@ketvietlab/ketsuite 0.1.25 → 0.1.30

package/dist/modules/backend/search-filter-state.js

@@ -0,0 +1,277 @@
+// The server half of the search-filter bar.
+//
+// The bar talks to four functions: one that turns the viewer's facets into a
+// href, and three that manage saved searches. None of that reads a domain — it
+// is `ListSearchShape` in, `ListState` out — yet `product_backend` carried 290
+// lines of it for one list. A second list would have copied them, and a third
+// would have copied the copy, so the logic lives here and a module declares
+// only which lists it owns.
+//
+// The functions stay in the owning module rather than in `backend`: a filter on
+// the product catalogue is product's `view` permission, not an internal
+// backend one, and `backend` is a headless module with no bundles to grant.
+import { randomUUID } from 'node:crypto';
+import { defineFn, encodeListState, eq, from, parseListState, validateListState } from '@ketvietlab/ketjs';
+/** The state a list starts from: nothing selected, sorted the way the spec says. */
+export const emptyListState = (spec) => ({
+    presets: [],
+    filters: [],
+    groupBy: [],
+    sort: [...(spec.defaultSort ?? [])],
+    openGroups: [],
+    groupPages: {},
+    page: 1,
+    includeArchived: false,
+});
+const bindingOf = (bindings, listKey) => {
+    const key = typeof listKey === 'string' ? listKey : '';
+    const binding = bindings.find((candidate) => candidate.key === key) ?? (key ? undefined : bindings[0]);
+    if (!binding)
+        throw new Error(`unknown list "${key}"`);
+    return binding;
+};
+/** A payload names where to go back to, so it may only name this list's page. */
+const safeUrl = (binding, value) => {
+    const url = new URL(typeof value === 'string' ? value : binding.path, 'http://ket.local');
+    const allowed = binding.accepts ? binding.accepts.test(url.pathname) : url.pathname === binding.path;
+    return allowed ? url : new URL(binding.path, 'http://ket.local');
+};
+const facetsOf = (value) => Array.isArray(value)
+    ? value.flatMap((facet) => {
+        if (!facet || typeof facet !== 'object')
+            return [];
+        const candidate = facet;
+        return typeof candidate.id === 'string' &&
+            typeof candidate.type === 'string' &&
+            typeof candidate.label === 'string'
+            ? [{ id: candidate.id, type: candidate.type, label: candidate.label }]
+            : [];
+    })
+    : [];
+const stringRules = (value) => Array.isArray(value)
+    ? value.flatMap((rule) => {
+        if (!rule || typeof rule !== 'object')
+            return [];
+        const candidate = rule;
+        return typeof candidate.id === 'string' &&
+            typeof candidate.field === 'string' &&
+            typeof candidate.operator === 'string'
+            ? [
+                {
+                    id: candidate.id,
+                    field: candidate.field,
+                    operator: candidate.operator,
+                    value: candidate.value,
+                },
+            ]
+            : [];
+    })
+    : [];
+const ruleValue = (raw, type, operator) => {
+    if (['isTrue', 'isFalse', 'isSet', 'isNotSet'].includes(operator))
+        return undefined;
+    const value = String(raw ?? '').trim();
+    if (operator === 'anyOf')
+        return value
+            .split(',')
+            .map((part) => part.trim())
+            .filter(Boolean);
+    if (operator === 'between')
+        return value.split(',').map((part) => (type === 'number' ? Number(part.trim()) : part.trim()));
+    return type === 'number' ? Number(value) : value;
+};
+/** The viewer's facets, read back as the list state they stand for. */
+export const stateFromPayload = (ctx, binding, payload) => {
+    const spec = binding.spec(ctx);
+    const prior = parseListState(spec, safeUrl(binding, payload.returnTo)).state;
+    const facets = facetsOf(payload.facets);
+    const latestQuery = (typeof payload.query === 'string' ? payload.query.trim() : '') ||
+        [...facets].reverse().find((facet) => facet.type === 'field')?.label;
+    const presets = new Set((spec.presets ?? []).map((preset) => preset.key));
+    const selectedPresets = facets
+        .filter((facet) => facet.type === 'filter' && facet.id.startsWith('preset:'))
+        .map((facet) => facet.id.slice('preset:'.length))
+        .filter((key) => presets.has(key));
+    const fieldByKey = new Map((spec.filterable ?? []).map((field) => [field.key, field]));
+    const filters = stringRules(payload.customFilters).flatMap((rule) => {
+        const field = fieldByKey.get(rule.field);
+        if (!field)
+            return [];
+        const value = ruleValue(rule.value, field.type, rule.operator);
+        return [
+            {
+                kind: 'rule',
+                field: rule.field,
+                operator: rule.operator,
+                ...(value === undefined ? {} : { value }),
+            },
+        ];
+    });
+    const groupFields = new Map((spec.groupable ?? []).map((field) => [field.key, field]));
+    const selectedGroups = (Array.isArray(payload.groupBy) ? payload.groupBy : []).flatMap((entry) => {
+        if (typeof entry !== 'string')
+            return [];
+        const [key, interval] = entry.split(':');
+        const field = groupFields.get(key ?? '');
+        if (!field || (interval && !field.intervals?.includes(interval)))
+            return [];
+        return [{ key: key, ...(interval ? { interval: interval } : {}) }];
+    });
+    const uniqueGroups = selectedGroups.filter((group, index) => selectedGroups.findIndex((candidate) => candidate.key === group.key) === index);
+    const state = {
+        ...emptyListState(spec),
+        ...(latestQuery?.trim() ? { q: latestQuery.trim() } : {}),
+        presets: selectedPresets,
+        filters,
+        groupBy: uniqueGroups,
+        sort: prior.sort.length ? prior.sort : [...(spec.defaultSort ?? [])],
+        includeArchived: facets.some((facet) => facet.type === 'filter' && facet.id === 'archived'),
+        favoriteId: typeof payload.favoriteId === 'string' && payload.favoriteId ? payload.favoriteId : undefined,
+    };
+    validateListState(spec, state);
+    return state;
+};
+const savedState = async (ctx, binding, id) => {
+    if (!ctx.actor)
+        return null;
+    const S = ctx.table('backend.SavedSearch');
+    const saved = await ctx.db.one(from(S).where(eq(S.id, id), eq(S.ownerId, ctx.actor), eq(S.listKey, binding.key), eq(S.active, true)));
+    if (!saved?.state || typeof saved.state !== 'object' || Array.isArray(saved.state))
+        return null;
+    const spec = binding.spec(ctx);
+    const fallback = emptyListState(spec);
+    const raw = saved.state;
+    const state = {
+        ...fallback,
+        ...(typeof raw.q === 'string' && raw.q.trim() ? { q: raw.q.trim() } : {}),
+        presets: Array.isArray(raw.presets) ? raw.presets : [],
+        filters: Array.isArray(raw.filters) ? raw.filters : [],
+        groupBy: Array.isArray(raw.groupBy) ? raw.groupBy : [],
+        sort: Array.isArray(raw.sort) && raw.sort.length ? raw.sort : fallback.sort,
+        includeArchived: raw.includeArchived === true,
+        favoriteId: id,
+    };
+    try {
+        validateListState(spec, state);
+        return state;
+    }
+    catch {
+        return null;
+    }
+};
+/** Where the viewer's current facets lead. */
+export const searchFilterHref = (ctx, binding, payload) => {
+    const target = safeUrl(binding, payload.returnTo);
+    const favoriteId = typeof payload.favoriteId === 'string' ? payload.favoriteId : '';
+    if (!favoriteId) {
+        const href = new URL(encodeListState(stateFromPayload(ctx, binding, payload), target), target);
+        // An explicit clear must not immediately reapply the viewer's default search.
+        href.searchParams.delete('favorite');
+        // An explicit empty query is expanded state, so a bare clear cannot reload a default favorite.
+        if (!href.searchParams.has('q'))
+            href.searchParams.set('q', '');
+        return `${href.pathname}${href.search}`;
+    }
+    return savedState(ctx, binding, favoriteId).then((state) => encodeListState(state ?? stateFromPayload(ctx, binding, { ...payload, favoriteId: undefined }), target));
+};
+/**
+ * The four functions the bar calls, for every list a module owns.
+ *
+ * The bar sends `listKey` from its manager's `applyInput`, which arrives at the
+ * top level for apply, delete and set-default, and nested inside `state` when a
+ * favourite is saved — so a module needs one set of these, not one per list.
+ */
+export const listSearchFilterFunctions = (bindings, reads = []) => {
+    const read = [...new Set(reads.map((model) => `read:${model}`))];
+    const payloadInput = {
+        listKey: 'text?',
+        query: 'text?',
+        returnTo: 'text?',
+        facets: 'json?',
+        filters: 'json?',
+        groupBy: 'json?',
+        favoriteId: 'text?',
+        customFilters: 'json?',
+    };
+    const defaultKeyOf = (actor, listKey) => `${actor}:${listKey}`;
+    /** At most one saved search per viewer and list may be the default one. */
+    const clearCurrentDefault = async (tx, actor, listKey, keep) => {
+        const S = tx.table('backend.SavedSearch');
+        const current = await tx.db.one(from(S).where(eq(S.ownerId, actor), eq(S.listKey, listKey), eq(S.defaultKey, defaultKeyOf(actor, listKey))));
+        if (current && current.id !== keep)
+            await tx.db.update('backend.SavedSearch', { id: current.id, ownerId: actor }, { defaultKey: null });
+    };
+    return {
+        applySearchFilter: defineFn({
+            input: payloadInput,
+            output: { href: 'text' },
+            effects: [...read, 'read:backend.SavedSearch'],
+            handler: async (ctx, args) => {
+                const payload = args;
+                return { href: await searchFilterHref(ctx, bindingOf(bindings, payload.listKey), payload) };
+            },
+        }),
+        saveSearchFavorite: defineFn({
+            input: { name: 'text', isDefault: 'bool?', state: 'json' },
+            output: { id: 'id' },
+            effects: [...read, 'read:backend.SavedSearch', 'write:backend.SavedSearch'],
+            handler: async (ctx, args) => {
+                if (!ctx.actor)
+                    throw new Error('authentication required');
+                const name = String(args.name).trim();
+                if (!name)
+                    throw new Error('name is required');
+                const payload = (args.state ?? {});
+                const binding = bindingOf(bindings, payload.listKey);
+                const state = stateFromPayload(ctx, binding, payload);
+                const id = randomUUID();
+                await ctx.tx(async (tx) => {
+                    if (args.isDefault === true)
+                        await clearCurrentDefault(tx, ctx.actor, binding.key);
+                    await tx.db.insert('backend.SavedSearch', {
+                        id,
+                        ownerId: ctx.actor,
+                        listKey: binding.key,
+                        name,
+                        state,
+                        defaultKey: args.isDefault === true ? defaultKeyOf(ctx.actor, binding.key) : null,
+                        active: true,
+                    });
+                });
+                return { id };
+            },
+        }),
+        deleteSearchFavorite: defineFn({
+            input: { id: 'id', listKey: 'text?' },
+            output: { ok: 'bool' },
+            effects: ['read:backend.SavedSearch', 'write:backend.SavedSearch'],
+            handler: async (ctx, args) => {
+                if (!ctx.actor)
+                    throw new Error('authentication required');
+                const binding = bindingOf(bindings, args.listKey);
+                await ctx.db.update('backend.SavedSearch', { id: args.id, ownerId: ctx.actor, listKey: binding.key }, { active: false, defaultKey: null });
+                return { ok: true };
+            },
+        }),
+        setDefaultSearchFavorite: defineFn({
+            input: { id: 'id', listKey: 'text?' },
+            output: { ok: 'bool' },
+            effects: ['read:backend.SavedSearch', 'write:backend.SavedSearch'],
+            handler: async (ctx, args) => {
+                if (!ctx.actor)
+                    throw new Error('authentication required');
+                const binding = bindingOf(bindings, args.listKey);
+                await ctx.tx(async (tx) => {
+                    const S = tx.table('backend.SavedSearch');
+                    const target = await tx.db.one(from(S).where(eq(S.id, args.id), eq(S.ownerId, ctx.actor), eq(S.listKey, binding.key), eq(S.active, true)));
+                    if (!target)
+                        throw new Error('saved search not found');
+                    await clearCurrentDefault(tx, ctx.actor, binding.key, String(args.id));
+                    await tx.db.update('backend.SavedSearch', { id: args.id, ownerId: ctx.actor }, { defaultKey: defaultKeyOf(ctx.actor, binding.key) });
+                });
+                return { ok: true };
+            },
+        }),
+    };
+};
+//# sourceMappingURL=search-filter-state.js.map

