waterplane 0.0.1 → 0.1.6

package/node_modules/@waterplane/shared/dist/dictate.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Dictation: the audio format both ends have to agree on, and the caps.
+ *
+ * ── Why the phone sends WAV and not what the microphone gives it ────────────
+ *
+ * `MediaRecorder` produces webm/opus, and nothing on the desktop side of this
+ * feature can read that: `whisper.cpp` takes 16 kHz mono PCM and nothing else,
+ * so a container would have to be transcoded on the host — which means ffmpeg,
+ * a binary this daemon otherwise does not need and which was, on the machine
+ * this was written on, BROKEN (`Library not loaded: libx265.216.dylib`) while
+ * every other part of the desktop worked. A dictation path that dies because a
+ * video codec was upgraded is not a dictation path.
+ *
+ * So the phone opens its capture graph at the sample rate whisper wants, takes
+ * the raw floats, and writes the header itself. `pcm16ToWav` is that header.
+ * The host then only has to CHECK the shape (`wavFacts`), which is 44 bytes of
+ * arithmetic and cannot fail for an environmental reason.
+ *
+ * ── The caps are seconds, not bytes ─────────────────────────────────────────
+ *
+ * At 16 kHz mono 16-bit, audio is exactly 32,000 bytes per second, so the two
+ * are the same fact — but a person dictating thinks in seconds, and the
+ * sentence they get told has to as well. `DICTATE_MAX_SECONDS` is generous on
+ * purpose: transcription is ~30× realtime on the machine that runs it, so five
+ * minutes of speech is about ten seconds of waiting, and a cap that cuts a
+ * long thought in half is worse than a wait somebody can see.
+ */
+/** What the capture graph is opened at, and the only rate whisper.cpp reads. */
+export declare const DICTATE_RATE = 16000;
+/** The longest single dictation, in seconds. */
+export declare const DICTATE_MAX_SECONDS = 300;
+/** Bytes of PCM in one second at the rate above: 16-bit mono. */
+export declare const DICTATE_BYTES_PER_SEC: number;
+/** The body cap, header included and rounded up — what the route refuses on. */
+export declare const DICTATE_MAX_BYTES: number;
+/** What a transcription attempt answers. A reason is an ANSWER, never a throw:
+ *  "no model on this desktop" and "you said nothing" are both things to show. */
+export type DictateAnswer = {
+    text: string;
+    seconds: number;
+    ms: number;
+    engine: string;
+    model?: string;
+} | {
+    error: string;
+};
+/** Whether this desktop can transcribe at all, asked before the mic opens so a
+ *  button is never offered for a thing that will fail. Absent binary, absent
+ *  model and switched off are three different sentences and stay that way. */
+export interface DictateStatus {
+    available: boolean;
+    /** Why not, in words, when `available` is false. Never set when it is true. */
+    reason?: string;
+    /** The engine that would run — `whisper.cpp` today, a service tomorrow. */
+    engine?: string;
+    /** The model file's basename, for a person deciding whether to swap it. */
+    model?: string;
+}
+/**
+ * A mono 16-bit WAV around Int16 samples.
+ *
+ * Written by hand rather than through any library because it is 44 bytes and
+ * this runs on a phone inside a WebView: a dependency here would be shipped in
+ * every bundle for one header.
+ */
+export declare function pcm16ToWav(samples: Int16Array, rate?: number): Uint8Array;
+/** Float samples in [-1, 1] as Int16, clamped. A clip is quieter than a wrap. */
+export declare function floatToPcm16(input: Float32Array): Int16Array;
+/** What a WAV body IS, or `null` if it is not one this feature can use. Read on
+ *  the host before anything is spawned: a sentence about the format beats a
+ *  whisper run that fails for a reason nobody can see. */
+export declare function wavFacts(buf: Uint8Array): {
+    rate: number;
+    channels: number;
+    bits: number;
+    seconds: number;
+    format: number;
+} | null;
+/** Whether a clip is worth spawning a transcription for. Below this it is a
+ *  mis-tap, and whisper answers a subtitle-corpus artifact for silence. */
+export declare const DICTATE_MIN_SECONDS = 0.25;
+/**
+ * The one wording for a refused clip, so the host and the phone say the same
+ * thing about the same audio.
+ *
+ * **The SHAPE checks are not decoration.** `wavFacts` walks a header and will
+ * happily report a float32 or ADPCM clip's rate and duration — they are valid
+ * WAVs — and whisper.cpp then refuses to decode it. That refusal used to reach
+ * the phone as `ENOENT … /var/folders/…/out.json`, because the transcriber
+ * reads its audio BEFORE it loads the model and **exits 0 when it cannot**, so
+ * the only trace on this side was the JSON it never wrote. A shape this feature
+ * cannot read is a fact 44 bytes of arithmetic already knows; it is said here,
+ * by name, before anything is spawned.
+ */
+export declare function dictateRefusal(facts: ReturnType<typeof wavFacts>): string | null;
+/**
+ * The language to ask the transcriber for, given what the phone knows.
+ *
+ * `auto` in, `auto` out — and `auto` for anything this engine does not have,
+ * because auto-detect transcribes and an unknown code transcribes NOTHING.
+ * Region and script subtags are dropped (`de-DE` → `de`, `zh-Hant` → `zh`):
+ * whisper's model is per language, not per locale.
+ */
+export declare function whisperLang(tag: string | undefined): string;
+/** The tag that means "let the transcriber decide", which is what whisper's
+ *  own `-l auto` is and what this app dictates in by default. */
+export declare const DICTATE_AUTO = "auto";
+/** A language's name, or its bare code when it is one only `whisperLang` knows.
+ *  `auto` is a CHOICE and is named like one, never left as a bare tag. */
+export declare function dictateLangName(code: string): string;
+/** What the control shows when it is not open: short, because it sits in a row
+ *  of 42px circles. `auto` stays a word; a language is its code, upper-cased. */
+export declare function dictateLangFace(code: string): string;
+/** What the control says it will do, as a sentence — the one place this is
+ *  worded, so the pill, its title and any future settings row agree. */
+export declare function dictateLangTitle(code: string): string;
+/**
+ * The languages to offer, given what the device says it is set to.
+ *
+ * `auto` always first: it is the default and the answer for a person who
+ * switches language mid-sentence. Then the two this app is dictated in, then
+ * the curated rest, then — only if it is not already there — the device's own
+ * language, so no phone is handed a list that cannot express what it speaks.
+ * A device tag `whisperLang` cannot place adds nothing: an unknown code
+ * transcribes NOTHING, and `auto` is already at the top.
+ */
+export declare function dictateLangChoices(deviceTag?: string): {
+    code: string;
+    label: string;
+}[];
+/**
+ * The languages a microphone offers until somebody says otherwise.
+ *
+ * Three, not the whole catalogue: the picker opens WHILE a recording is
+ * running, which is a one-handed tap between two sentences, and a 25-row list
+ * scrolled at that moment is the control failing at the one job it has. The
+ * catalogue is what Settings offers to add from.
+ */
+export declare const DICTATE_LANGS_DEFAULT: readonly string[];
+/**
+ * The languages the pill actually lists, given what Settings holds.
+ *
+ * Two rules, both about never showing a control that cannot express the state
+ * it is in:
+ *
+ *  - **An empty or unusable pick is the DEFAULT, never an empty list.** A
+ *    picker with nothing in it is a dead tap; a phone whose stored list was
+ *    written by an older build, or hand-edited, still gets a working mic.
+ *  - **The ACTIVE language is always in the list.** It is what the control
+ *    displays, and a `<select>` whose value matches no option renders as the
+ *    first one — which would silently re-aim the transcriber at a language
+ *    nobody picked, in the same control that is supposed to say which one is
+ *    in use.
+ *
+ * Order is the catalogue's, so a language keeps its place in the list however
+ * it got in.
+ */
+export declare function dictateLangOffered(picked: readonly string[] | undefined, active: string, deviceTag?: string): {
+    code: string;
+    label: string;
+}[];
+/**
+ * Where transcribed words go: onto whatever is in the box **at the moment they
+ * arrive**, never onto a snapshot taken when the microphone opened.
+ *
+ * The distinction did not matter while a transcription was one HTTP request
+ * that either answered in a second or died: nobody types in that second. It
+ * matters the moment a recording can be HELD — the desktop unreachable, the
+ * words read minutes later — because by then the person has very likely gone on
+ * writing, and `base + text` with a stale `base` would overwrite every word
+ * they typed in between. That is `local/no-draft-clobber`'s failure with a
+ * different lever: a draft is the last copy of itself, and dictation is not
+ * allowed to be the thing that deletes one.
+ *
+ * So the caller reads its box HERE, at landing time, and this joins the two.
+ * Silence appends nothing at all rather than a trailing space.
+ */
+export declare function appendDictation(base: string, text: string): string;

