@hypit/hypit 0.1.3 → 0.1.5

package/packages/ranking/README.md

@@ -1,7 +1,7 @@
 # `@hypit/ranking`
 
-The Track Surface accepts `semantic={speech.semantic}` or `space={animation}`. Semantic context
-resolves Script Selections and Moments; authored space supports clock-based animation. Shared `at`
+The Track Surface accepts `timeline={program.timeline}`. The same Timeline supports authored
+positions and, where prepared Takes supply evidence, Script Selections and Moments. Shared `at`
 inputs accept a Moment or a time such as `2s`; `at` with `for` produces a Window where required.
 
 Ranking boards that follow the argument of a video: introduce an item, give its verdict, and retain
@@ -20,12 +20,12 @@ where the selected schedule requires succession. Ending a reveal does not remove
 
 ## Bind the ranking to the target Script
 
-This excerpt assumes the Script, SemanticTrack, Canvas, Frame and Style have been declared:
+This excerpt assumes the Script, Timeline, Canvas, Frame and Style have been declared:
 
 ```svml
 <import as="ranking" from="@hypit/ranking@1"/>
 
-<ranking:Column id="priorities" semantic={speech.semantic} canvas={vertical}
+<ranking:Column id="priorities" timeline={speech.timeline} canvas={vertical}
   frame={layout.ranking} during={story.segment.ranking} style={ranking-style}>
   <ranking:ColumnItem rank="1" label="Winner" during={story.selection.winner}/>
   <ranking:ColumnItem rank="2" preset="true" label="Already placed"/>
@@ -38,7 +38,9 @@ Window. TopThree instead accepts item `at` projections and a board `terminal` pr
 can supply the intended trigger.
 
 Each board publishes `.schedule`, `.program` and `.visual`. Optional normalized `appear-sound` or
-`move-sound` inputs add `.audio` where that form supports them. Include the wanted visual and audio
+`move-sound` inputs add `.events` and `.audio` where that form supports them.
+The event plan drives the audio from the same appearance and movement timing
+as the visual animation. Include the wanted visual and audio
 outputs as peers in Film. Labels can be literal or graph Text; Styles are typed SVS Recipes with
 exact fonts. Use `hypit vocabulary @hypit/ranking --tag Column` (or another declared tag) for its
 attributes, children, outputs and configured example.
@@ -50,7 +52,7 @@ The following files are included in the Distribution and show how the responsibi
 | File | What to learn from it |
 | --- | --- |
 | [surface.ts](src/surface.ts) | `rankingSurface` resolves author inputs, projects the outer and item times through `createTemporalWindowProjection` / `createTemporalInstantProjection`, and retains the returned drafts and references. |
-| [fragment.ts](src/fragment.ts) | `createRankingFragment` receives ProgramSpace and wires typed content, time, layout and Style inputs into finite operations. |
+| [fragment.ts](src/fragment.ts) | `createRankingFragment` receives Timeline and wires typed content, time, layout and Style inputs into finite operations. |
 | [schedule.ts](src/schedule.ts) | Compute reveal, activation and settled spans from the projected times. |
 | [component.ts](src/component.ts) and [render.ts](src/render.ts) | Build the ranking program and produce picture and optional sound from that schedule. |
 | [manifest.ts](src/manifest.ts) and [activation.ts](src/activation.ts) | Publish Types, Producers, Surface vocabulary and package contributions. |

package/packages/ranking/package.json

@@ -19,7 +19,7 @@
     "@hypit/narrative": "workspace:*",
     "@hypit/program-space": "workspace:*",
     "@hypit/protocol": "workspace:*",
-    "@hypit/semantic-track": "workspace:*",
+    "@hypit/timeline": "workspace:*",
     "@hypit/spatial": "workspace:*",
     "@hypit/svs": "workspace:*",
     "@hypit/temporal": "workspace:*",

package/packages/ranking/src/component.ts

@@ -1,6 +1,6 @@
+import type { Timeline } from "@hypit/timeline";
 import type { ComponentPackage, ProducerHandlerContext } from "@hypit/component-kit";
 import type { SynchronizedMedia } from "@hypit/media";
-import type { ProgramSpace } from "@hypit/program-space";
 import { canonicalize } from "@hypit/protocol";
 import type { BlobRef, StoredValue } from "@hypit/protocol";
 import type { TemporalInstant, TemporalWindow } from "@hypit/temporal";
@@ -96,7 +96,7 @@ export const rankingComponent = {
       producer: rankingProducers.schedule,
       handler: ({ inputs }) => ({ outputs: { schedule: output(buildTriggeredRankingSchedule({
         header: inline(inputs.header?.value, "RankingHeader"), items: inline(inputs.items?.value, "RankingItemSpecSet"),
-        space: inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),
+        timeline: inline<Timeline>(inputs.timeline?.value, "Timeline"),
         outer: inline<TemporalWindow>(inputs.outer?.value, "TemporalWindow"),
         candidates: inline(inputs.candidates?.value, "TriggeredRankingCandidateSet"),
         terminal: inline<TemporalInstant>(inputs.terminal?.value, "TemporalInstant"),
@@ -119,7 +119,7 @@ export const rankingComponent = {
       handler: ({ inputs }) => ({ outputs: { schedule: output(buildTierBoardSchedule({
         header: inline<RankingHeader>(inputs.header?.value, "RankingHeader"),
         items: inline<RankingItemSpecSet>(inputs.items?.value, "RankingItemSpecSet"),
-        space: inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),
+        timeline: inline<Timeline>(inputs.timeline?.value, "Timeline"),
         outer: inline<TemporalWindow>(inputs.outer?.value, "TemporalWindow"),
         windows: inline<TierBoardWindowSet>(inputs.windows?.value, "TierBoardWindowSet"),
       })) }, needs: {} }),
@@ -141,7 +141,7 @@ export const rankingComponent = {
       handler: ({ inputs }) => ({ outputs: { schedule: output(buildColumnSchedule({
         header: inline<RankingHeader>(inputs.header?.value, "RankingHeader"),
         items: inline<RankingItemSpecSet>(inputs.items?.value, "RankingItemSpecSet"),
-        space: inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),
+        timeline: inline<Timeline>(inputs.timeline?.value, "Timeline"),
         outer: inline<TemporalWindow>(inputs.outer?.value, "TemporalWindow"),
         windows: inline<ColumnWindowSet>(inputs.windows?.value, "ColumnWindowSet"),
       })) }, needs: {} }),
@@ -239,7 +239,7 @@ export const rankingComponent = {
     {
       producer: rankingProducers.renderAudio,
       handler: ({ inputs }) => ({ outputs: { track: output(renderRankingAudio(
-        inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),
+        inline<Timeline>(inputs.timeline?.value, "Timeline"),
         inline<RankingSoundEventPlan>(inputs.events?.value, "RankingSoundEventPlan"),
         inline<RankingSoundStyle>(inputs.style?.value, "RankingSoundStyle"),
         inline<RankingSoundSet>(inputs.sounds?.value, "RankingSoundSet"),
@@ -252,7 +252,7 @@ export const rankingComponent = {
     ] as const).map(([producer, render, label]) => ({
       producer,
       handler: ({ inputs }: ProducerHandlerContext) => ({ outputs: { track: output(render(
-        inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"), inline(inputs.program?.value, label) as never,
+        inline<Timeline>(inputs.timeline?.value, "Timeline"), inline(inputs.program?.value, label) as never,
       )) }, needs: {} }),
     })),
   ],

package/packages/ranking/src/fragment.ts

@@ -1,4 +1,5 @@
-import { programSpaceTypes } from "@hypit/program-space";
+import { timelineTypes } from "@hypit/timeline";
+
 import { compositionTypes } from "@hypit/composition";
 import { sealGraphFragment } from "@hypit/elaborator";
 import type { FragmentOperation, GraphFragment } from "@hypit/elaborator";
@@ -56,7 +57,7 @@ export function createRankingFragment(
   const selected = definition(variant);
   const inputs: Array<GraphFragment["inputs"][number]> = [
     { name: "header", type: rankingTypes.header },
-    { name: "space", type: programSpaceTypes.programSpace },
+    { name: "timeline", type: timelineTypes.track },
     { name: "outer", type: temporalTypes.window },
     ...(variant === "top-three" ? [
       { name: "terminal", type: temporalTypes.instant },
@@ -133,7 +134,7 @@ export function createRankingFragment(
     operations.push({
       id: "schedule",
       producer: variant === "column" ? rankingProducers.columnSchedule : rankingProducers.tierSchedule,
-      inputs: { header: input("header"), items: specs, space: input("space"), outer: input("outer"), windows: candidates },
+      inputs: { header: input("header"), items: specs, timeline: input("timeline"), outer: input("outer"), windows: candidates },
       result: { kind: "output", name: "schedule" },
     });
   } else {
@@ -141,7 +142,7 @@ export function createRankingFragment(
     id: "schedule",
     producer: rankingProducers.schedule,
     inputs: {
-      header: input("header"), items: specs, space: input("space"),
+      header: input("header"), items: specs, timeline: input("timeline"),
         outer: input("outer"), candidates, terminal: input("terminal"),
     },
     result: { kind: "output", name: "schedule" },
@@ -160,7 +161,7 @@ export function createRankingFragment(
   operations.push({
     id: "visual",
     producer: selected.render,
-    inputs: { space: input("space"), program: operation("program") },
+    inputs: { timeline: input("timeline"), program: operation("program") },
     result: { kind: "output", name: "track" },
   });
   const hasAudio = sound.appearName !== undefined || sound.moveName !== undefined;
@@ -189,7 +190,7 @@ export function createRankingFragment(
     }
     operations.push({
       id: "audio", producer: rankingProducers.renderAudio,
-      inputs: { space: input("space"), events: operation("events"), style: input("sound-style"), sounds },
+      inputs: { timeline: input("timeline"), events: operation("events"), style: input("sound-style"), sounds },
       result: { kind: "output", name: "track" },
     });
   }
@@ -200,7 +201,10 @@ export function createRankingFragment(
       { name: "schedule", type: rankingTypes.schedule, root: operation("schedule") },
       { name: "program", type: selected.program, root: operation("program") },
       { name: "visual", type: compositionTypes.visualTrack, root: operation("visual") },
-      ...(hasAudio ? [{ name: "audio", type: compositionTypes.audioTrack, root: operation("audio") }] : []),
+      ...(hasAudio ? [
+        { name: "events", type: rankingTypes.soundEvents, root: operation("events") },
+        { name: "audio", type: compositionTypes.audioTrack, root: operation("audio") },
+      ] : []),
     ],
   });
 }

package/packages/ranking/src/manifest.ts

@@ -1,3 +1,4 @@
+import { timelineTypes } from "@hypit/timeline";
 import { temporalContextAttributeVocabulary } from "@hypit/temporal-markup";
 import { readFile } from "node:fs/promises";
 
@@ -5,9 +6,9 @@ import { artifactDependency } from "@hypit/artifact";
 import { compositionDependency, compositionTypes } from "@hypit/composition";
 import { mediaDependency, mediaTypes } from "@hypit/media";
 import { narrativeDependency, narrativeTypes } from "@hypit/narrative";
-import { programSpaceDependency, programSpaceTypes } from "@hypit/program-space";
+
 import type { ModuleManifest, ProducerRef, TypeRef, ValueSchema } from "@hypit/protocol";
-import { semanticTrackDependency } from "@hypit/semantic-track";
+import { timelineDependency } from "@hypit/timeline";
 import { spatialDependency, spatialFrameSchema, spatialTypes } from "@hypit/spatial";
 import { svsRecipeType } from "@hypit/svs";
 import { temporalDependency, temporalInstantSchema, temporalTypes, temporalWindowSchema } from "@hypit/temporal";
@@ -487,7 +488,7 @@ const allRankingMarkupSurfaces = [
           "Every other property is refused by name.",
         ],
       } },
-    { name: "tier", tag: "TierBoard", mode: "structured", outputs: [rankingTypes.header, rankingTypes.itemSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, rankingTypes.schedule, rankingTypes.tierProgram, compositionTypes.visualTrack, compositionTypes.audioTrack],
+    { name: "tier", tag: "TierBoard", mode: "structured", outputs: [rankingTypes.header, rankingTypes.itemSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, rankingTypes.schedule, rankingTypes.tierProgram, compositionTypes.visualTrack, rankingTypes.soundEvents, compositionTypes.audioTrack],
       vocabulary: {
         summary: "Places Items into tier rows from preset state or explicit reveal Selections, and publishes the board and the Tracks it renders to.",
         appearance:
@@ -537,11 +538,13 @@ const allRankingMarkupSurfaces = [
             summary: "The resolved board: its Frame, Style, Schedule and ordered Items." },
           { name: "visual", type: compositionTypes.visualTrack,
             summary: "The rendered board, an ordinary peer VisualTrack." },
+          { name: "events", type: rankingTypes.soundEvents,
+            summary: "Animation-linked sound events, published when a sound is authored." },
           { name: "audio", type: compositionTypes.audioTrack,
             summary: "The rendered board sound, published only when a sound is authored." },
         ],
         example: `<ranking:TierBoardStyle id="tier-style" recipe={recipes.ranking.tier} font={ui-font}/>
