nextworks 0.2.0-alpha.7 → 0.2.0-alpha.9

package/dist/commands/blocks.js

@@ -37,7 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addBlocks = addBlocks;
-// inquirer is ESM-only. Use dynamic import() at runtime to avoid require() errors when CLI is compiled to CommonJS.
+// `inquirer` is ESM-only; load it via runtime `import()` for CJS builds and fall back if unavailable.
 const file_operations_1 = require("../utils/file-operations");
 const installation_tracker_1 = require("../utils/installation-tracker");
 const package_manager_1 = require("../utils/package-manager");
@@ -53,7 +53,7 @@ async function addBlocks(options = {}) {
         // Behavior:
         // - No flags: install core + sections + templates by default.
         // - --sections: install core + sections only.
-        // - --templates: install core + templates only.
+        // - --templates: install core + sections + templates only.
         // - --sections --templates: core + sections + templates (same as default).
         // - --ui-only: install core only (bare UI primitives, no sections/templates).
         const explicitGroups = [];
@@ -61,6 +61,105 @@ async function addBlocks(options = {}) {
             typeof options.templates === "boolean" ||
             typeof options.gallery === "boolean" ||
             typeof options.uiOnly === "boolean";
+        if (options.dryRun) {
+            // Dry-run: compute the same install plan as a real run, but don't write anything.
+            let groupsToInstall = [];
+            if (options.uiOnly) {
+                // uiOnly overrides other flags if set
+                console.log("Flag: --ui-only");
+                groupsToInstall = manifest.groups
+                    ? ["core"].filter((g) => g in manifest.groups)
+                    : [];
+            }
+            else if (anyGroupFlag) {
+                if (options.sections)
+                    explicitGroups.push("sections");
+                if (options.templates)
+                    explicitGroups.push("sections", "templates");
+                if (options.gallery)
+                    explicitGroups.push("sections", "gallery");
+                console.log("Flags: " + explicitGroups.join(", "));
+                groupsToInstall = manifest.groups
+                    ? ["core", ...explicitGroups].filter((g) => g in manifest.groups)
+                    : [];
+            }
+            else {
+                // Default: core + sections
+                console.log("No flags passed");
+                explicitGroups.push("sections");
+                groupsToInstall = manifest.groups
+                    ? ["core", ...explicitGroups].filter((g) => g in manifest.groups)
+                    : [];
+            }
+            const files = groupsToInstall.length > 0 && manifest.groups
+                ? groupsToInstall.flatMap((groupName) => {
+                    const group = manifest.groups?.[groupName];
+                    return group?.files ?? [];
+                })
+                : manifest.files || [];
+            const filesToCopy = [];
+            const missingFiles = [];
+            for (const file of files) {
+                const kitSource = path_1.default.join(kitDir, file);
+                if (await (0, file_operations_1.fileExists)(kitSource)) {
+                    filesToCopy.push(file);
+                    continue;
+                }
+                const projectSource = path_1.default.join(process.cwd(), file);
+                if (await (0, file_operations_1.fileExists)(projectSource)) {
+                    console.log(`ℹ️  Skipping ${file} (already exists in project)`);
+                    continue;
+                }
+                missingFiles.push(file);
+            }
+            console.log("Blocks kit - dry-run ...");
+            console.log("Files to be copied into project:");
+            filesToCopy.forEach((file) => console.log(file));
+            // Read kit dependencies (but do not write package.json).
+            const depsPath = path_1.default.join(kitDir, "package-deps.json");
+            try {
+                const deps = await (0, file_operations_1.readJsonFile)(depsPath);
+                console.log("Dependencies:");
+                console.log(deps);
+            }
+            catch {
+                console.log("⚠️  No package-deps.json found for blocks or failed to read it");
+            }
+            if (missingFiles.length > 0) {
+                console.log("\n⚠️ The following files referenced by the blocks manifest were not found in the kit:");
+                missingFiles.forEach((f) => console.log(`  • ${f}`));
+            }
+            // Patching plan (no changes are made in dry-run).
+            const mode = await (0, file_operations_1.detectProjectRootMode)(process.cwd());
+            const detectedLayoutPath = mode === "src" ? "src/app/layout.tsx" : "app/layout.tsx";
+            const detectedPagesAppPath = mode === "src" ? "src/pages/_app.tsx" : "pages/_app.tsx";
+            const appRouterLayoutExists = await (0, file_operations_1.fileExists)(detectedLayoutPath);
+            const pagesRouterAppExists = await (0, file_operations_1.fileExists)(detectedPagesAppPath);
+            if (appRouterLayoutExists && pagesRouterAppExists) {
+                console.log(`Would patch ${detectedLayoutPath} (wrap with AppProviders)`);
+                console.log(`Would patch ${detectedPagesAppPath} (wrap with AppProviders)`);
+                console.log(`Would ensure ${mode === "src" ? "src/pages/_document.tsx" : "pages/_document.tsx"} includes suppressHydrationWarning`);
+            }
+            else if (appRouterLayoutExists) {
+                console.log(`Would patch ${detectedLayoutPath} (wrap with AppProviders)`);
+            }
+            else if (pagesRouterAppExists) {
+                console.log(`Would patch ${detectedPagesAppPath} (wrap with AppProviders)`);
+                console.log(`Would ensure ${mode === "src" ? "src/pages/_document.tsx" : "pages/_document.tsx"} includes suppressHydrationWarning`);
+            }
+            else {
+                console.log("ℹ️  No router entrypoints detected for patching (expected app/layout.tsx or pages/_app.tsx)");
+            }
+            // Where templates live (router-dependent; URLs are the same).
+            if (pagesRouterAppExists && !appRouterLayoutExists) {
+                console.log(`  (Pages Router install: files live under ${mode === "src" ? "src/pages/templates/<template>/index.tsx" : "pages/templates/<template>/index.tsx"})`);
+            }
+            else {
+                console.log(`  (App Router install: files live under ${mode === "src" ? "src/app/templates" : "app/templates"})`);
+            }
+            console.log("No changes were made.");
+            return;
+        }
         if (options.uiOnly) {
             // uiOnly overrides other flags if set
             const groupsToInstall = manifest.groups
@@ -119,15 +218,19 @@ async function addBlocks(options = {}) {
         if (anyGroupFlag) {
             if (options.sections)
                 explicitGroups.push("sections");
-            if (options.templates)
+            if (options.templates) {
+                explicitGroups.push("sections");
                 explicitGroups.push("templates");
-            if (options.gallery)
+            }
+            if (options.gallery) {
+                explicitGroups.push("sections");
                 explicitGroups.push("gallery");
+            }
         }
         else {
             // No flags passed: include sections and templates by default so templates
             // always have their section dependencies available.
-            explicitGroups.push("sections", "templates");
+            explicitGroups.push("sections");
         }
         const groupsToInstall = manifest.groups
             ? ["core", ...explicitGroups].filter((g) => g in manifest.groups)
@@ -204,8 +307,8 @@ async function addBlocks(options = {}) {
         }
         const appRouterLayoutExists = await (0, file_operations_1.fileExists)(detectedLayoutPath);
         const pagesRouterAppExists = await (0, file_operations_1.fileExists)(detectedPagesAppPath);
-        // Hybrid projects (common with create-next-app) may have both /app and /pages.
-        // In that case we should patch BOTH entrypoints so routes in either router
+        // Hybrid projects may have both /app and /pages.
+        // In that case patch BOTH entrypoints so routes in either router
         // are wrapped with providers.
         if (appRouterLayoutExists && pagesRouterAppExists) {
             try {
@@ -288,7 +391,7 @@ async function addBlocks(options = {}) {
                     // Make app-providers.tsx point at the Pages-safe implementation.
                     // (The kit defaults to App Router; Pages Router can't import @nextworks/blocks-core/server.)
                     //
-                    // Patch whichever path exists (some repos have src/pages but root-level components/).
+                    // Patch whichever path exists.
                     const candidateAppProvidersPaths = [
                         "components/app-providers.tsx",
                         "src/components/app-providers.tsx",
@@ -321,7 +424,7 @@ async function addBlocks(options = {}) {
                         // Make app-providers.tsx point at the Pages-safe implementation.
                         // (The kit defaults to App Router; Pages Router can't import @nextworks/blocks-core/server.)
                         //
-                        // Patch whichever path exists (some repos have src/pages but root-level components/).
+                        // Patch whichever path exists.
                         const candidateAppProvidersPaths = [
                             "components/app-providers.tsx",
                             "src/components/app-providers.tsx",
@@ -384,4 +487,428 @@ async function addBlocks(options = {}) {
         throw error;
     }
 }
+// export async function dryRunAddBlocks(
+//   options: AddBlocksOptions = {},
+// ): Promise<void> {
+//   // - This should do whatever addBlocks does EXCEPT actually copying files.
+//   console.log("Dry-run blocks kit...");
+//   try {
+//     const kitDir = resolveAssetPath("kits", "blocks");
+//     const manifestPath = resolveAssetPath(
+//       "cli_manifests",
+//       "blocks_manifest.json",
+//     );
+//     const manifest = (await readJsonFile(manifestPath)) as BlocksManifest;
+//     // Decide which groups to install.
+//     // Core is always included to satisfy the contract that sections/templates rely on core.
+//     // Behavior:
+//     // - No flags: install core + sections + templates by default.
+//     // - --sections: install core + sections only.
+//     // - --templates: install core + templates only.
+//     // - --sections --templates: core + sections + templates (same as default).
+//     // - --ui-only: install core only (bare UI primitives, no sections/templates).
+//     const explicitGroups: string[] = [];
+//     const anyGroupFlag =
+//       typeof options.sections === "boolean" ||
+//       typeof options.templates === "boolean" ||
+//       typeof options.gallery === "boolean" ||
+//       typeof options.uiOnly === "boolean";
+//     if (options.uiOnly) {
+//       // uiOnly overrides other flags if set
+//       const groupsToInstall: string[] = manifest.groups
+//         ? ["core"].filter((g) => g in manifest.groups!)
+//         : [];
+//       const files: string[] =
+//         groupsToInstall.length > 0 && manifest.groups
+//           ? groupsToInstall.flatMap((groupName) => {
+//               const group = manifest.groups?.[groupName];
+//               return group?.files ?? [];
+//             })
+//           : manifest.files || [];
+//       const filesToCopy: string[] = [];
+//       const missingFiles: string[] = [];
+//       for (const file of files) {
+//         const kitSource = path.join(kitDir, file);
+//         if (await fileExists(kitSource)) {
+//           filesToCopy.push(file);
+//         } else {
+//           const projectSource = path.join(process.cwd(), file);
+//           if (await fileExists(projectSource)) {
+//             console.log(`ℹ️  Skipping ${file} (already exists in project)`);
+//           } else {
+//             missingFiles.push(file);
+//           }
+//         }
+//       }
+//       // - Logging filesToCopy
+//       console.log("Blocks kit dry-run ...");
+//       console.log("Files to be copied into project:");
+//       filesToCopy.map((file) => {
+//         console.log(file);
+//       });
+//       // if (filesToCopy.length > 0) {
+//       //   await copyFiles(kitDir, process.cwd(), filesToCopy);
+//       // } else {
+//       //   console.log(
+//       //     "⚠️  No files to copy from the blocks kit (all files missing or already present)",
+//       //   );
+//       // }
+//       // -
+//       // Update package.json and track install as usual
+//       const depsPath = path.join(kitDir, "package-deps.json");
+//       let deps: any = {};
+//       try {
+//         deps = await readJsonFile(depsPath);
+//         // - For now, I simply console.log the deps object, which is not the final thing,
+//         // - as user might already have some of the dependencies installed.
+//         // - Go into file-operations, see exactly
+//         // - what happens in updatePackageJson right before it writes so package.json
+//         // - Dry-run log dependencies
+//         console.log("Dependencies of the blocks kit:");
+//         console.log(deps);
+//         // await updatePackageJson(deps, {
+//         //   pm: options.pm ?? (await detectPackageManager(process.cwd())),
+//         // });
+//       } catch (err) {
+//         console.log(
+//           "⚠️  No package-deps.json found for blocks or failed to read it",
+//         );
+//       }
+//       // await addInstalledKit(
+//       //   "blocks",
+//       //   Object.keys(deps.dependencies || {}),
+//       //   Object.keys(deps.devDependencies || {}),
+//       //   filesToCopy,
+//       // );
+//       // console.log(
+//       //   "✓ blocks core UI primitives installed successfully (ui-only mode)!",
+//       // );
+//       // if (missingFiles.length > 0) {
+//       //   console.log(
+//       //     "\n⚠️ The following files referenced by the blocks manifest were not found in the kit and were not copied:",
+//       //   );
+//       //   missingFiles.forEach((f) => console.log(`  • ${f}`));
+//       //   console.log(
+//       //     "You may need to copy these files manually (for example placeholder assets under public/placeholders) or reconcile the kit files.",
+//       //   );
+//       // }
+//       return;
+//     }
+//     if (anyGroupFlag) {
+//       if (options.sections) explicitGroups.push("sections");
+//       if (options.templates) explicitGroups.push("templates");
+//       if (options.gallery) explicitGroups.push("gallery");
+//     } else {
+//       // No flags passed: include sections and templates by default so templates
+//       // always have their section dependencies available.
+//       explicitGroups.push("sections", "templates");
+//     }
+//     const groupsToInstall: string[] = manifest.groups
+//       ? ["core", ...explicitGroups].filter((g) => g in manifest.groups!)
+//       : [];
+//     const files: string[] =
+//       groupsToInstall.length > 0 && manifest.groups
+//         ? groupsToInstall.flatMap((groupName) => {
+//             const group = manifest.groups?.[groupName];
+//             return group?.files ?? [];
+//           })
+//         : manifest.files || [];
+//     const filesToCopy: string[] = [];
+//     const missingFiles: string[] = [];
+//     // Determine which files are present in the kit and which are missing
+//     for (const file of files) {
+//       const kitSource = path.join(kitDir, file);
+//       // If the file exists in the kit, schedule it for copy
+//       if (await fileExists(kitSource)) {
+//         filesToCopy.push(file);
+//       } else {
+//         // If the file is already present in the user's project root, skip copying
+//         const projectSource = path.join(process.cwd(), file);
+//         if (await fileExists(projectSource)) {
+//           console.log(`ℹ️  Skipping ${file} (already exists in project)`);
+//         } else {
+//           missingFiles.push(file);
+//         }
+//       }
+//     }
+//     // - Logging filesToCopy
+//     console.log("Blocks kit dry-run ...");
+//     console.log("Files to be copied into project:");
+//     filesToCopy.map((file) => {
+//       console.log(file);
+//     });
+//     // Copy available files
+//     // if (filesToCopy.length > 0) {
+//     //   await copyFiles(kitDir, process.cwd(), filesToCopy);
+//     // } else {
+//     //   console.log(
+//     //     "⚠️  No files to copy from the blocks kit (all files missing or already present)",
+//     //   );
+//     // }
+//     // Update package.json with dependencies from the kit
+//     const depsPath = path.join(kitDir, "package-deps.json");
+//     let deps: any = {};
+//     try {
+//       deps = await readJsonFile(depsPath);
+//       // - Dry-run log dependencies
+//       console.log("Dependencies of the blocks kit:");
+//       console.log(deps);
+//       // await updatePackageJson(deps, {
+//       //   pm: options.pm ?? (await detectPackageManager(process.cwd())),
+//       // });
+//     } catch (err) {
+//       console.log(
+//         "⚠️  No package-deps.json found for blocks or failed to read it",
+//       );
+//     }
+//     // Track the installation
+//     // await addInstalledKit(
+//     //   "blocks",
+//     //   Object.keys(deps.dependencies || {}),
+//     //   Object.keys(deps.devDependencies || {}),
+//     //   filesToCopy,
+//     // );
+//     // console.log("✓ blocks kit installed successfully!");
+//     // - ------------------------------------------------------------
+//     // - Dry-run log patching of layout.tsx / _app.tsx:
+//     // let layoutUpgraded = false;
+//     // let pagesAppUpgraded = false;
+//     // Offer to auto-upgrade the root layout to use AppProviders (App Router)
+//     // (supports both root app/layout.tsx and src/app/layout.tsx)
+//     // const mode = await detectProjectRootMode(process.cwd());
+//     // const detectedLayoutPath =
+//     //   mode === "src" ? "src/app/layout.tsx" : "app/layout.tsx";
+//     // const detectedPagesAppPath =
+//     //   mode === "src" ? "src/pages/_app.tsx" : "pages/_app.tsx";
+//     // Dynamically load inquirer to avoid ESM/CJS interop issues when
+//     // the CLI is compiled to CommonJS but inquirer is ESM-only.
+//     // let promptFn: any;
+//     // try {
+//     //   // Use a runtime dynamic import via the Function constructor to ensure
+//     //   // we call the native import() at runtime and avoid TypeScript
+//     //   // transpilation turning this into a require() call.
+//     //   const inquirerModule = await new Function('return import("inquirer")')();
+//     //   // inquirer exports a default object with prompt; support both shapes
+//     //   promptFn = inquirerModule?.default?.prompt ?? inquirerModule?.prompt;
+//     // } catch (err) {
+//     //   console.log(
+//     //     "⚠️  Could not load optional interactive prompt (inquirer). Skipping optional prompts.",
+//     //   );
+//     //   promptFn = null;
+//     // }
+//     // const appRouterLayoutExists = await fileExists(detectedLayoutPath);
+//     // const pagesRouterAppExists = await fileExists(detectedPagesAppPath);
+//     // Hybrid projects may have both /app and /pages.
+//     // In that case patch BOTH entrypoints so routes in either router
+//     // are wrapped with providers.
+//     // if (appRouterLayoutExists && pagesRouterAppExists) {
+//     //   try {
+//     //     await updateLayoutWithAppProviders();
+//     //     layoutUpgraded = true;
+//     //   } catch (err) {
+//     //     console.log("⚠️  Failed to update app/layout.tsx automatically:", err);
+//     //   }
+//     //   try {
+//     //     await updatePagesAppWithAppProviders();
+//     //     await ensurePagesDocumentSuppressHydrationWarning();
+//     //     // Ensure pages/_app.tsx uses the Pages-safe AppProviders implementation.
+//     //     const candidatePagesAppProvidersPaths = [
+//     //       "components/app-providers.pages.tsx",
+//     //       "src/components/app-providers.pages.tsx",
+//     //     ];
+//     //     for (const appProvidersPath of candidatePagesAppProvidersPaths) {
+//     //       if (await fileExists(appProvidersPath)) {
+//     //         const fsExtraModule = await import("fs-extra");
+//     //         await fsExtraModule.default.writeFile(
+//     //           appProvidersPath,
+//     //           '"use client";\n\nimport * as React from "react";\n\nimport { BlocksAppProviders } from "./providers/BlocksAppProviders";\n\nexport default function AppProviders({ children }: { children: React.ReactNode }) {\n  return (\n    <div className="antialiased">\n      <BlocksAppProviders>{children}</BlocksAppProviders>\n    </div>\n  );\n}\n',
+//     //         );
+//     //       }
+//     //     }
+//     //     // Ensure root components/app-providers.tsx points to the App Router variant
+//     //     // so app/layout.tsx imports the correct implementation.
+//     //     const candidateRootAppProvidersPaths = [
+//     //       "components/app-providers.tsx",
+//     //       "src/components/app-providers.tsx",
+//     //     ];
+//     //     for (const appProvidersPath of candidateRootAppProvidersPaths) {
+//     //       if (await fileExists(appProvidersPath)) {
+//     //         const fsExtraModule = await import("fs-extra");
+//     //         await fsExtraModule.default.writeFile(
+//     //           appProvidersPath,
+//     //           'export { default } from "./app-providers.app";\n',
+//     //         );
+//     //       }
+//     //     }
+//     //     pagesAppUpgraded = true;
+//     //   } catch (err) {
+//     //     console.log("⚠️  Failed to update pages/_app.tsx automatically:", err);
+//     //   }
+//     // } else if (appRouterLayoutExists) {
+//     //   if (options.yes) {
+//     //     try {
+//     //       await updateLayoutWithAppProviders();
+//     //       layoutUpgraded = true;
+//     //     } catch (err) {
+//     //       console.log(
+//     //         "⚠️  Failed to update app/layout.tsx automatically:",
+//     //         err,
+//     //       );
+//     //     }
+//     //   } else if (promptFn) {
+//     //     const { upgradeLayout } = await promptFn([
+//     //       {
+//     //         type: "confirm",
+//     //         name: "upgradeLayout",
+//     //         message: `Would you like the CLI to automatically wrap your ${detectedLayoutPath} with AppProviders and add suppressHydrationWarning to the <html> tag?`,
+//     //         default: true,
+//     //       },
+//     //     ]);
+//     //     if (upgradeLayout) {
+//     //       try {
+//     //         await updateLayoutWithAppProviders();
+//     //         layoutUpgraded = true;
+//     //       } catch (err) {
+//     //         console.log(
+//     //           "⚠️  Failed to update app/layout.tsx automatically:",
+//     //           err,
+//     //         );
+//     //       }
+//     //     }
+//     //   }
+//     // } else if (await fileExists(detectedPagesAppPath)) {
+//     //   // Pages Router support:
+//     //   // - patch pages/_app.tsx (+ ensure _document.tsx hydration safety)
+//     //   // - switch the kit-provided app-providers entrypoint to the Pages-safe variant
+//     //   if (options.yes) {
+//     //     try {
+//     //       await updatePagesAppWithAppProviders();
+//     //       await ensurePagesDocumentSuppressHydrationWarning();
+//     //       // Make app-providers.tsx point at the Pages-safe implementation.
+//     //       // (The kit defaults to App Router; Pages Router can't import @nextworks/blocks-core/server.)
+//     //       //
+//     //       // Patch whichever path exists.
+//     //       const candidateAppProvidersPaths = [
+//     //         "components/app-providers.tsx",
+//     //         "src/components/app-providers.tsx",
+//     //       ];
+//     //       for (const appProvidersPath of candidateAppProvidersPaths) {
+//     //         if (await fileExists(appProvidersPath)) {
+//     //           const fsExtraModule = await import("fs-extra");
+//     //           await fsExtraModule.default.writeFile(
+//     //             appProvidersPath,
+//     //             'export { default } from "./app-providers.pages";\n',
+//     //           );
+//     //         }
+//     //       }
+//     //       pagesAppUpgraded = true;
+//     //     } catch (err) {
+//     //       console.log(
+//     //         "⚠️  Failed to update pages/_app.tsx automatically:",
+//     //         err,
+//     //       );
+//     //     }
+//     //   } else if (promptFn) {
+//     //     const { upgradePagesApp } = await promptFn([
+//     //       {
+//     //         type: "confirm",
+//     //         name: "upgradePagesApp",
+//     //         message: `Would you like the CLI to automatically wrap your ${detectedPagesAppPath} with AppProviders (and ensure suppressHydrationWarning in pages/_document.tsx)?`,
+//     //         default: true,
+//     //       },
+//     //     ]);
+//     //     if (upgradePagesApp) {
+//     //       try {
+//     //         await updatePagesAppWithAppProviders();
+//     //         await ensurePagesDocumentSuppressHydrationWarning();
+//     //         // Make app-providers.tsx point at the Pages-safe implementation.
+//     //         // (The kit defaults to App Router; Pages Router can't import @nextworks/blocks-core/server.)
+//     //         //
+//     //         // Patch whichever path exists.
+//     //         const candidateAppProvidersPaths = [
+//     //           "components/app-providers.tsx",
+//     //           "src/components/app-providers.tsx",
+//     //         ];
+//     //         for (const appProvidersPath of candidateAppProvidersPaths) {
+//     //           if (await fileExists(appProvidersPath)) {
+//     //             const fsExtraModule = await import("fs-extra");
+//     //             await fsExtraModule.default.writeFile(
+//     //               appProvidersPath,
+//     //               'export { default } from "./app-providers.pages";\n',
+//     //             );
+//     //           }
+//     //         }
+//     //         pagesAppUpgraded = true;
+//     //       } catch (err) {
+//     //         console.log(
+//     //           "⚠️  Failed to update pages/_app.tsx automatically:",
+//     //           err,
+//     //         );
+//     //       }
+//     //     }
+//     //   }
+//     // }
+//     // console.log("\n📋 Next steps:");
+//     // console.log("- Templates added. Try these routes in your browser:");
+//     // console.log("    /templates/productlaunch");
+//     // console.log("    /templates/saasdashboard");
+//     // console.log("    /templates/digitalagency");
+//     // console.log("    /templates/gallery  (blocks gallery)");
+//     // - The dry-run should log WHERE files are installed depending on router type ...
+//     // Note: depending on router type, the templates are installed into different folders,
+//     // but the URLs are the same.
+//     // if (pagesRouterAppExists && !appRouterLayoutExists) {
+//     //   console.log(
+//     //     `  (Pages Router install: files live under ${mode === "src" ? "src/pages/templates/<template>/index.tsx" : "pages/templates/<template>/index.tsx"})`,
+//     //   );
+//     // } else {
+//     //   console.log(
+//     //     `  (App Router install: files live under ${mode === "src" ? "src/app/templates" : "app/templates"})`,
+//     //   );
+//     // }
+//     // const pm = options.pm ?? (await detectPackageManager(process.cwd()));
+//     // const installCmd = getInstallCommand(pm);
+//     // if (layoutUpgraded) {
+//     //   console.log(
+//     //     `1. ${detectedLayoutPath} was updated to wrap the app with AppProviders and add suppressHydrationWarning.`,
+//     //   );
+//     //   console.log(
+//     //     "2. Ensure Tailwind is configured and app/globals.css is present (copied if available).",
+//     //   );
+//     //   console.log(`3. Install new dependencies: ${installCmd}`);
+//     // } else if (pagesAppUpgraded) {
+//     //   console.log(
+//     //     `1. ${detectedPagesAppPath} was updated to wrap the app with AppProviders (and fonts).`,
+//     //   );
+//     //   console.log(
+//     //     "2. pages/_document.tsx was ensured/updated to include suppressHydrationWarning.",
+//     //   );
+//     //   console.log(`3. Install new dependencies: ${installCmd}`);
+//     // } else {
+//     //   console.log(
+//     //     `1. Wrap your app with the AppProviders wrapper in ${detectedLayoutPath} (App Router) or ${detectedPagesAppPath} (Pages Router):`,
+//     //   );
+//     //   console.log('   import AppProviders from "@/components/app-providers";');
+//     //   console.log(
+//     //     "   Wrap your application with <AppProviders> to enable fonts, presets, CSS variable injection, session provider, and the app toaster.",
+//     //   );
+//     //   console.log(
+//     //     "2. Ensure Tailwind is configured and app/globals.css is present (copied if available).",
+//     //   );
+//     //   console.log(`3. Install new dependencies: ${installCmd}`);
+//     // }
+//     if (missingFiles.length > 0) {
+//       console.log(
+//         "\n⚠️ The following files referenced by the blocks manifest were not found in the kit and were not copied:",
+//       );
+//       missingFiles.forEach((f) => console.log(`  • ${f}`));
+//       console.log(
+//         "You may need to copy these files manually (for example placeholder assets under public/placeholders) or reconcile the kit files.",
+//       );
+//     }
+//   } catch (error) {
+//     console.log("❌ Failed to install blocks kit");
+//     throw error;
+//   }
+// }
 //# sourceMappingURL=blocks.js.map