allyhub 0.7.0 → 0.8.0

package/dist/node_modules/@allyhub/sheet/dist/api/charts.d.ts

@@ -0,0 +1,204 @@
+import { type SheetChart, type SheetChartAxis, type SheetChartType } from "@allyhub/formats";
+/** What a worksheet is to a reference. */
+interface HasTitle {
+    title: string;
+}
+export interface ReferenceOptions {
+    min_col?: number;
+    min_row?: number;
+    max_col?: number;
+    max_row?: number;
+    /** A range, Sheet!A1:B2 or A1:B2. */
+    range_string?: string;
+}
+/** A range of a worksheet, from 1 as openpyxl's. */
+export declare class Reference {
+    worksheet: HasTitle | undefined;
+    min_col: number;
+    min_row: number;
+    max_col: number;
+    max_row: number;
+    constructor(worksheet: HasTitle | undefined, o: ReferenceOptions);
+    /** Its text, from a sheet: short on its own. */
+    _text(own?: string): string;
+    /** Its columns, each a Reference. */
+    cols(): Reference[];
+    /** Its rows, each a Reference. */
+    rows(): Reference[];
+    pop(): Reference;
+}
+/** Where a chart's numbers are: a Reference, or a formula's text such as orders[total]. */
+export type ChartData = Reference | string;
+/** A line's look (`a:ln`). */
+export declare class LineProperties {
+    /** In EMU, 12,700 to the point, as openpyxl's. */
+    width: number | undefined;
+    solidFill: string | undefined;
+    noFill: boolean | undefined;
+    constructor();
+}
+/** A series' look (`c:spPr`). */
+export declare class GraphicalProperties {
+    solidFill: string | undefined;
+    noFill: boolean | undefined;
+    line: LineProperties;
+    constructor();
+}
+/** A line's points. */
+export declare class Marker {
+    symbol: string | undefined;
+    size: number | undefined;
+    constructor(o?: {
+        symbol?: string;
+        size?: number;
+    });
+}
+export interface SeriesOptions {
+    xvalues?: ChartData;
+    title?: string;
+    /** Its values' first cell is its name. */
+    title_from_data?: boolean;
+}
+export declare class Series {
+    val: ChartData;
+    xVal: ChartData | undefined;
+    /** Its name in words. */
+    title: string | undefined;
+    /** The cell that names it. */
+    _titleRef: ChartData | undefined;
+    smooth: boolean | undefined;
+    marker: Marker;
+    graphicalProperties: GraphicalProperties;
+    /** Its number format. */
+    _format: string | undefined;
+    constructor(values: ChartData, o?: SeriesOptions);
+}
+export declare class Legend {
+    /** r, l, t or b, as openpyxl's. */
+    position: string;
+    constructor();
+}
+export declare class Scaling {
+    min: number | undefined;
+    max: number | undefined;
+    /** minMax or maxMin. */
+    orientation: string;
+    constructor();
+}
+declare class Axis {
+    title: string | undefined;
+    scaling: Scaling;
+    majorUnit: number | undefined;
+    number_format: string | undefined;
+    delete: boolean | undefined;
+    /** null leaves its gridlines out. */
+    majorGridlines: object | null | undefined;
+    _spec(): SheetChartAxis | undefined;
+    _hold(a: SheetChartAxis | undefined): void;
+}
+export declare class TextAxis extends Axis {
+    constructor();
+}
+export declare class NumericAxis extends Axis {
+    constructor();
+}
+export declare class DataLabelList {
+    showVal: boolean | undefined;
+    showPercent: boolean | undefined;
+    showCatName: boolean | undefined;
+    showSerName: boolean | undefined;
+    /** Excel's dLblPos: outEnd, inEnd, ctr, inBase, t, b, l, r, bestFit. */
+    dLblPos: string | undefined;
+    constructor();
+}
+/** What openpyxl's chart classes share. */
+export declare abstract class ChartBase {
+    title: string | undefined;
+    /** null: no legend, as openpyxl's None. */
+    legend: Legend | null;
+    /** Centimetres, as openpyxl's. */
+    width: number;
+    height: number;
+    /** Excel's chart style; kept for openpyxl's sake, drawn by none. */
+    style: number | undefined;
+    anchor: string | undefined;
+    series: Series[];
+    dataLabels: DataLabelList | undefined;
+    x_axis: Axis;
+    y_axis: Axis;
+    /** Its categories. */
+    _labels: ChartData | undefined;
+    /** What of its entry in sheet.yaml nothing here says. */
+    _held: Partial<SheetChart>;
+    /** Its entry says no size of its own: it stays so while it keeps the one it had. */
+    _plainSize: {
+        width: number;
+        height: number;
+    } | undefined;
+    abstract _type(): SheetChartType;
+    /** Each column, or row, of a range as a series. */
+    add_data(data: ChartData, o?: {
+        titles_from_data?: boolean;
+        from_rows?: boolean;
+        title?: string;
+    }): void;
+    /** Names the categories of every series. */
+    set_categories(labels: ChartData): void;
+    append(series: Series): void;
+    /** Its entry in sheet.yaml, on a sheet. */
+    _spec(own: string): SheetChart;
+}
+export interface BarChartOptions {
+    /** col or bar. */
+    type?: "col" | "bar";
+    grouping?: "clustered" | "stacked" | "percentStacked";
+}
+export declare class BarChart extends ChartBase {
+    /** col for columns, bar for bars. */
+    type: "col" | "bar";
+    grouping: "clustered" | "stacked" | "percentStacked";
+    overlap: number | undefined;
+    gapWidth: number | undefined;
+    varyColors: boolean | undefined;
+    constructor(o?: BarChartOptions);
+    _type(): SheetChartType;
+    _spec(own: string): SheetChart;
+}
+export declare class LineChart extends ChartBase {
+    /** standard: a line chart has no other here. */
+    grouping: string;
+    constructor();
+    _type(): SheetChartType;
+}
+export declare class AreaChart extends ChartBase {
+    grouping: "standard" | "stacked" | "percentStacked";
+    constructor(o?: {
+        grouping?: AreaChart["grouping"];
+    });
+    _type(): SheetChartType;
+}
+export declare class PieChart extends ChartBase {
+    varyColors: boolean;
+    constructor();
+    _type(): SheetChartType;
+    _spec(own: string): SheetChart;
+}
+export declare class DoughnutChart extends ChartBase {
+    holeSize: number;
+    constructor();
+    _type(): SheetChartType;
+    _spec(own: string): SheetChart;
+}
+export declare class ScatterChart extends ChartBase {
+    x_axis: Axis;
+    constructor();
+    _type(): SheetChartType;
+    /** A smooth scatter's type says so of its series. */
+    _spec(own: string): SheetChart;
+}
+/** The entry sheet.yaml holds, as the class a script works with. */
+export declare function chartOfSpec(spec: SheetChart): ChartBase;
+/** A place a chart goes: a cell, as add_chart takes it. */
+export declare function anchorOf(anchor: string | undefined): string | undefined;
+export {};
+//# sourceMappingURL=charts.d.ts.map

