@hypit/hypit 0.1.4 → 0.1.5

package/dist/public/hyperframes.d.ts

@@ -243,6 +243,22 @@ type CompositableSurfaceRef = {
     };
 };
 
+/** Gain and audibility are measured on the complete 48 kHz program clock. */
+type AudioSampleSpan = {
+    readonly startSample: number;
+    readonly endSampleExclusive: number;
+};
+type AudioGainPoint = {
+    readonly sample: number;
+    readonly gain: number;
+};
+type AudioPresentation = {
+    /** Linear interpolation; hold the first/last gain outside the supplied points. */
+    readonly gainEnvelope?: readonly AudioGainPoint[];
+    /** Half-open audible regions; omission means the complete target, [] means silence. */
+    readonly audibility?: readonly AudioSampleSpan[];
+};
+
 /** Structural style vocabulary. Renderer programs own their richer layout and code formats. */
 declare const VISUAL_IR_V1: "hypit.visual-ir@1";
 
@@ -623,6 +639,8 @@ type VisualPresent = {
     /** Optional domain entity implemented by this renderer Present. */
     readonly subjectId?: string;
     readonly span: FrameSpan;
+    /** Optional visible subranges in program frames; span remains the animation and sampling origin. */
+    readonly visibility?: readonly FrameSpan[];
     /** Absolute paint position for this Present, not for its authoring Track. */
     readonly stacking: {
         readonly order: number;
@@ -640,7 +658,7 @@ type VisualTrack = {
     /** Author-owned contributions that Composition may interleave by absolute z. */
     readonly presents: readonly VisualPresent[];
 };
-type AudioClip = {
+type AudioClip = AudioPresentation & {
     readonly id: string;
     /** Optional domain entity implemented by this renderer Clip. */
     readonly subjectId?: string;

package/dist/public/narrative.d.ts

@@ -273,12 +273,14 @@ type SemanticAnchor = {
     readonly segmentId: string;
     readonly tokenId?: string;
 };
+/** Complete authored content; local views are projections of this value. */
 type Narrative = {
     /** Author-visible `<script id>`; every exported semantic view retains it. */
     readonly id: string;
     readonly segments: readonly NarrativeSegment[];
     readonly tokens: readonly NarrativeToken[];
     readonly turns: readonly NarrativeTurn[];
+    readonly caption: CaptionDocument;
     readonly selections: readonly NarrativeSelection[];
     readonly moments: readonly NarrativeMoment[];
     readonly semanticIndex: {
@@ -305,11 +307,23 @@ declare function assertNarrativeSelectionRefIdentity(value: NarrativeSelectionRe
 declare function assertNarrativeMomentRefIdentity(value: NarrativeMomentRef): void;
 declare function assertCaptionDocumentIdentity(value: CaptionDocument): void;
 
-declare const narrativeSchema: ValueSchema;
 declare const narrativeExcerptSchema: ValueSchema;
 declare const captionDocumentSchema: ValueSchema;
+declare const narrativeSchema: ValueSchema;
 declare const narrativeMomentSchema: ValueSchema;
 declare const narrativeSelectionSchema: ValueSchema;
 
-export { assertCaptionDocumentIdentity, assertNarrativeExcerptIdentity, assertNarrativeIdentity, assertNarrativeMomentRefIdentity, assertNarrativeSelectionRefIdentity, captionDocumentSchema, narrativeComponent, narrativeDependency, narrativeExcerptSchema, narrativeManifest, narrativeModuleRef, narrativeMomentSchema, narrativeSchema, narrativeSelectionSchema, narrativeTypes };
-export type { CaptionAlignmentUnit, CaptionCueBreak, CaptionDisplayWord, CaptionDocument, CaptionWordAttribute, CaptionWordAttributeValue, Narrative, NarrativeExcerpt, NarrativeMoment, NarrativeMomentRef, NarrativeSegment, NarrativeSelection, NarrativeSelectionRef, NarrativeToken, NarrativeTurn, SemanticAnchor };
+/** A range in authored token order, independent of material placement and frame timing. */
+type NarrativeTokenRange = {
+    readonly narrativeId: string;
+    readonly tokenStart: number;
+    readonly tokenEndExclusive: number;
+};
+/** Resolve a semantic anchor to a boundary in the authored token sequence. */
+declare function narrativeAnchorTokenBoundary(narrative: Narrative, anchorId: string): number;
+declare function narrativeSelectionTokenRange(narrative: Narrative, selection: NarrativeSelection | NarrativeSelectionRef): NarrativeTokenRange;
+/** Select content without consulting a Timeline or reconstructing prose from token strings. */
+declare function narrativeTokensForSelection(narrative: Narrative, selection: NarrativeSelection | NarrativeSelectionRef): readonly NarrativeToken[];
+
+export { assertCaptionDocumentIdentity, assertNarrativeExcerptIdentity, assertNarrativeIdentity, assertNarrativeMomentRefIdentity, assertNarrativeSelectionRefIdentity, captionDocumentSchema, narrativeAnchorTokenBoundary, narrativeComponent, narrativeDependency, narrativeExcerptSchema, narrativeManifest, narrativeModuleRef, narrativeMomentSchema, narrativeSchema, narrativeSelectionSchema, narrativeSelectionTokenRange, narrativeTokensForSelection, narrativeTypes };
+export type { CaptionAlignmentUnit, CaptionCueBreak, CaptionDisplayWord, CaptionDocument, CaptionWordAttribute, CaptionWordAttributeValue, Narrative, NarrativeExcerpt, NarrativeMoment, NarrativeMomentRef, NarrativeSegment, NarrativeSelection, NarrativeSelectionRef, NarrativeToken, NarrativeTokenRange, NarrativeTurn, SemanticAnchor };