allyhub 0.4.0 → 0.6.0

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{cellName as g}from"./address.js";import"./calc/types.js";import{analyse as y}from"./calc/analyse.js";import{dataValue as S,shownValue as x}from"./format.js";import{relativeKey as _}from"./formula/move.js";import{exceptionsOf as C}from"./edit.js";import{invalidCells as F}from"./validate.js";import{CellError as E}from"./values.js";import{FormulaCell as v}from"./workbook.js";export const SHEET_FACT_KINDS=["sheet-error","sheet-number","sheet-unlike","sheet-exception","sheet-unused","sheet-invalid","sheet-typed","sheet-ordinary"],INSPECT_DEFAULTS={plain:[0,1,-1],around:1};function w(o){const s=new Map;for(const t of o.formulas){const n=s.get(t.shared);n?(n.count+=1,(t.row<n.first.row||t.row===n.first.row&&t.col<n.first.col)&&(n.first=t)):s.set(t.shared,{shared:t.shared,first:t,count:1})}return[...s.values()].sort((t,n)=>t.first.row-n.first.row||t.first.col-n.first.col)}function k(o,s,t){switch(o.kind){case"number":t.push({value:o.value,in:s});return;case"unary":o.op==="-"&&o.arg.kind==="number"?t.push({value:-o.arg.value,in:s}):k(o.arg,o.op,t);return;case"postfix":k(o.arg,o.op,t);return;case"paren":k(o.arg,s,t);return;case"binary":k(o.left,o.op,t),k(o.right,o.op,t);return;case"array":for(const n of o.rows)for(const l of n)k(l,"{}",t);return;case"call":for(const n of o.args)k(n,o.name,t);return;case"invoke":k(o.callee,s,t);for(const n of o.args)k(n,"LAMBDA",t);return;default:return}}function N(o,s){const t={error:!1};for(const n of o.precedents(s))if(o.each(n,l=>{l instanceof E&&(t.error=!0)}),t.error)return!1;return!0}const b=new WeakMap;function A(o){const s=b.get(o);if(s!==void 0)return s;const t=o.node?_(o.node,o.row,o.col):o.text;return b.set(o,t),t}const I=(o,s)=>o instanceof v?o.text:x(o,s);function M(o,s,t){const n=[],l=(r,e)=>{if(r<0||e<0)return;const u=o.at(r,e);return u instanceof v?A(u.shared):void 0},c=(r,e,u,i)=>{const a=u==="column"?1:0,f=u==="row"?1:0,h=o.at(r,e);if(h===void 0||h instanceof v&&A(h.shared)===i)return;for(let d=1;d<=s;d++)if(l(r-a*d,e-f*d)!==i||l(r+a*d,e+f*d)!==i)return;if(t.has(r*16384+e))return;let m=s*2;for(let d=s+1;l(r-a*d,e-f*d)===i;d++)m+=1;for(let d=s+1;l(r+a*d,e+f*d)===i;d++)m+=1;const p=o.at(r-a,e-f);n.push({sheet:o.name,cell:g({row:r,col:e}),holds:I(h,o.lookAt(r,e).format),neighbour:p instanceof v?p.text:"",along:u,run:m})};for(const r of o.formulas){const e=A(r.shared);c(r.row+1,r.col,"column",e),c(r.row,r.col+1,"row",e)}return n.sort((r,e)=>T(r.cell,e.cell))}const T=(o,s)=>o.length-s.length||o.localeCompare(s,"en",{numeric:!0});function R(o,s){const t=[],n=(c,r)=>{c&&t.push(...o.readsOfFormula(c,r))};for(const c of s.sheets){for(const r of c.conditions)for(const e of r.formulas)n(e,c);for(const r of c.validations)for(const e of r.formulas)n(e,c);for(const r of c.charts){n(r.title,c),n(r.categories,c);for(const e of r.series)n(e.values,c),n(e.x,c),n(e.name,c)}}const l=s.sheets[0];if(l){for(const c of s.checks)n(c.formula,l);for(const c of s.names.values())n(c.formula,l)}return t}function D(o){const s=new Set,t=n=>{if(n)for(const l of y(o,n).names)s.add(l)};for(const n of o.sheets){for(const{shared:l}of w(n))t(l);for(const l of n.conditions)l.formulas.forEach(t);for(const l of n.validations)l.formulas.forEach(t);for(const l of n.charts){t(l.title),t(l.categories);for(const c of l.series)t(c.values),t(c.x),t(c.name)}}for(const n of o.checks)t(n.formula);return s}function K(o,s,t){const n=[],l=D(s);for(const e of s.names.values())l.has(e.name.toLowerCase())||n.push({what:"name",name:e.name,value:e.formula?.text??x(e.value??null)});const c=R(o,s),r=(e,u,i)=>c.some(a=>a.sheet===e&&u>=a.top&&u<=a.bottom&&i>=a.left&&i<=a.right)||o.readers(e,u,i).length>0;for(const e of s.sheets){for(let u=0;u<e.columnsUsed;u++){const[i,a]=e.span(u,0,Number.MAX_SAFE_INTEGER);for(let f=i;f<=a;f++){const h=e.at(f,u);typeof h=="number"&&(e.tableAt(f,u)||e.blockAt(f,u)||r(e,f,u)||n.push({what:"cell",sheet:e.name,name:g({row:f,col:u}),value:x(h,e.lookAt(f,u).format)}))}}if(t)for(const u of e.tables)for(const i of u.columns){const a=u.at.col+i.index,{top:f,bottom:h}=u.data;let m=!1;for(let p=f;p<=h&&!m;p++)m=r(e,p,a);m||n.push({what:"column",sheet:e.name,name:`${u.name}[${i.name}]`})}}return n}export function inspectWorkbook(o,s={}){const{wb:t}=o,n=new Set(s.plain??INSPECT_DEFAULTS.plain),l=Math.max(1,s.around??INSPECT_DEFAULTS.around),c=s.all===!0,r=[];for(const e of t.sheets){const u=[...e.formulas].sort((a,f)=>a.row-f.row||a.col-f.col);for(const a of u){const{value:f}=a;f instanceof E&&r.push({kind:"sheet-error",data:{sheet:e.name,cell:g(a),code:f.code,formula:a.text,origin:N(o,a)}})}for(let a=0;a<e.columnsUsed;a++){const[f,h]=e.span(a,0,Number.MAX_SAFE_INTEGER);for(let m=f;m<=h;m++){const p=e.at(m,a);p instanceof E&&r.push({kind:"sheet-error",data:{sheet:e.name,cell:g({row:m,col:a}),code:p.code,origin:!0}})}}for(const{shared:a,first:f,count:h}of w(e)){if(!a.node)continue;const m=[];k(a.node,"=",m);const p=c?m:m.filter(d=>!n.has(d.value));p.length>0&&r.push({kind:"sheet-number",data:{sheet:e.name,cell:g(f),cells:h,formula:f.text,numbers:p}})}const i=new Set;for(const a of e.tables)for(const f of C(a))i.add(f.row*16384+f.col),r.push({kind:"sheet-exception",data:{sheet:e.name,table:a.name,column:f.column,cell:g(f),text:f.text}});for(const a of M(e,l,i))r.push({kind:"sheet-unlike",data:a})}for(const e of K(o,t,c))r.push({kind:"sheet-unused",data:e});for(const e of F(t,o))r.push({kind:"sheet-invalid",data:{sheet:e.sheet,cell:g(e),value:S(e.value,void 0),rule:e.type,range:e.range}});for(const e of t.generated?.typed??[])t.sheet(e.sheet)?.generated===!0&&r.push({kind:"sheet-typed",data:e});for(const e of t.ordinary)r.push({kind:"sheet-ordinary",data:{sheet:e}});return r}

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

@@ -0,0 +1,4 @@
+import { type ParsedCsv } from "./csv.js";
+/** The file `csv` was read from, written again with `rows`, its first the header. */
+export declare function patchCsv(csv: ParsedCsv, rows: readonly (readonly string[])[]): string;
+//# sourceMappingURL=patch.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{csvRecord as y}from"./csv.js";const k=(c,t)=>{if(c.length===0)return"
";const n=[];for(let o=0;o<t;o++)n.push(c[o]??"");return n.join("\0")},b=(c,t)=>k(c.end===c.start?[]:c.fields,t);export function patchCsv(c,t){const{dialect:n,records:o,source:u}=c,a=t.reduce((e,l)=>Math.max(e,l.length),0);if(t.length===0)return n.bom?"\uFEFF":"";const g=new Map;for(const e of o)g.set(e.fields,e);const h=new Set,i=new Array(t.length);t.forEach((e,l)=>{const s=g.get(e);s&&!h.has(s)&&(h.add(s),i[l]=u.slice(s.start,s.end))});let r;t.forEach((e,l)=>{if(i[l]!==void 0)return;if(!r){r=new Map;for(const f of o){if(h.has(f)||f.fields.length>a)continue;const m=b(f,a),p=r.get(m);p?p.push(f):r.set(m,[f])}}const s=r.get(k(e,a))?.shift();if(s){i[l]=u.slice(s.start,s.end);return}const d=[...e];for(;d.length<a;)d.push("");i[l]=e.length===0?"":y(d,n.delimiter)});const w=n.finalNewline||i[i.length-1]==="";return`${n.bom?"\uFEFF":""}${i.join(n.newline)}${w?n.newline:""}`}

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

