@tekton-ui/core 0.2.0

package/dist/screen-generation/validators.d.ts

@@ -0,0 +1,286 @@
+/**
+ * @tekton-ui/core - Screen Definition Validation
+ * Zod-based runtime validation for screen definitions
+ * [SPEC-LAYOUT-002] [PHASE-1]
+ */
+import { z } from 'zod';
+import type { ValidationResult } from '../schema-validation.js';
+import type { ScreenDefinition, ComponentDefinition, ComponentType, ValidationContext } from './types.js';
+/**
+ * ResponsiveOverrides Zod Schema
+ */
+export declare const ResponsiveOverridesSchema: z.ZodObject<{
+    sm: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    md: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    lg: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    xl: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    '2xl': z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    sm?: Record<string, unknown> | undefined;
+    md?: Record<string, unknown> | undefined;
+    lg?: Record<string, unknown> | undefined;
+    xl?: Record<string, unknown> | undefined;
+    '2xl'?: Record<string, unknown> | undefined;
+}, {
+    sm?: Record<string, unknown> | undefined;
+    md?: Record<string, unknown> | undefined;
+    lg?: Record<string, unknown> | undefined;
+    xl?: Record<string, unknown> | undefined;
+    '2xl'?: Record<string, unknown> | undefined;
+}>;
+/**
+ * ComponentDefinition Zod Schema
+ * Supports nested children (recursive)
+ */
+export declare const ComponentDefinitionSchema: z.ZodType<ComponentDefinition>;
+/**
+ * SectionDefinition Zod Schema
+ */
+export declare const SectionDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    pattern: z.ZodString;
+    components: z.ZodArray<z.ZodType<ComponentDefinition, z.ZodTypeDef, ComponentDefinition>, "many">;
+    responsive: z.ZodOptional<z.ZodObject<{
+        sm: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        md: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        lg: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        xl: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        '2xl': z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        sm?: Record<string, unknown> | undefined;
+        md?: Record<string, unknown> | undefined;
+        lg?: Record<string, unknown> | undefined;
+        xl?: Record<string, unknown> | undefined;
+        '2xl'?: Record<string, unknown> | undefined;
+    }, {
+        sm?: Record<string, unknown> | undefined;
+        md?: Record<string, unknown> | undefined;
+        lg?: Record<string, unknown> | undefined;
+        xl?: Record<string, unknown> | undefined;
+        '2xl'?: Record<string, unknown> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    pattern: string;
+    components: ComponentDefinition[];
+    responsive?: {
+        sm?: Record<string, unknown> | undefined;
+        md?: Record<string, unknown> | undefined;
+        lg?: Record<string, unknown> | undefined;
+        xl?: Record<string, unknown> | undefined;
+        '2xl'?: Record<string, unknown> | undefined;
+    } | undefined;
+}, {
+    id: string;
+    pattern: string;
+    components: ComponentDefinition[];
+    responsive?: {
+        sm?: Record<string, unknown> | undefined;
+        md?: Record<string, unknown> | undefined;
+        lg?: Record<string, unknown> | undefined;
+        xl?: Record<string, unknown> | undefined;
+        '2xl'?: Record<string, unknown> | undefined;
+    } | undefined;
+}>;
+/**
+ * ScreenMeta Zod Schema
+ */
+export declare const ScreenMetaSchema: z.ZodObject<{
+    author: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    author?: string | undefined;
+    createdAt?: string | undefined;
+    version?: string | undefined;
+    tags?: string[] | undefined;
+}, {
+    author?: string | undefined;
+    createdAt?: string | undefined;
+    version?: string | undefined;
+    tags?: string[] | undefined;
+}>;
+/**
+ * ScreenDefinition Zod Schema
+ */
+export declare const ScreenDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    shell: z.ZodString;
+    page: z.ZodString;
+    themeId: z.ZodDefault<z.ZodString>;
+    sections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        pattern: z.ZodString;
+        components: z.ZodArray<z.ZodType<ComponentDefinition, z.ZodTypeDef, ComponentDefinition>, "many">;
+        responsive: z.ZodOptional<z.ZodObject<{
+            sm: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            md: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            lg: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            xl: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            '2xl': z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strict", z.ZodTypeAny, {
+            sm?: Record<string, unknown> | undefined;
+            md?: Record<string, unknown> | undefined;
+            lg?: Record<string, unknown> | undefined;
+            xl?: Record<string, unknown> | undefined;
+            '2xl'?: Record<string, unknown> | undefined;
+        }, {
+            sm?: Record<string, unknown> | undefined;
+            md?: Record<string, unknown> | undefined;
+            lg?: Record<string, unknown> | undefined;
+            xl?: Record<string, unknown> | undefined;
+            '2xl'?: Record<string, unknown> | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        pattern: string;
+        components: ComponentDefinition[];
+        responsive?: {
+            sm?: Record<string, unknown> | undefined;
+            md?: Record<string, unknown> | undefined;
+            lg?: Record<string, unknown> | undefined;
+            xl?: Record<string, unknown> | undefined;
+            '2xl'?: Record<string, unknown> | undefined;
+        } | undefined;
+    }, {
+        id: string;
+        pattern: string;
+        components: ComponentDefinition[];
+        responsive?: {
+            sm?: Record<string, unknown> | undefined;
+            md?: Record<string, unknown> | undefined;
+            lg?: Record<string, unknown> | undefined;
+            xl?: Record<string, unknown> | undefined;
+            '2xl'?: Record<string, unknown> | undefined;
+        } | undefined;
+    }>, "many">;
+    meta: z.ZodOptional<z.ZodObject<{
+        author: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        author?: string | undefined;
+        createdAt?: string | undefined;
+        version?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        author?: string | undefined;
+        createdAt?: string | undefined;
+        version?: string | undefined;
+        tags?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    shell: string;
+    page: string;
+    themeId: string;
+    sections: {
+        id: string;
+        pattern: string;
+        components: ComponentDefinition[];
+        responsive?: {
+            sm?: Record<string, unknown> | undefined;
+            md?: Record<string, unknown> | undefined;
+            lg?: Record<string, unknown> | undefined;
+            xl?: Record<string, unknown> | undefined;
+            '2xl'?: Record<string, unknown> | undefined;
+        } | undefined;
+    }[];
+    description?: string | undefined;
+    meta?: {
+        author?: string | undefined;
+        createdAt?: string | undefined;
+        version?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+}, {
+    name: string;
+    id: string;
+    shell: string;
+    page: string;
+    sections: {
+        id: string;
+        pattern: string;
+        components: ComponentDefinition[];
+        responsive?: {
+            sm?: Record<string, unknown> | undefined;
+            md?: Record<string, unknown> | undefined;
+            lg?: Record<string, unknown> | undefined;
+            xl?: Record<string, unknown> | undefined;
+            '2xl'?: Record<string, unknown> | undefined;
+        } | undefined;
+    }[];
+    description?: string | undefined;
+    themeId?: string | undefined;
+    meta?: {
+        author?: string | undefined;
+        createdAt?: string | undefined;
+        version?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+}>;
+/**
+ * Validate a ComponentDefinition
+ * @param component - Component definition to validate
+ * @returns Validation result with helpful error messages
+ */
+export declare function validateComponent(component: unknown): ValidationResult;
+/**
+ * Validate a SectionDefinition
+ * @param section - Section definition to validate
+ * @returns Validation result with helpful error messages
+ */
+export declare function validateSection(section: unknown): ValidationResult;
+/**
+ * Validate a ScreenDefinition
+ * @param screen - Screen definition to validate
+ * @param context - Optional validation context for additional checks
+ * @returns Validation result with helpful error messages
+ */
+export declare function validateScreenDefinition(screen: unknown, context?: ValidationContext): ValidationResult;
+/**
+ * Assert that a screen definition is valid (throws on invalid)
+ * @param screen - Screen definition to validate
+ * @param context - Optional validation context
+ * @throws Error if validation fails
+ */
+export declare function assertValidScreenDefinition(screen: unknown, context?: ValidationContext): asserts screen is ScreenDefinition;
+/**
+ * Validate multiple screen definitions
+ * @param screens - Array of screen definitions to validate
+ * @param context - Optional validation context
+ * @returns Validation summary
+ */
+export declare function validateScreenDefinitions(screens: unknown[], context?: ValidationContext): {
+    totalScreens: number;
+    validScreens: number;
+    invalidScreens: number;
+    validationResults: Array<{
+        id: string;
+        valid: boolean;
+        errors?: string[];
+        warnings?: string[];
+    }>;
+};
+/**
+ * Check if a token ID matches the shell pattern
+ */
+export declare function isValidShellToken(tokenId: string): boolean;
+/**
+ * Check if a token ID matches the page pattern
+ */
+export declare function isValidPageToken(tokenId: string): boolean;
+/**
+ * Check if a token ID matches the section pattern
+ */
+export declare function isValidSectionToken(tokenId: string): boolean;
+/**
+ * Get all component types used in a screen definition
+ */
+export declare function getUsedComponentTypes(screen: ScreenDefinition): Set<ComponentType>;
+//# sourceMappingURL=validators.d.ts.map

package/dist/screen-generation/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/screen-generation/validators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAkEpB;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EAQ3B,CAAC;AAEZ;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAapE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAW3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBjC,CAAC;AAMH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB,CActE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAclE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,gBAAgB,CAqElB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAKpC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,KAAK,CAAC;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,CAAC;CACJ,CAmBA;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,GAAG,CAAC,aAAa,CAAC,CAmBlF"}

package/dist/screen-generation/validators.js

@@ -0,0 +1,323 @@
+/**
+ * @tekton-ui/core - Screen Definition Validation
+ * Zod-based runtime validation for screen definitions
+ * [SPEC-LAYOUT-002] [PHASE-1]
+ */
+import { z } from 'zod';
+// ============================================================================
+// Component Type Validation
+// ============================================================================
+/**
+ * Component type enum - 20 component types
+ */
+const COMPONENT_TYPES = [
+    // Primitive (10)
+    'Button',
+    'Input',
+    'Text',
+    'Heading',
+    'Checkbox',
+    'Radio',
+    'Switch',
+    'Slider',
+    'Badge',
+    'Avatar',
+    // Composed (10)
+    'Card',
+    'Modal',
+    'Tabs',
+    'Table',
+    'Link',
+    'List',
+    'Image',
+    'Form',
+    'Dropdown',
+    'Progress',
+];
+// ============================================================================
+// Token ID Pattern Validation
+// ============================================================================
+/**
+ * Shell token ID pattern: shell.{platform}.{name}
+ * Examples: shell.web.dashboard, shell.mobile.app
+ */
+const SHELL_TOKEN_PATTERN = /^shell\.[a-z]+\.[a-z-]+$/;
+/**
+ * Page token ID pattern: page.{name}
+ * Examples: page.dashboard, page.settings
+ */
+const PAGE_TOKEN_PATTERN = /^page\.[a-z-]+$/;
+/**
+ * Section token ID pattern: section.{name} or section.{name}-{number}
+ * Examples: section.grid-4, section.hero, section.split
+ */
+const SECTION_TOKEN_PATTERN = /^section\.[a-z]+([-][a-z0-9]+)*$/;
+/**
+ * Screen ID pattern: kebab-case
+ * Examples: user-dashboard, settings-page
+ */
+const SCREEN_ID_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+// ============================================================================
+// Zod Schemas
+// ============================================================================
+/**
+ * ResponsiveOverrides Zod Schema
+ */
+export const ResponsiveOverridesSchema = z
+    .object({
+    sm: z.record(z.unknown()).optional(),
+    md: z.record(z.unknown()).optional(),
+    lg: z.record(z.unknown()).optional(),
+    xl: z.record(z.unknown()).optional(),
+    '2xl': z.record(z.unknown()).optional(),
+})
+    .strict();
+/**
+ * ComponentDefinition Zod Schema
+ * Supports nested children (recursive)
+ */
+export const ComponentDefinitionSchema = z.lazy(() => z.object({
+    type: z.enum(COMPONENT_TYPES, {
+        errorMap: () => ({
+            message: `Component type must be one of: ${COMPONENT_TYPES.join(', ')}`,
+        }),
+    }),
+    props: z.record(z.unknown(), {
+        errorMap: () => ({ message: 'Component props must be a valid object' }),
+    }),
+    children: z.array(z.union([ComponentDefinitionSchema, z.string()])).optional(),
+    slot: z.string().optional(),
+}));
+/**
+ * SectionDefinition Zod Schema
+ */
+export const SectionDefinitionSchema = z.object({
+    id: z.string().min(1, 'Section ID is required and cannot be empty'),
+    pattern: z
+        .string()
+        .regex(SECTION_TOKEN_PATTERN, 'Section pattern must match: section.{name} or section.{name}-{number} (e.g., "section.grid-4")'),
+    components: z.array(ComponentDefinitionSchema).min(1, 'Section must have at least one component'),
+    responsive: ResponsiveOverridesSchema.optional(),
+});
+/**
+ * ScreenMeta Zod Schema
+ */
+export const ScreenMetaSchema = z.object({
+    author: z.string().optional(),
+    createdAt: z
+        .string()
+        .datetime({ message: 'createdAt must be a valid ISO 8601 date-time string' })
+        .optional(),
+    version: z
+        .string()
+        .regex(/^\d+\.\d+\.\d+$/, 'version must follow semantic versioning (e.g., "1.0.0")')
+        .optional(),
+    tags: z.array(z.string()).optional(),
+});
+/**
+ * ScreenDefinition Zod Schema
+ */
+export const ScreenDefinitionSchema = z.object({
+    id: z
+        .string()
+        .regex(SCREEN_ID_PATTERN, 'Screen ID must be kebab-case (lowercase letters, numbers, hyphens)'),
+    name: z.string().min(1, 'Screen name is required and cannot be empty'),
+    description: z.string().optional(),
+    shell: z
+        .string()
+        .regex(SHELL_TOKEN_PATTERN, 'Shell token must match pattern: shell.{platform}.{name} (e.g., "shell.web.dashboard")'),
+    page: z
+        .string()
+        .regex(PAGE_TOKEN_PATTERN, 'Page token must match pattern: page.{name} (e.g., "page.dashboard")'),
+    themeId: z.string().default('default'),
+    sections: z
+        .array(SectionDefinitionSchema)
+        .min(1, 'Screen must have at least one section definition'),
+    meta: ScreenMetaSchema.optional(),
+});
+// ============================================================================
+// Validation Functions
+// ============================================================================
+/**
+ * Validate a ComponentDefinition
+ * @param component - Component definition to validate
+ * @returns Validation result with helpful error messages
+ */
+export function validateComponent(component) {
+    try {
+        ComponentDefinitionSchema.parse(component);
+        return { valid: true };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const errors = error.errors.map(err => {
+                const path = err.path.length > 0 ? `${err.path.join('.')}: ` : '';
+                return `${path}${err.message}`;
+            });
+            return { valid: false, errors };
+        }
+        return { valid: false, errors: ['Unknown validation error'] };
+    }
+}
+/**
+ * Validate a SectionDefinition
+ * @param section - Section definition to validate
+ * @returns Validation result with helpful error messages
+ */
+export function validateSection(section) {
+    try {
+        SectionDefinitionSchema.parse(section);
+        return { valid: true };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const errors = error.errors.map(err => {
+                const path = err.path.length > 0 ? `${err.path.join('.')}: ` : '';
+                return `${path}${err.message}`;
+            });
+            return { valid: false, errors };
+        }
+        return { valid: false, errors: ['Unknown validation error'] };
+    }
+}
+/**
+ * Validate a ScreenDefinition
+ * @param screen - Screen definition to validate
+ * @param context - Optional validation context for additional checks
+ * @returns Validation result with helpful error messages
+ */
+export function validateScreenDefinition(screen, context) {
+    const warnings = [];
+    // Basic schema validation
+    try {
+        ScreenDefinitionSchema.parse(screen);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const errors = error.errors.map(err => {
+                const path = err.path.length > 0 ? `${err.path.join('.')}: ` : '';
+                return `${path}${err.message}`;
+            });
+            return { valid: false, errors };
+        }
+        return { valid: false, errors: ['Unknown validation error'] };
+    }
+    // Type assertion after validation
+    const validScreen = screen;
+    // Context-based validation (if context provided)
+    if (context) {
+        // Check shell token availability
+        if (context.availableShells && !context.availableShells.includes(validScreen.shell)) {
+            warnings.push(`Shell token "${validScreen.shell}" not found in available shells`);
+        }
+        // Check page token availability
+        if (context.availablePages && !context.availablePages.includes(validScreen.page)) {
+            warnings.push(`Page token "${validScreen.page}" not found in available pages`);
+        }
+        // Check section pattern availability
+        if (context.availableSections) {
+            validScreen.sections.forEach(section => {
+                if (!context.availableSections.includes(section.pattern)) {
+                    warnings.push(`Section pattern "${section.pattern}" in section "${section.id}" not found in available sections`);
+                }
+            });
+        }
+        // Check theme ID availability
+        if (context.availableThemes &&
+            validScreen.themeId &&
+            !context.availableThemes.includes(validScreen.themeId)) {
+            warnings.push(`Theme ID "${validScreen.themeId}" not found in available themes`);
+        }
+        // Strict mode: treat warnings as errors
+        if (context.strict && warnings.length > 0) {
+            return { valid: false, errors: warnings };
+        }
+    }
+    // Check for duplicate section IDs
+    const sectionIds = validScreen.sections.map(s => s.id);
+    const duplicateSectionIds = sectionIds.filter((id, index) => sectionIds.indexOf(id) !== index);
+    if (duplicateSectionIds.length > 0) {
+        warnings.push(`Duplicate section IDs found: ${[...new Set(duplicateSectionIds)].join(', ')}`);
+    }
+    return {
+        valid: true,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+/**
+ * Assert that a screen definition is valid (throws on invalid)
+ * @param screen - Screen definition to validate
+ * @param context - Optional validation context
+ * @throws Error if validation fails
+ */
+export function assertValidScreenDefinition(screen, context) {
+    const result = validateScreenDefinition(screen, context);
+    if (!result.valid) {
+        throw new Error(`Invalid screen definition: ${result.errors?.join(', ')}`);
+    }
+}
+/**
+ * Validate multiple screen definitions
+ * @param screens - Array of screen definitions to validate
+ * @param context - Optional validation context
+ * @returns Validation summary
+ */
+export function validateScreenDefinitions(screens, context) {
+    const results = screens.map((screen, index) => {
+        const result = validateScreenDefinition(screen, context);
+        const id = typeof screen === 'object' && screen !== null && 'id' in screen
+            ? String(screen.id)
+            : `screen-${index}`;
+        return { id, ...result };
+    });
+    const validScreens = results.filter(r => r.valid).length;
+    const invalidScreens = results.filter(r => !r.valid).length;
+    return {
+        totalScreens: screens.length,
+        validScreens,
+        invalidScreens,
+        validationResults: results,
+    };
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Check if a token ID matches the shell pattern
+ */
+export function isValidShellToken(tokenId) {
+    return SHELL_TOKEN_PATTERN.test(tokenId);
+}
+/**
+ * Check if a token ID matches the page pattern
+ */
+export function isValidPageToken(tokenId) {
+    return PAGE_TOKEN_PATTERN.test(tokenId);
+}
+/**
+ * Check if a token ID matches the section pattern
+ */
+export function isValidSectionToken(tokenId) {
+    return SECTION_TOKEN_PATTERN.test(tokenId);
+}
+/**
+ * Get all component types used in a screen definition
+ */
+export function getUsedComponentTypes(screen) {
+    const types = new Set();
+    function collectTypes(component) {
+        types.add(component.type);
+        if (component.children) {
+            component.children.forEach(child => {
+                if (typeof child !== 'string') {
+                    collectTypes(child);
+                }
+            });
+        }
+    }
+    screen.sections.forEach(section => {
+        section.components.forEach(collectTypes);
+    });
+    return types;
+}
+//# sourceMappingURL=validators.js.map

package/dist/screen-generation/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/screen-generation/validators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,eAAe,GAAoB;IACvC,iBAAiB;IACjB,QAAQ;IACR,OAAO;IACP,MAAM;IACN,SAAS;IACT,UAAU;IACV,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,gBAAgB;IAChB,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,UAAU;CACX,CAAC;AAEF,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAEvD;;;GAGG;AACH,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,MAAM,qBAAqB,GAAG,kCAAkC,CAAC;AAEjE;;;GAGG;AACH,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAErD,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAmC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CACnF,CAAC,CAAC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,eAAsD,EAAE;QACnE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;YACf,OAAO,EAAE,kCAAkC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACxE,CAAC;KACH,CAAC;IACF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;KACxE,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,4CAA4C,CAAC;IACnE,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,KAAK,CACJ,qBAAqB,EACrB,gGAAgG,CACjG;IACH,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,0CAA0C,CAAC;IACjG,UAAU,EAAE,yBAAyB,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC;SAC5E,QAAQ,EAAE;IACb,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,KAAK,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;SACnF,QAAQ,EAAE;IACb,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,KAAK,CAAC,iBAAiB,EAAE,oEAAoE,CAAC;IACjG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;IACtE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,KAAK,CACJ,mBAAmB,EACnB,uFAAuF,CACxF;IACH,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CACJ,kBAAkB,EAClB,qEAAqE,CACtE;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACtC,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,uBAAuB,CAAC;SAC9B,GAAG,CAAC,CAAC,EAAE,kDAAkD,CAAC;IAC7D,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAkB;IAClD,IAAI,CAAC;QACH,yBAAyB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;gBACpC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,OAAO,GAAG,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YACjC,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAClC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC;IAChE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,IAAI,CAAC;QACH,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;gBACpC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,OAAO,GAAG,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YACjC,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAClC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC;IAChE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAe,EACf,OAA2B;IAE3B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,0BAA0B;IAC1B,IAAI,CAAC;QACH,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;gBACpC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,OAAO,GAAG,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YACjC,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAClC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC;IAChE,CAAC;IAED,kCAAkC;IAClC,MAAM,WAAW,GAAG,MAA0B,CAAC;IAE/C,iDAAiD;IACjD,IAAI,OAAO,EAAE,CAAC;QACZ,iCAAiC;QACjC,IAAI,OAAO,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACpF,QAAQ,CAAC,IAAI,CAAC,gBAAgB,WAAW,CAAC,KAAK,iCAAiC,CAAC,CAAC;QACpF,CAAC;QAED,gCAAgC;QAChC,IAAI,OAAO,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACjF,QAAQ,CAAC,IAAI,CAAC,eAAe,WAAW,CAAC,IAAI,gCAAgC,CAAC,CAAC;QACjF,CAAC;QAED,qCAAqC;QACrC,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;gBACrC,IAAI,CAAC,OAAO,CAAC,iBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1D,QAAQ,CAAC,IAAI,CACX,oBAAoB,OAAO,CAAC,OAAO,iBAAiB,OAAO,CAAC,EAAE,mCAAmC,CAClG,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,8BAA8B;QAC9B,IACE,OAAO,CAAC,eAAe;YACvB,WAAW,CAAC,OAAO;YACnB,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,EACtD,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,aAAa,WAAW,CAAC,OAAO,iCAAiC,CAAC,CAAC;QACnF,CAAC;QAED,wCAAwC;QACxC,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,mBAAmB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC;IAC/F,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC,gCAAgC,CAAC,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,OAAO;QACL,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KACrD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAe,EACf,OAA2B;IAE3B,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAkB,EAClB,OAA2B;IAY3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,EAAE,GACN,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,IAAI,IAAI,MAAM;YAC7D,CAAC,CAAC,MAAM,CAAE,MAAyB,CAAC,EAAE,CAAC;YACvC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACzD,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAE5D,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,YAAY;QACZ,cAAc;QACd,iBAAiB,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAwB;IAC5D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEvC,SAAS,YAAY,CAAC,SAA8B;QAClD,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACvB,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,YAAY,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QAChC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/screen-templates/__tests__/registry.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @tekton-ui/core - TemplateRegistry Tests
+ * [SPEC-UI-002] [TAG-UI002-004] Template Registry Testing
+ */
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/screen-templates/__tests__/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../../src/screen-templates/__tests__/registry.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}