@deephaven/iris-grid 1.22.1-alpha-pivot-builder.0 → 1.22.1

package/README.md

@@ -20,287 +20,4 @@ const model = await IrisGridModelFactory.makeModel(dh, table);
 
 // In your render function
 <IrisGrid dh={dh} model={model} />
-```
-
-## Customizing the Table Options menu
-
-The Table Options sidebar (the gear menu on the right edge of the grid) is
-extensible. Plugin authors can hide built-in items, relabel or reorder
-them, and add their own items that open a custom configuration page —
-without forking `IrisGrid`.
-
-There is a single entry point: the `transformTableOptions` prop on
-`<IrisGrid>`. It is **opt-in** — it lives on the iris-grid-specific
-`IrisGridTableOptionsWidgetProps`, not on the generic
-`WidgetComponentProps` / `WidgetPanelProps`, so widgets that don't care
-about the Table Options menu never see it.
-
-- **Own the render site?** Pass `transformTableOptions` straight to
-  `<IrisGrid>`.
-- **A `WidgetMiddlewarePlugin` that doesn't render `<IrisGrid>`
-  yourself?** Thread the prop down the middleware chain via the
-  `Component` you wrap, composing your own transform on top of the one
-  you received (see [Publishing from middleware](#publishing-from-middleware)).
-  The panel hosts that ship with Deephaven (`IrisGridPanel`,
-  `GridWidgetPlugin`) accept `transformTableOptions` as a prop and
-  forward it to `<IrisGrid>`.
-
-### Writing a transform
-
-`transformTableOptions(defaults)` is a pure function that receives the
-built-in items (already filtered by what the current model supports) and
-returns the items to actually render. Use it to add, hide, relabel,
-reorder, or replace entries.
-
-```tsx
-import { OptionType, type OptionItem } from '@deephaven/iris-grid';
-
-const transformTableOptions = (defaults: readonly OptionItem[]) => [
-  // hide a built-in
-  ...defaults.filter(o => o.type !== OptionType.SELECT_DISTINCT),
-  // add a plugin item with its own page
-  {
-    type: 'plugin:my-plugin:column-inspector',
-    title: 'Column Inspector',
-    configPage: ColumnInspectorPage,
-  },
-];
-```
-
-Rules:
-
-- The transform should be referentially stable and side-effect-free
-  (it's called inside memoization). Memoize it with `useMemo` /
-  `useCallback` rather than rebuilding per render.
-- A throwing transform is logged once and treated as identity for that
-  render, so the menu degrades gracefully.
-- Items **without** a `configPage` MUST have a `type` matching an
-  existing `OptionType` enum value — those are rendered by the built-in
-  page switch.
-- Items **with** a `configPage` SHOULD use a namespaced key,
-  conventionally `plugin:<name>:<id>`, to avoid colliding with built-ins
-  or other plugins.
-
-### Implementing a `configPage`
-
-A `configPage` is a regular React component that receives
-`IrisGridTableOptionsPageProps`:
-
-```tsx
-import { type IrisGridTableOptionsPageProps } from '@deephaven/iris-grid';
-
-export function ColumnInspectorPage({
-  model,
-  onBack,
-}: IrisGridTableOptionsPageProps): JSX.Element {
-  return (
-    <div>
-      <button type="button" onClick={onBack}>Back</button>
-      <pre>{model.columns.map(c => c.name).join('\n')}</pre>
-    </div>
-  );
-}
-```
-
-`IrisGrid` wraps each `configPage` render in `PluginTableOptionsErrorBoundary`,
-so a throw inside your page shows a small inline fallback instead of
-unmounting the whole grid.
-
-### Publishing from middleware
-
-When you're a `WidgetMiddlewarePlugin` and don't render `<IrisGrid>`
-yourself, you receive `transformTableOptions` as a prop and pass a
-composed transform down to the `Component` (or panel) you wrap. Run the
-upstream transform first so contributions compose, then layer your own
-changes on top.
-
-A `panelComponent` middleware should be built with `createPanelMiddleware`
-from `@deephaven/plugin`: you supply a body hook that may `inject` props onto
-the wrapped component and/or `wrap` the child in a wrapper element (both
-optional), and the factory owns the `React.forwardRef` ceremony and ref
-forwarding for you. That ref matters —
-golden-layout binds a ref to the registered panel to persist class-panel
-state (sorts, filters, column moves, etc.) into its `componentState`, and a
-middleware that swallowed it would silently break that persistence for every
-panel below it; the factory guarantees it can't be dropped. For the non-panel
-`component` path use `createWidgetMiddleware`, which is otherwise identical but
-takes no ref.
-
-```tsx
-import { useMemo } from 'react';
-import { createPanelMiddleware, type WidgetPanelProps } from '@deephaven/plugin';
-import {
-  type IrisGridTableOptionsWidgetProps,
-  type TableOptionsTransform,
-} from '@deephaven/iris-grid';
-
-function makeMyTransform(
-  upstream: TableOptionsTransform | undefined
-): TableOptionsTransform {
-  return defaults => {
-    const base = upstream != null ? upstream(defaults) : defaults;
-    return [...base, myPluginItem];
-  };
-}
-
-const MyMiddleware = createPanelMiddleware<
-  unknown,
-  WidgetPanelProps & IrisGridTableOptionsWidgetProps
->(({ transformTableOptions }) => {
-  const composedTransform = useMemo(
-    () => makeMyTransform(transformTableOptions),
-    [transformTableOptions]
-  );
-  return { inject: { transformTableOptions: composedTransform } };
-}, 'MyMiddleware');
-```
-
-The body hook receives the incoming props (minus `Component`) and returns an
-optional `{ inject?, wrap? }`. Every incoming prop is forwarded to the wrapped
-component automatically; `inject` only adds or overrides the few props you
-actually change (here `transformTableOptions`), and `wrap` optionally nests the
-child (e.g. in a context provider). Both fields are optional — a pass-through
-middleware can return `{}`. The factory adds the `ref` plumbing on top.
-
-
-Composition rule: each middleware layer reads the `transformTableOptions`
-it was handed, runs that transform first, then layers its own changes on
-top — last writer wins for any given `OptionItem.type`.
-
-#### Model-aware menus
-
-The transform must stay **pure** — it only sees `defaults`, never the
-`IrisGridModel`. To make a menu react to model state (e.g. relabel an
-item once a pivot is active), take a **snapshot of the value you care
-about** from model events and fold it into the transform's identity:
-
-```tsx
-const [isPivot, setIsPivot] = useState(model.isPivot);
-useEffect(() => {
-  const handler = () => setIsPivot(model.isPivot);
-  model.addEventListener(SOME_MODEL_EVENT, handler);
-  return () => model.removeEventListener(SOME_MODEL_EVENT, handler);
-}, [model]);
-
-const composedTransform = useMemo(
-  () => makeMyTransform(transformTableOptions, isPivot),
-  [transformTableOptions, isPivot]
-);
-```
-
-Because `composedTransform`'s identity changes when the snapshot
-changes, `IrisGrid` re-runs it (its menu cache is keyed on
-`[defaults, transform]`). Keeping the snapshot in the dependency array —
-rather than reading `model.isPivot` inside the transform — is what keeps
-that memoization honest.
-
-To obtain the model when the host builds it for you, pass an
-`onModelChanged` callback to `IrisGridPanel` (called once the panel's
-model is ready).
-
-### Full example
-
-See the [`@deephaven/js-plugin-pivot-builder`](https://github.com/deephaven/deephaven-plugins/tree/main/plugins/pivot-builder)
-plugin for a working `WidgetMiddlewarePlugin` that replaces the default
-widget renderer and adds a `configPage`-backed "Rollup, Aggregate and Pivot"
-item to the Table Options sidebar.
-
-### Why the transform doesn't take the model
-
-The transform signature is `(defaults) => items` — it deliberately does
-**not** receive the `IrisGridModel` or grid state. State-aware menus
-(e.g. "relabel an item once a pivot is active", "show *Reset filters*
-only when filters exist") are implemented in the middleware: subscribe
-to model events, snapshot the value you need, and fold that snapshot
-into the transform's identity (see
-[Model-aware menus](#model-aware-menus)). The transform itself stays
-pure.
-
-This isn't just about keeping the public surface small — it's also
-what keeps menu memoization honest. `IrisGrid` caches the computed
-item list on `[defaults, transform]` (see `getCachedTransformedOptionItems`),
-both of which are stable values/refs. Adding a live `model` argument
-would break that: `IrisGridModel` is a long-lived mutable handle whose
-identity does not change when `isExpandable`, `filter`, `sorts`, or
-`isRollup` flip, so any plugin that read those fields would silently
-return stale items until something unrelated invalidated the cache.
-
-By passing a **curated snapshot of values** through the transform's
-closure instead, the memo key changes exactly when those values change
-and re-runs are driven by actual dependencies. Passing the model itself,
-or the full `IrisGrid` instance, is intentionally off the table: the
-surface is too large, too volatile, and (in the model's case)
-memoization-hostile.
-
-## Transforming the model
-
-Some plugins need more than a custom menu — they need to change the
-**model** the grid renders (e.g. wrap it in a proxy that can swap its
-inner model in response to a config page). For that there is a second,
-symmetric opt-in seam: the `transformModel` prop.
-
-Like `transformTableOptions`, it lives on an iris-grid-specific
-interface (`IrisGridModelWidgetProps`), not on the generic
-`WidgetComponentProps` / `WidgetPanelProps`, and is threaded down the
-middleware chain by the hosts that build the model for you
-(`IrisGridPanel`, `GridWidgetPlugin` / `useIrisGridModel`).
-
-```ts
-import { type IrisGridModelTransform } from '@deephaven/iris-grid';
-
-// (model: IrisGridModel) => IrisGridModel | Promise<IrisGridModel>
-const transformModel: IrisGridModelTransform = model =>
-  wrapInMyProxy(model);
-```
-
-The host builds the model from `fetch` as usual, then applies
-`transformModel` to whatever it built **before** handing it to
-`<IrisGrid>`. The returned model must be a drop-in for the input — the
-host owns its lifecycle and will `close()` whatever you return, so wrap
-rather than discard the model you were given. The transform may be async
-if it needs to await dependencies first.
-
-Rules:
-
-- `transformModel` must be **referentially stable**. It is applied when
-  the model is (re)built; an unstable transform would rebuild the model.
-  Memoize it with `useMemo` / `useCallback`.
-- It runs once per model build, not per render, so it is the right place
-  for one-time wrapping — not for per-render state.
-- This is why model construction stays in the host: the host keeps
-  ownership of `fetch`, error/loading state, and `close()`, while the
-  plugin only augments the result. A middleware using `transformModel`
-  can therefore render the wrapped `Component` and stay a **chained**
-  layer instead of taking over model construction and becoming terminal.
-
-### Publishing `transformModel` from middleware
-
-A middleware that needs both seams composes them the same way — run any
-upstream transform first, then layer your own — and returns both from its
-body hook's `inject`. Props you don't touch (here `transformTableOptions`)
-are forwarded automatically, so you only inject what you change:
-
-```tsx
-import { useMemo } from 'react';
-import { createPanelMiddleware, type WidgetPanelProps } from '@deephaven/plugin';
-import {
-  type IrisGridModelTransform,
-  type IrisGridModelWidgetProps,
-  type IrisGridTableOptionsWidgetProps,
-} from '@deephaven/iris-grid';
-
-const MyMiddleware = createPanelMiddleware<
-  unknown,
-  WidgetPanelProps & IrisGridModelWidgetProps & IrisGridTableOptionsWidgetProps
->(({ transformModel }) => {
-  const composedModel = useMemo<IrisGridModelTransform>(
-    () => async model => {
-      const base = transformModel != null ? await transformModel(model) : model;
-      return wrapInMyProxy(base);
-    },
-    [transformModel]
-  );
-  return { inject: { transformModel: composedModel } };
-}, 'MyMiddleware');
-```
-
+```