package/dist/node_modules/@allyhub/sheet/dist/api/charts.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{strict as a}from"@allyhub/formats";import{cellName as S,rangeName as P,readAddress as L,readArea as N}from"../address.js";import{SHEET_CHART_DEFAULTS as w}from"../chart.js";import{sheetPrefix as z}from"../formula/print.js";import{HINT as o}from"./hint.js";import{colorText as E}from"./styles.js";const x=96/2.54,y=r=>Math.round(r*x),b=r=>Number((r/x).toFixed(3));function u(r,e,t){for(const s of Object.keys(e))if(!t.includes(s))throw new TypeError(`${r} takes ${t.join(", ")}; it has no ${s}. ${o}`)}export class Reference{worksheet;min_col;min_row;max_col;max_row;constructor(e,t){u("Reference",t,["min_col","min_row","max_col","max_row","range_string"]),this.worksheet=e;let s;if(t.range_string!==void 0){const c=t.range_string.lastIndexOf("!");if(s=N(t.range_string.slice(c+1).replaceAll("$","")),!s)throw new TypeError(`${t.range_string} is not a range. ${o}`)}return this.min_col=s?s.left+1:t.min_col??1,this.min_row=s?s.top+1:t.min_row??1,this.max_col=s?s.right+1:t.max_col??this.min_col,this.max_row=s?s.bottom+1:t.max_row??this.min_row,a(this,"Reference",o)}_text(e){const t={top:this.min_row-1,left:this.min_col-1,bottom:this.max_row-1,right:this.max_col-1},s=this.worksheet?.title;return`${s===void 0||s===e?"":z(s)}${P(t)}`}cols(){return Array.from({length:this.max_col-this.min_col+1},(e,t)=>new Reference(this.worksheet,{min_col:this.min_col+t,max_col:this.min_col+t,min_row:this.min_row,max_row:this.max_row}))}rows(){return Array.from({length:this.max_row-this.min_row+1},(e,t)=>new Reference(this.worksheet,{min_col:this.min_col,max_col:this.max_col,min_row:this.min_row+t,max_row:this.min_row+t}))}pop(){const e=new Reference(this.worksheet,{min_col:this.min_col,max_col:this.min_col,min_row:this.min_row,max_row:this.min_row});return this.min_row<this.max_row?this.min_row+=1:this.min_col+=1,e}}const g=(r,e)=>r===void 0?void 0:typeof r=="string"?r:r._text(e);export class LineProperties{width;solidFill;noFill;constructor(){return a(this,"LineProperties",o)}}export class GraphicalProperties{solidFill;noFill;line=new LineProperties;constructor(){return a(this,"GraphicalProperties",o)}}export class Marker{symbol;size;constructor(e={}){return u("Marker",e,["symbol","size"]),this.symbol=e.symbol,this.size=e.size,a(this,"Marker",o)}}export class Series{val;xVal;title;_titleRef;smooth;marker=new Marker;graphicalProperties=new GraphicalProperties;_format;constructor(e,t={}){if(u("Series",t,["xvalues","title","title_from_data"]),this.val=e,this.xVal=t.xvalues,this.title=t.title,t.title_from_data===!0){if(!(e instanceof Reference))throw new TypeError("title_from_data takes a Reference: a table's column names itself.");this._titleRef=e.pop()}return a(this,"Series",o)}}export class Legend{position="r";constructor(){return a(this,"Legend",o)}}export class Scaling{min;max;orientation="minMax";constructor(){return a(this,"Scaling",o)}}class k{title;scaling=new Scaling;majorUnit;number_format;delete;majorGridlines;_spec(){const e=this.scaling,t={...this.title===void 0?{}:{title:this.title},...e.min===void 0?{}:{min:e.min},...e.max===void 0?{}:{max:e.max},...this.majorUnit===void 0?{}:{major:this.majorUnit},...this.majorGridlines===null?{gridlines:!1}:{},...this.delete===!0?{visible:!1}:{},...this.number_format===void 0?{}:{format:this.number_format},...e.orientation==="maxMin"?{reverse:!0}:{}};return Object.keys(t).length===0?void 0:t}_hold(e){e&&(this.title=e.title,this.scaling.min=e.min,this.scaling.max=e.max,this.majorUnit=e.major,this.number_format=e.format,e.visible===!1&&(this.delete=!0),e.gridlines===!1&&(this.majorGridlines=null),e.reverse===!0&&(this.scaling.orientation="maxMin"))}}export class TextAxis extends k{constructor(){return super(),a(this,"TextAxis",o)}}export class NumericAxis extends k{constructor(){return super(),a(this,"NumericAxis",o)}}export class DataLabelList{showVal;showPercent;showCatName;showSerName;dLblPos;constructor(){return a(this,"DataLabelList",o)}}const A={r:"right",l:"left",t:"top",b:"bottom"},$={right:"r",left:"l",top:"t",bottom:"b"};export class ChartBase{title;legend=new Legend;width=15;height=7.5;style;anchor;series=[];dataLabels;x_axis=new TextAxis;y_axis=new NumericAxis;_labels;_held={};_plainSize;add_data(e,t={}){if(u("add_data",t,["titles_from_data","from_rows","title"]),typeof e=="string"){this.series.push(new Series(e,t.title===void 0?{}:{title:t.title}));return}for(const s of t.from_rows===!0?e.rows():e.cols())this.series.push(new Series(s,{title_from_data:t.titles_from_data===!0}))}set_categories(e){this._labels=e}append(e){this.series.push(e)}_spec(e){const t=this.dataLabels,s={category:this.x_axis._spec(),value:this.y_axis._spec()},c=this.series.map(l=>{const d=l.graphicalProperties,_=d.solidFill??d.line.solidFill,h=g(l._titleRef,e),f=g(l.xVal,e);return{values:g(l.val,e)??"",...f===void 0?{}:{x:f},...h!==void 0?{name:`=${h}`}:l.title===void 0?{}:{name:l.title},..._===void 0?{}:{color:E(_)},...l._format===void 0?{}:{format:l._format},...l.smooth===void 0?{}:{smooth:l.smooth},...d.line.width===void 0?{}:{line_width:d.line.width/12700},...l.marker.size===void 0?{}:{marker_size:l.marker.size}}}),m=g(this._labels,e),p=this.legend?A[this.legend.position]:void 0;return{...this._held,type:this._type(),at:this.anchor??"E15",...this.width===this._plainSize?.width?{}:{width:y(this.width)},...this.height===this._plainSize?.height?{}:{height:y(this.height)},...this.title===void 0?{}:{title:this.title},...m===void 0?{}:{categories:m},series:c,...p===void 0?{}:{legend:p},...t?{labels:{...t.showVal===void 0?{}:{value:t.showVal},...t.showPercent===void 0?{}:{percentage:t.showPercent},...t.showCatName===void 0?{}:{category:t.showCatName},...t.showSerName===void 0?{}:{series:t.showSerName},...t.dLblPos===void 0?{}:{position:t.dLblPos}}}:{},...s.value?{value_axis:s.value}:{},...s.category?{category_axis:s.category}:{}}}}export class BarChart extends ChartBase{type="col";grouping="clustered";overlap;gapWidth;varyColors;constructor(e={}){return super(),u("BarChart",e,["type","grouping"]),e.type&&(this.type=e.type),e.grouping&&(this.grouping=e.grouping),a(this,"BarChart",o)}_type(){const e=this.type==="bar"?"bar":"column";return this.grouping==="stacked"?`${e}-stacked`:this.grouping==="percentStacked"?`${e}-stacked-100`:`${e}-clustered`}_spec(e){return{...super._spec(e),...this.overlap===void 0?{}:{overlap:this.overlap},...this.gapWidth===void 0?{}:{gap_width:this.gapWidth},...this.varyColors===void 0?{}:{vary_by_categories:this.varyColors}}}}export class LineChart extends ChartBase{grouping="standard";constructor(){return super(),a(this,"LineChart",o)}_type(){if(this.grouping!=="standard")throw new TypeError(`A line chart here is standard, not ${this.grouping}: an AreaChart stacks. ${o}`);return this.series.some(e=>e.marker.symbol!==void 0&&e.marker.symbol!=="none")?"line-markers":"line"}}export class AreaChart extends ChartBase{grouping="standard";constructor(e={}){return super(),u("AreaChart",e,["grouping"]),e.grouping&&(this.grouping=e.grouping),a(this,"AreaChart",o)}_type(){return this.grouping==="stacked"?"area-stacked":this.grouping==="percentStacked"?"area-stacked-100":"area"}}export class PieChart extends ChartBase{varyColors=!0;constructor(){return super(),a(this,"PieChart",o)}_type(){return"pie"}_spec(e){return{...super._spec(e),...this.varyColors?{}:{vary_by_categories:!1}}}}export class DoughnutChart extends ChartBase{holeSize=50;constructor(){return super(),a(this,"DoughnutChart",o)}_type(){return"doughnut"}_spec(e){return{...super._spec(e),...this.holeSize===50?{}:{hole_size:this.holeSize}}}}export class ScatterChart extends ChartBase{x_axis=new NumericAxis;constructor(){return super(),a(this,"ScatterChart",o)}_type(){return this.series.some(e=>e.smooth===!0)?"scatter-smooth":this.series.every(e=>e.graphicalProperties.line.noFill===!0)?"scatter":"scatter-lines"}_spec(e){const t=super._spec(e);return t.type==="scatter-smooth"?{...t,series:t.series.map(s=>Object.fromEntries(Object.entries(s).filter(([c])=>c!=="smooth")))}:t}}const j=new Set(["type","at","width","height","title","categories","series","legend","labels","value_axis","category_axis","overlap","gap_width","vary_by_categories","hole_size"]);export function chartOfSpec(r){const t=(()=>{const i=r.type;if(i.startsWith("column")||i.startsWith("bar")){const n=new BarChart({type:i.startsWith("bar")?"bar":"col",grouping:i.endsWith("-100")?"percentStacked":i.endsWith("-stacked")?"stacked":"clustered"});return n.overlap=r.overlap,n.gapWidth=r.gap_width,n.varyColors=r.vary_by_categories,n}if(i==="line"||i==="line-markers")return new LineChart;if(i.startsWith("area"))return new AreaChart({grouping:i.endsWith("-100")?"percentStacked":i.endsWith("-stacked")?"stacked":"standard"});if(i==="pie"){const n=new PieChart;return r.vary_by_categories===!1&&(n.varyColors=!1),n}if(i==="doughnut"){const n=new DoughnutChart;return r.hole_size!==void 0&&(n.holeSize=r.hole_size),n}return new ScatterChart})(),{at:s,width:c,height:m,title:p,categories:l,series:d,legend:_,labels:h,value_axis:f,category_axis:v}=r,C=Object.fromEntries(Object.entries(r).filter(([i])=>!j.has(i)));if(t._held=C,t.anchor=s,t.width=b(c??w.width),t.height=b(m??w.height),t._plainSize={width:c===void 0?t.width:Number.NaN,height:m===void 0?t.height:Number.NaN},t.title=p,t._labels=l,_===void 0)t.legend=null;else{const i=new Legend;i.position=$[_],t.legend=i}if(h!==void 0&&h!==!1){const i=new DataLabelList;h===!0?i.showVal=!0:(i.showVal=h.value,i.showPercent=h.percentage,i.showCatName=h.category,i.showSerName=h.series,i.dLblPos=h.position),t.dataLabels=i}return t.x_axis._hold(v),t.y_axis._hold(f),t.series=d.map(i=>{const n=new Series(i.values,{...i.x===void 0?{}:{xvalues:i.x}});return i.name?.startsWith("=")===!0?n._titleRef=i.name.slice(1):n.title=i.name,i.color!==void 0&&(n.graphicalProperties.solidFill=i.color),i.line_width!==void 0&&(n.graphicalProperties.line.width=i.line_width*12700),n.smooth=r.type==="scatter-smooth"?!0:i.smooth,n.marker.size=i.marker_size,n._format=i.format,(r.type==="line-markers"||r.type==="scatter")&&(n.marker.symbol="circle"),r.type==="scatter"&&(n.graphicalProperties.line.noFill=!0),n}),t}export function anchorOf(r){if(r===void 0)return;const e=L(r);if(!e)throw new TypeError(`${r} is not a cell. ${o}`);return S(e)}

