@mengine/medeo-client 2.1.1-dsl.8 → 2.1.1-dsl.9

package/dist/{video-draft-types-Bq15tPBP.d.ts → video-draft-types-GqXnsOzA.d.ts}

@@ -53,8 +53,14 @@ type Media = MediaLocator & ({
   kind: 'image';
   storageKey?: string;
 });
+/** One segment of a script: its own text, and the id a Caption or PhoneticScript names it by. */
+interface AudioScriptSegment {
+  id: string;
+  text: string;
+}
+/** A script is segmented text: its segments in order (D181). */
 interface AudioScript {
-  body: string;
+  segments: AudioScriptSegment[];
   defaultLanguage?: string;
 }
 interface CaptionStyle$1 {
@@ -72,22 +78,27 @@ interface CaptionStyle$1 {
   positionX?: number;
   positionY?: number;
 }
-/** A run of a script's body a Caption reads its words from. One value: script and range move together. */
-interface CaptionContent {
+/**
+ * What a Caption shows or a PhoneticScript is written for: one segment of a script, or a run inside
+ * it (D181). The run's ends are Cursors on that segment's Text, so they follow its edits; without
+ * them the whole segment is meant, whatever it comes to say. One value: taken or replaced whole.
+ */
+interface SegmentSelection {
   audioScriptId: string;
-  start: Cursor;
-  end: Cursor;
+  segmentId: string;
+  start?: Cursor;
+  end?: Cursor;
 }
+type CaptionContent = SegmentSelection;
 /** Words come from a selected run of a script or from the Caption's own text, never both. */
 interface Caption {
   selection?: CaptionContent;
   text?: string;
   style?: CaptionStyle$1;
 }
-/** A phonetic script's base script and the pronunciation written for it, taken or replaced together. */
-interface Phoneme {
-  audioScriptId: string;
-  /** One whole script in the target TTS vocabulary, such as a `<speak>` document. */
+/** The segment a PhoneticScript is written for, selected as a Caption selects one, and its pronunciation. */
+interface Phoneme extends SegmentSelection {
+  /** What the voice synthesizes for that selection, written in what the voice accepts. */
   phonemeScript?: string;
 }
 /** A file Memota stored from raw content: how a Media File entity names it, and its digest. */
@@ -98,7 +109,7 @@ interface StoredFile {
   digest: string;
 }
 /**
- * A variant of an AudioScript: the script it reads, plus how to pronounce it. It has the Media File
+ * A variant of an AudioScript: the segment it is written for, plus what to synthesize. It has the Media File
  * trait (D178): its `phonemeScript` is raw content, stored in Memota as a text file whenever it is
  * written, and the file's facts are kept beside it. Without a `phonemeScript` it has no file.
  */
@@ -137,6 +148,12 @@ interface RelationValues {
     sourceDigest?: string;
   };
 }
+/** What a create states: a PhoneticScript's phoneme may follow by set-phoneme in the same write. */
+type EntityInput = Omit<EntityValues, 'phonetic-script-entities'> & {
+  'phonetic-script-entities': Omit<PhoneticScript, 'phoneme'> & {
+    phoneme?: Phoneme;
+  };
+};
 type EntityTable = keyof EntityValues;
 type RelationTable = keyof RelationValues;
 type EntityTables = { [K in EntityTable]: Record<string, EntityValues[K]> };
@@ -146,7 +163,7 @@ type EntityMutation = { [K in EntityTable]: {
   type: 'create-entity';
   table: K;
   id: string;
-  value: EntityValues[K];
+  value: EntityInput[K];
 } | {
   type: 'patch-entity';
   table: K;
@@ -180,12 +197,37 @@ type ContainMutation = {
   type: 'delete-node';
   entityId: string;
 };
-interface CaptionSelection {
-  captionId: string;
+/** A segment, or a run of it in UTF-16 offsets of its current text, as a write states it. */
+interface SegmentRange {
   audioScriptId: string;
-  start: number;
-  end: number;
+  segmentId: string;
+  start?: number;
+  end?: number;
+}
+interface CaptionSelection extends SegmentRange {
+  captionId: string;
 }
+interface PhonemeSelection extends SegmentRange {
+  phoneticScriptId: string;
+  phonemeScript?: string;
+}
+/** A script's segments are added, moved and removed by id; their text is edited in place. */
+type SegmentMutation = {
+  type: 'insert-segment';
+  audioScriptId: string;
+  segmentId: string;
+  index?: number;
+  text: string;
+} | {
+  type: 'move-segment';
+  audioScriptId: string;
+  segmentId: string;
+  index: number;
+} | {
+  type: 'delete-segment';
+  audioScriptId: string;
+  segmentId: string;
+};
 type TextMutation = {
   type: 'edit-caption-text';
   captionId: string;
@@ -194,12 +236,15 @@ type TextMutation = {
 } | {
   type: 'edit-text';
   audioScriptId: string;
+  segmentId: string;
   expectedBodyId?: string;
   edits: readonly TextEdit[];
 } | ({
   type: 'set-caption-content';
-} & CaptionSelection);
-type DslMutation = EntityMutation | RelationMutation | ContainMutation | TextMutation;
+} & CaptionSelection) | ({
+  type: 'set-phoneme';
+} & PhonemeSelection);
+type DslMutation = EntityMutation | RelationMutation | ContainMutation | SegmentMutation | TextMutation;
 interface ContainNode {
   treeId: TreeID;
   entityId: string;
@@ -219,6 +264,7 @@ interface RichTextSnapshot {
   plainText: string;
   delta: TextRun[];
 }
+/** Selected text, with its UTF-16 range in the Text it lies in: the segment's, or a Caption's own. */
 interface CaptionText {
   text: string;
   start: number;
@@ -227,9 +273,10 @@ interface CaptionText {
 }
 type DeepReadonly<T> = T extends Cursor ? T : T extends object ? { readonly [K in keyof T]: DeepReadonly<T[K]> } : T;
 type MedeoDslSnapshot = DeepReadonly<EntityTables & RelationTables & {
-  'contain-relations': ContainNode[];
+  'contain-relations': ContainNode[]; /** A Caption's own text by the Caption's id, and each script segment's text by the segment's id. */
   richText: Record<string, RichTextSnapshot>;
-  captionText: Record<string, CaptionText>;
+  captionText: Record<string, CaptionText>; /** What each PhoneticScript's selection holds now, resolved as a Caption's is. */
+  phoneticText: Record<string, CaptionText>;
   diagnostics: DslDiagnostic[];
 }>;
 type TextMark = 'language';
@@ -270,7 +317,8 @@ type TextDelta = {
 declare function tupleHash(tuple: readonly string[]): string;
 declare function resourceId(kind: 'media' | 'voice', system: string, key: string): string;
 declare function relationId<K extends RelationTable>(table: K, value: RelationValues[K]): string;
-type EntityIdKind = 'timeline' | 'track' | 'clip' | 'audio-script' | 'phonetic-script' | 'caption';
+/** Kinds of id a document mints: its entities', and a script segment's. */
+type EntityIdKind = 'timeline' | 'track' | 'clip' | 'audio-script' | 'segment' | 'phonetic-script' | 'caption';
 type DslIdFactory = (kind: EntityIdKind) => string;
 declare const defaultIdFactory: DslIdFactory;
 //#endregion
@@ -818,4 +866,4 @@ type VideoDraftContent = Pick<VideoDraft, 'timeline' | 'main_track' | 'above_mai
 type VideoDraftInput = Pick<VideoDraft, keyof VideoDraftContent>;
 declare const DEFAULT_UNIT_TIME_MS = 33.333;
 //#endregion
-export { Track$1 as $, DeepReadonly as A, RelationMutation as B, CaptionContent as C, Clip as D, CaptionText as E, EntityTables as F, RichTextSnapshot as G, RelationTables as H, EntityValues as I, TextEdit as J, StoredFile as K, FieldPatch as L, DslMutation as M, EntityMutation as N, ContainMutation as O, EntityTable as P, TimeAnchor as Q, MedeoDslSnapshot as R, Caption as S, CaptionStyle$1 as T, RelationValues as U, RelationTable as V, ResourceSystem as W, TextMutation as X, TextMark as Y, TextRun as Z, defaultIdFactory as _, VideoDraftCaptionStyle as a, tupleHash as b, VideoDraftInput as c, VideoDraftTrack as d, TrackRole as et, VideoDraftTrackItem as f, EntityIdKind as g, DslIdFactory as h, VideoDraft as i, DslDiagnostic as j, ContainNode as k, VideoDraftPartUnion as l, OpActor as m, DEFAULT_UNIT_TIME_MS as n, VideoDraftContent as o, CommitOptions as p, TextDelta as q, VideoCreationSettings as r, VideoDraftContentPartUnion as s, CaptionDisplayCue as t, Voice as tt, VideoDraftTimeline as u, relationId as v, CaptionSelection as w, AudioScript as x, resourceId as y, Media as z };
+export { TextMutation as $, DeepReadonly as A, PhonemeSelection as B, CaptionContent as C, Clip as D, CaptionText as E, EntityTables as F, ResourceSystem as G, RelationTable as H, EntityValues as I, SegmentSelection as J, RichTextSnapshot as K, FieldPatch as L, DslMutation as M, EntityMutation as N, ContainMutation as O, EntityTable as P, TextMark as Q, MedeoDslSnapshot as R, Caption as S, CaptionStyle$1 as T, RelationTables as U, RelationMutation as V, RelationValues as W, TextDelta as X, StoredFile as Y, TextEdit as Z, defaultIdFactory as _, VideoDraftCaptionStyle as a, tupleHash as b, VideoDraftInput as c, VideoDraftTrack as d, TextRun as et, VideoDraftTrackItem as f, EntityIdKind as g, DslIdFactory as h, VideoDraft as i, Voice as it, DslDiagnostic as j, ContainNode as k, VideoDraftPartUnion as l, OpActor as m, DEFAULT_UNIT_TIME_MS as n, Track$1 as nt, VideoDraftContent as o, CommitOptions as p, SegmentRange as q, VideoCreationSettings as r, TrackRole as rt, VideoDraftContentPartUnion as s, CaptionDisplayCue as t, TimeAnchor as tt, VideoDraftTimeline as u, relationId as v, CaptionSelection as w, AudioScript as x, resourceId as y, Media as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mengine/medeo-client",
-  "version": "2.1.1-dsl.8",
+  "version": "2.1.1-dsl.9",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -29,9 +29,9 @@
     "@noble/hashes": "^2.4.0",
     "immer": "^10.2.0",
     "zod": "^4.4.3",
-    "@mengine/sync": "2.1.1-dsl.8",
-    "@mengine/utils": "2.1.1-dsl.8",
-    "@mengine/storage": "2.1.1-dsl.8"
+    "@mengine/storage": "2.1.1-dsl.9",
+    "@mengine/sync": "2.1.1-dsl.9",
+    "@mengine/utils": "2.1.1-dsl.9"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",