cascivo 0.1.4 → 0.2.0

package/dist/template-init-DGEgatij.mjs

@@ -0,0 +1,179 @@
+import { r as writeFileSafe } from "./fs-m7ZvuBBm.mjs";
+import { join, resolve } from "node:path";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+//#region src/commands/template-init.ts
+function pascal(name) {
+	return name.split(/[-_/]/).filter(Boolean).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+}
+function rawUrl(repo, path) {
+	if (!repo) return path;
+	return `https://raw.githubusercontent.com/${repo}/main/${path}`;
+}
+function pageSource(name, components) {
+	const comp = pascal(name);
+	return `${components.length > 0 ? `// Components installed via the template's registryDependencies:\n// ${components.join(", ")}\n` : ""}import './${name}.module.css'
+
+/**
+ * ${comp} template page. Owned, copy-paste source — adapt freely.
+ * Presentational only: no useState/useEffect (cascade house rules).
+ */
+export function ${comp}Page() {
+  return (
+    <main className="${name}-page">
+      <h1>${comp}</h1>
+      {/* Compose the template's components here. */}
+    </main>
+  )
+}
+`;
+}
+function cssSource(name) {
+	return `@layer components {
+  .${name}-page {
+    display: grid;
+    gap: var(--cascivo-space-4, 1rem);
+    padding: var(--cascivo-space-4, 1rem);
+  }
+}
+`;
+}
+function fixturesSource(name) {
+	return `/** Mock data for the ${name} template. Replace with your real source. */
+export const ${name.replace(/-/g, "_")}Fixtures = {
+  items: [],
+}
+`;
+}
+function templateMetaSource(meta) {
+	return `import type { TemplateMeta } from '@cascivo/registry'
+
+export const meta: TemplateMeta = ${JSON.stringify(meta, null, 2)}
+`;
+}
+/**
+* Build the files + registry item for a new template. Pure — no I/O — so it can
+* be unit-tested. The caller writes the files and merges the item into
+* `cascade-registry.json`.
+*/
+function buildTemplateScaffold(opts) {
+	const { name, category, framework, components, repo, license, author } = opts;
+	const dir = `src/${name}`;
+	const pageTarget = `src/pages/${name}.tsx`;
+	const cssTarget = `src/pages/${name}.module.css`;
+	const fixturesTarget = `src/fixtures/${name}.ts`;
+	const files = [
+		{
+			path: `${dir}/${name}.tsx`,
+			contents: pageSource(name, components)
+		},
+		{
+			path: `${dir}/${name}.module.css`,
+			contents: cssSource(name)
+		},
+		{
+			path: `${dir}/fixtures.ts`,
+			contents: fixturesSource(name)
+		}
+	];
+	const meta = {
+		intent: `${pascal(name)} template`,
+		framework,
+		category,
+		screenshots: [{
+			light: rawUrl(repo, `screenshots/${name}-light.png`),
+			alt: `${name} preview (light)`
+		}],
+		fileRoles: {
+			[pageTarget]: "page",
+			[cssTarget]: "asset",
+			[fixturesTarget]: "fixture"
+		},
+		pages: [{
+			name: pascal(name),
+			target: pageTarget
+		}]
+	};
+	const item = {
+		schemaVersion: 2,
+		name,
+		type: "template",
+		description: `${pascal(name)} template`,
+		category,
+		version: "0.1.0",
+		license,
+		...author ? { author } : {},
+		...repo ? { homepage: `https://github.com/${repo}` } : {},
+		files: [
+			{
+				url: rawUrl(repo, `${dir}/${name}.tsx`),
+				target: pageTarget
+			},
+			{
+				url: rawUrl(repo, `${dir}/${name}.module.css`),
+				target: cssTarget
+			},
+			{
+				url: rawUrl(repo, `${dir}/fixtures.ts`),
+				target: fixturesTarget
+			}
+		],
+		dependencies: [],
+		registryDependencies: components,
+		tags: [category, "template"],
+		meta
+	};
+	files.push({
+		path: `${dir}/${name}.template.ts`,
+		contents: templateMetaSource(meta)
+	});
+	return {
+		files,
+		item
+	};
+}
+function flag(args, key) {
+	const eq = args.find((a) => a.startsWith(`--${key}=`));
+	if (eq) return eq.slice(key.length + 3);
+	const idx = args.indexOf(`--${key}`);
+	const next = idx !== -1 ? args[idx + 1] : void 0;
+	return next && !next.startsWith("--") ? next : void 0;
+}
+async function templateInit(args, cwd = process.cwd()) {
+	const name = args.find((a) => !a.startsWith("-"));
+	if (!name) {
+		console.error("Usage: cascivo template init <name> [--category dashboard] [--framework react-vite] [--components card,line-chart] [--repo owner/repo]");
+		process.exitCode = 1;
+		return;
+	}
+	const componentsArg = flag(args, "components");
+	const opts = {
+		name,
+		category: flag(args, "category") ?? "misc",
+		framework: flag(args, "framework") ?? "react-vite",
+		components: componentsArg ? componentsArg.split(",").map((c) => c.trim()).filter(Boolean) : [],
+		license: flag(args, "license") ?? "MIT",
+		...flag(args, "repo") ? { repo: flag(args, "repo") } : {},
+		...flag(args, "author") ? { author: flag(args, "author") } : {}
+	};
+	const { files, item } = buildTemplateScaffold(opts);
+	for (const file of files) await writeFileSafe(join(cwd, file.path), file.contents);
+	const registryPath = resolve(cwd, "cascivo-registry.json");
+	let index;
+	if (existsSync(registryPath)) {
+		index = JSON.parse(await readFile(registryPath, "utf8"));
+		index.items = (index.items ?? []).filter((i) => i.name !== item.name);
+		index.items.push(item);
+	} else index = {
+		schemaVersion: 2,
+		name: opts.repo ?? name,
+		items: [item]
+	};
+	await writeFileSafe(registryPath, `${JSON.stringify(index, null, 2)}\n`);
+	console.log(`Scaffolded template "${name}" (${files.length} files + cascivo-registry.json).`);
+	console.log("Next: fill in the page, capture screenshots, then `cascivo registry build`.");
+}
+//#endregion
+export { templateInit };
+
+//# sourceMappingURL=template-init-DGEgatij.mjs.map

