nextworks 0.2.0-alpha.5 → 0.2.0-alpha.7

package/README.md

@@ -1,12 +1,28 @@
 # nextworks
 
+## 90-second install demo (silent)
+
+Fresh `create-next-app` + `npx nextworks add blocks --sections --templates`, plus a quick browser tour of the gallery + templates:
+
+[![Nextworks install demo](https://img.youtube.com/vi/7YKmGFmFY5c/hqdefault.jpg)](https://www.youtube.com/watch?v=7YKmGFmFY5c)
+
 Nextworks is a CLI that installs **modular Next.js building blocks** into your app:
 
 - **Blocks** – UI sections, templates, and core UI primitives.
 
 > **Status:** early‑access alpha. Expect rough edges and breaking changes between alpha releases.
 >
-> **Package managers:** npm, pnpm, and yarn are supported.
+> **Support matrix:**
+>
+> **CI-tested:**
+>
+> - OS: Windows, macOS, Linux
+> - Node: 20.x and 22.x
+> - Next.js (sandbox pin): 16.0.7 and 16.1.4 (via create-next-app in CI)
+> - Router: App Router and Pages Router
+> - Package managers: npm, pnpm, yarn
+>
+> Note: CI uses pinned Next.js versions for stability and security (see CVE-2025-66478 / RSC protocol advisory).
 >
 > In this alpha, the most reliable setup is:
 >
@@ -47,6 +63,14 @@ Nextworks is a CLI that installs **modular Next.js building blocks** into your a
 
 ---
 
+## Known issues (alpha)
+
+- **Existing files may be overwritten** if they collide with kit paths. Commit first.
+- **Router entrypoint patching can conflict** with heavily customized `app/layout.tsx` or `pages/_app.tsx`.
+- **Fonts/providers wiring:** Blocks configures fonts in your router entrypoint (not inside shared packages) for Turbopack compatibility. If you manually edit fonts/providers and see errors, re-run the Blocks install to re-apply the patch.
+
+---
+
 ## Safety (read this first)
 
 `nextworks` installs kits by copying files into your Next.js project. If a destination path already exists, kit installs may **overwrite** your files.
@@ -84,6 +108,8 @@ Nextworks is early‑access alpha and I’m actively looking for feedback from e
 - **Start here (installation + where to post feedback):** https://github.com/jblh/nextworks-cli/discussions/1
 - **Alpha feedback thread (what broke / what’s missing):** https://github.com/jblh/nextworks-cli/discussions/2
 
+If you’re reporting an install/runtime issue, please include OS, Node version, Next.js version, package manager, the exact command you ran, and the error output.
+
 ### Bug reports
 
 For reproducible bugs / errors (especially install/runtime issues), please open a GitHub Issue using the templates in `.github/ISSUE_TEMPLATE/`.

package/dist/commands/remove-blocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remove-blocks.d.ts","sourceRoot":"","sources":["../../src/commands/remove-blocks.ts"],"names":[],"mappings":"AAiBA,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE;IAC3C,4DAA4D;IAC5D,EAAE,CAAC,EAAE,OAAO,0BAA0B,EAAE,cAAc,CAAC;CACxD,GAAG,OAAO,CAAC,IAAI,CAAC,CA+ChB"}
+{"version":3,"file":"remove-blocks.d.ts","sourceRoot":"","sources":["../../src/commands/remove-blocks.ts"],"names":[],"mappings":"AAiBA,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE;IAC3C,4DAA4D;IAC5D,EAAE,CAAC,EAAE,OAAO,0BAA0B,EAAE,cAAc,CAAC;CACxD,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEhB"}

package/dist/commands/remove-blocks.js

@@ -7,9 +7,24 @@ const package_manager_1 = require("../utils/package-manager");
 async function removeBlocks(options) {
     console.log("Removing blocks kit...");
     try {
-        const manifestPath = (0, file_operations_1.resolveAssetPath)("cli_manifests", "blocks_manifest.json");
-        const manifest = await (0, file_operations_1.readJsonFile)(manifestPath);
-        const files = manifest.files || [];
+        const config = await (0, installation_tracker_1.getLpkConfig)();
+        const installed = config.installedKits.find((k) => k.name === "blocks");
+        // Prefer removing exactly what was installed (tracked in .nextworks/config.json)
+        // so we don't accidentally delete user-owned files or miss router-mapped paths.
+        let files = installed?.files ?? [];
+        // Fallback: if the kit isn't tracked (older installs), remove the union of
+        // manifest groups plus manifest.files.
+        if (files.length === 0) {
+            const manifestPath = (0, file_operations_1.resolveAssetPath)("cli_manifests", "blocks_manifest.json");
+            const manifest = await (0, file_operations_1.readJsonFile)(manifestPath);
+            const groupFiles = manifest.groups
+                ? Object.values(manifest.groups).flatMap((g) => g?.files ?? [])
+                : [];
+            files = Array.from(new Set([...(manifest.files ?? []), ...groupFiles].filter(Boolean)));
+        }
+        if (files.length === 0) {
+            console.log("ℹ️  No tracked blocks files found to remove (is the blocks kit installed?)");
+        }
         // Get safe-to-remove dependencies (not shared with other kits)
         const safeToRemove = await (0, installation_tracker_1.getSafeToRemoveDependencies)("blocks");
         // Remove files
@@ -26,7 +41,7 @@ async function removeBlocks(options) {
         }
         // Remove from installation tracker
         await (0, installation_tracker_1.removeInstalledKit)("blocks");
-        console.log("✓ blocks kit removed successfully!");
+        console.log("✓ Blocks kit removed successfully!");
         const pm = options?.pm ?? (await (0, package_manager_1.detectPackageManager)(process.cwd()));
         const installCmd = (0, package_manager_1.getInstallCommand)(pm);
         console.log(`\n💡 You may want to run '${installCmd}' to clean up node_modules`);

package/dist/commands/remove-blocks.js.map

@@ -1 +1 @@
-{"version":3,"file":"remove-blocks.js","sourceRoot":"","sources":["../../src/commands/remove-blocks.ts"],"names":[],"mappings":";;AAiBA,oCAkDC;AAnED,8DAMkC;AAClC,wEAGuC;AACvC,8DAGkC;AAG3B,KAAK,UAAU,YAAY,CAAC,OAGlC;IACC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAEtC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAA,kCAAgB,EACnC,eAAe,EACf,sBAAsB,CACvB,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,IAAA,8BAAY,EAAC,YAAY,CAAC,CAAC;QAClD,MAAM,KAAK,GAAa,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;QAE7C,+DAA+D;QAC/D,MAAM,YAAY,GAAG,MAAM,IAAA,kDAA2B,EAAC,QAAQ,CAAC,CAAC;QAEjE,eAAe;QACf,MAAM,IAAA,6BAAW,EAAC,KAAK,CAAC,CAAC;QAEzB,uBAAuB;QACvB,MAAM,IAAA,oCAAkB,EAAC,KAAK,CAAC,CAAC;QAEhC,gCAAgC;QAChC,IACE,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;YACpC,YAAY,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EACvC,CAAC;YACD,MAAM,IAAA,wCAAsB,EAC1B,YAAY,CAAC,YAAY,EACzB,YAAY,CAAC,eAAe,CAC7B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACxE,CAAC;QAED,mCAAmC;QACnC,MAAM,IAAA,yCAAkB,EAAC,QAAQ,CAAC,CAAC;QAEnC,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,MAAM,IAAA,sCAAoB,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,IAAA,mCAAiB,EAAC,EAAE,CAAC,CAAC;QAEzC,OAAO,CAAC,GAAG,CACT,6BAA6B,UAAU,4BAA4B,CACpE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"remove-blocks.js","sourceRoot":"","sources":["../../src/commands/remove-blocks.ts"],"names":[],"mappings":";;AAiBA,oCA0EC;AA3FD,8DAMkC;AAClC,wEAIuC;AACvC,8DAGkC;AAE3B,KAAK,UAAU,YAAY,CAAC,OAGlC;IACC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAEtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,mCAAY,GAAE,CAAC;QACpC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAExE,iFAAiF;QACjF,gFAAgF;QAChF,IAAI,KAAK,GAAa,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC;QAE7C,2EAA2E;QAC3E,uCAAuC;QACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,YAAY,GAAG,IAAA,kCAAgB,EACnC,eAAe,EACf,sBAAsB,CACvB,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,IAAA,8BAAY,EAAC,YAAY,CAAC,CAAC;YAElD,MAAM,UAAU,GAAa,QAAQ,CAAC,MAAM;gBAC1C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;gBACpE,CAAC,CAAC,EAAE,CAAC;YAEP,KAAK,GAAG,KAAK,CAAC,IAAI,CAChB,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CACpE,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CACT,4EAA4E,CAC7E,CAAC;QACJ,CAAC;QAED,+DAA+D;QAC/D,MAAM,YAAY,GAAG,MAAM,IAAA,kDAA2B,EAAC,QAAQ,CAAC,CAAC;QAEjE,eAAe;QACf,MAAM,IAAA,6BAAW,EAAC,KAAK,CAAC,CAAC;QAEzB,uBAAuB;QACvB,MAAM,IAAA,oCAAkB,EAAC,KAAK,CAAC,CAAC;QAEhC,gCAAgC;QAChC,IACE,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;YACpC,YAAY,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EACvC,CAAC;YACD,MAAM,IAAA,wCAAsB,EAC1B,YAAY,CAAC,YAAY,EACzB,YAAY,CAAC,eAAe,CAC7B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACxE,CAAC;QAED,mCAAmC;QACnC,MAAM,IAAA,yCAAkB,EAAC,QAAQ,CAAC,CAAC;QAEnC,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,MAAM,IAAA,sCAAoB,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,IAAA,mCAAiB,EAAC,EAAE,CAAC,CAAC;QAEzC,OAAO,CAAC,GAAG,CACT,6BAA6B,UAAU,4BAA4B,CACpE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -2,18 +2,34 @@
 "use strict";
 // Copyright (c) 2025 Jakob Hansen
 // SPDX-License-Identifier: MIT
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
 const blocks_1 = require("./commands/blocks");
 const remove_blocks_1 = require("./commands/remove-blocks");
 const installation_tracker_1 = require("./utils/installation-tracker");
 const package_manager_1 = require("./utils/package-manager");
 const yarn_pnp_1 = require("./utils/yarn-pnp");
 const program = new commander_1.Command();
+const cliVersion = (() => {
+    try {
+        // When running from dist/, __dirname is: <pkgRoot>/dist
+        const pkgPath = path_1.default.resolve(__dirname, "..", "package.json");
+        const raw = fs_1.default.readFileSync(pkgPath, "utf8");
+        return JSON.parse(raw)?.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+})();
 program
     .name("nextworks")
     .description("Nextworks CLI - Feature kits installer for Next.js apps")
-    .version("0.1.0");
+    .version(cliVersion);
 program
     .command("add <kit>")
     .description("Add a feature kit to your project")

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA,kCAAkC;AAClC,+BAA+B;;AAE/B,yCAAoC;AACpC,8CAA8C;AAC9C,4DAAwD;AACxD,uEAAgE;AAChE,6DAIiC;AACjC,+CAG0B;AAE1B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,mCAAmC,CAAC;KAChD,MAAM,CACL,YAAY,EACZ,wDAAwD,CACzD;KACA,MAAM,CACL,aAAa,EACb,uFAAuF,CACxF;KACA,MAAM,CAAC,WAAW,EAAE,0CAA0C,CAAC;KAC/D,MAAM,CACL,WAAW,EACX,yDAAyD,CAC1D;KACA,MAAM,CACL,WAAW,EACX,6DAA6D,CAC9D;KACA,MAAM,CACL,WAAW,EACX,sEAAsE,CACvE;KACA,MAAM,CACL,KAAK,EACH,GAAW,EACX,OAOC,EACD,EAAE;IACF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC;QAC5B,IAAI,QAAQ,IAAI,CAAC,IAAA,kCAAgB,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,+EAA+E;QAC/E,mDAAmD;QACnD,MAAM,aAAa,GAChB,QAAuC;YACxC,CAAC,MAAM,IAAA,sCAAoB,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAE9C,IAAI,iBAAiB,GAAG,KAAK,CAAC;QAE9B,IACE,aAAa,KAAK,MAAM;YACxB,CAAC,MAAM,IAAA,2BAAgB,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EACvC,CAAC;YACD,yEAAyE;YACzE,IAAI,QAAQ,GAAQ,IAAI,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC;oBACH,MAAM,cAAc,GAAG,MAAM,IAAI,QAAQ,CACvC,2BAA2B,CAC5B,EAAE,CAAC;oBACJ,QAAQ;wBACN,cAAc,EAAE,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,CAAC;gBAC9D,CAAC;gBAAC,MAAM,CAAC;oBACP,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;YAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG;gBAC9B,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,OAAO,CACL,QAAQ;oBACN,CAAC,CAAC,CACE,MAAM,QAAQ,CAAC;wBACb;4BACE,IAAI,EAAE,SAAS;4BACf,IAAI,EAAE,QAAQ;4BACd,OAAO,EACL,4IAA4I;4BAC9I,OAAO,EAAE,IAAI;yBACd;qBACF,CAAC,CACH,CAAC,MAAM;oBACV,CAAC,CAAC,KAAK,CACV,CAAC;YAEN,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,MAAM,IAAA,sCAA2B,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBAChE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,iBAAiB,GAAG,IAAI,CAAC;oBACzB,OAAO,CAAC,GAAG,CACT,aAAa,MAAM,CAAC,QAAQ,4BAA4B,CACzD,CAAC;oBACF,OAAO,CAAC,GAAG,CACT,sEAAsE,CACvE,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CACT,wKAAwK,CACzK,CAAC;YACJ,CAAC;QACH,CAAC;QAED,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ;gBACX,MAAM,IAAA,kBAAS,EAAC;oBACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,EAAE,EAAE,QAAsC;iBAC3C,CAAC,CAAC;gBAEH,IAAI,iBAAiB,EAAE,CAAC;oBACtB,iDAAiD;oBACjD,OAAO,CAAC,GAAG,CACT,8GAA8G,CAC/G,CAAC;gBACJ,CAAC;gBAED,MAAM;YACR;gBACE,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;gBACrC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBAC/B,OAAO,CAAC,GAAG,CACT,mEAAmE,CACpE,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CACF,CAAC;AAEJ,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,wCAAwC,CAAC;KACrD,MAAM,CACL,WAAW,EACX,sEAAsE,CACvE;KACA,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAAwB,EAAE,EAAE;IACtD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC;QAC5B,IAAI,QAAQ,IAAI,CAAC,IAAA,kCAAgB,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ;gBACX,MAAM,IAAA,4BAAY,EAAC,EAAE,EAAE,EAAE,QAAsC,EAAE,CAAC,CAAC;gBACnE,MAAM;YACR;gBACE,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;gBACrC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;gBACzC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,qBAAqB,CAAC;KAClC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,IAAA,uCAAgB,GAAE,CAAC;QAE/C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAC5B,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/kits/blocks/.nextworks/docs/BLOCKS_QUICKSTART.md

@@ -1,116 +1,100 @@
-# Blocks Quickstart
-
-This document explains the Blocks kit: prebuilt UI sections, templates and core UI primitives included in this repository. The Blocks kit is intended to be a non-invasive copyable kit (shadCN-style) you can install into any Next.js project (App Router **or** Pages Router) with TypeScript + Tailwind.
-
-> **Alpha note**
-> Other kits (Auth Core, Forms, Data) are currently tested and supported on top of a default Blocks install.
-> For the smoothest experience, install **Blocks first** in your app before adding other kits.
-
-> If you are using the `nextworks` CLI in your own app, you can install this Blocks kit by running:
->
-> ```bash
-> npx nextworks@latest add blocks --sections --templates
-> ```
->
-> This installs **core UI primitives, sections, and page templates**, so the example templates work out of the box.
-
-The CLI will copy files into your project under `components/`, `lib/`, and `public/`. Template pages are installed in a router-native location:
-
-- **App Router projects:** `app/templates/<template>/**`
-- **Pages Router projects:**
-  - route entry file: `pages/templates/<template>/index.tsx`
-  - supporting template files: `components/templates/<template>/**` (installed outside `pages/` so Next doesn’t treat helpers as routable pages)
-
-What’s included
-
-- Page templates (composed from sections):
-  - `/templates/productlaunch`
-  - `/templates/saasdashboard`
-  - `/templates/digitalagency`
-  - `/templates/gallery`
-- Reusable UI sections: components/sections/\* (Navbar, Hero, Features, Pricing, Testimonials, FAQ, Contact, Footer, etc.)
-- Core UI primitives: components/ui/\* (Button, Input, Card, Select, Checkbox, Switch, Theme toggle/selector, Form primitives)
-- Theme helpers and presets: components/PresetThemeVars in each template and lib/themes.ts
-- Global styles: app/globals.css and optional theme variables in each template's PresetThemeVars file
-- Sample placeholder assets: public/placeholders/\*
-
-Where to look
-
-- Templates:
-  - App Router:
-    - page: `app/templates/<template>/page.tsx`
-    - supporting files: `app/templates/<template>/**`
-  - Pages Router:
-    - page: `pages/templates/<template>/index.tsx`
-    - supporting files: `components/templates/<template>/**`
-- Sections:
-  - components/sections/\*.tsx
-- UI primitives and form building blocks:
-  - components/ui/button.tsx
-  - components/ui/input.tsx
-  - components/ui/label.tsx
-  - components/ui/card.tsx
-  - components/ui/textarea.tsx
-  - components/ui/select.tsx
-  - components/ui/checkbox.tsx
-  - components/ui/switch.tsx
-  - components/ui/form/\* (Form, FormField, FormItem, FormControl, FormLabel, FormMessage, FormDescription)
-- Theme and providers:
-  - components/theme-provider.tsx
-  - components/enhanced-theme-provider.tsx
-  - lib/themes.ts
-
-Minimal steps to render a template locally
-
-1. Install dependencies and run the dev server:
-
-   npm install
-   npm run dev
-
-2. Open the productlaunch template in your browser:
-
-   http://localhost:3000/templates/productlaunch
-
-3. The templates use global styles (`app/globals.css`). No environment variables are required for Blocks-only usage.
-   - App Router: `app/layout.tsx` imports `./globals.css`.
-   - Pages Router: the CLI patches `pages/_app.tsx` to import `../app/globals.css` and `../app/tw-animate.css` so styling matches the templates.
-
-How to adopt / override template pieces
-
-- Slots & component overrides
-  - Each template composes small sections from components/sections/\*.tsx. To override a section, copy the desired section file into your project (or replace the import) and update props or classNames.
-  - Example: to override the Navbar, copy components/sections/Navbar.tsx into your app and update the markup or styles. The template imports Navbar from the components directory.
-
-- Styling and utility classes
-  - Tailwind is used across components. Prefer adding or modifying Tailwind utility classes on the exported component or pass className props (many components accept className).
-
-- Theme variables and PresetThemeVars
-  - Each template has a PresetThemeVars component/file that injects CSS variables for theme presets:
-    - App Router install: `app/templates/<template>/PresetThemeVars.tsx`
-    - Pages Router install: `components/templates/<template>/PresetThemeVars.tsx`
-  - To change default palette or add presets, edit the template PresetThemeVars and lib/themes.ts.
-  - Theme providers are implemented in components/theme-provider.tsx and components/enhanced-theme-provider.tsx — wrap your app with these if you extract blocks into another project.
-
-Import examples
-
-- Import a primitive in your code:
-
-  import Button from "@/components/ui/button";
-  import { Form, FormField } from "@/components/ui/form/form"; // path depends on your project alias
-
-- Use a section in a page:
-
-  import Navbar from "@/components/sections/Navbar";
-
-  export default function Page() {
-  return (
-  <>
-  <Navbar />
-  <main>{/_ ... _/}</main>
-  </>
-  );
-  }
-
-Public assets and placeholders
-
-- The templates reference placeholder images in public/placeholders/. If you copy templates to another project, copy the referenced assets (public/placeholders/gallery/\*) or replace with your own images.
+# Blocks Quickstart (in your project)
+
+This is the fastest path to verify your Blocks install is working and find the right files to edit.
+
+> Blocks is a “copy into your repo” kit (shadcn-style): you own the files and can modify them directly.
+
+---
+
+## 0) Prereqs
+
+- Next.js project (App Router **or** Pages Router)
+- TypeScript + Tailwind CSS
+
+---
+
+## 1) Install Blocks (recommended)
+
+From your app root:
+
+```bash
+npx nextworks@latest add blocks --sections --templates
+npm install
+```
+
+---
+
+## 2) Run dev and verify routes
+
+```bash
+npm run dev
+```
+
+Then visit:
+
+- `http://localhost:3000/templates/productlaunch`
+- `http://localhost:3000/templates/saasdashboard`
+- `http://localhost:3000/templates/digitalagency`
+- `http://localhost:3000/templates/gallery`
+
+If those load and look styled, you’re in good shape.
+
+---
+
+## 3) If styling is missing (quick checks)
+
+Blocks relies on global CSS files:
+
+- `app/globals.css`
+- `app/tw-animate.css`
+
+The correct import location depends on your router:
+
+- **App Router:** `app/layout.tsx` should import `./globals.css` (and `./tw-animate.css` if used).
+- **Pages Router:** `pages/_app.tsx` should import:
+  - `../app/globals.css`
+  - `../app/tw-animate.css`
+
+The CLI normally patches this automatically.
+
+---
+
+## 4) Where the files are
+
+### Template routes
+
+- **App Router:** `app/templates/<template>/page.tsx`
+- **Pages Router:** `pages/templates/<template>/index.tsx`
+
+Supporting template components live alongside the template:
+
+- App Router: `app/templates/<template>/**`
+- Pages Router: `components/templates/<template>/**` (kept outside `pages/` so helpers aren’t treated as pages)
+
+### Sections and UI primitives
+
+- Sections: `components/sections/**`
+- UI primitives: `components/ui/**`
+
+---
+
+## 5) What to edit first (common tasks)
+
+- Customize a template page:
+  - edit its route file (see paths above)
+  - tweak the imported sections/components
+
+- Customize a reusable section (Navbar/Hero/etc.):
+  - edit `components/sections/<Section>.tsx`
+
+- Customize theme/palette:
+  - see `.nextworks/docs/THEME_GUIDE.md`
+  - start with `lib/themes.ts`
+  - each template has a `PresetThemeVars` file you can modify
+
+---
+
+## 6) Need deeper detail?
+
+- `.nextworks/docs/BLOCKS_README.md` (what got installed + where things live)
+- `.nextworks/docs/THEME_GUIDE.md` (theme system + presets)

package/dist/kits/blocks/.nextworks/docs/BLOCKS_README.md

@@ -1,68 +1,105 @@
-Blocks kit (cli/kits/blocks)
+# Blocks kit
 
-This folder contains the files that the CLI copies into a target Next.js project when installing the "blocks" kit.
+This folder is the **Blocks kit** installed by the Nextworks CLI. It’s copied into your Next.js project so you can edit everything locally (shadcn-style): components, sections, templates, and theme utilities.
 
-What the kit includes
+If you’re reading this inside your app repo, you’ll also find companion docs at:
 
-- UI primitive components (Button, Input, Card, Form primitives, Checkbox, Switch, Toaster)
-- Sections and templates (About, CTA, Contact, Hero variants, Navbar, Pricing, Features, etc.)
-- Theme and provider utilities (theme-provider, enhanced-theme-provider, lib/themes)
-- app/globals.css and placeholder assets used by templates
+- `.nextworks/docs/BLOCKS_QUICKSTART.md` (start here)
+- `.nextworks/docs/THEME_GUIDE.md`
 
-Install behavior
+---
 
-> **Alpha note**
-> Other kits (Auth Core, Forms, Data) are currently tested and supported on top of a Blocks install that includes sections and templates. For the smoothest experience, run `npx nextworks@latest add blocks --sections --templates` before adding additional kits.
+## What this adds to your project
 
-- For a full UI kit, run `npx nextworks@latest add blocks --sections --templates` to install **core UI primitives, sections, and templates** so the example templates work out of the box.
-- You can pass flags to control what gets installed:
-  - `npx nextworks@latest add blocks --ui-only` → core UI primitives only (no sections/templates).
-  - `npx nextworks@latest add blocks --sections` → core + sections only.
-  - `npx nextworks@latest add blocks --templates` → core + templates only.
-  - `npx nextworks@latest add blocks --sections --templates` → same as the default (core + sections + templates).
+Depending on install flags, Blocks adds:
 
-Files included are defined in `cli/cli_manifests/blocks_manifest.json` in the Nextworks repository. When updating this kit inside the repo, keep that manifest and this kit folder in sync.
+- **UI primitives** under `components/ui/**` (Button, Input, Card, Select, Checkbox, Switch, Toaster, etc.)
+- **Reusable marketing sections** under `components/sections/**` (Navbar, Hero variants, Features, Pricing, Testimonials, FAQ, Contact, Footer, …)
+- **Full page templates** under a router-native path (see below)
+- **Theme + provider utilities** under `components/**` and `lib/**`
+- **Global styles**: `app/globals.css` and `app/tw-animate.css`
+- **Placeholder images** under `public/placeholders/**`
 
-Post-install notes
+---
 
-1. Install dependencies copied by the kit (the CLI will merge package-deps.json into your package.json):
+## Install commands / options
 
+> ```bash
+> npx nextworks@latest add blocks --sections --templates
+> ```
+
+Blocks supports these install shapes:
+
+- `npx nextworks@latest add blocks --ui-only` → core UI primitives only
+- `npx nextworks@latest add blocks --sections` → core + sections
+- `npx nextworks@latest add blocks --templates` → core + templates
+- `npx nextworks@latest add blocks --sections --templates` → core + sections + templates (recommended)
+
+---
+
+## After install: what to run
+
+1. Install merged dependencies:
+
+   ```bash
    npm install
+   ```
+
+2. Start dev:
+
+   ```bash
+   npm run dev
+   ```
+
+3. Visit template routes (when templates are installed):
+   - `/templates/productlaunch`
+   - `/templates/saasdashboard`
+   - `/templates/digitalagency`
+   - `/templates/gallery`
+
+---
+
+## Where templates live (App Router vs Pages Router)
+
+Templates are installed in a router-native location:
+
+- **App Router:**
+  - `app/templates/<template>/page.tsx`
+  - `app/templates/<template>/**`
+
+- **Pages Router:**
+  - route entry file: `pages/templates/<template>/index.tsx`
+  - supporting template files: `components/templates/<template>/**` (kept outside `pages/` so helpers are not treated as routable pages)
+
+---
+
+## Required wiring (providers + CSS)
+
+Blocks expects your app to be wrapped in the kit’s local `AppProviders`.
+
+- **App Router:** patched in `app/layout.tsx`
+- **Pages Router:** patched in `pages/_app.tsx` (and may create/update `pages/_document.tsx`)
+
+The CLI normally patches this automatically.
+
+Notes:
+
+- Pages Router installs also ensure CSS imports exist in `pages/_app.tsx`:
+  - `../app/globals.css`
+  - `../app/tw-animate.css`
+- The kit’s `components/app-providers.*` wrappers are **local kit providers** (they wrap the kit-local `BlocksAppProviders`) so providers/hooks resolve to the same React context instance under Turbopack/HMR.
+
+---
+
+## What to edit first
+
+- Want to change the look/branding quickly? Start with:
+  - `.nextworks/docs/THEME_GUIDE.md`
+  - `lib/themes.ts`
+  - each template’s `PresetThemeVars` file
+
+- Want to customize a section (Navbar/Hero/etc.)?
+  - edit files directly under `components/sections/**`
 
-2. Wrap your app with the AppProviders wrapper (the CLI patches this automatically).
-   - App Router: `app/layout.tsx`
-   - Pages Router: `pages/_app.tsx`
-
-   Example (App Router):
-
-   // at the top of app/layout.tsx
-   import "./globals.css"; // optional if you already import it elsewhere in your project
-   import AppProviders from "@/components/app-providers";
-
-   export default function RootLayout({ children }) {
-   return (
-   <html lang="en">
-   <body>
-   <AppProviders>
-   {children}
-   </AppProviders>
-   </body>
-   </html>
-   );
-   }
-
-   Notes:
-   - The kit’s `components/app-providers.*` files are **local kit providers** (they wrap with the kit-local `BlocksAppProviders`), so templates/hooks and providers resolve to the same React context instance under Turbopack/HMR.
-   - On Pages Router installs, the CLI also ensures kit CSS imports are present in `pages/_app.tsx`:
-     - `../app/globals.css`
-     - `../app/tw-animate.css`
-
-3. Ensure `app/globals.css` exists in your project and that Tailwind is configured (the Blocks kit expects Tailwind).
-
-4. Templates are installed in a router-native location:
-   - App Router: `app/templates/<template>/**`
-   - Pages Router:
-     - route entry file: `pages/templates/<template>/index.tsx`
-     - supporting template files: `components/templates/<template>/**`
-
-5. Placeholder assets are located under `public/placeholders`. These should already have been copied by the CLI; if you move files around, keep the paths aligned or update the template image references.
+- Want to customize a template page?
+  - edit the template route file (see paths above) and its local components.

package/dist/kits/blocks/package-deps.json

@@ -13,9 +13,9 @@
     "next-themes": "^0.4.6",
     "motion": "^12.24.10",
     "sonner": "^2.0.7",
-    "@nextworks/blocks-core": "0.2.0-alpha.5",
-    "@nextworks/blocks-sections": "0.2.0-alpha.5",
-    "@nextworks/blocks-templates": "0.2.0-alpha.5"
+    "@nextworks/blocks-core": "0.2.0-alpha.7",
+    "@nextworks/blocks-sections": "0.2.0-alpha.7",
+    "@nextworks/blocks-templates": "0.2.0-alpha.7"
   },
   "devDependencies": {
     "tailwindcss": "^4.1.12"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextworks",
-  "version": "0.2.0-alpha.5",
+  "version": "0.2.0-alpha.7",
   "description": "Nextworks CLI - Blocks installer for Next.js apps",
   "main": "dist/index.js",
   "bin": {