allyhub 0.7.1 → 0.8.0

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

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

package/dist/node_modules/@allyhub/sheet/dist/edit.d.ts

@@ -0,0 +1,154 @@
+import type { SheetFile, SheetTable, SheetWorksheet } from "@allyhub/formats";
+import { type Area } from "./address.js";
+import { restructure, type RefusedEdit } from "./structure.js";
+import { type CellLook, type CsvRows, type SharedFormula, type Table, type Workbook, type Worksheet } from "./workbook.js";
+/** What an edit reads: the files, and the workbook read from them. */
+export interface EditBook {
+    file: SheetFile;
+    rows: ReadonlyMap<string, CsvRows>;
+    workbook: Workbook;
+}
+/** A cell an edit changed, for a model that takes it in as it is. */
+export interface ChangedCell {
+    sheet: Worksheet;
+    row: number;
+    col: number;
+    /** What it now holds, as typed; nothing: empty. */
+    input?: string;
+    /** Its column's formula, as it is again when the exception goes. */
+    column?: SharedFormula;
+    /** sheet.yaml's key for it, now; null: it has none now. */
+    key?: string | null;
+    /** The CSV record of a table's row, now. */
+    record?: {
+        table: Table;
+        index: number;
+        fields: string[];
+    };
+}
+/** What an edit changed. */
+export interface BookEdit {
+    /** sheet.yaml, when it changed. */
+    file?: SheetFile;
+    /** The CSV files that changed. */
+    rows: Map<string, CsvRows>;
+    /** Cells changed, each one that did, when nothing else did. */
+    cells: ChangedCell[];
+    /** Tables, sheets or fills changed: the model is read again. */
+    whole: boolean;
+    /** Why nothing was done. */
+    refused?: EditRefused;
+    /** A formula went in one cell of a column of typed values: it can go over all of them. */
+    offer?: {
+        sheet: string;
+        row: number;
+        col: number;
+        text: string;
+    };
+    /** CSV files no sheet names any more. */
+    removed?: string[];
+}
+export type EditRefused = RefusedEdit | "column-name" | "sheet-name" | "sheet-taken" | "name-invalid" | "merge-table" | "no-data" | "table-move";
+/** The most typed cells written as keys of `cells`: more go in a CSV file of their own, as a script's do. */
+export declare const BLOCK_CELLS = 100;
+export declare const blankEdit: () => BookEdit;
+export declare const refused: (why: EditRefused) => BookEdit;
+export declare class Draft {
+    private readonly book;
+    private readonly specs;
+    private file;
+    private fileChanged;
+    /** Rows each table has in this edit: a paste may write several under it. */
+    private readonly grown;
+    /** The records of the rows added in this edit, by table and row. */
+    private readonly added;
+    readonly edit: BookEdit;
+    constructor(book: EditBook);
+    /** The sheet's entry, to change: its own copy from the first change on. */
+    spec(sheet: Worksheet): SheetWorksheet;
+    /** A table's entry, to change. */
+    table(sheet: Worksheet, table: Table): SheetTable;
+    /** A file's rows for this edit, to change: its own copy from the first change on. */
+    rows(path: string): (readonly string[])[];
+    setField(path: string, record: number, field: number, text: string): string[];
+    rowsOf(table: Table): number;
+    grow(table: Table, row: number, record: number): void;
+    /** The table a row added in this edit is in, and that row's record. */
+    addedAt(sheet: Worksheet, row: number, col: number): {
+        table: Table;
+        record: number;
+    } | undefined;
+    finish(): BookEdit;
+}
+export declare const movedTo: (text: string, rows: number, columns: number) => string;
+export declare function writeOne(d: Draft, book: EditBook, sheet: Worksheet, row: number, col: number, text: string): BookEdit | undefined;
+/** One cell written as typed, or several: `text` is what a person types there. */
+export interface CellWrite {
+    row: number;
+    col: number;
+    text: string;
+}
+/** Cells of a sheet written, each in the file that holds it. */
+export declare function writeCells(book: EditBook, sheetName: string, writes: readonly CellWrite[]): BookEdit;
+/** Every cell of a column's rows takes the formula: what Excel's "overwrite all cells" does. */
+export declare function overwriteColumn(book: EditBook, sheetName: string, row: number, col: number, text: string): BookEdit;
+/** What an area holds taken out; a calculated column whose every row is taken loses its formula. */
+export declare function clearCells(book: EditBook, sheetName: string, area: Area): BookEdit;
+/** Keys a fill takes the place of: the cells in it, and ranges it covers. */
+export declare function dropKeys(spec: SheetWorksheet, area: Area): void;
+/**
+ * What a cell holds filled over an area, as Cmd+D and Cmd+R do. In a file of
+ * rows each cell takes it; loose, a formula is one key over the range.
+ */
+export declare function fillCells(book: EditBook, sheetName: string, from: {
+    row: number;
+    col: number;
+}, area: Area, input: string): BookEdit;
+/** Many typed cells in empty places: a CSV file of their own, as a script's are. */
+export declare function writeBlockOf(book: EditBook, sheetName: string, at: {
+    row: number;
+    col: number;
+}, rows: readonly (readonly string[])[], path: string): BookEdit;
+/**
+ * A look given to an area: sheet.yaml's `format`, or the column, row or
+ * table's column it covers, whichever says it plainest. What said otherwise
+ * of those cells and would win gives way: a key's own field goes, and a range
+ * key's moves to `format`, which the new look then follows. A field set to
+ * undefined is taken away, and written as off only where the file says it
+ * elsewhere.
+ */
+export declare function setLook(book: EditBook, sheetName: string, area: Area, patch: CellLook): BookEdit;
+/** The same in an edit under way. */
+export declare function applyLook(d: Draft, sheet: Worksheet, area: Area, patch: CellLook): void;
+/** What an edit left empty goes. */
+export declare function tidied(spec: SheetWorksheet): void;
+/** A column's width, in pixels; undefined: as tall or wide as nothing sets. */
+export declare function setColumnWidth(book: EditBook, sheetName: string, col: number, width: number | undefined): BookEdit;
+export declare function setRowHeight(book: EditBook, sheetName: string, row: number, height: number | undefined): BookEdit;
+/** Excel's rules for a sheet's name. */
+export declare function sheetNameProblem(book: Pick<EditBook, "workbook">, name: string, own?: string): EditRefused | undefined;
+export declare function renameSheet(book: EditBook, from: string, to: string): BookEdit;
+/** A new sheet, after the one named. */
+export declare function addSheet(book: EditBook, name: string, after: string | undefined): BookEdit;
+/** Excel's name for a copy of a sheet: "Orders (2)", cut to fit the 31 a name may hold. */
+export declare function copyName(book: EditBook, name: string): string;
+/** A copy of a sheet right after it, under Excel's name for one. */
+export declare function duplicateSheet(book: EditBook, name: string): BookEdit;
+/** A sheet taken out; what named it says #REF!. */
+export declare function deleteSheet(book: EditBook, name: string): BookEdit;
+/** A sheet moved to `to` among the sheets. */
+export declare function moveSheet(book: EditBook, name: string, to: number): BookEdit;
+/** Rows or columns put in or taken out. */
+export declare function bandEdit(book: EditBook, edit: Parameters<typeof restructure>[1]): BookEdit;
+/** A name given to a place, as the name box does when it holds a new one. */
+export declare function defineName(book: EditBook, name: string, sheetName: string, area: Area): BookEdit;
+/** What a cell holds, as a person would type it again: its formula, or its value as the file writes it. */
+export declare function inputOf(book: Pick<EditBook, "rows">, sheet: Worksheet, row: number, col: number): string;
+/** The cells of a table's calculated columns set apart from their formula: facts, never problems. */
+export declare function exceptionsOf(table: Table): {
+    row: number;
+    col: number;
+    column: string;
+    text: string;
+}[];
+//# sourceMappingURL=edit.d.ts.map

