@allyhub/sdk 0.1.0-alpha.8 → 0.2.0-next.1

package/node_modules/@allyhub-next/video-core/dist/console.d.ts

@@ -0,0 +1,91 @@
+import type { Combo } from "./matrix.js";
+export declare const CONSOLE_LEVELS: readonly ["log", "info", "warn", "error", "debug"];
+export type ConsoleLevel = (typeof CONSOLE_LEVELS)[number];
+/**
+ * What piece code was doing when it printed: loading its files' top level
+ * (`module`), running the output's function (`build`), a layer's `mount`
+ * or `render`, drawing a cover (`cover`), or anything else, such as a
+ * callback that ran later (`other`).
+ */
+export type ConsolePhase = "module" | "build" | "mount" | "render" | "cover" | "other";
+/** Where a console call was made, as the stage knows it. */
+export interface ConsoleWhere {
+    phase: ConsolePhase;
+    /** The part (or page) whose layer was running. */
+    part?: string;
+    /** The layer's component name ("custom" for custom()). */
+    layer?: string;
+    /** The layer's place in its part's `layers`, from 0. */
+    index?: number;
+    /** render and cover: the part time drawn, seconds from the part's start (render's t). */
+    t?: number;
+}
+/** One message: the same text printed at the same place, with its count. */
+export interface ConsoleMessage extends ConsoleWhere {
+    level: ConsoleLevel;
+    text: string;
+    /** render: the latest part time it was printed at, when later than `t`. */
+    until?: number;
+    /** How many calls printed it. */
+    count: number;
+}
+/** What one output × combo × format printed. */
+export interface ConsoleLog {
+    messages: ConsoleMessage[];
+    /** Calls not kept: their message came after `limit` others. */
+    dropped: number;
+}
+/** A message with the output × combo × format it came from. */
+export interface ConsoleEntry extends ConsoleMessage {
+    piece: string;
+    output: string;
+    combo: Combo;
+    format: string;
+}
+/** What a command's pages printed, for the CLI. */
+export interface ConsoleReport {
+    entries: ConsoleEntry[];
+    /** Calls not kept, over every output × combo × format. */
+    dropped: number;
+    /** The most messages kept per output × combo × format. */
+    limit: number;
+}
+/** The most different messages kept per output × combo × format by default. */
+export declare const CONSOLE_LIMIT = 200;
+/** The longest text kept of one call, in characters; the rest is cut with a note. */
+export declare const CONSOLE_TEXT_MAX = 4000;
+/**
+ * Collects messages: the same text at the same place counts once (with the
+ * earliest and latest part time it was printed at), at most `limit`
+ * different ones. Pure: the stage and the host both use it.
+ */
+export declare class ConsoleCollector {
+    readonly limit: number;
+    private readonly kept;
+    private droppedCalls;
+    constructor(limit?: number);
+    /** Adds one call (or `count` calls, from another collector). */
+    add(m: ConsoleWhere & {
+        level: ConsoleLevel;
+        text: string;
+        count?: number;
+        until?: number;
+    }): void;
+    /** Adds what another collector kept and dropped. */
+    merge(log: ConsoleLog): void;
+    /**
+     * What was kept, in order: phase (module, build, mount, render, cover,
+     * other), then part in `parts` order, then part time, then first printed.
+     */
+    log(parts?: readonly string[]): ConsoleLog;
+}
+/** A value as console.log would show it, on one line where it can be. */
+export declare function consoleValue(v: unknown): string;
+/**
+ * The text of one console call: format specifiers in a first string
+ * (%s %d %i %f %o %O %j %c %%) take the next arguments, as the browser's
+ * console does, and the rest follow separated by spaces. Cut at
+ * CONSOLE_TEXT_MAX characters, saying how many more there were.
+ */
+export declare function consoleText(args: readonly unknown[]): string;
+//# sourceMappingURL=console.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/console.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const CONSOLE_LEVELS=["log","info","warn","error","debug"];const f={module:0,build:1,mount:2,render:3,cover:4,other:5};export const CONSOLE_LIMIT=200,CONSOLE_TEXT_MAX=4e3;const p=t=>[t.level,t.phase,t.part??"",t.layer??"",t.index??"",t.text].join("\0");export class ConsoleCollector{limit;kept=new Map;droppedCalls=0;constructor(e=CONSOLE_LIMIT){this.limit=Math.max(0,e)}add(e){const r=e.count??1,i=p(e),n=this.kept.get(i);if(n){n.count+=r;const o=[n.t,e.t].filter(s=>s!==void 0),u=[n.until??n.t,e.until??e.t].filter(s=>s!==void 0);if(o.length>0){const s=Math.min(...o),a=Math.max(...u);n.t=s,a>s&&(n.until=a)}return}if(this.kept.size>=this.limit){this.droppedCalls+=r;return}this.kept.set(i,{level:e.level,text:e.text,phase:e.phase,...e.part===void 0?{}:{part:e.part},...e.layer===void 0?{}:{layer:e.layer},...e.index===void 0?{}:{index:e.index},...e.t===void 0?{}:{t:e.t},...e.until!==void 0&&e.t!==void 0&&e.until>e.t?{until:e.until}:{},count:r})}merge(e){for(const r of e.messages)this.add(r);this.droppedCalls+=e.dropped}log(e=[]){const r=new Map(e.map((n,o)=>[n,o]));return{messages:[...this.kept.values()].map((n,o)=>({m:n,i:o})).sort((n,o)=>f[n.m.phase]-f[o.m.phase]||(r.get(n.m.part??"")??-1)-(r.get(o.m.part??"")??-1)||(n.m.t??-1)-(o.m.t??-1)||n.i-o.i).map(({m:n})=>({...n})),dropped:this.droppedCalls}}}function c(t){const e=globalThis.Node;if(!e||!(t instanceof e))return;const r=t;if(r.nodeType===1){const i=[...r.classList??[]].map(n=>`.${n}`).join("");return`<${r.nodeName.toLowerCase()}${i}${r.id?`#${r.id}`:""}>`}return JSON.stringify(r.textContent??"")}function l(t){if(typeof t=="bigint")return`${String(t)}n`;if(typeof t=="function")return`[Function${t.name?` ${t.name}`:""}]`;if(typeof t=="number"&&!Number.isFinite(t))return String(t);if(typeof t!="object"||t===null)return t;if(t instanceof Error)return`${t.name}: ${t.message}`;const e=c(t);return e!==void 0?e:t instanceof Map?{Map:[...t]}:t instanceof Set?{Set:[...t]}:ArrayBuffer.isView(t)&&!(t instanceof DataView)?Array.from(t):t}function d(t){const e=[];try{return JSON.stringify(t,function(r,i){for(;e.length>0&&e[e.length-1]!==this;)e.pop();if(typeof i!="object"||i===null)return l(i);if(e.includes(i))return"[Circular]";e.push(i);const n=l(i);return n!==i&&typeof n=="object"&&n!==null&&e.push(n),n})}catch{return Object.prototype.toString.call(t)}}export function consoleValue(t){switch(typeof t){case"string":return t;case"number":case"boolean":case"undefined":return String(t);case"bigint":return`${String(t)}n`;case"symbol":return t.toString();case"function":return`[Function${t.name?` ${t.name}`:""}]`;case"object":{if(t===null)return"null";if(t instanceof Error)return`${t.name}: ${t.message}`;const e=c(t);return e!==void 0?e:d(t)}}}export function consoleText(t){const e=[...t],r=[],i=e[0];typeof i=="string"&&i.includes("%")&&(e.shift(),r.push(i.replace(/%([sdifoOjc%])/g,(o,u)=>{if(u==="%")return"%";if(e.length===0)return o;const s=e.shift();if(u==="c")return"";if(u==="d"||u==="i"||u==="f"){const a=typeof s=="symbol"?NaN:Number(s);return String(u==="f"?a:Math.trunc(a))}return consoleValue(s)}))),r.push(...e.map(consoleValue));const n=r.join(" ");return n.length<=CONSOLE_TEXT_MAX?n:`${n.slice(0,CONSOLE_TEXT_MAX)}… (${String(n.length-CONSOLE_TEXT_MAX)} more characters)`}

