@mescius/spread-sheets 19.0.4 → 19.0.6

package/dist/gc.spread.sheets.d.ts

@@ -75,6 +75,71 @@ declare module GC{
             "above"|"below"|"equalOrAbove"|"equalOrBelow"|"above1StdDev"|"below1StdDev"|"above2StdDev"|"below2StdDev"|"above3StdDev"|"below3StdDev"
         
 
+        /**
+         * @typedef GC.Data.ButtonListOptions
+         * @property {string} type - The type of the cell type, supports "buttonList".
+         * @property {GC.Data.ItemOptions[]} items - Gets or sets the items for the buttonList list, which supports Object Array which each item contains text and value.
+         * @property {string} direction - Gets or sets the buttonList list's orders, which support "horizontal", "vertical".
+         * @property {number} maxColumnCount - Gets or sets the items for the buttonList list's column count.
+         * @property {number} maxRowCount - Gets or sets the items for the buttonList list's row count.
+         * @property {boolean} isFlowLayout - Gets or sets the buttonList list's layout is auto fit.
+         * @property {Object} itemSpacing - Gets or sets the space for two items in the buttonList.
+         * @property {number} itemSpacing.horizontal - The space for two items in horizontal direction.
+         * @property {number} itemSpacing.vertical - The space for two items in vertical direction.
+         * @property {string} selectedBackColor - Gets or sets the selected buttonList's background color.
+         * @property {string} selectedForeColor - Gets or sets the selected buttonList's fore color.
+         * @property {string} padding - Gets or sets the buttonList's padding in pixels relative to the cell.
+         * @property {string} selectionMode - Gets or sets the buttonList's select mode, which supports "single", "multiple".
+         */
+        export type ButtonListOptions = 
+            {
+                /**
+                 * The type of the cell type, supports "buttonList".
+                 */
+                type: "buttonList";
+                /**
+                 * Gets or sets the items for the buttonList list, which supports Object Array which each item contains text and value.
+                 */
+                items: GC.Data.ItemOptions[];
+                /**
+                 * Gets or sets the buttonList list's orders, which support "horizontal", "vertical".
+                 */
+                direction?: "horizontal" | "vertical";
+                /**
+                 * Gets or sets the items for the buttonList list's column count.
+                 */
+                maxColumnCount?: number;
+                /**
+                 * Gets or sets the items for the buttonList list's row count.
+                 */
+                maxRowCount?: number;
+                /**
+                 * Gets or sets the buttonList list's layout is auto fit.
+                 */
+                isFlowLayout?: boolean;
+                /**
+                 * Gets or sets the space for two items in the buttonList.
+                 */
+                itemSpacing?: { horizontal: number; vertical: number };
+                /**
+                 * Gets or sets the selected buttonList's background color.
+                 */
+                selectedBackColor?: string;
+                /**
+                 * Gets or sets the selected buttonList's fore color.
+                 */
+                selectedForeColor?: string;
+                /**
+                 * Gets or sets the buttonList's padding in pixels relative to the cell.
+                 */
+                padding?: string;
+                /**
+                 * Gets or sets the buttonList's select mode, which supports "single", "multiple".
+                 */
+                selectionMode?: "single" | "multiple";
+            }
+        
+
         /**
          * @typedef GC.Data.CellButtonOptions
          * @property {string} position - The button's position in cell, which supports "left", "right", "leftOfText", "rightOfText".
@@ -232,31 +297,31 @@ declare module GC{
                 /**
                  * The caption.
                  */
-                caption: string;
+                caption?: string;
                 /**
                  * The text when cell value is true.
                  */
-                textTrue: string;
+                textTrue?: string;
                 /**
                  * The text when cell value is indeterminate.
                  */
-                textIndeterminate: string;
+                textIndeterminate?: string;
                 /**
                  * The text when cell value is false.
                  */
-                textFalse: string;
+                textFalse?: string;
                 /**
                  * The text alignment relative to the check box, which supports "top", "bottom", "left", "right".
                  */
-                textAlign: "top" | "bottom" | "left" | "right";
+                textAlign?: "top" | "bottom" | "left" | "right";
                 /**
                  * Whether the check box supports three states.
                  */
-                isThreeState: boolean;
+                isThreeState?: boolean;
                 /**
                  * The check box size.
                  */
-                boxSize: number;
+                boxSize?: number;
             }
         
 
