allyhub 0.3.0 → 0.5.0

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{SHEET_PICTURE_HEIGHT as p}from"@allyhub-next/formats";import{columnIndex as d,columnLetter as a}from"./address.js";import{filesIn as x}from"./workbook.js";const m=/\.(?:png|jpe?g|gif|webp|bmp|svg)$/iu;export const isPicture=e=>m.test(e),pictureHeight=e=>(typeof e=="object"?e.height:void 0)??p;export function hasFiles(e){return Object.values(e.spec.columns??{}).some(t=>t.files!==void 0)||e.tables.some(t=>t.columns.some(c=>c.spec?.files))}export function fileCells(e,t){if(!hasFiles(e))return[];const c=[],o=(n,i,f)=>{const l=t.value(e,n,i);if(typeof l!="string")return;const s=x(l,f);s.length>0&&c.push({row:n,col:i,paths:s,column:f})},r=(n,i)=>e.tableAt(n,i)!==void 0;for(const[n,i]of Object.entries(e.spec.columns??{})){const f=d(n);if(f===void 0||i.files===void 0)continue;const[l,s]=e.span(f,0,e.lastRow);for(let u=l;u<=s;u++)r(u,f)||o(u,f,i.files)}for(const n of e.tables)for(const i of n.columns){const f=n.at.col+i.index,l=i.spec?.files??e.spec.columns?.[a(f)]?.files;if(l!==void 0)for(let s=n.data.top;s<=n.data.bottom;s++)o(s,f,l)}return c}export function pictureSize(e){const t=o=>e[o]??0,c=(o,r)=>{let n=0;for(let i=0;i<r;i++)n=n*256+t(o+i);return n};if(t(0)===137&&t(1)===80&&t(2)===78)return{type:"png",width:c(16,4),height:c(20,4)};if(t(0)===71&&t(1)===73&&t(2)===70)return{type:"gif",width:t(6)+t(7)*256,height:t(8)+t(9)*256};if(t(0)===255&&t(1)===216){let o=2;for(;o+9<e.length;){if(t(o)!==255)return;const r=t(o+1);if(r>=192&&r<=207&&![196,200,204].includes(r))return{type:"jpeg",width:c(o+7,2),height:c(o+5,2)};o+=2+c(o+2,2)}}}

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

@@ -0,0 +1,30 @@
+import { type Area, type Place } from "./address.js";
+import { Draft, type BookEdit, type EditBook } from "./edit.js";
+import { type FillMode } from "./series.js";
+import { type CellLook, type Worksheet } from "./workbook.js";
+/** Pairs of where a look comes from and where it goes. */
+export interface LookCopy {
+    from: Place;
+    to: Place;
+}
+/** Every field of a look taken away. */
+export declare const NO_LOOK: CellLook;
+/** Looks copied in an edit under way: only what differs is said, a rectangle at a time. */
+export declare function copyLooks(d: Draft, from: Worksheet, to: Worksheet, pairs: readonly LookCopy[]): void;
+/**
+ * What the fill handle does: `to` is the area dragged out, holding `from`.
+ * In one direction only, each line of `from` along it. A line of one formula
+ * is one key over its range when nothing but loose cells lie under it.
+ */
+export declare function autoFill(book: EditBook, sheetName: string, from: Area, to: Area, mode?: FillMode): BookEdit;
+/** Looks copied from cells to cells: Paste Special's Formats. */
+export declare function pasteLooks(book: EditBook, fromSheet: string, toSheet: string, pairs: readonly LookCopy[]): BookEdit;
+/** Where a double click on the handle fills to: as far down as the column beside it goes. */
+export declare function fillDownTo(sheet: Worksheet, area: Area): number | undefined;
+/**
+ * A cut pasted: the cells move, looks with them, and every formula in the
+ * workbook that named them follows. A table wholly among them moves too; part
+ * of one moves as its cells' values.
+ */
+export declare function moveCells(book: EditBook, sheetName: string, from: Area, toSheet: string, to: Place): BookEdit;
+//# sourceMappingURL=fill.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{cellName as X,contains as v,overlaps as A,rangeName as Y}from"./address.js";import{rectangles as N}from"./api/rectangles.js";import{Draft as E,applyLook as R,blankEdit as I,clearCells as Z,dropKeys as tt,inputOf as U,movedTo as W,refused as x,writeCells as ot,writeOne as et}from"./edit.js";import{relativeKey as nt}from"./formula/move.js";import{parseFormula as q}from"./formula/parse.js";import{printFormula as st}from"./formula/print.js";import{mapNode as rt}from"./formula/walk.js";import{restructure as it}from"./structure.js";import{seriesAfter as lt}from"./series.js";import{readTyped as ct}from"./values.js";import{workbookOf as ft}from"./workbook.js";const K=n=>ct(n).formula!==void 0;function ut(n,e,t){const o=q(n);return o.ok?nt(o.node,e,t):void 0}const at=(n,e)=>!n.tables.some(t=>A(t.area,e))&&!n.blocks.some(t=>A(t.area,e));function pt(n,e,t,o){if(n.some(r=>K(r.text))){const r=n.length;return e.map((f,l)=>{const a=t?n[((r-1-l)%r+r)%r]:n[l%r],b=a?.text??"";return{...f,text:a?W(b,f.row-a.row,f.col-a.col):b}})}const s=lt(n.map(r=>r.text),e.length,{mode:o,back:t});return e.map((r,f)=>({...r,text:s[f]??""}))}const G=["bold","italic","underline","strike","font","size","color","fill","align","valign","wrap","shrink","indent","rotation","border","format"];export const NO_LOOK=Object.fromEntries(G.map(n=>[n,void 0]));export function copyLooks(n,e,t,o){const i=new Map;for(const s of o){const r=e.lookAt(s.from.row,s.from.col),f=t.lookAt(s.to.row,s.to.col);if(JSON.stringify(r)===JSON.stringify(f))continue;const l=JSON.stringify(r),a=i.get(l);a?a.places.push(s.to):i.set(l,{look:r,places:[s.to]})}for(const{look:s,places:r}of i.values()){const f={};for(const l of G)f[l]=s[l];for(const l of N(r))R(n,t,l,f)}}export function autoFill(n,e,t,o,i="auto"){const s=n.workbook.sheet(e);if(!s)return x("no-sheet");const r=o.bottom>t.bottom||o.top<t.top,f=o.top<t.top||o.left<t.left,l=new E(n),a=r?{first:t.left,last:t.right}:{first:t.top,last:t.bottom},b=new Map,g=(u,w)=>{const k=`${String(u)}:${String(w)}`;let m=b.get(k);return m===void 0&&(m=U(n,s,u,w),b.set(k,m)),m},L=(t.bottom-t.top+1)*(t.right-t.left+1),y=new Set;for(let u=t.top;u<=t.bottom;u++)for(let w=t.left;w<=t.right;w++){const k=g(u,w);K(k)&&y.add(ut(k,u,w)??"")}if(y.size===1&&L>0&&at(s,o)&&wt(g,t)){const u=l.spec(s);return tt(u,o),u.cells={...u.cells,[Y(o)]:W(g(t.top,t.left),o.top-t.top,o.left-t.left)},l.edit.whole=!0,H(l,s,t,o,r),l.finish()}for(let u=a.first;u<=a.last;u++){const w=[];if(r)for(let p=t.top;p<=t.bottom;p++)w.push({row:p,col:u,text:g(p,u)});else for(let p=t.left;p<=t.right;p++)w.push({row:u,col:p,text:g(u,p)});const k=[],m=f?r?t.top-1:t.left-1:r?t.bottom+1:t.right+1,O=r?f?o.top:o.bottom:f?o.left:o.right,T=f?-1:1;for(let p=m;f?p>=O:p<=O;p+=T)k.push(r?{row:p,col:u}:{row:u,col:p});for(const p of pt(w,k,f,i))et(l,n,s,p.row,p.col,p.text)}return H(l,s,t,o,r),l.finish()}function wt(n,e){for(let t=e.top;t<=e.bottom;t++)for(let o=e.left;o<=e.right;o++)if(!K(n(t,o)))return!1;return!0}function H(n,e,t,o,i){const s=[],r=t.bottom-t.top+1,f=t.right-t.left+1;for(let l=o.top;l<=o.bottom;l++)for(let a=o.left;a<=o.right;a++){if(v(t,l,a))continue;const b=i?t.top+((l-t.top)%r+r)%r:l,g=i?a:t.left+((a-t.left)%f+f)%f;s.push({from:{row:b,col:g},to:{row:l,col:a}})}copyLooks(n,e,e,s)}export function pasteLooks(n,e,t,o){const i=n.workbook.sheet(e),s=n.workbook.sheet(t);if(!i||!s)return x("no-sheet");const r=new E(n);return copyLooks(r,i,s,o),r.finish()}export function fillDownTo(n,e){const t=(o,i)=>i>=0&&n.at(o,i)!==void 0;for(const o of[e.left-1,e.right+1]){if(!t(e.bottom,o)&&!t(e.bottom+1,o))continue;let i=e.bottom;for(;t(i+1,o);)i+=1;if(i>e.bottom)return i}}function dt(n,e,t){if(!K(n))return n;const o=q(n);if(!o.ok)return n;const i=rt(o.node,s=>s.kind!=="ref"?s:s.sheet===void 0?{...s,sheet:e}:s.sheet.toLowerCase()!==t.toLowerCase()||s.lastSheet!==void 0?s:Object.fromEntries(Object.entries(s).filter(([r])=>r!=="sheet")));return st(i)}function ht(n){const e=I();e.whole=!0;for(const t of n){t.file&&(e.file=t.file);for(const[o,i]of t.rows)e.rows.set(o,i)}return e}function S(n,e){const t=e.file??n.file,o=new Map(n.rows);for(const[i,s]of e.rows)o.set(i,s);return{file:t,rows:o,workbook:ft({file:t,rows:i=>o.get(i)})}}export function moveCells(n,e,t,o,i){const s=n.workbook.sheet(e),r=n.workbook.sheet(o);if(!s||!r)return x("no-sheet");const f=i.row-t.top,l=i.col-t.left;if(f===0&&l===0&&s===r)return I();const a={top:i.row,left:i.col,bottom:t.bottom+f,right:t.right+l},b=s.tables.filter(c=>v(t,c.area.top,c.area.left)&&v(t,c.area.bottom,c.area.right));for(const c of s.tables)if(!b.includes(c)&&A(c.area,t)&&t.top<=c.at.row)return x("table-move");if(b.length>0&&s!==r)return x("table-move");for(const c of r.tables)if(!b.includes(c)&&A(c.area,a)&&a.top<=c.at.row)return x("table-move");const g={op:"move-cells",sheet:e,area:t,rows:f,columns:l,...s===r?{}:{to:o}},L=it(n,g),y={...I(),file:L.file,rows:new Map(L.rows)},u=S(n,y),w=u.workbook.sheet(e),k=u.workbook.sheet(o);if(!w||!k)return x("no-sheet");const m=[],O=[],T=Math.min(t.right,w.columnsUsed-1),p=Math.min(t.bottom,w.lastRow),P=(c,d)=>b.some(h=>v(h.area,c,d));for(let c=t.top;c<=p;c++)for(let d=t.left;d<=T;d++)if(!P(c,d)){if(w.at(c,d)!==void 0){const h=U(u,w,c,d);m.push({row:c+f,col:d+l,text:s===r?h:dt(h,e,o)})}O.push({from:{row:c,col:d},to:{row:c+f,col:d+l}})}const F=Z(u,e,t);if(F.refused!==void 0)return F;const M=S(u,F),j=[y,F];let z=M;if(b.length>0){const c=new E(M),d=M.workbook.sheet(e);if(!d)return x("no-sheet");for(const J of b){const B=d.tables.find(V=>V.name===J.name);if(!B)continue;const Q=c.table(d,B);Q.at=X({row:J.at.row+f,col:J.at.col+l})}const h=c.finish();j.push(h),z=S(M,h)}const C=ot(z,o,m);if(C.refused!==void 0)return C;j.push(C);const D=S(z,C),_=D.workbook.sheet(e),$=D.workbook.sheet(o);if(_&&$){const c=new E(D);copyLooks(c,w,$,O);const d=O.map(h=>h.from).filter(h=>!(s===r&&v(a,h.row,h.col))&&Object.keys(w.lookAt(h.row,h.col)).length>0);for(const h of N(d))R(c,_,h,NO_LOOK);j.push(c.finish())}return ht(j)}

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

