@protobase/schema 0.54.5 → 0.55.0

package/dist/built-in-field-types.d.ts

@@ -0,0 +1,9 @@
+//#region src/built-in-field-types.d.ts
+/**
+ * The field types Protobase brings, which a view chooses with `.widget(name)` like a plugin's, by the storage types
+ * each shows: `members`, a JSON array of the user ids of an organization's members. A plugin's of the same name wins.
+ */
+export declare const builtInFieldTypes: {
+  readonly members: readonly ["json"];
+};
+//#endregion

package/dist/built-in-field-types.js

@@ -0,0 +1,8 @@
+//#region src/built-in-field-types.ts
+/**
+* The field types Protobase brings, which a view chooses with `.widget(name)` like a plugin's, by the storage types
+* each shows: `members`, a JSON array of the user ids of an organization's members. A plugin's of the same name wins.
+*/
+const builtInFieldTypes = { members: ["json"] };
+//#endregion
+export { builtInFieldTypes };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Rollup, RollupCount, RollupFn, RollupSource, RollupValue } from "./computed/rollup.js";
 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, ListDragModel, ListModel, ListQuery, Literal, MapSectionModel, MapView, NamedListModel, NavModel, NavRecentModel, NowValue, OrderByItem, ParentAccess, ParentModel, PeriodChartModel, PositionAfterModel, RecordChartModel, RecordChartRange, RecordMode, RecordWhen, RelatedColumnModel, RelatedModel, RelatedPresentation, ResourceModel, SaveFeedback, SaveSearchModel, SearchMatch, SearchResultModel, SearchesOfModel, SectionModel, SectionPresentation, ShowWhen, SignInPromptModel, SignInViewModel, SortSpec, Span, StatusTone, TabItemModel, TabModel, TimelineView, 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, ListDragModel, ListModel, ListQuery, Literal, MapSectionModel, MapView, NamedListModel, NavModel, NavRecentModel, NowValue, OrderByItem, ParentAccess, ParentModel, PeriodChartModel, PositionAfterModel, RecordChartModel, RecordChartRange, RecordMode, RecordWhen, RelatedColumnModel, RelatedModel, RelatedPresentation, ResourceModel, SaveFeedback, SaveSearchModel, SearchMatch, SearchResultModel, SearchesOfModel, SectionModel, SectionPresentation, ShowWhen, SignInPromptModel, SignInViewModel, SortSpec, Span, StatusTone, TabItemModel, TabModel, TimelineView, TitleFromModel, UserMenuItemModel, UserMenuModel, ViewModel } from "./model.js";
 import { AccessAction, AccessContext, AccessFn, AccessResult, AccessUser, FieldAccess, FieldRule } from "./access/types.js";
 import { Encrypted, encrypted } from "./encrypted-value.js";
 import { AnyField, Constraint, Field, FieldMeta, FieldTypeDef } from "./field.js";
