Files
hypit/packages/composition/test/render.test.ts

157 lines
6.3 KiB
TypeScript

import assert from "node:assert/strict";
import test from "node:test";
import { fixtureResource } from "../../../test/fixture-resource.js";
import { frameSamplingMapFixture } from "../../../test/temporal-fixture.js";
import {
assertCompositableSurfaceRef,
assertFontArtifactRef,
} from "@hypit/media";
import type { CompositableSurfaceRef, FontArtifactRef } from "@hypit/media";
import { sealTimeline } from "@hypit/timeline";
import {
assertCompositionIdentity,
sealComposition,
sealPresentVisualTrack,
} from "../src/index.js";
import type { PresentVisualTrack, VisualTrack } from "../src/index.js";
const space = sealTimeline({ id: "test-space", frameCount: 60, frameRate: { numerator: 30, denominator: 1 },
});
const font: FontArtifactRef = {
sources: [{ artifact: {
kind: "blob",
resource: fixtureResource("font:inter-bold"),
size: 1_024,
mediaType: "font/woff2",
} }],
weight: 700,
style: "normal",
};
const animatedSurface: CompositableSurfaceRef = {
artifact: {
kind: "blob",
resource: fixtureResource("surface:alpha-webm"),
size: 2_048,
mediaType: "video/webm",
},
width: 1080,
height: 1920,
picture: { colorPrimaries: "bt709", colorTransfer: "srgb", colorMatrix: "rgb", colorRange: "full", bitDepth: 8, alphaMode: "straight" } as const,
timing: {
kind: "frames",
frameRate: { numerator: 30, denominator: 1 },
frameCount: 60,
},
};
test("FontArtifactRef binds one exact font face to a Resource Blob", () => {
assert.doesNotThrow(() => assertFontArtifactRef(font));
assert.throws(
() => assertFontArtifactRef({
...font,
sources: [{ artifact: { ...font.sources[0]!.artifact, mediaType: "application/octet-stream" } }],
}),
/supported font media type/u,
);
assert.throws(() => assertFontArtifactRef({ ...font, weight: 0 }), /weight/u);
});
test("CompositableSurfaceRef distinguishes a typed alpha surface from an ordinary media guess", () => {
assert.doesNotThrow(() => assertCompositableSurfaceRef(animatedSurface));
assert.throws(
() => assertCompositableSurfaceRef({
...animatedSurface,
artifact: { ...animatedSurface.artifact, mediaType: "video/mp4" },
}),
/straight alpha requires/u,
);
assert.throws(
() => assertCompositableSurfaceRef({
...animatedSurface,
artifact: { ...animatedSurface.artifact, mediaType: "image/png" },
}),
/frame timing requires a video/u,
);
});
test("typed text owns exact font selection without renderer CSS", () => {
const valid = sealPresentVisualTrack({ timelineId: "test-space",
id: "invalid-font-track",
presents: [{
id: "title",
span: { startFrame: 0, endFrameExclusive: 60 },
root: {
id: "title",
kind: "text",
text: "SVML",
fonts: [font],
},
}],
});
assert.doesNotThrow(() => assertCompositionIdentity(sealComposition({ id: "font-composition", visual: { picture: { colorPrimaries: "bt709", colorTransfer: "srgb", referenceWhiteNits: 100, alphaMode: "premultiplied" } as const, canvas: { width: 1080, height: 1920, clearColor: "#000000" }, root: { members: [valid].map(track => ({ kind: "track" as const, id: track.id, track })) } }, audio: { contributions: [] } }, space)));
});
test("animated materialized Surfaces carry an explicit exact sampling relation", () => {
const sampling = frameSamplingMapFixture({
targetFrameRate: space.frameRate, targetFrames: 60,
sourceFrameRate: { numerator: 30, denominator: 1 }, sourceFrames: 60,
pieces: [{ target: { startFrame: 0, endFrameExclusive: 60 },
sourceAtStart: { numerator: 0, denominator: 1 },
rate: { numerator: 1, denominator: 1 },
}],
});
const valid = sealPresentVisualTrack({ timelineId: "test-space",
id: "surface-track",
presents: [{
id: "surface",
span: { startFrame: 0, endFrameExclusive: 60 },
root: { id: "surface", kind: "surface", surface: animatedSurface, sampling },
}],
});
assert.doesNotThrow(() => assertCompositionIdentity(sealComposition({ id: "surface-composition", visual: { picture: { colorPrimaries: "bt709", colorTransfer: "srgb", referenceWhiteNits: 100, alphaMode: "premultiplied" } as const, canvas: { width: 1080, height: 1920, clearColor: "#000000" }, root: { members: [valid].map(track => ({ kind: "track" as const, id: track.id, track })) } }, audio: { contributions: [] } }, space)));
const content = structuredClone(valid) as PresentVisualTrack;
const surface = content.items[0]!.root;
assert(surface.kind === "surface");
const invalid = sealPresentVisualTrack({...content,
presents: [{
...content.items[0]!,
span: { startFrame: 0, endFrameExclusive: 30 },
root: {
...surface,
surface: {
...surface.surface,
timing: { kind: "frames", frameRate: { numerator: 30, denominator: 1 }, frameCount: 60 },
},
},
}],
});
assert.throws(() => assertCompositionIdentity(sealComposition({ id: "invalid-surface-composition", visual: { picture: { colorPrimaries: "bt709", colorTransfer: "srgb", referenceWhiteNits: 100, alphaMode: "premultiplied" } as const, canvas: { width: 1080, height: 1920, clearColor: "#000000" }, root: { members: [invalid].map(track => ({ kind: "track" as const, id: track.id, track })) } }, audio: { contributions: [] } }, space)), /target domain differs from its occurrence/u);
});
test("a local mask owns exactly one mask root and one content root inside its Present", () => {
const track = sealPresentVisualTrack({ timelineId: "test-space",
id: "masked-text",
presents: [{
id: "mask",
span: { startFrame: 0, endFrameExclusive: 60 },
root: {
id: "local-mask", kind: "mask", mode: "alpha",
mask: {
id: "letters", kind: "text", text: "MASK", fonts: [font],
},
content: {
id: "material", kind: "text", text: "CONTENT", fonts: [font],
},
},
}],
});
assert.doesNotThrow(() => assertCompositionIdentity(sealComposition({ id: "mask-composition", visual: { picture: { colorPrimaries: "bt709", colorTransfer: "srgb", referenceWhiteNits: 100, alphaMode: "premultiplied" } as const, canvas: { width: 1080, height: 1920, clearColor: "#000000" }, root: { members: [track].map(track => ({ kind: "track" as const, id: track.id, track })) } }, audio: { contributions: [] } }, space)));
});