@decantr/essence-spec 1.0.0-beta.9 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Decantr AI
+
+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/README.md

@@ -0,0 +1,58 @@
+# @decantr/essence-spec
+
+Support status: `core-supported`  
+Release channel: `stable`
+
+Schemas, validation, migration, guard evaluation, and TypeScript types for `decantr.essence.json`.
+
+## Install
+
+```bash
+npm install @decantr/essence-spec
+```
+
+## What It Exports
+
+- `validateEssence()` for schema validation
+- `evaluateGuard()` for contract/guard checks
+- `normalizeEssence()` for version normalization
+- `migrateV2ToV3()` and `migrateV30ToV31()` for structured migrations
+- Decantr essence TypeScript types
+
+## Example
+
+```ts
+import { evaluateGuard, validateEssence } from '@decantr/essence-spec';
+
+const result = validateEssence(essence);
+if (!result.valid) {
+  console.error(result.errors);
+}
+
+const violations = evaluateGuard(essence, {});
+```
+
+## Schema Exports
+
+- `@decantr/essence-spec/schema/essence.v2.json`
+- `@decantr/essence-spec/schema/essence.v3.json`
+
+## Compatibility
+
+`@decantr/essence-spec` now defines a stable public contract for Decantr essence validation and migration in the `1.x` line.
+
+- additive schema fields may be introduced in compatible minor releases
+- breaking schema or migration behavior changes require a major version
+- deprecation and migration guidance should be documented before removing or replacing a supported essence path
+
+## Stability Note
+
+This package is the lowest-level public Decantr contract and is intended to remain boring and dependable for downstream consumers.
+
+- patch releases should stay documentation-only or behaviorally compatible
+- schema export paths are part of the supported public surface
+- coordinated downstream releases should only be needed when a package explicitly adopts a newer essence-spec version
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -11,13 +11,12 @@ type ThemeStyle = 'auradecantism' | 'clean' | 'glassmorphism' | 'retro' | 'biolu
 type ThemeMode = 'light' | 'dark' | 'auto';
 type ThemeShape = 'sharp' | 'rounded' | 'pill';
 interface Theme {
-    style: ThemeStyle | string;
+    id: string;
     mode: ThemeMode;
-    recipe: string;
     shape?: ThemeShape;
 }
 type PlatformType = 'spa' | 'ssr' | 'static';
