@sheetxl/sdk 0.6.17 → 0.6.19

package/node/esm/{BSkaqwyDqSBFahkS.mjs → zm4iD0p6YdIsQOZx.mjs}

@@ -1,5 +1,5 @@
 /**
- * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.6.17
+ * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.6.19
  *
  * (C) 2025-present SheetXL Inc. & Michael T. Ford
  * License: The license can be found at https://www.sheetxl.com/license.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sheetxl/sdk",
   "description": "SDK - A high-performance, embeddable spreadsheet engine.",
-  "version": "0.6.17",
+  "version": "0.6.19",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -31,9 +31,9 @@
     "automation"
   ],
   "dependencies": {
-    "@sheetxl/primitives": "^0.6.17",
-    "@sheetxl/scripting": "^0.6.17",
-    "@sheetxl/utils": "^0.6.17",
+    "@sheetxl/primitives": "^0.6.19",
+    "@sheetxl/scripting": "^0.6.19",
+    "@sheetxl/utils": "^0.6.19",
     "bahttext": "^2.3.0",
     "bessel": "^1.0.2",
     "chalk": "^5.5.0",

package/types/index.d.ts

@@ -2200,6 +2200,10 @@ export declare namespace IBorder {
      * Modifiers describe a partial list of properties that can be set with values or shorthand strings.
      */
     export type Modifiers = Partial<IBorder.Properties>;
+    /**
+     * Options for updating a border.
+     */
+    export type Update = IBorder | Modifiers | string | null;
     /**
      * JSON representation of a border.
      */
@@ -8157,6 +8161,14 @@ export declare namespace IFill {
          */
         type: IFill.Type;
     }
+    /**
+     * Modifiers describe a partial list of properties that can be set with values or shorthand strings.
+     */
+    export type Modifiers = Partial<IFill.Properties>;
+    /**
+     * Options for updating a fill.
+     */
+    export type Update = IFill | Modifiers | string | null;
     /**
      * A JSON representation useful for persistence.
      */
