@asteby/metacore-runtime-react 9.0.0 → 9.1.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @asteby/metacore-runtime-react
 
+## 9.1.0
+
+### Minor Changes
+
+- 2e50839: feat(runtime-react): leer `visibility` y `searchable` en metadata de columnas.
+  - `ColumnDefinition` tipa los nuevos campos `visibility?` (`"all" | "table" | "modal" | "list"`) y `searchable?` que el kernel ya emite (`manifest.ColumnDef`). Backwards compat: zero-value preserva el comportamiento previo.
+  - `<DynamicTable>` ahora oculta del listado las columnas con `visibility === "modal"` (y `"list"`) además del legacy `hidden`. Las columnas sin `visibility` o con `"all" | "table"` siguen visibles.
+  - Cuando al menos una columna declara `searchable` el SDK acota el global search a esas columnas vía el nuevo query param `search_columns=<keys>`. Si todas las columnas se opt-out (`searchable: false`), el SDK deja de mandar `search` al backend. Si ninguna columna trae el flag (kernel anterior a v0.8.x), no se cambia nada.
+  - Nuevos helpers públicos `isColumnVisibleInTable(col)` y `getSearchableColumnKeys(metadata)` exportados desde el barrel; tests con metadata mock cubren los pasos legacy + opt-in + opt-out total.
+
 ## 9.0.0
 
 ### Minor Changes

package/dist/column-visibility.d.ts

@@ -0,0 +1,22 @@
+import type { ColumnDefinition, TableMetadata } from './types';
+/**
+ * Whether a column should render in a list/index table view.
+ *
+ * A column is hidden when its `visibility` is scoped away from the table
+ * (`'modal'`: only the create/edit dialog; `'list'`: only API payloads) or
+ * when the legacy `hidden` boolean is set. Empty / `'all'` / `'table'` keep
+ * the column visible — preserving zero-value behaviour for metadata emitted
+ * by older kernels that don't set `visibility` at all.
+ */
+export declare function isColumnVisibleInTable(col: ColumnDefinition): boolean;
+/**
+ * Returns the keys of columns that opt into the model's full-text search,
+ * or `null` when no column declares `searchable` at all.
+ *
+ * `null` is the legacy signal: the host should NOT narrow the search request
+ * (every column participates, matching pre-Searchable kernels). An empty
+ * array is meaningful — it means every column has been explicitly opted out
+ * and the host should disable the global search input.
+ */
+export declare function getSearchableColumnKeys(metadata: Pick<TableMetadata, 'columns'>): string[] | null;
+//# sourceMappingURL=column-visibility.d.ts.map

package/dist/column-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-visibility.d.ts","sourceRoot":"","sources":["../src/column-visibility.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE9D;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAKrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,GACzC,MAAM,EAAE,GAAG,IAAI,CAKjB"}

package/dist/column-visibility.js

@@ -0,0 +1,40 @@
+// Pure helpers that map kernel `manifest.ColumnDef` metadata flags
+// (Visibility, Searchable) into client-side decisions:
+//   - which columns the dynamic table should render
+//   - which column keys are in scope for the global search
+//
+// Kept side-effect free and free of React/UI imports so the same logic can
+// be tested with plain unit tests against mock metadata.
+/**
+ * Whether a column should render in a list/index table view.
+ *
+ * A column is hidden when its `visibility` is scoped away from the table
+ * (`'modal'`: only the create/edit dialog; `'list'`: only API payloads) or
+ * when the legacy `hidden` boolean is set. Empty / `'all'` / `'table'` keep
+ * the column visible — preserving zero-value behaviour for metadata emitted
+ * by older kernels that don't set `visibility` at all.
+ */
+export function isColumnVisibleInTable(col) {
+    if (col.hidden)
+        return false;
+    const v = col.visibility;
+    if (!v)
+        return true;
+    return v === 'all' || v === 'table';
+}
+/**
+ * Returns the keys of columns that opt into the model's full-text search,
+ * or `null` when no column declares `searchable` at all.
+ *
+ * `null` is the legacy signal: the host should NOT narrow the search request
+ * (every column participates, matching pre-Searchable kernels). An empty
+ * array is meaningful — it means every column has been explicitly opted out
+ * and the host should disable the global search input.
+ */
+export function getSearchableColumnKeys(metadata) {
+    const cols = metadata.columns ?? [];
+    const declared = cols.some(c => typeof c.searchable === 'boolean');
+    if (!declared)
+        return null;
+    return cols.filter(c => c.searchable === true).map(c => c.key);
+}