package/dist/template-init-DGEgatij.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-init-DGEgatij.mjs","names":[],"sources":["../src/commands/template-init.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { readFile } from 'node:fs/promises'\nimport { join, resolve } from 'node:path'\nimport type { RegistryItem, TemplateMeta } from '@cascivo/registry'\nimport { writeFileSafe } from '../utils/fs.js'\n\nexport interface TemplateInitOptions {\n  /** kebab-case template name (also the source folder + registry item name). */\n  name: string\n  /** Discovery category, e.g. \"dashboard\". */\n  category: string\n  /** Target framework for the page source. */\n  framework: TemplateMeta['framework']\n  /** Components the template composes (registry names). */\n  components: string[]\n  /** Repo owner/name used to build raw file URLs and the homepage. */\n  repo?: string\n  /** License SPDX id. */\n  license: string\n  /** Author. */\n  author?: string\n}\n\nexport interface ScaffoldFile {\n  /** Path relative to the template repo root. */\n  path: string\n  contents: string\n}\n\nfunction pascal(name: string): string {\n  return name\n    .split(/[-_/]/)\n    .filter(Boolean)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join('')\n}\n\nfunction rawUrl(repo: string | undefined, path: string): string {\n  if (!repo) return path\n  return `https://raw.githubusercontent.com/${repo}/main/${path}`\n}\n\nfunction pageSource(name: string, components: string[]): string {\n  const comp = pascal(name)\n  const importLine =\n    components.length > 0\n      ? `// Components installed via the template's registryDependencies:\\n// ${components.join(', ')}\\n`\n      : ''\n  return `${importLine}import './${name}.module.css'\n\n/**\n * ${comp} template page. Owned, copy-paste source — adapt freely.\n * Presentational only: no useState/useEffect (cascade house rules).\n */\nexport function ${comp}Page() {\n  return (\n    <main className=\"${name}-page\">\n      <h1>${comp}</h1>\n      {/* Compose the template's components here. */}\n    </main>\n  )\n}\n`\n}\n\nfunction cssSource(name: string): string {\n  return `@layer components {\n  .${name}-page {\n    display: grid;\n    gap: var(--cascivo-space-4, 1rem);\n    padding: var(--cascivo-space-4, 1rem);\n  }\n}\n`\n}\n\nfunction fixturesSource(name: string): string {\n  return `/** Mock data for the ${name} template. Replace with your real source. */\nexport const ${name.replace(/-/g, '_')}Fixtures = {\n  items: [],\n}\n`\n}\n\nfunction templateMetaSource(meta: TemplateMeta): string {\n  return `import type { TemplateMeta } from '@cascivo/registry'\n\nexport const meta: TemplateMeta = ${JSON.stringify(meta, null, 2)}\n`\n}\n\n/**\n * Build the files + registry item for a new template. Pure — no I/O — so it can\n * be unit-tested. The caller writes the files and merges the item into\n * `cascade-registry.json`.\n */\nexport function buildTemplateScaffold(opts: TemplateInitOptions): {\n  files: ScaffoldFile[]\n  item: RegistryItem\n} {\n  const { name, category, framework, components, repo, license, author } = opts\n  const dir = `src/${name}`\n  const pageTarget = `src/pages/${name}.tsx`\n  const cssTarget = `src/pages/${name}.module.css`\n  const fixturesTarget = `src/fixtures/${name}.ts`\n\n  const files: ScaffoldFile[] = [\n    { path: `${dir}/${name}.tsx`, contents: pageSource(name, components) },\n    { path: `${dir}/${name}.module.css`, contents: cssSource(name) },\n    { path: `${dir}/fixtures.ts`, contents: fixturesSource(name) },\n  ]\n\n  const meta: TemplateMeta = {\n    intent: `${pascal(name)} template`,\n    framework,\n    category,\n    screenshots: [\n      { light: rawUrl(repo, `screenshots/${name}-light.png`), alt: `${name} preview (light)` },\n    ],\n    fileRoles: {\n      [pageTarget]: 'page',\n      [cssTarget]: 'asset',\n      [fixturesTarget]: 'fixture',\n    },\n    pages: [{ name: pascal(name), target: pageTarget }],\n  }\n\n  const item: RegistryItem = {\n    schemaVersion: 2,\n    name,\n    type: 'template',\n    description: `${pascal(name)} template`,\n    category,\n    version: '0.1.0',\n    license,\n    ...(author ? { author } : {}),\n    ...(repo ? { homepage: `https://github.com/${repo}` } : {}),\n    files: [\n      { url: rawUrl(repo, `${dir}/${name}.tsx`), target: pageTarget },\n      { url: rawUrl(repo, `${dir}/${name}.module.css`), target: cssTarget },\n      { url: rawUrl(repo, `${dir}/fixtures.ts`), target: fixturesTarget },\n    ],\n    dependencies: [],\n    registryDependencies: components,\n    tags: [category, 'template'],\n    meta,\n  }\n\n  files.push({ path: `${dir}/${name}.template.ts`, contents: templateMetaSource(meta) })\n\n  return { files, item }\n}\n\nfunction flag(args: string[], key: string): string | undefined {\n  const eq = args.find((a) => a.startsWith(`--${key}=`))\n  if (eq) return eq.slice(key.length + 3)\n  const idx = args.indexOf(`--${key}`)\n  const next = idx !== -1 ? args[idx + 1] : undefined\n  return next && !next.startsWith('--') ? next : undefined\n}\n\nexport async function templateInit(args: string[], cwd: string = process.cwd()): Promise<void> {\n  const name = args.find((a) => !a.startsWith('-'))\n  if (!name) {\n    console.error(\n      'Usage: cascivo template init <name> [--category dashboard] [--framework react-vite] [--components card,line-chart] [--repo owner/repo]',\n    )\n    process.exitCode = 1\n    return\n  }\n\n  const componentsArg = flag(args, 'components')\n  const opts: TemplateInitOptions = {\n    name,\n    category: flag(args, 'category') ?? 'misc',\n    framework: (flag(args, 'framework') as TemplateMeta['framework']) ?? 'react-vite',\n    components: componentsArg\n      ? componentsArg\n          .split(',')\n          .map((c) => c.trim())\n          .filter(Boolean)\n      : [],\n    license: flag(args, 'license') ?? 'MIT',\n    ...(flag(args, 'repo') ? { repo: flag(args, 'repo')! } : {}),\n    ...(flag(args, 'author') ? { author: flag(args, 'author')! } : {}),\n  }\n\n  const { files, item } = buildTemplateScaffold(opts)\n\n  for (const file of files) {\n    await writeFileSafe(join(cwd, file.path), file.contents)\n  }\n\n  // Merge into cascivo-registry.json (create if missing).\n  const registryPath = resolve(cwd, 'cascivo-registry.json')\n  let index: { schemaVersion: 2; name: string; items: RegistryItem[] }\n  if (existsSync(registryPath)) {\n    index = JSON.parse(await readFile(registryPath, 'utf8')) as typeof index\n    index.items = (index.items ?? []).filter((i) => i.name !== item.name)\n    index.items.push(item)\n  } else {\n    index = { schemaVersion: 2, name: opts.repo ?? name, items: [item] }\n  }\n  await writeFileSafe(registryPath, `${JSON.stringify(index, null, 2)}\\n`)\n\n  console.log(`Scaffolded template \"${name}\" (${files.length} files + cascivo-registry.json).`)\n  console.log('Next: fill in the page, capture screenshots, then `cascivo registry build`.')\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cascivo",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "private": false,
   "description": "CLI — npx cascivo init / add / list / update",
   "keywords": [
@@ -42,7 +42,7 @@
     "provenance": true
   },
   "dependencies": {
-    "@cascivo/registry": "^0.1.2"
+    "@cascivo/registry": "^0.1.5"
   },
   "devDependencies": {
     "@types/node": "^25",

package/readme.body.md

@@ -3,17 +3,23 @@ The `cascivo` CLI drives the copy-paste workflow — it scaffolds config, copies
 ## Commands
 
 ```sh
-npx cascivo init              # scaffold cascivo.config.ts + tokens; detects your package manager
-cascivo add button card       # copy component source from the registry into your project
-cascivo add owner/repo/button # install from any third-party registry
-cascivo list                  # list available components
-cascivo update                # pull newer versions of copied components
-cascivo audit --ai            # flag hard-coded values, invented props, missing wiring
-cascivo build                 # build a registry from your own components
+npx cascivo create my-app          # scaffold a full app — Vite + React, app shell, side nav, theme
+npx cascivo create my-app --template owner/repo/dashboard  # …and start from a template
+npx cascivo init                   # scaffold cascivo.config.ts + tokens; detects your package manager
+cascivo add button card            # copy component source from the registry into your project
+cascivo add owner/repo/button      # install from any third-party registry
+cascivo add owner/repo/dashboard   # install a template (its components + page/fixture files)
+cascivo view owner/repo/dashboard  # preview an item (or template) before installing
+cascivo list                       # list available components
+cascivo update                     # pull newer versions of copied components
+cascivo audit --ai                 # flag hard-coded values, invented props, missing wiring
+cascivo build                      # build a registry from your own components
 ```
 
+A **template** is a registry item (`type: "template"`) that bundles a working page with the components it composes (in `registryDependencies`) and its own page/fixture files (each with a `target`). `cascivo add` installs the component closure into your components directory and writes the template's files to their targets; `create --template` does the same into a freshly scaffolded app.
+
 ## How it works
 
-`init` detects npm / pnpm / yarn / bun, writes `cascivo.config.ts`, and wires up the token and theme imports. `add` resolves each component from [`registry.json`](https://github.com/cascivo/cascivo/blob/main/registry.json), fetches its source (TSX + CSS module + manifest) from GitHub raw URLs, and drops it into the path from your config — pulling in any dependencies it needs.
+`create` scaffolds a complete Vite + React + TypeScript app — pre-wired with the cascivo app shell, side navigation, header, and your chosen theme. It asks for a project name, theme, and the nav sections you want, then generates a section component for each. Pass `--theme`, `--sections "Dashboard, Reports"`, or `--yes` to skip the prompts. `init` detects npm / pnpm / yarn / bun, writes `cascivo.config.ts`, and wires up the token and theme imports. `add` resolves each component from [`registry.json`](https://github.com/cascivo/cascivo/blob/main/registry.json), fetches its source (TSX + CSS module + manifest) from GitHub raw URLs, and drops it into the path from your config — pulling in any dependencies it needs.
 
 Because the registry model is open, `add owner/repo/component` installs from any compatible registry, not just the first-party one. See the [registry starter](https://github.com/cascivo/cascivo/tree/main/apps/examples/registry-starter) to publish your own.