package/dist/node_modules/@allyhub/sheet/dist/file.d.ts

@@ -0,0 +1,19 @@
+import { type SheetFile } from "@allyhub/formats";
+/** What is wrong with a workbook. */
+export interface SheetProblem {
+    /** sheet.yaml or a CSV file, from the sheet's folder. */
+    file: string;
+    line?: number;
+    message: string;
+}
+export declare const ENTRY = "sheet.yaml";
+export type YamlPath = readonly (string | number)[];
+export interface ReadFile {
+    file?: SheetFile;
+    problems: SheetProblem[];
+    lineOf: (path: YamlPath) => number | undefined;
+}
+/** The CSV files a sheet.yaml names, from its folder. */
+export declare function dataFilesOf(text: string): string[];
+export declare function readSheetFile(text: string): ReadFile;
+//# sourceMappingURL=file.d.ts.map

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

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

package/dist/node_modules/@allyhub/sheet/dist/files.d.ts

@@ -0,0 +1,24 @@
+import { type SheetFilesColumn } from "@allyhub/formats";
+import type { Calc } from "./calc/engine.js";
+import { type Worksheet } from "./workbook.js";
+export interface FileCell {
+    row: number;
+    col: number;
+    paths: string[];
+    column: SheetFilesColumn;
+}
+/** Whether a file is drawn in its cell. */
+export declare const isPicture: (path: string) => boolean;
+/** How tall a column draws its pictures, px. */
+export declare const pictureHeight: (column: SheetFilesColumn) => number;
+/** Whether a sheet has a `files` column, of a table or its own. */
+export declare function hasFiles(sheet: Worksheet): boolean;
+/** Every cell of a sheet that names files. */
+export declare function fileCells(sheet: Worksheet, calc: Calc): FileCell[];
+/** A picture's pixels, read from its head: PNG, JPEG and GIF. */
+export declare function pictureSize(bytes: Uint8Array): {
+    width: number;
+    height: number;
+    type: "png" | "jpeg" | "gif";
+} | undefined;
+//# sourceMappingURL=files.d.ts.map

