@percepta/create 3.1.4 → 3.1.5

package/package.json

@@ -1,8 +1,17 @@
 {
   "name": "@percepta/create",
-  "version": "3.1.4",
+  "version": "3.1.5",
   "description": "Scaffold a new Mosaic package",
-  "type": "module",
+  "keywords": [
+    "cli",
+    "create",
+    "mosaic",
+    "nextjs",
+    "percepta",
+    "scaffold",
+    "template"
+  ],
+  "license": "MIT",
   "bin": {
     "create": "./dist/index.js"
   },
@@ -11,6 +20,10 @@
     "templates",
     "template-versions.json"
   ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
@@ -24,36 +37,22 @@
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^24.1.0",
     "@types/validate-npm-package-name": "^4.0.2",
-    "tsup": "^8.4.0",
-    "typescript": "^5.7.3",
     "vitest": "^4.0.0",
-    "@percepta/build": "0.4.1"
+    "@percepta/build": "0.5.0"
   },
   "engines": {
     "node": ">=18.0.0"
   },
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "create",
-    "template",
-    "nextjs",
-    "mosaic",
-    "percepta",
-    "scaffold",
-    "cli"
-  ],
-  "license": "MIT",
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
-    "create:local": "pnpm build && node dist/index.js",
-    "dev": "tsup src/index.ts --format esm --watch",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "clean": "rimraf dist",
     "typecheck": "tsc --noEmit",
-    "sync-template": "tsx scripts/sync-template.ts",
-    "template:tag": "tsx scripts/template-tag.ts",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:template": "bash scripts/test-template.sh"
+    "test:template": "bash scripts/test-template.sh",
+    "create:local": "pnpm build && node dist/index.js",
+    "sync-template": "tsx scripts/sync-template.ts",
+    "template:tag": "tsx scripts/template-tag.ts"
   }
 }

package/dist/chunk-CO3YWUD6.js

