@hypit/hypit 0.0.1 → 0.1.1

package/packages/ranking/src/manifest.ts

@@ -0,0 +1,807 @@
+import { temporalContextAttributeVocabulary } from "@hypit/temporal-markup";
+import { readFile } from "node:fs/promises";
+
+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 { spatialDependency, spatialFrameSchema, spatialTypes } from "@hypit/spatial";
+import { svsRecipeType } from "@hypit/svs";
+import { temporalDependency, temporalInstantSchema, temporalTypes, temporalWindowSchema } from "@hypit/temporal";
+import { temporalInstantAttributeVocabulary } from "@hypit/temporal-markup";
+import { textDependency, textTypes } from "@hypit/text";
+
+const previewImage = (file: string, mediaType = "image/png") => ({
+  mediaType,
+  path: `preview/${file}`,
+  open: async () => Uint8Array.from(await readFile(new URL(`../preview/${file}`, import.meta.url))),
+});
+
+export const rankingModuleRef = { name: "@hypit/ranking", version: "1" } as const;
+export const rankingTypes = {
+  header: { module: rankingModuleRef, name: "RankingHeader" },
+  itemSpec: { module: rankingModuleRef, name: "RankingItemSpec" },
+  textItemShell: { module: rankingModuleRef, name: "RankingTextItemShell" },
+  itemSpecs: { module: rankingModuleRef, name: "RankingItemSpecSet" },
+  triggeredCandidates: { module: rankingModuleRef, name: "TriggeredRankingCandidateSet" },
+  tierWindows: { module: rankingModuleRef, name: "TierBoardWindowSet" },
+  columnWindows: { module: rankingModuleRef, name: "ColumnWindowSet" },
+  schedule: { module: rankingModuleRef, name: "RankingSchedule" },
+  soundStyle: { module: rankingModuleRef, name: "RankingSoundStyle" },
+  soundEvents: { module: rankingModuleRef, name: "RankingSoundEventPlan" },
+  sounds: { module: rankingModuleRef, name: "RankingSoundSet" },
+  tierStyle: { module: rankingModuleRef, name: "TierBoardStyle" },
+  columnStyle: { module: rankingModuleRef, name: "ColumnStyle" },
+  topThreeStyle: { module: rankingModuleRef, name: "TopThreeStyle" },
+  tierItems: { module: rankingModuleRef, name: "TierBoardItemSet" },
+  columnItems: { module: rankingModuleRef, name: "ColumnItemSet" },
+  topThreeItems: { module: rankingModuleRef, name: "TopThreeItemSet" },
+  tierProgram: { module: rankingModuleRef, name: "TierBoardProgram" },
+  columnProgram: { module: rankingModuleRef, name: "ColumnProgram" },
+  topThreeProgram: { module: rankingModuleRef, name: "TopThreeProgram" },
+} satisfies Record<string, TypeRef>;
+
+export const rankingProducers = {
+  createSpecs: { module: rankingModuleRef, name: "create-ranking-item-specs" },
+  appendSpec: { module: rankingModuleRef, name: "append-ranking-item-spec" },
+  createTriggeredCandidates: { module: rankingModuleRef, name: "create-triggered-ranking-candidates" },
+  appendTriggeredCandidate: { module: rankingModuleRef, name: "append-triggered-ranking-candidate" },
+  schedule: { module: rankingModuleRef, name: "build-ranking-schedule" },
+  createTierWindows: { module: rankingModuleRef, name: "create-tier-board-windows" },
+  appendTierWindow: { module: rankingModuleRef, name: "append-tier-board-window" },
+  tierSchedule: { module: rankingModuleRef, name: "build-tier-board-schedule" },
+  createColumnWindows: { module: rankingModuleRef, name: "create-column-windows" },
+  appendColumnWindow: { module: rankingModuleRef, name: "append-column-window" },
+  columnSchedule: { module: rankingModuleRef, name: "build-column-schedule" },
+  createTierItems: { module: rankingModuleRef, name: "create-tier-board-items" },
+  appendTierItem: { module: rankingModuleRef, name: "append-tier-board-item" },
+  createColumnItems: { module: rankingModuleRef, name: "create-column-items" },
+  appendColumnItem: { module: rankingModuleRef, name: "append-column-item" },
+  appendColumnIconItem: { module: rankingModuleRef, name: "append-column-icon-item" },
+  createTopThreeItems: { module: rankingModuleRef, name: "create-top-three-items" },
+  appendTopThreeItem: { module: rankingModuleRef, name: "append-top-three-item" },
+  appendTopThreeIconItem: { module: rankingModuleRef, name: "append-top-three-icon-item" },
+  tierProgram: { module: rankingModuleRef, name: "build-tier-board-program" },
+  columnProgram: { module: rankingModuleRef, name: "build-column-program" },
+  topThreeProgram: { module: rankingModuleRef, name: "build-top-three-program" },
+  tierEvents: { module: rankingModuleRef, name: "build-tier-board-sound-events" },
+  columnEvents: { module: rankingModuleRef, name: "build-column-sound-events" },
+  topThreeEvents: { module: rankingModuleRef, name: "build-top-three-sound-events" },
+  createSounds: { module: rankingModuleRef, name: "create-ranking-sounds" },
+  appendAppearSound: { module: rankingModuleRef, name: "append-ranking-appear-sound" },
+  appendMoveSound: { module: rankingModuleRef, name: "append-ranking-move-sound" },
+  renderAudio: { module: rankingModuleRef, name: "render-ranking-audio" },
+  renderTier: { module: rankingModuleRef, name: "render-tier-board" },
+  renderColumn: { module: rankingModuleRef, name: "render-column" },
+  renderTopThree: { module: rankingModuleRef, name: "render-top-three" },
+  materializeTextItem: { module: rankingModuleRef, name: "materialize-text-item" },
+} satisfies Record<string, ProducerRef>;
+
+const string = { kind: "string", minLength: 1 } as const;
+const integer = { kind: "number", integer: true } as const;
+const unsigned = { kind: "number", integer: true, minimum: 0 } as const;
+const object = (fields: Readonly<Record<string, { readonly schema: ValueSchema; readonly optional?: boolean }>>, allowUnknown = false): ValueSchema => ({
+  kind: "object", fields, ...(allowUnknown ? { allowUnknown: true } : {}),
+});
+const recipeColor = { kind: "string", format: "color", minLength: 7, maxLength: 9 } as const satisfies ValueSchema;
+const rankingRecipeSchemas = {
+  rows: { kind: "array", minItems: 1, items: object({
+    id: { schema: { kind: "string", minLength: 1 } },
+    label: { schema: { kind: "string", minLength: 1 } },
+    color: { schema: recipeColor },
+  }) },
+  "rank-colors": { kind: "array", minItems: 1, items: recipeColor },
+  "slot-colors": { kind: "array", minItems: 3, maxItems: 3, items: recipeColor },
+  "font-size": { kind: "number", minimum: 0 },
+  "font-weight": { kind: "number", integer: true, minimum: 1 },
+  "text-color": recipeColor,
+  "label-text-color": recipeColor,
+  "label-size": { kind: "number", minimum: 0 },
+  "line-height": { kind: "number", minimum: 0 },
+  "board-background": recipeColor,
+  "board-border-color": recipeColor,
+  "board-border-width": { kind: "number", minimum: 0 },
+  "board-radius": { kind: "number", minimum: 0 },
+  "board-shadow-x": { kind: "number" },
+  "board-shadow-y": { kind: "number" },
+  "board-shadow-blur": { kind: "number", minimum: 0 },
+  "board-shadow-spread": { kind: "number" },
+  "board-shadow-color": recipeColor,
+  "appear-frames": { kind: "number", integer: true, minimum: 1 },
+  "move-frames": { kind: "number", integer: true, minimum: 1 },
+  "motion-easing": { kind: "string", enum: ["linear", "ease-in", "ease-out", "ease-in-out"] },
+  "label-width": { kind: "number", minimum: 0.08, maximum: 0.3 },
+  "icon-radius-ratio": { kind: "number", minimum: 0 },
+  padding: { kind: "number", minimum: 0 },
+  "row-height": { kind: "number", minimum: 0 },
+  "row-gap": { kind: "number", minimum: 0 },
+  "cell-gap": { kind: "number", minimum: 0 },
+  "icon-size": { kind: "number", minimum: 0 },
+  "icon-radius": { kind: "number", minimum: 0 },
+  "icon-fit": { kind: "string", enum: ["contain", "cover"] },
+  "stage-x": { kind: "number", minimum: 0, maximum: 1 },
+  "stage-y": { kind: "number", minimum: 0, maximum: 1 },
+  "stage-size": { kind: "number", minimum: 0 },
+  "center-x": { kind: "number" },
+  "baseline-y": { kind: "number" },
+  "slot-gap": { kind: "number", minimum: 0 },
+  "ring-width": { kind: "number", minimum: 0 },
+  "label-gap": { kind: "number", minimum: 0 },
+  "board-stack": { kind: "number", integer: true },
+  "stage-stack": { kind: "number", integer: true },
+  "item-stack": { kind: "number", integer: true },
+  "appear-gain": { kind: "number", minimum: 0 },
+  "move-gain": { kind: "number", minimum: 0 },
+  "sound-fade-frames": { kind: "number", integer: true, minimum: 0 },
+} as const satisfies Readonly<Record<string, ValueSchema>>;
+
+function typedRecipeProperties<const T extends readonly {
+  readonly name: string;
+  readonly required: boolean;
+  readonly summary: string;
+  readonly values?: readonly string[];
+  readonly fallback?: import("@hypit/protocol").CanonicalValue;
+}[]>(properties: T) {
+  return properties.map((property) => {
+    const schema = rankingRecipeSchemas[property.name as keyof typeof rankingRecipeSchemas];
+    if (schema === undefined) throw new Error(`Ranking Recipe property ${property.name} has no public schema.`);
+    const fallback = schema.kind === "number" && typeof property.fallback === "string"
+      ? Number(property.fallback)
+      : property.fallback;
+    return {
+      ...property,
+      schema,
+      ...(fallback === undefined ? {} : { fallback }),
+    };
+  });
+}
+const variants = { kind: "string", enum: ["tier-board", "column", "top-three"] } as const;
+const itemBase = {
+  id: { schema: string },
+  stackingOrder: { schema: integer, optional: true },
+} as const;
+export const rankingHeaderSchema: ValueSchema = object({
+  id: { schema: string }, variant: { schema: variants },
+});
+export const rankingItemSpecSchema: ValueSchema = { kind: "oneOf", variants: [
+  object({ variant: { schema: { kind: "literal", value: "tier-board" } }, ...itemBase,
+    tier: { schema: string }, preset: { schema: { kind: "literal", value: true } },
+  }),
+  object({ variant: { schema: { kind: "literal", value: "tier-board" } }, ...itemBase,
+    tier: { schema: string }, preset: { schema: { kind: "literal", value: false } }, entry: { schema: { kind: "string", enum: ["direct", "drop"] } },
+  }),
+  object({ variant: { schema: { kind: "literal", value: "column" } }, ...itemBase,
+    label: { schema: string }, rank: { schema: { kind: "number", integer: true, minimum: 1 } }, preset: { schema: { kind: "boolean" } },
+  }),
+  object({ variant: { schema: { kind: "literal", value: "top-three" } }, ...itemBase, label: { schema: string } }),
+] };
+export const rankingTextItemShellSchema: ValueSchema = { kind: "oneOf", variants: [
+  object({ variant: { schema: { kind: "literal", value: "column" } }, ...itemBase,
+    rank: { schema: { kind: "number", integer: true, minimum: 1 } }, preset: { schema: { kind: "boolean" } },
+  }),
+  object({ variant: { schema: { kind: "literal", value: "top-three" } }, ...itemBase }),
+] };
+export const rankingItemSpecSetSchema: ValueSchema = object({
+
+  variant: { schema: variants }, items: { schema: { kind: "array", items: rankingItemSpecSchema } },
+});
+const frameSpan = object({ startFrame: { schema: unsigned }, endFrameExclusive: { schema: unsigned } });
+export const triggeredRankingCandidateSetSchema: ValueSchema = object({
+  entries: { schema: { kind: "array", items: object({
+    itemId: { schema: string }, activation: { schema: temporalInstantSchema },
+  }) } },
+});
+export const rankingWindowSetSchema: ValueSchema = object({
+  entries: { schema: { kind: "array", items: object({
+    itemId: { schema: string }, window: { schema: temporalWindowSchema },
+  }) } },
+});
+export const tierBoardWindowSetSchema = rankingWindowSetSchema;
+export const columnWindowSetSchema = rankingWindowSetSchema;
+const triggeredScheduleSchema: ValueSchema = object({
+  id: { schema: string },
+  variant: { schema: { kind: "literal", value: "top-three" } },
+  outer: { schema: frameSpan }, terminalFrame: { schema: unsigned },
+  entries: { schema: { kind: "array", minItems: 1, items: object({
+    itemId: { schema: string }, triggerFrame: { schema: unsigned },
+    stage: { schema: frameSpan }, cumulative: { schema: frameSpan }, settled: { schema: frameSpan },
+  }) } },
+});
+const windowedScheduleSchema = (variant: "tier-board" | "column"): ValueSchema => object({
+  id: { schema: string }, variant: { schema: { kind: "literal", value: variant } }, outer: { schema: frameSpan },
+  entries: { schema: { kind: "array", minItems: 1, items: { kind: "oneOf", variants: [
+    object({ itemId: { schema: string }, mode: { schema: { kind: "literal", value: "preset" } }, settled: { schema: frameSpan } }),
+    object({ itemId: { schema: string }, mode: { schema: { kind: "literal", value: "reveal" } },
+      window: { schema: frameSpan }, settled: { schema: frameSpan },
+    }),
+  ] } } },
+});
+export const rankingScheduleSchema: ValueSchema = { kind: "oneOf", variants: [
+  triggeredScheduleSchema, windowedScheduleSchema("tier-board"), windowedScheduleSchema("column"),
+] };
+const styleSchema = (): ValueSchema => object({}, true);
+const setSchema = (): ValueSchema => object({
+  items: { schema: { kind: "array", items: object({}, true) } },
+});
+const programSchema = (): ValueSchema => object({
+  id: { schema: string }, frame: { schema: spatialFrameSchema },
+  schedule: { schema: rankingScheduleSchema }, style: { schema: object({}, true) }, items: { schema: { kind: "array", minItems: 1, items: object({}, true) } },
+}, true);
+export const rankingSoundStyleSchema = styleSchema();
+export const rankingSoundEventsSchema: ValueSchema = object({
+  id: { schema: string }, variant: { schema: variants },
+  events: { schema: { kind: "array", items: object({ id: { schema: string }, itemId: { schema: string }, kind: { schema: { kind: "string", enum: ["appear", "move"] } }, frame: { schema: unsigned } }) } },
+});
+export const rankingSoundSetSchema: ValueSchema = object({
+
+  appear: { schema: object({}, true), optional: true }, move: { schema: object({}, true), optional: true },
+});
+const programDefinitions = [
+  [rankingTypes.tierProgram, rankingTypes.tierStyle, rankingTypes.tierItems, rankingProducers.tierProgram, rankingProducers.tierEvents, rankingProducers.renderTier],
+  [rankingTypes.columnProgram, rankingTypes.columnStyle, rankingTypes.columnItems, rankingProducers.columnProgram, rankingProducers.columnEvents, rankingProducers.renderColumn],
+  [rankingTypes.topThreeProgram, rankingTypes.topThreeStyle, rankingTypes.topThreeItems, rankingProducers.topThreeProgram, rankingProducers.topThreeEvents, rankingProducers.renderTopThree],
+] as const;
+
+const allRankingMarkupSurfaces = [
+    { name: "tier-style", tag: "TierBoardStyle", mode: "structured", outputs: [rankingTypes.tierStyle, rankingTypes.soundStyle],
+      vocabulary: {
+        summary: "Compiles one SVS Recipe and one exact font into the Style a TierBoard is drawn in, and the private sound Style it connects.",
+        attributes: [
+          { name: "id", kind: "identifier", required: true,
+            summary: "Names this Style so a TierBoard can reference it." },
+          { name: "recipe", kind: "reference", required: true, accepts: [svsRecipeType],
+            summary: "Chooses the Recipe carrying the tier rows, board Paint, row and cell geometry, icon treatment and entrance motion.",
+            recipe: typedRecipeProperties([
+              { name: "rows", required: false, fallback: [
+                { id: "s", label: "S", color: "#EE5F52" },
+                { id: "a", label: "A", color: "#F0A04C" },
+                { id: "b", label: "B", color: "#F0C84D" },
+                { id: "c", label: "C", color: "#EDE356" },
+                { id: "d", label: "D", color: "#A6DA7B" },
+              ], summary: "Defines the ordered tier rows the board draws, each with an id, label and color." },
+              { name: "label-text-color", required: false, fallback: "#2c2c2c",
+                summary: "Sets the color of the row letters." },
+              { name: "label-size", required: false, fallback: "0.3",
+                summary: "Sets each row letter's size as a fraction of the row height." },
+              { name: "line-height", required: false, fallback: "1",
+                summary: "Sets the row letter line height as a multiple of its size." },
+              { name: "board-background", required: false, fallback: "#2b2b30",
+                summary: "Sets the grey content area behind the placed icons." },
+              { name: "board-border-color", required: false, fallback: "#111315",
+                summary: "Sets the continuous grid-line color around and between the tier rows." },
+              { name: "board-border-width", required: false, fallback: "3",
+                summary: "Sets the grid-line width in pixels." },
+              { name: "label-width", required: false,
+                summary: "Overrides the label column width as a fraction of the board Frame width; when absent it is derived from row height." },
+              { name: "stage-x", required: false, fallback: "0.2",
+                summary: "Places the independent explanation stage horizontally as a fraction of the Canvas width." },
+              { name: "stage-y", required: false, fallback: "0.3",
+                summary: "Places the independent explanation stage vertically as a fraction of the Canvas height." },
+              { name: "stage-size", required: false, fallback: "168",
+                summary: "Sets the staged Item size in Canvas pixels independently from its settled tier cell." },
+              { name: "icon-radius-ratio", required: false, fallback: "0.12",
+                summary: "Sets icon corner radius as a fraction of one tier row's height." },
+              { name: "icon-fit", required: false, fallback: "cover",
+                values: ["contain", "cover"],
+                summary: "Decides whether an Item's icon fits inside its box or fills it." },
+              { name: "appear-frames", required: false, fallback: "8",
+                summary: "Sets the quick in-place scale-and-fade entrance duration for both entry modes." },
+              { name: "move-frames", required: false, fallback: "14",
+                summary: "Sets the final eased curved glide duration of a staged Item; it always ends at the Item window's end." },
+              { name: "board-stack", required: false, fallback: "20",
+                summary: "Sets the draw order the board itself is placed at." },
+              { name: "stage-stack", required: false, fallback: "25",
+                summary: "Sets the draw order a drop Item uses while it occupies the independent stage." },
+              { name: "item-stack", required: false, fallback: "30",
+                summary: "Sets the draw order every Item is placed at, unless the Item overrides it." },
+              { name: "appear-gain", required: false, fallback: "1",
+                summary: "Sets the gain the appear sound is played at." },
+              { name: "move-gain", required: false, fallback: "1",
+                summary: "Sets the gain the move sound is played at." },
+              { name: "sound-fade-frames", required: false, fallback: "0",
+                summary: "Sets how many frames each sound fades in and out over." },
+            ]) },
+          { name: "font", kind: "reference", required: true,
+            accepts: [mediaTypes.fontArtifact, mediaTypes.fontStack],
+            summary: "Chooses the exact face, or a whole stack that already carries its own fallbacks, the board copy is set in." },
+        ],
+        ports: [
+          { name: "", type: rankingTypes.tierStyle,
+            summary: "The compiled visual Style, addressed by the element's own id." },
+          { name: "sound", type: rankingTypes.soundStyle,
+            summary: "The compiled sound Style, connected only when the board authors a sound." },
+        ],
+        example: `<ranking:TierBoardStyle id="tier-style" recipe={recipes.ranking.tier} font={ui-font}/>`,
+        notes: [
+          "The element is empty; it accepts no children and no text.",
+          "The Recipe is validated against the variant, so a Recipe holding another board's keys is refused by name.",
+          "The Recipe accepts exactly the properties listed here; every other property is refused by name.",
+          "Tier row ids, labels and colors are Recipe configuration, because they define the board vocabulary rather than item copy.",
+        ],
+      } },
+    { name: "column-style", tag: "ColumnStyle", mode: "structured", outputs: [rankingTypes.columnStyle, rankingTypes.soundStyle],
+      vocabulary: {
+        summary: "Compiles one SVS Recipe and one exact font into the Style a Column is drawn in, and the private sound Style it connects.",
+        attributes: [
+          { name: "id", kind: "identifier", required: true,
+            summary: "Names this Style so a Column can reference it." },
+          { name: "recipe", kind: "reference", required: true, accepts: [svsRecipeType],
+            summary: "Chooses the Recipe carrying the rank colors, board Paint, row geometry, icon treatment, staging pose and motion.",
+            recipe: typedRecipeProperties([
+              { name: "rank-colors", required: false, fallback: ["#facc15", "#d1d5db", "#fb923c", "#60a5fa", "#a78bfa"],
+                summary: "Defines the ordered colors rank badges use, cycling after the last color." },
+              { name: "font-size", required: false, fallback: "28",
+                summary: "Sets the size in pixels the row copy is set at." },
+              { name: "font-weight", required: false, fallback: "700",
+                summary: "Sets the weight the row copy is set at." },
+              { name: "text-color", required: false, fallback: "#ffffff",
+                summary: "Sets the color the row copy is drawn in." },
+              { name: "line-height", required: false, fallback: "1.15",
+                summary: "Sets the line height the row copy is set on, as a multiple of its size." },
+              { name: "board-background", required: false, fallback: "#151821",
+                summary: "Sets the color the board fills with." },
+              { name: "board-border-color", required: false, fallback: "#ffffff33",
+                summary: "Sets the color of the board's border." },
+              { name: "board-border-width", required: false, fallback: "1",
+                summary: "Sets the width in pixels of the board's border." },
+              { name: "board-radius", required: false, fallback: "18",
+                summary: "Sets the corner radius in pixels of the board." },
+              { name: "board-shadow-x", required: false, fallback: "0",
+                summary: "Offsets the board's shadow horizontally in pixels." },
+              { name: "board-shadow-y", required: false, fallback: "10",
+                summary: "Offsets the board's shadow vertically in pixels." },
+              { name: "board-shadow-blur", required: false, fallback: "24",
+                summary: "Sets the blur radius in pixels of the board's shadow." },
+              { name: "board-shadow-spread", required: false, fallback: "0",
+                summary: "Sets the spread in pixels of the board's shadow." },
+              { name: "board-shadow-color", required: false, fallback: "#00000066",
+                summary: "Sets the color of the board's shadow." },
+              { name: "appear-frames", required: false, fallback: "6",
+                summary: "Sets how many frames a row takes to appear." },
+              { name: "move-frames", required: false, fallback: "8",
+                summary: "Sets how many frames a staged row takes to move into the column." },
+              { name: "motion-easing", required: false, fallback: "ease-in-out",
+                values: ["linear", "ease-in", "ease-out", "ease-in-out"],
+                summary: "Selects the easing both the appearance and the move are timed with." },
+              { name: "padding", required: false, fallback: "18",
+                summary: "Sets the inset in pixels between the board's edge and its rows." },
+              { name: "row-height", required: false, fallback: "74",
+                summary: "Sets the height in pixels of one row." },
+              { name: "row-gap", required: false, fallback: "10",
+                summary: "Sets the gap in pixels between rows." },
+              { name: "icon-size", required: false, fallback: "58",
+                summary: "Sets the size in pixels a row's icon is drawn at." },
+              { name: "icon-radius", required: false, fallback: "10",
+                summary: "Sets the corner radius in pixels of a row's icon." },
+              { name: "icon-fit", required: false, fallback: "cover",
+                values: ["contain", "cover"],
+                summary: "Decides whether a row's icon fits inside its box or fills it." },
+              { name: "stage-x", required: false, fallback: "0.5",
+                summary: "Places the staging point horizontally, as a fraction of the Frame's width." },
+              { name: "stage-y", required: false, fallback: "0.24",
+                summary: "Places the staging point vertically, as a fraction of the Frame's height." },
+              { name: "stage-size", required: false, fallback: "132",
+                summary: "Sets the size in pixels a staged row is drawn at before it moves in." },
+              { name: "board-stack", required: false, fallback: "20",
+                summary: "Sets the draw order the board itself is placed at." },
+              { name: "stage-stack", required: false, fallback: "25",
+                summary: "Sets the draw order the staging area is placed at." },
+              { name: "item-stack", required: false, fallback: "30",
+                summary: "Sets the draw order every row is placed at, unless the Item overrides it." },
+              { name: "appear-gain", required: false, fallback: "1",
+                summary: "Sets the gain the appear sound is played at." },
+              { name: "move-gain", required: false, fallback: "1",
+                summary: "Sets the gain the move sound is played at." },
+              { name: "sound-fade-frames", required: false, fallback: "0",
+                summary: "Sets how many frames each sound fades in and out over." },
+            ]) },
+          { name: "font", kind: "reference", required: true,
+            accepts: [mediaTypes.fontArtifact, mediaTypes.fontStack],
+            summary: "Chooses the exact face, or a whole stack that already carries its own fallbacks, the board copy is set in." },
+        ],
+        ports: [
+          { name: "", type: rankingTypes.columnStyle,
+            summary: "The compiled visual Style, addressed by the element's own id." },
+          { name: "sound", type: rankingTypes.soundStyle,
+            summary: "The compiled sound Style, connected only when the board authors a sound." },
+        ],
+        example: `<ranking:ColumnStyle id="board-style" recipe={recipes.ranking.board} font={ui-font}/>`,
+        notes: [
+          "The element is empty; it accepts no children and no text.",
+          "The Recipe is validated against the variant, so a Recipe holding another board's keys is refused by name.",
+          "The Recipe accepts exactly the properties listed here; every other property is refused by name.",
+        ],
+      } },
+    { name: "top-three-style", tag: "TopThreeStyle", mode: "structured", outputs: [rankingTypes.topThreeStyle, rankingTypes.soundStyle],
+      vocabulary: {
+        summary: "Compiles one SVS Recipe and one exact font into the Style a TopThree is drawn in, and the private sound Style it connects.",
+        attributes: [
+          { name: "id", kind: "identifier", required: true,
+            summary: "Names this Style so a TopThree can reference it." },
+          { name: "recipe", kind: "reference", required: true, accepts: [svsRecipeType],
+            summary: "Chooses the Recipe carrying the slot colors, podium geometry, ring and label spacing, board Paint and motion.",
+            recipe: typedRecipeProperties([
+              { name: "slot-colors", required: false, fallback: ["#facc15", "#d1d5db", "#fb923c"],
+                summary: "Defines the three ordered colors used by the three podium slots." },
+              { name: "font-size", required: false, fallback: "28",
+                summary: "Sets the size in pixels the slot copy is set at." },
+              { name: "font-weight", required: false, fallback: "700",
+                summary: "Sets the weight the slot copy is set at." },
+              { name: "text-color", required: false, fallback: "#ffffff",
+                summary: "Sets the color the slot copy is drawn in, before the slot's own color replaces it." },
+              { name: "line-height", required: false, fallback: "1.15",
+                summary: "Sets the line height the slot copy is set on, as a multiple of its size." },
+              { name: "center-x", required: false, fallback: "0.5",
+                summary: "Places the podium's center horizontally, as a fraction of the Frame's width." },
+              { name: "baseline-y", required: false, fallback: "0.55",
+                summary: "Places the podium's baseline vertically, as a fraction of the Frame's height." },
+              { name: "slot-gap", required: false, fallback: "24",
+                summary: "Sets the gap in pixels between podium slots." },
+              { name: "icon-size", required: false, fallback: "104",
+                summary: "Sets the size in pixels a slot's icon is drawn at." },
+              { name: "icon-radius", required: false, fallback: "52",
+                summary: "Sets the corner radius in pixels of a slot's icon." },
+              { name: "icon-fit", required: false, fallback: "cover",
+                values: ["contain", "cover"],
+                summary: "Decides whether a slot's icon fits inside its box or fills it." },
+              { name: "ring-width", required: false, fallback: "5",
+                summary: "Sets the width in pixels of the ring drawn around a slot." },
+              { name: "label-gap", required: false, fallback: "12",
+                summary: "Sets the gap in pixels between a slot's icon and its label." },
+              { name: "appear-frames", required: false, fallback: "6",
+                summary: "Sets how many frames a slot takes to appear." },
+              { name: "move-frames", required: false, fallback: "8",
+                summary: "Sets how many frames a move is timed over, though a podium never moves a slot." },
+              { name: "motion-easing", required: false, fallback: "ease-in-out",
+                values: ["linear", "ease-in", "ease-out", "ease-in-out"],
+                summary: "Selects the easing the appearance is timed with." },
+              { name: "board-stack", required: false, fallback: "20",
+                summary: "Sets the draw order the empty podium is placed at." },
+              { name: "item-stack", required: false, fallback: "30",
+                summary: "Sets the draw order every filled slot is placed at, unless the Item overrides it." },
+              { name: "appear-gain", required: false, fallback: "1",
+                summary: "Sets the gain the appear sound is played at." },
+              { name: "move-gain", required: false, fallback: "1",
+                summary: "Sets the gain a move sound would be played at, though a podium authors none." },
+              { name: "sound-fade-frames", required: false, fallback: "0",
+                summary: "Sets how many frames each sound fades in and out over." },
+            ]) },
+          { name: "font", kind: "reference", required: true,
+            accepts: [mediaTypes.fontArtifact, mediaTypes.fontStack],
+            summary: "Chooses the exact face, or a whole stack that already carries its own fallbacks, the board copy is set in." },
+        ],
+        ports: [
+          { name: "", type: rankingTypes.topThreeStyle,
+            summary: "The compiled visual Style, addressed by the element's own id." },
+          { name: "sound", type: rankingTypes.soundStyle,
+            summary: "The compiled sound Style, connected only when the board authors a sound." },
+        ],
+        example: `<ranking:TopThreeStyle id="podium-style" recipe={recipes.ranking.podium} font={ui-font}/>`,
+        notes: [
+          "The element is empty; it accepts no children and no text.",
+          "The Recipe is validated against the variant, so a Recipe holding another board's keys is refused by name.",
+          "The Recipe carries one color per podium slot, so a TopThree Style always resolves three of them.",
+          "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],
+      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:
+          "The board occupies only its Frame: one continuous tier table with colored label cells, a dark content field and dark grid lines. An independent explanation stage is positioned in Canvas space. Preset tiles occupy the innermost cells from the first frame. Every other tile takes one explicit Segment or Selection window; sorting those disjoint windows gives the strict reveal order and fills each tier from inside to outside. Both entry modes appear in place with a quick overshoot and soft settle. A direct tile appears in its final cell. A drop tile appears on the stage, remains still while that Item is discussed, then follows an eased curved glide into its final cell during the window's last move interval. Every placed tile remains settled while later ones arrive.",
+        preview: previewImage("TierBoard.svg", "image/svg+xml"),
+        attributes: [
+          { name: "id", kind: "identifier", required: true,
+            summary: "Names this board so its Schedule, Program and Tracks can be referenced elsewhere in the Source." },
+          ...temporalContextAttributeVocabulary,
+          { name: "canvas", kind: "reference", required: true, accepts: [spatialTypes.canvas],
+            summary: "Chooses the Canvas coordinate space used by the independent explanation stage." },
+          { name: "frame", kind: "reference", required: true, accepts: [spatialTypes.frame],
+            summary: "Chooses the compact Frame occupied only by the tier table." },
+          { name: "during", kind: "expression", required: true, values: ["program"], accepts: [narrativeTypes.selection, narrativeTypes.excerpt],
+            summary: "Spans the complete film clock when written as program, or projects the referenced Segment or Selection into the board lifetime." },
+          { name: "style", kind: "reference", required: true, accepts: [rankingTypes.tierStyle],
+            summary: "Chooses the TierBoardStyle this board is drawn in, and only that variant's." },
+          { name: "appear-sound", kind: "reference", required: false, accepts: [mediaTypes.synchronized],
+            summary: "Chooses the Synchronized Medium played as each Item appears." },
+          { name: "move-sound", kind: "reference", required: false, accepts: [mediaTypes.synchronized],
+            summary: "Chooses the Synchronized Medium played when a drop Item leaves the independent stage near the end of its window." },
+        ],
+        children: [
+          { tag: "TierItem", cardinality: "many",
+            summary: "One icon tile of the board; it is either preset or owns one Segment or Selection reveal window and is empty.",
+            attributes: [
+              { name: "id", kind: "identifier", required: false,
+                summary: "Names this Item within the board; an omitted id is generated from the Item's position." },
+              { name: "tier", kind: "literal", required: true,
+                summary: "Chooses the row of the Style Recipe this Item is placed into." },
+              { name: "preset", kind: "literal", required: false, values: ["true", "false"],
+                summary: "Makes the Item occupy its tier from the start; a preset Item has no during or entry." },
+              { name: "entry", kind: "literal", required: false, values: ["direct", "drop"],
+                summary: "Chooses an in-place entrance in the final cell or on the independent stage; a staged Item holds for the explanation, then glides into the tier at the window end. It is required for non-preset Items and forbidden for preset Items." },
+              { name: "icon", kind: "reference", required: true, accepts: [mediaTypes.blobArtifact],
+                summary: "Chooses the image drawn beside the Item." },
+              { name: "during", kind: "reference", required: false, accepts: [narrativeTypes.selection, narrativeTypes.excerpt],
+                summary: "Chooses this non-preset Item's exact Segment or Selection interval; all sibling intervals must be disjoint." },
+              { name: "stack", kind: "literal", required: false,
+                summary: "Overrides the Style's draw order for this Item alone." },
+            ] },
+        ],
+        ports: [
+          { name: "schedule", type: rankingTypes.schedule,
+            summary: "The resolved Schedule: preset occupancy plus each revealed Item's exact window and settled span." },
+          { name: "program", type: rankingTypes.tierProgram,
+            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: "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}
+  during="program"
+  style={tier-style}>
+  <ranking:TierItem id="row-regen" tier="s" preset="true" icon={icon-regen}/>
+  <ranking:TierItem id="row-remini" tier="a" entry="drop" icon={icon-remini} during={story.selection.remini}/>
+</ranking:TierBoard>`,
+        notes: [
+          "The board requires at least one TierItem, accepts no other child and no text of its own, and Item ids must be unique within it.",
+          "Every non-preset Item consumes a non-empty Segment or Selection of at least two frames; windows must be inside the board and non-overlapping.",
+          "Preset Items occupy the inner cells in author order. Revealed Items follow in strict window order, independent of child order.",
+          "`move-sound` requires at least one TierItem written `entry=\"drop\"`; a sound with nothing to sound on is refused.",
+          "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],
+      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:
+          "A narrow vertical rank rail occupies its Frame while a large reveal stage is positioned independently in Canvas space. Preset rows are settled from the first frame. Each other row rises into the stage during its own projected Segment or Selection, then shrinks and moves into the content slot beside its numbered rank. Rank, child order and reveal time are independent.",
+        preview: previewImage("Column.svg", "image/svg+xml"),
+        attributes: [
+          { name: "id", kind: "identifier", required: true,
+            summary: "Names this board so its Schedule, Program and Tracks can be referenced elsewhere in the Source." },
+          ...temporalContextAttributeVocabulary,
+          { name: "canvas", kind: "reference", required: true, accepts: [spatialTypes.canvas],
+            summary: "Chooses the Canvas coordinate space used by the independent reveal stage." },
+          { name: "frame", kind: "reference", required: true, accepts: [spatialTypes.frame],
+            summary: "Chooses the fixed Frame occupied by the vertical rank rail." },
+          { name: "during", kind: "expression", required: true, values: ["program"], accepts: [narrativeTypes.selection, narrativeTypes.excerpt],
+            summary: "Spans the complete film clock when written as program, or projects the referenced Segment or Selection into the Column lifetime." },
+          { name: "style", kind: "reference", required: true, accepts: [rankingTypes.columnStyle],
+            summary: "Chooses the ColumnStyle this board is drawn in, and only that variant's." },
+          { name: "appear-sound", kind: "reference", required: false, accepts: [mediaTypes.synchronized],
+            summary: "Chooses the Synchronized Medium played as each row appears." },
+          { name: "move-sound", kind: "reference", required: false, accepts: [mediaTypes.synchronized],
+            summary: "Chooses the Synchronized Medium played as a staged row moves into the settled column." },
+        ],
+        children: [
+          { tag: "ColumnItem", cardinality: "many",
+            summary: "One explicitly ranked row; it is either preset or owns one Segment or Selection reveal window.",
+            attributes: [
+              { name: "id", kind: "identifier", required: false,
+                summary: "Names this row within the board; an omitted id is generated from the row's position." },
+              { name: "label", kind: "expression", required: true, accepts: [textTypes.text],
+                summary: "Sets the row's copy, written literally or chosen from an existing Text." },
+              { name: "rank", kind: "literal", required: true,
+                summary: "Sets the positive rank number and final row position independently from reveal order." },
+              { name: "preset", kind: "literal", required: false, values: ["true", "false"],
+                summary: "Settles the row from the start of the outer window; defaults to false." },
+              { name: "during", kind: "reference", required: false, accepts: [narrativeTypes.selection, narrativeTypes.excerpt],
+                summary: "Chooses this row's Segment or Selection reveal window; required unless preset is true." },
+              { name: "icon", kind: "reference", required: false, accepts: [mediaTypes.blobArtifact],
+                summary: "Chooses the image drawn beside the row." },
+              { name: "stack", kind: "literal", required: false,
+                summary: "Overrides the Style's draw order for this row alone." },
+            ] },
+        ],
+        ports: [
+          { name: "schedule", type: rankingTypes.schedule,
+            summary: "The resolved Schedule: preset spans and non-overlapping reveal windows inside the outer lifetime." },
+          { name: "program", type: rankingTypes.columnProgram,
+            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: "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}
+  during={story.segment.ranking}
+  style={board-style}>
+  <ranking:ColumnItem id="row-regen" rank="1" label="ReGen" icon={icon-regen} during={story.selection.regen}/>
+  <ranking:ColumnItem id="row-chatgpt" rank="2" label="ChatGPT" icon={icon-chatgpt} during={story.selection.chatgpt}/>
+  <ranking:ColumnItem id="row-remini" rank="5" preset="true" label="Remini" icon={icon-remini}/>
+</ranking:Column>`,
+        notes: [
+          "The board requires at least one ColumnItem, accepts no other child and no text of its own, and Item ids must be unique within it.",
+          "Ranks must be unique; child order does not determine either final placement or reveal order.",
+          "Every non-preset Selection window must already lie inside the outer window and be disjoint from every sibling; invalid input is refused, never repaired.",
+          "A `label` written as a reference materializes the row from that exact Text before the board is scheduled.",
+          "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],
+      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:
+          "No board, no fill and no shadow: at most three empty rings — circles at the Style's default corner radius — sit side by side in one row, centered on the Style's center point and standing on a shared baseline across the Frame, each outlined faintly in its own slot color. At each Item's Moment, its slot fades and rises into place, its ring brightening to the full slot color and swelling once slightly larger before settling back; the Item's icon fills the ring, or its rank number is set inside the ring in the slot color when no icon is written. The Item's label appears centered on its own line directly beneath the ring. Slots fill in chronological Moment order and never move afterwards, so the row only gains brightness and copy as it goes.",
+        preview: previewImage("TopThree.png"),
+        attributes: [
+          { name: "id", kind: "identifier", required: true,
+            summary: "Names this board so its Schedule, Program and Tracks can be referenced elsewhere in the Source." },
+          ...temporalContextAttributeVocabulary,
+          { name: "frame", kind: "reference", required: true, accepts: [spatialTypes.frame],
+            summary: "Chooses the Frame the whole board occupies." },
+          { name: "during", kind: "expression", required: true, values: ["program"], accepts: [narrativeTypes.selection, narrativeTypes.excerpt],
+            summary: "Chooses the board's whole-program, Selection or Segment lifetime." },
+          { name: "terminal", kind: "expression", required: true, accepts: [narrativeTypes.moment],
+            summary: "Chooses the terminal Moment or authored time, such as 8s." },
+          { name: "style", kind: "reference", required: true, accepts: [rankingTypes.topThreeStyle],
+            summary: "Chooses the TopThreeStyle this board is drawn in, and only that variant's." },
+          { name: "appear-sound", kind: "reference", required: false, accepts: [mediaTypes.synchronized],
+            summary: "Chooses the Synchronized Medium played as each slot appears." },
+        ],
+        children: [
+          { tag: "TopThreeItem", cardinality: "many",
+            summary: "One slot of the podium, placed at its own Moment; it is empty.",
+            attributes: [
+              { name: "id", kind: "identifier", required: false,
+                summary: "Names this slot within the board; an omitted id is generated from the slot's position." },
+              { name: "label", kind: "expression", required: true, accepts: [textTypes.text],
+                summary: "Sets the slot's copy, written literally or chosen from an existing Text." },
+              { name: "icon", kind: "reference", required: false, accepts: [mediaTypes.blobArtifact],
+                summary: "Chooses the image drawn beside the slot." },
+              ...temporalInstantAttributeVocabulary,
+              { name: "stack", kind: "literal", required: false,
+                summary: "Overrides the Style's draw order for this slot alone." },
+            ] },
+        ],
+        ports: [
+          { name: "schedule", type: rankingTypes.schedule,
+            summary: "The resolved Schedule: each Item's trigger frame and its staged, cumulative and settled spans." },
+          { name: "program", type: rankingTypes.topThreeProgram,
+            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: "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}
+  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}/>
+  <ranking:TopThreeItem id="slot-silver" label="ChatGPT" at={story.moment.chatgpt}/>
+  <ranking:TopThreeItem id="slot-bronze" label="Remini" at={story.moment.remini}/>
+</ranking:TopThree>`,
+        notes: [
+          "The board requires at least one TopThreeItem, accepts no other child and no text of its own, and Item ids must be unique within it.",
+          "A `label` written as a reference materializes the slot from that exact Text before the board is scheduled.",
+          "The podium has no move phase, so it takes no `move-sound`; writing one is refused.",
+          "The podium holds at most three Items; a fourth is refused when the Program is built.",
+          "Authoring the appear sound also connects the Style's `.sound` output, so `style` must name a TopThreeStyle written in this Source.",
+        ],
+      } },
+] as const;
+
+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],
+  types: [
+    { name: rankingTypes.header.name },
+    { name: rankingTypes.itemSpec.name },
+    { name: rankingTypes.textItemShell.name },
+    { name: rankingTypes.itemSpecs.name },
+    { name: rankingTypes.triggeredCandidates.name },
+    { name: rankingTypes.tierWindows.name },
+    { name: rankingTypes.columnWindows.name },
+    { name: rankingTypes.schedule.name },
+    { name: rankingTypes.soundStyle.name },
+    { name: rankingTypes.soundEvents.name },
+    { name: rankingTypes.sounds.name },
+    { name: rankingTypes.tierStyle.name },
+    { name: rankingTypes.columnStyle.name },
+    { name: rankingTypes.topThreeStyle.name },
+    { name: rankingTypes.tierItems.name },
+    { name: rankingTypes.columnItems.name },
+    { name: rankingTypes.topThreeItems.name },
+    { name: rankingTypes.tierProgram.name },
+    { name: rankingTypes.columnProgram.name },
+    { name: rankingTypes.topThreeProgram.name },
+  ],
+  capabilities: [],
+  producers: [
+    { name: rankingProducers.materializeTextItem.name, inputs: [{ name: "shell", type: rankingTypes.textItemShell }, { name: "content", type: textTypes.text }], outputs: [{ name: "spec", type: rankingTypes.itemSpec }], needs: [] },
+    { name: rankingProducers.createSpecs.name, inputs: [{ name: "header", type: rankingTypes.header }], outputs: [{ name: "set", type: rankingTypes.itemSpecs }], needs: [] },
+    { name: rankingProducers.appendSpec.name, inputs: [{ name: "set", type: rankingTypes.itemSpecs }, { name: "spec", type: rankingTypes.itemSpec }], outputs: [{ name: "set", type: rankingTypes.itemSpecs }], needs: [] },
+    { name: rankingProducers.createTriggeredCandidates.name, inputs: [], outputs: [
+      { name: "set", type: rankingTypes.triggeredCandidates },
+    ], needs: [] },
+    { name: rankingProducers.appendTriggeredCandidate.name, inputs: [
+      { name: "set", type: rankingTypes.triggeredCandidates }, { name: "spec", type: rankingTypes.itemSpec },
+      { name: "activation", type: temporalTypes.instant },
+    ], 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: "outer", type: temporalTypes.window }, { name: "candidates", type: rankingTypes.triggeredCandidates },
+      { name: "terminal", type: temporalTypes.instant },
+    ], outputs: [{ name: "schedule", type: rankingTypes.schedule }], needs: [] },
+    { name: rankingProducers.createTierWindows.name, inputs: [], outputs: [
+      { name: "set", type: rankingTypes.tierWindows },
+    ], needs: [] },
+    { name: rankingProducers.appendTierWindow.name, inputs: [
+      { name: "set", type: rankingTypes.tierWindows }, { name: "spec", type: rankingTypes.itemSpec },
+      { name: "window", type: temporalTypes.window },
+    ], 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: "outer", type: temporalTypes.window }, { name: "windows", type: rankingTypes.tierWindows },
+    ], outputs: [{ name: "schedule", type: rankingTypes.schedule }], needs: [] },
+    { name: rankingProducers.createColumnWindows.name, inputs: [], outputs: [
+      { name: "set", type: rankingTypes.columnWindows },
+    ], needs: [] },
+    { name: rankingProducers.appendColumnWindow.name, inputs: [
+      { name: "set", type: rankingTypes.columnWindows }, { name: "spec", type: rankingTypes.itemSpec },
+      { name: "window", type: temporalTypes.window },
+    ], 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: "outer", type: temporalTypes.window }, { name: "windows", type: rankingTypes.columnWindows },
+    ], outputs: [{ name: "schedule", type: rankingTypes.schedule }], needs: [] },
+    ...([
+      [rankingProducers.createTierItems, rankingTypes.tierItems],
+      [rankingProducers.createColumnItems, rankingTypes.columnItems],
+      [rankingProducers.createTopThreeItems, rankingTypes.topThreeItems],
+    ] as const).map(([producer, type]) => ({
+      name: producer.name, inputs: [], outputs: [{ name: "set", type }], needs: [],
+    })),
+    { name: rankingProducers.appendTierItem.name, inputs: [{ name: "set", type: rankingTypes.tierItems }, { name: "spec", type: rankingTypes.itemSpec }, { name: "icon", type: mediaTypes.blobArtifact }], outputs: [{ name: "set", type: rankingTypes.tierItems }], needs: [] },
+    ...([
+      [rankingProducers.appendColumnItem, rankingTypes.columnItems],
+      [rankingProducers.appendTopThreeItem, rankingTypes.topThreeItems],
+    ] as const).map(([producer, type]) => ({
+      name: producer.name, inputs: [{ name: "set", type }, { name: "spec", type: rankingTypes.itemSpec }], outputs: [{ name: "set", type }], needs: [],
+    })),
+    ...([
+      [rankingProducers.appendColumnIconItem, rankingTypes.columnItems],
+      [rankingProducers.appendTopThreeIconItem, rankingTypes.topThreeItems],
+    ] as const).map(([producer, type]) => ({
+      name: producer.name, inputs: [{ name: "set", type }, { name: "spec", type: rankingTypes.itemSpec }, { name: "icon", type: mediaTypes.blobArtifact }], outputs: [{ name: "set", type }], needs: [],
+    })),
+    ...programDefinitions.flatMap(([programType, styleType, setType, programProducer, eventProducer, renderProducer]) => [
+      { name: programProducer.name, inputs: [
+        { name: "header", type: rankingTypes.header },
+        ...(programType === rankingTypes.columnProgram || programType === rankingTypes.tierProgram
+          ? [{ name: "canvas", type: spatialTypes.canvas }] : []),
+        { name: "frame", type: spatialTypes.frame }, { name: "schedule", type: rankingTypes.schedule },
+        { name: "style", type: styleType }, { name: "set", type: setType },
+      ], outputs: [{ name: "program", type: programType }], needs: [] },
+      { 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: rankingProducers.createSounds.name, inputs: [], outputs: [{ name: "sounds", type: rankingTypes.sounds }], needs: [] },
+    ...([
+      rankingProducers.appendAppearSound,
+      rankingProducers.appendMoveSound,
+    ] as const).map((producer) => ({
+      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: "style", type: rankingTypes.soundStyle }, { name: "sounds", type: rankingTypes.sounds },
+    ], outputs: [{ name: "track", type: compositionTypes.audioTrack }], needs: [] },
+  ],
+};
+
+export const rankingDependency = { module: rankingModuleRef } as const;