cineview 1.0.0 → 1.0.1

package/dist/types/index.d.ts

@@ -39,10 +39,7 @@ export interface DragModeConfig {
 }
 export interface ScrollModeConfig {
     direction?: SlideDirection;
-    zoneTrigger?: 'center-lock';
     sceneSizing?: 'content' | 'screen';
-    /** Enable runtime parameter diagnostics for scroll layout and zone geometry. */
-    debug?: boolean;
     enterMargin?: number;
     exitMargin?: number;
 }
@@ -58,7 +55,7 @@ export interface ScrollModeConfig {
 export interface A11yConfig {
     /**
      * Accessible name for the drag root container (`aria-label`). Defaults to `'Scenes'`.
-     * When multiple CineView instances exist on one page, each must have a unique label
+     * When multiple Cineview instances exist on one page, each must have a unique label
      * so they can be distinguished in screen reader landmark lists.
      */
     label?: string;
@@ -71,6 +68,7 @@ export interface ScrollbarConfig {
     inset?: number;
     trackColor?: string;
     thumbColor?: string;
+    /** Thumb fill on pointer hover. Defaults to `thumbColor`; does not add a border. */
     thumbHoverColor?: string;
     autoHide?: boolean;
 }
@@ -83,19 +81,19 @@ export interface SceneChangeDetail {
  * Error codes emitted by the framework at runtime. Consumers can switch on `code`
  * in `onError` to get autocomplete and exhaustiveness checking (no longer a bare string).
  *
- * - `EMPTY_SCENES`: CineView has no Scene children (`context.scope` is default),
+ * - `EMPTY_SCENES`: Cineview has no Scene children (`context.scope` is default),
  *   or a Scene has no children (`context.scope === 'scene'`, includes `sceneIndex`).
  * - `IMAGE_LOAD_FAILED`: Image preload failed.
  * - `FIRST_SCENE_TIMEOUT`: First-screen priority resource wait timed out (recoverable, includes preventDefault).
- * - `INVALID_ANIMATION`: Animate's after points to a nonexistent component.
+ * - `INVALID_ANIMATION`: An animation dependency, control, or scroll phase is invalid.
  * - `CIRCULAR_DEPENDENCY`: Animate's after chain contains a cycle.
  * - `INVALID_COMPONENT_HIERARCHY`: Duplicate animateId or authored scroll zone identity in component tree.
  * - `INVALID_DRAG_CONFIG`: Drag unit / scale / enabled config is invalid (recoverable).
  * - `ANIMATION_ASSET_LOAD_FAILED`: Animation preset asset load failed (retryable).
  */
-export type CineViewErrorCode = 'EMPTY_SCENES' | 'IMAGE_LOAD_FAILED' | 'FIRST_SCENE_TIMEOUT' | 'INVALID_ANIMATION' | 'CIRCULAR_DEPENDENCY' | 'INVALID_COMPONENT_HIERARCHY' | 'INVALID_DRAG_CONFIG' | 'ANIMATION_ASSET_LOAD_FAILED';
-export interface CineViewErrorDetail {
-    code: CineViewErrorCode;
+export type CineviewErrorCode = 'EMPTY_SCENES' | 'IMAGE_LOAD_FAILED' | 'FIRST_SCENE_TIMEOUT' | 'INVALID_ANIMATION' | 'CIRCULAR_DEPENDENCY' | 'INVALID_COMPONENT_HIERARCHY' | 'INVALID_DRAG_CONFIG' | 'ANIMATION_ASSET_LOAD_FAILED';
+export interface CineviewErrorDetail {
+    code: CineviewErrorCode;
     message: string;
     context?: Record<string, unknown>;
     preventDefault?: () => void;
@@ -130,14 +128,14 @@ export interface SceneVisibilityDetail {
     visible: boolean;
     progress: number;
 }
-export interface CineViewCommonCallbacks {
-    onReady?: (api: CineViewRef) => void;
+export interface CineviewCommonCallbacks {
+    onReady?: (api: CineviewRef) => void;
     onLoadProgress?: (progress: number) => void;
     onSceneEnter?: (detail: SceneChangeDetail) => void;
     onSceneLeave?: (detail: SceneChangeDetail) => void;
-    onError?: (detail: CineViewErrorDetail) => void;
+    onError?: (detail: CineviewErrorDetail) => void;
 }
-export interface CineViewDragCallbacks {
+export interface CineviewDragCallbacks {
     /** Fires only after the first direction-qualified move acquires drag ownership. */
     onDragStart?: (detail: DragStartDetail) => void;
     onDragProgress?: (detail: DragDetail) => void;
@@ -145,7 +143,7 @@ export interface CineViewDragCallbacks {
     onDragEnd?: (detail: DragEndDetail) => void;
     onDragCancel?: (detail: DragDetail) => void;
 }
-export interface CineViewScrollCallbacks {
+export interface CineviewScrollCallbacks {
     onZoneEnter?: (detail: ZoneDetail) => void;
     onZoneLeave?: (detail: ZoneDetail) => void;
     onZoneProgress?: (detail: ZoneProgressDetail) => void;
@@ -154,7 +152,7 @@ export interface CineViewScrollCallbacks {
 /**
  * Flat callbacks accepted in drag mode (mode="drag" or omitted).
  *
- * The `[K in keyof CineViewScrollCallbacks]?: never` cross-exclusion closes a
+ * The `[K in keyof CineviewScrollCallbacks]?: never` cross-exclusion closes a
  * discrimination hole: without it, TS's excess-property check only rejects
  * wrong-mode callbacks written as an INLINE object literal. A caller who first
  * extracts callbacks into a variable that mixes a valid drag callback with a
@@ -164,12 +162,12 @@ export interface CineViewScrollCallbacks {
  * key as optional-`never` makes assigning a real function to it a type error on
  * both the inline and the extracted-variable paths.
  */
-export type DragModeCallbacks = CineViewCommonCallbacks & CineViewDragCallbacks & {
-    [K in keyof CineViewScrollCallbacks]?: never;
+export type DragModeCallbacks = CineviewCommonCallbacks & CineviewDragCallbacks & {
+    [K in keyof CineviewScrollCallbacks]?: never;
 };
 /** Flat callbacks accepted in scroll mode (mode="scroll"). Mirror cross-exclusion of drag-only keys — see DragModeCallbacks. */
-export type ScrollModeCallbacks = CineViewCommonCallbacks & CineViewScrollCallbacks & {
-    [K in keyof CineViewDragCallbacks]?: never;
+export type ScrollModeCallbacks = CineviewCommonCallbacks & CineviewScrollCallbacks & {
+    [K in keyof CineviewDragCallbacks]?: never;
 };
 /**
  * Back-compat alias. The shape changed from the old nested
@@ -177,7 +175,7 @@ export type ScrollModeCallbacks = CineViewCommonCallbacks & CineViewScrollCallba
  * change at the value level, but the NAME is preserved to avoid breaking
  * type-only imports.
  */
-export type CineViewCallbacks = DragModeCallbacks | ScrollModeCallbacks;
+export type CineviewCallbacks = DragModeCallbacks | ScrollModeCallbacks;
 export type PresetAnimation = 'fade' | 'fade-in' | 'fade-out' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'zoom-in' | 'zoom-out' | 'scale-up' | 'scale-down' | 'rotate' | 'rotate-in' | 'rotate-out' | 'spin' | 'flip' | 'flip-x' | 'flip-y' | 'bounce' | 'bounce-in' | 'bounce-out' | 'blink' | 'flash' | 'pulse' | 'shake' | 'shake-x' | 'shake-y' | 'vibrate' | 'jello' | 'blur-in' | 'blur-out' | 'focus-in' | 'elastic' | 'rubber-band' | 'wobble' | 'swing' | 'heartbeat' | 'tada' | 'wave' | 'roll-in' | 'roll-out' | 'hinge' | 'jack-in-the-box';
 export interface ParsedAnimationVariant {
     initial: Record<string, unknown>;
@@ -196,12 +194,12 @@ export interface ComposedAnimation {
 }
 export type AnimationType = PresetAnimation | CustomAnimation | ComposedAnimation;
 /**
- * Shared CineView props, independent of `mode`. Mode-specific fields are added
+ * Shared Cineview props, independent of `mode`. Mode-specific fields are added
  * by the per-mode branches below; the `mode`/`callbacks` pair closes the
  * discriminated union so both the callback surface and the mode-specific config
  * fields are constrained by the active mode.
  */
-export interface CineViewBaseProps {
+export interface CineviewBaseProps {
     /**
      * Design viewport width baseline (design px). The single site-wide conversion
      * ruler: `scale = viewportWidth / designWidth`. All design lengths (Position
@@ -218,41 +216,43 @@ export interface CineViewBaseProps {
     designWidth?: number;
     scrollbar?: false | ScrollbarConfig;
     monitor?: boolean;
+    /** Expose scroll layout diagnostics. Use `monitor` to sample performance and render `PerfPanel` explicitly. */
+    debug?: boolean;
     a11y?: A11yConfig;
     children: ReactNode;
 }
 /** Drag-branch-only config keys cannot appear on scroll root (and vice versa) — same cross-exclusion as callbacks. */
-type ScrollOnlyConfigKeys = 'zoneTrigger' | 'sceneSizing' | 'enterMargin' | 'exitMargin' | 'debug';
+type ScrollOnlyConfigKeys = 'sceneSizing' | 'enterMargin' | 'exitMargin';
 type DragOnlyConfigKeys = 'transitionDuration' | 'threshold' | 'unit' | 'scale' | 'firstSceneTimeout';
 /**
- * CineView drag branch Props: `mode` defaults to drag. Mode-specific fields are
+ * Cineview drag branch Props: `mode` defaults to drag. Mode-specific fields are
  * flattened at root level (no `modes.drag` wrapper); scroll-specific fields are
  * excluded as `never`.
  */
-export type CineViewDragModeProps = CineViewBaseProps & DragModeConfig & {
+export type CineviewDragModeProps = CineviewBaseProps & DragModeConfig & {
     mode?: 'drag';
     callbacks?: DragModeCallbacks;
 } & {
     [K in ScrollOnlyConfigKeys]?: never;
 };
 /**
- * CineView scroll branch Props: scroll-specific fields are flattened at root
+ * Cineview scroll branch Props: scroll-specific fields are flattened at root
  * level (no `modes.scroll` wrapper); drag-specific fields are excluded as `never`.
  */
-export type CineViewScrollModeProps = CineViewBaseProps & ScrollModeConfig & {
+export type CineviewScrollModeProps = CineviewBaseProps & ScrollModeConfig & {
     mode: 'scroll';
     callbacks?: ScrollModeCallbacks;
 } & {
     [K in DragOnlyConfigKeys]?: never;
 };
 /**
- * CineView component Props — discriminated on `mode`. Drag mode (the default when
+ * Cineview component Props — discriminated on `mode`. Drag mode (the default when
  * `mode` is omitted) accepts common + drag callbacks and flat drag config
  * fields; scroll mode accepts common + scroll callbacks and flat scroll config
  * fields. Passing a callback or config field from the wrong mode is a type
  * error (TS excess-property check on the flat objects).
  */
-export type CineViewProps = CineViewDragModeProps | CineViewScrollModeProps;
+export type CineviewProps = CineviewDragModeProps | CineviewScrollModeProps;
 /**
  * Performance metrics for monitoring runtime behavior.
  */
@@ -267,34 +267,32 @@ export interface PerformanceMetrics {
  * - number: zero-based scene index
  * - string: Scene.sceneId; in scroll mode it can also match Scene.scroll.zoneId
  */
-export type CineViewPreloadTarget = number | string;
+export type CineviewPreloadTarget = number | string;
 /**
- * CineView Ref methods.
+ * Cineview Ref methods.
  *
  * These 5 methods exist in both drag and scroll modes, so they are required —
  * call sites no longer need `ref.current?.refreshLayout?.()` per-method null checks.
  * `goToZone` is scroll-mode-only (drag mode has no zone concept), so it remains optional;
- * scroll consumers can switch to {@link CineViewScrollRef} for a view with `goToZone` required.
+ * scroll consumers can switch to {@link CineviewScrollRef} for a view with `goToZone` required.
  */
-export interface CineViewRef {
+export interface CineviewRef {
     goToScene: (index: number, animated?: boolean) => void;
     refreshLayout: () => void;
-    preload: (targets?: CineViewPreloadTarget[]) => Promise<void>;
+    preload: (targets?: CineviewPreloadTarget[]) => Promise<void>;
     getCurrentIndex: () => number;
     getPerformanceMetrics: () => PerformanceMetrics;
     /** Scroll mode only: jump to specified zone. Not available in drag mode. */
     goToZone?: (zoneId: string, options?: {
-        align?: 'center';
         animated?: boolean;
     }) => void;
 }
 /**
- * CineView Ref in scroll mode — `goToZone` is required here.
- * Usage: `const ref = useRef<CineViewScrollRef>(null)`, with `mode="scroll"`.
+ * Cineview Ref in scroll mode — `goToZone` is required here.
+ * Usage: `const ref = useRef<CineviewScrollRef>(null)`, with `mode="scroll"`.
  */
-export interface CineViewScrollRef extends CineViewRef {
+export interface CineviewScrollRef extends CineviewRef {
     goToZone: (zoneId: string, options?: {
-        align?: 'center';
         animated?: boolean;
     }) => void;
 }
@@ -305,6 +303,7 @@ export interface SceneProps extends Omit<HTMLAttributes<HTMLDivElement>, 'childr
     sceneId?: string;
     layout?: {
         width?: number | string;
+        /** Content-box CSS height; drag navigation remains fixed at one viewport. */
         height?: number | string;
         anchor?: SceneAnchor;
         overflow?: 'hidden' | 'visible' | 'clip';
@@ -328,7 +327,6 @@ export interface SceneProps extends Omit<HTMLAttributes<HTMLDivElement>, 'childr
     drag?: SceneDragConfig;
     scroll?: {
         zoneId?: string;
-        trigger?: 'center-lock';
     };
     callbacks?: {
         onVisibilityChange?: (detail: SceneVisibilityDetail) => void;
@@ -360,9 +358,8 @@ interface AnimateBaseProps {
          */
         driver?: 'scene' | 'clock';
         delay?: number;
-        /** Wait for a specific animateId to finish before entering. */
+        /** Start after the referenced animateId finishes entering, then apply delay. */
         after?: string;
-        zoneId?: string;
         phase?: {
             start?: number;
             end?: number;

package/dist/utils/animationHelpers.d.ts

@@ -1,7 +1,7 @@
-import { CineViewErrorCode, ParsedAnimationVariant, CustomAnimation, ComposedAnimation } from '../types';
+import { CineviewErrorCode, ParsedAnimationVariant, CustomAnimation, ComposedAnimation } from '../types';
 import { PresetAnimation } from '../animations/presets';
 export interface AnimationParseFailure {
-    code: Extract<CineViewErrorCode, 'INVALID_ANIMATION' | 'ANIMATION_ASSET_LOAD_FAILED'>;
+    code: Extract<CineviewErrorCode, 'INVALID_ANIMATION' | 'ANIMATION_ASSET_LOAD_FAILED'>;
     message: string;
     context: Record<string, unknown>;
 }

package/dist/utils/devLog.d.ts

@@ -6,7 +6,7 @@
  * dev builds and SSR scenarios that depend on the library source still log. This utility centralizes
  * the gate, aligning with existing guard patterns in context/Scene modules.
  *
- * Uniform prefix `[CineView]` for consistency with other developer-facing diagnostic messages.
+ * Uniform prefix `[Cineview]` for consistency with other developer-facing diagnostic messages.
  */
 export declare function devWarn(...args: unknown[]): void;
 export declare function devError(...args: unknown[]): void;

package/dist/utils/performanceMonitor.d.ts

@@ -43,7 +43,7 @@ export declare class PerformanceMonitor {
 export declare const createPerformanceMonitor: () => PerformanceMonitor;
 export declare const performanceMonitor: PerformanceMonitor;
 /**
- * Acquire page-level performance monitoring for a mounted CineView instance.
+ * Acquire page-level performance monitoring for a mounted Cineview instance.
  * First lease starts monitoring, stops only after last lease is released; release is idempotent.
  */
 export declare const acquirePerformanceMonitoring: () => (() => void);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cineview",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "React UI framework for creating cinematic full-screen sliding pages",
   "main": "dist/cineview.umd.js",
   "module": "dist/cineview.es.mjs",
@@ -41,39 +41,43 @@
     "build:verify": "pnpm run build && node scripts/verify-build.js",
     "preview": "vite preview",
     "test": "jest",
-    "test:examples": "pnpm --dir examples/performance-test test",
+    "test:examples": "jest --runInBand src/__tests__/site/acceptanceFixtures.test.ts && pnpm --dir examples/minimal build",
     "test:site-contracts": "jest --runInBand src/__tests__/site",
-    "test:browser": "pnpm build && pnpm --dir examples/performance-test acceptance:browser",
+    "test:browser": "pnpm build && pnpm --dir site acceptance:browser",
     "quality:duplicates": "jscpd --config .jscpd.json src",
     "verify:failure-injection": "node scripts/verify-failure-injection.js",
-    "verify:browser-failure-injection": "pnpm --dir examples/performance-test acceptance:failure-injection",
+    "verify:browser-failure-injection": "pnpm --dir site acceptance:failure-injection",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "test:coverage:framework": "jest --config jest.framework.config.js --coverage --runInBand",
+    "test:coverage:framework": "jest --config jest.framework.config.js --coverage --runInBand && node scripts/write-coverage-badge.mjs",
     "test:coverage:watch": "jest --coverage --watch",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
     "format": "pnpm format:framework && pnpm format:site",
-    "format:framework": "prettier --write \"src/**/*.{ts,tsx}\" \"examples/performance-test/**/*.{ts,tsx,js,mjs,json}\" \".github/**/*.{yml,yaml}\" \"*.{ts,js,json,md}\" \"scripts/*.{js,mjs}\"",
-    "format:site": "prettier --write \"site/src/**/*.{ts,tsx,css}\" \"site/*.{ts,json,html}\"",
+    "format:framework": "prettier --write \"src/**/*.{ts,tsx}\" \"examples/minimal/src/**/*.{ts,tsx}\" \".github/**/*.{yml,yaml}\" \"*.{ts,js,json,md}\" \"scripts/*.{js,mjs}\"",
+    "format:site": "prettier --write \"site/src/**/*.{ts,tsx,css}\" \"site/*.{ts,json,html}\" \"site/tools/{acceptance-drag,acceptance-scroll,profile-production,verify-browser-failure-injection}.mjs\"",
     "format:check": "pnpm format:check:framework && pnpm format:check:site",
-    "format:check:framework": "prettier --check \"src/**/*.{ts,tsx}\" \"examples/performance-test/**/*.{ts,tsx,js,mjs,json}\" \".github/**/*.{yml,yaml}\" \"*.{ts,js,json,md}\" \"scripts/*.{js,mjs}\"",
-    "format:check:site": "prettier --check \"site/src/**/*.{ts,tsx,css}\" \"site/*.{ts,json,html}\"",
+    "format:check:framework": "prettier --check \"src/**/*.{ts,tsx}\" \"examples/minimal/src/**/*.{ts,tsx}\" \".github/**/*.{yml,yaml}\" \"*.{ts,js,json,md}\" \"scripts/*.{js,mjs}\"",
+    "format:check:site": "prettier --check \"site/src/**/*.{ts,tsx,css}\" \"site/*.{ts,json,html}\" \"site/tools/{acceptance-drag,acceptance-scroll,profile-production,verify-browser-failure-injection}.mjs\"",
     "type-check": "tsc --noEmit",
     "type-check:framework": "tsc -p tsconfig.framework.json --noEmit",
     "type-check:site": "pnpm --dir site type-check",
-    "type-check:examples": "pnpm --dir examples/minimal type-check && pnpm --dir examples/performance-test type-check",
+    "type-check:examples": "pnpm --dir examples/minimal type-check",
     "prepublishOnly": "pnpm verify:framework:static",
     "prepare": "husky",
     "analyze": "vite build && open stats.html",
     "lighthouse": "lighthouse http://localhost:3000 --view",
-    "verify:framework:static": "pnpm format:check:framework && pnpm type-check:framework && pnpm type-check:examples && pnpm lint && pnpm test:coverage:framework && pnpm test:examples && pnpm quality:duplicates && pnpm build:verify && pnpm verify:failure-injection",
+    "verify:repository": "node scripts/verify-repository.mjs",
+    "verify:framework:static": "pnpm verify:repository && pnpm format:check:framework && pnpm type-check:framework && pnpm type-check:examples && pnpm lint && pnpm test:coverage:framework && pnpm test:examples && pnpm quality:duplicates && pnpm build:verify && pnpm verify:failure-injection",
     "verify:framework": "pnpm verify:framework:static && pnpm test:browser && pnpm verify:browser-failure-injection",
     "docs:style:static": "pnpm --dir site exec node tools/docs-style-probe.mjs --static",
     "docs:style": "pnpm --dir site exec node tools/docs-style-probe.mjs",
     "a11y:probe": "pnpm --dir site exec node tools/a11y-probe.mjs",
     "verify:all": "pnpm verify:framework && pnpm format:check:site && pnpm type-check && pnpm type-check:site && pnpm test:site-contracts && pnpm docs:style:static",
-    "verify": "pnpm verify:all"
+    "verify": "pnpm verify:all",
+    "docs:links": "node scripts/verify-documentation.mjs",
+    "audit:all": "node scripts/audit-all.mjs",
+    "profile:browser": "pnpm --dir site profile:browser"
   },
   "peerDependencies": {
     "framer-motion": "^13.0.0",
@@ -136,7 +140,7 @@
     "type": "git",
     "url": "https://github.com/AlienMu/cineview.git"
   },
-  "homepage": "https://github.com/AlienMu/cineview#readme",
+  "homepage": "https://cineview.pages.dev",
   "bugs": {
     "url": "https://github.com/AlienMu/cineview/issues"
   },

package/dist/components/CineView/CineViewDispatch.d.ts

@@ -1,2 +0,0 @@
-import { CineViewProps, CineViewRef } from '../../types';
-export declare const CineView: import('react').ForwardRefExoticComponent<CineViewProps & import('react').RefAttributes<CineViewRef>>;

package/dist/components/CineView/DirectScrollCineView.d.ts

@@ -1,5 +0,0 @@
-import { default as React } from 'react';
-import { CineViewRef, CineViewScrollModeProps } from '../../types';
-export declare const DirectScrollCineView: React.ForwardRefExoticComponent<Omit<CineViewScrollModeProps, "mode"> & {
-    mode?: "scroll";
-} & React.RefAttributes<CineViewRef>>;

package/dist/components/CineView/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * CineView component exports
- */
-export { CineView } from './CineViewDispatch';
-export type { CineViewPreloadTarget, CineViewProps, CineViewRef } from '../../types';