@protobase/schema 0.68.0 → 0.68.2

package/dist/address-errors.d.ts

@@ -11,7 +11,8 @@ export type AddressCheck = {
   createPages?: ReadonlySet<string>;
 };
 /**
- * What is wrong with a link's address against these models: an unknown resource or page, a `{field}` the record it sits
+ * What is wrong with a link's address against these models: an unknown resource or page, a filter, order or values
+ * beside a resource taken from the record (`'{field}'`), a `{field}` the record it sits
  * on does not have, a filter or order naming fields the resource does not have, or create values for fields it does not
  * have, unless its view opens a create page, which reads them. Empty when it can be followed.
  */

package/dist/address-errors.js

@@ -1,4 +1,4 @@
-import { addressPlaceholders } from "./address-template.js";
+import { addressPlaceholders, resourceField } from "./address-template.js";
 import { parseFilter } from "./filter/parse.js";
 import { checkFilter } from "./filter/check.js";
 import { checkOrderBy, parseOrderBy } from "./filter/order-by.js";
@@ -30,7 +30,8 @@ const orderErrors = (model, orderBy) => {
 	return checked.ok ? [] : checked.errors.map((error) => `orderBy: ${error.message}`);
 };
 /**
-* What is wrong with a link's address against these models: an unknown resource or page, a `{field}` the record it sits
+* What is wrong with a link's address against these models: an unknown resource or page, a filter, order or values
+* beside a resource taken from the record (`'{field}'`), a `{field}` the record it sits
 * on does not have, a filter or order naming fields the resource does not have, or create values for fields it does not
 * have, unless its view opens a create page, which reads them. Empty when it can be followed.
 */
@@ -39,6 +40,7 @@ const addressErrors = (to, { models, pages, source, createPages }) => {
 		if (!source) return [`"{${name}}" takes a value from the record, but the link sits on none`];
 		return Object.hasOwn(source.fields, name) ? [] : [`"{${name}}" is not a field of ${source.name}`];
 	});
