allyhub 0.4.0 → 0.6.0

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

@@ -0,0 +1,83 @@
+import { type SheetHeaderFooter, type SheetNote, type SheetPrint } from "@allyhub-next/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-next/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-next/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-next/sheet/dist/api/rectangles.d.ts

@@ -0,0 +1,4 @@
+import type { Area, Place } from "../address.js";
+/** Places as the fewest rectangles reading rows left to right finds: runs in a row, then rows with the same run. */
+export declare function rectangles(places: readonly Place[]): Area[];
+//# sourceMappingURL=rectangles.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/api/rectangles.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export function rectangles(c){const f=[...c].sort((o,t)=>o.row-t.row||o.col-t.col),s=[];for(const o of f){const t=s[s.length-1];t?.top===o.row&&t.right===o.col-1?t.right=o.col:s.push({top:o.row,bottom:o.row,left:o.col,right:o.col})}const e=[],l=[];for(const o of s){const t=e.find(r=>r.bottom===o.top-1&&r.left===o.left&&r.right===o.right);t?t.bottom=o.bottom:e.push({...o});for(let r=e.length-1;r>=0;r--){const n=e[r];n&&n.bottom<o.top-1&&(l.push(n),e.splice(r,1))}}return[...l,...e].sort((o,t)=>o.top-t.top||o.left-t.left)}

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

@@ -0,0 +1,170 @@
+import { type SheetConditional, type SheetValidation } from "@allyhub-next/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-next/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-next/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-next/sheet/dist/api/styles.d.ts

@@ -0,0 +1,117 @@
+import { SHEET_ALIGNS, SHEET_BORDERS, SHEET_PATTERNS, SHEET_VALIGNS } from "@allyhub-next/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-next/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-next/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}});