@atscript/vue-table 0.1.111 → 0.1.112

package/dist/index.d.cts

@@ -1,16 +1,16 @@
 import { t as _default$11 } from "./as-filters.vue-fv-tRL2H.cjs";
 import { t as _default$13 } from "./as-preset-picker.vue-DfXS3pGl.cjs";
-import { _ as TableNavBridge, c as NavKeyOptions, d as ReactiveTableState, f as RowDeleteOpt, g as TableActionsState, h as TVueTableActionInfo, m as TAsTableControls, n as ColumnMenuConfig, o as InvokeOpts, p as TAsCellTypeComponents, r as ConfigTab, s as MainActionRequest, t as ActionResult, u as QueryErrorKind } from "./types-CDJmLD-E.cjs";
-import { t as _default$16 } from "./as-table-actions.vue-DW-zOVP0.cjs";
-import { $ as createTableState, A as createDefaultControls, B as useTableSearch, C as formatCellValue, D as provideCellLocale, E as CellLocale, F as AS_PRESETS_APP, G as useTable, H as useTableNavBridge, I as injectPresetsApp, J as CreateStaticTableStateOptions, K as SelectionPersistence, L as UseTableUrlQueryOptions, M as UseAppPrefsOptions, N as UseAppPrefsReturn, O as useCellLocale, P as useAppPrefs, Q as createStaticTableState, R as useTableUrlQuery, S as extractIdentifier, T as getColumnWidth, U as UseTableOptions, V as useTableFilter, W as clearTableCache, X as TableContext, Y as CreateTableStateOptions, Z as TableStateInternals, _ as getDefaultClientFactory, a as PRESET_ASPECTS, at as usePresets, b as resolveSystemPresets, c as PresetData, ct as UseLocalDraftReturn, d as STANDARD_PRESET_ID, et as useTableContext, f as SYSTEM_PRESET_PREFIX, g as UserConfData, h as UrlQuerySync, i as ClientFactory, it as UsePresetsReturn, j as useTableComponent, k as createDefaultCellTypes, l as PresetSnapshot, lt as useLocalDraft, m as SystemPresetInput, n as AppConfData, nt as ActivePresetView, o as PresetAspect, ot as StorageLike, p as SystemPreset, q as useTableSelection, r as AsPresetEntryRow, rt as UsePresetsOptions, s as PresetCapabilities, st as UseLocalDraftOptions, t as _default$19, tt as useTableContextOptional, u as PresetSnapshotWire, v as isSystemPresetId, w as getCellValue, x as setDefaultClientFactory, y as resetDefaultClientFactory, z as useTableActions } from "./as-table-root.vue-DFCZwH1h.cjs";
-import { t as _default$15 } from "./as-table.vue-COtIbUsp.cjs";
-import { t as _default$20 } from "./as-window-table.vue-iLK4PSW_.cjs";
+import { _ as TableNavBridge, c as NavKeyOptions, d as ReactiveTableState, f as RowDeleteOpt, g as TableActionsState, h as TVueTableActionInfo, m as TAsTableControls, n as ColumnMenuConfig, o as InvokeOpts, p as TAsCellTypeComponents, r as ConfigTab, s as MainActionRequest, t as ActionResult, u as QueryErrorKind } from "./types-DAgdkjji.cjs";
+import { t as _default$16 } from "./as-table-actions.vue-62ZjZoIa.cjs";
+import { $ as createTableState, A as createDefaultControls, B as useTableSearch, C as formatCellValue, D as provideCellLocale, E as CellLocale, F as AS_PRESETS_APP, G as useTable, H as useTableNavBridge, I as injectPresetsApp, J as CreateStaticTableStateOptions, K as SelectionPersistence, L as UseTableUrlQueryOptions, M as UseAppPrefsOptions, N as UseAppPrefsReturn, O as useCellLocale, P as useAppPrefs, Q as createStaticTableState, R as useTableUrlQuery, S as extractIdentifier, T as getColumnWidth, U as UseTableOptions, V as useTableFilter, W as clearTableCache, X as TableContext, Y as CreateTableStateOptions, Z as TableStateInternals, _ as getDefaultClientFactory, a as PRESET_ASPECTS, at as usePresets, b as resolveSystemPresets, c as PresetData, ct as UseLocalDraftReturn, d as STANDARD_PRESET_ID, et as useTableContext, f as SYSTEM_PRESET_PREFIX, g as UserConfData, h as UrlQuerySync, i as ClientFactory, it as UsePresetsReturn, j as useTableComponent, k as createDefaultCellTypes, l as PresetSnapshot, lt as useLocalDraft, m as SystemPresetInput, n as AppConfData, nt as ActivePresetView, o as PresetAspect, ot as StorageLike, p as SystemPreset, q as useTableSelection, r as AsPresetEntryRow, rt as UsePresetsOptions, s as PresetCapabilities, st as UseLocalDraftOptions, t as _default$19, tt as useTableContextOptional, u as PresetSnapshotWire, v as isSystemPresetId, w as getCellValue, x as setDefaultClientFactory, y as resetDefaultClientFactory, z as useTableActions } from "./as-table-root.vue-D5Tp8U_d.cjs";
+import { t as _default$15 } from "./as-table.vue-53yyA7zP.cjs";
+import { t as _default$20 } from "./as-window-table.vue-DU6UdjA3.cjs";
 import { t as _default } from "./as-cell-array.vue-pFs5GcCR.cjs";
 import { t as _default$1 } from "./as-cell-date.vue-BBSps2B2.cjs";
 import { t as _default$2 } from "./as-cell-json.vue-C6wg4ARZ.cjs";
 import { t as _default$3 } from "./as-cell-number.vue-CJ2K5zeM.cjs";
 import { t as _default$4 } from "./as-cell-union.vue-CslPM_c2.cjs";
