@thewhateverapp/tile-sdk 0.13.31 → 0.13.33

package/dist/spec/theme/index.js

@@ -0,0 +1,12 @@
+/**
+ * Theme Module Index
+ *
+ * Exports theme provider and presets for overlay styling.
+ */
+export { 
+// Provider
+ThemeProvider, useTheme, useThemeColors, useThemeColor, generateThemeCSS, 
+// Default theme
+defaultTheme, 
+// Preset themes
+darkTheme, lightTheme, neonTheme, warmTheme, coolTheme, } from './ThemeProvider';

package/dist/spec/types.d.ts

@@ -0,0 +1,322 @@
+/**
+ * Overlay Spec Types
+ *
+ * A declarative, time-synced UI protocol for hybrid video tiles.
+ * Specs describe what to show and when, the host runtime handles rendering.
+ */
+export interface OverlaySpec {
+    /** Spec format version */
+    specVersion: '1.0';
+    /** Unique spec identifier */
+    id: string;
+    /** Target surface */
+    surface: 'tile' | 'full';
+    /** Optional metadata */
+    meta?: SpecMeta;
+    /** Time synchronization config */
+    sync: SyncConfig;
+    /** Local state initialization */
+    state: StateConfig;
+    /** Content tracks (captions + overlays) */
+    tracks: TracksConfig;
+    /** Data subscriptions (host-managed) */
+    subscriptions?: SubscriptionDeclaration[];
+    /** Theme configuration (colors, typography, spacing) */
+    theme?: SpecTheme;
+}
+/**
+ * Theme configuration that can be embedded in a spec.
+ * Allows AI agents to customize overlay appearance.
+ */
+export interface SpecTheme {
+    /** Use a preset theme as base */
+    preset?: 'default' | 'dark' | 'light' | 'neon' | 'warm' | 'cool';
+    /** Custom color overrides */
+    colors?: Partial<{
+        primary: string;
+        secondary: string;
+        background: string;
+        foreground: string;
+        success: string;
+        warning: string;
+        error: string;
+    }>;
+    /** Typography overrides */
+    typography?: Partial<{
+        fontFamily: string;
+    }>;
+    /** Component-specific overrides */
+    components?: {
+        caption?: {
+            background?: string;
+            textColor?: string;
+            speakerColor?: string;
+        };
+    };
+}
+export interface SpecMeta {
+    title?: string;
+    author?: string;
+    description?: string;
+    version?: string;
+}
+export interface SyncConfig {
+    /** Time source: video player or wall clock */
+    timebase: 'player' | 'wallClock';
+    /** Update frequency: requestAnimationFrame or video timeupdate event */
+    tick: 'raf' | 'timeupdate';
+    /** Tolerance for time window boundaries (ms) */
+    toleranceMs: number;
+    /** Behavior on video seek */
+    onSeek: 'recompute';
+    /** Optional time transform */
+    transform?: TimeTransform;
+    /** Optional conditions to freeze time */
+    freezeWhen?: Condition;
+}
+export interface TimeTransform {
+    /** Offset in milliseconds */
+    offsetMs?: number;
+    /** Scale factor (1.0 = normal speed) */
+    scale?: number;
+}
+export interface StateConfig {
+    /** Initial local state values */
+    local: Record<string, unknown>;
+}
+export interface TracksConfig {
+    /** Optional caption track */
+    captions?: CaptionTrack;
+    /** Overlay cues */
+    overlays: OverlayCue[];
+}
+export interface CaptionTrack {
+    /** Time-coded caption segments */
+    segments: CaptionSegment[];
+    /** Caption styling */
+    style: CaptionStyle;
+}
+export interface CaptionSegment {
+    /** Start time in milliseconds */
+    startMs: number;
+    /** End time in milliseconds */
+    endMs: number;
+    /** Caption text */
+    text: string;
+    /** Optional speaker identifier */
+    speaker?: string;
+}
+export interface CaptionStyle {
+    /** Position on screen */
+    position?: 'top' | 'bottom' | 'center';
+    /** Text size preset */
+    size?: 'sm' | 'md' | 'lg';
+    /** Optional background style */
+    background?: 'none' | 'solid' | 'gradient' | boolean;
+    /** Optional text shadow */
+    shadow?: boolean;
+    /** Optional text color */
+    color?: string;
+}
+export interface OverlayCue {
+    /** Unique cue identifier */
+    id: string;
+    /** Time window for visibility */
+    window: TimeWindow;
+    /** Additional visibility condition */
+    visibleWhen?: Condition;
+    /** Positioning configuration */
+    placement: Placement;
+    /** Dismiss behavior */
+    dismiss?: DismissPolicy;
+    /** Layout tree to render */
+    layout: LayoutNode;
+    /** Optional z-index override */
+    zIndex?: number;
+}
+export interface TimeWindow {
+    /** Start time in ms (undefined = from beginning) */
+    startMs?: number;
+    /** End time in ms (undefined = until end) */
+    endMs?: number;
+}
+export type Placement = TilePlacement | FullPlacement;
+export interface TilePlacement {
+    /** Lane-based positioning for tile surface */
+    lane: 'top' | 'center' | 'bottom';
+    /** Inset from edges (pixels) */
+    inset?: number;
+    /** Horizontal alignment within lane */
+    align?: 'left' | 'center' | 'right';
+    /** Z-index */
+    zIndex?: number;
+}
+export interface FullPlacement {
+    /** Full surface positioning */
+    type: 'fullscreen' | 'inset' | 'positioned';
+    /** Direct position values */
+    top?: number | string;
+    right?: number | string;
+    bottom?: number | string;
+    left?: number | string;
+    /** Dimensions */
+    width?: number | string;
+    height?: number | string;
+    /** Z-index */
+    zIndex?: number;
+    /** Insets for 'inset' type (legacy/alternative) */
+    insets?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Position for 'positioned' type (legacy/alternative) */
+    position?: {
+        x: number | string;
+        y: number | string;
+    };
+}
+export interface DismissTrigger {
+    /** Trigger type */
+    type: 'tap' | 'swipe' | 'timeout' | 'action' | 'tap-outside' | 'time-window-end';
+    /** Delay for timeout triggers */
+    delayMs?: number;
+    /** Direction for swipe triggers */
+    direction?: 'up' | 'down' | 'left' | 'right';
+}
+export interface DismissPolicy {
+    /** Dismiss triggers (array of trigger objects) */
+    triggers: DismissTrigger[];
+    /** Animation type */
+    animation?: 'fade' | 'slide' | 'none';
+    /** Animation duration in ms */
+    durationMs?: number;
+}
+export interface LayoutNode {
+    /** Component type (registry ID) */
+    type: string;
+    /** Component props */
+    props?: Record<string, PropValue>;
+    /** Child nodes */
+    children?: LayoutNode[];
+    /** Optional key for list rendering */
+    key?: string;
+}
+/** Primitive prop values */
+export type PrimitivePropValue = string | number | boolean | null;
+/** Complex prop value (may contain nested values) */
+export type PropValue = PrimitivePropValue | Binding | Action | PropValue[] | {
+    [key: string]: PropValue;
+};
+export interface Binding {
+    /** Binding path */
+    $bind: string;
+    /** Fallback value if binding resolves to undefined */
+    fallback?: unknown;
+    /** Optional format string */
+    format?: string;
+}
+export declare function isBinding(value: unknown): value is Binding;
+export interface Action {
+    /** Action type */
+    $action: ActionType;
+    /** Action payload */
+    payload?: Record<string, unknown>;
+}
+export type ActionType = 'emit' | 'setState' | 'sequence' | 'openTile' | 'openFull' | 'navigate' | 'dismiss' | 'fx';
+export declare function isAction(value: unknown): value is Action;
+export type Condition = BindingCondition | ComparisonCondition | LogicalCondition;
+export interface BindingCondition {
+    $bind: string;
+}
+export interface ComparisonCondition {
+    op: 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'notIn';
+    left: PropValue;
+    right: PropValue;
+}
+export interface LogicalCondition {
+    op: 'and' | 'or' | 'not';
+    conditions: Condition[];
+}
+export interface SubscriptionDeclaration {
+    /** Subscription identifier */
+    id: string;
+    /** Subscription type */
+    type: 'realtime' | 'keyspace' | 'host';
+    /** Channel or key to subscribe to */
+    channel: string;
+    /** Path to write data to (in data.*) */
+    target: string;
+    /** Optional transform/filter */
+    transform?: string;
+}
+export interface SpecContext {
+    /** Tile ID */
+    tileId: string;
+    /** Current user ID (if authenticated) */
+    userId?: string;
+    /** Current surface */
+    surface: 'tile' | 'full';
+    /** Is user authenticated */
+    isAuthenticated: boolean;
+    /** Device info */
+    device: {
+        platform: 'ios' | 'android' | 'web';
+        viewport: {
+            width: number;
+            height: number;
+        };
+    };
+}
+export interface SpecState {
+    /** Local state (managed by spec) */
+    local: Record<string, unknown>;
+    /** Data from host (subscriptions, props) */
+    data: Record<string, unknown>;
+    /** Read-only context */
+    ctx: SpecContext;
+    /** Current effective time in ms */
+    timeMs: number;
+}
+export interface SpecEvent {
+    /** Event type/name */
+    type: string;
+    /** Event payload */
+    payload?: Record<string, unknown>;
+    /** Timestamp (auto-added if not provided) */
+    timestamp?: number;
+    /** Source cue ID */
+    cueId?: string;
+}
+export interface SpecCommand {
+    /** Command type */
+    type: 'setData' | 'setState' | 'dismiss' | 'fx';
+    /** Command payload */
+    payload: Record<string, unknown>;
+}
+export type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+export type Weight = 'normal' | 'medium' | 'semibold' | 'bold';
+export type Color = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'muted' | 'white' | 'black';
+export type Variant = 'solid' | 'outline' | 'ghost' | 'link';
+export type Align = 'left' | 'center' | 'right';
+export type Justify = 'start' | 'center' | 'end' | 'between' | 'around';
+export interface ValidationProfile {
+    /** Profile name */
+    name: 'tile' | 'full';
+    /** Max simultaneous overlays */
+    maxOverlays: number;
+    /** Max text length */
+    maxTextLength: number;
+    /** Allowed placement types */
+    allowedPlacements: string[];
+    /** Allowed component types */
+    allowedComponents: string[];
+    /** Allow scroll containers */
+    allowScroll: boolean;
+    /** Allow navigation actions */
+    allowNavigation: boolean;
+}
+export declare const TILE_PROFILE: ValidationProfile;
+export declare const FULL_PROFILE: ValidationProfile;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/spec/types.js