package/node_modules/@allyhub-next/video-core/dist/contrast.d.ts

@@ -0,0 +1,98 @@
+import type { MeasuredText } from "./measure.js";
+import type { Box } from "./problem.js";
+/**
+ * A style sheet that hides every text's fill and nothing else: borders and
+ * icons drawn in `currentColor`, shadows and strokes round letters, and
+ * colour emoji stay. What a capture then has at the glyphs is what is
+ * behind them.
+ */
+export declare const HIDE_TEXT_CSS: string;
+/**
+ * The same, with the strokes and shadows round letters hidden too: what a
+ * capture has at the glyphs is then the picture under a text's outline.
+ */
+export declare const HIDE_OUTLINE_CSS = "*{-webkit-text-fill-color:transparent!important;caret-color:transparent!important;transition:none!important}svg text,svg tspan,svg textPath{fill:transparent!important}*{-webkit-text-stroke-color:transparent!important;text-shadow:none!important}";
+/** A colour in sRGB, channels 0–255, alpha 0–1. */
+export type Rgba = [r: number, g: number, b: number, a: number];
+/** One line of a text block's glyphs, as the stage draws it. */
+export interface InkLine {
+    /** The line's glyph box in the frame's pixels (not rounded; the frame may cut it). */
+    box: Box;
+    /** The colour its glyphs are filled with; absent when the fill is not a colour (transparent: a background clipped to the text). */
+    fill?: Rgba;
+    /** Its text node's opacity, its ancestors' included. */
+    opacity: number;
+}
+/** A text block with what its contrast is measured from (LoadedOutput.inks). */
+export interface TextInk {
+    text: MeasuredText;
+    lines: InkLine[];
+    /** Its font size in the frame's pixels (its transforms' scale counted), and its weight. */
+    size: number;
+    weight: number;
+    /** A text-shadow or a stroke round its letters: drawn with the picture behind its fill, so it counts there. */
+    shadow?: true;
+    stroke?: true;
+}
+/** How the text-contrast fact measures. */
+export interface ContrastOptions {
+    /** The low percentile reported beside the minimum and the median (0–100). */
+    percentile: number;
+    /** The scale the picture behind the text is captured at (0–1 of the frame's pixels). */
+    scale: number;
+    /** Blocks drawn at a lower opacity (fading in or out) are left out (0: every block). */
+    opacity: number;
+}
+/**
+ * The 10th percentile beside the minimum and the median; the picture
+ * behind captured at the frame's own pixels; blocks drawn at 90 % opacity
+ * or more (whole, as text-time counts it).
+ */
+export declare const CONTRAST_DEFAULTS: Readonly<ContrastOptions>;
+/** The options with the defaults filled in, checked. */
+export declare function contrastOptions(o?: Partial<ContrastOptions>): ContrastOptions;
+/** WCAG 2.1 relative luminance of an sRGB colour (0–1). */
+export declare function luminance(r: number, g: number, b: number): number;
+/** WCAG 2.1 contrast ratio of two luminances: 1 (none) to 21 (black on white). */
+export declare function contrastRatio(la: number, lb: number): number;
+/** A colour drawn at `alpha` over an opaque one. */
+export declare function over(fg: readonly [number, number, number], alpha: number, bg: readonly [number, number, number]): [number, number, number];
+/** #rrggbb, with the alpha as two more digits when under 1. */
+export declare function hexOf(c: readonly number[]): string;
+/** A picture's pixels, RGBA, row by row. */
+export interface Pixels {
+    width: number;
+    height: number;
+    data: Uint8Array;
+}
+/** Where a picture lies in the frame: its pixel (0, 0) is at frame (x, y), and each of its pixels spans `scale` frame pixels (2: captured at half size). */
+export interface PixelsAt {
+    x: number;
+    y: number;
+    scale: number;
+}
+/** The ratios over the pixels behind a block's glyphs. */
+export interface ContrastStats {
+    min: number;
+    low: number;
+    median: number;
+    /** Pixels measured. */
+    pixels: number;
+    /** The picture behind, #rrggbb: the median of each channel, and the pixel at the minimum. */
+    background: {
+        median: string;
+        atMin: string;
+    };
+}
+/**
+ * The contrast between each line's fill and every pixel of `behind` inside
+ * that line's glyph box (the box in frame pixels; `at` places the picture
+ * in the frame): the fill drawn at its alpha × opacity over the pixel,
+ * against the pixel. The minimum, the `percentile`th lowest and the
+ * median, and the colours behind. Undefined when no line has a colour or
+ * no pixel of the picture is inside a line's box.
+ */
+export declare function contrastOver(lines: readonly InkLine[], behind: Pixels, at: PixelsAt, percentile: number): ContrastStats | undefined;
+/** The box round a block's lines, whole frame pixels, inside the frame; undefined when none of it is inside. */
+export declare function linesRegion(lines: readonly InkLine[], width: number, height: number): Box | undefined;
+//# sourceMappingURL=contrast.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/contrast.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const HIDE_TEXT_CSS="*{-webkit-text-fill-color:transparent!important;caret-color:transparent!important;transition:none!important}svg text,svg tspan,svg textPath{fill:transparent!important}",HIDE_OUTLINE_CSS=`${HIDE_TEXT_CSS}*{-webkit-text-stroke-color:transparent!important;text-shadow:none!important}`,CONTRAST_DEFAULTS={percentile:10,scale:1,opacity:.9};export function contrastOptions(o={}){const t=(n,r,a)=>{const e=o[n];return e!==void 0&&Number.isFinite(e)&&e>=r&&e<=a?e:CONTRAST_DEFAULTS[n]};return{percentile:t("percentile",0,100),scale:t("scale",.05,1),opacity:t("opacity",0,1)}}const S=o=>{const t=o/255;return t<=.04045?t/12.92:((t+.055)/1.055)**2.4};export function luminance(o,t,n){return .2126*S(o)+.7152*S(t)+.0722*S(n)}export function contrastRatio(o,t){const n=Math.max(o,t),r=Math.min(o,t);return(n+.05)/(r+.05)}export function over(o,t,n){const r=Math.min(1,Math.max(0,t));return[o[0]*r+n[0]*(1-r),o[1]*r+n[1]*(1-r),o[2]*r+n[2]*(1-r)]}const u=o=>Math.round(Math.min(255,Math.max(0,o))).toString(16).padStart(2,"0");export function hexOf(o){const[t=0,n=0,r=0,a=1]=o;return`#${u(t)}${u(n)}${u(r)}${a<1?u(a*255):""}`}const b=o=>Math.round(o*100)/100;export function contrastOver(o,t,n,r){const a=[],e=[],p=[],x=[];let f=1/0,m=[0,0,0];for(const h of o){const s=h.fill;if(!s)continue;const E=s[3]*h.opacity,[v,T,O,_]=h.box,$=Math.max(0,Math.ceil((v-n.x)/n.scale-.5)),k=Math.max(0,Math.ceil((T-n.y)/n.scale-.5)),A=Math.min(t.width-1,Math.floor((v+O-n.x)/n.scale-.5)),F=Math.min(t.height-1,Math.floor((T+_-n.y)/n.scale-.5));for(let y=k;y<=F;y++)for(let d=$;d<=A;d++){const g=(y*t.width+d)*4,c=[t.data[g]??0,t.data[g+1]??0,t.data[g+2]??0],w=over([s[0],s[1],s[2]],E,c),I=contrastRatio(luminance(w[0],w[1],w[2]),luminance(c[0],c[1],c[2]));a.push(I),e.push(c[0]),p.push(c[1]),x.push(c[2]),I<f&&(f=I,m=c)}}if(a.length===0)return;const l=Float64Array.from(a).sort(),i=h=>l[Math.min(l.length-1,Math.floor(h/100*l.length))]??0,M=h=>{const s=Float64Array.from(h).sort();return s[Math.floor(s.length/2)]??0};return{min:b(l[0]??0),low:b(i(r)),median:b(i(50)),pixels:a.length,background:{median:hexOf([M(e),M(p),M(x)]),atMin:hexOf(m)}}}export function linesRegion(o,t,n){let r=1/0,a=1/0,e=-1/0,p=-1/0;for(const{box:i}of o)r=Math.min(r,i[0]),a=Math.min(a,i[1]),e=Math.max(e,i[0]+i[2]),p=Math.max(p,i[1]+i[3]);const x=Math.max(0,Math.floor(r)),f=Math.max(0,Math.floor(a)),m=Math.min(t,Math.ceil(e)),l=Math.min(n,Math.ceil(p));return m>x&&l>f?[x,f,m-x,l-f]:void 0}