-<ranking:TierBoard id="tiers" semantic={speech.semantic} canvas={vertical} frame={board-frame}
+<ranking:TierBoard id="tiers" timeline={speech.timeline} canvas={vertical} frame={board-frame}
   during="program"
   style={tier-style}>
   <ranking:TierItem id="row-regen" tier="s" preset="true" icon={icon-regen}/>
@@ -555,7 +558,7 @@ const allRankingMarkupSurfaces = [
           "Authoring either sound also connects the Style's `.sound` output, so `style` must name a TierBoardStyle written in this Source.",
         ],
       } },
-    { name: "column", tag: "Column", mode: "structured", outputs: [rankingTypes.header, rankingTypes.itemSpec, rankingTypes.textItemShell, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, rankingTypes.schedule, rankingTypes.columnProgram, compositionTypes.visualTrack, compositionTypes.audioTrack],
+    { name: "column", tag: "Column", mode: "structured", outputs: [rankingTypes.header, rankingTypes.itemSpec, rankingTypes.textItemShell, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, rankingTypes.schedule, rankingTypes.columnProgram, compositionTypes.visualTrack, rankingTypes.soundEvents, compositionTypes.audioTrack],
       vocabulary: {
         summary: "Places rows by explicit rank, reveals each non-preset row in its own Segment or Selection, and publishes the board and the Tracks it renders to.",
         appearance:
@@ -605,11 +608,13 @@ const allRankingMarkupSurfaces = [
             summary: "The resolved board: its Frame, Style, Schedule and ordered Items." },
           { name: "visual", type: compositionTypes.visualTrack,
             summary: "The rendered board, an ordinary peer VisualTrack." },
+          { name: "events", type: rankingTypes.soundEvents,
+            summary: "Animation-linked sound events, published when a sound is authored." },
           { name: "audio", type: compositionTypes.audioTrack,
             summary: "The rendered board sound, published only when a sound is authored." },
         ],
         example: `<ranking:ColumnStyle id="board-style" recipe={recipes.ranking.board} font={ui-font}/>
-<ranking:Column id="board" semantic={speech.semantic} canvas={vertical} frame={board-frame}
+<ranking:Column id="board" timeline={speech.timeline} canvas={vertical} frame={board-frame}
   during={story.segment.ranking}
   style={board-style}>
   <ranking:ColumnItem id="row-regen" rank="1" label="ReGen" icon={icon-regen} during={story.selection.regen}/>
@@ -624,7 +629,7 @@ const allRankingMarkupSurfaces = [
           "Authoring either sound also connects the Style's `.sound` output, so `style` must name a ColumnStyle written in this Source.",
         ],
       } },
-    { name: "top-three", tag: "TopThree", mode: "structured", outputs: [rankingTypes.header, rankingTypes.itemSpec, rankingTypes.textItemShell, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, rankingTypes.schedule, rankingTypes.topThreeProgram, compositionTypes.visualTrack, compositionTypes.audioTrack],
+    { name: "top-three", tag: "TopThree", mode: "structured", outputs: [rankingTypes.header, rankingTypes.itemSpec, rankingTypes.textItemShell, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, rankingTypes.schedule, rankingTypes.topThreeProgram, compositionTypes.visualTrack, rankingTypes.soundEvents, compositionTypes.audioTrack],
       vocabulary: {
         summary: "Fills a podium one slot at a time at the Moment owned by each Item, and publishes the board and the Tracks it renders to.",
         appearance:
@@ -667,11 +672,13 @@ const allRankingMarkupSurfaces = [
             summary: "The resolved board: its Frame, Style, Schedule and ordered Items." },
           { name: "visual", type: compositionTypes.visualTrack,
             summary: "The rendered board, an ordinary peer VisualTrack." },
+          { name: "events", type: rankingTypes.soundEvents,
+            summary: "Animation-linked sound events, published when a sound is authored." },
           { name: "audio", type: compositionTypes.audioTrack,
             summary: "The rendered board sound, published only when a sound is authored." },
         ],
         example: `<ranking:TopThreeStyle id="podium-style" recipe={recipes.ranking.podium} font={ui-font}/>
-<ranking:TopThree id="podium" semantic={speech.semantic} frame={board-frame}
+<ranking:TopThree id="podium" timeline={speech.timeline} frame={board-frame}
   during={story.selection.board} terminal={story.moment.done}
   style={podium-style}>
   <ranking:TopThreeItem id="slot-gold" label="ReGen" icon={icon-regen} at={story.moment.regen}/>
@@ -692,7 +699,7 @@ export const rankingMarkupSurfaces = allRankingMarkupSurfaces;
 
 export const rankingManifest: ModuleManifest = {
   format: "hypit.module@1", name: rankingModuleRef.name, version: rankingModuleRef.version,
-  dependencies: [artifactDependency, mediaDependency, narrativeDependency, programSpaceDependency, semanticTrackDependency, spatialDependency, temporalDependency, compositionDependency, textDependency],
+  dependencies: [artifactDependency, mediaDependency, narrativeDependency, timelineDependency, spatialDependency, temporalDependency, compositionDependency, textDependency],
   types: [
     { name: rankingTypes.header.name },
     { name: rankingTypes.itemSpec.name },
@@ -729,7 +736,7 @@ export const rankingManifest: ModuleManifest = {
     ], outputs: [{ name: "set", type: rankingTypes.triggeredCandidates }], needs: [] },
     { name: rankingProducers.schedule.name, inputs: [
       { name: "header", type: rankingTypes.header }, { name: "items", type: rankingTypes.itemSpecs },
-      { name: "space", type: programSpaceTypes.programSpace },
+      { name: "timeline", type: timelineTypes.track },
       { name: "outer", type: temporalTypes.window }, { name: "candidates", type: rankingTypes.triggeredCandidates },
       { name: "terminal", type: temporalTypes.instant },
     ], outputs: [{ name: "schedule", type: rankingTypes.schedule }], needs: [] },
@@ -742,7 +749,7 @@ export const rankingManifest: ModuleManifest = {
     ], outputs: [{ name: "set", type: rankingTypes.tierWindows }], needs: [] },
     { name: rankingProducers.tierSchedule.name, inputs: [
       { name: "header", type: rankingTypes.header }, { name: "items", type: rankingTypes.itemSpecs },
-      { name: "space", type: programSpaceTypes.programSpace },
+      { name: "timeline", type: timelineTypes.track },
       { name: "outer", type: temporalTypes.window }, { name: "windows", type: rankingTypes.tierWindows },
     ], outputs: [{ name: "schedule", type: rankingTypes.schedule }], needs: [] },
     { name: rankingProducers.createColumnWindows.name, inputs: [], outputs: [
@@ -754,7 +761,7 @@ export const rankingManifest: ModuleManifest = {
     ], outputs: [{ name: "set", type: rankingTypes.columnWindows }], needs: [] },
     { name: rankingProducers.columnSchedule.name, inputs: [
       { name: "header", type: rankingTypes.header }, { name: "items", type: rankingTypes.itemSpecs },
-      { name: "space", type: programSpaceTypes.programSpace },
+      { name: "timeline", type: timelineTypes.track },
       { name: "outer", type: temporalTypes.window }, { name: "windows", type: rankingTypes.columnWindows },
     ], outputs: [{ name: "schedule", type: rankingTypes.schedule }], needs: [] },
     ...([
@@ -788,7 +795,7 @@ export const rankingManifest: ModuleManifest = {
       { name: eventProducer.name, inputs: [
         { name: "schedule", type: rankingTypes.schedule }, { name: "style", type: styleType }, { name: "specs", type: rankingTypes.itemSpecs },
       ], outputs: [{ name: "events", type: rankingTypes.soundEvents }], needs: [] },
-      { name: renderProducer.name, inputs: [{ name: "space", type: programSpaceTypes.programSpace }, { name: "program", type: programType }], outputs: [{ name: "track", type: compositionTypes.visualTrack }], needs: [] },
+      { name: renderProducer.name, inputs: [{ name: "timeline", type: timelineTypes.track }, { name: "program", type: programType }], outputs: [{ name: "track", type: compositionTypes.visualTrack }], needs: [] },
     ]),
     { name: rankingProducers.createSounds.name, inputs: [], outputs: [{ name: "sounds", type: rankingTypes.sounds }], needs: [] },
     ...([
@@ -798,7 +805,7 @@ export const rankingManifest: ModuleManifest = {
       name: producer.name, inputs: [{ name: "sounds", type: rankingTypes.sounds }, { name: "media", type: mediaTypes.synchronized }], outputs: [{ name: "sounds", type: rankingTypes.sounds }], needs: [],
     })),
     { name: rankingProducers.renderAudio.name, inputs: [
-      { name: "space", type: programSpaceTypes.programSpace }, { name: "events", type: rankingTypes.soundEvents },
+      { name: "timeline", type: timelineTypes.track }, { name: "events", type: rankingTypes.soundEvents },
       { name: "style", type: rankingTypes.soundStyle }, { name: "sounds", type: rankingTypes.sounds },
     ], outputs: [{ name: "track", type: compositionTypes.audioTrack }], needs: [] },
   ],

package/packages/ranking/src/render.ts

@@ -1,3 +1,4 @@
+import type { Timeline } from "@hypit/timeline";
 import {
   assertAudioTrackIdentity,
   assertVisualTrackIdentity,
@@ -14,12 +15,7 @@ import type {
   VisualTrack,
 } from "@hypit/composition";
 import { synchronizedMediaSampleFrames, verifySynchronizedMedia } from "@hypit/media";
-import {
-  assertProgramSpaceIdentity,
-  programFrameSampleBoundary,
-  programSpaceSampleFrames,
-} from "@hypit/program-space";
-import type { ProgramSpace } from "@hypit/program-space";
+import { assertProgramSpaceIdentity, programFrameSampleBoundary, programSpaceSampleFrames } from "@hypit/program-space";
 
 import {
   assertColumnProgram,
@@ -183,6 +179,7 @@ function iconElement(input: {
 
 function present(input: {
   readonly id: string;
+  readonly subjectId: string;
   readonly start: number;
   readonly end: number;
   readonly stacking: number;
@@ -191,6 +188,7 @@ function present(input: {
 }): VisualPresent {
   return {
     id: input.id,
+    subjectId: input.subjectId,
     span: { startFrame: input.start, endFrameExclusive: input.end },
     stacking: { order: input.stacking, tieBreak: input.tieBreak },
     elements: input.elements,
@@ -251,14 +249,14 @@ function tierItemAnimation(
   })));
 }
 
-function sealTrack(space: ProgramSpace, id: string, presents: readonly VisualPresent[]): VisualTrack {
-  const value = sealVisualTrack({ programSpaceId: space.id, visualIr: "hypit.visual-ir@1", id, presents });
-  assertVisualTrackIdentity(value, space);
+function sealTrack(timeline: Timeline, id: string, presents: readonly VisualPresent[]): VisualTrack {
+  const value = sealVisualTrack({ programSpaceId: timeline.id, visualIr: "hypit.visual-ir@1", id, presents });
+  assertVisualTrackIdentity(value, timeline);
   return value;
 }
 
-export function renderTierBoard(space: ProgramSpace, program: TierBoardProgram): VisualTrack {
-  assertProgramSpaceIdentity(space);
+export function renderTierBoard(timeline: Timeline, program: TierBoardProgram): VisualTrack {
+  assertProgramSpaceIdentity(timeline);
   assertTierBoardProgram(program);
   const { canvas, frame, style, schedule } = program;
   const geometry = tierBoardGeometry(frame.widthPx, frame.heightPx, style);
@@ -307,7 +305,7 @@ export function renderTierBoard(space: ProgramSpace, program: TierBoardProgram):
     }));
   }
   presents.push(present({
-    id: `${program.id}:board`, start: schedule.outer.startFrame, end: schedule.outer.endFrameExclusive,
+    id: `${program.id}:board`, subjectId: program.id, start: schedule.outer.startFrame, end: schedule.outer.endFrameExclusive,
     stacking: style.boardStackingOrder, tieBreak: `${program.id}:0000:board`, elements: boardElements,
   }));
   const entries = new Map(schedule.entries.map((entry) => [entry.itemId, entry]));
@@ -351,7 +349,7 @@ export function renderTierBoard(space: ProgramSpace, program: TierBoardProgram):
         : (localFrame) => fromHighTierItemPose(
             localFrame, duration, stage, absoluteCell, style.motion.appearFrames, style.motion.moveFrames));
       presents.push(present({
-        id: `${program.id}:item:${item.id}:reveal`,
+        id: `${program.id}:item:${item.id}:reveal`, subjectId: item.id,
         start: entry.window.startFrame,
         end: entry.window.endFrameExclusive,
         stacking: item.stackingOrder ?? (item.entry === "drop" ? style.stageStackingOrder : style.itemStackingOrder),
@@ -360,7 +358,7 @@ export function renderTierBoard(space: ProgramSpace, program: TierBoardProgram):
       }));
     }
     if (entry.settled.endFrameExclusive > entry.settled.startFrame) presents.push(present({
-      id: `${program.id}:item:${item.id}:settled`,
+      id: `${program.id}:item:${item.id}:settled`, subjectId: item.id,
       start: entry.settled.startFrame,
       end: entry.settled.endFrameExclusive,
       stacking: item.stackingOrder ?? style.itemStackingOrder,
@@ -368,7 +366,7 @@ export function renderTierBoard(space: ProgramSpace, program: TierBoardProgram):
       elements: itemElements(),
     }));
   }
-  return sealTrack(space, program.id, presents);
+  return sealTrack(timeline, program.id, presents);
 }
 
 function rowY(frameY: number, frameHeight: number, padding: number, count: number, index: number, height: number, gap: number): number {
@@ -461,8 +459,8 @@ function columnRevealAnimation(input: {
   ]);
 }
 
-export function renderColumn(space: ProgramSpace, program: ColumnProgram): VisualTrack {
-  assertProgramSpaceIdentity(space);
+export function renderColumn(timeline: Timeline, program: ColumnProgram): VisualTrack {
+  assertProgramSpaceIdentity(timeline);
   assertColumnProgram(program);
   const { canvas, frame, style, schedule } = program;
   const presents: VisualPresent[] = [];
@@ -506,7 +504,7 @@ export function renderColumn(space: ProgramSpace, program: ColumnProgram): Visua
       ],
     }));
   }
