nuxt-ui-tools 1.1.0 → 1.2.0

package/dist/runtime/table/types/source.d.ts

@@ -62,6 +62,11 @@ export interface TableFacetRequestDescriptor<TKey extends string = string> {
     search?: string;
     limit?: number;
     cursor?: string | null;
+    /**
+     * Values to count, and only these. Filters loading options page by page (`source.remote`) send
+     * the values of one loaded page, since no single request can know every value.
+     */
+    values?: readonly (string | number | boolean)[];
 }
 export interface TableFacetOptionResult<TValue = unknown> {
     value: TValue;

package/dist/runtime/table/utils/filters/options.d.ts

@@ -10,6 +10,8 @@ export declare function resolveFilterOptionEntries(options: {
         count: number;
     }[];
     missingCountFallback?: number;
+    /** `options` is the complete answer (remote pages): an empty list stays empty instead of listing facet values. */
+    authoritative?: boolean;
 }): TableResolvedFilterOptionEntry<import("../../types/index.js").TableFilterPrimitiveValue>[] | {
     children: never[];
     count: number | undefined;

package/dist/runtime/table/utils/filters/options.js

@@ -21,7 +21,7 @@ export function resolveFilterOptionEntries(options) {
     return [];
   }
   const configuredOptions = options.options ?? options.definition.source?.options ?? [];
-  const sourceOptions = configuredOptions.length ? configuredOptions : (options.facetCounts ?? []).map((entry) => ({
+  const sourceOptions = configuredOptions.length || options.authoritative ? configuredOptions : (options.facetCounts ?? []).map((entry) => ({
     count: entry.count,
     label: String(entry.value),
     value: entry.value

package/dist/runtime/table/utils/prefetch.js

@@ -40,7 +40,11 @@ export function prefetchTable(params) {
       route: params.route,
       schema
     });
-    return resolveTableQueries({ request, schema });
+    return resolveTableQueries({
+      request,
+      rules: resolveFilterState(params.route, schema).ui,
+      schema
+    });
   }).stage((stageContext) => {
     const rows = resolvePrefetchedRows(stageContext.source);
     const context = resolveContextData(schema, stageContext);
@@ -93,6 +97,13 @@ function resolveTableQueries(options) {
     ]);
   }
   for (const definition of definitions) {
+    const selectedOptions = resolveRemoteSelectedQuery(definition, options.rules);
+    if (selectedOptions) {
+      entries.push([
+        `filter-selected-options:${definition.key}`,
+        withQueryDefaults(selectedOptions, QUERY_DEFAULTS.staleTime.filterOptions)
+      ]);
+    }
     if (definition.kind === "option" && isOptionQueryResolver(definition.source?.query)) {
       entries.push([
         `filter-options:${definition.key}`,
@@ -130,6 +141,15 @@ function resolveTableQueries(options) {
   }
   return Object.fromEntries(entries);
 }
+function resolveRemoteSelectedQuery(definition, rules) {
+  const resolve = definition.kind === "option" ? definition.source?.remote?.resolveSelected : void 0;
+  if (!resolve) return;
+  const rule = rules.find((entry) => entry.key === definition.key);
+  const values = (Array.isArray(rule?.value) ? rule.value : isNullish(rule?.value) ? [] : [rule.value]).filter(
+    (value) => isString(value) || isNumber(value) || isBoolean(value)
+  );
+  return values.length ? resolve({ values }) : void 0;
+}
 function resolveSourcePrefetchQuery(options) {
   const definition = options.schema.source.mode === "remote" ? options.schema.source.query(
     toTableRemoteSourceRequest(options.request),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-ui-tools",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Nuxt module and runtime toolkit for UI-heavy Nuxt applications",
   "homepage": "https://github.com/ChronicStone/nuxt-ui-tools#readme",
   "bugs": "https://github.com/ChronicStone/nuxt-ui-tools/issues",