@mengine/medeo-client 2.0.1-alpha.28 → 2.0.1-alpha.29

package/dist/{document-DcpvSvQK.js → document-B3RLmTzA.js}

@@ -1,9 +1,9 @@
 import { u as volumeSchema } from "./shared-iWnU2osE.js";
 import { Mirror, schema, validateSchema } from "loro-mirror";
 import { z } from "zod";
-import { LoroDoc, LoroMap, LoroMovableList, LoroText, UndoManager } from "loro-crdt";
 import { sha256 } from "@noble/hashes/sha2.js";
-import { bytesToHex } from "@noble/hashes/utils.js";
+import { bytesToHex, utf8ToBytes } from "@noble/hashes/utils.js";
+import { LoroDoc, LoroMap, LoroMovableList, LoroText, UndoManager } from "loro-crdt";
 import { produce } from "immer";
 //#region src/client/base64.ts
 function bytesToBase64(bytes) {
@@ -1508,6 +1508,7 @@ const ENTITY_KINDS = Object.freeze({
 	]),
 	voice: Object.freeze(["Container", "IPBound"]),
 	"sequence-marker": Object.freeze([]),
+	script: Object.freeze(["SegmentText"]),
 	"audio-script": Object.freeze(["SegmentText", "MediaFile"]),
 	"phonetic-script": Object.freeze(["SegmentText", "MediaFile"]),
 	caption: Object.freeze([
@@ -1809,6 +1810,32 @@ function entityToRow(entity) {
 	};
 }
 //#endregion
+//#region ../medeo-dsl/src/script-content.ts
+/** Canonical text used to identify one immutable professional Script version. */
+function normalizeScriptText(text) {
+	return text.normalize("NFC").replaceAll("\r\n", "\n").replaceAll("\r", "\n").split("\n").map((line) => line.trimEnd()).join("\n");
+}
+/** Preserve segment identity, boundaries and order while removing textual encoding noise. */
+function normalizeScriptSegments(segments) {
+	return segments.map(({ segmentId, text, language }) => ({
+		segmentId,
+		text: normalizeScriptText(text),
+		...language === void 0 ? {} : { language: language.normalize("NFC").trim() }
+	}));
+}
+/** Content identity: ordered canonical text with array boundaries, never local ids or language metadata. */
+function scriptContentHash(segments) {
+	return `sha256:${bytesToHex(sha256(utf8ToBytes(JSON.stringify(normalizeScriptSegments(segments).map((segment) => segment.text)))))}`;
+}
+//#endregion
+//#region ../medeo-dsl/src/script-revision.ts
+const HASH = /^sha256:[0-9a-f]{64}$/;
+function readScriptRevisionTrace(value) {
+	if (!isJsonObject(value)) return null;
+	if (Object.keys(value).length !== 4 || value.command !== "revise-script" || typeof value.editId !== "string" || value.editId.trim() !== value.editId || value.editId === "" || typeof value.sourceContentHash !== "string" || !HASH.test(value.sourceContentHash) || typeof value.resultContentHash !== "string" || !HASH.test(value.resultContentHash)) return null;
+	return value;
+}
+//#endregion
 //#region ../medeo-dsl/src/invariants.ts
 /** An entity is made from at most one Asset; two would leave its bytes ambiguous. */
 /** Validates one complete set of entities and its authoritative Relation rows. */
@@ -1848,6 +1875,38 @@ function validateEntityRelationSet(entityRefs, index) {
 		issues.push(...validateSequenceComposition(entity));
 	}
 	issues.push(...validateClipAnchorCycles(entities, index));
+	issues.push(...validateScriptRevisionRelations(entities, index));
+	return issues;
+}
+function validateScriptRevisionRelations(entities, index) {
+	const byId = new Map(entities.map((entity) => [entity.entityId, entity.current()]));
+	const seenRelations = /* @__PURE__ */ new Set();
+	const editIds = /* @__PURE__ */ new Set();
+	const parentCounts = /* @__PURE__ */ new Map();
+	const issues = [];
+	for (const entity of entities) for (const relation of index.relationsOf(entity)) {
+		const row = relation.toRow();
+		if (row == null || seenRelations.has(row.relationId)) continue;
+		seenRelations.add(row.relationId);
+		const result = byId.get(row.endpoint0EntityId);
+		const source = byId.get(row.endpoint1EntityId);
+		if (row.relationKind !== "derived-from" || result?.entityKind !== "script" || source?.entityKind !== "script") continue;
+		const trace = readScriptRevisionTrace(row.trace);
+		const invalid = trace == null || trace.resultContentHash !== result.contentHash || trace.sourceContentHash !== source.contentHash || trace.resultContentHash === trace.sourceContentHash || trace != null && editIds.has(trace.editId);
+		if (trace != null) editIds.add(trace.editId);
+		const parentCount = (parentCounts.get(row.endpoint0EntityId) ?? 0) + 1;
+		parentCounts.set(row.endpoint0EntityId, parentCount);
+		if (invalid) issues.push({
+			code: "invalid_script_revision",
+			entityId: row.endpoint0EntityId,
+			message: "Script revision requires one canonical revise-script trace matching distinct result and source text"
+		});
+		if (parentCount > 1) issues.push({
+			code: "invalid_script_revision",
+			entityId: row.endpoint0EntityId,
+			message: "A Script revision may name exactly one source Script"
+		});
+	}
 	return issues;
 }
 function validateMarkerUse(marker, index) {
@@ -2068,7 +2127,7 @@ function validateKnownEntityPayload(entity) {
 	const value = entity;
 	const problems = [];
 	if (value.lifecycle !== void 0 && !isRecord(value.lifecycle)) problems.push("lifecycle must be an object when present");
-	if (entity.entityKind === "audio-script" || entity.entityKind === "phonetic-script") {
+	if (entity.entityKind === "script" || entity.entityKind === "audio-script" || entity.entityKind === "phonetic-script") {
 		for (const key of [
 			"durationMs",
 			"extent",
@@ -2109,6 +2168,9 @@ function validateKnownEntityPayload(entity) {
 		case "audio-script":
 			validateScriptPayload(value, problems);
 			break;
+		case "script":
+			validateProfessionalScriptPayload(value, problems);
+			break;
 		case "phonetic-script":
 			validatePhoneticScriptPayload(value, problems);
 			break;
@@ -2284,6 +2346,24 @@ function validateScriptPayload(value, problems) {
 		if (segment.language !== void 0 && typeof segment.language !== "string") problems.push(`segments[${index}].language must be a string when present`);
 	}
 }
+function validateProfessionalScriptPayload(value, problems) {
+	validateScriptPayload(value, problems);
+	if (!Array.isArray(value.segments) || !value.segments.every(isCompleteScriptSegment)) return;
+	const segments = value.segments;
+	if (segments.length === 0) problems.push("segments must contain at least one screenplay segment");
+	const ids = segments.map((segment) => segment.segmentId);
+	if (ids.some((id) => id.trim() === "")) problems.push("segmentId must be a non-empty trimmed string");
+	if (ids.some((id) => id.trim() !== id)) problems.push("segmentId must be a non-empty trimmed string");
+	if (new Set(ids).size !== ids.length) problems.push("segmentId must be unique within the Script");
+	const normalized = normalizeScriptSegments(segments);
+	if (normalized.some((segment) => segment.text === "")) problems.push("segment text must be non-empty after normalization");
+	if (segments.some((segment, index) => segment.text !== normalized[index].text)) problems.push("segment text must use canonical NFC, LF line endings, and trimmed line endings");
+	if (segments.some((segment, index) => segment.language !== normalized[index].language)) problems.push("segment language must be canonical NFC and trimmed when present");
+	if (typeof value.contentHash !== "string" || value.contentHash !== scriptContentHash(segments)) problems.push("contentHash must equal the SHA-256 of the canonical ordered segment texts");
+}
+function isCompleteScriptSegment(value) {
+	return isRecord(value) && typeof value.segmentId === "string" && typeof value.text === "string" && (value.language === void 0 || typeof value.language === "string");
+}
 function validateOptionalField(value, key, expectedType, problems) {
 	if (value[key] !== void 0 && typeof value[key] !== expectedType) problems.push(`${key} must be a ${expectedType} when present`);
 }
@@ -2342,6 +2422,7 @@ function isOwnedLocalEntityValuePath(entityKind, path) {
 	if (entityKind === "voice" && /^voice\.(?:system|key|name)$/.test(path)) return true;
 	if (entityKind === "caption" && (path.startsWith("style.") || path === "selection.segmentId")) return true;
 	if ([
+		"script",
 		"audio-script",
 		"caption",
 		"phonetic-script"
@@ -2351,6 +2432,7 @@ function isOwnedLocalEntityValuePath(entityKind, path) {
 function isOwnedLocalIdPath(entityKind, path) {
 	if (path === "lifecycle.actorId") return true;
 	if ([
+		"script",
 		"audio-script",
 		"caption",
 		"phonetic-script"
@@ -2517,7 +2599,7 @@ const derivedFromRelationSpec = Object.freeze({
 	kind: "derived-from",
 	ordered: true,
 	sequenced: false,
-	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(MEDIA_VARIANT_KINDS), new Set(MEDIA_VARIANT_KINDS)) || hasKinds(endpoints, new Set(["voiceover-recording"]), new Set(["phonetic-script"])) || hasKinds(endpoints, new Set(["audio-script"]), new Set(MEDIA_AUDIBLE_KINDS)) || hasKinds(endpoints, new Set(["audio-script"]), new Set(["audio-script"])),
+	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(MEDIA_VARIANT_KINDS), new Set(MEDIA_VARIANT_KINDS)) || hasKinds(endpoints, new Set(["voiceover-recording"]), new Set(["phonetic-script"])) || hasKinds(endpoints, new Set(["video"]), new Set(["script"])) || hasKinds(endpoints, new Set(["script"]), new Set(["script"])) || hasKinds(endpoints, new Set(["audio-script"]), new Set(MEDIA_AUDIBLE_KINDS)) || hasKinds(endpoints, new Set(["audio-script"]), new Set(["audio-script"])),
 	validateMetadata: isEmptyMetadata
 });
 const captionAlignmentRelationSpec = Object.freeze({
@@ -2652,6 +2734,7 @@ var BiRelationIndex = class {
 	}
 	/** Author `derived-from(product, source)` without exposing positional arguments. */
 	linkDerivedFrom(input) {
+		if (input.product.current().entityKind === "script" && input.source.current().entityKind === "script") throw new Error("Script revision provenance is host-authored by reviseScript");
 		return this.linkValidated({
 			relationId: input.relationId,
 			spec: derivedFromRelationSpec,
@@ -2900,10 +2983,27 @@ var InvalidEntityRelationTransitionError = class extends Error {
 function validateEntityRelationTransition(before, candidate) {
 	const issues = [];
 	const previous = new Map(before.relations.map((row) => [row.relationId, row]));
+	const beforeEntities = new Map(before.entities.map((row) => [row.entityId, row]));
+	const candidateEntities = new Map(candidate.entities.map((row) => [row.entityId, row]));
+	const revisionEditIds = new Set(before.relations.filter((relation) => isScriptRevision(relation, beforeEntities)).map((relation) => readScriptRevisionTrace(relation.trace)?.editId).filter((editId) => editId !== void 0));
+	const revisionParents = /* @__PURE__ */ new Map();
+	for (const entity of before.entities) if (entity.entityKind === "script" && !candidateEntities.has(entity.entityId)) issues.push(`Script entity "${entity.entityId}" is immutable history and cannot be deleted or replaced`);
 	for (const relation of candidate.relations) {
+		if (isScriptRevision(relation, candidateEntities)) {
+			const count = (revisionParents.get(relation.endpoint0EntityId) ?? 0) + 1;
+			revisionParents.set(relation.endpoint0EntityId, count);
+			if (count > 1) issues.push(`Script "${relation.endpoint0EntityId}" may name only one revision source`);
+		}
 		const original = previous.get(relation.relationId);
 		if (original == null) {
 			if (relation.relationKind === "caption-alignment") issues.push(`new caption-alignment relation "${relation.relationId}" is forbidden`);
+			if (isScriptRevision(relation, candidateEntities)) {
+				const trace = readScriptRevisionTrace(relation.trace);
+				const result = candidateEntities.get(relation.endpoint0EntityId);
+				const source = candidateEntities.get(relation.endpoint1EntityId);
+				if (trace == null || beforeEntities.has(relation.endpoint0EntityId) || !beforeEntities.has(relation.endpoint1EntityId) || trace.resultContentHash !== result.payload.contentHash || trace.sourceContentHash !== source.payload.contentHash || trace.resultContentHash === trace.sourceContentHash || revisionEditIds.has(trace.editId)) issues.push(`Script revision relation "${relation.relationId}" must be one canonical new-result to existing-source edit`);
+				else revisionEditIds.add(trace.editId);
+			}
 			continue;
 		}
 		if (original.relationKind !== relation.relationKind || original.endpoint0EntityId !== relation.endpoint0EntityId || original.endpoint1EntityId !== relation.endpoint1EntityId) {
@@ -2912,9 +3012,13 @@ function validateEntityRelationTransition(before, candidate) {
 		}
 		if (!sameJson(original.metadata, relation.metadata)) issues.push(`relation "${relation.relationId}" changed semantic metadata without a new identity`);
 		if (relation.relationKind === "caption-alignment" && !sameJson(original.trace, relation.trace)) issues.push(`legacy caption-alignment relation "${relation.relationId}" may only be carried unchanged or deleted`);
+		if (isScriptRevision(relation, candidateEntities) && !sameJson(original.trace, relation.trace)) issues.push(`Script revision relation "${relation.relationId}" trace is immutable`);
 	}
 	if (issues.length > 0) throw new InvalidEntityRelationTransitionError(issues);
 }
+function isScriptRevision(relation, entities) {
+	return relation.relationKind === "derived-from" && entities.get(relation.endpoint0EntityId)?.entityKind === "script" && entities.get(relation.endpoint1EntityId)?.entityKind === "script";
+}
 function sameJson(left, right) {
 	if (left === right) return true;
 	if (Array.isArray(left) && Array.isArray(right)) return left.length === right.length && left.every((value, index) => sameJson(value, right[index]));
@@ -3204,6 +3308,7 @@ function projectEntityTimeline(rows) {
 				media_duration_ms: placement.duration,
 				audio_storage_key: storageKey(asset),
 				origin_speech_id: external.key,
+				...synthesized ? {} : { origin_asset_system: "memota" },
 				audio_script: assembled?.text ?? (transcript === void 0 ? "" : assembleScriptText(transcript)),
 				volume: volume.data,
 				voice: object(voice) ? {
@@ -4005,11 +4110,13 @@ var LoroEntityDocument = class LoroEntityDocument {
 	}
 	/** The callback and every domain validation execute on a causally complete fork first. */
 	transact(edit) {
+		const before = readEntityDocument(this.doc, true);
 		const probe = this.doc.fork();
 		const draft = new LoroEntityDraft(probe);
 		edit(draft);
 		draft.captureSelectionBaselines();
 		const state = readEntityDocument(probe);
+		validateEntityRelationTransition(before.rows, state.rows);
 		assertState(state);
 		this.validate?.(state);
 		materialize(probe);
@@ -4023,8 +4130,15 @@ var LoroEntityDocument = class LoroEntityDocument {
 			from
 		});
 	}
-	/** Import preserves native operation identities; projection errors never discard remote operations. */
+	/** Validate remote operations on a fork before importing their native identities. */
 	import(update) {
+		const before = readEntityDocument(this.doc, true);
+		const probe = this.doc.fork();
+		probe.import(update);
+		const candidate = readEntityDocument(probe, true);
+		validateEntityRelationTransition(before.rows, candidate.rows);
+		assertState(candidate);
+		this.validate?.(candidate);
 		this.doc.import(update);
 		const state = this.snapshot();
 		assertState(state);
@@ -4140,6 +4254,7 @@ var LoroEntityDraft = class {
 		});
 	}
 	delete(entityId) {
+		if (workspace(this.doc, family(this.doc, entityId)).get("kind") === "script") throw new Error("Script entities are immutable history and cannot be deleted");
 		this.record({
 			type: "delete",
 			root: family(this.doc, entityId)
@@ -4241,6 +4356,7 @@ var LoroEntityDraft = class {
 		});
 	}
 	replaceOwned(entityId, payload) {
+		this.assertGenericMutationAllowed(entityId);
 		this.record({
 			type: "write",
 			root: family(this.doc, entityId),
@@ -4251,6 +4367,7 @@ var LoroEntityDraft = class {
 	editText(entityId, path, start, deleteCount, text) {
 		if (typeof path[0] !== "string") throw new Error("Text path must start with a field");
 		const owner = resolveEntityFieldOwner(this.snapshot().rows, createEntityId(currentId(this.doc, entityId)), path[0]);
+		this.assertGenericMutationAllowed(owner);
 		this.record({
 			type: "text",
 			root: family(this.doc, owner),
@@ -4276,6 +4393,7 @@ var LoroEntityDraft = class {
 			const owner = resolveEntityFieldOwner(state.rows, id, change.path[0]);
 			const row = state.rows.entities.find((row) => row.entityId === owner);
 			if (equalJson(row.payload, applyFieldChanges(row.payload, [change]))) continue;
+			this.assertGenericMutationAllowed(owner);
 			this.record({
 				type: "field",
 				root: family(this.doc, owner),
@@ -4285,6 +4403,9 @@ var LoroEntityDraft = class {
 			});
 		}
 	}
+	assertGenericMutationAllowed(entityId) {
+		if (workspace(this.doc, family(this.doc, entityId)).get("kind") === "script") throw new Error("Script content is immutable; create a new Script revision");
+	}
 	changeRelation(relationId, changes) {
 		assertFieldChanges(changes);
 		const key = this.relationRoot(relationId);

package/dist/{index-BYv9FPSS.d.ts → index-DaabF2vA.d.ts}

@@ -736,7 +736,8 @@ type VideoClipPart = Omit<VideoClipPart$1, 'duration_ms'>;
  * from it by the projection.
  */
 type SpeechPart = Omit<SpeechPart$1, 'duration_ms'> & {
-  media_duration_ms?: number | undefined;
+  media_duration_ms?: number | undefined; /** Compatibility discriminator for already-recorded Audio projected as speech. */
+  origin_asset_system?: 'memota' | undefined;
 };
 /**
  * Authoritative caption part. The IDL `CaptionPart` carries `duration_ms` (the
@@ -1286,7 +1287,7 @@ declare function buildInitialVideoDocument(): VideoDocument;
 //#endregion
 //#region ../medeo-dsl/src/sandbox.d.ts
 /** Kinds a script can author. */
-type EntityKind = 'timeline' | 'track' | 'clip' | 'sequence-marker' | 'video' | 'audio' | 'voiceover-recording' | 'image' | 'voice' | 'audio-script' | 'phonetic-script' | 'caption';
+type EntityKind = 'timeline' | 'track' | 'clip' | 'sequence-marker' | 'video' | 'audio' | 'voiceover-recording' | 'image' | 'voice' | 'script' | 'audio-script' | 'phonetic-script' | 'caption';
 type RelationKind = 'contain' | 'marker' | 'clip-anchor' | 'voice-timbre' | 'caption-alignment' | 'derived-from';
 //#endregion
 //#region ../medeo-dsl/src/ids.d.ts

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as index_d_exports } from "./index-CMa6ZCtX.js";
-import { $ as derivePositionFromAbs, A as assertValidVideoDocument, At as VideoDraftContent, B as EntityRow, Bt as Track$1, C as isImplementedSemanticOpKind, Ct as TrackItem, D as PartIdFactory, Dt as VideoDocumentValidationIssue, E as ValidationError, Et as VideoDocument, F as ResolvedEntityTrack, Ft as CaptionPart$1, G as VoiceDescriptor, H as CaptionSegmentSelection, I as resolveEntityTimelineLayout, It as CaptionStyle, J as EntityId, K as JsonObject, L as projectEntityTimeline, Lt as PartAggregation, M as EntityTimelineTrackRole, Mt as effectiveVideoClipDurationMs, N as ResolvedEntityClipPlacement, Nt as speedOf, O as generatePartId, Ot as VideoDocumentValidationIssueCode, P as ResolvedEntityTimelineLayout, Pt as Attachment, Q as buildSpeechHostMap, R as EntityTimelineProjectionError, Rt as SpeedShift, S as SemanticOpKind, St as Track, T as SnapshotReadable, Tt as VideoClipPart, U as CaptionStyleFields, V as RelationRow, Vt as TrackItem$1, W as ScriptTextSegment, X as DerivedItemPosition, Y as buildInitialVideoDocument, Z as SpeechHostMap, _ as SemanticOpName, _t as DEFAULT_UNIT_TIME_MS, a as PlainMemoryAdapter, at as ensureLaneTrack, b as ImplementedSemanticOpKind, bt as SpeechPart, c as MirrorVideoDocumentAdapter, ct as solveVideoDocument, d as createMirrorVideoDocumentAdapter, dt as VideoDocumentDraft, et as fromVideoDocument, f as CommitOptions, ft as VideoDocumentMirrorSchema, g as SemanticOpInput, gt as CaptionPart, h as SemanticEditor, ht as CaptionDisplayCue, i as JournalEntry, it as SolvedVideoDocument, j as validateVideoDocument, jt as VideoDraftPartUnion, k as VideoDocumentValidationError, kt as VideoDraft, l as MirrorVideoDocumentOptions, lt as TrackDraft, m as SemanticDocumentAdapter, mt as BgmPart, n as videoDocumentSchema, nt as LANE_KINDS_IN_STACK_ORDER, o as PlainMemoryAdapterOptions, ot as findLaneTrack, p as OpActor, pt as videoDocumentMirrorSchema, q as JsonValue, r as readVideoDocumentFromDraft, rt as LaneKind, s as createPlainMemoryAdapter, st as laneTrackId, t as partUnionSchema, tt as toVideoDocument, u as createMirrorVideoDocument, ut as TrackItemDraft, v as TransactAudit, vt as PartKind, w as SchemaValidator, wt as TrackItemTimePosition, x as PlannedSemanticOpKind, xt as Timeline, y as IMPLEMENTED_SEMANTIC_OP_KINDS, yt as PartUnion, z as EntityRelationRows, zt as Timeline$1 } from "./index-BYv9FPSS.js";
+import { $ as derivePositionFromAbs, A as assertValidVideoDocument, At as VideoDraftContent, B as EntityRow, Bt as Track$1, C as isImplementedSemanticOpKind, Ct as TrackItem, D as PartIdFactory, Dt as VideoDocumentValidationIssue, E as ValidationError, Et as VideoDocument, F as ResolvedEntityTrack, Ft as CaptionPart$1, G as VoiceDescriptor, H as CaptionSegmentSelection, I as resolveEntityTimelineLayout, It as CaptionStyle, J as EntityId, K as JsonObject, L as projectEntityTimeline, Lt as PartAggregation, M as EntityTimelineTrackRole, Mt as effectiveVideoClipDurationMs, N as ResolvedEntityClipPlacement, Nt as speedOf, O as generatePartId, Ot as VideoDocumentValidationIssueCode, P as ResolvedEntityTimelineLayout, Pt as Attachment, Q as buildSpeechHostMap, R as EntityTimelineProjectionError, Rt as SpeedShift, S as SemanticOpKind, St as Track, T as SnapshotReadable, Tt as VideoClipPart, U as CaptionStyleFields, V as RelationRow, Vt as TrackItem$1, W as ScriptTextSegment, X as DerivedItemPosition, Y as buildInitialVideoDocument, Z as SpeechHostMap, _ as SemanticOpName, _t as DEFAULT_UNIT_TIME_MS, a as PlainMemoryAdapter, at as ensureLaneTrack, b as ImplementedSemanticOpKind, bt as SpeechPart, c as MirrorVideoDocumentAdapter, ct as solveVideoDocument, d as createMirrorVideoDocumentAdapter, dt as VideoDocumentDraft, et as fromVideoDocument, f as CommitOptions, ft as VideoDocumentMirrorSchema, g as SemanticOpInput, gt as CaptionPart, h as SemanticEditor, ht as CaptionDisplayCue, i as JournalEntry, it as SolvedVideoDocument, j as validateVideoDocument, jt as VideoDraftPartUnion, k as VideoDocumentValidationError, kt as VideoDraft, l as MirrorVideoDocumentOptions, lt as TrackDraft, m as SemanticDocumentAdapter, mt as BgmPart, n as videoDocumentSchema, nt as LANE_KINDS_IN_STACK_ORDER, o as PlainMemoryAdapterOptions, ot as findLaneTrack, p as OpActor, pt as videoDocumentMirrorSchema, q as JsonValue, r as readVideoDocumentFromDraft, rt as LaneKind, s as createPlainMemoryAdapter, st as laneTrackId, t as partUnionSchema, tt as toVideoDocument, u as createMirrorVideoDocument, ut as TrackItemDraft, v as TransactAudit, vt as PartKind, w as SchemaValidator, wt as TrackItemTimePosition, x as PlannedSemanticOpKind, xt as Timeline, y as IMPLEMENTED_SEMANTIC_OP_KINDS, yt as PartUnion, z as EntityRelationRows, zt as Timeline$1 } from "./index-DaabF2vA.js";
 import { LoroDoc, PeerID } from "loro-crdt";
 import { DocState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";
@@ -880,7 +880,7 @@ declare class LoroEntityDocument {
   getVersion(id: string): EntityRow | undefined;
   /** The callback and every domain validation execute on a causally complete fork first. */
   transact(edit: (draft: LoroEntityDraft) => void): Uint8Array;
-  /** Import preserves native operation identities; projection errors never discard remote operations. */
+  /** Validate remote operations on a fork before importing their native identities. */
   import(update: Uint8Array): void;
   /**
    * Bind a saved snapshot without rewriting text operations or resolving
@@ -924,6 +924,7 @@ declare class LoroEntityDraft {
   editText(entityId: string, path: readonly (string | number)[], start: number, deleteCount: number, text: string): void;
   /** Generic assembled-field edit compiled at the author's causal position. */
   change(entityId: string, changes: readonly FieldChange[]): void;
+  private assertGenericMutationAllowed;
   changeRelation(relationId: string, changes: readonly FieldChange[]): void;
   captureSelectionBaselines(): void;
   private record;

package/dist/index.js

@@ -1,8 +1,8 @@
-import { $ as fromVideoDocument, A as resolveEntityTimelineLayout, At as base64ToBytes, B as assembleScriptText, C as canonicalJson, Ct as safeDurationMs, D as resolveFieldPath, Dt as partUnionToDraft, E as assertFieldChanges, Et as speedOf, F as relationsTo, G as isJsonObject, H as selectAudioScriptSegment, I as ScriptCompositionError, J as hasSequence, K as createEntityId, L as assembleCaptionContent, M as validateEntityRelationTransition, N as decodeEntityRelationRows, O as projectEntityTimeline, Ot as recordEntries, P as relationsFrom, Q as derivePositionFromAbs, R as assembleEntityContent, S as scriptSourceAssetOf, St as partDurationMs, T as applyFieldChanges, Tt as effectiveVideoClipDurationMs, U as updateEntityFields, V as findComposedAudioScript, W as variantBaseEntityIds, X as buildInitialVideoDocument, Y as isMediaAssetVariantKind, Z as buildSpeechHostMap, _ as audioScriptAssetHash, _t as resolveAllSpeechOverlaps, a as createMirrorVideoDocument, at as videoDocumentSchema, b as phoneticScriptAssetHash, bt as TIMELINE_SKELETON_DURATION_MS, c as DocumentMutationGuard, ct as findLaneTrack, d as LoroEntityDraft, dt as solveVideoDocument, et as toVideoDocument, f as readEntityDocument, ft as cascadeAfterVideoClipChanges, g as audioScriptAssetFields, gt as recalculateTimelineDuration, h as audioScriptAssetContent, ht as reassignSpeechesToVideoClipsByTime, i as MirrorVideoDocumentAdapter, it as partUnionSchema, j as EntityTimelineProjectionError, jt as bytesToBase64, k as EntityProjectionGraph, kt as videoDocumentMirrorSchema, l as LORO_ENTITY_SCHEMA, lt as hasResolvedPlacement, m as entityOrderGroups, mt as fillMainTrackTimeGaps, n as createPlainMemoryAdapter, nt as assertValidVideoDocument, o as createMirrorVideoDocumentAdapter, ot as LANE_KINDS_IN_STACK_ORDER, p as readEntityRelationRecords, pt as arrangeMainTrackSeamlessly, q as createRelationId, r as generatePartId, rt as validateVideoDocument, s as readVideoDocumentFromDraft, st as ensureLaneTrack, t as PlainMemoryAdapter, tt as VideoDocumentValidationError, u as LoroEntityDocument, ut as laneTrackId, v as audioScriptAssetOf, vt as resolveSpeechOverlapByShiftingVideos, w as equalJson, wt as DEFAULT_UNIT_TIME_MS, x as phoneticScriptAssetOf, xt as isEmptyVideoClip, y as phoneticScriptAssetContent, yt as syncAggregatedClipsTimePosition, z as assemblePhoneticScriptContent } from "./document-DcpvSvQK.js";
+import { $ as fromVideoDocument, A as resolveEntityTimelineLayout, At as base64ToBytes, B as assembleScriptText, C as canonicalJson, Ct as safeDurationMs, D as resolveFieldPath, Dt as partUnionToDraft, E as assertFieldChanges, Et as speedOf, F as relationsTo, G as isJsonObject, H as selectAudioScriptSegment, I as ScriptCompositionError, J as hasSequence, K as createEntityId, L as assembleCaptionContent, M as validateEntityRelationTransition, N as decodeEntityRelationRows, O as projectEntityTimeline, Ot as recordEntries, P as relationsFrom, Q as derivePositionFromAbs, R as assembleEntityContent, S as scriptSourceAssetOf, St as partDurationMs, T as applyFieldChanges, Tt as effectiveVideoClipDurationMs, U as updateEntityFields, V as findComposedAudioScript, W as variantBaseEntityIds, X as buildInitialVideoDocument, Y as isMediaAssetVariantKind, Z as buildSpeechHostMap, _ as audioScriptAssetHash, _t as resolveAllSpeechOverlaps, a as createMirrorVideoDocument, at as videoDocumentSchema, b as phoneticScriptAssetHash, bt as TIMELINE_SKELETON_DURATION_MS, c as DocumentMutationGuard, ct as findLaneTrack, d as LoroEntityDraft, dt as solveVideoDocument, et as toVideoDocument, f as readEntityDocument, ft as cascadeAfterVideoClipChanges, g as audioScriptAssetFields, gt as recalculateTimelineDuration, h as audioScriptAssetContent, ht as reassignSpeechesToVideoClipsByTime, i as MirrorVideoDocumentAdapter, it as partUnionSchema, j as EntityTimelineProjectionError, jt as bytesToBase64, k as EntityProjectionGraph, kt as videoDocumentMirrorSchema, l as LORO_ENTITY_SCHEMA, lt as hasResolvedPlacement, m as entityOrderGroups, mt as fillMainTrackTimeGaps, n as createPlainMemoryAdapter, nt as assertValidVideoDocument, o as createMirrorVideoDocumentAdapter, ot as LANE_KINDS_IN_STACK_ORDER, p as readEntityRelationRecords, pt as arrangeMainTrackSeamlessly, q as createRelationId, r as generatePartId, rt as validateVideoDocument, s as readVideoDocumentFromDraft, st as ensureLaneTrack, t as PlainMemoryAdapter, tt as VideoDocumentValidationError, u as LoroEntityDocument, ut as laneTrackId, v as audioScriptAssetOf, vt as resolveSpeechOverlapByShiftingVideos, w as equalJson, wt as DEFAULT_UNIT_TIME_MS, x as phoneticScriptAssetOf, xt as isEmptyVideoClip, y as phoneticScriptAssetContent, yt as syncAggregatedClipsTimePosition, z as assemblePhoneticScriptContent } from "./document-B3RLmTzA.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, LoroMap, UndoManager, VersionVector } from "loro-crdt";
 import { sha256 } from "@noble/hashes/sha2.js";
 import { bytesToHex } from "@noble/hashes/utils.js";
+import { LoroDoc, LoroMap, UndoManager, VersionVector } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
 import { DisposableSet, EventBus, Task } from "@mengine/utils";
 import { BaseDocStorage, DummyConnection } from "@mengine/storage";

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { c as MirrorVideoDocumentAdapter, kt as VideoDraft } from "./index-BYv9FPSS.js";
+import { c as MirrorVideoDocumentAdapter, kt as VideoDraft } from "./index-DaabF2vA.js";
 
 //#region src/testing/in-memory-mengine-server.d.ts
 /**

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { At as base64ToBytes, jt as bytesToBase64, o as createMirrorVideoDocumentAdapter } from "./document-DcpvSvQK.js";
+import { At as base64ToBytes, jt as bytesToBase64, o as createMirrorVideoDocumentAdapter } from "./document-B3RLmTzA.js";
 import { t as classifyUpdate } from "./loro-relay-doc-cJSY-uau.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": "2.0.1-alpha.28",
+  "version": "2.0.1-alpha.29",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -28,9 +28,9 @@
     "immer": "^10.2.0",
     "loro-mirror": "^2.3.3",
     "zod": "^4.4.3",
-    "@mengine/sync": "2.0.1-alpha.28",
-    "@mengine/utils": "2.0.1-alpha.28",
-    "@mengine/storage": "2.0.1-alpha.28"
+    "@mengine/storage": "2.0.1-alpha.29",
+    "@mengine/utils": "2.0.1-alpha.29",
+    "@mengine/sync": "2.0.1-alpha.29"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",