@tekton-ui/core 0.2.0

package/dist/blueprint.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @tekton-ui/core - Blueprint Module
+ * Define and validate screen blueprints
+ * Target: 150 LOC
+ */
+import type { Blueprint, ComponentNode, LayoutType } from './types.js';
+export interface LayoutSlot {
+    name: string;
+    required: boolean;
+    allowedComponents?: string[];
+}
+export declare const LAYOUTS: Record<LayoutType, LayoutSlot[]>;
+export declare const COMPONENT_CATALOG: readonly ["Button", "Input", "Card", "Text", "Heading", "Image", "Link", "List", "Form", "Modal", "Tabs", "Table", "Badge", "Avatar", "Dropdown", "Checkbox", "Radio", "Switch", "Slider", "Progress"];
+export type ComponentType = (typeof COMPONENT_CATALOG)[number];
+export interface CreateBlueprintInput {
+    name: string;
+    description?: string;
+    themeId: string;
+    layout: LayoutType;
+    layoutToken?: string;
+    components: ComponentNode[];
+}
+/**
+ * Create a new blueprint with validation
+ * Supports optional layoutToken for advanced layout configuration
+ */
+export declare function createBlueprint(input: CreateBlueprintInput): Blueprint;
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate blueprint structure
+ */
+export declare function validateBlueprint(blueprint: Blueprint): ValidationResult;
+/**
+ * Check if component type is in catalog
+ */
+export declare function isValidComponent(type: string): boolean;
+/**
+ * Get layout slots for a layout type
+ */
+export declare function getLayoutSlots(layout: LayoutType): LayoutSlot[];
+//# sourceMappingURL=blueprint.d.ts.map

package/dist/blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../src/blueprint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAOvE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAoCpD,CAAC;AAMF,eAAO,MAAM,iBAAiB,wMAqBpB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAM/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAsBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS,CA6BtE;AAMD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAqCxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,CAE/D"}

package/dist/blueprint.js

