@protobase/layout 0.46.2 → 0.46.4

package/dist/block-specs.js

@@ -177,9 +177,58 @@ const blockSpecs = {
 			to: optional("address")
 		}
 	},
+	Tabs: {
+		children: true,
+		props: {}
+	},
+	Tab: {
+		children: true,
+		props: {
+			name: required("text"),
+			label: required("text")
+		}
+	},
+	Settings: {
+		children: false,
+		props: {
+			resource: required("text"),
+			fields: optional("texts"),
+			title: optional("text"),
+			description: optional("text"),
+			span: optional("span")
+		}
+	},
 	Users: {
 		children: false,
 		props: {}
+	},
+	Profile: {
+		children: false,
+		props: {}
+	},
+	Password: {
+		children: false,
+		props: {}
+	},
+	Passkeys: {
+		children: false,
+		props: {}
+	},
+	TwoFactor: {
+		children: false,
+		props: {}
+	},
+	ConnectedAccounts: {
+		children: false,
+		props: {}
+	},
+	Devices: {
+		children: false,
+		props: {}
+	},
+	ConnectedApps: {
+		children: false,
+		props: {}
 	}
 };
 const formats = [

package/dist/blocks.d.ts

@@ -183,8 +183,36 @@ export type LinkProps = ({
 }) & {
   children?: LayoutChildren;
 };
+/** One route per `Tab` below the page's address: the first tab at the page's own, each other at `/<page>/<tab name>`. */
+export type TabsProps = {
+  children?: LayoutChildren;
+};
+/** One tab of a `Tabs`: `name` is its address, after the page's, `label` the word it shows. */
+export type TabProps = {
+  name: string;
+  label: string;
+  children?: LayoutChildren;
+};
+/**
+ * The signed-in person's own record of `resource`, a resource whose `.owner(...)` is its key, as settings: each of
+ * `fields` as a control that saves on change, its default until the first save creates the record. Every caller, an
+ * admin too, reads and writes only their own record of it. `fields` defaults to every field a person can set.
+ */
+export type SettingsProps = {
+  resource: string;
+  fields?: string[];
+  title?: string;
+  description?: string;
+  span?: GridSpan;
+};
 /** Everyone who can sign in, for admins: inviting by email, adding accounts, changing roles and blocking. Takes no props. */
 export type UsersProps = Record<string, never>;
+/**
+ * A part of the signed-in person's own account, for the `account` page only: their profile, password, passkeys,
+ * two-factor authentication, connected accounts or connected apps. Each takes no props, loads its own data, and hides
+ * itself where it does not apply, such as Connected apps without MCP.
+ */
+export type AccountBlockProps = Record<string, never>;
 export declare const Page: Block<PageProps>;
 export declare const Grid: Block<GridProps>;
 export declare const Card: Block<CardProps>;
@@ -201,5 +229,15 @@ export declare const ModalForm: Block<ModalFormProps>;
 export declare const Action: Block<ActionProps>;
 export declare const Show: Block<ShowProps>;
 export declare const Link: Block<LinkProps>;
+export declare const Tabs: Block<TabsProps>;
+export declare const Tab: Block<TabProps>;
+export declare const Settings: Block<SettingsProps>;
 export declare const Users: Block<UsersProps>;
+export declare const Profile: Block<AccountBlockProps>;
+export declare const Password: Block<AccountBlockProps>;
+export declare const Passkeys: Block<AccountBlockProps>;
+export declare const TwoFactor: Block<AccountBlockProps>;
+export declare const ConnectedAccounts: Block<AccountBlockProps>;
+export declare const Devices: Block<AccountBlockProps>;
+export declare const ConnectedApps: Block<AccountBlockProps>;
 //#endregion

package/dist/blocks.js

@@ -16,6 +16,16 @@ const ModalForm = defineBlock("ModalForm", false);
 const Action = defineBlock("Action", false);
 const Show = defineBlock("Show", false);
 const Link = defineBlock("Link", false);
+const Tabs = defineBlock("Tabs", false);
+const Tab = defineBlock("Tab", false);
+const Settings = defineBlock("Settings", false);
 const Users = defineBlock("Users", false);
+const Profile = defineBlock("Profile", false);
+const Password = defineBlock("Password", false);
+const Passkeys = defineBlock("Passkeys", false);
+const TwoFactor = defineBlock("TwoFactor", false);
+const ConnectedAccounts = defineBlock("ConnectedAccounts", false);
+const Devices = defineBlock("Devices", false);
+const ConnectedApps = defineBlock("ConnectedApps", false);
 //#endregion
-export { Action, Card, CardRow, Chart, Field, Grid, Link, ModalForm, Page, Progress, RecordCard, RecordCards, RecordRow, Show, Stat, Table, Users };
+export { Action, Card, CardRow, Chart, ConnectedAccounts, ConnectedApps, Devices, Field, Grid, Link, ModalForm, Page, Passkeys, Password, Profile, Progress, RecordCard, RecordCards, RecordRow, Settings, Show, Stat, Tab, Table, Tabs, TwoFactor, Users };

package/dist/check-account.d.ts

@@ -0,0 +1,6 @@
+//#region src/check-account.d.ts
+/** The page that holds the signed-in person's own account. */
+export declare const accountPageName = "account";
+/** The blocks that act on the signed-in person's own sign-in, so they belong on the account page alone. */
+export declare const accountBlocks: ReadonlySet<string>;
+//#endregion

package/dist/check-account.js

@@ -0,0 +1,25 @@
+import { walkTree } from "./walk.js";
+//#region src/check-account.ts
+/** The page that holds the signed-in person's own account. */
+const accountPageName = "account";
+/** The blocks that act on the signed-in person's own sign-in, so they belong on the account page alone. */
+const accountBlocks = /* @__PURE__ */ new Set([
+	"Profile",
+	"Password",
+	"Passkeys",
+	"TwoFactor",
+	"ConnectedAccounts",
+	"Devices",
+	"ConnectedApps"
+]);
+/** Each account block on a page other than the account page, with where it is. */
+const accountBlockProblems = (name, tree) => {
+	if (name === "account") return [];
+	const problems = [];
+	walkTree(tree, (node, { path }) => {
+		if (!node.custom && accountBlocks.has(node.type)) problems.push(`${path}: <${node.type}> acts on the signed-in person's own account, so it is only allowed on the "${accountPageName}" page`);
+	});
+	return problems;
+};
+//#endregion
+export { accountBlockProblems, accountBlocks, accountPageName };

package/dist/check-page.js

@@ -1,5 +1,6 @@
 import { dataProps } from "./node.js";
 import { walkTree } from "./walk.js";
+import { settingsProblems } from "./settings.js";
 import { chartProblems } from "./check-chart.js";
 import { resolveFieldPath } from "./field-path.js";
 import { conditionProblems } from "./check-condition.js";
@@ -73,6 +74,9 @@ const nodeProblems = (node, scope, { models, actions, pages, createPages }) => {
 			}
 			for (const name of Object.keys(node.props.values ?? {})) if (!Object.hasOwn(model.fields, name)) problems.push(`values: unknown field "${name}" on ${model.name}`);
 			break;
+		case "Settings":
+			if (model) problems.push(...settingsProblems(model, node.props.fields));
+			break;
 		case "Action":
 			if (resource !== void 0 && !actions(resource).has(String(node.props.name))) problems.push(`no action "${node.props.name}" on ${resource}; declare it with view('${resource}').actions(...)`);
 			break;

package/dist/check-structure.js

@@ -1,6 +1,7 @@
 import { blockSpecs, propProblems } from "./block-specs.js";
-import { parseCondition } from "./condition.js";
 import { walkTree } from "./walk.js";
+import { parseCondition } from "./condition.js";
+import { tabsProblems } from "./check-tabs.js";
 import { appHrefError } from "@protobase/schema/internal";
 //#region src/check-structure.ts
 /** Problems that need a record around the element, which only a `RecordCard` or a `CardRow` card provides. */
@@ -33,8 +34,8 @@ const linkProblems = ({ props }) => {
 };
 /**
 * Checks a page's tree without the models: the root is one `Page`, every built-in element has known props of the right
-* kind, elements that show a record's fields sit inside one, and conditions parse. Returns the problems, each with
-* where it is.
+* kind, elements that show a record's fields sit inside one, tabs are placed as their address needs, and conditions
+* parse. Returns the problems, each with where it is.
 */
 const structureProblems = (tree) => {
 	const problems = [];
@@ -55,7 +56,7 @@ const structureProblems = (tree) => {
 			if (!parsed.ok) report(`"when" is not a valid condition: ${parsed.message}`);
 		}
 	});
