@atscript/ui-table 0.1.118 → 0.1.120

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/index.d.cts +23 -4
  2. package/dist/index.d.mts +23 -4
  3. package/package.json +8 -8
package/dist/index.d.cts CHANGED
@@ -896,6 +896,20 @@ interface TableStateData {
896
896
  /** Full-text search term. */
897
897
  searchTerm: string;
898
898
  }
899
+ /** Per-call options for `query()` / `queryImmediate()`. */
900
+ interface QueryOptions {
901
+ /**
902
+ * Run one query cycle WITHOUT loading affordances: the `querying` flag is
903
+ * never flipped (toolbar spinners, skeletons and the query overlay all key
904
+ * off it, so they stay quiet), and a failure leaves the currently displayed
905
+ * rows, `windowCache`, `totalCount` and error state untouched — no blanking,
906
+ * no error report. Everything else is identical to a normal query: the
907
+ * generation guard, keep-rows-until-settle swap, and respect of the current
908
+ * filters / sorters / search / pagination. Designed for timer-driven live
909
+ * refresh of the standard list view.
910
+ */
911
+ silent?: boolean;
912
+ }
899
913
  /**
900
914
  * Methods that any table state implementation must provide.
901
915
  *
@@ -912,16 +926,21 @@ interface TableStateMethods {
912
926
  * fetch on the next microtask. Multiple `query()` calls and watcher-driven
913
927
  * scheduleQuery calls in the same synchronous block coalesce into one
914
928
  * fetch. Use this from dialogs / mutators where you don't need to await.
929
+ * Pass `{ silent: true }` for a live refresh that runs the current query
930
+ * without touching the `querying` flag and leaves rows as-is on failure —
931
+ * see {@link QueryOptions}.
915
932
  */
916
- query(): void;
933
+ query(opts?: QueryOptions): void;
917
934
  /**
918
935
  * Synchronous refresh — fires the fetch now and returns a Promise that
919
936
  * settles when the response (or error) has been processed. Cancels any
920
937
  * pending coalesced query so we don't double-fire. Honours `blockQuery`,
921
938
  * `forceFilters`, `forceSorters`, `queryFn`. Use this from refresh
922
- * buttons / programmatic flows that need the result.
939
+ * buttons / programmatic flows that need the result. Pass `{ silent: true }`
940
+ * to await a live refresh with no loading flag and no blank-on-error — see
941
+ * {@link QueryOptions}.
923
942
  */
924
- queryImmediate(): Promise<void>;
943
+ queryImmediate(opts?: QueryOptions): Promise<void>;
925
944
  /**
926
945
  * Append-style extension. Does NOT mutate `pagination.page` (extension
927
946
  * runs parallel to pagination). Re-entry guarded via `queryingNext`.
@@ -1057,4 +1076,4 @@ type ColumnReorderPosition = "before" | "after";
1057
1076
  */
1058
1077
  declare function reorderColumnNames(names: string[], fromPath: string, toPath: string, position: ColumnReorderPosition): string[];
1059
1078
  //#endregion
1060
- 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 };
1079
+ 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 CHANGED
@@ -896,6 +896,20 @@ interface TableStateData {
896
896
  /** Full-text search term. */
897
897
  searchTerm: string;
898
898
  }
899
+ /** Per-call options for `query()` / `queryImmediate()`. */
900
+ interface QueryOptions {
901
+ /**
902
+ * Run one query cycle WITHOUT loading affordances: the `querying` flag is
903
+ * never flipped (toolbar spinners, skeletons and the query overlay all key
904
+ * off it, so they stay quiet), and a failure leaves the currently displayed
905
+ * rows, `windowCache`, `totalCount` and error state untouched — no blanking,
906
+ * no error report. Everything else is identical to a normal query: the
907
+ * generation guard, keep-rows-until-settle swap, and respect of the current
908
+ * filters / sorters / search / pagination. Designed for timer-driven live
909
+ * refresh of the standard list view.
910
+ */
911
+ silent?: boolean;
912
+ }
899
913
  /**
900
914
  * Methods that any table state implementation must provide.
901
915
  *
@@ -912,16 +926,21 @@ interface TableStateMethods {
912
926
  * fetch on the next microtask. Multiple `query()` calls and watcher-driven
913
927
  * scheduleQuery calls in the same synchronous block coalesce into one
914
928
  * fetch. Use this from dialogs / mutators where you don't need to await.
929
+ * Pass `{ silent: true }` for a live refresh that runs the current query
930
+ * without touching the `querying` flag and leaves rows as-is on failure —
931
+ * see {@link QueryOptions}.
915
932
  */
916
- query(): void;
933
+ query(opts?: QueryOptions): void;
917
934
  /**
918
935
  * Synchronous refresh — fires the fetch now and returns a Promise that
919
936
  * settles when the response (or error) has been processed. Cancels any
920
937
  * pending coalesced query so we don't double-fire. Honours `blockQuery`,
921
938
  * `forceFilters`, `forceSorters`, `queryFn`. Use this from refresh
922
- * buttons / programmatic flows that need the result.
939
+ * buttons / programmatic flows that need the result. Pass `{ silent: true }`
940
+ * to await a live refresh with no loading flag and no blank-on-error — see
941
+ * {@link QueryOptions}.
923
942
  */
924
- queryImmediate(): Promise<void>;
943
+ queryImmediate(opts?: QueryOptions): Promise<void>;
925
944
  /**
926
945
  * Append-style extension. Does NOT mutate `pagination.page` (extension
927
946
  * runs parallel to pagination). Re-entry guarded via `queryingNext`.
@@ -1057,4 +1076,4 @@ type ColumnReorderPosition = "before" | "after";
1057
1076
  */
1058
1077
  declare function reorderColumnNames(names: string[], fromPath: string, toPath: string, position: ColumnReorderPosition): string[];
1059
1078
  //#endregion
1060
- 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 };
1079
+ 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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atscript/ui-table",
3
- "version": "0.1.118",
3
+ "version": "0.1.120",
4
4
  "description": "Framework-agnostic filter model, filter-to-Uniquery conversion, and preset serialization for atscript tables",
5
5
  "keywords": [
6
6
  "atscript",
@@ -42,18 +42,18 @@
42
42
  "access": "public"
43
43
  },
44
44
  "dependencies": {
45
- "@atscript/ui": "0.1.118"
45
+ "@atscript/ui": "0.1.120"
46
46
  },
47
47
  "devDependencies": {
48
- "@atscript/db-client": "^0.1.113",
49
- "@uniqu/core": "^0.1.6",
50
- "@uniqu/url": "^0.1.6",
48
+ "@atscript/db-client": "^0.1.114",
49
+ "@uniqu/core": "^0.1.7",
50
+ "@uniqu/url": "^0.1.7",
51
51
  "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.14"
52
52
  },
53
53
  "peerDependencies": {
54
- "@atscript/db-client": "^0.1.113",
55
- "@uniqu/core": "^0.1.6",
56
- "@uniqu/url": "^0.1.6"
54
+ "@atscript/db-client": "^0.1.114",
55
+ "@uniqu/core": "^0.1.7",
56
+ "@uniqu/url": "^0.1.7"
57
57
  },
58
58
  "scripts": {
59
59
  "build": "vp pack",