-import { t as _default$5 } from "./as-column-menu.vue-DZawdGvY.cjs";
+import { t as _default$5 } from "./as-column-menu.vue-BbdaVsNi.cjs";
 import { t as _default$6 } from "./as-config-dialog.vue-DvvJi3xx.cjs";
 import { t as _default$7 } from "./as-confirm-dialog.vue-CXxLpzbu.cjs";
 import { t as _default$8 } from "./as-filter-dialog.vue-BV2J8PgZ.cjs";
@@ -19,5 +19,5 @@ import { t as _default$10 } from "./as-filter-input.vue-CS4nOk_Q.cjs";
 import { t as _default$12 } from "./as-preset-dialog.vue-DP9fy00Y.cjs";
 import { t as _default$14 } from "./as-row-actions.vue-Bvcc2tUN.cjs";
 import { t as _default$17 } from "./as-table-cell-value.vue-BgFDv2JQ.cjs";
-import { t as _default$18 } from "./as-table-header-cell.vue-jvtDmqhR.cjs";
+import { t as _default$18 } from "./as-table-header-cell.vue-BjQUPdmH.cjs";
 export { AS_PRESETS_APP, ActionResult, ActivePresetView, AppConfData, _default as AsCellArray, _default$1 as AsCellDate, _default$2 as AsCellJson, _default$3 as AsCellNumber, _default$4 as AsCellUnion, _default$5 as AsColumnMenu, _default$6 as AsConfigDialog, _default$7 as AsConfirmDialog, _default$8 as AsFilterDialog, _default$9 as AsFilterField, _default$10 as AsFilterInput, _default$11 as AsFilters, _default$12 as AsPresetDialog, AsPresetEntryRow, _default$13 as AsPresetPicker, _default$14 as AsRowActions, _default$15 as AsTable, _default$16 as AsTableActions, _default$17 as AsTableCellValue, _default$18 as AsTableHeaderCell, _default$19 as AsTableRoot, _default$20 as AsWindowTable, CellLocale, ClientFactory, ColumnMenuConfig, ConfigTab, CreateStaticTableStateOptions, CreateTableStateOptions, InvokeOpts, MainActionRequest, NavKeyOptions, PRESET_ASPECTS, PresetAspect, PresetCapabilities, PresetData, PresetSnapshot, PresetSnapshotWire, QueryErrorKind, ReactiveTableState, RowDeleteOpt, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, SelectionPersistence, StorageLike, SystemPreset, SystemPresetInput, TAsCellTypeComponents, TAsTableControls, TVueTableActionInfo, TableActionsState, TableContext, TableNavBridge, TableStateInternals, UrlQuerySync, UseAppPrefsOptions, UseAppPrefsReturn, UseLocalDraftOptions, UseLocalDraftReturn, UsePresetsOptions, UsePresetsReturn, UseTableOptions, UseTableUrlQueryOptions, UserConfData, clearTableCache, createDefaultCellTypes, createDefaultControls, createStaticTableState, createTableState, extractIdentifier, formatCellValue, getCellValue, getColumnWidth, getDefaultClientFactory, injectPresetsApp, isSystemPresetId, provideCellLocale, resetDefaultClientFactory, resolveSystemPresets, setDefaultClientFactory, useAppPrefs, useCellLocale, useLocalDraft, usePresets, useTable, useTableActions, useTableComponent, useTableContext, useTableContextOptional, useTableFilter, useTableNavBridge, useTableSearch, useTableSelection, useTableUrlQuery };

package/dist/index.d.mts

@@ -1,16 +1,16 @@
 import { t as _default$11 } from "./as-filters.vue-DmECMd1v.mjs";
 import { t as _default$13 } from "./as-preset-picker.vue-BPjsiaVt.mjs";
