@motionscript/audio 0.1.0-alpha.5 → 0.1.0-alpha.7

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @motionscript/audio
 
+## 0.1.0-alpha.7
+
+## 0.1.0-alpha.6
+
+### Minor Changes
+
+- 163b708: Node types are components: one spec object handed to `component2d`, `component3d` or `componentAudio`, with no classes, decorators or JSX.
+
+  - **Writing a node type.** A component is one object literal: `key`, `state` (literals and `Types`), `defaults`, `commands`, `children`, `allowedChildren`/`allowedParents`, `provide`, `load`, and its tree's own fields (`measure`, `layout`, `render` for 2D). Behaviour comes from modules you spread in and call: `Paint`, `Flow`, `Shapes`, `Typeface`, `TextLayout`, `Aim`, `Material`, `View3D`. ADR 0007 and the custom-node docs cover it.
+  - **Building nodes in code** uses calls: `Rect({ fill: 'tomato', children: [Text({ text: 'Hi' })] })`, or `new Rect({...})` for the node itself.
+  - **Every built-in and every kit node is a component**, under the same document key. Code that tested `instanceof` a class now uses the component's `.is`, or `instanceof X.node`. Changed members:
+    - `SurfacePlot3d.valueAt` and `FunctionPlot.valueAt` are now the functions `surfaceValueAt` and `curveValue`.
+    - A system's `coordinates` is replaced by `planeMap`/`axesMap`/`systemMap`.
+    - `PieChart.isSelected` is replaced by `isSliceSelected`.
+    - `ItemGrid` is a kit module (`ItemGrid.isGrid`, `ItemGrid.define`), not a base class.
+  - **The sdk no longer exports the class surface:**
+    - the decorators: `node`, `property` and every `*Property`, `command`, `withdraw`, `driveCommand`;
+    - the authoring bases: `PaintNode`, `ShapeNode`, `TextBase`, `Mesh3DBase`, `Canvas3DBase` and the `*Base` geometry classes;
+    - `asCommand`, `compose`, `drive` and `declarePaints` from `@motionscript/sdk/component`;
+    - the `jsx-runtime` and `jsx-dev-runtime` subpaths.
+    - `Node`, `Node2D`, `Node3D` and `NodeAudio` remain as types.
+  - **Editor metadata leaves the engine.** The kits no longer declare `parentKey`, `forkable`, `layout`, `seed`, `within`, `beside` or `closed`; a host keeps those in its own configs. `describe()` now reports `holds`, the trees a type takes children from, and the placement checks use it, so a 2D viewport of your own that takes 3D children places them.
+  - A command called from code with no argument runs, and a refused child is told what its parent takes (`allowedChildren`) or where it goes (`allowedParents`).
+
 ## 0.1.0-alpha.5
 
 ### Patch Changes

package/README.md

@@ -47,7 +47,7 @@ with `Array.from` before it puts the envelope in a document.
 
 ## Nodes
 
-| Key | Seed (w x h) | Commands | Notes |
+| Key | Made for (w x h) | Commands | Notes |
 |---|---|---|---|
 | `fullWaveform` | 900 x 160 | `sweep` | whole recording; `progress` is the played share, or with `follow` the node's elapsed time over `envelope.duration`. `sweep` is a `to` of `progress` to 1 |
 | `liveWaveform` | 420 x 220 | none | a `window` of seconds centred on `offset + elapsed` (or frozen at `offset` when `playing` is off); `style` is `bars`, `line` or `blocks`; `speaker` (-1 is every voice) filters to one voice |

package/dist/browser/index.js