package/node_modules/@allyhub-next/video-core/dist/cut-report.d.ts

@@ -0,0 +1,77 @@
+import { type EditList, type EditRange, type EditedSpeech, type KeptRange, type SoundCut } from "./edits.js";
+import type { Word } from "./media.js";
+import { type Join } from "./transcript.js";
+import { type RoomLevel, type VoiceFrames } from "./voice.js";
+export interface CutReportOptions {
+    /** Words [from, to] of the take (default every word). */
+    from?: number;
+    to?: number;
+    /** The frame grid cuts are placed on (default 30). */
+    fps?: number;
+    /** A join's silence is its 10 ms frames under this level, dBFS (default the take's speech/silence threshold). */
+    quiet?: number;
+    /** Seconds of each word next to a cut whose mean level gives the step across a join (default JOIN_NEAR). */
+    near?: number;
+    /** The take's length, seconds (default its last word's end). */
+    duration?: number;
+}
+/** A run of removed words. */
+export interface Removal {
+    from: number;
+    to: number;
+    start: number;
+    end: number;
+    text: string;
+}
+/** The room tone, and how a fill would be matched at each end of what is kept. */
+export interface RoomReport {
+    from: number;
+    to: number;
+    /** The floor of the room tone where a fill plays it, dBFS. */
+    level: number | null;
+    lead: {
+        word: number;
+        pad: number;
+    } & RoomLevel;
+    tail: {
+        word: number;
+        pad: number;
+    } & RoomLevel;
+}
+export interface CutReport {
+    from: number;
+    to: number;
+    fps: number;
+    /** The padding each cut keeps into the silence, seconds. */
+    pad: {
+        before: number;
+        after: number;
+    };
+    /** Whether the pad is the edits file's own. */
+    padGiven: boolean;
+    kept: KeptRange[];
+    removed: Removal[];
+    sounds: SoundCut[];
+    /** Sounds the edits file lists that are not between two kept words here: nothing was cut. */
+    soundsUnused: SoundCut[];
+    inWord: EditedSpeech["inWord"];
+    /** inWord stretches that cut nothing here (outside what is kept, or under 0.04 s once placed). */
+    inWordUnplaced: SoundCut[];
+    pauses: EditedSpeech["pauses"];
+    /** Ranges the take no longer says (AK-T005). */
+    lost: EditRange[];
+    seconds: {
+        before: number;
+        after: number;
+        removed: number;
+    };
+    /** Null without the take's levels, or when it has no steady quiet stretch. */
+    roomTone: RoomReport | null;
+    joins: Join[];
+    /** The level a join's silence is under, dBFS; null without levels. */
+    quietBelow: number | null;
+    near: number;
+}
+/** What an edits file keeps and removes of words [from, to] of a take, and every join. */
+export declare function cutReport(words: readonly Word[], list: EditList, frames: VoiceFrames | undefined, options?: CutReportOptions): CutReport;
+//# sourceMappingURL=cut-report.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/cut-report.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{applyEdits as E,editedLength as P,PAD_AFTER as T,PAD_BEFORE as _,speechPads as j}from"./edits.js";import{JOIN_NEAR as q,joinsOf as x,takeLevels as B}from"./transcript.js";import{matchRoom as g,ROOM_MATCH as v,roomTone as I}from"./voice.js";import{joinWords as y}from"./words.js";const A=o=>Math.round(o*1e3)/1e3;export function cutReport(o,e,a,c={}){const r=Math.max(0,o.length-1),d=Math.min(c.from??0,r),s=Math.min(c.to??r,r),p=c.fps??30,i=c.duration??o.at(-1)?.end??0,n=E(o,e,d,s,{levels:a,fps:p}),m=o[d],u=o[s],l=m&&u?u.end-m.start:0,h=P(n.ranges),M=[];for(const t of n.removed){const f=M.at(-1);f?.to===t-1?f.to=t:M.push({from:t,to:t})}const O=t=>e.maxPause===void 0?t:Math.min(t,e.maxPause/2),k={before:O(e.pad?.before??_),after:O(e.pad?.after??T)},W=M.map(t=>({...t,start:o[t.from]?.start??0,end:o[t.to]?.end??0,text:y(o.slice(t.from,t.to+1))})),R=c.quiet??(a?B(a).threshold:-60),b=c.near??q;return{from:d,to:s,fps:p,pad:k,padGiven:e.pad?.before!==void 0||e.pad?.after!==void 0,kept:n.ranges,removed:W,sounds:n.sounds,soundsUnused:(e.sounds??[]).filter(t=>!n.sounds.some(f=>f.from<t.to&&f.to>t.from)),inWord:n.inWord,inWordUnplaced:(e.inWord??[]).filter(t=>!n.inWord.some(f=>f.from<t.to+.05&&f.to>t.from-.05)),pauses:n.pauses,lost:n.lost,seconds:{before:A(l),after:A(h),removed:A(l-h)},roomTone:a?D(o,n,a,i):null,joins:x(o,n,a,R,b),quietBelow:a?R:null,near:b}}function D(o,e,a,c){const r=I(a),d=e.kept[0],s=e.kept.at(-1);if(!r||d===void 0||s===void 0)return null;const p=j(o,d,s,c,a),i=e.ranges[0]?.from??o[d]?.start??0,n=e.ranges.at(-1)?.to??o[s]?.end??0,m=i>(o[d]?.start??0)+1e-6?0:p.padIn,u=n<(o[s]?.end??0)-1e-6?0:p.padOut,l={from:r.from,to:Math.min(r.to,r.from+v.near)},h=g(a,l,{from:i-m,to:i-m+Math.min(m,v.near)}),M=g(a,l,{from:n+u-Math.min(u,v.near),to:n+u});return{...r,level:h.level,lead:{word:d,pad:m,...h},tail:{word:s,pad:u,...M}}}

