@atscript/vue-table 0.1.111 → 0.1.113

package/dist/{as-table-actions.vue-CTC9xl5i.d.mts → as-table-actions.vue-WXkllHVw.d.cts}

@@ -1,4 +1,4 @@
-import { h as TVueTableActionInfo } from "./types-BMvxn9iU.mjs";
+import { h as TVueTableActionInfo } from "./types-CTMxE_zA.cjs";
 import * as vue from "vue";
 
 //#region src/components/as-table-actions.vue.d.ts
@@ -18,20 +18,20 @@ declare var __VLS_1: {
     defaultAction: TVueTableActionInfo | undefined;
     otherActions: TVueTableActionInfo[];
     trailingRowActions: TVueTableActionInfo[];
-    level: "rows" | "table" | "row";
+    level: "row" | "rows" | "table";
     ids: Record<string, unknown>[];
     invoke: typeof invokeWith;
-  }, __VLS_3: {
+  }, __VLS_12: {
     action: TVueTableActionInfo;
-  }, __VLS_32: {
+  }, __VLS_42: {
     action: TVueTableActionInfo;
   };
 type __VLS_Slots = {} & {
   default?: (props: typeof __VLS_1) => any;
 } & {
-  button?: (props: typeof __VLS_3) => any;
+  button?: (props: typeof __VLS_12) => any;
 } & {
-  'menu-item'?: (props: typeof __VLS_32) => any;
+  'menu-item'?: (props: typeof __VLS_42) => any;
 };
 declare const __VLS_base: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
   level: "auto" | "table" | "rows" | "row";

package/dist/{as-table-base-DImVUSKt.cjs → as-table-base-1uBBmFuL.cjs}

@@ -1,6 +1,6 @@
-const require_use_table_state = require("./use-table-state-152Ejpyo.cjs");
+const require_use_table_state = require("./use-table-state-CElgF_iy.cjs");
 const require_get_cell_value = require("./get-cell-value-4rHKP-TG.cjs");
-const require_as_table_status = require("./as-table-status-C3A1WYwb.cjs");
+const require_as_table_status = require("./as-table-status-2eUIHBmk.cjs");
 let vue = require("vue");
 let _atscript_ui_table = require("@atscript/ui-table");
 let _vueuse_core = require("@vueuse/core");

package/dist/{as-table-base-D4Otzbe4.mjs → as-table-base-DOvVedJg.mjs}

@@ -1,6 +1,6 @@
-import { o as useTableContextOptional } from "./use-table-state-BHAwfUKw.mjs";
+import { o as useTableContextOptional } from "./use-table-state-Dju5bxt8.mjs";
 import { t as getCellValue } from "./get-cell-value-C8LLc_Rr.mjs";
-import { a as useCellComponents, n as as_table_header_default, o as useCellResolver, r as as_table_colgroup_default, t as as_table_status_default } from "./as-table-status-CxkiQ_EE.mjs";
+import { a as useCellComponents, n as as_table_header_default, o as useCellResolver, r as as_table_colgroup_default, t as as_table_status_default } from "./as-table-status-Dy3rA0T-.mjs";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createVNode, defineComponent, guardReactiveProps, mergeProps, nextTick, normalizeClass, normalizeProps, normalizeStyle, onMounted, openBlock, ref, renderList, renderSlot, resolveDynamicComponent, unref, useSlots, watch, withCtx } from "vue";
 import { DEFAULT_ROW_HEIGHT_PX, filledFilterCount } from "@atscript/ui-table";
 import { useParentElement, useResizeObserver } from "@vueuse/core";

package/dist/{as-table-header-cell-BEwpWr4m.cjs → as-table-header-cell-DD6Tw87_.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_component = require("./use-table-component-D-1kzctZ.cjs");
+const require_use_table_component = require("./use-table-component-QDcfYIBU.cjs");
 const require_as_column_menu = require("./as-column-menu-fZVbJ9lU.cjs");
 let vue = require("vue");
 let _atscript_ui_table = require("@atscript/ui-table");

package/dist/{as-table-header-cell-mCOAZsjL.mjs → as-table-header-cell-DfjfNeq4.mjs}

@@ -1,4 +1,4 @@
-import { t as useTableComponent } from "./use-table-component-ClgvnuRH.mjs";
+import { t as useTableComponent } from "./use-table-component-Bu7CIG5I.mjs";
 import { t as as_column_menu_default } from "./as-column-menu-kTIQfLTi.mjs";
 import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, normalizeClass, openBlock, resolveDynamicComponent, toDisplayString, unref, withCtx, withModifiers } from "vue";
 import { isFilled } from "@atscript/ui-table";

