@mengine/medeo-client 1.3.1-alpha.8 → 1.3.1-alpha.9

package/dist/index.d.ts

@@ -221,13 +221,12 @@ declare function selectAudioScriptSegments(script: EntityRow<'audio-script'>, se
 //#region src/entity-editor/entity-graph-http-client.d.ts
 /** One authenticated revision of the authoritative Medeo Entity graph. */
 interface EntityGraphState {
-  readonly audioScriptEntityId: string | null;
+  /** Fixed identity of the project's one AudioScript; present in every readable state. */
+  readonly audioScriptEntityId: string;
   readonly revision: number;
   readonly rows: EntityRelationRows;
 }
 interface EntityGraphCommitOptions {
-  /** Omitted preserves the baseline association; null explicitly clears it. */
-  readonly audioScriptEntityId?: string | null;
   /** Server version vector proving the explicit legacy-to-Entity migration baseline. */
   readonly migrationBaseVv?: string;
 }
@@ -245,7 +244,7 @@ declare class EntityGraphHttpClient {
    * transient create-then-remove never becomes a request to delete unknown
    * persisted data.
    */
-  commit(baseState: EntityGraphState, nextRows: EntityRelationRows, options?: EntityGraphCommitOptions): Promise<EntityGraphState>;
+  commit(baseState: Pick<EntityGraphState, 'revision' | 'rows'>, nextRows: EntityRelationRows, options?: EntityGraphCommitOptions): Promise<EntityGraphState>;
   private request;
 }
 //#endregion
@@ -590,6 +589,8 @@ 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. */
+  readonly audioScriptEntityId: string;
 }
 /**
  * MEngine editor policy, not a cardinality restriction on the general-purpose DSL.
@@ -661,8 +662,22 @@ interface DocumentAudioScript {
   readonly entityId: string;
   readonly segments: readonly (ScriptTextSegment & Readonly<Record<string, unknown>>)[];
 }
-/** Resolve only the document association; other AudioScripts remain independent resources. */
-declare function readDocumentAudioScript(state: Pick<EntityGraphState, 'rows' | 'audioScriptEntityId'>): DocumentAudioScript | null;
+/** Any state that carries the fixed document AudioScript identity outlet. */
+interface DocumentAudioScriptState {
+  readonly rows: EntityRelationRows;
+  /**
+   * Fixed identity minted atomically at project initialization. `null` is only
+   * the internal revision-0 "not yet initialized" representation; normal
+   * projects never carry the legacy null association.
+   */
+  readonly audioScriptEntityId: string | null;
+}
+/**
+ * Strict read of the project's one fixed AudioScript. The identity is immutable
+ * for the project's lifetime; this never selects, clears, or switches a
+ * script. Uninitialized or dangling identities are projection errors.
+ */
+declare function readDocumentAudioScript(state: DocumentAudioScriptState): DocumentAudioScript;
 //#endregion
 //#region src/editor/journal.d.ts
 /**
@@ -1568,4 +1583,4 @@ declare function hostForAbsMs(ranges: MainClipRange[], absMs: number): MainClipR
  */
 declare function relativePositionForAbs(ranges: MainClipRange[], absMs: number): TrackItemTimePosition;
 //#endregion
