@atscript/ui-table 0.1.119 → 0.1.121

package/dist/index.d.cts

@@ -896,6 +896,20 @@ interface TableStateData {
   /** Full-text search term. */
   searchTerm: string;
 }
+/** Per-call options for `query()` / `queryImmediate()`. */
+interface QueryOptions {
+  /**
+   * Run one query cycle WITHOUT loading affordances: the `querying` flag is
+   * never flipped (toolbar spinners, skeletons and the query overlay all key
+   * off it, so they stay quiet), and a failure leaves the currently displayed
+   * rows, `windowCache`, `totalCount` and error state untouched — no blanking,
+   * no error report. Everything else is identical to a normal query: the
+   * generation guard, keep-rows-until-settle swap, and respect of the current
+   * filters / sorters / search / pagination. Designed for timer-driven live
+   * refresh of the standard list view.
+   */
+  silent?: boolean;
+}
 /**
  * Methods that any table state implementation must provide.
  *
@@ -912,16 +926,21 @@ interface TableStateMethods {
    * fetch on the next microtask. Multiple `query()` calls and watcher-driven
    * scheduleQuery calls in the same synchronous block coalesce into one
    * fetch. Use this from dialogs / mutators where you don't need to await.
+   * Pass `{ silent: true }` for a live refresh that runs the current query
+   * without touching the `querying` flag and leaves rows as-is on failure —
+   * see {@link QueryOptions}.
    */
-  query(): void;
+  query(opts?: QueryOptions): void;
   /**
    * Synchronous refresh — fires the fetch now and returns a Promise that
    * settles when the response (or error) has been processed. Cancels any
    * pending coalesced query so we don't double-fire. Honours `blockQuery`,
    * `forceFilters`, `forceSorters`, `queryFn`. Use this from refresh
-   * buttons / programmatic flows that need the result.
+   * buttons / programmatic flows that need the result. Pass `{ silent: true }`
+   * to await a live refresh with no loading flag and no blank-on-error — see
+   * {@link QueryOptions}.
    */
-  queryImmediate(): Promise<void>;
+  queryImmediate(opts?: QueryOptions): Promise<void>;
   /**
    * Append-style extension. Does NOT mutate `pagination.page` (extension
    * runs parallel to pagination). Re-entry guarded via `queryingNext`.
@@ -1057,4 +1076,4 @@ type ColumnReorderPosition = "before" | "after";
  */
 declare function reorderColumnNames(names: string[], fromPath: string, toPath: string, position: ColumnReorderPosition): string[];
 //#endregion
-export { APP_CONF_PREFIX, type AppConfData, AppPrefsClient, type AppPrefsClientConfig, type AppPrefsLoadResult, type AsPresetEntryData, type AsPresetEntryRow, type AsPresetsErrorCode, type AspectGate, type AspectMask, type BuildTableQueryOptions, type ColumnFilterType, type ColumnReorderPosition, type ColumnWidthEntry, type ColumnWidthsMap, type ConfigTab, DEFAULT_ROW_HEIGHT_PX, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DraftPersistedAspect, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, MAX_DEFAULT_COLUMN_WIDTH_PX, type MergeResult, NULL_OPS, PRESET_ASPECTS, type PageAlignedBlock, type PlanFetchArgs, type PresetAspect, type PresetCapabilities, type PresetColumnWidthEntry, type PresetData, type PresetDraft, type PresetFilterOpEntry, type PresetLimitReachedBody, type PresetSnapshot, type PresetSnapshotWire, type PresetSorterEntry, PresetsClient, type PresetsClientConfig, PresetsHttpError, type PresetsListResult, type PresetsSaveAsOptions, type PresetsSaveResult, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, type SelectionMode, type SystemPreset, type SystemPresetInput, type TableStateData, type TableStateMethods, USER_CONF_PREFIX, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, clampTopIndex, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortersEqual, stableStringify, stateToUrlQueryString, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb };
+export { APP_CONF_PREFIX, type AppConfData, AppPrefsClient, type AppPrefsClientConfig, type AppPrefsLoadResult, type AsPresetEntryData, type AsPresetEntryRow, type AsPresetsErrorCode, type AspectGate, type AspectMask, type BuildTableQueryOptions, type ColumnFilterType, type ColumnReorderPosition, type ColumnWidthEntry, type ColumnWidthsMap, type ConfigTab, DEFAULT_ROW_HEIGHT_PX, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DraftPersistedAspect, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, MAX_DEFAULT_COLUMN_WIDTH_PX, type MergeResult, NULL_OPS, PRESET_ASPECTS, type PageAlignedBlock, type PlanFetchArgs, type PresetAspect, type PresetCapabilities, type PresetColumnWidthEntry, type PresetData, type PresetDraft, type PresetFilterOpEntry, type PresetLimitReachedBody, type PresetSnapshot, type PresetSnapshotWire, type PresetSorterEntry, PresetsClient, type PresetsClientConfig, PresetsHttpError, type PresetsListResult, type PresetsSaveAsOptions, type PresetsSaveResult, type QueryOptions, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, type SelectionMode, type SystemPreset, type SystemPresetInput, type TableStateData, type TableStateMethods, USER_CONF_PREFIX, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, clampTopIndex, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortersEqual, stableStringify, stateToUrlQueryString, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb };

