Releases: react-pdf-kit/agent-skills
Release list
v1.0.0
Retarget the entire catalog at the @react-pdf-kit/viewer v2.x.x
release line, align every skill with the official v2 docs, and
centralize all worker / pdfjs-dist configuration in
react-pdf-kit-worker-config.
Validated against: @react-pdf-kit/viewer >=2.0.0 <3.0.0
Changed
- Every skill's
metadata.react_pdf_kit_versionmoved from
>=1.0.0 <2.0.0to>=2.0.0 <3.0.0. Descriptions updated to match. - Install instructions across all skills now install only
@react-pdf-kit/viewer. Per the v2 docs,pdfjs-distis an
auto-installed peer dependency (default5.4.530); it is installed
explicitly only when overriding the version. - Default examples use
<RPLayout toolbar>and drop the manual
RPTheme(RPConfigwraps theming and worker setup internally). The
optionalRPConfiglicenseKeyprop is documented. react-pdf-kit-nextjs-app-routerand
react-pdf-kit-nextjs-pages-routerrestructured around the
documented client-only pattern ('use client'+next/dynamic
ssr: false), targeting Next.js 15 + Turbopack, and now reference
thePromise.withResolve is not a functionserver-render error.react-pdf-kit-worker-configrewritten around v2: the worker is
auto-configured (zero setup by default); the skill now owns the
pdfjs-distversion-override flow (install + package-manager
override) and the per-bundlerRPConfigworkerUrlrecipes (Vite
?url, Next.js 15 Turbopackimport.meta.url, webpack
copy-webpack-plugin).react-pdf-kit-nextjs14-pdfjs-overriderewritten as a compatibility
note: v2 does not support Next.js 14. It now documents the two
supported paths (upgrade to Next.js 15 + Turbopack, or stay on
Next.js 14 with the legacy@pdf-viewer/reactpackage) instead of
the obsolete "pinpdfjs-distto v4" recipe.
Removed
- All manual PDF.js worker-configuration guidance (the
pdfjs-worker.tsside-effect module,GlobalWorkerOptions.workerSrc
assignment, and the Next.jsuseEffectworker wiring) removed from
the general skillsreact-pdf-kit-setup,react-pdf-kit-vite,
react-pdf-kit-nextjs-app-router, and
react-pdf-kit-nextjs-pages-router. These skills now focus solely on
React PDF Kit usage and defer all worker /pdfjs-distconfiguration
toreact-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/viewerto
>=1.0.0 <2.0.0, a range no longer published to npm. Bumped to
>=2.0.0 <3.0.0to match the skills' ownmetadata.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; onlysamples/generic-react/is currently
build-verified. SeeMAINTENANCE.md's Sample inventory for detail
and follow-up plan.
v1.0.0-beta.2
README polish on top of v1.0.0-beta.1.
Validated against: @react-pdf-kit/viewer >=1.0.0 <2.0.0
Changed
README.mdSkill Catalog table no longer carries the
React PDF Kitandpdfjs-distversion-range columns. Seven of
the eight catalog rows showed identical ranges, so the columns
were noise. The override skill's distinctpdfjs-distv4
dependency is still surfaced through its own description in the
table and through the dedicated Troubleshooting section. Per-skill
compatibility ranges remain machine-readable in each skill's YAML
frontmatter (metadata.react_pdf_kit_versionand
metadata.pdfjs_dist_version), which is the canonical source of
truth.
Catalog content
(No skill content changes since v1.0.0-beta.1. All eight skills,
sample scaffolds, scripts, and CI workflows ship unchanged.)
v1.0.0-beta.1
Patch on top of v1.0.0-beta.0 to fix the release workflow.
Validated against: @react-pdf-kit/viewer >=1.0.0 <2.0.0
Fixed
.github/workflows/release.yml: the "Confirm samples workflow
green for this commit" step incorrectly assumedsamples.ymlhad
run against the tag commit onmain, butsamples.ymlonly
triggers onpull_requestandpush to main, never on tag
pushes. The query also hard-coded--branch=maineven when the
tag was ondevelop, so it returned'unknown'and failed the
release onv1.0.0-beta.0. The step is now informational only:
it reports the samples run conclusion as a notice/warning and no
longer fails the release. The maintainer cutting the tag remains
responsible for ensuring the green PR for the tagged commit
exists.
Catalog content
(No skill or content changes since v1.0.0-beta.0. All eight
skills, README, MAINTENANCE, CLAUDE.md, conformance scripts, and
the rest of the CI surface ship unchanged.)