@agrhub/engine-pixi 0.0.0-stage → 1.4.0

package/dist/utils/dom.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Create a new HTML element
+ * @param tagName - Tag name of the element to create
+ * @returns Newly created HTML element
+ */
+export declare function createEl(tagName: string): HTMLElement;
+/**
+ * Render text as an image
+ * @param text - Text to render
+ * @param cssText - CSS styles to apply to the text
+ * @returns Rendered image element
+ */
+export declare function renderTxt2Img(text: string, cssText: string, opts?: {
+    font?: {
+        name: string;
+        url: string;
+    };
+    onCreated?: (el: HTMLElement) => void;
+}): Promise<HTMLImageElement>;
+/**
+ * Render text as {@link ImageBitmap} for creating {@link Image}
+ * @param text - Text to render
+ * @param cssText - CSS styles to apply to the text
+ * @param opts - Options
+ * @param opts.font - Custom font
+ * @param opts.onCreated - Callback after creation
+ *
+ * // Example:
+ * new Image(
+ *   await renderTxt2ImgBitmap(
+ *     'Watermark',
+ *    `font-size:40px; color: white; text-shadow: 2px 2px 6px red; font-family: CustomFont;`,
+ *    {
+ *      font: {
+ *        name: 'CustomFont',
+ *        url: '/CustomFont.ttf',
+ *      },
+ *    },
+ *   )
+ * )
+ */
+export declare function renderTxt2ImgBitmap(text: string, cssText: string, opts?: {
+    font?: {
+        name: string;
+        url: string;
+    };
+    onCreated?: (el: HTMLElement) => void;
+}): Promise<ImageBitmap>;

package/dist/utils/effect.d.ts

@@ -0,0 +1 @@
+export declare function camelToWords(text: string): string;

package/dist/utils/fonts.d.ts

@@ -0,0 +1,21 @@
+export interface IFont {
+    name: string;
+    url: string;
+}
+export declare class FontManager {
+    private static instance;
+    private fonts;
+    /** In-flight loads, so concurrent addFont calls for one font share a single FontFace load */
+    private loading;
+    private warnedConflicts;
+    private constructor();
+    static getInstance(): FontManager;
+    addFont(font: IFont): Promise<void>;
+    /** The first registration of a name wins; a different URL for it is almost always a data bug */
+    private warnOnConflict;
+    loadFonts(fonts: IFont[]): Promise<void>;
+    removeFont(fontName: string): void;
+    clear(): void;
+    getLoadedFonts(): string[];
+}
+export declare const fontManager: FontManager;

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './audio';
+export * from './audio-codec-detector';
+export * from './chromakey';
+export * from './common';
+export * from './dom';
+export * from './video';

package/dist/utils/log.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Global logging utility.
+ */
+export declare const Log: {
+    debug: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    /**
+     * Sets the logging threshold. Only logs at this level or higher will be recorded.
+     * @example Log.setLogLevel(Log.warn) // Only warn and error will be logged
+     */
+    setLogLevel: <T extends Function>(logfn: T) => void;
+    /**
+     * Creates a logger instance that prefixes all messages with a tag.
+     */
+    create: (tag: string) => {
+        debug: (...args: any[]) => void;
+        info: (...args: any[]) => void;
+        warn: (...args: any[]) => void;
+        error: (...args: any[]) => void;
+    };
+    /**
+     * Dumps the log history as a string.
+     */
+    dump: () => Promise<string>;
+};