@@ -1,139 +0,0 @@
-// src/utils/prompts.ts
-import path from "path";
-import inquirer from "inquirer";
-
-// src/utils/validate.ts
-import validateNpmPackageName from "validate-npm-package-name";
-function validateProjectName(name) {
-  const result = validateNpmPackageName(name);
-  if (!result.validForNewPackages) {
-    const errors = [...result.errors || [], ...result.warnings || []];
-    return {
-      valid: false,
-      error: errors[0] || "Invalid package name"
-    };
-  }
-  return { valid: true };
-}
-
-// src/utils/case-converters.ts
-function toKebabCase(str) {
-  return str.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
-}
-function toTitleCase(str) {
-  return str.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-}
-function toSnakeCase(str) {
-  return str.replace(/-/g, "_");
-}
-
-// src/utils/prompts.ts
-var VALID_PROJECT_TYPES = ["monorepo", "webapp", "library"];
-function isValidProjectType(value) {
-  return typeof value === "string" && VALID_PROJECT_TYPES.includes(value);
-}
-async function promptName(message) {
-  const { name } = await inquirer.prompt([
-    {
-      type: "input",
-      name: "name",
-      message,
-      filter: toKebabCase,
-      validate: (input) => {
-        const result = validateProjectName(toKebabCase(input));
-        return result.valid || result.error || "Invalid project name";
-      }
-    }
-  ]);
-  return name;
-}
-async function promptOutsideMonorepoType() {
-  const { webapp } = await inquirer.prompt([
-    {
-      type: "confirm",
-      name: "webapp",
-      message: "Initialize with a webapp?",
-      default: true
-    }
-  ]);
-  return webapp ? "webapp" : "monorepo";
-}
-async function promptInsideMonorepoType() {
-  const { projectType } = await inquirer.prompt([
-    {
-      type: "rawlist",
-      name: "projectType",
-      message: "What kind of package?",
-      // inquirer v12 / @inquirer/rawlist v5 matches `default` against the
-      // choice's `value`, not its index. `default: 0` would be a no-op.
-      default: "webapp",
-      choices: [
-        { name: "Webapp  \u2014 A Next.js webapp", value: "webapp" },
-        { name: "Library \u2014 A TypeScript library", value: "library" }
-      ]
-    }
-  ]);
-  return projectType;
-}
-async function promptProjectDetails(defaults) {
-  const inMonorepo = defaults.monorepoContext?.found ?? false;
-  const cwd = defaults.cwd ?? process.cwd();
-  let projectType;
-  let finalName;
-  if (inMonorepo) {
-    projectType = defaults.projectType ?? await promptInsideMonorepoType();
-    await defaults.beforeNamePrompt?.(projectType);
-    finalName = defaults.name || await promptName("Package name?");
-  } else {
-    const repoName = defaults.repoName || (defaults.projectType === "monorepo" ? defaults.name : void 0) || await promptName("Repo name?");
-    const repoTitle = toTitleCase(repoName);
-    projectType = defaults.projectType ?? await promptOutsideMonorepoType();
-    await defaults.beforeNamePrompt?.(projectType);
-    if (projectType === "monorepo") {
-      finalName = repoName;
-      const finalTitle3 = repoTitle;
-      const finalDirectory3 = path.resolve(cwd, repoName);
-      return {
-        projectType,
-        directory: finalDirectory3,
-        name: finalName,
-        title: finalTitle3,
-        installDeps: !defaults.skipInstall,
-        monorepoName: repoName,
-        monorepoTitle: repoTitle
-      };
-    }
-    const packageNamePrompt = projectType === "webapp" ? "Webapp name?" : "Library name?";
-    finalName = defaults.name || await promptName(packageNamePrompt);
-    const finalTitle2 = toTitleCase(finalName);
-    const finalDirectory2 = path.resolve(cwd, repoName);
-    return {
-      projectType,
-      directory: finalDirectory2,
-      name: finalName,
-      title: finalTitle2,
-      installDeps: !defaults.skipInstall,
-      monorepoName: repoName,
-      monorepoTitle: repoTitle
-    };
-  }
-  const finalTitle = finalName ? toTitleCase(finalName) : "";
-  const finalDirectory = !inMonorepo && finalName ? path.resolve(cwd, finalName) : "";
-  return {
-    projectType,
-    directory: finalDirectory,
-    name: finalName,
-    title: finalTitle,
-    installDeps: !defaults.skipInstall
-  };
-}
-
-export {
-  validateProjectName,
-  toKebabCase,
-  toTitleCase,
-  toSnakeCase,
-  VALID_PROJECT_TYPES,
-  isValidProjectType,
-  promptProjectDetails
-};

package/dist/chunk-DCM7JOSC.js

@@ -1,49 +0,0 @@
-// src/utils/git-ops.ts
-import { execFileSync } from "child_process";
-function toGitPath(p) {
-  return p.replace(/\\/g, "/");
-}
-function getLatestTemplateTag(type, repoPath) {
-  try {
-    const tags = execFileSync(
-      "git",
-      ["tag", "-l", `template/${type}/*`, "--sort=-v:refname"],
-      { cwd: repoPath, encoding: "utf-8" }
-    ).trim();
-    if (!tags) return null;
-    return tags.split("\n")[0] ?? null;
-  } catch {
-    return null;
-  }
-}
-function getTemplateVersionFromTag(tag) {
-  const parts = tag.split("/");
-  return parts[parts.length - 1] ?? "";
-}
-function getTemplateDiff(repoPath, templatePath, fromTag, toTag) {
-  return execFileSync(
-    "git",
-    ["diff", `${fromTag}..${toTag}`, "--", toGitPath(templatePath)],
-    {
-      cwd: repoPath,
-      encoding: "utf-8"
-    }
-  );
-}
-function getFileAtTag(repoPath, tag, filePath) {
-  try {
-    return execFileSync("git", ["show", `${tag}:${toGitPath(filePath)}`], {
-      cwd: repoPath,
-      encoding: "utf-8"
-    });
-  } catch {
-    return null;
-  }
-}
-
-export {
-  getLatestTemplateTag,
-  getTemplateVersionFromTag,
-  getTemplateDiff,
-  getFileAtTag
-};

package/dist/chunk-V5EJIUBJ.js

