@mengine/medeo-tool 1.4.1-alpha.1 → 1.4.1-alpha.3

package/dist/sandbox-api.d.mts

@@ -19,70 +19,25 @@ interface BoundedNativeSequencePayload extends JsonObject {
   sampling: 'native';
   coordinateSpace: JsonValue;
 }
-/** Business editing surface. Infrastructure Assets are assembled by the host. */
+/** Business editing surface. Reads are assembled snapshots; writes preserve native operation intent. */
 interface BusinessEntityFacade {
   list(): SandboxEntity[];
   get(entityId: string): SandboxEntity | null;
-  readCaptionContent(entityId: string): ComposedScriptContent;
-  readPhoneticScriptContent(entityId: string): ComposedPhoneticContent;
   create(input: Exclude<CreateEntityInput, {
     entity_kind: 'asset';
   }>): string;
-  update(input: UpdateEntityInput): void;
+  update(input: EntityUpdateInput): void;
   declareFields(input: UpdateEntityInput): void;
   delete(input: DeleteEntityInput): void;
 }
-/** Physical Asset bindings are maintained outside the sandbox. */
+/** Endpoint order is retained; each relation kind defines its endpoint semantics. */
 interface BusinessRelationFacade {
   list(): SandboxRelation[];
   of(entityId: string, relationKind?: KnownRelationKind): SandboxRelation[];
-  link(input: Exclude<LinkRelationInput, {
-    relation_kind: 'physical-asset';
-  }>): string;
-  linkGenerated(input: LinkGeneratedRelationInput): string;
-  linkClipAnchor(input: LinkClipAnchorRelationInput): string;
-  linkPhoneticScriptRender(input: LinkPhoneticScriptRenderRelationInput): string;
-  linkAudioScriptSource(input: LinkAudioScriptSourceRelationInput): string;
+  link(input: LinkRelationInput): string;
+  update(input: RelationUpdateInput): void;
   unlink(input: UnlinkRelationInput): void;
 }