@@ -14047,7 +14059,7 @@ export declare interface IStyle {
      * @param options Optional configuration for the update.
      * @returns The `IBorder` object for further modifications.
      */
-    setBorder(border: IBorder | IProperties.ResolvableProperties<IBorder.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+    setBorder(border: IBorder.Update, options?: IStyle.UpdateOptions): IStyle;
     /**
      * Fill properties for the background.
      */
@@ -14061,7 +14073,7 @@ export declare interface IStyle {
      * @param options Optional configuration for the update.
      * @returns The `IFill` object for further modifications.
      */
-    setFill(fill: IFill | IProperties.ResolvableProperties<IFill.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+    setFill(fill: IFill.Update, options?: IStyle.UpdateOptions): IStyle;
     /**
      * Returns the alignment for the style.
      */
@@ -14069,13 +14081,13 @@ export declare interface IStyle {
     /**
      * Sets the alignment style.
      *
-     * This method allows updating alignments using an {@link ITextFrame.IAlignment} or a shorthand property object.
+     * This method allows updating alignments using an {@link ITextFrame.IAlignment.Update} or a shorthand property object.
      *
      * @param alignment The alignment object or a shorthand property object to apply. Pass `null` to clear.
      * @param options Optional configuration for the update.
      * @returns The `ITextFrame.IAlignment` object for further modifications.
      */
-    setAlignment(alignment: ITextFrame.IAlignment | IProperties.ResolvableProperties<ITextFrame.IAlignment.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+    setAlignment(alignment: ITextFrame.IAlignment.Update, options?: IStyle.UpdateOptions): IStyle;
     /**
      * Returns the font for the style.
      */
@@ -14089,7 +14101,7 @@ export declare interface IStyle {
      * @param options Optional configuration for the update.
      * @returns The `IStyledFont` object for further modifications.
      */
-    setFont(font: IStyledFont | IProperties.ResolvableProperties<IStyledFont.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+    setFont(font: IStyledFont.Update, options?: IStyle.UpdateOptions): IStyle;
     /**
      * Returns an instance of the named style that this is derived from.
      */
@@ -14910,6 +14922,14 @@ export declare namespace IStyledFont {
         outline?: boolean;
         extend?: boolean;
     }
+    /**
+     * Modifiers describe a partial list of properties that can be set with values or shorthand strings.
+     */
+    export type Modifiers<C = IColor.Serializable> = Partial<IStyledFont.Properties<C>>;
+    /**
+     * Options for updating a font.
+     */
+    export type Update<C = IColor.Serializable> = IStyledFont | Modifiers<C> | string | null;
     export interface JSON extends Properties<string> {
     }
 }
@@ -15901,6 +15921,14 @@ export declare namespace ITextBoxAlignment {
     }
     export interface JSON extends Properties {
     }
+    /**
+     * Modifiers describe a partial list of properties that can be set with values or shorthand strings.
+     */
+    export type Modifiers = Partial<ITextBoxAlignment.Properties>;
+    /**
+     * Options for updating an ITextBoxAlignment.
+     */
+    export type Update = ITextBoxAlignment | Modifiers | string | null;
 }
 
 /**
@@ -15969,6 +15997,14 @@ export declare namespace ITextFrame {
     export namespace IAlignment {
         export type Properties = ITextBoxAlignment.Properties;
         export type JSON = ITextBoxAlignment.JSON;
+        /**
+         * Modifiers describe a partial list of properties that can be set with values or shorthand strings.
+         */
+        export type Modifiers = ITextBoxAlignment.Modifiers;
+        /**
+         * Options for updating an IAlignment.
+         */
+        export type Update = ITextBoxAlignment.Update;
     }
     export type IAlignment = ITextBoxAlignment;
     /**

package/types/scripting.d.ts

@@ -3142,6 +3142,14 @@ declare module "fill/IFill" {
              */
             type: IFill.Type;
         }
+        /**
+         * Modifiers describe a partial list of properties that can be set with values or shorthand strings.
+         */
+        type Modifiers = Partial<IFill.Properties>;
+        /**
+         * Options for updating a fill.
+         */
+        type Update = IFill | Modifiers | string | null;
         /**
          * A JSON representation useful for persistence.
          */
@@ -3768,6 +3776,14 @@ declare module "text/TextBoxAlignment" {
         }
         interface JSON extends Properties {
         }
+        /**
+         * Modifiers describe a partial list of properties that can be set with values or shorthand strings.
+         */
+        type Modifiers = Partial<ITextBoxAlignment.Properties>;
+        /**
+         * Options for updating an ITextBoxAlignment.
+         */
+        type Update = ITextBoxAlignment | Modifiers | string | null;
     }
 }
 declare module "text/ITextFrame" {
@@ -3842,6 +3858,14 @@ declare module "text/ITextFrame" {
         namespace IAlignment {
             type Properties = _IAlignment.Properties;
             type JSON = _IAlignment.JSON;
+            /**
+             * Modifiers describe a partial list of properties that can be set with values or shorthand strings.
+             */
+            type Modifiers = _IAlignment.Modifiers;
+            /**
+             * Options for updating an IAlignment.
+             */
+            type Update = _IAlignment.Update;
         }
         type IAlignment = _IAlignment;
         /**
@@ -4814,6 +4838,14 @@ declare module "text/richtext/IStyledFont" {
             outline?: boolean;
             extend?: boolean;
         }
+        /**
+         * Modifiers describe a partial list of properties that can be set with values or shorthand strings.
+         */
+        type Modifiers<C = IColor.Serializable> = Partial<IStyledFont.Properties<C>>;
+        /**
+         * Options for updating a font.
+         */
+        type Update<C = IColor.Serializable> = IStyledFont | Modifiers<C> | string | null;
         interface JSON extends Properties<string> {
         }
     }
@@ -5101,6 +5133,10 @@ declare module "border/IBorder" {
          * Modifiers describe a partial list of properties that can be set with values or shorthand strings.
          */
         type Modifiers = Partial<IBorder.Properties>;
+        /**
+         * Options for updating a border.
+         */
+        type Update = IBorder | Modifiers | string | null;
         /**
          * JSON representation of a border.
          */
@@ -7265,7 +7301,7 @@ declare module "style/IStyle" {
          * @param options Optional configuration for the update.
          * @returns The `IBorder` object for further modifications.
          */
-        setBorder(border: IBorder | IProperties.ResolvableProperties<IBorder.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+        setBorder(border: IBorder.Update, options?: IStyle.UpdateOptions): IStyle;
         /**
          * Fill properties for the background.
          */
@@ -7279,7 +7315,7 @@ declare module "style/IStyle" {
          * @param options Optional configuration for the update.
          * @returns The `IFill` object for further modifications.
          */
-        setFill(fill: IFill | IProperties.ResolvableProperties<IFill.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+        setFill(fill: IFill.Update, options?: IStyle.UpdateOptions): IStyle;
         /**
          * Returns the alignment for the style.
          */
@@ -7287,13 +7323,13 @@ declare module "style/IStyle" {
         /**
          * Sets the alignment style.
          *
-         * This method allows updating alignments using an {@link ITextFrame.IAlignment} or a shorthand property object.
+         * This method allows updating alignments using an {@link ITextFrame.IAlignment.Update} or a shorthand property object.
          *
          * @param alignment The alignment object or a shorthand property object to apply. Pass `null` to clear.
          * @param options Optional configuration for the update.
          * @returns The `ITextFrame.IAlignment` object for further modifications.
          */
-        setAlignment(alignment: ITextFrame.IAlignment | IProperties.ResolvableProperties<ITextFrame.IAlignment.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+        setAlignment(alignment: ITextFrame.IAlignment.Update, options?: IStyle.UpdateOptions): IStyle;
         /**
          * Returns the font for the style.
          */
@@ -7307,7 +7343,7 @@ declare module "style/IStyle" {
          * @param options Optional configuration for the update.
          * @returns The `IStyledFont` object for further modifications.
          */
-        setFont(font: IStyledFont | IProperties.ResolvableProperties<IStyledFont.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+        setFont(font: IStyledFont.Update, options?: IStyle.UpdateOptions): IStyle;
         /**
          * Returns an instance of the named style that this is derived from.
          */
@@ -20554,23 +20590,23 @@ declare module "sheet/style/SheetCellStyle" {
         /** {@inheritDoc IStyle.getBorder} */
         getBorder(): IBorder;
         /** {@inheritDoc IStyle.setBorder} */
-        setBorder(border: IBorder | IProperties.ResolvableProperties<IBorder.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+        setBorder(border: IBorder.Update, options?: IStyle.UpdateOptions): IStyle;
         /** {@inheritDoc IStyle.getFont} */
         getFont(): IStyledFont;
         /** {@inheritDoc IStyle.setFont} */
-        setFont(font: IStyledFont | IProperties.ResolvableProperties<IStyledFont.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+        setFont(font: IStyledFont.Update, options?: IStyle.UpdateOptions): IStyle;
         /** {@inheritDoc IStyle.getFill} */
         getFill(): IFill.ISolid | IFill.IGradient | IFill.IPattern | IFill.INone;
         /** {@inheritDoc IStyle.setFill} */
-        setFill(fill: IFill | IProperties.ResolvableProperties<IFill.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+        setFill(fill: IFill.Update, options?: IStyle.UpdateOptions): IStyle;
         /** {@inheritDoc IStyle.getAlignment} */
         getAlignment(): ITextFrame.IAlignment;
         /** {@inheritDoc IStyle.setAlignment} */
-        setAlignment(alignment: ITextFrame.IAlignment | IProperties.ResolvableProperties<ITextFrame.IAlignment.Properties> | string | null, options?: IStyle.UpdateOptions): IStyle;
+        setAlignment(alignment: ITextFrame.IAlignment.Update | string | null, options?: IStyle.UpdateOptions): IStyle;
         /** {@inheritDoc IStyle.getNumberFormat} */
         getNumberFormat(): string;
         /** {@inheritDoc IStyle.setNumberFormat} */
-        setNumberFormat(numFmt: string | null, options?: IStyle.UpdateOptions): this;
+        setNumberFormat(numFmt: string | null, options?: IStyle.UpdateOptions): IStyle;
         /** {@inheritDoc IStyle.getQuotePrefix} */
         getQuotePrefix(): boolean;
         /** {@inheritDoc IStyle.setQuotePrefix} */