@hypit/hypit 0.1.3 → 0.1.5

package/dist/public/generation.d.ts

@@ -447,6 +447,8 @@ declare function verifyRequestAgainstPorts(table: GenerationPortTable, value: un
 /** Build one canonical request for a model from its declared ports. */
 declare function sealGenerationPortRequest(table: GenerationPortTable, ports: Readonly<Record<string, readonly GenerationPortValue[]>>): GenerationRequest;
 
+/** Per-reference fields consumed by the service's resource transport rather than its generation body. */
+type GenerationArtifactUrlResolver = (artifact: BlobRef, fields?: Readonly<Record<string, string | number | boolean>>) => Promise<string>;
 /**
  * How one service names the fields of one model's declared input ports.
  *
@@ -454,7 +456,6 @@ declare function sealGenerationPortRequest(table: GenerationPortTable, ports: Re
  * Provider package therefore never imports a model package: the model owns what
  * it eats, the service owns what it calls that on the wire.
  */
-type GenerationArtifactUrlResolver = (artifact: BlobRef) => Promise<string>;
 type GenerationFieldMapping = 
 /** One scalar written as-is. */
 {
@@ -478,12 +479,14 @@ type GenerationFieldMapping =
  | {
     readonly as: "url";
     readonly field: string;
+    readonly resourceFields?: readonly string[];
     readonly whenAbsent?: CanonicalValue;
 }
 /** Several media items written as one array of resolved URLs. */
  | {
     readonly as: "urlArray";
     readonly field: string;
+    readonly resourceFields?: readonly string[];
     readonly whenAbsent?: CanonicalValue;
 }
 /** Media items written as objects carrying the resolved URL and their item fields. */
@@ -491,6 +494,7 @@ type GenerationFieldMapping =
     readonly as: "itemObject";
     readonly field: string;
     readonly urlKey: string;
+    readonly resourceFields?: readonly string[];
     readonly fieldKeys: Readonly<Record<string, string>>;
     readonly whenAbsent?: CanonicalValue;
 };

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 };