@@ -0,0 +1,29 @@
+import { type Area, type Place } from "./address.js";
+import type { Calc } from "./calc/engine.js";
+import type { Scalar } from "./values.js";
+import type { Filter, Worksheet } from "./workbook.js";
+/** The rows a sheet's filters hide. */
+export declare function filteredRows(sheet: Worksheet, calc: Calc): Set<number>;
+export interface FilterChoice {
+    /** As the column shows it. */
+    text: string;
+    /** How many rows hold it. */
+    count: number;
+    /** Ticked. */
+    on: boolean;
+    value: Scalar;
+}
+/** A column's values for its list: each once, in order, those other columns' filters leave. */
+export declare function filterChoices(sheet: Worksheet, calc: Calc, filter: Filter, col: number): {
+    values: FilterChoice[];
+    blanks: {
+        count: number;
+        on: boolean;
+    } | undefined;
+};
+/**
+ * The rectangle of cells around a place that hold something, as Excel's
+ * Current Region: what Sort and Filter take when one cell is selected.
+ */
+export declare function regionAround(sheet: Worksheet, place: Place): Area | undefined;
+//# sourceMappingURL=filter.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import"./address.js";import{compareForSort as C}from"./sort.js";import{shownValue as h}from"./format.js";import{choicesIn as x}from"./validate.js";const g=(o,e,r,t)=>h(e.value(o,r,t),o.lookAt(r,t).format),b=(o,e)=>{if(e==="")return o.blanks===!0;const r=e.toLowerCase();return o.values?.some(t=>t.toLowerCase()===r)===!0};function v(o,e,r,t){const s=o.validations.length===0?void 0:o.validationAt(e,r);return s?.spec.multiple===!0?x(t,s.spec):[t]}function k(o,e,r,t,s){for(const[n,u]of r.columns){if(n===s)continue;const f=g(o,e,t,n);if(f===""){if(u.blanks!==!0)return!1;continue}if(!v(o,t,n,f).some(a=>b(u,a)))return!1}return!0}export function filteredRows(o,e){const r=new Set;for(const t of o.filters){if(t.columns.size===0)continue;const{top:s,bottom:n}=t.area,u=Math.min(n,o.lastRow);for(let f=s+1;f<=u;f++)k(o,e,t,f)||r.add(f)}return r}export function filterChoices(o,e,r,t){const s=r.columns.get(t),n=new Map;let u=0;const{top:f,bottom:a}=r.area,i=Math.min(a,o.lastRow);for(let l=f+1;l<=i;l++){if(!k(o,e,r,l,t))continue;const c=g(o,e,l,t);if(c===""){u+=1;continue}const d=v(o,l,t,c);for(const m of d){const p=m.toLowerCase(),w=n.get(p);w?w.count+=1:n.set(p,{text:m,count:1,on:s===void 0||b(s,m),value:d.length>1?m:e.value(o,l,t)})}}return{values:[...n.values()].sort((l,c)=>C(l.value,c.value)),blanks:u===0?void 0:{count:u,on:s===void 0||s.blanks===!0}}}export function regionAround(o,e){const r=(n,u)=>n>=0&&u>=0&&(o.at(n,u)!==void 0||o.spillAt(n,u)!==void 0),t={top:e.row,left:e.col,bottom:e.row,right:e.col};for(let n=!0;n;){n=!1;const u=a=>{for(let i=t.left-1;i<=t.right+1;i++)if(r(a,i))return!0;return!1},f=a=>{for(let i=t.top-1;i<=t.bottom+1;i++)if(r(i,a))return!0;return!1};u(t.top-1)&&(t.top-=1,n=!0),u(t.bottom+1)&&(t.bottom+=1,n=!0),f(t.left-1)&&(t.left-=1,n=!0),f(t.right+1)&&(t.right+=1,n=!0)}return t.top===t.bottom&&t.left===t.right&&!r(t.top,t.left)?void 0:t}

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

@@ -0,0 +1,9 @@
+import { type Scalar } from "./values.js";
+/** 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

@@ -0,0 +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}

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

@@ -0,0 +1,113 @@
+import type { ErrorCode } from "../values.js";
+/** One edge of a reference: `A`, or `$A` when it stays as a fill moves it. */
+export interface Bound {
+    index: number;
+    abs: boolean;
+}
+/**
+ * A1, A1:B2, A:B or 1:2, with its sheet when it names one. A cell has `col`
+ * and `row`; a range has their ends too; whole columns have no rows and
+ * whole rows no columns.
+ */
+export interface RefNode {
+    kind: "ref";
+    sheet?: string;
+    /** The last sheet of a 3D reference: Jan:Dec!A1. */
+    lastSheet?: string;
+    col?: Bound;
+    row?: Bound;
+    col2?: Bound;
+    row2?: Bound;
+    /** Two ends written, even when they are the same place: A1:A1. */
+    range: boolean;
+}
+/** The sections a structured reference can name. */
+export declare const TABLE_SECTIONS: readonly ["#All", "#Data", "#Headers", "#Totals", "#This Row"];
+export type TableSection = (typeof TABLE_SECTIONS)[number];
+/** orders[total], [@price], orders[[#Headers],[a]:[b]]. */
+export interface StructuredNode {
+    kind: "structured";
+    /** Absent: the table the formula is in. */
+    table?: string;
+    sections: TableSection[];
+    /** One column, or the two ends of a run of them; none: every column. */
+    columns: string[];
+    /** Written with @: the formula's own row. */
+    thisRow: boolean;
+}
+export type BinaryOp = "+" | "-" | "*" | "/" | "^" | "&" | "=" | "<>" | "<" | "<=" | ">" | ">="
+/** The range operator between what are not two plain cells: A1:INDEX(…). */
+ | ":"
+/** Intersection: a space. */
+ | " "
+/** Union, inside parentheses. */
+ | ",";
+export type Node = {
+    kind: "number";
+    value: number;
+    raw: string;
+} | {
+    kind: "string";
+    value: string;
+} | {
+    kind: "boolean";
+    value: boolean;
+} | {
+    kind: "error";
+    code: ErrorCode;
+    sheet?: string;
+}
+/** A function's argument left empty. */
+ | {
+    kind: "missing";
+} | RefNode | StructuredNode | {
+    kind: "name";
+    name: string;
+    sheet?: string;
+} | {
+    kind: "unary";
+    op: "-" | "+" | "@";
+    arg: Node;
+} | {
+    kind: "postfix";
+    op: "%" | "#";
+    arg: Node;
+} | {
+    kind: "binary";
+    op: BinaryOp;
+    left: Node;
+    right: Node;
+}
+/** `name` in capitals, what it is looked up by; `written` as the formula has it. */
+ | {
+    kind: "call";
+    name: string;
+    written: string;
+    args: Node[];
+}
+/** What a formula gives, called: LAMBDA(x, x + 1)(2). */
+ | {
+    kind: "invoke";
+    callee: Node;
+    args: Node[];
+} | {
+    kind: "array";
+    rows: Node[][];
+} | {
+    kind: "paren";
+    arg: Node;
+};
+/** A formula that does not parse, and where in its text. */
+export interface ParseError {
+    message: string;
+    /** Characters into the formula's text, the = included. */
+    at: number;
+}
+export type Parsed = {
+    ok: true;
+    node: Node;
+} | {
+    ok: false;
+    error: ParseError;
+};
+//# sourceMappingURL=ast.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/formula/ast.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const TABLE_SECTIONS=["#All","#Data","#Headers","#Totals","#This Row"];

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