@@ -1,60 +0,0 @@
-// src/utils/manifest.ts
-import path from "path";
-import fs from "fs-extra";
-var MANIFEST_FILENAME = ".mosaic-template.json";
-function getManifestPath(dir) {
-  return path.join(dir, MANIFEST_FILENAME);
-}
-async function readManifest(dir) {
-  const manifestPath = getManifestPath(dir);
-  if (!await fs.pathExists(manifestPath)) {
-    throw new Error(
-      `No ${MANIFEST_FILENAME} found in ${dir}. Run 'create init' to create one.`
-    );
-  }
-  const content = await fs.readFile(manifestPath, "utf-8");
-  try {
-    return JSON.parse(content);
-  } catch (error) {
-    throw new Error(
-      `Invalid JSON in ${MANIFEST_FILENAME}: ${error.message}`
-    );
-  }
-}
-async function writeManifest(dir, manifest) {
-  const manifestPath = getManifestPath(dir);
-  await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
-}
-async function manifestExists(dir) {
-  return fs.pathExists(getManifestPath(dir));
-}
-function derivePlaceholders(appName, appTitle, repoName = appName) {
-  const nameSnake = appName.replace(/-/g, "_");
-  const repoNameSnake = repoName.replace(/-/g, "_");
-  return {
-    __APP_NAME__: appName,
-    __APP_TITLE__: appTitle,
-    __DB_NAME__: nameSnake + "_db",
-    __APP_NAME_UPPER__: appName.toUpperCase(),
-    __APP_NAME_SNAKE__: nameSnake,
-    __REPO_NAME__: repoName,
-    __REPO_NAME_SNAKE__: repoNameSnake
-  };
-}
-function resolveMosaicTemplatePath(options) {
-  if (options.mosaicTemplatePath)
-    return path.resolve(options.mosaicTemplatePath);
-  if (process.env.MOSAIC_TEMPLATE_PATH)
-    return path.resolve(process.env.MOSAIC_TEMPLATE_PATH);
-  throw new Error(
-    "Mosaic repo path required. Use --mosaic-template-path or set MOSAIC_TEMPLATE_PATH."
-  );
-}
-
-export {
-  readManifest,
-  writeManifest,
-  manifestExists,
-  derivePlaceholders,
-  resolveMosaicTemplatePath
-};

package/dist/index.d.ts

@@ -1 +0,0 @@
-#!/usr/bin/env node

package/dist/init-EQZ2TCSJ.js

