@projitect/blueprint-next 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kapil Easwar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/package.json

@@ -0,0 +1,58 @@
+{
+    "name": "@projitect/blueprint-next",
+    "version": "1.0.1",
+    "description": "Next.js App Router + TypeScript app blueprint for projitect — composes tsconfig, gitignore and vitest, owns next.config.ts and the package.json scaffolding, seeds the starter source.",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/projitect/projitect.git",
+        "directory": "packages/blueprint-next"
+    },
+    "license": "MIT",
+    "type": "module",
+    "exports": {
+        ".": {
+            "types": "./dist/src/index.d.ts",
+            "import": "./dist/src/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "src",
+        "!**/*.tsbuildinfo"
+    ],
+    "scripts": {
+        "build": "tsc --build",
+        "build:clean": "tsc --build --clean",
+        "tc": "tsc --build"
+    },
+    "devDependencies": {
+        "@projitect/blueprint": "workspace:*",
+        "@projitect/blueprint-gitignore": "workspace:*",
+        "@projitect/blueprint-tsconfig": "workspace:*",
+        "@projitect/blueprint-vitest": "workspace:*",
+        "@projitect/core": "workspace:*",
+        "@projitect/test-kit": "workspace:*",
+        "effect": "4.0.0-rc.111",
+        "typescript": "5.9.3"
+    },
+    "peerDependencies": {
+        "@projitect/blueprint": "workspace:*",
+        "@projitect/blueprint-gitignore": "workspace:*",
+        "@projitect/blueprint-tsconfig": "workspace:*",
+        "@projitect/blueprint-vitest": "workspace:*",
+        "@projitect/core": "workspace:*",
+        "effect": "4.0.0-rc.111"
+    },
+    "engines": {
+        "node": ">=22.12.0"
+    },
+    "projitect": {
+        "type": "blueprint",
+        "import": "import { next } from \"@projitect/blueprint-next\"",
+        "call": "next()",
+        "supports": {
+            "next": "^16.4.0",
+            "react": "^19.2.0"
+        }
+    }
+}