@@ -412,6 +477,19 @@ declare module GC{
             }
         
 
+        /**
+         * @typedef GC.Data.CustomCellTypeOptions
+         * @property {string} typeName - The type name of the customized cell type.
+         */
+        export type CustomCellTypeOptions = 
+            {
+                /**
+                 * The type name of the customized cell type.
+                 */
+                typeName: string;
+            }
+        
+
         /**
          * @typedef GC.Data.DataBarAxisPosition
          * @type {"automatic"|"cellMidPoint"|"none"}
@@ -1303,27 +1381,27 @@ declare module GC{
                 /**
                  * The color of the link.
                  */
-                linkColor: string;
+                linkColor?: string;
                 /**
                  * The color of the visited link.
                  */
-                visitedLinkColor: string;
+                visitedLinkColor?: string;
                 /**
                  * The text of the link.
                  */
-                text: string;
+                text?: string;
                 /**
                  * The tooltip of the link.
                  */
-                linkToolTip: string;
+                linkToolTip?: string;
                 /**
                  * The type of the link's target, which support "blank", "self", "parent", "top".
                  */
-                target: "blank" | "self" | "parent" | "top";
+                target?: "blank" | "self" | "parent" | "top";
                 /**
                  * Whether to move to the active cell when clicked.
                  */
-                activeOnClick: boolean;
+                activeOnClick?: boolean;
             }
         
 
@@ -2519,31 +2597,31 @@ declare module GC{
                 /**
                  * The the radio box or check box's orders, which support "horizontal", "vertical".
                  */
-                direction: "horizontal" | "vertical";
+                direction?: "horizontal" | "vertical";
                 /**
                  * The the radio box or check box's column count.
                  */
-                maxColumnCount: number;
+                maxColumnCount?: number;
                 /**
                  * The the radio box or check box's row count.
                  */
-                maxRowCount: number;
+                maxRowCount?: number;
                 /**
                  * The the radio box or check box's layout is auto fit.
                  */
-                isFlowLayout: boolean;
+                isFlowLayout?: boolean;
                 /**
                  * The space for two items.
                  */
-                itemSpacing: { horizontal: number; vertical: number };
+                itemSpacing?: { horizontal: number; vertical: number };
                 /**
                  * The text alignment relative to the radio box or check box, which supports "left", "right".
                  */
-                textAlign: "left" | "right";
+                textAlign?: "left" | "right";
                 /**
                  * The radio box or check box size.
                  */
-                boxSize: number;
+                boxSize?: number;
             }
         
 