package/dist/as-table-header-cell.cjs

@@ -1,2 +1,2 @@
-const require_as_table_header_cell = require("./as-table-header-cell-BEwpWr4m.cjs");
+const require_as_table_header_cell = require("./as-table-header-cell-DD6Tw87_.cjs");
 module.exports = require_as_table_header_cell.as_table_header_cell_default;

package/dist/as-table-header-cell.d.cts

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-header-cell.vue-jvtDmqhR.cjs";
+import { t as _default } from "./as-table-header-cell.vue-BzTzfGRo.cjs";
 export = _default;

package/dist/as-table-header-cell.d.mts

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-header-cell.vue-DsVfhlk3.mjs";
+import { t as _default } from "./as-table-header-cell.vue-BCszzxtU.mjs";
 export { _default as default };

package/dist/as-table-header-cell.mjs

@@ -1,2 +1,2 @@
-import { t as as_table_header_cell_default } from "./as-table-header-cell-mCOAZsjL.mjs";
+import { t as as_table_header_cell_default } from "./as-table-header-cell-DfjfNeq4.mjs";
 export { as_table_header_cell_default as default };

package/dist/{as-table-header-cell.vue-DsVfhlk3.d.mts → as-table-header-cell.vue-BCszzxtU.d.mts}

@@ -1,4 +1,4 @@
-import { n as ColumnMenuConfig } from "./types-BMvxn9iU.mjs";
+import { n as ColumnMenuConfig } from "./types-ByU4O0Yf.mjs";
 import { ColumnDef } from "@atscript/ui";
 import * as vue from "vue";
 import { ColumnWidthEntry, FilterCondition } from "@atscript/ui-table";

package/dist/{as-table-header-cell.vue-jvtDmqhR.d.cts → as-table-header-cell.vue-BzTzfGRo.d.cts}

@@ -1,4 +1,4 @@
-import { n as ColumnMenuConfig } from "./types-CDJmLD-E.cjs";
+import { n as ColumnMenuConfig } from "./types-CTMxE_zA.cjs";
 import * as vue from "vue";
 import { ColumnDef } from "@atscript/ui";
 import { ColumnWidthEntry, FilterCondition } from "@atscript/ui-table";

package/dist/{as-table-root-BQNXfIvB.mjs → as-table-root-BSbO16CM.mjs}

@@ -1,8 +1,8 @@
-import { i as useRegisterMainActionListener } from "./use-table-state-BHAwfUKw.mjs";
-import { n as useTable } from "./use-table-CGxkBszK.mjs";
-import { t as useTableNavBridge } from "./use-table-nav-bridge-C3gqHOIa.mjs";
+import { i as useRegisterMainActionListener } from "./use-table-state-Dju5bxt8.mjs";
+import { n as useTable } from "./use-table-DHN_frAf.mjs";
+import { t as useTableNavBridge } from "./use-table-nav-bridge-CVO5_ttZ.mjs";
 import { t as useHasEmitListener } from "./use-has-emit-listener-BTMDIv2e.mjs";
-import { t as as_confirm_dialog_default } from "./as-confirm-dialog-B1zuisFu.mjs";
+import { t as as_confirm_dialog_default } from "./as-confirm-dialog-DlZzfASO.mjs";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, defineAsyncComponent, defineComponent, mergeModels, openBlock, ref, renderSlot, resolveDynamicComponent, unref, useModel, watch } from "vue";
 //#endregion
 //#region src/components/as-table-root.vue
@@ -88,6 +88,10 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 			required: false,
 			default: true
 		},
+		resolveHref: {
+			type: Function,
+			required: false
+		},
 		urlQuerySync: {
 			type: Object,
 			required: false
@@ -117,6 +121,11 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 			default: () => []
 		},
 		"sortersModifiers": {},
+		"ignoreSortersWhenSearched": {
+			type: Boolean,
+			default: false
+		},
+		"ignoreSortersWhenSearchedModifiers": {},
 		"selectedRows": {
 			type: Array,
 			default: () => []
@@ -133,6 +142,7 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 		"update:columnNames",
 		"update:columnWidths",
 		"update:sorters",
+		"update:ignoreSortersWhenSearched",
 		"update:selectedRows",
 		"update:urlQuery"
 	]),
@@ -147,6 +157,14 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 		const columnNames = useModel(__props, "columnNames");
 		const columnWidths = useModel(__props, "columnWidths");
 		const sorters = useModel(__props, "sorters");
