@happyvertical/smrt-ui 0.42.6 → 0.42.7

package/dist/components/data/data-surface.d.ts

@@ -28,12 +28,40 @@ export interface DataSurfaceIdentity {
     subject?: DataSurfaceSubject;
 }
 export type DataSurfaceColumnCapability = 'read' | 'search' | 'filter' | 'sort' | 'project';
+/** Presentation tier emitted by policy-aware domain adapters. */
+export type DataSurfaceColumnVisibility = 'basic' | 'advanced' | 'hidden';
+/** A domain-neutral column role. Adapters use roles to protect structural columns. */
+export type DataSurfaceColumnRole = 'data' | 'status' | 'computed' | 'row-key' | 'selection' | 'action';
+/** Operator allowlists are intentionally strings: #2444 owns query semantics. */
+export interface DataSurfaceColumnOperators {
+    search?: string[];
+    filter?: string[];
+    sort?: string[];
+}
 export interface DataSurfaceColumnDescriptor {
     id: string;
     label: string;
     description?: string;
     sensitivity?: DataSurfaceSensitivity;
     capabilities: DataSurfaceColumnCapability[];
+    /** Domain field identity; never accepted as a request path. */
+    fieldName?: string;
+    /** Effective policy visibility, when a domain adapter supplies one. */
+    visibility?: DataSurfaceColumnVisibility;
+    /** Stable policy order; domain column ids remain unchanged. */
+    order?: number;
+    /** Structural columns are preserved even when field policy narrows data columns. */
+    role?: DataSurfaceColumnRole;
+    /** Responsive adapters consume this without importing DataTable types. */
+    responsivePriority?: number;
+    /** Per-operation operator allowlists, narrowed by policy adapters. */
+    operators?: DataSurfaceColumnOperators;
+    /** Explicit aliases for adapters that mirror the canonical query schema. */
+    searchOperators?: string[];
+    filterOperators?: string[];
+    sortOperators?: string[];
+    /** Explicit readability is useful when read capability is policy-gated. */
+    readable?: boolean;
 }
 /** #2444 owns the canonical query language; this declares only its bounds. */
 export type DataSurfaceQueryMode = 'rows' | 'count' | 'facets';
