@protobase/schema 0.21.10 → 0.21.12

package/dist/app-address.d.ts

@@ -23,6 +23,8 @@ export declare const addressWords: {
   readonly create: "new";
   /** A record's form, `edit=true`, on a view whose record page opens as a read view or locked. */
   readonly edit: "edit";
+  /** A record page's open collapsed group, by title, once per group. */
+  readonly open: "open";
 };
 /** The path of `address` below `basePath` (such as `/admin`), every name and key encoded the one way the app reads them. */
 export declare const appPath: (address: AppAddress, basePath?: string) => string;

package/dist/app-address.js

@@ -22,7 +22,9 @@ const addressWords = {
 	/** The second path segment that opens a resource's create form instead of a record. */
 	create: "new",
 	/** A record's form, `edit=true`, on a view whose record page opens as a read view or locked. */
-	edit: "edit"
+	edit: "edit",
+	/** A record page's open collapsed group, by title, once per group. */
+	open: "open"
 };
 const listWords = [
 	"display",
@@ -71,12 +73,19 @@ const listQuery = (address) => {
 	const text = query.toString();
 	return text ? `?${text}` : "";
 };
+const recordQuery = (address) => {
+	const query = new URLSearchParams();
+	if (address.edit) query.set(addressWords.edit, "true");
+	for (const title of address.open ?? []) query.append(addressWords.open, title);
+	const text = query.toString();
+	return text ? `?${text}` : "";
+};
 /** The path of `address` below `basePath` (such as `/admin`), every name and key encoded the one way the app reads them. */
 const appPath = (address, basePath = "") => {
 	switch (address.kind) {
 		case "page": return `${basePath}/${encodeURIComponent(address.page)}`;
 		case "create": return `${basePath}/${encodeURIComponent(address.resource)}/${addressWords.create}${valuesQuery(address.values)}`;
-		case "record": return `${basePath}/${encodeURIComponent(address.resource)}/${encodeURIComponent(encodeKey(address.key))}${address.edit ? `?${addressWords.edit}=true` : ""}`;
+		case "record": return `${basePath}/${encodeURIComponent(address.resource)}/${encodeURIComponent(encodeKey(address.key))}${recordQuery(address)}`;
 		case "list": return `${basePath}/${encodeURIComponent(address.resource)}${listQuery(address)}`;
 	}
 };
@@ -115,12 +124,16 @@ const readAppPath = (pathAndQuery, pages) => {
 			...Object.keys(values).length > 0 && { values }
 		};
 	}
-	if (second !== void 0) return {
-		kind: "record",
-		resource: first,
-		key: second,
-		...url.searchParams.get(addressWords.edit) === "true" && { edit: true }
-	};
+	if (second !== void 0) {
+		const open = [...new Set(url.searchParams.getAll(addressWords.open).filter((title) => title !== ""))];
+		return {
+			kind: "record",
+			resource: first,
+			key: second,
+			...url.searchParams.get(addressWords.edit) === "true" && { edit: true },
+			...open.length > 0 && { open }
+		};
+	}
 	const params = url.searchParams;
 	const display = params.get(addressWords.display) || void 0;
 	const filter = params.get(addressWords.filter) || void 0;

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, HelpWhen, HistorySectionModel, JsonValue, KeyValue, LayoutItemModel, ListDisplayModel, ListModel, ListQuery, Literal, MapSectionModel, MapView, NavModel, NavRecentModel, NowValue, OrderByItem, PeriodChartModel, RecordMode, RelatedColumnModel, RelatedModel, ResourceModel, SaveFeedback, SaveSearchModel, SearchMatch, SearchResultModel, SearchesOfModel, 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, 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";
@@ -9,6 +9,7 @@ import { FieldRefs, FieldsInput, Ref, Refs } from "./refs.js";
 import { CreatedOptions, DeletedOptions, EventActor, EventContext, EventHelpers, EventMatch, EventSpec, UndeletedOptions, UpdatedOptions } from "./events/event-helpers.js";
 import { Access, InferRecord, Issue, KeyOf, KeyRefs, RecordKey, RecordOf } from "./resource-types.js";
 import { ResourceBuilder, SearchRef, SearchRefs, Validator, resource } from "./resource.js";