package/dist/CommonTypes.d.ts

@@ -3,9 +3,8 @@ import { type GridRangeIndex, type ModelIndex } from '@deephaven/grid';
 import type { dh } from '@deephaven/jsapi-types';
 import { type Shortcut } from '@deephaven/components';
 import { type IconDefinition } from '@deephaven/icons';
-import { type ComponentType } from 'react';
 import type AggregationOperation from './sidebar/aggregations/AggregationOperation';
-import { type UIRollupConfig, type OptionItemKey } from './sidebar';
+import { type UIRollupConfig, type OptionType } from './sidebar';
 import type IrisGridModel from './IrisGridModel';
 import { type IrisGridThemeType } from './IrisGridTheme';
 export type RowIndex = ModelIndex;
@@ -30,72 +29,13 @@ export type Action = {
     action: () => void;
     shortcut: Shortcut;
 };
-/**
- * Options accepted by `IrisGrid.startLoading`. Mirrors the inline options bag
- * on that method so initiators (including plugins) can type their request.
- */
-export type StartLoadingOptions = {
-    /** Reset selected ranges and scroll position when loading begins. */
-    resetRanges?: boolean;
-    /** Whether the loading scrim shows a cancel button. */
-    loadingCancelShown?: boolean;
-    /** Whether the loading scrim blocks interaction with the grid. */
-    loadingBlocksGrid?: boolean;
-};
-/**
- * Detail payload for `IrisGridModel.EVENT.PENDING`. Self-describing so an
- * initiator (e.g. a plugin) can raise the loading scrim for an operation
- * IrisGrid has no built-in knowledge of.
- */
-export type PendingOperationDetail = {
-    /**
-     * Display text for the scrim. Omitted → IrisGrid uses a generic message.
-     */
-    text?: string;
-    /** Scrim options the initiator wants applied while loading. */
-    options?: StartLoadingOptions;
-};
-/**
- * Props passed to a plugin-supplied sidebar page (an item whose
- * `configPage` is set). Pages receive the current model and a
- * back-navigation callback; any additional state access should
- * flow through the model or through props the plugin threads in
- * itself.
- */
-export type IrisGridTableOptionsPageProps = {
-    /** Current model the grid is rendering. */
-    model: IrisGridModel;
-    /** Pop the current page off the sidebar stack. */
-    onBack: () => void;
-};
 export type OptionItem = {
-    /**
-     * Built-in items use the `OptionType` enum; plugin-contributed items
-     * use a namespaced string key (convention `plugin:<name>:<id>`).
-     */
-    type: OptionItemKey;
+    type: OptionType;
     title: string;
     subtitle?: string;
     icon?: IconDefinition;
     isOn?: boolean;
     onChange?: () => void;
-    /**
-     * Optional sort weight for positioning the item within the menu. Items
-     * are stably sorted by ascending `order`; an omitted `order` sinks the
-     * item to the end of the menu. Built-in items are numbered with a stride
-     * of 100 (Chart Builder `100` … Go to `1200`), so a plugin can slot an
-     * item between two built-ins (e.g. `250`) or before all of them with a
-     * smaller/negative value.
-     */
-    order?: number;
-    /**
-     * Renderer for plugin-supplied sidebar pages. Built-in items leave
-     * this undefined — the `IrisGrid` page switch renders them via
-     * its existing `case OptionType.*` arms; the `default` case renders
-     * `configPage` when present and falls back to a programmer-error
-     * throw otherwise.
-     */
-    configPage?: ComponentType<IrisGridTableOptionsPageProps>;
 };
 export interface UITotalsTableConfig extends dh.TotalsTableConfig {
     operationOrder: AggregationOperation[];

package/dist/CommonTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommonTypes.d.ts","sourceRoot":"","sources":["../src/CommonTypes.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"CommonTypes.d.ts","sourceRoot":"","sources":["../src/CommonTypes.tsx"],"names":[],"mappings":"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"}

