@tipolox/litgrid-core 1.2.1 → 1.2.3

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { createGridEngine } from './core/createGridEngine.js';
 export type { GridEngine } from './core/GridEngine.js';
 export type { GridQuery, GridQueryFilter, GridQueryReason, GridQueryChangeDetail, GridQuerySnapshot, GridExternalTotal, GridExternalState } from './model/GridQuery.js';
-export type { GridConfig, GridPaginationConfig, ResolvedGridConfig, SelectionMode } from './model/GridConfig.js';
+export type { GridConfig, GridQuickSearchConfig, GridPaginationConfig, ResolvedGridConfig, SelectionMode } from './model/GridConfig.js';
 export type { FilterOperator, GridFilter, GridPaginationState, GridSelection, GridRowKey, SelectedRowSnapshot, SelectionChangeDetail, SelectionIntent, SortDirection } from './model/GridState.js';
 //# 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":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7D,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACvK,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAChH,YAAY,EACV,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACd,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7D,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACvK,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACvI,YAAY,EACV,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACd,MAAM,sBAAsB,CAAA"}

package/dist/model/GridConfig.d.ts

@@ -4,9 +4,22 @@ export type GridPaginationConfig = {
     pageSize?: number;
     pageIndex?: number;
 };
+/** Presentation-only quick-search options; server search scope remains consumer-owned. */
+export type GridQuickSearchConfig = {
+    /** External mode only: false hides the built-in search field and toolbar. */
+    visible?: boolean;
+    /** Input accessible name. Defaults to 'Quick search'. */
+    label?: string;
+    /** Input placeholder. Defaults to 'Search all columns'. */
+    placeholder?: string;
+    /** Optional visible help, connected by aria-describedby. */
+    description?: string;
+};
 export type GridConfig = {
     /** Opt in to atomic server page results and query intents. Defaults to local. */
     queryMode?: 'local' | 'external';
+    /** External visibility and shared quick-search wording; local Show/Hide remains unchanged. */
+    quickSearch?: GridQuickSearchConfig;
     selection?: {
         mode?: SelectionMode;
         checkboxes?: boolean;
@@ -23,6 +36,12 @@ export type GridConfig = {
 };
 export type ResolvedGridConfig = {
     queryMode: 'local' | 'external';
+    quickSearch: {
+        visible: boolean;
+        label: string;
+        placeholder: string;
+        description: string;
+    };
     selection: {
         mode: SelectionMode;
         checkboxes: boolean;

package/dist/model/GridConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GridConfig.d.ts","sourceRoot":"","sources":["../../src/model/GridConfig.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,YAAY,CAAA;AAEhF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAChC,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,aAAa,CAAA;QACpB,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,qEAAqE;QACrE,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,iFAAiF;QACjF,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAC3B,CAAA;IACD,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,UAAU,CAAC,EAAE,oBAAoB,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,OAAO,GAAG,UAAU,CAAA;IAC/B,SAAS,EAAE;QACT,IAAI,EAAE,aAAa,CAAA;QACnB,UAAU,EAAE,OAAO,CAAA;QACnB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAC3B,CAAA;IACD,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;CACF,CAAA;AAUD,wBAAgB,eAAe,CAAC,MAAM,GAAE,UAAe,GAAG,kBAAkB,CAmB3E"}
+{"version":3,"file":"GridConfig.d.ts","sourceRoot":"","sources":["../../src/model/GridConfig.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,YAAY,CAAA;AAEhF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,0FAA0F;AAC1F,MAAM,MAAM,qBAAqB,GAAG;IAClC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAChC,8FAA8F;IAC9F,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,aAAa,CAAA;QACpB,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,qEAAqE;QACrE,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,iFAAiF;QACjF,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAC3B,CAAA;IACD,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,UAAU,CAAC,EAAE,oBAAoB,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,OAAO,GAAG,UAAU,CAAA;IAC/B,WAAW,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1F,SAAS,EAAE;QACT,IAAI,EAAE,aAAa,CAAA;QACnB,UAAU,EAAE,OAAO,CAAA;QACnB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAC3B,CAAA;IACD,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;CACF,CAAA;AAUD,wBAAgB,eAAe,CAAC,MAAM,GAAE,UAAe,GAAG,kBAAkB,CAyB3E"}

package/dist/model/GridConfig.js

@@ -7,6 +7,12 @@ function normalizePageIndex(value) {
 export function normalizeConfig(config = {}) {
     return {
         queryMode: config.queryMode === 'external' ? 'external' : 'local',
+        quickSearch: {
+            visible: config.quickSearch?.visible !== false,
+            label: typeof config.quickSearch?.label === 'string' && config.quickSearch.label.trim() ? config.quickSearch.label : 'Quick search',
+            placeholder: typeof config.quickSearch?.placeholder === 'string' ? config.quickSearch.placeholder : 'Search all columns',
+            description: typeof config.quickSearch?.description === 'string' ? config.quickSearch.description.trim() : ''
+        },
         selection: {
             mode: config.selection?.mode ?? 'none',
             checkboxes: config.selection?.checkboxes ?? false,

package/dist/model/GridConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"GridConfig.js","sourceRoot":"","sources":["../../src/model/GridConfig.ts"],"names":[],"mappings":"AA6CA,SAAS,iBAAiB,CAAC,KAAyB;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACpF,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAyB;IACnD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAqB,EAAE;IACrD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;QACjE,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,IAAI,MAAM;YACtC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,IAAI,KAAK;YACjD,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM;YAChC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,QAAQ;SACrC;QACD,SAAS,EAAE;YACT,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,KAAK;YAC3C,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;SACrC;QACD,UAAU,EAAE;YACV,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,IAAI,KAAK;YAC5C,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC;YACxD,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;SAC5D;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"GridConfig.js","sourceRoot":"","sources":["../../src/model/GridConfig.ts"],"names":[],"mappings":"AA4DA,SAAS,iBAAiB,CAAC,KAAyB;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACpF,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAyB;IACnD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAqB,EAAE;IACrD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;QACjE,WAAW,EAAE;YACX,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,KAAK,KAAK;YAC9C,KAAK,EAAE,OAAO,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc;YACnI,WAAW,EAAE,OAAO,MAAM,CAAC,WAAW,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,oBAAoB;YACxH,WAAW,EAAE,OAAO,MAAM,CAAC,WAAW,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;SAC9G;QACD,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,IAAI,MAAM;YACtC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,IAAI,KAAK;YACjD,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM;YAChC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,QAAQ;SACrC;QACD,SAAS,EAAE;YACT,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,KAAK;YAC3C,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;SACrC;QACD,UAAU,EAAE;YACV,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,IAAI,KAAK;YAC5C,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC;YACxD,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;SAC5D;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tipolox/litgrid-core",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Framework-agnostic data engine for LitGrid.",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -1,7 +1,7 @@
 export { createGridEngine } from './core/createGridEngine.js'
 export type { GridEngine } from './core/GridEngine.js'
 export type { GridQuery, GridQueryFilter, GridQueryReason, GridQueryChangeDetail, GridQuerySnapshot, GridExternalTotal, GridExternalState } from './model/GridQuery.js'
-export type { GridConfig, GridPaginationConfig, ResolvedGridConfig, SelectionMode } from './model/GridConfig.js'
+export type { GridConfig, GridQuickSearchConfig, GridPaginationConfig, ResolvedGridConfig, SelectionMode } from './model/GridConfig.js'
 export type {
   FilterOperator,
   GridFilter,

package/src/model/GridConfig.ts

@@ -6,9 +6,23 @@ export type GridPaginationConfig = {
   pageIndex?: number
 }
 
+/** Presentation-only quick-search options; server search scope remains consumer-owned. */
+export type GridQuickSearchConfig = {
+  /** External mode only: false hides the built-in search field and toolbar. */
+  visible?: boolean
+  /** Input accessible name. Defaults to 'Quick search'. */
+  label?: string
+  /** Input placeholder. Defaults to 'Search all columns'. */
+  placeholder?: string
+  /** Optional visible help, connected by aria-describedby. */
+  description?: string
+}
+
 export type GridConfig = {
   /** Opt in to atomic server page results and query intents. Defaults to local. */
   queryMode?: 'local' | 'external'
+  /** External visibility and shared quick-search wording; local Show/Hide remains unchanged. */
+  quickSearch?: GridQuickSearchConfig
   selection?: {
     mode?: SelectionMode
     checkboxes?: boolean
@@ -26,6 +40,7 @@ export type GridConfig = {
 
 export type ResolvedGridConfig = {
   queryMode: 'local' | 'external'
+  quickSearch: { visible: boolean; label: string; placeholder: string; description: string }
   selection: {
     mode: SelectionMode
     checkboxes: boolean
@@ -54,6 +69,12 @@ function normalizePageIndex(value: number | undefined) {
 export function normalizeConfig(config: GridConfig = {}): ResolvedGridConfig {
   return {
     queryMode: config.queryMode === 'external' ? 'external' : 'local',
+    quickSearch: {
+      visible: config.quickSearch?.visible !== false,
+      label: typeof config.quickSearch?.label === 'string' && config.quickSearch.label.trim() ? config.quickSearch.label : 'Quick search',
+      placeholder: typeof config.quickSearch?.placeholder === 'string' ? config.quickSearch.placeholder : 'Search all columns',
+      description: typeof config.quickSearch?.description === 'string' ? config.quickSearch.description.trim() : ''
+    },
     selection: {
       mode: config.selection?.mode ?? 'none',
       checkboxes: config.selection?.checkboxes ?? false,