-export { type Aggregation, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionContentInput, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, DEFAULT_UNIT_TIME_MS, type DeleteBgmInput, type DeleteClipInput, type DeleteClipTreeInput, type DeleteVoiceoverInput, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, type DocumentAudioScript, ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION, type EditorFoundation, type EntityGraphCommitOptions, EntityGraphHttpClient, type EntityGraphState, EntityTimelineEditor, type EntityTimelineIdFactory, EntityTimelineProjectionError, type EntityTimelineTrackRole, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedMediaAsset, type InitialDocumentFacts, type InsertCaptionClipInput, type InsertClipInput, type InsertMediaClipInput, type InsertMediaClipsInput, type InsertPlacedClipInput, type JournalEntry, LANE_KINDS_IN_STACK_ORDER, type LaneKind, type LinearClipSpeed, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type MediaAssetFact, type MediaClipInsertion, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type MoveClipInput, type MoveClipsToStartsInput, type MoveSequentialClipsInput, type MoveVoiceoverInput, type OpActor, type PartAggregation, type PartIdFactory, type PartKind, type PartUnion, type PatchCaptionStyleInput, PlainMemoryAdapter, type PlainMemoryAdapterOptions, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type ReplaceClipContentInput, type ReplaceMediaClipInput, type ReplaceSequentialClipsInput, type ReplacementMediaClipInput, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechHostMap, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, type TrimClipInput, type UpdateClipInput, type UpdateClipMarkerInput, VIDEO_DOCUMENT_SCHEMA_VERSION, ValidationError, type VideoClipPart, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, type VideoDocumentSchemaVersion, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type VideoMediaAssetFact, type VisualMediaAssetFact, type VoiceMediaAssetFact, type VoiceoverCaptionFact, type VoiceoverTakeInput, type VoiceoverTakeResult, type WaitForServerAckOptions, applyEntityTimelineProjection, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertMediaAssetWritePolicy, assertValidVideoDocument, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, prepareCaptionContent, projectEntityTimeline, readDocumentAudioScript, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveSpeechOverlapByShiftingVideos, safeDurationMs, index_d_exports as schemas, selectAudioScriptSegments, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema, writeVideoDocumentToDraft };
+export { type Aggregation, type AssembledCaptionContent, type AssembledPhoneticScriptContent, type Attachment, type AudioMediaAssetFact, type BgmPart, type CaptionContentInput, type CaptionPart, type CaptionSegmentSelection, type CaptionStyle, type ClipEntityId, type ClipPlacement, type CommitOptions, DEFAULT_UNIT_TIME_MS, type DeleteBgmInput, type DeleteClipInput, type DeleteClipTreeInput, type DeleteVoiceoverInput, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, type DocumentAudioScript, type DocumentAudioScriptState, ENTITY_TIMELINE_PROJECTION_SCHEMA_VERSION, type EditorFoundation, type EntityGraphCommitOptions, EntityGraphHttpClient, type EntityGraphState, EntityTimelineEditor, type EntityTimelineIdFactory, EntityTimelineProjectionError, type EntityTimelineTrackRole, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImageMediaAssetFact, type ImplementedSemanticOpKind, type ImportedMediaAsset, type InitialDocumentFacts, type InsertCaptionClipInput, type InsertClipInput, type InsertMediaClipInput, type InsertMediaClipsInput, type InsertPlacedClipInput, type JournalEntry, LANE_KINDS_IN_STACK_ORDER, type LaneKind, type LinearClipSpeed, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type MediaAssetFact, type MediaClipInsertion, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type MoveClipInput, type MoveClipsToStartsInput, type MoveSequentialClipsInput, type MoveVoiceoverInput, type OpActor, type PartAggregation, type PartIdFactory, type PartKind, type PartUnion, type PatchCaptionStyleInput, PlainMemoryAdapter, type PlainMemoryAdapterOptions, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type ReplaceClipContentInput, type ReplaceMediaClipInput, type ReplaceSequentialClipsInput, type ReplacementMediaClipInput, type ResolvedEntityClipPlacement, type ResolvedEntityTimelineLayout, type ResolvedEntityTrack, SchemaValidator, ScriptCompositionError, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SequentialClipAnchor, type SetBgmInput, type SetCaptionVisibilityInput, type SetClipPlacementInput, type SetClipSpeedInput, type SetClipVolumeInput, type SnapshotReadable, type SolvedVideoDocument, type SpeechHostMap, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, type TrimClipInput, type UpdateClipInput, type UpdateClipMarkerInput, VIDEO_DOCUMENT_SCHEMA_VERSION, ValidationError, type VideoClipPart, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, type VideoDocumentSchemaVersion, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type VideoMediaAssetFact, type VisualMediaAssetFact, type VoiceMediaAssetFact, type VoiceoverCaptionFact, type VoiceoverTakeInput, type VoiceoverTakeResult, type WaitForServerAckOptions, applyEntityTimelineProjection, arrangeMainTrackSeamlessly, assembleCaptionContent, assembleEntityContent, assemblePhoneticScriptContent, assembleScriptText, assertCanonicalEditorResources, assertEntityProjectionPreservesLegacy, assertMediaAssetWritePolicy, assertValidVideoDocument, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, createEditSandbox, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, createPlainMemoryAdapter, decodeDocVersionMark, derivePositionFromAbs, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, ensureLaneTrack, fillMainTrackTimeGaps, findComposedAudioScript, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, importMediaAsset, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, migrateLegacyTimelineToEntities, partDurationMs, partUnionSchema, prepareCaptionContent, projectEntityTimeline, readDocumentAudioScript, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, replayJournal, resolveAllSpeechOverlaps, resolveEntityTimelineLayout, resolveSpeechOverlapByShiftingVideos, safeDurationMs, index_d_exports as schemas, selectAudioScriptSegments, snapshotToPlain, solveVideoDocument, speedOf, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema, writeVideoDocumentToDraft };

