@allyhub/sdk 0.1.0-alpha.7 → 0.2.0-next.0

package/docs/sheets.md

@@ -0,0 +1,119 @@
+# Sheets
+
+A sheet is rows a person sorts, filters and edits as a grid and an agent writes as files: `sheet.csv`, and `sheet.yaml` beside it saying what its columns are. It is one grid (no saved views, groups or footers in its files) and not a piece: it has no format, languages or combos. `allyhub check` checks it, `allyhub dev` shows it in its editor, `allyhub render` writes it out.
+
+## A sheet item
+
+A sheet is a folder whose entry file is `sheet.csv`:
+
+```
+research/leads/
+  sheet.csv        the rows: a header row, then a row per record
+  sheet.yaml       optional: its title, its key and title columns, what each column is
+  files/           optional: files its cells name (logo.png)
+  comments.json    optional: what was said about its cells
+```
+
+- The folder may be anywhere in the project but its root, a folder whose name starts with a dot, or `node_modules`. Its place is its path from the project (`research/leads`), which commands take.
+- A sheet is never inside another item's folder (AK-M009), and its folder holds no other item (AK-M003).
+
+## sheet.csv
+
+Plain CSV (RFC 4180) with a header row:
+
+```csv
+id,company,arr,share,stage,tags,signed,active,site,contact,notes,logo
+1,Acme,12000,0.12,Won,inbound;partner,2026-10-14,true,acme.example,ops@acme.example,"Signed after a demo, ""fast""",files/acme.png
+2,Globex,,,Lead,,2026-10-14T09:30,false,https://globex.example,,,
+```
+
+- The delimiter is a comma. A field is quoted when it holds a comma, a quote or a line break; `""` is a quote inside quotes.
+- Every value is text. Its column's type says how it is read; nothing is guessed from what the values look like.
+- A row may have fewer fields than the header (the rest are empty), never more. A blank line is a row of empty cells.
+- Header names are trimmed; each is a column's name, not empty, not repeated.
+- The file's dialect is kept when the editor writes rows back (line endings, a byte-order mark, a final line ending), and every row that did not change keeps its bytes.
+
+## sheet.yaml
+
+Every field is optional; a column not named under `columns` is text (JSON Schema: `https://allyhub.com/schemas/sheet.schema.json`).
+
+```yaml
+title: Launch leads
+key: id
+primary: company
+columns:
+  arr:
+    type: number
+    format: { style: currency, currency: USD, decimals: 0 }
+    width: 120
+  share: { type: number, format: percent }
+  stage:
+    type: select
+    options:
+      - { name: Lead, color: gray }
+      - { name: Won, color: green }
+  tags: { type: multi-select, options: [inbound, partner], separator: ";" }
+  signed: { type: date, format: { style: long, time: false } }
+  active: checkbox
+  site: url
+  contact: email
+  notes: { type: text, wrap: true }
+  logo: { type: file, height: 48 }
+```
+
+| Field | Type | |
+| --- | --- | --- |
+| `title` | string | The sheet's name; its workbook's worksheet is named by it, else by the sheet's folder |
+| `key` | column name | The column whose value names a row: every row has one, and no two rows share it |
+| `primary` | column name | The column a row is called by (a record's title). Default: the first text column that is not the key, else the first column that is not the key |
+| `columns` | map | By the column's name in the header: its type alone (`active: checkbox`), or a map of the fields below |
+
+A column:
+
+| Field | Type | For | |
+| --- | --- | --- | --- |
+| `type` | one of the types below | every column | Default `text` |
+| `options` | list | `select`, `multi-select` | In order, each once. An option is a name (`Won`) or `{ name, color }` |
+| `separator` | string | `multi-select`, `file` | What joins names or paths in a cell. Default `;`. Not empty, not a quote |
+| `format` | see below | `number`, `date` | How values are shown |
+| `width` | number, px | every column | Its width in the grid |
+| `wrap` | boolean | every column | Long text wraps onto more lines |
+| `height` | number, px | `file` | Pictures this tall in the grid; rows grow to hold them |
+
+A field set on a column of another type (`options` on a number column) is a problem. An option's `color` is one of `gray`, `brown`, `red`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`; its name is trimmed, not empty, and does not contain the separator.
+
+**Number format**: `plain`, `percent` (0.12 shows as 12%), `currency`, or a map of `style` (`plain`, `percent`, `currency`; `currency` when `currency` is given, else `plain`), `decimals` (0 to 10; default as many as the value has, at most 6), `currency` (ISO 4217, default `USD`) and `thousands` (default `true`).
+
+**Date format**: `iso` (2026-10-14), `short` (Oct 14, 2026), `long` (Wednesday, October 14, 2026), or a map of `style` (default `short`) and `time` (default `true`: the time of day shows when a value has one). Without a format a date shows as `short`.
+
+## Types
+
+| Type | A value is written | Read as |
+| --- | --- | --- |
+| `text` | as it is | text |
+| `number` | `1234.5`, `-0.12`, `1e6`: digits, a point for decimals, no thousands separator | a number |
+| `select` | one option's name | the option, sorted by its place among the options |
+| `multi-select` | option names joined by the separator: `inbound;partner` | a list of names |
+| `date` | `2026-10-14`, or `2026-10-14T09:30` with optional seconds and zone (`Z`, `+02:00`); UTC without a zone | a moment |
+| `checkbox` | `true` or `false`, any case | true or false |
+| `url` | an address with no space; without a scheme it links to `https://` | a link |
+| `email` | `name@domain.tld` | a `mailto:` link |
+| `phone` | as it is | a `tel:` link |
+| `file` | a path to a file of the project, from the sheet's folder or the project's root; several joined by the separator: `files/a.png;files/b.pdf` | an attachment: a picture (png, jpg, gif, webp, avif, svg) shows as itself, any other file by its name |
+
+Any column may have an empty cell. Sorting is by type; a value its type cannot read comes after those it can, and empty cells come last whichever the direction.
+
+## comments.json
+
+Threads about a sheet's cells are kept beside it in `comments.json`, as a doc's are ([docs.md](docs.md#commentsjson)), each with the `range` it is about (`B4`, or `B4:C9`: columns by letter, rows counted from 1 under the header).
+
+## Check, measure, import, render
+
+- `allyhub check` reports AK-M009, each with its file and line: rows that are not CSV, a header with an empty or repeated name, a row with more fields than the header; a value its column's type cannot read (five per column, then a count); a `file` cell naming no file of the project; a key with an empty or repeated value; a `sheet.yaml` that is not YAML, an unknown field or one of the wrong kind, a column, key or primary the sheet does not have; a sheet inside another item's folder. A mistake in `sheet.yaml` leaves the rest of it read.
+- `allyhub sheet <sheet>` measures each column of a sheet too long to read whole: count, empty cells, distinct values, values its type cannot read, smallest and largest, the most frequent values.
+- `allyhub sheet import <file> --to <folder>` makes a sheet of a CSV, a TSV or an Excel workbook (a sheet per worksheet), never over a place that is taken.
+- `allyhub render` writes each sheet as an Excel workbook, `.allyhub/out/<place>/sheet.xlsx`; `--type` takes any of `xlsx`, `csv`, `md`, `json`, and an item's place names one sheet (`allyhub render research/leads --type csv,md`). A sheet with a problem is not written: the command fails and says why.
+
+## A sheet in a piece
+
+A piece reads a sheet's rows as data, by import or with `ctx.data(path)` for a path worked out in code, both relative to the file that names them: an object per row, keyed by the header ([project.md](project.md)). This reads the CSV alone, not `sheet.yaml`: a column whose every non-empty value is a number becomes numbers, everything else stays text, and lines with nothing in them are left out.

package/docs/slides.md

@@ -0,0 +1,111 @@
+# Slides
+
+A deck is the default export of an item's `slides.ts`: `slides({ …, pages })`, pages of one format, each one still frame. It is a single image, a carousel, slides or a PDF document.
+
+```ts file=launch/deck/slides.ts
+import { custom, part, slides } from "@allyhub/sdk";
+import { h, layout } from "@allyhub/sdk/dom";
+
+const heading = (line: string) =>
+  custom({
+    mount(el, ctx) {
+      const L = layout(ctx);
+      const title = h("h1", {
+        position: "absolute",
+        left: L.left,
+        top: L.top,
+        fontSize: 96 * L.k,
+      });
+      title.textContent = line;
+      el.append(title);
+    },
+    render() {},
+  });
+
+export default slides({
+  format: "16x9",
+  notes: true,
+  pages: ({ s }) => [
+    part({ key: "cover", layers: [heading(s("launch.deck.cover.title"))] }),
+    part({
+      key: "how",
+      still: 0,
+      layers: [heading(s("launch.deck.how.title"))],
+    }),
+  ],
+});
+```
+
+## `slides()`
+
+Besides a piece's `id`, `title`, `format`, `matrix` and `meta` ([video.md](video.md)):
+
+| Field | Type | Default | What it is |
+| --- | --- | --- | --- |
+| `pages` | `(ctx) => PartSpec[]` (or a promise) | required | The pages, in order; `ctx` is the one a video's parts function gets (`s`, `combo`, `asset`…) |
+| `notes` | boolean | false | Each page's speaker notes are the message `<prefix>.<page key>.notes` |
+| `prefix` | message key | the piece's id with `/` as `.` | The prefix of the notes' keys |
+| `look` | string | `"clean"` | The look's name |
+| `loadLimit` | seconds | 10 | How long loading may take (AK-P002) |
+| `seekLimit` | seconds | 30 | How long one page may take to draw (AK-P003) |
+
+`slides()` with no `pages` function throws; `definePiece()` and `paged()` are gone and throw.
+
+## Pages
+
+- A page is made with `part()`, with a `key` unique in the deck, and its layers ([layers.md](layers.md)). It is drawn at its `still` moment: by default 0.4 s before the end of its `dur` (4 s unless given, or `defaults.part`); `still: 0` is its first moment, a function of its length another.
+- A deck has no clock to hear: a page's speech, sounds and transition are not played. A layer's `render(t)` is called at the still only. `footage(file)` on a page shows the file's frame at that moment; `footage()` without a file has no take to show (AK-A001).
+- Layers lay out in the page's pixels with `layout(ctx)` and `ctx.dims`, as a video's do.
+
+## Formats
+
+A deck's `format` is a preset (`16x9`, `9x16`, `1x1`, `4x5`), a platform profile, a page format, or `WIDTHxHEIGHT` in pixels (each side 64 to 8192, e.g. `1200x630`). An unknown format is AK-G001.
+
+| Format | Pixels | Paper |
+| --- | --- | --- |
+| `a4` | 1240 × 1754 | 210 × 297 mm, at 150 dpi |
+| `letter` | 1275 × 1650 | 8.5 × 11 in, at 150 dpi |
+
+`a4` and `letter` are for decks only. They and `WIDTHxHEIGHT` have no covered edges; a preset or a profile has its platform's.
+
+Another format is another item that imports what it shares:
+
+```ts file=launch/handout/slides.ts
+import { slides } from "@allyhub/sdk";
+
+import deck from "../deck/slides.ts";
+
+export default slides({
+  ...deck,
+  id: "launch/handout",
+  format: "a4",
+  notes: false,
+});
+```
+
+## Speaker notes
+
+With `notes: true`, a page's notes are the message `<prefix>.<page key>.notes`. In the item's script that is the page's row, `screen.notes`:
+
+```yaml
+title: Launch deck
+parts:
+  - id: cover
+    screen:
+      title: Tidyform
+      notes: Thank the partners first.
+```
+
+The keys are read in the combo's language. A page with no notes message has none.
+
+## What a deck renders to
+
+`allyhub render` makes a deck's files in `.allyhub/out/<piece>/` (`slides.<combo key>.<ext>`), each page drawn at its still as the render draws it. `--type` picks them; `allyhub help render` lists the options.
+
+| Type | What it is |
+| --- | --- |
+| `pdf` (the default) | One page per page, at the format's paper (`a4`, `letter`) or its pixels |
+| `png` | One PNG per page, numbered from 1 |
+| `pptx` | One full-bleed picture per page (not editable objects), with its speaker notes, else the text the page shows |
+
+Every combo of the deck's matrix (its languages, for one) renders its own files. `allyhub frames` draws every page's still on one sheet.

package/docs/sound.md

@@ -0,0 +1,170 @@
+# Sound
+
+Nothing makes a sound unless the piece puts it there: each part's speech ([speech.md](speech.md)), the music, footage with `audio: true` and the sound effects a part places. Each stem is shaped, levelled to a loudness, the music dips under speech, and the sum is mastered. The render's mix and the preview's are the same computation, sample by sample. This file covers music, sound effects, the mix, the master and how the voice was recorded.
+
+```ts file=launch/film/video.ts
+import { part, take, video } from "@allyhub/sdk";
+
+import chime from "./sfx/chime.wav";
+
+export default video({
+  format: "16x9",
+  music: {
+    file: "./music/song.mp3",
+    bpm: 113,
+    downbeat: 0.42,
+    play: [
+      { from: { bar: 0 }, to: { bar: 7 } },
+      { from: { bar: 3 }, to: { bar: 7 } },
+    ],
+    end: "bar",
+    snap: true,
+    eq: [
+      { type: "highpass", hz: 60 },
+      {
+        type: "lowpass",
+        hz: 20000,
+        keys: [
+          { at: 0, hz: 1100 },
+          { at: "@drop", hz: 1100 },
+          { at: "@drop+0.3", hz: 20000 },
+        ],
+      },
+    ],
+    compress: { threshold: -6, ratio: 1.5 },
+    gain: [
+      { at: 0, db: -4 },
+      { at: "@drop", db: -4 },
+      { at: "@drop+0.1", db: 0 },
+    ],
+  },
+  mix: { music: -24, duck: { db: -6, hold: 1 }, musicFade: { out: 3 } },
+  master: { lufs: -16, truePeak: -1.5 },
+  mic: { setup: "phone", distance: 1.3, room: "bedroom" },
+  parts: ({ s }) => [
+    part({
+      key: "how",
+      speech: take("./vo/en.mp3").saying(s("launch.film.how.say")),
+      anchors: { drop: 2 },
+      sounds: [
+        { at: "paste", sound: "tick", what: "step 1" },
+        { at: 2.4, sound: "./sfx/ding.wav", gainDb: -3 },
+        {
+          at: "free-0.05",
+          sound: chime,
+          shape: { eq: [{ type: "highpass", hz: 200 }] },
+        },
+      ],
+    }),
+  ],
+});
+```
+
+A path written as a string (the music's file, a sound's) is relative to the module that wrote it ([project.md](project.md)).
+
+## Music
+
+`video({ music })`: an audio file (an import, or a path), or `MusicOptions`. Any audio file is music: a song, or a bed of a room's sound.
+
+- `file`: the music, or one per language (`{ en: a, "zh-cn": b }`); a language without an entry has none.
+- `from`: where in the file it starts, seconds; default 0.
+- `play`: stretches of the file, `[{ from, to }]`, back to back; each place in seconds, `{ beat: n }` or `{ bar: n }`. The film moves on by each stretch's exact length, so stretches cut on the beat keep the beat. Default the file from `from` to its end.
+- `loop`: `true` plays the whole file again and again, each seam crossed over 0.25 s; `{ from, to }` plays that stretch again and again after `play`. Default false: it plays once.
+- `seam`: each seam's equal-power cross-fade, seconds, before the join, so a downbeat there is heard whole; default 0.03 (0.25 with `loop: true`).
+- `bpm`: beats per minute, for `snap`, beats and bars; default the tempo the build measured.
+- `downbeat`: the file's second of bar 0; bars and beats count from 0. Default the first beat measured, or 0 with a given `bpm`.
+- `meter`: beats a bar, for `{ bar }` places and `end: "bar"`; default 4.
+- `end`: where it stops, `"film"` (the video's end, the default), `"bar"` or `"beat"` (the last bar line or beat before it); its fade out ends there.
+- `snap`: parts without speech end on the music's beats as the stretches lay them; default false.
+- `gain`: its level over the film, `[{ at, db }]`, dB over its mix level, linear in dB between points and held outside them, added to its dip under speech.
+- `filter`: an ffmpeg audio filter chain run on the file as it is decoded, on the file's clock. One chain; nothing that reads files, listens, loads plugins, makes sound or changes the timing.
+- `eq`: bands, in order, `{ type, hz, db?, q?, keys? }`: `highpass`, `lowpass`, `bandpass` (`q` default 0.707), `peak` (`q` default 1), `lowshelf`, `highshelf` (`q` the slope, default 1). `keys: [{ at, hz?, db?, q? }]` move a band over the film.
+- `compress`: a compressor after the bands, `{ threshold, ratio?, knee?, attack?, release?, window? }`, its threshold dB over the music's own loudness; the rest `COMPRESS_DEFAULTS` (ratio 2, knee 6 dB, attack 0.01 s, release 0.15 s, window 0.01 s).
+
+- A moment of `gain` and `keys` (`at`) is film seconds, an anchor of any part (`"@drop"`, `"@drop-0.2"`, `"@/drop"`), a part's key (its start), or `{ part, at }`, a word reference or seconds in that part ([speech.md](speech.md#word-references)). One that is not there is AK-T004.
+- A beat, a bar, `snap` or `end` without a tempo (no `bpm` and none measured) plays the file once, or ends it with the film, and snaps nothing; a fact says so.
+- Music shorter than the film leaves its end silent unless it loops; the `music-length` fact gives both lengths.
+- The music is levelled as shaped: `filter`, `eq` and `compress` change how it sounds, `mix` and `gain` how loud. The values are `MUSIC_DEFAULTS` ([defaults.md](defaults.md)).
+
+## Sound effects
+
+A part places its sounds: `part({ sounds: [{ at, sound, gainDb?, shape?, what? }] })`.
+
+- `at`: a word reference, an anchor or seconds from the part's start. A built-in sound's transient lands there; a file starts there.
+- `sound`: a name (the built-in synthesized `whoosh`, `tick` or `pop`, or a name of the look's `sfx`), or an audio file: an import, or a path (a string with `.` or `/` in it). A video with sound plays its sound.
+- `gainDb`: −60 to 24, over the mix's sound-effect level; default 0.
+- `shape`: `{ filter?, eq?, compress? }`, as the music's, its bands without `keys`.
+- `what`: a note for people, what it marks (`allyhub inspect timeline` prints it).
+
+The look's sounds are named in `allyhub.config.ts`: `defineConfig({ look: { sfx: { swoosh: "assets/media/sfx/swoosh.wav" } } })`, each path from the project's root; a name there replaces a built-in one. A name that is neither a sound nor a file, or a file that is not in the project, is AK-A001; a file with no sound AK-A003.
+
+A file is levelled by its integrated loudness to `mix.sfx`; a sound too short or quiet for that (a click) by its K-weighted level over its whole length. The built-in sounds move by as much as `mix.sfx` moves from its default.
+
+## Footage sound
+
+A footage layer's own sound is mixed only with `footage(file, { audio: true })`; `gainDb` (default 0) changes its level over the mix's footage level. A take's own footage (`footage()` without a file) sounds as the part's speech ([footage.md](footage.md)).
+
+## The mix
+
+`video({ mix })`: each stem's loudness target in LUFS, and the music's dip under words.
+
+| Field | Default | What it is |
+| --- | --- | --- |
+| `speech` | −16 | Each part's speech, with its room tone |
+| `music` | −20 | The music while speech plays |
+| `musicAlone` | −16 | The music where nobody speaks |
+| `sfx` | −22 | Sound-effect files; the built-in sounds move by the same amount from −22 |
+| `footage` | −16 | Footage's own sound where nobody speaks |
+| `footageUnderSpeech` | −22 | Footage's own sound while speech plays |
+| `duck` | `{ db: −8, attack: 0.3, release: 1, hold: 2 }` | How far (dB) the music dips under words, over `attack` seconds before a word and `release` after one, staying down through pauses shorter than `hold` |
+| `musicFade` | `{ in: 0.3, out: 1.5 }` | The music's fades at the start and the end, seconds (the fade out at most a quarter of the video) |
+
+The values are `MIX_DEFAULTS`. A part's own speech level is `speechGainDb` ([speech.md](speech.md#speech-gain)).
+
+## The master
+
+`video({ master })`: a loudness in LUFS (−70 to 0), `{ lufs?, truePeak? }` (`truePeak` −9 to 0 dBTP), or `false`. The default is the format's platform profile's loudness, else −14 LUFS, with a −3 dBTP true peak (`MASTER_DEFAULTS`).
+
+The mix's integrated loudness is measured and one gain brings it to `lufs`; a limiter at 4 times the sample rate holds the true peak; what came out is measured again and the gain corrected by what the limiter took, at most 4 times, until within 0.1 LU (`MASTER_MECHANICS`). Nothing rides the level over time: the mix keeps its loudness range. `false` (or `lufs: false`) keeps the mix's own level and only limits its peaks.
+
+`allyhub audio` measures a video's mix as the render makes it: its loudness, range and true peak, what the master did, silences, onsets against cuts, each part's speech. `allyhub render --type wav` writes the mastered mix.
+
+## How the voice was recorded
+
+`video({ mic })` and `part({ mic })` say what heard the voice: a microphone of some pattern and distance, in a room, over the room's own sound, through what a device does by itself, then the finishing done to it after. The speech is played through it in the mix, the same every time. A part's `mic` replaces the video's for that part; parts with the same setting are one recording, with one room tone under them while they play.
+
+- Nothing asked is `"studio"`: a cardioid 0.2 m away, no room, no room tone, finished (`"finish"`: a high-pass, a gentle de-esser and compressor). `mic: false` plays the files as they are.
+- A setup by name: `"studio"`, `"phone"` (a phone held in front, a little below the face: two omni microphones, its band, its automatic gain, a small dead room and its room tone), `"lav"` (a clip-on on the chest, in a dead room, finished). Their values are `SETUP_PRESETS`, the rooms' `ROOM_PRESETS` and the finishing's `POST_PRESETS` ([defaults.md](defaults.md)).
+- Any value of a setup changes:
+
+```ts file=talk/video.ts
+import { part, video } from "@allyhub/sdk";
+
+export default video({
+  format: "16x9",
+  mic: {
+    setup: "lav",
+    room: { preset: "office", rt60: 0.3 },
+    noise: { below: 36, hum: { hz: 50, db: -50 } },
+    post: { preset: "finish", highpass: 80 },
+    also: [{ setup: "phone", distance: 0.8, gain: -10 }],
+  },
+  parts: () => [part({ key: "x", dur: 2, mic: "phone" })],
+});
+```
+
+- `setup`: the setup whose values fill what is not given; default `"studio"`.
+- `pattern`: `omni`, `subcardioid`, `cardioid`, `supercardioid`, `hypercardioid` or `figure8`.
+- `distance`, `angle`, `below`: mouth to microphone (m); how far round from where the talker faces, and how far below the mouth (degrees).
+- `response`: the microphone's own response, `[Hz, dB]` points, linear in log frequency. `band`: `[low, high]` Hz it records; under and over them it falls away.
+- `stereo`: two microphones this far apart (m), or `false`.
+- `room`: a name (`bedroom`, `living-room`, `office`, `kitchen`, `treated`, `car`, `outdoor`), a box `{ preset?, size: [w, h, d], walls, floor, ceiling, rt60, talker }`, or `false`. A surface is a material (`hard`, `plasterboard`, `plasterboard-ceiling`, `tiles`, `concrete`, `wood`, `carpet`, `carpet-thin`, `glass`, `curtains`, `ceiling-tiles`, `foam`, `upholstery`, `grass`) or its absorption by octave from 125 Hz to 8 kHz. `rt60` (s, at 500 Hz–1 kHz) scales the surfaces' absorption until the room has it. `talker` is the mouth, m from the room's corner, facing +z.
+- `noise`: the room tone, `{ below, tilt, rumble, top, hum }` (LU under the voice at the setup's own distance; dB per octave over 1 kHz; dB more below 120 Hz; the highest frequency, Hz; a mains hum `{ hz, db }`), or `false`. Further away, the voice reaches the microphone weaker against the same room tone.
+- `agc`: the device's automatic gain, `{ target, most, attack, release, window, gate }` (target dB over the voice's loudness; under `gate` dB the gain holds), or `false`.
+- `post`: the finishing, `"finish"`, `"phone-app"`, `{ preset?, highpass, eq, deess, compress }` (thresholds dB over the voice's loudness), or `false`.
+- `source`: what recorded the file already, `{ pattern, distance }`; default a cardioid 0.2 m away (a generated voice). The setup adds only what differs.
+- `also`: more microphones that heard the same voice, `[{ setup, …, gain }]`, mixed in at `gain` dB (default −12). The finishing is the first's, on the sum.
+
+The voice's loudness is kept: a setting changes how it sounds, not how loud it is. A part's `mic` that is not valid throws where `part()` is called, naming the field.
+
+`allyhub audio recording` measures how a video's voice is recorded (the room, the room tone, the spectrum, the dynamics), beside a reference file with `--file`, and `--fit` fits the video's setting to that file and prints it for `video({ mic })`.