@hypit/hypit 0.1.3 → 0.1.5

package/README.md

@@ -17,7 +17,7 @@
 
 <p align="center">
   <a href="https://github.com/hypit-ai/hypit/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/hypit-ai/hypit?style=flat-square&color=FFD700&logo=github&logoColor=white&label=Stars"></a>
-  <a href="https://github.com/hypit-ai/hypit/blob/main/package.json"><img alt="Node 22.12+" src="https://img.shields.io/badge/Node.js-22.12%2B-5FA04E?style=flat-square&logo=nodedotjs&logoColor=white"></a>
+  <a href="https://github.com/hypit-ai/hypit/blob/main/package.json"><img alt="Node 22.15+" src="https://img.shields.io/badge/Node.js-22.15%2B-5FA04E?style=flat-square&logo=nodedotjs&logoColor=white"></a>
   <a href="https://github.com/hypit-ai/hypit/blob/main/package.json"><img alt="pnpm 10.33" src="https://img.shields.io/badge/pnpm-10.33-F69220?style=flat-square&logo=pnpm&logoColor=white"></a>
   <a href="https://github.com/hypit-ai/hypit/blob/main/package.json"><img alt="TypeScript 5.9" src="https://img.shields.io/badge/TypeScript-5.9-3178C6?style=flat-square&logo=typescript&logoColor=white"></a>
   <a href="https://github.com/hypit-ai/hypit/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Apache--2.0%20with%20conditions-E3B341?style=flat-square"></a>
@@ -26,7 +26,7 @@
 <p align="center">
   <a href="https://hypit.ai"><img alt="Visit our website" src="https://img.shields.io/badge/Visit%20our%20website-DF3C68?style=for-the-badge&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjI1Ny4wMyAyODcuNDggNDg2Ljk0IDQyNi4wNCI%2BPHBhdGggZmlsbD0iI2ZmZiIgZD0iTTczMy4wMDEsNDYyLjU5MmMtMTEuNDQtMTYuNTEtMzAuMjg1LTI2LjM0NC01MC4zNTMtMjYuMzQ0aC0xNzguNzA1Yy0yMy40OTMsMC00Ny42NzUsMTQuMjM0LTU2LjYyOCwzNS45NjdsLTU0LjA2NSwxNDUuMDUzYy04LjgsMjEuNTIzLTguNjg2LDQ2LjAxMSw0LjI0Nyw2NS4zNTIsMTIuOTksMTkuNDE4LDM3LjAzOCwzMC44OTcsNjAuMzk3LDMwLjg5N2gxNjQuNDljMjcuMDEzLDAsNTEuNDYzLTE2Ljk4OSw2MC45MTQtNDIuMjhsNTYuODAxLTE1Mi4yMjdjNy4wMjEtMTguODI1LDQuMzgxLTM5LjkwOC03LjA1OS01Ni4zOTl2LS4wMzhoLS4wMzh2LjAxOVpNNjMzLjk3OCw2NTIuODEzYy0xLjc5OCw0LjgyMS02LjQ4NSw4LjA3My0xMS42MzIsOC4wNzNoLTE1OS42NWMtOC4zMDMsMC0xMi43OC01LjM1Ny0xNC4zMjktNy42MzNzLTQuNzgzLTguNDc1LTEuNjA3LTE2LjE0N2w0NS42MjgtMTI2LjcyNWM0LjM4MS0xMi4xNDgsMTUuNDU4LTIwLjc5NiwyOC4zNTItMjEuNDY1LjYzMS0uMDM4LDEuMjgyLS4wMzgsMS45NTEtLjAzOGgxNDQuMjY5czIzLjkzMywyLjcxNywxNy43NzMsMjcuOTUxbC01MC43NTUsMTM2LjAwNGgwdi0uMDE5Wk0zNTYuMjUsNjIzLjEyMnMtNDIuNzc3LTIyLjE3My0zMy43ODYtNjIuNDgzbDU2Ljc2Mi0xNTcuMzE2YzkuMTQ1LTI1LjM0OSwzMy4yMTItNDIuMjYxLDYwLjE2OC00Mi4yNjFoMTgxLjc4NWMxMS45NTcsMCwyMy4xNDksNS43OTcsMzAuMDU1LDE1LjU3M2wyNi41NzMsMzcuNjVoLTIxNi4xMjVjLTE2LjY0NCwwLTMxLjU0NywxMC4zNS0zNy4zNDQsMjUuOTYxbC02OC4wODgsMTgyLjg5NWgwdi0uMDE5Wk0yOTIuMDY0LDU0OS41NDNzLTQyLjc5Ny0yMi4xNzMtMzMuNzg2LTYyLjQ4M2w1Ni43NjItMTU3LjMxNmM5LjE2NC0yNS4zNDksMzMuMjMxLTQyLjI2MSw2MC4xNjgtNDIuMjYxaDE3Mi4wMDljMTEuOTU3LDAsMjMuMTQ5LDUuNzk3LDMwLjA1NSwxNS41NzNsMjYuNTczLDM3LjY1aC0yMDYuMzExYy0xNi42NDQsMC0zMS41NDcsMTAuMzUtMzcuMzQ0LDI1Ljk2MWwtNjguMDg4LDE4Mi44OTVoLS4wMzh2LS4wMTlaIi8%2BPC9zdmc%2B"></a>
   <a href="https://discord.gg/85hnyQnxpn"><img alt="Join our Discord" src="https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white"></a>
