@aperant/framework 0.6.2

package/dist/cli/design/extract.mjs

@@ -0,0 +1,297 @@
+/**
+ * design/extract.mjs — Pure, text-only token extractors for C27.
+ *
+ * Every function in this module takes a single UTF-8 string and returns a
+ * plain object of sorted, deduped string arrays matching the relevant slice
+ * of DesignTokensSchema. No filesystem access, no side effects — the scan
+ * orchestrator in `scan.mjs` is responsible for reading files and merging
+ * extractor results across the project.
+ *
+ * Extraction strategy is deliberately regex-based (not AST / CSS parser) so
+ * the command stays zero-dep and runs fast on brownfield codebases. Accuracy
+ * vs. completeness trade-offs are documented in `docs/design-tokens.md` under
+ * "v1 limits".
+ *
+ * The regex constants are exported so unit tests can assert against them
+ * individually and so downstream skills can re-use them for LLM prompt
+ * context without re-typing the patterns.
+ */
+// --- Colors -----------------------------------------------------------------
+// Hex: 3/4/6/8-digit. Anchored to a non-word boundary on the left to avoid
+// matching inside identifiers like `#foo123abcdef`; `\b` after the hex chars
+// rules out `#abcdefgh`.
+export const HEX_COLOR_RE = /(?<![\w#])#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})\b/g;
+// rgb/rgba/hsl/hsla functional forms — match the whole `rgb(...)` expression.
+export const RGB_HSL_RE = /\b(rgba?|hsla?)\(\s*[^)]*\)/gi;
+// Tailwind palette: 13 utility prefixes × 22 canonical colors × 11 shades.
+// We also accept prefix+color without a shade (`bg-white`, `text-black`) for
+// the neutrals Tailwind names without a number. The capture groups are
+// discarded — we store the full `color-shade` fragment (e.g. `slate-900`).
+const TW_UTIL_PREFIX = 'bg|text|border|ring|from|to|via|fill|stroke|outline|divide|placeholder|caret|accent|decoration';
+const TW_COLOR_NAME = 'slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose';
+const TW_SHADE = '50|100|200|300|400|500|600|700|800|900|950';
+export const TW_COLOR_RE = new RegExp(`\\b(?:${TW_UTIL_PREFIX})-(?:(?:${TW_COLOR_NAME})-(?:${TW_SHADE})|white|black|transparent|current|inherit)\\b`, 'g');
+// CSS custom property NAMES that look like color tokens. We only capture the
+// identifier (`--color-primary`), not the value, since value shapes vary and
+// the color extractor above already catches hex / rgb / hsl values.
+export const CSS_COLOR_VAR_RE = /--color-[a-z0-9][a-z0-9-]*/g;
+/**
+ * Extract colors from a text blob.
+ * @param {string} text
+ * @returns {{hex: string[], rgb: string[], hsl: string[], tailwind: string[], css_vars: string[]}}
+ */
+export function extractColors(text) {
+    const hex = new Set();
+    const rgb = new Set();
+    const hsl = new Set();
+    const tailwind = new Set();
+    const cssVars = new Set();
+    for (const m of text.matchAll(HEX_COLOR_RE))
+        hex.add(m[0].toLowerCase());
+    for (const m of text.matchAll(RGB_HSL_RE)) {
+        // Collapse internal whitespace so `rgb( 0 , 0 , 0 )` and `rgb(0,0,0)`
+        // dedup cleanly. Trailing-comma variants (rgb(0 0 0 / 0.5)) are left
+        // untouched — the raw matched value is what a reader sees in source.
+        const normalized = m[0].replace(/\s+/g, ' ').trim().toLowerCase();
+        if (/^hsla?/.test(normalized))
+            hsl.add(normalized);
+        else
+            rgb.add(normalized);
+    }
+    for (const m of text.matchAll(TW_COLOR_RE)) {
+        // Strip the utility prefix so `bg-slate-900` and `text-slate-900` both
+        // record as `slate-900` — consumers want the palette token, not every
+        // utility that uses it.
+        const value = m[0].replace(new RegExp(`^(?:${TW_UTIL_PREFIX})-`), '');
+        tailwind.add(value);
+    }
+    for (const m of text.matchAll(CSS_COLOR_VAR_RE))
+        cssVars.add(m[0]);
+    return {
+        hex: [...hex].sort(),
+        rgb: [...rgb].sort(),
+        hsl: [...hsl].sort(),
+        tailwind: [...tailwind].sort(),
+        css_vars: [...cssVars].sort(),
+    };
+}
+// --- Spacing ----------------------------------------------------------------
+// Raw length: integer or decimal, px / rem / em, with optional leading sign.
+// The preceding char must not be a word-char so `16px` matches but
+// `foo16px` does not. Upper-bounded at 4 digits to skip implausible values.
+export const RAW_LENGTH_RE = /(?<![\w.-])-?(?:\d{1,4}(?:\.\d{1,3})?)(px|rem|em)\b/g;
+// Tailwind spacing utilities. Captures the numeric scale token (`4`, `2.5`,
+// `px`, `auto`). Utility prefix set deliberately wider than colors because
+// Tailwind uses the spacing scale for many properties.
+//
+// The class must be preceded by a class-context boundary (start, whitespace,
+// or the usual JSX/HTML className delimiters). This stops identifier-embedded
+// collisions like `wt-001` (where `w` + `-001` would otherwise match the
+// `w-\d+` shape for `width` utilities). The numeric value also rejects
+// leading zeros on multi-digit integers (Tailwind uses `0`, not `00`),
+// further narrowing false positives.
+const TW_SPACING_PREFIX = 'p|m|gap|space|inset|top|right|bottom|left|w|h|min-w|max-w|min-h|max-h';
+const TW_SPACING_BOUNDARY = '(?:^|[\\s"\'`{(\\[])';
+const TW_SPACING_VALUE = '(?:0(?:\\.\\d+)?|[1-9]\\d*(?:\\.\\d+)?|px|auto|full|screen)';
+// Capture group 1: full class; capture group 2: numeric scale token.
+export const TW_SPACING_RE = new RegExp(`${TW_SPACING_BOUNDARY}((?:${TW_SPACING_PREFIX})(?:[xytrbl])?-(${TW_SPACING_VALUE}))\\b`, 'g');
+/**
+ * Extract spacing tokens from a text blob.
+ * @param {string} text
+ * @returns {{raw: string[], tailwind_scale: string[]}}
+ */
+export function extractSpacing(text) {
+    const raw = new Set();
+    const tw = new Set();
+    for (const m of text.matchAll(RAW_LENGTH_RE))
+        raw.add(m[0]);
+    for (const m of text.matchAll(TW_SPACING_RE)) {
+        // Drop `full` / `screen` — those are width/height sentinels, not
+        // spacing-scale contributors. m[2] is the scale token.
+        if (m[2] === 'full' || m[2] === 'screen')
+            continue;
+        tw.add(m[2]);
+    }
+    return {
+        raw: [...raw].sort(lengthSort),
+        tailwind_scale: [...tw].sort(numericScaleSort),
+    };
+}
+function lengthSort(a, b) {
+    const na = parseFloat(a);
+    const nb = parseFloat(b);
+    if (Number.isNaN(na) || Number.isNaN(nb))
+        return a.localeCompare(b);
+    if (na !== nb)
+        return na - nb;
+    return a.localeCompare(b);
+}
+function numericScaleSort(a, b) {
+    const na = parseFloat(a);
+    const nb = parseFloat(b);
+    if (Number.isNaN(na) && Number.isNaN(nb))
+        return a.localeCompare(b);
+    if (Number.isNaN(na))
+        return 1;
+    if (Number.isNaN(nb))
+        return -1;
+    return na - nb;
+}
+// --- Typography -------------------------------------------------------------
+// CSS font-family: capture the declaration's value. Stops at `;` or newline.
+export const FONT_FAMILY_RE = /font-family\s*:\s*([^;\n]+)/gi;
+// Tailwind text size classes: `text-xs` … `text-9xl`. Excludes alignment
+// (`text-left`) and color (`text-red-500`) via explicit enum.
+const TW_SIZE = 'xs|sm|base|lg|xl|2xl|3xl|4xl|5xl|6xl|7xl|8xl|9xl';
+export const TW_TEXT_SIZE_RE = new RegExp(`\\btext-(?:${TW_SIZE})\\b`, 'g');
+// CSS font-size values — px / rem / em literal.
+export const FONT_SIZE_RAW_RE = /font-size\s*:\s*([^;\n]+)/gi;
+// Line height — capture declaration value.
+export const LINE_HEIGHT_RE = /line-height\s*:\s*([^;\n]+)/gi;
+/**
+ * Extract typography tokens from a text blob.
+ * @param {string} text
+ * @returns {{font_families: string[], font_sizes_raw: string[], tailwind_sizes: string[], line_heights: string[]}}
+ */
+export function extractTypography(text) {
+    const families = new Set();
+    const sizesRaw = new Set();
+    const twSizes = new Set();
+    const lineHeights = new Set();
+    for (const m of text.matchAll(FONT_FAMILY_RE)) {
+        // Split on commas to capture each individual family, strip quotes,
+        // trim whitespace. `Inter, -apple-system, sans-serif` → three entries.
+        for (const part of m[1].split(',')) {
+            const cleaned = part.trim().replace(/^['"]|['"]$/g, '');
+            if (cleaned.length > 0 && cleaned.length < 64)
+                families.add(cleaned);
+        }
+    }
+    for (const m of text.matchAll(FONT_SIZE_RAW_RE)) {
+        const value = m[1].trim();
+        if (value.length > 0 && value.length < 64)
+            sizesRaw.add(value);
+    }
+    for (const m of text.matchAll(TW_TEXT_SIZE_RE)) {
+        twSizes.add(m[0].replace(/^text-/, ''));
+    }
+    for (const m of text.matchAll(LINE_HEIGHT_RE)) {
+        const value = m[1].trim();
+        if (value.length > 0 && value.length < 64)
+            lineHeights.add(value);
+    }
+    return {
+        font_families: [...families].sort(),
+        font_sizes_raw: [...sizesRaw].sort(),
+        tailwind_sizes: [...twSizes].sort(typographyScaleSort),
+        line_heights: [...lineHeights].sort(),
+    };
+}
+// Tailwind size order for human-readable output.
+const TW_SIZE_ORDER = [
+    'xs',
+    'sm',
+    'base',
+    'lg',
+    'xl',
+    '2xl',
+    '3xl',
+    '4xl',
+    '5xl',
+    '6xl',
+    '7xl',
+    '8xl',
+    '9xl',
+];
+function typographyScaleSort(a, b) {
+    const ia = TW_SIZE_ORDER.indexOf(a);
+    const ib = TW_SIZE_ORDER.indexOf(b);
+    if (ia >= 0 && ib >= 0)
+        return ia - ib;
+    if (ia >= 0)
+        return -1;
+    if (ib >= 0)
+        return 1;
+    return a.localeCompare(b);
+}
+// --- Radii ------------------------------------------------------------------
+export const BORDER_RADIUS_RE = /border-radius\s*:\s*([^;\n]+)/gi;
+// Tailwind `rounded`, `rounded-md`, `rounded-tl-lg`, `rounded-full` etc.
+// Captures the size token after the final dash, or "" for bare `rounded`.
+export const TW_ROUNDED_RE = /\brounded(?:-(?:t|r|b|l|tl|tr|bl|br))?(?:-([a-z0-9]+))?\b/g;
+/**
+ * Extract border-radius tokens from a text blob.
+ * @param {string} text
+ * @returns {{raw: string[], tailwind: string[]}}
+ */
+export function extractRadii(text) {
+    const raw = new Set();
+    const tw = new Set();
+    for (const m of text.matchAll(BORDER_RADIUS_RE)) {
+        const value = m[1].trim();
+        if (value.length > 0 && value.length < 64)
+            raw.add(value);
+    }
+    for (const m of text.matchAll(TW_ROUNDED_RE)) {
+        // `rounded` with no size token → default size, record as "default" so
+        // the scale includes it but doesn't collide with `rounded-md`.
+        tw.add(m[1] ?? 'default');
+    }
+    return {
+        raw: [...raw].sort(),
+        tailwind: [...tw].sort(radiiScaleSort),
+    };
+}
+const RADII_ORDER = ['none', 'sm', 'default', 'md', 'lg', 'xl', '2xl', '3xl', 'full'];
+function radiiScaleSort(a, b) {
+    const ia = RADII_ORDER.indexOf(a);
+    const ib = RADII_ORDER.indexOf(b);
+    if (ia >= 0 && ib >= 0)
+        return ia - ib;
+    if (ia >= 0)
+        return -1;
+    if (ib >= 0)
+        return 1;
+    return a.localeCompare(b);
+}
+// --- Shadows ----------------------------------------------------------------
+export const BOX_SHADOW_RE = /box-shadow\s*:\s*([^;\n]+)/gi;
+// Tailwind: `shadow`, `shadow-sm`, `shadow-inner`, `shadow-md`. Excludes
+// color utilities like `shadow-slate-500` by enumerating size tokens only.
+const TW_SHADOW_SIZE = 'sm|md|lg|xl|2xl|inner|none';
+export const TW_SHADOW_RE = new RegExp(`\\bshadow(?:-(?:${TW_SHADOW_SIZE}))?\\b`, 'g');
+/**
+ * Extract shadow tokens from a text blob.
+ * @param {string} text
+ * @returns {{raw: string[], tailwind: string[]}}
+ */
+export function extractShadows(text) {
+    const raw = new Set();
+    const tw = new Set();
+    for (const m of text.matchAll(BOX_SHADOW_RE)) {
+        const value = m[1].trim();
+        if (value.length > 0 && value.length < 128)
+            raw.add(value);
+    }
+    for (const m of text.matchAll(TW_SHADOW_RE)) {
+        const suffix = m[0].includes('-') ? m[0].slice('shadow-'.length) : 'default';
+        tw.add(suffix);
+    }
+    return {
+        raw: [...raw].sort(),
+        tailwind: [...tw].sort(shadowScaleSort),
+    };
+}
+const SHADOW_ORDER = ['none', 'sm', 'default', 'md', 'lg', 'xl', '2xl', 'inner'];
+function shadowScaleSort(a, b) {
+    const ia = SHADOW_ORDER.indexOf(a);
+    const ib = SHADOW_ORDER.indexOf(b);
+    if (ia >= 0 && ib >= 0)
+        return ia - ib;
+    if (ia >= 0)
+        return -1;
+    if (ib >= 0)
+        return 1;
+    return a.localeCompare(b);
+}
+//# sourceMappingURL=extract.mjs.map

package/dist/cli/design/extract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.mjs","sourceRoot":"","sources":["../../../src/cli/design/extract.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,+EAA+E;AAE/E,2EAA2E;AAC3E,6EAA6E;AAC7E,yBAAyB;AACzB,MAAM,CAAC,MAAM,YAAY,GAAG,kEAAkE,CAAA;AAE9F,8EAA8E;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAG,+BAA+B,CAAA;AAEzD,2EAA2E;AAC3E,6EAA6E;AAC7E,uEAAuE;AACvE,2EAA2E;AAC3E,MAAM,cAAc,GACnB,gGAAgG,CAAA;AACjG,MAAM,aAAa,GAClB,oIAAoI,CAAA;AACrI,MAAM,QAAQ,GAAG,4CAA4C,CAAA;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,MAAM,CACpC,SAAS,cAAc,WAAW,aAAa,QAAQ,QAAQ,+CAA+C,EAC9G,GAAG,CACH,CAAA;AAED,6EAA6E;AAC7E,6EAA6E;AAC7E,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,6BAA6B,CAAA;AAE7D;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAI;IACjC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;IACrB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;IACrB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;IACrB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAA;IAC1B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAA;IAEzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;IAExE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,sEAAsE;QACtE,qEAAqE;QACrE,qEAAqE;QACrE,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QACjE,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;;YAC7C,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACzB,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,uEAAuE;QACvE,sEAAsE;QACtE,wBAAwB;QACxB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,cAAc,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;QACrE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAElE,OAAO;QACN,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE;QACpB,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE;QACpB,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE;QACpB,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE;QAC9B,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE;KAC7B,CAAA;AACF,CAAC;AAED,+EAA+E;AAE/E,6EAA6E;AAC7E,mEAAmE;AACnE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAG,sDAAsD,CAAA;AAEnF,4EAA4E;AAC5E,2EAA2E;AAC3E,uDAAuD;AACvD,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,yEAAyE;AACzE,uEAAuE;AACvE,uEAAuE;AACvE,qCAAqC;AACrC,MAAM,iBAAiB,GAAG,uEAAuE,CAAA;AACjG,MAAM,mBAAmB,GAAG,sBAAsB,CAAA;AAClD,MAAM,gBAAgB,GAAG,6DAA6D,CAAA;AACtF,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,MAAM,CACtC,GAAG,mBAAmB,OAAO,iBAAiB,mBAAmB,gBAAgB,OAAO,EACxF,GAAG,CACH,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAI;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;IACrB,MAAM,EAAE,GAAG,IAAI,GAAG,EAAE,CAAA;IAEpB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9C,iEAAiE;QACjE,uDAAuD;QACvD,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,SAAQ;QAClD,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACb,CAAC;IAED,OAAO;QACN,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAC9B,cAAc,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;KAC9C,CAAA;AACF,CAAC;AAED,SAAS,UAAU,CAAC,CAAC,EAAE,CAAC;IACvB,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IACxB,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IACxB,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IACnE,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,CAAA;IAC7B,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAC,EAAE,CAAC;IAC7B,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IACxB,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IACxB,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IACnE,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,CAAA;IAC9B,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,CAAC,CAAA;IAC/B,OAAO,EAAE,GAAG,EAAE,CAAA;AACf,CAAC;AAED,+EAA+E;AAE/E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG,+BAA+B,CAAA;AAE7D,yEAAyE;AACzE,8DAA8D;AAC9D,MAAM,OAAO,GAAG,kDAAkD,CAAA;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,MAAM,CAAC,cAAc,OAAO,MAAM,EAAE,GAAG,CAAC,CAAA;AAE3E,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,6BAA6B,CAAA;AAE7D,2CAA2C;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,+BAA+B,CAAA;AAE7D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAI;IACrC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAA;IAC1B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAA;IACzB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAE,CAAA;IAE7B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/C,mEAAmE;QACnE,uEAAuE;QACvE,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;YACvD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACrE,CAAC;IACF,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACzB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;YAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC/D,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;IACxC,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACzB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;YAAE,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAClE,CAAC;IAED,OAAO;QACN,aAAa,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE;QACnC,cAAc,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE;QACpC,cAAc,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;QACtD,YAAY,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE;KACrC,CAAA;AACF,CAAC;AAED,iDAAiD;AACjD,MAAM,aAAa,GAAG;IACrB,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACL,CAAA;AACD,SAAS,mBAAmB,CAAC,CAAC,EAAE,CAAC;IAChC,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACnC,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACnC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,CAAA;IACtC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,CAAA;IACtB,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACrB,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;AAC1B,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,iCAAiC,CAAA;AAEjE,yEAAyE;AACzE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,aAAa,GAAG,4DAA4D,CAAA;AAEzF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAI;IAChC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;IACrB,MAAM,EAAE,GAAG,IAAI,GAAG,EAAE,CAAA;IAEpB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACzB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC1D,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9C,sEAAsE;QACtE,+DAA+D;QAC/D,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAA;IAC1B,CAAC;IAED,OAAO;QACN,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE;QACpB,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;KACtC,CAAA;AACF,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;AACrF,SAAS,cAAc,CAAC,CAAC,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACjC,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACjC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,CAAA;IACtC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,CAAA;IACtB,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACrB,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;AAC1B,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG,8BAA8B,CAAA;AAE3D,yEAAyE;AACzE,2EAA2E;AAC3E,MAAM,cAAc,GAAG,4BAA4B,CAAA;AACnD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,mBAAmB,cAAc,QAAQ,EAAE,GAAG,CAAC,CAAA;AAEtF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAI;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;IACrB,MAAM,EAAE,GAAG,IAAI,GAAG,EAAE,CAAA;IAEpB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACzB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;YAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC3D,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC5E,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACf,CAAC;IAED,OAAO;QACN,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE;QACpB,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;KACvC,CAAA;AACF,CAAC;AAED,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;AAChF,SAAS,eAAe,CAAC,CAAC,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAClC,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAClC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,CAAA;IACtC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,CAAA;IACtB,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACrB,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;AAC1B,CAAC"}

package/dist/cli/design/frontmatter-schema.d.mts

@@ -0,0 +1,179 @@
+/**
+ * Validate a parsed YAML object as DESIGN.md frontmatter.
+ *
+ * @param {unknown} data — the YAML.parse() output
+ * @returns {import('zod').SafeParseReturnType<unknown, unknown>}
+ */
+export function validateDesignFrontmatter(data: unknown): import("zod").SafeParseReturnType<unknown, unknown>;
+export const MetaSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    updated: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    inspiration: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export const ColorsSchema: z.ZodObject<{
+    bg: z.ZodString;
+    surface: z.ZodString;
+    accent: z.ZodString;
+    text: z.ZodString;
+    border: z.ZodString;
+    status: z.ZodOptional<z.ZodObject<{
+        success: z.ZodOptional<z.ZodString>;
+        warning: z.ZodOptional<z.ZodString>;
+        danger: z.ZodOptional<z.ZodString>;
+        info: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export const TypographyFamiliesSchema: z.ZodObject<{
+    primary: z.ZodString;
+    display: z.ZodOptional<z.ZodString>;
+    mono: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export const TypographySchema: z.ZodObject<{
+    families: z.ZodObject<{
+        primary: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        mono: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    scale: z.ZodArray<z.ZodString>;
+    weights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    lineHeight: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$loose>;
+export const SpacingSchema: z.ZodArray<z.ZodString>;
+export const RadiusSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export const ShadowSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export const MotionEasingSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export const MotionSchema: z.ZodObject<{
+    duration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    easing: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$loose>;
+export const TokensSchema: z.ZodObject<{
+    colors: z.ZodObject<{
+        bg: z.ZodString;
+        surface: z.ZodString;
+        accent: z.ZodString;
+        text: z.ZodString;
+        border: z.ZodString;
+        status: z.ZodOptional<z.ZodObject<{
+            success: z.ZodOptional<z.ZodString>;
+            warning: z.ZodOptional<z.ZodString>;
+            danger: z.ZodOptional<z.ZodString>;
+            info: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+    typography: z.ZodObject<{
+        families: z.ZodObject<{
+            primary: z.ZodString;
+            display: z.ZodOptional<z.ZodString>;
+            mono: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        scale: z.ZodArray<z.ZodString>;
+        weights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        lineHeight: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$loose>;
+    spacing: z.ZodArray<z.ZodString>;
+    radius: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    shadow: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    motion: z.ZodOptional<z.ZodObject<{
+        duration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        easing: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export const ComponentsSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+export const AntiPatternCategorySchema: z.ZodEnum<{
+    content: "content";
+    color: "color";
+    typography: "typography";
+    motion: "motion";
+    layout: "layout";
+    interaction: "interaction";
+}>;
+export const AntiPatternSchema: z.ZodObject<{
+    id: z.ZodString;
+    category: z.ZodEnum<{
+        content: "content";
+        color: "color";
+        typography: "typography";
+        motion: "motion";
+        layout: "layout";
+        interaction: "interaction";
+    }>;
+    pattern: z.ZodString;
+    why: z.ZodString;
+    rewrite: z.ZodString;
+}, z.core.$strict>;
+export const AntiPatternsSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    category: z.ZodEnum<{
+        content: "content";
+        color: "color";
+        typography: "typography";
+        motion: "motion";
+        layout: "layout";
+        interaction: "interaction";
+    }>;
+    pattern: z.ZodString;
+    why: z.ZodString;
+    rewrite: z.ZodString;
+}, z.core.$strict>>;
+export const InspirationSchema: z.ZodArray<z.ZodString>;
+export const DesignFrontmatterSchema: z.ZodObject<{
+    meta: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+        updated: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        inspiration: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    tokens: z.ZodObject<{
+        colors: z.ZodObject<{
+            bg: z.ZodString;
+            surface: z.ZodString;
+            accent: z.ZodString;
+            text: z.ZodString;
+            border: z.ZodString;
+            status: z.ZodOptional<z.ZodObject<{
+                success: z.ZodOptional<z.ZodString>;
+                warning: z.ZodOptional<z.ZodString>;
+                danger: z.ZodOptional<z.ZodString>;
+                info: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+        typography: z.ZodObject<{
+            families: z.ZodObject<{
+                primary: z.ZodString;
+                display: z.ZodOptional<z.ZodString>;
+                mono: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>;
+            scale: z.ZodArray<z.ZodString>;
+            weights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            lineHeight: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$loose>;
+        spacing: z.ZodArray<z.ZodString>;
+        radius: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        shadow: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        motion: z.ZodOptional<z.ZodObject<{
+            duration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            easing: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+    components: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    antiPatterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        category: z.ZodEnum<{
+            content: "content";
+            color: "color";
+            typography: "typography";
+            motion: "motion";
+            layout: "layout";
+            interaction: "interaction";
+        }>;
+        pattern: z.ZodString;
+        why: z.ZodString;
+        rewrite: z.ZodString;
+    }, z.core.$strict>>>;
+    inspiration: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+import { z } from 'zod';
+//# sourceMappingURL=frontmatter-schema.d.mts.map

package/dist/cli/design/frontmatter-schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-schema.d.mts","sourceRoot":"","sources":["../../../src/cli/design/frontmatter-schema.mjs"],"names":[],"mappings":"AA+KA;;;;;GAKG;AACH,gDAHW,OAAO,GACL,OAAO,KAAK,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAI/D;AAhJD;;;;;;mBAQU;AAaV;;;;;;;;;;;;kBASe;AAIf;;;;kBAMe;AAEf;;;;;;;;;kBAOe;AAIf,oDAAuD;AAEvD,iEAA4D;AAE5D,iEAAgE;AAEhE,uEAAsE;AAEtE;;;kBAKe;AAIf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBASe;AASf,gGAAuF;AAOvF;;;;;;;GAOE;AAEF;;;;;;;;;;;;;mBAQU;AAEV;;;;;;;;;;;;;oBAA4D;AAQ5D,wDAAwD;AAIxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQe;kBAtJG,KAAK"}

package/dist/cli/design/frontmatter-schema.mjs

@@ -0,0 +1,153 @@
+/**
+ * design/frontmatter-schema.mjs — Zod schema for DESIGN.md YAML frontmatter (C2).
+ *
+ * DESIGN.md is the project-root design contract (Stitch 9-section format). The
+ * YAML frontmatter carries the machine-parseable bits (tokens, palette,
+ * anti-patterns); the prose body carries the human-facing narrative. See
+ * `docs/frameworks/Design-system/overview.md` §2.3 / §10.1 for the rationale.
+ *
+ * Schema is intentionally permissive on additive fields (not `.strict()`): tools
+ * and future milestones may introduce new frontmatter keys, and a stale
+ * validator should not block a newer authoring flow. The authored keys are
+ * checked; unknown keys pass through silently.
+ *
+ * The flat-ish shape below mirrors `design/schema.mjs` for design-scan tokens:
+ * small objects of sorted arrays where there's no richer structure yet, and a
+ * strict `meta` block so human/agent drift on the required identity fields
+ * surfaces at validate time rather than lint time.
+ *
+ * v1 keeps `components` open-ended (any keyed record) and `motion` as named
+ * duration/easing pairs. Richer structure (dark/light pairing, tonal ramps,
+ * keyframe tracks) is deferred.
+ */
+import { z } from 'zod';
+// --- Shared primitives -------------------------------------------------------
+const NonEmptyString = z.string().min(1);
+// Hex color: #RGB, #RRGGBB, or #RRGGBBAA.  OKLCH/rgb()/hsl() strings also valid
+// because the body may reference color-space-specific values we don't want to
+// police here; anything non-empty is accepted.  Hex is the cheapest canonical
+// form for apt-tools design-lint downstream.
+const ColorString = NonEmptyString;
+const PixelOrRem = NonEmptyString;
+// --- meta (strict) -----------------------------------------------------------
+export const MetaSchema = z
+    .object({
+    name: NonEmptyString,
+    version: NonEmptyString,
+    updated: NonEmptyString, // ISO-8601 date or datetime; free-form by design
+    description: NonEmptyString.optional(),
+    inspiration: NonEmptyString.optional(), // typeui-sh slug or free-form note
+})
+    .strict();
+// --- tokens.colors -----------------------------------------------------------
+const ColorStatusSchema = z
+    .object({
+    success: ColorString.optional(),
+    warning: ColorString.optional(),
+    danger: ColorString.optional(),
+    info: ColorString.optional(),
+})
+    .passthrough();
+export const ColorsSchema = z
+    .object({
+    bg: ColorString,
+    surface: ColorString,
+    accent: ColorString,
+    text: ColorString,
+    border: ColorString,
+    status: ColorStatusSchema.optional(),
+})
+    .passthrough();
+// --- tokens.typography -------------------------------------------------------
+export const TypographyFamiliesSchema = z
+    .object({
+    primary: NonEmptyString,
+    display: NonEmptyString.optional(),
+    mono: NonEmptyString.optional(),
+})
+    .passthrough();
+export const TypographySchema = z
+    .object({
+    families: TypographyFamiliesSchema,
+    scale: z.array(PixelOrRem).min(3), // at least {body, heading, display}
+    weights: z.array(z.number().int().positive()).optional(),
+    lineHeight: z.record(z.string(), NonEmptyString).optional(),
+})
+    .passthrough();
+// --- tokens.spacing / radius / shadow / motion -------------------------------
+export const SpacingSchema = z.array(PixelOrRem).min(2);
+export const RadiusSchema = z.record(z.string(), PixelOrRem);
+export const ShadowSchema = z.record(z.string(), NonEmptyString);
+export const MotionEasingSchema = z.record(z.string(), NonEmptyString);
+export const MotionSchema = z
+    .object({
+    duration: z.record(z.string(), NonEmptyString).optional(),
+    easing: MotionEasingSchema.optional(),
+})
+    .passthrough();
+// --- tokens (required) -------------------------------------------------------
+export const TokensSchema = z
+    .object({
+    colors: ColorsSchema,
+    typography: TypographySchema,
+    spacing: SpacingSchema,
+    radius: RadiusSchema.optional(),
+    shadow: ShadowSchema.optional(),
+    motion: MotionSchema.optional(),
+})
+    .passthrough();
+// --- components --------------------------------------------------------------
+//
+// Open-ended record: each key is a component name (`button`, `card`, `input`),
+// each value is a record of token overrides or variant definitions.  We don't
+// prescribe the inner shape in v1 — enforcing one would constrain what the
+// style skills in examples/by-source/typeui-sh/ can express.
+export const ComponentsSchema = z.record(z.string(), z.record(z.string(), z.unknown()));
+// --- antiPatterns ------------------------------------------------------------
+//
+// Structured catalog consumed by C11 `apt-tools design-lint`.  Each entry is
+// specific enough for a post-generation grep to find violations.
+export const AntiPatternCategorySchema = z.enum([
+    'color',
+    'typography',
+    'layout',
+    'content',
+    'motion',
+    'interaction',
+]);
+export const AntiPatternSchema = z
+    .object({
+    id: NonEmptyString,
+    category: AntiPatternCategorySchema,
+    pattern: NonEmptyString, // regex or css-match literal
+    why: NonEmptyString,
+    rewrite: NonEmptyString,
+})
+    .strict();
+export const AntiPatternsSchema = z.array(AntiPatternSchema);
+// --- inspiration -------------------------------------------------------------
+//
+// Names of design styles the author drew from — typically typeui-sh slugs
+// (`paper`, `bento`, `clean`, `neobrutalism`, …) so the variant-generator can
+// reach for a vendored style skill when expanding `apt:mockup --variants N`.
+export const InspirationSchema = z.array(NonEmptyString);
+// --- root --------------------------------------------------------------------
+export const DesignFrontmatterSchema = z
+    .object({
+    meta: MetaSchema,
+    tokens: TokensSchema,
+    components: ComponentsSchema.optional(),
+    antiPatterns: AntiPatternsSchema.optional(),
+    inspiration: InspirationSchema.optional(),
+})
+    .passthrough();
+/**
+ * Validate a parsed YAML object as DESIGN.md frontmatter.
+ *
+ * @param {unknown} data — the YAML.parse() output
+ * @returns {import('zod').SafeParseReturnType<unknown, unknown>}
+ */
+export function validateDesignFrontmatter(data) {
+    return DesignFrontmatterSchema.safeParse(data);
+}
+//# sourceMappingURL=frontmatter-schema.mjs.map

package/dist/cli/design/frontmatter-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-schema.mjs","sourceRoot":"","sources":["../../../src/cli/design/frontmatter-schema.mjs"],"names":[],"mappings":"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"}