@atscript/vue-table 0.1.147 → 0.1.148

package/dist/index.mjs

@@ -1,37 +1,36 @@
-import { I as queryTargetGate, O as extractIdentifier, V as ROW_ACTIONS_TYPE, a as useTableContext, b as QUERY_TARGET_UNSUPPORTED_REASON, k as identifierFieldsOf, n as createTableState, o as useTableContextOptional, r as provideTableContext, t as createStaticTableState, v as resolveRowActions, x as actionIdentifiers } from "./use-table-state-1OZfdhQi.mjs";
+import { I as queryTargetGate, O as extractIdentifier, V as ROW_ACTIONS_TYPE, a as useTableContext, b as QUERY_TARGET_UNSUPPORTED_REASON, k as identifierFieldsOf, n as createTableState, o as useTableContextOptional, r as provideTableContext, t as createStaticTableState, v as resolveRowActions, x as actionIdentifiers } from "./use-table-state-CIoWhwTD.mjs";
 import { t as getCellValue } from "./get-cell-value-Cb3X8nUn.mjs";
 import { n as useTableSelection } from "./use-table-selection-CdaOPo1d.mjs";
-import { a as useLocalDraft, i as usePresets, o as AS_PRESETS_APP, r as useTable, s as injectPresetsApp, t as clearTableCache } from "./use-table-DP6Y0kbl.mjs";
-import { t as useTableNavBridge } from "./use-table-nav-bridge-BhOPIT2R.mjs";
-import { t as useTableComponent } from "./use-table-component-DNGUvhf7.mjs";
-import { t as as_cell_array_default } from "./as-cell-array-Bgc4GYZf.mjs";
-import { t as as_cell_date_default } from "./as-cell-date-B9mu0OOD.mjs";
-import { n as useCellLocale, t as provideCellLocale } from "./use-cell-locale-MQXoONh5.mjs";
-import { t as as_cell_json_default } from "./as-cell-json-ByEGYRST.mjs";
-import { t as as_cell_number_default } from "./as-cell-number-CNDT6gfw.mjs";
+import { a as useLocalDraft, i as usePresets, o as AS_PRESETS_APP, r as useTable, s as injectPresetsApp, t as clearTableCache } from "./use-table-BYNBpLJt.mjs";
+import { n as useCellLocale, t as provideCellLocale } from "./use-cell-locale-BTJZ6UcP.mjs";
+import { t as useTableNavBridge } from "./use-table-nav-bridge-CJBERyPB.mjs";
+import { t as useTableComponent } from "./use-table-component-Dy397695.mjs";
+import { t as as_cell_array_default } from "./as-cell-array-CnoVd9ps.mjs";
+import { t as as_cell_date_default } from "./as-cell-date-dhIM7hWA.mjs";
+import { t as as_cell_json_default } from "./as-cell-json-ChN_NDhO.mjs";
+import { t as as_cell_number_default } from "./as-cell-number-D-mSaE_G.mjs";
 import { t as formatCellValue } from "./format-cell-D1Ziv96Q.mjs";
-import { t as as_cell_union_default } from "./as-cell-union-DMnoa7RM.mjs";
+import { t as as_cell_union_default } from "./as-cell-union-C9Bbnkrg.mjs";
 import { t as as_column_menu_default } from "./as-column-menu-CBtUfYEE.mjs";