@@ -47,4 +47,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 ArgumentSpec, type ArgumentType, type ArgumentsSpec, 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 ComputedReveal, type ConnectAddress, type Constraint, type CreateModel, type CreatedOptions, type CustomSectionModel, type DatePreset, type DeletedOptions, type DurationLiteral, type DurationUnit, type Encrypted, type EvaluateOptions, type EventActor, type EventContext, type EventHelpers, type EventMatch, type EventModel, type EventOperation, type EventSpec, type ExactCapability, 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 ListDragModel, 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 ParentAccess, type ParentModel, type PeriodChartInput, type PeriodChartModel, type PositionAfterModel, type RecordChartModel, type RecordChartRange, type RecordKey, type RecordMode, type RecordOf, type RecordWhen, type Ref, type Refs, type RelatedColumnModel, type RelatedModel, type RelatedPresentation, type RelationField, type ResolveOptions, type ResolvedAccess, type ResourceBuilder, type ResourceModel, type RevealCaller, type RoleEntry, type RoleLimit, type Roles, type RolesOptions, type Rollup, type RollupCount, type RollupFn, type RollupSource, type RollupValue, 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 TabItemModel, type TabModel, type TenantOptions, type TimelineView, type UndeletedOptions, type UpdatedOptions, type UserMenuItemModel, type UserMenuModel, type UserMenuSource, type Validator, type ViewBuilder, type ViewModel, type ViewProps, accessWarnings, addressWords, anonymousRole, appPath, argumentsSchema, bottomBar, bottomBarErrors, checkFilter, checkOrderBy, checkRecord, connectParams, connectPath, connectRoute, createWhere, defineRoles, encrypted, enumLabel, evaluateFilter, f, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, isRecordCondition, keyTypes, layout as l, maxBottomBarItems, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, readConnectAddress, 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 ArgumentSpec, type ArgumentType, type ArgumentsSpec, 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 ComputedReveal, type ConnectAddress, type Constraint, type CreateModel, type CreatedOptions, type CustomSectionModel, type DatePreset, type DeletedOptions, type DurationLiteral, type DurationUnit, type Encrypted, type EvaluateOptions, type EventActor, type EventContext, type EventHelpers, type EventMatch, type EventModel, type EventOperation, type EventSpec, type ExactCapability, 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 ListDragModel, 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 ParentAccess, type ParentModel, type PeriodChartInput, type PeriodChartModel, type PositionAfterModel, type RecordChartModel, type RecordChartRange, type RecordKey, type RecordMode, type RecordOf, type RecordWhen, type Ref, type Refs, type RelatedColumnModel, type RelatedModel, type RelatedPresentation, type RelationField, type ResolveOptions, type ResolvedAccess, type ResourceBuilder, type ResourceModel, type RevealCaller, type RoleEntry, type RoleLimit, type Roles, type RolesOptions, type Rollup, type RollupCount, type RollupFn, type RollupSource, type RollupValue, 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 TabItemModel, type TabModel, type TenantOptions, type TimelineView, type TitleFromModel, type UndeletedOptions, type UpdatedOptions, type UserMenuItemModel, type UserMenuModel, type UserMenuSource, type Validator, type ViewBuilder, type ViewModel, type ViewProps, accessWarnings, addressWords, anonymousRole, appPath, argumentsSchema, bottomBar, bottomBarErrors, checkFilter, checkOrderBy, checkRecord, connectParams, connectPath, connectRoute, createWhere, defineRoles, encrypted, enumLabel, evaluateFilter, f, fieldRef, fieldsUsedBy, fitsKeyType, formPath, formRoute, imageFormats, isRecordCondition, keyTypes, layout as l, maxBottomBarItems, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, readConnectAddress, readFormAddress, readSignInAddress, resolveAccess, resource, restrictModel, rule, signInParams, signInPath, signInRoute, signInSteps, userMenu, view, where };

package/dist/internal.d.ts

@@ -35,4 +35,5 @@ import { pushRecord, serviceWorkerFile } from "./push-record.js";
 import { deviceIdParam, devicesPath } from "./devices-path.js";
 import { historyIdParam, historyIdPattern, historyPath } from "./history-path.js";
 import { listColumnNames } from "./list-columns.js";
-export { type AddressCheck, type FormulaNode, type Locale, type MobileReleaseAnswer, type PluginHost, type PluginRequirement, type PropShapes, type RefShape, type SearchTerm, actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, boardErrors, bottomBarFor, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, datesErrors, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, renderPrompt, searchTerms, serviceWorkerFile, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources };
+import { builtInFieldTypes } from "./built-in-field-types.js";
+export { type AddressCheck, type FormulaNode, type Locale, type MobileReleaseAnswer, type PluginHost, type PluginRequirement, type PropShapes, type RefShape, type SearchTerm, actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, boardErrors, bottomBarFor, builtInFieldTypes, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, datesErrors, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, renderPrompt, searchTerms, serviceWorkerFile, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources };

package/dist/internal.js

@@ -35,4 +35,5 @@ import { pushRecord, serviceWorkerFile } from "./push-record.js";
 import { deviceIdParam, devicesPath } from "./devices-path.js";
 import { historyIdParam, historyIdPattern, historyPath } from "./history-path.js";
 import { listColumnNames } from "./list-columns.js";
-export { actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, boardErrors, bottomBarFor, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, datesErrors, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, renderPrompt, searchTerms, serviceWorkerFile, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources };
+import { builtInFieldTypes } from "./built-in-field-types.js";
+export { actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, boardErrors, bottomBarFor, builtInFieldTypes, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, datesErrors, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, renderPrompt, searchTerms, serviceWorkerFile, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources };

package/dist/model.d.ts

@@ -327,8 +327,9 @@ export type FieldViewModel = {
   /** `arrow` draws the field's badges as arrows pointing right, as on a rating scale such as the EU energy label. */
   badgeShape?: BadgeShape;
   /**
-   * The field type a plugin registers (`definePlugin({ fields })`) that shows and edits this field, with its props;
-   * without that plugin, or for a storage type it does not show, the field shows as it would without it.
+   * The field type a plugin registers (`definePlugin({ fields })`), or a built-in one such as `members`, that shows and
+   * edits this field, with its props; without it, or for a storage type it does not show, the field shows as it would
+   * without it.
    */
   widget?: FieldWidgetModel;
 };
