@thewhateverapp/tile-sdk 0.13.31 → 0.13.33

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,cAAc,WAAW,CAAC"}

package/dist/react/index.js

@@ -1,3 +1,4 @@
+'use client';
 export { TileProvider, TileContext } from './TileProvider';
 export { useTile } from './useTile';
 export { useKeyboard } from './useKeyboard';

package/dist/spec/host/OverlayHost.d.ts

@@ -0,0 +1,68 @@
+/**
+ * OverlayHost
+ *
+ * Host-side provider for the overlay spec system.
+ * Manages data, events, and integration with the tile bridge.
+ */
+import { type ReactNode } from 'react';
+import type { SpecEvent, SpecCommand, OverlaySpec } from '../types';
+import type { VideoTimeSource } from '../runtime/TimeSync';
+export interface OverlayHostContextValue {
+    /** Update host data */
+    updateData: (key: string, value: unknown) => void;
+    /** Update multiple data values */
+    updateDataBatch: (updates: Record<string, unknown>) => void;
+    /** Send a command to the overlay */
+    sendCommand: (command: SpecCommand) => void;
+    /** Current data snapshot */
+    data: Record<string, unknown>;
+    /** User context */
+    ctx: Record<string, unknown>;
+}
+export interface OverlayHostProps {
+    /** The overlay spec to render */
+    spec: OverlaySpec;
+    /** Initial host data */
+    initialData?: Record<string, unknown>;
+    /** User context (userId, roles, etc.) */
+    ctx?: Record<string, unknown>;
+    /** Video time source for sync */
+    timeSource?: VideoTimeSource | null;
+    /** Event callback when spec emits events */
+    onEvent?: (event: SpecEvent) => void;
+    /** Navigate to page callback */
+    onNavigateToPage?: () => void;
+    /** Open tile callback */
+    onOpenTile?: (tileId: string) => void;
+    /** Show captions */
+    showCaptions?: boolean;
+    /** Children (typically the video player) */
+    children?: ReactNode;
+}
+export declare function OverlayHost({ spec, initialData, ctx, timeSource, onEvent, onNavigateToPage, onOpenTile, showCaptions, children, }: OverlayHostProps): JSX.Element;
+/**
+ * Hook to access the overlay host context.
+ */
+export declare function useOverlayHost(): OverlayHostContextValue;
+/**
+ * Hook to update host data.
+ */
+export declare function useHostDataUpdater(): (key: string, value: unknown) => void;
+/**
+ * Hook to get current host data.
+ */
+export declare function useHostData<T = unknown>(key: string): T | undefined;
+export interface SubscriptionConfig {
+    /** Channel to subscribe to */
+    channel: string;
+    /** Data key to update */
+    dataKey: string;
+    /** Transform function */
+    transform?: (message: unknown) => unknown;
+}
+/**
+ * Hook to subscribe to realtime updates and sync to host data.
+ */
+export declare function useSubscriptionAdapter(subscriptions: SubscriptionConfig[], subscribe: (channel: string, callback: (data: unknown) => void) => () => void): void;
+export default OverlayHost;
+//# sourceMappingURL=OverlayHost.d.ts.map

package/dist/spec/host/OverlayHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayHost.d.ts","sourceRoot":"","sources":["../../../src/spec/host/OverlayHost.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EAOZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAa,MAAM,UAAU,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA+D3D,MAAM,WAAW,uBAAuB;IACtC,uBAAuB;IACvB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAElD,kCAAkC;IAClC,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAE5D,oCAAoC;IACpC,WAAW,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAE5C,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAQD,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,IAAI,EAAE,WAAW,CAAC;IAElB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B,iCAAiC;IACjC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAEpC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAErC,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAE9B,yBAAyB;IACzB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC,oBAAoB;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAMD,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,WAAgB,EAChB,GAAQ,EACR,UAAiB,EACjB,OAAO,EACP,gBAAgB,EAChB,UAAU,EACV,YAAmB,EACnB,QAAQ,GACT,EAAE,gBAAgB,GAAG,GAAG,CAAC,OAAO,CA0EhC;AAMD;;GAEG;AACH,wBAAgB,cAAc,IAAI,uBAAuB,CAMxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAG1E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAGnE;AAMD,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAEhB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,yBAAyB;IACzB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,kBAAkB,EAAE,EACnC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,GAC5E,IAAI,CAkBN;AAED,eAAe,WAAW,CAAC"}

