@sebastianwessel/isostate 0.1.0

package/dist/animation/animation-engine.d.ts

@@ -0,0 +1,78 @@
+import type { AmbientAnimation, PrimitiveContent, RuntimeConnectorState, RuntimeConnectorStyle, RuntimeElementState, TextContent } from "../types/node.ts";
+import type { RuntimeBundle } from "../types/runtime-bundle.ts";
+export type LifecycleKey = "entering" | "present" | "exiting" | "removed";
+/** Interpolation result for a frame update. */
+export interface FrameUpdate {
+    id: string;
+    asset: string;
+    lifecycle: LifecycleKey;
+    ambient: AmbientAnimation[];
+    pos: [number, number];
+    size: number;
+    layer: string;
+    entry?: string;
+    exit?: string;
+    text?: TextContent;
+    primitive?: PrimitiveContent;
+}
+/** Interpolation result for a connector frame update. */
+export interface ConnectorFrameUpdate {
+    id: string;
+    route: [number, number][];
+    layer: string;
+    lifecycle: LifecycleKey;
+    style: RuntimeConnectorStyle;
+    start: RuntimeConnectorState["start"];
+    end: RuntimeConnectorState["end"];
+    direction: RuntimeConnectorState["direction"];
+    ambient: AmbientAnimation[];
+    entry?: string;
+    exit?: string;
+}
+/**
+ * Animation engine — resolves progress against compiled RuntimeBundle scene stops.
+ *
+ * The engine does not manipulate DOM. It computes interpolation data and lifecycle
+ * transitions that the controller applies to the rendering engine.
+ */
+export declare class AnimationEngine {
+    private _bundle;
+    private _progress;
+    private _paused;
+    private _prevFrameMap;
+    private _elementFrameMap;
+    private _prevConnectorFrameMap;
+    private _connectorFrameMap;
+    get bundle(): RuntimeBundle | null;
+    get progress(): number;
+    getProgress(): number;
+    get paused(): boolean;
+    isPaused(): boolean;
+    get elementsCount(): number;
+    get connectorsCount(): number;
+    /** Initialize with a compiled runtime bundle. */
+    init(bundle: RuntimeBundle): void;
+    /** Set current scroll progress (0-1) and compute frame update. */
+    setProgress(progress: number): void;
+    /** Get interpolated FrameUpdate for an element id or runtime element. */
+    getElementUpdate(element: string | Pick<RuntimeElementState, "id">): FrameUpdate;
+    getFrameUpdates(): FrameUpdate[];
+    /** Get interpolated ConnectorFrameUpdate for a connector id or runtime connector. */
+    getConnectorUpdate(connector: string | Pick<RuntimeConnectorState, "id">): ConnectorFrameUpdate;
+    getConnectorFrameUpdates(): ConnectorFrameUpdate[];
+    /** Compute lifecycle transition between previous and current frame. */
+    getLifecycleTransition(elId: string): {
+        from: LifecycleKey;
+        to: LifecycleKey;
+    } | null;
+    /** Compute lifecycle transition between previous and current connector frame. */
+    getConnectorLifecycleTransition(connectorId: string): {
+        from: LifecycleKey;
+        to: LifecycleKey;
+    } | null;
+    getCurrentState(): RuntimeBundle["scenes"][number] | null;
+    pause(): void;
+    resume(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=animation-engine.d.ts.map

package/dist/animation/animation-engine.d.ts.map

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

package/dist/animation/controller.d.ts

@@ -0,0 +1,130 @@
+import type { RuntimeBundle } from "../types/runtime-bundle.ts";
+import { AnimationEngine } from "./animation-engine.ts";
+export interface ControllerEvents {
+    "progress-change": (progress: number) => void;
+    "scene-change": (index: number) => void;
+    paused: () => void;
+    resumed: () => void;
+}
+type EventKey = keyof ControllerEvents;
+export interface ControllerConfig {
+    /** Scroll container used to derive progress. Defaults to the mount target in `mountScene()`. */
+    container?: HTMLElement;
+    /** SVG scene updated by this controller. Defaults to the first SVG in `container` for direct controller usage. */
+    sceneElement?: SVGSVGElement;
+    scrollDirection?: "vertical" | "horizontal";
+    scrollOffset?: {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    minProgress?: number;
+    maxProgress?: number;
+    keyboardControls?: boolean;
+    touchControls?: boolean;
+    scrollSensitivity?: number;
+    transitionDuration?: number;
+    transitionEasing?: "linear" | "ease-in-out" | "ease-out";
+}
+interface ControllerRuntime {
+    engine?: AnimationEngine;
+    sceneElement?: SVGSVGElement;
+}
+/**
+ * Animation controller — manages scroll progress, scene navigation,
+ * and delegates to the animation engine for frame updates.
+ */
+export declare class AnimationController {
+    private _engine;
+    private _bundle;
+    private _sceneIndex;
+    private _progress;
+    private _paused;
+    private _config;
+    private _container;
+    private _sceneElement;
+    private _ownsEngine;
+    private _rafId;
+    private _pendingProgress;
+    private _destroyed;
+    private _listeners;
+    private _minScroll;
+    private _maxScroll;
+    private _touchStartY;
+    private _touchStartX;
+    private _isDragging;
+    private _transitionAnim;
+    get engine(): AnimationEngine;
+    get progress(): number;
+    getProgress(): number;
+    get sceneIndex(): number;
+    getSceneIndex(): number;
+    get scenes(): RuntimeBundle["scenes"];
+    get paused(): boolean;
+    get currentScene(): RuntimeBundle["scenes"][number] | undefined;
+    /**
+     * Initialize the controller with a compiled bundle and optional runtime resources.
+     */
+    init(bundle: RuntimeBundle, config?: ControllerConfig, runtime?: ControllerRuntime): void;
+    /**
+     * Set scroll progress (0–1, clamped) and trigger frame update.
+     */
+    setProgress(progress: number): void;
+    /**
+     * Navigate to next scene (wraps to 0 if at end).
+     */
+    nextScene(): void;
+    /**
+     * Navigate to previous scene (wraps to last if at beginning).
+     */
+    prevScene(): void;
+    /**
+     * Set scene index directly.
+     */
+    setSceneIndex(index: number): void;
+    /**
+     * Pause all animations.
+     */
+    pause(): void;
+    /**
+     * Resume from paused state.
+     */
+    resume(): void;
+    /**
+     * Check if controller is paused.
+     */
+    isPaused(): boolean;
+    /**
+     * Destroy controller and clean up all listeners and resources.
+     */
+    destroy(): void;
+    on<K extends EventKey>(event: K, listener: ControllerEvents[K]): void;
+    off<K extends EventKey>(event: K, listener: ControllerEvents[K]): void;
+    private _emit;
+    private _scheduleProgressForward;
+    private _cancelFrame;
+    private _applyFrameUpdate;
+    private _applyLifecycleChanges;
+    private _applyConnectorLifecycleChanges;
+    private _applyEntryAnimation;
+    private _applyExitAnimation;
+    private _applyConnectorEntryAnimation;
+    private _applyConnectorExitAnimation;
+    private _transitionToScene;
+    private _animateProgress;
+    private _cancelTransition;
+    private _bindScroll;
+    private _unbindScroll;
+    private _calculateScrollBounds;
+    private _onScroll;
+    private _onResize;
+    private _onKeyDown;
+    private _onTouchStart;
+    private _onTouchMove;
+    private _onTouchEnd;
+    private _applyPauseState;
+    private _assertNotDestroyed;
+}
+export {};
+//# sourceMappingURL=controller.d.ts.map

package/dist/animation/controller.d.ts.map

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