Release 0.1.1: fix consumer install/build

0.1.0 shipped three regressions that broke `npm install` + `npm run
build` from a fresh consumer project:

  1. `workspace:*` strings leaked into every template's published
     package.json. The first publish bypassed `pnpm changeset version`,
     so pnpm's workspace-protocol rewrite never ran. New CI job
     `pack-leak` packs every publishable workspace package and greps
     for `workspace:` to prevent regression.

  2. Five templates imported Bibliography via a deep relative path
     (`../../reactwright/src/userland/Bibliography.js`) that only
     resolves inside the monorepo. Switched to the public package
     entry `reactwright/userland`.

  3. tsx's default JSX transform is classic (`React.createElement`),
     and the consumer-side tsx runtime does not apply the host's
     tsconfig to files in node_modules. Every published template.tsx
     and the scaffolder-generated .tsx now `import React from "react"`
     explicitly. The scaffolder also writes a sibling tsconfig.json
     with `"jsx": "react-jsx"` so consumer .tsx files build cleanly.

While verifying the fix, also corrected the scaffolder's default
template to use `<link>` instead of `<a>` (not a registered content
intrinsic). New CI job `scaffold-build` runs the full
scaffold + npm install + npm run build loop for all six templates
against local tarballs.

Defers the `remove-deprecated-compounds` changeset (parked at
`.deferred`) so this release stays a clean 0.1.1 patch. Restore the
extension when cutting the next minor.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: PurpleReverie

.changeset/remove-deprecated-compounds.md.deferred

@@ -0,0 +1,11 @@
+---
+"reactwright": minor
+---
+
+Remove the engine compound intrinsics (`<bibliography>`, `<toc>`,
+`<list-of>`, and the template-side `<index>`). Authors should use the
+userland helpers `<Bibliography>`, `<Toc>`, `<ListOf>`, and `<Index>`
+from `reactwright/userland`, which compose the data-source primitives
+(`<bib-data>`, `<toc-data>`, `<list-of-data>`, `<index-data>`) to
+produce equivalent output. The content-side `<index term="...">`
+inline marker is unchanged.

.github/workflows/ci.yml

@@ -29,3 +29,45 @@ jobs:
 
       - name: Typecheck
         run: pnpm check
+
+  pack-leak:
+    name: Pack — no workspace:* leak
+    needs: test
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install
+        run: pnpm install --frozen-lockfile
+
+      - name: Check pack tarballs for workspace:* leaks
+        run: pnpm test:pack-leak
+
+  scaffold-build:
+    name: Scaffold + npm install + build (html)
+    needs: test
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install (workspace, for pnpm pack)
+        run: pnpm install --frozen-lockfile
+
+      - name: Scaffold each template + npm install + build to HTML
+        run: pnpm test:scaffold

package.json

@@ -10,7 +10,9 @@
     "build": "turbo build",
     "test": "turbo test",
     "check": "turbo check",