+		/**
+		* Opt-in for relevance-ranked backends (e.g. Atlas Search): while true AND a
+		* search term is active, user sorters are omitted from the query so relevance
+		* ranking survives (`forceSorters` still apply). Usable as a plain prop
+		* (`:ignore-sorters-when-searched="true"` sets the configured default) or as
+		* `v-model:ignore-sorters-when-searched` to observe/drive the runtime flag.
+		*/
+		const ignoreSortersWhenSearched = useModel(__props, "ignoreSortersWhenSearched");
 		const selectedRows = useModel(__props, "selectedRows");
 		/**
 		* Bidirectional URL bridge bound via `v-model:url-query`. When unbound the
@@ -175,6 +193,7 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 			formTypes: props.formTypes,
 			formComponents: props.formComponents,
 			refreshOnAction: () => props.refreshOnAction,
+			resolveHref: props.resolveHref,
 			onActionResolved: (action, ids, result, event) => {
 				emit("action", action, ids, result, event);
 			},
@@ -182,6 +201,7 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 			columnNames,
 			columnWidths,
 			sorters,
+			ignoreSortersWhenSearched,
 			selectedRows,
 			urlQueryReady: urlQueryActive ? urlQueryReady : void 0,
 			onUrlQueryChange: urlQueryActive ? (s) => urlQuery.value = s : void 0,
@@ -245,6 +265,7 @@ var as_table_root_default = /* @__PURE__ */ defineComponent({
 					metadataError: unref(state).metadataError.value,
 					mustRefresh: unref(state).mustRefresh.value,
 					searchTerm: unref(state).searchTerm.value,
+					ignoreSortersWhenSearched: unref(state).ignoreSortersWhenSearched.value,
 					selectedRows: unref(state).selectedRows.value,
 					selectedCount: unref(state).selectedCount.value,
 					navBridge: unref(navBridge),

package/dist/{as-table-root-BNJ1yqaD.cjs → as-table-root-BnW1SL4W.cjs}

@@ -1,8 +1,8 @@
-const require_use_table_state = require("./use-table-state-152Ejpyo.cjs");
-const require_use_table = require("./use-table-CaegBdPZ.cjs");
-const require_use_table_nav_bridge = require("./use-table-nav-bridge-bZIH2d6Y.cjs");
+const require_use_table_state = require("./use-table-state-CElgF_iy.cjs");
+const require_use_table = require("./use-table-BWgcmQS7.cjs");
+const require_use_table_nav_bridge = require("./use-table-nav-bridge-BlqeY53w.cjs");
 const require_use_has_emit_listener = require("./use-has-emit-listener-hhOH8CBI.cjs");
-const require_as_confirm_dialog = require("./as-confirm-dialog-BqvOf3yo.cjs");
+const require_as_confirm_dialog = require("./as-confirm-dialog-CYiLQUP-.cjs");
 let vue = require("vue");
 //#endregion
 //#region src/components/as-table-root.vue
@@ -88,6 +88,10 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			required: false,
 			default: true
 		},
+		resolveHref: {
+			type: Function,
+			required: false
+		},
 		urlQuerySync: {
 			type: Object,
 			required: false
@@ -117,6 +121,11 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			default: () => []
 		},
 		"sortersModifiers": {},
+		"ignoreSortersWhenSearched": {
+			type: Boolean,
+			default: false
+		},
+		"ignoreSortersWhenSearchedModifiers": {},
 		"selectedRows": {
 			type: Array,
 			default: () => []
@@ -133,6 +142,7 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		"update:columnNames",
 		"update:columnWidths",
 		"update:sorters",
+		"update:ignoreSortersWhenSearched",
 		"update:selectedRows",
 		"update:urlQuery"
 	]),
@@ -147,6 +157,14 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		const columnNames = (0, vue.useModel)(__props, "columnNames");
 		const columnWidths = (0, vue.useModel)(__props, "columnWidths");
 		const sorters = (0, vue.useModel)(__props, "sorters");
