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

package/dist/{document-DdwzfZ1g.js → document-C30rnewk.js}

@@ -1448,62 +1448,84 @@ function emptyLaneTracks() {
 //#endregion
 //#region ../medeo-dsl/src/entities.ts
 /**
-* The declared trait set of every known kind.
+* What every known entity kind declares.
 *
-* `caption` carries `sequence` on purpose: a Caption owns the display timing of
-* the one AudioScript segment it shows, which is what admits it into a Clip.
-* `voice` carries no media or sequence trait — it is a timbre identity, not
-* playable content; a rendered voiceover is an `audio` entity.
+* `kinds` is a multi-declaration: every entry holds at the same time, the first
+* naming the object and the rest the properties it shares with others. The
+* order carries no priority, endpoint role, or edit sequence — an operation
+* asks whether the entity declares the kind it needs, never what its "main
+* type" is.
+*
+* `Caption` declares `Sequence` on purpose: it owns the display timing of the
+* one AudioScript segment it shows, which is what admits it into a Clip.
+* `Voice` declares neither `MediaFile` nor `Sequence` — it is a timbre
+* identity, not playable content; a rendered voiceover is an `audio` entity.
 */
-const ENTITY_TRAIT_KINDS = Object.freeze({
+const ENTITY_KINDS = Object.freeze({
 	axvideo: Object.freeze([
-		"container",
-		"sequence",
-		"visual",
-		"audible"
+		"AXVideo",
+		"Container",
+		"Sequence",
+		"Visual",
+		"Audible"
+	]),
+	timeline: Object.freeze(["Timeline", "Container"]),
+	track: Object.freeze([
+		"Track",
+		"Container",
+		"Sequence"
 	]),
-	timeline: Object.freeze(["container"]),
-	track: Object.freeze(["container", "sequence"]),
-	clip: Object.freeze(["container"]),
-	asset: Object.freeze([]),
+	clip: Object.freeze(["Clip", "Container"]),
+	asset: Object.freeze(["Asset"]),
 	video: Object.freeze([
-		"media-file",
-		"sequence",
-		"visual",
-		"audible"
+		"Video",
+		"MediaFile",
+		"Sequence",
+		"Visual",
+		"Audible"
 	]),
 	audio: Object.freeze([
-		"media-file",
-		"sequence",
-		"audible"
+		"Audio",
+		"MediaFile",
+		"Sequence",
+		"Audible"
 	]),
 	image: Object.freeze([
-		"media-file",
-		"sequence",
-		"visual"
+		"Image",
+		"MediaFile",
+		"Sequence",
+		"Visual"
 	]),
-	voice: Object.freeze(["container", "ip-bound"]),
-	"sequence-marker": Object.freeze([]),
-	viewport: Object.freeze([]),
-	"audio-script": Object.freeze(["segment-text"]),
-	"phonetic-script": Object.freeze(["segment-text"]),
-	caption: Object.freeze(["segment-text", "sequence"])
+	voice: Object.freeze([
+		"Voice",
+		"Container",
+		"IPBound"
+	]),
+	"sequence-marker": Object.freeze(["SequenceMarker"]),
+	viewport: Object.freeze(["Viewport"]),
+	"audio-script": Object.freeze(["AudioScript", "SegmentText"]),
+	"phonetic-script": Object.freeze(["PhoneticScript", "SegmentText"]),
+	caption: Object.freeze([
+		"Caption",
+		"SegmentText",
+		"Sequence"
+	])
 });
-/** Declared traits of a known kind; extension kinds declare none through this table. */
-function traitKindsOf(entityKind) {
-	return isKnownEntityKind(entityKind) ? ENTITY_TRAIT_KINDS[entityKind] : [];
+/** What a known kind declares; extension kinds declare nothing through this table. */
+function kindsOf(entityKind) {
+	return isKnownEntityKind(entityKind) ? ENTITY_KINDS[entityKind] : [];
 }
-function hasTraitKind(entityKind, trait) {
-	return traitKindsOf(entityKind).includes(trait);
+function declaresKind(entityKind, kind) {
+	return kindsOf(entityKind).includes(kind);
 }
 /**
-* Sequence admission asks the declared traits first, so a kind that does not
-* declare `sequence` can never buy its way in by carrying the fields. Extension
-* kinds declare no traits and stay structurally detected.
+* Sequence admission asks `kinds` first, so an entity that does not declare
+* `Sequence` can never buy its way in by carrying the fields. Extension kinds
+* declare nothing and stay structurally detected.
 */
 function hasSequence(entity) {
 	if (isReservedEntityKind(entity.entityKind)) return false;
-	if (isKnownEntityKind(entity.entityKind) && !hasTraitKind(entity.entityKind, "sequence")) return false;
+	if (isKnownEntityKind(entity.entityKind) && !declaresKind(entity.entityKind, "Sequence")) return false;
 	return isSequenceFields(entity);
 }
 function isSequenceFields(value) {
@@ -1520,7 +1542,7 @@ function isMediaAssetVariantKind(kind) {
 	return kind === "video" || kind === "image" || kind === "audio";
 }
 function isKnownEntityKind(kind) {
-	return Object.hasOwn(ENTITY_TRAIT_KINDS, kind);
+	return Object.hasOwn(ENTITY_KINDS, kind);
 }
 function isReservedEntityKind(kind) {
 	const normalized = kind.toLowerCase().replaceAll("-", "").replaceAll("_", "");
@@ -1709,14 +1731,17 @@ function assembleCaptionContent(rows, captionEntityId) {
 	requireEntityKind(rows, captionEntityId, "caption");
 	const caption = assembleEntityContent(rows, captionEntityId);
 	const script = findComposedAudioScript(rows, captionEntityId, "caption");
-	const segment = selectAudioScriptSegment({
+	const selection = captionSelection(caption);
+	const composed = {
 		...script,
 		payload: caption.payload
-	}, captionSelection(caption));
+	};
+	const segment = selectAudioScriptSegment(composed, selection);
 	return {
 		caption,
 		audioScript: script,
 		segments: [segment],
+		segmentIndex: scriptSegments(composed).findIndex((entry) => entry.segmentId === selection.segmentId),
 		text: segment.text
 	};
 }

package/dist/index.d.ts

@@ -192,6 +192,16 @@ interface AssembledCaptionContent {
   readonly audioScript: EntityRow<'audio-script'>;
   /** Selected AudioScript segments in Caption selection order. */
   readonly segments: readonly ScriptTextSegment[];
+  /**
+   * Where the selected segment sits in the AudioScript's ordered segments.
+   *
+   * A Caption locates its text as AudioScript plus index. The selection is
+   * stored as the segment's own stable id rather than this ordinal, so a
+   * concurrent insert or re-segmentation cannot silently slide a Caption onto
+   * different text; the ordinal is derived here for readers that want the
+   * position.
+   */
+  readonly segmentIndex: number;
   /** Complete display text: the selected segments' text joined in order. */
   readonly text: string;
 }

package/dist/index.js

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

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { St as bytesToBase64, o as createMirrorVideoDocumentAdapter, xt as base64ToBytes } from "./document-DdwzfZ1g.js";
+import { St as bytesToBase64, o as createMirrorVideoDocumentAdapter, xt as base64ToBytes } from "./document-C30rnewk.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.8",
+  "version": "2.0.1-alpha.9",
   "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.8",
-    "@mengine/utils": "2.0.1-alpha.8",
-    "@mengine/storage": "2.0.1-alpha.8"
+    "@mengine/storage": "2.0.1-alpha.9",
+    "@mengine/sync": "2.0.1-alpha.9",
+    "@mengine/utils": "2.0.1-alpha.9"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -40,8 +40,8 @@
     "typescript": "^6.0.3",
     "vite-plugin-wasm": "^3.6.0",
     "vite-plus": "^0.1.23",
-    "@mengine/idl-codegen": "0.0.0",
-    "@mengine/medeo-dsl": "0.0.0"
+    "@mengine/medeo-dsl": "0.0.0",
+    "@mengine/idl-codegen": "0.0.0"
   },
   "peerDependencies": {
     "loro-crdt": "^1.16.1"