@mengine/medeo-client 1.2.0 → 1.2.1-alpha.1

package/dist/{document-C0o_cjAH.js → document-Dcu87api.js}

@@ -87,7 +87,8 @@ function jsonTransform() {
 const trackItem = schema.LoroMap({
 	part_id: schema.String(),
 	time_position: schema.String().transform(jsonTransform()),
-	fallback_abs_ms: schema.Number({ required: false })
+	fallback_abs_ms: schema.Number({ required: false }),
+	duration_override_ms: schema.Number({ required: false })
 });
 const track = schema.LoroMap({
 	id: schema.String(),
@@ -773,7 +774,8 @@ const trackItemTimePositionSchema = z.discriminatedUnion("mode", [
 const trackItemSchema = z.object({
 	part_id: z.string(),
 	time_position: trackItemTimePositionSchema,
-	fallback_abs_ms: finiteNumber.optional()
+	fallback_abs_ms: finiteNumber.optional(),
+	duration_override_ms: z.number().finite().positive().optional()
 }).passthrough();
 const trackSchema = z.object({
 	id: z.string().optional(),
@@ -1326,7 +1328,7 @@ function fromVideoDocument(document) {
 		above_main_tracks: aboveTracks.map((t) => draftTrack(t, view.absByPartId)),
 		below_main_tracks: belowTracks.map((t) => draftTrack(t, view.absByPartId)),
 		part_aggregations: view.aggregations,
-		part_library: toReadViewPartLibrary(view.partLibrary, view.durationMs, view.derivedFillerPartIds),
+		part_library: toReadViewPartLibrary(view.partLibrary, view.durationMs, view.derivedFillerPartIds, captionDurationOverrides(document)),
 		version: document.meta.version
 	};
 }
@@ -1347,7 +1349,7 @@ function fromVideoDocument(document) {
 * and they are not part of the document (see `fromVideoDocument`). An empty clip a
 * writer placed deliberately is NOT in that set and is projected normally.
 */
-function toReadViewPartLibrary(partLibrary, durationMs, derivedFillerPartIds) {
+function toReadViewPartLibrary(partLibrary, durationMs, derivedFillerPartIds, captionDurationByPartId) {
 	const out = {};
 	for (const [partId, part] of Object.entries(partLibrary)) {
 		if (derivedFillerPartIds.has(partId)) continue;
@@ -1367,7 +1369,7 @@ function toReadViewPartLibrary(partLibrary, durationMs, derivedFillerPartIds) {
 			const caption = clone(part.caption);
 			out[partId] = { caption: {
 				...caption,
-				duration_ms: caption.initial_duration_ms
+				duration_ms: captionDurationByPartId.get(partId) ?? caption.initial_duration_ms
 			} };
 		} else if (part.bgm != null) out[partId] = { bgm: {
 			...clone(part.bgm),
@@ -1376,6 +1378,14 @@ function toReadViewPartLibrary(partLibrary, durationMs, derivedFillerPartIds) {
 	}
 	return out;
 }
+function captionDurationOverrides(document) {
+	const result = /* @__PURE__ */ new Map();
+	for (const track of document.tracks ?? []) {
+		if (track.parts_kind !== "caption") continue;
+		for (const item of track.items ?? []) if (item.duration_override_ms != null) result.set(item.part_id, item.duration_override_ms);
+	}
+	return result;
+}
 /** Deep-clone a part payload, dropping the derived read-view `duration_ms`. */
 function omitDurationMs(part) {
 	const { duration_ms: _drop, ...rest } = clone(part);
@@ -1538,6 +1548,7 @@ function rowToTrack(row) {
 				time_position: item.time_position
 			};
 			if (item.fallback_abs_ms != null) result.fallback_abs_ms = item.fallback_abs_ms;
+			if (item.duration_override_ms != null) result.duration_override_ms = item.duration_override_ms;
 			return result;
 		})
 	};
@@ -1646,7 +1657,8 @@ function toTrackRow(track) {
 		items: (track.items ?? []).map((item) => ({
 			part_id: item.part_id,
 			time_position: item.time_position,
-			fallback_abs_ms: item.fallback_abs_ms
+			fallback_abs_ms: item.fallback_abs_ms,
+			duration_override_ms: item.duration_override_ms
 		}))
 	};
 }

package/dist/{index-DWVYLTjv.d.ts → index-CZlTzzrm.d.ts}

@@ -545,6 +545,8 @@ interface TrackItem {
   part_id: string;
   time_position: TrackItemTimePosition;
   fallback_abs_ms?: number | undefined;
+  /** Presentation window for this placement; currently used by caption resize. */
+  duration_override_ms?: number | undefined;
 }
 interface Track {
   id: string | undefined;
@@ -1320,6 +1322,14 @@ declare const replaceVideoClipSequenceInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ReplaceVideoClipSequenceInput = z.infer<typeof replaceVideoClipSequenceInputSchema>;
 //#endregion
+//#region src/editor/schemas/resize-caption.d.ts
+/** Resize one caption placement without changing its cue/source duration. */
+declare const resizeCaptionInputSchema: z.ZodObject<{
+  caption_id: z.ZodString;
+  duration_ms: z.ZodNumber;
+}, z.core.$strip>;
+type ResizeCaptionInput = z.infer<typeof resizeCaptionInputSchema>;
+//#endregion
 //#region src/editor/schemas/set-bgm.d.ts
 /**
  * Set the document BGM. The media's stable result (storage key) arrives
@@ -1538,7 +1548,7 @@ type SpeechAsset = z.infer<typeof speechAssetSchema>;
 type CaptionAsset = z.infer<typeof captionAssetSchema>;
 type SpeechAssets = z.infer<typeof speechAssetsSchema>;
 declare namespace index_d_exports {
-  export { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, AnchoredDeletePolicy, AnchoredReplacePolicy, CaptionAsset, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, MoveAnchor, MoveSpeechesInput, MoveVideoClipsByAnchorInput, MoveVideoClipsInput, MovedClipAnchoredPolicy, ReplaceVideoClipContentInput, ReplaceVideoClipSequenceInput, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput, SpeechAsset, SpeechAssets, addSpeechesInputSchema, addVideoClipsInputSchema, adjustBgmVolumeInputSchema, adjustSpeechVolumeInputSchema, adjustVideoClipDurationInputSchema, adjustVideoClipVolumeInputSchema, anchoredDeletePolicySchema, anchoredReplacePolicySchema, changeSpeechScriptInputSchema, changeSpeechVoiceInputSchema, clipIdSchema, clipIdsSchema, deleteBgmInputSchema, deleteSpeechesInputSchema, deleteVideoClipsInputSchema, mediaIdSchema, moveAnchorSchema, moveSpeechesInputSchema, moveVideoClipsByAnchorInputSchema, moveVideoClipsInputSchema, movedClipAnchoredPolicySchema, positiveMsSchema, replaceVideoClipContentInputSchema, replaceVideoClipSequenceInputSchema, setBgmInputSchema, setCaptionStyleInputSchema, setCaptionVisibilityInputSchema, setVideoClipSpeedShiftInputSchema, speechAssetsSchema, speechIdSchema, speechIdsSchema, speedShiftSchema, timelineMsSchema, voiceSchema, volumeSchema };
+  export { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, AnchoredDeletePolicy, AnchoredReplacePolicy, CaptionAsset, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, MoveAnchor, MoveSpeechesInput, MoveVideoClipsByAnchorInput, MoveVideoClipsInput, MovedClipAnchoredPolicy, ReplaceVideoClipContentInput, ReplaceVideoClipSequenceInput, ResizeCaptionInput, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput, SpeechAsset, SpeechAssets, addSpeechesInputSchema, addVideoClipsInputSchema, adjustBgmVolumeInputSchema, adjustSpeechVolumeInputSchema, adjustVideoClipDurationInputSchema, adjustVideoClipVolumeInputSchema, anchoredDeletePolicySchema, anchoredReplacePolicySchema, changeSpeechScriptInputSchema, changeSpeechVoiceInputSchema, clipIdSchema, clipIdsSchema, deleteBgmInputSchema, deleteSpeechesInputSchema, deleteVideoClipsInputSchema, mediaIdSchema, moveAnchorSchema, moveSpeechesInputSchema, moveVideoClipsByAnchorInputSchema, moveVideoClipsInputSchema, movedClipAnchoredPolicySchema, positiveMsSchema, replaceVideoClipContentInputSchema, replaceVideoClipSequenceInputSchema, resizeCaptionInputSchema, setBgmInputSchema, setCaptionStyleInputSchema, setCaptionVisibilityInputSchema, setVideoClipSpeedShiftInputSchema, speechAssetsSchema, speechIdSchema, speechIdsSchema, speedShiftSchema, timelineMsSchema, voiceSchema, volumeSchema };
 }
 //#endregion
 //#region src/editor/schema-validator.d.ts
@@ -1590,6 +1600,7 @@ declare class SchemaValidator {
   validateSetBgm(input: SetBgmInput, _doc: SnapshotReadable): void;
   validateDeleteBgm(input: DeleteBgmInput, _doc: SnapshotReadable): void;
   validateSetCaptionVisibility(input: SetCaptionVisibilityInput, _doc: SnapshotReadable): void;
+  validateResizeCaption(input: ResizeCaptionInput, doc: SnapshotReadable): void;
   validateSetCaptionStyle(input: SetCaptionStyleInput, _doc: SnapshotReadable): void;
   private parse;
   private mainTrackIds;
@@ -1638,7 +1649,7 @@ declare class SchemaValidator {
  * side-effect payload contract in
  * `docs/projects/medeo-integration/results/phase-4-side-effect-payload-contract.md`.
  */
-type ImplementedSemanticOpKind = 'MoveVideoClips' | 'MoveVideoClipsByAnchor' | 'DeleteVideoClips' | 'AddVideoClips' | 'AdjustVideoClipVolume' | 'SetVideoClipSpeedShift' | 'ReplaceVideoClipContent' | 'ReplaceVideoClipSequence' | 'AdjustVideoClipDuration' | 'AddSpeeches' | 'DeleteSpeeches' | 'MoveSpeeches' | 'ChangeSpeechScript' | 'ChangeSpeechVoice' | 'AdjustSpeechVolume' | 'SetCaptionVisibility' | 'SetCaptionStyle' | 'SetBgm' | 'DeleteBgm' | 'AdjustBgmVolume';
+type ImplementedSemanticOpKind = 'MoveVideoClips' | 'MoveVideoClipsByAnchor' | 'DeleteVideoClips' | 'AddVideoClips' | 'AdjustVideoClipVolume' | 'SetVideoClipSpeedShift' | 'ReplaceVideoClipContent' | 'ReplaceVideoClipSequence' | 'AdjustVideoClipDuration' | 'AddSpeeches' | 'DeleteSpeeches' | 'MoveSpeeches' | 'ChangeSpeechScript' | 'ChangeSpeechVoice' | 'AdjustSpeechVolume' | 'ResizeCaption' | 'SetCaptionVisibility' | 'SetCaptionStyle' | 'SetBgm' | 'DeleteBgm' | 'AdjustBgmVolume';
 /**
  * Operations on the roadmap but NOT yet implemented by `SemanticEditor`. Empty:
  * Phase 4 covers every op with a real entry point. Kept as a named type so the
@@ -1700,7 +1711,7 @@ interface CommitOptions {
   /** Author of this op; omitted for writes with no acting user (bootstrap, repair). */
   actor?: OpActor;
 }
-type SemanticOpInput = MoveVideoClipsInput | MoveVideoClipsByAnchorInput | DeleteVideoClipsInput | AddVideoClipsInput | AdjustVideoClipVolumeInput | AdjustSpeechVolumeInput | AdjustBgmVolumeInput | SetVideoClipSpeedShiftInput | ReplaceVideoClipContentInput | ReplaceVideoClipSequenceInput | AdjustVideoClipDurationInput | AddSpeechesInput | DeleteSpeechesInput | MoveSpeechesInput | SetCaptionVisibilityInput | SetCaptionStyleInput | SetBgmInput | DeleteBgmInput;
+type SemanticOpInput = MoveVideoClipsInput | MoveVideoClipsByAnchorInput | DeleteVideoClipsInput | AddVideoClipsInput | AdjustVideoClipVolumeInput | AdjustSpeechVolumeInput | AdjustBgmVolumeInput | SetVideoClipSpeedShiftInput | ReplaceVideoClipContentInput | ReplaceVideoClipSequenceInput | AdjustVideoClipDurationInput | AddSpeechesInput | DeleteSpeechesInput | MoveSpeechesInput | ResizeCaptionInput | SetCaptionVisibilityInput | SetCaptionStyleInput | SetBgmInput | DeleteBgmInput;
 type SemanticOpName = ImplementedSemanticOpKind;
 /** Audit metadata committed alongside an op's writes. */
 interface TransactAudit {
@@ -1846,6 +1857,8 @@ declare class SemanticEditor {
   deleteBgm(input: DeleteBgmInput, options?: CommitOptions): Promise<void>;
   /** Toggle caption visibility (caption track `is_hidden`). */
   setCaptionVisibility(input: SetCaptionVisibilityInput, options?: CommitOptions): Promise<void>;
+  /** Resize the caption placement window; cue/source duration stays immutable. */
+  resizeCaption(input: ResizeCaptionInput, options?: CommitOptions): Promise<void>;
   /**
    * Set the document-wide caption style. GLOBAL (no `caption_id`): the patch is
    * merged onto EVERY caption part's `style`, mirroring the FE, which applies a
@@ -2030,6 +2043,7 @@ declare const videoDocumentSchema: z.ZodObject<{
         offsetMs: z.ZodNumber;
       }, z.core.$loose>], "mode">;
       fallback_abs_ms: z.ZodOptional<z.ZodNumber>;
+      duration_override_ms: z.ZodOptional<z.ZodNumber>;
     }, z.core.$loose>>>;
   }, z.core.$loose>>>;
   part_library: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as VideoDocumentSchemaVersion, A as assertValidVideoDocument, B as BgmPart, C as index_d_exports, D as VideoDocumentMirrorSchema, E as VideoDocumentDraft, F as SpeechHostMap, G as SpeechPart, H as DEFAULT_UNIT_TIME_MS, I as buildSpeechHostMap, J as TrackItem, K as Timeline, L as derivePositionFromAbs, M as InitialDocumentFacts, N as buildInitialVideoDocument, O as videoDocumentMirrorSchema, P as DerivedItemPosition, Q as VideoDocument, R as fromVideoDocument, S as ValidationError, T as TrackItemDraft, U as PartKind, V as CaptionPart, W as PartUnion, X as VIDEO_DOCUMENT_SCHEMA_VERSION, Y as TrackItemTimePosition, Z as VideoClipPart, _ as PlannedSemanticOpKind, a as MirrorVideoDocumentOptions, at as CaptionPart$1, b as SchemaValidator, c as CommitOptions, ct as SpeedShift, d as SemanticEditor, dt as TrackItem$1, et as VideoDocumentValidationIssue, f as SemanticOpInput, g as ImplementedSemanticOpKind, h as IMPLEMENTED_SEMANTIC_OP_KINDS, i as MirrorVideoDocumentAdapter, it as Attachment, j as validateVideoDocument, k as VideoDocumentValidationError, l as OpActor, lt as Timeline$1, m as TransactAudit, n as videoDocumentSchema, nt as VideoDraft, o as createMirrorVideoDocument, ot as CaptionStyle, p as SemanticOpName, q as Track, r as readVideoDocumentFromDraft, rt as VideoDraftPartUnion, s as createMirrorVideoDocumentAdapter, st as PartAggregation, t as partUnionSchema, tt as VideoDocumentValidationIssueCode, u as SemanticDocumentAdapter, ut as Track$1, v as SemanticOpKind, w as TrackDraft, x as SnapshotReadable, y as isImplementedSemanticOpKind, z as toVideoDocument } from "./index-DWVYLTjv.js";
+import { $ as VideoDocumentSchemaVersion, A as assertValidVideoDocument, B as BgmPart, C as index_d_exports, D as VideoDocumentMirrorSchema, E as VideoDocumentDraft, F as SpeechHostMap, G as SpeechPart, H as DEFAULT_UNIT_TIME_MS, I as buildSpeechHostMap, J as TrackItem, K as Timeline, L as derivePositionFromAbs, M as InitialDocumentFacts, N as buildInitialVideoDocument, O as videoDocumentMirrorSchema, P as DerivedItemPosition, Q as VideoDocument, R as fromVideoDocument, S as ValidationError, T as TrackItemDraft, U as PartKind, V as CaptionPart, W as PartUnion, X as VIDEO_DOCUMENT_SCHEMA_VERSION, Y as TrackItemTimePosition, Z as VideoClipPart, _ as PlannedSemanticOpKind, a as MirrorVideoDocumentOptions, at as CaptionPart$1, b as SchemaValidator, c as CommitOptions, ct as SpeedShift, d as SemanticEditor, dt as TrackItem$1, et as VideoDocumentValidationIssue, f as SemanticOpInput, g as ImplementedSemanticOpKind, h as IMPLEMENTED_SEMANTIC_OP_KINDS, i as MirrorVideoDocumentAdapter, it as Attachment, j as validateVideoDocument, k as VideoDocumentValidationError, l as OpActor, lt as Timeline$1, m as TransactAudit, n as videoDocumentSchema, nt as VideoDraft, o as createMirrorVideoDocument, ot as CaptionStyle, p as SemanticOpName, q as Track, r as readVideoDocumentFromDraft, rt as VideoDraftPartUnion, s as createMirrorVideoDocumentAdapter, st as PartAggregation, t as partUnionSchema, tt as VideoDocumentValidationIssueCode, u as SemanticDocumentAdapter, ut as Track$1, v as SemanticOpKind, w as TrackDraft, x as SnapshotReadable, y as isImplementedSemanticOpKind, z as toVideoDocument } from "./index-CZlTzzrm.js";
 import { PeerID } from "loro-crdt";
 import { DocState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";

package/dist/index.js

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-D7D4PA-g.js";
-import { A as partDurationMs, C as reassignSpeechesToVideoClipsByTime, D as syncAggregatedClipsTimePosition, E as resolveSpeechOverlapByShiftingVideos, F as partUnionToDraft, I as recordEntries, L as videoDocumentMirrorSchema, M as DEFAULT_UNIT_TIME_MS, N as VIDEO_DOCUMENT_SCHEMA_VERSION, O as TIMELINE_SKELETON_DURATION_MS, P as effectiveVideoClipDurationMs, R as base64ToBytes, S as fillMainTrackTimeGaps, T as resolveAllSpeechOverlaps, _ as findLaneTrack, a as buildInitialVideoDocument, b as cascadeAfterVideoClipChanges, c as fromVideoDocument, d as assertValidVideoDocument, f as validateVideoDocument, g as ensureLaneTrack, h as LANE_KINDS_IN_STACK_ORDER, i as readVideoDocumentFromDraft, j as safeDurationMs, k as isEmptyVideoClip, l as toVideoDocument, m as videoDocumentSchema, n as createMirrorVideoDocument, o as buildSpeechHostMap, p as partUnionSchema, r as createMirrorVideoDocumentAdapter, s as derivePositionFromAbs, t as MirrorVideoDocumentAdapter, u as VideoDocumentValidationError, v as laneTrackId, w as recalculateTimelineDuration, x as arrangeMainTrackSeamlessly, y as solveVideoDocument, z as bytesToBase64 } from "./document-C0o_cjAH.js";
+import { A as partDurationMs, C as reassignSpeechesToVideoClipsByTime, D as syncAggregatedClipsTimePosition, E as resolveSpeechOverlapByShiftingVideos, F as partUnionToDraft, I as recordEntries, L as videoDocumentMirrorSchema, M as DEFAULT_UNIT_TIME_MS, N as VIDEO_DOCUMENT_SCHEMA_VERSION, O as TIMELINE_SKELETON_DURATION_MS, P as effectiveVideoClipDurationMs, R as base64ToBytes, S as fillMainTrackTimeGaps, T as resolveAllSpeechOverlaps, _ as findLaneTrack, a as buildInitialVideoDocument, b as cascadeAfterVideoClipChanges, c as fromVideoDocument, d as assertValidVideoDocument, f as validateVideoDocument, g as ensureLaneTrack, h as LANE_KINDS_IN_STACK_ORDER, i as readVideoDocumentFromDraft, j as safeDurationMs, k as isEmptyVideoClip, l as toVideoDocument, m as videoDocumentSchema, n as createMirrorVideoDocument, o as buildSpeechHostMap, p as partUnionSchema, r as createMirrorVideoDocumentAdapter, s as derivePositionFromAbs, t as MirrorVideoDocumentAdapter, u as VideoDocumentValidationError, v as laneTrackId, w as recalculateTimelineDuration, x as arrangeMainTrackSeamlessly, y as solveVideoDocument, z as bytesToBase64 } from "./document-Dcu87api.js";
 import { z } from "zod";
 import { LoroDoc, VersionVector } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
@@ -670,6 +670,13 @@ const replaceVideoClipSequenceInputSchema = z.object({
 	}
 });
 //#endregion
+//#region src/editor/schemas/resize-caption.ts
+/** Resize one caption placement without changing its cue/source duration. */
+const resizeCaptionInputSchema = z.object({
+	caption_id: z.string().min(1),
+	duration_ms: z.number().finite().positive()
+});
+//#endregion
 //#region src/editor/schemas/set-bgm.ts
 /**
 * Set the document BGM. The media's stable result (storage key) arrives
@@ -765,6 +772,7 @@ var schemas_exports = /* @__PURE__ */ __exportAll({
 	positiveMsSchema: () => positiveMsSchema,
 	replaceVideoClipContentInputSchema: () => replaceVideoClipContentInputSchema,
 	replaceVideoClipSequenceInputSchema: () => replaceVideoClipSequenceInputSchema,
+	resizeCaptionInputSchema: () => resizeCaptionInputSchema,
 	setBgmInputSchema: () => setBgmInputSchema,
 	setCaptionStyleInputSchema: () => setCaptionStyleInputSchema,
 	setCaptionVisibilityInputSchema: () => setCaptionVisibilityInputSchema,
@@ -1015,6 +1023,18 @@ var SchemaValidator = class {
 	validateSetCaptionVisibility(input, _doc) {
 		this.parse(setCaptionVisibilityInputSchema, input, "set_caption_visibility_invalid_input");
 	}
+	validateResizeCaption(input, doc) {
+		const parsed = this.parse(resizeCaptionInputSchema, input, "resize_caption_invalid_input");
+		const snapshot = doc.snapshot();
+		this.assertPartKind(snapshot, parsed.caption_id, "caption", "resize_caption");
+		if (snapshot.tracks?.find((track) => track.parts_kind === "caption")?.items?.find((row) => row.part_id === parsed.caption_id) == null) throw new ValidationError("resize_caption_placement_not_found", `caption_id "${parsed.caption_id}" is not placed on the caption track`, { caption_id: parsed.caption_id });
+		const cueDuration = snapshot.part_library?.[parsed.caption_id]?.caption?.initial_duration_ms ?? 0;
+		if (parsed.duration_ms < cueDuration) throw new ValidationError("resize_caption_below_cue", `duration_ms ${parsed.duration_ms} is shorter than cue duration ${cueDuration}`, {
+			caption_id: parsed.caption_id,
+			duration_ms: parsed.duration_ms,
+			cue_duration_ms: cueDuration
+		});
+	}
 	validateSetCaptionStyle(input, _doc) {
 		this.parse(setCaptionStyleInputSchema, input, "set_caption_style_invalid_input");
 	}
@@ -1220,7 +1240,8 @@ var SemanticEditor = class {
 				track.items.splice(at, 0, {
 					part_id: partId,
 					time_position: { mode: "sequential" },
-					fallback_abs_ms: void 0
+					fallback_abs_ms: void 0,
+					duration_override_ms: void 0
 				});
 				at += 1;
 			}
@@ -1267,7 +1288,8 @@ var SemanticEditor = class {
 				newItems.push({
 					part_id: partId,
 					time_position: { mode: "sequential" },
-					fallback_abs_ms: void 0
+					fallback_abs_ms: void 0,
+					duration_override_ms: void 0
 				});
 				newClipIds.push(partId);
 			}
@@ -1480,7 +1502,8 @@ var SemanticEditor = class {
 					mode: "absolute",
 					offsetMs: 0
 				},
-				fallback_abs_ms: void 0
+				fallback_abs_ms: void 0,
+				duration_override_ms: void 0
 			}];
 		}, audit("SetBgm", input, options));
 	}
@@ -1503,6 +1526,15 @@ var SemanticEditor = class {
 			track.is_hidden = input.is_hidden;
 		}, audit("SetCaptionVisibility", input, options));
 	}
+	/** Resize the caption placement window; cue/source duration stays immutable. */
+	async resizeCaption(input, options) {
+		this.validator.validateResizeCaption(input, this.doc);
+		this.doc.transact((draft) => {
+			const item = findLaneTrack(draft, "caption")?.items?.find((row) => row.part_id === input.caption_id);
+			if (item == null) return;
+			item.duration_override_ms = input.duration_ms;
+		}, audit("ResizeCaption", input, options));
+	}
 	/**
 	* Set the document-wide caption style. GLOBAL (no `caption_id`): the patch is
 	* merged onto EVERY caption part's `style`, mirroring the FE, which applies a
@@ -1749,7 +1781,8 @@ function placeRelative(items, partId, anchorPartId, offsetMs, fallbackAbsMs) {
 	items.push({
 		part_id: partId,
 		time_position: timePosition,
-		fallback_abs_ms: fallbackAbsMs
+		fallback_abs_ms: fallbackAbsMs,
+		duration_override_ms: void 0
 	});
 }
 /**
@@ -1893,6 +1926,7 @@ const IMPLEMENTED_SEMANTIC_OP_KINDS = [
 	"ChangeSpeechScript",
 	"ChangeSpeechVoice",
 	"AdjustSpeechVolume",
+	"ResizeCaption",
 	"SetCaptionVisibility",
 	"SetCaptionStyle",
 	"SetBgm",

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { i as MirrorVideoDocumentAdapter, nt as VideoDraft } from "./index-DWVYLTjv.js";
+import { i as MirrorVideoDocumentAdapter, nt as VideoDraft } from "./index-CZlTzzrm.js";
 
 //#region src/testing/in-memory-mengine-server.d.ts
 /**

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { N as VIDEO_DOCUMENT_SCHEMA_VERSION, R as base64ToBytes, r as createMirrorVideoDocumentAdapter, z as bytesToBase64 } from "./document-C0o_cjAH.js";
+import { N as VIDEO_DOCUMENT_SCHEMA_VERSION, R as base64ToBytes, r as createMirrorVideoDocumentAdapter, z as bytesToBase64 } from "./document-Dcu87api.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.2.0",
+  "version": "1.2.1-alpha.1",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -25,9 +25,9 @@
   "dependencies": {
     "loro-mirror": "^2.2.0",
     "zod": "^4.4.3",
-    "@mengine/sync": "1.2.0",
-    "@mengine/storage": "1.2.0",
-    "@mengine/utils": "1.2.0"
+    "@mengine/storage": "1.2.1-alpha.1",
+    "@mengine/sync": "1.2.1-alpha.1",
+    "@mengine/utils": "1.2.1-alpha.1"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",