@ai-matrx/records-ui 0.28.0 → 0.30.0

package/dist/index.d.cts

@@ -5,7 +5,7 @@ import { Uuid, Field as Field$1, ReadRow as ReadRow$1 } from '@ai-matrx/records/
 import { RecordsClient } from '@ai-matrx/records/core';
 import { FieldFormatConfig } from '@ai-matrx/design-system/field-formats';
 import { MatrxColumnDef } from '@ai-matrx/design-system/data-table/types';
-import { TableStyle, ChoiceColorLookup } from '@ai-matrx/design-system/data-table';
+import { TableStyle, GroupAggregateSpec, GroupOrder, ChoiceColorLookup } from '@ai-matrx/design-system/data-table';
 
 /** The six things a person does to a record or a table, as the screens offer them. */
 type Capability = "read" | "comment" | "write" | "remove" | "share" | "structure";
@@ -649,6 +649,33 @@ declare function RefusalLine({ error, className }: {
  * has ever styled still shows `$1,250.50` and `45%`.
  */
 
+/**
+ * SECTIONS BY A FIELD — the view's own grouping.
+ *
+ * `field` is a Field KEY, exactly like `frozen` and the keys of `formats`,
+ * because a view is written against the Table's declaration and never against
+ * whatever id a screen happened to build its columns with.
+ *
+ * `aggregates` is keyed by Field key too, and `collapsed` holds the data
+ * table's own group keys (`s:Blocked`, `n:3`, `empty`), which is what the
+ * primitive emits and the only thing that survives a value rendering the same
+ * text as another.
+ *
+ * NOTHING HERE IS EVER CALLED `valueOf`, `toString` or `hasOwnProperty`: every
+ * object in JavaScript already has all three, so an optional field by one of
+ * those names is NEVER absent and a `config.valueOf ? … : …` check silently
+ * reads `Object.prototype`. It cost the primitive a whole grouping once.
+ */
+type GridGrouping = {
+    /** The Field key whose value makes the sections. */
+    field: string;
+    /** Per-Field-key subtotal on every section header. */
+    aggregates?: Record<string, GroupAggregateSpec>;
+    /** Section order. The primitive's default is `value-asc`; blanks sort last. */
+    order?: GroupOrder;
+    /** The sections this view keeps shut, by the primitive's own group key. */
+    collapsed?: string[];
+};
 /** Everything a view says about how its table LOOKS. */
 type GridPresentation = {
     /** Color-by-a-column, rules and manual highlights. */
@@ -662,10 +689,29 @@ type GridPresentation = {
      * guessed offset.
      */
     frozen?: string[];
+    /** Collapsible sections by one Field, with subtotals on each header. */
+    grouping?: GridGrouping;
+    /**
+     * The width a person dragged a column to, by Field key. SPARSE on purpose —
+     * a view saved before widths existed carries none and still parses, and a
+     * column nobody resized is left to the table's own measurement.
+     */
+    widths?: Record<string, number>;
+    /** The body row height this view remembers, in px. */
+    rowHeight?: number;
 };
 declare const EMPTY_PRESENTATION: GridPresentation;
 /** A frozen column needs a known width, or the table declines to freeze at all. */
 declare const FROZEN_COLUMN_WIDTH = 200;
+/**
+ * WHAT A ROW HEIGHT IS ALLOWED TO BE. Below the floor the text is clipped and
+ * no editor fits; above the ceiling one record fills the screen. A view asking
+ * for anything outside it is DROPPED rather than obeyed, because a saved look
+ * must not be able to make a table unreadable — and the Fields' own heights
+ * still draw, which is the tolerant half.
+ */
+declare const MIN_ROW_HEIGHT = 24;
+declare const MAX_ROW_HEIGHT = 96;
 /**
  * Read a presentation out of whatever the view record holds — an object, or the
  * JSON string a text field stores.
@@ -737,9 +783,26 @@ interface GridProps {
      * override, never the only thing that makes a column readable.
      */
     presentation?: GridPresentation | undefined;
+    /**
+     * THE LOOK, WRITTEN BACK. Called with the WHOLE next look when the person
+     * changes one on the table itself — picks a column to group by, shuts a
+     * section, drags a column wider.
+     *
+     * It is the same door every other view change already uses: `ViewSwitcher`
+     * folds it into its `onViewChange` patch and `TablePage` writes that patch
+     * onto the view record with `client.recordUpdate`, carrying the version it
+     * read. The Grid has no view id and must not grow one — a component that
+     * wrote to a record it was never told about would be a second, parallel way
+     * to save a view.
+     *
+     * UNBOUND, NOTHING IS DEAD. A host that binds no door still gets grouping,
+     * collapsing and resizing for this visit — they are held in the grid's own
+     * state — they are simply not remembered.
+     */
+    onPresentationChange?: ((next: GridPresentation) => void) | undefined;
     className?: string | undefined;
 }
-declare function Grid({ tableId, pageSize, onOpenRecord, onAddField, onNewRecordForm, toolbarActions, editable, presentation, className, }: GridProps): react.JSX.Element;
+declare function Grid({ tableId, pageSize, onOpenRecord, onAddField, onNewRecordForm, toolbarActions, editable, presentation, onPresentationChange, className, }: GridProps): react.JSX.Element;
 /**
  * One Field becomes one column. The header is the Field's own NAME — never its
  * key (`names.ts`) — and the cell is the value, rendered by its parity type and
@@ -2165,4 +2228,4 @@ declare function useCanShare(): boolean;
 declare function shareUnavailableReason(): string;
 declare function ShareControl({ kind, organizationId, subjectId, name, may, size, variant, className, }: ShareControlProps): ReactNode;
 
-export { ACTION_KINDS, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type Capability, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, type FieldTypeChoice, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, Grid, GridCell, type GridEditing, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, MACHINE_IDENTITY, NOT_ANSWERED_YET, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, SubscriptionsPanel, type SubscriptionsPanelProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, type WhatYouMayDo, addFields, blockFromSpec, bodyForReading, bodyFromKeys, colorFromTheValue, columnForField, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isId, isMachineIdentity, isPlainFieldType, isSignatureField, keyFor, laneFor, machineIdentityIn, memberName, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, recordName, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, tableName, tableRightsAt, tokenFor, useCanShare, useEmbedHandshake, useGridEditing, useMeasuredWidth, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable };
+export { ACTION_KINDS, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type Capability, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, type FieldTypeChoice, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, NOT_ANSWERED_YET, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, SubscriptionsPanel, type SubscriptionsPanelProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, type WhatYouMayDo, addFields, blockFromSpec, bodyForReading, bodyFromKeys, colorFromTheValue, columnForField, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isId, isMachineIdentity, isPlainFieldType, isSignatureField, keyFor, laneFor, machineIdentityIn, memberName, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, recordName, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, tableName, tableRightsAt, tokenFor, useCanShare, useEmbedHandshake, useGridEditing, useMeasuredWidth, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable };

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { Uuid, Field as Field$1, ReadRow as ReadRow$1 } from '@ai-matrx/records/
 import { RecordsClient } from '@ai-matrx/records/core';
 import { FieldFormatConfig } from '@ai-matrx/design-system/field-formats';
 import { MatrxColumnDef } from '@ai-matrx/design-system/data-table/types';
-import { TableStyle, ChoiceColorLookup } from '@ai-matrx/design-system/data-table';
+import { TableStyle, GroupAggregateSpec, GroupOrder, ChoiceColorLookup } from '@ai-matrx/design-system/data-table';
 
 /** The six things a person does to a record or a table, as the screens offer them. */
 type Capability = "read" | "comment" | "write" | "remove" | "share" | "structure";
@@ -649,6 +649,33 @@ declare function RefusalLine({ error, className }: {
  * has ever styled still shows `$1,250.50` and `45%`.
  */
 
+/**
+ * SECTIONS BY A FIELD — the view's own grouping.
+ *
+ * `field` is a Field KEY, exactly like `frozen` and the keys of `formats`,
+ * because a view is written against the Table's declaration and never against
+ * whatever id a screen happened to build its columns with.
+ *
+ * `aggregates` is keyed by Field key too, and `collapsed` holds the data
+ * table's own group keys (`s:Blocked`, `n:3`, `empty`), which is what the
+ * primitive emits and the only thing that survives a value rendering the same
+ * text as another.
+ *
+ * NOTHING HERE IS EVER CALLED `valueOf`, `toString` or `hasOwnProperty`: every
+ * object in JavaScript already has all three, so an optional field by one of
+ * those names is NEVER absent and a `config.valueOf ? … : …` check silently
+ * reads `Object.prototype`. It cost the primitive a whole grouping once.
+ */
+type GridGrouping = {
+    /** The Field key whose value makes the sections. */
+    field: string;
+    /** Per-Field-key subtotal on every section header. */
+    aggregates?: Record<string, GroupAggregateSpec>;
+    /** Section order. The primitive's default is `value-asc`; blanks sort last. */
+    order?: GroupOrder;
+    /** The sections this view keeps shut, by the primitive's own group key. */
+    collapsed?: string[];
+};
 /** Everything a view says about how its table LOOKS. */
 type GridPresentation = {
     /** Color-by-a-column, rules and manual highlights. */
@@ -662,10 +689,29 @@ type GridPresentation = {
      * guessed offset.
      */
     frozen?: string[];
+    /** Collapsible sections by one Field, with subtotals on each header. */
+    grouping?: GridGrouping;
+    /**
+     * The width a person dragged a column to, by Field key. SPARSE on purpose —
+     * a view saved before widths existed carries none and still parses, and a
+     * column nobody resized is left to the table's own measurement.
+     */
+    widths?: Record<string, number>;
+    /** The body row height this view remembers, in px. */
+    rowHeight?: number;
 };
 declare const EMPTY_PRESENTATION: GridPresentation;
 /** A frozen column needs a known width, or the table declines to freeze at all. */
 declare const FROZEN_COLUMN_WIDTH = 200;
+/**
+ * WHAT A ROW HEIGHT IS ALLOWED TO BE. Below the floor the text is clipped and
+ * no editor fits; above the ceiling one record fills the screen. A view asking
+ * for anything outside it is DROPPED rather than obeyed, because a saved look
+ * must not be able to make a table unreadable — and the Fields' own heights
+ * still draw, which is the tolerant half.
+ */
+declare const MIN_ROW_HEIGHT = 24;
+declare const MAX_ROW_HEIGHT = 96;
 /**
  * Read a presentation out of whatever the view record holds — an object, or the
  * JSON string a text field stores.
@@ -737,9 +783,26 @@ interface GridProps {
      * override, never the only thing that makes a column readable.
      */
     presentation?: GridPresentation | undefined;
+    /**
+     * THE LOOK, WRITTEN BACK. Called with the WHOLE next look when the person
+     * changes one on the table itself — picks a column to group by, shuts a
+     * section, drags a column wider.
+     *
+     * It is the same door every other view change already uses: `ViewSwitcher`
+     * folds it into its `onViewChange` patch and `TablePage` writes that patch
+     * onto the view record with `client.recordUpdate`, carrying the version it
+     * read. The Grid has no view id and must not grow one — a component that
+     * wrote to a record it was never told about would be a second, parallel way
+     * to save a view.
+     *
+     * UNBOUND, NOTHING IS DEAD. A host that binds no door still gets grouping,
+     * collapsing and resizing for this visit — they are held in the grid's own
+     * state — they are simply not remembered.
+     */
+    onPresentationChange?: ((next: GridPresentation) => void) | undefined;
     className?: string | undefined;
 }
-declare function Grid({ tableId, pageSize, onOpenRecord, onAddField, onNewRecordForm, toolbarActions, editable, presentation, className, }: GridProps): react.JSX.Element;
+declare function Grid({ tableId, pageSize, onOpenRecord, onAddField, onNewRecordForm, toolbarActions, editable, presentation, onPresentationChange, className, }: GridProps): react.JSX.Element;
 /**
  * One Field becomes one column. The header is the Field's own NAME — never its
  * key (`names.ts`) — and the cell is the value, rendered by its parity type and
@@ -2165,4 +2228,4 @@ declare function useCanShare(): boolean;
 declare function shareUnavailableReason(): string;
 declare function ShareControl({ kind, organizationId, subjectId, name, may, size, variant, className, }: ShareControlProps): ReactNode;
 
-export { ACTION_KINDS, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type Capability, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, type FieldTypeChoice, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, Grid, GridCell, type GridEditing, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, MACHINE_IDENTITY, NOT_ANSWERED_YET, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, SubscriptionsPanel, type SubscriptionsPanelProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, type WhatYouMayDo, addFields, blockFromSpec, bodyForReading, bodyFromKeys, colorFromTheValue, columnForField, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isId, isMachineIdentity, isPlainFieldType, isSignatureField, keyFor, laneFor, machineIdentityIn, memberName, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, recordName, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, tableName, tableRightsAt, tokenFor, useCanShare, useEmbedHandshake, useGridEditing, useMeasuredWidth, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable };
+export { ACTION_KINDS, ActionInbox, type ActionInboxProps, type ActionKind, BookingSlots, type BookingSlotsProps, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_TABLE, COMMENT_TABLE, type Capability, type CaptureMode, type CaptureQueuePort, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, type ChecklistSpec, type ChecklistStepSpec, CommentThread, type CommentThreadProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldLabel, type FieldProposalRow, type FieldTypeChoice, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, NOT_ANSWERED_YET, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PARITY_LABEL, PARITY_MADE_OF, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, RefusalLine, RefusalNotice, RelationPicker, type RelationPickerProps, SERIES_COLORS, STORE_DECIDES_REASON, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, SubscriptionsPanel, type SubscriptionsPanelProps, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, type WhatYouMayDo, addFields, blockFromSpec, bodyForReading, bodyFromKeys, colorFromTheValue, columnForField, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isId, isMachineIdentity, isPlainFieldType, isSignatureField, keyFor, laneFor, machineIdentityIn, memberName, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, recordName, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, tableName, tableRightsAt, tokenFor, useCanShare, useEmbedHandshake, useGridEditing, useMeasuredWidth, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable };

package/dist/index.js

@@ -1706,6 +1706,27 @@ import {
 } from "@ai-matrx/design-system/data-table";
 var EMPTY_PRESENTATION = {};
 var FROZEN_COLUMN_WIDTH = 200;
+var MIN_ROW_HEIGHT = 24;
+var MAX_ROW_HEIGHT = 96;
+var AGGREGATE_KINDS = [
+  "count",
+  "sum",
+  "average",
+  "min",
+  "max",
+  "empty",
+  "filled",
+  "unique",
+  "checked",
+  "unchecked",
+  "percentFilled"
+];
+var GROUP_ORDERS = [
+  "value-asc",
+  "value-desc",
+  "count-desc",
+  "first-seen"
+];
 function isRecord(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
@@ -1742,10 +1763,51 @@ function parseGridPresentation(raw) {
     const frozen = value["frozen"].filter((k) => typeof k === "string");
     if (frozen.length > 0) out.frozen = frozen;
   }
+  const grouping = parseGrouping(value["grouping"]);
+  if (grouping) out.grouping = grouping;
+  if (isRecord(value["widths"])) {
+    const widths = {};
+    for (const [key, raw2] of Object.entries(value["widths"])) {
+      if (typeof raw2 !== "number" || !Number.isFinite(raw2) || raw2 <= 0) continue;
+      widths[key] = Math.round(raw2);
+    }
+    if (Object.keys(widths).length > 0) out.widths = widths;
+  }
+  const rowHeight = value["rowHeight"];
+  if (typeof rowHeight === "number" && Number.isFinite(rowHeight) && rowHeight >= MIN_ROW_HEIGHT && rowHeight <= MAX_ROW_HEIGHT) {
+    out.rowHeight = Math.round(rowHeight);
+  }
+  return out;
+}
+function parseGrouping(raw) {
+  if (!isRecord(raw)) return void 0;
+  const field = raw["field"];
+  if (typeof field !== "string" || field.trim() === "") return void 0;
+  const out = { field };
+  if (isRecord(raw["aggregates"])) {
+    const aggregates = {};
+    for (const [key, spec] of Object.entries(raw["aggregates"])) {
+      if (!isRecord(spec)) continue;
+      const kind = spec["kind"];
+      if (typeof kind !== "string") continue;
+      if (!AGGREGATE_KINDS.includes(kind)) continue;
+      const label = spec["label"];
+      aggregates[key] = typeof label === "string" ? { kind, label } : { kind };
+    }
+    if (Object.keys(aggregates).length > 0) out.aggregates = aggregates;
+  }
+  const order = raw["order"];
+  if (typeof order === "string" && GROUP_ORDERS.includes(order)) {
+    out.order = order;
+  }
+  if (Array.isArray(raw["collapsed"])) {
+    const collapsed = raw["collapsed"].filter((k) => typeof k === "string");
+    if (collapsed.length > 0) out.collapsed = collapsed;
+  }
   return out;
 }
 function presentationIsEmpty(p) {
-  return (p.style === void 0 || tableStyleIsEmpty(p.style)) && Object.keys(p.formats ?? {}).length === 0 && (p.frozen?.length ?? 0) === 0;
+  return (p.style === void 0 || tableStyleIsEmpty(p.style)) && Object.keys(p.formats ?? {}).length === 0 && (p.frozen?.length ?? 0) === 0 && p.grouping === void 0 && Object.keys(p.widths ?? {}).length === 0 && p.rowHeight === void 0;
 }
 function presentationDocument(p) {
   return presentationIsEmpty(p) ? "" : JSON.stringify(p);
@@ -1816,6 +1878,7 @@ function Grid({
   toolbarActions,
   editable = true,
   presentation = EMPTY_PRESENTATION,
+  onPresentationChange,
   className
 }) {
   const host = useRecordsUi();
@@ -1867,6 +1930,67 @@ function Grid({
     ),
     [ordered, canWrite, editing, mayWriteRow, whyNotRow, presentation.formats, frozenKeys]
   );
+  const columnIds = useMemo6(() => ordered.map((field) => field.key), [ordered]);
+  const [localColumns, setLocalColumns] = useState6(
+    null
+  );
+  const [localWidths, setLocalWidths] = useState6(null);
+  const writeLook = useCallback4(
+    (next) => onPresentationChange?.(next),
+    [onPresentationChange]
+  );
+  const widths = localWidths ?? presentation.widths;
+  const columnState = useMemo6(
+    () => ({
+      order: localColumns?.order ?? columnIds,
+      hidden: localColumns?.hidden ?? [],
+      onChange: (next) => setLocalColumns(next),
+      ...widths ? { widths } : {},
+      // A drag that changed nothing would be the silent half of a control that
+      // looks alive, so the width always lands somewhere — the session at
+      // least, the view record when a door is bound.
+      onWidthsChange: (next) => {
+        setLocalWidths(next);
+        writeLook({ ...presentation, widths: next });
+      }
+    }),
+    [columnIds, localColumns, widths, presentation, writeLook]
+  );
+  const groupingConfig = useMemo6(() => {
+    const view = presentation.grouping;
+    const field = view?.field ?? null;
+    if (field === null && !onPresentationChange) return null;
+    const aggregates = view && Object.keys(view.aggregates ?? {}).length > 0 ? view.aggregates : field ? { [field]: { kind: "count" } } : void 0;
+    return {
+      columnId: field,
+      rowNoun: "record",
+      ...aggregates ? { aggregates } : {},
+      ...view?.order ? { order: view.order } : {},
+      ...view?.collapsed ? { collapsed: view.collapsed } : {},
+      ...onPresentationChange ? {
+        onColumnIdChange: (columnId) => {
+          if (columnId === null) {
+            const { grouping: _dropped, ...rest } = presentation;
+            writeLook(rest);
+            return;
+          }
+          writeLook({
+            ...presentation,
+            grouping: {
+              field: columnId,
+              ...presentation.grouping?.aggregates ? { aggregates: presentation.grouping.aggregates } : {},
+              ...presentation.grouping?.order ? { order: presentation.grouping.order } : {}
+            }
+          });
+        },
+        onCollapsedChange: (collapsed) => {
+          const current = presentation.grouping;
+          if (!current) return;
+          writeLook({ ...presentation, grouping: { ...current, collapsed } });
+        }
+      } : {}
+    };
+  }, [presentation, onPresentationChange, writeLook]);
   if (table.error) return /* @__PURE__ */ jsx9(RefusalNotice, { error: table.error, className });
   if (fields.error) return /* @__PURE__ */ jsx9(RefusalNotice, { error: fields.error, className });
   const nothingToShowYet = table.loading || fields.loading || !rights.known || records.loading && rows.length === 0;
@@ -1930,6 +2054,15 @@ function Grid({
           pageSize,
           detail: { enabled: false },
           window: { enabled: false },
+          ...groupingConfig ? { grouping: groupingConfig } : {},
+          columnState,
+          ...presentation.rowHeight ? { rowHeight: presentation.rowHeight } : {},
+          virtualize: true,
+          coverage: {
+            answeredBy: "client",
+            noun: "record",
+            ...typeof records.data?.total === "number" ? { total: records.data.total } : {}
+          },
           ...presentation.style ? {
             tableStyle: {
               style: presentation.style,
@@ -3850,6 +3983,7 @@ function ViewSwitcher({
         tableId: view.subject,
         pageSize,
         ...local.presentation ?? view.presentation ? { presentation: local.presentation ?? view.presentation } : {},
+        ...onViewChange ? { onPresentationChange: (next) => change({ presentation: next }) } : {},
         ...onOpenRecord ? { onOpenRecord } : {},
         ...onNewRecordForm ? { onNewRecordForm } : {}
       }
@@ -6712,10 +6846,13 @@ function NotifyRuleEditor({ tableId, seed, className }) {
   const [busy, setBusy] = useState30(false);
   const load = useCallback17(async () => {
     const [held, offered] = await Promise.all([
-      client.aggSubscriptions(),
+      // THE PERSON'S OWN DOOR, not the notifier's. It answers what is addressed
+      // to them plus — only where they hold admin on this Table — anyone's over
+      // it, and it is narrowed to Tables they can already open.
+      client.subscriptions({ table_id: tableId }),
       // The cadences are ASKED of the store, never a list typed into a picker
       // here that could drift from what the digest runner understands.
-      client.aggSubscriptionCadences()
+      client.subscriptionCadences()
     ]);
     if (!held.ok) {
       setError(held.error);
@@ -6726,7 +6863,7 @@ function NotifyRuleEditor({ tableId, seed, className }) {
     if (offered.ok) setCadences(offered.data);
     if (host.savedViews) setViews(await host.savedViews());
     else setViews(null);
-  }, [client, host]);
+  }, [client, host, tableId]);
   useEffect21(() => {
     void load();
   }, [load]);
@@ -6816,6 +6953,7 @@ function NotifyRuleEditor({ tableId, seed, className }) {
       held.cadence === "digest" && held.schedule ? /* @__PURE__ */ jsx32("span", { className: "text-muted-foreground", children: held.schedule }) : null,
       held.recipient_user_id === null ? /* @__PURE__ */ jsx32("span", { className: "text-destructive", children: "This one has nobody to tell, so it fires at nobody." }) : null,
       held.saved_view_id === null ? /* @__PURE__ */ jsx32("span", { className: "text-destructive", children: "This one names no view, so the store never admits a record to it." }) : null,
+      held.muted ? /* @__PURE__ */ jsx32("span", { className: "text-muted-foreground", children: "Switched off \u2014 it tells nobody until somebody switches it back on." }) : null,
       rights.write ? /* @__PURE__ */ jsx32(
         Button27,
         {
@@ -9337,6 +9475,8 @@ export {
   LAYOUT_NO_FIELD,
   LEVEL_WORD,
   MACHINE_IDENTITY,
+  MAX_ROW_HEIGHT,
+  MIN_ROW_HEIGHT,
   NOT_ANSWERED_YET,
   NO_CHAT_REASON,
   NO_COLUMNS_WHY,