package/dist/spec/host/OverlayHost.js

@@ -0,0 +1,143 @@
+/**
+ * OverlayHost
+ *
+ * Host-side provider for the overlay spec system.
+ * Manages data, events, and integration with the tile bridge.
+ */
+import React, { createContext, useContext, useState, useCallback, useMemo, useEffect, } from 'react';
+import { OverlayRuntime } from '../runtime/OverlayRuntime';
+import { OverlayCueContainer } from '../renderer/OverlayCue';
+import { CaptionTrackRenderer } from '../renderer/CaptionTrack';
+import { ThemeProvider, defaultTheme, darkTheme, lightTheme, neonTheme, warmTheme, coolTheme, } from '../theme';
+// Theme preset mapping
+const themePresets = {
+    default: defaultTheme,
+    dark: darkTheme,
+    light: lightTheme,
+    neon: neonTheme,
+    warm: warmTheme,
+    cool: coolTheme,
+};
+/**
+ * Convert spec theme to full overlay theme
+ */
+function resolveSpecTheme(specTheme) {
+    if (!specTheme)
+        return undefined;
+    const baseTheme = specTheme.preset ? themePresets[specTheme.preset] : defaultTheme;
+    return {
+        ...baseTheme,
+        colors: {
+            ...baseTheme.colors,
+            primary: specTheme.colors?.primary ?? baseTheme.colors.primary,
+            secondary: specTheme.colors?.secondary ?? baseTheme.colors.secondary,
+            background: specTheme.colors?.background ?? baseTheme.colors.background,
+            foreground: specTheme.colors?.foreground ?? baseTheme.colors.foreground,
+            success: specTheme.colors?.success ?? baseTheme.colors.success,
+            warning: specTheme.colors?.warning ?? baseTheme.colors.warning,
+            error: specTheme.colors?.error ?? baseTheme.colors.error,
+        },
+        typography: {
+            ...baseTheme.typography,
+            fontFamily: specTheme.typography?.fontFamily ?? baseTheme.typography.fontFamily,
+        },
+        components: {
+            ...baseTheme.components,
+            caption: {
+                ...baseTheme.components?.caption,
+                ...specTheme.components?.caption,
+            },
+        },
+    };
+}
+const OverlayHostContext = createContext(null);
+// =============================================================================
+// Provider Component
+// =============================================================================
+export function OverlayHost({ spec, initialData = {}, ctx = {}, timeSource = null, onEvent, onNavigateToPage, onOpenTile, showCaptions = true, children, }) {
+    // Host data state
+    const [data, setData] = useState(initialData);
+    // Update single data value
+    const updateData = useCallback((key, value) => {
+        setData((prev) => ({ ...prev, [key]: value }));
+    }, []);
+    // Update multiple data values
+    const updateDataBatch = useCallback((updates) => {
+        setData((prev) => ({ ...prev, ...updates }));
+    }, []);
+    // Send command to overlay (for future use)
+    const sendCommand = useCallback((command) => {
+        console.log('OverlayHost command:', command);
+        // Commands can be used to control the overlay from the host
+    }, []);
+    // Event handler - forward to parent and handle internally
+    const handleEvent = useCallback((event) => {
+        // Forward to parent callback
+        onEvent?.(event);
+        // Could also handle events internally here
+        // e.g., for tracking, analytics, etc.
+    }, [onEvent]);
+    const hostValue = useMemo(() => ({
+        updateData,
+        updateDataBatch,
+        sendCommand,
+        data,
+        ctx,
+    }), [updateData, updateDataBatch, sendCommand, data, ctx]);
+    // Resolve theme from spec
+    const resolvedTheme = useMemo(() => resolveSpecTheme(spec.theme), [spec.theme]);
+    return (React.createElement(ThemeProvider, { theme: resolvedTheme },
+        React.createElement(OverlayHostContext.Provider, { value: hostValue },
+            React.createElement(OverlayRuntime, { spec: spec, timeSource: timeSource, data: data, ctx: ctx, onEvent: handleEvent, onNavigateToPage: onNavigateToPage, onOpenTile: onOpenTile },
+                React.createElement("div", { className: "overlay-host relative" },
+                    children,
+                    React.createElement(OverlayCueContainer, null),
+                    showCaptions && spec.tracks?.captions && (React.createElement(CaptionTrackRenderer, { track: spec.tracks.captions })))))));
+}
+// =============================================================================
+// Hooks
+// =============================================================================
+/**
+ * Hook to access the overlay host context.
+ */
+export function useOverlayHost() {
+    const context = useContext(OverlayHostContext);
+    if (!context) {
+        throw new Error('useOverlayHost must be used within an OverlayHost provider');
+    }
+    return context;
+}
+/**
+ * Hook to update host data.
+ */
+export function useHostDataUpdater() {
+    const { updateData } = useOverlayHost();
+    return updateData;
+}
+/**
+ * Hook to get current host data.
+ */
+export function useHostData(key) {
+    const { data } = useOverlayHost();
+    return data[key];
+}
+/**
+ * Hook to subscribe to realtime updates and sync to host data.
+ */
+export function useSubscriptionAdapter(subscriptions, subscribe) {
+    const { updateData } = useOverlayHost();
+    useEffect(() => {
+        const unsubscribes = [];
+        for (const sub of subscriptions) {
+            const unsub = subscribe(sub.channel, (message) => {
+                const value = sub.transform ? sub.transform(message) : message;
+                updateData(sub.dataKey, value);
+            });
+            unsubscribes.push(unsub);
+        }
+        return () => {
+            unsubscribes.forEach((unsub) => unsub());
+        };
+    }, [subscriptions, subscribe, updateData]);
+}
+export default OverlayHost;

