v1.0.0 release prep: API docs, README overhaul, semver commitment

[yancya]

Scope

Everything needed to call the gem stable and ship 1.0.0.

• API docs: RDoc/YARD docstrings on RangePpoiString.dump, .parse, both refinements, and the error classes (NoNextError, ParseError) — params, return types, raised errors, examples
• README overhaul: module-function API as the primary usage example, refinement API as the alternative; a behavior table (valid inputs, error cases, negative numbers, type: Integer); refinement caveats (lexical scoping, Array#to_s shadowing)
• CHANGELOG: entries for 0.3.0 / 0.4.0 (if not already added per-release) and 1.0.0
• Release: bump lib/range_ppoi_string/version.rb to 1.0.0, tag v1.0.0, Trusted Publisher workflow ships it

Prerequisites

• All of Add gemspec metadata and CHANGELOG; update README to the tag-based release flow #1–Typed parse: RangePpoiString.parse(str, type: Integer) for a true round-trip #6 merged and released as 0.3.0 / 0.4.0 (1.0.0 should be a docs-and-commitment release, not a feature release)

Acceptance criteria

• Every public method and error class has a docstring with at least one example
• README documents both APIs, the error behavior table, and the tag-based release flow
• CHANGELOG covers every released version up to 1.0.0
• gem build range_ppoi_string.gemspec succeeds with no warnings
• CI green; v1.0.0 tag pushed and gem live on rubygems.org (tag push is a human GO)

Verification

gem build range_ppoi_string.gemspec
rake test
# after release: gem info range_ppoi_string --remote

[yancya]

🤖 このissueは一旦スキップします（着手せず）。

理由: 受け入れ条件に「`v1.0.0` タグを push してrubygems.orgに公開する」という外部公開・デプロイ操作が含まれており、方針上ユーザーのGOなしには着手できません。加えて前提条件（#1〜#6 を v0.3.0 / v0.4.0 として実際にリリース済みであること）自体も、バージョン番号のbump + タグpushというデプロイ操作を要するため、まだ満たされていません（#1〜#6 のコード変更自体は master に反映・クローズ済みですが、実際のgemリリースはまだ行っていません）。

ドキュメント整備（APIドキュメント・README全面改稿・CHANGELOG追記）自体は次回以降、着手前にユーザーへ確認の上で進められます。リリースフロー（バージョンbump → タグpush → CI自動公開）の実行判断はユーザーにお任せします。