-import { _ as TableNavBridge, c as NavKeyOptions, d as ReactiveTableState, f as RowDeleteOpt, g as TableActionsState, h as TVueTableActionInfo, m as TAsTableControls, n as ColumnMenuConfig, o as InvokeOpts, p as TAsCellTypeComponents, r as ConfigTab, s as MainActionRequest, t as ActionResult, u as QueryErrorKind } from "./types-BMvxn9iU.mjs";
-import { t as _default$16 } from "./as-table-actions.vue-CTC9xl5i.mjs";
-import { $ as createTableState, A as createDefaultControls, B as useTableSearch, C as formatCellValue, D as provideCellLocale, E as CellLocale, F as AS_PRESETS_APP, G as useTable, H as useTableNavBridge, I as injectPresetsApp, J as CreateStaticTableStateOptions, K as SelectionPersistence, L as UseTableUrlQueryOptions, M as UseAppPrefsOptions, N as UseAppPrefsReturn, O as useCellLocale, P as useAppPrefs, Q as createStaticTableState, R as useTableUrlQuery, S as extractIdentifier, T as getColumnWidth, U as UseTableOptions, V as useTableFilter, W as clearTableCache, X as TableContext, Y as CreateTableStateOptions, Z as TableStateInternals, _ as getDefaultClientFactory, a as PRESET_ASPECTS, at as usePresets, b as resolveSystemPresets, c as PresetData, ct as UseLocalDraftReturn, d as STANDARD_PRESET_ID, et as useTableContext, f as SYSTEM_PRESET_PREFIX, g as UserConfData, h as UrlQuerySync, i as ClientFactory, it as UsePresetsReturn, j as useTableComponent, k as createDefaultCellTypes, l as PresetSnapshot, lt as useLocalDraft, m as SystemPresetInput, n as AppConfData, nt as ActivePresetView, o as PresetAspect, ot as StorageLike, p as SystemPreset, q as useTableSelection, r as AsPresetEntryRow, rt as UsePresetsOptions, s as PresetCapabilities, st as UseLocalDraftOptions, t as _default$19, tt as useTableContextOptional, u as PresetSnapshotWire, v as isSystemPresetId, w as getCellValue, x as setDefaultClientFactory, y as resetDefaultClientFactory, z as useTableActions } from "./as-table-root.vue-C5IrebWr.mjs";
-import { t as _default$15 } from "./as-table.vue-CAydq1n0.mjs";
-import { t as _default$20 } from "./as-window-table.vue-BycvdZ82.mjs";
+import { _ as TableNavBridge, c as NavKeyOptions, d as ReactiveTableState, f as RowDeleteOpt, g as TableActionsState, h as TVueTableActionInfo, m as TAsTableControls, n as ColumnMenuConfig, o as InvokeOpts, p as TAsCellTypeComponents, r as ConfigTab, s as MainActionRequest, t as ActionResult, u as QueryErrorKind } from "./types-iSundY5p.mjs";
+import { t as _default$16 } from "./as-table-actions.vue-B2C_nC86.mjs";
+import { $ as createTableState, A as createDefaultControls, B as useTableSearch, C as formatCellValue, D as provideCellLocale, E as CellLocale, F as AS_PRESETS_APP, G as useTable, H as useTableNavBridge, I as injectPresetsApp, J as CreateStaticTableStateOptions, K as SelectionPersistence, L as UseTableUrlQueryOptions, M as UseAppPrefsOptions, N as UseAppPrefsReturn, O as useCellLocale, P as useAppPrefs, Q as createStaticTableState, R as useTableUrlQuery, S as extractIdentifier, T as getColumnWidth, U as UseTableOptions, V as useTableFilter, W as clearTableCache, X as TableContext, Y as CreateTableStateOptions, Z as TableStateInternals, _ as getDefaultClientFactory, a as PRESET_ASPECTS, at as usePresets, b as resolveSystemPresets, c as PresetData, ct as UseLocalDraftReturn, d as STANDARD_PRESET_ID, et as useTableContext, f as SYSTEM_PRESET_PREFIX, g as UserConfData, h as UrlQuerySync, i as ClientFactory, it as UsePresetsReturn, j as useTableComponent, k as createDefaultCellTypes, l as PresetSnapshot, lt as useLocalDraft, m as SystemPresetInput, n as AppConfData, nt as ActivePresetView, o as PresetAspect, ot as StorageLike, p as SystemPreset, q as useTableSelection, r as AsPresetEntryRow, rt as UsePresetsOptions, s as PresetCapabilities, st as UseLocalDraftOptions, t as _default$19, tt as useTableContextOptional, u as PresetSnapshotWire, v as isSystemPresetId, w as getCellValue, x as setDefaultClientFactory, y as resetDefaultClientFactory, z as useTableActions } from "./as-table-root.vue-DtJBjtoC.mjs";
+import { t as _default$15 } from "./as-table.vue-CdSb4IUc.mjs";
+import { t as _default$20 } from "./as-window-table.vue-DQPjWA3T.mjs";
 import { t as _default } from "./as-cell-array.vue-D4vS7C_D.mjs";
 import { t as _default$1 } from "./as-cell-date.vue-Chs7WTZ9.mjs";
 import { t as _default$2 } from "./as-cell-json.vue-C0_LDvQw.mjs";
 import { t as _default$3 } from "./as-cell-number.vue-BBF0OuU8.mjs";
 import { t as _default$4 } from "./as-cell-union.vue-CL-Lf-Rm.mjs";
-import { t as _default$5 } from "./as-column-menu.vue-csCNmAYR.mjs";
+import { t as _default$5 } from "./as-column-menu.vue-CwhbMgzZ.mjs";
 import { t as _default$6 } from "./as-config-dialog.vue-BvFZZRuY.mjs";
 import { t as _default$7 } from "./as-confirm-dialog.vue-Cz52-v6c.mjs";
 import { t as _default$8 } from "./as-filter-dialog.vue-likNLqzF.mjs";
@@ -19,5 +19,5 @@ import { t as _default$10 } from "./as-filter-input.vue-B9ma2l9j.mjs";
 import { t as _default$12 } from "./as-preset-dialog.vue-BRjjfPty.mjs";
 import { t as _default$14 } from "./as-row-actions.vue-DUSDuoR2.mjs";
 import { t as _default$17 } from "./as-table-cell-value.vue-kfNgVhzn.mjs";