@@ -0,0 +1,6 @@
+import type { Node } from "./ast.js";
+/** A formula as it reads `rows` down and `columns` across from where it is. */
+export declare function moveFormula(node: Node, rows: number, columns: number): Node;
+/** The same text for every cell a fill of one formula gives: its relative references as distances. */
+export declare function relativeKey(node: Node, row: number, col: number): string;
+//# sourceMappingURL=move.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/formula/move.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{MAX_COLUMNS as n,MAX_ROWS as l}from"../address.js";import{mapNode as a}from"./walk.js";function u(o,t,e){if(o.abs||t===0)return o;const r=o.index+t;return r<0||r>=e?void 0:{...o,index:r}}function m(o,t,e){const r=o.col&&u(o.col,e,n),i=o.col2&&u(o.col2,e,n),c=o.row&&u(o.row,t,l),f=o.row2&&u(o.row2,t,l),d=(s,w)=>s!==void 0&&w===void 0;return d(o.col,r)||d(o.col2,i)||d(o.row,c)||d(o.row2,f)?{kind:"error",code:"#REF!",...o.sheet===void 0?{}:{sheet:o.sheet}}:r===o.col&&i===o.col2&&c===o.row&&f===o.row2?o:{...o,...r?{col:r}:{},...i?{col2:i}:{},...c?{row:c}:{},...f?{row2:f}:{}}}export function moveFormula(o,t,e){return t===0&&e===0?o:a(o,r=>r.kind==="ref"?m(r,t,e):r)}export function relativeKey(o,t,e){return JSON.stringify(o,(r,i)=>{const c=i;return(r==="col"||r==="col2"||r==="row"||r==="row2")&&c?.abs===!1?[c.index-(r.startsWith("col")?e:t)]:i})}

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

