allyhub 0.5.0 → 0.7.0

package/dist/node_modules/@allyhub-next/sheet/dist/calc/remote.d.ts

@@ -0,0 +1,49 @@
+import type { Area } from "../address.js";
+import { Matrix, type Scalar } from "../values.js";
+/** A value as plain data. */
+export type WireScalar = number | string | boolean | null | {
+    error: string;
+};
+/** A formula cell as a pass left it. */
+export interface WireCell {
+    sheet: number;
+    row: number;
+    col: number;
+    value: WireScalar;
+    array?: {
+        rows: number;
+        cols: number;
+        data: WireScalar[];
+    };
+    spill?: Area;
+    blocked?: Area;
+}
+/** What a pass computed, since the last one was sent. */
+export interface Computed {
+    cells: WireCell[];
+    /** Each circular reference, as its cells. */
+    cycles: {
+        sheet: number;
+        row: number;
+        col: number;
+    }[][];
+    /** The rows filters hide, by sheet: every sheet that has some. */
+    hidden: {
+        sheet: number;
+        rows: number[];
+    }[];
+}
+export declare const toWire: (v: Scalar) => WireScalar;
+/** A value from plain data; an error code that is none is #VALUE!. */
+export declare function fromWire(v: WireScalar): Scalar;
+export declare const matrixToWire: (m: Matrix) => {
+    rows: number;
+    cols: number;
+    data: WireScalar[];
+};
+export declare const matrixFromWire: (m: {
+    rows: number;
+    cols: number;
+    data: WireScalar[];
+}) => Matrix;
+//# sourceMappingURL=remote.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/calc/remote.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{CellError as o,ERR as t,Matrix as e,errorOf as a}from"../values.js";export const toWire=r=>r instanceof o?{error:r.code}:r;export function fromWire(r){return r===null||typeof r!="object"?r:a(r.error)??t.VALUE}export const matrixToWire=r=>({rows:r.rows,cols:r.cols,data:r.data.map(toWire)}),matrixFromWire=r=>new e(r.rows,r.cols,r.data.map(fromWire));

package/dist/node_modules/@allyhub-next/sheet/dist/calc/server.d.ts