-import { t as _default$18 } from "./as-table-header-cell.vue-DsVfhlk3.mjs";
+import { t as _default$18 } from "./as-table-header-cell.vue-PEFiv40i.mjs";
 export { AS_PRESETS_APP, ActionResult, ActivePresetView, AppConfData, _default as AsCellArray, _default$1 as AsCellDate, _default$2 as AsCellJson, _default$3 as AsCellNumber, _default$4 as AsCellUnion, _default$5 as AsColumnMenu, _default$6 as AsConfigDialog, _default$7 as AsConfirmDialog, _default$8 as AsFilterDialog, _default$9 as AsFilterField, _default$10 as AsFilterInput, _default$11 as AsFilters, _default$12 as AsPresetDialog, AsPresetEntryRow, _default$13 as AsPresetPicker, _default$14 as AsRowActions, _default$15 as AsTable, _default$16 as AsTableActions, _default$17 as AsTableCellValue, _default$18 as AsTableHeaderCell, _default$19 as AsTableRoot, _default$20 as AsWindowTable, CellLocale, ClientFactory, ColumnMenuConfig, ConfigTab, CreateStaticTableStateOptions, CreateTableStateOptions, InvokeOpts, MainActionRequest, NavKeyOptions, PRESET_ASPECTS, PresetAspect, PresetCapabilities, PresetData, PresetSnapshot, PresetSnapshotWire, QueryErrorKind, ReactiveTableState, RowDeleteOpt, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, SelectionPersistence, StorageLike, SystemPreset, SystemPresetInput, TAsCellTypeComponents, TAsTableControls, TVueTableActionInfo, TableActionsState, TableContext, TableNavBridge, TableStateInternals, UrlQuerySync, UseAppPrefsOptions, UseAppPrefsReturn, UseLocalDraftOptions, UseLocalDraftReturn, UsePresetsOptions, UsePresetsReturn, UseTableOptions, UseTableUrlQueryOptions, UserConfData, clearTableCache, createDefaultCellTypes, createDefaultControls, createStaticTableState, createTableState, extractIdentifier, formatCellValue, getCellValue, getColumnWidth, getDefaultClientFactory, injectPresetsApp, isSystemPresetId, provideCellLocale, resetDefaultClientFactory, resolveSystemPresets, setDefaultClientFactory, useAppPrefs, useCellLocale, useLocalDraft, usePresets, useTable, useTableActions, useTableComponent, useTableContext, useTableContextOptional, useTableFilter, useTableNavBridge, useTableSearch, useTableSelection, useTableUrlQuery };

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { _ as ROW_ACTIONS_TYPE, a as useTableContext, f as extractIdentifier, n as createTableState, o as useTableContextOptional, t as createStaticTableState } from "./use-table-state-BHAwfUKw.mjs";
+import { _ as ROW_ACTIONS_TYPE, a as useTableContext, f as extractIdentifier, n as createTableState, o as useTableContextOptional, t as createStaticTableState } from "./use-table-state-kxv6_Biy.mjs";
 import { n as useTableSelection } from "./use-table-selection-C84z4OZy.mjs";
-import { a as AS_PRESETS_APP, i as useLocalDraft, n as useTable, o as injectPresetsApp, r as usePresets, t as clearTableCache } from "./use-table-CGxkBszK.mjs";
-import { t as useTableNavBridge } from "./use-table-nav-bridge-C3gqHOIa.mjs";
-import { t as useTableComponent } from "./use-table-component-ClgvnuRH.mjs";
+import { a as AS_PRESETS_APP, i as useLocalDraft, n as useTable, o as injectPresetsApp, r as usePresets, t as clearTableCache } from "./use-table-ClKUAYU4.mjs";
+import { t as useTableNavBridge } from "./use-table-nav-bridge-0WVZrMv9.mjs";
+import { t as useTableComponent } from "./use-table-component-QIECHhdZ.mjs";
 import { t as getCellValue } from "./get-cell-value-C8LLc_Rr.mjs";
 import { t as as_cell_array_default } from "./as-cell-array-2qmJ1lT2.mjs";
 import { t as as_cell_date_default } from "./as-cell-date-BwFgi6O0.mjs";
@@ -12,21 +12,21 @@ import { t as as_cell_number_default } from "./as-cell-number-DKRaS9pM.mjs";
 import { t as formatCellValue } from "./format-cell-D1Ziv96Q.mjs";
 import { t as as_cell_union_default } from "./as-cell-union-C9FukGqF.mjs";
 import { t as as_column_menu_default } from "./as-column-menu-kTIQfLTi.mjs";
-import { t as as_config_dialog_default } from "./as-config-dialog-DAqSy8zx.mjs";
-import { t as as_confirm_dialog_default } from "./as-confirm-dialog-B1zuisFu.mjs";
+import { t as as_config_dialog_default } from "./as-config-dialog-Dvnlubkp.mjs";
+import { t as as_confirm_dialog_default } from "./as-confirm-dialog-DLR2ejrF.mjs";
 import { t as as_filter_input_default } from "./as-filter-input-BM23TNeh.mjs";