@@ -611,7 +612,7 @@ export type ParentAccess = 'read' | 'update';
 /**
  * A record that a resource's records belong to through a relation field, such as an operation's VM: creating, changing,
  * deleting or undeleting a record needs `access` on the record `field` points at, checked with the caller's own access
- * rules on that resource. See
+ * rules on that resource; with `read`, every read of its records keeps to those whose parent the caller reads. See
  * [Records that belong to another](website/src/content/docs/reference/access.mdx#records-that-belong-to-another).
  */
 export type ParentModel = {
@@ -1220,6 +1221,19 @@ export type SearchResultModel = {
   /** The field on the line under it. */
   subtitle?: string;
 };
+/**
+ * A record's title derived in the browser, for the person reading it: the project UI's `titles[rule]` gets the record's
+ * `fields` and the reader, such as the names of a conversation's other members. Presentation only: it is no field,
+ * filter or sort key. `unreadable` marks one that reads a field the caller cannot read, which then titles by the key.
+ */
+export type TitleFromModel = {
+  /** The name of the function under the project UI's `titles`. */
+  rule: string;
+  /** The fields the rule reads, which every request that titles a record asks for. */
+  fields: string[];
+  /** Set in `/meta` for a caller who cannot read one of the fields, which it then leaves out. */
+  unreadable?: true;
+};
 /**
  * How the admin shows a resource: its names, list, filters, record page and actions, built by `view(...)` and sent to
  * each user in `/meta` without what they cannot see. See [Views](website/src/content/docs/reference/ui-config.mdx).
@@ -1231,6 +1245,8 @@ export type ViewModel = {
   roles?: string[];
   /** Field used as the record's display title in breadcrumbs, relation links and search results. */
   title?: string;
+  /** A title the browser derives per reader in place of `title`, by a rule of the project's UI (see `TitleFromModel`). */
+  titleFrom?: TitleFromModel;
   /** A record in the global search: a title of one or more fields joined by spaces, over a subtitle field by default. */
   searchResult?: SearchResultModel;
   /** Where the resource sits in the sidebar. */

package/dist/resource.d.ts

@@ -114,8 +114,9 @@ export declare class ResourceBuilder<F extends FieldsInput = {}, K = never> {
   /**
    * A relation whose record each record belongs to, and the access on it writing them needs: creating a record, changing
    * it (the parent it leaves and the one it moves to), deleting and undeleting it all need `access` on the parent,
-   * checked with the caller's own access rules on its resource and locked until the write commits. A null relation
-   * checks nothing; each call adds a check. See
+   * checked with the caller's own access rules on its resource and locked until the write commits. With `read`, every
+   * read of its records (lists, counts, aggregates, gets and labels) also keeps to those whose parent the caller reads
+   * there. A null relation checks nothing; each call adds a check. See
    * [Records that belong to another](website/src/content/docs/reference/access.mdx#records-that-belong-to-another).
    *
    * @example

package/dist/resource.js

@@ -121,8 +121,9 @@ var ResourceBuilder = class ResourceBuilder {
 	/**
 	* A relation whose record each record belongs to, and the access on it writing them needs: creating a record, changing
 	* it (the parent it leaves and the one it moves to), deleting and undeleting it all need `access` on the parent,
-	* checked with the caller's own access rules on its resource and locked until the write commits. A null relation
-	* checks nothing; each call adds a check. See
+	* checked with the caller's own access rules on its resource and locked until the write commits. With `read`, every
+	* read of its records (lists, counts, aggregates, gets and labels) also keeps to those whose parent the caller reads
+	* there. A null relation checks nothing; each call adds a check. See
 	* [Records that belong to another](website/src/content/docs/reference/access.mdx#records-that-belong-to-another).
 	*
 	* @example

package/dist/view-field.d.ts

@@ -67,7 +67,9 @@ export declare class FieldView<N extends string = string, V = unknown> {
   icon(icon: string): FieldView<N, V>;
   /**
    * Shows and edits the field with the field type a plugin registers under `name` (`definePlugin({ fields })`), given
-   * `props`, such as `r.score.widget('rating', { max: 5 })`. Without that plugin, or when the field type does not show
+   * `props`, such as `r.score.widget('rating', { max: 5 })`, or with the built-in `members`, which picks an
+   * organization's members into a JSON array of user ids (see
+   * [Members](website/src/content/docs/reference/plugins.md#members)). Without that field type, or when it does not show
    * this field's storage type, the field shows as it would without it.
    */
   widget(name: string, props?: Record<string, JsonValue>): FieldView<N, V>;

package/dist/view-field.js

@@ -103,7 +103,9 @@ var FieldView = class FieldView {
 	}
 	/**
 	* Shows and edits the field with the field type a plugin registers under `name` (`definePlugin({ fields })`), given
-	* `props`, such as `r.score.widget('rating', { max: 5 })`. Without that plugin, or when the field type does not show
+	* `props`, such as `r.score.widget('rating', { max: 5 })`, or with the built-in `members`, which picks an
+	* organization's members into a JSON array of user ids (see
+	* [Members](website/src/content/docs/reference/plugins.md#members)). Without that field type, or when it does not show
 	* this field's storage type, the field shows as it would without it.
 	*/
 	widget(name, props) {

package/dist/view.d.ts

@@ -57,6 +57,12 @@ export declare class ViewBuilder<R extends {
   forRoles(roles: string[]): ViewBuilder<R>;
   /** The field shown as this record's title. Throws when the field does not exist. */
   title(pick: (r: FieldRefs<FieldsOf<R>>) => Ref): ViewBuilder<R>;
+  /**
+   * A title derived per reader in the browser, in place of `title`: `rule` names a function of the project's UI
+   * `titles`, which gets the record with the `fields` picked and the signed-in reader, such as the names of the members
+   * other than the reader. The record's key shows while it returns nothing. Throws when a field does not exist.
+   */
+  titleFrom(rule: string, pick: (r: FieldRefs<FieldsOf<R>>) => Ref[]): ViewBuilder<R>;
   /**
    * How a record shows in the global search: a bold `title` of one or more fields joined by spaces (default: `title`)
    * and a `subtitle` field under it, replaced by the search field the text matched when that is neither.
@@ -205,7 +211,7 @@ export declare class ViewBuilder<R extends {
     };
     limit?: number;
   }): ViewBuilder<R>;
-  /** With the resource's model, also verifies the title, search result and list display fields, related column names, a gallery's image, `listOf`, `searchesOf`, the sidebar's `recent` group and `tenant`, and the forms' fields. */
+  /** With the resource's model, also verifies the title and `titleFrom`, search result and list display fields, related column names, a gallery's image, `listOf`, `searchesOf`, the sidebar's `recent` group and `tenant`, and the forms' fields. */
   toModel(resource?: ResourceModel): ViewModel;
   private refs;
   private next;

package/dist/view.js

@@ -58,6 +58,20 @@ var ViewBuilder = class ViewBuilder {
 		return this.next({ title: pick(this.refs()).name });
 	}
 	/**
+	* A title derived per reader in the browser, in place of `title`: `rule` names a function of the project's UI
+	* `titles`, which gets the record with the `fields` picked and the signed-in reader, such as the names of the members
+	* other than the reader. The record's key shows while it returns nothing. Throws when a field does not exist.
+	*/
+	titleFrom(rule, pick) {
+		const fields = pick(this.refs()).map((ref) => ref.name);
+		if (rule === "") throw new Error(`View "${this.state.resource}": titleFrom needs the name of a rule`);
+		if (fields.length === 0) throw new Error(`View "${this.state.resource}": titleFrom "${rule}" reads no fields`);
+		return this.next({ titleFrom: {
+			rule,
+			fields
+		} });
+	}
+	/**
 	* How a record shows in the global search: a bold `title` of one or more fields joined by spaces (default: `title`)
 	* and a `subtitle` field under it, replaced by the search field the text matched when that is neither.
 	*/
@@ -287,10 +301,12 @@ var ViewBuilder = class ViewBuilder {
 		};
 		return this.next({ searchesOf: searches });
 	}
-	/** With the resource's model, also verifies the title, search result and list display fields, related column names, a gallery's image, `listOf`, `searchesOf`, the sidebar's `recent` group and `tenant`, and the forms' fields. */
+	/** With the resource's model, also verifies the title and `titleFrom`, search result and list display fields, related column names, a gallery's image, `listOf`, `searchesOf`, the sidebar's `recent` group and `tenant`, and the forms' fields. */
 	toModel(resource) {
-		const { title, nav, searchResult, list, listOf } = this.state;
+		const { title, titleFrom, nav, searchResult, list, listOf } = this.state;
 		if (resource && title !== void 0 && !Object.hasOwn(resource.fields, title)) throw new Error(`View "${this.state.resource}": title field "${title}" does not exist on the resource`);
+		const unknownTitleField = resource ? titleFrom?.fields.find((name) => !Object.hasOwn(resource.fields, name)) : void 0;
+		if (unknownTitleField !== void 0) throw new Error(`View "${this.state.resource}": titleFrom field "${unknownTitleField}" does not exist on the resource`);
 		const missing = resource ? [...searchResult?.title ?? [], ...searchResult?.subtitle ? [searchResult.subtitle] : []].filter((name) => !Object.hasOwn(resource.fields, name)) : [];
 		if (missing.length > 0) throw new Error(`View "${this.state.resource}": search result field "${missing[0]}" does not exist on the resource`);
 		for (const display of resource ? list?.displays ?? [] : []) {

package/package.json

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