cineview 0.0.1-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alien.mu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+# Cineview
+
+[简体中文](./README.zh-CN.md)
+
+[![npm](https://img.shields.io/npm/v/cineview/beta?style=flat-square&color=8A5B43)](https://www.npmjs.com/package/cineview)
+[![Tests](https://github.com/AlienMu/cineview/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/AlienMu/cineview/actions/workflows/ci.yml)
+[![Framework line coverage](https://img.shields.io/endpoint?url=https%3A%2F%2Fcineview.pages.dev%2Fcoverage.json&style=flat-square)](https://cineview.pages.dev/coverage.json)
+[![React 19](https://img.shields.io/badge/React-19-287EA3?style=flat-square)](https://react.dev/)
+[![MIT](https://img.shields.io/badge/license-MIT-555?style=flat-square)](./LICENSE)
+
+Cineview is a React framework for pages controlled by dragging and scrolling. Define animation durations and dependencies, then let gestures or scroll position advance that timeline.
+
+Each `Scene` owns its content and element time. `Animate` describes effects such as fading and movement; `after` starts an element when its predecessor finishes entering, then adds the follower’s delay. Ordinary entrances that play over time can coexist with these interactions.
+
+[Quick start and interactive examples](https://cineview.pages.dev/docs/03-quickstart) · [Documentation](https://cineview.pages.dev/docs) · [Website](https://cineview.pages.dev)
+
+## Install the beta
+
+These examples target `cineview@0.0.1-beta` and its `Cineview` API. Install the exact beta version:
+
+```bash
+npm install cineview@0.0.1-beta react@19 react-dom@19 framer-motion@13
+```
+
+The npm `beta` channel tracks this API. The `latest` channel remains on `1.0.0`, which uses the earlier `CineView` API.
+
+## Run the local example
+
+To change the source and try it in the included example:
+
+```bash
+pnpm install --frozen-lockfile
+pnpm --dir examples/minimal install --frozen-lockfile
+pnpm build
+pnpm --dir examples/minimal dev
+```
+
+The current package requires React `^19.0.0`, React DOM `^19.0.0`, and Framer Motion `^13.0.0`. See the [Changelog](./CHANGELOG.md) for migration notes.
+
+## Build a drag page
+
+Use this as `App.tsx`. No media assets are required:
+
+```tsx
+import { Animate, Cineview, Scene } from 'cineview';
+
+export default function App() {
+  return (
+    <Cineview mode="drag" unit="percent" scale={1}>
+      <Scene sceneId="intro" style={{ background: '#f5e8d8', padding: 40 }}>
+        <h1>Drag up to the next scene</h1>
+      </Scene>
+      <Scene sceneId="details" style={{ background: '#e8edf0', padding: 40 }}>
+        <Animate animateId="title" enterAnimation="fade-in" duration={{ enter: 600 }}>
+          <h2>The title appears first</h2>
+        </Animate>
+        <Animate
+          enterAnimation="slide-up"
+          duration={{ enter: 400 }}
+          timeline={{ after: 'title', delay: 100 }}
+        >
+          <p>The detail follows the title.</p>
+        </Animate>
+      </Scene>
+    </Cineview>
+  );
+}
+```
+
+In the second scene, the title enters over 600ms. After another 100ms, the detail enters over 400ms, making a 1100ms timeline. Change the title to 900ms and the detail moves later automatically, without changing its delay.
+
+This example maps drag percentage to timeline percentage. Half a screen advances element time to 550ms. A committed release continues unfinished animations; cancellation restores them. Focus the Cineview container to navigate with arrow keys.
+
+## How input advances animation
+
+| Mode                 | Use                                                                                             | When input stops                                                             |
+| -------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
+| drag                 | Change scenes while previewing the target scene's animations                                    | Distance and release velocity decide whether to continue or restore          |
+| scroll               | Keep ordinary content in flow; add `scroll` to a Scene to advance its animations at `1ms = 1px` | Stopping within the zone holds the frame; reverse scrolling moves backward   |
+| Independent entrance | `timeline={{ driver: 'clock' }}`                                                                | Plays over time once its start conditions are met, even when scrolling stops |
+
+[Quick start](https://cineview.pages.dev/docs/03-quickstart) includes working examples and basic code for both modes. The [mode guide](https://cineview.pages.dev/docs/01-modes) explains page movement and element time.
+
+## Explore further
+
+- [Animation order](https://cineview.pages.dev/docs/04-orchestration): `after`, delays, composition, and staggered entrances.
+- [Video control](https://cineview.pages.dev/docs/11-video-timeline): use drag and scroll progress to seek video frames.
+- [Custom drawing](https://cineview.pages.dev/docs/09-use-animate-timeline): drive Canvas, SVG, or WebGL from MotionValues.
+- [Responsive layout](https://cineview.pages.dev/docs/05-responsive): use `designWidth`, Position, and Container.
+- [Preloading](https://cineview.pages.dev/docs/02-preload): prepare scene resources and handle first-screen waiting.
+
+Add `data-cineview-ignore-drag` to controls that need their own gestures. Keep navigation and persistent state that span scenes outside Cineview.
+
+## Verify and develop
+
+The test badge shows GitHub CI status. The coverage badge reports line coverage generated by a successful framework test run for the deployed website. It does not establish browser interaction coverage; drag and scroll have separate browser acceptance checks.
+
+See [Contributing](./CONTRIBUTING.md) and [Releases](./RELEASING.md) for the full environment, validation, and publishing commands. The [minimal example](./examples/minimal/README.md) switches between both modes.
+
+## License
+
+[MIT](./LICENSE) © Alien.mu.

package/README.zh-CN.md

@@ -0,0 +1,102 @@
+# Cineview
+
+[English](./README.md)
+
+[![npm](https://img.shields.io/npm/v/cineview/beta?style=flat-square&color=8A5B43)](https://www.npmjs.com/package/cineview)
+[![Tests](https://github.com/AlienMu/cineview/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/AlienMu/cineview/actions/workflows/ci.yml)
+[![Framework line coverage](https://img.shields.io/endpoint?url=https%3A%2F%2Fcineview.pages.dev%2Fcoverage.json&style=flat-square)](https://cineview.pages.dev/coverage.json)
+[![React 19](https://img.shields.io/badge/React-19-287EA3?style=flat-square)](https://react.dev/)
+[![MIT](https://img.shields.io/badge/license-MIT-555?style=flat-square)](./LICENSE)
+
+Cineview 是用于制作拖拽和滚动交互页面的 React 框架。为元素声明动画时长和先后顺序，再让手势或滚动位置推进这段时间线。
+
+每个 `Scene` 管理自己的内容和元素时间。`Animate` 描述淡入、位移等变化，`after` 等前序元素入场完成，再加上当前元素的延迟后开始。普通按时间播放的入场动画也可以与这些交互共存。
+
+[快速上手与交互案例](https://cineview.pages.dev/docs/03-quickstart) · [文档](https://cineview.pages.dev/docs) · [官网](https://cineview.pages.dev)
+
+## 安装 beta
+
+下方示例对应 `cineview@0.0.1-beta` 的 `Cineview` API。安装指定的 beta 版本：
+
+```bash
+npm install cineview@0.0.1-beta react@19 react-dom@19 framer-motion@13
+```
+
+npm 的 `beta` 标签对应这套 API。`latest` 标签保留在 `1.0.0`，该版本使用早期的 `CineView` API。
+
+## 运行本地示例
+
+修改源码并在附带的示例中验证：
+
+```bash
+pnpm install --frozen-lockfile
+pnpm --dir examples/minimal install --frozen-lockfile
+pnpm build
+pnpm --dir examples/minimal dev
+```
+
+当前包需要 React `^19.0.0`、React DOM `^19.0.0` 和 Framer Motion `^13.0.0`。迁移说明见 [Changelog](./CHANGELOG.md)。
+
+## 第一个拖拽页面
+
+将以下内容用作 `App.tsx`，不需要媒体素材：
+
+```tsx
+import { Animate, Cineview, Scene } from 'cineview';
+
+export default function App() {
+  return (
+    <Cineview mode="drag" unit="percent" scale={1}>
+      <Scene sceneId="intro" style={{ background: '#f5e8d8', padding: 40 }}>
+        <h1>向上拖动，查看下一个场景</h1>
+      </Scene>
+      <Scene sceneId="details" style={{ background: '#e8edf0', padding: 40 }}>
+        <Animate animateId="title" enterAnimation="fade-in" duration={{ enter: 600 }}>
+          <h2>标题先出现</h2>
+        </Animate>
+        <Animate
+          enterAnimation="slide-up"
+          duration={{ enter: 400 }}
+          timeline={{ after: 'title', delay: 100 }}
+        >
+          <p>说明在标题之后出现。</p>
+        </Animate>
+      </Scene>
+    </Cineview>
+  );
+}
+```
+
+第二个场景的标题用 600ms 入场，等待 100ms 后，说明用 400ms 入场，总时长为 1100ms。把标题时长改成 900ms，说明会自动后移，不必修改它的延迟。
+
+这个例子将拖拽比例映射到时间线比例。拖到一半，元素时间是 550ms。确认切换后，未完成的动画继续播放；取消时还原。聚焦 Cineview 容器后也可使用方向键导航。
+
+## 两种交互如何推进动画
+
+| 模式     | 使用方式                                                                  | 停止输入后的行为                               |
+| -------- | ------------------------------------------------------------------------- | ---------------------------------------------- |
+| drag     | 拖拽切换 Scene，同时预览目标场景的元素动画                                | 松手时根据位移与速度决定继续切换或还原         |
+| scroll   | 普通内容连续滚动；给 Scene 声明 `scroll`，让其动画按 `1ms = 1px` 跟随滚动 | 区间内停止滚动，动画停在当前帧；反向滚动会倒退 |
+| 独立入场 | `timeline={{ driver: 'clock' }}`                                          | 满足启动条件后按时间播放，不因停止滚动而暂停   |
+
+[快速上手](https://cineview.pages.dev/docs/03-quickstart)提供两种可操作案例和基础代码。[模式说明](https://cineview.pages.dev/docs/01-modes)解释场景移动与元素时间的关系。
+
+## 进一步使用
+
+- [动画顺序](https://cineview.pages.dev/docs/04-orchestration)：`after`、延迟、组合与子元素入场。
+- [视频控制](https://cineview.pages.dev/docs/11-video-timeline)：将拖拽和滚动进度用于视频帧。
+- [自定义绘制](https://cineview.pages.dev/docs/09-use-animate-timeline)：用 MotionValue 驱动 Canvas、SVG 或 WebGL。
+- [布局换算](https://cineview.pages.dev/docs/05-responsive)：使用 `designWidth`、Position 和 Container。
+- [资源预加载](https://cineview.pages.dev/docs/02-preload)：准备场景资源与处理首屏等待。
+
+为需要独立处理手势的控件添加 `data-cineview-ignore-drag`。跨场景的导航或持久状态放在 Cineview 外部。
+
+## 验证与开发
+
+测试徽章显示 GitHub CI 状态。覆盖率徽章读取网站发布时成功运行框架测试生成的行覆盖率，不代表所有浏览器交互都已覆盖；拖拽与滚动另有浏览器验收。
+
+完整开发环境、测试与发布命令见 [Contributing](./CONTRIBUTING.md) 和[发布说明](./RELEASING.md)。[最小示例](./examples/minimal/README.md)可在两种模式间切换。
+
+## 许可证
+
+[MIT](./LICENSE) © Alien.mu.

package/dist/animations/animationParser.d.ts

@@ -0,0 +1,24 @@
+import { CustomAnimation, ParsedAnimationVariant } from '../types';
+export declare function normalizeParsedAnimationVariant(variant: ParsedAnimationVariant): ParsedAnimationVariant;
+export declare const validateCustomAnimation: (animation: CustomAnimation) => boolean;
+/**
+ * Normalize a CustomAnimation into a Framer Motion variant subset.
+ */
+export declare const normalizeCustomAnimationVariant: (animation: CustomAnimation) => ParsedAnimationVariant;
+export declare const convertWebAnimationToVariant: (animation: CustomAnimation) => ParsedAnimationVariant;
+/**
+ * Parse preset animation by name
+ */
+export declare const parsePresetAnimation: (name: string) => Promise<ParsedAnimationVariant>;
+/**
+ * Parse custom animation
+ */
+export declare const parseCustomAnimation: (animation: CustomAnimation) => ParsedAnimationVariant | null;
+/**
+ * Parse animation (supports both preset and custom)
+ */
+export declare const parseAnimation: (animation: string | CustomAnimation) => Promise<ParsedAnimationVariant | null>;
+/**
+ * Create default animation (fallback when parsing fails)
+ */
+export declare const createDefaultAnimation: () => ParsedAnimationVariant;

package/dist/animations/composer.d.ts

@@ -0,0 +1,13 @@
+import { ComposedAnimation, CustomAnimation, ParsedAnimationVariant } from '../types';
+/**
+ * Validate composed animation configuration
+ */
+export declare const validateComposedAnimation: (animation: ComposedAnimation) => boolean;
+/**
+ * Compose animation
+ */
+export declare const composeAnimation: (animation: ComposedAnimation) => Promise<ParsedAnimationVariant | null>;
+/**
+ * Parse animation (supports preset, custom, and composed)
+ */
+export declare const parseAnimationWithComposition: (animation: string | CustomAnimation | ComposedAnimation) => Promise<ParsedAnimationVariant | null>;

package/dist/animations/presets/blink.d.ts

@@ -0,0 +1,18 @@
+import { Variant } from 'framer-motion';
+export declare const blinkAnimations: {
+    blink: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    flash: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    pulse: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/presets/blur.d.ts

@@ -0,0 +1,18 @@
+import { Variant } from 'framer-motion';
+export declare const blurAnimations: {
+    'blur-in': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'blur-out': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'focus-in': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/presets/bounce.d.ts

@@ -0,0 +1,18 @@
+import { Variant } from 'framer-motion';
+export declare const bounceAnimations: {
+    bounce: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'bounce-in': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'bounce-out': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/presets/elastic.d.ts

@@ -0,0 +1,23 @@
+import { Variant } from 'framer-motion';
+export declare const elasticAnimations: {
+    elastic: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'rubber-band': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    wobble: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    swing: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/presets/fade.d.ts

@@ -0,0 +1,18 @@
+import { Variant } from 'framer-motion';
+export declare const fadeAnimations: {
+    fade: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'fade-in': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'fade-out': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/presets/flip.d.ts

@@ -0,0 +1,18 @@
+import { Variant } from 'framer-motion';
+export declare const flipAnimations: {
+    flip: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'flip-x': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'flip-y': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/presets/index.d.ts

@@ -0,0 +1,38 @@
+import { Variant } from 'framer-motion';
+export interface PresetAnimation {
+    initial: Variant;
+    animate: Variant;
+    exit: Variant;
+}
+export type PresetLoadErrorCode = 'INVALID_ANIMATION' | 'ANIMATION_ASSET_LOAD_FAILED';
+export type PresetLoadState = 'idle' | 'pending' | 'success' | 'failed-permanent' | 'failed-transient';
+export declare const PRESET_LOAD_TIMEOUT_MS = 3000;
+export declare class PresetLoadError extends Error {
+    readonly code: PresetLoadErrorCode;
+    readonly permanent: boolean;
+    readonly category?: string;
+    readonly presetName?: string;
+    readonly cause?: unknown;
+    constructor(code: PresetLoadErrorCode, message: string, options: {
+        permanent: boolean;
+        category?: string;
+        presetName?: string;
+        cause?: unknown;
+    });
+}
+export declare function isPresetLoadError(error: unknown): error is PresetLoadError;
+type AnimationModule = Record<string, PresetAnimation>;
+type CategoryLoader = (category: string) => Promise<AnimationModule>;
+/** Load one category, coalescing concurrent requests across all Cineview roots. */
+export declare function loadAnimationModule(category: string): Promise<AnimationModule>;
+/** Resolve one preset. Unknown names/missing exports are permanent failures. */
+export declare function getPresetAnimation(name: string): Promise<PresetAnimation>;
+export declare function preloadAnimationCategory(category: string): Promise<void>;
+export declare function preloadAllAnimations(): Promise<void>;
+/** Clears success/permanent caches. Pending imports may finish but cannot repopulate a cleared epoch. */
+export declare function clearAnimationCache(): void;
+/** Read-only diagnostic state used by tests and development tooling. */
+export declare function getPresetCategoryState(category: string): PresetLoadState;
+/** Test seam; intentionally not re-exported from the package barrel. */
+export declare function setPresetCategoryLoaderForTests(loader: CategoryLoader | null): void;
+export {};

package/dist/animations/presets/rotate.d.ts

@@ -0,0 +1,23 @@
+import { Variant } from 'framer-motion';
+export declare const rotateAnimations: {
+    rotate: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'rotate-in': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'rotate-out': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    spin: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/presets/shake.d.ts

@@ -0,0 +1,28 @@
+import { Variant } from 'framer-motion';
+export declare const shakeAnimations: {
+    shake: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'shake-x': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'shake-y': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    vibrate: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    jello: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/presets/slide.d.ts

@@ -0,0 +1,23 @@
+import { Variant } from 'framer-motion';
+export declare const slideAnimations: {
+    'slide-up': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'slide-down': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'slide-left': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'slide-right': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/presets/special.d.ts

@@ -0,0 +1,38 @@
+import { Variant } from 'framer-motion';
+export declare const specialAnimations: {
+    heartbeat: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    tada: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    wave: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'roll-in': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'roll-out': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    hinge: {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'jack-in-the-box': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/presets/zoom.d.ts

@@ -0,0 +1,23 @@
+import { Variant } from 'framer-motion';
+export declare const zoomAnimations: {
+    'zoom-in': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'zoom-out': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'scale-up': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+    'scale-down': {
+        initial: Variant;
+        animate: Variant;
+        exit: Variant;
+    };
+};

package/dist/animations/registry.d.ts

@@ -0,0 +1,51 @@
+export type AnimateTimelineLane = 'drag' | 'scroll' | 'visibility';
+export declare function isLaneCompatible(followerLane: AnimateTimelineLane, leaderLane: AnimateTimelineLane): boolean;
+export interface AnimateRegistrationInfo {
+    delay: number;
+    duration: number;
+    after?: string;
+    /** Concrete runtime driver. Optional only for legacy/internal callers while the
+     * registration API migrates to owner-safe leases. */
+    lane?: AnimateTimelineLane;
+}
+export type AnimationRegistryIssue = {
+    type: 'missing-dependency';
+    animateId: string;
+    after: string;
+} | {
+    type: 'circular-dependency';
+    animateId: string;
+    cycle: string[];
+} | {
+    type: 'duplicate-id';
+    animateId: string;
+} | {
+    type: 'incompatible-lane';
+    animateId: string;
+    after: string;
+    followerLane: AnimateTimelineLane;
+    leaderLane: AnimateTimelineLane;
+};
+export interface AnimationRegistrySnapshot {
+    registrations: Map<string, AnimateRegistrationInfo>;
+    calculatedDelays: Map<string, number>;
+    issues: AnimationRegistryIssue[];
+    timelineDuration: number;
+}
+/** Immutable registry compilation captured by prepared scenes and transactions. */
+export interface FrozenAnimationRegistrySnapshot {
+    readonly registrations: ReadonlyMap<string, Readonly<AnimateRegistrationInfo>>;
+    readonly calculatedDelays: ReadonlyMap<string, number>;
+    readonly issues: readonly AnimationRegistryIssue[];
+    readonly timelineDuration: number;
+}
+export declare function createImmutableMap<K, V>(entries: Iterable<readonly [K, V]>): ReadonlyMap<K, V>;
+export declare function freezeAnimationRegistrySnapshot(snapshot: AnimationRegistrySnapshot): FrozenAnimationRegistrySnapshot;
+export interface BuildAnimationRegistrySnapshotOptions {
+    baseDuration: number;
+    registrations: Map<string, AnimateRegistrationInfo>;
+    /** Driver-only declarations never enter registrations or extend timelineDuration. */
+    declaredLanes?: ReadonlyMap<string, AnimateTimelineLane>;
+    duplicateIds?: Iterable<string>;
+}
+export declare function buildAnimationRegistrySnapshot({ baseDuration, registrations, declaredLanes, duplicateIds, }: BuildAnimationRegistrySnapshotOptions): AnimationRegistrySnapshot;

package/dist/artifacts.json

@@ -0,0 +1,40 @@
+{
+  "generatedBy": "scripts/build-all.mjs",
+  "artifacts": [
+    {
+      "file": "cineview.es.mjs",
+      "module": true,
+      "budgetKB": 50,
+      "label": "全量 ESM（运行时按 mode 派发）",
+      "entry": "src/index.ts"
+    },
+    {
+      "file": "cineview.umd.js",
+      "module": false,
+      "budgetKB": 62,
+      "label": "全量 UMD（运行时按 mode 派发）",
+      "entry": "src/index.ts"
+    },
+    {
+      "file": "cineview-drag.umd.js",
+      "module": false,
+      "budgetKB": 50,
+      "label": "UMD（仅拖拽引擎）",
+      "entry": "src/entry-drag.ts"
+    },
+    {
+      "file": "cineview-scroll.umd.js",
+      "module": false,
+      "budgetKB": 54,
+      "label": "UMD（仅滚动引擎）",
+      "entry": "src/entry-scroll.ts"
+    },
+    {
+      "file": "cineview-dev.es.mjs",
+      "module": true,
+      "budgetKB": 10,
+      "label": "开发工具 ESM",
+      "entry": "src/dev/index.ts"
+    }
+  ]
+}