+import { isRecordCondition } from "./record-when.js";
 import { ChartInput, GroupChartInput, PeriodChartInput } from "./view-chart.js";
 import { FormInput } from "./view-form.js";
 import { ListColumn } from "./view-columns.js";
@@ -41,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 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 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 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, 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 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/index.js

@@ -9,6 +9,7 @@ import { createWhere, where } from "./filter/where.js";
 import { anonymousRole } from "./access/role-entry.js";
 import { accessWarnings, checkRecord, fieldsUsedBy, resolveAccess } from "./access/resolve.js";
 import { resource } from "./resource.js";
+import { isRecordCondition } from "./record-when.js";
 import { formPath, formRoute, readFormAddress } from "./form-address.js";
 import { fieldRef } from "./field-ref.js";
 import { view } from "./view.js";
@@ -24,4 +25,4 @@ import { rule } from "./access/rule.js";
 import { defineRoles } from "./access/roles.js";
 import { pickView } from "./access/pick-view.js";
 import { restrictModel } from "./access/restrict.js";
-export { accessWarnings, addressWords, anonymousRole, appPath, bottomBar, bottomBarErrors, checkFilter, checkOrderBy, checkRecord, createWhere, defineRoles, enumLabel, evaluateFilter, f, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, 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 { 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

@@ -17,4 +17,5 @@ import { promptError, promptFields, renderPrompt } from "./ai-prompt.js";
 import { AddressCheck, addressErrors } from "./address-errors.js";
 import { applyAssistantEvent, emptyAssistantState } from "./assistant/apply-event.js";
 import { readEventStream } from "./assistant/event-stream.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, leavesApp, linkActionError, markFieldRefs, matchedSearchField, matchesSearch, navRecentErrors, parseSize, pluginProblem, promptError, promptFields, pruneByShape, readEventStream, redactSecrets, renderPrompt, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, webhookResources };
+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, webhookResources };

package/dist/internal.js

@@ -17,4 +17,5 @@ import { redactSecrets } from "./redact-secrets.js";
 import { addressErrors } from "./address-errors.js";
 import { applyAssistantEvent, emptyAssistantState } from "./assistant/apply-event.js";
 import { readEventStream } from "./assistant/event-stream.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, leavesApp, linkActionError, markFieldRefs, matchedSearchField, matchesSearch, navRecentErrors, parseSize, pluginProblem, promptError, promptFields, pruneByShape, readEventStream, redactSecrets, renderPrompt, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, webhookResources };
+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, webhookResources };

package/dist/layout-items.d.ts

@@ -0,0 +1,5 @@
+import { LayoutItemModel } from "./model.js";
+//#region src/layout-items.d.ts
+/** The layout's items with every group's items in its place, for code that looks for sections and related tables wherever they sit. */
+export declare const layoutItems: (layout: readonly LayoutItemModel[]) => LayoutItemModel[];
+//#endregion

package/dist/layout-items.js

@@ -0,0 +1,5 @@
+//#region src/layout-items.ts
+/** The layout's items with every group's items in its place, for code that looks for sections and related tables wherever they sit. */
+const layoutItems = (layout) => layout.flatMap((item) => item.kind === "group" ? item.items : [item]);
+//#endregion
+export { layoutItems };

package/dist/layout.d.ts

@@ -1,4 +1,4 @@
-import { CardPhotosModel, HelpWhen, LayoutItemModel, RelatedModel, SectionPresentation, ShowWhen } from "./model.js";
+import { CardPhotosModel, HelpWhen, LayoutItemModel, RecordWhen, RelatedModel, SectionPresentation, ShowWhen } from "./model.js";
 import { Ref } from "./refs.js";
 import { ComponentRef, ViewProps } from "./view-displays.js";
 //#region src/layout.d.ts