package/node_modules/@allyhub-next/video-core/dist/edit.d.ts

@@ -0,0 +1,77 @@
+import { type FormattingOptions, type JSONPath } from "jsonc-parser";
+/** A key's new value; undefined deletes it. */
+export interface KeyEdit {
+    key: string;
+    value?: unknown;
+}
+/** The indentation and line ending the file already uses. */
+export declare function formattingOf(text: string): FormattingOptions;
+/** A value on one line, the way prettier prints it: `["a", "b"]`, `{ "k": 1 }`. */
+export declare function inline(v: unknown): string;
+/**
+ * Sets (or with `undefined` deletes) the value at a path of keys and
+ * indexes of a JSON document; the empty path replaces the whole document.
+ * A new key goes where `insertAt` says among its siblings (default: last).
+ * Lists and objects that were on one line (or are new) stay on one line
+ * when they fit.
+ */
+export declare function editJsonAt(text: string, at: readonly (string | number)[], value: unknown, insertAt?: (props: string[]) => number): string;
+/** The value at a path of a JSON document; undefined when it is not there. */
+export declare function readJsonAt(text: string, path: JSONPath): unknown;
+/**
+ * Applies edits to the top-level keys of a JSON object. A new key goes after
+ * the last key that comes before it in `order` (the default language's
+ * strings, so every language file keeps the same order), else at the end.
+ */
+export declare function editJsonKeys(text: string, edits: readonly KeyEdit[], order?: readonly string[]): string;
+/** A field of a CSV file and where its text is (start inclusive, end exclusive). */
+interface CsvField {
+    value: string;
+    start: number;
+    end: number;
+    quoted: boolean;
+}
+/**
+ * RFC 4180 rows with where each field is, skipping blank lines the way the
+ * build reads CSV (`@allyhub/build`'s parseCsvRows): the first row is the
+ * header.
+ */
+export declare function csvFields(text: string): CsvField[][];
+/** A cell by data row (0 = the first row after the header) and column name. */
+export declare function csvCell(text: string, row: number, column: string): CsvField | undefined;
+/** Replaces one cell's text; quotes it when it must be (or was) quoted. */
+export declare function editCsvCell(text: string, row: number, column: string, value: string): string;
+/** Where an edit is: a messages key, a JSON path, or a CSV cell. */
+export type EditLocation = string | {
+    pointer: (string | number)[];
+} | {
+    row: number;
+    column: string;
+};
+/** null means absent: a key that is not there, a value to delete. */
+export type EditValue = unknown;
+export type EditOutcome = {
+    ok: true;
+    text: string;
+} | {
+    ok: false;
+    reason: "conflict";
+    current: EditValue;
+} | {
+    ok: false;
+    reason: "invalid";
+    message: string;
+};
+/** Which kind of file an edit can change. */
+export declare function editableKind(path: string): "json" | "csv" | undefined;
+/** The value now at a location of a file's text; null when absent. */
+export declare function valueAt(text: string | null, path: string, at: EditLocation): EditValue;
+/**
+ * Applies one edit to a file's text if the value there is still `before`
+ * (if it is, only that value changes; if not, it is a conflict). A file that does not
+ * exist is `null`; it can only gain a JSON value. `after` null deletes a
+ * JSON value (a translation cleared); a CSV cell becomes empty.
+ */
+export declare function applyEdit(text: string | null, path: string, at: EditLocation, before: EditValue, after: EditValue, order?: readonly string[]): EditOutcome;
+export {};
+//# sourceMappingURL=edit.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/edit.js