package/dist/spec/host/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Host Module Index
+ *
+ * Exports all host-side components and utilities.
+ */
+export { OverlayHost, useOverlayHost, useHostDataUpdater, useHostData, useSubscriptionAdapter, type OverlayHostProps, type OverlayHostContextValue, type SubscriptionConfig, } from './OverlayHost';
+//# sourceMappingURL=index.d.ts.map

package/dist/spec/host/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spec/host/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC"}

package/dist/spec/host/index.js

@@ -0,0 +1,6 @@
+/**
+ * Host Module Index
+ *
+ * Exports all host-side components and utilities.
+ */
+export { OverlayHost, useOverlayHost, useHostDataUpdater, useHostData, useSubscriptionAdapter, } from './OverlayHost';

package/dist/spec/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Overlay Spec Module
+ *
+ * A declarative, time-synced UI protocol for hybrid video tiles.
+ *
+ * @example
+ * ```tsx
+ * import { OverlayRuntime, OverlayHost, validateSpec } from '@thewhateverapp/tile-sdk/spec';
+ *
+ * function HybridTile({ spec }: { spec: OverlaySpec }) {
+ *   return (
+ *     <OverlayHost onEvent={handleEvent}>
+ *       <VideoPlayer src={videoUrl}>
+ *         <OverlayRuntime spec={spec} />
+ *       </VideoPlayer>
+ *     </OverlayHost>
+ *   );
+ * }
+ * ```
+ */
+export type { OverlaySpec, SpecMeta, SyncConfig, TimeTransform, StateConfig, TracksConfig, CaptionTrack, CaptionSegment, CaptionStyle, OverlayCue, TimeWindow, Placement, TilePlacement, FullPlacement, DismissPolicy, DismissTrigger, LayoutNode, PropValue, Binding, Action, ActionType, Condition, BindingCondition, ComparisonCondition, LogicalCondition, SubscriptionDeclaration, SpecContext, SpecState, SpecEvent, SpecCommand, Size, Weight, Color, Variant, Align, Justify, ValidationProfile, SpecTheme, } from './types';
+export { isBinding, isAction, TILE_PROFILE, FULL_PROFILE } from './types';
+export { OverlaySpecSchema, BindingSchema, ActionSchema, PropValueSchema, ConditionSchema, LayoutNodeSchema, PlacementSchema, OverlayCueSchema, CaptionTrackSchema, validateSpec, parseSpec, validateAgainstProfile, } from './schema';
+export { ComponentRegistry, globalRegistry, registerComponent, getComponent, hasComponent, getAllComponentIds, type RegistryComponentProps, type ComponentWithAction, sizeClasses, colorClasses, weightClasses, alignClasses, justifyClasses, paddingClasses, gapClasses, Text, Button, Stack, Row, Image, ProgressBar, Spacer, Divider, registerPrimitives, PRIMITIVE_TYPES, type PrimitiveType, type PrimitivePropsMap, type TextProps, type ButtonProps, type StackProps, type RowProps, type ImageProps, type ProgressBarProps, type SpacerProps, type DividerProps, Poll, Prediction, CountdownCTA, BottomSheet, registerComposites, COMPOSITE_TYPES, type CompositeType, type CompositePropsMap, type PollProps, type PollOption, type PredictionProps, type PredictionOption, type PredictionStatus, type CountdownCTAProps, type BottomSheetProps, registerAllComponents, } from './registry';
+export { OverlayRuntime, useOverlayRuntime, useRuntimeTime, useRuntimeState, useRuntimeData, useRuntimeAction, type OverlayRuntimeProps, type OverlayRuntimeContextValue, createStateManager, useSpecState, useSpecStateValue, useSpecStateSetter, type StateManager, type StateSnapshot, createActionRouter, isActionValue, type ActionRouter, type ActionContext, useTimeSync, useWallClockTime, createVideoTimeSource, isTimeInWindow, type TimeState, type VideoTimeSource, } from './runtime';
+export { LayoutRenderer, LayoutTree, type LayoutRendererProps, resolveBindingPath, resolveBinding, resolveProps, resolvePropValue, createBindingContext, type BindingContext, CaptionTrackRenderer, useActiveCaption, type CaptionTrackProps, OverlayCueRenderer, OverlayCueContainer, type OverlayCueRendererProps, } from './renderer';
+export { OverlayHost, useOverlayHost, useHostDataUpdater, useHostData, useSubscriptionAdapter, type OverlayHostProps, type OverlayHostContextValue, type SubscriptionConfig, } from './host';
+export { ThemeProvider, useTheme, useThemeColors, useThemeColor, generateThemeCSS, defaultTheme, darkTheme, lightTheme, neonTheme, warmTheme, coolTheme, type OverlayTheme, type ThemeColors, type ThemeTypography, type ThemeSpacing, type ThemeRadius, type ThemeComponents, type ThemeProviderProps, } from './theme';
+//# sourceMappingURL=index.d.ts.map

