@mengine/medeo-client 1.3.1-alpha.11 → 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-CkbNx-mi.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: []

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. */
@@ -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-CkbNx-mi.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.
 *
@@ -1376,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-CkbNx-mi.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.11",
+  "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.11",
-    "@mengine/sync": "1.3.1-alpha.11",
-    "@mengine/utils": "1.3.1-alpha.11"
+    "@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"