@@ -0,0 +1,4 @@
+import { type Parsed } from "./ast.js";
+/** A formula's text, with or without its =, as a tree. */
+export declare function parseFormula(text: string): Parsed;
+//# sourceMappingURL=parse.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/formula/parse.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{MAX_COLUMNS as y,MAX_ROWS as l,columnIndex as d}from"../address.js";import{errorOf as v}from"../values.js";import{TABLE_SECTIONS as N}from"./ast.js";class m extends Error{at;constructor(t,s){super(t),this.at=s}}const R=new Set(["=","<>","<","<=",">",">="]),b={"=":1,"<>":1,"<":1,"<=":1,">":1,">=":1,"&":2,"+":3,"-":3,"*":4,"/":4,"^":5},g=i=>i>="0"&&i<="9",p=i=>/[\p{L}_\\]/u.test(i)||i>="\uD800"&&i<="\uDFFF",w=i=>/[\p{L}\p{N}\p{M}_.?\\]/u.test(i)||i>="\uD800"&&i<="\uDFFF",f=(i,t)=>({index:i,abs:t});class C{at=0;s;constructor(t){this.s=t}blanks(){const t=this.at;for(;/\s/u.test(this.s.charAt(this.at));)this.at+=1;return this.at>t}peek(t){return this.s.startsWith(t,this.at)}eat(t){return this.peek(t)?(this.at+=t.length,!0):!1}stop(t,s=this.at){throw new m(t,s)}parse(){this.eat("="),this.blanks(),this.at>=this.s.length&&this.stop("a formula with nothing in it");const t=this.expression(0);return this.blanks(),this.at<this.s.length&&this.stop(`"${this.s.charAt(this.at)}" where an operator should be`),t}operator(){this.blanks();const t=this.s.slice(this.at,this.at+2);if(R.has(t))return t;const s=this.s.charAt(this.at);return b[s]===void 0?void 0:s}expression(t){let s=this.prefix();for(;;){const e=this.operator();if(e===void 0)return s;const n=b[e]??0;if(n<=t)return s;this.at+=e.length,this.blanks();const r=this.expression(n);s={kind:"binary",op:e,left:s,right:r}}}prefix(){this.blanks();for(const t of["-","+","@"])if(this.eat(t))return{kind:"unary",op:t,arg:this.prefix()};return this.postfix()}postfix(){let t=this.references();for(;;){const s=this.at;if(this.blanks(),this.eat("%")){t={kind:"postfix",op:"%",arg:t};continue}if(this.at=s,this.peek("#")&&!A(this.s,this.at)){this.at+=1,t={kind:"postfix",op:"#",arg:t};continue}if(this.peek("(")&&(t.kind==="call"||t.kind==="paren")){const{args:e}=this.call("");t={kind:"invoke",callee:t,args:e};continue}return t}}references(){let t=this.primary();for(;;){if(this.peek(":")){this.at+=1,this.blanks();const e=this.primary();t={kind:"binary",op:":",left:t,right:e};continue}const s=this.at;if(E(t)&&this.blanks()&&this.startsReference()){const e=this.primary();t={kind:"binary",op:" ",left:t,right:e};continue}return this.at=s,t}}startsReference(){const t=this.s.charAt(this.at);return t==="$"||t==="'"||t==="("||t==="["||p(t)}primary(){this.blanks();const t=this.s.charAt(this.at);if(t===""&&this.stop("the formula ends where a value should be"),t==="(")return this.parenthesis();if(t==="{")return this.arrayConstant();if(t==='"')return{kind:"string",value:this.text()};if(g(t)||t==="."){const s=k(this.s,this.at);return s?(this.at=s.end,{kind:"ref",...s.ref}):this.number()}return t==="#"?this.errorLiteral(void 0):t==="["?this.bracket(void 0):t==="$"||t==="'"||p(t)?this.word():this.stop(`"${t}" where a value should be`)}parenthesis(){const t=this.at;this.at+=1;let s=this.expression(0);for(this.blanks();this.eat(",");){const e=this.expression(0);s={kind:"binary",op:",",left:s,right:e},this.blanks()}return this.eat(")")||this.stop("a ( that is never closed",t),{kind:"paren",arg:s}}number(){const t=/^(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?/u.exec(this.s.slice(this.at));return t?(this.at+=t[0].length,{kind:"number",value:Number(t[0]),raw:t[0]}):this.stop("a number that is not one")}text(){const t=this.at;this.at+=1;let s="";for(;;){this.at>=this.s.length&&this.stop('a " that is never closed',t);const e=this.s.charAt(this.at);if(e==='"'){if(this.s.charAt(this.at+1)!=='"')return this.at+=1,s;this.at+=1}s+=e,this.at+=1}}errorLiteral(t){const s=A(this.s,this.at);return s===void 0?this.stop("a # that names no error"):(this.at+=s.length,{kind:"error",code:s,...t===void 0?{}:{sheet:t}})}arrayConstant(){const t=this.at;this.at+=1;const s=[[]];for(;;)if(this.blanks(),s[s.length-1]?.push(this.arrayItem()),this.blanks(),!this.eat(",")){if(this.eat(";")){s.push([]);continue}if(this.eat("}"))break;this.stop("a { that is never closed",t)}const e=s[0]?.length;return s.some(n=>n.length!==e)&&this.stop("an array whose rows are not all as long",t),{kind:"array",rows:s}}arrayItem(){const t=this.s.charAt(this.at);if(t==='"')return{kind:"string",value:this.text()};if(t==="#")return this.errorLiteral(void 0);if(t==="-"||t==="+")return this.at+=1,{kind:"unary",op:t,arg:this.number()};if(g(t)||t===".")return this.number();const s=this.name(),e=s.toUpperCase();return e==="TRUE"||e==="FALSE"?{kind:"boolean",value:e==="TRUE"}:this.stop(`${s} in an array: an array holds only constants`)}name(){const t=this.at;for(;this.at<this.s.length&&w(this.s.charAt(this.at));)this.at+=1;return this.s.slice(t,this.at)}quoted(){const t=this.at;this.at+=1;let s="";for(;;){this.at>=this.s.length&&this.stop("a ' that is never closed",t);const e=this.s.charAt(this.at);if(e==="'"){if(this.s.charAt(this.at+1)!=="'")return this.at+=1,s;this.at+=1}s+=e,this.at+=1}}word(){const t=this.sheetPrefix();if(t)return this.afterSheet(t.first,t.last);const s=k(this.s,this.at);if(s)return this.at=s.end,{kind:"ref",...s.ref};const e=x(this.s,this.at);if(e)return this.at=e.end,{kind:"ref",...e.ref};if(this.peek("$"))return this.stop('a "$" that is not part of a reference');const n=this.at,r=this.name();if(r==="")return this.stop(`"${this.s.charAt(n)}" in a name`);if(this.peek("("))return this.call(r);if(this.peek("["))return this.bracket(r);const h=r.toUpperCase();return h==="TRUE"||h==="FALSE"?{kind:"boolean",value:h==="TRUE"}:{kind:"name",name:r}}sheetPrefix(){const t=this.at;if(this.peek("'")){const e=this.quoted();if(!this.eat("!")){this.at=t;return}const n=e.indexOf(":");return n>0?{first:e.slice(0,n),last:e.slice(n+1)}:{first:e}}const s=this.name();if(s!==""&&this.eat("!"))return{first:s};if(s!==""&&this.eat(":")){const e=this.name();if(e!==""&&this.eat("!"))return{first:s,last:e}}this.at=t}afterSheet(t,s){const e={sheet:t,...s===void 0?{}:{lastSheet:s}};if(this.peek("#"))return this.errorLiteral(t);const n=k(this.s,this.at);if(n)return this.at=n.end,{kind:"ref",...e,...n.ref};const r=x(this.s,this.at);if(r)return this.at=r.end,{kind:"ref",...e,...r.ref};const h=this.name();return h===""?this.stop(`nothing after ${t}!`):{kind:"name",name:h,sheet:t}}call(t){const s=this.at;this.at+=1;const e=[];this.blanks();const n=()=>({kind:"call",name:t.toUpperCase(),written:t,args:e});if(this.eat(")"))return n();for(;;)if(this.blanks(),this.peek(",")||this.peek(")")?e.push({kind:"missing"}):e.push(this.expression(0)),this.blanks(),!this.eat(",")){if(this.eat(")"))return n();this.stop(`a ( of ${t.toUpperCase()} that is never closed`,s)}}columnName(){let t="";for(;;){this.at>=this.s.length&&this.stop("a [ that is never closed");const s=this.s.charAt(this.at);if(s==="]")return t;if(s==="["&&this.stop("a [ inside a column's name"),s==="'"){this.at+=1,t+=this.s.charAt(this.at),this.at+=1;continue}t+=s,this.at+=1}}bracket(t){const s=this.at;this.at+=1;const e={kind:"structured",...t===void 0?{}:{table:t},sections:[],columns:[],thisRow:!1};if(this.eat("]"))return e;if(!(this.peek("[")||this.peek("#")||this.peek("@"))){const r=this.columnName();return this.at+=1,t===void 0&&/[!']/u.test(this.s.charAt(this.at))&&this.stop("a formula that reaches into another workbook",s),t===void 0&&p(this.s.charAt(this.at))&&this.stop("a formula that reaches into another workbook",s),e.columns=[r.trim()],e}return this.eat("@")?(e.thisRow=!0,this.eat("]")||(this.peek("[")?this.items(e):e.columns=[this.columnName().trim()],this.eat("]")||this.stop("a [ that is never closed",s)),e):(this.items(e),this.eat("]")||this.stop("a [ that is never closed",s),e)}items(t){for(;;){if(this.blanks(),this.peek("#"))this.section(t);else if(this.eat("["))if(this.peek("#"))this.section(t),this.eat("]")||this.stop("a [ that is never closed");else{const s=this.columnName().trim();this.at+=1,t.columns.push(s),this.eat(":")&&(this.eat("[")||this.stop("a column's name after :"),t.columns.push(this.columnName().trim()),this.at+=1)}else this.stop("a column or a section of a table");if(this.blanks(),!this.eat(","))return}}section(t){const s=this.s.slice(this.at).toLowerCase(),e=N.find(n=>s.startsWith(n.toLowerCase()));e===void 0&&this.stop("a section of a table that is not one"),this.at+=e.length,e==="#This Row"?t.thisRow=!0:t.sections.push(e)}}const E=i=>i.kind==="ref"||i.kind==="name"||i.kind==="structured"||i.kind==="call"||i.kind==="paren"||i.kind==="binary"&&(i.op===":"||i.op===" ");function A(i,t){const s=/^#[A-Za-z0-9_/]+[!?]?/u.exec(i.slice(t));return s?v(s[0])?.code:void 0}const u=(i,t)=>{const s=i.charAt(t);return s!==""&&(w(s)||s==="("||s==="!"||s==="[")};function x(i,t){const s=i.slice(t),e=/^(\$?)([A-Za-z]{1,3}):(\$?)([A-Za-z]{1,3})/u.exec(s);if(e){const a=t+e[0].length,o=d(e[2]??""),c=d(e[4]??"");if(o!==void 0&&c!==void 0&&!u(i,a))return{ref:{col:f(o,e[1]==="$"),col2:f(c,e[3]==="$"),range:!0},end:a}}const n=/^(\$?)([A-Za-z]{1,3})(\$?)([1-9]\d*)/u.exec(s);if(!n)return;const r=$(n),h=t+n[0].length;if(!(!r||u(i,h))){if(i.charAt(h)===":"){const a=/^(\$?)([A-Za-z]{1,3})(\$?)([1-9]\d*)/u.exec(i.slice(h+1));if(a){const o=$(a),c=h+1+a[0].length;if(o&&!u(i,c))return{ref:{...r,col2:o.col,row2:o.row,range:!0},end:c}}}return{ref:{...r,range:!1},end:h}}}function $(i){const t=d(i[2]??""),s=Number(i[4])-1;if(!(t===void 0||t>=y||s>=l))return{col:f(t,i[1]==="$"),row:f(s,i[3]==="$")}}function k(i,t){const s=/^(\$?)([1-9]\d*):(\$?)([1-9]\d*)/u.exec(i.slice(t));if(!s)return;const e=t+s[0].length,n=Number(s[2])-1,r=Number(s[4])-1;if(!(n>=l||r>=l||u(i,e)))return{ref:{row:f(n,s[1]==="$"),row2:f(r,s[3]==="$"),range:!0},end:e}}export function parseFormula(i){try{return{ok:!0,node:new C(i).parse()}}catch(t){if(t instanceof m)return{ok:!1,error:{message:t.message,at:t.at}};throw t}}

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

@@ -0,0 +1,6 @@
+import type { Node } from "./ast.js";
+/** A sheet's name as a formula writes it: quoted when it has to be. */
+export declare function sheetPrefix(sheet: string, last?: string): string;
+/** A tree as a formula's text, its = included. */
+export declare const printFormula: (node: Node) => string;
+//# sourceMappingURL=print.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/formula/print.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{columnLetter as l}from"../address.js";const $=e=>`${e.abs?"$":""}${l(e.index)}`,s=e=>`${e.abs?"$":""}${String(e.index+1)}`;export function sheetPrefix(e,r){const t=r===void 0?e:`${e}:${r}`;return/^[\p{L}_][\p{L}\p{N}_.]*$/u.test(e)&&!/^[A-Za-z]{1,3}\d+$/u.test(e)&&!/^(?:TRUE|FALSE)$/iu.test(e)&&(r===void 0||/^[\p{L}_][\p{L}\p{N}_.]*$/u.test(r))?`${t}!`:`'${t.replaceAll("'","''")}'!`}function f(e){const r=e.sheet===void 0?"":sheetPrefix(e.sheet,e.lastSheet);if(e.row===void 0&&e.col&&e.col2)return`${r}${$(e.col)}:${$(e.col2)}`;if(e.col===void 0&&e.row&&e.row2)return`${r}${s(e.row)}:${s(e.row2)}`;if(!e.col||!e.row)return`${r}#REF!`;const t=`${$(e.col)}${s(e.row)}`;return e.col2&&e.row2?`${r}${t}:${$(e.col2)}${s(e.row2)}`:`${r}${t}`}const c=e=>e.replace(/([[\]#'@])/gu,"'$1"),p=e=>/^[\p{L}\p{N}_]+$/u.test(e);function d(e){const r=e.table??"",[t,i]=e.columns,u=e.columns.map(n=>`[${c(n)}]`).join(":");if(e.sections.length===0)return e.thisRow?t===void 0?`${r}[@]`:i!==void 0?`${r}[@${u}]`:`${r}[@${p(t)?c(t):u}]`:t===void 0?r===""?"[]":r:i!==void 0?`${r}[${u}]`:`${r}[${c(t)}]`;if(t===void 0&&e.sections.length===1)return`${r}[${e.sections[0]??""}]`;const a=e.sections.map(n=>`[${n}]`);return u!==""&&a.push(u),`${r}[${a.join(",")}]`}function o(e){switch(e.kind){case"number":return e.raw;case"string":return`"${e.value.replaceAll('"','""')}"`;case"boolean":return e.value?"TRUE":"FALSE";case"error":return`${e.sheet===void 0?"":sheetPrefix(e.sheet)}${e.code}`;case"missing":return"";case"ref":return f(e);case"structured":return d(e);case"name":return`${e.sheet===void 0?"":sheetPrefix(e.sheet)}${e.name}`;case"unary":return`${e.op}${o(e.arg)}`;case"postfix":return`${o(e.arg)}${e.op}`;case"binary":return`${o(e.left)}${e.op}${o(e.right)}`;case"call":return`${e.written}(${e.args.map(o).join(",")})`;case"invoke":return`${o(e.callee)}(${e.args.map(o).join(",")})`;case"array":return`{${e.rows.map(r=>r.map(o).join(",")).join(";")}}`;case"paren":return`(${o(e.arg)})`}}export const printFormula=e=>`=${o(e)}`;

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

