cascivo 0.1.6 → 0.3.4

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 urbanisierung
+Copyright (c) cascivo contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

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

package/dist/{audit-AHr4MDMK.mjs → audit-InQqdY1s.mjs}

@@ -389,11 +389,11 @@ function findRequiredPropViolations(source, filename, contract) {
 //#endregion
 //#region src/utils/contract.ts
 const HERE = dirname(fileURLToPath(import.meta.url));
-/** Walk up from a start directory looking for the apps/docs/public dir. */
+/** Walk up from a start directory looking for the apps/site/public dir. */
 function findDocsPublic(startDir) {
 	let dir = startDir;
 	for (let i = 0; i < 10; i++) {
-		const candidate = join(dir, "apps", "docs", "public");
+		const candidate = join(dir, "apps", "site", "public");
 		if (existsSync(candidate)) return candidate;
 		dir = join(dir, "..");
 	}
@@ -411,18 +411,18 @@ function findRegistry(startDir) {
 }
 /**
 * Load the published cascade contract from local generated artifacts:
-* - token catalog (apps/docs/public/tokens.catalog.json) → value→token map
+* - token catalog (apps/site/public/tokens.catalog.json) → value→token map
 * - registry.json (repo root) → component prop index
-* - context bundle (apps/docs/public/context.json) → which components have chrome text
+* - context bundle (apps/site/public/context.json) → which components have chrome text
 */
 async function loadContract(options) {
 	const docsPublic = findDocsPublic(HERE) ?? findDocsPublic(process.cwd());
 	const catalogPath = options?.catalogPath ?? (docsPublic ? join(docsPublic, "tokens.catalog.json") : null);
 	const contextPath = options?.contextPath ?? (docsPublic ? join(docsPublic, "context.json") : null);
 	const registryPath = options?.registryPath ?? findRegistry(HERE) ?? findRegistry(process.cwd());
-	if (!catalogPath || !existsSync(catalogPath)) throw new Error("token catalog not found (apps/docs/public/tokens.catalog.json)");
+	if (!catalogPath || !existsSync(catalogPath)) throw new Error("token catalog not found (apps/site/public/tokens.catalog.json)");
 	if (!registryPath || !existsSync(registryPath)) throw new Error("registry.json not found");
-	if (!contextPath || !existsSync(contextPath)) throw new Error("context bundle not found (apps/docs/public/context.json)");
+	if (!contextPath || !existsSync(contextPath)) throw new Error("context bundle not found (apps/site/public/context.json)");
 	return buildContract({
 		catalog: JSON.parse(readFileSync(catalogPath, "utf8")),
 		registry: JSON.parse(readFileSync(registryPath, "utf8")),
@@ -544,7 +544,7 @@ function applyFixes(files, contract) {
 }
 async function audit(args, _config) {
 	if (!args.includes("--ai")) {
-		console.log("cascade audit: use --ai to audit AI-generated code against the cascade contract");
+		console.log("cascivo audit: use --ai to audit AI-generated code against the cascivo contract");
 		return;
 	}
 	const jsonOutput = args.includes("--json");
@@ -580,4 +580,4 @@ async function audit(args, _config) {
 //#endregion
 export { audit };
 
-//# sourceMappingURL=audit-AHr4MDMK.mjs.map
+//# sourceMappingURL=audit-InQqdY1s.mjs.map

package/dist/{audit-AHr4MDMK.mjs.map → audit-InQqdY1s.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"audit-AHr4MDMK.mjs","names":[],"sources":["../src/utils/contract-pure.ts","../src/audit-ai/css-literals.ts","../src/audit-ai/jsx-props.ts","../src/audit-ai/raw-strings.ts","../src/audit-ai/required-props.ts","../src/utils/contract.ts","../src/commands/audit.ts"],"sourcesContent":["export interface PropInfo {\n  name: string\n  type: string\n  required: boolean\n}\n\nexport interface ComponentInfo {\n  props: PropInfo[]\n  /** True if any prop has required: true */\n  hasRequiredProps: boolean\n  /** Props that have required: true */\n  requiredProps: string[]\n  /** True if the component declares user-facing chrome text (intent.content) */\n  hasContent: boolean\n}\n\nexport interface Contract {\n  /** Map from normalized color/size value → token names */\n  tokensByValue: Map<string, string[]>\n  /** Map from component name (PascalCase) → component info */\n  components: Map<string, ComponentInfo>\n}\n\ninterface TokenEntry {\n  name: string\n  resolvedDefault: string | null\n}\n\ninterface CatalogFile {\n  tokens: TokenEntry[]\n}\n\ninterface RegistryPropMeta {\n  name: string\n  type?: string\n  required?: boolean\n}\n\ninterface RegistryComponentMeta {\n  name: string\n  props?: RegistryPropMeta[]\n}\n\ninterface RegistryEntry {\n  meta?: RegistryComponentMeta\n}\n\ninterface RegistryFile {\n  components: RegistryEntry[]\n}\n\ninterface ContextComponentEntry {\n  name: string\n  intent?: { content?: unknown }\n}\n\ninterface ContextFile {\n  components: ContextComponentEntry[]\n}\n\nexport interface BuildContractInput {\n  catalog: CatalogFile\n  registry: RegistryFile\n  context: ContextFile\n}\n\n/** Normalize a color/size value for catalog comparison: lowercase, strip spaces. */\nexport function normalizeValue(value: string): string {\n  return value.toLowerCase().replace(/\\s+/g, '')\n}\n\n/** Pure builder — assemble a Contract from already-parsed JSON. Testable without fs. */\nexport function buildContract(input: BuildContractInput): Contract {\n  const tokensByValue = new Map<string, string[]>()\n  for (const token of input.catalog.tokens) {\n    if (token.resolvedDefault == null) continue\n    const key = normalizeValue(token.resolvedDefault)\n    const list = tokensByValue.get(key)\n    if (list) list.push(token.name)\n    else tokensByValue.set(key, [token.name])\n  }\n\n  const contentNames = new Set<string>()\n  for (const c of input.context.components) {\n    if (c.intent?.content) contentNames.add(c.name)\n  }\n\n  const components = new Map<string, ComponentInfo>()\n  for (const entry of input.registry.components) {\n    const meta = entry.meta\n    if (!meta?.name) continue\n    const props: PropInfo[] = (meta.props ?? []).map((p) => ({\n      name: p.name,\n      type: p.type ?? 'unknown',\n      required: p.required === true,\n    }))\n    const requiredProps = props.filter((p) => p.required).map((p) => p.name)\n    components.set(meta.name, {\n      props,\n      requiredProps,\n      hasRequiredProps: requiredProps.length > 0,\n      hasContent: contentNames.has(meta.name),\n    })\n  }\n\n  return { tokensByValue, components }\n}\n","import type { Contract } from '../utils/contract-pure.js'\nimport { normalizeValue } from '../utils/contract-pure.js'\n\nexport interface LiteralFinding {\n  file: string\n  line: number\n  property: string\n  value: string\n  level: 'error' | 'info'\n  rule: 'hardcoded-value'\n  /** only when exactly one catalog match */\n  suggestedToken?: string\n  /** when multiple catalog matches → info */\n  allMatches?: string[]\n}\n\n/** Visual CSS properties whose literal values should be tokens. */\nconst VISUAL_PROPS = new Set([\n  'color',\n  'background',\n  'background-color',\n  'border-color',\n  'box-shadow',\n  'border-radius',\n  'font-size',\n  'gap',\n  'padding',\n  'margin',\n  'width',\n  'height',\n])\n\n/** Inline-style camelCase → kebab-case for the props we care about. */\nconst INLINE_PROP_MAP: Record<string, string> = {\n  color: 'color',\n  background: 'background',\n  backgroundColor: 'background-color',\n  borderColor: 'border-color',\n  boxShadow: 'box-shadow',\n  borderRadius: 'border-radius',\n  fontSize: 'font-size',\n  gap: 'gap',\n  padding: 'padding',\n  margin: 'margin',\n  width: 'width',\n  height: 'height',\n}\n\n/** A literal value worth checking: hex, oklch/rgb/hsl(a), or px/rem number. */\nfunction isLiteralValue(value: string): boolean {\n  const v = value.trim()\n  if (v.includes('var(')) return false\n  if (/^#[0-9a-fA-F]{3,8}$/.test(v)) return true\n  if (/^(oklch|oklab|rgb|rgba|hsl|hsla)\\(/i.test(v)) return true\n  if (/^-?\\d*\\.?\\d+(px|rem)$/.test(v)) return true\n  return false\n}\n\nfunction classify(\n  value: string,\n  contract: Contract,\n): Pick<LiteralFinding, 'level' | 'suggestedToken' | 'allMatches'> | null {\n  const matches = contract.tokensByValue.get(normalizeValue(value))\n  if (!matches || matches.length === 0) return null\n  const first = matches[0]\n  if (matches.length === 1 && first) return { level: 'error', suggestedToken: first }\n  return { level: 'info', allMatches: matches }\n}\n\n/**\n * Detect literal color/size values in CSS declarations and TSX inline styles\n * that exactly match a known cascade token. Heuristic, line-based — no full\n * CSS/JS parse. Values with no catalog match are NOT flagged (arbitrary brand\n * values are allowed).\n */\nexport function findCssLiteralViolations(\n  source: string,\n  filename: string,\n  contract: Contract,\n): LiteralFinding[] {\n  const findings: LiteralFinding[] = []\n  const lines = source.split('\\n')\n\n  // CSS declaration: `property: value;` (also matches the kebab props inside style=\"...\")\n  const cssDecl = /(^|[;{\\s])([a-z-]+)\\s*:\\s*([^;}{]+?)\\s*(?=[;}]|$)/gi\n  // Inline JSX style object: `color: '#fff'` or `color: \"#fff\"`\n  const inlineDecl = /([A-Za-z][A-Za-z]*)\\s*:\\s*(['\"])([^'\"]+)\\2/g\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i]\n    if (line === undefined) continue\n    const seen = new Set<string>()\n\n    for (const m of line.matchAll(cssDecl)) {\n      if (m[2] === undefined || m[3] === undefined) continue\n      const prop = m[2].toLowerCase()\n      const rawValue = m[3].trim()\n      if (!VISUAL_PROPS.has(prop)) continue\n      if (!isLiteralValue(rawValue)) continue\n      const cls = classify(rawValue, contract)\n      if (!cls) continue\n      const key = `${prop}|${rawValue}`\n      seen.add(key)\n      findings.push({\n        file: filename,\n        line: i + 1,\n        property: prop,\n        value: rawValue,\n        rule: 'hardcoded-value',\n        ...cls,\n      })\n    }\n\n    for (const m of line.matchAll(inlineDecl)) {\n      if (m[1] === undefined || m[3] === undefined) continue\n      const prop = INLINE_PROP_MAP[m[1]]\n      if (!prop) continue\n      const rawValue = m[3].trim()\n      if (!isLiteralValue(rawValue)) continue\n      const key = `${prop}|${rawValue}`\n      if (seen.has(key)) continue\n      const cls = classify(rawValue, contract)\n      if (!cls) continue\n      findings.push({\n        file: filename,\n        line: i + 1,\n        property: prop,\n        value: rawValue,\n        rule: 'hardcoded-value',\n        ...cls,\n      })\n    }\n  }\n\n  return findings\n}\n","import type { Contract } from '../utils/contract-pure.js'\n\nexport interface PropFinding {\n  file: string\n  line: number\n  component: string\n  prop: string\n  level: 'error' | 'info'\n  rule: 'unknown-prop' | 'spread-suppressed'\n  message: string\n}\n\n/** Props always allowed on any cascade component (DOM passthrough / React intrinsics). */\nconst PASSTHROUGH = new Set(['className', 'style', 'id', 'ref', 'key', 'children'])\n\nfunction isPassthrough(prop: string): boolean {\n  if (PASSTHROUGH.has(prop)) return true\n  if (prop.startsWith('data-')) return true\n  if (prop.startsWith('aria-')) return true\n  if (/^on[A-Z]/.test(prop)) return true\n  return false\n}\n\n/** Names imported from @cascivo/react in this source. */\nexport function importedCascadeComponents(source: string): Set<string> {\n  const names = new Set<string>()\n  const importRe = /import\\s*\\{([^}]*)\\}\\s*from\\s*['\"]@cascivo\\/react['\"]/g\n  for (const m of source.matchAll(importRe)) {\n    const group = m[1]\n    if (group === undefined) continue\n    for (const raw of group.split(',')) {\n      const name = raw\n        .trim()\n        .split(/\\s+as\\s+/)[0]\n        ?.trim()\n      if (name) names.add(name)\n    }\n  }\n  return names\n}\n\n/** Find each opening tag for `comp`, returning its attribute substring + start index. */\nexport interface OpeningTag {\n  attrs: string\n  index: number\n  hasSpread: boolean\n}\n\nexport function findOpeningTags(source: string, comp: string): OpeningTag[] {\n  const tags: OpeningTag[] = []\n  const re = new RegExp(`<${comp}(?=[\\\\s/>])`, 'g')\n  for (const m of source.matchAll(re)) {\n    const start = m.index ?? 0\n    // Walk forward to the matching '>' that closes the opening tag, respecting\n    // nested braces (JSX expressions) and quoted strings.\n    let i = start + m[0].length\n    let depth = 0\n    let quote = ''\n    let attrs = ''\n    let closed = false\n    for (; i < source.length; i++) {\n      const ch = source[i]\n      if (quote) {\n        if (ch === quote) quote = ''\n        attrs += ch\n        continue\n      }\n      if (ch === '\"' || ch === \"'\" || ch === '`') {\n        quote = ch\n        attrs += ch\n        continue\n      }\n      if (ch === '{') depth++\n      else if (ch === '}') depth--\n      else if (ch === '>' && depth === 0) {\n        closed = true\n        break\n      }\n      attrs += ch\n    }\n    if (!closed) continue\n    const cleanAttrs = attrs.replace(/\\/$/, '')\n    tags.push({ attrs: cleanAttrs, index: start, hasSpread: /\\{\\s*\\.\\.\\./.test(cleanAttrs) })\n  }\n  return tags\n}\n\n/** Extract top-level attribute names from an opening-tag attribute string. */\nexport function extractAttrNames(attrs: string): string[] {\n  const names: string[] = []\n  let depth = 0\n  let quote = ''\n  let token = ''\n  const flush = () => {\n    const name = token.trim().split('=')[0]?.trim()\n    if (name && /^[A-Za-z]/.test(name)) names.push(name)\n    token = ''\n  }\n  for (let i = 0; i < attrs.length; i++) {\n    const ch = attrs[i]\n    if (ch === undefined) continue\n    if (quote) {\n      if (ch === quote) quote = ''\n      continue\n    }\n    if (ch === '\"' || ch === \"'\" || ch === '`') {\n      quote = ch\n      continue\n    }\n    if (ch === '{') {\n      depth++\n      continue\n    }\n    if (ch === '}') {\n      depth--\n      continue\n    }\n    if (depth > 0) continue\n    if (ch === '=') {\n      flush()\n      // skip the value: handled by quote/brace state on next chars; reset token\n      token = ''\n      continue\n    }\n    if (/\\s/.test(ch)) {\n      if (token.trim()) flush()\n      continue\n    }\n    token += ch\n  }\n  if (token.trim()) flush()\n  return names\n}\n\nexport function lineOf(source: string, index: number): number {\n  let line = 1\n  for (let i = 0; i < index && i < source.length; i++) {\n    if (source[i] === '\\n') line++\n  }\n  return line\n}\n\n/**\n * Check JSX usages of imported cascade components for unknown props.\n * Heuristic — regex/brace-aware scan, not a full AST. Elements using a spread\n * (`{...rest}`) are reported as info and skipped (props can't be statically known).\n */\nexport function findJsxPropViolations(\n  source: string,\n  filename: string,\n  contract: Contract,\n): PropFinding[] {\n  const findings: PropFinding[] = []\n  const tracked = importedCascadeComponents(source)\n\n  for (const comp of tracked) {\n    const info = contract.components.get(comp)\n    if (!info) continue\n    const known = new Set(info.props.map((p) => p.name))\n\n    for (const tag of findOpeningTags(source, comp)) {\n      const line = lineOf(source, tag.index)\n      if (tag.hasSpread) {\n        findings.push({\n          file: filename,\n          line,\n          component: comp,\n          prop: '...',\n          level: 'info',\n          rule: 'spread-suppressed',\n          message: `<${comp}> uses a spread — prop checks skipped`,\n        })\n        continue\n      }\n      for (const name of extractAttrNames(tag.attrs)) {\n        if (isPassthrough(name)) continue\n        if (known.has(name)) continue\n        findings.push({\n          file: filename,\n          line,\n          component: comp,\n          prop: name,\n          level: 'error',\n          rule: 'unknown-prop',\n          message: `<${comp}> has unknown prop \"${name}\"`,\n        })\n      }\n    }\n  }\n\n  return findings\n}\n","import type { Contract } from '../utils/contract-pure.js'\nimport { findOpeningTags, importedCascadeComponents, lineOf } from './jsx-props.js'\n\nexport interface RawStringFinding {\n  file: string\n  line: number\n  component: string\n  text: string\n  level: 'warn'\n  rule: 'raw-string'\n  message: string\n}\n\n/** Looks like English prose worth flagging: ≥2 whitespace-separated words, letters/spaces only. */\nfunction looksLikeProse(text: string): boolean {\n  const trimmed = text.trim()\n  if (!/^[A-Za-z][A-Za-z\\s]*$/.test(trimmed)) return false\n  return trimmed.split(/\\s+/).length >= 2\n}\n\n/**\n * Conservative raw-string check: for cascade components that own user-facing\n * chrome text (intent.content), warn when a literal multi-word English child\n * appears, suggesting the labels prop / i18n. Never errors. Only inspects the\n * immediate text directly after the opening tag (no nested element traversal).\n */\nexport function findRawStringViolations(\n  source: string,\n  filename: string,\n  contract: Contract,\n): RawStringFinding[] {\n  const findings: RawStringFinding[] = []\n  const tracked = importedCascadeComponents(source)\n\n  for (const comp of tracked) {\n    const info = contract.components.get(comp)\n    if (!info?.hasContent) continue\n\n    for (const tag of findOpeningTags(source, comp)) {\n      // Locate the end of this opening tag in the source.\n      const openEnd = source.indexOf('>', tag.index)\n      if (openEnd === -1) continue\n      if (source[openEnd - 1] === '/') continue // self-closing, no children\n\n      // Grab text up to the next tag/expression boundary.\n      const after = source.slice(openEnd + 1)\n      const stop = after.search(/[<{]/)\n      const child = (stop === -1 ? after : after.slice(0, stop)).trim()\n      if (!child || !looksLikeProse(child)) continue\n\n      findings.push({\n        file: filename,\n        line: lineOf(source, openEnd),\n        component: comp,\n        text: child,\n        level: 'warn',\n        rule: 'raw-string',\n        message: `<${comp}> raw text \"${child}\" — use the labels prop / i18n`,\n      })\n    }\n  }\n\n  return findings\n}\n","import type { Contract } from '../utils/contract-pure.js'\nimport {\n  extractAttrNames,\n  findOpeningTags,\n  importedCascadeComponents,\n  lineOf,\n} from './jsx-props.js'\n\nexport interface RequiredPropFinding {\n  file: string\n  line: number\n  component: string\n  prop: string\n  level: 'error'\n  rule: 'missing-prop'\n  message: string\n}\n\n/**\n * Flag cascade elements that omit a prop the component marks required.\n * Elements using a spread are skipped (the prop may arrive via the spread).\n */\nexport function findRequiredPropViolations(\n  source: string,\n  filename: string,\n  contract: Contract,\n): RequiredPropFinding[] {\n  const findings: RequiredPropFinding[] = []\n  const tracked = importedCascadeComponents(source)\n\n  for (const comp of tracked) {\n    const info = contract.components.get(comp)\n    if (!info?.hasRequiredProps) continue\n\n    for (const tag of findOpeningTags(source, comp)) {\n      if (tag.hasSpread) continue\n      const present = new Set(extractAttrNames(tag.attrs))\n      const line = lineOf(source, tag.index)\n      for (const req of info.requiredProps) {\n        if (present.has(req)) continue\n        findings.push({\n          file: filename,\n          line,\n          component: comp,\n          prop: req,\n          level: 'error',\n          rule: 'missing-prop',\n          message: `<${comp}> requires \"${req}\"`,\n        })\n      }\n    }\n  }\n\n  return findings\n}\n","import { existsSync, readFileSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nexport type { BuildContractInput, ComponentInfo, Contract, PropInfo } from './contract-pure.js'\nexport { buildContract, normalizeValue } from './contract-pure.js'\nimport type { Contract } from './contract-pure.js'\nimport { buildContract } from './contract-pure.js'\n\nconst HERE = dirname(fileURLToPath(import.meta.url))\n\n/** Walk up from a start directory looking for the apps/docs/public dir. */\nfunction findDocsPublic(startDir: string): string | null {\n  let dir = startDir\n  for (let i = 0; i < 10; i++) {\n    const candidate = join(dir, 'apps', 'docs', 'public')\n    if (existsSync(candidate)) return candidate\n    dir = join(dir, '..')\n  }\n  return null\n}\n\n/** Walk up from a start directory looking for registry.json at the repo root. */\nfunction findRegistry(startDir: string): string | null {\n  let dir = startDir\n  for (let i = 0; i < 10; i++) {\n    const candidate = join(dir, 'registry.json')\n    if (existsSync(candidate)) return candidate\n    dir = join(dir, '..')\n  }\n  return null\n}\n\n/**\n * Load the published cascade contract from local generated artifacts:\n * - token catalog (apps/docs/public/tokens.catalog.json) → value→token map\n * - registry.json (repo root) → component prop index\n * - context bundle (apps/docs/public/context.json) → which components have chrome text\n */\nexport async function loadContract(options?: {\n  catalogPath?: string\n  contextPath?: string\n  registryPath?: string\n}): Promise<Contract> {\n  const docsPublic = findDocsPublic(HERE) ?? findDocsPublic(process.cwd())\n  const catalogPath =\n    options?.catalogPath ?? (docsPublic ? join(docsPublic, 'tokens.catalog.json') : null)\n  const contextPath = options?.contextPath ?? (docsPublic ? join(docsPublic, 'context.json') : null)\n  const registryPath = options?.registryPath ?? findRegistry(HERE) ?? findRegistry(process.cwd())\n\n  if (!catalogPath || !existsSync(catalogPath)) {\n    throw new Error('token catalog not found (apps/docs/public/tokens.catalog.json)')\n  }\n  if (!registryPath || !existsSync(registryPath)) {\n    throw new Error('registry.json not found')\n  }\n  if (!contextPath || !existsSync(contextPath)) {\n    throw new Error('context bundle not found (apps/docs/public/context.json)')\n  }\n\n  const catalog = JSON.parse(readFileSync(catalogPath, 'utf8')) as Parameters<\n    typeof buildContract\n  >[0]['catalog']\n  const registry = JSON.parse(readFileSync(registryPath, 'utf8')) as Parameters<\n    typeof buildContract\n  >[0]['registry']\n  const context = JSON.parse(readFileSync(contextPath, 'utf8')) as Parameters<\n    typeof buildContract\n  >[0]['context']\n\n  return buildContract({ catalog, registry, context })\n}\n","import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'\nimport { extname, join } from 'node:path'\nimport type { LiteralFinding } from '../audit-ai/css-literals.js'\nimport { findCssLiteralViolations } from '../audit-ai/css-literals.js'\nimport type { PropFinding } from '../audit-ai/jsx-props.js'\nimport { findJsxPropViolations } from '../audit-ai/jsx-props.js'\nimport type { RawStringFinding } from '../audit-ai/raw-strings.js'\nimport { findRawStringViolations } from '../audit-ai/raw-strings.js'\nimport type { RequiredPropFinding } from '../audit-ai/required-props.js'\nimport { findRequiredPropViolations } from '../audit-ai/required-props.js'\nimport type { CascadeConfig } from '../utils/config.js'\nimport type { Contract } from '../utils/contract.js'\nimport { loadContract } from '../utils/contract.js'\n\nexport type Finding = LiteralFinding | PropFinding | RequiredPropFinding | RawStringFinding\n\nconst SKIP_DIRS = new Set(['node_modules', 'dist', '.git', 'build', '.next', 'coverage'])\n\nfunction collectFiles(paths: string[]): string[] {\n  const out: string[] = []\n  const walk = (p: string) => {\n    if (!existsSync(p)) return\n    const s = statSync(p)\n    if (s.isDirectory()) {\n      const base = p.split('/').pop() ?? ''\n      if (SKIP_DIRS.has(base)) return\n      for (const entry of readdirSync(p)) walk(join(p, entry))\n      return\n    }\n    const ext = extname(p)\n    if (ext === '.css' || ext === '.tsx' || ext === '.ts') out.push(p)\n  }\n  for (const p of paths) walk(p)\n  return out\n}\n\nfunction findingsFor(file: string, source: string, contract: Contract): Finding[] {\n  const ext = extname(file)\n  const findings: Finding[] = []\n  if (ext === '.css') {\n    findings.push(...findCssLiteralViolations(source, file, contract))\n  } else if (ext === '.tsx' || ext === '.ts') {\n    findings.push(...findCssLiteralViolations(source, file, contract))\n    findings.push(...findJsxPropViolations(source, file, contract))\n    findings.push(...findRequiredPropViolations(source, file, contract))\n    findings.push(...findRawStringViolations(source, file, contract))\n  }\n  return findings\n}\n\nfunction detail(f: Finding): string {\n  switch (f.rule) {\n    case 'hardcoded-value':\n      if (f.suggestedToken) return `${f.value} → var(${f.suggestedToken})`\n      return `${f.value} → ${f.allMatches?.join(' | ') ?? '(ambiguous)'}`\n    case 'unknown-prop':\n      return `<${f.component} ${f.prop}>`\n    case 'spread-suppressed':\n      return `<${f.component} {...}> (props not checked)`\n    case 'missing-prop':\n      return `<${f.component}> requires \"${f.prop}\"`\n    case 'raw-string':\n      return `\"${f.text}\" → use labels prop / i18n`\n  }\n}\n\nfunction levelLabel(level: Finding['level']): string {\n  return level === 'warn' ? 'warn' : level\n}\n\nfunction renderFindings(findings: Finding[]): void {\n  if (findings.length === 0) {\n    console.log('cascade audit --ai: no findings.')\n    return\n  }\n  const rows = findings.map((f) => ({\n    loc: `${f.file}:${f.line}`,\n    level: levelLabel(f.level),\n    rule: f.rule,\n    detail: detail(f),\n  }))\n  const locW = Math.max(...rows.map((r) => r.loc.length), 8)\n  const lvlW = Math.max(...rows.map((r) => r.level.length), 5)\n  const ruleW = Math.max(...rows.map((r) => r.rule.length), 4)\n  for (const r of rows) {\n    console.log(\n      `${r.loc.padEnd(locW)}  ${r.level.padEnd(lvlW)}  ${r.rule.padEnd(ruleW)}  ${r.detail}`,\n    )\n  }\n  console.log('---')\n  const errors = findings.filter((f) => f.level === 'error').length\n  const warnings = findings.filter((f) => f.level === 'warn').length\n  const infos = findings.filter((f) => f.level === 'info').length\n  const parts = [\n    `${errors} error${errors === 1 ? '' : 's'}`,\n    `${warnings} warning${warnings === 1 ? '' : 's'}`,\n  ]\n  if (infos) parts.push(`${infos} info`)\n  console.log(parts.join(', '))\n}\n\nfunction escapeRe(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\n/**\n * Pure literal→token rewrite. Only rewrites simple `property: #hex;` style\n * declarations where exactly one token matches. Returns the new source and how\n * many findings were resolved (verified by re-running the checker).\n */\nexport function fixCssLiterals(\n  source: string,\n  file: string,\n  contract: Contract,\n): { source: string; fixed: number } {\n  const fixable = findCssLiteralViolations(source, file, contract).filter(\n    (f) => f.level === 'error' && f.suggestedToken && /^#[0-9a-fA-F]{3,8}$/.test(f.value),\n  )\n  let next = source\n  for (const f of fixable) {\n    // Only rewrite a full-value declaration: `prop: #hex;` (or end of block).\n    const re = new RegExp(`(${escapeRe(f.property)}\\\\s*:\\\\s*)${escapeRe(f.value)}(\\\\s*[;}])`, 'gi')\n    next = next.replace(re, `$1var(${f.suggestedToken})$2`)\n  }\n  if (next === source) return { source, fixed: 0 }\n  const remaining = findCssLiteralViolations(next, file, contract).filter(\n    (f) => f.level === 'error' && f.suggestedToken,\n  ).length\n  return { source: next, fixed: fixable.length - remaining }\n}\n\n/** Apply {@link fixCssLiterals} to each .css file on disk. */\nfunction applyFixes(files: string[], contract: Contract): number {\n  let fixed = 0\n  for (const file of files) {\n    if (extname(file) !== '.css') continue\n    const { source, fixed: n } = fixCssLiterals(readFileSync(file, 'utf8'), file, contract)\n    if (n > 0) {\n      writeFileSync(file, source)\n      fixed += n\n    }\n  }\n  return fixed\n}\n\nexport async function audit(args: string[], _config: CascadeConfig): Promise<void> {\n  if (!args.includes('--ai')) {\n    console.log('cascade audit: use --ai to audit AI-generated code against the cascade contract')\n    return\n  }\n\n  const jsonOutput = args.includes('--json')\n  const fixMode = args.includes('--fix')\n  const levelIdx = args.indexOf('--level')\n  const minLevel = levelIdx >= 0 ? (args[levelIdx + 1] ?? 'error') : 'error'\n\n  const paths = args.filter((a, i) => {\n    if (a.startsWith('--')) return false\n    if (levelIdx >= 0 && i === levelIdx + 1) return false\n    return true\n  })\n\n  let contract: Contract\n  try {\n    contract = await loadContract()\n  } catch (e) {\n    console.error(`Contract unavailable: ${e instanceof Error ? e.message : String(e)}`)\n    process.exitCode = 2\n    return\n  }\n\n  const files = collectFiles(paths.length ? paths : [process.cwd()])\n\n  if (fixMode) {\n    const n = applyFixes(files, contract)\n    console.log(`cascade audit --ai --fix: rewrote ${n} literal${n === 1 ? '' : 's'} to tokens.`)\n  }\n\n  const allFindings: Finding[] = []\n  for (const file of files) {\n    allFindings.push(...findingsFor(file, readFileSync(file, 'utf8'), contract))\n  }\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(allFindings, null, 2))\n  } else {\n    renderFindings(allFindings)\n  }\n\n  const hasErrors = allFindings.some((f) => f.level === 'error')\n  if (minLevel === 'error' && hasErrors) process.exitCode = 1\n  if (minLevel === 'warn' && allFindings.some((f) => f.level !== 'info')) process.exitCode = 1\n}\n"],"mappings":"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"}
+{"version":3,"file":"audit-InQqdY1s.mjs","names":[],"sources":["../src/utils/contract-pure.ts","../src/audit-ai/css-literals.ts","../src/audit-ai/jsx-props.ts","../src/audit-ai/raw-strings.ts","../src/audit-ai/required-props.ts","../src/utils/contract.ts","../src/commands/audit.ts"],"sourcesContent":["export interface PropInfo {\n  name: string\n  type: string\n  required: boolean\n}\n\nexport interface ComponentInfo {\n  props: PropInfo[]\n  /** True if any prop has required: true */\n  hasRequiredProps: boolean\n  /** Props that have required: true */\n  requiredProps: string[]\n  /** True if the component declares user-facing chrome text (intent.content) */\n  hasContent: boolean\n}\n\nexport interface Contract {\n  /** Map from normalized color/size value → token names */\n  tokensByValue: Map<string, string[]>\n  /** Map from component name (PascalCase) → component info */\n  components: Map<string, ComponentInfo>\n}\n\ninterface TokenEntry {\n  name: string\n  resolvedDefault: string | null\n}\n\ninterface CatalogFile {\n  tokens: TokenEntry[]\n}\n\ninterface RegistryPropMeta {\n  name: string\n  type?: string\n  required?: boolean\n}\n\ninterface RegistryComponentMeta {\n  name: string\n  props?: RegistryPropMeta[]\n}\n\ninterface RegistryEntry {\n  meta?: RegistryComponentMeta\n}\n\ninterface RegistryFile {\n  components: RegistryEntry[]\n}\n\ninterface ContextComponentEntry {\n  name: string\n  intent?: { content?: unknown }\n}\n\ninterface ContextFile {\n  components: ContextComponentEntry[]\n}\n\nexport interface BuildContractInput {\n  catalog: CatalogFile\n  registry: RegistryFile\n  context: ContextFile\n}\n\n/** Normalize a color/size value for catalog comparison: lowercase, strip spaces. */\nexport function normalizeValue(value: string): string {\n  return value.toLowerCase().replace(/\\s+/g, '')\n}\n\n/** Pure builder — assemble a Contract from already-parsed JSON. Testable without fs. */\nexport function buildContract(input: BuildContractInput): Contract {\n  const tokensByValue = new Map<string, string[]>()\n  for (const token of input.catalog.tokens) {\n    if (token.resolvedDefault == null) continue\n    const key = normalizeValue(token.resolvedDefault)\n    const list = tokensByValue.get(key)\n    if (list) list.push(token.name)\n    else tokensByValue.set(key, [token.name])\n  }\n\n  const contentNames = new Set<string>()\n  for (const c of input.context.components) {\n    if (c.intent?.content) contentNames.add(c.name)\n  }\n\n  const components = new Map<string, ComponentInfo>()\n  for (const entry of input.registry.components) {\n    const meta = entry.meta\n    if (!meta?.name) continue\n    const props: PropInfo[] = (meta.props ?? []).map((p) => ({\n      name: p.name,\n      type: p.type ?? 'unknown',\n      required: p.required === true,\n    }))\n    const requiredProps = props.filter((p) => p.required).map((p) => p.name)\n    components.set(meta.name, {\n      props,\n      requiredProps,\n      hasRequiredProps: requiredProps.length > 0,\n      hasContent: contentNames.has(meta.name),\n    })\n  }\n\n  return { tokensByValue, components }\n}\n","import type { Contract } from '../utils/contract-pure.js'\nimport { normalizeValue } from '../utils/contract-pure.js'\n\nexport interface LiteralFinding {\n  file: string\n  line: number\n  property: string\n  value: string\n  level: 'error' | 'info'\n  rule: 'hardcoded-value'\n  /** only when exactly one catalog match */\n  suggestedToken?: string\n  /** when multiple catalog matches → info */\n  allMatches?: string[]\n}\n\n/** Visual CSS properties whose literal values should be tokens. */\nconst VISUAL_PROPS = new Set([\n  'color',\n  'background',\n  'background-color',\n  'border-color',\n  'box-shadow',\n  'border-radius',\n  'font-size',\n  'gap',\n  'padding',\n  'margin',\n  'width',\n  'height',\n])\n\n/** Inline-style camelCase → kebab-case for the props we care about. */\nconst INLINE_PROP_MAP: Record<string, string> = {\n  color: 'color',\n  background: 'background',\n  backgroundColor: 'background-color',\n  borderColor: 'border-color',\n  boxShadow: 'box-shadow',\n  borderRadius: 'border-radius',\n  fontSize: 'font-size',\n  gap: 'gap',\n  padding: 'padding',\n  margin: 'margin',\n  width: 'width',\n  height: 'height',\n}\n\n/** A literal value worth checking: hex, oklch/rgb/hsl(a), or px/rem number. */\nfunction isLiteralValue(value: string): boolean {\n  const v = value.trim()\n  if (v.includes('var(')) return false\n  if (/^#[0-9a-fA-F]{3,8}$/.test(v)) return true\n  if (/^(oklch|oklab|rgb|rgba|hsl|hsla)\\(/i.test(v)) return true\n  if (/^-?\\d*\\.?\\d+(px|rem)$/.test(v)) return true\n  return false\n}\n\nfunction classify(\n  value: string,\n  contract: Contract,\n): Pick<LiteralFinding, 'level' | 'suggestedToken' | 'allMatches'> | null {\n  const matches = contract.tokensByValue.get(normalizeValue(value))\n  if (!matches || matches.length === 0) return null\n  const first = matches[0]\n  if (matches.length === 1 && first) return { level: 'error', suggestedToken: first }\n  return { level: 'info', allMatches: matches }\n}\n\n/**\n * Detect literal color/size values in CSS declarations and TSX inline styles\n * that exactly match a known cascade token. Heuristic, line-based — no full\n * CSS/JS parse. Values with no catalog match are NOT flagged (arbitrary brand\n * values are allowed).\n */\nexport function findCssLiteralViolations(\n  source: string,\n  filename: string,\n  contract: Contract,\n): LiteralFinding[] {\n  const findings: LiteralFinding[] = []\n  const lines = source.split('\\n')\n\n  // CSS declaration: `property: value;` (also matches the kebab props inside style=\"...\")\n  const cssDecl = /(^|[;{\\s])([a-z-]+)\\s*:\\s*([^;}{]+?)\\s*(?=[;}]|$)/gi\n  // Inline JSX style object: `color: '#fff'` or `color: \"#fff\"`\n  const inlineDecl = /([A-Za-z][A-Za-z]*)\\s*:\\s*(['\"])([^'\"]+)\\2/g\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i]\n    if (line === undefined) continue\n    const seen = new Set<string>()\n\n    for (const m of line.matchAll(cssDecl)) {\n      if (m[2] === undefined || m[3] === undefined) continue\n      const prop = m[2].toLowerCase()\n      const rawValue = m[3].trim()\n      if (!VISUAL_PROPS.has(prop)) continue\n      if (!isLiteralValue(rawValue)) continue\n      const cls = classify(rawValue, contract)\n      if (!cls) continue\n      const key = `${prop}|${rawValue}`\n      seen.add(key)\n      findings.push({\n        file: filename,\n        line: i + 1,\n        property: prop,\n        value: rawValue,\n        rule: 'hardcoded-value',\n        ...cls,\n      })\n    }\n\n    for (const m of line.matchAll(inlineDecl)) {\n      if (m[1] === undefined || m[3] === undefined) continue\n      const prop = INLINE_PROP_MAP[m[1]]\n      if (!prop) continue\n      const rawValue = m[3].trim()\n      if (!isLiteralValue(rawValue)) continue\n      const key = `${prop}|${rawValue}`\n      if (seen.has(key)) continue\n      const cls = classify(rawValue, contract)\n      if (!cls) continue\n      findings.push({\n        file: filename,\n        line: i + 1,\n        property: prop,\n        value: rawValue,\n        rule: 'hardcoded-value',\n        ...cls,\n      })\n    }\n  }\n\n  return findings\n}\n","import type { Contract } from '../utils/contract-pure.js'\n\nexport interface PropFinding {\n  file: string\n  line: number\n  component: string\n  prop: string\n  level: 'error' | 'info'\n  rule: 'unknown-prop' | 'spread-suppressed'\n  message: string\n}\n\n/** Props always allowed on any cascade component (DOM passthrough / React intrinsics). */\nconst PASSTHROUGH = new Set(['className', 'style', 'id', 'ref', 'key', 'children'])\n\nfunction isPassthrough(prop: string): boolean {\n  if (PASSTHROUGH.has(prop)) return true\n  if (prop.startsWith('data-')) return true\n  if (prop.startsWith('aria-')) return true\n  if (/^on[A-Z]/.test(prop)) return true\n  return false\n}\n\n/** Names imported from @cascivo/react in this source. */\nexport function importedCascadeComponents(source: string): Set<string> {\n  const names = new Set<string>()\n  const importRe = /import\\s*\\{([^}]*)\\}\\s*from\\s*['\"]@cascivo\\/react['\"]/g\n  for (const m of source.matchAll(importRe)) {\n    const group = m[1]\n    if (group === undefined) continue\n    for (const raw of group.split(',')) {\n      const name = raw\n        .trim()\n        .split(/\\s+as\\s+/)[0]\n        ?.trim()\n      if (name) names.add(name)\n    }\n  }\n  return names\n}\n\n/** Find each opening tag for `comp`, returning its attribute substring + start index. */\nexport interface OpeningTag {\n  attrs: string\n  index: number\n  hasSpread: boolean\n}\n\nexport function findOpeningTags(source: string, comp: string): OpeningTag[] {\n  const tags: OpeningTag[] = []\n  const re = new RegExp(`<${comp}(?=[\\\\s/>])`, 'g')\n  for (const m of source.matchAll(re)) {\n    const start = m.index ?? 0\n    // Walk forward to the matching '>' that closes the opening tag, respecting\n    // nested braces (JSX expressions) and quoted strings.\n    let i = start + m[0].length\n    let depth = 0\n    let quote = ''\n    let attrs = ''\n    let closed = false\n    for (; i < source.length; i++) {\n      const ch = source[i]\n      if (quote) {\n        if (ch === quote) quote = ''\n        attrs += ch\n        continue\n      }\n      if (ch === '\"' || ch === \"'\" || ch === '`') {\n        quote = ch\n        attrs += ch\n        continue\n      }\n      if (ch === '{') depth++\n      else if (ch === '}') depth--\n      else if (ch === '>' && depth === 0) {\n        closed = true\n        break\n      }\n      attrs += ch\n    }\n    if (!closed) continue\n    const cleanAttrs = attrs.replace(/\\/$/, '')\n    tags.push({ attrs: cleanAttrs, index: start, hasSpread: /\\{\\s*\\.\\.\\./.test(cleanAttrs) })\n  }\n  return tags\n}\n\n/** Extract top-level attribute names from an opening-tag attribute string. */\nexport function extractAttrNames(attrs: string): string[] {\n  const names: string[] = []\n  let depth = 0\n  let quote = ''\n  let token = ''\n  const flush = () => {\n    const name = token.trim().split('=')[0]?.trim()\n    if (name && /^[A-Za-z]/.test(name)) names.push(name)\n    token = ''\n  }\n  for (let i = 0; i < attrs.length; i++) {\n    const ch = attrs[i]\n    if (ch === undefined) continue\n    if (quote) {\n      if (ch === quote) quote = ''\n      continue\n    }\n    if (ch === '\"' || ch === \"'\" || ch === '`') {\n      quote = ch\n      continue\n    }\n    if (ch === '{') {\n      depth++\n      continue\n    }\n    if (ch === '}') {\n      depth--\n      continue\n    }\n    if (depth > 0) continue\n    if (ch === '=') {\n      flush()\n      // skip the value: handled by quote/brace state on next chars; reset token\n      token = ''\n      continue\n    }\n    if (/\\s/.test(ch)) {\n      if (token.trim()) flush()\n      continue\n    }\n    token += ch\n  }\n  if (token.trim()) flush()\n  return names\n}\n\nexport function lineOf(source: string, index: number): number {\n  let line = 1\n  for (let i = 0; i < index && i < source.length; i++) {\n    if (source[i] === '\\n') line++\n  }\n  return line\n}\n\n/**\n * Check JSX usages of imported cascade components for unknown props.\n * Heuristic — regex/brace-aware scan, not a full AST. Elements using a spread\n * (`{...rest}`) are reported as info and skipped (props can't be statically known).\n */\nexport function findJsxPropViolations(\n  source: string,\n  filename: string,\n  contract: Contract,\n): PropFinding[] {\n  const findings: PropFinding[] = []\n  const tracked = importedCascadeComponents(source)\n\n  for (const comp of tracked) {\n    const info = contract.components.get(comp)\n    if (!info) continue\n    const known = new Set(info.props.map((p) => p.name))\n\n    for (const tag of findOpeningTags(source, comp)) {\n      const line = lineOf(source, tag.index)\n      if (tag.hasSpread) {\n        findings.push({\n          file: filename,\n          line,\n          component: comp,\n          prop: '...',\n          level: 'info',\n          rule: 'spread-suppressed',\n          message: `<${comp}> uses a spread — prop checks skipped`,\n        })\n        continue\n      }\n      for (const name of extractAttrNames(tag.attrs)) {\n        if (isPassthrough(name)) continue\n        if (known.has(name)) continue\n        findings.push({\n          file: filename,\n          line,\n          component: comp,\n          prop: name,\n          level: 'error',\n          rule: 'unknown-prop',\n          message: `<${comp}> has unknown prop \"${name}\"`,\n        })\n      }\n    }\n  }\n\n  return findings\n}\n","import type { Contract } from '../utils/contract-pure.js'\nimport { findOpeningTags, importedCascadeComponents, lineOf } from './jsx-props.js'\n\nexport interface RawStringFinding {\n  file: string\n  line: number\n  component: string\n  text: string\n  level: 'warn'\n  rule: 'raw-string'\n  message: string\n}\n\n/** Looks like English prose worth flagging: ≥2 whitespace-separated words, letters/spaces only. */\nfunction looksLikeProse(text: string): boolean {\n  const trimmed = text.trim()\n  if (!/^[A-Za-z][A-Za-z\\s]*$/.test(trimmed)) return false\n  return trimmed.split(/\\s+/).length >= 2\n}\n\n/**\n * Conservative raw-string check: for cascade components that own user-facing\n * chrome text (intent.content), warn when a literal multi-word English child\n * appears, suggesting the labels prop / i18n. Never errors. Only inspects the\n * immediate text directly after the opening tag (no nested element traversal).\n */\nexport function findRawStringViolations(\n  source: string,\n  filename: string,\n  contract: Contract,\n): RawStringFinding[] {\n  const findings: RawStringFinding[] = []\n  const tracked = importedCascadeComponents(source)\n\n  for (const comp of tracked) {\n    const info = contract.components.get(comp)\n    if (!info?.hasContent) continue\n\n    for (const tag of findOpeningTags(source, comp)) {\n      // Locate the end of this opening tag in the source.\n      const openEnd = source.indexOf('>', tag.index)\n      if (openEnd === -1) continue\n      if (source[openEnd - 1] === '/') continue // self-closing, no children\n\n      // Grab text up to the next tag/expression boundary.\n      const after = source.slice(openEnd + 1)\n      const stop = after.search(/[<{]/)\n      const child = (stop === -1 ? after : after.slice(0, stop)).trim()\n      if (!child || !looksLikeProse(child)) continue\n\n      findings.push({\n        file: filename,\n        line: lineOf(source, openEnd),\n        component: comp,\n        text: child,\n        level: 'warn',\n        rule: 'raw-string',\n        message: `<${comp}> raw text \"${child}\" — use the labels prop / i18n`,\n      })\n    }\n  }\n\n  return findings\n}\n","import type { Contract } from '../utils/contract-pure.js'\nimport {\n  extractAttrNames,\n  findOpeningTags,\n  importedCascadeComponents,\n  lineOf,\n} from './jsx-props.js'\n\nexport interface RequiredPropFinding {\n  file: string\n  line: number\n  component: string\n  prop: string\n  level: 'error'\n  rule: 'missing-prop'\n  message: string\n}\n\n/**\n * Flag cascade elements that omit a prop the component marks required.\n * Elements using a spread are skipped (the prop may arrive via the spread).\n */\nexport function findRequiredPropViolations(\n  source: string,\n  filename: string,\n  contract: Contract,\n): RequiredPropFinding[] {\n  const findings: RequiredPropFinding[] = []\n  const tracked = importedCascadeComponents(source)\n\n  for (const comp of tracked) {\n    const info = contract.components.get(comp)\n    if (!info?.hasRequiredProps) continue\n\n    for (const tag of findOpeningTags(source, comp)) {\n      if (tag.hasSpread) continue\n      const present = new Set(extractAttrNames(tag.attrs))\n      const line = lineOf(source, tag.index)\n      for (const req of info.requiredProps) {\n        if (present.has(req)) continue\n        findings.push({\n          file: filename,\n          line,\n          component: comp,\n          prop: req,\n          level: 'error',\n          rule: 'missing-prop',\n          message: `<${comp}> requires \"${req}\"`,\n        })\n      }\n    }\n  }\n\n  return findings\n}\n","import { existsSync, readFileSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nexport type { BuildContractInput, ComponentInfo, Contract, PropInfo } from './contract-pure.js'\nexport { buildContract, normalizeValue } from './contract-pure.js'\nimport type { Contract } from './contract-pure.js'\nimport { buildContract } from './contract-pure.js'\n\nconst HERE = dirname(fileURLToPath(import.meta.url))\n\n/** Walk up from a start directory looking for the apps/site/public dir. */\nfunction findDocsPublic(startDir: string): string | null {\n  let dir = startDir\n  for (let i = 0; i < 10; i++) {\n    const candidate = join(dir, 'apps', 'site', 'public')\n    if (existsSync(candidate)) return candidate\n    dir = join(dir, '..')\n  }\n  return null\n}\n\n/** Walk up from a start directory looking for registry.json at the repo root. */\nfunction findRegistry(startDir: string): string | null {\n  let dir = startDir\n  for (let i = 0; i < 10; i++) {\n    const candidate = join(dir, 'registry.json')\n    if (existsSync(candidate)) return candidate\n    dir = join(dir, '..')\n  }\n  return null\n}\n\n/**\n * Load the published cascade contract from local generated artifacts:\n * - token catalog (apps/site/public/tokens.catalog.json) → value→token map\n * - registry.json (repo root) → component prop index\n * - context bundle (apps/site/public/context.json) → which components have chrome text\n */\nexport async function loadContract(options?: {\n  catalogPath?: string\n  contextPath?: string\n  registryPath?: string\n}): Promise<Contract> {\n  const docsPublic = findDocsPublic(HERE) ?? findDocsPublic(process.cwd())\n  const catalogPath =\n    options?.catalogPath ?? (docsPublic ? join(docsPublic, 'tokens.catalog.json') : null)\n  const contextPath = options?.contextPath ?? (docsPublic ? join(docsPublic, 'context.json') : null)\n  const registryPath = options?.registryPath ?? findRegistry(HERE) ?? findRegistry(process.cwd())\n\n  if (!catalogPath || !existsSync(catalogPath)) {\n    throw new Error('token catalog not found (apps/site/public/tokens.catalog.json)')\n  }\n  if (!registryPath || !existsSync(registryPath)) {\n    throw new Error('registry.json not found')\n  }\n  if (!contextPath || !existsSync(contextPath)) {\n    throw new Error('context bundle not found (apps/site/public/context.json)')\n  }\n\n  const catalog = JSON.parse(readFileSync(catalogPath, 'utf8')) as Parameters<\n    typeof buildContract\n  >[0]['catalog']\n  const registry = JSON.parse(readFileSync(registryPath, 'utf8')) as Parameters<\n    typeof buildContract\n  >[0]['registry']\n  const context = JSON.parse(readFileSync(contextPath, 'utf8')) as Parameters<\n    typeof buildContract\n  >[0]['context']\n\n  return buildContract({ catalog, registry, context })\n}\n","import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'\nimport { extname, join } from 'node:path'\nimport type { LiteralFinding } from '../audit-ai/css-literals.js'\nimport { findCssLiteralViolations } from '../audit-ai/css-literals.js'\nimport type { PropFinding } from '../audit-ai/jsx-props.js'\nimport { findJsxPropViolations } from '../audit-ai/jsx-props.js'\nimport type { RawStringFinding } from '../audit-ai/raw-strings.js'\nimport { findRawStringViolations } from '../audit-ai/raw-strings.js'\nimport type { RequiredPropFinding } from '../audit-ai/required-props.js'\nimport { findRequiredPropViolations } from '../audit-ai/required-props.js'\nimport type { CascadeConfig } from '../utils/config.js'\nimport type { Contract } from '../utils/contract.js'\nimport { loadContract } from '../utils/contract.js'\n\nexport type Finding = LiteralFinding | PropFinding | RequiredPropFinding | RawStringFinding\n\nconst SKIP_DIRS = new Set(['node_modules', 'dist', '.git', 'build', '.next', 'coverage'])\n\nfunction collectFiles(paths: string[]): string[] {\n  const out: string[] = []\n  const walk = (p: string) => {\n    if (!existsSync(p)) return\n    const s = statSync(p)\n    if (s.isDirectory()) {\n      const base = p.split('/').pop() ?? ''\n      if (SKIP_DIRS.has(base)) return\n      for (const entry of readdirSync(p)) walk(join(p, entry))\n      return\n    }\n    const ext = extname(p)\n    if (ext === '.css' || ext === '.tsx' || ext === '.ts') out.push(p)\n  }\n  for (const p of paths) walk(p)\n  return out\n}\n\nfunction findingsFor(file: string, source: string, contract: Contract): Finding[] {\n  const ext = extname(file)\n  const findings: Finding[] = []\n  if (ext === '.css') {\n    findings.push(...findCssLiteralViolations(source, file, contract))\n  } else if (ext === '.tsx' || ext === '.ts') {\n    findings.push(...findCssLiteralViolations(source, file, contract))\n    findings.push(...findJsxPropViolations(source, file, contract))\n    findings.push(...findRequiredPropViolations(source, file, contract))\n    findings.push(...findRawStringViolations(source, file, contract))\n  }\n  return findings\n}\n\nfunction detail(f: Finding): string {\n  switch (f.rule) {\n    case 'hardcoded-value':\n      if (f.suggestedToken) return `${f.value} → var(${f.suggestedToken})`\n      return `${f.value} → ${f.allMatches?.join(' | ') ?? '(ambiguous)'}`\n    case 'unknown-prop':\n      return `<${f.component} ${f.prop}>`\n    case 'spread-suppressed':\n      return `<${f.component} {...}> (props not checked)`\n    case 'missing-prop':\n      return `<${f.component}> requires \"${f.prop}\"`\n    case 'raw-string':\n      return `\"${f.text}\" → use labels prop / i18n`\n  }\n}\n\nfunction levelLabel(level: Finding['level']): string {\n  return level === 'warn' ? 'warn' : level\n}\n\nfunction renderFindings(findings: Finding[]): void {\n  if (findings.length === 0) {\n    console.log('cascade audit --ai: no findings.')\n    return\n  }\n  const rows = findings.map((f) => ({\n    loc: `${f.file}:${f.line}`,\n    level: levelLabel(f.level),\n    rule: f.rule,\n    detail: detail(f),\n  }))\n  const locW = Math.max(...rows.map((r) => r.loc.length), 8)\n  const lvlW = Math.max(...rows.map((r) => r.level.length), 5)\n  const ruleW = Math.max(...rows.map((r) => r.rule.length), 4)\n  for (const r of rows) {\n    console.log(\n      `${r.loc.padEnd(locW)}  ${r.level.padEnd(lvlW)}  ${r.rule.padEnd(ruleW)}  ${r.detail}`,\n    )\n  }\n  console.log('---')\n  const errors = findings.filter((f) => f.level === 'error').length\n  const warnings = findings.filter((f) => f.level === 'warn').length\n  const infos = findings.filter((f) => f.level === 'info').length\n  const parts = [\n    `${errors} error${errors === 1 ? '' : 's'}`,\n    `${warnings} warning${warnings === 1 ? '' : 's'}`,\n  ]\n  if (infos) parts.push(`${infos} info`)\n  console.log(parts.join(', '))\n}\n\nfunction escapeRe(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\n/**\n * Pure literal→token rewrite. Only rewrites simple `property: #hex;` style\n * declarations where exactly one token matches. Returns the new source and how\n * many findings were resolved (verified by re-running the checker).\n */\nexport function fixCssLiterals(\n  source: string,\n  file: string,\n  contract: Contract,\n): { source: string; fixed: number } {\n  const fixable = findCssLiteralViolations(source, file, contract).filter(\n    (f) => f.level === 'error' && f.suggestedToken && /^#[0-9a-fA-F]{3,8}$/.test(f.value),\n  )\n  let next = source\n  for (const f of fixable) {\n    // Only rewrite a full-value declaration: `prop: #hex;` (or end of block).\n    const re = new RegExp(`(${escapeRe(f.property)}\\\\s*:\\\\s*)${escapeRe(f.value)}(\\\\s*[;}])`, 'gi')\n    next = next.replace(re, `$1var(${f.suggestedToken})$2`)\n  }\n  if (next === source) return { source, fixed: 0 }\n  const remaining = findCssLiteralViolations(next, file, contract).filter(\n    (f) => f.level === 'error' && f.suggestedToken,\n  ).length\n  return { source: next, fixed: fixable.length - remaining }\n}\n\n/** Apply {@link fixCssLiterals} to each .css file on disk. */\nfunction applyFixes(files: string[], contract: Contract): number {\n  let fixed = 0\n  for (const file of files) {\n    if (extname(file) !== '.css') continue\n    const { source, fixed: n } = fixCssLiterals(readFileSync(file, 'utf8'), file, contract)\n    if (n > 0) {\n      writeFileSync(file, source)\n      fixed += n\n    }\n  }\n  return fixed\n}\n\nexport async function audit(args: string[], _config: CascadeConfig): Promise<void> {\n  if (!args.includes('--ai')) {\n    console.log('cascivo audit: use --ai to audit AI-generated code against the cascivo contract')\n    return\n  }\n\n  const jsonOutput = args.includes('--json')\n  const fixMode = args.includes('--fix')\n  const levelIdx = args.indexOf('--level')\n  const minLevel = levelIdx >= 0 ? (args[levelIdx + 1] ?? 'error') : 'error'\n\n  const paths = args.filter((a, i) => {\n    if (a.startsWith('--')) return false\n    if (levelIdx >= 0 && i === levelIdx + 1) return false\n    return true\n  })\n\n  let contract: Contract\n  try {\n    contract = await loadContract()\n  } catch (e) {\n    console.error(`Contract unavailable: ${e instanceof Error ? e.message : String(e)}`)\n    process.exitCode = 2\n    return\n  }\n\n  const files = collectFiles(paths.length ? paths : [process.cwd()])\n\n  if (fixMode) {\n    const n = applyFixes(files, contract)\n    console.log(`cascade audit --ai --fix: rewrote ${n} literal${n === 1 ? '' : 's'} to tokens.`)\n  }\n\n  const allFindings: Finding[] = []\n  for (const file of files) {\n    allFindings.push(...findingsFor(file, readFileSync(file, 'utf8'), contract))\n  }\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(allFindings, null, 2))\n  } else {\n    renderFindings(allFindings)\n  }\n\n  const hasErrors = allFindings.some((f) => f.level === 'error')\n  if (minLevel === 'error' && hasErrors) process.exitCode = 1\n  if (minLevel === 'warn' && allFindings.some((f) => f.level !== 'info')) process.exitCode = 1\n}\n"],"mappings":"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"}

package/dist/config-BsyJbMvD.mjs

@@ -0,0 +1,106 @@
+import "node:module";
+import { pathToFileURL } from "node:url";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/utils/config.ts
+var config_exports = /* @__PURE__ */ __exportAll({
+	CASCIVO_HOST: () => CASCIVO_HOST,
+	DEFAULT_CONFIG: () => DEFAULT_CONFIG,
+	THEMES: () => THEMES,
+	applyEnvOverrides: () => applyEnvOverrides,
+	detectPackageManager: () => detectPackageManager,
+	installCommand: () => installCommand,
+	loadConfig: () => loadConfig,
+	resolveConfig: () => resolveConfig
+});
+/**
+* Canonical host for hosted cascivo artifacts (registry.json, per-item
+* r/<name>.json, marketplace.json). docs.cascivo.com mirrors the same tree.
+* Keep in sync with CASCIVO_HOST in packages/mcp.
+*/
+const CASCIVO_HOST = "https://cascivo.com";
+/** All first-party themes shipped by @cascivo/themes (selectable via data-theme). */
+const THEMES = [
+	"light",
+	"dark",
+	"warm",
+	"flat",
+	"minimal",
+	"midnight",
+	"pastel",
+	"brutalist",
+	"corporate",
+	"terminal",
+	"cyberpunk",
+	"arcade"
+];
+const DEFAULT_CONFIG = {
+	registry: `${CASCIVO_HOST}/registry.json`,
+	outputDir: "src/components/ui",
+	theme: "light"
+};
+const CONFIG_FILES = [
+	"cascivo.config.ts",
+	"cascivo.config.js",
+	"cascivo.config.mjs"
+];
+/** Apply defaults over a (possibly partial) user config object. */
+function resolveConfig(partial) {
+	return {
+		...DEFAULT_CONFIG,
+		...partial
+	};
+}
+/** Let env vars override config — used by the MCP server to pass `outputDir`. */
+function applyEnvOverrides(config, env = process.env) {
+	return {
+		...config,
+		...env.CASCIVO_REGISTRY ? { registry: env.CASCIVO_REGISTRY } : {},
+		...env.CASCIVO_OUTPUT_DIR ? { outputDir: env.CASCIVO_OUTPUT_DIR } : {}
+	};
+}
+/**
+* Locate and load `cascivo.config.{ts,js,mjs}` from `cwd`. Falls back to the
+* default config when no file is found or the file cannot be loaded. Env vars
+* (`CASCIVO_REGISTRY`, `CASCIVO_OUTPUT_DIR`) take precedence.
+*/
+async function loadConfig(cwd = process.cwd()) {
+	for (const file of CONFIG_FILES) {
+		const path = join(cwd, file);
+		if (!existsSync(path)) continue;
+		try {
+			const mod = await import(pathToFileURL(path).href);
+			return applyEnvOverrides(resolveConfig(mod.default ?? mod));
+		} catch {
+			return applyEnvOverrides(resolveConfig(null));
+		}
+	}
+	return applyEnvOverrides(resolveConfig(null));
+}
+/** Detect the package manager in use from lock files, defaulting to npm. */
+function detectPackageManager(cwd = process.cwd()) {
+	if (existsSync(join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+	if (existsSync(join(cwd, "yarn.lock"))) return "yarn";
+	if (existsSync(join(cwd, "bun.lockb"))) return "bun";
+	return "npm";
+}
+/** The install subcommand each package manager uses to add dependencies. */
+function installCommand(pm, packages) {
+	return [pm, [pm === "npm" ? "install" : "add", ...packages]];
+}
+//#endregion
+export { detectPackageManager as a, __exportAll as c, config_exports as i, DEFAULT_CONFIG as n, installCommand as o, THEMES as r, loadConfig as s, CASCIVO_HOST as t };
+
+//# sourceMappingURL=config-BsyJbMvD.mjs.map

package/dist/config-BsyJbMvD.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-BsyJbMvD.mjs","names":[],"sources":["../src/utils/config.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { pathToFileURL } from 'node:url'\n\n/**\n * Canonical host for hosted cascivo artifacts (registry.json, per-item\n * r/<name>.json, marketplace.json). docs.cascivo.com mirrors the same tree.\n * Keep in sync with CASCIVO_HOST in packages/mcp.\n */\nexport const CASCIVO_HOST = 'https://cascivo.com'\n\n/** All first-party themes shipped by @cascivo/themes (selectable via data-theme). */\nexport const THEMES = [\n  'light',\n  'dark',\n  'warm',\n  'flat',\n  'minimal',\n  'midnight',\n  'pastel',\n  'brutalist',\n  'corporate',\n  'terminal',\n  'cyberpunk',\n  'arcade',\n] as const\n\nexport type ThemeName = (typeof THEMES)[number]\n\nexport type RegistryNamespaceConfig =\n  | string\n  | { url: string; headers?: Record<string, string>; params?: Record<string, string> }\n\nexport interface CascadeConfig {\n  /** URL of the registry.json index. */\n  registry: string\n  /** Directory (relative to project root) where components are written. */\n  outputDir: string\n  /** Default theme imported by `cascade init`. */\n  theme: ThemeName\n  /** Namespace → registry URL template (with {name} placeholder) or auth config. */\n  registries?: Record<string, RegistryNamespaceConfig>\n  /** Whether to copy test files (*.contract.test.tsx) when adding components. */\n  tests?: boolean\n}\n\nexport const DEFAULT_CONFIG: CascadeConfig = {\n  // Canonical hosted registry index (served from the landing site, documented in\n  // llms.txt). Prefer this over a branch's GitHub raw URL, which 404s for\n  // unauthenticated/private-repo requests and breaks `cascivo list`/`add`.\n  registry: `${CASCIVO_HOST}/registry.json`,\n  outputDir: 'src/components/ui',\n  theme: 'light',\n}\n\nconst CONFIG_FILES = ['cascivo.config.ts', 'cascivo.config.js', 'cascivo.config.mjs']\n\n/** Apply defaults over a (possibly partial) user config object. */\nexport function resolveConfig(partial: Partial<CascadeConfig> | null | undefined): CascadeConfig {\n  return { ...DEFAULT_CONFIG, ...partial }\n}\n\n/** Let env vars override config — used by the MCP server to pass `outputDir`. */\nexport function applyEnvOverrides(\n  config: CascadeConfig,\n  env: NodeJS.ProcessEnv = process.env,\n): CascadeConfig {\n  return {\n    ...config,\n    ...(env.CASCIVO_REGISTRY ? { registry: env.CASCIVO_REGISTRY } : {}),\n    ...(env.CASCIVO_OUTPUT_DIR ? { outputDir: env.CASCIVO_OUTPUT_DIR } : {}),\n  }\n}\n\n/**\n * Locate and load `cascivo.config.{ts,js,mjs}` from `cwd`. Falls back to the\n * default config when no file is found or the file cannot be loaded. Env vars\n * (`CASCIVO_REGISTRY`, `CASCIVO_OUTPUT_DIR`) take precedence.\n */\nexport async function loadConfig(cwd: string = process.cwd()): Promise<CascadeConfig> {\n  for (const file of CONFIG_FILES) {\n    const path = join(cwd, file)\n    if (!existsSync(path)) continue\n    try {\n      const mod = (await import(pathToFileURL(path).href)) as {\n        default?: Partial<CascadeConfig>\n      }\n      return applyEnvOverrides(resolveConfig(mod.default ?? (mod as Partial<CascadeConfig>)))\n    } catch {\n      // Unloadable config (e.g. unsupported TS syntax) — fall back to defaults.\n      return applyEnvOverrides(resolveConfig(null))\n    }\n  }\n  return applyEnvOverrides(resolveConfig(null))\n}\n\nexport type PackageManager = 'pnpm' | 'yarn' | 'npm' | 'bun'\n\n/** Detect the package manager in use from lock files, defaulting to npm. */\nexport function detectPackageManager(cwd: string = process.cwd()): PackageManager {\n  if (existsSync(join(cwd, 'pnpm-lock.yaml'))) return 'pnpm'\n  if (existsSync(join(cwd, 'yarn.lock'))) return 'yarn'\n  if (existsSync(join(cwd, 'bun.lockb'))) return 'bun'\n  return 'npm'\n}\n\n/** The install subcommand each package manager uses to add dependencies. */\nexport function installCommand(pm: PackageManager, packages: string[]): [string, string[]] {\n  const verb = pm === 'npm' ? 'install' : 'add'\n  return [pm, [verb, ...packages]]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,MAAa,eAAe;;AAG5B,MAAa,SAAS;CACpB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAqBA,MAAa,iBAAgC;CAI3C,UAAU,GAAG,aAAa;CAC1B,WAAW;CACX,OAAO;AACT;AAEA,MAAM,eAAe;CAAC;CAAqB;CAAqB;AAAoB;;AAGpF,SAAgB,cAAc,SAAmE;CAC/F,OAAO;EAAE,GAAG;EAAgB,GAAG;CAAQ;AACzC;;AAGA,SAAgB,kBACd,QACA,MAAyB,QAAQ,KAClB;CACf,OAAO;EACL,GAAG;EACH,GAAI,IAAI,mBAAmB,EAAE,UAAU,IAAI,iBAAiB,IAAI,CAAC;EACjE,GAAI,IAAI,qBAAqB,EAAE,WAAW,IAAI,mBAAmB,IAAI,CAAC;CACxE;AACF;;;;;;AAOA,eAAsB,WAAW,MAAc,QAAQ,IAAI,GAA2B;CACpF,KAAK,MAAM,QAAQ,cAAc;EAC/B,MAAM,OAAO,KAAK,KAAK,IAAI;EAC3B,IAAI,CAAC,WAAW,IAAI,GAAG;EACvB,IAAI;GACF,MAAM,MAAO,MAAM,OAAO,cAAc,IAAI,CAAC,CAAC;GAG9C,OAAO,kBAAkB,cAAc,IAAI,WAAY,GAA8B,CAAC;EACxF,QAAQ;GAEN,OAAO,kBAAkB,cAAc,IAAI,CAAC;EAC9C;CACF;CACA,OAAO,kBAAkB,cAAc,IAAI,CAAC;AAC9C;;AAKA,SAAgB,qBAAqB,MAAc,QAAQ,IAAI,GAAmB;CAChF,IAAI,WAAW,KAAK,KAAK,gBAAgB,CAAC,GAAG,OAAO;CACpD,IAAI,WAAW,KAAK,KAAK,WAAW,CAAC,GAAG,OAAO;CAC/C,IAAI,WAAW,KAAK,KAAK,WAAW,CAAC,GAAG,OAAO;CAC/C,OAAO;AACT;;AAGA,SAAgB,eAAe,IAAoB,UAAwC;CAEzF,OAAO,CAAC,IAAI,CADC,OAAO,QAAQ,YAAY,OACrB,GAAG,QAAQ,CAAC;AACjC"}

package/dist/drift-Ciw5qeEt.mjs

@@ -0,0 +1,56 @@
+import { t as readFileSafe } from "./fs-m7ZvuBBm.mjs";
+import { i as sha256, l as findComponent, r as readLock, s as fetchRegistry, t as checkPeerVersions } from "./peer-versions-B2bCgko-.mjs";
+//#region src/commands/drift.ts
+/**
+* `cascivo doctor --drift` — compares installed components against the
+* registry. Two drift classes:
+*
+*  1. Local-edit drift: an installed file's content no longer matches what
+*     was copied at install time (hand edits, or deleted after install).
+*  2. Peer-version drift: the currently-registered component source needs a
+*     newer `@cascivo/*` peer package (per `peerVersions`) than what's
+*     actually installed in node_modules — the dashboard-feedback failure
+*     mode (DataTable referencing an i18n builtin key an older published
+*     @cascivo/i18n build doesn't have).
+*/
+async function runDoctorDrift(config, cwd = process.cwd()) {
+	const lock = await readLock(cwd);
+	if (!lock || Object.keys(lock.items).length === 0) {
+		console.log("No installed components found in cascivo.lock.");
+		return;
+	}
+	const registry = await fetchRegistry(config.registry);
+	let driftCount = 0;
+	for (const [name, entry] of Object.entries(lock.items)) {
+		const current = findComponent(registry, name);
+		if (!current) continue;
+		for (const [path, lockedHash] of Object.entries(entry.files)) {
+			const content = await readFileSafe(path);
+			if (content === null) {
+				console.log(`${name}: ${path} is missing (installed, then deleted)`);
+				driftCount++;
+				continue;
+			}
+			if (sha256(content) !== lockedHash) {
+				console.log(`${name}: ${path} has local edits (differs from the version installed)`);
+				driftCount++;
+			}
+		}
+		if (current.peerVersions) {
+			const violations = await checkPeerVersions(cwd, current.peerVersions);
+			for (const v of violations) {
+				const installedDesc = v.installed ? `${v.installed} is installed` : "it is not installed";
+				console.log(`${name}: needs ${v.pkg} ${v.required}, but ${installedDesc}.`);
+				driftCount++;
+			}
+		}
+	}
+	if (driftCount > 0) {
+		console.log(`\n${driftCount} drift issue(s) found.`);
+		process.exitCode = 1;
+	} else console.log("No drift detected — installed components match the registry.");
+}
+//#endregion
+export { runDoctorDrift };
+
+//# sourceMappingURL=drift-Ciw5qeEt.mjs.map

package/dist/drift-Ciw5qeEt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-Ciw5qeEt.mjs","names":[],"sources":["../src/commands/drift.ts"],"sourcesContent":["import type { CascadeConfig } from '../utils/config.js'\nimport { readFileSafe } from '../utils/fs.js'\nimport { readLock, sha256 } from '../utils/lock.js'\nimport { checkPeerVersions } from '../utils/peer-versions.js'\nimport { fetchRegistry, findComponent } from '../utils/registry.js'\n\n/**\n * `cascivo doctor --drift` — compares installed components against the\n * registry. Two drift classes:\n *\n *  1. Local-edit drift: an installed file's content no longer matches what\n *     was copied at install time (hand edits, or deleted after install).\n *  2. Peer-version drift: the currently-registered component source needs a\n *     newer `@cascivo/*` peer package (per `peerVersions`) than what's\n *     actually installed in node_modules — the dashboard-feedback failure\n *     mode (DataTable referencing an i18n builtin key an older published\n *     @cascivo/i18n build doesn't have).\n */\nexport async function runDoctorDrift(\n  config: CascadeConfig,\n  cwd: string = process.cwd(),\n): Promise<void> {\n  const lock = await readLock(cwd)\n  if (!lock || Object.keys(lock.items).length === 0) {\n    console.log('No installed components found in cascivo.lock.')\n    return\n  }\n\n  const registry = await fetchRegistry(config.registry)\n  let driftCount = 0\n\n  for (const [name, entry] of Object.entries(lock.items)) {\n    const current = findComponent(registry, name)\n    if (!current) continue\n\n    for (const [path, lockedHash] of Object.entries(entry.files)) {\n      const content = await readFileSafe(path)\n      if (content === null) {\n        console.log(`${name}: ${path} is missing (installed, then deleted)`)\n        driftCount++\n        continue\n      }\n      if (sha256(content) !== lockedHash) {\n        console.log(`${name}: ${path} has local edits (differs from the version installed)`)\n        driftCount++\n      }\n    }\n\n    if (current.peerVersions) {\n      const violations = await checkPeerVersions(cwd, current.peerVersions)\n      for (const v of violations) {\n        const installedDesc = v.installed ? `${v.installed} is installed` : 'it is not installed'\n        console.log(`${name}: needs ${v.pkg} ${v.required}, but ${installedDesc}.`)\n        driftCount++\n      }\n    }\n  }\n\n  if (driftCount > 0) {\n    console.log(`\\n${driftCount} drift issue(s) found.`)\n    process.exitCode = 1\n  } else {\n    console.log('No drift detected — installed components match the registry.')\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,eAAsB,eACpB,QACA,MAAc,QAAQ,IAAI,GACX;CACf,MAAM,OAAO,MAAM,SAAS,GAAG;CAC/B,IAAI,CAAC,QAAQ,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,WAAW,GAAG;EACjD,QAAQ,IAAI,gDAAgD;EAC5D;CACF;CAEA,MAAM,WAAW,MAAM,cAAc,OAAO,QAAQ;CACpD,IAAI,aAAa;CAEjB,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,KAAK,KAAK,GAAG;EACtD,MAAM,UAAU,cAAc,UAAU,IAAI;EAC5C,IAAI,CAAC,SAAS;EAEd,KAAK,MAAM,CAAC,MAAM,eAAe,OAAO,QAAQ,MAAM,KAAK,GAAG;GAC5D,MAAM,UAAU,MAAM,aAAa,IAAI;GACvC,IAAI,YAAY,MAAM;IACpB,QAAQ,IAAI,GAAG,KAAK,IAAI,KAAK,sCAAsC;IACnE;IACA;GACF;GACA,IAAI,OAAO,OAAO,MAAM,YAAY;IAClC,QAAQ,IAAI,GAAG,KAAK,IAAI,KAAK,sDAAsD;IACnF;GACF;EACF;EAEA,IAAI,QAAQ,cAAc;GACxB,MAAM,aAAa,MAAM,kBAAkB,KAAK,QAAQ,YAAY;GACpE,KAAK,MAAM,KAAK,YAAY;IAC1B,MAAM,gBAAgB,EAAE,YAAY,GAAG,EAAE,UAAU,iBAAiB;IACpE,QAAQ,IAAI,GAAG,KAAK,UAAU,EAAE,IAAI,GAAG,EAAE,SAAS,QAAQ,cAAc,EAAE;IAC1E;GACF;EACF;CACF;CAEA,IAAI,aAAa,GAAG;EAClB,QAAQ,IAAI,KAAK,WAAW,uBAAuB;EACnD,QAAQ,WAAW;CACrB,OACE,QAAQ,IAAI,8DAA8D;AAE9E"}

package/dist/{eject-D_mC1lsq.mjs → eject-Br8V7I3m.mjs}

@@ -1,4 +1,4 @@
-import { t as fetchJson } from "./http-CLkdTpxD.mjs";
+import { t as fetchJson } from "./http-CJZ5W0Fa.mjs";
 import { fileURLToPath } from "node:url";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -48,7 +48,7 @@ function loadRegistry(config) {
 	return fetchJson(config.registry);
 }
 function loadCatalog(config) {
-	const local = findUp(HERE, join("apps", "docs", "public", "tokens.catalog.json")) ?? findUp(process.cwd(), join("apps", "docs", "public", "tokens.catalog.json"));
+	const local = findUp(HERE, join("apps", "site", "public", "tokens.catalog.json")) ?? findUp(process.cwd(), join("apps", "site", "public", "tokens.catalog.json"));
 	if (local) return JSON.parse(readFileSync(local, "utf8"));
 	return fetchJson(config.registry.replace(/registry\.json$/, "tokens.catalog.json"));
 }
@@ -113,4 +113,4 @@ async function eject(args, config, options = {}) {
 //#endregion
 export { eject };
 
-//# sourceMappingURL=eject-D_mC1lsq.mjs.map
+//# sourceMappingURL=eject-Br8V7I3m.mjs.map

package/dist/{eject-D_mC1lsq.mjs.map → eject-Br8V7I3m.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"eject-D_mC1lsq.mjs","names":[],"sources":["../src/commands/eject.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { mkdir, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport type { CascadeConfig } from '../utils/config.js'\nimport { fetchJson } from '../utils/http.js'\n\nconst HERE = dirname(fileURLToPath(import.meta.url))\n\nexport interface EjectToken {\n  name: string\n  /** Resolved starting value (light theme), or null when unknown. */\n  value: string | null\n}\n\ninterface RegistryComponentMeta {\n  name: string\n  tokens?: string[]\n}\ninterface RegistryEntry {\n  name: string\n  type?: string\n  meta?: RegistryComponentMeta\n}\ninterface RegistryFile {\n  components: RegistryEntry[]\n}\ninterface CatalogEntry {\n  name: string\n  value?: string\n  resolvedDefault?: string | null\n}\ninterface CatalogFile {\n  tokens: CatalogEntry[]\n}\n\n/**\n * Build a scoped, locally-owned token-override stylesheet. The component itself\n * stays imported from `@cascivo/react`; only the listed token values are\n * ejected so they can be tuned without copying the whole component in.\n *\n * The block is intentionally *unlayered*: unlayered declarations win over the\n * themed `@layer cascivo.theme` values, so the override always takes effect.\n */\nexport function buildOverrideCss(opts: {\n  component: string\n  scope: string\n  tokens: EjectToken[]\n}): string {\n  const { component, scope, tokens } = opts\n  const lines: string[] = []\n  lines.push(`/* cascivo eject — ${component}`)\n  lines.push(' *')\n  lines.push(` * Locally-owned token overrides. ${component} is still imported from`)\n  lines.push(' * @cascivo/react — only these token values are ejected so you can tune them')\n  lines.push(' * without copying the whole component into your repo.')\n  lines.push(' *')\n  lines.push(' * Unlayered, so these win over the themed layer values. Apply the scope by')\n  lines.push(` * adding the selector to the subtree you want to affect, e.g.`)\n  lines.push(` *   <div data-cascivo-eject=\"${component}\">…</div>`)\n  lines.push(' */')\n  lines.push(`${scope} {`)\n  for (const t of tokens) {\n    if (t.value === null) {\n      lines.push(`  /* ${t.name}: set a value — resolves per theme by default */`)\n    } else {\n      lines.push(`  ${t.name}: ${t.value};`)\n    }\n  }\n  lines.push('}')\n  return lines.join('\\n') + '\\n'\n}\n\n/** Walk up from a start dir looking for a file/dir match. */\nfunction findUp(startDir: string, rel: string): string | null {\n  let dir = startDir\n  for (let i = 0; i < 10; i++) {\n    const candidate = join(dir, rel)\n    if (existsSync(candidate)) return candidate\n    dir = join(dir, '..')\n  }\n  return null\n}\n\nfunction loadRegistry(config: CascadeConfig): Promise<RegistryFile> | RegistryFile {\n  const local = findUp(HERE, 'registry.json') ?? findUp(process.cwd(), 'registry.json')\n  if (local) return JSON.parse(readFileSync(local, 'utf8')) as RegistryFile\n  return fetchJson(config.registry) as Promise<RegistryFile>\n}\n\nfunction loadCatalog(config: CascadeConfig): Promise<CatalogFile> | CatalogFile {\n  const local =\n    findUp(HERE, join('apps', 'docs', 'public', 'tokens.catalog.json')) ??\n    findUp(process.cwd(), join('apps', 'docs', 'public', 'tokens.catalog.json'))\n  if (local) return JSON.parse(readFileSync(local, 'utf8')) as CatalogFile\n  const catalogUrl = config.registry.replace(/registry\\.json$/, 'tokens.catalog.json')\n  return fetchJson(catalogUrl) as Promise<CatalogFile>\n}\n\ninterface EjectOptions {\n  tokens?: string[]\n  scope?: string\n  out?: string\n  dryRun?: boolean\n}\n\n/**\n * `cascivo eject <component> [--tokens a,b] [--scope sel] [--out file]`\n *\n * Ejects a targeted slice of a component — specific design tokens — into a\n * scoped local override file, instead of copying the whole component.\n */\nexport async function eject(\n  args: string[],\n  config: CascadeConfig,\n  options: EjectOptions = {},\n): Promise<void> {\n  const component = args.find((a) => !a.startsWith('--'))\n  if (!component) {\n    console.error(\n      'Usage: cascivo eject <component> [--tokens a,b] [--scope <selector>] [--out <file>]',\n    )\n    process.exitCode = 1\n    return\n  }\n\n  const registry = await loadRegistry(config)\n  const entry = registry.components.find((c) => c.name === component)\n  if (!entry) {\n    console.error(`Component \"${component}\" not found in the registry.`)\n    process.exitCode = 1\n    return\n  }\n\n  const available = entry.meta?.tokens ?? []\n  if (available.length === 0) {\n    console.error(`Component \"${component}\" declares no tokens to eject.`)\n    process.exitCode = 1\n    return\n  }\n\n  let selected = available\n  if (options.tokens && options.tokens.length > 0) {\n    const unknown = options.tokens.filter((t) => !available.includes(t))\n    if (unknown.length > 0) {\n      console.error(\n        `These tokens are not used by \"${component}\": ${unknown.join(', ')}\\n` +\n          `Available: ${available.join(', ')}`,\n      )\n      process.exitCode = 1\n      return\n    }\n    selected = options.tokens\n  }\n\n  const catalog = await loadCatalog(config)\n  const valueOf = new Map(\n    catalog.tokens.map((t) => [t.name, t.resolvedDefault ?? t.value ?? null] as const),\n  )\n  const tokens: EjectToken[] = selected.map((name) => ({ name, value: valueOf.get(name) ?? null }))\n\n  const scope = options.scope ?? `[data-cascivo-eject='${component}']`\n  const css = buildOverrideCss({ component, scope, tokens })\n\n  if (options.dryRun) {\n    console.log(css)\n    return\n  }\n\n  const out = options.out ?? join('src', 'styles', `cascivo-${component}.overrides.css`)\n  await mkdir(dirname(out), { recursive: true })\n  await writeFile(out, css)\n  console.log(`Ejected ${tokens.length} token(s) for \"${component}\" → ${out}`)\n  console.log(`Import it after your theme CSS, then add the scope:`)\n  console.log(`  import './${out.replace(/\\\\/g, '/')}'`)\n  console.log(`  <div data-cascivo-eject=\"${component}\">…</div>`)\n}\n"],"mappings":"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"}
+{"version":3,"file":"eject-Br8V7I3m.mjs","names":[],"sources":["../src/commands/eject.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { mkdir, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport type { CascadeConfig } from '../utils/config.js'\nimport { fetchJson } from '../utils/http.js'\n\nconst HERE = dirname(fileURLToPath(import.meta.url))\n\nexport interface EjectToken {\n  name: string\n  /** Resolved starting value (light theme), or null when unknown. */\n  value: string | null\n}\n\ninterface RegistryComponentMeta {\n  name: string\n  tokens?: string[]\n}\ninterface RegistryEntry {\n  name: string\n  type?: string\n  meta?: RegistryComponentMeta\n}\ninterface RegistryFile {\n  components: RegistryEntry[]\n}\ninterface CatalogEntry {\n  name: string\n  value?: string\n  resolvedDefault?: string | null\n}\ninterface CatalogFile {\n  tokens: CatalogEntry[]\n}\n\n/**\n * Build a scoped, locally-owned token-override stylesheet. The component itself\n * stays imported from `@cascivo/react`; only the listed token values are\n * ejected so they can be tuned without copying the whole component in.\n *\n * The block is intentionally *unlayered*: unlayered declarations win over the\n * themed `@layer cascivo.theme` values, so the override always takes effect.\n */\nexport function buildOverrideCss(opts: {\n  component: string\n  scope: string\n  tokens: EjectToken[]\n}): string {\n  const { component, scope, tokens } = opts\n  const lines: string[] = []\n  lines.push(`/* cascivo eject — ${component}`)\n  lines.push(' *')\n  lines.push(` * Locally-owned token overrides. ${component} is still imported from`)\n  lines.push(' * @cascivo/react — only these token values are ejected so you can tune them')\n  lines.push(' * without copying the whole component into your repo.')\n  lines.push(' *')\n  lines.push(' * Unlayered, so these win over the themed layer values. Apply the scope by')\n  lines.push(` * adding the selector to the subtree you want to affect, e.g.`)\n  lines.push(` *   <div data-cascivo-eject=\"${component}\">…</div>`)\n  lines.push(' */')\n  lines.push(`${scope} {`)\n  for (const t of tokens) {\n    if (t.value === null) {\n      lines.push(`  /* ${t.name}: set a value — resolves per theme by default */`)\n    } else {\n      lines.push(`  ${t.name}: ${t.value};`)\n    }\n  }\n  lines.push('}')\n  return lines.join('\\n') + '\\n'\n}\n\n/** Walk up from a start dir looking for a file/dir match. */\nfunction findUp(startDir: string, rel: string): string | null {\n  let dir = startDir\n  for (let i = 0; i < 10; i++) {\n    const candidate = join(dir, rel)\n    if (existsSync(candidate)) return candidate\n    dir = join(dir, '..')\n  }\n  return null\n}\n\nfunction loadRegistry(config: CascadeConfig): Promise<RegistryFile> | RegistryFile {\n  const local = findUp(HERE, 'registry.json') ?? findUp(process.cwd(), 'registry.json')\n  if (local) return JSON.parse(readFileSync(local, 'utf8')) as RegistryFile\n  return fetchJson(config.registry) as Promise<RegistryFile>\n}\n\nfunction loadCatalog(config: CascadeConfig): Promise<CatalogFile> | CatalogFile {\n  const local =\n    findUp(HERE, join('apps', 'site', 'public', 'tokens.catalog.json')) ??\n    findUp(process.cwd(), join('apps', 'site', 'public', 'tokens.catalog.json'))\n  if (local) return JSON.parse(readFileSync(local, 'utf8')) as CatalogFile\n  const catalogUrl = config.registry.replace(/registry\\.json$/, 'tokens.catalog.json')\n  return fetchJson(catalogUrl) as Promise<CatalogFile>\n}\n\ninterface EjectOptions {\n  tokens?: string[]\n  scope?: string\n  out?: string\n  dryRun?: boolean\n}\n\n/**\n * `cascivo eject <component> [--tokens a,b] [--scope sel] [--out file]`\n *\n * Ejects a targeted slice of a component — specific design tokens — into a\n * scoped local override file, instead of copying the whole component.\n */\nexport async function eject(\n  args: string[],\n  config: CascadeConfig,\n  options: EjectOptions = {},\n): Promise<void> {\n  const component = args.find((a) => !a.startsWith('--'))\n  if (!component) {\n    console.error(\n      'Usage: cascivo eject <component> [--tokens a,b] [--scope <selector>] [--out <file>]',\n    )\n    process.exitCode = 1\n    return\n  }\n\n  const registry = await loadRegistry(config)\n  const entry = registry.components.find((c) => c.name === component)\n  if (!entry) {\n    console.error(`Component \"${component}\" not found in the registry.`)\n    process.exitCode = 1\n    return\n  }\n\n  const available = entry.meta?.tokens ?? []\n  if (available.length === 0) {\n    console.error(`Component \"${component}\" declares no tokens to eject.`)\n    process.exitCode = 1\n    return\n  }\n\n  let selected = available\n  if (options.tokens && options.tokens.length > 0) {\n    const unknown = options.tokens.filter((t) => !available.includes(t))\n    if (unknown.length > 0) {\n      console.error(\n        `These tokens are not used by \"${component}\": ${unknown.join(', ')}\\n` +\n          `Available: ${available.join(', ')}`,\n      )\n      process.exitCode = 1\n      return\n    }\n    selected = options.tokens\n  }\n\n  const catalog = await loadCatalog(config)\n  const valueOf = new Map(\n    catalog.tokens.map((t) => [t.name, t.resolvedDefault ?? t.value ?? null] as const),\n  )\n  const tokens: EjectToken[] = selected.map((name) => ({ name, value: valueOf.get(name) ?? null }))\n\n  const scope = options.scope ?? `[data-cascivo-eject='${component}']`\n  const css = buildOverrideCss({ component, scope, tokens })\n\n  if (options.dryRun) {\n    console.log(css)\n    return\n  }\n\n  const out = options.out ?? join('src', 'styles', `cascivo-${component}.overrides.css`)\n  await mkdir(dirname(out), { recursive: true })\n  await writeFile(out, css)\n  console.log(`Ejected ${tokens.length} token(s) for \"${component}\" → ${out}`)\n  console.log(`Import it after your theme CSS, then add the scope:`)\n  console.log(`  import './${out.replace(/\\\\/g, '/')}'`)\n  console.log(`  <div data-cascivo-eject=\"${component}\">…</div>`)\n}\n"],"mappings":"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"}

package/dist/fs-m7ZvuBBm.mjs

@@ -0,0 +1,24 @@
+import { dirname, join, resolve } from "node:path";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+//#region src/utils/fs.ts
+/** Resolve where a component file should be written. */
+function resolveOutputPath(outputDir, component, file, cwd = process.cwd()) {
+	return join(resolve(cwd, outputDir), component, file);
+}
+/** Write a file, creating parent directories as needed. */
+async function writeFileSafe(path, content) {
+	await mkdir(dirname(path), { recursive: true });
+	await writeFile(path, content, "utf8");
+}
+/** Read a file, returning null if it does not exist. */
+async function readFileSafe(path) {
+	try {
+		return await readFile(path, "utf8");
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { resolveOutputPath as n, writeFileSafe as r, readFileSafe as t };
+
+//# sourceMappingURL=fs-m7ZvuBBm.mjs.map

package/dist/fs-m7ZvuBBm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-m7ZvuBBm.mjs","names":[],"sources":["../src/utils/fs.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from 'node:fs/promises'\nimport { dirname, join, resolve } from 'node:path'\n\n/** Resolve where a component file should be written. */\nexport function resolveOutputPath(\n  outputDir: string,\n  component: string,\n  file: string,\n  cwd: string = process.cwd(),\n): string {\n  return join(resolve(cwd, outputDir), component, file)\n}\n\n/** Write a file, creating parent directories as needed. */\nexport async function writeFileSafe(path: string, content: string): Promise<void> {\n  await mkdir(dirname(path), { recursive: true })\n  await writeFile(path, content, 'utf8')\n}\n\n/** Read a file, returning null if it does not exist. */\nexport async function readFileSafe(path: string): Promise<string | null> {\n  try {\n    return await readFile(path, 'utf8')\n  } catch {\n    return null\n  }\n}\n"],"mappings":";;;;AAIA,SAAgB,kBACd,WACA,WACA,MACA,MAAc,QAAQ,IAAI,GAClB;CACR,OAAO,KAAK,QAAQ,KAAK,SAAS,GAAG,WAAW,IAAI;AACtD;;AAGA,eAAsB,cAAc,MAAc,SAAgC;CAChF,MAAM,MAAM,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;CAC9C,MAAM,UAAU,MAAM,SAAS,MAAM;AACvC;;AAGA,eAAsB,aAAa,MAAsC;CACvE,IAAI;EACF,OAAO,MAAM,SAAS,MAAM,MAAM;CACpC,QAAQ;EACN,OAAO;CACT;AACF"}