@@ -0,0 +1,30 @@
+import type { Calc } from "./calc/engine.js";
+import type { Table } from "./workbook.js";
+/** How many of a column's most frequent values are listed. */
+export declare const PROFILE_TOP = 5;
+export interface ColumnProfile {
+    name: string;
+    /** A calculated column's formula. */
+    formula?: string;
+    rows: number;
+    empty: number;
+    distinct: number;
+    numbers: number;
+    dates: number;
+    text: number;
+    booleans: number;
+    errors: number;
+    min?: number;
+    max?: number;
+    sum?: number;
+    mean?: number;
+    shortest?: number;
+    longest?: number;
+    top: {
+        value: string;
+        count: number;
+    }[];
+}
+/** Each column of a table. */
+export declare function profileTable(calc: Calc, table: Table, top?: number): ColumnProfile[];
+//# sourceMappingURL=profile.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{CellError as h}from"./values.js";import{isDateCode as g}from"./format.js";export const PROFILE_TOP=5;function y(p,s,m,u,a){const e={name:p,...s===void 0?{}:{formula:s},rows:m.length,empty:0,distinct:0,numbers:0,dates:0,text:0,booleans:0,errors:0,top:[]},n=new Map;let r=0,i=1/0,o=-1/0,l=1/0,c=-1;return m.forEach((t,f)=>{if(t===null){e.empty+=1;return}const d=t instanceof h?t.code:String(t);n.set(d,(n.get(d)??0)+1),typeof t=="number"?(u[f]===!0?e.dates+=1:e.numbers+=1,r+=t,t<i&&(i=t),t>o&&(o=t)):typeof t=="string"?(e.text+=1,t.length<l&&(l=t.length),t.length>c&&(c=t.length)):typeof t=="boolean"?e.booleans+=1:e.errors+=1}),e.distinct=n.size,e.numbers+e.dates>0&&(e.min=i,e.max=o),e.numbers>0&&(e.sum=r,e.mean=r/e.numbers),c>=0&&(e.shortest=l,e.longest=c),e.top=[...n].sort((t,f)=>f[1]-t[1]||(t[0]<f[0]?-1:1)).slice(0,a).map(([t,f])=>({value:t,count:f})),e}export function profileTable(p,s,m=PROFILE_TOP){const{sheet:u,at:a}=s;return s.columns.map(e=>{const n=a.col+e.index,r=[],i=[];for(let o=0;o<s.rows;o++){const l=a.row+1+o;r.push(p.value(u,l,n)),i.push(g(u.lookAt(l,n).format))}return y(e.name,e.formula?.text,r,i,m)})}

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

@@ -0,0 +1,56 @@
+import type { Calc } from "./calc/engine.js";
+import { type Scalar } from "./values.js";
+import type { CellLook, Worksheet } from "./workbook.js";
+/** What rules give a cell. */
+export interface RuleShow {
+    /** Over the cell's own look. */
+    look?: CellLook;
+    /** A data bar: its length as a share of the cell. */
+    bar?: {
+        share: number;
+        color: string;
+    };
+    /** A colour scale's fill. */
+    scale?: string;
+    /** An icon of a set, from the lowest. */
+    icon?: {
+        set: string;
+        index: number;
+    };
+    /** The bar or the icon alone: the value is not shown. */
+    bare?: boolean;
+}
+/** A colour between two, by a share of the way. */
+export declare function colorBetween(a: string, b: string, share: number): string;
+/** One value against a bound, as Excel orders them: numbers, then text, then TRUE and FALSE. */
+export declare function compareValues(a: Scalar, b: Scalar): number;
+/** Whether a value stands as an operator asks of its bounds. */
+export declare function holds(operator: string, value: Scalar, first: Scalar, second: Scalar): boolean;
+export declare class Rules {
+    private readonly sheet;
+    private readonly calc;
+    private readonly measured;
+    constructor(sheet: Worksheet, calc: Calc);
+    private measure;
+    private eachIn;
+    /** A bound's value at a cell: a formula's result, or what is written. */
+    private boundAt;
+    /** A stop's place on a rule's scale of numbers. */
+    private stopAt;
+    private whether;
+    private scale;
+    private bar;
+    private icon;
+    /** What every rule on a place gives it. */
+    at(row: number, col: number): RuleShow | undefined;
+}
+/** What an icon of a set looks like: a shape and its colour, wherever it is drawn. */
+export interface IconShape {
+    shape: "up" | "up-right" | "right" | "down-right" | "down" | "circle" | "flag" | "check" | "bang" | "cross" | "triangle" | "diamond" | "bars" | "quarter";
+    color: string;
+    /** For bars and quarters: how many of four, or of all. */
+    level?: number;
+}
+/** The icon at a place of a set, the first the lowest. */
+export declare function iconShape(set: string, index: number): IconShape;
+//# sourceMappingURL=rules.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{contains as A}from"./address.js";import{toBool as S}from"./calc/coerce.js";import{CellError as l,Matrix as y,readTyped as k}from"./values.js";const d=.1,E=.9,x={3:[0,33,67],4:[0,25,50,75],5:[0,20,40,60,80]},w=s=>{if(!(s===null||s==="")&&!(s instanceof l))return typeof s=="string"?`s${s.toLowerCase()}`:`${typeof s}${String(s)}`},B=s=>Math.round(s).toString(16).padStart(2,"0");export function colorBetween(s,t,r){const i=(e,n)=>Number.parseInt(e.slice(n,n+2),16),o=e=>B(i(s,e)+(i(t,e)-i(s,e))*r);return`#${o(1)}${o(3)}${o(5)}`.toUpperCase()}export function compareValues(s,t){const r=e=>typeof e=="number"||e===null?0:typeof e=="string"?1:typeof e=="boolean"?2:3,i=r(s),o=r(t);if(i!==o)return i-o;if(i===0)return(s??0)-(t??0);if(i===1){const e=s.toLowerCase(),n=t.toLowerCase();return e<n?-1:e>n?1:0}return s===t?0:s===!0?1:-1}export function holds(s,t,r,i){if(t instanceof l)return!1;const o=()=>compareValues(t,r);switch(s){case"equal":return o()===0;case"notEqual":return o()!==0;case"greaterThan":return o()>0;case"lessThan":return o()<0;case"greaterThanOrEqual":return o()>=0;case"lessThanOrEqual":return o()<=0;default:{const e=o()>=0&&compareValues(t,i)<=0;return s==="notBetween"?!e:e}}}const M=s=>s===null||s instanceof l?"":typeof s=="boolean"?s?"TRUE":"FALSE":String(s);function C(s,t,r){if(t instanceof l)return!1;const i=M(t).toLowerCase(),o=r.toLowerCase();switch(s){case"notContains":return!i.includes(o);case"beginsWith":return i.startsWith(o);case"endsWith":return i.endsWith(o);default:return i.includes(o)}}function F(s){if(s.type==="dataBar"||s.type==="colorScale"||s.type==="iconSet")return;const t={};return s.bold!==void 0&&(t.bold=s.bold),s.italic!==void 0&&(t.italic=s.italic),s.underline!==void 0&&(t.underline=s.underline),s.strike!==void 0&&(t.strike=s.strike),s.color!==void 0&&(t.color=s.color),s.fill!==void 0&&(t.fill=s.fill),s.border!==void 0&&(t.border=s.border),t}function L(s,t){const r=(s.length-1)*t,i=Math.floor(r),o=Math.ceil(r),e=s[i]??0,n=s[o]??e;return e+(n-e)*(r-i)}export class Rules{sheet;calc;measured=new Map;constructor(t,r){this.sheet=t,this.calc=r}measure(t){const r=this.measured.get(t);if(r)return r;const i=[],o=new Map;for(const n of t.areas)this.eachIn(n,c=>{typeof c=="number"&&i.push(c);const a=w(c);a!==void 0&&o.set(a,(o.get(a)??0)+1)});const e={numbers:i,sorted:[...i].sort((n,c)=>n-c),counts:o};return this.measured.set(t,e),e}eachIn(t,r){const{sheet:i,calc:o}=this,e=Math.min(t.right,i.columnsUsed-1);for(let n=t.left;n<=e;n++){const[c,a]=i.span(n,t.top,t.bottom);for(let u=c;u<=a;u++){const f=o.value(i,u,n);f!==null&&r(f)}}}boundAt(t,r,i,o){if(r===void 0)return null;if(typeof r=="number")return r;if(!r.startsWith("=")){const c=k(r);return c.formula===void 0?c.value:r}const e=t.formulas.find(c=>c.text===r);if(!e)return null;const n=this.calc.evaluateAt(e,this.sheet,i,o);return n instanceof y?n.at(0,0):n}stopAt(t,r,i,o,e){const{sorted:n}=this.measure(t),c=n[0]??0,a=n[n.length-1]??0,u=this.boundAt(t,r.value,i,o),f=typeof u=="number"?u:void 0;switch(r.at){case"min":return c;case"max":return a;case"percent":return c+(a-c)*(f??e)/100;case"percentile":return L(n,(f??e)/100);default:return f??e}}whether(t,r,i,o){const{spec:e}=t;switch(e.type){case"cellIs":return holds(e.operator,r,this.boundAt(t,e.formula[0],i,o),this.boundAt(t,e.formula[1],i,o));case"containsText":return C(e.operator,r,e.text);case"duplicateValues":case"uniqueValues":{const n=w(r);if(n===void 0)return!1;const c=this.measure(t).counts.get(n)??0;return e.type==="duplicateValues"?c>1:c===1}case"top10":{if(typeof r!="number")return!1;const{sorted:n}=this.measure(t),c=e.percent===!0?Math.max(1,Math.floor(n.length*e.rank/100)):e.rank,a=e.bottom===!0?n[Math.min(c,n.length)-1]:n[Math.max(n.length-c,0)];return a===void 0?!1:e.bottom===!0?r<=a:r>=a}case"aboveAverage":{if(typeof r!="number")return!1;const{numbers:n}=this.measure(t);if(n.length===0)return!1;const c=n.reduce((a,u)=>a+u,0)/n.length;return e.equal===!0&&r===c?!0:e.below===!0?r<c:r>c}case"expression":{const[n]=t.formulas;if(!n)return!1;const c=this.calc.evaluateAt(n,this.sheet,i,o),a=c instanceof y?c.at(0,0):c;return S(a)===!0}default:return!1}}scale(t,r,i,o,e){const n=r.stops.map((u,f)=>({at:this.stopAt(t,u,o,e,f*100/(r.stops.length-1)),color:u.color})),[c]=n,a=n[n.length-1];if(!(!c||!a)){if(i<=c.at)return c.color;if(i>=a.at)return a.color;for(let u=1;u<n.length;u++){const f=n[u-1],h=n[u];if(f&&h&&i<=h.at)return colorBetween(f.color,h.color,h.at===f.at?1:(i-f.at)/(h.at-f.at))}return a.color}}bar(t,r,i,o,e){const n=this.stopAt(t,r.min??{at:"min"},o,e,0),c=this.stopAt(t,r.max??{at:"max"},o,e,100);if(c<=n)return d;const a=Math.min(1,Math.max(0,(i-n)/(c-n)));return d+(E-d)*a}icon(t,r,i,o,e){const n=Number.parseInt(r.icons,10),c=r.stops??(x[n]??[]).map(u=>({at:"percent",value:u}));let a=0;return c.forEach((u,f)=>{i>=this.stopAt(t,u,o,e,0)&&(a=f)}),r.reverse===!0?n-1-a:a}at(t,r){const{sheet:i,calc:o}=this;if(i.conditions.length===0)return;const e=o.value(i,t,r);let n;for(const c of i.conditions){if(!c.areas.some(u=>A(u,t,r)))continue;const{spec:a}=c;if(a.type==="dataBar"||a.type==="colorScale"||a.type==="iconSet"){if(typeof e!="number")continue;if(n??={},a.type==="dataBar")n.bar??={share:this.bar(c,a,e,t,r),color:a.color},a.show===!1&&(n.bare=!0);else if(a.type==="colorScale"){const u=this.scale(c,a,e,t,r);u!==void 0&&(n.scale??=u)}else n.icon??={set:a.icons,index:this.icon(c,a,e,t,r)},a.show===!1&&(n.bare=!0);if(a.stop===!0)break;continue}if(this.whether(c,e,t,r)&&(n??={},n.look={...F(a),...n.look},a.stop===!0))break}return n}}const m="#00A651",g="#FFC000",b="#E03C32",p="#7F7F7F",T="#000000",R="#2F75B5",O=s=>s===3?[b,g,m]:s===4?[T,b,g,m]:[b,"#ED7D31",g,"#92D050",m];export function iconShape(s,t){const r=Number.parseInt(s,10),o=O(r)[t]??p,e=s.slice(1);return e.startsWith("Arrows")?{shape:(r===3?["down","right","up"]:r===4?["down","down-right","up-right","up"]:["down","down-right","right","up-right","up"])[t]??"right",color:e==="ArrowsGray"?p:o}:e==="Flags"?{shape:"flag",color:o}:e==="Signs"?{shape:t===0?"diamond":t===1?"triangle":"circle",color:o}:e.startsWith("Symbols")?{shape:t===0?"cross":t===1?"bang":"check",color:o}:e==="Rating"?{shape:"bars",color:R,level:t+1}:e==="Quarters"?{shape:"quarter",color:p,level:t}:e==="RedToBlack"?{shape:"circle",color:["#000000","#7F7F7F","#F4B6B6","#E03C32"][t]??p}:{shape:"circle",color:o}}

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