package/dist/index.d.mts

@@ -896,6 +896,20 @@ interface TableStateData {
   /** Full-text search term. */
   searchTerm: string;
 }
+/** Per-call options for `query()` / `queryImmediate()`. */
+interface QueryOptions {
+  /**
+   * Run one query cycle WITHOUT loading affordances: the `querying` flag is
+   * never flipped (toolbar spinners, skeletons and the query overlay all key
+   * off it, so they stay quiet), and a failure leaves the currently displayed
+   * rows, `windowCache`, `totalCount` and error state untouched — no blanking,
+   * no error report. Everything else is identical to a normal query: the
+   * generation guard, keep-rows-until-settle swap, and respect of the current
+   * filters / sorters / search / pagination. Designed for timer-driven live
+   * refresh of the standard list view.
+   */
+  silent?: boolean;
+}
 /**
  * Methods that any table state implementation must provide.
  *
@@ -912,16 +926,21 @@ interface TableStateMethods {
    * fetch on the next microtask. Multiple `query()` calls and watcher-driven
    * scheduleQuery calls in the same synchronous block coalesce into one
    * fetch. Use this from dialogs / mutators where you don't need to await.
+   * Pass `{ silent: true }` for a live refresh that runs the current query
+   * without touching the `querying` flag and leaves rows as-is on failure —
+   * see {@link QueryOptions}.
    */
-  query(): void;
+  query(opts?: QueryOptions): void;
   /**
    * Synchronous refresh — fires the fetch now and returns a Promise that
    * settles when the response (or error) has been processed. Cancels any
    * pending coalesced query so we don't double-fire. Honours `blockQuery`,
    * `forceFilters`, `forceSorters`, `queryFn`. Use this from refresh
-   * buttons / programmatic flows that need the result.
+   * buttons / programmatic flows that need the result. Pass `{ silent: true }`
+   * to await a live refresh with no loading flag and no blank-on-error — see
+   * {@link QueryOptions}.
    */
-  queryImmediate(): Promise<void>;
+  queryImmediate(opts?: QueryOptions): Promise<void>;
   /**
    * Append-style extension. Does NOT mutate `pagination.page` (extension
    * runs parallel to pagination). Re-entry guarded via `queryingNext`.
@@ -1057,4 +1076,4 @@ type ColumnReorderPosition = "before" | "after";
  */
 declare function reorderColumnNames(names: string[], fromPath: string, toPath: string, position: ColumnReorderPosition): string[];
 //#endregion