@@ -1,96 +0,0 @@
-import {
-  VALID_PROJECT_TYPES,
-  isValidProjectType
-} from "./chunk-CO3YWUD6.js";
-import {
-  derivePlaceholders,
-  manifestExists,
-  writeManifest
-} from "./chunk-V5EJIUBJ.js";
-
-// src/commands/init.ts
-import path from "path";
-import fs from "fs-extra";
-import chalk from "chalk";
-import inquirer from "inquirer";
-async function initCommand(options) {
-  const cwd = process.cwd();
-  if (await manifestExists(cwd)) {
-    console.error(
-      chalk.red(".mosaic-template.json already exists in this directory.")
-    );
-    process.exit(1);
-  }
-  const pkgPath = path.join(cwd, "package.json");
-  let appName = path.basename(cwd);
-  if (await fs.pathExists(pkgPath)) {
-    const pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
-    appName = pkg.name?.replace(/^@[^/]+\//, "") || appName;
-  }
-  let templateType = options.type;
-  if (templateType && !isValidProjectType(templateType)) {
-    console.error(
-      chalk.red(
-        `Invalid template type "${templateType}". Valid types: ${VALID_PROJECT_TYPES.join(", ")}`
-      )
-    );
-    process.exit(1);
-  }
-  if (!templateType) {
-    const answer = await inquirer.prompt([
-      {
-        type: "list",
-        name: "type",
-        message: "Template type:",
-        choices: ["webapp", "library"]
-      }
-    ]);
-    templateType = answer.type;
-  }
-  const templateVersion = options.templateVersion || "1.0.0";
-  const appTitle = appName.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
-  const manifest = {
-    templateType,
-    templateVersion,
-    templateCommit: "unknown",
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    placeholders: derivePlaceholders(appName, appTitle),
-    source: {
-      templatePath: `packages/create-mosaic-module/templates/${templateType}`
-    }
-  };
-  await writeManifest(cwd, manifest);
-  const notesPath = path.join(cwd, "mosaic-template-notes.md");
-  if (!await fs.pathExists(notesPath)) {
-    await fs.writeFile(
-      notesPath,
-      `# Mosaic Divergence Notes
-
-Document intentional differences from the ${templateType} template here.
-Claude reads this file during sync to preserve your customizations.
-
-## Intentional Divergences
-
-`
-    );
-  }
-  console.log();
-  console.log(
-    chalk.green("\u2714"),
-    chalk.bold("Initialized .mosaic-template.json")
-  );
-  console.log();
-  console.log(chalk.dim("  Template:"), templateType);
-  console.log(chalk.dim("  Version:"), templateVersion);
-  console.log(chalk.dim("  App name:"), appName);
-  console.log();
-  console.log(
-    chalk.dim(
-      "Review .mosaic-template.json and mosaic-template-notes.md, then commit them."
-    )
-  );
-  console.log();
-}
-export {
-  initCommand
-};

package/dist/status-QW5TQDYY.js

@@ -1,76 +0,0 @@
-import {
-  getLatestTemplateTag,
-  getTemplateVersionFromTag
-} from "./chunk-DCM7JOSC.js";
-import {
-  readManifest
-} from "./chunk-V5EJIUBJ.js";
-
-// src/commands/status.ts
-import path from "path";
-import chalk from "chalk";
-async function statusCommand(options) {
-  const cwd = process.cwd();
-  try {
-    const manifest = await readManifest(cwd);
-    console.log();
-    console.log(chalk.bold("Mosaic Template Status"));
-    console.log();
-    console.log(chalk.dim("  Template type:"), manifest.templateType);
-    console.log(chalk.dim("  Current version:"), manifest.templateVersion);
-    console.log(chalk.dim("  Template commit:"), manifest.templateCommit);
-    console.log(chalk.dim("  Created:"), manifest.createdAt);
-    if (manifest.lastSyncedAt) {
-      console.log(chalk.dim("  Last synced:"), manifest.lastSyncedAt);
-    }
-    const rawPath = options.mosaicTemplatePath || process.env.MOSAIC_TEMPLATE_PATH;
-    const mosaicTemplatePath = rawPath ? path.resolve(rawPath) : void 0;
-    if (mosaicTemplatePath) {
-      const latestTag = getLatestTemplateTag(
-        manifest.templateType,
-        mosaicTemplatePath
-      );
-      if (latestTag) {
-        const latestVersion = getTemplateVersionFromTag(latestTag);
-        console.log(chalk.dim("  Latest version:"), latestVersion);
-        console.log();
-        if (latestVersion !== manifest.templateVersion) {
-          console.log(
-            chalk.yellow(
-              `  Update available: ${manifest.templateVersion} \u2192 ${latestVersion}`
-            )
-          );
-          console.log(
-            chalk.dim("  Run:"),
-            `create sync --mosaic-template-path ${mosaicTemplatePath}`
-          );
-        } else {
-          console.log(chalk.green("  Up to date"));
-        }
-      } else {
-        console.log();
-        console.log(
-          chalk.yellow("  No template tags found in mosaic repo.")
-        );
-        console.log(
-          chalk.dim("  Run:"),
-          `cd ${mosaicTemplatePath} && pnpm template:tag`
-        );
-      }
-    } else {
-      console.log();
-      console.log(
-        chalk.dim(
-          "  Use --mosaic-template-path or set MOSAIC_TEMPLATE_PATH to check for updates"
-        )
-      );
-    }
-    console.log();
-  } catch (error) {
-    console.error(chalk.red(error.message));
-    process.exit(1);
-  }
-}
-export {
-  statusCommand
-};

package/dist/sync-RLBZDOFB.js

@@ -1,136 +0,0 @@
-import {
-  getLatestTemplateTag,
-  getTemplateDiff,
-  getTemplateVersionFromTag
-} from "./chunk-DCM7JOSC.js";
-import {
-  readManifest,
-  resolveMosaicTemplatePath
-} from "./chunk-V5EJIUBJ.js";
-
-// src/commands/sync.ts
-import path from "path";
-import fs from "fs-extra";
-import chalk from "chalk";
-function generateSyncContext(manifest, toVersion, diff, notes) {
-  let content = `# Mosaic Sync Context
-
-## App Info
-- **Template:** ${manifest.templateType}
-- **Current version:** ${manifest.templateVersion}
-- **Target version:** ${toVersion}
-
-## Placeholder Mappings
-
-When applying template changes, replace these placeholder tokens with the actual values:
-
-| Placeholder | Value |
-|------------|-------|
-${Object.entries(manifest.placeholders).map(([k, v]) => `| \`${k}\` | \`${v}\` |`).join("\n")}
-
-## Template Changes (${manifest.templateVersion} \u2192 ${toVersion})
-
-\`\`\`diff
-${diff}
-\`\`\`
-`;
-  if (notes.trim()) {
-    content += `
-## Divergence Notes (from mosaic-template-notes.md)
-
-${notes}
-`;
-  }
-  content += `
-## Instructions
-
-1. Apply the template changes above to this app
-2. When you see placeholder tokens (e.g. \`__APP_NAME__\`), replace them with the actual values from the mapping table
-3. Check the divergence notes \u2014 preserve intentional divergences
-4. For files not modified locally: apply changes directly
-5. For files modified locally: merge intelligently, preserving local customizations
-6. After applying all changes, run: \`pnpm install && pnpm build && pnpm lint\`
-7. Update \`.mosaic-template.json\`: set \`templateVersion\` to \`"${toVersion}"\` and update \`templateCommit\`
-8. If you made decisions about merge conflicts, add notes to \`mosaic-template-notes.md\`
-9. Delete this file (\`.mosaic-sync-context.md\`) when done
-`;
-  return content;
-}
-async function syncCommand(options) {
-  const cwd = process.cwd();
-  try {
-    const manifest = await readManifest(cwd);
-    const mosaicTemplatePath = resolveMosaicTemplatePath(options);
-    const fromTag = `template/${manifest.templateType}/${manifest.templateVersion}`;
-    let toTag;
-    if (options.to) {
-      toTag = `template/${manifest.templateType}/${options.to}`;
-    } else {
-      const latest = getLatestTemplateTag(
-        manifest.templateType,
-        mosaicTemplatePath
-      );
-      if (!latest) {
-        console.error(
-          chalk.red(
-            "No template tags found. Run 'pnpm template:tag' in the mosaic repo first."
-          )
-        );
-        process.exit(1);
-      }
-      toTag = latest;
-    }
-    const toVersion = getTemplateVersionFromTag(toTag);
-    if (toVersion === manifest.templateVersion) {
-      console.log(chalk.green("Already up to date."));
-      return;
-    }
-    const diff = getTemplateDiff(
-      mosaicTemplatePath,
-      manifest.source.templatePath,
-      fromTag,
-      toTag
-    );
-    if (!diff.trim()) {
-      console.log(
-        chalk.green("No template file changes between versions.")
-      );
-      return;
-    }
-    const notesPath = path.join(cwd, "mosaic-template-notes.md");
-    let notes = "";
-    if (await fs.pathExists(notesPath)) {
-      notes = await fs.readFile(notesPath, "utf-8");
-    }
-    const context = generateSyncContext(manifest, toVersion, diff, notes);
-    const contextPath = path.join(cwd, ".mosaic-sync-context.md");
-    await fs.writeFile(contextPath, context);
-    console.log();
-    console.log(chalk.bold("Sync Context Generated"));
-    console.log();
-    console.log(chalk.dim("  From:"), manifest.templateVersion);
-    console.log(chalk.dim("  To:"), toVersion);
-    console.log(chalk.dim("  Context file:"), ".mosaic-sync-context.md");
-    console.log();
-    console.log("Next steps:");
-    console.log(
-      chalk.dim("  1."),
-      "Open Claude Code in this directory"
-    );
-    console.log(
-      chalk.dim("  2."),
-      'Tell Claude: "Read .mosaic-sync-context.md and apply the template changes"'
-    );
-    console.log(
-      chalk.dim("  3."),
-      "Review Claude's changes, then delete .mosaic-sync-context.md"
-    );
-    console.log();
-  } catch (error) {
-    console.error(chalk.red(error.message));
-    process.exit(1);
-  }
-}
-export {
-  syncCommand
-};