@mengine/medeo-tool 1.3.1-alpha.11 → 1.3.1-alpha.13

package/dist/sandbox-api.d.mts

@@ -25,6 +25,35 @@ interface BoundedNativeSequencePayload extends JsonObject {
   sampling: 'native';
   coordinateSpace: JsonValue;
 }
+/** Business editing surface. Infrastructure Assets are assembled by the host. */
+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;
+  declareFields(input: UpdateEntityInput): void;
+  delete(input: DeleteEntityInput): void;
+  ensureMedia(fact: MediaAssetFact): {
+    contentEntityId: string;
+  };
+}
+/** Physical Asset bindings are maintained outside the sandbox. */
+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;
+  unlink(input: UnlinkRelationInput): void;
+}
 interface CaptionFontDescriptor {
   readonly system: 'font-library';
   readonly key: string;
@@ -114,28 +143,6 @@ interface DeleteVoiceoverInput {
   readonly voiceoverClipEntityIds: readonly string[];
 }
 type EmptyRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'audio-script-marker';
-interface EntityFacade {
-  /** Read complete assembled fields; returned objects are snapshots. Use update to persist edits. */
-  list(): SandboxEntity[];
-  get(entityId: string): SandboxEntity | null;
-  /** Find document resources by external Memota asset id, including directly composed media variants. */
-  findByAssetId(assetId: string): SandboxEntity<ResourceEntityKind>[];
-  /** Assemble selected Caption text; missing composition is an error. */
-  readCaptionContent(entityId: string): ComposedScriptContent;
-  /** Assemble base text and pronunciation fields before generating Voice. */
-  readPhoneticScriptContent(entityId: string): ComposedPhoneticContent;
-  create(input: CreateEntityInput): string;
-  /** Patch assembled fields, routing inherited fields to their declaring entity. */
-  update(input: UpdateEntityInput): void;
-  /** Explicitly declare own fields, overriding unambiguous bases without modifying them. Ordinary edits use update. */
-  declareFields(input: UpdateEntityInput): void;
-  /** Delete an Entity only after all of its incident Relations have been explicitly unlinked. */
-  delete(input: DeleteEntityInput): void;
-  /** Get or create one typed Asset by factual external id and return its single content identity. Never creates a Clip. */
-  ensureMedia(fact: MediaAssetFact): {
-    contentEntityId: string;
-  };
-}
 type EntityId = string;
 interface EntityPayloadByKind {
   axvideo: BoundedDerivedSequencePayload;
@@ -206,6 +213,8 @@ interface ImageMediaAssetFact {
 }
 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. */
@@ -353,23 +362,6 @@ interface PatchCaptionStyleInput {
   readonly timelineEntityId: string;
   readonly style: CaptionStyleFields;
 }
-interface RelationFacade {
-  list(): SandboxRelation[];
-  /** Incident lookup is endpoint-agnostic; persisted endpoint positions stay unchanged. */
-  of(entityId: string, relationKind?: KnownRelationKind): SandboxRelation[];
-  /** Link existing entities through ordinary associations; variant bases are stored directly on the variant. */
-  link(input: LinkRelationInput): string;
-  /** Author ordered generated(output,input); generic link() deliberately rejects this kind. */
-  linkGenerated(input: LinkGeneratedRelationInput): string;
-  /** Author ordered clip-anchor(child,host) without positional endpoint ambiguity. */
-  linkClipAnchor(input: LinkClipAnchorRelationInput): string;
-  /** Author ordered phonetic-script-render(output,script) without positional endpoint ambiguity. */
-  linkPhoneticScriptRender(input: LinkPhoneticScriptRenderRelationInput): string;
-  /** Author ordered audio-script-source(script,source) without positional endpoint ambiguity. */
-  linkAudioScriptSource(input: LinkAudioScriptSourceRelationInput): string;
-  /** Remove a Relation by identity; endpoint replacement is an explicit unlink plus link. */
-  unlink(input: UnlinkRelationInput): void;
-}
 interface ReplaceClipContentInput {
   readonly clipEntityId: string;
   /** Existing Sequence media Entity id. Asset ids and URLs are not content ids. */
@@ -396,8 +388,6 @@ interface ReplacementMediaClipInput {
   readonly sourceRange: SequenceRange<number>;
   readonly volume?: number;
 }
-/** Asset identity, either an old physical-only row or a directly composed media variant. */
-type ResourceEntityKind = 'image' | 'video' | 'audio' | 'voice';
 interface SandboxEntity<K extends KnownEntityKind = KnownEntityKind> {
   entity_id: string;
   entity_kind: K;
@@ -589,11 +579,11 @@ interface SandboxCheckpoint {
 }
 declare const edit: EditApi;
 declare const timeline: TimelineApi;
-declare const entities: EntityFacade;
-declare const relations: RelationFacade;
+declare const entities: BusinessEntityFacade;
+declare const relations: BusinessRelationFacade;
 declare function checkpoint(): SandboxCheckpoint;
 declare function rollbackTo(cp: SandboxCheckpoint): void;
 declare const inputs: Readonly<Record<string, unknown>>;
 //#endregion
-export type { AudioMediaAssetFact, BoundedDerivedSequencePayload, BoundedNativeSequencePayload, CaptionFontDescriptor, CaptionSegmentSelection, CaptionStyleFields, CaptionTextRange, CaptionTextSelection, ClipEntityId, ClipPlacement, ComposedPhoneticContent, ComposedScriptContent, CreateEntityInput, DeleteBgmInput, DeleteClipInput, DeleteClipTreeInput, DeleteEntityInput, DeleteVoiceoverInput, EditApi, EmptyRelationKind, EntityFacade, EntityId, EntityPayloadByKind, EntityStoreSnapshot, ImageMediaAssetFact, InsertCaptionClipInput, InsertClipInput, InsertMediaClipInput, InsertMediaClipsInput, InsertPlacedClipInput, JsonObject, JsonPrimitive, JsonValue, KnownEntityKind, KnownRelationKind, LinearClipSpeed, LinkAudioScriptSourceRelationInput, LinkClipAnchorRelationInput, LinkGeneratedRelationInput, LinkPhoneticScriptRenderRelationInput, LinkRelationInput, MediaAssetFact, MediaAssetPayload, MediaClipInsertion, MoveClipInput, MoveClipsToStartsInput, MoveSequentialClipsInput, MoveVoiceoverInput, PatchCaptionStyleInput, RelationFacade, ReplaceClipContentInput, ReplaceMediaClipInput, ReplaceSequentialClipsInput, ReplacementMediaClipInput, ResourceEntityKind, SandboxCheckpoint, SandboxEntity, SandboxRelation, ScriptTextSegment, SequenceDuration, SequenceRange, SequentialClipAnchor, SetBgmInput, SetCaptionVisibilityInput, SetClipPlacementInput, SetClipSpeedInput, SetClipVolumeInput, StoredEntityPayload, TimelineApi, TrimClipInput, UnboundedConstantSequencePayload, UnlinkRelationInput, UpdateClipInput, UpdateClipMarkerInput, UpdateEntityInput, VideoMediaAssetFact, VisualMediaAssetFact, VoiceDescriptor, VoiceMediaAssetFact, VoiceoverCaptionFact, VoiceoverTakeInput, VoiceoverTakeResult, checkpoint, edit, entities, inputs, relations, rollbackTo, timeline };
+export type { AudioMediaAssetFact, BoundedDerivedSequencePayload, BoundedNativeSequencePayload, BusinessEntityFacade, BusinessRelationFacade, CaptionFontDescriptor, CaptionSegmentSelection, CaptionStyleFields, CaptionTextRange, CaptionTextSelection, ClipEntityId, ClipPlacement, ComposedPhoneticContent, ComposedScriptContent, CreateEntityInput, DeleteBgmInput, DeleteClipInput, DeleteClipTreeInput, DeleteEntityInput, DeleteVoiceoverInput, EditApi, EmptyRelationKind, EntityId, EntityPayloadByKind, EntityStoreSnapshot, ImageMediaAssetFact, InsertCaptionClipInput, InsertClipInput, InsertMediaClipInput, InsertMediaClipsInput, InsertPlacedClipInput, JsonObject, JsonPrimitive, JsonValue, KnownEntityKind, KnownRelationKind, LinearClipSpeed, LinkAudioScriptSourceRelationInput, LinkClipAnchorRelationInput, LinkGeneratedRelationInput, LinkPhoneticScriptRenderRelationInput, LinkRelationInput, MediaAssetFact, MediaAssetPayload, MediaClipInsertion, MoveClipInput, MoveClipsToStartsInput, MoveSequentialClipsInput, MoveVoiceoverInput, PatchCaptionStyleInput, ReplaceClipContentInput, ReplaceMediaClipInput, ReplaceSequentialClipsInput, ReplacementMediaClipInput, SandboxCheckpoint, SandboxEntity, SandboxRelation, ScriptTextSegment, SequenceDuration, SequenceRange, SequentialClipAnchor, SetBgmInput, SetCaptionVisibilityInput, SetClipPlacementInput, SetClipSpeedInput, SetClipVolumeInput, StoredEntityPayload, TimelineApi, TrimClipInput, UnboundedConstantSequencePayload, UnlinkRelationInput, UpdateClipInput, UpdateClipMarkerInput, UpdateEntityInput, VideoMediaAssetFact, VisualMediaAssetFact, VoiceDescriptor, VoiceMediaAssetFact, VoiceoverCaptionFact, VoiceoverTakeInput, VoiceoverTakeResult, checkpoint, edit, entities, inputs, relations, rollbackTo, timeline };
 //# sourceMappingURL=sandbox-api.d.mts.map

package/dist/{script-session-DLBhoA1R.mjs → script-session-IqAIVBCM.mjs}

@@ -422,9 +422,8 @@ function entityToRow(entity) {
 //#region ../medeo-dsl/src/invariants.ts
 /**
 * Media variants own their Asset identity directly: a `physical-asset`
-* Relation may not bind them. Caption text is composed domain content, so
-* Captions do not bind Physical Assets either; the Relation vocabulary stays
-* open for future physical pipeline semantics.
+* Relation may not bind them. Caption may associate with a physical text Asset
+* independently of its AudioScript composition.
 */
 function validateMediaAssetIdentity(entity, index) {
 	return [...index.relationsOf(entity)].filter((relation) => relation.kind === "physical-asset").map(() => ({
@@ -583,11 +582,6 @@ function validatePhoneticComposition(phonetic, index, entities = []) {
 }
 function validateVariantComposition(variant, index, entities, kind) {
 	const issues = [];
-	if (kind === "caption" && ofKind([...index.relationsOf(variant)], "physical-asset").length > 0) issues.push({
-		code: "caption_physical_asset_forbidden",
-		entityId: variant.entityId,
-		message: "Caption text is composed from its AudioScript; Caption must not bind a Physical Asset"
-	});
 	const rows = {
 		entities: collectRelatedEntities([...entities, variant], index).entities.map((ref) => entityToRow(ref.current())),
 		relations: []
@@ -2388,4 +2382,4 @@ function replayJournalSync(adapter, journal) {
 //#endregion
 export { isMediaAssetVariantKind as a, renderCompactProjection as c, createRelationId as i, EntitySandbox as n, collectAffectedPartIds as o, createEntityId as r, renderPreview as s, EditSandboxSession as t };
 
-//# sourceMappingURL=script-session-DLBhoA1R.mjs.map
+//# sourceMappingURL=script-session-IqAIVBCM.mjs.map