package/node_modules/@waterplane/shared/dist/dictate.js

@@ -0,0 +1,345 @@
+/**
+ * Dictation: the audio format both ends have to agree on, and the caps.
+ *
+ * ── Why the phone sends WAV and not what the microphone gives it ────────────
+ *
+ * `MediaRecorder` produces webm/opus, and nothing on the desktop side of this
+ * feature can read that: `whisper.cpp` takes 16 kHz mono PCM and nothing else,
+ * so a container would have to be transcoded on the host — which means ffmpeg,
+ * a binary this daemon otherwise does not need and which was, on the machine
+ * this was written on, BROKEN (`Library not loaded: libx265.216.dylib`) while
+ * every other part of the desktop worked. A dictation path that dies because a
+ * video codec was upgraded is not a dictation path.
+ *
+ * So the phone opens its capture graph at the sample rate whisper wants, takes
+ * the raw floats, and writes the header itself. `pcm16ToWav` is that header.
+ * The host then only has to CHECK the shape (`wavFacts`), which is 44 bytes of
+ * arithmetic and cannot fail for an environmental reason.
+ *
+ * ── The caps are seconds, not bytes ─────────────────────────────────────────
+ *
+ * At 16 kHz mono 16-bit, audio is exactly 32,000 bytes per second, so the two
+ * are the same fact — but a person dictating thinks in seconds, and the
+ * sentence they get told has to as well. `DICTATE_MAX_SECONDS` is generous on
+ * purpose: transcription is ~30× realtime on the machine that runs it, so five
+ * minutes of speech is about ten seconds of waiting, and a cap that cuts a
+ * long thought in half is worse than a wait somebody can see.
+ */
+/** What the capture graph is opened at, and the only rate whisper.cpp reads. */
+export const DICTATE_RATE = 16_000;
+/** The longest single dictation, in seconds. */
+export const DICTATE_MAX_SECONDS = 300;
+/** Bytes of PCM in one second at the rate above: 16-bit mono. */
+export const DICTATE_BYTES_PER_SEC = DICTATE_RATE * 2;
+/** The body cap, header included and rounded up — what the route refuses on. */
+export const DICTATE_MAX_BYTES = DICTATE_MAX_SECONDS * DICTATE_BYTES_PER_SEC + 1024;
+/**
+ * A mono 16-bit WAV around Int16 samples.
+ *
+ * Written by hand rather than through any library because it is 44 bytes and
+ * this runs on a phone inside a WebView: a dependency here would be shipped in
+ * every bundle for one header.
+ */
+export function pcm16ToWav(samples, rate = DICTATE_RATE) {
+    const bytes = samples.length * 2;
+    const buf = new ArrayBuffer(44 + bytes);
+    const view = new DataView(buf);
+    const tag = (off, s) => { for (let i = 0; i < s.length; i++)
+        view.setUint8(off + i, s.charCodeAt(i)); };
+    tag(0, "RIFF");
+    view.setUint32(4, 36 + bytes, true);
+    tag(8, "WAVE");
+    tag(12, "fmt ");
+    view.setUint32(16, 16, true); // PCM chunk size
+    view.setUint16(20, 1, true); // format 1 = PCM
+    view.setUint16(22, 1, true); // mono
+    view.setUint32(24, rate, true);
+    view.setUint32(28, rate * 2, true); // byte rate
+    view.setUint16(32, 2, true); // block align
+    view.setUint16(34, 16, true); // bits per sample
+    tag(36, "data");
+    view.setUint32(40, bytes, true);
+    new Int16Array(buf, 44).set(samples);
+    return new Uint8Array(buf);
+}
+/** Float samples in [-1, 1] as Int16, clamped. A clip is quieter than a wrap. */
+export function floatToPcm16(input) {
+    const out = new Int16Array(input.length);
+    for (let i = 0; i < input.length; i++) {
+        const s = Math.max(-1, Math.min(1, input[i]));
+        out[i] = s < 0 ? s * 0x8000 : s * 0x7fff;
+    }
+    return out;
+}
+/** What a WAV body IS, or `null` if it is not one this feature can use. Read on
+ *  the host before anything is spawned: a sentence about the format beats a
+ *  whisper run that fails for a reason nobody can see. */
+export function wavFacts(buf) {
+    if (buf.length < 44)
+        return null;
+    const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    const str = (off, n) => String.fromCharCode(...buf.subarray(off, off + n));
+    if (str(0, 4) !== "RIFF" || str(8, 4) !== "WAVE")
+        return null;
+    // Walk the chunks rather than assuming `fmt ` at 12 and `data` at 36: a
+    // recorder that writes a LIST chunk is still writing a valid WAV.
+    let off = 12;
+    let rate = 0, channels = 0, bits = 0, dataBytes = 0, format = 0;
+    while (off + 8 <= buf.length) {
+        const id = str(off, 4);
+        const size = view.getUint32(off + 4, true);
+        if (id === "fmt " && off + 8 + 16 <= buf.length) {
+            format = view.getUint16(off + 8, true);
+            channels = view.getUint16(off + 10, true);
+            rate = view.getUint32(off + 12, true);
+            bits = view.getUint16(off + 22, true);
+        }
+        else if (id === "data") {
+            // A truncated body is common (the socket died mid-upload); trust the
+            // bytes that ARRIVED over a length field describing bytes that did not.
+            dataBytes = Math.min(size, buf.length - off - 8);
+            break;
+        }
+        off += 8 + size + (size % 2);
+    }
+    if (!rate || !channels || !bits || !dataBytes)
+        return null;
+    return { rate, channels, bits, format, seconds: dataBytes / (rate * channels * (bits / 8)) };
+}
+/** Whether a clip is worth spawning a transcription for. Below this it is a
+ *  mis-tap, and whisper answers a subtitle-corpus artifact for silence. */
+export const DICTATE_MIN_SECONDS = 0.25;
+/** The `fmt ` tag of uncompressed integer PCM — the only thing `pcm16ToWav`
+ *  writes, and the only thing the transcriber is asked to read. */
+const WAVE_FORMAT_PCM = 1;
+/**
+ * The one wording for a refused clip, so the host and the phone say the same
+ * thing about the same audio.
+ *
+ * **The SHAPE checks are not decoration.** `wavFacts` walks a header and will
+ * happily report a float32 or ADPCM clip's rate and duration — they are valid
+ * WAVs — and whisper.cpp then refuses to decode it. That refusal used to reach
+ * the phone as `ENOENT … /var/folders/…/out.json`, because the transcriber
+ * reads its audio BEFORE it loads the model and **exits 0 when it cannot**, so
+ * the only trace on this side was the JSON it never wrote. A shape this feature
+ * cannot read is a fact 44 bytes of arithmetic already knows; it is said here,
+ * by name, before anything is spawned.
+ */
+export function dictateRefusal(facts) {
+    if (!facts)
+        return "that recording is not 16-bit PCM audio this desktop can read";
+    if (facts.format !== WAVE_FORMAT_PCM) {
+        return `that recording is WAV format ${facts.format}, not uncompressed PCM — this desktop reads PCM only`;
+    }
+    if (facts.bits !== 16)
+        return `that recording is ${facts.bits}-bit audio — this desktop reads 16-bit PCM only`;
+    if (facts.channels > 2)
+        return `that recording has ${facts.channels} channels — this desktop reads mono or stereo`;
+    if (facts.seconds < DICTATE_MIN_SECONDS)
+        return "nothing was said";
+    if (facts.seconds > DICTATE_MAX_SECONDS) {
+        return `that is ${Math.round(facts.seconds)}s of audio — the limit is ${DICTATE_MAX_SECONDS}s in one go`;
+    }
+    return null;
+}
+/**
+ * Every language code whisper.cpp knows, and nothing else.
+ *
+ * This list exists because of the bug it fixes. The phone sends what the
+ * browser knows it is set to — `navigator.language`, which is a BCP-47 tag like
+ * `de-DE` — and whisper takes ISO-639-1 and **refuses anything else**:
+ *
+ *   whisper_lang_id: unknown language 'de-de'
+ *   error: unknown language 'de-de'
+ *
+ * It then EXITS 0, having written no transcript, because it validates the
+ * language before it loads the model. So every dictation from a phone whose
+ * locale carries a region — which is most phones — died silently, and the host
+ * could only report the JSON that was never written. A region subtag is not a
+ * different language, and it is not this feature's job to make somebody set
+ * their phone to plain `de`.
+ *
+ * Kept as a set rather than trusting the primary subtag, because an unknown
+ * code is the exact failure being fixed: `auto` is a worse answer than a named
+ * language and a far better one than no answer at all.
+ */
+const WHISPER_LANGS = new Set([
+    "af", "am", "ar", "as", "az", "ba", "be", "bg", "bn", "bo", "br", "bs", "ca", "cs", "cy", "da",
+    "de", "el", "en", "es", "et", "eu", "fa", "fi", "fo", "fr", "gl", "gu", "ha", "haw", "he", "hi",
+    "hr", "ht", "hu", "hy", "id", "is", "it", "ja", "jw", "ka", "kk", "km", "kn", "ko", "la", "lb",
+    "ln", "lo", "lt", "lv", "mg", "mi", "mk", "ml", "mn", "mr", "ms", "mt", "my", "ne", "nl", "nn",
+    "no", "oc", "pa", "pl", "ps", "pt", "ro", "ru", "sa", "sd", "si", "sk", "sl", "sn", "so", "sq",
+    "sr", "su", "sv", "sw", "ta", "te", "tg", "th", "tk", "tl", "tr", "tt", "uk", "ur", "uz", "vi",
+    "yi", "yo", "yue", "zh",
+]);
+/** Tags a browser reports that whisper spells differently, or not at all.
+ *  `nb` (Bokmål) is the one that matters: Android reports it, whisper has only
+ *  the macrolanguage `no`, and dropping to `auto` for it would be a worse
+ *  transcription than the language the person is actually speaking. The rest
+ *  are the legacy ISO codes some WebViews still emit. */
+const LANG_ALIASES = {
+    nb: "no", jv: "jw", iw: "he", in: "id", ji: "yi", fil: "tl", cmn: "zh", mo: "ro",
+};
+/**
+ * The language to ask the transcriber for, given what the phone knows.
+ *
+ * `auto` in, `auto` out — and `auto` for anything this engine does not have,
+ * because auto-detect transcribes and an unknown code transcribes NOTHING.
+ * Region and script subtags are dropped (`de-DE` → `de`, `zh-Hant` → `zh`):
+ * whisper's model is per language, not per locale.
+ */
+export function whisperLang(tag) {
+    const raw = (tag || "").trim().toLowerCase();
+    if (!raw || raw === "auto")
+        return "auto";
+    const primary = raw.split(/[-_]/)[0];
+    const mapped = LANG_ALIASES[primary] || primary;
+    return WHISPER_LANGS.has(mapped) ? mapped : "auto";
+}
+/** The tag that means "let the transcriber decide", which is what whisper's
+ *  own `-l auto` is and what this app dictates in by default. */
+export const DICTATE_AUTO = "auto";
+/**
+ * The languages the microphone OFFERS, and why the phone's locale is not one of
+ * them by itself.
+ *
+ * The phone used to send `navigator.language` and nothing else, so a German
+ * phone asked whisper for `de` on every clip — and whisper, told a language,
+ * does not transcribe another one: it TRANSLATES it. English dictated into a
+ * German phone came back as German prose, which is the reported bug and the
+ * worst possible failure for this feature, because the words in the box are
+ * fluent, plausible and not what anybody said.
+ *
+ * A person who dictates in two languages cannot be described by one device
+ * setting, and changing the phone's system language to pick a transcriber is
+ * not a thing to ask of anybody. So the language is the DICTATION's, chosen on
+ * the microphone and remembered, with `auto` the default: auto-detect reads
+ * either language correctly, and a pinned one is there for the short clip or
+ * the technical sentence where detection is the part that wobbles.
+ *
+ * The list is curated rather than the whole of `WHISPER_LANGS`: a hundred-row
+ * picker on a phone is a worse control than a dozen, and any language missing
+ * from it is one `whisperLang` still accepts — `dictateLangChoices` adds the
+ * device's own so no phone is offered a list without its language in it.
+ */
+const DICTATE_LANG_NAMES = {
+    en: "English", de: "German", fr: "French", es: "Spanish", it: "Italian",
+    nl: "Dutch", pt: "Portuguese", pl: "Polish", ru: "Russian", uk: "Ukrainian",
+    cs: "Czech", sv: "Swedish", da: "Danish", no: "Norwegian", fi: "Finnish",
+    tr: "Turkish", el: "Greek", he: "Hebrew", ar: "Arabic", hi: "Hindi",
+    ja: "Japanese", ko: "Korean", zh: "Chinese",
+};
+/** The two this app is dictated in, first — the rest follow in the order above,
+ *  which is roughly how likely they are here and not an opinion worth a sort. */
+const DICTATE_LANG_FIRST = ["en", "de"];
+/** A language's name, or its bare code when it is one only `whisperLang` knows.
+ *  `auto` is a CHOICE and is named like one, never left as a bare tag. */
+export function dictateLangName(code) {
+    if (code === DICTATE_AUTO)
+        return "auto — whichever is spoken";
+    return DICTATE_LANG_NAMES[code] || code;
+}
+/** What the control shows when it is not open: short, because it sits in a row
+ *  of 42px circles. `auto` stays a word; a language is its code, upper-cased. */
+export function dictateLangFace(code) {
+    return code === DICTATE_AUTO ? "auto" : code.toUpperCase();
+}
+/** What the control says it will do, as a sentence — the one place this is
+ *  worded, so the pill, its title and any future settings row agree. */
+export function dictateLangTitle(code) {
+    return code === DICTATE_AUTO
+        ? "dictation is read as whichever language is spoken — pick one to pin it"
+        : `dictation is read as ${dictateLangName(code)} — anything else spoken is TRANSLATED into it`;
+}
+/**
+ * The languages to offer, given what the device says it is set to.
+ *
+ * `auto` always first: it is the default and the answer for a person who
+ * switches language mid-sentence. Then the two this app is dictated in, then
+ * the curated rest, then — only if it is not already there — the device's own
+ * language, so no phone is handed a list that cannot express what it speaks.
+ * A device tag `whisperLang` cannot place adds nothing: an unknown code
+ * transcribes NOTHING, and `auto` is already at the top.
+ */
+export function dictateLangChoices(deviceTag) {
+    const rest = Object.keys(DICTATE_LANG_NAMES).filter((c) => !DICTATE_LANG_FIRST.includes(c));
+    const codes = [DICTATE_AUTO, ...DICTATE_LANG_FIRST, ...rest];
+    const device = whisperLang(deviceTag);
+    if (device !== DICTATE_AUTO && !codes.includes(device))
+        codes.push(device);
+    return codes.map((code) => ({ code, label: dictateLangName(code) }));
+}
+/**
+ * The languages a microphone offers until somebody says otherwise.
+ *
+ * Three, not the whole catalogue: the picker opens WHILE a recording is
+ * running, which is a one-handed tap between two sentences, and a 25-row list
+ * scrolled at that moment is the control failing at the one job it has. The
+ * catalogue is what Settings offers to add from.
+ */
+export const DICTATE_LANGS_DEFAULT = [DICTATE_AUTO, "en", "de"];
+/**
+ * The languages the pill actually lists, given what Settings holds.
+ *
+ * Two rules, both about never showing a control that cannot express the state
+ * it is in:
+ *
+ *  - **An empty or unusable pick is the DEFAULT, never an empty list.** A
+ *    picker with nothing in it is a dead tap; a phone whose stored list was
+ *    written by an older build, or hand-edited, still gets a working mic.
+ *  - **The ACTIVE language is always in the list.** It is what the control
+ *    displays, and a `<select>` whose value matches no option renders as the
+ *    first one — which would silently re-aim the transcriber at a language
+ *    nobody picked, in the same control that is supposed to say which one is
+ *    in use.
+ *
+ * Order is the catalogue's, so a language keeps its place in the list however
+ * it got in.
+ */
+export function dictateLangOffered(picked, active, deviceTag) {
+    const catalogue = dictateLangChoices(deviceTag);
+    const known = new Set(catalogue.map((c) => c.code));
+    // An unknown stored code DROPS OUT rather than collapsing into `auto`:
+    // `whisperLang` answers `auto` for anything it cannot place, which is right
+    // for a clip about to be transcribed and wrong here — a list of two codes an
+    // older build wrote would silently become a picker offering auto-detect and
+    // nothing else.
+    const want = new Set((picked || [])
+        .map((c) => {
+        const norm = whisperLang(c);
+        return norm === DICTATE_AUTO && c.trim().toLowerCase() !== DICTATE_AUTO ? "" : norm;
+    })
+        .filter((c) => known.has(c)));
+    if (!want.size)
+        for (const c of DICTATE_LANGS_DEFAULT)
+            if (known.has(c))
+                want.add(c);
+    const live = whisperLang(active);
+    if (known.has(live))
+        want.add(live);
+    return catalogue.filter((c) => want.has(c.code));
+}
+/**
+ * Where transcribed words go: onto whatever is in the box **at the moment they
+ * arrive**, never onto a snapshot taken when the microphone opened.
+ *
+ * The distinction did not matter while a transcription was one HTTP request
+ * that either answered in a second or died: nobody types in that second. It
+ * matters the moment a recording can be HELD — the desktop unreachable, the
+ * words read minutes later — because by then the person has very likely gone on
+ * writing, and `base + text` with a stale `base` would overwrite every word
+ * they typed in between. That is `local/no-draft-clobber`'s failure with a
+ * different lever: a draft is the last copy of itself, and dictation is not
+ * allowed to be the thing that deletes one.
+ *
+ * So the caller reads its box HERE, at landing time, and this joins the two.
+ * Silence appends nothing at all rather than a trailing space.
+ */
+export function appendDictation(base, text) {
+    const said = text.trim();
+    if (!said)
+        return base;
+    const head = base.replace(/\s*$/, "");
+    return head ? `${head} ${said}` : said;
+}
+//# sourceMappingURL=dictate.js.map

