@nghitrum/dsforge 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,3222 @@
+import { z } from 'zod';
+
+type RawValue = string | number;
+/**
+ * TokenValue: either a raw value or a "{layer.key}" reference string.
+ * The token resolver validates and expands references at runtime.
+ */
+type TokenValue = RawValue;
+type GlobalTokens = Record<string, RawValue>;
+type SemanticTokens = Record<string, TokenValue>;
+type ComponentTokens = Record<string, TokenValue>;
+interface TokenLayers {
+    global?: GlobalTokens;
+    semantic?: SemanticTokens;
+    component?: ComponentTokens;
+}
+interface ColorSurface {
+    default: TokenValue;
+    subtle?: TokenValue;
+    overlay?: TokenValue;
+    inverse?: TokenValue;
+}
+interface ColorBorder {
+    default: TokenValue;
+    strong?: TokenValue;
+    focus?: TokenValue;
+    subtle?: TokenValue;
+}
+interface ColorText {
+    primary: TokenValue;
+    secondary?: TokenValue;
+    disabled?: TokenValue;
+    inverse?: TokenValue;
+    onColor?: TokenValue;
+}
+interface StatusColorSet {
+    bg: TokenValue;
+    fg: TokenValue;
+    border?: TokenValue;
+}
+interface ColorStatus {
+    success?: StatusColorSet;
+    warning?: StatusColorSet;
+    danger?: StatusColorSet;
+    info?: StatusColorSet;
+}
+interface InteractiveStateSet {
+    rest: TokenValue;
+    hover: TokenValue;
+    active: TokenValue;
+    disabled: TokenValue;
+    selected?: TokenValue;
+}
+interface ColorInteractive {
+    primary?: InteractiveStateSet;
+    secondary?: InteractiveStateSet;
+    danger?: InteractiveStateSet;
+}
+interface ColorConfig {
+    surface?: ColorSurface;
+    border?: ColorBorder;
+    text?: ColorText;
+    status?: ColorStatus;
+    interactive?: ColorInteractive;
+}
+interface TypographyRole {
+    size: number;
+    weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+    lineHeight: number;
+    letterSpacing?: string | number;
+    fontFamily?: string;
+}
+interface TypographyConfig {
+    fontFamily: string;
+    /** Semantic roles — the public API for type usage */
+    roles?: {
+        display?: TypographyRole;
+        h1?: TypographyRole;
+        h2?: TypographyRole;
+        h3?: TypographyRole;
+        body?: TypographyRole;
+        small?: TypographyRole;
+        caption?: TypographyRole;
+        label?: TypographyRole;
+        code?: TypographyRole;
+    };
+    /** Raw numeric scale — kept for legacy; prefer roles */
+    scale?: number[];
+    fontWeights?: number[];
+}
+/** Named numeric scale: { "1": 4, "2": 8, ... } */
+type SpacingScale = Record<string, number>;
+/** Semantic spacing tokens that reference scale values */
+type SpacingSemantic = Record<string, TokenValue>;
+interface SpacingConfig {
+    /** The raw numeric multiplier grid (e.g., base-4) */
+    baseUnit?: number;
+    /** Pre-computed named scale derived from baseUnit */
+    scale?: SpacingScale;
+    /** Intent-named tokens: component-padding-md, layout-gap-sm, etc. */
+    semantic?: SpacingSemantic;
+}
+interface RadiusConfig {
+    none?: number;
+    sm?: number;
+    md?: number;
+    lg?: number;
+    xl?: number;
+    full?: number;
+    [key: string]: number | undefined;
+}
+/** Named shadow levels. Key is level name ("0"–"4" or "none"/"sm"/"lg"). */
+type ElevationConfig = Record<string, string>;
+interface MotionDuration {
+    instant?: number;
+    fast?: number;
+    normal?: number;
+    slow?: number;
+    deliberate?: number;
+    [key: string]: number | undefined;
+}
+interface MotionEasing {
+    standard?: string;
+    decelerate?: string;
+    accelerate?: string;
+    spring?: string;
+    linear?: string;
+    [key: string]: string | undefined;
+}
+interface MotionConfig {
+    duration?: MotionDuration;
+    easing?: MotionEasing;
+}
+interface FocusRing {
+    color: TokenValue;
+    width: string;
+    offset: string;
+    style?: "solid" | "dashed" | "dotted";
+}
+interface StatesConfig {
+    hoverOpacity?: number;
+    activeOpacity?: number;
+    disabledOpacity?: number;
+    focusRing?: FocusRing;
+}
+type Breakpoints = {
+    sm?: number;
+    md?: number;
+    lg?: number;
+    xl?: number;
+    "2xl"?: number;
+    [key: string]: number | undefined;
+};
+interface GridColumns {
+    sm?: number;
+    md?: number;
+    lg?: number;
+    xl?: number;
+    [key: string]: number | undefined;
+}
+interface GridConfig {
+    columns?: GridColumns;
+    gutter?: number;
+    margin?: number;
+}
+interface LayoutConfig {
+    breakpoints?: Breakpoints;
+    grid?: GridConfig;
+    container?: Record<string, number>;
+}
+/**
+ * A theme is a flat map of semantic token overrides.
+ * At runtime, these become CSS custom property overrides on :root[data-theme="..."].
+ */
+type ThemeOverrides = Record<string, RawValue>;
+type ThemesConfig = Record<string, ThemeOverrides>;
+interface PhilosophyConfig {
+    /** Component density: affects padding/spacing defaults */
+    density?: "compact" | "comfortable" | "spacious";
+    /** Shadow approach */
+    elevation?: "minimal" | "moderate" | "expressive";
+    /** Motion preference */
+    motion?: "none" | "reduced" | "full";
+}
+interface CustomizationConfig {
+    /**
+     * Package name to extend. Merged before applying local overrides.
+     * e.g. "@myorg/base-design-system"
+     */
+    extends?: string | null;
+    /**
+     * Deep-merged token overrides on top of resolved base config.
+     * Keys use dot-path notation: "tokens.semantic.color-action"
+     */
+    overrides?: Record<string, RawValue>;
+}
+/**
+ * The set of supported adapter target identifiers.
+ * Kept in sync with SUPPORTED_TARGETS in src/schema/config.schema.ts.
+ */
+type OutputTarget = "react";
+interface OutputConfig {
+    /**
+     * The framework adapter to use when generating component files.
+     *
+     * @default "react"
+     *
+     * Supported values: "react"
+     * Future values: "vue", "svelte", "angular", "react-native"
+     */
+    target?: OutputTarget;
+}
+interface MetaConfig {
+    name: string;
+    version: string;
+    description?: string;
+    /** Preset profile applied at init time */
+    preset?: "compact" | "comfortable" | "spacious";
+    /** The npm scope for publishing, e.g. "@myorg" */
+    npmScope?: string;
+}
+interface DesignSystemConfig {
+    meta: MetaConfig;
+    tokens?: TokenLayers;
+    themes?: ThemesConfig;
+    color?: ColorConfig;
+    typography?: TypographyConfig;
+    spacing?: SpacingConfig;
+    radius?: RadiusConfig;
+    elevation?: ElevationConfig;
+    motion?: MotionConfig;
+    states?: StatesConfig;
+    layout?: LayoutConfig;
+    philosophy?: PhilosophyConfig;
+    customization?: CustomizationConfig;
+    /** Output adapter configuration. Omitting this field defaults to React. */
+    output?: OutputConfig;
+}
+interface ComponentRule {
+    /** Allowed variant prop values */
+    allowedVariants?: string[];
+    /** Props that must always be provided */
+    requiredProps?: string[];
+    /** Max CSS width value */
+    maxWidth?: string;
+    /** Allowed borderRadius values (must exist in radius config) */
+    allowedRadius?: string[];
+    /** Allowed shadow levels (must exist in elevation config) */
+    allowedShadows?: string[];
+    /** Allowed color palette tokens for this component */
+    colorPalette?: string[];
+    /** Component-level token overrides */
+    tokens?: Record<string, TokenValue>;
+    /** Accessibility requirements */
+    a11y?: {
+        keyboard?: boolean;
+        focusRing?: boolean;
+        ariaLabel?: "required" | "optional" | "forbidden";
+        role?: string;
+    };
+}
+type RulesConfig = Record<string, ComponentRule>;
+/** A fully resolved token map: all {refs} replaced with concrete values */
+type ResolvedTokenMap = Record<string, string>;
+interface ResolvedConfig {
+    /** The original config before resolution */
+    source: DesignSystemConfig;
+    /** All tokens resolved to concrete values, keyed by "layer.name" */
+    tokens: ResolvedTokenMap;
+    /** CSS custom property declarations per theme */
+    themes: Record<string, Record<string, string>>;
+}
+declare class TokenResolutionError extends Error {
+    readonly path: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, path: string, cause?: Error | undefined);
+}
+declare class CircularReferenceError extends TokenResolutionError {
+    readonly cycle: string[];
+    constructor(cycle: string[]);
+}
+declare class UnresolvedReferenceError extends TokenResolutionError {
+    readonly fromToken: string;
+    constructor(refPath: string, fromToken: string);
+}
+type IssueSeverity = "error" | "warning" | "info";
+interface ValidationIssue {
+    severity: IssueSeverity;
+    code: string;
+    message: string;
+    path?: string;
+    suggestion?: string;
+}
+interface ValidationResult {
+    valid: boolean;
+    score: number;
+    maxScore: number;
+    issues: ValidationIssue[];
+}
+
+interface ResolutionResult {
+    /** Fully resolved token map: "layer.key" → concrete value */
+    tokens: ResolvedTokenMap;
+    /** Any non-fatal warnings encountered during resolution */
+    warnings: ResolutionWarning[];
+}
+interface ResolutionWarning {
+    type: "unresolved_ref" | "unexpected_type";
+    path: string;
+    message: string;
+}
+declare class TokenResolver {
+    private readonly config;
+    /** LRU-style cache: refPath → resolved concrete string */
+    private readonly cache;
+    /** Tracks the current resolution chain for cycle detection */
+    private readonly stack;
+    private readonly warnings;
+    constructor(config: DesignSystemConfig);
+    /**
+     * Resolve all tokens in the config.
+     * Returns a flat map of every token path to its concrete value.
+     *
+     * Resolution order ensures correct layering:
+     *   global → semantic → component
+     */
+    resolve(): ResolutionResult;
+    /**
+     * Resolve a single value in isolation.
+     * Useful for one-off resolution outside the full config context.
+     */
+    resolveOneValue(value: string, contextPath?: string): string;
+    /**
+     * Resolve all {ref} patterns within a value string.
+     *
+     * Two modes:
+     *   - SOLE reference: "{global.blue-600}"  → return the resolved value directly
+     *     (preserves numeric types when the referenced value is a number)
+     *   - INTERPOLATED: "0 1px {shadow.color}" → replace refs inline, return string
+     */
+    private resolveValue;
+    /**
+     * Resolve a single reference path to its concrete value.
+     * Implements:
+     *   - Cache lookup (avoid redundant resolution)
+     *   - Cycle detection via the resolution stack
+     *   - Recursive resolution (a ref can point to another ref)
+     */
+    private resolveRef;
+    private handleError;
+}
+/**
+ * Resolve all tokens in a DesignSystemConfig.
+ *
+ * @example
+ *   const { tokens, warnings } = resolveTokens(config);
+ *   console.log(tokens["semantic.color-action"]); // "#2563eb"
+ */
+declare function resolveTokens(config: DesignSystemConfig): ResolutionResult;
+/**
+ * Build CSS custom property output for a given theme.
+ *
+ * @example
+ *   buildThemeCss(config, "dark")
+ *   // `:root[data-theme="dark"] { --color-action: #60a5fa; ... }`
+ */
+declare function buildThemeCss(config: DesignSystemConfig, themeName: string): string;
+/**
+ * Extract all {ref} paths from a value string.
+ * Useful for static analysis and validation.
+ *
+ * @example
+ *   extractRefs("0 1px {shadow.color} {radius.md}")
+ *   // → ["shadow.color", "radius.md"]
+ */
+declare function extractRefs(value: string): string[];
+/**
+ * Check whether a value contains any unresolved {ref} patterns.
+ */
+declare function hasRefs(value: string): boolean;
+
+declare function validateConfig(config: DesignSystemConfig, rules: RulesConfig): ValidationResult;
+
+type Preset = "compact" | "comfortable" | "spacious";
+declare function buildInitialConfig(name: string, preset?: Preset): DesignSystemConfig;
+declare function buildInitialRules(): RulesConfig;
+
+/**
+ * CSS custom property emitter.
+ *
+ * Generates one .css file per theme, plus a base.css with all resolved tokens.
+ * Consumers import the appropriate theme file to activate that theme's tokens.
+ *
+ * Output format:
+ *   :root[data-theme="light"] { --color-action: #2563eb; ... }
+ */
+
+/**
+ * Emit base.css — all resolved semantic + component tokens as :root vars.
+ * This file is always safe to import regardless of theme.
+ */
+declare function emitBaseCss(config: DesignSystemConfig, resolution: ResolutionResult): string;
+/**
+ * Emit a theme-specific CSS file.
+ * The generated selector is :root[data-theme="themeName"].
+ */
+declare function emitThemeCss(themeName: string, themeOverrides: Record<string, string | number>, config: DesignSystemConfig): string;
+interface CssFile {
+    filename: string;
+    content: string;
+}
+/**
+ * Generate all CSS files from a resolved config.
+ * Returns an array of { filename, content } pairs ready to write to disk.
+ */
+declare function generateCssFiles(config: DesignSystemConfig, resolution: ResolutionResult): CssFile[];
+
+/**
+ * JS + TypeScript token emitter.
+ *
+ * Generates:
+ *   tokens.js   — CommonJS-compatible object literal (also valid ESM)
+ *   tokens.d.ts — TypeScript type declarations
+ *
+ * Consumers can import individual tokens by name for use in
+ * CSS-in-JS, React Native, or anywhere that needs raw values at runtime.
+ */
+
+/**
+ * Emit tokens.js — a flat ESM export of all resolved tokens.
+ */
+declare function emitJsTokens(config: DesignSystemConfig, resolution: ResolutionResult): string;
+/**
+ * Emit tailwind.config.js — a Tailwind CSS theme extension.
+ * Consumers spread this into their tailwind.config.js `theme.extend`.
+ */
+declare function emitTailwindConfig(config: DesignSystemConfig): string;
+
+/**
+ * Button component generator.
+ *
+ * Generates a fully typed, accessible React Button component
+ * using CSS custom properties for all visual tokens.
+ * Variant types and governance rules are derived from design-system.rules.json.
+ */
+
+declare function generateButton(config: DesignSystemConfig, rule: ComponentRule | undefined): string;
+
+/**
+ * Input component generator.
+ * Generates a typed, accessible React Input with label, error, and helper text slots.
+ */
+
+declare function generateInput(config: DesignSystemConfig, rule: ComponentRule | undefined): string;
+
+/**
+ * Card component generator.
+ * Generates a composable Card with Header, Body, and Footer slots.
+ */
+
+declare function generateCard(config: DesignSystemConfig, rule: ComponentRule | undefined): string;
+
+/**
+ * ThemeProvider + component barrel index generator.
+ *
+ * Generates:
+ *   ThemeProvider.tsx — React context-based theme switcher
+ *   index.ts          — barrel export of all components
+ */
+
+declare function generateThemeProvider(config: DesignSystemConfig): string;
+declare function generateComponentIndex(config: DesignSystemConfig, componentNames: string[]): string;
+
+/**
+ * AI-consumable metadata generator.
+ *
+ * Outputs one JSON file per component + an index.json registry.
+ * These files are read by AI coding assistants (Copilot, Cursor, Claude)
+ * to understand component contracts before generating UI code.
+ *
+ * Format is designed to be both human-readable and machine-parseable.
+ */
+
+interface ComponentMetadata {
+    component: string;
+    version: string;
+    description: string;
+    role: string;
+    hierarchyLevel: "primary" | "secondary" | "tertiary" | "utility";
+    interactionModel: "synchronous" | "asynchronous" | "none";
+    layoutImpact: "inline" | "block" | "overlay" | "layout";
+    destructive: boolean;
+    allowedVariants: string[];
+    defaultVariant: string;
+    sizes?: string[];
+    requiredProps: string[];
+    optionalProps: string[];
+    tokens: Record<string, string>;
+    accessibilityContract: {
+        keyboard: boolean;
+        focusRing: boolean;
+        ariaLabel: "required" | "optional" | "forbidden";
+        role?: string;
+        announcements?: string[];
+    };
+    governanceRules: {
+        maxWidth?: string;
+        allowedRadius?: string[];
+        allowedShadows?: string[];
+        colorPalette?: string[];
+    };
+}
+interface MetadataFile {
+    filename: string;
+    content: string;
+}
+/**
+ * Generate all metadata JSON files.
+ * Returns { filename, content } pairs ready to write to disk.
+ */
+declare function generateMetadata(config: DesignSystemConfig, rules: RulesConfig, tokenCount: number): MetadataFile[];
+
+/**
+ * MDX documentation generator.
+ *
+ * Generates Storybook-ready MDX stories for each component.
+ * Stories demonstrate all variants, sizes, and states.
+ * Content is derived from metadata so docs always stay in sync.
+ */
+
+interface DocFile {
+    filename: string;
+    content: string;
+}
+/**
+ * Generate all MDX documentation files.
+ */
+declare function generateDocs(config: DesignSystemConfig, rules: RulesConfig, metadataMap: Record<string, ComponentMetadata>): DocFile[];
+
+/**
+ * Package emitter.
+ *
+ * Generates the package.json and README.md for the published npm package.
+ * The published package is what consumers install — it's separate from the
+ * dsforge tool itself.
+ */
+
+declare function generatePackageJson(config: DesignSystemConfig, componentNames: string[]): string;
+declare function generateTsConfig(): string;
+declare function generateReadme(config: DesignSystemConfig, componentNames: string[]): string;
+declare function generateChangelog(config: DesignSystemConfig): string;
+
+/**
+ * Calculate the contrast ratio between two hex color strings.
+ * Returns null if either color cannot be parsed.
+ */
+declare function hexContrastRatio(foreground: string, background: string): number | null;
+type WcagLevel = "AA" | "AAA";
+type TextSize = "normal" | "large";
+interface ContrastCheckResult {
+    ratio: number;
+    passes: boolean;
+    level: WcagLevel;
+    textSize: TextSize;
+    required: number;
+    /** Rounded to 2dp for display */
+    ratioDisplay: string;
+}
+/**
+ * Check whether a foreground/background color pair meets the WCAG threshold.
+ */
+declare function checkContrast(foreground: string, background: string, level?: WcagLevel, textSize?: TextSize): ContrastCheckResult | null;
+/**
+ * Given a hex color that fails contrast against a background,
+ * suggest a darker (or lighter) variant that passes AA.
+ *
+ * Strategy: darken/lighten in HSL space by small steps until threshold met.
+ * Returns the adjusted hex, or null if no adjustment found within 20 steps.
+ */
+declare function suggestContrastFix(foreground: string, background: string, level?: WcagLevel, textSize?: TextSize): string | null;
+/**
+ * Check whether a string looks like a parseable hex color.
+ */
+declare function isHexColor(value: string): boolean;
+
+/**
+ * src/adapters/types.ts
+ *
+ * The FrameworkAdapter contract.
+ *
+ * Every framework adapter — React (current), Vue, Angular, Svelte, React Native,
+ * or any future enterprise custom target — must satisfy this interface.
+ *
+ * Why this exists
+ * ───────────────
+ * The generate pipeline in src/cli/commands/generate.ts currently hard-codes
+ * calls to React-specific generators (generateButton, generateInput, etc.).
+ * This interface extracts the shape of those responsibilities so the pipeline
+ * can call adapter.generateComponent("Button", ...) instead, and each new
+ * framework becomes a single file that satisfies this contract.
+ *
+ * Scope: what lives in the adapter layer
+ * ───────────────────────────────────────
+ * Framework-specific outputs — things that change when you target Vue vs React:
+ *   • Component source files (TSX → SFC .vue → Angular @Component)
+ *   • Theme provider (React context vs Vue provide/inject vs Angular service)
+ *   • Barrel index (re-export syntax differs across module formats)
+ *   • Token files (CSS vars are universal; React Native needs a JS-only object)
+ *   • Component documentation (MDX imports React; Vue Storybook is different)
+ *   • Package manifest (peerDependencies, engines, and exports map differ)
+ *
+ * Framework-agnostic outputs — NOT in the adapter (stay in the core pipeline):
+ *   • Token resolution (token-resolver.ts)
+ *   • Validation and WCAG checks
+ *   • AI metadata JSON (machine-readable; framework-neutral)
+ *   • Diff engine and changelog
+ */
+
+/**
+ * A single generated file, ready to be written to disk.
+ *
+ * Consolidates the ad-hoc { filename, content } shapes that appear throughout
+ * the codebase as CssFile, MetadataFile, DocFile, etc.
+ *
+ * `filename` is always relative to the adapter's output sub-directory.
+ * The pipeline is responsible for constructing the full absolute path.
+ *
+ * @example
+ *   { filename: "Button.tsx",  content: "import React from 'react'; ..." }
+ *   { filename: "base.css",    content: ":root { --color-action: #2563eb }" }
+ *   { filename: "button.mdx",  content: "---\ntitle: Button\n---\n..." }
+ */
+interface GeneratedFile {
+    filename: string;
+    content: string;
+}
+/**
+ * The contract every framework adapter must satisfy.
+ *
+ * The generate pipeline calls these methods in order:
+ *   1. generateTokenFiles  — tokens/
+ *   2. generateComponent   — src/<Name>.<ext>   (once per component)
+ *   3. generateThemeProvider — src/ThemeProvider.<ext>
+ *   4. generateComponentIndex — src/index.<ext>
+ *   5. generateDocs        — docs/
+ *   6. generatePackageManifest — package.json
+ *
+ * Each method must be pure: given the same inputs it must produce the same
+ * outputs. No side effects, no disk I/O.
+ */
+interface FrameworkAdapter {
+    /**
+     * Stable machine identifier for this adapter.
+     * Used in config (output.target), log messages, and test fixtures.
+     *
+     * Convention: lowercase, no spaces.
+     * @example "react" | "vue" | "angular" | "svelte" | "react-native"
+     */
+    readonly name: string;
+    /**
+     * File extension applied to every generated component file.
+     *
+     * The generate pipeline appends this to the component name to form the
+     * output filename, e.g. `Button` + `.tsx` → `Button.tsx`.
+     *
+     * @example "tsx" | "vue" | "component.ts" | "ts"
+     */
+    readonly componentExtension: string;
+    /**
+     * Generate the source file for a single named component.
+     *
+     * The pipeline iterates over all component names defined in the rules config
+     * and calls this method once per component. Unknown component names (ones
+     * without a specific implementation in the adapter) should fall back to a
+     * minimal compliant stub rather than throwing, so the pipeline stays
+     * resilient when new component names are added to rules.json.
+     *
+     * Contract:
+     *   • `result.filename` must equal `<PascalCaseName>.<componentExtension>`
+     *   • The generated file must compile cleanly for the target framework
+     *   • All visual values must be sourced from CSS custom properties or the
+     *     resolved token map — no hard-coded color/spacing literals
+     *   • The component must satisfy the accessibility requirements in `rule.a11y`
+     *
+     * @param componentName  PascalCase component name, e.g. "Button", "Input"
+     * @param config         The full resolved design system configuration
+     * @param rule           Governance rules for this component, or undefined if
+     *                       no rule was defined (adapter should use safe defaults)
+     */
+    generateComponent(componentName: string, config: DesignSystemConfig, rule: ComponentRule | undefined): GeneratedFile;
+    /**
+     * Generate the theme provider for this framework.
+     *
+     * The theme provider is responsible for:
+     *   • Accepting a theme name at runtime (e.g. "light" | "dark")
+     *   • Applying the correct CSS custom property overrides to a root element
+     *     (or equivalent mechanism in the target framework)
+     *   • Exposing a hook/composable/service for consumers to read + change the
+     *     active theme
+     *
+     * Contract:
+     *   • `result.filename` must equal `ThemeProvider.<componentExtension>`
+     *   • Theme names must be derived from `Object.keys(config.themes ?? {})`
+     *   • The default theme should be "light" if present, otherwise the first key
+     *
+     * @param config  Full design system configuration, including themes map
+     */
+    generateThemeProvider(config: DesignSystemConfig): GeneratedFile;
+    /**
+     * Generate the barrel index that re-exports all generated components.
+     *
+     * Consumers import from the package root via this file:
+     *   `import { Button, ThemeProvider } from "@myorg/my-ds"`
+     *
+     * Contract:
+     *   • `result.filename` must equal `index.<componentExtension>`
+     *     (or `index.ts` for frameworks that separate type and runtime exports)
+     *   • All names in `componentNames` plus ThemeProvider must be re-exported
+     *   • The file must not contain any implementation logic — only re-exports
+     *
+     * @param config          Full design system configuration
+     * @param componentNames  PascalCase component names that were successfully
+     *                        generated (may be a subset of rules keys if any
+     *                        generation step failed)
+     */
+    generateComponentIndex(config: DesignSystemConfig, componentNames: string[]): GeneratedFile;
+    /**
+     * Generate all token output files for this framework.
+     *
+     * The default React adapter produces:
+     *   • tokens/base.css      — all structural tokens as CSS custom properties
+     *   • tokens/light.css     — light theme overrides
+     *   • tokens/dark.css      — dark theme overrides
+     *   • tokens/tokens.js     — ESM export of all resolved tokens as JS consts
+     *   • tokens/tailwind.js   — Tailwind CSS theme extension object
+     *
+     * Other adapters may produce different formats. React Native would emit a
+     * tokens/tokens.ts with numeric values (no CSS vars); Angular might produce
+     * a SCSS variables file in addition to CSS custom properties.
+     *
+     * Contract:
+     *   • All returned filenames must be relative to the `tokens/` subdirectory
+     *   • At minimum, one file must carry the full resolved semantic token set
+     *     in a format the adapter's components can consume at runtime
+     *   • The token values must match `resolution.tokens` exactly — no
+     *     re-resolution or value transformation in the adapter
+     *
+     * @param config      Full design system configuration
+     * @param resolution  Pre-resolved token map from the core token resolver
+     */
+    generateTokenFiles(config: DesignSystemConfig, resolution: ResolutionResult): GeneratedFile[];
+    /**
+     * Generate component documentation files for this framework.
+     *
+     * The React adapter produces MDX files with live React component previews.
+     * A Vue adapter would produce MDX with `<script setup>` examples. Angular
+     * might produce plain Markdown with Angular template snippets.
+     *
+     * Contract:
+     *   • Must always produce at least one `index.<ext>` overview file
+     *   • Per-component docs must be named `<componentName>.<ext>` matching the
+     *     component names in `rules`
+     *   • Code examples in docs must use the correct framework import syntax,
+     *     pointing to the published package name from `config.meta`
+     *   • Docs must be kept in sync with `metadataMap` — props, variants, and
+     *     accessibility requirements must reflect the metadata, not be hardcoded
+     *
+     * @param config       Full design system configuration
+     * @param rules        Governance rules (source of truth for variants + props)
+     * @param metadataMap  Pre-generated AI metadata per component (use as the
+     *                     single source of truth for component capabilities)
+     */
+    generateDocs(config: DesignSystemConfig, rules: RulesConfig, metadataMap: Record<string, ComponentMetadata>): GeneratedFile[];
+    /**
+     * Generate the package.json for the published design system package.
+     *
+     * The published package is what downstream consumers install — it is
+     * distinct from the dsforge tool itself.
+     *
+     * Framework differences here are significant:
+     *   • React:        peerDependencies: { react: ">=17", react-dom: ">=17" }
+     *   • Vue:          peerDependencies: { vue: ">=3" }
+     *   • Angular:      peerDependencies: { @angular/core: ">=15" }
+     *   • React Native: peerDependencies: { react-native: ">=0.70" }
+     *   • Svelte:       peerDependencies: { svelte: ">=3" }
+     *
+     * The `exports` map should expose the correct entry points for the framework
+     * (e.g. Vue SFC consumers need `.vue` source files, not pre-compiled JS).
+     *
+     * Contract:
+     *   • `result.filename` must equal `package.json`
+     *   • `result.content` must be valid JSON parseable by `JSON.parse`
+     *   • `name` field must be `${config.meta.npmScope}/${config.meta.name}`
+     *   • `version` field must equal `config.meta.version`
+     *
+     * @param config          Full design system configuration
+     * @param componentNames  Names of all successfully generated components
+     */
+    generatePackageManifest(config: DesignSystemConfig, componentNames: string[]): GeneratedFile;
+}
+/**
+ * A lookup map of adapter name → adapter instance.
+ *
+ * The generate pipeline resolves the active adapter from this map using
+ * `config.output?.target ?? "react"` once Task 3 adds that config field.
+ *
+ * @example
+ *   const registry: AdapterRegistry = {
+ *     react:  new ReactAdapter(),
+ *     vue:    new VueAdapter(),
+ *   };
+ *   const adapter = registry[config.output?.target ?? "react"];
+ */
+type AdapterRegistry = Record<string, FrameworkAdapter>;
+
+declare const TokenLayersSchema: z.ZodObject<{
+    global: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    semantic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    component: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+}, "strip", z.ZodTypeAny, {
+    global?: Record<string, string | number> | undefined;
+    semantic?: Record<string, string | number> | undefined;
+    component?: Record<string, string | number> | undefined;
+}, {
+    global?: Record<string, string | number> | undefined;
+    semantic?: Record<string, string | number> | undefined;
+    component?: Record<string, string | number> | undefined;
+}>;
+declare const ColorConfigSchema: z.ZodObject<{
+    surface: z.ZodOptional<z.ZodObject<{
+        default: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        subtle: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        overlay: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        inverse: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, "strip", z.ZodTypeAny, {
+        default: string | number;
+        subtle?: string | number | undefined;
+        overlay?: string | number | undefined;
+        inverse?: string | number | undefined;
+    }, {
+        default: string | number;
+        subtle?: string | number | undefined;
+        overlay?: string | number | undefined;
+        inverse?: string | number | undefined;
+    }>>;
+    border: z.ZodOptional<z.ZodObject<{
+        default: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        strong: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        focus: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        subtle: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, "strip", z.ZodTypeAny, {
+        default: string | number;
+        subtle?: string | number | undefined;
+        strong?: string | number | undefined;
+        focus?: string | number | undefined;
+    }, {
+        default: string | number;
+        subtle?: string | number | undefined;
+        strong?: string | number | undefined;
+        focus?: string | number | undefined;
+    }>>;
+    text: z.ZodOptional<z.ZodObject<{
+        primary: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        secondary: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        disabled: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        inverse: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        onColor: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, "strip", z.ZodTypeAny, {
+        primary: string | number;
+        inverse?: string | number | undefined;
+        secondary?: string | number | undefined;
+        disabled?: string | number | undefined;
+        onColor?: string | number | undefined;
+    }, {
+        primary: string | number;
+        inverse?: string | number | undefined;
+        secondary?: string | number | undefined;
+        disabled?: string | number | undefined;
+        onColor?: string | number | undefined;
+    }>>;
+    status: z.ZodOptional<z.ZodObject<{
+        success: z.ZodOptional<z.ZodObject<{
+            bg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            fg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            border: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        }, "strip", z.ZodTypeAny, {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        }, {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        }>>;
+        warning: z.ZodOptional<z.ZodObject<{
+            bg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            fg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            border: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        }, "strip", z.ZodTypeAny, {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        }, {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        }>>;
+        danger: z.ZodOptional<z.ZodObject<{
+            bg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            fg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            border: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        }, "strip", z.ZodTypeAny, {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        }, {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        }>>;
+        info: z.ZodOptional<z.ZodObject<{
+            bg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            fg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            border: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        }, "strip", z.ZodTypeAny, {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        }, {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        warning?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        info?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        success?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        danger?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+    }, {
+        warning?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        info?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        success?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        danger?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+    }>>;
+    interactive: z.ZodOptional<z.ZodObject<{
+        primary: z.ZodOptional<z.ZodObject<{
+            rest: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            hover: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            active: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            disabled: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            selected: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        }, "strip", z.ZodTypeAny, {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        }, {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        }>>;
+        secondary: z.ZodOptional<z.ZodObject<{
+            rest: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            hover: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            active: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            disabled: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            selected: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        }, "strip", z.ZodTypeAny, {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        }, {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        }>>;
+        danger: z.ZodOptional<z.ZodObject<{
+            rest: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            hover: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            active: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            disabled: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            selected: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        }, "strip", z.ZodTypeAny, {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        }, {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        primary?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+        secondary?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+        danger?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+    }, {
+        primary?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+        secondary?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+        danger?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    status?: {
+        warning?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        info?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        success?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        danger?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+    } | undefined;
+    border?: {
+        default: string | number;
+        subtle?: string | number | undefined;
+        strong?: string | number | undefined;
+        focus?: string | number | undefined;
+    } | undefined;
+    surface?: {
+        default: string | number;
+        subtle?: string | number | undefined;
+        overlay?: string | number | undefined;
+        inverse?: string | number | undefined;
+    } | undefined;
+    text?: {
+        primary: string | number;
+        inverse?: string | number | undefined;
+        secondary?: string | number | undefined;
+        disabled?: string | number | undefined;
+        onColor?: string | number | undefined;
+    } | undefined;
+    interactive?: {
+        primary?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+        secondary?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+        danger?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    status?: {
+        warning?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        info?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        success?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+        danger?: {
+            bg: string | number;
+            fg: string | number;
+            border?: string | number | undefined;
+        } | undefined;
+    } | undefined;
+    border?: {
+        default: string | number;
+        subtle?: string | number | undefined;
+        strong?: string | number | undefined;
+        focus?: string | number | undefined;
+    } | undefined;
+    surface?: {
+        default: string | number;
+        subtle?: string | number | undefined;
+        overlay?: string | number | undefined;
+        inverse?: string | number | undefined;
+    } | undefined;
+    text?: {
+        primary: string | number;
+        inverse?: string | number | undefined;
+        secondary?: string | number | undefined;
+        disabled?: string | number | undefined;
+        onColor?: string | number | undefined;
+    } | undefined;
+    interactive?: {
+        primary?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+        secondary?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+        danger?: {
+            disabled: string | number;
+            rest: string | number;
+            hover: string | number;
+            active: string | number;
+            selected?: string | number | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+declare const TypographyConfigSchema: z.ZodObject<{
+    fontFamily: z.ZodString;
+    roles: z.ZodOptional<z.ZodObject<{
+        display: z.ZodOptional<z.ZodObject<{
+            size: z.ZodNumber;
+            weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+            lineHeight: z.ZodNumber;
+            letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }>>;
+        h1: z.ZodOptional<z.ZodObject<{
+            size: z.ZodNumber;
+            weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+            lineHeight: z.ZodNumber;
+            letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }>>;
+        h2: z.ZodOptional<z.ZodObject<{
+            size: z.ZodNumber;
+            weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+            lineHeight: z.ZodNumber;
+            letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }>>;
+        h3: z.ZodOptional<z.ZodObject<{
+            size: z.ZodNumber;
+            weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+            lineHeight: z.ZodNumber;
+            letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }>>;
+        body: z.ZodOptional<z.ZodObject<{
+            size: z.ZodNumber;
+            weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+            lineHeight: z.ZodNumber;
+            letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }>>;
+        small: z.ZodOptional<z.ZodObject<{
+            size: z.ZodNumber;
+            weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+            lineHeight: z.ZodNumber;
+            letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }>>;
+        caption: z.ZodOptional<z.ZodObject<{
+            size: z.ZodNumber;
+            weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+            lineHeight: z.ZodNumber;
+            letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }>>;
+        label: z.ZodOptional<z.ZodObject<{
+            size: z.ZodNumber;
+            weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+            lineHeight: z.ZodNumber;
+            letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }>>;
+        code: z.ZodOptional<z.ZodObject<{
+            size: z.ZodNumber;
+            weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+            lineHeight: z.ZodNumber;
+            letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }, {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        code?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        display?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h1?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h2?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h3?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        body?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        small?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        caption?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        label?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+    }, {
+        code?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        display?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h1?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h2?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h3?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        body?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        small?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        caption?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        label?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+    }>>;
+    /** Legacy — kept for backward compat; prefer roles */
+    scale: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    fontWeights: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    fontFamily: string;
+    roles?: {
+        code?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        display?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h1?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h2?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h3?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        body?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        small?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        caption?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        label?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+    } | undefined;
+    scale?: number[] | undefined;
+    fontWeights?: (100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900)[] | undefined;
+}, {
+    fontFamily: string;
+    roles?: {
+        code?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        display?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h1?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h2?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        h3?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        body?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        small?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        caption?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+        label?: {
+            size: number;
+            weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+            lineHeight: number;
+            letterSpacing?: string | number | undefined;
+            fontFamily?: string | undefined;
+        } | undefined;
+    } | undefined;
+    scale?: number[] | undefined;
+    fontWeights?: (100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900)[] | undefined;
+}>;
+declare const SpacingConfigSchema: z.ZodObject<{
+    baseUnit: z.ZodOptional<z.ZodNumber>;
+    scale: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    semantic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+}, "strip", z.ZodTypeAny, {
+    semantic?: Record<string, string | number> | undefined;
+    scale?: Record<string, number> | undefined;
+    baseUnit?: number | undefined;
+}, {
+    semantic?: Record<string, string | number> | undefined;
+    scale?: Record<string, number> | undefined;
+    baseUnit?: number | undefined;
+}>;
+declare const RadiusConfigSchema: z.ZodRecord<z.ZodString, z.ZodNumber>;
+declare const ElevationConfigSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+declare const MotionConfigSchema: z.ZodObject<{
+    duration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    easing: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    duration?: Record<string, number> | undefined;
+    easing?: Record<string, string> | undefined;
+}, {
+    duration?: Record<string, number> | undefined;
+    easing?: Record<string, string> | undefined;
+}>;
+declare const StatesConfigSchema: z.ZodObject<{
+    hoverOpacity: z.ZodOptional<z.ZodNumber>;
+    activeOpacity: z.ZodOptional<z.ZodNumber>;
+    disabledOpacity: z.ZodOptional<z.ZodNumber>;
+    focusRing: z.ZodOptional<z.ZodObject<{
+        color: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        width: z.ZodString;
+        offset: z.ZodString;
+        style: z.ZodOptional<z.ZodEnum<["solid", "dashed", "dotted"]>>;
+    }, "strip", z.ZodTypeAny, {
+        color: string | number;
+        width: string;
+        offset: string;
+        style?: "solid" | "dashed" | "dotted" | undefined;
+    }, {
+        color: string | number;
+        width: string;
+        offset: string;
+        style?: "solid" | "dashed" | "dotted" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    hoverOpacity?: number | undefined;
+    activeOpacity?: number | undefined;
+    disabledOpacity?: number | undefined;
+    focusRing?: {
+        color: string | number;
+        width: string;
+        offset: string;
+        style?: "solid" | "dashed" | "dotted" | undefined;
+    } | undefined;
+}, {
+    hoverOpacity?: number | undefined;
+    activeOpacity?: number | undefined;
+    disabledOpacity?: number | undefined;
+    focusRing?: {
+        color: string | number;
+        width: string;
+        offset: string;
+        style?: "solid" | "dashed" | "dotted" | undefined;
+    } | undefined;
+}>;
+declare const LayoutConfigSchema: z.ZodObject<{
+    breakpoints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    grid: z.ZodOptional<z.ZodObject<{
+        columns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        gutter: z.ZodOptional<z.ZodNumber>;
+        margin: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        columns?: Record<string, number> | undefined;
+        gutter?: number | undefined;
+        margin?: number | undefined;
+    }, {
+        columns?: Record<string, number> | undefined;
+        gutter?: number | undefined;
+        margin?: number | undefined;
+    }>>;
+    container: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    breakpoints?: Record<string, number> | undefined;
+    grid?: {
+        columns?: Record<string, number> | undefined;
+        gutter?: number | undefined;
+        margin?: number | undefined;
+    } | undefined;
+    container?: Record<string, number> | undefined;
+}, {
+    breakpoints?: Record<string, number> | undefined;
+    grid?: {
+        columns?: Record<string, number> | undefined;
+        gutter?: number | undefined;
+        margin?: number | undefined;
+    } | undefined;
+    container?: Record<string, number> | undefined;
+}>;
+declare const ThemesConfigSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+/**
+ * The set of framework adapter IDs the pipeline knows about.
+ * Adding a new adapter here is the only schema change needed when a
+ * new framework target ships.
+ */
+declare const SUPPORTED_TARGETS: readonly ["react"];
+declare const OutputConfigSchema: z.ZodOptional<z.ZodObject<{
+    /**
+     * The framework adapter to use when generating component files.
+     *
+     * @default "react"
+     *
+     * Supported values: "react"
+     * Future values: "vue", "svelte", "angular", "react-native"
+     *
+     * An unknown value here will fail validation with an actionable message
+     * rather than silently generating incorrect output.
+     */
+    target: z.ZodDefault<z.ZodEnum<["react"]>>;
+}, "strip", z.ZodTypeAny, {
+    target: "react";
+}, {
+    target?: "react" | undefined;
+}>>;
+declare const DesignSystemConfigSchema: z.ZodObject<{
+    meta: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        preset: z.ZodOptional<z.ZodEnum<["compact", "comfortable", "spacious"]>>;
+        npmScope: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        description?: string | undefined;
+        preset?: "compact" | "comfortable" | "spacious" | undefined;
+        npmScope?: string | undefined;
+    }, {
+        name: string;
+        version: string;
+        description?: string | undefined;
+        preset?: "compact" | "comfortable" | "spacious" | undefined;
+        npmScope?: string | undefined;
+    }>;
+    tokens: z.ZodOptional<z.ZodObject<{
+        global: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        semantic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        component: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    }, "strip", z.ZodTypeAny, {
+        global?: Record<string, string | number> | undefined;
+        semantic?: Record<string, string | number> | undefined;
+        component?: Record<string, string | number> | undefined;
+    }, {
+        global?: Record<string, string | number> | undefined;
+        semantic?: Record<string, string | number> | undefined;
+        component?: Record<string, string | number> | undefined;
+    }>>;
+    themes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>>;
+    color: z.ZodOptional<z.ZodObject<{
+        surface: z.ZodOptional<z.ZodObject<{
+            default: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            subtle: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            overlay: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            inverse: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        }, "strip", z.ZodTypeAny, {
+            default: string | number;
+            subtle?: string | number | undefined;
+            overlay?: string | number | undefined;
+            inverse?: string | number | undefined;
+        }, {
+            default: string | number;
+            subtle?: string | number | undefined;
+            overlay?: string | number | undefined;
+            inverse?: string | number | undefined;
+        }>>;
+        border: z.ZodOptional<z.ZodObject<{
+            default: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            strong: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            focus: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            subtle: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        }, "strip", z.ZodTypeAny, {
+            default: string | number;
+            subtle?: string | number | undefined;
+            strong?: string | number | undefined;
+            focus?: string | number | undefined;
+        }, {
+            default: string | number;
+            subtle?: string | number | undefined;
+            strong?: string | number | undefined;
+            focus?: string | number | undefined;
+        }>>;
+        text: z.ZodOptional<z.ZodObject<{
+            primary: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            secondary: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            disabled: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            inverse: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            onColor: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        }, "strip", z.ZodTypeAny, {
+            primary: string | number;
+            inverse?: string | number | undefined;
+            secondary?: string | number | undefined;
+            disabled?: string | number | undefined;
+            onColor?: string | number | undefined;
+        }, {
+            primary: string | number;
+            inverse?: string | number | undefined;
+            secondary?: string | number | undefined;
+            disabled?: string | number | undefined;
+            onColor?: string | number | undefined;
+        }>>;
+        status: z.ZodOptional<z.ZodObject<{
+            success: z.ZodOptional<z.ZodObject<{
+                bg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                fg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                border: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            }, "strip", z.ZodTypeAny, {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            }, {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            }>>;
+            warning: z.ZodOptional<z.ZodObject<{
+                bg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                fg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                border: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            }, "strip", z.ZodTypeAny, {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            }, {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            }>>;
+            danger: z.ZodOptional<z.ZodObject<{
+                bg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                fg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                border: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            }, "strip", z.ZodTypeAny, {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            }, {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            }>>;
+            info: z.ZodOptional<z.ZodObject<{
+                bg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                fg: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                border: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            }, "strip", z.ZodTypeAny, {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            }, {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            warning?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            info?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            success?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+        }, {
+            warning?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            info?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            success?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+        }>>;
+        interactive: z.ZodOptional<z.ZodObject<{
+            primary: z.ZodOptional<z.ZodObject<{
+                rest: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                hover: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                active: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                disabled: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                selected: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            }, "strip", z.ZodTypeAny, {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            }, {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            }>>;
+            secondary: z.ZodOptional<z.ZodObject<{
+                rest: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                hover: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                active: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                disabled: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                selected: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            }, "strip", z.ZodTypeAny, {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            }, {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            }>>;
+            danger: z.ZodOptional<z.ZodObject<{
+                rest: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                hover: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                active: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                disabled: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+                selected: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            }, "strip", z.ZodTypeAny, {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            }, {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            primary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            secondary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+        }, {
+            primary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            secondary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        status?: {
+            warning?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            info?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            success?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+        } | undefined;
+        border?: {
+            default: string | number;
+            subtle?: string | number | undefined;
+            strong?: string | number | undefined;
+            focus?: string | number | undefined;
+        } | undefined;
+        surface?: {
+            default: string | number;
+            subtle?: string | number | undefined;
+            overlay?: string | number | undefined;
+            inverse?: string | number | undefined;
+        } | undefined;
+        text?: {
+            primary: string | number;
+            inverse?: string | number | undefined;
+            secondary?: string | number | undefined;
+            disabled?: string | number | undefined;
+            onColor?: string | number | undefined;
+        } | undefined;
+        interactive?: {
+            primary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            secondary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        status?: {
+            warning?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            info?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            success?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+        } | undefined;
+        border?: {
+            default: string | number;
+            subtle?: string | number | undefined;
+            strong?: string | number | undefined;
+            focus?: string | number | undefined;
+        } | undefined;
+        surface?: {
+            default: string | number;
+            subtle?: string | number | undefined;
+            overlay?: string | number | undefined;
+            inverse?: string | number | undefined;
+        } | undefined;
+        text?: {
+            primary: string | number;
+            inverse?: string | number | undefined;
+            secondary?: string | number | undefined;
+            disabled?: string | number | undefined;
+            onColor?: string | number | undefined;
+        } | undefined;
+        interactive?: {
+            primary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            secondary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+        } | undefined;
+    }>>;
+    typography: z.ZodOptional<z.ZodObject<{
+        fontFamily: z.ZodString;
+        roles: z.ZodOptional<z.ZodObject<{
+            display: z.ZodOptional<z.ZodObject<{
+                size: z.ZodNumber;
+                weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+                lineHeight: z.ZodNumber;
+                letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+                fontFamily: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }>>;
+            h1: z.ZodOptional<z.ZodObject<{
+                size: z.ZodNumber;
+                weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+                lineHeight: z.ZodNumber;
+                letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+                fontFamily: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }>>;
+            h2: z.ZodOptional<z.ZodObject<{
+                size: z.ZodNumber;
+                weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+                lineHeight: z.ZodNumber;
+                letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+                fontFamily: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }>>;
+            h3: z.ZodOptional<z.ZodObject<{
+                size: z.ZodNumber;
+                weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+                lineHeight: z.ZodNumber;
+                letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+                fontFamily: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }>>;
+            body: z.ZodOptional<z.ZodObject<{
+                size: z.ZodNumber;
+                weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+                lineHeight: z.ZodNumber;
+                letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+                fontFamily: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }>>;
+            small: z.ZodOptional<z.ZodObject<{
+                size: z.ZodNumber;
+                weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+                lineHeight: z.ZodNumber;
+                letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+                fontFamily: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }>>;
+            caption: z.ZodOptional<z.ZodObject<{
+                size: z.ZodNumber;
+                weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+                lineHeight: z.ZodNumber;
+                letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+                fontFamily: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }>>;
+            label: z.ZodOptional<z.ZodObject<{
+                size: z.ZodNumber;
+                weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+                lineHeight: z.ZodNumber;
+                letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+                fontFamily: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }>>;
+            code: z.ZodOptional<z.ZodObject<{
+                size: z.ZodNumber;
+                weight: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>;
+                lineHeight: z.ZodNumber;
+                letterSpacing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+                fontFamily: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }, {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            code?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            display?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h1?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h2?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h3?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            body?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            small?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            caption?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            label?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+        }, {
+            code?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            display?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h1?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h2?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h3?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            body?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            small?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            caption?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            label?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+        }>>;
+        /** Legacy — kept for backward compat; prefer roles */
+        scale: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        fontWeights: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>, z.ZodLiteral<900>]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        fontFamily: string;
+        roles?: {
+            code?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            display?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h1?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h2?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h3?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            body?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            small?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            caption?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            label?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+        } | undefined;
+        scale?: number[] | undefined;
+        fontWeights?: (100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900)[] | undefined;
+    }, {
+        fontFamily: string;
+        roles?: {
+            code?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            display?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h1?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h2?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h3?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            body?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            small?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            caption?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            label?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+        } | undefined;
+        scale?: number[] | undefined;
+        fontWeights?: (100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900)[] | undefined;
+    }>>;
+    spacing: z.ZodOptional<z.ZodObject<{
+        baseUnit: z.ZodOptional<z.ZodNumber>;
+        scale: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        semantic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    }, "strip", z.ZodTypeAny, {
+        semantic?: Record<string, string | number> | undefined;
+        scale?: Record<string, number> | undefined;
+        baseUnit?: number | undefined;
+    }, {
+        semantic?: Record<string, string | number> | undefined;
+        scale?: Record<string, number> | undefined;
+        baseUnit?: number | undefined;
+    }>>;
+    radius: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    elevation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    motion: z.ZodOptional<z.ZodObject<{
+        duration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        easing: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        duration?: Record<string, number> | undefined;
+        easing?: Record<string, string> | undefined;
+    }, {
+        duration?: Record<string, number> | undefined;
+        easing?: Record<string, string> | undefined;
+    }>>;
+    states: z.ZodOptional<z.ZodObject<{
+        hoverOpacity: z.ZodOptional<z.ZodNumber>;
+        activeOpacity: z.ZodOptional<z.ZodNumber>;
+        disabledOpacity: z.ZodOptional<z.ZodNumber>;
+        focusRing: z.ZodOptional<z.ZodObject<{
+            color: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+            width: z.ZodString;
+            offset: z.ZodString;
+            style: z.ZodOptional<z.ZodEnum<["solid", "dashed", "dotted"]>>;
+        }, "strip", z.ZodTypeAny, {
+            color: string | number;
+            width: string;
+            offset: string;
+            style?: "solid" | "dashed" | "dotted" | undefined;
+        }, {
+            color: string | number;
+            width: string;
+            offset: string;
+            style?: "solid" | "dashed" | "dotted" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        hoverOpacity?: number | undefined;
+        activeOpacity?: number | undefined;
+        disabledOpacity?: number | undefined;
+        focusRing?: {
+            color: string | number;
+            width: string;
+            offset: string;
+            style?: "solid" | "dashed" | "dotted" | undefined;
+        } | undefined;
+    }, {
+        hoverOpacity?: number | undefined;
+        activeOpacity?: number | undefined;
+        disabledOpacity?: number | undefined;
+        focusRing?: {
+            color: string | number;
+            width: string;
+            offset: string;
+            style?: "solid" | "dashed" | "dotted" | undefined;
+        } | undefined;
+    }>>;
+    layout: z.ZodOptional<z.ZodObject<{
+        breakpoints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        grid: z.ZodOptional<z.ZodObject<{
+            columns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            gutter: z.ZodOptional<z.ZodNumber>;
+            margin: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            columns?: Record<string, number> | undefined;
+            gutter?: number | undefined;
+            margin?: number | undefined;
+        }, {
+            columns?: Record<string, number> | undefined;
+            gutter?: number | undefined;
+            margin?: number | undefined;
+        }>>;
+        container: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        breakpoints?: Record<string, number> | undefined;
+        grid?: {
+            columns?: Record<string, number> | undefined;
+            gutter?: number | undefined;
+            margin?: number | undefined;
+        } | undefined;
+        container?: Record<string, number> | undefined;
+    }, {
+        breakpoints?: Record<string, number> | undefined;
+        grid?: {
+            columns?: Record<string, number> | undefined;
+            gutter?: number | undefined;
+            margin?: number | undefined;
+        } | undefined;
+        container?: Record<string, number> | undefined;
+    }>>;
+    philosophy: z.ZodOptional<z.ZodObject<{
+        density: z.ZodOptional<z.ZodEnum<["compact", "comfortable", "spacious"]>>;
+        elevation: z.ZodOptional<z.ZodEnum<["minimal", "moderate", "expressive"]>>;
+        motion: z.ZodOptional<z.ZodEnum<["none", "reduced", "full"]>>;
+    }, "strip", z.ZodTypeAny, {
+        density?: "compact" | "comfortable" | "spacious" | undefined;
+        elevation?: "minimal" | "moderate" | "expressive" | undefined;
+        motion?: "none" | "full" | "reduced" | undefined;
+    }, {
+        density?: "compact" | "comfortable" | "spacious" | undefined;
+        elevation?: "minimal" | "moderate" | "expressive" | undefined;
+        motion?: "none" | "full" | "reduced" | undefined;
+    }>>;
+    customization: z.ZodOptional<z.ZodObject<{
+        extends: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    }, "strip", z.ZodTypeAny, {
+        extends?: string | null | undefined;
+        overrides?: Record<string, string | number> | undefined;
+    }, {
+        extends?: string | null | undefined;
+        overrides?: Record<string, string | number> | undefined;
+    }>>;
+    output: z.ZodOptional<z.ZodObject<{
+        /**
+         * The framework adapter to use when generating component files.
+         *
+         * @default "react"
+         *
+         * Supported values: "react"
+         * Future values: "vue", "svelte", "angular", "react-native"
+         *
+         * An unknown value here will fail validation with an actionable message
+         * rather than silently generating incorrect output.
+         */
+        target: z.ZodDefault<z.ZodEnum<["react"]>>;
+    }, "strip", z.ZodTypeAny, {
+        target: "react";
+    }, {
+        target?: "react" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    meta: {
+        name: string;
+        version: string;
+        description?: string | undefined;
+        preset?: "compact" | "comfortable" | "spacious" | undefined;
+        npmScope?: string | undefined;
+    };
+    tokens?: {
+        global?: Record<string, string | number> | undefined;
+        semantic?: Record<string, string | number> | undefined;
+        component?: Record<string, string | number> | undefined;
+    } | undefined;
+    color?: {
+        status?: {
+            warning?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            info?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            success?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+        } | undefined;
+        border?: {
+            default: string | number;
+            subtle?: string | number | undefined;
+            strong?: string | number | undefined;
+            focus?: string | number | undefined;
+        } | undefined;
+        surface?: {
+            default: string | number;
+            subtle?: string | number | undefined;
+            overlay?: string | number | undefined;
+            inverse?: string | number | undefined;
+        } | undefined;
+        text?: {
+            primary: string | number;
+            inverse?: string | number | undefined;
+            secondary?: string | number | undefined;
+            disabled?: string | number | undefined;
+            onColor?: string | number | undefined;
+        } | undefined;
+        interactive?: {
+            primary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            secondary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    elevation?: Record<string, string> | undefined;
+    motion?: {
+        duration?: Record<string, number> | undefined;
+        easing?: Record<string, string> | undefined;
+    } | undefined;
+    themes?: Record<string, Record<string, string | number>> | undefined;
+    typography?: {
+        fontFamily: string;
+        roles?: {
+            code?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            display?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h1?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h2?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h3?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            body?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            small?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            caption?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            label?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+        } | undefined;
+        scale?: number[] | undefined;
+        fontWeights?: (100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900)[] | undefined;
+    } | undefined;
+    spacing?: {
+        semantic?: Record<string, string | number> | undefined;
+        scale?: Record<string, number> | undefined;
+        baseUnit?: number | undefined;
+    } | undefined;
+    radius?: Record<string, number> | undefined;
+    states?: {
+        hoverOpacity?: number | undefined;
+        activeOpacity?: number | undefined;
+        disabledOpacity?: number | undefined;
+        focusRing?: {
+            color: string | number;
+            width: string;
+            offset: string;
+            style?: "solid" | "dashed" | "dotted" | undefined;
+        } | undefined;
+    } | undefined;
+    layout?: {
+        breakpoints?: Record<string, number> | undefined;
+        grid?: {
+            columns?: Record<string, number> | undefined;
+            gutter?: number | undefined;
+            margin?: number | undefined;
+        } | undefined;
+        container?: Record<string, number> | undefined;
+    } | undefined;
+    philosophy?: {
+        density?: "compact" | "comfortable" | "spacious" | undefined;
+        elevation?: "minimal" | "moderate" | "expressive" | undefined;
+        motion?: "none" | "full" | "reduced" | undefined;
+    } | undefined;
+    customization?: {
+        extends?: string | null | undefined;
+        overrides?: Record<string, string | number> | undefined;
+    } | undefined;
+    output?: {
+        target: "react";
+    } | undefined;
+}, {
+    meta: {
+        name: string;
+        version: string;
+        description?: string | undefined;
+        preset?: "compact" | "comfortable" | "spacious" | undefined;
+        npmScope?: string | undefined;
+    };
+    tokens?: {
+        global?: Record<string, string | number> | undefined;
+        semantic?: Record<string, string | number> | undefined;
+        component?: Record<string, string | number> | undefined;
+    } | undefined;
+    color?: {
+        status?: {
+            warning?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            info?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            success?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                bg: string | number;
+                fg: string | number;
+                border?: string | number | undefined;
+            } | undefined;
+        } | undefined;
+        border?: {
+            default: string | number;
+            subtle?: string | number | undefined;
+            strong?: string | number | undefined;
+            focus?: string | number | undefined;
+        } | undefined;
+        surface?: {
+            default: string | number;
+            subtle?: string | number | undefined;
+            overlay?: string | number | undefined;
+            inverse?: string | number | undefined;
+        } | undefined;
+        text?: {
+            primary: string | number;
+            inverse?: string | number | undefined;
+            secondary?: string | number | undefined;
+            disabled?: string | number | undefined;
+            onColor?: string | number | undefined;
+        } | undefined;
+        interactive?: {
+            primary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            secondary?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+            danger?: {
+                disabled: string | number;
+                rest: string | number;
+                hover: string | number;
+                active: string | number;
+                selected?: string | number | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    elevation?: Record<string, string> | undefined;
+    motion?: {
+        duration?: Record<string, number> | undefined;
+        easing?: Record<string, string> | undefined;
+    } | undefined;
+    themes?: Record<string, Record<string, string | number>> | undefined;
+    typography?: {
+        fontFamily: string;
+        roles?: {
+            code?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            display?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h1?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h2?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            h3?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            body?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            small?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            caption?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+            label?: {
+                size: number;
+                weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+                lineHeight: number;
+                letterSpacing?: string | number | undefined;
+                fontFamily?: string | undefined;
+            } | undefined;
+        } | undefined;
+        scale?: number[] | undefined;
+        fontWeights?: (100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900)[] | undefined;
+    } | undefined;
+    spacing?: {
+        semantic?: Record<string, string | number> | undefined;
+        scale?: Record<string, number> | undefined;
+        baseUnit?: number | undefined;
+    } | undefined;
+    radius?: Record<string, number> | undefined;
+    states?: {
+        hoverOpacity?: number | undefined;
+        activeOpacity?: number | undefined;
+        disabledOpacity?: number | undefined;
+        focusRing?: {
+            color: string | number;
+            width: string;
+            offset: string;
+            style?: "solid" | "dashed" | "dotted" | undefined;
+        } | undefined;
+    } | undefined;
+    layout?: {
+        breakpoints?: Record<string, number> | undefined;
+        grid?: {
+            columns?: Record<string, number> | undefined;
+            gutter?: number | undefined;
+            margin?: number | undefined;
+        } | undefined;
+        container?: Record<string, number> | undefined;
+    } | undefined;
+    philosophy?: {
+        density?: "compact" | "comfortable" | "spacious" | undefined;
+        elevation?: "minimal" | "moderate" | "expressive" | undefined;
+        motion?: "none" | "full" | "reduced" | undefined;
+    } | undefined;
+    customization?: {
+        extends?: string | null | undefined;
+        overrides?: Record<string, string | number> | undefined;
+    } | undefined;
+    output?: {
+        target?: "react" | undefined;
+    } | undefined;
+}>;
+declare const RulesConfigSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    allowedVariants: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requiredProps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    maxWidth: z.ZodOptional<z.ZodString>;
+    allowedRadius: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    allowedShadows: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    colorPalette: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tokens: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    a11y: z.ZodOptional<z.ZodObject<{
+        keyboard: z.ZodOptional<z.ZodBoolean>;
+        focusRing: z.ZodOptional<z.ZodBoolean>;
+        ariaLabel: z.ZodOptional<z.ZodEnum<["required", "optional", "forbidden"]>>;
+        role: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        focusRing?: boolean | undefined;
+        keyboard?: boolean | undefined;
+        ariaLabel?: "required" | "optional" | "forbidden" | undefined;
+        role?: string | undefined;
+    }, {
+        focusRing?: boolean | undefined;
+        keyboard?: boolean | undefined;
+        ariaLabel?: "required" | "optional" | "forbidden" | undefined;
+        role?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    tokens?: Record<string, string | number> | undefined;
+    allowedVariants?: string[] | undefined;
+    requiredProps?: string[] | undefined;
+    maxWidth?: string | undefined;
+    allowedRadius?: string[] | undefined;
+    allowedShadows?: string[] | undefined;
+    colorPalette?: string[] | undefined;
+    a11y?: {
+        focusRing?: boolean | undefined;
+        keyboard?: boolean | undefined;
+        ariaLabel?: "required" | "optional" | "forbidden" | undefined;
+        role?: string | undefined;
+    } | undefined;
+}, {
+    tokens?: Record<string, string | number> | undefined;
+    allowedVariants?: string[] | undefined;
+    requiredProps?: string[] | undefined;
+    maxWidth?: string | undefined;
+    allowedRadius?: string[] | undefined;
+    allowedShadows?: string[] | undefined;
+    colorPalette?: string[] | undefined;
+    a11y?: {
+        focusRing?: boolean | undefined;
+        keyboard?: boolean | undefined;
+        ariaLabel?: "required" | "optional" | "forbidden" | undefined;
+        role?: string | undefined;
+    } | undefined;
+}>>;
+
+export { type AdapterRegistry, CircularReferenceError, type ColorConfig, ColorConfigSchema, type ComponentTokens, type DesignSystemConfig, DesignSystemConfigSchema, type ElevationConfig, ElevationConfigSchema, type FrameworkAdapter, type GeneratedFile, type GlobalTokens, type IssueSeverity, type LayoutConfig, LayoutConfigSchema, type MetaConfig, type MotionConfig, MotionConfigSchema, type OutputConfig, OutputConfigSchema, type OutputTarget, type RadiusConfig, RadiusConfigSchema, type RawValue, type ResolvedConfig, type ResolvedTokenMap, type RulesConfig, RulesConfigSchema, SUPPORTED_TARGETS, type SemanticTokens, type SpacingConfig, SpacingConfigSchema, type StatesConfig, StatesConfigSchema, type ThemesConfig, ThemesConfigSchema, type TokenLayers, TokenLayersSchema, TokenResolutionError, TokenResolver, type TokenValue, type TypographyConfig, TypographyConfigSchema, type TypographyRole, UnresolvedReferenceError, type ValidationIssue, type ValidationResult, buildInitialConfig, buildInitialRules, buildThemeCss, checkContrast, emitBaseCss, emitJsTokens, emitTailwindConfig, emitThemeCss, extractRefs, generateButton, generateCard, generateChangelog, generateComponentIndex, generateCssFiles, generateDocs, generateInput, generateMetadata, generatePackageJson, generateReadme, generateThemeProvider, generateTsConfig, hasRefs, hexContrastRatio, isHexColor, resolveTokens, suggestContrastFix, validateConfig };