package/dist/dynamic-columns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-columns.d.ts","sourceRoot":"","sources":["../src/dynamic-columns.tsx"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAER,iBAAiB,EACpB,MAAM,wBAAwB,CAAA;AAE/B,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAwHD;;;;GAIG;AACH,wBAAgB,4BAA4B,CACxC,OAAO,GAAE,qBAA0B,GACpC,iBAAiB,CAmXnB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBACL,CAAA"}
+{"version":3,"file":"dynamic-columns.d.ts","sourceRoot":"","sources":["../src/dynamic-columns.tsx"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAER,iBAAiB,EACpB,MAAM,wBAAwB,CAAA;AAE/B,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAwHD;;;;GAIG;AACH,wBAAgB,4BAA4B,CACxC,OAAO,GAAE,qBAA0B,GACpC,iBAAiB,CAqXnB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBACL,CAAA"}

package/dist/dynamic-columns.js

@@ -18,6 +18,7 @@ import { DataTableColumnHeader, FilterableColumnHeader, } from '@asteby/metacore
 import { generateBadgeStyles, getInitials } from '@asteby/metacore-ui/lib';
 import { OptionsContext } from './options-context';
 import { DynamicIcon } from './dynamic-icon';
+import { isColumnVisibleInTable } from './column-visibility';
 const defaultGetImageUrl = (path) => path;
 const getNestedValue = (obj, path) => path.split('.').reduce((acc, part) => acc && acc[part], obj);
 const lowerFirst = (value) => {
@@ -123,7 +124,9 @@ export function makeDefaultGetDynamicColumns(helpers = {}) {
             },
         ];
         metadata.columns.forEach((col) => {
-            if (col.hidden)
+            // Honors both the legacy `hidden` boolean and the kernel's
+            // `visibility` scope (skips `'modal'` and `'list'`).
+            if (!isColumnVisibleInTable(col))
                 return;
             const translatedLabel = col.label;
             const filterConfig = filterConfigs?.get(col.key);

package/dist/dynamic-table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-table.d.ts","sourceRoot":"","sources":["../src/dynamic-table.tsx"],"names":[],"mappings":"AAiBA,OAAO,EAKH,KAAK,SAAS,EAajB,MAAM,uBAAuB,CAAA;AA+B9B,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AASnF,UAAU,iBAAiB;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;IAC7C,cAAc,CAAC,EAAE,GAAG,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACpC,YAAY,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAA;IAC/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACxC;AAED,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,aAAoB,EACpB,aAAkB,EAClB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,YAAiB,EACjB,iBAA4C,GAC/C,EAAE,iBAAiB,2CA8rBnB"}
+{"version":3,"file":"dynamic-table.d.ts","sourceRoot":"","sources":["../src/dynamic-table.tsx"],"names":[],"mappings":"AAiBA,OAAO,EAKH,KAAK,SAAS,EAajB,MAAM,uBAAuB,CAAA;AA+B9B,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAUnF,UAAU,iBAAiB;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;IAC7C,cAAc,CAAC,EAAE,GAAG,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACpC,YAAY,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAA;IAC/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACxC;AAED,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,aAAoB,EACpB,aAAkB,EAClB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,YAAiB,EACjB,iBAA4C,GAC/C,EAAE,iBAAiB,2CA+sBnB"}

package/dist/dynamic-table.js

@@ -27,6 +27,7 @@ import { useApi, useCurrentBranch } from './api-context';
 import { defaultGetDynamicColumns } from './dynamic-columns';
 import { OptionsContext } from './options-context';
 import { ActionModalDispatcher } from './action-modal-dispatcher';
+import { getSearchableColumnKeys } from './column-visibility';
 import { DynamicRecordDialog } from './dialogs/dynamic-record';
 import { ExportDialog } from './dialogs/export';
 import { ImportDialog } from './dialogs/import';
@@ -253,14 +254,27 @@ export function DynamicTable({ model, endpoint, enableUrlSync = true, hiddenColu
         };
         initMetadataAndOptions();
     }, [model]); // eslint-disable-line react-hooks/exhaustive-deps
+    // Derived from `metadata.columns[].searchable`. `null` means the kernel
+    // didn't emit the flag for any column → preserve legacy "search every
+    // column" behaviour by not narrowing the request. An empty array means
+    // every column was explicitly opted out → skip sending `search` at all.
+    const searchableKeys = useMemo(() => (metadata ? getSearchableColumnKeys(metadata) : null), [metadata]);
     const buildFilterParams = useCallback(() => {
         const params = {};
         if (sorting.length > 0) {
             params.sortBy = sorting[0].id;
             params.order = sorting[0].desc ? 'desc' : 'asc';
         }
-        if (globalFilter)
-            params.search = globalFilter;
+        if (globalFilter) {
+            if (searchableKeys === null) {
+                params.search = globalFilter;
+            }
+            else if (searchableKeys.length > 0) {
+                params.search = globalFilter;
+                params.search_columns = searchableKeys.join(',');
+            }
+            // searchableKeys === [] → drop the search request entirely
+        }
         columnFilters.forEach((filter) => { params[`f_${filter.id}`] = filter.value; });
         if (defaultFilters)
             Object.entries(defaultFilters).forEach(([key, value]) => { params[`f_${key}`] = value; });
@@ -286,7 +300,7 @@ export function DynamicTable({ model, endpoint, enableUrlSync = true, hiddenColu
             params['f_created_at'] = `${startDate}_${endDate}`;
         }
         return params;
-    }, [sorting, globalFilter, columnFilters, defaultFilters, dynamicFilters, dateRange]);
+    }, [sorting, globalFilter, columnFilters, defaultFilters, dynamicFilters, dateRange, searchableKeys]);
     const hasActiveFilters = useMemo(() => {
         if (globalFilter)
             return true;

package/dist/index.d.ts

@@ -19,4 +19,5 @@ export { ImportDialog } from './dialogs/import';
 export { DynamicCRUDPage, type DynamicCRUDPageProps, type DynamicCRUDPageStrings, type DynamicCRUDPageClasses, } from './dynamic-crud-page';
 export { DynamicRelation, type DynamicRelationProps, type DynamicRelationStrings, type DynamicRelationKind, buildRelationFilterParams, buildCreatePayload, deriveRelationFormFields, relationRowKey, } from './dynamic-relation';
 export { registerModelExtension, getModelExtension, clearModelExtensions, type ModelExtension, type ModelExtensionProps, } from './model-extension-registry';
+export { isColumnVisibleInTable, getSearchableColumnKeys, } from './column-visibility';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,SAAS,CAAA;AACvB,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EACH,qBAAqB,EACrB,KAAK,gBAAgB,GACxB,MAAM,2BAA2B,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,QAAQ,CAAA;AACtB,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,YAAY,EACR,kBAAkB,EAClB,YAAY,IAAI,yBAAyB,EACzC,iBAAiB,EACjB,oBAAoB,GACvB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACH,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,qBAAqB,GAC7B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EACH,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC9B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,GACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACH,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GAC3B,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,SAAS,CAAA;AACvB,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EACH,qBAAqB,EACrB,KAAK,gBAAgB,GACxB,MAAM,2BAA2B,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,QAAQ,CAAA;AACtB,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,YAAY,EACR,kBAAkB,EAClB,YAAY,IAAI,yBAAyB,EACzC,iBAAiB,EACjB,oBAAoB,GACvB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACH,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,qBAAqB,GAC7B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EACH,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC9B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,GACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACH,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GAC3B,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACH,sBAAsB,EACtB,uBAAuB,GAC1B,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -23,3 +23,4 @@ export { ImportDialog } from './dialogs/import';
 export { DynamicCRUDPage, } from './dynamic-crud-page';
 export { DynamicRelation, buildRelationFilterParams, buildCreatePayload, deriveRelationFormFields, relationRowKey, } from './dynamic-relation';
 export { registerModelExtension, getModelExtension, clearModelExtensions, } from './model-extension-registry';
+export { isColumnVisibleInTable, getSearchableColumnKeys, } from './column-visibility';

package/dist/types.d.ts

@@ -26,6 +26,17 @@ export interface FilterDefinition {
     }[];
     searchEndpoint?: string;
 }
+/**
+ * Where a column is rendered. Mirrors `manifest.ColumnDef.Visibility` in the
+ * kernel:
+ *   - `''` / `'all'` — visible everywhere (default).
+ *   - `'table'`     — only the list/index page.
+ *   - `'modal'`     — only the create/edit modal.
+ *   - `'list'`      — only API list payloads (omitted from UI).
+ * Hosts may extend the union with their own scopes; the SDK only acts on the
+ * canonical values above.
+ */
+export type ColumnVisibility = 'all' | 'table' | 'modal' | 'list' | (string & {});
 export interface ColumnDefinition {
     key: string;
     label: string;
@@ -33,6 +44,19 @@ export interface ColumnDefinition {
     sortable: boolean;
     filterable: boolean;
     hidden?: boolean;
+    /**
+     * Scopes where this column is rendered. When `'modal'` (or `'list'`) the
+     * column is hidden from the table even if `hidden` is unset. Empty/`'all'`/
+     * `'table'` keep the column visible. See `column-visibility.ts`.
+     */
+    visibility?: ColumnVisibility;
+    /**
+     * Opts the column into the model's full-text/contains search. Independent
+     * of `filterable` (which drives column-level filter chips). When at least
+     * one column declares `searchable`, the SDK narrows the global search to
+     * those columns; otherwise legacy "search every column" behaviour applies.
+     */
+    searchable?: boolean;
     styleConfig?: Record<string, any>;
     tooltip?: string;
     description?: string;

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "9.0.0",
+  "version": "9.1.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",
@@ -56,6 +56,7 @@
     "react-dom": "^19.2.4",
     "react-i18next": "^17.0.0",
     "sonner": "^2.0.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.6.0",
     "vitest": "^4.0.0",
     "zustand": "^5.0.0",

package/src/__tests__/column-visibility.test.ts

@@ -0,0 +1,116 @@
+import { describe, it, expect } from 'vitest'
+
+import {
+    isColumnVisibleInTable,
+    getSearchableColumnKeys,
+} from '../column-visibility'
+import type { ColumnDefinition, TableMetadata } from '../types'
+
+const baseCol = (overrides: Partial<ColumnDefinition> = {}): ColumnDefinition => ({
+    key: 'name',
+    label: 'Name',
+    type: 'text',
+    sortable: true,
+    filterable: false,
+    ...overrides,
+})
+
+const baseMeta = (columns: ColumnDefinition[]): TableMetadata => ({
+    title: 'Mock',
+    endpoint: '/data/mock',
+    columns,
+    actions: [],
+    perPageOptions: [10],
+    defaultPerPage: 10,
+    searchPlaceholder: 'Search…',
+    enableCRUDActions: true,
+    hasActions: false,
+})
+
+describe('isColumnVisibleInTable', () => {
+    it('keeps columns with no visibility flag (legacy zero-value)', () => {
+        expect(isColumnVisibleInTable(baseCol())).toBe(true)
+    })
+
+    it('keeps columns with visibility="all"', () => {
+        expect(isColumnVisibleInTable(baseCol({ visibility: 'all' }))).toBe(true)
+    })
+
+    it('keeps columns with visibility="table"', () => {
+        expect(isColumnVisibleInTable(baseCol({ visibility: 'table' }))).toBe(true)
+    })
+
+    it('hides columns with visibility="modal"', () => {
+        expect(isColumnVisibleInTable(baseCol({ visibility: 'modal' }))).toBe(false)
+    })
+
+    it('hides columns with visibility="list"', () => {
+        expect(isColumnVisibleInTable(baseCol({ visibility: 'list' }))).toBe(false)
+    })
+
+    it('hides columns with the legacy hidden boolean even if visibility="all"', () => {
+        expect(isColumnVisibleInTable(baseCol({ hidden: true, visibility: 'all' }))).toBe(false)
+    })
+
+    it('hides columns with an unknown visibility value (fail-closed)', () => {
+        expect(isColumnVisibleInTable(baseCol({ visibility: 'detail' as any }))).toBe(false)
+    })
+})
+
+describe('getSearchableColumnKeys', () => {
+    it('returns null when no column declares searchable (legacy metadata)', () => {
+        const meta = baseMeta([
+            baseCol({ key: 'name' }),
+            baseCol({ key: 'email' }),
+        ])
+        expect(getSearchableColumnKeys(meta)).toBe(null)
+    })
+
+    it('returns only the searchable keys when at least one column declares it', () => {
+        const meta = baseMeta([
+            baseCol({ key: 'name', searchable: true }),
+            baseCol({ key: 'email', searchable: true }),
+            baseCol({ key: 'phone', searchable: false }),
+            baseCol({ key: 'created_at' }), // undefined → not searchable
+        ])
+        expect(getSearchableColumnKeys(meta)).toEqual(['name', 'email'])
+    })
+
+    it('returns an empty array when every column is explicitly opted out', () => {
+        const meta = baseMeta([
+            baseCol({ key: 'name', searchable: false }),
+            baseCol({ key: 'email', searchable: false }),
+        ])
+        expect(getSearchableColumnKeys(meta)).toEqual([])
+    })
+
+    it('treats searchable=true on a single column as the explicit allowlist', () => {
+        const meta = baseMeta([
+            baseCol({ key: 'name', searchable: true }),
+            baseCol({ key: 'internal_notes' }),
+        ])
+        expect(getSearchableColumnKeys(meta)).toEqual(['name'])
+    })
+
+    it('handles missing columns array defensively', () => {
+        const meta = { columns: undefined as unknown as ColumnDefinition[] }
+        expect(getSearchableColumnKeys(meta as any)).toBe(null)
+    })
+})
+
+describe('column-visibility integration with mock metadata', () => {
+    it('filtering and search keys can be derived from a single mock', () => {
+        const meta = baseMeta([
+            baseCol({ key: 'id', visibility: 'list', searchable: false }),
+            baseCol({ key: 'name', visibility: 'all', searchable: true }),
+            baseCol({ key: 'email', visibility: 'table', searchable: true }),
+            baseCol({ key: 'password_hash', visibility: 'modal', searchable: false }),
+            baseCol({ key: 'profile', visibility: 'modal', searchable: false }),
+        ])
+
+        const tableColumns = meta.columns.filter(isColumnVisibleInTable).map(c => c.key)
+        expect(tableColumns).toEqual(['name', 'email'])
+
+        expect(getSearchableColumnKeys(meta)).toEqual(['name', 'email'])
+    })
+})

package/src/column-visibility.ts

@@ -0,0 +1,43 @@
+// Pure helpers that map kernel `manifest.ColumnDef` metadata flags
+// (Visibility, Searchable) into client-side decisions:
+//   - which columns the dynamic table should render
+//   - which column keys are in scope for the global search
+//
+// Kept side-effect free and free of React/UI imports so the same logic can
+// be tested with plain unit tests against mock metadata.
+
+import type { ColumnDefinition, TableMetadata } from './types'
+
+/**
+ * Whether a column should render in a list/index table view.
+ *
+ * A column is hidden when its `visibility` is scoped away from the table
+ * (`'modal'`: only the create/edit dialog; `'list'`: only API payloads) or
+ * when the legacy `hidden` boolean is set. Empty / `'all'` / `'table'` keep
+ * the column visible — preserving zero-value behaviour for metadata emitted
+ * by older kernels that don't set `visibility` at all.
+ */
+export function isColumnVisibleInTable(col: ColumnDefinition): boolean {
+    if (col.hidden) return false
+    const v = col.visibility
+    if (!v) return true
+    return v === 'all' || v === 'table'
+}
+
+/**
+ * Returns the keys of columns that opt into the model's full-text search,
+ * or `null` when no column declares `searchable` at all.
+ *
+ * `null` is the legacy signal: the host should NOT narrow the search request
+ * (every column participates, matching pre-Searchable kernels). An empty
+ * array is meaningful — it means every column has been explicitly opted out
+ * and the host should disable the global search input.
+ */
+export function getSearchableColumnKeys(
+    metadata: Pick<TableMetadata, 'columns'>,
+): string[] | null {
+    const cols = metadata.columns ?? []
+    const declared = cols.some(c => typeof c.searchable === 'boolean')
+    if (!declared) return null
+    return cols.filter(c => c.searchable === true).map(c => c.key)
+}

package/src/dynamic-columns.tsx

@@ -35,6 +35,7 @@ import { generateBadgeStyles, getInitials } from '@asteby/metacore-ui/lib'
 import { OptionsContext } from './options-context'
 import { DynamicIcon } from './dynamic-icon'
 import type { TableMetadata, ColumnDefinition } from './types'
+import { isColumnVisibleInTable } from './column-visibility'
 import type {
     ColumnFilterConfig,
     GetDynamicColumns,
@@ -221,7 +222,9 @@ export function makeDefaultGetDynamicColumns(
         ]
 
         metadata.columns.forEach((col) => {
-            if (col.hidden) return
+            // Honors both the legacy `hidden` boolean and the kernel's
+            // `visibility` scope (skips `'modal'` and `'list'`).
+            if (!isColumnVisibleInTable(col)) return
 
             const translatedLabel = col.label
             const filterConfig = filterConfigs?.get(col.key)

package/src/dynamic-table.tsx

@@ -69,6 +69,7 @@ import { defaultGetDynamicColumns } from './dynamic-columns'
 import { OptionsContext } from './options-context'
 import { ActionModalDispatcher } from './action-modal-dispatcher'
 import type { TableMetadata, ApiResponse, ActionMetadata } from './types'
+import { getSearchableColumnKeys } from './column-visibility'
 import { DynamicRecordDialog } from './dialogs/dynamic-record'
 import { ExportDialog } from './dialogs/export'
 import { ImportDialog } from './dialogs/import'
@@ -324,13 +325,30 @@ export function DynamicTable({
         initMetadataAndOptions()
     }, [model]) // eslint-disable-line react-hooks/exhaustive-deps
 
+    // Derived from `metadata.columns[].searchable`. `null` means the kernel
+    // didn't emit the flag for any column → preserve legacy "search every
+    // column" behaviour by not narrowing the request. An empty array means
+    // every column was explicitly opted out → skip sending `search` at all.
+    const searchableKeys = useMemo(
+        () => (metadata ? getSearchableColumnKeys(metadata) : null),
+        [metadata],
+    )
+
     const buildFilterParams = useCallback(() => {
         const params: Record<string, any> = {}
         if (sorting.length > 0) {
             params.sortBy = sorting[0].id
             params.order = sorting[0].desc ? 'desc' : 'asc'
         }
-        if (globalFilter) params.search = globalFilter
+        if (globalFilter) {
+            if (searchableKeys === null) {
+                params.search = globalFilter
+            } else if (searchableKeys.length > 0) {
+                params.search = globalFilter
+                params.search_columns = searchableKeys.join(',')
+            }
+            // searchableKeys === [] → drop the search request entirely
+        }
         columnFilters.forEach((filter: { id: string; value: unknown }) => { params[`f_${filter.id}`] = filter.value })
         if (defaultFilters) Object.entries(defaultFilters).forEach(([key, value]) => { params[`f_${key}`] = value })
         Object.entries(dynamicFilters).forEach(([key, values]) => {
@@ -352,7 +370,7 @@ export function DynamicTable({
             params['f_created_at'] = `${startDate}_${endDate}`
         }
         return params
-    }, [sorting, globalFilter, columnFilters, defaultFilters, dynamicFilters, dateRange])
+    }, [sorting, globalFilter, columnFilters, defaultFilters, dynamicFilters, dateRange, searchableKeys])
 
     const hasActiveFilters = useMemo(() => {
         if (globalFilter) return true

package/src/index.ts

@@ -56,3 +56,7 @@ export {
     type ModelExtension,
     type ModelExtensionProps,
 } from './model-extension-registry'
+export {
+    isColumnVisibleInTable,
+    getSearchableColumnKeys,
+} from './column-visibility'

package/src/types.ts

@@ -26,6 +26,18 @@ export interface FilterDefinition {
     searchEndpoint?: string
 }
 
+/**
+ * Where a column is rendered. Mirrors `manifest.ColumnDef.Visibility` in the
+ * kernel:
+ *   - `''` / `'all'` — visible everywhere (default).
+ *   - `'table'`     — only the list/index page.
+ *   - `'modal'`     — only the create/edit modal.
+ *   - `'list'`      — only API list payloads (omitted from UI).
+ * Hosts may extend the union with their own scopes; the SDK only acts on the
+ * canonical values above.
+ */
+export type ColumnVisibility = 'all' | 'table' | 'modal' | 'list' | (string & {})
+
 export interface ColumnDefinition {
     key: string
     label: string
@@ -33,6 +45,19 @@ export interface ColumnDefinition {
     sortable: boolean
     filterable: boolean
     hidden?: boolean
+    /**
+     * Scopes where this column is rendered. When `'modal'` (or `'list'`) the
+     * column is hidden from the table even if `hidden` is unset. Empty/`'all'`/
+     * `'table'` keep the column visible. See `column-visibility.ts`.
+     */
+    visibility?: ColumnVisibility
+    /**
+     * Opts the column into the model's full-text/contains search. Independent
+     * of `filterable` (which drives column-level filter chips). When at least
+     * one column declares `searchable`, the SDK narrows the global search to
+     * those columns; otherwise legacy "search every column" behaviour applies.
+     */
+    searchable?: boolean
     styleConfig?: Record<string, any>
     tooltip?: string
     description?: string

package/tsconfig.json

@@ -12,5 +12,6 @@
     "outDir": "./dist",
     "rootDir": "./src"
   },
-  "include": ["src/**/*"]
+  "include": ["src/**/*"],
+  "exclude": ["src/**/*.test.ts", "src/**/__tests__/**"]
 }

package/dist/__tests__/dynamic-form.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=dynamic-form.test.d.ts.map

package/dist/__tests__/dynamic-form.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dynamic-form.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dynamic-form.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/dynamic-form.test.js

@@ -1,93 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { buildZodSchema, resolveWidget } from '../dynamic-form-schema';
-describe('buildZodSchema', () => {
-    it('aplica regex de Validation a strings', () => {
-        const fields = [
-            { key: 'sku', label: 'SKU', type: 'string', required: true, validation: { regex: '^[A-Z]{3}-\\d{3}$' } },
-        ];
-        const schema = buildZodSchema(fields);
-        expect(schema.safeParse({ sku: 'ABC-123' }).success).toBe(true);
-        expect(schema.safeParse({ sku: 'abc-123' }).success).toBe(false);
-        expect(schema.safeParse({ sku: 'ABCD-123' }).success).toBe(false);
-    });
-    it('aplica min/max como longitud sobre strings', () => {
-        const fields = [
-            { key: 'name', label: 'Nombre', type: 'string', required: true, validation: { min: 3, max: 8 } },
-        ];
-        const schema = buildZodSchema(fields);
-        expect(schema.safeParse({ name: 'ab' }).success).toBe(false);
-        expect(schema.safeParse({ name: 'abc' }).success).toBe(true);
-        expect(schema.safeParse({ name: 'abcdefgh' }).success).toBe(true);
-        expect(schema.safeParse({ name: 'abcdefghi' }).success).toBe(false);
-    });
-    it('aplica min/max como bounds sobre números', () => {
-        const fields = [
-            { key: 'age', label: 'Edad', type: 'number', required: true, validation: { min: 18, max: 99 } },
-        ];
-        const schema = buildZodSchema(fields);
-        expect(schema.safeParse({ age: 17 }).success).toBe(false);
-        expect(schema.safeParse({ age: 18 }).success).toBe(true);
-        expect(schema.safeParse({ age: 99 }).success).toBe(true);
-        expect(schema.safeParse({ age: 100 }).success).toBe(false);
-    });
-    it('marca campos requeridos vacíos como inválidos', () => {
-        const fields = [
-            { key: 'title', label: 'Título', type: 'string', required: true },
-        ];
-        const schema = buildZodSchema(fields);
-        expect(schema.safeParse({ title: '' }).success).toBe(false);
-        expect(schema.safeParse({ title: 'ok' }).success).toBe(true);
-    });
-    it('campos opcionales aceptan vacío o ausente', () => {
-        const fields = [
-            { key: 'note', label: 'Nota', type: 'string' },
-            { key: 'qty', label: 'Cantidad', type: 'number' },
-        ];
-        const schema = buildZodSchema(fields);
-        expect(schema.safeParse({ note: '', qty: '' }).success).toBe(true);
-        expect(schema.safeParse({}).success).toBe(true);
-    });
-    it('valida email y url por type', () => {
-        const fields = [
-            { key: 'mail', label: 'Email', type: 'email', required: true },
-            { key: 'site', label: 'URL', type: 'url', required: true },
-        ];
-        const schema = buildZodSchema(fields);
-        expect(schema.safeParse({ mail: 'a@b.co', site: 'https://x.test' }).success).toBe(true);
-        expect(schema.safeParse({ mail: 'no-email', site: 'https://x.test' }).success).toBe(false);
-        expect(schema.safeParse({ mail: 'a@b.co', site: 'no-url' }).success).toBe(false);
-    });
-    it('regex inválida no rompe el build (silently skipped)', () => {
-        const fields = [
-            { key: 'x', label: 'X', type: 'string', required: true, validation: { regex: '[invalid(' } },
-        ];
-        expect(() => buildZodSchema(fields)).not.toThrow();
-        const schema = buildZodSchema(fields);
-        expect(schema.safeParse({ x: 'anything' }).success).toBe(true);
-    });
-    it('booleans requeridos exigen un valor explícito', () => {
-        const fields = [
-            { key: 'agree', label: 'Acepto', type: 'boolean', required: true },
-        ];
-        const schema = buildZodSchema(fields);
-        expect(schema.safeParse({ agree: true }).success).toBe(true);
-        expect(schema.safeParse({ agree: false }).success).toBe(true);
-        expect(schema.safeParse({}).success).toBe(false);
-    });
-});
-describe('resolveWidget', () => {
-    it('respeta widget explícito', () => {
-        expect(resolveWidget({ key: 'k', label: 'L', type: 'string', widget: 'textarea' })).toBe('textarea');
-        expect(resolveWidget({ key: 'k', label: 'L', type: 'string', widget: 'richtext' })).toBe('richtext');
-        expect(resolveWidget({ key: 'k', label: 'L', type: 'string', widget: 'color' })).toBe('color');
-    });
-    it('cae al inferido por type cuando widget no está', () => {
-        expect(resolveWidget({ key: 'k', label: 'L', type: 'textarea' })).toBe('textarea');
-        expect(resolveWidget({ key: 'k', label: 'L', type: 'select' })).toBe('select');
-        expect(resolveWidget({ key: 'k', label: 'L', type: 'boolean' })).toBe('switch');
-        expect(resolveWidget({ key: 'k', label: 'L', type: 'number' })).toBe('number');
-        expect(resolveWidget({ key: 'k', label: 'L', type: 'date' })).toBe('date');
-        expect(resolveWidget({ key: 'k', label: 'L', type: 'string' })).toBe('text');
-        expect(resolveWidget({ key: 'k', label: 'L', type: 'email' })).toBe('text');
-    });
-});

package/dist/__tests__/dynamic-relation.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=dynamic-relation.test.d.ts.map

package/dist/__tests__/dynamic-relation.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dynamic-relation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dynamic-relation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/dynamic-relation.test.js

@@ -1,228 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { buildCreatePayload, buildPivotAttachPayload, buildPivotRowIndex, buildRelationFilterParams, deriveRelationFormFields, diffSelection, extractSelectedTargetIds, pickOptionLabel, relationRowKey, } from '../dynamic-relation-helpers';
-describe('buildRelationFilterParams', () => {
-    it('produce el filtro f_<fk>=eq:<id> con string parentId', () => {
-        expect(buildRelationFilterParams('invoice_id', 'inv_42')).toEqual({
-            f_invoice_id: 'eq:inv_42',
-        });
-    });
-    it('coerce parentId numérico a string en el query', () => {
-        expect(buildRelationFilterParams('invoice_id', 42)).toEqual({
-            f_invoice_id: 'eq:42',
-        });
-    });
-    it('rechaza foreignKey vacío', () => {
-        expect(() => buildRelationFilterParams('', 'x')).toThrow(/foreignKey/);
-    });
-    it('rechaza parentId vacío / null / undefined', () => {
-        expect(() => buildRelationFilterParams('invoice_id', '')).toThrow(/parentId/);
-        // @ts-expect-error testing runtime guard
-        expect(() => buildRelationFilterParams('invoice_id', null)).toThrow(/parentId/);
-        // @ts-expect-error testing runtime guard
-        expect(() => buildRelationFilterParams('invoice_id', undefined)).toThrow(/parentId/);
-    });
-});
-describe('buildCreatePayload', () => {
-    it('inyecta el foreign key sobre los valores del form', () => {
-        const payload = buildCreatePayload('invoice_id', 'inv_42', { qty: 3, sku: 'A' });
-        expect(payload).toEqual({ qty: 3, sku: 'A', invoice_id: 'inv_42' });
-    });
-    it('el foreign key sobreescribe lo que venga del form', () => {
-        const payload = buildCreatePayload('invoice_id', 'inv_42', { invoice_id: 'inv_OTHER', qty: 1 });
-        expect(payload.invoice_id).toBe('inv_42');
-    });
-    it('preserva el parentId numérico tal cual', () => {
-        const payload = buildCreatePayload('invoice_id', 7, { qty: 1 });
-        expect(payload.invoice_id).toBe(7);
-    });
-    it('rechaza foreignKey vacío', () => {
-        expect(() => buildCreatePayload('', 'x', {})).toThrow(/foreignKey/);
-    });
-});
-describe('deriveRelationFormFields', () => {
-    const baseMeta = {
-        columns: [
-            { key: 'id', label: 'ID', type: 'text', sortable: true, filterable: false, hidden: true },
-            { key: 'invoice_id', label: 'Factura', type: 'text', sortable: false, filterable: false },
-            { key: 'sku', label: 'SKU', type: 'text', sortable: true, filterable: true },
-            { key: 'qty', label: 'Cantidad', type: 'number', sortable: true, filterable: false },
-            { key: 'taxable', label: 'Aplica IVA', type: 'boolean', sortable: false, filterable: false },
-            { key: 'category', label: 'Categoría', type: 'select', sortable: false, filterable: true, options: [
-                    { value: 'a', label: 'A' }, { value: 'b', label: 'B' },
-                ] },
-        ],
-    };
-    it('omite la foreign key porque está fija al parentId', () => {
-        const fields = deriveRelationFormFields(baseMeta, 'invoice_id');
-        expect(fields.find(f => f.key === 'invoice_id')).toBeUndefined();
-    });
-    it('omite columnas marcadas hidden', () => {
-        const fields = deriveRelationFormFields(baseMeta, 'invoice_id');
-        expect(fields.find(f => f.key === 'id')).toBeUndefined();
-    });
-    it('mapea types de ColumnDefinition al ActionFieldDef.type', () => {
-        const fields = deriveRelationFormFields(baseMeta, 'invoice_id');
-        const byKey = Object.fromEntries(fields.map(f => [f.key, f]));
-        expect(byKey['sku']?.type).toBe('string');
-        expect(byKey['qty']?.type).toBe('number');
-        expect(byKey['taxable']?.type).toBe('boolean');
-        expect(byKey['category']?.type).toBe('select');
-    });
-    it('propaga options con value coerced a string', () => {
-        const fields = deriveRelationFormFields(baseMeta, 'invoice_id');
-        const cat = fields.find(f => f.key === 'category');
-        expect(cat?.options).toEqual([
-            { value: 'a', label: 'A' },
-            { value: 'b', label: 'B' },
-        ]);
-    });
-    it('devuelve [] cuando no hay metadata', () => {
-        expect(deriveRelationFormFields(null, 'invoice_id')).toEqual([]);
-        expect(deriveRelationFormFields(undefined, 'invoice_id')).toEqual([]);
-        expect(deriveRelationFormFields({ columns: [] }, 'invoice_id')).toEqual([]);
-    });
-});
-describe('relationRowKey', () => {
-    it('usa row.id como key cuando existe', () => {
-        expect(relationRowKey({ id: 'abc' }, 0, 'invoice_id')).toBe('abc');
-        expect(relationRowKey({ id: 7 }, 5, 'invoice_id')).toBe('7');
-    });
-    it('cae a synthetic key cuando id falta o es vacío', () => {
-        expect(relationRowKey({}, 2, 'invoice_id')).toBe('__rel-invoice_id-2');
-        expect(relationRowKey({ id: '' }, 3, 'invoice_id')).toBe('__rel-invoice_id-3');
-        expect(relationRowKey({ id: null }, 1, 'invoice_id')).toBe('__rel-invoice_id-1');
-        expect(relationRowKey(undefined, 0, 'invoice_id')).toBe('__rel-invoice_id-0');
-    });
-});
-// ---------------------------------------------------------------------------
-// many_to_many helpers
-// ---------------------------------------------------------------------------
-describe('buildPivotAttachPayload', () => {
-    it('produce el body con los dos FKs fijos', () => {
-        const body = buildPivotAttachPayload('org_id', 'org_1', 'user_id', 'user_42');
-        expect(body).toEqual({ org_id: 'org_1', user_id: 'user_42' });
-    });
-    it('mezcla campos extra del pivot sin pisar los FKs', () => {
-        const body = buildPivotAttachPayload('org_id', 1, 'user_id', 2, {
-            role: 'owner',
-            org_id: 'evil',
-            user_id: 'evil',
-        });
-        expect(body.org_id).toBe(1);
-        expect(body.user_id).toBe(2);
-        expect(body.role).toBe('owner');
-    });
-    it('rechaza foreignKey / referencesKey vacíos', () => {
-        expect(() => buildPivotAttachPayload('', 'p', 'r', 't')).toThrow(/foreignKey/);
-        expect(() => buildPivotAttachPayload('f', 'p', '', 't')).toThrow(/referencesKey/);
-    });
-    it('rechaza parentId / targetId vacíos', () => {
-        expect(() => buildPivotAttachPayload('f', '', 'r', 't')).toThrow(/parentId/);
-        expect(() => buildPivotAttachPayload('f', 'p', 'r', '')).toThrow(/targetId/);
-        // @ts-expect-error testing runtime guard
-        expect(() => buildPivotAttachPayload('f', 'p', 'r', null)).toThrow(/targetId/);
-    });
-});
-describe('extractSelectedTargetIds', () => {
-    it('mapea pivot rows al set de target ids como strings', () => {
-        const ids = extractSelectedTargetIds([
-            { id: 1, org_id: 'org_1', user_id: 'u_1' },
-            { id: 2, org_id: 'org_1', user_id: 7 },
-        ], 'user_id');
-        expect(ids).toEqual(['u_1', '7']);
-    });
-    it('omite filas sin valor en el referencesKey', () => {
-        const ids = extractSelectedTargetIds([
-            { id: 1, user_id: 'u_1' },
-            { id: 2, user_id: null },
-            { id: 3, user_id: '' },
-            { id: 4 },
-        ], 'user_id');
-        expect(ids).toEqual(['u_1']);
-    });
-    it('devuelve [] cuando no hay rows o referencesKey', () => {
-        expect(extractSelectedTargetIds(null, 'user_id')).toEqual([]);
-        expect(extractSelectedTargetIds(undefined, 'user_id')).toEqual([]);
-        expect(extractSelectedTargetIds([{ user_id: 'x' }], '')).toEqual([]);
-    });
-});
-describe('buildPivotRowIndex', () => {
-    it('mapea targetId -> pivotRowId', () => {
-        const idx = buildPivotRowIndex([
-            { id: 'p1', user_id: 'u_1' },
-            { id: 'p2', user_id: 7 },
-        ], 'user_id');
-        expect(idx.get('u_1')).toBe('p1');
-        expect(idx.get('7')).toBe('p2');
-    });
-    it('omite filas sin id pivot o sin target', () => {
-        const idx = buildPivotRowIndex([
-            { id: 'p1', user_id: 'u_1' },
-            { user_id: 'u_2' },
-            { id: 'p3' },
-            { id: 'p4', user_id: null },
-        ], 'user_id');
-        expect(Array.from(idx.keys())).toEqual(['u_1']);
-    });
-    it('última fila gana cuando hay duplicados', () => {
-        const idx = buildPivotRowIndex([
-            { id: 'p1', user_id: 'u_1' },
-            { id: 'p2', user_id: 'u_1' },
-        ], 'user_id');
-        expect(idx.get('u_1')).toBe('p2');
-    });
-});
-describe('diffSelection', () => {
-    it('detecta toAdd y toRemove respecto al estado previo', () => {
-        const { toAdd, toRemove } = diffSelection(['a', 'b', 'c'], ['b', 'c', 'd']);
-        expect(toAdd).toEqual(['d']);
-        expect(toRemove).toEqual(['a']);
-    });
-    it('preserva el orden de aparición en next/prev', () => {
-        const { toAdd, toRemove } = diffSelection(['a', 'b'], ['c', 'a', 'd']);
-        expect(toAdd).toEqual(['c', 'd']);
-        expect(toRemove).toEqual(['b']);
-    });
-    it('devuelve arrays vacíos cuando no cambia nada', () => {
-        const { toAdd, toRemove } = diffSelection(['a', 'b'], ['b', 'a']);
-        expect(toAdd).toEqual([]);
-        expect(toRemove).toEqual([]);
-    });
-    it('caso vacío -> next agrega todo', () => {
-        const { toAdd, toRemove } = diffSelection([], ['a', 'b']);
-        expect(toAdd).toEqual(['a', 'b']);
-        expect(toRemove).toEqual([]);
-    });
-    it('caso prev -> [] remueve todo', () => {
-        const { toAdd, toRemove } = diffSelection(['a', 'b'], []);
-        expect(toAdd).toEqual([]);
-        expect(toRemove).toEqual(['a', 'b']);
-    });
-});
-describe('pickOptionLabel', () => {
-    const cols = [
-        { key: 'id', label: 'ID', type: 'text', sortable: false, filterable: false, hidden: true },
-        { key: 'name', label: 'Nombre', type: 'text', sortable: true, filterable: true },
-        { key: 'email', label: 'Email', type: 'text', sortable: false, filterable: true },
-    ];
-    it('respeta displayKey cuando existe en la fila', () => {
-        expect(pickOptionLabel({ id: 1, name: 'Alice', email: 'a@x' }, 'email', cols)).toBe('a@x');
-    });
-    it('cae al primer column no-id no-hidden cuando displayKey falta', () => {
-        expect(pickOptionLabel({ id: 1, name: 'Alice', email: 'a@x' }, undefined, cols)).toBe('Alice');
-    });
-    it('salta valores nulos / vacíos al inferir', () => {
-        expect(pickOptionLabel({ id: 1, name: '', email: 'a@x' }, undefined, cols)).toBe('a@x');
-    });
-    it('cae a row.id cuando no hay match en columns', () => {
-        expect(pickOptionLabel({ id: 7 }, undefined, cols)).toBe('7');
-        expect(pickOptionLabel({ id: 7 }, undefined, undefined)).toBe('7');
-    });
-    it('devuelve "—" cuando no hay nada usable', () => {
-        expect(pickOptionLabel(null, undefined, cols)).toBe('—');
-        expect(pickOptionLabel({}, undefined, cols)).toBe('—');
-    });
-    it('ignora valores object al inferir', () => {
-        expect(pickOptionLabel({ id: 1, name: { nested: true }, email: 'a@x' }, undefined, cols)).toBe('a@x');
-    });
-});