cinematic-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pushkar Verma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+
+/**
+ * ProjectSpec — the single source of truth for a cinematic-web project.
+ * Written to cinematic.json at the project root by `cinematic-web create` and `cinematic-web think`.
+ */
+declare const ProjectSpecSchema: z.ZodObject<{
+    /** Human-readable brand name. E.g. "Nura Health" */
+    brand: z.ZodString;
+    /** One-line purpose statement. E.g. "Precision longevity medicine powered by biological data." */
+    purpose: z.ZodString;
+    /** ID of the selected design preset. Must match a folder in presets/. */
+    presetId: z.ZodString;
+    /** Three key value propositions — become Feature card copy. */
+    valueProps: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
+    /** Primary call-to-action text. E.g. "Book a consultation" */
+    cta: z.ZodString;
+    /** Free-text special requests / custom features. */
+    notes: z.ZodDefault<z.ZodString>;
+    /** Stream B: paths to generated product documents (optional). */
+    prd: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>>;
+    ux: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>>;
+    mvp: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>>;
+    /** Reference website URL provided by user (content context only, not design). */
+    referenceUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    brand: string;
+    purpose: string;
+    presetId: string;
+    valueProps: [string, string, string];
+    cta: string;
+    notes: string;
+    prd?: {
+        path: string;
+    } | undefined;
+    ux?: {
+        path: string;
+    } | undefined;
+    mvp?: {
+        path: string;
+    } | undefined;
+    referenceUrl?: string | undefined;
+}, {
+    brand: string;
+    purpose: string;
+    presetId: string;
+    valueProps: [string, string, string];
+    cta: string;
+    notes?: string | undefined;
+    prd?: {
+        path: string;
+    } | undefined;
+    ux?: {
+        path: string;
+    } | undefined;
+    mvp?: {
+        path: string;
+    } | undefined;
+    referenceUrl?: string | undefined;
+}>;
+type ProjectSpec = z.infer<typeof ProjectSpecSchema>;
+
+/**
+ * A fully parsed preset.json — design tokens for one aesthetic direction.
+ */
+interface Preset {
+    id: string;
+    name: string;
+    label: string;
+    template: 'base-react' | 'three-fiber';
+    identity: string;
+    palette: {
+        primary: string;
+        accent: string;
+        background: string;
+        dark: string;
+        primaryLabel: string;
+        accentLabel: string;
+        backgroundLabel: string;
+        darkLabel: string;
+    };
+    typography: {
+        heading: string[];
+        drama?: string;
+        body?: string;
+        data?: string;
+        headingTracking?: string;
+        dramaStyle?: string;
+        microCopy?: string;
+    };
+    googleFonts: string;
+    imageMood: string;
+    unsplashQuery: string;
+    unsplashPhotoId?: string;
+    heroLinePattern: {
+        part1: string;
+        part1Style: string;
+        part2: string;
+        part2Style: string;
+    };
+    dependencies?: Record<string, string>;
+    promptFile?: string;
+    notes?: string;
+}
+/**
+ * Load all presets from the `presets/` directory.
+ * Results are cached after the first call.
+ */
+declare function loadPresetRegistry(presetsDir?: string): Map<string, Preset>;
+/**
+ * Get a single preset by ID. Returns undefined if not found.
+ */
+declare function getPreset(id: string, presetsDir?: string): Preset | undefined;
+/**
+ * Get all presets as an array, sorted by id for deterministic output.
+ */
+declare function listPresets(presetsDir?: string): Preset[];
+/** Clear the in-memory cache (useful in tests). */
+declare function clearPresetCache(): void;
+
+/**
+ * token-replace — simple mustache-style `{{x.y}}` substitution.
+ *
+ * Resolves dotted paths against a flat or nested object.
+ * Unknown tokens are left as-is (no silent erasure).
+ *
+ * @example
+ * tokenReplace('Hello {{brand}}!', { brand: 'Nura Health' })
+ * // → 'Hello Nura Health!'
+ *
+ * tokenReplace('Color: {{palette.primary}}', { palette: { primary: '#2E4036' } })
+ * // → 'Color: #2E4036'
+ */
+declare function tokenReplace(content: string, data: Record<string, unknown>): string;
+
+export { type Preset, type ProjectSpec, ProjectSpecSchema, clearPresetCache, getPreset, listPresets, loadPresetRegistry, tokenReplace };