package/dist/node_modules/@allyhub/sheet/dist/api/page.d.ts

@@ -0,0 +1,83 @@
+import { type SheetHeaderFooter, type SheetNote, type SheetPrint } from "@allyhub/formats";
+/** What a page object changes: the sheet's `print`, and that it changed. */
+export interface PageHost {
+    _print: SheetPrint;
+    _changed(): void;
+}
+/** openpyxl's `PrintPageSetup`. */
+export declare class PageSetup {
+    private readonly ws;
+    constructor(ws: PageHost);
+    get orientation(): SheetPrint["orientation"];
+    set orientation(v: SheetPrint["orientation"]);
+    /** Excel's number (9 is A4), or a name: letter, legal, a3, a4, a5. */
+    get paperSize(): number | undefined;
+    set paperSize(v: number | string | undefined);
+    get fitToWidth(): number | undefined;
+    /** Pages wide. Setting it fits the sheet: openpyxl's pageSetUpPr.fitToPage is not asked for. */
+    set fitToWidth(v: number | undefined);
+    get fitToHeight(): number | undefined;
+    /** Pages tall; 0 as many as it takes. */
+    set fitToHeight(v: number | undefined);
+    private _fit;
+}
+/** openpyxl's `PageMargins`, in inches. */
+export declare class PageMargins {
+    private readonly ws;
+    constructor(ws: PageHost);
+    private _set;
+    get left(): number | undefined;
+    set left(v: number | undefined);
+    get right(): number | undefined;
+    set right(v: number | undefined);
+    get top(): number | undefined;
+    set top(v: number | undefined);
+    get bottom(): number | undefined;
+    set bottom(v: number | undefined);
+    get header(): number | undefined;
+    set header(v: number | undefined);
+    get footer(): number | undefined;
+    set footer(v: number | undefined);
+}
+/** openpyxl's `_HeaderFooterPart`: its `text`, Excel's codes holding. */
+export declare class HeaderFooterPart {
+    private readonly ws;
+    private readonly kind;
+    private readonly side;
+    constructor(ws: PageHost, kind: "header" | "footer", side: keyof SheetHeaderFooter);
+    get text(): string | undefined;
+    set text(v: string | undefined);
+}
+/** openpyxl's `_HeaderFooterItem`: a header's or a footer's three parts. */
+export declare class HeaderFooter {
+    readonly left: HeaderFooterPart;
+    readonly center: HeaderFooterPart;
+    readonly right: HeaderFooterPart;
+    constructor(ws: PageHost, kind: "header" | "footer");
+}
+/** openpyxl's `SheetProtection`, with no password. */
+export declare class SheetProtection {
+    private readonly read;
+    private readonly write;
+    constructor(read: () => boolean, write: (on: boolean) => void);
+    get sheet(): boolean;
+    set sheet(on: boolean);
+    enable(): void;
+    disable(): void;
+}
+/** openpyxl's `Comment`: Excel's Note. */
+export declare class Comment {
+    readonly text: string;
+    readonly author: string | undefined;
+    constructor(text: string, author?: string);
+    _file(): SheetNote;
+}
+/** openpyxl's `Image`: a picture over the cells, a path from the sheet's folder. */
+export declare class Image {
+    readonly path: string;
+    width: number | undefined;
+    height: number | undefined;
+    anchor: string | undefined;
+    constructor(path: string);
+}
+//# sourceMappingURL=page.d.ts.map