@@ -1,2 +1,2 @@
-import{a as v,b as m,c as _,d as V,e as S,f as A,g as y,h as g,i as E,j as b,k as w,l as B}from"./chunks/chunk-DAFIVUTT.js";import{Node2D as R,node as T,command as j,easeInOut as D,fillOps as F,property as h}from"@motionscript/sdk";import{declarePaints as k}from"@motionscript/sdk/component";var n=function(u,e,t,l){var a=arguments.length,o=a<3?e:l===null?l=Object.getOwnPropertyDescriptor(e,t):l,p;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")o=Reflect.decorate(u,e,t,l);else for(var d=u.length-1;d>=0;d--)(p=u[d])&&(o=(a<3?p(o):a>3?p(e,t,o):p(e,t))||o);return a>3&&o&&Object.defineProperty(e,t,o),o},i=class extends R{sweep(e){return this.to({data:{progress:1},duration:e.duration,easing:e.easing??D()})}declareAssets(e){super.declareAssets(e),k(this,e,{fills:[this.playedFill]})}get played(){if(!this.follow)return w(this.progress);let e=this.envelope.duration;return e<=0?0:w(this.time.elapsed/e)}renderSelf(e){let t=this.layoutBounds,l=t?.width??0,a=t?.height??0;if(l<=0||a<=0)return;let o=Math.max(1,Math.round(this.bars)),p=m(this.envelope,0,this.envelope.duration,o),d=g(p,{width:l,height:a,gap:this.gap,align:this.align,gain:this.gain,floor:this.floor});if(d.length===0)return;let x=this.played*d.length,M=b(d,c=>this.byVoice?`voice:${p[c].speaker}`:c<x?"played":"ahead");for(let[c,O]of M){let P=E(O,this.paintFor(c),this.radius);P&&e.draw(P)}}paintFor(e){if(e==="played")return this.playedFill;if(e==="ahead")return this.fill;let t=Number(e.slice(6));return!Number.isFinite(t)||t<0?this.fill:this.voiceColors[t]??y(t)}};n([h({default:v})],i.prototype,"envelope",void 0);n([h({default:120})],i.prototype,"bars",void 0);n([h({default:.3})],i.prototype,"gap",void 0);n([h({default:2})],i.prototype,"radius",void 0);n([h({default:0})],i.prototype,"progress",void 0);n([h({default:!1})],i.prototype,"follow",void 0);n([h({default:1})],i.prototype,"gain",void 0);n([h({default:.015})],i.prototype,"floor",void 0);n([h({default:"center"})],i.prototype,"align",void 0);n([h({default:!1})],i.prototype,"byVoice",void 0);n([h({default:[]})],i.prototype,"voiceColors",void 0);n([h({default:"#5b5b7a",mapper:F.resolve,tween:F.lerp})],i.prototype,"fill",void 0);n([h({default:"#6366f1",mapper:F.resolve,tween:F.lerp})],i.prototype,"playedFill",void 0);n([j()],i.prototype,"sweep",null);i=n([T({key:"fullWaveform",parentKey:"node",forkable:!0,layout:{children:"freeform",defaultWidthMode:"fixed",defaultHeightMode:"fixed",acceptsChildren:!0},seed:{width:900,height:160}})],i);import{Node2D as Y,node as I,fillOps as C,property as f}from"@motionscript/sdk";import{declarePaints as K}from"@motionscript/sdk/component";var s=function(u,e,t,l){var a=arguments.length,o=a<3?e:l===null?l=Object.getOwnPropertyDescriptor(e,t):l,p;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")o=Reflect.decorate(u,e,t,l);else for(var d=u.length-1;d>=0;d--)(p=u[d])&&(o=(a<3?p(o):a>3?p(e,t,o):p(e,t))||o);return a>3&&o&&Object.defineProperty(e,t,o),o},r=class extends Y{declareAssets(e){super.declareAssets(e),K(this,e)}get at(){return this.offset+(this.playing?Math.max(0,this.time.elapsed):0)}renderSelf(e){let t=this.layoutBounds,l=t?.width??0,a=t?.height??0;if(l<=0||a<=0)return;let o=Math.max(1,Math.round(this.bars)),p=Math.max(.05,this.window),d=this.at,x=this.speaker<0?null:Math.round(this.speaker),M=_(m(this.envelope,d-p/2,d+p/2,o),x),c=this.style==="line"?H(M):M,O=g(c,{width:l,height:a,gap:this.style==="blocks"?.12:this.gap,align:this.align,gain:this.gain,floor:this.floor});if(O.length===0)return;let P=b(O,W=>B(c[W].speaker,this.byVoice,x));for(let[W,L]of P){let N=E(L,this.paintFor(W),this.radius);N&&e.draw(N)}}paintFor(e){if(e==="all")return this.fill;let t=Number(e.slice(6));return!Number.isFinite(t)||t<0?this.fill:this.voiceColors[t]??y(t)}};s([f({default:v})],r.prototype,"envelope",void 0);s([f({default:48})],r.prototype,"bars",void 0);s([f({default:.35})],r.prototype,"gap",void 0);s([f({default:4})],r.prototype,"radius",void 0);s([f({default:3})],r.prototype,"window",void 0);s([f({default:0})],r.prototype,"offset",void 0);s([f({default:!0})],r.prototype,"playing",void 0);s([f({default:1.4})],r.prototype,"gain",void 0);s([f({default:.04})],r.prototype,"floor",void 0);s([f({default:"center"})],r.prototype,"align",void 0);s([f({default:"bars"})],r.prototype,"style",void 0);s([f({default:-1})],r.prototype,"speaker",void 0);s([f({default:!1})],r.prototype,"byVoice",void 0);s([f({default:[]})],r.prototype,"voiceColors",void 0);s([f({default:"#6366f1",mapper:C.resolve,tween:C.lerp})],r.prototype,"fill",void 0);r=s([I({key:"liveWaveform",parentKey:"node",forkable:!0,layout:{children:"freeform",defaultWidthMode:"fixed",defaultHeightMode:"fixed",acceptsChildren:!0},seed:{width:420,height:220}})],r);function H(u){let e=u.length;if(e<3)return[...u];let t=Math.max(1,Math.floor(e/5));return u.map((l,a)=>{let o=Math.min(a,e-1-a),p=w(o/t);return{magnitude:l.magnitude*p,speaker:l.speaker}})}var G=[i,r];export{v as EMPTY_ENVELOPE,i as FullWaveform,r as LiveWaveform,G as NODES,A as VOICE_PALETTE,V as WAVEFORM_ALIGNMENTS,S as WAVEFORM_STYLES,_ as forSpeaker,b as groupByPaint,g as layOutBars,E as paintBars,m as sampleEnvelope,y as voiceColor};
+import{a as p,b as s,c as w,d as W,e as L,f as T,g as f,h as c,i as u,j as m,k as g,l as B}from"./chunks/chunk-DAFIVUTT.js";import{Types as M,component2d as C,easeInOut as S,fillOps as N}from"@motionscript/sdk";var P=o=>M.custom(o,{resolve:N.resolve,lerp:N.lerp}),O=C({key:"fullWaveform",state:{envelope:M.custom(p),bars:120,gap:.3,radius:2,progress:0,follow:!1,gain:1,floor:.015,align:M.custom("center"),byVoice:!1,voiceColors:M.custom([]),fill:P("#5b5b7a"),playedFill:P("#6366f1")},load:(o,e)=>{o.fill(e.fill),o.fill(e.playedFill)},commands:{sweep:(o,e)=>{let r=o.easing?null:S(),n=e.progress;return o.animate(t=>({progress:n+(1-n)*(r?r(t):t)}))}},render:(o,e)=>{_(o,e),o.children()}});function _(o,e){let{width:r,height:n}=o.size;if(r<=0||n<=0)return;let t=Math.max(1,Math.round(e.bars)),a=s(e.envelope,0,e.envelope.duration,t),l=c(a,{width:r,height:n,gap:e.gap,align:e.align,gain:e.gain,floor:e.floor});if(l.length===0)return;let v=A(o,e)*l.length,h=m(l,i=>e.byVoice?`voice:${a[i].speaker}`:i<v?"played":"ahead");for(let[i,y]of h){let E=u(y,Y(e,i),e.radius);E&&o.draw(E)}}function A(o,e){if(!e.follow)return g(e.progress);let r=e.envelope.duration;return r<=0?0:g(o.time.elapsed/r)}function Y(o,e){if(e==="played")return o.playedFill;if(e==="ahead")return o.fill;let r=Number(e.slice(6));return!Number.isFinite(r)||r<0?o.fill:o.voiceColors[r]??f(r)}import{Types as d,component2d as I,fillOps as x}from"@motionscript/sdk";var F=I({key:"liveWaveform",state:{envelope:d.custom(p),bars:48,gap:.35,radius:4,window:3,offset:0,playing:!0,gain:1.4,floor:.04,align:d.custom("center"),style:d.custom("bars"),speaker:-1,byVoice:!1,voiceColors:d.custom([]),fill:d.custom("#6366f1",{resolve:x.resolve,lerp:x.lerp})},load:(o,e)=>o.fill(e.fill),render:(o,e)=>{D(o,e),o.children()}});function z(o,e){return e.offset+(e.playing?Math.max(0,o.time.elapsed):0)}function D(o,e){let{width:r,height:n}=o.size;if(r<=0||n<=0)return;let t=Math.max(1,Math.round(e.bars)),a=Math.max(.05,e.window),l=z(o,e),v=e.speaker<0?null:Math.round(e.speaker),h=w(s(e.envelope,l-a/2,l+a/2,t),v),i=e.style==="line"?G(h):h,y=c(i,{width:r,height:n,gap:e.style==="blocks"?.12:e.gap,align:e.align,gain:e.gain,floor:e.floor});if(y.length===0)return;let E=m(y,b=>B(i[b].speaker,e.byVoice,v));for(let[b,V]of E){let k=u(V,R(e,b),e.radius);k&&o.draw(k)}}function R(o,e){if(e==="all")return o.fill;let r=Number(e.slice(6));return!Number.isFinite(r)||r<0?o.fill:o.voiceColors[r]??f(r)}function G(o){let e=o.length;if(e<3)return[...o];let r=Math.max(1,Math.floor(e/5));return o.map((n,t)=>{let a=Math.min(t,e-1-t),l=g(a/r);return{magnitude:n.magnitude*l,speaker:n.speaker}})}var K=[O,F];export{p as EMPTY_ENVELOPE,O as FullWaveform,F as LiveWaveform,K as NODES,T as VOICE_PALETTE,W as WAVEFORM_ALIGNMENTS,L as WAVEFORM_STYLES,w as forSpeaker,m as groupByPaint,c as layOutBars,u as paintBars,s as sampleEnvelope,f as voiceColor};
 //# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/waveform/full-waveform.ts", "../../src/waveform/live-waveform.ts", "../../src/nodes.ts"],
-  "sourcesContent": ["import {\r\n  Node2D,\r\n  node,\r\n  command,\r\n  easeInOut,\r\n  fillOps,\r\n  property,\r\n  type AssetScope,\r\n  type CommandArgs,\r\n  type Fill,\r\n  type FillResolved,\r\n  type Node2DProps,\r\n  type RenderContext2D,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { declarePaints } from \"@motionscript/sdk/component\"\r\nimport type { Seekable } from \"@motionscript/sdk/component\"\r\nimport { EMPTY_ENVELOPE, sampleEnvelope, type AudioEnvelope } from \"./envelope\"\r\nimport {\r\n  clamp01,\r\n  groupByPaint,\r\n  layOutBars,\r\n  paintBars,\r\n  voiceColor,\r\n  type WaveformAlignment,\r\n} from \"./shared\"\r\n\r\nexport interface FullWaveformProps extends Node2DProps {\r\n  /** The baked recording. See {@link AudioEnvelope} for why it is baked. */\r\n  envelope: AudioEnvelope\r\n  /** How many columns the whole file is drawn as. */\r\n  bars: number\r\n  /** Space between bars, as a fraction of the pitch. See {@link layOutBars}. */\r\n  gap: number\r\n  /** Corner radius of a bar, capped at half its width. */\r\n  radius: number\r\n  /** How much of the file reads as played, `0`–`1`. Tweenable. */\r\n  progress: number\r\n  /** Drive {@link progress} from the node's own clock instead of the prop. */\r\n  follow: boolean\r\n  /** Multiplies every magnitude — a quiet track pulled up to fill its box. */\r\n  gain: number\r\n  /** How much of the box a silent bar still occupies, `0`–`1`. */\r\n  floor: number\r\n  align: WaveformAlignment\r\n  /** Colour each voice's turns rather than splitting on played / not played. */\r\n  byVoice: boolean\r\n  /** A colour per voice index. Short or empty falls back to the palette. */\r\n  voiceColors: string[]\r\n  /** The bars ahead of the playhead. */\r\n  fill: Fill\r\n  /** …and the bars behind it. */\r\n  playedFill: Fill\r\n}\r\n\r\n/**\r\n * A **waveform overview**: the whole recording's shape, drawn at once.\r\n *\r\n * The picture every audio editor opens with, and the one a podcast clip puts\r\n * under its caption — a static silhouette of the file, with a played portion\r\n * that advances. It answers \"how long is this and where are the loud parts\",\r\n * which is a question about the *file*, not about the moment; its sibling\r\n * {@link LiveWaveform} answers the other one.\r\n *\r\n * ## Progress is authored, not assumed\r\n *\r\n * {@link follow} is off by default, and that default is the considered one. A\r\n * scene has no idea where the recording it is drawing sits on the video's audio\r\n * lane — a clip is placed, trimmed and sped up out there, and none of that is\r\n * visible from in here. So the honest default is that the fill is *animation*:\r\n * the author sweeps it with a command, the same as any other tween, and it lands\r\n * wherever they put it. `follow` is the shortcut for the common arrangement\r\n * where the node appears exactly as the track starts, and it says so by being a\r\n * switch someone has to turn on rather than a behaviour that quietly disagrees\r\n * with the mix.\r\n *\r\n * ## Voices instead of progress\r\n *\r\n * With {@link byVoice} on, the played/ahead split is replaced by one colour per\r\n * speaking voice, at a size you can read. For a two-hander it is a map of the conversation: who has the\r\n * floor, where the turns are, how long each one ran. It replaces the progress\r\n * colours rather than combining with them, because a bar cannot mean two things\r\n * at once and \"played, and also Grace\" is a legend nobody can hold in their\r\n * head.\r\n */\r\n@node({\r\n  key: \"fullWaveform\",\r\n  parentKey: \"node\",\r\n  forkable: true,\r\n  layout: {\r\n    children: \"freeform\",\r\n    defaultWidthMode: \"fixed\",\r\n    defaultHeightMode: \"fixed\",\r\n    acceptsChildren: true,\r\n  },\r\n  seed: {\r\n    width: 900,\r\n    height: 160,\r\n  },\r\n})\r\nexport class FullWaveform extends Node2D<FullWaveformProps> {\r\n  @property({ default: EMPTY_ENVELOPE }) declare envelope: AudioEnvelope\r\n  @property({ default: 120 }) declare bars: number\r\n  @property({ default: 0.3 }) declare gap: number\r\n  @property({ default: 2 }) declare radius: number\r\n  @property({ default: 0 }) declare progress: number\r\n  @property({ default: false }) declare follow: boolean\r\n  @property({ default: 1 }) declare gain: number\r\n  @property({ default: 0.015 }) declare floor: number\r\n  @property({ default: \"center\" }) declare align: WaveformAlignment\r\n  @property({ default: false }) declare byVoice: boolean\r\n  @property({ default: [] }) declare voiceColors: string[]\r\n\r\n  @property({\r\n    default: \"#5b5b7a\",\r\n    mapper: fillOps.resolve,\r\n    tween: fillOps.lerp,\r\n  })\r\n  declare fill: Fill\r\n\r\n  @property({\r\n    default: \"#6366f1\",\r\n    mapper: fillOps.resolve,\r\n    tween: fillOps.lerp,\r\n  })\r\n  declare playedFill: Fill\r\n\r\n  /**\r\n   * Fill the waveform in, left to right — the node's one command, since\r\n   * everything else about it is expressible as an ordinary `to`.\r\n   */\r\n  @command()\r\n  sweep(args: CommandArgs<Record<string, never>> & { duration: number }): Seekable {\r\n    return this.to({\r\n      data: { progress: 1 } as Partial<FullWaveformProps>,\r\n      duration: args.duration,\r\n      easing: args.easing ?? easeInOut(),\r\n    })\r\n  }\r\n\r\n  /**\r\n   * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the\r\n   * paint props it carries — see {@link declarePaints}. `playedFill` is named\r\n   * past the conventional slots, so it is passed explicitly.\r\n   */\r\n  override declareAssets(assets: AssetScope): void {\r\n    super.declareAssets(assets)\r\n    declarePaints(this, assets, { fills: [this.playedFill as FillResolved[]] })\r\n  }\r\n\r\n  /** Where the fill has reached, from whichever source is in charge. */\r\n  private get played(): number {\r\n    if (!this.follow) return clamp01(this.progress)\r\n    const length = this.envelope.duration\r\n    if (length <= 0) return 0\r\n    return clamp01(this.time.elapsed / length)\r\n  }\r\n\r\n  protected renderSelf(ctx: RenderContext2D): void {\r\n    const rect = this.layoutBounds\r\n    const width = rect?.width ?? 0\r\n    const height = rect?.height ?? 0\r\n    if (width <= 0 || height <= 0) return\r\n\r\n    const count = Math.max(1, Math.round(this.bars))\r\n    const sampled = sampleEnvelope(\r\n      this.envelope,\r\n      0,\r\n      this.envelope.duration,\r\n      count\r\n    )\r\n    const boxes = layOutBars(sampled, {\r\n      width,\r\n      height,\r\n      gap: this.gap,\r\n      align: this.align,\r\n      gain: this.gain,\r\n      floor: this.floor,\r\n    })\r\n    if (boxes.length === 0) return\r\n\r\n    // One draw per colour rather than per bar — see {@link paintBars}. The key\r\n    // is a string because it has to be comparable; the paint it stands for is\r\n    // resolved after the grouping.\r\n    const edge = this.played * boxes.length\r\n    const groups = groupByPaint(boxes, (i) =>\r\n      this.byVoice\r\n        ? `voice:${sampled[i].speaker}`\r\n        : i < edge\r\n          ? \"played\"\r\n          : \"ahead\"\r\n    )\r\n\r\n    for (const [key, run] of groups) {\r\n      const graphics = paintBars(run, this.paintFor(key), this.radius)\r\n      if (graphics) ctx.draw(graphics)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * The paint a group takes.\r\n   *\r\n   * A voice's colour is a **colour string**, never one of the node's two fill\r\n   * props, and that is deliberate: a voice is identified by hue, so a gradient\r\n   * or an image there would defeat the only thing the colour is for. It also\r\n   * means these paints declare no assets, which is why {@link declareAssets}\r\n   * only has to account for the two real fill props.\r\n   */\r\n  private paintFor(key: string): Fill {\r\n    if (key === \"played\") return this.playedFill\r\n    if (key === \"ahead\") return this.fill\r\n\r\n    const voice = Number(key.slice(\"voice:\".length))\r\n    if (!Number.isFinite(voice) || voice < 0) return this.fill\r\n    return this.voiceColors[voice] ?? voiceColor(voice)\r\n  }\r\n}\r\n", "import {\r\n  Node2D,\r\n  node,\r\n  fillOps,\r\n  property,\r\n  type AssetScope,\r\n  type Fill,\r\n  type Node2DProps,\r\n  type RenderContext2D,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { declarePaints } from \"@motionscript/sdk/component\"\r\nimport {\r\n  EMPTY_ENVELOPE,\r\n  forSpeaker,\r\n  sampleEnvelope,\r\n  type AudioEnvelope,\r\n  type EnvelopeBar,\r\n} from \"./envelope\"\r\nimport {\r\n  clamp01,\r\n  groupByPaint,\r\n  layOutBars,\r\n  livePaintKey,\r\n  paintBars,\r\n  voiceColor,\r\n  type WaveformAlignment,\r\n  type WaveformStyle,\r\n} from \"./shared\"\r\n\r\nexport interface LiveWaveformProps extends Node2DProps {\r\n  /** The baked recording. See {@link AudioEnvelope} for why it is baked. */\r\n  envelope: AudioEnvelope\r\n  /** How many bars the visualiser is made of. */\r\n  bars: number\r\n  /** Space between bars, as a fraction of the pitch. */\r\n  gap: number\r\n  radius: number\r\n  /** How many seconds of audio are on screen at once. */\r\n  window: number\r\n  /** Seconds into the file the node's first frame shows. */\r\n  offset: number\r\n  /** Advance with the scene clock. Off freezes the picture at {@link offset}. */\r\n  playing: boolean\r\n  /** Multiplies every magnitude before it is clamped. */\r\n  gain: number\r\n  /** How much of the box a silent bar still occupies, `0`–`1`. */\r\n  floor: number\r\n  align: WaveformAlignment\r\n  style: WaveformStyle\r\n  /**\r\n   * Show only this voice's activity, by index into the recording's own\r\n   * numbering. `-1` — the default — is every voice.\r\n   */\r\n  speaker: number\r\n  /** Colour each bar by whoever is speaking in it. */\r\n  byVoice: boolean\r\n  /** A colour per voice index. Short or empty falls back to the palette. */\r\n  voiceColors: string[]\r\n  fill: Fill\r\n}\r\n\r\n/**\r\n * A **live audio visualiser**: bars that move with the recording as it plays.\r\n *\r\n * The thing every podcast-to-video tool puts beside the artwork. It is not a\r\n * picture of the file — that is {@link FullWaveform} — it is a picture of *this\r\n * moment*, and what it is for is making a static frame of a talking head feel\r\n * like it is playing.\r\n *\r\n * ## \"Live\" without listening\r\n *\r\n * Nothing here reads an audio device. The bars are sampled out of a baked\r\n * envelope at the node's own elapsed time, which is what makes the visualiser\r\n * survive the thing it exists for: an **export**, where there is no playback to\r\n * analyse and frames may be rendered out of order or in parallel. A frame is a\r\n * pure function of its time, so scrubbing back and forth over the visualiser\r\n * redraws exactly what it drew the first time — which an analyser node, by\r\n * construction, cannot promise. See {@link AudioEnvelope}.\r\n *\r\n * ## The speaker filter\r\n *\r\n * {@link speaker} narrows the node to one voice of a diarized recording, and it\r\n * is the reason this node knows about transcripts at all. Two visualisers beside\r\n * two headshots, each filtered to its own host, is a podcast edit that would\r\n * otherwise be done by hand for every turn — and because the filter *silences*\r\n * rather than skips (see {@link forSpeaker}), the quiet host visibly stops\r\n * talking instead of vanishing. Nothing about that requires the words: only who\r\n * is talking when, which is what the diarizer produces.\r\n *\r\n * A filter naming a voice the recording doesn't have draws a resting row rather\r\n * than everything — a picture of \"this person never speaks here\", which is\r\n * true, where falling back to the unfiltered mix would be a silent lie about\r\n * whose voice you were watching.\r\n */\r\n@node({\r\n  key: \"liveWaveform\",\r\n  parentKey: \"node\",\r\n  forkable: true,\r\n  layout: {\r\n    children: \"freeform\",\r\n    defaultWidthMode: \"fixed\",\r\n    defaultHeightMode: \"fixed\",\r\n    acceptsChildren: true,\r\n  },\r\n  seed: {\r\n    width: 420,\r\n    height: 220,\r\n  },\r\n})\r\nexport class LiveWaveform extends Node2D<LiveWaveformProps> {\r\n  @property({ default: EMPTY_ENVELOPE }) declare envelope: AudioEnvelope\r\n  @property({ default: 48 }) declare bars: number\r\n  @property({ default: 0.35 }) declare gap: number\r\n  @property({ default: 4 }) declare radius: number\r\n  @property({ default: 3 }) declare window: number\r\n  @property({ default: 0 }) declare offset: number\r\n  @property({ default: true }) declare playing: boolean\r\n  @property({ default: 1.4 }) declare gain: number\r\n  @property({ default: 0.04 }) declare floor: number\r\n  @property({ default: \"center\" }) declare align: WaveformAlignment\r\n  @property({ default: \"bars\" }) declare style: WaveformStyle\r\n  @property({ default: -1 }) declare speaker: number\r\n  @property({ default: false }) declare byVoice: boolean\r\n  @property({ default: [] }) declare voiceColors: string[]\r\n\r\n  @property({\r\n    default: \"#6366f1\",\r\n    mapper: fillOps.resolve,\r\n    tween: fillOps.lerp,\r\n  })\r\n  declare fill: Fill\r\n\r\n  override declareAssets(assets: AssetScope): void {\r\n    super.declareAssets(assets)\r\n    declarePaints(this, assets)\r\n  }\r\n\r\n  /**\r\n   * The second of the recording the visualiser is showing.\r\n   *\r\n   * Off the node's own clock rather than the scene's, which is what \"from the\r\n   * moment this node appeared\" means — the same clock the engine's own\r\n   * `Video` times its picture from, and the same one that makes a node dropped\r\n   * halfway through a clip start its recording at its entrance rather than\r\n   * partway in.\r\n   */\r\n  private get at(): number {\r\n    return this.offset + (this.playing ? Math.max(0, this.time.elapsed) : 0)\r\n  }\r\n\r\n  protected renderSelf(ctx: RenderContext2D): void {\r\n    const rect = this.layoutBounds\r\n    const width = rect?.width ?? 0\r\n    const height = rect?.height ?? 0\r\n    if (width <= 0 || height <= 0) return\r\n\r\n    const count = Math.max(1, Math.round(this.bars))\r\n    const span = Math.max(0.05, this.window)\r\n    const at = this.at\r\n    const voice = this.speaker < 0 ? null : Math.round(this.speaker)\r\n\r\n    // The window is centred on the playhead, so the bars run *toward* the\r\n    // middle and away again — the arrangement every mixer's meter uses, and the\r\n    // one that reads as sound arriving rather than as a strip scrolling past.\r\n    const sampled = forSpeaker(\r\n      sampleEnvelope(this.envelope, at - span / 2, at + span / 2, count),\r\n      voice\r\n    )\r\n\r\n    const shaped = this.style === \"line\" ? taper(sampled) : sampled\r\n    const boxes = layOutBars(shaped, {\r\n      width,\r\n      height,\r\n      gap: this.style === \"blocks\" ? 0.12 : this.gap,\r\n      align: this.align,\r\n      gain: this.gain,\r\n      floor: this.floor,\r\n    })\r\n    if (boxes.length === 0) return\r\n\r\n    const groups = groupByPaint(boxes, (i) =>\r\n      livePaintKey(shaped[i].speaker, this.byVoice, voice)\r\n    )\r\n\r\n    for (const [key, run] of groups) {\r\n      const graphics = paintBars(run, this.paintFor(key), this.radius)\r\n      if (graphics) ctx.draw(graphics)\r\n    }\r\n  }\r\n\r\n  /** See {@link FullWaveform.paintFor} — a voice is a hue, never a gradient. */\r\n  private paintFor(key: string): Fill {\r\n    if (key === \"all\") return this.fill\r\n    const voice = Number(key.slice(\"voice:\".length))\r\n    if (!Number.isFinite(voice) || voice < 0) return this.fill\r\n    return this.voiceColors[voice] ?? voiceColor(voice)\r\n  }\r\n}\r\n\r\n/**\r\n * Rolls the ends of a window off toward silence.\r\n *\r\n * What separates the `line` style from `bars`: a hard-edged window makes the\r\n * loud bar entering at the right edge appear from nothing, which reads as a\r\n * glitch rather than as sound arriving. Fading the outer fifth turns the same\r\n * data into a shape that grows out of the baseline — the profile a spectrum\r\n * display has, and the reason it looks like one object rather than a row of\r\n * separate meters.\r\n */\r\nfunction taper(bars: readonly EnvelopeBar[]): EnvelopeBar[] {\r\n  const count = bars.length\r\n  if (count < 3) return [...bars]\r\n  const edge = Math.max(1, Math.floor(count / 5))\r\n\r\n  return bars.map((bar, i) => {\r\n    const fromEnd = Math.min(i, count - 1 - i)\r\n    const weight = clamp01(fromEnd / edge)\r\n    return { magnitude: bar.magnitude * weight, speaker: bar.speaker }\r\n  })\r\n}\r\n", "import { FullWaveform } from \"./waveform/full-waveform\";\r\nimport { LiveWaveform } from \"./waveform/live-waveform\";\r\n\r\n/**\r\n * Every node type this package publishes.\r\n *\r\n * A host registers these by handing the array to an engine —\r\n * `new Engine(platform, { nodes: NODES })` — which reads each class's `@node()`\r\n * key. The decorator only *declares* that key: nothing is registered by the mere\r\n * act of importing a module, so a registry holds exactly what its owner asked\r\n * for and two engines in one process can differ about it.\r\n *\r\n * Listing class **values** is also what survives bundling. This package declares\r\n * `sideEffects: false`, which licenses a bundler to drop a module nothing\r\n * imports a value from, and a document names a node type by string — so\r\n * `import \"./waveform/full-waveform\"` for its side effect is exactly what gets shaken out, where an\r\n * array of bindings is a data dependency that cannot be.\r\n */\r\nexport const NODES = [FullWaveform, LiveWaveform];\r\n"],
-  "mappings": "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",
-  "names": ["Node2D", "node", "command", "easeInOut", "fillOps", "property", "declarePaints", "FullWaveform", "Node2D", "args", "easeInOut", "assets", "declarePaints", "clamp01", "length", "ctx", "rect", "width", "height", "count", "sampled", "sampleEnvelope", "boxes", "layOutBars", "edge", "groups", "groupByPaint", "i", "key", "run", "graphics", "paintBars", "voice", "voiceColor", "__decorate", "property", "EMPTY_ENVELOPE", "fillOps", "command", "node", "Node2D", "node", "fillOps", "property", "declarePaints", "LiveWaveform", "Node2D", "assets", "declarePaints", "ctx", "rect", "width", "height", "count", "span", "at", "voice", "sampled", "forSpeaker", "sampleEnvelope", "shaped", "taper", "boxes", "layOutBars", "groups", "groupByPaint", "i", "livePaintKey", "key", "run", "graphics", "paintBars", "voiceColor", "__decorate", "property", "EMPTY_ENVELOPE", "fillOps", "node", "taper", "bars", "count", "edge", "bar", "i", "fromEnd", "weight", "clamp01", "NODES", "FullWaveform", "LiveWaveform"]
+  "sourcesContent": ["import {\r\n  Types,\r\n  component2d,\r\n  easeInOut,\r\n  fillOps,\r\n  type Fill,\r\n  type FillResolved,\r\n  type NodeOf,\r\n  type RenderContext,\r\n  // Named so the emitted declaration reaches these through the sdk, not core.\r\n  type Node2D as _Node2D,\r\n  type Node2DProps as _Node2DProps,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { EMPTY_ENVELOPE, sampleEnvelope, type AudioEnvelope } from \"./envelope\"\r\nimport {\r\n  clamp01,\r\n  groupByPaint,\r\n  layOutBars,\r\n  paintBars,\r\n  voiceColor,\r\n  type WaveformAlignment,\r\n} from \"./shared\"\r\n\r\n/** A paint entry as the waveforms declare theirs: resolved and tweened like a fill, its kind read off the default. */\r\nconst paint = (initial: string) =>\r\n  Types.custom<Fill, FillResolved[]>(initial, { resolve: fillOps.resolve, lerp: fillOps.lerp })\r\n\r\n/**\r\n * A **waveform overview**: the whole recording's shape, drawn at once.\r\n *\r\n * The picture every audio editor opens with, and the one a podcast clip puts\r\n * under its caption — a static silhouette of the file, with a played portion\r\n * that advances. It answers \"how long is this and where are the loud parts\",\r\n * which is a question about the *file*, not about the moment; its sibling\r\n * {@link LiveWaveform} answers the other one.\r\n *\r\n * ## Progress is authored, not assumed\r\n *\r\n * `follow` is off by default, and that default is the considered one. A\r\n * scene has no idea where the recording it is drawing sits on the video's audio\r\n * lane — a clip is placed, trimmed and sped up out there, and none of that is\r\n * visible from in here. So the honest default is that the fill is *animation*:\r\n * the author sweeps it with a command, the same as any other tween, and it lands\r\n * wherever they put it. `follow` is the shortcut for the common arrangement\r\n * where the node appears exactly as the track starts, and it says so by being a\r\n * switch someone has to turn on rather than a behaviour that quietly disagrees\r\n * with the mix.\r\n *\r\n * ## Voices instead of progress\r\n *\r\n * With `byVoice` on, the played/ahead split is replaced by one colour per\r\n * speaking voice, at a size you can read. For a two-hander it is a map of the conversation: who has the\r\n * floor, where the turns are, how long each one ran. It replaces the progress\r\n * colours rather than combining with them, because a bar cannot mean two things\r\n * at once and \"played, and also Grace\" is a legend nobody can hold in their\r\n * head.\r\n */\r\nexport const FullWaveform = component2d({\r\n  key: \"fullWaveform\",\r\n  state: {\r\n    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */\r\n    envelope: Types.custom<AudioEnvelope>(EMPTY_ENVELOPE),\r\n    /** How many columns the whole file is drawn as. */\r\n    bars: 120,\r\n    /** Space between bars, as a fraction of the pitch. See {@link layOutBars}. */\r\n    gap: 0.3,\r\n    /** Corner radius of a bar, capped at half its width. */\r\n    radius: 2,\r\n    /** How much of the file reads as played, `0`–`1`. Tweenable. */\r\n    progress: 0,\r\n    /** Drive `progress` from the node's own clock instead of the prop. */\r\n    follow: false,\r\n    /** Multiplies every magnitude — a quiet track pulled up to fill its box. */\r\n    gain: 1,\r\n    /** How much of the box a silent bar still occupies, `0`–`1`. */\r\n    floor: 0.015,\r\n    align: Types.custom<WaveformAlignment>(\"center\"),\r\n    /** Colour each voice's turns rather than splitting on played / not played. */\r\n    byVoice: false,\r\n    /** A colour per voice index. Short or empty falls back to the palette. */\r\n    voiceColors: Types.custom<string[]>([]),\r\n    /** The bars ahead of the playhead. */\r\n    fill: paint(\"#5b5b7a\"),\r\n    /** …and the bars behind it. */\r\n    playedFill: paint(\"#6366f1\"),\r\n  },\r\n  // Nothing declares a component's paints but itself: `fill` and `playedFill` both.\r\n  load: (loader, state) => {\r\n    loader.fill(state.fill)\r\n    loader.fill(state.playedFill)\r\n  },\r\n  commands: {\r\n    /**\r\n     * Fill the waveform in, left to right — the node's one command, since\r\n     * everything else about it is expressible as an ordinary `to`. Eased in-out\r\n     * unless it is given an easing of its own.\r\n     */\r\n    sweep: (timeline, state) => {\r\n      const ease = timeline.easing ? null : easeInOut()\r\n      const from = state.progress\r\n      return timeline.animate((t) => ({ progress: from + (1 - from) * (ease ? ease(t) : t) }))\r\n    },\r\n  },\r\n  render: (ctx, state) => {\r\n    drawBars(ctx, state)\r\n    ctx.children()\r\n  },\r\n})\r\n\r\nexport type FullWaveform = NodeOf<typeof FullWaveform>\r\nexport type FullWaveformProps = NonNullable<Parameters<typeof FullWaveform>[0]>\r\n\r\ninterface FullState {\r\n  readonly envelope: AudioEnvelope\r\n  readonly bars: number\r\n  readonly gap: number\r\n  readonly radius: number\r\n  readonly progress: number\r\n  readonly follow: boolean\r\n  readonly gain: number\r\n  readonly floor: number\r\n  readonly align: WaveformAlignment\r\n  readonly byVoice: boolean\r\n  readonly voiceColors: string[]\r\n  readonly fill: FillResolved[]\r\n  readonly playedFill: FillResolved[]\r\n}\r\n\r\nfunction drawBars(ctx: RenderContext, s: FullState): void {\r\n  const { width, height } = ctx.size\r\n  if (width <= 0 || height <= 0) return\r\n\r\n  const count = Math.max(1, Math.round(s.bars))\r\n  const sampled = sampleEnvelope(s.envelope, 0, s.envelope.duration, count)\r\n  const boxes = layOutBars(sampled, {\r\n    width,\r\n    height,\r\n    gap: s.gap,\r\n    align: s.align,\r\n    gain: s.gain,\r\n    floor: s.floor,\r\n  })\r\n  if (boxes.length === 0) return\r\n\r\n  // One draw per colour rather than per bar — see {@link paintBars}. The key\r\n  // is a string because it has to be comparable; the paint it stands for is\r\n  // resolved after the grouping.\r\n  const edge = played(ctx, s) * boxes.length\r\n  const groups = groupByPaint(boxes, (i) =>\r\n    s.byVoice\r\n      ? `voice:${sampled[i].speaker}`\r\n      : i < edge\r\n        ? \"played\"\r\n        : \"ahead\"\r\n  )\r\n\r\n  for (const [key, run] of groups) {\r\n    const graphics = paintBars(run, paintFor(s, key), s.radius)\r\n    if (graphics) ctx.draw(graphics)\r\n  }\r\n}\r\n\r\n/** Where the fill has reached, from whichever source is in charge. */\r\nfunction played(ctx: RenderContext, s: FullState): number {\r\n  if (!s.follow) return clamp01(s.progress)\r\n  const length = s.envelope.duration\r\n  if (length <= 0) return 0\r\n  return clamp01(ctx.time.elapsed / length)\r\n}\r\n\r\n/**\r\n * The paint a group takes.\r\n *\r\n * A voice's colour is a **colour string**, never one of the node's two fill\r\n * props, and that is deliberate: a voice is identified by hue, so a gradient\r\n * or an image there would defeat the only thing the colour is for. It also\r\n * means these paints declare no assets, which is why `load` only has to account\r\n * for the two real fill props.\r\n */\r\nfunction paintFor(s: FullState, key: string): Fill {\r\n  if (key === \"played\") return s.playedFill\r\n  if (key === \"ahead\") return s.fill\r\n\r\n  const voice = Number(key.slice(\"voice:\".length))\r\n  if (!Number.isFinite(voice) || voice < 0) return s.fill\r\n  return s.voiceColors[voice] ?? voiceColor(voice)\r\n}\r\n", "import {\r\n  Types,\r\n  component2d,\r\n  fillOps,\r\n  type Fill,\r\n  type FillResolved,\r\n  type NodeOf,\r\n  type RenderContext,\r\n  // Named so the emitted declaration reaches these through the sdk, not core.\r\n  type Node2D as _Node2D,\r\n  type Node2DProps as _Node2DProps,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport {\r\n  EMPTY_ENVELOPE,\r\n  forSpeaker,\r\n  sampleEnvelope,\r\n  type AudioEnvelope,\r\n  type EnvelopeBar,\r\n} from \"./envelope\"\r\nimport {\r\n  clamp01,\r\n  groupByPaint,\r\n  layOutBars,\r\n  livePaintKey,\r\n  paintBars,\r\n  voiceColor,\r\n  type WaveformAlignment,\r\n  type WaveformStyle,\r\n} from \"./shared\"\r\n\r\n/**\r\n * A **live audio visualiser**: bars that move with the recording as it plays.\r\n *\r\n * The thing every podcast-to-video tool puts beside the artwork. It is not a\r\n * picture of the file — that is {@link FullWaveform} — it is a picture of *this\r\n * moment*, and what it is for is making a static frame of a talking head feel\r\n * like it is playing.\r\n *\r\n * ## \"Live\" without listening\r\n *\r\n * Nothing here reads an audio device. The bars are sampled out of a baked\r\n * envelope at the node's own elapsed time, which is what makes the visualiser\r\n * survive the thing it exists for: an **export**, where there is no playback to\r\n * analyse and frames may be rendered out of order or in parallel. A frame is a\r\n * pure function of its time, so scrubbing back and forth over the visualiser\r\n * redraws exactly what it drew the first time — which an analyser node, by\r\n * construction, cannot promise. See {@link AudioEnvelope}.\r\n *\r\n * ## The speaker filter\r\n *\r\n * `speaker` narrows the node to one voice of a diarized recording, and it\r\n * is the reason this node knows about transcripts at all. Two visualisers beside\r\n * two headshots, each filtered to its own host, is a podcast edit that would\r\n * otherwise be done by hand for every turn — and because the filter *silences*\r\n * rather than skips (see {@link forSpeaker}), the quiet host visibly stops\r\n * talking instead of vanishing. Nothing about that requires the words: only who\r\n * is talking when, which is what the diarizer produces.\r\n *\r\n * A filter naming a voice the recording doesn't have draws a resting row rather\r\n * than everything — a picture of \"this person never speaks here\", which is\r\n * true, where falling back to the unfiltered mix would be a silent lie about\r\n * whose voice you were watching.\r\n */\r\nexport const LiveWaveform = component2d({\r\n  key: \"liveWaveform\",\r\n  state: {\r\n    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */\r\n    envelope: Types.custom<AudioEnvelope>(EMPTY_ENVELOPE),\r\n    /** How many bars the visualiser is made of. */\r\n    bars: 48,\r\n    /** Space between bars, as a fraction of the pitch. */\r\n    gap: 0.35,\r\n    radius: 4,\r\n    /** How many seconds of audio are on screen at once. */\r\n    window: 3,\r\n    /** Seconds into the file the node's first frame shows. */\r\n    offset: 0,\r\n    /** Advance with the scene clock. Off freezes the picture at `offset`. */\r\n    playing: true,\r\n    /** Multiplies every magnitude before it is clamped. */\r\n    gain: 1.4,\r\n    /** How much of the box a silent bar still occupies, `0`–`1`. */\r\n    floor: 0.04,\r\n    align: Types.custom<WaveformAlignment>(\"center\"),\r\n    style: Types.custom<WaveformStyle>(\"bars\"),\r\n    /**\r\n     * Show only this voice's activity, by index into the recording's own\r\n     * numbering. `-1` — the default — is every voice.\r\n     */\r\n    speaker: -1,\r\n    /** Colour each bar by whoever is speaking in it. */\r\n    byVoice: false,\r\n    /** A colour per voice index. Short or empty falls back to the palette. */\r\n    voiceColors: Types.custom<string[]>([]),\r\n    fill: Types.custom<Fill, FillResolved[]>(\"#6366f1\", { resolve: fillOps.resolve, lerp: fillOps.lerp }),\r\n  },\r\n  // Nothing declares a component's paints but itself.\r\n  load: (loader, state) => loader.fill(state.fill),\r\n  render: (ctx, state) => {\r\n    drawBars(ctx, state)\r\n    ctx.children()\r\n  },\r\n})\r\n\r\nexport type LiveWaveform = NodeOf<typeof LiveWaveform>\r\nexport type LiveWaveformProps = NonNullable<Parameters<typeof LiveWaveform>[0]>\r\n\r\ninterface LiveState {\r\n  readonly envelope: AudioEnvelope\r\n  readonly bars: number\r\n  readonly gap: number\r\n  readonly radius: number\r\n  readonly window: number\r\n  readonly offset: number\r\n  readonly playing: boolean\r\n  readonly gain: number\r\n  readonly floor: number\r\n  readonly align: WaveformAlignment\r\n  readonly style: WaveformStyle\r\n  readonly speaker: number\r\n  readonly byVoice: boolean\r\n  readonly voiceColors: string[]\r\n  readonly fill: FillResolved[]\r\n}\r\n\r\n/**\r\n * The second of the recording the visualiser is showing.\r\n *\r\n * Off the node's own clock rather than the scene's, which is what \"from the\r\n * moment this node appeared\" means — the same clock the engine's own\r\n * `Video` times its picture from, and the same one that makes a node dropped\r\n * halfway through a clip start its recording at its entrance rather than\r\n * partway in.\r\n */\r\nfunction at(ctx: RenderContext, s: LiveState): number {\r\n  return s.offset + (s.playing ? Math.max(0, ctx.time.elapsed) : 0)\r\n}\r\n\r\nfunction drawBars(ctx: RenderContext, s: LiveState): void {\r\n  const { width, height } = ctx.size\r\n  if (width <= 0 || height <= 0) return\r\n\r\n  const count = Math.max(1, Math.round(s.bars))\r\n  const span = Math.max(0.05, s.window)\r\n  const now = at(ctx, s)\r\n  const voice = s.speaker < 0 ? null : Math.round(s.speaker)\r\n\r\n  // The window is centred on the playhead, so the bars run *toward* the\r\n  // middle and away again — the arrangement every mixer's meter uses, and the\r\n  // one that reads as sound arriving rather than as a strip scrolling past.\r\n  const sampled = forSpeaker(\r\n    sampleEnvelope(s.envelope, now - span / 2, now + span / 2, count),\r\n    voice\r\n  )\r\n\r\n  const shaped = s.style === \"line\" ? taper(sampled) : sampled\r\n  const boxes = layOutBars(shaped, {\r\n    width,\r\n    height,\r\n    gap: s.style === \"blocks\" ? 0.12 : s.gap,\r\n    align: s.align,\r\n    gain: s.gain,\r\n    floor: s.floor,\r\n  })\r\n  if (boxes.length === 0) return\r\n\r\n  const groups = groupByPaint(boxes, (i) =>\r\n    livePaintKey(shaped[i].speaker, s.byVoice, voice)\r\n  )\r\n\r\n  for (const [key, run] of groups) {\r\n    const graphics = paintBars(run, paintFor(s, key), s.radius)\r\n    if (graphics) ctx.draw(graphics)\r\n  }\r\n}\r\n\r\n/** See `FullWaveform`'s paints — a voice is a hue, never a gradient. */\r\nfunction paintFor(s: LiveState, key: string): Fill {\r\n  if (key === \"all\") return s.fill\r\n  const voice = Number(key.slice(\"voice:\".length))\r\n  if (!Number.isFinite(voice) || voice < 0) return s.fill\r\n  return s.voiceColors[voice] ?? voiceColor(voice)\r\n}\r\n\r\n/**\r\n * Rolls the ends of a window off toward silence.\r\n *\r\n * What separates the `line` style from `bars`: a hard-edged window makes the\r\n * loud bar entering at the right edge appear from nothing, which reads as a\r\n * glitch rather than as sound arriving. Fading the outer fifth turns the same\r\n * data into a shape that grows out of the baseline — the profile a spectrum\r\n * display has, and the reason it looks like one object rather than a row of\r\n * separate meters.\r\n */\r\nfunction taper(bars: readonly EnvelopeBar[]): EnvelopeBar[] {\r\n  const count = bars.length\r\n  if (count < 3) return [...bars]\r\n  const edge = Math.max(1, Math.floor(count / 5))\r\n\r\n  return bars.map((bar, i) => {\r\n    const fromEnd = Math.min(i, count - 1 - i)\r\n    const weight = clamp01(fromEnd / edge)\r\n    return { magnitude: bar.magnitude * weight, speaker: bar.speaker }\r\n  })\r\n}\r\n", "import { FullWaveform } from \"./waveform/full-waveform\";\r\nimport { LiveWaveform } from \"./waveform/live-waveform\";\r\n\r\n/**\r\n * Every node type this package publishes.\r\n *\r\n * A host registers these by handing the array to an engine —\r\n * `new Engine(platform, { nodes: NODES })` — which reads each component's key.\r\n * Defining a component only *declares* that key: nothing is registered by\r\n * importing a module, so a registry holds exactly what its owner asked for.\r\n *\r\n * Listing the component **values** is also what survives bundling: this package\r\n * declares `sideEffects: false`, and a document names a node type by string, so\r\n * an import kept only for its side effect is exactly what gets shaken out.\r\n */\r\n// Typed by name, so the declaration names each component rather than spelling out its type through core.\r\nexport const NODES: (typeof FullWaveform | typeof LiveWaveform)[] = [FullWaveform, LiveWaveform];\r\n"],
+  "mappings": "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",
+  "names": ["Types", "component2d", "easeInOut", "fillOps", "paint", "initial", "Types", "fillOps", "FullWaveform", "component2d", "EMPTY_ENVELOPE", "loader", "state", "timeline", "ease", "easeInOut", "from", "ctx", "drawBars", "s", "width", "height", "count", "sampled", "sampleEnvelope", "boxes", "layOutBars", "edge", "played", "groups", "groupByPaint", "key", "run", "graphics", "paintBars", "paintFor", "clamp01", "length", "voice", "voiceColor", "Types", "component2d", "fillOps", "LiveWaveform", "component2d", "Types", "EMPTY_ENVELOPE", "fillOps", "loader", "state", "ctx", "drawBars", "at", "s", "width", "height", "count", "span", "now", "voice", "sampled", "forSpeaker", "sampleEnvelope", "shaped", "taper", "boxes", "layOutBars", "groups", "groupByPaint", "i", "livePaintKey", "key", "run", "graphics", "paintBars", "paintFor", "voiceColor", "bars", "edge", "bar", "fromEnd", "weight", "clamp01", "NODES", "FullWaveform", "LiveWaveform"]
 }

