Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
refactor: require named temporal values at component boundaries
kashorin682b221c81b4
diff --git a/examples/complex-explainer/README.md b/examples/complex-explainer/README.mdindex 92a92db9..56da0514 100644--- a/examples/complex-explainer/README.md+++ b/examples/complex-explainer/README.md@@ -68,7 +68,7 @@ explains joining exported parts. The archive also includes `productions/explaine| What is said, and which words motivate a change? | [Script](productions/explainer/authors/script.svml) || Which raw resources, clock and canvas are used? | [Assets](productions/explainer/authors/assets.svml) || What directed the accepted performance? | [Direction](productions/explainer/authors/direction.svml), [performance Recipe](productions/explainer/recipes/performance.svs) |-| How are Takes, Uses, events and contributions assembled? | [Main Source](productions/explainer/authors/main.svml) |+| How are media occurrences, Uses, events and contributions assembled? | [Main Source](productions/explainer/authors/main.svml) || How does the Caption look? | [Composition Recipe](productions/explainer/recipes/composition.svs) || How does each coordinated scene behave? | [Web scenes](packages/web-scenes/README.md) || How do the presenter and opening graphics move? | [Opening system](packages/opening-system/README.md) |@@ -78,7 +78,7 @@ explains joining exported parts. The archive also includes `productions/explaineGenerated and normalized Outputs remain in the entry Source where the Run can satisfy them explicitly.Changing a cue break or graphic event does not require replacing the performance. A rewrite of the-spoken words is different: supply a new Take with timing for that Script and select it in the Run.+spoken words is different: supply new performance media with timing for that Script and select it in the Run.The retained generation declarations show the original direction but are not invoked by the defaultRun. Configure an explicitly chosen Model/Provider path before requesting new material.diff --git a/examples/complex-explainer/packages/launch-scenes/src/activation.js b/examples/complex-explainer/packages/launch-scenes/src/activation.jsindex 2dd565b1..399fa21c 100644--- a/examples/complex-explainer/packages/launch-scenes/src/activation.js+++ b/examples/complex-explainer/packages/launch-scenes/src/activation.js@@ -12,8 +12,8 @@ import { spatialTypes } from "@hypit/hypit/spatial";import { temporalTypes, assertTemporalInstantFor } from "@hypit/hypit/temporal";import {resolveTemporalContext,- createTemporalWindowConstruction,- createTemporalInstantConstruction,+ resolveTemporalWindowReference,+ resolveTemporalInstantReference,temporalWindowAttributeNames,temporalWindowAttributeVocabulary,temporalContextAttributeVocabulary,@@ -147,13 +147,7 @@ function decode(tag) {]);const id = textAttribute(element, "id"),context = resolveTemporalContext({ element, resolveReference }),- window = createTemporalWindowConstruction({- id: id + ".window",- subjectId: id,- element,- ...context,- resolveReference,- });+ window = resolveTemporalWindowReference({ element, resolveReference });const ref = (el, n, t) => {const raw = el.attributes[n];if (typeof raw !== "object" || raw.kind !== "reference")@@ -170,16 +164,13 @@ function decode(tag) {}if (!Number.isSafeInteger(opts.z)) throw Error("z must be integer");const records = [- ...window.records,{id: id + ".options",type: options,value: value(opts),range: element.range,},- ],- components = [...window.components],- fragments = [...window.fragments];+ ];const inputs = ins(tag).filter((p) => p.name !== "events"),bindings = {timeline: context.timeline.ref,@@ -212,21 +203,13 @@ function decode(tag) {const name = textAttribute(ch, "name"),key = "beat" + ++count,eid = id + "." + key,- at = createTemporalInstantConstruction({- id: eid,- subjectId: eid,- element: ch,- ...context,- resolveReference,- });- records.push(...at.records, {+ at = resolveTemporalInstantReference({ element: ch, resolveReference });+ records.push({id: eid + ".options",type: options,value: value({ id: eid, name }),range: ch.range,});- components.push(...at.components);- fragments.push(...at.fragments);inputs.push(port(key, options), port(key + "-at", temporalTypes.instant));bindings[key] = { kind: "record", id: eid + ".options" };bindings[key + "-at"] = at.ref;@@ -269,9 +252,8 @@ function decode(tag) {});return {records,- fragments: [...fragments, fragment],+ fragments: [fragment],components: [- ...components,{id,fragment: fragment.id,@@ -302,11 +284,6 @@ export const hypitPackage = {options,events,compositionTypes.visualTrack,- temporalTypes.window,- temporalTypes.instant,- temporalTypes.windowSpec,- temporalTypes.instantSpec,- temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec,],vocabulary: {summary: "Project launch scene with phrase-driven visual beats.",diff --git a/examples/complex-explainer/packages/opening-system/README.md b/examples/complex-explainer/packages/opening-system/README.mdindex 86b97767..0a658eaf 100644--- a/examples/complex-explainer/packages/opening-system/README.md+++ b/examples/complex-explainer/packages/opening-system/README.md@@ -3,7 +3,7 @@Project components for an explanation-led video. They share the film's Timeline and Canvas but own independent visual behavior. Connect each visual output to Film explicitly. They produce no audio.- **Title**: opening clock and a two-level headline in a pink window card. Existing presenter footage continues beneath it at its original brightness. Its outer Window ends on the authored “开始” Moment in this production. `seconds` is the promise printed on the title, not the estimated duration of the film.-- **Timer**: a persistent topic plaque, pennant and dot-matrix timer. Its Window's first frame starts the countdown; zero is followed by coral overtime counting upward. `title`, `subtitle`, `seconds`, `flag-color`, `x`, `y`, `width`, `flag-amplitude`, `flag-speed`, `entrance-frames` and `z` are author choices. It does not infer pauses from speech or stop when a Take is absent.+- **Timer**: a persistent topic plaque, pennant and dot-matrix timer. Its Window's first frame starts the countdown; zero is followed by coral overtime counting upward. `title`, `subtitle`, `seconds`, `flag-color`, `x`, `y`, `width`, `flag-amplitude`, `flag-speed`, `entrance-frames` and `z` are author choices. It does not infer pauses from speech or stop when performance media is absent.- **Flag**: an independent low-angle pixel flag. It uses the same deterministic pixel texture treatment as Timer, with its own Window, placement, dimensions and color. No relationship to the opposition boards is inferred. The current Source places it below captions during the first-road explanation. `flag-amplitude` and `flag-speed` keep the folds slow and the logo readable.- **Stage**: independent images or normalized videos in a clear foreground viewport, with the same material enlarged, blurred and dimmed behind it. Each Item has its own projected Window. Foreground and background share exact video sampling. An image is held during its Window. Later declared Items paint above earlier ones if they overlap. Empty intervals stay empty. `fit="contain"` preserves the supplied screenshot; `cover` fills and crops. `x`, `y`, `width`, `height` are fractions of Canvas dimensions. `blur` is specified at a reference width of 1080 and scales with Canvas width. `brightness`, `zoom`, `radius` and `z` finish the treatment.@@ -49,7 +49,7 @@ Earlier texture studies are retained in private production history. The active S### Opening pullback as a Presenter Use-`<gfx:Pullback id="opening-pullback" scale="1.5"/>` defines one project-owned Presenter treatment. Apply it with `<gfx:Use from="0f" until="1s" style={opening-pullback}/>` inside `<gfx:Presenter>`, after the broad full-frame Use. Its original Use Window drives a quartic ease-out from 1.5× to 1×, centered at 50%/35%; footage keeps its source clock. At the end it meets ordinary full-frame geometry. Titles and other contributions stay independent. This changes framing, not playback speed or generated material.+`<gfx:Pullback id="opening-pullback" scale="1.5"/>` defines one project-owned Presenter treatment. Declare its absolute Window once, then apply it with `<gfx:Use during={opening-pullback-window} style={opening-pullback}/>` inside `<gfx:Presenter>`, after the broad full-frame Use. That named Window drives a quartic ease-out from 1.5× to 1×, centered at 50%/35%; footage keeps its source clock. At the end it meets ordinary full-frame geometry. Titles and other contributions stay independent. This changes framing, not playback speed or generated material.## Portrait inset`<gfx:PortraitInset id="host-small" frame={host-inset}/>` is a project Presenter treatment for a circular viewport with a closer inner crop. It receives the Presenter component's explicit Sources, clips each interval, and preserves playback from each Source Window. The external Frame controls position and size; this work uses 330px. An inner 1.23× magnification, anchored at 50%/28%, increases face presence independently from viewport size. Its vivid-pink rim, dark outline and solid offset shadow match the supplied pink interface reference. This is independent from full-frame and Reframe Uses.diff --git a/examples/complex-explainer/packages/opening-system/src/activation.js b/examples/complex-explainer/packages/opening-system/src/activation.jsindex 58d3ce8b..f81b866b 100644--- a/examples/complex-explainer/packages/opening-system/src/activation.js+++ b/examples/complex-explainer/packages/opening-system/src/activation.js@@ -15,8 +15,8 @@ import { spatialTypes } from "@hypit/hypit/spatial";import { temporalTypes } from "@hypit/hypit/temporal";import { visualTrackModuleRef } from "@hypit/visual-track";import {- createTemporalWindowConstruction,- createTemporalInstantConstruction,+ resolveTemporalWindowReference,+ resolveTemporalInstantReference,resolveTemporalContext,temporalWindowAttributeNames,temporalWindowAttributeVocabulary,@@ -198,13 +198,7 @@ function decode(kind) {]);const id = textAttribute(element, "id"),context = resolveTemporalContext({ element, resolveReference });- const win = createTemporalWindowConstruction({- id: id + ".window",- subjectId: id,- element,- ...context,- resolveReference,- });+ const win = resolveTemporalWindowReference({ element, resolveReference });const ref = (el, name, t) => {const raw = el.attributes[name];if (typeof raw !== "object" || raw.kind !== "reference")@@ -262,16 +256,13 @@ function decode(kind) {"Veil needs mesh/dots/hatch, positive cell size, opacity from zero to one, and a nonnegative fade frame count",);const records = [- ...win.records,{id: id + ".options",type: optionsType,value: val(o),range: element.range,},- ],- components = [...win.components],- fragments = [...win.fragments];+ ];const inputs = [...common],bindings = {timeline: context.timeline.ref,@@ -280,17 +271,11 @@ function decode(kind) {options: { kind: "record", id: id + ".options" },};if (kind === "Title") {- const bounce = createTemporalInstantConstruction({- id: id + ".bounce", subjectId: id + ".bounce",- element: { ...element, attributes: { at: element.attributes["bounce-at"] ?? "timeline.start" } },- ...context, resolveReference,- });- records.push(...bounce.records); components.push(...bounce.components); fragments.push(...bounce.fragments);+ const bounce = resolveTemporalInstantReference({ element, resolveReference, attribute: "bounce-at" });inputs.push(port("bounce", temporalTypes.instant)); bindings.bounce = bounce.ref;}if (kind === "Timer") {- const stop = createTemporalInstantConstruction({id:id+".stop",subjectId:id+".stop",element:{...element,attributes:{at:element.attributes["stop-at"]??"timeline.end"}},...context,resolveReference});- records.push(...stop.records);components.push(...stop.components);fragments.push(...stop.fragments);+ const stop = resolveTemporalInstantReference({ element, resolveReference, attribute: "stop-at" });inputs.push(port("stop",temporalTypes.instant));bindings.stop=stop.ref;}const input = (name) => ({ kind: "fragment-input", name }),@@ -324,16 +309,7 @@ function decode(kind) {isImage = child.attributes.image !== undefined;if (isImage === (child.attributes.video !== undefined))throw Error("Item needs exactly one image or normalized video");- const iw = createTemporalWindowConstruction({- id: `${id}.${cid}.window`,- subjectId: cid,- element: child,- ...context,- resolveReference,- });- records.push(...iw.records);- components.push(...iw.components);- fragments.push(...iw.fragments);+ const iw = resolveTemporalWindowReference({ element: child, resolveReference });const key = "item" + ++n,optsId = id + "." + key,sourceStart = Number(child.attributes["source-start-frame"] ?? 0);@@ -414,9 +390,8 @@ function decode(kind) {});return {records,- fragments: [...fragments, fragment],+ fragments: [fragment],components: [- ...components,{id,fragment: fragment.id,@@ -437,12 +412,6 @@ const declarations = Object.keys(defaults).map((tag) => ({optionsType,itemsType,compositionTypes.visualTrack,- timelineTypes.timeline,- temporalTypes.window,- temporalTypes.instant,- temporalTypes.windowSpec,- temporalTypes.instantSpec,- temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec,],vocabulary: {summary: {@@ -456,8 +425,8 @@ const declarations = Object.keys(defaults).map((tag) => ({"Clear foreground media with the same moving picture enlarged, blurred and dimmed behind it.",}[tag],attributes: [- ...(tag === "Title" ? [{ name: "bounce-at", kind: "expression", required: false, summary: "Moment or time when the title jumps." }] : []),- ...(tag === "Timer" ? [{name:"stop-at",kind:"expression",required:false,summary:"Freeze the overtime display and flash on this instant."}] : []),+ ...(tag === "Title" ? [{ name: "bounce-at", kind: "reference", required: true, accepts: [temporalTypes.instant], summary: "Resolved Instant when the title jumps." }] : []),+ ...(tag === "Timer" ? [{name:"stop-at",kind:"reference",required:true,accepts:[temporalTypes.instant],summary:"Resolved Instant that freezes the overtime display and flashes."}] : []),...temporalContextAttributeVocabulary,...temporalWindowAttributeVocabulary,...[diff --git a/examples/complex-explainer/packages/opening-system/src/presenter.js b/examples/complex-explainer/packages/opening-system/src/presenter.jsindex af84d294..b2658101 100644--- a/examples/complex-explainer/packages/opening-system/src/presenter.js+++ b/examples/complex-explainer/packages/opening-system/src/presenter.js@@ -7,7 +7,7 @@ import { spatialTypes } from "@hypit/hypit/spatial";import { recipeType } from "@hypit/hypit/recipe";import { temporalTypes, assertTemporalWindowFor } from "@hypit/hypit/temporal";import {- createTemporalWindowConstruction,+ resolveTemporalWindowReference,resolveTemporalContext,temporalWindowAttributeNames,temporalWindowAttributeVocabulary,@@ -226,7 +226,7 @@ export function installPresenter(module, manifest, component) {});const stackingOrder = recipeValue.properties["stack-order"];if (!Number.isSafeInteger(stackingOrder)) throw Error(`Presenter appearance ${recipeValue.path} requires integer stack-order.`);- const sampleKeys = [...visualMaterialKeys.fit, ...visualMaterialKeys.sample, ...visualMaterialKeys.sourceTime, ...visualMaterialKeys.frame];+ const sampleKeys = [...visualMaterialKeys.fit, ...visualMaterialKeys.sample, ...visualMaterialKeys.frame];const treatmentKeys = [...visualMaterialKeys.sample, ...visualMaterialKeys.frame];const style = presenterStyle(ordinaryFragment, {frame,@@ -244,13 +244,6 @@ export function installPresenter(module, manifest, component) {types.sourceSpec,types.sources,types.program,- temporalTypes.duration,- temporalTypes.extent,- temporalTypes.shiftSpec,- temporalTypes.instantSpec,- temporalTypes.windowSpec,- temporalTypes.instant,- temporalTypes.window,compositionTypes.visualTrack,],vocabulary: { summary: "Continuing presenter role owned by the explainer project.", attributes: [@@ -320,10 +313,7 @@ export function installPresenter(module, manifest, component) {for (const [index, child] of uses.entries()) {assertAttributes(child, ["id", "style", ...temporalWindowAttributeNames]); assertEmptyElement(child);const useId = optionalTextAttribute(child, "id") ?? `${id}.use.${index + 1}`;- const hasTime = temporalWindowAttributeNames.some((name) => child.attributes[name] !== undefined);- const temporal = createTemporalWindowConstruction({ id: useId, ...context, resolveReference,- element: hasTime ? child : { ...child, attributes: { ...child.attributes, during: "timeline" } } });- records.push(...temporal.records); components.push(...temporal.components); fragments.push(...temporal.fragments);+ const temporal = resolveTemporalWindowReference({ element: child, resolveReference });const style = authored(ref(child, "style", types.style, resolveReference), "Presenter Style");fragments.push(style.fragment);const needsWithin = style.fragment.inputs.some((port) => port.name === "within");diff --git a/examples/complex-explainer/packages/web-scenes/README.md b/examples/complex-explainer/packages/web-scenes/README.mdindex dccd9cb0..5d2f4251 100644--- a/examples/complex-explainer/packages/web-scenes/README.md+++ b/examples/complex-explainer/packages/web-scenes/README.md@@ -21,7 +21,7 @@ Each folder owns `index.js` (content and resource slots), `styles.js` (appearancEach Surface receives Timeline, Canvas, font, a temporal Window, its explicit assets and named `Beat` children. The Source attaches those events to Script Moments or authored time. The Surface uses the public temporal projection helpers; local animation reads the resulting event frames. Seek any frame directly: pointer paths, springs, typing and transitions derive state from time.-Prepared video inputs are SynchronizedMedia. Image inputs are Blob artifacts. `DeliveryWorkshop.reference` is the fictional drinking illustration; it is deliberately an image, without fabricating a silent Take or video. Media entries explicitly choose native playback, holding the last frame or looping where the scene needs it.+Prepared video inputs are SynchronizedMedia. Image inputs are Blob artifacts. `DeliveryWorkshop.reference` is the fictional drinking illustration; it is deliberately an image, without fabricating silent performance media or video. Media entries explicitly choose native playback, holding the last frame or looping where the scene needs it.Shared ordinary modules under `src/shared/` own html-visual assembly and media sampling, visual primitives, the route cards, terminal behavior and editor artwork. `@explainer/visual-language` supplies common palette and motion helpers. These code dependencies are not automatically separate Film Tracks.diff --git a/examples/complex-explainer/packages/web-scenes/src/activation.js b/examples/complex-explainer/packages/web-scenes/src/activation.jsindex 15325a53..9b7221ca 100644--- a/examples/complex-explainer/packages/web-scenes/src/activation.js+++ b/examples/complex-explainer/packages/web-scenes/src/activation.js@@ -18,8 +18,8 @@ import { spatialTypes } from "@hypit/hypit/spatial";import { temporalTypes, assertTemporalInstantFor } from "@hypit/hypit/temporal";import {resolveTemporalContext,- createTemporalWindowConstruction,- createTemporalInstantConstruction,+ resolveTemporalWindowReference,+ resolveTemporalInstantReference,temporalWindowAttributeNames,temporalWindowAttributeVocabulary,temporalContextAttributeVocabulary,@@ -270,13 +270,7 @@ function decode(tag) {]);const id = textAttribute(element, "id"),context = resolveTemporalContext({ element, resolveReference }),- window = createTemporalWindowConstruction({- id: id + ".window",- subjectId: id,- element,- ...context,- resolveReference,- });+ window = resolveTemporalWindowReference({ element, resolveReference });const ref = (el, n, t) => {const raw = el.attributes[n];if (typeof raw !== "object" || raw.kind !== "reference")@@ -293,16 +287,13 @@ function decode(tag) {}if (!Number.isSafeInteger(opts.z)) throw Error("z must be integer");const records = [- ...window.records,{id: id + ".options",type: options,value: value(opts),range: element.range,},- ],- components = [...window.components],- fragments = [...window.fragments];+ ];const inputs = ins(tag).filter((p) => p.name !== "events"),bindings = {timeline: context.timeline.ref,@@ -335,21 +326,13 @@ function decode(tag) {const name = textAttribute(ch, "name"),key = "beat" + ++count,eid = id + "." + key,- at = createTemporalInstantConstruction({- id: eid,- subjectId: eid,- element: ch,- ...context,- resolveReference,- });- records.push(...at.records, {+ at = resolveTemporalInstantReference({ element: ch, resolveReference });+ records.push({id: eid + ".options",type: options,value: value({ id: eid, name }),range: ch.range,});- components.push(...at.components);- fragments.push(...at.fragments);inputs.push(port(key, options), port(key + "-at", temporalTypes.instant));bindings[key] = { kind: "record", id: eid + ".options" };bindings[key + "-at"] = at.ref;@@ -392,9 +375,8 @@ function decode(tag) {});return {records,- fragments: [...fragments, fragment],+ fragments: [fragment],components: [- ...components,{id,fragment: fragment.id,@@ -425,11 +407,6 @@ export const hypitPackage = {options,events,compositionTypes.visualTrack,- temporalTypes.window,- temporalTypes.instant,- temporalTypes.windowSpec,- temporalTypes.instantSpec,- temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec,],vocabulary: {summary: "Project launch scene with phrase-driven visual beats.",diff --git a/examples/complex-explainer/productions/explainer/BRIEF.md b/examples/complex-explainer/productions/explainer/BRIEF.mdindex 85fe8ab2..78a88147 100644--- a/examples/complex-explainer/productions/explainer/BRIEF.md+++ b/examples/complex-explainer/productions/explainer/BRIEF.md@@ -2,7 +2,7 @@Produce a lively Chinese explanation of Hypit, using the reference’s alternating presenter and MG structure with the owner’s supplied AI presenter and voice. The accepted direction is pink retro pixel graphics, actual website demonstrations, clear comparisons and expressive full-frame moments.-The completed composition is 1080 × 1920, 30 fps, 4,112 frames (137.067 seconds). Seventeen prepared Takes supply the performance and its semantic anchors. An opening 1.5-second gap carries the four-image montage; a two-second tail carries the closing graphic without a fabricated Take.+The completed composition is 1080 × 1920, 30 fps, 4,112 frames (137.067 seconds). Seventeen prepared performance clips supply the spoken material and its semantic anchors. An opening 1.5-second gap carries the four-image montage; a two-second tail carries the closing graphic without fabricated performance media.This production is being organized as a complex spoken-video example. Preserve the accepted visual direction while making the Sources, project components and explicit material reuse understandable. Separate independent behavior; expose parameters only for actual author choices.diff --git a/examples/complex-explainer/productions/explainer/CRAFT-NOTES.md b/examples/complex-explainer/productions/explainer/CRAFT-NOTES.mdindex ae7236f8..3c547262 100644--- a/examples/complex-explainer/productions/explainer/CRAFT-NOTES.md+++ b/examples/complex-explainer/productions/explainer/CRAFT-NOTES.md@@ -52,7 +52,7 @@ drag and return from that frame, sharing the object's displacement with the poincomponent's vocabulary, not a special event known to Hypit. Moving the spoken anchor changes whenthe event happens; changing the animation changes how it feels.-This also explains why one Take need not equal one scene. The editor develops across several spoken+This also explains why one generated clip need not equal one scene. The editor develops across several spokenpassages, while a single passage can trigger several states. Keep the temporal cause separate fromthe scope of the objects that respond to it.@@ -64,10 +64,10 @@ The camera presentation changes while the source playback continues. The[opening system](../../packages/opening-system/README.md) owns these Styles; Main Source owns wherethey are used. Foreground and enlarged background presentations likewise share the same media sample.-Covering the presenter with MG does not require producing a new audio-only Take: the voice remains+Covering the presenter with MG does not require producing a new audio-only performance: the voice remainsconnected separately. The opening montage and silent ending occupy authored Timeline space outsidespoken coverage. They do not need fake empty media. An actual acted drinking passage is different:-it has performed material whose actions and eventual words belong to its Take.+it has performed material whose actions and eventual words belong to that clip.## Material quality starts in directiondiff --git a/examples/complex-explainer/productions/explainer/README.md b/examples/complex-explainer/productions/explainer/README.mdindex e2d312c2..bedcd617 100644--- a/examples/complex-explainer/productions/explainer/README.md+++ b/examples/complex-explainer/productions/explainer/README.md@@ -1,6 +1,6 @@# Complex spoken explainer-A 137-second Chinese explainer built from 17 accepted Takes, recorded demonstrations, project-owned MG, independent Caption and sound. The example demonstrates useful component boundaries without turning every design constant into a public parameter.+A 137-second Chinese explainer built from 17 accepted performance clips, recorded demonstrations, project-owned MG, independent Caption and sound. The example demonstrates useful component boundaries without turning every design constant into a public parameter.## Start here@@ -21,7 +21,7 @@ The current production Run explicitly selects accepted Outputs. Read the plan be| Spoken words, cue breaks, Moments and Selections | `authors/script.svml` || Input images, recordings, fonts and clock/canvas | `authors/assets.svml` || Performance prompt and selected speaker Kit | `authors/direction.svml`, `recipes/performance.svs` |-| Material outputs, Take placement, Uses, scene events and Film | `authors/main.svml` |+| Material outputs, media placement, Uses, scene events and Film | `authors/main.svml` || Caption appearance and ordinary presentation | `recipes/composition.svs` || A coordinated visual behavior | The owning project package under `../../packages/` || Which accepted output is used | `runs/render.svrun` |diff --git a/examples/complex-explainer/productions/explainer/authors/main.svml b/examples/complex-explainer/productions/explainer/authors/main.svmlindex c2f2531b..b499f0ff 100644--- a/examples/complex-explainer/productions/explainer/authors/main.svml+++ b/examples/complex-explainer/productions/explainer/authors/main.svml@@ -325,6 +325,72 @@<semantic:Instant id="moment-result-brand-cue" moment={copy.story.moment.result-brand}/><semantic:Instant id="moment-outro-copy-cue" moment={copy.story.moment.outro-copy}/></semantic:Projection>+ <!-- Absolute presentation windows are named once; components only consume them. -->+ <time:Window id="opening-title-window" timeline={program.timeline} from="start" until={story-time.moment-begin-cue}/>+ <time:Window id="road-flag-window" timeline={program.timeline} from={story-time.moment-road-overview-cue} until={story-time.segment-timing-cost-end}/>+ <time:Window id="closing-road-flag-window" timeline={program.timeline} from={story-time.segment-synthesis-start} until={story-time.segment-closing-start}/>+ <time:Window id="series-timer-window" timeline={program.timeline} from={story-time.moment-begin-cue} until="end"/>+ <time:Window id="opening-montage-window" timeline={program.timeline} from={story-time.segment-opening-end} until={story-time.segment-opening-end-plus-1-5s}/>+ <time:Window id="montage-image-1-window" timeline={program.timeline} from={story-time.segment-opening-end-plus-0f} until={story-time.segment-opening-end-plus-5f}/>+ <time:Window id="montage-image-2-window" timeline={program.timeline} from={story-time.segment-opening-end-plus-5f} until={story-time.segment-opening-end-plus-9f}/>+ <time:Window id="montage-image-3-window" timeline={program.timeline} from={story-time.segment-opening-end-plus-9f} until={story-time.segment-opening-end-plus-14f}/>+ <time:Window id="montage-image-4-window" timeline={program.timeline} from={story-time.segment-opening-end-plus-14f} until={story-time.segment-opening-end-plus-45f}/>+ <time:Window id="host-small-from-introduction" timeline={program.timeline} from={story-time.segment-introduction-start} until="end"/>+ <time:Window id="opening-pullback-window" timeline={program.timeline} from="0f" until="1s"/>+ <time:Window id="two-roads-pullback-window" timeline={program.timeline} from={story-time.segment-two-roads-start} until={story-time.segment-two-roads-start-plus-1s}/>+ <time:Window id="host-upper-road-window" timeline={program.timeline} from={story-time.moment-road-half-cue} until={story-time.moment-road-overview-cue}/>+ <time:Window id="host-rise-window" timeline={program.timeline} from={story-time.moment-road-half-cue} for="14f"/>+ <time:Window id="host-small-road-window" timeline={program.timeline} from={story-time.moment-road-overview-cue} until={story-time.segment-two-roads-end}/>+ <time:Window id="host-small-resume-window" timeline={program.timeline} from={story-time.moment-resume-cue} until="end"/>+ <time:Window id="host-resume-window" timeline={program.timeline} from={story-time.moment-resume-cue} for="18f"/>+ <time:Window id="closing-pullback-window" timeline={program.timeline} from={story-time.segment-closing-start} until={story-time.segment-closing-start-plus-1s}/>+ <time:Window id="host-small-outro-window" timeline={program.timeline} from={story-time.moment-outro-github-cue} until={story-time.moment-outro-bye-cue}/>+ <time:Window id="host-hidden-result-window" timeline={program.timeline} from={story-time.moment-result-guess-cue} until={story-time.segment-reference-reveal-end}/>+ <time:Window id="host-fade-window" timeline={program.timeline} from={story-time.segment-closing-end-minus-12f} until={story-time.segment-closing-end}/>+ <time:Window id="host-hidden-after-closing-window" timeline={program.timeline} from={story-time.segment-closing-end} until="end"/>+ <time:Window id="editor-journey-window" timeline={program.timeline} from={story-time.segment-two-roads-start} until={story-time.segment-keyframe-cost-end}/>+ <time:Window id="code-journey-window" timeline={program.timeline} from={story-time.segment-code-road-start} until={story-time.segment-synthesis-end}/>+ <time:Window id="semantic-workshop-window" timeline={program.timeline} from={story-time.segment-semantic-time-start} until={story-time.segment-semantic-demo-end}/>+ <time:Window id="delivery-workshop-window" timeline={program.timeline} from={story-time.segment-result-start} until={story-time.segment-reference-reveal-end}/>+ <time:Window id="outro-scene-window" timeline={program.timeline} from={story-time.segment-closing-start} until="end"/>+ <time:Window id="sfx-intro-codex-window" timeline={program.timeline} from={story-time.moment-intro-codex-cue} for="0.24s"/>+ <time:Window id="sfx-intro-claude-window" timeline={program.timeline} from={story-time.moment-intro-claude-cue} for="0.24s"/>+ <time:Window id="sfx-intro-examples-window" timeline={program.timeline} from={story-time.moment-intro-examples-cue} for="0.36s"/>+ <time:Window id="sfx-intro-face-window" timeline={program.timeline} from={story-time.moment-intro-face-cue} for="0.48s"/>+ <time:Window id="sfx-competitor-monthly-window" timeline={program.timeline} from={story-time.moment-competitor-monthly-cue} for="0.12s"/>+ <time:Window id="sfx-competitor-watermark-window" timeline={program.timeline} from={story-time.moment-competitor-watermark-cue} for="0.65s"/>+ <time:Window id="sfx-roads-window" timeline={program.timeline} from={story-time.moment-roads-cue} for="0.26s"/>+ <time:Window id="sfx-road-assets-window" timeline={program.timeline} from={story-time.moment-road-assets-cue} for="0.24s"/>+ <time:Window id="sfx-road-drag-window" timeline={program.timeline} from={story-time.moment-road-drag-cue} for="0.12s"/>+ <time:Window id="sfx-road-fail-window" timeline={program.timeline} from={story-time.moment-road-fail-cue} for="0.4s"/>+ <time:Window id="sfx-road-number-window" timeline={program.timeline} from={story-time.moment-road-number-cue} for="0.24s"/>+ <time:Window id="sfx-road-image-window" timeline={program.timeline} from={story-time.moment-road-image-cue} for="0.36s"/>+ <time:Window id="sfx-road-keys-window" timeline={program.timeline} from={story-time.moment-road-keys-cue} for="0.65s"/>+ <time:Window id="sfx-road-tokens-window" timeline={program.timeline} from={story-time.moment-road-tokens-cue} for="0.65s"/>+ <time:Window id="sfx-code-play-window" timeline={program.timeline} from={story-time.moment-code-play-cue} for="0.24s"/>+ <time:Window id="sfx-code-duplicate-window" timeline={program.timeline} from={story-time.moment-code-duplicate-cue} for="0.65s"/>+ <time:Window id="sfx-solution-keep-window" timeline={program.timeline} from={story-time.moment-solution-keep-cue} for="0.48s"/>+ <time:Window id="sfx-solution-drop-window" timeline={program.timeline} from={story-time.moment-solution-drop-cue} for="0.36s"/>+ <time:Window id="sfx-part-caption-window" timeline={program.timeline} from={story-time.moment-part-caption-cue} for="0.12s"/>+ <time:Window id="sfx-part-ranking-window" timeline={program.timeline} from={story-time.moment-part-ranking-cue} for="0.12s"/>+ <time:Window id="sfx-part-chart-window" timeline={program.timeline} from={story-time.moment-part-chart-cue} for="0.12s"/>+ <time:Window id="sfx-part-card-window" timeline={program.timeline} from={story-time.moment-part-card-cue} for="0.12s"/>+ <time:Window id="sfx-parts-library-window" timeline={program.timeline} from={story-time.moment-parts-library-cue} for="0.26s"/>+ <time:Window id="sfx-parts-reuse-window" timeline={program.timeline} from={story-time.moment-parts-reuse-cue} for="0.48s"/>+ <time:Window id="sfx-parts-swap-window" timeline={program.timeline} from={story-time.moment-parts-swap-cue} for="0.36s"/>+ <time:Window id="sfx-rank-reveal-window" timeline={program.timeline} from={story-time.moment-rank-reveal-cue} for="0.26s"/>+ <time:Window id="sfx-product-reveal-window" timeline={program.timeline} from={story-time.moment-product-reveal-cue} for="0.24s"/>+ <time:Window id="sfx-sem-voice-window" timeline={program.timeline} from={story-time.moment-sem-voice-cue} for="0.12s"/>+ <time:Window id="sfx-sem-adapt-window" timeline={program.timeline} from={story-time.moment-sem-adapt-cue} for="0.48s"/>+ <time:Window id="sfx-result-assets-window" timeline={program.timeline} from={story-time.moment-result-assets-cue} for="0.72s"/>+ <time:Window id="sfx-result-meta-window" timeline={program.timeline} from={story-time.moment-result-meta-cue} for="0.36s"/>+ <time:Window id="sfx-outro-install-window" timeline={program.timeline} from={story-time.moment-outro-install-cue} for="0.12s"/>+ <time:Window id="sfx-outro-gift-window" timeline={program.timeline} from={story-time.moment-outro-gift-cue} for="0.48s"/>+ <time:Window id="sfx-outro-bye-window" timeline={program.timeline} from={story-time.moment-outro-bye-cue} for="0.72s"/>+ <time:Window id="sfx-montage-1-window" timeline={program.timeline} from={story-time.segment-opening-end-plus-0f} until={story-time.segment-opening-end-plus-4f}/>+ <time:Window id="sfx-montage-2-window" timeline={program.timeline} from={story-time.segment-opening-end-plus-5f} until={story-time.segment-opening-end-plus-9f}/>+ <time:Window id="sfx-montage-3-window" timeline={program.timeline} from={story-time.segment-opening-end-plus-9f} until={story-time.segment-opening-end-plus-13f}/>+ <time:Window id="sfx-montage-4-window" timeline={program.timeline} from={story-time.segment-opening-end-plus-14f} until={story-time.segment-opening-end-plus-28f}/><narrative-caption:Timing id="caption-timing" document={copy.story.caption}binding={copy.story.caption-binding} projection={story-time.projection}/><mediaop:Normalize id="ranking-clone-media" source={assets.ranking-clone} clock={assets.clock} video="primary-moving" audio="none" span-authority="video"/>@@ -335,15 +401,15 @@<mediaop:Normalize id="swap-vehicle-media" source={assets.swap-vehicle} clock={assets.clock} video="primary-moving" audio="none" span-authority="video"/><!-- Opening chrome and independent montage -->- <gfx:Title id="opening-title" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} from="start" until={story-time.moment-begin-cue} bounce-at={story-time.moment-opening-brand-cue} color="#fa67aa" title-y="0.58" title="Hypit" subtitle="一分钟了解" seconds="60"/>- <gfx:Flag id="road-flag" x="0.035" width="0.93" height="0.21" y="0.752" timeline={program.timeline} within={assets.canvas.bounds} logo={assets.flag-logo} from={story-time.moment-road-overview-cue} until={story-time.segment-timing-cost-end}/>- <gfx:Flag id="closing-road-flag" x="0.035" width="0.93" height="0.21" y="0.752" timeline={program.timeline} within={assets.canvas.bounds} logo={assets.flag-logo} from={story-time.segment-synthesis-start} until={story-time.segment-closing-start}/>- <gfx:Timer flag-amplitude="0.06" logo={assets.flag-logo} id="series-timer" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} from={story-time.moment-begin-cue} until="end" stop-at={story-time.moment-outro-overtime-cue} flag-color="#fa67aa" title="Hypit" subtitle="VIDEO FRAMEWORK" seconds="60"/>- <gfx:Stage id="opening-montage" push-rate="0.025" timeline={program.timeline} within={assets.canvas.bounds} from={story-time.segment-opening-end} until={story-time.segment-opening-end-plus-1-5s}>- <gfx:Item id="image-1" image={assets.montage-1} from={story-time.segment-opening-end-plus-0f} until={story-time.segment-opening-end-plus-5f}/>- <gfx:Item id="image-2" image={assets.montage-2} from={story-time.segment-opening-end-plus-5f} until={story-time.segment-opening-end-plus-9f}/>- <gfx:Item id="image-3" image={assets.montage-3} from={story-time.segment-opening-end-plus-9f} until={story-time.segment-opening-end-plus-14f}/>- <gfx:Item id="image-4" image={assets.montage-4} from={story-time.segment-opening-end-plus-14f} until={story-time.segment-opening-end-plus-45f}/>+ <gfx:Title id="opening-title" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} during={opening-title-window} bounce-at={story-time.moment-opening-brand-cue} color="#fa67aa" title-y="0.58" title="Hypit" subtitle="一分钟了解" seconds="60"/>+ <gfx:Flag id="road-flag" x="0.035" width="0.93" height="0.21" y="0.752" timeline={program.timeline} within={assets.canvas.bounds} logo={assets.flag-logo} during={road-flag-window}/>+ <gfx:Flag id="closing-road-flag" x="0.035" width="0.93" height="0.21" y="0.752" timeline={program.timeline} within={assets.canvas.bounds} logo={assets.flag-logo} during={closing-road-flag-window}/>+ <gfx:Timer flag-amplitude="0.06" logo={assets.flag-logo} id="series-timer" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} during={series-timer-window} stop-at={story-time.moment-outro-overtime-cue} flag-color="#fa67aa" title="Hypit" subtitle="VIDEO FRAMEWORK" seconds="60"/>+ <gfx:Stage id="opening-montage" push-rate="0.025" timeline={program.timeline} within={assets.canvas.bounds} during={opening-montage-window}>+ <gfx:Item id="image-1" image={assets.montage-1} during={montage-image-1-window}/>+ <gfx:Item id="image-2" image={assets.montage-2} during={montage-image-2-window}/>+ <gfx:Item id="image-3" image={assets.montage-3} during={montage-image-3-window}/>+ <gfx:Item id="image-4" image={assets.montage-4} during={montage-image-4-window}/></gfx:Stage><!-- Project Presenter: component-local Uses select framing without changing playback -->@@ -376,24 +442,24 @@<gfx:Source id="result-source" media={result-media.media} window={program.result}/><gfx:Source id="reference-reveal-source" media={reference-reveal-media.media} window={program.reference-reveal}/><gfx:Source id="closing-source" media={closing-media.media} window={program.closing}/>- <gfx:Use style={host-small} from={story-time.segment-introduction-start} until="end"/>+ <gfx:Use style={host-small} during={host-small-from-introduction}/><gfx:Use during={story-time.segment-opening} style={host-full}/>- <gfx:Use from="0f" until="1s" style={opening-pullback}/>+ <gfx:Use during={opening-pullback-window} style={opening-pullback}/><gfx:Use during={story-time.segment-two-roads} style={host-full}/>- <gfx:Use from={story-time.segment-two-roads-start} until={story-time.segment-two-roads-start-plus-1s} style={opening-pullback}/>- <gfx:Use from={story-time.moment-road-half-cue} until={story-time.moment-road-overview-cue} style={host-upper}/>- <gfx:Use from={story-time.moment-road-half-cue} for="14f" style={host-rise}/>- <gfx:Use from={story-time.moment-road-overview-cue} until={story-time.segment-two-roads-end} style={host-small}/>+ <gfx:Use during={two-roads-pullback-window} style={opening-pullback}/>+ <gfx:Use during={host-upper-road-window} style={host-upper}/>+ <gfx:Use during={host-rise-window} style={host-rise}/>+ <gfx:Use during={host-small-road-window} style={host-small}/><gfx:Use during={story-time.segment-water-break} style={host-full}/>- <gfx:Use from={story-time.moment-resume-cue} until="end" style={host-small}/>- <gfx:Use from={story-time.moment-resume-cue} for="18f" style={host-resume}/>+ <gfx:Use during={host-small-resume-window} style={host-small}/>+ <gfx:Use during={host-resume-window} style={host-resume}/><gfx:Use during={story-time.segment-closing} style={host-full}/>- <gfx:Use from={story-time.segment-closing-start} until={story-time.segment-closing-start-plus-1s} style={opening-pullback}/>- <gfx:Use from={story-time.moment-outro-github-cue} until={story-time.moment-outro-bye-cue} style={host-small}/>+ <gfx:Use during={closing-pullback-window} style={opening-pullback}/>+ <gfx:Use during={host-small-outro-window} style={host-small}/><gfx:Use during={story-time.segment-timing-cost} style={host-hidden}/>- <gfx:Use from={story-time.moment-result-guess-cue} until={story-time.segment-reference-reveal-end} style={host-hidden}/>- <gfx:Use from={story-time.segment-closing-end-minus-12f} until={story-time.segment-closing-end} style={host-fade}/>- <gfx:Use from={story-time.segment-closing-end} until="end" style={host-hidden}/>+ <gfx:Use during={host-hidden-result-window} style={host-hidden}/>+ <gfx:Use during={host-fade-window} style={host-fade}/>+ <gfx:Use during={host-hidden-after-closing-window} style={host-hidden}/></gfx:Presenter><!-- Voice, music and independently authored effects --><audio:Track id="voice" timeline={program.timeline}>@@ -416,7 +482,7 @@<audio:Clip id="closing-source" source={closing-media.media} during={program.closing}/></audio:Track><audio:Track id="music" timeline={program.timeline}>- <audio:Clip id="bgm" source={bgm-media.media} during="timeline" gain="0.09" fade-in="6f" fade-out="2s"/>+ <audio:Clip id="bgm" source={bgm-media.media} during={program.window} gain="0.09" fade-in="6f" fade-out="2s"/></audio:Track><mediaop:Normalize id="sfx-tap-media" source={assets.sfx-tap} clock={assets.clock} video="none" audio="default" span-authority="audio"/><mediaop:Normalize id="sfx-pop-media" source={assets.sfx-pop} clock={assets.clock} video="none" audio="default" span-authority="audio"/>@@ -427,55 +493,55 @@<mediaop:Normalize id="sfx-spark-media" source={assets.sfx-spark} clock={assets.clock} video="none" audio="default" span-authority="audio"/><mediaop:Normalize id="sfx-finish-media" source={assets.sfx-finish} clock={assets.clock} video="none" audio="default" span-authority="audio"/><audio:Track id="pixel-effects" timeline={program.timeline}>- <audio:Clip id="sfx-intro-codex" source={sfx-pop-media.media} from={story-time.moment-intro-codex-cue} for="0.24s" gain="0.16" fade-out="1f"/>- <audio:Clip id="sfx-intro-claude" source={sfx-pop-media.media} from={story-time.moment-intro-claude-cue} for="0.24s" gain="0.16" fade-out="1f"/>- <audio:Clip id="sfx-intro-examples" source={sfx-swipe-media.media} from={story-time.moment-intro-examples-cue} for="0.36s" gain="0.2" fade-out="1f"/>- <audio:Clip id="sfx-intro-face" source={sfx-spark-media.media} from={story-time.moment-intro-face-cue} for="0.48s" gain="0.13" fade-out="1f"/>- <audio:Clip id="sfx-competitor-monthly" source={sfx-tap-media.media} from={story-time.moment-competitor-monthly-cue} for="0.12s" gain="0.16" fade-out="1f"/>- <audio:Clip id="sfx-competitor-watermark" source={sfx-ticks-media.media} from={story-time.moment-competitor-watermark-cue} for="0.65s" gain="0.13" fade-out="1f"/>- <audio:Clip id="sfx-roads" source={sfx-land-media.media} from={story-time.moment-roads-cue} for="0.26s" gain="0.22" fade-out="1f"/>- <audio:Clip id="sfx-road-assets" source={sfx-pop-media.media} from={story-time.moment-road-assets-cue} for="0.24s" gain="0.15" fade-out="1f"/>- <audio:Clip id="sfx-road-drag" source={sfx-tap-media.media} from={story-time.moment-road-drag-cue} for="0.12s" gain="0.13" fade-out="1f"/>- <audio:Clip id="sfx-road-fail" source={sfx-reject-media.media} from={story-time.moment-road-fail-cue} for="0.4s" gain="0.19" fade-out="1f"/>- <audio:Clip id="sfx-road-number" source={sfx-pop-media.media} from={story-time.moment-road-number-cue} for="0.24s" gain="0.2" fade-out="1f"/>- <audio:Clip id="sfx-road-image" source={sfx-swipe-media.media} from={story-time.moment-road-image-cue} for="0.36s" gain="0.18" fade-out="1f"/>- <audio:Clip id="sfx-road-keys" source={sfx-ticks-media.media} from={story-time.moment-road-keys-cue} for="0.65s" gain="0.13" fade-out="1f"/>- <audio:Clip id="sfx-road-tokens" source={sfx-ticks-media.media} from={story-time.moment-road-tokens-cue} for="0.65s" gain="0.12" fade-out="1f"/>- <audio:Clip id="sfx-code-play" source={sfx-pop-media.media} from={story-time.moment-code-play-cue} for="0.24s" gain="0.16" fade-out="1f"/>- <audio:Clip id="sfx-code-duplicate" source={sfx-ticks-media.media} from={story-time.moment-code-duplicate-cue} for="0.65s" gain="0.12" fade-out="1f"/>- <audio:Clip id="sfx-solution-keep" source={sfx-spark-media.media} from={story-time.moment-solution-keep-cue} for="0.48s" gain="0.19" fade-out="1f"/>- <audio:Clip id="sfx-solution-drop" source={sfx-swipe-media.media} from={story-time.moment-solution-drop-cue} for="0.36s" gain="0.18" fade-out="1f"/>- <audio:Clip id="sfx-part-caption" source={sfx-tap-media.media} from={story-time.moment-part-caption-cue} for="0.12s" gain="0.13" fade-out="1f"/>- <audio:Clip id="sfx-part-ranking" source={sfx-tap-media.media} from={story-time.moment-part-ranking-cue} for="0.12s" gain="0.13" fade-out="1f"/>- <audio:Clip id="sfx-part-chart" source={sfx-tap-media.media} from={story-time.moment-part-chart-cue} for="0.12s" gain="0.13" fade-out="1f"/>- <audio:Clip id="sfx-part-card" source={sfx-tap-media.media} from={story-time.moment-part-card-cue} for="0.12s" gain="0.13" fade-out="1f"/>- <audio:Clip id="sfx-parts-library" source={sfx-land-media.media} from={story-time.moment-parts-library-cue} for="0.26s" gain="0.18" fade-out="1f"/>- <audio:Clip id="sfx-parts-reuse" source={sfx-spark-media.media} from={story-time.moment-parts-reuse-cue} for="0.48s" gain="0.14" fade-out="1f"/>- <audio:Clip id="sfx-parts-swap" source={sfx-swipe-media.media} from={story-time.moment-parts-swap-cue} for="0.36s" gain="0.19" fade-out="1f"/>- <audio:Clip id="sfx-rank-reveal" source={sfx-land-media.media} from={story-time.moment-rank-reveal-cue} for="0.26s" gain="0.2" fade-out="1f"/>- <audio:Clip id="sfx-product-reveal" source={sfx-pop-media.media} from={story-time.moment-product-reveal-cue} for="0.24s" gain="0.2" fade-out="1f"/>- <audio:Clip id="sfx-sem-voice" source={sfx-tap-media.media} from={story-time.moment-sem-voice-cue} for="0.12s" gain="0.13" fade-out="1f"/>- <audio:Clip id="sfx-sem-adapt" source={sfx-spark-media.media} from={story-time.moment-sem-adapt-cue} for="0.48s" gain="0.14" fade-out="1f"/>- <audio:Clip id="sfx-result-assets" source={sfx-finish-media.media} from={story-time.moment-result-assets-cue} for="0.72s" gain="0.16" fade-out="1f"/>- <audio:Clip id="sfx-result-meta" source={sfx-swipe-media.media} from={story-time.moment-result-meta-cue} for="0.36s" gain="0.17" fade-out="1f"/>- <audio:Clip id="sfx-outro-install" source={sfx-tap-media.media} from={story-time.moment-outro-install-cue} for="0.12s" gain="0.15" fade-out="1f"/>- <audio:Clip id="sfx-outro-gift" source={sfx-spark-media.media} from={story-time.moment-outro-gift-cue} for="0.48s" gain="0.18" fade-out="1f"/>- <audio:Clip id="sfx-outro-bye" source={sfx-finish-media.media} from={story-time.moment-outro-bye-cue} for="0.72s" gain="0.18" fade-out="1f"/>- <audio:Clip id="sfx-montage-1" source={sfx-tap-media.media} from={story-time.segment-opening-end-plus-0f} until={story-time.segment-opening-end-plus-4f} gain="0.21"/>- <audio:Clip id="sfx-montage-2" source={sfx-tap-media.media} from={story-time.segment-opening-end-plus-5f} until={story-time.segment-opening-end-plus-9f} gain="0.21"/>- <audio:Clip id="sfx-montage-3" source={sfx-tap-media.media} from={story-time.segment-opening-end-plus-9f} until={story-time.segment-opening-end-plus-13f} gain="0.21"/>- <audio:Clip id="sfx-montage-4" source={sfx-spark-media.media} from={story-time.segment-opening-end-plus-14f} until={story-time.segment-opening-end-plus-28f} gain="0.27"/>+ <audio:Clip id="sfx-intro-codex" source={sfx-pop-media.media} during={sfx-intro-codex-window} gain="0.16" fade-out="1f"/>+ <audio:Clip id="sfx-intro-claude" source={sfx-pop-media.media} during={sfx-intro-claude-window} gain="0.16" fade-out="1f"/>+ <audio:Clip id="sfx-intro-examples" source={sfx-swipe-media.media} during={sfx-intro-examples-window} gain="0.2" fade-out="1f"/>+ <audio:Clip id="sfx-intro-face" source={sfx-spark-media.media} during={sfx-intro-face-window} gain="0.13" fade-out="1f"/>+ <audio:Clip id="sfx-competitor-monthly" source={sfx-tap-media.media} during={sfx-competitor-monthly-window} gain="0.16" fade-out="1f"/>+ <audio:Clip id="sfx-competitor-watermark" source={sfx-ticks-media.media} during={sfx-competitor-watermark-window} gain="0.13" fade-out="1f"/>+ <audio:Clip id="sfx-roads" source={sfx-land-media.media} during={sfx-roads-window} gain="0.22" fade-out="1f"/>+ <audio:Clip id="sfx-road-assets" source={sfx-pop-media.media} during={sfx-road-assets-window} gain="0.15" fade-out="1f"/>+ <audio:Clip id="sfx-road-drag" source={sfx-tap-media.media} during={sfx-road-drag-window} gain="0.13" fade-out="1f"/>+ <audio:Clip id="sfx-road-fail" source={sfx-reject-media.media} during={sfx-road-fail-window} gain="0.19" fade-out="1f"/>+ <audio:Clip id="sfx-road-number" source={sfx-pop-media.media} during={sfx-road-number-window} gain="0.2" fade-out="1f"/>+ <audio:Clip id="sfx-road-image" source={sfx-swipe-media.media} during={sfx-road-image-window} gain="0.18" fade-out="1f"/>+ <audio:Clip id="sfx-road-keys" source={sfx-ticks-media.media} during={sfx-road-keys-window} gain="0.13" fade-out="1f"/>+ <audio:Clip id="sfx-road-tokens" source={sfx-ticks-media.media} during={sfx-road-tokens-window} gain="0.12" fade-out="1f"/>+ <audio:Clip id="sfx-code-play" source={sfx-pop-media.media} during={sfx-code-play-window} gain="0.16" fade-out="1f"/>+ <audio:Clip id="sfx-code-duplicate" source={sfx-ticks-media.media} during={sfx-code-duplicate-window} gain="0.12" fade-out="1f"/>+ <audio:Clip id="sfx-solution-keep" source={sfx-spark-media.media} during={sfx-solution-keep-window} gain="0.19" fade-out="1f"/>+ <audio:Clip id="sfx-solution-drop" source={sfx-swipe-media.media} during={sfx-solution-drop-window} gain="0.18" fade-out="1f"/>+ <audio:Clip id="sfx-part-caption" source={sfx-tap-media.media} during={sfx-part-caption-window} gain="0.13" fade-out="1f"/>+ <audio:Clip id="sfx-part-ranking" source={sfx-tap-media.media} during={sfx-part-ranking-window} gain="0.13" fade-out="1f"/>+ <audio:Clip id="sfx-part-chart" source={sfx-tap-media.media} during={sfx-part-chart-window} gain="0.13" fade-out="1f"/>+ <audio:Clip id="sfx-part-card" source={sfx-tap-media.media} during={sfx-part-card-window} gain="0.13" fade-out="1f"/>+ <audio:Clip id="sfx-parts-library" source={sfx-land-media.media} during={sfx-parts-library-window} gain="0.18" fade-out="1f"/>+ <audio:Clip id="sfx-parts-reuse" source={sfx-spark-media.media} during={sfx-parts-reuse-window} gain="0.14" fade-out="1f"/>+ <audio:Clip id="sfx-parts-swap" source={sfx-swipe-media.media} during={sfx-parts-swap-window} gain="0.19" fade-out="1f"/>+ <audio:Clip id="sfx-rank-reveal" source={sfx-land-media.media} during={sfx-rank-reveal-window} gain="0.2" fade-out="1f"/>+ <audio:Clip id="sfx-product-reveal" source={sfx-pop-media.media} during={sfx-product-reveal-window} gain="0.2" fade-out="1f"/>+ <audio:Clip id="sfx-sem-voice" source={sfx-tap-media.media} during={sfx-sem-voice-window} gain="0.13" fade-out="1f"/>+ <audio:Clip id="sfx-sem-adapt" source={sfx-spark-media.media} during={sfx-sem-adapt-window} gain="0.14" fade-out="1f"/>+ <audio:Clip id="sfx-result-assets" source={sfx-finish-media.media} during={sfx-result-assets-window} gain="0.16" fade-out="1f"/>+ <audio:Clip id="sfx-result-meta" source={sfx-swipe-media.media} during={sfx-result-meta-window} gain="0.17" fade-out="1f"/>+ <audio:Clip id="sfx-outro-install" source={sfx-tap-media.media} during={sfx-outro-install-window} gain="0.15" fade-out="1f"/>+ <audio:Clip id="sfx-outro-gift" source={sfx-spark-media.media} during={sfx-outro-gift-window} gain="0.18" fade-out="1f"/>+ <audio:Clip id="sfx-outro-bye" source={sfx-finish-media.media} during={sfx-outro-bye-window} gain="0.18" fade-out="1f"/>+ <audio:Clip id="sfx-montage-1" source={sfx-tap-media.media} during={sfx-montage-1-window} gain="0.21"/>+ <audio:Clip id="sfx-montage-2" source={sfx-tap-media.media} during={sfx-montage-2-window} gain="0.21"/>+ <audio:Clip id="sfx-montage-3" source={sfx-tap-media.media} during={sfx-montage-3-window} gain="0.21"/>+ <audio:Clip id="sfx-montage-4" source={sfx-spark-media.media} during={sfx-montage-4-window} gain="0.27"/></audio:Track><!-- Caption: Script text, authored cues and presentation --><caption:Hidden id="hidden-captions"/><caption-fine:Style id="caption-base" recipe={look.caption.primary} font={assets.display-font}/>- <linecaption:Track id="captions" timeline={program.timeline}+ <linecaption:Caption id="captions" timeline={program.timeline}document={copy.story.caption} timing={caption-timing} within={assets.canvas.bounds}><linecaption:Use style={caption-base}/><linecaption:Use during={story-time.segment-opening} style={hidden-captions}/>- </linecaption:Track>- <launch:PosterTitle id="montage-label" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} from={story-time.segment-opening-end-plus-14f} until={story-time.segment-opening-end-plus-45f} text="Hypit" subtitle="复刻任何爆款视频" y="0.165" size="180" subtitle-size="46" subtitle-gap="35"/>+ </linecaption:Caption>+ <launch:PosterTitle id="montage-label" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} during={montage-image-4-window} text="Hypit" subtitle="复刻任何爆款视频" y="0.165" size="180" subtitle-size="46" subtitle-gap="35"/><!-- Coordinated scenes: supplied media plus semantic events --><webscene:Introduction id="intro-scene" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} during={story-time.segment-introduction} page={web-hypit-media.media} code={code-demo-media.media} readme={readme-demo-media.media} codex={assets.icon-codex} claude={assets.icon-claude} reference-ranking={reference-ranking-media.media} reference-podcast={reference-podcast-media.media} reference-interview={reference-interview-media.media} hypit-ranking={hypit-ranking-media.media} hypit-podcast={hypit-podcast-media.media} hypit-interview={hypit-interview-media.media}>@@ -495,7 +561,7 @@<webscene:Beat name="cases" at={story-time.moment-competitor-cases-cue}/><webscene:Beat name="watermark" at={story-time.moment-competitor-watermark-cue}/></webscene:Comparison>- <webscene:Road id="editor-journey" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} from={story-time.segment-two-roads-start} until={story-time.segment-keyframe-cost-end} page={web-hypit-media.media} sample={case-higgsfield-media.media} codex={assets.icon-codex} capcut={assets.icon-capcut} premiere={assets.icon-premiere} resolve={assets.icon-resolve} logo={assets.road-logo} portrait={assets.presenter-reference} thumb-a={assets.gallery-ranking} thumb-b={assets.gallery-podcast} thumb-c={assets.gallery-interview} thumb-d={assets.gallery-original-ranking} thumb-e={assets.gallery-original-interview} thumb-f={assets.gallery-homepage} thumb-g={assets.gallery-code}>+ <webscene:Road id="editor-journey" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} during={editor-journey-window} page={web-hypit-media.media} sample={case-higgsfield-media.media} codex={assets.icon-codex} capcut={assets.icon-capcut} premiere={assets.icon-premiere} resolve={assets.icon-resolve} logo={assets.road-logo} portrait={assets.presenter-reference} thumb-a={assets.gallery-ranking} thumb-b={assets.gallery-podcast} thumb-c={assets.gallery-interview} thumb-d={assets.gallery-original-ranking} thumb-e={assets.gallery-original-interview} thumb-f={assets.gallery-homepage} thumb-g={assets.gallery-code}><webscene:Beat name="half" at={story-time.moment-road-half-cue}/><webscene:Beat name="overview" at={story-time.moment-road-overview-cue}/><webscene:Beat name="editor" at={story-time.moment-road-editor-cue}/>@@ -516,7 +582,7 @@<webscene:Beat name="unstable" at={story-time.moment-road-unstable-cue}/><webscene:Beat name="styles" at={story-time.moment-road-styles-cue}/></webscene:Road>- <webscene:CodeJourney id="code-journey" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} from={story-time.segment-code-road-start} until={story-time.segment-synthesis-end} codex={assets.icon-codex} remotion={assets.icon-remotion} hyperframes={assets.icon-hyperframes} ranking={reference-ranking-media.media} podcast={reference-podcast-media.media} interview={reference-interview-media.media} target={hypit-ranking-media.media}>+ <webscene:CodeJourney id="code-journey" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} during={code-journey-window} codex={assets.icon-codex} remotion={assets.icon-remotion} hyperframes={assets.icon-hyperframes} ranking={reference-ranking-media.media} podcast={reference-podcast-media.media} interview={reference-interview-media.media} target={hypit-ranking-media.media}><webscene:Beat name="remotion" at={story-time.moment-code-remotion-cue}/><webscene:Beat name="hyperframes" at={story-time.moment-code-hyperframes-cue}/><webscene:Beat name="html" at={story-time.moment-code-html-cue}/>@@ -551,7 +617,7 @@<webscene:Beat name="color" at={story-time.moment-parts-color-cue}/><webscene:Beat name="swap" at={story-time.moment-parts-swap-cue}/></webscene:ComponentWorkshop>- <webscene:SemanticWorkshop id="semantic-workshop" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} creatify={assets.ranking-creatify} higgsfield={assets.ranking-higgsfield} from={story-time.segment-semantic-time-start} until={story-time.segment-semantic-demo-end}>+ <webscene:SemanticWorkshop id="semantic-workshop" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} creatify={assets.ranking-creatify} higgsfield={assets.ranking-higgsfield} during={semantic-workshop-window}><webscene:Beat name="bind" at={story-time.moment-sem-bind-cue}/><webscene:Beat name="examples" at={story-time.moment-sem-examples-cue}/><webscene:Beat name="rank" at={story-time.moment-rank-reveal-cue}/>@@ -562,7 +628,7 @@<webscene:Beat name="adapt" at={story-time.moment-sem-adapt-cue}/><webscene:Beat name="syntax" at={story-time.moment-sem-syntax-cue}/></webscene:SemanticWorkshop>- <webscene:DeliveryWorkshop id="delivery-workshop" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} from={story-time.segment-result-start} until={story-time.segment-reference-reveal-end} film={hypit-ranking-media.media} clone={ranking-clone-media.media} water={water-break-media.media} reference={assets.reference-drink-illustration} host={assets.ranking-host} thumb1={assets.ranking-icon} thumb2={assets.ranking-creatify} thumb3={assets.ranking-higgsfield}>+ <webscene:DeliveryWorkshop id="delivery-workshop" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} during={delivery-workshop-window} film={hypit-ranking-media.media} clone={ranking-clone-media.media} water={water-break-media.media} reference={assets.reference-drink-illustration} host={assets.ranking-host} thumb1={assets.ranking-icon} thumb2={assets.ranking-creatify} thumb3={assets.ranking-higgsfield}><webscene:Beat name="assets" at={story-time.moment-result-assets-cue}/><webscene:Beat name="upload" at={story-time.moment-result-upload-cue}/><webscene:Beat name="compare" at={story-time.moment-result-compare-cue}/>@@ -570,7 +636,7 @@<webscene:Beat name="brand" at={story-time.moment-result-brand-cue}/><webscene:Beat name="guess" at={story-time.moment-result-guess-cue}/></webscene:DeliveryWorkshop>- <webscene:Outro id="outro-scene" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} from={story-time.segment-closing-start} until="end" page={readme-demo-media.media} codex={assets.icon-codex} portraits-0={assets.portraits-0} portraits-1={assets.portraits-1} portraits-2={assets.portraits-2} portraits-3={assets.portraits-3} portraits-4={assets.portraits-4}>+ <webscene:Outro id="outro-scene" timeline={program.timeline} within={assets.canvas.bounds} font={assets.display-font} during={outro-scene-window} page={readme-demo-media.media} codex={assets.icon-codex} portraits-0={assets.portraits-0} portraits-1={assets.portraits-1} portraits-2={assets.portraits-2} portraits-3={assets.portraits-3} portraits-4={assets.portraits-4}><webscene:Beat name="overtime" at={story-time.moment-outro-overtime-cue}/><webscene:Beat name="github" at={story-time.moment-outro-github-cue}/><webscene:Beat name="copy" at={story-time.moment-outro-copy-cue}/>diff --git a/examples/interview/README.md b/examples/interview/README.mdindex 7ffb94d0..9b10141e 100644--- a/examples/interview/README.md+++ b/examples/interview/README.md@@ -12,11 +12,11 @@ edge, preserving their spatial relationship. All three are generated; the old `hand `guy.png` are not inputs to this entry. Two Fish Audio Voice Design requests supply recurring voices.The street-interview Kit consumes interviewer, guest and shared images in that order, followed by-the corresponding interviewer/guest voice references. Three Seedance Mini Takes carry eleven, eight+the corresponding interviewer/guest voice references. Three Seedance Mini clips carry eleven, eightand eight seconds of dialogue. The first starts with the guest occupied with her bag as theinterviewer approaches. Answers favor her close view; neutral questions can use the shared view,and surprised questions can cut to him. The final answer ends with her beginning to turn away.-These cuts and actions are authored within the Takes, with no serial tail-frame chain.+These cuts and actions are authored within the generated clips, with no serial tail-frame chain.Each reveal uses the same Script Moment for the answer strip, sound and colored flash. Preparedquestion-mark, sparkles, building and Bitcoin PNGs remain local assets. Their palette works with@@ -47,12 +47,12 @@ performance, cuts, reading and reveal timing.The published video used externally measured head positions. A fresh generation changes motion,cuts and actual length, so this Source does not import the original 783-frame `tracking.svs`.-That file describes the old footage only. Supplying it to new Takes would attach plausible-looking+That file describes the old footage only. Supplying it to new requests would attach plausible-lookingnumbers to the wrong video.After the first Build, export its `final.video` and measure that actual footage, using Google VideoIntelligence with face bounding boxes, another suitable detector, or manual observation. If graphics-obstruct the detector, render a clean picture pass from the same normalized Takes. Use the actual+obstruct the detector, render a clean picture pass from the same normalized media. Use the actualprogram frame count and 30 fps clock; identify WIFE across camera cuts, expand face boxes to includeher hair, and write one normalized `[x,y,width,height]` or `null` per frame into a new`reference-heads.svs`. Keep interpolation within a continuous shot and one identity.diff --git a/examples/interview/packages/flash/src/activation.ts b/examples/interview/packages/flash/src/activation.tsindex 81cc1f75..142236a1 100644--- a/examples/interview/packages/flash/src/activation.ts+++ b/examples/interview/packages/flash/src/activation.ts@@ -24,7 +24,7 @@ import {} from "@hypit/hypit/temporal";import type { TemporalWindow } from "@hypit/hypit/temporal";import {- createTemporalWindowConstruction,+ resolveTemporalWindowReference,resolveTemporalContext,temporalContextAttributeVocabulary,temporalWindowAttributeNames,@@ -211,9 +211,7 @@ const decodeFlash: StructuredSurfaceHandler = ({ element, resolveReference }) =>if (within === undefined || !sameType(within.type, spatialTypes.frame)) {throw new Error("Flash.within has the wrong Type.");}- const window = createTemporalWindowConstruction({- id: `${id}.window`, subjectId: id, element, ...context, resolveReference,- });+ const window = resolveTemporalWindowReference({ element, resolveReference });const options: FlashOptions = {id,color: textAttribute(element, "color"),@@ -251,12 +249,10 @@ const decodeFlash: StructuredSurfaceHandler = ({ element, resolveReference }) =>});return {records: [- ...window.records,{ id: optionsId, type: optionsType, value: { kind: "inline", value: canonicalize(options) }, range: element.range },],- fragments: [...window.fragments, fragment],+ fragments: [fragment],components: [- ...window.components,{id,fragment: fragment.id,@@ -280,11 +276,6 @@ const declaration = {mode: "structured" as const,outputs: [compositionTypes.visualTrack,- temporalTypes.window,- temporalTypes.duration,- temporalTypes.extent,- temporalTypes.shiftSpec,- temporalTypes.windowSpec,optionsType,],vocabulary: {@@ -299,7 +290,7 @@ const declaration = {})),],ports: [{ name: "visual", type: compositionTypes.visualTrack, summary: "The flash as an ordinary VisualTrack." }],- example: '<flash:Flash id="hit" timeline={speech.timeline} within={vertical.bounds} from={cue} for="8f" z="80" color="#FFFFFF" intensity="0.28" attack="2" hold="1" decay="5"/>',+ example: '<flash:Flash id="hit" timeline={speech.timeline} within={vertical.bounds} during={hit-window} z="80" color="#FFFFFF" intensity="0.28" attack="2" hold="1" decay="5"/>',},};diff --git a/examples/interview/reference.svml b/examples/interview/reference.svmlindex baccf463..f4378fc0 100644--- a/examples/interview/reference.svml+++ b/examples/interview/reference.svml@@ -265,6 +265,12 @@<semantic:Instant id="moment-real-estate-cue" moment={story.moment.real-estate}/><semantic:Instant id="moment-bitcoin-cue" moment={story.moment.bitcoin}/></semantic:Projection>+ <time:Window id="manifest-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-manifest-cue} for="20f"/>+ <time:Window id="real-estate-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-real-estate-cue} for="20f"/>+ <time:Window id="bitcoin-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-bitcoin-cue} for="20f"/>+ <time:Window id="manifest-flash-window" timeline={speech.timeline} from={story-time.moment-manifest-cue} for="8f"/>+ <time:Window id="real-estate-flash-window" timeline={speech.timeline} from={story-time.moment-real-estate-cue} for="8f"/>+ <time:Window id="bitcoin-flash-window" timeline={speech.timeline} from={story-time.moment-bitcoin-cue} for="8f"/><audio:Track id="speech-sound" timeline={speech.timeline}><audio:Clip id="manifest-rule-semantic-source" source={manifest-rule-media.media} during={speech.manifest-rule-semantic}/><audio:Clip id="real-estate-rule-semantic-source" source={real-estate-rule-media.media} during={speech.real-estate-rule-semantic}/>@@ -277,14 +283,14 @@</visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track><audio-track:Track id="rule-reveal-sfx" timeline={speech.timeline}>- <audio-track:Clip id="manifest-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-manifest-cue} for="20f" gain="0.20"/>- <audio-track:Clip id="real-estate-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-real-estate-cue} for="20f" gain="0.20"/>- <audio-track:Clip id="bitcoin-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-bitcoin-cue} for="20f" gain="0.20"/>+ <audio-track:Clip id="manifest-reveal-sfx" source={rule-reveal-sound-media.media} during={manifest-reveal-sfx-window} gain="0.20"/>+ <audio-track:Clip id="real-estate-reveal-sfx" source={rule-reveal-sound-media.media} during={real-estate-reveal-sfx-window} gain="0.20"/>+ <audio-track:Clip id="bitcoin-reveal-sfx" source={rule-reveal-sound-media.media} during={bitcoin-reveal-sfx-window} gain="0.20"/></audio-track:Track><fonts:Face id="caption-font" package="@fontsource-variable/league-spartan" weight="900" style="normal"/>@@ -302,20 +308,20 @@<emoji:Style id="rule-reveal-style" recipe={recipes.emoji.strip}/><emoji:EmojiReveal id="rule-reveal" timeline={speech.timeline} within={vertical.bounds}- style={rule-reveal-style} placeholder={rule-placeholder} during="timeline">+ style={rule-reveal-style} placeholder={rule-placeholder} during={speech.window}><emoji:Item id="manifest" icon={manifest-icon} at={story-time.moment-manifest-cue}/><emoji:Item id="real-estate" icon={real-estate-icon} at={story-time.moment-real-estate-cue}/><emoji:Item id="bitcoin" icon={bitcoin-icon} at={story-time.moment-bitcoin-cue}/></emoji:EmojiReveal><flash:Flash id="manifest-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-manifest-cue} for="8f" z="80"+ during={manifest-flash-window} z="80"color="#FF4D6D" intensity="0.28" attack="2" hold="1" decay="5"/><flash:Flash id="real-estate-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-real-estate-cue} for="8f" z="80"+ during={real-estate-flash-window} z="80"color="#14A68A" intensity="0.28" attack="2" hold="1" decay="5"/><flash:Flash id="bitcoin-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-bitcoin-cue} for="8f" z="80"+ during={bitcoin-flash-window} z="80"color="#F59E0B" intensity="0.28" attack="2" hold="1" decay="5"/><film:Film id="main" canvas={vertical.canvas} timeline={speech.timeline}diff --git a/examples/interview/swap-host.svml b/examples/interview/swap-host.svmlindex 4c06bf12..63f5ca2b 100644--- a/examples/interview/swap-host.svml+++ b/examples/interview/swap-host.svml@@ -195,6 +195,12 @@<semantic:Instant id="moment-real-estate-cue" moment={story.moment.real-estate}/><semantic:Instant id="moment-bitcoin-cue" moment={story.moment.bitcoin}/></semantic:Projection>+ <time:Window id="manifest-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-manifest-cue} for="20f"/>+ <time:Window id="real-estate-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-real-estate-cue} for="20f"/>+ <time:Window id="bitcoin-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-bitcoin-cue} for="20f"/>+ <time:Window id="manifest-flash-window" timeline={speech.timeline} from={story-time.moment-manifest-cue} for="8f"/>+ <time:Window id="real-estate-flash-window" timeline={speech.timeline} from={story-time.moment-real-estate-cue} for="8f"/>+ <time:Window id="bitcoin-flash-window" timeline={speech.timeline} from={story-time.moment-bitcoin-cue} for="8f"/><region:Evidence id="wojak-heads" within={vertical.bounds} timeline={speech.timeline}recipe={wojak-tracking.heads.wojak}/>@@ -210,14 +216,14 @@</visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track><audio-track:Track id="rule-reveal-sfx" timeline={speech.timeline}>- <audio-track:Clip id="manifest-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-manifest-cue} for="20f" gain="0.20"/>- <audio-track:Clip id="real-estate-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-real-estate-cue} for="20f" gain="0.20"/>- <audio-track:Clip id="bitcoin-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-bitcoin-cue} for="20f" gain="0.20"/>+ <audio-track:Clip id="manifest-reveal-sfx" source={rule-reveal-sound-media.media} during={manifest-reveal-sfx-window} gain="0.20"/>+ <audio-track:Clip id="real-estate-reveal-sfx" source={rule-reveal-sound-media.media} during={real-estate-reveal-sfx-window} gain="0.20"/>+ <audio-track:Clip id="bitcoin-reveal-sfx" source={rule-reveal-sound-media.media} during={bitcoin-reveal-sfx-window} gain="0.20"/></audio-track:Track><fonts:Face id="caption-font" package="@fontsource-variable/league-spartan" weight="900" style="normal"/>@@ -235,20 +241,20 @@<emoji:Style id="rule-reveal-style" recipe={recipes.emoji.strip}/><emoji:EmojiReveal id="rule-reveal" timeline={speech.timeline} within={vertical.bounds}- style={rule-reveal-style} placeholder={rule-placeholder.image} during="timeline">+ style={rule-reveal-style} placeholder={rule-placeholder.image} during={speech.window}><emoji:Item id="manifest" icon={manifest-icon.image} at={story-time.moment-manifest-cue}/><emoji:Item id="real-estate" icon={real-estate-icon.image} at={story-time.moment-real-estate-cue}/><emoji:Item id="bitcoin" icon={bitcoin-icon.image} at={story-time.moment-bitcoin-cue}/></emoji:EmojiReveal><flash:Flash id="manifest-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-manifest-cue} for="8f" z="80"+ during={manifest-flash-window} z="80"color="#FF4D6D" intensity="0.28" attack="2" hold="1" decay="5"/><flash:Flash id="real-estate-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-real-estate-cue} for="8f" z="80"+ during={real-estate-flash-window} z="80"color="#14A68A" intensity="0.28" attack="2" hold="1" decay="5"/><flash:Flash id="bitcoin-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-bitcoin-cue} for="8f" z="80"+ during={bitcoin-flash-window} z="80"color="#F59E0B" intensity="0.28" attack="2" hold="1" decay="5"/><film:Film id="main" canvas={vertical.canvas} timeline={speech.timeline}diff --git a/examples/interview/swap-lang.svml b/examples/interview/swap-lang.svmlindex cd43bd8f..95325725 100644--- a/examples/interview/swap-lang.svml+++ b/examples/interview/swap-lang.svml@@ -194,6 +194,12 @@<semantic:Instant id="moment-real-estate-cue" moment={story.moment.real-estate}/><semantic:Instant id="moment-bitcoin-cue" moment={story.moment.bitcoin}/></semantic:Projection>+ <time:Window id="manifest-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-manifest-cue} for="20f"/>+ <time:Window id="real-estate-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-real-estate-cue} for="20f"/>+ <time:Window id="bitcoin-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-bitcoin-cue} for="20f"/>+ <time:Window id="manifest-flash-window" timeline={speech.timeline} from={story-time.moment-manifest-cue} for="8f"/>+ <time:Window id="real-estate-flash-window" timeline={speech.timeline} from={story-time.moment-real-estate-cue} for="8f"/>+ <time:Window id="bitcoin-flash-window" timeline={speech.timeline} from={story-time.moment-bitcoin-cue} for="8f"/><region:Evidence id="wife-heads" within={vertical.bounds} timeline={speech.timeline}recipe={tracking.heads.wife}/>@@ -209,14 +215,14 @@</visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track><audio-track:Track id="rule-reveal-sfx" timeline={speech.timeline}>- <audio-track:Clip id="manifest-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-manifest-cue} for="20f" gain="0.20"/>- <audio-track:Clip id="real-estate-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-real-estate-cue} for="20f" gain="0.20"/>- <audio-track:Clip id="bitcoin-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-bitcoin-cue} for="20f" gain="0.20"/>+ <audio-track:Clip id="manifest-reveal-sfx" source={rule-reveal-sound-media.media} during={manifest-reveal-sfx-window} gain="0.20"/>+ <audio-track:Clip id="real-estate-reveal-sfx" source={rule-reveal-sound-media.media} during={real-estate-reveal-sfx-window} gain="0.20"/>+ <audio-track:Clip id="bitcoin-reveal-sfx" source={rule-reveal-sound-media.media} during={bitcoin-reveal-sfx-window} gain="0.20"/></audio-track:Track><fonts:Face id="caption-font" package="@fontsource-variable/league-spartan" weight="900" style="normal"/>@@ -234,20 +240,20 @@<emoji:Style id="rule-reveal-style" recipe={recipes.emoji.strip}/><emoji:EmojiReveal id="rule-reveal" timeline={speech.timeline} within={vertical.bounds}- style={rule-reveal-style} placeholder={rule-placeholder.image} during="timeline">+ style={rule-reveal-style} placeholder={rule-placeholder.image} during={speech.window}><emoji:Item id="manifest" icon={manifest-icon.image} at={story-time.moment-manifest-cue}/><emoji:Item id="real-estate" icon={real-estate-icon.image} at={story-time.moment-real-estate-cue}/><emoji:Item id="bitcoin" icon={bitcoin-icon.image} at={story-time.moment-bitcoin-cue}/></emoji:EmojiReveal><flash:Flash id="manifest-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-manifest-cue} for="8f" z="80"+ during={manifest-flash-window} z="80"color="#FF4D6D" intensity="0.28" attack="2" hold="1" decay="5"/><flash:Flash id="real-estate-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-real-estate-cue} for="8f" z="80"+ during={real-estate-flash-window} z="80"color="#14A68A" intensity="0.28" attack="2" hold="1" decay="5"/><flash:Flash id="bitcoin-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-bitcoin-cue} for="8f" z="80"+ during={bitcoin-flash-window} z="80"color="#F59E0B" intensity="0.28" attack="2" hold="1" decay="5"/><film:Film id="main" canvas={vertical.canvas} timeline={speech.timeline}diff --git a/examples/interview/swap-ride.svml b/examples/interview/swap-ride.svmlindex 580f3f22..b202e09a 100644--- a/examples/interview/swap-ride.svml+++ b/examples/interview/swap-ride.svml@@ -202,6 +202,12 @@<semantic:Instant id="moment-shortcuts-cue" moment={story.moment.shortcuts}/><semantic:Instant id="moment-first-place-cue" moment={story.moment.first-place}/></semantic:Projection>+ <time:Window id="uber-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-uber-cue} for="20f"/>+ <time:Window id="shortcuts-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-shortcuts-cue} for="20f"/>+ <time:Window id="first-place-reveal-sfx-window" timeline={speech.timeline} from={story-time.moment-first-place-cue} for="20f"/>+ <time:Window id="uber-flash-window" timeline={speech.timeline} from={story-time.moment-uber-cue} for="8f"/>+ <time:Window id="shortcuts-flash-window" timeline={speech.timeline} from={story-time.moment-shortcuts-cue} for="8f"/>+ <time:Window id="first-place-flash-window" timeline={speech.timeline} from={story-time.moment-first-place-cue} for="8f"/><audio:Track id="speech-sound" timeline={speech.timeline}><audio:Clip id="uber-rule-semantic-source" source={uber-rule-media.media} during={speech.uber-rule-semantic}/><audio:Clip id="shortcuts-rule-semantic-source" source={shortcuts-rule-media.media} during={speech.shortcuts-rule-semantic}/>@@ -214,14 +220,14 @@</visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track><audio-track:Track id="rule-reveal-sfx" timeline={speech.timeline}>- <audio-track:Clip id="uber-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-uber-cue} for="20f" gain="0.20"/>- <audio-track:Clip id="shortcuts-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-shortcuts-cue} for="20f" gain="0.20"/>- <audio-track:Clip id="first-place-reveal-sfx" source={rule-reveal-sound-media.media} from={story-time.moment-first-place-cue} for="20f" gain="0.20"/>+ <audio-track:Clip id="uber-reveal-sfx" source={rule-reveal-sound-media.media} during={uber-reveal-sfx-window} gain="0.20"/>+ <audio-track:Clip id="shortcuts-reveal-sfx" source={rule-reveal-sound-media.media} during={shortcuts-reveal-sfx-window} gain="0.20"/>+ <audio-track:Clip id="first-place-reveal-sfx" source={rule-reveal-sound-media.media} during={first-place-reveal-sfx-window} gain="0.20"/></audio-track:Track><fonts:Face id="caption-font" package="@fontsource-variable/league-spartan" weight="900" style="normal"/>@@ -241,20 +247,20 @@<emoji:Style id="rule-reveal-style" recipe={recipes.emoji.strip}/><emoji:EmojiReveal id="rule-reveal" timeline={speech.timeline} within={vertical.bounds}- style={rule-reveal-style} placeholder={rule-placeholder.image} during="timeline">+ style={rule-reveal-style} placeholder={rule-placeholder.image} during={speech.window}><emoji:Item id="uber" icon={uber-icon.image} at={story-time.moment-uber-cue}/><emoji:Item id="shortcuts" icon={shortcuts-icon.image} at={story-time.moment-shortcuts-cue}/><emoji:Item id="first-place" icon={first-place-icon.image} at={story-time.moment-first-place-cue}/></emoji:EmojiReveal><flash:Flash id="uber-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-uber-cue} for="8f" z="80"+ during={uber-flash-window} z="80"color="#2A9DFF" intensity="0.28" attack="2" hold="1" decay="5"/><flash:Flash id="shortcuts-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-shortcuts-cue} for="8f" z="80"+ during={shortcuts-flash-window} z="80"color="#A855F7" intensity="0.28" attack="2" hold="1" decay="5"/><flash:Flash id="first-place-flash" timeline={speech.timeline} within={vertical.bounds}- from={story-time.moment-first-place-cue} for="8f" z="80"+ during={first-place-flash-window} z="80"color="#F2B832" intensity="0.28" attack="2" hold="1" decay="5"/><film:Film id="main" canvas={vertical.canvas} timeline={speech.timeline}diff --git a/examples/minimal-author-package/packages/example-component/src/manifest.ts b/examples/minimal-author-package/packages/example-component/src/manifest.tsindex 8d7cdb69..23ea5764 100644--- a/examples/minimal-author-package/packages/example-component/src/manifest.ts+++ b/examples/minimal-author-package/packages/example-component/src/manifest.ts@@ -71,7 +71,7 @@ const vocabulary = (summary: string, example: string) => ({export const exampleMarkupSurfaces = [{ name: "box", tag: "Box", mode: "structured", outputs: [exampleTypes.box, compositionTypes.visualTrack], vocabulary: { ...vocabulary("A framed box surface.", "<example:Box id=\"box\" timeline={speech.timeline} within={layout.card}/>") , preview: previewImage("Box.png") } },- { name: "text", tag: "Text", mode: "structured", outputs: [exampleTypes.text, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, compositionTypes.visualTrack], vocabulary: { ...vocabulary("A text-bearing surface.", "<example:Text id=\"title\" timeline={speech.timeline} within={layout.title}>Hello</example:Text>"), preview: previewImage("Box.png") } },+ { name: "text", tag: "Text", mode: "structured", outputs: [exampleTypes.text, compositionTypes.visualTrack], vocabulary: { ...vocabulary("A text-bearing surface.", "<example:Text id=\"title\" timeline={speech.timeline} within={layout.title} during={speech.window}>Hello</example:Text>"), preview: previewImage("Box.png") } },{ name: "image-slot", tag: "ImageSlot", mode: "structured", outputs: [exampleTypes.imageSlot, compositionTypes.visualTrack], vocabulary: { ...vocabulary("An image slot whose content is a graph input.", "<example:ImageSlot id=\"shot\" timeline={speech.timeline} within={layout.shot} image={shot-image}/>") , attributes: [...vocabulary("", "").attributes, { name: "image", kind: "reference" as const, required: false, accepts: [blobTypes.blob], summary: "Optional image Blob Artifact." }], preview: previewImage("Box.png") } },{ name: "style", tag: "Style", mode: "structured", outputs: [exampleTypes.style], vocabulary: {summary: "Decodes one SVS Recipe and exact FontStackRef into a Style value.",diff --git a/examples/minimal-author-package/packages/example-component/src/temporal.ts b/examples/minimal-author-package/packages/example-component/src/temporal.tsindex 0e55494f..0b20f297 100644--- a/examples/minimal-author-package/packages/example-component/src/temporal.ts+++ b/examples/minimal-author-package/packages/example-component/src/temporal.ts@@ -1,6 +1,6 @@-import { createTemporalInstantConstruction, createTemporalWindowConstruction, temporalInstantAttributeNames, temporalWindowAttributeNames } from "@hypit/hypit/temporal/markup";+import { resolveTemporalInstantReference, resolveTemporalWindowReference, temporalInstantAttributeNames, temporalWindowAttributeNames } from "@hypit/hypit/temporal/markup";/** The fixture intentionally exposes both projection helpers and their vocabularies. */export { temporalInstantAttributeNames, temporalWindowAttributeNames };-export const projectExampleWindow = createTemporalWindowConstruction;-export const projectExampleMoment = createTemporalInstantConstruction;+export const projectExampleWindow = resolveTemporalWindowReference;+export const projectExampleMoment = resolveTemporalInstantReference;diff --git a/examples/podcast/README.md b/examples/podcast/README.mdindex b44fb1ed..83d29f84 100644--- a/examples/podcast/README.md+++ b/examples/podcast/README.md@@ -34,7 +34,7 @@ creatine packaging. [reference.svs](reference.svs) owns this entry's appearance## Performance and coverage-Two Fish Audio Voice Design requests establish recurring voices. Three Seedance Mini Takes carry the+Two Fish Audio Voice Design requests establish recurring voices. Three Seedance Mini clips carry theScript: a five-second split opening, an eight-second product explanation, and a six-second handoff.The opening uses its own small Text Template in `kits/split-opening.svs`, with dialogue bound fromScript. The other two use the podcast Kit. A silent listener still glances, adjusts posture and reacts.@@ -49,7 +49,7 @@ not freeze the last frame or retime to fill the Window. Inspect the newly alignethe Selection if the actual montage needs more reading time. Exact word-to-scene reconstructionwould use separate Clips and adjoining Selections instead.-`shared-soundtrack.m4a` is the only supplied media asset on the final route. Images, voices and Takes+`shared-soundtrack.m4a` is the only supplied media asset on the final route. Images, voices and generated clipsare generated; normalization, alignment, Caption and Film composition are explicit downstream work.## Run and refinediff --git a/examples/podcast/reference.svml b/examples/podcast/reference.svmlindex 88e1608c..5a93d191 100644--- a/examples/podcast/reference.svml+++ b/examples/podcast/reference.svml@@ -400,7 +400,7 @@</visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>diff --git a/examples/podcast/swap-app.svml b/examples/podcast/swap-app.svmlindex 351dc8d5..eeea32d4 100644--- a/examples/podcast/swap-app.svml+++ b/examples/podcast/swap-app.svml@@ -214,7 +214,7 @@</visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>diff --git a/examples/podcast/swap-host.svml b/examples/podcast/swap-host.svmlindex 70f32ebe..7da85659 100644--- a/examples/podcast/swap-host.svml+++ b/examples/podcast/swap-host.svml@@ -222,7 +222,7 @@</visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>diff --git a/examples/podcast/swap-item.svml b/examples/podcast/swap-item.svmlindex 2db6c824..0e447046 100644--- a/examples/podcast/swap-item.svml+++ b/examples/podcast/swap-item.svml@@ -222,7 +222,7 @@</visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>diff --git a/examples/ranking-football/README.md b/examples/ranking-football/README.mdindex e6e8e01b..3ff88ec8 100644--- a/examples/ranking-football/README.md+++ b/examples/ranking-football/README.md@@ -1,7 +1,7 @@# Football ranking[reference.svml](reference.svml) generates a goth football commentator and all eight comedy B-roll-images, then makes two independent speaking Takes from the same presenter image and designed voice.+images, then makes two independent speaking clips from the same presenter image and designed voice.A tier board preserves its state while the argument, Caption and overlapping image inserts unfold.[reference.svrun](reference.svrun) targets `final.video` without earlier Results or replacement files.@@ -9,7 +9,7 @@ A tier board preserves its state while the argument, Caption and overlapping ima- `presenter.image`: the striking goth host, seated to the right in a sky-blue football classroom.- Eight `broll-*.image` outputs: independent text-to-image jokes for the annotated Script passages.-- `presenter-voice.reference`: one Fish Audio Voice Design request reused by both Takes.+- `presenter-voice.reference`: one Fish Audio Voice Design request reused by both clips.- `ronaldo-take.video` and `messi-take.video`: Seedance Mini performances with audio, followed bynormalization and WhisperX alignment. Both use the same presenter image; there is no tail-frame chain.- Eleven supplied player photographs identify the board entries. Nine are presets and two enterdiff --git a/examples/ranking-football/reference-banana-from-swap/reference-banana-from-swap.svml b/examples/ranking-football/reference-banana-from-swap/reference-banana-from-swap.svmlindex 7b7f55f9..9b13e594 100644--- a/examples/ranking-football/reference-banana-from-swap/reference-banana-from-swap.svml+++ b/examples/ranking-football/reference-banana-from-swap/reference-banana-from-swap.svml@@ -244,7 +244,7 @@<visual:Clip id="messi-semantic-source" media={messi-media.media} during={speech.messi-semantic} frame={speech-frame} z="0" fit="cover"/></visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>@@ -254,7 +254,7 @@font={tier-font}/><ranking:TierBoard id="football-tiers" timeline={speech.timeline}within={vertical.bounds} frame={tier-frame}- during="timeline" style={tier-style}+ during={speech.window} style={tier-style}appear-sound={ranking-appear-media.media}move-sound={ranking-move-media.media}><ranking:TierItem id="yamal" tier="s" preset="true" icon={yamal-icon.image}/>diff --git a/examples/ranking-football/reference-banana/reference-banana.svml b/examples/ranking-football/reference-banana/reference-banana.svmlindex 7b7f55f9..9b13e594 100644--- a/examples/ranking-football/reference-banana/reference-banana.svml+++ b/examples/ranking-football/reference-banana/reference-banana.svml@@ -244,7 +244,7 @@<visual:Clip id="messi-semantic-source" media={messi-media.media} during={speech.messi-semantic} frame={speech-frame} z="0" fit="cover"/></visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>@@ -254,7 +254,7 @@font={tier-font}/><ranking:TierBoard id="football-tiers" timeline={speech.timeline}within={vertical.bounds} frame={tier-frame}- during="timeline" style={tier-style}+ during={speech.window} style={tier-style}appear-sound={ranking-appear-media.media}move-sound={ranking-move-media.media}><ranking:TierItem id="yamal" tier="s" preset="true" icon={yamal-icon.image}/>diff --git a/examples/ranking-football/reference-gpt.svml b/examples/ranking-football/reference-gpt.svmlindex f447fe47..82c518a8 100644--- a/examples/ranking-football/reference-gpt.svml+++ b/examples/ranking-football/reference-gpt.svml@@ -244,7 +244,7 @@<visual:Clip id="messi-semantic-source" media={messi-media.media} during={speech.messi-semantic} frame={speech-frame} z="0" fit="cover"/></visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>@@ -254,7 +254,7 @@font={tier-font}/><ranking:TierBoard id="football-tiers" timeline={speech.timeline}within={vertical.bounds} frame={tier-frame}- during="timeline" style={tier-style}+ during={speech.window} style={tier-style}appear-sound={ranking-appear-media.media}move-sound={ranking-move-media.media}><ranking:TierItem id="yamal" tier="s" preset="true" icon={yamal-icon.image}/>diff --git a/examples/ranking-football/reference.svml b/examples/ranking-football/reference.svmlindex d9d205b8..aa574bed 100644--- a/examples/ranking-football/reference.svml+++ b/examples/ranking-football/reference.svml@@ -249,7 +249,7 @@<audio:Track id="mix" timeline={speech.timeline}><audio:Clip id="ronaldo-semantic-source" source={ronaldo-media.media} during={speech.ronaldo-semantic}/><audio:Clip id="messi-semantic-source" source={messi-media.media} during={speech.messi-semantic}/>- <audio:Clip id="music-bed" source={soundtrack-media.media} during="timeline"+ <audio:Clip id="music-bed" source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio:Track><fonts:Face id="display-font" package="@fontsource-variable/montserrat" weight="900" style="normal"/>@@ -258,7 +258,7 @@font={tier-font}/><ranking:TierBoard id="football-tiers" timeline={speech.timeline}within={vertical.bounds} frame={tier-frame}- during="timeline" style={tier-style}+ during={speech.window} style={tier-style}appear-sound={ranking-appear-media.media}move-sound={ranking-move-media.media}><ranking:TierItem id="yamal" tier="s" preset="true" icon={yamal-icon}/>diff --git a/examples/ranking-football/swap-effect-banana-reference-sync/swap-effect-banana-reference-sync.svml b/examples/ranking-football/swap-effect-banana-reference-sync/swap-effect-banana-reference-sync.svmlindex 414d4a71..0400f313 100644--- a/examples/ranking-football/swap-effect-banana-reference-sync/swap-effect-banana-reference-sync.svml+++ b/examples/ranking-football/swap-effect-banana-reference-sync/swap-effect-banana-reference-sync.svml@@ -244,7 +244,7 @@<visual:Clip id="messi-semantic-source" media={messi-media.media} during={speech.messi-semantic} frame={speech-frame} z="0" fit="cover"/></visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>@@ -253,7 +253,7 @@<ranking:ColumnStyle id="column-style" recipe={recipes.ranking.football-column}font={column-font}/><ranking:Column id="football-column" timeline={speech.timeline}- within={vertical.bounds} frame={column-frame} during="timeline" style={column-style}+ within={vertical.bounds} frame={column-frame} during={speech.window} style={column-style}appear-sound={ranking-appear-media.media}move-sound={ranking-move-media.media}><ranking:ColumnItem id="ronaldo" rank="1" label="Ronaldo"diff --git a/examples/ranking-football/swap-effect-banana/swap-effect-banana.svml b/examples/ranking-football/swap-effect-banana/swap-effect-banana.svmlindex 82a2bd70..260984ec 100644--- a/examples/ranking-football/swap-effect-banana/swap-effect-banana.svml+++ b/examples/ranking-football/swap-effect-banana/swap-effect-banana.svml@@ -213,7 +213,7 @@<visual:Clip id="ronaldo-semantic-source" media={ronaldo-media.media} during={speech.ronaldo-semantic} frame={speech-frame} z="0" fit="cover"/></visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>@@ -222,7 +222,7 @@<ranking:ColumnStyle id="column-style" recipe={recipes.ranking.football-column}font={column-font}/><ranking:Column id="football-column" timeline={speech.timeline}- within={vertical.bounds} frame={column-frame} during="timeline" style={column-style}+ within={vertical.bounds} frame={column-frame} during={speech.window} style={column-style}appear-sound={ranking-appear-media.media}move-sound={ranking-move-media.media}><ranking:ColumnItem id="ronaldo" rank="1" label="Ronaldo"diff --git a/examples/ranking-football/swap-effect.svml b/examples/ranking-football/swap-effect.svmlindex eaba02db..d52dd5ab 100644--- a/examples/ranking-football/swap-effect.svml+++ b/examples/ranking-football/swap-effect.svml@@ -213,7 +213,7 @@<visual:Clip id="ronaldo-semantic-source" media={ronaldo-media.media} during={speech.ronaldo-semantic} frame={speech-frame} z="0" fit="cover"/></visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>@@ -222,7 +222,7 @@<ranking:ColumnStyle id="column-style" recipe={recipes.ranking.football-column}font={column-font}/><ranking:Column id="football-column" timeline={speech.timeline}- within={vertical.bounds} frame={column-frame} during="timeline" style={column-style}+ within={vertical.bounds} frame={column-frame} during={speech.window} style={column-style}appear-sound={ranking-appear-media.media}move-sound={ranking-move-media.media}><ranking:ColumnItem id="ronaldo" rank="1" label="Ronaldo"diff --git a/examples/ranking-football/swap-host.svml b/examples/ranking-football/swap-host.svmlindex 9113e10f..c68b11c5 100644--- a/examples/ranking-football/swap-host.svml+++ b/examples/ranking-football/swap-host.svml@@ -244,7 +244,7 @@<visual:Clip id="messi-semantic-source" media={messi-media.media} during={speech.messi-semantic} frame={speech-frame} z="0" fit="cover"/></visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>@@ -254,7 +254,7 @@font={tier-font}/><ranking:TierBoard id="football-tiers" timeline={speech.timeline}within={vertical.bounds} frame={tier-frame}- during="timeline" style={tier-style}+ during={speech.window} style={tier-style}appear-sound={ranking-appear-media.media}move-sound={ranking-move-media.media}><ranking:TierItem id="yamal" tier="s" preset="true" icon={yamal-icon.image}/>diff --git a/examples/ranking-football/swap-topic.svml b/examples/ranking-football/swap-topic.svmlindex 0f820232..b0365e69 100644--- a/examples/ranking-football/swap-topic.svml+++ b/examples/ranking-football/swap-topic.svml@@ -274,7 +274,7 @@<visual:Clip id="sam-semantic-source" media={sam-media.media} during={speech.sam-semantic} frame={speech-frame} z="0" fit="cover"/></visual:Track><audio-track:Track id="music-bed" timeline={speech.timeline}>- <audio-track:Clip source={soundtrack-media.media} during="timeline"+ <audio-track:Clip source={soundtrack-media.media} during={speech.window}gain="0.12" fade-in="300ms" fade-out="600ms"/></audio-track:Track>@@ -284,7 +284,7 @@font={tier-font}/><ranking:TierBoard id="tech-tiers" timeline={speech.timeline}within={vertical.bounds} frame={tier-frame}- during="timeline" style={tier-style}+ during={speech.window} style={tier-style}appear-sound={ranking-appear-media.media}move-sound={ranking-move-media.media}><ranking:TierItem id="jensen" tier="s" preset="true" icon={jensen-icon.image}/>diff --git a/examples/semantic-composition/chat.svml b/examples/semantic-composition/chat.svmlindex 45f778f2..9df412f2 100644--- a/examples/semantic-composition/chat.svml+++ b/examples/semantic-composition/chat.svml@@ -10,16 +10,21 @@<import as="style" source="./chat.svs"/><time:Clock id="animation-clock" frame-rate="30"/>- <time:Timeline id="animation" clock={animation-clock} end="8s"/>+ <time:Timeline id="animation" clock={animation-clock} end="8s">+ <time:Instant id="question" at="0.5s"/>+ <time:Instant id="reply" at="2s"/>+ <time:Instant id="turn" at="3.5s"/>+ <time:Instant id="reveal" at="5.2s"/>+ </time:Timeline><spatial:Canvas id="canvas" width="540" height="960"/><fonts:Face id="font-face" package="@fontsource-variable/inter" weight="600" style="normal"/><media:FontStack id="font" primary={font-face}/><chat:Scene id="conversation" timeline={animation.timeline} within={canvas.bounds} font={font}- during="timeline" title="Launch crew">- <chat:Message id="question" sender="Maya" side="left" at="0.5s" text="Are we ready to launch?"/>- <chat:Message id="reply" sender="Leo" side="right" at="2s" text="The video is ready."/>- <chat:Message id="turn" sender="Maya" side="left" at="3.5s" text="Great. One tiny change..."/>- <chat:Message id="reveal" sender="Leo" side="right" at="5.2s" text="I left the whole scene editable."/>+ during={animation.window} title="Launch crew">+ <chat:Message id="question" sender="Maya" side="left" at={animation.question} text="Are we ready to launch?"/>+ <chat:Message id="reply" sender="Leo" side="right" at={animation.reply} text="The video is ready."/>+ <chat:Message id="turn" sender="Maya" side="left" at={animation.turn} text="Great. One tiny change..."/>+ <chat:Message id="reveal" sender="Leo" side="right" at={animation.reveal} text="I left the whole scene editable."/></chat:Scene><film:Film id="main" canvas={canvas.canvas} timeline={animation.timeline} appearance={style.film.main}><film:Track source={conversation.visual}/>diff --git a/examples/semantic-composition/packages/chat-scene/README.md b/examples/semantic-composition/packages/chat-scene/README.mdindex 197f8d46..fc1f5fa7 100644--- a/examples/semantic-composition/packages/chat-scene/README.md+++ b/examples/semantic-composition/packages/chat-scene/README.md@@ -13,7 +13,7 @@ For speech-led work, bind the message to the words that introduce it:</chat:Scene>```-The same component can receive a zero-Take `timeline={animation.timeline}` and `at="2s"` for authored animation. A Scene+The same component can receive a graphics-only `timeline={animation.timeline}` and `at="2s"` for authored animation. A Scenehas an outer Window; its message Instants trigger persistent state. `entrance-frames` controls arrivaland scrolling duration independently of those triggers (default 10). Messages stay visible or scrollup as the conversation develops. Message times are on the film clock and must fall inside the Scene.diff --git a/examples/semantic-composition/packages/chat-scene/src/activation.ts b/examples/semantic-composition/packages/chat-scene/src/activation.tsindex 2f2201c5..f49e6e2a 100644--- a/examples/semantic-composition/packages/chat-scene/src/activation.ts+++ b/examples/semantic-composition/packages/chat-scene/src/activation.ts@@ -15,7 +15,7 @@ import { spatialTypes } from "@hypit/hypit/spatial";import type { SpatialFrame } from "@hypit/hypit/spatial";import { assertTemporalInstantFor, temporalTypes } from "@hypit/hypit/temporal";import type { TemporalInstant, TemporalWindow } from "@hypit/hypit/temporal";-import { createTemporalInstantConstruction, createTemporalWindowConstruction, resolveTemporalContext,+import { resolveTemporalInstantReference, resolveTemporalWindowReference, resolveTemporalContext,temporalContextAttributeVocabulary, temporalInstantAttributeNames, temporalInstantAttributeVocabulary,temporalWindowAttributeNames, temporalWindowAttributeVocabulary } from "@hypit/hypit/temporal/markup";import { renderChat } from "./render.js";@@ -57,7 +57,7 @@ const component: ProducerPackage & AdmissionPackage = { producers: [export const decodeSurface: StructuredSurfaceHandler = ({ element, resolveReference }) => {assertAttributes(element, ["id", "timeline", "within", "font", "title", "entrance-frames", ...temporalWindowAttributeNames]);const id = textAttribute(element, "id"), context = resolveTemporalContext({ element, resolveReference });- const window = createTemporalWindowConstruction({ id: `${id}.window`, subjectId: id, element, ...context, resolveReference });+ const window = resolveTemporalWindowReference({ element, resolveReference });const reference = (name: string, type: TypeRef): SurfaceResolvedReference => {const raw = element.attributes[name];if (typeof raw !== "object" || raw.kind !== "reference") throw new Error(`${name} must be a reference.`);@@ -66,8 +66,7 @@ export const decodeSurface: StructuredSurfaceHandler = ({ element, resolveReferereturn found;};const options: ChatOptions = { id, title: textAttribute(element, "title"), entranceFrames: Number(element.attributes["entrance-frames"] ?? "10") };- const records = [...window.records, { id: `${id}.options`, type: types.Options, value: value(options), range: element.range }];- const components = [...window.components], fragments = [...window.fragments];+ const records = [{ id: `${id}.options`, type: types.Options, value: value(options), range: element.range }];const inputs = [{ name: "timeline", type: timelineTypes.timeline }, { name: "within", type: spatialTypes.frame },{ name: "font", type: mediaTypes.fontStack }, { name: "window", type: temporalTypes.window }, { name: "options", type: types.Options }];const bindings: Record<string, SurfaceResolvedReference["ref"]> = { timeline: context.timeline.ref, within: reference("within", spatialTypes.frame).ref,@@ -82,8 +81,7 @@ export const decodeSurface: StructuredSurfaceHandler = ({ element, resolveRefereassertAttributes(child, ["id", "sender", "text", "side", ...temporalInstantAttributeNames]); assertEmptyElement(child);const messageId = textAttribute(child, "id"), side = textAttribute(child, "side");if (side !== "left" && side !== "right") throw new Error("Message side must be left or right.");- const at = createTemporalInstantConstruction({ id: `${id}.${messageId}`, subjectId: messageId, element: child, ...context, resolveReference });- records.push(...at.records); components.push(...at.components); fragments.push(...at.fragments);+ const at = resolveTemporalInstantReference({ element: child, resolveReference });const key = `message-${++index}`;records.push({ id: `${id}.${key}`, type: types.Message, value: value({ id: messageId, sender: textAttribute(child, "sender"), text: textAttribute(child, "text"), side }), range: child.range });inputs.push({ name: key, type: types.Message }, { name: `${key}-at`, type: temporalTypes.instant });@@ -95,11 +93,11 @@ export const decodeSurface: StructuredSurfaceHandler = ({ element, resolveRefereoperations.push({ id: "render", producer: producers.render, inputs: { messages: operation(previous), options: input("options"),timeline: input("timeline"), within: input("within"), font: input("font"), window: input("window") }, result: { kind: "output", name: "visual" } });const fragment = sealGraphFragment({ inputs, operations, exports: [{ name: "visual", type: compositionTypes.visualTrack, root: operation("render") }] });- return { records, fragments: [...fragments, fragment], components: [...components,- { id, fragment: fragment.id, inputs: bindings, outputs: { visual: `${id}.visual` }, range: element.range }], exports: [`${id}.visual`] };+ return { records, fragments: [fragment], components:+ [{ id, fragment: fragment.id, inputs: bindings, outputs: { visual: `${id}.visual` }, range: element.range }], exports: [`${id}.visual`] };};const declaration = { name: "scene", tag: "Scene", mode: "structured" as const,- outputs: [compositionTypes.visualTrack, timelineTypes.timeline, temporalTypes.window, temporalTypes.instant, temporalTypes.windowSpec, temporalTypes.instantSpec, ...Object.values(types)],+ outputs: [compositionTypes.visualTrack, ...Object.values(types)],vocabulary: { summary: "A conversation whose message arrivals and scrolling form one visual scene.", attributes: [...temporalContextAttributeVocabulary, ...temporalWindowAttributeVocabulary,...["id", "title", "within", "font"].map(name => ({ name, kind: "expression" as const, required: true, summary: name })),@@ -107,7 +105,7 @@ const declaration = { name: "scene", tag: "Scene", mode: "structured" as const,], children: [{ tag: "Message", cardinality: "many" as const, summary: "One authored message and the event that reveals it.", attributes: [...["id", "sender", "text", "side"].map(name => ({ name, kind: "literal" as const, required: true, summary: name })), ...temporalInstantAttributeVocabulary,] }], ports: [{ name: "visual", type: compositionTypes.visualTrack, summary: "The complete conversation scene." }],- example: '<chat:Scene id="chat" timeline={speech.timeline} within={within} font={font} during="timeline" title="Conversation"><chat:Message id="answer" sender="Maya" side="left" text="Here it is." at={story-time.answer}/></chat:Scene>',+ example: '<chat:Scene id="chat" timeline={speech.timeline} within={within} font={font} during={speech.window} title="Conversation"><chat:Message id="answer" sender="Maya" side="left" text="Here it is." at={story-time.answer}/></chat:Scene>',},};export const hypitPackage = { format: "hypit.package@1" as const, modules: [{ manifest }],diff --git a/examples/semantic-composition/packages/responsive-explainer/README.md b/examples/semantic-composition/packages/responsive-explainer/README.mdindex 079ee096..fc5df19d 100644--- a/examples/semantic-composition/packages/responsive-explainer/README.md+++ b/examples/semantic-composition/packages/responsive-explainer/README.md@@ -11,7 +11,7 @@ already available:<explainer:Scene id="scene" timeline={speech.timeline}within={canvas.bounds} font={font} media={speaker-media.media} source-window={speech.speaker}- during="timeline" reveal={story-time.demonstrate} title="Make room for meaning"+ during={speech.window} reveal={story-time.demonstrate} title="Make room for meaning"transition-frames="24" stack-order="0"/><film:Film id="main" canvas={canvas.canvas} timeline={speech.timeline} appearance={look.film}>@@ -21,8 +21,7 @@ already available:</film:Film>```-`during` also accepts a resolved Window; the shared Window syntax supports authored absolute-intervals. `reveal` accepts an absolute Instant, such as the output projected from+`during` accepts a resolved Window. `reveal` accepts an absolute Instant, such as the output projected from`@{demonstrate!}` before the relevant word. Rewriting the Script or using another delivery changesthe upstream projected frame while retaining the layout behavior.`transition-frames` is the duration of that change, separate from the scene's lifetime. `stack-order`diff --git a/examples/semantic-composition/packages/responsive-explainer/src/activation.ts b/examples/semantic-composition/packages/responsive-explainer/src/activation.tsindex 600e162f..9f0103a2 100644--- a/examples/semantic-composition/packages/responsive-explainer/src/activation.ts+++ b/examples/semantic-composition/packages/responsive-explainer/src/activation.ts@@ -17,7 +17,7 @@ import { spatialTypes } from "@hypit/hypit/spatial";import type { SpatialFrame } from "@hypit/hypit/spatial";import { temporalTypes } from "@hypit/hypit/temporal";import type { TemporalInstant, TemporalWindow } from "@hypit/hypit/temporal";-import { createTemporalInstantConstruction, createTemporalWindowConstruction, temporalWindowAttributeNames,+import { resolveTemporalInstantReference, resolveTemporalWindowReference, temporalWindowAttributeNames,temporalWindowAttributeVocabulary, resolveTemporalContext } from "@hypit/hypit/temporal/markup";import { temporalContextAttributeVocabulary } from "@hypit/hypit/temporal/markup";import { renderExplainer } from "./render.js";@@ -67,17 +67,15 @@ export const decodeSurface: StructuredSurfaceHandler = ({ element, resolveRefere};const context = resolveTemporalContext({ element, resolveReference });const timeline = context.timeline;- const window = createTemporalWindowConstruction({ id: `${id}.window`, element, ...context, resolveReference });+ const window = resolveTemporalWindowReference({ element, resolveReference });// Reveal is already absolute; the outer Window independently controls this scene's lifetime.- reference("reveal", temporalTypes.instant);- const reveal = createTemporalInstantConstruction({ id: `${id}.reveal`,- element: { ...element, attributes: { at: element.attributes.reveal! } }, ...context, resolveReference });+ const reveal = resolveTemporalInstantReference({ element, resolveReference, attribute: "reveal" });const options: ExplainerOptions = { id, title: textAttribute(element, "title"),transitionFrames: Number(textAttribute(element, "transition-frames")), stackingOrder: Number(textAttribute(element, "stack-order")) };- return { records: [...window.records, ...reveal.records, { id: `${id}.options`, type: optionsType,+ return { records: [{ id: `${id}.options`, type: optionsType,value: { kind: "inline", value: canonicalize(options) }, range: element.range }],- fragments: [...window.fragments, ...reveal.fragments, fragment],- components: [...window.components, ...reveal.components, { id, fragment: fragment.id,+ fragments: [fragment],+ components: [{ id, fragment: fragment.id,inputs: { timeline: timeline.ref, within: reference("within", spatialTypes.frame).ref,font: reference("font", mediaTypes.fontStack).ref,media: reference("media", mediaTypes.synchronized).ref,@@ -87,8 +85,7 @@ export const decodeSurface: StructuredSurfaceHandler = ({ element, resolveRefereexports: [`${id}.visual`] };};const declaration = { name: "scene", tag: "Scene", mode: "structured" as const,- outputs: [compositionTypes.visualTrack, temporalTypes.window, temporalTypes.instant, temporalTypes.duration,- temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.windowSpec, temporalTypes.instantSpec, optionsType],+ outputs: [compositionTypes.visualTrack, optionsType],vocabulary: { summary: "A continuously playing performance makes room for a diagram on a semantic Moment.",attributes: [...["id", "title", "transition-frames", "stack-order"].map(name => ({ name, kind: "literal" as const, required: true, summary: name })),@@ -99,7 +96,7 @@ const declaration = { name: "scene", tag: "Scene", mode: "structured" as const,.map(({ name, type }) => ({ name, kind: "reference" as const, required: true, accepts: [type], summary: name })),...temporalWindowAttributeVocabulary,], ports: [{ name: "visual", type: compositionTypes.visualTrack, summary: "The coordinated scene." }],- example: '<explainer:Scene id="scene" timeline={speech.timeline} within={within} font={font} media={presenter.media} source-window={speech.presenter} during="timeline" reveal={story-time.reveal} title="How it works" transition-frames="18" stack-order="0"/>',+ example: '<explainer:Scene id="scene" timeline={speech.timeline} within={within} font={font} media={presenter.media} source-window={speech.presenter} during={speech.window} reveal={story-time.reveal} title="How it works" transition-frames="18" stack-order="0"/>',},};export const hypitPackage = { format: "hypit.package@1" as const, modules: [{ manifest }],diff --git a/packages/audio-track/README.md b/packages/audio-track/README.mdindex 217be45b..b21a9ad5 100644--- a/packages/audio-track/README.md+++ b/packages/audio-track/README.md@@ -12,21 +12,23 @@ destination Window. The Track publishes `.program` for declared tooling and `.aupeer contribution to Film.```svml+<time:Window id="reveal-hit-window" timeline={program.timeline}+ from={story-time.reveal} for="600ms"/>+<audio:Track id="mix" timeline={program.timeline}><audio:Clip id="voice" source={speaker-media.media} during={program.speaker}/>- <audio:Clip id="music" source={music-media.media} during="timeline"+ <audio:Clip id="music" source={music-media.media} during={program.window}gain="0.18" fade-in="12f" fade-out="18f"><audio:Map target-at="end" source-at="end" rate="1"wrap-from="start" wrap-until="end"/></audio:Clip><audio:Clip id="reveal-hit" source={hit-media.media}- from={story-time.reveal} for="600ms" gain="0.45"/>+ during={reveal-hit-window} gain="0.45"/></audio:Track>```-`during` consumes a resolved Window or the whole Timeline. The alternative absolute form supplies-exactly two of `from`, `until` and `for`. Semantic, beat or other domain coordinates are projected to-Instants/Windows upstream; Audio Track does not recognize those domains.+`during` consumes a resolved Window. Timeline authoring or a domain projector declares that value+upstream; Audio Track neither constructs time ranges nor recognizes semantic, beat or other domains.`gain` is a linear multiplier and fades default to zero. Omitting Map means bounded partial identity:target start maps to source start at native rate, and excess Window time is silent. One `Map` relatesdiff --git a/packages/audio-track/src/manifest.ts b/packages/audio-track/src/manifest.tsindex eb644e98..ab263999 100644--- a/packages/audio-track/src/manifest.ts+++ b/packages/audio-track/src/manifest.ts@@ -76,8 +76,6 @@ const clipInputs = [export const audioTrackMarkupSurfaces = [{name: "track", tag: "Track", mode: "structured",outputs: [audioTrackTypes.header, audioTrackTypes.sourceTime, audioTrackTypes.clipSpec,- temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec,- temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window,audioTrackTypes.program, compositionTypes.audioTrack],vocabulary: {summary: "Places ordinary audio Clips on one completed Timeline and mixes them into one AudioTrack.",@@ -104,7 +102,7 @@ export const audioTrackMarkupSurfaces = [{],example: `<audio:Track id="mix" timeline={program.timeline}><audio:Clip source={voice-media.media} during={program.voice}/>- <audio:Clip source={music-media.media} during="timeline" gain="0.18">+ <audio:Clip source={music-media.media} during={program.window} gain="0.18"><audio:Map rate="1" wrap-from="start" wrap-until="end"/></audio:Clip></audio:Track>`,diff --git a/packages/audio-track/src/surface.ts b/packages/audio-track/src/surface.tsindex 7a2bf872..6047195d 100644--- a/packages/audio-track/src/surface.ts+++ b/packages/audio-track/src/surface.ts@@ -2,7 +2,7 @@ import { mediaTypes } from "@hypit/hypit/media";import type { MarkupAttributeValue, StructuredElement, StructuredSurfaceHandler, SurfaceRecordDraft, SurfaceResolvedReference } from "@hypit/hypit/markup";import type { TemporalDuration } from "@hypit/hypit/temporal";import {- createTemporalWindowConstruction,+ resolveTemporalWindowReference,resolveTemporalContext,temporalWindowAttributeNames,} from "@hypit/hypit/temporal/markup";@@ -211,8 +211,6 @@ export const decodeAudioTrackSurface: StructuredSurfaceHandler = ({ element, resvalue: { kind: "inline", value: sealAudioTrackHeader({ id }) },range: element.range,}];- const components = [] as ReturnType<typeof createTemporalWindowConstruction>["components"][number][];- const fragments = [] as ReturnType<typeof createTemporalWindowConstruction>["fragments"][number][];const clips: Parameters<typeof createAudioTrackFragment>[0][number][] = [];const inputs: Record<string, SurfaceResolvedReference["ref"] | { readonly kind: "record"; readonly id: string }> = {header: { kind: "record", id: headerId },@@ -239,10 +237,7 @@ export const decodeAudioTrackSurface: StructuredSurfaceHandler = ({ element, resconst suffix = String(clipIndex).padStart(4, "0");const clipId = optionalText(child, "id") ?? `${id}.clip.${suffix}`;const source = resolved(child.attributes.source, `${child.name}.source`, mediaTypes.synchronized, resolveReference);- const temporal = createTemporalWindowConstruction({ id: clipId, element: child, ...context, resolveReference });- records.push(...temporal.records);- components.push(...temporal.components);- fragments.push(...temporal.fragments);+ const window = resolveTemporalWindowReference({ element: child, resolveReference });const sourceTime = sourceTimeFrom(child, resolveReference);const spec = sealAudioClipSpec({id: clipId,@@ -258,7 +253,7 @@ export const decodeAudioTrackSurface: StructuredSurfaceHandler = ({ element, resconst specName = `clip-${suffix}-spec`;const specId = `${id}.clip.${suffix}.spec`;records.push({ id: specId, type: audioTrackTypes.clipSpec, value: { kind: "inline", value: spec }, range: child.range });- inputs[windowName] = temporal.ref;+ inputs[windowName] = window.ref;inputs[mediaName] = source.ref;inputs[specName] = { kind: "record", id: specId };clips.push({ mediaName, specName, windowName });@@ -267,14 +262,14 @@ export const decodeAudioTrackSurface: StructuredSurfaceHandler = ({ element, resconst fragment = createAudioTrackFragment(clips);return {records,- components: [...components, {+ components: [{id,fragment: fragment.id,inputs,outputs: { program: `${id}.program`, audio: `${id}.audio` },range: element.range,}],- fragments: [...fragments, fragment],+ fragments: [fragment],exports: [`${id}.audio`, `${id}.program`],};};diff --git a/packages/audio-track/test/audio-track.test.ts b/packages/audio-track/test/audio-track.test.tsindex ab4701e3..3714021b 100644--- a/packages/audio-track/test/audio-track.test.ts+++ b/packages/audio-track/test/audio-track.test.ts@@ -33,7 +33,7 @@ import type { NarrativeMomentRef, NarrativeSelectionRef } from "@hypit/narrativeimport { narrativeManifest } from "@hypit/narrative";import { compileAudioProgramPlan } from "@hypit/media-operations";import type { ModuleManifest } from "@hypit/protocol";-import { temporalProducers } from "@hypit/temporal";+import { temporalDependency, temporalTypes } from "@hypit/temporal";import type { TemporalDuration } from "@hypit/temporal";import { speechEvidenceManifest } from "@hypit/speech-evidence";import { narrativeTemporalManifest } from "@hypit/narrative-temporal";@@ -312,13 +312,13 @@ test("the self-described Audio Surface parses into the same finite Producer grapconst fixtureSurfaceDigest = fixtureResource("example.audio-inputs/surface@1");const fixtureSurface = {name: "inputs", tag: "Inputs", mode: "structured",- outputs: [mediaTypes.synchronized, timelineTypes.timeline],+ outputs: [mediaTypes.synchronized, timelineTypes.timeline, temporalTypes.window],} as const;const fixtureManifest: ModuleManifest = {format: "hypit.module@1",name: fixtureModule.name,version: fixtureModule.version,- dependencies: [mediaDependency, timelineDependency],+ dependencies: [mediaDependency, timelineDependency, temporalDependency],types: [],capabilities: [],producers: [],@@ -342,6 +342,8 @@ test("the self-described Audio Surface parses into the same finite Producer graprecords: [{ id: "source", type: mediaTypes.synchronized, value: { kind: "inline", value: media("surface", 48_000) }, range: element.range },{ id: "semantic", type: timelineTypes.timeline, value: { kind: "inline", value: semantic }, range: element.range },+ { id: "whole", type: temporalTypes.window, value: { kind: "inline", value: projectProgramWindow({ itemId: "whole",+ semantic, projection: { start: { ref: "timeline.start" }, end: { ref: "timeline.end" } } }) }, range: element.range },],components: [],fragments: [],@@ -368,7 +370,7 @@ test("the self-described Audio Surface parses into the same finite Producer grap<import as="audio" from="@hypit/audio-track@1"/><fixture:Inputs/><audio:Track id="sound" timeline={semantic}>- <audio:Clip source={source} during="timeline" gain="0.5" fade-in="2f" fade-out="3f">+ <audio:Clip source={source} during={whole} gain="0.5" fade-in="2f" fade-out="3f"><audio:Map target-at="end" source-at="end" rate="1" wrap-from="start" wrap-until="end"/></audio:Clip></audio:Track>@@ -388,9 +390,6 @@ test("the self-described Audio Surface parses into the same finite Producer grapaudioTrackProducers.createSet.name,audioTrackProducers.appendClip.name,audioTrackProducers.finalize.name,- temporalProducers.projectProgramInstant.name,- temporalProducers.projectProgramInstant.name,- temporalProducers.composeWindow.name,audioTrackProducers.render.name,].sort());});diff --git a/packages/caption-fine/src/manifest.ts b/packages/caption-fine/src/manifest.tsindex 4bc78908..60adedf7 100644--- a/packages/caption-fine/src/manifest.ts+++ b/packages/caption-fine/src/manifest.ts@@ -298,7 +298,7 @@ export const captionFineMarkupSurfaces = [},},{- name: "caption", tag: "Caption", mode: "structured", outputs: [captionFineTypes.schedule, compositionTypes.visualTrack, captionTypes.program, captionTypes.header, captionTypes.filter, temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window],+ name: "caption", tag: "Caption", mode: "structured", outputs: [captionFineTypes.schedule, compositionTypes.visualTrack, captionTypes.program, captionTypes.header, captionTypes.filter],vocabulary: {summary: "Renders an authored CaptionDocument at its already resolved CaptionTiming as one ordinary peer VisualTrack.",appearance: "One block of caption text wrapped into lines inside a rounded Cue box, placed at a Recipe-chosen point in the selected Frame and spanning a fraction of its width. Cues follow the speech one after another, each arriving and leaving with its own motion, and the Words of a Cue either stand there together from its first Frame or uncover as they are spoken. As the speech advances, the Word being spoken, or every Word up to it, is repainted in the active Paint, snapping at the Word boundary or sweeping across the glyphs, and it may take a rule beneath it, a rounded highlight capsule behind it and a brief pop at the moment it becomes the spoken one. That capsule either stands alone on each Atom or grows as one continuous run over everything already read, following the Words across line breaks.\n\nEvery Cue uses the ordered exact font stack its Style names, with fallback faces supplying glyphs for other scripts. Emphasis varies by timed unit through the active Paint. Lines follow the common flow, so a line cannot be given a separate face, colour or weight of its own. A caption whose lines are set in different typefaces is outside what this Caption can draw.",diff --git a/packages/caption-fine/src/schedule.ts b/packages/caption-fine/src/schedule.tsindex d6431385..372b5ea0 100644--- a/packages/caption-fine/src/schedule.ts+++ b/packages/caption-fine/src/schedule.ts@@ -75,11 +75,11 @@ export function scheduleFineCaption(const contentCues = fineCaptionContentCues(timing, document);const cues: FineCaptionScheduledCue[] = [];for (const [index, use] of program.uses.entries()) {- if (use.window.start.timelineId !== timing.timelineId) throw new Error("Caption Use belongs to another Timeline");+ if (use.window !== undefined && use.window.start.timelineId !== timing.timelineId) throw new Error("Caption Use belongs to another Timeline");const style = parameters.get(use.styleId);if (style === undefined) continue; // Hidden still participates in coverage below.const desired = contentCues.filter(cue => use.role === undefined || units.get(cue.units[0]!.unitId)?.role === use.role).map((cue): FineCaptionScheduledCue => ({- id: `${use.window.subjectId}:${cue.id}`, cueId: cue.id, styleId: use.styleId,+ id: `${use.id}:${cue.id}`, cueId: cue.id, styleId: use.styleId,timedStartFrame: cue.startFrame, timedEndFrameExclusive: cue.endFrameExclusive,visibleStartFrame: Math.max(0, cue.startFrame - style.timing.leadFrames),visibleEndFrameExclusive: cue.endFrameExclusive + style.timing.tailFrames,diff --git a/packages/caption-fine/src/studio.ts b/packages/caption-fine/src/studio.tsindex 650bbfa7..02094bf7 100644--- a/packages/caption-fine/src/studio.ts+++ b/packages/caption-fine/src/studio.ts@@ -1,4 +1,3 @@-import { temporalTypes } from "@hypit/hypit/temporal";import type { CaptionDocument, CaptionProgram, CaptionTiming } from "@hypit/hypit/caption";import { captionTypes } from "@hypit/hypit/caption";import { compositionTypes } from "@hypit/hypit/composition";@@ -134,21 +133,20 @@ export function projectCaptionContents(context: StudioTrackCompanionContext): reexport function projectCaption(context: StudioTrackCompanionContext): readonly StudioEntityDraft[] {const program = requiredSurfaceValue(context, "program") as CaptionProgram;- const uses: StudioEntityDraft[] = program.uses.map((use, index) => {- const authoredId = use.window.subjectId;- const child = authoredChildFor(context, authoredId, [temporalTypes.windowSpec]);- if (child === undefined) throw new Error(`Caption Use ${authoredId} has no author provenance.`);- const temporal = temporalLineageFor(context, authoredId, "window");+ const uses: StudioEntityDraft[] = program.uses.flatMap((use, index) => {+ if (use.window === undefined) return [];+ const child = authoredChildFor(context, use.id, []);+ const temporal = temporalLineageFor(context, use.window.subjectId, "window");const semantic = temporalDomainSource(temporal);- return {- id: `${context.track.outputRef}:use:${authoredId}`, authoredId,+ return [{+ id: `${context.track.outputRef}:use:${use.id}`, authoredId: use.id,display: { title: use.styleId, layers: [] },- ...use.window.span, stackOrder: index, elementRange: child.range,+ ...use.window.span, stackOrder: index, ...(child === undefined ? {} : { elementRange: child.range }),...(temporal === undefined ? {} : { temporal }),...(semantic === undefined ? {} : { markerId: semantic.id }),presentation: { entity: "caption-use", chrome: "standard" }, band: "uses",inspector: [{ id: "range", label: "Range", domain: "when", section: { id: "placement", label: "Placement" }, value: `${use.window.span.startFrame}–${use.window.span.endFrameExclusive}`, unit: "f" }],- };+ }];});return [...projectCaptionContents(context), ...uses];}diff --git a/packages/caption-fine/src/surface.ts b/packages/caption-fine/src/surface.tsindex 2d297f05..d8c06959 100644--- a/packages/caption-fine/src/surface.ts+++ b/packages/caption-fine/src/surface.ts@@ -12,7 +12,7 @@ import { sealGraphFragment } from "@hypit/hypit/author";import type { FragmentOperation } from "@hypit/hypit/author";import type { SurfaceRecordDraft, SurfaceComponentDraft } from "@hypit/hypit/markup";import { assertEmptyElement, optionalTextAttribute } from "@hypit/hypit/markup";-import { createTemporalWindowConstruction, resolveTemporalContext, temporalWindowAttributeNames } from "@hypit/hypit/temporal/markup";+import { resolveTemporalContext, resolveTemporalWindowReference, temporalWindowAttributeNames } from "@hypit/hypit/temporal/markup";import { temporalTypes } from "@hypit/hypit/temporal";import { compositionTypes } from "@hypit/hypit/composition";import { captionFineProducers, captionFineTypes } from "./manifest.js";@@ -141,19 +141,23 @@ export const decodeFineCaptionTrackSurface: StructuredSurfaceHandler = ({ elemenassertEmptyElement(child);index += 1;const useId = optionalTextAttribute(child, "id") ?? `${id}.use.${index}`;- const hasTime = temporalWindowAttributeNames.some(name => child.attributes[name] !== undefined);- const temporal = createTemporalWindowConstruction({ id: useId, ...context, resolveReference,- element: hasTime ? child : { ...child, attributes: { ...child.attributes, during: "timeline" } } });- records.push(...temporal.records); components.push(...temporal.components); fragments.push(...temporal.fragments);+ const window = child.attributes.during === undefined+ ? undefined+ : resolveTemporalWindowReference({ element: child, resolveReference });const style = reference(child, "style", captionTypes.style, resolveReference);const role = optionalTextAttribute(child, "role");const filterId = `${useId}.filter`;- records.push({ id: filterId, type: captionTypes.filter, value: { kind: "inline", value: role === undefined ? {} : { role } }, range: child.range });+ records.push({ id: filterId, type: captionTypes.filter, value: { kind: "inline", value: {+ id: useId, ...(role === undefined ? {} : { role }),+ } }, range: child.range });const key = `use-${index}`;- inputs.push({ name: `${key}-window`, type: temporalTypes.window }, { name: `${key}-style`, type: captionTypes.style }, { name: `${key}-filter`, type: captionTypes.filter });- bindings[`${key}-window`] = temporal.ref; bindings[`${key}-style`] = style.ref; bindings[`${key}-filter`] = { kind: "record", id: filterId };- operations.push({ id: key, producer: captionProducers.append,- inputs: { program: operation(previous), window: input(`${key}-window`), style: input(`${key}-style`), filter: input(`${key}-filter`) }, result: { kind: "output", name: "program" } });+ inputs.push(...(window === undefined ? [] : [{ name: `${key}-window`, type: temporalTypes.window }]),+ { name: `${key}-style`, type: captionTypes.style }, { name: `${key}-filter`, type: captionTypes.filter });+ if (window !== undefined) bindings[`${key}-window`] = window.ref;+ bindings[`${key}-style`] = style.ref; bindings[`${key}-filter`] = { kind: "record", id: filterId };+ operations.push({ id: key, producer: window === undefined ? captionProducers.appendUnbounded : captionProducers.append,+ inputs: { program: operation(previous), ...(window === undefined ? {} : { window: input(`${key}-window`) }),+ style: input(`${key}-style`), filter: input(`${key}-filter`) }, result: { kind: "output", name: "program" } });previous = key;}operations.push({ id: "schedule", producer: captionFineProducers.schedule,diff --git a/packages/caption-fine/test/caption-fine.test.ts b/packages/caption-fine/test/caption-fine.test.tsindex 9a911f4d..c8687d0b 100644--- a/packages/caption-fine/test/caption-fine.test.ts+++ b/packages/caption-fine/test/caption-fine.test.ts@@ -86,7 +86,7 @@ function fixture(script = "<line>one two || three four</line>") {id: "captions",documentId: document.id,styles: [style],- uses: [{ styleId: style.id, window: projectProgramWindow({ itemId: "captions.use.1",+ uses: [{ id: "captions.use.1", styleId: style.id, window: projectProgramWindow({ itemId: "captions.use.1",semantic: sealTimeline({ id: "test-space", frameCount: 90, frameRate: { numerator: 30, denominator: 1 } }),projection: { start: { ref: "timeline.start" }, end: { ref: "timeline.end" } },}) }],@@ -476,7 +476,7 @@ test("a Use beginning inside a Cue changes presentation without changing words ounits: [unit(0), unit(1), unit(2), unit(3)] };const emphasis = fineCaptionStyle("emphasis", { ...recipe, properties: { ...recipe.properties, "active-fill": "#FF6347", karaoke: "trail" } }, [font]);const window = (id:string,start:number,end:number) => projectProgramWindow({itemId:id,semantic:timeline,projection:{start:{ref:"absolute",at:{unit:"frames",value:start}},end:{ref:"absolute",at:{unit:"frames",value:end}}}});- const changed: CaptionProgram = { ...program, styles: [...program.styles, emphasis], uses: [...program.uses, { styleId: emphasis.id, window: window("emphasis",30,50) }] };+ const changed: CaptionProgram = { ...program, styles: [...program.styles, emphasis], uses: [...program.uses, { id: "emphasis", styleId: emphasis.id, window: window("emphasis",30,50) }] };const schedule = scheduleFineCaption(projection, changed, document);const cueId = `${document.id}:cue:2`;const parts = schedule.cues.filter(cue=>cue.cueId===cueId);@@ -489,11 +489,11 @@ test("a Use beginning inside a Cue changes presentation without changing words oassert.equal(entered.span.startFrame,20);assert.deepEqual(entered.visibility,[{startFrame:30,endFrameExclusive:40}]);// Rendering the same Style over the whole timeline has identical animation data for this Cue.- const whole: CaptionProgram = {...changed,uses:[{styleId:emphasis.id,window:window("whole",0,90)}]};+ const whole: CaptionProgram = {...changed,uses:[{id:"whole",styleId:emphasis.id,window:window("whole",0,90)}]};const original = renderCaption(scheduleFineCaption(projection,whole,document),whole,document,timeline).presents.find(p=>p.id.endsWith(`:${cueId}`))!;assert.deepEqual(entered.elements,original.elements);- const hidden: CaptionProgram = {...changed,styles:[...changed.styles,{id:"hidden",rendering:null}],uses:[...changed.uses,{styleId:"hidden",window:window("hide",32,35)}]};+ const hidden: CaptionProgram = {...changed,styles:[...changed.styles,{id:"hidden",rendering:null}],uses:[...changed.uses,{id:"hide",styleId:"hidden",window:window("hide",32,35)}]};const resumed = scheduleFineCaption(projection,hidden,document).cues.find(cue=>cue.id===parts[1]!.id)!;assert.deepEqual(resumed.visibility,[{startFrame:30,endFrameExclusive:32},{startFrame:35,endFrameExclusive:40}]);assert.deepEqual(resumed.units,parts[1]!.units);@@ -506,7 +506,7 @@ test("Caption time windows select presentation, while Role filters preserve simuconst overlap: CaptionTiming = {...projection,units:projection.units.map((unit,index)=>index < 2 ? unit: {...unit,startFrame:15+(index-2)*10,endFrameExclusive:25+(index-2)*10})};const hidden: CaptionProgram = {...program,styles:[...program.styles,{id:"hidden",rendering:null}],uses:[...program.uses,{- role:"A",styleId:"hidden",window:projectProgramWindow({itemId:"hideA",semantic:timeline,projection:{start:{ref:"timeline.start"},end:{ref:"timeline.end"}}}),+ id:"hideA",role:"A",styleId:"hidden",window:projectProgramWindow({itemId:"hideA",semantic:timeline,projection:{start:{ref:"timeline.start"},end:{ref:"timeline.end"}}}),}]};const schedule = scheduleFineCaption(overlap,hidden,document);assert.equal(schedule.cues.length,1);@@ -515,7 +515,7 @@ test("Caption time windows select presentation, while Role filters preserve simuassert.deepEqual(scheduleFineCaption(projection,{...program,uses:[],styles:[]},document).cues,[]);});-test("Caption Uses share the temporal author language and reject the removed Program edge", async () => {+test("Caption Uses are either unbounded or consume one declared Window", async () => {const { decodeFineCaptionTrackSurface } = await import("../src/surface.js");const { parseStructuredElement } = await import("@hypit/markup");const { timelineTypes } = await import("@hypit/timeline");@@ -530,18 +530,21 @@ test("Caption Uses share the temporal author language and reject the removed ProresolveReference(path){const type=refs[path];return type===undefined?undefined:{path,type,ref:{kind:"record" as const,id:path}};},resolveAsset(){throw new Error("No assets");},});- for (const time of ['', 'during={window}', 'from="2s" for="2s"', 'until="3s" for="12f"', 'from="2s" until="5s"']) {+ for (const time of ['', 'during={window}']) {const result=await decode(`<fine:Use style={style} ${time}/>`);const track=result.components.find(component=>component.id==="captions")!;assert.ok(track.outputs.program);const fragment=result.fragments!.find(fragment=>fragment.id===track.fragment)!;assert.equal(fragment.inputs.find(port=>port.name==="timing")?.type.name,"CaptionTiming");- assert.ok(fragment.inputs.some(port=>port.name.endsWith("-window")));+ assert.equal(fragment.inputs.some(port=>port.name.endsWith("-window")), time !== "");assert.equal(fragment.inputs.some(port=>port.name==="program"),false);}+ for (const time of ['during="timeline"', 'from="2s" for="2s"', 'until="3s" for="12f"', 'from="2s" until="5s"']) {+ await assert.rejects(()=>decode(`<fine:Use style={style} ${time}/>`));+ }await assert.rejects(()=>decode('<fine:Use style={style}/>', 'semantic={window}'));await assert.rejects(()=>decode('', 'program={old}'),/requires id, document, timing, timeline, within/);- await assert.rejects(()=>decode('<fine:Use style={style} selection={window}/>'),/optional id, role, during, from, until, for/);+ await assert.rejects(()=>decode('<fine:Use style={style} selection={window}/>'),/optional id, role, during/);});test("Fine uses author separators in ordinary text, shared groups, active copies and joined boxes", () => {diff --git a/packages/caption-fine/test/layout.browser.test.ts b/packages/caption-fine/test/layout.browser.test.tsindex a71fb563..e866edb7 100644--- a/packages/caption-fine/test/layout.browser.test.ts+++ b/packages/caption-fine/test/layout.browser.test.ts@@ -22,7 +22,7 @@ function cueHtml(source: string, width: number, extra: Recipe["properties"]): st"anchor-x": "left", "anchor-y": "top", padding: "0", radius: 0, "stack-order": 1, size: 36, width: 1, x: 0, y: 0, "word-gap": 14, "inline-size": "fixed",karaoke: "trail", "active-box": "trail", "active-box-continuity": "joined", "active-box-padding": "0", "active-box-background": "#00800080", "active-box-radius": 0, ...extra,} }, [{ sources: [{ artifact: { kind: "blob", resource: fixtureResource("font"), size: 1, mediaType: "font/woff2" } }], weight: 400, style: "normal" }]);- const program = { id: "p", documentId: document.id, styles: [style], uses: [{ styleId: "plain",+ const program = { id: "p", documentId: document.id, styles: [style], uses: [{ id: "use", styleId: "plain",window: projectProgramWindow({ itemId: "use", semantic: timeline, projection: { start: { ref: "timeline.start" }, end: { ref: "timeline.end" } } }),}] };const timed = { timelineId: timeline.id, documentId: document.id,diff --git a/packages/caption-fine/test/studio-companion.test.ts b/packages/caption-fine/test/studio-companion.test.tsindex e05dce1b..6d06c6bb 100644--- a/packages/caption-fine/test/studio-companion.test.ts+++ b/packages/caption-fine/test/studio-companion.test.ts@@ -100,10 +100,10 @@ test("Caption Uses keep authored windows and child ownership even with no renderconst { timelineFixture } = await import("../../../test/timeline-fixture.js");const { projectProgramWindow } = await import("../../../test/temporal-fixture.js");const timeline = timelineFixture({id:"film",frameCount: 180, frameRate: { numerator: 30, denominator: 1 }}, {segments:[{id:"a",frameCount:90},{id:"b",frameCount:90}]});- const uses = ["base", "hidden"].map(id=>({styleId:id,window:projectProgramWindow({itemId:id,semantic:timeline,projection:{start:{ref:"timeline.start"},end:{ref:"timeline.end"}}})}));+ const uses = ["base", "hidden"].map(id=>({id,styleId:id,window:projectProgramWindow({itemId:id,semantic:timeline,projection:{start:{ref:"timeline.start"},end:{ref:"timeline.end"}}})}));const context = {track:{outputRef:"captions.track",trace:{references:[{input:"document",typeRef:captionTypes.document,ref:"document"},{input:"timing",typeRef:captionTypes.timing,ref:"timing"}],outputPorts:[{name:"schedule",ref:"schedule"},{name:"program",ref:"program"}]}},- placement:{children:uses.map((use,i)=>({range:{start:i*10,end:i*10+8},referenceAttributes:{style:use.styleId},values:[{type:temporalTypes.windowSpec,value:{id:use.window.subjectId}}]}))},+ placement:{children:uses.map((use,i)=>({id:use.id,range:{start:i*10,end:i*10+8},referenceAttributes:{style:use.styleId},values:[]}))},values:new Map<string,unknown>([["document",{id:"document",units:[],words:[]}],["timing",{timelineId:"film",documentId:"document",units:[]}],["schedule",{cues:[]}],["program",{uses}]]),spans:[],temporalBindings:[],} as unknown as StudioTrackCompanionContext;diff --git a/packages/caption/README.md b/packages/caption/README.mdindex fee66c1b..9b5d024a 100644--- a/packages/caption/README.md+++ b/packages/caption/README.md@@ -21,19 +21,20 @@ actually needs and ordered `Use` children. Fine takes one placement Frame:<caption:Hidden id="hidden"/><narrative-caption:Timing id="story-captions" document={story.caption}binding={story.caption-binding} projection={story-time.projection}/>+<time:Window id="impact-window" timeline={film.timeline} from="12s" for="2s"/><caption-fine:Caption id="captions" document={story.caption} timing={story-captions}timeline={film.timeline} within={vertical.bounds}><caption-fine:Use style={plain}/><caption-fine:Use role="GUEST" style={guest}/><caption-fine:Use during={demo-window} style={hidden}/>- <caption-fine:Use from="12s" for="2s" style={impact}/>+ <caption-fine:Use during={impact-window} style={impact}/></caption-fine:Caption>```-Time attributes come from `@hypit/temporal/markup`: `during`, or exactly two of `from`, `until`, and-`for`, including resolved temporal references and explicit frame/second expressions. Omitted time-attributes mean the whole Timeline. Domain adapters must resolve semantic or other domain references-to ordinary absolute Windows/Instants before a Caption family consumes them. `role` filters content independently of time. Later matching+Each bounded Use consumes one resolved Window through `during`. Omitted time means the Use applies+to the complete Caption document; it is the deliberate batch-caption form, not an anonymous Timeline+Window. Domain adapters must resolve semantic or other domain references to ordinary absolute values+before a Caption family consumes them. `role` filters content independently of time. Later matchingUses replace earlier presentation inside their windows, including a Hidden Style. Separate Tracksremain independent and can intentionally display simultaneous captions.diff --git a/packages/caption/src/component.ts b/packages/caption/src/component.tsindex 25dbd22e..8bfb289f 100644--- a/packages/caption/src/component.ts+++ b/packages/caption/src/component.ts@@ -27,9 +27,19 @@ export const captionComponent = {producer: captionProducers.append,handler: ({ inputs }) => ({ outputs: { program: { kind: "inline", value: canonicalize(appendCaptionUse(inline<CaptionProgram>(inputs.program?.value, "CaptionProgram"),+ inline<{id:string}>(inputs.filter?.value, "CaptionContentFilter").id,inline<TemporalWindow>(inputs.window?.value, "TemporalWindow"),inline<CaptionStyleIntent>(inputs.style?.value, "CaptionStyle"),- inline<{role?:string}>(inputs.filter?.value, "CaptionContentFilter").role,+ inline<{id:string;role?:string}>(inputs.filter?.value, "CaptionContentFilter").role,+ )) } }, needs: {} }),+ }, {+ producer: captionProducers.appendUnbounded,+ handler: ({ inputs }) => ({ outputs: { program: { kind: "inline", value: canonicalize(appendCaptionUse(+ inline<CaptionProgram>(inputs.program?.value, "CaptionProgram"),+ inline<{id:string}>(inputs.filter?.value, "CaptionContentFilter").id,+ undefined,+ inline<CaptionStyleIntent>(inputs.style?.value, "CaptionStyle"),+ inline<{id:string;role?:string}>(inputs.filter?.value, "CaptionContentFilter").role,)) } }, needs: {} }),}],validators: [diff --git a/packages/caption/src/manifest.ts b/packages/caption/src/manifest.tsindex 522262bb..63c10421 100644--- a/packages/caption/src/manifest.ts+++ b/packages/caption/src/manifest.ts@@ -5,6 +5,7 @@ export const captionModuleRef = { name: "@hypit/caption", version: "1" } as consexport const captionProducers = {create: { module: captionModuleRef, name: "create-caption-uses" },append: { module: captionModuleRef, name: "append-caption-use" },+ appendUnbounded: { module: captionModuleRef, name: "append-unbounded-caption-use" },} satisfies Record<string, ProducerRef>;export const captionTypes = {document: { module: captionModuleRef, name: "CaptionDocument" },@@ -47,7 +48,8 @@ export const captionProgramSchema: ValueSchema = object({id: { schema: string }, documentId: { schema: string },styles: { schema: { kind: "array", items: captionStyleSchema } },uses: { schema: { kind: "array", items: object({- window: { schema: temporalWindowSchema }, styleId: { schema: string }, role: { schema: string, optional: true },+ id: { schema: string }, window: { schema: temporalWindowSchema, optional: true },+ styleId: { schema: string }, role: { schema: string, optional: true },}) } },});const timedUnit = object({ unitId: { schema: string }, startFrame: { schema: integer }, endFrameExclusive: { schema: integer } });@@ -81,6 +83,11 @@ export const captionManifest: ModuleManifest = {inputs: [{ name: "program", type: captionTypes.program }, { name: "window", type: temporalTypes.window },{ name: "style", type: captionTypes.style }, { name: "filter", type: captionTypes.filter }],outputs: [{ name: "program", type: captionTypes.program }], needs: [],+ }, {+ name: captionProducers.appendUnbounded.name,+ inputs: [{ name: "program", type: captionTypes.program },+ { name: "style", type: captionTypes.style }, { name: "filter", type: captionTypes.filter }],+ outputs: [{ name: "program", type: captionTypes.program }], needs: [],}],};export const captionDependency = { module: captionModuleRef } as const;diff --git a/packages/caption/src/style.ts b/packages/caption/src/style.tsindex f18ac344..bedd46eb 100644--- a/packages/caption/src/style.ts+++ b/packages/caption/src/style.ts@@ -36,9 +36,10 @@ export function assertCaptionProgram(value: CaptionProgram): void {const styles = new Map(value.styles.map(style => [style.id, style]));assert(styles.size === value.styles.length, "Caption Styles are repeated");value.styles.forEach(assertCaptionStyle);- assert(new Set(value.uses.map(use => use.window.subjectId)).size === value.uses.length, "Caption Use ids are repeated");+ assert(new Set(value.uses.map(use => use.id)).size === value.uses.length, "Caption Use ids are repeated");for (const use of value.uses) {- assertTemporalWindowFor(use.window, { subjectId: use.window.subjectId });+ assert(ID.test(use.id), "Caption Use identity is invalid");+ if (use.window !== undefined) assertTemporalWindowFor(use.window, {});assert(styles.has(use.styleId), "Caption Use references an unknown Style");assert(use.role === undefined || use.role.trim().length > 0, "Caption Role is empty");}@@ -48,11 +49,11 @@ export function assertCaptionProgramForDocument(value: CaptionProgram, document:assertCaptionDocumentIdentity(document);assert(value.documentId === document.id, "Caption Uses belong to another CaptionDocument");}-export function appendCaptionUse(program: CaptionProgram, window: TemporalWindow, style: CaptionStyleIntent, role?: string): CaptionProgram {+export function appendCaptionUse(program: CaptionProgram, id: string, window: TemporalWindow | undefined, style: CaptionStyleIntent, role?: string): CaptionProgram {const previous = program.styles.find(item => item.id === style.id);assert(previous === undefined || canonicalStringify(previous) === canonicalStringify(style), `Caption Style ${style.id} has conflicting definitions`);return sealCaptionProgram({ ...program,styles: previous === undefined ? [...program.styles, style] : program.styles,- uses: [...program.uses, { window, styleId: style.id, ...(role === undefined ? {} : { role }) }],+ uses: [...program.uses, { id, ...(window === undefined ? {} : { window }), styleId: style.id, ...(role === undefined ? {} : { role }) }],});}diff --git a/packages/caption/src/types.ts b/packages/caption/src/types.tsindex ac4d524b..b66f9478 100644--- a/packages/caption/src/types.ts+++ b/packages/caption/src/types.ts@@ -48,7 +48,8 @@ export type CaptionStyleIntent = {/** Ordered, resolved Uses owned by a Caption Track, not a separate author element. */export type CaptionUse = {- readonly window: import("@hypit/temporal").TemporalWindow;+ readonly id: string;+ readonly window?: import("@hypit/temporal").TemporalWindow;readonly styleId: string;readonly role?: string;};diff --git a/packages/caption/src/visibility.ts b/packages/caption/src/visibility.tsindex aadb47c5..11021e17 100644--- a/packages/caption/src/visibility.ts+++ b/packages/caption/src/visibility.ts@@ -5,12 +5,12 @@ import type { CaptionProgram } from "./types.js";export function captionUseVisibility(program: CaptionProgram, index: number, role: string | undefined, envelope: FrameSpan): FrameSpan[] {const use = program.uses[index]!;if (use.role !== undefined && use.role !== role) return [];- const startFrame = Math.max(envelope.startFrame, use.window.span.startFrame);- const endFrameExclusive = Math.min(envelope.endFrameExclusive, use.window.span.endFrameExclusive);+ const startFrame = Math.max(envelope.startFrame, use.window?.span.startFrame ?? envelope.startFrame);+ const endFrameExclusive = Math.min(envelope.endFrameExclusive, use.window?.span.endFrameExclusive ?? envelope.endFrameExclusive);let visible = endFrameExclusive > startFrame ? [{ startFrame, endFrameExclusive }] : [];for (const later of program.uses.slice(index + 1)) {if (later.role !== undefined && later.role !== role) continue;- const cut = later.window.span;+ const cut = later.window?.span ?? envelope;visible = visible.flatMap(span => {if (cut.startFrame >= span.endFrameExclusive || cut.endFrameExclusive <= span.startFrame) return [span];return [diff --git a/packages/comment-sticker/README.md b/packages/comment-sticker/README.mdindex 7e05856d..9150149a 100644--- a/packages/comment-sticker/README.md+++ b/packages/comment-sticker/README.md@@ -1,8 +1,7 @@# `@hypit/comment-sticker`-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.+The Track Surface accepts `timeline={program.timeline}`. Each Sticker consumes a previously declared+absolute Window; semantic or other domain coordinates are projected upstream.An author package for timed social-comment cards. It publishes an ordinary `VisualTrack` containingthe cards' independently timed appearances.@@ -29,7 +28,7 @@ The author surface keeps the three independent concerns visible:style={social-comment}author={comment-author}meta="Featured comment"- during="timeline"+ during={speech.window}/></comment:Track>```diff --git a/packages/comment-sticker/src/manifest.ts b/packages/comment-sticker/src/manifest.tsindex 7d9286e2..ce6f71ce 100644--- a/packages/comment-sticker/src/manifest.ts+++ b/packages/comment-sticker/src/manifest.ts@@ -266,7 +266,7 @@ export const commentStickerMarkupSurfaces = [],},},- { name: "track", tag: "Track", mode: "structured", outputs: [textTypes.text, commentStickerTypes.header, commentStickerTypes.itemSpec, temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, commentStickerTypes.program, compositionTypes.visualTrack],+ { name: "track", tag: "Track", mode: "structured", outputs: [textTypes.text, commentStickerTypes.header, commentStickerTypes.itemSpec, commentStickerTypes.program, compositionTypes.visualTrack],vocabulary: {summary: "Places social comment cards over the Program and renders them as one self-contained VisualTrack.",appearance: "One rounded card per Sticker, tilted a couple of degrees and lifted on a soft drop shadow, drawn at the place and size its picture-plane Frame gives it, with a small triangular speech tail hanging from the card's lower edge. Inside the card a circular avatar sits at the left — the supplied image Artifact, or a filled disc bearing the author's initial — and a text column runs beside it from top to bottom: a small faint header line such as `Reply to @viewer's comment`, then the comment copy in large heavy type wrapped to a few lines and ellipsized, then a small faint metadata row pinned to the card's bottom edge when one is supplied. Each card keeps its own window rather than a shared one: it pops in scaling up and unwinding its tilt, rises and rocks gently while it holds, then fades upward as it leaves. Cards are placed by their Frames alone, so several stand on screen at once and none reflows around another.",diff --git a/packages/comment-sticker/src/surface.ts b/packages/comment-sticker/src/surface.tsindex 0997e841..3fb55078 100644--- a/packages/comment-sticker/src/surface.ts+++ b/packages/comment-sticker/src/surface.ts@@ -6,8 +6,8 @@ import { spatialTypes } from "@hypit/hypit/spatial";import { recipeType } from "@hypit/hypit/recipe";import type { Recipe } from "@hypit/hypit/recipe";import { sealText, textTypes } from "@hypit/hypit/text";-import type { StructuredElement, StructuredSurfaceHandler, SurfaceComponentDraft, SurfaceRecordDraft, SurfaceResolvedReference, MarkupAttributeValue } from "@hypit/hypit/markup";-import { createTemporalWindowConstruction, temporalWindowAttributeNames } from "@hypit/hypit/temporal/markup";+import type { StructuredElement, StructuredSurfaceHandler, SurfaceRecordDraft, SurfaceResolvedReference, MarkupAttributeValue } from "@hypit/hypit/markup";+import { resolveTemporalWindowReference, temporalWindowAttributeNames } from "@hypit/hypit/temporal/markup";import { decodeCommentStickerStyle } from "./author.js";import { createCommentStickerFragment } from "./fragment.js";@@ -91,8 +91,6 @@ export const decodeCommentStickerTrackSurface: StructuredSurfaceHandler = ({ elevalue: { kind: "inline", value: sealCommentStickerHeader({ id }) },range: element.range,}];- const temporalComponents: SurfaceComponentDraft[] = [];- const temporalFragments: ReturnType<typeof createTemporalWindowConstruction>["fragments"][number][] = [];const inputs: Record<string, typeof context.timeline.ref> = { header: { kind: "record", id: headerId }, timeline: context.timeline.ref };const items: Parameters<typeof createCommentStickerFragment>[0][number][] = [];for (const child of element.children) {@@ -104,8 +102,7 @@ export const decodeCommentStickerTrackSurface: StructuredSurfaceHandler = ({ eleif (child.children.some((node) => node.kind === "element")) throw new Error(`${child.name} accepts plain comment text only.`);allowed(child, ["id", "comment", "frame", "style", "avatar", "author", "header", "meta", ...TIMING], ["id", "frame", "style"]);const itemId = text(child, "id");- const temporal = createTemporalWindowConstruction({ id: itemId, element: child, ...context, resolveReference });- records.push(...temporal.records); temporalComponents.push(...temporal.components); temporalFragments.push(...temporal.fragments);+ const window = resolveTemporalWindowReference({ element: child, resolveReference });const suffix = String(items.length + 1).padStart(4, "0");const frame = reference(child.attributes.frame, `${child.name}.frame`, spatialTypes.frame, resolveReference);const style = reference(child.attributes.style, `${child.name}.style`, commentStickerTypes.style, resolveReference);@@ -132,7 +129,7 @@ export const decodeCommentStickerTrackSurface: StructuredSurfaceHandler = ({ ele});const windowName = `item-${suffix}-window`;const specName = `item-${suffix}-spec`; const frameName = `item-${suffix}-frame`; const styleName = `item-${suffix}-style`;- inputs[specName] = { kind: "record", id: specId }; inputs[windowName] = temporal.ref;+ inputs[specName] = { kind: "record", id: specId }; inputs[windowName] = window.ref;inputs[frameName] = frame.ref; inputs[styleName] = style.ref;const attachText = (field: string, value: string | SurfaceResolvedReference): string => {const name = `item-${suffix}-${field}`;@@ -156,8 +153,8 @@ export const decodeCommentStickerTrackSurface: StructuredSurfaceHandler = ({ eleconst fragment = createCommentStickerFragment(items);return {records,- components: [...temporalComponents, { id, fragment: fragment.id, inputs, outputs: { program: `${id}.program`, visual: `${id}.visual` }, range: element.range }],- fragments: [...temporalFragments, fragment],+ components: [{ id, fragment: fragment.id, inputs, outputs: { program: `${id}.program`, visual: `${id}.visual` }, range: element.range }],+ fragments: [fragment],exports: [`${id}.program`, `${id}.visual`],};};diff --git a/packages/comment-sticker/test/comment-sticker.test.ts b/packages/comment-sticker/test/comment-sticker.test.tsindex 5a64c071..2399d112 100644--- a/packages/comment-sticker/test/comment-sticker.test.ts+++ b/packages/comment-sticker/test/comment-sticker.test.ts@@ -16,7 +16,7 @@ import { parseStructuredElement } from "@hypit/markup";import type { SurfaceResolvedReference } from "@hypit/markup";import { sealText } from "@hypit/text";import { textTypes } from "@hypit/text";-import { temporalProducers } from "@hypit/temporal";+import { temporalTypes } from "@hypit/temporal";import {appendProjectedCommentSticker,@@ -172,11 +172,13 @@ test("Track Surface lowers mixed literal and resolved-Window Stickers to a finit["social", authored("social", commentStickerTypes.style, style)],["avatar", authored("avatar", blobTypes.blob, blob)],["copy", authored("copy", textTypes.text, sealText("This is graph-supplied comment content."))],+ ["whole", authored("whole", temporalTypes.window, projectProgramWindow({ itemId: "whole", semantic,+ projection: { start: { ref: "timeline.start" }, end: { ref: "timeline.end" } } }))],]);const result = await decodeCommentStickerTrackSurface({sourceName: "fixture.svml",element: parsed(`<comment:Track id="comments" timeline={video.timeline}>- <comment:Sticker id="one" comment={copy} frame={layout.comment} style={social} avatar={avatar} author="@viewer" meta="Featured" during="timeline"/>+ <comment:Sticker id="one" comment={copy} frame={layout.comment} style={social} avatar={avatar} author="@viewer" meta="Featured" during={whole}/></comment:Track>`),resolveReference: (path) => refs.get(path),resolveAsset: noAsset,@@ -189,9 +191,6 @@ test("Track Surface lowers mixed literal and resolved-Window Stickers to a finitcommentStickerProducers.setContentMeta.name,commentStickerProducers.appendItemAvatar.name,commentStickerProducers.finalize.name,- temporalProducers.projectProgramInstant.name,- temporalProducers.projectProgramInstant.name,- temporalProducers.composeWindow.name,commentStickerProducers.render.name,].sort());assert.equal(result.components.find((component) => component.outputs.visual !== undefined)?.outputs.visual, "comments.visual");diff --git a/packages/depth-stack/src/manifest.ts b/packages/depth-stack/src/manifest.tsindex fb37d169..96bceb91 100644--- a/packages/depth-stack/src/manifest.ts+++ b/packages/depth-stack/src/manifest.ts@@ -157,7 +157,6 @@ export const depthStackMarkupSurfaces = [depthStackTypes.header, depthStackTypes.spec, depthStackTypes.cardSpec,spatialTypes.fit, visualTrackTypes.sampleLayerSpec, visualTrackTypes.paintLayerSpec,depthStackTypes.cardLabel, depthStackTypes.cardLabelStyle, textTypes.text,- temporalTypes.instantSpec, temporalTypes.instant,depthStackTypes.program, compositionTypes.visualTrack,],vocabulary: {diff --git a/packages/depth-stack/src/surface.ts b/packages/depth-stack/src/surface.tsindex e7170656..b6054fc4 100644--- a/packages/depth-stack/src/surface.ts+++ b/packages/depth-stack/src/surface.ts@@ -6,7 +6,7 @@ import { visualTrackTypes } from "@hypit/visual-track";import type { TypeRef } from "@hypit/hypit/protocol";import { spatialTypes } from "@hypit/hypit/spatial";import { recipeType } from "@hypit/hypit/recipe";-import { createTemporalInstantConstruction, temporalInstantAttributeNames } from "@hypit/hypit/temporal/markup";+import { resolveTemporalInstantReference, temporalInstantAttributeNames } from "@hypit/hypit/temporal/markup";import type { Recipe } from "@hypit/hypit/recipe";import { sealText, textTypes } from "@hypit/hypit/text";import { sealGraphFragment } from "@hypit/hypit/author";@@ -179,13 +179,8 @@ export const decodeDepthStackSurface: StructuredSurfaceHandler = ({ element, resconst context = resolveTemporalContext({ element, resolveReference });const frame = reference(element.attributes.frame, `${element.name}.frame`, spatialTypes.frame, resolveReference);const appearance = recipe(element.attributes.appearance, `${element.name}.appearance`, resolveReference);- const terminal = createTemporalInstantConstruction({- id: `${id}.terminal`, subjectId: id, element, ...context, resolveReference,- attribute: "until",- });- const records: SurfaceRecordDraft[] = [...terminal.records];- const temporalComponents: SurfaceComponentDraft[] = [...terminal.components];- const temporalFragments = [...terminal.fragments];+ const terminal = resolveTemporalInstantReference({ element, resolveReference, attribute: "until" });+ const records: SurfaceRecordDraft[] = [];const headerId = `${id}.header`;const specId = `${id}.spec`;records.push(@@ -216,8 +211,7 @@ export const decodeDepthStackSurface: StructuredSurfaceHandler = ({ element, res: reference(child.attributes.extent, `${child.name}.extent`, spatialTypes.extent, resolveReference);if (sourceKind === "still" && extent === undefined) throw new Error(`${child.name}.extent is required for a still image.`);if (sourceKind !== "still" && extent !== undefined) throw new Error(`${child.name}.extent belongs only to a still image.`);- const activation = createTemporalInstantConstruction({ id: `${id}.${cardId}`, subjectId: cardId, element: child, ...context, resolveReference });- records.push(...activation.records); temporalComponents.push(...activation.components); temporalFragments.push(...activation.fragments);+ const activation = resolveTemporalInstantReference({ element: child, resolveReference });const cardAppearance = child.attributes.appearance === undefined? appearance : recipe(child.attributes.appearance, `${child.name}.appearance`, resolveReference);const material = decodeDepthStackMaterial(cardAppearance, `${id}.${cardId}`, sourceKind);@@ -270,8 +264,8 @@ export const decodeDepthStackSurface: StructuredSurfaceHandler = ({ element, resconst fragment = createDepthStackFragment(cards, "terminal");return {records,- components: [...temporalComponents, { id, fragment: fragment.id, inputs, outputs: { program: `${id}.program`, visual: `${id}.visual` }, range: element.range }],- fragments: [...temporalFragments, fragment],+ components: [{ id, fragment: fragment.id, inputs, outputs: { program: `${id}.program`, visual: `${id}.visual` }, range: element.range }],+ fragments: [fragment],exports: [`${id}.program`, `${id}.visual`],};};diff --git a/packages/depth-stack/test/depth-stack.test.ts b/packages/depth-stack/test/depth-stack.test.tsindex a79611d6..feda9c04 100644--- a/packages/depth-stack/test/depth-stack.test.ts+++ b/packages/depth-stack/test/depth-stack.test.ts@@ -95,7 +95,6 @@ test("DepthStack Surface declares every sealed Record it may emit", () => {depthStackTypes.cardLabel,depthStackTypes.cardLabelStyle,textTypes.text,- temporalTypes.instantSpec,depthStackTypes.program,compositionTypes.visualTrack,]) {diff --git a/packages/interview-emoji-reveal/README.md b/packages/interview-emoji-reveal/README.mdindex 3e83cd60..4d988f42 100644--- a/packages/interview-emoji-reveal/README.md+++ b/packages/interview-emoji-reveal/README.md@@ -21,7 +21,7 @@ answers remain and later slots remain unanswered.<emoji:Style id="emoji-strip" recipe={styles.emoji-strip}/><emoji:EmojiReveal id="rules" timeline={speech.timeline} within={vertical.bounds}- style={emoji-strip} placeholder={question-icon} during="timeline">+ style={emoji-strip} placeholder={question-icon} during={speech.window}><emoji:Item id="manifest" icon={manifest-icon} preset="true"/><emoji:Item id="real-estate" icon={real-estate-icon} at={story-time.real-estate}/><emoji:Item id="bitcoin" icon={bitcoin-icon} at={story-time.bitcoin}/>diff --git a/packages/interview-emoji-reveal/src/manifest.ts b/packages/interview-emoji-reveal/src/manifest.tsindex 1a3b365a..9bc8dc63 100644--- a/packages/interview-emoji-reveal/src/manifest.ts+++ b/packages/interview-emoji-reveal/src/manifest.ts@@ -109,7 +109,7 @@ export const emojiRevealMarkupSurfaces = [notes: ["The Style owns appearance and placement, but never event timing."],} },{ name: "emojiReveal", tag: "EmojiReveal", mode: "structured",- outputs: [emojiRevealTypes.header, emojiRevealTypes.itemSpec, temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, emojiRevealTypes.program, compositionTypes.visualTrack],+ outputs: [emojiRevealTypes.header, emojiRevealTypes.itemSpec, emojiRevealTypes.program, compositionTypes.visualTrack],vocabulary: {summary: "Draws one adaptive row of preset or progressively revealed icon slots.",appearance: "A compact rounded rectangle centered near the top of the frame, with a dark outline and a hard lower-right shadow. Its width is computed from the number of fixed-size slots. Preset slots are settled from the first frame. Every other slot starts with the same supplied placeholder icon, then its activation Instant replaces that slot with a brief overshoot and settle while earlier answers remain visible and later slots remain unanswered.",@@ -132,7 +132,7 @@ export const emojiRevealMarkupSurfaces = [{ name: "program", type: emojiRevealTypes.program, summary: "The adaptive strip with its outer Window and fully traced activation Instants." },{ name: "visual", type: compositionTypes.visualTrack, summary: "That Program rendered as an ordinary VisualTrack." },],- example: `<emoji:EmojiReveal id="rules" timeline={speech.timeline} within={vertical.bounds} style={emoji-strip} placeholder={question-icon} during="timeline">+ example: `<emoji:EmojiReveal id="rules" timeline={speech.timeline} within={vertical.bounds} style={emoji-strip} placeholder={question-icon} during={speech.window}><emoji:Item id="manifest" icon={manifest-icon} preset="true"/><emoji:Item id="real-estate" icon={real-estate-icon} at={story-time.real-estate}/><emoji:Item id="bitcoin" icon={bitcoin-icon} at={story-time.bitcoin}/>diff --git a/packages/interview-emoji-reveal/src/surface.ts b/packages/interview-emoji-reveal/src/surface.tsindex 6e43718f..d703076e 100644--- a/packages/interview-emoji-reveal/src/surface.ts+++ b/packages/interview-emoji-reveal/src/surface.ts@@ -5,7 +5,7 @@ import { sameType, type CanonicalValue, type TypeRef } from "@hypit/hypit/protocimport { spatialTypes } from "@hypit/hypit/spatial";import { recipeType } from "@hypit/hypit/recipe";import type { Recipe } from "@hypit/hypit/recipe";-import { createTemporalInstantConstruction, createTemporalWindowConstruction, temporalWindowAttributeNames } from "@hypit/hypit/temporal/markup";+import { resolveTemporalInstantReference, resolveTemporalWindowReference, temporalWindowAttributeNames } from "@hypit/hypit/temporal/markup";import { createEmojiRevealFragment } from "./fragment.js";import { emojiRevealTypes } from "./manifest.js";@@ -50,14 +50,12 @@ export const decodeEmojiRevealTrackSurface: StructuredSurfaceHandler = ({ elemenconst within = reference(element.attributes.within, `${element.name}.within`, spatialTypes.frame, resolveReference);const style = reference(element.attributes.style, `${element.name}.style`, emojiRevealTypes.style, resolveReference);const placeholder = reference(element.attributes.placeholder, `${element.name}.placeholder`, blobTypes.blob, resolveReference);- const outer = createTemporalWindowConstruction({ id, subjectId: id, element, ...context, resolveReference });+ const outer = resolveTemporalWindowReference({ element, resolveReference });const headerId = `${id}.header`;- const records: SurfaceRecordDraft[] = [...outer.records, {+ const records: SurfaceRecordDraft[] = [{id: headerId, type: emojiRevealTypes.header,value: { kind: "inline", value: sealEmojiRevealHeader({ id }) as unknown as CanonicalValue }, range: element.range,}];- const temporalComponents: SurfaceComponentDraft[] = [...outer.components];- const temporalFragments = [...outer.fragments];const items: { specName: string; iconName: string; activationName?: string }[] = [];const inputs: Record<string, typeof context.timeline.ref> = {header: { kind: "record", id: headerId }, timeline: context.timeline.ref, within: within.ref, style: style.ref,@@ -85,11 +83,7 @@ export const decodeEmojiRevealTrackSurface: StructuredSurfaceHandler = ({ elemeninputs[specName] = { kind: "record", id: specId }; inputs[iconName] = icon.ref;if (preset) items.push({ specName, iconName });else {- const activation = createTemporalInstantConstruction({- id: `${id}.item.${suffix}.activation`, subjectId: itemId,- element: child, ...context, resolveReference, attribute: "at",- });- records.push(...activation.records); temporalComponents.push(...activation.components); temporalFragments.push(...activation.fragments);+ const activation = resolveTemporalInstantReference({ element: child, resolveReference });const activationName = `item-${suffix}-activation`;inputs[activationName] = activation.ref;items.push({ specName, iconName, activationName });@@ -99,7 +93,7 @@ export const decodeEmojiRevealTrackSurface: StructuredSurfaceHandler = ({ elemenconst fragment = createEmojiRevealFragment(items);return {records,- components: [...temporalComponents, { id, fragment: fragment.id, inputs, outputs: { program: `${id}.program`, visual: `${id}.visual` }, range: element.range }],- fragments: [...temporalFragments, fragment], exports: [`${id}.program`, `${id}.visual`],+ components: [{ id, fragment: fragment.id, inputs, outputs: { program: `${id}.program`, visual: `${id}.visual` }, range: element.range }],+ fragments: [fragment], exports: [`${id}.program`, `${id}.visual`],};};diff --git a/packages/provider-html-local/test/visual-readiness.test.ts b/packages/provider-html-local/test/visual-readiness.test.tsindex cc9febfa..8d78a5aa 100644--- a/packages/provider-html-local/test/visual-readiness.test.ts+++ b/packages/provider-html-local/test/visual-readiness.test.ts@@ -290,9 +290,9 @@ test("Fine Caption Cues stay isolated over Picture during reverse seeks and indespan: { startFrame, endFrameExclusive },});const program = { id: "captions", documentId: document.id, styles, uses: [- { styleId: "red", window: useWindow("red-use", 0, 30) },- { styleId: "green", window: useWindow("green-use", 30, 60) },- { styleId: "blue", window: useWindow("blue-use", 60, 90) },+ { id: "red-use", styleId: "red", window: useWindow("red-use", 0, 30) },+ { id: "green-use", styleId: "green", window: useWindow("green-use", 30, 60) },+ { id: "blue-use", styleId: "blue", window: useWindow("blue-use", 60, 90) },] };const timing = { timelineId: timeline.id, documentId: document.id, units: document.units.map((unit, index) => ({unitId: unit.id, startFrame: index * 30, endFrameExclusive: index * 30 + 30,diff --git a/packages/ranking/src/manifest.ts b/packages/ranking/src/manifest.tsindex 1a083204..54dfee7f 100644--- a/packages/ranking/src/manifest.ts+++ b/packages/ranking/src/manifest.ts@@ -486,7 +486,7 @@ const allRankingMarkupSurfaces = ["Every other property is refused by name.",],} },- { name: "tier", tag: "TierBoard", mode: "structured", outputs: [rankingTypes.header, rankingTypes.itemSpec, temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, rankingTypes.schedule, rankingTypes.tierProgram, compositionTypes.visualTrack, rankingTypes.soundEvents, compositionTypes.audioTrack],+ { name: "tier", tag: "TierBoard", mode: "structured", outputs: [rankingTypes.header, rankingTypes.itemSpec, 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:@@ -543,7 +543,7 @@ const allRankingMarkupSurfaces = [],example: `<ranking:TierBoardStyle id="tier-style" recipe={recipes.ranking.tier} font={ui-font}/><ranking:TierBoard id="tiers" timeline={speech.timeline} within={vertical.bounds} frame={board-frame}- during="timeline"+ during={speech.window}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-time.remini}/>@@ -556,7 +556,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.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, rankingTypes.schedule, rankingTypes.columnProgram, compositionTypes.visualTrack, rankingTypes.soundEvents, compositionTypes.audioTrack],+ { name: "column", tag: "Column", mode: "structured", outputs: [rankingTypes.header, rankingTypes.itemSpec, rankingTypes.textItemShell, 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:@@ -627,7 +627,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.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, rankingTypes.schedule, rankingTypes.topThreeProgram, compositionTypes.visualTrack, rankingTypes.soundEvents, compositionTypes.audioTrack],+ { name: "top-three", tag: "TopThree", mode: "structured", outputs: [rankingTypes.header, rankingTypes.itemSpec, rankingTypes.textItemShell, 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:diff --git a/packages/ranking/src/surface.ts b/packages/ranking/src/surface.tsindex 33fc4744..f7eb6252 100644--- a/packages/ranking/src/surface.ts+++ b/packages/ranking/src/surface.ts@@ -1,5 +1,5 @@import { resolveTemporalContext } from "@hypit/hypit/temporal/markup";-import { assertEmptyElement as empty, assertAttributes as allowed, localName, textAttribute as text, optionalTextAttribute as optionalText, type StructuredElement, type StructuredSurfaceHandler, type SurfaceComponentDraft, type SurfaceRecordDraft, type SurfaceResolvedReference, type MarkupAttributeValue } from "@hypit/hypit/markup";+import { assertEmptyElement as empty, assertAttributes as allowed, localName, textAttribute as text, optionalTextAttribute as optionalText, type StructuredElement, type StructuredSurfaceHandler, type SurfaceRecordDraft, type SurfaceResolvedReference, type MarkupAttributeValue } from "@hypit/hypit/markup";import { sameType, type CanonicalValue, type TypeRef } from "@hypit/hypit/protocol";import { mediaTypes } from "@hypit/hypit/media";import type { FontArtifactRef, FontStackRef } from "@hypit/hypit/media";@@ -7,7 +7,7 @@ import { spatialTypes } from "@hypit/hypit/spatial";import { recipeType } from "@hypit/hypit/recipe";import type { Recipe } from "@hypit/hypit/recipe";import { textTypes } from "@hypit/hypit/text";-import { createTemporalInstantConstruction, createTemporalWindowConstruction, temporalInstantAttributeNames } from "@hypit/hypit/temporal/markup";+import { resolveTemporalInstantReference, resolveTemporalWindowReference, temporalInstantAttributeNames } from "@hypit/hypit/temporal/markup";import { createRankingFragment } from "./fragment.js";import type { RankingFragmentItem, RankingFragmentSound } from "./fragment.js";@@ -199,18 +199,13 @@ function rankingSurface(variant: RankingVariant): StructuredSurfaceHandler {? reference(element.attributes.within, `${element.name}.within`, spatialTypes.frame, resolveReference): undefined;const frame = reference(element.attributes.frame, `${element.name}.frame`, spatialTypes.frame, resolveReference);- const outerTemporal = createTemporalWindowConstruction({ id: `${id}.outer`, subjectId: id, element, ...context, resolveReference });+ const outerTemporal = resolveTemporalWindowReference({ element, resolveReference });const terminalTemporal = variant === "top-three"- ? createTemporalInstantConstruction({- id: `${id}.terminal`, subjectId: id, element, ...context, resolveReference,- attribute: "terminal",- })+ ? resolveTemporalInstantReference({ element, resolveReference, attribute: "terminal" }): 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[] = [...outerTemporal.components, ...(terminalTemporal?.components ?? [])];- const temporalFragments = [...outerTemporal.fragments, ...(terminalTemporal?.fragments ?? [])];+ const records: SurfaceRecordDraft[] = [];const headerId = `${id}.header`;records.push({id: headerId, type: rankingTypes.header,@@ -247,13 +242,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"- ? createTemporalInstantConstruction({ id: `${id}.item.${suffix}`, subjectId: spec.id, element: child, ...context, resolveReference })- : createTemporalWindowConstruction({ id: `${id}.item.${suffix}`, subjectId: spec.id, element: child, ...context, resolveReference });- if (itemTemporal !== undefined) {- records.push(...itemTemporal.records);- temporalComponents.push(...itemTemporal.components);- temporalFragments.push(...itemTemporal.fragments);- }+ ? resolveTemporalInstantReference({ element: child, resolveReference })+ : resolveTemporalWindowReference({ element: child, resolveReference });const timingName = itemTemporal === undefined ? undefined : `item-${suffix}-timing`;if (itemTemporal !== undefined) inputs[timingName!] = itemTemporal.ref;let iconName: string | undefined;@@ -290,7 +280,7 @@ function rankingSurface(variant: RankingVariant): StructuredSurfaceHandler {const fragment = createRankingFragment(variant, items, sound);return {records,- components: [...temporalComponents, {+ components: [{id, fragment: fragment.id, inputs,outputs: {schedule: `${id}.schedule`, program: `${id}.program`, visual: `${id}.visual`,@@ -298,7 +288,7 @@ function rankingSurface(variant: RankingVariant): StructuredSurfaceHandler {},range: element.range,}],- fragments: [...temporalFragments, fragment],+ fragments: [fragment],exports: [`${id}.schedule`, `${id}.program`, `${id}.visual`, ...(sound.appearName === undefined && sound.moveName === undefined ? [] : [`${id}.events`, `${id}.audio`])],};};diff --git a/packages/ranking/test/ranking.test.ts b/packages/ranking/test/ranking.test.tsindex 2332ff12..6be250f8 100644--- a/packages/ranking/test/ranking.test.ts+++ b/packages/ranking/test/ranking.test.ts@@ -80,7 +80,7 @@ import type {import { spatialTypes } from "@hypit/spatial";import { recipeType } from "@hypit/recipe";import { sealText, textManifest, textTypes } from "@hypit/text";-import { temporalProducers, temporalTypes } from "@hypit/temporal";+import { temporalTypes } from "@hypit/temporal";import type { TemporalWindow } from "@hypit/temporal";import type {StructuredElement,@@ -562,7 +562,7 @@ test("all three author Surfaces preserve absolute temporal, spatial, font, image}const cases = [[decodeTierBoardSurface, node("ranking:TierBoard", {- id: "tier", timeline: ref("semantic"), within: ref("frame"), frame: ref("frame"), during: "timeline",+ id: "tier", timeline: ref("semantic"), within: ref("frame"), frame: ref("frame"), during: ref("outer"),style: ref("tier-style"),}, [node("ranking:TierItem", { id: "tier-one", tier: "s", entry: "drop", icon: ref("icon-1"), during: ref("ranking-segment") })])],[decodeColumnSurface, node("ranking:Column", {@@ -600,8 +600,8 @@ test("all three author Surfaces preserve absolute temporal, spatial, font, image});const tierFragment = programTier.fragments.find((candidate) => candidate.exports.some((output) => output.name === "visual"))!;assert.equal(tierFragment.inputs.find((input) => input.name === "outer")?.type.name, "TemporalWindow");- assert.ok(programTier.fragments.some((fragment) => fragment.operations.some((operation) =>- operation.producer.name === temporalProducers.projectProgramInstant.name)));+ assert.equal(programTier.fragments.some((fragment) => fragment.operations.some((operation) =>+ operation.producer.module.name === "@hypit/temporal")), false);assert.equal(programTier.fragments.some((fragment) => fragment.operations.some((operation) =>operation.producer.module.name === "@hypit/narrative-temporal")), false);const column = await decodeColumnSurface({@@ -651,17 +651,17 @@ test("Ranking author Surfaces fail closed on impossible image and sound combinat["style", plain("style", rankingTypes.tierStyle)], ["style.sound", plain("style.sound", rankingTypes.soundStyle)],["move", plain("move", mediaTypes.synchronized)],]);- const common = { id: "bad", timeline: ref("semantic"), within: ref("frame"), frame: ref("frame"), during: "timeline", style: ref("style") };+ const common = { id: "bad", timeline: ref("semantic"), within: ref("frame"), frame: ref("frame"), during: ref("outer"), style: ref("style") };const context = (element: StructuredElement) => ({sourceName: "ranking.svml", element, resolveReference: (path: string) => references.get(path),resolveAsset: async () => { throw new Error("no asset resolution expected"); },});assert.throws(() => decodeTierBoardSurface(context({kind: "element", name: "ranking:TierBoard", attributes: common,- children: [{ kind: "element", name: "ranking:TierItem", attributes: { tier: "s", entry: "direct", during: "timeline" }, children: [], range }], range,+ children: [{ kind: "element", name: "ranking:TierItem", attributes: { tier: "s", entry: "direct", during: ref("outer") }, children: [], range }], range,})), /icon/u);assert.throws(() => decodeTierBoardSurface(context({kind: "element", name: "ranking:TierBoard", attributes: { ...common, "move-sound": ref("move") },- children: [{ kind: "element", name: "ranking:TierItem", attributes: { tier: "s", entry: "direct", icon: ref("icon"), during: "timeline" }, children: [], range }], range,+ children: [{ kind: "element", name: "ranking:TierItem", attributes: { tier: "s", entry: "direct", icon: ref("icon"), during: ref("outer") }, children: [], range }], range,})), /move-sound/u);});diff --git a/packages/temporal/EDITING.md b/packages/temporal/EDITING.mdindex 22fadf7f..1395d3cb 100644--- a/packages/temporal/EDITING.md+++ b/packages/temporal/EDITING.md@@ -9,19 +9,19 @@ derived from a duration. Studio reads that fact from the executed graph; it doesattribute names. A reference has no local parameter authority: its producer remains the only placethat may declare an inverse.-## Direct absolute construction+## Named absolute declarations| Author form | Move | Leading edge | Trailing edge || --- | --- | --- | --- || `from="2s" for="8f"` | Rewrite `from`; retain `for`. | Rewrite `from`. | Rewrite `for`. || `until="3s" for="8f"` | Rewrite `until`; retain `for`. | Rewrite `for`. | Rewrite `until`. || `from="1s" until="3s"` | Shift both values. | Rewrite `from`. | Rewrite `until`. |-| `during="timeline"` | No local write. | No local write. | No local write. |-| `during={named-window}` | Follow the referenced value. | Edit its producer. | Edit its producer. |+| named Window declared with `from`/`until`/`for` | Rewrite the declaration. | Rewrite its leading relation. | Rewrite its trailing relation. |+| component `during={named-window}` | Follow the referenced value. | Edit its producer. | Edit its producer. |-`from` and `until` may also reference completed Instants. Those references remain fixed at the-consumer; editing follows the Instant's producer. A resolved value does not grant the consumer an-inverse operation over its source domain.+`from` and `until` may reference completed Instants on the named declaration. The component has no+local time constructor or parameter authority; editing follows the Window or Instant producer. A+resolved value does not grant the consumer an inverse operation over its source domain.Frames and milliseconds are integral. Seconds may be rational decimals. Timeline conversion usesexact arithmetic and whole frame boundaries. Unedited values retain their authored unit.diff --git a/packages/temporal/src/markup/index.ts b/packages/temporal/src/markup/index.tsindex 2038992b..fae0b90c 100644--- a/packages/temporal/src/markup/index.ts+++ b/packages/temporal/src/markup/index.ts@@ -19,26 +19,22 @@ type ExtentDraft =| { readonly kind: "duration"; readonly duration: TemporalDuration; readonly author?: TemporalAuthorParameter }| { readonly kind: "reference"; readonly reference: SurfaceResolvedReference };-/** Absolute-only author vocabulary for a Window consumer. */+/** Reference-only vocabulary for a Window consumer. */export const temporalWindowAttributeVocabulary: readonly SurfaceAttributeVocabulary[] = [- { name: "during", kind: "expression", required: false, values: ["timeline"], accepts: [temporalTypes.window],- summary: "Uses the whole Timeline or an already resolved Window." },- { name: "from", kind: "expression", required: false, accepts: [temporalTypes.instant],- summary: "Sets the inclusive absolute start boundary." },- { name: "until", kind: "expression", required: false, accepts: [temporalTypes.instant],- summary: "Sets the exclusive absolute end boundary." },- { name: "for", kind: "expression", required: false, accepts: [temporalTypes.extent],- summary: "Sets an exact duration or resolved Extent." },+ { name: "during", kind: "expression", required: false, accepts: [temporalTypes.window],+ summary: "Uses an already resolved Window." },];export const temporalWindowAttributeNames = temporalWindowAttributeVocabulary.map(({ name }) => name);-/** Absolute-only author vocabulary for an Instant consumer. */+/** Reference-only vocabulary for an Instant consumer. */export const temporalInstantAttributeVocabulary: readonly SurfaceAttributeVocabulary[] = [{ name: "at", kind: "expression", required: false, accepts: [temporalTypes.instant],- summary: "Uses an already resolved Instant or an absolute authored position." },+ summary: "Uses an already resolved Instant." },];export const temporalInstantAttributeNames = temporalInstantAttributeVocabulary.map(({ name }) => name);+const temporalWindowAuthorAttributeNames = ["from", "until", "for"] as const;+export type TemporalMarkupConstruction = {readonly records: readonly SurfaceRecordDraft[];readonly components: readonly SurfaceComponentDraft[];@@ -112,7 +108,7 @@ function extentDraft(raw: MarkupAttributeValue, label: string, binding: string,function rejectUnused(element: StructuredElement, allowed: readonly string[]): void {const accepted = new Set(allowed);- const unused = temporalWindowAttributeNames.filter((name) => element.attributes[name] !== undefined && !accepted.has(name));+ const unused = temporalWindowAuthorAttributeNames.filter((name) => element.attributes[name] !== undefined && !accepted.has(name));if (unused.length > 0) throw new Error(`${element.name} timing form does not accept ${unused.join(", ")}.`);}@@ -208,27 +204,16 @@ function constructWindow(value: {endRef: { kind: "component-output", component: componentId, output: "end" } };}-/** Construct or pass through one absolute Window. */+/** Construct one named absolute Window for an author declaration. */export function createTemporalWindowConstruction(value: {readonly id: string; readonly subjectId?: string; readonly element: StructuredElement;readonly timeline: SurfaceResolvedReference; readonly resolveReference: ResolveReference;}): TemporalMarkupConstruction {const { element, resolveReference } = value;- const during = element.attributes.during, from = element.attributes.from;+ const from = element.attributes.from;const until = element.attributes.until, length = element.attributes.for;- if (during !== undefined) {- rejectUnused(element, ["during"]);- if (typeof during !== "string") {- const found = resolvedReference(during, `${element.name}.during`, temporalTypes.window, resolveReference);- return { records: [], components: [], fragments: [], ref: found.ref };- }- if (during.trim() !== "timeline") throw new Error(`${element.name}.during text must be timeline.`);- return constructWindow({ ...value, subjectId: value.subjectId ?? value.id,- start: { kind: "expression", expression: { ref: "timeline.start" } },- end: { kind: "expression", expression: { ref: "timeline.end" } } });- }if (Number(from !== undefined) + Number(until !== undefined) + Number(length !== undefined) !== 2) {- throw new Error(`${element.name} requires during or exactly two of from, until and for.`);+ throw new Error(`${element.name} requires exactly two of from, until and for.`);}rejectUnused(element, ["from", "until", "for"]);const subjectId = value.subjectId ?? value.id;@@ -245,7 +230,7 @@ export function createTemporalWindowConstruction(value: {extent: extentDraft(length, `${element.name}.for`, "for", resolveReference), direction: -1 });}-/** Construct or pass through one absolute Instant. */+/** Construct one named absolute Instant for an author declaration. */export function createTemporalInstantConstruction(value: {readonly id: string; readonly subjectId?: string; readonly element: StructuredElement;readonly timeline: SurfaceResolvedReference; readonly resolveReference: ResolveReference; readonly attribute?: string;@@ -272,3 +257,27 @@ export function createTemporalInstantConstruction(value: {outputs: { instant: `${value.id}.__temporal.instant.value` }, range: value.element.range }], fragments: [fragment],ref: { kind: "component-output", component: componentId, output: "instant" } };}++/** Resolve one already declared Window at a consumer boundary. */+export function resolveTemporalWindowReference(value: {+ readonly element: StructuredElement;+ readonly resolveReference: ResolveReference;+ readonly attribute?: string;+}): SurfaceResolvedReference {+ const attribute = value.attribute ?? "during";+ const raw = value.element.attributes[attribute];+ if (raw === undefined) throw new Error(`${value.element.name}.${attribute} is required.`);+ return resolvedReference(raw, `${value.element.name}.${attribute}`, temporalTypes.window, value.resolveReference);+}++/** Resolve one already declared Instant at a consumer boundary. */+export function resolveTemporalInstantReference(value: {+ readonly element: StructuredElement;+ readonly resolveReference: ResolveReference;+ readonly attribute?: string;+}): SurfaceResolvedReference {+ const attribute = value.attribute ?? "at";+ const raw = value.element.attributes[attribute];+ if (raw === undefined) throw new Error(`${value.element.name}.${attribute} is required.`);+ return resolvedReference(raw, `${value.element.name}.${attribute}`, temporalTypes.instant, value.resolveReference);+}diff --git a/packages/temporal/test/markup.test.ts b/packages/temporal/test/markup.test.tsindex 2790e6bc..f615d78a 100644--- a/packages/temporal/test/markup.test.ts+++ b/packages/temporal/test/markup.test.ts@@ -5,7 +5,13 @@ import type { MarkupAttributeValue, StructuredElement, SurfaceResolvedReferenceimport { temporalTypes } from "@hypit/temporal";import { timelineTypes } from "@hypit/timeline";-import { createTemporalInstantConstruction, createTemporalWindowConstruction, resolveTemporalContext } from "../src/markup/index.js";+import {+ createTemporalInstantConstruction,+ createTemporalWindowConstruction,+ resolveTemporalContext,+ resolveTemporalInstantReference,+ resolveTemporalWindowReference,+} from "../src/markup/index.js";const range = { source: "main.svml", start: 0, end: 1 };const reference = (path: string): MarkupAttributeValue => ({ kind: "reference", path });@@ -28,14 +34,7 @@ const inlineValues = (construction: ReturnType<typeof createTemporalWindowConstr.filter((record) => record.type.name === typeName).map((record) => record.value.kind === "inline" ? record.value.value : undefined);-test("whole Timeline and absolute literals lower without any domain projector", () => {- const whole = createTemporalWindowConstruction({ id: "whole", element: element({ during: "timeline" }), timeline, resolveReference });- assert.deepEqual(inlineValues(whole, "TemporalInstantSpec"), [- { id: "whole.start", subjectId: "whole", projection: { ref: "timeline.start" } },- { id: "whole.end", subjectId: "whole", projection: { ref: "timeline.end" } },- ]);- assert.equal(whole.fragments[0]!.inputs.some((port) => port.type.module.name.includes("narrative")), false);-+test("absolute author declarations lower without any domain projector", () => {const literal = createTemporalWindowConstruction({ id: "literal", element: element({ from: "2.5s", for: "8f" }), timeline, resolveReference });assert.deepEqual(inlineValues(literal, "TemporalDuration"), [{ unit: "frames", value: 8 }]);assert.deepEqual(inlineValues(literal, "TemporalInstantSpec"), [{@@ -65,10 +64,12 @@ test("resolved Instants compose a Window and an Extent shifts either boundary",});test("resolved Window and Instant references pass directly through", () => {- const window = createTemporalWindowConstruction({ id: "use", element: element({ during: reference("window") }), timeline, resolveReference });- assert.deepEqual(window, { records: [], components: [], fragments: [], ref: references.get("window")!.ref });- const instant = createTemporalInstantConstruction({ id: "cue", element: element({ at: reference("start-instant") }), timeline, resolveReference });- assert.deepEqual(instant, { records: [], components: [], fragments: [], ref: references.get("start-instant")!.ref });+ const window = resolveTemporalWindowReference({ element: element({ during: reference("window") }), resolveReference });+ assert.deepEqual(window, references.get("window"));+ const instant = resolveTemporalInstantReference({ element: element({ at: reference("start-instant") }), resolveReference });+ assert.deepEqual(instant, references.get("start-instant"));+ assert.throws(() => resolveTemporalWindowReference({ element: element({ during: "timeline" }), resolveReference }), /must be a reference/u);+ assert.throws(() => resolveTemporalInstantReference({ element: element({ at: "2.5s" }), resolveReference }), /must be a reference/u);});test("Instant literals use common Timeline arithmetic", () => {diff --git a/packages/text-fine/README.md b/packages/text-fine/README.mdindex 8d67ce9a..78d49b34 100644--- a/packages/text-fine/README.md+++ b/packages/text-fine/README.md@@ -62,10 +62,10 @@ Content has two explicit author forms:<copy:Value id="headline-copy">A useful idea, clearly shown.</copy:Value><typo:Flow id="headline" timeline={film.timeline} content={headline-copy}- within={layout.headline} style={title-style} z="40" during="timeline"/>+ within={layout.headline} style={title-style} z="40" during={film.window}/><typo:Flow id="editorial" timeline={film.timeline} within={layout.editorial}- style={body-style} z="40" during="timeline">+ style={body-style} z="40" during={film.window}><typo:P>Rich <typo:Span style={accent}>authored</typo:Span> typography.</typo:P></typo:Flow>```diff --git a/packages/text-fine/src/manifest.ts b/packages/text-fine/src/manifest.tsindex 4b18f438..3fe656e5 100644--- a/packages/text-fine/src/manifest.ts+++ b/packages/text-fine/src/manifest.ts@@ -402,7 +402,7 @@ export const textFineMarkupSurfaces = [notes: ["A PathMotion needs at least two ordered Keyframes and is accepted only by a Path occurrence."],},},- { name: "flow", tag: "Flow", mode: "structured", outputs: [textFineTypes.itemSpec, textFineTypes.plainItemSpec, textFineTypes.motion, textFineTypes.flowPlacementPolicy, textFineTypes.placement, temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, textFineTypes.occurrence, compositionTypes.visualTrack],+ { name: "flow", tag: "Flow", mode: "structured", outputs: [textFineTypes.itemSpec, textFineTypes.plainItemSpec, textFineTypes.motion, textFineTypes.flowPlacementPolicy, textFineTypes.placement, textFineTypes.occurrence, compositionTypes.visualTrack],vocabulary: {summary: "One independently timed fine-text occurrence flowing inside a SpatialFrame; no aggregate Text Track is created.",attributes: [@@ -425,14 +425,14 @@ export const textFineMarkupSurfaces = [children: documentChildren,text: "Direct text is the occurrence's whole document, read as one paragraph.",ports: fineTextPorts,- example: `<text:Flow id="title" timeline={film.timeline} within={title-frame} style={title-style} z="40" align="center" block-align="center" during="timeline">EDIT MEANING</text:Flow>`,+ example: `<text:Flow id="title" timeline={film.timeline} within={title-frame} style={title-style} z="40" align="center" block-align="center" during={film.window}>EDIT MEANING</text:Flow>`,notes: ["This is one occurrence, not a container. Compose its `.visual` beside media, captions and other visual outputs.",- "Timing is absolute: use an existing Window with `during`, or author exactly two of `from`, `until` and `for`. A semantic package may project its own anchor into a Window first.",+ "Timing is absolute: `during` consumes an existing Window. Timeline or domain author packages declare the Window first.",],},},- { name: "point", tag: "Point", mode: "structured", outputs: [textFineTypes.itemSpec, textFineTypes.plainItemSpec, textFineTypes.motion, textFineTypes.pointPlacementPolicy, textFineTypes.placement, temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, textFineTypes.occurrence, compositionTypes.visualTrack],+ { name: "point", tag: "Point", mode: "structured", outputs: [textFineTypes.itemSpec, textFineTypes.plainItemSpec, textFineTypes.motion, textFineTypes.pointPlacementPolicy, textFineTypes.placement, textFineTypes.occurrence, compositionTypes.visualTrack],vocabulary: {summary: "One independently timed fine-text occurrence anchored at a SpatialPoint; no aggregate Text Track is created.",attributes: [@@ -444,11 +444,11 @@ export const textFineMarkupSurfaces = [children: documentChildren,text: "Direct text is the occurrence's whole document, read as one paragraph.",ports: fineTextPorts,- example: `<text:Point id="label" timeline={film.timeline} point={label-point} style={label-style} z="40" anchor-inline="start" from="2s" for="90f">ORBIT</text:Point>`,+ example: `<text:Point id="label" timeline={film.timeline} point={label-point} style={label-style} z="40" anchor-inline="start" during={label-window}>ORBIT</text:Point>`,notes: ["This is one occurrence, not a container; semantic sources can supply a resolved Window without becoming part of this text surface."],},},- { name: "path", tag: "Path", mode: "structured", outputs: [textFineTypes.itemSpec, textFineTypes.plainItemSpec, textFineTypes.motion, textFineTypes.pathMotion, textFineTypes.pathPlacementPolicy, textFineTypes.placement, temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec, temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, textFineTypes.occurrence, compositionTypes.visualTrack],+ { name: "path", tag: "Path", mode: "structured", outputs: [textFineTypes.itemSpec, textFineTypes.plainItemSpec, textFineTypes.motion, textFineTypes.pathMotion, textFineTypes.pathPlacementPolicy, textFineTypes.placement, textFineTypes.occurrence, compositionTypes.visualTrack],vocabulary: {summary: "One independently timed fine-text occurrence set along a SpatialPath; no aggregate Text Track is created.",attributes: [@@ -466,7 +466,7 @@ export const textFineMarkupSurfaces = [children: documentChildren,text: "Direct text is the occurrence's whole document, read as one paragraph.",ports: fineTextPorts,- example: `<text:Path id="orbit-copy" timeline={film.timeline} path={orbit} style={orbit-style} z="40" path-motion={orbit-travel} from="timeline.start + 1s" until="timeline.end">FOLLOW THE CURVE</text:Path>`,+ example: `<text:Path id="orbit-copy" timeline={film.timeline} path={orbit} style={orbit-style} z="40" path-motion={orbit-travel} during={orbit-window}>FOLLOW THE CURVE</text:Path>`,notes: ["This is one occurrence, not a container; Path-specific layout and margin motion belong here, not to the reusable Style or general Motion."],},},diff --git a/packages/text-fine/src/surface.ts b/packages/text-fine/src/surface.tsindex 867e6abb..f19cfc3f 100644--- a/packages/text-fine/src/surface.ts+++ b/packages/text-fine/src/surface.ts@@ -25,7 +25,7 @@ import type { Recipe } from "@hypit/hypit/recipe";import { textTypes } from "@hypit/hypit/text";import type { StructuredElement, StructuredSurfaceHandler, SurfaceResolvedReference, MarkupAttributeValue } from "@hypit/hypit/markup";import { temporalTypes } from "@hypit/hypit/temporal";-import { createTemporalWindowConstruction } from "@hypit/hypit/temporal/markup";+import { resolveTemporalWindowReference } from "@hypit/hypit/temporal/markup";import { fineTextWindowAttributeVocabulary, textFineProducers, textFineTypes } from "./manifest.js";import {@@ -725,10 +725,7 @@ function decodeFineTextOccurrenceSurface(form: FineTextForm): StructuredSurfaceH], ["id", "timeline", geometryAttribute, "style", "z"]);const id = text(element, "id");const context = resolveTemporalContext({ element, resolveReference });- const temporal = createTemporalWindowConstruction({- id: `${id}.__window`, subjectId: id, element,- timeline: context.timeline, resolveReference,- });+ const window = resolveTemporalWindowReference({ element, resolveReference });const geometry = reference(element.attributes[geometryAttribute], `${element.name}.${geometryAttribute}`, geometryType, resolveReference);const style = reference(element.attributes.style, `${element.name}.style`, textFineTypes.style, resolveReference);const defaultMotionId = `${id}.__still-motion`;@@ -770,10 +767,8 @@ function decodeFineTextOccurrenceSurface(form: FineTextForm): StructuredSurfaceHid: specId, type: content === undefined ? textFineTypes.itemSpec : textFineTypes.plainItemSpec,value: { kind: "inline", value: spec }, range: element.range,},- ...temporal.records,],components: [- ...temporal.components,{id, fragment: fragment.id,inputs: {@@ -782,12 +777,12 @@ function decodeFineTextOccurrenceSurface(form: FineTextForm): StructuredSurfaceH...(pathMotion === undefined ? {} : { pathMotion }),spec: { kind: "record", id: specId },...(content === undefined ? {} : { content: content.ref }),- style: style.ref, motion, window: temporal.ref,+ style: style.ref, motion, window: window.ref,},outputs: { occurrence: `${id}.occurrence`, visual: `${id}.visual` }, range: element.range,},],- fragments: [...temporal.fragments, fragment],+ fragments: [fragment],exports: [`${id}.occurrence`, `${id}.visual`],};};diff --git a/packages/text-fine/test/text-fine.test.ts b/packages/text-fine/test/text-fine.test.tsindex 9b2bacbf..d9c236bd 100644--- a/packages/text-fine/test/text-fine.test.ts+++ b/packages/text-fine/test/text-fine.test.ts@@ -3,7 +3,7 @@ import assert from "node:assert/strict";import test from "node:test";import { fixtureResource } from "../../../test/fixture-resource.js";import { narrativeProjectionFixture, timelineFixture } from "../../../test/timeline-fixture.js";-import { projectSelectionWindow } from "../../../test/temporal-fixture.js";+import { projectProgramWindow, projectSelectionWindow } from "../../../test/temporal-fixture.js";import { spatialComponent, videoContractManifests } from "../../../test/support/video-domain.js";import { registerTypeValidatorFacets } from "@hypit/admission";@@ -48,6 +48,7 @@ import { sealText, textComponent, textDependency, textManifest, textTypes } fromimport { MarkupSurfaceRegistry, createMarkupAuthorFrontend } from "@hypit/markup";import { createRecordAdmitter, TypeValidatorRegistry } from "@hypit/admission";import { resolveSelfDescribedTextSource } from "@hypit/source/text";+import { temporalDependency, temporalTypes } from "@hypit/temporal";const space = sealTimeline({ id: "test-space", frameCount: 150, frameRate: { numerator: 30, denominator: 1 },});@@ -268,6 +269,7 @@ test("the self-described Markup Surfaces compile Style, Motion and all three spaoutputs: [recipeType,timelineTypes.timeline,+ temporalTypes.window,spatialTypes.point,spatialTypes.frame,spatialTypes.path,@@ -282,6 +284,7 @@ test("the self-described Markup Surfaces compile Style, Motion and all three spaversion: fixtureModule.version,dependencies: [timelineDependency,+ temporalDependency,spatialDependency,mediaDependency,{@@ -329,6 +332,10 @@ test("the self-described Markup Surfaces compile Style, Motion and all three sparange: element.range,},{ id: "semantic", type: timelineTypes.timeline, value: { kind: "inline", value: semantic }, range: element.range },+ { id: "whole-window", type: temporalTypes.window, value: { kind: "inline", value: projectProgramWindow({ itemId: "whole-window", semantic,+ projection: { start: { ref: "timeline.start" }, end: { ref: "timeline.end" } } }) }, range: element.range },+ { id: "point-window", type: temporalTypes.window, value: { kind: "inline", value: projectProgramWindow({ itemId: "point-window", semantic,+ projection: { start: { ref: "absolute", at: { unit: "frames", value: 30 } }, end: { ref: "absolute", at: { unit: "frames", value: 60 } } } }) }, range: element.range },{ id: "title-point", type: spatialTypes.point, value: { kind: "inline", value: { xPx: 540, yPx: 120 } }, range: element.range },{ id: "body-frame", type: spatialTypes.frame, value: { kind: "inline", value: { xPx: 80, yPx: 220, widthPx: 920, heightPx: 520 } }, range: element.range },{ id: "arc", type: spatialTypes.path, value: { kind: "inline", value: { commands: [@@ -386,19 +393,19 @@ test("the self-described Markup Surfaces compile Style, Motion and all three spa<text:Keyframe at="0" margin="0"/><text:Keyframe at="150" margin="120" easing="ease-in-out"/></text:PathMotion>- <text:Flow id="standalone-flow" timeline={semantic} within={body-frame} style={poster} z="70" overflow="shrink" minimum-scale="0.65" during="timeline">+ <text:Flow id="standalone-flow" timeline={semantic} within={body-frame} style={poster} z="70" overflow="shrink" minimum-scale="0.65" during={whole-window}>Independent flow</text:Flow>- <text:Point id="standalone-point" timeline={semantic} point={title-point} style={poster} z="70" content={copy} from="1s" for="30f"/>- <text:Path id="standalone-path" timeline={semantic} path={arc} style={poster} z="70" motion={arrive} path-motion={orbit-travel} from="0f" until="150f">+ <text:Point id="standalone-point" timeline={semantic} point={title-point} style={poster} z="70" content={copy} during={point-window}/>+ <text:Path id="standalone-path" timeline={semantic} path={arc} style={poster} z="70" motion={arrive} path-motion={orbit-travel} during={whole-window}>Independent path</text:Path>- <text:Point id="hook" timeline={semantic} content={copy} point={title-point} style={poster} z="70" during="timeline"/>- <text:Flow id="body" timeline={semantic} within={body-frame} style={poster} z="70" overflow="shrink" minimum-scale="0.65" motion={arrive} during="timeline">+ <text:Point id="hook" timeline={semantic} content={copy} point={title-point} style={poster} z="70" during={whole-window}/>+ <text:Flow id="body" timeline={semantic} within={body-frame} style={poster} z="70" overflow="shrink" minimum-scale="0.65" motion={arrive} during={whole-window}><text:P id="first">Rich <text:Span style={poster}>inline text</text:Span><text:Break/>wraps.</text:P></text:Flow>- <text:Path id="arc-title" timeline={semantic} path={arc} style={poster} z="70" during="timeline">Along the path</text:Path>- <text:Flow id="mask-shape" timeline={semantic} within={body-frame} style={mask-shape-style} z="75" wrap="none" during="timeline">MASK</text:Flow>+ <text:Path id="arc-title" timeline={semantic} path={arc} style={poster} z="70" during={whole-window}>Along the path</text:Path>+ <text:Flow id="mask-shape" timeline={semantic} within={body-frame} style={mask-shape-style} z="75" wrap="none" during={whole-window}>MASK</text:Flow><text:Mask id="masked-titles" timeline={semantic} text={mask-shape.occurrence} material={material}/></svml>`,}),@@ -448,7 +455,7 @@ test("fine Text occurrences expose only absolute timing vocabulary", () => {assert.equal(attributes.includes("segment"), false);assert.equal(attributes.includes("moment"), false);assert.deepEqual(attributes.filter((attribute) => ["during", "from", "until", "for"].includes(attribute)),- ["during", "from", "until", "for"]);+ ["during"]);}const mask = textFineMarkupSurfaces.find((item) => item.name === "mask");assert.ok(mask);@@ -584,13 +591,13 @@ test("a paragraph's source indentation is not part of its words", async () => {const fixtureSurface = {name: "inputs", tag: "Inputs", mode: "structured",outputs: [- recipeType, timelineTypes.timeline, spatialTypes.frame,+ recipeType, timelineTypes.timeline, temporalTypes.window, spatialTypes.frame,mediaTypes.fontArtifact, textTypes.text,],} as const;const fixtureManifest: ModuleManifest = {format: "hypit.module@1", name: fixtureModule.name, version: fixtureModule.version,- dependencies: [timelineDependency, spatialDependency, mediaDependency,+ dependencies: [timelineDependency, temporalDependency, spatialDependency, mediaDependency,{ module: { name: recipeManifest.name, version: recipeManifest.version } }, textDependency],types: [], capabilities: [], producers: [],};@@ -604,6 +611,8 @@ test("a paragraph's source indentation is not part of its words", async () => {path: "text.editorial", properties: { size: 44, "line-height": 1.15 } } },range: element.range },{ id: "semantic", type: timelineTypes.timeline, value: { kind: "inline", value: semantic }, range: element.range },+ { id: "whole-window", type: temporalTypes.window, value: { kind: "inline", value: projectProgramWindow({ itemId: "whole-window", semantic,+ projection: { start: { ref: "timeline.start" }, end: { ref: "timeline.end" } } }) }, range: element.range },{ id: "body-frame", type: spatialTypes.frame, value: { kind: "inline", value: { xPx: 80, yPx: 220, widthPx: 920, heightPx: 520 } }, range: element.range },{ id: "exact-font", type: mediaTypes.fontArtifact, value: { kind: "inline", value: exactTestFont }, range: element.range },],@@ -630,7 +639,7 @@ test("a paragraph's source indentation is not part of its words", async () => {<text:Style id="poster" recipe={editorial} font={exact-font}><text:Fill color="#f8fafc"/></text:Style>- <text:Flow id="body" timeline={semantic} within={body-frame} style={poster} z="70" overflow="shrink" minimum-scale="0.65" during="timeline">+ <text:Flow id="body" timeline={semantic} within={body-frame} style={poster} z="70" overflow="shrink" minimum-scale="0.65" during={whole-window}><text:P id="first">Top 5 Most PopularWays to <text:Span style={poster}>learn AI</text:Span>diff --git a/packages/timeline-author/README.md b/packages/timeline-author/README.mdindex 5ade26ac..304f4a99 100644--- a/packages/timeline-author/README.md+++ b/packages/timeline-author/README.md@@ -111,10 +111,10 @@ projection does not clip, loop, hold, stretch, resample or hide a source tail. Tordinary absolute Instants and Windows and erases the construction relation. Visual and Audio thenplace ordinary normalized media independently.-A one-off component Window can still be authored directly on that component or supplied by another-domain projection. Put a named child in Timeline when it participates in the construction DAG. When-the Timeline is already complete and several consumers deliberately share a newly composed absolute-range, publish it independently:+A component consumes a completed Window or Instant; it never authors an anonymous time value on its+own surface. Put a named child in Timeline when it participates in the construction DAG. When the+Timeline is already complete, publish an independent named value or consume a value supplied by a+domain projection:```svml<time:Window id="reveal-band" timeline={film.timeline}diff --git a/packages/visual-track/preview/preview.svml b/packages/visual-track/preview/preview.svmlindex 8bad5872..54dc17e2 100644--- a/packages/visual-track/preview/preview.svml+++ b/packages/visual-track/preview/preview.svml@@ -38,9 +38,9 @@</visual:Motion><visual:Track id="showcase" timeline={speech.timeline}>- <visual:Clip id="rounded-card" image={picture-a} extent={picture-size} during="timeline"+ <visual:Clip id="rounded-card" image={picture-a} extent={picture-size} during={speech.window}frame={card-a} z="40" fit="cover" treatment={recipes.media.card} motion={card-motion}/>- <visual:Clip id="flush-card" image={picture-b} extent={picture-size} during="timeline"+ <visual:Clip id="flush-card" image={picture-b} extent={picture-size} during={speech.window}frame={card-b} z="41" fit="cover" treatment={recipes.media.wide} motion={card-motion}/></visual:Track><film:Film id="main" canvas={vertical.canvas} timeline={speech.timeline} appearance={recipes.film.vertical}>diff --git a/packages/visual-track/src/manifest.ts b/packages/visual-track/src/manifest.tsindex ac0666d0..cb1158b3 100644--- a/packages/visual-track/src/manifest.ts+++ b/packages/visual-track/src/manifest.ts@@ -253,8 +253,7 @@ export const visualTrackMarkupSurfaces = [{name: "track", tag: "Track", mode: "structured",outputs: [spatialTypes.fit, visualTrackTypes.header, visualTrackTypes.paintLayerSpec, visualTrackTypes.sampleLayerSpec,visualTrackTypes.layerSet, visualTrackTypes.clipSpec, visualTrackTypes.set,- temporalTypes.duration, temporalTypes.extent, temporalTypes.shiftSpec, temporalTypes.instantSpec,- temporalTypes.windowSpec, temporalTypes.instant, temporalTypes.window, visualTrackTypes.program,+ visualTrackTypes.program,compositionTypes.visualTrack],vocabulary: {summary: "Places ordinary visual Clips on one completed Timeline and composes them by explicit stack order.",@@ -319,7 +318,7 @@ export const visualTrackMarkupSurfaces = [{</visual:Motion><visual:Track id="cutaways" timeline={speech.timeline}>- <visual:Clip media={prepared.media} during="timeline" frame={full} z="10" fit="cover"/>+ <visual:Clip media={prepared.media} during={program.window} frame={full} z="10" fit="cover"/><visual:Clip id="bags" media={cutaway-bags.media} during={story-time.bags}frame={full} z="20" fit="cover" treatment={recipes.visual.cutaway} motion={gentle-push}/></visual:Track>`,diff --git a/packages/visual-track/src/surface.ts b/packages/visual-track/src/surface.tsindex cb80c8e3..72d349c0 100644--- a/packages/visual-track/src/surface.ts+++ b/packages/visual-track/src/surface.ts@@ -10,7 +10,7 @@ import { spatialTypes } from "@hypit/hypit/spatial";import { recipeType } from "@hypit/hypit/recipe";import type { Recipe } from "@hypit/hypit/recipe";import { temporalTypes } from "@hypit/hypit/temporal";-import { createTemporalWindowConstruction, temporalWindowAttributeNames } from "@hypit/hypit/temporal/markup";+import { resolveTemporalWindowReference, temporalWindowAttributeNames } from "@hypit/hypit/temporal/markup";import {decodeMediaFit,@@ -593,8 +593,6 @@ export const decodeVisualTrackSurface: StructuredSurfaceHandler = ({ element, restate.addRecord("header", headerId, visualTrackTypes.header,sealVisualTrackHeader({ id: trackId }), element.range);const clips: FragmentClip[] = [];- const temporalComponents: SurfaceComponentDraft[] = [];- const temporalFragments: ReturnType<typeof createTemporalWindowConstruction>["fragments"][number][] = [];let clipIndex = 0;for (const child of element.children) {if (child.kind === "text") {@@ -629,8 +627,7 @@ export const decodeVisualTrackSurface: StructuredSurfaceHandler = ({ element, restate.addReference(motionName, reference(child.attributes.motion, `${child.name}.motion`, visualTrackTypes.motion, resolveReference));}}- const temporal = createTemporalWindowConstruction({ id, element: child, ...context, resolveReference });- state.records.push(...temporal.records); temporalComponents.push(...temporal.components); temporalFragments.push(...temporal.fragments);+ const window = resolveTemporalWindowReference({ element: child, resolveReference });const directSource = declaredVisualSource(child, resolveReference, true)!;const sourceTime = sourceTimeFrom(child, resolveReference);const mapping = child.attributes.mapping === undefined ? undefined@@ -644,7 +641,7 @@ export const decodeVisualTrackSurface: StructuredSurfaceHandler = ({ element, reallowFramePaint: true }, resolveReference);const specName = `clip-${clipSuffix}-spec`;const windowName = `clip-${clipSuffix}-window`;- state.addValue(windowName, temporal.ref, temporalTypes.window);+ state.addValue(windowName, window.ref, temporalTypes.window);state.addRecord(specName, `${trackId}.clip.${clipSuffix}.spec`, visualTrackTypes.clipSpec,decodeVisualClipSpec(treatment, { id, z: integerValue(child, "z") }), child.range);const frameName = `clip-${clipSuffix}-frame`;@@ -662,14 +659,14 @@ export const decodeVisualTrackSurface: StructuredSurfaceHandler = ({ element, reconst fragment = createVisualTrackSurfaceFragment(state.inputTypes, clips);return {records: state.records,- components: [...temporalComponents, {+ components: [{id: trackId,fragment: fragment.id,inputs: state.inputs,outputs: { visual: `${trackId}.visual`, program: `${trackId}.program` },range: element.range,}],- fragments: [...temporalFragments, fragment],+ fragments: [fragment],exports: [`${trackId}.program`,`${trackId}.visual`,diff --git a/packages/visual-track/test/visual-track.test.ts b/packages/visual-track/test/visual-track.test.tsindex 129949b4..dee615eb 100644--- a/packages/visual-track/test/visual-track.test.ts+++ b/packages/visual-track/test/visual-track.test.ts@@ -667,13 +667,14 @@ test("the Visual author Surface emits explicit graph edges for layers, absolute["surface", plain("surface", mediaTypes.compositableSurface)],["selection", plain("selection", temporalTypes.window)],["answer-segment", plain("answer-segment", temporalTypes.window)],+ ["inset-window", plain("inset-window", temporalTypes.window)],["still-style", appearance("still-style", {})],["card-style", appearance("card-style", { clip: "frame", "frame-paint": "#111111" })],["surface-style", appearance("surface-style", {})],["motion", plain("motion", visualTrackTypes.motion)],]);const root = node("visual:Track", { id: "editorial", timeline: ref("semantic") }, [- node("visual:Clip", { id: "still-card", image: ref("still"), extent: ref("extent"), frame: ref("frame"), clip: ref("clip-path"), treatment: ref("still-style"), z: "20", fit: "contain", during: "timeline" }),+ node("visual:Clip", { id: "still-card", image: ref("still"), extent: ref("extent"), frame: ref("frame"), clip: ref("clip-path"), treatment: ref("still-style"), z: "20", fit: "contain", during: ref("selection") }),node("visual:Clip", { id: "segment-card", image: ref("still"), extent: ref("extent"), frame: ref("frame"), mapping: ref("mapping"), treatment: ref("still-style"), z: "21", during: ref("answer-segment") }),node("visual:Clip", { id: "proof", media: ref("video"), frame: ref("frame"), treatment: ref("card-style"), motion: ref("motion"), z: "30", fit: "cover", during: ref("selection") }, [node("visual:Map", { rate: "1", "wrap-from": "start", "wrap-until": "end" }),@@ -686,8 +687,8 @@ test("the Visual author Surface emits explicit graph edges for layers, absolutenode("visual:Pose", { at: "start", opacity: "0" }),node("visual:Pose", { at: "end", opacity: "1" }),]),- node("visual:Clip", { image: ref("still"), extent: ref("extent"), id: "inset", frame: ref("frame"), treatment: ref("still-style"), z: "32", from: "12f", for: "2s" }),- node("visual:Clip", { surface: ref("surface"), id: "alpha-overlay", frame: ref("frame"), treatment: ref("surface-style"), z: "35", fit: "cover", during: "timeline" }, [+ node("visual:Clip", { image: ref("still"), extent: ref("extent"), id: "inset", frame: ref("frame"), treatment: ref("still-style"), z: "32", during: ref("inset-window") }),+ node("visual:Clip", { surface: ref("surface"), id: "alpha-overlay", frame: ref("frame"), treatment: ref("surface-style"), z: "35", fit: "cover", during: ref("selection") }, [node("visual:Map", { rate: "1", "wrap-from": "start", "wrap-until": "end" }),]),]);