create-idia-app 0.2.0

package/README.md

@@ -0,0 +1,104 @@
+# create-idia-app
+
+Scaffold an Expo + React Navigation consumer app with `@idia-ui/core` and `@idia-ui/theme`.
+
+**Track C Phase 2a** — local monorepo build only; not published to npm until Phase 5.
+
+## Build
+
+From repo root:
+
+```bash
+pnpm --filter create-idia-app build
+```
+
+`prebuild` copies `templates/consumer-app/` into `packages/create-idia-app/template/`. Refresh the source template first when the sandbox changes:
+
+```bash
+node scripts/sync-consumer-template.mjs
+pnpm --filter create-idia-app build
+```
+
+## Local usage
+
+```bash
+node packages/create-idia-app/dist/index.js my-app
+# or
+pnpm --filter create-idia-app exec create-idia-app my-app
+```
+
+### Flags
+
+| Flag | Behavior |
+|------|----------|
+| `--pm <pnpm\|npm\|yarn>` | Override package manager |
+| `--skip-install` | Skip install + doctor |
+| `--force` | Overwrite existing directory |
+| `--no-git` | Skip `git init` |
+| `--with-storybook` | Warn only — Phase 3 |
+| `--with-brain` | Warn only — Phase 4 |
+
+## E2E outside monorepo (pre–Phase 5)
+
+`@idia-ui/*` is **not** on public npm at `0.2.0` yet. External e2e uses packed tarballs + `file:` overrides (same procedure as Phase 0.5 / 1a).
+
+### 1. Build runtime packages + CLI
+
+```bash
+# repo root
+pnpm --filter @idia-ui/tokens build
+pnpm --filter @idia-ui/theme build
+pnpm --filter @idia-ui/core build
+pnpm --filter @idia-ui/hooks build
+pnpm --filter @idia-ui/motion build
+pnpm --filter @idia-ui/utils build
+pnpm --filter @idia-ui/validators build
+pnpm --filter @idia-ui/cli build
+pnpm --filter create-idia-app build
+```
+
+### 2. Pack tarballs
+
+```bash
+OUT_DIR=C:\Users\Ojanti\Desktop\Projects_\idia-ui-pack-tarballs
+mkdir %OUT_DIR%
+cd packages/tokens && pnpm pack --pack-destination %OUT_DIR%
+# repeat for theme, core, hooks, motion, utils, validators, cli
+```
+
+### 3. Scaffold outside monorepo
+
+```powershell
+cd $env:TEMP
+node C:\Users\Ojanti\Desktop\Projects_\idia-ui\packages\create-idia-app\dist\index.js my-cli-test --skip-install
+cd my-cli-test
+```
+
+### 4. Apply `file:` overrides
+
+In generated `package.json`, replace semver `@idia-ui/*` and `@idia-ui/cli` with `file:<tarball>` paths. Add matching `pnpm.overrides` for all `@idia-ui/*` packages (transitive graph).
+
+### 5. Install, doctor, dev
+
+```bash
+pnpm install
+pnpm exec idia-ui doctor
+pnpm dev
+# or non-interactive smoke:
+npx expo export --platform web
+```
+
+When developing **inside** the monorepo, `create-idia-app` auto-detects `packages/cli/dist/cli.js` and runs doctor via the sibling CLI build (no npm install of `@idia-ui/cli` required for doctor during maintainer smoke).
+
+## Generated app contract
+
+- `package.json` name + `@idia-ui/*` pinned to `^0.2.0`
+- `app.json` name / slug / scheme renamed from `my-idia-app`
+- `src/navigation/linking.ts` URL prefixes updated
+- `.idia/manifest.json` stub with `idiaCli` + `core` versions
+- `@idia-ui/cli` added to `devDependencies`
+- Post-install: `idia-ui doctor` (non-strict) unless `--skip-install`
+
+## Version coupling
+
+`create-idia-app@0.2.x` generates apps targeting `@idia-ui/core@0.2.x` and `@idia-ui/cli@0.2.x`.

package/dist/index.js