package/dist/browser/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionscript/audio",
-  "version": "0.1.0-alpha.5",
+  "version": "0.1.0-alpha.7",
   "exports": {
     ".": "dist/browser/index.js",
     "./kit": "dist/browser/kit.js"

package/dist/nodes.d.ts

@@ -4,16 +4,13 @@ import { LiveWaveform } from "./waveform/live-waveform.js";
  * Every node type this package publishes.
  *
  * A host registers these by handing the array to an engine —
- * `new Engine(platform, { nodes: NODES })` — which reads each class's `@node()`
- * key. The decorator only *declares* that key: nothing is registered by the mere
- * act of importing a module, so a registry holds exactly what its owner asked
- * for and two engines in one process can differ about it.
+ * `new Engine(platform, { nodes: NODES })` — which reads each component's key.
+ * Defining a component only *declares* that key: nothing is registered by
+ * importing a module, so a registry holds exactly what its owner asked for.
  *
- * Listing class **values** is also what survives bundling. This package declares
- * `sideEffects: false`, which licenses a bundler to drop a module nothing
- * imports a value from, and a document names a node type by string — so
- * `import "./waveform/full-waveform.js"` for its side effect is exactly what gets shaken out, where an
- * array of bindings is a data dependency that cannot be.
+ * Listing the component **values** is also what survives bundling: this package
+ * declares `sideEffects: false`, and a document names a node type by string, so
+ * an import kept only for its side effect is exactly what gets shaken out.
  */
 export declare const NODES: (typeof FullWaveform | typeof LiveWaveform)[];
 //# sourceMappingURL=nodes.d.ts.map

package/dist/nodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,+CAA+B,CAAC"}
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,KAAK,EAAE,CAAC,OAAO,YAAY,GAAG,OAAO,YAAY,CAAC,EAAiC,CAAC"}

package/dist/nodes.js

@@ -4,16 +4,14 @@ import { LiveWaveform } from "./waveform/live-waveform.js";
  * Every node type this package publishes.
  *
  * A host registers these by handing the array to an engine —
- * `new Engine(platform, { nodes: NODES })` — which reads each class's `@node()`
- * key. The decorator only *declares* that key: nothing is registered by the mere
- * act of importing a module, so a registry holds exactly what its owner asked
- * for and two engines in one process can differ about it.
+ * `new Engine(platform, { nodes: NODES })` — which reads each component's key.
+ * Defining a component only *declares* that key: nothing is registered by
+ * importing a module, so a registry holds exactly what its owner asked for.
  *
- * Listing class **values** is also what survives bundling. This package declares
- * `sideEffects: false`, which licenses a bundler to drop a module nothing
- * imports a value from, and a document names a node type by string — so
- * `import "./waveform/full-waveform.js"` for its side effect is exactly what gets shaken out, where an
- * array of bindings is a data dependency that cannot be.
+ * Listing the component **values** is also what survives bundling: this package
+ * declares `sideEffects: false`, and a document names a node type by string, so
+ * an import kept only for its side effect is exactly what gets shaken out.
  */
+// Typed by name, so the declaration names each component rather than spelling out its type through core.
 export const NODES = [FullWaveform, LiveWaveform];
 //# sourceMappingURL=nodes.js.map

package/dist/nodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC","sourcesContent":["import { FullWaveform } from \"./waveform/full-waveform\";\r\nimport { LiveWaveform } from \"./waveform/live-waveform\";\r\n\r\n/**\r\n * Every node type this package publishes.\r\n *\r\n * A host registers these by handing the array to an engine —\r\n * `new Engine(platform, { nodes: NODES })` — which reads each class's `@node()`\r\n * key. The decorator only *declares* that key: nothing is registered by the mere\r\n * act of importing a module, so a registry holds exactly what its owner asked\r\n * for and two engines in one process can differ about it.\r\n *\r\n * Listing class **values** is also what survives bundling. This package declares\r\n * `sideEffects: false`, which licenses a bundler to drop a module nothing\r\n * imports a value from, and a document names a node type by string — so\r\n * `import \"./waveform/full-waveform\"` for its side effect is exactly what gets shaken out, where an\r\n * array of bindings is a data dependency that cannot be.\r\n */\r\nexport const NODES = [FullWaveform, LiveWaveform];\r\n"]}
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,yGAAyG;AACzG,MAAM,CAAC,MAAM,KAAK,GAAkD,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC","sourcesContent":["import { FullWaveform } from \"./waveform/full-waveform\";\r\nimport { LiveWaveform } from \"./waveform/live-waveform\";\r\n\r\n/**\r\n * Every node type this package publishes.\r\n *\r\n * A host registers these by handing the array to an engine —\r\n * `new Engine(platform, { nodes: NODES })` — which reads each component's key.\r\n * Defining a component only *declares* that key: nothing is registered by\r\n * importing a module, so a registry holds exactly what its owner asked for.\r\n *\r\n * Listing the component **values** is also what survives bundling: this package\r\n * declares `sideEffects: false`, and a document names a node type by string, so\r\n * an import kept only for its side effect is exactly what gets shaken out.\r\n */\r\n// Typed by name, so the declaration names each component rather than spelling out its type through core.\r\nexport const NODES: (typeof FullWaveform | typeof LiveWaveform)[] = [FullWaveform, LiveWaveform];\r\n"]}