-	return problems;
+	return [...problems, ...tabsProblems(tree)];
 };
 //#endregion
 export { structureProblems };

package/dist/check-tabs.js

@@ -0,0 +1,36 @@
+import { walkTree } from "./walk.js";
+//#region src/check-tabs.ts
+const tabName = /^[a-z][a-zA-Z0-9-]*$/;
+const isBuiltIn = (child, type) => typeof child !== "string" && !child.custom && child.type === type;
+const ownProblems = (tabs) => {
+	const problems = [];
+	if (tabs.children.some((child) => !isBuiltIn(child, "Tab"))) problems.push("holds only <Tab> elements");
+	const names = tabs.children.filter((child) => isBuiltIn(child, "Tab")).map((tab) => tab.props.name);
+	if (names.length === 0) problems.push("holds no <Tab>");
+	for (const name of names.filter((name) => typeof name === "string" && !tabName.test(name))) problems.push(`tab name "${String(name)}" must start with a lowercase letter and hold only letters, digits and dashes`);
+	for (const name of new Set(names.filter((name, index) => names.indexOf(name) !== index))) problems.push(`two tabs are named "${String(name)}"`);
+	return problems;
+};
+/**
+* Problems with a page's tabs: the tabs take the page's address, so a page holds at most one `Tabs`, directly in its
+* `Page`, each `Tab` sits directly in it, and every tab has a name of its own that fits in an address.
+*/
+const tabsProblems = (tree) => {
+	const problems = [];
+	const placed = /* @__PURE__ */ new Set();
+	let count = 0;
+	walkTree(tree, (node, { path }) => {
+		if (node.custom) return;
+		if (node.type === "Tabs") {
+			count += 1;
+			if (!tree.children.includes(node)) problems.push(`${path}: <Tabs> only sits directly in the <Page>`);
+			if (count === 2) problems.push(`${path}: a page holds one <Tabs>, as its tabs take the page's address`);
+			for (const child of node.children) if (isBuiltIn(child, "Tab")) placed.add(child);
+			ownProblems(node).forEach((problem) => problems.push(`${path}: ${problem}`));
+		}
+		if (node.type === "Tab" && !placed.has(node)) problems.push(`${path}: <Tab> only sits directly in a <Tabs>`);
+	});
+	return problems;
+};
+//#endregion
+export { tabsProblems };