@@ -0,0 +1,42 @@
+import type { Calc } from "./calc/engine.js";
+import { type Scalar } from "./values.js";
+import { type DefinedName, type Workbook, type Worksheet } from "./workbook.js";
+/** The workbook's scenarios, by name, in the file's order. */
+export declare function scenarioNames(wb: Workbook): string[];
+/** The one typed or computed cell a name stands for, if it is a cell. */
+export declare function cellOfName(wb: Workbook, name: DefinedName): {
+    sheet: Worksheet;
+    row: number;
+    col: number;
+} | undefined;
+/**
+ * A workbook as a scenario has it, before anything is computed. False when
+ * there is no such scenario. Names it holds that are not there are the check's
+ * to say.
+ */
+export declare function applyScenario(wb: Workbook, scenario: string): boolean;
+export interface ScenarioCell {
+    row: number;
+    col: number;
+    /** What the scenario has it hold. */
+    value: Scalar;
+    /** What it holds as the file stands. */
+    base: Scalar;
+}
+export interface SheetScenarios {
+    sheet: Worksheet;
+    /** Each scenario's cells on this sheet, by name. */
+    scenarios: {
+        name: string;
+        cells: ScenarioCell[];
+    }[];
+}
+/**
+ * Scenarios as Excel holds them, each of a sheet and of its cells; what names
+ * no cell has no place there, and is said.
+ */
+export declare function scenariosByCell(calc: Calc): {
+    sheets: SheetScenarios[];
+    left: string[];
+};
+//# sourceMappingURL=scenario.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{parseFormula as p}from"./formula/parse.js";import{readTyped as m}from"./values.js";import{SharedFormula as h}from"./workbook.js";export function scenarioNames(e){return Object.keys(e.file.scenarios??{})}export function cellOfName(e,r){const s=r.formula?.text;if(s===void 0)return;const c=p(s);if(!c.ok||c.node.kind!=="ref")return;const n=c.node;if(n.range||!n.col||!n.row||n.lastSheet!==void 0)return;const o=n.sheet===void 0?e.sheets[0]:e.sheet(n.sheet);return o&&{sheet:o,row:n.row.index,col:n.col.index}}const d=e=>typeof e=="string"?m(e):{value:e??null};export function applyScenario(e,r){const s=e.file.scenarios?.[r];if(!s)return!1;for(const[c,n]of Object.entries(s)){const o=e.name(c);if(!o)continue;const t=d(n),l=cellOfName(e,o);t.formula!==void 0?(o.formula=new h(t.formula,0,0,o.source),delete o.value):l?l.sheet.replace(l.row,l.col,t.value??void 0):(o.value=t.value,delete o.formula)}return!0}export function scenariosByCell(e){const{wb:r}=e,s=new Map,c=[];for(const n of scenarioNames(r)){const o=new Map;for(const[t,l]of Object.entries(r.file.scenarios?.[n]??{})){const f=r.name(t),a=f&&cellOfName(r,f),i=d(l);if(!a||i.formula!==void 0){c.push(`scenario ${n}'s ${t}: Excel's scenarios change cells, and it is no cell`);continue}const u=o.get(a.sheet)??[];u.push({row:a.row,col:a.col,value:i.value,base:e.value(a.sheet,a.row,a.col)}),o.set(a.sheet,u)}for(const[t,l]of o){const f=s.get(t)??{sheet:t,scenarios:[]};f.scenarios.push({name:n,cells:l}),s.set(t,f)}}return{sheets:[...s.values()],left:c}}

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

