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

package/dist/{script-session-lXpqmupK.mjs → entity-sandbox-OArq9NSH.mjs}

@@ -1,138 +1,4 @@
-import { SchemaValidator, SemanticEditor, assertCanonicalEditorResources, createEditSandbox, effectiveVideoClipDurationMs, ensureEditorFoundation, fromVideoDocument, importMediaAsset, readDocumentAudioScript, solveVideoDocument, speedOf } from "@mengine/medeo-client";
-//#region src/document/compact-projection.ts
-const DEFAULT_TEXT_PREVIEW_LENGTH = 24;
-/** Kind tag shown in the first column (`video_clip` → `clip`). */
-function kindTag(kind) {
-	return kind === "video_clip" ? "clip" : kind;
-}
-/** Lane label: `video_clip` tracks display as `main`, otherwise `parts_kind`. */
-function laneLabel(partsKind) {
-	return partsKind === "video_clip" ? "main" : partsKind;
-}
-/** Speed token: absent → `1`; linear → numeric multiplier; anything else → `custom`. */
-function speedToken(speedShift) {
-	if (speedShift == null) return "1";
-	if (speedShift.category === "linear") return String(speedOf(speedShift));
-	return "custom";
-}
-function effectiveDurationMs(part, timelineDurationMs) {
-	if (part.video_clip != null) return effectiveVideoClipDurationMs(part.video_clip);
-	if (part.speech != null) return part.speech.media_duration_ms ?? 0;
-	if (part.caption != null) return part.caption.initial_duration_ms ?? 0;
-	if (part.bgm != null) return timelineDurationMs;
-	return 0;
-}
-function truncateText(text, budget) {
-	if (text.length <= budget) return text;
-	return `${text.slice(0, budget)}…`;
-}
-function anchorToken(timePosition) {
-	if (timePosition.mode === "anchored") return `anchor=${timePosition.anchorPartId}+${timePosition.offsetMs}`;
-	if (timePosition.mode === "absolute") return "anchor=abs";
-	return "anchor=abs";
-}
-function clipAttrs(clip) {
-	const playIn = clip.play_in ?? 0;
-	const playOut = clip.play_out ?? 0;
-	return `media=${clip.origin_media_id ?? ""} trim=${playIn}-${playOut} speed=${speedToken(clip.speed_shift)} vol=${clip.volume ?? 0}`;
-}
-function partAttrs(part, item, textPreviewLength) {
-	if (part.video_clip != null) return clipAttrs(part.video_clip);
-	if (part.speech != null) return `${anchorToken(item.time_position)} dur=${part.speech.media_duration_ms ?? 0}`;
-	if (part.caption != null) {
-		const preview = truncateText(part.caption.text ?? "", textPreviewLength);
-		return `${anchorToken(item.time_position)} text="${preview}"`;
-	}
-	if (part.bgm != null) return `vol=${part.bgm.volume ?? 0}`;
-	return "";
-}
-/**
-* Render a `VideoDocument` as compact text: one header line plus one row per
-* timeline part (optionally filtered by `onlyPartIds`). Deterministic and
-* side-effect free — same document always yields the same string.
-*/
-function renderCompactProjection(document, options) {
-	const onlyPartIds = options?.onlyPartIds;
-	const textPreviewLength = options?.textPreviewLength ?? DEFAULT_TEXT_PREVIEW_LENGTH;
-	const solved = solveVideoDocument(document);
-	const library = document.part_library ?? {};
-	const tracks = document.tracks ?? [];
-	let totalParts = 0;
-	const rows = [];
-	for (const track of tracks) {
-		const partsKind = track.parts_kind;
-		if (partsKind == null) continue;
-		const lane = laneLabel(partsKind);
-		const tag = kindTag(partsKind);
-		for (const item of track.items ?? []) {
-			totalParts += 1;
-			const partId = item.part_id;
-			if (onlyPartIds != null && !onlyPartIds.has(partId)) continue;
-			const part = library[partId];
-			if (part == null) continue;
-			const abs = solved.absByPartId.get(partId) ?? 0;
-			const dur = effectiveDurationMs(part, solved.durationMs);
-			const attrs = partAttrs(part, item, textPreviewLength);
-			rows.push(`${tag} ${partId} ${lane} [${abs},${abs + dur}) ${attrs}`);
-		}
-	}
-	return [`# draft=${document.meta.draft_id ?? ""} v=${document.meta.version ?? 0} duration=${solved.durationMs} parts=${totalParts} shown=${rows.length}`, ...rows].join("\n");
-}
-//#endregion
-//#region src/sandbox/preview.ts
-/**
-* Collect part ids referenced by a journal for compact preview filtering.
-* Walks known id-shaped payload keys (宁多勿少) and unions `generated_ids`.
-*/
-const PART_ID_KEYS = new Set([
-	"clip_id",
-	"clip_ids",
-	"before_clip_id",
-	"after_clip_id",
-	"speech_id",
-	"speech_ids",
-	"speech_part_id",
-	"caption_id",
-	"caption_ids",
-	"bgm_id",
-	"anchor_part_id",
-	"part_id",
-	"body_part_id"
-]);
-/** Extract every part id a journal entry touches (payload refs + minted ids). */
-function collectAffectedPartIds(journal) {
-	const ids = /* @__PURE__ */ new Set();
-	for (const entry of journal) {
-		for (const generated of entry.generated_ids ?? []) if (generated.length > 0) ids.add(generated);
-		collectFromValue(entry.payload, ids);
-	}
-	return ids;
-}
-function collectFromValue(value, ids) {
-	if (value == null) return;
-	if (Array.isArray(value)) {
-		for (const item of value) collectFromValue(item, ids);
-		return;
-	}
-	if (typeof value !== "object") return;
-	for (const [key, child] of Object.entries(value)) {
-		if (PART_ID_KEYS.has(key)) {
-			if (typeof child === "string" && child.length > 0) ids.add(child);
-			else if (Array.isArray(child)) {
-				for (const item of child) if (typeof item === "string" && item.length > 0) ids.add(item);
-			}
-		}
-		collectFromValue(child, ids);
-	}
-}
-/**
-* Render a ChangePlan preview: header + rows for journal-affected parts only.
-* Empty journal → empty `onlyPartIds` (header alone), matching the T2 contract.
-*/
-function renderPreview(document, journal) {
-	return renderCompactProjection(document, { onlyPartIds: journal.length === 0 ? /* @__PURE__ */ new Set() : collectAffectedPartIds(journal) });
-}
-//#endregion
+import { applyFieldChanges, assertCanonicalEditorResources, assertFieldChanges, ensureEditorFoundation, importMediaAsset, readDocumentAudioScript } from "@mengine/medeo-client";
 //#region ../medeo-dsl/src/entities.ts
 function hasSequence(entity) {
 	if (isKnownNonSequenceKind(entity.entityKind) || isReservedEntityKind(entity.entityKind)) return false;
@@ -1560,12 +1426,17 @@ function businessFacades(entities, relations) {
 			create: (input) => {
 				if (input.entity_kind === "asset") throw new Error("Asset entities are managed by host assembly");
 				assertBusinessPayload(input.payload);
+				if (input.entity_id && entities.get(input.entity_id)) throw new Error(`Entity id ${input.entity_id} already exists`);
 				return entities.create(input);
 			},
 			update: (input) => {
 				assertBusiness(input.entity_id);
-				assertBusinessPayload(input.payload);
-				entities.update(input);
+				if (!Array.isArray(input.changes)) throw new Error("entities.update requires changes");
+				for (const change of input.changes) {
+					if (infrastructureFields.has(change.path?.[0])) throw new Error("Field is managed by host assembly");
+					if (change.path?.[0] === "baseEntityIds" && change.op === "list.insert" && typeof change.value === "string") assertBusiness(change.value);
+				}
+				entities.changeFields(input);
 			},
 			declareFields: (input) => {
 				assertBusiness(input.entity_id);
@@ -1581,9 +1452,7 @@ function businessFacades(entities, relations) {
 				}
 				for (const relation of incident) relations.unlink({ relation_id: relation.relation_id });
 				entities.delete(input);
-			},
-			readCaptionContent: (input) => entities.readCaptionContent(input),
-			readPhoneticScriptContent: (input) => entities.readPhoneticScriptContent(input)
+			}
 		},
 		relations: {
 			list: () => relations.list().filter(visibleRelation),
@@ -1599,14 +1468,11 @@ function businessFacades(entities, relations) {
 				if (relation && !visibleRelation(relation)) throw new Error("Asset bindings are managed by host assembly");
 				relations.unlink(input);
 			},
-			linkGenerated: (input) => {
-				assertBusiness(input.output_entity_id);
-				assertBusiness(input.input_entity_id);
-				return relations.linkGenerated(input);
-			},
-			linkClipAnchor: (input) => relations.linkClipAnchor(input),
-			linkPhoneticScriptRender: (input) => relations.linkPhoneticScriptRender(input),
-			linkAudioScriptSource: (input) => relations.linkAudioScriptSource(input)
+			update: (input) => {
+				const relation = relations.list().find((row) => row.relation_id === input.relation_id);
+				if (relation && !visibleRelation(relation)) throw new Error("Asset bindings are managed by host assembly");
+				relations.update(input);
+			}
 		}
 	};
 }
