@mengine/medeo-client 2.1.1-dsl.0 → 2.1.1-dsl.10

package/dist/video-draft-types-DTXxvPt-.js

@@ -1,449 +0,0 @@
-import { sha256 } from "@noble/hashes/sha2.js";
-import { Cursor } from "loro-crdt";
-import { schema } from "loro-mirror";
-//#region ../medeo-dsl/src/ids.ts
-function bytesToBase64url(bytes) {
-	let binary = "";
-	for (const byte of bytes) binary += String.fromCharCode(byte);
-	return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
-}
-function base64urlToBytes(value) {
-	if (!/^[A-Za-z0-9_-]+$/.test(value) || value.length % 4 === 1) throw new Error("Invalid base64url");
-	const bytes = Uint8Array.from(atob(value.replaceAll("-", "+").replaceAll("_", "/")), (c) => c.charCodeAt(0));
-	if (bytesToBase64url(bytes) !== value) throw new Error("Non-canonical base64url");
-	return bytes;
-}
-function tupleHash(tuple) {
-	return bytesToBase64url(sha256(new TextEncoder().encode(JSON.stringify(tuple))));
-}
-function resourceId(kind, system, key) {
-	return `${kind}:${tupleHash([system, key])}`;
-}
-function relationId(table, value) {
-	const v = value;
-	switch (table) {
-		case "clip-source-relations": return `cs:${v.clipId}`;
-		case "time-anchor-relations": return `ta:${v.from}`;
-		case "caption-content-relations": return `cc:${v.captionId}`;
-		case "caption-alignment-relations": return `ca:${v.captionId}`;
-		case "voice-timbre-relations": return `voice-timbre:${tupleHash([v.recordingId, v.voiceId])}`;
-		case "derived-from-relations": return `derived-from:${tupleHash([v.entityId, v.sourceId])}`;
-		case "from-asset-relations": return `from-asset:${v.audioScriptId}`;
-		case "to-asset-relations": return `to-asset:${v.audioScriptId}`;
-	}
-	throw new Error(`Unknown relation table: ${table}`);
-}
-const defaultIdFactory = (kind) => `${kind}_${globalThis.crypto.randomUUID()}`;
-const resourceKinds = {
-	"media-entities": "media",
-	"voice-entities": "voice",
-	"asset-entities": "asset"
-};
-/** A resource row's ID is derived from its locator, so one external resource is one entity. */
-function assertResourceIdentity(table, id, value) {
-	const kind = resourceKinds[table];
-	if (kind && id !== resourceId(kind, value.system, value.key)) throw new Error("Resource identity does not match locator");
-}
-/** A relation row's ID is derived from its uniqueness key. */
-function assertRelationIdentity(table, id, value) {
-	if (id !== relationId(table, value)) throw new Error("Relation ID does not match endpoints");
-}
-//#endregion
-//#region ../medeo-dsl/src/fields.ts
-const string = (v) => typeof v === "string";
-const nonempty = (v) => string(v) && v.length > 0;
-const finite = (v) => typeof v === "number" && Number.isFinite(v);
-const integer = (v) => typeof v === "number" && Number.isSafeInteger(v);
-const nonnegative = (v) => integer(v) && v >= 0;
-const positive = (v) => integer(v) && v > 0;
-const oneOf = (...values) => (v) => values.includes(v);
-const required = (check) => ({ check });
-const optional$1 = (check) => ({
-	check,
-	optional: true
-});
-function isRecord(value) {
-	return value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Cursor);
-}
-function assertId(value) {
-	if (!nonempty(value) || [
-		"$cid",
-		"__proto__",
-		"constructor",
-		"prototype"
-	].includes(value)) throw new Error("Expected a nonempty, non-reserved ID");
-}
-function validLanguage(value) {
-	if (typeof value !== "string") return false;
-	if (/^x(?:-[a-z0-9]{1,8})+$/i.test(value)) return true;
-	try {
-		return value.length > 0 && Intl.getCanonicalLocales(value).length === 1;
-	} catch {
-		return false;
-	}
-}
-function object(fields) {
-	return (v) => {
-		try {
-			checkFields(v, fields);
-			return true;
-		} catch {
-			return false;
-		}
-	};
-}
-function checkFields(value, fields, partial = false) {
-	if (!isRecord(value)) throw new Error("Expected an object");
-	for (const key of Object.keys(value)) if (!Object.hasOwn(fields, key)) throw new Error(`Unknown field: ${key}`);
-	for (const [key, field] of Object.entries(fields)) {
-		if (partial && !Object.hasOwn(value, key)) continue;
-		const v = value[key];
-		if (v === void 0 && field.optional) continue;
-		if (!field.check(v)) throw new Error(`Invalid or missing field: ${key}`);
-	}
-}
-const styleFields = {
-	font: optional$1(object({
-		system: required(oneOf("font-library")),
-		key: required(nonempty)
-	})),
-	fontSize: optional$1(finite),
-	fontColor: optional$1(string),
-	fontWeight: optional$1(finite),
-	entranceAnimation: optional$1(string),
-	entranceAnimationDurationMs: optional$1(nonnegative),
-	strokeColor: optional$1(string),
-	strokeWidth: optional$1(finite),
-	positionX: optional$1(finite),
-	positionY: optional$1(finite)
-};
-const seqMarkerFields = {
-	inMs: required(nonnegative),
-	outMs: required(nonnegative),
-	rate: optional$1((v) => finite(v) && v > 0),
-	fillTimeline: optional$1(oneOf(true))
-};
-/** A sequence marker's own fields; the window being nonempty is checked where it is written. */
-function assertSeqMarker(value) {
-	checkFields(value, seqMarkerFields);
-}
-const locator = {
-	system: required(oneOf("memota", "memota-speech")),
-	key: required(nonempty)
-};
-const entityFields = {
-	"timeline-entities": {},
-	"track-entities": {
-		role: required(oneOf("video_clip", "speech", "caption", "bgm")),
-		hidden: optional$1((v) => typeof v === "boolean")
-	},
-	"clip-entities": {
-		seqMarker: required(object(seqMarkerFields)),
-		volume: optional$1(finite)
-	},
-	"media-entities": {
-		...locator,
-		kind: required(oneOf("video", "audio", "voiceover-recording", "image")),
-		storageKey: optional$1(nonempty),
-		durationMs: optional$1(positive),
-		digest: optional$1(nonempty)
-	},
-	"audio-script-entities": {
-		body: required(string),
-		defaultLanguage: optional$1(validLanguage)
-	},
-	"caption-entities": {
-		text: optional$1(string),
-		style: optional$1(object(styleFields))
-	},
-	"voice-entities": {
-		system: required(oneOf("voice-library")),
-		key: required(nonempty),
-		name: optional$1(string)
-	},
-	"asset-entities": {
-		...locator,
-		storageKey: optional$1(nonempty),
-		digest: optional$1(nonempty)
-	}
-};
-const entityTables = Object.keys(entityFields);
-const relationFields = {
-	"clip-source-relations": {
-		clipId: required(nonempty),
-		sourceId: required(nonempty)
-	},
-	"time-anchor-relations": {
-		from: required(nonempty),
-		to: required(nonempty),
-		offsetMs: required(integer),
-		fallback_abs_ms: required(nonnegative)
-	},
-	"caption-content-relations": {
-		captionId: required(nonempty),
-		audioScriptId: required(nonempty),
-		start: required((v) => v instanceof Cursor),
-		end: required((v) => v instanceof Cursor)
-	},
-	"caption-alignment-relations": {
-		captionId: required(nonempty),
-		mediaId: required(nonempty),
-		startMs: required(nonnegative),
-		endMs: required(nonnegative)
-	},
-	"voice-timbre-relations": {
-		recordingId: required(nonempty),
-		voiceId: required(nonempty)
-	},
-	"derived-from-relations": {
-		entityId: required(nonempty),
-		sourceId: required(nonempty)
-	},
-	"from-asset-relations": {
-		audioScriptId: required(nonempty),
-		assetId: required(nonempty)
-	},
-	"to-asset-relations": {
-		audioScriptId: required(nonempty),
-		assetId: required(nonempty)
-	}
-};
-const relationTables = Object.keys(relationFields);
-function assertEntity(table, value) {
-	checkFields(value, entityFields[table]);
-	if (table === "media-entities") {
-		if (value.kind === "image" && value.durationMs !== void 0) throw new Error("Image has no intrinsic duration");
-		if (value.kind !== "image" && !positive(value.durationMs)) throw new Error("Finite media requires durationMs");
-		if (["audio", "voiceover-recording"].includes(value.kind) && !nonempty(value.storageKey)) throw new Error("Audio requires storageKey");
-	}
-}
-/** Validate only touched fields, so an unrelated edit can proceed in a merged, invalid document. */
-function assertEntityPatch(table, patch, current) {
-	if (!isRecord(patch)) throw new Error("Expected an entity patch");
-	if (table === "audio-script-entities" && Object.hasOwn(patch, "body")) throw new Error("Edit body through the Text adapter");
-	if (table === "caption-entities" && current.style !== void 0 && Object.hasOwn(patch, "style") && patch.style === void 0) throw new Error("Reset individual style fields; retain the style Map");
-	if (table === "caption-entities" && current.text !== void 0 && patch.text !== void 0) throw new Error("Edit Caption text through the Text adapter");
-	const next = mergeFields(current, patch);
-	for (const key of Object.keys(patch)) {
-		const field = entityFields[table][key];
-		if (!field || !field.optional && next[key] === void 0 || next[key] !== void 0 && !field.check(next[key])) throw new Error(`Invalid patch field: ${key}`);
-	}
-	if (table === "media-entities" || table === "voice-entities" || table === "asset-entities") {
-		for (const key of [
-			"system",
-			"key",
-			"kind"
-		]) if (Object.hasOwn(patch, key) && patch[key] !== current[key]) throw new Error(`Resource identity field is immutable: ${key}`);
-	}
-	if (table === "media-entities") {
-		if (Object.hasOwn(patch, "durationMs")) {
-			if (next.kind === "image" ? next.durationMs !== void 0 : !positive(next.durationMs)) throw new Error("durationMs must match the media kind");
-		}
-		if (Object.hasOwn(patch, "storageKey") && ["audio", "voiceover-recording"].includes(next.kind) && !nonempty(next.storageKey)) throw new Error("Audio requires storageKey");
-	}
-}
-function assertRelation(table, value) {
-	checkFields(value, relationFields[table]);
-	for (const [key, endpoint] of Object.entries(value)) if (key.endsWith("Id") || key === "from" || key === "to") assertId(endpoint);
-}
-/** Undefined deletes; nested patches retain sibling fields and an existing empty style Map. */
-function mergeFields(target, patch) {
-	const result = { ...target };
-	for (const [key, value] of Object.entries(patch)) {
-		if ([
-			"$cid",
-			"__proto__",
-			"constructor",
-			"prototype"
-		].includes(key)) throw new Error(`Reserved field: ${key}`);
-		if (value === void 0) delete result[key];
-		else result[key] = isRecord(value) ? mergeFields(isRecord(result[key]) ? result[key] : {}, value) : value;
-	}
-	return result;
-}
-//#endregion
-//#region ../medeo-dsl/src/schema/codec.ts
-function isInvalidAtomic(value) {
-	return typeof value === "object" && value !== null && "invalid" in value && value.invalid === true;
-}
-function codec(encode, decode) {
-	return {
-		encode: (v) => isInvalidAtomic(v) ? v.raw : encode(v),
-		decode: (raw) => {
-			try {
-				return decode(raw);
-			} catch (error) {
-				return {
-					invalid: true,
-					raw,
-					reason: String(error)
-				};
-			}
-		}
-	};
-}
-const timeAnchorCodec = codec((v) => {
-	assertRelation("time-anchor-relations", v);
-	return JSON.stringify({
-		from: v.from,
-		to: v.to,
-		offsetMs: v.offsetMs,
-		fallback_abs_ms: v.fallback_abs_ms
-	});
-}, (raw) => {
-	const v = JSON.parse(raw);
-	assertRelation("time-anchor-relations", v);
-	return v;
-});
-const captionContentCodec = codec((v) => {
-	assertRelation("caption-content-relations", v);
-	return JSON.stringify({
-		captionId: v.captionId,
-		audioScriptId: v.audioScriptId,
-		start: bytesToBase64url(v.start.encode()),
-		end: bytesToBase64url(v.end.encode())
-	});
-}, (raw) => {
-	const v = JSON.parse(raw);
-	if (typeof v?.start !== "string" || typeof v?.end !== "string") throw new Error("Expected encoded Cursor pair");
-	const value = {
-		...v,
-		start: Cursor.decode(base64urlToBytes(v.start)),
-		end: Cursor.decode(base64urlToBytes(v.end))
-	};
-	assertRelation("caption-content-relations", value);
-	return value;
-});
-/** A Clip's sequence marker is stored as one string, so it is taken or replaced whole. */
-const seqMarkerCodec = codec((v) => {
-	assertSeqMarker(v);
-	return JSON.stringify({
-		inMs: v.inMs,
-		outMs: v.outMs,
-		...v.rate === void 0 ? {} : { rate: v.rate },
-		...v.fillTimeline === void 0 ? {} : { fillTimeline: v.fillTimeline }
-	});
-}, (raw) => {
-	const v = JSON.parse(raw);
-	assertSeqMarker(v);
-	return v;
-});
-//#endregion
-//#region ../medeo-dsl/src/schema/loro-shape.ts
-const optional = { required: false };
-const mergeable = { mergeableMapChildContainers: true };
-const strings = (keys) => Object.fromEntries(keys.map((key) => [key, schema.String()]));
-const relation = (keys) => schema.LoroMapRecord(schema.LoroMap(strings(keys)), mergeable);
-const atomicValue = (codec) => schema.String().transform({
-	...codec,
-	isEqual: "encoded-value-equality",
-	validateEncodedType: true
-});
-const atomic = (codec) => schema.LoroMapRecord(atomicValue(codec));
-/** Only direct children inherit mergeable identity. Body and ordinary entity rows keep normal identities. */
-const medeoDslLoroShape = schema({
-	"timeline-entities": schema.LoroMapRecord(schema.LoroMap({})),
-	"track-entities": schema.LoroMapRecord(schema.LoroMap({
-		role: schema.String(),
-		hidden: schema.Boolean(optional)
-	})),
-	"clip-entities": schema.LoroMapRecord(schema.LoroMap({
-		seqMarker: atomicValue(seqMarkerCodec),
-		volume: schema.Number(optional)
-	})),
-	"media-entities": schema.LoroMapRecord(schema.LoroMap({
-		kind: schema.String(),
-		system: schema.String(),
-		key: schema.String(),
-		storageKey: schema.String(optional),
-		durationMs: schema.Number(optional),
-		digest: schema.String(optional)
-	}), mergeable),
-	"audio-script-entities": schema.LoroMapRecord(schema.LoroMap({
-		body: schema.LoroText(),
-		defaultLanguage: schema.String(optional)
-	})),
-	"caption-entities": schema.LoroMapRecord(schema.LoroMap({
-		text: schema.LoroText(optional),
-		style: schema.LoroMap({
-			font: schema.LoroMap({
-				system: schema.String(),
-				key: schema.String()
-			}, optional),
-			fontSize: schema.Number(optional),
-			fontColor: schema.String(optional),
-			fontWeight: schema.Number(optional),
-			entranceAnimation: schema.String(optional),
-			entranceAnimationDurationMs: schema.Number(optional),
-			strokeColor: schema.String(optional),
-			strokeWidth: schema.Number(optional),
-			positionX: schema.Number(optional),
-			positionY: schema.Number(optional)
-		}, {
-			...optional,
-			...mergeable
-		})
-	}, mergeable)),
-	"voice-entities": schema.LoroMapRecord(schema.LoroMap({
-		system: schema.String(),
-		key: schema.String(),
-		name: schema.String(optional)
-	}), mergeable),
-	"asset-entities": schema.LoroMapRecord(schema.LoroMap({
-		system: schema.String(),
-		key: schema.String(),
-		storageKey: schema.String(optional),
-		digest: schema.String(optional)
-	}), mergeable),
-	"contain-relations": schema.LoroTree(schema.LoroMap({ entityId: schema.String() })),
-	"clip-source-relations": relation(["clipId", "sourceId"]),
-	"time-anchor-relations": atomic(timeAnchorCodec),
-	"caption-content-relations": atomic(captionContentCodec),
-	"caption-alignment-relations": schema.LoroMapRecord(schema.LoroMap({
-		captionId: schema.String(),
-		mediaId: schema.String(),
-		startMs: schema.Number(),
-		endMs: schema.Number()
-	}), mergeable),
-	"voice-timbre-relations": relation(["recordingId", "voiceId"]),
-	"derived-from-relations": relation(["entityId", "sourceId"]),
-	"from-asset-relations": relation(["audioScriptId", "assetId"]),
-	"to-asset-relations": relation(["audioScriptId", "assetId"])
-});
-//#endregion
-//#region ../medeo-dsl/src/schema/document-format.ts
-/** Format discrimination does not register containers or alter the document. */
-function documentFormat(doc) {
-	const roots = doc.getShallowValue();
-	const legacy = [
-		"medeo",
-		"timeline",
-		"tracks",
-		"part_library"
-	].some((key) => Object.hasOwn(roots, key));
-	const dsl = Object.keys(roots).some((key) => key.endsWith("-entities") || key.endsWith("-relations"));
-	return legacy && dsl ? "mixed" : legacy ? "legacy" : dsl ? "dsl" : "unknown";
-}
-var UnsupportedDocumentFormatError = class extends Error {
-	code = "unsupported_document_format";
-	constructor() {
-		super("Expected a new DSL document; legacy, mixed or uninitialized content is not supported");
-		this.name = "UnsupportedDocumentFormatError";
-	}
-};
-/** Run after initial import, before opening an editable handle. Empty new documents still have one Timeline. */
-function assertDslDocument(doc) {
-	if (documentFormat(doc) !== "dsl" || doc.getMap("timeline-entities").keys().length !== 1) throw new UnsupportedDocumentFormatError();
-}
-//#endregion
-//#region ../medeo-dsl/src/schema/text-styles.ts
-/** How rich-text marks extend at their edges: a language runs on into new text, a pause stays on its space. */
-const textStyles = {
-	language: { expand: "after" },
-	pauseMs: { expand: "none" }
-};
-//#endregion
-//#region src/dsl/projection/video-draft-types.ts
-const DEFAULT_UNIT_TIME_MS = 33.333;
-//#endregion
-export { resourceId as C, relationId as S, relationTables as _, documentFormat as a, assertResourceIdentity as b, isInvalidAtomic as c, assertEntityPatch as d, assertId as f, mergeFields as g, isRecord as h, assertDslDocument as i, timeAnchorCodec as l, entityTables as m, textStyles as n, medeoDslLoroShape as o, assertRelation as p, UnsupportedDocumentFormatError as r, captionContentCodec as s, DEFAULT_UNIT_TIME_MS as t, assertEntity as u, validLanguage as v, tupleHash as w, defaultIdFactory as x, assertRelationIdentity as y };