@@ -0,0 +1,10 @@
+export type FillMode = "auto" | "copy" | "series";
+/**
+ * The inputs that follow a run of them, nearest first: `back` says the run is
+ * being dragged up or left. Formulas are the caller's.
+ */
+export declare function seriesAfter(inputs: readonly string[], count: number, o?: {
+    mode?: FillMode;
+    back?: boolean;
+}): string[];
+//# sourceMappingURL=series.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{dateOfSerial as y,isoOfSerial as g,readTyped as C,serialOfDate as T}from"./values.js";const M=[["Mon","Tue","Wed","Thu","Fri","Sat","Sun"],["Monday","Tuesday","Wednesday","Thursday","Friday","Saturday","Sunday"],["周一","周二","周三","周四","周五","周六","周日"],["星期一","星期二","星期三","星期四","星期五","星期六","星期日"]],A=[["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],["January","February","March","April","May","June","July","August","September","October","November","December"],["一月","二月","三月","四月","五月","六月","七月","八月","九月","十月","十一月","十二月"]],S=[...M,...A];function D(t){const e=t.trim().toLowerCase();for(const f of S){const o=f.findIndex(n=>n.toLowerCase()===e);if(o>=0)return{list:f,at:o}}}function U(t,e){return e===e.toUpperCase()&&e!==e.toLowerCase()?t.toUpperCase():e===e.toLowerCase()&&e!==e.toUpperCase()?t.toLowerCase():t}const b=/^\d{4}-\d{2}-\d{2}/u;function h(t,e,f){const o=t.length,n=(o-1)/2,a=t.reduce((r,u)=>r+u,0)/o;let d=0,s=0;t.forEach((r,u)=>{d+=(u-n)*(r-a),s+=(u-n)**2});const c=s===0?1:d/s,l=[];for(let r=0;r<e;r++){const u=f?-1-r:o+r,i=a+c*(u-n);l.push(Number(i.toPrecision(15)))}return l}function L(t,e,f){const o=t.map(s=>y(s)),n=o.flatMap(s=>s?[s]:[]),[a,d]=n;if(a&&d&&n.length===o.length){const s=r=>r.getUTCFullYear()*12+r.getUTCMonth(),c=s(d)-s(a);if(c!==0&&n.every((r,u)=>r.getUTCDate()===a.getUTCDate()&&s(r)===s(a)+c*u)){const r=[];for(let u=0;u<e;u++){const i=f?-1-u:n.length+u;r.push(T(new Date(Date.UTC(a.getUTCFullYear(),a.getUTCMonth()+c*i,a.getUTCDate()))))}return r}}if(t.length===1){const[s=0]=t;return Array.from({length:e},(c,l)=>f?s-l-1:s+l+1)}return h(t,e,f)}const v=(t,e)=>e.length>10?g(t):g(Math.round(t)),w=(t,e,f)=>`${t}${String(Math.max(f,0)).padStart(e.length,"0")}`,F=/^(.*?)(\d+)$/su;function J(t,e,f){const o=t.map(r=>F.exec(r)),[n]=o;if(!n||o.some(r=>!r||r[1]!==n[1]))return;const a=n[1]??"",d=n[2]??"",s=o.map(r=>Number(r?.[2])),c=h(s,e,f),l=/^q$/iu.test(a);return c.map(r=>w(a,d,l?(Math.round(r)+399)%4+1:Math.round(r)))}function N(t,e,f){const o=t.map(D),[n]=o;if(!n||o.some(u=>u?.list!==n.list))return;const a=n.list.length,d=o[o.length-1],s=o.length>1&&d&&(d.at-n.at)/(o.length-1)||1,c=t[0]??"",l=[],r=f?n.at:d?.at??n.at;for(let u=0;u<e;u++){const i=r+(f?-s:s)*(u+1),p=n.list[(Math.round(i)%a+a)%a]??"";l.push(U(p,c))}return l}const m=(t,e,f)=>{const o=t.length;return Array.from({length:e},(n,a)=>f?t[((o-1-a)%o+o)%o]??"":t[a%o]??"")};export function seriesAfter(t,e,f={}){const o=f.mode??"auto",n=f.back===!0;if(o==="copy"||t.length===0)return m(t,e,n);const a=t.map(c=>C(c).value),d=t.length===1,s=a.flatMap(c=>typeof c=="number"?[c]:[]);if(s.length===a.length){if(t.every(r=>b.test(r)))return L(s,e,n).map(r=>v(r,t[0]??""));if(d&&o==="auto")return m(t,e,n);const c=s;return(d&&c[0]!==void 0?Array.from({length:e},(r,u)=>n?(c[0]??0)-u-1:(c[0]??0)+u+1):h(c,e,n)).map(String)}return a.every(c=>typeof c=="string")?N(t,e,n)??J(t,e,n)??m(t,e,n):m(t,e,n)}

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

@@ -0,0 +1,24 @@
+import { type Area } from "./address.js";
+import type { Calc } from "./calc/engine.js";
+import { type BookEdit, type EditBook } from "./edit.js";
+import { type Scalar } from "./values.js";
+import type { Worksheet } from "./workbook.js";
+export interface SortKey {
+    col: number;
+    descending?: boolean;
+}
+/** Two values in Excel's order, ascending. Blanks are the caller's. */
+export declare function compareForSort(a: Scalar, b: Scalar): number;
+/** Rows in sorted order, a stable sort. */
+export declare function sortedRows(rows: readonly number[], keys: readonly SortKey[], value: (row: number, col: number) => Scalar): number[];
+/** The rows of `from` to `to` in sorted order, each as where it came from. */
+export declare const sortedOrder: (from: number, to: number, keys: readonly SortKey[], value: (row: number, col: number) => Scalar) => number[];
+/**
+ * The rows of an area put in order of its keys. An area in a table sorts all
+ * of that table's rows, as Excel does; `area` is the rows sorted, no header.
+ * What a filter hides, `skip`, stays where it is.
+ */
+export declare function sortCells(book: EditBook, calc: Calc, sheetName: string, area: Area, keys: readonly SortKey[], skip?: ReadonlySet<number>): BookEdit;
+/** Whether a region's first row reads as a header: text over what is not, or set apart by its look. */
+export declare function hasHeader(sheet: Worksheet, calc: Calc, region: Area): boolean;
+//# sourceMappingURL=sort.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{contains as T}from"./address.js";import{Draft as L,blankEdit as y,inputOf as x,movedTo as b,refused as M,writeOne as R}from"./edit.js";import{CellError as g,readTyped as C}from"./values.js";const E=t=>typeof t=="number"?0:typeof t=="string"?1:typeof t=="boolean"?2:3;export function compareForSort(t,n){const e=E(t),r=E(n);if(e!==r)return e-r;if(typeof t=="number"&&typeof n=="number")return t-n;if(typeof t=="string"&&typeof n=="string"){const o=t.toLowerCase(),f=n.toLowerCase();return o<f?-1:o>f?1:0}return typeof t=="boolean"&&typeof n=="boolean"?t===n?0:t?1:-1:t instanceof g&&n instanceof g?t.code<n.code?-1:t.code>n.code?1:0:0}const w=t=>t===null||t==="";export function sortedRows(t,n,e){return t.map((r,o)=>({row:r,index:o})).sort((r,o)=>{for(const{col:f,descending:c}of n){const u=e(r.row,f),l=e(o.row,f);if(w(u)||w(l)){if(w(u)&&w(l))continue;return w(u)?1:-1}const s=compareForSort(u,l);if(s!==0)return c===!0?-s:s}return r.index-o.index}).map(r=>r.row)}export const sortedOrder=(t,n,e,r)=>sortedRows(Array.from({length:n-t+1},(o,f)=>t+f),e,r);function S(t,n,e,r,o){const f=t.rows(n.file),c=[...f];r.forEach((u,l)=>{const s=e[l];if(s===void 0)return;const d=n.places[u-o],p=n.places[s-o];if(d===void 0||p===void 0)return;const i=s-u,a=c[d]??[];f[p]=i===0?a:a.map(m=>C(m).formula===void 0?m:b(m,i,0))}),t.edit.whole=!0}const v=(t,n,e)=>{const r=[];for(let o=t;o<=n;o++)e?.has(o)||r.push(o);return r};export function sortCells(t,n,e,r,o,f){const c=t.workbook.sheet(e);if(!c)return M("no-sheet");if(o.length===0)return y();const u=(i,a)=>n.value(c,i,a),l=c.tables.find(i=>i.rows>0&&T(i.area,r.top,r.left)),s=new L(t);if(l){const{top:i,bottom:a}=l.data,m=v(i,a,f),h=sortedRows(m,o,u);return h.every((A,O)=>A===m[O])?y():(S(s,l,m,h,i),s.finish())}const d=v(r.top,Math.min(r.bottom,c.lastRow),f),p=sortedRows(d,o,u);return D(s,t,c,r,d,p),s.finish()}function D(t,n,e,r,o,f){const c=Math.min(r.right,e.columnsUsed-1);f.forEach((u,l)=>{const s=o[l];if(!(s===void 0||u===s))for(let d=r.left;d<=c;d++){const p=x(n,e,u,d),i=C(p).formula===void 0?p:b(p,s-u,0);i!==x(n,e,s,d)&&R(t,n,e,s,d,i)}})}export function hasHeader(t,n,e){if(e.bottom<=e.top)return!1;const r=(o,f)=>n.value(t,o,f);for(let o=e.left;o<=e.right;o++){const f=r(e.top,o),c=r(e.top+1,o);if(typeof f=="string"&&c!==null&&typeof c!="string"||t.lookAt(e.top,o).bold===!0&&t.lookAt(e.top+1,o).bold!==!0)return!0}return!1}

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