package/dist/waveform/full-waveform.d.ts

@@ -1,34 +1,5 @@
-import { Node2D, type AssetScope, type CommandArgs, type Fill, type Node2DProps, type RenderContext2D } from "@motionscript/sdk";
-import type { Seekable } from "@motionscript/sdk/component";
+import { type Fill, type FillResolved, type NodeOf, type Node2D as _Node2D, type Node2DProps as _Node2DProps } from "@motionscript/sdk";
 import { type AudioEnvelope } from "./envelope.js";
-import { type WaveformAlignment } from "./shared.js";
-export interface FullWaveformProps extends Node2DProps {
-    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */
-    envelope: AudioEnvelope;
-    /** How many columns the whole file is drawn as. */
-    bars: number;
-    /** Space between bars, as a fraction of the pitch. See {@link layOutBars}. */
-    gap: number;
-    /** Corner radius of a bar, capped at half its width. */
-    radius: number;
-    /** How much of the file reads as played, `0`–`1`. Tweenable. */
-    progress: number;
-    /** Drive {@link progress} from the node's own clock instead of the prop. */
-    follow: boolean;
-    /** Multiplies every magnitude — a quiet track pulled up to fill its box. */
-    gain: number;
-    /** How much of the box a silent bar still occupies, `0`–`1`. */
-    floor: number;
-    align: WaveformAlignment;
-    /** Colour each voice's turns rather than splitting on played / not played. */
-    byVoice: boolean;
-    /** A colour per voice index. Short or empty falls back to the palette. */
-    voiceColors: string[];
-    /** The bars ahead of the playhead. */
-    fill: Fill;
-    /** …and the bars behind it. */
-    playedFill: Fill;
-}
 /**
  * A **waveform overview**: the whole recording's shape, drawn at once.
  *
@@ -40,7 +11,7 @@ export interface FullWaveformProps extends Node2DProps {
  *
  * ## Progress is authored, not assumed
  *
- * {@link follow} is off by default, and that default is the considered one. A
+ * `follow` is off by default, and that default is the considered one. A
  * scene has no idea where the recording it is drawing sits on the video's audio
  * lane — a clip is placed, trimmed and sped up out there, and none of that is
  * visible from in here. So the honest default is that the fill is *animation*:
@@ -52,52 +23,96 @@ export interface FullWaveformProps extends Node2DProps {
  *
  * ## Voices instead of progress
  *
- * With {@link byVoice} on, the played/ahead split is replaced by one colour per
+ * With `byVoice` on, the played/ahead split is replaced by one colour per
  * speaking voice, at a size you can read. For a two-hander it is a map of the conversation: who has the
  * floor, where the turns are, how long each one ran. It replaces the progress
  * colours rather than combining with them, because a bar cannot mean two things
  * at once and "played, and also Grace" is a legend nobody can hold in their
  * head.
  */