package/dist/index.d.ts

@@ -1,10 +1,13 @@
 import { Block, LayoutChild, LayoutChildren, LayoutNode, LayoutValue, isLayoutNode } from "./node.js";
-import { Action, ActionProps, ButtonVariant, Card, CardProps, CardRow, CardRowProps, CardWidth, CardsLayout, Chart, ChartBucket, ChartProps, ChartType, DataProps, Elements, Field, FieldProps, Grid, GridProps, GridSpan, Link, LinkProps, ModalForm, ModalFormProps, Page, PageProps, Progress, ProgressProps, RecordCard, RecordCardProps, RecordCards, RecordCardsProps, RecordRow, RecordRowProps, Show, ShowProps, Stat, StatProps, Table, TableProps, Users, UsersProps } from "./blocks.js";
+import { AccountBlockProps, Action, ActionProps, ButtonVariant, Card, CardProps, CardRow, CardRowProps, CardWidth, CardsLayout, Chart, ChartBucket, ChartProps, ChartType, ConnectedAccounts, ConnectedApps, DataProps, Devices, Elements, Field, FieldProps, Grid, GridProps, GridSpan, Link, LinkProps, ModalForm, ModalFormProps, Page, PageProps, Passkeys, Password, Profile, Progress, ProgressProps, RecordCard, RecordCardProps, RecordCards, RecordCardsProps, RecordRow, RecordRowProps, Settings, SettingsProps, Show, ShowProps, Stat, StatProps, Tab, TabProps, Table, TableProps, Tabs, TabsProps, TwoFactor, Users, UsersProps } from "./blocks.js";
 import { ComponentOptions, component } from "./component.js";
-import { usersPage } from "./presets/users-page.js";
+import { accountBlocks, accountPageName } from "./check-account.js";
 import { PageDefinition, PageModel, PageOptions, isPageDefinition, page } from "./page.js";
+import { settingsFields, settingsResources, withSettingsFields } from "./settings.js";
+import { accountPage, accountTabs } from "./presets/account-page.js";
+import { usersPage } from "./presets/users-page.js";
 import { cardsLayoutOf } from "./cards-layout.js";