@@ -1646,10 +1512,14 @@ var EntitySandbox = class {
 	}
 	/** Host-owned fixed structure is journaled through the same CAS graph as model edits. */
 	ensureFoundation(timelinePayload = {}) {
-		const foundation = ensureEditorFoundation(toDslRows(this.state), this.idFactory, timelinePayload);
+		const foundation = ensureEditorFoundation(toDslRows(this.state), this.idFactory, timelinePayload, this.state.audioScriptEntityId);
 		this.appendResourceRows(foundation.rows);
 		if (this.state.audioScriptEntityId === null) this.state.audioScriptEntityId = foundation.audioScriptEntityId;
 	}
+	/** Host assembly resolves the text owner before a resource Caption is complete. */
+	captionAudioScriptId(entityId) {
+		return findComposedAudioScript(toDslRows(this.state), createEntityId(entityId), "caption").entityId;
+	}
 	get audioScriptEntityId() {
 		return this.state.audioScriptEntityId;
 	}
@@ -1688,6 +1558,12 @@ var EntitySandbox = class {
 			case "create-entity":
 				lines.push(`+ entity ${command.entity.entity_id} kind=${command.entity.entity_kind}`);
 				break;
+			case "change-relation":
+				lines.push(`~ relation ${command.relation_id} ${command.changes.map((c) => c.op).join(", ")}`);
+				break;
+			case "change-entity":
+				lines.push(`~ entity ${command.entity_id} ${command.changes.map((c) => c.op).join(", ")}`);
+				break;
 			case "update-entity":
 				lines.push(`~ entity ${command.entity_id} payload`);
 				break;
@@ -1742,6 +1618,7 @@ var EntitySandbox = class {
 				});
 			},
 			create: (input) => this.createEntity(input),