-export declare class FullWaveform extends Node2D<FullWaveformProps> {
-    envelope: AudioEnvelope;
-    bars: number;
-    gap: number;
-    radius: number;
-    progress: number;
-    follow: boolean;
-    gain: number;
-    floor: number;
-    align: WaveformAlignment;
-    byVoice: boolean;
-    voiceColors: string[];
-    fill: Fill;
-    playedFill: Fill;
-    /**
-     * Fill the waveform in, left to right — the node's one command, since
-     * everything else about it is expressible as an ordinary `to`.
-     */
-    sweep(args: CommandArgs<Record<string, never>> & {
-        duration: number;
-    }): Seekable;
-    /**
-     * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the
-     * paint props it carries — see {@link declarePaints}. `playedFill` is named
-     * past the conventional slots, so it is passed explicitly.
-     */
-    declareAssets(assets: AssetScope): void;
-    /** Where the fill has reached, from whichever source is in charge. */
-    private get played();
-    protected renderSelf(ctx: RenderContext2D): void;
-    /**
-     * The paint a group takes.
-     *
-     * A voice's colour is a **colour string**, never one of the node's two fill
-     * props, and that is deliberate: a voice is identified by hue, so a gradient
-     * or an image there would defeat the only thing the colour is for. It also
-     * means these paints declare no assets, which is why {@link declareAssets}
-     * only has to account for the two real fill props.
-     */
-    private paintFor;
-}
+export declare const FullWaveform: import("@motionscript/sdk").Component<"fullWaveform", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */
+    readonly envelope: import("@motionscript/sdk").Type<AudioEnvelope, AudioEnvelope, false>;
+    /** How many columns the whole file is drawn as. */
+    readonly bars: 120;
+    /** Space between bars, as a fraction of the pitch. See {@link layOutBars}. */
+    readonly gap: 0.3;
+    /** Corner radius of a bar, capped at half its width. */
+    readonly radius: 2;
+    /** How much of the file reads as played, `0`–`1`. Tweenable. */
+    readonly progress: 0;
+    /** Drive `progress` from the node's own clock instead of the prop. */
+    readonly follow: false;
+    /** Multiplies every magnitude — a quiet track pulled up to fill its box. */
+    readonly gain: 1;
+    /** How much of the box a silent bar still occupies, `0`–`1`. */
+    readonly floor: 0.015;
+    readonly align: import("@motionscript/sdk").Type<"center" | "bottom", "center" | "bottom", false>;
+    /** Colour each voice's turns rather than splitting on played / not played. */
+    readonly byVoice: false;
+    /** A colour per voice index. Short or empty falls back to the palette. */
+    readonly voiceColors: import("@motionscript/sdk").Type<string[], string[], false>;
+    /** The bars ahead of the playhead. */
+    readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+    /** …and the bars behind it. */
+    readonly playedFill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+}>, {
+    readonly sweep: unknown;
+}, null, _Node2D<_Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */
+    readonly envelope: import("@motionscript/sdk").Type<AudioEnvelope, AudioEnvelope, false>;
+    /** How many columns the whole file is drawn as. */
+    readonly bars: 120;
+    /** Space between bars, as a fraction of the pitch. See {@link layOutBars}. */
+    readonly gap: 0.3;
+    /** Corner radius of a bar, capped at half its width. */
+    readonly radius: 2;
+    /** How much of the file reads as played, `0`–`1`. Tweenable. */
+    readonly progress: 0;
+    /** Drive `progress` from the node's own clock instead of the prop. */
+    readonly follow: false;
+    /** Multiplies every magnitude — a quiet track pulled up to fill its box. */
+    readonly gain: 1;
+    /** How much of the box a silent bar still occupies, `0`–`1`. */
+    readonly floor: 0.015;
+    readonly align: import("@motionscript/sdk").Type<"center" | "bottom", "center" | "bottom", false>;
+    /** Colour each voice's turns rather than splitting on played / not played. */
+    readonly byVoice: false;
+    /** A colour per voice index. Short or empty falls back to the palette. */
+    readonly voiceColors: import("@motionscript/sdk").Type<string[], string[], false>;
+    /** The bars ahead of the playhead. */
+    readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+    /** …and the bars behind it. */
+    readonly playedFill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+}>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */
+    readonly envelope: import("@motionscript/sdk").Type<AudioEnvelope, AudioEnvelope, false>;
+    /** How many columns the whole file is drawn as. */
+    readonly bars: 120;
+    /** Space between bars, as a fraction of the pitch. See {@link layOutBars}. */
+    readonly gap: 0.3;
+    /** Corner radius of a bar, capped at half its width. */
+    readonly radius: 2;
+    /** How much of the file reads as played, `0`–`1`. Tweenable. */
+    readonly progress: 0;
+    /** Drive `progress` from the node's own clock instead of the prop. */
+    readonly follow: false;
+    /** Multiplies every magnitude — a quiet track pulled up to fill its box. */
+    readonly gain: 1;
+    /** How much of the box a silent bar still occupies, `0`–`1`. */
+    readonly floor: 0.015;
+    readonly align: import("@motionscript/sdk").Type<"center" | "bottom", "center" | "bottom", false>;
+    /** Colour each voice's turns rather than splitting on played / not played. */
+    readonly byVoice: false;
+    /** A colour per voice index. Short or empty falls back to the palette. */
+    readonly voiceColors: import("@motionscript/sdk").Type<string[], string[], false>;
+    /** The bars ahead of the playhead. */
+    readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+    /** …and the bars behind it. */
+    readonly playedFill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+}>, {
+    readonly sweep: unknown;
+}, _Node2D<_Node2DProps>>>>;
+export type FullWaveform = NodeOf<typeof FullWaveform>;
+export type FullWaveformProps = NonNullable<Parameters<typeof FullWaveform>[0]>;
 //# sourceMappingURL=full-waveform.d.ts.map

