reamkit 1.15.4 → 1.17.0

package/dist/esm/core/ir/sheet.d.ts

@@ -10,6 +10,9 @@ export interface SheetChartRef {
     readonly chartPartPath: string;
     readonly widthPt: number;
     readonly heightPt: number;
+    /** Where the anchor puts it, in points from the grid's top-left. */
+    readonly xPt?: number;
+    readonly yPt?: number;
 }
 /**
  * §20.5.2.1 xdr:pic — a picture anchored over a sheet's grid, sized from its
@@ -20,6 +23,9 @@ export interface SheetImageRef {
     readonly resourceId: ResourceId;
     readonly widthPt: number;
     readonly heightPt: number;
+    /** Where the anchor puts it, in points from the grid's top-left. */
+    readonly xPt?: number;
+    readonly yPt?: number;
 }
 /** One item (label + selection state) in a {@link SheetSlicer}. */
 export interface SheetSlicerItem {
@@ -73,10 +79,38 @@ export interface SheetComment {
  * spin/scroll/list controls. Render-only.
  */
 export interface SheetFormControl {
+    /**
+     * §18.3.1.19 `<control name>` — the shape's NAME, an identifier like
+     * "CheckBox28". Excel shows it in the name box, never on the page; it is what
+     * the after-the-grid listing calls a control that has no geometry.
+     */
     readonly name?: string;
+    /**
+     * The visible label, from the control's legacy VML `<v:textbox>`. A control
+     * drawn in place draws THIS beside its widget — never {@link name}, which is
+     * an internal id: 45540_form_Header.xlsx has forty captionless check boxes
+     * and printing their names put "CheckBox28" across the form's own text.
+     */
+    readonly caption?: string;
     readonly objectType?: string;
     readonly checked?: boolean;
     readonly value?: number;
+    /** Where the control sits on the sheet, in points from the grid's origin. */
+    readonly box?: SheetControlBox;
+    /** The caption's declared size, when the shape names one. */
+    readonly fontSizePt?: number;
+}
+/**
+ * A control's rectangle on the sheet, in points from the grid's top-left — read
+ * from its legacy VML shape, the only part that says where a control goes.
+ * Absent when the drawing carries no geometry, in which case the control is
+ * listed after the grid rather than drawn in place.
+ */
+export interface SheetControlBox {
+    readonly xPt: number;
+    readonly yPt: number;
+    readonly widthPt: number;
+    readonly heightPt: number;
 }
 /**
  * An ActiveX control resolved against its activeX part (E-SHEET W10): the control
@@ -87,6 +121,8 @@ export interface SheetFormControl {
  */
 export interface SheetActiveXControl {
     readonly type: string;
+    /** Where the control sits on the sheet — from the VML shape sharing its `shapeId`. */
+    readonly box?: SheetControlBox;
     /** §18.3.1.19 `<control name>` — the control's identifier, when it came that way. */
     readonly name?: string;
     readonly caption?: string;
@@ -97,6 +133,12 @@ export interface SheetActiveXControl {
 export interface Sheet {
     /** The sheet (tab) name. */
     readonly name: string;
+    /**
+     * §18.2.19 `<sheet @state>` — the tab is `hidden` or `veryHidden`. Carried
+     * because a consumer that shows the workbook (the HTML writer) may still want
+     * it; the paginated projection skips it, as Excel and LibreOffice do.
+     */
+    readonly hidden?: boolean;
     /**
      * The grid + per-sheet geometry exactly as parsed: cells, columns, rows,
      * merges, dimensions, pageSetup/printOptions, manual breaks, drawingRelId.
@@ -165,4 +207,23 @@ export interface SheetDoc {
     readonly resources: ResourceStore;
     /** Document metadata from docProps/core.xml. */
     readonly info?: DocumentInfo;
+    /**
+     * §20.1.6.2 the workbook theme's colour scheme, slot name → 6-hex. Cell
+     * colours are resolved against it at parse time; a header/footer's `&K` theme
+     * reference is resolved at projection time, which is why the palette travels.
+     */
+    readonly themePalette?: ReadonlyMap<string, string>;
+    /**
+     * §18.3.* — how many embedded objects (`<oleObject progId="Package">` and the
+     * like) the workbook carries. They print as an icon and a caption in Excel
+     * and Calc, both of which live in a metafile; the projection reports them.
+     */
+    readonly embeddedObjects?: number;
+    /**
+     * §20.5.2.x — how many anchored pictures are a metafile (WMF / EMF / PICT)
+     * rather than a raster. They keep their anchor and their box, and draw
+     * nothing: replaying a metafile is a different feature from embedding an
+     * image. The projection reports them.
+     */
+    readonly metafilePictures?: number;
 }

package/dist/esm/{excel → core}/number-format.d.ts

@@ -13,6 +13,20 @@
  * @returns The formatted display string.
  */
 export declare function applyNumberFormat(rawValue: string, numFmtId: number, customFormats: ReadonlyMap<number, string>, date1904?: boolean): string;
+/**
+ * The colour a number format paints its cell in (§18.8.31), as a 6-digit RRGGBB,
+ * or undefined when the section that applies declares none.
+ *
+ * A `[Red]` at the head of a section is part of the format, not decoration: the
+ * accounting codes write the negative section as `[Red]-#,##0.00`, and rendering
+ * it in the cell's own font colour loses the one signal the format exists for.
+ * `[Color 12]` indexes the same legacy palette a `<color indexed>` does.
+ *
+ * @param rawValue      The cell's raw stored value — it selects the section.
+ * @param numFmtId      The number-format id from the cell's `cellXf`.
+ * @param customFormats Custom format codes by id (from `<numFmts>`).
+ */
+export declare function numberFormatColorHex(rawValue: string, numFmtId: number, customFormats: ReadonlyMap<number, string>): string | undefined;
 /**
  * Excel serial date → JS `Date`. The default 1900 epoch uses 1899-12-30 as day 0
  * (so serial 1 is 1900-01-01) and inherits the Lotus 1-2-3 leap-year bug: serial 60
@@ -35,3 +49,26 @@ export declare function excelSerialToDate(serial: number, date1904: boolean): Da
  * @param month0 The 0-indexed month (0 = January).
  */
 export declare function excelSerialFromUtcParts(year: number, month0: number, day: number, date1904: boolean): number;
+/**
+ * A General number rounded to the decimals that fit `maxChars` characters.
+ *
+ * General is not a fixed format: a spreadsheet shows as many decimal places as
+ * the column has room for and ROUNDS to that, so 4.3900875881221957 in a
+ * column eight characters wide reads 4.390088. We rendered every stored digit
+ * and let the cell clip it, which turns the same value into 4.390087 — off by
+ * one in the last place shown, with nothing to say a digit was cut.
+ *
+ * The integer part is never dropped: a number too wide even without decimals
+ * keeps them all and the cell says so its own way (see hashOnOverflow).
+ *
+ * `fits` decides, and it must measure in the face this will be DRAWN in rather
+ * than count characters against the column's width in the document's unit.
+ * Counted that way we produced nine digits for a column that holds nine of
+ * Excel's and eight of ours, and the layout clipped the ninth — the very
+ * truncation this exists to prevent. Fewer digits than the reference shows is a
+ * coarser number; a clipped one is a different number.
+ *
+ * @param rawValue The cell's stored value.
+ * @param fits     Whether a rendering will fit the cell.
+ */
+export declare function generalToWidth(rawValue: string, fits: (text: string) => boolean): string;