package/dist/utils/media-cache.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Shared media cache for video/audio/image/font bytes.
+ *
+ * Every consumer (clip creation, preload, split/duplicate, export Compositor, app timeline
+ * thumbnails/waveforms) gets the same bytes for a URL:
+ *  1. in-flight requests are shared (one network fetch per URL at a time),
+ *  2. completed downloads stay in an in-memory LRU of Blobs (byte budget; browsers keep large
+ *     Blobs in their blob store, not the JS heap),
+ *  3. remote URLs are persisted to OPFS (AssetManager) for later sessions.
+ *
+ * It is a globalThis singleton so duplicated bundle copies share one cache.
+ */
+export interface MediaCacheOptions {
+    /** Total bytes kept in memory (default 768 MB) */
+    maxMemoryBytes?: number;
+    /** Larger entries are not kept in memory, only in OPFS (default 400 MB) */
+    maxEntryBytes?: number;
+}
+export declare class MediaCache {
+    private memory;
+    private memoryBytes;
+    private inflight;
+    private maxMemoryBytes;
+    private maxEntryBytes;
+    constructor(opts?: MediaCacheOptions);
+    configure(opts: MediaCacheOptions): void;
+    /** Cache key: absolute URL (relative paths resolve against the page) */
+    key(url: string): string;
+    /** Bytes for a URL, from memory, an in-flight request, OPFS, or the network (in that order) */
+    getBlob(url: string): Promise<Blob>;
+    getStream(url: string): Promise<ReadableStream<Uint8Array>>;
+    /** A fresh ImageBitmap per call (callers own and may close it); the bytes are shared */
+    getImageBitmap(url: string): Promise<ImageBitmap>;
+    getArrayBuffer(url: string): Promise<ArrayBuffer>;
+    /** Warm the cache; resolves once every URL is loaded (failures are ignored) */
+    preload(urls: string[]): Promise<void>;
+    has(url: string): boolean;
+    /** Forget a URL in memory (OPFS copy stays) */
+    release(url: string): void;
+    clearMemory(): void;
+    private load;
+    private remember;
+    private evict;
+}
+export declare const mediaCache: MediaCache;

package/dist/utils/stream-utils.d.ts

@@ -0,0 +1,4 @@
+export declare function autoReadStream<ST extends ReadableStream>(stream: ST, cbs: {
+    onChunk: ST extends ReadableStream<infer DT> ? (chunk: DT) => Promise<void> : never;
+    onDone: () => void;
+}): () => void;

package/dist/utils/video.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Decode image stream, return an array of video frames.
+ *
+ * @param stream - Readable stream containing image data.
+ * @param type - MIME type of the image, e.g. 'image/jpeg'.
+ *
+ * @returns Returns a Promise that resolves to an array of {@link VideoFrame} after decoding completes.
+ *
+ * @example
+ *
+ * const frames = await decodeImg(
+ *   (await fetch('<gif url>')).body!,
+ *   `image/gif`,
+ * );
+ */
+export declare function decodeImg(stream: ReadableStream<Uint8Array>, type: string): Promise<VideoFrame[]>;

package/dist/utils/worker-timer.d.ts

@@ -0,0 +1 @@
+export declare const workerTimer: (handler: () => void, time: number) => (() => void);

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@agrhub/engine-pixi",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "PixiJS/WebCodecs rendering engine for the AgrHub video editor (fork of @openvideo/engine-pixi)",
+  "version": "1.4.0",
+  "keywords": [
+    "mp4",
+    "rendering",
+    "video",
+    "webcodecs"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "AgrHub (fork of OpenVideo by OpenVideoDev)",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "NOTICE.md"
+  ],
+  "type": "module",
+  "main": "dist/index.umd.cjs",
+  "module": "dist/index.es.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.umd.cjs"
+    },
+    "./standalone": "./dist/standalone/index.es.js",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": true,
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "dependencies": {
+    "@pixi/layout": "^3.2.0",
+    "@types/dom-webcodecs": "^0.1.17",
+    "gl-transitions": "^1.43.0",
+    "gsap": "^3.12.7",
+    "mediabunny": "^1.26.0",
+    "microdiff": "^1.4.0",
+    "nanoid": "^5.0.7",
+    "opfs-tools": "^0.7.2",
+    "pixi-filters": "^6.1.5",
+    "pixi.js": "^8.14.3",
+    "wave-resampler": "^1.0.0",
+    "wrapbox": "^0.1.0",
+    "@agrhub/core": "^1.4.0"
+  },
+  "devDependencies": {
+    "@vitest/browser": "^4.0.18",
+    "@vitest/browser-playwright": "^4.0.18",
+    "@vitest/ui": "^4.0.18",
+    "jsdom": "^27.4.0",
+    "typescript": "~5.9.2",
+    "vite": "^7.1.5",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc --noEmit && vite build && vite build --config vite.standalone.config.ts",
+    "test": "vitest run"
+  }
 }