@parallelworks/ui 0.88.2 → 0.89.0

package/dist/list/index.d.ts

@@ -1,5 +1,5 @@
 export { ActionToolbar, type ToolbarAction, ToolbarButton, type ToolbarItem, } from './ActionToolbar.js';
-export { type ActiveFilter, applyFilterList, DATE_PRESETS, type DatePreset, dateFilterRange, decodeFilters, encodeFilters, type FilterField, type FilterKind, type FilterOperator, type FilterOption, type FilterRowValue, filterParamKeys, matchFilter, sameFilters, withFilterParams, } from './filterModel.js';
+export { type ActiveFilter, applyFilterList, DATE_PRESETS, type DatePreset, dateFilterRange, decodeFilters, encodeFilters, type FilterField, type FilterKind, type FilterOperator, type FilterOption, type FilterRowValue, filterParamKeys, matchFilter, type QuickFilter, sameFilters, withFilterParams, } from './filterModel.js';
 export { AddFilterMenu, type AddFilterMenuProps, FilterChip, ListFilterBar, type ListFilterBarProps, } from './ListFilterBar.js';
 export { GroupRow, ListColumns, ListPage, type ListPageEmpty, type ListPageProps, ListRow, ListRowActionsProvider, useListNavigate, } from './ListPage.js';
 export { actionsColumnWidth, ListActionsHeader, ListCellText, ListError, ListSelectAllHeader, ListSkeleton, listTableFixedProps, listTableProps, NAME_MIN_WIDTH_PX, NameCell, RowSelectCheckbox, STRETCHED_LINK, } from './ListTable.js';

package/dist/list/listView.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { ActiveFilter, FilterField } from './filterModel.js';
+import type { ActiveFilter, FilterField, QuickFilter } from './filterModel.js';
 import { type FilterStore, type ListFilters } from './useListFilters.js';
 /** A toggleable column. Rendering stays in the page's row component, gated by
  * {@link ListView.isVisible}; this is just the header metadata + visibility. */
