chore(release): promote Unreleased to v1.0.0

   Retarget release for @react-pdf-kit/viewer v2.x.x, moved from
   [Unreleased] to a dated v1.0.0 CHANGELOG section per the
   MAINTENANCE.md runbook. Also fixes a real release blocker found
   while validating the samples: generic-react, vite, and
   nextjs-app-router still pinned @react-pdf-kit/viewer to the
   now-unpublished >=1.0.0 <2.0.0 range, which failed pnpm install
   outright. Bumped to >=2.0.0 <3.0.0 to match the skills' own
   declared metadata.

   Documents a pre-existing, previously unflagged gap in
   MAINTENANCE.md and CHANGELOG.md: three of four samples
   (vite, nextjs-app-router, nextjs-14-override) have been unhydrated
   placeholder scaffolds since the initial commit and have never
   actually been build-verified � samples.yml has zero CI runs on the
   repo. Only generic-react currently builds successfully. Released
   anyway per maintainer decision; sample hydration is tracked as
   follow-up work.

Author: kittisakLS

CHANGELOG.md

@@ -17,7 +17,7 @@ range under a **Validated against** line.
 - Reference skills by their kebab-case `name`, not their display
   description.
 
-## [Unreleased]
+## [1.0.0] - 2026-07-03
 
 Retarget the entire catalog at the `@react-pdf-kit/viewer` v2.x.x
 release line, align every skill with the official v2 docs, and
@@ -64,6 +64,23 @@ centralize all worker / `pdfjs-dist` configuration in
   `react-pdf-kit-nextjs-pages-router`. These skills now focus solely on
   React PDF Kit usage and defer all worker / `pdfjs-dist` configuration
   to `react-pdf-kit-worker-config`.
+- Internal `TESTING.md` (pre-release, private-repo testing instructions
+  not meant for the public catalog).
+
+### Fixed
+
+- `samples/generic-react/`, `samples/vite/`, and
+  `samples/nextjs-app-router/` still pinned `@react-pdf-kit/viewer` to
+  `>=1.0.0 <2.0.0`, a range no longer published to npm. Bumped to
+  `>=2.0.0 <3.0.0` to match the skills' own `metadata.react_pdf_kit_version`.
+
+### Known gaps
+
+- `samples/vite/`, `samples/nextjs-app-router/`, and
+  `samples/nextjs-14-override/` are unhydrated placeholder scaffolds
+  and do not build; only `samples/generic-react/` is currently
+  build-verified. See `MAINTENANCE.md`'s Sample inventory for detail
+  and follow-up plan.
 
 ## [1.0.0-beta.2] - 2026-05-15
 

MAINTENANCE.md

@@ -113,12 +113,24 @@ release after v1.0.0.
 
 ## Sample inventory
 