package/dist/CommonTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommonTypes.js","names":[],"sources":["../src/CommonTypes.tsx"],"sourcesContent":["import {\n  type AdvancedFilterOptions,\n  type SortDescriptor,\n} from '@deephaven/jsapi-utils';\nimport { type GridRangeIndex, type ModelIndex } from '@deephaven/grid';\nimport type { dh } from '@deephaven/jsapi-types';\nimport { type Shortcut } from '@deephaven/components';\nimport { type IconDefinition } from '@deephaven/icons';\nimport { type ComponentType } from 'react';\nimport type AggregationOperation from './sidebar/aggregations/AggregationOperation';\nimport { type UIRollupConfig, type OptionItemKey } from './sidebar';\nimport type IrisGridModel from './IrisGridModel';\nimport { type IrisGridThemeType } from './IrisGridTheme';\n\nexport type RowIndex = ModelIndex;\n\nexport type { AdvancedFilterOptions };\nexport type ColumnName = string;\nexport type AdvancedFilterMap = Map<ModelIndex, AdvancedFilter>;\nexport type QuickFilterMap = Map<ModelIndex, QuickFilter>;\nexport type ReadonlyAdvancedFilterMap = ReadonlyMap<ModelIndex, AdvancedFilter>;\nexport type ReadonlyQuickFilterMap = ReadonlyMap<ModelIndex, QuickFilter>;\nexport type ReadonlyAggregationMap = Readonly<\n  Record<AggregationOperation, readonly ColumnName[]>\n>;\nexport type OperationMap = Record<ColumnName, readonly AggregationOperation[]>;\nexport type ReadonlyOperationMap = Readonly<\n  Record<ColumnName, readonly AggregationOperation[]>\n>;\n\nexport type QuickFilter = {\n  text: string;\n  filter: dh.FilterCondition | null;\n};\n\nexport type AdvancedFilter = {\n  filter: dh.FilterCondition | null;\n  options: AdvancedFilterOptions;\n};\n\nexport type Action = {\n  action: () => void;\n  shortcut: Shortcut;\n};\n\n/**\n * Options accepted by `IrisGrid.startLoading`. Mirrors the inline options bag\n * on that method so initiators (including plugins) can type their request.\n */\nexport type StartLoadingOptions = {\n  /** Reset selected ranges and scroll position when loading begins. */\n  resetRanges?: boolean;\n  /** Whether the loading scrim shows a cancel button. */\n  loadingCancelShown?: boolean;\n  /** Whether the loading scrim blocks interaction with the grid. */\n  loadingBlocksGrid?: boolean;\n};\n\n/**\n * Detail payload for `IrisGridModel.EVENT.PENDING`. Self-describing so an\n * initiator (e.g. a plugin) can raise the loading scrim for an operation\n * IrisGrid has no built-in knowledge of.\n */\nexport type PendingOperationDetail = {\n  /**\n   * Display text for the scrim. Omitted → IrisGrid uses a generic message.\n   */\n  text?: string;\n  /** Scrim options the initiator wants applied while loading. */\n  options?: StartLoadingOptions;\n};\n\n/**\n * Props passed to a plugin-supplied sidebar page (an item whose\n * `configPage` is set). Pages receive the current model and a\n * back-navigation callback; any additional state access should\n * flow through the model or through props the plugin threads in\n * itself.\n */\nexport type IrisGridTableOptionsPageProps = {\n  /** Current model the grid is rendering. */\n  model: IrisGridModel;\n  /** Pop the current page off the sidebar stack. */\n  onBack: () => void;\n};\n\nexport type OptionItem = {\n  /**\n   * Built-in items use the `OptionType` enum; plugin-contributed items\n   * use a namespaced string key (convention `plugin:<name>:<id>`).\n   */\n  type: OptionItemKey;\n  title: string;\n  subtitle?: string;\n  icon?: IconDefinition;\n  isOn?: boolean;\n  onChange?: () => void;\n  /**\n   * Optional sort weight for positioning the item within the menu. Items\n   * are stably sorted by ascending `order`; an omitted `order` sinks the\n   * item to the end of the menu. Built-in items are numbered with a stride\n   * of 100 (Chart Builder `100` … Go to `1200`), so a plugin can slot an\n   * item between two built-ins (e.g. `250`) or before all of them with a\n   * smaller/negative value.\n   */\n  order?: number;\n  /**\n   * Renderer for plugin-supplied sidebar pages. Built-in items leave\n   * this undefined — the `IrisGrid` page switch renders them via\n   * its existing `case OptionType.*` arms; the `default` case renders\n   * `configPage` when present and falls back to a programmer-error\n   * throw otherwise.\n   */\n  configPage?: ComponentType<IrisGridTableOptionsPageProps>;\n};\n\nexport interface UITotalsTableConfig extends dh.TotalsTableConfig {\n  operationOrder: AggregationOperation[];\n  showOnTop: boolean;\n}\n\nexport type InputFilter = {\n  name: string;\n  type: string;\n  value: string;\n  excludePanelIds?: (string | string[])[];\n};\n\nexport interface UIRow {\n  /**\n   * The data in the row indexed by column number.\n   * If a column is not part of the columns array (i.e. it's hidden by the model/table),\n   * then it will be included by its name instead of index.\n   */\n  data: Map<ModelIndex | ColumnName, CellData>;\n}\n\nexport type UIViewportData<R extends UIRow = UIRow> = {\n  offset: number;\n  rows: R[];\n};\nexport type RowData<T = unknown> = Map<number, { value: T }>;\n\nexport type CellData = {\n  value: unknown;\n  format?: dh.Format;\n};\nexport type PendingDataMap<R extends UIRow = UIRow> = ReadonlyMap<RowIndex, R>;\n\n/** Maps from a row index to the errors for that row */\nexport type PendingDataErrorMap<T extends Error = Error> = ReadonlyMap<\n  RowIndex,\n  readonly T[]\n>;\n\nexport interface IrisGridStateOverride extends Record<string, unknown> {\n  model: IrisGridModel;\n  theme: IrisGridThemeType;\n  hoverSelectColumn: GridRangeIndex;\n  isFilterBarShown: boolean;\n  isMenuShown: boolean;\n  isSelectingColumn: boolean;\n  loadingScrimProgress: number | null;\n  advancedFilters: ReadonlyAdvancedFilterMap;\n  quickFilters: ReadonlyQuickFilterMap;\n  sorts: readonly SortDescriptor[];\n  reverse: boolean;\n  rollupConfig: UIRollupConfig | undefined;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"CommonTypes.js","names":[],"sources":["../src/CommonTypes.tsx"],"sourcesContent":["import {\n  type AdvancedFilterOptions,\n  type SortDescriptor,\n} from '@deephaven/jsapi-utils';\nimport { type GridRangeIndex, type ModelIndex } from '@deephaven/grid';\nimport type { dh } from '@deephaven/jsapi-types';\nimport { type Shortcut } from '@deephaven/components';\nimport { type IconDefinition } from '@deephaven/icons';\nimport type AggregationOperation from './sidebar/aggregations/AggregationOperation';\nimport { type UIRollupConfig, type OptionType } from './sidebar';\nimport type IrisGridModel from './IrisGridModel';\nimport { type IrisGridThemeType } from './IrisGridTheme';\n\nexport type RowIndex = ModelIndex;\n\nexport type { AdvancedFilterOptions };\nexport type ColumnName = string;\nexport type AdvancedFilterMap = Map<ModelIndex, AdvancedFilter>;\nexport type QuickFilterMap = Map<ModelIndex, QuickFilter>;\nexport type ReadonlyAdvancedFilterMap = ReadonlyMap<ModelIndex, AdvancedFilter>;\nexport type ReadonlyQuickFilterMap = ReadonlyMap<ModelIndex, QuickFilter>;\nexport type ReadonlyAggregationMap = Readonly<\n  Record<AggregationOperation, readonly ColumnName[]>\n>;\nexport type OperationMap = Record<ColumnName, readonly AggregationOperation[]>;\nexport type ReadonlyOperationMap = Readonly<\n  Record<ColumnName, readonly AggregationOperation[]>\n>;\n\nexport type QuickFilter = {\n  text: string;\n  filter: dh.FilterCondition | null;\n};\n\nexport type AdvancedFilter = {\n  filter: dh.FilterCondition | null;\n  options: AdvancedFilterOptions;\n};\n\nexport type Action = {\n  action: () => void;\n  shortcut: Shortcut;\n};\n\nexport type OptionItem = {\n  type: OptionType;\n  title: string;\n  subtitle?: string;\n  icon?: IconDefinition;\n  isOn?: boolean;\n  onChange?: () => void;\n};\n\nexport interface UITotalsTableConfig extends dh.TotalsTableConfig {\n  operationOrder: AggregationOperation[];\n  showOnTop: boolean;\n}\n\nexport type InputFilter = {\n  name: string;\n  type: string;\n  value: string;\n  excludePanelIds?: (string | string[])[];\n};\n\nexport interface UIRow {\n  /**\n   * The data in the row indexed by column number.\n   * If a column is not part of the columns array (i.e. it's hidden by the model/table),\n   * then it will be included by its name instead of index.\n   */\n  data: Map<ModelIndex | ColumnName, CellData>;\n}\n\nexport type UIViewportData<R extends UIRow = UIRow> = {\n  offset: number;\n  rows: R[];\n};\nexport type RowData<T = unknown> = Map<number, { value: T }>;\n\nexport type CellData = {\n  value: unknown;\n  format?: dh.Format;\n};\nexport type PendingDataMap<R extends UIRow = UIRow> = ReadonlyMap<RowIndex, R>;\n\n/** Maps from a row index to the errors for that row */\nexport type PendingDataErrorMap<T extends Error = Error> = ReadonlyMap<\n  RowIndex,\n  readonly T[]\n>;\n\nexport interface IrisGridStateOverride extends Record<string, unknown> {\n  model: IrisGridModel;\n  theme: IrisGridThemeType;\n  hoverSelectColumn: GridRangeIndex;\n  isFilterBarShown: boolean;\n  isMenuShown: boolean;\n  isSelectingColumn: boolean;\n  loadingScrimProgress: number | null;\n  advancedFilters: ReadonlyAdvancedFilterMap;\n  quickFilters: ReadonlyQuickFilterMap;\n  sorts: readonly SortDescriptor[];\n  reverse: boolean;\n  rollupConfig: UIRollupConfig | undefined;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/IrisGrid.d.ts

@@ -22,7 +22,7 @@ import { type AdvancedSettingsMenuCallback } from './sidebar/AdvancedSettingsMen
 import { type GotoRowElement } from './GotoRow';
 import { type Aggregation, type AggregationSettings } from './sidebar/aggregations/Aggregations';
 import { type ChartBuilderSettings } from './sidebar/ChartBuilder';
-import type AggregationOperation from './sidebar/aggregations/AggregationOperation';
+import AggregationOperation from './sidebar/aggregations/AggregationOperation';
 import { type UIRollupConfig } from './sidebar/RollupRows';
 import { type Action, type AdvancedFilterOptions, type ColumnName, type InputFilter, type IrisGridStateOverride, type OperationMap, type OptionItem, type PendingDataErrorMap, type PendingDataMap, type QuickFilterMap, type ReadonlyAdvancedFilterMap, type ReadonlyAggregationMap, type ReadonlyQuickFilterMap, type UITotalsTableConfig } from './CommonTypes';
 import type ColumnHeaderGroup from './ColumnHeaderGroup';
@@ -70,23 +70,6 @@ export interface IrisGridProps {
     onDataSelected: (index: ModelIndex, map: RowDataMap) => void;
     onStateChange: (irisGridState: IrisGridState, gridState: GridState) => void;
     onAdvancedSettingsChange: AdvancedSettingsMenuCallback;
-    /**
-     * Pure transform over the default Table Options menu list. Receives
-     * the built-in items (already filtered by model availability) and
-     * returns the items to actually render. Use it to add, hide,
-     * relabel, reorder, or replace entries.
-     *
-     * Items returned with a `configPage` are rendered by the
-     * `default` case of the page switch and isolated inside a small
-     * error boundary; items without a `configPage` MUST have a `type`
-     * matching an existing `OptionType` enum value, otherwise the
-     * existing case arms can't render them.
-     *
-     * Called inside memoization; the function should be referentially
-     * stable and side-effect-free. A throwing transform is logged once
-     * and treated as identity for that render.
-     */
-    transformTableOptions?: (defaults: readonly OptionItem[]) => readonly OptionItem[];
     /** @deprecated use `partitionConfig` instead */
     partitions?: (string | null)[];
     partitionConfig?: PartitionConfig;
@@ -145,16 +128,6 @@ export interface IrisGridProps {
     density?: 'compact' | 'regular' | 'spacious';
     getMetricCalculator: GetMetricCalculatorType;
 }
-/**
- * The subset of `IrisGridProps` that overrides how the grid presents its
- * model: theme, canvas renderer, extra mouse handlers, and the metric
- * calculator factory. Hosts that render `<IrisGrid>` on behalf of a plugin
- * (e.g. `GridWidgetPlugin`) accept this as a single passthrough bag so they
- * don't need to know each view concern by name, and plugins build it from
- * their own hooks. Kept as a `Pick` (not `Partial<IrisGridProps>`) so it can
- * never clobber structural props like `model` or `ref`.
- */
-export type IrisGridViewProps = Pick<IrisGridProps, 'theme' | 'renderer' | 'mouseHandlers' | 'getMetricCalculator'>;
 export interface IrisGridState {
     isFilterBarShown: boolean;
     isSelectingPartition: boolean;
@@ -349,13 +322,6 @@ declare class IrisGrid extends Component<IrisGridProps, IrisGridState> {
     tableUtils: TableUtils;
     keyHandlers: readonly KeyHandler[];
     mouseHandlers: MouseHandlersProp;
-    /**
-     * The metric calculator factory most recently used to instantiate the
-     * calculator currently stored in state. Used by `maybeRebuildMetricCalculator`
-     * (called from `componentDidUpdate` when the `getMetricCalculator` prop
-     * changes) to detect when a different factory is supplied and rebuild.
-     */
-    lastMetricCalculatorFactory?: GetMetricCalculatorType;
     slideTransitionRef: React.RefObject<HTMLDivElement>;
     bottomTransitionRef: React.RefObject<HTMLDivElement>;
     get gridWrapper(): HTMLDivElement | null;
@@ -363,13 +329,6 @@ declare class IrisGrid extends Component<IrisGridProps, IrisGridState> {
     getAdvancedMenuToggleMaximizeHandler: ((column: ModelIndex) => () => void) & memoize.Memoized<(column: ModelIndex) => () => void>;
     getCachedAdvancedFilterMenuActions: ((model: IrisGridModel, column: DhType.Column, advancedFilterOptions: AdvancedFilterOptions | undefined, sortDirection: SortDirection | undefined, formatter: Formatter, isMaximized: boolean, onToggleMaximize: () => void) => import("react/jsx-runtime").JSX.Element) & memoize.Memoized<(model: IrisGridModel, column: DhType.Column, advancedFilterOptions: AdvancedFilterOptions | undefined, sortDirection: SortDirection | undefined, formatter: Formatter, isMaximized: boolean, onToggleMaximize: () => void) => import("react/jsx-runtime").JSX.Element>;
     getCachedOptionItems: ((isChartBuilderAvailable: boolean, isCustomColumnsAvailable: boolean, isFormatColumnsAvailable: boolean, isOrganizeColumnsAvailable: boolean, isRollupAvailable: boolean, isTotalsAvailable: boolean, isSelectDistinctAvailable: boolean, isExportAvailable: boolean, toggleFilterBarAction: Action, toggleSearchBarAction: Action, toggleGotoRowAction: Action, isFilterBarShown: boolean, showSearchBar: boolean, canDownloadCsv: boolean, canToggleSearch: boolean, showGotoRow: boolean, hasAdvancedSettings: boolean) => readonly OptionItem[]) & memoize.Memoized<(isChartBuilderAvailable: boolean, isCustomColumnsAvailable: boolean, isFormatColumnsAvailable: boolean, isOrganizeColumnsAvailable: boolean, isRollupAvailable: boolean, isTotalsAvailable: boolean, isSelectDistinctAvailable: boolean, isExportAvailable: boolean, toggleFilterBarAction: Action, toggleSearchBarAction: Action, toggleGotoRowAction: Action, isFilterBarShown: boolean, showSearchBar: boolean, canDownloadCsv: boolean, canToggleSearch: boolean, showGotoRow: boolean, hasAdvancedSettings: boolean) => readonly OptionItem[]>;
-    /**
-     * Apply the `transformTableOptions` transform (if any) to the
-     * default option list.
-     * Catches exceptions so a buggy plugin can't break the grid,
-     * and warns about duplicate `type` collisions.
-     */
-    getCachedTransformedOptionItems: ((items: readonly OptionItem[], transformTableOptions: IrisGridProps["transformTableOptions"]) => readonly OptionItem[]) & memoize.Memoized<(items: readonly OptionItem[], transformTableOptions: IrisGridProps["transformTableOptions"]) => readonly OptionItem[]>;
     getCachedHiddenColumns: ((metricCalculator: IrisGridMetricCalculator, userColumnWidths: ModelSizeMap) => readonly ModelIndex[]) & memoize.Memoized<(metricCalculator: IrisGridMetricCalculator, userColumnWidths: ModelSizeMap) => readonly ModelIndex[]>;
     getAggregationMap: ((columns: readonly DhType.Column[], aggregations: readonly Aggregation[]) => ReadonlyAggregationMap) & memoize.Memoized<(columns: readonly DhType.Column[], aggregations: readonly Aggregation[]) => ReadonlyAggregationMap>;
     getOperationMap: ((columns: readonly DhType.Column[], aggregations: readonly Aggregation[]) => OperationMap) & memoize.Memoized<(columns: readonly DhType.Column[], aggregations: readonly Aggregation[]) => OperationMap>;
@@ -392,7 +351,7 @@ declare class IrisGrid extends Component<IrisGridProps, IrisGridState> {
     getCachedKeyHandlers: ((keyHandlers: readonly KeyHandler[]) => KeyHandler[]) & memoize.Memoized<(keyHandlers: readonly KeyHandler[]) => KeyHandler[]>;
     getKeyHandlers(): readonly KeyHandler[];
     getMetricState(): IrisGridMetricState | undefined;
-    getCachedMouseHandlers: ((mouseHandlersProp: MouseHandlersProp) => readonly GridMouseHandler[]) & memoize.Memoized<(mouseHandlersProp: MouseHandlersProp) => readonly GridMouseHandler[]>;
+    getCachedMouseHandlers: ((mouseHandlers: MouseHandlersProp) => readonly GridMouseHandler[]) & memoize.Memoized<(mouseHandlers: MouseHandlersProp) => readonly GridMouseHandler[]>;
     getCachedRenderer: ((rendererProp?: IrisGridRenderer) => IrisGridRenderer) & memoize.Memoized<(rendererProp?: IrisGridRenderer) => IrisGridRenderer>;
     get renderer(): IrisGridRenderer;
     getMouseHandlers(): readonly GridMouseHandler[];
@@ -574,32 +533,8 @@ declare class IrisGrid extends Component<IrisGridProps, IrisGridState> {
     handleMenuBack(): void;
     handleMenuSelect(option: OptionItem): void;
     handleRequestFailed(event: EventT): void;
-    /**
-     * Raise the loading scrim in response to a model-driven `PENDING` event. The
-     * model is the start signal, mirroring how `UPDATED`/`COLUMNS_CHANGED` are
-     * already the model-driven stop signal. Idempotent: the first message within
-     * a commit wins (the `loadingScrimStartTime == null` guard collapses multiple
-     * pending operations into a single scrim).
-     */
-    handlePending(event: EventT): void;
-    /**
-     * Clear the loading scrim in response to a model-driven `PENDING_CLEARED`
-     * event. Only needed for operations that do not naturally end in
-     * `UPDATED`/`COLUMNS_CHANGED`/`REQUEST_FAILED`.
-     */
-    handlePendingCleared(): void;
     handleUpdate(): void;
     handleTableChanged(): void;
-    /**
-     * Handle an inner-model swap on a proxy model (`MODEL_CHANGED`). The previous
-     * model's `movedColumns` reference indices that may not exist in the new
-     * model (e.g. a pivot exposes a different column set), so reset them to the
-     * new model's initial order. The metric calculator is rebuilt separately when
-     * the `getMetricCalculator` prop changes (see `componentDidUpdate`); a calc
-     * whose seed `movedColumns` are now stale self-heals because `getMetrics`
-     * reconciles against the grid's current `movedColumns` at draw time.
-     */
-    handleModelChanged(): void;
     handleViewChanged(metrics?: GridMetrics): void;
     handleSelectionChanged(selectedRanges?: readonly GridRange[]): void;
     handleMovedColumnsChanged(movedColumns: readonly MoveOperation[], onChangeApplied?: () => void): void;
@@ -613,24 +548,6 @@ declare class IrisGrid extends Component<IrisGridProps, IrisGridState> {
     handleConditionalFormatEditorCancel(): void;
     handleUpdateCustomColumns(customColumns: readonly string[]): void;
     handleCustomColumnsChanged(): void;
-    /**
-     * Rebuild the metric calculator when the `getMetricCalculator` prop swaps for
-     * a different factory (e.g. entering or leaving a pivot, where the
-     * pivot-builder middleware flips the prop). The renderer and mouse handlers
-     * are recomputed via their memoized getters on the next render and do not
-     * need explicit handling here.
-     *
-     * User column-widths / row-heights from the previous calculator are not
-     * carried over: a factory swap means the column set has effectively changed,
-     * so the stored sizes wouldn't map to anything meaningful.
-     *
-     * Moved columns are NOT reset here — that is owned by `handleModelChanged`
-     * (the `MODEL_CHANGED` event) so that a plain prop swap against the same
-     * model preserves the user's layout. The new calculator is seeded with the
-     * current moved columns; `getMetrics` reconciles against the grid's live
-     * `movedColumns` at draw time, so a later reset stays consistent.
-     */
-    maybeRebuildMetricCalculator(): void;
     handlePendingCommitClicked(): Promise<void>;
     handlePendingDiscardClicked(): Promise<void>;
     handlePendingDataUpdated(): void;