@hypit/hypit 0.1.4 → 0.1.6

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,
@@ -253,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);
@@ -370,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 {
@@ -463,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[] = [];
@@ -562,7 +558,7 @@ export function renderColumn(space: ProgramSpace, program: ColumnProgram): Visua
       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 {
@@ -580,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({
@@ -652,33 +648,33 @@ export function renderTopThree(space: ProgramSpace, program: TopThreeProgram): V
       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,
@@ -694,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.");
   }
 }
 

package/packages/ranking/src/surface.ts

@@ -1,4 +1,4 @@
-import { createTemporalSpace, resolveTemporalContext } from "@hypit/temporal-markup";
+import { resolveTemporalContext } from "@hypit/temporal-markup";
 import {
   assertEmptyElement as empty,
   assertAttributes as allowed,
@@ -199,7 +199,7 @@ const variantDefinition = {
 
 function rankingSurface(variant: RankingVariant): StructuredSurfaceHandler {
   return ({ element, resolveReference }) => {
-    const common = ["id", "semantic", "space", "frame", "during", "terminal", "style", "appear-sound", "move-sound"];
+    const common = ["id", "timeline", "frame", "during", "terminal", "style", "appear-sound", "move-sound"];
     const attributes = variant === "column" || variant === "tier-board"
       ? [...common.filter((name) => name !== "terminal"), "canvas"]
       : common;
@@ -207,31 +207,30 @@ function rankingSurface(variant: RankingVariant): StructuredSurfaceHandler {
     const id = text(element, "id");
     const selected = variantDefinition[variant];
     const context = resolveTemporalContext({ element, resolveReference });
-    const time = createTemporalSpace({ id, element, ...context });
     const canvas = variant === "column" || variant === "tier-board"
       ? reference(element.attributes.canvas, `${element.name}.canvas`, spatialTypes.canvas, resolveReference)
       : undefined;
     const frame = reference(element.attributes.frame, `${element.name}.frame`, spatialTypes.frame, resolveReference);
-    const outerTemporal = createTemporalWindowProjection({ id: `${id}.outer`, subjectId: id, element, ...context, space: time.space, resolveReference });
+    const outerTemporal = createTemporalWindowProjection({ id: `${id}.outer`, subjectId: id, element, ...context, resolveReference });
     const terminalTemporal = variant === "top-three"
       ? createTemporalInstantProjection({
-          id: `${id}.terminal`, subjectId: id, element, ...context, space: time.space, resolveReference,
+          id: `${id}.terminal`, subjectId: id, element, ...context, resolveReference,
           semanticAttribute: "terminal", projectedAttribute: false,
         })
       : undefined;
     const styleRaw = element.attributes.style;
     const style = reference(styleRaw, `${element.name}.style`, selected.style, resolveReference);
     const records: SurfaceRecordDraft[] = [...outerTemporal.records, ...(terminalTemporal?.records ?? [])];
-    const temporalComponents: SurfaceComponentDraft[] = [...time.components, ...outerTemporal.components, ...(terminalTemporal?.components ?? [])];
-    const temporalFragments = [...time.fragments, ...outerTemporal.fragments, ...(terminalTemporal?.fragments ?? [])];
+    const temporalComponents: SurfaceComponentDraft[] = [...outerTemporal.components, ...(terminalTemporal?.components ?? [])];
+    const temporalFragments = [...outerTemporal.fragments, ...(terminalTemporal?.fragments ?? [])];
     const headerId = `${id}.header`;
     records.push({
       id: headerId, type: rankingTypes.header,
       value: { kind: "inline", value: sealRankingHeader({ id, variant }) as unknown as CanonicalValue },
       range: element.range,
     });
-    const inputs: Record<string, typeof time.space.ref> = {
-      header: { kind: "record", id: headerId }, space: time.space.ref, frame: frame.ref,
+    const inputs: Record<string, typeof context.timeline.ref> = {
+      header: { kind: "record", id: headerId }, timeline: context.timeline.ref, frame: frame.ref,
       outer: outerTemporal.ref, style: style.ref,
       ...(canvas === undefined ? {} : { canvas: canvas.ref }),
       ...(terminalTemporal === undefined ? {} : { terminal: terminalTemporal.ref }),
@@ -260,8 +259,8 @@ function rankingSurface(variant: RankingVariant): StructuredSurfaceHandler {
       const contentName = authored.content === undefined ? undefined : `item-${suffix}-content`;
       if (authored.content !== undefined) inputs[contentName!] = authored.content.ref;
       const itemTemporal = !authored.timed ? undefined : variant === "top-three"
-        ? createTemporalInstantProjection({ id: `${id}.item.${suffix}`, subjectId: spec.id, element: child, ...context, space: time.space, resolveReference })
-        : createTemporalWindowProjection({ id: `${id}.item.${suffix}`, subjectId: spec.id, element: child, ...context, space: time.space, resolveReference });
+        ? createTemporalInstantProjection({ id: `${id}.item.${suffix}`, subjectId: spec.id, element: child, ...context, resolveReference })
+        : createTemporalWindowProjection({ id: `${id}.item.${suffix}`, subjectId: spec.id, element: child, ...context, resolveReference });
       if (itemTemporal !== undefined) {
         records.push(...itemTemporal.records);
         temporalComponents.push(...itemTemporal.components);
@@ -307,12 +306,12 @@ function rankingSurface(variant: RankingVariant): StructuredSurfaceHandler {
         id, fragment: fragment.id, inputs,
         outputs: {
           schedule: `${id}.schedule`, program: `${id}.program`, visual: `${id}.visual`,
-          ...(sound.appearName === undefined && sound.moveName === undefined ? {} : { audio: `${id}.audio` }),
+          ...(sound.appearName === undefined && sound.moveName === undefined ? {} : { events: `${id}.events`, audio: `${id}.audio` }),
         },
         range: element.range,
       }],
       fragments: [...temporalFragments, fragment],
-      exports: [`${id}.schedule`, `${id}.program`, `${id}.visual`, ...(sound.appearName === undefined && sound.moveName === undefined ? [] : [`${id}.audio`])],
+      exports: [`${id}.schedule`, `${id}.program`, `${id}.visual`, ...(sound.appearName === undefined && sound.moveName === undefined ? [] : [`${id}.events`, `${id}.audio`])],
     };
   };
 }