package/dist/node_modules/@allyhub/sheet/dist/api/page.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{SHEET_PAPERS as h,strict as s}from"@allyhub/formats";import{HINT as r}from"./hint.js";export class PageSetup{ws;constructor(t){return this.ws=t,s(this,"PageSetup",r)}get orientation(){return this.ws._print.orientation}set orientation(t){t===void 0?delete this.ws._print.orientation:this.ws._print.orientation=t,this.ws._changed()}get paperSize(){const{paper:t}=this.ws._print;return t===void 0?void 0:h[t]}set paperSize(t){const e=Object.keys(h).find(i=>i===t||String(h[i])===String(t));if(t===void 0)delete this.ws._print.paper;else if(e)this.ws._print.paper=e;else throw new RangeError(`Paper is one of ${Object.keys(h).join(", ")}, not ${String(t)}.`);this.ws._changed()}get fitToWidth(){return this.ws._print.fit?.width}set fitToWidth(t){this._fit("width",t)}get fitToHeight(){return this.ws._print.fit?.height}set fitToHeight(t){this._fit("height",t)}_fit(t,e){const i={...this.ws._print.fit};e===void 0?Reflect.deleteProperty(i,t):i[t]=e,Object.keys(i).length===0?delete this.ws._print.fit:this.ws._print.fit=i,this.ws._changed()}}export class PageMargins{ws;constructor(t){return this.ws=t,s(this,"PageMargins",r)}_set(t,e){const i={...this.ws._print.margins};e===void 0?Reflect.deleteProperty(i,t):i[t]=e,this.ws._print.margins=i,this.ws._changed()}get left(){return this.ws._print.margins?.left}set left(t){this._set("left",t)}get right(){return this.ws._print.margins?.right}set right(t){this._set("right",t)}get top(){return this.ws._print.margins?.top}set top(t){this._set("top",t)}get bottom(){return this.ws._print.margins?.bottom}set bottom(t){this._set("bottom",t)}get header(){return this.ws._print.margins?.header}set header(t){this._set("header",t)}get footer(){return this.ws._print.margins?.footer}set footer(t){this._set("footer",t)}}export class HeaderFooterPart{ws;kind;side;constructor(t,e,i){return this.ws=t,this.kind=e,this.side=i,s(this,"_HeaderFooterPart",r)}get text(){return this.ws._print[this.kind]?.[this.side]}set text(t){const e={...this.ws._print[this.kind]};t===void 0?Reflect.deleteProperty(e,this.side):e[this.side]=t,this.ws._print[this.kind]=e,this.ws._changed()}}export class HeaderFooter{left;center;right;constructor(t,e){return this.left=new HeaderFooterPart(t,e,"left"),this.center=new HeaderFooterPart(t,e,"center"),this.right=new HeaderFooterPart(t,e,"right"),s(this,"_HeaderFooterItem",r)}}export class SheetProtection{read;write;constructor(t,e){return this.read=t,this.write=e,s(this,"SheetProtection",r)}get sheet(){return this.read()}set sheet(t){this.write(t)}enable(){this.write(!0)}disable(){this.write(!1)}}export class Comment{text;author;constructor(t,e){return this.text=t,this.author=e,s(this,"Comment",r)}_file(){return this.author===void 0?this.text:{text:this.text,author:this.author}}}export class Image{path;width;height;anchor;constructor(t){return this.path=t,this.width=void 0,this.height=void 0,this.anchor=void 0,s(this,"Image",r)}}

package/dist/node_modules/@allyhub/sheet/dist/api/rules.d.ts

