@thewhateverapp/tile-sdk 0.13.31 → 0.13.33

package/dist/spec/runtime/StateManager.js

@@ -0,0 +1,60 @@
+/**
+ * StateManager
+ *
+ * Manages local spec state with React integration.
+ */
+import { useCallback, useSyncExternalStore } from 'react';
+/**
+ * Creates a state manager for spec local state.
+ */
+export function createStateManager(initial = {}) {
+    let state = { ...initial };
+    const listeners = new Set();
+    const notify = () => {
+        listeners.forEach((listener) => listener());
+    };
+    return {
+        getSnapshot() {
+            return state;
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        setState(key, value) {
+            if (state[key] !== value) {
+                state = { ...state, [key]: value };
+                notify();
+            }
+        },
+        getState(key) {
+            return state[key];
+        },
+        reset() {
+            state = { ...initial };
+            notify();
+        },
+    };
+}
+/**
+ * Hook to use spec state in components.
+ */
+export function useSpecState(manager) {
+    return useSyncExternalStore(manager.subscribe, manager.getSnapshot, manager.getSnapshot // Same for server
+    );
+}
+/**
+ * Hook to get a specific state value.
+ */
+export function useSpecStateValue(manager, key) {
+    const state = useSpecState(manager);
+    return state[key];
+}
+/**
+ * Hook to get a state setter.
+ */
+export function useSpecStateSetter(manager) {
+    return useCallback((key, value) => {
+        manager.setState(key, value);
+    }, [manager]);
+}

package/dist/spec/runtime/TimeSync.d.ts

@@ -0,0 +1,47 @@
+/**
+ * TimeSync
+ *
+ * Time synchronization with video player.
+ */
+import type { SyncConfig } from '../types';
+export interface TimeState {
+    /** Current time in milliseconds */
+    timeMs: number;
+    /** Total duration in milliseconds */
+    durationMs: number;
+    /** Whether the video is playing */
+    isPlaying: boolean;
+    /** Whether the video has ended */
+    hasEnded: boolean;
+}
+export interface VideoTimeSource {
+    /** Get current time in seconds */
+    getCurrentTime(): number;
+    /** Get duration in seconds */
+    getDuration(): number;
+    /** Check if playing */
+    isPlaying(): boolean;
+    /** Check if ended */
+    hasEnded(): boolean;
+    /** Subscribe to time updates */
+    onTimeUpdate(callback: () => void): () => void;
+    /** Subscribe to seek events */
+    onSeek?(callback: () => void): () => void;
+}
+/**
+ * Hook for time synchronization with video player.
+ */
+export declare function useTimeSync(source: VideoTimeSource | null, config?: SyncConfig): TimeState;
+/**
+ * Hook for wall clock time (not synced to video).
+ */
+export declare function useWallClockTime(intervalMs?: number): TimeState;
+/**
+ * Creates a video time source from an HTML video element.
+ */
+export declare function createVideoTimeSource(video: HTMLVideoElement): VideoTimeSource;
+/**
+ * Checks if a time is within a window (with tolerance).
+ */
+export declare function isTimeInWindow(timeMs: number, startMs?: number, endMs?: number, toleranceMs?: number): boolean;
+//# sourceMappingURL=TimeSync.d.ts.map

package/dist/spec/runtime/TimeSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeSync.d.ts","sourceRoot":"","sources":["../../../src/spec/runtime/TimeSync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,UAAU,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IAEnB,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,cAAc,IAAI,MAAM,CAAC;IAEzB,8BAA8B;IAC9B,WAAW,IAAI,MAAM,CAAC;IAEtB,uBAAuB;IACvB,SAAS,IAAI,OAAO,CAAC;IAErB,qBAAqB;IACrB,QAAQ,IAAI,OAAO,CAAC;IAEpB,gCAAgC;IAChC,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE/C,+BAA+B;IAC/B,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3C;AA8BD;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,eAAe,GAAG,IAAI,EAC9B,MAAM,GAAE,UAAgC,GACvC,SAAS,CAiEX;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,GAAE,MAAa,GAAG,SAAS,CAoBrE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,eAAe,CAiB9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,GAAE,MAAU,GACtB,OAAO,CAQT"}

package/dist/spec/runtime/TimeSync.js

@@ -0,0 +1,140 @@
+/**
+ * TimeSync
+ *
+ * Time synchronization with video player.
+ */
+import { useState, useEffect, useCallback, useRef } from 'react';
+const DEFAULT_SYNC_CONFIG = {
+    timebase: 'player',
+    tick: 'timeupdate',
+    toleranceMs: 100,
+    onSeek: 'recompute',
+};
+/**
+ * Applies a time transform to the current time.
+ */
+function applyTransform(timeMs, transform) {
+    if (!transform)
+        return timeMs;
+    let result = timeMs;
+    // Apply offset
+    if (transform.offsetMs) {
+        result += transform.offsetMs;
+    }
+    // Apply scale
+    if (transform.scale && transform.scale !== 1) {
+        result *= transform.scale;
+    }
+    return Math.max(0, result);
+}
+/**
+ * Hook for time synchronization with video player.
+ */
+export function useTimeSync(source, config = DEFAULT_SYNC_CONFIG) {
+    const [state, setState] = useState({
+        timeMs: 0,
+        durationMs: 0,
+        isPlaying: false,
+        hasEnded: false,
+    });
+    const rafRef = useRef();
+    const lastUpdateRef = useRef(0);
+    const updateTime = useCallback(() => {
+        if (!source)
+            return;
+        const now = performance.now();
+        const rawTimeMs = source.getCurrentTime() * 1000;
+        const transformedTime = applyTransform(rawTimeMs, config.transform);
+        setState({
+            timeMs: transformedTime,
+            durationMs: source.getDuration() * 1000,
+            isPlaying: source.isPlaying(),
+            hasEnded: source.hasEnded(),
+        });
+        lastUpdateRef.current = now;
+    }, [source, config.transform]);
+    useEffect(() => {
+        if (!source)
+            return;
+        // Initial update
+        updateTime();
+        // Subscribe based on tick mode
+        if (config.tick === 'raf') {
+            const loop = () => {
+                updateTime();
+                rafRef.current = requestAnimationFrame(loop);
+            };
+            rafRef.current = requestAnimationFrame(loop);
+            return () => {
+                if (rafRef.current) {
+                    cancelAnimationFrame(rafRef.current);
+                }
+            };
+        }
+        else {
+            // timeupdate mode
+            return source.onTimeUpdate(updateTime);
+        }
+    }, [source, config.tick, updateTime]);
+    // Handle seek events
+    useEffect(() => {
+        if (!source?.onSeek)
+            return;
+        return source.onSeek(() => {
+            if (config.onSeek === 'recompute') {
+                updateTime();
+            }
+        });
+    }, [source, config.onSeek, updateTime]);
+    return state;
+}
+/**
+ * Hook for wall clock time (not synced to video).
+ */
+export function useWallClockTime(intervalMs = 1000) {
+    const [state, setState] = useState({
+        timeMs: Date.now(),
+        durationMs: Infinity,
+        isPlaying: true,
+        hasEnded: false,
+    });
+    useEffect(() => {
+        const interval = setInterval(() => {
+            setState((prev) => ({
+                ...prev,
+                timeMs: Date.now(),
+            }));
+        }, intervalMs);
+        return () => clearInterval(interval);
+    }, [intervalMs]);
+    return state;
+}
+/**
+ * Creates a video time source from an HTML video element.
+ */
+export function createVideoTimeSource(video) {
+    return {
+        getCurrentTime: () => video.currentTime,
+        getDuration: () => video.duration || 0,
+        isPlaying: () => !video.paused && !video.ended,
+        hasEnded: () => video.ended,
+        onTimeUpdate(callback) {
+            video.addEventListener('timeupdate', callback);
+            return () => video.removeEventListener('timeupdate', callback);
+        },
+        onSeek(callback) {
+            video.addEventListener('seeked', callback);
+            return () => video.removeEventListener('seeked', callback);
+        },
+    };
+}
+/**
+ * Checks if a time is within a window (with tolerance).
+ */
+export function isTimeInWindow(timeMs, startMs, endMs, toleranceMs = 0) {
+    const adjustedStart = startMs !== undefined ? startMs - toleranceMs : undefined;
+    const adjustedEnd = endMs !== undefined ? endMs + toleranceMs : undefined;
+    const afterStart = adjustedStart === undefined || timeMs >= adjustedStart;
+    const beforeEnd = adjustedEnd === undefined || timeMs < adjustedEnd;
+    return afterStart && beforeEnd;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * Runtime Module Index
+ *
+ * Exports all runtime components and utilities.
+ */
+export { OverlayRuntime, useOverlayRuntime, useRuntimeTime, useRuntimeState, useRuntimeData, useRuntimeAction, evaluateCondition, resolveBinding, getNestedValue, type OverlayRuntimeProps, type OverlayRuntimeContextValue, type EvaluationContext, } from './OverlayRuntime';
+export { createStateManager, useSpecState, useSpecStateValue, useSpecStateSetter, type StateManager, type StateSnapshot, } from './StateManager';
+export { createActionRouter, isActionValue, type ActionRouter, type ActionContext, } from './ActionRouter';
+export { useTimeSync, useWallClockTime, createVideoTimeSource, isTimeInWindow, type TimeState, type VideoTimeSource, } from './TimeSync';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spec/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC"}

package/dist/spec/runtime/index.js

@@ -0,0 +1,13 @@
+/**
+ * Runtime Module Index
+ *
+ * Exports all runtime components and utilities.
+ */
+// Main runtime provider
+export { OverlayRuntime, useOverlayRuntime, useRuntimeTime, useRuntimeState, useRuntimeData, useRuntimeAction, evaluateCondition, resolveBinding, getNestedValue, } from './OverlayRuntime';
+// State management
+export { createStateManager, useSpecState, useSpecStateValue, useSpecStateSetter, } from './StateManager';
+// Action routing
+export { createActionRouter, isActionValue, } from './ActionRouter';
+// Time synchronization
+export { useTimeSync, useWallClockTime, createVideoTimeSource, isTimeInWindow, } from './TimeSync';