@codellyson/framely 0.1.0

package/dist/hooks/useDelayRender.d.ts

@@ -0,0 +1,52 @@
+import { DelayRenderOptions } from '../delayRender';
+/**
+ * Return type for the useDelayRender hook.
+ */
+export interface UseDelayRenderReturn {
+    /** Call this to signal that the async operation has completed. */
+    continueRender: () => void;
+    /** Whether the hook is still waiting (continueRender has not been called yet). */
+    isWaiting: boolean;
+}
+/**
+ * Hook for managing delay render in React components.
+ *
+ * Automatically handles cleanup on unmount and provides a cleaner API
+ * than using delayRender/continueRender directly.
+ *
+ * @param {string} [label] - Label for debugging timeout errors
+ * @param {object} [options]
+ * @param {number} [options.timeoutInMilliseconds=30000] - Timeout before throwing
+ * @param {number} [options.retries=0] - Number of retries on timeout
+ * @returns {{ continueRender: () => void, isWaiting: boolean }}
+ *
+ * Usage:
+ *   function MyComponent() {
+ *     const [data, setData] = useState(null);
+ *     const { continueRender } = useDelayRender('Loading data');
+ *
+ *     useEffect(() => {
+ *       fetchData().then(d => {
+ *         setData(d);
+ *         continueRender();
+ *       });
+ *     }, [continueRender]);
+ *
+ *     return data ? <div>{data}</div> : null;
+ *   }
+ */
+export declare function useDelayRender(label?: string | DelayRenderOptions, options?: DelayRenderOptions): UseDelayRenderReturn;
+/**
+ * Hook that delays render while a condition is true.
+ *
+ * @param {boolean} condition - If true, delays render
+ * @param {string} [label] - Label for debugging
+ * @param {object} [options] - Same options as useDelayRender
+ *
+ * Usage:
+ *   const [isLoading, setIsLoading] = useState(true);
+ *   useDelayRenderWhile(isLoading, 'Waiting for data');
+ */
+export declare function useDelayRenderWhile(condition: boolean, label?: string, options?: DelayRenderOptions): void;
+export default useDelayRender;
+//# sourceMappingURL=useDelayRender.d.ts.map

package/dist/hooks/useDelayRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDelayRender.d.ts","sourceRoot":"","sources":["../../src/hooks/useDelayRender.ts"],"names":[],"mappings":"AACA,OAAO,EAA+B,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,kFAAkF;IAClF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,EACnC,OAAO,GAAE,kBAAuB,GAC/B,oBAAoB,CAiCtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,OAAO,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAqBN;AAED,eAAe,cAAc,CAAC"}

package/dist/hooks/useDelayRender.js