package/dist/index.js

@@ -218,13 +218,18 @@ function findSseFrameBoundary(buffer) {
 }
 //#endregion
 //#region src/entity-editor/document-audio-script.ts
-/** Resolve only the document association; other AudioScripts remain independent resources. */
+/**
+* Strict read of the project's one fixed AudioScript. The identity is immutable
+* for the project's lifetime; this never selects, clears, or switches a
+* script. Uninitialized or dangling identities are projection errors.
+*/
 function readDocumentAudioScript(state) {
 	const id = state.audioScriptEntityId;
-	if (id === null) return null;
-	if (typeof id !== "string" || id.trim() !== id || !id) throw new EntityTimelineProjectionError("Invalid document AudioScript association");
+	if (id === null) throw new EntityTimelineProjectionError("Document AudioScript is not initialized");
+	if (typeof id !== "string" || id.trim() !== id || !id) throw new EntityTimelineProjectionError("Invalid document AudioScript identity");
+	if (state.rows.entities.filter((row) => row.entityKind === "audio-script").length !== 1) throw new EntityTimelineProjectionError("Editor requires exactly one AudioScript");
 	const entity = state.rows.entities.find((row) => row.entityId === id);
-	if (!entity || entity.entityKind !== "audio-script") throw new EntityTimelineProjectionError(`Document AudioScript ${id} must name an AudioScript in this document`);
+	if (!entity || entity.entityKind !== "audio-script") throw new EntityTimelineProjectionError(`Document AudioScript ${id} must name the project AudioScript`);
 	const content = assembleEntityContent(state.rows, createEntityId(id));
 	assembleScriptText(content);
 	return {
@@ -251,6 +256,7 @@ const roleOrder$1 = {
 */
 function assertCanonicalEditorResources(rows) {
 	if (rows.entities.filter((row) => row.entityKind === "timeline").length > 1) throw new EntityTimelineProjectionError("Editor requires exactly one Timeline");
+	if (rows.entities.filter((row) => row.entityKind === "audio-script").length !== 1) throw new EntityTimelineProjectionError("Editor requires exactly one AudioScript");
 	for (const role of Object.keys(roleOrder$1)) if (rows.entities.filter((row) => row.entityKind === "track" && row.payload.role === role).length > 1) throw new EntityTimelineProjectionError(`Editor has multiple ${role} Tracks`);
 	const identityByAssetKey = /* @__PURE__ */ new Map();
 	const kinds = new Map(rows.entities.map((row) => [String(row.entityId), row.entityKind]));
@@ -312,6 +318,26 @@ function memotaLocator(value) {
 		key: value.key
 	};
 }
+/**
+* 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.
+*/
+function ensureDocumentAudioScript(entities, idFactory) {
+	const scripts = entities.filter((row) => row.entityKind === "audio-script");
+	if (scripts.length > 1) throw new EntityTimelineProjectionError("Editor requires exactly one AudioScript");
+	const existing = scripts[0];
+	if (existing !== void 0) return existing.entityId;
+	const id = createEntityId(idFactory("entity"));
+	if (entities.some((row) => row.entityId === id)) throw new Error(`Duplicate entity id ${id}`);
+	entities.push({
+		entityId: id,
+		entityKind: "audio-script",
+		payload: { segments: [] }
+	});
+	return id;
+}
 /** Add only missing editor structure; existing identities and owned settings are never replaced. */
 function ensureEditorFoundation(initial, idFactory = (prefix) => `${prefix}_${globalThis.crypto.randomUUID()}`, timelinePayload = {}) {
 	const entities = structuredClone([...initial.entities]);
@@ -364,13 +390,15 @@ function ensureEditorFoundation(initial, idFactory = (prefix) => `${prefix}_${gl
 		}
 		trackEntityIds[role] = track.entityId;
 	}
+	const audioScriptEntityId = ensureDocumentAudioScript(entities, idFactory);
 	return {
 		rows: {
 			entities,
 			relations
 		},
 		timelineEntityId: timeline.entityId,
-		trackEntityIds
+		trackEntityIds,
+		audioScriptEntityId
 	};
 }
 //#endregion
@@ -406,10 +434,11 @@ var EntityGraphHttpClient = class {
 		const baseRows = cloneAndValidateRows(baseState.rows);
 		const next = cloneAndValidateRows(nextRows);
 		assertMediaAssetWritePolicy(baseRows, next);
-		const audioScriptEntityId = options.audioScriptEntityId === void 0 ? baseState.audioScriptEntityId : options.audioScriptEntityId;
+		const scriptRows = next.entities.filter((row) => row.entityKind === "audio-script");
+		if (scriptRows.length !== 1) throw new EntityTimelineProjectionError("Editor requires exactly one AudioScript");
 		readDocumentAudioScript({
 			rows: next,
-			audioScriptEntityId
+			audioScriptEntityId: scriptRows[0].entityId
 		});
 		const nextEntityIds = new Set(next.entities.map((row) => row.entityId));
 		const nextRelationIds = new Set(next.relations.map((row) => row.relationId));
@@ -419,7 +448,6 @@ var EntityGraphHttpClient = class {
 			method: "POST",
 			body: JSON.stringify({
 				expected_revision: baseState.revision,
-				audio_script_entity_id: audioScriptEntityId,
 				rows: toWireRows(next),
 				deleted_entity_ids: deletedEntityIds,
 				deleted_relation_ids: deletedRelationIds,
@@ -442,12 +470,11 @@ function parseWireState(value, expectedDocId) {
 	if (value.doc_id !== expectedDocId) throw new Error(`Entity-state response doc_id mismatch: expected "${expectedDocId}"`);
 	const rows = parseWireRows(value.rows);
 	decodeEntityRelationRows(rows, numericMarkerValidation$1);
-	const audioScriptEntityId = value.audio_script_entity_id;
-	if (audioScriptEntityId !== null && typeof audioScriptEntityId !== "string") throw new Error("Invalid document AudioScript association");
+	if (typeof value.audio_script_entity_id !== "string") throw new Error("Document AudioScript is not initialized");
 	const state = {
 		revision: value.revision,
 		rows,
-		audioScriptEntityId
+		audioScriptEntityId: value.audio_script_entity_id
 	};
 	readDocumentAudioScript(state);
 	return state;
@@ -1961,6 +1988,7 @@ function migrateLegacyTimelineToEntities(legacy, assetFacts, initial = {
 	const normalizedMainRanges = overlapNormalizedMainRanges(legacy);
 	let entities = structuredClone([...initial.entities]);
 	let relations = structuredClone([...initial.relations]);
+	const documentAudioScriptEntityId = ensureDocumentAudioScript(entities, idFactory);
 	const addEntity = (kind, payload, existingId) => {
 		const entityId = createEntityId(existingId ?? idFactory("entity"));
 		if (entities.some((row) => row.entityId === entityId)) fail(`Migration entity identity collision: ${entityId}`);
@@ -2023,7 +2051,7 @@ function migrateLegacyTimelineToEntities(legacy, assetFacts, initial = {
 			relations = [...imported.rows.relations];
 			contentByPartId.set(item.part_id, imported.contentEntityId);
 			const phonemeScript = speech.phoneme_script;
-			ensureSpeechPhoneticChain(imported.contentEntityId, speech.audio_script, typeof phonemeScript === "string" ? phonemeScript : void 0, entities, relations, addEntity, link);
+			ensureSpeechPhoneticChain(imported.contentEntityId, speech.audio_script, typeof phonemeScript === "string" ? phonemeScript : void 0, entities, relations, addEntity, link, documentAudioScriptEntityId);
 		} else if (part.bgm !== void 0) {
 			const bgm = part.bgm;
 			const fact = facts.get(bgm.origin_media_id);
@@ -2469,7 +2497,7 @@ function requirePart(document, partId) {
 	if (part === void 0) fail(`Placed Clip ${partId} has no part payload`);
 	return part;
 }
-function ensureSpeechPhoneticChain(voiceEntityId, audioScriptText, phonemeScript, entities, relations, addEntity, link) {
+function ensureSpeechPhoneticChain(voiceEntityId, audioScriptText, phonemeScript, entities, relations, addEntity, link, documentAudioScriptEntityId) {
 	const renders = relations.filter((relation) => relation.relationKind === "phonetic-script-render" && relation.endpoint0EntityId === voiceEntityId);
 	if (renders.length > 1) fail(`Voice ${voiceEntityId} has ambiguous PhoneticScript provenance`);
 	if (renders.length === 1) {
@@ -2479,11 +2507,23 @@ function ensureSpeechPhoneticChain(voiceEntityId, audioScriptText, phonemeScript
 		if (script === void 0 || scriptText(script) !== audioScriptText) fail(`Voice ${voiceEntityId} conflicts with the legacy Speech script`);
 		return phonetic.entityId;
 	}
+	const script = entities.find((entity) => entity.entityId === documentAudioScriptEntityId);
+	if (script === void 0 || script.entityKind !== "audio-script") fail("Migration must carry the fixed document AudioScript");
+	const segments = script.payload.segments;
+	if (Array.isArray(segments) && segments.length > 0) {
+		if (scriptText(script) !== audioScriptText) fail(`Voice ${voiceEntityId} conflicts with the project AudioScript text`);
+	} else {
+		const scriptIndex = entities.findIndex((row) => row.entityId === script.entityId);
+		entities[scriptIndex] = {
+			...script,
+			payload: { segments: [{
+				segmentId: "segment-0",
+				text: audioScriptText
+			}] }
+		};
+	}
 	const phonetic = addEntity("phonetic-script", {
-		baseEntityIds: [addEntity("audio-script", { segments: [{
-			segmentId: "segment-0",
-			text: audioScriptText
-		}] })],
+		baseEntityIds: [script.entityId],
 		...phonemeScript === void 0 ? {} : { phonemeScript }
 	});
 	link("phonetic-script-render", voiceEntityId, phonetic);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mengine/medeo-client",
-  "version": "1.3.1-alpha.8",
+  "version": "1.3.1-alpha.9",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -27,9 +27,9 @@
     "immer": "^10.2.0",
     "loro-mirror": "^2.2.0",
     "zod": "^4.4.3",
-    "@mengine/storage": "1.3.1-alpha.8",
-    "@mengine/sync": "1.3.1-alpha.8",
-    "@mengine/utils": "1.3.1-alpha.8"
+    "@mengine/storage": "1.3.1-alpha.9",
+    "@mengine/sync": "1.3.1-alpha.9",
+    "@mengine/utils": "1.3.1-alpha.9"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",