package/node_modules/@waterplane/shared/dist/dictate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictate.js","sourceRoot":"","sources":["../src/dictate.ts"],"names":[],"mappings":"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"}

package/node_modules/@waterplane/shared/dist/dictateterms.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Dictation vocabulary: words the person uses a lot that the transcriber does
+ * not know — an app called `BA3`, a repo name, a product name.
+ *
+ * ── Two levers, both on the person's own list ───────────────────────────────
+ *
+ * 1. **The prompt.** whisper.cpp takes an initial prompt (`--prompt`) and
+ *    conditions its decoding on it, so a term that appears there is far more
+ *    likely to be SPELLED the way it appears there. That is the lever that
+ *    moves recognition itself, and it is the reason the list lives on the phone
+ *    and travels with every clip: the host has no other way to know it.
+ * 2. **The corrections.** A prompt biases, it does not guarantee. So each term
+ *    may also say what it keeps coming back as (`BA3: bee a three, be a 3`),
+ *    and those are replaced after the fact. Without any, a term is still
+ *    rejoined when it arrives SPLIT (`BA 3`, `B.A.3`, `B-A-3`) and re-cased
+ *    when it is an identifier (`ba3` → `BA3`) — the two shapes a short
+ *    identifier reliably comes back in.
+ *
+ * The re-casing is the one rule that could touch an ordinary word, so it is
+ * limited to terms that cannot be one: three characters or more, with a digit
+ * or a capital past the first letter. `Go` or `Tiptoi` is never forced onto a
+ * sentence that happened to say "go"; `NASA`, `BA3` and `iPhone` are.
+ *
+ * Nothing here decides anything: the words land in the box the person is
+ * editing, same as before, and they read them before anything is sent.
+ *
+ * ── The list, as written ────────────────────────────────────────────────────
+ *
+ * One term per line, optionally followed by a colon and what it is misheard
+ * as, comma-separated. `#` starts a comment line. Parsed by ONE function on
+ * both ends — the phone to say how many terms it has, the host to use them —
+ * so the two can never count a line differently.
+ */
+/** One entry: the spelling wanted, and what it arrives as instead. */
+export interface DictateTerm {
+    term: string;
+    heard: string[];
+}
+/** Terms kept. whisper's prompt is capped at half its text context (~224
+ *  tokens), so a longer list would be cut by the transcriber, not by us —
+ *  silently. Cut here, where the Settings row can say so. */
+export declare const DICTATE_TERMS_MAX = 60;
+/** One term or one alias, in characters. A "term" longer than this is a
+ *  sentence, and a sentence in the prompt steers style, not spelling. */
+export declare const DICTATE_TERM_MAX_CHARS = 40;
+/** Aliases per term. */
+export declare const DICTATE_HEARD_MAX = 8;
+/** The prompt handed to whisper, in characters — well inside its token cap. */
+export declare const DICTATE_PROMPT_MAX_CHARS = 600;
+/** The product's own names, which every list starts out knowing. */
+export declare function brandDictateTerms(): DictateTerm[];
+/** The list as written in Settings → the entries, deduplicated by term
+ *  (case-insensitive, the later line's aliases added to the first) and capped. */
+export declare function parseDictateTerms(text: string | null | undefined): DictateTerm[];
+/** How many non-comment lines the list has, against what `parseDictateTerms`
+ *  kept — so the Settings row can say "60 of 64 kept" instead of dropping four
+ *  in silence. */
+export declare function dictateTermsDropped(text: string | null | undefined): number;
+/** The canonical text of a parsed list — what the phone SENDS, so the query
+ *  string carries no comments and no blank lines. Round-trips through
+ *  `parseDictateTerms` unchanged. */
+export declare function serializeDictateTerms(terms: DictateTerm[]): string;
+/**
+ * The initial prompt for whisper: the terms, comma-separated, and nothing
+ * else. Deliberately no lead-in like "Glossary:" — a prompt is also read as
+ * the text that came BEFORE the clip, and an English word there nudges the
+ * language detection and the style of a German dictation.
+ *
+ * A list of ONE is said twice. Measured (large-v3-turbo, a clip saying
+ * "kwixel"): a prompt of `Kwixel.` alone changed nothing — "Quixel" both
+ * times — while `Kwixel, Kwixel.` and `BA3, Kwixel.` both spelled it the
+ * person's way, and neither changed a German clip in the same run.
+ */
+export declare function dictatePrompt(terms: DictateTerm[]): string;
+/**
+ * The transcript with the person's terms put back.
+ *
+ * Longest pattern first, so `bee a three` wins over a shorter alias inside it.
+ * Matched on whole words only (letters and digits either side end a match), so
+ * a term is never rewritten out of the middle of a longer word.
+ */
+export declare function applyDictateTerms(text: string, terms: DictateTerm[]): string;
+/**
+ * Whether a transcript is the prompt handed back.
+ *
+ * whisper, given a prompt and a clip with no speech in it, sometimes answers
+ * with the prompt — the same family of artifact as its subtitle boilerplate,
+ * and just as plausible-looking: a list of the person's own words. Refused as
+ * "no speech" rather than pasted into the box as if it had been said.
+ */
+export declare function isPromptEcho(text: string, terms: DictateTerm[]): boolean;