-import { t as as_config_dialog_default } from "./as-config-dialog-D503Ek_m.mjs";
-import { t as as_confirm_dialog_default } from "./as-confirm-dialog-CJfDnaiU.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-CxjO-Ge5.mjs";
-import { t as as_table_header_cell_default } from "./as-table-header-cell-DrVzYaof.mjs";
-import { t as as_window_table_default } from "./as-window-table-CygDqZMU.mjs";
-import { t as as_filter_field_default } from "./as-filter-field-ByPlGyWz.mjs";
-import { t as as_residual_filter_default } from "./as-residual-filter-BRsEs8oe.mjs";
-import { t as as_filters_default } from "./as-filters-CJZJiOXb.mjs";
-import { t as as_preset_dialog_default } from "./as-preset-dialog-CLOVEpWZ.mjs";
-import { t as as_row_actions_default } from "./as-row-actions-DyjIXePd.mjs";
-import { t as as_table_cell_value_default } from "./as-table-cell-value-DoH8Mieo.mjs";
-import { t as as_table_root_default } from "./as-table-root-BYHXuNPI.mjs";
-import { t as as_table_default } from "./as-table-Cpvfv9zA.mjs";
-import { t as as_table_actions_default } from "./as-table-actions-BlbAps1h.mjs";
-import { t as as_preset_picker_default } from "./as-preset-picker-CwFObhME.mjs";
+import { t as as_config_dialog_default } from "./as-config-dialog-ZKMnfirD.mjs";
+import { t as as_confirm_dialog_default } from "./as-confirm-dialog-DMiGquH1.mjs";
+import { t as as_filter_field_default } from "./as-filter-field-DE6MJMx7.mjs";
+import { t as as_filter_input_default } from "./as-filter-input-DmOW_jzK.mjs";
+import { t as as_filter_dialog_default } from "./as-filter-dialog-DNFR30fV.mjs";
+import { t as as_table_header_cell_default } from "./as-table-header-cell-ahzAeHXj.mjs";
+import { t as as_window_table_default } from "./as-window-table-DjplqWzr.mjs";
+import { t as as_residual_filter_default } from "./as-residual-filter-DHfbtTQj.mjs";
+import { t as as_filters_default } from "./as-filters-DErM2bFq.mjs";
+import { t as as_preset_dialog_default } from "./as-preset-dialog-CY5dPfZa.mjs";
+import { t as as_row_actions_default } from "./as-row-actions-BNQ7jrie.mjs";
+import { t as as_table_cell_value_default } from "./as-table-cell-value-D-S127gr.mjs";
+import { t as as_table_root_default } from "./as-table-root-BnkF5-rh.mjs";
+import { t as as_table_default } from "./as-table-Bcz-WOTS.mjs";
+import { t as as_table_actions_default } from "./as-table-actions-DPq5SrGa.mjs";
+import { t as as_preset_picker_default } from "./as-preset-picker-DkZ7sinz.mjs";
 import { getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
 import { computed, effectScope, ref, shallowRef } from "vue";
-import { AppPrefsClient, ExportAbortError, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, collectExportRows, columnDefaultCondition, columnFilterConditions, columnFilterType, isFilled, isSystemPresetId, isUnavailableError, resolveExportValue, resolveSystemPresets, toCsv, urlQueryConsumesKey, withStableOrder } from "@atscript/ui-table";
-import { splitUrlSegments } from "@uniqu/url";
+import { AppPrefsClient, DEV, ExportAbortError, PRESET_ASPECTS, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, collectExportRows, columnFilter, isFilled, isSystemPresetId, isUnavailableError, leadingKey, mergeUrlQueryRecord, resolveExportValue, resolveSystemPresets, toCsv, urlQueryConsumesKey, urlQueryRecordToString, withStableOrder } from "@atscript/ui-table";
 import { StorageSerializers, useEventBus, useStorage } from "@vueuse/core";
 //#region src/composables/use-table-export.ts
 /**
@@ -71,13 +70,12 @@ function useTableExport(ctx) {
 	}
 	/**
 	* One value resolver per column, built once per run: the formatter lookup
-	* and the union-option index happen here instead of per cell.
+	* happens here instead of per cell (union-option labels are Map-backed in `optionLabel`).
 	*/
 	function resolversFor(columns, opts) {
 		return columns.map((column) => {
 			const perColumn = opts.formatters?.[column.path];
 			const formatCell = opts.formatCell;
-			const labels = column.options?.length ? new Map(column.options.map((o) => [o.key, o.label])) : null;
 			return (row) => {
 				const raw = getCellValue(row, column.path);
 				if (perColumn) {
@@ -88,11 +86,7 @@ function useTableExport(ctx) {
 					const out = formatCell(raw, column, row);
 					if (out !== void 0) return out;
 				}
-				if (labels !== null && (typeof raw === "string" || typeof raw === "number")) {
-					const hit = labels.get(String(raw));
-					if (hit !== void 0) return hit;
-				}
-				return resolveExportValue(raw);
+				return resolveExportValue(raw, column);
 			};
 		});
 	}
@@ -198,9 +192,7 @@ function rawColumn(path) {
 * Accepts `state` directly rather than injecting — safe to call outside `setup`.
 */
 function useTableFilter(column, state) {
-	const filterType = columnFilterType(column.type);
-	const availableConditions = columnFilterConditions(column);
-	const defCondition = columnDefaultCondition(column);
+	const { kind: filterType, conditions: availableConditions, defaultCondition: defCondition } = columnFilter(column);
 	function cloneConditions() {
 		const existing = state.filters.value[column.path];
 		if (existing && existing.length > 0) return existing.map((c) => ({
@@ -294,26 +286,11 @@ function useTableActions() {
 }
 //#endregion
 //#region src/composables/use-table-url-query.ts
-const KEY_CHAR = /[A-Za-z0-9_.$-]/;
-/**
-* Index of `=` if every char before it is URL-key-safe. Returns -1 when any
-* non-key char (uniqu operator, whitespace, etc.) appears first — those
-* segments must round-trip as a single bare key because vue-router's `query`
-* record has no encoding for non-`=` separators.
-*/
-function findCleanEq(segment) {
-	for (let i = 0; i < segment.length; i++) {
-		const c = segment[i];
-		if (c === "=") return i > 0 ? i : -1;
-		if (!KEY_CHAR.test(c)) return -1;
-	}
-	return -1;
-}
 /**
-* Bridge `<AsTableRoot v-model:url-query>` to vue-router. Uses **type-only**
-* imports of `Router` and `RouteLocationNormalizedLoaded` — no runtime
-* dependency on `vue-router` is added to `@atscript/vue-table`. Consumers
-* pass in their already-resolved `useRoute()` and `useRouter()` instances.
+* Bridge `<AsTableRoot v-model:url-query>` to a router. Takes the structural
+* {@link TableUrlQueryRoute} / {@link TableUrlQueryRouter} slices, so
+* `@atscript/vue-table` imports nothing from `vue-router`: consumers pass
+* their already-resolved `useRoute()` and `useRouter()` instances.
 *
 * Scope: the bridge owns **only what the table reads back** (since 0.1.133).
 * A key is the table's iff `urlQueryStringToState` would consume it — see
@@ -325,10 +302,11 @@ function findCleanEq(segment) {
 * written as one block in the table's order.
 *
 * Without a `prefix` the bridge cannot tell a plain `field=value` filter from
-* a page-owned flag of the same shape, so a plain key that was already in the
-* URL when the bridge mounted counts as foreign until the bridge writes it
-* itself. Pass `prefix` when a route carries a host key that could collide
-* with a column path, or when it carries two tables.
+* a page-owned flag of the same shape: the table reads every unprefixed key,
+* so a host key that is also a column path becomes a user filter. Pass
+* `preserveKeys` to fence such host keys off (or `prefix` to namespace the
+* table, which changes its URLs), and `prefix` when a route carries two
+* tables.
 *
 * @example
 * ```vue
@@ -346,47 +324,47 @@ function findCleanEq(segment) {
 * ```
 */
 function useTableUrlQuery(route, router, opts = {}) {
-	const navigate = (opts.mode ?? "replace") === "push" ? router.push.bind(router) : router.replace.bind(router);
+	const usePush = (opts.mode ?? "replace") === "push";
+	if (usePush && typeof router.push !== "function") throw new TypeError("[vue-table] useTableUrlQuery: mode \"push\" needs router.push.");
+	const navigate = (query) => usePush ? router.push?.({ query }) : router.replace({ query });
 	const prefix = opts.prefix ? `${opts.prefix}.` : "";
+	const recordOpts = {
+		prefix: opts.prefix,
+		preserveKeys: opts.preserveKeys
+	};
 	const written = /* @__PURE__ */ new Set();
 	function isOwn(key) {
 		if (prefix) return key.startsWith(prefix);
 		return written.has(key) || urlQueryConsumesKey(key);
 	}
+	let withheld;
+	const warned = /* @__PURE__ */ new Set();
 	return computed({
 		get: () => {
-			const q = route.query;
-			const parts = [];
-			for (const key in q) {
-				if (prefix && !key.startsWith(prefix)) continue;
-				const own = prefix ? key.slice(prefix.length) : key;
-				const v = q[key];
-				if (Array.isArray(v)) for (const item of v) parts.push(item == null ? own : `${own}=${item}`);
-				else if (v == null) parts.push(own);
-				else parts.push(`${own}=${v}`);
-			}
-			return parts.join("&");
+			const own = urlQueryRecordToString(route.query, recordOpts);
+			if (!withheld) return own;
+			if (own === withheld.expectedOwn) return withheld.lastSet;
+			return [own, ...withheld.held].filter(Boolean).join("&");
 		},
 		set: (urlString) => {
-			const serialized = /* @__PURE__ */ new Map();
-			for (const segment of splitUrlSegments(urlString)) {
-				if (!segment) continue;
-				const eqIdx = findCleanEq(segment);
-				const key = eqIdx > 0 ? `${prefix}${segment.slice(0, eqIdx)}` : `${prefix}${segment}`;
-				serialized.set(key, eqIdx > 0 ? segment.slice(eqIdx + 1) : null);
-				written.add(key);
+			const merged = mergeUrlQueryRecord(route.query, urlString, {
+				...recordOpts,
+				isOwn
+			});
+			const { query } = merged;
+			for (const key of merged.own) written.add(key);
+			withheld = merged.withheld.length ? {
+				held: merged.withheld,
+				lastSet: urlString,
+				expectedOwn: urlQueryRecordToString(query, recordOpts)
+			} : void 0;
+			if (DEV) for (const segment of merged.withheld) {
+				const name = leadingKey(segment) || segment;
+				if (warned.has(name)) continue;
+				warned.add(name);
+				console.warn(`[vue-table] useTableUrlQuery: "${name}" is in preserveKeys, so the table's own "${name}" filter is kept private and is not written to the URL.`);
 			}
-			const query = {};
-			let placed = false;
-			const place = () => {
-				if (placed) return;
-				placed = true;
-				for (const [key, value] of serialized) query[key] = value;
-			};
-			for (const key in route.query) if (isOwn(key)) place();
-			else query[key] = route.query[key];
-			place();
-			navigate({ query });
+			navigate(query);
 		}
 	});
 }

package/dist/{intent-scope-BXPEN5kJ.d.cts → intent-scope-CGch9yhy.d.cts}

@@ -586,6 +586,19 @@ interface ReactiveTableState extends TableStateMethods {
    * when present, otherwise type+`@expect.maxLen`-derived (see `computeDefaultColumnWidth`).
    */
   columnWidths: Ref<ColumnWidthsMap>;
+  /**
+   * The app-authored `forceFilters` scope, read live. For chrome such as a
+   * "scoped to ..." badge. Since 0.1.148.
+   */
+  forceFilters: ComputedRef<FilterExpr | undefined>;
+  /** The app-authored `forceSorters`, read live (empty when none). Since 0.1.148. */
+  forceSorters: ComputedRef<SortControl[]>;
+  /**
+   * The IANA time zone the table reads dates in (`undefined` = the browser's):
+   * the `timeZone` option, else the cell locale's. Date filters, their chips
+   * and their inputs all follow it. Since 0.1.148.
+   */
+  timeZone: ComputedRef<string | undefined>;
   filterFields: ShallowRef<string[]>;
   filters: ShallowRef<FieldFilters>;
   /**

package/dist/{intent-scope-Ck7RZ0dK.d.mts → intent-scope-CvD4YOvf.d.mts}

@@ -586,6 +586,19 @@ interface ReactiveTableState extends TableStateMethods {
    * when present, otherwise type+`@expect.maxLen`-derived (see `computeDefaultColumnWidth`).
    */
   columnWidths: Ref<ColumnWidthsMap>;
+  /**
+   * The app-authored `forceFilters` scope, read live. For chrome such as a
+   * "scoped to ..." badge. Since 0.1.148.
+   */
+  forceFilters: ComputedRef<FilterExpr | undefined>;
+  /** The app-authored `forceSorters`, read live (empty when none). Since 0.1.148. */
+  forceSorters: ComputedRef<SortControl[]>;
+  /**
+   * The IANA time zone the table reads dates in (`undefined` = the browser's):
+   * the `timeZone` option, else the cell locale's. Date filters, their chips
+   * and their inputs all follow it. Since 0.1.148.
+   */
+  timeZone: ComputedRef<string | undefined>;
   filterFields: ShallowRef<string[]>;
   filters: ShallowRef<FieldFilters>;
   /**

package/dist/use-condition-format-5LcuInDy.mjs

@@ -0,0 +1,34 @@
+import { n as useCellLocale } from "./use-cell-locale-BTJZ6UcP.mjs";
+import { computed } from "vue";
+import { formatColumnCondition, formatColumnValue, formatFilterCondition } from "@atscript/ui-table";
+//#region src/composables/use-condition-format.ts
+/**
+* Chip wording for filter conditions, in the table's time zone and the cell
+* locale: "Last 7 days", "on Oct 5, 2026", "after Oct 5, 2026, 14:30" on date
+* columns, the operator symbols elsewhere. Reads reactive sources, so call the
+* returned functions inside `computed` / templates.
+*
+* Call in `setup` (it injects the cell locale).
+*/
+function useConditionFormat(state) {
+	const { locale } = useCellLocale();
+	const opts = () => ({
+		locale: locale.value,
+		timeZone: state.timeZone.value
+	});
+	const columns = computed(() => new Map(state.allColumns.value.map((c) => [c.path, c])));
+	return {
+		formatCondition(column, cond) {
+			return column ? formatColumnCondition(column, cond, opts()) : formatFilterCondition(cond);
+		},
+		formatValue(path, value) {
+			const column = columns.value.get(path);
+			return column ? formatColumnValue(column, value, opts()) : void 0;
+		},
+		labelOf(path) {
+			return columns.value.get(path)?.label;
+		}
+	};
+}
+//#endregion
+export { useConditionFormat as t };

package/dist/use-condition-format-DrgfX6xL.cjs

@@ -0,0 +1,39 @@
+const require_use_cell_locale = require("./use-cell-locale-Dv514-Al.cjs");
+let vue = require("vue");
+let _atscript_ui_table = require("@atscript/ui-table");
+//#region src/composables/use-condition-format.ts
+/**
+* Chip wording for filter conditions, in the table's time zone and the cell
+* locale: "Last 7 days", "on Oct 5, 2026", "after Oct 5, 2026, 14:30" on date
+* columns, the operator symbols elsewhere. Reads reactive sources, so call the
+* returned functions inside `computed` / templates.
+*
+* Call in `setup` (it injects the cell locale).
+*/
+function useConditionFormat(state) {
+	const { locale } = require_use_cell_locale.useCellLocale();
+	const opts = () => ({
+		locale: locale.value,
+		timeZone: state.timeZone.value
+	});
+	const columns = (0, vue.computed)(() => new Map(state.allColumns.value.map((c) => [c.path, c])));
+	return {
+		formatCondition(column, cond) {
+			return column ? (0, _atscript_ui_table.formatColumnCondition)(column, cond, opts()) : (0, _atscript_ui_table.formatFilterCondition)(cond);
+		},
+		formatValue(path, value) {
+			const column = columns.value.get(path);
+			return column ? (0, _atscript_ui_table.formatColumnValue)(column, value, opts()) : void 0;
+		},
+		labelOf(path) {
+			return columns.value.get(path)?.label;
+		}
+	};
+}
+//#endregion
+Object.defineProperty(exports, "useConditionFormat", {
+	enumerable: true,
+	get: function() {
+		return useConditionFormat;
+	}
+});

package/dist/{use-table-DP6Y0kbl.mjs → use-table-BYNBpLJt.mjs}

@@ -1,7 +1,8 @@
-import { l as DEFAULT_AVAILABLE_ASPECTS, n as createTableState, r as provideTableContext } from "./use-table-state-1OZfdhQi.mjs";
+import { l as DEFAULT_AVAILABLE_ASPECTS, n as createTableState, r as provideTableContext } from "./use-table-state-CIoWhwTD.mjs";
 import { n as useTableSelection } from "./use-table-selection-CdaOPo1d.mjs";
+import { n as useCellLocale } from "./use-cell-locale-BTJZ6UcP.mjs";
 import { createTableDef, getMetaEntry, resetMetaCache } from "@atscript/ui";
-import { computed, inject, isRef, ref, shallowRef, toValue, watch } from "vue";
+import { computed, getCurrentInstance, inject, isRef, ref, shallowRef, toValue, watch } from "vue";
 import { PresetsClient, STANDARD_PRESET_ID, debounce, deserializeDraft, isEmptyDraft, isSystemPresetId, isUnavailableError, resolveSystemPresets, serializeDraft, stableStringify } from "@atscript/ui-table";
 //#region src/composables/as-presets-app.ts
 /**
@@ -33,6 +34,23 @@ function injectPresetsApp(explicit) {
 	throw new Error("[vue-table] AS_PRESETS_APP not provided. Call `app.provide(AS_PRESETS_APP, '<your-app>')` once at boot, or pass `app` to the composable.");
 }
 //#endregion
+//#region src/utils/week-start.ts
+/**
+* The first day of the week for a locale, `1` = Monday … `7` = Sunday, from
+* `Intl.Locale#getWeekInfo` where the runtime has it; `undefined` otherwise
+* (callers then default to Monday).
+*/
+function weekStartOf(locale) {
+	if (!locale) return void 0;
+	try {
+		const l = new Intl.Locale(locale);
+		const day = (l.getWeekInfo?.() ?? l.weekInfo)?.firstDay;
+		return typeof day === "number" && day >= 1 && day <= 7 ? day : void 0;
+	} catch {
+		return;
+	}
+}
+//#endregion
 //#region src/composables/use-local-draft.ts
 const DEFAULT_DEBOUNCE_MS = 300;
 /**
@@ -395,6 +413,7 @@ function useTable(url, opts) {
 	if (!entry.tableDef) entry.tableDef = Promise.all([entry.meta, entry.type]).then(([meta, type]) => createTableDef(meta, type));
 	const { client } = entry;
 	const defPromise = entry.tableDef;
+	const cellLocale = getCurrentInstance() ? useCellLocale() : void 0;
 	const preset = opts?.preset;
 	const presetsHandle = preset ? usePresets({
 		url: preset.url,
@@ -431,6 +450,8 @@ function useTable(url, opts) {
 			forceFilters: opts?.forceFilters,
 			forceSorters: opts?.forceSorters,
 			alwaysSelected: opts?.alwaysSelected,
+			timeZone: () => toValue(opts?.timeZone) ?? cellLocale?.timezone.value,
+			weekStart: () => toValue(opts?.weekStart) ?? weekStartOf(cellLocale?.locale.value),
 			blockQuery: opts?.blockQuery,
 			queryOnMount: opts?.queryOnMount,
 			ignoreSortersWhenSearched: typeof opts?.ignoreSortersWhenSearched === "boolean" ? opts.ignoreSortersWhenSearched : void 0,

package/dist/{use-table-CydIJZbx.cjs → use-table-C9qI-TL6.cjs}

@@ -1,5 +1,6 @@
-const require_use_table_state = require("./use-table-state-sDnqOi3b.cjs");
+const require_use_table_state = require("./use-table-state-BQchKxUr.cjs");
 const require_use_table_selection = require("./use-table-selection-Cs7-gjHg.cjs");
+const require_use_cell_locale = require("./use-cell-locale-Dv514-Al.cjs");
 let _atscript_ui = require("@atscript/ui");
 let vue = require("vue");
 let _atscript_ui_table = require("@atscript/ui-table");
@@ -33,6 +34,23 @@ function injectPresetsApp(explicit) {
 	throw new Error("[vue-table] AS_PRESETS_APP not provided. Call `app.provide(AS_PRESETS_APP, '<your-app>')` once at boot, or pass `app` to the composable.");
 }
 //#endregion
+//#region src/utils/week-start.ts
+/**
+* The first day of the week for a locale, `1` = Monday … `7` = Sunday, from
+* `Intl.Locale#getWeekInfo` where the runtime has it; `undefined` otherwise
+* (callers then default to Monday).
+*/
+function weekStartOf(locale) {
+	if (!locale) return void 0;
+	try {
+		const l = new Intl.Locale(locale);
+		const day = (l.getWeekInfo?.() ?? l.weekInfo)?.firstDay;
+		return typeof day === "number" && day >= 1 && day <= 7 ? day : void 0;
+	} catch {
+		return;
+	}
+}
+//#endregion
 //#region src/composables/use-local-draft.ts
 const DEFAULT_DEBOUNCE_MS = 300;
 /**
@@ -395,6 +413,7 @@ function useTable(url, opts) {
 	if (!entry.tableDef) entry.tableDef = Promise.all([entry.meta, entry.type]).then(([meta, type]) => (0, _atscript_ui.createTableDef)(meta, type));
 	const { client } = entry;
 	const defPromise = entry.tableDef;
+	const cellLocale = (0, vue.getCurrentInstance)() ? require_use_cell_locale.useCellLocale() : void 0;
 	const preset = opts?.preset;
 	const presetsHandle = preset ? usePresets({
 		url: preset.url,
@@ -431,6 +450,8 @@ function useTable(url, opts) {
 			forceFilters: opts?.forceFilters,
 			forceSorters: opts?.forceSorters,
 			alwaysSelected: opts?.alwaysSelected,
+			timeZone: () => (0, vue.toValue)(opts?.timeZone) ?? cellLocale?.timezone.value,
+			weekStart: () => (0, vue.toValue)(opts?.weekStart) ?? weekStartOf(cellLocale?.locale.value),
 			blockQuery: opts?.blockQuery,
 			queryOnMount: opts?.queryOnMount,
 			ignoreSortersWhenSearched: typeof opts?.ignoreSortersWhenSearched === "boolean" ? opts.ignoreSortersWhenSearched : void 0,

package/dist/{use-table-component-aqfGzECx.cjs → use-table-component-CsdvdGJT.cjs}

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

package/dist/{use-table-component-DNGUvhf7.mjs → use-table-component-Dy397695.mjs}

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

package/dist/{use-table-nav-bridge-BhOPIT2R.mjs → use-table-nav-bridge-CJBERyPB.mjs}

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

package/dist/{use-table-nav-bridge-B7A30yja.cjs → use-table-nav-bridge-Gm4ZfOjJ.cjs}

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

package/dist/{use-table-state-sDnqOi3b.cjs → use-table-state-BQchKxUr.cjs}

@@ -2359,10 +2359,33 @@ function createTableState(opts) {
 	}
 	/** Reads the value a sorter orders by — a display column's `sortValue` wins. */
 	const sortValueOf = createSortValueReader(opts.displayColumns);
+	/** The app-authored scope, read live — the query, local sort and chrome all go through these. */
+	const forceFilters = (0, vue.computed)(() => (0, vue.toValue)(queryOpts?.forceFilters));
+	const timeZone = (0, vue.computed)(() => (0, vue.toValue)(queryOpts?.timeZone));
+	const weekStart = (0, vue.computed)(() => (0, vue.toValue)(queryOpts?.weekStart));
+	/**
+	* Turns a typed filter value into what the server accepts (date periods in
+	* `timeZone`, boolean text → boolean). Rebuilt when the columns, the zone or
+	* the week start change; "today" is read at each query build.
+	*/
+	const encodeCondition = (0, vue.computed)(() => (0, _atscript_ui_table.createColumnValueEncoder)(allColumns.value, {
+		timeZone: timeZone.value,
+		weekStart: weekStart.value
+	}));
+	const forceSorters = (0, vue.computed)(() => (0, vue.toValue)(queryOpts?.forceSorters) ?? []);
+	/** Whether a date filter is set — the only filters a zone or week-start change affects. */
+	function hasFilledTemporalFilter() {
+		for (const c of allColumns.value) {
+			if (!c.valueKind || !(0, _atscript_ui_table.isTemporalKind)((0, _atscript_ui_table.columnFilterKind)(c))) continue;
+			if (filters.value[c.path]?.some(_atscript_ui_table.isFilled)) return true;
+		}
+		return false;
+	}
 	function applyLocalSort(rows) {
 		if (queryOpts?.preSorted) return rows;
 		if (splitSorters.value.local.length === 0 || sortersIgnored()) return rows;
-		return (0, _atscript_ui_table.sortRowsLocally)(rows, queryOpts?.forceSorters?.length ? (0, _atscript_ui_table.mergeSorters)(queryOpts.forceSorters, sorters.value) : sorters.value, sortValueOf);
+		const forced = forceSorters.value;
+		return (0, _atscript_ui_table.sortRowsLocally)(rows, forced.length ? (0, _atscript_ui_table.mergeSorters)(forced, sorters.value) : sorters.value, sortValueOf);
 	}
 	/**
 	* The query's view of the model, gated to the fields this caller can use.
@@ -2405,9 +2428,7 @@ function createTableState(opts) {
 		const available = tableDef.value?.fetchableFields ?? knownFields.value?.columns ?? /* @__PURE__ */ new Set();
 		const extra = /* @__PURE__ */ new Set();
 		for (const c of columns.value) for (const p of c.selectWith ?? []) if (available.has(p)) extra.add(p);
-		if (queryOpts?.alwaysSelected) {
-			for (const p of queryOpts.alwaysSelected) if (available.has(p)) extra.add(p);
-		}
+		for (const p of (0, vue.toValue)(queryOpts?.alwaysSelected) ?? []) if (available.has(p)) extra.add(p);
 		const def = tableDef.value;
 		if (def?.identifierFields && def.identifierFields !== def.preferredId) {
 			for (const p of def.identifierFields) if (available.has(p) && !def.preferredId.includes(p)) extra.add(p);
@@ -2426,10 +2447,11 @@ function createTableState(opts) {
 			visibleColumnPaths: (buildOpts?.columnPaths ?? model.columnNames).filter((p) => !localPaths.has(p) && (!known || known.columns.has(p))),
 			extraSelect: extra.size ? [...extra] : void 0,
 			sorters: model.sorters,
-			forceSorters: queryOpts?.forceSorters,
+			forceSorters: forceSorters.value,
 			filters: model.filters,
+			encodeCondition: encodeCondition.value,
 			residualFilters: model.residual,
-			forceFilters: queryOpts?.forceFilters,
+			forceFilters: forceFilters.value,
 			search: searchTerm.value || void 0,
 			ignoreSorters: sortersIgnored(),
 			includeActions: buildOpts?.includeActions ?? includeActions.value
@@ -2714,6 +2736,9 @@ function createTableState(opts) {
 		metadataError,
 		lastError,
 		mustRefresh,
+		forceFilters,
+		forceSorters,
+		timeZone,
 		searchTerm,
 		ignoreSortersWhenSearched,
 		configDialogOpen,
@@ -3006,6 +3031,27 @@ function createTableState(opts) {
 		resetPagination();
 		debouncedFilterQuery();
 	});
+	const readScope = () => ({
+		filter: (0, _atscript_ui_table.stableValueKey)(forceFilters.value ?? null),
+		sorters: (0, _atscript_ui_table.stableValueKey)(forceSorters.value),
+		selected: ((0, vue.toValue)(queryOpts?.alwaysSelected) ?? []).join("\0"),
+		zone: `${timeZone.value ?? ""}|${weekStart.value ?? ""}`
+	});
+	let scope = readScope();
+	(0, vue.watch)(() => Object.values(readScope()).join("
"), () => {
+		const prev = scope;
+		scope = readScope();
+		if (!queryDetected) return;
+		const filterChanged = scope.filter !== prev.filter;
+		if (!filterChanged && scope.sorters === prev.sorters && scope.selected === prev.selected && (scope.zone === prev.zone || !hasFilledTemporalFilter())) return;
+		mustRefresh.value = true;
+		if (hydratingFromUrl) {
+			if (filterChanged && urlQuerySync?.pagination === false) resetPagination();
+			return;
+		}
+		if (filterChanged) resetPagination();
+		scheduleQuery();
+	});
 	(0, vue.watch)(() => sorters.value, (next, prev) => {
 		if (hydratingFromUrl) return;
 		if ((0, _atscript_ui_table.sortersEqual)(prev, next)) return;
@@ -3114,6 +3160,7 @@ function createStaticTableState(opts) {
 			itemsPerPage: size,
 			pages: 1
 		});
+		if (opts.remote) return opts.remote({ searchTerm: _state.searchTerm.value }, page, size);
 		fetcher ??= buildStaticQueryFn(opts, _state);
 		return fetcher(q, page, size);
 	};