-export { APP_CONF_PREFIX, type AppConfData, AppPrefsClient, type AppPrefsClientConfig, type AppPrefsLoadResult, type AsPresetEntryData, type AsPresetEntryRow, type AsPresetsErrorCode, type AspectGate, type AspectMask, type BuildTableQueryOptions, type ColumnFilterType, type ColumnReorderPosition, type ColumnWidthEntry, type ColumnWidthsMap, type ConfigTab, DEFAULT_ROW_HEIGHT_PX, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DraftPersistedAspect, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, MAX_DEFAULT_COLUMN_WIDTH_PX, type MergeResult, NULL_OPS, PRESET_ASPECTS, type PageAlignedBlock, type PlanFetchArgs, type PresetAspect, type PresetCapabilities, type PresetColumnWidthEntry, type PresetData, type PresetDraft, type PresetFilterOpEntry, type PresetLimitReachedBody, type PresetSnapshot, type PresetSnapshotWire, type PresetSorterEntry, PresetsClient, type PresetsClientConfig, PresetsHttpError, type PresetsListResult, type PresetsSaveAsOptions, type PresetsSaveResult, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, type SelectionMode, type SystemPreset, type SystemPresetInput, type TableStateData, type TableStateMethods, USER_CONF_PREFIX, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, clampTopIndex, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortersEqual, stableStringify, stateToUrlQueryString, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb };
+export { APP_CONF_PREFIX, type AppConfData, AppPrefsClient, type AppPrefsClientConfig, type AppPrefsLoadResult, type AsPresetEntryData, type AsPresetEntryRow, type AsPresetsErrorCode, type AspectGate, type AspectMask, type BuildTableQueryOptions, type ColumnFilterType, type ColumnReorderPosition, type ColumnWidthEntry, type ColumnWidthsMap, type ConfigTab, DEFAULT_ROW_HEIGHT_PX, DRAFT_PERSISTED_ASPECTS, type DateShortcut, type DraftPersistedAspect, type FetchPlan, type FetchPlanMode, type FieldFilters, type FilterCondition, type FilterConditionType, MAX_DEFAULT_COLUMN_WIDTH_PX, type MergeResult, NULL_OPS, PRESET_ASPECTS, type PageAlignedBlock, type PlanFetchArgs, type PresetAspect, type PresetCapabilities, type PresetColumnWidthEntry, type PresetData, type PresetDraft, type PresetFilterOpEntry, type PresetLimitReachedBody, type PresetSnapshot, type PresetSnapshotWire, type PresetSorterEntry, PresetsClient, type PresetsClientConfig, PresetsHttpError, type PresetsListResult, type PresetsSaveAsOptions, type PresetsSaveResult, type QueryOptions, RESERVED_ID_PREFIXES, STANDARD_PRESET_ID, SYSTEM_PRESET_PREFIX, type SelectionMode, type SystemPreset, type SystemPresetInput, type TableStateData, type TableStateMethods, USER_CONF_PREFIX, type UrlQueryDefaults, type UrlQueryParseOptions, type UrlQueryStateLike, type UrlQueryStateSnapshot, type UrlQuerySync, type UserConfData, appConfId, arraysEqual, blockStartFor, buildTableQuery, clampTopIndex, columnFilterType, computeDefaultColumnWidth, conditionLabel, conditionsForType, dateShortcuts, debounce, defaultCondition, derivePresetAspects, deserializeDraft, draftMatchesPreset, escapeRegex, filledFilterCount, filterTokenLabel, filtersToUniqueryFilter, formatFilterCondition, fromWireSnapshot, hasSecondValue, isAuthError, isDirtyAgainst, isEmptyDraft, isFilled, isSimpleEq, isSystemPresetId, mergeFilters, mergeSorters, normaliseSystemPresetId, pageAlignedBlocksFor, parseFilterInput, planFetch, reconcileColumnWidthDefaults, reorderColumnNames, resolveAspectGate, resolveSystemPresets, rowsToPks, sameColumnSet, serializeDraft, setsEqual, sortersEqual, stableStringify, stateToUrlQueryString, toWireSnapshot, togglePk, trimSelection, unescapeRegex, uniqueryFilterToFieldFilters, urlQueryStringToState, userConfId, walkBackwardAbsorb, walkForwardAbsorb };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/ui-table",
-  "version": "0.1.119",
+  "version": "0.1.121",
   "description": "Framework-agnostic filter model, filter-to-Uniquery conversion, and preset serialization for atscript tables",
   "keywords": [
     "atscript",
@@ -42,16 +42,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@atscript/ui": "0.1.119"
+    "@atscript/ui": "0.1.121"
   },
   "devDependencies": {
-    "@atscript/db-client": "^0.1.114",
+    "@atscript/db-client": "^0.1.115",
     "@uniqu/core": "^0.1.7",
     "@uniqu/url": "^0.1.7",
     "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.14"
   },
   "peerDependencies": {
-    "@atscript/db-client": "^0.1.114",
+    "@atscript/db-client": "^0.1.115",
     "@uniqu/core": "^0.1.7",
     "@uniqu/url": "^0.1.7"
   },