-import { Location, walkTree } from "./walk.js";
+import { Location, mapTree, walkTree } from "./walk.js";
 import { checkPages } from "./check-page.js";
 import { conditionProblems, conditionReadable } from "./check-condition.js";
 import { prunePage } from "./prune-page.js";
@@ -12,4 +15,4 @@ import { countedResource, evaluateCondition, parseCondition } from "./condition.
 import { PathStep, resolveFieldPath } from "./field-path.js";
 import { jsx_runtime_d_exports } from "./jsx-runtime.js";
 import { FieldRefValue, fieldRef } from "@protobase/schema";
-export { Action, type ActionProps, type Block, type ButtonVariant, Card, type CardProps, CardRow, type CardRowProps, type CardWidth, type CardsLayout, Chart, type ChartBucket, type ChartProps, type ChartType, type ComponentOptions, type DataProps, type Elements, Field, type FieldProps, type FieldRefValue, Grid, type GridProps, type GridSpan, type LayoutChild, type LayoutChildren, type LayoutNode, type LayoutValue, Link, type LinkProps, type Location, ModalForm, type ModalFormProps, Page, type PageDefinition, type PageModel, type PageOptions, type PageProps, type PathStep, Progress, type ProgressProps, RecordCard, type RecordCardProps, RecordCards, type RecordCardsProps, RecordRow, type RecordRowProps, Show, type ShowProps, Stat, type StatProps, Table, type TableProps, Users, type UsersProps, cardsLayoutOf, checkPages, component, conditionProblems, conditionReadable, countedResource, evaluateCondition, fieldRef, isLayoutNode, isPageDefinition, jsx_runtime_d_exports as jsxRuntime, page, parseCondition, prunePage, resolveFieldPath, usersPage, walkTree };
+export { type AccountBlockProps, Action, type ActionProps, type Block, type ButtonVariant, Card, type CardProps, CardRow, type CardRowProps, type CardWidth, type CardsLayout, Chart, type ChartBucket, type ChartProps, type ChartType, type ComponentOptions, ConnectedAccounts, ConnectedApps, type DataProps, Devices, type Elements, Field, type FieldProps, type FieldRefValue, Grid, type GridProps, type GridSpan, type LayoutChild, type LayoutChildren, type LayoutNode, type LayoutValue, Link, type LinkProps, type Location, ModalForm, type ModalFormProps, Page, type PageDefinition, type PageModel, type PageOptions, type PageProps, Passkeys, Password, type PathStep, Profile, Progress, type ProgressProps, RecordCard, type RecordCardProps, RecordCards, type RecordCardsProps, RecordRow, type RecordRowProps, Settings, type SettingsProps, Show, type ShowProps, Stat, type StatProps, Tab, type TabProps, Table, type TableProps, Tabs, type TabsProps, TwoFactor, Users, type UsersProps, accountBlocks, accountPage, accountPageName, accountTabs, cardsLayoutOf, checkPages, component, conditionProblems, conditionReadable, countedResource, evaluateCondition, fieldRef, isLayoutNode, isPageDefinition, jsx_runtime_d_exports as jsxRuntime, mapTree, page, parseCondition, prunePage, resolveFieldPath, settingsFields, settingsResources, usersPage, walkTree, withSettingsFields };

package/dist/index.js

@@ -1,9 +1,12 @@
 import { isLayoutNode } from "./node.js";
-import { Action, Card, CardRow, Chart, Field, Grid, Link, ModalForm, Page, Progress, RecordCard, RecordCards, RecordRow, Show, Stat, Table, Users } from "./blocks.js";
+import { Action, Card, CardRow, Chart, ConnectedAccounts, ConnectedApps, Devices, Field, Grid, Link, ModalForm, Page, Passkeys, Password, Profile, Progress, RecordCard, RecordCards, RecordRow, Settings, Show, Stat, Tab, Table, Tabs, TwoFactor, Users } from "./blocks.js";
 import { component } from "./component.js";
+import { mapTree, walkTree } from "./walk.js";
+import { accountBlocks, accountPageName } from "./check-account.js";
+import { settingsFields, settingsResources, withSettingsFields } from "./settings.js";
 import { countedResource, evaluateCondition, parseCondition } from "./condition.js";
-import { walkTree } from "./walk.js";
 import { isPageDefinition, page } from "./page.js";