@@ -0,0 +1,170 @@
+import { type SheetConditional, type SheetValidation } from "@allyhub/formats";
+import { type Border, type Color, type Font, type PatternFill } from "./styles.js";
+export interface DifferentialStyleOptions {
+    font?: Font;
+    fill?: PatternFill;
+    border?: Border;
+}
+/** What a rule that holds gives a cell. */
+export declare class DifferentialStyle {
+    readonly font: Font | undefined;
+    readonly fill: PatternFill | undefined;
+    readonly border: Border | undefined;
+    constructor(o?: DifferentialStyleOptions);
+}
+export interface RuleOptions {
+    type: SheetConditional["type"] | "containsText";
+    operator?: string;
+    formula?: (string | number)[];
+    stopIfTrue?: boolean;
+    rank?: number;
+    percent?: boolean;
+    bottom?: boolean;
+    aboveAverage?: boolean;
+    equalAverage?: boolean;
+    text?: string;
+    dxf?: DifferentialStyle;
+}
+/** A rule as sheet.yaml holds it, but for the cells it is on. */
+type RuleSpec = {
+    type: string;
+} & Record<string, unknown>;
+/** openpyxl's Rule: `new Rule({ type: "top10", rank: 3, dxf })`. */
+export declare class Rule {
+    readonly type: string;
+    readonly operator: string | undefined;
+    readonly formula: (string | number)[];
+    readonly stopIfTrue: boolean;
+    readonly rank: number | undefined;
+    readonly percent: boolean;
+    readonly bottom: boolean;
+    readonly aboveAverage: boolean;
+    readonly equalAverage: boolean;
+    readonly text: string | undefined;
+    readonly dxf: DifferentialStyle | undefined;
+    /** What sheet.yaml holds of it; made here unless a helper made it. */
+    _spec: RuleSpec;
+    constructor(o: RuleOptions, spec?: RuleSpec);
+}
+export interface CellIsRuleOptions {
+    operator: string;
+    formula: (string | number)[];
+    stopIfTrue?: boolean;
+    font?: Font;
+    fill?: PatternFill;
+    border?: Border;
+}
+/** openpyxl's helper: fills are given as `PatternFill`, its bgColor or fgColor painting. */
+export declare function CellIsRule(o: CellIsRuleOptions): Rule;
+export type FormulaRuleOptions = Omit<CellIsRuleOptions, "operator" | "formula"> & {
+    formula: string[];
+};
+export declare function FormulaRule(o: FormulaRuleOptions): Rule;
+export interface ColorScaleRuleOptions {
+    start_type?: string;
+    start_value?: string | number;
+    start_color: string | Color;
+    mid_type?: string;
+    mid_value?: string | number;
+    mid_color?: string | Color;
+    end_type?: string;
+    end_value?: string | number;
+    end_color: string | Color;
+}
+export declare function ColorScaleRule(o: ColorScaleRuleOptions): Rule;
+export interface DataBarRuleOptions {
+    start_type?: string;
+    start_value?: string | number;
+    end_type?: string;
+    end_value?: string | number;
+    color: string | Color;
+    showValue?: boolean;
+}
+export declare function DataBarRule(o: DataBarRuleOptions): Rule;
+/** openpyxl's: IconSetRule("3TrafficLights1", "percent", [0, 33, 67], showValue, percent, reverse). */
+export declare function IconSetRule(icon_style: string, type: string, values: readonly (string | number)[], showValue?: boolean, _percent?: boolean, reverse?: boolean): Rule;
+/** `ws.conditional_formatting`: rules in the order added, the first the strongest. */
+export declare class ConditionalFormattingList {
+    _rules: SheetConditional[];
+    private readonly touched;
+    constructor(rules: SheetConditional[], touched: () => void);
+    add(range_string: string, cfRule: Rule): void;
+    get max_priority(): number;
+}
+export interface DataValidationOptions {
+    type?: SheetValidation["type"];
+    formula1?: string | number;
+    formula2?: string | number;
+    operator?: SheetValidation["operator"];
+    allow_blank?: boolean;
+    allowBlank?: boolean;
+    showDropDown?: boolean;
+    showErrorMessage?: boolean;
+    showInputMessage?: boolean;
+    errorStyle?: "stop" | "warning" | "information";
+    errorTitle?: string;
+    error?: string;
+    promptTitle?: string;
+    prompt?: string;
+    sqref?: string;
+    /** A list's cell may hold several of its values. */
+    multiple?: boolean;
+    /** What joins them; ", " unless it says. */
+    separator?: string;
+}
+export declare class DataValidation {
+    type: SheetValidation["type"];
+    formula1: string | number | undefined;
+    formula2: string | number | undefined;
+    operator: SheetValidation["operator"];
+    allow_blank: boolean | undefined;
+    showDropDown: boolean;
+    showErrorMessage: boolean;
+    showInputMessage: boolean;
+    errorStyle: "stop" | "warning" | "information" | undefined;
+    errorTitle: string | undefined;
+    error: string | undefined;
+    promptTitle: string | undefined;
+    prompt: string | undefined;
+    sqref: string;
+    /** A list's cell may hold several of its values: not an openpyxl field. */
+    multiple: boolean;
+    /** What joins them; ", " unless it says. */
+    separator: string | undefined;
+    constructor(o?: DataValidationOptions);
+    get allowBlank(): boolean | undefined;
+    /** openpyxl's: showDropDown is true when the arrow is hidden. */
+    get hide_drop_down(): boolean;
+    get validation_type(): string;
+    /** The cells it is on, a cell or a range at a time. */
+    add(cell: string | {
+        coordinate: string;
+    }): void;
+}
+/** What sheet.yaml holds of a DataValidation. */
+export declare function validationSpec(v: DataValidation): SheetValidation;
+/** A DataValidation of what sheet.yaml holds. */
+export declare function validationOf(spec: SheetValidation): DataValidation;
+/** `ws.data_validations`. */
+export declare class DataValidationList {
+    dataValidation: DataValidation[];
+    private readonly touched;
+    constructor(list: DataValidation[], touched: () => void);
+    append(dv: DataValidation): void;
+    get count(): number;
+}
+/** `ws.auto_filter`, and a table's `autoFilter`. */
+export declare class AutoFilter {
+    ref: string | undefined;
+    /** What each column keeps, by its place in the filter. */
+    _columns: Map<number, {
+        values?: string[] | undefined;
+        blanks?: boolean | undefined;
+    }>;
+    private readonly touched;
+    constructor(ref: string | undefined, touched: () => void);
+    /** openpyxl's: a column of the filter, from 0, keeps these values, and blanks if `blank`. */
+    add_filter_column(col_id: number, vals: readonly string[], blank?: boolean): void;
+}
+export {};
+//# sourceMappingURL=rules.d.ts.map