@@ -0,0 +1,38 @@
+import type { SheetFile, SheetTable } from "@allyhub-next/formats";
+import { type Place } from "./address.js";
+import { type StructureEdit } from "./formula/rewrite.js";
+import { type CsvRows } from "./workbook.js";
+/** A workbook's files as values. */
+export interface BookValues {
+    file: SheetFile;
+    rows: ReadonlyMap<string, CsvRows>;
+}
+export interface Restructured {
+    file: SheetFile;
+    rows: Map<string, CsvRows>;
+    /** Why it could not be done; the files are as they were. */
+    refused?: RefusedEdit;
+}
+export type RefusedEdit = "table-header" | "last-sheet" | "no-sheet";
+/** What a table is, from sheet.yaml and its file. */
+export interface TableShape {
+    at: Place;
+    /** The CSV file's header, as it writes it. */
+    header: readonly string[];
+    /** Its columns' names, those in the file first. */
+    names: string[];
+    /** The record of each row. */
+    places: number[];
+}
+export declare function tableShape(spec: SheetTable, rows: CsvRows): TableShape | undefined;
+/** A column's name no other in the table has: Column1, Column2… */
+export declare function freeColumn(names: readonly string[], stem?: string): string;
+/** A column's name made unlike the others', as Excel makes one: id, id2. */
+export declare function uniqueColumn(names: readonly string[], name: string): string;
+/** A table's file with columns up to `index` in it: what comes after a calculated column needs it there. */
+export declare function withColumnsUpTo(rows: CsvRows, names: readonly string[], index: number): string[][];
+/** A workbook's files after rows or columns are put in or taken out, or a sheet, a table's column renamed or a sheet deleted. */
+export declare function restructure(book: BookValues, edit: StructureEdit): Restructured;
+/** The workbook with a copy of a sheet right after it. */
+export declare function duplicated(book: BookValues, from: string, to: string): Restructured;
+//# sourceMappingURL=structure.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{MAX_COLUMNS as G,MAX_ROWS as H,cellName as v,columnIndex as R,columnLetter as _,rangeName as M,readAddress as y,readArea as A,readAreas as J}from"./address.js";import{chartAfter as Q}from"./chart.js";import{moveFormula as V,relativeKey as Y}from"./formula/move.js";import{parseFormula as z}from"./formula/parse.js";import{printFormula as N}from"./formula/print.js";import{rewriteFormula as B}from"./formula/rewrite.js";import{walk as Z}from"./formula/walk.js";import{readTyped as tt}from"./values.js";import{chartFormula as nt}from"./workbook.js";const $=r=>r.op==="insert-rows"||r.op==="delete-rows"||r.op==="insert-columns"||r.op==="delete-columns",k=r=>r.op==="insert-rows"||r.op==="insert-columns",b=r=>r.op==="insert-rows"||r.op==="delete-rows";function x(r,t){return k(t)?r>=t.at?r+t.count:r:r<t.at?r:r>=t.at+t.count?r-t.count:void 0}function P(r,t){const n=y(r);if(!n)return r;const s=x(b(t)?n.row:n.col,t);if(s!==void 0)return v(b(t)?{...n,row:s}:{...n,col:s})}function K(r,t){return Object.fromEntries(Object.entries(r).flatMap(([n,s])=>{const i=P(n,t);return i===void 0?[]:[[i,s]]}))}const et=r=>b(r)?H:G;function E(r,t,n){const s=et(n);if(k(n)){const e=r>=n.at?r+n.count:r,c=t>=n.at?t+n.count:t;return e>=s?void 0:[e,Math.min(c,s-1)]}const i=n.at+n.count-1;if(r>=n.at&&t<=i)return;const a=r<n.at?r:r>i?r-n.count:n.at,o=t<n.at?t:t>i?t-n.count:n.at-1;return[a,o]}function L(r,t){const n=b(t)?E(r.top,r.bottom,t):E(r.left,r.right,t);if(n)return b(t)?{...r,top:n[0],bottom:n[1]}:{...r,left:n[0],right:n[1]}}function ot(r,t,n,s){let i=0;const a=(o,e)=>{o&&!o.abs&&(i=Math.max(i,Math.abs(o.index-e)))};return Z(r,o=>{o.kind==="ref"&&(t?(a(o.row,n),a(o.row2,n)):(a(o.col,s),a(o.col2,s)))}),i}function st(r,t,n,s){const i=new Set,a=l=>{for(let f=l-s-1;f<=l+s+1;f++)f>=r&&f<=t&&i.add(f)};a(n.at),a(n.at+n.count);const o=[...i].sort((l,f)=>l-f),e=[];let c=r;for(const l of o)l>c&&e.push([c,l-1]),e.push([l,l]),c=l+1;return c<=t&&e.push([c,t]),e}function rt(r,t,n,s,i){const a=z(t);if(!a.ok){const m=i?L(r,s):r;return m?[{area:m,text:t}]:[]}const o=b(s),[e,c]=o?[r.top,r.bottom]:[r.left,r.right],l=ot(a.node,o,r.top,r.left),f=[];let u=!0;for(const[m,d]of st(e,c,s,l)){const w=o?m:r.top,p=o?r.left:m,h=i?x(m,s):m;if(h===void 0)continue;const g=i?x(d,s):d;if(g===void 0)continue;const C=V(a.node,w-r.top,p-r.left),S=B(C,s,n);S!==C&&(u=!1);const q=o?h:r.top,D=o?r.left:h,F=Y(S,q,D),I=f[f.length-1];I?.key===F&&I.to+1===h?I.to=g:f.push({from:h,to:g,key:F,text:N(S)})}return f.map(m=>({area:o?{...r,top:m.from,bottom:m.to}:{...r,left:m.from,right:m.to},text:u&&f.length===1?t:m.text}))}function W(r,t){return r!==null&&typeof r=="object"?{...r,formula:t}:t}const it=r=>{if(typeof r=="string")return r.startsWith("=")?r:void 0;if(!(r===null||typeof r!="object"))return r.formula!==void 0?r.formula.startsWith("=")?r.formula:`=${r.formula}`:typeof r.value=="string"&&r.value.startsWith("=")?r.value:void 0};function O(r,t,n,s){const i=z(r);if(!i.ok)return r;const a=B(i.node,t,n,s);return a===i.node?r:N(a)}function ct(r,t,n,s){const i={},a=$(n)?n:void 0;for(const[o,e]of Object.entries(r)){const c=it(e),l=A(o);if(!l){i[o]=e;continue}const f=s&&a!==void 0;if(o.includes(":")){if(!a){i[o]=c===void 0?e:W(e,O(c,n,t));continue}if(c!==void 0){for(const h of rt(l,c,t,a,f))i[M(h.area)]=W(e,h.text);continue}if(!f){i[o]=e;continue}if(!k(a)){const h=L(l,a);h&&(i[M(h)]=e);continue}const d=b(a),[w,p]=d?[l.top,l.bottom]:[l.left,l.right];for(const[h,g]of[[w,Math.min(p,a.at-1)],[Math.max(w,a.at),p]]){if(h>g)continue;const C=h>=a.at?a.count:0,S=d?{...l,top:h+C,bottom:g+C}:{...l,left:h+C,right:g+C};i[M(S)]=e}continue}const u={row:l.top,col:l.left};let m=u;if(f){const d=x(b(a)?u.row:u.col,a);m=d===void 0?void 0:b(a)?{...u,row:d}:{...u,col:d}}m&&(i[v(m)]=c===void 0?e:W(e,O(c,n,t)))}return i}export function tableShape(r,t){const n=y(r.at);if(!n)return;const s=t[0]??[],i=s.map(e=>e.trim()),a=new Set(i.map(e=>e.toLowerCase()));for(const e of Object.keys(r.columns??{}))a.has(e.toLowerCase())||i.push(e);const o=[];return t.forEach((e,c)=>{c>0&&e.length>0&&o.push(c)}),{at:n,header:s,names:i,places:o}}const T=r=>r.reduce((t,n)=>Math.max(t,n.length),0);function U(r,t,n){const s=Math.max(T(r),1),i=Array.from({length:n},()=>new Array(s).fill(""));return[...r.slice(0,t),...i,...r.slice(t)]}export function freeColumn(r,t="Column"){const n=new Set(r.map(s=>s.toLowerCase()));for(let s=1;;s++){const i=`${t}${String(s)}`;if(!n.has(i.toLowerCase()))return i}}export function uniqueColumn(r,t){const n=new Set(r.map(s=>s.toLowerCase()));if(!n.has(t.toLowerCase()))return t;for(let s=2;;s++){const i=`${t}${String(s)}`;if(!n.has(i.toLowerCase()))return i}}export function withColumnsUpTo(r,t,n){const s=r.map(o=>[...o]),i=s[0]??[];for(s.length===0&&s.push(i);i.length<=n;)i.push(t[i.length]??"");const a=i.length;for(let o=1;o<s.length;o++){const e=s[o];if(e&&e.length>0)for(;e.length<a;)e.push("")}return s}class X{file;rows;edit;after=[];refused;constructor(t,n){this.file=structuredClone(t.file),this.rows=new Map(t.rows),this.edit=n}sheets(){return this.file.sheets}rewrite(t){const n=this.file.sheets[0]?.name??"";if(this.file.names)for(const[s,i]of Object.entries(this.file.names))typeof i=="string"&&i.startsWith("=")&&(this.file.names[s]=O(i,t,n));for(const s of this.file.checks??[])s.formula=O(s.formula,t,n);for(const s of this.sheets())this.rewriteSheet(s,t)}rewriteSheet(t,n){const s=$(n)&&j(t.name,n.sheet);t.cells&&(t.cells=ct(t.cells,t.name,n,s));for(const i of t.tables??[]){for(const a of Object.values(i.columns??{}))a.formula!==void 0&&(a.formula=O(a.formula,n,t.name,i.name));this.rewriteCsv(i.rows,n,t.name,i.name)}for(const i of t.blocks??[])this.rewriteCsv(i.rows,n,t.name);this.rewriteRules(t,n)}freePath(t,n){const s=t.slice(0,t.lastIndexOf("/")+1),i=o=>[...this.rows.keys()].some(e=>j(e,o));let a=`${s}${n}.csv`;for(let o=2;i(a);o++)a=`${s}${n}-${String(o)}.csv`;return a}duplicate(t,n){const s=this.sheets(),i=s.findIndex(f=>j(f.name,t)),a=s[i];if(!a){this.refused="no-sheet";return}const o=structuredClone(a);o.name=n,delete o.hidden;for(const f of Object.values(o.cells??{}))f!==null&&typeof f=="object"&&delete f.name;const e=new Set(s.flatMap(f=>f.tables??[]).map(f=>f.name.toLowerCase())),c=new Set(Object.keys(this.file.names??{}).map(f=>f.toLowerCase())),l=[];for(const f of o.tables??[]){let u=f.name;for(let d=2;;d++){u=`${f.name}${String(d)}`;const w=u.toLowerCase();if(!e.has(w)&&!c.has(w))break}e.add(u.toLowerCase());const m=this.freePath(f.rows,u);this.rows.set(m,this.rows.get(f.rows)??[]),l.push({op:"rename-table",from:f.name,to:u}),f.rows=m,f.name=u}for(const f of o.blocks??[]){const u=f.rows.slice(f.rows.lastIndexOf("/")+1,-4),m=this.freePath(f.rows,u);this.rows.set(m,this.rows.get(f.rows)??[]),f.rows=m}this.file.sheets=[...s.slice(0,i+1),o,...s.slice(i+1)],this.rewriteSheet(o,{op:"rename-sheet",from:t,to:n});for(const f of l)this.rewriteSheet(o,f)}rewriteRules(t,n){const s=e=>typeof e=="string"&&e.startsWith("=")?O(e,n,t.name):e,i=e=>e.value===void 0?e:{...e,value:s(e.value)},a=t.conditional?.map(e=>{switch(e.type){case"cellIs":return{...e,formula:e.formula.map(s)};case"expression":return{...e,formula:O(e.formula.startsWith("=")?e.formula:`=${e.formula}`,n,t.name)};case"dataBar":return{...e,...e.min?{min:i(e.min)}:{},...e.max?{max:i(e.max)}:{}};case"colorScale":return{...e,stops:e.stops.map(i)};case"iconSet":return e.stops?{...e,stops:e.stops.map(i)}:e;default:return e}});a&&(t.conditional=a);const o=t.validations?.map(e=>e.formula?{...e,formula:e.formula.map(s)}:e);o&&(t.validations=o),$(n)&&n.sheet===t.name&&(t.links&&(t.links=K(t.links,n)),t.notes&&(t.notes=K(t.notes,n)),t.pictures&&(t.pictures=t.pictures.flatMap(e=>{const c=P(e.at,n);return c===void 0?[]:[{...e,at:c}]}))),t.charts&&(t.charts=t.charts.map(e=>Q(e,c=>{const l=c.startsWith("="),f=O(nt(c),n,t.name);return l?f:f.slice(1)})))}rewriteCsv(t,n,s,i){const a=this.rows.get(t);if(!a)return;let o;a.forEach((e,c)=>{if(!e.some(f=>f.charCodeAt(0)===61))return;const l=e.map(f=>tt(f).formula===void 0?f:O(f,n,s,i));l.every((f,u)=>f===e[u])||(o??=[...a],o[c]=l)}),o&&this.rows.set(t,o)}tableOn(t,n){const s=b(n),i=[];for(const a of t.tables??[]){const o=this.rows.get(a.rows),e=o&&tableShape(a,o);if(!o||!e){i.push(a);continue}const c=e.at.row,l=e.at.col,f=c+e.places.length,u=l+Math.max(e.names.length,1)-1,[m,d]=s?[c,f]:[l,u];if(!k(n)&&n.at<=m&&n.at+n.count-1>=d){this.after.push({op:"delete-table",name:a.name});continue}const w={...e.at};if(s)if(k(n)){if(n.at<=c)w.row+=n.count;else if(n.at<=f){const p=e.places[n.at-c-1]??o.length;this.rows.set(a.rows,U(o,p,n.count))}}else{const p=n.at+n.count-1;if(p<c)w.row-=n.count;else if(n.at<=c){this.refused="table-header";return}else if(n.at<=f){const h=new Set(e.places.slice(n.at-c-1,p-c));this.rows.set(a.rows,o.filter((g,C)=>!h.has(C)))}}else if(k(n))n.at<=l?w.col+=n.count:n.at<=u&&this.columnsIn(a,e,n.at-l,n.count);else{const p=n.at+n.count-1;if(p<l)w.col-=n.count;else if(n.at<=u){w.col=Math.min(l,n.at);const h=Math.max(0,n.at-l),g=Math.min(e.names.length-1,p-l);this.columnsOut(a,e,h,g)}}a.at=v(w),i.push(a)}t.tables=i,i.length===0&&delete t.tables}columnsIn(t,n,s,i){const a=this.rows.get(t.rows)??[],o=s>0?withColumnsUpTo(a,n.names,s-1):a.map(c=>[...c]),e=[...n.names];o.forEach((c,l)=>{if(l>0&&c.length===0)return;const f=[];for(let u=0;u<i;u++)if(l===0){const m=freeColumn(e);e.push(m),f.push(m)}else f.push("");for(;c.length<s;)c.push("");c.splice(s,0,...f)}),this.rows.set(t.rows,o)}columnsOut(t,n,s,i){const a=n.names.slice(s,i+1),o=this.rows.get(t.rows)??[],e=n.header.length,c=new Set;for(let l=s;l<=i&&l<e;l++)c.add(l);if(c.size>0&&this.rows.set(t.rows,o.map(l=>l.length===0?l:l.filter((f,u)=>!c.has(u)))),t.columns){const l=new Set(a.map(f=>f.toLowerCase()));t.columns=Object.fromEntries(Object.entries(t.columns).filter(([f])=>!l.has(f.toLowerCase()))),Object.keys(t.columns).length===0&&delete t.columns}if(t.key!==void 0&&a.some(l=>l.toLowerCase()===t.key?.toLowerCase())&&delete t.key,t.filter){const l=new Set(a.map(u=>u.toLowerCase())),f=Object.fromEntries(Object.entries(t.filter.columns).filter(([u])=>!l.has(u.toLowerCase())));Object.keys(f).length>0?t.filter={columns:f}:delete t.filter}for(const l of a)this.after.push({op:"delete-column",table:t.name,name:l})}blocksOn(t,n){const s=b(n),i=(t.blocks??[]).flatMap(a=>{const o=y(a.at),e=this.rows.get(a.rows);if(!o||!e)return[a];const c=s?o.row:o.col,l=s?e.length:Math.max(T(e),1),f=c+l-1,u=E(c,f,n);if(!u)return[];const m=s?{...o,row:u[0]}:{...o,col:u[0]};if(k(n)&&n.at>c&&n.at<=f){const d=n.at-c;this.rows.set(a.rows,s?U(e,d,n.count):e.map(w=>{if(w.length===0)return w;const p=[...w];for(;p.length<d;)p.push("");return p.splice(d,0,...new Array(n.count).fill("")),p}))}else if(!k(n)&&n.at<=f){const d=Math.max(n.at,c)-c,w=Math.min(n.at+n.count-1,f)-c;this.rows.set(a.rows,s?e.filter((p,h)=>h<d||h>w):e.map(p=>p.filter((h,g)=>g<d||g>w)))}return[{...a,at:v(m)}]});t.blocks=i,i.length===0&&delete t.blocks}looksOn(t,n){const s=b(n);t.format&&(t.format=t.format.flatMap(o=>{const e=A(o.range);if(!e)return[o];const c=L(e,n);return c?[{...o,range:M(c)}]:[]})),t.format?.length===0&&delete t.format,t.merges&&(t.merges=t.merges.flatMap(o=>{const e=A(o);if(!e)return[o];const c=L(e,n);return c?[M(c)]:[]})),t.merges?.length===0&&delete t.merges;const i=o=>{const e=J(o);if(!e)return o;const c=e.flatMap(l=>{const f=L(l,n);return f?[M(f)]:[]});return c.length===0?void 0:c.join(" ")};if(t.conditional&&(t.conditional=t.conditional.flatMap(o=>{const e=i(o.range);return e===void 0?[]:[{...o,range:e}]})),t.conditional?.length===0&&delete t.conditional,t.validations&&(t.validations=t.validations.flatMap(o=>{const e=i(o.range);return e===void 0?[]:[{...o,range:e}]})),t.validations?.length===0&&delete t.validations,t.charts&&(t.charts=t.charts.map(o=>{const e=y(o.at);if(!e)return o;const c=s?e.row:e.col,l=x(c,n)??n.at;return{...o,at:v(s?{...e,row:l}:{...e,col:l})}})),t.filter){const o=A(t.filter.range),e=o&&L(o,n);if(o&&!e)delete t.filter;else if(e){const c=s?t.filter.columns:Object.fromEntries(Object.entries(t.filter.columns??{}).flatMap(([l,f])=>{const u=R(l),m=u===void 0?void 0:x(u,n);return m===void 0?[]:[[_(m),f]]}));t.filter={range:M(e),...c&&Object.keys(c).length>0?{columns:c}:{}}}}if(t.freeze!==void 0){const o=y(t.freeze);if(o){const e=s?o.row:o.col,c=E(0,e-1,n),l=e===0?0:c?c[1]+1:0;t.freeze=v(s?{...o,row:l}:{...o,col:l})}}const a=(o,e,c)=>{if(!o)return;const l={};for(const[f,u]of Object.entries(o)){const m=e(f),d=m===void 0?void 0:x(m,n);m===void 0?l[f]=u:d!==void 0&&(l[c(d)]=u)}return l};if(s){const o=a(t.rows,e=>/^[1-9]\d*$/u.test(e)?Number(e)-1:void 0,e=>String(e+1));o&&(t.rows=o)}else{const o=a(t.columns,R,_);o&&(t.columns=o)}}run(){const t=this.edit;if($(t)){const n=this.sheets().find(s=>j(s.name,t.sheet));if(!n){this.refused="no-sheet";return}if(this.rewrite(t),this.tableOn(n,t),this.refused)return;this.blocksOn(n,t),this.looksOn(n,t);for(const s of this.after)this.rewrite(s);return}switch(t.op){case"rename-sheet":{this.rewrite(t);const n=this.sheets().find(s=>j(s.name,t.from));n&&(n.name=t.to);return}case"rename-column":{this.renameColumn(t.table,t.from,t.to),this.rewrite(t);return}case"delete-sheet":{const n=this.sheets(),s=n.find(i=>j(i.name,t.name));if(!s){this.refused="no-sheet";return}if(n.filter(i=>i.hidden!==!0).length<=1){this.refused="last-sheet";return}this.rewrite(t);for(const i of s.tables??[])this.rewrite({op:"delete-table",name:i.name});this.file.sheets=n.filter(i=>i!==s);return}default:this.rewrite(t)}}renameColumn(t,n,s){const i=this.sheets().flatMap(c=>c.tables??[]).find(c=>j(c.name,t));if(!i)return;const a=n.toLowerCase(),o=this.rows.get(i.rows),e=o?.[0]?.findIndex(c=>c.trim().toLowerCase()===a)??-1;if(o&&e>=0){const c=[...o[0]??[]];c[e]=s,this.rows.set(i.rows,[c,...o.slice(1)])}if(i.columns){const c=Object.keys(i.columns).find(l=>l.toLowerCase()===a);c!==void 0&&(i.columns=Object.fromEntries(Object.entries(i.columns).map(([l,f])=>[l===c?s:l,f])))}i.key?.toLowerCase()===a&&(i.key=s),i.filter&&(i.filter={columns:Object.fromEntries(Object.entries(i.filter.columns).map(([c,l])=>[c.toLowerCase()===a?s:c,l]))})}}const j=(r,t)=>r.toLowerCase()===t.toLowerCase();export function restructure(r,t){const n=new X(r,t);return n.run(),n.refused?{file:r.file,rows:new Map(r.rows),refused:n.refused}:{file:n.file,rows:n.rows}}export function duplicated(r,t,n){const s=new X(r,{op:"rename-sheet",from:t,to:n});return s.duplicate(t,n),s.refused?{file:r.file,rows:new Map(r.rows),refused:s.refused}:{file:s.file,rows:s.rows}}

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

