allyhub 0.4.0 → 0.5.0

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{SHEET_DATA as G,SHEET_FILE as Q}from"@allyhub-next/formats";import{cellName as $,columnLetter as A,contains as z,overlaps as D,rangeName as x,readAddress as Z,readArea as ee}from"../address.js";import{rectangles as _}from"../api/rectangles.js";import{chartAfter as te}from"../chart.js";import{analyse as oe}from"../calc/analyse.js";import{FUNCTIONS as ne}from"../calc/functions/index.js";import{checkWorkbook as se}from"../check.js";import{writeCsv as I}from"../csv.js";import{isDateCode as W}from"../format.js";import{moveFormula as re,relativeKey as B}from"../formula/move.js";import{printFormula as M,sheetPrefix as ie}from"../formula/print.js";import{mapNode as le,walk as N}from"../formula/walk.js";import{CellError as T,isoOfSerial as fe,readTyped as F,writeTyped as P}from"../values.js";import{FormulaCell as ae,placeKey as g,validName as R}from"../workbook.js";import{writeYaml as ce}from"../write.js";import{readFileFormula as ue}from"./formula.js";import{hasDate as H}from"./numfmt.js";import{placesLine as J,readXlsx as de}from"./read.js";const K=100,he=.5,q=1462;export const COMPARE_TOLERANCE=1e-9;const me=f=>f.toLowerCase().replace(/[^\p{L}\p{N}]+/gu,"-").replace(/^-+|-+$/gu,"")||"rows",b=f=>Object.keys(f).length===0,V=(f,e)=>`${String(f)} ${e}${f===1?"":"s"}`,C=f=>({row:f.row,col:f.col});function X(f,e){const o=e.toLowerCase();return le(f,n=>n.kind!=="structured"||n.table?.toLowerCase()!==o?n:Object.fromEntries(Object.entries(n).filter(([i])=>i!=="table")))}function Y(f){return f.headers===0?"has no header row":f.columns.length!==f.ref.right-f.ref.left+1||!R(f.name)?"cannot be held as a table":new Set(f.columns.map(e=>e.name.toLowerCase())).size===f.columns.length?void 0:"has two columns of one name"}function U(f,e,o){let n;const i=new Set;N(f,t=>{t.kind==="call"&&(t.name==="LET"||t.name==="LAMBDA")&&t.args.forEach(r=>{r.kind==="name"&&i.add(r.name.toLowerCase())})});const s=t=>i.has(t)||o===void 0||o.names.has(t)||o.tables.has(t);return N(f,t=>{n===void 0&&(t.kind==="call"&&!ne.has(t.name)&&(s(t.written.toLowerCase())||(n=`no function ${t.name}`)),t.kind==="name"&&!s(t.name.toLowerCase())&&(n=`no name ${t.name}`),t.kind==="structured"&&t.table!==void 0&&!s(t.table.toLowerCase())&&(n=`no table ${t.table}`),(t.kind==="ref"||t.kind==="name"||t.kind==="error")&&t.sheet!==void 0&&(t.sheet.startsWith("[")?n="it reads another workbook":e.has(t.sheet.toLowerCase())||(n=`no sheet ${t.sheet}`)))}),n}function pe(f){const e=new Set(f.book.sheets.map(o=>o.name.toLowerCase()));for(const o of f.book.sheets){const n=new Map,i=(t,r)=>{const l=n.get(r),c=$(t);l?l.push(c):n.set(r,[c])},s=[];for(const t of o.cells){if(t.unread!==void 0){i(t,/^\[|[!']\[|\[\d+\]/u.test(t.unread)?"it reads another workbook":`it could not be read: ${t.unread}`);continue}if(!t.node)continue;const r=U(t.node,e,f);r!==void 0?(delete t.node,i(t,r)):(f.carried.set(t,o),t.array&&x(t.array)!==$(t)&&s.push(t))}we(f,o,s);for(const[t,r]of n)f.lost.push(`${o.name}: ${V(r.length,"formula")} kept as ${r.length===1?"its value":"their values"}, as ${t} (${J(r)})`)}}function we(f,e,o){if(o.length===0)return;const n=new Set;for(const i of o){const{array:s}=i;if(s)for(const t of e.cells)t!==i&&!t.node&&z(s,t.row,t.col)&&n.add(t)}e.cells=e.cells.filter(i=>!n.has(i));for(const i of n)f.spilled.set(i,e)}function O(f,e){const{value:o}=e;if(!f.book.date1904||typeof o!="number")return o;const n=f.book.looks[e.style]?.format;return W(n)&&n!==void 0&&H(n)?o+q:o}function j(f,e){if(typeof f!="number"||e===void 0||!W(e)||!H(e)||f<1)return;const o=fe(f);return F(o).value===f?o:void 0}const ge=(f,e)=>j(f,e)??P(f??null);function ke(f,e){const o=j(f,e);return o!==void 0?o:f==null?null:typeof f=="number"||typeof f=="boolean"?f:P(f)}function be(f){const e={top:1/0,left:1/0,bottom:-1,right:-1};for(const{row:o,col:n}of f)e.top=Math.min(e.top,o),e.left=Math.min(e.left,n),e.bottom=Math.max(e.bottom,o),e.right=Math.max(e.right,n);return e}class ye{ctx;read;byPlace=new Map;inTables=new Set;columnLooks=new Map;rowLooks=new Map;lookDone=new Set;tables=[];areas=[];filtered=[];constructor(e,o){this.ctx=e,this.read=o;for(const n of o.cells)this.byPlace.set(g(n.row,n.col),n)}look(e){return this.ctx.book.looks[e.style]??{}}code(e){return this.look(e).format}text(e){return e.node?M(e.node):ge(O(this.ctx,e),this.code(e))}baseLooks(){const{read:e}=this,{looks:o}=this.ctx.book,n=e.cells.reduce((s,t)=>Math.max(s,t.col),-1);for(const s of e.columns){if(s.style===void 0)continue;const t=o[s.style];if(!(!t||b(t)))for(let r=s.min;r<=Math.min(s.max,n);r++)this.columnLooks.set(r,t)}for(const s of e.rows){const t=s.style===void 0?void 0:o[s.style];t&&!b(t)&&this.rowLooks.set(s.row,t)}const i=(s,t)=>Object.keys(t).every(r=>r in s);for(const s of e.cells){const t=this.look(s),r=this.columnLooks.get(s.col);r&&!i(t,r)&&this.columnLooks.delete(s.col);const l=this.rowLooks.get(s.row);l&&!i(t,l)&&this.rowLooks.delete(s.row)}}ownLook(e){const o={...this.columnLooks.get(e.col),...this.rowLooks.get(e.row)},n={};for(const[s,t]of Object.entries(this.look(e)))JSON.stringify(t)!==JSON.stringify(o[s])&&(n[s]=t);const i=n.format;if(typeof i=="string"){const s=e.node?void 0:j(O(this.ctx,e),i);s!==void 0&&F(s).format===i&&delete n.format}return n}columnFormula(e,o,n){const i=new Map,s=n-o+1;for(let r=o;r<=n;r++){const l=this.byPlace.get(g(r,e));if(!l||l.value===void 0&&!l.node||l.value===null&&!l.node)return;if(!l.node)continue;l.key??=B(l.node,l.row,l.col);const c=i.get(l.key);c?c.n+=1:i.set(l.key,{n:1,cell:l})}let t;for(const r of i.values())(!t||r.n>t.n)&&(t=r);return t&&t.n*2>s?t.cell:void 0}table(e){const{read:o,ctx:n}=this,i=h=>n.lost.push(`${o.name}: table ${e.name} ${h}`),s=e.ref.right-e.ref.left+1,t=Y(e);if(t!==void 0)return i(`${t}, so its cells are kept and it is no table`),!1;const r=e.ref.top,l=r+1,c=e.ref.bottom-e.totals;e.totals>0&&i("has a totals row, kept as plain cells under it");const a=e.columns.map((h,m)=>c>=l?this.columnFormula(e.ref.left+m,l,c):void 0),u=h=>{const m=a[h];if(!m)return!1;for(let k=l;k<=c;k++)if(this.byPlace.get(g(k,e.ref.left+h))?.key!==m.key)return!1;return!0};let d=s;for(;d>1&&u(d-1);)d-=1;const w=[e.columns.slice(0,d).map(h=>h.name)],p={};for(let h=l;h<=c;h++){const m=[];for(let k=0;k<d;k++){const y=this.byPlace.get(g(h,e.ref.left+k)),v=a[k];y?v&&y.key===v.key?m.push(""):y.node?m.push(M(X(y.node,e.name))):m.push(this.text(y)):m.push("")}w.push(m)}for(let h=e.ref.top;h<=c;h++)for(let m=e.ref.left;m<=e.ref.right;m++)this.inTables.add(g(h,m));e.columns.forEach((h,m)=>{const k=e.ref.left+m,y=this.columnLook(k,l,c),v=a[m];v?.node&&(y.formula=M(X(re(v.node,l-v.row,0),e.name))),b(y)||(p[h.name]=y)});const L=this.path(e.name);n.files.set(L,I(w));const E=new Map;for(const[h,m]of e.filter?.columns??[]){const k=e.columns[h]?.name;k!==void 0&&E.set(k,m)}return(e.filter?.unread??0)>0&&i(`has ${V(e.filter?.unread??0,"filter")} by condition, its rows left as they were hidden`),this.tables.push({name:e.name,at:$({row:r,col:e.ref.left}),rows:L,...e.style!==void 0&&e.style!=="TableStyleMedium2"?{style:e.style}:{},...b(p)?{}:{columns:p},...e.filter===void 0?{filter:!1}:E.size>0?{filter:{columns:Object.fromEntries(E)}}:{}}),e.filter?.unread===0&&e.filter.columns.size>0&&this.filtered.push({...e.ref,bottom:c}),this.areas.push({...e.ref,bottom:c}),!0}columnLook(e,o,n){let i,s={};for(let t=o;t<=n;t++){const r=this.byPlace.get(g(t,e)),l=r?this.ownLook(r):{},c=JSON.stringify(l);if(i===void 0)i=c,s=l;else if(i!==c)return{}}if(b(s))return{};for(let t=o;t<=n;t++)this.lookDone.add(g(t,e));return{...s}}path(e){const o=`${G}/${me(e)}`;let n=`${o}.csv`;for(let i=2;this.ctx.files.has(n);i++)n=`${o}-${String(i)}.csv`;return n}loose(){const e=[],o=[];for(const n of this.read.cells)this.inTables.has(g(n.row,n.col))||(n.node?e.push(n):n.value!==void 0&&n.value!==null&&o.push(n));return{formulas:e,typed:o}}blockAreas(e,o){const n=new Map;e.forEach((a,u)=>n.set(g(a.row,a.col),u));const i=e.map((a,u)=>u),s=a=>{let u=a;for(;i[u]!==u;){const d=i[i[u]??u]??u;i[u]=d,u=d}return u};e.forEach((a,u)=>{for(const d of[n.get(g(a.row,a.col-1)),n.get(g(a.row-1,a.col))])d!==void 0&&(i[s(u)]=s(d))});const t=new Map;e.forEach((a,u)=>{const d=s(u),w=t.get(d);w?w.push(a):t.set(d,[a])});const r=[],l=a=>!r.some(u=>D(u,a))&&!this.areas.some(u=>D(u,a))&&!o.some(u=>z(a,u.row,u.col)),c=a=>(a.bottom-a.top+1)*(a.right-a.left+1);for(const a of t.values()){const u=be(a);if(!(c(u)<K)){if(a.length/c(u)>=he&&l(u)){r.push(u);continue}for(const d of _(a.map(C)))c(d)>=K&&l(d)&&r.push(d)}}return r.sort((a,u)=>a.top-u.top||a.left-u.left)}cells(e){const{formulas:o,typed:n}=this.loose(),i=this.blockAreas(n,o),s=l=>i.some(c=>z(c,l.row,l.col));i.length>0&&(e.blocks=i.map(l=>{const c=[];for(let u=l.top;u<=l.bottom;u++){const d=[];for(let w=l.left;w<=l.right;w++){const p=this.byPlace.get(g(u,w));d.push(p?this.text(p):"")}c.push(d)}const a=this.path(this.read.name);return this.ctx.files.set(a,I(c)),{at:$({row:l.top,col:l.left}),rows:a}}));const t=[],r=new Map;for(const l of o){if(!l.node)continue;l.key??=B(l.node,l.row,l.col);const c=r.get(l.key);c?c.push(l):r.set(l.key,[l])}for(const l of r.values())for(const c of _(l.map(C))){const a=this.byPlace.get(g(c.top,c.left));a?.node&&t.push([{row:c.top,col:c.left},x(c),M(a.node)])}for(const l of n)i.length>0&&s(l)||t.push([C(l),$(l),ke(O(this.ctx,l),this.code(l))]);t.sort(([l],[c])=>l.row-c.row||l.col-c.col),t.length>0&&(e.cells=Object.fromEntries(t.map(([,l,c])=>[l,c])))}formats(e){const o=new Map;for(const i of this.read.cells){if(this.lookDone.has(g(i.row,i.col)))continue;const s=this.ownLook(i);if(b(s))continue;const t=JSON.stringify(s),r=o.get(t);r?r.places.push(C(i)):o.set(t,{look:s,places:[C(i)]})}const n=[];for(const{look:i,places:s}of o.values())for(const t of _(s))n.push({range:x(t),...i});n.length>0&&(e.format=n)}columns(e){const{read:o}=this,n=new Map,i=o.cells.reduce((t,r)=>Math.max(t,r.col),0),s=[];for(const t of o.columns)if(!(t.width===void 0&&t.hidden!==!0)){t.max>i&&s.push(A(Math.max(t.min,i+1)));for(let r=t.min;r<=Math.min(t.max,i);r++)n.set(r,{...t.width===void 0?{}:{width:t.width},...t.hidden===!0?{hidden:!0}:{}})}for(const[t,r]of this.columnLooks)n.set(t,{...n.get(t),...r});n.size>0&&(e.columns=Object.fromEntries([...n.keys()].sort((t,r)=>t-r).map(t=>[A(t),n.get(t)??{}]))),s.some(Boolean)&&o.columns.some(t=>t.max>i&&t.hidden===!0)&&this.ctx.lost.push(`${o.name}: the size of the columns past its last used one`)}rows(e){const o={};for(const n of this.read.rows){const i=this.rowLooks.get(n.row),s=this.filtered.some(r=>n.row>r.top&&n.row<=r.bottom),t={...n.height===void 0?{}:{height:n.height},...n.hidden===!0&&!s?{hidden:!0}:{},...i};b(t)||(o[String(n.row+1)]=t)}b(o)||(e.rows=o)}build(){const{read:e}=this;this.baseLooks();for(const n of e.tables)this.table(n);const o={name:e.name};return e.state!=="visible"&&(o.hidden=!0),e.gridlines===!1&&(o.gridlines=!1),e.tab!==void 0&&(o.tab=e.tab),e.state==="veryHidden"&&this.ctx.lost.push(`${e.name}: being very hidden; it is hidden`),e.freeze&&(e.freeze.row>0||e.freeze.col>0)&&(o.freeze=$(e.freeze)),this.tables.length>0&&(o.tables=this.tables),this.filter(o),this.columns(o),this.rows(o),this.cells(o),e.merges.length>0&&(o.merges=e.merges.map(x)),this.formats(o),e.conditional.length>0&&(o.conditional=e.conditional),e.validations.length>0&&(o.validations=e.validations),e.charts.length>0&&(o.charts=e.charts.map(n=>this.chart(n))),o}chart(e){return te(e,o=>{const n=this.chartReference(o.replace(/^=/u,""));return o.startsWith("=")?`=${n}`:n})}chartReference(e){const o=e.lastIndexOf("!"),i=(o<0?this.read.name:e.slice(0,o)).replace(/^'|'$/gu,"").replaceAll("''","'"),s=ee(e.slice(o+1).replaceAll("$",""));if(!s)return e;const t=this.ctx.book.sheets.find(r=>r.name.toLowerCase()===i.toLowerCase());for(const r of t?.tables??[]){const l=r.ref.top+1,a=s.left===s.right&&s.top===l&&s.bottom===r.ref.bottom&&s.left>=r.ref.left&&s.left<=r.ref.right?r.columns[s.left-r.ref.left]:void 0;if(a&&this.ctx.tables.has(r.name.toLowerCase()))return`${r.name}[${a.name}]`}return`${t===this.read||o<0?"":`${e.slice(0,o)}!`}${x(s)}`}filter(e){const{filter:o}=this.read;if(!o)return;const n={};for(const[i,s]of o.columns)n[A(o.ref.left+i)]=s;e.filter={range:x(o.ref),...b(n)?{}:{columns:n}},o.unread===0&&!b(n)&&this.filtered.push(o.ref)}}function $e(f){const e={},{book:o,lost:n}=f,i=new Set(o.sheets.map(r=>r.name.toLowerCase())),s=new Set,t=new Set;for(const r of o.names){if(r.name.startsWith("_xlnm.")){r.name==="_xlnm.Print_Area"?t.add("print areas"):r.name==="_xlnm.Print_Titles"?t.add("print titles"):r.name!=="_xlnm._FilterDatabase"&&n.push(`Excel's name ${r.name}`);continue}if(/^_xl(?:fn|pm|ws|udf)/iu.test(r.name))continue;const l=r.name.toLowerCase();if(!R(r.name)||f.tables.has(l)){n.push(`the name ${r.name}, which cannot be held here`);continue}if(s.has(l)){n.push(`a second name ${r.name}, for one sheet: names here are the workbook's`);continue}const c=xe(r.text);if(c!==void 0)e[r.name]=typeof c=="string"?P(c):c,s.add(l),f.names.add(l);else{const a=ue(r.text,!0),u=a.ok?U(a.node,i):"it could not be read";if(!a.ok||u!==void 0||ve(a.node)){n.push(`the name ${r.name} (${r.text})${u===void 0?"":`: ${u}`}`);continue}e[r.name]=M(a.node),s.add(l),f.names.add(l)}r.sheet!==void 0&&n.push(`the name ${r.name} belonging to one sheet: here it is the workbook's`)}return t.size>0&&n.push([...t].join(" and ")),e}function Le(f,e){const o={},n=new Map;for(const[i,s]of Object.entries(e))typeof s=="string"&&s.startsWith("=")&&n.set(s.slice(1).replaceAll("$","").toLowerCase(),i);for(const i of f.book.sheets)for(const s of i.scenarios){const t={};let r=!0;for(const{at:l,value:c}of s.cells){const a=Z(l),u=a&&i.cells.find(p=>p.row===a.row&&p.col===a.col);String(u?.value??"")!==c&&(r=!1);const d=n.get(`${ie(i.name)}${l}`.toLowerCase())??n.get(l.toLowerCase()),w=F(c);d===void 0?f.lost.push(`${i.name}: scenario ${s.name}'s cell ${l}, which has no name`):t[d]=typeof w.value=="number"?w.value:c}!r&&!b(t)&&(o[s.name]={...o[s.name],...t})}return o}function ve(f){let e=!1;return N(f,o=>{e||=o.kind==="error"&&o.code==="#REF!"}),e}function xe(f){const e=f.trim();return/^[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?$/u.test(e)?Number(e):/^true$/iu.test(e)?!0:/^false$/iu.test(e)?!1:/^"((?:[^"]|"")*)"$/u.exec(e)?.[1]?.replaceAll('""','"')}const S=f=>f instanceof T?f.code:f??null;export function sameValue(f,e,o){if(typeof f=="number"&&typeof e=="number")return f===e?!0:Math.abs(f-e)<=Math.max(Math.abs(f),Math.abs(e))*o;if(f instanceof T||e instanceof T)return f?.code===e?.code;if(f===null||e===null){const n=f??e;return n===null||n===""||n===0||n===!1}return f===e}function Me(f,e){const o=[];for(const s of e.sheets)for(const t of s.formulas)t.shared.node&&oe(e,t.shared).volatile&&o.push(t);const n=new Set(o),i=[...o];for(;;){const s=i.pop();if(!s)return n;for(const t of f.readers(s.sheet,s.row,s.col))n.has(t)||(n.add(t),i.push(t))}}function Ce(f,e,o,n){const i={formulas:0,same:0,uncached:0,moving:0,differences:[]},s=Me(o,e);for(const[t,r]of f.carried){if(!t.node)continue;const l=e.sheet(r.name);if(!l)continue;i.formulas+=1;const c=l.at(t.row,t.col);if(c instanceof ae&&s.has(c)){i.moving+=1;continue}const a=O(f,t);if(a===void 0){i.uncached+=1;continue}const u=o.value(l,t.row,t.col);sameValue(a,u,n)?i.same+=1:i.differences.push({sheet:r.name,cell:$(t),formula:M(t.node),file:S(a),engine:S(u)})}for(const[t,r]of f.spilled){const l=e.sheet(r.name);if(!l)continue;i.formulas+=1;const c=l.spillAt(t.row,t.col);if(c&&s.has(c)){i.moving+=1;continue}const a=O(f,t),u=o.value(l,t.row,t.col);a===void 0?i.uncached+=1:sameValue(a,u,n)?i.same+=1:i.differences.push({sheet:r.name,cell:$(t),formula:c?`${$(c)}#`:"",file:S(a),engine:S(u)})}return i}function Oe(f,e){const o=new Map,n=[];for(const i of f){const s=e.find(l=>i.startsWith(`${l}: `));if(s===void 0){n.push(i);continue}const t=i.slice(s.length+2),r=o.get(t);r?r.push(s):o.set(t,[s])}for(const[i,s]of o)n.push(s.length===1?`${s[0]??""}: ${i}`:`${i}, on ${String(s.length)} sheets (${J(s)})`);return n}export function importXlsx(f,e){const o=de(f);if(o.sheets.length===0)throw new Error("It holds no sheets.");const n={book:o,files:new Map,lost:[...o.lost],tables:new Set(o.sheets.flatMap(p=>p.tables.filter(L=>Y(L)===void 0).map(L=>L.name.toLowerCase()))),names:new Set,carried:new Map,spilled:new Map};o.date1904&&n.lost.push(`the 1904 date system: dates are moved to the 1900 one, ${String(q)} days on`),(o.font.name!==void 0&&o.font.name!=="Calibri"||o.font.size!==void 0&&o.font.size!==11)&&n.lost.push(`its default font, ${o.font.name??""} ${String(o.font.size??"")}`);const i=$e(n);pe(n);const s=o.sheets.map(p=>new ye(n,p).build()),t=Le(n,i),r={title:e.name,...b(i)?{}:{names:i},sheets:s,...b(t)?{}:{scenarios:t}},l=ce(r),c=new Map([[Q,l],...n.files]),a=se({text:l,read:p=>c.get(p)}),{workbook:u,calc:d,problems:w}=a;return{files:c,lost:Oe(n.lost,o.sheets.map(p=>p.name)),problems:w,compared:u&&d?Ce(n,u,d,e.tolerance??COMPARE_TOLERANCE):{formulas:0,same:0,uncached:0,moving:0,differences:[]},sheets:o.sheets.length,tables:n.tables.size}}

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

@@ -0,0 +1,5 @@
+export { writeXlsx, type WriteOptions, type WrittenXlsx } from "./write.js";
+export { readXlsx, type ReadBook, type ReadCell, type ReadColumn, type ReadName, type ReadRow, type ReadSheet, type ReadTable, } from "./read.js";
+export { COMPARE_TOLERANCE, importXlsx, sameValue, type Compared, type Difference, type ImportOptions, type ImportedXlsx, } from "./import.js";
+export { fileFormula, needsArray, readFileFormula } from "./formula.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{writeXlsx}from"./write.js";export{readXlsx}from"./read.js";export{COMPARE_TOLERANCE,importXlsx,sameValue}from"./import.js";export{fileFormula,needsArray,readFileFormula}from"./formula.js";

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

@@ -0,0 +1,8 @@
+export declare const BUILTIN_FORMATS: Readonly<Record<number, string>>;
+/** The number a built-in format code goes by. */
+export declare const builtinId: (code: string) => number | undefined;
+/** The first number free for a file's own codes. */
+export declare const FIRST_CUSTOM = 164;
+/** Whether a date format names a day, a month or a year, not a time alone. */
+export declare function hasDate(code: string): boolean;
+//# sourceMappingURL=numfmt.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/xlsx/numfmt.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const BUILTIN_FORMATS={0:"General",1:"0",2:"0.00",3:"#,##0",4:"#,##0.00",9:"0%",10:"0.00%",11:"0.00E+00",12:"# ?/?",13:"# ??/??",14:"m/d/yyyy",15:"d-mmm-yy",16:"d-mmm",17:"mmm-yy",18:"h:mm AM/PM",19:"h:mm:ss AM/PM",20:"h:mm",21:"h:mm:ss",22:"m/d/yyyy h:mm",37:"#,##0_);(#,##0)",38:"#,##0_);[Red](#,##0)",39:"#,##0.00_);(#,##0.00)",40:"#,##0.00_);[Red](#,##0.00)",41:'_(* #,##0_);_(* \\(#,##0\\);_(* "-"_);_(@_)',42:'_("$"* #,##0_);_("$"* \\(#,##0\\);_("$"* "-"_);_(@_)',43:'_(* #,##0.00_);_(* \\(#,##0.00\\);_(* "-"??_);_(@_)',44:'_("$"* #,##0.00_);_("$"* \\(#,##0.00\\);_("$"* "-"??_);_(@_)',45:"mm:ss",46:"[h]:mm:ss",47:"mmss.0",48:"##0.0E+0",49:"@"};const e=new Map(Object.entries(BUILTIN_FORMATS).map(([_,m])=>[m,Number(_)]));export const builtinId=_=>e.get(_),FIRST_CUSTOM=164;export function hasDate(_){const m=_.replace(/"[^"]*"/gu,"").replace(/\\./gu,"").replace(/\[[^\]]*\]/gu,"");return/[yd]/iu.test(m)||/mmm/iu.test(m)}

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

@@ -0,0 +1,117 @@
+import type { SheetConditional, SheetFilterColumn, SheetValidation } from "@allyhub-next/formats";
+import { type Area, type Place } from "../address.js";
+import type { Node } from "../formula/ast.js";
+import { type Scalar } from "../values.js";
+import type { CellLook } from "../workbook.js";
+import { type ReadChart } from "./charts.js";
+export interface ReadCell {
+    row: number;
+    col: number;
+    /** What it holds, or what its formula last gave; undefined when a file did not say. */
+    value: Scalar | undefined;
+    /** Its formula, in a person's spelling. */
+    node?: Node;
+    /** The same for every cell of one fill. */
+    key?: string;
+    /** A formula as the file has it, which this language cannot read. */
+    unread?: string;
+    /** Its array formula's cells, when it is one. */
+    array?: Area;
+    /** It spills as a dynamic array, not a formula entered over a range. */
+    dynamic?: boolean;
+    /** Into `looks`. */
+    style: number;
+    rich?: boolean;
+}
+export interface ReadColumn {
+    /** Ends included, from 0. */
+    min: number;
+    max: number;
+    /** In pixels, when the file sets it. */
+    width?: number;
+    hidden?: boolean;
+    style?: number;
+}
+export interface ReadRow {
+    row: number;
+    /** In pixels, when the file sets it. */
+    height?: number;
+    hidden?: boolean;
+    style?: number;
+}
+/** A filter's columns by their place in it, and those that say what this cannot read. */
+export interface ReadFilter {
+    columns: Map<number, SheetFilterColumn>;
+    unread: number;
+}
+export interface ReadTable {
+    name: string;
+    /** Its header, rows and totals. */
+    ref: Area;
+    headers: number;
+    totals: number;
+    columns: {
+        name: string;
+        calculated: boolean;
+    }[];
+    style?: string;
+    /** Its filter buttons; nothing when it has none. */
+    filter?: ReadFilter;
+}
+export interface ReadSheet {
+    name: string;
+    state: "visible" | "hidden" | "veryHidden";
+    cells: ReadCell[];
+    merges: Area[];
+    freeze?: Place;
+    gridlines?: false;
+    tab?: string;
+    columns: ReadColumn[];
+    rows: ReadRow[];
+    tables: ReadTable[];
+    /** Conditional formats, the strongest first. */
+    conditional: SheetConditional[];
+    validations: SheetValidation[];
+    /** Its AutoFilter. */
+    filter?: ReadFilter & {
+        ref: Area;
+    };
+    /** Its charts as sheet.yaml writes them, their references as the file spells them. */
+    charts: ReadChart[];
+    /** Excel's scenarios: each sets cells of this sheet. */
+    scenarios: {
+        name: string;
+        cells: {
+            at: string;
+            value: string;
+        }[];
+    }[];
+}
+export interface ReadName {
+    name: string;
+    /** As the file has it. */
+    text: string;
+    /** The sheet it belongs to, by its place; absent: the workbook. */
+    sheet?: number;
+}
+export interface ReadBook {
+    sheets: ReadSheet[];
+    names: ReadName[];
+    /** Each cell format's look; a look says only what differs from the file's default font. */
+    looks: CellLook[];
+    /** What each differential format gives a cell. */
+    dxfs: CellLook[];
+    date1904: boolean;
+    /** The file's default font. */
+    font: {
+        name?: string;
+        size?: number;
+    };
+    /** What this model holds nothing of, a line each. */
+    lost: string[];
+}
+/** Places as a line: the first few and how many more. */
+export declare function placesLine(places: readonly string[]): string;
+/** What a .xlsx, .xlsm or .xltx file holds. */
+export declare function readXlsx(bytes: Uint8Array): ReadBook;
+//# sourceMappingURL=read.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/xlsx/read.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{strFromU8 as ie,unzipSync as ae}from"fflate";import{SHEET_ICONS as le,SHEET_OPERATORS as ce,SHEET_VALIDATIONS as de}from"@allyhub-next/formats";import{cellName as J,readAddress as K,readArea as z,readAreas as Q}from"../address.js";import{SHEET_CHART_DEFAULTS as Y}from"../chart.js";import{moveFormula as ue,relativeKey as fe}from"../formula/move.js";import{printFormula as Z}from"../formula/print.js";import{ERR as me,errorOf as he,serialOfDate as pe}from"../values.js";import{OFFICE_THEME as be,colorOf as C,paletteOf as ee,themeColors as ge}from"./colors.js";import{chartAnchors as xe,readChart as ye}from"./charts.js";import{readFileFormula as P}from"./formula.js";import{BUILTIN_FORMATS as we}from"./numfmt.js";import{attr as d,flag as k,numberAttr as x,readXml as ve,readXstring as L,tag as l,tags as b,textOf as F}from"./xml.js";const te=7,ke=o=>Math.floor((256*o+Math.floor(128/te))/256*te),$e=o=>Math.round(o*4/3),B=5;export function placesLine(o){const e=o.slice(0,B).join(", ");return o.length>B?`${e} and ${String(o.length-B)} more`:e}const H=(o,e,t=`${e}s`)=>`${String(o)} ${o===1?e:t}`;class Se{parts;names;constructor(e){this.parts=ae(e),this.names=Object.keys(this.parts)}has(e){return this.parts[e]!==void 0}text(e){const t=this.parts[e];return t?ie(t):void 0}xml(e){const t=this.text(e);return t===void 0?void 0:ve(t)}rels(e){const t=e.lastIndexOf("/"),n=`${e.slice(0,t+1)}_rels/${e.slice(t+1)}.rels`,s=this.xml(n);return b(l(s?.Relationships)?.Relationship).map(r=>{const a=d(r,"Type")??"",c=d(r,"Target")??"",i=d(r,"TargetMode")==="External";return{id:d(r,"Id")??"",type:a.slice(a.lastIndexOf("/")+1),target:i?c:Te(e,c),external:i}})}count(e){return this.names.filter(t=>e.test(t)).length}}function Te(o,e){if(e.startsWith("/"))return e.slice(1);const t=o.split("/").slice(0,-1);for(const n of e.split("/"))n===".."?t.pop():n!=="."&&t.push(n);return t.join("/")}function Ee(o,e){const t=e===void 0?void 0:o.xml(e);return b(l(t?.sst)?.si).map(n=>{const s=b(n.r);return s.length>0?{text:L(s.map(r=>F(r.t)).join("")),rich:!0}:{text:L(F(n.t)),rich:!1}})}function M(o,e){const t=o[e];if(t===void 0)return!1;const n=d(l(t),"val");return n===void 0||n!=="0"&&n!=="false"}const Oe=new Set(["double","singleAccounting","doubleAccounting"]);function Ie(o,e,t){const n={},s=(i,m)=>d(l(i?.[m]),"val");if(M(o,"b")&&(n.bold=!0),M(o,"i")&&(n.italic=!0),M(o,"strike")&&(n.strike=!0),M(o,"u")){const i=s(o,"u");n.underline=i!==void 0&&Oe.has(i)?i:!0}const r=s(o,"name");r!==void 0&&r!==s(e,"name")&&(n.font=r);const a=s(o,"sz");a!==void 0&&a!==s(e,"sz")&&(n.size=Number(a));const c=C(l(o.color),t);return c!==void 0&&c!==C(l(e?.color),t)&&(n.color=c),n}function Ae(o,e){const t=l(o.patternFill),n=d(t,"patternType");if(n===void 0||n==="none")return;const s=C(l(t?.fgColor),e),r=C(l(t?.bgColor),e);return n==="solid"&&s!==void 0?s:{pattern:n,...s===void 0?{}:{color:s},...r===void 0?{}:{background:r}}}function ne(o,e){const t={};for(const n of["left","right","top","bottom"]){const s=l(o[n]),r=d(s,"style");if(r===void 0||r==="none")continue;const a=C(l(s?.color),e);t[n]={style:r,...a===void 0?{}:{color:a}}}return Object.keys(t).length===0?void 0:t}function Ce(o){const e={},t=d(o,"horizontal");t!==void 0&&t!=="general"&&(e.align=t);const n=d(o,"vertical");n!==void 0&&n!=="bottom"&&(e.valign=n),k(o,"wrapText")===!0&&(e.wrap=!0),k(o,"shrinkToFit")===!0&&(e.shrink=!0);const s=x(o,"indent");s!==void 0&&s>0&&(e.indent=s);const r=x(o,"textRotation");return r!==void 0&&r>0&&r<=180&&(e.rotation=r),e}function Fe(o,e){const t={},n=l(o.font);if(n){const i=(f,u)=>{n[f]!==void 0&&(t[u]=M(n,f))};i("b","bold"),i("i","italic"),i("strike","strike"),n.u!==void 0&&(t.underline=M(n,"u"));const m=C(l(n.color),e);m!==void 0&&(t.color=m)}const s=l(l(o.fill)?.patternFill),r=C(l(s?.bgColor),e)??C(l(s?.fgColor),e);r!==void 0&&(t.fill=r);const a=l(o.border),c=a&&ne(a,e);return c!==void 0&&(t.border=c),t}function Re(o,e){const t=l(o?.styleSheet),n=ee(e,t),s=new Map(b(l(t?.numFmts)?.numFmt).map(p=>[x(p,"numFmtId")??-1,d(p,"formatCode")??"General"])),r=b(l(t?.fonts)?.font),a=b(l(t?.fills)?.fill),c=b(l(t?.borders)?.border),i=b(l(t?.cellXfs)?.xf),m=r[x(i[0],"fontId")??0],f=new Set;a.some(p=>p.gradientFill!==void 0)&&f.add("gradient fills");const u=i.map(p=>{const y={},$=r[x(p,"fontId")??0];$&&(Object.assign(y,Ie($,m,n)),$.vertAlign!==void 0&&f.add("superscript and subscript"));const T=a[x(p,"fillId")??0],O=T&&Ae(T,n);O!==void 0&&(y.fill=O);const R=c[x(p,"borderId")??0],I=R&&ne(R,n);I!==void 0&&(y.border=I),R&&d(l(R.diagonal),"style")!==void 0&&f.add("diagonal borders");const w=l(p.alignment);w&&(Object.assign(y,Ce(w)),x(w,"textRotation")===255&&f.add("vertical text"));const S=x(p,"numFmtId")??0,A=s.get(S)??we[S];return A!==void 0&&A!=="General"&&(y.format=A),y}),h=d(l(m?.name),"val"),v=d(l(m?.sz),"val");return{looks:u,dxfs:b(l(t?.dxfs)?.dxf).map(p=>Fe(p,n)),font:{...h===void 0?{}:{name:h},...v===void 0?{}:{size:Number(v)}},lost:[...f]}}function oe(o){const e=new Map;let t=0;for(const n of b(o.filterColumn)){const s=x(n,"colId")??0,r=l(n.filters);if(!r){Object.keys(n).some(c=>c!=="colId"&&c!=="hiddenButton")&&(t+=1);continue}if(r.dateGroupItem!==void 0){t+=1;continue}const a=b(r.filter).map(c=>L(d(c,"val")??""));e.set(s,{...a.length===0?{}:{values:a},...k(r,"blank")===!0?{blanks:!0}:{}})}return{columns:e,unread:t}}function Le(o){const e=l(o?.table),t=z(d(e,"ref")??""),n=d(e,"displayName")??d(e,"name");if(!t||n===void 0)return;const s=l(e?.tableStyleInfo),r=l(e?.autoFilter);return{name:n,ref:t,headers:x(e,"headerRowCount")??1,totals:x(e,"totalsRowCount")??0,columns:b(l(e?.tableColumns)?.tableColumn).map(a=>({name:L(d(a,"name")??"").trim(),calculated:a.calculatedColumnFormula!==void 0})),style:d(s,"name")??"none",...r?{filter:oe(r)}:{}}}function W(o){const e=o.trim();if(e==="")return;const t=/^"((?:[^"]|"")*)"$/u.exec(e);if(t)return(t[1]??"").replaceAll('""','"');const n=Number(e);if(!Number.isNaN(n))return n;const s=P(e,!0);return s.ok?Z(s.node):void 0}const re=o=>o!==void 0&&ce.includes(o);function q(o){const e=d(o,"type")??"num",t=d(o,"val"),n=t===void 0?void 0:W(t);return{at:e,...n===void 0?{}:{value:n}}}const Ne=le;function je(o,e,t,n){const s=d(o,"type")??"",r={range:e,...k(o,"stopIfTrue")===!0?{stop:!0}:{}},a=x(o,"dxfId"),c=a===void 0?{}:t[a]??{},i={...c.bold===void 0?{}:{bold:c.bold},...c.italic===void 0?{}:{italic:c.italic},...c.underline===void 0?{}:{underline:c.underline!==!1},...c.strike===void 0?{}:{strike:c.strike},...c.color===void 0?{}:{color:c.color},...typeof c.fill=="string"?{fill:c.fill}:{},...c.border===void 0?{}:{border:c.border}},m=o.formula,f=(Array.isArray(m)?m:m===void 0?[]:[m]).map(F);switch(s){case"cellIs":{const u=d(o,"operator"),h=f.flatMap(v=>{const p=W(v);return p===void 0?[]:[p]});return!re(u)||h.length===0?`a cellIs rule of ${u??"no operator"}`:{...r,...i,type:"cellIs",operator:u,formula:h}}case"containsText":case"notContainsText":case"beginsWith":case"endsWith":{const u=d(o,"text");return u===void 0?`a ${s} rule with no text`:{...r,...i,type:"containsText",...s==="containsText"?{}:{operator:s==="notContainsText"?"notContains":s},text:L(u)}}case"duplicateValues":case"uniqueValues":return{...r,...i,type:s};case"top10":return{...r,...i,type:"top10",rank:x(o,"rank")??10,...k(o,"percent")===!0?{percent:!0}:{},...k(o,"bottom")===!0?{bottom:!0}:{}};case"aboveAverage":return{...r,...i,type:"aboveAverage",...k(o,"aboveAverage")===!1?{below:!0}:{},...k(o,"equalAverage")===!0?{equal:!0}:{}};case"expression":{const u=f[0]===void 0?void 0:P(f[0],!0);return u?.ok?{...r,...i,type:"expression",formula:Z(u.node)}:"an expression rule that cannot be read"}case"dataBar":{const u=l(o.dataBar),h=C(l(u?.color),n),[v,p]=b(u?.cfvo).map(q);return h===void 0?"a data bar with no colour":{...r,type:"dataBar",color:h,...v&&v.at!=="min"?{min:v}:{},...p&&p.at!=="max"?{max:p}:{},...k(u,"showValue")===!1?{show:!1}:{}}}case"colorScale":{const u=l(o.colorScale),h=b(u?.cfvo).map(q),v=b(u?.color).map(y=>C(y,n)),p=h.flatMap((y,$)=>{const T=v[$];return T===void 0?[]:[{...y,color:T}]});return p.length<2?"a colour scale with too few stops":{...r,type:"colorScale",stops:p.slice(0,3)}}case"iconSet":{const u=l(o.iconSet),h=d(u,"iconSet")??"3TrafficLights1";if(!Ne.includes(h))return`the icon set ${h}`;const v=b(u?.cfvo).map(q);return{...r,type:"iconSet",icons:h,...v.length>=3?{stops:v.slice(0,5)}:{},...k(u,"reverse")===!0?{reverse:!0}:{},...k(u,"showValue")===!1?{show:!1}:{}}}default:return`a ${s} rule`}}function Me(o,e,t){const n=[],s=[];for(const r of b(o.conditionalFormatting)){const a=d(r,"sqref")??"";if(!Q(a)){s.push(`a rule on ${a}`);continue}for(const c of b(r.cfRule)){const i=je(c,a,e,t);typeof i=="string"?s.push(`${i} on ${a}`):n.push({priority:x(c,"priority")??0,rule:i})}}return{rules:n.sort((r,a)=>r.priority-a.priority).map(r=>r.rule),unread:s}}const De=de;function Ve(o){const e=[],t=[];for(const n of b(l(o.dataValidations)?.dataValidation)){const s=d(n,"sqref")??"",r=d(n,"type")??"none";if(r==="none"&&d(n,"prompt")===void 0)continue;if(!De.includes(r)||!Q(s)){t.push(`a ${r} rule on ${s}`);continue}const a=F(n.formula1),c=F(n.formula2),i=/^"((?:[^"]|"")*)"$/u.exec(a.trim()),m=r==="list"&&i?(i[1]??"").replaceAll('""','"').split(","):void 0,f=[a,c].flatMap(T=>{const O=W(T);return O===void 0?[]:[O]}),u=d(n,"operator"),h=T=>Object.fromEntries(Object.entries(T).filter(([,O])=>O!==void 0)),v=h({title:d(n,"promptTitle"),message:d(n,"prompt")}),p=h({style:d(n,"errorStyle"),title:d(n,"errorTitle"),message:d(n,"error")}),y=k(n,"showInputMessage")!==!0,$=k(n,"showErrorMessage")!==!0;e.push({range:s,type:r,...re(u)&&u!=="between"?{operator:u}:{},...m?{values:m}:{formula:f},...k(n,"allowBlank")===!0?{}:{blank:!1},...k(n,"showDropDown")===!0?{dropdown:!1}:{},...y||Object.keys(v).length>0?{prompt:{...v,...y?{show:!1}:{}}}:{},...$||Object.keys(p).length>0?{error:{...p,...$?{show:!1}:{}}}:{}})}return{rules:e,unread:t}}function U(o,e){const t=P(o,e);return t.ok?{node:t.node}:{unread:o}}class ze{cells=[];rich=[];masters=new Map;strings;constructor(e){this.strings=e}value(e,t){const n=d(e,"t")??"n",s=e.v;if(n==="inlineStr"){const a=l(e.is),c=b(a?.r);return c.length>0?{value:L(c.map(i=>F(i.t)).join("")),rich:!0}:{value:L(F(a?.t))}}if(s===void 0)return{value:void 0};const r=F(s);switch(n){case"s":{const a=this.strings[Number(r)];return a?{value:a.text,...a.rich?{rich:!0}:{}}:{value:""}}case"str":return{value:L(r)};case"b":return{value:r.trim()==="1"||r.trim()==="true"};case"e":return{value:he(r.trim())??me.VALUE};case"d":{const a=new Date(r.trim());return{value:Number.isNaN(a.getTime())?r:pe(a)}}default:{if(r.trim()==="")return{value:void 0};const a=Number(r);if(Number.isNaN(a))throw new Error(`${t} says it holds a number and holds ${r}.`);return{value:a}}}}formula(e,t,n,s){const r=e.f;if(r===void 0)return;const a=l(r),c=d(a,"t")??"normal",i=F(r);if(c==="dataTable"){s.unread=`a data table's {=TABLE(${d(a,"r1")??""})}`;return}if(c==="array"){const m=e.cm!==void 0;Object.assign(s,U(i,!0));const f=z(d(a,"ref")??"");f&&(s.array=f),m&&(s.dynamic=!0);return}if(c==="shared"){const m=d(a,"si")??"";if(i!==""){const u=U(i,!1);this.masters.set(m,{node:u.node,unread:u.unread,row:t,col:n,key:u.node?fe(u.node,t,n):"",dynamicArray:!1}),Object.assign(s,u),u.node&&(s.key=this.masters.get(m)?.key??"");return}const f=this.masters.get(m);if(!f){s.unread=`a shared formula of a group that has no first cell (${m})`;return}f.node?(s.node=ue(f.node,t-f.row,n-f.col),s.key=f.key):f.unread!==void 0&&(s.unread=f.unread);return}i!==""&&Object.assign(s,U(i,!1))}readRows(e){let t=0;for(const n of e){const s=x(n,"r"),r=s===void 0?t:s-1;t=r+1;let a=0;for(const c of b(n.c)){const i=d(c,"r"),f=(i===void 0?void 0:K(i))?.col??a;a=f+1;const u=i??J({row:r,col:f}),{value:h,rich:v}=this.value(c,u),p={row:r,col:f,value:h,style:x(c,"s")??0};v===!0&&(p.rich=!0,this.rich.push(u)),this.formula(c,r,f,p),this.cells.push(p)}}}}function He(o,e,t){const n=[],s=i=>n.push(`${o}: ${i}`);t.length>0&&s(`${H(t.length,"cell")} of rich text, kept as plain text (${placesLine(t)})`);const r=b(l(e.hyperlinks)?.hyperlink);r.length>0&&s(`${H(r.length,"hyperlink")} (${placesLine(r.map(i=>d(i,"ref")??""))})`),e.sortState!==void 0&&s("a sort"),k(l(e.sheetProtection),"sheet")===!0&&s("protection"),e.protectedRanges!==void 0&&s("protected ranges"),e.headerFooter!==void 0&&F(e.headerFooter).trim()!==""&&s("its print header and footer"),l(e.headerFooter)?.oddHeader!==void 0&&s("its print header"),l(e.headerFooter)?.oddFooter!==void 0&&s("its print footer"),(e.rowBreaks!==void 0||e.colBreaks!==void 0)&&s("its page breaks"),e.oleObjects!==void 0&&s("embedded objects"),e.controls!==void 0&&s("form controls"),e.dataConsolidate!==void 0&&s("a consolidation"),e.customSheetViews!==void 0&&s("custom views"),b(l(e.sheetViews)?.sheetView).some(i=>d(l(i.pane),"state")==="split")&&s("a split, not frozen, window");const c=JSON.stringify(e.extLst??"");return c.includes("sparklineGroups")&&s("sparklines"),X(e.extLst)&&s("conditional formats of Excel 2010 and later"),c.includes("dataValidations")&&s("data validations of Excel 2010 and later"),c.includes("slicerList")&&s("slicers"),n}function X(o){if(typeof o!="object"||o===null)return!1;if(Array.isArray(o))return o.some(X);const e=o;return b(e.cfRule).some(t=>d(t,"type")!=="dataBar")&&e.cfRule!==void 0?!0:Object.values(e).some(X)}function _e(o){const e=[],t=(n,s,r)=>{const a=o.count(n);a>0&&e.push(H(a,s,r))};return o.has("xl/vbaProject.bin")&&e.push("VBA macros"),t(/^xl\/pivotTables\/pivotTable\d*\.xml$/u,"pivot table"),t(/^xl\/chartsheets\/[^/]+\.xml$/u,"chart sheet"),t(/^xl\/dialogsheets\/[^/]+\.xml$/u,"dialog sheet"),t(/^xl\/macrosheets\/[^/]+\.xml$/u,"macro sheet"),t(/^xl\/media\//u,"image"),t(/^xl\/embeddings\//u,"embedded object"),t(/^xl\/comments\d*\.xml$/u,"sheet's comments","sheets' comments"),t(/^xl\/threadedComments\//u,"sheet's threaded comments","sheets' threaded comments"),t(/^xl\/slicers\/[^/]+\.xml$/u,"slicer part"),t(/^xl\/timelines\/[^/]+\.xml$/u,"timeline part"),t(/^xl\/ctrlProps\/[^/]+\.xml$/u,"form control"),t(/^xl\/activeX\/[^/]+\.xml$/u,"ActiveX control"),t(/^xl\/queryTables\/[^/]+\.xml$/u,"query table"),o.has("xl/connections.xml")&&e.push("data connections"),o.names.some(n=>n.startsWith("xl/richData/"))&&e.push("rich values (data types, pictures in cells)"),o.names.some(n=>/^customXml\/item\d+\.xml$/u.test(n)&&(o.text(n)??"").includes("DataMashup"))&&e.push("Power Query queries"),e}function Pe(o,e,t,n,s,r,a){const c=o.xml(e),i=l(c?.worksheet);if(!i)throw new Error(`${e} is not a worksheet.`);const m=new ze(s);m.readRows(b(l(i.sheetData)?.row));const f=b(l(i.cols)?.col).map(g=>{const E=x(g,"width"),D=x(g,"style");return{min:(x(g,"min")??1)-1,max:(x(g,"max")??1)-1,...E===void 0||k(g,"customWidth")===!1?{}:{width:ke(E)},...k(g,"hidden")===!0?{hidden:!0}:{},...D===void 0||D===0?{}:{style:D}}}),u=[];let h=b(l(i.cols)?.col).some(g=>(x(g,"outlineLevel")??0)>0);b(l(i.sheetData)?.row).forEach((g,E)=>{const D=(x(g,"r")??E+1)-1;(x(g,"outlineLevel")??0)>0&&(h=!0);const G=x(g,"ht"),_=x(g,"s"),V={row:D};G!==void 0&&k(g,"customHeight")===!0&&(V.height=$e(G)),k(g,"hidden")===!0&&(V.hidden=!0),_!==void 0&&_!==0&&k(g,"customFormat")===!0&&(V.style=_),Object.keys(V).length>1&&u.push(V)});const v=b(l(i.mergeCells)?.mergeCell).flatMap(g=>{const E=z(d(g,"ref")??"");return E?[E]:[]}),p=b(l(i.sheetViews)?.sheetView)[0],y=l(p?.pane);let $;const T=d(y,"state");if(T==="frozen"||T==="frozenSplit"){const g=K(d(p,"topLeftCell")??"A1")??{row:0,col:0};$={row:g.row+(x(y,"ySplit")??0),col:g.col+(x(y,"xSplit")??0)}}const O=o.rels(e).filter(g=>g.type==="table").flatMap(g=>{const E=Le(o.xml(g.target));return E?[E]:[]}),R=C(l(l(i.sheetPr)?.tabColor),r),I=He(t,i,m.rich);h&&I.push(`${t}: its grouped rows or columns, left ungrouped`);const w=Me(i,a,r),S=Ve(i);for(const g of w.unread)I.push(`${t}: a conditional format, ${g}`);for(const g of S.unread)I.push(`${t}: a data validation, ${g}`);const A=l(i.autoFilter),j=z(d(A,"ref")??""),N=A&&j?{ref:j,...oe(A)}:void 0;N&&N.unread>0&&I.push(`${t}: ${H(N.unread,"filter")} by condition on ${d(A,"ref")??""}, its rows left as they were hidden`);const se=qe(o,e,t,f,u,I);return{sheet:{name:t,state:n,cells:m.cells,merges:v,...$?{freeze:$}:{},...d(p,"showGridLines")==="0"?{gridlines:!1}:{},...R===void 0?{}:{tab:R},columns:f,rows:u,tables:O,conditional:w.rules,validations:S.rules,scenarios:b(l(i.scenarios)?.scenario).map(g=>({name:d(g,"name")??"",cells:b(g.inputCells).map(E=>({at:d(E,"r")??"",value:d(E,"val")??""}))})),...N?{filter:N}:{},charts:se},lost:I}}const Be=64,We=20;function qe(o,e,t,n,s,r){const a=m=>n.find(f=>m>=f.min&&m<=f.max)?.width??Be,c=m=>s.find(f=>f.row===m)?.height??We,i=[];for(const m of o.rels(e).filter(f=>f.type==="drawing")){const{anchors:f}=xe(o.xml(m.target),a,c),u=o.rels(m.target);for(const h of f){const v=u.find($=>$.id===h.id),p=ye(v?o.xml(v.target):void 0),y=J(h.at);if(typeof p=="string"){r.push(`${t}: the chart at ${y}, as ${p}`);continue}i.push({...p,at:y,...h.x===void 0?{}:{x:h.x},...h.y===void 0?{}:{y:h.y},...h.width===Y.width?{}:{width:h.width},...h.height===Y.height?{}:{height:h.height}})}}return i}export function readXlsx(o){let e;try{e=new Se(o)}catch{throw new Error("It is not a zip file, as an .xlsx file is.")}const n=e.rels("").find(w=>w.type==="officeDocument")?.target??"xl/workbook.xml";if(n.endsWith(".bin"))throw new Error("It is a binary workbook (.xlsb): save it as .xlsx.");const s=e.xml(n),r=l(s?.workbook);if(!r)throw new Error("It has no workbook part.");const a=e.rels(n),c=w=>a.find(S=>S.type===w)?.target,i=(()=>{const w=c("theme");return w===void 0?void 0:e.text(w)})(),m=i===void 0?be:ge(i),f=c("styles"),u=f===void 0?void 0:e.xml(f),h=Re(u,m),v=ee(m,l(u?.styleSheet)),p=Ee(e,c("sharedStrings")),y=[..._e(e)];for(const w of h.lost)y.push(w);const $=l(r.workbookPr),T=l(r.calcPr);k(T,"iterate")===!0&&y.push("iterative calculation");const O=l(r.workbookProtection);(k(O,"lockStructure")===!0||k(O,"lockWindows")===!0)&&y.push("the workbook's protection"),r.fileSharing!==void 0&&y.push("its write protection");const R=[],I=new Map(a.map(w=>[w.id,w]));for(const w of b(l(r.sheets)?.sheet)){const S=I.get(d(w,"id")??""),A=L(d(w,"name")??"");if(S?.type!=="worksheet"){S?.type!=="chartsheet"&&S?.type!=="dialogsheet"&&y.push(`${A}: a sheet of a kind this cannot read`);continue}const j=d(w,"state"),N=Pe(e,S.target,A,j==="hidden"||j==="veryHidden"?j:"visible",p,v,h.dxfs);R.push(N.sheet),y.push(...N.lost)}return{sheets:R,names:b(l(r.definedNames)?.definedName).map(w=>{const S=x(w,"localSheetId");return{name:d(w,"name")??"",text:L(F(w)),...S===void 0?{}:{sheet:S}}}),looks:h.looks,dxfs:h.dxfs,date1904:k($,"date1904")===!0,font:h.font,lost:y}}

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

@@ -0,0 +1,23 @@
+import type { CellLook } from "../workbook.js";
+/** The body font of a workbook, whatever its cells say. */
+export declare const DEFAULT_FONT: {
+    readonly name: "Calibri";
+    readonly size: 11;
+};
+export declare class Styles {
+    private readonly fonts;
+    private readonly fills;
+    private readonly borders;
+    private readonly formats;
+    private readonly xfs;
+    private readonly byLook;
+    private readonly dxfs;
+    constructor();
+    private format;
+    /** The cell format of a look. */
+    xf(look: CellLook): number;
+    /** The differential format of what a rule gives a cell. */
+    dxf(look: CellLook): number;
+    xml(): string;
+}
+//# sourceMappingURL=styles.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/xlsx/styles.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{FIRST_CUSTOM as p,builtinId as g}from"./numfmt.js";import{NS as y,el as e}from"./xml.js";export const DEFAULT_FONT={name:"Calibri",size:11};const s=t=>`FF${t.slice(1).toUpperCase()}`;class l{items=[];index=new Map;add(n){const r=this.index.get(n);if(r!==void 0)return r;const i=this.items.length;return this.items.push(n),this.index.set(n,i),i}}function b(t){const{underline:n}=t;return e("font",{},t.bold===!0?"<b/>":"",t.italic===!0?"<i/>":"",t.strike===!0?"<strike/>":"",n===!0||n==="single"?"<u/>":n?e("u",{val:n}):"",e("sz",{val:t.size??DEFAULT_FONT.size}),t.color===void 0?e("color",{theme:1}):e("color",{rgb:s(t.color)}),e("name",{val:t.font??DEFAULT_FONT.name}),e("family",{val:2}),t.font===void 0?e("scheme",{val:"minor"}):"")}function x(t){const{pattern:n,color:r,background:i}=typeof t=="string"?{pattern:"solid",color:t,background:void 0}:t;return e("fill",{},e("patternFill",{patternType:n},r===void 0?"":e("fgColor",{rgb:s(r)}),i===void 0?n==="solid"?e("bgColor",{indexed:64}):"":e("bgColor",{rgb:s(i)})))}function f(t,n){return n?e(t,{style:n.style},n.color===void 0?e("color",{auto:1}):e("color",{rgb:s(n.color)})):e(t)}function h(t){return e("border",{},f("left",t.left),f("right",t.right),f("top",t.top),f("bottom",t.bottom),e("diagonal"))}function F(t){const{underline:n}=t,r=[t.bold===void 0?"":e("b",{val:t.bold}),t.italic===void 0?"":e("i",{val:t.italic}),t.strike===void 0?"":e("strike",{val:t.strike}),n===!0?"<u/>":"",t.color===void 0?"":e("color",{rgb:s(t.color)})].join(""),{fill:i,border:d}=t;return e("dxf",{},r===""?"":e("font",{},r),typeof i=="string"?e("fill",{},e("patternFill",{},e("bgColor",{rgb:s(i)}))):"",d?h(d):"")}const I=t=>t<0?90-t:t;function v(t){const n={horizontal:t.align,vertical:t.valign,textRotation:t.rotation===void 0?void 0:I(t.rotation),wrapText:t.wrap===!0?!0:void 0,indent:t.indent,shrinkToFit:t.shrink===!0?!0:void 0};return Object.values(n).every(r=>r===void 0)?"":e("alignment",n)}export class Styles{fonts=new l;fills=new l;borders=new l;formats=new Map;xfs=new l;byLook=new Map;dxfs=new l;constructor(){this.fonts.add(b({})),this.fills.add(e("fill",{},e("patternFill",{patternType:"none"}))),this.fills.add(e("fill",{},e("patternFill",{patternType:"gray125"}))),this.borders.add(e("border",{},e("left"),e("right"),e("top"),e("bottom"),e("diagonal"))),this.xfs.add(e("xf",{numFmtId:0,fontId:0,fillId:0,borderId:0,xfId:0}))}format(n){if(n===void 0)return 0;const r=g(n);if(r!==void 0)return r;let i=this.formats.get(n);return i===void 0&&(i=p+this.formats.size,this.formats.set(n,i)),i}xf(n){const r=JSON.stringify(n),i=this.byLook.get(r);if(i!==void 0)return i;const d=this.format(n.format),o=this.fonts.add(b(n)),a=n.fill===void 0?0:this.fills.add(x(n.fill)),u=n.border===void 0?0:this.borders.add(h(n.border)),c=v(n),m=this.xfs.add(e("xf",{numFmtId:d,fontId:o,fillId:a,borderId:u,xfId:0,applyNumberFormat:d===0?void 0:!0,applyFont:o===0?void 0:!0,applyFill:a===0?void 0:!0,applyBorder:u===0?void 0:!0,applyAlignment:c===""?void 0:!0},c));return this.byLook.set(r,m),m}dxf(n){return this.dxfs.add(F(n))}xml(){const n=(i,d)=>e(i,{count:d.length},...d),r=[...this.formats].map(([i,d])=>e("numFmt",{numFmtId:d,formatCode:i}));return e("styleSheet",{xmlns:y.main},r.length>0?n("numFmts",r):"",n("fonts",this.fonts.items),n("fills",this.fills.items),n("borders",this.borders.items),n("cellStyleXfs",[e("xf",{numFmtId:0,fontId:0,fillId:0,borderId:0})]),n("cellXfs",this.xfs.items),n("cellStyles",[e("cellStyle",{name:"Normal",xfId:0,builtinId:0})]),this.dxfs.items.length===0?e("dxfs",{count:0}):n("dxfs",this.dxfs.items),e("tableStyles",{count:0,defaultTableStyle:"TableStyleMedium2",defaultPivotStyle:"PivotStyleLight16"}))}}

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

@@ -0,0 +1,3 @@
+/** xl/theme/theme1.xml. */
+export declare const THEME_XML: string;
+//# sourceMappingURL=theme.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/xlsx/theme.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{NS as i,el as a}from"./xml.js";const e=(c,n)=>`<a:${c}>${n}</a:${c}>`,t=c=>a("a:srgbClr",{val:c}),r=[e("dk1",a("a:sysClr",{val:"windowText",lastClr:"000000"})),e("lt1",a("a:sysClr",{val:"window",lastClr:"FFFFFF"})),e("dk2",t("44546A")),e("lt2",t("E7E6E6")),e("accent1",t("4472C4")),e("accent2",t("ED7D31")),e("accent3",t("A5A5A5")),e("accent4",t("FFC000")),e("accent5",t("5B9BD5")),e("accent6",t("70AD47")),e("hlink",t("0563C1")),e("folHlink",t("954F72"))].join(""),o=(c,n)=>`<a:${c}>${a("a:latin",{typeface:n})}${a("a:ea",{typeface:""})}${a("a:cs",{typeface:""})}</a:${c}>`,l=a("a:solidFill",{},a("a:schemeClr",{val:"phClr"})),s=a("a:ln",{w:6350,cap:"flat",cmpd:"sng",algn:"ctr"},l,a("a:prstDash",{val:"solid"})),f=a("a:effectStyle",{},a("a:effectLst"));export const THEME_XML=a("a:theme",{"xmlns:a":i.drawing,name:"Office Theme"},a("a:themeElements",{},`<a:clrScheme name="Office">${r}</a:clrScheme>`,`<a:fontScheme name="Office">${o("majorFont","Calibri Light")}${o("minorFont","Calibri")}</a:fontScheme>`,a("a:fmtScheme",{name:"Office"},a("a:fillStyleLst",{},l,l,l),a("a:lnStyleLst",{},s,s,s),a("a:effectStyleLst",{},f,f,f),a("a:bgFillStyleLst",{},l,l,l))));

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

@@ -0,0 +1,17 @@
+import type { Calc } from "../calc/engine.js";
+/** A table's style when sheet.yaml names none. */
+export declare const DEFAULT_TABLE_STYLE = "TableStyleMedium2";
+export interface WriteOptions {
+    /** false leaves out what formulas compute: the file has to be computed by what opens it. */
+    cached?: boolean;
+    /** A file a `files` column names, from the sheet's folder: a picture goes in its cell. */
+    file?: (path: string) => Uint8Array | undefined;
+}
+export interface WrittenXlsx {
+    bytes: Uint8Array;
+    /** What of the workbook a file does not hold. */
+    left: string[];
+}
+/** A computed workbook as the bytes of an .xlsx file. */
+export declare function writeXlsx(calc: Calc, o?: WriteOptions): WrittenXlsx;
+//# sourceMappingURL=write.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/xlsx/write.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{zipSync as se}from"fflate";import{cellName as R,columnIndex as ne,columnLetter as Y,rangeName as E}from"../address.js";import{parseFormula as oe}from"../formula/parse.js";import{sheetPrefix as re}from"../formula/print.js";import{fileCells as ie,isPicture as ae,pictureHeight as le,pictureSize as ce}from"../files.js";import{scenariosByCell as de}from"../scenario.js";import{CellError as P,readTyped as he}from"../values.js";import{FormulaCell as me}from"../workbook.js";import{chartPart as fe,drawingPart as ue}from"./charts.js";import{fileFormula as O,needsArray as V}from"./formula.js";import{Styles as pe}from"./styles.js";import{THEME_XML as ge}from"./theme.js";import{HEAD as g,NS as y,el as o,xstring as x}from"./xml.js";const $={sheet:"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml",worksheet:"application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml",styles:"application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml",strings:"application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml",theme:"application/vnd.openxmlformats-officedocument.theme+xml",table:"application/vnd.openxmlformats-officedocument.spreadsheetml.table+xml",metadata:"application/vnd.openxmlformats-officedocument.spreadsheetml.sheetMetadata+xml",drawing:"application/vnd.openxmlformats-officedocument.drawing+xml",chart:"application/vnd.openxmlformats-officedocument.drawingml.chart+xml",core:"application/vnd.openxmlformats-package.core-properties+xml",app:"application/vnd.openxmlformats-officedocument.extended-properties+xml"},w=`${y.rel}/`,G=new Date(1980,0,1),xe=191029;export const DEFAULT_TABLE_STYLE="TableStyleMedium2";const $e=64,we=7,be=l=>Math.min(255,Math.floor(l/we*256)/256),ye=l=>Math.min(409.5,l*3/4),z=32767,B=255,Se=2e5,ke=o("metadata",{xmlns:y.main,"xmlns:xda":"http://schemas.microsoft.com/office/spreadsheetml/2017/dynamicarray"},o("metadataTypes",{count:1},o("metadataType",{name:"XLDAPR",minSupportedVersion:12e4,copy:1,pasteAll:1,pasteValues:1,merge:1,splitFirst:1,rowColShift:1,clearFormats:1,clearComments:1,assign:1,coerce:1,cellMeta:1})),o("futureMetadata",{name:"XLDAPR",count:1},o("bk",{},o("extLst",{},o("ext",{uri:"{bdbb8cdc-fa1e-496e-a857-3c3f30c029c3}"},o("xda:dynamicArrayProperties",{fDynamic:1,fCollapsed:0}))))),o("cellMetadata",{count:1},o("bk",{},o("rc",{t:1,v:0}))));class ve{index=new Map;count=0;of(t){this.count+=1;let e=this.index.get(t);return e===void 0&&(e=this.index.size,this.index.set(t,e)),e}xml(){const t=[...this.index.keys()].map(e=>`<si><t${/^\s|\s$|\n/u.test(e)?' xml:space="preserve"':""}>${x(e)}</t></si>`);return o("sst",{xmlns:y.main,count:this.count,uniqueCount:this.index.size},...t)}}const H=l=>x(l),Te="Base case";function Ce(l){const t=new Map;for(const n of l.scenarios)for(const r of n.cells)t.set(R(r),r);const e=(n,r)=>o("inputCells",{r:R(n),val:r===null||r instanceof P?"":typeof r=="boolean"?r?"1":"0":String(r)}),s=(n,r)=>o("scenario",{name:n,locked:!0,count:r.length,user:"AllyHub"},...r);return o("scenarios",{current:0,show:0,sqref:[...t.keys()].join(" ")},s(Te,[...t.values()].map(n=>e(n,n.base))),...l.scenarios.map(n=>s(n.name,n.cells.map(r=>e(r,r.value)))))}function Ae(l,t,e,s){const n=[];let r=0;for(const{row:d,col:h,paths:a,column:i}of ie(l,t)){let c=0;const u=le(i);for(const S of a){const b=ae(S)?e?.(S):void 0,k=b&&ce(b);if(!b||!k){r+=1;continue}const M=Math.round(k.width/k.height*u);n.push({row:d,col:h,x:c,width:M,height:u,name:S.split("/").pop()??S,file:`.${k.type==="jpeg"?"jpg":k.type}`,bytes:b}),c+=M+4}}return r>0&&s.push(`${l.name}: ${String(r)} file${r===1?"":"s"} in a cell, which stay${r===1?"s":""} a name`),n}class Ee{arrays=!1;places=new Map;sheet;calc;styles;strings;wb;cached;left;isTable;isRangeName;hiddenRows;tall;scenarios;drawn;constructor(t,e,s,n,r,d,h=[],a){this.sheet=t,this.calc=e,this.wb=e.wb,this.styles=s,this.strings=n,this.cached=r,this.left=d,this.isTable=c=>this.wb.table(c)!==void 0,this.isRangeName=c=>{const u=this.wb.name(c)?.formula?.node;return this.isTable(c)||u!==void 0&&V({kind:"unary",op:"-",arg:u})},this.hiddenRows=e.filtered(t),this.scenarios=a,this.drawn=t.charts.length>0||h.length>0;const i=new Map;for(const c of h)i.set(c.row,Math.max(i.get(c.row)??0,c.height));this.tall=i}add(t,e){let s=this.places.get(t);s||(s=new Set,this.places.set(t,s)),s.add(e)}gather(){const{sheet:t}=this;for(let e=0;e<t.columnsUsed;e++){const[s,n]=t.span(e,0,Number.MAX_SAFE_INTEGER);for(let r=s;r<=n;r++)(t.at(r,e)!==void 0||t.spillAt(r,e))&&this.add(r,e)}for(const{area:e}of t.styledAreas()){const s=(e.bottom-e.top+1)*(e.right-e.left+1);if(s>Se){this.left.push(`${t.name}!${E(e)}: its look on the cells that hold something, ${String(s)} cells being too many to write empty`);continue}for(let n=e.top;n<=e.bottom;n++)for(let r=e.left;r<=e.right;r++)this.add(n,r)}for(const e of t.keys.keys())this.add(Math.floor(e/16384),e%16384)}styleOf(t,e){const s=this.sheet.lookAt(t,e);return Object.keys(s).length===0?void 0:this.styles.xf(s)}held(t,e){return e.length<=z?e:(this.left.push(`${this.sheet.name}!${t} past Excel's ${String(z)} characters, of its ${String(e.length)}`),e.slice(0,z))}value(t,e,s){return s===null?o("c",{r:t,s:e}):typeof s=="number"?`<c r="${t}"${p(e)}><v>${String(s)}</v></c>`:typeof s=="boolean"?`<c r="${t}"${p(e)} t="b"><v>${s?"1":"0"}</v></c>`:s instanceof P?Z(s)?`<c r="${t}"${p(e)} t="e"><v>${s.code}</v></c>`:`<c r="${t}"${p(e)} t="s"><v>${String(this.strings.of(s.code))}</v></c>`:`<c r="${t}"${p(e)} t="s"><v>${String(this.strings.of(this.held(t,s)))}</v></c>`}table(t){return this.sheet.tableAt(t.row,t.col)?.name}formula(t,e,s){const n=this.calc.value(s.sheet,s.row,s.col),{node:r}=s.shared;if(!r)return`<c r="${t}"${p(e)} t="e"><v>#NAME?</v></c>`;const d=s.moved,h=s.array!==void 0||s.blocked!==void 0||V(d,this.isRangeName),a=O(d,{table:this.table(s),isTable:this.isTable,array:h});let i=`<f>${H(a)}</f>`,c="";if(h){this.arrays=!0;const u=s.spill??{top:s.row,left:s.col,bottom:s.row,right:s.col};i=`<f t="array" ref="${E(u)}">${H(a)}</f>`,c=' cm="1"'}return this.cached?n===null||typeof n=="number"?`<c r="${t}"${p(e)}${c}>${i}<v>${String(n??0)}</v></c>`:typeof n=="boolean"?`<c r="${t}"${p(e)} t="b"${c}>${i}<v>${n?"1":"0"}</v></c>`:n instanceof P?Z(n)?`<c r="${t}"${p(e)} t="e"${c}>${i}<v>${n.code}</v></c>`:`<c r="${t}"${p(e)}${c}>${i}<v>0</v></c>`:`<c r="${t}"${p(e)} t="str"${c}>${i}<v>${x(this.held(t,n))}</v></c>`:`<c r="${t}"${p(e)}${c}>${i}</c>`}cell(t,e){const s=R({row:t,col:e}),n=this.styleOf(t,e),r=this.sheet.at(t,e);return r instanceof me?this.formula(s,n,r):r===void 0&&this.sheet.spillAt(t,e)&&this.cached?this.value(s,n,this.calc.value(this.sheet,t,e)):this.value(s,n,r??null)}columns(){const{sheet:t}=this,{spec:e}=t,s=new Map,n=new Map;for(const a of t.tables)for(const i of a.columns)i.spec?.width!==void 0&&n.set(a.at.col+i.index,i.spec.width);const r=new Set(n.keys()),d=new Map;for(const[a,i]of Object.entries(e.columns??{})){const c=ne(a);c!==void 0&&(d.set(c,i),r.add(c))}for(const a of r){const i=d.get(a),c=i?.width??n.get(a),u=J(i);s.set(a,o("col",{min:a+1,max:a+1,width:be(c??$e),style:u===void 0?void 0:this.styles.xf(u),hidden:i?.hidden===!0?!0:void 0,customWidth:c===void 0?void 0:!0}))}const h=[...s.keys()].sort((a,i)=>a-i).map(a=>s.get(a)??"");return h.length===0?"":o("cols",{},...h)}rowAttrs(t){const e=this.sheet.spec.rows?.[String(t+1)],s=J(e),n=e?.height??this.tall.get(t);return{r:t+1,s:s===void 0?void 0:this.styles.xf(s),customFormat:s===void 0?void 0:!0,ht:n===void 0?void 0:ye(n),customHeight:n===void 0?void 0:!0,hidden:e?.hidden===!0||this.hiddenRows.has(t)?!0:void 0}}rows(){const{sheet:t}=this,e=new Set(this.places.keys());for(const n of Object.keys(t.spec.rows??{}))e.add(Number(n)-1);for(const n of this.hiddenRows)e.add(n);const s=[];for(const n of[...e].sort((r,d)=>r-d)){const r=[...this.places.get(n)??[]].sort((a,i)=>a-i),d=o("row",this.rowAttrs(n)).slice(4,-2);if(r.length===0){s.push(`<row${d}/>`);continue}let h=`<row${d}>`;for(const a of r)h+=this.cell(n,a);s.push(`${h}</row>`)}return s.join("")}view(t){const{freeze:e}=this.sheet;let s="";if(e&&(e.row>0||e.col>0)){const n=e.row>0&&e.col>0?"bottomRight":e.row>0?"bottomLeft":"topRight";s=o("pane",{xSplit:e.col>0?e.col:void 0,ySplit:e.row>0?e.row:void 0,topLeftCell:R(e),activePane:n,state:"frozen"})}return o("sheetViews",{},o("sheetView",{showGridLines:this.sheet.spec.gridlines===!1?!1:void 0,tabSelected:t?!0:void 0,workbookViewId:0},s))}write(t,e){const{sheet:s}=this;this.gather();const n=_e(this.places),r=this.rows(),d=s.merges.map(i=>o("mergeCell",{ref:E(i)})),h=s.tables.map((i,c)=>o("tablePart",{"r:id":`rId${String(c+1)}`}));return{xml:g+o("worksheet",{xmlns:y.main,"xmlns:r":y.rel},s.spec.tab===void 0?"":o("sheetPr",{},o("tabColor",{rgb:`FF${s.spec.tab.slice(1).toUpperCase()}`})),o("dimension",{ref:n?E(n):"A1"}),this.view(t),o("sheetFormatPr",{defaultRowHeight:15}),this.columns(),r===""?o("sheetData"):`<sheetData>${r}</sheetData>`,this.scenarios?Ce(this.scenarios):"",this.sheetFilter(),d.length>0?o("mergeCells",{count:d.length},...d):"",...s.conditions.map((i,c)=>this.condition(i,c+1)),this.validations(),o("pageMargins",{left:.7,right:.7,top:.75,bottom:.75,header:.3,footer:.3}),this.drawn?o("drawing",{"r:id":`rId${String(h.length+1)}`}):"",h.length>0?o("tableParts",{count:h.length},...h):""),tables:s.tables.map((i,c)=>this.tableXml(i,e+c))}}bound(t){if(t===void 0)return"";if(typeof t=="number")return String(t);if(!t.startsWith("=")){const s=he(t);return typeof s.value=="number"&&s.formula===void 0?String(s.value):`"${t.replaceAll('"','""')}"`}const e=oe(t);return e.ok?O(e.node,{isTable:this.isTable,array:!0}):t.slice(1)}cfvo(t){return o("cfvo",{type:t.at,val:t.value===void 0?void 0:typeof t.value=="number"?t.value:this.bound(t.value)})}condition(t,e){const{spec:s}=t,n=s.range,r=(i,...c)=>o("conditionalFormatting",{sqref:n},o("cfRule",{...i,priority:e,stopIfTrue:s.stop===!0?!0:void 0},...c)),d=()=>{const i=Me(s);return Object.keys(i).length===0?void 0:this.styles.dxf(i)},h=t.areas[0],a=h?R({row:h.top,col:h.left}):"A1";switch(s.type){case"cellIs":return r({type:"cellIs",dxfId:d(),operator:s.operator},...s.formula.map(i=>o("formula",{},x(this.bound(i)))));case"containsText":{const i=s.operator??"contains",c=`"${s.text.replaceAll('"','""')}"`,u=i==="contains"?`NOT(ISERROR(SEARCH(${c},${a})))`:i==="notContains"?`ISERROR(SEARCH(${c},${a}))`:i==="beginsWith"?`LEFT(${a},LEN(${c}))=${c}`:`RIGHT(${a},LEN(${c}))=${c}`;return r({type:i==="contains"?"containsText":i==="notContains"?"notContainsText":i,dxfId:d(),operator:i==="contains"?"containsText":i,text:s.text},o("formula",{},x(u)))}case"duplicateValues":case"uniqueValues":return r({type:s.type,dxfId:d()});case"top10":return r({type:"top10",dxfId:d(),percent:s.percent===!0?!0:void 0,bottom:s.bottom===!0?!0:void 0,rank:s.rank});case"aboveAverage":return r({type:"aboveAverage",dxfId:d(),aboveAverage:s.below===!0?!1:void 0,equalAverage:s.equal===!0?!0:void 0});case"expression":return r({type:"expression",dxfId:d()},o("formula",{},x(this.bound(s.formula.startsWith("=")?s.formula:`=${s.formula}`))));case"dataBar":return r({type:"dataBar"},o("dataBar",{showValue:s.show===!1?!1:void 0},this.cfvo(s.min??{at:"min"}),this.cfvo(s.max??{at:"max"}),o("color",{rgb:K(s.color)})));case"colorScale":return r({type:"colorScale"},o("colorScale",{},...s.stops.map(i=>this.cfvo(i)),...s.stops.map(i=>o("color",{rgb:K(i.color)}))));case"iconSet":{const i=Number.parseInt(s.icons,10),c=s.stops??Array.from({length:i},(u,S)=>({at:"percent",value:Math.round(S*100/i)}));return r({type:"iconSet"},o("iconSet",{iconSet:s.icons,showValue:s.show===!1?!1:void 0,reverse:s.reverse===!0?!0:void 0},...c.map(u=>this.cfvo(u))))}}}validation(t){const{spec:e}=t;let s="";if(e.values){const h=e.values.join(",");(h.length>B||e.values.some(a=>a.includes(",")))&&this.left.push(`${this.sheet.name}!${e.range}: a list a file's cell cannot spell out, its values longer than ${String(B)} characters or holding a comma`),s=`"${h.slice(0,B)}"`}else s=this.bound(e.formula?.[0]);const n=this.bound(e.formula?.[1]),{error:r,prompt:d}=e;return e.multiple===!0&&this.left.push(`${this.sheet.name}!${e.range}: several choices in a cell: its text stays, and Excel's list offers one at a time`),o("dataValidation",{type:e.type,errorStyle:r?.style===void 0||r.style==="stop"?void 0:r.style,operator:e.operator===void 0||e.operator==="between"?void 0:e.operator,allowBlank:e.blank===!1?void 0:!0,showDropDown:e.dropdown===!1?!0:void 0,showInputMessage:d?.show===!1?void 0:!0,showErrorMessage:r?.show===!1||e.multiple===!0?void 0:!0,errorTitle:r?.title,error:r?.message,promptTitle:d?.title,prompt:d?.message,sqref:e.range},s===""?"":o("formula1",{},x(s)),n===""?"":o("formula2",{},x(n)))}validations(){const t=this.sheet.validations;return t.length===0?"":o("dataValidations",{count:t.length},...t.map(e=>this.validation(e)))}filterColumns(t){return[...t.columns.entries()].sort(([e],[s])=>e-s).map(([e,s])=>Ie(e-t.area.left,s))}sheetFilter(){const t=this.sheet.filters.find(e=>!e.table);return t?o("autoFilter",{ref:E(t.area)},...this.filterColumns(t)):""}columnFormula(t,e){if(!e?.node)return"";const s=V(e.node,this.isRangeName),n=O(e.node,{table:t.name,isTable:this.isTable,array:s});return o("calculatedColumnFormula",{array:s?!0:void 0},H(n))}tableXml(t,e){const s=t.area,n=E({...s,bottom:Math.max(s.bottom,s.top+1)}),r=t.spec.style??DEFAULT_TABLE_STYLE,d=this.sheet.filters.find(h=>h.table===t);return g+o("table",{xmlns:y.main,id:e,name:t.name,displayName:t.name,ref:n,totalsRowShown:0},d?o("autoFilter",{ref:n},...this.filterColumns(d)):"",o("tableColumns",{count:t.columns.length},...t.columns.map((h,a)=>o("tableColumn",{id:a+1,name:h.name},this.columnFormula(t,h.formula)))),r==="none"?o("tableStyleInfo",{showFirstColumn:0,showLastColumn:0,showRowStripes:1,showColumnStripes:0}):o("tableStyleInfo",{name:r,showFirstColumn:0,showLastColumn:0,showRowStripes:1,showColumnStripes:0}))}}const K=l=>`FF${l.slice(1).toUpperCase()}`;function Me(l){if(l.type==="dataBar"||l.type==="colorScale"||l.type==="iconSet")return{};const t={};for(const e of["bold","italic","underline","strike","color","fill","border"])l[e]!==void 0&&(t[e]=l[e]);return t}function Ie(l,t){return o("filterColumn",{colId:l},o("filters",{blank:t.blanks===!0?!0:void 0},...(t.values??[]).map(e=>o("filter",{val:e}))))}const p=l=>l===void 0?"":` s="${String(l)}"`,Z=l=>l.code!=="#CYCLE!";function _e(l){let t;for(const[e,s]of l)for(const n of s)t?(t.top=Math.min(t.top,e),t.bottom=Math.max(t.bottom,e),t.left=Math.min(t.left,n),t.right=Math.max(t.right,n)):t={top:e,bottom:e,left:n,right:n};return t}const Re=new Set(["width","height","hidden"]);function J(l){if(!l)return;const t=Object.fromEntries(Object.entries(l).filter(([e])=>!Re.has(e)));return Object.keys(t).length===0?void 0:t}const D=l=>g+o("Relationships",{xmlns:y.pkg},...l.map(([t,e],s)=>o("Relationship",{Id:`rId${String(s+1)}`,Type:t,Target:e})));function Le(l,t){const e=l.name(t);if(!e)return;const s=e.formula?.node;if(s)return O(s,{isTable:r=>l.table(r)!==void 0,array:!0});const{value:n}=e;return n==null?'""':typeof n=="string"?`"${n.replaceAll('"','""')}"`:typeof n=="boolean"?n?"TRUE":"FALSE":n instanceof P?n.code:String(n)}const Fe=(l,t)=>l.length===t.length&&l.every((e,s)=>e===t[s]),Pe=l=>`$${Y(l.left)}$${String(l.top+1)}:$${Y(l.right)}$${String(l.bottom+1)}`;export function writeXlsx(l,t={}){const e=l.wb,s=[];e.checks.length>0&&s.push(`${String(e.checks.length)} check${e.checks.length===1?"":"s"}: a file has no such thing`);const n=de(l);s.push(...n.left);const r=new pe,d=new ve,h=new TextEncoder,a={},i=[["/xl/workbook.xml",$.sheet]],c=Math.max(0,e.sheets.findIndex(m=>m.spec.hidden!==!0));let u=1,S=!1;const b=new Map;let k=0,M=0;for(const[m,f]of e.sheets.entries()){const v=String(m+1),T=Ae(f,l,t.file,s),q=new Ee(f,l,r,d,t.cached!==!1,s,T,n.sheets.find(C=>C.sheet===f)),U=q.write(m===c,u);S||=q.arrays,a[`xl/worksheets/sheet${v}.xml`]=U.xml,i.push([`/xl/worksheets/sheet${v}.xml`,$.worksheet]);const L=[];for(const C of U.tables){const A=`table${String(u)}.xml`;u+=1,a[`xl/tables/${A}`]=C,i.push([`/xl/tables/${A}`,$.table]),L.push([`${w}table`,`../tables/${A}`])}if(f.charts.length>0||T.length>0){k+=1;const C=`drawing${String(k)}.xml`;a[`xl/drawings/${C}`]=ue(f.charts,T),i.push([`/xl/drawings/${C}`,$.drawing]),L.push([`${w}drawing`,`../drawings/${C}`]);const A=f.charts.map(_=>{M+=1;const F=`chart${String(M)}.xml`;return a[`xl/charts/${F}`]=fe(l,f,_),i.push([`/xl/charts/${F}`,$.chart]),[`${w}chart`,`../charts/${F}`]});for(const _ of T){const W=[...b].find(([,te])=>Fe(te,_.bytes))?.[0]??`image${String(b.size+1)}${_.file}`;b.set(W,_.bytes),A.push([`${w}image`,`../media/${W}`])}a[`xl/drawings/_rels/${C}.rels`]=D(A)}L.length>0&&(a[`xl/worksheets/_rels/sheet${v}.xml.rels`]=D(L))}const Q=e.sheets.length,I=e.sheets.map((m,f)=>[`${w}worksheet`,`worksheets/sheet${String(f+1)}.xml`]);I.push([`${w}theme`,"theme/theme1.xml"]),I.push([`${w}styles`,"styles.xml"]),I.push([`${w}sharedStrings`,"sharedStrings.xml"]),S&&(I.push([`${w}sheetMetadata`,"metadata.xml"]),a["xl/metadata.xml"]=g+ke,i.push(["/xl/metadata.xml",$.metadata]));const N=[...e.names.values()].flatMap(m=>{const f=Le(e,m.name);return f===void 0?[]:[o("definedName",{name:m.name},x(f))]});e.sheets.forEach((m,f)=>{const v=m.filters.find(T=>!T.table);v&&N.push(o("definedName",{name:"_xlnm._FilterDatabase",localSheetId:f,hidden:!0},x(`${re(m.name)}${Pe(v.area)}`)))}),a["xl/workbook.xml"]=g+o("workbook",{xmlns:y.main,"xmlns:r":y.rel},o("workbookPr",{}),o("bookViews",{},o("workbookView",{activeTab:c===0?void 0:c})),o("sheets",{},...e.sheets.map((m,f)=>o("sheet",{name:m.name,sheetId:f+1,state:m.spec.hidden===!0?"hidden":void 0,"r:id":`rId${String(f+1)}`}))),N.length>0?o("definedNames",{},...N):"",o("calcPr",{calcId:xe,fullCalcOnLoad:!0})),a["xl/_rels/workbook.xml.rels"]=D(I),a["xl/styles.xml"]=g+r.xml(),a["xl/sharedStrings.xml"]=g+d.xml(),a["xl/theme/theme1.xml"]=g+ge,a["docProps/core.xml"]=g+o("cp:coreProperties",{"xmlns:cp":"http://schemas.openxmlformats.org/package/2006/metadata/core-properties","xmlns:dc":"http://purl.org/dc/elements/1.1/"},e.title===void 0?"":o("dc:title",{},x(e.title))),a["docProps/app.xml"]=g+o("Properties",{xmlns:"http://schemas.openxmlformats.org/officeDocument/2006/extended-properties"},o("Application",{},"AllyHub")),a["_rels/.rels"]=D([[`${w}officeDocument`,"xl/workbook.xml"],["http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties","docProps/core.xml"],[`${w}extended-properties`,"docProps/app.xml"]]),i.push(["/xl/styles.xml",$.styles],["/xl/sharedStrings.xml",$.strings],["/xl/theme/theme1.xml",$.theme],["/docProps/core.xml",$.core],["/docProps/app.xml",$.app]),a["[Content_Types].xml"]=g+o("Types",{xmlns:y.types},o("Default",{Extension:"rels",ContentType:"application/vnd.openxmlformats-package.relationships+xml"}),o("Default",{Extension:"xml",ContentType:"application/xml"}),...[...new Set([...b.keys()].map(m=>m.split(".").pop()??""))].sort().map(m=>o("Default",{Extension:m,ContentType:`image/${m==="jpg"?"jpeg":m}`})),...i.map(([m,f])=>o("Override",{PartName:m,ContentType:f})));const X=["[Content_Types].xml","_rels/.rels","docProps/app.xml","docProps/core.xml","xl/workbook.xml","xl/_rels/workbook.xml.rels",...Array.from({length:Q},(m,f)=>`xl/worksheets/sheet${String(f+1)}.xml`)],ee=[...X,...Object.keys(a).filter(m=>!X.includes(m)).sort()],j={};for(const m of ee)j[m]=[h.encode(a[m]??""),{mtime:G}];for(const[m,f]of[...b].sort(([v],[T])=>v.localeCompare(T)))j[`xl/media/${m}`]=[f,{mtime:G}];return{bytes:se(j),left:s}}

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

@@ -0,0 +1,28 @@
+/** Text as an ST_Xstring, then escaped for XML. */
+export declare function xstring(text: string): string;
+/** What an ST_Xstring says. */
+export declare const readXstring: (text: string) => string;
+export type Attrs = Record<string, string | number | boolean | undefined>;
+/** An element: its attributes in the order given (undefined ones left out, booleans as 1 and 0) and its children. */
+export declare function el(name: string, attrs?: Attrs, ...children: string[]): string;
+export declare const HEAD = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n";
+export declare const NS: {
+    readonly main: "http://schemas.openxmlformats.org/spreadsheetml/2006/main";
+    readonly rel: "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+    readonly pkg: "http://schemas.openxmlformats.org/package/2006/relationships";
+    readonly types: "http://schemas.openxmlformats.org/package/2006/content-types";
+    readonly drawing: "http://schemas.openxmlformats.org/drawingml/2006/main";
+};
+/** An element or an attribute as the parser gives it. */
+export type Tag = Record<string, unknown>;
+/** A part's root element. */
+export declare function readXml(text: string): Tag;
+export declare const tags: (v: unknown) => Tag[];
+export declare const tag: (v: unknown) => Tag | undefined;
+/** An element's text; "" for an empty one. */
+export declare function textOf(v: unknown): string;
+export declare const attr: (t: Tag | undefined, name: string) => string | undefined;
+export declare const numberAttr: (t: Tag | undefined, name: string) => number | undefined;
+/** An xsd:boolean. */
+export declare const flag: (t: Tag | undefined, name: string) => boolean | undefined;
+//# sourceMappingURL=xml.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/xlsx/xml.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{XMLParser as f}from"fast-xml-parser";const l={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"},c=e=>e<32&&e!==9&&e!==10||e===65534||e===65535||e>=55296&&e<=57343,p=e=>e.toString(16).toUpperCase().padStart(4,"0");export function xstring(e){const r=e.replace(/_(?=x[0-9A-Fa-f]{4}_)/gu,"_x005F_");let t="";for(const n of r){const o=n.codePointAt(0)??0;t+=n.length===1&&c(o)?`_x${p(o)}_`:n}return t.replace(/[&<>"]/gu,n=>l[n]??n)}export const readXstring=e=>e.includes("_x")?e.replace(/_x([0-9A-Fa-f]{4})_/gu,(r,t)=>String.fromCharCode(Number.parseInt(t,16))):e;export function el(e,r={},...t){let n="";for(const[i,s]of Object.entries(r))s!==void 0&&(n+=` ${i}="${xstring(typeof s=="boolean"?s?"1":"0":String(s))}"`);const o=t.join("");return o===""?`<${e}${n}/>`:`<${e}${n}>${o}</${e}>`}export const HEAD=`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+`,NS={main:"http://schemas.openxmlformats.org/spreadsheetml/2006/main",rel:"http://schemas.openxmlformats.org/officeDocument/2006/relationships",pkg:"http://schemas.openxmlformats.org/package/2006/relationships",types:"http://schemas.openxmlformats.org/package/2006/content-types",drawing:"http://schemas.openxmlformats.org/drawingml/2006/main"};const u=new Set(["c","row","col","cols","si","r","rPh","sheet","definedName","font","fill","border","numFmt","xf","Relationship","Override","Default","mergeCell","tablePart","tableColumn","sheetView","pane","selection","conditionalFormatting","dataValidation","hyperlink","rgbColor","brk","filterColumn","externalReference","gsd"]),d=new f({ignoreAttributes:!1,attributeNamePrefix:"",removeNSPrefix:!0,trimValues:!1,parseTagValue:!1,parseAttributeValue:!1,processEntities:!0,htmlEntities:!0,textNodeName:"#text",isArray:(e,r,t,n)=>!n&&u.has(e)});export function readXml(e){return d.parse(e)}const a=e=>typeof e=="object"?e:{};export const tags=e=>Array.isArray(e)?e.map(a):e===void 0?[]:[a(e)],tag=e=>{const r=Array.isArray(e)?e[0]:e;return r===void 0?void 0:a(r)};export function textOf(e){if(typeof e=="string")return e;if(e==null)return"";if(Array.isArray(e))return e.map(textOf).join("");const r=e["#text"];return typeof r=="string"?r:""}export const attr=(e,r)=>{const t=e?.[r];return typeof t=="string"?t:void 0},numberAttr=(e,r)=>{const t=attr(e,r);if(t===void 0||t==="")return;const n=Number(t);return Number.isFinite(n)?n:void 0},flag=(e,r)=>{const t=attr(e,r);return t===void 0?void 0:t==="1"||t==="true"};

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

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

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

@@ -0,0 +1,25 @@
+{
+  "name": "@allyhub-next/site",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    "./assets": {
+      "types": "./dist/assets.d.ts",
+      "default": "./dist/assets.js"
+    },
+    "./astro": {
+      "types": "./dist/astro.d.ts",
+      "default": "./dist/astro.js"
+    },
+    "./lockfile": {
+      "types": "./dist/lockfile.d.ts",
+      "default": "./dist/lockfile.js"
+    },
+    "./media": {
+      "types": "./dist/media.d.ts",
+      "default": "./dist/media.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

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

@@ -0,0 +1,165 @@
+import type { ChartLegendPosition, ChartType } from "@allyhub-next/formats";
+import { ColorFormat, FillFormat } from "./api.js";
+import type { ChartAxisDef, ChartDef, ChartLabelPosition, ChartLabelsDef, ChartSeriesDef } from "@allyhub-next/chart";
+import type { Color } from "./model.js";
+import { type Length } from "./units.js";
+/** The numbers a chart shows (python-pptx's `CategoryChartData`). */
+export declare class CategoryChartData {
+    number_format: string;
+    private names;
+    private readonly list;
+    constructor(options?: {
+        number_format?: string;
+    });
+    get categories(): string[];
+    set categories(v: readonly (string | number)[]);
+    add_category(label: string | number): void;
+    add_series(name: string, values?: readonly (number | null | undefined)[], number_format?: string): void;
+    /** The series as a chart holds them. */
+    _series(): ChartSeriesDef[];
+}
+/** A chart's text, or its labels' (`font`). */
+export declare class ChartFont {
+    private readonly read;
+    private readonly write;
+    constructor(read: () => {
+        size?: number;
+        color?: Color;
+    }, write: (v: {
+        size?: number;
+        color?: Color;
+    }) => void);
+    get size(): Length | undefined;
+    set size(v: Length | undefined);
+    get color(): ColorFormat;
+}
+/** A line's colour (`format.line`). */
+export declare class ChartLine {
+    private readonly read;
+    private readonly write;
+    constructor(read: () => Color | undefined, write: (c: Color | undefined) => void);
+    get color(): ColorFormat;
+}
+/** A series (python-pptx's `BarSeries`, `LineSeries`…). */
+export declare class ChartSeries {
+    private readonly def;
+    private readonly at;
+    constructor(def: ChartSeriesDef, at: number);
+    get name(): string;
+    get values(): readonly (number | null)[];
+    /** A marker's size in points (`marker.size`). */
+    get marker(): {
+        size: number | undefined;
+    };
+    get smooth(): boolean;
+    set smooth(v: boolean);
+    /** Its fill (`format.fill`), and its line's width (`format.line.width`); a line's or an area's colour is the fill's. */
+    get format(): {
+        fill: FillFormat;
+        line: {
+            width: Length | undefined;
+        };
+    };
+}
+/** Data labels (python-pptx's `DataLabels`). */
+export declare class DataLabels {
+    private readonly def;
+    constructor(def: ChartLabelsDef);
+    get show_value(): boolean;
+    set show_value(v: boolean);
+    get show_percentage(): boolean;
+    set show_percentage(v: boolean);
+    get show_category_name(): boolean;
+    set show_category_name(v: boolean);
+    get show_series_name(): boolean;
+    set show_series_name(v: boolean);
+    get number_format(): string;
+    set number_format(v: string);
+    get position(): ChartLabelPosition | undefined;
+    set position(v: ChartLabelPosition | undefined);
+    get font(): ChartFont;
+}
+/** A chart's plot (python-pptx's `BarPlot`, `LinePlot`…). */
+export declare class ChartPlot {
+    private readonly def;
+    constructor(def: ChartDef);
+    get categories(): readonly string[];
+    get series(): ChartSeries[];
+    get has_data_labels(): boolean;
+    set has_data_labels(v: boolean);
+    get data_labels(): DataLabels;
+    /** Between bars' groups, as a share of a bar's width, in %. */
+    get gap_width(): number;
+    set gap_width(v: number);
+    get overlap(): number;
+    set overlap(v: number);
+    get vary_by_categories(): boolean;
+    set vary_by_categories(v: boolean);
+}
+/** A chart's legend (python-pptx's `Legend`). */
+export declare class ChartLegend {
+    private readonly def;
+    constructor(def: ChartDef);
+    get position(): ChartLegendPosition;
+    set position(v: ChartLegendPosition);
+}
+/** A chart's axis (python-pptx's `ValueAxis`, `CategoryAxis`). */
+export declare class ChartAxis {
+    private readonly def;
+    constructor(def: ChartAxisDef);
+    get minimum_scale(): number | undefined;
+    set minimum_scale(v: number | undefined);
+    get maximum_scale(): number | undefined;
+    set maximum_scale(v: number | undefined);
+    get major_unit(): number | undefined;
+    set major_unit(v: number | undefined);
+    get has_major_gridlines(): boolean;
+    set has_major_gridlines(v: boolean);
+    get visible(): boolean;
+    set visible(v: boolean);
+    get reverse_order(): boolean;
+    set reverse_order(v: boolean);
+    /** Its tick labels' format (`tick_labels.number_format`). */
+    get tick_labels(): {
+        number_format: string;
+    };
+    /** Its gridlines' colour (`major_gridlines.format.line.color`). */
+    get major_gridlines(): {
+        format: {
+            line: ChartLine;
+        };
+    };
+    /** Its line's colour (`format.line.color`). */
+    get format(): {
+        line: ChartLine;
+    };
+}
+/** A chart (python-pptx's `Chart`), in its shape's `.chart`. */
+export declare class Chart {
+    private readonly def;
+    constructor(def: ChartDef);
+    get chart_type(): ChartType;
+    get has_legend(): boolean;
+    set has_legend(v: boolean);
+    get legend(): ChartLegend;
+    get has_title(): boolean;
+    set has_title(v: boolean);
+    /** Its title (`chart_title.text_frame.text`, and `chart_title.font.size`). */
+    get chart_title(): {
+        text_frame: {
+            text: string;
+        };
+        font: {
+            size: Length | undefined;
+        };
+    };
+    /** Its text's size and colour. */
+    get font(): ChartFont;
+    get plots(): ChartPlot[];
+    get series(): ChartSeries[];
+    get value_axis(): ChartAxis;
+    get category_axis(): ChartAxis;
+    /** Other numbers, in its look. */
+    replace_data(chart_data: CategoryChartData): void;
+}
+//# sourceMappingURL=chart-api.d.ts.map