@mengine/medeo-client 1.3.1-alpha.1 → 1.3.1-alpha.11

package/README.md

@@ -74,18 +74,17 @@ plan. A speech-overlap shift is explicit placement on the real visual Clips;
 an uncovered time interval does not require an invented empty-media entity.
 
 Generated Voice links to a pre-existing PhoneticScript through `phonetic-script-render`.
-Caption and PhoneticScript each compose a real AudioScript through exactly one
-`caption-composition` or `phonetic-script-composition` relation. AudioScript owns
-`segments[].text`; the variants never persist a text copy. Read complete content
+Caption and PhoneticScript each compose a real AudioScript by directly holding `baseEntityIds`, an array that may compose multiple entities. AudioScript owns
+`segments[].text`; assembly never automatically persists a copy on the variants. Read complete content
 with `assembleCaptionContent` or `assemblePhoneticScriptContent`. Broken composition
-fails explicitly. Recorded Audio/Video/Voice can be the ASR source via
+fails explicitly. Same-name fields from different bases are rejected even for equal values and even if the variant declares that field. After base fields are unambiguous, explicit own fields may override them without mutating the bases. Recorded Audio/Video/Voice can be the ASR source via
 `audio-script-source`, without creating a synthesis variant.
 
-`insertCaptionClip` requires `audioScriptEntityId` and `selections`. Each selection
+`insertCaptionClip` requires `baseEntityIds` and `selections`. Each selection
 names a source `segmentId` and optionally a half-open Unicode code-point
 `textRange: {start, end}`. This permits display re-segmentation without rewriting
 the original script. `upsertVoiceoverTake` requires the real
-`phoneticScriptEntityId` used for synthesis; its captions select the same script.
+`phoneticScriptEntityId` used for synthesis; its captions supply their own `baseEntityIds` and select the same script.
 External speech identity and storage key stay on Voice.
 
 AudioScript has no intrinsic Sequence and cannot enter a Clip. `audio-script-marker`
@@ -107,3 +106,9 @@ It rejects `video-document/entity-projection-v1` documents. Production entity
 tools and editor adapters must not fall back to it or raw `/updates` on failure.
 For an entity projection, `meta.version` is the committed entity revision; the
 Loro version vector remains the transport-sync cursor.
+
+### Transparent variant fields in the DSL sandbox
+
+`entities.get/list` return complete assembled fields. Consumers do not query base IDs or merge source payloads. `entities.update` patches supplied fields, preserves omitted fields, and routes inherited fields to their declaring entity. Explicit own-field declarations use `entities.declareFields`; these override unambiguous base fields without changing the base. Persisted entity rows and command payloads contain owned fields only. Base collisions are validated before own overrides.
+
+`prepareCaptionContent` accepts caption authoring intent and handles source composition, visible text selection, and preservation of existing intrinsic timing inside the SDK.