@@ -0,0 +1,26 @@
+import { type SheetValidation } from "@allyhub-next/formats";
+import type { Calc } from "./calc/engine.js";
+import { type Scalar } from "./values.js";
+import { type Validation, type Workbook, type Worksheet } from "./workbook.js";
+/** What joins the choices of a cell under a rule. */
+export declare const separatorOf: (spec: SheetValidation) => string;
+/** The choices a cell's text holds, under a list that allows several. */
+export declare function choicesIn(text: string, spec: SheetValidation): string[];
+/** A cell's text for its choices. */
+export declare const joinChoices: (choices: readonly string[], spec: SheetValidation) => string;
+/** A rule's list: what it spells out, or what its range holds. */
+export declare function listValues(calc: Calc, sheet: Worksheet, rule: Validation, row: number, col: number): string[];
+/** Whether a value passes a rule, at the place it would stand. */
+export declare function valid(calc: Calc, sheet: Worksheet, rule: Validation, row: number, col: number, value: Scalar): boolean;
+export interface InvalidCell {
+    sheet: string;
+    row: number;
+    col: number;
+    value: Scalar;
+    /** The range of the rule it breaks. */
+    range: string;
+    type: string;
+}
+/** Every cell that breaks its sheet's data validation: facts, never problems. */
+export declare function invalidCells(wb: Workbook, calc: Calc): InvalidCell[];
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{SHEET_SEPARATOR as y}from"@allyhub-next/formats";import{toBool as g}from"./calc/coerce.js";import{holds as l}from"./rules.js";import{shownValue as d}from"./format.js";import{CellError as x,Matrix as b,readTyped as C}from"./values.js";import{FormulaCell as A}from"./workbook.js";export const separatorOf=e=>e.separator??y;export function choicesIn(e,o){const i=separatorOf(o);return e.split(i.trim()===""?i:i.trim()).map(n=>n.trim()).filter(n=>n!=="")}export const joinChoices=(e,o)=>e.join(separatorOf(o));export function listValues(e,o,i,n,r){const{spec:t}=i;if(t.values)return t.values;const[s]=t.formula??[],[f]=i.formulas;if(!f)return typeof s=="string"?s.split(","):[];const u=e.evaluateAt(f,o,n,r),a=m=>d(m,void 0);return u instanceof b?u.data.map(a).filter(m=>m!==""):u===null?[]:[a(u)]}function E(e,o,i,n,r,t){const s=i.spec.formula?.[n];if(s===void 0)return null;const f=i.formulas[n];if(f){const a=e.evaluateAt(f,o,r,t);return a instanceof b?a.at(0,0):a}if(typeof s=="number")return s;const u=C(s);return u.formula===void 0?u.value:null}function H(e,o,i,n,r,t){const[s]=i.formulas;if(!s)return!0;const f=o.at(n,r),a=e.value(o,n,r)!==t&&!(f instanceof A);a&&e.change([{sheet:o,row:n,col:r,slot:t??void 0}]);const m=e.evaluateAt(s,o,n,r);a&&e.change([{sheet:o,row:n,col:r,slot:f}]);const c=m instanceof b?m.at(0,0):m;return g(c)===!0}export function valid(e,o,i,n,r,t){const{spec:s}=i;if(t===null||t==="")return s.blank!==!1;if(t instanceof x)return!1;const f=s.operator??"between",u=a=>E(e,o,i,a,n,r);switch(s.type){case"list":{const a=d(t,void 0),m=listValues(e,o,i,n,r).map(p=>p.trim()),c=p=>s.values?m.includes(p.trim()):m.some(h=>h.toLowerCase()===p.trim().toLowerCase());return s.multiple===!0?choicesIn(a,s).every(c):c(a)}case"custom":return H(e,o,i,n,r,t);case"textLength":return l(f,(typeof t=="string"?t:d(t)).length,u(0),u(1));case"whole":return typeof t=="number"&&Number.isInteger(t)&&l(f,t,u(0),u(1));case"time":return typeof t=="number"&&t>=0&&t<1&&l(f,t,u(0),u(1));default:return typeof t=="number"&&l(f,t,u(0),u(1))}}function L(e,o,i){const n=Math.min(o.right,e.columnsUsed-1);for(let r=o.left;r<=n;r++){const[t,s]=e.span(r,o.top,o.bottom);for(let f=t;f<=s;f++)e.at(f,r)!==void 0&&i(f,r)}}export function invalidCells(e,o){const i=[];for(const n of e.sheets)for(const r of n.validations)for(const t of r.areas)L(n,t,(s,f)=>{const u=o.value(n,s,f);valid(o,n,r,s,f,u)||i.push({sheet:n.name,row:s,col:f,value:u,range:r.spec.range,type:r.spec.type})});return i}

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