package/dist/src/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @projitect/blueprint-next
+ *
+ * One composite blueprint that scaffolds a Next.js (App Router) + TypeScript app:
+ *
+ *  1. Composes the existing `tsconfig` (type-check only, DOM lib, `react-jsx`, the keys Next.js
+ *     wants in `tsconfig.json`), `gitignore` (`node`, `next` and `tsbuildinfo` sections) and
+ *     `vitest` (jsdom) blueprints, so each stays the single owner of its files.
+ *  2. Owns `next.config.ts`. Owned mode — projitect rewrites it on every `remodel`.
+ *  3. Merges the `dev` / `build` / `start` / `lint` scripts, the Next.js and React dependencies
+ *     and the TypeScript / ESLint / testing devDependencies into `package.json`. Merge mode —
+ *     user keys survive.
+ *  4. Seeds the starter source (`src/app/layout.tsx`, `src/app/page.tsx`, `src/app/globals.css`,
+ *     `src/app/page.test.tsx`) and `eslint.config.mjs`, which extends `eslint-config-next`. Seed
+ *     mode — written once, never enforced, so the app is yours to edit.
+ */
+import type { Blueprint } from "@projitect/core";
+/**
+ * Build the composite Next.js blueprint. Every operation is attributed to its own sub-blueprint
+ * (`pjt:tsconfig`, `pjt:vitest`, `pjt:next`, …); removing `next()` from `.pjt.ts` removes the
+ * maintained scaffolding and managed keys but leaves the seeded source and the user's own
+ * `package.json` keys in place.
+ */
+export declare const next: () => Blueprint.Blueprint;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AA8BhD;;;;;GAKG;AACH,eAAO,MAAM,IAAI,QAAO,SAAS,CAAC,SAiGjC,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,143 @@
+/**
+ * @projitect/blueprint-next
+ *
+ * One composite blueprint that scaffolds a Next.js (App Router) + TypeScript app:
+ *
+ *  1. Composes the existing `tsconfig` (type-check only, DOM lib, `react-jsx`, the keys Next.js
+ *     wants in `tsconfig.json`), `gitignore` (`node`, `next` and `tsbuildinfo` sections) and
+ *     `vitest` (jsdom) blueprints, so each stays the single owner of its files.
+ *  2. Owns `next.config.ts`. Owned mode — projitect rewrites it on every `remodel`.
+ *  3. Merges the `dev` / `build` / `start` / `lint` scripts, the Next.js and React dependencies
+ *     and the TypeScript / ESLint / testing devDependencies into `package.json`. Merge mode —
+ *     user keys survive.
+ *  4. Seeds the starter source (`src/app/layout.tsx`, `src/app/page.tsx`, `src/app/globals.css`,
+ *     `src/app/page.test.tsx`) and `eslint.config.mjs`, which extends `eslint-config-next`. Seed
+ *     mode — written once, never enforced, so the app is yours to edit.
+ */
+import { Effect } from "effect";
+import { jsonMerge, ownFile, seedFile } from "@projitect/blueprint";
+import { gitignores } from "@projitect/blueprint-gitignore";
+import { tsconfig } from "@projitect/blueprint-tsconfig";
+import { vitest } from "@projitect/blueprint-vitest";
+import { ChangeSet as CS } from "@projitect/core";
+import manifest from "../package.json" with { type: "json" };
+import * as templates from "./templates.js";
+// Read the version from the package manifest (emitted next to `dist/src`) so a release bump
+// reaches `.pjt.lock` and `pjt inspect` can report a real upgrade.
+const PACKAGE_VERSION = manifest.version;
+// The supported Next.js and React ranges. Keep `projitect.supports` in `package.json` in step.
+const NEXT_DEP_RANGE = "^16.4.0";
+const REACT_DEP_RANGE = "^19.2.0";
+const ESLINT_DEP_RANGE = "^9.39.0";
+const ESLINT_CONFIG_NEXT_DEP_RANGE = "^16.4.0";
+const TYPESCRIPT_DEP_RANGE = "^5.9.0";
+const TYPES_NODE_DEP_RANGE = "^22.19.0";
+const TYPES_REACT_DEP_RANGE = "^19.2.0";
+const JSDOM_DEP_RANGE = "^27.4.0";
+const TESTING_LIBRARY_REACT_DEP_RANGE = "^16.3.0";
+const TESTING_LIBRARY_DOM_DEP_RANGE = "^10.4.0";
+/** Starter files, written once and never enforced. */
+const STARTER_FILES = {
+    "src/app/layout.tsx": templates.layoutTsx,
+    "src/app/page.tsx": templates.pageTsx,
+    "src/app/globals.css": templates.globalsCss,
+    "src/app/page.test.tsx": templates.pageTestTsx,
+    "eslint.config.mjs": templates.eslintConfig,
+};
+/**
+ * Build the composite Next.js blueprint. Every operation is attributed to its own sub-blueprint
+ * (`pjt:tsconfig`, `pjt:vitest`, `pjt:next`, …); removing `next()` from `.pjt.ts` removes the
+ * maintained scaffolding and managed keys but leaves the seeded source and the user's own
+ * `package.json` keys in place.
+ */
+export const next = () => {
+    const id = "pjt:next";
+    const packageJsonMerge = jsonMerge({
+        id,
+        version: PACKAGE_VERSION,
+        description: "Next.js scripts, dependencies and TypeScript / ESLint devDependencies",
+        path: "package.json",
+        ownedKeys: [
+            "scripts.dev",
+            "scripts.build",
+            "scripts.start",
+            "scripts.lint",
+            "dependencies.next",
+            "dependencies.react",
+            "dependencies.react-dom",
+            "devDependencies.@testing-library/dom",
+            "devDependencies.@testing-library/react",
+            "devDependencies.@types/node",
+            "devDependencies.@types/react",
+            "devDependencies.@types/react-dom",
+            "devDependencies.eslint",
+            "devDependencies.eslint-config-next",
+            "devDependencies.jsdom",
+            "devDependencies.typescript",
+        ],
+        value: {
+            scripts: {
+                dev: "next dev",
+                build: "next build",
+                start: "next start",
+                lint: "eslint .",
+            },
+            dependencies: {
+                next: NEXT_DEP_RANGE,
+                react: REACT_DEP_RANGE,
+                "react-dom": REACT_DEP_RANGE,
+            },
+            devDependencies: {
+                "@testing-library/dom": TESTING_LIBRARY_DOM_DEP_RANGE,
+                "@testing-library/react": TESTING_LIBRARY_REACT_DEP_RANGE,
+                "@types/node": TYPES_NODE_DEP_RANGE,
+                "@types/react": TYPES_REACT_DEP_RANGE,
+                "@types/react-dom": TYPES_REACT_DEP_RANGE,
+                eslint: ESLINT_DEP_RANGE,
+                "eslint-config-next": ESLINT_CONFIG_NEXT_DEP_RANGE,
+                jsdom: JSDOM_DEP_RANGE,
+                typescript: TYPESCRIPT_DEP_RANGE,
+            },
+        },
+    });
+    const nextConfig = ownFile({
+        id,
+        version: PACKAGE_VERSION,
+        description: "Next.js configuration",
+        path: "next.config.ts",
+        content: templates.nextConfig,
+    });
+    const starter = Object.entries(STARTER_FILES).map(([path, content]) => seedFile({ id, version: PACKAGE_VERSION, description: `starter ${path}`, path, content }));
+    const parts = [
+        // `next build` adds these keys to `tsconfig.json` when they are missing, and it requires the
+        // automatic JSX runtime. Declaring them keeps the build from rewriting the owned file.
+        tsconfig({
+            module: "ESNext",
+            dom: true,
+            jsx: "react-jsx",
+            noEmit: true,
+            allowJs: true,
+            incremental: true,
+            plugins: ["next"],
+            include: ["next-env.d.ts", ".next/types/**/*.ts", ".next/dev/types/**/*.ts"],
+        }),
+        gitignores.node(),
+        gitignores.next(),
+        gitignores.tsbuildinfo(),
+        vitest({ environment: "jsdom" }),
+        packageJsonMerge,
+        nextConfig,
+        ...starter,
+    ];
+    return {
+        id,
+        version: PACKAGE_VERSION,
+        description: "Next.js App Router + TypeScript app (config, scripts, dependencies and starter source)",
+        permissions: parts.flatMap((part) => part.permissions),
+        plan: Effect.gen(function* () {
+            const changeSets = yield* Effect.forEach(parts, (part) => part.plan);
+            return CS.Reducer.combineAll(changeSets);
+        }),
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/templates.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Starter source and config for the Next.js app. The seeded files are written once and never
+ * enforced; `nextConfig` is owned and rewritten on every `remodel`.
+ */
+export declare const layoutTsx = "import type { Metadata } from \"next\"\nimport type { ReactNode } from \"react\"\nimport \"./globals.css\"\n\nexport const metadata: Metadata = {\n  title: \"Next app\",\n  description: \"Scaffolded by projitect\",\n}\n\nexport default function RootLayout({ children }: { readonly children: ReactNode }) {\n  return (\n    <html lang=\"en\">\n      <body>{children}</body>\n    </html>\n  )\n}\n";
+export declare const pageTsx = "export default function Page() {\n  return (\n    <main>\n      <h1>Hello from projitect</h1>\n      <p>\n        Edit <code>src/app/page.tsx</code> to get started.\n      </p>\n    </main>\n  )\n}\n";
+export declare const pageTestTsx = "import { cleanup, render, screen } from \"@testing-library/react\"\nimport { afterEach, describe, expect, it } from \"vitest\"\nimport Page from \"./page\"\n\nafterEach(cleanup)\n\ndescribe(\"Page\", () => {\n  it(\"renders the starter heading\", () => {\n    render(<Page />)\n    expect(screen.getByRole(\"heading\", { name: \"Hello from projitect\" })).toBeTruthy()\n  })\n})\n";
+export declare const globalsCss = ":root {\n  font-family: system-ui, sans-serif;\n  color-scheme: light dark;\n}\n\nbody {\n  margin: 0;\n  display: grid;\n  min-height: 100vh;\n  place-items: center;\n}\n";
+export declare const eslintConfig = "import { defineConfig, globalIgnores } from \"eslint/config\"\nimport nextVitals from \"eslint-config-next/core-web-vitals\"\nimport nextTs from \"eslint-config-next/typescript\"\n\nexport default defineConfig([\n  ...nextVitals,\n  ...nextTs,\n  globalIgnores([\".next/**\", \"out/**\", \"next-env.d.ts\"]),\n])\n";
+export declare const nextConfig = "import type { NextConfig } from \"next\"\n\n/**\n * Next.js configuration scaffolded by `@projitect/blueprint-next`.\n *\n * Owned mode \u2014 projitect rewrites this file on every `pjt remodel`.\n */\nconst nextConfig: NextConfig = {\n  reactStrictMode: true,\n}\n\nexport default nextConfig\n";
+//# sourceMappingURL=templates.d.ts.map

package/dist/src/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,SAAS,gZAgBrB,CAAA;AAED,eAAO,MAAM,OAAO,4MAUnB,CAAA;AAED,eAAO,MAAM,WAAW,iYAYvB,CAAA;AAED,eAAO,MAAM,UAAU,gLAWtB,CAAA;AAED,eAAO,MAAM,YAAY,+TASxB,CAAA;AAED,eAAO,MAAM,UAAU,2SAYtB,CAAA"}

package/dist/src/templates.js

@@ -0,0 +1,81 @@
+/**
+ * Starter source and config for the Next.js app. The seeded files are written once and never
+ * enforced; `nextConfig` is owned and rewritten on every `remodel`.
+ */
+export const layoutTsx = `import type { Metadata } from "next"
+import type { ReactNode } from "react"
+import "./globals.css"
+
+export const metadata: Metadata = {
+  title: "Next app",
+  description: "Scaffolded by projitect",
+}
+
+export default function RootLayout({ children }: { readonly children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+`;
+export const pageTsx = `export default function Page() {
+  return (
+    <main>
+      <h1>Hello from projitect</h1>
+      <p>
+        Edit <code>src/app/page.tsx</code> to get started.
+      </p>
+    </main>
+  )
+}
+`;
+export const pageTestTsx = `import { cleanup, render, screen } from "@testing-library/react"
+import { afterEach, describe, expect, it } from "vitest"
+import Page from "./page"
+
+afterEach(cleanup)
+
+describe("Page", () => {
+  it("renders the starter heading", () => {
+    render(<Page />)
+    expect(screen.getByRole("heading", { name: "Hello from projitect" })).toBeTruthy()
+  })
+})
+`;
+export const globalsCss = `:root {
+  font-family: system-ui, sans-serif;
+  color-scheme: light dark;
+}
+
+body {
+  margin: 0;
+  display: grid;
+  min-height: 100vh;
+  place-items: center;
+}
+`;
+export const eslintConfig = `import { defineConfig, globalIgnores } from "eslint/config"
+import nextVitals from "eslint-config-next/core-web-vitals"
+import nextTs from "eslint-config-next/typescript"
+
+export default defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  globalIgnores([".next/**", "out/**", "next-env.d.ts"]),
+])
+`;
+export const nextConfig = `import type { NextConfig } from "next"
+
+/**
+ * Next.js configuration scaffolded by \`@projitect/blueprint-next\`.
+ *
+ * Owned mode — projitect rewrites this file on every \`pjt remodel\`.
+ */
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+}
+
+export default nextConfig
+`;
+//# sourceMappingURL=templates.js.map

package/dist/src/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;CAgBxB,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;CAUtB,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;CAY1B,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;CAWzB,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;CAS3B,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;CAYzB,CAAA"}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@projitect/blueprint-next",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "description": "Next.js App Router + TypeScript app blueprint for projitect — composes tsconfig, gitignore and vitest, owns next.config.ts and the package.json scaffolding, seeds the starter source.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/projitect/projitect.git",
+    "directory": "packages/blueprint-next"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!**/*.tsbuildinfo"
+  ],
+  "devDependencies": {
+    "effect": "4.0.0-rc.111",
+    "typescript": "5.9.3",
+    "@projitect/blueprint": "1.0.1",
+    "@projitect/blueprint-gitignore": "1.0.1",
+    "@projitect/blueprint-tsconfig": "1.0.1",
+    "@projitect/blueprint-vitest": "1.0.1",
+    "@projitect/core": "1.0.1",
+    "@projitect/test-kit": "1.0.1"
+  },
+  "peerDependencies": {
+    "effect": "4.0.0-rc.111",
+    "@projitect/blueprint": "1.0.1",
+    "@projitect/blueprint-gitignore": "1.0.1",
+    "@projitect/blueprint-tsconfig": "1.0.1",
+    "@projitect/blueprint-vitest": "1.0.1",
+    "@projitect/core": "1.0.1"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "projitect": {
+    "type": "blueprint",
+    "import": "import { next } from \"@projitect/blueprint-next\"",
+    "call": "next()",
+    "supports": {
+      "next": "^16.4.0",
+      "react": "^19.2.0"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "build:clean": "tsc --build --clean",
+    "tc": "tsc --build"
+  }
 }

package/src/index.ts

@@ -0,0 +1,156 @@
+/**
+ * @projitect/blueprint-next
+ *
+ * One composite blueprint that scaffolds a Next.js (App Router) + TypeScript app:
+ *
+ *  1. Composes the existing `tsconfig` (type-check only, DOM lib, `react-jsx`, the keys Next.js
+ *     wants in `tsconfig.json`), `gitignore` (`node`, `next` and `tsbuildinfo` sections) and
+ *     `vitest` (jsdom) blueprints, so each stays the single owner of its files.
+ *  2. Owns `next.config.ts`. Owned mode — projitect rewrites it on every `remodel`.
+ *  3. Merges the `dev` / `build` / `start` / `lint` scripts, the Next.js and React dependencies
+ *     and the TypeScript / ESLint / testing devDependencies into `package.json`. Merge mode —
+ *     user keys survive.
+ *  4. Seeds the starter source (`src/app/layout.tsx`, `src/app/page.tsx`, `src/app/globals.css`,
+ *     `src/app/page.test.tsx`) and `eslint.config.mjs`, which extends `eslint-config-next`. Seed
+ *     mode — written once, never enforced, so the app is yours to edit.
+ */
+
+import { Effect } from "effect"
+import { jsonMerge, ownFile, seedFile } from "@projitect/blueprint"
+import { gitignores } from "@projitect/blueprint-gitignore"
+import { tsconfig } from "@projitect/blueprint-tsconfig"
+import { vitest } from "@projitect/blueprint-vitest"
+import type { Blueprint } from "@projitect/core"
+import { ChangeSet as CS } from "@projitect/core"
+import manifest from "../package.json" with { type: "json" }
+import * as templates from "./templates.js"
+
+// Read the version from the package manifest (emitted next to `dist/src`) so a release bump
+// reaches `.pjt.lock` and `pjt inspect` can report a real upgrade.
+const PACKAGE_VERSION = manifest.version
+
+// The supported Next.js and React ranges. Keep `projitect.supports` in `package.json` in step.
+const NEXT_DEP_RANGE = "^16.4.0"
+const REACT_DEP_RANGE = "^19.2.0"
+const ESLINT_DEP_RANGE = "^9.39.0"
+const ESLINT_CONFIG_NEXT_DEP_RANGE = "^16.4.0"
+const TYPESCRIPT_DEP_RANGE = "^5.9.0"
+const TYPES_NODE_DEP_RANGE = "^22.19.0"
+const TYPES_REACT_DEP_RANGE = "^19.2.0"
+const JSDOM_DEP_RANGE = "^27.4.0"
+const TESTING_LIBRARY_REACT_DEP_RANGE = "^16.3.0"
+const TESTING_LIBRARY_DOM_DEP_RANGE = "^10.4.0"
+
+/** Starter files, written once and never enforced. */
+const STARTER_FILES = {
+  "src/app/layout.tsx": templates.layoutTsx,
+  "src/app/page.tsx": templates.pageTsx,
+  "src/app/globals.css": templates.globalsCss,
+  "src/app/page.test.tsx": templates.pageTestTsx,
+  "eslint.config.mjs": templates.eslintConfig,
+} as const
+
+/**
+ * Build the composite Next.js blueprint. Every operation is attributed to its own sub-blueprint
+ * (`pjt:tsconfig`, `pjt:vitest`, `pjt:next`, …); removing `next()` from `.pjt.ts` removes the
+ * maintained scaffolding and managed keys but leaves the seeded source and the user's own
+ * `package.json` keys in place.
+ */
+export const next = (): Blueprint.Blueprint => {
+  const id = "pjt:next"
+
+  const packageJsonMerge = jsonMerge({
+    id,
+    version: PACKAGE_VERSION,
+    description: "Next.js scripts, dependencies and TypeScript / ESLint devDependencies",
+    path: "package.json",
+    ownedKeys: [
+      "scripts.dev",
+      "scripts.build",
+      "scripts.start",
+      "scripts.lint",
+      "dependencies.next",
+      "dependencies.react",
+      "dependencies.react-dom",
+      "devDependencies.@testing-library/dom",
+      "devDependencies.@testing-library/react",
+      "devDependencies.@types/node",
+      "devDependencies.@types/react",
+      "devDependencies.@types/react-dom",
+      "devDependencies.eslint",
+      "devDependencies.eslint-config-next",
+      "devDependencies.jsdom",
+      "devDependencies.typescript",
+    ],
+    value: {
+      scripts: {
+        dev: "next dev",
+        build: "next build",
+        start: "next start",
+        lint: "eslint .",
+      },
+      dependencies: {
+        next: NEXT_DEP_RANGE,
+        react: REACT_DEP_RANGE,
+        "react-dom": REACT_DEP_RANGE,
+      },
+      devDependencies: {
+        "@testing-library/dom": TESTING_LIBRARY_DOM_DEP_RANGE,
+        "@testing-library/react": TESTING_LIBRARY_REACT_DEP_RANGE,
+        "@types/node": TYPES_NODE_DEP_RANGE,
+        "@types/react": TYPES_REACT_DEP_RANGE,
+        "@types/react-dom": TYPES_REACT_DEP_RANGE,
+        eslint: ESLINT_DEP_RANGE,
+        "eslint-config-next": ESLINT_CONFIG_NEXT_DEP_RANGE,
+        jsdom: JSDOM_DEP_RANGE,
+        typescript: TYPESCRIPT_DEP_RANGE,
+      },
+    },
+  })
+
+  const nextConfig = ownFile({
+    id,
+    version: PACKAGE_VERSION,
+    description: "Next.js configuration",
+    path: "next.config.ts",
+    content: templates.nextConfig,
+  })
+
+  const starter = Object.entries(STARTER_FILES).map(([path, content]) =>
+    seedFile({ id, version: PACKAGE_VERSION, description: `starter ${path}`, path, content }),
+  )
+
+  const parts = [
+    // `next build` adds these keys to `tsconfig.json` when they are missing, and it requires the
+    // automatic JSX runtime. Declaring them keeps the build from rewriting the owned file.
+    tsconfig({
+      module: "ESNext",
+      dom: true,
+      jsx: "react-jsx",
+      noEmit: true,
+      allowJs: true,
+      incremental: true,
+      plugins: ["next"],
+      include: ["next-env.d.ts", ".next/types/**/*.ts", ".next/dev/types/**/*.ts"],
+    }),
+    gitignores.node(),
+    gitignores.next(),
+    gitignores.tsbuildinfo(),
+    vitest({ environment: "jsdom" }),
+    packageJsonMerge,
+    nextConfig,
+    ...starter,
+  ]
+
+  return {
+    id,
+    version: PACKAGE_VERSION,
+    description:
+      "Next.js App Router + TypeScript app (config, scripts, dependencies and starter source)",
+    permissions: parts.flatMap((part) => part.permissions),
+    plan: Effect.gen(function* () {
+      const changeSets = yield* Effect.forEach(parts, (part) => part.plan)
+      return CS.Reducer.combineAll(changeSets)
+    }),
+  }
+}

package/src/templates.ts

@@ -0,0 +1,86 @@
+/**
+ * Starter source and config for the Next.js app. The seeded files are written once and never
+ * enforced; `nextConfig` is owned and rewritten on every `remodel`.
+ */
+
+export const layoutTsx = `import type { Metadata } from "next"
+import type { ReactNode } from "react"
+import "./globals.css"
+
+export const metadata: Metadata = {
+  title: "Next app",
+  description: "Scaffolded by projitect",
+}
+
+export default function RootLayout({ children }: { readonly children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+`
+
+export const pageTsx = `export default function Page() {
+  return (
+    <main>
+      <h1>Hello from projitect</h1>
+      <p>
+        Edit <code>src/app/page.tsx</code> to get started.
+      </p>
+    </main>
+  )
+}
+`
+
+export const pageTestTsx = `import { cleanup, render, screen } from "@testing-library/react"
+import { afterEach, describe, expect, it } from "vitest"
+import Page from "./page"
+
+afterEach(cleanup)
+
+describe("Page", () => {
+  it("renders the starter heading", () => {
+    render(<Page />)
+    expect(screen.getByRole("heading", { name: "Hello from projitect" })).toBeTruthy()
+  })
+})
+`
+
+export const globalsCss = `:root {
+  font-family: system-ui, sans-serif;
+  color-scheme: light dark;
+}
+
+body {
+  margin: 0;
+  display: grid;
+  min-height: 100vh;
+  place-items: center;
+}
+`
+
+export const eslintConfig = `import { defineConfig, globalIgnores } from "eslint/config"
+import nextVitals from "eslint-config-next/core-web-vitals"
+import nextTs from "eslint-config-next/typescript"
+
+export default defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  globalIgnores([".next/**", "out/**", "next-env.d.ts"]),
+])
+`
+
+export const nextConfig = `import type { NextConfig } from "next"
+
+/**
+ * Next.js configuration scaffolded by \`@projitect/blueprint-next\`.
+ *
+ * Owned mode — projitect rewrites this file on every \`pjt remodel\`.
+ */
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+}
+
+export default nextConfig
+`

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.