apex-grid 2.0.0 → 3.0.1

package/custom-elements.json

@@ -224,25 +224,25 @@
         },
         {
           "kind": "js",
-          "name": "ExportOptions",
+          "name": "ExportFormat",
           "declaration": {
-            "name": "ExportOptions",
+            "name": "ExportFormat",
             "module": "./internal/export.js"
           }
         },
         {
           "kind": "js",
-          "name": "ExportSource",
+          "name": "ExportOptions",
           "declaration": {
-            "name": "ExportSource",
+            "name": "ExportOptions",
             "module": "./internal/export.js"
           }
         },
         {
           "kind": "js",
-          "name": "XLSXExportOptions",
+          "name": "ExportSource",
           "declaration": {
-            "name": "XLSXExportOptions",
+            "name": "ExportSource",
             "module": "./internal/export.js"
           }
         },
@@ -645,7 +645,7 @@
               }
             }
           ],
-          "description": "One-call convenience: registers `<apex-grid>`, configures the Ignite UI\ntheme, and adopts a default host stylesheet so the virtualizer has a\nbounded height."
+          "description": "One-call convenience: registers `<apex-grid>` and adopts a default host\nstylesheet so the virtualizer has a bounded height. The grid is styled\nout-of-the-box via `--ag-*` CSS custom properties — no theme import needed."
         }
       ],
       "exports": [
@@ -1306,10 +1306,89 @@
           "kind": "class",
           "description": "Apex grid is a web component for displaying data in a tabular format quick and easy.\n\nOut of the box it provides row virtualization, sort and filter operations (client and server side),\nthe ability to template cells and headers and column hiding.",
           "name": "ApexGrid",
+          "cssProperties": [
+            {
+              "description": "Brand color for selection, focus rings, and accents. Auto-tints from `--ig-primary-500` when igniteui is present.",
+              "name": "--ag-brand"
+            },
+            {
+              "description": "Brand color for hover / pressed states.",
+              "name": "--ag-brand-strong"
+            },
+            {
+              "description": "Grid edge/shadow override. Default is a flat 1px hairline edge; set to `var(--ag-shadow-card)` for the elevated card look, or `none` to remove it.",
+              "name": "--ag-grid-shadow"
+            },
+            {
+              "description": "Grid card background (must be opaque).",
+              "name": "--ag-surface"
+            },
+            {
+              "description": "Alternating row tint.",
+              "name": "--ag-surface-alt"
+            },
+            {
+              "description": "Header background.",
+              "name": "--ag-surface-elevated"
+            },
+            {
+              "description": "Header / structural gridline color.",
+              "name": "--ag-hairline"
+            },
+            {
+              "description": "Row separator color.",
+              "name": "--ag-border"
+            },
+            {
+              "description": "Primary text color.",
+              "name": "--ag-text"
+            },
+            {
+              "description": "Row text color.",
+              "name": "--ag-text-body"
+            },
+            {
+              "description": "Muted text (roles, labels).",
+              "name": "--ag-text-muted"
+            },
+            {
+              "description": "Row hover wash.",
+              "name": "--ag-row-hover"
+            },
+            {
+              "description": "Row height.",
+              "name": "--ag-row-h"
+            },
+            {
+              "description": "Header height.",
+              "name": "--ag-header-h"
+            },
+            {
+              "description": "Outer card corner radius.",
+              "name": "--ag-radius"
+            },
+            {
+              "description": "Grid font family.",
+              "name": "--ag-font"
+            },
+            {
+              "description": "Cell font size.",
+              "name": "--ag-fs-cell"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "Visually-hidden ARIA live region used for screen-reader announcements.",
+              "name": "live-region"
+            }
+          ],
           "members": [
             {
               "kind": "field",
               "name": "tagName",
+              "type": {
+                "text": "string"
+              },
               "privacy": "public",
               "static": true,
               "readonly": true
@@ -1324,8 +1403,7 @@
             {
               "kind": "field",
               "name": "stateController",
-              "privacy": "protected",
-              "default": "new StateController<T>(this)"
+              "privacy": "protected"
             },
             {
               "kind": "field",
@@ -1339,6 +1417,17 @@
               "privacy": "protected",
               "default": "new DataOperationsController<T>(this)"
             },
+            {
+              "kind": "method",
+              "name": "createStateController",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "StateController<T>"
+                }
+              },
+              "description": "Builds the grid's StateController. This is the single construction\nsite for `stateController` — overriding it (rather than re-declaring the\nfield) is the supported seam for derived grids to inject optional\nGridFeatureModules while preserving field-initializer ordering.\nThe community grid registers no extra modules."
+            },
             {
               "kind": "field",
               "name": "stateProvider",
@@ -2306,25 +2395,41 @@
               ],
               "description": "Exports the current grid contents as a CSV string and (in a browser\ncontext) triggers a download."
             },