@@ -41,6 +69,10 @@ export interface DataSurfaceQueryCapabilities {
     modes: DataSurfaceQueryMode[];
     /** Explicit allowlist; field paths are not accepted in requests. */
     projectableColumnIds: string[];
+    /** Explicit allowlists for non-projection query operations. */
+    searchableColumnIds?: string[];
+    filterableColumnIds?: string[];
+    sortableColumnIds?: string[];
 }
 export interface DataSurfaceVisibleControl {
     /** Stable command name accepted by the mounted surface. */
@@ -56,6 +88,8 @@ export interface DataSurfaceActionDescriptor {
     sensitivity?: DataSurfaceSensitivity;
     selectionScopes: DataSurfaceSelectionScope[];
     requiresConfirmation?: boolean;
+    /** Optional column dependencies used by field-policy adapters. */
+    columnIds?: string[];
 }
 /** Per-surface limits; generic envelopes use DATA_SURFACE_MAX_REQUEST_BYTES. */
 export interface DataSurfaceLimits {
@@ -233,6 +267,8 @@ export interface DataSurfaceRegistry {
 }
 /** Generic browser-transport ceiling for normalized command/action envelopes. */
 export declare const DATA_SURFACE_MAX_REQUEST_BYTES = 100000;
+/** Maximum length shared by every DataSurface protocol identifier. */
+export declare const DATA_SURFACE_IDENTIFIER_MAX_LENGTH = 256;
 /** Per-surface LRU capacity for command acknowledgement replay. */
 export declare const DATA_SURFACE_MAX_REPLAY_ENTRIES = 100;
 export declare function normalizeDataSurfaceDescriptor(value: DataSurfaceDescriptor): DataSurfaceDescriptor;

package/dist/components/data/data-surface.d.ts.map

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

package/dist/components/data/data-surface.js

@@ -8,10 +8,11 @@
  */
 /** Generic browser-transport ceiling for normalized command/action envelopes. */
 export const DATA_SURFACE_MAX_REQUEST_BYTES = 100_000;
+/** Maximum length shared by every DataSurface protocol identifier. */
+export const DATA_SURFACE_IDENTIFIER_MAX_LENGTH = 256;
 /** Per-surface LRU capacity for command acknowledgement replay. */
 export const DATA_SURFACE_MAX_REPLAY_ENTRIES = 100;
 const MAX_QUERY_LIMIT = 1_000;
-const MAX_REQUEST_ID_LENGTH = 256;
 const MAX_CURSOR_LENGTH = 2_048;
 const MAX_JSON_DEPTH = 16;
 const MAX_JSON_CONTAINER_ITEMS = 1_000;
@@ -45,6 +46,19 @@ const SELECTION_SCOPES = new Set([
     'explicit-ids',
     'all-matching',
 ]);
+const COLUMN_VISIBILITIES = new Set([
+    'basic',
+    'advanced',
+    'hidden',
+]);
+const COLUMN_ROLES = new Set([
+    'data',
+    'status',
+    'computed',
+    'row-key',
+    'selection',
+    'action',
+]);
 const FORBIDDEN_BOUNDARY_KEYS = new Set([
     'tenant',
     'tenantid',
@@ -94,11 +108,26 @@ function stringValue(value, label) {
     }
     return value;
 }
+function identifierValue(value, label) {
+    const result = stringValue(value, label);
+    if (result.length > DATA_SURFACE_IDENTIFIER_MAX_LENGTH) {
+        throw new TypeError(`${label} cannot exceed ${DATA_SURFACE_IDENTIFIER_MAX_LENGTH} characters`);
+    }
+    return result;
+}
 function optionalString(value, label) {
     if (value === undefined)
         return undefined;
     return stringValue(value, label);
 }
+function optionalFiniteNumber(value, label) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new TypeError(`${label} must be a finite number`);
+    }
+    return value;
+}
 function positiveInteger(value, label) {
     if (typeof value !== 'number' || !Number.isSafeInteger(value) || value <= 0) {
         throw new TypeError(`${label} must be a positive safe integer`);
@@ -319,13 +348,13 @@ function normalizeIdentity(value) {
         exactKeys(source, ['type', 'id', 'label'], 'DataSurface subject');
         const label = optionalString(source.label, 'DataSurface subject label');
         subject = {
-            type: stringValue(source.type, 'DataSurface subject type'),
-            id: stringValue(source.id, 'DataSurface subject id'),
+            type: identifierValue(source.type, 'DataSurface subject type'),
+            id: identifierValue(source.id, 'DataSurface subject id'),
             ...(label ? { label } : {}),
         };
     }
     return {
-        surfaceId: stringValue(object.surfaceId, 'DataSurface surface id'),
+        surfaceId: identifierValue(object.surfaceId, 'DataSurface surface id'),
         kind,
         ...(subject ? { subject } : {}),
     };
@@ -352,6 +381,9 @@ function normalizeStringArray(value, label, options = {}) {
     }
     return options.sort ? values.sort() : values;
 }
+function normalizeIdentifierArray(value, label, options = {}) {
+    return normalizeStringArray(value, label, options).map((entry) => identifierValue(entry, label));
+}
 function normalizeCapabilityArray(value, label) {
     const capabilities = normalizeStringArray(value, label, { sort: true });
     for (const capability of capabilities) {
@@ -370,6 +402,83 @@ function normalizeSensitivity(value, label) {
     }
     return sensitivity;
 }
+function normalizeColumnOperators(value, label) {
+    if (value === undefined)
+        return undefined;
+    const operators = plainObject(value, label);
+    exactKeys(operators, ['search', 'filter', 'sort'], label);
+    const search = operators.search === undefined
+        ? undefined
+        : normalizeStringArray(operators.search, `${label} search operators`, {
+            sort: true,
+        });
+    const filter = operators.filter === undefined
+        ? undefined
+        : normalizeStringArray(operators.filter, `${label} filter operators`, {
+            sort: true,
+        });
+    const sort = operators.sort === undefined
+        ? undefined
+        : normalizeStringArray(operators.sort, `${label} sort operators`, {
+            sort: true,
+        });
+    if (!search && !filter && !sort)
+        return {};
+    return {
+        ...(search ? { search } : {}),
+        ...(filter ? { filter } : {}),
+        ...(sort ? { sort } : {}),
+    };
+}
+function normalizeColumnDescriptorMetadata(column) {
+    const fieldName = optionalString(column.fieldName, 'DataSurface column field name');
+    const rawVisibility = optionalString(column.visibility, 'DataSurface column visibility');
+    if (rawVisibility &&
+        !COLUMN_VISIBILITIES.has(rawVisibility)) {
+        throw new TypeError(`Unsupported DataSurface column visibility: ${rawVisibility}`);
+    }
+    const rawRole = optionalString(column.role, 'DataSurface column role');
+    if (rawRole && !COLUMN_ROLES.has(rawRole)) {
+        throw new TypeError(`Unsupported DataSurface column role: ${rawRole}`);
+    }
+    if (column.readable !== undefined && typeof column.readable !== 'boolean') {
+        throw new TypeError('DataSurface column readable must be boolean');
+    }
+    const normalizeAliasOperators = (key) => column[key] === undefined
+        ? undefined
+        : normalizeStringArray(column[key], `DataSurface column ${key}`, {
+            sort: true,
+        });
+    const searchOperators = normalizeAliasOperators('searchOperators');
+    const filterOperators = normalizeAliasOperators('filterOperators');
+    const sortOperators = normalizeAliasOperators('sortOperators');
+    return {
+        ...(fieldName ? { fieldName } : {}),
+        ...(rawVisibility
+            ? { visibility: rawVisibility }
+            : {}),
+        ...(column.order === undefined
+            ? {}
+            : {
+                order: optionalFiniteNumber(column.order, 'DataSurface column order'),
+            }),
+        ...(rawRole ? { role: rawRole } : {}),
+        ...(column.responsivePriority === undefined
+            ? {}
+            : {
+                responsivePriority: optionalFiniteNumber(column.responsivePriority, 'DataSurface column responsive priority'),
+            }),
+        ...(column.operators === undefined
+            ? {}
+            : {
+                operators: normalizeColumnOperators(column.operators, 'DataSurface column operators'),
+            }),
+        ...(searchOperators ? { searchOperators } : {}),
+        ...(filterOperators ? { filterOperators } : {}),
+        ...(sortOperators ? { sortOperators } : {}),
+        ...(column.readable === undefined ? {} : { readable: column.readable }),
+    };
+}
 function normalizeSelection(value) {
     const object = plainObject(value, 'DataSurface selection');
     const scope = stringValue(object.scope, 'DataSurface selection scope');
@@ -394,7 +503,11 @@ function normalizeSelection(value) {
                 (typeof rowId !== 'number' || !Number.isFinite(rowId))) {
                 throw new TypeError('DataSurface row ids must be finite strings or numbers');
             }
-            const normalized = typeof rowId === 'number' && rowId === 0 ? 0 : rowId;
+            const normalized = typeof rowId === 'string'
+                ? identifierValue(rowId, 'DataSurface row id')
+                : rowId === 0
+                    ? 0
+                    : rowId;
             rowIds.set(`${typeof normalized}:${String(normalized)}`, normalized);
         }
         return {
@@ -411,7 +524,7 @@ function normalizeSelection(value) {
     exactKeys(object, ['scope', 'queryFingerprint'], 'DataSurface all-matching selection');
     return {
         scope,
-        queryFingerprint: stringValue(object.queryFingerprint, 'DataSurface query fingerprint'),
+        queryFingerprint: identifierValue(object.queryFingerprint, 'DataSurface query fingerprint'),
     };
 }
 export function normalizeDataSurfaceDescriptor(value) {
@@ -437,22 +550,46 @@ export function normalizeDataSurfaceDescriptor(value) {
     }
     const columns = object.columns.map((value) => {
         const column = plainObject(value, 'DataSurface column');
-        exactKeys(column, ['id', 'label', 'description', 'sensitivity', 'capabilities'], 'DataSurface column');
+        exactKeys(column, [
+            'id',
+            'label',
+            'description',
+            'sensitivity',
+            'capabilities',
+            'fieldName',
+            'visibility',
+            'order',
+            'role',
+            'responsivePriority',
+            'operators',
+            'searchOperators',
+            'filterOperators',
+            'sortOperators',
+            'readable',
+        ], 'DataSurface column');
         const sensitivity = normalizeSensitivity(column.sensitivity, 'DataSurface column sensitivity');
         const description = optionalString(column.description, 'DataSurface column description');
+        const metadata = normalizeColumnDescriptorMetadata(column);
         return {
-            id: stringValue(column.id, 'DataSurface column id'),
+            id: identifierValue(column.id, 'DataSurface column id'),
             label: stringValue(column.label, 'DataSurface column label'),
             ...(description ? { description } : {}),
             ...(sensitivity ? { sensitivity } : {}),
             capabilities: normalizeCapabilityArray(column.capabilities, 'DataSurface column capabilities'),
+            ...metadata,
         };
     });
     if (new Set(columns.map((column) => column.id)).size !== columns.length) {
         throw new TypeError('DataSurface descriptor column ids must be unique');
     }
     const query = plainObject(object.query, 'DataSurface query capabilities');
-    exactKeys(query, ['modes', 'projectableColumnIds'], 'DataSurface query capabilities');
+    exactKeys(query, [
+        'modes',
+        'projectableColumnIds',
+        'searchableColumnIds',
+        'filterableColumnIds',
+        'sortableColumnIds',
+    ], 'DataSurface query capabilities');
     const modes = normalizeStringArray(query.modes, 'DataSurface query modes', {
         sort: true,
     });
@@ -461,13 +598,27 @@ export function normalizeDataSurfaceDescriptor(value) {
             throw new TypeError(`Unsupported DataSurface query mode: ${mode}`);
         }
     }
-    const projectableColumnIds = normalizeStringArray(query.projectableColumnIds, 'DataSurface projectable column ids', { sort: true });
+    const projectableColumnIds = normalizeIdentifierArray(query.projectableColumnIds, 'DataSurface projectable column ids', { sort: true });
     const knownColumns = new Set(columns.map((column) => column.id));
     for (const columnId of projectableColumnIds) {
         if (!knownColumns.has(columnId)) {
             throw new TypeError(`Unknown projectable DataSurface column: ${columnId}`);
         }
     }
+    const queryColumnAllowlist = (value, label) => {
+        if (value === undefined)
+            return undefined;
+        const ids = normalizeStringArray(value, label, { sort: true });
+        for (const columnId of ids) {
+            if (!knownColumns.has(columnId)) {
+                throw new TypeError(`Unknown ${label}: ${columnId}`);
+            }
+        }
+        return ids;
+    };
+    const searchableColumnIds = queryColumnAllowlist(query.searchableColumnIds, 'searchable DataSurface column');
+    const filterableColumnIds = queryColumnAllowlist(query.filterableColumnIds, 'filterable DataSurface column');
+    const sortableColumnIds = queryColumnAllowlist(query.sortableColumnIds, 'sortable DataSurface column');
     if (!Array.isArray(object.controls)) {
         throw new TypeError('DataSurface controls must be an array');
     }
@@ -476,7 +627,7 @@ export function normalizeDataSurfaceDescriptor(value) {
         exactKeys(control, ['id', 'label', 'description'], 'DataSurface control');
         const description = optionalString(control.description, 'DataSurface control description');
         return {
-            id: stringValue(control.id, 'DataSurface control id'),
+            id: identifierValue(control.id, 'DataSurface control id'),
             label: stringValue(control.label, 'DataSurface control label'),
             ...(description ? { description } : {}),
         };
@@ -496,6 +647,7 @@ export function normalizeDataSurfaceDescriptor(value) {
             'sensitivity',
             'selectionScopes',
             'requiresConfirmation',
+            'columnIds',
         ], 'DataSurface action');
         if (action.requiresConfirmation !== undefined &&
             typeof action.requiresConfirmation !== 'boolean') {
@@ -509,8 +661,17 @@ export function normalizeDataSurfaceDescriptor(value) {
         }
         const sensitivity = normalizeSensitivity(action.sensitivity, 'DataSurface action sensitivity');
         const description = optionalString(action.description, 'DataSurface action description');
+        const columnIds = action.columnIds === undefined
+            ? undefined
+            : normalizeStringArray(action.columnIds, 'DataSurface action column ids', {
+                sort: true,
+            });
+        if (columnIds?.some((columnId) => !knownColumns.has(columnId))) {
+            const unknownColumnId = columnIds.find((columnId) => !knownColumns.has(columnId));
+            throw new TypeError(`Unknown DataSurface action column id: ${unknownColumnId}`);
+        }
         return {
-            id: stringValue(action.id, 'DataSurface action id'),
+            id: identifierValue(action.id, 'DataSurface action id'),
             label: stringValue(action.label, 'DataSurface action label'),
             ...(description ? { description } : {}),
             ...(sensitivity ? { sensitivity } : {}),
@@ -518,6 +679,7 @@ export function normalizeDataSurfaceDescriptor(value) {
             ...(action.requiresConfirmation === undefined
                 ? {}
                 : { requiresConfirmation: action.requiresConfirmation }),
+            ...(columnIds ? { columnIds } : {}),
         };
     });
     if (new Set(actions.map((action) => action.id)).size !== actions.length) {
@@ -529,7 +691,7 @@ export function normalizeDataSurfaceDescriptor(value) {
     if (maxQueryRows > MAX_QUERY_LIMIT) {
         throw new TypeError(`DataSurface maxQueryRows cannot exceed ${MAX_QUERY_LIMIT}`);
     }
-    const rowKey = stringValue(object.rowKey, 'DataSurface row key');
+    const rowKey = identifierValue(object.rowKey, 'DataSurface row key');
     if (!knownColumns.has(rowKey)) {
         throw new TypeError('DataSurface rowKey must name a declared column');
     }
@@ -542,7 +704,13 @@ export function normalizeDataSurfaceDescriptor(value) {
         ...(description ? { description } : {}),
         rowKey,
         columns,
-        query: { modes, projectableColumnIds },
+        query: {
+            modes,
+            projectableColumnIds,
+            ...(searchableColumnIds ? { searchableColumnIds } : {}),
+            ...(filterableColumnIds ? { filterableColumnIds } : {}),
+            ...(sortableColumnIds ? { sortableColumnIds } : {}),
+        },
         controls,
         actions,
         limits: {
@@ -581,13 +749,10 @@ export function normalizeDataSurfaceVisibleCommand(value) {
     if (object.version !== 1) {
         throw new TypeError('Unsupported DataSurface visible command version');
     }
-    const commandId = stringValue(object.commandId, 'DataSurface command id');
-    if (commandId.length > MAX_REQUEST_ID_LENGTH) {
-        throw new TypeError('DataSurface command id is too long');
-    }
+    const commandId = identifierValue(object.commandId, 'DataSurface command id');
     const commandIdentity = normalizeIdentity(object.identity);
     const expectedRevision = revisionNumber(object.expectedRevision);
-    const controlId = stringValue(object.controlId, 'DataSurface control id');
+    const controlId = identifierValue(object.controlId, 'DataSurface control id');
     assertRequestByteLimit(value, 'DataSurface visible command');
     const normalized = {
         version: 1,
@@ -610,10 +775,7 @@ export function normalizeDataSurfaceQueryRequest(value) {
     if (object.version !== 1) {
         throw new TypeError('Unsupported DataSurface query request version');
     }
-    const requestId = stringValue(object.requestId, 'DataSurface query request id');
-    if (requestId.length > MAX_REQUEST_ID_LENGTH) {
-        throw new TypeError('DataSurface query request id is too long');
-    }
+    const requestId = identifierValue(object.requestId, 'DataSurface query request id');
     const identity = normalizeIdentity(object.identity);
     if (kind === 'rows') {
         exactKeys(object, [
@@ -644,7 +806,7 @@ export function normalizeDataSurfaceQueryRequest(value) {
             ...(object.projection === undefined
                 ? {}
                 : {
-                    projection: normalizeStringArray(object.projection, 'DataSurface query projection', { sort: true }),
+                    projection: normalizeIdentifierArray(object.projection, 'DataSurface query projection', { sort: true }),
                 }),
         };
     }
@@ -665,7 +827,7 @@ export function normalizeDataSurfaceQueryRequest(value) {
             requestId,
             identity,
             kind,
-            columnId: stringValue(object.columnId, 'DataSurface facets query column id'),
+            columnId: identifierValue(object.columnId, 'DataSurface facets query column id'),
             limit,
         };
     }
@@ -686,17 +848,14 @@ export function normalizeDataSurfaceActionRequest(value) {
     if (object.version !== 1) {
         throw new TypeError('Unsupported DataSurface action request version');
     }
-    const requestId = stringValue(object.requestId, 'DataSurface action request id');
-    if (requestId.length > MAX_REQUEST_ID_LENGTH) {
-        throw new TypeError('DataSurface action request id is too long');
-    }
+    const requestId = identifierValue(object.requestId, 'DataSurface action request id');
     const phase = stringValue(object.phase, 'DataSurface action phase');
     if (phase !== 'preview' && phase !== 'apply') {
         throw new TypeError(`Unsupported DataSurface action phase: ${phase}`);
     }
     const confirmationToken = optionalString(object.confirmationToken, 'DataSurface confirmation token');
     const actionIdentity = normalizeIdentity(object.identity);
-    const actionId = stringValue(object.actionId, 'DataSurface action id');
+    const actionId = identifierValue(object.actionId, 'DataSurface action id');
     const selection = normalizeSelection(object.selection);
     assertRequestByteLimit(value, 'DataSurface action request');
     const normalized = {

package/dist/components/data/data-table-surface.d.ts

@@ -0,0 +1,9 @@
+/** Maps declared DataSurface controls onto the existing DataTable command model. */
+import type { DataTableCommand } from './DataTableController.js';
+import type { DataSurfaceVisibleCommand } from './data-surface.js';
+/**
+ * Returns `null` for a component-local control (focus, reveal, refresh, …) or
+ * an invalid table command. The mounted component owns those local controls.
+ */
+export declare function dataTableCommandFromDataSurfaceCommand(command: DataSurfaceVisibleCommand): DataTableCommand | null;
+//# sourceMappingURL=data-table-surface.d.ts.map

package/dist/components/data/data-table-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-surface.d.ts","sourceRoot":"","sources":["../../../src/components/data/data-table-surface.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,KAAK,EAEV,gBAAgB,EAKjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAqJ3B;;;GAGG;AACH,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,yBAAyB,GACjC,gBAAgB,GAAG,IAAI,CA8EzB"}