package/dist/spec/index.d.ts.map

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

package/dist/spec/index.js

@@ -0,0 +1,81 @@
+/**
+ * Overlay Spec Module
+ *
+ * A declarative, time-synced UI protocol for hybrid video tiles.
+ *
+ * @example
+ * ```tsx
+ * import { OverlayRuntime, OverlayHost, validateSpec } from '@thewhateverapp/tile-sdk/spec';
+ *
+ * function HybridTile({ spec }: { spec: OverlaySpec }) {
+ *   return (
+ *     <OverlayHost onEvent={handleEvent}>
+ *       <VideoPlayer src={videoUrl}>
+ *         <OverlayRuntime spec={spec} />
+ *       </VideoPlayer>
+ *     </OverlayHost>
+ *   );
+ * }
+ * ```
+ */
+export { isBinding, isAction, TILE_PROFILE, FULL_PROFILE } from './types';
+// =============================================================================
+// Schema & Validation
+// =============================================================================
+export { 
+// Main schema
+OverlaySpecSchema, 
+// Sub-schemas
+BindingSchema, ActionSchema, PropValueSchema, ConditionSchema, LayoutNodeSchema, PlacementSchema, OverlayCueSchema, CaptionTrackSchema, 
+// Validation functions
+validateSpec, parseSpec, validateAgainstProfile, } from './schema';
+// =============================================================================
+// Component Registry
+// =============================================================================
+export { 
+// Registry core
+ComponentRegistry, globalRegistry, registerComponent, getComponent, hasComponent, getAllComponentIds, 
+// Design tokens
+sizeClasses, colorClasses, weightClasses, alignClasses, justifyClasses, paddingClasses, gapClasses, 
+// Primitives
+Text, Button, Stack, Row, Image, ProgressBar, Spacer, Divider, registerPrimitives, PRIMITIVE_TYPES, 
+// Composites
+Poll, Prediction, CountdownCTA, BottomSheet, registerComposites, COMPOSITE_TYPES, 
+// All components
+registerAllComponents, } from './registry';
+// =============================================================================
+// Runtime
+// =============================================================================
+export { 
+// Main provider
+OverlayRuntime, useOverlayRuntime, useRuntimeTime, useRuntimeState, useRuntimeData, useRuntimeAction, 
+// State management
+createStateManager, useSpecState, useSpecStateValue, useSpecStateSetter, 
+// Action routing
+createActionRouter, isActionValue, 
+// Time sync
+useTimeSync, useWallClockTime, createVideoTimeSource, isTimeInWindow, } from './runtime';
+// =============================================================================
+// Renderer
+// =============================================================================
+export { 
+// Layout rendering
+LayoutRenderer, LayoutTree, 
+// Binding resolution
+resolveBindingPath, resolveBinding, resolveProps, resolvePropValue, createBindingContext, 
+// Caption rendering
+CaptionTrackRenderer, useActiveCaption, 
+// Overlay cue rendering
+OverlayCueRenderer, OverlayCueContainer, } from './renderer';
+// =============================================================================
+// Host
+// =============================================================================
+export { OverlayHost, useOverlayHost, useHostDataUpdater, useHostData, useSubscriptionAdapter, } from './host';
+// =============================================================================
+// Theme
+// =============================================================================
+export { 
+// Provider
+ThemeProvider, useTheme, useThemeColors, useThemeColor, generateThemeCSS, 
+// Preset themes
+defaultTheme, darkTheme, lightTheme, neonTheme, warmTheme, coolTheme, } from './theme';

