@shapio/schema 0.5.3 → 0.5.5

package/dist/index.d.ts

@@ -17,7 +17,7 @@ export declare const createStableId: () => string;
 //#endregion
 //#region src/types/dataTypes.d.ts
 /** Every stored data type. A field's data type is separate from the editor that renders it (brief §2.5). */
-export declare const DATA_TYPES: readonly ["string", "text", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"];
+export declare const DATA_TYPES: readonly ["string", "text", "code", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"];
 export type DataType = (typeof DATA_TYPES)[number];
 export declare const isDataType: (value: unknown) => value is DataType;
 /**
@@ -48,6 +48,9 @@ export type JsonObject = {
 //#region src/types/settings.d.ts
 export declare const MEDIA_KINDS: readonly ["image", "video", "audio", "document", "other"];
 export declare const RELATION_CARDINALITIES: readonly ["one", "many"];
+/** Languages a `code` field can hold. The language reaches the API (OpenAPI, GraphQL, generated types). */
+export declare const CODE_LANGUAGES: readonly ["plain", "html", "css", "javascript", "json", "yaml", "markdown"];
+export type CodeLanguage = (typeof CODE_LANGUAGES)[number];
 export declare const EnumValueSchema: Type.TObject<{
   value: Type.TString;
   label: Type.TString;
@@ -62,6 +65,13 @@ export declare const SETTINGS_SCHEMAS: {
     minLength: Type.TOptional<Type.TInteger>;
     maxLength: Type.TOptional<Type.TInteger>;
   }>;
+  code: Type.TObject<{
+    /** JSON only: a value that does not parse is refused. */
+    validate: Type.TOptional<Type.TBoolean>;
+    minLength: Type.TOptional<Type.TInteger>;
+    maxLength: Type.TOptional<Type.TInteger>;
+    language: Type.TOptional<Type.TEnum<["plain", "html", "css", "javascript", "json", "yaml", "markdown"]>>;
+  }>;
   richtext: Type.TObject<{
     formatVersion: Type.TOptional<Type.TInteger>;
     maxLength: Type.TOptional<Type.TInteger>;
@@ -146,7 +156,10 @@ type SettingsSchemas = typeof SETTINGS_SCHEMAS;
 /** Settings as authored (defaults may be missing). */
 export type DataTypeSettingsInput = { [T in DataType]: Static<SettingsSchemas[T]>; };
 /** Settings after normalization: the defaulted keys are always present. */
-export type DataTypeSettings = Omit<DataTypeSettingsInput, 'richtext' | 'enum' | 'media' | 'component'> & {
+export type DataTypeSettings = Omit<DataTypeSettingsInput, 'code' | 'richtext' | 'enum' | 'media' | 'component'> & {
+  code: DataTypeSettingsInput['code'] & {
+    language: CodeLanguage;
+  };
   richtext: DataTypeSettingsInput['richtext'] & {
     formatVersion: number;
   };
@@ -168,6 +181,19 @@ export declare const DEFINITION_KINDS: readonly ["collection", "singleton", "com
 export type DefinitionKind = (typeof DEFINITION_KINDS)[number];
 export declare const SORT_DIRECTIONS: readonly ["asc", "desc"];
 export type SortDirection = (typeof SORT_DIRECTIONS)[number];
+/**
+ * How an entry of a model opens: `document` (title typed into the page, blocks in a canvas, properties in
+ * the strip and the settings drawer) or `form` (every field inline at its `width`, sections from
+ * `display.groups`). Unset means `document`; normalizing drops an explicit `document`.
+ */
+export declare const ENTRY_LAYOUTS: readonly ["document", "form"];
+export type EntryLayout = (typeof ENTRY_LAYOUTS)[number];
+/**
+ * A field's width in a form-layout entry, as a share of the row: rows fill in field order and wrap. Unset
+ * means `full`; normalizing drops an explicit `full`.
+ */
+export declare const FIELD_WIDTHS: readonly ["full", "two-thirds", "half", "third"];
+export type FieldWidth = (typeof FIELD_WIDTHS)[number];
 export declare const MAX_FIELDS_PER_DEFINITION = 500;
 export declare const MAX_LABEL_LENGTH = 200;
 export declare const MAX_DESCRIPTION_LENGTH = 2000;
@@ -181,7 +207,7 @@ export declare const FieldInputSchema: Type.TObject<{
   label: Type.TString;
   /** Help text shown under the control. */
   description: Type.TOptional<Type.TString>;
-  type: Type.TEnum<["string", "text", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"]>;
+  type: Type.TEnum<["string", "text", "code", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"]>;
   required: Type.TOptional<Type.TBoolean>;
   /** Per-locale value. Ignored (must be false) when the model is not localized. */
   localized: Type.TOptional<Type.TBoolean>;
@@ -200,8 +226,15 @@ export declare const FieldInputSchema: Type.TObject<{
     id: Type.TString;
     options: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
   }>>;
+  /**
+   * Width in a form-layout entry (`display.layout: 'form'`). Default `full`. Model fields only: the
+   * validator refuses it on a component's field.
+   */
+  width: Type.TOptional<Type.TEnum<["full", "two-thirds", "half", "third"]>>;
 }>;
 export declare const ModelDisplayInputSchema: Type.TObject<{
+  /** How entries open: `document` (default) or `form`. See `ENTRY_LAYOUTS`. */
+  layout: Type.TOptional<Type.TEnum<["document", "form"]>>;
   /** Field whose value labels an entry in lists, pickers and relation summaries. */
   titleFieldId: Type.TOptional<Type.TString>;
   /** Columns of the content list, in order. */
@@ -242,6 +275,8 @@ export declare const ModelDefinitionInputSchema: Type.TObject<{
   /** Entries have separate draft and published states. Default true. */
   draftAndPublish: Type.TOptional<Type.TBoolean>;
   display: Type.TOptional<Type.TObject<{
+    /** How entries open: `document` (default) or `form`. See `ENTRY_LAYOUTS`. */
+    layout: Type.TOptional<Type.TEnum<["document", "form"]>>;
     /** Field whose value labels an entry in lists, pickers and relation summaries. */
     titleFieldId: Type.TOptional<Type.TString>;
     /** Columns of the content list, in order. */
@@ -273,7 +308,7 @@ export declare const ModelDefinitionInputSchema: Type.TObject<{
     label: Type.TString;
     /** Help text shown under the control. */
     description: Type.TOptional<Type.TString>;
-    type: Type.TEnum<["string", "text", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"]>;
+    type: Type.TEnum<["string", "text", "code", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"]>;
     required: Type.TOptional<Type.TBoolean>;
     /** Per-locale value. Ignored (must be false) when the model is not localized. */
     localized: Type.TOptional<Type.TBoolean>;
@@ -292,6 +327,11 @@ export declare const ModelDefinitionInputSchema: Type.TObject<{
       id: Type.TString;
       options: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
     }>>;
+    /**
+     * Width in a form-layout entry (`display.layout: 'form'`). Default `full`. Model fields only: the
+     * validator refuses it on a component's field.
+     */
+    width: Type.TOptional<Type.TEnum<["full", "two-thirds", "half", "third"]>>;
   }>>;
 }>;
 export declare const ComponentDefinitionInputSchema: Type.TObject<{
@@ -316,7 +356,7 @@ export declare const ComponentDefinitionInputSchema: Type.TObject<{
     label: Type.TString;
     /** Help text shown under the control. */
     description: Type.TOptional<Type.TString>;
-    type: Type.TEnum<["string", "text", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"]>;
+    type: Type.TEnum<["string", "text", "code", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"]>;
     required: Type.TOptional<Type.TBoolean>;
     /** Per-locale value. Ignored (must be false) when the model is not localized. */
     localized: Type.TOptional<Type.TBoolean>;
@@ -335,6 +375,11 @@ export declare const ComponentDefinitionInputSchema: Type.TObject<{
       id: Type.TString;
       options: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
     }>>;
+    /**
+     * Width in a form-layout entry (`display.layout: 'form'`). Default `full`. Model fields only: the
+     * validator refuses it on a component's field.
+     */
+    width: Type.TOptional<Type.TEnum<["full", "two-thirds", "half", "third"]>>;
   }>>;
 }>;
 export declare const DefinitionInputSchema: Type.TUnion<[Type.TObject<{
@@ -348,6 +393,8 @@ export declare const DefinitionInputSchema: Type.TUnion<[Type.TObject<{
   /** Entries have separate draft and published states. Default true. */
   draftAndPublish: Type.TOptional<Type.TBoolean>;
   display: Type.TOptional<Type.TObject<{
+    /** How entries open: `document` (default) or `form`. See `ENTRY_LAYOUTS`. */
+    layout: Type.TOptional<Type.TEnum<["document", "form"]>>;
     /** Field whose value labels an entry in lists, pickers and relation summaries. */
     titleFieldId: Type.TOptional<Type.TString>;
     /** Columns of the content list, in order. */
@@ -379,7 +426,7 @@ export declare const DefinitionInputSchema: Type.TUnion<[Type.TObject<{
     label: Type.TString;
     /** Help text shown under the control. */
     description: Type.TOptional<Type.TString>;
-    type: Type.TEnum<["string", "text", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"]>;
+    type: Type.TEnum<["string", "text", "code", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"]>;
     required: Type.TOptional<Type.TBoolean>;
     /** Per-locale value. Ignored (must be false) when the model is not localized. */
     localized: Type.TOptional<Type.TBoolean>;
@@ -398,6 +445,11 @@ export declare const DefinitionInputSchema: Type.TUnion<[Type.TObject<{
       id: Type.TString;
       options: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
     }>>;
+    /**
+     * Width in a form-layout entry (`display.layout: 'form'`). Default `full`. Model fields only: the
+     * validator refuses it on a component's field.
+     */
+    width: Type.TOptional<Type.TEnum<["full", "two-thirds", "half", "third"]>>;
   }>>;
 }>, Type.TObject<{
   kind: Type.TLiteral<"component">;
@@ -421,7 +473,7 @@ export declare const DefinitionInputSchema: Type.TUnion<[Type.TObject<{
     label: Type.TString;
     /** Help text shown under the control. */
     description: Type.TOptional<Type.TString>;
-    type: Type.TEnum<["string", "text", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"]>;
+    type: Type.TEnum<["string", "text", "code", "richtext", "number", "integer", "decimal", "biginteger", "boolean", "date", "datetime", "time", "enum", "json", "slug", "email", "url", "uid", "media", "relation", "component", "dynamiczone"]>;
     required: Type.TOptional<Type.TBoolean>;
     /** Per-locale value. Ignored (must be false) when the model is not localized. */
     localized: Type.TOptional<Type.TBoolean>;
@@ -440,6 +492,11 @@ export declare const DefinitionInputSchema: Type.TUnion<[Type.TObject<{
       id: Type.TString;
       options: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
     }>>;
+    /**
+     * Width in a form-layout entry (`display.layout: 'form'`). Default `full`. Model fields only: the
+     * validator refuses it on a component's field.
+     */
+    width: Type.TOptional<Type.TEnum<["full", "two-thirds", "half", "third"]>>;
   }>>;
 }>]>;
 export type FieldInput = Static<typeof FieldInputSchema>;
@@ -464,6 +521,8 @@ type FieldBase = {
   deprecated: boolean;
   defaultValue?: JsonValue;
   editor: EditorChoice;
+  /** Width in a form-layout entry; absent means `full`. */
+  width?: FieldWidth;
 };
 /** A normalized field. Narrow on `type` to get typed `settings`. */
 export type FieldDefinition<T extends DataType = DataType> = { [K in T]: FieldBase & {
@@ -476,6 +535,8 @@ export type FieldGroup = {
   fieldIds: string[];
 };
 export type ModelDisplay = {
+  /** Absent means `document`. */
+  layout?: EntryLayout;
   titleFieldId?: string;
   listFieldIds?: string[];
   defaultSort?: {
@@ -644,6 +705,34 @@ export type DocumentLayout = {
 export declare const effectiveLayout: (model: ModelDefinition) => DocumentLayout;
 /** The strip's properties: the configured ones, or the first `limit` that `hasValue` says are non-empty. */
 export declare const stripFieldsOf: (layout: DocumentLayout, hasValue: (field: FieldDefinition) => boolean, limit?: number) => FieldDefinition[];
+/** How the model's entries open (`display.layout`): `document` unless set to `form`. */
+export declare const entryLayoutOf: (model: ModelDefinition) => EntryLayout;
+/**
+ * One section of a form-layout entry: a `display.groups` group (its `id` and `label`), or a run of
+ * consecutive ungrouped fields (`label` undefined). A run's `id` is `ungrouped-<ID of its first field>`:
+ * stable while that field stays first, and unique because a field starts one run at most. Should a group
+ * be given that very ID, the run's ID gets `~` prefixed until no group has it.
+ */
+export type FieldSection = PropertyGroup;
+export type FormLayout = {
+  /** The field that labels the entry (`effectiveTitleField`): the page heading. It is also in `sections`. */
+  title: FieldDefinition | undefined;
+  /** Every live field, in sections. */
+  sections: FieldSection[];
+};
+/**
+ * The entry form's layout (`display.layout: 'form'`): every live field, the title included, in sections.
+ * Field order decides everything: a group's section sits where its first field appears, with its fields in
+ * field order, and every run of consecutive ungrouped fields is an unlabelled section of its own at its
+ * place. So name, price, sku, description with a Pricing group (price, sku) reads [name], Pricing [price,
+ * sku], [description]. Unknown and deprecated ids are skipped. Pure: no values, no I/O.
+ */
+export declare const effectiveFormLayout: (model: ModelDefinition) => FormLayout;
+/**
+ * The entry's rich-text body, which "Summarize from body" reads: the document's rich-text canvas fields, or
+ * every live rich-text field of a form (a form has no canvas; its fields are all on the page).
+ */
+export declare const richTextBodyOf: (model: ModelDefinition) => FieldDefinition[];
 //#endregion
 //#region src/display/titleField.d.ts
 /** Field types that may label entries: the only types `display.titleFieldId` accepts, and the fallback's. */
@@ -688,8 +777,9 @@ export type DefinitionInputWithIds = (WithIds<ModelDefinitionInput> & {
 /**
  * Applies defaults so that two definitions meaning the same thing are byte-identical once serialized
  * canonically: a hand-written file that omits `public` hashes the same as one that says `public: true`.
- * Empty optional strings and arrays are dropped. A collection without a plural API ID gets the suggested
- * one (`suggestPlural`), so files and definitions from before plural API IDs keep working.
+ * Empty optional strings and arrays are dropped, and so are the defaults of keys added after definitions
+ * were first hashed (`width: 'full'`, `display.layout: 'document'`). A collection without a plural API ID
+ * gets the suggested one (`suggestPlural`), so files and definitions from before plural API IDs keep working.
  */
 export declare const normalizeDefinition: (input: DefinitionInputWithIds) => SchemaDefinition;
 /** Normalizes a definition that is already normalized-shaped (e.g. read back from the database). */
@@ -1167,6 +1257,14 @@ export declare const richTextToPlainText: (document: RichTextDocument) => string
 /** Plain text → a document of paragraphs (blank lines split paragraphs; single newlines are hard breaks). */
 export declare const plainTextToRichText: (text: string) => RichTextDocument;
 //#endregion
+//#region src/richtext/plainText.d.ts
+/**
+ * A stored rich text value (`{ format, version, doc }`) as one line of plain text: blocks separated by a
+ * space, whitespace collapsed. For summaries (list cells, collapsed items, review rows), never for delivery.
+ * Anything that is not a valid document (an unconverted value of a field that became rich text) reads as ''.
+ */
+export declare const richTextPlainText: (value: unknown) => string;
+//#endregion
 //#region src/themes/tokens.d.ts
 /**
  * Admin themes (docs/plans/themes.md): a theme is a named, complete set of these tokens for a light variant, a

package/dist/index.js

@@ -8,6 +8,7 @@ import { Value } from "typebox/value";
 const DATA_TYPES = [
 	"string",
 	"text",
+	"code",
 	"richtext",
 	"number",
 	"integer",
@@ -74,6 +75,7 @@ const REFERENCE_DATA_TYPES = /* @__PURE__ */ new Set([
 const STORAGE_FAMILY = {
 	string: "jsonString",
 	text: "jsonString",
+	code: "jsonString",
 	slug: "jsonString",
 	email: "jsonString",
 	url: "jsonString",
@@ -108,6 +110,22 @@ const closed$3 = { additionalProperties: false };
 const MODEL_KINDS = ["collection", "singleton"];
 const DEFINITION_KINDS = [...MODEL_KINDS, "component"];
 const SORT_DIRECTIONS = ["asc", "desc"];
+/**
+* How an entry of a model opens: `document` (title typed into the page, blocks in a canvas, properties in
+* the strip and the settings drawer) or `form` (every field inline at its `width`, sections from
+* `display.groups`). Unset means `document`; normalizing drops an explicit `document`.
+*/
+const ENTRY_LAYOUTS = ["document", "form"];
+/**
+* A field's width in a form-layout entry, as a share of the row: rows fill in field order and wrap. Unset
+* means `full`; normalizing drops an explicit `full`.
+*/
+const FIELD_WIDTHS = [
+	"full",
+	"two-thirds",
+	"half",
+	"third"
+];
 const MAX_FIELDS_PER_DEFINITION = 500;
 const MAX_LABEL_LENGTH = 200;
 const MAX_DESCRIPTION_LENGTH = 2e3;
@@ -144,7 +162,12 @@ const FieldInputSchema = Type.Object({
 	defaultValue: Type.Optional(Type.Unknown()),
 	/** Type-specific settings, validated against SETTINGS_SCHEMAS[type]. */
 	settings: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
-	editor: Type.Optional(EditorChoiceInputSchema)
+	editor: Type.Optional(EditorChoiceInputSchema),
+	/**
+	* Width in a form-layout entry (`display.layout: 'form'`). Default `full`. Model fields only: the
+	* validator refuses it on a component's field.
+	*/
+	width: Type.Optional(Type.Enum(FIELD_WIDTHS))
 }, closed$3);
 const FieldGroupSchema = Type.Object({
 	id: Type.String({
@@ -155,6 +178,8 @@ const FieldGroupSchema = Type.Object({
 	fieldIds: Type.Array(Type.String())
 }, closed$3);
 const ModelDisplayInputSchema = Type.Object({
+	/** How entries open: `document` (default) or `form`. See `ENTRY_LAYOUTS`. */
+	layout: Type.Optional(Type.Enum(ENTRY_LAYOUTS)),
 	/** Field whose value labels an entry in lists, pickers and relation summaries. */
 	titleFieldId: Type.Optional(Type.String()),
 	/** Columns of the content list, in order. */
@@ -255,6 +280,16 @@ const MEDIA_KINDS = [
 	"other"
 ];
 const RELATION_CARDINALITIES = ["one", "many"];
+/** Languages a `code` field can hold. The language reaches the API (OpenAPI, GraphQL, generated types). */
+const CODE_LANGUAGES = [
+	"plain",
+	"html",
+	"css",
+	"javascript",
+	"json",
+	"yaml",
+	"markdown"
+];
 const EnumValueSchema = Type.Object({
 	value: Type.String({
 		minLength: 1,
@@ -274,6 +309,12 @@ const SETTINGS_SCHEMAS = {
 		}))
 	}, closed$2),
 	text: Type.Object(lengthRules, closed$2),
+	code: Type.Object({
+		language: Type.Optional(Type.Enum(CODE_LANGUAGES)),
+		...lengthRules,
+		/** JSON only: a value that does not parse is refused. */
+		validate: Type.Optional(Type.Boolean())
+	}, closed$2),
 	richtext: Type.Object({
 		formatVersion: Type.Optional(Type.Integer({ minimum: 1 })),
 		maxLength: Type.Optional(Type.Integer({ minimum: 1 }))
@@ -482,6 +523,14 @@ const entries = [
 			maximum: 80
 		})) }, closed$1)
 	},
+	{
+		id: "codeEditor",
+		dataTypes: ["code"],
+		optionsSchema: Type.Object({ rows: Type.Optional(Type.Integer({
+			minimum: 3,
+			maximum: 80
+		})) }, closed$1)
+	},
 	{
 		id: "mediaPicker",
 		dataTypes: ["media"],
@@ -514,6 +563,7 @@ const EDITOR_CATALOGUE = new Map(entries.map((entry) => [entry.id, entry]));
 const DEFAULT_EDITORS = {
 	string: "textInput",
 	text: "textarea",
+	code: "codeEditor",
 	richtext: "richText",
 	number: "numberInput",
 	integer: "numberInput",
@@ -666,6 +716,66 @@ const effectiveLayout = (model) => {
 };
 /** The strip's properties: the configured ones, or the first `limit` that `hasValue` says are non-empty. */
 const stripFieldsOf = (layout, hasValue, limit = 5) => layout.strip ?? layout.properties.filter(hasValue).slice(0, limit);
+/** How the model's entries open (`display.layout`): `document` unless set to `form`. */
+const entryLayoutOf = (model) => model.display.layout ?? "document";
+const ungroupedSectionId = (first, groupIds) => {
+	let candidate = `ungrouped-${first.id}`;
+	while (groupIds.has(candidate)) candidate = `~${candidate}`;
+	return candidate;
+};
+/**
+* The entry form's layout (`display.layout: 'form'`): every live field, the title included, in sections.
+* Field order decides everything: a group's section sits where its first field appears, with its fields in
+* field order, and every run of consecutive ungrouped fields is an unlabelled section of its own at its
+* place. So name, price, sku, description with a Pricing group (price, sku) reads [name], Pricing [price,
+* sku], [description]. Unknown and deprecated ids are skipped. Pure: no values, no I/O.
+*/
+const effectiveFormLayout = (model) => {
+	const groups = model.display.groups ?? [];
+	const groupIds = new Set(groups.map((group) => group.id));
+	const groupOf = /* @__PURE__ */ new Map();
+	for (const group of groups) for (const fieldId of group.fieldIds) if (!groupOf.has(fieldId)) groupOf.set(fieldId, group);
+	const sections = [];
+	const groupSections = /* @__PURE__ */ new Map();
+	let run;
+	for (const field of model.fields) {
+		if (field.deprecated) continue;
+		const group = groupOf.get(field.id);
+		if (!group) {
+			if (!run) {
+				run = {
+					id: ungroupedSectionId(field, groupIds),
+					label: void 0,
+					fields: []
+				};
+				sections.push(run);
+			}
+			run.fields.push(field);
+			continue;
+		}
+		run = void 0;
+		let section = groupSections.get(group.id);
+		if (!section) {
+			section = {
+				id: group.id,
+				label: group.label,
+				fields: []
+			};
+			groupSections.set(group.id, section);
+			sections.push(section);
+		}
+		section.fields.push(field);
+	}
+	return {
+		title: effectiveTitleField(model),
+		sections
+	};
+};
+/**
+* The entry's rich-text body, which "Summarize from body" reads: the document's rich-text canvas fields, or
+* every live rich-text field of a form (a form has no canvas; its fields are all on the page).
+*/
+const richTextBodyOf = (model) => entryLayoutOf(model) === "form" ? model.fields.filter((field) => field.type === "richtext" && !field.deprecated) : effectiveLayout(model).canvas.filter((field) => field.type === "richtext");
 //#endregion
 //#region src/validators/apiKey.ts
 /**
@@ -715,6 +825,7 @@ const suggestPlural = (apiKey) => {
 //#endregion
 //#region src/normalize.ts
 const SETTINGS_DEFAULTS = {
+	code: { language: "plain" },
 	richtext: { formatVersion: 1 },
 	enum: { multiple: false },
 	media: { multiple: false },
@@ -768,17 +879,22 @@ const normalizeField = (field) => {
 		editor: {
 			id: field.editor?.id ?? DEFAULT_EDITORS[field.type],
 			options: field.editor?.options ?? {}
-		}
+		},
+		width: field.width === "full" ? void 0 : field.width
 	};
 	return withoutEmpty(normalized);
 };
-const normalizeModelDisplay = (display) => withoutEmpty({ ...display });
+const normalizeModelDisplay = (display) => withoutEmpty({
+	...display,
+	layout: display?.layout === "document" ? void 0 : display?.layout
+});
 const normalizeComponentDisplay = (display) => withoutEmpty({ ...display });
 /**
 * Applies defaults so that two definitions meaning the same thing are byte-identical once serialized
 * canonically: a hand-written file that omits `public` hashes the same as one that says `public: true`.
-* Empty optional strings and arrays are dropped. A collection without a plural API ID gets the suggested
-* one (`suggestPlural`), so files and definitions from before plural API IDs keep working.
+* Empty optional strings and arrays are dropped, and so are the defaults of keys added after definitions
+* were first hashed (`width: 'full'`, `display.layout: 'document'`). A collection without a plural API ID
+* gets the suggested one (`suggestPlural`), so files and definitions from before plural API IDs keep working.
 */
 const normalizeDefinition = (input) => {
 	const fields = input.fields.map(normalizeField);
@@ -823,6 +939,7 @@ const checkDefaultValue = (field) => {
 	switch (field.type) {
 		case "string":
 		case "text":
+		case "code":
 		case "email":
 		case "url": return isString ? null : "must be a string";
 		case "slug": return matches(SLUG_PATTERN) ? null : "must be a lower-case slug";
@@ -1167,6 +1284,7 @@ const checkSettings = (field, path, definition) => {
 		if (!source) issues.push(issue(`${path}/settings/sourceFieldId`, "UNKNOWN_FIELD_REFERENCE", "refers to no field of this definition"));
 		else if (source.type !== "string" && source.type !== "text") issues.push(issue(`${path}/settings/sourceFieldId`, "INVALID_FIELD_REFERENCE", "must refer to a string or text field"));
 	}
+	if (field.type === "code" && field.settings.validate && field.settings.language !== "json") issues.push(issue(`${path}/settings/validate`, "INVALID_SETTINGS", "only a json code field can be validated"));
 	if (field.type === "richtext" && field.settings.formatVersion !== 1) issues.push(issue(`${path}/settings/formatVersion`, "INVALID_SETTINGS", "unsupported rich-text format version"));
 	if (field.type === "relation" && !isStableId(field.settings.target)) issues.push(issue(`${path}/settings/target`, "INVALID_ID", "must be the ID of a model"));
 	if (field.type === "component" && !isStableId(field.settings.component)) issues.push(issue(`${path}/settings/component`, "INVALID_ID", "must be the ID of a component"));
@@ -1189,6 +1307,7 @@ const checkFlags = (field, path, isComponent) => {
 			"filterable",
 			"sortable"
 		]) if (field[flag]) reject(flag, `fields of a component cannot be ${flag}`);
+		if (field.width !== void 0) reject("width", "fields of a component have no width");
 	}
 	if (field.deprecated && field.required) reject("required", "a deprecated field cannot be required");
 	return issues;
@@ -1642,7 +1761,8 @@ const DEFINITION_METADATA = [
 const FIELD_METADATA = [
 	"label",
 	"description",
-	"defaultValue"
+	"defaultValue",
+	"width"
 ];
 const FIELD_FLAGS = [
 	["required", "field.required"],
@@ -1813,6 +1933,7 @@ const hasIndex = (field) => Boolean(field && (field.filterable || field.sortable
 const API_SCALAR = {
 	string: "String",
 	text: "String",
+	code: "String",
 	slug: "String",
 	email: "String",
 	url: "String",
@@ -1834,6 +1955,12 @@ const API_SCALAR = {
 	dynamiczone: "DynamicZone"
 };
 const PLAIN_TEXT_TYPES = /* @__PURE__ */ new Set(["string", "text"]);
+/** Types any string value is valid for, so a same-family change to one without constraints only widens. */
+const TEXT_TARGETS = /* @__PURE__ */ new Set([
+	"string",
+	"text",
+	"code"
+]);
 const SCALAR_FAMILIES = /* @__PURE__ */ new Set([
 	"jsonString",
 	"jsonNumber",
@@ -1842,23 +1969,23 @@ const SCALAR_FAMILIES = /* @__PURE__ */ new Set([
 ]);
 const hasTextConstraints = (field) => {
 	const settings = field?.settings ?? {};
-	return settings.minLength !== void 0 || settings.maxLength !== void 0 || settings.pattern !== void 0;
+	return settings.minLength !== void 0 || settings.maxLength !== void 0 || settings.pattern !== void 0 || settings.validate === true;
 };
 /**
 * A type change. Within one storage family the stored JSON stays as it is: widening is live, anything else
 * re-validates existing values. Across families Shapio converts values with a job, for the pairs it knows.
 */
 const classifyTypeChange = (from, to, after) => {
-	const breaking = API_SCALAR[from] !== API_SCALAR[to];
+	const breaking = API_SCALAR[from] !== API_SCALAR[to] || to === "code" && from !== "code";
 	const fromFamily = STORAGE_FAMILY[from];
 	const toFamily = STORAGE_FAMILY[to];
-	if (fromFamily === toFamily) return fromFamily === "jsonString" && PLAIN_TEXT_TYPES.has(to) && !hasTextConstraints(after) || from === "integer" && to === "number" || from === "biginteger" && to === "decimal" && after?.type === "decimal" && after.settings.precision === void 0 ? result("additive", { breaking }) : result("validation", {
+	if (fromFamily === toFamily) return fromFamily === "jsonString" && TEXT_TARGETS.has(to) && !hasTextConstraints(after) || from === "integer" && to === "number" || from === "biginteger" && to === "decimal" && after?.type === "decimal" && after.settings.precision === void 0 ? result("additive", { breaking }) : result("validation", {
 		breaking,
 		prerequisites: ["validateValues"]
 	});
 	const numericPair = fromFamily === "jsonNumber" && toFamily === "numericString" || fromFamily === "numericString" && toFamily === "jsonNumber";
 	const toText = SCALAR_FAMILIES.has(fromFamily) && PLAIN_TEXT_TYPES.has(to);
-	const textToRichtext = fromFamily === "jsonString" && to === "richtext";
+	const textToRichtext = fromFamily === "jsonString" && from !== "code" && to === "richtext";
 	const richtextToText = from === "richtext" && PLAIN_TEXT_TYPES.has(to);
 	const supported = numericPair || toText || textToRichtext || richtextToText;
 	return result("conversion", {
@@ -1905,7 +2032,9 @@ const classifySettingsChange = (change) => {
 		case "components":
 		case "allowedKinds":
 		case "protocols": return validation(to !== void 0 && (from === void 0 || removesAny(from, to)));
-		case "sourceFieldId": return result("metadata");
+		case "sourceFieldId":
+		case "language": return result("metadata");
+		case "validate": return validation(to === true);
 		case "multiple":
 		case "repeatable":
 		case "cardinality": return result("conversion", {
@@ -2367,6 +2496,17 @@ const plainTextToRichText = (text) => {
 	};
 };
 //#endregion
+//#region src/richtext/plainText.ts
+/**
+* A stored rich text value (`{ format, version, doc }`) as one line of plain text: blocks separated by a
+* space, whitespace collapsed. For summaries (list cells, collapsed items, review rows), never for delivery.
+* Anything that is not a valid document (an unconverted value of a field that became rich text) reads as ''.
+*/
+const richTextPlainText = (value) => {
+	const result = validateRichText(value);
+	return result.ok ? richTextToPlainText(result.document).replace(/\s+/g, " ").trim() : "";
+};
+//#endregion
 //#region src/themes/tokens.ts
 /**
 * Admin themes (docs/plans/themes.md): a theme is a named, complete set of these tokens for a light variant, a
@@ -2633,6 +2773,6 @@ const SeoDefaultsSchema = Type.Object({
 	twitterHandle: Type.Union([Type.String({ pattern: SEO_TWITTER_HANDLE_PATTERN.source }), Type.Null()])
 }, closed);
 //#endregion
-export { API_KEY_PATTERN, BIGINTEGER_PATTERN, BUILT_IN_THEME_KEYS, CANVAS_ELIGIBLE, CHANGE_KINDS, COMPONENT_TYPE_SUFFIXES, CUSTOM_EDITOR_ID_PATTERN, ComponentDefinitionInputSchema, ComponentDisplayInputSchema, DATA_TYPES, DATETIME_PATTERN, DATE_PATTERN, DECIMAL_PATTERN, DEFAULT_EDITORS, DEFAULT_SEO_KEYS, DEFINITION_KINDS, DefinitionInputSchema, EDITOR_CATALOGUE, EMPTY_SEO_DEFAULTS, EditorChoiceInputSchema, EnumValueSchema, FieldInputSchema, INLINE_TITLE_TYPES, LOCALE_CODE_PATTERN, LOCK_FILE_FORMAT_VERSION, LOCK_FILE_PATH, LocaleInputSchema, LockEntrySchema, LockFileError, LockFileSchema, MARK_RULES, MAX_API_KEY_LENGTH, MAX_COMPONENT_DEPTH, MAX_DESCRIPTION_LENGTH, MAX_FALLBACK_CHAIN, MAX_FIELDS_PER_DEFINITION, MAX_LABEL_LENGTH, MAX_RICHTEXT_DEPTH, MEDIA_KINDS, MODEL_KINDS, MODEL_TYPE_SUFFIXES, MUTATION_PREFIXES, ModelDefinitionInputSchema, ModelDisplayInputSchema, NODE_RULES, PLURAL_FALLBACK_SUFFIX, REFERENCE_DATA_TYPES, RELATION_CARDINALITIES, RESERVED_DEFINITION_API_KEYS, RESERVED_FIELD_API_KEYS, RESERVED_QUERY_NAMES, RESERVED_TYPE_NAMES, RICHTEXT_FORMAT, RICHTEXT_FORMAT_VERSION, SAFE_LINK_PATTERN, SCALAR_DATA_TYPES, SCHEMA_KIND_DIRECTORIES, SEO_COMPONENT_API_KEY, SEO_COMPONENT_ID, SEO_DESCRIPTION_SOFT_MAX, SEO_EDITOR_ID, SEO_FIELD_IDS, SEO_TITLE_PLACEHOLDER, SEO_TITLE_SOFT_MAX, SEO_TITLE_TEMPLATE_PATTERN, SEO_TWITTER_HANDLE_PATTERN, SETTINGS_SCHEMAS, SITES_DIRECTORY, SLUG_PATTERN, SORT_DIRECTIONS, STABLE_ID_PATTERN, STORAGE_FAMILY, STRIP_DEFAULT_COUNT, SchemaValidationError, SeoDefaultsSchema, SeoLocaleDefaultsSchema, TEXT_TITLE_FIELD_TYPES, THEME_BRAND_TOKENS, THEME_COLOUR_PATTERN, THEME_DARK_UI_PAIRS, THEME_KEY_PATTERN, THEME_SEMANTIC_TOKENS, THEME_TEXT_PAIRS, THEME_TOKENS, THEME_UI_PAIRS, THEME_VARIANTS, TIME_PATTERN, TITLE_FIELD_TYPES, UID_PATTERN, UNIQUE_CAPABLE_DATA_TYPES, applyTitleTemplate, assignIds, canonicalJson, checkApiKeySyntax, checkDefaultValue, checkThemeContrast, classifyChange, classifyChanges, classifyLocaleChange, collectionQueryName, contrastRatio, createStableId, decideSync, diffDefinitions, effectiveLayout, effectiveTitleField, embeddedComponentIds, escapeHtml, findDependentModels, findReferencingDefinitions, foldApiKey, generatedNames, hashDefinition, isApiKeySyntaxValid, isCanvasEligible, isComponentDefinition, isCoverEligible, isCustomEditorId, isDataType, isDocumentPlaceable, isEmptyRichText, isModelDefinition, isSeoField, isStableId, isValidTitleTemplate, issue, listCompatibleEditors, lockCoversSite, lockEntriesForSite, mergePulledLock, normalizeDefinition, parseDefinition, parseLockFile, plainTextToRichText, renderRichTextHtml, renormalizeDefinition, resolveSeo, richTextMediaIds, richTextToPlainText, routeKeyOf, schemaFilePath, scopeDirectory, scopeOfSchemaFilePath, seoComponentDefinition, seoDefaultsForLocale, serializeDefinition, serializeLockFile, sha256, stripFieldsOf, suggestPlural, summarizeChanges, toTypeName, upgradeLockFile, validateDefinition, validateRichText, validateSchema, withDerivedPlural, withSiteCovered };
+export { API_KEY_PATTERN, BIGINTEGER_PATTERN, BUILT_IN_THEME_KEYS, CANVAS_ELIGIBLE, CHANGE_KINDS, CODE_LANGUAGES, COMPONENT_TYPE_SUFFIXES, CUSTOM_EDITOR_ID_PATTERN, ComponentDefinitionInputSchema, ComponentDisplayInputSchema, DATA_TYPES, DATETIME_PATTERN, DATE_PATTERN, DECIMAL_PATTERN, DEFAULT_EDITORS, DEFAULT_SEO_KEYS, DEFINITION_KINDS, DefinitionInputSchema, EDITOR_CATALOGUE, EMPTY_SEO_DEFAULTS, ENTRY_LAYOUTS, EditorChoiceInputSchema, EnumValueSchema, FIELD_WIDTHS, FieldInputSchema, INLINE_TITLE_TYPES, LOCALE_CODE_PATTERN, LOCK_FILE_FORMAT_VERSION, LOCK_FILE_PATH, LocaleInputSchema, LockEntrySchema, LockFileError, LockFileSchema, MARK_RULES, MAX_API_KEY_LENGTH, MAX_COMPONENT_DEPTH, MAX_DESCRIPTION_LENGTH, MAX_FALLBACK_CHAIN, MAX_FIELDS_PER_DEFINITION, MAX_LABEL_LENGTH, MAX_RICHTEXT_DEPTH, MEDIA_KINDS, MODEL_KINDS, MODEL_TYPE_SUFFIXES, MUTATION_PREFIXES, ModelDefinitionInputSchema, ModelDisplayInputSchema, NODE_RULES, PLURAL_FALLBACK_SUFFIX, REFERENCE_DATA_TYPES, RELATION_CARDINALITIES, RESERVED_DEFINITION_API_KEYS, RESERVED_FIELD_API_KEYS, RESERVED_QUERY_NAMES, RESERVED_TYPE_NAMES, RICHTEXT_FORMAT, RICHTEXT_FORMAT_VERSION, SAFE_LINK_PATTERN, SCALAR_DATA_TYPES, SCHEMA_KIND_DIRECTORIES, SEO_COMPONENT_API_KEY, SEO_COMPONENT_ID, SEO_DESCRIPTION_SOFT_MAX, SEO_EDITOR_ID, SEO_FIELD_IDS, SEO_TITLE_PLACEHOLDER, SEO_TITLE_SOFT_MAX, SEO_TITLE_TEMPLATE_PATTERN, SEO_TWITTER_HANDLE_PATTERN, SETTINGS_SCHEMAS, SITES_DIRECTORY, SLUG_PATTERN, SORT_DIRECTIONS, STABLE_ID_PATTERN, STORAGE_FAMILY, STRIP_DEFAULT_COUNT, SchemaValidationError, SeoDefaultsSchema, SeoLocaleDefaultsSchema, TEXT_TITLE_FIELD_TYPES, THEME_BRAND_TOKENS, THEME_COLOUR_PATTERN, THEME_DARK_UI_PAIRS, THEME_KEY_PATTERN, THEME_SEMANTIC_TOKENS, THEME_TEXT_PAIRS, THEME_TOKENS, THEME_UI_PAIRS, THEME_VARIANTS, TIME_PATTERN, TITLE_FIELD_TYPES, UID_PATTERN, UNIQUE_CAPABLE_DATA_TYPES, applyTitleTemplate, assignIds, canonicalJson, checkApiKeySyntax, checkDefaultValue, checkThemeContrast, classifyChange, classifyChanges, classifyLocaleChange, collectionQueryName, contrastRatio, createStableId, decideSync, diffDefinitions, effectiveFormLayout, effectiveLayout, effectiveTitleField, embeddedComponentIds, entryLayoutOf, escapeHtml, findDependentModels, findReferencingDefinitions, foldApiKey, generatedNames, hashDefinition, isApiKeySyntaxValid, isCanvasEligible, isComponentDefinition, isCoverEligible, isCustomEditorId, isDataType, isDocumentPlaceable, isEmptyRichText, isModelDefinition, isSeoField, isStableId, isValidTitleTemplate, issue, listCompatibleEditors, lockCoversSite, lockEntriesForSite, mergePulledLock, normalizeDefinition, parseDefinition, parseLockFile, plainTextToRichText, renderRichTextHtml, renormalizeDefinition, resolveSeo, richTextBodyOf, richTextMediaIds, richTextPlainText, richTextToPlainText, routeKeyOf, schemaFilePath, scopeDirectory, scopeOfSchemaFilePath, seoComponentDefinition, seoDefaultsForLocale, serializeDefinition, serializeLockFile, sha256, stripFieldsOf, suggestPlural, summarizeChanges, toTypeName, upgradeLockFile, validateDefinition, validateRichText, validateSchema, withDerivedPlural, withSiteCovered };
 
 //# sourceMappingURL=index.js.map