@mengine/medeo-tool 1.4.1-alpha.4 → 2.0.1-alpha.2

package/README.md

@@ -84,6 +84,15 @@ Resource-free Caption composition from AudioScript is also supported. Each
 on-screen placement has its own Clip and display SequenceMarker, connected by
 ordinary relations; intrinsic Caption timing remains independent.
 
+Voice resources use `external: {system: 'memota-speech', key: speechId}`.
+Await `rgetAssetFromEntity(voiceId)` before constructing placement relations: the
+host supplies `storageKey`, the full millisecond `extent`, and the optional TTS
+`voice` locator. The loader returns `{assetId, content: {storageKey, durationMs,
+voice?}}` from a project-scoped Speech lookup. Recorded speech omits `voice`;
+TTS retains its explicit PhoneticScript relation. Resource reads do not create
+script text or display markers. New or changed Speech references are also
+resolved before commit, and failed reads publish no partial edits.
+
 `materializeResources` and generation/resource loaders are host APIs. The model
 never receives these capabilities. Project initialization and historical data
 migration also remain outside script execution. Retrying an unconfirmed commit

package/dist/{entity-contract-DQ56Ihrh.d.mts → entity-contract-G4HxwNXl.d.mts}

@@ -106,7 +106,7 @@ interface EntityPayloadByKind {
   };
   caption: BoundedNativeSequencePayload & {
     baseEntityIds: string[];
-    selections: CaptionTextSelection[];
+    selection: CaptionTextSelection;
     style?: JsonObject;
     segmentRanges?: {
       segmentId: string;
@@ -116,7 +116,7 @@ interface EntityPayloadByKind {
   };
 }
 /** Stored own fields; a variant may obtain required content fields from its declared bases. */
-type StoredEntityPayload<K extends KnownEntityKind> = EntityPayloadByKind[K] | (K extends 'caption' ? JsonObject & Pick<MediaAssetPayload, 'external'> : never) | (JsonObject & Partial<EntityPayloadByKind[K]> & {
+type StoredEntityPayload<K extends KnownEntityKind> = EntityPayloadByKind[K] | (K extends 'caption' | 'voice' ? JsonObject & Pick<MediaAssetPayload, 'external'> : never) | (JsonObject & Partial<EntityPayloadByKind[K]> & {
   baseEntityIds: string[];
 });
 interface SandboxEntity<K extends KnownEntityKind = KnownEntityKind> {
@@ -238,4 +238,4 @@ interface BusinessRelationFacade {
 }
 //#endregion
 export { UpdateEntityInput as C, UnlinkRelationInput as S, LinkRelationInput as _, DeleteEntityInput as a, SandboxEntity as b, EntitySandboxCheckpoint as c, JsonObject as d, JsonPrimitive as f, LinkGeneratedRelationInput as g, KnownRelationKind as h, CreateEntityInput as i, EntityStoreSnapshot as l, KnownEntityKind as m, BusinessEntityFacade as n, EntityCommand as o, JsonValue as p, BusinessRelationFacade as r, EntityPlanState as s, AuthorableRelationKind as t, EntityUpdateInput as u, RelationUpdateInput as v, SandboxRelation as x, ResourceEntityKind as y };
-//# sourceMappingURL=entity-contract-DQ56Ihrh.d.mts.map
+//# sourceMappingURL=entity-contract-G4HxwNXl.d.mts.map

package/dist/{entity-sandbox-OArq9NSH.mjs → entity-sandbox-TaUVT3on.mjs}

@@ -209,15 +209,15 @@ function assembleCaptionContent(rows, captionEntityId) {
 	requireEntityKind(rows, captionEntityId, "caption");
 	const caption = assembleEntityContent(rows, captionEntityId);
 	const script = findComposedAudioScript(rows, captionEntityId, "caption");
-	const segments = selectAudioScriptSegments({
+	const segment = selectAudioScriptSegment({
 		...script,
 		payload: caption.payload
-	}, captionSelections(caption));
+	}, captionSelection(caption));
 	return {
 		caption,
 		audioScript: script,
-		segments,
-		text: segments.map((segment) => segment.text).join("")
+		segments: [segment],
+		text: segment.text
 	};
 }
 /**
@@ -239,20 +239,18 @@ function assemblePhoneticScriptContent(rows, phoneticScriptEntityId) {
 		text: segments.map((segment) => segment.text).join("")
 	};
 }
-function captionSelections(caption) {
-	const selections = caption.payload.selections;
-	if (!Array.isArray(selections) || selections.length === 0) throw new ScriptCompositionError("empty_selection", caption.entityId, `Caption "${caption.entityId}" requires a non-empty segment selection into its AudioScript`);
-	if (!selections.every(isSegmentSelection)) throw new ScriptCompositionError("invalid_selection", caption.entityId, "Caption selections require a segmentId and optional textRange");
-	return selections;
+function captionSelection(caption) {
+	if (Object.hasOwn(caption.payload, "selections") || !isSegmentSelection(caption.payload.selection)) throw new ScriptCompositionError("invalid_selection", caption.entityId, "Caption requires one selection object with segmentId and optional textRange; selections arrays are forbidden");
+	return caption.payload.selection;
 }
 function isSegmentSelection(value) {
 	return typeof value === "object" && value != null && !Array.isArray(value) && typeof value.segmentId === "string" && value.segmentId.trim() !== "" && Object.keys(value).every((key) => key === "segmentId" || key === "textRange");
 }
 /** Select source text without creating another authoritative text field. */
-function selectAudioScriptSegments(script, selections) {
-	if (!Array.isArray(selections) || selections.length === 0 || !selections.every(isSegmentSelection) || new Set(selections.map((s) => s.segmentId)).size !== selections.length) throw new ScriptCompositionError("invalid_selection", script.entityId, "Caption selections must be non-empty and name unique source segments");
+function selectAudioScriptSegment(script, selection) {
+	if (!isSegmentSelection(selection)) throw new ScriptCompositionError("invalid_selection", script.entityId, "Caption requires one selection object with segmentId and optional textRange");
 	const bySegmentId = new Map(scriptSegments(script).map((segment) => [segment.segmentId, segment]));
-	const selected = selections.map((selection) => {
+	const selected = (() => {
 		const segment = bySegmentId.get(selection.segmentId);
 		if (segment === void 0) throw new ScriptCompositionError("unknown_segment", script.entityId, `Caption selection "${selection.segmentId}" does not name a segment of AudioScript "${script.entityId}"`);
 		if (selection.textRange === void 0) return segment;
@@ -263,8 +261,8 @@ function selectAudioScriptSegments(script, selections) {
 			...segment,
 			text: points.slice(range.start, range.end).join("")
 		};
-	});
-	if (!selected.map((segment) => segment.text).join("").trim()) throw new ScriptCompositionError("empty_selection", script.entityId, "Caption selection must contain visible source text");
+	})();
+	if (!selected.text.trim()) throw new ScriptCompositionError("empty_selection", script.entityId, "Caption selection must contain visible source text");
 	return selected;
 }
 function requireEntityKind(rows, entityIdValue, entityKind) {
@@ -736,25 +734,15 @@ function validateVoicePayload(value, problems) {
 function validateCaptionPayload(value, problems) {
 	validateExternalLocator(value, problems);
 	if (value.segmentRanges !== void 0) validateSegmentRanges(value.segmentRanges, problems);
-	const selections = value.selections;
-	if (!Array.isArray(selections)) problems.push("selections must be a non-empty array of AudioScript segment selections");
+	if (Object.hasOwn(value, "selections")) problems.push("selections is forbidden; Caption requires one selection object");
+	const selection = value.selection;
+	if (!isRecord(selection)) problems.push("selection must be one AudioScript segment selection object, not an array");
 	else {
-		if (selections.length === 0) problems.push("selections must name at least one AudioScript segment");
-		const seen = /* @__PURE__ */ new Set();
-		for (const [index, selection] of selections.entries()) {
-			if (!isRecord(selection)) {
-				problems.push(`selections[${index}] must be an object`);
-				continue;
-			}
-			if (typeof selection.segmentId !== "string" || selection.segmentId.trim() === "") problems.push(`selections[${index}].segmentId must be a string`);
-			else if (seen.has(selection.segmentId)) problems.push(`selections[${index}].segmentId must be unique within the Caption`);
-			else seen.add(selection.segmentId);
-			if (Object.keys(selection).some((key) => key !== "segmentId" && key !== "textRange")) problems.push(`selections[${index}] may only contain segmentId and textRange`);
-			if (selection.textRange !== void 0) {
-				const range = selection.textRange;
-				if (!isRecord(range) || !Number.isSafeInteger(range.start) || !Number.isSafeInteger(range.end) || range.start < 0 || range.end <= range.start || Object.keys(range).some((key) => key !== "start" && key !== "end")) problems.push(`selections[${index}].textRange must be a non-empty half-open code-point range`);
-			}
-		}
+		if (typeof selection.segmentId !== "string" || !selection.segmentId.trim()) problems.push("selection.segmentId must be a non-empty string");
+		if (Object.keys(selection).some((key) => key !== "segmentId" && key !== "textRange")) problems.push("selection may only contain segmentId and textRange");
+		const range = selection.textRange;
+		if (range !== void 0 && (!isRecord(range) || !Number.isSafeInteger(range.start) || !Number.isSafeInteger(range.end) || range.start < 0 || range.end <= range.start || Object.keys(range).some((key) => key !== "start" && key !== "end"))) problems.push("selection.textRange must be a non-empty half-open code-point range");
+		if (Array.isArray(value.segmentRanges) && (value.segmentRanges.length !== 1 || !isRecord(value.segmentRanges[0]) || value.segmentRanges[0].segmentId !== selection.segmentId)) problems.push("Caption segmentRanges must contain only the selected segment timing");
 	}
 	const style = value.style;
 	if (style === void 0) return;
@@ -878,7 +866,7 @@ function isOwnedLocalEntityValuePath(entityKind, path) {
 	if (entityKind === "asset" && /^(?:external\.(?:system|key)|storageKey)$/.test(path)) return true;
 	if (isMediaAssetVariantKind(entityKind) && /^(?:external\.(?:system|key)|storageKey)$/.test(path)) return true;
 	if (entityKind === "voice" && /^voice\.(?:system|key|name)$/.test(path)) return true;
-	if (entityKind === "caption" && (path.startsWith("style.") || /^selections\[\d+\]\.segmentId$/.test(path))) return true;
+	if (entityKind === "caption" && (path.startsWith("style.") || path === "selection.segmentId")) return true;
 	if ([
 		"audio-script",
 		"caption",
@@ -893,7 +881,7 @@ function isOwnedLocalIdPath(entityKind, path) {
 		"caption",
 		"phonetic-script"
 	].includes(entityKind) && /^segments\[\d+\]\.segmentId$/.test(path)) return true;
-	if (entityKind === "caption" && /^selections\[\d+\]\.segmentId$/.test(path)) return true;
+	if (entityKind === "caption" && path === "selection.segmentId") return true;
 	if ((entityKind === "sequence-marker" || entityKind === "caption") && /^segmentRanges\[\d+\]\.segmentId$/.test(path)) return true;
 	if (entityKind === "asset" && /^(?:tracks\[\d+\]\.trackId|renditions\[\d+\]\.renditionId)$/.test(path)) return true;
 	return false;
@@ -2096,6 +2084,6 @@ const numericMarkerComparators = { compareMarkerPoints: (_marker, _range, left,
 	return left - right;
 } };
 //#endregion
-export { createEntityId as a, businessState as i, toDslRows as n, createRelationId as o, businessFacades as r, isMediaAssetVariantKind as s, EntitySandbox as t };
+export { isJsonObject as a, isMediaAssetVariantKind as c, businessState as i, toDslRows as n, createEntityId as o, businessFacades as r, createRelationId as s, EntitySandbox as t };
 
-//# sourceMappingURL=entity-sandbox-OArq9NSH.mjs.map
+//# sourceMappingURL=entity-sandbox-TaUVT3on.mjs.map