-| Sample | Framework | pdfjs-dist | Used by |
-|--------|-----------|------------|---------|
-| `samples/generic-react/` | Vite + React 18 | v5 | `react-pdf-kit-setup`, `react-pdf-kit-toolbar-customization`, `react-pdf-kit-custom-layout` |
-| `samples/vite/` | Vite 5 | v5 | `react-pdf-kit-setup`, `react-pdf-kit-vite`, `react-pdf-kit-worker-config` |
-| `samples/nextjs-app-router/` | Next.js 15 + Turbopack | v5 | `react-pdf-kit-nextjs-app-router`, `react-pdf-kit-nextjs-pages-router` (via `verification/pages-router/` shim), `react-pdf-kit-worker-config`, `react-pdf-kit-toolbar-customization`, `react-pdf-kit-custom-layout` |
-| `samples/nextjs-14-override/` | Next.js 14 + webpack | v4 (post-fix) | `react-pdf-kit-nextjs14-pdfjs-override` |
+| Sample | Framework | pdfjs-dist | Used by | Build-verified? |
+|--------|-----------|------------|---------|------------------|
+| `samples/generic-react/` | Vite + React 18 | v5 | `react-pdf-kit-setup`, `react-pdf-kit-toolbar-customization`, `react-pdf-kit-custom-layout` | Yes — `pnpm install && pnpm build` passes against `@react-pdf-kit/viewer@2.7.2` (v1.0.0 release check). |
+| `samples/vite/` | Vite 5 | v5 | `react-pdf-kit-setup`, `react-pdf-kit-vite`, `react-pdf-kit-worker-config` | **No.** Placeholder `package.json` + `README.md` only since the initial scaffold commit — never hydrated into a runnable Vite app (no `tsconfig.json`, `vite.config.ts`, `index.html`, or `src/`). `pnpm build` fails immediately. |
+| `samples/nextjs-app-router/` | Next.js 15 + Turbopack | v5 | `react-pdf-kit-nextjs-app-router`, `react-pdf-kit-nextjs-pages-router` (via `verification/pages-router/` shim), `react-pdf-kit-worker-config`, `react-pdf-kit-toolbar-customization`, `react-pdf-kit-custom-layout` | **No.** Same placeholder-only state as `samples/vite/`; no Next.js app scaffold exists yet. |
+| `samples/nextjs-14-override/` | Next.js 14 + webpack | v4 (post-fix) | `react-pdf-kit-nextjs14-pdfjs-override` | **No.** Placeholder-only, and its premise (pin `pdfjs-dist` to v4 as a workaround) is now superseded by the skill's rewritten guidance (v2 doesn't support Next.js 14 at all; use Next.js 15 or the legacy `@pdf-viewer/react` package). Needs a rewrite, not just hydration, before it can build-verify anything. |
+
+**Known gap as of `v1.0.0`**: three of four samples have never been
+build-verified, on any release including the `v1.0.0-beta.x` line —
+`samples.yml` has zero recorded CI runs on the repo. `v1.0.0-beta.0`'s
+CHANGELOG entry flagged this as outstanding at the time; it was not
+resolved before this release either. Only `samples/generic-react/` is
+confirmed working. Treat every skill *other than* `react-pdf-kit-setup`,
+`react-pdf-kit-toolbar-customization`, and `react-pdf-kit-custom-layout`
+as verified by conformance script only (`scripts/verify-skill.sh`), not
+by an actual build. Hydrating the remaining three samples (and
+rewriting `nextjs-14-override` to match its current skill content) is
+required before their skills can be considered build-verified.
 
 If a skill needs verification against a framework / version combination
 not listed above, add a new sample in the same PR as the skill and
@@ -132,7 +144,7 @@ end-to-end to ensure the runbook stays accurate. Record each walk here.
 | Date | Flow | Outcome |
 |------|------|---------|
 |      | Deprecation drill (per tasks T038) | TBD |
-|      | First release (v1.0.0, per tasks T045) | TBD |
+| 2026-07-03 | First release (v1.0.0, per tasks T045) | Partial. `scripts/verify-all.sh` passes (8/8 skills). Only `samples/generic-react/` build-verified; `samples/vite/`, `samples/nextjs-app-router/`, `samples/nextjs-14-override/` are unhydrated placeholders (see Sample inventory). Released anyway per maintainer decision; sample hydration tracked as follow-up work, not blocking. |
 
 ## Security review
 

samples/generic-react/package.json

@@ -10,7 +10,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@react-pdf-kit/viewer": ">=1.0.0 <2.0.0",
+    "@react-pdf-kit/viewer": ">=2.0.0 <3.0.0",
     "pdfjs-dist": "5.4.530",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"

samples/nextjs-app-router/package.json

@@ -9,7 +9,7 @@
     "start": "next start"
   },
   "dependencies": {
-    "@react-pdf-kit/viewer": ">=1.0.0 <2.0.0",
+    "@react-pdf-kit/viewer": ">=2.0.0 <3.0.0",
     "next": "^15.0.0",
     "pdfjs-dist": "5.4.530",
     "react": "^18.3.1",

samples/vite/package.json

@@ -10,7 +10,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@react-pdf-kit/viewer": ">=1.0.0 <2.0.0",
+    "@react-pdf-kit/viewer": ">=2.0.0 <3.0.0",
     "pdfjs-dist": "5.4.530",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"