-    "mockup:all": "turbo mockup --filter='./examples/*'"
+    "mockup:all": "turbo mockup --filter='./examples/*'",
+    "test:pack-leak": "node scripts/check-pack-no-workspace-leak.mjs",
+    "test:scaffold": "node scripts/check-scaffold-build.mjs"
   },
   "engines": {
     "node": ">=20",

packages/create-reactwright-doc/CHANGELOG.md

@@ -0,0 +1,23 @@
+# create-reactwright-doc
+
+## 0.1.1
+
+### Patch Changes
+
+- Fix consumer install/build failure introduced in 0.1.0.
+
+  - Templates with bibliography support (`book`, `essay`, `ieee`, `ieee-report`,
+    `report`) imported `Bibliography` via a deep relative path that only
+    resolved inside the monorepo, breaking once installed from npm. The
+    import now uses the `reactwright/userland` package entry.
+  - Every template `template.tsx` now imports `React` explicitly. The
+    consumer-side `tsx` runtime does not apply the host project's tsconfig
+    to files in `node_modules`, so it defaults to the classic JSX transform
+    (`React.createElement(...)`) and fails with "React is not defined"
+    without an explicit React import.
+  - `create-reactwright-doc` now writes a `tsconfig.json` next to the
+    generated `.tsx` and emits an explicit `import React from "react";`, so
+    the scaffolded build works end-to-end against published packages.
+  - `@reactwright/markdown` and the templates are republished so their
+    tarballs carry concrete dependency versions rather than the unresolved
+    `workspace:*` strings shipped in 0.1.0.

packages/create-reactwright-doc/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-reactwright-doc",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Scaffolder for new Reactwright documents.",
   "license": "MIT",
   "author": "Reactwright contributors",
@@ -13,7 +13,11 @@
   "bugs": {
     "url": "https://github.com/PurpleReverie/reactwright/issues"
   },
-  "keywords": ["reactwright", "scaffolder", "create-app"],
+  "keywords": [
+    "reactwright",
+    "scaffolder",
+    "create-app"
+  ],
   "type": "module",
   "bin": {
     "create-reactwright-doc": "./src/index.js"

packages/create-reactwright-doc/src/index.js

@@ -41,7 +41,7 @@ const TEMPLATES = {
   }
 };
 
-const REACTWRIGHT_VERSION = "^0.2.0";
+const REACTWRIGHT_VERSION = "^0.1.0";
 const TEMPLATE_VERSION = "^0.1.0";
 
 function parseArgs(argv) {
@@ -129,6 +129,11 @@ function main() {
     starterTsx(args.template, args.name)
   );
 
+  fs.writeFileSync(
+    path.join(targetDir, "tsconfig.json"),
+    starterTsconfig()
+  );
+
   fs.writeFileSync(
     path.join(targetDir, "README.md"),
     starterReadme(args.name, args.template, entryFile)
@@ -138,6 +143,7 @@ function main() {
 
   ${args.name}/
   ├── package.json
+  ├── tsconfig.json
   ├── ${entryFile}
   └── README.md
 
@@ -154,6 +160,7 @@ function starterTsx(templateKey, name) {
   const template = TEMPLATES[templateKey];
   if (templateKey === "letter") {
     return `import "reactwright/jsx";
+import React from "react";
 import { Template } from "${template.pkg}";
 
 export { Template };
@@ -202,6 +209,7 @@ export default function Document() {
   }
   if (templateKey === "book") {
     return `import "reactwright/jsx";
+import React from "react";
 import { Template } from "${template.pkg}";
 
 export { Template };
@@ -235,6 +243,7 @@ export default function Document() {
 `;
   }
   return `import "reactwright/jsx";
+import React from "react";
 import { Template } from "${template.pkg}";
 
 export { Template };
@@ -249,8 +258,8 @@ export default function Document() {
           flows through the engine to paginated HTML and PDF.
         </p>
         <p>
-          See <a href="https://github.com/PurpleReverie/reactwright">the
-          documentation</a> for the full primitive vocabulary.
+          See <link href="https://github.com/PurpleReverie/reactwright">the
+          documentation</link> for the full primitive vocabulary.
         </p>
       </section>
 
@@ -273,6 +282,24 @@ export default function Document() {
 `;
 }
 
+function starterTsconfig() {
+  return `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "jsx": "react-jsx",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": false,
+    "noEmit": true
+  },
+  "include": ["*.tsx", "*.ts"]
+}
+`;
+}
+
 function starterReadme(name, templateKey, entryFile) {
   return `# ${name}
 

packages/markdown/CHANGELOG.md

@@ -0,0 +1,23 @@
+# @reactwright/markdown
+
+## 0.1.1
+
+### Patch Changes
+
+- Fix consumer install/build failure introduced in 0.1.0.
+
+  - Templates with bibliography support (`book`, `essay`, `ieee`, `ieee-report`,
+    `report`) imported `Bibliography` via a deep relative path that only
+    resolved inside the monorepo, breaking once installed from npm. The
+    import now uses the `reactwright/userland` package entry.
+  - Every template `template.tsx` now imports `React` explicitly. The
+    consumer-side `tsx` runtime does not apply the host project's tsconfig
+    to files in `node_modules`, so it defaults to the classic JSX transform
+    (`React.createElement(...)`) and fails with "React is not defined"
+    without an explicit React import.
+  - `create-reactwright-doc` now writes a `tsconfig.json` next to the
+    generated `.tsx` and emits an explicit `import React from "react";`, so
+    the scaffolded build works end-to-end against published packages.
+  - `@reactwright/markdown` and the templates are republished so their
+    tarballs carry concrete dependency versions rather than the unresolved
+    `workspace:*` strings shipped in 0.1.0.

packages/markdown/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reactwright/markdown",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Author Reactwright documents in Markdown. Parses CommonMark + YAML frontmatter into Reactwright content JSX so any template (essay, IEEE, report) can render `.md` files to HTML and PDF.",
   "keywords": [
     "reactwright",

packages/template-book/CHANGELOG.md

@@ -0,0 +1,23 @@
+# @reactwright/template-book
+
+## 0.1.1
+
+### Patch Changes
+
+- Fix consumer install/build failure introduced in 0.1.0.
+
+  - Templates with bibliography support (`book`, `essay`, `ieee`, `ieee-report`,
+    `report`) imported `Bibliography` via a deep relative path that only
+    resolved inside the monorepo, breaking once installed from npm. The
+    import now uses the `reactwright/userland` package entry.
+  - Every template `template.tsx` now imports `React` explicitly. The
+    consumer-side `tsx` runtime does not apply the host project's tsconfig
+    to files in `node_modules`, so it defaults to the classic JSX transform
+    (`React.createElement(...)`) and fails with "React is not defined"
+    without an explicit React import.
+  - `create-reactwright-doc` now writes a `tsconfig.json` next to the
+    generated `.tsx` and emits an explicit `import React from "react";`, so
+    the scaffolded build works end-to-end against published packages.
+  - `@reactwright/markdown` and the templates are republished so their
+    tarballs carry concrete dependency versions rather than the unresolved
+    `workspace:*` strings shipped in 0.1.0.

packages/template-book/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reactwright/template-book",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Long-form chaptered book template (trade paperback) for the Reactwright document engine.",
   "license": "MIT",
   "author": "Reactwright contributors",
@@ -13,7 +13,13 @@
   "bugs": {
     "url": "https://github.com/PurpleReverie/reactwright/issues"
   },
-  "keywords": ["reactwright", "template", "book", "novel", "trade-paperback"],
+  "keywords": [
+    "reactwright",
+    "template",
+    "book",
+    "novel",
+    "trade-paperback"
+  ],
   "type": "module",
   "exports": {
     ".": {