@protobase/schema 0.22.4 → 0.22.6

package/dist/app-address.d.ts

@@ -5,6 +5,8 @@ import { AppAddress } from "./model.js";
  * changes in this module alone.
  */
 export declare const addressWords: {
+  /** A named list of the resource (`.namedList(...)`), in place of its own list. */
+  readonly list: "list";
   /** A list's filter (AIP-160), as the list API takes it. An empty `filter=` means no filter, in place of the view's default. */
   readonly filter: "filter";
   /** A list's order (AIP-132). */

package/dist/app-address.js

@@ -5,6 +5,8 @@ import { encodeKey } from "./keys.js";
 * changes in this module alone.
 */
 const addressWords = {
+	/** A named list of the resource (`.namedList(...)`), in place of its own list. */
+	list: "list",
 	/** A list's filter (AIP-160), as the list API takes it. An empty `filter=` means no filter, in place of the view's default. */
 	filter: "filter",
 	/** A list's order (AIP-132). */
@@ -27,6 +29,7 @@ const addressWords = {
 	open: "open"
 };
 const listWords = [
+	"list",
 	"display",
 	"filter",
 	"orderBy",
@@ -136,6 +139,7 @@ const readAppPath = (pathAndQuery, pages) => {
 		};
 	}
 	const params = url.searchParams;
+	const list = params.get(addressWords.list) || void 0;
 	const display = params.get(addressWords.display) || void 0;
 	const filter = params.get(addressWords.filter) ?? void 0;
 	const orderBy = params.get(addressWords.orderBy) || void 0;
@@ -146,6 +150,7 @@ const readAppPath = (pathAndQuery, pages) => {
 	return {
 		kind: "list",
 		resource: first,
+		...list && { list },
 		...display && { display },
 		...filter !== void 0 && { filter },
 		...orderBy && { orderBy },

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { FileOptions, FileProcessor, FileProcessorInput, ImageFormat, ImageVariant, ImageVariantOptions, imageFormats } from "./files/file-options.js";
-import { ActionInputKind, ActionInputModel, ActionModel, ActionRun, AppAddress, BadgeShape, BottomBarItemModel, BottomBarModel, CalendarView, CardFavoriteModel, CardPhotosModel, ChartGranularity, ChartModel, ChartRange, CheckedFilter, CommentsSectionModel, CompareOp, CreateModel, CustomSectionModel, DatePreset, DurationLiteral, DurationUnit, EventModel, EventOperation, ExportModel, FieldFormat, FieldModel, FieldPath, FieldType, FieldViewModel, FieldWidgetModel, FileFieldModel, FilterError, FilterErrorCode, FilterExpr, FilterLayout, FilterOf, FilterValue, FilterWidgetModel, FormModel, GalleryModel, GroupChartModel, GroupItemModel, GroupModel, HelpWhen, HistorySectionModel, JsonValue, KeyValue, LayoutItemModel, ListDisplayModel, ListModel, ListQuery, Literal, MapSectionModel, MapView, NavModel, NavRecentModel, NowValue, OrderByItem, PeriodChartModel, RecordMode, RecordWhen, RelatedColumnModel, RelatedModel, ResourceModel, SaveFeedback, SaveSearchModel, SearchMatch, SearchResultModel, SearchesOfModel, SectionModel, SectionPresentation, ShowWhen, SignInPromptModel, SignInViewModel, SortSpec, Span, StatusTone, UserMenuItemModel, UserMenuModel, ViewModel } from "./model.js";
+import { ActionInputKind, ActionInputModel, ActionModel, ActionRun, AppAddress, BadgeShape, BottomBarItemModel, BottomBarModel, CalendarView, CardFavoriteModel, CardPhotosModel, ChartGranularity, ChartModel, ChartRange, CheckedFilter, CommentsSectionModel, CompareOp, CreateModel, CustomSectionModel, DatePreset, DurationLiteral, DurationUnit, EventModel, EventOperation, ExportModel, FieldFormat, FieldModel, FieldPath, FieldType, FieldViewModel, FieldWidgetModel, FileFieldModel, FilterError, FilterErrorCode, FilterExpr, FilterLayout, FilterOf, FilterValue, FilterWidgetModel, FormModel, GalleryModel, GroupChartModel, GroupItemModel, GroupModel, HelpWhen, HistorySectionModel, JsonValue, KeyValue, LayoutItemModel, ListDisplayModel, ListModel, ListQuery, Literal, MapSectionModel, MapView, NamedListModel, NavModel, NavRecentModel, NowValue, OrderByItem, PeriodChartModel, RecordMode, RecordWhen, RelatedColumnModel, RelatedModel, ResourceModel, SaveFeedback, SaveSearchModel, SearchMatch, SearchResultModel, SearchesOfModel, SectionModel, SectionPresentation, ShowWhen, SignInPromptModel, SignInViewModel, SortSpec, Span, StatusTone, UserMenuItemModel, UserMenuModel, ViewModel } from "./model.js";
 import { AccessAction, AccessContext, AccessFn, AccessResult, AccessUser, FieldAccess, FieldRule } from "./access/types.js";
 import { AnyField, Constraint, Field, FieldMeta, FieldTypeDef } from "./field.js";
 import { RelationField } from "./relation-field.js";
@@ -42,4 +42,4 @@ import { AccessSource, ResolveOptions, ResolvedAccess, RowFilterOperation, acces
 import { restrictModel } from "./access/restrict.js";
 import "./access/index.js";
 import { AssistantAction, AssistantActionRequest, AssistantCardPart, AssistantDiff, AssistantEvent, AssistantMessage, AssistantMessageRequest, AssistantPart, AssistantState, AssistantStep, AssistantStepState, AssistantTablePart, AssistantTextPart, AssistantTone, AssistantWidgetPart } from "./assistant/protocol.js";
-export { type Access, type AccessAction, type AccessContext, type AccessFn, type AccessResult, type AccessSource, type AccessUser, type ActionInputKind, type ActionInputModel, type ActionModel, type ActionRun, type AnyField, type AppAddress, type AssistantAction, type AssistantActionRequest, type AssistantCardPart, type AssistantDiff, type AssistantEvent, type AssistantMessage, type AssistantMessageRequest, type AssistantPart, type AssistantState, type AssistantStep, type AssistantStepState, type AssistantTablePart, type AssistantTextPart, type AssistantTone, type AssistantWidgetPart, type BadgeShape, type BottomBarItemModel, type BottomBarModel, type BottomBarNames, type BottomBarSource, type CalendarView, type Capability, type CapabilityAction, type CapabilityLimit, type CapabilityScope, type CardFavoriteModel, type CardPhotosModel, type ChartGranularity, type ChartInput, type ChartModel, type ChartRange, type CheckResult, type CheckedFilter, type CommentsSectionModel, type CompareOp, type ComponentRef, type Constraint, type CreateModel, type CreatedOptions, type CustomSectionModel, type DatePreset, type DeletedOptions, type DurationLiteral, type DurationUnit, type EvaluateOptions, type EventActor, type EventContext, type EventHelpers, type EventMatch, type EventModel, type EventOperation, type EventSpec, type ExportModel, type Field, type FieldAccess, type FieldFormat, type FieldMeta, type FieldModel, type FieldPath, type FieldRefValue, type FieldRefs, type FieldRule, type FieldType, type FieldTypeDef, type FieldView, type FieldViewModel, type FieldViews, type FieldWidgetModel, type FieldsInput, type FileField, type FileFieldModel, type FileOptions, type FileProcessor, type FileProcessorInput, type FilterError, type FilterErrorCode, type FilterExpr, type FilterLayout, type FilterLimits, type FilterOf, type FilterParse, type FilterValue, type FilterWidgetModel, type FormAddress, type FormInput, type FormModel, type GalleryModel, type Grant, type GroupChartInput, type GroupChartModel, type GroupItemModel, type GroupModel, type HeldCapability, type HelpWhen, type HistorySectionModel, type ImageFormat, type ImageVariant, type ImageVariantOptions, type InferRecord, type Issue, type JsonValue, type KeyOf, type KeyRefs, type KeyType, type KeyValue, type LayoutItemModel, type ListColumn, type ListDisplayModel, type ListModel, type ListQuery, type Literal, type MapSectionModel, type MapView, type NavModel, type NavRecentModel, type NowValue, type OrderByCheck, type OrderByItem, type OrderByParse, type PeriodChartInput, type PeriodChartModel, type RecordKey, type RecordMode, type RecordOf, type RecordWhen, type Ref, type Refs, type RelatedColumnModel, type RelatedModel, type RelationField, type ResolveOptions, type ResolvedAccess, type ResourceBuilder, type ResourceModel, type RoleEntry, type RoleLimit, type Roles, type RolesOptions, type RowFilterOperation, type Rule, type SaveFeedback, type SaveSearchModel, type SearchMatch, type SearchRef, type SearchRefs, type SearchResultModel, type SearchesOfModel, type SectionModel, type SectionPresentation, type ShowWhen, type SignInAddress, type SignInPromptModel, type SignInStep, type SignInViewModel, type SortSpec, type Span, type StatusTone, type UndeletedOptions, type UpdatedOptions, type UserMenuItemModel, type UserMenuModel, type UserMenuSource, type Validator, type ViewBuilder, type ViewModel, type ViewProps, accessWarnings, addressWords, anonymousRole, appPath, bottomBar, bottomBarErrors, checkFilter, checkOrderBy, checkRecord, createWhere, defineRoles, enumLabel, evaluateFilter, f, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, isRecordCondition, keyTypes, layout as l, maxBottomBarItems, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, readFormAddress, readSignInAddress, resolveAccess, resource, restrictModel, rule, signInParams, signInPath, signInRoute, signInSteps, userMenu, view, where };
+export { type Access, type AccessAction, type AccessContext, type AccessFn, type AccessResult, type AccessSource, type AccessUser, type ActionInputKind, type ActionInputModel, type ActionModel, type ActionRun, type AnyField, type AppAddress, type AssistantAction, type AssistantActionRequest, type AssistantCardPart, type AssistantDiff, type AssistantEvent, type AssistantMessage, type AssistantMessageRequest, type AssistantPart, type AssistantState, type AssistantStep, type AssistantStepState, type AssistantTablePart, type AssistantTextPart, type AssistantTone, type AssistantWidgetPart, type BadgeShape, type BottomBarItemModel, type BottomBarModel, type BottomBarNames, type BottomBarSource, type CalendarView, type Capability, type CapabilityAction, type CapabilityLimit, type CapabilityScope, type CardFavoriteModel, type CardPhotosModel, type ChartGranularity, type ChartInput, type ChartModel, type ChartRange, type CheckResult, type CheckedFilter, type CommentsSectionModel, type CompareOp, type ComponentRef, type Constraint, type CreateModel, type CreatedOptions, type CustomSectionModel, type DatePreset, type DeletedOptions, type DurationLiteral, type DurationUnit, type EvaluateOptions, type EventActor, type EventContext, type EventHelpers, type EventMatch, type EventModel, type EventOperation, type EventSpec, type ExportModel, type Field, type FieldAccess, type FieldFormat, type FieldMeta, type FieldModel, type FieldPath, type FieldRefValue, type FieldRefs, type FieldRule, type FieldType, type FieldTypeDef, type FieldView, type FieldViewModel, type FieldViews, type FieldWidgetModel, type FieldsInput, type FileField, type FileFieldModel, type FileOptions, type FileProcessor, type FileProcessorInput, type FilterError, type FilterErrorCode, type FilterExpr, type FilterLayout, type FilterLimits, type FilterOf, type FilterParse, type FilterValue, type FilterWidgetModel, type FormAddress, type FormInput, type FormModel, type GalleryModel, type Grant, type GroupChartInput, type GroupChartModel, type GroupItemModel, type GroupModel, type HeldCapability, type HelpWhen, type HistorySectionModel, type ImageFormat, type ImageVariant, type ImageVariantOptions, type InferRecord, type Issue, type JsonValue, type KeyOf, type KeyRefs, type KeyType, type KeyValue, type LayoutItemModel, type ListColumn, type ListDisplayModel, type ListModel, type ListQuery, type Literal, type MapSectionModel, type MapView, type NamedListModel, type NavModel, type NavRecentModel, type NowValue, type OrderByCheck, type OrderByItem, type OrderByParse, type PeriodChartInput, type PeriodChartModel, type RecordKey, type RecordMode, type RecordOf, type RecordWhen, type Ref, type Refs, type RelatedColumnModel, type RelatedModel, type RelationField, type ResolveOptions, type ResolvedAccess, type ResourceBuilder, type ResourceModel, type RoleEntry, type RoleLimit, type Roles, type RolesOptions, type RowFilterOperation, type Rule, type SaveFeedback, type SaveSearchModel, type SearchMatch, type SearchRef, type SearchRefs, type SearchResultModel, type SearchesOfModel, type SectionModel, type SectionPresentation, type ShowWhen, type SignInAddress, type SignInPromptModel, type SignInStep, type SignInViewModel, type SortSpec, type Span, type StatusTone, type UndeletedOptions, type UpdatedOptions, type UserMenuItemModel, type UserMenuModel, type UserMenuSource, type Validator, type ViewBuilder, type ViewModel, type ViewProps, accessWarnings, addressWords, anonymousRole, appPath, bottomBar, bottomBarErrors, checkFilter, checkOrderBy, checkRecord, createWhere, defineRoles, enumLabel, evaluateFilter, f, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, isRecordCondition, keyTypes, layout as l, maxBottomBarItems, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, readFormAddress, readSignInAddress, resolveAccess, resource, restrictModel, rule, signInParams, signInPath, signInRoute, signInSteps, userMenu, view, where };

package/dist/internal.d.ts

@@ -19,4 +19,5 @@ import { AddressCheck, addressErrors } from "./address-errors.js";
 import { applyAssistantEvent, emptyAssistantState } from "./assistant/apply-event.js";
 import { readEventStream } from "./assistant/event-stream.js";
 import { layoutItems } from "./layout-items.js";
-export { type AddressCheck, type PluginHost, type PluginRequirement, type PropShapes, type RefShape, type SearchTerm, actionInputErrors, addressErrors, addressPlaceholders, appHrefError, applyAssistantEvent, boardErrors, bottomBarFor, calendarErrors, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, decodeKey, defaultRecentLimit, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, hrefField, hrefPlaceholders, inRange, isFieldRef, isGroupChart, layoutItems, leavesApp, linkActionError, markFieldRefs, matchedSearchField, matchesSearch, navRecentErrors, parseSize, pluginProblem, promptError, promptFields, pruneByShape, readEventStream, redactSecrets, renderPrompt, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, webhookResources };
+import { viewOfList } from "./named-list.js";
+export { type AddressCheck, type PluginHost, type PluginRequirement, type PropShapes, type RefShape, type SearchTerm, actionInputErrors, addressErrors, addressPlaceholders, appHrefError, applyAssistantEvent, boardErrors, bottomBarFor, calendarErrors, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, decodeKey, defaultRecentLimit, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, hrefField, hrefPlaceholders, inRange, isFieldRef, isGroupChart, layoutItems, leavesApp, linkActionError, markFieldRefs, matchedSearchField, matchesSearch, navRecentErrors, parseSize, pluginProblem, promptError, promptFields, pruneByShape, readEventStream, redactSecrets, renderPrompt, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources };

package/dist/internal.js

@@ -3,6 +3,7 @@ import { promptError, promptFields, renderPrompt } from "./ai-prompt.js";
 import { checkedAccept, checkedProvider, parseSize } from "./files/file-options.js";
 import { matchedSearchField, matchesSearch, searchTerms, termMatches } from "./search-match.js";
 import { checkEventFilter } from "./events/event-models.js";
+import { viewOfList } from "./named-list.js";
 import { defaultRecentLimit, navRecentErrors, statusTones } from "./nav-recent.js";
 import { actionInputErrors, shownInputs } from "./action-inputs.js";
 import { updateSetErrors, updateValues } from "./update-set.js";
@@ -19,4 +20,4 @@ import { addressErrors } from "./address-errors.js";
 import { applyAssistantEvent, emptyAssistantState } from "./assistant/apply-event.js";
 import { readEventStream } from "./assistant/event-stream.js";
 import { layoutItems } from "./layout-items.js";
-export { actionInputErrors, addressErrors, addressPlaceholders, appHrefError, applyAssistantEvent, boardErrors, bottomBarFor, calendarErrors, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, decodeKey, defaultRecentLimit, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, hrefField, hrefPlaceholders, inRange, isFieldRef, isGroupChart, layoutItems, leavesApp, linkActionError, markFieldRefs, matchedSearchField, matchesSearch, navRecentErrors, parseSize, pluginProblem, promptError, promptFields, pruneByShape, readEventStream, redactSecrets, renderPrompt, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, webhookResources };
+export { actionInputErrors, addressErrors, addressPlaceholders, appHrefError, applyAssistantEvent, boardErrors, bottomBarFor, calendarErrors, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, decodeKey, defaultRecentLimit, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, hrefField, hrefPlaceholders, inRange, isFieldRef, isGroupChart, layoutItems, leavesApp, linkActionError, markFieldRefs, matchedSearchField, matchesSearch, navRecentErrors, parseSize, pluginProblem, promptError, promptFields, pruneByShape, readEventStream, redactSecrets, renderPrompt, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources };

package/dist/model.d.ts

@@ -189,6 +189,8 @@ export type AppAddress = {
   kind: 'list';
   /** The resource listed. */
   resource: string;
+  /** A named list of the resource's view (`.namedList(...)`); its own list when omitted. */
+  list?: string;
   /** An AIP-160 filter on the list. */
   filter?: string;
   /** An AIP-132 order of the list. */
@@ -568,7 +570,7 @@ export type DatePreset = 'today' | 'yesterday' | '24h' | '7d' | '30d' | '90d' |
  * A filter widget above a list (`.filters((r, w) => ...)`), on a filterable field; see
  * [Filters and the chart](website/src/content/docs/reference/ui-config.mdx#filters-and-the-chart).
  */
-export type FilterWidgetModel = {
+export type FilterWidgetModel = ({
   /** A slider between the lowest and highest value. */
   kind: 'range';
   /** The field it filters. */
@@ -601,6 +603,9 @@ export type FilterWidgetModel = {
   fields: string[];
   /** The menu's label. */
   label: string;
+}) & {
+  /** Shown behind the bar's "More filters" menu until it is picked there or set. */
+  secondary?: boolean;
 };
 /**
  * Records of another resource on the record page: those whose `field` holds this record's key or, with `through`,
@@ -1086,6 +1091,33 @@ export type ViewModel = {
   create?: CreateModel;
   /** Public forms that create its records for people without an account, each at `/-/forms/<name>`. */
   forms?: FormModel[];
+  /** Other lists of the resource, each with its own sidebar entry and address. */
+  lists?: NamedListModel[];
+};
+/**
+ * Another list of a view's resource (`.namedList(...)`), with its own sidebar entry at `/<resource>?list=<name>`: its
+ * own names, list, filter widgets and chart in place of the view's. Its records open at the resource's own address.
+ */
+export type NamedListModel = {
+  /** Its address, `?list=<name>`: lowercase letters, digits, `-` and `_`, unique in its view. */
+  name: string;
+  /** What its records are called; `plural` is its sidebar entry and title. */
+  names: {
+    /** One record's name, as in "New repair". */
+    singular: string;
+    /** The records' name, as its sidebar entry and title. */
+    plural: string;
+  };
+  /** Where it sits in the sidebar; without `recent`. */
+  nav?: NavModel;
+  /** A line under its title. */
+  help?: string;
+  /** Its list; the resource's first six fields as columns when omitted. */
+  list?: ListModel;
+  /** Its filter widgets, in order. */
+  filters: FilterWidgetModel[];
+  /** Its chart. */
+  chart?: ChartModel;
 };
 /**
  * A public form (`.form(...)`): anyone, signed in or not, opens it at `/-/forms/<name>` and creates a record with its

package/dist/named-list.d.ts

@@ -0,0 +1,8 @@
+import { ViewModel } from "./model.js";
+//#region src/named-list.d.ts
+/**
+ * The view a list page shows: `view` itself, or, with `list`, the view with that named list's names, nav, help, list,
+ * filters and chart in place of its own, and no named lists; none when the view has no list by that name.
+ */
+export declare const viewOfList: (view: ViewModel | undefined, list: string | undefined) => ViewModel | undefined;
+//#endregion

package/dist/named-list.js

@@ -0,0 +1,18 @@
+//#region src/named-list.ts
+/**
+* The view a list page shows: `view` itself, or, with `list`, the view with that named list's names, nav, help, list,
+* filters and chart in place of its own, and no named lists; none when the view has no list by that name.
+*/
+const viewOfList = (view, list) => {
+	if (list === void 0) return view;
+	const named = view?.lists?.find((entry) => entry.name === list);
+	if (!view || !named) return void 0;
+	const { list: _list, chart: _chart, help: _help, nav: _nav, lists: _lists, names: _names, ...rest } = view;
+	const { name: _name, ...parts } = named;
+	return {
+		...rest,
+		...parts
+	};
+};
+//#endregion
+export { viewOfList };

package/dist/view-widgets.d.ts

@@ -1,10 +1,12 @@
 import { DatePreset, FilterWidgetModel } from "./model.js";
 import { Ref } from "./refs.js";
 //#region src/view-widgets.d.ts
+/** Every widget also takes `secondary: true`, which puts it behind the bar's "More filters" menu until it is picked there or set. */
 export declare const widgets: {
   /** A slider between the field's lowest and highest value; `histogram` draws the values' histogram behind it. */
   range: (ref: Ref, o?: {
     histogram?: boolean;
+    secondary?: boolean;
   }) => FilterWidgetModel;
   /**
    * A menu of the field's values with counts; `search` adds a search box for long lists. On a relation it searches the
@@ -12,19 +14,24 @@ export declare const widgets: {
    */
   facets: (ref: Ref, o?: {
     search?: boolean;
+    secondary?: boolean;
   }) => FilterWidgetModel;
   /** A date range with buttons for the `presets`, such as `today` and `30d`. */
   dateRange: (ref: Ref, o?: {
     presets?: DatePreset[];
+    secondary?: boolean;
   }) => FilterWidgetModel;
   /** A switch for a boolean field. */
-  toggle: (ref: Ref) => FilterWidgetModel;
+  toggle: (ref: Ref, o?: {
+    secondary?: boolean;
+  }) => FilterWidgetModel;
   /**
    * A menu of boolean fields under one `label`, such as "for sale" and "for rent": a record shows when any chosen field
    * is true, so one that is both shows under each.
    */
   flags: (refs: Ref<string, boolean | null>[], o: {
     label: string;
+    secondary?: boolean;
   }) => FilterWidgetModel;
 };
 //#endregion

package/dist/view-widgets.js

@@ -1,10 +1,12 @@
 //#region src/view-widgets.ts
+/** Every widget also takes `secondary: true`, which puts it behind the bar's "More filters" menu until it is picked there or set. */
 const widgets = {
 	/** A slider between the field's lowest and highest value; `histogram` draws the values' histogram behind it. */
 	range: (ref, o = {}) => ({
 		kind: "range",
 		field: ref.name,
-		histogram: o.histogram ?? false
+		histogram: o.histogram ?? false,
+		...o.secondary && { secondary: true }
 	}),
 	/**
 	* A menu of the field's values with counts; `search` adds a search box for long lists. On a relation it searches the
@@ -13,18 +15,21 @@ const widgets = {
 	facets: (ref, o = {}) => ({
 		kind: "facets",
 		field: ref.name,
-		search: o.search ?? false
+		search: o.search ?? false,
+		...o.secondary && { secondary: true }
 	}),
 	/** A date range with buttons for the `presets`, such as `today` and `30d`. */
 	dateRange: (ref, o = {}) => ({
 		kind: "dateRange",
 		field: ref.name,
-		presets: o.presets ?? []
+		presets: o.presets ?? [],
+		...o.secondary && { secondary: true }
 	}),
 	/** A switch for a boolean field. */
-	toggle: (ref) => ({
+	toggle: (ref, o = {}) => ({
 		kind: "toggle",
-		field: ref.name
+		field: ref.name,
+		...o.secondary && { secondary: true }
 	}),
 	/**
 	* A menu of boolean fields under one `label`, such as "for sale" and "for rent": a record shows when any chosen field
@@ -33,7 +38,8 @@ const widgets = {
 	flags: (refs, o) => ({
 		kind: "flags",
 		fields: refs.map((ref) => ref.name),
-		label: o.label
+		label: o.label,
+		...o.secondary && { secondary: true }
 	})
 };
 //#endregion

package/dist/view.d.ts

@@ -88,6 +88,14 @@ export declare class ViewBuilder<R extends {
    * `w.toggle` and `w.flags`. Together they write the list's `?filter=`.
    */
   filters(build: (r: FieldRefs<FieldsOf<R>>, w: typeof widgets) => FilterWidgetModel[]): ViewBuilder<R>;
+  /**
+   * Another list of this resource, with its own sidebar entry and address (`/<resource>?list=<name>`). `build` gets a
+   * fresh view and sets its `names` (the sidebar entry, required), `nav`, `help`, `list`, `filters` and `chart`, none of
+   * which come from the view's own list. Its records open at the resource's own address. Throws on a name that does not
+   * fit an address or repeats, on anything else set, on `nav.recent`, and in `toModel` when the view has `listOf` or
+   * `searchesOf`. See [More than one list](website/src/content/docs/reference/ui-config.mdx#more-than-one-list).
+   */
+  namedList(name: string, build: (v: ViewBuilder<R>) => ViewBuilder<R>): ViewBuilder<R>;
   /**
    * The record page, as items of `l` in order: sections, sidebar cards, related records, maps and custom components.
    * Without it the page shows one section with every field.

package/dist/view.js

@@ -1,5 +1,7 @@
 import { createRefs, ref } from "./refs.js";
+import { formNamePattern } from "./form-address.js";
 import { isMenuHref } from "./menu-href.js";
+import { viewOfList } from "./named-list.js";
 import { navRecentErrors } from "./nav-recent.js";
 import { actions } from "./view-actions.js";
 import { chartModel } from "./view-chart.js";
@@ -9,6 +11,15 @@ import { boardErrors, calendarErrors, displayErrors, displayFields, displays } f
 import { FieldView } from "./view-field.js";
 import { widgets } from "./view-widgets.js";
 //#region src/view.ts
+const namedListParts = /* @__PURE__ */ new Set([
+	"resource",
+	"names",
+	"nav",
+	"help",
+	"list",
+	"filters",
+	"chart"
+]);
 const searchesOfErrors = (searches, resource) => {
 	const typed = (role, name, type) => name === void 0 || resource.fields[name]?.type === type ? [] : [`${role} "${name}" is not a ${type} field of the resource`];
 	return [
@@ -111,6 +122,34 @@ var ViewBuilder = class ViewBuilder {
 		return this.next({ filters: build(this.refs(), widgets) });
 	}
 	/**
+	* Another list of this resource, with its own sidebar entry and address (`/<resource>?list=<name>`). `build` gets a
+	* fresh view and sets its `names` (the sidebar entry, required), `nav`, `help`, `list`, `filters` and `chart`, none of
+	* which come from the view's own list. Its records open at the resource's own address. Throws on a name that does not
+	* fit an address or repeats, on anything else set, on `nav.recent`, and in `toModel` when the view has `listOf` or
+	* `searchesOf`. See [More than one list](website/src/content/docs/reference/ui-config.mdx#more-than-one-list).
+	*/
+	namedList(name, build) {
+		const where = `View "${this.state.resource}": named list "${name}"`;
+		if (!formNamePattern.test(name)) throw new Error(`${where}: its name goes in its address, so it takes lowercase letters, digits, - and _`);
+		if (this.state.lists?.some((entry) => entry.name === name)) throw new Error(`${where} is declared twice`);
+		const start = view(this.state.resource);
+		const { state } = build(start);
+		const extra = Object.keys(state).filter((key) => !namedListParts.has(key) && state[key] !== start.state[key]);
+		if (extra.length > 0) throw new Error(`${where} sets ${extra.join(", ")}; a named list takes names, nav, help, list, filters and chart`);
+		if (!state.names) throw new Error(`${where} needs .names(...), its sidebar entry`);
+		if (state.nav?.recent) throw new Error(`${where}: recent records are the view's own, not a named list's`);
+		const named = {
+			name,
+			names: state.names,
+			filters: state.filters,
+			...state.nav && { nav: state.nav },
+			...state.help !== void 0 && { help: state.help },
+			...state.list && { list: state.list },
+			...state.chart && { chart: state.chart }
+		};
+		return this.next({ lists: [...this.state.lists ?? [], named] });
+	}
+	/**
 	* The record page, as items of `l` in order: sections, sidebar cards, related records, maps and custom components.
 	* Without it the page shows one section with every field.
 	*/
@@ -281,6 +320,8 @@ var ViewBuilder = class ViewBuilder {
 		}
 		const recentErrors = resource && nav?.recent ? navRecentErrors(nav.recent, resource) : [];
 		if (recentErrors.length > 0) throw new Error(`View "${this.state.resource}": nav.recent ${recentErrors.join("; ")}`);
+		if (this.state.lists?.length && (listOf !== void 0 || this.state.searchesOf)) throw new Error(`View "${this.state.resource}": named lists cannot go with listOf or searchesOf, which replace the list page`);
+		for (const named of this.state.lists ?? []) new ViewBuilder(viewOfList(this.state, named.name)).toModel(resource);
 		return structuredClone(this.state);
 	}
 	refs() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protobase/schema",
-  "version": "0.22.4",
+  "version": "0.22.6",
   "description": "Resource, field, view and access definitions for Protobase configs.",
   "license": "Apache-2.0",
   "repository": {