@particle-academy/holy-sheet 2.5.0 → 2.7.0

package/dist/index.d.cts

@@ -58,6 +58,18 @@ interface SheetSchema {
     columnWidths?: Record<number | string, number>;
     frozenRows?: number;
     frozenCols?: number;
+    /** 1-based row number → pixels. */
+    rowHeights?: Record<number | string, number>;
+    print?: {
+        orientation?: "portrait" | "landscape";
+        fitToWidth?: boolean;
+        /** `{page}` / `{pages}` print the page number and count. */
+        footer?: {
+            left?: string;
+            center?: string;
+            right?: string;
+        };
+    };
 }
 interface HolySheetSchema {
     sheets: SheetSchema[];
@@ -223,7 +235,7 @@ interface SetMetaOp {
 }
 
 /** This package's own version, pinned to package.json by `version.test.ts`. */
-declare const VERSION = "2.5.0";
+declare const VERSION = "2.7.0";
 type Any$6 = any;
 /**
  * Agent — the structured-tool surface for Holy Sheet. Mirrors PHP `Agent`.
@@ -295,7 +307,7 @@ type Any$5 = any;
  * over `Agent`. Provided for parity / DI ergonomics; most callers use `Agent`.
  */
 declare class HolySheet {
-    static readonly VERSION = "2.5.0";
+    static readonly VERSION = "2.7.0";
     validate(schema: Any$5): ValidationError[];
     toBytes(schema: Any$5): Uint8Array;
     write(schema: Any$5, path: string): Promise<WriteResult>;
@@ -428,6 +440,16 @@ declare class MergedRegion {
     ref(): string;
 }
 
+/** How a sheet prints. Mirrors the PHP `Sheet::$print` array. */
+interface PrintSetup {
+    orientation: "portrait" | "landscape" | null;
+    fitToWidth: boolean;
+    footer: {
+        left: string;
+        center: string;
+        right: string;
+    } | null;
+}
 /** A worksheet. Mirrors PHP `Workbook\Sheet`. Cells are an A1-keyed map. */
 declare class Sheet {
     readonly name: string;
@@ -436,7 +458,12 @@ declare class Sheet {
     readonly columnWidths: Map<number, number>;
     readonly frozenRows: number;
     readonly frozenCols: number;
-    constructor(name: string, cells?: Map<string, Cell>, mergedRegions?: MergedRegion[], columnWidths?: Map<number, number>, frozenRows?: number, frozenCols?: number);
+    /** 1-based row number → pixels. */
+    readonly rowHeights: Map<number, number>;
+    readonly print: PrintSetup | null;
+    constructor(name: string, cells?: Map<string, Cell>, mergedRegions?: MergedRegion[], columnWidths?: Map<number, number>, frozenRows?: number, frozenCols?: number, 
+    /** 1-based row number → pixels. */
+    rowHeights?: Map<number, number>, print?: PrintSetup | null);
     /** rowNumber → (colLetter → Cell), sorted by ascending row number. */
     rows(): Map<number, Map<string, Cell>>;
     hasComments(): boolean;
@@ -547,10 +574,6 @@ declare class Theme {
     totalsFormat(): CellFormat | null;
 }
 
-/**
- * XLSX writer — emits a complete OOXML SpreadsheetML package as bytes.
- * Mirrors PHP `Writer\XlsxWriter` (file I/O moved to the Agent for isomorphism).
- */
 declare class XlsxWriter {
     toBytes(workbook: Workbook): Uint8Array;
     private contentTypesXml;

package/dist/index.d.ts

@@ -58,6 +58,18 @@ interface SheetSchema {
     columnWidths?: Record<number | string, number>;
     frozenRows?: number;
     frozenCols?: number;
+    /** 1-based row number → pixels. */
+    rowHeights?: Record<number | string, number>;
+    print?: {
+        orientation?: "portrait" | "landscape";
+        fitToWidth?: boolean;
+        /** `{page}` / `{pages}` print the page number and count. */
+        footer?: {
+            left?: string;
+            center?: string;
+            right?: string;
+        };
+    };
 }
 interface HolySheetSchema {
     sheets: SheetSchema[];
@@ -223,7 +235,7 @@ interface SetMetaOp {
 }
 
 /** This package's own version, pinned to package.json by `version.test.ts`. */
-declare const VERSION = "2.5.0";
+declare const VERSION = "2.7.0";
 type Any$6 = any;
 /**
  * Agent — the structured-tool surface for Holy Sheet. Mirrors PHP `Agent`.
@@ -295,7 +307,7 @@ type Any$5 = any;
  * over `Agent`. Provided for parity / DI ergonomics; most callers use `Agent`.
  */
 declare class HolySheet {
-    static readonly VERSION = "2.5.0";
+    static readonly VERSION = "2.7.0";
     validate(schema: Any$5): ValidationError[];
     toBytes(schema: Any$5): Uint8Array;
     write(schema: Any$5, path: string): Promise<WriteResult>;
@@ -428,6 +440,16 @@ declare class MergedRegion {
     ref(): string;
 }
 
+/** How a sheet prints. Mirrors the PHP `Sheet::$print` array. */
+interface PrintSetup {
+    orientation: "portrait" | "landscape" | null;
+    fitToWidth: boolean;
+    footer: {
+        left: string;
+        center: string;
+        right: string;
+    } | null;
+}
 /** A worksheet. Mirrors PHP `Workbook\Sheet`. Cells are an A1-keyed map. */
 declare class Sheet {
     readonly name: string;
@@ -436,7 +458,12 @@ declare class Sheet {
     readonly columnWidths: Map<number, number>;
     readonly frozenRows: number;
     readonly frozenCols: number;
-    constructor(name: string, cells?: Map<string, Cell>, mergedRegions?: MergedRegion[], columnWidths?: Map<number, number>, frozenRows?: number, frozenCols?: number);
+    /** 1-based row number → pixels. */
+    readonly rowHeights: Map<number, number>;
+    readonly print: PrintSetup | null;
+    constructor(name: string, cells?: Map<string, Cell>, mergedRegions?: MergedRegion[], columnWidths?: Map<number, number>, frozenRows?: number, frozenCols?: number, 
+    /** 1-based row number → pixels. */
+    rowHeights?: Map<number, number>, print?: PrintSetup | null);
     /** rowNumber → (colLetter → Cell), sorted by ascending row number. */
     rows(): Map<number, Map<string, Cell>>;
     hasComments(): boolean;
@@ -547,10 +574,6 @@ declare class Theme {
     totalsFormat(): CellFormat | null;
 }
 
-/**
- * XLSX writer — emits a complete OOXML SpreadsheetML package as bytes.
- * Mirrors PHP `Writer\XlsxWriter` (file I/O moved to the Agent for isomorphism).
- */
 declare class XlsxWriter {
     toBytes(workbook: Workbook): Uint8Array;
     private contentTypesXml;