@@ -0,0 +1,65 @@
+import { type Area } from "../address.js";
+import type { Node } from "./ast.js";
+export type StructureEdit = {
+    op: "insert-rows";
+    sheet: string;
+    at: number;
+    count: number;
+} | {
+    op: "delete-rows";
+    sheet: string;
+    at: number;
+    count: number;
+} | {
+    op: "insert-columns";
+    sheet: string;
+    at: number;
+    count: number;
+} | {
+    op: "delete-columns";
+    sheet: string;
+    at: number;
+    count: number;
+} | {
+    op: "rename-sheet";
+    from: string;
+    to: string;
+} | {
+    op: "rename-table";
+    from: string;
+    to: string;
+} | {
+    op: "rename-column";
+    table: string;
+    from: string;
+    to: string;
+} | {
+    op: "rename-name";
+    from: string;
+    to: string;
+} | {
+    op: "delete-sheet";
+    name: string;
+} | {
+    op: "delete-table";
+    name: string;
+} | {
+    op: "delete-column";
+    table: string;
+    name: string;
+} | {
+    op: "move-cells";
+    sheet: string;
+    area: Area;
+    rows: number;
+    columns: number;
+    /** The sheet they went to, when not their own. */
+    to?: string;
+};
+/**
+ * A formula after an edit of its workbook. `own` is the sheet it is on, what
+ * a reference without a sheet is on; `table`, the table it is in, what a
+ * column named without a table is in. The same tree when nothing changed.
+ */
+export declare function rewriteFormula(node: Node, edit: StructureEdit, own: string, table?: string): Node;
+//# sourceMappingURL=rewrite.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/formula/rewrite.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{MAX_COLUMNS as b,MAX_ROWS as M}from"../address.js";import{mapNode as S}from"./walk.js";const u=(r,n)=>r?.toLowerCase()===n?.toLowerCase(),k=(r,n,s)=>r.index>=n?{...r,index:r.index+s}:r;function O(r,n,s){if(r.index<n)return r;if(r.index>=n+s)return{...r,index:r.index-s}}function R(r,n,s,i){const o=r.index<=n.index?r:n,e=o===r?n:r,t=k(o,s,i),c=e.index>=s?{...e,index:e.index+i}:e;return o===r?[t,c]:[c,t]}function C(r,n,s,i){const o=r.index<=n.index?r:n,e=o===r?n:r,t=s+i-1;if(o.index>=s&&e.index<=t)return;const c=o.index<s?o:o.index>t?{...o,index:o.index-i}:{...o,index:s},a=e.index<s?e:e.index>t?{...e,index:e.index-i}:{...e,index:s-1};return o===r?[c,a]:[a,c]}function x(r){return{kind:"error",code:"#REF!",...r.sheet===void 0?{}:{sheet:r.sheet}}}const h={kind:"error",code:"#REF!"};function E(r,n,s){if(!u(r.sheet??s,n.sheet)||r.lastSheet!==void 0)return r;const{col:i,row:o}=r;if(i===void 0||o===void 0)return r;const e=r.col2??i,t=r.row2??o,{area:c,rows:a,columns:d,to:m}=n;if(!(Math.min(i.index,e.index)>=c.left&&Math.max(i.index,e.index)<=c.right&&Math.min(o.index,t.index)>=c.top&&Math.max(o.index,t.index)<=c.bottom))return r;const f=(l,p)=>({...l,index:l.index+p}),w={...r,col:f(i,d),row:f(o,a),...r.col2?{col2:f(r.col2,d)}:{},...r.row2?{row2:f(r.row2,a)}:{}};return m===void 0?w:u(m,s)?Object.fromEntries(Object.entries(w).filter(([l])=>l!=="sheet")):{...w,sheet:m}}function g(r,n,s){if(!u(r.sheet??s,n.sheet)||r.lastSheet!==void 0)return r;const i=n.op==="insert-rows"||n.op==="delete-rows",o=i?r.row:r.col,e=i?r.row2:r.col2;if(o===void 0)return r;const t=i?["row","row2"]:["col","col2"],c=n.op==="insert-rows"||n.op==="insert-columns",a=i?M:b;if(e===void 0){const m=c?k(o,n.at,n.count):O(o,n.at,n.count);return!m||m.index>=a?x(r):m===o?r:{...r,[t[0]]:m}}const d=c?R(o,e,n.at,n.count):C(o,e,n.at,n.count);return!d||d[0].index>=a||d[1].index>=a?x(r):d[0]===o&&d[1]===e?r:{...r,[t[0]]:d[0],[t[1]]:d[1]}}export function rewriteFormula(r,n,s,i){const o=(e,t)=>e===void 0?i===void 0||u(i,t):u(e,t);return S(r,e=>{switch(n.op){case"rename-sheet":return(e.kind==="ref"||e.kind==="name"||e.kind==="error")&&u(e.sheet,n.from)?{...e,sheet:n.to}:e.kind==="ref"&&u(e.lastSheet,n.from)?{...e,lastSheet:n.to}:e;case"rename-table":return e.kind==="structured"&&u(e.table,n.from)?{...e,table:n.to}:e;case"delete-sheet":return e.kind==="ref"&&u(e.sheet,n.name)||e.kind==="ref"&&u(e.lastSheet,n.name)?x(e):e.kind==="name"&&u(e.sheet,n.name)?h:e;case"delete-table":return e.kind==="structured"&&u(e.table,n.name)||e.kind==="name"&&u(e.name,n.name)?h:e;case"delete-column":return e.kind==="structured"&&o(e.table,n.table)&&e.columns.some(t=>u(t,n.name))?h:e;case"rename-column":return e.kind==="structured"&&o(e.table,n.table)&&e.columns.some(t=>u(t,n.from))?{...e,columns:e.columns.map(t=>u(t,n.from)?n.to:t)}:e;case"rename-name":return e.kind==="name"&&u(e.name,n.from)?{...e,name:n.to}:e.kind==="call"&&u(e.name,n.from)?{...e,name:n.to.toUpperCase(),written:n.to}:e;case"move-cells":return e.kind==="ref"?E(e,n,s):e;default:return e.kind==="ref"?g(e,n,s):e}})}

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

@@ -0,0 +1,6 @@
+import type { Node } from "./ast.js";
+/** A tree with `change` made to each node, children first; the same object where nothing changed. */
+export declare function mapNode(node: Node, change: (n: Node) => Node): Node;
+/** Every node of a tree, each before its children. */
+export declare function walk(node: Node, visit: (n: Node) => void): void;
+//# sourceMappingURL=walk.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/formula/walk.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export function mapNode(r,e){const a=l(r,e);return e(a)}function l(r,e){switch(r.kind){case"unary":case"postfix":case"paren":{const a=mapNode(r.arg,e);return a===r.arg?r:{...r,arg:a}}case"binary":{const a=mapNode(r.left,e),s=mapNode(r.right,e);return a===r.left&&s===r.right?r:{...r,left:a,right:s}}case"call":{const a=r.args.map(s=>mapNode(s,e));return a.every((s,c)=>s===r.args[c])?r:{...r,args:a}}case"invoke":{const a=mapNode(r.callee,e),s=r.args.map(c=>mapNode(c,e));return a===r.callee&&s.every((c,t)=>c===r.args[t])?r:{...r,callee:a,args:s}}case"array":{const a=r.rows.map(s=>s.map(c=>mapNode(c,e)));return a.every((s,c)=>s.every((t,o)=>t===r.rows[c]?.[o]))?r:{...r,rows:a}}default:return r}}export function walk(r,e){switch(e(r),r.kind){case"unary":case"postfix":case"paren":walk(r.arg,e);break;case"binary":walk(r.left,e),walk(r.right,e);break;case"call":for(const a of r.args)walk(a,e);break;case"invoke":walk(r.callee,e);for(const a of r.args)walk(a,e);break;case"array":for(const a of r.rows)for(const s of a)walk(s,e);break;default:break}}

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