@@ -0,0 +1,67 @@
+export type ErrorCode = "#NULL!" | "#DIV/0!" | "#VALUE!" | "#REF!" | "#NAME?" | "#NUM!" | "#N/A" | "#GETTING_DATA" | "#SPILL!" | "#CALC!" | "#CYCLE!";
+/** An error value; one object per code, so two are the same with ===. */
+export declare class CellError {
+    private static readonly all;
+    readonly code: ErrorCode;
+    private constructor();
+    static of(code: ErrorCode): CellError;
+    toString(): string;
+    toJSON(): string;
+}
+export declare const ERR: {
+    readonly NULL: CellError;
+    readonly DIV0: CellError;
+    readonly VALUE: CellError;
+    readonly REF: CellError;
+    readonly NAME: CellError;
+    readonly NUM: CellError;
+    readonly NA: CellError;
+    readonly SPILL: CellError;
+    readonly CALC: CellError;
+    /** A formula that reads itself: Excel says so in a dialog, a sheet in its value. */
+    readonly CYCLE: CellError;
+};
+/** The error text names, whatever its case; undefined when it names none. */
+export declare function errorOf(text: string): CellError | undefined;
+/** What a cell holds; null is an empty cell. */
+export type Scalar = number | string | boolean | null | CellError;
+/** Values in rows, as an array formula gives them. */
+export declare class Matrix {
+    readonly rows: number;
+    readonly cols: number;
+    readonly data: readonly Scalar[];
+    constructor(rows: number, cols: number, data: readonly Scalar[]);
+    at(row: number, col: number): Scalar;
+}
+/** The serial of a year, month and day; months and days past their end carry over, as DATE's do. */
+export declare function serialOf(year: number, month: number, day: number): number;
+/** A serial's year, month (from 1) and day; serial 60 is the 29 February 1900 Excel has. */
+export declare function dateOf(serial: number): {
+    year: number;
+    month: number;
+    day: number;
+};
+/** A moment as a serial. */
+export declare function serialOfDate(at: Date): number;
+/** A serial as a moment; undefined for the day that never was. */
+export declare function dateOfSerial(serial: number): Date | undefined;
+/** A serial as ISO 8601: its time only when it has one. */
+export declare function isoOfSerial(serial: number): string;
+/** A value as text reads it: at most 15 significant digits, as Excel's are. */
+export declare function numberText(n: number): string;
+/** How a value typed reads: the value, and the format Excel gives it when it has none. */
+export interface Typed {
+    value: Scalar;
+    /** The formula's text, the = included, when it is one. */
+    formula?: string;
+    format?: string;
+}
+/**
+ * Text as Excel reads what is typed: a number (a percent, grouped thousands
+ * and a dollar sign included), TRUE or FALSE, an ISO date, an error, text.
+ * `=` starts a formula, and `'` keeps what follows as text.
+ */
+export declare function readTyped(text: string): Typed;
+/** A value as a CSV cell or a YAML cell writes it: it reads back as itself. */
+export declare function writeTyped(value: Scalar): string;
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export class CellError{static all=new Map;code;constructor(t){this.code=t}static of(t){let n=CellError.all.get(t);return n||(n=new CellError(t),CellError.all.set(t,n)),n}toString(){return this.code}toJSON(){return this.code}}export const ERR={NULL:CellError.of("#NULL!"),DIV0:CellError.of("#DIV/0!"),VALUE:CellError.of("#VALUE!"),REF:CellError.of("#REF!"),NAME:CellError.of("#NAME?"),NUM:CellError.of("#NUM!"),NA:CellError.of("#N/A"),SPILL:CellError.of("#SPILL!"),CALC:CellError.of("#CALC!"),CYCLE:CellError.of("#CYCLE!")};const L=["#NULL!","#DIV/0!","#VALUE!","#REF!","#NAME?","#NUM!","#N/A","#GETTING_DATA","#SPILL!","#CALC!","#CYCLE!"];export function errorOf(e){const t=e.toUpperCase(),n=L.find(r=>r===t);return n===void 0?void 0:CellError.of(n)}export class Matrix{rows;cols;data;constructor(t,n,r){this.rows=t,this.cols=n,this.data=r}at(t,n){return this.data[t*this.cols+n]??null}}const i=864e5,p=25569;function y(e){const t=e+p;return t<61?t-1:t}function N(e){const t=Math.floor(e);if(t!==60)return(t<60?t+1:t)-p}export function serialOf(e,t,n){const r=new Date(Date.UTC(2e3,t-1,1));return r.setUTCFullYear(r.getUTCFullYear()-2e3+e),y(Math.floor(r.getTime()/i))+n-1}export function dateOf(e){const t=N(e);if(t===void 0)return{year:1900,month:2,day:29};if(Math.floor(e)===0)return{year:1900,month:1,day:0};const n=new Date(t*i);return{year:n.getUTCFullYear(),month:n.getUTCMonth()+1,day:n.getUTCDate()}}export function serialOfDate(e){const t=e.getTime(),n=Math.floor(t/i);return y(n)+(t-n*i)/i}export function dateOfSerial(e){const t=N(e);if(t===void 0)return;const n=e-Math.floor(e);return new Date(t*i+Math.round(n*i))}const a=(e,t=2)=>String(e).padStart(t,"0");export function isoOfSerial(e){const{year:t,month:n,day:r}=dateOf(e),s=`${a(t,4)}-${a(n)}-${a(r)}`,o=Math.round((e-Math.floor(e))*86400);if(o===0)return s;const u=o%60;return`${s}T${a(Math.floor(o/3600))}:${a(Math.floor(o/60)%60)}${u===0?"":`:${a(u)}`}`}export function numberText(e){if(e===0)return"0";const t=Number(e.toPrecision(15)),n=Math.floor(Math.log10(Math.abs(t)));if(n>=15||n<-10){const[s="",o="0"]=t.toExponential().split("e"),u=Number(o);return`${s}E${u<0?"-":"+"}${a(Math.abs(u))}`}const r=String(t);return r.includes("e")?t.toFixed(Math.min(20,Math.abs(n)+15)).replace(/0+$/u,""):r}const M=/^[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?$/u,$=/^[+-]?\d{1,3}(?:,\d{3})+(?:\.\d+)?$/u,b=/^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.\d+)?)?(Z|[+-]\d{2}:?\d{2})?)?$/u,E=e=>/^[+-]?\d+$/u.test(e)&&e.replace(/^[+-]?0*/u,"").length>15;function U(e){const t=b.exec(e);if(!t)return;const[n,r,s]=[Number(t[1]),Number(t[2]),Number(t[3])],o=serialOf(n,r,s),u=dateOf(o);if(u.month!==r||u.day!==s)return;if(t[4]===void 0)return{value:o,format:"yyyy-mm-dd"};const[f,l,m]=[Number(t[4]),Number(t[5]),Number(t[6]??0)];if(f>23||l>59||m>59)return;const d=t[7];let h=0;if(d!==void 0&&d!=="Z"){const c=d.replace(":","");h=(c.startsWith("-")?1:-1)*(Number(c.slice(1,3))*60+Number(c.slice(3,5)))/1440}return{value:o+(f*3600+l*60+m)/86400+h,format:t[6]===void 0?"yyyy-mm-dd hh:mm":"yyyy-mm-dd hh:mm:ss"}}export function readTyped(e){if(e==="")return{value:null};if(e.startsWith("'"))return{value:e.slice(1)};if(e.length>1&&e.startsWith("="))return{value:null,formula:e};const t=e.trim();if(t==="")return{value:e};const n=t.toUpperCase();if(n==="TRUE")return{value:!0};if(n==="FALSE")return{value:!1};if(M.test(t))return E(t)?{value:e}:{value:Number(t)};if(t.endsWith("%")){const f=t.slice(0,-1).trim();if(M.test(f))return{value:Number(f)/100,format:f.includes(".")?"0.00%":"0%"}}if($.test(t))return{value:Number(t.replaceAll(",","")),format:t.includes(".")?"#,##0.00":"#,##0"};const r=/^([+-]?)\$(\d[\d,]*(?:\.\d+)?)$/u.exec(t),s=r?.[2]?.replaceAll(",","");if(r&&s!==void 0)return{value:+`${r[1]??""}${s}`,format:t.includes(".")?"$#,##0.00":"$#,##0"};const o=U(t);if(o)return o;const u=errorOf(t);return u?{value:u}:{value:e}}export function writeTyped(e){if(e===null)return"";if(typeof e=="number"){const n=String(e);return E(n)?e.toExponential():n}if(typeof e=="boolean")return e?"TRUE":"FALSE";if(e instanceof CellError)return e.code;const t=readTyped(e);return t.value===e&&t.formula===void 0?e:`'${e}`}