@@ -0,0 +1,163 @@
+/**
+ * @tekton-ui/core - Blueprint Module
+ * Define and validate screen blueprints
+ * Target: 150 LOC
+ */
+import { resolveLayout } from './layout-resolver.js';
+export const LAYOUTS = {
+    'single-column': [
+        { name: 'header', required: false },
+        { name: 'main', required: true },
+        { name: 'footer', required: false },
+    ],
+    'two-column': [
+        { name: 'header', required: false },
+        { name: 'left', required: true },
+        { name: 'right', required: true },
+        { name: 'footer', required: false },
+    ],
+    'sidebar-left': [
+        { name: 'header', required: false },
+        { name: 'sidebar', required: true },
+        { name: 'main', required: true },
+        { name: 'footer', required: false },
+    ],
+    'sidebar-right': [
+        { name: 'header', required: false },
+        { name: 'main', required: true },
+        { name: 'sidebar', required: true },
+        { name: 'footer', required: false },
+    ],
+    dashboard: [
+        { name: 'header', required: true },
+        { name: 'sidebar', required: true },
+        { name: 'main', required: true },
+        { name: 'footer', required: false },
+    ],
+    landing: [
+        { name: 'hero', required: true },
+        { name: 'features', required: false },
+        { name: 'cta', required: false },
+        { name: 'footer', required: false },
+    ],
+};
+// ============================================================================
+// Component Catalog
+// ============================================================================
+export const COMPONENT_CATALOG = [
+    'Button',
+    'Input',
+    'Card',
+    'Text',
+    'Heading',
+    'Image',
+    'Link',
+    'List',
+    'Form',
+    'Modal',
+    'Tabs',
+    'Table',
+    'Badge',
+    'Avatar',
+    'Dropdown',
+    'Checkbox',
+    'Radio',
+    'Switch',
+    'Slider',
+    'Progress',
+];
+/**
+ * Validate layout token ID format
+ * Must match: "shell.*.*" OR "page.*" OR "section.*"
+ */
+function validateLayoutToken(layoutToken) {
+    const shellPattern = /^shell\.[a-z0-9-]+\.[a-z0-9-]+$/;
+    const pagePattern = /^page\.[a-z0-9-]+$/;
+    const sectionPattern = /^section\.[a-z0-9-]+$/;
+    if (!shellPattern.test(layoutToken) &&
+        !pagePattern.test(layoutToken) &&
+        !sectionPattern.test(layoutToken)) {
+        throw new Error(`Invalid layoutToken format: "${layoutToken}". Must match "shell.*.*", "page.*", or "section.*"`);
+    }
+}
+/**
+ * Create a new blueprint with validation
+ * Supports optional layoutToken for advanced layout configuration
+ */
+export function createBlueprint(input) {
+    const id = `bp-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    // Handle layoutToken if provided
+    let layoutConfig;
+    if (input.layoutToken) {
+        // Validate layoutToken format
+        validateLayoutToken(input.layoutToken);
+        // Resolve layoutToken to get layoutConfig
+        try {
+            layoutConfig = resolveLayout(input.layoutToken);
+        }
+        catch (error) {
+            throw new Error(`Failed to resolve layoutToken "${input.layoutToken}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return {
+        id,
+        name: input.name,
+        description: input.description,
+        themeId: input.themeId,
+        layout: input.layout,
+        layoutToken: input.layoutToken,
+        layoutConfig,
+        components: input.components,
+    };
+}
+/**
+ * Validate blueprint structure
+ */
+export function validateBlueprint(blueprint) {
+    const errors = [];
+    // Check required fields
+    if (!blueprint.id) {
+        errors.push('Missing blueprint id');
+    }
+    if (!blueprint.name) {
+        errors.push('Missing blueprint name');
+    }
+    if (!blueprint.themeId) {
+        errors.push('Missing themeId');
+    }
+    if (!blueprint.layout) {
+        errors.push('Missing layout');
+    }
+    // Check layout validity
+    if (blueprint.layout && !LAYOUTS[blueprint.layout]) {
+        errors.push(`Invalid layout: ${blueprint.layout}`);
+    }
+    // Check components
+    if (!blueprint.components || !Array.isArray(blueprint.components)) {
+        errors.push('Components must be an array');
+    }
+    else {
+        for (const comp of blueprint.components) {
+            if (!comp.type) {
+                errors.push('Component missing type');
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Check if component type is in catalog
+ */
+export function isValidComponent(type) {
+    return COMPONENT_CATALOG.includes(type);
+}
+/**
+ * Get layout slots for a layout type
+ */
+export function getLayoutSlots(layout) {
+    return LAYOUTS[layout] || [];
+}
+//# sourceMappingURL=blueprint.js.map

package/dist/blueprint.js.map

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

package/dist/component-schemas.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @tekton-ui/core - Component Schema Definitions
+ * Platform-agnostic component interface specifications with token bindings
+ * [SPEC-COMPONENT-001-B] [TAG-001] [TAG-002] [TAG-003]
+ */
+/**
+ * Property definition for component props
+ */
+export interface PropDefinition {
+    /** Property name */
+    name: string;
+    /** Property type (TypeScript-style) */
+    type: string;
+    /** Whether the property is required */
+    required: boolean;
+    /** Human-readable description */
+    description: string;
+    /** Default value if not required */
+    defaultValue?: unknown;
+    /** Allowed values (for enum-like props) */
+    options?: string[];
+}
+/**
+ * Accessibility requirements for a component
+ */
+export interface A11yRequirements {
+    /** ARIA role */
+    role: string;
+    /** WCAG compliance level */
+    wcag: string;
+    /** Required ARIA attributes */
+    ariaAttributes?: string[];
+    /** Keyboard interaction requirements */
+    keyboard?: string[];
+    /** Focus management requirements */
+    focus?: string;
+    /** Screen reader announcements */
+    screenReader?: string;
+}
+/**
+ * Token bindings map component properties to design tokens
+ * Supports template variables like {variant}, {size}
+ */
+export type TokenBindings = Record<string, string>;
+/**
+ * Complete component schema definition
+ */
+export interface ComponentSchema {
+    /** Component type identifier */
+    type: string;
+    /** Component category */
+    category: 'primitive' | 'composed';
+    /** Component properties */
+    props: PropDefinition[];
+    /** Design token bindings with template variables */
+    tokenBindings: TokenBindings;
+    /** Accessibility requirements (WCAG 2.1 AA) */
+    a11y: A11yRequirements;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * All primitive components (10)
+ */
+export declare const PRIMITIVE_COMPONENTS: ComponentSchema[];
+/**
+ * All composed components (10)
+ */
+export declare const COMPOSED_COMPONENTS: ComponentSchema[];
+/**
+ * All components registry (20 total)
+ */
+export declare const ALL_COMPONENTS: ComponentSchema[];
+/**
+ * Get component schema by type
+ */
+export declare function getComponentSchema(type: string): ComponentSchema | undefined;
+//# sourceMappingURL=component-schemas.d.ts.map

package/dist/component-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-schemas.d.ts","sourceRoot":"","sources":["../src/component-schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAElB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,yBAAyB;IACzB,QAAQ,EAAE,WAAW,GAAG,UAAU,CAAC;IAEnC,2BAA2B;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IAExB,oDAAoD;IACpD,aAAa,EAAE,aAAa,CAAC;IAE7B,+CAA+C;IAC/C,IAAI,EAAE,gBAAgB,CAAC;IAEvB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAw/BD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAAe,EAWjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAAe,EAWhD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,eAAe,EAAsD,CAAC;AAEnG;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE5E"}