@@ -0,0 +1,46 @@
+import { type SheetFile, type SheetWorksheet } from "@allyhub-next/formats";
+import type { BookEdit } from "./edit.js";
+/** Where a generated CSV file is named, so it never stands for one on disk. */
+export declare const GENERATED = "sheet.ts/";
+export interface GeneratedSheets {
+    /** The sheets it makes, in the order it made them, as sheet.yaml would hold them. */
+    sheets: SheetWorksheet[];
+    /** Names it defines. */
+    names?: NonNullable<SheetFile["names"]>;
+    /** Its tables' and blocks' rows, as CSV text, by the paths its sheets name. */
+    csv: Record<string, string>;
+    /** Numbers it typed that neither its data nor its code holds. */
+    typed?: {
+        sheet: string;
+        cell: string;
+        value: number;
+    }[];
+}
+export interface MergedFile {
+    file: SheetFile;
+    /** How many of its sheets, the first ones, are sheet.yaml's. */
+    own: number;
+    /** Names that are sheet.ts's. */
+    names: ReadonlySet<string>;
+    /** Sheets sheet.ts makes that sheet.yaml holds: sheet.yaml's stand. */
+    ordinary: string[];
+}
+/** sheet.yaml with what sheet.ts makes after it. */
+export declare function withGenerated(file: SheetFile, generated: GeneratedSheets | undefined): MergedFile;
+/**
+ * A generated sheet as an ordinary one: its spec in sheet.yaml and its rows in
+ * CSV files of their own, where `taken` says no file stands. From then on
+ * sheet.yaml holds that name, so what sheet.ts makes of it is left out; taking
+ * the sheet out of sheet.yaml gives it back to the code.
+ */
+export declare function ordinarySheet(book: {
+    file: SheetFile;
+}, generated: GeneratedSheets, name: string, taken?: (path: string) => boolean): BookEdit;
+/** Every number typed on sheets, with where it stands, for what asks whether code computed it. */
+export declare function typedNumbers(sheets: readonly SheetWorksheet[], csv: Readonly<Record<string, string>>): {
+    sheet: string;
+    cell?: string;
+    file?: string;
+    value: number;
+}[];
+//# sourceMappingURL=generated.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{SHEET_CODE as v,SHEET_DATA as w}from"@allyhub-next/formats";import{readCsv as d}from"./csv.js";export const GENERATED=`${v}/`;const l=e=>e.toLowerCase();export function withGenerated(e,n){const a=e.sheets.length;if(!n)return{file:e,own:a,names:new Set,ordinary:[]};const m=new Set(e.sheets.map(s=>l(s.name))),t=n.sheets.filter(s=>!m.has(l(s.name))),c=n.sheets.filter(s=>m.has(l(s.name))).map(s=>s.name),f=new Set(Object.keys(e.names??{}).map(l)),r=Object.entries(n.names??{}).filter(([s])=>!f.has(l(s)));return{file:{...e,sheets:[...e.sheets,...t],...r.length===0?{}:{names:{...e.names,...Object.fromEntries(r)}}},own:a,names:new Set(r.map(([s])=>s)),ordinary:c}}const b=e=>[...(e.tables??[]).map(n=>n.rows),...(e.blocks??[]).map(n=>n.rows)],E=e=>e.toLowerCase().replace(/[^\p{L}\p{N}]+/gu,"-").replace(/^-|-$/gu,"");export function ordinarySheet(e,n,a,m=()=>!1){const t=n.sheets.find(o=>l(o.name)===l(a));if(!t)return{rows:new Map,cells:[],whole:!1,refused:"no-sheet"};const c=new Map,f=new Map;for(const o of b(t)){const p=n.csv[o];if(p===void 0)continue;const h=E(`${t.name} ${o.split("/").pop()??""}`).replace(/-csv$/u,"");let u=`${w}/${h}.csv`;for(let i=2;m(u)||c.has(u);i++)u=`${w}/${h}-${String(i)}.csv`;f.set(o,u),c.set(u,d(p).records.map(i=>i.end===i.start?[]:i.fields))}const r=o=>f.get(o)??o,s=structuredClone(t);for(const o of s.tables??[])o.rows=r(o.rows);for(const o of s.blocks??[])o.rows=r(o.rows);return{file:{...e.file,sheets:[...e.file.sheets,s]},rows:c,cells:[],whole:!0}}export function typedNumbers(e,n){const a=[],m=t=>typeof t=="number"?t:t!==null&&typeof t=="object"?t.value:void 0;for(const t of e){for(const[c,f]of Object.entries(t.cells??{})){const r=m(f);typeof r=="number"&&a.push({sheet:t.name,cell:c,value:r})}for(const c of b(t))d(n[c]??"").records.forEach(f=>{for(const r of f.fields){const s=Number(r);r.trim()!==""&&Number.isFinite(s)&&a.push({sheet:t.name,file:c,value:s})}})}return a}

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

@@ -0,0 +1,34 @@
+import { type Area } from "./address.js";
+import type { Calc } from "./calc/engine.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 interface SheetHtmlOptions {
+    /** The sheets drawn; default every one that is not hidden. */
+    sheets?: readonly Worksheet[];
+    /** Only this area, of the one sheet drawn. */
+    area?: Area;
+    /** Letters over the columns, numbers down the rows and gridlines, as a person sees a sheet. */
+    headings?: boolean;
+    /** Rows drawn at most of each sheet. */
+    rows?: number;
+    /** Columns drawn at most of each sheet. */
+    columns?: number;
+    /** @font-face rules, for a page that has no network. */
+    css?: string;
+    /** The font of a cell that names none. */
+    font?: string;
+    /** A file a `files` column names, from the sheet's folder: a picture is drawn in its cell. */
+    file?: (path: string) => Uint8Array | undefined;
+}
+export interface SheetHtml {
+    html: string;
+    /** Its widest table, px. */
+    width: number;
+    /** What `rows` and `columns` left out, a line per sheet. */
+    cut: string[];
+}
+/** A workbook's sheets as one page of HTML. */
+export declare function sheetHtml(calc: Calc, o?: SheetHtmlOptions): SheetHtml;
+//# sourceMappingURL=html.d.ts.map

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