@@ -0,0 +1,92 @@
+import { useEffect, useRef, useCallback } from 'react';
+import { delayRender, continueRender } from '../delayRender';
+/**
+ * Hook for managing delay render in React components.
+ *
+ * Automatically handles cleanup on unmount and provides a cleaner API
+ * than using delayRender/continueRender directly.
+ *
+ * @param {string} [label] - Label for debugging timeout errors
+ * @param {object} [options]
+ * @param {number} [options.timeoutInMilliseconds=30000] - Timeout before throwing
+ * @param {number} [options.retries=0] - Number of retries on timeout
+ * @returns {{ continueRender: () => void, isWaiting: boolean }}
+ *
+ * Usage:
+ *   function MyComponent() {
+ *     const [data, setData] = useState(null);
+ *     const { continueRender } = useDelayRender('Loading data');
+ *
+ *     useEffect(() => {
+ *       fetchData().then(d => {
+ *         setData(d);
+ *         continueRender();
+ *       });
+ *     }, [continueRender]);
+ *
+ *     return data ? <div>{data}</div> : null;
+ *   }
+ */
+export function useDelayRender(label, options = {}) {
+    const handleRef = useRef(null);
+    const continuedRef = useRef(false);
+    // Create the handle on mount
+    useEffect(() => {
+        const actualLabel = typeof label === 'string' ? label : 'useDelayRender';
+        const actualOptions = typeof label === 'object' ? label : options;
+        handleRef.current = delayRender(actualLabel, actualOptions);
+        continuedRef.current = false;
+        // Cleanup on unmount - continue if not already done
+        return () => {
+            if (handleRef.current !== null && !continuedRef.current) {
+                continueRender(handleRef.current);
+                continuedRef.current = true;
+            }
+        };
+    }, []); // Only run on mount/unmount
+    // Stable callback to continue rendering
+    const continueRenderCallback = useCallback(() => {
+        if (handleRef.current !== null && !continuedRef.current) {
+            continueRender(handleRef.current);
+            continuedRef.current = true;
+        }
+    }, []);
+    return {
+        continueRender: continueRenderCallback,
+        isWaiting: !continuedRef.current,
+    };
+}
+/**
+ * Hook that delays render while a condition is true.
+ *
+ * @param {boolean} condition - If true, delays render
+ * @param {string} [label] - Label for debugging
+ * @param {object} [options] - Same options as useDelayRender
+ *
+ * Usage:
+ *   const [isLoading, setIsLoading] = useState(true);
+ *   useDelayRenderWhile(isLoading, 'Waiting for data');
+ */
+export function useDelayRenderWhile(condition, label, options = {}) {
+    const handleRef = useRef(null);
+    useEffect(() => {
+        if (condition && handleRef.current === null) {
+            // Start delaying
+            handleRef.current = delayRender(label || 'useDelayRenderWhile', options);
+        }
+        else if (!condition && handleRef.current !== null) {
+            // Stop delaying
+            continueRender(handleRef.current);
+            handleRef.current = null;
+        }
+        // Cleanup
+        return () => {
+            if (handleRef.current !== null) {
+                continueRender(handleRef.current);
+                handleRef.current = null;
+            }
+        };
+    }, [condition, label]);
+}
+export default useDelayRender;
+//# sourceMappingURL=useDelayRender.js.map

package/dist/hooks/useDelayRender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDelayRender.js","sourceRoot":"","sources":["../../src/hooks/useDelayRender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAsB,MAAM,gBAAgB,CAAC;AAYjF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAmC,EACnC,UAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,MAAM,CAAU,KAAK,CAAC,CAAC;IAE5C,6BAA6B;IAC7B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAW,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC;QACjF,MAAM,aAAa,GAAuB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;QAEtF,SAAS,CAAC,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAC5D,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;QAE7B,oDAAoD;QACpD,OAAO,GAAG,EAAE;YACV,IAAI,SAAS,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBACxD,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAClC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,4BAA4B;IAEpC,wCAAwC;IACxC,MAAM,sBAAsB,GAAG,WAAW,CAAC,GAAS,EAAE;QACpD,IAAI,SAAS,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YACxD,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAClC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,cAAc,EAAE,sBAAsB;QACtC,SAAS,EAAE,CAAC,YAAY,CAAC,OAAO;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAkB,EAClB,KAAc,EACd,UAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAE9C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,IAAI,SAAS,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC5C,iBAAiB;YACjB,SAAS,CAAC,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,qBAAqB,EAAE,OAAO,CAAC,CAAC;QAC3E,CAAC;aAAM,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,gBAAgB;YAChB,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAClC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,UAAU;QACV,OAAO,GAAG,EAAE;YACV,IAAI,SAAS,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC/B,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAClC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;AACzB,CAAC;AAED,eAAe,cAAc,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Video configuration returned by `useVideoConfig`.
+ */
+export interface VideoConfig {
+    fps: number;
+    width: number;
+    height: number;
+    durationInFrames: number;
+}
+/**
+ * Returns the current frame number.
+ * This is the primary hook your compositions will use.
+ */
+export declare function useCurrentFrame(): number;
+/**
+ * Returns the video configuration (fps, dimensions, duration).
+ */
+export declare function useVideoConfig(): VideoConfig;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAG5C"}

package/dist/hooks.js

