@mengine/medeo-client 1.3.1-alpha.10 → 1.3.1-alpha.12

package/README.md

@@ -44,7 +44,7 @@ boundary already fails rows whose media variants lack `external` or carry a
 media is an explicit caller decision, and no implicit historical merge or
 identity rewriting occurs. The
 compatibility reader reads physical facts directly from the media variant;
-Caption text is assembled from its required AudioScript composition and never stored in an inline Asset.
+Caption text is assembled from its required AudioScript composition. The host may associate Caption with a real text Asset through `physical-asset`, keyed by Caption identity; the sandbox does not manage Assets. The association is optional and does not replace composition. Editing inherited text through Caption advances the AudioScript version and its base reference, preserving the Caption ID unless its own fields change.
 
 `SequenceMarker` owns source/target ranges, duration, and time remapping. `Clip`
 owns clip properties such as volume; `Track` owns track properties. References
@@ -80,7 +80,7 @@ with `assembleCaptionContent` or `assemblePhoneticScriptContent`. Broken composi
 fails explicitly. Same-name fields from different bases are rejected even for equal values and even if the variant declares that field. After base fields are unambiguous, explicit own fields may override them without mutating the bases. Recorded Audio/Video/Voice can be the ASR source via
 `audio-script-source`, without creating a synthesis variant.
 
-`insertCaptionClip` requires `baseEntityIds` and `selections`. Each selection
+`insertCaptionClip` requires `baseEntityIds` and `selections`; its optional `captionEntityId` preserves a generation-provided business identity independently of `captionClipEntityId`. Each selection
 names a source `segmentId` and optionally a half-open Unicode code-point
 `textRange: {start, end}`. This permits display re-segmentation without rewriting
 the original script. `upsertVoiceoverTake` requires the real

package/dist/{document-BxWxPFTj.js → document-CF-q_mRy.js}