@@ -0,0 +1,20 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{formatColor as T,isValidFormat as B}from"numfmt";import{cellName as E,columnLetter as C,contains as I,overlaps as N}from"./address.js";import{chartDef as _,chartPlace as P,chartSize as H,chartSvg as G}from"./chart.js";import{fileCells as U,isPicture as V,pictureHeight as W,pictureSize as q}from"./files.js";import{shownValue as k}from"./format.js";import{Rules as K,iconShape as J}from"./rules.js";import{CellError as Q}from"./values.js";import{placeKey as z}from"./workbook.js";export const DEFAULT_COLUMN_WIDTH=64,DEFAULT_ROW_HEIGHT=20;const X={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"},Y=i=>{let t="";for(let n=0;n<i.length;n+=32768)t+=String.fromCharCode(...i.subarray(n,n+32768));return btoa(t)},y=i=>i.replace(/[&<>"]/gu,t=>X[t]??t),Z={thin:"1px solid",medium:"2px solid",thick:"3px solid",double:"3px double",hair:"1px dotted",dotted:"1px dotted",dashed:"1px dashed",dashDot:"1px dashed",dashDotDot:"1px dashed",mediumDashed:"2px dashed",mediumDashDot:"2px dashed",mediumDashDotDot:"2px dashed",slantDashDot:"2px dashed"},tt={left:"left",center:"center",right:"right",justify:"justify",distributed:"justify",centerContinuous:"center",fill:"left"},et={top:"top",center:"middle",justify:"middle",distributed:"middle"};function nt(i){if(typeof i=="number")return"right";if(typeof i=="boolean"||i instanceof Q)return"center"}const ot={up:"▲","up-right":"◥",right:"▶","down-right":"◢",down:"▼",circle:"●",flag:"⚑",check:"✔",bang:"!",cross:"✖",triangle:"▲",diamond:"◆",bars:"▮",quarter:"◔"};function it(i){const{shape:t,color:n,level:e}=J(i.set,i.index),o=(ot[t]??"●").repeat(t==="bars"?e??1:1);return`<span style="float:left;color:${n}">${o}</span>`}function st(i,t,n){const e=[];i.bold===!0&&e.push("font-weight:bold"),i.italic===!0&&e.push("font-style:italic");const o=[i.underline?"underline":"",i.strike===!0?"line-through":""].filter(Boolean);o.length>0&&e.push(`text-decoration:${o.join(" ")}`),i.font!==void 0&&e.push(`font-family:"${i.font.replace(/["\\]/gu,"")}",var(--font)`),i.size!==void 0&&e.push(`font-size:${String(i.size)}pt`);const r=i.color??(typeof t=="number"&&n!==void 0&&B(n)?T(n,t)??void 0:void 0);typeof r=="string"&&e.push(`color:${r}`);const{fill:s}=i;if(typeof s=="string")e.push(`background:${s}`);else if(s){const c=s.color??s.background;c!==void 0&&e.push(`background:${c}`)}const a=(i.align===void 0||i.align==="general"?void 0:tt[i.align])??nt(t);a!==void 0&&e.push(`text-align:${a}`);const d=i.valign===void 0?void 0:et[i.valign];d!==void 0&&e.push(`vertical-align:${d}`),i.wrap===!0&&e.push("white-space:pre-wrap","overflow-wrap:anywhere"),i.indent!==void 0&&e.push(`padding-left:${String(3+i.indent*9)}px`);for(const c of["left","right","top","bottom"]){const h=i.border?.[c];h&&e.push(`border-${c}:${Z[h.style]??"1px solid"} ${h.color??"#000"}`)}return e.join(";")}class rt{classes=new Map;calc;cut=[];drawnFiles=new Map;pages=[];widest=0;o;rules;constructor(t,n){this.calc=t,this.o=n}classOf(t){if(t==="")return"";let n=this.classes.get(t);return n||(n=`s${String(this.classes.size)}`,this.classes.set(t,n)),n}shown(t,n,e){const o=[];for(let r=t;r<=n;r++)e(r)||o.push(r);return o}spans(t,n,e){const o=new Map,r=new Set;for(const s of t.merges){const a=n.filter(p=>p>=s.top&&p<=s.bottom),d=e.filter(p=>p>=s.left&&p<=s.right),[c]=a,[h]=d;if(!(c===void 0||h===void 0)){for(const p of a)for(const l of d)r.add(`${String(p)}:${String(l)}`);r.delete(`${String(c)}:${String(h)}`),o.set(`${String(c)}:${String(h)}`,{rows:a.length,cols:d.length})}}return{spans:o,covered:r}}width(t,n){const e=C(n),o=t.spec.columns?.[e]?.width;if(o!==void 0)return o;for(const r of t.tables){const s=r.columns[n-r.at.col]?.spec?.width;if(s!==void 0)return s}return DEFAULT_COLUMN_WIDTH}cell(t,n,e,o,r){const s=this.calc.value(t,n,e),a=this.rules?.at(n,e),d={...t.lookAt(n,e),...a?.look,...a?.scale===void 0?{}:{fill:a.scale}},c=d.format,h=t.tables.some($=>n===$.at.row&&I($.area,n,e));let p=st(d,s,c);if(a?.bar){const $=`${String(Math.round(a.bar.share*100))}%`;p=[p,`background:linear-gradient(90deg,${a.bar.color} ${$},transparent ${$})`].filter(Boolean).join(";")}h&&(p=[p,d.bold===void 0?"font-weight:bold":"","border-bottom:1px solid #000"].filter(Boolean).join(";"));const l=typeof s=="string"&&d.wrap!==!0&&r&&!o,u=[this.classOf(p),l?"over":""].filter(Boolean).join(" "),g=[u===""?"":` class="${u}"`,o&&o.rows>1?` rowspan="${String(o.rows)}"`:"",o&&o.cols>1?` colspan="${String(o.cols)}"`:""].join(""),m=a?.icon?it(a.icon):"",w=this.pictures(t).get(z(n,e))??(a?.bare===!0?"":y(k(s,c)));return`<td${g}>${m}${w}</td>`}pictures(t){const n=this.drawnFiles.get(t);if(n)return n.cells;const e=new Map,o=new Map,r=this.o.file;for(const{row:s,col:a,paths:d,column:c}of r?U(t,this.calc):[]){const h=W(c),p=d.map(l=>{const u=V(l)?r?.(l):void 0,g=u&&q(u);if(!u||!g)return y(l);o.set(s,Math.max(o.get(s)??0,h));const m=Y(u);return`<img src="data:image/${g.type};base64,${m}" alt="${y(l)}" style="height:${String(h)}px">`});e.set(z(s,a),p.join(" "))}return this.drawnFiles.set(t,{cells:e,rows:o}),e}sheet(t,n){const{o:e}=this,o=e.area??this.withCharts(t,t.used??{top:0,left:0,bottom:0,right:0}),r=this.calc.filtered(t);this.rules=t.conditions.length>0?new K(t,this.calc):void 0;const s=this.shown(o.top,o.bottom,f=>r.has(f)||t.spec.rows?.[String(f+1)]?.hidden===!0),a=this.shown(o.left,o.right,f=>t.spec.columns?.[C(f)]?.hidden===!0),d=s.slice(0,e.rows??s.length),c=a.slice(0,e.columns??a.length);if(d.length<s.length||c.length<a.length){const f=d[d.length-1]??o.top,x=c[c.length-1]??o.left;this.cut.push(`${t.name}: drew ${E({row:o.top,col:o.left})}:${E({row:f,col:x})} of ${String(s.length)} rows and ${String(a.length)} columns`)}const{spans:h,covered:p}=this.spans(t,d,c),l=e.headings===!0,u=c.map(f=>this.width(t,f)),g=44,m=u.reduce((f,x)=>f+x,0)+(l?g:0),b=[l?`<col style="width:${String(g)}px">`:"",...u.map(f=>`<col style="width:${String(f)}px">`)].join(""),w=[];l&&w.push(`<thead><tr><th></th>${c.map(f=>`<th>${C(f)}</th>`).join("")}</tr></thead>`),w.push("<tbody>");for(const f of d){this.pictures(t);const x=t.spec.rows?.[String(f+1)]?.height??this.drawnFiles.get(t)?.rows.get(f);w.push(`<tr${x===void 0?"":` style="height:${String(x)}px"`}>`),l&&w.push(`<th>${String(f+1)}</th>`),c.forEach((M,L)=>{const A=`${String(f)}:${String(M)}`;if(p.has(A))return;const v=c[L+1],O=v!==void 0&&t.at(f,v)===void 0&&!p.has(`${String(f)}:${String(v)}`);w.push(this.cell(t,f,M,h.get(A),O))}),w.push("</tr>")}w.push("</tbody>"),this.widest=Math.max(this.widest,m);const $=this.charts(t,d,c,u,l?g:0),j=`p${String(n)}`,S=m>690,D=S?m<=1020:!0,R=D?S?1123:794:m+104,F=D?S?794:1123:794;this.pages.push(`<section class="sheet" style="page:${j}"><style>@page ${j}{size:${String(R)}px ${String(F)}px;margin:48px}</style><h2>${y(t.name)}</h2><div class="book"><table class="${l?t.spec.gridlines===!1?"edged":"edged grid":""}" style="width:${String(m)}px"><colgroup>${b}</colgroup>${w.join("")}</table>${$}</div></section>`)}withCharts(t,n){const e={...n};for(const{spec:o,at:r}of t.charts){const{width:s,height:a}=H(o);let d=r.col;for(let h=(o.x??0)+s;h>0;d++)h-=this.width(t,d);let c=r.row;for(let h=(o.y??0)+a;h>0;c++)h-=this.rowHeight(t,c);e.bottom=Math.max(e.bottom,c-1),e.right=Math.max(e.right,d-1)}return e}rowHeight(t,n){return t.spec.rows?.[String(n+1)]?.height??DEFAULT_ROW_HEIGHT}charts(t,n,e,o,r){const[s]=n,[a]=e;if(t.charts.length===0||s===void 0||a===void 0)return"";const d=r>0?DEFAULT_ROW_HEIGHT:0,c={top:s,left:a,bottom:n[n.length-1]??s,right:e[e.length-1]??a},h=l=>{let u=d;for(const g of n){if(g>=l)break;u+=this.rowHeight(t,g)}return u},p=l=>{let u=r;return e.forEach((g,m)=>{g<l&&(u+=o[m]??0)}),u};return t.charts.filter(l=>{const{width:u,height:g}=H(l.spec),m=Math.ceil(u/DEFAULT_COLUMN_WIDTH),b=Math.ceil(g/DEFAULT_ROW_HEIGHT);return N(c,{top:l.at.row,left:l.at.col,bottom:l.at.row+b,right:l.at.col+m})}).map(l=>{const{left:u,top:g,width:m,height:b}=P(l.spec,h,p);return`<div class="chart" style="left:${String(u)}px;top:${String(g)}px">${G(_(this.calc,t,l),m,b,{font:"var(--font)"})}</div>`}).join("")}page(){const{o:t}=this,n=[...this.classes].map(([o,r])=>`.${r}{${o}}`),e=(t.sheets?.length??2)>1&&t.area===void 0;return`<!doctype html><html><head><meta charset="utf-8"><style>
+${t.css??""}
+:root{--font:${t.font===void 0?"":`"${t.font}",`}Carlito,Calibri,Arial,sans-serif}
+*{box-sizing:border-box}
+html,body{margin:0;background:#fff;color:#000}
+body{font:11pt/1.2 var(--font)}
+.sheet{break-after:page}
+.sheet:last-child{break-after:auto}
+h2{font:bold 12pt var(--font);margin:0 0 8px;${e?"":"display:none"}}
+table{table-layout:fixed;border-collapse:collapse}
+td,th{height:${String(DEFAULT_ROW_HEIGHT)}px;padding:0 3px;overflow:hidden;white-space:pre;vertical-align:bottom}
+td.over{overflow:visible}
+.book{position:relative;width:max-content;overflow:hidden}
+.chart{position:absolute;line-height:0}
+.grid td{border:1px solid #e3e3e3}
+.edged th{border:1px solid #e3e3e3;background:#f5f5f5;color:#555;font-weight:normal;text-align:center;vertical-align:middle;font-size:9pt}
+${n.join(`
+`)}
+</style></head><body>${this.pages.join("")}</body></html>`}}export function sheetHtml(i,t={}){const n=t.sheets??i.wb.sheets.filter(o=>o.spec.hidden!==!0),e=new rt(i,{...t,sheets:n});return n.forEach((o,r)=>{e.sheet(o,r)}),{html:e.page(),width:e.widest,cut:e.cut}}

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