package/dist/waveform/full-waveform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"full-waveform.d.ts","sourceRoot":"","sources":["../../src/waveform/full-waveform.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAMN,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,IAAI,EAET,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAkC,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/E,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,0EAA0E;IAC1E,QAAQ,EAAE,aAAa,CAAA;IACvB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAA;IACX,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAA;IACf,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,iBAAiB,CAAA;IACxB,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAA;IAChB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,sCAAsC;IACtC,IAAI,EAAE,IAAI,CAAA;IACV,+BAA+B;IAC/B,UAAU,EAAE,IAAI,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAea,YAAa,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IACV,QAAQ,EAAE,aAAa,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACR,KAAK,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,iBAAiB,CAAA;IAC3B,OAAO,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,MAAM,EAAE,CAAA;IAOhD,IAAI,EAAE,IAAI,CAAA;IAOV,UAAU,EAAE,IAAI,CAAA;IAExB;;;OAGG;IAEH,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IAQhF;;;;OAIG;IACM,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKhD,sEAAsE;IACtE,OAAO,KAAK,MAAM,GAKjB;IAED,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAyChD;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ;CAQjB"}
+{"version":3,"file":"full-waveform.d.ts","sourceRoot":"","sources":["../../src/waveform/full-waveform.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,MAAM,EAGX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,IAAI,YAAY,EACjC,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAkC,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAc/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,YAAY;IAGrB,0EAA0E;;IAE1E,mDAAmD;;IAEnD,8EAA8E;;IAE9E,wDAAwD;;IAExD,gEAAgE;;IAEhE,sEAAsE;;IAEtE,4EAA4E;;IAE5E,gEAAgE;;;IAGhE,8EAA8E;;IAE9E,0EAA0E;;IAE1E,sCAAsC;;IAEtC,+BAA+B;;;;;IAvB/B,0EAA0E;;IAE1E,mDAAmD;;IAEnD,8EAA8E;;IAE9E,wDAAwD;;IAExD,gEAAgE;;IAEhE,sEAAsE;;IAEtE,4EAA4E;;IAE5E,gEAAgE;;;IAGhE,8EAA8E;;IAE9E,0EAA0E;;IAE1E,sCAAsC;;IAEtC,+BAA+B;;;IAvB/B,0EAA0E;;IAE1E,mDAAmD;;IAEnD,8EAA8E;;IAE9E,wDAAwD;;IAExD,gEAAgE;;IAEhE,sEAAsE;;IAEtE,4EAA4E;;IAE5E,gEAAgE;;;IAGhE,8EAA8E;;IAE9E,0EAA0E;;IAE1E,sCAAsC;;IAEtC,+BAA+B;;;;2BAwBjC,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,YAAY,CAAC,CAAA;AACtD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA"}