package/dist/node_modules/@allyhub/sheet/dist/api/rules.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{SHEET_ICONS as h,SHEET_OPERATORS as m,SHEET_VALIDATIONS as w,strict as u}from"@allyhub/formats";import{readArea as b,readAreas as T}from"../address.js";import{HINT as s}from"./hint.js";import{borderLook as _,colorText as d}from"./styles.js";function i(e,r,t){for(const o of Object.keys(r))if(!t.includes(o))throw new TypeError(`${e} takes ${t.join(", ")}; it has no ${o}. ${s}`)}function c(e){if(typeof e=="number")return e;const r=e.trim(),t=Number(r);if(r!==""&&!Number.isNaN(t))return t;const o=/^"((?:[^"]|"")*)"$/u.exec(r);return o?(o[1]??"").replaceAll('""','"'):r.startsWith("=")?r:`=${r}`}function y(e){if(e!==void 0)return typeof e=="number"?String(e):e.startsWith("=")?e.slice(1):`"${e.replaceAll('"','""')}"`}export class DifferentialStyle{font;fill;border;constructor(r={}){return i("DifferentialStyle",r,["font","fill","border"]),this.font=r.font,this.fill=r.fill,this.border=r.border,u(this,"DifferentialStyle",s)}}const x=e=>e?.bgColor?.rgb??e?.fgColor?.rgb;function k(e){const r={},{font:t,fill:o,border:a}=e??{};t?.bold===!0&&(r.bold=!0),t?.italic===!0&&(r.italic=!0),t?.strike===!0&&(r.strike=!0),t?.underline!==void 0&&(r.underline=!0),t?.color&&(r.color=t.color.rgb);const n=x(o);if(n!==void 0&&(r.fill=n),a){const{border:l}=_(a);l&&Object.keys(l).length>0&&(r.border=l)}return r}const I={">":"greaterThan",">=":"greaterThanOrEqual","<":"lessThan","<=":"lessThanOrEqual","=":"equal","==":"equal","!=":"notEqual"};export class Rule{type;operator;formula;stopIfTrue;rank;percent;bottom;aboveAverage;equalAverage;text;dxf;_spec;constructor(r,t){return i("Rule",r,["type","operator","formula","stopIfTrue","rank","percent","bottom","aboveAverage","equalAverage","text","dxf"]),this.type=r.type,this.operator=r.operator,this.formula=r.formula??[],this.stopIfTrue=r.stopIfTrue??!1,this.rank=r.rank,this.percent=r.percent??!1,this.bottom=r.bottom??!1,this.aboveAverage=r.aboveAverage??!0,this.equalAverage=r.equalAverage??!1,this.text=r.text,this.dxf=r.dxf,this._spec=t??S(r),u(this,"Rule",s)}}function S(e){const r=k(e.dxf),t=e.stopIfTrue===!0?{stop:!0}:{};switch(e.type){case"cellIs":{const o=I[e.operator??""]??e.operator;if(!m.includes(o))throw new TypeError(`${String(e.operator)} is not an operator: ${m.join(", ")}.`);return{type:"cellIs",operator:o,formula:(e.formula??[]).map(c),...r,...t}}case"expression":{const[o]=e.formula??[];if(o===void 0)throw new TypeError("An expression rule has a formula.");const a=String(o);return{type:"expression",formula:a.startsWith("=")?a:`=${a}`,...r,...t}}case"containsText":{if(e.text===void 0)throw new TypeError("A containsText rule has a text.");const o=e.operator===void 0||e.operator==="containsText"?{}:{operator:e.operator};return{type:"containsText",text:e.text,...o,...r,...t}}case"duplicateValues":case"uniqueValues":return{type:e.type,...r,...t};case"top10":return{type:"top10",rank:e.rank??10,...e.percent===!0?{percent:!0}:{},...e.bottom===!0?{bottom:!0}:{},...r,...t};case"aboveAverage":return{type:"aboveAverage",...e.aboveAverage===!1?{below:!0}:{},...e.equalAverage===!0?{equal:!0}:{},...r,...t};default:throw new TypeError(`A rule of type ${e.type} is made by ColorScaleRule, DataBarRule or IconSetRule.`)}}export function CellIsRule(e){return i("CellIsRule",e,["operator","formula","stopIfTrue","font","fill","border"]),new Rule({type:"cellIs",operator:e.operator,formula:e.formula,...e.stopIfTrue===void 0?{}:{stopIfTrue:e.stopIfTrue},dxf:new DifferentialStyle({...e.font?{font:e.font}:{},...e.fill?{fill:e.fill}:{},...e.border?{border:e.border}:{}})})}export function FormulaRule(e){return i("FormulaRule",e,["formula","stopIfTrue","font","fill","border"]),new Rule({type:"expression",formula:e.formula,...e.stopIfTrue===void 0?{}:{stopIfTrue:e.stopIfTrue},dxf:new DifferentialStyle({...e.font?{font:e.font}:{},...e.fill?{fill:e.fill}:{},...e.border?{border:e.border}:{}})})}function f(e,r,t){const o=e??t;return r===void 0?{at:o}:{at:o,value:c(r)}}export function ColorScaleRule(e){i("ColorScaleRule",e,["start_type","start_value","start_color","mid_type","mid_value","mid_color","end_type","end_value","end_color"]);const r=[{...f(e.start_type,e.start_value,"min"),color:d(e.start_color)},...e.mid_color===void 0?[]:[{...f(e.mid_type,e.mid_value,"percentile"),color:d(e.mid_color)}],{...f(e.end_type,e.end_value,"max"),color:d(e.end_color)}];return new Rule({type:"colorScale"},{type:"colorScale",stops:r})}export function DataBarRule(e){i("DataBarRule",e,["start_type","start_value","end_type","end_value","color","showValue"]);const r=f(e.start_type,e.start_value,"min"),t=f(e.end_type,e.end_value,"max");return new Rule({type:"dataBar"},{type:"dataBar",color:d(e.color),...r.at==="min"?{}:{min:r},...t.at==="max"?{}:{max:t},...e.showValue===!1?{show:!1}:{}})}export function IconSetRule(e,r,t,o,a,n){if(!h.includes(e))throw new TypeError(`${e} is not an icon set: ${h.join(", ")}.`);return new Rule({type:"iconSet"},{type:"iconSet",icons:e,stops:t.map(l=>f(r,l,"percent")),...o===!1?{show:!1}:{},...n===!0?{reverse:!0}:{}})}export class ConditionalFormattingList{_rules;touched;constructor(r,t){return this._rules=r,this.touched=t,u(this,"ConditionalFormattingList",s)}add(r,t){if(!T(r))throw new TypeError(`${r} is not a range.`);this._rules.push({...t._spec,range:r}),this.touched()}get max_priority(){return this._rules.length}}export class DataValidation{type;formula1;formula2;operator;allow_blank;showDropDown;showErrorMessage;showInputMessage;errorStyle;errorTitle;error;promptTitle;prompt;sqref;multiple;separator;constructor(r={}){i("DataValidation",r,["type","formula1","formula2","operator","allow_blank","allowBlank","showDropDown","showErrorMessage","showInputMessage","errorStyle","errorTitle","error","promptTitle","prompt","sqref","multiple","separator"]);const t=r.type??"custom";if(!w.includes(t))throw new TypeError(`${t} is not a validation: ${w.join(", ")}.`);return this.type=t,this.formula1=r.formula1,this.formula2=r.formula2,this.operator=r.operator,this.allow_blank=r.allow_blank??r.allowBlank,this.showDropDown=r.showDropDown??!1,this.showErrorMessage=r.showErrorMessage??!0,this.showInputMessage=r.showInputMessage??!0,this.errorStyle=r.errorStyle,this.errorTitle=r.errorTitle,this.error=r.error,this.promptTitle=r.promptTitle,this.prompt=r.prompt,this.sqref=r.sqref??"",this.multiple=r.multiple??!1,this.separator=r.separator,u(this,"DataValidation",s)}get allowBlank(){return this.allow_blank}get hide_drop_down(){return this.showDropDown}get validation_type(){return this.type}add(r){const t=typeof r=="string"?r:r.coordinate;if(!b(t))throw new TypeError(`${t} is not a range.`);this.sqref=this.sqref===""?t:`${this.sqref} ${t}`}}export function validationSpec(e){const r=e.formula1,t=e.type==="list"&&typeof r=="string"?/^"((?:[^"]|"")*)"$/u.exec(r.trim()):null,o=[r,e.formula2].flatMap(p=>p===void 0?[]:[c(p)]),a=p=>Object.fromEntries(Object.entries(p).filter(([,g])=>g!==void 0)),n=a({title:e.promptTitle,message:e.prompt,show:e.showInputMessage?void 0:!1}),l=a({style:e.errorStyle,title:e.errorTitle,message:e.error,show:e.showErrorMessage?void 0:!1});return{range:e.sqref,type:e.type,...e.operator===void 0?{}:{operator:e.operator},...t?{values:(t[1]??"").split(",")}:o.length>0?{formula:o}:{},...e.multiple?{multiple:!0}:{},...e.separator===void 0?{}:{separator:e.separator},...e.allow_blank===!1?{blank:!1}:{},...e.showDropDown?{dropdown:!1}:{},...Object.keys(n).length>0?{prompt:n}:{},...Object.keys(l).length>0?{error:l}:{}}}export function validationOf(e){const[r,t]=e.formula??[],o=e.values?`"${e.values.join(",")}"`:y(r),a={type:e.type,sqref:e.range,showDropDown:e.dropdown===!1,showErrorMessage:e.error?.show!==!1,showInputMessage:e.prompt?.show!==!1};o!==void 0&&(a.formula1=o);const n=y(t);return n!==void 0&&(a.formula2=n),e.operator!==void 0&&(a.operator=e.operator),e.blank===!1&&(a.allow_blank=!1),e.error?.style!==void 0&&(a.errorStyle=e.error.style),e.error?.title!==void 0&&(a.errorTitle=e.error.title),e.error?.message!==void 0&&(a.error=e.error.message),e.prompt?.title!==void 0&&(a.promptTitle=e.prompt.title),e.prompt?.message!==void 0&&(a.prompt=e.prompt.message),e.multiple===!0&&(a.multiple=!0),e.separator!==void 0&&(a.separator=e.separator),new DataValidation(a)}export class DataValidationList{dataValidation;touched;constructor(r,t){return this.dataValidation=r,this.touched=t,u(this,"DataValidationList",s)}append(r){this.dataValidation.push(r),this.touched()}get count(){return this.dataValidation.length}}export class AutoFilter{ref;_columns=new Map;touched;constructor(r,t){return this.ref=r,this.touched=t,u(this,"AutoFilter",s)}add_filter_column(r,t,o=!1){this._columns.set(r,{...t.length===0?{}:{values:[...t]},...o?{blanks:!0}:{}}),this.touched()}}

package/dist/node_modules/@allyhub/sheet/dist/api/styles.d.ts

@@ -0,0 +1,117 @@
+import { SHEET_ALIGNS, SHEET_BORDERS, SHEET_PATTERNS, SHEET_VALIGNS } from "@allyhub/formats";
+import type { CellLook } from "../workbook.js";
+/** openpyxl's colours: RRGGBB or AARRGGBB, with or without #; here #RRGGBB. */
+export declare function colorText(value: string | Color): string;
+export declare class Color {
+    readonly rgb: string;
+    constructor(rgb: string | {
+        rgb: string;
+    });
+}
+export interface FontOptions {
+    name?: string;
+    size?: number;
+    sz?: number;
+    bold?: boolean;
+    b?: boolean;
+    italic?: boolean;
+    i?: boolean;
+    underline?: "single" | "double" | "singleAccounting" | "doubleAccounting";
+    u?: "single" | "double" | "singleAccounting" | "doubleAccounting";
+    strike?: boolean;
+    color?: string | Color;
+}
+export declare class Font {
+    readonly name: string | undefined;
+    readonly size: number | undefined;
+    readonly bold: boolean;
+    readonly italic: boolean;
+    readonly underline: FontOptions["underline"];
+    readonly strike: boolean;
+    readonly color: Color | undefined;
+    constructor(o?: FontOptions);
+    get b(): boolean;
+    get i(): boolean;
+    get sz(): number | undefined;
+    get u(): FontOptions["underline"];
+}
+type Pattern = (typeof SHEET_PATTERNS)[number];
+export interface PatternFillOptions {
+    fill_type?: Pattern;
+    patternType?: Pattern;
+    fgColor?: string | Color;
+    bgColor?: string | Color;
+    start_color?: string | Color;
+    end_color?: string | Color;
+}
+export declare class PatternFill {
+    readonly fill_type: Pattern | undefined;
+    readonly fgColor: Color | undefined;
+    readonly bgColor: Color | undefined;
+    constructor(first?: Pattern | PatternFillOptions, more?: PatternFillOptions);
+    get patternType(): Pattern | undefined;
+    get start_color(): Color | undefined;
+    get end_color(): Color | undefined;
+}
+type BorderStyle = (typeof SHEET_BORDERS)[number];
+export interface SideOptions {
+    style?: BorderStyle;
+    border_style?: BorderStyle;
+    color?: string | Color;
+}
+export declare class Side {
+    readonly style: BorderStyle | undefined;
+    readonly color: Color | undefined;
+    constructor(o?: SideOptions);
+    get border_style(): BorderStyle | undefined;
+}
+export interface BorderOptions {
+    left?: Side;
+    right?: Side;
+    top?: Side;
+    bottom?: Side;
+}
+export declare class Border {
+    readonly left: Side;
+    readonly right: Side;
+    readonly top: Side;
+    readonly bottom: Side;
+    constructor(o?: BorderOptions);
+}
+type Horizontal = (typeof SHEET_ALIGNS)[number];
+type Vertical = (typeof SHEET_VALIGNS)[number];
+export interface AlignmentOptions {
+    horizontal?: Horizontal;
+    vertical?: Vertical;
+    wrap_text?: boolean;
+    wrapText?: boolean;
+    shrink_to_fit?: boolean;
+    shrinkToFit?: boolean;
+    indent?: number;
+    text_rotation?: number;
+    textRotation?: number;
+}
+export declare class Alignment {
+    readonly horizontal: Horizontal | undefined;
+    readonly vertical: Vertical | undefined;
+    readonly wrap_text: boolean | undefined;
+    readonly shrink_to_fit: boolean | undefined;
+    readonly indent: number;
+    readonly text_rotation: number;
+    constructor(o?: AlignmentOptions);
+    get wrapText(): boolean | undefined;
+    get shrinkToFit(): boolean | undefined;
+    get textRotation(): number;
+}
+/** A style object as the look fields it sets. */
+export declare const fontLook: (f: Font) => CellLook;
+export declare function fillLook(f: PatternFill): CellLook;
+export declare function borderLook(b: Border): CellLook;
+export declare const alignmentLook: (a: Alignment) => CellLook;
+/** The style objects a look reads back as. */
+export declare const fontOf: (l: CellLook) => Font;
+export declare function fillOf(l: CellLook): PatternFill;
+export declare const borderOf: (l: CellLook) => Border;
+export declare const alignmentOf: (l: CellLook) => Alignment;
+export {};
+//# sourceMappingURL=styles.d.ts.map

package/dist/node_modules/@allyhub/sheet/dist/api/styles.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{SHEET_ALIGNS as f,SHEET_BORDERS as u,SHEET_PATTERNS as h,SHEET_VALIGNS as p,strict as l}from"@allyhub/formats";import{HINT as i}from"./hint.js";function s(t,e,n){for(const r of Object.keys(e))if(!n.includes(r))throw new TypeError(`${t} takes ${n.join(", ")}; it has no ${r}. ${i}`)}export function colorText(t){if(t instanceof Color)return t.rgb;const e=t.replace(/^#/u,"");if(!/^(?:[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/u.test(e))throw new TypeError(`${t} is not a colour: RRGGBB or AARRGGBB.`);return`#${e.slice(-6).toUpperCase()}`}export class Color{rgb;constructor(e){return this.rgb=colorText(typeof e=="string"?e:e.rgb),l(this,"Color",i)}}const d=t=>t===void 0?void 0:new Color(colorText(t));export class Font{name;size;bold;italic;underline;strike;color;constructor(e={}){return s("Font",e,["name","size","sz","bold","b","italic","i","underline","u","strike","color"]),this.name=e.name,this.size=e.size??e.sz,this.bold=e.bold??e.b??!1,this.italic=e.italic??e.i??!1,this.underline=e.underline??e.u,this.strike=e.strike??!1,this.color=d(e.color),l(this,"Font",i)}get b(){return this.bold}get i(){return this.italic}get sz(){return this.size}get u(){return this.underline}}export class PatternFill{fill_type;fgColor;bgColor;constructor(e={},n={}){const r=typeof e=="string"?{...n,fill_type:e}:e;s("PatternFill",r,["fill_type","patternType","fgColor","bgColor","start_color","end_color"]);const o=r.fill_type??r.patternType;if(o!==void 0&&!h.includes(o))throw new TypeError(`${o} is not a fill: ${h.join(", ")}.`);return this.fill_type=o,this.fgColor=d(r.fgColor??r.start_color),this.bgColor=d(r.bgColor??r.end_color),l(this,"PatternFill",i)}get patternType(){return this.fill_type}get start_color(){return this.fgColor}get end_color(){return this.bgColor}}export class Side{style;color;constructor(e={}){s("Side",e,["style","border_style","color"]);const n=e.style??e.border_style;if(n!==void 0&&!u.includes(n))throw new TypeError(`${n} is not a border: ${u.join(", ")}.`);return this.style=n,this.color=d(e.color),l(this,"Side",i)}get border_style(){return this.style}}export class Border{left;right;top;bottom;constructor(e={}){return s("Border",e,["left","right","top","bottom"]),this.left=e.left??new Side,this.right=e.right??new Side,this.top=e.top??new Side,this.bottom=e.bottom??new Side,l(this,"Border",i)}}export class Alignment{horizontal;vertical;wrap_text;shrink_to_fit;indent;text_rotation;constructor(e={}){if(s("Alignment",e,["horizontal","vertical","wrap_text","wrapText","shrink_to_fit","shrinkToFit","indent","text_rotation","textRotation"]),e.horizontal!==void 0&&!f.includes(e.horizontal))throw new TypeError(`${e.horizontal} is not an alignment: ${f.join(", ")}.`);if(e.vertical!==void 0&&!p.includes(e.vertical))throw new TypeError(`${e.vertical} is not an alignment: ${p.join(", ")}.`);return this.horizontal=e.horizontal,this.vertical=e.vertical,this.wrap_text=e.wrap_text??e.wrapText,this.shrink_to_fit=e.shrink_to_fit??e.shrinkToFit,this.indent=e.indent??0,this.text_rotation=e.text_rotation??e.textRotation??0,l(this,"Alignment",i)}get wrapText(){return this.wrap_text}get shrinkToFit(){return this.shrink_to_fit}get textRotation(){return this.text_rotation}}const c=t=>t.style===void 0?void 0:{style:t.style,...t.color?{color:t.color.rgb}:{}};export const fontLook=t=>({bold:t.bold,italic:t.italic,strike:t.strike,underline:t.underline??!1,...t.name===void 0?{}:{font:t.name},...t.size===void 0?{}:{size:t.size},...t.color?{color:t.color.rgb}:{}});export function fillLook(t){return t.fill_type===void 0?{}:t.fill_type==="solid"&&!t.bgColor&&t.fgColor?{fill:t.fgColor.rgb}:{fill:{pattern:t.fill_type,...t.fgColor?{color:t.fgColor.rgb}:{},...t.bgColor?{background:t.bgColor.rgb}:{}}}}export function borderLook(t){const e=c(t.left),n=c(t.right),r=c(t.top),o=c(t.bottom);return{border:{...e?{left:e}:{},...n?{right:n}:{},...r?{top:r}:{},...o?{bottom:o}:{}}}}export const alignmentLook=t=>({...t.horizontal===void 0?{}:{align:t.horizontal},...t.vertical===void 0?{}:{valign:t.vertical},...t.wrap_text===void 0?{}:{wrap:t.wrap_text},...t.shrink_to_fit===void 0?{}:{shrink:t.shrink_to_fit},...t.indent===0?{}:{indent:t.indent},...t.text_rotation===0?{}:{rotation:t.text_rotation}}),fontOf=t=>new Font({...t.font===void 0?{}:{name:t.font},...t.size===void 0?{}:{size:t.size},bold:t.bold??!1,italic:t.italic??!1,strike:t.strike??!1,...typeof t.underline=="string"?{underline:t.underline}:t.underline===!0?{underline:"single"}:{},...t.color===void 0?{}:{color:t.color}});export function fillOf(t){const{fill:e}=t;return e===void 0?new PatternFill:typeof e=="string"?new PatternFill({fill_type:"solid",fgColor:e}):new PatternFill({fill_type:e.pattern,...e.color===void 0?{}:{fgColor:e.color},...e.background===void 0?{}:{bgColor:e.background}})}const a=t=>t===void 0?new Side:new Side({style:t.style,...t.color===void 0?{}:{color:t.color}});export const borderOf=t=>new Border({left:a(t.border?.left),right:a(t.border?.right),top:a(t.border?.top),bottom:a(t.border?.bottom)}),alignmentOf=t=>new Alignment({...t.align===void 0?{}:{horizontal:t.align},...t.valign===void 0?{}:{vertical:t.valign},...t.wrap===void 0?{}:{wrap_text:t.wrap},...t.shrink===void 0?{}:{shrink_to_fit:t.shrink},...t.indent===void 0?{}:{indent:t.indent},...t.rotation===void 0?{}:{text_rotation:t.rotation}});