+			changeFields: (input) => this.changeEntity(input),
 			update: (input) => {
 				assertTrimmed(input.entity_id, "entity_id");
 				if (!this.state.entities.some((entity) => entity.entity_id === input.entity_id)) throw new Error(`Entity id "${input.entity_id}" does not exist`);
@@ -1755,12 +1632,28 @@ var EntitySandbox = class {
 				const current = this.state.entities.find((entity) => entity.entity_id === input.entity_id);
 				if (current === void 0) throw new Error(`Unknown entity "${input.entity_id}"`);
 				assembleEntityContent(toDslRows(this.state), createEntityId(input.entity_id));
+				const payload = {
+					...current.payload,
+					...input.payload
+				};
+				const rows = toDslRows({
+					...this.state,
+					entities: this.state.entities.map((row) => row.entity_id === input.entity_id ? {
+						...row,
+						payload
+					} : row)
+				});
+				for (const row of rows.entities) assembleEntityContent(rows, row.entityId);
+				const assembled = assembleEntityContent(rows, createEntityId(input.entity_id));
+				const issues = validateEntity(createEntityRef({
+					...assembled.payload,
+					entityId: assembled.entityId,
+					entityKind: assembled.entityKind
+				}));
+				if (issues.length) throw new Error(issues.map((issue) => issue.message).join("; "));
 				this.replaceOwnedPayload({
 					entity_id: input.entity_id,
-					payload: {
-						...current.payload,
-						...input.payload
-					}
+					payload
 				});
 			},
 			delete: (input) => this.deleteEntity(input),
@@ -1780,7 +1673,8 @@ var EntitySandbox = class {
 			linkClipAnchor: (input) => this.linkClipAnchor(input),
 			linkPhoneticScriptRender: (input) => this.linkPhoneticScriptRender(input),
 			linkAudioScriptSource: (input) => this.linkAudioScriptSource(input),
-			unlink: (input) => this.unlinkRelation(input)
+			unlink: (input) => this.unlinkRelation(input),
+			update: (input) => this.changeRelation(input)
 		};
 	}
 	createEntity(input) {
@@ -1804,10 +1698,6 @@ var EntitySandbox = class {
 		}
 		const entityId = input.entity_id ?? this.idFactory("entity");
 		assertTrimmed(entityId, "entity_id");
-		if (input.entity_kind === "audio-script") {
-			const existing = this.state.entities.find((entity) => entity.entity_kind === "audio-script");
-			if (existing !== void 0 && existing.entity_id !== entityId) throw new Error(`Editor requires exactly one AudioScript; edit ${existing.entity_id} instead of creating ${entityId}`);
-		}
 		const entity = {
 			entity_id: entityId,
 			entity_kind: input.entity_kind,
@@ -1818,6 +1708,10 @@ var EntitySandbox = class {
 			entityId: createEntityId(entityId),
 			entityKind: entity.entity_kind
 		});
+		assembleEntityContent(toDslRows({
+			...this.state,
+			entities: [...this.state.entities, entity]
+		}), createEntityId(entityId));
 		this.record({
 			kind: "create-entity",
 			entity
@@ -1848,6 +1742,22 @@ var EntitySandbox = class {
 			payload
 		});
 	}
+	changeEntity(input) {
+		assertFieldChanges(input.changes);
+		this.record({
+			kind: "change-entity",
+			entity_id: input.entity_id,
+			changes: clone(input.changes)
+		});
+	}
+	changeRelation(input) {
+		assertFieldChanges(input.changes);
+		this.record({
+			kind: "change-relation",
+			relation_id: input.relation_id,
+			changes: clone(input.changes)
+		});
+	}
 	deleteEntity(input) {
 		assertTrimmed(input.entity_id, "entity_id");
 		this.record({
@@ -1893,12 +1803,11 @@ var EntitySandbox = class {
 		}
 	}
 	link(input) {
-		if (input.relation_kind === "generated") throw new Error("Author generated Relations with relations.linkGenerated({ output_entity_id, input_entity_id })");
 		const spec = builtInRelationSpecs.find((candidate) => candidate.kind === input.relation_kind);
 		if (spec == null) throw new Error(`Unknown Relation kind "${String(input.relation_kind)}"`);
 		const relation = this.relationFromInput(input, input.relation_kind);
 		const [first, second] = this.refsFor(relation);
-		new BiRelationIndex().link({
+		new BiRelationIndex().linkRuntime({
 			relationId: createRelationId(relation.relation_id),
 			spec,
 			endpoints: [first, second],
@@ -2036,10 +1945,9 @@ var EntitySandbox = class {
 	apply(command, enforceIdentity) {
 		switch (command.kind) {
 			case "create-entity": {
-				if (command.entity.entity_kind === "audio-script" && this.state.entities.some((entity) => entity.entity_kind === "audio-script")) throw new Error("The project AudioScript already exists; edit its segments instead");
 				if (enforceIdentity && this.state.entities.some((entity) => entity.entity_id === command.entity.entity_id)) throw new Error(`Entity id "${command.entity.entity_id}" already exists`);
 				const original = this.original.entities.find((entity) => entity.entity_id === command.entity.entity_id);
-				if (enforceIdentity && original != null && original.entity_kind !== command.entity.entity_kind) throw new Error(`Entity id "${command.entity.entity_id}" was originally kind "${original.entity_kind}" and cannot be recreated as "${command.entity.entity_kind}"`);
+				if (enforceIdentity && original != null) throw new Error(`Entity id "${command.entity.entity_id}" was originally kind "${original.entity_kind}" and cannot be recreated as "${command.entity.entity_kind}"`);
 				this.state.entities.push(clone(command.entity));
 				if (command.entity.entity_kind === "audio-script" && this.state.audioScriptEntityId === null) this.state.audioScriptEntityId = command.entity.entity_id;
 				return;
@@ -2055,8 +1963,66 @@ var EntitySandbox = class {
 				};
 				return;
 			}
+			case "change-entity": {
+				const original = this.state;
+				this.state = cloneSnapshot(original);
+				try {
+					const touched = new Set([command.entity_id]);
+					for (const change of command.changes) {
+						if (change.path[0] === "baseEntityIds" && change.op === "list.move") throw new Error("Composition bases are unordered; list.move is not applicable");
+						const owner = resolveEntityFieldOwner(toDslRows(this.state), createEntityId(command.entity_id), change.path[0]);
+						const row = this.state.entities.find((row) => row.entity_id === owner);
+						row.payload = applyFieldChanges(row.payload, [change]);
+						touched.add(owner);
+					}
+					const rows = toDslRows(this.state);
+					for (const row of rows.entities) {
+						const assembled = assembleEntityContent(rows, row.entityId);
+						if (touched.has(row.entityId)) {
+							const issues = validateEntity(createEntityRef({
+								...assembled.payload,
+								entityId: row.entityId,
+								entityKind: row.entityKind
+							}));
+							if (issues.length) throw new Error(issues.map((issue) => issue.message).join("; "));
+						}
+					}
+				} catch (error) {
+					this.state = original;
+					throw error;
+				}
+				return;
+			}
+			case "change-relation": {
+				const index = this.state.relations.findIndex((row) => row.relation_id === command.relation_id);
+				if (index < 0) throw new Error(`Unknown relation ${command.relation_id}`);
+				for (const change of command.changes) if (!["metadata", "trace"].includes(change.path[0]) || change.path.length < 2) throw new Error("Relation changes may only edit metadata or trace fields");
+				const current = this.state.relations[index];
+				const fields = applyFieldChanges({
+					metadata: current.metadata,
+					trace: current.trace
+				}, command.changes);
+				const next = {
+					...current,
+					metadata: fields.metadata,
+					trace: fields.trace
+				};
+				const spec = builtInRelationSpecs.find((spec) => spec.kind === next.relation_kind);
+				new BiRelationIndex().linkRuntime({
+					relationId: createRelationId(next.relation_id),
+					spec,
+					endpoints: this.refsFor(next),
+					metadata: next.metadata,
+					trace: next.trace
+				});
+				this.state.relations[index] = next;
+				return;
+			}
 			case "delete-entity": {
-				if (this.state.entities.find((entity) => entity.entity_id === command.entity_id)?.entity_kind === "audio-script") throw new Error("The document AudioScript is a fixed project identity and cannot be deleted");
+				const target = this.state.entities.find((entity) => entity.entity_id === command.entity_id);
+				if (target && (target.entity_kind === "timeline" || target.entity_id === this.state.audioScriptEntityId)) throw new Error("An entity attached to the project editor cannot be deleted");
+				const dependents = this.state.entities.filter((entity) => Array.isArray(entity.payload.baseEntityIds) && entity.payload.baseEntityIds.includes(command.entity_id));
+				if (dependents.length) throw new Error(`Entity ${command.entity_id} is still referenced by variants: ${dependents.map((row) => row.entity_id).join(", ")}`);
 				const index = this.state.entities.findIndex((entity) => entity.entity_id === command.entity_id);
 				if (index < 0) throw new Error(`Entity id "${command.entity_id}" does not exist`);
 				const incidentRelationIds = this.state.relations.filter((relation) => relation.endpoint_0_entity_id === command.entity_id || relation.endpoint_1_entity_id === command.entity_id).map((relation) => relation.relation_id).sort();
@@ -2130,350 +2096,6 @@ const numericMarkerComparators = { compareMarkerPoints: (_marker, _range, left,
 	return left - right;
 } };
 //#endregion
-//#region src/sandbox/script-session.ts
-const LOG_LINE_MAX = 2e3;
-const LOG_LINE_CAP = 1e3;
-const LOG_BYTE_CAP = 64 * 1024;
-const TRUNCATE_MARK = "[truncated]";
-const LOG_TRUNCATED = "[log truncated]";
-const ENTITY_CHECKPOINT_INDEX = Symbol("entityCheckpointIndex");
-/** Session core for one forked document; globals stay identity-stable across rollback. */
-var EditSandboxSession = class {
-	original;
-	idFactory;
-	onEntry;
-	onLog;
-	onTruncate;
-	entitySandbox;
-	current;
-	/** Adapter journal length already accounted for — new slices are real commits. */
-	adapterJournalSeen = 0;
-	entries = [];
-	logs = [];
-	logBytes = 0;
-	logCapped = false;
-	edit;
-	timeline;
-	entities;
-	relations;
-	console;
-	checkpoint;
-	rollbackTo;
-	constructor(document, options) {
-		this.original = structuredClone(document);
-		this.idFactory = options?.idFactory;
-		this.onEntry = options?.onEntry;
-		this.onLog = options?.onLog;
-		this.onTruncate = options?.onTruncate;
-		this.entitySandbox = new EntitySandbox({
-			state: options?.entityState,
-			idFactory: options?.domainIdFactory ?? (() => {
-				throw new Error("Entity id factory is unavailable in this sandbox host");
-			}),
-			onCommand: options?.onEntityCommand,
-			onTruncate: options?.onEntityTruncate
-		});
-		this.current = this.boot(structuredClone(this.original));
-		this.adapterJournalSeen = this.current.adapter.journal.length;
-		this.edit = this.buildEditFacade();
-		this.timeline = this.buildTimelineFacade();
-		this.entities = this.entitySandbox.entities;
-		this.relations = this.entitySandbox.relations;
-		this.console = this.buildConsoleShim();
-		this.checkpoint = () => {
-			const checkpoint = { index: this.entries.length };
-			Object.defineProperty(checkpoint, ENTITY_CHECKPOINT_INDEX, {
-				value: this.entitySandbox.commandCount,
-				enumerable: false
-			});
-			return checkpoint;
-		};
-		this.rollbackTo = (cp) => this.doRollbackTo(cp);
-	}
-	/** Assemble a ChangePlan from the self-maintained journal + current preview. */
-	buildPlan(baseVersion) {
-		const entityCommands = this.entitySandbox.getCommands();
-		if (this.entries.length > 0 && entityCommands.length > 0) throw new Error("A sandbox plan cannot mix timeline and entity mutations; run and commit them as separate plans");
-		const entityPlan = this.entitySandbox.buildPlan();
-		const planKind = entityCommands.length > 0 ? "entities" : "timeline";
-		return {
-			plan_kind: planKind,
-			doc_id: this.original.meta.draft_id ?? "",
-			base_version: baseVersion,
-			ops: this.entries.slice(),
-			entity_base_revision: entityPlan.base_revision,
-			entity_commands: entityPlan.commands,
-			...planKind === "entities" ? { entity_rows: entityPlan.rows } : {},
-			...planKind === "entities" ? {
-				deleted_entity_ids: entityPlan.deleted_entity_ids,
-				deleted_relation_ids: entityPlan.deleted_relation_ids
-			} : {},
-			preview: planKind === "entities" ? this.entitySandbox.renderPreview() : renderPreview(this.current.adapter.snapshot(), this.entries),
-			logs: this.logs.slice()
-		};
-	}
-	getEntries() {
-		return this.entries;
-	}
-	getLogs() {
-		return this.logs;
-	}
-	boot(document) {
-		const sandbox = createEditSandbox(document, this.idFactory != null ? { idFactory: this.idFactory } : void 0);
-		return {
-			adapter: sandbox.adapter,
-			editor: sandbox.editor
-		};
-	}
-	doRollbackTo(cp) {
-		if (cp.index > this.entries.length) throw new Error(`rollbackTo: checkpoint index ${cp.index} is past journal length ${this.entries.length}`);
-		const prefix = this.entries.slice(0, cp.index);
-		const next = this.boot(structuredClone(this.original));
-		replayJournalSync(next.adapter, prefix);
-		this.entries.length = 0;
-		this.entries.push(...prefix);
-		this.current = next;
-		this.adapterJournalSeen = next.adapter.journal.length;
-		this.onTruncate?.(prefix.length);
-		const entityIndex = cp[ENTITY_CHECKPOINT_INDEX];
-		if (entityIndex !== void 0) this.entitySandbox.rollbackTo(entityIndex);
-	}
-	captureNewEntries() {
-		const journal = this.current.adapter.journal;
-		if (journal.length <= this.adapterJournalSeen) return;
-		const fresh = journal.slice(this.adapterJournalSeen);
-		this.adapterJournalSeen = journal.length;
-		for (const entry of fresh) {
-			this.entries.push(entry);
-			this.onEntry?.(entry);
-		}
-	}
-	appendLog(line) {
-		if (this.logCapped) return;
-		if (this.logs.length >= LOG_LINE_CAP || this.logBytes >= LOG_BYTE_CAP) {
-			this.logs.push(LOG_TRUNCATED);
-			this.logCapped = true;
-			this.onLog?.(LOG_TRUNCATED);
-			return;
-		}
-		let out = line;
-		if (out.length > LOG_LINE_MAX) out = `${out.slice(0, LOG_LINE_MAX - 11)}${TRUNCATE_MARK}`;
-		this.logs.push(out);
-		this.logBytes += out.length;
-		this.onLog?.(out);
-	}
-	buildConsoleShim() {
-		const write = (...args) => {
-			this.appendLog(args.map(formatLogArg).join(" "));
-		};
-		return {
-			log: write,
-			info: write,
-			warn: write,
-			error: write
-		};
-	}
-	buildEditFacade() {
-		const wrap = (method) => async (input) => {
-			await method(this.current.editor, input);
-			this.captureNewEntries();
-		};
-		return {
-			addSpeeches: wrap((e, i) => e.addSpeeches(i)),
-			addVideoClips: async (input) => {
-				const needsAppend = input.before_clip_id == null && input.after_clip_id == null && input.clips.some((clip) => clip.start_ms == null);
-				const appendAt = this.timeline.snapshot().timeline?.duration_ms ?? 0;
-				const normalized = needsAppend ? {
-					...input,
-					clips: input.clips.map((clip) => clip.start_ms == null ? {
-						...clip,
-						start_ms: appendAt
-					} : clip)
-				} : input;
-				await this.current.editor.addVideoClips(normalized);
-				this.captureNewEntries();
-			},
-			adjustBgmVolume: wrap((e, i) => e.adjustBgmVolume(i)),
-			adjustSpeechVolume: wrap((e, i) => e.adjustSpeechVolume(i)),
-			adjustVideoClipDuration: wrap((e, i) => e.adjustVideoClipDuration(i)),
-			adjustVideoClipVolume: wrap((e, i) => e.adjustVideoClipVolume(i)),
-			changeSpeechScript: wrap((e, i) => e.changeSpeechScript(i)),
-			changeSpeechVoice: wrap((e, i) => e.changeSpeechVoice(i)),
-			deleteBgm: wrap((e, i) => e.deleteBgm(i)),
-			deleteSpeeches: wrap((e, i) => e.deleteSpeeches(i)),
-			deleteVideoClips: wrap((e, i) => e.deleteVideoClips(i)),
-			moveSpeeches: wrap((e, i) => e.moveSpeeches(i)),
-			moveVideoClips: wrap((e, i) => e.moveVideoClips(i)),
-			moveVideoClipsByAnchor: wrap((e, i) => e.moveVideoClipsByAnchor(i)),
-			replaceVideoClipContent: wrap((e, i) => e.replaceVideoClipContent(i)),
-			replaceVideoClipSequence: wrap((e, i) => e.replaceVideoClipSequence(i)),
-			setBgm: wrap((e, i) => e.setBgm(i)),
-			setCaptionStyle: wrap((e, i) => e.setCaptionStyle(i)),
-			setCaptionVisibility: wrap((e, i) => e.setCaptionVisibility(i)),
-			setVideoClipSpeedShift: wrap((e, i) => e.setVideoClipSpeedShift(i))
-		};
-	}
-	buildTimelineFacade() {
-		return {
-			snapshot: () => fromVideoDocument(this.current.adapter.snapshot()),
-			clipsInRange: (startMs, endMs) => this.clipsInRange(startMs, endMs),
-			part: (id) => this.part(id)
-		};
-	}
-	clipsInRange(startMs, endMs) {
-		const document = this.current.adapter.snapshot();
-		const solved = solveVideoDocument(document);
-		const library = document.part_library ?? {};
-		const main = document.tracks?.find((track) => track.parts_kind === "video_clip");
-		const out = [];
-		for (const item of main?.items ?? []) {
-			const id = item.part_id;
-			if (id == null) continue;
-			const clip = library[id]?.video_clip;
-			if (clip == null) continue;
-			const start = solved.absByPartId.get(id) ?? 0;
-			const duration = effectiveVideoClipDurationMs(clip);
-			const end = start + duration;
-			const mid = start + duration / 2;
-			if (!(mid >= startMs && mid < endMs)) continue;
-			out.push({
-				id,
-				start_ms: start,
-				end_ms: end,
-				duration_ms: duration,
-				speed_shift: clip.speed_shift,
-				volume: clip.volume,
-				media_id: clip.origin_media_id
-			});
-		}
-		return out;
-	}
-	part(id) {
-		const document = this.current.adapter.snapshot();
-		const part = (document.part_library ?? {})[id];
-		if (part == null) return null;
-		let lane = "main";
-		let kind = "video_clip";
-		for (const track of document.tracks ?? []) {
-			if (!(track.items ?? []).some((item) => item.part_id === id)) continue;
-			const partsKind = track.parts_kind ?? "video_clip";
-			kind = partsKind;
-			lane = partsKind === "video_clip" ? "main" : partsKind;
-			break;
-		}
-		const solved = solveVideoDocument(document);
-		const start = solved.absByPartId.get(id) ?? 0;
-		let duration = 0;
-		if (part.video_clip != null) duration = effectiveVideoClipDurationMs(part.video_clip);
-		else if (part.speech != null) duration = part.speech.media_duration_ms ?? 0;
-		else if (part.caption != null) duration = part.caption.initial_duration_ms ?? 0;
-		else if (part.bgm != null) duration = solved.durationMs;
-		return {
-			id,
-			kind,
-			lane,
-			start_ms: start,
-			end_ms: start + duration,
-			duration_ms: duration,
-			part
-		};
-	}
-};
-function formatLogArg(value) {
-	if (typeof value === "string") return value;
-	if (typeof value === "number" || typeof value === "boolean" || value === null || value === void 0) return String(value);
-	try {
-		return JSON.stringify(value);
-	} catch {
-		return "[unstringifiable]";
-	}
-}
-/**
-* Synchronous journal replay for rollback. Editor methods are `async` only for
-* interface uniformity — their bodies complete before the Promise is returned,
-* so voiding the call applies mutations in-order without yielding.
-*/
-function replayJournalSync(adapter, journal) {
-	const queue = [];
-	const idFactory = (_prefix) => {
-		const id = queue.shift();
-		if (id == null) throw new Error("unrecorded id");
-		return id;
-	};
-	const editor = new SemanticEditor(adapter, new SchemaValidator(), idFactory);
-	for (const entry of journal) {
-		queue.push(...entry.generated_ids ?? []);
-		const payload = entry.payload;
-		switch (entry.kind) {
-			case "MoveVideoClips":
-				editor.moveVideoClips(payload);
-				break;
-			case "MoveVideoClipsByAnchor":
-				editor.moveVideoClipsByAnchor(payload);
-				break;
-			case "DeleteVideoClips":
-				editor.deleteVideoClips(payload);
-				break;
-			case "AddVideoClips":
-				editor.addVideoClips(payload);
-				break;
-			case "AdjustVideoClipVolume":
-				editor.adjustVideoClipVolume(payload);
-				break;
-			case "SetVideoClipSpeedShift":
-				editor.setVideoClipSpeedShift(payload);
-				break;
-			case "ReplaceVideoClipContent":
-				editor.replaceVideoClipContent(payload);
-				break;
-			case "ReplaceVideoClipSequence":
-				editor.replaceVideoClipSequence(payload);
-				break;
-			case "AdjustVideoClipDuration":
-				editor.adjustVideoClipDuration(payload);
-				break;
-			case "AddSpeeches":
-				editor.addSpeeches(payload);
-				break;
-			case "DeleteSpeeches":
-				editor.deleteSpeeches(payload);
-				break;
-			case "MoveSpeeches":
-				editor.moveSpeeches(payload);
-				break;
-			case "ChangeSpeechScript":
-				editor.changeSpeechScript(payload);
-				break;
-			case "ChangeSpeechVoice":
-				editor.changeSpeechVoice(payload);
-				break;
-			case "AdjustSpeechVolume":
-				editor.adjustSpeechVolume(payload);
-				break;
-			case "SetCaptionVisibility":
-				editor.setCaptionVisibility(payload);
-				break;
-			case "SetCaptionStyle":
-				editor.setCaptionStyle(payload);
-				break;
-			case "SetBgm":
-				editor.setBgm(payload);
-				break;
-			case "DeleteBgm":
-				editor.deleteBgm(payload);
-				break;
-			case "AdjustBgmVolume":
-				editor.adjustBgmVolume(payload);
-				break;
-			default: {
-				const _exhaustive = entry.kind;
-				throw new Error(`replayJournalSync: unsupported kind ${String(_exhaustive)}`);
-			}
-		}
-		if (queue.length > 0) throw new Error("unconsumed ids");
-	}
-}
-//#endregion
-export { createEntityId as a, collectAffectedPartIds as c, businessState as i, renderPreview as l, EntitySandbox as n, createRelationId as o, businessFacades as r, isMediaAssetVariantKind as s, EditSandboxSession as t, renderCompactProjection as u };
+export { createEntityId as a, businessState as i, toDslRows as n, createRelationId as o, businessFacades as r, isMediaAssetVariantKind as s, EntitySandbox as t };
 
-//# sourceMappingURL=script-session-lXpqmupK.mjs.map
+//# sourceMappingURL=entity-sandbox-OArq9NSH.mjs.map