@@ -31,7 +31,7 @@ export declare const layout: {
     help?: string;
     helpWhen?: HelpWhen;
     presentation?: SectionPresentation;
-    when?: ShowWhen;
+    when?: RecordWhen;
   }) => LayoutItemModel;
   /**
    * The record's photos as tiles in the main column, one large and the next four smaller, the last saying how many more
@@ -48,7 +48,16 @@ export declare const layout: {
   }) => LayoutItemModel;
   /** A read-only summary card of fields beside the main column. */
   sidebar: (fields: Ref[], o?: {
-    when?: ShowWhen;
+    when?: RecordWhen;
+  }) => LayoutItemModel;
+  /**
+   * A heading over sections and related tables in the main column; `collapsed: true` keeps it closed until the person
+   * opens it, or a link to the record does (the address names the open groups by title). Throws on any other item. See
+   * [Groups](website/src/content/docs/reference/ui-config.mdx#groups).
+   */
+  group: (title: string, items: LayoutItemModel[], o?: {
+    collapsed?: boolean;
+    when?: RecordWhen;
   }) => LayoutItemModel;
   /** A table of the records of another resource that point at this one, directly or through a join table. */
   related: (title: string, o: Omit<RelatedModel, "kind" | "title">) => LayoutItemModel;

package/dist/layout.js

@@ -59,6 +59,22 @@ const layout = {
 		fields: fields.map((ref) => ref.name),
 		...o.when !== void 0 && { when: o.when }
 	}),
