alpha-video-gpu-web 0.0.0-stage → 1.0.0

package/dist/index.mjs

@@ -0,0 +1,43 @@
+import {
+  ASTC_FORMAT_MAP,
+  AlphaVideoGpuError,
+  KTX2PlayerCore,
+  STORAGE_NAMESPACE,
+  ZSTDDecoder,
+  extractKTX2Metadata,
+  getASTCBlockSize,
+  getASTCBytesPerLayer
+} from "./chunk-P3MJ6UC3.mjs";
+
+// src/index.ts
+import {
+  blobSource,
+  createStore,
+  httpSource,
+  memorySource,
+  HttpSourceError,
+  SourceChangedError
+} from "range-source-web";
+function createAlphaVideoGpuPlayer(canvas, options = {}) {
+  return new KTX2PlayerCore(canvas, {
+    ...options,
+    ZSTDDecoderClass: ZSTDDecoder
+  });
+}
+export {
+  ASTC_FORMAT_MAP,
+  KTX2PlayerCore as AlphaVideoGpuCore,
+  AlphaVideoGpuError,
+  HttpSourceError,
+  STORAGE_NAMESPACE,
+  SourceChangedError,
+  ZSTDDecoder,
+  blobSource,
+  createAlphaVideoGpuPlayer,
+  createStore,
+  extractKTX2Metadata,
+  getASTCBlockSize,
+  getASTCBytesPerLayer,
+  httpSource,
+  memorySource
+};

package/dist/react.d.mts

