@tekton-ui/core 0.2.0

package/dist/layout-validation.d.ts

@@ -0,0 +1,1547 @@
+/**
+ * @tekton-ui/core - Layout Token Validation
+ * Zod-based runtime validation for 4-layer layout token architecture
+ * [SPEC-LAYOUT-001] [PHASE-2]
+ */
+import { z } from 'zod';
+import type { TokenReference } from './token-resolver.js';
+import type { ResponsiveConfig, ShellToken, PageLayoutToken, SectionPatternToken, MobileShellToken } from './layout-tokens/types.js';
+/**
+ * Token Reference Schema
+ * Validates token reference format: "atomic.spacing.16" or "semantic.color.primary"
+ */
+export declare const TokenReferenceSchema: z.ZodString;
+/**
+ * Responsive Token Schema
+ * Validates breakpoint definitions
+ */
+export declare const ResponsiveTokenSchema: z.ZodObject<{
+    id: z.ZodString;
+    minWidth: z.ZodNumber;
+    maxWidth: z.ZodOptional<z.ZodNumber>;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    id: string;
+    minWidth: number;
+    maxWidth?: number | undefined;
+}, {
+    description: string;
+    id: string;
+    minWidth: number;
+    maxWidth?: number | undefined;
+}>;
+/**
+ * Generic Responsive Configuration Schema
+ * Validates responsive config with breakpoint overrides
+ *
+ * Note: Uses z.any() for breakpoint overrides since they are Partial<T> and flexible
+ */
+export declare function ResponsiveConfigSchema<T extends z.ZodTypeAny>(configSchema: T): z.ZodType<ResponsiveConfig<z.infer<T>>>;
+/**
+ * Shell Region Position Schema
+ */
+export declare const ShellRegionPositionSchema: z.ZodEnum<["top", "left", "right", "bottom", "center"]>;
+/**
+ * Shell Region Schema
+ * Validates shell region configuration
+ */
+export declare const ShellRegionSchema: z.ZodObject<{
+    name: z.ZodString;
+    position: z.ZodEnum<["top", "left", "right", "bottom", "center"]>;
+    size: z.ZodString;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    position: "top" | "left" | "right" | "bottom" | "center";
+    size: string;
+    collapsible?: boolean | undefined;
+    defaultCollapsed?: boolean | undefined;
+}, {
+    name: string;
+    position: "top" | "left" | "right" | "bottom" | "center";
+    size: string;
+    collapsible?: boolean | undefined;
+    defaultCollapsed?: boolean | undefined;
+}>;
+/**
+ * Shell Config Schema
+ * Flexible schema for shell-level settings
+ */
+export declare const ShellConfigSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/**
+ * Shell Token Schema
+ * Validates complete shell token structure
+ */
+export declare const ShellTokenSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    platform: z.ZodEnum<["web", "mobile", "desktop"]>;
+    regions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        position: z.ZodEnum<["top", "left", "right", "bottom", "center"]>;
+        size: z.ZodString;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }, {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }>, "many">;
+    responsive: z.ZodType<ResponsiveConfig<Record<string, unknown>>, z.ZodTypeDef, ResponsiveConfig<Record<string, unknown>>>;
+    tokenBindings: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    tokenBindings: Record<string, string>;
+    id: string;
+    responsive: ResponsiveConfig<Record<string, unknown>>;
+    platform: "web" | "mobile" | "desktop";
+    regions: {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }[];
+}, {
+    description: string;
+    tokenBindings: Record<string, string>;
+    id: string;
+    responsive: ResponsiveConfig<Record<string, unknown>>;
+    platform: "web" | "mobile" | "desktop";
+    regions: {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }[];
+}>;
+/**
+ * Page Purpose Schema
+ */
+export declare const PagePurposeSchema: z.ZodEnum<["job", "resource", "dashboard", "settings", "detail", "empty", "wizard", "onboarding"]>;
+/**
+ * Section Slot Schema
+ * Validates section slot configuration
+ */
+export declare const SectionSlotSchema: z.ZodObject<{
+    name: z.ZodString;
+    pattern: z.ZodString;
+    required: z.ZodBoolean;
+    allowedComponents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    required: boolean;
+    pattern: string;
+    allowedComponents?: string[] | undefined;
+}, {
+    name: string;
+    required: boolean;
+    pattern: string;
+    allowedComponents?: string[] | undefined;
+}>;
+/**
+ * Page Config Schema
+ * Flexible schema for page-level settings
+ */
+export declare const PageConfigSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/**
+ * Page Layout Token Schema
+ * Validates complete page layout structure
+ */
+export declare const PageLayoutTokenSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    purpose: z.ZodEnum<["job", "resource", "dashboard", "settings", "detail", "empty", "wizard", "onboarding"]>;
+    sections: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        pattern: z.ZodString;
+        required: z.ZodBoolean;
+        allowedComponents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        required: boolean;
+        pattern: string;
+        allowedComponents?: string[] | undefined;
+    }, {
+        name: string;
+        required: boolean;
+        pattern: string;
+        allowedComponents?: string[] | undefined;
+    }>, "many">;
+    responsive: z.ZodType<ResponsiveConfig<Record<string, unknown>>, z.ZodTypeDef, ResponsiveConfig<Record<string, unknown>>>;
+    tokenBindings: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    tokenBindings: Record<string, string>;
+    id: string;
+    responsive: ResponsiveConfig<Record<string, unknown>>;
+    sections: {
+        name: string;
+        required: boolean;
+        pattern: string;
+        allowedComponents?: string[] | undefined;
+    }[];
+    purpose: "job" | "resource" | "dashboard" | "settings" | "detail" | "empty" | "wizard" | "onboarding";
+}, {
+    description: string;
+    tokenBindings: Record<string, string>;
+    id: string;
+    responsive: ResponsiveConfig<Record<string, unknown>>;
+    sections: {
+        name: string;
+        required: boolean;
+        pattern: string;
+        allowedComponents?: string[] | undefined;
+    }[];
+    purpose: "job" | "resource" | "dashboard" | "settings" | "detail" | "empty" | "wizard" | "onboarding";
+}>;
+/**
+ * Section Type Schema
+ */
+export declare const SectionTypeSchema: z.ZodEnum<["grid", "flex", "split", "stack", "container"]>;
+/**
+ * Section CSS Schema
+ * Validates section CSS properties
+ */
+export declare const SectionCSSSchema: z.ZodObject<{
+    display: z.ZodEnum<["grid", "flex"]>;
+    gridTemplateColumns: z.ZodOptional<z.ZodString>;
+    gridTemplateRows: z.ZodOptional<z.ZodString>;
+    gap: z.ZodOptional<z.ZodString>;
+    flexDirection: z.ZodOptional<z.ZodEnum<["row", "column"]>>;
+    alignItems: z.ZodOptional<z.ZodString>;
+    justifyContent: z.ZodOptional<z.ZodString>;
+    maxWidth: z.ZodOptional<z.ZodString>;
+    padding: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    display: "grid" | "flex";
+    maxWidth?: string | undefined;
+    gridTemplateColumns?: string | undefined;
+    gridTemplateRows?: string | undefined;
+    gap?: string | undefined;
+    flexDirection?: "row" | "column" | undefined;
+    alignItems?: string | undefined;
+    justifyContent?: string | undefined;
+    padding?: string | undefined;
+}, {
+    display: "grid" | "flex";
+    maxWidth?: string | undefined;
+    gridTemplateColumns?: string | undefined;
+    gridTemplateRows?: string | undefined;
+    gap?: string | undefined;
+    flexDirection?: "row" | "column" | undefined;
+    alignItems?: string | undefined;
+    justifyContent?: string | undefined;
+    padding?: string | undefined;
+}>;
+/**
+ * Section Pattern Token Schema
+ * Validates complete section pattern structure
+ */
+export declare const SectionPatternTokenSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<["grid", "flex", "split", "stack", "container"]>;
+    description: z.ZodString;
+    css: z.ZodObject<{
+        display: z.ZodEnum<["grid", "flex"]>;
+        gridTemplateColumns: z.ZodOptional<z.ZodString>;
+        gridTemplateRows: z.ZodOptional<z.ZodString>;
+        gap: z.ZodOptional<z.ZodString>;
+        flexDirection: z.ZodOptional<z.ZodEnum<["row", "column"]>>;
+        alignItems: z.ZodOptional<z.ZodString>;
+        justifyContent: z.ZodOptional<z.ZodString>;
+        maxWidth: z.ZodOptional<z.ZodString>;
+        padding: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    }, {
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    }>;
+    responsive: z.ZodType<ResponsiveConfig<{
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    }>, z.ZodTypeDef, ResponsiveConfig<{
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    }>>;
+    tokenBindings: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>;
+}, "strip", z.ZodTypeAny, {
+    type: "grid" | "flex" | "split" | "stack" | "container";
+    description: string;
+    tokenBindings: Record<string, string>;
+    id: string;
+    responsive: ResponsiveConfig<{
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    }>;
+    css: {
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    };
+}, {
+    type: "grid" | "flex" | "split" | "stack" | "container";
+    description: string;
+    tokenBindings: Record<string, string>;
+    id: string;
+    responsive: ResponsiveConfig<{
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    }>;
+    css: {
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    };
+}>;
+/**
+ * Safe Area Defaults Schema
+ * Validates device-specific safe area measurements
+ */
+export declare const SafeAreaDefaultsSchema: z.ZodObject<{
+    notch: z.ZodNumber;
+    dynamicIsland: z.ZodNumber;
+    homeIndicator: z.ZodNumber;
+    statusBar: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    notch: number;
+    dynamicIsland: number;
+    homeIndicator: number;
+    statusBar: number;
+}, {
+    notch: number;
+    dynamicIsland: number;
+    homeIndicator: number;
+    statusBar: number;
+}>;
+/**
+ * Safe Area Edges Schema
+ * Validates which edges should respect safe area insets
+ */
+export declare const SafeAreaEdgesSchema: z.ZodObject<{
+    top: z.ZodBoolean;
+    bottom: z.ZodBoolean;
+    horizontal: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    top: boolean;
+    bottom: boolean;
+    horizontal: boolean;
+}, {
+    top: boolean;
+    bottom: boolean;
+    horizontal: boolean;
+}>;
+/**
+ * Safe Area Config Schema
+ * Validates complete safe area configuration
+ */
+export declare const SafeAreaConfigSchema: z.ZodObject<{
+    top: z.ZodString;
+    bottom: z.ZodString;
+    left: z.ZodString;
+    right: z.ZodString;
+    defaults: z.ZodObject<{
+        notch: z.ZodNumber;
+        dynamicIsland: z.ZodNumber;
+        homeIndicator: z.ZodNumber;
+        statusBar: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        notch: number;
+        dynamicIsland: number;
+        homeIndicator: number;
+        statusBar: number;
+    }, {
+        notch: number;
+        dynamicIsland: number;
+        homeIndicator: number;
+        statusBar: number;
+    }>;
+    edges: z.ZodObject<{
+        top: z.ZodBoolean;
+        bottom: z.ZodBoolean;
+        horizontal: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        top: boolean;
+        bottom: boolean;
+        horizontal: boolean;
+    }, {
+        top: boolean;
+        bottom: boolean;
+        horizontal: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    top: string;
+    left: string;
+    right: string;
+    bottom: string;
+    defaults: {
+        notch: number;
+        dynamicIsland: number;
+        homeIndicator: number;
+        statusBar: number;
+    };
+    edges: {
+        top: boolean;
+        bottom: boolean;
+        horizontal: boolean;
+    };
+}, {
+    top: string;
+    left: string;
+    right: string;
+    bottom: string;
+    defaults: {
+        notch: number;
+        dynamicIsland: number;
+        homeIndicator: number;
+        statusBar: number;
+    };
+    edges: {
+        top: boolean;
+        bottom: boolean;
+        horizontal: boolean;
+    };
+}>;
+/**
+ * Status Bar Config Schema
+ * Validates mobile status bar configuration
+ */
+export declare const StatusBarConfigSchema: z.ZodObject<{
+    height: z.ZodString;
+    visible: z.ZodBoolean;
+    style: z.ZodEnum<["light-content", "dark-content", "auto"]>;
+    backgroundColor: z.ZodOptional<z.ZodString>;
+    translucent: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    height: string;
+    visible: boolean;
+    style: "light-content" | "dark-content" | "auto";
+    translucent: boolean;
+    backgroundColor?: string | undefined;
+}, {
+    height: string;
+    visible: boolean;
+    style: "light-content" | "dark-content" | "auto";
+    translucent: boolean;
+    backgroundColor?: string | undefined;
+}>;
+/**
+ * Navigation Bar Config Schema
+ * Validates Android navigation bar configuration
+ */
+export declare const NavigationBarConfigSchema: z.ZodObject<{
+    height: z.ZodString;
+    mode: z.ZodEnum<["overlay", "inset", "hidden"]>;
+    backgroundColor: z.ZodOptional<z.ZodString>;
+    buttonStyle: z.ZodEnum<["light", "dark", "auto"]>;
+}, "strip", z.ZodTypeAny, {
+    height: string;
+    mode: "overlay" | "inset" | "hidden";
+    buttonStyle: "auto" | "light" | "dark";
+    backgroundColor?: string | undefined;
+}, {
+    height: string;
+    mode: "overlay" | "inset" | "hidden";
+    buttonStyle: "auto" | "light" | "dark";
+    backgroundColor?: string | undefined;
+}>;
+/**
+ * System UI Config Schema
+ * Validates combined status bar and navigation bar configuration
+ */
+export declare const SystemUIConfigSchema: z.ZodObject<{
+    statusBar: z.ZodObject<{
+        height: z.ZodString;
+        visible: z.ZodBoolean;
+        style: z.ZodEnum<["light-content", "dark-content", "auto"]>;
+        backgroundColor: z.ZodOptional<z.ZodString>;
+        translucent: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        height: string;
+        visible: boolean;
+        style: "light-content" | "dark-content" | "auto";
+        translucent: boolean;
+        backgroundColor?: string | undefined;
+    }, {
+        height: string;
+        visible: boolean;
+        style: "light-content" | "dark-content" | "auto";
+        translucent: boolean;
+        backgroundColor?: string | undefined;
+    }>;
+    navigationBar: z.ZodObject<{
+        height: z.ZodString;
+        mode: z.ZodEnum<["overlay", "inset", "hidden"]>;
+        backgroundColor: z.ZodOptional<z.ZodString>;
+        buttonStyle: z.ZodEnum<["light", "dark", "auto"]>;
+    }, "strip", z.ZodTypeAny, {
+        height: string;
+        mode: "overlay" | "inset" | "hidden";
+        buttonStyle: "auto" | "light" | "dark";
+        backgroundColor?: string | undefined;
+    }, {
+        height: string;
+        mode: "overlay" | "inset" | "hidden";
+        buttonStyle: "auto" | "light" | "dark";
+        backgroundColor?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    statusBar: {
+        height: string;
+        visible: boolean;
+        style: "light-content" | "dark-content" | "auto";
+        translucent: boolean;
+        backgroundColor?: string | undefined;
+    };
+    navigationBar: {
+        height: string;
+        mode: "overlay" | "inset" | "hidden";
+        buttonStyle: "auto" | "light" | "dark";
+        backgroundColor?: string | undefined;
+    };
+}, {
+    statusBar: {
+        height: string;
+        visible: boolean;
+        style: "light-content" | "dark-content" | "auto";
+        translucent: boolean;
+        backgroundColor?: string | undefined;
+    };
+    navigationBar: {
+        height: string;
+        mode: "overlay" | "inset" | "hidden";
+        buttonStyle: "auto" | "light" | "dark";
+        backgroundColor?: string | undefined;
+    };
+}>;
+/**
+ * Keyboard Animation Config Schema
+ * Validates keyboard animation settings
+ */
+export declare const KeyboardAnimationConfigSchema: z.ZodObject<{
+    duration: z.ZodNumber;
+    easing: z.ZodString;
+    enabled: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    duration: number;
+    easing: string;
+    enabled: boolean;
+}, {
+    duration: number;
+    easing: string;
+    enabled: boolean;
+}>;
+/**
+ * Keyboard Config Schema
+ * Validates keyboard behavior configuration
+ */
+export declare const KeyboardConfigSchema: z.ZodObject<{
+    avoidance: z.ZodEnum<["padding", "resize", "position", "none"]>;
+    behavior: z.ZodEnum<["height", "position", "padding"]>;
+    animation: z.ZodObject<{
+        duration: z.ZodNumber;
+        easing: z.ZodString;
+        enabled: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        duration: number;
+        easing: string;
+        enabled: boolean;
+    }, {
+        duration: number;
+        easing: string;
+        enabled: boolean;
+    }>;
+    dismissMode: z.ZodEnum<["on-drag", "interactive", "none"]>;
+}, "strip", z.ZodTypeAny, {
+    avoidance: "position" | "padding" | "resize" | "none";
+    behavior: "position" | "padding" | "height";
+    animation: {
+        duration: number;
+        easing: string;
+        enabled: boolean;
+    };
+    dismissMode: "none" | "on-drag" | "interactive";
+}, {
+    avoidance: "position" | "padding" | "resize" | "none";
+    behavior: "position" | "padding" | "height";
+    animation: {
+        duration: number;
+        easing: string;
+        enabled: boolean;
+    };
+    dismissMode: "none" | "on-drag" | "interactive";
+}>;
+/**
+ * Bottom Tab Item Config Schema
+ * Validates individual tab bar item configuration
+ */
+export declare const BottomTabItemConfigSchema: z.ZodObject<{
+    minTouchTarget: z.ZodString;
+    iconSize: z.ZodString;
+    labelSize: z.ZodString;
+    spacing: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    minTouchTarget: string;
+    iconSize: string;
+    labelSize: string;
+    spacing: string;
+}, {
+    minTouchTarget: string;
+    iconSize: string;
+    labelSize: string;
+    spacing: string;
+}>;
+/**
+ * Bottom Tab Config Schema
+ * Validates bottom tab bar configuration
+ */
+export declare const BottomTabConfigSchema: z.ZodObject<{
+    height: z.ZodString;
+    safeAreaBottom: z.ZodString;
+    totalHeight: z.ZodString;
+    visibility: z.ZodEnum<["always", "scroll-hide", "route-based"]>;
+    maxItems: z.ZodNumber;
+    item: z.ZodObject<{
+        minTouchTarget: z.ZodString;
+        iconSize: z.ZodString;
+        labelSize: z.ZodString;
+        spacing: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        minTouchTarget: string;
+        iconSize: string;
+        labelSize: string;
+        spacing: string;
+    }, {
+        minTouchTarget: string;
+        iconSize: string;
+        labelSize: string;
+        spacing: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    height: string;
+    safeAreaBottom: string;
+    totalHeight: string;
+    visibility: "always" | "scroll-hide" | "route-based";
+    maxItems: number;
+    item: {
+        minTouchTarget: string;
+        iconSize: string;
+        labelSize: string;
+        spacing: string;
+    };
+}, {
+    height: string;
+    safeAreaBottom: string;
+    totalHeight: string;
+    visibility: "always" | "scroll-hide" | "route-based";
+    maxItems: number;
+    item: {
+        minTouchTarget: string;
+        iconSize: string;
+        labelSize: string;
+        spacing: string;
+    };
+}>;
+/**
+ * Hit Slop Config Schema
+ * Validates expanded touch area configuration
+ */
+export declare const HitSlopConfigSchema: z.ZodObject<{
+    top: z.ZodNumber;
+    bottom: z.ZodNumber;
+    left: z.ZodNumber;
+    right: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+}, {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+}>;
+/**
+ * Touch Target Config Schema
+ * Validates minimum touch target size configuration
+ */
+export declare const TouchTargetConfigSchema: z.ZodObject<{
+    minSize: z.ZodString;
+    hitSlop: z.ZodObject<{
+        top: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+        right: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        top: number;
+        left: number;
+        right: number;
+        bottom: number;
+    }, {
+        top: number;
+        left: number;
+        right: number;
+        bottom: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    minSize: string;
+    hitSlop: {
+        top: number;
+        left: number;
+        right: number;
+        bottom: number;
+    };
+}, {
+    minSize: string;
+    hitSlop: {
+        top: number;
+        left: number;
+        right: number;
+        bottom: number;
+    };
+}>;
+/**
+ * Mobile Shell Token Schema
+ * Validates complete mobile shell structure with platform-specific configurations
+ */
+export declare const MobileShellTokenSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    regions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        position: z.ZodEnum<["top", "left", "right", "bottom", "center"]>;
+        size: z.ZodString;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }, {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }>, "many">;
+    responsive: z.ZodType<ResponsiveConfig<Record<string, unknown>>, z.ZodTypeDef, ResponsiveConfig<Record<string, unknown>>>;
+    tokenBindings: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>;
+} & {
+    platform: z.ZodLiteral<"mobile">;
+    os: z.ZodEnum<["ios", "android", "cross-platform"]>;
+    safeArea: z.ZodObject<{
+        top: z.ZodString;
+        bottom: z.ZodString;
+        left: z.ZodString;
+        right: z.ZodString;
+        defaults: z.ZodObject<{
+            notch: z.ZodNumber;
+            dynamicIsland: z.ZodNumber;
+            homeIndicator: z.ZodNumber;
+            statusBar: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            notch: number;
+            dynamicIsland: number;
+            homeIndicator: number;
+            statusBar: number;
+        }, {
+            notch: number;
+            dynamicIsland: number;
+            homeIndicator: number;
+            statusBar: number;
+        }>;
+        edges: z.ZodObject<{
+            top: z.ZodBoolean;
+            bottom: z.ZodBoolean;
+            horizontal: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            top: boolean;
+            bottom: boolean;
+            horizontal: boolean;
+        }, {
+            top: boolean;
+            bottom: boolean;
+            horizontal: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        top: string;
+        left: string;
+        right: string;
+        bottom: string;
+        defaults: {
+            notch: number;
+            dynamicIsland: number;
+            homeIndicator: number;
+            statusBar: number;
+        };
+        edges: {
+            top: boolean;
+            bottom: boolean;
+            horizontal: boolean;
+        };
+    }, {
+        top: string;
+        left: string;
+        right: string;
+        bottom: string;
+        defaults: {
+            notch: number;
+            dynamicIsland: number;
+            homeIndicator: number;
+            statusBar: number;
+        };
+        edges: {
+            top: boolean;
+            bottom: boolean;
+            horizontal: boolean;
+        };
+    }>;
+    systemUI: z.ZodObject<{
+        statusBar: z.ZodObject<{
+            height: z.ZodString;
+            visible: z.ZodBoolean;
+            style: z.ZodEnum<["light-content", "dark-content", "auto"]>;
+            backgroundColor: z.ZodOptional<z.ZodString>;
+            translucent: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            height: string;
+            visible: boolean;
+            style: "light-content" | "dark-content" | "auto";
+            translucent: boolean;
+            backgroundColor?: string | undefined;
+        }, {
+            height: string;
+            visible: boolean;
+            style: "light-content" | "dark-content" | "auto";
+            translucent: boolean;
+            backgroundColor?: string | undefined;
+        }>;
+        navigationBar: z.ZodObject<{
+            height: z.ZodString;
+            mode: z.ZodEnum<["overlay", "inset", "hidden"]>;
+            backgroundColor: z.ZodOptional<z.ZodString>;
+            buttonStyle: z.ZodEnum<["light", "dark", "auto"]>;
+        }, "strip", z.ZodTypeAny, {
+            height: string;
+            mode: "overlay" | "inset" | "hidden";
+            buttonStyle: "auto" | "light" | "dark";
+            backgroundColor?: string | undefined;
+        }, {
+            height: string;
+            mode: "overlay" | "inset" | "hidden";
+            buttonStyle: "auto" | "light" | "dark";
+            backgroundColor?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        statusBar: {
+            height: string;
+            visible: boolean;
+            style: "light-content" | "dark-content" | "auto";
+            translucent: boolean;
+            backgroundColor?: string | undefined;
+        };
+        navigationBar: {
+            height: string;
+            mode: "overlay" | "inset" | "hidden";
+            buttonStyle: "auto" | "light" | "dark";
+            backgroundColor?: string | undefined;
+        };
+    }, {
+        statusBar: {
+            height: string;
+            visible: boolean;
+            style: "light-content" | "dark-content" | "auto";
+            translucent: boolean;
+            backgroundColor?: string | undefined;
+        };
+        navigationBar: {
+            height: string;
+            mode: "overlay" | "inset" | "hidden";
+            buttonStyle: "auto" | "light" | "dark";
+            backgroundColor?: string | undefined;
+        };
+    }>;
+    keyboard: z.ZodObject<{
+        avoidance: z.ZodEnum<["padding", "resize", "position", "none"]>;
+        behavior: z.ZodEnum<["height", "position", "padding"]>;
+        animation: z.ZodObject<{
+            duration: z.ZodNumber;
+            easing: z.ZodString;
+            enabled: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            duration: number;
+            easing: string;
+            enabled: boolean;
+        }, {
+            duration: number;
+            easing: string;
+            enabled: boolean;
+        }>;
+        dismissMode: z.ZodEnum<["on-drag", "interactive", "none"]>;
+    }, "strip", z.ZodTypeAny, {
+        avoidance: "position" | "padding" | "resize" | "none";
+        behavior: "position" | "padding" | "height";
+        animation: {
+            duration: number;
+            easing: string;
+            enabled: boolean;
+        };
+        dismissMode: "none" | "on-drag" | "interactive";
+    }, {
+        avoidance: "position" | "padding" | "resize" | "none";
+        behavior: "position" | "padding" | "height";
+        animation: {
+            duration: number;
+            easing: string;
+            enabled: boolean;
+        };
+        dismissMode: "none" | "on-drag" | "interactive";
+    }>;
+    bottomTab: z.ZodOptional<z.ZodObject<{
+        height: z.ZodString;
+        safeAreaBottom: z.ZodString;
+        totalHeight: z.ZodString;
+        visibility: z.ZodEnum<["always", "scroll-hide", "route-based"]>;
+        maxItems: z.ZodNumber;
+        item: z.ZodObject<{
+            minTouchTarget: z.ZodString;
+            iconSize: z.ZodString;
+            labelSize: z.ZodString;
+            spacing: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            minTouchTarget: string;
+            iconSize: string;
+            labelSize: string;
+            spacing: string;
+        }, {
+            minTouchTarget: string;
+            iconSize: string;
+            labelSize: string;
+            spacing: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        height: string;
+        safeAreaBottom: string;
+        totalHeight: string;
+        visibility: "always" | "scroll-hide" | "route-based";
+        maxItems: number;
+        item: {
+            minTouchTarget: string;
+            iconSize: string;
+            labelSize: string;
+            spacing: string;
+        };
+    }, {
+        height: string;
+        safeAreaBottom: string;
+        totalHeight: string;
+        visibility: "always" | "scroll-hide" | "route-based";
+        maxItems: number;
+        item: {
+            minTouchTarget: string;
+            iconSize: string;
+            labelSize: string;
+            spacing: string;
+        };
+    }>>;
+    touchTarget: z.ZodObject<{
+        minSize: z.ZodString;
+        hitSlop: z.ZodObject<{
+            top: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            right: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            top: number;
+            left: number;
+            right: number;
+            bottom: number;
+        }, {
+            top: number;
+            left: number;
+            right: number;
+            bottom: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        minSize: string;
+        hitSlop: {
+            top: number;
+            left: number;
+            right: number;
+            bottom: number;
+        };
+    }, {
+        minSize: string;
+        hitSlop: {
+            top: number;
+            left: number;
+            right: number;
+            bottom: number;
+        };
+    }>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    keyboard: {
+        avoidance: "position" | "padding" | "resize" | "none";
+        behavior: "position" | "padding" | "height";
+        animation: {
+            duration: number;
+            easing: string;
+            enabled: boolean;
+        };
+        dismissMode: "none" | "on-drag" | "interactive";
+    };
+    tokenBindings: Record<string, string>;
+    id: string;
+    responsive: ResponsiveConfig<Record<string, unknown>>;
+    platform: "mobile";
+    regions: {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }[];
+    os: "ios" | "android" | "cross-platform";
+    safeArea: {
+        top: string;
+        left: string;
+        right: string;
+        bottom: string;
+        defaults: {
+            notch: number;
+            dynamicIsland: number;
+            homeIndicator: number;
+            statusBar: number;
+        };
+        edges: {
+            top: boolean;
+            bottom: boolean;
+            horizontal: boolean;
+        };
+    };
+    systemUI: {
+        statusBar: {
+            height: string;
+            visible: boolean;
+            style: "light-content" | "dark-content" | "auto";
+            translucent: boolean;
+            backgroundColor?: string | undefined;
+        };
+        navigationBar: {
+            height: string;
+            mode: "overlay" | "inset" | "hidden";
+            buttonStyle: "auto" | "light" | "dark";
+            backgroundColor?: string | undefined;
+        };
+    };
+    touchTarget: {
+        minSize: string;
+        hitSlop: {
+            top: number;
+            left: number;
+            right: number;
+            bottom: number;
+        };
+    };
+    bottomTab?: {
+        height: string;
+        safeAreaBottom: string;
+        totalHeight: string;
+        visibility: "always" | "scroll-hide" | "route-based";
+        maxItems: number;
+        item: {
+            minTouchTarget: string;
+            iconSize: string;
+            labelSize: string;
+            spacing: string;
+        };
+    } | undefined;
+}, {
+    description: string;
+    keyboard: {
+        avoidance: "position" | "padding" | "resize" | "none";
+        behavior: "position" | "padding" | "height";
+        animation: {
+            duration: number;
+            easing: string;
+            enabled: boolean;
+        };
+        dismissMode: "none" | "on-drag" | "interactive";
+    };
+    tokenBindings: Record<string, string>;
+    id: string;
+    responsive: ResponsiveConfig<Record<string, unknown>>;
+    platform: "mobile";
+    regions: {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }[];
+    os: "ios" | "android" | "cross-platform";
+    safeArea: {
+        top: string;
+        left: string;
+        right: string;
+        bottom: string;
+        defaults: {
+            notch: number;
+            dynamicIsland: number;
+            homeIndicator: number;
+            statusBar: number;
+        };
+        edges: {
+            top: boolean;
+            bottom: boolean;
+            horizontal: boolean;
+        };
+    };
+    systemUI: {
+        statusBar: {
+            height: string;
+            visible: boolean;
+            style: "light-content" | "dark-content" | "auto";
+            translucent: boolean;
+            backgroundColor?: string | undefined;
+        };
+        navigationBar: {
+            height: string;
+            mode: "overlay" | "inset" | "hidden";
+            buttonStyle: "auto" | "light" | "dark";
+            backgroundColor?: string | undefined;
+        };
+    };
+    touchTarget: {
+        minSize: string;
+        hitSlop: {
+            top: number;
+            left: number;
+            right: number;
+            bottom: number;
+        };
+    };
+    bottomTab?: {
+        height: string;
+        safeAreaBottom: string;
+        totalHeight: string;
+        visibility: "always" | "scroll-hide" | "route-based";
+        maxItems: number;
+        item: {
+            minTouchTarget: string;
+            iconSize: string;
+            labelSize: string;
+            spacing: string;
+        };
+    } | undefined;
+}>;
+/**
+ * Validation result with detailed error information
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Error messages if validation failed (undefined if valid) */
+    errors?: string[];
+}
+/**
+ * Validate Shell Token (strict validation for application code)
+ *
+ * @param data - Unknown data to validate
+ * @returns Validated ShellToken
+ * @throws Error if validation fails
+ *
+ * @example
+ * ```typescript
+ * const shell = validateShellToken(data);
+ * ```
+ */
+export declare function validateShellToken(data: unknown): ShellToken;
+/**
+ * Validate Page Layout Token (strict validation for application code)
+ *
+ * @param data - Unknown data to validate
+ * @returns Validated PageLayoutToken
+ * @throws Error if validation fails
+ *
+ * @example
+ * ```typescript
+ * const page = validatePageLayoutToken(data);
+ * ```
+ */
+export declare function validatePageLayoutToken(data: unknown): PageLayoutToken;
+/**
+ * Validate Section Pattern Token (strict validation for application code)
+ *
+ * @param data - Unknown data to validate
+ * @returns Validated SectionPatternToken
+ * @throws Error if validation fails
+ *
+ * @example
+ * ```typescript
+ * const section = validateSectionPatternToken(data);
+ * ```
+ */
+export declare function validateSectionPatternToken(data: unknown): SectionPatternToken;
+/**
+ * Validate Token Reference format
+ *
+ * @param data - Unknown data to validate
+ * @returns Validated TokenReference
+ * @throws Error if validation fails
+ *
+ * @example
+ * ```typescript
+ * const ref = validateTokenReference("atomic.spacing.16");
+ * ```
+ */
+export declare function validateTokenReference(data: unknown): TokenReference;
+/**
+ * Validate Mobile Shell Token (strict validation for application code)
+ *
+ * @param token - Mobile shell token to validate
+ * @returns Validated MobileShellToken
+ * @throws Error if validation fails with detailed error messages
+ *
+ * @example
+ * ```typescript
+ * import { SHELL_MOBILE_APP } from './mobile-shells.js';
+ * import { validateMobileShellToken } from './layout-validation.js';
+ *
+ * try {
+ *   const validated = validateMobileShellToken(SHELL_MOBILE_APP);
+ *   console.log('Valid mobile shell token');
+ * } catch (error) {
+ *   console.error('Invalid token:', error.message);
+ * }
+ * ```
+ */
+export declare function validateMobileShellToken(token: unknown): MobileShellToken;
+/**
+ * LLM Shell Input Schema (lenient - only required fields)
+ * Allows LLMs to provide minimal input
+ */
+export declare const LLMShellInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    platform: z.ZodEnum<["web", "mobile", "desktop"]>;
+    regions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        position: z.ZodEnum<["top", "left", "right", "bottom", "center"]>;
+        size: z.ZodString;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }, {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    platform: "web" | "mobile" | "desktop";
+    regions: {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }[];
+}, {
+    id: string;
+    platform: "web" | "mobile" | "desktop";
+    regions: {
+        name: string;
+        position: "top" | "left" | "right" | "bottom" | "center";
+        size: string;
+        collapsible?: boolean | undefined;
+        defaultCollapsed?: boolean | undefined;
+    }[];
+}>;
+/**
+ * LLM Page Input Schema (lenient - only required fields)
+ */
+export declare const LLMPageInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    purpose: z.ZodEnum<["job", "resource", "dashboard", "settings", "detail", "empty", "wizard", "onboarding"]>;
+    sections: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        pattern: z.ZodString;
+        required: z.ZodBoolean;
+        allowedComponents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        required: boolean;
+        pattern: string;
+        allowedComponents?: string[] | undefined;
+    }, {
+        name: string;
+        required: boolean;
+        pattern: string;
+        allowedComponents?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    sections: {
+        name: string;
+        required: boolean;
+        pattern: string;
+        allowedComponents?: string[] | undefined;
+    }[];
+    purpose: "job" | "resource" | "dashboard" | "settings" | "detail" | "empty" | "wizard" | "onboarding";
+}, {
+    id: string;
+    sections: {
+        name: string;
+        required: boolean;
+        pattern: string;
+        allowedComponents?: string[] | undefined;
+    }[];
+    purpose: "job" | "resource" | "dashboard" | "settings" | "detail" | "empty" | "wizard" | "onboarding";
+}>;
+/**
+ * LLM Section Input Schema (lenient - only required fields)
+ */
+export declare const LLMSectionInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<["grid", "flex", "split", "stack", "container"]>;
+    css: z.ZodObject<{
+        display: z.ZodEnum<["grid", "flex"]>;
+        gridTemplateColumns: z.ZodOptional<z.ZodString>;
+        gridTemplateRows: z.ZodOptional<z.ZodString>;
+        gap: z.ZodOptional<z.ZodString>;
+        flexDirection: z.ZodOptional<z.ZodEnum<["row", "column"]>>;
+        alignItems: z.ZodOptional<z.ZodString>;
+        justifyContent: z.ZodOptional<z.ZodString>;
+        maxWidth: z.ZodOptional<z.ZodString>;
+        padding: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    }, {
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "grid" | "flex" | "split" | "stack" | "container";
+    id: string;
+    css: {
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    };
+}, {
+    type: "grid" | "flex" | "split" | "stack" | "container";
+    id: string;
+    css: {
+        display: "grid" | "flex";
+        maxWidth?: string | undefined;
+        gridTemplateColumns?: string | undefined;
+        gridTemplateRows?: string | undefined;
+        gap?: string | undefined;
+        flexDirection?: "row" | "column" | undefined;
+        alignItems?: string | undefined;
+        justifyContent?: string | undefined;
+        padding?: string | undefined;
+    };
+}>;
+/**
+ * Validate LLM Shell Input (lenient validation for LLM-generated data)
+ *
+ * @param data - Unknown data from LLM
+ * @returns Partial ShellToken with only required fields
+ * @throws Error if validation fails with helpful messages
+ *
+ * @example
+ * ```typescript
+ * const partialShell = validateLLMShellInput(llmData);
+ * ```
+ */
+export declare function validateLLMShellInput(data: unknown): Partial<ShellToken>;
+/**
+ * Validate LLM Page Input (lenient validation for LLM-generated data)
+ *
+ * @param data - Unknown data from LLM
+ * @returns Partial PageLayoutToken with only required fields
+ * @throws Error if validation fails with helpful messages
+ *
+ * @example
+ * ```typescript
+ * const partialPage = validateLLMPageInput(llmData);
+ * ```
+ */
+export declare function validateLLMPageInput(data: unknown): Partial<PageLayoutToken>;
+/**
+ * Validate LLM Section Input (lenient validation for LLM-generated data)
+ *
+ * @param data - Unknown data from LLM
+ * @returns Partial SectionPatternToken with only required fields
+ * @throws Error if validation fails with helpful messages
+ *
+ * @example
+ * ```typescript
+ * const partialSection = validateLLMSectionInput(llmData);
+ * ```
+ */
+export declare function validateLLMSectionInput(data: unknown): Partial<SectionPatternToken>;
+/**
+ * Detect circular references in token hierarchy
+ *
+ * Checks if a token references itself directly or indirectly.
+ * A circular reference occurs when token.id appears in any of its own token references
+ * (excluding the id field itself).
+ *
+ * @param token - Shell, Page, or Section token to check
+ * @returns true if no circular references found, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const hasNoCircularRefs = detectCircularRefs(shellToken);
+ * if (!hasNoCircularRefs) {
+ *   console.error('Circular reference detected!');
+ * }
+ * ```
+ */
+export declare function detectCircularRefs(token: ShellToken | PageLayoutToken | SectionPatternToken): boolean;
+/**
+ * Token collection for layout hierarchy validation
+ */
+export interface LayoutTokenCollection {
+    shells: ShellToken[];
+    pages: PageLayoutToken[];
+    sections: SectionPatternToken[];
+}
+/**
+ * Validate complete layout token hierarchy
+ *
+ * Checks:
+ * - All tokens pass schema validation
+ * - No circular references exist
+ * - All token references point to valid tokens
+ *
+ * @param tokens - Collection of all layout tokens
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const result = validateLayoutHierarchy({ shells, pages, sections });
+ * if (!result.valid) {
+ *   console.error('Hierarchy validation failed:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateLayoutHierarchy(tokens: LayoutTokenCollection): ValidationResult;
+/**
+ * Safe validation with result (does not throw)
+ *
+ * @param data - Data to validate
+ * @param schema - Zod schema to use
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const result = safeValidate(data, ShellTokenSchema);
+ * if (!result.valid) {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function safeValidate(data: unknown, schema: z.ZodTypeAny): ValidationResult;
+//# sourceMappingURL=layout-validation.d.ts.map