@protobase/schema 0.21.6 → 0.21.8

package/dist/access/role-entry.js

@@ -33,10 +33,10 @@ const limited = (role, capability, limit) => {
 const checkAnonymous = (held) => {
 	for (const { capability, fields } of held) {
 		const { name, action, scope } = parseCapability(capability);
-		if (action !== "read") throw new Error(`The anonymous role may only read, but it grants "${capability}"`);
-		if (name === "*") throw new Error(`The anonymous role must name each resource it reads, not "${capability}"`);
+		if (action !== "read" && action !== "create") throw new Error(`The anonymous role may only read, or create through a public form, but it grants "${capability}"`);
+		if (name === "*") throw new Error(`The anonymous role must name each resource it ${action}s, not "${capability}"`);
 		if (scope !== void 0) throw new Error(`The anonymous role grants "${capability}", but an anonymous caller owns no rows`);
-		if (!fields) throw new Error(`The anonymous role must list the fields it reads: { '${capability}': ['name', ...] }`);
+		if (!fields) throw new Error(`The anonymous role must list the fields it ${action}s: { '${capability}': ['name', ...] }`);
 	}
 };
 /** A role's entries as the capabilities it holds; throws on anything that is not a capability or a valid limit. */

package/dist/access/roles.d.ts

@@ -22,7 +22,8 @@ export type RoleLimit = HeldCapability & {
  *
  * An entry may limit capabilities to fields (an allowlist) and rows (an AIP-160 filter):
  * `{ 'products.read': ['sku', 'price'] }`, `{ 'products.read': { fields: ['name'], filter: 'published = true' } }`.
- * The role `anonymous`, when defined, is what requests without a token act as; it may only read listed fields.
+ * The role `anonymous`, when defined, is what requests without a token act as; it may only read listed fields, and
+ * create listed fields through a public form.
  * See [Access](website/src/content/docs/reference/access.mdx#capabilities).
  *
  * @example

package/dist/access/roles.js

@@ -11,7 +11,8 @@ const rolesOf = (user) => user.roles ?? [];
 *
 * An entry may limit capabilities to fields (an allowlist) and rows (an AIP-160 filter):
 * `{ 'products.read': ['sku', 'price'] }`, `{ 'products.read': { fields: ['name'], filter: 'published = true' } }`.
-* The role `anonymous`, when defined, is what requests without a token act as; it may only read listed fields.
+* The role `anonymous`, when defined, is what requests without a token act as; it may only read listed fields, and
+* create listed fields through a public form.
 * See [Access](website/src/content/docs/reference/access.mdx#capabilities).
 *
 * @example

package/dist/address-errors.js

@@ -1,7 +1,7 @@
+import { addressPlaceholders } from "./address-template.js";
 import { parseFilter } from "./filter/parse.js";
 import { checkFilter } from "./filter/check.js";
 import { checkOrderBy, parseOrderBy } from "./filter/order-by.js";
-import { addressPlaceholders } from "./address-template.js";
 //#region src/address-errors.ts
 const nameErrors = [
 	"unknown-field",

package/dist/ai-prompt.d.ts

@@ -0,0 +1,8 @@
+//#region src/ai-prompt.d.ts
+/** The fields an AI prompt reads from the record, from its `{field}` placeholders. */
+export declare const promptFields: (prompt: string) => string[];
+/** `prompt` with every `{field}` replaced by the record's value as text; a missing value becomes empty, json as JSON. */
+export declare const renderPrompt: (prompt: string, record: Record<string, unknown>) => string;
+/** Why a prompt cannot be an AI field's or action's: it reads no field of the record. */
+export declare const promptError: (prompt: string) => "its prompt must name at least one {field} of the record" | undefined;
+//#endregion

package/dist/ai-prompt.js

@@ -0,0 +1,17 @@
+import { hrefPlaceholders } from "./address-template.js";
+//#region src/ai-prompt.ts
+const placeholder = /\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
+/** The fields an AI prompt reads from the record, from its `{field}` placeholders. */
+const promptFields = (prompt) => hrefPlaceholders(prompt);
+const asText = (value) => {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return String(value);
+	return JSON.stringify(value);
+};
+/** `prompt` with every `{field}` replaced by the record's value as text; a missing value becomes empty, json as JSON. */
+const renderPrompt = (prompt, record) => prompt.replace(placeholder, (_, name) => asText(record[name]));
+/** Why a prompt cannot be an AI field's or action's: it reads no field of the record. */
+const promptError = (prompt) => promptFields(prompt).length === 0 ? "its prompt must name at least one {field} of the record" : void 0;
+//#endregion
+export { promptError, promptFields, renderPrompt };

package/dist/app-address.d.ts

@@ -15,6 +15,8 @@ export declare const addressWords: {
   readonly filterLayout: "layout";
   /** Where a list's map display looks: `latitude,longitude,zoom`. */
   readonly map: "map";
+  /** The month or week a list's calendar display shows: `month,YYYY-MM-DD` or `week,YYYY-MM-DD`. */
+  readonly calendar: "calendar";
   /** The saved search a list was opened from, by its key. */
   readonly savedSearch: "saved_search";
   /** The second path segment that opens a resource's create form instead of a record. */

package/dist/app-address.js

@@ -15,6 +15,8 @@ const addressWords = {
 	filterLayout: "layout",
 	/** Where a list's map display looks: `latitude,longitude,zoom`. */
 	map: "map",
+	/** The month or week a list's calendar display shows: `month,YYYY-MM-DD` or `week,YYYY-MM-DD`. */
+	calendar: "calendar",
 	/** The saved search a list was opened from, by its key. */
 	savedSearch: "saved_search",
 	/** The second path segment that opens a resource's create form instead of a record. */
@@ -41,6 +43,23 @@ const readMap = (text) => {
 		zoom
 	} : void 0;
 };
+const calendarText = (view) => `${view.scale},${view.day}`;
+const isDay = (text) => {
+	const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(text);
+	if (!match) return false;
+	const [year, month, day] = match.slice(1).map(Number);
+	const date = new Date(Date.UTC(year, month - 1, day));
+	return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+};
+const readCalendar = (text) => {
+	const parts = text?.split(",");
+	if (parts?.length !== 2) return void 0;
+	const [scale, day] = parts;
+	return (scale === "month" || scale === "week") && isDay(day) ? {
+		scale,
+		day
+	} : void 0;
+};
 const listQuery = (address) => {
 	const query = new URLSearchParams();
 	for (const name of listWords) {
@@ -48,6 +67,7 @@ const listQuery = (address) => {
 		if (value !== void 0 && value !== "") query.set(addressWords[name], value);
 	}
 	if (address.map) query.set(addressWords.map, mapText(address.map));
+	if (address.calendar) query.set(addressWords.calendar, calendarText(address.calendar));
 	const text = query.toString();
 	return text ? `?${text}` : "";
 };
@@ -107,6 +127,7 @@ const readAppPath = (pathAndQuery, pages) => {
 	const orderBy = params.get(addressWords.orderBy) || void 0;
 	const layout = filterLayout(params.get(addressWords.filterLayout));
 	const map = readMap(params.get(addressWords.map));
+	const calendar = readCalendar(params.get(addressWords.calendar));
 	const savedSearch = params.get(addressWords.savedSearch) || void 0;
 	return {
 		kind: "list",
@@ -116,6 +137,7 @@ const readAppPath = (pathAndQuery, pages) => {
 		...orderBy && { orderBy },
 		...layout && { filterLayout: layout },
 		...map && { map },
+		...calendar && { calendar },
 		...savedSearch && { savedSearch }
 	};
 };

package/dist/field.d.ts

@@ -57,6 +57,11 @@ export type FieldMeta = {
   };
   /** A file field's settings (`f.file()`). */
   file?: FileOptions;
+  /** How a job fills it (`.ai()`). */
+  ai?: {
+    /** The prompt the job fills it from. */
+    prompt: string;
+  };
 };
 /** A field type: its name, the constraints it takes and how it builds the schema that checks a value. */
 export type FieldTypeDef = {
@@ -115,6 +120,13 @@ export declare class Field<V> {
   min(value: number): Field<V>;
   /** The greatest value of an integer, or the longest length of a text. Only `f.integer()` and `f.text()` take it. */
   max(value: number): Field<V>;
+  /**
+   * A job fills the field from `prompt`, `{field}` replaced by the record's values, after a create, and after an update
+   * that changes a field the prompt names, as the user who wrote; see [AI fields and actions](website/src/content/docs/reference/ai.mdx).
+   */
+  ai(o: {
+    prompt: string;
+  }): Field<V>;
   /** A copy of the field with `patch` applied, which every option returns. */
   protected with(patch: Partial<FieldMeta>): Field<V>;
   private constrain;

package/dist/field.js

@@ -1,3 +1,4 @@
+import { promptError } from "./ai-prompt.js";
 import { z } from "zod";
 //#region src/field.ts
 const fieldRegistry = z.registry();
@@ -85,6 +86,15 @@ var Field = class Field {
 	max(value) {
 		return this.constrain("max", { max: value });
 	}
+	/**
+	* A job fills the field from `prompt`, `{field}` replaced by the record's values, after a create, and after an update
+	* that changes a field the prompt names, as the user who wrote; see [AI fields and actions](website/src/content/docs/reference/ai.mdx).
+	*/
+	ai(o) {
+		const error = promptError(o.prompt);
+		if (error) throw new Error(`.ai(): ${error}`);
+		return this.with({ ai: { prompt: o.prompt } });
+	}
 	/** A copy of the field with `patch` applied, which every option returns. */
 	with(patch) {
 		return new Field(this.def, {

package/dist/form-address.d.ts

@@ -0,0 +1,13 @@
+//#region src/form-address.d.ts
+/** The path of the public forms, below the app's base path: a form is at `/-/forms/<name>`. */
+export declare const formRoute = "/-/forms";
+/** Where a public form is: the form's name. */
+export type FormAddress = {
+  /** The form's name, as `.form(...)` gives it. */
+  name: string;
+};
+/** The path below the base path of the public form `name`. */
+export declare const formPath: (name: string) => string;
+/** The public form the path below the base path shows; `undefined` for any other path. */
+export declare const readFormAddress: (path: string) => FormAddress | undefined;
+//#endregion

package/dist/form-address.js

@@ -0,0 +1,15 @@
+//#region src/form-address.ts
+/** The path of the public forms, below the app's base path: a form is at `/-/forms/<name>`. */
+const formRoute = "/-/forms";
+/** What a form's name may hold, since it is its address: lowercase letters, digits, `-` and `_`. */
+const formNamePattern = /^[a-z0-9][a-z0-9_-]*$/;
+/** The path below the base path of the public form `name`. */
+const formPath = (name) => `${formRoute}/${name}`;
+/** The public form the path below the base path shows; `undefined` for any other path. */
+const readFormAddress = (path) => {
+	if (!path.startsWith(`/-/forms/`)) return void 0;
+	const name = path.slice(9);
+	return formNamePattern.test(name) ? { name } : void 0;
+};
+//#endregion
+export { formNamePattern, formPath, formRoute, readFormAddress };

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, CardFavoriteModel, CardPhotosModel, ChartGranularity, ChartModel, ChartRange, CheckedFilter, CompareOp, CreateModel, CustomSectionModel, DatePreset, DurationLiteral, DurationUnit, EventModel, EventOperation, ExportModel, FieldFormat, FieldModel, FieldPath, FieldType, FieldViewModel, FieldWidgetModel, FileFieldModel, FilterError, FilterErrorCode, FilterExpr, FilterLayout, FilterOf, FilterValue, FilterWidgetModel, 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, 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 { 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";
@@ -10,6 +10,7 @@ import { CreatedOptions, DeletedOptions, EventActor, EventContext, EventHelpers,
 import { Access, InferRecord, Issue, KeyOf, KeyRefs, RecordKey, RecordOf } from "./resource-types.js";
 import { ResourceBuilder, SearchRef, SearchRefs, Validator, resource } from "./resource.js";
 import { ChartInput, GroupChartInput, PeriodChartInput } from "./view-chart.js";
+import { FormInput } from "./view-form.js";
 import { ListColumn } from "./view-columns.js";
 import { ComponentRef, ViewProps } from "./view-displays.js";
 import { FieldView } from "./view-field.js";
@@ -22,6 +23,7 @@ import { BottomBarNames, bottomBarErrors } from "./bottom-bar-errors.js";
 import { layout } from "./layout.js";
 import { KeyType, fitsKeyType, keyTypes } from "./keys.js";
 import { addressWords, appPath, readAppPath } from "./app-address.js";
+import { FormAddress, formPath, formRoute, readFormAddress } from "./form-address.js";
 import { SignInAddress, SignInStep, readSignInAddress, signInParams, signInPath, signInRoute, signInSteps } from "./sign-in-address.js";
 import { FilterLimits, FilterParse, parseFilter } from "./filter/parse.js";
 import { CheckResult, checkFilter } from "./filter/check.js";
@@ -39,4 +41,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 Capability, type CapabilityAction, type CapabilityLimit, type CapabilityScope, type CardFavoriteModel, type CardPhotosModel, type ChartGranularity, type ChartInput, type ChartModel, type ChartRange, type CheckResult, type CheckedFilter, 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 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, imageFormats, keyTypes, layout as l, maxBottomBarItems, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, 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 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 };

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 { formPath, formRoute, readFormAddress } from "./form-address.js";
 import { fieldRef } from "./field-ref.js";
 import { view } from "./view.js";
 import { enumLabel } from "./enum-label.js";
@@ -23,4 +24,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, imageFormats, keyTypes, layout as l, maxBottomBarItems, parseFilter, parseOrderBy, pickView, printFilter, printOrderBy, readAppPath, 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, 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

@@ -1,7 +1,7 @@
 import { checkedAccept, checkedProvider, parseSize } from "./files/file-options.js";
 import { actionInputErrors, shownInputs } from "./action-inputs.js";
 import { chartFields, isGroupChart } from "./view-chart.js";
-import { boardErrors, cardPhotoLimit, displayFields, tableDisplay } from "./view-displays.js";
+import { boardErrors, calendarErrors, cardPhotoLimit, displayFields, tableDisplay } from "./view-displays.js";
 import { fieldRefsIn, isFieldRef, markFieldRefs, unmarkFieldRefs } from "./field-ref.js";
 import { bottomBarFor } from "./bottom-bar.js";
 import { decodeKey, encodeKey } from "./keys.js";
@@ -13,7 +13,8 @@ import { defaultRecentLimit, navRecentErrors, statusTones } from "./nav-recent.j
 import { PluginHost, PluginRequirement, inRange, pluginProblem } from "./plugin-version.js";
 import { redactSecrets } from "./redact-secrets.js";
 import { addressPlaceholders, appHrefError, fillAddress, hrefField, hrefPlaceholders, leavesApp, linkActionError } from "./address-template.js";
+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, 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, pruneByShape, readEventStream, redactSecrets, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, webhookResources };
+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 };

package/dist/internal.js

@@ -1,12 +1,13 @@
+import { addressPlaceholders, appHrefError, fillAddress, hrefField, hrefPlaceholders, leavesApp, linkActionError } from "./address-template.js";
+import { promptError, promptFields, renderPrompt } from "./ai-prompt.js";
 import { checkedAccept, checkedProvider, parseSize } from "./files/file-options.js";
 import { matchedSearchField, matchesSearch, searchTerms, termMatches } from "./search-match.js";
 import { checkEventFilter } from "./events/event-models.js";
 import { defaultRecentLimit, navRecentErrors, statusTones } from "./nav-recent.js";
 import { actionInputErrors, shownInputs } from "./action-inputs.js";
-import { addressPlaceholders, appHrefError, fillAddress, hrefField, hrefPlaceholders, leavesApp, linkActionError } from "./address-template.js";
 import { chartFields, isGroupChart } from "./view-chart.js";
 import { fieldRefsIn, isFieldRef, markFieldRefs, unmarkFieldRefs } from "./field-ref.js";
-import { boardErrors, cardPhotoLimit, displayFields, tableDisplay } from "./view-displays.js";
+import { boardErrors, calendarErrors, cardPhotoLimit, displayFields, tableDisplay } from "./view-displays.js";
 import { bottomBarFor } from "./bottom-bar.js";
 import { decodeKey, encodeKey } from "./keys.js";
 import { webhookResources } from "./webhooks/webhook-resources.js";
@@ -16,4 +17,4 @@ 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, 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, pruneByShape, readEventStream, redactSecrets, searchTerms, shapes, shownInputs, statusTones, tableDisplay, termMatches, unmarkFieldRefs, webhookResources };
+export { actionInputErrors, addressErrors, addressPlaceholders, appHrefError, applyAssistantEvent, boardErrors, bottomBarFor, calendarErrors, cardPhotoLimit, chartFields, checkEventFilter, checkedAccept, checkedProvider, decodeKey, defaultRecentLimit, displayFields, emptyAssistantState, encodeKey, fieldRefsIn, fillAddress, hrefField, hrefPlaceholders, inRange, isFieldRef, isGroupChart, 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.d.ts

@@ -73,6 +73,14 @@ export declare const layout: {
     limit?: number;
     when?: ShowWhen;
   }) => LayoutItemModel;
+  /**
+   * The record's comments, oldest first, with who wrote each and when, and a box to write one; `@` mentions someone who
+   * may read the record. Needs `.comments()` on the resource; a view without a layout shows it last by itself. See
+   * [Record comments](website/src/content/docs/reference/comments.mdx).
+   */
+  comments: (title?: string, o?: {
+    when?: ShowWhen;
+  }) => LayoutItemModel;
   /**
    * A component of the project, registered in `protobase.ui.tsx` under its name, drawn where it is listed: in the main
    * column, or in the sidebar with `sidebar: true`. The record page stays around it, with its title, breadcrumbs,

package/dist/layout.js

@@ -94,6 +94,16 @@ const layout = {
 		};
 	},
 	/**
+	* The record's comments, oldest first, with who wrote each and when, and a box to write one; `@` mentions someone who
+	* may read the record. Needs `.comments()` on the resource; a view without a layout shows it last by itself. See
+	* [Record comments](website/src/content/docs/reference/comments.mdx).
+	*/
+	comments: (title = "Comments", o = {}) => ({
+		kind: "comments",
+		title,
+		...o.when !== void 0 && { when: o.when }
+	}),
+	/**
 	* A component of the project, registered in `protobase.ui.tsx` under its name, drawn where it is listed: in the main
 	* column, or in the sidebar with `sidebar: true`. The record page stays around it, with its title, breadcrumbs,
 	* actions and save; the component reads the record with `useLayoutRecord()`.

package/dist/model.d.ts

@@ -44,6 +44,11 @@ export type FieldModel = {
   };
   /** A file field's allowed types (empty: any), largest upload in bytes, provider, and what each upload writes. */
   file?: FileFieldModel;
+  /** A job fills it from the prompt after a create or an update of a field the prompt names (`.ai()`). */
+  ai?: {
+    /** The prompt, with `{field}` placeholders. */
+    prompt: string;
+  };
 };
 /** A file field's settings, as `/meta` gives them; see [Files](website/src/content/docs/reference/files.mdx). */
 export type FileFieldModel = {
@@ -105,6 +110,8 @@ export type ResourceModel = {
   events?: EventModel[];
   /** Whether every change of its records is kept, with who made it (`.history()`). */
   history?: true;
+  /** Whether people who may read its records comment on them (`.comments()`). */
+  comments?: true;
 };
 /** What happened to a record: `delete` and `undelete` include setting and clearing a soft delete field. */
 export type EventOperation = 'create' | 'update' | 'delete' | 'undelete';
@@ -164,11 +171,18 @@ export type MapView = {
   /** MapLibre's zoom, from 0 to 22. */
   zoom: number;
 };
+/** Which month or week a list's calendar display shows: the grid's `scale`, and a UTC day (`YYYY-MM-DD`) in it. */
+export type CalendarView = {
+  /** A month of whole weeks, or one week. */
+  scale: 'month' | 'week';
+  /** A day in the month or week, as `YYYY-MM-DD`. */
+  day: string;
+};
 /**
  * A place in the app: a resource's list, one of its records, its create form, or a composed page. A record's `key` is
  * its one value or its parts, as the record API takes them; `readAppPath` gives it back as the API's text form. A create
  * form's `values` fill in fields of the new record by name, as text (`{ listing_id: '42' }`). A list's `map` is where its
- * map display looks. See [Addresses](website/src/content/docs/reference/layouts.md#addresses).
+ * map display looks, and its `calendar` the month or week its calendar display shows. See [Addresses](website/src/content/docs/reference/layouts.md#addresses).
  */
 export type AppAddress = {
   /** A resource's list. */
@@ -185,6 +199,8 @@ export type AppAddress = {
   filterLayout?: FilterLayout;
   /** Where its map display looks. */
   map?: MapView;
+  /** The month or week its calendar display shows. */
+  calendar?: CalendarView;
   /**
    * The saved search the list was opened from, by its key in the text form the record API takes: while the list's
    * filter differs from the search's, the list offers to update the search.
@@ -365,6 +381,21 @@ export type ListDisplayModel = {
   badge?: string;
   /** A few small fields, such as dates, each shown when it has a value. */
   meta?: string[];
+} | {
+  /** The records on the days they cover, in a month grid or a week grid, moved to another day by dragging. */
+  kind: 'calendar';
+  /** What the address names (`?display=calendar`). */
+  name: string;
+  /** The display's name in the switch. */
+  label?: string;
+  /** The display's icon in the switch. */
+  icon?: string;
+  /** The filterable date or timestamp field a record starts on. */
+  start: string;
+  /** The filterable field of `start`'s type a record ends on; a record is on its start day alone when omitted. */
+  end?: string;
+  /** The event's text; the view's title when omitted. */
+  title?: string;
 } | {
   /** The rows drawn by a project component. */
   kind: 'custom';
@@ -597,6 +628,11 @@ export type RelatedModel = {
   sort?: string;
   /** Fields of `resource`, through relations too (`unitId.propertyId`). */
   columns?: string[];
+  /**
+   * The relation field of `resource` whose record a row opens, for rows that are links between this record and another
+   * (a join resource); by default the one relation in `resource`'s primary key besides `field`, when there is exactly one.
+   */
+  open?: string;
   /** How many records it shows, the first in `sort` order; with more, it says so ("The first 10 of 37.") beside "View all", which opens the rest in the list. */
   limit?: number;
   /** The display of `resource`'s list it opens in, such as `cards`; the list's default when omitted. */
@@ -659,6 +695,18 @@ export type HistorySectionModel = {
   /** Whether it shows on the form, the read view or both. */
   when?: ShowWhen;
 };
+/**
+ * The record's comments, oldest first, each with its author and time, and a box to write a new one that mentions people
+ * with `@`. Needs `.comments()` on the resource. See [Record comments](website/src/content/docs/reference/comments.mdx).
+ */
+export type CommentsSectionModel = {
+  /** A comments section. */
+  kind: 'comments';
+  /** The section's title. */
+  title: string;
+  /** Whether it shows on the form, the read view or both. */
+  when?: ShowWhen;
+};
 /** 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). */
@@ -687,7 +735,7 @@ export type LayoutItemModel = {
   fields: string[];
   /** Whether it shows on the form, the read view or both. */
   when?: ShowWhen;
-} | RelatedModel | CustomSectionModel | MapSectionModel | GalleryModel | HistorySectionModel;
+} | RelatedModel | CustomSectionModel | MapSectionModel | GalleryModel | HistorySectionModel | CommentsSectionModel;
 /**
  * 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
@@ -744,8 +792,8 @@ export type RecordMode = 'edit' | 'read' | 'locked';
 export type SaveFeedback = 'toast' | 'button';
 /**
  * What a named action does in the app: set fields of the record (`update`), delete it (`delete`), go to an address in
- * the app (`link` with `to`) or open a link that leaves it (`link` with `href`), `{field}` replaced by the record's
- * values. Without it the app runs a handler it registered by name.
+ * the app (`link` with `to`), open a link that leaves it (`link` with `href`), `{field}` replaced by the record's
+ * values, or have the model write a field (`ai`). Without it the app runs a handler it registered by name.
  */
 export type ActionRun = {
   /** Updates the record. */
@@ -768,6 +816,13 @@ export type ActionRun = {
    * the `https:` or `http:` URL the record holds, without which the action does not show.
    */
   href: string;
+} | {
+  /** Has the model write one field of the record from `prompt`, `{field}` replaced by the record's values, as the user. */
+  kind: 'ai';
+  /** The prompt, with `{field}` placeholders; `/meta` leaves it out. */
+  prompt?: string;
+  /** The field it writes. */
+  writes: string;
 };
 /** A named action of a view (`.actions((a) => ...)`); see [Named actions](website/src/content/docs/reference/layouts.md#named-actions). */
 export type ActionModel = {
@@ -1000,6 +1055,25 @@ export type ViewModel = {
   export?: false | ExportModel;
   /** The page that creates the resource's records, in place of the create form. */
   create?: CreateModel;
+  /** Public forms that create its records for people without an account, each at `/-/forms/<name>`. */
+  forms?: FormModel[];
+};
+/**
+ * A public form (`.form(...)`): anyone, signed in or not, opens it at `/-/forms/<name>` and creates a record with its
+ * fields, through the `anonymous` role's `create`, behind a rate limit and a bot check. See
+ * [Public forms](website/src/content/docs/reference/forms.mdx).
+ */
+export type FormModel = {
+  /** Its address in the app, `/-/forms/<name>`; unique across the app. */
+  name: string;
+  /** The page's heading; the view's singular name when omitted. */
+  title?: string;
+  /** The fields a visitor fills in, in order. */
+  fields: string[];
+  /** What the page shows once the record is created. */
+  thanks: string;
+  /** How many submissions one client may send per minute. */
+  perMinute: number;
 };
 /** How the resource's records are created (`.create(...)`): a page of the app's own. */
 export type CreateModel = {

package/dist/resource-model.d.ts

@@ -18,5 +18,6 @@ export type ResourceState = {
   };
   events?: EventSpec[];
   history?: boolean;
+  comments?: boolean;
 };
 //#endregion

package/dist/resource-model.js

@@ -1,3 +1,4 @@
+import { promptFields } from "./ai-prompt.js";
 import { buildEventModels } from "./events/event-models.js";
 import { snakeCase } from "./naming.js";
 //#region src/resource-model.ts
@@ -40,7 +41,8 @@ const fieldModel = (name, field) => {
 			...meta.file.variants && Object.keys(meta.file.variants).length > 0 && { variants: structuredClone(meta.file.variants) },
 			...meta.file.original && { original: { ...meta.file.original } },
 			...meta.file.external && { external: true }
-		} }
+		} },
+		...meta.ai && { ai: { prompt: meta.ai.prompt } }
 	};
 };
 const assembleModel = (state) => {
@@ -59,6 +61,7 @@ const assembleModel = (state) => {
 		...state.searchMatch && Object.keys(state.searchMatch).length > 0 && { searchMatch: { ...state.searchMatch } },
 		...state.owner && { owner: state.owner },
 		...state.history && { history: true },
+		...state.comments && { comments: true },
 		...state.position && { position: { ...state.position } }
 	};
 };
@@ -118,6 +121,19 @@ const positionProblems = (model) => {
 		...parent && !parent.filterable ? [`position "${name}" is within "${within}", which is not filterable, and each parent's records are found by it`] : []
 	];
 };
+const aiProblems = (model) => Object.values(model.fields).filter((field) => field.ai).flatMap((field) => [
+	...field.type === "text" || field.type === "enum" ? [] : [`is ${field.type}, not text or an enum`],
+	...field.nullable ? [] : ["must be optional(), empty until the job fills it"],
+	...field.readOnly ? ["cannot be readOnly(), as the job writes it through the API"] : [],
+	...field.sensitive ? ["cannot be sensitive"] : [],
+	...promptFields(field.ai.prompt).flatMap((name) => {
+		const read = Object.hasOwn(model.fields, name) ? model.fields[name] : void 0;
+		if (!read) return [`reads "${name}", which is not a field`];
+		if (name === field.name) return [`reads "${name}", itself`];
+		if (read.ai) return [`reads "${name}", which is an AI field too`];
+		return read.sensitive ? [`reads "${name}", which is sensitive`] : [];
+	})
+].map((problem) => `AI field "${field.name}" ${problem}`));
 const buildResourceModel = (state) => {
 	const model = assembleModel(state);
 	const events = state.events && buildEventModels(model, state.events);
@@ -125,6 +141,7 @@ const buildResourceModel = (state) => {
 		...sensitiveProblems(model),
 		...fileProblems(model),
 		...positionProblems(model),
+		...aiProblems(model),
 		...events?.problems ?? []
 	];
 	if (problems.length > 0) throw new Error(`Resource "${model.name}": ${problems.join("; ")}`);

package/dist/resource.d.ts

@@ -103,6 +103,12 @@ export declare class ResourceBuilder<F extends FieldsInput = {}, K = never> {
    * [Record history](website/src/content/docs/reference/history.mdx).
    */
   history(): ResourceBuilder<F, K>;
+  /**
+   * Lets the people who may read a record comment on it, and mention others who may read it too, who get an email. The
+   * record page shows the thread with `l.comments()`, and admins list every comment as Comments. See
+   * [Record comments](website/src/content/docs/reference/comments.mdx).
+   */
+  comments(): ResourceBuilder<F, K>;
   /** The code predicates (`match`) of its events, by event name. */
   eventMatches(): Record<string, EventMatch<any>>;
   /**

package/dist/resource.js

@@ -120,6 +120,14 @@ var ResourceBuilder = class ResourceBuilder {
 	history() {
 		return this.next({ history: true });
 	}
+	/**
+	* Lets the people who may read a record comment on it, and mention others who may read it too, who get an email. The
+	* record page shows the thread with `l.comments()`, and admins list every comment as Comments. See
+	* [Record comments](website/src/content/docs/reference/comments.mdx).
+	*/
+	comments() {
+		return this.next({ comments: true });
+	}
 	/** The code predicates (`match`) of its events, by event name. */
 	eventMatches() {
 		return eventMatches(this.toModel(), this.state.events ?? []);

package/dist/view-actions.d.ts

@@ -38,5 +38,9 @@ export declare const actions: {
   } | {
     href: string;
   })) => ActionModel;
+  ai: (name: string, o: ActionOptions & {
+    prompt: string;
+    writes: string;
+  }) => ActionModel;
 };
 //#endregion

package/dist/view-actions.js

@@ -1,5 +1,6 @@
-import { actionInputErrors, inputs } from "./action-inputs.js";
 import { linkActionError } from "./address-template.js";
+import { promptError } from "./ai-prompt.js";
+import { actionInputErrors, inputs } from "./action-inputs.js";
 //#region src/view-actions.ts
 const named = (name, o) => ({
 	name,
@@ -64,6 +65,18 @@ const actions = {
 				href: o.href
 			}
 		};
+	},
+	ai: (name, o) => {
+		const error = promptError(o.prompt) ?? (o.writes === "" ? "it writes no field" : void 0);
+		if (error) throw new Error(`Action "${name}": ${error}`);
+		return {
+			...named(name, o),
+			run: {
+				kind: "ai",
+				prompt: o.prompt,
+				writes: o.writes
+			}
+		};
 	}
 };
 //#endregion

package/dist/view-displays.d.ts

@@ -92,6 +92,21 @@ export declare const displays: {
     badge?: Ref;
     meta?: Ref[];
   }, o?: Naming) => ListDisplayModel;
+  /**
+   * The records on the days from `start` to `end` (or on their start day alone), in a month grid of whole weeks or a
+   * week grid, with weeks from Monday and days in UTC. It loads only the days shown through the list API, with the
+   * list's filter and search, in start order. An event shows `title` (default: the view's title), after its time for a
+   * timestamp, and opens the record. Dragging an event to another day, or picking it up with Space and moving it with
+   * the arrow keys, saves the record with `start` and `end` moved by the same days, as one update with its ETag, so the
+   * resource's access rules and `validate` decide, and a refusal puts the event back and says why. `start` must be a
+   * filterable date or timestamp field and `end` a filterable field of the same type. Named `calendar` unless `name`
+   * says otherwise. See [Calendars](website/src/content/docs/reference/ui-config.mdx#calendars).
+   */
+  calendar: (fields: {
+    start: Ref;
+    end?: Ref;
+    title?: Ref;
+  }, o?: Naming) => ListDisplayModel;
   /**
    * The list drawn by a component of the project, registered in `protobase.ui.tsx` under its name. It gets `props` and
    * reads the rows with `useListDisplay()`; `fields` are the fields it shows, fetched with relation names.
@@ -107,6 +122,10 @@ export declare const displays: {
 export declare const boardErrors: (display: Extract<ListDisplayModel, {
   kind: "board";
 }>, model: ResourceModel) => string[];
-/** Every field a display names: what it shows, a map's position and the fields saying how exact it is, a board's columns, and the field references in a custom display's props. */
+/** What makes a calendar unable to place the records on days: a `start` that is no filterable date or timestamp, or an `end` that is no filterable field of its type. */
+export declare const calendarErrors: (display: Extract<ListDisplayModel, {
+  kind: "calendar";
+}>, model: ResourceModel) => string[];
+/** Every field a display names: what it shows, a map's position and the fields saying how exact it is, a board's columns, a calendar's dates, and the field references in a custom display's props. */
 export declare const displayFields: (display: ListDisplayModel) => string[];
 //#endregion

package/dist/view-displays.js

@@ -92,6 +92,24 @@ const displays = {
 		...fields.meta && { meta: fields.meta.map((ref) => ref.name) }
 	}),
 	/**
+	* The records on the days from `start` to `end` (or on their start day alone), in a month grid of whole weeks or a
+	* week grid, with weeks from Monday and days in UTC. It loads only the days shown through the list API, with the
+	* list's filter and search, in start order. An event shows `title` (default: the view's title), after its time for a
+	* timestamp, and opens the record. Dragging an event to another day, or picking it up with Space and moving it with
+	* the arrow keys, saves the record with `start` and `end` moved by the same days, as one update with its ETag, so the
+	* resource's access rules and `validate` decide, and a refusal puts the event back and says why. `start` must be a
+	* filterable date or timestamp field and `end` a filterable field of the same type. Named `calendar` unless `name`
+	* says otherwise. See [Calendars](website/src/content/docs/reference/ui-config.mdx#calendars).
+	*/
+	calendar: (fields, o = {}) => ({
+		kind: "calendar",
+		name: o.name ?? "calendar",
+		...naming(o),
+		start: fields.start.name,
+		...fields.end && { end: fields.end.name },
+		...fields.title && { title: fields.title.name }
+	}),
+	/**
 	* The list drawn by a component of the project, registered in `protobase.ui.tsx` under its name. It gets `props` and
 	* reads the rows with `useListDisplay()`; `fields` are the fields it shows, fetched with relation names.
 	*/
@@ -131,7 +149,21 @@ const boardErrors = (display, model) => {
 	if (field.type !== "enum") return [`"${display.by}" on ${model.name} is ${field.type}, not an enum, whose values are the board's columns`];
 	return field.filterable ? [] : [`"${display.by}" on ${model.name} is not filterable, and each column of the board filters by its value`];
 };
-/** Every field a display names: what it shows, a map's position and the fields saying how exact it is, a board's columns, and the field references in a custom display's props. */
+/** What makes a calendar unable to place the records on days: a `start` that is no filterable date or timestamp, or an `end` that is no filterable field of its type. */
+const calendarErrors = (display, model) => {
+	const known = (name) => Object.hasOwn(model.fields, name) ? model.fields[name] : void 0;
+	const start = known(display.start);
+	const end = display.end === void 0 ? void 0 : known(display.end);
+	if (!start) return [];
+	if (start.type !== "date" && start.type !== "timestamp") return [`start "${display.start}" on ${model.name} is ${start.type}, not a date or timestamp`];
+	const unfilterable = (name) => `${name === display.start ? "start" : "end"} "${name}" on ${model.name} is not filterable, and the calendar filters by it for the days it shows`;
+	return [
+		...start.filterable ? [] : [unfilterable(display.start)],
+		...end && end.type !== start.type ? [`end "${display.end}" on ${model.name} is ${end.type}, not ${start.type} like start "${display.start}"`] : [],
+		...end && end.type === start.type && !end.filterable ? [unfilterable(display.end)] : []
+	];
+};
+/** Every field a display names: what it shows, a map's position and the fields saying how exact it is, a board's columns, a calendar's dates, and the field references in a custom display's props. */
 const displayFields = (display) => {
 	if (display.kind === "map") return [
 		display.latitude,
@@ -149,6 +181,11 @@ const displayFields = (display) => {
 		display.badge,
 		...display.meta ?? []
 	].filter((name) => name !== void 0);
+	if (display.kind === "calendar") return [
+		display.start,
+		display.end,
+		display.title
+	].filter((name) => name !== void 0);
 	return [
 		display.image,
 		display.title,
@@ -161,4 +198,4 @@ const displayFields = (display) => {
 	].filter((name) => name !== void 0);
 };
 //#endregion
-export { boardErrors, cardPhotoLimit, customComponent, displayErrors, displayFields, displays, tableDisplay };
+export { boardErrors, calendarErrors, cardPhotoLimit, customComponent, displayErrors, displayFields, displays, tableDisplay };

package/dist/view-form.d.ts

@@ -0,0 +1,16 @@
+import { Ref } from "./refs.js";
+//#region src/view-form.d.ts
+/** What `.form(...)` takes. */
+export type FormInput = {
+  /** Its address in the app, `/-/forms/<name>`: lowercase letters, digits, `-` and `_`, unique across the app. */
+  name: string;
+  /** The page's heading; the view's singular name when omitted. */
+  title?: string;
+  /** The fields a visitor fills in, in order: plain fields the `anonymous` role may create. */
+  fields: Ref[];
+  /** What the page shows once the record is created. */
+  thanks: string;
+  /** How many submissions one client may send per minute; default 5. */
+  perMinute?: number;
+};
+//#endregion

package/dist/view-form.js

@@ -0,0 +1,22 @@
+import { formNamePattern } from "./form-address.js";
+const formModel = (input) => {
+	const { name, title, fields, thanks } = input;
+	if (!formNamePattern.test(name)) throw new Error(`A form's name goes in its address, so it takes lowercase letters, digits, - and _, not "${name}"`);
+	if (fields.length === 0) throw new Error(`Form "${name}" has no fields`);
+	const names = fields.map((field) => field.name);
+	const repeated = names.find((field, index) => names.indexOf(field) !== index);
+	if (repeated !== void 0) throw new Error(`Form "${name}" lists the field "${repeated}" twice`);
+	if (thanks.trim() === "") throw new Error(`Form "${name}" needs a thanks text, shown once a visitor sends it`);
+	if (title !== void 0 && title.trim() === "") throw new Error(`Form "${name}" has an empty title; leave it out for the view's name`);
+	const perMinute = input.perMinute ?? 5;
+	if (!Number.isInteger(perMinute) || perMinute < 1) throw new Error(`Form "${name}" takes perMinute as a positive whole number, not ${perMinute}`);
+	return {
+		name,
+		...title !== void 0 && { title },
+		fields: names,
+		thanks,
+		perMinute
+	};
+};
+//#endregion
+export { formModel };

package/dist/view.d.ts

@@ -2,6 +2,7 @@ import { ActionModel, CreateModel, ExportModel, FilterWidgetModel, HelpWhen, Lay
 import { FieldRefs, Ref } from "./refs.js";
 import { actions } from "./view-actions.js";
 import { ChartInput } from "./view-chart.js";
+import { FormInput } from "./view-form.js";
 import { ListColumn, columns } from "./view-columns.js";
 import { displays } from "./view-displays.js";
 import { FieldView } from "./view-field.js";
@@ -68,7 +69,7 @@ export declare class ViewBuilder<R extends {
   fields(build: (r: FieldViews<R>) => Record<string, FieldView>): ViewBuilder<R>;
   /**
    * The list: its table's `columns`, fields or columns of related records (`c.related`), `sort` and `search`, the
-   * columns that are `editable` in their cell, and other `displays` to switch to (`d.cards`, `d.map`, `d.board`, `d.custom`), one of which
+   * columns that are `editable` in their cell, and other `displays` to switch to (`d.cards`, `d.map`, `d.board`, `d.calendar`, `d.custom`), one of which
    * may be the `default` the list opens in. Throws when display or column names collide, `default` names none or an
    * editable field is not among the columns. See
    * [Editing in the list](website/src/content/docs/reference/ui-config.mdx#editing-in-the-list).
@@ -97,6 +98,14 @@ export declare class ViewBuilder<R extends {
    * 10), counted or with `sum` or `average` that of a numeric field.
    */
   chart(build: (r: FieldRefs<FieldsOf<R>>) => ChartInput): ViewBuilder<R>;
+  /**
+   * A public form that creates a record of this resource for anyone, signed in or not, at `/-/forms/<name>`: the
+   * `fields` a visitor fills in, the `thanks` shown once it is sent, a `title` (the view's singular name by default) and
+   * how many submissions one client may send `perMinute` (default 5). The `anonymous` role must grant `create` of those
+   * fields; the form is the only way it creates. Each call adds a form. Throws on a name that does not fit an address, no
+   * or repeated fields, or an empty `thanks`. See [Public forms](website/src/content/docs/reference/forms.mdx).
+   */
+  form(build: (r: FieldRefs<FieldsOf<R>>) => FormInput): ViewBuilder<R>;
   /**
    * How the record page opens to a user who may change the record: `edit`, the default, as its form; `read` as a read
    * view, its sections as tables of labels and values, with an Edit button to the form; `locked` as the form, locked
@@ -178,7 +187,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` and the sidebar's `recent` group. */
+  /** 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 the forms' fields. */
   toModel(resource?: ResourceModel): ViewModel;
   private refs;
   private next;

package/dist/view.js

@@ -3,8 +3,9 @@ import { isMenuHref } from "./menu-href.js";
 import { navRecentErrors } from "./nav-recent.js";
 import { actions } from "./view-actions.js";
 import { chartModel } from "./view-chart.js";
+import { formModel } from "./view-form.js";
 import { columns, isListColumn } from "./view-columns.js";
-import { boardErrors, displayErrors, displayFields, displays } from "./view-displays.js";
+import { boardErrors, calendarErrors, displayErrors, displayFields, displays } from "./view-displays.js";
 import { FieldView } from "./view-field.js";
 import { widgets } from "./view-widgets.js";
 //#region src/view.ts
@@ -75,7 +76,7 @@ var ViewBuilder = class ViewBuilder {
 	}
 	/**
 	* The list: its table's `columns`, fields or columns of related records (`c.related`), `sort` and `search`, the
-	* columns that are `editable` in their cell, and other `displays` to switch to (`d.cards`, `d.map`, `d.board`, `d.custom`), one of which
+	* columns that are `editable` in their cell, and other `displays` to switch to (`d.cards`, `d.map`, `d.board`, `d.calendar`, `d.custom`), one of which
 	* may be the `default` the list opens in. Throws when display or column names collide, `default` names none or an
 	* editable field is not among the columns. See
 	* [Editing in the list](website/src/content/docs/reference/ui-config.mdx#editing-in-the-list).
@@ -124,6 +125,16 @@ var ViewBuilder = class ViewBuilder {
 		return this.next({ chart: chartModel(build(this.refs())) });
 	}
 	/**
+	* A public form that creates a record of this resource for anyone, signed in or not, at `/-/forms/<name>`: the
+	* `fields` a visitor fills in, the `thanks` shown once it is sent, a `title` (the view's singular name by default) and
+	* how many submissions one client may send `perMinute` (default 5). The `anonymous` role must grant `create` of those
+	* fields; the form is the only way it creates. Each call adds a form. Throws on a name that does not fit an address, no
+	* or repeated fields, or an empty `thanks`. See [Public forms](website/src/content/docs/reference/forms.mdx).
+	*/
+	form(build) {
+		return this.next({ forms: [...this.state.forms ?? [], formModel(build(this.refs()))] });
+	}
+	/**
 	* How the record page opens to a user who may change the record: `edit`, the default, as its form; `read` as a read
 	* view, its sections as tables of labels and values, with an Edit button to the form; `locked` as the form, locked
 	* until Edit is pressed. A user who may not change it gets the read view in every mode. The form has its own address
@@ -230,7 +241,7 @@ 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` and the sidebar's `recent` group. */
+	/** 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 the forms' fields. */
 	toModel(resource) {
 		const { title, 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`);
@@ -244,6 +255,8 @@ var ViewBuilder = class ViewBuilder {
 			if (flag !== void 0) throw new Error(`View "${this.state.resource}": display "${display.name}" shows "${flag}" as a flag, which is not a boolean field`);
 			const board = display.kind === "board" ? boardErrors(display, resource) : [];
 			if (board.length > 0) throw new Error(`View "${this.state.resource}": display "${display.name}": ${board.join("; ")}`);
+			const calendar = display.kind === "calendar" ? calendarErrors(display, resource) : [];
+			if (calendar.length > 0) throw new Error(`View "${this.state.resource}": display "${display.name}": ${calendar.join("; ")}`);
 		}
 		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`);
@@ -255,6 +268,10 @@ var ViewBuilder = class ViewBuilder {
 		if (resource && listOf !== void 0 && (!Object.hasOwn(resource.fields, listOf) || resource.fields[listOf].type !== "relation")) throw new Error(`View "${this.state.resource}": listOf names "${listOf}", which is not a relation field of the resource`);
 		const searchErrors = resource && this.state.searchesOf ? searchesOfErrors(this.state.searchesOf, resource) : [];
 		if (searchErrors.length > 0) throw new Error(`View "${this.state.resource}": searchesOf ${searchErrors.join("; ")}`);
+		for (const form of resource ? this.state.forms ?? [] : []) {
+			const unknown = form.fields.find((name) => !Object.hasOwn(resource.fields, name));
+			if (unknown !== void 0) throw new Error(`View "${this.state.resource}": form "${form.name}" names field "${unknown}", which the resource does not have`);
+		}
 		const recentErrors = resource && nav?.recent ? navRecentErrors(nav.recent, resource) : [];
 		if (recentErrors.length > 0) throw new Error(`View "${this.state.resource}": nav.recent ${recentErrors.join("; ")}`);
 		return structuredClone(this.state);

package/package.json

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