@@ -0,0 +1,412 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/scaffold.ts
+var import_node_fs3 = require("fs");
+var import_node_path3 = require("path");
+var import_node_child_process = require("child_process");
+
+// src/replace.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+
+// src/constants.ts
+var IDIA_UI_VERSION = "0.2.0";
+var CREATE_APP_VERSION = "0.2.0";
+var CLI_VERSION = "0.2.0";
+var TEMPLATE_SLUG = "my-idia-app";
+
+// src/replace.ts
+function toKebabCase(name) {
+  return name.trim().replace(/[\s_]+/g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function validateProjectName(name) {
+  const slug = toKebabCase(name);
+  if (!slug) {
+    throw new Error("Project name is required.");
+  }
+  if (!/^[a-z][a-z0-9-]*$/.test(slug)) {
+    throw new Error(
+      `Invalid project name "${name}". Use lowercase letters, numbers, and hyphens (must start with a letter).`
+    );
+  }
+  return slug;
+}
+function replacePlaceholders(projectDir, projectName) {
+  const packageJsonPath = (0, import_node_path.join)(projectDir, "package.json");
+  const packageJson = JSON.parse((0, import_node_fs.readFileSync)(packageJsonPath, "utf8"));
+  packageJson.name = projectName;
+  for (const field of ["dependencies", "devDependencies"]) {
+    const deps = packageJson[field];
+    if (!deps) continue;
+    for (const pkg of Object.keys(deps)) {
+      if (pkg.startsWith("@idia-ui/")) {
+        deps[pkg] = `^${IDIA_UI_VERSION}`;
+      }
+    }
+  }
+  packageJson.devDependencies ??= {};
+  packageJson.devDependencies["@idia-ui/cli"] = `^${CLI_VERSION}`;
+  (0, import_node_fs.writeFileSync)(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
+`, "utf8");
+  const appJsonPath = (0, import_node_path.join)(projectDir, "app.json");
+  const appJson = JSON.parse((0, import_node_fs.readFileSync)(appJsonPath, "utf8"));
+  appJson.expo.name = projectName;
+  appJson.expo.slug = projectName;
+  appJson.expo.scheme = projectName;
+  (0, import_node_fs.writeFileSync)(appJsonPath, `${JSON.stringify(appJson, null, 2)}
+`, "utf8");
+  const linkingPath = (0, import_node_path.join)(projectDir, "src", "navigation", "linking.ts");
+  let linking = (0, import_node_fs.readFileSync)(linkingPath, "utf8");
+  linking = linking.replaceAll(TEMPLATE_SLUG, projectName);
+  (0, import_node_fs.writeFileSync)(linkingPath, linking, "utf8");
+}
+function writeManifest(projectDir) {
+  const manifestDir = (0, import_node_path.join)(projectDir, ".idia");
+  (0, import_node_fs.mkdirSync)(manifestDir, { recursive: true });
+  const manifestPath = (0, import_node_path.join)(manifestDir, "manifest.json");
+  const manifest = {
+    idiaCli: CLI_VERSION,
+    core: IDIA_UI_VERSION
+  };
+  (0, import_node_fs.writeFileSync)(manifestPath, `${JSON.stringify(manifest, null, 2)}
+`, "utf8");
+}
+
+// src/pm.ts
+var PM_VALUES = /* @__PURE__ */ new Set(["pnpm", "npm", "yarn"]);
+function parsePackageManagerFlag(value) {
+  if (!value) return void 0;
+  const normalized = value.toLowerCase();
+  if (!PM_VALUES.has(normalized)) {
+    throw new Error(`Invalid --pm value "${value}". Use pnpm, npm, or yarn.`);
+  }
+  return normalized;
+}
+function detectPackageManager(override) {
+  if (override) return override;
+  const agent = process.env.npm_config_user_agent ?? "";
+  if (agent.includes("pnpm")) return "pnpm";
+  if (agent.includes("yarn")) return "yarn";
+  const execPath = process.env.npm_execpath ?? "";
+  if (execPath.includes("pnpm")) return "pnpm";
+  if (execPath.includes("yarn")) return "yarn";
+  return "npm";
+}
+function installCommand(pm) {
+  switch (pm) {
+    case "pnpm":
+      return { command: "pnpm", args: ["install"] };
+    case "yarn":
+      return { command: "yarn", args: ["install"] };
+    default:
+      return { command: "npm", args: ["install"] };
+  }
+}
+function devCommand(pm) {
+  switch (pm) {
+    case "pnpm":
+      return "pnpm dev";
+    case "yarn":
+      return "yarn dev";
+    default:
+      return "npm run dev";
+  }
+}
+function idiaUiCommand(pm, subcommand) {
+  switch (pm) {
+    case "pnpm":
+      return { command: "pnpm", args: ["exec", "idia-ui", ...subcommand] };
+    case "yarn":
+      return { command: "yarn", args: ["idia-ui", ...subcommand] };
+    default:
+      return { command: "npx", args: ["idia-ui", ...subcommand] };
+  }
+}
+
+// src/doctor.ts
+var import_node_fs2 = require("fs");
+
+// src/paths.ts
+var import_node_path2 = require("path");
+function cliEntryPath() {
+  const entry = process.argv[1];
+  if (!entry) {
+    throw new Error("Unable to resolve CLI entry path.");
+  }
+  return entry;
+}
+function packageRootDir() {
+  return (0, import_node_path2.join)((0, import_node_path2.dirname)(cliEntryPath()), "..");
+}
+function templateDir() {
+  return (0, import_node_path2.join)(packageRootDir(), "template");
+}
+function monorepoDoctorCliPath() {
+  return (0, import_node_path2.join)(packageRootDir(), "..", "cli", "dist", "cli.js");
+}
+
+// src/doctor.ts
+function resolveMonorepoDoctorCli() {
+  const candidate = monorepoDoctorCliPath();
+  return (0, import_node_fs2.existsSync)(candidate) ? candidate : null;
+}
+function resolveIdiaUiInvocation(pm, subcommand) {
+  const monorepoCli = resolveMonorepoDoctorCli();
+  if (monorepoCli) {
+    return {
+      command: process.execPath,
+      args: [monorepoCli, ...subcommand],
+      via: "monorepo"
+    };
+  }
+  const viaPm = idiaUiCommand(pm, subcommand);
+  return { ...viaPm, via: "installed" };
+}
+function resolveDoctorInvocation(pm) {
+  return resolveIdiaUiInvocation(pm, ["doctor"]);
+}
+
+// src/scaffold.ts
+function resolveTemplateDir() {
+  const bundled = templateDir();
+  if ((0, import_node_fs3.existsSync)(bundled)) return bundled;
+  throw new Error(
+    "Template directory missing. Run `pnpm run build` in packages/create-idia-app first."
+  );
+}
+function runCommand(command, args, cwd) {
+  const result = (0, import_node_child_process.spawnSync)(command, args, {
+    cwd,
+    stdio: "inherit",
+    shell: process.platform === "win32"
+  });
+  if (result.error) {
+    return { status: result.status, error: result.error };
+  }
+  return { status: result.status };
+}
+function scaffold(options) {
+  const projectName = validateProjectName(options.projectName);
+  const projectDir = options.targetDir ? (0, import_node_path3.join)(options.targetDir, projectName) : (0, import_node_path3.join)(process.cwd(), projectName);
+  const pm = detectPackageManager(options.pm);
+  if ((0, import_node_fs3.existsSync)(projectDir)) {
+    if (!options.force) {
+      throw new Error(
+        `Directory "${projectDir}" already exists. Pass --force to overwrite or choose another name.`
+      );
+    }
+    (0, import_node_fs3.rmSync)(projectDir, { recursive: true, force: true });
+  }
+  (0, import_node_fs3.mkdirSync)(projectDir, { recursive: true });
+  (0, import_node_fs3.cpSync)(resolveTemplateDir(), projectDir, { recursive: true });
+  replacePlaceholders(projectDir, projectName);
+  writeManifest(projectDir);
+  if (!options.noGit) {
+    const git = runCommand("git", ["init"], projectDir);
+    if (git.error) {
+      console.warn("\u26A0 git init skipped:", git.error.message);
+    }
+  }
+  let installed = false;
+  let doctorRan = false;
+  let doctorExitCode = null;
+  let doctorVia = "skipped";
+  if (!options.skipInstall) {
+    console.log(`
+Installing dependencies with ${pm}\u2026`);
+    const install = installCommand(pm);
+    const installResult = runCommand(install.command, install.args, projectDir);
+    if (installResult.error) {
+      throw installResult.error;
+    }
+    if (installResult.status !== 0) {
+      throw new Error(`${pm} install failed with exit code ${installResult.status ?? 1}`);
+    }
+    installed = true;
+    console.log("\nRunning idia-ui doctor (non-strict)\u2026");
+    const doctor = resolveDoctorInvocation(pm);
+    doctorVia = doctor.via;
+    const doctorResult = runCommand(doctor.command, doctor.args, projectDir);
+    doctorRan = true;
+    doctorExitCode = doctorResult.status;
+    if (doctorResult.error) {
+      console.warn("\u26A0 idia-ui doctor could not run:", doctorResult.error.message);
+      doctorRan = false;
+      doctorExitCode = null;
+    } else if (doctorExitCode !== 0) {
+      console.warn(
+        `\u26A0 idia-ui doctor exited with code ${doctorExitCode}. Review warnings above; re-run after fixing peers.`
+      );
+    }
+    runPostScaffoldAddons(projectDir, pm, options);
+  } else {
+    console.log("\n--skip-install: skipping dependency install and idia-ui doctor.");
+    if (options.withStorybook || options.withBrain) {
+      console.warn(
+        "\u26A0 --with-storybook / --with-brain require install. After `pnpm install`, run idia-ui add storybook and/or idia-ui add brain."
+      );
+    }
+  }
+  printNextSteps(projectName, projectDir, pm, options);
+  return {
+    projectDir,
+    projectName,
+    pm,
+    installed,
+    doctorRan,
+    doctorExitCode,
+    doctorVia
+  };
+}
+function runPostScaffoldAddons(projectDir, pm, options) {
+  if (options.withStorybook) {
+    console.log("\nRunning idia-ui add storybook\u2026");
+    const add = resolveIdiaUiInvocation(pm, ["add", "storybook"]);
+    const result = runCommand(add.command, add.args, projectDir);
+    if (result.error) {
+      console.warn("\u26A0 idia-ui add storybook could not run:", result.error.message);
+    } else if (result.status !== 0) {
+      console.warn(
+        `\u26A0 idia-ui add storybook exited with code ${result.status ?? 1}. Re-run manually after fixing peers.`
+      );
+    }
+  }
+  if (options.withBrain) {
+    console.log("\nRunning idia-ui add brain\u2026");
+    const add = resolveIdiaUiInvocation(pm, ["add", "brain"]);
+    const result = runCommand(add.command, add.args, projectDir);
+    if (result.error) {
+      console.warn("\u26A0 idia-ui add brain could not run:", result.error.message);
+    } else if (result.status !== 0) {
+      console.warn(
+        `\u26A0 idia-ui add brain exited with code ${result.status ?? 1}. Re-run manually after fixing peers.`
+      );
+    }
+  }
+}
+function printNextSteps(projectName, projectDir, pm, options) {
+  const dev = devCommand(pm);
+  console.log("\n\u2713 Project scaffolded successfully\n");
+  console.log("Next steps:");
+  console.log(`  cd ${projectDir}`);
+  if (!(0, import_node_fs3.existsSync)((0, import_node_path3.join)(projectDir, "node_modules"))) {
+    const install = installCommand(pm);
+    console.log(`  ${install.command} ${install.args.join(" ")}`);
+  }
+  console.log(`  ${dev}`);
+  console.log(`  ${pm === "npm" ? "npx idia-ui doctor" : `${pm} exec idia-ui doctor`}`);
+  if (!options.withStorybook) {
+    console.log(`  ${pm === "npm" ? "npx idia-ui add storybook" : `${pm} exec idia-ui add storybook`}`);
+  }
+  if (!options.withBrain) {
+    console.log(`  ${pm === "npm" ? "npx idia-ui add brain" : `${pm} exec idia-ui add brain`}`);
+  }
+}
+
+// src/index.ts
+function printHelp() {
+  console.log(`create-idia-app v${CREATE_APP_VERSION}
+
+Usage:
+  create-idia-app [project-name] [options]
+
+Options:
+  --pm <pnpm|npm|yarn>   Override package manager detection
+  --skip-install         Skip install and idia-ui doctor
+  --force                Overwrite target directory if it exists
+  --no-git               Skip git init
+  --with-storybook       Not available (Phase 3) \u2014 prints warning
+  --with-brain           Not available (Phase 4) \u2014 prints warning
+  -h, --help             Show help
+  -V, --version          Show version
+`);
+}
+function parseArgs(argv) {
+  const result = {
+    projectName: void 0,
+    pm: void 0,
+    skipInstall: false,
+    force: false,
+    noGit: false,
+    withStorybook: false,
+    withBrain: false,
+    help: false,
+    version: false
+  };
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    switch (arg) {
+      case "--pm":
+        result.pm = parsePackageManagerFlag(argv[++i]);
+        break;
+      case "--skip-install":
+        result.skipInstall = true;
+        break;
+      case "--force":
+        result.force = true;
+        break;
+      case "--no-git":
+        result.noGit = true;
+        break;
+      case "--with-storybook":
+        result.withStorybook = true;
+        break;
+      case "--with-brain":
+        result.withBrain = true;
+        break;
+      case "-h":
+      case "--help":
+        result.help = true;
+        break;
+      case "-V":
+      case "--version":
+        result.version = true;
+        break;
+      default:
+        if (arg.startsWith("-")) {
+          throw new Error(`Unknown option: ${arg}`);
+        }
+        if (!result.projectName) {
+          result.projectName = arg;
+        } else {
+          throw new Error(`Unexpected argument: ${arg}`);
+        }
+    }
+  }
+  return result;
+}
+function main() {
+  try {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+      printHelp();
+      return;
+    }
+    if (args.version) {
+      console.log(CREATE_APP_VERSION);
+      return;
+    }
+    if (!args.projectName) {
+      printHelp();
+      throw new Error("Project name is required. Example: create-idia-app my-app");
+    }
+    scaffold({
+      projectName: args.projectName,
+      targetDir: process.cwd(),
+      pm: args.pm,
+      skipInstall: args.skipInstall,
+      force: args.force,
+      noGit: args.noGit,
+      withStorybook: args.withStorybook,
+      withBrain: args.withBrain
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`
+Error: ${message}`);
+    process.exit(1);
+  }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts","../src/replace.ts","../src/constants.ts","../src/pm.ts","../src/doctor.ts","../src/paths.ts","../src/index.ts"],"sourcesContent":["import { cpSync, existsSync, mkdirSync, rmSync } from 'node:fs'\r\nimport { join } from 'node:path'\r\nimport { spawnSync } from 'node:child_process'\r\n\r\nimport { replacePlaceholders, validateProjectName, writeManifest } from './replace.js'\r\nimport {\r\n  detectPackageManager,\r\n  devCommand,\r\n  installCommand,\r\n  type PackageManager,\r\n} from './pm.js'\r\nimport { resolveDoctorInvocation, resolveIdiaUiInvocation } from './doctor.js'\r\nimport { templateDir } from './paths.js'\r\n\r\nexport type ScaffoldOptions = {\r\n  projectName: string\r\n  targetDir: string\r\n  pm?: PackageManager\r\n  skipInstall?: boolean\r\n  force?: boolean\r\n  noGit?: boolean\r\n  withStorybook?: boolean\r\n  withBrain?: boolean\r\n}\r\n\r\nexport type ScaffoldResult = {\r\n  projectDir: string\r\n  projectName: string\r\n  pm: PackageManager\r\n  installed: boolean\r\n  doctorRan: boolean\r\n  doctorExitCode: number | null\r\n  doctorVia: 'monorepo' | 'installed' | 'skipped'\r\n}\r\n\r\nfunction resolveTemplateDir(): string {\r\n  const bundled = templateDir()\r\n  if (existsSync(bundled)) return bundled\r\n  throw new Error(\r\n    'Template directory missing. Run `pnpm run build` in packages/create-idia-app first.',\r\n  )\r\n}\r\n\r\nfunction runCommand(\r\n  command: string,\r\n  args: string[],\r\n  cwd: string,\r\n): { status: number | null; error?: Error } {\r\n  const result = spawnSync(command, args, {\r\n    cwd,\r\n    stdio: 'inherit',\r\n    shell: process.platform === 'win32',\r\n  })\r\n  if (result.error) {\r\n    return { status: result.status, error: result.error }\r\n  }\r\n  return { status: result.status }\r\n}\r\n\r\nexport function scaffold(options: ScaffoldOptions): ScaffoldResult {\r\n  const projectName = validateProjectName(options.projectName)\r\n  const projectDir = options.targetDir\r\n    ? join(options.targetDir, projectName)\r\n    : join(process.cwd(), projectName)\r\n  const pm = detectPackageManager(options.pm)\r\n\r\n  if (existsSync(projectDir)) {\r\n    if (!options.force) {\r\n      throw new Error(\r\n        `Directory \"${projectDir}\" already exists. Pass --force to overwrite or choose another name.`,\r\n      )\r\n    }\r\n    rmSync(projectDir, { recursive: true, force: true })\r\n  }\r\n\r\n  mkdirSync(projectDir, { recursive: true })\r\n  cpSync(resolveTemplateDir(), projectDir, { recursive: true })\r\n\r\n  replacePlaceholders(projectDir, projectName)\r\n  writeManifest(projectDir)\r\n\r\n  if (!options.noGit) {\r\n    const git = runCommand('git', ['init'], projectDir)\r\n    if (git.error) {\r\n      console.warn('⚠ git init skipped:', git.error.message)\r\n    }\r\n  }\r\n\r\n  let installed = false\r\n  let doctorRan = false\r\n  let doctorExitCode: number | null = null\r\n  let doctorVia: ScaffoldResult['doctorVia'] = 'skipped'\r\n\r\n  if (!options.skipInstall) {\r\n    console.log(`\\nInstalling dependencies with ${pm}…`)\r\n    const install = installCommand(pm)\r\n    const installResult = runCommand(install.command, install.args, projectDir)\r\n    if (installResult.error) {\r\n      throw installResult.error\r\n    }\r\n    if (installResult.status !== 0) {\r\n      throw new Error(`${pm} install failed with exit code ${installResult.status ?? 1}`)\r\n    }\r\n    installed = true\r\n\r\n    console.log('\\nRunning idia-ui doctor (non-strict)…')\r\n    const doctor = resolveDoctorInvocation(pm)\r\n    doctorVia = doctor.via\r\n    const doctorResult = runCommand(doctor.command, doctor.args, projectDir)\r\n    doctorRan = true\r\n    doctorExitCode = doctorResult.status\r\n    if (doctorResult.error) {\r\n      console.warn('⚠ idia-ui doctor could not run:', doctorResult.error.message)\r\n      doctorRan = false\r\n      doctorExitCode = null\r\n    } else if (doctorExitCode !== 0) {\r\n      console.warn(\r\n        `⚠ idia-ui doctor exited with code ${doctorExitCode}. Review warnings above; re-run after fixing peers.`,\r\n      )\r\n    }\r\n\r\n    runPostScaffoldAddons(projectDir, pm, options)\r\n  } else {\r\n    console.log('\\n--skip-install: skipping dependency install and idia-ui doctor.')\r\n    if (options.withStorybook || options.withBrain) {\r\n      console.warn(\r\n        '⚠ --with-storybook / --with-brain require install. After `pnpm install`, run idia-ui add storybook and/or idia-ui add brain.',\r\n      )\r\n    }\r\n  }\r\n\r\n  printNextSteps(projectName, projectDir, pm, options)\r\n\r\n  return {\r\n    projectDir,\r\n    projectName,\r\n    pm,\r\n    installed,\r\n    doctorRan,\r\n    doctorExitCode,\r\n    doctorVia,\r\n  }\r\n}\r\n\r\nfunction runPostScaffoldAddons(\r\n  projectDir: string,\r\n  pm: PackageManager,\r\n  options: Pick<ScaffoldOptions, 'withStorybook' | 'withBrain'>,\r\n): void {\r\n  if (options.withStorybook) {\r\n    console.log('\\nRunning idia-ui add storybook…')\r\n    const add = resolveIdiaUiInvocation(pm, ['add', 'storybook'])\r\n    const result = runCommand(add.command, add.args, projectDir)\r\n    if (result.error) {\r\n      console.warn('⚠ idia-ui add storybook could not run:', result.error.message)\r\n    } else if (result.status !== 0) {\r\n      console.warn(\r\n        `⚠ idia-ui add storybook exited with code ${result.status ?? 1}. Re-run manually after fixing peers.`,\r\n      )\r\n    }\r\n  }\r\n\r\n  if (options.withBrain) {\r\n    console.log('\\nRunning idia-ui add brain…')\r\n    const add = resolveIdiaUiInvocation(pm, ['add', 'brain'])\r\n    const result = runCommand(add.command, add.args, projectDir)\r\n    if (result.error) {\r\n      console.warn('⚠ idia-ui add brain could not run:', result.error.message)\r\n    } else if (result.status !== 0) {\r\n      console.warn(\r\n        `⚠ idia-ui add brain exited with code ${result.status ?? 1}. Re-run manually after fixing peers.`,\r\n      )\r\n    }\r\n  }\r\n}\r\n\r\nfunction printNextSteps(\r\n  projectName: string,\r\n  projectDir: string,\r\n  pm: PackageManager,\r\n  options: Pick<ScaffoldOptions, 'withStorybook' | 'withBrain'>,\r\n): void {\r\n  const dev = devCommand(pm)\r\n  console.log('\\n✓ Project scaffolded successfully\\n')\r\n  console.log('Next steps:')\r\n  console.log(`  cd ${projectDir}`)\r\n  if (!existsSync(join(projectDir, 'node_modules'))) {\r\n    const install = installCommand(pm)\r\n    console.log(`  ${install.command} ${install.args.join(' ')}`)\r\n  }\r\n  console.log(`  ${dev}`)\r\n  console.log(`  ${pm === 'npm' ? 'npx idia-ui doctor' : `${pm} exec idia-ui doctor`}`)\r\n  if (!options.withStorybook) {\r\n    console.log(`  ${pm === 'npm' ? 'npx idia-ui add storybook' : `${pm} exec idia-ui add storybook`}`)\r\n  }\r\n  if (!options.withBrain) {\r\n    console.log(`  ${pm === 'npm' ? 'npx idia-ui add brain' : `${pm} exec idia-ui add brain`}`)\r\n  }\r\n}\r\n","import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'\r\nimport { join } from 'node:path'\r\n\r\nimport { CLI_VERSION, IDIA_UI_VERSION, TEMPLATE_SLUG } from './constants.js'\r\n\r\ntype PackageJson = {\r\n  name?: string\r\n  dependencies?: Record<string, string>\r\n  devDependencies?: Record<string, string>\r\n}\r\n\r\nexport function toKebabCase(name: string): string {\r\n  return name\r\n    .trim()\r\n    .replace(/[\\s_]+/g, '-')\r\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\r\n    .toLowerCase()\r\n    .replace(/[^a-z0-9-]/g, '-')\r\n    .replace(/-+/g, '-')\r\n    .replace(/^-|-$/g, '')\r\n}\r\n\r\nexport function validateProjectName(name: string): string {\r\n  const slug = toKebabCase(name)\r\n  if (!slug) {\r\n    throw new Error('Project name is required.')\r\n  }\r\n  if (!/^[a-z][a-z0-9-]*$/.test(slug)) {\r\n    throw new Error(\r\n      `Invalid project name \"${name}\". Use lowercase letters, numbers, and hyphens (must start with a letter).`,\r\n    )\r\n  }\r\n  return slug\r\n}\r\n\r\nexport function replacePlaceholders(projectDir: string, projectName: string): void {\r\n  const packageJsonPath = join(projectDir, 'package.json')\r\n  const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8')) as PackageJson\r\n\r\n  packageJson.name = projectName\r\n\r\n  for (const field of ['dependencies', 'devDependencies'] as const) {\r\n    const deps = packageJson[field]\r\n    if (!deps) continue\r\n    for (const pkg of Object.keys(deps)) {\r\n      if (pkg.startsWith('@idia-ui/')) {\r\n        deps[pkg] = `^${IDIA_UI_VERSION}`\r\n      }\r\n    }\r\n  }\r\n\r\n  packageJson.devDependencies ??= {}\r\n  packageJson.devDependencies['@idia-ui/cli'] = `^${CLI_VERSION}`\r\n\r\n  writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\\n`, 'utf8')\r\n\r\n  const appJsonPath = join(projectDir, 'app.json')\r\n  const appJson = JSON.parse(readFileSync(appJsonPath, 'utf8')) as {\r\n    expo: { name: string; slug: string; scheme: string }\r\n  }\r\n  appJson.expo.name = projectName\r\n  appJson.expo.slug = projectName\r\n  appJson.expo.scheme = projectName\r\n  writeFileSync(appJsonPath, `${JSON.stringify(appJson, null, 2)}\\n`, 'utf8')\r\n\r\n  const linkingPath = join(projectDir, 'src', 'navigation', 'linking.ts')\r\n  let linking = readFileSync(linkingPath, 'utf8')\r\n  linking = linking.replaceAll(TEMPLATE_SLUG, projectName)\r\n  writeFileSync(linkingPath, linking, 'utf8')\r\n}\r\n\r\nexport function writeManifest(projectDir: string): void {\r\n  const manifestDir = join(projectDir, '.idia')\r\n  mkdirSync(manifestDir, { recursive: true })\r\n  const manifestPath = join(manifestDir, 'manifest.json')\r\n  const manifest = {\r\n    idiaCli: CLI_VERSION,\r\n    core: IDIA_UI_VERSION,\r\n  }\r\n  writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`, 'utf8')\r\n}\r\n","/** Monorepo-local @idia-ui/* minor — pins generated app deps (RFC §10.4). */\r\nexport const IDIA_UI_VERSION = '0.2.0'\r\n\r\n/** create-idia-app package version — keep in sync with package.json. */\r\nexport const CREATE_APP_VERSION = '0.2.0'\r\n\r\n/** @idia-ui/cli version written to manifest + devDependency. */\r\nexport const CLI_VERSION = '0.2.0'\r\n\r\nexport const TEMPLATE_SLUG = 'my-idia-app'\r\n","export type PackageManager = 'pnpm' | 'npm' | 'yarn'\r\n\r\nconst PM_VALUES = new Set<PackageManager>(['pnpm', 'npm', 'yarn'])\r\n\r\nexport function parsePackageManagerFlag(value: string | undefined): PackageManager | undefined {\r\n  if (!value) return undefined\r\n  const normalized = value.toLowerCase() as PackageManager\r\n  if (!PM_VALUES.has(normalized)) {\r\n    throw new Error(`Invalid --pm value \"${value}\". Use pnpm, npm, or yarn.`)\r\n  }\r\n  return normalized\r\n}\r\n\r\nexport function detectPackageManager(override?: PackageManager): PackageManager {\r\n  if (override) return override\r\n\r\n  const agent = process.env.npm_config_user_agent ?? ''\r\n  if (agent.includes('pnpm')) return 'pnpm'\r\n  if (agent.includes('yarn')) return 'yarn'\r\n\r\n  const execPath = process.env.npm_execpath ?? ''\r\n  if (execPath.includes('pnpm')) return 'pnpm'\r\n  if (execPath.includes('yarn')) return 'yarn'\r\n\r\n  return 'npm'\r\n}\r\n\r\nexport function installCommand(pm: PackageManager): { command: string; args: string[] } {\r\n  switch (pm) {\r\n    case 'pnpm':\r\n      return { command: 'pnpm', args: ['install'] }\r\n    case 'yarn':\r\n      return { command: 'yarn', args: ['install'] }\r\n    default:\r\n      return { command: 'npm', args: ['install'] }\r\n  }\r\n}\r\n\r\nexport function devCommand(pm: PackageManager): string {\r\n  switch (pm) {\r\n    case 'pnpm':\r\n      return 'pnpm dev'\r\n    case 'yarn':\r\n      return 'yarn dev'\r\n    default:\r\n      return 'npm run dev'\r\n  }\r\n}\r\n\r\nexport function doctorCommand(pm: PackageManager): { command: string; args: string[] } {\r\n  return idiaUiCommand(pm, ['doctor'])\r\n}\r\n\r\nexport type IdiaUiCommand = { command: string; args: string[] }\r\n\r\nexport function idiaUiCommand(\r\n  pm: PackageManager,\r\n  subcommand: string[],\r\n): IdiaUiCommand {\r\n  switch (pm) {\r\n    case 'pnpm':\r\n      return { command: 'pnpm', args: ['exec', 'idia-ui', ...subcommand] }\r\n    case 'yarn':\r\n      return { command: 'yarn', args: ['idia-ui', ...subcommand] }\r\n    default:\r\n      return { command: 'npx', args: ['idia-ui', ...subcommand] }\r\n  }\r\n}\r\n","import { existsSync } from 'node:fs'\r\n\r\nimport { monorepoDoctorCliPath } from './paths.js'\r\nimport { idiaUiCommand, type PackageManager } from './pm.js'\r\n\r\n/** Monorepo sibling @idia-ui/cli when developing create-idia-app locally. */\r\nexport function resolveMonorepoDoctorCli(): string | null {\r\n  const candidate = monorepoDoctorCliPath()\r\n  return existsSync(candidate) ? candidate : null\r\n}\r\n\r\nexport function resolveIdiaUiInvocation(\r\n  pm: PackageManager,\r\n  subcommand: string[],\r\n): { command: string; args: string[]; via: 'monorepo' | 'installed' } {\r\n  const monorepoCli = resolveMonorepoDoctorCli()\r\n  if (monorepoCli) {\r\n    return {\r\n      command: process.execPath,\r\n      args: [monorepoCli, ...subcommand],\r\n      via: 'monorepo',\r\n    }\r\n  }\r\n\r\n  const viaPm = idiaUiCommand(pm, subcommand)\r\n  return { ...viaPm, via: 'installed' }\r\n}\r\n\r\nexport function resolveDoctorInvocation(\r\n  pm: PackageManager,\r\n): { command: string; args: string[]; via: 'monorepo' | 'installed' } {\r\n  return resolveIdiaUiInvocation(pm, ['doctor'])\r\n}\r\n","import { dirname, join } from 'node:path'\r\n\r\n/** CLI entry file (dist/index.js) — reliable in CJS bin bundles. */\r\nfunction cliEntryPath(): string {\r\n  const entry = process.argv[1]\r\n  if (!entry) {\r\n    throw new Error('Unable to resolve CLI entry path.')\r\n  }\r\n  return entry\r\n}\r\n\r\nexport function packageRootDir(): string {\r\n  return join(dirname(cliEntryPath()), '..')\r\n}\r\n\r\nexport function templateDir(): string {\r\n  return join(packageRootDir(), 'template')\r\n}\r\n\r\nexport function monorepoDoctorCliPath(): string {\r\n  return join(packageRootDir(), '..', 'cli', 'dist', 'cli.js')\r\n}\r\n","import { scaffold } from './scaffold.js'\r\nimport { parsePackageManagerFlag } from './pm.js'\r\nimport { CREATE_APP_VERSION } from './constants.js'\r\n\r\nfunction printHelp(): void {\r\n  console.log(`create-idia-app v${CREATE_APP_VERSION}\r\n\r\nUsage:\r\n  create-idia-app [project-name] [options]\r\n\r\nOptions:\r\n  --pm <pnpm|npm|yarn>   Override package manager detection\r\n  --skip-install         Skip install and idia-ui doctor\r\n  --force                Overwrite target directory if it exists\r\n  --no-git               Skip git init\r\n  --with-storybook       Not available (Phase 3) — prints warning\r\n  --with-brain           Not available (Phase 4) — prints warning\r\n  -h, --help             Show help\r\n  -V, --version          Show version\r\n`)\r\n}\r\n\r\nfunction parseArgs(argv: string[]): {\r\n  projectName?: string\r\n  pm?: ReturnType<typeof parsePackageManagerFlag>\r\n  skipInstall: boolean\r\n  force: boolean\r\n  noGit: boolean\r\n  withStorybook: boolean\r\n  withBrain: boolean\r\n  help: boolean\r\n  version: boolean\r\n} {\r\n  const result = {\r\n    projectName: undefined as string | undefined,\r\n    pm: undefined as ReturnType<typeof parsePackageManagerFlag>,\r\n    skipInstall: false,\r\n    force: false,\r\n    noGit: false,\r\n    withStorybook: false,\r\n    withBrain: false,\r\n    help: false,\r\n    version: false,\r\n  }\r\n\r\n  for (let i = 0; i < argv.length; i += 1) {\r\n    const arg = argv[i]\r\n    switch (arg) {\r\n      case '--pm':\r\n        result.pm = parsePackageManagerFlag(argv[++i])\r\n        break\r\n      case '--skip-install':\r\n        result.skipInstall = true\r\n        break\r\n      case '--force':\r\n        result.force = true\r\n        break\r\n      case '--no-git':\r\n        result.noGit = true\r\n        break\r\n      case '--with-storybook':\r\n        result.withStorybook = true\r\n        break\r\n      case '--with-brain':\r\n        result.withBrain = true\r\n        break\r\n      case '-h':\r\n      case '--help':\r\n        result.help = true\r\n        break\r\n      case '-V':\r\n      case '--version':\r\n        result.version = true\r\n        break\r\n      default:\r\n        if (arg.startsWith('-')) {\r\n          throw new Error(`Unknown option: ${arg}`)\r\n        }\r\n        if (!result.projectName) {\r\n          result.projectName = arg\r\n        } else {\r\n          throw new Error(`Unexpected argument: ${arg}`)\r\n        }\r\n    }\r\n  }\r\n\r\n  return result\r\n}\r\n\r\nfunction main(): void {\r\n  try {\r\n    const args = parseArgs(process.argv.slice(2))\r\n\r\n    if (args.help) {\r\n      printHelp()\r\n      return\r\n    }\r\n\r\n    if (args.version) {\r\n      console.log(CREATE_APP_VERSION)\r\n      return\r\n    }\r\n\r\n    if (!args.projectName) {\r\n      printHelp()\r\n      throw new Error('Project name is required. Example: create-idia-app my-app')\r\n    }\r\n\r\n    scaffold({\r\n      projectName: args.projectName,\r\n      targetDir: process.cwd(),\r\n      pm: args.pm,\r\n      skipInstall: args.skipInstall,\r\n      force: args.force,\r\n      noGit: args.noGit,\r\n      withStorybook: args.withStorybook,\r\n      withBrain: args.withBrain,\r\n    })\r\n  } catch (error) {\r\n    const message = error instanceof Error ? error.message : String(error)\r\n    console.error(`\\nError: ${message}`)\r\n    process.exit(1)\r\n  }\r\n}\r\n\r\nmain()\r\n"],"mappings":";;;;AAAA,IAAAA,kBAAsD;AACtD,IAAAC,oBAAqB;AACrB,gCAA0B;;;ACF1B,qBAAuD;AACvD,uBAAqB;;;ACAd,IAAM,kBAAkB;AAGxB,IAAM,qBAAqB;AAG3B,IAAM,cAAc;AAEpB,IAAM,gBAAgB;;;ADEtB,SAAS,YAAY,MAAsB;AAChD,SAAO,KACJ,KAAK,EACL,QAAQ,WAAW,GAAG,EACtB,QAAQ,mBAAmB,OAAO,EAClC,YAAY,EACZ,QAAQ,eAAe,GAAG,EAC1B,QAAQ,OAAO,GAAG,EAClB,QAAQ,UAAU,EAAE;AACzB;AAEO,SAAS,oBAAoB,MAAsB;AACxD,QAAM,OAAO,YAAY,IAAI;AAC7B,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,MAAM,2BAA2B;AAAA,EAC7C;AACA,MAAI,CAAC,oBAAoB,KAAK,IAAI,GAAG;AACnC,UAAM,IAAI;AAAA,MACR,yBAAyB,IAAI;AAAA,IAC/B;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,oBAAoB,YAAoB,aAA2B;AACjF,QAAM,sBAAkB,uBAAK,YAAY,cAAc;AACvD,QAAM,cAAc,KAAK,UAAM,6BAAa,iBAAiB,MAAM,CAAC;AAEpE,cAAY,OAAO;AAEnB,aAAW,SAAS,CAAC,gBAAgB,iBAAiB,GAAY;AAChE,UAAM,OAAO,YAAY,KAAK;AAC9B,QAAI,CAAC,KAAM;AACX,eAAW,OAAO,OAAO,KAAK,IAAI,GAAG;AACnC,UAAI,IAAI,WAAW,WAAW,GAAG;AAC/B,aAAK,GAAG,IAAI,IAAI,eAAe;AAAA,MACjC;AAAA,IACF;AAAA,EACF;AAEA,cAAY,oBAAoB,CAAC;AACjC,cAAY,gBAAgB,cAAc,IAAI,IAAI,WAAW;AAE7D,oCAAc,iBAAiB,GAAG,KAAK,UAAU,aAAa,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AAElF,QAAM,kBAAc,uBAAK,YAAY,UAAU;AAC/C,QAAM,UAAU,KAAK,UAAM,6BAAa,aAAa,MAAM,CAAC;AAG5D,UAAQ,KAAK,OAAO;AACpB,UAAQ,KAAK,OAAO;AACpB,UAAQ,KAAK,SAAS;AACtB,oCAAc,aAAa,GAAG,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AAE1E,QAAM,kBAAc,uBAAK,YAAY,OAAO,cAAc,YAAY;AACtE,MAAI,cAAU,6BAAa,aAAa,MAAM;AAC9C,YAAU,QAAQ,WAAW,eAAe,WAAW;AACvD,oCAAc,aAAa,SAAS,MAAM;AAC5C;AAEO,SAAS,cAAc,YAA0B;AACtD,QAAM,kBAAc,uBAAK,YAAY,OAAO;AAC5C,gCAAU,aAAa,EAAE,WAAW,KAAK,CAAC;AAC1C,QAAM,mBAAe,uBAAK,aAAa,eAAe;AACtD,QAAM,WAAW;AAAA,IACf,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AACA,oCAAc,cAAc,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AAC9E;;;AE9EA,IAAM,YAAY,oBAAI,IAAoB,CAAC,QAAQ,OAAO,MAAM,CAAC;AAE1D,SAAS,wBAAwB,OAAuD;AAC7F,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,aAAa,MAAM,YAAY;AACrC,MAAI,CAAC,UAAU,IAAI,UAAU,GAAG;AAC9B,UAAM,IAAI,MAAM,uBAAuB,KAAK,4BAA4B;AAAA,EAC1E;AACA,SAAO;AACT;AAEO,SAAS,qBAAqB,UAA2C;AAC9E,MAAI,SAAU,QAAO;AAErB,QAAM,QAAQ,QAAQ,IAAI,yBAAyB;AACnD,MAAI,MAAM,SAAS,MAAM,EAAG,QAAO;AACnC,MAAI,MAAM,SAAS,MAAM,EAAG,QAAO;AAEnC,QAAM,WAAW,QAAQ,IAAI,gBAAgB;AAC7C,MAAI,SAAS,SAAS,MAAM,EAAG,QAAO;AACtC,MAAI,SAAS,SAAS,MAAM,EAAG,QAAO;AAEtC,SAAO;AACT;AAEO,SAAS,eAAe,IAAyD;AACtF,UAAQ,IAAI;AAAA,IACV,KAAK;AACH,aAAO,EAAE,SAAS,QAAQ,MAAM,CAAC,SAAS,EAAE;AAAA,IAC9C,KAAK;AACH,aAAO,EAAE,SAAS,QAAQ,MAAM,CAAC,SAAS,EAAE;AAAA,IAC9C;AACE,aAAO,EAAE,SAAS,OAAO,MAAM,CAAC,SAAS,EAAE;AAAA,EAC/C;AACF;AAEO,SAAS,WAAW,IAA4B;AACrD,UAAQ,IAAI;AAAA,IACV,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAQO,SAAS,cACd,IACA,YACe;AACf,UAAQ,IAAI;AAAA,IACV,KAAK;AACH,aAAO,EAAE,SAAS,QAAQ,MAAM,CAAC,QAAQ,WAAW,GAAG,UAAU,EAAE;AAAA,IACrE,KAAK;AACH,aAAO,EAAE,SAAS,QAAQ,MAAM,CAAC,WAAW,GAAG,UAAU,EAAE;AAAA,IAC7D;AACE,aAAO,EAAE,SAAS,OAAO,MAAM,CAAC,WAAW,GAAG,UAAU,EAAE;AAAA,EAC9D;AACF;;;ACnEA,IAAAC,kBAA2B;;;ACA3B,IAAAC,oBAA8B;AAG9B,SAAS,eAAuB;AAC9B,QAAM,QAAQ,QAAQ,KAAK,CAAC;AAC5B,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AACA,SAAO;AACT;AAEO,SAAS,iBAAyB;AACvC,aAAO,4BAAK,2BAAQ,aAAa,CAAC,GAAG,IAAI;AAC3C;AAEO,SAAS,cAAsB;AACpC,aAAO,wBAAK,eAAe,GAAG,UAAU;AAC1C;AAEO,SAAS,wBAAgC;AAC9C,aAAO,wBAAK,eAAe,GAAG,MAAM,OAAO,QAAQ,QAAQ;AAC7D;;;ADfO,SAAS,2BAA0C;AACxD,QAAM,YAAY,sBAAsB;AACxC,aAAO,4BAAW,SAAS,IAAI,YAAY;AAC7C;AAEO,SAAS,wBACd,IACA,YACoE;AACpE,QAAM,cAAc,yBAAyB;AAC7C,MAAI,aAAa;AACf,WAAO;AAAA,MACL,SAAS,QAAQ;AAAA,MACjB,MAAM,CAAC,aAAa,GAAG,UAAU;AAAA,MACjC,KAAK;AAAA,IACP;AAAA,EACF;AAEA,QAAM,QAAQ,cAAc,IAAI,UAAU;AAC1C,SAAO,EAAE,GAAG,OAAO,KAAK,YAAY;AACtC;AAEO,SAAS,wBACd,IACoE;AACpE,SAAO,wBAAwB,IAAI,CAAC,QAAQ,CAAC;AAC/C;;;AJGA,SAAS,qBAA6B;AACpC,QAAM,UAAU,YAAY;AAC5B,UAAI,4BAAW,OAAO,EAAG,QAAO;AAChC,QAAM,IAAI;AAAA,IACR;AAAA,EACF;AACF;AAEA,SAAS,WACP,SACA,MACA,KAC0C;AAC1C,QAAM,aAAS,qCAAU,SAAS,MAAM;AAAA,IACtC;AAAA,IACA,OAAO;AAAA,IACP,OAAO,QAAQ,aAAa;AAAA,EAC9B,CAAC;AACD,MAAI,OAAO,OAAO;AAChB,WAAO,EAAE,QAAQ,OAAO,QAAQ,OAAO,OAAO,MAAM;AAAA,EACtD;AACA,SAAO,EAAE,QAAQ,OAAO,OAAO;AACjC;AAEO,SAAS,SAAS,SAA0C;AACjE,QAAM,cAAc,oBAAoB,QAAQ,WAAW;AAC3D,QAAM,aAAa,QAAQ,gBACvB,wBAAK,QAAQ,WAAW,WAAW,QACnC,wBAAK,QAAQ,IAAI,GAAG,WAAW;AACnC,QAAM,KAAK,qBAAqB,QAAQ,EAAE;AAE1C,UAAI,4BAAW,UAAU,GAAG;AAC1B,QAAI,CAAC,QAAQ,OAAO;AAClB,YAAM,IAAI;AAAA,QACR,cAAc,UAAU;AAAA,MAC1B;AAAA,IACF;AACA,gCAAO,YAAY,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAAA,EACrD;AAEA,iCAAU,YAAY,EAAE,WAAW,KAAK,CAAC;AACzC,8BAAO,mBAAmB,GAAG,YAAY,EAAE,WAAW,KAAK,CAAC;AAE5D,sBAAoB,YAAY,WAAW;AAC3C,gBAAc,UAAU;AAExB,MAAI,CAAC,QAAQ,OAAO;AAClB,UAAM,MAAM,WAAW,OAAO,CAAC,MAAM,GAAG,UAAU;AAClD,QAAI,IAAI,OAAO;AACb,cAAQ,KAAK,4BAAuB,IAAI,MAAM,OAAO;AAAA,IACvD;AAAA,EACF;AAEA,MAAI,YAAY;AAChB,MAAI,YAAY;AAChB,MAAI,iBAAgC;AACpC,MAAI,YAAyC;AAE7C,MAAI,CAAC,QAAQ,aAAa;AACxB,YAAQ,IAAI;AAAA,+BAAkC,EAAE,QAAG;AACnD,UAAM,UAAU,eAAe,EAAE;AACjC,UAAM,gBAAgB,WAAW,QAAQ,SAAS,QAAQ,MAAM,UAAU;AAC1E,QAAI,cAAc,OAAO;AACvB,YAAM,cAAc;AAAA,IACtB;AACA,QAAI,cAAc,WAAW,GAAG;AAC9B,YAAM,IAAI,MAAM,GAAG,EAAE,kCAAkC,cAAc,UAAU,CAAC,EAAE;AAAA,IACpF;AACA,gBAAY;AAEZ,YAAQ,IAAI,6CAAwC;AACpD,UAAM,SAAS,wBAAwB,EAAE;AACzC,gBAAY,OAAO;AACnB,UAAM,eAAe,WAAW,OAAO,SAAS,OAAO,MAAM,UAAU;AACvE,gBAAY;AACZ,qBAAiB,aAAa;AAC9B,QAAI,aAAa,OAAO;AACtB,cAAQ,KAAK,wCAAmC,aAAa,MAAM,OAAO;AAC1E,kBAAY;AACZ,uBAAiB;AAAA,IACnB,WAAW,mBAAmB,GAAG;AAC/B,cAAQ;AAAA,QACN,0CAAqC,cAAc;AAAA,MACrD;AAAA,IACF;AAEA,0BAAsB,YAAY,IAAI,OAAO;AAAA,EAC/C,OAAO;AACL,YAAQ,IAAI,mEAAmE;AAC/E,QAAI,QAAQ,iBAAiB,QAAQ,WAAW;AAC9C,cAAQ;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,iBAAe,aAAa,YAAY,IAAI,OAAO;AAEnD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,sBACP,YACA,IACA,SACM;AACN,MAAI,QAAQ,eAAe;AACzB,YAAQ,IAAI,uCAAkC;AAC9C,UAAM,MAAM,wBAAwB,IAAI,CAAC,OAAO,WAAW,CAAC;AAC5D,UAAM,SAAS,WAAW,IAAI,SAAS,IAAI,MAAM,UAAU;AAC3D,QAAI,OAAO,OAAO;AAChB,cAAQ,KAAK,+CAA0C,OAAO,MAAM,OAAO;AAAA,IAC7E,WAAW,OAAO,WAAW,GAAG;AAC9B,cAAQ;AAAA,QACN,iDAA4C,OAAO,UAAU,CAAC;AAAA,MAChE;AAAA,IACF;AAAA,EACF;AAEA,MAAI,QAAQ,WAAW;AACrB,YAAQ,IAAI,mCAA8B;AAC1C,UAAM,MAAM,wBAAwB,IAAI,CAAC,OAAO,OAAO,CAAC;AACxD,UAAM,SAAS,WAAW,IAAI,SAAS,IAAI,MAAM,UAAU;AAC3D,QAAI,OAAO,OAAO;AAChB,cAAQ,KAAK,2CAAsC,OAAO,MAAM,OAAO;AAAA,IACzE,WAAW,OAAO,WAAW,GAAG;AAC9B,cAAQ;AAAA,QACN,6CAAwC,OAAO,UAAU,CAAC;AAAA,MAC5D;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,eACP,aACA,YACA,IACA,SACM;AACN,QAAM,MAAM,WAAW,EAAE;AACzB,UAAQ,IAAI,4CAAuC;AACnD,UAAQ,IAAI,aAAa;AACzB,UAAQ,IAAI,QAAQ,UAAU,EAAE;AAChC,MAAI,KAAC,gCAAW,wBAAK,YAAY,cAAc,CAAC,GAAG;AACjD,UAAM,UAAU,eAAe,EAAE;AACjC,YAAQ,IAAI,KAAK,QAAQ,OAAO,IAAI,QAAQ,KAAK,KAAK,GAAG,CAAC,EAAE;AAAA,EAC9D;AACA,UAAQ,IAAI,KAAK,GAAG,EAAE;AACtB,UAAQ,IAAI,KAAK,OAAO,QAAQ,uBAAuB,GAAG,EAAE,sBAAsB,EAAE;AACpF,MAAI,CAAC,QAAQ,eAAe;AAC1B,YAAQ,IAAI,KAAK,OAAO,QAAQ,8BAA8B,GAAG,EAAE,6BAA6B,EAAE;AAAA,EACpG;AACA,MAAI,CAAC,QAAQ,WAAW;AACtB,YAAQ,IAAI,KAAK,OAAO,QAAQ,0BAA0B,GAAG,EAAE,yBAAyB,EAAE;AAAA,EAC5F;AACF;;;AMlMA,SAAS,YAAkB;AACzB,UAAQ,IAAI,oBAAoB,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAcnD;AACD;AAEA,SAAS,UAAU,MAUjB;AACA,QAAM,SAAS;AAAA,IACb,aAAa;AAAA,IACb,IAAI;AAAA,IACJ,aAAa;AAAA,IACb,OAAO;AAAA,IACP,OAAO;AAAA,IACP,eAAe;AAAA,IACf,WAAW;AAAA,IACX,MAAM;AAAA,IACN,SAAS;AAAA,EACX;AAEA,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,GAAG;AACvC,UAAM,MAAM,KAAK,CAAC;AAClB,YAAQ,KAAK;AAAA,MACX,KAAK;AACH,eAAO,KAAK,wBAAwB,KAAK,EAAE,CAAC,CAAC;AAC7C;AAAA,MACF,KAAK;AACH,eAAO,cAAc;AACrB;AAAA,MACF,KAAK;AACH,eAAO,QAAQ;AACf;AAAA,MACF,KAAK;AACH,eAAO,QAAQ;AACf;AAAA,MACF,KAAK;AACH,eAAO,gBAAgB;AACvB;AAAA,MACF,KAAK;AACH,eAAO,YAAY;AACnB;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,eAAO,OAAO;AACd;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,eAAO,UAAU;AACjB;AAAA,MACF;AACE,YAAI,IAAI,WAAW,GAAG,GAAG;AACvB,gBAAM,IAAI,MAAM,mBAAmB,GAAG,EAAE;AAAA,QAC1C;AACA,YAAI,CAAC,OAAO,aAAa;AACvB,iBAAO,cAAc;AAAA,QACvB,OAAO;AACL,gBAAM,IAAI,MAAM,wBAAwB,GAAG,EAAE;AAAA,QAC/C;AAAA,IACJ;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,OAAa;AACpB,MAAI;AACF,UAAM,OAAO,UAAU,QAAQ,KAAK,MAAM,CAAC,CAAC;AAE5C,QAAI,KAAK,MAAM;AACb,gBAAU;AACV;AAAA,IACF;AAEA,QAAI,KAAK,SAAS;AAChB,cAAQ,IAAI,kBAAkB;AAC9B;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,aAAa;AACrB,gBAAU;AACV,YAAM,IAAI,MAAM,2DAA2D;AAAA,IAC7E;AAEA,aAAS;AAAA,MACP,aAAa,KAAK;AAAA,MAClB,WAAW,QAAQ,IAAI;AAAA,MACvB,IAAI,KAAK;AAAA,MACT,aAAa,KAAK;AAAA,MAClB,OAAO,KAAK;AAAA,MACZ,OAAO,KAAK;AAAA,MACZ,eAAe,KAAK;AAAA,MACpB,WAAW,KAAK;AAAA,IAClB,CAAC;AAAA,EACH,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAQ,MAAM;AAAA,SAAY,OAAO,EAAE;AACnC,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;AAEA,KAAK;","names":["import_node_fs","import_node_path","import_node_fs","import_node_path"]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "create-idia-app",
+  "version": "0.2.0",
+  "description": "Scaffold an Expo + idia-ui consumer app from the official template",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/idia-ui/idia-ui.git",
+    "directory": "packages/create-idia-app"
+  },
+  "bin": {
+    "create-idia-app": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "template"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prebuild": "node scripts/copy-template.mjs",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist template",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/template/.cursor/rules/idia-ui-ds-brain.mdc

@@ -0,0 +1,32 @@
+---
+description: "Always-apply ds-brain rules: read AGENTS.md, use generated registry indexes, do not invent components or variants."
+globs:
+  - "**/*"
+alwaysApply: true
+---
+# Idia UI — ds-brain
+
+Operational rules for AI coding agents working in this repo.
+
+- Read `.idia/brain/AGENTS.md` before design-system work.
+- If authored docs and generated files conflict, authored docs win.
+- `foundations/`
+- `components/`
+- `patterns/`
+- `decisions/`
+- Read `AGENTS.md` (repo root) — **session-start**; mandatory first Read for **any** task (see root `AGENTS.md`).
+- Read `.idia/brain/AGENTS.md` — **gate step 1**; brain entrypoint (this file).
+- Read `.idia/brain/registry/ai-index.generated.json` — **gate step 2**; **STOP** — required before any component or pattern doc.
+- Read `.idia/brain/ai/skills/ds-brain-index/SKILL.md` — **gate step 3**; **required** meta router; read before domain skills and component/pattern docs.
+- Classify **output mode** and **task intent** from the ai-index before opening authored component docs.
+- Read `AGENTS.md` — entry routing and output-mode read lists.
+- Read `.idia/brain/registry/ai-index.generated.json` — **required** gate before component/pattern docs.
+- Read `ds-brain-index` skill (`.idia/brain/ai/skills/ds-brain-index/SKILL.md`) — **required** meta router before domain skills and authored component docs.
+- Classify output mode from the ai-index.
+- Prefer `.idia/brain/registry/ai-index.generated.json` when present.
+- Use `.idia/brain/registry/component-registry.generated.json` for component metadata — do not invent components, props, variants, tokens, or Figma mappings.
+- Do not edit `.idia/brain/` directly.
+- Do not invent components, props, variants, tokens, or Figma mappings.
+- Do not mark a doc `rich` unless required sections are substantive, especially accessibility for interactive components.
+- Do not claim catalog completeness beyond what the pack registries summarize.
+- If a gap is found, report it to the idia-ui maintainers rather than inventing API or docs.

package/template/.cursor/rules/idia-ui-forms.mdc

@@ -0,0 +1,34 @@
+---
+description: "Form composition: action hierarchy, choice controls (radio/select/checkbox), validation patterns."
+globs:
+  - "**/forms/**"
+  - "**/*Form*"
+  - "**/*form*"
+alwaysApply: false
+---
+# Idia UI — Forms
+
+Apply when editing form flows, field groups, validation, or choice controls.
+
+- Forms collect, validate, and submit structured user input — multiple related values the user enters or edits before a primary action completes the task.
+- Retrieve this pattern plus `patterns/forms.md` and `decisions/action-hierarchy.md`.
+- Retrieve `components/form-section.md` and `components/form-element.md` before generating hierarchy.
+- Retrieve component brain docs for every field you render.
+- Use `FormSection` when there are 2+ logical groups; use built-in `label` on `InputText`/`Select`/`TextArea`/`InputGroup` when possible.
+- Reserve `FormElement` for custom/headless controls or `Toggle` group labels.
+- Apply `FORM_V_GAP` / `FORM_H_GAP` from `foundations/spacing.md` — do not invent spacing tokens.
+- Retrieve this pattern, `patterns/forms.md`, and `patterns/form-composition.md` for layout context.
+- Retrieve `components/form-element.md` and every field component you render.
+- Import validators from `@idia-ui/validators` — do not duplicate regex in screens.
+- Map `formState.errors` to `hasError` + `errorText` on the matching field.
+- Use `mode: 'onSubmit'` as default for short forms; gate on-change revalidation with `isSubmitted`.
+- Set submit `Button` `loading` during async work.
+- Each local action group should have **one primary action** — the control that completes the main task. Secondary actions support cancellation, back navigation, alternative flows, or lower-priority choices. Destructive actions must be visually distinct and must not read as casual alternatives to the primary action.
+- **Form footers** — submit, save, continue, cancel, back (`patterns/forms.md`)
+- **Dialog or sheet action rows** — confirm, dismiss, delete with confirmation (`patterns/modal-routing.md`, `components/confirmation-modal.md`)
+- **Modal `footer` slots** — save/cancel pairs on responsive `Modal` branches (`components/modal.md`)
+- **Wizard step footers** — next/continue vs back/submit on first, middle, and last steps (`patterns/wizard-flows.md`)
+- Choose the control by **selection model**, **visibility needs**, and **visual density**. All Group A choice controls have brain docs — retrieve the cited component doc before generating props.
+- Form task-intent components: avatar-upload, button, checkbox, custom-selection, date-input, date-range-input, form-element, form-section, ….
+- Form foundations: color, spacing, tokens, typography.
+- Retrieve pattern docs from ds-brain index task intent `form` before generating form UI.