@@ -0,0 +1,13 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{applyEdits as h,findNodeAtLocation as g,getNodeValue as S,modify as w,parseTree as p}from"jsonc-parser";import{dequal as m}from"dequal/lite";export function formattingOf(n){const o=n.includes(`\r
+`)?`\r
+`:`
+`,e=/\n([ \t]+)"/.exec(n)?.[1]??"  ";return e.startsWith("	")?{insertSpaces:!1,tabSize:1,eol:o}:{insertSpaces:!0,tabSize:e.length,eol:o}}const b=80;export function inline(n){if(Array.isArray(n))return`[${n.map(inline).join(", ")}]`;if(typeof n=="object"&&n!==null){const o=Object.entries(n).map(([e,r])=>`${JSON.stringify(e)}: ${inline(r)}`);return o.length?`{ ${o.join(", ")} }`:"{}"}return JSON.stringify(n)}const y={type:"object",offset:0,length:0};export function editJsonAt(n,o,e,r){const t=formattingOf(n);if(o.length===0){const s=t.insertSpaces?t.tabSize:"	";return`${JSON.stringify(e,null,s)}${t.eol??`
+`}`}const u=[...o];let i=n.trim()===""?`{}
+`:n;const f=g(p(i)??y,u),c=f===void 0||!i.slice(f.offset,f.offset+f.length).includes(`
+`);if(i=h(i,w(i,u,e,{formattingOptions:t,...r?{getInsertionIndex:r}:{}})),e!==null&&typeof e=="object"&&c){const s=g(p(i)??y,u),l=inline(e);if(s){const d=i.lastIndexOf(`
+`,s.offset)+1;s.offset-d+l.length+1<=b&&(i=i.slice(0,s.offset)+l+i.slice(s.offset+s.length))}}return i}export function readJsonAt(n,o){const e=p(n);if(!e)return;const r=g(e,o);return r?S(r):void 0}export function editJsonKeys(n,o,e=[]){let r=n;for(const{key:t,value:u}of o){const i=e.indexOf(t);r=editJsonAt(r,[t],u,f=>{if(i<0)return f.length;let c=f.length,s=-1;return f.forEach((l,d)=>{const a=e.indexOf(l);a>=0&&a<i&&a>s&&(s=a,c=d+1)}),s<0&&f.some(l=>e.indexOf(l)>i)?0:c})}return r}export function csvFields(n){const o=[];let e=[],t=n.startsWith("\uFEFF")?1:0,u=t,i="",f=!1,c=!1;const s=l=>{e.push({value:i,start:u,end:l,quoted:c}),i="",c=!1};for(;t<n.length;t++){const l=n.charAt(t);if(f){l==='"'?n[t+1]==='"'?(i+='"',t++):f=!1:i+=l;continue}l==='"'?(f=!0,c=!0):l===","?(s(t),u=t+1):l===`
+`||l==="\r"?(s(t),o.push(e),e=[],l==="\r"&&n[t+1]===`
+`&&t++,u=t+1):i+=l}return(i!==""||e.length>0||c)&&(s(n.length),o.push(e)),o.filter(l=>l.some(d=>d.value!==""))}export function csvCell(n,o,e){const[r,...t]=csvFields(n),u=r?.findIndex(i=>i.value.trim()===e)??-1;if(!(u<0))return t[o]?.[u]}const $=/[",\r\n]|^\s|\s$/;export function editCsvCell(n,o,e,r){const t=csvCell(n,o,e);if(!t)throw new Error(`There is no cell ${e} in row ${String(o+1)}.`);const u=t.quoted||$.test(r)?`"${r.replace(/"/g,'""')}"`:r;return n.slice(0,t.start)+u+n.slice(t.end)}export function editableKind(n){if(/\.json$/i.test(n))return"json";if(/\.csv$/i.test(n))return"csv"}export function valueAt(n,o,e){if(n===null)return null;if(editableKind(o)==="csv")return typeof e!="object"||!("row"in e)?null:csvCell(n,e.row,e.column)?.value??null;const t=typeof e=="string"?[e]:"pointer"in e?e.pointer:void 0;return t?readJsonAt(n,t)??null:null}export function applyEdit(n,o,e,r,t,u=[]){const i=editableKind(o);if(!i)return{ok:!1,reason:"invalid",message:`${o} cannot be edited in the preview: only messages and JSON or CSV data files can.`};const f=valueAt(n,o,e);if(!m(f,r??null))return{ok:!1,reason:"conflict",current:f};if(m(f,t??null))return{ok:!0,text:n??""};if(i==="csv")return typeof e!="object"||!("row"in e)?{ok:!1,reason:"invalid",message:"An edit to a CSV file needs { row, column }."}:n===null||t!==null&&typeof t!="string"?{ok:!1,reason:"invalid",message:"A CSV cell can only be text."}:csvCell(n,e.row,e.column)?{ok:!0,text:editCsvCell(n,e.row,e.column,t??"")}:{ok:!1,reason:"invalid",message:`${o} has no cell ${e.column} in row ${String(e.row+1)}.`};if(typeof e=="object"&&"row"in e)return{ok:!1,reason:"invalid",message:"An edit to a JSON file needs a key or { pointer }."};if(n!==null&&p(n)?.type!=="object")return{ok:!1,reason:"invalid",message:`${o} is not a JSON object.`};const c=t===null?void 0:t,s=typeof e=="string"?editJsonKeys(n??"",[{key:e,value:c}],u):editJsonAt(n??"",e.pointer,c);return{ok:!0,text:n===null&&!s.endsWith(`
+`)?`${s}
+`:s}}

package/node_modules/@allyhub-next/video-core/dist/edits.d.ts

@@ -0,0 +1,163 @@
+import type { Word } from "./media.js";
+import { type VoiceFrames } from "./voice.js";
+import { WordStream } from "./words.js";
+/** Words removed: indices into the take's words file, inclusive, with their text. */
+export interface EditRange {
+    from: number;
+    to: number;
+    /**
+     * The removed words as text: when the words file changes (transcribed
+     * again), the range is found again by its text, nearest its old place.
+     */
+    text?: string;
+}
+/** A sound removed: its stretch of the take's file, seconds (from `allyhub words`). */
+export interface SoundCut {
+    from: number;
+    to: number;
+}
+/** An edits file: `edits/<name>.json`. */
+export interface EditList {
+    /** Ranges of words to remove. */
+    remove?: EditRange[];
+    /**
+     * Sounds between words to remove, by their stretch of the file. A cut
+     * never reaches into a kept word, whatever the stretch says.
+     */
+    sounds?: SoundCut[];
+    /**
+     * Stretches of the file to remove even inside a kept word: a sound
+     * attached to a word with no silence between ("so-um"), which `sounds`
+     * would never reach. Cut as listed: each end moves only to the quietest
+     * 10 ms within 40 ms. Nothing finds these: `allyhub words` measures
+     * the words, the choice is the agent's.
+     */
+    inWord?: SoundCut[];
+    /** Pauses between kept words longer than this many seconds are shortened to it. */
+    maxPause?: number;
+    /**
+     * Seconds of silence kept beside each cut: `before` it, after the last
+     * kept word (default PAD_BEFORE, 0.12), and `after` it, before the next
+     * kept word (default PAD_AFTER, 0.08). Never past half the silence.
+     */
+    pad?: CutPad;
+}
+/** Seconds of silence kept on each side of a cut (EditList.pad). */
+export interface CutPad {
+    before?: number;
+    after?: number;
+}
+/** A kept stretch of the take's file, in its seconds. */
+export interface KeptRange {
+    from: number;
+    to: number;
+}
+export interface EditedSpeech {
+    /** Kept stretches of the file, in order, from the first kept word's start to the last one's end. */
+    ranges: KeptRange[];
+    /** The kept words on the edited clock: 0 at the first kept word's start. */
+    words: Word[];
+    /** Indices (in the words file) of the kept words. */
+    kept: number[];
+    /** Indices of removed words. */
+    removed: number[];
+    /** Sounds removed inside the stretch, clamped to the silence between kept words. */
+    sounds: SoundCut[];
+    /**
+     * Stretches cut inside kept speech (`inWord`), as placed, with the kept
+     * words each one cuts into.
+     */
+    inWord: (SoundCut & {
+        words: number[];
+    })[];
+    /** Pauses shortened: after word index `after`, from `was` seconds to `now`. */
+    pauses: {
+        after: number;
+        was: number;
+        now: number;
+    }[];
+    /** Edit ranges whose words are no longer in the take (AK-T005). */
+    lost: EditRange[];
+}
+/**
+ * Seconds kept into the silence beside a cut when the edits file does not
+ * say (`pad`): before the cut (after the word before it), and after it
+ * (before the word after it).
+ */
+export declare const PAD_BEFORE = 0.12;
+export declare const PAD_AFTER = 0.08;
+/**
+ * Checks a parsed edits file; returns the edit list, or what is wrong with
+ * it (one line).
+ */
+export declare function parseEditList(v: unknown): EditList | string;
+/** The text of words [from, to], as an edit range keeps it. */
+export declare function rangeText(words: readonly Word[], from: number, to: number): string;
+/**
+ * Where an edit range's words are now: the same indices when their text
+ * still matches, else the occurrence of its text nearest its old place;
+ * undefined when the take no longer says it.
+ */
+export declare function locateRange(words: readonly Word[], r: EditRange, stream?: WordStream): {
+    from: number;
+    to: number;
+} | undefined;
+/**
+ * The words an edit list removes (indices into the take's words file, each
+ * range found again by its text when the file changed), and the ranges the
+ * take no longer says.
+ */
+export declare function removedWords(words: readonly Word[], edits: EditList | undefined, stream?: WordStream): {
+    cut: Set<number>;
+    lost: EditRange[];
+};
+/** The take's level per 10 ms, which cut points snap to. */
+export type CutLevels = Pick<VoiceFrames, "db" | "hop">;
+/**
+ * A cut point near `target`, inside [lo, hi]: the quietest 10 ms within
+ * SNAP of it when the levels are known, else the target.
+ */
+export declare function snapCut(levels: CutLevels | undefined, target: number, lo: number, hi: number): number;
+/**
+ * The take's own sound a part keeps around words [first, last]: before the
+ * first and after the last, into the silence there (never past half of it,
+ * so never into a neighbouring word; up to half a second before, 0.6 s
+ * after), each end at its quietest 10 ms nearby when the levels are known.
+ * A recognizer's word times clip consonants, and a part's lead and tail
+ * play the take's own room rather than digital silence. Seconds.
+ */
+export declare function speechPads(words: readonly Word[], first: number, last: number, duration: number | undefined, levels?: CutLevels): {
+    padIn: number;
+    padOut: number;
+};
+/** How cuts are placed: the take's level per 10 ms and the film's frame rate. */
+export interface CutOptions {
+    /** Moves each cut point to the quietest moment near it (voice.ts). */
+    levels?: CutLevels | undefined;
+    /**
+     * Moves each cut point onto this frame grid, outward into the kept
+     * stretch's silence, never into what is removed: picture cuts land on
+     * whole frames.
+     */
+    fps?: number | undefined;
+}
+/**
+ * Applies an edit list to words [first, last] of a take, exactly as
+ * listed. Without edits (or with nothing to remove) the result is one
+ * stretch from the first word's start to the last one's end.
+ */
+export declare function applyEdits(words: readonly Word[], edits: EditList | undefined, first?: number, last?: number, opts?: CutOptions): EditedSpeech;
+/** Seconds of the edited take: the kept stretches' lengths added up. */
+export declare function editedLength(ranges: readonly KeptRange[]): number;
+/**
+ * A moment of the file on the edited clock (0 at the first stretch's
+ * start). A moment inside a cut lands where the cut is; before the first
+ * stretch or after the last, the clock runs on.
+ */
+export declare function toEdited(ranges: readonly KeptRange[], t: number): number;
+/**
+ * The file's moment at a moment of the edited clock: inside a stretch;
+ * before the first or after the last, the file runs on from its edge.
+ */
+export declare function fromEdited(ranges: readonly KeptRange[], e: number): number;
+//# sourceMappingURL=edits.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/edits.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{PAD_MAX as X}from"@allyhub-next/formats";import{quietest as Y}from"./voice.js";import{joinWords as Z,normText as w,WordStream as z}from"./words.js";export const PAD_BEFORE=.12,PAD_AFTER=.08;const $=.04,R=.04,A=e=>Math.round(e*1e3)/1e3,T=e=>typeof e=="number"&&Number.isFinite(e)&&e>=0;export function parseEditList(e){if(typeof e!="object"||e===null||Array.isArray(e))return"an edits file is a JSON object: { version: 1, remove, sounds, inWord, maxPause, pad }";const t=e;if(t.version!==1)return"version is 1";for(const o of["take","$schema"])if(t[o]!==void 0&&typeof t[o]!="string")return`${o} is a string`;const s=Object.keys(t).filter(o=>!["version","remove","sounds","inWord","maxPause","pad","take","$schema"].includes(o));if(s.length>0)return`unknown field${s.length>1?"s":""} ${s.join(", ")} (an edits file has version, remove, sounds, inWord, maxPause, pad and take)`;const f={};if(t.remove!==void 0){if(!Array.isArray(t.remove))return"remove is a list of { from, to, text }";const o=[];for(const[i,k]of t.remove.entries()){const u=k,M=u?.from,m=u?.to,p=u?.text;if(typeof M!="number"||typeof m!="number"||!Number.isInteger(M)||!Number.isInteger(m)||M<0||m<M||p!==void 0&&typeof p!="string")return`remove[${String(i)}] is not { from, to, text } with word indices from ≤ to`;o.push({from:M,to:m,...p===void 0?{}:{text:p}})}f.remove=o}for(const o of["sounds","inWord"]){if(t[o]===void 0)continue;if(!Array.isArray(t[o]))return`${o} is a list of { from, to } in seconds of the take`;const i=[];for(const[k,u]of t[o].entries()){const M=u,m=M?.from,p=M?.to;if(!T(m)||!T(p)||p<=m)return`${o}[${String(k)}] is not { from, to } in seconds with from < to`;i.push({from:m,to:p})}f[o]=i}const a=t.maxPause;if(a!==void 0){if(typeof a!="number"||!Number.isFinite(a)||a<.05||a>10)return"maxPause is seconds, from 0.05 to 10";f.maxPause=a}const r=t.pad;if(r!==void 0){const o=r,i=typeof r=="object"&&o!==null&&!Array.isArray(r),k=i?Object.keys(o).filter(p=>p!=="before"&&p!=="after"):[],u=p=>p===void 0||T(p)&&p<=X;if(!i||k.length>0||!u(o.before)||!u(o.after))return`pad is { before, after }: seconds of silence kept before and after each cut, each from 0 to ${String(X)}`;const M=o.before,m=o.after;f.pad={...M===void 0?{}:{before:M},...m===void 0?{}:{after:m}}}return f}export function rangeText(e,t,s){return Z(e.slice(t,s+1))}export function locateRange(e,t,s=new z(e)){const f=t.from>=0&&t.to<e.length&&t.to>=t.from;if(t.text===void 0)return f?{from:t.from,to:t.to}:void 0;const a=w(t.text);if(a==="")return f?{from:t.from,to:t.to}:void 0;if(f&&w(rangeText(e,t.from,t.to))===a)return{from:t.from,to:t.to};let r;for(let o=1;;o++){const i=s.span(a,0,e.length-1,o);if(!i)break;w(rangeText(e,i.first,i.last))===a&&(!r||Math.abs(i.first-t.from)<Math.abs(r.from-t.from))&&(r={from:i.first,to:i.last})}return r}export function removedWords(e,t,s=new z(e)){const f=new Set,a=[];for(const r of t?.remove??[]){const o=locateRange(e,r,s);if(!o){a.push(r);continue}for(let i=o.from;i<=o.to;i++)f.add(i)}return{cut:f,lost:a}}export function snapCut(e,t,s,f){const a=Math.min(Math.max(t,s),f);return e?Y(e,a,Math.max(s,a-$),Math.min(f,a+$)):a}const tt=.5,ot=.6;export function speechPads(e,t,s,f,a){const r=e[t],o=e[s]??r;if(!r||!o)return{padIn:0,padOut:0};const i=r.start,k=e[t-1]?.end??0,u=e[s+1]?.start??f??o.end+.4,M=Math.max(0,Math.min((i-k)/2,i)),m=Math.max(0,(u-o.end)/2),p=snapCut(a,i-Math.min(tt,M),i-M,i),g=snapCut(a,o.end+Math.min(ot,m),o.end,o.end+m);return{padIn:A(Math.max(0,i-p)),padOut:A(Math.max(0,g-o.end))}}export function applyEdits(e,t,s=0,f=e.length-1,a={}){const{levels:r,fps:o}=a,{cut:i,lost:k}=removedWords(e,t),u=[];for(let n=s;n<=f;n++)i.has(n)||u.push(n);const M=[...i].filter(n=>n>=s&&n<=f).sort((n,c)=>n-c),m=t?.maxPause,p=[],g=[],y=n=>e[n]??{text:"",start:0,end:0};if(u.length===0)return{ranges:[],words:[],kept:u,removed:M,sounds:[],inWord:[],pauses:p,lost:k};const _=[],j=new Map;for(const n of t?.sounds??[])for(let c=0;c<u.length-1;c++){const h=y(u[c]??0),l=y(u[c+1]??0),b=Math.max(n.from,h.end),x=Math.min(n.to,l.start);if(x-b<.01)continue;const d=j.get(c)??[];d.push({start:b,end:x}),j.set(c,d),_.push({from:A(b),to:A(x)})}const F=y(u[0]??0);let O=F.start,W=F.start;const B=t?.pad?.before??PAD_BEFORE,C=t?.pad?.after??PAD_AFTER,H=m===void 0?B:Math.min(B,m/2),K=m===void 0?C:Math.min(C,m/2);for(let n=0;n<u.length-1;n++){const c=u[n]??0,h=u[n+1]??0,l=y(c),b=y(h),x=[];for(let v=c+1;v<h;v++)x.push({start:y(v).start,end:y(v).end});x.push(...j.get(n)??[]),x.sort((v,P)=>v.start-P.start);const d=x[0],N=x.at(-1);if(!d||!N){const v=b.start-l.end;if(m!==void 0&&v>m){const P=snapCut(r,l.end+m/2,l.end,b.start),S=snapCut(r,b.start-m/2,P,b.start);S-P>=R&&(p.push({after:c,was:A(v),now:m}),g.push({from:O,to:P,lo:W,hi:S}),O=S,W=P)}continue}const J=Math.max(0,d.start-l.end),q=Math.max(0,b.start-N.end),U=snapCut(r,l.end+Math.min(H,J/2),l.end,l.end+J/2),V=snapCut(r,b.start-Math.min(K,q/2),b.start-q/2,b.start);g.push({from:O,to:U,lo:W,hi:d.start}),O=Math.max(V,U),W=Math.min(O,N.end)}const D=y(u.at(-1)??0);g.push({from:O,to:D.end,lo:W,hi:D.end});const L=[];for(const n of t?.inWord??[]){const c=(n.from+n.to)/2,h=snapCut(r,n.from,n.from-$,c),l=snapCut(r,n.to,c,n.to+$);if(l-h<R)continue;let b=!1;for(let x=0;x<g.length;x++){const d=g[x];!d||h>=d.to||l<=d.from||(b=!0,h>d.from&&l<d.to?(g.splice(x,1,{from:d.from,to:h,lo:d.lo,hi:h},{from:l,to:d.to,lo:l,hi:d.hi}),x++):h<=d.from&&l>=d.to?(g.splice(x,1),x--):h<=d.from?(d.from=l,d.lo=l):(d.to=h,d.hi=h))}b&&L.push({from:A(h),to:A(l),words:u.filter(x=>y(x).start<l&&y(x).end>h)})}o!==void 0&&o>0&&g.forEach((n,c)=>{if(c>0){const h=Math.floor(n.from*o+1e-6)/o;h>=n.lo-1e-9&&(n.from=h)}if(c<g.length-1){const h=Math.ceil(n.to*o-1e-6)/o;h<=n.hi+1e-9&&(n.to=h)}});const E=[];for(const n of g){const c=E.at(-1);c&&n.from-c.to<R?c.to=Math.max(c.to,n.to):E.push({from:n.from,to:n.to})}const I=E.map(n=>({from:A(n.from),to:A(n.to)})),Q=editedLength(I),G=n=>A(Math.min(Q,Math.max(0,toEdited(I,n))));return{ranges:I,words:u.map(n=>{const c=y(n);return{text:c.text,start:G(c.start),end:G(c.end)}}),kept:u,removed:M,sounds:_,inWord:L,pauses:p,lost:k}}export function editedLength(e){return e.reduce((t,s)=>t+(s.to-s.from),0)}export function toEdited(e,t){let s=0;const f=e[0];if(!f)return t;if(t<=f.from)return t-f.from;for(const r of e){if(t<r.from)return s;if(t<=r.to)return s+(t-r.from);s+=r.to-r.from}const a=e.at(-1)??f;return s+(t-a.to)}export function fromEdited(e,t){const s=e[0];if(!s)return t;if(t<=0)return s.from+t;let f=0;for(const r of e){const o=r.to-r.from;if(t<f+o)return r.from+(t-f);f+=o}return(e.at(-1)??s).to+(t-f)}