@@ -2726,7 +2804,7 @@ declare module GC{
          * @property {boolean} wordWrap - Whether words wrap within the cell or cells.
          * @property {boolean} shrinkToFit - Whether content shrinks to fit the cell or cells.
          * @property {string} backgroundImage - The background image to display.
-         * @property {GC.Data.CheckboxOptions | GC.Data.ComboBoxOptions | GC.Data.HyperlinkOptions | GC.Data.FileUploadOptions | GC.Data.RadioButtonCheckboxListOptions} cellType - The cell type.
+         * @property {GC.Data.CheckboxOptions | GC.Data.ComboBoxOptions | GC.Data.HyperlinkOptions | GC.Data.FileUploadOptions | GC.Data.RadioButtonCheckboxListOptions | GC.Data.ButtonListOptions | GC.Data.CustomCellTypeOptions} cellType - The cell type.
          * @property {string} backgroundImageLayout - The layout for the background image, which supports "stretch", "center", "zoom", "none".
          * @property {boolean} tabStop - Whether the user can set focus to the cell using the Tab key.
          * @property {GC.Data.TextDecoration} textDecoration - The decoration added to text.
@@ -2821,7 +2899,7 @@ declare module GC{
                 /**
                  * The cell type.
                  */
-                cellType?: GC.Data.CheckboxOptions | GC.Data.ComboBoxOptions | GC.Data.HyperlinkOptions | GC.Data.FileUploadOptions | GC.Data.RadioButtonCheckboxListOptions;
+                cellType?: GC.Data.CheckboxOptions | GC.Data.ComboBoxOptions | GC.Data.HyperlinkOptions | GC.Data.FileUploadOptions | GC.Data.RadioButtonCheckboxListOptions | GC.Data.ButtonListOptions | GC.Data.CustomCellTypeOptions;
                 /**
                  * The layout for the background image, which supports "stretch", "center", "zoom", "none".
                  */
@@ -7184,11 +7262,11 @@ declare module GC{
                  * @param {GC.Spread.Pivot.PivotTable} pivotTable  Indicates the pivot table which is attached.
                  * @returns void
                  */
-                attach(pivotTable: GC.Spread.Pivot.PivotTable): any;
+                attach(pivotTable: GC.Spread.Pivot.PivotTable): void;
                 /**
                  * @description destroy the PivotPanel.
                  */
-                destroy(): any;
+                destroy(): void;
                 /**
                  * @description detach the pivot table for pivot panel, stop the pivot panel control bound pivot table.
                  * @returns void
@@ -20052,13 +20130,11 @@ declare module GC{
                  * @param eventParam *{@link GC.Spread.Sheets.Collaboration.IPermission}* `permission` The sheet that triggered the event.
                  * @example
                  * ```javascript
-                 * ```javascript
                  * //This example uses the ThreadedCommentChanged event.
                  * spread.bind(GC.Spread.Sheets.Events.PermissionChanged, function (e, info) {
                  *     console.log(info.permission);
                  * });
                  * ```
-                 * ```
                  */
                 static PermissionChanged: string;
                 /**
@@ -21319,13 +21395,11 @@ declare module GC{
                  * @param eventParam *string[]* `userIds` The user ids that were mentioned.
                  * @example
                  * ```javascript
-                 * ```javascript
                  * //This example uses the ThreadedCommentChanged event.
                  * sheet.bind(GC.Spread.Sheets.Events.UserMentioned, function (e, info) {
                  *     console.log(info.userId);
                  * });
                  * ```
-                 * ```
                  */
                 static UserMentioned: string;
                 /**
@@ -21670,7 +21744,7 @@ declare module GC{
                  * sheet.pivotTables.remove("pivotTable_1");
                  * ```
                  */
-                remove(name: string): any;
+                remove(name: string): void;
             }
 
             export class Point{
@@ -23005,7 +23079,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Apex: ColorScheme;
+                static Apex: ColorScheme;
                 /**
                  * The theme color of the Aspect theme.
                  * @example
@@ -23016,7 +23090,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Aspect: ColorScheme;
+                static Aspect: ColorScheme;
                 /**
                  * The theme color of the Civic theme.
                  * @example
@@ -23027,7 +23101,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Civic: ColorScheme;
+                static Civic: ColorScheme;
                 /**
                  * The theme color of the Concourse theme.
                  * @example
@@ -23038,7 +23112,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Concourse: ColorScheme;
+                static Concourse: ColorScheme;
                 /**
                  * The theme color of the Default theme.
                  * @example
@@ -23049,7 +23123,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Default: ColorScheme;
+                static Default: ColorScheme;
                 /**
                  * The theme color of the Equity theme.
                  * @example
@@ -23060,7 +23134,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Equity: ColorScheme;
+                static Equity: ColorScheme;
                 /**
                  * The theme color of the Flow theme.
                  * @example
@@ -23071,7 +23145,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Flow: ColorScheme;
+                static Flow: ColorScheme;
                 /**
                  * The theme color of the Foundry theme.
                  * @example
@@ -23082,7 +23156,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Foundry: ColorScheme;
+                static Foundry: ColorScheme;
                 /**
                  * The theme color of the Median theme.
                  * @example
@@ -23093,7 +23167,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Median: ColorScheme;
+                static Median: ColorScheme;
                 /**
                  * The theme color of the Metro theme.
                  * @example
@@ -23104,7 +23178,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Metro: ColorScheme;
+                static Metro: ColorScheme;
                 /**
                  * The theme color of the Module theme.
                  * @example
@@ -23115,7 +23189,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Module: ColorScheme;
+                static Module: ColorScheme;
                 /**
                  * The theme color of the Office theme.
                  * @example
@@ -23126,7 +23200,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Office: ColorScheme;
+                static Office: ColorScheme;
                 /**
                  * The theme color of the Office 2007 theme.
                  * @example
@@ -23137,7 +23211,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Office2007: ColorScheme;
+                static Office2007: ColorScheme;
                 /**
                  * The theme color of the Opulent theme.
                  * @example
@@ -23148,7 +23222,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Opulent: ColorScheme;
+                static Opulent: ColorScheme;
                 /**
                  * The theme color of the Oriel theme.
                  * @example
@@ -23159,7 +23233,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Oriel: ColorScheme;
+                static Oriel: ColorScheme;
                 /**
                  * The theme color of the Origin theme.
                  * @example
@@ -23170,7 +23244,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Origin: ColorScheme;
+                static Origin: ColorScheme;
                 /**
                  * The theme color of the Paper theme.
                  * @example
@@ -23181,7 +23255,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Paper: ColorScheme;
+                static Paper: ColorScheme;
                 /**
                  * The theme color of the Solstice theme.
                  * @example
@@ -23192,7 +23266,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Solstice: ColorScheme;
+                static Solstice: ColorScheme;
                 /**
                  * The theme color of the Technic theme.
                  * @example
@@ -23203,7 +23277,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Technic: ColorScheme;
+                static Technic: ColorScheme;
                 /**
                  * The theme color of the Trek theme.
                  * @example
@@ -23214,7 +23288,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Trek: ColorScheme;
+                static Trek: ColorScheme;
                 /**
                  * The theme color of the Urban theme.
                  * @example
@@ -23225,7 +23299,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Urban: ColorScheme;
+                static Urban: ColorScheme;
                 /**
                  * The theme color of the Verve theme.
                  * @example
@@ -23236,7 +23310,7 @@ declare module GC{
                  * activeSheet.repaint();
                  * ```
                  */
-                Verve: ColorScheme;
+                static Verve: ColorScheme;
             }
 
             export class ThemeFont{
@@ -23359,87 +23433,87 @@ declare module GC{
                 /**
                  * The theme font named BookmanGillSansMT.
                  */
-                BookmanGillSansMT: GC.Spread.Sheets.ThemeFont;
+                static BookmanGillSansMT: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named CalibriConstantia.
                  */
-                CalibriConstantia: GC.Spread.Sheets.ThemeFont;
+                static CalibriConstantia: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named CenturyGothic.
                  */
-                CenturyGothic: GC.Spread.Sheets.ThemeFont;
+                static CenturyGothic: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named CenturySchoolbook.
                  */
-                CenturySchoolbook: GC.Spread.Sheets.ThemeFont;
+                static CenturySchoolbook: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named ConsolasCorbel.
                  */
-                ConsolasCorbel: GC.Spread.Sheets.ThemeFont;
+                static ConsolasCorbel: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named Constantia.
                  */
-                Constantia: GC.Spread.Sheets.ThemeFont;
+                static Constantia: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named Corbel.
                  */
-                Corbel: GC.Spread.Sheets.ThemeFont;
+                static Corbel: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named FranklinGothic.
                  */
-                FranklinGothic: GC.Spread.Sheets.ThemeFont;
+                static FranklinGothic: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named FranklinGothicArial.
                  */
-                FranklinGothicArial: GC.Spread.Sheets.ThemeFont;
+                static FranklinGothicArial: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named FranklinGothicPerpetua.
                  */
-                FranklinGothicPerpetua: GC.Spread.Sheets.ThemeFont;
+                static FranklinGothicPerpetua: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named Georgia.
                  */
-                Georgia: GC.Spread.Sheets.ThemeFont;
+                static Georgia: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named GillSansMT.
                  */
-                GillSansMT: GC.Spread.Sheets.ThemeFont;
+                static GillSansMT: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named LucidaBook.
                  */
-                LucidaBook: GC.Spread.Sheets.ThemeFont;
+                static LucidaBook: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named LucidaSansUnicode.
                  */
-                LucidaSansUnicode: GC.Spread.Sheets.ThemeFont;
+                static LucidaSansUnicode: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named Office.
                  */
-                Office: GC.Spread.Sheets.ThemeFont;
+                static Office: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named Office2007.
                  */
-                Office2007: GC.Spread.Sheets.ThemeFont;
+                static Office2007: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named Rockwell.
                  */
-                Rockwell: GC.Spread.Sheets.ThemeFont;
+                static Rockwell: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named TrebuchetGeorgia.
                  */
-                TrebuchetGeorgia: GC.Spread.Sheets.ThemeFont;
+                static TrebuchetGeorgia: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named TrebuchetMS.
                  */
-                TrebuchetMS: GC.Spread.Sheets.ThemeFont;
+                static TrebuchetMS: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named TwCenMT.
                  */
-                TwCenMT: GC.Spread.Sheets.ThemeFont;
+                static TwCenMT: GC.Spread.Sheets.ThemeFont;
                 /**
                  * The theme font named Verdana.
                  */
-                Verdana: GC.Spread.Sheets.ThemeFont;
+                static Verdana: GC.Spread.Sheets.ThemeFont;
             }
 
             export class Themes{
@@ -23451,91 +23525,91 @@ declare module GC{
                 /**
                  * Indicates the Apex theme.
                  */
-                Apex: Theme;
+                static Apex: Theme;
                 /**
                  * Indicates the Aspect theme.
                  */
-                Aspect: Theme;
+                static Aspect: Theme;
                 /**
                  * Indicates the Civic theme.
                  */
-                Civic: Theme;
+                static Civic: Theme;
                 /**
                  * Indicates the Concourse theme.
                  */
-                Concourse: Theme;
+                static Concourse: Theme;
                 /**
                  * Indicates the Default theme.
                  */
-                Default: Theme;
+                static Default: Theme;
                 /**
                  * Indicates the Equity theme.
                  */
-                Equity: Theme;
+                static Equity: Theme;
                 /**
                  * Indicates the Flow theme.
                  */
-                Flow: Theme;
+                static Flow: Theme;
                 /**
                  * Indicates the Foundry theme.
                  */
-                Foundry: Theme;
+                static Foundry: Theme;
                 /**
                  * Indicates the Median theme.
                  */
-                Median: Theme;
+                static Median: Theme;
                 /**
                  * Indicates the Metro theme.
                  */
-                Metro: Theme;
+                static Metro: Theme;
                 /**
                  * Indicates the Module theme.
                  */
-                Module: Theme;
+                static Module: Theme;
                 /**
                  * Indicates the Office theme.
                  */
-                Office: Theme;
+                static Office: Theme;
                 /**
                  * Indicates the Office 2007 theme.
                  */
-                Office2007: Theme;
+                static Office2007: Theme;
                 /**
                  * Indicates the Opulent theme.
                  */
-                Opulent: Theme;
+                static Opulent: Theme;
                 /**
                  * Indicates the Oriel theme.
                  */
-                Oriel: Theme;
+                static Oriel: Theme;
                 /**
                  * Indicates the Origin theme.
                  */
-                Origin: Theme;
+                static Origin: Theme;
                 /**
                  * Indicates the Paper theme.
                  */
-                Paper: Theme;
+                static Paper: Theme;
                 /**
                  * Indicates the Solstice theme.
                  */
-                Solstice: Theme;
+                static Solstice: Theme;
                 /**
                  * Indicates the Technic theme.
                  */
-                Technic: Theme;
+                static Technic: Theme;
                 /**
                  * Indicates the Trek theme.
                  */
-                Trek: Theme;
+                static Trek: Theme;
                 /**
                  * Indicates the Urban theme.
                  */
-                Urban: Theme;
+                static Urban: Theme;
                 /**
                  * Indicates the Verve theme.
                  */
-                Verve: Theme;
+                static Verve: Theme;
             }
 
             export class Workbook{
@@ -24797,13 +24871,13 @@ declare module GC{
                  * ```javascript
                  * // This example sets the external source with workbook JSON.
                  * spread.getActiveSheet().setFormula(0, 0, "[calc.xlsx]Sheet1!A1");  // spread cell A1 value is #REF!
-                 * spread2.getActiveSheet().setFormula(0, 0, "=123+1"); \xa0// spread2 cell A1 value is 124
+                 * spread2.getActiveSheet().setFormula(0, 0, "=123+1");  // spread2 cell A1 value is 124
                  * spread.updateExternalReference("calc.xlsx", spread2.toJSON());  // spread cell A1 value is 124
                  * // Set the data with simple JSON data:
-                 * spread.getActiveSheet().setFormula(0, 0, "=SUM([calc.xlsx]Sheet1!A1:B2"); \xa0// spread cell A1 value is #REF!
-                 * spread.updateExternalReference("calc.xlsx", {"Sheet1":[[1, 2],[1, 3]]}); \xa0// spread cell A1 value is 7
-                 * spread.updateExternalReference("calc.xlsx", {"Sheet1":{0:{0:10, 1:10}, 1:{0:10, 1:10}}}); \xa0// spread cell A1 value is 40
-                 * spread.updateExternalReference("calc.xlsx", {"Sheet1":{1:{0:2, 1:2}}}, null, true); \xa0// spread cell A1 value is 24 after the merge update.
+                 * spread.getActiveSheet().setFormula(0, 0, "=SUM([calc.xlsx]Sheet1!A1:B2");  // spread cell A1 value is #REF!
+                 * spread.updateExternalReference("calc.xlsx", {"Sheet1":[[1, 2],[1, 3]]});  // spread cell A1 value is 7
+                 * spread.updateExternalReference("calc.xlsx", {"Sheet1":{0:{0:10, 1:10}, 1:{0:10, 1:10}}});  // spread cell A1 value is 40
+                 * spread.updateExternalReference("calc.xlsx", {"Sheet1":{1:{0:2, 1:2}}}, null, true);  // spread cell A1 value is 24 after the merge update.
                  * // This example sets the external values with the successCallback result of GC.Spread.Sheets.IO.getPartialValues
                  * let refList = spread.getExternalReferences(true);
                  * GC.Spread.Sheets.IO.getPartialValues(refList, getFile, (externalValues) => {
@@ -27816,18 +27890,25 @@ declare module GC{
             module AI{
 
                 /**
-                 * @param {IAIConfig} config
-                 * @returns {Promise<any>}
+                 * Callback function type for sending an AI request.
+                 * @typedef {Function} AIRequestCallback
+                 * @param {IAIConfig} config - Request parameters to forward to the AI provider.
+                 * @returns {Promise<any>} Promise that resolves with the provider response.
                  */
                 export type AIRequestCallback = 
                     (config: IAIConfig) => Promise<any>
                 
 
                 /**
-                 * @property {{ role: string; content: string }[]} [messages]
-                 * @property {number} [temperature]
-                 * @property {number} [max_tokens]
-                 * @property {boolean} [stream]
+                 * Simplified request body passed to the AI provider.
+                 * This shape is compatible with the OpenAI Chat Completions API request body used by this plugin,
+                 * while allowing additional OpenAI-compatible fields to pass through as custom properties.
+                 * @typedef {Object} IAIConfig
+                 * @property {{ role: string; content: string }[]} [messages] - Array of message objects containing role and content pairs for conversation history
+                 * @property {number} [temperature] - Sampling temperature for the generated response. Higher values make output more random.
+                 * @property {number} [max_tokens] - Legacy maximum output token limit.
+                 * @property {boolean} [stream] - Whether to return the response as a server-sent event stream (SSE).
+                 * @property {any} [key: string] - Additional provider-specific or OpenAI-compatible request properties, such as `model` or `max_completion_tokens`.
                  */
                 export type IAIConfig = 
                     {
@@ -27840,14 +27921,25 @@ declare module GC{
                 
 
                 /**
-                 * @property {string} model
-                 * @property {string} key
-                 * @property {string} basePath
+                 * Environment configuration for the AI service endpoint.
+                 * @typedef {Object} IAIEnvironment
+                 * @property {string} model - Model identifier added to the outbound request body, for example an OpenAI chat model name.
+                 * @property {string} key - API key used in the `Authorization: Bearer` request header.
+                 * @property {string} basePath - HTTP endpoint that receives the JSON request body, for example a server route or OpenAI-compatible API URL.
                  */
                 export type IAIEnvironment = 
                     {
+                        /**
+                         * Model identifier added to the outbound request body, for example an OpenAI chat model name.
+                         */
                         model: string;
+                        /**
+                         * API key used in the `Authorization: Bearer` request header.
+                         */
                         key: string;
+                        /**
+                         * HTTP endpoint that receives the JSON request body, for example a server route or OpenAI-compatible API URL.
+                         */
                         basePath: string;
                     }
                 
@@ -39711,7 +39803,7 @@ declare module GC{
                      */
                     type?:string;
                     /**
-                     * Represents on which area this context menu item should be shown. Value can be a collection of conditions separated by whitespace. Include: "outline", "rowHeader", "colHeader", "corner", "slicer", "chart", "shape", "table", "vpWithoutTb", "pivotPageFilter", "pivotTopLeft", "pivotEmptyLabel", "pivotHeader", "pivotGrandTotal", "pivotContent", "pivotTable", "sheetTab", "timeline".
+                     * Represents on which area this context menu item should be shown. Value can be a collection of conditions separated by whitespace. Include: "viewport", "rowHeader", "colHeader", "corner", "sheetTab", "outline", "slicer", "timeline", "chart", "shape", "table", "vpWithoutTb", "pivotPageFilter", "pivotTopLeft", "pivotEmptyLabel", "pivotHeader", "pivotGrandTotal", "pivotContent", "pivotTable", "GanttRowHeader", "GanttField", "GanttColumn".
                      */
                     workArea?:string;
                     /**
@@ -39770,7 +39862,7 @@ declare module GC{
                      * @property {string} [group] - Represent this context menu item is a group menu item and this property's value should be it's group header's name.
                      * @property {Object[]} [subMenu] - Represent this context menu item has sub menu.
                      * @property {string} [type] - Represent a context menu's type.
-                     * @property {string} [workArea] - Represent this context menu item's should be shown on what area,value can be a collection of conditions,separate by whitespace. include: "outline","rowHeader","colHeader","corner","slicer","chart","shape","table","vpWithoutTb","pivotPageFilter","pivotTopLeft","pivotEmptyLabel","pivotHeader","pivotGrandTotal","pivotContent","pivotTable".
+                     * @property {string} [workArea] - Represent this context menu item's should be shown on what area,value can be a collection of conditions,separate by whitespace. include: "viewport","rowHeader","colHeader","corner","sheetTab","outline","slicer","timeline","chart","shape","table","vpWithoutTb","pivotPageFilter","pivotTopLeft","pivotEmptyLabel","pivotHeader","pivotGrandTotal","pivotContent","pivotTable","GanttRowHeader","GanttField","GanttColumn".
                      */
                     menuData: GC.Spread.Sheets.ContextMenu.IMenuItemData[];
                     /**
@@ -39874,7 +39966,7 @@ declare module GC{
                      * @param {string} [menuData.group] - Represent this context menu item is a group menu item and this param's value should be it's group header's name.
                      * @param {Object[]} [menuData.subMenu] - Represent this context menu item has sub menu.
                      * @param {string} [menuData.type] - Represent a context menu's type.
-                     * @param {string} [menuData.workArea] - Represent this context menu item's should be shown on what area,value can be a collection of conditions,separate by whitespace. include: "outline","rowHeader","colHeader","corner","slicer","chart","shape","table","vpWithoutTb","pivotPageFilter","pivotTopLeft","pivotEmptyLabel","pivotHeader","pivotGrandTotal","pivotContent","pivotTable".
+                     * @param {string} [menuData.workArea] - Represent this context menu item's should be shown on what area,value can be a collection of conditions,separate by whitespace. include: "viewport","rowHeader","colHeader","corner","sheetTab","outline","slicer","timeline","chart","shape","table","vpWithoutTb","pivotPageFilter","pivotTopLeft","pivotEmptyLabel","pivotHeader","pivotGrandTotal","pivotContent","pivotTable","GanttRowHeader","GanttField","GanttColumn".
                      * @param {Object[]} itemsDataForShown
                      * @param {string} [itemsDataForShown.name] - Represent context menu item's identify.
                      * @param {string} [itemsDataForShown.text] - Represent the text to be shown,if this context menu item is a group,text will be shown as DOM element's title.
@@ -39884,7 +39976,7 @@ declare module GC{
                      * @param {string} [itemsDataForShown.group] - Represent this context menu item is a group menu item and this param's value should be it's group header's name.
                      * @param {Object[]} [itemsDataForShown.subMenu] - Represent this context menu item has sub menu.
                      * @param {string} [itemsDataForShown.type] - Represent a context menu's type.
-                     * @param {string} [itemsDataForShown.workArea] - Represent this context menu item's should be shown on what area,value can be a collection of conditions,separate by whitespace. include: "outline","rowHeader","colHeader","corner","slicer","chart","shape","table","vpWithoutTb","pivotPageFilter","pivotTopLeft","pivotEmptyLabel","pivotHeader","pivotGrandTotal","pivotContent","pivotTable".
+                     * @param {string} [itemsDataForShown.workArea] - Represent this context menu item's should be shown on what area,value can be a collection of conditions,separate by whitespace. include: "viewport","rowHeader","colHeader","corner","sheetTab","outline","slicer","timeline","chart","shape","table","vpWithoutTb","pivotPageFilter","pivotTopLeft","pivotEmptyLabel","pivotHeader","pivotGrandTotal","pivotContent","pivotTable","GanttRowHeader","GanttField","GanttColumn".
                      * @param {Object} hitInfo
                      * @param {Object} spread
                      * @return {boolean} indicate whether or not the contextmenu event has been processed done
@@ -44115,7 +44207,7 @@ declare module GC{
                      * @param {GC.Spread.Sheets.Workbook} workbook Indicates the workbook which is attached.
                      * @returns void
                      */
-                    attach(workbook: GC.Spread.Sheets.Workbook): any;
+                    attach(workbook: GC.Spread.Sheets.Workbook): void;
                     /**
                      * Gets the command manager.
                      * @returns {GC.Spread.Commands.CommandManager} The command manager.
@@ -61131,47 +61223,47 @@ declare module GC{
                     /**
                      * Whether promoting menu item to show
                      */
-                    promoteMenuItemVisible: false,
+                    promoteMenuItemVisible?: boolean,
                     /**
                      * Whether demoting menu item to show
                      */
-                    demoteMenuItemVisible: false,
+                    demoteMenuItemVisible?: boolean,
                     /**
                      * Whether moving up menu item to show
                      */
-                    moveUpMenuItemVisible: false,
+                    moveUpMenuItemVisible?: boolean,
                     /**
                      * Whether moving down menu item to show
                      */
-                    moveDownMenuItemVisible: false,
+                    moveDownMenuItemVisible?: boolean,
                     /**
                      * Whether adding before menu item to show
                      */
-                    addBeforeMenuItemVisible: false,
+                    addBeforeMenuItemVisible?: boolean,
                     /**
                      * Whether adding after menu item to show
                      */
-                    addAfterMenuItemVisible: false,
+                    addAfterMenuItemVisible?: boolean,
                     /**
                      * Whether adding above menu item to show
                      */
-                    addAboveMenuItemVisible: false,
+                    addAboveMenuItemVisible?: boolean,
                     /**
                      * Whether adding below menu item to show
                      */
-                    addBelowMenuItemVisible: false,
+                    addBelowMenuItemVisible?: boolean,
                     /**
                      * Whether expanding all level menu item to show
                      */
-                    expandAllLevelMenuItemVisible: false,
+                    expandAllLevelMenuItemVisible?: boolean,
                     /**
                      * Whether collapsing all level menu item to show
                      */
-                    collapseAllLevelMenuItemVisible: false,
+                    collapseAllLevelMenuItemVisible?: boolean,
                     /**
                      * Whether expanding to level menu item to show
                      */
-                    expandToLevelMenuItemVisible: false,
+                    expandToLevelMenuItemVisible?: boolean,
                 }
 
 
@@ -62290,11 +62382,11 @@ declare module GC{
                      * @param {GC.Spread.Sheets.Workbook} workbook Indicates the workbook which is attached.
                      * @returns void
                      */
-                    attach(workbook: GC.Spread.Sheets.Workbook): any;
+                    attach(workbook: GC.Spread.Sheets.Workbook): void;
                     /**
                      * @description destroy the PivotPanel.
                      */
-                    destroy(): any;
+                    destroy(): void;
                     /**
                      * @description detach the workbook for threaded comment panel.
                      * @returns void