@@ -1784,9 +1784,8 @@ function entityToRow(entity) {
 //#region ../medeo-dsl/src/invariants.ts
 /**
 * Media variants own their Asset identity directly: a `physical-asset`
-* Relation may not bind them. Caption text is composed domain content, so
-* Captions do not bind Physical Assets either; the Relation vocabulary stays
-* open for future physical pipeline semantics.
+* Relation may not bind them. Caption may associate with a physical text Asset
+* independently of its AudioScript composition.
 */
 function validateMediaAssetIdentity(entity, index) {
 	return [...index.relationsOf(entity)].filter((relation) => relation.kind === "physical-asset").map(() => ({
@@ -1945,11 +1944,6 @@ function validatePhoneticComposition(phonetic, index, entities = []) {
 }
 function validateVariantComposition(variant, index, entities, kind) {
 	const issues = [];
-	if (kind === "caption" && ofKind([...index.relationsOf(variant)], "physical-asset").length > 0) issues.push({
-		code: "caption_physical_asset_forbidden",
-		entityId: variant.entityId,
-		message: "Caption text is composed from its AudioScript; Caption must not bind a Physical Asset"
-	});
 	const rows = {
 		entities: collectRelatedEntities([...entities, variant], index).entities.map((ref) => entityToRow(ref.current())),
 		relations: []
@@ -3487,7 +3481,7 @@ function entityContent(doc, key) {
 }
 function bases(map) {
 	const links = requireMap(map, "bases");
-	return links.keys().sort((a, b) => Number(a) - Number(b)).map((key) => String(links.get(key)));
+	return links.keys().sort((a, b) => a < b ? -1 : a > b ? 1 : 0).map((key) => String(links.get(key)));
 }
 function owned(payload) {
 	const { baseEntityIds: _bases, ...fields } = payload;
@@ -3561,7 +3555,7 @@ function readEntityDocument(doc, allowSelectionConflicts = false) {
 		});
 	}
 	const project = {};
-	for (const [key, value] of Object.entries(section(doc, "project").toJSON())) {
+	for (const [key, value] of Object.entries(section(doc, "attachments").toJSON())) {
 		if (typeof value !== "string") throw new Error(`Invalid project attachment ${key}`);
 		project[key] = currentId(doc, value, ids);
 	}
@@ -3608,6 +3602,7 @@ var LoroEntityDocument = class LoroEntityDocument {
 			"origins",
 			"relations",
 			"project",
+			"attachments",
 			"ordering"
 		]) root(doc).ensureMergeableMap(name);
 		for (const row of rows.entities) apply(doc, {
@@ -3856,7 +3851,7 @@ function apply(doc, command) {
 			map.ensureMergeableMap("changes");
 			section(doc, "origins").set(row.entityId, row.entityId);
 			writeObject(map.ensureMergeableMap("content"), {}, owned(row.payload));
-			writeBases(map, baseIds(row.payload));
+			writeBases(doc, map, baseIds(row.payload));
 			break;
 		}
 		case "write": {
@@ -3867,7 +3862,7 @@ function apply(doc, command) {
 				writeObject(map.ensureMergeableMap("content"), before, after);
 				map.ensureMergeableMap("changes").set(command.token, true);
 			}
-			writeBases(map, baseIds(command.payload));
+			writeBases(doc, map, baseIds(command.payload));
 			break;
 		}
 		case "text": {
@@ -3916,16 +3911,19 @@ function apply(doc, command) {
 			break;
 		}
 		case "attach":
-			section(doc, "project").set(command.slot, command.entityId);
+			section(doc, "attachments").set(command.slot, command.entityId);
 			break;
 	}
 }
-function writeBases(map, ids) {
+function writeBases(doc, map, ids) {
 	const links = map.ensureMergeableMap("bases");
-	for (const key of links.keys()) if (Number(key) >= ids.length) links.delete(key);
-	ids.forEach((id, index) => {
-		if (links.get(String(index)) !== id) links.set(String(index), id);
-	});
+	const wanted = new Map(ids.map((id) => {
+		const origin = section(doc, "origins").get(id);
+		return [typeof origin === "string" ? origin : [...currentIds(doc)].find(([, current]) => current === id)?.[0] ?? id, id];
+	}));
+	if (wanted.size !== ids.length) throw new Error("Duplicate base entity family");
+	for (const key of links.keys()) if (!wanted.has(key)) links.delete(key);
+	for (const [key, id] of wanted) if (links.get(key) === void 0) links.set(key, id);
 }
 /** Numeric sub-spans must not silently quote different text after a collaborative edit. */
 function selectionFingerprint(rows, id) {
@@ -3964,7 +3962,6 @@ function materialize(doc) {
 		const previous = byId.get(row.entityId);
 		if (isJsonObject(previous) && !equalJson(owned(previous), owned(next))) throw new Error("Immutable entity version collision");
 		if (!equalJson(previous, next)) byId.set(row.entityId, next);
-		writeBases(workspace(doc, family(doc, row.entityId)), baseIds(row.payload));
 	}
 	const project = section(doc, "project");
 	for (const [slot, id] of Object.entries(state.project)) if (project.get(slot) !== id) project.set(slot, id);

package/dist/index.d.ts

@@ -454,6 +454,8 @@ interface PatchCaptionStyleInput {
 }
 interface InsertCaptionClipInput {
   readonly timelineEntityId: string;
+  /** Existing generation identity for newly materialized Caption content, distinct from its Clip. */
+  readonly captionEntityId?: string;
   /** Stable placed caption identity, distinct from the Caption content identity. */
   readonly captionClipEntityId?: string;
   /** Existing bases composed by this variant; includes an AudioScript text owner. */
@@ -592,7 +594,7 @@ interface EditorFoundation {
   readonly rows: EntityRelationRows;
   readonly timelineEntityId: string;
   readonly trackEntityIds: Readonly<Record<EditorTrackRole, string>>;
-  /** Fixed identity of the project's one AudioScript, minted here when missing. */
+  /** Initial or current AudioScript content ID selected by the foundation. */
   readonly audioScriptEntityId: string;
 }
 /**
@@ -602,7 +604,7 @@ interface EditorFoundation {
  * Image/Video/Audio/Voice Entity must carry its own external locator, every
  * external asset id has exactly one claimant, and no media variant may be
  * bound through a legacy `physical-asset` Relation. Dual-entity media graphs
- * are rejected, not migrated. Caption composes AudioScript text and has no physical text Asset.
+ * are rejected, not migrated. Caption composes AudioScript text and may associate with a physical text Asset.
  */
 declare function assertCanonicalEditorResources(rows: EntityRelationRows): void;
 /**
@@ -613,7 +615,7 @@ declare function assertCanonicalEditorResources(rows: EntityRelationRows): void;
  *
  * 1. every Image/Video/Audio/Voice Entity carries its own Asset `external`
  *    identity;
- * 2. no `physical-asset` Relation may bind a media variant or Caption;
+ * 2. no `physical-asset` Relation may bind a media variant;
  * 3. a self-carried media identity is immutable — it cannot be rewritten to
  *    another asset id.
  *

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as reassignSpeechesToVideoClipsByTime, A as isJsonObject, B as VideoDocumentValidationError, C as assembleEntityContent, D as selectAudioScriptSegments, E as findComposedAudioScript, F as buildInitialVideoDocument, G as LANE_KINDS_IN_STACK_ORDER, H as validateVideoDocument, I as buildSpeechHostMap, J as laneTrackId, K as ensureLaneTrack, L as derivePositionFromAbs, M as createRelationId, N as hasSequence, O as updateEntityFields, P as isMediaAssetVariantKind, Q as fillMainTrackTimeGaps, R as fromVideoDocument, S as assembleCaptionContent, T as assembleScriptText, U as partUnionSchema, V as assertValidVideoDocument, W as videoDocumentSchema, X as cascadeAfterVideoClipChanges, Y as solveVideoDocument, Z as arrangeMainTrackSeamlessly, _ as EntityProjectionGraph, _t as bytesToBase64, a as applyEntityTimelineProjection, at as isEmptyVideoClip, b as decodeEntityRelationRows, c as writeVideoDocumentToDraft, ct as DEFAULT_UNIT_TIME_MS, d as LoroEntityDocument, dt as effectiveVideoClipDurationMs, et as recalculateTimelineDuration, f as LoroEntityDraft, ft as speedOf, g as projectEntityTimeline, gt as base64ToBytes, h as equalJson, ht as videoDocumentMirrorSchema, i as MirrorVideoDocumentAdapter, it as TIMELINE_SKELETON_DURATION_MS, j as createEntityId, k as variantBaseEntityIds, l as readVideoDocumentFromDraft, lt as ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION, m as entityOrderGroups, mt as recordEntries, n as createPlainMemoryAdapter, nt as resolveSpeechOverlapByShiftingVideos, o as createMirrorVideoDocument, ot as partDurationMs, p as readEntityDocument, pt as partUnionToDraft, q as findLaneTrack, r as generatePartId, rt as syncAggregatedClipsTimePosition, s as createMirrorVideoDocumentAdapter, st as safeDurationMs, t as PlainMemoryAdapter, tt as resolveAllSpeechOverlaps, u as LORO_ENTITY_SCHEMA, ut as VIDEO_DOCUMENT_SCHEMA_VERSION, v as resolveEntityTimelineLayout, w as assemblePhoneticScriptContent, x as ScriptCompositionError, y as EntityTimelineProjectionError, z as toVideoDocument } from "./document-BxWxPFTj.js";
+import { $ as reassignSpeechesToVideoClipsByTime, A as isJsonObject, B as VideoDocumentValidationError, C as assembleEntityContent, D as selectAudioScriptSegments, E as findComposedAudioScript, F as buildInitialVideoDocument, G as LANE_KINDS_IN_STACK_ORDER, H as validateVideoDocument, I as buildSpeechHostMap, J as laneTrackId, K as ensureLaneTrack, L as derivePositionFromAbs, M as createRelationId, N as hasSequence, O as updateEntityFields, P as isMediaAssetVariantKind, Q as fillMainTrackTimeGaps, R as fromVideoDocument, S as assembleCaptionContent, T as assembleScriptText, U as partUnionSchema, V as assertValidVideoDocument, W as videoDocumentSchema, X as cascadeAfterVideoClipChanges, Y as solveVideoDocument, Z as arrangeMainTrackSeamlessly, _ as EntityProjectionGraph, _t as bytesToBase64, a as applyEntityTimelineProjection, at as isEmptyVideoClip, b as decodeEntityRelationRows, c as writeVideoDocumentToDraft, ct as DEFAULT_UNIT_TIME_MS, d as LoroEntityDocument, dt as effectiveVideoClipDurationMs, et as recalculateTimelineDuration, f as LoroEntityDraft, ft as speedOf, g as projectEntityTimeline, gt as base64ToBytes, h as equalJson, ht as videoDocumentMirrorSchema, i as MirrorVideoDocumentAdapter, it as TIMELINE_SKELETON_DURATION_MS, j as createEntityId, k as variantBaseEntityIds, l as readVideoDocumentFromDraft, lt as ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION, m as entityOrderGroups, mt as recordEntries, n as createPlainMemoryAdapter, nt as resolveSpeechOverlapByShiftingVideos, o as createMirrorVideoDocument, ot as partDurationMs, p as readEntityDocument, pt as partUnionToDraft, q as findLaneTrack, r as generatePartId, rt as syncAggregatedClipsTimePosition, s as createMirrorVideoDocumentAdapter, st as safeDurationMs, t as PlainMemoryAdapter, tt as resolveAllSpeechOverlaps, u as LORO_ENTITY_SCHEMA, ut as VIDEO_DOCUMENT_SCHEMA_VERSION, v as resolveEntityTimelineLayout, w as assemblePhoneticScriptContent, x as ScriptCompositionError, y as EntityTimelineProjectionError, z as toVideoDocument } from "./document-CF-q_mRy.js";
 import { addSpeechesInputSchema, addVideoClipsInputSchema, adjustBgmVolumeInputSchema, adjustSpeechVolumeInputSchema, adjustVideoClipDurationInputSchema, adjustVideoClipVolumeInputSchema, changeSpeechScriptInputSchema, changeSpeechVoiceInputSchema, deleteBgmInputSchema, deleteSpeechesInputSchema, deleteVideoClipsInputSchema, moveSpeechesInputSchema, moveVideoClipsByAnchorInputSchema, moveVideoClipsInputSchema, replaceVideoClipContentInputSchema, replaceVideoClipSequenceInputSchema, setBgmInputSchema, setCaptionStyleInputSchema, setCaptionVisibilityInputSchema, setVideoClipSpeedShiftInputSchema, t as schemas_exports } from "./schemas.js";
 import { LoroDoc, VersionVector } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
@@ -292,7 +292,7 @@ const roleOrder$1 = {
 * Image/Video/Audio/Voice Entity must carry its own external locator, every
 * external asset id has exactly one claimant, and no media variant may be
 * bound through a legacy `physical-asset` Relation. Dual-entity media graphs
-* are rejected, not migrated. Caption composes AudioScript text and has no physical text Asset.
+* are rejected, not migrated. Caption composes AudioScript text and may associate with a physical text Asset.
 */
 function assertCanonicalEditorResources(rows) {
 	if (rows.entities.filter((row) => row.entityKind === "timeline").length > 1) throw new EntityTimelineProjectionError("Editor requires exactly one Timeline");
@@ -323,7 +323,7 @@ function assertCanonicalEditorResources(rows) {
 *
 * 1. every Image/Video/Audio/Voice Entity carries its own Asset `external`
 *    identity;
-* 2. no `physical-asset` Relation may bind a media variant or Caption;
+* 2. no `physical-asset` Relation may bind a media variant;
 * 3. a self-carried media identity is immutable — it cannot be rewritten to
 *    another asset id.
 *
@@ -358,10 +358,9 @@ function memotaLocator(value) {
 	};
 }
 /**
-* The project AudioScript is a fixed structure identity, like the Timeline: at
-* most one may exist, and a missing one is minted atomically with empty
-* segments. Project initialization and legacy migration share this single
-* path, so both produce the same canonical structure.
+* Bootstrap an empty script when the foundation has no candidate. Without an
+* explicit project attachment, multiple candidates are ambiguous. Existing
+* content IDs are reused here; Loro editing advances their immutable versions.
 */
 function ensureDocumentAudioScript(entities, idFactory) {
 	const scripts = entities.filter((row) => row.entityKind === "audio-script");
@@ -1377,7 +1376,7 @@ var EntityTimelineEditor = class {
 			const selections = captionSelections(input.selections);
 			const track = this.ensureRoleTrack(draft, input.timelineEntityId, "caption");
 			const content = {
-				entityId: this.mintEntityId(draft),
+				entityId: input.captionEntityId === void 0 ? this.mintEntityId(draft) : requireAvailableEntityId(draft, input.captionEntityId),
 				entityKind: "caption",
 				payload: {
 					extent: {

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { _t as bytesToBase64, gt as base64ToBytes, s as createMirrorVideoDocumentAdapter, ut as VIDEO_DOCUMENT_SCHEMA_VERSION } from "./document-BxWxPFTj.js";
+import { _t as bytesToBase64, gt as base64ToBytes, s as createMirrorVideoDocumentAdapter, ut as VIDEO_DOCUMENT_SCHEMA_VERSION } from "./document-CF-q_mRy.js";
 import { t as classifyUpdate } from "./loro-relay-doc-ssdYpuef.js";
 import { LoroDoc, VersionVector, encodeFrontiers } from "loro-crdt";
 //#region src/testing/in-memory-mengine-server.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mengine/medeo-client",
-  "version": "1.3.1-alpha.10",
+  "version": "1.3.1-alpha.12",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -28,9 +28,9 @@
     "immer": "^10.2.0",
     "loro-mirror": "^2.2.0",
     "zod": "^4.4.3",
-    "@mengine/storage": "1.3.1-alpha.10",
-    "@mengine/sync": "1.3.1-alpha.10",
-    "@mengine/utils": "1.3.1-alpha.10"
+    "@mengine/storage": "1.3.1-alpha.12",
+    "@mengine/sync": "1.3.1-alpha.12",
+    "@mengine/utils": "1.3.1-alpha.12"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -40,8 +40,8 @@
     "typescript": "^6.0.3",
     "vite-plugin-wasm": "^3.6.0",
     "vite-plus": "^0.1.23",
-    "@mengine/idl-codegen": "0.0.0",
-    "@mengine/medeo-dsl": "0.0.0"
+    "@mengine/medeo-dsl": "0.0.0",
+    "@mengine/idl-codegen": "0.0.0"
   },
   "peerDependencies": {
     "loro-crdt": "^1.13.6"