-import { t as as_filter_dialog_default } from "./as-filter-dialog-BIj0ABzy.mjs";
-import { t as as_table_header_cell_default } from "./as-table-header-cell-mCOAZsjL.mjs";
-import { t as as_window_table_default } from "./as-window-table-DONQh4nM.mjs";
-import { t as as_filter_field_default } from "./as-filter-field-9mG-alNU.mjs";
-import { t as as_filters_default } from "./as-filters-BSQ3nugx.mjs";
-import { t as as_preset_dialog_default } from "./as-preset-dialog-CuWw5fuN.mjs";
-import { t as as_row_actions_default } from "./as-row-actions-DIpn-EYD.mjs";
+import { t as as_filter_dialog_default } from "./as-filter-dialog-CiIPgmt8.mjs";
+import { t as as_table_header_cell_default } from "./as-table-header-cell-BlDhjZNp.mjs";
+import { t as as_window_table_default } from "./as-window-table-C3o72zaM.mjs";
+import { t as as_filter_field_default } from "./as-filter-field-C3wmTg22.mjs";
+import { t as as_filters_default } from "./as-filters-Dmn0ykIo.mjs";
+import { t as as_preset_dialog_default } from "./as-preset-dialog-B3fC0Eqc.mjs";
+import { t as as_row_actions_default } from "./as-row-actions-C4mSAqeh.mjs";
 import { t as as_table_cell_value_default } from "./as-table-cell-value-CPcFxSOj.mjs";