-type RoutingStrategy = 'hash' | 'history';
+type RoutingStrategy = 'hash' | 'history' | 'pathname';
 interface Platform {
     type: PlatformType;
     routing: RoutingStrategy;
@@ -58,11 +57,25 @@ interface SpatialTokens {
     '--d-data-py': string;
     '--d-control-py': string;
     '--d-content-gap': string;
+    '--d-label-mb': string;
+    '--d-label-px': string;
+    '--d-section-gap': string;
+    '--d-annotation-mt': string;
+}
+interface SpatialTokenHints {
+    section_padding?: string | null;
+    density_bias?: number;
+    content_gap_shift?: number;
+    label_content_gap?: string | null;
+}
+interface ShellGuidance {
+    section_label_treatment?: string;
+    section_density?: DensityLevel;
+    [key: string]: string | DensityLevel | undefined;
 }
 type GuardMode = 'creative' | 'guided' | 'strict';
 interface Guard {
     enforce_style?: boolean;
-    enforce_recipe?: boolean;
     mode: GuardMode;
 }
 interface Impression {
@@ -163,7 +176,7 @@ interface EssenceDNA {
         effects?: Record<string, string>;
     };
 }
-/** Only density and mode may be overridden per-page. DNA axioms like wcag_level and theme.style are never overrideable. */
+/** Only density and mode may be overridden per-page. DNA axioms like wcag_level and theme.id are never overrideable. */
 interface DNAOverrides {
     density?: DensityLevel;
     mode?: ThemeMode;
@@ -245,24 +258,19 @@ interface ValidationResult {
 }
 declare function validateEssence(data: unknown): ValidationResult;
 
-interface RecipeSpatialHints {
-    density_bias?: number;
-    content_gap_shift?: number;
-}
-declare function computeDensity(personality: string[], recipeSpatial?: RecipeSpatialHints): Density;
-interface SpatialRecipeHints {
-    section_padding?: string | null;
+interface SpatialHints {
     density_bias?: number;
     content_gap_shift?: number;
 }
-declare function computeSpatialTokens(density: DensityLevel, recipeHints?: SpatialRecipeHints): SpatialTokens;
+declare function computeDensity(personality: string[], spatialHints?: SpatialHints): Density;
+declare function computeSpatialTokens(density: DensityLevel, spatialHints?: SpatialTokenHints): SpatialTokens;
 
 interface AutoFix {
     type: 'add_page' | 'update_layout' | 'update_blueprint';
     patch: Record<string, unknown>;
 }
 interface GuardViolation {
-    rule: 'style' | 'structure' | 'layout' | 'recipe' | 'density' | 'theme-mode' | 'pattern-exists' | 'accessibility';
+    rule: 'theme' | 'structure' | 'layout' | 'density' | 'theme-mode' | 'pattern-exists' | 'accessibility';
     severity: 'error' | 'warning';
     message: string;
     suggestion?: string;
@@ -272,8 +280,9 @@ interface GuardViolation {
 }
 interface GuardContext {
     pageId?: string;
+    theme?: string;
+    /** @deprecated Use `theme` instead. */
     style?: string;
-    recipe?: string;
     layout?: string[];
     density_gap?: string;
     themeRegistry?: Map<string, {
@@ -297,4 +306,4 @@ declare function migrateV2ToV3(essence: EssenceFile): EssenceV3;
  */
 declare function migrateV30ToV31(essence: EssenceV3): EssenceV3;
 
-export { type Accessibility, type ArchetypeRole, type AutoFix, type BlueprintPage, type ColumnLayout, type CvdPreference, type DNAOverrides, type Density, type DensityLevel, type Essence, type EssenceBlueprint, type EssenceDNA, type EssenceFile, type EssenceMeta, type EssenceSection, type EssenceV3, type EssenceV31Section, type EssenceV3Guard, type GeneratorTarget, type Guard, type GuardContext, type GuardMode, type GuardViolation, type Impression, type LayoutItem, type PatternRef, type Platform, type PlatformType, type RouteEntry, type RoutingStrategy, type SectionedEssence, type ShellType, type SpatialTokens, type StructurePage, type Theme, type ThemeMode, type ThemeShape, type ThemeStyle, type ValidationResult, type WcagLevel, computeDensity, computeSpatialTokens, evaluateGuard, flattenPages, isSectioned, isSimple, isV3, migrateV2ToV3, migrateV30ToV31, normalizeEssence, validateEssence };
+export { type Accessibility, type ArchetypeRole, type AutoFix, type BlueprintPage, type ColumnLayout, type CvdPreference, type DNAOverrides, type Density, type DensityLevel, type Essence, type EssenceBlueprint, type EssenceDNA, type EssenceFile, type EssenceMeta, type EssenceSection, type EssenceV3, type EssenceV31Section, type EssenceV3Guard, type GeneratorTarget, type Guard, type GuardContext, type GuardMode, type GuardViolation, type Impression, type LayoutItem, type PatternRef, type Platform, type PlatformType, type RouteEntry, type RoutingStrategy, type SectionedEssence, type ShellGuidance, type ShellType, type SpatialTokenHints, type SpatialTokens, type StructurePage, type Theme, type ThemeMode, type ThemeShape, type ThemeStyle, type ValidationResult, type WcagLevel, computeDensity, computeSpatialTokens, evaluateGuard, flattenPages, isSectioned, isSimple, isV3, migrateV2ToV3, migrateV30ToV31, normalizeEssence, validateEssence };

package/dist/index.js

@@ -50,7 +50,8 @@ function getValidator(version) {
 }
 function detectVersion(data) {
   if (typeof data === "object" && data !== null && "version" in data) {
-    if (data.version === "3.0.0") return "v3";
+    const v = data.version;
+    if (v === "3.0.0" || v === "3.1.0") return "v3";
   }
   return "v2";
 }
@@ -85,7 +86,7 @@ var MAX_GAP = 10;
 function clamp(value, min, max) {
   return Math.max(min, Math.min(max, value));
 }
-function computeDensity(personality, recipeSpatial) {
+function computeDensity(personality, spatialHints) {
   const lower = personality.map((c) => c.toLowerCase());
   let level = "comfortable";
   let gap = 4;
@@ -96,11 +97,11 @@ function computeDensity(personality, recipeSpatial) {
       break;
     }
   }
-  if (recipeSpatial?.density_bias) {
-    gap += recipeSpatial.density_bias;
+  if (spatialHints?.density_bias) {
+    gap += spatialHints.density_bias;
   }
-  if (recipeSpatial?.content_gap_shift) {
-    gap += recipeSpatial.content_gap_shift;
+  if (spatialHints?.content_gap_shift) {
+    gap += spatialHints.content_gap_shift;
   }
   gap = clamp(gap, MIN_GAP, MAX_GAP);
   if (gap <= 3) level = "compact";
@@ -120,7 +121,11 @@ var BASE_TOKENS = {
   "--d-surface-p": 1.25,
   "--d-data-py": 0.625,
   "--d-control-py": 0.5,
-  "--d-content-gap": 1
+  "--d-content-gap": 1,
+  "--d-label-mb": 0.75,
+  "--d-label-px": 0.75,
+  "--d-section-gap": 1.5,
+  "--d-annotation-mt": 0.5
 };
 function roundTo3(value) {
   return Math.round(value * 1e3) / 1e3;
@@ -129,23 +134,41 @@ function toRemString(value) {
   const rounded = roundTo3(value);
   return `${rounded}rem`;
 }
-function computeSpatialTokens(density, recipeHints) {
+function computeSpatialTokens(density, spatialHints) {
   const scale = DENSITY_SCALES[density];
-  const biasMultiplier = 1 + (recipeHints?.density_bias ?? 0) / 10;
+  const biasMultiplier = 1 + (spatialHints?.density_bias ?? 0) / 10;
   const result = {};
   for (const [key, base] of Object.entries(BASE_TOKENS)) {
     const tokenKey = key;
-    if (tokenKey === "--d-section-py" && recipeHints?.section_padding) {
-      const pxMatch = recipeHints.section_padding.match(/^(\d+(?:\.\d+)?)px$/);
+    if (tokenKey === "--d-label-px") {
+      result[tokenKey] = toRemString(base);
+      continue;
+    }
+    if (tokenKey === "--d-section-py" && spatialHints?.section_padding) {
+      const pxMatch = spatialHints.section_padding.match(/^(\d+(?:\.\d+)?)px$/);
       if (pxMatch) {
         const remValue = parseFloat(pxMatch[1]) / 16;
         result[tokenKey] = toRemString(remValue * scale * biasMultiplier);
         continue;
       }
+      const remMatch = spatialHints.section_padding.match(/^(\d+(?:\.\d+)?)rem$/);
+      if (remMatch) {
+        const remValue = parseFloat(remMatch[1]);
+        result[tokenKey] = toRemString(remValue * scale * biasMultiplier);
+        continue;
+      }
+    }
+    if (tokenKey === "--d-label-mb" && spatialHints?.label_content_gap) {
+      const remMatch = spatialHints.label_content_gap.match(/^(\d+(?:\.\d+)?)rem$/);
+      if (remMatch) {
+        const remValue = parseFloat(remMatch[1]);
+        result[tokenKey] = toRemString(remValue * scale * biasMultiplier);
+        continue;
+      }
     }
     let computed = base * scale * biasMultiplier;
-    if (tokenKey === "--d-content-gap" && recipeHints?.content_gap_shift) {
-      computed += recipeHints.content_gap_shift * 0.25;
+    if (tokenKey === "--d-content-gap" && spatialHints?.content_gap_shift) {
+      computed += spatialHints.content_gap_shift * 0.25;
     }
     result[tokenKey] = toRemString(computed);
   }
@@ -158,10 +181,10 @@ function checkThemeModeCompatibility(essence, context) {
   let themeId;
   let mode;
   if (isV3(essence)) {
-    themeId = essence.dna.theme?.style ?? null;
+    themeId = essence.dna.theme?.id ?? null;
     mode = essence.dna.theme?.mode ?? null;
   } else {
-    themeId = isSimple(essence) ? essence.theme?.style : null;
+    themeId = isSimple(essence) ? essence.theme?.id : null;
     mode = isSimple(essence) ? essence.theme?.mode : null;
   }
   if (!themeId || !mode) return null;
@@ -261,19 +284,20 @@ function evaluateGuard(essence, context = {}) {
   }
   const violations = [];
   const isStrict = guard.mode === "strict";
-  if (context.style) {
-    let essenceStyle;
+  const requestedTheme = context.theme ?? context.style;
+  if (requestedTheme) {
+    let essenceThemeId;
     if (isV3(essence)) {
-      essenceStyle = essence.dna.theme.style;
+      essenceThemeId = essence.dna.theme.id;
     } else {
-      essenceStyle = isSimple(essence) ? essence.theme.style : null;
+      essenceThemeId = isSimple(essence) ? essence.theme.id : null;
     }
     const enforceStyle = isV3(essence) ? true : guard.enforce_style !== false;
-    if (essenceStyle && context.style !== essenceStyle && enforceStyle) {
+    if (essenceThemeId && requestedTheme !== essenceThemeId && enforceStyle) {
       violations.push({
-        rule: "style",
+        rule: "theme",
         severity: "error",
-        message: `Style "${context.style}" does not match essence theme "${essenceStyle}". Change the essence theme first.`,
+        message: `Theme "${requestedTheme}" does not match essence theme "${essenceThemeId}". Change the essence theme first.`,
         ...isV3(essence) ? { layer: "dna", autoFixable: false } : {}
       });
     }
@@ -317,25 +341,6 @@ function evaluateGuard(essence, context = {}) {
       }
     }
   }
-  if (context.recipe) {
-    let essenceRecipe;
-    let enforceRecipe;
-    if (isV3(essence)) {
-      essenceRecipe = essence.dna.theme.recipe;
-      enforceRecipe = true;
-    } else {
-      essenceRecipe = isSimple(essence) ? essence.theme.recipe : null;
-      enforceRecipe = guard.enforce_recipe !== false;
-    }
-    if (essenceRecipe && context.recipe !== essenceRecipe && enforceRecipe) {
-      violations.push({
-        rule: "recipe",
-        severity: "error",
-        message: `Recipe "${context.recipe}" does not match essence recipe "${essenceRecipe}".`,
-        ...isV3(essence) ? { layer: "dna", autoFixable: false } : {}
-      });
-    }
-  }
   if (isStrict && context.density_gap) {
     let expectedGap;
     if (isV3(essence)) {
@@ -410,7 +415,7 @@ function getPageDensityOverride(essence, pageId) {
 
 // src/normalize.ts
 function normalizeEssence(input) {
-  if (input.version === "3.0.0") {
+  if (input.version === "3.0.0" || input.version === "3.1.0") {
     return input;
   }
   if (input.theme && input.platform) {
@@ -431,9 +436,8 @@ function normalizeSimple(v1) {
     version: "2.0.0",
     archetype: v1.terroir ?? v1.vignette ?? v1.archetype,
     theme: {
-      style: vintage?.style ?? "",
+      id: vintage?.style ?? "",
       mode: vintage?.mode ?? "dark",
-      recipe: vintage?.recipe ?? "",
       ...vintage?.shape ? { shape: vintage.shape } : {}
     },
     // Accept both old 'character' and new 'personality' field names
@@ -471,9 +475,8 @@ function normalizeSectioned(v1) {
       path: section.path,
       archetype: section.terroir ?? section.vignette ?? section.archetype,
       theme: {
-        style: section.vintage?.style ?? "",
-        mode: section.vintage?.mode ?? "dark",
-        recipe: section.vintage?.recipe ?? ""
+        id: section.vintage?.style ?? "",
+        mode: section.vintage?.mode ?? "dark"
       },
       structure: (section.structure ?? []).map(normalizeStructurePage),
       ...section.tannins ? { features: section.tannins } : {}
@@ -505,7 +508,6 @@ function normalizeGuard(cork) {
   };
   return {
     ...cork.enforce_style !== void 0 ? { enforce_style: cork.enforce_style } : {},
-    ...cork.enforce_recipe !== void 0 ? { enforce_recipe: cork.enforce_recipe } : {},
     mode: modeMap[cork.mode ?? "creative"] ?? "creative"
   };
 }
@@ -583,9 +585,8 @@ function buildDNA(essence) {
   const radiusBase = inferRadiusBase(shape);
   return {
     theme: {
-      style: essence.theme.style,
+      id: essence.theme.id,
       mode: essence.theme.mode,
-      recipe: essence.theme.recipe,
       ...essence.theme.shape ? { shape: essence.theme.shape } : {}
     },
     spacing: {
@@ -678,7 +679,7 @@ function migrateV30ToV31(essence) {
     role: "primary",
     shell: essence.blueprint.shell ?? "top-nav-main",
     features: essence.blueprint.features,
-    description: "",
+    description: `${essence.meta.archetype} primary section`,
     pages: essence.blueprint.pages ?? []
   };
   return {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/validate.ts","../src/density.ts","../src/guard.ts","../src/normalize.ts","../src/migrate.ts"],"sourcesContent":["/**\n * Essence v2 schema types — normalized terminology.\n *\n * Terminology mapping (v1 wine terms → v2 normalized):\n *   terroir → archetype, vintage → theme, tannins → features,\n *   carafe → shell, cork → guard, blend → layout, clarity → density,\n *   vessel → platform, character → personality,\n *   decantation process → essence pipeline\n */\n\n// --- Theme ---\n\nexport type ThemeStyle =\n  | 'auradecantism'\n  | 'clean'\n  | 'glassmorphism'\n  | 'retro'\n  | 'bioluminescent'\n  | 'launchpad'\n  | 'dopamine'\n  | 'editorial'\n  | 'liquid-glass'\n  | 'prismatic';\n\nexport type ThemeMode = 'light' | 'dark' | 'auto';\nexport type ThemeShape = 'sharp' | 'rounded' | 'pill';\n\nexport interface Theme {\n  style: ThemeStyle | string;\n  mode: ThemeMode;\n  recipe: string;\n  shape?: ThemeShape;\n}\n\n// --- Platform ---\n\nexport type PlatformType = 'spa' | 'ssr' | 'static';\nexport type RoutingStrategy = 'hash' | 'history';\n\nexport interface Platform {\n  type: PlatformType;\n  routing: RoutingStrategy;\n}\n\n// --- Structure ---\n\nexport type ShellType =\n  | 'sidebar-main'\n  | 'top-nav-main'\n  | 'full-bleed'\n  | 'dashboard'\n  | 'stacked'\n  | string;\n\nexport type LayoutItem = string | PatternRef | ColumnLayout;\n\nexport interface PatternRef {\n  pattern: string;\n  preset?: string;\n  as?: string;\n}\n\nexport interface ColumnLayout {\n  cols: string[];\n  at?: 'sm' | 'md' | 'lg' | 'xl' | '2xl';\n  span?: Record<string, number>;\n  // AUTO: Multi-breakpoint grid — array of { at, cols } entries for cascading breakpoints\n  breakpoints?: { at: string; cols: number }[];\n  // AUTO: \"container\" uses container queries instead of viewport breakpoints\n  responsive?: 'viewport' | 'container';\n}\n\nexport interface StructurePage {\n  id: string;\n  shell: ShellType;\n  layout: LayoutItem[];\n  surface?: string;\n}\n\n// --- Density ---\n\nexport type DensityLevel = 'compact' | 'comfortable' | 'spacious';\n\nexport interface Density {\n  level: DensityLevel;\n  content_gap: string;\n}\n\nexport interface SpatialTokens {\n  '--d-section-py': string;\n  '--d-interactive-py': string;\n  '--d-interactive-px': string;\n  '--d-surface-p': string;\n  '--d-data-py': string;\n  '--d-control-py': string;\n  '--d-content-gap': string;\n}\n\n// --- Guard ---\n\nexport type GuardMode = 'creative' | 'guided' | 'strict';\n\nexport interface Guard {\n  enforce_style?: boolean;\n  enforce_recipe?: boolean;\n  mode: GuardMode;\n}\n\n// --- Impression ---\n\nexport interface Impression {\n  vibe: string[];\n  references: string[];\n  density_intent: DensityLevel | string;\n  layout_intent: ShellType | string;\n  novel_elements: string[];\n}\n\n// --- Generator Target ---\n\nexport type GeneratorTarget = 'decantr' | 'react' | 'vue' | 'svelte' | string;\n\n// --- Accessibility ---\n\nexport type WcagLevel = 'none' | 'A' | 'AA' | 'AAA';\n\nexport type CvdPreference =\n  | 'none'\n  | 'auto'\n  | 'deuteranopia'\n  | 'protanopia'\n  | 'tritanopia'\n  | 'achromatopsia';\n\nexport interface Accessibility {\n  wcag_level?: WcagLevel;\n  cvd_preference?: CvdPreference;\n}\n\n// --- Essence (simple) ---\n\nexport interface Essence {\n  $schema?: string;\n  version: string;\n  archetype: string;\n  theme: Theme;\n  personality: string[];\n  platform: Platform;\n  structure: StructurePage[];\n  features: string[];\n  density: Density;\n  guard: Guard;\n  target: GeneratorTarget;\n  accessibility?: Accessibility;\n  _impression?: Impression;\n}\n\n// --- Essence (sectioned) ---\n\nexport interface EssenceSection {\n  id: string;\n  path: string;\n  archetype: string;\n  theme: Theme;\n  structure: StructurePage[];\n  features?: string[];\n}\n\nexport interface SectionedEssence {\n  $schema?: string;\n  version: string;\n  platform: Platform;\n  personality: string[];\n  sections: EssenceSection[];\n  shared_features?: string[];\n  density: Density;\n  guard: Guard;\n  target: GeneratorTarget;\n  accessibility?: Accessibility;\n  _impression?: Impression;\n}\n\n// --- Essence v3: DNA/Blueprint/Meta split ---\n\nexport interface EssenceDNA {\n  theme: Theme;\n  spacing: {\n    base_unit: number;\n    scale: string;\n    density: DensityLevel;\n    content_gap: string;\n  };\n  typography: {\n    scale: string;\n    heading_weight: number;\n    body_weight: number;\n  };\n  color: {\n    palette: string;\n    accent_count: number;\n    cvd_preference: CvdPreference | string;\n  };\n  radius: {\n    philosophy: ThemeShape | string;\n    base: number;\n  };\n  elevation: {\n    system: string;\n    max_levels: number;\n  };\n  motion: {\n    preference: string;\n    duration_scale: number;\n    reduce_motion: boolean;\n    timing?: string;\n    durations?: Record<string, string>;\n  };\n  accessibility: {\n    wcag_level: WcagLevel;\n    focus_visible: boolean;\n    skip_nav: boolean;\n  };\n  personality: string[];\n  constraints?: {\n    mode?: string;\n    typography?: string;\n    borders?: string;\n    corners?: string;\n    shadows?: string;\n    effects?: Record<string, string>;\n  };\n}\n\n/** Only density and mode may be overridden per-page. DNA axioms like wcag_level and theme.style are never overrideable. */\nexport interface DNAOverrides {\n  density?: DensityLevel;\n  mode?: ThemeMode;\n}\n\nexport interface BlueprintPage {\n  id: string;\n  route?: string;\n  shell_override?: ShellType | null;\n  layout: LayoutItem[];\n  patterns?: PatternRef[];\n  dna_overrides?: DNAOverrides;\n  surface?: string;\n}\n\nexport type ArchetypeRole = 'primary' | 'gateway' | 'public' | 'auxiliary';\n\nexport interface EssenceV31Section {\n  id: string;\n  role: ArchetypeRole;\n  shell: ShellType | string;\n  features: string[];\n  description: string;\n  pages: BlueprintPage[];\n  dna_overrides?: DNAOverrides;\n}\n\nexport interface RouteEntry {\n  section: string;\n  page: string;\n}\n\nexport interface EssenceBlueprint {\n  shell?: ShellType | string;\n  sections?: EssenceV31Section[];\n  pages?: BlueprintPage[];\n  features: string[];\n  routes?: Record<string, RouteEntry>;\n  icon_style?: string;\n  avatar_style?: string;\n}\n\nexport interface EssenceV3Guard {\n  mode: GuardMode;\n  dna_enforcement: 'error' | 'warn' | 'off';\n  blueprint_enforcement: 'warn' | 'off';\n}\n\nexport interface EssenceMeta {\n  archetype: string;\n  target: GeneratorTarget;\n  platform: Platform;\n  guard: EssenceV3Guard;\n  seo?: {\n    schema_org?: string[];\n    meta_priorities?: string[];\n  };\n  navigation?: {\n    hotkeys?: Array<{ key: string; route?: string; action?: string; label: string }>;\n    command_palette?: boolean;\n  };\n}\n\nexport interface EssenceV3 {\n  $schema?: string;\n  version: '3.0.0' | '3.1.0';\n  dna: EssenceDNA;\n  blueprint: EssenceBlueprint;\n  meta: EssenceMeta;\n  _impression?: Impression;\n}\n\n// --- Discriminated union ---\n\nexport type EssenceFile = Essence | SectionedEssence | EssenceV3;\n\nexport function isV3(essence: EssenceFile): essence is EssenceV3 {\n  return (essence.version === '3.0.0' || essence.version === '3.1.0') && 'dna' in essence && 'blueprint' in essence;\n}\n\n/** Flatten sections into a flat page list (for guards and backward compat). */\nexport function flattenPages(blueprint: EssenceBlueprint): BlueprintPage[] {\n  if (blueprint.sections && blueprint.sections.length > 0) {\n    return blueprint.sections.flatMap(s =>\n      s.pages.map(p => ({\n        ...p,\n        shell_override: p.shell_override ?? (s.shell !== blueprint.shell ? (s.shell as ShellType) : undefined),\n      }))\n    );\n  }\n  return blueprint.pages ?? [];\n}\n\nexport function isSectioned(essence: EssenceFile): essence is SectionedEssence {\n  if (isV3(essence)) return false;\n  return 'sections' in essence && Array.isArray((essence as SectionedEssence).sections);\n}\n\nexport function isSimple(essence: EssenceFile): essence is Essence {\n  if (isV3(essence)) return false;\n  return 'archetype' in essence && !('sections' in essence);\n}\n","import Ajv from 'ajv';\nimport { readFileSync, existsSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst v2SchemaPath = join(__dirname, '..', 'schema', 'essence.v2.json');\nconst v3SchemaPath = join(__dirname, '..', 'schema', 'essence.v3.json');\n\nlet cachedAjv: Ajv | null = null;\nconst validatorCache = new Map<string, ReturnType<Ajv['compile']>>();\n\nfunction getAjv(): Ajv {\n  if (!cachedAjv) {\n    cachedAjv = new Ajv({ allErrors: true, strict: false, validateSchema: false });\n  }\n  return cachedAjv;\n}\n\nfunction getValidator(version: 'v2' | 'v3'): ReturnType<Ajv['compile']> | null {\n  if (validatorCache.has(version)) return validatorCache.get(version)!;\n\n  const schemaPath = version === 'v3' ? v3SchemaPath : v2SchemaPath;\n  if (!existsSync(schemaPath)) return null;\n\n  const schema = JSON.parse(readFileSync(schemaPath, 'utf-8'));\n  const ajv = getAjv();\n  const validate = ajv.compile(schema);\n  validatorCache.set(version, validate);\n  return validate;\n}\n\nfunction detectVersion(data: unknown): 'v2' | 'v3' {\n  if (typeof data === 'object' && data !== null && 'version' in data) {\n    if ((data as Record<string, unknown>).version === '3.0.0') return 'v3';\n  }\n  return 'v2';\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\nexport function validateEssence(data: unknown): ValidationResult {\n  const version = detectVersion(data);\n  const validate = getValidator(version);\n\n  if (!validate) {\n    return { valid: false, errors: [`No schema available for ${version} documents`] };\n  }\n\n  const valid = validate(data);\n\n  if (valid) {\n    return { valid: true, errors: [] };\n  }\n\n  const errors = (validate.errors ?? []).map((err) => {\n    const path = err.instancePath || '/';\n    const msg = err.message ?? 'unknown error';\n    return `${path}: ${msg}`;\n  });\n\n  return { valid: false, errors };\n}\n","import type { Density, DensityLevel, SpatialTokens } from './types.js';\n\ninterface RecipeSpatialHints {\n  density_bias?: number;\n  content_gap_shift?: number;\n}\n\ninterface DensityRule {\n  traits: string[];\n  level: DensityLevel;\n  gap: number;\n}\n\nconst RULES: DensityRule[] = [\n  { traits: ['tactical', 'dense', 'data-dense', 'utilitarian'], level: 'compact', gap: 3 },\n  { traits: ['luxurious', 'premium', 'editorial'], level: 'spacious', gap: 8 },\n  { traits: ['playful', 'bouncy', 'expressive'], level: 'comfortable', gap: 5 },\n  { traits: ['minimal', 'clean', 'airy'], level: 'spacious', gap: 6 },\n  { traits: ['professional', 'modern', 'balanced'], level: 'comfortable', gap: 4 },\n];\n\nconst MIN_GAP = 2;\nconst MAX_GAP = 10;\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.max(min, Math.min(max, value));\n}\n\nexport function computeDensity(\n  personality: string[],\n  recipeSpatial?: RecipeSpatialHints,\n): Density {\n  const lower = personality.map(c => c.toLowerCase());\n\n  let level: DensityLevel = 'comfortable';\n  let gap = 4;\n\n  for (const rule of RULES) {\n    if (rule.traits.some(t => lower.includes(t))) {\n      level = rule.level;\n      gap = rule.gap;\n      break;\n    }\n  }\n\n  if (recipeSpatial?.density_bias) {\n    gap += recipeSpatial.density_bias;\n  }\n  if (recipeSpatial?.content_gap_shift) {\n    gap += recipeSpatial.content_gap_shift;\n  }\n\n  gap = clamp(gap, MIN_GAP, MAX_GAP);\n\n  if (gap <= 3) level = 'compact';\n  else if (gap >= 6) level = 'spacious';\n  else level = 'comfortable';\n\n  return { level, content_gap: String(gap) };\n}\n\n// --- Spatial Tokens ---\n\ninterface SpatialRecipeHints {\n  section_padding?: string | null;\n  density_bias?: number;\n  content_gap_shift?: number;\n}\n\nconst DENSITY_SCALES: Record<DensityLevel, number> = {\n  compact: 0.65,\n  comfortable: 1.0,\n  spacious: 1.4,\n};\n\nconst BASE_TOKENS = {\n  '--d-section-py': 5,\n  '--d-interactive-py': 0.5,\n  '--d-interactive-px': 1,\n  '--d-surface-p': 1.25,\n  '--d-data-py': 0.625,\n  '--d-control-py': 0.5,\n  '--d-content-gap': 1,\n} as const;\n\nfunction roundTo3(value: number): number {\n  return Math.round(value * 1000) / 1000;\n}\n\nfunction toRemString(value: number): string {\n  const rounded = roundTo3(value);\n  return `${rounded}rem`;\n}\n\nexport function computeSpatialTokens(\n  density: DensityLevel,\n  recipeHints?: SpatialRecipeHints,\n): SpatialTokens {\n  const scale = DENSITY_SCALES[density];\n  const biasMultiplier = 1 + (recipeHints?.density_bias ?? 0) / 10;\n\n  const result = {} as SpatialTokens;\n\n  for (const [key, base] of Object.entries(BASE_TOKENS)) {\n    const tokenKey = key as keyof SpatialTokens;\n\n    if (tokenKey === '--d-section-py' && recipeHints?.section_padding) {\n      const pxMatch = recipeHints.section_padding.match(/^(\\d+(?:\\.\\d+)?)px$/);\n      if (pxMatch) {\n        const remValue = parseFloat(pxMatch[1]) / 16;\n        result[tokenKey] = toRemString(remValue * scale * biasMultiplier);\n        continue;\n      }\n    }\n\n    let computed = base * scale * biasMultiplier;\n\n    if (tokenKey === '--d-content-gap' && recipeHints?.content_gap_shift) {\n      computed += recipeHints.content_gap_shift * 0.25;\n    }\n\n    result[tokenKey] = toRemString(computed);\n  }\n\n  return result;\n}\n","import type { EssenceFile, EssenceV3, EssenceV3Guard, StructurePage, LayoutItem, DensityLevel } from './types.js';\nimport { isSimple, isSectioned, isV3, flattenPages } from './types.js';\n\nexport interface AutoFix {\n  type: 'add_page' | 'update_layout' | 'update_blueprint';\n  patch: Record<string, unknown>;\n}\n\nexport interface GuardViolation {\n  rule: 'style' | 'structure' | 'layout' | 'recipe' | 'density' | 'theme-mode' | 'pattern-exists' | 'accessibility';\n  severity: 'error' | 'warning';\n  message: string;\n  suggestion?: string;\n  layer?: 'dna' | 'blueprint';\n  autoFixable?: boolean;\n  autoFix?: AutoFix;\n}\n\nexport interface GuardContext {\n  pageId?: string;\n  style?: string;\n  recipe?: string;\n  layout?: string[];\n  density_gap?: string;\n  themeRegistry?: Map<string, { modes: string[] }>;\n  patternRegistry?: Map<string, unknown>;\n  a11y_issues?: string[];\n}\n\n/**\n * Check if the theme supports the specified mode.\n */\nfunction checkThemeModeCompatibility(\n  essence: EssenceFile,\n  context: GuardContext\n): GuardViolation | null {\n  if (!context.themeRegistry) return null;\n\n  let themeId: string | null;\n  let mode: string | null;\n  if (isV3(essence)) {\n    themeId = essence.dna.theme?.style ?? null;\n    mode = essence.dna.theme?.mode ?? null;\n  } else {\n    themeId = isSimple(essence) ? essence.theme?.style : null;\n    mode = isSimple(essence) ? essence.theme?.mode : null;\n  }\n\n  if (!themeId || !mode) return null;\n\n  const theme = context.themeRegistry.get(themeId);\n  if (!theme) {\n    // Theme not found - separate validation\n    return null;\n  }\n\n  if (!theme.modes.includes(mode) && mode !== 'auto') {\n    const supportedModes = theme.modes.join(', ');\n    const suggestion = theme.modes.length > 0\n      ? `Use mode: \"${theme.modes[0]}\" instead, or choose a theme that supports ${mode} mode.`\n      : undefined;\n\n    return {\n      rule: 'theme-mode',\n      severity: 'error',\n      message: `Theme \"${themeId}\" does not support \"${mode}\" mode. Supported modes: ${supportedModes}.`,\n      suggestion,\n      ...(isV3(essence) ? { layer: 'dna' as const, autoFixable: false } : {}),\n    };\n  }\n\n  return null;\n}\n\n/**\n * Collect all pattern IDs from a layout item, recursively handling nested structures.\n */\nfunction collectPatternIds(item: LayoutItem, ids: Set<string>): void {\n  if (typeof item === 'string') {\n    ids.add(item);\n    return;\n  }\n  if (typeof item === 'object' && item !== null) {\n    if ('pattern' in item && typeof item.pattern === 'string') {\n      ids.add(item.pattern);\n    }\n    if ('cols' in item && Array.isArray(item.cols)) {\n      for (const col of item.cols) {\n        // cols contains strings (pattern IDs)\n        if (typeof col === 'string') {\n          ids.add(col);\n        }\n      }\n    }\n  }\n}\n\n/**\n * Find similar pattern IDs in the registry for suggestion.\n */\nfunction findSimilarPatterns(target: string, registry: Map<string, unknown>): string[] {\n  const similar: string[] = [];\n  const targetLower = target.toLowerCase();\n\n  for (const id of registry.keys()) {\n    const idLower = id.toLowerCase();\n    // Simple similarity: contains target or target contains id\n    if (idLower.includes(targetLower) || targetLower.includes(idLower)) {\n      similar.push(id);\n    }\n  }\n\n  return similar.slice(0, 3); // Top 3 suggestions\n}\n\n/**\n * Check if all referenced patterns exist in the registry.\n */\nfunction checkPatternExistence(\n  essence: EssenceFile,\n  context: GuardContext\n): GuardViolation[] {\n  if (!context.patternRegistry) return [];\n\n  const violations: GuardViolation[] = [];\n  const referencedPatterns = new Set<string>();\n\n  // Collect all pattern references from structure\n  const pages = getAllPages(essence);\n  for (const page of pages) {\n    for (const item of page.layout || []) {\n      collectPatternIds(item, referencedPatterns);\n    }\n  }\n\n  // Check each pattern exists\n  for (const patternId of referencedPatterns) {\n    if (!context.patternRegistry.has(patternId)) {\n      // Find similar patterns for suggestion\n      const similar = findSimilarPatterns(patternId, context.patternRegistry);\n      const suggestion = similar.length > 0\n        ? `Similar patterns: ${similar.join(', ')}`\n        : `Run \"decantr search ${patternId}\" to find alternatives.`;\n\n      violations.push({\n        rule: 'pattern-exists',\n        severity: isV3(essence) ? 'warning' : 'error',\n        message: `Pattern \"${patternId}\" is referenced but does not exist in the registry.`,\n        suggestion,\n        ...(isV3(essence) ? { layer: 'blueprint' as const, autoFixable: false } : {}),\n      });\n    }\n  }\n\n  return violations;\n}\n\n/**\n * Check accessibility compliance based on declared WCAG level.\n */\nfunction checkAccessibility(\n  essence: EssenceFile,\n  context: GuardContext\n): GuardViolation | null {\n  const accessibility = isV3(essence) ? essence.dna.accessibility : ('accessibility' in essence ? essence.accessibility : undefined);\n\n  if (!accessibility?.wcag_level || accessibility.wcag_level === 'none') {\n    return null;\n  }\n\n  if (context.a11y_issues && context.a11y_issues.length > 0) {\n    const issueList = context.a11y_issues.slice(0, 3).join(', ');\n    const moreCount = context.a11y_issues.length > 3 ? ` (+${context.a11y_issues.length - 3} more)` : '';\n\n    return {\n      rule: 'accessibility',\n      severity: 'error',\n      message: `WCAG ${accessibility.wcag_level} compliance required. Issues found: ${issueList}${moreCount}`,\n      suggestion: 'Fix accessibility issues before proceeding. Run an accessibility audit for details.',\n      ...(isV3(essence) ? { layer: 'dna' as const, autoFixable: false } : {}),\n    };\n  }\n\n  return null;\n}\n\nexport function evaluateGuard(essence: EssenceFile, context: GuardContext = {}): GuardViolation[] {\n  const guard = isV3(essence) ? essence.meta.guard : essence.guard;\n\n  if (guard.mode === 'creative') {\n    return [];\n  }\n\n  const violations: GuardViolation[] = [];\n  const isStrict = guard.mode === 'strict';\n\n  // Rule 1: Style guard\n  if (context.style) {\n    let essenceStyle: string | null;\n    if (isV3(essence)) {\n      essenceStyle = essence.dna.theme.style;\n    } else {\n      essenceStyle = isSimple(essence) ? essence.theme.style : null;\n    }\n    const enforceStyle = isV3(essence) ? true : (guard as import('./types.js').Guard).enforce_style !== false;\n    if (essenceStyle && context.style !== essenceStyle && enforceStyle) {\n      violations.push({\n        rule: 'style',\n        severity: 'error',\n        message: `Style \"${context.style}\" does not match essence theme \"${essenceStyle}\". Change the essence theme first.`,\n        ...(isV3(essence) ? { layer: 'dna' as const, autoFixable: false } : {}),\n      });\n    }\n  }\n\n  // Rule 2: Structure guard (enforced in both guided and strict)\n  if (context.pageId) {\n    const pages = getAllPages(essence);\n    const pageExists = pages.some(p => p.id === context.pageId);\n    if (!pageExists) {\n      violations.push({\n        rule: 'structure',\n        severity: isV3(essence) ? 'warning' : 'error',\n        message: `Page \"${context.pageId}\" does not exist in essence structure. Add it to the essence first.`,\n        ...(isV3(essence) ? {\n          layer: 'blueprint' as const,\n          autoFixable: true,\n          autoFix: { type: 'add_page' as const, patch: { id: context.pageId } },\n        } : {}),\n      });\n    }\n  }\n\n  // Rule 3: Layout guard (strict only)\n  if (isStrict && context.pageId && context.layout) {\n    const pages = getAllPages(essence);\n    const page = pages.find(p => p.id === context.pageId);\n    if (page) {\n      const essenceLayout = page.layout.map(item =>\n        typeof item === 'string' ? item : 'pattern' in item ? item.pattern : 'cols'\n      );\n      const proposedLayout = context.layout;\n      const matches = essenceLayout.length === proposedLayout.length &&\n        essenceLayout.every((item, i) => item === proposedLayout[i]);\n      if (!matches) {\n        violations.push({\n          rule: 'layout',\n          severity: isV3(essence) ? 'warning' : 'error',\n          message: `Layout for page \"${context.pageId}\" deviates from essence. Expected: [${essenceLayout.join(', ')}].`,\n          ...(isV3(essence) ? {\n            layer: 'blueprint' as const,\n            autoFixable: true,\n            autoFix: { type: 'update_layout' as const, patch: { page: context.pageId, layout: context.layout } },\n          } : {}),\n        });\n      }\n    }\n  }\n\n  // Rule 4: Recipe guard\n  if (context.recipe) {\n    let essenceRecipe: string | null;\n    let enforceRecipe: boolean;\n    if (isV3(essence)) {\n      essenceRecipe = essence.dna.theme.recipe;\n      enforceRecipe = true;\n    } else {\n      essenceRecipe = isSimple(essence) ? essence.theme.recipe : null;\n      enforceRecipe = (guard as import('./types.js').Guard).enforce_recipe !== false;\n    }\n    if (essenceRecipe && context.recipe !== essenceRecipe && enforceRecipe) {\n      violations.push({\n        rule: 'recipe',\n        severity: 'error',\n        message: `Recipe \"${context.recipe}\" does not match essence recipe \"${essenceRecipe}\".`,\n        ...(isV3(essence) ? { layer: 'dna' as const, autoFixable: false } : {}),\n      });\n    }\n  }\n\n  // Rule 5: Density guard (strict only)\n  if (isStrict && context.density_gap) {\n    let expectedGap: string;\n    if (isV3(essence)) {\n      // Check per-page dna_overrides for density if a pageId is provided\n      const overriddenDensity = getPageDensityOverride(essence, context.pageId);\n      expectedGap = overriddenDensity ?? essence.dna.spacing.content_gap;\n    } else {\n      expectedGap = essence.density.content_gap;\n    }\n    if (context.density_gap !== expectedGap) {\n      violations.push({\n        rule: 'density',\n        severity: 'warning',\n        message: `Content gap \"${context.density_gap}\" does not match essence density \"${expectedGap}\".`,\n        ...(isV3(essence) ? { layer: 'dna' as const, autoFixable: false } : {}),\n      });\n    }\n  }\n\n  // Rule 6: Theme/mode compatibility (always checked when registry available)\n  const themeModeViolation = checkThemeModeCompatibility(essence, context);\n  if (themeModeViolation) {\n    violations.push(themeModeViolation);\n  }\n\n  // Rule 7: Pattern existence (always checked when registry available)\n  const patternViolations = checkPatternExistence(essence, context);\n  violations.push(...patternViolations);\n\n  // Rule 8: Accessibility (when wcag_level is set, guided and strict modes)\n  const accessibilityViolation = checkAccessibility(essence, context);\n  if (accessibilityViolation) {\n    violations.push(accessibilityViolation);\n  }\n\n  // Apply v3 enforcement level filtering\n  if (isV3(essence)) {\n    const v3Guard = guard as EssenceV3Guard;\n\n    // DNA enforcement\n    if (v3Guard.dna_enforcement === 'off') {\n      // Remove all DNA-layer violations\n      return violations.filter(v => v.layer !== 'dna');\n    }\n    if (v3Guard.dna_enforcement === 'warn') {\n      // Downgrade DNA-layer violations to warning severity\n      for (const v of violations) {\n        if (v.layer === 'dna') {\n          v.severity = 'warning';\n        }\n      }\n    }\n\n    // Blueprint enforcement\n    if (v3Guard.blueprint_enforcement === 'off') {\n      // Remove all blueprint-layer violations\n      return violations.filter(v => v.layer !== 'blueprint');\n    }\n  }\n\n  return violations;\n}\n\nfunction getAllPages(essence: EssenceFile): StructurePage[] {\n  if (isV3(essence)) {\n    // Map v3 BlueprintPages to StructurePage shape for guard evaluation\n    const pages = flattenPages(essence.blueprint);\n    return pages.map(page => ({\n      id: page.id,\n      shell: page.shell_override ?? essence.blueprint.shell ?? '',\n      layout: page.layout,\n      ...(page.surface ? { surface: page.surface } : {}),\n    }));\n  }\n  if (isSimple(essence)) return essence.structure;\n  if (isSectioned(essence)) return essence.sections.flatMap(s => s.structure);\n  throw new Error('Unknown EssenceFile type');\n}\n\n/** Get per-page density override from v3 blueprint, if set. */\nfunction getPageDensityOverride(essence: EssenceV3, pageId?: string): string | undefined {\n  if (!pageId) return undefined;\n  const pages = flattenPages(essence.blueprint);\n  const page = pages.find(p => p.id === pageId);\n  if (!page?.dna_overrides?.density) return undefined;\n  // Map density level to a content_gap value\n  const densityGapMap: Record<DensityLevel, string> = {\n    compact: '2',\n    comfortable: '4',\n    spacious: '6',\n  };\n  return densityGapMap[page.dna_overrides.density] ?? undefined;\n}\n","import type { Essence, SectionedEssence, EssenceFile, EssenceV3, StructurePage, GuardMode } from './types.js';\n\nexport function normalizeEssence(input: Record<string, unknown>): EssenceFile {\n  // v3: version-based detection only (no structural fallback to avoid false positives)\n  if (input.version === '3.0.0') {\n    return input as unknown as EssenceV3;\n  }\n\n  // Detect v2: has 'theme' and 'platform' (normalized terms)\n  if (input.theme && input.platform) {\n    return input as unknown as EssenceFile;\n  }\n\n  if (input.sections) {\n    return normalizeSectioned(input);\n  }\n\n  return normalizeSimple(input);\n}\n\nfunction normalizeSimple(v1: Record<string, unknown>): Essence {\n  // v1 field names (wine terms) → v2 normalized names:\n  //   vintage → theme, vessel → platform, clarity → density,\n  //   cork → guard, terroir/vignette → archetype, tannins → features,\n  //   carafe → shell, blend → layout, character → personality\n  const vintage = v1.vintage as Record<string, string> | undefined;\n  const vessel = v1.vessel as Record<string, string> | undefined;\n  const clarity = v1.clarity as Record<string, string> | undefined;\n  const cork = v1.cork as Record<string, unknown> | undefined;\n  const structure = v1.structure as Array<Record<string, unknown>> | undefined;\n\n  return {\n    version: '2.0.0',\n    archetype: (v1.terroir ?? v1.vignette ?? v1.archetype) as string,\n    theme: {\n      style: vintage?.style ?? '',\n      mode: (vintage?.mode ?? 'dark') as 'light' | 'dark' | 'auto',\n      recipe: vintage?.recipe ?? '',\n      ...(vintage?.shape ? { shape: vintage.shape as 'sharp' | 'rounded' | 'pill' } : {}),\n    },\n    // Accept both old 'character' and new 'personality' field names\n    personality: (v1.character ?? v1.personality) as string[],\n    platform: {\n      type: (vessel?.type ?? 'spa') as 'spa' | 'ssr' | 'static',\n      routing: (vessel?.routing ?? 'hash') as 'hash' | 'history',\n    },\n    structure: (structure ?? []).map(normalizeStructurePage),\n    features: (v1.tannins ?? v1.features ?? []) as string[],\n    density: {\n      level: (clarity?.density ?? 'comfortable') as 'compact' | 'comfortable' | 'spacious',\n      content_gap: stripGapPrefix(clarity?.content_gap ?? '4'),\n    },\n    guard: normalizeGuard(cork),\n    target: (v1.target as string) ?? 'decantr',\n    ...(v1._impression ? { _impression: v1._impression as Essence['_impression'] } : {}),\n  };\n}\n\nfunction normalizeSectioned(v1: Record<string, unknown>): SectionedEssence {\n  // v1 field names (wine terms) → v2 normalized names:\n  //   vessel → platform, clarity → density, cork → guard,\n  //   terroir/vignette → archetype, tannins → features,\n  //   shared_tannins → shared_features, character → personality\n  const vessel = v1.vessel as Record<string, string> | undefined;\n  const clarity = v1.clarity as Record<string, string> | undefined;\n  const cork = v1.cork as Record<string, unknown> | undefined;\n  const sections = v1.sections as Array<Record<string, unknown>>;\n\n  return {\n    version: '2.0.0',\n    platform: {\n      type: (vessel?.type ?? 'spa') as 'spa' | 'ssr' | 'static',\n      routing: (vessel?.routing ?? 'hash') as 'hash' | 'history',\n    },\n    // Accept both old 'character' and new 'personality' field names\n    personality: (v1.character ?? v1.personality) as string[],\n    sections: sections.map(section => ({\n      id: section.id as string,\n      path: section.path as string,\n      archetype: (section.terroir ?? section.vignette ?? section.archetype) as string,\n      theme: {\n        style: (section.vintage as Record<string, string>)?.style ?? '',\n        mode: ((section.vintage as Record<string, string>)?.mode ?? 'dark') as 'light' | 'dark' | 'auto',\n        recipe: (section.vintage as Record<string, string>)?.recipe ?? '',\n      },\n      structure: ((section.structure as Array<Record<string, unknown>>) ?? []).map(normalizeStructurePage),\n      ...(section.tannins ? { features: section.tannins as string[] } : {}),\n    })),\n    ...(v1.shared_tannins ? { shared_features: v1.shared_tannins as string[] } : {}),\n    density: {\n      level: (clarity?.density ?? 'comfortable') as 'compact' | 'comfortable' | 'spacious',\n      content_gap: stripGapPrefix(clarity?.content_gap ?? '4'),\n    },\n    guard: normalizeGuard(cork),\n    target: (v1.target as string) ?? 'decantr',\n  };\n}\n\nfunction normalizeStructurePage(page: Record<string, unknown>): StructurePage {\n  // Accept v1 wine terms (carafe → shell, blend → layout) for backward compatibility\n  return {\n    id: page.id as string,\n    shell: (page.carafe ?? page.shell) as string,\n    layout: (page.blend ?? page.layout) as StructurePage['layout'],\n    ...(page.surface ? { surface: page.surface as string } : {}),\n  };\n}\n\n// Accept v1 'cork' object and normalize to v2 'guard'\nfunction normalizeGuard(cork: Record<string, unknown> | undefined): Essence['guard'] {\n  if (!cork) return { mode: 'creative' };\n\n  const modeMap: Record<string, GuardMode> = {\n    creative: 'creative',\n    maintenance: 'strict',\n    strict: 'strict',\n    guided: 'guided',\n  };\n\n  return {\n    ...(cork.enforce_style !== undefined ? { enforce_style: cork.enforce_style as boolean } : {}),\n    ...(cork.enforce_recipe !== undefined ? { enforce_recipe: cork.enforce_recipe as boolean } : {}),\n    mode: modeMap[(cork.mode as string) ?? 'creative'] ?? 'creative',\n  };\n}\n\nfunction stripGapPrefix(gap: string): string {\n  const match = gap.match(/^_gap(\\d+)$/);\n  return match ? match[1] : gap;\n}\n","import type {\n  Essence,\n  SectionedEssence,\n  EssenceV3,\n  EssenceFile,\n  EssenceDNA,\n  EssenceBlueprint,\n  EssenceMeta,\n  EssenceV31Section,\n  ThemeShape,\n  DensityLevel,\n  GuardMode,\n} from './types.js';\nimport { isSimple, isSectioned, isV3 } from './types.js';\n\n/**\n * Migrate a v2 EssenceFile to v3 format (DNA/Blueprint/Meta split).\n * If already v3, returns unchanged. SectionedEssence uses first section's theme.\n */\nexport function migrateV2ToV3(essence: EssenceFile): EssenceV3 {\n  if (isV3(essence)) return essence;\n\n  if (isSectioned(essence)) {\n    return migrateSectionedToV3(essence);\n  }\n\n  if (isSimple(essence)) {\n    return migrateSimpleToV3(essence);\n  }\n\n  throw new Error('Unknown EssenceFile type — cannot migrate');\n}\n\nfunction migrateSimpleToV3(essence: Essence): EssenceV3 {\n  const dna = buildDNA(essence);\n  const blueprint = buildBlueprintFromSimple(essence);\n  const meta = buildMeta(essence);\n\n  return {\n    version: '3.0.0',\n    dna,\n    blueprint,\n    meta,\n    ...(essence._impression ? { _impression: essence._impression } : {}),\n  };\n}\n\nfunction migrateSectionedToV3(essence: SectionedEssence): EssenceV3 {\n  // Use first section's theme as the DNA theme (sectioned essences have per-section themes)\n  const firstSection = essence.sections[0];\n  const syntheticSimple: Partial<Essence> = {\n    theme: firstSection.theme,\n    density: essence.density,\n    guard: essence.guard,\n    accessibility: essence.accessibility,\n  };\n\n  const dna = buildDNA(syntheticSimple as Essence);\n  // Override personality from the sectioned root\n  dna.personality = essence.personality;\n\n  // Flatten all sections' pages into the blueprint\n  const pages = essence.sections.flatMap(section =>\n    section.structure.map(page => ({\n      id: page.id,\n      shell_override: page.shell as string | null,\n      layout: page.layout,\n      ...(page.surface ? { surface: page.surface } : {}),\n    }))\n  );\n\n  const allFeatures = [\n    ...(essence.shared_features ?? []),\n    ...essence.sections.flatMap(s => s.features ?? []),\n  ];\n\n  const blueprint: EssenceBlueprint = {\n    shell: firstSection.structure[0]?.shell ?? 'top-nav-main',\n    pages,\n    features: [...new Set(allFeatures)],\n  };\n\n  const meta: EssenceMeta = {\n    archetype: firstSection.archetype,\n    target: essence.target,\n    platform: essence.platform,\n    guard: migrateGuard(essence.guard.mode),\n  };\n\n  return {\n    version: '3.0.0',\n    dna,\n    blueprint,\n    meta,\n    ...(essence._impression ? { _impression: essence._impression } : {}),\n  };\n}\n\nfunction buildDNA(essence: Essence): EssenceDNA {\n  const shape = essence.theme.shape ?? 'rounded';\n  const radiusBase = inferRadiusBase(shape);\n\n  return {\n    theme: {\n      style: essence.theme.style,\n      mode: essence.theme.mode,\n      recipe: essence.theme.recipe,\n      ...(essence.theme.shape ? { shape: essence.theme.shape } : {}),\n    },\n    spacing: {\n      base_unit: 4,\n      scale: 'linear',\n      density: (essence.density?.level ?? 'comfortable') as DensityLevel,\n      content_gap: essence.density?.content_gap ?? '4',\n    },\n    typography: {\n      scale: 'modular',\n      heading_weight: 600,\n      body_weight: 400,\n    },\n    color: {\n      palette: 'semantic',\n      accent_count: 1,\n      cvd_preference: essence.accessibility?.cvd_preference ?? 'auto',\n    },\n    radius: {\n      philosophy: shape,\n      base: radiusBase,\n    },\n    elevation: {\n      system: 'layered',\n      max_levels: 3,\n    },\n    motion: {\n      preference: 'subtle',\n      duration_scale: 1.0,\n      reduce_motion: true,\n    },\n    accessibility: {\n      wcag_level: essence.accessibility?.wcag_level ?? 'AA',\n      focus_visible: true,\n      skip_nav: true,\n    },\n    personality: essence.personality ?? ['professional'],\n  };\n}\n\nfunction buildBlueprintFromSimple(essence: Essence): EssenceBlueprint {\n  const defaultShell = essence.structure[0]?.shell ?? 'top-nav-main';\n\n  return {\n    shell: defaultShell,\n    pages: essence.structure.map(page => ({\n      id: page.id,\n      ...(page.shell !== defaultShell ? { shell_override: page.shell } : {}),\n      layout: page.layout,\n      ...(page.surface ? { surface: page.surface } : {}),\n    })),\n    features: essence.features ?? [],\n  };\n}\n\nfunction buildMeta(essence: Essence): EssenceMeta {\n  return {\n    archetype: essence.archetype,\n    target: essence.target,\n    platform: essence.platform,\n    guard: migrateGuard(essence.guard.mode),\n  };\n}\n\nfunction migrateGuard(mode: GuardMode): EssenceMeta['guard'] {\n  switch (mode) {\n    case 'strict':\n      return { mode: 'strict', dna_enforcement: 'error', blueprint_enforcement: 'warn' };\n    case 'guided':\n      return { mode: 'guided', dna_enforcement: 'error', blueprint_enforcement: 'off' };\n    case 'creative':\n    default:\n      return { mode: 'creative', dna_enforcement: 'off', blueprint_enforcement: 'off' };\n  }\n}\n\nfunction inferRadiusBase(shape: ThemeShape | string): number {\n  switch (shape) {\n    case 'pill': return 12;\n    case 'rounded': return 8;\n    case 'sharp': return 2;\n    default: return 8;\n  }\n}\n\n/**\n * Migrate a v3.0 flat-page EssenceV3 to v3.1 sectioned format.\n * If already v3.1 or has blueprint.sections, returns unchanged.\n */\nexport function migrateV30ToV31(essence: EssenceV3): EssenceV3 {\n  if (essence.version === '3.1.0' || essence.blueprint.sections) {\n    return essence;\n  }\n\n  const section: EssenceV31Section = {\n    id: essence.meta.archetype,\n    role: 'primary',\n    shell: essence.blueprint.shell ?? 'top-nav-main',\n    features: essence.blueprint.features,\n    description: '',\n    pages: essence.blueprint.pages ?? [],\n  };\n\n  return {\n    ...essence,\n    version: '3.1.0',\n    blueprint: {\n      ...essence.blueprint,\n      sections: [section],\n      pages: undefined,\n      routes: {},\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/types.ts","../src/validate.ts","../src/density.ts","../src/guard.ts","../src/normalize.ts","../src/migrate.ts"],"sourcesContent":["/**\n * Essence v2 schema types — normalized terminology.\n *\n * Terminology mapping (v1 wine terms → v2 normalized):\n *   terroir → archetype, vintage → theme, tannins → features,\n *   carafe → shell, cork → guard, blend → layout, clarity → density,\n *   vessel → platform, character → personality,\n *   decantation process → essence pipeline\n */\n\n// --- Theme ---\n\nexport type ThemeStyle =\n  | 'auradecantism'\n  | 'clean'\n  | 'glassmorphism'\n  | 'retro'\n  | 'bioluminescent'\n  | 'launchpad'\n  | 'dopamine'\n  | 'editorial'\n  | 'liquid-glass'\n  | 'prismatic';\n\nexport type ThemeMode = 'light' | 'dark' | 'auto';\nexport type ThemeShape = 'sharp' | 'rounded' | 'pill';\n\nexport interface Theme {\n  id: string;\n  mode: ThemeMode;\n  shape?: ThemeShape;\n}\n\n// --- Platform ---\n\nexport type PlatformType = 'spa' | 'ssr' | 'static';\nexport type RoutingStrategy = 'hash' | 'history' | 'pathname';\n\nexport interface Platform {\n  type: PlatformType;\n  routing: RoutingStrategy;\n}\n\n// --- Structure ---\n\nexport type ShellType =\n  | 'sidebar-main'\n  | 'top-nav-main'\n  | 'full-bleed'\n  | 'dashboard'\n  | 'stacked'\n  | string;\n\nexport type LayoutItem = string | PatternRef | ColumnLayout;\n\nexport interface PatternRef {\n  pattern: string;\n  preset?: string;\n  as?: string;\n}\n\nexport interface ColumnLayout {\n  cols: string[];\n  at?: 'sm' | 'md' | 'lg' | 'xl' | '2xl';\n  span?: Record<string, number>;\n  // AUTO: Multi-breakpoint grid — array of { at, cols } entries for cascading breakpoints\n  breakpoints?: { at: string; cols: number }[];\n  // AUTO: \"container\" uses container queries instead of viewport breakpoints\n  responsive?: 'viewport' | 'container';\n}\n\nexport interface StructurePage {\n  id: string;\n  shell: ShellType;\n  layout: LayoutItem[];\n  surface?: string;\n}\n\n// --- Density ---\n\nexport type DensityLevel = 'compact' | 'comfortable' | 'spacious';\n\nexport interface Density {\n  level: DensityLevel;\n  content_gap: string;\n}\n\nexport interface SpatialTokens {\n  '--d-section-py': string;\n  '--d-interactive-py': string;\n  '--d-interactive-px': string;\n  '--d-surface-p': string;\n  '--d-data-py': string;\n  '--d-control-py': string;\n  '--d-content-gap': string;\n  '--d-label-mb': string;\n  '--d-label-px': string;\n  '--d-section-gap': string;\n  '--d-annotation-mt': string;\n}\n\nexport interface SpatialTokenHints {\n  section_padding?: string | null;\n  density_bias?: number;\n  content_gap_shift?: number;\n  label_content_gap?: string | null;\n}\n\nexport interface ShellGuidance {\n  section_label_treatment?: string;\n  section_density?: DensityLevel;\n  [key: string]: string | DensityLevel | undefined;\n}\n\n// --- Guard ---\n\nexport type GuardMode = 'creative' | 'guided' | 'strict';\n\nexport interface Guard {\n  enforce_style?: boolean;\n  mode: GuardMode;\n}\n\n// --- Impression ---\n\nexport interface Impression {\n  vibe: string[];\n  references: string[];\n  density_intent: DensityLevel | string;\n  layout_intent: ShellType | string;\n  novel_elements: string[];\n}\n\n// --- Generator Target ---\n\nexport type GeneratorTarget = 'decantr' | 'react' | 'vue' | 'svelte' | string;\n\n// --- Accessibility ---\n\nexport type WcagLevel = 'none' | 'A' | 'AA' | 'AAA';\n\nexport type CvdPreference =\n  | 'none'\n  | 'auto'\n  | 'deuteranopia'\n  | 'protanopia'\n  | 'tritanopia'\n  | 'achromatopsia';\n\nexport interface Accessibility {\n  wcag_level?: WcagLevel;\n  cvd_preference?: CvdPreference;\n}\n\n// --- Essence (simple) ---\n\nexport interface Essence {\n  $schema?: string;\n  version: string;\n  archetype: string;\n  theme: Theme;\n  personality: string[];\n  platform: Platform;\n  structure: StructurePage[];\n  features: string[];\n  density: Density;\n  guard: Guard;\n  target: GeneratorTarget;\n  accessibility?: Accessibility;\n  _impression?: Impression;\n}\n\n// --- Essence (sectioned) ---\n\nexport interface EssenceSection {\n  id: string;\n  path: string;\n  archetype: string;\n  theme: Theme;\n  structure: StructurePage[];\n  features?: string[];\n}\n\nexport interface SectionedEssence {\n  $schema?: string;\n  version: string;\n  platform: Platform;\n  personality: string[];\n  sections: EssenceSection[];\n  shared_features?: string[];\n  density: Density;\n  guard: Guard;\n  target: GeneratorTarget;\n  accessibility?: Accessibility;\n  _impression?: Impression;\n}\n\n// --- Essence v3: DNA/Blueprint/Meta split ---\n\nexport interface EssenceDNA {\n  theme: Theme;\n  spacing: {\n    base_unit: number;\n    scale: string;\n    density: DensityLevel;\n    content_gap: string;\n  };\n  typography: {\n    scale: string;\n    heading_weight: number;\n    body_weight: number;\n  };\n  color: {\n    palette: string;\n    accent_count: number;\n    cvd_preference: CvdPreference | string;\n  };\n  radius: {\n    philosophy: ThemeShape | string;\n    base: number;\n  };\n  elevation: {\n    system: string;\n    max_levels: number;\n  };\n  motion: {\n    preference: string;\n    duration_scale: number;\n    reduce_motion: boolean;\n    timing?: string;\n    durations?: Record<string, string>;\n  };\n  accessibility: {\n    wcag_level: WcagLevel;\n    focus_visible: boolean;\n    skip_nav: boolean;\n  };\n  personality: string[];\n  constraints?: {\n    mode?: string;\n    typography?: string;\n    borders?: string;\n    corners?: string;\n    shadows?: string;\n    effects?: Record<string, string>;\n  };\n}\n\n/** Only density and mode may be overridden per-page. DNA axioms like wcag_level and theme.id are never overrideable. */\nexport interface DNAOverrides {\n  density?: DensityLevel;\n  mode?: ThemeMode;\n}\n\nexport interface BlueprintPage {\n  id: string;\n  route?: string;\n  shell_override?: ShellType | null;\n  layout: LayoutItem[];\n  patterns?: PatternRef[];\n  dna_overrides?: DNAOverrides;\n  surface?: string;\n}\n\nexport type ArchetypeRole = 'primary' | 'gateway' | 'public' | 'auxiliary';\n\nexport interface EssenceV31Section {\n  id: string;\n  role: ArchetypeRole;\n  shell: ShellType | string;\n  features: string[];\n  description: string;\n  pages: BlueprintPage[];\n  dna_overrides?: DNAOverrides;\n}\n\nexport interface RouteEntry {\n  section: string;\n  page: string;\n}\n\nexport interface EssenceBlueprint {\n  shell?: ShellType | string;\n  sections?: EssenceV31Section[];\n  pages?: BlueprintPage[];\n  features: string[];\n  routes?: Record<string, RouteEntry>;\n  icon_style?: string;\n  avatar_style?: string;\n}\n\nexport interface EssenceV3Guard {\n  mode: GuardMode;\n  dna_enforcement: 'error' | 'warn' | 'off';\n  blueprint_enforcement: 'warn' | 'off';\n}\n\nexport interface EssenceMeta {\n  archetype: string;\n  target: GeneratorTarget;\n  platform: Platform;\n  guard: EssenceV3Guard;\n  seo?: {\n    schema_org?: string[];\n    meta_priorities?: string[];\n  };\n  navigation?: {\n    hotkeys?: Array<{ key: string; route?: string; action?: string; label: string }>;\n    command_palette?: boolean;\n  };\n}\n\nexport interface EssenceV3 {\n  $schema?: string;\n  version: '3.0.0' | '3.1.0';\n  dna: EssenceDNA;\n  blueprint: EssenceBlueprint;\n  meta: EssenceMeta;\n  _impression?: Impression;\n}\n\n// --- Discriminated union ---\n\nexport type EssenceFile = Essence | SectionedEssence | EssenceV3;\n\nexport function isV3(essence: EssenceFile): essence is EssenceV3 {\n  return (essence.version === '3.0.0' || essence.version === '3.1.0') && 'dna' in essence && 'blueprint' in essence;\n}\n\n/** Flatten sections into a flat page list (for guards and backward compat). */\nexport function flattenPages(blueprint: EssenceBlueprint): BlueprintPage[] {\n  if (blueprint.sections && blueprint.sections.length > 0) {\n    return blueprint.sections.flatMap(s =>\n      s.pages.map(p => ({\n        ...p,\n        shell_override: p.shell_override ?? (s.shell !== blueprint.shell ? (s.shell as ShellType) : undefined),\n      }))\n    );\n  }\n  return blueprint.pages ?? [];\n}\n\nexport function isSectioned(essence: EssenceFile): essence is SectionedEssence {\n  if (isV3(essence)) return false;\n  return 'sections' in essence && Array.isArray((essence as SectionedEssence).sections);\n}\n\nexport function isSimple(essence: EssenceFile): essence is Essence {\n  if (isV3(essence)) return false;\n  return 'archetype' in essence && !('sections' in essence);\n}\n","import Ajv from 'ajv';\nimport { readFileSync, existsSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst v2SchemaPath = join(__dirname, '..', 'schema', 'essence.v2.json');\nconst v3SchemaPath = join(__dirname, '..', 'schema', 'essence.v3.json');\n\nlet cachedAjv: Ajv | null = null;\nconst validatorCache = new Map<string, ReturnType<Ajv['compile']>>();\n\nfunction getAjv(): Ajv {\n  if (!cachedAjv) {\n    cachedAjv = new Ajv({ allErrors: true, strict: false, validateSchema: false });\n  }\n  return cachedAjv;\n}\n\nfunction getValidator(version: 'v2' | 'v3'): ReturnType<Ajv['compile']> | null {\n  if (validatorCache.has(version)) return validatorCache.get(version)!;\n\n  const schemaPath = version === 'v3' ? v3SchemaPath : v2SchemaPath;\n  if (!existsSync(schemaPath)) return null;\n\n  const schema = JSON.parse(readFileSync(schemaPath, 'utf-8'));\n  const ajv = getAjv();\n  const validate = ajv.compile(schema);\n  validatorCache.set(version, validate);\n  return validate;\n}\n\nfunction detectVersion(data: unknown): 'v2' | 'v3' {\n  if (typeof data === 'object' && data !== null && 'version' in data) {\n    const v = (data as Record<string, unknown>).version;\n    if (v === '3.0.0' || v === '3.1.0') return 'v3';\n  }\n  return 'v2';\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\nexport function validateEssence(data: unknown): ValidationResult {\n  const version = detectVersion(data);\n  const validate = getValidator(version);\n\n  if (!validate) {\n    return { valid: false, errors: [`No schema available for ${version} documents`] };\n  }\n\n  const valid = validate(data);\n\n  if (valid) {\n    return { valid: true, errors: [] };\n  }\n\n  const errors = (validate.errors ?? []).map((err) => {\n    const path = err.instancePath || '/';\n    const msg = err.message ?? 'unknown error';\n    return `${path}: ${msg}`;\n  });\n\n  return { valid: false, errors };\n}\n","import type { Density, DensityLevel, SpatialTokens, SpatialTokenHints } from './types.js';\n\ninterface SpatialHints {\n  density_bias?: number;\n  content_gap_shift?: number;\n}\n\ninterface DensityRule {\n  traits: string[];\n  level: DensityLevel;\n  gap: number;\n}\n\nconst RULES: DensityRule[] = [\n  { traits: ['tactical', 'dense', 'data-dense', 'utilitarian'], level: 'compact', gap: 3 },\n  { traits: ['luxurious', 'premium', 'editorial'], level: 'spacious', gap: 8 },\n  { traits: ['playful', 'bouncy', 'expressive'], level: 'comfortable', gap: 5 },\n  { traits: ['minimal', 'clean', 'airy'], level: 'spacious', gap: 6 },\n  { traits: ['professional', 'modern', 'balanced'], level: 'comfortable', gap: 4 },\n];\n\nconst MIN_GAP = 2;\nconst MAX_GAP = 10;\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.max(min, Math.min(max, value));\n}\n\nexport function computeDensity(\n  personality: string[],\n  spatialHints?: SpatialHints,\n): Density {\n  const lower = personality.map(c => c.toLowerCase());\n\n  let level: DensityLevel = 'comfortable';\n  let gap = 4;\n\n  for (const rule of RULES) {\n    if (rule.traits.some(t => lower.includes(t))) {\n      level = rule.level;\n      gap = rule.gap;\n      break;\n    }\n  }\n\n  if (spatialHints?.density_bias) {\n    gap += spatialHints.density_bias;\n  }\n  if (spatialHints?.content_gap_shift) {\n    gap += spatialHints.content_gap_shift;\n  }\n\n  gap = clamp(gap, MIN_GAP, MAX_GAP);\n\n  if (gap <= 3) level = 'compact';\n  else if (gap >= 6) level = 'spacious';\n  else level = 'comfortable';\n\n  return { level, content_gap: String(gap) };\n}\n\n// --- Spatial Tokens ---\n\nconst DENSITY_SCALES: Record<DensityLevel, number> = {\n  compact: 0.65,\n  comfortable: 1.0,\n  spacious: 1.4,\n};\n\nconst BASE_TOKENS = {\n  '--d-section-py': 5,\n  '--d-interactive-py': 0.5,\n  '--d-interactive-px': 1,\n  '--d-surface-p': 1.25,\n  '--d-data-py': 0.625,\n  '--d-control-py': 0.5,\n  '--d-content-gap': 1,\n  '--d-label-mb': 0.75,\n  '--d-label-px': 0.75,\n  '--d-section-gap': 1.5,\n  '--d-annotation-mt': 0.5,\n} as const;\n\nfunction roundTo3(value: number): number {\n  return Math.round(value * 1000) / 1000;\n}\n\nfunction toRemString(value: number): string {\n  const rounded = roundTo3(value);\n  return `${rounded}rem`;\n}\n\nexport function computeSpatialTokens(\n  density: DensityLevel,\n  spatialHints?: SpatialTokenHints,\n): SpatialTokens {\n  const scale = DENSITY_SCALES[density];\n  const biasMultiplier = 1 + (spatialHints?.density_bias ?? 0) / 10;\n\n  const result = {} as SpatialTokens;\n\n  for (const [key, base] of Object.entries(BASE_TOKENS)) {\n    const tokenKey = key as keyof SpatialTokens;\n\n    // --d-label-px is a visual anchor — never density-scaled\n    if (tokenKey === '--d-label-px') {\n      result[tokenKey] = toRemString(base);\n      continue;\n    }\n\n    if (tokenKey === '--d-section-py' && spatialHints?.section_padding) {\n      const pxMatch = spatialHints.section_padding.match(/^(\\d+(?:\\.\\d+)?)px$/);\n      if (pxMatch) {\n        const remValue = parseFloat(pxMatch[1]) / 16;\n        result[tokenKey] = toRemString(remValue * scale * biasMultiplier);\n        continue;\n      }\n      const remMatch = spatialHints.section_padding.match(/^(\\d+(?:\\.\\d+)?)rem$/);\n      if (remMatch) {\n        const remValue = parseFloat(remMatch[1]);\n        result[tokenKey] = toRemString(remValue * scale * biasMultiplier);\n        continue;\n      }\n    }\n\n    // --d-label-mb can be overridden by theme's label_content_gap\n    if (tokenKey === '--d-label-mb' && spatialHints?.label_content_gap) {\n      const remMatch = spatialHints.label_content_gap.match(/^(\\d+(?:\\.\\d+)?)rem$/);\n      if (remMatch) {\n        const remValue = parseFloat(remMatch[1]);\n        result[tokenKey] = toRemString(remValue * scale * biasMultiplier);\n        continue;\n      }\n    }\n\n    let computed = base * scale * biasMultiplier;\n\n    if (tokenKey === '--d-content-gap' && spatialHints?.content_gap_shift) {\n      computed += spatialHints.content_gap_shift * 0.25;\n    }\n\n    result[tokenKey] = toRemString(computed);\n  }\n\n  return result;\n}\n","import type { EssenceFile, EssenceV3, EssenceV3Guard, StructurePage, LayoutItem, DensityLevel } from './types.js';\nimport { isSimple, isSectioned, isV3, flattenPages } from './types.js';\n\nexport interface AutoFix {\n  type: 'add_page' | 'update_layout' | 'update_blueprint';\n  patch: Record<string, unknown>;\n}\n\nexport interface GuardViolation {\n  rule: 'theme' | 'structure' | 'layout' | 'density' | 'theme-mode' | 'pattern-exists' | 'accessibility';\n  severity: 'error' | 'warning';\n  message: string;\n  suggestion?: string;\n  layer?: 'dna' | 'blueprint';\n  autoFixable?: boolean;\n  autoFix?: AutoFix;\n}\n\nexport interface GuardContext {\n  pageId?: string;\n  theme?: string;\n  /** @deprecated Use `theme` instead. */\n  style?: string;\n  layout?: string[];\n  density_gap?: string;\n  themeRegistry?: Map<string, { modes: string[] }>;\n  patternRegistry?: Map<string, unknown>;\n  a11y_issues?: string[];\n}\n\n/**\n * Check if the theme supports the specified mode.\n */\nfunction checkThemeModeCompatibility(\n  essence: EssenceFile,\n  context: GuardContext\n): GuardViolation | null {\n  if (!context.themeRegistry) return null;\n\n  let themeId: string | null;\n  let mode: string | null;\n  if (isV3(essence)) {\n    themeId = essence.dna.theme?.id ?? null;\n    mode = essence.dna.theme?.mode ?? null;\n  } else {\n    themeId = isSimple(essence) ? essence.theme?.id : null;\n    mode = isSimple(essence) ? essence.theme?.mode : null;\n  }\n\n  if (!themeId || !mode) return null;\n\n  const theme = context.themeRegistry.get(themeId);\n  if (!theme) {\n    // Theme not found - separate validation\n    return null;\n  }\n\n  if (!theme.modes.includes(mode) && mode !== 'auto') {\n    const supportedModes = theme.modes.join(', ');\n    const suggestion = theme.modes.length > 0\n      ? `Use mode: \"${theme.modes[0]}\" instead, or choose a theme that supports ${mode} mode.`\n      : undefined;\n\n    return {\n      rule: 'theme-mode',\n      severity: 'error',\n      message: `Theme \"${themeId}\" does not support \"${mode}\" mode. Supported modes: ${supportedModes}.`,\n      suggestion,\n      ...(isV3(essence) ? { layer: 'dna' as const, autoFixable: false } : {}),\n    };\n  }\n\n  return null;\n}\n\n/**\n * Collect all pattern IDs from a layout item, recursively handling nested structures.\n */\nfunction collectPatternIds(item: LayoutItem, ids: Set<string>): void {\n  if (typeof item === 'string') {\n    ids.add(item);\n    return;\n  }\n  if (typeof item === 'object' && item !== null) {\n    if ('pattern' in item && typeof item.pattern === 'string') {\n      ids.add(item.pattern);\n    }\n    if ('cols' in item && Array.isArray(item.cols)) {\n      for (const col of item.cols) {\n        // cols contains strings (pattern IDs)\n        if (typeof col === 'string') {\n          ids.add(col);\n        }\n      }\n    }\n  }\n}\n\n/**\n * Find similar pattern IDs in the registry for suggestion.\n */\nfunction findSimilarPatterns(target: string, registry: Map<string, unknown>): string[] {\n  const similar: string[] = [];\n  const targetLower = target.toLowerCase();\n\n  for (const id of registry.keys()) {\n    const idLower = id.toLowerCase();\n    // Simple similarity: contains target or target contains id\n    if (idLower.includes(targetLower) || targetLower.includes(idLower)) {\n      similar.push(id);\n    }\n  }\n\n  return similar.slice(0, 3); // Top 3 suggestions\n}\n\n/**\n * Check if all referenced patterns exist in the registry.\n */\nfunction checkPatternExistence(\n  essence: EssenceFile,\n  context: GuardContext\n): GuardViolation[] {\n  if (!context.patternRegistry) return [];\n\n  const violations: GuardViolation[] = [];\n  const referencedPatterns = new Set<string>();\n\n  // Collect all pattern references from structure\n  const pages = getAllPages(essence);\n  for (const page of pages) {\n    for (const item of page.layout || []) {\n      collectPatternIds(item, referencedPatterns);\n    }\n  }\n\n  // Check each pattern exists\n  for (const patternId of referencedPatterns) {\n    if (!context.patternRegistry.has(patternId)) {\n      // Find similar patterns for suggestion\n      const similar = findSimilarPatterns(patternId, context.patternRegistry);\n      const suggestion = similar.length > 0\n        ? `Similar patterns: ${similar.join(', ')}`\n        : `Run \"decantr search ${patternId}\" to find alternatives.`;\n\n      violations.push({\n        rule: 'pattern-exists',\n        severity: isV3(essence) ? 'warning' : 'error',\n        message: `Pattern \"${patternId}\" is referenced but does not exist in the registry.`,\n        suggestion,\n        ...(isV3(essence) ? { layer: 'blueprint' as const, autoFixable: false } : {}),\n      });\n    }\n  }\n\n  return violations;\n}\n\n/**\n * Check accessibility compliance based on declared WCAG level.\n */\nfunction checkAccessibility(\n  essence: EssenceFile,\n  context: GuardContext\n): GuardViolation | null {\n  const accessibility = isV3(essence) ? essence.dna.accessibility : ('accessibility' in essence ? essence.accessibility : undefined);\n\n  if (!accessibility?.wcag_level || accessibility.wcag_level === 'none') {\n    return null;\n  }\n\n  if (context.a11y_issues && context.a11y_issues.length > 0) {\n    const issueList = context.a11y_issues.slice(0, 3).join(', ');\n    const moreCount = context.a11y_issues.length > 3 ? ` (+${context.a11y_issues.length - 3} more)` : '';\n\n    return {\n      rule: 'accessibility',\n      severity: 'error',\n      message: `WCAG ${accessibility.wcag_level} compliance required. Issues found: ${issueList}${moreCount}`,\n      suggestion: 'Fix accessibility issues before proceeding. Run an accessibility audit for details.',\n      ...(isV3(essence) ? { layer: 'dna' as const, autoFixable: false } : {}),\n    };\n  }\n\n  return null;\n}\n\nexport function evaluateGuard(essence: EssenceFile, context: GuardContext = {}): GuardViolation[] {\n  const guard = isV3(essence) ? essence.meta.guard : essence.guard;\n\n  if (guard.mode === 'creative') {\n    return [];\n  }\n\n  const violations: GuardViolation[] = [];\n  const isStrict = guard.mode === 'strict';\n\n  // Rule 1: Theme guard\n  const requestedTheme = context.theme ?? context.style;\n  if (requestedTheme) {\n    let essenceThemeId: string | null;\n    if (isV3(essence)) {\n      essenceThemeId = essence.dna.theme.id;\n    } else {\n      essenceThemeId = isSimple(essence) ? essence.theme.id : null;\n    }\n    const enforceStyle = isV3(essence) ? true : (guard as import('./types.js').Guard).enforce_style !== false;\n    if (essenceThemeId && requestedTheme !== essenceThemeId && enforceStyle) {\n      violations.push({\n        rule: 'theme',\n        severity: 'error',\n        message: `Theme \"${requestedTheme}\" does not match essence theme \"${essenceThemeId}\". Change the essence theme first.`,\n        ...(isV3(essence) ? { layer: 'dna' as const, autoFixable: false } : {}),\n      });\n    }\n  }\n\n  // Rule 2: Structure guard (enforced in both guided and strict)\n  if (context.pageId) {\n    const pages = getAllPages(essence);\n    const pageExists = pages.some(p => p.id === context.pageId);\n    if (!pageExists) {\n      violations.push({\n        rule: 'structure',\n        severity: isV3(essence) ? 'warning' : 'error',\n        message: `Page \"${context.pageId}\" does not exist in essence structure. Add it to the essence first.`,\n        ...(isV3(essence) ? {\n          layer: 'blueprint' as const,\n          autoFixable: true,\n          autoFix: { type: 'add_page' as const, patch: { id: context.pageId } },\n        } : {}),\n      });\n    }\n  }\n\n  // Rule 3: Layout guard (strict only)\n  if (isStrict && context.pageId && context.layout) {\n    const pages = getAllPages(essence);\n    const page = pages.find(p => p.id === context.pageId);\n    if (page) {\n      const essenceLayout = page.layout.map(item =>\n        typeof item === 'string' ? item : 'pattern' in item ? item.pattern : 'cols'\n      );\n      const proposedLayout = context.layout;\n      const matches = essenceLayout.length === proposedLayout.length &&\n        essenceLayout.every((item, i) => item === proposedLayout[i]);\n      if (!matches) {\n        violations.push({\n          rule: 'layout',\n          severity: isV3(essence) ? 'warning' : 'error',\n          message: `Layout for page \"${context.pageId}\" deviates from essence. Expected: [${essenceLayout.join(', ')}].`,\n          ...(isV3(essence) ? {\n            layer: 'blueprint' as const,\n            autoFixable: true,\n            autoFix: { type: 'update_layout' as const, patch: { page: context.pageId, layout: context.layout } },\n          } : {}),\n        });\n      }\n    }\n  }\n\n  // Rule 4: Density guard (strict only)\n  if (isStrict && context.density_gap) {\n    let expectedGap: string;\n    if (isV3(essence)) {\n      // Check per-page dna_overrides for density if a pageId is provided\n      const overriddenDensity = getPageDensityOverride(essence, context.pageId);\n      expectedGap = overriddenDensity ?? essence.dna.spacing.content_gap;\n    } else {\n      expectedGap = essence.density.content_gap;\n    }\n    if (context.density_gap !== expectedGap) {\n      violations.push({\n        rule: 'density',\n        severity: 'warning',\n        message: `Content gap \"${context.density_gap}\" does not match essence density \"${expectedGap}\".`,\n        ...(isV3(essence) ? { layer: 'dna' as const, autoFixable: false } : {}),\n      });\n    }\n  }\n\n  // Rule 6: Theme/mode compatibility (always checked when registry available)\n  const themeModeViolation = checkThemeModeCompatibility(essence, context);\n  if (themeModeViolation) {\n    violations.push(themeModeViolation);\n  }\n\n  // Rule 7: Pattern existence (always checked when registry available)\n  const patternViolations = checkPatternExistence(essence, context);\n  violations.push(...patternViolations);\n\n  // Rule 8: Accessibility (when wcag_level is set, guided and strict modes)\n  const accessibilityViolation = checkAccessibility(essence, context);\n  if (accessibilityViolation) {\n    violations.push(accessibilityViolation);\n  }\n\n  // Apply v3 enforcement level filtering\n  if (isV3(essence)) {\n    const v3Guard = guard as EssenceV3Guard;\n\n    // DNA enforcement\n    if (v3Guard.dna_enforcement === 'off') {\n      // Remove all DNA-layer violations\n      return violations.filter(v => v.layer !== 'dna');\n    }\n    if (v3Guard.dna_enforcement === 'warn') {\n      // Downgrade DNA-layer violations to warning severity\n      for (const v of violations) {\n        if (v.layer === 'dna') {\n          v.severity = 'warning';\n        }\n      }\n    }\n\n    // Blueprint enforcement\n    if (v3Guard.blueprint_enforcement === 'off') {\n      // Remove all blueprint-layer violations\n      return violations.filter(v => v.layer !== 'blueprint');\n    }\n  }\n\n  return violations;\n}\n\nfunction getAllPages(essence: EssenceFile): StructurePage[] {\n  if (isV3(essence)) {\n    // Map v3 BlueprintPages to StructurePage shape for guard evaluation\n    const pages = flattenPages(essence.blueprint);\n    return pages.map(page => ({\n      id: page.id,\n      shell: page.shell_override ?? essence.blueprint.shell ?? '',\n      layout: page.layout,\n      ...(page.surface ? { surface: page.surface } : {}),\n    }));\n  }\n  if (isSimple(essence)) return essence.structure;\n  if (isSectioned(essence)) return essence.sections.flatMap(s => s.structure);\n  throw new Error('Unknown EssenceFile type');\n}\n\n/** Get per-page density override from v3 blueprint, if set. */\nfunction getPageDensityOverride(essence: EssenceV3, pageId?: string): string | undefined {\n  if (!pageId) return undefined;\n  const pages = flattenPages(essence.blueprint);\n  const page = pages.find(p => p.id === pageId);\n  if (!page?.dna_overrides?.density) return undefined;\n  // Map density level to a content_gap value\n  const densityGapMap: Record<DensityLevel, string> = {\n    compact: '2',\n    comfortable: '4',\n    spacious: '6',\n  };\n  return densityGapMap[page.dna_overrides.density] ?? undefined;\n}\n","import type { Essence, SectionedEssence, EssenceFile, EssenceV3, StructurePage, GuardMode } from './types.js';\n\nexport function normalizeEssence(input: Record<string, unknown>): EssenceFile {\n  // v3: version-based detection only (no structural fallback to avoid false positives)\n  if (input.version === '3.0.0' || input.version === '3.1.0') {\n    return input as unknown as EssenceV3;\n  }\n\n  // Detect v2: has 'theme' and 'platform' (normalized terms)\n  if (input.theme && input.platform) {\n    return input as unknown as EssenceFile;\n  }\n\n  if (input.sections) {\n    return normalizeSectioned(input);\n  }\n\n  return normalizeSimple(input);\n}\n\nfunction normalizeSimple(v1: Record<string, unknown>): Essence {\n  // v1 field names (wine terms) → v2 normalized names:\n  //   vintage → theme, vessel → platform, clarity → density,\n  //   cork → guard, terroir/vignette → archetype, tannins → features,\n  //   carafe → shell, blend → layout, character → personality\n  const vintage = v1.vintage as Record<string, string> | undefined;\n  const vessel = v1.vessel as Record<string, string> | undefined;\n  const clarity = v1.clarity as Record<string, string> | undefined;\n  const cork = v1.cork as Record<string, unknown> | undefined;\n  const structure = v1.structure as Array<Record<string, unknown>> | undefined;\n\n  return {\n    version: '2.0.0',\n    archetype: (v1.terroir ?? v1.vignette ?? v1.archetype) as string,\n    theme: {\n      id: vintage?.style ?? '',\n      mode: (vintage?.mode ?? 'dark') as 'light' | 'dark' | 'auto',\n      ...(vintage?.shape ? { shape: vintage.shape as 'sharp' | 'rounded' | 'pill' } : {}),\n    },\n    // Accept both old 'character' and new 'personality' field names\n    personality: (v1.character ?? v1.personality) as string[],\n    platform: {\n      type: (vessel?.type ?? 'spa') as 'spa' | 'ssr' | 'static',\n      routing: (vessel?.routing ?? 'hash') as 'hash' | 'history' | 'pathname',\n    },\n    structure: (structure ?? []).map(normalizeStructurePage),\n    features: (v1.tannins ?? v1.features ?? []) as string[],\n    density: {\n      level: (clarity?.density ?? 'comfortable') as 'compact' | 'comfortable' | 'spacious',\n      content_gap: stripGapPrefix(clarity?.content_gap ?? '4'),\n    },\n    guard: normalizeGuard(cork),\n    target: (v1.target as string) ?? 'decantr',\n    ...(v1._impression ? { _impression: v1._impression as Essence['_impression'] } : {}),\n  };\n}\n\nfunction normalizeSectioned(v1: Record<string, unknown>): SectionedEssence {\n  // v1 field names (wine terms) → v2 normalized names:\n  //   vessel → platform, clarity → density, cork → guard,\n  //   terroir/vignette → archetype, tannins → features,\n  //   shared_tannins → shared_features, character → personality\n  const vessel = v1.vessel as Record<string, string> | undefined;\n  const clarity = v1.clarity as Record<string, string> | undefined;\n  const cork = v1.cork as Record<string, unknown> | undefined;\n  const sections = v1.sections as Array<Record<string, unknown>>;\n\n  return {\n    version: '2.0.0',\n    platform: {\n      type: (vessel?.type ?? 'spa') as 'spa' | 'ssr' | 'static',\n      routing: (vessel?.routing ?? 'hash') as 'hash' | 'history' | 'pathname',\n    },\n    // Accept both old 'character' and new 'personality' field names\n    personality: (v1.character ?? v1.personality) as string[],\n    sections: sections.map(section => ({\n      id: section.id as string,\n      path: section.path as string,\n      archetype: (section.terroir ?? section.vignette ?? section.archetype) as string,\n      theme: {\n        id: (section.vintage as Record<string, string>)?.style ?? '',\n        mode: ((section.vintage as Record<string, string>)?.mode ?? 'dark') as 'light' | 'dark' | 'auto',\n      },\n      structure: ((section.structure as Array<Record<string, unknown>>) ?? []).map(normalizeStructurePage),\n      ...(section.tannins ? { features: section.tannins as string[] } : {}),\n    })),\n    ...(v1.shared_tannins ? { shared_features: v1.shared_tannins as string[] } : {}),\n    density: {\n      level: (clarity?.density ?? 'comfortable') as 'compact' | 'comfortable' | 'spacious',\n      content_gap: stripGapPrefix(clarity?.content_gap ?? '4'),\n    },\n    guard: normalizeGuard(cork),\n    target: (v1.target as string) ?? 'decantr',\n  };\n}\n\nfunction normalizeStructurePage(page: Record<string, unknown>): StructurePage {\n  // Accept v1 wine terms (carafe → shell, blend → layout) for backward compatibility\n  return {\n    id: page.id as string,\n    shell: (page.carafe ?? page.shell) as string,\n    layout: (page.blend ?? page.layout) as StructurePage['layout'],\n    ...(page.surface ? { surface: page.surface as string } : {}),\n  };\n}\n\n// Accept v1 'cork' object and normalize to v2 'guard'\nfunction normalizeGuard(cork: Record<string, unknown> | undefined): Essence['guard'] {\n  if (!cork) return { mode: 'creative' };\n\n  const modeMap: Record<string, GuardMode> = {\n    creative: 'creative',\n    maintenance: 'strict',\n    strict: 'strict',\n    guided: 'guided',\n  };\n\n  return {\n    ...(cork.enforce_style !== undefined ? { enforce_style: cork.enforce_style as boolean } : {}),\n    mode: modeMap[(cork.mode as string) ?? 'creative'] ?? 'creative',\n  };\n}\n\nfunction stripGapPrefix(gap: string): string {\n  const match = gap.match(/^_gap(\\d+)$/);\n  return match ? match[1] : gap;\n}\n","import type {\n  Essence,\n  SectionedEssence,\n  EssenceV3,\n  EssenceFile,\n  EssenceDNA,\n  EssenceBlueprint,\n  EssenceMeta,\n  EssenceV31Section,\n  ThemeShape,\n  DensityLevel,\n  GuardMode,\n} from './types.js';\nimport { isSimple, isSectioned, isV3 } from './types.js';\n\n/**\n * Migrate a v2 EssenceFile to v3 format (DNA/Blueprint/Meta split).\n * If already v3, returns unchanged. SectionedEssence uses first section's theme.\n */\nexport function migrateV2ToV3(essence: EssenceFile): EssenceV3 {\n  if (isV3(essence)) return essence;\n\n  if (isSectioned(essence)) {\n    return migrateSectionedToV3(essence);\n  }\n\n  if (isSimple(essence)) {\n    return migrateSimpleToV3(essence);\n  }\n\n  throw new Error('Unknown EssenceFile type — cannot migrate');\n}\n\nfunction migrateSimpleToV3(essence: Essence): EssenceV3 {\n  const dna = buildDNA(essence);\n  const blueprint = buildBlueprintFromSimple(essence);\n  const meta = buildMeta(essence);\n\n  return {\n    version: '3.0.0',\n    dna,\n    blueprint,\n    meta,\n    ...(essence._impression ? { _impression: essence._impression } : {}),\n  };\n}\n\nfunction migrateSectionedToV3(essence: SectionedEssence): EssenceV3 {\n  // Use first section's theme as the DNA theme (sectioned essences have per-section themes)\n  const firstSection = essence.sections[0];\n  const syntheticSimple: Partial<Essence> = {\n    theme: firstSection.theme,\n    density: essence.density,\n    guard: essence.guard,\n    accessibility: essence.accessibility,\n  };\n\n  const dna = buildDNA(syntheticSimple as Essence);\n  // Override personality from the sectioned root\n  dna.personality = essence.personality;\n\n  // Flatten all sections' pages into the blueprint\n  const pages = essence.sections.flatMap(section =>\n    section.structure.map(page => ({\n      id: page.id,\n      shell_override: page.shell as string | null,\n      layout: page.layout,\n      ...(page.surface ? { surface: page.surface } : {}),\n    }))\n  );\n\n  const allFeatures = [\n    ...(essence.shared_features ?? []),\n    ...essence.sections.flatMap(s => s.features ?? []),\n  ];\n\n  const blueprint: EssenceBlueprint = {\n    shell: firstSection.structure[0]?.shell ?? 'top-nav-main',\n    pages,\n    features: [...new Set(allFeatures)],\n  };\n\n  const meta: EssenceMeta = {\n    archetype: firstSection.archetype,\n    target: essence.target,\n    platform: essence.platform,\n    guard: migrateGuard(essence.guard.mode),\n  };\n\n  return {\n    version: '3.0.0',\n    dna,\n    blueprint,\n    meta,\n    ...(essence._impression ? { _impression: essence._impression } : {}),\n  };\n}\n\nfunction buildDNA(essence: Essence): EssenceDNA {\n  const shape = essence.theme.shape ?? 'rounded';\n  const radiusBase = inferRadiusBase(shape);\n\n  return {\n    theme: {\n      id: essence.theme.id,\n      mode: essence.theme.mode,\n      ...(essence.theme.shape ? { shape: essence.theme.shape } : {}),\n    },\n    spacing: {\n      base_unit: 4,\n      scale: 'linear',\n      density: (essence.density?.level ?? 'comfortable') as DensityLevel,\n      content_gap: essence.density?.content_gap ?? '4',\n    },\n    typography: {\n      scale: 'modular',\n      heading_weight: 600,\n      body_weight: 400,\n    },\n    color: {\n      palette: 'semantic',\n      accent_count: 1,\n      cvd_preference: essence.accessibility?.cvd_preference ?? 'auto',\n    },\n    radius: {\n      philosophy: shape,\n      base: radiusBase,\n    },\n    elevation: {\n      system: 'layered',\n      max_levels: 3,\n    },\n    motion: {\n      preference: 'subtle',\n      duration_scale: 1.0,\n      reduce_motion: true,\n    },\n    accessibility: {\n      wcag_level: essence.accessibility?.wcag_level ?? 'AA',\n      focus_visible: true,\n      skip_nav: true,\n    },\n    personality: essence.personality ?? ['professional'],\n  };\n}\n\nfunction buildBlueprintFromSimple(essence: Essence): EssenceBlueprint {\n  const defaultShell = essence.structure[0]?.shell ?? 'top-nav-main';\n\n  return {\n    shell: defaultShell,\n    pages: essence.structure.map(page => ({\n      id: page.id,\n      ...(page.shell !== defaultShell ? { shell_override: page.shell } : {}),\n      layout: page.layout,\n      ...(page.surface ? { surface: page.surface } : {}),\n    })),\n    features: essence.features ?? [],\n  };\n}\n\nfunction buildMeta(essence: Essence): EssenceMeta {\n  return {\n    archetype: essence.archetype,\n    target: essence.target,\n    platform: essence.platform,\n    guard: migrateGuard(essence.guard.mode),\n  };\n}\n\nfunction migrateGuard(mode: GuardMode): EssenceMeta['guard'] {\n  switch (mode) {\n    case 'strict':\n      return { mode: 'strict', dna_enforcement: 'error', blueprint_enforcement: 'warn' };\n    case 'guided':\n      return { mode: 'guided', dna_enforcement: 'error', blueprint_enforcement: 'off' };\n    case 'creative':\n    default:\n      return { mode: 'creative', dna_enforcement: 'off', blueprint_enforcement: 'off' };\n  }\n}\n\nfunction inferRadiusBase(shape: ThemeShape | string): number {\n  switch (shape) {\n    case 'pill': return 12;\n    case 'rounded': return 8;\n    case 'sharp': return 2;\n    default: return 8;\n  }\n}\n\n/**\n * Migrate a v3.0 flat-page EssenceV3 to v3.1 sectioned format.\n * If already v3.1 or has blueprint.sections, returns unchanged.\n */\nexport function migrateV30ToV31(essence: EssenceV3): EssenceV3 {\n  if (essence.version === '3.1.0' || essence.blueprint.sections) {\n    return essence;\n  }\n\n  const section: EssenceV31Section = {\n    id: essence.meta.archetype,\n    role: 'primary',\n    shell: essence.blueprint.shell ?? 'top-nav-main',\n    features: essence.blueprint.features,\n    description: `${essence.meta.archetype} primary section`,\n    pages: essence.blueprint.pages ?? [],\n  };\n\n  return {\n    ...essence,\n    version: '3.1.0',\n    blueprint: {\n      ...essence.blueprint,\n      sections: [section],\n      pages: undefined,\n      routes: {},\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@decantr/essence-spec",
-  "version": "1.0.0-beta.9",
-  "description": "Essence schema, validator, and TypeScript types for Decantr",
+  "version": "1.0.1",
+  "description": "Essence schemas, validation, migration, and TypeScript types for Decantr",
+  "author": "Decantr AI",
   "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/decantr-ai/decantr/issues"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/decantr-ai/decantr.git",
+    "url": "git+https://github.com/decantr-ai/decantr.git",
     "directory": "packages/essence-spec"
   },
   "homepage": "https://decantr.ai",
@@ -19,18 +23,23 @@
     },
     "./schema": {
       "import": "./schema/essence.v2.json"
-    }
+    },
+    "./schema/essence.v2.json": "./schema/essence.v2.json",
+    "./schema/essence.v3.json": "./schema/essence.v3.json"
   },
-  "files": ["dist", "schema"],
+  "files": [
+    "dist",
+    "schema"
+  ],
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "ajv": "^8.17.0"
+  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
     "test:watch": "vitest"
-  },
-  "dependencies": {
-    "ajv": "^8.17.0"
   }
-}
+}

package/schema/essence.v2.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://decantr.ai/schema/essence/2.0.json",
+  "$id": "https://decantr.ai/schemas/essence.v2.json",
   "title": "Decantr Essence v2",
   "description": "Design intent specification for AI-generated web applications",
   "oneOf": [
@@ -48,12 +48,11 @@
     },
     "Theme": {
       "type": "object",
-      "required": ["style", "mode", "recipe"],
+      "required": ["id", "mode"],
       "additionalProperties": false,
       "properties": {
-        "style": { "type": "string", "minLength": 1 },
+        "id": { "type": "string", "minLength": 1 },
         "mode": { "type": "string", "enum": ["light", "dark", "auto"] },
-        "recipe": { "type": "string", "minLength": 1 },
         "shape": { "type": "string", "enum": ["sharp", "rounded", "pill"] }
       }
     },
@@ -63,7 +62,7 @@
       "additionalProperties": false,
       "properties": {
         "type": { "type": "string", "enum": ["spa", "ssr", "static"] },
-        "routing": { "type": "string", "enum": ["hash", "history"] }
+        "routing": { "type": "string", "enum": ["hash", "history", "pathname"] }
       }
     },
     "StructurePage": {
@@ -121,7 +120,6 @@
       "additionalProperties": false,
       "properties": {
         "enforce_style": { "type": "boolean" },
-        "enforce_recipe": { "type": "boolean" },
         "mode": { "type": "string", "enum": ["creative", "guided", "strict"] }
       }
     },

package/schema/essence.v3.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://decantr.ai/schema/essence/3.0.json",
+  "$id": "https://decantr.ai/schemas/essence.v3.json",
   "title": "Decantr Essence v3",
   "description": "Design intent specification with DNA/Blueprint/Meta split",
   "type": "object",
@@ -8,7 +8,7 @@
   "additionalProperties": false,
   "properties": {
     "$schema": { "type": "string" },
-    "version": { "type": "string", "const": "3.0.0" },
+    "version": { "type": "string", "enum": ["3.0.0", "3.1.0"] },
     "dna": { "$ref": "#/$defs/DNA" },
     "blueprint": { "$ref": "#/$defs/Blueprint" },
     "meta": { "$ref": "#/$defs/Meta" },
@@ -28,17 +28,17 @@
         "elevation": { "$ref": "#/$defs/Elevation" },
         "motion": { "$ref": "#/$defs/Motion" },
         "accessibility": { "$ref": "#/$defs/AccessibilityV3" },
-        "personality": { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+        "personality": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        "constraints": { "$ref": "#/$defs/Constraints" }
       }
     },
     "Theme": {
       "type": "object",
-      "required": ["style", "mode", "recipe"],
+      "required": ["id", "mode"],
       "additionalProperties": false,
       "properties": {
-        "style": { "type": "string", "minLength": 1 },
+        "id": { "type": "string", "minLength": 1 },
         "mode": { "type": "string", "enum": ["light", "dark", "auto"] },
-        "recipe": { "type": "string", "minLength": 1 },
         "shape": { "type": "string", "enum": ["sharp", "rounded", "pill"] }
       }
     },
@@ -111,14 +111,38 @@
         "skip_nav": { "type": "boolean" }
       }
     },
+    "Constraints": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "mode": { "type": "string", "minLength": 1 },
+        "typography": { "type": "string", "minLength": 1 },
+        "borders": { "type": "string", "minLength": 1 },
+        "corners": { "type": "string", "minLength": 1 },
+        "shadows": { "type": "string", "minLength": 1 },
+        "effects": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        }
+      }
+    },
     "Blueprint": {
       "type": "object",
-      "required": ["shell", "pages", "features"],
+      "required": ["features"],
       "additionalProperties": false,
+      "anyOf": [
+        { "required": ["shell", "pages"] },
+        { "required": ["sections"] }
+      ],
       "properties": {
         "shell": { "type": "string", "minLength": 1 },
         "pages": { "type": "array", "items": { "$ref": "#/$defs/BlueprintPage" }, "minItems": 1 },
+        "sections": { "type": "array", "items": { "$ref": "#/$defs/BlueprintSection" }, "minItems": 1 },
         "features": { "type": "array", "items": { "type": "string" } },
+        "routes": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/RouteEntry" }
+        },
         "icon_style": { "type": "string" },
         "avatar_style": { "type": "string" }
       }
@@ -129,12 +153,36 @@
       "additionalProperties": false,
       "properties": {
         "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+        "route": { "type": "string", "minLength": 1 },
         "shell_override": { "oneOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }] },
         "layout": { "type": "array", "items": { "$ref": "#/$defs/LayoutItem" }, "minItems": 1 },
         "dna_overrides": { "$ref": "#/$defs/DNAOverrides" },
         "surface": { "type": "string" }
       }
     },
+    "BlueprintSection": {
+      "type": "object",
+      "required": ["id", "role", "shell", "features", "description", "pages"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+        "role": { "type": "string", "enum": ["primary", "gateway", "public", "auxiliary"] },
+        "shell": { "type": "string", "minLength": 1 },
+        "features": { "type": "array", "items": { "type": "string" } },
+        "description": { "type": "string", "minLength": 1 },
+        "pages": { "type": "array", "items": { "$ref": "#/$defs/BlueprintPage" }, "minItems": 1 },
+        "dna_overrides": { "$ref": "#/$defs/DNAOverrides" }
+      }
+    },
+    "RouteEntry": {
+      "type": "object",
+      "required": ["section", "page"],
+      "additionalProperties": false,
+      "properties": {
+        "section": { "type": "string", "minLength": 1 },
+        "page": { "type": "string", "minLength": 1 }
+      }
+    },
     "DNAOverrides": {
       "type": "object",
       "additionalProperties": false,
@@ -180,7 +228,9 @@
         "archetype": { "type": "string", "minLength": 1 },
         "target": { "type": "string", "minLength": 1 },
         "platform": { "$ref": "#/$defs/Platform" },
-        "guard": { "$ref": "#/$defs/GuardV3" }
+        "guard": { "$ref": "#/$defs/GuardV3" },
+        "seo": { "$ref": "#/$defs/SeoHints" },
+        "navigation": { "$ref": "#/$defs/NavigationHints" }
       }
     },
     "Platform": {
@@ -189,7 +239,7 @@
       "additionalProperties": false,
       "properties": {
         "type": { "type": "string", "enum": ["spa", "ssr", "static"] },
-        "routing": { "type": "string", "enum": ["hash", "history"] }
+        "routing": { "type": "string", "enum": ["hash", "history", "pathname"] }
       }
     },
     "GuardV3": {
@@ -202,6 +252,33 @@
         "blueprint_enforcement": { "type": "string", "enum": ["warn", "off"] }
       }
     },
+    "SeoHints": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "schema_org": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "meta_priorities": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "NavigationHints": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "hotkeys": { "type": "array", "items": { "$ref": "#/$defs/NavigationHotkey" } },
+        "command_palette": { "type": "boolean" }
+      }
+    },
+    "NavigationHotkey": {
+      "type": "object",
+      "required": ["key", "label"],
+      "additionalProperties": false,
+      "properties": {
+        "key": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "route": { "type": "string", "minLength": 1 },
+        "action": { "type": "string", "minLength": 1 }
+      }
+    },
     "Impression": {
       "type": "object",
       "additionalProperties": false,