allyhub 0.4.0 → 0.6.0

package/dist/node_modules/@allyhub-next/chart/dist/chart.d.ts

@@ -0,0 +1,195 @@
+import type { ChartLegendPosition, SheetChartType, ThemeColor } from "@allyhub-next/formats";
+/** A colour: the theme's, or `#RRGGBB`. */
+export type Color = ThemeColor | {
+    rgb: string;
+};
+/** The kinds a chart is drawn as: a slide's and a sheet's (which adds scatter). */
+export type ChartKind = SheetChartType;
+/** Where a data label sits (`c:dLblPos`). */
+export type ChartLabelPosition = "outEnd" | "inEnd" | "ctr" | "inBase" | "t" | "b" | "l" | "r" | "bestFit";
+export interface ChartSeriesDef {
+    name: string;
+    /** One per category; null where there is none. */
+    values: (number | null)[];
+    /** A scatter's: each point's place across, beside `values`. */
+    x?: (number | null)[];
+    /** Its values' format in the workbook (Excel's). */
+    number_format?: string;
+    /** Its colour; default the theme's accents, in turn. */
+    color?: Color;
+    /** A line's curve. */
+    smooth?: boolean;
+    /** A line's width in points. */
+    line_width?: number;
+    /** A marker's size in points. */
+    marker_size?: number;
+}
+export interface ChartAxisDef {
+    minimum_scale?: number;
+    maximum_scale?: number;
+    major_unit?: number;
+    has_major_gridlines?: boolean;
+    visible?: boolean;
+    /** Its tick labels' format (Excel's). */
+    number_format?: string;
+    /** Last category first. */
+    reverse_order?: boolean;
+    /** Its gridlines' colour. */
+    gridline_color?: Color;
+    /** Its line's colour. */
+    line_color?: Color;
+    /** Its title (`c:title`). */
+    title?: string;
+}
+export interface ChartLabelsDef {
+    show_value?: boolean;
+    show_percentage?: boolean;
+    show_category_name?: boolean;
+    show_series_name?: boolean;
+    number_format?: string;
+    position?: ChartLabelPosition;
+    /** Points. */
+    size?: number;
+    color?: Color;
+}
+/** A chart (`c:chartSpace`). */
+export interface ChartDef {
+    type: ChartKind;
+    categories: string[];
+    series: ChartSeriesDef[];
+    title?: string;
+    /** Where its legend is; absent: it has none. */
+    legend?: ChartLegendPosition;
+    /** Its data labels; absent: it has none. */
+    labels?: ChartLabelsDef;
+    /** Between bars' groups, as a share of a bar's width, in %. */
+    gap_width?: number;
+    /** Of one bar over the next, in %, from -100 to 100. */
+    overlap?: number;
+    /** A colour per category, as a pie has by default. */
+    vary_by_categories?: boolean;
+    /** A doughnut's hole, in % of its size. */
+    hole_size?: number;
+    value_axis?: ChartAxisDef;
+    category_axis?: ChartAxisDef;
+    /** Its text's size in points. */
+    font_size?: number;
+    /** Its title's size in points. */
+    title_size?: number;
+    font_color?: Color;
+    /** The project file its numbers came from. */
+    source?: string;
+}
+/** What a chart is drawn with unless it says otherwise. */
+export declare const CHART_DEFAULTS: {
+    /** Points. */
+    readonly fontSize: 12;
+    /** A title's size over the chart's text. */
+    readonly titleScale: 1.2;
+    readonly gapWidth: 150;
+    readonly holeSize: 50;
+    /** Space round the chart, points. */
+    readonly margin: 6;
+    readonly gridline: "#D9D9D9";
+    readonly axisLine: "#BFBFBF";
+    /** A share of a letter's size: how wide a letter is taken to be. */
+    readonly letter: 0.55;
+    /** Line widths, points. */
+    readonly lineWidth: 2.25;
+    readonly gridWidth: 0.75;
+    /** A marker's size, points. */
+    readonly marker: 5;
+};
+export declare const accentOf: (i: number) => Color;
+export declare const isBar: (t: ChartKind) => boolean;
+export declare const isHorizontal: (t: ChartKind) => boolean;
+export declare const isLine: (t: ChartKind) => boolean;
+export declare const isArea: (t: ChartKind) => boolean;
+export declare const isRound: (t: ChartKind) => t is "pie" | "doughnut";
+export declare const isScatter: (t: ChartKind) => boolean;
+/** Whether its points are joined. */
+export declare const hasLines: (t: ChartKind) => boolean;
+export declare const hasMarkers: (t: ChartKind) => t is "line-markers" | "scatter" | "scatter-lines";
+export declare const groupingOf: (t: ChartKind) => "clustered" | "stacked" | "percentStacked" | "standard";
+/**
+ * Where each kind of chart can have its labels: PowerPoint repairs a file
+ * that names any other (a stacked bar's outside end), and an area or a
+ * doughnut names none.
+ */
+export declare function labelPositionsOf(t: ChartKind): readonly ChartLabelPosition[];
+/** Where a chart's labels are: where it says if its kind can, else where this one draws them. */
+export declare function labelPositionOf(c: Pick<ChartDef, "type" | "labels">): ChartLabelPosition | undefined;
+/** Whether each category has its own colour. */
+export declare const variesOf: (c: Pick<ChartDef, "type" | "vary_by_categories">) => boolean;
+/** A number as an Excel format shows it. */
+export declare function formatValue(value: number, code?: string): string;
+export interface ChartScale {
+    min: number;
+    max: number;
+    major: number;
+    ticks: number[];
+}
+/**
+ * A value axis from the values it shows, as Excel's automatic one: zero is on
+ * it unless the values are close together, a step of 1, 2 or 5 of a power of
+ * ten that gives its length at least `room` per step, and 5 % of head room.
+ */
+export declare function chartScale(low: number, high: number, length: number, room: number, axis?: ChartAxisDef): ChartScale;
+export interface ChartBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    color: Color;
+    series: number;
+    category: number;
+}
+export interface ChartStroke {
+    /** An SVG path. */
+    d: string;
+    color: Color;
+    width: number;
+    fill?: Color;
+    series?: number;
+    category?: number;
+}
+export interface ChartDot {
+    x: number;
+    y: number;
+    r: number;
+    color: Color;
+}
+export interface ChartWord {
+    /** Where it is anchored: its left, middle or right, at its vertical middle. */
+    x: number;
+    y: number;
+    text: string;
+    size: number;
+    anchor: "start" | "middle" | "end";
+    color: Color;
+    /** Turned, in degrees: an axis's title beside it. */
+    rotate?: number;
+}
+/** A chart as drawn, in points in its frame, back to front. */
+export interface ChartDrawing {
+    grid: ChartStroke[];
+    /** Filled areas, bars and slices. */
+    shapes: ChartStroke[];
+    boxes: ChartBox[];
+    lines: ChartStroke[];
+    axes: ChartStroke[];
+    dots: ChartDot[];
+    /** Swatches of the legend. */
+    keys: ChartBox[];
+    words: ChartWord[];
+    /** Where the plot is. */
+    plot: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/** A chart laid out in a frame of `width` × `height` points. */
+export declare function chartDrawing(c: ChartDef, width: number, height: number): ChartDrawing;
+//# sourceMappingURL=chart.d.ts.map

package/dist/node_modules/@allyhub-next/chart/dist/chart.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{format as Lt,isValidFormat as jt}from"numfmt";export const CHART_DEFAULTS={fontSize:12,titleScale:1.2,gapWidth:150,holeSize:50,margin:6,gridline:"#D9D9D9",axisLine:"#BFBFBF",letter:.55,lineWidth:2.25,gridWidth:.75,marker:5};const bt=["accent1","accent2","accent3","accent4","accent5","accent6"];export const accentOf=t=>bt[t%bt.length]??"accent1",isBar=t=>t.startsWith("column")||t.startsWith("bar"),isHorizontal=t=>t.startsWith("bar"),isLine=t=>t.startsWith("line"),isArea=t=>t.startsWith("area"),isRound=t=>t==="pie"||t==="doughnut",isScatter=t=>t.startsWith("scatter"),hasLines=t=>!isScatter(t)||t!=="scatter",hasMarkers=t=>t==="line-markers"||t==="scatter"||t==="scatter-lines",groupingOf=t=>t.endsWith("-100")?"percentStacked":t.endsWith("-stacked")?"stacked":isBar(t)?"clustered":"standard";export function labelPositionsOf(t){return isArea(t)||t==="doughnut"?[]:t==="pie"?["bestFit","outEnd","inEnd","ctr"]:isLine(t)||isScatter(t)?["t","b","l","r","ctr"]:groupingOf(t)==="clustered"?["outEnd","inEnd","ctr","inBase"]:["inEnd","ctr","inBase"]}export function labelPositionOf(t){const a=labelPositionsOf(t.type),l=t.labels?.position;if(l!==void 0&&a.includes(l))return l;if(a.length!==0)return t.type==="pie"?"ctr":isLine(t.type)||isScatter(t.type)?"t":groupingOf(t.type)==="clustered"?"outEnd":"ctr"}export const variesOf=t=>t.vary_by_categories??isRound(t.type);export function formatValue(t,a="General"){return a==="General"||!jt(a)?String(Number(t.toPrecision(10))):Lt(a,t)}const Ct=[1,2,5,10];export function chartScale(t,a,l,s,e={}){const h=t>0&&(a-t)/a<.16666666666666666?t:Math.min(t,0),i=a<=0&&t<0?0:a,o=e.minimum_scale??h,C=e.maximum_scale??i,_=C>o?C-o:1,F=Math.max(1,Math.floor(l/s)),b=_/F,P=10**Math.floor(Math.log10(b)),B=e.major_unit??(Ct.find(E=>E*P>=b)??10)*P,N=(E,L)=>Number((L(Number((E/B).toFixed(9)))*B).toPrecision(12)),Z=i>0?i+_*.05:i===h?_:i,g=e.maximum_scale??N(Z,Math.ceil),R=h<0?h-_*.05:h,W=e.minimum_scale??N(R,Math.floor),O=[],x=Math.round((g-W)/B);for(let E=0;E<=x;E++)O.push(Number((W+E*B).toPrecision(12)));return{min:W,max:g,major:B,ticks:O}}const it=(t,a)=>{let l=0;for(const s of t)l+=(s.codePointAt(0)??0)>11903?1:CHART_DEFAULTS.letter;return l*a},d=t=>String(Number(t.toFixed(3)));function $t(t){const a=l=>t[Math.max(0,Math.min(t.length-1,l))]??[0,0];return t.map(([l,s],e)=>{if(e===0)return`M${d(l)} ${d(s)}`;const[h,i]=a(e-2),[o,C]=a(e-1),[_,F]=a(e+1),b=`${d(o+(l-h)/6)} ${d(C+(s-i)/6)}`,P=`${d(l-(_-o)/6)} ${d(s-(F-C)/6)}`;return`C${b} ${P} ${d(l)} ${d(s)}`}).join(" ")}const lt=t=>t.map(([a,l],s)=>`${s===0?"M":"L"}${d(a)} ${d(l)}`).join(" ");function Ft(t,a,l,s,e,h){const i=(F,b)=>`${d(t+F*Math.sin(b))} ${d(a-F*Math.cos(b))}`,o=h-e>=Math.PI*2?e+Math.PI*2-1e-4:h,C=o-e>Math.PI?1:0,_=`M${i(l,e)} A${d(l)} ${d(l)} 0 ${String(C)} 1 ${i(l,o)}`;return s<=0?`${_} L${d(t)} ${d(a)} Z`:`${_} L${i(s,o)} A${d(s)} ${d(s)} 0 ${String(C)} 0 ${i(s,e)} Z`}function vt(t,a,l,s){const e=s*1.5;return a!==void 0&&a!==""&&(t.bottom-=e),l!==void 0&&l!==""&&(t.left+=e),{x:t.left-e/2,y:t.bottom+e/2}}function kt(t,a,l,s,e,h,i){s!==void 0&&s!==""&&t.words.push({x:a.x+a.width/2,y:l.y,text:s,size:h,anchor:"middle",color:i}),e!==void 0&&e!==""&&t.words.push({x:l.x,y:a.y+a.height/2,text:e,size:h,anchor:"middle",color:i,rotate:-90})}const ht=(t,a,l,s,e)=>{const h=t.labels;if(!h)return"";const i=isRound(t.type),o=[];return h.show_series_name&&o.push(s.name),h.show_category_name&&o.push(e),(h.show_value??!(h.show_percentage??!1))&&o.push(formatValue(a,h.number_format??s.number_format)),h.show_percentage&&i&&o.push(formatValue(l,h.number_format??"0%")),o.join(", ")};function Bt(t,a,l,s,e){const h=CHART_DEFAULTS,i=t.category_axis??{},o=t.value_axis??{},C=vt(l,i.title,o.title,s),_=t.series.map(c=>c.values.flatMap(($,H)=>{const I=c.x?.[H]??(c.x?null:H+1);return I===null||$===null?[]:[[I,$]]})),F=_.flat().map(c=>c[0]),b=_.flat().map(c=>c[1]),P=c=>c.length>0?Math.min(...c):0,B=c=>c.length>0?Math.max(...c):1,N=o.number_format??t.series[0]?.number_format??"General",Z=i.number_format??"General",g=s*.5,R=chartScale(P(b),B(b),l.bottom-l.top,s*2.4,o),W=o.visible===!1?0:Math.max(0,...R.ticks.map(c=>it(formatValue(c,N),s)))+g,O=i.visible===!1?0:s*1.2+g,x={x:l.left+W,y:l.top,width:l.right-l.left-W,height:l.bottom-l.top-O};a.plot=x,kt(a,x,C,i.title,o.title,s,e);const E=chartScale(P(F),B(F),x.width,s*5,i),L=chartScale(P(b),B(b),x.height,s*2.4,o),z=c=>x.x+(Math.min(E.max,Math.max(E.min,c))-E.min)/(E.max-E.min)*x.width,D=c=>x.y+x.height-(Math.min(L.max,Math.max(L.min,c))-L.min)/(L.max-L.min)*x.height;for(const c of L.ticks){const $=D(c);(o.has_major_gridlines??!0)&&a.grid.push({d:`M${d(x.x)} ${d($)} H${d(x.x+x.width)}`,color:o.gridline_color??{rgb:h.gridline},width:h.gridWidth}),o.visible!==!1&&a.words.push({x:x.x-g,y:$,text:formatValue(c,N),size:s,anchor:"end",color:e})}for(const c of E.ticks){const $=z(c);i.has_major_gridlines===!0&&a.grid.push({d:`M${d($)} ${d(x.y)} V${d(x.y+x.height)}`,color:i.gridline_color??{rgb:h.gridline},width:h.gridWidth}),i.visible!==!1&&a.words.push({x:$,y:x.y+x.height+g+s*.6,text:formatValue(c,Z),size:s,anchor:"middle",color:e})}a.axes.push({d:`M${d(x.x)} ${d(D(Math.max(L.min,Math.min(L.max,0))))} H${d(x.x+x.width)}`,color:i.line_color??{rgb:h.axisLine},width:h.gridWidth}),t.series.forEach((c,$)=>{const H=c.color??accentOf($),I=(_[$]??[]).map(([U,Y])=>[z(U),D(Y)]);if(I.length!==0&&(hasLines(t.type)&&a.lines.push({d:t.type==="scatter-smooth"||c.smooth===!0?$t(I):lt(I),color:H,width:c.line_width??h.lineWidth,series:$}),hasMarkers(t.type)))for(const[U,Y]of I)a.dots.push({x:U,y:Y,r:(c.marker_size??h.marker)/2,color:H})})}export function chartDrawing(t,a,l){const s=CHART_DEFAULTS,e=t.font_size??s.fontSize,h=t.font_color??"dk1",i={grid:[],shapes:[],boxes:[],lines:[],axes:[],dots:[],keys:[],words:[],plot:{x:0,y:0,width:0,height:0}},o={left:s.margin,top:s.margin,right:a-s.margin,bottom:l-s.margin};if(t.title!==void 0&&t.title!==""){const n=t.title_size??e*s.titleScale;i.words.push({x:a/2,y:o.top+n*.7,text:t.title,size:n,anchor:"middle",color:h}),o.top+=n*1.6}const C=isRound(t.type),_=variesOf(t),F=(n,m)=>_?accentOf(m):t.series[n]?.color??accentOf(n);if(t.legend!==void 0){const n=_?t.categories:t.series.map(p=>p.name),m=e*.6,f=e*.4,r=e*1.5,y=n.map(p=>m+f+it(p,e)),S=(p,M,w)=>{i.keys.push({x:M,y:w-m/2,width:m,height:m,color:_?accentOf(p):t.series[p]?.color??accentOf(p),series:_?0:p,category:_?p:0}),i.words.push({x:M+m+f,y:w,text:n[p]??"",size:e,anchor:"start",color:h})};if(t.legend==="top"||t.legend==="bottom"){const p=y.reduce((A,v)=>A+v,0)+e*(n.length-1),M=t.legend==="top"?o.top+r/2:o.bottom-r/2;let w=(a-p)/2;n.forEach((A,v)=>{S(v,w,M),w+=(y[v]??0)+e}),t.legend==="top"?o.top+=r:o.bottom-=r}else{const p=Math.max(0,...y),M=t.legend==="left"?o.left:o.right-p,w=(o.top+o.bottom-r*n.length)/2+r/2;n.forEach((A,v)=>{S(v,M,w+v*r)}),t.legend==="left"?o.left+=p+e:o.right-=p+e}}const b=t.labels,P=b?.size??e,B=b?.color??h,N=(n,m,f,r,y=B)=>{f!==""&&i.words.push({x:n,y:m,text:f,size:P,anchor:r,color:y})};if(C){const n=t.series[0],m=(n?.values??[]).map(w=>Math.max(0,w??0)),f=m.reduce((w,A)=>w+A,0),r=Math.max(0,Math.min(o.right-o.left,o.bottom-o.top)/2),y=(o.left+o.right)/2,S=(o.top+o.bottom)/2,p=t.type==="doughnut"?r*((t.hole_size??s.holeSize)/100):0;i.plot={x:y-r,y:S-r,width:r*2,height:r*2};let M=0;return m.forEach((w,A)=>{const v=f>0?w/f:0,V=M+v*Math.PI*2;if(v>0){i.shapes.push({d:Ft(y,S,r,p,M,V),color:"lt1",width:1,fill:F(0,A),series:0,category:A});const j=(M+V)/2,k=p>0?(r+p)/2:labelPositionOf(t)==="inEnd"?r*.85:r*.6;n&&N(y+k*Math.sin(j),S-k*Math.cos(j),ht(t,w,v,n,t.categories[A]??""),"middle",b?.color??"lt1")}M=V}),i}if(isScatter(t.type))return Bt(t,i,o,e,h),i;const Z=Math.max(1,t.categories.length),g=isHorizontal(t.type),R=groupingOf(t.type),W=R!=="clustered"&&R!=="standard",O=R==="percentStacked",x=t.series.map(n=>t.categories.map((m,f)=>n.values[f]??null)),E=t.categories.map((n,m)=>x.reduce((f,r)=>f+Math.abs(r[m]??0),0)),L=(n,m)=>{const f=x[n]?.[m];if(f==null)return null;const r=E[m]??0;return O?r>0?f/r:0:f};let z=0,D=0;if(t.categories.forEach((n,m)=>{let f=0,r=0;t.series.forEach((y,S)=>{const p=L(S,m)??0;W?p>=0?f+=p:r+=p:(f=Math.max(f,p),r=Math.min(r,p))}),D=Math.max(D,f),z=Math.min(z,r)}),!W){const n=x.flat().filter(m=>m!==null);n.length>0&&Math.min(...n)>0&&(z=Math.min(...n))}O&&(D=1,z=Math.min(z,0));const c=t.value_axis??{},$=t.category_axis??{},H=c.number_format??(O?"0%":t.series[0]?.number_format??"General"),I=g?o.right-o.left:o.bottom-o.top,U=g?e*5:e*2.4,Y=chartScale(z,D,I,U,{...c,...O?{maximum_scale:c.maximum_scale??1}:{}}),Wt=c.visible===!1?[]:Y.ticks.map(n=>formatValue(n,H)),Et=Math.max(0,...Wt.map(n=>it(n,e))),ot=$.visible!==!1,dt=ot?Math.max(0,...t.categories.map(n=>it(n,e))):0,T=e*.5,mt=g?c.title:$.title,ft=g?$.title:c.title,St=vt(o,mt,ft,e),u=g?{x:o.left+(ot?dt+T:0),y:o.top,width:0,height:o.bottom-o.top-(c.visible===!1?0:e*1.2+T)}:{x:o.left+(c.visible===!1?0:Et+T),y:o.top,width:0,height:o.bottom-o.top-(ot?e*1.2+T:0)};u.width=o.right-u.x,i.plot=u,kt(i,u,St,mt,ft,e,h);const G=chartScale(z,D,g?u.width:u.height,U,{...c,...O?{maximum_scale:c.maximum_scale??1}:{}}),ut=n=>(Math.min(G.max,Math.max(G.min,n))-G.min)/(G.max-G.min)*(g?u.width:u.height),q=n=>g?u.x+ut(n):u.y+u.height-ut(n),pt=isArea(t.type),gt=$.reverse_order===!0,xt=g?!gt:gt,at=(g?u.height:u.width)/Z,yt=pt?(g?u.height:u.width)/Math.max(1,Z-1):at,ct=n=>{const m=pt?n*yt:(n+.5)*at,f=g?u.height:u.width,r=xt?f-m:m;return(g?u.y:u.x)+r},Mt=q(Math.max(G.min,Math.min(G.max,0)));for(const n of G.ticks){const m=q(n);(c.has_major_gridlines??!0)&&i.grid.push({d:g?`M${d(m)} ${d(u.y)} V${d(u.y+u.height)}`:`M${d(u.x)} ${d(m)} H${d(u.x+u.width)}`,color:c.gridline_color??{rgb:s.gridline},width:s.gridWidth}),c.visible!==!1&&i.words.push(g?{x:m,y:u.y+u.height+T+e*.6,text:formatValue(n,H),size:e,anchor:"middle",color:h}:{x:u.x-T,y:m,text:formatValue(n,H),size:e,anchor:"end",color:h})}if(i.axes.push({d:g?`M${d(Mt)} ${d(u.y)} V${d(u.y+u.height)}`:`M${d(u.x)} ${d(Mt)} H${d(u.x+u.width)}`,color:$.line_color??{rgb:s.axisLine},width:s.gridWidth}),ot){const n=g?e*1.3:dt+e,m=Math.max(1,Math.ceil(n/Math.max(1,yt)));t.categories.forEach((f,r)=>{if(r%m!==0)return;const y=ct(r);i.words.push(g?{x:u.x-T,y,text:f,size:e,anchor:"end",color:h}:{x:y,y:u.y+u.height+T+e*.6,text:f,size:e,anchor:"middle",color:h})})}if(isBar(t.type)){const n=(t.gap_width??s.gapWidth)/100,m=W?1:t.series.length,f=W?1:(t.overlap??0)/100,r=at/(Math.max(1,m-(m-1)*f)+n),y=r*(1-f),S=r+y*(m-1);t.categories.forEach((p,M)=>{const w=ct(M);let A=0,v=0;t.series.forEach((V,j)=>{const k=L(j,M);if(k===null)return;const nt=W?k>=0?A:v:0,tt=nt+k;W&&(k>=0?A=tt:v=tt);const J=q(nt),K=q(tt),st=(W?w-r/2:w-S/2+j*y)+(g&&xt&&!W?S-r-2*j*y:0),Pt=g?{x:Math.min(J,K),y:st,width:Math.abs(K-J),height:r}:{x:st,y:Math.min(J,K),width:r,height:Math.abs(K-J)};if(i.boxes.push({...Pt,color:F(j,M),series:j,category:M}),!b)return;const wt=ht(t,x[j]?.[M]??0,0,V,t.categories[M]??""),rt=labelPositionOf(t),Q=P*.8,At=k>=0?1:-1,_t=(et,X)=>rt==="ctr"?(et+X)/2:rt==="inBase"?et+(X>et?Q:-Q):rt==="inEnd"?X-(X>et?Q:-Q):X+(X>=et?Q:-Q);g?N(_t(J,K),st+r/2,wt,rt==="outEnd"?At>0?"start":"end":"middle"):N(st+r/2,_t(J,K),wt,"middle")})})}else{const n=t.categories.map(()=>0),m=t.series.map((f,r)=>{const y=[],S=[];return t.categories.forEach((p,M)=>{const w=L(r,M);if(w===null)return;const A=W?n[M]??0:0,v=A+w;W&&(n[M]=v);const V=ct(M),j=k=>g?[q(k),V]:[V,q(k)];if(y.push(j(v)),S.push(j(A)),isLine(t.type)&&b){const k=labelPositionOf(t),[nt,tt]=j(v);N(nt+(k==="r"?P:k==="l"?-P:0),tt+(k==="t"?-P:k==="b"?P:0),ht(t,x[r]?.[M]??0,0,f,t.categories[M]??""),k==="r"?"start":k==="l"?"end":"middle")}}),{series:f,s:r,points:y,base:S}});for(const{series:f,s:r,points:y,base:S}of m){const p=f.color??accentOf(r);if(isArea(t.type)&&y.length>0)i.shapes.push({d:`${lt([...y,...[...S].reverse()])} Z`,color:p,width:0,fill:p,series:r});else if(y.length>0&&(i.lines.push({d:f.smooth===!0?$t(y):lt(y),color:p,width:f.line_width??s.lineWidth,series:r}),hasMarkers(t.type)))for(const[M,w]of y)i.dots.push({x:M,y:w,r:(f.marker_size??s.marker)/2,color:p})}i.shapes.reverse()}return i}

package/dist/node_modules/@allyhub-next/chart/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./chart.js";
+export * from "./chart-xml.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub-next/chart/dist/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export*from"./chart.js";export*from"./chart-xml.js";

package/dist/node_modules/@allyhub-next/chart/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@allyhub-next/chart",
+  "version": "0.6.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/check/dist/check.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{deckFacts as ge}from"@allyhub-next/slides-core";import{createHash as te}from"node:crypto";import{join as se}from"node:path";import{uniformInt as oe}from"pure-rand/distribution/uniformInt";import{xoroshiro128plus as we}from"pure-rand/generator/xoroshiro128plus";import{CACHE_DIR as xe}from"@allyhub-next/formats";import{buildModule as be}from"@allyhub-next/model/build";import{ffmpegOf as ye,ffmpegRuns as $e,postPlaces as ke,postProblems as Se,readPng as ne}from"@allyhub-next/render";import{comboIdOf as U,comboKey as B,comboMatches as Me,countLevels as ve,coverCombos as Fe,cutThroughout as ie,pieceNamed as ae,problem as z,CONSOLE_LIMIT as Ce}from"@allyhub-next/video-core";import{OutputCache as Le,cacheKey as De,checkerId as Ee}from"./cache.js";import{consoleOf as Ae,baseDigest as Pe,outputDigest as re,dedupe as ce,StuckError as me,CheckSession as _e,runtimeDigest as Ie,extraCombos as Te}from"@allyhub-next/project";import{matrixFacts as Ke,measuredFacts as Oe,screenFidelity as Re,flatFrames as je,cutSeams as He,flashFrames as Be,stillPicture as ze}from"@allyhub-next/measure";import{generatedFact as Ne,generatedPagedFact as Ue,mismatchFacts as Ge}from"./generated.js";import{StretchLoudness as fe,estimatePlan as Ye,loadedPlan as qe,planProblems as Je}from"./plans.js";import{sceneryLayerFacts as Qe,withBakes as Ve}from"./scenery.js";export function checkStats(s,t,o,e=0){const i=t.length;return{loaded:t,reused:o,outputs:{total:s,checked:i,reused:Math.max(0,s-i-e),covered:e}}}const We=new Set(["text-time","words-on-screen","speech-on-screen","text-covered","flat-frames","still-picture"]);export const plural=(s,t)=>`${String(s)} ${t}${s===1?"":"s"}`;const de=s=>we(te("sha256").update(s).digest().readInt32BE(0));export function samplesFor(s,t,o,e){const i=new Set(s.slice(0,e)),r=de(o),c=Math.floor(t*30);for(let f=0;i.size<Math.min(e,c)&&f<e*20;f++)i.add(oe(r,0,c-1)/30);return[...i]}export function shuffled(s,t){const o=[...s],e=de(t);for(let i=o.length-1;i>0;i--){const r=oe(e,0,i),c=o[i],f=o[r];c===void 0||f===void 0||(o[i]=f,o[r]=c)}return o}export const RASTER_NOISE=3,RASTER_SPECKS=8;export function frameDifference(s,t){const o=ne(s),e=ne(t);if(o.width!==e.width||o.height!==e.height)return{max:255,pixels:Math.max(o.width*o.height,1)};let i=0,r=0;for(let c=0;c<o.data.length;c+=4){let f=0;for(let d=0;d<4;d++)f=Math.max(f,Math.abs((o.data[c+d]??0)-(e.data[c+d]??0)));f>RASTER_NOISE&&r++,f>i&&(i=f)}return{max:i,pixels:r}}export const CUT_RECHECK={most:48,every:2};export async function recheckCuts(s,t,o,e){const i=ie(t);if(i.length===0)return t;const r=CUT_RECHECK.every/o,c=new Set;for(const d of i){const a=e.find(h=>h.key===d.part);if(!a)continue;const l=t.moments.filter(h=>h.part===d.part).map(h=>h.t).sort((h,C)=>h-C),x=d.moments[0]??d.t,b=d.moments.at(-1)??d.t,F=Math.max(a.start,l.filter(h=>h<x).at(-1)??a.start),T=Math.min(a.end-1/o,l.find(h=>h>b)??a.end),A=Math.min(CUT_RECHECK.most,Math.floor((T-F)/r)+1),R=A>1?(T-F)/(A-1):0;for(let h=0;h<A;h++){const C=Math.round((F+R*h)*o)/o;l.includes(C)||c.add(C)}}if(c.size===0)return t;const f=await s.measure([...c].sort((d,a)=>d-a));return{...t,moments:[...t.moments,...f.moments].sort((d,a)=>d.t-a.t)}}export function offFrameProblems(s,t){const o=e=>`${e.toFixed(2)} s`;return ie(s).map(e=>{const i=e.moments[0]??0,r=e.moments.at(-1)??i,c=e.moments.length===1?`at ${o(i)}, the one moment measured that shows it`:`at all ${String(e.moments.length)} moments measured that show it (${i.toFixed(2)}–${o(r)})`,f=e.worst.edges.map(l=>`${String(l.px)} pixels past the ${l.side} edge`).join(" and "),d=`"${e.text.text.length>40?`${e.text.text.slice(0,40)}…`:e.text.text}"`,a=s.deck?`Text goes off the slide: the slide's edge cuts ${d} of ${e.text.layer} on slide ${e.part}; its letters reach ${f} at ${t.format} (${String(Math.round(e.worst.share*100))}% of them outside). Move or size its shape inside the slide, or give it less text. allyhub inspect --kind text-off-frame has it.`:void 0;return z("AK-L002",a??`Text goes off the frame: the frame cuts "${e.text.text.length>40?`${e.text.text.slice(0,40)}…`:e.text.text}" ${c}; its letters reach ${f} at ${t.format} (${String(Math.round(e.worst.share*100))}% of them outside). Move it inside the frame or make it smaller (fitText in a component); text that is part of a picture the frame crops on purpose (a mocked interface) goes inside an element with data-ak-picture. allyhub inspect --kind text-off-frame has each moment.`,{piece:t.piece,output:t.output,combo:t.combo,format:t.format,part:e.part,t:e.t,where:{bbox:e.worst.glyphs}})})}const le=s=>te("sha256").update(s).digest("hex");export async function determinism(s,t,o){const e=s.timeline,i=samplesFor(e.parts.map(a=>a.still),e.duration,t,o),r=new Map;for(const a of[...i].sort((l,x)=>l-x))r.set(a,await s.shot(a));const c=[];let f=0;for(const a of shuffled(i,`${t}:shuffle`)){const l=r.get(a),x=await s.shot(a);if(!l||le(x)===le(l))continue;const b=frameDifference(l,x);b.pixels>RASTER_SPECKS&&(c.push(a),f=Math.max(f,b.max))}if(c.length===0)return[];c.sort((a,l)=>a-l);const d=[...new Set(c.flatMap(a=>e.parts.filter(l=>a>=l.start&&a<l.end).map(l=>l.key)))];return[z("AK-D002",`${plural(c.length,"moment")} drew differently in order and out of order (${c.map(a=>`${a.toFixed(2)}s`).join(", ")}; pixels differ by up to ${String(f)} levels). render must depend only on t, not on state left by an earlier frame.`,{piece:s.target.piece,output:s.target.output,combo:s.target.combo,format:s.target.format,t:c[0]??0,...d.length===1&&d[0]?{part:d[0]}:{}})]}export function summarize(s){const t=ve(s);return{status:t.errors>0?"failed":t.warnings>0?"warnings":"passed",...t}}function Xe(s,t){const o=r=>[r.piece??"",r.output??"",r.combo?B(r.combo):"",r.format??"",r.part??"",r.where?.file??"",String(r.where?.line??0).padStart(6,"0"),r.code].join("\0"),e=o(s),i=o(t);return e<i?-1:e>i?1:0}class Ze{spent=new Map;on=process.env.ALLYHUB_CHECK_TIMINGS==="1";async time(t,o){if(!this.on)return o();const e=performance.now();try{return await o()}finally{this.spent.set(t,(this.spent.get(t)??0)+(performance.now()-e)/1e3)}}report(){if(!this.on)return;const t=[...this.spent].sort((o,e)=>e[1]-o[1]);process.stderr.write(`Check timings (s): ${t.map(([o,e])=>`${o} ${e.toFixed(2)}`).join(", ")}
+`)}}function et(s){const t=s.options,o=t.post,e=typeof o=="object"&&o!==null?o.filter:void 0;return{transparent:t.transparent===!0,deliverable:t.deliverable!==!1,...typeof t.maxDuration=="number"?{maxDuration:t.maxDuration}:{},...typeof e=="string"?{post:e}:{}}}async function tt(s){let t;try{t=await ye(s===void 0?{}:{ffmpeg:s})}catch(o){return{missing:`the pinned ffmpeg could not be had: ${(o instanceof Error?o.message:String(o)).split(`
+`)[0]??""}`}}return await $e(t)?{ffmpeg:t}:{missing:`${t} does not run`}}export async function runCheck(s){const t=new Ze,o=s.session??await t.time("prepare (discover, metadata, bundle)",()=>_e.open({root:s.dir,...s.buildDir===void 0?{}:{buildDir:s.buildDir},...s.gpu===void 0?{}:{gpu:s.gpu},...s.consoleLimit===void 0?{}:{consoleLimit:s.consoleLimit}}));try{const e=o.prepared,i=s.samples??12,r=o.consoleLimit,c=await Ie(),f=await Le.open(e.root,await Ee({runtimeSha:c,samples:i,gpu:o.gpu,...r===Ce?{}:{consoleLimit:r}}));let d;const a=()=>d??=tt(s.ffmpeg),l=[],x=[...e.problems],b=[],F=[],T=[],A=[];let R=0,h=0;const C=[];let L;const ue=e.pieces.filter(n=>s.piece===void 0||ae({id:n.id,path:n.place},s.piece));for(const n of ue){if(!e.bundle?.chunks.entries[n.id.replaceAll("/","__")])continue;const M=et(n),P=n.kind,K=n.format,Y=await Pe(e,n,c);b.push(...Ke(n));const q=new Set,j=[...n.combos.filter(p=>!s.combos?.length||s.combos.some(u=>Me(p,u,U(n.matrix,p)))),...Te(n,s.combos)],pe=new Set(n.matrix?Fe(n.matrix.space,n.dims,j):j.keys()),_=[],J=p=>{T.push(p);for(const u of p.reads?.media??[])q.add(u.path);p.timeline&&_.push({...p,timeline:p.timeline})};let N=!1;const he=(p,u,I)=>{if(s.fresh===!0)return;const m=f.get(p),y=m?.result.reads,D=m?.result.timeline;return!m||!y||!D||I&&!m.sampled||m.factless===!0&&s.facts!==!1?void 0:re(e,Y,n,u,y)===m.digest?m:void 0};for(const[p,u]of j.entries()){const I=U(n.matrix,u),m={piece:n.id,output:P,combo:u,format:K},y=B(u);if(F.push({...m,...I?{id:I}:{},key:y}),!pe.has(p)){h++;continue}const D=n.kind==="video"&&!N,E=De(n.id,P,y,K),g=he(E,u,D);if(g){R++,g.sampled&&(N=!0),x.push(...g.problems),b.push(...g.facts),l.push({version:m,log:g.console}),J({...g.result,digest:g.digest}),f.set(E,g);continue}A.push(`${n.id}/${P}/${y}/${K}`);const w=await t.time("load (mount, stills)",()=>o.open(n,m));try{const $=w.summary,O=[],v=[...$?.facts??[]];let Q=!1;try{if($){const k=$.timeline;try{const S=await t.time("layout measure",()=>w.measure());O.push(...offFrameProblems(S.deck?S:await t.time("recheck cut text",()=>recheckCuts(w,S,k.fps,k.parts)),m));const ee=await a();v.push(...await t.time("layout facts",()=>Oe(S,k,m,{root:e.root,media:e.media,ffmpeg:"ffmpeg"in ee?ee.ffmpeg:"ffmpeg"},k.profile?.label))),S.deck&&v.push(...ge(S.deck,{width:S.width,height:S.height},{piece:m.piece,output:m.output,combo:m.combo,format:m.format}))}catch(S){if(S instanceof me)throw S}s.facts!==!1&&v.push(...await t.time("scenery facts",()=>Qe(w)))}$&&D&&(N=!0,Q=!0,O.push(...await t.time("determinism",()=>determinism(w,`${n.id}:${P}:${K}`,i))),s.facts!==!1&&!M.transparent&&v.push(...await t.time("flat frames",()=>je(w))),s.facts!==!1&&v.push(...await t.time("still picture",()=>ze(w))),s.facts!==!1&&(v.push(...await t.time("cut seams",()=>He(w))),M.transparent||v.push(...await t.time("flash",()=>Be(w))))),$&&s.facts!==!1&&v.push(...(await t.time("scenery screen fidelity",()=>Re(w))).facts)}catch(k){if(!(k instanceof me))throw k;k.kept||O.push(z("AK-P003",k.message,{piece:m.piece,output:m.output,combo:m.combo,format:m.format}))}O.push(...await w.problems());const V=ce(O);x.push(...V);const W=M.deliverable?v:v.filter(k=>!We.has(k.kind));b.push(...W);const X=await w.console();l.push({version:m,log:X});const H=$?re(e,Y,n,u,$.reads):void 0,Z={...m,...$?{timeline:$.timeline,reads:$.reads,text:$.text}:{}};J({...Z,...H?{digest:H}:{}}),H&&f.set(E,{digest:H,result:Z,problems:V,facts:W,sampled:Q,...s.facts===!1?{factless:!0}:{},console:X})}finally{await w.close()}}if(n.kind==="video"){const p=ke(M.post,_.map(u=>u.timeline));if(p.length>0){const u=await a();"ffmpeg"in u&&x.push(...await t.time("post chains",()=>Se(p,{piece:n.id,output:P},u.ffmpeg)))}}if(n.kind!=="video")for(const p of _){const u=Ue(p,e.media);u&&b.push(u)}else for(const p of j){const u=U(n.matrix,p),I=B(p),m=_.find(g=>B(g.combo)===I),y=m?qe(m,u):Ye(n,p,u,P,K,_);if(!y)continue;if(C.push(y),n.matrix&&L===void 0){const g=await a();if("ffmpeg"in g){const w=new fe(e.root,g.ffmpeg);await w.open(),L=w}else L={missing:"ffmpeg",why:`${g.missing} (set ALLYHUB_FFMPEG to an ffmpeg, or let the runtime manager fetch its pinned one)`}}const D=await t.time("plans (loudness, music)",()=>Je(y,{...M.maxDuration===void 0?{}:{maxDuration:M.maxDuration},fps:m?.timeline.fps??_[0]?.timeline.fps??30,media:e.media,local:g=>o.mediaPath(g),...n.matrix&&L?{loudness:L}:{}}));x.push(...D.problems),b.push(...D.facts);const E=Ne(y,e.media);E&&b.push(E)}b.push(...Ge({piece:n.id},q,e.media))}for(const n of e.items)if(n.kind==="model"&&!(s.piece!==void 0&&!ae({id:n.dir,path:n.dir},s.piece)))try{await t.time("models",()=>be(se(e.root,n.entry),{root:e.root,cache:se(e.root,xe,"model"),log:()=>{}}))}catch(M){x.push(z("AK-B010",`${n.entry} does not build: ${M instanceof Error?M.message:String(M)}`,{piece:n.dir,where:{file:n.entry}}))}L instanceof fe&&await L.save(),await f.save(new Set(e.pieces.map(n=>n.id)));const G=ce(x).sort(Xe);return t.report(),{targets:F,check:summarize(G),problems:G,facts:await Ve(b,e.root),results:T,plans:C,stats:checkStats(F.length,A,R,h),console:Ae(r,l)}}finally{s.session||await o.close()}}

package/dist/node_modules/@allyhub-next/check/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/check",
+  "version": "0.6.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/cloud/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/cloud",
+  "version": "0.6.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/components/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@allyhub-next/components",
+  "version": "0.6.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./registry.json": "./registry.json",
+    "./r/*": "./r/*"
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/dev-server/dist/card.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as p}from"node:fs/promises";import{basename as f,join as w}from"node:path";import{parseDoc as y,splitTitle as b}from"@allyhub-next/doc";import{readSheetSource as g,workbookFiles as k}from"@allyhub-next/build";import{Calc as j,readWorkbook as x,shownValue as A}from"@allyhub-next/sheet";export const CARD_DEFAULTS={lines:4,chars:240,rows:5,columns:6},projectName=t=>f(t);function v(t){if(!("content"in t)||!Array.isArray(t.content))return;const e=t.content.map(r=>r.text).join("").trim();return e===""?void 0:e}const D=(t,e)=>t.length<=e?t:`${t.slice(0,e-1).trimEnd()}…`;function F(t){const{body:e}=b(y(t).blocks),r=[];for(const o of e){const i=v(o);if(i!==void 0&&r.push(D(i,CARD_DEFAULTS.chars)),r.length===CARD_DEFAULTS.lines)break}return{type:"text",lines:r}}async function P(t,e){const r=await g(t,e.dir),{workbook:o}=x(k(t,r)),i=o?.sheets[0];if(!o||!i)return{type:"table",columns:[],rows:[],count:0};const u=new j(o).calculate(),n=i.tables[0]?.area??i.used;if(!n)return{type:"table",columns:[],rows:[],count:0};const d=(s,c)=>A(u.value(i,s,c),i.lookAt(s,c).format),h=Math.min(n.right-n.left+1,CARD_DEFAULTS.columns),a=s=>Array.from({length:h},(c,m)=>d(s,n.left+m)),l=[];for(let s=n.top+1;s<=Math.min(n.bottom,n.top+CARD_DEFAULTS.rows);s++)l.push(a(s));return{type:"table",columns:a(n.top),rows:l,count:n.bottom-n.top}}export async function itemPreview(t,e){const r=t.project.root;switch(e.kind){case"doc":return F(await p(w(r,e.entry),"utf8"));case"sheet":return await P(r,e);case"video":{const o=await t.project.tool("video/still",{item:e.dir});return{type:"picture",image:o.image,width:o.width,height:o.height,duration:o.duration}}case"slides":{const o=await t.project.tool("video/still",{item:e.dir});return{type:"picture",image:o.image,width:o.width,height:o.height}}default:return}}

package/dist/node_modules/@allyhub-next/dev-server/dist/exports.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{randomBytes as n}from"node:crypto";import{join as h}from"node:path";import{exportProject as l}from"@allyhub-next/export";import{OUT_DIR as c}from"@allyhub-next/formats";import{parseCombo as p}from"@allyhub-next/project";import{projectPathOf as d}from"./paths.js";function u(i){const t=i?.pptx;return{...i?.steps===!0?{steps:!0}:{},...t==="picture"?{pptx:t}:{}}}export class Exports{root;changed;jobs=[];aborts=new Map;queue=Promise.resolve();constructor(t,s){this.root=t,this.changed=s}list(){return this.jobs.map(t=>({...t}))}start(t,s,r,o){const e={id:`x${n(4).toString("hex")}`,item:t,versions:s,types:r,...o?{options:o}:{},state:"queued",progress:0,files:[]};this.jobs.push(e);const a=new AbortController;return this.aborts.set(e.id,a),this.changed({...e}),this.queue=this.queue.then(()=>this.run(e,a.signal)),{...e}}cancel(t){const s=this.jobs.find(r=>r.id===t);return!s||s.state==="done"||s.state==="failed"?!1:(this.aborts.get(t)?.abort(),this.set(s,{state:"cancelled"}),!0)}idle(){return this.queue}async close(){for(const t of this.aborts.values())t.abort();await this.queue}set(t,s){Object.assign(t,s),this.changed({...t})}async run(t,s){if(t.state!=="cancelled"){this.set(t,{state:"running"});try{const r=await l({root:this.root,items:[t.item],...t.versions.length?{combos:t.versions.map(e=>p(e))}:{},...t.types.length?{types:t.types}:{},...u(t.options),out:h(this.root,c),signal:s,onProgress:e=>{s.aborted||this.set(t,{progress:Math.max(t.progress,Math.min(1,e))})}}),o=r.files.flatMap(e=>e.files).map(e=>d(this.root,e)).filter(e=>e!==void 0);s.aborted?this.set(t,{state:"cancelled",files:o}):r.failed.length>0&&o.length===0?this.set(t,{state:"failed",error:r.failed.map(e=>e.message).join(" ")}):this.set(t,{state:"done",progress:1,files:o,...r.failed.length>0?{error:[...new Map(r.failed.map(e=>[e.code,e.message])).values()].join(" ")}:{}})}catch(r){this.set(t,{state:s.aborted?"cancelled":"failed",...s.aborted?{}:{error:r instanceof Error?r.message:String(r)}})}finally{this.aborts.delete(t.id)}}}}

package/dist/node_modules/@allyhub-next/dev-server/dist/live.d.ts

@@ -0,0 +1,77 @@
+import { type Browser } from "@allyhub-next/browser";
+import { type PieceInfo, type Prepared, type SheetSource } from "@allyhub-next/build";
+import { CheckSession } from "@allyhub-next/project";
+import type { BuildSource, Combo } from "@allyhub-next/video-core";
+/** Where a project path is served to the stage, under its base. */
+export declare const stageMedia: (base: string, path: string) => string;
+/** A tool's failure in the project, as a JSON-RPC error. */
+export declare function rpcErrorOf(e: unknown): unknown;
+export declare class Live {
+    readonly root: string;
+    /** The stage's base path, ending in "/": `/s/<its token>/`. */
+    readonly stageBase: string;
+    /** This server's own build folders. */
+    readonly buildDir: string;
+    revision: number;
+    private prep;
+    private last;
+    private lease;
+    private readonly old;
+    private browserStarted;
+    private readonly gpu;
+    private sceneries;
+    private building;
+    private closed;
+    private readonly sheetCodes;
+    constructor(root: string, stageBase: string, o?: {
+        gpu?: boolean;
+    });
+    /** The project changed: the next build and session are the new revision's. */
+    moved(revision: number): void;
+    /** The project prepared and bundled for the stage, as it is now. */
+    prepared(): Promise<Prepared>;
+    private build;
+    /** What a sheet's sheet.ts makes, once per revision: the same files make the same sheets. */
+    sheetCode(dir: string): Promise<{
+        generated?: SheetSource["generated"];
+        failed: boolean;
+    }>;
+    /** The last build that finished, if any (without waiting for one). */
+    latest(): Prepared | undefined;
+    /** A piece and its version, by the item's folder and a combo's key or id. */
+    target(item: string, version?: string): Promise<{
+        prepared: Prepared;
+        piece: PieceInfo;
+        combo: Combo;
+    }>;
+    /**
+     * What the stage page loads for a piece: its build at this server's
+     * addresses, and each sound's loudness as the export measures it, so the preview plays at
+     * the export's levels.
+     */
+    source(pieceId: string, origin: string): Promise<BuildSource>;
+    /** The one Chrome the check and the tools draw in, started when first needed. */
+    browser(): Promise<Browser>;
+    /**
+     * Runs `work` on a session of the project as it is now (a CheckSession:
+     * the check's, and the tools' that draw); a session is opened once per
+     * revision and closed when the project moved on and nothing uses it.
+     */
+    withSession<T>(work: (s: CheckSession) => Promise<T>): Promise<T>;
+    private refuseStopped;
+    private retire;
+    private end;
+    /** A scenery module bundled for its viewer, once per revision. */
+    scenery(file: string): Promise<SceneryBuild>;
+    private bundleScenery;
+    close(): Promise<void>;
+}
+/** A scenery's viewer bundle (paths from the scenery build folder) and the media it may load. */
+export interface SceneryBuild {
+    module: string;
+    decoders: string;
+    manifoldWasm: string;
+    xatlasWasm: string;
+    media: string[];
+}
+//# sourceMappingURL=live.d.ts.map

package/dist/node_modules/@allyhub-next/dev-server/dist/live.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as b,rm as m}from"node:fs/promises";import{join as c}from"node:path";import{fileLoudness as v}from"@allyhub-next/audio/node";import{startBrowser as g}from"@allyhub-next/browser";import{allyhubPlugin as y,hasSheetCode as S,listFiles as $,loadUserVite as D,prepare as C,readMedia as k,readSheetSource as j,sourceOf as B}from"@allyhub-next/build";import{CACHE_DIR as O,entryKind as R}from"@allyhub-next/formats";import{CheckSession as U,ProjectError as P,pickTarget as E,parseCombo as M}from"@allyhub-next/project";import{RPC_ERROR as p,RpcError as f}from"@allyhub-next/protocol";import{bundleScenery as F,writeModelStage as x}from"@allyhub-next/scenery-host/bundle";import{sceneryHost as w,serveDecoders as H}from"@allyhub-next/stage";export const stageMedia=(o,e)=>`${o}media/${e.split("/").map(encodeURIComponent).join("/")}`;export function rpcErrorOf(o){return o instanceof P?new f(o.kind==="not-found"?p.notFound:p.invalid,o.hint?`${o.message} ${o.hint}`:o.message):o}export class Live{root;stageBase;buildDir;revision=0;prep;last;lease;old=new Set;browserStarted;gpu;sceneries=new Map;building=Promise.resolve();closed=!1;sheetCodes=new Map;constructor(e,t,s={}){this.root=e,this.stageBase=t,this.buildDir=c(e,O,"build",`dev-${String(process.pid)}`),this.gpu=s.gpu}moved(e){this.revision=e,this.lease&&this.lease.revision!==e&&this.retire(this.lease)}prepared(){const e=this.revision;if(this.prep?.revision===e)return this.prep.promise;const t=this.building.then(()=>e===this.revision?this.build():void 0);this.building=t.catch(()=>{});const s=t.then(i=>i??this.prepared());return this.prep={revision:e,promise:s},s.catch(()=>{this.prep?.promise===s&&(this.prep=void 0)}),s}async build(){const e=await C(this.root,{buildDir:c(this.buildDir,"stage"),mediaUrl:t=>stageMedia(this.stageBase,t),host:w(this.root)});return e.bundle&&await H(e.bundle.dir),this.last=e,e}async sheetCode(e){if(!S(this.root,e))return{failed:!1};const t=this.sheetCodes.get(e),s=t?.revision===this.revision?t.promise:j(this.root,e).catch(()=>{});this.sheetCodes.set(e,{revision:this.revision,promise:s});const i=await s;return{failed:i?.failed??!0,...i?.generated?{generated:i.generated}:{}}}latest(){return this.last}async target(e,t){const s=await this.prepared();try{const{piece:i,target:r}=E(s,e,t===void 0?void 0:[M(t)]);return{prepared:s,piece:i,combo:r.combo}}catch(i){throw rpcErrorOf(i)}}async source(e,t){const s=await this.prepared(),i=s.pieces.find(n=>n.id===e);if(!i)throw new f(p.notFound,`No piece ${e}.`);const r=B(s,i,`${t}${this.stageBase}build/`,n=>`${t}${stageMedia(this.stageBase,n)}`),h={...r.media},u=(n,a)=>`${t}${this.stageBase}${n}/${a.split("/").map(encodeURIComponent).join("/")}`;return await Promise.all(Object.entries(h).map(async([n,a])=>{let d=a;if(a.kind==="video"&&a.matte===!0&&(d={...d,matteUrl:u("matte",n)}),a.kind==="audio"||a.kind==="video"&&a.audio===!0){d={...d,denoisedUrl:u("sound",n)};const l=await v(c(this.root,n)).catch(()=>{});l!==void 0&&(d={...d,loudness:l.lufs,...l.by==="level"?{loudnessBy:"level"}:{}})}h[n]=d})),{...r,media:h}}browser(){return this.browserStarted??=g(this.gpu===void 0?{}:{gpu:this.gpu}),this.browserStarted}async withSession(e){this.refuseStopped();let t=this.lease;if(t?.revision!==this.revision){t&&this.retire(t);const s=await this.browser();if(this.refuseStopped(),t=this.lease,t?.revision!==this.revision){t&&this.retire(t);const i=c(this.buildDir,`session-${String(this.revision)}`),r={revision:this.revision,session:U.open({root:this.root,browser:s,buildDir:i}),users:0,retired:!1,dir:i};t=r,this.lease=r,r.session.catch(()=>{this.lease===r&&(this.lease=void 0)})}}t.users++;try{return await e(await t.session)}finally{t.users--,t.retired&&t.users===0&&this.end(t)}}refuseStopped(){if(this.closed)throw new f(p.unavailable,"allyhub dev is stopping.")}retire(e){e.retired=!0,this.lease===e&&(this.lease=void 0),this.old.add(e),e.users===0&&this.end(e)}end(e){return e.ended??=(async()=>{this.old.delete(e),await e.session.then(t=>t.close()).catch(()=>{}),await m(e.dir,{recursive:!0,force:!0})})(),e.ended}scenery(e){const t=this.sceneries.get(e);if(t?.revision===this.revision)return t.promise;const s=this.bundleScenery(e);return this.sceneries.set(e,{revision:this.revision,promise:s}),s.catch(()=>{this.sceneries.get(e)?.promise===s&&this.sceneries.delete(e)}),s}async bundleScenery(e){const t=await $(this.root),s=await k(this.root,t),i=await I(this.root),r=w(this.root),h=await D(this.root),u=c(this.buildDir,"scenery"),n=R(e)==="model"?await x({root:this.root,model:e,outDir:u}):e;return{...await F({root:this.root,file:n,outDir:u,dependencies:i,plugins:[y({root:this.root,media:s,dependencies:i,lent:r.lent,mediaUrl:d=>stageMedia(this.stageBase,d)})],...h?{user:h}:{}}),media:Object.keys(s)}}async close(){this.closed=!0;const e=[...this.old,...this.lease?[this.lease]:[]];this.lease&&this.retire(this.lease),await Promise.all(e.map(t=>this.end(t))),await this.browserStarted?.then(t=>t.close()).catch(()=>{}),await m(this.buildDir,{recursive:!0,force:!0})}}async function I(o){try{const e=JSON.parse(await b(c(o,"package.json"),"utf8")),t=new Set;for(const s of["dependencies","devDependencies","peerDependencies","optionalDependencies"]){const i=e[s];if(i&&typeof i=="object")for(const r of Object.keys(i))t.add(r)}return t}catch{return new Set}}

package/dist/node_modules/@allyhub-next/dev-server/dist/tools.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{access as E,readFile as b}from"node:fs/promises";import{basename as R,join as h}from"node:path";import{listFiles as y}from"@allyhub-next/build";import{splitTitle as S,parseDoc as O,titleText as j}from"@allyhub-next/doc";import{ITEM_KINDS as k,OUT_DIR as D,scanItems as g,scriptFileFor as I,slidesFileFor as N}from"@allyhub-next/formats";import{OpenedVersion as _,parseCombo as C}from"@allyhub-next/project";import{RPC_ERROR as d,RpcError as f}from"@allyhub-next/protocol";import{readSheetFile as K}from"@allyhub-next/sheet";import{comboKey as v,formatInfo as x,messagePrefix as M}from"@allyhub-next/video-core";import{rpcErrorOf as U}from"./live.js";import{loose as q}from"./paths.js";const F=i=>{const o=i.addresses?.();if(!o)throw new f(d.unavailable,"This server serves no pages: only allyhub dev's does.");return o},$=i=>({mime:"image/webp",data:i.toString("base64")});async function L(i,o,p){try{if(o.kind==="doc"){const m=await b(h(i,o.entry),"utf8");return j(S(O(m).blocks).title)||void 0}if(o.kind==="sheet"){const m=await b(h(i,o.entry),"utf8");return K(m).file?.title}}catch{return}return p.get(o.dir)}const W=512;export function toolHandlers(i){const{live:o}=i,p=new Map,m=async(t,e,s,r)=>{try{return await o.withSession(async a=>{const n=await _.open({root:o.root,item:t,...e===void 0?{}:{combos:[C(e)]},purpose:s,session:a});try{return await r(n)}finally{await n.close()}})}catch(a){throw U(a)}};return{"project/items":async()=>{const t=await y(o.root),e=g(t),r=e.items.some(n=>n.kind==="video"||n.kind==="slides")?await o.prepared().catch(()=>o.latest()):void 0,a=new Map;for(const n of r?.pieces??[]){const c=typeof n.title=="string"?n.title:void 0;c&&a.set(n.dir,c)}return{items:await Promise.all(e.items.map(async n=>{const c=await L(o.root,n,a);return{...n,...c?{title:c}:{}}})),folder:o.root,name:R(o.root),revision:o.revision}},"sheet/generated":async({item:t})=>{const e=await o.sheetCode(t);return{failed:e.failed,...e.generated?{generated:e.generated}:{}}},"video/versions":async({item:t})=>{const{piece:e}=await o.target(t),s=[...new Set(e.combos.map(r=>r.lang))];return{piece:e.id,kind:e.kind,...typeof e.title=="string"?{title:e.title}:{},width:x(e.formatEntry)?.width??0,height:x(e.formatEntry)?.height??0,versions:s.map(r=>r===void 0?{key:v({})}:{key:v({lang:r}),lang:r})}},"slides/deck":async({item:t})=>{const{prepared:e,piece:s}=await o.target(t);if(s.kind!=="slides")throw new Error(`${t} is a video, not a deck.`);return{piece:s.id,file:N(s.dir),prefix:M(s.id),layouts:s.deck?.layouts??[],components:s.deck?.components??{},generators:s.deck?.generators??[],scripts:Object.fromEntries(e.messages.locales.map(r=>[r,I(s.dir,r)]))}},"video/stage":async({item:t,version:e,start:s,play:r,chrome:a,edit:n})=>{const{piece:c,combo:w}=await o.target(t,e),l=new URLSearchParams({piece:c.id,combo:v(w)});for(const[P,T]of Object.entries(s??{}))l.set(P,String(T));r&&l.set("play","1"),a===!1&&l.set("chrome","0"),n===!0&&l.set("edit","1");const u=F(i);return{url:u.stage(l),probe:u.probe}},"video/timeline":async({item:t,version:e})=>m(t,e,"play",s=>Promise.resolve({timeline:q(s.timeline),text:s.version.summary?.text??[]})),"video/still":async({item:t,version:e,t:s})=>m(t,e,"render",async r=>{const a=s??r.timeline.parts[0]?.still??0;return{t:a,image:$(await r.still(a,{format:"webp"})),width:r.timeline.width,height:r.timeline.height,duration:r.timeline.duration}}),"video/stills":async({item:t,version:e,moments:s})=>m(t,e,"render",async r=>{const a=[];for(const n of s){const c=await r.version.sign(n),w=`${t}\0${e??""}\0${c??""}`,l=c===void 0?void 0:p.get(w),u=l??$(await r.still(n,{format:"webp"}));c!==void 0&&!l&&(p.size>=W&&p.clear(),p.set(w,u)),a.push({t:n,image:u})}return{stills:a}}),"check/results":()=>Promise.resolve(i.checker?.state??{status:"off",revision:o.revision,problems:[],facts:[]}),"check/run":()=>{if(!i.checker)throw new f(d.unavailable,"This server runs no check.");return i.checker.schedule(!0),Promise.resolve({})},"export/start":async({item:t,versions:e,types:s,options:r})=>{const a=await y(o.root);if(!g(a).items.some(n=>n.dir===t))throw new f(d.notFound,`There is no item ${t}.`);return{job:i.exports.start(t,e??[],s??[],r)}},"export/cancel":({job:t})=>{if(!i.exports.cancel(t))throw new f(d.notFound,`No export ${t} is under way.`);return Promise.resolve({})},"export/list":()=>Promise.resolve({jobs:i.exports.list(),reveal:i.reveal!==void 0}),"export/reveal":async({path:t})=>{if(!i.reveal)throw new f(d.unavailable,"This server is not on the person's computer: download the file.");if(!t.startsWith(`${D}/`))throw new f(d.notFound,`${t} is no exported file.`);const e=h(o.root,t);return await E(e).catch(()=>{throw new f(d.notFound,`There is no file ${t}.`)}),await i.reveal(e),{}},"scenery/viewer":async({item:t,camera:e})=>{const s=await y(o.root),r=g(s).items.find(c=>c.dir===t&&(c.kind==="scenery"||c.kind==="model"));if(!r)throw new f(d.notFound,`There is no scenery or 3D model ${t}: a scenery is a folder with a ${k.scenery.entries[0]??"scenery.ts"}, a model one with a ${k.model.entries[0]??"model.ts"}.`);const a=new URLSearchParams({file:r.entry});e&&a.set("camera",JSON.stringify(e));const n=F(i);return{url:n.viewer(a),probe:n.probe}}}}

package/dist/node_modules/@allyhub-next/dev-server/dist/validate.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{parse as c}from"yaml";import{parseDoc as p}from"@allyhub-next/doc";import{DATA_FILES as m,ITEM_KINDS as l,baseOf as f}from"@allyhub-next/formats";import{readSheetFile as u}from"@allyhub-next/sheet";const $=r=>new RegExp(`^${r.split("**/").map(s=>s.replace(/[.+?^${}()|[\]\\]/gu,"\\$&").replaceAll("*","[^/]*")).join("(?:.*/)?")}$`,"u"),d=Object.entries(m).flatMap(([r,s])=>s.files.map(t=>({name:r,re:$(t)})));export function dataFileOf(r){return d.find(s=>s.re.test(r))?.name}const g=l.doc.entries[0],b=l.sheet.entries[0];export function writeProblems(r,s){const t=f(r);if(t===g){const e=p(s),n=e.blocks.length===0?e.problems[0]:void 0;return n&&s.trim()!==""?[`not MDX${n.line===void 0?"":` (line ${String(n.line)})`}: ${n.message}`]:[]}if(t===b)return u(s).problems.filter(e=>e.message.startsWith("not YAML")).map(e=>e.message);const a=dataFileOf(r);if(a===void 0)return[];let o;try{o=/\.ya?ml$/u.test(t)?c(s):JSON.parse(s)}catch(e){return[`not ${/\.ya?ml$/u.test(t)?"YAML":"JSON"}: ${e.message.split(`
+`)[0]??""}`]}const i=m[a].schema.safeParse(o);return i.success?[]:i.error.issues.map(e=>`${e.path.length?`${e.path.join(".")}: `:""}${e.message}`)}

package/dist/node_modules/@allyhub-next/dev-server/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/dev-server",
+  "version": "0.6.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/doc/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@allyhub-next/doc",
+  "version": "0.6.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./docx": {
+      "types": "./dist/docx.d.ts",
+      "default": "./dist/docx.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/export/dist/export.d.ts

@@ -0,0 +1,123 @@
+import { type EncodeOptions, type RenderTimings } from "@allyhub-next/render";
+import { type CaptionCueOptions, type Combo, type ConsoleReport, type FileType, type Problem } from "@allyhub-next/video-core";
+import { OpenedVersion } from "@allyhub-next/project";
+/** How a version's files are made. */
+export interface VersionExportOptions {
+    encode?: EncodeOptions;
+    /** Pages drawing a video's graphics, shared by the parts it renders at once. */
+    workers?: number;
+    /** srt and vtt: how cues are cut and timed; default as the piece's own captions are (subtitleCues). */
+    captions?: CaptionCueOptions;
+    /** false renders every part again and keeps nothing in the part cache. */
+    partCache?: false;
+    /** A deck's pdf, png and pptx: a page, a file or a slide per step, not only each page's last. */
+    steps?: boolean;
+    /** A deck's pptx: PowerPoint's own model (the default), or each slide a picture. */
+    pptx?: "native" | "picture";
+    /** 0–1. */
+    onProgress?: (p: number) => void;
+    /** Aborting it stops the export: what runs stops, and no part of a file stays. */
+    signal?: AbortSignal;
+}
+/** What one export wrote. */
+export interface VersionFile {
+    /** Every file written; one, or a PNG per page or frame. */
+    files: string[];
+    /** A video's seconds. */
+    duration?: number;
+    parts?: {
+        total: number;
+        cached: number;
+    };
+    junctions?: {
+        total: number;
+        cached: number;
+    };
+    loudness?: {
+        integrated: number;
+        range?: number;
+        truePeak?: number;
+    };
+    master?: Record<string, unknown>;
+    timings?: RenderTimings;
+    /** A deck's PowerPoint file: the fonts it names and does not carry, and why. */
+    fontsLeft?: {
+        font: string;
+        why: string;
+    }[];
+}
+export declare function exportVersion(v: OpenedVersion, type: FileType, out: string, o?: VersionExportOptions): Promise<VersionFile>;
+/** Exports made at once: a quarter of the CPUs. */
+export declare const exportsAtOnce: (n: number) => number;
+/** A file a project's export made. */
+export interface ExportedFile extends VersionFile {
+    /** Its path in the output folder, with / between folders. */
+    name: string;
+    path: string;
+    piece: string;
+    type: FileType | DocType | SheetType | ModelType;
+    combo?: Combo;
+    key?: string;
+    format?: string;
+    bytes: number;
+    seconds: number;
+}
+/** A file that could not be made, and why; the others are made. */
+export interface NotExported {
+    name: string;
+    piece: string;
+    type: FileType | DocType | SheetType | ModelType;
+    code: string;
+    message: string;
+    hint?: string;
+}
+/** A doc's and a sheet's own file types. */
+export declare const DOC_TYPES: readonly ["pdf", "docx", "png", "md"];
+export declare const SHEET_TYPES: readonly ["xlsx", "pdf", "png", "csv", "md", "json"];
+export type DocType = (typeof DOC_TYPES)[number];
+export type SheetType = (typeof SHEET_TYPES)[number];
+/** What a 3D model renders to: its GLB, as `allyhub 3d-model` builds it. */
+export declare const MODEL_TYPES: readonly ["glb"];
+export type ModelType = (typeof MODEL_TYPES)[number];
+export interface ProjectExportOptions extends VersionExportOptions {
+    root: string;
+    /** Only these items (a piece, a doc or a sheet by id or place, a path into it, a folder of items); default every one. */
+    items?: readonly string[];
+    /** Only the combos matching one of these. */
+    combos?: readonly Combo[];
+    /** File types; default each kind's own (mp4, pdf; a doc's pdf; a sheet's xlsx). A type a kind does not have is skipped. */
+    types?: readonly string[];
+    /** The output folder. */
+    out: string;
+    /**
+     * A name for the versions' files: `<piece>/<name>.<ext>`, with what
+     * tells the versions apart before the extension when there are several
+     * (exportNames). Default each one's own (exportName).
+     */
+    name?: string;
+    gpu?: boolean;
+    consoleLimit?: number;
+    /** Make what the media index lacks first (default true). */
+    index?: boolean;
+    log?: (line: string) => void;
+}
+export interface ProjectExport {
+    out: string;
+    files: ExportedFile[];
+    failed: NotExported[];
+    /** The check's problems and what the pages found drawing. */
+    problems: Problem[];
+    console: ConsoleReport;
+    /** Videos the media index could not be made for, and why. */
+    unindexed: {
+        file: string;
+        error: string;
+    }[];
+}
+/** Every file the project's items make, as asked. */
+export declare function exportProject(o: ProjectExportOptions): Promise<ProjectExport>;
+/** Rows of a sheet drawn at most in a PNG: a picture past some 16,000 pixels is not made. */
+export declare const PNG_ROWS = 700;
+/** Columns of a sheet drawn at most in a PNG. */
+export declare const PNG_COLUMNS = 200;
+//# sourceMappingURL=export.d.ts.map