@xenosystem/blocks 0.13.20 → 0.13.21

package/dist/data/index.d.ts

@@ -241,6 +241,21 @@ declare class TableController {
     private snapshot;
     constructor(options: TableControllerOptions);
     /** Subscribe to state changes. Returns an unsubscribe function. */
+    /** The scroller's measured viewport — the view state windows rows AND columns from it (`table/Scroller` reports it). */
+    private viewport;
+    /** The scroller reports its viewport; the view state windows the grid from it. */
+    setViewport(viewport: {
+        width: number;
+        height: number;
+        scrollTop: number;
+        scrollLeft: number;
+    }): void;
+    getViewport(): {
+        width: number;
+        height: number;
+        scrollTop: number;
+        scrollLeft: number;
+    };
     subscribe: (listener: () => void) => (() => void);
     /** The current view snapshot (stable reference until something changes). */
     getState: () => TableViewState;
@@ -658,39 +673,199 @@ declare function constraintsOfColumn(column: {
 }): NumericConstraints;
 
 /**
- * The Table panel's React view — grid + pivot.
+ * The Table panel AS A DECLARATION — the twenty-first block written the §8d way, and the first
+ * GRID: rows AND columns windowed, frozen columns, an inline cell editor, and a cross-tab.
  *
- * **First real consumer of `@xenosystem/components/chrome`.** Everything that is chrome (toolbar,
- * status strip, empty/loading/error states, badges, icon buttons, segmented control) comes from the
- * primitives; only the grid body itself — which is the panel's actual job — is local.
+ * Presentation contract: input `view` (a {@link TableViewModel} the runtime derives from the
+ * controller on every draw — the result state decided, both windows computed from the viewport the
+ * controller holds, every header, row and cell as DATA), output `ui` (a {@link TableUiIntent})
+ * applied by the runtime to the controller's own methods.
  *
- * The view is deliberately thin: all state lives in {@link TableController}, bound through
- * `useSyncExternalStore`. Rendering is the only thing that happens here.
+ * The grid is the `chrome/Grid*` family: a sticky `GridHeader` of `GridHeaderCell`s, fixed-height
+ * `GridRow`s of `GridCell`s, a `GridSpacer` standing in for the columns windowed out to the left.
+ * Frozen columns come first in every row and are sticky at their own offset. The cell being edited
+ * holds a plain `chrome/Input` over the controller's own draft. The pivot is `chrome/PivotTable`
+ * rows flattened with their depth. Values are FORMATTED HERE, in the model — a cell aligns, it never
+ * formats.
  *
- * @module
+ * What a declaration cannot hold: the SCROLLER (`table/Scroller` — measured width and height, the
+ * scroll offsets both ways). The runtime registers it bound to its controller
+ * ({@link tableRuntimeComponents}).
  */
 
-/** Props for {@link TablePanelView}. */
-interface TablePanelViewProps {
-    /** The controller. */
-    controller: TableController;
+/** The half of a renderer's config the view reads. */
+interface TableViewOptions {
     /** Fixed row height in px (config `rowHeight`). */
     rowHeight?: number;
     /** Render the grand-totals footer. */
     showFooter?: boolean;
     /** Shade alternate rows. */
     zebra?: boolean;
-    /**
-     * Render a leading ordinal gutter.
-     *
-     * U5: the manifest declared this from day one and the view never rendered it — declared config
-     * with no implementation. The numbers are 1-based over the CURRENT PAGE plus the query offset,
-     * so row 1 of page 2 reads as its absolute position rather than restarting.
-     */
+    /** Render a leading ordinal gutter — 1-based over the CURRENT PAGE plus the query offset. */
     showRowNumbers?: boolean;
 }
+interface TableViewHeaderCell {
+    key: string;
+    columnId: string;
+    name: string;
+    width: number;
+    frozen: boolean;
+    offset: number;
+    sort: 'asc' | 'desc' | null;
+    sortAsc: boolean;
+    sortDesc: boolean;
+    sortable: boolean;
+    title: string;
+}
+interface TableViewCell {
+    key: string;
+    rowId: string;
+    columnId: string;
+    width: number;
+    align: 'left' | 'right' | 'center';
+    frozen: boolean;
+    offset: number;
+    editing: boolean;
+    draft: string;
+    text: string;
+}
+interface TableViewRow {
+    key: string;
+    id: string;
+    height: number;
+    width: number;
+    selected: boolean;
+    zebra: boolean;
+    hasGutter: boolean;
+    ordinal: string;
+    gutterWidth: number;
+    frozenCells: TableViewCell[];
+    cells: TableViewCell[];
+}
+interface TableViewPivotRow {
+    key: string;
+    label: string;
+    depth: number;
+    total: boolean;
+    cells: {
+        key: string;
+        text: string;
+    }[];
+}
+interface TableViewModel {
+    modes: {
+        label: string;
+        value: 'grid' | 'pivot';
+    }[];
+    mode: 'grid' | 'pivot';
+    partial: boolean;
+    loadingBadge: boolean;
+    prevDisabled: boolean;
+    nextDisabled: boolean;
+    idle: boolean;
+    failed: boolean;
+    failedTitle: string;
+    failedMessage?: string;
+    retryable: boolean;
+    failedNoRetry: boolean;
+    loading: boolean;
+    pivot: boolean;
+    pivotEmpty: boolean;
+    noRows: boolean;
+    grid: boolean;
+    width: number;
+    headerHeight: number;
+    frozenHeaders: TableViewHeaderCell[];
+    headers: TableViewHeaderCell[];
+    spacerWidth: number;
+    totalHeight: number;
+    offsetTop: number;
+    rows: TableViewRow[];
+    pivotHeads: {
+        key: string;
+        name: string;
+    }[];
+    pivotRows: TableViewPivotRow[];
+    footerShown: boolean;
+    countLabel: string;
+    selectedLabel?: string;
+}
+type TableUiIntent = {
+    kind: 'mode';
+    mode: 'grid' | 'pivot';
+} | {
+    kind: 'prev';
+} | {
+    kind: 'next';
+} | {
+    kind: 'refresh';
+} | {
+    kind: 'sort';
+    columnId: string;
+    shiftKey?: boolean;
+} | {
+    kind: 'rowClick';
+    id: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+} | {
+    kind: 'rowDouble';
+    id: string;
+} | {
+    kind: 'cellDouble';
+    rowId: string;
+    columnId: string;
+} | {
+    kind: 'draft';
+    value: string;
+} | {
+    kind: 'editKey';
+    key: string;
+} | {
+    kind: 'commitEdit';
+};
+/** Derive the view model from the live controller — the runtime calls this on every draw. */
+declare function tableViewState(c: TableController, options?: TableViewOptions): TableViewModel;
+/** Apply a `ui` intent to the controller — the runtime's half of the contract. */
+declare function applyTableUi(c: TableController, intent: TableUiIntent): void;
+declare const tableViewManifest: PanelManifest;
+declare const BEHAVIOURS$4: {
+    'data/tablePanelView': (inputs: Record<string, unknown>) => TableViewModel;
+};
+declare const TABLE_DECLARATION: BlockDeclaration;
+
+/**
+ * The Table panel view — the CODE VIEW of `TABLE_DECLARATION`, drawing the same {@link TableViewModel}
+ * byte-identical (the equivalence suite holds the two together). The one runtime-bound unit is the
+ * scroller (`table/Scroller`: the viewport both windows are computed from); every other intent goes
+ * through `applyTableUi`.
+ *
+ * Composes `@xenosystem/components/chrome` — the grid family for the grid, the pivot family for the
+ * cross-tab; only the scroller is local.
+ *
+ * @module
+ */
+
+/** Props for {@link TablePanelView}. */
+interface TablePanelViewProps extends TableViewOptions {
+    /** The controller. */
+    controller: TableController;
+}
 /** The Table panel view. */
-declare function TablePanelView({ controller, showRowNumbers, rowHeight, showFooter, zebra, }: TablePanelViewProps): ReactNode;
+declare function TablePanelView({ controller, ...options }: TablePanelViewProps): ReactNode;
+/**
+ * The scroller — `table/Scroller` in the declaration, bound to the controller: the viewport is
+ * MEASURED (ResizeObserver, sheets' Grid.tsx discipline), never assumed, so both windows are right
+ * on first paint and after every dock resize; the scroll offsets are reported both ways.
+ */
+declare function TableScroller({ controller, children }: {
+    controller: TableController;
+    children?: ReactNode;
+}): ReactNode;
+/** The unit names the runtime supplies for this block — what a host's registry check must accept beside the shared families. */
+declare const TABLE_RUNTIME_UNITS: readonly ["table/Scroller"];
+/** The units the runtime registers for `TABLE_DECLARATION`, bound to ITS controller. */
+declare function tableRuntimeComponents(controller: TableController): Record<(typeof TABLE_RUNTIME_UNITS)[number], React.ComponentType<any>>;
 
 /**
  * The `xeno.core.chart` contract.
@@ -3586,4 +3761,4 @@ interface ConnectorsPanelViewProps extends ConnectorsViewOptions {
 /** The Connectors panel view. */
 declare function ConnectorsPanelView({ controller, emptyHint }: ConnectorsPanelViewProps): ReactNode;
 
-export { AGENT_HIDDEN_COMMANDS, ALL_AGGREGATES, ALL_CHART_TYPES, type BuildChartOptions, type BuildSelectOptions, type BuildSelectResult, BEHAVIOURS$3 as CHART_BEHAVIOURS, CHART_DECLARATION, CHART_EMPTY_FILL, CHART_PALETTE_STEPS, CHART_PANEL_ID, CHART_RUNTIME_UNITS, CHART_TYPE_LABELS, BEHAVIOURS as CONNECTORS_BEHAVIOURS, CONNECTORS_DECLARATION, CONNECTORS_PANEL_ID, CONNECTORS_RUNTIME_UNITS, type CellAddress, ChartController, type ChartControllerOptions, type ChartHostBridge, type ChartPanelState, ChartPanelView, type ChartPanelViewProps, ChartPlot, type ChartRenderContext, type ChartRenderInput, type ChartRenderOptions, type ChartRenderer, type ChartUiIntent, type ChartViewModel, type ChartViewOptions, type ChartViewState, type ColumnLayout, type ColumnWindow, ConnectorExecuteInput, ConnectorExecuteOutput, ConnectorTransport, ConnectorsController, type ConnectorsControllerOptions, type ConnectorsHostBridge, ConnectorsPanelState, ConnectorsPanelView, type ConnectorsPanelViewProps, type ConnectorsRenderContext, type ConnectorsUiIntent, type ConnectorsViewField, type ConnectorsViewModel, type ConnectorsViewOptions, type ConnectorsViewSource, ConnectorsViewState, type CreateChartPanelOptions, type CreateConnectorExecutorOptions, type CreateConnectorsPanelOptions, type CreateFieldsPanelOptions, type CreateMetricsPanelOptions, type CreateTablePanelOptions, type CredentialDraft, type CredentialErrors, DEFAULT_CHART_OPTIONS, DEFAULT_COLUMN_WIDTH, DEFAULT_PAGE_SIZE, DEFAULT_RANGES, type DeltaDirection, EMPTY_LAYOUT, EXPIRY_SKEW_MS, type ExecuteError, BEHAVIOURS$1 as FIELDS_BEHAVIOURS, FIELDS_DECLARATION, FIELDS_PANEL_ID, FIELDS_RUNTIME_UNITS, FieldsController, type FieldsControllerOptions, type FieldsHostBridge, type FieldsPanelState, FieldsPanelView, type FieldsPanelViewProps, type FieldsRenderContext, type FieldsUiIntent, type FieldsViewColumn, type FieldsViewEntry, type FieldsViewFilter, type FieldsViewModel, type FieldsViewOptions, type FieldsViewShelf, type FieldsViewState, type HostSqlResolver, IMPLEMENTED_VIEW_MODES, type LoopbackRequest, type LoopbackVerdict, BEHAVIOURS$2 as METRICS_BEHAVIOURS, METRICS_DECLARATION, METRICS_PANEL_ID, METRICS_RUNTIME_UNITS, MIN_COLUMN_WIDTH, MONO_FILL_PALETTE, MONO_PALETTE, MetricsController, type MetricsControllerOptions, type MetricsHostBridge, type MetricsPanelState, MetricsPanelView, type MetricsPanelViewProps, type MetricsRenderContext, type MetricsUiIntent, type MetricsViewModel, type MetricsViewOptions, type MetricsViewState, type MetricsViewTile, type NumericConstraints, type OAuthStateRecord, type OAuthStateStore, type OAuthStateStoreOptions, type ParseCsvOptions, type ParseResult, type ParsedCsv, type PkcePair, PushdownSplit, type RefreshCoordinator, type ResolvedColumn, SHELF_PRESETS, type StoredOAuthToken, SubstrateFacilities, TABLE_PANEL_ID, TableController, type TableControllerOptions, type TableHostBridge, type TablePanelState, TablePanelView, type TablePanelViewProps, type TableRenderContext, type TableViewMode, type TableViewState, type TokenEndpointResponse, type VirtualWindow, type XenoAlertLevel, type XenoCalculatedFieldRequest, type XenoCellEdit, type XenoChartData, type XenoChartDrillDown, type XenoChartEncoding, type XenoChartExportRequest, type XenoChartHighlight, type XenoChartSeries, type XenoChartType, XenoConnection, XenoConnectionStatus, XenoConnectorFetch, XenoConnectorFileReader, XenoConnectorQueryRequest, XenoCredentialField, XenoCredentialFormSpec, XenoCredentialResult, type XenoFieldStat, type XenoMetricAlert, type XenoMetricRange, type XenoMetricSpec, type XenoMetricThreshold, type XenoMetricValue, XenoResolverErrorCode, XenoRestPaging, type XenoRowActivate, type XenoShelfEntry, type XenoShelfSpec, XenoSqlEngine, applyChartUi, applyConnectorsUi, applyFieldsUi, applyMetricsUi, applyPrecision, base64Url, breachSideOf, buildChartData, buildRestUrl, buildSelect, chartManifest, chartPanel, chartRuntimeComponents, chartViewManifest, chartViewState, clamp, classifyHttpStatus, coerceCsvValues, columnIndexAt, columnsOf, compileForHost, computeColumnWindow, computeWindow, connectorsManifest, connectorsPanel, connectorsViewManifest, connectorsViewState, constraintsOfColumn, createChartPanel, createConnectorExecutor, createConnectorsPanel, createFieldsPanel, createMetricsPanel, createOAuthStateStore, createPkcePair, createRefreshCoordinator, createTablePanel, credentialSpecProblem, defaultAggregateFor, defaultEncoding, deltaToneOf, emptyFilterGroup, entityOf, escapeLikePattern, executeCsvFile, executeDuckDb, executeGraphql, executeJsonFile, executeRest, executeSql, extractJsonPath, extractRows, fieldsManifest, fieldsPanel, fieldsViewManifest, fieldsViewState, firstGraphqlError, frozenWidth, getChartRenderer, isCategorical, isFieldVisible, isFilled, isLeafFilter, isLoopbackHost, isSafeTableName, mergeRefreshResponse, metricsManifest, metricsPanel, metricsViewManifest, metricsViewState, moveCell, moveColumn, needsRefresh, nextPageToken, normalizeLayout, normalizeNumeric, offerableAggregates, offerableFilterOps, parseCsv, parseJsonBody, parseJsonPath, parseLinkHeader, parseNumeric, pruneHiddenValues, queriesEqual, quoteIdent, quoteLiteral, redirectUriFor, renderFilterGroup, resolveChartColors, resolveColumns, rowsForMark, scrollLeftToReveal, scrollTopToReveal, setChartRenderer, setColumnVisible, setColumnWidth, setFrozenCount, sniffDelimiter, suggestedShelfFor, tableManifest, tablePanel, toChartJsConfig, toExecuteError, totalWidth, uniqueTableName, unsupportedMessage, validateCredentialDraft, validateEncoding, validateLoopbackRequest, visibleFields };
+export { AGENT_HIDDEN_COMMANDS, ALL_AGGREGATES, ALL_CHART_TYPES, type BuildChartOptions, type BuildSelectOptions, type BuildSelectResult, BEHAVIOURS$3 as CHART_BEHAVIOURS, CHART_DECLARATION, CHART_EMPTY_FILL, CHART_PALETTE_STEPS, CHART_PANEL_ID, CHART_RUNTIME_UNITS, CHART_TYPE_LABELS, BEHAVIOURS as CONNECTORS_BEHAVIOURS, CONNECTORS_DECLARATION, CONNECTORS_PANEL_ID, CONNECTORS_RUNTIME_UNITS, type CellAddress, ChartController, type ChartControllerOptions, type ChartHostBridge, type ChartPanelState, ChartPanelView, type ChartPanelViewProps, ChartPlot, type ChartRenderContext, type ChartRenderInput, type ChartRenderOptions, type ChartRenderer, type ChartUiIntent, type ChartViewModel, type ChartViewOptions, type ChartViewState, type ColumnLayout, type ColumnWindow, ConnectorExecuteInput, ConnectorExecuteOutput, ConnectorTransport, ConnectorsController, type ConnectorsControllerOptions, type ConnectorsHostBridge, ConnectorsPanelState, ConnectorsPanelView, type ConnectorsPanelViewProps, type ConnectorsRenderContext, type ConnectorsUiIntent, type ConnectorsViewField, type ConnectorsViewModel, type ConnectorsViewOptions, type ConnectorsViewSource, ConnectorsViewState, type CreateChartPanelOptions, type CreateConnectorExecutorOptions, type CreateConnectorsPanelOptions, type CreateFieldsPanelOptions, type CreateMetricsPanelOptions, type CreateTablePanelOptions, type CredentialDraft, type CredentialErrors, DEFAULT_CHART_OPTIONS, DEFAULT_COLUMN_WIDTH, DEFAULT_PAGE_SIZE, DEFAULT_RANGES, type DeltaDirection, EMPTY_LAYOUT, EXPIRY_SKEW_MS, type ExecuteError, BEHAVIOURS$1 as FIELDS_BEHAVIOURS, FIELDS_DECLARATION, FIELDS_PANEL_ID, FIELDS_RUNTIME_UNITS, FieldsController, type FieldsControllerOptions, type FieldsHostBridge, type FieldsPanelState, FieldsPanelView, type FieldsPanelViewProps, type FieldsRenderContext, type FieldsUiIntent, type FieldsViewColumn, type FieldsViewEntry, type FieldsViewFilter, type FieldsViewModel, type FieldsViewOptions, type FieldsViewShelf, type FieldsViewState, type HostSqlResolver, IMPLEMENTED_VIEW_MODES, type LoopbackRequest, type LoopbackVerdict, BEHAVIOURS$2 as METRICS_BEHAVIOURS, METRICS_DECLARATION, METRICS_PANEL_ID, METRICS_RUNTIME_UNITS, MIN_COLUMN_WIDTH, MONO_FILL_PALETTE, MONO_PALETTE, MetricsController, type MetricsControllerOptions, type MetricsHostBridge, type MetricsPanelState, MetricsPanelView, type MetricsPanelViewProps, type MetricsRenderContext, type MetricsUiIntent, type MetricsViewModel, type MetricsViewOptions, type MetricsViewState, type MetricsViewTile, type NumericConstraints, type OAuthStateRecord, type OAuthStateStore, type OAuthStateStoreOptions, type ParseCsvOptions, type ParseResult, type ParsedCsv, type PkcePair, PushdownSplit, type RefreshCoordinator, type ResolvedColumn, SHELF_PRESETS, type StoredOAuthToken, SubstrateFacilities, BEHAVIOURS$4 as TABLE_BEHAVIOURS, TABLE_DECLARATION, TABLE_PANEL_ID, TABLE_RUNTIME_UNITS, TableController, type TableControllerOptions, type TableHostBridge, type TablePanelState, TablePanelView, type TablePanelViewProps, type TableRenderContext, TableScroller, type TableUiIntent, type TableViewCell, type TableViewHeaderCell, type TableViewMode, type TableViewModel, type TableViewOptions, type TableViewPivotRow, type TableViewRow, type TableViewState, type TokenEndpointResponse, type VirtualWindow, type XenoAlertLevel, type XenoCalculatedFieldRequest, type XenoCellEdit, type XenoChartData, type XenoChartDrillDown, type XenoChartEncoding, type XenoChartExportRequest, type XenoChartHighlight, type XenoChartSeries, type XenoChartType, XenoConnection, XenoConnectionStatus, XenoConnectorFetch, XenoConnectorFileReader, XenoConnectorQueryRequest, XenoCredentialField, XenoCredentialFormSpec, XenoCredentialResult, type XenoFieldStat, type XenoMetricAlert, type XenoMetricRange, type XenoMetricSpec, type XenoMetricThreshold, type XenoMetricValue, XenoResolverErrorCode, XenoRestPaging, type XenoRowActivate, type XenoShelfEntry, type XenoShelfSpec, XenoSqlEngine, applyChartUi, applyConnectorsUi, applyFieldsUi, applyMetricsUi, applyPrecision, applyTableUi, base64Url, breachSideOf, buildChartData, buildRestUrl, buildSelect, chartManifest, chartPanel, chartRuntimeComponents, chartViewManifest, chartViewState, clamp, classifyHttpStatus, coerceCsvValues, columnIndexAt, columnsOf, compileForHost, computeColumnWindow, computeWindow, connectorsManifest, connectorsPanel, connectorsViewManifest, connectorsViewState, constraintsOfColumn, createChartPanel, createConnectorExecutor, createConnectorsPanel, createFieldsPanel, createMetricsPanel, createOAuthStateStore, createPkcePair, createRefreshCoordinator, createTablePanel, credentialSpecProblem, defaultAggregateFor, defaultEncoding, deltaToneOf, emptyFilterGroup, entityOf, escapeLikePattern, executeCsvFile, executeDuckDb, executeGraphql, executeJsonFile, executeRest, executeSql, extractJsonPath, extractRows, fieldsManifest, fieldsPanel, fieldsViewManifest, fieldsViewState, firstGraphqlError, frozenWidth, getChartRenderer, isCategorical, isFieldVisible, isFilled, isLeafFilter, isLoopbackHost, isSafeTableName, mergeRefreshResponse, metricsManifest, metricsPanel, metricsViewManifest, metricsViewState, moveCell, moveColumn, needsRefresh, nextPageToken, normalizeLayout, normalizeNumeric, offerableAggregates, offerableFilterOps, parseCsv, parseJsonBody, parseJsonPath, parseLinkHeader, parseNumeric, pruneHiddenValues, queriesEqual, quoteIdent, quoteLiteral, redirectUriFor, renderFilterGroup, resolveChartColors, resolveColumns, rowsForMark, scrollLeftToReveal, scrollTopToReveal, setChartRenderer, setColumnVisible, setColumnWidth, setFrozenCount, sniffDelimiter, suggestedShelfFor, tableManifest, tablePanel, tableRuntimeComponents, tableViewManifest, tableViewState, toChartJsConfig, toExecuteError, totalWidth, uniqueTableName, unsupportedMessage, validateCredentialDraft, validateEncoding, validateLoopbackRequest, visibleFields };