-  <a href="https://t.me/hypit"><img alt="Join our Telegram" src="https://img.shields.io/badge/Join%20our%20Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white"></a>
+  <a href="https://t.me/hypitai"><img alt="Join our Telegram" src="https://img.shields.io/badge/Join%20our%20Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white"></a>
   <a href="https://x.com/hypitai"><img alt="Follow @hypitai on X" src="https://img.shields.io/badge/Follow%20%40hypitai-000000?style=for-the-badge&logo=x&logoColor=white"></a>
 </p>
 
@@ -46,7 +46,7 @@ Hypit gives AI agents (Claude Code, Codex...) a language and system to create vi
 
 ## Install once
 
-Install the Hypit CLI (Node.js 22.12 or newer):
+Install the Hypit CLI (Node.js 22.15 or newer):
 
 ```bash
 npm install -g @hypit/hypit
@@ -140,3 +140,5 @@ commands and the repository layout.
 ## License
 
 Hypit is released under the [Hypit Open Source License](https://github.com/hypit-ai/hypit/blob/main/LICENSE). The videos and other outputs you create belong to you; third-party models and services may have their own terms.
+
+Partnership Community: [LINUX DO](https://linux.do/)

package/dist/public/caption.d.ts

@@ -240,12 +240,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: {
@@ -259,13 +261,30 @@ type CaptionUnitSubset = {
     readonly unitIds: readonly string[];
 };
 /** Project a semantic Selection to complete authored N:M Caption units. */
-declare function captionUnitsForSelection(document: CaptionDocument, narrative: Narrative, selection: NarrativeSelection): CaptionUnitSubset;
+declare function captionUnitsForSelection(narrative: Narrative, selection: NarrativeSelection): CaptionUnitSubset;
 declare function captionUnitsForRole(document: CaptionDocument, role: string): CaptionUnitSubset;
 declare function captionWordsForAttribute(document: CaptionDocument, attribute: string): readonly string[];
 declare function assertCaptionUnitSubset(value: CaptionUnitSubset, document: CaptionDocument): void;
 
 declare const captionComponent: {
-    producers: {
+    producers: ({
+        producer: {
+            module: {
+                readonly name: "@hypit/caption";
+                readonly version: "1";
+            };
+            name: string;
+        };
+        handler: ({ inputs }: ProducerHandlerContext) => {
+            outputs: {
+                program: {
+                    kind: "inline";
+                    value: CanonicalValue;
+                };
+            };
+            needs: {};
+        };
+    } | {
         producer: {
             module: {
                 readonly name: "@hypit/caption";
@@ -282,7 +301,7 @@ declare const captionComponent: {
             };
             needs: {};
         };
-    }[];
+    })[];
     validators: {
         type: {
             module: {
@@ -381,14 +400,26 @@ type AuthorSourceIdentity = {
 type Awaitable<T> = T | Promise<T>;
 
 declare const captionTimingFragment: GraphFragment;
-/** Kept as the fragment's public name for callers that only know the old export. */
-declare const plannedCaptionTimingFragment: GraphFragment;
 
 declare const captionModuleRef: {
     readonly name: "@hypit/caption";
     readonly version: "1";
 };
 declare const captionProducers: {
+    create: {
+        module: {
+            readonly name: "@hypit/caption";
+            readonly version: "1";
+        };
+        name: string;
+    };
+    append: {
+        module: {
+            readonly name: "@hypit/caption";
+            readonly version: "1";
+        };
+        name: string;
+    };
     temporalizeDocument: {
         module: {
             readonly name: "@hypit/caption";
@@ -398,6 +429,20 @@ declare const captionProducers: {
     };
 };
 declare const captionTypes: {
+    header: {
+        module: {
+            readonly name: "@hypit/caption";
+            readonly version: "1";
+        };
+        name: string;
+    };
+    filter: {
+        module: {
+            readonly name: "@hypit/caption";
+            readonly version: "1";
+        };
+        name: string;
+    };
     style: {
         module: {
             readonly name: "@hypit/caption";
@@ -424,8 +469,8 @@ declare const captionStyleSchema: ValueSchema;
 declare const captionProgramSchema: ValueSchema;
 declare const timedCaptionProjectionSchema: ValueSchema;
 declare const captionMarkupSurfaces: readonly [{
-    readonly name: "program";
-    readonly tag: "Program";
+    readonly name: "hidden";
+    readonly tag: "Hidden";
     readonly mode: "structured";
     readonly outputs: readonly [{
         module: {
@@ -435,113 +480,15 @@ declare const captionMarkupSurfaces: readonly [{
         name: string;
     }];
     readonly vocabulary: {
-        readonly summary: "Assigns rendering Styles to the Script-owned CaptionDocument using authored semantic selections.";
+        readonly summary: "Declares a Caption Style that contributes no rendering when selected by Use.";
         readonly attributes: readonly [{
             readonly name: "id";
             readonly kind: "identifier";
             readonly required: true;
-            readonly summary: "Names the CaptionProgram.";
-        }, {
-            readonly name: "document";
-            readonly kind: "reference";
-            readonly required: true;
-            readonly accepts: readonly [{
-                module: {
-                    readonly name: "@hypit/narrative";
-                    readonly version: "1";
-                };
-                name: string;
-            }];
-            readonly summary: "The complete Script-owned CaptionDocument.";
-        }, {
-            readonly name: "narrative";
-            readonly kind: "reference";
-            readonly required: true;
-            readonly accepts: readonly [{
-                module: {
-                    readonly name: "@hypit/narrative";
-                    readonly version: "1";
-                };
-                name: string;
-            }];
-            readonly summary: "The semantic anchor universe used to project selections.";
-        }, {
-            readonly name: "default";
-            readonly kind: "reference";
-            readonly required: true;
-            readonly accepts: readonly [{
-                module: {
-                    readonly name: "@hypit/caption";
-                    readonly version: "1";
-                };
-                name: string;
-            }];
-            readonly summary: "The default Style.";
-        }];
-        readonly children: readonly [{
-            readonly tag: "Use";
-            readonly cardinality: "many";
-            readonly summary: "Applies a complete Style by Role or semantic Selection, or supplies a word-attribute Style for a supporting family.";
-            readonly attributes: readonly [{
-                readonly name: "style";
-                readonly kind: "reference";
-                readonly required: true;
-                readonly accepts: readonly [{
-                    module: {
-                        readonly name: "@hypit/caption";
-                        readonly version: "1";
-                    };
-                    name: string;
-                }];
-                readonly summary: "The Style to apply.";
-            }, {
-                readonly name: "role";
-                readonly kind: "literal";
-                readonly required: false;
-                readonly summary: "Selects all Caption units authored for this Role.";
-            }, {
-                readonly name: "selection";
-                readonly kind: "reference";
-                readonly required: false;
-                readonly accepts: readonly [{
-                    module: {
-                        readonly name: "@hypit/narrative";
-                        readonly version: "1";
-                    };
-                    name: string;
-                }];
-                readonly summary: "Selects complete Caption units contained by a semantic Selection.";
-            }, {
-                readonly name: "attribute";
-                readonly kind: "literal";
-                readonly required: false;
-                readonly summary: "Selects display words carrying this Script-native attribute.";
-            }];
-        }, {
-            readonly tag: "Mute";
-            readonly cardinality: "many";
-            readonly summary: "Hides selected complete Caption units.";
-            readonly attributes: readonly [{
-                readonly name: "role";
-                readonly kind: "literal";
-                readonly required: false;
-                readonly summary: "Selects all Caption units authored for this Role.";
-            }, {
-                readonly name: "selection";
-                readonly kind: "reference";
-                readonly required: false;
-                readonly accepts: readonly [{
-                    module: {
-                        readonly name: "@hypit/narrative";
-                        readonly version: "1";
-                    };
-                    name: string;
-                }];
-                readonly summary: "Selects complete Caption units contained by a semantic Selection.";
-            }];
+            readonly summary: "Names the hidden Style.";
         }];
-        readonly example: "<caption:Program id=\"captions\" document={story.caption} narrative={story} default={plain}>\n  <caption:Use role=\"GUEST\" style={guest}/>\n  <caption:Use selection={story.selection.answer} style={answer}/>\n  <caption:Mute selection={story.selection.demonstration}/>\n</caption:Program>";
-        readonly notes: readonly ["Use selects exactly one of role, selection or attribute; Mute selects exactly one of role or selection.", "For Role and Selection applications, the last matching Use in Source order selects the complete Style; properties are not merged.", "Selections may cover a phrase, a whole Segment, several Segments or the program, preserving complete display/pronunciation units.", "All Mute selections hide their words independently of Style order. They do not mute audio; the family still controls neighboring Cue lead and tail.", "Word-attribute runs are separate from Role/Selection overrides and require a family that implements them; Fine does not. Conflicting Styles on one attributed word are rejected."];
+        readonly example: "<caption:Hidden id=\"hidden\"/>";
+        readonly notes: readonly ["Hidden is a complete Style choice; it uses ordinary Use precedence and changes no speech or semantic anchors."];
     };
 }];
 declare const captionManifest: ModuleManifest;
@@ -608,75 +555,17 @@ type SurfaceResolvedReference = {
 };
 type StructuredSurfaceHandler = (input: StructuredSurfaceInput) => Awaitable<SurfaceDecodeOutput>;
 
-declare const decodeCaptionProgramSurface: StructuredSurfaceHandler;
+declare const decodeHiddenCaptionStyleSurface: StructuredSurfaceHandler;
 
-type CaptionStyleIntent = {
+type ProgramSpace = {
+    /** Author-visible identity of this film time axis. */
     readonly id: string;
-    readonly rendering: {
-        readonly family: string;
-        readonly parameters: CanonicalValue;
+    readonly durationSec: number;
+    readonly frameRate: {
+        readonly numerator: number;
+        readonly denominator: number;
     };
 };
-type CaptionStyleApplication = {
-    readonly id: string;
-    readonly unitIds: readonly string[];
-    readonly style: CaptionStyleIntent;
-};
-type CaptionWordStyleApplication = {
-    readonly id: string;
-    readonly attribute: string;
-    readonly wordIds: readonly string[];
-    readonly style: CaptionStyleIntent;
-};
-type CaptionMuteApplication = {
-    readonly id: string;
-    readonly unitIds: readonly string[];
-};
-type CaptionProgramRun = {
-    readonly id: string;
-    readonly styleId: string;
-    readonly unitIds: readonly string[];
-};
-type CaptionProgramWordRun = {
-    readonly id: string;
-    readonly styleId: string;
-    readonly wordIds: readonly string[];
-};
-type CaptionProgram = {
-    readonly id: string;
-    readonly documentId: string;
-    readonly styles: readonly CaptionStyleIntent[];
-    readonly runs: readonly CaptionProgramRun[];
-    /** Optional local word styles resolved from Script-native word attributes. */
-    readonly wordRuns: readonly CaptionProgramWordRun[];
-    readonly mutedUnitIds: readonly string[];
-};
-type TimedCaptionUnit = {
-    readonly unitId: string;
-    readonly startFrame: number;
-    readonly endFrameExclusive: number;
-};
-type TimedCaptionCue = {
-    readonly id: string;
-    readonly styleId: string;
-    readonly startFrame: number;
-    readonly endFrameExclusive: number;
-    readonly units: readonly TimedCaptionUnit[];
-};
-type TimedCaptionProjection = {
-    /** Semantic ProgramSpace from which every unit frame was measured. */
-    readonly spaceId: string;
-    readonly narrativeId: string;
-    readonly documentId: string;
-    readonly cues: readonly TimedCaptionCue[];
-};
-
-declare function sealCaptionStyle(value: CaptionStyleIntent): CaptionStyleIntent;
-declare function assertCaptionStyle(value: CaptionStyleIntent): void;
-declare function sealCaptionProgram(value: CaptionProgram): CaptionProgram;
-declare function assertCaptionProgram(value: CaptionProgram): void;
-declare function assertCaptionProgramForDocument(value: CaptionProgram, document: CaptionDocument): void;
-declare function resolveCaptionProgram(document: CaptionDocument, narrative: Narrative, id: string, defaultStyle: CaptionStyleIntent, applications: readonly CaptionStyleApplication[], mutes?: readonly CaptionMuteApplication[], wordApplications?: readonly CaptionWordStyleApplication[]): CaptionProgram;
 
 type MediaRational = {
     readonly numerator: number;
@@ -730,22 +619,156 @@ type SemanticTake = {
     }[];
 };
 
-type SemanticTrackItem = {
+type TimelineItem = {
     readonly take: SemanticTake;
+    readonly startFrame: number;
+};
+/** One complete film time range, with prepared material placed where it belongs. */
+type Timeline = ProgramSpace & {
+    readonly narrativeId?: string;
+    readonly items: readonly TimelineItem[];
+};
+
+/** Exact author duration. Decimal source spelling is reduced before reaching this value. */
+type TemporalDuration = {
+    readonly unit: "frames";
+    readonly value: number;
+} | {
+    readonly unit: "milliseconds";
+    readonly value: number;
+} | {
+    readonly unit: "seconds";
+    readonly numerator: number;
+    readonly denominator: number;
+};
+/** A single projected boundary before it is resolved into ProgramSpace. */
+type TemporalInstantExpression = {
+    readonly ref: "program.start";
+    readonly offset?: TemporalDuration;
+} | {
+    readonly ref: "program.end";
+    readonly offset?: TemporalDuration;
+} | {
+    readonly ref: "selection.start";
+    readonly offset?: TemporalDuration;
+} | {
+    readonly ref: "selection.end";
+    readonly offset?: TemporalDuration;
+} | {
+    readonly ref: "segment.start";
+    readonly offset?: TemporalDuration;
+} | {
+    readonly ref: "segment.end";
+    readonly offset?: TemporalDuration;
+} | {
+    readonly ref: "moment.cue";
+    readonly offset?: TemporalDuration;
+} | {
+    readonly ref: "absolute";
+    readonly at: TemporalDuration;
+    readonly offset?: TemporalDuration;
+};
+/** Runtime dependency used to resolve an Instant. This is not its authoring authority. */
+type TemporalSource = {
+    readonly spaceId: string;
+    /** Present when the boundary originates in a Script. */
+    readonly narrativeId?: string;
+    readonly kind: "program" | "selection" | "segment" | "moment";
+    readonly id: string;
 };
 /**
- * The continuous program skeleton. Every item is a real SemanticTake and the
- * global frame domain is exactly their prefix sum: no gap or empty item exists.
+ * The author-owned inverse of one projected Instant. Runtime dependencies and
+ * author authority are deliberately separate: an expression may read an
+ * anchor while remaining writable only at its author parameter.
  */
-type SemanticTrack = {
+type TemporalInstantAuthority = {
+    readonly kind: "semantic";
+    readonly boundary: "start" | "end" | "cue";
+} | {
+    readonly kind: "parameter";
+    readonly binding: string;
+    readonly relation: "direct" | "after-start" | "before-end";
+} | {
+    readonly kind: "fixed";
+};
+type FrameSpan$1 = {
+    readonly startFrame: number;
+    readonly endFrameExclusive: number;
+};
+type ProjectedInstant = {
     readonly id: string;
+    readonly subjectId: string;
+    readonly source: TemporalSource;
+    readonly projection: TemporalInstantExpression;
+    readonly authority: TemporalInstantAuthority;
+    readonly frame: number;
+};
+type ProjectedWindow = {
+    readonly id: string;
+    readonly subjectId: string;
+    readonly start: ProjectedInstant;
+    readonly end: ProjectedInstant;
+    readonly span: FrameSpan$1;
+};
+/** Public projection protocol composed from two independently traced Instants. */
+type TemporalWindow = ProjectedWindow;
+
+type CaptionStyleIntent = {
+    readonly id: string;
+    /** null selects no rendering; later Uses can select a visible Style again. */
+    readonly rendering: {
+        readonly family: string;
+        readonly parameters: CanonicalValue;
+    } | null;
+};
+/** Ordered, resolved Uses owned by a Caption Track, not a separate author element. */
+type CaptionUse = {
+    readonly window: TemporalWindow;
+    readonly styleId: string;
+    readonly role?: string;
+};
+type CaptionProgram = {
+    readonly id: string;
+    readonly documentId: string;
+    readonly styles: readonly CaptionStyleIntent[];
+    readonly uses: readonly CaptionUse[];
+};
+type TimedCaptionUnit = {
+    readonly unitId: string;
+    readonly startFrame: number;
+    readonly endFrameExclusive: number;
+};
+type TimedCaptionCue = {
+    readonly id: string;
+    readonly startFrame: number;
+    readonly endFrameExclusive: number;
+    readonly units: readonly TimedCaptionUnit[];
+};
+type TimedCaptionProjection = {
+    /** Semantic Timeline from which every unit frame was measured. */
+    readonly spaceId: string;
     readonly narrativeId: string;
-    readonly items: readonly SemanticTrackItem[];
+    readonly documentId: string;
+    readonly cues: readonly TimedCaptionCue[];
 };
 
-declare function temporalizeCaptionDocument(document: CaptionDocument, semantic: SemanticTrack, program: CaptionProgram): TimedCaptionProjection;
-declare function applyCaptionMute(projection: TimedCaptionProjection, program: CaptionProgram, document: CaptionDocument): TimedCaptionProjection;
+declare function sealCaptionStyle(value: CaptionStyleIntent): CaptionStyleIntent;
+declare function assertCaptionStyle(value: CaptionStyleIntent): void;
+declare function sealCaptionProgram(value: CaptionProgram): CaptionProgram;
+declare function assertCaptionProgram(value: CaptionProgram): void;
+declare function assertCaptionProgramForDocument(value: CaptionProgram, document: CaptionDocument): void;
+declare function appendCaptionUse(program: CaptionProgram, window: TemporalWindow, style: CaptionStyleIntent, role?: string): CaptionProgram;
+
+declare function temporalizeCaptionDocument(document: CaptionDocument, semantic: Timeline): TimedCaptionProjection;
 declare function assertTimedCaptionProjection(projection: TimedCaptionProjection): void;
 
-export { CaptionTimingError, applyCaptionMute, assertCaptionDocument, assertCaptionProgram, assertCaptionProgramForDocument, assertCaptionStyle, assertCaptionUnitSubset, assertTimedCaptionProjection, captionComponent, captionManifest, captionMarkupSurfaces, captionModuleRef, captionProducers, captionProgramSchema, captionStyleSchema, captionTimingFragment, captionTypes, captionUnitsForRole, captionUnitsForSelection, captionWordsForAttribute, decodeCaptionProgramSurface, plannedCaptionTimingFragment, resolveCaptionProgram, sealCaptionProgram, sealCaptionStyle, temporalizeCaptionDocument, timedCaptionProjectionSchema };
-export type { CaptionMuteApplication, CaptionProgram, CaptionProgramRun, CaptionProgramWordRun, CaptionStyleApplication, CaptionStyleIntent, CaptionUnitSubset, CaptionWordStyleApplication, TimedCaptionCue, TimedCaptionProjection, TimedCaptionUnit };
+type FrameSpan = {
+    readonly startFrame: number;
+    readonly endFrameExclusive: number;
+};
+
+/** Later Uses replace this Cue's presentation inside their windows, including Hidden. */
+declare function captionUseVisibility(program: CaptionProgram, index: number, role: string | undefined, envelope: FrameSpan): FrameSpan[];
+
+export { CaptionTimingError, appendCaptionUse, assertCaptionDocument, assertCaptionProgram, assertCaptionProgramForDocument, assertCaptionStyle, assertCaptionUnitSubset, assertTimedCaptionProjection, captionComponent, captionManifest, captionMarkupSurfaces, captionModuleRef, captionProducers, captionProgramSchema, captionStyleSchema, captionTimingFragment, captionTypes, captionUnitsForRole, captionUnitsForSelection, captionUseVisibility, captionWordsForAttribute, decodeHiddenCaptionStyleSurface, sealCaptionProgram, sealCaptionStyle, temporalizeCaptionDocument, timedCaptionProjectionSchema };
+export type { CaptionProgram, CaptionStyleIntent, CaptionUnitSubset, CaptionUse, TimedCaptionCue, TimedCaptionProjection, TimedCaptionUnit };

package/dist/public/composition.d.ts

@@ -215,9 +215,29 @@ declare const visualSurfaceSchema: ValueSchema;
 declare const visualProgramSchema: ValueSchema;
 declare const visualElementSchema: ValueSchema;
 declare const visualTrackSchema: ValueSchema;
+declare const audioSampleSpanSchema: ValueSchema;
+declare const audioGainEnvelopeSchema: ValueSchema;
 declare const audioTrackSchema: ValueSchema;
 declare const compositionSchema: ValueSchema;
 
+/** 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[];
+};
+declare function assertAudioPresentation(value: AudioPresentation, target: AudioSampleSpan, totalSamples?: number): void;
+declare function audioEnvelopeGainAt(points: readonly AudioGainPoint[] | undefined, sample: number): number;
+
 /** Structural style vocabulary. Renderer programs own their richer layout and code formats. */
 declare const VISUAL_IR_V1: "hypit.visual-ir@1";
 
@@ -598,6 +618,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;
@@ -615,7 +637,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;
@@ -668,5 +690,5 @@ declare function assertAudioTrackIdentity(track: AudioTrack, programSpace?: Prog
 declare function sealComposition(value: Composition): Composition;
 declare function assertCompositionIdentity(composition: Composition, programSpace?: ProgramSpace): void;
 
-export { animatableLocalStyles, assertAudioTrackIdentity, assertCompositionIdentity, assertVisualTrackIdentity, audioTrackSchema, compositionComponent, compositionDependency, compositionManifest, compositionModuleRef, compositionSchema, compositionTypes, sealAudioTrack, sealComposition, sealVisualTrack, visualBoxSchema, visualColorPaintSchema, visualElementSchema, visualImageSchema, visualMaskSchema, visualPathCommandSchema, visualProgramSchema, visualSurfaceSchema, visualTextDocumentSchema, visualTextFlowSchema, visualTextPaintSchema, visualTextSchema, visualTextSequenceSchema, visualTextTypographySchema, visualTimedSamplingSchema, visualTrackSchema, visualVideoSchema };
-export type { AudioClip, AudioTrack, Composition, FrameSpan, Track, VisualAnimation, VisualAttribute, VisualBoxElement, VisualColorPaint, VisualEasing, VisualElement, VisualElementBase, VisualKeyframe, VisualMaskElement, VisualMediaElement, VisualPathTextElement, VisualPresent, VisualProgramElement, VisualSamplingRational, VisualSamplingSegment, VisualStyleDeclaration, VisualSurfaceElement, VisualTextBoxDecoration, VisualTextDecoration, VisualTextDirection, VisualTextDocument, VisualTextElement, VisualTextFlow, VisualTextFlowElement, VisualTextInline, VisualTextPaintLayer, VisualTextPaintTarget, VisualTextRunStyle, VisualTextSequenceAnimation, VisualTextTypography, VisualTextWritingMode, VisualTimedSampling, VisualTrack, VisualVectorPathCommand };
+export { animatableLocalStyles, assertAudioPresentation, assertAudioTrackIdentity, assertCompositionIdentity, assertVisualTrackIdentity, audioEnvelopeGainAt, audioGainEnvelopeSchema, audioSampleSpanSchema, audioTrackSchema, compositionComponent, compositionDependency, compositionManifest, compositionModuleRef, compositionSchema, compositionTypes, sealAudioTrack, sealComposition, sealVisualTrack, visualBoxSchema, visualColorPaintSchema, visualElementSchema, visualImageSchema, visualMaskSchema, visualPathCommandSchema, visualProgramSchema, visualSurfaceSchema, visualTextDocumentSchema, visualTextFlowSchema, visualTextPaintSchema, visualTextSchema, visualTextSequenceSchema, visualTextTypographySchema, visualTimedSamplingSchema, visualTrackSchema, visualVideoSchema };
+export type { AudioClip, AudioGainPoint, AudioPresentation, AudioSampleSpan, AudioTrack, Composition, FrameSpan, Track, VisualAnimation, VisualAttribute, VisualBoxElement, VisualColorPaint, VisualEasing, VisualElement, VisualElementBase, VisualKeyframe, VisualMaskElement, VisualMediaElement, VisualPathTextElement, VisualPresent, VisualProgramElement, VisualSamplingRational, VisualSamplingSegment, VisualStyleDeclaration, VisualSurfaceElement, VisualTextBoxDecoration, VisualTextDecoration, VisualTextDirection, VisualTextDocument, VisualTextElement, VisualTextFlow, VisualTextFlowElement, VisualTextInline, VisualTextPaintLayer, VisualTextPaintTarget, VisualTextRunStyle, VisualTextSequenceAnimation, VisualTextTypography, VisualTextWritingMode, VisualTimedSampling, VisualTrack, VisualVectorPathCommand };

package/dist/public/endpoint-kit.d.ts

@@ -36,6 +36,8 @@ type StoredValue = {
     readonly value: CanonicalValue;
 } | BlobRef;
 
+declare function canonicalize(value: unknown): CanonicalValue;
+
 type Need = {
     readonly id: NeedId;
     readonly capability: CapabilityRef;
@@ -70,6 +72,7 @@ type CredentialAcquisition = {
     /** Maximum duration of the service-owned token exchange after browser authorization returns. */
     readonly requestTimeoutMs: number;
 };
+declare function credentialRef(store: string, key: string): CredentialRef;
 
 /** A shared resource: occupancy when periodMs is absent, a replenishing rate budget otherwise. */
 type CapacityResourceClaim = {
@@ -104,6 +107,13 @@ type OperationProgress = {
     readonly unit?: string;
 };
 
+/** Provider-authored diagnostic text suitable for users; never credentials or request bodies. */
+type ExecutionDiagnostic = {
+    readonly level: "info" | "warning" | "error";
+    readonly message: string;
+    readonly stream?: "stdout" | "stderr";
+};
+
 /** Build-local byte resources. Location, retention and transport are Runtime policy. */
 type ResourceIOOptions = {
     /** Cancel the transfer, close its streams and discard unfinished writes before rejecting.
@@ -121,6 +131,14 @@ type ResourceStore = {
     /** Cheap presence query. */
     has(resource: ResourceId, options?: ResourceIOOptions): Promise<boolean>;
 };
+/** Optional transfer capability. Core and components never require storage to expose it. */
+type StreamingResourceStore = ResourceStore & {
+    putStream(chunks: AsyncIterable<Uint8Array>, mediaType: string, options?: ResourceIOOptions): Promise<BlobRef>;
+    writeStream(resource: BlobRef, chunks: AsyncIterable<Uint8Array>, options?: ResourceIOOptions): Promise<void>;
+    /** Stream bytes previously stored under this resource identity. */
+    open(resource: ResourceId, options?: ResourceIOOptions): Promise<AsyncIterable<Uint8Array> | undefined>;
+};
+declare function isStreamingResourceStore(value: ResourceStore): value is StreamingResourceStore;
 
 type Awaitable<T> = T | Promise<T>;
 type EndpointFulfillment = {
@@ -167,6 +185,10 @@ type EndpointInvocationContext = {
     readonly resources: ResourceStore;
     /** Only slots explicitly declared by this configured Endpoint instance are present. */
     readonly credentials: Readonly<Record<string, EndpointCredential>>;
+    /** Explicit non-secret diagnostic output. The Provider owns its content, never its storage. */
+    readonly reportDiagnostic?: (diagnostic: ExecutionDiagnostic) => Promise<void>;
+    /** Report non-secret activity of a long local call without creating a remote Operation. */
+    readonly reportProgress?: (progress: OperationProgress) => Promise<void>;
 };
 type ImmediateEndpointHandler = (context: EndpointInvocationContext) => Awaitable<EndpointFulfillment>;
 type EndpointCheckpoint = {
@@ -362,5 +384,5 @@ declare function wakeAfter(handle: CanonicalValue, delayMs: number, now?: number
     readonly progress?: OperationProgress;
 };
 
-export { actionResourceClaims, defineEndpointPackage, endpointActions, endpointResourceClaims, verifyEndpointPricingDocument, wakeAfter };
-export type { AsyncEndpoint, AsyncEndpointCapability, Awaitable, CanonicalValue, CapabilityRef, CapacityResourceClaim, CredentialAcquisition, CredentialRef, CredentialValue, DefineEndpointPackageOptions, EndpointAction, EndpointActionLimits, EndpointCancelOutcome, EndpointCapability, EndpointCheckpoint, EndpointCredential, EndpointCredentialDescription, EndpointFulfillment, EndpointInputSlot, EndpointInvocationContext, EndpointOffer, EndpointOutcome, EndpointPackage, EndpointPollContext, EndpointPricing, EndpointPricingDocument, EndpointPricingReader, EndpointPricingReaderContext, EndpointRegistrar, EndpointRegistrationOptions, EndpointRequest, EndpointScheduling, EndpointStartContext, EndpointSupport, ImmediateEndpointCapability, ImmediateEndpointHandler, ModuleRef, OperationFailure, OperationProgress, OperationReceipt, ResourceIOOptions, ResourceStore, StoredValue, TypeRef };
+export { actionResourceClaims, canonicalize, credentialRef, defineEndpointPackage, endpointActions, endpointResourceClaims, isStreamingResourceStore, verifyEndpointPricingDocument, wakeAfter };
+export type { AsyncEndpoint, AsyncEndpointCapability, Awaitable, BlobRef, CanonicalValue, CapabilityRef, CapacityResourceClaim, CredentialAcquisition, CredentialRef, CredentialValue, DefineEndpointPackageOptions, EndpointAction, EndpointActionLimits, EndpointCancelOutcome, EndpointCapability, EndpointCheckpoint, EndpointCredential, EndpointCredentialDescription, EndpointFulfillment, EndpointInputSlot, EndpointInvocationContext, EndpointOffer, EndpointOutcome, EndpointPackage, EndpointPollContext, EndpointPricing, EndpointPricingDocument, EndpointPricingReader, EndpointPricingReaderContext, EndpointRegistrar, EndpointRegistrationOptions, EndpointRequest, EndpointScheduling, EndpointStartContext, EndpointSupport, ImmediateEndpointCapability, ImmediateEndpointHandler, ModuleRef, OperationFailure, OperationProgress, OperationReceipt, ResourceIOOptions, ResourceId, ResourceStore, StoredValue, TypeRef };