cineview 0.0.1-beta

package/dist/utils/gestureDetector.d.ts

@@ -0,0 +1,67 @@
+import { GestureType } from '../types';
+/**
+ * Gesture detection configuration
+ */
+interface GestureConfig {
+    minSwipeDistance?: number;
+    maxSwipeTime?: number;
+    direction?: 'x' | 'y' | 'both';
+}
+/**
+ * Gesture detector class
+ */
+export declare class GestureDetector {
+    private startPos;
+    private config;
+    constructor(config?: GestureConfig);
+    /**
+     * Handle touch or mouse start event
+     */
+    handleStart(event: TouchEvent | MouseEvent): void;
+    /**
+     * Handle touch or mouse end event
+     * @returns Detected gesture type
+     */
+    handleEnd(event: TouchEvent | MouseEvent): GestureType;
+    /**
+     * Get current drag progress (0-1)
+     * @param event - Current event
+     * @param containerSize - Container size (width or height)
+     * @returns Drag progress
+     */
+    getDragProgress(event: TouchEvent | MouseEvent, containerSize: number): number;
+    /**
+     * Reset gesture detector
+     */
+    reset(): void;
+    /**
+     * Extract position from event
+     */
+    private getPosition;
+}
+/**
+ * Create gesture detector
+ * @param config - Gesture detection configuration
+ * @returns Gesture detector instance
+ */
+export declare function createGestureDetector(config?: GestureConfig): GestureDetector;
+/**
+ * Detect if device supports touch
+ */
+export declare function isTouchDevice(): boolean;
+/**
+ * Simple gesture detection function
+ * @param start - Start position
+ * @param end - End position
+ * @param direction - Detection direction
+ * @param minDistance - Minimum swipe distance
+ * @returns Gesture type
+ */
+export declare function detectGesture(start: {
+    x: number;
+    y: number;
+}, end: {
+    x: number;
+    y: number;
+}, direction?: 'x' | 'y', minDistance?: number): GestureType;
+export {};

package/dist/utils/performanceMonitor.d.ts

@@ -0,0 +1,66 @@
+import { PerformanceMetrics } from '../types';
+export type { PerformanceMetrics };
+export declare class PerformanceMonitor {
+    private frameCount;
+    private lastTime;
+    private frameTimes;
+    private memorySamples;
+    private lastMemorySampleTime;
+    private cachedMemoryUsage;
+    private cachedBundleSizeKb;
+    private rafId;
+    private isMonitoring;
+    private measure;
+    constructor();
+    /**
+     * Start performance monitoring
+     */
+    start(): void;
+    /**
+     * Stop performance monitoring
+     */
+    stop(): void;
+    /**
+     * Get current performance metrics
+     */
+    getMetrics(): PerformanceMetrics;
+    /**
+     * Calculate average frame time
+     */
+    private calculateAvgFrameTime;
+    /**
+     * Get memory usage (if browser supports it)
+     * @returns Memory usage in MB
+     */
+    private getMemoryUsage;
+    private sampleMemory;
+    private getBundleSizeKb;
+    private estimateBundleSizeKb;
+}
+/**
+ * Create performance monitor instance
+ */
+export declare const createPerformanceMonitor: () => PerformanceMonitor;
+export declare const performanceMonitor: PerformanceMonitor;
+/**
+ * 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);
+/**
+ * Start performance monitoring (using singleton)
+ */
+export declare const startPerformanceMonitoring: () => void;
+/**
+ * Stop performance monitoring (using singleton)
+ */
+export declare const stopPerformanceMonitoring: () => void;
+/**
+ * Get performance metrics (using singleton)
+ */
+export declare const getPerformanceMetrics: () => PerformanceMetrics;
+/**
+ * Get global performance monitor instance
+ * @deprecated Use performanceMonitor singleton instead
+ */
+export declare const getGlobalPerformanceMonitor: () => PerformanceMonitor;

package/dist/utils/styleConvert.d.ts

@@ -0,0 +1,7 @@
+import { CSSProperties } from 'react';
+/** Single-ruler converter interface (avoids circular dependency on context). */
+export interface ScaleConverter {
+    convert: (value: number) => number;
+}
+export declare const convertNumericStyleValue: (key: string, value: unknown, context: ScaleConverter | null) => unknown;
+export declare const convertStyle: (style: CSSProperties | undefined, context: ScaleConverter | null) => CSSProperties | undefined;

package/dist/utils/useIsomorphicLayoutEffect.d.ts

@@ -0,0 +1,22 @@
+import { useEffect } from 'react';
+/**
+ * SSR-safe `useLayoutEffect`.
+ *
+ * Background: `useLayoutEffect` does not execute during server-side rendering,
+ * causing React to emit "useLayoutEffect does nothing on the server" warnings.
+ * For a library, this warning appears directly in the consumer's (Next.js / Remix, etc.)
+ * server console, even though the library itself has no layout measurements to perform.
+ *
+ * The fix is a standard community pattern: fall back to `useEffect` when DOM is absent.
+ * Neither hook executes on the server, so **client-side behavior is unchanged** — this
+ * only suppresses the meaningless server-side warning.
+ *
+ * Detection uses `typeof document !== 'undefined'` rather than `window`: both are absent
+ * in SSR scenarios, but `document` is the actual dependency for layout measurements,
+ * making it semantically more precise.
+ *
+ * Note: this constant is evaluated once at module load time. The library's entire output
+ * runs in either browser or server environment for its full lifecycle — there is no
+ * mid-execution DOM acquisition, so re-checking on every render is unnecessary.
+ */
+export declare const useIsomorphicLayoutEffect: typeof useEffect;