+	if (to.kind !== "page" && resourceField(to) !== void 0) return (to.kind === "list" ? to.filter !== void 0 || to.orderBy !== void 0 : to.kind === "create" && to.values !== void 0) ? [...placeholders, `a link whose resource comes from the record ("${to.resource}") names no filter, order or values`] : placeholders;
 	switch (to.kind) {
 		case "page": return pages && !pages.has(to.page) ? [`unknown page "${to.page}"`] : [];
 		case "list":

package/dist/address-template.d.ts

@@ -1,10 +1,12 @@
 import { AppAddress } from "./model.js";
 //#region src/address-template.d.ts
+/** The field a link's address takes its resource from, when its `resource` is only `{field}`, as `'{name}'`. */
+export declare const resourceField: (to: AppAddress) => string | undefined;
 /** The fields whose values a link's address takes from the record, from its `{field}` placeholders. */
 export declare const addressPlaceholders: (to: AppAddress) => string[];
 /** The fields an href takes from the record, from its `{field}` placeholders. */
 export declare const hrefPlaceholders: (href: string) => string[];
-/** `to` with every `{field}` in its key, filter, order or values replaced by the record's value; a missing value becomes empty. */
+/** `to` with every `{field}` in its resource, key, filter, order or values replaced by the record's value; a missing value becomes empty. */
 export declare const fillAddress: (to: AppAddress, record?: Record<string, unknown>) => AppAddress;
 /**
  * Whether an href leaves the app: it starts with a scheme (`https:`, `mailto:`) or `//`. A path inside the app is an

package/dist/address-template.js

@@ -1,33 +1,40 @@
 //#region src/address-template.ts
 const placeholder = /\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
 const names = (text) => [...text.matchAll(placeholder)].map((match) => match[1]);
+/** The field a link's address takes its resource from, when its `resource` is only `{field}`, as `'{name}'`. */
+const resourceField = (to) => to.kind === "page" ? void 0 : /^\{([A-Za-z_][A-Za-z0-9_]*)\}$/.exec(to.resource)?.[1];
 const templated = (to) => {
-	if (to.kind === "record") return (Array.isArray(to.key) ? to.key : [to.key]).filter((part) => typeof part === "string");
-	if (to.kind === "list") return [to.filter, to.orderBy].filter((part) => part !== void 0);
-	if (to.kind === "create") return Object.values(to.values ?? {});
-	return [];
+	if (to.kind === "page") return [];
+	const resource = resourceField(to) === void 0 ? [] : [to.resource];
+	if (to.kind === "record") return [...resource, ...(Array.isArray(to.key) ? to.key : [to.key]).filter((part) => typeof part === "string")];
+	if (to.kind === "list") return [...resource, ...[to.filter, to.orderBy].filter((part) => part !== void 0)];
+	return [...resource, ...Object.values(to.values ?? {})];
 };
 /** The fields whose values a link's address takes from the record, from its `{field}` placeholders. */
 const addressPlaceholders = (to) => [...new Set(templated(to).flatMap(names))];
 /** The fields an href takes from the record, from its `{field}` placeholders. */
 const hrefPlaceholders = (href) => [...new Set(names(href))];
 const fill = (text, record) => text.replace(placeholder, (_, name) => record[name] === null || record[name] === void 0 ? "" : String(record[name]));
-/** `to` with every `{field}` in its key, filter, order or values replaced by the record's value; a missing value becomes empty. */
+/** `to` with every `{field}` in its resource, key, filter, order or values replaced by the record's value; a missing value becomes empty. */
 const fillAddress = (to, record = {}) => {
+	if (to.kind === "page") return to;
+	const resource = resourceField(to) === void 0 ? to.resource : fill(to.resource, record);
 	if (to.kind === "record") {
 		const part = (value) => typeof value === "string" ? fill(value, record) : value;
 		return {
 			...to,
+			resource,
 			key: Array.isArray(to.key) ? to.key.map(part) : part(to.key)
 		};
 	}
-	if (to.kind === "create") return to.values ? {
+	if (to.kind === "create") return {
 		...to,
-		values: Object.fromEntries(Object.entries(to.values).map(([name, value]) => [name, fill(value, record)]))
-	} : to;
-	if (to.kind !== "list") return to;
+		resource,
+		...to.values && { values: Object.fromEntries(Object.entries(to.values).map(([name, value]) => [name, fill(value, record)])) }
+	};
 	return {
 		...to,
+		resource,
 		...to.filter !== void 0 && { filter: fill(to.filter, record) },
 		...to.orderBy !== void 0 && { orderBy: fill(to.orderBy, record) }
 	};
@@ -50,4 +57,4 @@ const linkActionError = (label, run) => {
 	return label.includes("{host}") ? "the label names {host}, which only a link with an href has" : void 0;
 };
 //#endregion
-export { addressPlaceholders, appHrefError, fillAddress, hrefField, hrefPlaceholders, leavesApp, linkActionError };
+export { addressPlaceholders, appHrefError, fillAddress, hrefField, hrefPlaceholders, leavesApp, linkActionError, resourceField };

package/dist/internal.d.ts

@@ -19,7 +19,7 @@ import { PluginHost, PluginRequirement, inRange, pluginProblem } from "./plugin-
 import { redactSecrets } from "./redact-secrets.js";
 import { firstPartyCodeKey } from "./first-party-code.js";
 import { updateSetErrors, updateValues } from "./update-set.js";
-import { addressPlaceholders, appHrefError, fillAddress, hrefField, hrefPlaceholders, leavesApp, linkActionError } from "./address-template.js";
+import { addressPlaceholders, appHrefError, fillAddress, hrefField, hrefPlaceholders, leavesApp, linkActionError, resourceField } from "./address-template.js";
 import { promptError, promptFields, renderPrompt } from "./ai-prompt.js";
 import { FormulaNode, parseFormula } from "./computed/formula.js";
 import { AddressCheck, addressErrors } from "./address-errors.js";
@@ -45,4 +45,4 @@ import { builtInFieldTypes } from "./built-in-field-types.js";
 import { CallCandidate, CallClientMessage, CallDescription, CallGuestLink, CallGuestRefusal, CallGuestState, CallLeftReason, CallLobbyGuest, CallMode, CallRemoteTrack, CallResume, CallRosterMember, CallServerMessage, CallTrackRequest, CallTrackSource, CallVideoLayer } from "./calls/call-protocol.js";
 import { guestCallsPath } from "./calls/call-guests.js";
 import { CallRing, callsChannelEvent, declineWord, ringNotice, ringsPath } from "./calls/call-rings.js";
-export { type AddressCheck, type Availability, type CallCandidate, type CallClientMessage, type CallDescription, type CallGuestLink, type CallGuestRefusal, type CallGuestState, type CallLeftReason, type CallLobbyGuest, type CallMode, type CallRemoteTrack, type CallResume, type CallRing, type CallRosterMember, type CallServerMessage, type CallTrackRequest, type CallTrackSource, type CallVideoLayer, type FormulaNode, type Locale, type MobileReleaseAnswer, type PersonStatus, type PluginHost, type PluginRequirement, type PropShapes, type RefShape, type ReleaseBinding, type SearchTerm, type StatusInput, type WorkflowTypeEntry, type WorkflowTypeList, actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, availabilities, boardErrors, bottomBarFor, builtInFieldTypes, callsChannelEvent, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, confirmationMinutes, datesErrors, declineWord, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emailCodeMinutes, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, firstPartyCodeKey, guestCallsPath, heldStatus, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, maxStatusText, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, releaseStatementContext, releaseStatementFile, renderPrompt, ringNotice, ringsPath, searchTerms, serviceWorkerFile, shapes, shownInputs, statusPath, statusTextProblem, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources, workflowResources, workflowTypesPath };
+export { type AddressCheck, type Availability, type CallCandidate, type CallClientMessage, type CallDescription, type CallGuestLink, type CallGuestRefusal, type CallGuestState, type CallLeftReason, type CallLobbyGuest, type CallMode, type CallRemoteTrack, type CallResume, type CallRing, type CallRosterMember, type CallServerMessage, type CallTrackRequest, type CallTrackSource, type CallVideoLayer, type FormulaNode, type Locale, type MobileReleaseAnswer, type PersonStatus, type PluginHost, type PluginRequirement, type PropShapes, type RefShape, type ReleaseBinding, type SearchTerm, type StatusInput, type WorkflowTypeEntry, type WorkflowTypeList, actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, availabilities, boardErrors, bottomBarFor, builtInFieldTypes, callsChannelEvent, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, confirmationMinutes, datesErrors, declineWord, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emailCodeMinutes, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, firstPartyCodeKey, guestCallsPath, heldStatus, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, maxStatusText, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, releaseStatementContext, releaseStatementFile, renderPrompt, resourceField, ringNotice, ringsPath, searchTerms, serviceWorkerFile, shapes, shownInputs, statusPath, statusTextProblem, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources, workflowResources, workflowTypesPath };

package/dist/internal.js

@@ -1,4 +1,4 @@
-import { addressPlaceholders, appHrefError, fillAddress, hrefField, hrefPlaceholders, leavesApp, linkActionError } from "./address-template.js";
+import { addressPlaceholders, appHrefError, fillAddress, hrefField, hrefPlaceholders, leavesApp, linkActionError, resourceField } from "./address-template.js";
 import { promptError, promptFields, renderPrompt } from "./ai-prompt.js";
 import { parseFormula } from "./computed/formula.js";
 import { checkedAccept, checkedProvider, parseSize } from "./files/file-options.js";
@@ -44,4 +44,4 @@ import { listColumnNames } from "./list-columns.js";
 import { builtInFieldTypes } from "./built-in-field-types.js";
 import { guestCallsPath } from "./calls/call-guests.js";
 import { callsChannelEvent, declineWord, ringNotice, ringsPath } from "./calls/call-rings.js";
-export { actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, availabilities, boardErrors, bottomBarFor, builtInFieldTypes, callsChannelEvent, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, confirmationMinutes, datesErrors, declineWord, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emailCodeMinutes, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, firstPartyCodeKey, guestCallsPath, heldStatus, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, maxStatusText, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, releaseStatementContext, releaseStatementFile, renderPrompt, ringNotice, ringsPath, searchTerms, serviceWorkerFile, shapes, shownInputs, statusPath, statusTextProblem, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources, workflowResources, workflowTypesPath };
+export { actionConditionError, actionInputErrors, addressErrors, addressPlaceholders, apiOriginMeta, appHrefError, applyAssistantEvent, authBasePath, availabilities, boardErrors, bottomBarFor, builtInFieldTypes, callsChannelEvent, capacitorOrigin, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, confirmationMinutes, datesErrors, declineWord, decodeKey, defaultRecentLimit, deviceIdParam, devicesPath, displayFields, emailCodeMinutes, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, firstPartyCodeKey, guestCallsPath, heldStatus, historyIdParam, historyIdPattern, historyPath, hrefField, hrefPlaceholders, humanize, inRange, isFieldRef, isGroupChart, isLocale, labelFieldOf, layoutItems, leavesApp, linkActionError, listColumnNames, locales, markFieldRefs, matchedSearchField, matchesSearch, maxStatusText, mobileReleaseBasePath, mobileReleaseParams, mobileReleasePath, mobileReleaseQuery, mobileReleasesPath, navRecentErrors, parseCapability, parseFormula, parseSize, parseTable, pickLocale, pluginProblem, promptError, promptFields, pruneByShape, pushRecord, readEventStream, recordTitle, recordTitleField, redactSecrets, releaseManifestFile, releaseStatementContext, releaseStatementFile, renderPrompt, resourceField, ringNotice, ringsPath, searchTerms, serviceWorkerFile, shapes, shownInputs, statusPath, statusTextProblem, statusTones, tableDisplay, termMatches, unmarkFieldRefs, updateSetErrors, updateValues, viewOfList, webhookResources, workflowResources, workflowTypesPath };

package/dist/model.d.ts

@@ -317,6 +317,8 @@ export type FieldViewModel = {
   helpWhen?: HelpWhen;
   /** When the field shows on the record page: always, the default, only on its form or only on its read view. */
   when?: ShowWhen;
+  /** Left off the create form, so a create leaves it empty or to its default; the server refuses it on a field a create needs. */
+  notOnCreate?: true;
   /** The question a form or a list cell asks before the field's value first changes; cancelling keeps the value. */
   confirm?: string;
   /** How the value is shown. */
@@ -1157,6 +1159,8 @@ export type NavRecentModel = {
 export type NavModel = {
   /** Hide the resource from the sidebar, for line or link tables. */
   hidden?: boolean;
+  /** Show the entry only to whoever the list offers New, for a list that is there to make records, such as the tables users add. */
+  creatorsOnly?: true;
   /** The sidebar group it sits in; its database schema when omitted. */
   group?: string;
   /** Where it sorts within its group. */

package/dist/view-field.d.ts

@@ -27,6 +27,12 @@ export declare class FieldView<N extends string = string, V = unknown> {
    * view and locked form; `always` when omitted. Its lists, cards and filters show it either way.
    */
   when(when: ShowWhen): FieldView<N, V>;
+  /**
+   * Leaves the field off the create form, for one that makes sense only once the record exists, such as a choice among
+   * records added after it; the create leaves it empty or to its default, and the record page shows it as usual. The
+   * server stops at startup on a field a create needs: not optional and with no default.
+   */
+  notOnCreate(): FieldView<N, V>;
   /**
    * Asks `question` before a person changes the value in a form or a list cell, such as a flag that is easy to set by
    * mistake: once as the value first moves away from the saved one, not on every key. Cancelling keeps the value. See

package/dist/view-field.js

@@ -33,6 +33,14 @@ var FieldView = class FieldView {
 		return this.with({ when });
 	}
 	/**
+	* Leaves the field off the create form, for one that makes sense only once the record exists, such as a choice among
+	* records added after it; the create leaves it empty or to its default, and the record page shows it as usual. The
+	* server stops at startup on a field a create needs: not optional and with no default.
+	*/
+	notOnCreate() {
+		return this.with({ notOnCreate: true });
+	}
+	/**
 	* Asks `question` before a person changes the value in a form or a list cell, such as a flag that is easy to set by
 	* mistake: once as the value first moves away from the saved one, not on every key. Cancelling keeps the value. See
 	* [Confirming a change](docs/website/src/content/docs/reference/ui-config.mdx#confirming-a-change).

package/package.json

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