-  presents.push(present({ id: `${program.id}:board`, start: schedule.outer.startFrame, end: schedule.outer.endFrameExclusive,
+  presents.push(present({ id: `${program.id}:board`, subjectId: program.id, start: schedule.outer.startFrame, end: schedule.outer.endFrameExclusive,
     stacking: style.boardStackingOrder, tieBreak: `${program.id}:0000:board`, elements: boardElements }));
   for (const [index, item] of program.items.entries()) {
     const entry = entries.get(item.id)!;
@@ -549,18 +547,18 @@ export function renderColumn(space: ProgramSpace, program: ColumnProgram): Visua
         stageSize: style.stageSizePx, finalSize: contentSize, easing: style.motion.easing,
       });
       presents.push(present({
-        id: `${program.id}:item:${item.id}:stage`, start: entry.window.startFrame, end: entry.window.endFrameExclusive,
+        id: `${program.id}:item:${item.id}:stage`, subjectId: item.id, start: entry.window.startFrame, end: entry.window.endFrameExclusive,
         stacking: item.stackingOrder ?? style.stageStackingOrder,
         tieBreak: `${program.id}:item:${String(item.rank).padStart(4, "0")}:${item.id}:stage`, elements: itemElements(rootAnimation),
       }));
     }
     if (entry.settled.endFrameExclusive > entry.settled.startFrame) presents.push(present({
-      id: `${program.id}:item:${item.id}:settled`, start: entry.settled.startFrame, end: entry.settled.endFrameExclusive,
+      id: `${program.id}:item:${item.id}:settled`, subjectId: item.id, start: entry.settled.startFrame, end: entry.settled.endFrameExclusive,
       stacking: item.stackingOrder ?? style.itemStackingOrder,
       tieBreak: `${program.id}:item:${String(item.rank).padStart(4, "0")}:${item.id}:settled`, elements: itemElements(),
     }));
   }