package/dist/utils/useStructurallyStableValue.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Keeps JSON-like authoring objects stable across renders when only their object
+ * identity changed. Functions and non-plain objects remain identity-sensitive.
+ */
+export declare function useStructurallyStableValue<T>(value: T): T;

package/dist/zoom-CuAthpqd.mjs

@@ -0,0 +1,63 @@
+var a = {
+  "zoom-in": {
+    initial: {
+      scale: 0,
+      opacity: 0
+    },
+    animate: {
+      scale: 1,
+      opacity: 1
+    },
+    exit: {
+      scale: 0,
+      opacity: 0
+    }
+  },
+  "zoom-out": {
+    initial: {
+      scale: 1.5,
+      opacity: 0
+    },
+    animate: {
+      scale: 1,
+      opacity: 1
+    },
+    exit: {
+      scale: 1.5,
+      opacity: 0
+    }
+  },
+  "scale-up": {
+    initial: {
+      scale: 0.5,
+      opacity: 0
+    },
+    animate: {
+      scale: 1,
+      opacity: 1
+    },
+    exit: {
+      scale: 1.5,
+      opacity: 0
+    }
+  },
+  "scale-down": {
+    initial: {
+      scale: 1.5,
+      opacity: 0
+    },
+    animate: {
+      scale: 1,
+      opacity: 1
+    },
+    exit: {
+      scale: 0.5,
+      opacity: 0
+    }
+  }
+};
+export {
+  a as zoomAnimations
+};
+
+//# sourceMappingURL=zoom-CuAthpqd.mjs.map

package/package.json

@@ -0,0 +1,171 @@
+{
+  "name": "cineview",
+  "version": "0.0.1-beta",
+  "description": "React UI framework for creating cinematic full-screen sliding pages",
+  "main": "dist/cineview.umd.js",
+  "module": "dist/cineview.es.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/cineview.es.mjs",
+      "require": "./dist/cineview.umd.js"
+    },
+    "./drag": {
+      "types": "./dist/entry-drag.d.ts",
+      "require": "./dist/cineview-drag.umd.js"
+    },
+    "./scroll": {
+      "types": "./dist/entry-scroll.d.ts",
+      "require": "./dist/cineview-scroll.umd.js"
+    },
+    "./dev": {
+      "types": "./dist/dev/index.d.ts",
+      "import": "./dist/cineview-dev.es.mjs"
+    },
+    "./dev/style.css": "./dist/cineview-dev.css"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.mjs",
+    "dist/**/*.d.ts",
+    "dist/**/*.css",
+    "dist/artifacts.json"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "node scripts/build-all.mjs && node scripts/minify-library-entries.mjs",
+    "build:verify": "pnpm run build && node scripts/verify-build.js",
+    "preview": "vite preview",
+    "test": "jest",
+    "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 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 site acceptance:failure-injection",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "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/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/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",
+    "prepublishOnly": "pnpm verify:framework:static",
+    "prepare": "husky",
+    "analyze": "vite build && open stats.html",
+    "lighthouse": "lighthouse http://localhost:3000 --view",
+    "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",
+    "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",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@fast-check/jest": "^2.2.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "^14.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^26.4.1",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.69.0",
+    "@typescript-eslint/parser": "^8.69.0",
+    "@vitejs/plugin-react": "^6.1.1",
+    "esbuild": "^0.28.2",
+    "eslint": "^10.9.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-react": "^7.0.0",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "fast-check": "^4.6.0",
+    "framer-motion": "^13.2.0",
+    "globals": "^16.5.0",
+    "husky": "^9.1.7",
+    "jest": "^30.5.1",
+    "jest-environment-jsdom": "^30.5.1",
+    "jscpd": "5.1.1",
+    "lint-staged": "^17.4.1",
+    "playwright": "^1.63.0",
+    "prettier": "^3.0.0",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "rollup-plugin-visualizer": "^7.1.1",
+    "terser": "5.46.1",
+    "ts-jest": "^29.4.12",
+    "ts-prune": "^0.10.3",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.69.0",
+    "vite": "^8.2.2",
+    "vite-plugin-compression": "^0.5.0",
+    "vite-plugin-dts": "^5.1.0"
+  },
+  "keywords": [
+    "react",
+    "ui",
+    "framework",
+    "animation",
+    "fullscreen",
+    "slider",
+    "cinematic"
+  ],
+  "author": "Alien.mu",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AlienMu/cineview.git"
+  },
+  "homepage": "https://cineview.pages.dev",
+  "bugs": {
+    "url": "https://github.com/AlienMu/cineview/issues"
+  },
+  "packageManager": "pnpm@10.22.0",
+  "browserslist": [
+    "chrome >= 85",
+    "edge >= 85",
+    "firefox >= 79",
+    "safari >= 14",
+    "ios_saf >= 14",
+    "not dead"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "pnpm": {
+    "overrides": {
+      "minimatch": ">=3.1.3"
+    }
+  },
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": "^22.22.1 || >=24.0.0",
+      "onFail": "error"
+    }
+  }
+}