@@ -0,0 +1,17 @@
+import { useTimeline } from './context';
+/**
+ * Returns the current frame number.
+ * This is the primary hook your compositions will use.
+ */
+export function useCurrentFrame() {
+    const { frame } = useTimeline();
+    return frame;
+}
+/**
+ * Returns the video configuration (fps, dimensions, duration).
+ */
+export function useVideoConfig() {
+    const { fps, width, height, durationInFrames } = useTimeline();
+    return { fps, width, height, durationInFrames };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAYxC;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,CAAC;IAChC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE,CAAC;IAC/D,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Framely Library
+ *
+ * Main barrel export for the Framely animation framework.
+ */
+export { TimelineProvider, useTimeline } from './context';
+export { default as TimelineContext } from './context';
+export type { TimelineContextValue, TimelineProviderProps } from './context';
+export { useCurrentFrame, useVideoConfig } from './hooks';
+export type { VideoConfig } from './hooks';
+export { useDelayRender, useDelayRenderWhile } from './hooks/useDelayRender';
+export type { UseDelayRenderReturn } from './hooks/useDelayRender';
+export { interpolate, spring } from './interpolate';
+export type { ExtrapolationType, InterpolateOptions, SpringOptions } from './interpolate';
+export { Easing } from './Easing';
+export type { EasingFunction } from './Easing';
+export { interpolateColors } from './interpolateColors';
+export type { RGBAColor, OKLCHColor, InterpolateColorsOptions } from './interpolateColors';
+export { measureSpring, springPresets, springNaturalFrequency, springDampingRatio } from './measureSpring';
+export type { SpringPreset, MeasureSpringOptions } from './measureSpring';
+export { delayRender, continueRender, cancelRender, isDelayRenderPending, getPendingDelayRenders, clearAllDelayRenders, } from './delayRender';
+export type { DelayRenderOptions, DelayRenderHandle, PendingDelayRender } from './delayRender';
+export { staticFile, isStaticFile, getFileExtension, getMimeType } from './staticFile';
+export { preloadImage, preloadVideo, preloadAudio, preloadFont, prefetch, preloadAll, resolveWhenLoaded, } from './preload';
+export { Sequence } from './Sequence';
+export type { SequenceProps } from './Sequence';
+export { Series } from './Series';
+export type { SeriesSequenceProps, SeriesProps } from './Series';
+export { Loop, useLoop } from './Loop';
+export type { LoopContextValue, LoopProps } from './Loop';
+export { Freeze } from './Freeze';
+export type { FreezeProps } from './Freeze';
+export { Folder, useFolder } from './Folder';
+export { AbsoluteFill } from './AbsoluteFill';
+export type { AbsoluteFillProps } from './AbsoluteFill';
+export { Composition, defineComposition, resolveComponent, resolveMetadata, validateProps, getDefaultProps, createCompositionWrapper, } from './Composition';
+export type { Codec, CompositionSchema, CalculateMetadataInput, CalculateMetadataOutput, CalculateMetadataFunction, CompositionProps, CompositionConfig, ResolvedMetadata, ValidationResult, } from './Composition';
+export { registerRoot, registerRootAsync, getRoot, getCompositions, getComposition, getCompositionTree, isRootRegistered, onRootRegistered, clearRegistry, } from './registerRoot';
+export type { CompositionConfig as RegisteredCompositionConfig, Registry, CompositionTree, } from './registerRoot';
+export { getInputProps, setInputProps, mergeInputProps, getInputProp, hasInputProps, getInputPropsSource, clearInputProps, parsePropsInput, serializeProps, createUrlWithProps, } from './getInputProps';
+export type { InputProps, InputPropsSource } from './getInputProps';
+export { Config, getConfig, getConfigValue, resetConfig, loadConfig, getFfmpegArgs, getOutputExtension, validateConfig, } from './config';
+export type { Codec as ConfigCodec, LogLevel, ImageFormat, PixelFormat, HardwareAcceleration, AudioCodec, FramelyConfig, ValidationResult as ConfigValidationResult, ConfigSetter, } from './config';
+export { Img } from './Img';
+export type { ImgProps } from './Img';
+export { Video } from './Video';
+export type { VolumeCallback as VideoVolumeCallback, VideoProps } from './Video';
+export { Audio, getAudioMetadata, getAudioDurationInFrames } from './Audio';
+export type { VolumeCallback as AudioVolumeCallback, AudioProps, AudioMetadata } from './Audio';
+export { IFrame } from './IFrame';
+export type { IFrameProps } from './IFrame';
+export { TransitionSeries, useTransition, createPresentation, createTiming, fade, crossfade, slide, slideFromLeft, slideFromRight, slideFromTop, slideFromBottom, push, wipe, wipeLeft, wipeRight, wipeTop, wipeBottom, iris, diagonalWipe, zoom, zoomInOut, zoomOutIn, kenBurns, zoomRotate, flip, flipHorizontal, flipVertical, cardFlip, cube, door, presets as transitionPresets, } from './transitions';
+export type { SlideDirection, SlideOptions, TransitionStyle, TransitionResult, FadeStyle, FadeOptions, FadeTransitionStyle, FadeTransitionResult, TransitionPresentation, } from './transitions';
+export { useSpring, useSpringSequence } from './useSpring';
+export type { UseSpringOptions, UseSpringSequenceOptions } from './useSpring';
+export { Text, splitText, getWords } from './Text';
+export type { CharSpanProps, CharData, StrokeConfig, ShadowConfig, WordData, TextProps, } from './Text';
+export { Svg, Circle, Rect, Ellipse, Line, Path, Polygon, usePathLength } from './shapes';
+export type { SvgProps, CircleProps, RectProps, EllipseProps, LineProps, PathProps, PolygonProps, } from './shapes';
+export { useAudioData, getFrequencyBands } from './useAudioData';
+export type { AudioDataOptions, AudioDataResult, FrequencyBandRanges, FrequencyBandValues, } from './useAudioData';
+export { random, randomRange, randomInt, noise2D, noise3D, fbm2D } from './noise';
+export { makeTransform, transform, interpolateTransform } from './makeTransform';
+export { ErrorBoundary } from './ErrorBoundary';
+export type { ErrorBoundaryProps, ErrorBoundaryState } from './ErrorBoundary';
+export { Player, Thumbnail } from './Player';
+export type { PlayerTimelineContextValue, PlayerProps, ThumbnailProps } from './Player';
+export { templatesApi } from './templates/api';
+export { CATEGORY_LABELS } from './templates/types';
+export type { Template, TemplateCategory, TemplateAuthor, TemplatePreview, TemplatesListResponse, TemplatesFilterParams, CategoryCount, } from './templates/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,65 @@
+/**
+ * Framely Library
+ *
+ * Main barrel export for the Framely animation framework.
+ */
+// Core context & provider
+export { TimelineProvider, useTimeline } from './context';
+export { default as TimelineContext } from './context';
+// Hooks
+export { useCurrentFrame, useVideoConfig } from './hooks';
+export { useDelayRender, useDelayRenderWhile } from './hooks/useDelayRender';
+// Animation utilities
+export { interpolate, spring } from './interpolate';
+export { Easing } from './Easing';
+export { interpolateColors } from './interpolateColors';
+export { measureSpring, springPresets, springNaturalFrequency, springDampingRatio } from './measureSpring';
+// Delay render system
+export { delayRender, continueRender, cancelRender, isDelayRenderPending, getPendingDelayRenders, clearAllDelayRenders, } from './delayRender';
+// Asset utilities
+export { staticFile, isStaticFile, getFileExtension, getMimeType } from './staticFile';
+export { preloadImage, preloadVideo, preloadAudio, preloadFont, prefetch, preloadAll, resolveWhenLoaded, } from './preload';
+// Layout components
+export { Sequence } from './Sequence';
+export { Series } from './Series';
+export { Loop, useLoop } from './Loop';
+export { Freeze } from './Freeze';
+export { Folder, useFolder } from './Folder';
+export { AbsoluteFill } from './AbsoluteFill';
+// Composition system
+export { Composition, defineComposition, resolveComponent, resolveMetadata, validateProps, getDefaultProps, createCompositionWrapper, } from './Composition';
+// Registry & root
+export { registerRoot, registerRootAsync, getRoot, getCompositions, getComposition, getCompositionTree, isRootRegistered, onRootRegistered, clearRegistry, } from './registerRoot';
+// Input props
+export { getInputProps, setInputProps, mergeInputProps, getInputProp, hasInputProps, getInputPropsSource, clearInputProps, parsePropsInput, serializeProps, createUrlWithProps, } from './getInputProps';
+// Configuration
+export { Config, getConfig, getConfigValue, resetConfig, loadConfig, getFfmpegArgs, getOutputExtension, validateConfig, } from './config';
+// Media components
+export { Img } from './Img';
+export { Video } from './Video';
+export { Audio, getAudioMetadata, getAudioDurationInFrames } from './Audio';
+export { IFrame } from './IFrame';
+// Transitions
+export { TransitionSeries, useTransition, createPresentation, createTiming, 
+// Presets
+fade, crossfade, slide, slideFromLeft, slideFromRight, slideFromTop, slideFromBottom, push, wipe, wipeLeft, wipeRight, wipeTop, wipeBottom, iris, diagonalWipe, zoom, zoomInOut, zoomOutIn, kenBurns, zoomRotate, flip, flipHorizontal, flipVertical, cardFlip, cube, door, presets as transitionPresets, } from './transitions';
+// Spring hooks
+export { useSpring, useSpringSequence } from './useSpring';
+// Text component
+export { Text, splitText, getWords } from './Text';
+// Shape components
+export { Svg, Circle, Rect, Ellipse, Line, Path, Polygon, usePathLength } from './shapes';
+// Audio visualization
+export { useAudioData, getFrequencyBands } from './useAudioData';
+// Noise & random utilities
+export { random, randomRange, randomInt, noise2D, noise3D, fbm2D } from './noise';
+// Transform utilities
+export { makeTransform, transform, interpolateTransform } from './makeTransform';
+// Error boundary
+export { ErrorBoundary } from './ErrorBoundary';
+// Player
+export { Player, Thumbnail } from './Player';
+// Templates marketplace
+export { templatesApi } from './templates/api';
+export { CATEGORY_LABELS } from './templates/types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0BAA0B;AAC1B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,WAAW,CAAC;AAGvD,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7E,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG3G,sBAAsB;AACtB,OAAO,EACL,WAAW,EACX,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAGvB,kBAAkB;AAClB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,UAAU,EACV,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,oBAAoB;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,qBAAqB;AACrB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,eAAe,EACf,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAavB,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,OAAO,EACP,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAOxB,cAAc;AACd,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,gBAAgB;AAChB,OAAO,EACL,MAAM,EACN,SAAS,EACT,cAAc,EACd,WAAW,EACX,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,MAAM,UAAU,CAAC;AAalB,mBAAmB;AACnB,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAE5E,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,cAAc;AACd,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,YAAY;AACZ,UAAU;AACV,IAAI,EACJ,SAAS,EACT,KAAK,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,SAAS,EACT,QAAQ,EACR,UAAU,EACV,IAAI,EACJ,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,OAAO,IAAI,iBAAiB,GAC7B,MAAM,eAAe,CAAC;AAavB,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG3D,iBAAiB;AACjB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAUnD,mBAAmB;AACnB,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAW1F,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAQjE,2BAA2B;AAC3B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAElF,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG7C,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/interpolate.d.ts

@@ -0,0 +1,80 @@
+import { Easing, type EasingFunction } from './Easing';
+export { Easing };
+export type ExtrapolationType = 'extend' | 'clamp' | 'wrap' | 'identity';
+export interface InterpolateOptions {
+    easing?: EasingFunction;
+    extrapolateLeft?: ExtrapolationType;
+    extrapolateRight?: ExtrapolationType;
+}
+export interface SpringOptions {
+    from?: number;
+    to?: number;
+    fps?: number;
+    delay?: number;
+    mass?: number;
+    stiffness?: number;
+    damping?: number;
+    overshootClamping?: boolean;
+}
+/**
+ * Maps a value from one range to another, with optional easing and extrapolation.
+ */
+export declare function interpolate(value: number, inputRange: readonly number[], outputRange: readonly number[], options?: InterpolateOptions): number;
+/**
+ * Spring-based interpolation with physics-based easing.
+ */
+export declare function spring(frame: number, options?: SpringOptions): number;
+declare const _default: {
+    interpolate: typeof interpolate;
+    spring: typeof spring;
+    Easing: {
+        linear: (t: number) => number;
+        ease: EasingFunction;
+        easeIn: (t: number) => number;
+        easeOut: (t: number) => number;
+        easeInOut: (t: number) => number;
+        cubic: (t: number) => number;
+        easeInCubic: (t: number) => number;
+        easeOutCubic: (t: number) => number;
+        easeInOutCubic: (t: number) => number;
+        easeInQuart: (t: number) => number;
+        easeOutQuart: (t: number) => number;
+        easeInOutQuart: (t: number) => number;
+        easeInQuint: (t: number) => number;
+        easeOutQuint: (t: number) => number;
+        easeInOutQuint: (t: number) => number;
+        easeInSine: (t: number) => number;
+        easeOutSine: (t: number) => number;
+        easeInOutSine: (t: number) => number;
+        exp: (t: number) => number;
+        easeInExpo: (t: number) => number;
+        easeOutExpo: (t: number) => number;
+        easeInOutExpo: (t: number) => number;
+        circle: (t: number) => number;
+        easeInCirc: (t: number) => number;
+        easeOutCirc: (t: number) => number;
+        easeInOutCirc: (t: number) => number;
+        easeInBack: (t: number) => number;
+        easeOutBack: (t: number) => number;
+        easeInOutBack: (t: number) => number;
+        easeInElastic: (t: number) => number;
+        easeOutElastic: (t: number) => number;
+        easeInOutElastic: (t: number) => number;
+        bounce: (t: number) => number;
+        easeInBounce: (t: number) => number;
+        easeOutBounce: (t: number) => number;
+        easeInOutBounce: (t: number) => number;
+        spring: (t: number) => number;
+        step0: (t: number) => number;
+        step1: (t: number) => number;
+        poly: (n?: number) => EasingFunction;
+        back: (overshoot?: number) => EasingFunction;
+        elastic: (bounciness?: number) => EasingFunction;
+        bezier: (x1: number, y1: number, x2: number, y2: number) => EasingFunction;
+        in: (easing: EasingFunction) => EasingFunction;
+        out: (easing: EasingFunction) => EasingFunction;
+        inOut: (easing: EasingFunction) => EasingFunction;
+    };
+};
+export default _default;
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../src/interpolate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAgFR;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAyCzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,wBAA+C"}

package/dist/interpolate.js

@@ -0,0 +1,108 @@
+import { Easing } from './Easing';
+export { Easing };
+/**
+ * Maps a value from one range to another, with optional easing and extrapolation.
+ */
+export function interpolate(value, inputRange, outputRange, options = {}) {
+    const { easing = Easing.linear, extrapolateLeft = 'clamp', extrapolateRight = 'clamp', } = options;
+    if (inputRange.length !== outputRange.length) {
+        throw new Error('inputRange and outputRange must have the same length');
+    }
+    if (inputRange.length < 2) {
+        throw new Error('inputRange must have at least 2 elements');
+    }
+    // Validate ranges are ascending
+    for (let i = 1; i < inputRange.length; i++) {
+        if (inputRange[i] < inputRange[i - 1]) {
+            throw new Error('inputRange must be monotonically increasing');
+        }
+    }
+    // Find which segment we're in
+    let segIndex = 0;
+    for (let i = 1; i < inputRange.length; i++) {
+        if (value >= inputRange[i - 1]) {
+            segIndex = i - 1;
+        }
+    }
+    const inputMin = inputRange[segIndex];
+    const inputMax = inputRange[segIndex + 1] ?? inputRange[segIndex];
+    const outputMin = outputRange[segIndex];
+    const outputMax = outputRange[segIndex + 1] ?? outputRange[segIndex];
+    // Calculate progress within this segment (0 to 1)
+    let progress;
+    if (inputMax === inputMin) {
+        progress = 0;
+    }
+    else {
+        progress = (value - inputMin) / (inputMax - inputMin);
+    }
+    // Handle extrapolation
+    const handleExtrapolation = (p, direction) => {
+        const extrapolate = direction === 'left' ? extrapolateLeft : extrapolateRight;
+        switch (extrapolate) {
+            case 'clamp':
+                return Math.max(0, Math.min(1, p));
+            case 'extend':
+                return p;
+            case 'wrap': {
+                const wrapped = p % 1;
+                return wrapped < 0 ? wrapped + 1 : wrapped;
+            }
+            case 'identity':
+                return null;
+            default:
+                return p;
+        }
+    };
+    // Check if we're outside the range
+    if (progress < 0) {
+        if (extrapolateLeft === 'identity') {
+            return value;
+        }
+        progress = handleExtrapolation(progress, 'left') ?? progress;
+    }
+    else if (progress > 1) {
+        if (extrapolateRight === 'identity') {
+            return value;
+        }
+        progress = handleExtrapolation(progress, 'right') ?? progress;
+    }
+    // Apply easing only to the 0-1 range
+    const easedProgress = progress < 0 || progress > 1 ? progress : easing(progress);
+    return outputMin + easedProgress * (outputMax - outputMin);
+}
+/**
+ * Spring-based interpolation with physics-based easing.
+ */
+export function spring(frame, options = {}) {
+    const { from = 0, to = 1, fps = 30, delay = 0, mass = 1, stiffness = 100, damping = 10, overshootClamping = false, } = options;
+    const f = frame - delay;
+    if (f < 0)
+        return from;
+    const omega0 = Math.sqrt(stiffness / mass);
+    const zeta = damping / (2 * Math.sqrt(stiffness * mass));
+    const t = f / fps;
+    let progress;
+    if (zeta < 1) {
+        // Underdamped (oscillates)
+        const omegaD = omega0 * Math.sqrt(1 - zeta * zeta);
+        progress = 1 - Math.exp(-zeta * omega0 * t) *
+            (Math.cos(omegaD * t) + (zeta * omega0 / omegaD) * Math.sin(omegaD * t));
+    }
+    else if (zeta === 1) {
+        // Critically damped
+        progress = 1 - Math.exp(-omega0 * t) * (1 + omega0 * t);
+    }
+    else {
+        // Overdamped
+        const s1 = -omega0 * (zeta - Math.sqrt(zeta * zeta - 1));
+        const s2 = -omega0 * (zeta + Math.sqrt(zeta * zeta - 1));
+        progress = 1 - (s2 * Math.exp(s1 * t) - s1 * Math.exp(s2 * t)) / (s2 - s1);
+    }
+    if (overshootClamping) {
+        progress = Math.max(0, Math.min(1, progress));
+    }
+    return from + (to - from) * progress;
+}
+export default { interpolate, spring, Easing };
+//# sourceMappingURL=interpolate.js.map

package/dist/interpolate.js.map

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

package/dist/interpolateColors.d.ts

@@ -0,0 +1,50 @@
+import { EasingFunction } from './Easing';
+/**
+ * RGBA color with channels 0-255 for RGB and 0-1 for alpha.
+ */
+export interface RGBAColor {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/**
+ * Color in the OKLCH perceptual color space.
+ */
+export interface OKLCHColor {
+    L: number;
+    C: number;
+    H: number;
+}
+/**
+ * Options for interpolateColors.
+ */
+export interface InterpolateColorsOptions {
+    easing?: EasingFunction;
+    extrapolateLeft?: 'extend' | 'clamp';
+    extrapolateRight?: 'extend' | 'clamp';
+    colorSpace?: 'rgb' | 'oklch';
+}
+/**
+ * Interpolate between colors across a range.
+ *
+ * Works like interpolate() but for colors. Supports any CSS color format.
+ *
+ * Usage:
+ *   interpolateColors(frame, [0, 30], ['#ff0000', '#0000ff'])
+ *   interpolateColors(frame, [0, 30], ['red', 'blue'], { easing: Easing.easeOut })
+ *   interpolateColors(frame, [0, 30, 60], ['red', 'yellow', 'green']) // multi-color
+ *
+ * @param {number} value - The input value (usually the current frame)
+ * @param {number[]} inputRange - Array of ascending input breakpoints
+ * @param {string[]} outputRange - Corresponding color values
+ * @param {object} [options]
+ * @param {function} [options.easing=Easing.linear] - Easing function
+ * @param {'extend'|'clamp'} [options.extrapolateLeft='clamp']
+ * @param {'extend'|'clamp'} [options.extrapolateRight='clamp']
+ * @param {'rgb'|'oklch'} [options.colorSpace='rgb'] - Interpolation color space
+ * @returns {string} Interpolated CSS color string
+ */
+export declare function interpolateColors(value: number, inputRange: number[], outputRange: string[], options?: InterpolateColorsOptions): string;
+export default interpolateColors;
+//# sourceMappingURL=interpolateColors.d.ts.map

package/dist/interpolateColors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolateColors.d.ts","sourceRoot":"","sources":["../src/interpolateColors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,cAAc,EAAE,MAAM,UAAU,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,eAAe,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACrC,gBAAgB,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACtC,UAAU,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC9B;AAiOD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAsFR;AAED,eAAe,iBAAiB,CAAC"}