+            {
+              "kind": "field",
+              "name": "exportFormats",
+              "type": {
+                "text": "ReadonlyArray<ExportFormat>"
+              },
+              "privacy": "public",
+              "description": "The export formats offered in the toolbar's export menu, in order.",
+              "readonly": true
+            },
             {
               "kind": "method",
-              "name": "exportToXLSX",
+              "name": "exportAs",
               "privacy": "public",
               "return": {
                 "type": {
-                  "text": "Uint8Array"
+                  "text": "void"
                 }
               },
               "parameters": [
+                {
+                  "name": "formatId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
                 {
                   "name": "options",
                   "default": "{}",
                   "type": {
-                    "text": "XLSXExportOptions<T>"
+                    "text": "ExportOptions<T>"
                   }
                 }
               ],
-              "description": "Exports the current grid contents as an `.xlsx` workbook and (in a browser\ncontext) triggers a download."
+              "description": "Exports the grid in the given format (one of ApexGrid.exportFormats).\nCalled by the toolbar's export menu. The community grid handles `'csv'`;\nderived grids override to handle additional formats, delegating to `super`\nfor the ones they don't add."
             },
             {
               "kind": "method",
@@ -2610,6 +2715,22 @@
               "description": "Emitted after a selection-set change has been applied.",
               "name": "rowSelected"
             },
+            {
+              "description": "Cancellable. Emitted before the row-expansion set changes (master-detail).",
+              "name": "rowExpanding"
+            },
+            {
+              "description": "Emitted after a row-expansion change has been applied.",
+              "name": "rowExpanded"
+            },
+            {
+              "description": "Cancellable. Emitted before a tree-row expansion change (tree mode).",
+              "name": "treeRowExpanding"
+            },
+            {
+              "description": "Emitted after a tree-row expansion change has been applied.",
+              "name": "treeRowExpanded"
+            },
             {
               "type": {
                 "text": "CustomEvent"
@@ -6247,6 +6368,14 @@
               },
               "privacy": "public"
             },
+            {
+              "kind": "field",
+              "name": "modules",
+              "privacy": "public",
+              "readonly": true,
+              "default": "new Map<string, ReactiveController>()",
+              "description": "Optional feature controllers contributed by GridFeatureModules,\nkeyed by module id. Empty for the community `<apex-grid>` element; populated\nby derived grids (e.g. `@apexcharts/grid-enterprise`) that pass modules to\nthe constructor."
+            },
             {
               "kind": "field",
               "name": "announcement",
@@ -6329,6 +6458,25 @@
               "name": "init",
               "privacy": "protected"
             },
+            {
+              "kind": "method",
+              "name": "module",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "C | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Look up a feature controller contributed by a GridFeatureModule,\nby its module id. Returns `undefined` when no such module is registered."
+            },
             {
               "kind": "method",
               "name": "hostConnected",
@@ -7307,6 +7455,12 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/internal/feature-module.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/internal/flip.ts",
@@ -7457,6 +7611,16 @@
             }
           ],
           "description": "Renders one of the grid's built-in icons as an inline `<svg>`. All icons are\ndecorative (`aria-hidden=\"true\"`) by default — surrounding controls supply\nthe accessible label via `aria-label`."