package/dist/modules/backend/search-filter-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-filter-state.js","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/backend/search-filter-state.ts"],"names":[],"mappings":"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"}

package/dist/modules/backend/search-filter.d.ts

@@ -0,0 +1,77 @@
+import type { ListSearchShape, ListState, Route, ServeContext, Translator } from '@ketvietlab/ketjs';
+import type { JSXChild } from '@ketvietlab/ketjs-view';
+import type { Frame } from '../../ui/index.ts';
+import type { CustomFilterField, SearchFilterConfig, SearchFilterLabels } from '@ketvietlab/design-system';
+export type { CustomFilterField, SearchFacet, SearchFavorite, SearchFilterCustomRule, SearchFilterConfig, SearchFilterLabels, SearchFilterManager, SearchFilterSize, SearchFilterOption, SearchGroupByOption, } from '@ketvietlab/design-system';
+type Req = Parameters<Route>[1];
+export declare const searchFilterBar: (ctx: ServeContext, url: URL, req: Req, id: string, config: SearchFilterConfig) => Promise<JSXChild>;
+/**
+ * The search-filter bar's own vocabulary, which is the same wherever the bar
+ * appears. A module overrides only what names its own collection: the bar's
+ * label and its search placeholder.
+ */
+export declare const searchFilterLabels: (_: Translator, overrides?: Partial<SearchFilterLabels>) => SearchFilterLabels;
+/** A saved search as the list route reads it back. */
+export type ListFavorite = {
+    id: string;
+    name: string;
+    state: Partial<ListState>;
+    defaultKey?: string | null;
+};
+export type ListSearchFilterOptions = {
+    /** The bar's own name, and the id of the body its apply replaces. */
+    name: string;
+    bodyId: string;
+    spec: ListSearchShape;
+    state: ListState;
+    favorites: readonly ListFavorite[];
+    /** The module's word for a spec field, given the spec's English fallback. */
+    fieldLabel?: (key: string, fallback: string) => string;
+    /** The module's word for a preset, when it differs from the field's. */
+    presetLabel?: (key: string, fallback: string) => string;
+    labels?: Partial<SearchFilterLabels>;
+    fieldChoices?: Record<string, NonNullable<CustomFilterField['choices']>>;
+    favoriteHref?: string;
+    /** Carried into every call the bar makes, and so how `listKey` travels. */
+    applyInput?: Record<string, string | undefined>;
+    functions: {
+        apply: string;
+        saveFavorite?: string;
+        deleteFavorite?: string;
+        setDefaultFavorite?: string;
+    };
+};
+/**
+ * The bar a `ListSearchShape` describes.
+ *
+ * Every list's bar is the same shape — presets as filters, groupable fields as
+ * group-by options, filterable fields as custom-rule fields, the state's own
+ * selections as facets — so the spec is the only thing a screen writes.
+ */
+export declare const listSearchFilterConfig: (_: Translator, options: ListSearchFilterOptions) => SearchFilterConfig;
+/**
+ * The viewer's saved searches for a list, minus any that no longer fit the spec
+ * — a column a favourite grouped by can be removed from the list it belongs to.
+ */
+export declare const loadListFavorites: (ctx: ServeContext, url: URL, req: Req, spec: ListSearchShape, state: ListState) => Promise<ListFavorite[]>;
+/**
+ * The bar itself, on a frame, for a list that narrows its own rows.
+ *
+ * A list whose source pages and filters server-side maps the state onto its
+ * own arguments; a list holding the whole collection uses `rowListSearch`,
+ * which is this plus the filter evaluated over the rows.
+ */
+export declare const listSearchChrome: (ctx: ServeContext, url: URL, req: Req, options: {
+    spec: ListSearchShape;
+    frame: Frame;
+    name: string;
+    bodyId: string;
+    functions: ListSearchFilterOptions['functions'];
+    labels?: Partial<SearchFilterLabels>;
+    fieldLabel?: ListSearchFilterOptions['fieldLabel'];
+    presetLabel?: ListSearchFilterOptions['presetLabel'];
+}) => Promise<{
+    frame: Frame;
+    state: ListState;
+}>;
+//# sourceMappingURL=search-filter.d.ts.map