package/dist/node_modules/@allyhub/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/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/sheet/dist/generated.d.ts

@@ -0,0 +1,46 @@
+import { type SheetFile, type SheetWorksheet } from "@allyhub/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/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/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/sheet/dist/inspect.d.ts

@@ -0,0 +1,25 @@
+import type { SheetFactData } from "@allyhub/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

package/dist/node_modules/@allyhub/sheet/dist/paginate.d.ts

@@ -0,0 +1,98 @@
+import type { SheetHeaderFooter, SheetPrint } from "@allyhub/formats";
+import { type Area } from "./address.js";
+import type { Calc } from "./calc/engine.js";
+import type { Chart, Worksheet } from "./workbook.js";
+/** A column and a row nothing sizes, px: Excel's 8.43 characters and 15 points. */
+export declare const DEFAULT_COLUMN_WIDTH = 64;
+export declare const DEFAULT_ROW_HEIGHT = 20;
+/** Paper, portrait, px. */
+export declare const PAPERS: Readonly<Record<NonNullable<SheetPrint["paper"]>, {
+    width: number;
+    height: number;
+}>>;
+/** How a sheet prints when `print` does not say: A4, Excel's Normal margins (inches), 100%. */
+export declare const PRINT_DEFAULTS: {
+    readonly paper: "a4";
+    readonly orientation: "portrait";
+    readonly margins: {
+        readonly left: 0.7;
+        readonly right: 0.7;
+        readonly top: 0.75;
+        readonly bottom: 0.75;
+        readonly header: 0.3;
+        readonly footer: 0.3;
+    };
+    readonly scale: 100;
+};
+/** A stretch of a sheet's rows or columns that show, by index: from, and to before. */
+export interface Span {
+    from: number;
+    to: number;
+}
+/** One sheet as it prints. */
+export interface SheetPages {
+    sheet: Worksheet;
+    /** The rows and columns that show in its print area, in order, and their sizes, px. */
+    rows: readonly number[];
+    heights: readonly number[];
+    cols: readonly number[];
+    widths: readonly number[];
+    /** Where each of them starts, px from the area's first; one more for where the last ends. */
+    rowAt: readonly number[];
+    colAt: readonly number[];
+    /** Its charts, px from the area's first row and column that show. */
+    charts: readonly PlacedChart[];
+    /** Rows and columns repeated on each page that comes after them. */
+    titleRows: readonly number[];
+    titleCols: readonly number[];
+    /** Pages down and across. */
+    down: readonly Span[];
+    across: readonly Span[];
+    /** Paper, oriented, and its margins, px. */
+    paper: {
+        width: number;
+        height: number;
+    };
+    margins: Readonly<Record<keyof typeof PRINT_DEFAULTS.margins, number>>;
+    /** 1 is 100%. */
+    scale: number;
+    header?: SheetHeaderFooter;
+    footer?: SheetHeaderFooter;
+}
+/** A chart where it lies, px from a print area's first row and column that show. */
+export interface PlacedChart {
+    chart: Chart;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** A page: which sheet, which of its rows and columns, its number from 1. */
+export interface PrintedPage {
+    of: SheetPages;
+    down: Span;
+    across: Span;
+    number: number;
+}
+export interface PrintJob {
+    sheets: SheetPages[];
+    pages: PrintedPage[];
+}
+export interface PaginateOptions {
+    /** The sheets printed; default every one that is not hidden. */
+    sheets?: readonly Worksheet[];
+    /** A row's height as drawn, px; default its own (pictures in a cell make a row taller). */
+    height?: (sheet: Worksheet, row: number) => number;
+}
+export declare function columnWidth(sheet: Worksheet, col: number): number;
+export declare const rowHeight: (sheet: Worksheet, row: number) => number;
+export declare const rowHidden: (calc: Calc, sheet: Worksheet, row: number) => boolean;
+export declare const columnHidden: (sheet: Worksheet, col: number) => boolean;
+/** What a sheet uses, with the cells its charts reach. */
+export declare function usedWithCharts(sheet: Worksheet): Area | undefined;
+/** A workbook's sheets on paper: every page, numbered through the workbook. */
+export declare function paginate(calc: Calc, o?: PaginateOptions): PrintJob;
+/** The rows a page repeats over its own: the title rows before its first. */
+export declare const pageTitleRows: (page: PrintedPage) => number[];
+export declare const pageTitleCols: (page: PrintedPage) => number[];
+//# sourceMappingURL=paginate.d.ts.map

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

@@ -0,0 +1,38 @@
+import type { SheetFile, SheetTable } from "@allyhub/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/sheet/dist/table-style.d.ts

@@ -0,0 +1,32 @@
+import type { SheetSide } from "@allyhub/formats";
+import type { CellLook, Table } from "./workbook.js";
+/** A line of a part: Excel's border style and colour. */
+export interface TableLine {
+    style: SheetSide["style"];
+    color: string;
+}
+/** One part of a table style: a fill, a font's weight and colour, its lines. */
+export interface TablePart {
+    bold?: boolean;
+    color?: string;
+    fill?: string;
+    /** Its outer sides, and `horizontal` and `vertical`, the lines inside it. */
+    border?: Partial<Record<"left" | "right" | "top" | "bottom" | "horizontal" | "vertical", TableLine>>;
+}
+export interface TableStyle {
+    whole?: TablePart;
+    header?: TablePart;
+    stripe?: TablePart;
+    stripe2?: TablePart;
+}
+/** A table's style unless it names one, as Excel's new table. */
+export declare const DEFAULT_TABLE_STYLE = "TableStyleMedium2";
+/** The style a table is drawn in; undefined for `none` or a name Excel has not. */
+export declare const tableStyleOf: (table: Table) => TableStyle | undefined;
+/**
+ * The look a table's style gives a cell of it, under the cell's own.
+ * `band` is which stripe the row is, counted over the rows that show
+ * (0 the first); undefined for the header.
+ */
+export declare function tableStyleLook(style: TableStyle, table: Table, row: number, col: number, band: number | undefined): CellLook;
+//# sourceMappingURL=table-style.d.ts.map

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

@@ -0,0 +1,26 @@
+import { type SheetValidation } from "@allyhub/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/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/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}