-interface CaptionFontDescriptor {
-  readonly system: 'font-library';
-  readonly key: string;
-}
-/**
- * One ordered entry of the Caption's segment selection. `segmentId` quotes the
- * composed AudioScript's own stable segment identity — a local id quoted by the
- * variant, never a peer Entity reference. Text itself is never copied here;
- * complete Caption content is assembled through its direct baseEntityIds.
- * The optional `textRange` narrows one Segment to an intra-Segment sub-span
- * (intra-segment re-segmentation); without it the whole Segment text is selected.
- */
-type CaptionSegmentSelection = JsonObject & {
-  readonly segmentId: string;
-  readonly textRange?: CaptionTextRange;
-};
-interface CaptionStyleFields {
-  readonly font?: CaptionFontDescriptor;
-  readonly fontSize?: number;
-  readonly fontColor?: string;
-  readonly fontWeight?: number;
-  readonly entranceAnimation?: string;
-  readonly entranceAnimationDurationMs?: number;
-  readonly strokeColor?: string;
-  readonly strokeWidth?: number;
-  readonly positionX?: number;
-  readonly positionY?: number;
-}
-/**
- * Half-open `[start, end)` position window inside one Segment's text, counted
- * in Unicode code points (not UTF-16 code units), so a boundary never splits a
- * surrogate pair. Positions are non-negative safe integers with `start < end`;
- * `end` must not exceed the Segment's code-point length.
- */
-interface CaptionTextRange extends JsonObject {
-  readonly start: number;
-  readonly end: number;
-}
 type CaptionTextSelection = JsonObject & {
   segmentId: string; /** Half-open Unicode code-point range within the selected source segment. */
   textRange?: {
@@ -90,51 +45,19 @@ type CaptionTextSelection = JsonObject & {
     end: number;
   };
 };
-type ClipEntityId = EntityId;
-type ClipPlacement = {
-  readonly kind: 'sequential';
-  readonly order: number;
-} | {
-  readonly kind: 'absolute';
-  readonly targetRange: SequenceRange<number>;
-} | {
-  readonly kind: 'anchored';
-  readonly hostClipEntityId: string;
-  readonly anchorOffset: number;
-};
-interface ComposedPhoneticContent extends ComposedScriptContent {
-  phonemeScript?: string;
-  prosody?: JsonObject;
-}
-/** Read result only: base text is assembled from the real AudioScript row. */
-interface ComposedScriptContent {
-  audio_script_entity_id: string;
-  text: string;
-  segments: ScriptTextSegment[];
-}
 type CreateEntityInput = { [K in KnownEntityKind]: {
   entity_id?: string;
   entity_kind: K;
   payload: StoredEntityPayload<K>;
 } }[KnownEntityKind];
-interface DeleteBgmInput {
-  readonly timelineEntityId: string;
-}
-interface DeleteClipInput {
-  readonly clipEntityId: string;
-}
-interface DeleteClipTreeInput {
-  readonly clipEntityIds: readonly string[];
-  readonly onAnchored: 'cascade' | 'detach';
-}
 interface DeleteEntityInput {
   entity_id: string;
 }
-interface DeleteVoiceoverInput {
-  readonly voiceoverClipEntityIds: readonly string[];
+/** Immutable resource content resolved by the host for a document Entity. */
+interface EntityAssetContent {
+  assetId: string;
+  content: JsonValue;
 }
-type EmptyRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'audio-script-marker';
-type EntityId = string;
 interface EntityPayloadByKind {
   axvideo: BoundedDerivedSequencePayload;
   timeline: JsonObject;
@@ -143,10 +66,10 @@ interface EntityPayloadByKind {
     role?: string;
   };
   clip: JsonObject;
-  video: BoundedNativeSequencePayload;
-  audio: BoundedNativeSequencePayload;
-  voice: BoundedNativeSequencePayload;
-  image: UnboundedConstantSequencePayload;
+  video: BoundedNativeSequencePayload & MediaAssetPayload;
+  audio: BoundedNativeSequencePayload & MediaAssetPayload;
+  voice: BoundedNativeSequencePayload & MediaAssetPayload;
+  image: UnboundedConstantSequencePayload & MediaAssetPayload;
   'sequence-marker': JsonObject & {
     sourceRange: {
       start: number;
@@ -184,51 +107,53 @@ interface EntityPayloadByKind {
     baseEntityIds: string[];
     selections: CaptionTextSelection[];
     style?: JsonObject;
+    segmentRanges?: {
+      segmentId: string;
+      startMs: number;
+      endMs: number;
+    }[];
   };
 }
-interface EntityStoreSnapshot {
-  /** Causal compiler baseline; required for publishing edits. */
-  loroSnapshot?: string;
-  revision: number;
-  /** Current AudioScript version attached to the project; initialized projects always attach a script, possibly empty. */
-  audioScriptEntityId: string | null;
-  entities: SandboxEntity[];
-  relations: SandboxRelation[];
-}
-interface InsertCaptionClipInput {
-  readonly timelineEntityId: string;
-  /** Existing generation identity for newly materialized Caption content, distinct from its Clip. */
-  readonly captionEntityId?: string;
-  /** Stable placed caption identity, distinct from the Caption content identity. */
-  readonly captionClipEntityId?: string;
-  /** Existing bases composed by this variant; includes an AudioScript text owner. */
-  readonly baseEntityIds: readonly string[];
-  /** Ordered selection of the AudioScript segments this Caption displays. */
-  readonly selections: readonly CaptionSegmentSelection[];
-  /** Intrinsic cue length of the Caption entity itself; display comes from the placement. */
-  readonly durationMs: number;
-  readonly style?: CaptionStyleFields;
-  readonly placement: ClipPlacement;
-}
-interface InsertClipInput {
-  readonly trackEntityId: string;
-  /** Existing Sequence media Entity id. Asset ids and URLs are not content ids. */
-  readonly contentEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
-  readonly duration: SequenceDuration<number>;
-  readonly targetRange?: SequenceRange<number>;
-  readonly clipPayload?: JsonObject;
+/** Tokens have no script-authored data; only the creating session can validate them. */
+interface EntitySandboxCheckpoint {
+  readonly __checkpoint: unique symbol;
 }
-interface InsertPlacedClipInput {
-  readonly trackEntityId: string;
-  readonly contentEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
-  readonly duration: SequenceDuration<number>;
-  readonly placement: ClipPlacement;
-  readonly clipPayload?: JsonObject;
-  /** Stable caller-owned placement identity, when one already exists outside the graph. */
-  readonly clipEntityId?: string;
+interface EntityUpdateInput {
+  entity_id: string;
+  changes: FieldChange[];
 }
+type FieldChange = {
+  op: 'set';
+  path: FieldPath;
+  value: JsonValue;
+} | {
+  op: 'unset';
+  path: FieldPath;
+} | {
+  op: 'text.splice';
+  path: FieldPath;
+  index: number;
+  deleteCount: number;
+  text: string;
+} | {
+  op: 'list.insert';
+  path: FieldPath;
+  value: JsonValue;
+  beforeElementId: string | null;
+} | {
+  op: 'list.move';
+  path: FieldPath;
+  elementId: string;
+  beforeElementId: string | null;
+} | {
+  op: 'list.remove';
+  path: FieldPath;
+  elementId: string;
+};
+/** List members are addressed by identity, never a transient array offset. */
+type FieldPath = readonly (string | {
+  elementId: string;
+})[];
 interface JsonObject {
   [key: string]: JsonValue;
 }
@@ -236,90 +161,25 @@ type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
 type KnownEntityKind = 'axvideo' | 'timeline' | 'track' | 'clip' | 'video' | 'audio' | 'voice' | 'image' | 'sequence-marker' | 'viewport' | 'audio-script' | 'phonetic-script' | 'caption';
 type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'generated' | 'caption-alignment' | 'clip-anchor' | 'phonetic-script-render' | 'audio-script-source' | 'audio-script-marker';
-interface LinearClipSpeed {
-  readonly kind: 'linear';
-  readonly rate: number;
-  readonly mode?: string;
-}
-/** `audio-script-source(script, source)`; the script was transcribed from the source media. */
-interface LinkAudioScriptSourceRelationInput {
-  relation_id?: string;
-  script_entity_id: string;
-  source_entity_id: string;
-  trace?: JsonObject;
-}
-interface LinkClipAnchorRelationInput {
-  relation_id?: string;
-  child_clip_entity_id: string;
-  host_clip_entity_id: string;
-  trace?: JsonObject;
-}
-interface LinkGeneratedRelationInput {
-  relation_id?: string;
-  output_entity_id: string;
-  input_entity_id: string;
-  trace?: JsonObject;
-}
-interface LinkPhoneticScriptRenderRelationInput {
-  relation_id?: string;
-  output_entity_id: string;
-  phonetic_script_entity_id: string;
-  trace?: JsonObject;
-}
 interface LinkRelationBase {
   relation_id?: string;
   endpoint_0_entity_id: string;
   endpoint_1_entity_id: string;
   trace?: JsonObject;
 }
-type LinkRelationInput = (LinkRelationBase & {
-  relation_kind: EmptyRelationKind;
-  metadata?: {
-    [key: string]: never;
-  };
-}) | (LinkRelationBase & {
-  relation_kind: 'physical-asset';
+interface LinkRelationInput extends LinkRelationBase {
+  relation_kind: KnownRelationKind;
   metadata?: JsonObject;
-}) | (LinkRelationBase & {
-  relation_kind: 'caption-alignment';
-  metadata: JsonObject & {
-    alignment: JsonValue;
-  };
-});
-interface MoveClipInput {
-  readonly clipEntityId: string;
-  readonly trackEntityId: string;
-}
-interface MoveClipsToStartsInput {
-  readonly moves: readonly {
-    readonly clipEntityId: string;
-    readonly newStartMs: number;
-  }[];
-  /** Absolute-time drags preserve every voiceover's current visible landing. */
-  readonly onAnchored: 'keepAbsolute';
-}
-interface MoveSequentialClipsInput {
-  readonly clipEntityIds: readonly string[];
-  readonly anchor: SequentialClipAnchor;
-  readonly onAnchored: 'follow' | 'keepAbsolute';
-}
-interface MoveVoiceoverInput {
-  readonly voiceoverClipEntityId: string;
-  /** Absolute requested timeline start; MEngine resolves and persists the host relation. */
-  readonly newStartMs: number;
 }
-interface PatchCaptionStyleInput {
-  readonly timelineEntityId: string;
-  readonly style: CaptionStyleFields;
-}
-interface ReplaceClipContentInput {
-  readonly clipEntityId: string;
-  /** Existing Sequence media Entity id. Asset ids and URLs are not content ids. */
-  readonly contentEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
-  readonly duration: SequenceDuration<number>;
-  readonly targetRange?: SequenceRange<number>;
-  readonly timeRemapping?: JsonValue;
+type MediaAssetPayload = JsonObject & {
+  external: {
+    system: 'memota' | 'memota-speech';
+    key: string;
+  };
+};
+interface RelationUpdateInput {
+  relation_id: string;
+  changes: FieldChange[];
 }
 interface SandboxEntity<K extends KnownEntityKind = KnownEntityKind> {
   entity_id: string;
@@ -339,47 +199,10 @@ type ScriptTextSegment = JsonObject & {
   text: string;
   language?: string;
 };
-type SequenceDuration<Span = unknown> = {
-  readonly mode: 'from-source';
-} | {
-  readonly mode: 'fixed';
-  readonly value: Span;
-};
-interface SequenceRange<Point = unknown> {
-  readonly start: Point;
-  readonly end: Point;
-}
-type SequentialClipAnchor = {
-  readonly position: 'before' | 'after';
-  readonly clipEntityId: string;
-} | {
-  readonly position: 'trackStart';
-};
-interface SetCaptionVisibilityInput {
-  readonly timelineEntityId: string;
-  readonly hidden: boolean;
-}
-interface SetClipPlacementInput {
-  readonly clipEntityId: string;
-  readonly placement: ClipPlacement;
-}
-interface SetClipSpeedInput {
-  readonly clipEntityId: string;
-  readonly timeRemapping: LinearClipSpeed | null;
-}
-interface SetClipVolumeInput {
-  readonly clipEntityId: string;
-  /** Playback gain in decibels. */
-  readonly volume: number;
-}
 /** Stored own fields; a variant may obtain required content fields from its declared bases. */
-type StoredEntityPayload<K extends KnownEntityKind> = EntityPayloadByKind[K] | (JsonObject & Partial<EntityPayloadByKind[K]> & {
+type StoredEntityPayload<K extends KnownEntityKind> = EntityPayloadByKind[K] | (K extends 'caption' ? JsonObject & Pick<MediaAssetPayload, 'external'> : never) | (JsonObject & Partial<EntityPayloadByKind[K]> & {
   baseEntityIds: string[];
 });
-interface TrimClipInput {
-  readonly clipEntityId: string;
-  readonly sourceRange: SequenceRange<number>;
-}
 interface UnboundedConstantSequencePayload extends JsonObject {
   extent: {
     kind: 'unbounded';
@@ -391,63 +214,24 @@ interface UnboundedConstantSequencePayload extends JsonObject {
 interface UnlinkRelationInput {
   relation_id: string;
 }
-interface UpdateClipInput {
-  readonly clipEntityId: string;
-  /** Complete replacement for the Clip-owned payload. */
-  readonly payload: JsonObject;
-}
-interface UpdateClipMarkerInput {
-  readonly clipEntityId: string;
-  readonly sourceRange?: SequenceRange<number>;
-  /** Passing `undefined` explicitly removes the optional target range. */
-  readonly targetRange?: SequenceRange<number> | undefined;
-  readonly duration?: SequenceDuration<number>;
-  /** Passing `undefined` explicitly removes the optional remapping value. */
-  readonly timeRemapping?: JsonValue | undefined;
-}
 /** Patch supplied fields on the assembled entity; omitted fields remain unchanged. */
 interface UpdateEntityInput {
   entity_id: string;
   payload: JsonObject;
 }
-/** Timeline writes accept existing media Entity ids, never Memota asset ids or URLs. */
-interface EditApi {
-  insertClip(input: InsertClipInput): ClipEntityId;
-  insertPlacedClip(input: InsertPlacedClipInput): ClipEntityId;
-  updateClipMarker(input: UpdateClipMarkerInput): void;
-  setClipPlacement(input: SetClipPlacementInput): void;
-  moveSequentialClips(input: MoveSequentialClipsInput): void;
-  moveClip(input: MoveClipInput): void;
-  replaceClipContent(input: ReplaceClipContentInput): void;
-  setClipVolume(input: SetClipVolumeInput): void;
-  setClipSpeed(input: SetClipSpeedInput): void;
-  trimClip(input: TrimClipInput): void;
-  deleteClip(input: DeleteClipInput): void;
-  deleteClipTree(input: DeleteClipTreeInput): void;
-  updateClip(input: UpdateClipInput): void;
-  moveVoiceover(input: MoveVoiceoverInput): void;
-  moveClipsToStarts(input: MoveClipsToStartsInput): void;
-  deleteVoiceover(input: DeleteVoiceoverInput): void;
-  deleteBgm(input: DeleteBgmInput): void;
-  setCaptionVisibility(input: SetCaptionVisibilityInput): void;
-  patchCaptionStyle(input: PatchCaptionStyleInput): void;
-  insertCaptionClip(input: InsertCaptionClipInput): ClipEntityId;
-}
-interface TimelineApi {
-  snapshot(): EntityStoreSnapshot & {
-    audioScriptEntityId: string;
-  };
-}
-interface SandboxCheckpoint {
-  readonly index: number;
-}
-declare const edit: EditApi;
-declare const timeline: TimelineApi;
 declare const entities: BusinessEntityFacade;
 declare const relations: BusinessRelationFacade;
-declare function checkpoint(): SandboxCheckpoint;
-declare function rollbackTo(cp: SandboxCheckpoint): void;
+/** Resolve this Entity's attached resource through the host; await before using an uninitialized Caption. */
+declare function rgetAssetFromEntity(entityId: string): Promise<EntityAssetContent>;
+declare function checkpoint(): EntitySandboxCheckpoint;
+declare function rollbackTo(cp: EntitySandboxCheckpoint): void;
 declare const inputs: Readonly<Record<string, unknown>>;
+declare const console: {
+  log(...values: unknown[]): void;
+  info(...values: unknown[]): void;
+  warn(...values: unknown[]): void;
+  error(...values: unknown[]): void;
+};
 //#endregion
-export type { BoundedDerivedSequencePayload, BoundedNativeSequencePayload, BusinessEntityFacade, BusinessRelationFacade, CaptionFontDescriptor, CaptionSegmentSelection, CaptionStyleFields, CaptionTextRange, CaptionTextSelection, ClipEntityId, ClipPlacement, ComposedPhoneticContent, ComposedScriptContent, CreateEntityInput, DeleteBgmInput, DeleteClipInput, DeleteClipTreeInput, DeleteEntityInput, DeleteVoiceoverInput, EditApi, EmptyRelationKind, EntityId, EntityPayloadByKind, EntityStoreSnapshot, InsertCaptionClipInput, InsertClipInput, InsertPlacedClipInput, JsonObject, JsonPrimitive, JsonValue, KnownEntityKind, KnownRelationKind, LinearClipSpeed, LinkAudioScriptSourceRelationInput, LinkClipAnchorRelationInput, LinkGeneratedRelationInput, LinkPhoneticScriptRenderRelationInput, LinkRelationInput, MoveClipInput, MoveClipsToStartsInput, MoveSequentialClipsInput, MoveVoiceoverInput, PatchCaptionStyleInput, ReplaceClipContentInput, SandboxCheckpoint, SandboxEntity, SandboxRelation, ScriptTextSegment, SequenceDuration, SequenceRange, SequentialClipAnchor, SetCaptionVisibilityInput, SetClipPlacementInput, SetClipSpeedInput, SetClipVolumeInput, StoredEntityPayload, TimelineApi, TrimClipInput, UnboundedConstantSequencePayload, UnlinkRelationInput, UpdateClipInput, UpdateClipMarkerInput, UpdateEntityInput, checkpoint, edit, entities, inputs, relations, rollbackTo, timeline };
+export type { BoundedDerivedSequencePayload, BoundedNativeSequencePayload, BusinessEntityFacade, BusinessRelationFacade, CaptionTextSelection, CreateEntityInput, DeleteEntityInput, EntityAssetContent, EntityPayloadByKind, EntitySandboxCheckpoint, EntityUpdateInput, FieldChange, FieldPath, JsonObject, JsonPrimitive, JsonValue, KnownEntityKind, KnownRelationKind, LinkRelationInput, MediaAssetPayload, RelationUpdateInput, SandboxEntity, SandboxRelation, ScriptTextSegment, StoredEntityPayload, UnboundedConstantSequencePayload, UnlinkRelationInput, UpdateEntityInput, checkpoint, console, entities, inputs, relations, rgetAssetFromEntity, rollbackTo };
 //# sourceMappingURL=sandbox-api.d.mts.map

package/dist/worker-entry.d.mts

@@ -1,4 +1,4 @@
-import { s as EntityStoreSnapshot } from "./entity-contract-DHasvrhq.mjs";
+import { l as EntityStoreSnapshot } from "./entity-contract-DQ56Ihrh.mjs";
 import { VideoDocument } from "@mengine/medeo-client";
 
 //#region src/sandbox/worker-entry.d.ts
@@ -15,7 +15,6 @@ interface WorkerData {
   inputs?: Record<string, unknown>;
   entityState?: EntityStoreSnapshot;
   idLabel?: string;
-  entityOnly?: boolean;
 }
 //#endregion
 export { WorkerData };