+import { accountPage, accountTabs } from "./presets/account-page.js";
 import { usersPage } from "./presets/users-page.js";
 import { cardsLayoutOf } from "./cards-layout.js";
 import { resolveFieldPath } from "./field-path.js";
@@ -12,4 +15,4 @@ import { checkPages } from "./check-page.js";
 import { prunePage } from "./prune-page.js";
 import { jsx_runtime_exports } from "./jsx-runtime.js";
 import { fieldRef } from "@protobase/schema";
-export { Action, Card, CardRow, Chart, Field, Grid, Link, ModalForm, Page, Progress, RecordCard, RecordCards, RecordRow, Show, Stat, Table, Users, cardsLayoutOf, checkPages, component, conditionProblems, conditionReadable, countedResource, evaluateCondition, fieldRef, isLayoutNode, isPageDefinition, jsx_runtime_exports as jsxRuntime, page, parseCondition, prunePage, resolveFieldPath, usersPage, walkTree };
+export { Action, Card, CardRow, Chart, ConnectedAccounts, ConnectedApps, Devices, Field, Grid, Link, ModalForm, Page, Passkeys, Password, Profile, Progress, RecordCard, RecordCards, RecordRow, Settings, Show, Stat, Tab, Table, Tabs, TwoFactor, Users, accountBlocks, accountPage, accountPageName, accountTabs, cardsLayoutOf, checkPages, component, conditionProblems, conditionReadable, countedResource, evaluateCondition, fieldRef, isLayoutNode, isPageDefinition, jsx_runtime_exports as jsxRuntime, mapTree, page, parseCondition, prunePage, resolveFieldPath, settingsFields, settingsResources, usersPage, walkTree, withSettingsFields };

package/dist/page.js

@@ -1,3 +1,4 @@
+import { accountBlockProblems } from "./check-account.js";
 import { structureProblems } from "./check-structure.js";
 //#region src/page.ts
 const pageName = /^[a-z][a-zA-Z0-9-]*$/;