@@ -0,0 +1,11 @@
+export interface ImportedSheet {
+    /** sheet.yaml's text. */
+    text: string;
+    /** The rows' path from the sheet's folder, and its text. */
+    path: string;
+    csv: string;
+    rows: number;
+}
+/** A sheet of a file's rows; `name` is what its table and title are called. */
+export declare function importRows(name: string, text: string, delimiter: "," | "\t"): ImportedSheet;
+//# sourceMappingURL=import.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readCsv as m,writeCsv as c}from"./csv.js";import{validName as p}from"./workbook.js";import{writeYaml as w}from"./write.js";const f=r=>{const e=r.replace(/[^\p{L}\p{N}_]+/gu,"_").replace(/^_+|_+$/gu,"");return p(e)?e:`t_${e||"rows"}`};export function importRows(r,e,n){const t=m(e,n),o=t.problems[0];if(o)throw new Error(`line ${String(o.line)}: ${o.message}`);const s=t.records.map(i=>i.fields);if(s.length===0)throw new Error("the file holds no rows");const a=f(r),l=`data/${a.toLowerCase()}.csv`;return{text:w({title:r,sheets:[{name:"Sheet1",freeze:"A2",tables:[{name:a,at:"A1",rows:l}]}]}),path:l,csv:n===","&&t.dialect.finalNewline?e:c(s),rows:s.length-1}}

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

@@ -0,0 +1,38 @@
+export * from "./address.js";
+export { DEFAULT_DIALECT, csvField, csvRecord, csvRows, fromTsv, readCsv, toTsv, writeCsv, type CsvDialect, type CsvProblem, type CsvRecord, type ParsedCsv, } from "./csv.js";
+export { patchCsv } from "./patch.js";
+export * from "./values.js";
+export * from "./workbook.js";
+export { dataFilesOf, readSheetFile, type SheetProblem } from "./file.js";
+export { GENERATED, ordinarySheet, typedNumbers, withGenerated, type GeneratedSheets, type MergedFile, } from "./generated.js";
+export { applyScenario, cellOfName, scenarioNames, scenariosByCell, type ScenarioCell, type SheetScenarios, } from "./scenario.js";
+export { fileCells, hasFiles, isPicture, pictureHeight, pictureSize, type FileCell, } from "./files.js";
+export * from "./formula/ast.js";
+export { parseFormula } from "./formula/parse.js";
+export { printFormula, sheetPrefix } from "./formula/print.js";
+export { moveFormula } from "./formula/move.js";
+export { rewriteFormula, type StructureEdit } from "./formula/rewrite.js";
+export { Calc, seededRandom, type CalcOptions, type CellChange, } from "./calc/engine.js";
+export { analyse, type Analysis } from "./calc/analyse.js";
+export { FUNCTIONS } from "./calc/functions/index.js";
+export { Reference } from "./calc/types.js";
+export { checkWorkbook, placeName, type CheckedWorkbook } from "./check.js";
+export { csvOf, jsonOf, markdownOf, tableRows } from "./export.js";
+export { dataValue, isDateCode, shownColor, shownValue } from "./format.js";
+export { DEFAULT_COLUMN_WIDTH, DEFAULT_ROW_HEIGHT, sheetHtml, type SheetHtml, type SheetHtmlOptions, } from "./html.js";
+export { PROFILE_TOP, profileTable, type ColumnProfile } from "./profile.js";
+export { importRows, type ImportedSheet } from "./import.js";
+export { patchYaml, writeYaml } from "./write.js";
+export * from "./edit.js";
+export * from "./arrange.js";
+export { NO_LOOK, autoFill, copyLooks, fillDownTo, moveCells, pasteLooks, type LookCopy, } from "./fill.js";
+export { seriesAfter, type FillMode } from "./series.js";
+export { compareForSort, hasHeader, sortCells, sortedOrder, sortedRows, type SortKey, } from "./sort.js";
+export { filterChoices, filteredRows, regionAround, type FilterChoice, } from "./filter.js";
+export { Rules, colorBetween, compareValues, holds, iconShape, type IconShape, type RuleShow, } from "./rules.js";
+export { choicesIn, invalidCells, joinChoices, listValues, separatorOf, valid, type InvalidCell, } from "./validate.js";
+export { freeColumn, restructure, tableShape, uniqueColumn, withColumnsUpTo, type BookValues, type RefusedEdit, type Restructured, type TableShape, } from "./structure.js";
+export { SHEET_CHART_DEFAULTS, chartAfter, chartDataRange, chartDef, chartOfRange, chartPlace, chartSize, chartSvg, readDataRange, type ChartSvgOptions, type NewChart, } from "./chart.js";
+export { INSPECT_DEFAULTS, SHEET_FACT_KINDS, inspectWorkbook, type InspectOptions, type SheetFactKind, type SheetFinding, } from "./inspect.js";
+export { DIFF_DEFAULTS, diffWorkbooks, type CellChange as DiffCell, type DiffKind, type DiffOptions, type DiffSide, type SheetDiff, type TableDiff, type WorkbookDiff, } from "./diff.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export*from"./address.js";export{DEFAULT_DIALECT,csvField,csvRecord,csvRows,fromTsv,readCsv,toTsv,writeCsv}from"./csv.js";export{patchCsv}from"./patch.js";export*from"./values.js";export*from"./workbook.js";export{dataFilesOf,readSheetFile}from"./file.js";export{GENERATED,ordinarySheet,typedNumbers,withGenerated}from"./generated.js";export{applyScenario,cellOfName,scenarioNames,scenariosByCell}from"./scenario.js";export{fileCells,hasFiles,isPicture,pictureHeight,pictureSize}from"./files.js";export*from"./formula/ast.js";export{parseFormula}from"./formula/parse.js";export{printFormula,sheetPrefix}from"./formula/print.js";export{moveFormula}from"./formula/move.js";export{rewriteFormula}from"./formula/rewrite.js";export{Calc,seededRandom}from"./calc/engine.js";export{analyse}from"./calc/analyse.js";export{FUNCTIONS}from"./calc/functions/index.js";export{Reference}from"./calc/types.js";export{checkWorkbook,placeName}from"./check.js";export{csvOf,jsonOf,markdownOf,tableRows}from"./export.js";export{dataValue,isDateCode,shownColor,shownValue}from"./format.js";export{DEFAULT_COLUMN_WIDTH,DEFAULT_ROW_HEIGHT,sheetHtml}from"./html.js";export{PROFILE_TOP,profileTable}from"./profile.js";export{importRows}from"./import.js";export{patchYaml,writeYaml}from"./write.js";export*from"./edit.js";export*from"./arrange.js";export{NO_LOOK,autoFill,copyLooks,fillDownTo,moveCells,pasteLooks}from"./fill.js";export{seriesAfter}from"./series.js";export{compareForSort,hasHeader,sortCells,sortedOrder,sortedRows}from"./sort.js";export{filterChoices,filteredRows,regionAround}from"./filter.js";export{Rules,colorBetween,compareValues,holds,iconShape}from"./rules.js";export{choicesIn,invalidCells,joinChoices,listValues,separatorOf,valid}from"./validate.js";export{freeColumn,restructure,tableShape,uniqueColumn,withColumnsUpTo}from"./structure.js";export{SHEET_CHART_DEFAULTS,chartAfter,chartDataRange,chartDef,chartOfRange,chartPlace,chartSize,chartSvg,readDataRange}from"./chart.js";export{INSPECT_DEFAULTS,SHEET_FACT_KINDS,inspectWorkbook}from"./inspect.js";export{DIFF_DEFAULTS,diffWorkbooks}from"./diff.js";

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

@@ -0,0 +1,25 @@
+import type { SheetFactData } from "@allyhub-next/formats";
+import type { Calc } from "./calc/engine.js";
+export type SheetFactKind = keyof SheetFactData;
+export type SheetFinding = {
+    [K in SheetFactKind]: {
+        kind: K;
+        data: SheetFactData[K];
+    };
+}[SheetFactKind];
+export declare const SHEET_FACT_KINDS: readonly ["sheet-error", "sheet-number", "sheet-unlike", "sheet-exception", "sheet-unused", "sheet-invalid", "sheet-typed", "sheet-ordinary"];
+export interface InspectOptions {
+    /** Numbers a formula may hold and not be said: what any formula has. */
+    plain?: readonly number[];
+    /** How many neighbours each side must agree for a cell to be unlike them. */
+    around?: number;
+    /** Every number in every formula, whatever `plain` says, and a table's columns nothing reads. */
+    all?: boolean;
+}
+export declare const INSPECT_DEFAULTS: {
+    readonly plain: readonly [0, 1, -1];
+    readonly around: 1;
+};
+/** The facts of a workbook, computed. */
+export declare function inspectWorkbook(calc: Calc, o?: InspectOptions): SheetFinding[];
+//# sourceMappingURL=inspect.d.ts.map