@tekton-ui/core 0.2.0

package/dist/screen-generation/resolver/screen-resolver.js

@@ -0,0 +1,373 @@
+/**
+ * @tekton-ui/core - Screen Resolver
+ * Main entry point for resolving screen definitions to complete screen structures
+ * [SPEC-LAYOUT-002] [PHASE-2]
+ */
+import { resolveShell, resolvePage, resolveSection, } from './layout-resolver.js';
+import { resolveComponent, } from './component-resolver.js';
+import { tokenRefToCSSVar } from './token-resolver.js';
+// ============================================================================
+// Cache
+// ============================================================================
+/**
+ * Screen resolution cache
+ * Key: `${screenId}:${themeId}`
+ */
+const screenCache = new Map();
+/**
+ * Clear screen resolution cache
+ * Useful for testing or when screen definitions change
+ *
+ * @example
+ * ```typescript
+ * clearScreenCache();
+ * ```
+ */
+export function clearScreenCache() {
+    screenCache.clear();
+}
+// ============================================================================
+// Component Tree Building
+// ============================================================================
+/**
+ * Build component tree node from resolved component
+ *
+ * @param component - Resolved component
+ * @returns Component tree node
+ */
+function buildComponentTreeNode(component) {
+    const node = {
+        type: component.type,
+        slot: component.slot,
+    };
+    if (component.children && component.children.length > 0) {
+        node.children = component.children
+            .filter((child) => typeof child !== 'string')
+            .map(child => buildComponentTreeNode(child));
+    }
+    return node;
+}
+/**
+ * Build complete component tree from resolved sections
+ *
+ * @param sections - Resolved sections with components
+ * @returns Component tree structure
+ */
+function buildComponentTree(sections) {
+    return {
+        sections: sections.map(section => ({
+            sectionId: section.id,
+            components: section.components.map(component => buildComponentTreeNode(component)),
+        })),
+    };
+}
+// ============================================================================
+// CSS Variables Generation
+// ============================================================================
+/**
+ * Merge CSS variables from multiple layouts
+ *
+ * Combines CSS variables from shell, page, and section layouts
+ * into a single global CSS variable map.
+ *
+ * @param shell - Resolved shell layout
+ * @param page - Resolved page layout
+ * @param sections - Resolved sections
+ * @returns Merged CSS variables
+ */
+function mergeCSSVariables(shell, page, sections) {
+    const merged = {};
+    // Add shell CSS variables
+    Object.assign(merged, shell.cssVariables);
+    // Add page CSS variables
+    Object.assign(merged, page.cssVariables);
+    // Add section CSS variables
+    for (const section of sections) {
+        Object.assign(merged, section.cssVariables);
+    }
+    return merged;
+}
+/**
+ * Generate CSS variables from token references in layout
+ *
+ * Extracts all token references from layout structure and
+ * generates CSS variable declarations.
+ *
+ * @param layout - Resolved layout
+ * @returns CSS variables map
+ */
+function generateLayoutCSSVariables(layout) {
+    const cssVars = {};
+    // Extract token references from layout
+    const extractTokens = (obj) => {
+        if (typeof obj === 'string' && /^[a-z]+\.[a-z-]+(\.[a-z0-9-]+)*$/.test(obj)) {
+            // This is a token reference
+            const cssVarName = tokenRefToCSSVar(obj);
+            cssVars[cssVarName] = obj;
+        }
+        else if (typeof obj === 'object' && obj !== null) {
+            for (const value of Object.values(obj)) {
+                extractTokens(value);
+            }
+        }
+    };
+    extractTokens(layout);
+    return cssVars;
+}
+// ============================================================================
+// Core Resolution Functions
+// ============================================================================
+/**
+ * Resolve section definition to complete resolved section
+ *
+ * Process:
+ * 1. Resolve section pattern layout
+ * 2. Resolve all components in section
+ * 3. Generate CSS variables
+ *
+ * @param section - Section definition to resolve
+ * @param screenId - Screen ID for error messages
+ * @param theme - Theme ID for token resolution
+ * @returns Resolved section with layout and components
+ */
+function resolveScreenSection(section, screenId, theme) {
+    // Create layout context
+    const layoutContext = {
+        screenId,
+        layoutType: 'section',
+        meta: {
+            sectionId: section.id,
+        },
+    };
+    // Resolve section pattern layout
+    let layout;
+    try {
+        layout = resolveSection(section.pattern, layoutContext);
+    }
+    catch (error) {
+        throw new Error(`Failed to resolve section '${section.id}' (pattern: ${section.pattern}): ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Create component context
+    const componentContext = {
+        theme,
+        screenId,
+        sectionId: section.id,
+    };
+    // Resolve all components in section
+    const components = [];
+    for (let i = 0; i < section.components.length; i++) {
+        try {
+            const resolved = resolveComponent(section.components[i], componentContext);
+            components.push(resolved);
+        }
+        catch (error) {
+            throw new Error(`Failed to resolve component at index ${i} in section '${section.id}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Generate CSS variables from layout
+    const cssVariables = generateLayoutCSSVariables(layout);
+    return {
+        id: section.id,
+        layout,
+        components,
+        cssVariables,
+    };
+}
+/**
+ * Resolve screen definition to complete resolved screen structure
+ *
+ * Main entry point for screen resolution. Performs complete resolution:
+ * 1. Validate screen definition
+ * 2. Resolve shell layout
+ * 3. Resolve page layout
+ * 4. Resolve all sections with layouts and components
+ * 5. Generate global CSS variables
+ * 6. Build component tree
+ *
+ * Performance: <5ms for typical screen resolution (cached after first call)
+ *
+ * @param screen - Screen definition to resolve
+ * @returns Complete resolved screen structure
+ * @throws Error if resolution fails at any stage
+ *
+ * @example
+ * ```typescript
+ * const screen = {
+ *   id: 'dashboard-screen',
+ *   name: 'Dashboard',
+ *   shell: 'shell.web.dashboard',
+ *   page: 'page.dashboard',
+ *   themeId: 'default',
+ *   sections: [
+ *     {
+ *       id: 'stats',
+ *       pattern: 'section.grid-4',
+ *       components: [
+ *         { type: 'Card', props: { children: 'Stats' } }
+ *       ]
+ *     }
+ *   ]
+ * };
+ *
+ * const resolved = resolveScreen(screen);
+ * console.log(resolved.shell.shell?.description);
+ * console.log(resolved.sections[0].components[0].tokenBindings);
+ * ```
+ */
+export function resolveScreen(screen) {
+    const startTime = performance.now();
+    // Use default theme if not specified
+    const themeId = screen.themeId || 'default';
+    // Check cache
+    const cacheKey = `${screen.id}:${themeId}`;
+    const cached = screenCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    // Create layout context for shell
+    const shellContext = {
+        screenId: screen.id,
+        layoutType: 'shell',
+    };
+    // Resolve shell layout
+    let shell;
+    try {
+        shell = resolveShell(screen.shell, shellContext);
+    }
+    catch (error) {
+        throw new Error(`Failed to resolve shell for screen '${screen.id}': ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Create layout context for page
+    const pageContext = {
+        screenId: screen.id,
+        layoutType: 'page',
+    };
+    // Resolve page layout
+    let page;
+    try {
+        page = resolvePage(screen.page, pageContext);
+    }
+    catch (error) {
+        throw new Error(`Failed to resolve page for screen '${screen.id}': ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Resolve all sections
+    const sections = [];
+    for (let i = 0; i < screen.sections.length; i++) {
+        try {
+            const resolved = resolveScreenSection(screen.sections[i], screen.id, themeId);
+            sections.push(resolved);
+        }
+        catch (error) {
+            throw new Error(`Failed to resolve section at index ${i}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Merge CSS variables from all layouts
+    const cssVariables = mergeCSSVariables(shell, page, sections);
+    // Build component tree
+    const componentTree = buildComponentTree(sections);
+    // Create resolved screen
+    const resolved = {
+        id: screen.id,
+        name: screen.name,
+        description: screen.description,
+        shell,
+        page,
+        sections,
+        cssVariables,
+        componentTree,
+        meta: screen.meta,
+        themeId,
+    };
+    // Cache result
+    screenCache.set(cacheKey, resolved);
+    // Performance logging
+    const endTime = performance.now();
+    const duration = endTime - startTime;
+    if (duration > 5) {
+        console.warn(`Screen resolution for '${screen.id}' took ${duration.toFixed(2)}ms (target: <5ms). ` +
+            `Consider optimizing layout or component complexity.`);
+    }
+    return resolved;
+}
+// ============================================================================
+// Validation Utilities
+// ============================================================================
+/**
+ * Validate resolved screen structure
+ *
+ * Checks:
+ * - Shell layout is present
+ * - Page layout is present
+ * - All sections have layouts and components
+ * - CSS variables are generated
+ * - Component tree is built
+ *
+ * @param resolved - Resolved screen to validate
+ * @returns True if valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const resolved = resolveScreen(screenDefinition);
+ * if (isValidResolvedScreen(resolved)) {
+ *   // Ready to render
+ * }
+ * ```
+ */
+export function isValidResolvedScreen(resolved) {
+    if (typeof resolved !== 'object' || resolved === null) {
+        return false;
+    }
+    const obj = resolved;
+    // Check required fields
+    if (typeof obj.id !== 'string' ||
+        typeof obj.name !== 'string' ||
+        typeof obj.shell !== 'object' ||
+        typeof obj.page !== 'object' ||
+        !Array.isArray(obj.sections) ||
+        typeof obj.cssVariables !== 'object' ||
+        typeof obj.componentTree !== 'object') {
+        return false;
+    }
+    return true;
+}
+/**
+ * Get screen resolution statistics
+ *
+ * Provides insights into resolved screen structure:
+ * - Total component count
+ * - Component types used
+ * - Section count
+ * - CSS variable count
+ *
+ * @param resolved - Resolved screen
+ * @returns Statistics object
+ *
+ * @example
+ * ```typescript
+ * const resolved = resolveScreen(screenDefinition);
+ * const stats = getScreenStats(resolved);
+ * console.log(`Components: ${stats.componentCount}`);
+ * console.log(`CSS Variables: ${stats.cssVariableCount}`);
+ * ```
+ */
+export function getScreenStats(resolved) {
+    let componentCount = 0;
+    const componentTypes = new Set();
+    const countComponents = (node) => {
+        componentCount++;
+        componentTypes.add(node.type);
+        if (node.children) {
+            node.children.forEach(countComponents);
+        }
+    };
+    resolved.componentTree.sections.forEach(section => {
+        section.components.forEach(countComponents);
+    });
+    return {
+        componentCount,
+        componentTypes,
+        sectionCount: resolved.sections.length,
+        cssVariableCount: Object.keys(resolved.cssVariables).length,
+    };
+}
+//# sourceMappingURL=screen-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screen-resolver.js","sourceRoot":"","sources":["../../../src/screen-generation/resolver/screen-resolver.ts"],"names":[],"mappings":"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"}

package/dist/screen-generation/resolver/token-resolver.d.ts

@@ -0,0 +1,170 @@
+/**
+ * @tekton-ui/core - Token Binding Resolver
+ * Resolves token bindings with template variable substitution
+ * [SPEC-LAYOUT-002] [PHASE-2]
+ */
+import type { TokenBindings } from '../../component-schemas.js';
+/**
+ * Token binding resolution context
+ * Contains component props and theme for template variable substitution
+ */
+export interface TokenBindingContext {
+    /** Component props for template variable substitution */
+    props: Record<string, unknown>;
+    /** Theme ID for token resolution */
+    theme: string;
+}
+/**
+ * Resolved token bindings map
+ * Maps property names to CSS variable references
+ */
+export type ResolvedTokenBindings = Record<string, string>;
+/**
+ * Clear token binding cache
+ * Useful for testing or when token definitions change
+ *
+ * @example
+ * ```typescript
+ * clearBindingCache();
+ * ```
+ */
+export declare function clearBindingCache(): void;
+/**
+ * Substitute template variables in token binding
+ *
+ * Template syntax: `{variableName}`
+ * Variables are resolved from component props
+ *
+ * @param binding - Token binding with template variables (e.g., "component.button.{variant}.background")
+ * @param props - Component props (e.g., { variant: "primary" })
+ * @returns Token reference with substituted variables (e.g., "component.button.primary.background")
+ * @throws Error if required template variable is missing from props
+ *
+ * @example
+ * ```typescript
+ * substituteTemplateVariables(
+ *   'component.button.{variant}.background',
+ *   { variant: 'primary' }
+ * ); // → 'component.button.primary.background'
+ *
+ * substituteTemplateVariables(
+ *   'atomic.spacing.{size}',
+ *   { size: 'large' }
+ * ); // → 'atomic.spacing.large'
+ * ```
+ */
+export declare function substituteTemplateVariables(binding: string, props: Record<string, unknown>): string;
+/**
+ * Convert token reference to CSS variable reference
+ *
+ * Converts dot notation to CSS custom property format:
+ * - "atomic.spacing.16" → "var(--atomic-spacing-16)"
+ * - "semantic.color.primary" → "var(--semantic-color-primary)"
+ *
+ * @param tokenRef - Token reference in dot notation
+ * @returns CSS variable reference in var() format
+ *
+ * @example
+ * ```typescript
+ * tokenRefToCSSVar('atomic.spacing.16'); // → 'var(--atomic-spacing-16)'
+ * tokenRefToCSSVar('semantic.color.primary'); // → 'var(--semantic-color-primary)'
+ * ```
+ */
+export declare function tokenRefToCSSVar(tokenRef: string): string;
+/**
+ * Resolve single token binding with caching
+ *
+ * Process:
+ * 1. Check cache for previously resolved binding
+ * 2. Substitute template variables from props
+ * 3. Convert to CSS variable reference
+ * 4. Cache the result
+ *
+ * @param binding - Token binding (may contain template variables)
+ * @param context - Resolution context with props and theme
+ * @returns CSS variable reference
+ * @throws Error if template variable substitution fails
+ *
+ * @example
+ * ```typescript
+ * const context = {
+ *   props: { variant: 'primary', size: 'medium' },
+ *   theme: 'default'
+ * };
+ *
+ * resolveBinding('component.button.{variant}.background', context);
+ * // → 'var(--component-button-primary-background)'
+ *
+ * resolveBinding('atomic.spacing.{size}', context);
+ * // → 'var(--atomic-spacing-medium)'
+ * ```
+ */
+export declare function resolveBinding(binding: string, context: TokenBindingContext): string;
+/**
+ * Resolve all token bindings for a component
+ *
+ * Processes all token bindings in the component schema,
+ * substituting template variables and converting to CSS variables.
+ *
+ * @param bindings - Token bindings from component schema
+ * @param context - Resolution context with props and theme
+ * @returns Resolved token bindings map (property → CSS variable)
+ *
+ * @example
+ * ```typescript
+ * const bindings = {
+ *   background: 'component.button.{variant}.background',
+ *   foreground: 'component.button.{variant}.foreground',
+ *   padding: 'atomic.spacing.{size}'
+ * };
+ *
+ * const context = {
+ *   props: { variant: 'primary', size: 'medium' },
+ *   theme: 'default'
+ * };
+ *
+ * const resolved = resolveBindings(bindings, context);
+ * // {
+ * //   background: 'var(--component-button-primary-background)',
+ * //   foreground: 'var(--component-button-primary-foreground)',
+ * //   padding: 'var(--atomic-spacing-medium)'
+ * // }
+ * ```
+ */
+export declare function resolveBindings(bindings: TokenBindings, context: TokenBindingContext): ResolvedTokenBindings;
+/**
+ * Validate token binding format
+ *
+ * Checks if a token binding string is valid:
+ * - Must be in dot notation (e.g., "atomic.spacing.16")
+ * - May contain template variables (e.g., "component.button.{variant}.background")
+ * - Must start with valid layer (atomic, semantic, component)
+ *
+ * @param binding - Token binding to validate
+ * @returns True if valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidTokenBinding('atomic.spacing.16'); // → true
+ * isValidTokenBinding('component.button.{variant}.background'); // → true
+ * isValidTokenBinding('invalid-format'); // → false
+ * ```
+ */
+export declare function isValidTokenBinding(binding: string): boolean;
+/**
+ * Extract template variable names from binding
+ *
+ * @param binding - Token binding with template variables
+ * @returns Array of template variable names
+ *
+ * @example
+ * ```typescript
+ * extractTemplateVariables('component.button.{variant}.{size}.background');
+ * // → ['variant', 'size']
+ *
+ * extractTemplateVariables('atomic.spacing.16');
+ * // → []
+ * ```
+ */
+export declare function extractTemplateVariables(binding: string): string[];
+//# sourceMappingURL=token-resolver.d.ts.map

package/dist/screen-generation/resolver/token-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-resolver.d.ts","sourceRoot":"","sources":["../../../src/screen-generation/resolver/token-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAMhE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAY3D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAmCR;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOzD;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAoBpF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,mBAAmB,GAC3B,qBAAqB,CAiBvB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA6B5D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAIlE"}