+	/**
+	* A heading over sections and related tables in the main column; `collapsed: true` keeps it closed until the person
+	* opens it, or a link to the record does (the address names the open groups by title). Throws on any other item. See
+	* [Groups](website/src/content/docs/reference/ui-config.mdx#groups).
+	*/
+	group: (title, items, o = {}) => {
+		const wrong = items.find((item) => item.kind !== "section" && item.kind !== "related");
+		if (wrong) throw new Error(`l.group "${title}" holds sections and related tables, not ${wrong.kind}`);
+		return {
+			kind: "group",
+			title,
+			items,
+			...o.collapsed && { collapsed: true },
+			...o.when !== void 0 && { when: o.when }
+		};
+	},
 	/** A table of the records of another resource that point at this one, directly or through a join table. */
 	related: (title, o) => ({
 		kind: "related",

package/dist/model.d.ts

@@ -218,6 +218,8 @@ export type AppAddress = {
    * Edit opens. A view whose record page is always editable ignores it.
    */
   edit?: boolean;
+  /** The titles of the record page's collapsed groups that are open. */
+  open?: readonly string[];
 } | {
   /** The form for a new record. */
   kind: 'create';
@@ -288,6 +290,8 @@ export type HelpWhen = 'always' | 'editing';
  * [Form and read view](website/src/content/docs/reference/ui-config.mdx#form-and-read-view).
  */
 export type ShowWhen = 'always' | 'editing' | 'reading';
+/** `ShowWhen`, or an AIP-160 condition over the saved record, as `<Show when>` takes: the item shows while it holds. See "Form and read view" in the UI reference. */
+export type RecordWhen = ShowWhen | (string & {});
 /** How a field's badges are drawn: `arrow` points them right, as on a rating scale. */
 export type BadgeShape = 'arrow';
 /** A field type by the name a plugin registers it under, and the plain data it is given. */
@@ -640,8 +644,10 @@ export type RelatedModel = {
   display?: string;
   /** The text when nothing matches. */
   empty?: string;
-  /** Whether it shows on the form, the read view or both. */
-  when?: ShowWhen;
+  /** Leave the section off the page while it has no records. */
+  hideEmpty?: boolean;
+  /** Whether it shows on the form, the read view or both, or a condition on the saved record that it shows while it holds. */
+  when?: RecordWhen;
 };
 /**
  * A project component drawn on the record page where it is listed, in the main column or with `sidebar` in the
@@ -710,8 +716,8 @@ export type CommentsSectionModel = {
 };
 /** How a section shows its fields on the read view: `facts` as a row of key facts; label/value rows when omitted. */
 export type SectionPresentation = 'facts';
-/** An item of the record page (`.layout((r) => ...)` with `l`); see [The record page](website/src/content/docs/reference/ui-config.mdx#the-record-page). */
-export type LayoutItemModel = {
+/** A titled group of fields on the record page; see [The record page](website/src/content/docs/reference/ui-config.mdx#the-record-page). */
+export type SectionModel = {
   /** A titled group of fields in the main column, editable where the user may write. */
   kind: 'section';
   /** The section's title. */
@@ -727,16 +733,33 @@ export type LayoutItemModel = {
    * label/value rows; the form edits them as any section's.
    */
   presentation?: SectionPresentation;
-  /** Whether it shows on the form, the read view or both. */
-  when?: ShowWhen;
-} | {
+  /** Whether it shows on the form, the read view or both, or a condition on the saved record that it shows while it holds. */
+  when?: RecordWhen;
+};
+/** An item of the record page (`.layout((r) => ...)` with `l`); see [The record page](website/src/content/docs/reference/ui-config.mdx#the-record-page). */
+export type LayoutItemModel = SectionModel | {
   /** A read-only summary card beside the main column. */
   kind: 'sidebar';
   /** The fields it shows, in order. */
   fields: string[];
+  /** Whether it shows on the form, the read view or both, or a condition on the saved record that it shows while it holds. */
+  when?: RecordWhen;
+} | RelatedModel | GroupModel | CustomSectionModel | MapSectionModel | GalleryModel | HistorySectionModel | CommentsSectionModel;
+/** A titled group of sections and related tables on the record page, closed until opened with `collapsed`; see [Groups](website/src/content/docs/reference/ui-config.mdx#groups). */
+export type GroupModel = {
+  /** A group of sections and related tables. */
+  kind: 'group';
+  /** Its heading, unique among the view's groups: the address names an open group by it. */
+  title: string;
+  /** The sections and related tables it holds, in order. */
+  items: GroupItemModel[];
+  /** Closed until the person opens it, or a link does. */
+  collapsed?: boolean;
   /** Whether it shows on the form, the read view or both. */
-  when?: ShowWhen;
-} | RelatedModel | CustomSectionModel | MapSectionModel | GalleryModel | HistorySectionModel | CommentsSectionModel;
+  when?: RecordWhen;
+};
+/** An item a group may hold. */
+export type GroupItemModel = SectionModel | RelatedModel;
 /**
  * A record's photos as tiles in the main column under `title`, one large and the next few smaller, opening a lightbox
  * that steps through them all: first the record's own file field `image`, then the `image` of the records of

package/dist/record-when.d.ts

@@ -0,0 +1,4 @@
+//#region src/record-when.d.ts
+/** Whether `when` is a condition on the saved record rather than one of the `ShowWhen` modes. */
+export declare const isRecordCondition: (when: string | undefined) => when is string;
+//#endregion

package/dist/record-when.js

@@ -0,0 +1,10 @@
+//#region src/record-when.ts
+const showModes = [
+	"always",
+	"editing",
+	"reading"
+];
+/** Whether `when` is a condition on the saved record rather than one of the `ShowWhen` modes. */
+const isRecordCondition = (when) => when !== void 0 && !showModes.includes(when);
+//#endregion
+export { isRecordCondition };

package/dist/view.js

@@ -260,6 +260,12 @@ var ViewBuilder = class ViewBuilder {
 		}
 		const clash = resource ? list?.relatedColumns?.find((column) => Object.hasOwn(resource.fields, column.name)) : void 0;
 		if (clash) throw new Error(`View "${this.state.resource}": related column "${clash.name}" has the name of a field of the resource`);
+		const groupTitles = /* @__PURE__ */ new Set();
+		for (const item of this.state.layout) {
+			if (item.kind !== "group") continue;
+			if (groupTitles.has(item.title)) throw new Error(`View "${this.state.resource}": two groups are titled "${item.title}"`);
+			groupTitles.add(item.title);
+		}
 		for (const item of resource ? this.state.layout : []) {
 			if (item.kind !== "gallery" || item.image === void 0) continue;
 			if (!Object.hasOwn(resource.fields, item.image)) throw new Error(`View "${this.state.resource}": gallery "${item.title}" names field "${item.image}", which the resource does not have`);

package/package.json

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