@@ -0,0 +1,36 @@
+/**
+ * Overlay Spec Types
+ *
+ * A declarative, time-synced UI protocol for hybrid video tiles.
+ * Specs describe what to show and when, the host runtime handles rendering.
+ */
+export function isBinding(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '$bind' in value &&
+        typeof value.$bind === 'string');
+}
+export function isAction(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '$action' in value &&
+        typeof value.$action === 'string');
+}
+export const TILE_PROFILE = {
+    name: 'tile',
+    maxOverlays: 3,
+    maxTextLength: 200,
+    allowedPlacements: ['lane'],
+    allowedComponents: ['ui.*'],
+    allowScroll: false,
+    allowNavigation: false,
+};
+export const FULL_PROFILE = {
+    name: 'full',
+    maxOverlays: 10,
+    maxTextLength: 1000,
+    allowedPlacements: ['lane', 'fullscreen', 'inset', 'positioned'],
+    allowedComponents: ['ui.*', 'tile.*'],
+    allowScroll: true,
+    allowNavigation: true,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thewhateverapp/tile-sdk",
-  "version": "0.13.31",
+  "version": "0.13.33",
   "description": "SDK for building interactive tiles on The Whatever App platform",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -13,6 +13,10 @@
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js"
     },
+    "./spec": {
+      "types": "./dist/spec/index.d.ts",
+      "import": "./dist/spec/index.js"
+    },
     "./tools": {
       "types": "./dist/tools/index.d.ts",
       "import": "./dist/tools/index.js"
@@ -51,6 +55,9 @@
   ],
   "author": "The Whatever App",
   "license": "MIT",
+  "dependencies": {
+    "zod": "^3.22.0"
+  },
   "peerDependencies": {
     "react": "^18.0.0"
   },