@@ -97,6 +97,9 @@ export interface ListViewConfig<T> {
     filterStore?: FilterStore | undefined;
     /** False leaves remembering the filters to `filterStore` alone. */
     rememberFilters?: boolean | undefined;
+    /** Fields whose values also show as toggles above the chips, such as a job's state with how
+     *  many jobs are in each. */
+    quickFilters?: readonly QuickFilter[] | undefined;
     actions?: ActionDef[];
     /** Explicit pinned-button count when not using actions+isPinned; sizes the actions column. */
     actionCount?: number;
@@ -192,5 +195,5 @@ export interface ListView<T> extends ListViewChrome {
 }
 /** Persisted grouping + column-visibility + field-filter state for a list page,
  * driving the shared Display/Filter menus. */
-export declare function useListView<T>({ storageKey, sharedFiltersKey, columns, groupBys, defaultGroupBy, orderBys, defaultOrderBy, facets, filterFields, defaultFilters, filterStore, rememberFilters, actions, actionCount, defaultShowColumnHeaders, defaultShowActions, isFavorite, isOn, createdAt, }: ListViewConfig<T>): ListView<T>;
+export declare function useListView<T>({ storageKey, sharedFiltersKey, columns, groupBys, defaultGroupBy, orderBys, defaultOrderBy, facets, filterFields, defaultFilters, filterStore, rememberFilters, quickFilters, actions, actionCount, defaultShowColumnHeaders, defaultShowActions, isFavorite, isOn, createdAt, }: ListViewConfig<T>): ListView<T>;
 export {};

package/dist/list/listView.js

@@ -28,7 +28,7 @@ var DEFAULT_ORDER = "__default";
 var FAVORITE_ORDER = "__favorite";
 /** Persisted grouping + column-visibility + field-filter state for a list page,
 * driving the shared Display/Filter menus. */
-function useListView({ storageKey, sharedFiltersKey, columns, groupBys = [], defaultGroupBy, orderBys = [], defaultOrderBy, facets = [], filterFields, defaultFilters, filterStore, rememberFilters = true, actions = [], actionCount, defaultShowColumnHeaders = true, defaultShowActions = true, isFavorite, isOn, createdAt }) {
+function useListView({ storageKey, sharedFiltersKey, columns, groupBys = [], defaultGroupBy, orderBys = [], defaultOrderBy, facets = [], filterFields, defaultFilters, filterStore, rememberFilters = true, quickFilters, actions = [], actionCount, defaultShowColumnHeaders = true, defaultShowActions = true, isFavorite, isOn, createdAt }) {
 	const t = useStrings().list;
 	const tiebreak = orderBys[0]?.compare;
 	const effectiveOrderBys = useMemo(() => {
@@ -76,7 +76,8 @@ function useListView({ storageKey, sharedFiltersKey, columns, groupBys = [], def
 		fields,
 		defaultFilters,
 		store: filterStore,
-		remember: rememberFilters
+		remember: rememberFilters,
+		quick: quickFilters
 	});
 	const filters = useMemo(() => {
 		const out = {};

package/dist/list/useListFilters.d.ts

@@ -1,4 +1,4 @@
-import { type ActiveFilter, type FilterField, type FilterOperator } from './filterModel.js';
+import { type ActiveFilter, type FilterField, type FilterOperator, type QuickFilter } from './filterModel.js';
 /** Where filters live besides what the list remembers, such as the page's URL. */
 export interface FilterStore {
     /** The filters it holds, or `null` when it holds none, such as a URL with no filter params,
@@ -20,6 +20,8 @@ export interface ListFiltersConfig<T> {
     store?: FilterStore | undefined;
     /** False leaves remembering to the store alone. */
     remember?: boolean | undefined;
+    /** Fields whose values also show as toggles above the chips. */
+    quick?: readonly QuickFilter[] | undefined;
 }
 /** A request for a chip to open one of its pickers, which the chip clears once it has. */
 export interface FilterEditRequest {
@@ -30,6 +32,8 @@ export interface FilterEditRequest {
 /** A list's filters, the state behind the chip row and the Filter menu. */
 export interface ListFilters {
     fields: readonly FilterField<any>[];
+    /** Fields whose values also show as toggles above the chips. */
+    quick: readonly QuickFilter[];
     /** The filters in effect, in the order they were added. */
     active: readonly ActiveFilter[];
     /** The chips to show: the filters in effect, then one being added that has no value yet. */
@@ -65,4 +69,4 @@ export interface ListFilters {
 /** A list's active filters: which, in what order, where they are remembered and how rows
  *  match them. `useListView` builds one from its facets and fields; a page not on it, or
  *  filtering on the server, can call this alone. */
-export declare function useListFilters<T>({ storageKey, sharedFiltersKey, fields, defaultFilters, store, remember, }: ListFiltersConfig<T>): ListFilters;
+export declare function useListFilters<T>({ storageKey, sharedFiltersKey, fields, defaultFilters, store, remember, quick, }: ListFiltersConfig<T>): ListFilters;

package/dist/list/useListFilters.js

@@ -3,10 +3,11 @@ import { applyFilterList, fieldOperators, fromStored, isComplete, sameFilters, t
 import { useCallback, useMemo, useRef, useState } from "react";
 //#region src/list/useListFilters.ts
 var NONE = [];
+var NO_QUICK = [];
 /** A list's active filters: which, in what order, where they are remembered and how rows
 *  match them. `useListView` builds one from its facets and fields; a page not on it, or
 *  filtering on the server, can call this alone. */
-function useListFilters({ storageKey, sharedFiltersKey, fields, defaultFilters = NONE, store, remember = true }) {
+function useListFilters({ storageKey, sharedFiltersKey, fields, defaultFilters = NONE, store, remember = true, quick = NO_QUICK }) {
 	const sharedKeys = useMemo(() => new Set(fields.filter((f) => f.shared).map((f) => f.key)), [fields]);
 	const defaults = useMemo(() => defaultFilters.filter((f) => !sharedKeys.has(f.field)), [defaultFilters, sharedKeys]);
 	const sharedDefaults = useMemo(() => defaultFilters.filter((f) => sharedKeys.has(f.field)), [defaultFilters, sharedKeys]);
@@ -218,6 +219,7 @@ function useListFilters({ storageKey, sharedFiltersKey, fields, defaultFilters =
 	const apply = useCallback((rows) => applyFilterList(rows, active, fields), [active, fields]);
 	return {
 		fields,
+		quick,
 		active,
 		chips: useMemo(() => {
 			if (!draft) return active;