-  return sealTrack(space, program.id, presents);
+  return sealTrack(timeline, program.id, presents);
 }
 
 function topSlotX(program: TopThreeProgram, index: number): number {
@@ -578,8 +576,8 @@ function activeAccentAnimation(duration: number, activeFrames: number): VisualAn
   ]);
 }
 
-export function renderTopThree(space: ProgramSpace, program: TopThreeProgram): VisualTrack {
-  assertProgramSpaceIdentity(space);
+export function renderTopThree(timeline: Timeline, program: TopThreeProgram): VisualTrack {
+  assertProgramSpaceIdentity(timeline);
   assertTopThreeProgram(program);
   const { frame, style, schedule } = program;
   const boardElements: VisualElement[] = [absoluteBox({
@@ -599,7 +597,7 @@ export function renderTopThree(space: ProgramSpace, program: TopThreeProgram): V
     }));
   }
   const presents: VisualPresent[] = [present({
-    id: `${program.id}:slots`, start: schedule.outer.startFrame, end: schedule.outer.endFrameExclusive,
+    id: `${program.id}:slots`, subjectId: program.id, start: schedule.outer.startFrame, end: schedule.outer.endFrameExclusive,
     stacking: style.boardStackingOrder, tieBreak: `${program.id}:0000:slots`, elements: boardElements,
   })];
   for (const [index, item] of program.items.entries()) {
@@ -640,43 +638,43 @@ export function renderTopThree(space: ProgramSpace, program: TopThreeProgram): V
       return elements;
     };
     presents.push(present({
-      id: `${program.id}:item:${item.id}:stage`, start: entry.stage.startFrame, end: entry.stage.endFrameExclusive,
+      id: `${program.id}:item:${item.id}:stage`, subjectId: item.id, start: entry.stage.startFrame, end: entry.stage.endFrameExclusive,
       stacking: item.stackingOrder ?? style.itemStackingOrder,
       tieBreak: `${program.id}:item:${String(index).padStart(4, "0")}:${item.id}:stage`, elements: itemElements(true),
     }));
     if (entry.settled.endFrameExclusive > entry.settled.startFrame) presents.push(present({
-      id: `${program.id}:item:${item.id}:settled`, start: entry.settled.startFrame, end: entry.settled.endFrameExclusive,
+      id: `${program.id}:item:${item.id}:settled`, subjectId: item.id, start: entry.settled.startFrame, end: entry.settled.endFrameExclusive,
       stacking: item.stackingOrder ?? style.itemStackingOrder,
       tieBreak: `${program.id}:item:${String(index).padStart(4, "0")}:${item.id}:settled`, elements: itemElements(false),
     }));
   }
