@hypertools/sdk 0.1.0

package/dist/controls/types.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Control definition types
+ */
+export type ControlType = 'number' | 'color' | 'boolean' | 'string' | 'text' | 'select' | 'selector' | 'point' | 'point2d' | 'point3d' | 'point4d' | 'folder' | 'group' | 'button' | 'tab' | 'file';
+export interface BaseControlDefinition {
+    type?: ControlType;
+    label?: string;
+    value?: any;
+    readonly?: boolean;
+    interval?: number;
+    bufferSize?: number;
+    multiline?: boolean;
+    rows?: number;
+    view?: 'graph';
+}
+export interface NumberControlDefinition extends BaseControlDefinition {
+    type: 'number';
+    value: number;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+export interface ColorControlDefinition extends BaseControlDefinition {
+    type: 'color';
+    value: string;
+}
+export interface BooleanControlDefinition extends BaseControlDefinition {
+    type: 'boolean';
+    value: boolean;
+}
+export interface StringControlDefinition extends BaseControlDefinition {
+    type: 'string' | 'text';
+    value: string;
+}
+export interface SelectControlDefinition extends BaseControlDefinition {
+    type: 'select' | 'selector';
+    value: string | number;
+    options: Record<string, string | number> | Array<string | number> | Array<{
+        label?: string;
+        text?: string;
+        value: string | number;
+    }>;
+}
+export interface AxisConstraints {
+    min?: number;
+    max?: number;
+    step?: number;
+    inverted?: boolean;
+}
+export interface Point2DControlDefinition extends BaseControlDefinition {
+    type?: 'point' | 'point2d';
+    value: {
+        x: number;
+        y: number;
+    };
+    min?: number | {
+        x: number;
+        y: number;
+    };
+    max?: number | {
+        x: number;
+        y: number;
+    };
+    step?: number | {
+        x: number;
+        y: number;
+    };
+    x?: AxisConstraints;
+    y?: AxisConstraints;
+}
+export interface Point3DControlDefinition extends BaseControlDefinition {
+    type?: 'point' | 'point3d';
+    value: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    min?: number | {
+        x: number;
+        y: number;
+        z: number;
+    };
+    max?: number | {
+        x: number;
+        y: number;
+        z: number;
+    };
+    step?: number | {
+        x: number;
+        y: number;
+        z: number;
+    };
+    x?: AxisConstraints;
+    y?: AxisConstraints;
+    z?: AxisConstraints;
+}
+export interface Point4DControlDefinition extends BaseControlDefinition {
+    type?: 'point' | 'point4d';
+    value: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    min?: number | {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    max?: number | {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    step?: number | {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    x?: AxisConstraints;
+    y?: AxisConstraints;
+    z?: AxisConstraints;
+    w?: AxisConstraints;
+}
+export interface FolderDefinition extends BaseControlDefinition {
+    type: 'folder' | 'group';
+    value?: never;
+    expanded?: boolean;
+    controls: ControlDefinitions;
+}
+export interface ButtonDefinition extends BaseControlDefinition {
+    type: 'button';
+    value?: never;
+    title: string;
+    onClick?: () => void;
+}
+export interface FileControlDefinition extends BaseControlDefinition {
+    type: 'file';
+    value: string | null;
+    accept?: string;
+    maxSize?: number;
+    preview?: boolean;
+    placeholder?: string;
+}
+export interface TabPage {
+    title: string;
+    controls: ControlDefinitions;
+}
+export interface TabDefinition extends BaseControlDefinition {
+    type: 'tab';
+    value?: never;
+    pages: TabPage[];
+}
+export type ControlDefinition = NumberControlDefinition | ColorControlDefinition | BooleanControlDefinition | StringControlDefinition | SelectControlDefinition | Point2DControlDefinition | Point3DControlDefinition | Point4DControlDefinition | FolderDefinition | ButtonDefinition | TabDefinition | FileControlDefinition;
+export type ControlDefinitions = Record<string, ControlDefinition>;
+export type ControlPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+export interface ControlChangeContext<T extends ControlDefinitions = ControlDefinitions> {
+    key: keyof T;
+    value: any;
+    event: any;
+}
+export interface HypertoolControlsOptions<T extends ControlDefinitions = ControlDefinitions> {
+    title?: string;
+    position?: ControlPosition;
+    expanded?: boolean;
+    container?: HTMLElement | string | null;
+    onChange?: (params: ParameterValues<T>, context: ControlChangeContext<T>) => void;
+    onReady?: () => void;
+}
+export type ParameterValues<T extends ControlDefinitions> = {
+    [K in keyof T]: T[K] extends FolderDefinition ? ParameterValues<T[K]['controls']> : T[K] extends TabDefinition ? any[] : T[K] extends ButtonDefinition ? never : T[K] extends {
+        value: infer V;
+    } ? V : never;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/EventEmitter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Typed event system for Experience
+ */
+export type ExperienceEventType = 'ready' | 'error' | 'frame' | 'resize' | 'paramChange' | 'play' | 'pause' | 'objectRegistered' | 'objectUnregistered' | string;
+export interface ExperienceEvent {
+    type: ExperienceEventType;
+    timestamp: number;
+}
+export interface ReadyEvent extends ExperienceEvent {
+    type: 'ready';
+}
+export interface ErrorEvent extends ExperienceEvent {
+    type: 'error';
+    error: Error;
+}
+export interface FrameEvent extends ExperienceEvent {
+    type: 'frame';
+    frame: number;
+    deltaTime: number;
+}
+export interface ResizeEvent extends ExperienceEvent {
+    type: 'resize';
+    width: number;
+    height: number;
+}
+export interface ParamChangeEvent extends ExperienceEvent {
+    type: 'paramChange';
+    key: string;
+    value: unknown;
+    previousValue: unknown;
+}
+export interface PlayEvent extends ExperienceEvent {
+    type: 'play';
+}
+export interface PauseEvent extends ExperienceEvent {
+    type: 'pause';
+}
+export interface ObjectRegisteredEvent extends ExperienceEvent {
+    type: 'objectRegistered';
+    name: string;
+    id: string;
+}
+export interface ObjectUnregisteredEvent extends ExperienceEvent {
+    type: 'objectUnregistered';
+    name: string;
+}
+export type EventHandler<T extends ExperienceEvent = ExperienceEvent> = (event: T) => void;
+export declare class EventEmitter {
+    private _handlers;
+    /**
+     * Subscribe to event
+     * @returns Unsubscribe function
+     */
+    on<T extends ExperienceEvent>(type: T['type'], handler: EventHandler<T>): () => void;
+    /**
+     * Subscribe once - auto-unsubscribes after first call
+     */
+    once<T extends ExperienceEvent>(type: T['type'], handler: EventHandler<T>): () => void;
+    /**
+     * Unsubscribe from event
+     */
+    off<T extends ExperienceEvent>(type: T['type'], handler: EventHandler<T>): void;
+    /**
+     * Emit event to all handlers
+     */
+    emit<T extends ExperienceEvent>(event: T): void;
+    /**
+     * Remove all listeners for a type (or all if no type specified)
+     */
+    removeAllListeners(type?: ExperienceEventType): void;
+    /**
+     * Get listener count for a type
+     */
+    listenerCount(type: ExperienceEventType): number;
+}
+//# sourceMappingURL=EventEmitter.d.ts.map

package/dist/core/EventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../src/core/EventEmitter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,GACR,aAAa,GACb,MAAM,GACN,OAAO,GACP,kBAAkB,GAClB,oBAAoB,GACpB,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAU,SAAQ,eAAe;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,CACtE,KAAK,EAAE,CAAC,KACL,IAAI,CAAC;AAEV,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAqD;IAEtE;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,eAAe,EAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,MAAM,IAAI;IAUb;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,eAAe,EAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,MAAM,IAAI;IAQb;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,eAAe,EAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,IAAI;IAOP;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAa/C;;OAEG;IACH,kBAAkB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAQpD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM;CAGjD"}

package/dist/core/Experience.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Core Experience class - THE shared logic for all runtimes
+ *
+ * This is the brain. All adapters (Frame, Export, HostedPreview) use this.
+ * Adapters are thin wiring layers - Experience contains ALL the logic.
+ */
+import { EventEmitter, type ExperienceEvent, type EventHandler } from './EventEmitter';
+import { type ParamDefinitions, type ParamValues } from './ParamStore';
+import { ObjectRegistry } from './ObjectRegistry';
+export interface ExperienceConfig {
+    /** Mount element where content is rendered */
+    mount: HTMLElement;
+    /** Parameter definitions schema */
+    paramDefs?: ParamDefinitions;
+    /** Initial parameter values (overrides defaults from paramDefs) */
+    initialParams?: Record<string, unknown>;
+    /** User's setup function */
+    setup: SetupFunction;
+    /** Auto-start on init (default: true) */
+    autoplay?: boolean;
+    /** Target frame rate for frame events (default: 60) */
+    frameRate?: number;
+    /** Background color/style */
+    background?: string;
+}
+/**
+ * Context passed to user's setup function
+ * This is the API users interact with in their code
+ */
+export interface ExperienceContext {
+    /** DOM element to render into */
+    mount: HTMLElement;
+    /** Reactive params object (Proxy) - changes trigger events */
+    params: ParamValues;
+    /** Export/capture utilities */
+    exports: ExportsApi;
+    /** Environment utilities (window, document, resize) */
+    environment: EnvironmentApi;
+    /** Register an object for Spline-like queries */
+    registerObject: <T = unknown>(name: string, object: T, metadata?: Record<string, unknown>) => string;
+    /** Find registered object by name */
+    findObjectByName: <T = unknown>(name: string) => T | undefined;
+    /** Experience instance (for advanced use) */
+    experience: Experience;
+}
+export interface ExportsApi {
+    /** Capture canvas as image */
+    captureImage: (format?: 'png' | 'jpeg' | 'webp') => Promise<Blob | null>;
+    /** Set filename for exports */
+    setFilename: (filename: string) => void;
+    /** Register custom capture handler */
+    registerCaptureHandler: (handler: CaptureHandler) => void;
+}
+export type CaptureHandler = (format: string) => Promise<Blob | null>;
+export interface EnvironmentApi {
+    /** Window reference */
+    window: Window;
+    /** Document reference */
+    document: Document;
+    /** Subscribe to resize events, returns cleanup */
+    onResize: (callback: (width: number, height: number) => void) => () => void;
+    /** Add cleanup function to be called on destroy */
+    addCleanup: (cleanup: () => void) => void;
+}
+export type SetupFunction = (context: ExperienceContext) => CleanupFunction | void | Promise<CleanupFunction | void>;
+export type CleanupFunction = () => void;
+export declare class Experience {
+    private _isReady;
+    private _isPlaying;
+    private _isDestroyed;
+    private _currentFrame;
+    private _paramStore;
+    private _events;
+    private _objects;
+    private _mount;
+    private _frameRate;
+    private _filename;
+    private _cleanups;
+    private _userCleanup?;
+    private _animationFrameId?;
+    private _lastFrameTime;
+    private _resizeObserver?;
+    private _captureHandler?;
+    constructor(config: ExperienceConfig);
+    get isReady(): boolean;
+    get isPlaying(): boolean;
+    get isDestroyed(): boolean;
+    get currentFrame(): number;
+    get mount(): HTMLElement;
+    /** Reactive params proxy */
+    get params(): ParamValues;
+    /** EventEmitter for external subscriptions */
+    get events(): EventEmitter;
+    /** ObjectRegistry for external access */
+    get objects(): ObjectRegistry;
+    setParam(key: string, value: unknown): void;
+    setParams(params: Record<string, unknown>): void;
+    getParams(): Record<string, unknown>;
+    getParamDefs(): ParamDefinitions;
+    resetParams(): void;
+    registerObject<T = unknown>(name: string, object: T, metadata?: Record<string, unknown>): string;
+    findObjectByName<T = unknown>(name: string): T | undefined;
+    findObjectById<T = unknown>(id: string): T | undefined;
+    getAllObjects(): Map<string, unknown>;
+    play(): void;
+    pause(): void;
+    toggle(): void;
+    on<T extends ExperienceEvent>(type: T['type'], handler: EventHandler<T>): () => void;
+    once<T extends ExperienceEvent>(type: T['type'], handler: EventHandler<T>): () => void;
+    off<T extends ExperienceEvent>(type: T['type'], handler: EventHandler<T>): void;
+    captureImage(format?: 'png' | 'jpeg' | 'webp'): Promise<Blob | null>;
+    getFilename(): string;
+    /**
+     * Add a cleanup function to be called on destroy
+     */
+    addCleanup(cleanup: CleanupFunction): void;
+    /**
+     * Destroy the experience and run all cleanups
+     */
+    destroy(): void;
+    private _runSetup;
+    private _createContext;
+    private _createExportsApi;
+    private _createEnvironmentApi;
+    private _setupResizeObserver;
+    private _tick;
+}
+//# sourceMappingURL=Experience.d.ts.map

package/dist/core/Experience.d.ts.map

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

package/dist/core/ObjectRegistry.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Spline-like object registry for querying objects by name/id
+ */
+export interface RegisteredObject<T = unknown> {
+    name: string;
+    id: string;
+    object: T;
+    metadata?: Record<string, unknown>;
+}
+export type ObjectRegisteredCallback = (name: string, id: string, object: unknown) => void;
+export type ObjectUnregisteredCallback = (name: string) => void;
+export declare class ObjectRegistry {
+    private _byName;
+    private _byId;
+    private _onRegister;
+    private _onUnregister;
+    /**
+     * Register an object for external access
+     * @returns Generated ID for the object
+     */
+    register<T>(name: string, object: T, metadata?: Record<string, unknown>): string;
+    /**
+     * Unregister an object by name
+     */
+    unregister(name: string): boolean;
+    /**
+     * Find object by name (Spline-like API)
+     */
+    findByName<T = unknown>(name: string): T | undefined;
+    /**
+     * Find object by ID
+     */
+    findById<T = unknown>(id: string): T | undefined;
+    /**
+     * Get registered object info by name
+     */
+    getInfo(name: string): RegisteredObject | undefined;
+    /**
+     * Check if an object exists
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered object names
+     */
+    getNames(): string[];
+    /**
+     * Get all registered objects as a Map
+     */
+    getAll(): Map<string, unknown>;
+    /**
+     * Query objects by metadata
+     */
+    query(predicate: (obj: RegisteredObject) => boolean): RegisteredObject[];
+    /**
+     * Query objects by type (requires metadata.type to be set)
+     */
+    findByType<T = unknown>(type: string): T[];
+    /**
+     * Clear all registered objects
+     */
+    clear(): void;
+    /**
+     * Subscribe to object registration events
+     */
+    onRegister(callback: ObjectRegisteredCallback): () => void;
+    /**
+     * Subscribe to object unregistration events
+     */
+    onUnregister(callback: ObjectUnregisteredCallback): () => void;
+    /**
+     * Get the number of registered objects
+     */
+    get size(): number;
+    private _generateId;
+}
+//# sourceMappingURL=ObjectRegistry.d.ts.map

package/dist/core/ObjectRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectRegistry.d.ts","sourceRoot":"","sources":["../../src/core/ObjectRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAC3F,MAAM,MAAM,0BAA0B,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEhE,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,aAAa,CAA8C;IAEnE;;;OAGG;IACH,QAAQ,CAAC,CAAC,EACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,EACT,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM;IA8BT;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAmBjC;;OAEG;IACH,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIpD;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIhD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAInD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;OAEG;IACH,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ9B;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,GAAG,gBAAgB,EAAE;IAUxE;;OAEG;IACH,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE;IAM1C;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAK1D;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,0BAA0B,GAAG,MAAM,IAAI;IAK9D;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,WAAW;CAGpB"}

package/dist/core/ParamStore.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Reactive parameter store with Proxy-based reactivity
+ */
+export type ParamType = 'number' | 'color' | 'boolean' | 'string' | 'select' | 'file' | 'point2d' | 'point3d';
+export interface SelectOption {
+    label: string;
+    value: string;
+}
+export interface ParamDefinition {
+    type: ParamType;
+    value: unknown;
+    label?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    options?: (string | SelectOption)[];
+    accept?: string;
+    maxSize?: number;
+}
+export type ParamDefinitions = Record<string, ParamDefinition>;
+export type ParamValues = Record<string, unknown>;
+export type ParamChangeCallback = (key: string, value: unknown, previousValue: unknown) => void;
+export declare class ParamStore {
+    private _definitions;
+    private _values;
+    private _listeners;
+    private _proxy;
+    constructor(definitions: ParamDefinitions, initialOverrides?: ParamValues);
+    private _createProxy;
+    private _validate;
+    private _notify;
+    /**
+     * Get reactive params proxy
+     */
+    getProxy(): ParamValues;
+    /**
+     * Get snapshot of current values (non-reactive copy)
+     */
+    getSnapshot(): ParamValues;
+    /**
+     * Get definitions
+     */
+    getDefinitions(): ParamDefinitions;
+    /**
+     * Set single value
+     */
+    set(key: string, value: unknown): void;
+    /**
+     * Set multiple values
+     */
+    setMultiple(params: ParamValues): void;
+    /**
+     * Reset to defaults
+     */
+    reset(): void;
+    /**
+     * Subscribe to changes
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: ParamChangeCallback): () => void;
+    /**
+     * Add a new param definition dynamically
+     */
+    addDefinition(key: string, definition: ParamDefinition): void;
+}
+//# sourceMappingURL=ParamStore.d.ts.map

package/dist/core/ParamStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParamStore.d.ts","sourceRoot":"","sources":["../../src/core/ParamStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,OAAO,GACP,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC;IAGpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,OAAO,KACnB,IAAI,CAAC;AAEV,qBAAa,UAAU;IACrB,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAAc;gBAEhB,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,EAAE,WAAW;IAuBzE,OAAO,CAAC,YAAY;IAyCpB,OAAO,CAAC,SAAS;IAiFjB,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACH,WAAW,IAAI,WAAW;IAI1B;;OAEG;IACH,cAAc,IAAI,gBAAgB;IAIlC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAMtC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAKpD;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI;CAI9D"}

package/dist/core/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Core SDK exports
+ */
+export { Experience } from './Experience';
+export type { ExperienceConfig, ExperienceContext, ExportsApi, EnvironmentApi, SetupFunction, CleanupFunction, CaptureHandler, } from './Experience';
+export { ParamStore } from './ParamStore';
+export type { ParamType, ParamDefinition, ParamDefinitions, ParamValues, ParamChangeCallback, SelectOption, } from './ParamStore';
+export { EventEmitter } from './EventEmitter';
+export type { ExperienceEventType, ExperienceEvent, ReadyEvent, ErrorEvent, FrameEvent, ResizeEvent, ParamChangeEvent, PlayEvent, PauseEvent, ObjectRegisteredEvent, ObjectUnregisteredEvent, EventHandler, } from './EventEmitter';
+export { ObjectRegistry } from './ObjectRegistry';
+export type { RegisteredObject, ObjectRegisteredCallback, ObjectUnregisteredCallback, } from './ObjectRegistry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,3 @@
+class H{_handlers=new Map;on(E,x){if(!this._handlers.has(E))this._handlers.set(E,new Set);return this._handlers.get(E).add(x),()=>this.off(E,x)}once(E,x){let C=(P)=>{this.off(E,C),x(P)};return this.on(E,C)}off(E,x){let C=this._handlers.get(E);if(C)C.delete(x)}emit(E){let x=this._handlers.get(E.type);if(!x)return;for(let C of x)try{C(E)}catch(P){console.error(`[EventEmitter] Handler error for ${E.type}:`,P)}}removeAllListeners(E){if(E)this._handlers.delete(E);else this._handlers.clear()}listenerCount(E){return this._handlers.get(E)?.size??0}}class O{_definitions;_values;_listeners;_proxy;constructor(E,x){this._definitions=E,this._listeners=new Set,this._values={};for(let[C,P]of Object.entries(E))this._values[C]=P.value;if(x){for(let[C,P]of Object.entries(x))if(C in this._definitions)this._values[C]=this._validate(C,P)}this._proxy=this._createProxy()}_createProxy(){let E=this;return new Proxy(this._values,{get(x,C){return x[C]},set(x,C,P){if(!(C in E._definitions))return console.warn(`[ParamStore] Unknown parameter: ${C}`),!1;let R=E._validate(C,P),D=x[C];if(R!==D)x[C]=R,E._notify(C,R,D);return!0},has(x,C){return C in x},ownKeys(x){return Object.keys(x)},getOwnPropertyDescriptor(x,C){if(C in x)return{enumerable:!0,configurable:!0,value:x[C]};return}})}_validate(E,x){let C=this._definitions[E];if(!C)return x;switch(C.type){case"number":{let P=typeof x==="number"?x:parseFloat(String(x));if(isNaN(P))P=C.value;if(C.min!==void 0)P=Math.max(C.min,P);if(C.max!==void 0)P=Math.min(C.max,P);if(C.step!==void 0)P=Math.round(P/C.step)*C.step;return P}case"color":{let P=String(x);if(/^#[0-9A-Fa-f]{6}$/.test(P))return P;if(/^#[0-9A-Fa-f]{3}$/.test(P))return P;if(/^#[0-9A-Fa-f]{8}$/.test(P))return P;if(/^rgb\(/.test(P))return P;if(/^rgba\(/.test(P))return P;if(/^hsl\(/.test(P))return P;if(/^hsla\(/.test(P))return P;return C.value}case"boolean":if(typeof x==="boolean")return x;if(x==="true"||x==="1")return!0;if(x==="false"||x==="0")return!1;return Boolean(x);case"string":return String(x);case"select":{let P=String(x);return(C.options||[]).some((F)=>typeof F==="object"?F.value===P:F===P)?P:C.value}case"point2d":{if(typeof x==="object"&&x!==null&&"x"in x&&"y"in x)return{x:Number(x.x),y:Number(x.y)};return C.value}case"point3d":{if(typeof x==="object"&&x!==null&&"x"in x&&"y"in x&&"z"in x)return{x:Number(x.x),y:Number(x.y),z:Number(x.z)};return C.value}default:return x}}_notify(E,x,C){for(let P of this._listeners)try{P(E,x,C)}catch(R){console.error("[ParamStore] Listener error:",R)}}getProxy(){return this._proxy}getSnapshot(){return{...this._values}}getDefinitions(){return{...this._definitions}}set(E,x){this._proxy[E]=x}setMultiple(E){for(let[x,C]of Object.entries(E))this._proxy[x]=C}reset(){for(let[E,x]of Object.entries(this._definitions))this._proxy[E]=x.value}subscribe(E){return this._listeners.add(E),()=>this._listeners.delete(E)}addDefinition(E,x){this._definitions[E]=x,this._values[E]=x.value}}class S{_byName=new Map;_byId=new Map;_onRegister=new Set;_onUnregister=new Set;register(E,x,C){if(this._byName.has(E))this.unregister(E);let P=this._generateId(),R={name:E,id:P,object:x,metadata:C};this._byName.set(E,R),this._byId.set(P,R);for(let D of this._onRegister)try{D(E,P,x)}catch(F){console.error("[ObjectRegistry] onRegister callback error:",F)}return P}unregister(E){let x=this._byName.get(E);if(!x)return!1;this._byName.delete(E),this._byId.delete(x.id);for(let C of this._onUnregister)try{C(E)}catch(P){console.error("[ObjectRegistry] onUnregister callback error:",P)}return!0}findByName(E){return this._byName.get(E)?.object}findById(E){return this._byId.get(E)?.object}getInfo(E){return this._byName.get(E)}has(E){return this._byName.has(E)}getNames(){return Array.from(this._byName.keys())}getAll(){let E=new Map;for(let[x,C]of this._byName)E.set(x,C.object);return E}query(E){let x=[];for(let C of this._byName.values())if(E(C))x.push(C);return x}findByType(E){return this.query((x)=>x.metadata?.type===E).map((x)=>x.object)}clear(){let E=Array.from(this._byName.keys());for(let x of E)this.unregister(x)}onRegister(E){return this._onRegister.add(E),()=>this._onRegister.delete(E)}onUnregister(E){return this._onUnregister.add(E),()=>this._onUnregister.delete(E)}get size(){return this._byName.size}_generateId(){return`obj_${Date.now()}_${Math.random().toString(36).slice(2,9)}`}}class U{_isReady=!1;_isPlaying=!1;_isDestroyed=!1;_currentFrame=0;_paramStore;_events;_objects;_mount;_frameRate;_filename="capture";_cleanups=[];_userCleanup;_animationFrameId;_lastFrameTime=0;_resizeObserver;_captureHandler;constructor(E){if(this._mount=E.mount,this._frameRate=E.frameRate??60,E.background)this._mount.style.background=E.background;this._paramStore=new O(E.paramDefs??{},E.initialParams),this._events=new H,this._objects=new S,this._paramStore.subscribe((x,C,P)=>{this._events.emit({type:"paramChange",timestamp:Date.now(),key:x,value:C,previousValue:P})}),this._setupResizeObserver(),this._runSetup(E.setup,E.autoplay??!0)}get isReady(){return this._isReady}get isPlaying(){return this._isPlaying}get isDestroyed(){return this._isDestroyed}get currentFrame(){return this._currentFrame}get mount(){return this._mount}get params(){return this._paramStore.getProxy()}get events(){return this._events}get objects(){return this._objects}setParam(E,x){this._paramStore.set(E,x)}setParams(E){this._paramStore.setMultiple(E)}getParams(){return this._paramStore.getSnapshot()}getParamDefs(){return this._paramStore.getDefinitions()}resetParams(){this._paramStore.reset()}registerObject(E,x,C){return this._objects.register(E,x,C)}findObjectByName(E){return this._objects.findByName(E)}findObjectById(E){return this._objects.findById(E)}getAllObjects(){return this._objects.getAll()}play(){if(this._isPlaying||this._isDestroyed)return;this._isPlaying=!0,this._lastFrameTime=performance.now(),this._tick(),this._events.emit({type:"play",timestamp:Date.now()})}pause(){if(!this._isPlaying)return;if(this._isPlaying=!1,this._animationFrameId)cancelAnimationFrame(this._animationFrameId),this._animationFrameId=void 0;this._events.emit({type:"pause",timestamp:Date.now()})}toggle(){if(this._isPlaying)this.pause();else this.play()}on(E,x){return this._events.on(E,x)}once(E,x){return this._events.once(E,x)}off(E,x){this._events.off(E,x)}async captureImage(E="png"){if(this._captureHandler)return this._captureHandler(E);let x=this._mount.querySelector("canvas");if(!x)return console.warn("[Experience] No canvas found for capture"),null;return new Promise((C)=>{let P=`image/${E}`,R=E==="jpeg"?0.92:void 0;x.toBlob((D)=>C(D),P,R)})}getFilename(){return this._filename}addCleanup(E){if(typeof E==="function")this._cleanups.push(E)}destroy(){if(this._isDestroyed)return;if(this._isDestroyed=!0,this.pause(),this._userCleanup)try{this._userCleanup()}catch(E){console.error("[Experience] User cleanup error:",E)}while(this._cleanups.length>0){let E=this._cleanups.pop();if(E)try{E()}catch(x){console.error("[Experience] Cleanup error:",x)}}this._resizeObserver?.disconnect(),this._objects.clear(),this._events.removeAllListeners(),this._events.emit({type:"destroyed",timestamp:Date.now()})}async _runSetup(E,x){try{let C=this._createContext(),P=await E(C);if(typeof P==="function")this._userCleanup=P;if(this._isReady=!0,this._events.emit({type:"ready",timestamp:Date.now()}),x)this.play()}catch(C){console.error("[Experience] Setup error:",C),this._events.emit({type:"error",timestamp:Date.now(),error:C instanceof Error?C:Error(String(C))})}}_createContext(){return{mount:this._mount,params:this._paramStore.getProxy(),exports:this._createExportsApi(),environment:this._createEnvironmentApi(),registerObject:(E,x,C)=>this._objects.register(E,x,C),findObjectByName:(E)=>this._objects.findByName(E),experience:this}}_createExportsApi(){return{captureImage:(E)=>this.captureImage(E),setFilename:(E)=>{this._filename=E},registerCaptureHandler:(E)=>{this._captureHandler=E}}}_createEnvironmentApi(){return{window,document,onResize:(E)=>{let x=()=>{E(this._mount.clientWidth,this._mount.clientHeight)};x();let C=new ResizeObserver(x);C.observe(this._mount);let P=()=>C.disconnect();return this._cleanups.push(P),P},addCleanup:(E)=>this.addCleanup(E)}}_setupResizeObserver(){this._resizeObserver=new ResizeObserver((E)=>{for(let x of E){let{width:C,height:P}=x.contentRect;this._events.emit({type:"resize",timestamp:Date.now(),width:C,height:P})}}),this._resizeObserver.observe(this._mount)}_tick(){if(!this._isPlaying)return;let E=performance.now(),x=E-this._lastFrameTime,C=1000/this._frameRate;if(x>=C)this._currentFrame++,this._lastFrameTime=E-x%C,this._events.emit({type:"frame",timestamp:Date.now(),frame:this._currentFrame,deltaTime:x});this._animationFrameId=requestAnimationFrame(()=>this._tick())}}export{O as ParamStore,S as ObjectRegistry,U as Experience,H as EventEmitter};
+
+//# debugId=730310C6746E3D6664756E2164756E21