@@ -0,0 +1,75 @@
+import React from 'react';
+import { a as KTX2Source, d as KTX2Storage, e as MemoryStrategy, c as KTX2LoadEvent, P as PlayerState } from './types-C6J2fa98.mjs';
+import 'range-source-web';
+
+/**
+ * AlphaVideoGpuPlayer - React-only Wrapper (no React Native dependency)
+ *
+ * GPU-accelerated transparent alpha video player.
+ *
+ * Usage:
+ *   import { AlphaVideoGpuPlayer } from 'alpha-video-gpu-web/react';
+ *
+ *   <AlphaVideoGpuPlayer
+ *     src="https://example.com/animation.ktx2"
+ *     width={300}
+ *     height={300}
+ *     autoPlay
+ *     loop
+ *   />
+ *
+ * Self-contained: the ZSTD decoder (JS + WASM) is bundled inline.
+ * No external files or <script> tags needed.
+ */
+
+interface AlphaVideoGpuPlayerProps {
+    /** The KTX2 file: a URL, a Blob or File, bytes in memory, or a ByteSource */
+    src?: KTX2Source;
+    /** Names the stored copy, for URLs that change while the file doesn't (presigned URLs) */
+    cacheKey?: string;
+    /** Sent with every request for a URL source, e.g. Authorization; a change doesn't reload */
+    headers?: Record<string, string>;
+    /** Where a URL's bytes are kept between plays. Default: 'auto' (OPFS, else IndexedDB). Read on mount */
+    storage?: KTX2Storage;
+    /** Cap on the stored bytes across clips. Default: 512 MB. Read on mount */
+    maxStorageBytes?: number;
+    /** Canvas width in pixels */
+    width?: number;
+    /** Canvas height in pixels */
+    height?: number;
+    /** CSS class for the canvas element */
+    className?: string;
+    /** Inline styles for the canvas element */
+    style?: React.CSSProperties;
+    autoPlay?: boolean;
+    loop?: boolean;
+    playbackSpeed?: number;
+    paused?: boolean;
+    stream?: boolean;
+    streamingPrefetchAhead?: number;
+    memoryStrategy?: MemoryStrategy;
+    /** Log info traces to the console. Default: false */
+    verbose?: boolean;
+    onLoad?: (event: KTX2LoadEvent) => void;
+    onStateChange?: (state: PlayerState) => void;
+    onFrameUpdate?: (frame: number, total: number) => void;
+    onFinished?: () => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Seeks show the frame (clamped to the clip) and keep playing, or stay paused. They are ignored
+ * until the source has loaded.
+ */
+interface AlphaVideoGpuPlayerRef {
+    /** Plays from the shown frame, or from the start once a clip that doesn't loop has finished. */
+    play: () => void;
+    pause: () => void;
+    /** Pauses on the first frame. */
+    stop: () => void;
+    seekToFrame: (frame: number) => void;
+    /** Seeks to the frame showing at that time, in seconds. */
+    seekToTime: (seconds: number) => void;
+}
+declare const AlphaVideoGpuPlayer: React.ForwardRefExoticComponent<AlphaVideoGpuPlayerProps & React.RefAttributes<AlphaVideoGpuPlayerRef>>;
+
+export { KTX2LoadEvent as AlphaVideoGpuLoadEvent, AlphaVideoGpuPlayer, type AlphaVideoGpuPlayerProps, type AlphaVideoGpuPlayerRef, KTX2Source as AlphaVideoGpuSource, KTX2Storage as AlphaVideoGpuStorage, MemoryStrategy, PlayerState };

package/dist/react.d.ts

@@ -0,0 +1,75 @@
+import React from 'react';
+import { a as KTX2Source, d as KTX2Storage, e as MemoryStrategy, c as KTX2LoadEvent, P as PlayerState } from './types-C6J2fa98.js';
+import 'range-source-web';
+
+/**
+ * AlphaVideoGpuPlayer - React-only Wrapper (no React Native dependency)
+ *
+ * GPU-accelerated transparent alpha video player.
+ *
+ * Usage:
+ *   import { AlphaVideoGpuPlayer } from 'alpha-video-gpu-web/react';
+ *
+ *   <AlphaVideoGpuPlayer
+ *     src="https://example.com/animation.ktx2"
+ *     width={300}
+ *     height={300}
+ *     autoPlay
+ *     loop
+ *   />
+ *
+ * Self-contained: the ZSTD decoder (JS + WASM) is bundled inline.
+ * No external files or <script> tags needed.
+ */
+
+interface AlphaVideoGpuPlayerProps {
+    /** The KTX2 file: a URL, a Blob or File, bytes in memory, or a ByteSource */
+    src?: KTX2Source;
+    /** Names the stored copy, for URLs that change while the file doesn't (presigned URLs) */
+    cacheKey?: string;
+    /** Sent with every request for a URL source, e.g. Authorization; a change doesn't reload */
+    headers?: Record<string, string>;
+    /** Where a URL's bytes are kept between plays. Default: 'auto' (OPFS, else IndexedDB). Read on mount */
+    storage?: KTX2Storage;
+    /** Cap on the stored bytes across clips. Default: 512 MB. Read on mount */
+    maxStorageBytes?: number;
+    /** Canvas width in pixels */
+    width?: number;
+    /** Canvas height in pixels */
+    height?: number;
+    /** CSS class for the canvas element */
+    className?: string;
+    /** Inline styles for the canvas element */
+    style?: React.CSSProperties;
+    autoPlay?: boolean;
+    loop?: boolean;
+    playbackSpeed?: number;
+    paused?: boolean;
+    stream?: boolean;
+    streamingPrefetchAhead?: number;
+    memoryStrategy?: MemoryStrategy;
+    /** Log info traces to the console. Default: false */
+    verbose?: boolean;
+    onLoad?: (event: KTX2LoadEvent) => void;
+    onStateChange?: (state: PlayerState) => void;
+    onFrameUpdate?: (frame: number, total: number) => void;
+    onFinished?: () => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Seeks show the frame (clamped to the clip) and keep playing, or stay paused. They are ignored
+ * until the source has loaded.
+ */
+interface AlphaVideoGpuPlayerRef {
+    /** Plays from the shown frame, or from the start once a clip that doesn't loop has finished. */
+    play: () => void;
+    pause: () => void;
+    /** Pauses on the first frame. */
+    stop: () => void;
+    seekToFrame: (frame: number) => void;
+    /** Seeks to the frame showing at that time, in seconds. */
+    seekToTime: (seconds: number) => void;
+}
+declare const AlphaVideoGpuPlayer: React.ForwardRefExoticComponent<AlphaVideoGpuPlayerProps & React.RefAttributes<AlphaVideoGpuPlayerRef>>;
+
+export { KTX2LoadEvent as AlphaVideoGpuLoadEvent, AlphaVideoGpuPlayer, type AlphaVideoGpuPlayerProps, type AlphaVideoGpuPlayerRef, KTX2Source as AlphaVideoGpuSource, KTX2Storage as AlphaVideoGpuStorage, MemoryStrategy, PlayerState };