+        },
+        {
+          "kind": "function",
+          "name": "renderSortArrows",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "description": "Renders the stacked up/down sort affordance used by sortable column headers.\nBoth chevrons are dimmed by default; the header CSS lifts the inactive one on\nhover and paints the active direction in the brand color, driven by the\nbutton's `data-sort-active` (`'ascending' | 'descending' | 'none'`) attribute."
         }
       ],
       "exports": [
@@ -7467,6 +7631,149 @@
             "name": "renderIcon",
             "module": "src/internal/icons.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "renderSortArrows",
+          "declaration": {
+            "name": "renderSortArrows",
+            "module": "src/internal/icons.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/internal/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ApexGrid",
+          "declaration": {
+            "name": "ApexGrid",
+            "module": "../components/grid.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "gridStateContext",
+          "declaration": {
+            "name": "gridStateContext",
+            "module": "../controllers/state.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "StateController",
+          "declaration": {
+            "name": "StateController",
+            "module": "../controllers/state.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PIPELINE",
+          "declaration": {
+            "name": "PIPELINE",
+            "module": "./constants.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ExportCellValue",
+          "declaration": {
+            "name": "ExportCellValue",
+            "module": "./export.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ExportFormat",
+          "declaration": {
+            "name": "ExportFormat",
+            "module": "./export.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ExportOptions",
+          "declaration": {
+            "name": "ExportOptions",
+            "module": "./export.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "downloadBlob",
+          "declaration": {
+            "name": "downloadBlob",
+            "module": "./export.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getColumnLabel",
+          "declaration": {
+            "name": "getColumnLabel",
+            "module": "./export.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "resolveExportColumns",
+          "declaration": {
+            "name": "resolveExportColumns",
+            "module": "./export.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "resolveExportRows",
+          "declaration": {
+            "name": "resolveExportRows",
+            "module": "./export.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "resolveExportValue",
+          "declaration": {
+            "name": "resolveExportValue",
+            "module": "./export.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GridFeatureModule",
+          "declaration": {
+            "name": "GridFeatureModule",
+            "module": "./feature-module.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "registerComponent",
+          "declaration": {
+            "name": "registerComponent",
+            "module": "./register.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ActiveNode",
+          "declaration": {
+            "name": "ActiveNode",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GridHost",
+          "declaration": {
+            "name": "GridHost",
+            "module": "./types.js"
+          }
         }
       ]
     },
@@ -7764,149 +8071,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/internal/theming.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "ThemingController",
-          "members": [
-            {
-              "kind": "field",
-              "name": "_host",
-              "type": {
-                "text": "ReactiveControllerHost & ReactiveElement"
-              },
-              "privacy": "private",
-              "readonly": true,
-              "default": "host"
-            },
-            {
-              "kind": "field",
-              "name": "_themes",
-              "type": {
-                "text": "Themes"
-              },
-              "privacy": "private",
-              "readonly": true,
-              "default": "themes"
-            },
-            {
-              "kind": "field",
-              "name": "_options",
-              "type": {
-                "text": "ThemingControllerConfig | undefined"
-              },
-              "privacy": "private",
-              "readonly": true,
-              "default": "config"
-            },
-            {
-              "kind": "field",
-              "name": "_theme",
-              "type": {
-                "text": "Theme"
-              },
-              "privacy": "private",
-              "default": "'bootstrap'"
-            },
-            {
-              "kind": "field",
-              "name": "_variant",
-              "type": {
-                "text": "ThemeVariant"
-              },
-              "privacy": "private",
-              "default": "'light'"
-            },
-            {
-              "kind": "field",
-              "name": "theme",
-              "type": {
-                "text": "Theme"
-              },
-              "privacy": "public",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "_getStyles",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_adoptStyles",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "_handleThemeChanged",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            }
-          ]
-        },
-        {
-          "kind": "function",
-          "name": "addThemingController",
-          "return": {
-            "type": {
-              "text": "ThemingController"
-            }
-          },
-          "parameters": [
-            {
-              "name": "host",
-              "type": {
-                "text": "ReactiveControllerHost & ReactiveElement"
-              }
-            },
-            {
-              "name": "themes",
-              "type": {
-                "text": "Themes"
-              }
-            },
-            {
-              "name": "config",
-              "optional": true,
-              "type": {
-                "text": "ThemingControllerConfig"
-              }
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "addThemingController",
-          "declaration": {
-            "name": "addThemingController",
-            "module": "src/internal/theming.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ThemingController",
-          "declaration": {
-            "name": "ThemingController",
-            "module": "src/internal/theming.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/internal/types.ts",
@@ -8140,92 +8304,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/internal/xlsx.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "columnLetter",
-          "return": {
-            "type": {
-              "text": "string"
-            }
-          },
-          "parameters": [
-            {
-              "name": "index",
-              "type": {
-                "text": "number"
-              }
-            }
-          ],
-          "description": "Excel column letter for zero-based column index (0 → A, 26 → AA)."
-        },
-        {
-          "kind": "function",
-          "name": "toExcelSerial",
-          "return": {
-            "type": {
-              "text": "number"
-            }
-          },
-          "parameters": [
-            {
-              "name": "date",
-              "type": {
-                "text": "Date"
-              }
-            }
-          ],
-          "description": "Converts a `Date` to the Excel serial date number (days since the 1899-12-30\nepoch, with the day rolling over at the user's local midnight). Time of day\nis preserved as the fractional part."
-        },
-        {
-          "kind": "function",
-          "name": "buildXLSX",
-          "return": {
-            "type": {
-              "text": "Uint8Array"
-            }
-          },
-          "parameters": [
-            {
-              "name": "sheet",
-              "type": {
-                "text": "XLSXSheetData"
-              }
-            }
-          ],
-          "description": "Builds the complete `.xlsx` bytes for a single-sheet workbook."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "columnLetter",
-          "declaration": {
-            "name": "columnLetter",
-            "module": "src/internal/xlsx.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "toExcelSerial",
-          "declaration": {
-            "name": "toExcelSerial",
-            "module": "src/internal/xlsx.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "buildXLSX",
-          "declaration": {
-            "name": "buildXLSX",
-            "module": "src/internal/xlsx.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/operations/base.ts",

package/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,QAAQ,CAAC,QAAQ,EAAE,CAAC","sourcesContent":["import { ApexGrid } from './components/grid.js';\nexport { ApexGrid };\n\nApexGrid.register();\n"]}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,QAAQ,CAAC,QAAQ,EAAE,CAAC","sourcesContent":["import { ApexGrid } from './components/grid.js';\n\nexport { ApexGrid };\n\nApexGrid.register();\n"]}

package/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "eJyVkVFrgzAUhf/LfU63otHUvHXi22AFYRSKD0FvNSxNJMmGUPzvww2G62Q1L3k6J985517BGuMd8BONUxJnCUlYVBGweFZYe2m0A36FlE2vFhcEDvseh4NoMe+EbrEpPlB7IPAmdQM8SlIC71YBB6k92rOo0T0uWR46f1FAoFbCOeDgXbOZ/tj8+GAkELNshs7L12LojfUv/Xe2/7G38pXILJkhQ3ihMAJ1J1VjUQM/xSwjdLurRgJ0u5slOD6Xx5AUf/TratM4nUGfhMPpajkqlRvtcbh34wVH6ASUsq/6lC0kKRrpjQ3L8suzboaERTP4QbRSi2nF0guPd7A36tD6KavGcfwEVCkzTw=="
+window.hierarchyData = "eJyVkctqwzAQRf9l1kqbWPID7VLjdQOBboIXwprYoopkpGkxBP97cQvFDaaJN7Oaq3Pm6grBe4ogT4LvmNhyluZFzSDg2WJDxrsI8gpZPk2nLggS9j0OB9Vi2SnXoq4+0REweDdOg0zSjMFHsCDBOMJwVg3G56XIU0cXCwwaq2IECRT1Znpj85uDkQEvxAxdHt+qofeBXvsft/+xt+uPIcWWz5BreGthDJrOWB3QgTzxQtQTne9m9BcVcSqvRGtL7wiHe1UvJNaaCJF8m4hkwaTShnxY5/In89gnpHkxgx9Ua5yaaj2SIryDvdlee36W1+M4fgGn4Ark"