+		/**
+		* Opt-in for relevance-ranked backends (e.g. Atlas Search): while true AND a
+		* search term is active, user sorters are omitted from the query so relevance
+		* ranking survives (`forceSorters` still apply). Usable as a plain prop
+		* (`:ignore-sorters-when-searched="true"` sets the configured default) or as
+		* `v-model:ignore-sorters-when-searched` to observe/drive the runtime flag.
+		*/
+		const ignoreSortersWhenSearched = (0, vue.useModel)(__props, "ignoreSortersWhenSearched");
 		const selectedRows = (0, vue.useModel)(__props, "selectedRows");
 		/**
 		* Bidirectional URL bridge bound via `v-model:url-query`. When unbound the
@@ -175,6 +193,7 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			formTypes: props.formTypes,
 			formComponents: props.formComponents,
 			refreshOnAction: () => props.refreshOnAction,
+			resolveHref: props.resolveHref,
 			onActionResolved: (action, ids, result, event) => {
 				emit("action", action, ids, result, event);
 			},
@@ -182,6 +201,7 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			columnNames,
 			columnWidths,
 			sorters,
+			ignoreSortersWhenSearched,
 			selectedRows,
 			urlQueryReady: urlQueryActive ? urlQueryReady : void 0,
 			onUrlQueryChange: urlQueryActive ? (s) => urlQuery.value = s : void 0,
@@ -245,6 +265,7 @@ var as_table_root_default = /* @__PURE__ */ (0, vue.defineComponent)({
 					metadataError: (0, vue.unref)(state).metadataError.value,
 					mustRefresh: (0, vue.unref)(state).mustRefresh.value,
 					searchTerm: (0, vue.unref)(state).searchTerm.value,
+					ignoreSortersWhenSearched: (0, vue.unref)(state).ignoreSortersWhenSearched.value,
 					selectedRows: (0, vue.unref)(state).selectedRows.value,
 					selectedCount: (0, vue.unref)(state).selectedCount.value,
 					navBridge: (0, vue.unref)(navBridge),

package/dist/as-table-root.cjs

@@ -1,2 +1,2 @@
-const require_as_table_root = require("./as-table-root-BNJ1yqaD.cjs");
+const require_as_table_root = require("./as-table-root-BnW1SL4W.cjs");
 module.exports = require_as_table_root.as_table_root_default;

package/dist/as-table-root.d.cts

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-root.vue-DFCZwH1h.cjs";
+import { t as _default } from "./as-table-root.vue-DRv85M1N.cjs";
 export = _default;

package/dist/as-table-root.d.mts

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table-root.vue-C5IrebWr.mjs";
+import { t as _default } from "./as-table-root.vue-TUauKr31.mjs";
 export { _default as default };

package/dist/as-table-root.mjs

@@ -1,2 +1,2 @@
-import { t as as_table_root_default } from "./as-table-root-BQNXfIvB.mjs";
+import { t as as_table_root_default } from "./as-table-root-BSbO16CM.mjs";
 export { as_table_root_default as default };

package/dist/{as-table-root.vue-DFCZwH1h.d.cts → as-table-root.vue-DRv85M1N.d.cts}

@@ -1,4 +1,4 @@
-import { _ as TableNavBridge, c as NavKeyOptions, d as ReactiveTableState, g as TableActionsState, h as TVueTableActionInfo, i as ConfirmOptions, l as PresetConfig, m as TAsTableControls, p as TAsCellTypeComponents, t as ActionResult } from "./types-CDJmLD-E.cjs";
+import { _ as TableNavBridge, c as NavKeyOptions, d as ReactiveTableState, g as TableActionsState, h as TVueTableActionInfo, i as ConfirmOptions, l as PresetConfig, m as TAsTableControls, p as TAsCellTypeComponents, t as ActionResult } from "./types-CTMxE_zA.cjs";
 import * as vue from "vue";
 import { AllowedComponentProps, AnchorHTMLAttributes, App, Component as Component$1, ComponentCustomProps, ComponentPublicInstance, ComputedRef, DefineComponent, InjectionKey, MaybeRef, MaybeRefOrGetter, Ref, ShallowRef, UnwrapRef, VNode, VNodeProps, WritableComputedRef } from "vue";
 import { Client, PageResult, TDbActionInfo } from "@atscript/db-client";
@@ -192,6 +192,12 @@ interface TableModelRefs {
   columnNames?: Ref<string[]>;
   columnWidths?: Ref<ColumnWidthsMap>;
   sorters?: Ref<SortControl[]>;
+  /**
+   * Runtime "preserve search relevance" flag (see
+   * `ReactiveTableState.ignoreSortersWhenSearched`). Its initial value is the
+   * configured default the flag resets to on every new search session.
+   */
+  ignoreSortersWhenSearched?: Ref<boolean>;
 }
 type TableSelectionOptions = SelectionApiOptions;
 interface TableQueryOptions {
@@ -208,6 +214,15 @@ interface TableQueryOptions {
   alwaysSelected?: string[];
   /** When true, all triggers (query/queryNext/loadRange) early-return. */
   blockQuery?: boolean;
+  /**
+   * Configured default for the runtime `ignoreSortersWhenSearched` flag
+   * (default `false`). Opt-in for relevance-ranked backends: while the
+   * runtime flag is true AND a search term is active, user `sorters` are
+   * omitted from the query (`forceSorters` still apply). Ignored when a
+   * `model.ignoreSortersWhenSearched` ref is wired — the ref's initial
+   * value is the default then.
+   */
+  ignoreSortersWhenSearched?: boolean;
   /** Auto-query when metadata loads (default: true). */
   queryOnMount?: boolean;
   /**
@@ -239,6 +254,12 @@ interface TableWindowOptions {
 interface TableActionsOptions {
   /** Refetch policy: when `true` (default), successful backend / __remove invocations call `state.query()`. */
   refreshOnAction?: () => boolean;
+  /**
+   * Maps a navigate action's href before it lands in an anchor's `href` /
+   * a mod-click `window.open` target (e.g. router base-path resolution).
+   * Plain function passthrough — see `ReactiveTableState.resolveHref`.
+   */
+  resolveHref?: (url: string) => string;
   /**
    * Bridge for `<AsTableRoot>`'s `@action` emit. Called once per settled
    * `invoke` (success, error, custom). `ids` is the level-derived list:
@@ -371,6 +392,15 @@ interface UseTableOptions {
   columnWidths?: Ref<ColumnWidthsMap>;
   /** External ref for sorters (from defineModel). */
   sorters?: Ref<SortControl[]>;
+  /**
+   * Opt-in for relevance-ranked backends: while true AND a search term is
+   * active, user sorters are omitted from the query (`forceSorters` still
+   * apply). Pass a boolean to set the configured default, or a `Ref` (from
+   * `defineModel`) to also v-model the runtime flag — the ref's initial
+   * value is the default the flag resets to on each new search session.
+   * Default `false`.
+   */
+  ignoreSortersWhenSearched?: boolean | Ref<boolean>;
   /**
    * External ref for selected rows (from `defineModel`/v-model or any external
    * source). Identity is preserved — the framework reads from and writes to
@@ -418,6 +448,13 @@ interface UseTableOptions {
    * successful `'backend'` / `'__remove'` invocations call `state.query()`.
    */
   refreshOnAction?: () => boolean;
+  /**
+   * Maps a navigate action's href before it is used as an anchor `href` /
+   * mod-click `window.open` target (e.g. `router.resolve(url).href` under a
+   * base path). Never applied on the plain-left-click invoke path. Default:
+   * identity.
+   */
+  resolveHref?: (url: string) => string;
   /** Bridge for `<AsTableRoot>`'s `@action` emit; see `TableActionsOptions.onResolved`. */
   onActionResolved?: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: KeyboardEvent | MouseEvent) => void;
   /**
@@ -2176,6 +2213,14 @@ type __VLS_Props = {
    * `state.actions.invoke(action, pk, { suppressRefresh: true })` overrides.
    */
   refreshOnAction?: boolean;
+  /**
+   * Maps a navigate action's interpolated href before it is used as an
+   * anchor's `href` attribute or a mod/middle-click `window.open` target —
+   * e.g. `(url) => router.resolve(url).href` for apps served under a
+   * router base path. NOT applied on the plain-left-click invoke path (the
+   * Client's `navigate` hook owns that URL). Default: identity.
+   */
+  resolveHref?: (url: string) => string;
   /**
    * Per-aspect opt-in/out for `v-model:url-query`. Default (omitted): full
    * sync — filters, sorters, `searchTerm`, and pagination all round-trip.
@@ -2196,6 +2241,14 @@ type __VLS_ModelProps = {
   "columnNames"?: string[];
   "columnWidths"?: ColumnWidthsMap;
   "sorters"?: SortControl[];
+  /**
+   * Opt-in for relevance-ranked backends (e.g. Atlas Search): while true AND a
+   * search term is active, user sorters are omitted from the query so relevance
+   * ranking survives (`forceSorters` still apply). Usable as a plain prop
+   * (`:ignore-sorters-when-searched="true"` sets the configured default) or as
+   * `v-model:ignore-sorters-when-searched` to observe/drive the runtime flag.
+   */
+  "ignoreSortersWhenSearched"?: boolean;
   "selectedRows"?: unknown[];
   /**
    * Bidirectional URL bridge bound via `v-model:url-query`. When unbound the
@@ -2225,6 +2278,7 @@ declare var __VLS_1: {
   metadataError: Error | null;
   mustRefresh: boolean;
   searchTerm: string;
+  ignoreSortersWhenSearched: boolean;
   selectedRows: unknown[];
   selectedCount: number;
   navBridge: TableNavBridge;
@@ -2252,6 +2306,7 @@ declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
   "update:columnNames": (value: string[]) => any;
   "update:columnWidths": (value: ColumnWidthsMap) => any;
   "update:sorters": (value: SortControl[]) => any;
+  "update:ignoreSortersWhenSearched": (value: boolean) => any;
   "update:selectedRows": (value: unknown[]) => any;
   "update:urlQuery": (value: string | undefined) => any;
 } & {
@@ -2259,13 +2314,14 @@ declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
   action: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any;
 }, string, vue.PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
   "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any) | undefined;
+  onAction?: ((action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any) | undefined;
   "onUpdate:filterFields"?: ((value: string[]) => any) | undefined;
   "onUpdate:columnNames"?: ((value: string[]) => any) | undefined;
   "onUpdate:columnWidths"?: ((value: ColumnWidthsMap) => any) | undefined;
   "onUpdate:sorters"?: ((value: SortControl[]) => any) | undefined;
+  "onUpdate:ignoreSortersWhenSearched"?: ((value: boolean) => any) | undefined;
   "onUpdate:selectedRows"?: ((value: unknown[]) => any) | undefined;
   "onUpdate:urlQuery"?: ((value: string | undefined) => any) | undefined;
-  onAction?: ((action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any) | undefined;
 }>, {
   queryOnMount: boolean;
   selectionPersistence: SelectionPersistence;

package/dist/{as-table-root.vue-C5IrebWr.d.mts → as-table-root.vue-TUauKr31.d.mts}

@@ -1,4 +1,4 @@
-import { _ as TableNavBridge, c as NavKeyOptions, d as ReactiveTableState, g as TableActionsState, h as TVueTableActionInfo, i as ConfirmOptions, l as PresetConfig, m as TAsTableControls, p as TAsCellTypeComponents, t as ActionResult } from "./types-BMvxn9iU.mjs";
+import { _ as TableNavBridge, c as NavKeyOptions, d as ReactiveTableState, g as TableActionsState, h as TVueTableActionInfo, i as ConfirmOptions, l as PresetConfig, m as TAsTableControls, p as TAsCellTypeComponents, t as ActionResult } from "./types-ByU4O0Yf.mjs";
 import * as _atscript_ui0 from "@atscript/ui";
 import { ClientFactory, ClientFactory as ClientFactory$1, ColumnDef, SortControl, TableDef, getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
 import * as vue from "vue";
@@ -192,6 +192,12 @@ interface TableModelRefs {
   columnNames?: Ref<string[]>;
   columnWidths?: Ref<ColumnWidthsMap>;
   sorters?: Ref<SortControl[]>;
+  /**
+   * Runtime "preserve search relevance" flag (see
+   * `ReactiveTableState.ignoreSortersWhenSearched`). Its initial value is the
+   * configured default the flag resets to on every new search session.
+   */
+  ignoreSortersWhenSearched?: Ref<boolean>;
 }
 type TableSelectionOptions = SelectionApiOptions;
 interface TableQueryOptions {
@@ -208,6 +214,15 @@ interface TableQueryOptions {
   alwaysSelected?: string[];
   /** When true, all triggers (query/queryNext/loadRange) early-return. */
   blockQuery?: boolean;
+  /**
+   * Configured default for the runtime `ignoreSortersWhenSearched` flag
+   * (default `false`). Opt-in for relevance-ranked backends: while the
+   * runtime flag is true AND a search term is active, user `sorters` are
+   * omitted from the query (`forceSorters` still apply). Ignored when a
+   * `model.ignoreSortersWhenSearched` ref is wired — the ref's initial
+   * value is the default then.
+   */
+  ignoreSortersWhenSearched?: boolean;
   /** Auto-query when metadata loads (default: true). */
   queryOnMount?: boolean;
   /**
@@ -239,6 +254,12 @@ interface TableWindowOptions {
 interface TableActionsOptions {
   /** Refetch policy: when `true` (default), successful backend / __remove invocations call `state.query()`. */
   refreshOnAction?: () => boolean;
+  /**
+   * Maps a navigate action's href before it lands in an anchor's `href` /
+   * a mod-click `window.open` target (e.g. router base-path resolution).
+   * Plain function passthrough — see `ReactiveTableState.resolveHref`.
+   */
+  resolveHref?: (url: string) => string;
   /**
    * Bridge for `<AsTableRoot>`'s `@action` emit. Called once per settled
    * `invoke` (success, error, custom). `ids` is the level-derived list:
@@ -371,6 +392,15 @@ interface UseTableOptions {
   columnWidths?: Ref<ColumnWidthsMap>;
   /** External ref for sorters (from defineModel). */
   sorters?: Ref<SortControl[]>;
+  /**
+   * Opt-in for relevance-ranked backends: while true AND a search term is
+   * active, user sorters are omitted from the query (`forceSorters` still
+   * apply). Pass a boolean to set the configured default, or a `Ref` (from
+   * `defineModel`) to also v-model the runtime flag — the ref's initial
+   * value is the default the flag resets to on each new search session.
+   * Default `false`.
+   */
+  ignoreSortersWhenSearched?: boolean | Ref<boolean>;
   /**
    * External ref for selected rows (from `defineModel`/v-model or any external
    * source). Identity is preserved — the framework reads from and writes to
@@ -418,6 +448,13 @@ interface UseTableOptions {
    * successful `'backend'` / `'__remove'` invocations call `state.query()`.
    */
   refreshOnAction?: () => boolean;
+  /**
+   * Maps a navigate action's href before it is used as an anchor `href` /
+   * mod-click `window.open` target (e.g. `router.resolve(url).href` under a
+   * base path). Never applied on the plain-left-click invoke path. Default:
+   * identity.
+   */
+  resolveHref?: (url: string) => string;
   /** Bridge for `<AsTableRoot>`'s `@action` emit; see `TableActionsOptions.onResolved`. */
   onActionResolved?: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: KeyboardEvent | MouseEvent) => void;
   /**
@@ -2176,6 +2213,14 @@ type __VLS_Props = {
    * `state.actions.invoke(action, pk, { suppressRefresh: true })` overrides.
    */
   refreshOnAction?: boolean;
+  /**
+   * Maps a navigate action's interpolated href before it is used as an
+   * anchor's `href` attribute or a mod/middle-click `window.open` target —
+   * e.g. `(url) => router.resolve(url).href` for apps served under a
+   * router base path. NOT applied on the plain-left-click invoke path (the
+   * Client's `navigate` hook owns that URL). Default: identity.
+   */
+  resolveHref?: (url: string) => string;
   /**
    * Per-aspect opt-in/out for `v-model:url-query`. Default (omitted): full
    * sync — filters, sorters, `searchTerm`, and pagination all round-trip.
@@ -2196,6 +2241,14 @@ type __VLS_ModelProps = {
   "columnNames"?: string[];
   "columnWidths"?: ColumnWidthsMap;
   "sorters"?: SortControl[];
+  /**
+   * Opt-in for relevance-ranked backends (e.g. Atlas Search): while true AND a
+   * search term is active, user sorters are omitted from the query so relevance
+   * ranking survives (`forceSorters` still apply). Usable as a plain prop
+   * (`:ignore-sorters-when-searched="true"` sets the configured default) or as
+   * `v-model:ignore-sorters-when-searched` to observe/drive the runtime flag.
+   */
+  "ignoreSortersWhenSearched"?: boolean;
   "selectedRows"?: unknown[];
   /**
    * Bidirectional URL bridge bound via `v-model:url-query`. When unbound the
@@ -2225,6 +2278,7 @@ declare var __VLS_1: {
   metadataError: Error | null;
   mustRefresh: boolean;
   searchTerm: string;
+  ignoreSortersWhenSearched: boolean;
   selectedRows: unknown[];
   selectedCount: number;
   navBridge: TableNavBridge;
@@ -2252,6 +2306,7 @@ declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
   "update:columnNames": (value: string[]) => any;
   "update:columnWidths": (value: ColumnWidthsMap) => any;
   "update:sorters": (value: SortControl[]) => any;
+  "update:ignoreSortersWhenSearched": (value: boolean) => any;
   "update:selectedRows": (value: unknown[]) => any;
   "update:urlQuery": (value: string | undefined) => any;
 } & {
@@ -2259,13 +2314,14 @@ declare const __VLS_base: vue.DefineComponent<__VLS_PublicProps, {
   action: (action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any;
 }, string, vue.PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
   "onMain-action"?: ((row: Record<string, unknown>, absIndex: number, event: MouseEvent | KeyboardEvent) => any) | undefined;
+  onAction?: ((action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any) | undefined;
   "onUpdate:filterFields"?: ((value: string[]) => any) | undefined;
   "onUpdate:columnNames"?: ((value: string[]) => any) | undefined;
   "onUpdate:columnWidths"?: ((value: ColumnWidthsMap) => any) | undefined;
   "onUpdate:sorters"?: ((value: SortControl[]) => any) | undefined;
+  "onUpdate:ignoreSortersWhenSearched"?: ((value: boolean) => any) | undefined;
   "onUpdate:selectedRows"?: ((value: unknown[]) => any) | undefined;
   "onUpdate:urlQuery"?: ((value: string | undefined) => any) | undefined;
-  onAction?: ((action: TVueTableActionInfo, ids: unknown[], result: ActionResult, event?: MouseEvent | KeyboardEvent | undefined) => any) | undefined;
 }>, {
   queryOnMount: boolean;
   selectionPersistence: SelectionPersistence;

package/dist/{as-table-status-C3A1WYwb.cjs → as-table-status-2eUIHBmk.cjs}

@@ -1,7 +1,7 @@
-const require_use_table_state = require("./use-table-state-152Ejpyo.cjs");
-const require_use_table_component = require("./use-table-component-D-1kzctZ.cjs");
-const require_as_table_header_cell = require("./as-table-header-cell-BEwpWr4m.cjs");
-const require_as_row_actions = require("./as-row-actions-BoOAXAeW.cjs");
+const require_use_table_state = require("./use-table-state-CElgF_iy.cjs");
+const require_use_table_component = require("./use-table-component-QDcfYIBU.cjs");
+const require_as_table_header_cell = require("./as-table-header-cell-DD6Tw87_.cjs");
+const require_as_row_actions = require("./as-row-actions-DC6-kpsJ.cjs");
 const require_as_table_cell_value = require("./as-table-cell-value-D1JkTQt0.cjs");
 let _atscript_ui = require("@atscript/ui");
 let vue = require("vue");

package/dist/{as-table-status-CxkiQ_EE.mjs → as-table-status-Dy3rA0T-.mjs}

@@ -1,7 +1,7 @@
-import { o as useTableContextOptional } from "./use-table-state-BHAwfUKw.mjs";
-import { t as useTableComponent } from "./use-table-component-ClgvnuRH.mjs";
-import { t as as_table_header_cell_default } from "./as-table-header-cell-mCOAZsjL.mjs";
-import { t as as_row_actions_default } from "./as-row-actions-DIpn-EYD.mjs";
+import { o as useTableContextOptional } from "./use-table-state-Dju5bxt8.mjs";
+import { t as useTableComponent } from "./use-table-component-Bu7CIG5I.mjs";
+import { t as as_table_header_cell_default } from "./as-table-header-cell-DfjfNeq4.mjs";
+import { t as as_row_actions_default } from "./as-row-actions-CBVF6B2-.mjs";
 import { t as as_table_cell_value_default } from "./as-table-cell-value-CPcFxSOj.mjs";
 import { UI_TABLE_ATTR, UI_TABLE_CLASSES, UI_TABLE_FN_ATTR, UI_TABLE_FN_CLASSES, UI_TABLE_FN_STYLES, UI_TABLE_STYLES, getFieldMeta, parseStaticAttrs, resolveAttrs, resolveFieldProp } from "@atscript/ui";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, defineComponent, normalizeClass, normalizeStyle, onBeforeUnmount, openBlock, ref, renderList, renderSlot, resolveDynamicComponent, toDisplayString, unref, withModifiers } from "vue";

package/dist/as-table.cjs

@@ -1,2 +1,2 @@
-const require_as_table = require("./as-table-C3Li7WTI.cjs");
+const require_as_table = require("./as-table-DaT2K-7n.cjs");
 module.exports = require_as_table.as_table_default;

package/dist/as-table.d.cts

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table.vue-COtIbUsp.cjs";
+import { t as _default } from "./as-table.vue-Co8kYS_o.cjs";
 export = _default;

package/dist/as-table.d.mts

@@ -1,2 +1,2 @@
-import { t as _default } from "./as-table.vue-CAydq1n0.mjs";
+import { t as _default } from "./as-table.vue-B2ywpIo_.mjs";
 export { _default as default };

package/dist/as-table.mjs

@@ -1,2 +1,2 @@
-import { t as as_table_default } from "./as-table-QkKHAIh6.mjs";
+import { t as as_table_default } from "./as-table-DQwYi63u.mjs";
 export { as_table_default as default };