-  return sealTrack(space, program.id, presents);
+  return sealTrack(timeline, program.id, presents);
 }
 
 export function renderRankingAudio(
-  space: ProgramSpace,
+  timeline: Timeline,
   plan: RankingSoundEventPlan,
   style: RankingSoundStyle,
   sounds: RankingSoundSet,
 ): AudioTrack {
-  assertProgramSpaceIdentity(space);
+  assertProgramSpaceIdentity(timeline);
   assertRankingSoundEventPlan(plan);
   assertRankingSoundStyle(style);
   assert(sounds.appear !== undefined || sounds.move !== undefined, "Ranking audio requires at least one authored sound.");
   if (sounds.appear !== undefined) verifySynchronizedMedia(sounds.appear);
   if (sounds.move !== undefined) verifySynchronizedMedia(sounds.move);
-  const totalSamples = programSpaceSampleFrames(space, 48_000);
-  const fadeSamples = programFrameSampleBoundary(space, style.fadeFrames, 48_000);
+  const totalSamples = programSpaceSampleFrames(timeline, 48_000);
+  const fadeSamples = programFrameSampleBoundary(timeline, style.fadeFrames, 48_000);
   const clips: AudioClip[] = [];
   for (const event of plan.events) {
     const media = sounds[event.kind];
     if (media === undefined) continue;
     const audio = media.audio;
     assert(audio !== undefined, `Ranking ${event.kind} sound has no normalized audio.`);
-    const startSample = programFrameSampleBoundary(space, event.frame, 48_000);
+    const startSample = programFrameSampleBoundary(timeline, event.frame, 48_000);
     const sourceSampleFrames = synchronizedMediaSampleFrames(media);
     const length = Math.min(sourceSampleFrames, totalSamples - startSample);
-    assert(length > 0, `Ranking sound ${event.id} starts after ProgramSpace.`);
+    assert(length > 0, `Ranking sound ${event.id} starts after Timeline.`);
     assert(fadeSamples <= length, `Ranking sound ${event.id} fade exceeds its audible interval.`);
     clips.push({
       id: event.id,
@@ -692,7 +690,7 @@ export function renderRankingAudio(
     if (sounds[kind] !== undefined) assert(clips.some((clip) => clip.id.endsWith(`:${kind}`)),
       `Ranking ${kind} sound has no matching visual event.`);
   }
-  const track = sealAudioTrack({ programSpaceId: space.id, id: `${plan.id}.audio`, clips });
-  assertAudioTrackIdentity(track, space);
+  const track = sealAudioTrack({ programSpaceId: timeline.id, id: `${plan.id}.audio`, clips });
+  assertAudioTrackIdentity(track, timeline);
   return track;
 }

package/packages/ranking/src/schedule.ts

@@ -1,13 +1,10 @@
+import type { Timeline } from "@hypit/timeline";
 import {
   assertFontArtifactRef,
   verifySynchronizedMedia,
 } from "@hypit/media";
 import type { SynchronizedMedia } from "@hypit/media";
-import {
-  assertProgramSpaceIdentity,
-  programSpaceFrameCount,
-} from "@hypit/program-space";
-import type { ProgramSpace } from "@hypit/program-space";
+import { assertProgramSpaceIdentity, programSpaceFrameCount } from "@hypit/program-space";
 import { canonicalize, isResourceId } from "@hypit/protocol";
 import { verifyText } from "@hypit/text";
 import type { Text } from "@hypit/text";
@@ -334,7 +331,7 @@ export function appendTriggeredRankingCandidate(
 export function buildTriggeredRankingSchedule(input: {
   readonly header: RankingHeader;
   readonly items: RankingItemSpecSet;
-  readonly space: ProgramSpace;
+  readonly timeline: Timeline;
   readonly outer: TemporalWindow;
   readonly candidates: TriggeredRankingCandidateSet;
   readonly terminal: TemporalInstant;
@@ -345,10 +342,10 @@ export function buildTriggeredRankingSchedule(input: {
   assert(input.header.variant === "top-three", "Only TopThree uses the triggered Ranking schedule.");
   assert(input.items.items.length > 0, "Ranking requires at least one Item.");
   assertTriggeredRankingCandidateSet(input.candidates);
-  assertTemporalWindowFor(input.outer, { subjectId: input.header.id, space: input.space });
-  assertTemporalInstantFor(input.terminal, { subjectId: input.header.id, space: input.space });
+  assertTemporalWindowFor(input.outer, { subjectId: input.header.id, space: input.timeline });
+  assertTemporalInstantFor(input.terminal, { subjectId: input.header.id, space: input.timeline });
   for (const candidate of input.candidates.entries) {
-    assertTemporalInstantFor(candidate.activation, { subjectId: candidate.itemId, space: input.space });
+    assertTemporalInstantFor(candidate.activation, { subjectId: candidate.itemId, space: input.timeline });
   }
   const expected = new Set(input.items.items.map((item) => item.id));
   const received = new Set(input.candidates.entries.map((entry) => entry.itemId));
@@ -379,7 +376,7 @@ export function buildTriggeredRankingSchedule(input: {
     terminalFrame: resolved.terminalFrame,
     entries,
   };
-  assertRankingSchedule(result, input.space);
+  assertRankingSchedule(result, input.timeline);
   return canonicalize(result) as unknown as TriggeredRankingSchedule;
 }
 
@@ -448,7 +445,7 @@ export function appendColumnWindow(
 function buildWindowedRankingSchedule(input: {
   readonly header: RankingHeader;
   readonly items: RankingItemSpecSet;
-  readonly space: ProgramSpace;
+  readonly timeline: Timeline;
   readonly outer: TemporalWindow;
   readonly windows: RankingWindowSet;
   readonly variant: "tier-board" | "column";
@@ -460,7 +457,7 @@ function buildWindowedRankingSchedule(input: {
   assert(input.items.variant === input.variant, `${label} Schedule requires ${label} Items.`);
   assert(input.items.items.length > 0, `${label} requires at least one Item.`);
   assertRankingWindowSet(input.windows, `${label}WindowSet`);
-  assertTemporalWindowFor(input.outer, { subjectId: input.header.id, space: input.space });
+  assertTemporalWindowFor(input.outer, { subjectId: input.header.id, space: input.timeline });
   frame(input.outer.span.startFrame, `${label} outer window start`);
   frame(input.outer.span.endFrameExclusive, `${label} outer window end`);
   assert(input.outer.span.endFrameExclusive > input.outer.span.startFrame, `${label} outer window is empty.`);
@@ -474,7 +471,7 @@ function buildWindowedRankingSchedule(input: {
     || left.window.span.endFrameExclusive - right.window.span.endFrameExclusive
     || left.itemId.localeCompare(right.itemId));
   for (const entry of orderedWindows) {
-    assertTemporalWindowFor(entry.window, { subjectId: entry.itemId, space: input.space });
+    assertTemporalWindowFor(entry.window, { subjectId: entry.itemId, space: input.timeline });
     assert(entry.window.span.startFrame >= input.outer.span.startFrame
       && entry.window.span.endFrameExclusive <= input.outer.span.endFrameExclusive,
     `${label} Item ${entry.itemId} window is outside the outer window.`);
@@ -524,7 +521,7 @@ function buildWindowedRankingSchedule(input: {
 export function buildTierBoardSchedule(input: {
   readonly header: RankingHeader;
   readonly items: RankingItemSpecSet;
-  readonly space: ProgramSpace;
+  readonly timeline: Timeline;
   readonly outer: TemporalWindow;
   readonly windows: TierBoardWindowSet;
 }): TierBoardSchedule {
@@ -534,7 +531,7 @@ export function buildTierBoardSchedule(input: {
 export function buildColumnSchedule(input: {
   readonly header: RankingHeader;
   readonly items: RankingItemSpecSet;
-  readonly space: ProgramSpace;
+  readonly timeline: Timeline;
   readonly outer: TemporalWindow;
   readonly windows: ColumnWindowSet;
 }): ColumnSchedule {
@@ -626,12 +623,12 @@ function assertWindowedRankingSchedule(value: TierBoardSchedule | ColumnSchedule
   }
 }
 
-export function assertRankingSchedule(value: RankingSchedule, space?: ProgramSpace): void {
+export function assertRankingSchedule(value: RankingSchedule, timeline?: Timeline): void {
   if (value.variant === "top-three") assertTriggeredRankingSchedule(value);
   else assertWindowedRankingSchedule(value);
-  if (space !== undefined) {
-    assertProgramSpaceIdentity(space);
-    assert(value.outer.endFrameExclusive <= programSpaceFrameCount(space), "RankingSchedule exceeds ProgramSpace.");
+  if (timeline !== undefined) {
+    assertProgramSpaceIdentity(timeline);
+    assert(value.outer.endFrameExclusive <= programSpaceFrameCount(timeline), "RankingSchedule exceeds Timeline.");
   }
 }