@give-tech/ec-player 0.0.1-beta.0

package/dist/prefetch/SegmentPrefetcher.d.ts

@@ -0,0 +1,116 @@
+/**
+ * 分片预取器（用于 HLS）
+ *
+ * 管理分片下载队列，支持 TS 和 fMP4 格式
+ */
+import { BasePrefetcher } from './BasePrefetcher';
+import type { SegmentPrefetcherConfig, PrefetcherStatus, PrefetcherCallbacks, PrefetchQueueItem } from './types';
+/**
+ * 分片信息
+ */
+export interface SegmentInfo {
+    /** 分片 URI */
+    uri: string;
+    /** 分片时长（秒） */
+    duration: number;
+    /** 字节范围（可选，用于 fMP4） */
+    byteRange?: {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * 分片预取器状态
+ */
+export interface SegmentPrefetcherStatus extends PrefetcherStatus {
+    /** 当前分片索引 */
+    currentSegmentIndex: number;
+    /** 总分片数 */
+    totalSegments: number;
+    /** 预取队列大小 */
+    prefetchQueueSize: number;
+}
+/**
+ * 分片预取器回调
+ */
+export interface SegmentPrefetcherCallbacks extends PrefetcherCallbacks {
+    /** 分片下载完成回调 */
+    onSegmentFetched?: (segmentIndex: number, data: Uint8Array) => void;
+    /** 分片解析完成回调 */
+    onSegmentParsed?: (segmentIndex: number, itemCount: number) => void;
+}
+/**
+ * 分片预取器
+ *
+ * 用于 HLS 流的分片预取，支持：
+ * - TS 分片
+ * - fMP4 分片（支持字节范围）
+ */
+export declare abstract class SegmentPrefetcher extends BasePrefetcher<SegmentPrefetcherConfig, SegmentPrefetcherStatus> {
+    /** 预取队列：存储已下载但尚未解析的分片 */
+    protected prefetchQueue: PrefetchQueueItem[];
+    /** 分片列表 */
+    protected segments: SegmentInfo[];
+    /** 当前分片索引 */
+    protected currentSegmentIndex: number;
+    /** 基础 URL（用于解析相对路径） */
+    protected baseUrl: string;
+    /** 正在预取标志 */
+    protected isPrefetchingSegment: boolean;
+    constructor(config: SegmentPrefetcherConfig, callbacks?: SegmentPrefetcherCallbacks);
+    /**
+     * 创建初始状态
+     */
+    protected createInitialState(): SegmentPrefetcherStatus;
+    /**
+     * 设置分片列表
+     */
+    setSegments(segments: SegmentInfo[], baseUrl: string): void;
+    /**
+     * 设置当前分片索引（用于 seek）
+     */
+    setCurrentSegmentIndex(index: number): void;
+    /**
+     * 获取当前队列大小（返回预取队列大小）
+     */
+    getQueueSize(): number;
+    /**
+     * 判断是否应该预取
+     */
+    shouldPrefetch(): boolean;
+    /**
+     * 执行预取
+     */
+    doPrefetch(): Promise<void>;
+    /**
+     * 处理预取队列中的数据
+     *
+     * @returns 是否有数据被处理
+     */
+    processQueue(): boolean;
+    /**
+     * 重置状态
+     */
+    doReset(): void;
+    /**
+     * 获取当前分片索引
+     */
+    getCurrentSegmentIndex(): number;
+    /**
+     * 获取总分片数
+     */
+    getTotalSegments(): number;
+    /**
+     * 获取分片数据（子类实现具体下载逻辑）
+     */
+    abstract fetchSegment(segment: SegmentInfo, index: number): Promise<Uint8Array>;
+    /**
+     * 解析分片数据（子类实现具体解析逻辑）
+     *
+     * @param data 分片数据
+     * @param index 分片索引
+     * @returns 解析出的项目数量
+     */
+    abstract parseSegment(data: Uint8Array, index: number): number;
+}
+//# sourceMappingURL=SegmentPrefetcher.d.ts.map

package/dist/prefetch/SegmentPrefetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentPrefetcher.d.ts","sourceRoot":"","sources":["../../src/prefetch/SegmentPrefetcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EAElB,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa;IACb,GAAG,EAAE,MAAM,CAAA;IACX,cAAc;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,uBAAuB;IACvB,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,aAAa;IACb,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW;IACX,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa;IACb,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,eAAe;IACf,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;IACnE,eAAe;IACf,eAAe,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;CACpE;AAED;;;;;;GAMG;AACH,8BAAsB,iBAAkB,SAAQ,cAAc,CAC5D,uBAAuB,EACvB,uBAAuB,CACxB;IACC,yBAAyB;IACzB,SAAS,CAAC,aAAa,EAAE,iBAAiB,EAAE,CAAK;IAEjD,WAAW;IACX,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAK;IAEtC,aAAa;IACb,SAAS,CAAC,mBAAmB,SAAI;IAEjC,uBAAuB;IACvB,SAAS,CAAC,OAAO,SAAK;IAEtB,aAAa;IACb,SAAS,CAAC,oBAAoB,UAAQ;gBAGpC,MAAM,EAAE,uBAAuB,EAC/B,SAAS,GAAE,0BAA+B;IAK5C;;OAEG;cACgB,kBAAkB,IAAI,uBAAuB;IAShE;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAa3D;;OAEG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAW3C;;OAEG;IACM,YAAY,IAAI,MAAM;IAI/B;;OAEG;IACM,cAAc,IAAI,OAAO;IAgBlC;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C1C;;;;OAIG;IACH,YAAY,IAAI,OAAO;IAoCvB;;OAEG;IACM,OAAO,IAAI,IAAI;IAQxB;;OAEG;IACH,sBAAsB,IAAI,MAAM;IAIhC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAM1B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAE/E;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAC/D"}

package/dist/prefetch/StreamPrefetcher.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 流式预取器（用于 FLV）
+ *
+ * 管理 ReadableStream 下载，支持动态扩容缓冲区
+ */
+import { BasePrefetcher } from './BasePrefetcher';
+import type { StreamPrefetcherConfig, PrefetcherStatus, PrefetcherCallbacks, DownloadBufferInfo } from './types';
+/**
+ * 流式预取器状态
+ */
+export interface StreamPrefetcherStatus extends PrefetcherStatus {
+    /** 缓冲区使用量 */
+    bufferLength: number;
+    /** 缓冲区容量 */
+    bufferCapacity: number;
+    /** 是否已完成下载 */
+    downloadComplete: boolean;
+}
+/**
+ * 流式预取器回调
+ */
+export interface StreamPrefetcherCallbacks extends PrefetcherCallbacks {
+    /** 数据到达回调 */
+    onDataReceived?: (totalBytes: number) => void;
+    /** 缓冲区处理回调 */
+    onBufferProcessed?: (processedBytes: number) => void;
+}
+/**
+ * 流式预取器
+ *
+ * 用于 FLV 流的流式预取，支持：
+ * - 动态扩容缓冲区
+ * - ReadableStream 读取
+ * - 增量解析
+ */
+export declare abstract class StreamPrefetcher extends BasePrefetcher<StreamPrefetcherConfig, StreamPrefetcherStatus> {
+    /** 下载缓冲区 */
+    protected downloadBuffer: Uint8Array | null;
+    /** 已使用的缓冲区长度 */
+    protected bufferLength: number;
+    /** 流读取器 */
+    protected reader: ReadableStreamDefaultReader<Uint8Array> | null;
+    /** 下载完成标志 */
+    protected downloadComplete: boolean;
+    /** 下载 Promise */
+    protected downloadPromise: Promise<void> | null;
+    /** 总下载字节数 */
+    protected totalDownloadedBytes: number;
+    constructor(config: StreamPrefetcherConfig, callbacks?: StreamPrefetcherCallbacks);
+    /**
+     * 创建初始状态
+     */
+    protected createInitialState(): StreamPrefetcherStatus;
+    /**
+     * 设置流读取器
+     */
+    setReader(reader: ReadableStreamDefaultReader<Uint8Array>, initialData?: Uint8Array): void;
+    /**
+     * 确保缓冲区有足够的容量
+     */
+    protected ensureCapacity(needed: number): void;
+    /**
+     * 获取当前队列大小（使用缓冲区长度）
+     */
+    getQueueSize(): number;
+    /**
+     * 判断是否应该预取
+     */
+    shouldPrefetch(): boolean;
+    /**
+     * 执行预取（从流读取数据）
+     */
+    doPrefetch(): Promise<void>;
+    /**
+     * 处理缓冲区数据
+     *
+     * @returns 是否有数据被处理
+     */
+    processBuffer(): boolean;
+    /**
+     * 获取缓冲区信息
+     */
+    getBufferInfo(): DownloadBufferInfo;
+    /**
+     * 获取缓冲区数据（复制）
+     */
+    getBufferData(): Uint8Array | null;
+    /**
+     * 重置状态
+     */
+    doReset(): void;
+    /**
+     * 取消下载
+     */
+    cancelDownload(): void;
+    /**
+     * 是否下载完成
+     */
+    isDownloadComplete(): boolean;
+    /**
+     * 处理缓冲区数据（子类实现具体解析逻辑）
+     *
+     * @param data 当前缓冲区数据
+     * @returns 处理结果
+     */
+    abstract processBufferData(data: Uint8Array): {
+        /** 是否有新数据 */
+        hasNewData: boolean;
+        /** 已处理的字节数 */
+        processedBytes: number;
+    };
+}
+//# sourceMappingURL=StreamPrefetcher.d.ts.map

package/dist/prefetch/StreamPrefetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamPrefetcher.d.ts","sourceRoot":"","sources":["../../src/prefetch/StreamPrefetcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAEnB,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,aAAa;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY;IACZ,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc;IACd,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,aAAa;IACb,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,cAAc;IACd,iBAAiB,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAA;CACrD;AAED;;;;;;;GAOG;AACH,8BAAsB,gBAAiB,SAAQ,cAAc,CAC3D,sBAAsB,EACtB,sBAAsB,CACvB;IACC,YAAY;IACZ,SAAS,CAAC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAO;IAElD,gBAAgB;IAChB,SAAS,CAAC,YAAY,SAAI;IAE1B,WAAW;IACX,SAAS,CAAC,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAAG,IAAI,CAAO;IAEvE,aAAa;IACb,SAAS,CAAC,gBAAgB,UAAQ;IAElC,iBAAiB;IACjB,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAO;IAEtD,aAAa;IACb,SAAS,CAAC,oBAAoB,SAAI;gBAGhC,MAAM,EAAE,sBAAsB,EAC9B,SAAS,GAAE,yBAA8B;IAK3C;;OAEG;cACgB,kBAAkB,IAAI,sBAAsB;IAS/D;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,IAAI;IA+B1F;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAyB9C;;OAEG;IACM,YAAY,IAAI,MAAM;IAI/B;;OAEG;IACM,cAAc,IAAI,OAAO;IAWlC;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C1C;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAoBxB;;OAEG;IACH,aAAa,IAAI,kBAAkB;IAQnC;;OAEG;IACH,aAAa,IAAI,UAAU,GAAG,IAAI;IAOlC;;OAEG;IACM,OAAO,IAAI,IAAI;IASxB;;OAEG;IACH,cAAc,IAAI,IAAI;IAUtB;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAM7B;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG;QAC5C,aAAa;QACb,UAAU,EAAE,OAAO,CAAA;QACnB,cAAc;QACd,cAAc,EAAE,MAAM,CAAA;KACvB;CACF"}

package/dist/prefetch/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 预取器模块
+ *
+ * 提供通用的预取抽象层，支持分片预取（HLS）和流式预取（FLV）
+ */
+export { BasePrefetcher } from './BasePrefetcher';
+export { SegmentPrefetcher } from './SegmentPrefetcher';
+export type { SegmentInfo, SegmentPrefetcherStatus, SegmentPrefetcherCallbacks } from './SegmentPrefetcher';
+export { StreamPrefetcher } from './StreamPrefetcher';
+export type { StreamPrefetcherStatus, StreamPrefetcherCallbacks } from './StreamPrefetcher';
+export type { PrefetcherConfig, PrefetcherStatus, PrefetcherCallbacks, SegmentPrefetcherConfig, StreamPrefetcherConfig, PrefetchQueueItem, DownloadBufferInfo } from './types';
+export { DEFAULT_PREFETCHER_CONFIG, DEFAULT_SEGMENT_PREFETCHER_CONFIG, DEFAULT_STREAM_PREFETCHER_CONFIG } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/prefetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prefetch/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EACV,WAAW,EACX,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EACV,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,oBAAoB,CAAA;AAG3B,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,SAAS,CAAA;AAEhB,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,gCAAgC,EACjC,MAAM,SAAS,CAAA"}

package/dist/prefetch/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 预取器类型定义
+ *
+ * 定义通用的预取器配置、状态和回调接口
+ */
+/**
+ * 预取器配置
+ */
+export interface PrefetcherConfig {
+    /** 低水位：队列低于此值开始预取 */
+    lowWaterMark: number;
+    /** 高水位：队列达到此值暂停预取 */
+    highWaterMark: number;
+    /** 预取间隔（毫秒） */
+    prefetchInterval: number;
+    /** 是否启用动态间隔调整 */
+    dynamicInterval: boolean;
+}
+/**
+ * 预取器状态
+ */
+export interface PrefetcherStatus {
+    /** 是否正在预取 */
+    isPrefetching: boolean;
+    /** 当前队列大小 */
+    queueSize: number;
+    /** 下载速度 (KB/s) */
+    downloadSpeed: number;
+    /** 已预取的总字节数 */
+    totalBytes: number;
+    /** 预取错误信息 */
+    lastError?: string;
+}
+/**
+ * 预取器回调
+ */
+export interface PrefetcherCallbacks {
+    /** 状态变化回调 */
+    onStatusChange?: (status: PrefetcherStatus) => void;
+    /** 预取完成回调 */
+    onPrefetchComplete?: (bytesFetched: number) => void;
+    /** 错误回调 */
+    onError?: (error: Error) => void;
+}
+/**
+ * 默认预取器配置
+ */
+export declare const DEFAULT_PREFETCHER_CONFIG: PrefetcherConfig;
+/**
+ * 分片预取器配置（扩展基础配置）
+ */
+export interface SegmentPrefetcherConfig extends PrefetcherConfig {
+    /** 提前预取的分片数量 */
+    prefetchAhead: number;
+}
+/**
+ * 默认分片预取器配置
+ */
+export declare const DEFAULT_SEGMENT_PREFETCHER_CONFIG: SegmentPrefetcherConfig;
+/**
+ * 流式预取器配置（扩展基础配置）
+ */
+export interface StreamPrefetcherConfig extends PrefetcherConfig {
+    /** 初始缓冲区大小 */
+    initialBufferSize: number;
+}
+/**
+ * 默认流式预取器配置
+ */
+export declare const DEFAULT_STREAM_PREFETCHER_CONFIG: StreamPrefetcherConfig;
+/**
+ * 预取队列项（分片模式）
+ */
+export interface PrefetchQueueItem {
+    /** 分片数据 */
+    data: Uint8Array;
+    /** 分片索引 */
+    segmentIndex: number;
+    /** 获取时间 */
+    fetchTime: number;
+}
+/**
+ * 下载缓冲区信息（流式模式）
+ */
+export interface DownloadBufferInfo {
+    /** 缓冲区 */
+    buffer: Uint8Array | null;
+    /** 已使用长度 */
+    length: number;
+    /** 总容量 */
+    capacity: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/prefetch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prefetch/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB;IACjB,eAAe,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa;IACb,aAAa,EAAE,OAAO,CAAA;IACtB,aAAa;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,kBAAkB;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa;IACb,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;IACnD,aAAa;IACb,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;IACnD,WAAW;IACX,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAKvC,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,gBAAgB;IAChB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,iCAAiC,EAAE,uBAG/C,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,cAAc;IACd,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,gCAAgC,EAAE,sBAK9C,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,IAAI,EAAE,UAAU,CAAA;IAChB,WAAW;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW;IACX,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU;IACV,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IACzB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,UAAU;IACV,QAAQ,EAAE,MAAM,CAAA;CACjB"}

package/dist/renderer/Canvas2DRenderer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Canvas 2D 渲染器
+ */
+import type { VideoFrame } from '../types';
+export declare class Canvas2DRenderer {
+    private canvas;
+    private ctx;
+    private frameCount;
+    private lastFpsUpdate;
+    private lastFps;
+    constructor(canvas: HTMLCanvasElement);
+    render(frame: VideoFrame): void;
+    updateFps(): number;
+    getCanvas(): HTMLCanvasElement;
+}
+//# sourceMappingURL=Canvas2DRenderer.d.ts.map

package/dist/renderer/Canvas2DRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Canvas2DRenderer.d.ts","sourceRoot":"","sources":["../../src/renderer/Canvas2DRenderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,GAAG,CAAwC;IACnD,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,OAAO,CAAI;gBAEP,MAAM,EAAE,iBAAiB;IAQrC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAY/B,SAAS,IAAI,MAAM;IAWnB,SAAS,IAAI,iBAAiB;CAG/B"}

package/dist/renderer/index.d.ts

@@ -0,0 +1,2 @@
+export { Canvas2DRenderer } from './Canvas2DRenderer';
+//# sourceMappingURL=index.d.ts.map

package/dist/renderer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/renderer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 核心类型定义
+ */
+export interface VideoFrame {
+    width: number;
+    height: number;
+    data: Uint8Array;
+}
+export interface NALUnit {
+    type: number;
+    data: Uint8Array;
+    size: number;
+}
+export interface HLSPlayerConfig {
+    /** WASM 文件路径 */
+    wasmPath?: string;
+    /** 帧缓冲区目标大小 - 控制缓冲的最大帧数 */
+    targetBufferSize?: number;
+    /** 每批解码帧数 - 批量解码后再让出主线程 */
+    decodeBatchSize?: number;
+    /** NAL/Sample 队列上限 - 超过则暂停下载 */
+    maxQueueSize?: number;
+    /** 是否为直播流 - 直播流会持续下载数据 */
+    isLive?: boolean;
+}
+export interface PlayerState {
+    isPlaying: boolean;
+    isLoaded: boolean;
+    isLoading: boolean;
+    fps: number;
+    resolution: string;
+    decoded: number;
+    downloaded: number;
+    droppedFrames: number;
+    isPrefetching: boolean;
+    segmentIndex: number;
+    totalSegments: number;
+    downloadSpeed: number;
+    currentTime: number;
+    duration: number;
+}
+export interface PlayerCallbacks {
+    onFrameRender?: (frame: VideoFrame) => void;
+    onStateChange?: (state: Partial<PlayerState>) => void;
+    onError?: (error: Error) => void;
+}
+export interface WASMModule {
+    _create_decoder(codecId: number): number;
+    _decode_video(ctx: number, data: number, size: number): number;
+    _set_extradata(ctx: number, data: number, size: number): number;
+    _get_frame_data(ctx: number, plane: number): number;
+    _get_frame_width(ctx: number): number;
+    _get_frame_height(ctx: number): number;
+    _get_frame_linesize(ctx: number, plane: number): number;
+    _malloc(size: number): number;
+    _free(ptr: number): void;
+    HEAPU8: Uint8Array;
+}
+export type DecoderContext = number;
+export declare const NAL_TYPES: {
+    readonly SLICE: 1;
+    readonly IDR: 5;
+    readonly SEI: 6;
+    readonly SPS: 7;
+    readonly PPS: 8;
+    readonly AUD: 9;
+};
+export type NALType = typeof NAL_TYPES[keyof typeof NAL_TYPES];
+export declare const FLV_TAG_TYPES: {
+    readonly AUDIO: 8;
+    readonly VIDEO: 9;
+    readonly SCRIPT_DATA: 18;
+};
+export declare const AVC_PACKET_TYPES: {
+    readonly SEQUENCE_HEADER: 0;
+    readonly NALU: 1;
+    readonly END_OF_SEQUENCE: 2;
+};
+export interface FLVVideoTag {
+    timestamp: number;
+    frameType: number;
+    codecId: number;
+    avcPacketType: number;
+    compositionTimeOffset: number;
+    data: Uint8Array;
+}
+export interface FLVAVCConfig {
+    configurationVersion: number;
+    avcProfileIndication: number;
+    profileCompatibility: number;
+    avcLevelIndication: number;
+    lengthSizeMinusOne: number;
+    spsList: Uint8Array[];
+    ppsList: Uint8Array[];
+}
+export interface FLVHEVCConfig {
+    configurationVersion: number;
+    general_profile_space: number;
+    general_tier_flag: number;
+    general_profile_idc: number;
+    general_profile_compatibility_flags: number;
+    general_constraint_indicator_flags: bigint;
+    general_level_idc: number;
+    lengthSizeMinusOne: number;
+    vpsList: Uint8Array[];
+    spsList: Uint8Array[];
+    ppsList: Uint8Array[];
+}
+export interface FLVParseResult {
+    videoTags: FLVVideoTag[];
+    avcConfig: FLVAVCConfig | null;
+    hevcConfig: FLVHEVCConfig | null;
+    duration: number;
+}
+export interface FLVPlayerConfig extends HLSPlayerConfig {
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { LogLevel, setLogLevel, getLogLevel, createLogger, logger } from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 日志级别
+ */
+export declare enum LogLevel {
+    NONE = 0,
+    ERROR = 1,
+    WARN = 2,
+    INFO = 3,
+    DEBUG = 4
+}
+/**
+ * 设置全局日志级别
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * 获取当前日志级别
+ */
+export declare function getLogLevel(): LogLevel;
+/**
+ * 创建带模块名的日志器
+ */
+export declare function createLogger(moduleName: string): {
+    error: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+    log: (...args: any[]) => void;
+};
+export declare const logger: {
+    error: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+    log: (...args: any[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAaD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM;qBAI1B,GAAG,EAAE;oBAMN,GAAG,EAAE;oBAML,GAAG,EAAE;qBAMJ,GAAG,EAAE;mBAMP,GAAG,EAAE;EAOvB;AAGD,eAAO,MAAM,MAAM;qBAlCE,GAAG,EAAE;oBAMN,GAAG,EAAE;oBAML,GAAG,EAAE;qBAMJ,GAAG,EAAE;mBAMP,GAAG,EAAE;CAUsB,CAAA"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@give-tech/ec-player",
+  "version": "0.0.1-beta.0",
+  "description": "EcPlayer Core - HLS/FLV Streaming Video Player with WASM Decoder",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./wasm/*": "./wasm/*"
+  },
+  "files": [
+    "dist",
+    "wasm"
+  ],
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1"
+  },
+  "keywords": [
+    "hls",
+    "flv",
+    "video",
+    "player",
+    "wasm",
+    "simd",
+    "streaming",
+    "h264",
+    "decoder"
+  ],
+  "author": {
+    "name": "polarIsle",
+    "email": "givetech@126.com"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}