@decantr/essence-spec 1.0.0-beta.3 → 1.0.0-beta.4

package/dist/index.d.ts

@@ -64,6 +64,12 @@ interface Impression {
     novel_elements: string[];
 }
 type GeneratorTarget = 'decantr' | 'react' | 'vue' | 'svelte' | string;
+type WcagLevel = 'none' | 'A' | 'AA' | 'AAA';
+type CvdPreference = 'none' | 'auto' | 'deuteranopia' | 'protanopia' | 'tritanopia' | 'achromatopsia';
+interface Accessibility {
+    wcag_level?: WcagLevel;
+    cvd_preference?: CvdPreference;
+}
 interface Essence {
     $schema?: string;
     version: string;
@@ -76,6 +82,7 @@ interface Essence {
     density: Density;
     guard: Guard;
     target: GeneratorTarget;
+    accessibility?: Accessibility;
     _impression?: Impression;
 }
 interface EssenceSection {
@@ -96,6 +103,7 @@ interface SectionedEssence {
     density: Density;
     guard: Guard;
     target: GeneratorTarget;
+    accessibility?: Accessibility;
     _impression?: Impression;
 }
 type EssenceFile = Essence | SectionedEssence;
@@ -115,9 +123,10 @@ interface RecipeSpatialHints {
 declare function computeDensity(personality: string[], recipeSpatial?: RecipeSpatialHints): Density;
 
 interface GuardViolation {
-    rule: 'style' | 'structure' | 'layout' | 'recipe' | 'density';
+    rule: 'style' | 'structure' | 'layout' | 'recipe' | 'density' | 'theme-mode' | 'pattern-exists' | 'accessibility';
     severity: 'error' | 'warning';
     message: string;
+    suggestion?: string;
 }
 interface GuardContext {
     pageId?: string;
@@ -125,9 +134,14 @@ interface GuardContext {
     recipe?: string;
     layout?: string[];
     density_gap?: string;
+    themeRegistry?: Map<string, {
+        modes: string[];
+    }>;
+    patternRegistry?: Map<string, unknown>;
+    a11y_issues?: string[];
 }
-declare function evaluateGuard(essence: EssenceFile, context: GuardContext): GuardViolation[];
+declare function evaluateGuard(essence: EssenceFile, context?: GuardContext): GuardViolation[];
 
 declare function normalizeEssence(input: Record<string, unknown>): EssenceFile;
 
-export { type ColumnLayout, type Density, type DensityLevel, type Essence, type EssenceFile, type EssenceSection, type GeneratorTarget, type Guard, type GuardContext, type GuardMode, type GuardViolation, type Impression, type LayoutItem, type PatternRef, type Platform, type PlatformType, type RoutingStrategy, type SectionedEssence, type ShellType, type StructurePage, type Theme, type ThemeMode, type ThemeShape, type ThemeStyle, type ValidationResult, computeDensity, evaluateGuard, isSectioned, isSimple, normalizeEssence, validateEssence };
+export { type Accessibility, type ColumnLayout, type CvdPreference, type Density, type DensityLevel, type Essence, type EssenceFile, type EssenceSection, type GeneratorTarget, type Guard, type GuardContext, type GuardMode, type GuardViolation, type Impression, type LayoutItem, type PatternRef, type Platform, type PlatformType, type RoutingStrategy, type SectionedEssence, type ShellType, type StructurePage, type Theme, type ThemeMode, type ThemeShape, type ThemeStyle, type ValidationResult, type WcagLevel, computeDensity, evaluateGuard, isSectioned, isSimple, normalizeEssence, validateEssence };

package/dist/index.js

@@ -74,7 +74,98 @@ function computeDensity(personality, recipeSpatial) {
 }
 
 // src/guard.ts
-function evaluateGuard(essence, context) {
+function checkThemeModeCompatibility(essence, context) {
+  if (!context.themeRegistry) return null;
+  const themeId = isSimple(essence) ? essence.theme?.style : null;
+  const mode = isSimple(essence) ? essence.theme?.mode : null;
+  if (!themeId || !mode) return null;
+  const theme = context.themeRegistry.get(themeId);
+  if (!theme) {
+    return null;
+  }
+  if (!theme.modes.includes(mode) && mode !== "auto") {
+    const supportedModes = theme.modes.join(", ");
+    const suggestion = theme.modes.length > 0 ? `Use mode: "${theme.modes[0]}" instead, or choose a theme that supports ${mode} mode.` : void 0;
+    return {
+      rule: "theme-mode",
+      severity: "error",
+      message: `Theme "${themeId}" does not support "${mode}" mode. Supported modes: ${supportedModes}.`,
+      suggestion
+    };
+  }
+  return null;
+}
+function collectPatternIds(item, ids) {
+  if (typeof item === "string") {
+    ids.add(item);
+    return;
+  }
+  if (typeof item === "object" && item !== null) {
+    if ("pattern" in item && typeof item.pattern === "string") {
+      ids.add(item.pattern);
+    }
+    if ("cols" in item && Array.isArray(item.cols)) {
+      for (const col of item.cols) {
+        if (typeof col === "string") {
+          ids.add(col);
+        }
+      }
+    }
+  }
+}
+function findSimilarPatterns(target, registry) {
+  const similar = [];
+  const targetLower = target.toLowerCase();
+  for (const id of registry.keys()) {
+    const idLower = id.toLowerCase();
+    if (idLower.includes(targetLower) || targetLower.includes(idLower)) {
+      similar.push(id);
+    }
+  }
+  return similar.slice(0, 3);
+}
+function checkPatternExistence(essence, context) {
+  if (!context.patternRegistry) return [];
+  const violations = [];
+  const referencedPatterns = /* @__PURE__ */ new Set();
+  const pages = getAllPages(essence);
+  for (const page of pages) {
+    for (const item of page.layout || []) {
+      collectPatternIds(item, referencedPatterns);
+    }
+  }
+  for (const patternId of referencedPatterns) {
+    if (!context.patternRegistry.has(patternId)) {
+      const similar = findSimilarPatterns(patternId, context.patternRegistry);
+      const suggestion = similar.length > 0 ? `Similar patterns: ${similar.join(", ")}` : `Run "decantr search ${patternId}" to find alternatives.`;
+      violations.push({
+        rule: "pattern-exists",
+        severity: "error",
+        message: `Pattern "${patternId}" is referenced but does not exist in the registry.`,
+        suggestion
+      });
+    }
+  }
+  return violations;
+}
+function checkAccessibility(essence, context) {
+  const accessibility = "accessibility" in essence ? essence.accessibility : void 0;
+  if (!accessibility?.wcag_level || accessibility.wcag_level === "none") {
+    return null;
+  }
+  if (context.a11y_issues && context.a11y_issues.length > 0) {
+    const issueList = context.a11y_issues.slice(0, 3).join(", ");
+    const moreCount = context.a11y_issues.length > 3 ? ` (+${context.a11y_issues.length - 3} more)` : "";
+    return {
+      rule: "accessibility",
+      severity: "error",
+      message: `WCAG ${accessibility.wcag_level} compliance required. Issues found: ${issueList}${moreCount}`,
+      suggestion: "Fix accessibility issues before proceeding. Run an accessibility audit for details."
+    };
+  }
+  return null;
+}
+function evaluateGuard(essence, context = {}) {
   const guard = essence.guard;
   if (guard.mode === "creative") {
     return [];
@@ -139,6 +230,16 @@ function evaluateGuard(essence, context) {
       });
     }
   }
+  const themeModeViolation = checkThemeModeCompatibility(essence, context);
+  if (themeModeViolation) {
+    violations.push(themeModeViolation);
+  }
+  const patternViolations = checkPatternExistence(essence, context);
+  violations.push(...patternViolations);
+  const accessibilityViolation = checkAccessibility(essence, context);
+  if (accessibilityViolation) {
+    violations.push(accessibilityViolation);
+  }
   return violations;
 }
 function getAllPages(essence) {

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"],"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\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// --- 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  _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  _impression?: Impression;\n}\n\nexport type EssenceFile = Essence | SectionedEssence;\n\nexport function isSectioned(essence: EssenceFile): essence is SectionedEssence {\n  return 'sections' in essence && Array.isArray((essence as SectionedEssence).sections);\n}\n\nexport function isSimple(essence: EssenceFile): essence is Essence {\n  return 'archetype' in essence && !('sections' in essence);\n}\n","import Ajv from 'ajv';\nimport { readFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst schemaPath = join(__dirname, '..', 'schema', 'essence.v2.json');\n\nlet cachedAjv: Ajv | null = null;\nlet cachedValidate: ReturnType<Ajv['compile']> | null = null;\n\nfunction getValidator() {\n  if (cachedValidate) return cachedValidate;\n  const schema = JSON.parse(readFileSync(schemaPath, 'utf-8'));\n  cachedAjv = new Ajv({ allErrors: true, strict: false, validateSchema: false });\n  cachedValidate = cachedAjv.compile(schema);\n  return cachedValidate;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\nexport function validateEssence(data: unknown): ValidationResult {\n  const validate = getValidator();\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 } 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","import type { EssenceFile, StructurePage } from './types.js';\nimport { isSimple, isSectioned } from './types.js';\n\nexport interface GuardViolation {\n  rule: 'style' | 'structure' | 'layout' | 'recipe' | 'density';\n  severity: 'error' | 'warning';\n  message: string;\n}\n\nexport interface GuardContext {\n  pageId?: string;\n  style?: string;\n  recipe?: string;\n  layout?: string[];\n  density_gap?: string;\n}\n\nexport function evaluateGuard(essence: EssenceFile, context: GuardContext): GuardViolation[] {\n  const 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    const essenceStyle = isSimple(essence) ? essence.theme.style : null;\n    if (essenceStyle && context.style !== essenceStyle && guard.enforce_style !== false) {\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      });\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: 'error',\n        message: `Page \"${context.pageId}\" does not exist in essence structure. Add it to the essence first.`,\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: 'error',\n          message: `Layout for page \"${context.pageId}\" deviates from essence. Expected: [${essenceLayout.join(', ')}].`,\n        });\n      }\n    }\n  }\n\n  // Rule 4: Recipe guard\n  if (context.recipe && guard.enforce_recipe !== false) {\n    const essenceRecipe = isSimple(essence) ? essence.theme.recipe : null;\n    if (essenceRecipe && context.recipe !== essenceRecipe) {\n      violations.push({\n        rule: 'recipe',\n        severity: 'error',\n        message: `Recipe \"${context.recipe}\" does not match essence recipe \"${essenceRecipe}\".`,\n      });\n    }\n  }\n\n  // Rule 5: Density guard (strict only)\n  if (isStrict && context.density_gap) {\n    if (context.density_gap !== essence.density.content_gap) {\n      violations.push({\n        rule: 'density',\n        severity: 'warning',\n        message: `Content gap \"${context.density_gap}\" does not match essence density \"${essence.density.content_gap}\".`,\n      });\n    }\n  }\n\n  return violations;\n}\n\nfunction getAllPages(essence: EssenceFile): StructurePage[] {\n  if (isSimple(essence)) return essence.structure;\n  if (isSectioned(essence)) return essence.sections.flatMap(s => s.structure);\n  return [];\n}\n","import type { Essence, SectionedEssence, EssenceFile, StructurePage, GuardMode } from './types.js';\n\nexport function normalizeEssence(input: Record<string, unknown>): EssenceFile {\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"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/types.ts","../src/validate.ts","../src/density.ts","../src/guard.ts","../src/normalize.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\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\nexport type EssenceFile = Essence | SectionedEssence;\n\nexport function isSectioned(essence: EssenceFile): essence is SectionedEssence {\n  return 'sections' in essence && Array.isArray((essence as SectionedEssence).sections);\n}\n\nexport function isSimple(essence: EssenceFile): essence is Essence {\n  return 'archetype' in essence && !('sections' in essence);\n}\n","import Ajv from 'ajv';\nimport { readFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst schemaPath = join(__dirname, '..', 'schema', 'essence.v2.json');\n\nlet cachedAjv: Ajv | null = null;\nlet cachedValidate: ReturnType<Ajv['compile']> | null = null;\n\nfunction getValidator() {\n  if (cachedValidate) return cachedValidate;\n  const schema = JSON.parse(readFileSync(schemaPath, 'utf-8'));\n  cachedAjv = new Ajv({ allErrors: true, strict: false, validateSchema: false });\n  cachedValidate = cachedAjv.compile(schema);\n  return cachedValidate;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\nexport function validateEssence(data: unknown): ValidationResult {\n  const validate = getValidator();\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 } 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","import type { EssenceFile, StructurePage, LayoutItem } from './types.js';\nimport { isSimple, isSectioned } from './types.js';\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}\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  const themeId = isSimple(essence) ? essence.theme?.style : null;\n  const mode = isSimple(essence) ? essence.theme?.mode : null;\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    };\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: 'error',\n        message: `Pattern \"${patternId}\" is referenced but does not exist in the registry.`,\n        suggestion,\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 = '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    };\n  }\n\n  return null;\n}\n\nexport function evaluateGuard(essence: EssenceFile, context: GuardContext = {}): GuardViolation[] {\n  const 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    const essenceStyle = isSimple(essence) ? essence.theme.style : null;\n    if (essenceStyle && context.style !== essenceStyle && guard.enforce_style !== false) {\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      });\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: 'error',\n        message: `Page \"${context.pageId}\" does not exist in essence structure. Add it to the essence first.`,\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: 'error',\n          message: `Layout for page \"${context.pageId}\" deviates from essence. Expected: [${essenceLayout.join(', ')}].`,\n        });\n      }\n    }\n  }\n\n  // Rule 4: Recipe guard\n  if (context.recipe && guard.enforce_recipe !== false) {\n    const essenceRecipe = isSimple(essence) ? essence.theme.recipe : null;\n    if (essenceRecipe && context.recipe !== essenceRecipe) {\n      violations.push({\n        rule: 'recipe',\n        severity: 'error',\n        message: `Recipe \"${context.recipe}\" does not match essence recipe \"${essenceRecipe}\".`,\n      });\n    }\n  }\n\n  // Rule 5: Density guard (strict only)\n  if (isStrict && context.density_gap) {\n    if (context.density_gap !== essence.density.content_gap) {\n      violations.push({\n        rule: 'density',\n        severity: 'warning',\n        message: `Content gap \"${context.density_gap}\" does not match essence density \"${essence.density.content_gap}\".`,\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  return violations;\n}\n\nfunction getAllPages(essence: EssenceFile): StructurePage[] {\n  if (isSimple(essence)) return essence.structure;\n  if (isSectioned(essence)) return essence.sections.flatMap(s => s.structure);\n  return [];\n}\n","import type { Essence, SectionedEssence, EssenceFile, StructurePage, GuardMode } from './types.js';\n\nexport function normalizeEssence(input: Record<string, unknown>): EssenceFile {\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"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/essence-spec",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.4",
   "description": "Essence schema, validator, and TypeScript types for Decantr",
   "license": "MIT",
   "repository": {
@@ -21,19 +21,16 @@
       "import": "./schema/essence.v2.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

@@ -24,6 +24,7 @@
         "density": { "$ref": "#/$defs/Density" },
         "guard": { "$ref": "#/$defs/Guard" },
         "target": { "type": "string", "minLength": 1 },
+        "accessibility": { "$ref": "#/$defs/Accessibility" },
         "_impression": { "$ref": "#/$defs/Impression" }
       }
     },
@@ -41,6 +42,7 @@
         "density": { "$ref": "#/$defs/Density" },
         "guard": { "$ref": "#/$defs/Guard" },
         "target": { "type": "string", "minLength": 1 },
+        "accessibility": { "$ref": "#/$defs/Accessibility" },
         "_impression": { "$ref": "#/$defs/Impression" }
       }
     },
@@ -144,6 +146,22 @@
         "structure": { "type": "array", "items": { "$ref": "#/$defs/StructurePage" }, "minItems": 1 },
         "features": { "type": "array", "items": { "type": "string" } }
       }
+    },
+    "Accessibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "wcag_level": {
+          "type": "string",
+          "enum": ["none", "A", "AA", "AAA"],
+          "description": "WCAG compliance level requirement"
+        },
+        "cvd_preference": {
+          "type": "string",
+          "enum": ["none", "auto", "deuteranopia", "protanopia", "tritanopia", "achromatopsia"],
+          "description": "Color vision deficiency accommodation preference"
+        }
+      }
     }
   }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-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.