@@ -0,0 +1,82 @@
+import type { SheetFile } from "@allyhub-next/formats";
+import type { BookEdit } from "../edit.js";
+import type { GeneratedSheets } from "../generated.js";
+import { type CsvRows, type Workbook } from "../workbook.js";
+import { Calc } from "./engine.js";
+import type { Computed } from "./remote.js";
+/** A changed cell as plain data, which crosses postMessage. */
+export interface CellEdit {
+    /** The sheet's place in the workbook. */
+    sheet: number;
+    row: number;
+    col: number;
+    /** What it now holds, as typed; absent: empty. */
+    input?: string;
+    /** A table's calculated column whose formula it holds again. */
+    column?: {
+        table: string;
+        name: string;
+    };
+    /** sheet.yaml's key for it now; null: it has none. */
+    key?: string | null;
+    /** The CSV record of a table's row, now. */
+    record?: {
+        table: string;
+        index: number;
+        fields: string[];
+    };
+}
+/** An edit's changed cells, as plain data. */
+export declare function cellEditsOf(edit: BookEdit): CellEdit[];
+/**
+ * Changed cells put in a model and computed, or, for a replica, put in to
+ * wait for what a calculation elsewhere computes: sheet.yaml's keys, a
+ * table's records, the format a value typed implies, and the cell itself.
+ */
+export declare function applyCellEdits(wb: Workbook, calc: Calc, cells: readonly CellEdit[], file?: SheetFile): void;
+/** What a workbook is opened from. */
+export interface Opening {
+    file: SheetFile;
+    rows: readonly (readonly [string, CsvRows])[];
+    /** What RAND is seeded with. */
+    seed: string;
+    generated?: GeneratedSheets;
+    /** The scenario on show. */
+    scenario?: string;
+}
+/** A model made from what its files say, computing or a replica. */
+export declare function openWorkbook(o: Opening, mode?: {
+    report?: boolean;
+    replica?: boolean;
+}): {
+    workbook: Workbook;
+    calc: Calc;
+};
+/**
+ * What a calculation elsewhere is told. Each opening starts a generation;
+ * what is said of an earlier one is left unanswered, and its answers are
+ * dropped by the page.
+ */
+export type CalcRequest = ({
+    kind: "open";
+    generation: number;
+} & Opening) | {
+    kind: "cells";
+    generation: number;
+    cells: CellEdit[];
+    file?: SheetFile;
+} | {
+    kind: "recalculate";
+    generation: number;
+};
+export interface CalcReply {
+    generation: number;
+    computed: Computed;
+}
+/** The calculation a worker runs: a request in, what it computed out. */
+export declare class CalcServer {
+    private model;
+    private generation;
+    handle(r: CalcRequest): CalcReply | undefined;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/calc/server.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{applyScenario as p}from"../scenario.js";import{readTyped as h}from"../values.js";import{FormulaCell as m,SharedFormula as k,placeKey as y,workbookOf as b}from"../workbook.js";import{Calc as g,seededRandom as w}from"./engine.js";export function cellEditsOf(o){return o.cells.map(e=>{const r=e.column?e.sheet.tables.flatMap(t=>t.columns.map(i=>({table:t.name,col:i}))).find(t=>t.col.formula===e.column):void 0;return{sheet:e.sheet.index,row:e.row,col:e.col,...e.input===void 0?{}:{input:e.input},...r?{column:{table:r.table,name:r.col.name}}:{},...e.key===void 0?{}:{key:e.key},...e.record?{record:{table:e.record.table.name,index:e.record.index,fields:e.record.fields}}:{}}})}export function applyCellEdits(o,e,r,t){t&&o.respec(t);const i=[];for(const n of r){const l=o.sheets[n.sheet];if(!l)continue;const{row:d,col:a}=n,c=y(d,a);if(n.key===null?l.keys.delete(c):n.key!==void 0&&l.keys.set(c,n.key),n.record){const u=o.table(n.record.table);u&&(u.records[n.record.index]=n.record.fields)}l.implied.delete(c);const f=n.column?o.table(n.column.table)?.columns.find(u=>u.name===n.column?.name)?.formula:void 0;if(f){i.push({sheet:l,row:d,col:a,slot:new m(f,l,d,a)});continue}const s=h(n.input??"");s.format!==void 0&&l.implied.set(c,s.format),i.push({sheet:l,row:d,col:a,slot:s.formula===void 0?s.value??void 0:new m(new k(s.formula,d,a,{file:""}),l,d,a)})}e.change(i)}export function openWorkbook(o,e={}){const r=new Map(o.rows),t=b({file:o.file,rows:n=>r.get(n),generated:o.generated});o.scenario!==void 0&&p(t,o.scenario);const i=new g(t,{random:w(o.seed),...e}).calculate();return{workbook:t,calc:i}}export class CalcServer{model;generation=-1;handle(e){if(e.kind==="open")this.model=openWorkbook(e,{report:!0}),this.generation=e.generation;else{if(e.generation!==this.generation||!this.model)return;e.kind==="cells"?applyCellEdits(this.model.workbook,this.model.calc,e.cells,e.file):this.model.calc.recalculate()}return{generation:this.generation,computed:this.model.calc.takeComputed()}}}

package/dist/node_modules/@allyhub-next/sheet/dist/calc/types.d.ts

@@ -24,7 +24,12 @@ export declare class Lambda {
     readonly params: readonly string[];
     readonly body: Node;
     readonly frame: Frame;
-    constructor(params: readonly string[], body: Node, frame: Frame);
+    /**
+     * A function named alone (SUM in GROUPBY(…,SUM)), called with whatever
+     * it is given, as many arguments as the function takes.
+     */
+    readonly named: string | undefined;
+    constructor(params: readonly string[], body: Node, frame: Frame, named?: string);
 }
 /** A function's argument left empty. */
 export declare class Missing {

package/dist/node_modules/@allyhub-next/sheet/dist/calc/types.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-export class Reference{sheet;top;left;bottom;right;constructor(t,i,r,e,o){this.sheet=t,this.top=i,this.left=r,this.bottom=e,this.right=o}get rows(){return this.bottom-this.top+1}get cols(){return this.right-this.left+1}get single(){return this.top===this.bottom&&this.left===this.right}get key(){return`${String(this.sheet.index)}!${String(this.top)},${String(this.left)}:${String(this.bottom)},${String(this.right)}`}}export class Union{parts;constructor(t){this.parts=t}}export class Lambda{params;body;frame;constructor(t,i,r){this.params=t,this.body=i,this.frame=r}}export class Missing{missing=!0}export const MISSING=new Missing;
+export class Reference{sheet;top;left;bottom;right;constructor(t,i,r,e,o){this.sheet=t,this.top=i,this.left=r,this.bottom=e,this.right=o}get rows(){return this.bottom-this.top+1}get cols(){return this.right-this.left+1}get single(){return this.top===this.bottom&&this.left===this.right}get key(){return`${String(this.sheet.index)}!${String(this.top)},${String(this.left)}:${String(this.bottom)},${String(this.right)}`}}export class Union{parts;constructor(t){this.parts=t}}export class Lambda{params;body;frame;named;constructor(t,i,r,e){this.params=t,this.body=i,this.frame=r,this.named=e}}export class Missing{missing=!0}export const MISSING=new Missing;

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

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{chartDrawing as B,isRound as F,isScatter as R}from"@allyhub-next/chart";import{cellName as U,columnLetter as q,contains as I,rangeName as j,readAddress as V,readArea as W}from"./address.js";import{Reference as N,Union as G}from"./calc/types.js";import{shownValue as J}from"./format.js";import{sheetPrefix as D}from"./formula/print.js";import{CellError as K,Matrix as T}from"./values.js";export const SHEET_CHART_DEFAULTS={width:480,height:288,size:9,titleSize:14,ink:"#595959",pixelsToPoints:.75};const Q={dk1:"#000000",lt1:"#FFFFFF",dk2:"#44546A",lt2:"#E7E6E6",accent1:"#4472C4",accent2:"#ED7D31",accent3:"#A5A5A5",accent4:"#FFC000",accent5:"#5B9BD5",accent6:"#70AD47",hlink:"#0563C1",folHlink:"#954F72"},k=e=>typeof e=="string"?Q[e]??"#000000":e.rgb;function z(e,o,n){const{node:t}=n;if(!t)return[];const i=e.eval(t,{sheet:o,row:0,col:0,dr:0,dc:0}),s=u=>{const a=u.sheet,h=e.filtered(a),m=[],x=Math.min(u.bottom,a.lastRow),g=Math.min(u.right,a.columnsUsed-1);for(let c=u.top;c<=x;c++)if(!(h.has(c)||a.spec.rows?.[String(c+1)]?.hidden===!0))for(let l=u.left;l<=g;l++)a.spec.columns?.[q(l)]?.hidden!==!0&&m.push({value:e.value(a,c,l),sheet:a,row:c,col:l});return m};if(i instanceof N)return s(i);if(i instanceof G)return i.parts.flatMap(s);if(i instanceof T)return i.data.map(u=>({value:u}));const r=e.flat(i);return r instanceof T?r.data.map(u=>({value:u})):[{value:r}]}const E=e=>{if(e.value===null)return"";const o=e.sheet&&e.row!==void 0&&e.col!==void 0?e.sheet.lookAt(e.row,e.col).format:void 0;return J(e.value,o)};function H(e){return typeof e=="number"?Number.isFinite(e)?e:null:e===null||e instanceof K?null:typeof e=="boolean"&&e?1:0}const P=e=>e&&{...e.min===void 0?{}:{minimum_scale:e.min},...e.max===void 0?{}:{maximum_scale:e.max},...e.major===void 0?{}:{major_unit:e.major},...e.gridlines===void 0?{}:{has_major_gridlines:e.gridlines},...e.visible===void 0?{}:{visible:e.visible},...e.format===void 0?{}:{number_format:e.format},...e.reverse===void 0?{}:{reverse_order:e.reverse},...e.title===void 0||e.title===""?{}:{title:e.title}},C=e=>e===void 0?void 0:{rgb:e};function X(e){if(e===void 0||e===!1)return;if(e===!0)return{show_value:!0};const o=typeof e.color=="string"?C(e.color):void 0;return{...e.value===void 0?{}:{show_value:e.value},...e.percentage===void 0?{}:{show_percentage:e.percentage},...e.category===void 0?{}:{show_category_name:e.category},...e.series===void 0?{}:{show_series_name:e.series},...e.format===void 0?{}:{number_format:e.format},...e.position===void 0?{}:{position:e.position},...e.size===void 0?{}:{size:e.size},...o?{color:o}:{}}}const Y=e=>{const o=e.find(n=>n.sheet);return o?.sheet&&o.row!==void 0&&o.col!==void 0?o.sheet.lookAt(o.row,o.col).format:void 0};export function chartDef(e,o,n){const{spec:t}=n,i=R(t.type),s=n.categories?z(e,o,n.categories):void 0,r=n.series.map((l,b)=>{const p=t.series[b],v=z(e,o,l.values),$=l.name?z(e,o,l.name)[0]:void 0,A=l.x?z(e,o,l.x):i?s:void 0,w=p.format??Y(v),y=C(p.color);return{name:($?E($):p.name)??`Series${String(b+1)}`,values:v.map(f=>H(f.value)),...A?{x:A.map(f=>H(f.value))}:{},...w===void 0?{}:{number_format:w},...y?{color:y}:{},...p.smooth===void 0?{}:{smooth:p.smooth},...p.line_width===void 0?{}:{line_width:p.line_width},...p.marker_size===void 0?{}:{marker_size:p.marker_size}}}),u=Math.max(0,...r.map(l=>l.values.length)),a=s?s.map(E):Array.from({length:u},(l,b)=>String(b+1)),h=n.title?z(e,o,n.title)[0]:void 0,m=h?E(h):t.title,x=X(t.labels),g=P(t.value_axis),c=P(t.category_axis);return{type:t.type,categories:a,series:r,...m===void 0||m===""?{}:{title:m},...t.legend===void 0?{}:{legend:t.legend},...x?{labels:x}:{},...t.gap_width===void 0?{}:{gap_width:t.gap_width},...t.overlap===void 0?{}:{overlap:t.overlap},...t.vary_by_categories===void 0?{}:{vary_by_categories:t.vary_by_categories},...t.hole_size===void 0?{}:{hole_size:t.hole_size},...g?{value_axis:g}:{},...c?{category_axis:c}:{},font_size:t.size??SHEET_CHART_DEFAULTS.size,title_size:t.title_size??SHEET_CHART_DEFAULTS.titleSize,font_color:C(t.color)??{rgb:SHEET_CHART_DEFAULTS.ink}}}export const chartSize=e=>({width:e.width??SHEET_CHART_DEFAULTS.width,height:e.height??SHEET_CHART_DEFAULTS.height});const Z={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"},O=e=>e.replace(/[&<>"]/gu,o=>Z[o]??o),d=e=>String(Number(e.toFixed(3)));function L(e){const o=e.fill===void 0?"none":k(e.fill),n=e.width>0?k(e.color):"none";return`<path d="${O(e.d)}" fill="${o}" stroke="${n}" stroke-width="${d(e.width)}" stroke-linejoin="round"/>`}function ee(e){const o=[];for(const n of[...e.grid,...e.shapes])o.push(L(n));for(const n of[...e.boxes,...e.keys])o.push(`<rect x="${d(n.x)}" y="${d(n.y)}" width="${d(n.width)}" height="${d(n.height)}" fill="${k(n.color)}"/>`);for(const n of[...e.axes,...e.lines])o.push(L(n));for(const n of e.dots)o.push(`<circle cx="${d(n.x)}" cy="${d(n.y)}" r="${d(n.r)}" fill="${k(n.color)}"/>`);for(const n of e.words){const t=n.rotate===void 0?"":` transform="rotate(${d(n.rotate)} ${d(n.x)} ${d(n.y)})"`;o.push(`<text x="${d(n.x)}" y="${d(n.y)}" font-size="${d(n.size)}" text-anchor="${n.anchor}" dominant-baseline="central" fill="${k(n.color)}"${t}>${O(n.text)}</text>`)}return o.join("")}export function chartSvg(e,o,n,t={}){const i=SHEET_CHART_DEFAULTS.pixelsToPoints,s=o*i,r=n*i,u=t.font??"Carlito, Calibri, Arial, sans-serif",a=t.paper??"#FFFFFF",h=t.edge??"#D9D9D9";return`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${d(s)} ${d(r)}" width="${d(o)}" height="${d(n)}" font-family="${O(u)}"><rect x="0.375" y="0.375" width="${d(s-.75)}" height="${d(r-.75)}" fill="${a}" stroke="${h==="none"?"none":h}" stroke-width="0.75"/>${ee(B(e,s,r))}</svg>`}export function chartAfter(e,o){const n=i=>i?.startsWith("=")===!0?o(i):i,t=n(e.title);return{...e,...t===void 0?{}:{title:t},...e.categories===void 0?{}:{categories:o(e.categories)},series:e.series.map(i=>{const s=n(i.name);return{...i,values:o(i.values),...i.x===void 0?{}:{x:o(i.x)},...s===void 0?{}:{name:s}}})}}function te(e,o,n,t){if(t){const i=t.data;if(n.top===i.top&&n.bottom===i.bottom&&n.left===n.right){const s=t.columns[n.left-t.at.col];if(s)return`${t.name}[${s.name}]`}}return`${o===e?"":D(o.name)}${j(n)}`}const ne=(e,o,n,t)=>typeof e.value(o,n,t)=="number",oe=(e,o,n,t)=>{const i=e.value(o,n,t);if(typeof i=="string")return!0;const s=o.lookAt(n,t).format;return typeof i=="number"&&s!==void 0&&/[ymd]/iu.test(s)};export function chartOfRange(e,o,n,t,i){const s=t.bottom-t.top+1,r=t.right-t.left+1,u=o.tables.find(f=>I(f.area,t.top,t.left)),a=f=>te(n,o,f,u),h=R(i),m=s>1&&Array.from({length:r},(f,_)=>t.left+_).some(f=>!ne(e,o,t.top,f)),x=r>1&&(h||Array.from({length:s-(m?1:0)},(f,_)=>_).every(f=>oe(e,o,t.top+(m?1:0)+f,t.left)||e.value(o,t.top+(m?1:0)+f,t.left)===null)),g=t.top+(m?1:0),c=t.left+(x?1:0);if(g>t.bottom||c>t.right)return;const l=!h&&!F(i)&&t.right-c>t.bottom-g,b=[],p=(f,_)=>e.value(o,f,_)===null?void 0:`=${o===n?"":D(o.name)}${U({row:f,col:_})}`,v=l?{first:g,last:t.bottom}:{first:c,last:t.right};for(let f=v.first;f<=v.last;f++){const _=l?{top:f,left:c,bottom:f,right:t.right}:{top:g,left:f,bottom:t.bottom,right:f},M=l?x?p(f,t.left):void 0:m?p(t.top,f):void 0;b.push({values:a(_),...M===void 0?{}:{name:M}})}const $=l?m?{top:t.top,left:c,bottom:t.top,right:t.right}:void 0:x?{top:g,left:t.left,bottom:t.bottom,right:t.left}:void 0,A=b.length>1&&!F(i),w=F(i)?b.slice(0,1):b,y=w.length===1?w[0]?.name:void 0;return{type:i,...$?{categories:a($)}:{},series:w,...A||F(i)?{legend:"bottom"}:{},...y===void 0?{}:{title:y}}}function S(e,o,n){if(!n?.node)return;const t=e.eval(n.node,{sheet:o,row:0,col:0,dr:0,dc:0});return t instanceof N?{sheet:t.sheet,area:{top:t.top,left:t.left,bottom:Math.min(t.bottom,Math.max(t.top,t.sheet.lastRow)),right:t.right}}:void 0}export function chartDataRange(e,o,n){const t=[S(e,o,n.categories),...n.series.flatMap(r=>[S(e,o,r.values),S(e,o,r.name),S(e,o,r.x)])].filter(r=>r!==void 0),i=t[0];if(!i||t.some(r=>r.sheet!==i.sheet))return;const s={top:Math.min(...t.map(r=>r.area.top)),left:Math.min(...t.map(r=>r.area.left)),bottom:Math.max(...t.map(r=>r.area.bottom)),right:Math.max(...t.map(r=>r.area.right))};return`${i.sheet===o?"":D(i.sheet.name)}${j(s)}`}export function readDataRange(e,o,n){const t=n.lastIndexOf("!"),i=t<0?void 0:n.slice(0,t).replace(/^'|'$/gu,""),s=i===void 0?o:e.wb.sheet(i.replaceAll("''","'")),r=W(n.slice(t+1).replaceAll("$",""));return s&&r?{sheet:s,area:r}:void 0}export function chartPlace(e,o,n){const t=V(e.at)??{row:0,col:0};return{left:n(t.col)+(e.x??0),top:o(t.row)+(e.y??0),...chartSize(e)}}
+import{chartDrawing as B,colorRgb as U,isRound as F,isScatter as R}from"@allyhub-next/chart";import{cellName as q,columnLetter as I,contains as V,rangeName as j,readAddress as W,readArea as G}from"./address.js";import{Reference as N,Union as J}from"./calc/types.js";import{shownValue as K}from"./format.js";import{sheetPrefix as D}from"./formula/print.js";import{CellError as Q,Matrix as T}from"./values.js";export const SHEET_CHART_DEFAULTS={width:480,height:288,size:9,titleSize:14,ink:"#595959",pixelsToPoints:.75};const X={dk1:"#000000",lt1:"#FFFFFF",dk2:"#44546A",lt2:"#E7E6E6",accent1:"#4472C4",accent2:"#ED7D31",accent3:"#A5A5A5",accent4:"#FFC000",accent5:"#5B9BD5",accent6:"#70AD47",hlink:"#0563C1",folHlink:"#954F72"},k=e=>U(e,X);function z(e,o,n){const{node:t}=n;if(!t)return[];const i=e.eval(t,{sheet:o,row:0,col:0,dr:0,dc:0}),s=u=>{const a=u.sheet,p=e.filtered(a),m=[],x=Math.min(u.bottom,a.lastRow),g=Math.min(u.right,a.columnsUsed-1);for(let c=u.top;c<=x;c++)if(!(p.has(c)||a.spec.rows?.[String(c+1)]?.hidden===!0))for(let d=u.left;d<=g;d++)a.spec.columns?.[I(d)]?.hidden!==!0&&m.push({value:e.value(a,c,d),sheet:a,row:c,col:d});return m};if(i instanceof N)return s(i);if(i instanceof J)return i.parts.flatMap(s);if(i instanceof T)return i.data.map(u=>({value:u}));const r=e.flat(i);return r instanceof T?r.data.map(u=>({value:u})):[{value:r}]}const E=e=>{if(e.value===null)return"";const o=e.sheet&&e.row!==void 0&&e.col!==void 0?e.sheet.lookAt(e.row,e.col).format:void 0;return K(e.value,o)};function H(e){return typeof e=="number"?Number.isFinite(e)?e:null:e===null||e instanceof Q?null:typeof e=="boolean"&&e?1:0}const P=e=>e&&{...e.min===void 0?{}:{minimum_scale:e.min},...e.max===void 0?{}:{maximum_scale:e.max},...e.major===void 0?{}:{major_unit:e.major},...e.gridlines===void 0?{}:{has_major_gridlines:e.gridlines},...e.visible===void 0?{}:{visible:e.visible},...e.format===void 0?{}:{number_format:e.format},...e.reverse===void 0?{}:{reverse_order:e.reverse},...e.title===void 0||e.title===""?{}:{title:e.title}},C=e=>e===void 0?void 0:{rgb:e};function Y(e){if(e===void 0||e===!1)return;if(e===!0)return{show_value:!0};const o=typeof e.color=="string"?C(e.color):void 0;return{...e.value===void 0?{}:{show_value:e.value},...e.percentage===void 0?{}:{show_percentage:e.percentage},...e.category===void 0?{}:{show_category_name:e.category},...e.series===void 0?{}:{show_series_name:e.series},...e.format===void 0?{}:{number_format:e.format},...e.position===void 0?{}:{position:e.position},...e.size===void 0?{}:{size:e.size},...o?{color:o}:{}}}const Z=e=>{const o=e.find(n=>n.sheet);return o?.sheet&&o.row!==void 0&&o.col!==void 0?o.sheet.lookAt(o.row,o.col).format:void 0};export function chartDef(e,o,n){const{spec:t}=n,i=R(t.type),s=n.categories?z(e,o,n.categories):void 0,r=n.series.map((d,b)=>{const h=t.series[b],v=z(e,o,d.values),$=d.name?z(e,o,d.name)[0]:void 0,A=d.x?z(e,o,d.x):i?s:void 0,w=h.format??Z(v),y=C(h.color);return{name:($?E($):h.name)??`Series${String(b+1)}`,values:v.map(f=>H(f.value)),...A?{x:A.map(f=>H(f.value))}:{},...w===void 0?{}:{number_format:w},...y?{color:y}:{},...h.smooth===void 0?{}:{smooth:h.smooth},...h.line_width===void 0?{}:{line_width:h.line_width},...h.marker_size===void 0?{}:{marker_size:h.marker_size}}}),u=Math.max(0,...r.map(d=>d.values.length)),a=s?s.map(E):Array.from({length:u},(d,b)=>String(b+1)),p=n.title?z(e,o,n.title)[0]:void 0,m=p?E(p):t.title,x=Y(t.labels),g=P(t.value_axis),c=P(t.category_axis);return{type:t.type,categories:a,series:r,...m===void 0||m===""?{}:{title:m},...t.legend===void 0?{}:{legend:t.legend},...x?{labels:x}:{},...t.gap_width===void 0?{}:{gap_width:t.gap_width},...t.overlap===void 0?{}:{overlap:t.overlap},...t.vary_by_categories===void 0?{}:{vary_by_categories:t.vary_by_categories},...t.hole_size===void 0?{}:{hole_size:t.hole_size},...g?{value_axis:g}:{},...c?{category_axis:c}:{},font_size:t.size??SHEET_CHART_DEFAULTS.size,title_size:t.title_size??SHEET_CHART_DEFAULTS.titleSize,font_color:C(t.color)??{rgb:SHEET_CHART_DEFAULTS.ink}}}export const chartSize=e=>({width:e.width??SHEET_CHART_DEFAULTS.width,height:e.height??SHEET_CHART_DEFAULTS.height});const ee={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"},O=e=>e.replace(/[&<>"]/gu,o=>ee[o]??o),l=e=>String(Number(e.toFixed(3)));function L(e){const o=e.fill===void 0?"none":k(e.fill),n=e.width>0?k(e.color):"none";return`<path d="${O(e.d)}" fill="${o}" stroke="${n}" stroke-width="${l(e.width)}" stroke-linejoin="round"/>`}function te(e){const o=[];for(const n of[...e.grid,...e.shapes])o.push(L(n));for(const n of[...e.boxes,...e.keys])o.push(`<rect x="${l(n.x)}" y="${l(n.y)}" width="${l(n.width)}" height="${l(n.height)}" fill="${k(n.color)}"/>`);for(const n of[...e.axes,...e.lines])o.push(L(n));for(const n of e.dots)o.push(`<circle cx="${l(n.x)}" cy="${l(n.y)}" r="${l(n.r)}" fill="${k(n.color)}"/>`);for(const n of e.words){const t=n.rotate===void 0?"":` transform="rotate(${l(n.rotate)} ${l(n.x)} ${l(n.y)})"`;o.push(`<text x="${l(n.x)}" y="${l(n.y)}" font-size="${l(n.size)}" text-anchor="${n.anchor}" dominant-baseline="central" fill="${k(n.color)}"${t}>${O(n.text)}</text>`)}return o.join("")}export function chartSvg(e,o,n,t={}){const i=SHEET_CHART_DEFAULTS.pixelsToPoints,s=o*i,r=n*i,u=t.font??"Carlito, Calibri, Arial, sans-serif",a=t.paper??"#FFFFFF",p=t.edge??"#D9D9D9";return`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${l(s)} ${l(r)}" width="${l(o)}" height="${l(n)}" font-family="${O(u)}"><rect x="0.375" y="0.375" width="${l(s-.75)}" height="${l(r-.75)}" fill="${a}" stroke="${p==="none"?"none":p}" stroke-width="0.75"/>${te(B(e,s,r))}</svg>`}export function chartAfter(e,o){const n=i=>i?.startsWith("=")===!0?o(i):i,t=n(e.title);return{...e,...t===void 0?{}:{title:t},...e.categories===void 0?{}:{categories:o(e.categories)},series:e.series.map(i=>{const s=n(i.name);return{...i,values:o(i.values),...i.x===void 0?{}:{x:o(i.x)},...s===void 0?{}:{name:s}}})}}function ne(e,o,n,t){if(t){const i=t.data;if(n.top===i.top&&n.bottom===i.bottom&&n.left===n.right){const s=t.columns[n.left-t.at.col];if(s)return`${t.name}[${s.name}]`}}return`${o===e?"":D(o.name)}${j(n)}`}const oe=(e,o,n,t)=>typeof e.value(o,n,t)=="number",ie=(e,o,n,t)=>{const i=e.value(o,n,t);if(typeof i=="string")return!0;const s=o.lookAt(n,t).format;return typeof i=="number"&&s!==void 0&&/[ymd]/iu.test(s)};export function chartOfRange(e,o,n,t,i){const s=t.bottom-t.top+1,r=t.right-t.left+1,u=o.tables.find(f=>V(f.area,t.top,t.left)),a=f=>ne(n,o,f,u),p=R(i),m=s>1&&Array.from({length:r},(f,_)=>t.left+_).some(f=>!oe(e,o,t.top,f)),x=r>1&&(p||Array.from({length:s-(m?1:0)},(f,_)=>_).every(f=>ie(e,o,t.top+(m?1:0)+f,t.left)||e.value(o,t.top+(m?1:0)+f,t.left)===null)),g=t.top+(m?1:0),c=t.left+(x?1:0);if(g>t.bottom||c>t.right)return;const d=!p&&!F(i)&&t.right-c>t.bottom-g,b=[],h=(f,_)=>e.value(o,f,_)===null?void 0:`=${o===n?"":D(o.name)}${q({row:f,col:_})}`,v=d?{first:g,last:t.bottom}:{first:c,last:t.right};for(let f=v.first;f<=v.last;f++){const _=d?{top:f,left:c,bottom:f,right:t.right}:{top:g,left:f,bottom:t.bottom,right:f},M=d?x?h(f,t.left):void 0:m?h(t.top,f):void 0;b.push({values:a(_),...M===void 0?{}:{name:M}})}const $=d?m?{top:t.top,left:c,bottom:t.top,right:t.right}:void 0:x?{top:g,left:t.left,bottom:t.bottom,right:t.left}:void 0,A=b.length>1&&!F(i),w=F(i)?b.slice(0,1):b,y=w.length===1?w[0]?.name:void 0;return{type:i,...$?{categories:a($)}:{},series:w,...A||F(i)?{legend:"bottom"}:{},...y===void 0?{}:{title:y}}}function S(e,o,n){if(!n?.node)return;const t=e.eval(n.node,{sheet:o,row:0,col:0,dr:0,dc:0});return t instanceof N?{sheet:t.sheet,area:{top:t.top,left:t.left,bottom:Math.min(t.bottom,Math.max(t.top,t.sheet.lastRow)),right:t.right}}:void 0}export function chartDataRange(e,o,n){const t=[S(e,o,n.categories),...n.series.flatMap(r=>[S(e,o,r.values),S(e,o,r.name),S(e,o,r.x)])].filter(r=>r!==void 0),i=t[0];if(!i||t.some(r=>r.sheet!==i.sheet))return;const s={top:Math.min(...t.map(r=>r.area.top)),left:Math.min(...t.map(r=>r.area.left)),bottom:Math.max(...t.map(r=>r.area.bottom)),right:Math.max(...t.map(r=>r.area.right))};return`${i.sheet===o?"":D(i.sheet.name)}${j(s)}`}export function readDataRange(e,o,n){const t=n.lastIndexOf("!"),i=t<0?void 0:n.slice(0,t).replace(/^'|'$/gu,""),s=i===void 0?o:e.wb.sheet(i.replaceAll("''","'")),r=G(n.slice(t+1).replaceAll("$",""));return s&&r?{sheet:s,area:r}:void 0}export function chartPlace(e,o,n){const t=W(e.at)??{row:0,col:0};return{left:n(t.col)+(e.x??0),top:o(t.row)+(e.y??0),...chartSize(e)}}

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

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{cellName as d,rangeName as b}from"./address.js";import{ERR as p,Matrix as w,CellError as m}from"./values.js";import{analyse as $}from"./calc/analyse.js";import{Calc as k}from"./calc/engine.js";import{toBool as g}from"./calc/coerce.js";import{ENTRY as l}from"./file.js";import{fileCells as x}from"./files.js";import{applyScenario as y}from"./scenario.js";import{readWorkbook as S}from"./workbook.js";class O{problems;wb;lineOf;constructor(t,e){this.wb=t,this.problems=[...e.problems],this.lineOf=e.lineOf}at(t,e){const o=t.line??(t.path===void 0?void 0:this.lineOf(t.path));this.problems.push({file:t.file===""?l:t.file,...o===void 0?{}:{line:o},message:e})}formulas(){const t=new Map;for(const e of this.wb.sheets){for(const o of e.formulas)t.set(o.shared,e);for(const o of e.tables)for(const n of o.columns)n.formula&&t.set(n.formula,e);for(const o of e.conditions)for(const n of o.formulas)t.set(n,e);for(const o of e.validations)for(const n of o.formulas)n&&t.set(n,e);for(const o of e.charts){o.title&&t.set(o.title,e),o.categories&&t.set(o.categories,e);for(const n of o.series)t.set(n.values,e),n.x&&t.set(n.x,e),n.name&&t.set(n.name,e)}}for(const e of this.wb.names.values())e.formula&&t.set(e.formula,void 0);for(const e of this.wb.checks)t.set(e.formula,void 0);return t}formulaProblems(){for(const[t,e]of this.formulas()){const o=s=>{this.at(t.source,`${t.text}: ${s}`)};if(t.error){o(`does not parse: ${t.error.message}`);continue}const n=$(this.wb,t);t.analysis=n;for(const s of new Set(n.unknownNames))o(`there is no name ${s}`);for(const s of new Set(n.unknownFunctions))o(`there is no function ${s}`);for(const s of n.arguments)o(`${s.name} takes ${s.min===s.max?String(s.min):`${String(s.min)} to ${String(s.max)}`} arguments and is given ${String(s.given)}`);for(const s of n.reads){if(s.kind==="ref"){for(const r of[s.sheet,s.lastSheet])r!==void 0&&!this.wb.sheet(r)&&o(`there is no sheet ${r}`);continue}const f=s.table===void 0?e?.tableAt(t.row,t.col):this.wb.table(s.table);if(!f){o(s.table===void 0?"a column named with no table, outside a table":`there is no table ${s.table}`);continue}for(const r of s.columns)f.column(r)||o(`table ${f.name} has no column ${r}; it has ${f.columns.map(c=>c.name).join(", ")}`)}}}cycles(t){for(const e of t.cycles){const o=e.reduce((r,c,h)=>{const a=e[r];return a&&(c.row<a.row||c.row===a.row&&c.col<a.col)?h:r},0),n=[...e.slice(o),...e.slice(0,o)],s=n[0];if(!s)continue;const f=[...n,s].map(r=>`${r.sheet.name}!${d(r)}`).join(" → ");this.at(s.shared.source,`a circular reference: ${f}`)}}scenarios(){const{scenarios:t}=this.wb.file;for(const[e,o]of Object.entries(t??{}))for(const n of Object.keys(o))this.wb.name(n)||this.at({file:l,path:["scenarios",e,n]},`scenario ${e} sets ${n}, and there is no name ${n}`)}files(t,e){for(const o of this.wb.sheets)for(const{row:n,col:s,paths:f}of x(o,t))for(const r of f)e(r)||this.at(this.wb.sourceOf(o,n,s)??{file:l},`${placeName(o,n,s)} names ${r}, which is not there`)}checks(t){const e=this.wb.sheets[0];if(e)for(const o of this.wb.checks){if(!o.formula.node)continue;const n=t.evaluate(o.formula,e),s=u(n);s!==void 0&&this.at(o.source,`check "${o.name}" does not hold: ${o.formula.text} is ${s}`)}}}function u(i){if(i instanceof w){for(const e of i.data){const o=u(e);if(o!==void 0)return o}return}if(i instanceof m)return i.code;const t=g(i);return t instanceof m?p.VALUE.code:t?void 0:"FALSE"}export function checkWorkbook(i,t={}){const e=S(i),{workbook:o}=e;if(!o)return{problems:e.problems};const n=new O(o,e);n.scenarios(),t.scenario!==void 0&&y(o,t.scenario);const s=new k(o,t);return n.formulaProblems(),s.calculate(),n.cycles(s),n.checks(s),i.exists&&n.files(s,i.exists),{workbook:o,calc:s,problems:n.problems}}export const placeName=(i,t,e)=>`${i.name}!${b({top:t,left:e,bottom:t,right:e})}`;
+import{cellName as d,rangeName as b}from"./address.js";import{ERR as p,Matrix as $,CellError as m}from"./values.js";import{analyse as w}from"./calc/analyse.js";import{Calc as g}from"./calc/engine.js";import{toBool as k}from"./calc/coerce.js";import{ENTRY as l}from"./file.js";import{fileCells as S}from"./files.js";import{applyScenario as x}from"./scenario.js";import{readWorkbook as v}from"./workbook.js";class y{problems;wb;lineOf;constructor(t,o){this.wb=t,this.problems=[...o.problems],this.lineOf=o.lineOf}at(t,o){const e=t.line??(t.path===void 0?void 0:this.lineOf(t.path));this.problems.push({file:t.file===""?l:t.file,...e===void 0?{}:{line:e},message:o})}formulas(){const t=new Map;for(const o of this.wb.sheets){for(const e of o.formulas)t.set(e.shared,o);for(const e of o.names.values())e.formula&&t.set(e.formula,o);for(const e of o.tables)for(const s of e.columns)s.formula&&t.set(s.formula,o);for(const e of o.conditions)for(const s of e.formulas)t.set(s,o);for(const e of o.validations)for(const s of e.formulas)s&&t.set(s,o);for(const e of o.charts){e.title&&t.set(e.title,o),e.categories&&t.set(e.categories,o);for(const s of e.series)t.set(s.values,o),s.x&&t.set(s.x,o),s.name&&t.set(s.name,o)}}for(const o of this.wb.names.values())o.formula&&t.set(o.formula,void 0);for(const o of this.wb.checks)t.set(o.formula,void 0);return t}formulaProblems(){for(const[t,o]of this.formulas()){const e=n=>{this.at(t.source,`${t.text}: ${n}`)};if(t.error){e(`does not parse: ${t.error.message}`);continue}const s=w(this.wb,t,o);t.analysis=s;for(const n of new Set(s.unknownNames))e(`there is no name ${n}`);for(const n of new Set(s.unknownFunctions))e(`there is no function ${n}`);for(const n of s.arguments)e(n.group===void 0?`${n.name} takes ${n.min===n.max?String(n.min):`${String(n.min)} to ${String(n.max)}`} arguments and is given ${String(n.given)}`:`${n.name} takes its last arguments in groups of ${String(n.group)} and is given ${String(n.given)}, which leaves one short`);for(const n of s.reads){if(n.kind==="ref"){for(const r of[n.sheet,n.lastSheet])r!==void 0&&!this.wb.sheet(r)&&e(`there is no sheet ${r}`);continue}const f=n.table===void 0?o?.tableAt(t.row,t.col):this.wb.table(n.table);if(!f){e(n.table===void 0?"a column named with no table, outside a table":`there is no table ${n.table}`);continue}for(const r of n.columns)f.column(r)||e(`table ${f.name} has no column ${r}; it has ${f.columns.map(a=>a.name).join(", ")}`)}}}cycles(t){for(const o of t.cycles){const e=o.reduce((r,a,h)=>{const c=o[r];return c&&(a.row<c.row||a.row===c.row&&a.col<c.col)?h:r},0),s=[...o.slice(e),...o.slice(0,e)],n=s[0];if(!n)continue;const f=[...s,n].map(r=>`${r.sheet.name}!${d(r)}`).join(" → ");this.at(n.shared.source,`a circular reference: ${f}`)}}scenarios(){const{scenarios:t}=this.wb.file;for(const[o,e]of Object.entries(t??{}))for(const s of Object.keys(e))this.wb.name(s)||this.at({file:l,path:["scenarios",o,s]},`scenario ${o} sets ${s}, and there is no name ${s}`)}files(t,o){for(const e of this.wb.sheets)for(const{row:s,col:n,paths:f}of S(e,t))for(const r of f)o(r)||this.at(this.wb.sourceOf(e,s,n)??{file:l},`${placeName(e,s,n)} names ${r}, which is not there`);for(const e of this.wb.sheets)for(const s of e.spec.pictures??[])o(s.file)||this.at({file:l},`${e.name} has a picture ${s.file}, which is not there`)}checks(t){const o=this.wb.sheets[0];if(o)for(const e of this.wb.checks){if(!e.formula.node)continue;const s=t.evaluate(e.formula,o),n=u(s);n!==void 0&&this.at(e.source,`check "${e.name}" does not hold: ${e.formula.text} is ${n}`)}}}function u(i){if(i instanceof $){for(const o of i.data){const e=u(o);if(e!==void 0)return e}return}if(i instanceof m)return i.code;const t=k(i);return t instanceof m?p.VALUE.code:t?void 0:"FALSE"}export function checkWorkbook(i,t={}){const o=v(i),{workbook:e}=o;if(!e)return{problems:o.problems};const s=new y(e,o);s.scenarios(),t.scenario!==void 0&&x(e,t.scenario);const n=new g(e,t);return s.formulaProblems(),n.calculate(),s.cycles(n),s.checks(n),i.exists&&s.files(n,i.exists),{workbook:e,calc:n,problems:s.problems}}export const placeName=(i,t,o)=>`${i.name}!${b({top:t,left:o,bottom:t,right:o})}`;

