@hyperframes/producer 0.8.204 → 0.8.206

package/dist/services/animatedGifPrep.d.ts

@@ -30,6 +30,12 @@ export interface PrepareAnimatedGifInputsResult {
     preparedAssets: Map<string, string>;
     preparedGifs: PreparedAnimatedGif[];
 }
+export declare function splitUrlSuffix(src: string): {
+    basePath: string;
+    suffix: string;
+};
+export declare function normalizeRelPath(path: string): string;
+export declare function resolveLocalImageSourcePath(src: string, options: Pick<PrepareAnimatedGifInputsOptions, "projectDir" | "downloadDir" | "sourceAssets">): string | null;
 export declare function buildAnimatedGifTranscodeArgs(input: {
     inputPath: string;
     outputPath: string;

package/dist/services/assetMediaType.d.ts

@@ -15,6 +15,7 @@ export declare class AssetMediaTypeMismatchError extends Error {
     readonly mismatches: readonly AssetMediaTypeMismatch[];
     constructor(mismatches: readonly AssetMediaTypeMismatch[]);
 }
+export declare function mediaProfileMatchesElementType(expected: AssetElementMediaType, profile: MediaProbeProfile): boolean;
 export declare function assertAssetMediaTypeProfile(expected: AssetElementMediaType, profile: MediaProbeProfile, elementIdentity: string): void;
 interface CompositionMediaAssets {
     videos: readonly VideoElement[];

package/dist/services/heifImagePrep.d.ts

@@ -0,0 +1,69 @@
+export declare const HEIF_IMAGE_CONVERSION_FAILED: "HEIF_IMAGE_CONVERSION_FAILED";
+export declare class HeifImageConversionError extends Error {
+    readonly code: "HEIF_IMAGE_CONVERSION_FAILED";
+    readonly owner: "user";
+    readonly retryable: false;
+    constructor(label: string, reason: string);
+}
+/** The host's ffmpeg or ffprobe cannot do the job; a different photo would not help. */
+export declare class HeifToolUnavailableError extends Error {
+    readonly code: "HEIF_TOOL_UNAVAILABLE";
+    readonly owner: "system";
+    readonly retryable: false;
+    constructor(label: string, reason: string);
+}
+export interface HeifTranscodeRequest {
+    inputPath: string;
+    outputPath: string;
+    timeoutMs?: number;
+}
+export interface PrepareHeifImageInputsOptions {
+    projectDir: string;
+    downloadDir: string;
+    outputDir?: string;
+    outputSrcPrefix?: string;
+    cacheDir?: string;
+    sourceAssets?: Map<string, string>;
+    timeoutMs?: number;
+    transcode?: (input: HeifTranscodeRequest) => Promise<void>;
+    /** Leaves an image whose conversion failed as authored and reports it, instead of throwing. */
+    onFailure?: (error: HeifImageConversionError | HeifToolUnavailableError) => void;
+}
+export interface PreparedHeifImage {
+    sourceSrc: string;
+    outputSrc: string;
+    outputPath: string;
+}
+export interface PrepareHeifImageInputsResult {
+    html: string;
+    preparedAssets: Map<string, string>;
+    preparedImages: PreparedHeifImage[];
+}
+/** True when the leading bytes are a HEIF file by its `ftyp` brands, and not an AVIF one. */
+export declare function isHeifBytes(head: Uint8Array): boolean;
+export interface ProbedStream {
+    width?: number;
+    height?: number;
+    coded_width?: number;
+    coded_height?: number;
+    horizontal_offset?: number;
+    vertical_offset?: number;
+    subcomponents?: {
+        stream_index: number;
+        tile_horizontal_offset: number;
+        tile_vertical_offset: number;
+    }[];
+}
+export interface ProbeJson {
+    streams?: ProbedStream[];
+    stream_groups?: {
+        components?: ProbedStream[];
+        disposition?: {
+            default?: number;
+        };
+    }[];
+}
+/** The primary item's grid: the group ffmpeg marks default, so an auxiliary grid listed first is skipped. */
+export declare function primaryGrid(probed: ProbeJson): ProbedStream | undefined;
+export declare function convertHeifToJpeg(request: HeifTranscodeRequest): Promise<void>;
+export declare function prepareHeifImageInputs(html: string, options: PrepareHeifImageInputsOptions): Promise<PrepareHeifImageInputsResult>;

package/dist/services/heifRotation.d.ts

@@ -0,0 +1,2 @@
+/** Counter-clockwise degrees of the primary item's `irot` property; 0 when none or unreadable. */
+export declare function readHeifPrimaryRotation(buf: Buffer): 0 | 90 | 180 | 270;

package/dist/services/htmlCompiler.d.ts

@@ -175,10 +175,7 @@ export interface CompileForRenderOptions {
     allowSystemFontCapture?: boolean;
     /** Caller cancellation propagated through compile-time font fetches. */
     abortSignal?: AbortSignal;
-    /**
-     * Optional persistent cache directory for prep-time animated GIF → WebM
-     * transcodes. When omitted, the render's downloadDir is used.
-     */
+    /** Persistent cache directory for the animated GIF and HEIC prep transcodes; defaults to downloadDir. */
     animatedGifCacheDir?: string;
     /** FFmpeg timeout for animated GIF transcodes. */
     ffmpegProcessTimeout?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.204",
+  "version": "0.8.206",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
@@ -35,11 +35,11 @@
     "postcss": "^8.4.0",
     "puppeteer": "^25.2.1",
     "puppeteer-core": "^25.2.1",
-    "@hyperframes/engine": "0.8.204",
-    "@hyperframes/lint": "0.8.204",
-    "@hyperframes/core": "0.8.204",
-    "@hyperframes/parsers": "0.8.204",
-    "@hyperframes/studio-server": "0.8.204"
+    "@hyperframes/core": "0.8.206",
+    "@hyperframes/parsers": "0.8.206",
+    "@hyperframes/lint": "0.8.206",
+    "@hyperframes/studio-server": "0.8.206",
+    "@hyperframes/engine": "0.8.206"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",
@@ -48,7 +48,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.7.2",
     "vitest": "^4.1.11",
-    "@hyperframes/aws-lambda": "0.8.204"
+    "@hyperframes/aws-lambda": "0.8.206"
   },
   "engines": {
     "node": ">=22"