package/dist/modules/backend/search-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-filter.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketsuite/src/modules/backend/search-filter.ts"],"names":[],"mappings":"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"}

package/dist/modules/backend/search-filter.js

@@ -0,0 +1,259 @@
+import { parseListState, validateListState } from '@ketvietlab/ketjs';
+import { searchFilterRuleLabel } from '@ketvietlab/design-system';
+export const searchFilterBar = (ctx, url, req, id, config) => ctx.joint(url, req, 'backend:search.filter', { id, config });
+/**
+ * The search-filter bar's own vocabulary, which is the same wherever the bar
+ * appears. A module overrides only what names its own collection: the bar's
+ * label and its search placeholder.
+ */
+export const searchFilterLabels = (_, overrides = {}) => ({
+    searchLabel: _('backend.search.label'),
+    searchPlaceholder: _('backend.search.placeholder'),
+    toggleLabel: _('backend.search.toggle'),
+    filters: _('backend.search.filters'),
+    groupBy: _('backend.search.groupBy'),
+    groupByApplied: _('backend.search.groupByApplied'),
+    groupByAdd: _('backend.search.groupByAdd'),
+    groupByClear: _('backend.search.groupByClear'),
+    groupByMoveEarlier: _('backend.search.groupByMoveEarlier'),
+    groupByMoveLater: _('backend.search.groupByMoveLater'),
+    favorites: _('backend.search.favorites'),
+    searchGenericLabel: _('backend.search.genericLabel'),
+    searchFieldPrefix: _('backend.search.fieldPrefix'),
+    searchFieldPreposition: _('backend.search.fieldPreposition'),
+    customFilterField: _('backend.search.customFilterField'),
+    customFilterOperator: _('backend.search.customFilterOperator'),
+    customFilterValue: _('backend.search.customFilterValue'),
+    customFilterAdd: _('backend.search.customFilterAdd'),
+    customGroupByPlaceholder: _('backend.search.customGroupByPlaceholder'),
+    saveSearch: _('backend.search.saveSearch'),
+    favoriteName: _('backend.search.favoriteName'),
+    favoriteDefault: _('backend.search.favoriteDefault'),
+    favoriteSaveAction: _('backend.search.favoriteSaveAction'),
+    favoriteCancel: _('backend.search.favoriteCancel'),
+    favoriteError: _('backend.search.favoriteError'),
+    favoriteRemove: _('backend.search.favoriteRemove'),
+    favoriteSetDefault: _('backend.search.favoriteSetDefault'),
+    noFavorites: _('backend.search.noFavorites'),
+    clear: _('backend.search.clear'),
+    applyError: _('backend.search.applyError'),
+    retry: _('backend.search.retry'),
+    clearFilters: _('backend.search.clearFilters'),
+    close: _('backend.search.close'),
+    valueFrom: _('backend.search.valueFrom'),
+    valueTo: _('backend.search.valueTo'),
+    operatorLabels: Object.fromEntries([
+        'contains',
+        'notContains',
+        'equals',
+        'notEquals',
+        'startsWith',
+        'gt',
+        'gte',
+        'lt',
+        'lte',
+        'between',
+        'anyOf',
+        'isTrue',
+        'isFalse',
+        'isSet',
+        'isNotSet',
+    ].map((operator) => [operator, _(`backend.search.operator.${operator}`)])),
+    ...overrides,
+});
+/**
+ * The bar a `ListSearchShape` describes.
+ *
+ * Every list's bar is the same shape — presets as filters, groupable fields as
+ * group-by options, filterable fields as custom-rule fields, the state's own
+ * selections as facets — so the spec is the only thing a screen writes.
+ */
+export const listSearchFilterConfig = (_, options) => {
+    const { spec, state, favorites } = options;
+    const labels = searchFilterLabels(_, options.labels ?? {});
+    const choicesFor = (key) => options.fieldChoices?.[key] ??
+        spec.filterable
+            ?.find((field) => field.key === key)
+            ?.choices?.map((value) => ({ value, label: _.resolves(value) ? _(value) : value }));
+    const fieldLabel = (key, fallback) => options.fieldLabel?.(key, fallback) ?? (_.resolves(fallback) ? _(fallback) : fallback);
+    const presetLabel = (key) => {
+        const fallback = spec.presets?.find((preset) => preset.key === key)?.label ?? key;
+        return options.presetLabel?.(key, fallback) ?? fieldLabel(key, fallback);
+    };
+    const ruleLabel = (field, operator, value) => {
+        const label = fieldLabel(field, spec.filterable?.find((candidate) => candidate.key === field)?.label ?? field);
+        return searchFilterRuleLabel({
+            fieldLabel: label,
+            operator: operator,
+            value,
+            choices: choicesFor(field),
+            operatorLabels: labels.operatorLabels,
+        });
+    };
+    const customFilters = state.filters.flatMap((filter, index) => filter.kind === 'rule'
+        ? [
+            {
+                id: `rule:${index}`,
+                field: filter.field,
+                operator: filter.operator,
+                value: Array.isArray(filter.value) ? filter.value.join(',') : String(filter.value ?? ''),
+                label: ruleLabel(filter.field, filter.operator, filter.value),
+            },
+        ]
+        : []);
+    const groupLabel = (key) => fieldLabel(key, spec.groupable?.find((candidate) => candidate.key === key)?.label ?? key);
+    const facets = [
+        ...(state.q ? [{ id: 'query:current', type: 'field', label: state.q }] : []),
+        ...state.presets.map((key) => ({
+            id: `preset:${key}`,
+            type: 'filter',
+            label: presetLabel(key),
+        })),
+        ...(state.includeArchived
+            ? [{ id: 'archived', type: 'filter', label: _('backend.chrome.includeArchived') }]
+            : []),
+        ...customFilters.map(({ id, label }) => ({ id, type: 'filter', label })),
+        ...state.groupBy.map((group) => ({
+            id: `${group.key}${group.interval ? `:${group.interval}` : ''}`,
+            type: 'groupBy',
+            label: `${groupLabel(group.key)}${group.interval ? ` / ${_(`backend.search.interval.${group.interval}`)}` : ''}`,
+        })),
+        ...(state.favoriteId
+            ? [
+                {
+                    id: state.favoriteId,
+                    type: 'favorite',
+                    label: favorites.find((favorite) => favorite.id === state.favoriteId)?.name ?? state.favoriteId,
+                },
+            ]
+            : []),
+    ];
+    return {
+        name: options.name,
+        favoriteHref: options.favoriteHref,
+        size: 'compact',
+        ...(spec.limits?.maxGroups ? { maxGroupBy: spec.limits.maxGroups } : {}),
+        facets,
+        filters: [
+            ...(spec.presets ?? []).map((preset) => ({
+                id: `preset:${preset.key}`,
+                label: presetLabel(preset.key),
+                active: state.presets.includes(preset.key),
+                group: preset.group,
+            })),
+            // Archiving is a state every list shares, so the bar offers it wherever
+            // the spec can filter on the flag that records it.
+            ...(spec.filterable?.some((field) => field.key === 'active')
+                ? [
+                    {
+                        id: 'archived',
+                        label: _('backend.chrome.includeArchived'),
+                        active: state.includeArchived,
+                        group: 'state',
+                    },
+                ]
+                : []),
+        ],
+        groupBy: (spec.groupable ?? []).map((field) => {
+            const label = fieldLabel(field.key, field.label);
+            return field.intervals?.length
+                ? {
+                    id: field.key,
+                    label,
+                    active: false,
+                    options: field.intervals.map((interval) => ({
+                        id: `${field.key}:${interval}`,
+                        label: `${label} / ${_(`backend.search.interval.${interval}`)}`,
+                        active: state.groupBy.some((group) => group.key === field.key && group.interval === interval),
+                    })),
+                }
+                : {
+                    id: field.key,
+                    label,
+                    active: state.groupBy.some((group) => group.key === field.key),
+                };
+        }),
+        favorites: favorites.map((favorite) => ({
+            id: favorite.id,
+            label: favorite.name,
+            isDefault: Boolean(favorite.defaultKey),
+            active: state.favoriteId === favorite.id,
+        })),
+        customFilterFields: (spec.filterable ?? []).map((field) => ({
+            value: field.key,
+            label: fieldLabel(field.key, field.label),
+            type: field.type,
+            choices: choicesFor(field.key),
+        })),
+        customFilters,
+        labels,
+        manager: {
+            applyFunction: options.functions.apply,
+            bodyId: options.bodyId,
+            applyInput: options.applyInput,
+            ...(options.functions.saveFavorite ? { saveFavoriteFunction: options.functions.saveFavorite } : {}),
+            ...(options.functions.deleteFavorite
+                ? { deleteFavoriteFunction: options.functions.deleteFavorite }
+                : {}),
+            ...(options.functions.setDefaultFavorite
+                ? { setDefaultFavoriteFunction: options.functions.setDefaultFavorite }
+                : {}),
+        },
+    };
+};
+/**
+ * The viewer's saved searches for a list, minus any that no longer fit the spec
+ * — a column a favourite grouped by can be removed from the list it belongs to.
+ */
+export const loadListFavorites = async (ctx, url, req, spec, state) => {
+    const loaded = (await ctx.callUnchecked('backend.listSavedSearches', { listKey: spec.key }, url, req));
+    return loaded.filter((favorite) => {
+        try {
+            validateListState(spec, {
+                ...state,
+                ...favorite.state,
+                presets: [...(favorite.state.presets ?? [])],
+                filters: [...(favorite.state.filters ?? [])],
+                groupBy: [...(favorite.state.groupBy ?? [])],
+                sort: [...(favorite.state.sort ?? spec.defaultSort ?? [])],
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+};
+/**
+ * The bar itself, on a frame, for a list that narrows its own rows.
+ *
+ * A list whose source pages and filters server-side maps the state onto its
+ * own arguments; a list holding the whole collection uses `rowListSearch`,
+ * which is this plus the filter evaluated over the rows.
+ */
+export const listSearchChrome = async (ctx, url, req, options) => {
+    const _ = ctx.translate(ctx.localeOf(url, req));
+    const { state } = parseListState(options.spec, url);
+    const favorites = await loadListFavorites(ctx, url, req, options.spec, state);
+    const bar = await searchFilterBar(ctx, url, req, options.name, listSearchFilterConfig(_, {
+        name: options.name,
+        bodyId: options.bodyId,
+        spec: options.spec,
+        state,
+        favorites,
+        labels: options.labels,
+        ...(options.fieldLabel ? { fieldLabel: options.fieldLabel } : {}),
+        ...(options.presetLabel ? { presetLabel: options.presetLabel } : {}),
+        applyInput: { listKey: options.spec.key, returnTo: `${url.pathname}${url.search}` },
+        functions: options.functions,
+    }));
+    return {
+        frame: {
+            ...options.frame,
+            collectionUrl: `${url.pathname}${url.search}`,
+            chrome: { ...options.frame.chrome, search: null, searchContent: bar },
+        },
+        state,
+    };
+};
+//# sourceMappingURL=search-filter.js.map