package/dist/index.js

@@ -0,0 +1,93 @@
+// src/spec-schema.ts
+import { z } from "zod";
+var ProjectSpecSchema = z.object({
+  /** Human-readable brand name. E.g. "Nura Health" */
+  brand: z.string().min(1),
+  /** One-line purpose statement. E.g. "Precision longevity medicine powered by biological data." */
+  purpose: z.string().min(1),
+  /** ID of the selected design preset. Must match a folder in presets/. */
+  presetId: z.string().min(1),
+  /** Three key value propositions — become Feature card copy. */
+  valueProps: z.tuple([z.string(), z.string(), z.string()]),
+  /** Primary call-to-action text. E.g. "Book a consultation" */
+  cta: z.string().min(1),
+  /** Free-text special requests / custom features. */
+  notes: z.string().default(""),
+  /** Stream B: paths to generated product documents (optional). */
+  prd: z.object({ path: z.string() }).optional(),
+  ux: z.object({ path: z.string() }).optional(),
+  mvp: z.object({ path: z.string() }).optional(),
+  /** Reference website URL provided by user (content context only, not design). */
+  referenceUrl: z.string().url().optional()
+});
+
+// src/presets.ts
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { join, resolve } from "path";
+import { fileURLToPath } from "url";
+var REPO_ROOT = resolve(fileURLToPath(import.meta.url), "..", "..", "..", "..");
+var _registry = null;
+function loadPresetRegistry(presetsDir) {
+  if (_registry !== null) return _registry;
+  const dir = presetsDir ?? join(REPO_ROOT, "presets");
+  _registry = /* @__PURE__ */ new Map();
+  if (!existsSync(dir)) {
+    return _registry;
+  }
+  const entries = readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const jsonPath = join(dir, entry.name, "preset.json");
+    if (!existsSync(jsonPath)) continue;
+    try {
+      const raw = readFileSync(jsonPath, "utf-8");
+      const preset = JSON.parse(raw);
+      _registry.set(preset.id, preset);
+    } catch {
+    }
+  }
+  return _registry;
+}
+function getPreset(id, presetsDir) {
+  return loadPresetRegistry(presetsDir).get(id);
+}
+function listPresets(presetsDir) {
+  return [...loadPresetRegistry(presetsDir).values()].sort(
+    (a, b) => a.id.localeCompare(b.id)
+  );
+}
+function clearPresetCache() {
+  _registry = null;
+}
+
+// src/token-replace.ts
+function tokenReplace(content, data) {
+  return content.replace(/\{\{([\w.\-]+)\}\}/g, (match, path) => {
+    const value = resolvePath(data, path);
+    if (value === void 0 || value === null) return match;
+    return String(value);
+  });
+}
+function resolvePath(obj, path) {
+  if (Object.prototype.hasOwnProperty.call(obj, path)) {
+    return obj[path];
+  }
+  const parts = path.split(".");
+  let current = obj;
+  for (const part of parts) {
+    if (current === null || current === void 0 || typeof current !== "object") {
+      return void 0;
+    }
+    current = current[part];
+  }
+  return current;
+}
+export {
+  ProjectSpecSchema,
+  clearPresetCache,
+  getPreset,
+  listPresets,
+  loadPresetRegistry,
+  tokenReplace
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/spec-schema.ts","../src/presets.ts","../src/token-replace.ts"],"sourcesContent":["import { z } from 'zod'\n\n/**\n * ProjectSpec — the single source of truth for a cinematic-web project.\n * Written to cinematic.json at the project root by `cinematic-web create` and `cinematic-web think`.\n */\nexport const ProjectSpecSchema = z.object({\n  /** Human-readable brand name. E.g. \"Nura Health\" */\n  brand: z.string().min(1),\n\n  /** One-line purpose statement. E.g. \"Precision longevity medicine powered by biological data.\" */\n  purpose: z.string().min(1),\n\n  /** ID of the selected design preset. Must match a folder in presets/. */\n  presetId: z.string().min(1),\n\n  /** Three key value propositions — become Feature card copy. */\n  valueProps: z.tuple([z.string(), z.string(), z.string()]),\n\n  /** Primary call-to-action text. E.g. \"Book a consultation\" */\n  cta: z.string().min(1),\n\n  /** Free-text special requests / custom features. */\n  notes: z.string().default(''),\n\n  /** Stream B: paths to generated product documents (optional). */\n  prd: z.object({ path: z.string() }).optional(),\n  ux: z.object({ path: z.string() }).optional(),\n  mvp: z.object({ path: z.string() }).optional(),\n\n  /** Reference website URL provided by user (content context only, not design). */\n  referenceUrl: z.string().url().optional(),\n})\n\nexport type ProjectSpec = z.infer<typeof ProjectSpecSchema>\n","import { readFileSync, readdirSync, existsSync } from 'node:fs'\nimport { join, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n// Resolve the monorepo root from the bundled dist file.\n// packages/core/dist/index.js → 4 levels up → repo root\nconst REPO_ROOT = resolve(fileURLToPath(import.meta.url), '..', '..', '..', '..')\n\n/**\n * A fully parsed preset.json — design tokens for one aesthetic direction.\n */\nexport interface Preset {\n  id: string\n  name: string\n  label: string\n  template: 'base-react' | 'three-fiber'\n  identity: string\n  palette: {\n    primary: string\n    accent: string\n    background: string\n    dark: string\n    primaryLabel: string\n    accentLabel: string\n    backgroundLabel: string\n    darkLabel: string\n  }\n  typography: {\n    heading: string[]\n    drama?: string\n    body?: string\n    data?: string\n    headingTracking?: string\n    dramaStyle?: string\n    microCopy?: string\n  }\n  googleFonts: string\n  imageMood: string\n  unsplashQuery: string\n  unsplashPhotoId?: string\n  heroLinePattern: {\n    part1: string\n    part1Style: string\n    part2: string\n    part2Style: string\n  }\n  dependencies?: Record<string, string>\n  promptFile?: string\n  notes?: string\n}\n\nlet _registry: Map<string, Preset> | null = null\n\n/**\n * Load all presets from the `presets/` directory.\n * Results are cached after the first call.\n */\nexport function loadPresetRegistry(presetsDir?: string): Map<string, Preset> {\n  if (_registry !== null) return _registry\n\n  const dir = presetsDir ?? join(REPO_ROOT, 'presets')\n  _registry = new Map()\n\n  if (!existsSync(dir)) {\n    return _registry\n  }\n\n  const entries = readdirSync(dir, { withFileTypes: true })\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue\n    const jsonPath = join(dir, entry.name, 'preset.json')\n    if (!existsSync(jsonPath)) continue\n\n    try {\n      const raw = readFileSync(jsonPath, 'utf-8')\n      const preset = JSON.parse(raw) as Preset\n      _registry.set(preset.id, preset)\n    } catch {\n      // Skip malformed preset.json silently — CLI will warn separately\n    }\n  }\n\n  return _registry\n}\n\n/**\n * Get a single preset by ID. Returns undefined if not found.\n */\nexport function getPreset(id: string, presetsDir?: string): Preset | undefined {\n  return loadPresetRegistry(presetsDir).get(id)\n}\n\n/**\n * Get all presets as an array, sorted by id for deterministic output.\n */\nexport function listPresets(presetsDir?: string): Preset[] {\n  return [...loadPresetRegistry(presetsDir).values()].sort((a, b) =>\n    a.id.localeCompare(b.id)\n  )\n}\n\n/** Clear the in-memory cache (useful in tests). */\nexport function clearPresetCache(): void {\n  _registry = null\n}\n","/**\n * token-replace — simple mustache-style `{{x.y}}` substitution.\n *\n * Resolves dotted paths against a flat or nested object.\n * Unknown tokens are left as-is (no silent erasure).\n *\n * @example\n * tokenReplace('Hello {{brand}}!', { brand: 'Nura Health' })\n * // → 'Hello Nura Health!'\n *\n * tokenReplace('Color: {{palette.primary}}', { palette: { primary: '#2E4036' } })\n * // → 'Color: #2E4036'\n */\nexport function tokenReplace(content: string, data: Record<string, unknown>): string {\n  return content.replace(/\\{\\{([\\w.\\-]+)\\}\\}/g, (match, path: string) => {\n    const value = resolvePath(data, path)\n    if (value === undefined || value === null) return match\n    return String(value)\n  })\n}\n\nfunction resolvePath(obj: Record<string, unknown>, path: string): unknown {\n  // Try the flat dotted key first (e.g. { 'palette.primary': '#2E4036' })\n  if (Object.prototype.hasOwnProperty.call(obj, path)) {\n    return obj[path]\n  }\n  // Fall back to nested traversal (e.g. { palette: { primary: '#2E4036' } })\n  const parts = path.split('.')\n  let current: unknown = obj\n  for (const part of parts) {\n    if (current === null || current === undefined || typeof current !== 'object') {\n      return undefined\n    }\n    current = (current as Record<string, unknown>)[part]\n  }\n  return current\n}\n"],"mappings":";AAAA,SAAS,SAAS;AAMX,IAAM,oBAAoB,EAAE,OAAO;AAAA;AAAA,EAExC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA;AAAA,EAGvB,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA;AAAA,EAGzB,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA;AAAA,EAG1B,YAAY,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC;AAAA;AAAA,EAGxD,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA;AAAA,EAGrB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;AAAA;AAAA,EAG5B,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS;AAAA,EAC7C,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS;AAAA,EAC5C,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS;AAAA;AAAA,EAG7C,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAC1C,CAAC;;;AChCD,SAAS,cAAc,aAAa,kBAAkB;AACtD,SAAS,MAAM,eAAe;AAC9B,SAAS,qBAAqB;AAI9B,IAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,GAAG,MAAM,MAAM,MAAM,IAAI;AA6ChF,IAAI,YAAwC;AAMrC,SAAS,mBAAmB,YAA0C;AAC3E,MAAI,cAAc,KAAM,QAAO;AAE/B,QAAM,MAAM,cAAc,KAAK,WAAW,SAAS;AACnD,cAAY,oBAAI,IAAI;AAEpB,MAAI,CAAC,WAAW,GAAG,GAAG;AACpB,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,YAAY,KAAK,EAAE,eAAe,KAAK,CAAC;AACxD,aAAW,SAAS,SAAS;AAC3B,QAAI,CAAC,MAAM,YAAY,EAAG;AAC1B,UAAM,WAAW,KAAK,KAAK,MAAM,MAAM,aAAa;AACpD,QAAI,CAAC,WAAW,QAAQ,EAAG;AAE3B,QAAI;AACF,YAAM,MAAM,aAAa,UAAU,OAAO;AAC1C,YAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,gBAAU,IAAI,OAAO,IAAI,MAAM;AAAA,IACjC,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,UAAU,IAAY,YAAyC;AAC7E,SAAO,mBAAmB,UAAU,EAAE,IAAI,EAAE;AAC9C;AAKO,SAAS,YAAY,YAA+B;AACzD,SAAO,CAAC,GAAG,mBAAmB,UAAU,EAAE,OAAO,CAAC,EAAE;AAAA,IAAK,CAAC,GAAG,MAC3D,EAAE,GAAG,cAAc,EAAE,EAAE;AAAA,EACzB;AACF;AAGO,SAAS,mBAAyB;AACvC,cAAY;AACd;;;AC3FO,SAAS,aAAa,SAAiB,MAAuC;AACnF,SAAO,QAAQ,QAAQ,uBAAuB,CAAC,OAAO,SAAiB;AACrE,UAAM,QAAQ,YAAY,MAAM,IAAI;AACpC,QAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,WAAO,OAAO,KAAK;AAAA,EACrB,CAAC;AACH;AAEA,SAAS,YAAY,KAA8B,MAAuB;AAExE,MAAI,OAAO,UAAU,eAAe,KAAK,KAAK,IAAI,GAAG;AACnD,WAAO,IAAI,IAAI;AAAA,EACjB;AAEA,QAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,MAAI,UAAmB;AACvB,aAAW,QAAQ,OAAO;AACxB,QAAI,YAAY,QAAQ,YAAY,UAAa,OAAO,YAAY,UAAU;AAC5E,aAAO;AAAA,IACT;AACA,cAAW,QAAoC,IAAI;AAAA,EACrD;AACA,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "cinematic-core",
+  "version": "0.1.0",
+  "description": "Shared core for cinematic-web: preset registry, project spec schema, token replacement",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit"
+  }
+}