-import { t as as_table_root_default } from "./as-table-root-BQNXfIvB.mjs";
-import { t as as_table_default } from "./as-table-QkKHAIh6.mjs";
-import { t as as_table_actions_default } from "./as-table-actions-DQ3xaFXJ.mjs";
-import { t as as_preset_picker_default } from "./as-preset-picker-CyBbOnBS.mjs";
+import { t as as_table_root_default } from "./as-table-root-IzffHCVo.mjs";
+import { t as as_table_default } from "./as-table-DnUc3TB1.mjs";
+import { t as as_table_actions_default } from "./as-table-actions-Ct3tEarY.mjs";
+import { t as as_preset_picker_default } from "./as-preset-picker-B9hw2qc8.mjs";
 import { getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
 import { computed, effectScope, ref, shallowRef } from "vue";
 import { AppPrefsClient, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, columnFilterType, conditionsForType, defaultCondition, isAuthError, isFilled, isSystemPresetId, resolveSystemPresets } from "@atscript/ui-table";

package/dist/{types-BMvxn9iU.d.mts → types-DAgdkjji.d.cts}

@@ -1,7 +1,7 @@
-import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
 import { Component, ComputedRef, Ref, ShallowRef } from "vue";
-import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
 import { ClientError, TDbActionInfo, TDbActionProcessor, TDbDeleteResult } from "@atscript/db-client";
+import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
+import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
 
 //#region src/types.d.ts
 /** UI-side sentinel for the synthesised row-delete processor. */
@@ -325,6 +325,16 @@ interface ReactiveTableState extends TableStateMethods {
   } | null>;
   mustRefresh: Ref<boolean>;
   searchTerm: Ref<string>;
+  /**
+   * Runtime "preserve search relevance" flag (a model — read/write). While
+   * `true` AND `searchTerm` is non-empty, user `sorters` are omitted from the
+   * query so the backend's relevance ranking survives; `forceSorters` still
+   * apply and `sorters` itself is never mutated (suppression is query-time
+   * only). Any write to `sorters` during an active search flips this to
+   * `false` for the current search session; a new session (empty →
+   * non-empty `searchTerm`) resets it to the configured default.
+   */
+  ignoreSortersWhenSearched: Ref<boolean>;
   configDialogOpen: Ref<boolean>;
   configTab: Ref<ConfigTab>;
   /** Selected row values (PKs extracted via `rowValueFn`). */

package/dist/{types-CDJmLD-E.d.cts → types-iSundY5p.d.mts}

@@ -1,7 +1,7 @@
-import { Component, ComputedRef, Ref, ShallowRef } from "vue";
-import { ClientError, TDbActionInfo, TDbActionProcessor, TDbDeleteResult } from "@atscript/db-client";
 import { ColumnDef, PaginationControl, SortControl, TableDef } from "@atscript/ui";
+import { Component, ComputedRef, Ref, ShallowRef } from "vue";
 import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
+import { ClientError, TDbActionInfo, TDbActionProcessor, TDbDeleteResult } from "@atscript/db-client";
 
 //#region src/types.d.ts
 /** UI-side sentinel for the synthesised row-delete processor. */
@@ -325,6 +325,16 @@ interface ReactiveTableState extends TableStateMethods {
   } | null>;
   mustRefresh: Ref<boolean>;
   searchTerm: Ref<string>;
+  /**
+   * Runtime "preserve search relevance" flag (a model — read/write). While
+   * `true` AND `searchTerm` is non-empty, user `sorters` are omitted from the
+   * query so the backend's relevance ranking survives; `forceSorters` still
+   * apply and `sorters` itself is never mutated (suppression is query-time
+   * only). Any write to `sorters` during an active search flips this to
+   * `false` for the current search session; a new session (empty →
+   * non-empty `searchTerm`) resets it to the configured default.
+   */
+  ignoreSortersWhenSearched: Ref<boolean>;
   configDialogOpen: Ref<boolean>;
   configTab: Ref<ConfigTab>;
   /** Selected row values (PKs extracted via `rowValueFn`). */

package/dist/{use-table-CGxkBszK.mjs → use-table-ClKUAYU4.mjs}

@@ -1,4 +1,4 @@
-import { n as createTableState, r as provideTableContext, s as DEFAULT_AVAILABLE_ASPECTS } from "./use-table-state-BHAwfUKw.mjs";
+import { n as createTableState, r as provideTableContext, s as DEFAULT_AVAILABLE_ASPECTS } from "./use-table-state-kxv6_Biy.mjs";
 import { n as useTableSelection } from "./use-table-selection-C84z4OZy.mjs";
 import { createTableDef, getMetaEntry, resetMetaCache } from "@atscript/ui";
 import { computed, inject, isRef, ref, shallowRef, watch } from "vue";
@@ -389,7 +389,8 @@ function useTable(url, opts) {
 			filterFields: opts?.filterFields,
 			columnNames: opts?.columnNames,
 			columnWidths: opts?.columnWidths,
-			sorters: opts?.sorters
+			sorters: opts?.sorters,
+			ignoreSortersWhenSearched: typeof opts?.ignoreSortersWhenSearched === "object" ? opts.ignoreSortersWhenSearched : void 0
 		},
 		query: {
 			fn: opts?.queryFn,
@@ -398,6 +399,7 @@ function useTable(url, opts) {
 			alwaysSelected: opts?.alwaysSelected,
 			blockQuery: opts?.blockQuery,
 			queryOnMount: opts?.queryOnMount,
+			ignoreSortersWhenSearched: typeof opts?.ignoreSortersWhenSearched === "boolean" ? opts.ignoreSortersWhenSearched : void 0,
 			urlQueryReady: opts?.urlQueryReady,
 			onUrlQueryChange: opts?.onUrlQueryChange,
 			urlQuerySync: opts?.urlQuerySync

package/dist/{use-table-CaegBdPZ.cjs → use-table-Dwl4JoZR.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-152Ejpyo.cjs");
+const require_use_table_state = require("./use-table-state-CI8i5m7s.cjs");
 const require_use_table_selection = require("./use-table-selection-Cmiu1h4S.cjs");
 let _atscript_ui = require("@atscript/ui");
 let vue = require("vue");
@@ -389,7 +389,8 @@ function useTable(url, opts) {
 			filterFields: opts?.filterFields,
 			columnNames: opts?.columnNames,
 			columnWidths: opts?.columnWidths,
-			sorters: opts?.sorters
+			sorters: opts?.sorters,
+			ignoreSortersWhenSearched: typeof opts?.ignoreSortersWhenSearched === "object" ? opts.ignoreSortersWhenSearched : void 0
 		},
 		query: {
 			fn: opts?.queryFn,
@@ -398,6 +399,7 @@ function useTable(url, opts) {
 			alwaysSelected: opts?.alwaysSelected,
 			blockQuery: opts?.blockQuery,
 			queryOnMount: opts?.queryOnMount,
+			ignoreSortersWhenSearched: typeof opts?.ignoreSortersWhenSearched === "boolean" ? opts.ignoreSortersWhenSearched : void 0,
 			urlQueryReady: opts?.urlQueryReady,
 			onUrlQueryChange: opts?.onUrlQueryChange,
 			urlQuerySync: opts?.urlQuerySync

package/dist/{use-table-component-ClgvnuRH.mjs → use-table-component-QIECHhdZ.mjs}

@@ -1,4 +1,4 @@
-import { o as useTableContextOptional } from "./use-table-state-BHAwfUKw.mjs";
+import { o as useTableContextOptional } from "./use-table-state-kxv6_Biy.mjs";
 //#region src/composables/use-table-component.ts
 /**
 * Resolve a single skin-slot component from the injected `controls` map,

package/dist/{use-table-component-D-1kzctZ.cjs → use-table-component-xSoXI7Jm.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-152Ejpyo.cjs");
+const require_use_table_state = require("./use-table-state-CI8i5m7s.cjs");
 //#region src/composables/use-table-component.ts
 /**
 * Resolve a single skin-slot component from the injected `controls` map,

package/dist/{use-table-nav-bridge-C3gqHOIa.mjs → use-table-nav-bridge-0WVZrMv9.mjs}

@@ -1,4 +1,4 @@
-import { o as useTableContextOptional } from "./use-table-state-BHAwfUKw.mjs";
+import { o as useTableContextOptional } from "./use-table-state-kxv6_Biy.mjs";
 //#region src/composables/use-table-nav-bridge.ts
 function isPassthroughKey(event) {
 	const key = event.key;

package/dist/{use-table-nav-bridge-bZIH2d6Y.cjs → use-table-nav-bridge-Cs4R_6F2.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-152Ejpyo.cjs");
+const require_use_table_state = require("./use-table-state-CI8i5m7s.cjs");
 //#region src/composables/use-table-nav-bridge.ts
 function isPassthroughKey(event) {
 	const key = event.key;

package/dist/{use-table-state-152Ejpyo.cjs → use-table-state-CI8i5m7s.cjs}

@@ -1264,6 +1264,19 @@ function createTableState(opts) {
 	}
 	const mustRefresh = (0, vue.ref)(false);
 	const searchTerm = (0, vue.ref)("");
+	const ignoreSortersDefault = modelOpts?.ignoreSortersWhenSearched?.value ?? queryOpts?.ignoreSortersWhenSearched ?? false;
+	const ignoreSortersWhenSearched = modelOpts?.ignoreSortersWhenSearched ?? (0, vue.ref)(ignoreSortersDefault);
+	let internalIgnoreSortersWrite = false;
+	function setIgnoreSortersInternal(v) {
+		if (ignoreSortersWhenSearched.value === v) return;
+		if (!internalIgnoreSortersWrite) {
+			internalIgnoreSortersWrite = true;
+			(0, vue.nextTick)(() => {
+				internalIgnoreSortersWrite = false;
+			});
+		}
+		ignoreSortersWhenSearched.value = v;
+	}
 	const configDialogOpen = (0, vue.ref)(false);
 	const configTab = (0, vue.ref)("columns");
 	const filterDialogColumn = (0, vue.ref)(null);
@@ -1325,6 +1338,7 @@ function createTableState(opts) {
 			filters: filters.value,
 			forceFilters: queryOpts?.forceFilters,
 			search: searchTerm.value || void 0,
+			ignoreSorters: ignoreSortersWhenSearched.value && !!searchTerm.value,
 			includeActions: includeActions.value
 		});
 	}
@@ -1510,6 +1524,7 @@ function createTableState(opts) {
 		lastError,
 		mustRefresh,
 		searchTerm,
+		ignoreSortersWhenSearched,
 		configDialogOpen,
 		configTab,
 		filterDialogColumn,
@@ -1603,9 +1618,11 @@ function createTableState(opts) {
 			sorters: sorters.value,
 			page: pagination.value.page,
 			itemsPerPage: pagination.value.itemsPerPage,
-			searchTerm: searchTerm.value
+			searchTerm: searchTerm.value,
+			ignoreSorters: ignoreSortersWhenSearched.value
 		}, {
 			defaultItemsPerPage: urlDefaultItemsPerPage,
+			defaultIgnoreSorters: ignoreSortersDefault,
 			sync: urlQuerySync
 		});
 	}
@@ -1644,15 +1661,25 @@ function createTableState(opts) {
 			for (const path in parsed.filters) next[path] = parsed.filters[path];
 			filters.value = next;
 		}
-		if ((0, _atscript_ui_table.resolveAspectGate)(urlQuerySync?.sorters) !== "none") {
+		const sortersGate = (0, _atscript_ui_table.resolveAspectGate)(urlQuerySync?.sorters);
+		let urlSortersChanged = false;
+		if (sortersGate !== "none") {
 			const urlFields = /* @__PURE__ */ new Set();
 			for (const s of parsed.sorters) urlFields.add(s.field);
 			const merged = [...sorters.value.filter((s) => !urlFields.has(s.field)), ...parsed.sorters];
-			if (!(0, _atscript_ui_table.sortersEqual)(sorters.value, merged)) sorters.value = merged;
+			if (!(0, _atscript_ui_table.sortersEqual)(sorters.value, merged)) {
+				sorters.value = merged;
+				urlSortersChanged = true;
+			}
 		}
+		const searchWasActive = !!searchTerm.value;
 		if (urlQuerySync?.search !== false) {
 			if (searchTerm.value !== parsed.searchTerm) searchTerm.value = parsed.searchTerm;
 		}
+		const searchNowActive = !!searchTerm.value;
+		if (!searchWasActive && searchNowActive) setIgnoreSortersInternal(ignoreSortersDefault);
+		else if (urlSortersChanged && searchWasActive && searchNowActive) setIgnoreSortersInternal(false);
+		if (parsed.ignoreSorters !== void 0) setIgnoreSortersInternal(parsed.ignoreSorters);
 		if (urlQuerySync?.pagination !== false) {
 			if (pagination.value.page !== nextPage) pagination.value = {
 				...pagination.value,
@@ -1688,9 +1715,21 @@ function createTableState(opts) {
 	(0, vue.watch)(() => sorters.value, (next, prev) => {
 		if (hydratingFromUrl) return;
 		if ((0, _atscript_ui_table.sortersEqual)(prev, next)) return;
+		if (searchTerm.value) setIgnoreSortersInternal(false);
 		if (!queryDetected) return;
 		requestRefresh();
 	}, { immediate: false });
+	(0, vue.watch)(() => searchTerm.value, (next, prev) => {
+		if (hydratingFromUrl) return;
+		if (!prev && next) setIgnoreSortersInternal(ignoreSortersDefault);
+	});
+	(0, vue.watch)(() => ignoreSortersWhenSearched.value, () => {
+		if (internalIgnoreSortersWrite) return;
+		if (hydratingFromUrl) return;
+		if (!queryDetected) return;
+		if (!searchTerm.value) return;
+		requestRefresh();
+	});
 	(0, vue.watch)(() => columnNames.value, (next, prev) => {
 		if (!queryDetected) return;
 		if ((0, _atscript_ui_table.sameColumnSet)(prev, next)) return;
@@ -1710,7 +1749,8 @@ function createTableState(opts) {
 		() => filters.value,
 		() => sorters.value,
 		() => searchTerm.value,
-		() => pagination.value
+		() => pagination.value,
+		() => ignoreSortersWhenSearched.value
 	], () => emitUrlIfChanged());
 	(0, vue.watch)(() => includeActions.value, () => {
 		if (!queryDetected) return;

package/dist/{use-table-state-BHAwfUKw.mjs → use-table-state-kxv6_Biy.mjs}

@@ -1264,6 +1264,19 @@ function createTableState(opts) {
 	}
 	const mustRefresh = ref(false);
 	const searchTerm = ref("");
+	const ignoreSortersDefault = modelOpts?.ignoreSortersWhenSearched?.value ?? queryOpts?.ignoreSortersWhenSearched ?? false;
+	const ignoreSortersWhenSearched = modelOpts?.ignoreSortersWhenSearched ?? ref(ignoreSortersDefault);
+	let internalIgnoreSortersWrite = false;
+	function setIgnoreSortersInternal(v) {
+		if (ignoreSortersWhenSearched.value === v) return;
+		if (!internalIgnoreSortersWrite) {
+			internalIgnoreSortersWrite = true;
+			nextTick(() => {
+				internalIgnoreSortersWrite = false;
+			});
+		}
+		ignoreSortersWhenSearched.value = v;
+	}
 	const configDialogOpen = ref(false);
 	const configTab = ref("columns");
 	const filterDialogColumn = ref(null);
@@ -1325,6 +1338,7 @@ function createTableState(opts) {
 			filters: filters.value,
 			forceFilters: queryOpts?.forceFilters,
 			search: searchTerm.value || void 0,
+			ignoreSorters: ignoreSortersWhenSearched.value && !!searchTerm.value,
 			includeActions: includeActions.value
 		});
 	}
@@ -1510,6 +1524,7 @@ function createTableState(opts) {
 		lastError,
 		mustRefresh,
 		searchTerm,
+		ignoreSortersWhenSearched,
 		configDialogOpen,
 		configTab,
 		filterDialogColumn,
@@ -1603,9 +1618,11 @@ function createTableState(opts) {
 			sorters: sorters.value,
 			page: pagination.value.page,
 			itemsPerPage: pagination.value.itemsPerPage,
-			searchTerm: searchTerm.value
+			searchTerm: searchTerm.value,
+			ignoreSorters: ignoreSortersWhenSearched.value
 		}, {
 			defaultItemsPerPage: urlDefaultItemsPerPage,
+			defaultIgnoreSorters: ignoreSortersDefault,
 			sync: urlQuerySync
 		});
 	}
@@ -1644,15 +1661,25 @@ function createTableState(opts) {
 			for (const path in parsed.filters) next[path] = parsed.filters[path];
 			filters.value = next;
 		}
-		if (resolveAspectGate(urlQuerySync?.sorters) !== "none") {
+		const sortersGate = resolveAspectGate(urlQuerySync?.sorters);
+		let urlSortersChanged = false;
+		if (sortersGate !== "none") {
 			const urlFields = /* @__PURE__ */ new Set();
 			for (const s of parsed.sorters) urlFields.add(s.field);
 			const merged = [...sorters.value.filter((s) => !urlFields.has(s.field)), ...parsed.sorters];
-			if (!sortersEqual(sorters.value, merged)) sorters.value = merged;
+			if (!sortersEqual(sorters.value, merged)) {
+				sorters.value = merged;
+				urlSortersChanged = true;
+			}
 		}
+		const searchWasActive = !!searchTerm.value;
 		if (urlQuerySync?.search !== false) {
 			if (searchTerm.value !== parsed.searchTerm) searchTerm.value = parsed.searchTerm;
 		}
+		const searchNowActive = !!searchTerm.value;
+		if (!searchWasActive && searchNowActive) setIgnoreSortersInternal(ignoreSortersDefault);
+		else if (urlSortersChanged && searchWasActive && searchNowActive) setIgnoreSortersInternal(false);
+		if (parsed.ignoreSorters !== void 0) setIgnoreSortersInternal(parsed.ignoreSorters);
 		if (urlQuerySync?.pagination !== false) {
 			if (pagination.value.page !== nextPage) pagination.value = {
 				...pagination.value,
@@ -1688,9 +1715,21 @@ function createTableState(opts) {
 	watch(() => sorters.value, (next, prev) => {
 		if (hydratingFromUrl) return;
 		if (sortersEqual(prev, next)) return;
+		if (searchTerm.value) setIgnoreSortersInternal(false);
 		if (!queryDetected) return;
 		requestRefresh();
 	}, { immediate: false });
+	watch(() => searchTerm.value, (next, prev) => {
+		if (hydratingFromUrl) return;
+		if (!prev && next) setIgnoreSortersInternal(ignoreSortersDefault);
+	});
+	watch(() => ignoreSortersWhenSearched.value, () => {
+		if (internalIgnoreSortersWrite) return;
+		if (hydratingFromUrl) return;
+		if (!queryDetected) return;
+		if (!searchTerm.value) return;
+		requestRefresh();
+	});
 	watch(() => columnNames.value, (next, prev) => {
 		if (!queryDetected) return;
 		if (sameColumnSet(prev, next)) return;
@@ -1710,7 +1749,8 @@ function createTableState(opts) {
 		() => filters.value,
 		() => sorters.value,
 		() => searchTerm.value,
-		() => pagination.value
+		() => pagination.value,
+		() => ignoreSortersWhenSearched.value
 	], () => emitUrlIfChanged());
 	watch(() => includeActions.value, () => {
 		if (!queryDetected) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/vue-table",
-  "version": "0.1.111",
+  "version": "0.1.112",
   "description": "Type-driven table components for Atscript with Vue 3",
   "keywords": [
     "atscript",
@@ -162,9 +162,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@atscript/ui": "^0.1.111",
-    "@atscript/vue-form": "^0.1.111",
-    "@atscript/ui-table": "^0.1.111"
+    "@atscript/ui": "^0.1.112",
+    "@atscript/ui-table": "^0.1.112",
+    "@atscript/vue-form": "^0.1.112"
   },
   "devDependencies": {
     "@atscript/db-client": "^0.1.111",