package/dist/node_modules/@allyhub-next/sheet/dist/diff.d.ts

@@ -39,14 +39,29 @@ export interface TableDiff {
     columnsAdded: string[];
     columnsRemoved: string[];
 }
+/** What changed outside the cells: how a sheet prints, its notes, links, rules, pictures, sizes. */
+export interface PartChange {
+    /** The sheet it is of; absent: the workbook's. */
+    sheet?: string;
+    /** Which part: `print`, `notes`, `links`, `validations`, `conditional`, `pictures`, `protect`, `freeze`, `merges`, `filter`, `columns`, `rows`, `view`, `title`, `hidden names`. */
+    part: string;
+    /** Which of it: a note's or a link's cell, a column's letter, a row's number. */
+    key?: string;
+    /** What it was and is, as JSON (a note's or a link's text as it is); absent: none. */
+    was?: string;
+    now?: string;
+}
 export interface WorkbookDiff {
     sheets: SheetDiff[];
     tables: TableDiff[];
+    /** The workbook's names, and each sheet's own as `Sheet!name`. */
     names: {
         name: string;
         was?: string;
         now?: string;
     }[];
+    /** What changed outside the cells. */
+    parts: PartChange[];
     /** Sheets whose charts differ. */
     charts: string[];
     cells: CellChange[];

package/dist/node_modules/@allyhub-next/sheet/dist/diff.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{cellName as N}from"./address.js";import{dataValue as D,shownValue as b}from"./format.js";import{CellError as y}from"./values.js";import{FormulaCell as M}from"./workbook.js";export const DIFF_DEFAULTS={tolerance:0};const J=(a,e)=>{if(a!=="written")return e};function U(a){const{row:e,col:t}=a;return JSON.stringify(a.moved,(s,c)=>(s==="col"||s==="col2"||s==="row"||s==="row2")&&typeof c=="object"&&c!==null&&c.abs===!1?[c.index-(s.startsWith("col")?t:e)]:J(s,c))}function j(a,e,t){if(a===e)return!0;if(typeof a=="number"&&typeof e=="number"){const s=Math.max(Math.abs(a),Math.abs(e));return Math.abs(a-e)<=t*s}return a instanceof y&&e instanceof y?a.code===e.code:!1}function A(a,e,t,s){const c=a.value(e,t,s),r=e.lookAt(t,s).format,o=e.at(t,s);return{cell:N({row:t,col:s}),value:D(c,r),shown:b(c,r),...o instanceof M?{formula:o.text}:{}}}const S=(a,e,t)=>{const s=a.at(e,t);return s instanceof M&&s.shared.node?U(s):void 0},O=(a,e,t)=>a.at(e,t)!==void 0||a.spillAt(e,t)!==void 0;class C{out={sheets:[],tables:[],names:[],charts:[],cells:[],counts:{value:0,formula:0,both:0,added:0,removed:0}};a;b;tolerance;constructor(e,t,s){this.a=e,this.b=t,this.tolerance=s}push(e){this.out.counts[e.kind]+=1,this.out.cells.push(e)}cell(e,t,s){const c=this.a.value(e.sheet,e.row,e.col),r=this.b.value(t.sheet,t.row,t.col),o=O(e.sheet,e.row,e.col),i=O(t.sheet,t.row,t.col);if(!o&&!i)return;const u=t.sheet.name,l=()=>({was:A(this.a,e.sheet,e.row,e.col),now:A(this.b,t.sheet,t.row,t.col)});if(!o){this.push({...s,sheet:u,kind:"added",now:l().now});return}if(!i){this.push({...s,sheet:u,kind:"removed",was:l().was});return}const h=j(c,r,this.tolerance),w=S(e.sheet,e.row,e.col)===S(t.sheet,t.row,t.col);if(h&&w)return;const v=w?"value":h?"formula":"both";this.push({...s,sheet:u,kind:v,...l()})}loose(e,t){const s=(o,i,u)=>o.tableAt(i,u)!==void 0,c=Math.max(e.lastRow,t.lastRow),r=Math.max(e.columnsUsed,t.columnsUsed)-1;for(let o=0;o<=r;o++){const[i,u]=E(e,t,o,c);for(let l=i;l<=u;l++)s(e,l,o)||s(t,l,o)||this.cell({sheet:e,row:l,col:o},{sheet:t,row:l,col:o},{})}}table(e,t){const s=t.spec.key??e.spec.key,c=e.column(s??""),r=t.column(s??""),o=(n,f,p)=>{const d=new Map;if(p){for(let m=0;m<n.rows;m++){const F=f.value(n.sheet,n.at.row+1+m,n.at.col+p.index),x=b(F);if(x===""||d.has(x))return;d.set(x,m)}return d}},i=o(e,this.a,c),u=o(t,this.b,r),l=i&&u?{from:i,to:u}:void 0,h=[];if(l){for(const[n,f]of l.from)h.push([f,l.to.get(n),n]);for(const[n,f]of l.to)l.from.has(n)||h.push([void 0,f,n])}else for(let n=0;n<Math.max(e.rows,t.rows);n++)h.push([n<e.rows?n:void 0,n<t.rows?n:void 0,String(n+1)]);const w=[],v=[],R=t.columns.filter(n=>e.column(n.name));for(const[n,f,p]of h)if(n===void 0)w.push(p);else if(f===void 0)v.push(p);else for(const d of R){const m=e.column(d.name);m&&this.cell({sheet:e.sheet,row:e.at.row+1+n,col:e.at.col+m.index},{sheet:t.sheet,row:t.at.row+1+f,col:t.at.col+d.index},{table:t.name,column:d.name,...l?{key:p}:{}})}const k=t.columns.filter(n=>!e.column(n.name)).map(n=>n.name),g=e.columns.filter(n=>!t.column(n.name)).map(n=>n.name);(w.length+v.length+k.length+g.length>0||l)&&this.out.tables.push({sheet:t.sheet.name,name:t.name,by:l?"key":"position",...l&&s!==void 0?{key:s}:{},rowsAdded:w,rowsRemoved:v,columnsAdded:k,columnsRemoved:g})}names(e,t){const s=(r,o)=>{const i=r.name(o);if(i)return i.formula?.text??b(i.value??null)},c=new Set([...e.names.values(),...t.names.values()].map(r=>r.name));for(const r of[...c].sort()){const o=s(e,r),i=s(t,r);o!==i&&this.out.names.push({name:r,...o===void 0?{}:{was:o},...i===void 0?{}:{now:i}})}}run(){const{wb:e}=this.a,{wb:t}=this.b;this.names(e,t);for(const s of e.sheets)t.sheet(s.name)||this.out.sheets.push({name:s.name,added:!1,removed:!0});for(const s of t.sheets){const c=e.sheet(s.name);if(!c){this.out.sheets.push({name:s.name,added:!0,removed:!1});continue}this.loose(c,s);for(const r of s.tables){const o=e.table(r.name);o?this.table(o,r):this.out.tables.push({sheet:s.name,name:r.name,by:"position",rowsAdded:[String(r.rows)],rowsRemoved:[],columnsAdded:r.columns.map(i=>i.name),columnsRemoved:[]})}JSON.stringify(c.spec.charts??[])!==JSON.stringify(s.spec.charts??[])&&this.out.charts.push(s.name)}return this.out}}function E(a,e,t,s){const[c,r]=a.span(t,0,s),[o,i]=e.span(t,0,s);return[Math.min(c,o),Math.max(r,i)]}export function diffWorkbooks(a,e,t={}){return new C(a,e,t.tolerance??DIFF_DEFAULTS.tolerance).run()}
+import{SHEET_MARGINS as F,SHEET_NOTE_AUTHOR as H}from"@allyhub-next/formats";import{cellName as U,readAddress as A}from"./address.js";import{dataValue as _}from"./export.js";import{shownValue as j}from"./format.js";import{sheetPrefix as S}from"./formula/print.js";import{CellError as M}from"./values.js";import{FormulaCell as N}from"./workbook.js";export const DIFF_DEFAULTS={tolerance:0};const I=(o,e)=>{if(o!=="written")return e};function J(o){const{row:e,col:n}=o;return JSON.stringify(o.moved,(t,s)=>(t==="col"||t==="col2"||t==="row"||t==="row2")&&typeof s=="object"&&s!==null&&s.abs===!1?[s.index-(t.startsWith("col")?n:e)]:I(t,s))}function P(o,e,n){if(o===e)return!0;if(typeof o=="number"&&typeof e=="number"){const t=Math.max(Math.abs(o),Math.abs(e));return Math.abs(o-e)<=n*t}return o instanceof M&&e instanceof M?o.code===e.code:!1}function E(o,e,n,t){const s=o.value(e,n,t),i=e.lookAt(n,t).format,r=e.at(n,t);return{cell:U({row:n,col:t}),value:_(s,i),shown:j(s,i),...r instanceof N?{formula:r.text}:{}}}const R=(o,e,n)=>{const t=o.at(e,n);return t instanceof N&&t.shared.node?J(t):void 0},T=(o,e,n)=>o.at(e,n)!==void 0||o.spillAt(e,n)!==void 0;class D{out={sheets:[],tables:[],names:[],parts:[],charts:[],cells:[],counts:{value:0,formula:0,both:0,added:0,removed:0}};a;b;tolerance;constructor(e,n,t){this.a=e,this.b=n,this.tolerance=t}push(e){this.out.counts[e.kind]+=1,this.out.cells.push(e)}cell(e,n,t){const s=this.a.value(e.sheet,e.row,e.col),i=this.b.value(n.sheet,n.row,n.col),r=T(e.sheet,e.row,e.col),d=T(n.sheet,n.row,n.col);if(!r&&!d)return;const u=n.sheet.name,c=()=>({was:E(this.a,e.sheet,e.row,e.col),now:E(this.b,n.sheet,n.row,n.col)});if(!r){this.push({...t,sheet:u,kind:"added",now:c().now});return}if(!d){this.push({...t,sheet:u,kind:"removed",was:c().was});return}const f=P(s,i,this.tolerance),l=R(e.sheet,e.row,e.col)===R(n.sheet,n.row,n.col);if(f&&l)return;const h=l?"value":f?"formula":"both";this.push({...t,sheet:u,kind:h,...c()})}loose(e,n){const t=(r,d,u)=>r.tableAt(d,u)!==void 0,s=Math.max(e.lastRow,n.lastRow),i=Math.max(e.columnsUsed,n.columnsUsed)-1;for(let r=0;r<=i;r++){const[d,u]=W(e,n,r,s);for(let c=d;c<=u;c++)t(e,c,r)||t(n,c,r)||this.cell({sheet:e,row:c,col:r},{sheet:n,row:c,col:r},{})}}table(e,n){const t=n.spec.key??e.spec.key,s=e.column(t??""),i=n.column(t??""),r=(a,m,g)=>{const w=new Map;if(g){for(let p=0;p<a.rows;p++){const C=m.value(a.sheet,a.at.row+1+p,a.at.col+g.index),v=j(C);if(v===""||w.has(v))return;w.set(v,p)}return w}},d=r(e,this.a,s),u=r(n,this.b,i),c=d&&u?{from:d,to:u}:void 0,f=[];if(c){for(const[a,m]of c.from)f.push([m,c.to.get(a),a]);for(const[a,m]of c.to)c.from.has(a)||f.push([void 0,m,a])}else for(let a=0;a<Math.max(e.rows,n.rows);a++)f.push([a<e.rows?a:void 0,a<n.rows?a:void 0,String(a+1)]);const l=[],h=[],y=n.columns.filter(a=>e.column(a.name));for(const[a,m,g]of f)if(a===void 0)l.push(g);else if(m===void 0)h.push(g);else for(const w of y){const p=e.column(w.name);p&&this.cell({sheet:e.sheet,row:e.at.row+1+a,col:e.at.col+p.index},{sheet:n.sheet,row:n.at.row+1+m,col:n.at.col+w.index},{table:n.name,column:w.name,...c?{key:g}:{}})}const k=n.columns.filter(a=>!e.column(a.name)).map(a=>a.name),x=e.columns.filter(a=>!n.column(a.name)).map(a=>a.name);(l.length+h.length+k.length+x.length>0||c)&&this.out.tables.push({sheet:n.sheet.name,name:n.name,by:c?"key":"position",...c&&t!==void 0?{key:t}:{},rowsAdded:l,rowsRemoved:h,columnsAdded:k,columnsRemoved:x})}names(e,n){const t=u=>{const c=new Map;for(const f of u.names.values())c.set(f.name.toLowerCase(),f);for(const f of u.sheets)for(const l of f.names.values())c.set(`${S(f.name)}${l.name}`.toLowerCase(),l);return c},s=u=>u&&(u.formula?.text??j(u.value??null)),i=t(e),r=t(n),d=new Map;for(const[u,c]of[...i,...r])d.set(u,c.sheet?`${S(c.sheet.name)}${c.name}`:c.name);for(const u of[...d.keys()].sort()){const c=s(i.get(u)),f=s(r.get(u));c!==f&&this.out.names.push({name:d.get(u)??u,...c===void 0?{}:{was:c},...f===void 0?{}:{now:f}});const l=k=>k===void 0?void 0:k.hidden===!0,h=l(i.get(u)),y=l(r.get(u));h!==void 0&&y!==void 0&&h!==y&&this.out.parts.push({part:"hidden names",key:d.get(u)??u,was:String(h),now:String(y)})}}part(e){this.out.parts.push(e)}whole(e,n,t,s){const i=b(t),r=b(s);i!==r&&this.part({...e===void 0?{}:{sheet:e},part:n,...i===void 0?{}:{was:i},...r===void 0?{}:{now:r}})}keyed(e,n,t,s,i=b){const r=new Set([...Object.keys(t??{}),...Object.keys(s??{})]);for(const d of[...r].sort(L)){const u=i(t?.[d]),c=i(s?.[d]);u!==c&&this.part({sheet:e,part:n,key:d,...u===void 0?{}:{was:u},...c===void 0?{}:{now:c}})}}listed(e,n,t,s,i=!0){const r=d=>d===void 0||d.length===0?void 0:i?d:d.map(u=>b(u)??"").sort();this.whole(e,n,r(t),r(s))}sheetParts(e,n){const t=e.spec,s=n.spec,i=n.name;this.whole(i,"print",$(t.print),$(s.print)),this.keyed(i,"notes",t.notes,s.notes,V),this.keyed(i,"links",t.links,s.links,r=>typeof r=="string"?r:void 0),this.listed(i,"validations",t.validations,s.validations,!1),this.listed(i,"conditional",t.conditional,s.conditional),this.listed(i,"pictures",t.pictures,s.pictures),this.whole(i,"protect",t.protect===!0||void 0,s.protect===!0||void 0),this.whole(i,"freeze",t.freeze,s.freeze),this.listed(i,"merges",t.merges,s.merges,!1),this.whole(i,"filter",t.filter,s.filter),this.keyed(i,"columns",O(t.columns),O(s.columns)),this.keyed(i,"rows",O(t.rows),O(s.rows)),this.whole(i,"view",z(t),z(s))}run(){const{wb:e}=this.a,{wb:n}=this.b;this.names(e,n),this.whole(void 0,"title",e.title,n.title);for(const t of e.sheets)n.sheet(t.name)||this.out.sheets.push({name:t.name,added:!1,removed:!0});for(const t of n.sheets){const s=e.sheet(t.name);if(!s){this.out.sheets.push({name:t.name,added:!0,removed:!1});continue}this.loose(s,t),this.sheetParts(s,t);for(const i of t.tables){const r=e.table(i.name);r?this.table(r,i):this.out.tables.push({sheet:t.name,name:i.name,by:"position",rowsAdded:[String(i.rows)],rowsRemoved:[],columnsAdded:i.columns.map(d=>d.name),columnsRemoved:[]})}JSON.stringify(s.spec.charts??[])!==JSON.stringify(t.spec.charts??[])&&this.out.charts.push(t.name)}return this.out}}function b(o){if(o!==void 0)return JSON.stringify(o,(e,n)=>n!==null&&typeof n=="object"&&!Array.isArray(n)?Object.fromEntries(Object.entries(n).sort(([t],[s])=>t<s?-1:t>s?1:0)):n)}function L(o,e){const n=A(o),t=A(e);if(n&&t)return n.row-t.row||n.col-t.col;const s=Number(o),i=Number(e);return Number.isInteger(s)&&Number.isInteger(i)?s-i:o.length-e.length||(o<e?-1:o>e?1:0)}function V(o){if(typeof o=="string")return o;if(o===null||typeof o!="object")return;const e=o;return e.author===void 0||e.author===H?e.text:`${e.text} (${e.author})`}function $(o){if(!o)return;const e=Object.fromEntries(Object.entries(o.margins??{}).filter(([t,s])=>F[t]!==s)),n={...o};return Object.keys(e).length>0?n.margins=e:delete n.margins,Object.keys(n).length>0?n:void 0}function O(o){if(!o)return;const e={};for(const[n,t]of Object.entries(o)){const s={..."width"in t&&t.width!==void 0?{width:t.width}:{},..."height"in t&&t.height!==void 0?{height:t.height}:{},...t.hidden===!0?{hidden:!0}:{},...t.level===void 0?{}:{level:t.level}};Object.keys(s).length>0&&(e[n]=s)}return e}const z=o=>{const e={...o.hidden===!0?{hidden:!0}:{},...o.tab===void 0?{}:{tab:o.tab.toUpperCase()},...o.gridlines===!1?{gridlines:!1}:{}};return Object.keys(e).length>0?e:void 0};function W(o,e,n,t){const[s,i]=o.span(n,0,t),[r,d]=e.span(n,0,t);return[Math.min(s,r),Math.max(i,d)]}export function diffWorkbooks(o,e,n={}){return new D(o,e,n.tolerance??DIFF_DEFAULTS.tolerance).run()}

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

@@ -1,11 +1,32 @@
-import { Calc } from "./calc/engine.js";
+import type { Calc } from "./calc/engine.js";
+import { type Scalar } from "./values.js";
 import type { Table, Worksheet } from "./workbook.js";
-/** A sheet as CSV: dates as ISO text, numbers as numbers. */
-export declare function csvOf(calc: Calc, sheet: Worksheet): string;
-/** A sheet as a Markdown table, values as their formats show them, its first row the head. */
-export declare function markdownOf(calc: Calc, sheet: Worksheet): string;
+/** What a value is written as: data, or as its format shows it. */
+export type ValueMode = "data" | "shown";
+export interface ValueOptions {
+    /** Default "data" for CSV and JSON, "shown" for Markdown. */
+    values?: ValueMode;
+}
+export interface CsvOptions extends ValueOptions {
+    /** A UTF-8 byte-order mark first, by which Excel reads the file as UTF-8 (é, €, 中文); default true. */
+    bom?: boolean;
+}
+/** A number as Excel keeps it: 15 significant digits, -0 as 0. */
+export declare const excelNumber: (n: number) => number;
+/** A value as one CSV field. */
+export declare function csvText(value: Scalar, code: string | undefined, mode?: ValueMode): string;
+/** A value as JSON holds it: a number, text, true or false, an error's code, or null. */
+export declare function dataValue(value: Scalar, code: string | undefined, mode?: ValueMode): string | number | boolean | null;
+/** A sheet as CSV (RFC 4180: CRLF between records), from A1 to the last cell it uses. */
+export declare function csvOf(calc: Calc, sheet: Worksheet, o?: CsvOptions): string;
+/**
+ * A sheet as a Markdown table, its first row the head: values as their
+ * formats show them unless `values` is "data"; a column whose values are
+ * all numbers is aligned right.
+ */
+export declare function markdownOf(calc: Calc, sheet: Worksheet, o?: ValueOptions): string;
 /** A table's computed rows, by header. */
-export declare function tableRows(calc: Calc, table: Table): Record<string, string | number | boolean | null>[];
-/** The workbook as data: each sheet's rows, each table's rows by header, each name's value. */
-export declare function jsonOf(calc: Calc): Record<string, unknown>;
+export declare function tableRows(calc: Calc, table: Table, o?: ValueOptions): Record<string, string | number | boolean | null>[];
+/** The workbook as data: each sheet's rows, each table's rows by header. */
+export declare function jsonOf(calc: Calc, o?: ValueOptions): Record<string, unknown>;
 //# sourceMappingURL=export.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/export.js

@@ -1,6 +1,5 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import"./calc/engine.js";import{csvRecord as i}from"./csv.js";import{dataValue as a,shownValue as m}from"./format.js";const p=(r,t,e,o)=>m(r.value(t,e,o),t.lookAt(e,o).format),u=(r,t,e,o)=>a(r.value(t,e,o),t.lookAt(e,o).format);function f(r,t){const e=r.used;if(!e)return[];const o=[];for(let s=0;s<=e.bottom;s++){const n=[];for(let c=0;c<=e.right;c++)n.push(t(s,c));o.push(n)}return o}export function csvOf(r,t){return f(t,(o,s)=>{const n=u(r,t,o,s);return n===null?"":typeof n=="boolean"?n?"TRUE":"FALSE":String(n)}).map(o=>`${i(o)}
-`).join("")}const w=r=>r.replaceAll("|","\\|").replaceAll(`
-`,"<br>");export function markdownOf(r,t){const e=f(t,(c,l)=>p(r,t,c,l)),[o,...s]=e;if(!o)return"";const n=c=>`| ${c.map(w).join(" | ")} |`;return`${[n(o),n(o.map(()=>"---")),...s.map(n)].join(`
+import{writeCsv as S}from"./csv.js";import{isDateCode as k,shownValue as b}from"./format.js";import{CellError as w,dateOf as j}from"./values.js";const y=t=>(t.split(";")[0]??"").replace(/"[^"]*"|\\.|_.|\*./gu,"").replace(/\[(?![hms]+\])[^\]]*\]/giu,""),h=new Map;function _(t){if(t===void 0)return;if(h.has(t))return h.get(t);let n;if(k(t)){const r=y(t).toLowerCase(),o=/\[(h+|m+|s+)\]/u.test(r),e=[...r.matchAll(/\[?([ydhms])\1*\]?|am\/pm|a\/p/gu)].map(c=>c[0]);let s=!1,i=!1,u=!1;for(const[c,a]of e.entries()){const f=a.replace(/[[\]]/gu,"")[0];if(f==="y"||f==="d")s=!0;else if(f==="h"||a.includes("/"))i=!0;else if(f==="s")i=!0,u=!0;else if(f==="m"){const l=e[c-1]?.replace(/[[\]]/gu,"")[0],m=e[c+1]?.replace(/[[\]]/gu,"")[0];a.startsWith("[")||l==="h"||m==="s"?i=!0:s=!0}}o?n={kind:"duration",seconds:u}:s&&i?n={kind:"datetime",seconds:u}:i?n={kind:"time",seconds:u}:s&&(n={kind:"date",seconds:!1})}return h.set(t,n),n}const $=864e5,A=2958465,d=(t,n=2)=>String(t).padStart(n,"0");export const excelNumber=t=>t===0?0:Number(t.toPrecision(15));function x(t,n,r=2){const o=Math.floor(t/1e3),e=t%1e3;let s=`${d(Math.floor(o/3600),r)}:${d(Math.floor(o/60)%60)}`;return(n||o%60!==0||e!==0)&&(s+=`:${d(o%60)}`),e!==0&&(s+=`.${d(e,3).replace(/0+$/u,"")}`),s}function T(t){const n=t<0?"-":"";let r=Math.abs(t);const o=Math.floor(r/36e5);r-=o*36e5;const e=Math.floor(r/6e4);r-=e*6e4;const s=[o>0?`${String(o)}H`:"",e>0?`${String(e)}M`:"",r>0?`${String(r/1e3)}S`:""].join("");return`${n}PT${s||"0S"}`}function M(t,n,r){const o=Math.round(t*$);if(n.kind==="duration")return r==="json"?T(o):`${o<0?"-":""}${x(Math.abs(o),n.seconds,1)}`;if(t<0||t>=A+1)return;const e=Math.floor(o/$),s=x(o-e*$,n.seconds||r==="json");if(e===0||n.kind==="time")return s;if(e===60)return;const{year:i,month:u,day:c}=j(e),a=`${d(i,4)}-${d(u)}-${d(c)}`;return n.kind==="date"?a:`${a}${r==="json"?"T":" "}${s}`}export function csvText(t,n,r="data"){if(t===null)return"";if(r==="shown")return b(t,n);if(typeof t=="boolean")return t?"TRUE":"FALSE";if(t instanceof w)return t.code;if(typeof t=="string")return t;const o=_(n);return(o&&M(t,o,"csv"))??String(excelNumber(t))}export function dataValue(t,n,r="data"){if(t===null)return null;if(r==="shown")return b(t,n);if(t instanceof w)return t.code;if(typeof t!="number")return t;const o=_(n);return(o&&M(t,o,"json"))??excelNumber(t)}const p=(t,n,r)=>t.lookAt(n,r).format;function g(t,n){const r=t.used;if(!r)return[];const o=[];for(let e=0;e<=r.bottom;e++){const s=[];for(let i=0;i<=r.right;i++)s.push(n(e,i));o.push(s)}return o}export function csvOf(t,n,r={}){const o=g(n,(e,s)=>csvText(t.value(n,e,s),p(n,e,s),r.values));return S(o,{delimiter:",",newline:`\r
+`,bom:r.bom??!0,finalNewline:!0})}const E=t=>t.replaceAll("|","\\|").replace(/\r?\n/gu,"<br>");export function markdownOf(t,n,r={}){const o=r.values??"shown",e=[],s=g(n,(f,l)=>{const m=t.value(n,f,l);return f>0&&m!==null&&(e[l]=(e[l]??!0)&&typeof m=="number"),csvText(m,p(n,f,l),o)}),[i,...u]=s;if(!i)return"";const c=f=>`| ${f.map(E).join(" | ")} |`,a=i.map((f,l)=>e[l]===!0?"---:":"---");return`${[c(i),`| ${a.join(" | ")} |`,...u.map(c)].join(`
 `)}
-`}export function tableRows(r,t){const{sheet:e,at:o}=t,s=[];for(let n=0;n<t.rows;n++){const c={};for(const l of t.columns)c[l.name]=u(r,e,o.row+1+n,o.col+l.index);s.push(c)}return s}export function jsonOf(r){const{wb:t}=r,e={};for(const o of t.sheets){const s={};for(const n of o.tables)s[n.name]=tableRows(r,n);e[o.name]={rows:f(o,(n,c)=>u(r,o,n,c)),...o.tables.length>0?{tables:s}:{}}}return{...t.title===void 0?{}:{title:t.title},sheets:e}}
+`}export function tableRows(t,n,r={}){const{sheet:o,at:e}=n,s=[];for(let i=0;i<n.rows;i++){const u={};for(const c of n.columns){const a=e.row+1+i,f=e.col+c.index;u[c.name]=dataValue(t.value(o,a,f),p(o,a,f),r.values)}s.push(u)}return s}export function jsonOf(t,n={}){const{wb:r}=t,o={};for(const e of r.sheets){const s={};for(const i of e.tables)s[i.name]=tableRows(t,i,n);o[e.name]={rows:g(e,(i,u)=>dataValue(t.value(e,i,u),p(e,i,u),n.values)),...e.tables.length>0?{tables:s}:{}}}return{...r.title===void 0?{}:{title:r.title},sheets:o}}

package/dist/node_modules/@allyhub-next/sheet/dist/file.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readDataFile as m}from"@allyhub-next/formats";import{LineCounter as u,parseDocument as f}from"yaml";export const ENTRY="sheet.yaml";export function dataFilesOf(l){const{file:o}=readSheetFile(l);return[...new Set(o?.sheets.flatMap(n=>[...(n.tables??[]).map(t=>t.rows),...(n.blocks??[]).map(t=>t.rows)])??[])]}export function readSheetFile(l){const o=new u,n=f(l,{lineCounter:o}),t=e=>{for(let r=e.length;r>=0;r--){const a=n.getIn(e.slice(0,r),!0)?.range?.[0];if(a!==void 0)return o.linePos(a).line}};if(n.errors.length>0)return{problems:n.errors.map(e=>({file:ENTRY,line:o.linePos(e.pos[0]).line,message:`not YAML: ${e.message.split(`
-`)[0]??""}`})),lineOf:t};const i=m("sheet",n.toJS()??{});return i.ok?{file:i.value,problems:[],lineOf:t}:{problems:i.problems.map(e=>{const r=t(e.path===""?[]:e.path.split(".").map(s=>/^\d+$/u.test(s)?Number(s):s));return{file:ENTRY,...r===void 0?{}:{line:r},message:`${e.path===""?"":`${e.path}: `}${e.message}`}}),lineOf:t}}
+import{readDataFile as c}from"@allyhub-next/formats";import{LineCounter as p,isMap as m,isScalar as f,parseDocument as d,visit as g}from"yaml";export const ENTRY="sheet.yaml";export function dataFilesOf(i){const{file:t}=readSheetFile(i);return[...new Set(t?.sheets.flatMap(s=>[...(s.tables??[]).map(n=>n.rows),...(s.blocks??[]).map(n=>n.rows)])??[])]}function h(i){const t=[];return g(i,{Map(s,n){if(!m(n))return;const a=new Set;for(const o of n.items){const e=f(o.key)?String(o.key.value):void 0;if(e!==void 0)if(a.has(e)){const r=f(o.key)?o.key.range?.[0]??0:0;t.push({at:r,key:e})}else a.add(e)}}}),t}export function readSheetFile(i){const t=new p,s=d(i,{lineCounter:t,uniqueKeys:!1}),n=e=>{for(let r=e.length;r>=0;r--){const u=s.getIn(e.slice(0,r),!0)?.range?.[0];if(u!==void 0)return t.linePos(u).line}},a=h(s);if(s.errors.length>0||a.length>0)return{problems:[...s.errors.map(e=>({file:ENTRY,line:t.linePos(e.pos[0]).line,message:`not YAML: ${e.message.split(`
+`)[0]??""}`})),...a.map(e=>({file:ENTRY,line:t.linePos(e.at).line,message:`not YAML: Map keys must be unique (${e.key})`}))],lineOf:n};const o=c("sheet",s.toJS()??{});return o.ok?{file:o.value,problems:[],lineOf:n}:{problems:o.problems.map(e=>{const r=n(e.path===""?[]:e.path.split(".").map(l=>/^\d+$/u.test(l)?Number(l):l));return{file:ENTRY,...r===void 0?{}:{line:r},message:`${e.path===""?"":`${e.path}: `}${e.message}`}}),lineOf:n}}

package/dist/node_modules/@allyhub-next/sheet/dist/format.d.ts

@@ -1,9 +1,15 @@
 import { type Scalar } from "./values.js";
+/**
+ * What General can show a number as, widest first: as it is (at most 11
+ * characters), then with fewer digits, then with an exponent. A cell shows
+ * the first that fits it; none is ####.
+ */
+export declare function generalForms(value: number): string[];
+/** A number as General shows it, in a cell as wide as `fits` allows when it is given: undefined when nothing fits (####). */
+export declare function generalText(value: number, fits?: (text: string) => boolean): string | undefined;
 /** A value through a number format; General without one. */
 export declare function shownValue(value: Scalar, code?: string): string;
 /** The colour a number format gives a value, as [Red] does. */
 export declare function shownColor(value: Scalar, code?: string): string | undefined;
 export declare const isDateCode: (code: string | undefined) => boolean;
-/** A value as data: a date as ISO text, an error as its code. */
-export declare function dataValue(value: Scalar, code: string | undefined): string | number | boolean | null;
 //# sourceMappingURL=format.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/format.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{format as e,formatColor as s,isDateFormat as p,isValidFormat as o}from"numfmt";import{CellError as f,isoOfSerial as m,numberText as i}from"./values.js";export function shownValue(r,n){if(r===null)return"";if(r instanceof f)return r.code;if(typeof r=="boolean")return r?"TRUE":"FALSE";const t=n??"General";if(typeof r=="string")return n!==void 0&&o(n)?e(n,r):r;if(t==="General"||!o(t))return i(r);try{return e(t,r)}catch{return i(r)}}export function shownColor(r,n){if(typeof r!="number"||n===void 0||!o(n))return;const t=s(n,r);return typeof t=="string"?t:void 0}export const isDateCode=r=>r!==void 0&&o(r)&&p(r);export function dataValue(r,n){return r instanceof f?r.code:typeof r=="number"&&isDateCode(n)?m(r):r}
+import{format as i,formatColor as p,isDateFormat as u,isValidFormat as f}from"numfmt";import{CellError as l,numberText as s}from"./values.js";export function generalForms(n){const r=i("General",n),t=[r];for(let e=10;e>=1;e--){const o=i("General",Number(n.toPrecision(e)));o.length<(t[t.length-1]??r).length&&t.push(o)}for(let e=5;e>=0;e--){const o=n.toExponential(e).replace(/e([+-])(\d)$/u,"E$10$2").replace(/e/u,"E");o.length<(t[t.length-1]??r).length&&t.push(o)}return t}export function generalText(n,r){const t=generalForms(n);return r?t.find(r):t[0]}export function shownValue(n,r){if(n===null)return"";if(n instanceof l)return n.code;if(typeof n=="boolean")return n?"TRUE":"FALSE";const t=r??"General";if(typeof n=="string")return r!==void 0&&f(r)?i(r,n):n;if(t==="General"||!f(t))return generalText(n)??s(n);try{return i(t,n)}catch{return generalText(n)??s(n)}}export function shownColor(n,r){if(typeof n!="number"||r===void 0||!f(r))return;const t=p(r,n);return typeof t=="string"?t:void 0}export const isDateCode=n=>n!==void 0&&f(n)&&u(n);

package/dist/node_modules/@allyhub-next/sheet/dist/html.d.ts

@@ -1,9 +1,8 @@
 import { type Area } from "./address.js";
 import type { Calc } from "./calc/engine.js";
+import { DEFAULT_COLUMN_WIDTH, DEFAULT_ROW_HEIGHT, type PrintJob } from "./paginate.js";
 import { type Worksheet } from "./workbook.js";
-/** A cell of a size nothing sets. */
-export declare const DEFAULT_COLUMN_WIDTH = 64;
-export declare const DEFAULT_ROW_HEIGHT = 20;
+export { DEFAULT_COLUMN_WIDTH, DEFAULT_ROW_HEIGHT };
 export interface SheetHtmlOptions {
     /** The sheets drawn; default every one that is not hidden. */
     sheets?: readonly Worksheet[];
@@ -29,6 +28,55 @@ export interface SheetHtml {
     /** What `rows` and `columns` left out, a line per sheet. */
     cut: string[];
 }
-/** A workbook's sheets as one page of HTML. */
+/** A workbook's sheets as one page of HTML, as a person sees them: for a picture, and frames. */
 export declare function sheetHtml(calc: Calc, o?: SheetHtmlOptions): SheetHtml;
+/** What a header's or footer's codes name, for one page. */
+export interface PageFields {
+    page: number;
+    pages: number;
+    sheet: string;
+    /** The workbook's file name, &F. */
+    file: string;
+    /** When it is printed, for &D and &T. */
+    date: Date;
+}
+/**
+ * A header's or footer's section as HTML: Excel's codes, &P and &N (with
+ * +n or -n), &D, &T, &F, &A, &Z, &&, &B, &I, &U, &E, &S, &X, &Y, a font
+ * (&"name,style"), a size (&14) and a colour (&KFF0000). A picture (&G)
+ * draws nothing.
+ */
+export declare function headerFooterHtml(text: string, f: PageFields): string;
+export interface PrintHtmlOptions {
+    css?: string;
+    font?: string;
+    /** The workbook's file name, a header's &F. */
+    name: string;
+    /** When it is printed, a header's &D and &T. */
+    date: Date;
+}
+/**
+ * A workbook on paper: its pages, laid out once, and any stretch of them
+ * as one HTML page that prints them. What drawing a sheet needs (its
+ * pictures, its tables' stripes, its charts) is read once for every
+ * stretch.
+ */
+export declare class SheetPrint {
+    readonly job: PrintJob;
+    private readonly calc;
+    private readonly drawers;
+    private readonly file;
+    constructor(calc: Calc, o?: {
+        sheets?: readonly Worksheet[];
+        file?: SheetHtmlOptions["file"];
+    });
+    private drawer;
+    /**
+     * Pages `from` to before `to` as one HTML page that prints them: each
+     * the paper's size, its header and footer in its margins, its title rows
+     * and columns, then its own, scaled, and the charts that fall in them.
+     */
+    html(from: number, to: number, o: PrintHtmlOptions): string;
+    private page;
+}
 //# sourceMappingURL=html.d.ts.map