package/dist/spec/registry/ComponentRegistry.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Component Registry
+ *
+ * Maps component type IDs (e.g., "ui.text", "ui.button") to React components.
+ * The spec uses string IDs; the registry resolves them to actual components.
+ */
+import type { ComponentType, ReactNode } from 'react';
+/**
+ * Props passed to all registered components
+ */
+export interface RegistryComponentProps {
+    /** Resolved props from spec */
+    [key: string]: unknown;
+    /** Children nodes (already rendered) */
+    children?: ReactNode;
+    /** Action handler */
+    onAction?: (action: {
+        $action: string;
+        payload?: Record<string, unknown>;
+    }) => void;
+}
+/**
+ * Component with action support type helper
+ */
+export type ComponentWithAction<P = Record<string, unknown>> = ComponentType<P & {
+    onAction?: RegistryComponentProps['onAction'];
+}>;
+/**
+ * Component definition in the registry
+ */
+export interface ComponentDefinition {
+    /** The React component */
+    component: ComponentType<RegistryComponentProps>;
+    /** Default props */
+    defaults?: Record<string, unknown>;
+    /** Prop validation/transformation */
+    transformProps?: (props: Record<string, unknown>) => Record<string, unknown>;
+}
+/**
+ * Register a component with the registry.
+ * Components should extend RegistryComponentProps but can have additional required props.
+ */
+export declare function registerComponent<P extends RegistryComponentProps = RegistryComponentProps>(type: string, component: ComponentType<any>, options?: {
+    defaults?: Record<string, unknown>;
+    transformProps?: (props: Record<string, unknown>) => Record<string, unknown>;
+}): void;
+/**
+ * Get a component from the registry
+ */
+export declare function getComponent(type: string): ComponentDefinition | undefined;
+/**
+ * Check if a component type is registered
+ */
+export declare function hasComponent(type: string): boolean;
+/**
+ * Get all registered component types
+ */
+export declare function getRegisteredTypes(): string[];
+/** Alias for getRegisteredTypes */
+export declare const getAllComponentIds: typeof getRegisteredTypes;
+/**
+ * Clear the registry (useful for testing)
+ */
+export declare function clearRegistry(): void;
+export declare class ComponentRegistry {
+    private components;
+    /**
+     * Register a component
+     */
+    register(type: string, component: ComponentType<RegistryComponentProps>, options?: {
+        defaults?: Record<string, unknown>;
+        transformProps?: (props: Record<string, unknown>) => Record<string, unknown>;
+    }): this;
+    /**
+     * Get a component definition
+     */
+    get(type: string): ComponentDefinition | undefined;
+    /**
+     * Check if type is registered
+     */
+    has(type: string): boolean;
+    /**
+     * Get all registered types
+     */
+    types(): string[];
+    /**
+     * Merge another registry into this one
+     */
+    merge(other: ComponentRegistry): this;
+    /**
+     * Create a child registry that inherits from this one
+     */
+    extend(): ComponentRegistry;
+}
+export declare const defaultRegistry: ComponentRegistry;
+/** Alias for defaultRegistry (for compatibility) */
+export declare const globalRegistry: ComponentRegistry;
+/**
+ * Fallback component for unknown types.
+ * This is defined in the React component files that use it.
+ */
+export declare function createUnknownComponentMessage(type: string): string;
+/**
+ * Size token to Tailwind class mapping
+ */
+export declare const sizeClasses: {
+    readonly xs: "text-xs";
+    readonly sm: "text-sm";
+    readonly md: "text-base";
+    readonly lg: "text-lg";
+    readonly xl: "text-xl";
+    readonly '2xl': "text-2xl";
+};
+/**
+ * Weight token to Tailwind class mapping
+ */
+export declare const weightClasses: {
+    readonly normal: "font-normal";
+    readonly medium: "font-medium";
+    readonly semibold: "font-semibold";
+    readonly bold: "font-bold";
+};
+/**
+ * Color token to Tailwind class mapping
+ */
+export declare const colorClasses: {
+    readonly primary: "text-purple-500";
+    readonly secondary: "text-gray-500";
+    readonly success: "text-green-500";
+    readonly warning: "text-yellow-500";
+    readonly error: "text-red-500";
+    readonly muted: "text-gray-400";
+    readonly white: "text-white";
+    readonly black: "text-black";
+};
+/**
+ * Background color token to Tailwind class mapping
+ */
+export declare const bgColorClasses: {
+    readonly primary: "bg-purple-500";
+    readonly secondary: "bg-gray-500";
+    readonly success: "bg-green-500";
+    readonly warning: "bg-yellow-500";
+    readonly error: "bg-red-500";
+    readonly muted: "bg-gray-400";
+    readonly white: "bg-white";
+    readonly black: "bg-black";
+};
+/**
+ * Variant token to button style mapping
+ */
+export declare const variantStyles: {
+    readonly solid: {
+        readonly base: "bg-purple-500 text-white hover:bg-purple-600";
+        readonly disabled: "bg-gray-300 text-gray-500";
+    };
+    readonly outline: {
+        readonly base: "border-2 border-purple-500 text-purple-500 hover:bg-purple-50";
+        readonly disabled: "border-gray-300 text-gray-400";
+    };
+    readonly ghost: {
+        readonly base: "text-purple-500 hover:bg-purple-50";
+        readonly disabled: "text-gray-400";
+    };
+    readonly link: {
+        readonly base: "text-purple-500 underline hover:text-purple-600";
+        readonly disabled: "text-gray-400";
+    };
+};
+/**
+ * Gap token to Tailwind class mapping
+ */
+export declare const gapClasses: {
+    readonly xs: "gap-1";
+    readonly sm: "gap-2";
+    readonly md: "gap-4";
+    readonly lg: "gap-6";
+    readonly xl: "gap-8";
+};
+/**
+ * Padding token to Tailwind class mapping
+ */
+export declare const paddingClasses: {
+    readonly xs: "p-1";
+    readonly sm: "p-2";
+    readonly md: "p-4";
+    readonly lg: "p-6";
+    readonly xl: "p-8";
+};
+/**
+ * Align token to Tailwind class mapping
+ */
+export declare const alignClasses: {
+    readonly left: "items-start";
+    readonly center: "items-center";
+    readonly right: "items-end";
+};
+/**
+ * Justify token to Tailwind class mapping
+ */
+export declare const justifyClasses: {
+    readonly start: "justify-start";
+    readonly center: "justify-center";
+    readonly end: "justify-end";
+    readonly between: "justify-between";
+    readonly around: "justify-around";
+};
+//# sourceMappingURL=ComponentRegistry.d.ts.map

package/dist/spec/registry/ComponentRegistry.d.ts.map

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