@@ -7,7 +8,7 @@ const pageName = /^[a-z][a-zA-Z0-9-]*$/;
 */
 const page = (name, tree, options = {}) => {
 	if (!pageName.test(name)) throw new Error(`Page name "${name}" must start with a lowercase letter and hold only letters, digits and dashes`);
-	const problems = structureProblems(tree);
+	const problems = [...structureProblems(tree), ...accountBlockProblems(name, tree)];
 	if (problems.length > 0) throw new Error(`Page "${name}" is not a valid layout:\n${problems.map((problem) => `  - ${problem}`).join("\n")}`);
 	const model = {
 		name,

package/dist/presets/account-page.d.ts

@@ -0,0 +1,20 @@
+import { LayoutNode } from "../node.js";
+import { PageDefinition } from "../page.js";
+import "../index.js";
+//#region src/presets/account-page.d.ts
+/**
+ * The standard tabs of the account page, by name, for an account page of the app's own: list the ones to keep, in
+ * the order to show them, beside tabs of its own. Written as calls rather than JSX, as `usersPage` is.
+ */
+export declare const accountTabs: {
+  profile: LayoutNode;
+  security: LayoutNode;
+  devices: LayoutNode;
+  apps: LayoutNode;
+};
+/**
+ * The account page everyone signed in has at `/-/account`, each tab below it (`/-/account/security`). The server
+ * serves it when the config exports no page named `account`; exporting one replaces it.
+ */
+export declare const accountPage: PageDefinition;
+//#endregion

package/dist/presets/account-page.js

@@ -0,0 +1,45 @@
+import { ConnectedAccounts, ConnectedApps, Devices, Page, Passkeys, Password, Profile, Tab, Tabs, TwoFactor } from "../blocks.js";
+import { accountPageName } from "../check-account.js";
+import { page } from "../page.js";
+//#region src/presets/account-page.ts
+/**
+* The standard tabs of the account page, by name, for an account page of the app's own: list the ones to keep, in
+* the order to show them, beside tabs of its own. Written as calls rather than JSX, as `usersPage` is.
+*/
+const accountTabs = {
+	profile: Tab({
+		name: "profile",
+		label: "Profile",
+		children: [Profile({})]
+	}),
+	security: Tab({
+		name: "security",
+		label: "Sign-in & security",
+		children: [
+			Password({}),
+			Passkeys({}),
+			TwoFactor({}),
+			ConnectedAccounts({})
+		]
+	}),
+	devices: Tab({
+		name: "devices",
+		label: "Devices",
+		children: [Devices({})]
+	}),
+	apps: Tab({
+		name: "apps",
+		label: "Connected apps",
+		children: [ConnectedApps({})]
+	})
+};
+/**
+* The account page everyone signed in has at `/-/account`, each tab below it (`/-/account/security`). The server
+* serves it when the config exports no page named `account`; exporting one replaces it.
+*/
+const accountPage = page(accountPageName, Page({
+	title: "Account",
+	children: Tabs({ children: Object.values(accountTabs) })
+}));
+//#endregion
+export { accountPage, accountTabs };

package/dist/prune-page.d.ts

@@ -16,9 +16,9 @@ export type CallerAccess = {
 /**
  * The page as one caller may see it, or `undefined` when its roles leave the caller out. Every element that names a
  * resource, field, filter, sort or action the caller cannot use is left out, with what it contains, custom components
- * by their `resource` and field references (`fieldRef`) too; table columns and form fields are narrowed to what the
- * caller may read and write. Data still comes from the API, which applies
- * the same access rules (row filters included) to every request.
+ * by their `resource` and field references (`fieldRef`) too, and so is a tab left with nothing in it; table columns and
+ * form fields are narrowed to what the caller may read and write. Data still comes from the API, which applies the same
+ * access rules (row filters included) to every request.
  */
 export declare const prunePage: (page: PageModel, roles: readonly string[], access: CallerAccess) => PageModel | undefined;
 //#endregion

package/dist/prune-page.js

@@ -1,6 +1,6 @@
 import { dataProps } from "./node.js";
-import { countedResource, parseCondition } from "./condition.js";
 import { mapTree } from "./walk.js";
+import { countedResource, parseCondition } from "./condition.js";
 import { chartFields } from "./check-chart.js";
 import { resolveFieldPath } from "./field-path.js";
 import { elementResource, linkSource } from "./check-page.js";
@@ -80,6 +80,17 @@ const prune = (node, scope, access) => {
 				}
 			} : null;
 		}
+		case "Settings": {
+			if (!model) return null;
+			const fields = (node.props.fields ?? []).filter((name) => Object.hasOwn(model.fields, name));
+			return fields.length > 0 ? {
+				...node,
+				props: {
+					...node.props,
+					fields
+				}
+			} : null;
+		}
 		case "Action": return resource !== void 0 && model && access.actions(resource).has(String(node.props.name)) ? node : null;
 		case "Link": return node.props.to === void 0 || addressErrors(node.props.to, {
 			models,
@@ -95,15 +106,17 @@ const prune = (node, scope, access) => {
 				return counted !== void 0 ? Boolean(models[counted]) : readable(name);
 			}) ? node : null;
 		}
+		case "Tab":
+		case "Tabs": return node.children.length > 0 ? node : null;
 		default: return node;
 	}
 };
 /**
 * The page as one caller may see it, or `undefined` when its roles leave the caller out. Every element that names a
 * resource, field, filter, sort or action the caller cannot use is left out, with what it contains, custom components
-* by their `resource` and field references (`fieldRef`) too; table columns and form fields are narrowed to what the
-* caller may read and write. Data still comes from the API, which applies
-* the same access rules (row filters included) to every request.
+* by their `resource` and field references (`fieldRef`) too, and so is a tab left with nothing in it; table columns and
+* form fields are narrowed to what the caller may read and write. Data still comes from the API, which applies the same
+* access rules (row filters included) to every request.
 */
 const prunePage = (page, roles, access) => {
 	if (page.roles && !page.roles.some((role) => roles.includes(role))) return void 0;

package/dist/settings.d.ts

@@ -0,0 +1,10 @@
+import { PageModel } from "./page.js";
+import { ResourceModel } from "@protobase/schema";
+//#region src/settings.d.ts
+/** The fields a `Settings` of `model` shows without `fields`: every one a person can set, in the model's order. */
+export declare const settingsFields: (model: ResourceModel) => string[];
+/** The resources the pages' `Settings` blocks show, which every caller reads and writes only their own records of. */
+export declare const settingsResources: (pages: readonly PageModel[]) => Set<string>;
+/** The page with each `Settings` without `fields` given its default fields, from the full models, before pruning. */
+export declare const withSettingsFields: (page: PageModel, models: Record<string, ResourceModel>) => PageModel;
+//#endregion

package/dist/settings.js

@@ -0,0 +1,65 @@
+import { mapTree, walkTree } from "./walk.js";
+//#region src/settings.ts
+const setBySystem = (model) => /* @__PURE__ */ new Set([
+	...model.primaryKey,
+	model.owner,
+	model.tenant,
+	model.softDelete,
+	model.position?.field
+]);
+/** The fields a `Settings` of `model` shows without `fields`: every one a person can set, in the model's order. */
+const settingsFields = (model) => {
+	const system = setBySystem(model);
+	return Object.entries(model.fields).filter(([name, field]) => !system.has(name) && !field.readOnly && !field.sensitive && !field.file).map(([name]) => name);
+};
+/**
+* What keeps `model` from holding settings: an owner that is its whole key, so each person has one record, and no
+* tenant, as settings are personal; and the `fields` it names.
+*/
+const settingsProblems = (model, fields) => {
+	const { name, owner, primaryKey, tenant } = model;
+	if (owner === void 0) return [`${name} has no .owner(...), so its records are not each person's own`];
+	const problems = [];
+	if (primaryKey.length !== 1 || primaryKey[0] !== owner) problems.push(`the owner "${owner}" must be the key of ${name}, so each person has one record: .primaryKey((r) => r.${owner})`);
+	if (tenant !== void 0) problems.push(`${name} has a tenant, and settings are each person's own: leave out .tenant()`);
+	if (fields === void 0) {
+		if (settingsFields(model).length === 0) problems.push(`${name} has no field a person can set`);
+		return problems;
+	}
+	const system = setBySystem(model);
+	for (const field of fields) {
+		const found = Object.hasOwn(model.fields, field) ? model.fields[field] : void 0;
+		if (!found) problems.push(`unknown field "${field}" on ${name}`);
+		else if (system.has(field)) problems.push(`"${field}" is set by the server on ${name}, so it is no setting`);
+		else if (found.sensitive) problems.push(`"${field}" is sensitive, and Settings does not show sensitive fields`);
+		else if (found.file) problems.push(`"${field}" is a file, and Settings does not upload files`);
+	}
+	return problems;
+};
+const isSettings = (node) => !node.custom && node.type === "Settings" && typeof node.props.resource === "string";
+/** The resources the pages' `Settings` blocks show, which every caller reads and writes only their own records of. */
+const settingsResources = (pages) => {
+	const found = /* @__PURE__ */ new Set();
+	for (const page of pages) walkTree(page.tree, (node) => void (isSettings(node) && found.add(String(node.props.resource))));
+	return found;
+};
+/** The page with each `Settings` without `fields` given its default fields, from the full models, before pruning. */
+const withSettingsFields = (page, models) => {
+	const tree = mapTree(page.tree, (node) => {
+		if (!isSettings(node) || node.props.fields !== void 0) return node;
+		const model = models[String(node.props.resource)];
+		return model ? {
+			...node,
+			props: {
+				...node.props,
+				fields: settingsFields(model)
+			}
+		} : node;
+	});
+	return {
+		...page,
+		tree
+	};
+};
+//#endregion
+export { settingsFields, settingsProblems, settingsResources, withSettingsFields };

package/dist/walk.d.ts

@@ -9,6 +9,11 @@ export type Location = {
   path: string;
   scope: Scope;
 };
+/**
+ * Rebuilds the tree bottom-up through `visit`, which sees each element (with its children and element props already
+ * rebuilt) and returns it, a replacement, or `null` to leave it out. Text children are kept as they are.
+ */
+export declare const mapTree: (node: LayoutNode, visit: (node: LayoutNode, at: Location) => LayoutNode | null, at?: Location) => LayoutNode | null;
 /** Calls `visit` for every element, parents first. */
 export declare const walkTree: (node: LayoutNode, visit: (node: LayoutNode, at: Location) => void, at?: Location) => void;
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protobase/layout",
-  "version": "0.46.2",
+  "version": "0.46.4",
   "description": "Composed pages for Protobase, written as JSX that compiles to plain data, with its JSX runtime.",
   "license": "Apache-2.0",
   "repository": {
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@protobase/schema": "0.46.2",
+    "@protobase/schema": "0.46.4",
     "aip-parsers": "^1.0.0"
   }
 }