@relyio/cli 0.8.0 → 0.9.0

package/dist/index.js

@@ -928,10 +928,10 @@ var init_exit_codes = __esm({
   }
 });
 
-// ../../platform/api-contract/dist/chunk-PPSLKRFU.js
+// ../../platform/api-contract/dist/chunk-WE6ZXIJM.js
 var ERROR_CODES;
-var init_chunk_PPSLKRFU = __esm({
-  "../../platform/api-contract/dist/chunk-PPSLKRFU.js"() {
+var init_chunk_WE6ZXIJM = __esm({
+  "../../platform/api-contract/dist/chunk-WE6ZXIJM.js"() {
     ERROR_CODES = {
       MISSING_API_KEY: { status: 401 },
       INVALID_API_KEY: { status: 401 },
@@ -1088,6 +1088,23 @@ var init_chunk_PPSLKRFU = __esm({
        * approval (REL-2053).
        */
       ORGANIZATION_BEING_DELETED: { status: 409 },
+      /**
+       * Added by REL-2200, the ninth name added to §4's approved seventeen.
+       *
+       * The Project's data region promises residency — today the EU — and RelyIO has no AI that
+       * processes inside it yet, so every AI request for the Project is refused before any provider is
+       * called (`multi-region-spec.md` decision 17 as amended 2026-10-08, MR6a,
+       * `INV-MR-AI-STAYS-IN-REGION`). `details.region` names the Project's data region. It passes
+       * Decision 3's test: a client reading it stops offering AI for that Project and says why, which no
+       * other code tells it — `PLAN_FEATURE_UNAVAILABLE` sends the customer to upgrade a Plan that would
+       * change nothing, and `PROJECT_IN_ANOTHER_CELL` to a cell that would refuse the same way. 403
+       * because the request is understood and refused for what the Project is, and no retry, credential
+       * or Plan changes that; MR6 lifts it by giving the region an AI that stays inside it.
+       *
+       * A **customer-facing naming decision**, approved by the product owner on
+       * 2026-10-08 (REL-2200, MR6a).
+       */
+      AI_UNAVAILABLE_IN_REGION: { status: 403 },
       RESOURCE_NOT_FOUND: { status: 404 },
       RESOURCE_CONFLICT: { status: 409 },
       RESOURCE_EXPIRED: { status: 410 },
@@ -1134,7 +1151,7 @@ function readError(body) {
 var ContractBodyError;
 var init_client2 = __esm({
   "../../platform/api-contract/dist/client/index.js"() {
-    init_chunk_PPSLKRFU();
+    init_chunk_WE6ZXIJM();
     ContractBodyError = class extends Error {
       body;
       constructor(message, body) {
@@ -1276,15 +1293,89 @@ var init_manage = __esm({
   }
 });
 
-// ../../domain/schema/dist/chunk-GCR57WZV.js
-var TIME_ZONE_HANDLING;
-var init_chunk_GCR57WZV = __esm({
-  "../../domain/schema/dist/chunk-GCR57WZV.js"() {
+// ../../domain/schema/dist/chunk-MGMW4ZMJ.js
+function slugProblems(value) {
+  return [
+    ...value.startsWith("/") ? ["it starts with a slash"] : [],
+    ...value.endsWith("/") ? ["it ends with a slash"] : [],
+    ...value.includes("//") ? ["it has an empty segment (two slashes in a row)"] : []
+  ];
+}
+var SLUG_MAX_LENGTH, SLUG_DEFAULT_MAX_LENGTH, FIELD_FORMAT_CODE_KEY, URL_VALUE_FORMAT, SITE_RELATIVE_PATH, FieldFormats, ConfiguredFieldFormats, TIME_ZONE_HANDLING;
+var init_chunk_MGMW4ZMJ = __esm({
+  "../../domain/schema/dist/chunk-MGMW4ZMJ.js"() {
+    SLUG_MAX_LENGTH = 255;
+    SLUG_DEFAULT_MAX_LENGTH = 100;
+    FIELD_FORMAT_CODE_KEY = "x-formatCode";
+    URL_VALUE_FORMAT = "url";
+    SITE_RELATIVE_PATH = /^\/(?!\/)/;
+    FieldFormats = {
+      slug: {
+        code: "slug",
+        pattern: /^[a-z0-9]+(?:-[a-z0-9]+)*(?:\/[a-z0-9]+(?:-[a-z0-9]+)*)*$/,
+        message: "can only contain lowercase letters, numbers and hyphens, in segments separated by a slash, with no leading, trailing or repeated hyphen or slash",
+        problemsOf: slugProblems
+      },
+      email: {
+        code: "email",
+        pattern: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+        message: "must be a valid email address"
+      },
+      uuid: {
+        code: "uuid",
+        pattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+        message: "must be a valid UUID"
+      },
+      phone: {
+        code: "phone",
+        pattern: /^[+]?[\d\s\-()]{7,15}$/,
+        message: "must be a valid phone number"
+      }
+    };
+    ConfiguredFieldFormats = {
+      /** An email field restricted to a `config.domainWhitelist`. */
+      emailDomain: {
+        code: "emailDomain",
+        message: "must be from an allowed domain"
+      },
+      /** A URL field restricted to `config.allowedProtocols`. */
+      urlProtocol: {
+        code: "urlProtocol",
+        message: "must use an allowed protocol"
+      }
+    };
     TIME_ZONE_HANDLING = ["UTC", "local"];
   }
 });
 
-// ../../domain/schema/dist/chunk-7HSDWMYK.js
+// ../../domain/schema/dist/chunk-DERETXFC.js
+var JSON_SCHEMA_TYPES, JSON_SCHEMA_FORMATS;
+var init_chunk_DERETXFC = __esm({
+  "../../domain/schema/dist/chunk-DERETXFC.js"() {
+    JSON_SCHEMA_TYPES = [
+      "string",
+      "number",
+      "integer",
+      "boolean",
+      "object",
+      "array",
+      "null"
+    ];
+    JSON_SCHEMA_FORMATS = [
+      "date",
+      "time",
+      "date-time",
+      "email",
+      "hostname",
+      "ipv4",
+      "ipv6",
+      "uri",
+      "uuid"
+    ];
+  }
+});
+
+// ../../domain/schema/dist/chunk-VFLLYTDW.js
 function isFieldKind(type) {
   return KIND_SET.has(type);
 }
@@ -1295,17 +1386,13 @@ function parseFieldType(type) {
 function isKind(type, kind) {
   return type === kind;
 }
-function holdsReferenceValue(type) {
-  const declaration = fieldKindDeclarationOf(type);
-  return declaration !== null && declaration.references === "value";
-}
 function fieldKindDeclarationOf(type) {
   const parsed = parseFieldType(type);
   return parsed.key === null ? null : FIELD_KIND_DECLARATIONS[parsed.key];
 }
-var FIELD_KINDS, KIND_SET, TEXT_OPERATORS, LONG_TEXT_OPERATORS, NUMERIC_OPERATORS, BOOLEAN_OPERATORS, ENUM_OPERATORS, DATE_OPERATORS, REFERENCE_OPERATORS, TAGS_OPERATORS, NO_AI_CONSTRAINT, EMPTY_RICH_TEXT, PLAIN_TEXT_LIVE, VALUE_LIVE, WHOLE_VALUE_LOCALE, QUESTIONED_LOCALE, NOT_FILTERED, NOT_SEARCHED, NO_CHANGE, ONE_OR_LIST, FIELD_KIND_DECLARATIONS;
-var init_chunk_7HSDWMYK = __esm({
-  "../../domain/schema/dist/chunk-7HSDWMYK.js"() {
+var FIELD_KINDS, KIND_SET, TEXT_OPERATORS, LONG_TEXT_OPERATORS, NUMERIC_OPERATORS, BOOLEAN_OPERATORS, ENUM_OPERATORS, DATE_OPERATORS, REFERENCE_OPERATORS, TAGS_OPERATORS, EMPTY_RICH_TEXT, PLAIN_TEXT_LIVE, VALUE_LIVE, WHOLE_VALUE_LOCALE, QUESTIONED_LOCALE, NOT_FILTERED, NOT_SEARCHED, NO_CHANGE, ONE_OR_LIST, FIELD_KIND_DECLARATIONS;
+var init_chunk_VFLLYTDW = __esm({
+  "../../domain/schema/dist/chunk-VFLLYTDW.js"() {
     FIELD_KINDS = [
       // Text
       "shortText",
@@ -1331,7 +1418,9 @@ var init_chunk_7HSDWMYK = __esm({
       // Composite
       "tags",
       "list",
-      "object"
+      "object",
+      // Data nobody models (REL-1811): any JSON value, held to the field's JSON Schema when it gives one
+      "json"
     ];
     KIND_SET = new Set(FIELD_KINDS);
     TEXT_OPERATORS = [
@@ -1400,7 +1489,6 @@ var init_chunk_7HSDWMYK = __esm({
       "isEmpty",
       "hasValue"
     ];
-    NO_AI_CONSTRAINT = { jsonSchema: {} };
     EMPTY_RICH_TEXT = Object.freeze({
       _type: "richText",
       version: 1,
@@ -1425,7 +1513,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: "prose", treatments: ["autocomplete", "string", "token"] },
         filter: { kind: "text", viewOperators: TEXT_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "text", text: "plain" } }
       },
       longText: {
         change: { convertsTo: ["shortText"], backfill: null },
@@ -1437,7 +1525,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: "prose", treatments: ["string"] },
         filter: { kind: "text", viewOperators: LONG_TEXT_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "text", text: "plain" } }
       },
       richText: {
         change: NO_CHANGE,
@@ -1448,10 +1536,14 @@ var init_chunk_7HSDWMYK = __esm({
         // The tree holding nothing. Frozen, as every facet value is shared: a read fills a fresh one
         // (`./empty`'s `freshEmptyValue`)
         empty: { value: EMPTY_RICH_TEXT },
-        search: { embed: "prose", treatments: ["string"] },
+        // The tree is an object, which Atlas indexes under no mapping, so its path is mapped with nothing:
+        // keyword search asks its plain-text twin, which `entries_search` maps as `string` (REL-2089,
+        // `@relyio/content-db`'s `search-text`)
+        search: { embed: "prose", treatments: [] },
         filter: NOT_FILTERED,
-        references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        // Its entry links and its declared nodes' fields (REL-1808)
+        references: "tree",
+        aiTool: { write: { as: "markdown" } }
       },
       // A table as a field's whole value (REL-1806): exactly a rich-text `table` block's value, edited
       // through the same binding — a fragment holding that one table, each cell's text merging
@@ -1466,11 +1558,12 @@ var init_chunk_7HSDWMYK = __esm({
         // never mints a key (REL-1777) — so a required table is required from creation, as an object is
         // (design decision 9, REL-2034).
         empty: null,
-        // Its cells' text, a paragraph a line (`richTextFieldBlockPlainText`), as rich text's
-        search: { embed: "prose", treatments: ["string"] },
+        // Its cells' text, a paragraph a line (`richTextFieldBlockPlainText`), as rich text's — searched
+        // in its plain-text twin, so its path is mapped with nothing (REL-2089)
+        search: { embed: "prose", treatments: [] },
         filter: NOT_FILTERED,
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "markdownBlock", block: "table" } }
       },
       // Code with tabs as a field's whole value (REL-1806): exactly a rich-text `codeGroup` block's
       // value — one tab or more, each with its label, language, filename and line range — so a code
@@ -1483,11 +1576,12 @@ var init_chunk_7HSDWMYK = __esm({
         synthesized: null,
         // No empty value, as a table's: a code group holds a keyed tab or more.
         empty: null,
-        // Its tabs' text, as rich text embeds its code blocks
-        search: { embed: "prose", treatments: ["string"] },
+        // Its tabs' text, as rich text embeds its code blocks — searched in its plain-text twin, so its
+        // path is mapped with nothing (REL-2089)
+        search: { embed: "prose", treatments: [] },
         filter: NOT_FILTERED,
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "markdownBlock", block: "codeGroup" } }
       },
       email: {
         change: NO_CHANGE,
@@ -1499,7 +1593,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: null, treatments: ["token", "string"] },
         filter: { kind: "text", viewOperators: TEXT_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "text", text: "email" } }
       },
       url: {
         change: NO_CHANGE,
@@ -1511,7 +1605,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: null, treatments: ["token", "string"] },
         filter: { kind: "text", viewOperators: TEXT_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "text", text: "url" } }
       },
       slug: {
         change: NO_CHANGE,
@@ -1523,7 +1617,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: null, treatments: ["token", "string"] },
         filter: { kind: "text", viewOperators: TEXT_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "text", text: "slug" } }
       },
       integer: {
         change: { convertsTo: [], backfill: { value: 0 } },
@@ -1535,7 +1629,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: null, treatments: ["number"] },
         filter: { kind: "number", viewOperators: NUMERIC_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "integer" } }
       },
       decimal: {
         // `0`, as `integer`: the old backfill switch's `number` arm, which named no kind (REL-1937).
@@ -1548,7 +1642,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: null, treatments: ["number"] },
         filter: { kind: "number", viewOperators: NUMERIC_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "number" } }
       },
       boolean: {
         change: { convertsTo: [], backfill: { value: false } },
@@ -1560,7 +1654,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: null, treatments: ["boolean"] },
         filter: { kind: "boolean", viewOperators: BOOLEAN_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "boolean" } }
       },
       enum: {
         change: NO_CHANGE,
@@ -1572,7 +1666,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: null, treatments: ["token", "string"] },
         filter: { kind: "choice", viewOperators: ENUM_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "option" } }
       },
       date: {
         change: { convertsTo: [], backfill: { now: "date" } },
@@ -1587,7 +1681,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: null, treatments: ["token"] },
         filter: { kind: "date", viewOperators: DATE_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "text", text: "date" } }
       },
       dateTime: {
         // The instant, as `date` takes the day: the old backfill switch's `datetime` arm, which named
@@ -1601,7 +1695,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: null, treatments: ["token"] },
         filter: { kind: "date", viewOperators: DATE_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "text", text: "date-time" } }
       },
       reference: {
         change: NO_CHANGE,
@@ -1613,7 +1707,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: NOT_SEARCHED,
         filter: { kind: "reference", viewOperators: REFERENCE_OPERATORS },
         references: "value",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "entryId" } }
       },
       tags: {
         change: NO_CHANGE,
@@ -1625,7 +1719,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: { embed: "label", treatments: ["token", "string", "autocomplete"] },
         filter: { kind: "text", viewOperators: TAGS_OPERATORS },
         references: "none",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "strings" } }
       },
       list: {
         change: NO_CHANGE,
@@ -1637,7 +1731,7 @@ var init_chunk_7HSDWMYK = __esm({
         search: NOT_SEARCHED,
         filter: NOT_FILTERED,
         references: "fields",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "items" } }
       },
       object: {
         change: NO_CHANGE,
@@ -1655,21 +1749,55 @@ var init_chunk_7HSDWMYK = __esm({
         search: NOT_SEARCHED,
         filter: NOT_FILTERED,
         references: "fields",
-        aiTool: NO_AI_CONSTRAINT
+        aiTool: { write: { as: "item" } }
+      },
+      // Data nobody models (REL-1811, design decision 18): any JSON value, held to the JSON Schema its
+      // config may give (`config.schema`). Its source is collaborative text that merges keystroke by
+      // keystroke (ADR 0014), parsed on save and served parsed.
+      json: {
+        change: NO_CHANGE,
+        value: { shape: "json" },
+        live: { holds: "text", stored: "json" },
+        locale: WHOLE_VALUE_LOCALE,
+        synthesized: null,
+        // No empty value: no one value is one every JSON Schema admits, so a required json field is
+        // required from creation, as a number or an object is (design decision 9)
+        empty: null,
+        // Data, not prose: neither embedded nor keyword-searched, and its path is mapped with nothing
+        search: NOT_SEARCHED,
+        // Not filterable at first (design decision 18): a Filter on one is refused by name
+        filter: NOT_FILTERED,
+        references: "none",
+        aiTool: { write: { as: "json" } }
       }
     };
   }
 });
 
-// ../../domain/schema/dist/chunk-RDFZ6WP6.js
+// ../../domain/schema/dist/chunk-UBAXWQKU.js
 function itemSegmentOf(shapeId) {
   return `${LIST_ITEM_SEGMENT}${shapeId}`;
 }
+function readItemSegment(segment) {
+  if (!segment.startsWith(LIST_ITEM_SEGMENT)) return null;
+  return { shape: segment.length === LIST_ITEM_SEGMENT.length ? null : segment.slice(1) };
+}
 function isItemSegment(segment) {
   return segment.startsWith(LIST_ITEM_SEGMENT);
 }
+function isRichTextTreeSegment(segment) {
+  return readRichTextTreeSegment(segment) !== null;
+}
+function richTextTreeSegmentOf(type) {
+  return `${RICH_TEXT_TREE_SEGMENT}${type}`;
+}
+function readRichTextTreeSegment(segment) {
+  return segment.startsWith(RICH_TEXT_TREE_SEGMENT) && segment.length > 1 ? segment.slice(RICH_TEXT_TREE_SEGMENT.length) : null;
+}
 function includePathOf(walkPath) {
-  return walkPath.split(".").filter((segment) => !isItemSegment(segment)).join(".");
+  const segments = walkPath.split(".");
+  const tree = segments.findIndex((segment) => isRichTextTreeSegment(segment));
+  return (tree === -1 ? segments : segments.slice(0, tree)).filter((segment) => !isItemSegment(segment)).join(".");
 }
 function shapesOf(field) {
   return shapePlacesOf(field).map((place) => place.shape);
@@ -1684,6 +1812,31 @@ function shapePlacesOf(field) {
   if (!Array.isArray(of) || of.length === 0 || !of.every((item) => isShape(item))) return [];
   return of.map((shape, index) => ({ shape, at: `config.of[${index}]` }));
 }
+function richTextShapePlacesOf(field) {
+  if (parseFieldType(field.type).key !== "richText") return [];
+  const config = field.config;
+  if (typeof config !== "object" || config === null) return [];
+  const places = [];
+  for (const option of RICH_TEXT_SHAPE_OPTIONS) {
+    if (!(option in config)) continue;
+    const held = config[option];
+    if (!Array.isArray(held) || !held.every((item) => isShape(item))) continue;
+    for (const [index, shape] of held.entries()) {
+      places.push({ shape, at: `config.${option}[${index}]`, option });
+    }
+  }
+  return places;
+}
+function richTextShapesOf(field) {
+  const places = richTextShapePlacesOf(field);
+  return {
+    blocks: places.filter((place) => place.option === "blocks").map((place) => place.shape),
+    inline: places.filter((place) => place.option === "inline").map((place) => place.shape)
+  };
+}
+function fieldsetPlacesOf(field) {
+  return [...shapePlacesOf(field), ...richTextShapePlacesOf(field)];
+}
 function isShape(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) && "id" in value && typeof value.id === "string" && isSection(value);
 }
@@ -1701,19 +1854,56 @@ function fieldsOfMembers(members) {
   visitMembers(members);
   return fields;
 }
-function walkMembers(members) {
+function walkMembers(members, options = {}) {
   const walked = [];
   for (const field of fieldsOfMembers(members)) {
-    visit(field, [], [], walked);
+    visit(field, [], [], walked, options);
   }
   return walked;
 }
-function walkFieldKinds(field) {
+function walkReferences(members) {
+  const references = [];
+  for (const walked of walkMembers(members, { intoRichText: true })) {
+    if (walked.status !== "declared") continue;
+    const config = walked.field.config ?? {};
+    if (walked.declaration.references === "value") {
+      references.push({
+        path: walked.path,
+        field: walked.field,
+        holds: "reference",
+        to: typeIdsOf(config.to),
+        multi: config.multi === true
+      });
+      continue;
+    }
+    if (walked.declaration.references !== "tree") continue;
+    const links = config.links;
+    const to = typeof links === "object" && links !== null && !Array.isArray(links) ? typeIdsOf(links.to) : [];
+    if (to.length === 0) continue;
+    references.push({
+      path: [
+        ...walked.path,
+        richTextTreeSegmentOf(RICH_TEXT_ENTRY_LINK_TYPE),
+        ENTRY_LINK_TARGET_MEMBER
+      ],
+      field: walked.field,
+      holds: "entryLink",
+      to,
+      multi: true
+    });
+  }
+  return references;
+}
+function typeIdsOf(to) {
+  if (typeof to === "string") return to === "" ? [] : [to];
+  return Array.isArray(to) ? to.filter((id) => typeof id === "string" && id !== "") : [];
+}
+function walkFieldKinds(field, options = {}) {
   const walked = [];
-  visit(field, [], [], walked);
+  visit(field, [], [], walked, options);
   return walked;
 }
-function visit(field, parentPath, shapeStack, walked) {
+function visit(field, parentPath, shapeStack, walked, options) {
   const path25 = [...parentPath, field.id];
   const parsed = parseFieldType(field.type);
   if (parsed.key === null) {
@@ -1721,7 +1911,10 @@ function visit(field, parentPath, shapeStack, walked) {
     return;
   }
   const shapes = shapesOf(field);
-  const cyclic = shapes.find((shape) => shapeStack.includes(shape.id));
+  const treeShapes = options.intoRichText === true ? richTextShapePlacesOf(field) : [];
+  const cyclic = [...shapes, ...treeShapes.map((place) => place.shape)].find(
+    (shape) => shapeStack.includes(shape.id)
+  );
   if (cyclic !== void 0) {
     walked.push({ status: "shapeCycle", path: path25, field, shapeId: cyclic.id });
     return;
@@ -1735,9 +1928,65 @@ function visit(field, parentPath, shapeStack, walked) {
   });
   for (const shape of shapes) {
     for (const child of fieldsOfMembers(shape.fields)) {
-      visit(child, [...path25, itemSegmentOf(shape.id)], [...shapeStack, shape.id], walked);
+      visit(child, [...path25, itemSegmentOf(shape.id)], [...shapeStack, shape.id], walked, options);
+    }
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const { shape } of treeShapes) {
+    if (seen.has(shape.id)) continue;
+    seen.add(shape.id);
+    for (const child of fieldsOfMembers(shape.fields)) {
+      const segment = richTextTreeSegmentOf(shape.id);
+      visit(child, [...path25, segment], [...shapeStack, shape.id], walked, options);
+    }
+  }
+}
+function richTextTextPathsOf(field) {
+  return walkFieldKinds(field, { intoRichText: true }).flatMap((walked) => {
+    if (walked.status !== "declared" || walked.declaration.search.embed !== "prose") return [];
+    const inside = walked.path.slice(1);
+    if (inside.length === 0 || !isRichTextTreeSegment(inside[0])) return [];
+    return [inside.join(".")];
+  });
+}
+function richTextDeclaredTextOfPaths(paths) {
+  const declared = {};
+  const put = (shape, member, holds) => {
+    const members = declared[shape] ??= {};
+    if (members[member] === void 0) members[member] = holds;
+  };
+  for (const path25 of paths) {
+    const segments = path25.split(".");
+    let shape = null;
+    for (const [index, segment] of segments.entries()) {
+      const tree = readRichTextTreeSegment(segment);
+      if (tree !== null) {
+        shape = tree;
+        continue;
+      }
+      const item = readItemSegment(segment);
+      if (item !== null) {
+        shape = item.shape;
+        continue;
+      }
+      if (shape === null) break;
+      const next = segments[index + 1];
+      const holds = next === void 0 || isRichTextTreeSegment(next) ? "text" : isItemSegment(next) ? "items" : null;
+      if (holds === null) break;
+      put(shape, segment, holds);
+      shape = null;
     }
   }
+  return declared;
+}
+function richTextDeclaredTextOf(field) {
+  return richTextDeclaredTextOfPaths(richTextTextPathsOf(field));
+}
+function isRichTextShapeType(type) {
+  return typeof type === "string" && SHAPE_ID.test(type) && !RESERVED_SHAPE_IDS.has(type);
+}
+function isRichTextShapeNode(node) {
+  return isRecord(node) && isRichTextShapeType(node._type);
 }
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -1817,6 +2066,10 @@ function checkNode(node, at, place, problems, check) {
     return;
   }
   const type = node._type;
+  if (isRichTextShapeType(type)) {
+    checkShapeNode(node, String(type), at, place, problems, check);
+    return;
+  }
   if (typeof type !== "string" || !Object.hasOwn(MEMBERS, type)) {
     problems.push({
       at,
@@ -1965,6 +2218,16 @@ function checkNode(node, at, place, problems, check) {
     }
   }
 }
+function checkShapeNode(node, type, at, place, problems, check) {
+  if (place !== "block" && place !== "inline") {
+    problems.push({
+      at,
+      problem: `is a ${type}, a declared block or inline element, which cannot stand ${PLACES[place].where}`
+    });
+    return;
+  }
+  checkKey(node._key, at, problems, check);
+}
 function isLineNumber(value) {
   return typeof value === "number" && Number.isSafeInteger(value) && value >= 1;
 }
@@ -2016,12 +2279,13 @@ function checkMarks(marks, at, problems) {
     if (order <= previous) {
       problems.push({
         at: markAt,
-        problem: `is out of order or repeated; marks go ${RICH_TEXT_MARK_TYPES.join(", ")}`
+        problem: `is out of order or repeated; marks go ${RICH_TEXT_MARK_ORDER.join(", ")}`
       });
     }
     previous = order;
+    const members = MARK_MEMBERS[mark._type] ?? [];
     for (const member of Object.keys(mark)) {
-      if (member !== "_type" && !(mark._type === "link" && member === "href")) {
+      if (member !== "_type" && !members.includes(member)) {
         problems.push({
           at: `${markAt}.${member}`,
           problem: `is not a member of a ${mark._type} mark`
@@ -2031,8 +2295,28 @@ function checkMarks(marks, at, problems) {
     if (mark._type === "link" && (typeof mark.href !== "string" || mark.href === "")) {
       problems.push({ at: `${markAt}.href`, problem: "must be a non-empty string" });
     }
+    if (mark._type === RICH_TEXT_ENTRY_LINK_TYPE) {
+      if (typeof mark.to !== "string" || mark.to === "") {
+        problems.push({
+          at: `${markAt}.to`,
+          problem: "must be the id of the entry it links to, a non-empty string"
+        });
+      }
+      if (mark.anchor !== void 0 && (typeof mark.anchor !== "string" || mark.anchor === "")) {
+        problems.push({
+          at: `${markAt}.anchor`,
+          problem: "must be a heading anchor on the linked entry, a non-empty string, or absent"
+        });
+      }
+    }
   }
   const types = new Set(marks.map((mark) => isRecord(mark) ? mark._type : void 0));
+  if (types.has("link") && types.has(RICH_TEXT_ENTRY_LINK_TYPE)) {
+    problems.push({
+      at,
+      problem: "holds a link beside an entry link; a run links to one place"
+    });
+  }
   if (marks.length > 1 && types.has("code")) {
     problems.push({ at, problem: "holds code beside another mark; code stands alone" });
   }
@@ -2040,15 +2324,67 @@ function checkMarks(marks, at, problems) {
     problems.push({ at, problem: "holds subscript beside superscript; a run is one or the other" });
   }
 }
+function richTextLinkTargetsOf(links) {
+  if (links === void 0 || links === null) return [];
+  if (Array.isArray(links)) return links;
+  if (!isRecord(links)) return [];
+  const to = links.to;
+  if (typeof to === "string") return [to];
+  return Array.isArray(to) ? to : [];
+}
+function shapesAllowedBy(held) {
+  const allowed = /* @__PURE__ */ new Map();
+  for (const entry of held ?? []) {
+    if (typeof entry === "string") {
+      allowed.set(entry, null);
+      continue;
+    }
+    if (!isRecord(entry) || typeof entry.id !== "string" || !Array.isArray(entry.fields)) continue;
+    const fields = entry.fields.every((field) => typeof field === "string") ? entry.fields : fieldsOfMembers(entry.fields).map((field) => field.id);
+    allowed.set(entry.id, new Set(fields));
+  }
+  return allowed;
+}
 function richTextNarrowingOf(config) {
   const multiline = config.multiline ?? true;
   return {
     // A one-line field holds one paragraph whatever `structure` says; deploy refuses the two together.
     structure: new Set(multiline ? config.structure ?? RICH_TEXT_STRUCTURES : []),
     marks: new Set(config.marks ?? RICH_TEXT_MARK_TYPES),
-    multiline
+    multiline,
+    // A one-line field holds one paragraph and no declared block either; deploy refuses the two together.
+    blocks: multiline ? shapesAllowedBy(config.blocks) : /* @__PURE__ */ new Map(),
+    inline: shapesAllowedBy(config.inline),
+    links: new Set(richTextLinkTargetsOf(config.links))
+  };
+}
+function spelledShapes(allowed) {
+  return [...allowed].map(([id, fields]) => fields === null ? id : { id, fields: [...fields] });
+}
+function richTextNarrowingOptionsOf(narrowing) {
+  return {
+    structure: RICH_TEXT_STRUCTURES.filter((structure) => narrowing.structure.has(structure)),
+    marks: RICH_TEXT_MARK_TYPES.filter((mark) => narrowing.marks.has(mark)),
+    multiline: narrowing.multiline,
+    blocks: spelledShapes(narrowing.blocks),
+    inline: spelledShapes(narrowing.inline),
+    links: [...narrowing.links]
   };
 }
+function shapesLost(before, after) {
+  const lost = [];
+  for (const [id, fields] of before) {
+    const now = after.get(id);
+    if (now === void 0) {
+      lost.push(id);
+      continue;
+    }
+    if (fields === null || now === null) continue;
+    const gone = [...fields].filter((field) => !now.has(field));
+    if (gone.length > 0) lost.push({ id, fields: gone });
+  }
+  return lost;
+}
 function richTextNarrowingLost(before, after) {
   const structure = RICH_TEXT_STRUCTURES.filter(
     (structure2) => before.structure.has(structure2) && !after.structure.has(structure2)
@@ -2057,10 +2393,10 @@ function richTextNarrowingLost(before, after) {
     (mark) => before.marks.has(mark) && !after.marks.has(mark)
   );
   const multiline = before.multiline && !after.multiline;
-  return structure.length === 0 && marks.length === 0 && !multiline ? null : { structure, marks, multiline };
-}
-function isFullRichTextNarrowing(narrowing) {
-  return narrowing.multiline && narrowing.structure.size === RICH_TEXT_STRUCTURES.length && narrowing.marks.size === RICH_TEXT_MARK_TYPES.length;
+  const blocks = shapesLost(before.blocks, after.blocks);
+  const inline = shapesLost(before.inline, after.inline);
+  const links = [...before.links].filter((type) => !after.links.has(type));
+  return structure.length === 0 && marks.length === 0 && !multiline && blocks.length === 0 && inline.length === 0 && links.length === 0 ? null : { structure, marks, multiline, blocks, inline, links };
 }
 function structureOfBlock(block) {
   switch (block._type) {
@@ -2080,7 +2416,13 @@ function structureOfBlock(block) {
     }
   }
 }
-function richTextNarrowingProblems(value, narrowing) {
+function keepsEntryLink(link, narrowing) {
+  if (narrowing.links.size === 0) return false;
+  const type = typeof link.to === "string" ? narrowing.linkTargets?.get(link.to) : void 0;
+  return type === void 0 || narrowing.links.has(type);
+}
+function richTextNarrowingProblems(value, narrowing, linkTargets) {
+  const reading = { ...narrowing, linkTargets };
   const problems = [];
   if (!narrowing.multiline && value.children.length > 1) {
     problems.push({
@@ -2088,15 +2430,49 @@ function richTextNarrowingProblems(value, narrowing) {
       problem: `is a block after the first; this field is one line (multiline: false) and holds ${value.children.length}`
     });
   }
-  narrowingProblemsIn(value.children, "children", narrowing, problems);
+  narrowingProblemsIn(value.children, "children", "block", reading, problems);
   return problems;
 }
-function narrowingProblemsIn(nodes, at, narrowing, problems) {
+function shapeNarrowingProblems(node, here, place, narrowing, problems) {
+  const option = place === "block" ? "blocks" : "inline";
+  const allowed = narrowing[option];
+  const fields = allowed.get(node._type);
+  if (fields === void 0) {
+    problems.push({
+      at: here,
+      problem: `is a ${node._type}, which this field does not declare as ${SHAPE_PLACE_NAMES[place]} (${option}: ${listOf(new Set(allowed.keys()))})`
+    });
+    return;
+  }
+  if (fields === null) return;
+  for (const member of Object.keys(node)) {
+    if (member === "_type" || member === "_key" || fields.has(member)) continue;
+    problems.push({
+      at: `${here}.${member}`,
+      problem: `is not a field the ${node._type} fieldset declares`
+    });
+  }
+}
+function narrowingProblemsIn(nodes, at, place, narrowing, problems) {
   for (const [index, node] of nodes.entries()) {
     const here = `${at}[${index}]`;
+    if (isRichTextShapeNode(node)) {
+      shapeNarrowingProblems(node, here, place, narrowing, problems);
+      continue;
+    }
     switch (node._type) {
       case "text": {
-        for (const [markIndex, mark] of (node.marks ?? []).entries()) {
+        for (const [markIndex, mark] of marksOfRun(node).entries()) {
+          if (mark._type === RICH_TEXT_ENTRY_LINK_TYPE) {
+            if (!keepsEntryLink(mark, narrowing)) {
+              const type = typeof mark.to === "string" ? narrowing.linkTargets?.get(mark.to) : void 0;
+              problems.push({
+                at: `${here}.marks[${markIndex}]`,
+                problem: narrowing.links.size === 0 ? "is an entry link, which this field does not allow (links: none)" : `is an entry link to a ${type}, which this field does not link to (links: ${listOf(narrowing.links)})`
+              });
+            }
+            continue;
+          }
           if (!narrowing.marks.has(mark._type)) {
             problems.push({
               at: `${here}.marks[${markIndex}]`,
@@ -2118,7 +2494,7 @@ function narrowingProblemsIn(nodes, at, narrowing, problems) {
       case "listItem":
       case "tableRow":
       case "tableCell": {
-        narrowingProblemsIn(node.children, `${here}.children`, narrowing, problems);
+        narrowingProblemsIn(node.children, `${here}.children`, "block", narrowing, problems);
         continue;
       }
       case "codeBlock":
@@ -2137,24 +2513,32 @@ function narrowingProblemsIn(nodes, at, narrowing, problems) {
           });
         }
         if ("children" in node && node._type !== "codeGroup") {
-          narrowingProblemsIn(node.children, `${here}.children`, narrowing, problems);
+          const inside = node._type === "paragraph" || node._type === "heading" ? "inline" : "block";
+          narrowingProblemsIn(node.children, `${here}.children`, inside, narrowing, problems);
         }
         continue;
       }
     }
   }
 }
+function marksOfRun(run3) {
+  return run3.marks ?? [];
+}
 function listOf(allowed) {
   return allowed.size === 0 ? "none" : [...allowed].join(", ");
 }
-var LIST_ITEM_SEGMENT, LIST_ITEM_KEY, LIST_ITEM_TYPE, SHAPED_KINDS, RICH_TEXT_VERSION, RICH_TEXT_TYPE, RICH_TEXT_HEADING_LEVELS, RICH_TEXT_LIST_STYLES, RICH_TEXT_CELL_ALIGNMENTS, RICH_TEXT_MARK_TYPES, MEMBERS, PLACES, MARK_ORDER, RICH_TEXT_STRUCTURES, LIST_STRUCTURE, RICH_TEXT_RESERVED_OPTIONS, STRUCTURE_NAMES;
-var init_chunk_RDFZ6WP6 = __esm({
-  "../../domain/schema/dist/chunk-RDFZ6WP6.js"() {
-    init_chunk_7HSDWMYK();
+var LIST_ITEM_SEGMENT, RICH_TEXT_TREE_SEGMENT, LIST_ITEM_KEY, LIST_ITEM_TYPE, SHAPED_KINDS, RICH_TEXT_SHAPE_OPTIONS, RICH_TEXT_ENTRY_LINK_TYPE, ENTRY_LINK_TARGET_MEMBER, RICH_TEXT_VERSION, RICH_TEXT_TYPE, RICH_TEXT_HEADING_LEVELS, RICH_TEXT_LIST_STYLES, RICH_TEXT_CELL_ALIGNMENTS, RICH_TEXT_MARK_TYPES, RICH_TEXT_MARK_ORDER, RICH_TEXT_KEYED_NODE_TYPES, RICH_TEXT_RESERVED_SHAPE_IDS, RESERVED_SHAPE_IDS, SHAPE_ID, MEMBERS, PLACES, MARK_ORDER, MARK_MEMBERS, RICH_TEXT_STRUCTURES, LIST_STRUCTURE, STRUCTURE_NAMES, SHAPE_PLACE_NAMES;
+var init_chunk_UBAXWQKU = __esm({
+  "../../domain/schema/dist/chunk-UBAXWQKU.js"() {
+    init_chunk_VFLLYTDW();
     LIST_ITEM_SEGMENT = "$";
+    RICH_TEXT_TREE_SEGMENT = "~";
     LIST_ITEM_KEY = "_key";
     LIST_ITEM_TYPE = "_type";
     SHAPED_KINDS = /* @__PURE__ */ new Set(["list", "object"]);
+    RICH_TEXT_SHAPE_OPTIONS = ["blocks", "inline"];
+    RICH_TEXT_ENTRY_LINK_TYPE = "entryLink";
+    ENTRY_LINK_TARGET_MEMBER = "to";
     RICH_TEXT_VERSION = 1;
     RICH_TEXT_TYPE = "richText";
     RICH_TEXT_HEADING_LEVELS = [1, 2, 3, 4, 5, 6];
@@ -2171,6 +2555,34 @@ var init_chunk_RDFZ6WP6 = __esm({
       "subscript",
       "superscript"
     ];
+    RICH_TEXT_MARK_ORDER = [
+      "link",
+      RICH_TEXT_ENTRY_LINK_TYPE,
+      ...RICH_TEXT_MARK_TYPES.filter((type) => type !== "link")
+    ];
+    RICH_TEXT_KEYED_NODE_TYPES = [
+      "paragraph",
+      "heading",
+      "quote",
+      "list",
+      "listItem",
+      "codeBlock",
+      "codeGroup",
+      "table",
+      "tableRow",
+      "tableCell",
+      "divider",
+      "lineBreak"
+    ];
+    RICH_TEXT_RESERVED_SHAPE_IDS = [
+      RICH_TEXT_TYPE,
+      "text",
+      ...RICH_TEXT_KEYED_NODE_TYPES,
+      ...RICH_TEXT_MARK_TYPES,
+      RICH_TEXT_ENTRY_LINK_TYPE
+    ];
+    RESERVED_SHAPE_IDS = new Set(RICH_TEXT_RESERVED_SHAPE_IDS);
+    SHAPE_ID = /^[a-zA-Z][a-zA-Z0-9_]*$/;
     MEMBERS = {
       paragraph: ["_key", "children"],
       heading: ["_key", "level", "children"],
@@ -2208,8 +2620,12 @@ var init_chunk_RDFZ6WP6 = __esm({
       cellBlock: { types: /* @__PURE__ */ new Set(["paragraph"]), where: "inside a table cell" }
     };
     MARK_ORDER = new Map(
-      RICH_TEXT_MARK_TYPES.map((type, index) => [type, index])
+      RICH_TEXT_MARK_ORDER.map((type, index) => [type, index])
     );
+    MARK_MEMBERS = {
+      link: ["href"],
+      [RICH_TEXT_ENTRY_LINK_TYPE]: ["to", "anchor"]
+    };
     RICH_TEXT_STRUCTURES = [
       "heading",
       "quote",
@@ -2226,11 +2642,6 @@ var init_chunk_RDFZ6WP6 = __esm({
       numbered: "numberedList",
       task: "taskList"
     };
-    RICH_TEXT_RESERVED_OPTIONS = {
-      blocks: "REL-1807",
-      inline: "REL-1807",
-      links: "REL-1808"
-    };
     STRUCTURE_NAMES = {
       heading: "a heading",
       quote: "a quote",
@@ -2242,6 +2653,7 @@ var init_chunk_RDFZ6WP6 = __esm({
       table: "a table",
       divider: "a divider"
     };
+    SHAPE_PLACE_NAMES = { block: "a block", inline: "an inline element" };
   }
 });
 
@@ -2310,55 +2722,6 @@ var init_chunk_IJSOONHT = __esm({
     DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
   }
 });
-function distinct(values) {
-  return new Set(values).size === values.length;
-}
-function reserved(option) {
-  const message = `\`${option}\` is reserved for ${RICH_TEXT_RESERVED_OPTIONS[option]}, which implements it; this build does not accept it yet`;
-  return z.never({ errorMap: () => ({ message }) });
-}
-function distinct2(values) {
-  return new Set(values).size === values.length;
-}
-function isCalendarDate(value) {
-  if (!DATE_PATTERN.test(value)) return true;
-  const [year, month, day] = value.split("-").map(Number);
-  const date = new Date(Date.UTC(year, month - 1, day));
-  return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
-}
-function normalizeReferenceTargets(to) {
-  if (to == null) return [];
-  return Array.isArray(to) ? [...to] : [to];
-}
-function resolveReferenceConfigTargets(config, schema) {
-  const typeIds = normalizeReferenceTargets(config?.to);
-  const contentTypeIds = [];
-  const assetTypeIds = [];
-  const unknownTypeIds = [];
-  const contentTypes = schema.contentTypes ?? {};
-  const singletons = schema.singletonContentTypes ?? {};
-  const assetTypes = schema.assetTypes ?? {};
-  for (const id of typeIds) {
-    if (id in contentTypes || id in singletons) {
-      contentTypeIds.push(id);
-    } else if (id in assetTypes) {
-      assetTypeIds.push(id);
-    } else {
-      unknownTypeIds.push(id);
-    }
-  }
-  let family;
-  if (unknownTypeIds.length > 0 && contentTypeIds.length === 0 && assetTypeIds.length === 0) {
-    family = "unknown";
-  } else if (contentTypeIds.length > 0 && assetTypeIds.length > 0) {
-    family = "mixed";
-  } else if (assetTypeIds.length > 0) {
-    family = "asset";
-  } else {
-    family = "content";
-  }
-  return { family, typeIds, contentTypeIds, assetTypeIds, unknownTypeIds };
-}
 function sortDependencyLevels(nodes, dependencies) {
   const nodeSet = new Set(nodes);
   const dependents = /* @__PURE__ */ new Map();
@@ -2495,22 +2858,23 @@ function refineDeclaredReadSets(fields, ctx) {
 }
 function refineShapes(of, kind, ctx) {
   if (of === void 0) return;
+  const words2 = SHAPE_PLACE_WORDS[kind];
   const shapes = Array.isArray(of) ? of : [of];
   const seen = /* @__PURE__ */ new Set();
   for (const [index, shape] of shapes.entries()) {
-    const at = Array.isArray(of) ? ["of", index] : ["of"];
+    const at = Array.isArray(of) ? [words2.option, index] : [words2.option];
     const ids = fieldsOfMembers(shape.fields).map((field) => field.id);
     if (ids.length !== new Set(ids).size) {
       ctx.addIssue({
         code: z.ZodIssueCode.custom,
-        message: `Duplicate field IDs are not allowed within ${kind === "list" ? "a list's" : "an object's"} shape`,
+        message: `Duplicate field IDs are not allowed within ${words2.owner} shape`,
         path: at
       });
     }
     if (seen.has(shape.id)) {
       ctx.addIssue({
         code: z.ZodIssueCode.custom,
-        message: `${kind === "list" ? "A list" : "An object"} takes each shape once: '${shape.id}' is named twice in its 'of'`,
+        message: `${words2.subject} takes each shape once: '${shape.id}' is named twice in its '${words2.option}'`,
         path: [...at, "id"]
       });
     }
@@ -2521,6 +2885,65 @@ function refineShapes(of, kind, ctx) {
     );
   }
 }
+function normalizeReferenceTargets(to) {
+  if (to == null) return [];
+  return Array.isArray(to) ? [...to] : [to];
+}
+function resolveReferenceConfigTargets(config, schema) {
+  const typeIds = normalizeReferenceTargets(config?.to);
+  const contentTypeIds = [];
+  const assetTypeIds = [];
+  const unknownTypeIds = [];
+  const contentTypes = schema.contentTypes ?? {};
+  const singletons = schema.singletonContentTypes ?? {};
+  const assetTypes = schema.assetTypes ?? {};
+  for (const id of typeIds) {
+    if (id in contentTypes || id in singletons) {
+      contentTypeIds.push(id);
+    } else if (id in assetTypes) {
+      assetTypeIds.push(id);
+    } else {
+      unknownTypeIds.push(id);
+    }
+  }
+  let family;
+  if (unknownTypeIds.length > 0 && contentTypeIds.length === 0 && assetTypeIds.length === 0) {
+    family = "unknown";
+  } else if (contentTypeIds.length > 0 && assetTypeIds.length > 0) {
+    family = "mixed";
+  } else if (assetTypeIds.length > 0) {
+    family = "asset";
+  } else {
+    family = "content";
+  }
+  return { family, typeIds, contentTypeIds, assetTypeIds, unknownTypeIds };
+}
+function directiveNameable(id) {
+  return !id.endsWith("_");
+}
+function distinct(values) {
+  return new Set(values).size === values.length;
+}
+function distinct2(values) {
+  return new Set(values).size === values.length;
+}
+function isCalendarDate(value) {
+  if (!DATE_PATTERN.test(value)) return true;
+  const [year, month, day] = value.split("-").map(Number);
+  const date = new Date(Date.UTC(year, month - 1, day));
+  return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+}
+function distinct3(values) {
+  return new Set(values.map((value) => JSON.stringify(value))).size === values.length;
+}
+function compiles(pattern) {
+  try {
+    new RegExp(pattern, "u");
+    return true;
+  } catch {
+    return false;
+  }
+}
 function configDeclarationOf(key) {
   switch (key) {
     case "shortText": {
@@ -2577,6 +3000,9 @@ function configDeclarationOf(key) {
     case "object": {
       return ObjectConfigSchema;
     }
+    case "json": {
+      return JsonConfigSchema;
+    }
   }
 }
 function getFieldConfigSchema(type) {
@@ -2666,13 +3092,14 @@ function filterCapabilitiesOf(kind) {
   const { filter } = FIELD_KIND_DECLARATIONS[kind];
   return { filterable: filter.kind !== null, filterOperators: [...filter.viewOperators] };
 }
-var FallbackChainSchema, BaseFieldConfigSchema, ShortTextConfigSchema, LongTextConfigSchema, RichTextDefaultSchema, RichTextConfigSchema, TableConfigSchema, CodeConfigSchema, DOMAIN, EmailConfigSchema, UrlConfigSchema, SlugConfigSchema, IntegerConfigSchema, DecimalConfigSchema, BooleanConfigSchema, EnumConfigSchema, DATE_PATTERN, CalendarDateSchema, DateConfigSchema, InstantSchema, DateTimeConfigSchema, ReferenceStrengthSchema, OnTargetDeleteSchema, ReferenceTargetSchema, ReferenceConfigSchema, AI_INSTRUCTIONS_MAX_CHARS, AIConfigSchema, FieldAIConfigSchema, AssetAIConfigSchema, UNKNOWN_INPUT_MESSAGE, INPUT_CYCLE_MESSAGE, TagsConfigSchema, ofShapes, ListConfigSchema, ObjectConfigSchema, BaseUIConfigSchema, TextUIOptionsSchema, LongTextUIOptionsSchema, SlugUIOptionsSchema, NumericUIOptionsSchema, BooleanUIOptionsSchema, EnumUIOptionsSchema, DateUIOptionsSchema, DateTimeUIOptionsSchema, ReferenceUIOptionsSchema, TagsUIOptionsSchema, ListUIOptionsSchema, ObjectUIOptionsSchema, UI_OPTIONS_SCHEMAS, UIConfigSchema, RuleConditionSchema, RuleConditionsSchema, VisibilityRuleSchema, RequirementRuleSchema, ValidationRuleSchema, ReadOnlyRuleSchema, FieldRuleSchema, LocalizationConfigSchema, INVALID_FIELD_CONFIG, judgingFieldConfigs, FieldSchema, FIELDSET_ID, TypeMemberSchema, FieldsetSchema, BUILT_IN_ROLES, ROLE_ACTIONS, RoleActionSchema, BuiltInRoleSchema, roleIdPattern, RoleIdSchema, accessTagPattern, AccessTagSchema, AccessTagsArraySchema, ResourcePermissionSchema, FieldVisibilitySchema, RolePermissionsSchema, RoleSchema, RolesArraySchema, COLUMN_RENDERERS, ColumnRendererSchema, FIELD_CAPABILITIES, SYSTEM_FIELD_CAPABILITIES, SYSTEM_FIELD_IDS, CHOICE_OPERATORS, PERSON_OPERATORS, INSTANT_OPERATORS, STUDIO_SYSTEM_FIELD_CAPABILITIES, STUDIO_SYSTEM_FIELD_IDS, FIELD_ICONS;
-var init_chunk_3FBPIG5X = __esm({
-  "../../domain/schema/dist/chunk-3FBPIG5X.js"() {
-    init_chunk_GCR57WZV();
-    init_chunk_RDFZ6WP6();
+var FallbackChainSchema, BaseFieldConfigSchema, ShortTextConfigSchema, LongTextConfigSchema, AI_INSTRUCTIONS_MAX_CHARS, AIConfigSchema, FieldAIConfigSchema, AssetAIConfigSchema, UNKNOWN_INPUT_MESSAGE, INPUT_CYCLE_MESSAGE, TagsConfigSchema, ofShapes, SHAPE_PLACE_WORDS, ListConfigSchema, ObjectConfigSchema, ReferenceStrengthSchema, OnTargetDeleteSchema, ReferenceTargetSchema, ReferenceConfigSchema, RichTextDefaultSchema, declaredShapes, RichTextLinksSchema, RichTextConfigSchema, TableConfigSchema, CodeConfigSchema, DOMAIN, EmailConfigSchema, UrlConfigSchema, SlugConfigSchema, IntegerConfigSchema, DecimalConfigSchema, BooleanConfigSchema, EnumConfigSchema, DATE_PATTERN, CalendarDateSchema, DateConfigSchema, InstantSchema, DateTimeConfigSchema, JsonValueSchema, count, bound, JsonFieldSchemaSchema, JsonConfigSchema, BaseUIConfigSchema, TextUIOptionsSchema, LongTextUIOptionsSchema, SlugUIOptionsSchema, NumericUIOptionsSchema, BooleanUIOptionsSchema, EnumUIOptionsSchema, DateUIOptionsSchema, DateTimeUIOptionsSchema, ReferenceUIOptionsSchema, TagsUIOptionsSchema, ListUIOptionsSchema, ObjectUIOptionsSchema, UI_OPTIONS_SCHEMAS, UIConfigSchema, RuleConditionSchema, RuleConditionsSchema, VisibilityRuleSchema, RequirementRuleSchema, ValidationRuleSchema, ReadOnlyRuleSchema, FieldRuleSchema, LocalizationConfigSchema, INVALID_FIELD_CONFIG, judgingFieldConfigs, FieldSchema, FIELDSET_ID, TypeMemberSchema, FieldsetSchema, BUILT_IN_ROLES, ROLE_ACTIONS, RoleActionSchema, BuiltInRoleSchema, roleIdPattern, RoleIdSchema, accessTagPattern, AccessTagSchema, AccessTagsArraySchema, ResourcePermissionSchema, FieldVisibilitySchema, RolePermissionsSchema, RoleSchema, RolesArraySchema, COLUMN_RENDERERS, ColumnRendererSchema, FIELD_CAPABILITIES, SYSTEM_FIELD_CAPABILITIES, SYSTEM_FIELD_IDS, CHOICE_OPERATORS, PERSON_OPERATORS, INSTANT_OPERATORS, STUDIO_SYSTEM_FIELD_CAPABILITIES, STUDIO_SYSTEM_FIELD_IDS, FIELD_ICONS;
+var init_chunk_QTFIQNJM = __esm({
+  "../../domain/schema/dist/chunk-QTFIQNJM.js"() {
+    init_chunk_MGMW4ZMJ();
+    init_chunk_DERETXFC();
+    init_chunk_UBAXWQKU();
     init_chunk_IJSOONHT();
-    init_chunk_7HSDWMYK();
+    init_chunk_VFLLYTDW();
     FallbackChainSchema = z.object({
       chain: z.array(
         z.discriminatedUnion("method", [
@@ -2734,19 +3161,173 @@ var init_chunk_3FBPIG5X = __esm({
         path: ["maxLength"]
       }
     );
+    AI_INSTRUCTIONS_MAX_CHARS = 1e3;
+    AIConfigSchema = z.object({
+      /**
+       * The AI brief for this element: what it should contain and how to produce
+       * it. Used by the Studio authoring agent, and — on asset types with
+       * `ai.autoGenerate` — by the automatic post-upload run.
+       *
+       * Fallback chain for AI guidance: `ai.instructions` → `ui.description` →
+       * displayName + type.
+       */
+      instructions: z.string().max(AI_INSTRUCTIONS_MAX_CHARS, "ai.instructions must be at most 1000 characters").optional()
+    }).strict();
+    FieldAIConfigSchema = AIConfigSchema.extend({
+      /**
+       * Field ids this instruction reads. Unknown ids and cycles are refused on
+       * the owning type at parse time.
+       */
+      inputs: z.array(z.string().min(1)).optional()
+    });
+    AssetAIConfigSchema = AIConfigSchema.extend({
+      /**
+       * Master switch for automatic, post-upload field generation. When true, the
+       * agent fills each field that has `ai.instructions` (as a proposal). Only
+       * meaningful for image asset types in v1.
+       */
+      autoGenerate: z.boolean().optional()
+    });
+    UNKNOWN_INPUT_MESSAGE = (fieldId, inputId) => `ai.inputs on field '${fieldId}' names unknown field '${inputId}'`;
+    INPUT_CYCLE_MESSAGE = (cycle) => `ai.inputs cycle: ${cycle.join(" \u2192 ")}`;
+    TagsConfigSchema = BaseFieldConfigSchema.extend({
+      allowCustom: z.boolean().optional(),
+      predefinedTags: z.array(z.string()).optional(),
+      maxTags: z.number().min(1).optional()
+    }).refine((data) => data.allowCustom !== false || (data.predefinedTags?.length ?? 0) > 0, {
+      message: "When custom tags are disabled, predefinedTags must list at least one tag",
+      path: ["predefinedTags"]
+    });
+    ofShapes = (kind) => (
+      // Lazy because `FieldsetSchema` reaches `FieldSchema`, which holds a field's config to this
+      // declaration (`refineDeclaredConfig`), so the modules import each other, and whichever is
+      // evaluated second must not read the first's schema while it is still being built.
+      z.lazy(
+        () => z.union([
+          FieldsetSchema,
+          z.array(FieldsetSchema).min(1, `${kind === "list" ? "A list's" : "An object's"} 'of' names at least one fieldset`)
+        ])
+      )
+    );
+    SHAPE_PLACE_WORDS = {
+      list: { owner: "a list's", subject: "A list", option: "of" },
+      object: { owner: "an object's", subject: "An object", option: "of" },
+      blocks: { owner: "a rich-text field's block", subject: "A rich-text field", option: "blocks" },
+      inline: {
+        owner: "a rich-text field's inline element",
+        subject: "A rich-text field",
+        option: "inline"
+      }
+    };
+    ListConfigSchema = BaseFieldConfigSchema.extend({
+      dragAndDrop: z.boolean().optional(),
+      minItems: z.number().min(0).optional(),
+      maxItems: z.number().min(1).optional(),
+      /**
+       * The Shape each item takes: a fieldset, whose fields every item holds beside `_type` (the
+       * fieldset's id) and `_key` (REL-1796, ADR 0012) — or several, a page builder (REL-1798), each
+       * item naming in `_type` the one it takes. A list without one holds strings. Read it through
+       * `shapesOf` (`./field-kinds`), never off the config.
+       */
+      of: ofShapes("list").optional()
+    }).refine(
+      (data) => {
+        if (data.minItems !== void 0 && data.maxItems !== void 0) {
+          return data.minItems <= data.maxItems;
+        }
+        return true;
+      },
+      { message: "minItems must be less than or equal to maxItems", path: ["maxItems"] }
+    ).superRefine((data, ctx) => refineShapes(data.of, "list", ctx));
+    ObjectConfigSchema = BaseFieldConfigSchema.extend({
+      of: ofShapes("object")
+    }).superRefine((data, ctx) => refineShapes(data.of, "object", ctx));
+    ReferenceStrengthSchema = z.enum(["strong", "weak"]).default("strong");
+    OnTargetDeleteSchema = z.enum(["block", "nullify"]).default("block");
+    ReferenceTargetSchema = z.union([z.string().min(1), z.array(z.string().min(1)).min(1)]);
+    ReferenceConfigSchema = BaseFieldConfigSchema.extend({
+      /**
+       * Target entry type id(s) — content type or asset type ids. A single string
+       * for one target, an array for several. All ids must resolve to the same
+       * family (all content types or all asset types); cross-family targets are
+       * rejected by the DataIntegrityValidator (which has schema access).
+       */
+      to: ReferenceTargetSchema,
+      /** Whether the field holds a list of references (true) or a single one. */
+      multi: z.boolean().optional(),
+      /**
+       * The fewest and the most entries a multi reference holds (REL-2033), as a list's `minItems` and
+       * `maxItems`: the customer's limit, enforced on every write and publish. A single reference
+       * holds one, so it takes neither.
+       */
+      minItems: z.number().int().min(0).optional(),
+      maxItems: z.number().int().min(1).optional(),
+      defaultValue: z.union([z.string(), z.array(z.string())]).optional(),
+      /**
+       * Reference strength for publish/unpublish behavior
+       * - 'strong' (default): Hard dependency - blocks publish if target unpublished
+       * - 'weak': Soft dependency - warns but allows, target unpublish nullifies ref
+       */
+      referenceStrength: ReferenceStrengthSchema.optional(),
+      /**
+       * Behavior when referenced entry is deleted
+       * - 'block' (default): Prevents deletion until reference is removed
+       * - 'nullify': Sets reference to null when target deleted
+       */
+      onTargetDelete: OnTargetDeleteSchema.optional()
+    }).superRefine((data, ctx) => {
+      for (const key of ["minItems", "maxItems"]) {
+        if (data[key] !== void 0 && data.multi !== true) {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `${key} applies to a multi reference: set multi: true, or remove ${key}`,
+            path: [key]
+          });
+        }
+      }
+      if (data.minItems !== void 0 && data.maxItems !== void 0 && data.minItems > data.maxItems) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          message: "minItems must be less than or equal to maxItems",
+          path: ["maxItems"]
+        });
+      }
+      if (data.defaultValue !== void 0) {
+        const isMulti2 = data.multi === true;
+        const isArrayDefault = Array.isArray(data.defaultValue);
+        if (isMulti2 && !isArrayDefault) {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "defaultValue must be an array when multi is true",
+            path: ["defaultValue"]
+          });
+        }
+        if (!isMulti2 && isArrayDefault) {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "defaultValue must be a string when multi is false or undefined",
+            path: ["defaultValue"]
+          });
+        }
+      }
+    });
     RichTextDefaultSchema = z.custom(
       (value) => richTextProblems(value).length === 0,
       'A rich-text default value is a version-1 tree ({ _type: "richText", version: 1, children }) with a _key on every node but a text run'
     );
+    declaredShapes = (option) => z.lazy(
+      () => z.array(FieldsetSchema).min(1, `${option} names at least one fieldset; leave it out to declare none`)
+    );
+    RichTextLinksSchema = z.object({ to: ReferenceTargetSchema }).strict();
     RichTextConfigSchema = BaseFieldConfigSchema.extend({
       maxLength: z.number().min(1).optional(),
       defaultValue: RichTextDefaultSchema.optional(),
       structure: z.array(z.enum(RICH_TEXT_STRUCTURES)).refine(distinct, "structure names each built-in block at most once").optional(),
       marks: z.array(z.enum(RICH_TEXT_MARK_TYPES)).refine(distinct, "marks names each mark at most once").optional(),
       multiline: z.boolean().optional(),
-      blocks: reserved("blocks").optional(),
-      inline: reserved("inline").optional(),
-      links: reserved("links").optional()
+      blocks: declaredShapes("blocks").optional(),
+      inline: declaredShapes("inline").optional(),
+      links: RichTextLinksSchema.optional()
     }).superRefine((config, ctx) => {
       if (config.multiline === false && config.structure !== void 0 && config.structure.length > 0) {
         ctx.addIssue({
@@ -2755,6 +3336,43 @@ var init_chunk_3FBPIG5X = __esm({
           message: "A one-line field (multiline: false) holds one paragraph and no other block; drop structure or allow many lines"
         });
       }
+      if (config.multiline === false && config.blocks !== void 0 && config.blocks.length > 0) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          path: ["blocks"],
+          message: "A one-line field (multiline: false) holds one paragraph and no declared block; drop blocks or allow many lines"
+        });
+      }
+      for (const option of ["blocks", "inline"]) {
+        const shapes = config[option];
+        if (shapes === void 0) continue;
+        refineShapes(shapes, option, ctx);
+        for (const [index, shape] of shapes.entries()) {
+          if (RICH_TEXT_RESERVED_SHAPE_IDS.includes(shape.id)) {
+            ctx.addIssue({
+              code: z.ZodIssueCode.custom,
+              path: [option, index, "id"],
+              message: `A fieldset placed in rich text cannot take the name '${shape.id}', which the tree's built-ins and marks use; give it another id`
+            });
+          }
+          if (!directiveNameable(shape.id)) {
+            ctx.addIssue({
+              code: z.ZodIssueCode.custom,
+              path: [option, index, "id"],
+              message: `A fieldset placed in rich text is named in RelyIO Markdown by its id, which cannot end in '_': rename '${shape.id}'`
+            });
+          }
+          if (option !== "blocks") continue;
+          for (const field of fieldsOfMembers(shape.fields)) {
+            if (!isKind(field.type, "richText") || directiveNameable(field.id)) continue;
+            ctx.addIssue({
+              code: z.ZodIssueCode.custom,
+              path: [option, index, "fields"],
+              message: `A rich-text field of a block placed in rich text is named in RelyIO Markdown by its id, which cannot end in '_': rename '${shape.id}.${field.id}'`
+            });
+          }
+        }
+      }
       if (config.defaultValue !== void 0 && richTextProblems(config.defaultValue).length === 0) {
         for (const problem of richTextNarrowingProblems(
           config.defaultValue,
@@ -2818,7 +3436,12 @@ var init_chunk_3FBPIG5X = __esm({
     });
     SlugConfigSchema = BaseFieldConfigSchema.extend({
       sourceField: z.string().optional(),
-      maxLength: z.number().min(1).optional(),
+      // Capped (REL-2149): a slug is read in a URL path, and the hosts that serve one there size their
+      // router to `SLUG_MAX_LENGTH`. A longer `maxLength` would admit slugs the router answers 414.
+      maxLength: z.number().min(1).max(
+        SLUG_MAX_LENGTH,
+        `A slug's maxLength may be at most ${SLUG_MAX_LENGTH}: a slug is read in a URL path, and no longer one is served`
+      ).optional(),
       defaultValue: z.string().optional()
     });
     IntegerConfigSchema = BaseFieldConfigSchema.extend({
@@ -2947,146 +3570,55 @@ var init_chunk_3FBPIG5X = __esm({
         path: ["maxDateTime"]
       }
     );
-    ReferenceStrengthSchema = z.enum(["strong", "weak"]).default("strong");
-    OnTargetDeleteSchema = z.enum(["block", "nullify"]).default("block");
-    ReferenceTargetSchema = z.union([z.string().min(1), z.array(z.string().min(1)).min(1)]);
-    ReferenceConfigSchema = BaseFieldConfigSchema.extend({
-      /**
-       * Target entry type id(s) — content type or asset type ids. A single string
-       * for one target, an array for several. All ids must resolve to the same
-       * family (all content types or all asset types); cross-family targets are
-       * rejected by the DataIntegrityValidator (which has schema access).
-       */
-      to: ReferenceTargetSchema,
-      /** Whether the field holds a list of references (true) or a single one. */
-      multi: z.boolean().optional(),
-      /**
-       * The fewest and the most entries a multi reference holds (REL-2033), as a list's `minItems` and
-       * `maxItems`: the customer's limit, enforced on every write and publish. A single reference
-       * holds one, so it takes neither.
-       */
-      minItems: z.number().int().min(0).optional(),
-      maxItems: z.number().int().min(1).optional(),
-      defaultValue: z.union([z.string(), z.array(z.string())]).optional(),
-      /**
-       * Reference strength for publish/unpublish behavior
-       * - 'strong' (default): Hard dependency - blocks publish if target unpublished
-       * - 'weak': Soft dependency - warns but allows, target unpublish nullifies ref
-       */
-      referenceStrength: ReferenceStrengthSchema.optional(),
-      /**
-       * Behavior when referenced entry is deleted
-       * - 'block' (default): Prevents deletion until reference is removed
-       * - 'nullify': Sets reference to null when target deleted
-       */
-      onTargetDelete: OnTargetDeleteSchema.optional()
-    }).superRefine((data, ctx) => {
-      for (const key of ["minItems", "maxItems"]) {
-        if (data[key] !== void 0 && data.multi !== true) {
-          ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: `${key} applies to a multi reference: set multi: true, or remove ${key}`,
-            path: [key]
-          });
-        }
-      }
-      if (data.minItems !== void 0 && data.maxItems !== void 0 && data.minItems > data.maxItems) {
-        ctx.addIssue({
-          code: z.ZodIssueCode.custom,
-          message: "minItems must be less than or equal to maxItems",
-          path: ["maxItems"]
-        });
-      }
-      if (data.defaultValue !== void 0) {
-        const isMulti2 = data.multi === true;
-        const isArrayDefault = Array.isArray(data.defaultValue);
-        if (isMulti2 && !isArrayDefault) {
-          ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: "defaultValue must be an array when multi is true",
-            path: ["defaultValue"]
-          });
-        }
-        if (!isMulti2 && isArrayDefault) {
-          ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: "defaultValue must be a string when multi is false or undefined",
-            path: ["defaultValue"]
-          });
-        }
-      }
-    });
-    AI_INSTRUCTIONS_MAX_CHARS = 1e3;
-    AIConfigSchema = z.object({
-      /**
-       * The AI brief for this element: what it should contain and how to produce
-       * it. Used by the Studio authoring agent, and — on asset types with
-       * `ai.autoGenerate` — by the automatic post-upload run.
-       *
-       * Fallback chain for AI guidance: `ai.instructions` → `ui.description` →
-       * displayName + type.
-       */
-      instructions: z.string().max(AI_INSTRUCTIONS_MAX_CHARS, "ai.instructions must be at most 1000 characters").optional()
-    }).strict();
-    FieldAIConfigSchema = AIConfigSchema.extend({
-      /**
-       * Field ids this instruction reads. Unknown ids and cycles are refused on
-       * the owning type at parse time.
-       */
-      inputs: z.array(z.string().min(1)).optional()
-    });
-    AssetAIConfigSchema = AIConfigSchema.extend({
-      /**
-       * Master switch for automatic, post-upload field generation. When true, the
-       * agent fills each field that has `ai.instructions` (as a proposal). Only
-       * meaningful for image asset types in v1.
-       */
-      autoGenerate: z.boolean().optional()
-    });
-    UNKNOWN_INPUT_MESSAGE = (fieldId, inputId) => `ai.inputs on field '${fieldId}' names unknown field '${inputId}'`;
-    INPUT_CYCLE_MESSAGE = (cycle) => `ai.inputs cycle: ${cycle.join(" \u2192 ")}`;
-    TagsConfigSchema = BaseFieldConfigSchema.extend({
-      allowCustom: z.boolean().optional(),
-      predefinedTags: z.array(z.string()).optional(),
-      maxTags: z.number().min(1).optional()
-    }).refine((data) => data.allowCustom !== false || (data.predefinedTags?.length ?? 0) > 0, {
-      message: "When custom tags are disabled, predefinedTags must list at least one tag",
-      path: ["predefinedTags"]
-    });
-    ofShapes = (kind) => (
-      // Lazy because `FieldsetSchema` reaches `FieldSchema`, which holds a field's config to this
-      // declaration (`refineDeclaredConfig`), so the modules import each other, and whichever is
-      // evaluated second must not read the first's schema while it is still being built.
-      z.lazy(
-        () => z.union([
-          FieldsetSchema,
-          z.array(FieldsetSchema).min(1, `${kind === "list" ? "A list's" : "An object's"} 'of' names at least one fieldset`)
-        ])
-      )
+    JsonValueSchema = z.lazy(
+      () => z.union([
+        z.string(),
+        z.number().finite(),
+        z.boolean(),
+        z.null(),
+        z.array(JsonValueSchema),
+        z.record(z.string(), JsonValueSchema)
+      ])
     );
-    ListConfigSchema = BaseFieldConfigSchema.extend({
-      dragAndDrop: z.boolean().optional(),
-      minItems: z.number().min(0).optional(),
-      maxItems: z.number().min(1).optional(),
-      /**
-       * The Shape each item takes: a fieldset, whose fields every item holds beside `_type` (the
-       * fieldset's id) and `_key` (REL-1796, ADR 0012) — or several, a page builder (REL-1798), each
-       * item naming in `_type` the one it takes. A list without one holds strings. Read it through
-       * `shapesOf` (`./field-kinds`), never off the config.
-       */
-      of: ofShapes("list").optional()
-    }).refine(
-      (data) => {
-        if (data.minItems !== void 0 && data.maxItems !== void 0) {
-          return data.minItems <= data.maxItems;
-        }
-        return true;
-      },
-      { message: "minItems must be less than or equal to maxItems", path: ["maxItems"] }
-    ).superRefine((data, ctx) => refineShapes(data.of, "list", ctx));
-    ObjectConfigSchema = BaseFieldConfigSchema.extend({
-      of: ofShapes("object")
-    }).superRefine((data, ctx) => refineShapes(data.of, "object", ctx));
+    count = z.number().int().min(0);
+    bound = z.number().finite();
+    JsonFieldSchemaSchema = z.lazy(
+      () => z.object({
+        type: z.union([
+          z.enum(JSON_SCHEMA_TYPES),
+          z.array(z.enum(JSON_SCHEMA_TYPES)).min(1, "type names at least one type").refine(distinct3, "type names each type at most once")
+        ]).optional(),
+        properties: z.record(z.string(), JsonFieldSchemaSchema).optional(),
+        required: z.array(z.string()).refine(distinct3, "required names each property at most once").optional(),
+        additionalProperties: z.union([z.boolean(), JsonFieldSchemaSchema]).optional(),
+        items: JsonFieldSchemaSchema.optional(),
+        enum: z.array(JsonValueSchema).min(1, "enum names at least one value; a schema no value passes is not one to deploy").refine(distinct3, "enum names each value at most once").optional(),
+        const: JsonValueSchema.optional(),
+        anyOf: z.array(JsonFieldSchemaSchema).min(1, "anyOf names at least one schema").optional(),
+        oneOf: z.array(JsonFieldSchemaSchema).min(1, "oneOf names at least one schema").optional(),
+        minLength: count.optional(),
+        maxLength: count.optional(),
+        pattern: z.string().refine(compiles, "pattern is not a regular expression (read with the u flag)").optional(),
+        format: z.enum(JSON_SCHEMA_FORMATS).optional(),
+        minimum: bound.optional(),
+        maximum: bound.optional(),
+        exclusiveMinimum: bound.optional(),
+        exclusiveMaximum: bound.optional(),
+        multipleOf: z.number().finite().positive().optional(),
+        minItems: count.optional(),
+        maxItems: count.optional(),
+        uniqueItems: z.boolean().optional(),
+        minProperties: count.optional(),
+        maxProperties: count.optional(),
+        title: z.string().optional(),
+        description: z.string().optional(),
+        default: JsonValueSchema.optional(),
+        examples: z.array(JsonValueSchema).optional()
+      }).strict()
+    );
+    JsonConfigSchema = BaseFieldConfigSchema.omit({ defaultValue: true }).extend({
+      schema: JsonFieldSchemaSchema.optional()
+    });
     BaseUIConfigSchema = z.object({
       displayName: z.string(),
       description: z.string().optional(),
@@ -3165,7 +3697,9 @@ var init_chunk_3FBPIG5X = __esm({
       reference: ReferenceUIOptionsSchema,
       tags: TagsUIOptionsSchema,
       list: ListUIOptionsSchema,
-      object: ObjectUIOptionsSchema
+      object: ObjectUIOptionsSchema,
+      // Its source is edited as lines of plain text (REL-1811): a placeholder and a height, as long text's
+      json: LongTextUIOptionsSchema
     };
     UIConfigSchema = BaseUIConfigSchema;
     RuleConditionSchema = z.object({
@@ -3567,6 +4101,19 @@ var init_chunk_3FBPIG5X = __esm({
         metadataDisplayable: false,
         metadataRenderer: "none",
         sortable: false
+      },
+      // ─────────────────────────────────────────────────────────────────────────────
+      // DATA
+      // ─────────────────────────────────────────────────────────────────────────────
+      json: {
+        // Not filterable at first (REL-1811, design decision 18): the declaration's `filter` facet
+        ...filterCapabilitiesOf("json"),
+        columnDisplayable: false,
+        // Any JSON value: nothing a column can show in one cell
+        columnRenderer: "none",
+        metadataDisplayable: false,
+        metadataRenderer: "none",
+        sortable: false
       }
     };
     SYSTEM_FIELD_CAPABILITIES = {
@@ -3885,7 +4432,9 @@ var init_chunk_3FBPIG5X = __esm({
       // Composite
       tags: "tags",
       list: "list-tree",
-      object: "box"
+      object: "box",
+      // Data
+      json: "braces"
     };
   }
 });
@@ -3934,9 +4483,9 @@ function inSidebarOrder(views) {
   ).map(({ view }) => view);
 }
 var stageIdPattern, WorkflowEscalationSchema, WorkflowAutoAssignSchema, WorkflowStageSchema, WorkflowConfigSchema, ContentTypeWorkflowSchema, ASSET_KINDS, FORBIDDEN_ASSET_TYPE_FIELD_TYPES, IMAGE_OUTPUT_FORMATS, IMAGE_FIT_MODES, CF_IMAGES_LIMITS, DEFAULT_IMAGE_SOURCE, FitSchema, OutputFormatSchema, ImageTransformSchema, ImageUploadConfigSchema, VideoUploadConfigSchema, FileUploadConfigSchema, ImageExifConfigSchema, VariantDefinitionSchema, ImageSourceConfigSchema, ImageKindConfigSchema, VideoPosterConfigSchema, VideoCaptionsConfigSchema, VideoDownloadConfigSchema, VideoWatermarkConfigSchema, VideoKindConfigSchema, FileScanConfigSchema, FileKindConfigSchema, AssetTypeSchema;
-var init_chunk_TVFFHTGZ = __esm({
-  "../../domain/schema/dist/chunk-TVFFHTGZ.js"() {
-    init_chunk_3FBPIG5X();
+var init_chunk_RFXTOU4J = __esm({
+  "../../domain/schema/dist/chunk-RFXTOU4J.js"() {
+    init_chunk_QTFIQNJM();
     stageIdPattern = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$|^[a-z][a-zA-Z0-9]*$/;
     WorkflowEscalationSchema = z.object({
       /** Roles to notify when stage times out */
@@ -4539,13 +5088,13 @@ function filterValueWith(range, relativeDate) {
   ]);
 }
 var QUERY_BLOCKS, queryBlocksOf, QUERY_BLOCKS_SPELLED, queryRunsBlock, QUERY_FILTER_OPERATORS, isQueryFilterOperator, QUERY_FILTER_OPERATOR_NAMES, SPELLED, INCLUDE_MODIFIER_NAMES, INCLUDE_MODIFIERS, isIncludeModifier, FIELD_PATH, AGGREGATE_OPERATORS, isAggregateOperator, AGGREGATE_OPERATOR_NAMES, MAX_SELECT_OPERATION_ARGUMENT, withoutArguments, SELECT_STRING_OPERATIONS, isSelectStringOperationName, SELECT_STRING_OPERATION_NAMES, OPERATION_SPELLING, NON_NEGATIVE_INTEGER, VIEW_SLUG_PATTERN, VIEW_SLUG_MESSAGE, SCHEMA_VIEW_FILTER_GROUP_REFUSAL, SAVED_VIEW_FILTER_GROUP_REFUSAL, RangeValueSchema, ColumnConfigSchema, MetadataFieldConfigSchema, MetadataLineConfigSchema, TableSettingsSchema, ViewScopeSchema, contentTypeScope, contentTypesScope, allScope, entryTypeScope, DeclaredViewScopeSchema, DeclaredFilterValueSchema, SchemaViewFilterSchema, SchemaViewDefinitionSchema;
-var init_chunk_VIVFUDPH = __esm({
-  "../../domain/schema/dist/chunk-VIVFUDPH.js"() {
+var init_chunk_AUX6CCB5 = __esm({
+  "../../domain/schema/dist/chunk-AUX6CCB5.js"() {
     init_chunk_46JQ2NQ5();
     init_chunk_GR7UT3XN();
-    init_chunk_3FBPIG5X();
-    init_chunk_RDFZ6WP6();
-    init_chunk_7HSDWMYK();
+    init_chunk_QTFIQNJM();
+    init_chunk_UBAXWQKU();
+    init_chunk_VFLLYTDW();
     QUERY_BLOCKS = ["fetch", "aggregate", "search"];
     queryBlocksOf = (query) => QUERY_BLOCKS.filter((block) => Boolean(query[block]));
     QUERY_BLOCKS_SPELLED = QUERY_BLOCKS.join(", ");
@@ -5093,15 +5642,16 @@ function undeclaredFieldTypeMessage(type) {
   return `Invalid field type '${type}'. Valid field types are: ${FIELD_KINDS.join(", ")}`;
 }
 var QUERY_ENDPOINT_SEGMENT, QUERY_ENDPOINT_PATTERN, PARAMETER_EXPRESSION_SOURCE, parameterExpressionMatcher, ANCHORED_PARAMETER_EXPRESSION, parseDefault, parseParameterExpression, collectParameterExpressions, endpointPathParameters, ParameterExpressionStringSchema, QUERY_PARAMETER_TYPES, QueryParameterTypeSchema, QueryParameterScalarSchema, QueryParameterSchema, typeOfDefault, declareQueryParameters, SEARCH_SCORE_SORT_KEYS, isSearchScoreSortKey, FIELD, PATH, SPELLING, Refused, QUERY_SYSTEM_FIELDS, isQuerySystemField, QUERY_STORAGE_PATH_PREFIX, QUERY_SYSTEM_ROOTS, SEARCH_SELECT_COLUMNS, isSearchSelectColumn, parseDynamicParameter, ParameterizedLimitSchema, ParameterizedOffsetSchema, ScalarSchema, WhereOperatorObjectSchema, FilterOperatorObjectSchema, HavingOperatorObjectSchema, WhereValueSchema, WhereConditionSchema, SortConditionSchema, RELATIONSHIP_NAME, IncludeRelationshipSchema, IncludeDefinitionSchema, SelectMappingSchema, FilterDefinitionSchema, FullTextSearchSchema, ContentTypesSchema, SearchBlockSchema, AggregationMetricSchema, QueryCardinalitySchema, QueryCachePolicySchema, FetchBlockSchema, AggregateBlockSchema, IncludeSubQueriesSchema, QueryDefinitionSchema, CACHE_POLICY_STRING, normalizeQueryCachePolicy, CONTENT_API_ROUTE_SEGMENTS, RESERVED_TYPE_IDS, ContentTypeSchema, SettingsGroupSchema, SchemaDefinitionSchema, SavedViewFilterSchema;
-var init_chunk_7GULCWXY = __esm({
-  "../../domain/schema/dist/chunk-7GULCWXY.js"() {
-    init_chunk_TVFFHTGZ();
-    init_chunk_VIVFUDPH();
+var init_chunk_OUTLPFR2 = __esm({
+  "../../domain/schema/dist/chunk-OUTLPFR2.js"() {
+    init_chunk_RFXTOU4J();
+    init_chunk_AUX6CCB5();
     init_chunk_LK3PZTVM();
     init_chunk_GR7UT3XN();
-    init_chunk_3FBPIG5X();
-    init_chunk_RDFZ6WP6();
-    init_chunk_7HSDWMYK();
+    init_chunk_QTFIQNJM();
+    init_chunk_MGMW4ZMJ();
+    init_chunk_UBAXWQKU();
+    init_chunk_VFLLYTDW();
     QUERY_ENDPOINT_SEGMENT = "api";
     QUERY_ENDPOINT_PATTERN = new RegExp(
       String.raw`^\/${QUERY_ENDPOINT_SEGMENT}\/([a-zA-Z0-9\-_/]|\{[a-zA-Z][a-zA-Z0-9_]*\})*$`
@@ -5709,6 +6259,17 @@ var init_chunk_7GULCWXY = __esm({
           });
         }
       }
+      const routedIdCollections = [...typeCollections, ["settingsGroups", "Settings group"]];
+      for (const [collection, label] of routedIdCollections) {
+        for (const typeId of Object.keys(schema[collection] || {})) {
+          if (typeId.length <= SLUG_MAX_LENGTH) continue;
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `${label} ID '${typeId}' is ${typeId.length} characters; an id may be at most ${SLUG_MAX_LENGTH}, the longest path segment the Content API routes. Choose a shorter id.`,
+            path: [collection, typeId]
+          });
+        }
+      }
       const builtInRoles = /* @__PURE__ */ new Set(["admin", "editor", "viewer"]);
       const customRoleIds = new Set(schema.roles?.map((r) => r.id) ?? []);
       const allRoleIds = /* @__PURE__ */ new Set([...builtInRoles, ...customRoleIds]);
@@ -5830,7 +6391,153 @@ var init_chunk_7GULCWXY = __esm({
   }
 });
 
-// ../../domain/schema/dist/chunk-5FYSBHHZ.js
+// ../../domain/schema/dist/chunk-NKUAK5EA.js
+function isContainer(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function declaredFieldsOf(fields) {
+  const root = { children: /* @__PURE__ */ new Map() };
+  for (const walked of walkMembers(fields, { intoRichText: true })) {
+    if (walked.path.some((segment) => typeof segment !== "string")) continue;
+    let node = root;
+    const way = [root];
+    for (const segment of walked.path) {
+      const treeType = readRichTextTreeSegment(segment);
+      node = treeType === null ? childOf(node, segment) : treeShapeOf(node, treeType);
+      way.push(node);
+    }
+    if (walked.status === "declared") {
+      if (isKind(walked.key, "richText")) {
+        node.richText = narrowingOfConfig(walked.field.config);
+        if (node.richText.links.size > 0) for (const on of way) on.linksTypes = true;
+      }
+      const shapes = shapesOf(walked.field);
+      if (shapes.length > 0) node.holds = walked.key === "object" ? "item" : "items";
+      for (const shape of shapes) {
+        const item = childOf(node, itemSegmentOf(shape.id));
+        childOf(item, LIST_ITEM_TYPE);
+        childOf(item, LIST_ITEM_KEY);
+      }
+    }
+  }
+  pruneTrees(root);
+  return root;
+}
+function treeShapeOf(node, shapeId) {
+  node.tree ??= /* @__PURE__ */ new Map();
+  let shape = node.tree.get(shapeId);
+  if (shape === void 0) {
+    shape = { children: /* @__PURE__ */ new Map() };
+    node.tree.set(shapeId, shape);
+  }
+  return shape;
+}
+function pruneTrees(node) {
+  for (const child of node.children.values()) pruneTrees(child);
+  if (node.tree === void 0) return;
+  for (const [shapeId, shape] of node.tree) {
+    pruneTrees(shape);
+    if (![...shape.children.values()].some((field) => holdsBelow(field))) node.tree.delete(shapeId);
+  }
+  if (node.tree.size === 0) delete node.tree;
+}
+function holdsBelow(node) {
+  return node.richText !== void 0 || node.children.size > 0 || node.tree !== void 0 || node.linksTypes === true;
+}
+function childOf(node, segment) {
+  let child = node.children.get(segment);
+  if (child === void 0) {
+    child = { children: /* @__PURE__ */ new Map() };
+    node.children.set(segment, child);
+  }
+  return child;
+}
+function narrowingOfConfig(config) {
+  return richTextNarrowingOf(isContainer(config) ? config : {});
+}
+var init_chunk_NKUAK5EA = __esm({
+  "../../domain/schema/dist/chunk-NKUAK5EA.js"() {
+    init_chunk_UBAXWQKU();
+    init_chunk_VFLLYTDW();
+  }
+});
+
+// ../../domain/schema/dist/chunk-YPAAGSVJ.js
+function isFieldLocalized(field) {
+  const declared = field.localization;
+  if (declared !== void 0 && declared !== null) {
+    if (typeof declared === "boolean") return declared;
+    if (Array.isArray(declared)) return declared.length > 0;
+    if (typeof declared === "object") {
+      return declared.enabled === true;
+    }
+  }
+  return false;
+}
+function parseKeyedPath(path25) {
+  const segments = [];
+  let at = 0;
+  let expectField = true;
+  while (at < path25.length) {
+    if (path25.startsWith(ITEM_SELECTOR, at)) {
+      const previous = segments.at(-1);
+      if (expectField || previous === void 0 || !("field" in previous)) return null;
+      const quoted2 = readQuoted(path25, at + ITEM_SELECTOR.length);
+      if (quoted2 === null || path25[quoted2.end] !== "]") return null;
+      segments.push({ key: quoted2.value });
+      at = quoted2.end + 1;
+      if (at < path25.length && path25[at] !== "." && !path25.startsWith(ITEM_SELECTOR, at)) return null;
+      if (path25[at] === ".") {
+        at += 1;
+        expectField = true;
+      }
+      continue;
+    }
+    let end = at;
+    while (end < path25.length && path25[end] !== "." && path25[end] !== "[") end += 1;
+    const field = path25.slice(at, end);
+    if (field.length === 0) return null;
+    segments.push({ field });
+    expectField = false;
+    at = end;
+    if (path25[at] === ".") {
+      at += 1;
+      expectField = true;
+      if (at === path25.length) return null;
+    } else if (at < path25.length && !path25.startsWith(ITEM_SELECTOR, at)) {
+      return null;
+    }
+  }
+  return segments.length === 0 || expectField ? null : segments;
+}
+function readQuoted(path25, start) {
+  if (path25[start] !== '"') return null;
+  for (let end = start + 1; end < path25.length; end += 1) {
+    if (path25[end] === "\\") {
+      end += 1;
+      continue;
+    }
+    if (path25[end] !== '"') continue;
+    try {
+      const value = JSON.parse(path25.slice(start, end + 1));
+      return typeof value === "string" && value.length > 0 ? { value, end: end + 1 } : null;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+var ITEM_SELECTOR;
+var init_chunk_YPAAGSVJ = __esm({
+  "../../domain/schema/dist/chunk-YPAAGSVJ.js"() {
+    init_chunk_NKUAK5EA();
+    init_chunk_UBAXWQKU();
+    init_chunk_VFLLYTDW();
+    ITEM_SELECTOR = `[${LIST_ITEM_KEY}==`;
+  }
+});
+
+// ../../domain/schema/dist/chunk-JVCO3TTQ.js
 function kindConversionOf(from, to) {
   const source = parseFieldType(from);
   const target = parseFieldType(to);
@@ -5838,9 +6545,12 @@ function kindConversionOf(from, to) {
   const converts = FIELD_KIND_DECLARATIONS[source.key].change.convertsTo;
   return converts.includes(target.key) ? { status: "declared", from: source.key, to: target.key } : { status: "undeclared" };
 }
-var init_chunk_5FYSBHHZ = __esm({
-  "../../domain/schema/dist/chunk-5FYSBHHZ.js"() {
-    init_chunk_7HSDWMYK();
+var init_chunk_JVCO3TTQ = __esm({
+  "../../domain/schema/dist/chunk-JVCO3TTQ.js"() {
+    init_chunk_YPAAGSVJ();
+    init_chunk_NKUAK5EA();
+    init_chunk_UBAXWQKU();
+    init_chunk_VFLLYTDW();
   }
 });
 function emptyDefinition() {
@@ -5903,23 +6613,20 @@ function buildReferenceGraph(reader) {
   const reverse = {};
   for (const type of reader.getAllTypes()) {
     const edges = [];
-    for (const walked of walkMembers(reader.getFieldsForContentType(type.id))) {
-      if (walked.status !== "declared") continue;
-      const { field } = walked;
-      if (!holdsReferenceValue(field.type)) continue;
-      const config = field.config ?? {};
-      const target = reader.resolveReferenceTarget({ config: { to: config.to } });
+    for (const reference of walkReferences(reader.getFieldsForContentType(type.id))) {
+      const target = reader.resolveReferenceTarget({ config: { to: [...reference.to] } });
       if (target.types.length === 0) continue;
       const edge = {
         sourceType: type.id,
-        sourceField: field.id,
-        path: walked.path.join("."),
-        // Only a top-level field is addressable as a pipeline path; a nested one is
-        // reachable only through its logical path, and the caller decides how.
-        ...walked.path.length === 1 ? { mongoPath: `fields.${field.id}` } : {},
+        sourceField: reference.field.id,
+        path: reference.path.join("."),
+        // Only a top-level reference field is addressable as a pipeline path; a nested one — and an
+        // entry link, inside its field's tree — is reachable only through its logical path, and the
+        // caller decides how.
+        ...reference.path.length === 1 ? { mongoPath: `fields.${reference.field.id}` } : {},
         targetTypes: target.types,
         targetKind: target.kind,
-        multi: config.multi === true
+        multi: reference.multi
       };
       edges.push(edge);
       for (const targetType of target.types) {
@@ -5932,10 +6639,9 @@ function buildReferenceGraph(reader) {
   return { forward, reverse };
 }
 var DEFINITION_SECTIONS, KEYED_SECTIONS, SCHEMA_HASH_OPTIONS;
-var init_chunk_W5P6N7TE = __esm({
-  "../../domain/schema/dist/chunk-W5P6N7TE.js"() {
-    init_chunk_RDFZ6WP6();
-    init_chunk_7HSDWMYK();
+var init_chunk_MLQFI2H5 = __esm({
+  "../../domain/schema/dist/chunk-MLQFI2H5.js"() {
+    init_chunk_UBAXWQKU();
     DEFINITION_SECTIONS = {
       locales: "list",
       roles: "list",
@@ -5952,73 +6658,90 @@ var init_chunk_W5P6N7TE = __esm({
   }
 });
 
-// ../../domain/schema/dist/chunk-OA32TBFV.js
+// ../../domain/schema/dist/chunk-CTS2X4ES.js
 function shapedValueFragment(shapes, nestedFields) {
-  const valueOf = (shape, type) => {
-    const value = nestedFields(fieldsOfMembers(shape.fields));
-    value.properties = {
-      ...value.properties,
-      [LIST_ITEM_TYPE]: type,
-      [LIST_ITEM_KEY]: { type: "string" }
-    };
-    return value;
-  };
   const [only] = shapes;
   if (shapes.length === 1 && only !== void 0) {
-    return valueOf(only, { type: "string", enum: [only.id] });
+    return valueOf(only, { type: "string", enum: [only.id] }, nestedFields);
   }
   if (shapes.length > 1) {
     return {
       type: "object",
       discriminator: { propertyName: LIST_ITEM_TYPE },
-      oneOf: shapes.map((shape) => {
-        const value = valueOf(shape, { const: shape.id });
-        return { ...value, required: [...value.required ?? [], LIST_ITEM_TYPE] };
-      })
+      oneOf: shapes.map((shape) => shapeFragmentOf(shape, nestedFields))
     };
   }
   return void 0;
 }
-var FIELD_FORMAT_CODE_KEY, URL_VALUE_FORMAT, SITE_RELATIVE_PATH, FieldFormats, ConfiguredFieldFormats, StringFieldValidators, NumericFieldValidators, BooleanChoiceFieldValidators, DateTimeFieldValidators, ReferenceFieldValidators, CompositeFieldValidators, FIELD_KIND_VALUE_RULES;
-var init_chunk_OA32TBFV = __esm({
-  "../../domain/schema/dist/chunk-OA32TBFV.js"() {
-    init_chunk_GCR57WZV();
-    init_chunk_RDFZ6WP6();
-    FIELD_FORMAT_CODE_KEY = "x-formatCode";
-    URL_VALUE_FORMAT = "url";
-    SITE_RELATIVE_PATH = /^\/(?!\/)/;
-    FieldFormats = {
-      slug: {
-        code: "slug",
-        pattern: /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
-        message: "can only contain lowercase letters, numbers and hyphens, with no leading, trailing or repeated hyphens"
-      },
-      email: {
-        code: "email",
-        pattern: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
-        message: "must be a valid email address"
-      },
-      uuid: {
-        code: "uuid",
-        pattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
-        message: "must be a valid UUID"
+function shapeFragmentOf(shape, nestedFields) {
+  const value = valueOf(shape, { const: shape.id }, nestedFields);
+  return { ...value, required: [...value.required ?? [], LIST_ITEM_TYPE] };
+}
+function valueOf(shape, type, nestedFields) {
+  const value = nestedFields(fieldsOfMembers(shape.fields));
+  value.properties = {
+    ...value.properties,
+    [LIST_ITEM_TYPE]: type,
+    [LIST_ITEM_KEY]: { type: "string" }
+  };
+  return value;
+}
+var CompositeFieldValidators, StringFieldValidators, NumericFieldValidators, BooleanChoiceFieldValidators, DateTimeFieldValidators, ReferenceFieldValidators, DataFieldValidators, FIELD_KIND_VALUE_RULES;
+var init_chunk_CTS2X4ES = __esm({
+  "../../domain/schema/dist/chunk-CTS2X4ES.js"() {
+    init_chunk_MGMW4ZMJ();
+    init_chunk_UBAXWQKU();
+    CompositeFieldValidators = {
+      tags: {
+        type: "array",
+        items: { type: "string" },
+        uniqueItems: true,
+        customValidator: (schema, field) => {
+          if (field.config?.maxTags) {
+            schema.maxItems = field.config.maxTags;
+          }
+          if (field.config?.allowCustom === false && schema.items) {
+            if (!field.config.predefinedTags?.length) {
+              throw new Error("Tags field with allowCustom: false must have predefinedTags defined");
+            }
+            schema.items.enum = field.config.predefinedTags;
+          }
+        }
       },
-      phone: {
-        code: "phone",
-        pattern: /^[+]?[\d\s\-()]{7,15}$/,
-        message: "must be a valid phone number"
-      }
-    };
-    ConfiguredFieldFormats = {
-      /** An email field restricted to a `config.domainWhitelist`. */
-      emailDomain: {
-        code: "emailDomain",
-        message: "must be from an allowed domain"
+      list: {
+        type: "array",
+        items: { type: "string" },
+        customValidator: (schema, field, nestedFields) => {
+          if (field.config?.minItems) {
+            schema.minItems = field.config.minItems;
+          }
+          if (field.config?.maxItems) {
+            schema.maxItems = field.config.maxItems;
+          }
+          const shapes = shapesOf(field);
+          if (shapes.length === 0 && field.config?.of !== void 0) {
+            throw new Error(
+              "A list field's `of` must be a fieldset, or a list of them: an id, a displayName and fields"
+            );
+          }
+          const items = shapedValueFragment(shapes, nestedFields);
+          if (items !== void 0) schema.items = items;
+          if (field.config?.unique) {
+            schema.uniqueItems = true;
+          }
+        }
       },
-      /** A URL field restricted to `config.allowedProtocols`. */
-      urlProtocol: {
-        code: "urlProtocol",
-        message: "must use an allowed protocol"
+      object: {
+        type: "object",
+        customValidator: (schema, field, nestedFields) => {
+          const value = shapedValueFragment(shapesOf(field), nestedFields);
+          if (value === void 0) {
+            throw new Error(
+              "An object field's `of` must be a fieldset, or a list of them: an id, a displayName and fields"
+            );
+          }
+          Object.assign(schema, value);
+        }
       }
     };
     StringFieldValidators = {
@@ -6060,18 +6783,37 @@ var init_chunk_OA32TBFV = __esm({
       // the 50,000 characters of HTML this kept by default approximated — and an empty tree is refused
       // as an empty string was, by `minItems` on the root's blocks. A field that narrows the docs set
       // (REL-1805: `structure`, `marks`, `multiline`) carries its narrowing as `x-richTextNarrowing`, so
-      // a write holding what the field does not allow is refused naming it.
+      // a write holding what the field does not allow is refused naming it. Every field carries it,
+      // since every field refuses a declared block or inline element it does not declare (REL-1807) —
+      // one that declares none refuses them all. The fields of each one it declares are held to the
+      // shape's own fragment, the one a page builder's item of that fieldset is held to
+      // (`x-richTextShapes`). Its `links` (REL-1808) rides the narrowing too: a field that names none
+      // refuses an entry link; which type one points at is the write core's reference check.
       richText: {
         "x-richTextTree": 1,
         properties: { children: { type: "array", minItems: 1 } },
-        customValidator: (schema, field) => {
-          schema["x-richTextMaxLength"] = field.config?.maxLength ?? 5e4;
+        customValidator: (schema, field, nestedFields) => {
+          schema["x-richTextMaxLength"] = {
+            limit: field.config?.maxLength ?? 5e4,
+            declared: richTextDeclaredTextOf(field)
+          };
           const narrowing = richTextNarrowingOf(field.config ?? {});
-          if (!isFullRichTextNarrowing(narrowing)) {
-            schema["x-richTextNarrowing"] = {
-              structure: [...narrowing.structure],
-              marks: [...narrowing.marks],
-              multiline: narrowing.multiline
+          schema["x-richTextNarrowing"] = {
+            structure: [...narrowing.structure],
+            marks: [...narrowing.marks],
+            multiline: narrowing.multiline,
+            blocks: [...narrowing.blocks.keys()],
+            inline: [...narrowing.inline.keys()],
+            links: [...narrowing.links]
+          };
+          const shapes = richTextShapesOf(field);
+          if (shapes.blocks.length > 0 || shapes.inline.length > 0) {
+            const fragments = (declared) => Object.fromEntries(
+              declared.map((shape) => [shape.id, shapeFragmentOf(shape, nestedFields)])
+            );
+            schema["x-richTextShapes"] = {
+              blocks: fragments(shapes.blocks),
+              inline: fragments(shapes.inline)
             };
           }
           if (field.config?.defaultValue) {
@@ -6158,7 +6900,7 @@ var init_chunk_OA32TBFV = __esm({
             schema.maxLength = field.config.maxLength;
           }
           if (!schema.maxLength) {
-            schema.maxLength = 100;
+            schema.maxLength = SLUG_DEFAULT_MAX_LENGTH;
           }
         }
       }
@@ -6289,56 +7031,12 @@ var init_chunk_OA32TBFV = __esm({
         }
       }
     };
-    CompositeFieldValidators = {
-      tags: {
-        type: "array",
-        items: { type: "string" },
-        uniqueItems: true,
+    DataFieldValidators = {
+      json: {
+        "x-json": {},
         customValidator: (schema, field) => {
-          if (field.config?.maxTags) {
-            schema.maxItems = field.config.maxTags;
-          }
-          if (field.config?.allowCustom === false && schema.items) {
-            if (!field.config.predefinedTags?.length) {
-              throw new Error("Tags field with allowCustom: false must have predefinedTags defined");
-            }
-            schema.items.enum = field.config.predefinedTags;
-          }
-        }
-      },
-      list: {
-        type: "array",
-        items: { type: "string" },
-        customValidator: (schema, field, nestedFields) => {
-          if (field.config?.minItems) {
-            schema.minItems = field.config.minItems;
-          }
-          if (field.config?.maxItems) {
-            schema.maxItems = field.config.maxItems;
-          }
-          const shapes = shapesOf(field);
-          if (shapes.length === 0 && field.config?.of !== void 0) {
-            throw new Error(
-              "A list field's `of` must be a fieldset, or a list of them: an id, a displayName and fields"
-            );
-          }
-          const items = shapedValueFragment(shapes, nestedFields);
-          if (items !== void 0) schema.items = items;
-          if (field.config?.unique) {
-            schema.uniqueItems = true;
-          }
-        }
-      },
-      object: {
-        type: "object",
-        customValidator: (schema, field, nestedFields) => {
-          const value = shapedValueFragment(shapesOf(field), nestedFields);
-          if (value === void 0) {
-            throw new Error(
-              "An object field's `of` must be a fieldset, or a list of them: an id, a displayName and fields"
-            );
-          }
-          Object.assign(schema, value);
+          const declared = field.config?.schema;
+          if (declared !== void 0) schema["x-json"] = { schema: declared };
         }
       }
     };
@@ -6360,7 +7058,8 @@ var init_chunk_OA32TBFV = __esm({
       reference: { fragment: ReferenceFieldValidators.reference },
       tags: { fragment: CompositeFieldValidators.tags },
       list: { fragment: CompositeFieldValidators.list },
-      object: { fragment: CompositeFieldValidators.object }
+      object: { fragment: CompositeFieldValidators.object },
+      json: { fragment: DataFieldValidators.json }
     };
   }
 });
@@ -6371,114 +7070,7 @@ var init_chunk_NGOOYRLJ = __esm({
   }
 });
 
-// ../../domain/schema/dist/chunk-KDABWSAA.js
-function declaredFieldsOf(fields) {
-  const root = { children: /* @__PURE__ */ new Map() };
-  for (const walked of walkMembers(fields)) {
-    let node = root;
-    for (const segment of walked.path) node = childOf(node, segment);
-    if (walked.status === "declared") {
-      const shapes = shapesOf(walked.field);
-      if (shapes.length > 0) node.holds = walked.key === "object" ? "item" : "items";
-      for (const shape of shapes) {
-        const item = childOf(node, itemSegmentOf(shape.id));
-        childOf(item, LIST_ITEM_TYPE);
-        childOf(item, LIST_ITEM_KEY);
-      }
-    }
-  }
-  return root;
-}
-function childOf(node, segment) {
-  let child = node.children.get(segment);
-  if (child === void 0) {
-    child = { children: /* @__PURE__ */ new Map() };
-    node.children.set(segment, child);
-  }
-  return child;
-}
-var init_chunk_KDABWSAA = __esm({
-  "../../domain/schema/dist/chunk-KDABWSAA.js"() {
-    init_chunk_RDFZ6WP6();
-  }
-});
-
-// ../../domain/schema/dist/chunk-SXB4UYLV.js
-function isFieldLocalized(field) {
-  const declared = field.localization;
-  if (declared !== void 0 && declared !== null) {
-    if (typeof declared === "boolean") return declared;
-    if (Array.isArray(declared)) return declared.length > 0;
-    if (typeof declared === "object") {
-      return declared.enabled === true;
-    }
-  }
-  return false;
-}
-function parseKeyedPath(path25) {
-  const segments = [];
-  let at = 0;
-  let expectField = true;
-  while (at < path25.length) {
-    if (path25.startsWith(ITEM_SELECTOR, at)) {
-      const previous = segments.at(-1);
-      if (expectField || previous === void 0 || !("field" in previous)) return null;
-      const quoted = readQuoted(path25, at + ITEM_SELECTOR.length);
-      if (quoted === null || path25[quoted.end] !== "]") return null;
-      segments.push({ key: quoted.value });
-      at = quoted.end + 1;
-      if (at < path25.length && path25[at] !== "." && !path25.startsWith(ITEM_SELECTOR, at)) return null;
-      if (path25[at] === ".") {
-        at += 1;
-        expectField = true;
-      }
-      continue;
-    }
-    let end = at;
-    while (end < path25.length && path25[end] !== "." && path25[end] !== "[") end += 1;
-    const field = path25.slice(at, end);
-    if (field.length === 0) return null;
-    segments.push({ field });
-    expectField = false;
-    at = end;
-    if (path25[at] === ".") {
-      at += 1;
-      expectField = true;
-      if (at === path25.length) return null;
-    } else if (at < path25.length && !path25.startsWith(ITEM_SELECTOR, at)) {
-      return null;
-    }
-  }
-  return segments.length === 0 || expectField ? null : segments;
-}
-function readQuoted(path25, start) {
-  if (path25[start] !== '"') return null;
-  for (let end = start + 1; end < path25.length; end += 1) {
-    if (path25[end] === "\\") {
-      end += 1;
-      continue;
-    }
-    if (path25[end] !== '"') continue;
-    try {
-      const value = JSON.parse(path25.slice(start, end + 1));
-      return typeof value === "string" && value.length > 0 ? { value, end: end + 1 } : null;
-    } catch {
-      return null;
-    }
-  }
-  return null;
-}
-var ITEM_SELECTOR;
-var init_chunk_SXB4UYLV = __esm({
-  "../../domain/schema/dist/chunk-SXB4UYLV.js"() {
-    init_chunk_KDABWSAA();
-    init_chunk_RDFZ6WP6();
-    init_chunk_7HSDWMYK();
-    ITEM_SELECTOR = `[${LIST_ITEM_KEY}==`;
-  }
-});
-
-// ../../domain/schema/dist/chunk-VXC2EEEM.js
+// ../../domain/schema/dist/chunk-AAH22U23.js
 function buildFieldPath(segments) {
   return segments.join(".");
 }
@@ -6501,6 +7093,36 @@ function getFieldRenderer(baseType) {
 function getReferenceFieldRenderer(targetKind) {
   return targetKind === "asset" ? "AssetReferenceField" : "ReferenceField";
 }
+function nestedRichTextFieldsOf(field) {
+  const nested = /* @__PURE__ */ new Map();
+  const read = /* @__PURE__ */ new Set();
+  const visit2 = (holder) => {
+    for (const shape of richTextShapesOf(holder).blocks) {
+      if (read.has(shape.id)) continue;
+      read.add(shape.id);
+      const richText = fieldsOfMembers(shape.fields).filter(
+        (member) => isKind(member.type, "richText")
+      );
+      if (richText.length === 0) continue;
+      nested.set(shape.id, new Map(richText.map((member) => [member.id, member])));
+      for (const member of richText) visit2(member);
+    }
+  };
+  visit2(field);
+  return nested;
+}
+function nestedRichTextNarrowingsOf(field) {
+  const narrowings = {};
+  for (const [shape, fields] of nestedRichTextFieldsOf(field)) {
+    const spelled = {};
+    for (const [id, member] of fields) {
+      const config = member.config ?? {};
+      spelled[id] = richTextNarrowingOptionsOf(richTextNarrowingOf(config));
+    }
+    narrowings[shape] = spelled;
+  }
+  return narrowings;
+}
 function isValidFieldType2(type) {
   return FIELD_KINDS.includes(type);
 }
@@ -6522,7 +7144,7 @@ function createSchemaReader(schemaDefinition) {
 }
 function findFieldset(members, id, enclosing = []) {
   for (const member of members) {
-    const candidates = isSection(member) ? [member] : shapesOf(member).filter((shape) => !enclosing.includes(shape.id));
+    const candidates = isSection(member) ? [member] : fieldsetPlacesOf(member).map((place) => place.shape).filter((shape) => !enclosing.includes(shape.id));
     for (const fieldset of candidates) {
       if (fieldset.id === id) return fieldset;
       const inside = findFieldset(fieldset.fields, id, [...enclosing, fieldset.id]);
@@ -6531,21 +7153,38 @@ function findFieldset(members, id, enclosing = []) {
   }
   return void 0;
 }
-function placedFieldsets(members, enclosing = []) {
+function placedFieldsets(members, enclosing = [], prefix = "") {
   const placed = [];
   for (const member of members) {
     if (isSection(member)) {
       placed.push(
         { fieldset: member, placement: "section" },
-        ...placedFieldsets(member.fields, enclosing)
+        ...placedFieldsets(member.fields, enclosing, prefix)
       );
       continue;
     }
-    for (const shape of shapesOf(member)) {
-      if (enclosing.includes(shape.id)) continue;
+    const path25 = prefix === "" ? member.id : `${prefix}.${member.id}`;
+    const of = shapePlacesOf(member).map((place) => place.shape);
+    const tree = richTextShapePlacesOf(member);
+    const places = [
+      ...of.map((fieldset) => ({
+        fieldset,
+        placement: "shape",
+        shapes: of.map((shape) => shape.id),
+        segment: itemSegmentOf(fieldset.id)
+      })),
+      ...tree.map(({ shape, option }) => ({
+        fieldset: shape,
+        placement: option === "blocks" ? "block" : "inline",
+        shapes: tree.filter((place) => place.option === option).map((place) => place.shape.id),
+        segment: richTextTreeSegmentOf(shape.id)
+      }))
+    ];
+    for (const { fieldset, placement, shapes, segment } of places) {
+      if (enclosing.includes(fieldset.id)) continue;
       placed.push(
-        { fieldset: shape, placement: "shape" },
-        ...placedFieldsets(shape.fields, [...enclosing, shape.id])
+        { fieldset, placement, path: path25, fieldType: member.type, shapes },
+        ...placedFieldsets(fieldset.fields, [...enclosing, fieldset.id], `${path25}.${segment}`)
       );
     }
   }
@@ -6576,13 +7215,13 @@ function ownConfigOf(field) {
   return typeof config === "object" && config !== null && !Array.isArray(config) ? { ...config } : {};
 }
 var DEFAULT_FIELD_ICON, FIELD_RENDERER_MAP, SYSTEM_FIELD_PRESENTATION, SchemaReader;
-var init_chunk_VXC2EEEM = __esm({
-  "../../domain/schema/dist/chunk-VXC2EEEM.js"() {
-    init_chunk_TVFFHTGZ();
-    init_chunk_SXB4UYLV();
-    init_chunk_3FBPIG5X();
-    init_chunk_RDFZ6WP6();
-    init_chunk_7HSDWMYK();
+var init_chunk_AAH22U23 = __esm({
+  "../../domain/schema/dist/chunk-AAH22U23.js"() {
+    init_chunk_RFXTOU4J();
+    init_chunk_YPAAGSVJ();
+    init_chunk_QTFIQNJM();
+    init_chunk_UBAXWQKU();
+    init_chunk_VFLLYTDW();
     DEFAULT_FIELD_ICON = "circle";
     FIELD_RENDERER_MAP = {
       // Text-based fields
@@ -6610,7 +7249,9 @@ var init_chunk_VXC2EEEM = __esm({
       // Composite
       tags: "TagsField",
       list: "ListField",
-      object: "ObjectField"
+      object: "ObjectField",
+      // Data: a JSON value, edited as its source text (REL-1811)
+      json: "JsonField"
     };
     SYSTEM_FIELD_PRESENTATION = {
       id: { displayName: "ID", icon: "user" },
@@ -7304,11 +7945,12 @@ var init_chunk_VXC2EEEM = __esm({
       // ═══════════════════════════════════════════════════════════════════════════════
       /**
        * Every fieldset the schema declares, once per id, in the order the types declare them (REL-1799):
-       * each section among a type's fields, and each shape an object's or a list's `of` names, at any
-       * depth — inside sections, shapes and their fields. A fieldset
-       * is reused by placing it, and its id names one shape across the schema (`FieldsetValidator`),
-       * so the first declaration found is its fields. A shape that is a shape of a value it sits in is
-       * not entered again (deploy refuses it).
+       * each section among a type's fields, each shape an object's or a list's `of` names, and each block
+       * and inline element a rich-text field's `blocks` and `inline` name (REL-1807, REL-1813), at any
+       * depth — inside sections, shapes, blocks and their fields, as deploy's validators reach them
+       * (`fieldsetPlacesOf`). A fieldset is reused by placing it, and its id names one shape across the
+       * schema (`FieldsetValidator`), so the first declaration found is its fields. A shape that is a
+       * shape of a value it sits in is not entered again (deploy refuses it).
        */
       getFieldsets() {
         const found = /* @__PURE__ */ new Map();
@@ -7318,7 +7960,8 @@ var init_chunk_VXC2EEEM = __esm({
             displayName: definition.displayName ?? typeId,
             category
           };
-          const record = (fieldset, placement) => {
+          const record = (placed) => {
+            const { fieldset, placement } = placed;
             let entry = found.get(fieldset.id);
             if (entry === void 0) {
               entry = {
@@ -7327,16 +7970,28 @@ var init_chunk_VXC2EEEM = __esm({
                 ...fieldset.description === void 0 ? {} : { description: fieldset.description },
                 fields: this.extractFieldsFromRaw(fieldsOfMembers(fieldset.fields), ref),
                 placements: [],
-                usedIn: []
+                usedIn: [],
+                heldBy: []
               };
               found.set(fieldset.id, entry);
             }
             if (!entry.placements.includes(placement)) entry.placements.push(placement);
             if (!entry.usedIn.some((used) => used.id === typeId)) entry.usedIn.push(ref);
+            if (placed.placement !== "section") {
+              const holder = {
+                type: typeId,
+                path: placed.path,
+                fieldType: placed.fieldType,
+                placement: placed.placement,
+                shapes: [...placed.shapes]
+              };
+              const known = entry.heldBy.some(
+                (held) => held.type === holder.type && held.path === holder.path && held.placement === holder.placement
+              );
+              if (!known) entry.heldBy.push(holder);
+            }
           };
-          for (const { fieldset, placement } of placedFieldsets(definition.fields ?? [])) {
-            record(fieldset, placement);
-          }
+          for (const placed of placedFieldsets(definition.fields ?? [])) record(placed);
         }
         return [...found.values()];
       }
@@ -7517,18 +8172,16 @@ var init_chunk_VXC2EEEM = __esm({
        * Create an ExpandedField from a raw field.
        */
       createExpandedField(field, context, pathSegments) {
-        const baseType = field.type;
         const fieldPath = buildFieldPath(pathSegments);
-        const icon = isKind(baseType, "reference") ? getReferenceFieldIcon(
+        const icon = isKind(field.type, "reference") ? getReferenceFieldIcon(
           this.resolveReferenceTarget({
             config: { to: field.config?.to }
           }).kind
-        ) : getFieldIcon(baseType);
+        ) : getFieldIcon(field.type);
         return {
           id: field.id,
           displayName: field.ui?.displayName ?? field.id,
           type: field.type,
-          baseType,
           icon,
           description: field.ui?.description,
           required: field.config?.required === true,
@@ -7792,13 +8445,13 @@ var init_chunk_VXC2EEEM = __esm({
           ...Object.values(this.schema.assetTypes ?? {}),
           ...Object.values(this.schema.settingsGroups ?? {})
         ];
-        const distinct3 = /* @__PURE__ */ new Set();
+        const distinct4 = /* @__PURE__ */ new Set();
         for (const owner of owners) {
           for (const walked of walkMembers(owner.fields ?? [])) {
-            distinct3.add(walked.path.join("."));
+            distinct4.add(walked.path.join("."));
           }
         }
-        return distinct3.size;
+        return distinct4.size;
       }
       // ═══════════════════════════════════════════════════════════════════════════════
       // PRIVATE HELPERS
@@ -8024,7 +8677,7 @@ var init_chunk_VXC2EEEM = __esm({
        * @returns Resolved renderable field
        */
       resolveField(field, context) {
-        const baseType = field.type;
+        const { type } = field;
         const pathSegments = [...context.pathSegments, field.id];
         const path25 = buildFieldPath(pathSegments);
         const displayName = field.ui?.displayName ?? field.id;
@@ -8032,11 +8685,11 @@ var init_chunk_VXC2EEEM = __esm({
         const placeholder = field.ui?.options?.placeholder;
         const widgetConfig = this.extractWidgetConfig(field);
         const validation = this.extractFieldValidation(field);
-        const referenceTarget = isKind(baseType, "reference") ? this.resolveReferenceTarget({
+        const referenceTarget = isKind(type, "reference") ? this.resolveReferenceTarget({
           config: { to: field.config?.to }
         }) : null;
-        const renderer = referenceTarget ? getReferenceFieldRenderer(referenceTarget.kind) : getFieldRenderer(baseType);
-        const icon = referenceTarget ? getReferenceFieldIcon(referenceTarget.kind) : getFieldIcon(baseType);
+        const renderer = referenceTarget ? getReferenceFieldRenderer(referenceTarget.kind) : getFieldRenderer(type);
+        const icon = referenceTarget ? getReferenceFieldIcon(referenceTarget.kind) : getFieldIcon(type);
         const renderableField = {
           id: field.id,
           path: path25,
@@ -8045,8 +8698,7 @@ var init_chunk_VXC2EEEM = __esm({
           description,
           placeholder,
           icon,
-          type: field.type,
-          baseType,
+          type,
           renderer,
           widgetConfig,
           required: field.config?.required === true,
@@ -8058,26 +8710,30 @@ var init_chunk_VXC2EEEM = __esm({
           hasRules: Array.isArray(field.rules) && field.rules.length > 0,
           raw: field
         };
-        if (isKind(baseType, "richText")) {
+        if (isKind(type, "richText")) {
           const narrowing = richTextNarrowingOf(field.config ?? {});
           renderableField.richText = {
             document: "blocks",
-            structure: [...narrowing.structure],
-            marks: [...narrowing.marks],
-            multiline: narrowing.multiline
+            ...richTextNarrowingOptionsOf(narrowing),
+            // Each declared Block's rich-text fields, held to their own configs (REL-2114)
+            nestedRichText: nestedRichTextNarrowingsOf(field)
           };
         }
-        const holdsBlock = isKind(baseType, "table") ? "table" : isKind(baseType, "code") ? "codeGroup" : null;
+        const holdsBlock = isKind(type, "table") ? "table" : isKind(type, "code") ? "codeGroup" : null;
         if (holdsBlock !== null) {
           renderableField.richText = {
             document: holdsBlock,
             structure: [holdsBlock],
             marks: [...RICH_TEXT_MARK_TYPES],
-            multiline: true
+            multiline: true,
+            blocks: [],
+            inline: [],
+            links: [],
+            nestedRichText: {}
           };
         }
         const shapes = shapesOf(field);
-        const expand = isKind(baseType, "object") ? context.expandObjects : isKind(baseType, "list") && context.expandListItemFields;
+        const expand = isKind(type, "object") ? context.expandObjects : isKind(type, "list") && context.expandListItemFields;
         if (shapes.length > 0 && expand && context.depth < context.maxDepth) {
           const nestedContext = {
             ...context,
@@ -8137,11 +8793,11 @@ var init_chunk_VXC2EEEM = __esm({
         const plan = this.getRenderPlan(contentTypeId, options);
         if (!plan) return null;
         if (fieldPath.includes("[")) {
-          const keyed = parseKeyedPath(fieldPath);
-          if (keyed === null) return null;
+          const keyed2 = parseKeyedPath(fieldPath);
+          if (keyed2 === null) return null;
           let scope = plan.fields;
           let current = null;
-          for (const segment of keyed) {
+          for (const segment of keyed2) {
             if ("key" in segment) {
               if (current === null || !isKind(current.type, "list")) return null;
               scope = current.nestedFields ?? current.shapes?.flatMap((shape) => shape.fields);
@@ -8217,14 +8873,14 @@ var init_chunk_VXC2EEEM = __esm({
         return built;
       }
       countTotalFields(fields) {
-        let count = 0;
+        let count2 = 0;
         for (const field of fields) {
-          count += 1;
+          count2 += 1;
           if (field.nestedFields) {
-            count += this.countTotalFields(field.nestedFields);
+            count2 += this.countTotalFields(field.nestedFields);
           }
         }
-        return count;
+        return count2;
       }
       calculateRenderPlanSummary(members) {
         const allFields = renderFieldsOf(members);
@@ -8299,7 +8955,7 @@ var init_chunk_VXC2EEEM = __esm({
   }
 });
 
-// ../../domain/schema/dist/chunk-GG33YIFS.js
+// ../../domain/schema/dist/chunk-Q6EBYJVQ.js
 function flattenTypeFields(detail) {
   return detail?.fields ?? [];
 }
@@ -8307,16 +8963,16 @@ function buildTypeDetail(reader, typeId) {
   return reader.getAssetType(typeId) ?? reader.getContentTypeDetails(typeId);
 }
 var TABLE_SYSTEM_FIELD_KINDS;
-var init_chunk_GG33YIFS = __esm({
-  "../../domain/schema/dist/chunk-GG33YIFS.js"() {
+var init_chunk_Q6EBYJVQ = __esm({
+  "../../domain/schema/dist/chunk-Q6EBYJVQ.js"() {
     init_chunk_NGOOYRLJ();
-    init_chunk_VXC2EEEM();
-    init_chunk_SXB4UYLV();
-    init_chunk_KDABWSAA();
+    init_chunk_AAH22U23();
+    init_chunk_YPAAGSVJ();
+    init_chunk_NKUAK5EA();
     init_chunk_GR7UT3XN();
-    init_chunk_3FBPIG5X();
-    init_chunk_RDFZ6WP6();
-    init_chunk_7HSDWMYK();
+    init_chunk_QTFIQNJM();
+    init_chunk_UBAXWQKU();
+    init_chunk_VFLLYTDW();
     TABLE_SYSTEM_FIELD_KINDS = {
       id: "text",
       contentType: "choice",
@@ -8380,7 +9036,7 @@ function buildSchemaIndex(schema) {
   };
   const recordShapeFields = (list, enclosing = []) => {
     if (!list.field?.type) return;
-    for (const place of shapePlacesOf(list.field)) {
+    for (const place of fieldsetPlacesOf(list.field)) {
       const shape = place.shape;
       if (enclosing.includes(shape.id)) continue;
       const visit2 = (members, basePath) => {
@@ -8628,7 +9284,8 @@ function declarativePath(zodPath, definition) {
         typeof named2.field === "string" && named2.field ? `${named2.field}_condition_${part}` : `condition_${part}`
       );
     } else {
-      pathParts.push(part.toString());
+      const last = pathParts.pop();
+      pathParts.push(`${last ?? ""}[${part}]`);
     }
     currentContext = item;
   }
@@ -8727,16 +9384,31 @@ function noNestedFieldChanges() {
     removedOptions: [],
     narrowedRichText: [],
     removedShapes: [],
-    renamedShapes: []
+    renamedShapes: [],
+    changedJsonSchemas: []
   };
 }
+function jsonSchemaOf(config) {
+  return typeof config === "object" && config !== null ? config.schema : void 0;
+}
+function jsonSchemaChangedBetween(before, after) {
+  const now = jsonSchemaOf(after);
+  if (typeof now !== "object" || now === null) return null;
+  const was = jsonSchemaOf(before);
+  if (JSON.stringify(normalizeSchemaValue(was ?? null)) === JSON.stringify(normalizeSchemaValue(now))) {
+    return null;
+  }
+  return now;
+}
 function richTextNarrowingLostBetween(before, after) {
-  const options = (config) => typeof config === "object" && config !== null ? config : {};
   return richTextNarrowingLost(
-    richTextNarrowingOf(options(before)),
-    richTextNarrowingOf(options(after))
+    richTextNarrowingOf(narrowingOptionsOf(before)),
+    richTextNarrowingOf(narrowingOptionsOf(after))
   );
 }
+function narrowingOptionsOf(config) {
+  return typeof config === "object" && config !== null ? config : {};
+}
 function nestedConfigOf(field) {
   const config = field.config;
   return typeof config === "object" && config !== null ? config : {};
@@ -8821,14 +9493,41 @@ function nestedFieldChangeSites(before, after) {
       const lost = richTextNarrowingLostBetween(was, is);
       if (lost !== null) sites.narrowedRichText.push({ ...kept, lost });
     }
+    if (isKind(kept.field.type, "json")) {
+      const schema = jsonSchemaChangedBetween(was, is);
+      if (schema !== null) sites.changedJsonSchemas.push({ ...kept, schema });
+    }
   }
   for (const [key, site] of now) {
     if (old.has(key) || below(key)) continue;
     if (!existedBefore(parentKey(site.path))) continue;
     if (nestedConfigOf(site.field).required === true) sites.addedRequired.push(site);
   }
+  const nowInTree = fieldsInTree(after);
+  for (const [key, site] of fieldsInTree(before)) {
+    if (below(key)) continue;
+    const kept = nowInTree.get(key);
+    if (kept === void 0 || kept.field.type !== site.field.type) continue;
+    if (isKind(kept.field.type, "richText")) {
+      const lost = richTextNarrowingLostBetween(site.field.config, kept.field.config);
+      if (lost !== null) sites.narrowedRichText.push({ ...kept, lost });
+    }
+    if (isKind(kept.field.type, "json")) {
+      const schema = jsonSchemaChangedBetween(site.field.config, kept.field.config);
+      if (schema !== null) sites.changedJsonSchemas.push({ ...kept, schema });
+    }
+  }
   return sites;
 }
+function fieldsInTree(field) {
+  const found = /* @__PURE__ */ new Map();
+  for (const walked of walkFieldKinds(field, { intoRichText: true })) {
+    if (walked.status !== "declared") continue;
+    if (!walked.path.some((segment) => isRichTextTreeSegment(segment))) continue;
+    found.set(walked.path.join("."), { path: [...walked.path], field: walked.field });
+  }
+  return found;
+}
 function declaredOptionValues(options) {
   if (!Array.isArray(options)) return [];
   const values = [];
@@ -8839,13 +9538,17 @@ function declaredOptionValues(options) {
   }
   return values;
 }
-function fieldChangeSites(changes) {
+function fieldChangeSites({
+  changes,
+  narrowedRichTextFields
+}) {
   const sites = {
     removedFields: [...changes.removedFields],
     typeChanges: [],
     requiredFlips: [],
     removedOptions: [],
-    narrowedRichText: [],
+    // Read off both whole configs by the differ, never off the changed keys alone (REL-2093)
+    narrowedRichText: [...narrowedRichTextFields],
     nested: noNestedFieldChanges()
   };
   for (const mod of changes.modifiedFields) {
@@ -8870,12 +9573,14 @@ function fieldChangeSites(changes) {
       (change) => RICH_TEXT_NARROWING_CHANGE_KEYS.includes(change.field)
     );
     if (narrowing.length > 0 && !typeChange) {
-      const side = (which) => Object.fromEntries(
-        narrowing.map((change) => [change.field.slice("config.".length), change[which]])
+      const declaredChange = (which) => Object.fromEntries(
+        narrowing.filter((change) => RICH_TEXT_DECLARED_CHANGE_KEYS.has(change.field)).map((change) => [change.field.slice("config.".length), change[which]])
       );
-      if (richTextNarrowingLostBetween(side("before"), side("after")) !== null) {
-        sites.narrowedRichText.push(mod.name);
-      }
+      const inTree = nestedFieldChangeSites(
+        { id: mod.name, type: "richText", config: declaredChange("before") },
+        { id: mod.name, type: "richText", config: declaredChange("after") }
+      );
+      sites.nested.narrowedRichText.push(...inTree.narrowedRichText);
     }
     const shapeChange = mod.changes.find((c) => c.field === FIELD_SHAPE_CHANGE_KEY);
     if (shapeChange && !typeChange) {
@@ -8891,6 +9596,7 @@ function fieldChangeSites(changes) {
       sites.nested.narrowedRichText.push(...inside.narrowedRichText);
       sites.nested.removedShapes.push(...inside.removedShapes);
       sites.nested.renamedShapes.push(...inside.renamedShapes);
+      sites.nested.changedJsonSchemas.push(...inside.changedJsonSchemas);
     }
   }
   return sites;
@@ -8898,6 +9604,16 @@ function fieldChangeSites(changes) {
 function shapeHolder(id, of) {
   return { id, type: "list", config: { of } };
 }
+function narrowedRichTextFieldsOf(changes, oldFields, newFields) {
+  const before = new Map(oldFields.map((field) => [field.id, field]));
+  const after = new Map(newFields.map((field) => [field.id, field]));
+  return changes.modifiedFields.filter((mod) => !mod.changes.some((change) => change.field === "type")).map((mod) => mod.name).filter((id) => {
+    const was = before.get(id);
+    const is = after.get(id);
+    if (was === void 0 || is === void 0 || !isKind(is.type, "richText")) return false;
+    return richTextNarrowingLostBetween(was.config, is.config) !== null;
+  });
+}
 function addedRequiredFieldsOf(changes, newFields) {
   const added = new Set(changes.addedFields);
   return newFields.filter((field) => added.has(field.id) && nestedConfigOf(field).required === true).map((field) => field.id);
@@ -8962,7 +9678,7 @@ function classifyCompatibility(diff2) {
   }
   const classifyEntityFieldChanges = (entities, entityLabel) => {
     for (const entity of entities) {
-      const sites = fieldChangeSites(entity.changes);
+      const sites = fieldChangeSites(entity);
       for (const field of sites.removedFields) {
         breakingChanges.push({
           category: "field_removed",
@@ -9107,6 +9823,48 @@ function sectionsOf2(members) {
 function isCrossVersionCheckCode(code) {
   return Object.hasOwn(CROSS_VERSION_CHECKS, code);
 }
+function shapeLocalizationConflictsOf(members) {
+  const conflicts = [];
+  const visit2 = (path25, placed, shapeStack) => {
+    const localized = placed.filter((entry) => isFieldLocalized(entry.field));
+    if (localized.length > 0) {
+      const shared = placed.filter((entry) => !isFieldLocalized(entry.field));
+      if (shared.length > 0) {
+        conflicts.push({
+          path: path25,
+          at: localized[0].at,
+          localizedIn: localized.map((entry) => entry.shape ?? ""),
+          sharedIn: shared.map((entry) => entry.shape ?? "")
+        });
+      }
+      return;
+    }
+    const byId = /* @__PURE__ */ new Map();
+    const shapesHere = [];
+    for (const entry of placed) {
+      if (!isKind(entry.field.type, "object")) continue;
+      for (const { shape, at } of shapePlacesOf(entry.field)) {
+        if (shapeStack.includes(shape.id)) continue;
+        shapesHere.push(shape.id);
+        for (const child of fieldsOfMembers(shape.fields)) {
+          const field = child;
+          const group = byId.get(field.id) ?? [];
+          group.push({ field, shape: shape.id, at: `${entry.at}.${at}.fields.${field.id}` });
+          byId.set(field.id, group);
+        }
+      }
+    }
+    for (const [id, group] of byId) visit2(`${path25}.${id}`, group, [...shapeStack, ...shapesHere]);
+  };
+  for (const member of fieldsOfMembers(members)) {
+    const field = member;
+    visit2(field.id, [{ field, shape: null, at: field.id }], []);
+  }
+  return conflicts;
+}
+function quoted(ids) {
+  return ids.map((id) => `'${id}'`).join(", ");
+}
 function listItemFieldsOf(field) {
   return shapesOf(field).flatMap((shape) => fieldsOfMembers(shape.fields));
 }
@@ -9249,29 +10007,30 @@ function notComparedWarning(part, refusals) {
     suggestion: "Nothing to change for it: this deploy replaces the deployed definition, and the next deploy is compared against all of it"
   };
 }
-var USAGE_CONTAINERS, BaseValidator, ValidationUtils, NamingValidator, StructuralValidator, nestedLists, slugUniqueness, referenceTargetsResolve, NO_CHECKS, FIELD_CONFIG_CHECKS, FIELD_KIND_RULES, FieldConfigValidator, CrossReferenceValidator, BASIC_KINDS, NUMERIC_KINDS, DATE_KINDS, FieldsetValidator, CONTENT_TYPE_PROPS, GROUP_PROPS, QUERY_BASIC_PROPS, QUERY_OPTIONAL_PROPS, QUERY_DSL_BLOCKS, LOCALE_PROPS, ROLE_PROPS, WORKFLOW_STAGE_PROPS, VIEW_PROPS, FIELDSET_PROPS, ASSET_TYPE_PROPS, ASSET_KIND_BLOCKS, ASSET_KIND_KEY_MARKER, FILE_LOCALIZATION_MARKER, FIELD_REQUIRED_CHANGE_KEY, RICH_TEXT_NARROWING_CHANGE_KEYS, FIELD_SHAPE_CHANGE_KEY, FIELD_OPTIONS_CHANGE_KEY, SchemaDiffer, ADDED_LABEL, CROSS_VERSION_CHECKS, CROSS_VERSION_CODES, EvolutionValidator, NAVIGATION_KINDS, HierarchicalContentValidator, FieldRulesValidator, LOCALIZATION_FRIENDLY_KINDS, LocalizationValidator, LocaleConfigValidator, RECOMMENDED_SETTINGS_KINDS, DISCOURAGED_SETTINGS_KINDS, SettingsGroupsValidator, CONFIGURATION_KINDS, NOT_A_KIND_CONFIGURATION_TYPES, SingletonContentTypesValidator, FORBIDDEN_TYPES, AssetTypesValidator, COUNTED_TEXT_KINDS, WIDGET_KINDS, SUGGESTED_WIDGETS, HIGH_BENEFIT_UI_KINDS, DESCRIBED_KINDS, FieldUIValidator, DslQueryValidator, SLUG_SOURCE_KINDS, COMPLEX_SETTINGS_KINDS, SIMPLE_KINDS, LOCALIZABLE_TEXT_KINDS, DataIntegrityValidator, RolesValidator, EVOLUTION_VALIDATOR_KEY, CROSS_VERSION_CHECKS_SKIPPED, ValidationPipeline, SchemaValidator, FIELD_SECTIONS, OPERATION_TIER, DEPLOY_VALIDATION_CONFIG;
+var USAGE_CONTAINERS, BaseValidator, ValidationUtils, NamingValidator, StructuralValidator, nestedLists, slugUniqueness, referenceTargetsResolve, richTextLinkTargetsResolve, NO_CHECKS, FIELD_CONFIG_CHECKS, FIELD_KIND_RULES, FieldConfigValidator, CrossReferenceValidator, BASIC_KINDS, NUMERIC_KINDS, DATE_KINDS, FieldsetValidator, CONTENT_TYPE_PROPS, GROUP_PROPS, QUERY_BASIC_PROPS, QUERY_OPTIONAL_PROPS, QUERY_DSL_BLOCKS, LOCALE_PROPS, ROLE_PROPS, WORKFLOW_STAGE_PROPS, VIEW_PROPS, FIELDSET_PROPS, ASSET_TYPE_PROPS, ASSET_KIND_BLOCKS, ASSET_KIND_KEY_MARKER, FILE_LOCALIZATION_MARKER, FIELD_REQUIRED_CHANGE_KEY, RICH_TEXT_NARROWING_CHANGE_KEYS, RICH_TEXT_DECLARED_CHANGE_KEYS, FIELD_SHAPE_CHANGE_KEY, FIELD_OPTIONS_CHANGE_KEY, SchemaDiffer, ADDED_LABEL, CROSS_VERSION_CHECKS, CROSS_VERSION_CODES, EvolutionValidator, NAVIGATION_KINDS, HierarchicalContentValidator, FieldRulesValidator, LOCALIZATION_FRIENDLY_KINDS, LocalizationValidator, LocaleConfigValidator, RECOMMENDED_SETTINGS_KINDS, DISCOURAGED_SETTINGS_KINDS, SettingsGroupsValidator, CONFIGURATION_KINDS, NOT_A_KIND_CONFIGURATION_TYPES, SingletonContentTypesValidator, FORBIDDEN_TYPES, AssetTypesValidator, COUNTED_TEXT_KINDS, WIDGET_KINDS, SUGGESTED_WIDGETS, HIGH_BENEFIT_UI_KINDS, DESCRIBED_KINDS, FieldUIValidator, DslQueryValidator, SLUG_SOURCE_KINDS, COMPLEX_SETTINGS_KINDS, SIMPLE_KINDS, LOCALIZABLE_TEXT_KINDS, DataIntegrityValidator, RolesValidator, EVOLUTION_VALIDATOR_KEY, CROSS_VERSION_CHECKS_SKIPPED, ValidationPipeline, SchemaValidator, FIELD_SECTIONS, OPERATION_TIER, DEPLOY_VALIDATION_CONFIG;
 var init_dist2 = __esm({
   "../../domain/schema/dist/index.js"() {
-    init_chunk_7GULCWXY();
-    init_chunk_5FYSBHHZ();
-    init_chunk_W5P6N7TE();
-    init_chunk_OA32TBFV();
-    init_chunk_GG33YIFS();
+    init_chunk_OUTLPFR2();
+    init_chunk_JVCO3TTQ();
+    init_chunk_MLQFI2H5();
+    init_chunk_CTS2X4ES();
+    init_chunk_Q6EBYJVQ();
     init_chunk_NGOOYRLJ();
-    init_chunk_VXC2EEEM();
-    init_chunk_TVFFHTGZ();
-    init_chunk_SXB4UYLV();
-    init_chunk_KDABWSAA();
-    init_chunk_VIVFUDPH();
+    init_chunk_AAH22U23();
+    init_chunk_RFXTOU4J();
+    init_chunk_YPAAGSVJ();
+    init_chunk_NKUAK5EA();
+    init_chunk_AUX6CCB5();
     init_chunk_LK3PZTVM();
     init_chunk_46JQ2NQ5();
     init_chunk_GR7UT3XN();
-    init_chunk_3FBPIG5X();
-    init_chunk_GCR57WZV();
-    init_chunk_RDFZ6WP6();
+    init_chunk_QTFIQNJM();
+    init_chunk_MGMW4ZMJ();
+    init_chunk_DERETXFC();
+    init_chunk_UBAXWQKU();
     init_chunk_JH6U6ENN();
     init_chunk_IJSOONHT();
-    init_chunk_7HSDWMYK();
+    init_chunk_VFLLYTDW();
     USAGE_CONTAINERS = [
       "contentTypes",
       "singletonContentTypes",
@@ -9752,11 +10511,33 @@ var init_dist2 = __esm({
         }
       }
     };
+    richTextLinkTargetsResolve = ({ field, config, path: path25, index }, findings) => {
+      const links = config.links;
+      if (links === void 0 || links.to === void 0) return;
+      const resolved = resolveReferenceConfigTargets({ to: links.to }, index.schema);
+      for (const [position, typeId] of resolved.typeIds.entries()) {
+        if (resolved.unknownTypeIds.includes(typeId)) {
+          findings.error(
+            "REFERENCE_TARGET_NOT_FOUND",
+            `Field '${field.id}' links to non-existent type '${typeId}'`,
+            `${path25}.config.links.to[${position}]`,
+            "Link to an existing content type"
+          );
+        } else if (resolved.assetTypeIds.includes(typeId)) {
+          findings.error(
+            "RICH_TEXT_LINK_TO_ASSET_TYPE",
+            `Field '${field.id}' links to the asset type '${typeId}'; an entry link points at a content type`,
+            `${path25}.config.links.to[${position}]`,
+            "Link to a content type, or hold the asset in a reference field or a declared block"
+          );
+        }
+      }
+    };
     NO_CHECKS = { declared: [], integrity: [] };
     FIELD_CONFIG_CHECKS = {
       shortText: NO_CHECKS,
       longText: NO_CHECKS,
-      richText: NO_CHECKS,
+      richText: { declared: [], integrity: [richTextLinkTargetsResolve] },
       table: NO_CHECKS,
       code: NO_CHECKS,
       email: NO_CHECKS,
@@ -9772,7 +10553,9 @@ var init_dist2 = __esm({
       tags: NO_CHECKS,
       list: { declared: [nestedLists], integrity: [] },
       // Its shapes' fields are checked where `SchemaIndex` indexes them, as any field is
-      object: NO_CHECKS
+      object: NO_CHECKS,
+      // Its JSON Schema is the declaration's to judge, keyword by keyword (REL-1811)
+      json: NO_CHECKS
     };
     FIELD_KIND_RULES = {
       shortText: {
@@ -9864,6 +10647,11 @@ var init_dist2 = __esm({
         config: configDeclarationOf("object"),
         configChecks: FIELD_CONFIG_CHECKS.object,
         valueValidation: FIELD_KIND_VALUE_RULES.object
+      },
+      json: {
+        config: configDeclarationOf("json"),
+        configChecks: FIELD_CONFIG_CHECKS.json,
+        valueValidation: FIELD_KIND_VALUE_RULES.json
       }
     };
     FieldConfigValidator = class extends BaseValidator {
@@ -9943,7 +10731,7 @@ var init_dist2 = __esm({
         this.traverseFields(index, (field, path25, _context) => {
           const contentTypeId = this.extractContentTypeIdFromPath(path25);
           if (!contentTypeId) return;
-          for (const { shape, at } of shapePlacesOf(field)) {
+          for (const { shape, at } of fieldsetPlacesOf(field)) {
             const itemFields = fieldsOfType(shape);
             const itemFieldIds = itemFields.map(({ field: itemField }) => itemField.id);
             for (const { field: itemField, path: itemPath } of itemFields) {
@@ -10059,7 +10847,7 @@ var init_dist2 = __esm({
               visitFieldset(member, `${basePath}.${member.id}`, ancestors);
               continue;
             }
-            for (const { shape, at } of shapePlacesOf(member)) {
+            for (const { shape, at } of fieldsetPlacesOf(member)) {
               visitFieldset(shape, `${basePath}.${member.id}.${at}`, ancestors);
             }
           }
@@ -10301,8 +11089,16 @@ var init_dist2 = __esm({
     RICH_TEXT_NARROWING_CHANGE_KEYS = [
       "config.structure",
       "config.marks",
-      "config.multiline"
+      "config.multiline",
+      "config.blocks",
+      "config.inline",
+      // The types its entry links point at (REL-1808): fewer is a narrowing, as fewer blocks is
+      "config.links"
     ];
+    RICH_TEXT_DECLARED_CHANGE_KEYS = /* @__PURE__ */ new Set([
+      "config.blocks",
+      "config.inline"
+    ]);
     FIELD_SHAPE_CHANGE_KEY = "config.of";
     FIELD_OPTIONS_CHANGE_KEY = "config.options";
     SchemaDiffer = class {
@@ -10585,6 +11381,11 @@ var init_dist2 = __esm({
                 addedRequiredFields: addedRequiredFieldsOf(
                   fieldChanges,
                   this.extractAllFields(newItem)
+                ),
+                narrowedRichTextFields: narrowedRichTextFieldsOf(
+                  fieldChanges,
+                  this.extractAllFields(oldItem),
+                  this.extractAllFields(newItem)
                 )
               });
             }
@@ -10725,6 +11526,11 @@ var init_dist2 = __esm({
                 addedRequiredFields: addedRequiredFieldsOf(
                   fieldChanges,
                   this.extractAllFields(newItem)
+                ),
+                narrowedRichTextFields: narrowedRichTextFieldsOf(
+                  fieldChanges,
+                  this.extractAllFields(oldItem),
+                  this.extractAllFields(newItem)
                 )
               });
             }
@@ -10769,6 +11575,11 @@ var init_dist2 = __esm({
                 addedRequiredFields: addedRequiredFieldsOf(
                   fieldChanges,
                   newItem.fields
+                ),
+                narrowedRichTextFields: narrowedRichTextFieldsOf(
+                  fieldChanges,
+                  oldItem.fields,
+                  newItem.fields
                 )
               });
             }
@@ -11678,9 +12489,40 @@ var init_dist2 = __esm({
             this.validateFieldFallback(field, path25, result, allFieldIds, context);
           }
         });
+        this.validateShapeLocalization(index, result);
         this.addLocalizationSummary(result, localizationStats);
         return result;
       }
+      /**
+       * One field id localized in one shape of an object and shared in another, outside every list
+       * (REL-2038 item 4): the localized path (`hero.alt`) does not name the shape there, so it would
+       * carry both meanings. Refused at the localized declaration, naming the path and the shapes.
+       */
+      validateShapeLocalization(index, result) {
+        const records = [
+          ["contentTypes", index.contentTypes.entries],
+          ["singletonContentTypes", index.singletonContentTypes.entries],
+          ["settingsGroups", index.settingsGroups.entries],
+          ["assetTypes", index.assetTypes.entries]
+        ];
+        for (const [container, entries] of records) {
+          for (const [id, record] of entries) {
+            const members = record.fields;
+            if (!Array.isArray(members)) continue;
+            for (const conflict of shapeLocalizationConflictsOf(members)) {
+              result.errors.push(
+                this.createError(
+                  "AMBIGUOUS_SHAPE_LOCALIZATION",
+                  `Field '${conflict.path}' is localized in shape ${quoted(conflict.localizedIn)} and shared in shape ${quoted(conflict.sharedIn)}: outside a list, a localized path does not name the shape its value takes, so it cannot mean both`,
+                  `${container}.${id}.fields.${conflict.at}`,
+                  "error",
+                  "Declare the field localized in every shape of the object, or in none, or give it a different id in one of them"
+                )
+              );
+            }
+          }
+        }
+      }
       collectAllFieldIds(index) {
         const fieldIds = /* @__PURE__ */ new Set();
         this.traverseFields(index, (field) => {
@@ -11708,8 +12550,31 @@ var init_dist2 = __esm({
           this.validateArrayLocalization(localization, localizationPath, result, field);
         } else if (localization !== void 0) {
           this.validateRequiredLocales(localization.requiredLocales, localizationPath, result);
+          this.refuseRequiredLocalesOnSharedField(field, localizationPath, result);
         }
       }
+      /**
+       * `requiredLocales` on a field that is not localized (REL-2196): a shared value is one value every
+       * locale shows, never a locale's own, so the publish check — an own value in each named locale —
+       * could never pass, and every publish of a named locale was refused for a value no locale holds.
+       * Refused by name, as a declaration that cannot mean anything.
+       */
+      refuseRequiredLocalesOnSharedField(field, localizationPath, result) {
+        if (isFieldLocalized(field)) return;
+        const declared = field.localization;
+        if (typeof declared !== "object" || declared === null || Array.isArray(declared)) return;
+        const required = declared.requiredLocales ?? [];
+        if (required.length === 0) return;
+        result.errors.push(
+          this.createError(
+            "REQUIRED_LOCALES_ON_SHARED_FIELD",
+            `Field '${field.id}' requires its own value in ${quoted(required)} but is not localized: a shared value is one value every locale shows, so no locale holds one of its own`,
+            `${localizationPath}.requiredLocales`,
+            "error",
+            "Enable localization on the field, or remove requiredLocales"
+          )
+        );
+      }
       validateBooleanLocalization(enabled, localizationPath, result, field) {
         if (enabled) {
           result.info.push(
@@ -13487,7 +14352,7 @@ var init_dist2 = __esm({
             this.validateFieldTypeSpecificUI(field.ui, fieldType, path25, result, stats);
           }
         }
-        for (const { shape, at } of shapePlacesOf(field)) {
+        for (const { shape, at } of fieldsetPlacesOf(field)) {
           for (const { field: itemField, path: itemPath } of fieldsOfType(shape)) {
             this.validateFieldUI(
               itemField,
@@ -13915,7 +14780,7 @@ var init_dist2 = __esm({
             );
           }
           const fieldsWithWidgets = Object.values(stats.widgetUsageBreakdown).reduce(
-            (sum, count) => sum + count,
+            (sum, count2) => sum + count2,
             0
           );
           if (fieldsWithWidgets > 0) {
@@ -16346,14 +17211,14 @@ var init_dist2 = __esm({
        * was tuned against.
        */
       countTotalFields(index) {
-        let count = 0;
+        let count2 = 0;
         for (const ct of index.contentTypes.values) {
-          count += ct.fields?.length || 0;
+          count2 += ct.fields?.length || 0;
         }
         for (const sct of index.singletonContentTypes.values) {
-          count += sct.fields?.length || 0;
+          count2 += sct.fields?.length || 0;
         }
-        return count;
+        return count2;
       }
       createEmptyResult() {
         return {
@@ -17790,13 +18655,16 @@ function planPathLabel(path25) {
   const shape = path25.shape === void 0 ? "" : `.$${path25.shape}`;
   return `${path25.section}.${path25.type}${field}${subpath}${option}${shape}`;
 }
-function plural(count, noun, nouns = `${noun}s`) {
-  return `${count} ${count === 1 ? noun : nouns}`;
+function plural(count2, noun, nouns = `${noun}s`) {
+  return `${count2} ${count2 === 1 ? noun : nouns}`;
 }
-function formatAdaptationCount(count) {
-  if (count.state === "uncountable") return `could not be counted (${count.reason})`;
-  const counted = `${plural(count.entries, "entry", "entries")}, ${plural(count.locales, "locale")}`;
-  return count.items === void 0 ? counted : `${counted}, ${plural(count.items, "item")}`;
+function formatAdaptationCount(count2) {
+  if (count2.state === "uncountable") return `could not be counted (${count2.reason})`;
+  const parts = [plural(count2.entries, "entry", "entries"), plural(count2.locales, "locale")];
+  if (count2.items !== void 0) parts.push(plural(count2.items, "item"));
+  if (count2.blocks !== void 0) parts.push(plural(count2.blocks, "block"));
+  if (count2.links !== void 0) parts.push(plural(count2.links, "entry link"));
+  return parts.join(", ");
 }
 function datasetLines(datasets) {
   if (datasets.length <= 1 && datasets.every((dataset) => dataset.inherited === null)) return [];
@@ -17831,7 +18699,8 @@ function residueLines(residue) {
   ];
 }
 function refusalLines(refusal) {
-  const items = refusal.items === void 0 ? "" : `, ${plural(refusal.items, "item")}`;
+  const counted = refusal.code === "LIST_BELOW_MIN_ITEMS" ? "list" : "item";
+  const items = refusal.items === void 0 ? "" : `, ${plural(refusal.items, counted)}`;
   return [
     `  ${chalk13.red("Refused".padEnd(16))}${chalk13.bold(planPathLabel(refusal.path))}  ${chalk13.gray(`${refusal.code}, ${plural(refusal.entries, "entry", "entries")}${items}`)}`,
     `  ${" ".repeat(16)}${refusal.message}`
@@ -17873,14 +18742,16 @@ var init_adaptation_plan = __esm({
       archives: "Archives",
       backfills: "Backfills",
       renames: "Renames",
-      nothing: "Changes nothing"
+      nothing: "Changes nothing",
+      "leaves-to-author": "Left to author"
     };
     ACTION_COLOR = {
       deletes: chalk13.red,
       archives: chalk13.yellow,
       backfills: chalk13.cyan,
       renames: chalk13.yellow,
-      nothing: chalk13.gray
+      nothing: chalk13.gray,
+      "leaves-to-author": chalk13.magenta
     };
   }
 });
@@ -18025,12 +18896,11 @@ function collectFieldsets(elements) {
         visitFieldset(member, owner, false);
         continue;
       }
-      const parsed = typeof member.type === "string" ? parseFieldType(member.type) : { key: null };
-      if (parsed.key === null || CONFIG_WRITTEN_AS[parsed.key] !== "shapeBuilder") continue;
+      if (typeof member.type !== "string") continue;
       const field = `${owner}, field '${String(member.id)}'`;
-      for (const { shape } of shapePlacesOf({
+      for (const { shape } of fieldsetPlacesOf({
         id: String(member.id),
-        type: parsed.key,
+        type: member.type,
         config: member.config
       })) {
         visitFieldset(shape, field, true);
@@ -18390,7 +19260,7 @@ ${prefix}: ${error2.path}`, `   ${error2.message}`);
     CONFIG_WRITTEN_AS = {
       shortText: "verbatim",
       longText: "verbatim",
-      richText: "verbatim",
+      richText: "richTextShapes",
       table: "verbatim",
       code: "verbatim",
       email: "verbatim",
@@ -18405,7 +19275,8 @@ ${prefix}: ${error2.path}`, `   ${error2.message}`);
       reference: "verbatim",
       tags: "verbatim",
       list: "shapeBuilder",
-      object: "shapeBuilder"
+      object: "shapeBuilder",
+      json: "jsonSchemaConst"
     };
     TypeScriptGenerator = class {
       schema;
@@ -18536,7 +19407,7 @@ ${this.usageExample().map((line) => line ? ` * ${line}` : " *").join("\n")}
         const typeImports = [
           "InferContentType",
           "InferSingleton",
-          "InferAssetType",
+          "InferAssetEntry",
           "InferSettingsGroup",
           "ShapeValue"
         ].filter((name) => used(name));
@@ -18567,9 +19438,10 @@ import type {} from '@relyio/sdk'
       /**
        * Every fieldset the schema places, once per id, as a `fieldset(…)` const — the one type per
        * fieldset id (REL-1799). A fieldset id names one shape across the whole schema, whether it is a
-       * section in one place and a list's or an object's shape in another (ADR 0012), so the file
-       * declares it once and every place it stands names the const, as a hand-written schema passes the
-       * same value. A fieldset that holds another comes after it.
+       * section in one place, a list's or an object's shape in another and a rich-text field's Block or
+       * Inline element in a third (ADR 0012, REL-1812), so the file declares it once and every place it
+       * stands names the const, as a hand-written schema passes the same value. A fieldset that holds
+       * another comes after it.
        */
       addFieldsets() {
         this.fieldsets = collectFieldsets([
@@ -18580,7 +19452,8 @@ import type {} from '@relyio/sdk'
         ]);
         if (this.fieldsets.size === 0) return;
         this.output.push(`// ============================================================================
-// \u{1F9E9} Fieldsets (a section where they stand among fields, a shape as a list's or object's \`of\`)
+// \u{1F9E9} Fieldsets (a section where they stand among fields; a shape as a list's or object's \`of\`,
+// and as a rich-text field's \`blocks\` or \`inline\`)
 // ============================================================================
 `);
         for (const fieldset of this.fieldsets.values()) {
@@ -18784,6 +19657,12 @@ import type {} from '@relyio/sdk'
           if (key === "config" && parsed.key !== null && CONFIG_WRITTEN_AS[parsed.key] === "shapeBuilder" && this.isRecord(value)) {
             return [`config: ${this.shapesConfig(parsed.key, value, where)}`];
           }
+          if (key === "config" && parsed.key !== null && CONFIG_WRITTEN_AS[parsed.key] === "richTextShapes" && this.isRecord(value)) {
+            return [`config: ${this.richTextShapesConfig(parsed.key, value, where)}`];
+          }
+          if (key === "config" && parsed.key !== null && CONFIG_WRITTEN_AS[parsed.key] === "jsonSchemaConst" && this.isRecord(value)) {
+            return [`config: ${this.jsonSchemaConfig(value)}`];
+          }
           return [`${this.propertyKey(key)}: ${this.literal(value)}`];
         });
         const optionsArgument = options.length > 0 ? [`{ ${options.join(", ")} }`] : [];
@@ -18812,6 +19691,43 @@ import type {} from '@relyio/sdk'
         });
         return `{ ${entries.join(", ")} }`;
       }
+      /**
+       * A rich-text field's config, verbatim but for its declared Blocks and Inline elements (REL-1812):
+       * each of `blocks` and `inline` a list of its fieldsets' consts, read through
+       * `richTextShapePlacesOf`, the one reading of them. Written inline, a fieldset was a literal the
+       * SDK could read no field type from — every field of a callout read as `unknown` — and a fieldset
+       * declared in two fields was two definitions. `links` names types, not fieldsets, so it is written
+       * as declared; an option holding no fieldset is written verbatim, for deploy to refuse.
+       */
+      richTextShapesConfig(kind, config, owner) {
+        const places = richTextShapePlacesOf({ type: kind, config });
+        const options = new Set(RICH_TEXT_SHAPE_OPTIONS);
+        const entries = Object.entries(config).flatMap(([key, value]) => {
+          if (value === void 0) return [];
+          const shapes = places.filter((place) => place.option === key);
+          if (options.has(key) && shapes.length > 0) {
+            const written = shapes.map(
+              ({ shape, at }) => this.generateFieldset(shape, `${owner}, ${at}`)
+            );
+            return [`${key}: [${written.join(", ")}]`];
+          }
+          return [`${this.propertyKey(key)}: ${this.literal(value)}`];
+        });
+        return `{ ${entries.join(", ")} }`;
+      }
+      /**
+       * A json field's config, verbatim but for its JSON Schema, written `as const` (REL-1811): the SDK
+       * infers the field's read from the schema literal, and without `as const` a `required` list and an
+       * `enum` widen to `string[]`, so every property would read as optional.
+       */
+      jsonSchemaConfig(config) {
+        const entries = Object.entries(config).flatMap(([key, value]) => {
+          if (value === void 0) return [];
+          if (key === "schema") return [`schema: ${this.literal(value)} as const`];
+          return [`${this.propertyKey(key)}: ${this.literal(value)}`];
+        });
+        return `{ ${entries.join(", ")} }`;
+      }
       /**
        * Add schema export
        */
@@ -18936,11 +19852,13 @@ import type {} from '@relyio/sdk'
        * `content('post')` reads. Without it a reference would read as `UnresolvedEntry`, though the
        * client resolves it.
        *
-       * A fieldset placed as a shape — a list's or an object's `of` — has one alias for its id,
-       * `<Id>Fieldset`: `ShapeValue<typeof <id>Fieldset, SchemaTypes>`, the `_type`, `_key` and fields
-       * an item or an object's value of it holds, which is what the client types it as (REL-1799).
-       * Suffixed, as its const is, because a fieldset id may be a type's id too. A fieldset that is only
-       * ever a section has no alias: its fields join the record it sits in, and it holds no value.
+       * A fieldset placed as a shape — a list's or an object's `of`, or a rich-text field's `blocks` or
+       * `inline` — has one alias for its id, `<Id>Fieldset`: `ShapeValue<typeof <id>Fieldset,
+       * SchemaTypes>`, the `_type`, `_key` and fields an item, an object's value or a node of rich text
+       * of it holds, which is what the client types it as (REL-1799, REL-1812). One alias wherever it
+       * stands: a `link` in four lists is one `LinkFieldset`. Suffixed, as its const is, because a
+       * fieldset id may be a type's id too. A fieldset that is only ever a section has no alias: its
+       * fields join the record it sits in, and it holds no value.
        *
        * Every kind's alias is its id in PascalCase, as a content type's is. Ids are unique across kinds
        * (case-insensitively, the schema's `NAME_CONFLICT`), so two aliases collide only where the recipe
@@ -18967,15 +19885,15 @@ export type ${this.declare("SchemaTypes", "type", "the SchemaTypes export")} = t
         for (const [, assetType] of this.schema.assetTypes) {
           const varName = naming.camel(assetType.id);
           const typeName = this.aliasOf(assetType.id, `asset type '${assetType.id}'`);
-          lines.push(`export type ${typeName} = InferAssetType<typeof ${varName}, SchemaTypes>`);
+          lines.push(`export type ${typeName} = InferAssetEntry<typeof ${varName}, SchemaTypes>`);
           if (assetType.variantIds && assetType.variantIds.length > 0) {
-            const union2 = assetType.variantIds.map((vid) => this.literal(vid)).join(" | ");
+            const union3 = assetType.variantIds.map((vid) => this.literal(vid)).join(" | ");
             const variantName = this.declare(
               `${typeName}Variant`,
               "type",
               `asset type '${assetType.id}' (its variant ids)`
             );
-            lines.push(`export type ${variantName} = ${union2}`);
+            lines.push(`export type ${variantName} = ${union3}`);
           }
         }
         for (const [id] of this.schema.singletons) {
@@ -19140,11 +20058,14 @@ __export(dist_exports2, {
 function className(id) {
   return escape(naming.pascal(id), (name) => PYTHON_KEYWORDS.has(name) || IMPORTED_NAMES.has(name));
 }
+function expandedClassName(id) {
+  return escape(`Expanded${naming.pascal(id)}`, (name) => IMPORTED_NAMES.has(name));
+}
 function moduleName(id) {
   return escape(naming.snake(id), (name) => PYTHON_KEYWORDS.has(name));
 }
 function attributeName(key, taken) {
-  const snake = naming.snake(key);
+  const snake = identifierOf(naming.snake(key));
   const name = escape(
     snake.startsWith(MODEL_NAMESPACE) ? `${snake}_` : snake,
     (candidate) => PYTHON_KEYWORDS.has(candidate) || SHADOWED_IN_CLASS_BODY.has(candidate) || MODEL_MEMBERS.has(candidate) || taken.has(candidate)
@@ -19152,6 +20073,13 @@ function attributeName(key, taken) {
   taken.add(name);
   return name;
 }
+function identifierOf(snake) {
+  const word = snake.replaceAll(/[^A-Za-z0-9_]/g, "_").replace(/^_+/, "");
+  return /^[A-Za-z]/.test(word) ? word : `key_${word}`;
+}
+function memberClassName(owner, key) {
+  return `${owner}${naming.pascal(key).replaceAll(/[^A-Za-z0-9_]/g, "")}`;
+}
 function uniqueName(name, taken) {
   const unique = escape(name, (candidate) => taken.has(candidate));
   taken.add(unique);
@@ -19163,6 +20091,62 @@ function pyString(value) {
 function pyDocstring(text) {
   return `"""${text.replaceAll("\\", "\\\\").replaceAll('"', String.raw`\"`)}"""`;
 }
+function literal(values) {
+  const members = values.map(
+    (value) => typeof value === "string" ? pyString(value) : typeof value === "boolean" ? value ? "True" : "False" : String(value)
+  );
+  return `Literal[${members.join(", ")}]`;
+}
+function blockOf(family) {
+  return union([
+    family.name("paragraph"),
+    family.name("heading"),
+    family.name("quote"),
+    family.name("list"),
+    family.name("codeBlock"),
+    family.name("codeGroup"),
+    family.name("table"),
+    family.name("divider"),
+    ...family.blocks
+  ]);
+}
+function inlineOf(family) {
+  return union([family.name("text"), family.name("lineBreak"), ...family.inline]);
+}
+function markOf(family) {
+  return union([
+    family.name("link"),
+    family.name("mark"),
+    ...family.links ? [family.name("entryLink")] : []
+  ]);
+}
+function familyNodes(links) {
+  return Object.keys(RICH_TEXT_NODES).filter(
+    (node) => RICH_TEXT_NODES[node].perField && (node !== "entryLink" || links)
+  );
+}
+function builtInNodes() {
+  return Object.keys(RICH_TEXT_NODES).filter((node) => node !== "entryLink");
+}
+function familyName(prefix, node) {
+  return `${prefix}${RICH_TEXT_NODES[node].name.replace(/^RichText/, "")}`;
+}
+function nodeAttributes(node, family) {
+  return Object.entries(RICH_TEXT_NODES[node].attributes).map(([key, attribute]) => ({
+    key,
+    required: attribute.required,
+    annotation: attribute.annotation(family)
+  }));
+}
+function referenceOf(field, to, scope) {
+  const targets = typeof to === "string" || Array.isArray(to) && to.every((target) => typeof target === "string") ? normalizeReferenceTargets(to) : [];
+  if (targets.length === 0) {
+    throw new Error(
+      `${field.id} names no type it references, which deploy refuses and the Python target has no type for.`
+    );
+  }
+  return `Union[${["str", ...targets.map((target) => scope.entry(target, field))].join(", ")}]`;
+}
 function isRecord6(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -19170,12 +20154,183 @@ function arrayAt(field, key) {
   const value = field.config?.[key];
   return Array.isArray(value) ? value : [];
 }
-function union(classes) {
+function union2(classes) {
   return `Union[${classes.join(", ")}]`;
 }
+function unionOf(types) {
+  const distinct4 = [...new Set(types)];
+  if (distinct4.includes("Any")) return "Any";
+  const others = distinct4.filter((type) => type !== "None");
+  const inner = others.length === 1 ? others[0] ?? "Any" : union2(others);
+  if (others.length === 0) return "None";
+  return distinct4.includes("None") ? `Optional[${inner}]` : inner;
+}
+function literalOf(value) {
+  if (typeof value === "string") return pyString(value);
+  if (typeof value === "boolean") return value ? "True" : "False";
+  if (value === null) return "None";
+  if (typeof value === "number" && Number.isInteger(value)) return String(value);
+  return null;
+}
+function literalsOf(values) {
+  const members = values.map((value) => literalOf(value));
+  if (members.length === 0 || members.some((member) => member === null)) return "Any";
+  const present = members.filter((member) => member !== null && member !== "None");
+  if (present.length === 0) return "None";
+  const literal2 = `Literal[${present.join(", ")}]`;
+  return members.includes("None") ? `Optional[${literal2}]` : literal2;
+}
+function jsonSchemaClasses(schema, name, doc, naming3) {
+  const classes = [];
+  const annotation = jsonSchemaType(schema, name, doc, naming3, classes);
+  return { annotation, classes };
+}
+function jsonSchemaType(schema, name, doc, naming3, classes) {
+  if (!isRecord6(schema)) return "Any";
+  if (typeof schema.$ref === "string") return naming3.ref?.(schema.$ref) ?? "Any";
+  if (Object.hasOwn(schema, "const")) return literalsOf([schema.const]);
+  if (Array.isArray(schema.enum)) return literalsOf(schema.enum);
+  for (const combinator of ["anyOf", "oneOf"]) {
+    const branches = schema[combinator];
+    if (Array.isArray(branches)) {
+      return unionOf(
+        branches.map(
+          (branch, index) => jsonSchemaType(
+            branch,
+            `${name}Option${index + 1}`,
+            `One branch of ${name}.`,
+            naming3,
+            classes
+          )
+        )
+      );
+    }
+  }
+  const type = schema.type;
+  const ofType = (each) => jsonType(each, schema, name, doc, naming3, classes);
+  if (Array.isArray(type)) return unionOf(type.map((each) => ofType(each)));
+  return type === void 0 ? "Any" : ofType(type);
+}
+function jsonType(type, schema, name, doc, naming3, classes) {
+  switch (type) {
+    case "string": {
+      return "str";
+    }
+    case "integer": {
+      return "int";
+    }
+    case "number": {
+      return "float";
+    }
+    case "boolean": {
+      return "bool";
+    }
+    case "null": {
+      return "None";
+    }
+    case "array": {
+      if (schema.items === void 0) return "List[Any]";
+      const item = jsonSchemaType(
+        schema.items,
+        `${name}Item`,
+        `One item of ${name}.`,
+        naming3,
+        classes
+      );
+      return `List[${item}]`;
+    }
+    case "object": {
+      const properties = isRecord6(schema.properties) ? Object.entries(schema.properties) : [];
+      if (properties.length > 0) return objectClass(schema, properties, name, doc, naming3, classes);
+      const additional = schema.additionalProperties;
+      if (!isRecord6(additional)) return "Dict[str, Any]";
+      const value = jsonSchemaType(
+        additional,
+        `${name}Value`,
+        `One value of ${name}.`,
+        naming3,
+        classes
+      );
+      return `Dict[str, ${value}]`;
+    }
+    default: {
+      return "Any";
+    }
+  }
+}
+function objectClass(schema, properties, name, doc, naming3, classes) {
+  const className2 = uniqueName(name, naming3.taken);
+  const required = new Set(
+    Array.isArray(schema.required) ? schema.required.filter((key) => typeof key === "string") : []
+  );
+  const attributes = [];
+  const described = typeof schema.description === "string" ? schema.description : doc;
+  const written = { name: className2, doc: described, attributes };
+  classes.push(written);
+  for (const [key, property] of properties) {
+    attributes.push({
+      key,
+      annotation: jsonSchemaType(
+        property,
+        memberClassName(className2, key),
+        `The \`${key}\` of ${className2}.`,
+        naming3,
+        classes
+      ),
+      required: required.has(key)
+    });
+  }
+  return className2;
+}
 function pythonTypeOf(field, kind, scope) {
   return ROWS[kind](field, scope);
 }
+function readBlockClasses() {
+  const schemas = define_RELYIO_READ_BLOCK_SCHEMAS_default;
+  const names = Object.keys(schemas);
+  const blocks = [
+    "EntryMetadata",
+    "SingletonMetadata",
+    "SettingsGroupMetadata",
+    "AssetFile",
+    "AssetUrls"
+  ];
+  for (const block of blocks) {
+    if (!names.includes(block)) {
+      throw new Error(`The Content API's document declares no ${block}, which a read carries.`);
+    }
+  }
+  const ref = (target) => {
+    const name = target.startsWith(REF_PREFIX) ? target.slice(REF_PREFIX.length) : "";
+    if (!names.includes(name)) {
+      throw new Error(
+        `A read block names ${target}, which the Content API's document does not declare.`
+      );
+    }
+    return name;
+  };
+  const taken = new Set(names);
+  const classes = [];
+  for (const name of names) {
+    taken.delete(name);
+    const written = jsonSchemaClasses(
+      schemas[name],
+      name,
+      `${name}, as the Content API's document declares it.`,
+      { taken, ref }
+    );
+    if (written.annotation !== name) {
+      throw new Error(
+        `The Content API's document declares ${name} as ${written.annotation}, not an object with properties.`
+      );
+    }
+    classes.push(...written.classes);
+  }
+  return classes;
+}
+function metadataOf(block) {
+  return { name: "metadata", key: "_metadata", block, required: true };
+}
 function itemKeys(shapeId) {
   return [
     { name: "type", key: "_type", annotation: `Literal[${pyString(shapeId)}]`, required: true },
@@ -19211,6 +20366,26 @@ function elementsOf(ir, kind, warnings) {
     };
   });
 }
+function classOf(spec) {
+  const taken = /* @__PURE__ */ new Set();
+  return {
+    name: spec.name,
+    doc: spec.doc,
+    attributes: spec.attributes.map((attribute) => ({
+      name: attributeName(attribute.key, taken),
+      ...attribute
+    }))
+  };
+}
+function declaresAnything(field) {
+  const { blocks, inline } = richTextShapesOf(field);
+  return blocks.length > 0 || inline.length > 0 || linkTargetsOf(field).length > 0;
+}
+function linkTargetsOf(field) {
+  const to = isRecord22(field.config?.links) ? field.config.links.to : void 0;
+  const declared = typeof to === "string" || Array.isArray(to) && to.every((type) => typeof type === "string");
+  return declared ? richTextLinkTargetsOf({ to }) : [];
+}
 function optional(attribute) {
   return { ...attribute, required: false };
 }
@@ -19237,7 +20412,7 @@ function renderAttribute(attribute, baseModel) {
   const alias = `metadata={${pyString("alias")}: ${pyString(key)}}`;
   return `${name}: ${annotation} = field(${required ? "" : "default=None, "}${alias})`;
 }
-function renderModule(doc, imports, classes, baseModel) {
+function renderModule(doc, classes, imports, baseModel) {
   const header = baseModel === "pydantic" ? [
     "from typing import Any, Dict, List, Literal, Optional, Union",
     "",
@@ -19249,9 +20424,16 @@ function renderModule(doc, imports, classes, baseModel) {
   return [
     pyDocstring(doc),
     "",
+    "from __future__ import annotations",
+    "",
     ...header,
-    ...imports.length > 0 ? ["", ...imports] : [],
     ...classes.flatMap((spec) => ["", "", renderClass(spec, baseModel)]),
+    ...imports.length > 0 ? [
+      "",
+      "",
+      "# Imported after the classes above, so modules that name each other import each other",
+      ...imports.map((line) => `${line}  # noqa: E402`)
+    ] : [],
     "",
     "",
     exportList(classes.map((spec) => spec.name))
@@ -19261,19 +20443,42 @@ function exportList(names) {
   return `__all__ = [${names.map((name) => pyString(name)).join(", ")}]
 `;
 }
-function writeElement(element, kind, shapes, options) {
+function writeElement(element, kind, catalog, options) {
   const model = className(element.id);
+  const expanded = kind.expanded === null ? null : expandedClassName(element.id);
   const create = `Create${naming.pascal(element.id)}Input`;
   const update = `Update${naming.pascal(element.id)}Input`;
-  const exports = [model, ...kind.create ? [create] : [], ...kind.update ? [update] : []];
+  const exports = [
+    model,
+    ...kind.create ? [create] : [],
+    ...kind.update ? [update] : [],
+    ...expanded === null ? [] : [expanded]
+  ];
   const display = element.displayName ?? `${model} ${kind.label}`;
-  const module = new ModuleWriter("..fieldsets.", shapes, exports);
-  const fields = module.attributes(element.fields, element.id, kind.envelope);
+  const module = new ModuleWriter(
+    { directory: kind.directory, module: moduleName(element.id) },
+    model,
+    catalog,
+    exports
+  );
+  module.reserveFamilies(element.fields, element.id);
+  const envelope = module.envelope(kind.envelope);
+  const fields = module.attributes(element.fields, element.id, envelope);
   module.declare({
     name: model,
     doc: display,
-    attributes: [...kind.envelope, ...fields.map((attribute) => optional(attribute))]
+    attributes: [...envelope, ...fields.map((attribute) => optional(attribute))]
   });
+  if (expanded !== null && kind.expanded !== null) {
+    module.declare({
+      name: expanded,
+      doc: `${display}, as an include expands it: its fields beside an entry's metadata.`,
+      attributes: [
+        ...module.envelope(kind.expanded),
+        ...fields.map((attribute) => optional(attribute))
+      ]
+    });
+  }
   if (kind.create) {
     module.declare({ name: create, doc: `What creating a ${display} sends.`, attributes: fields });
   }
@@ -19287,20 +20492,61 @@ function writeElement(element, kind, shapes, options) {
   const doc = `${display}: the ${kind.label} \`${element.id}\`, written by \`relyio generate-types\` from the schema.`;
   return { content: module.render(doc, options.baseModel ?? "dataclass"), exports };
 }
-function writeFieldset(shape, shapes, options) {
+function writeFieldset(shape, catalog, options) {
   const name = className(shape.id);
-  const module = new ModuleWriter(".", shapes, [name]);
+  const module = new ModuleWriter(
+    { directory: FIELDSETS.directory, module: moduleName(shape.id) },
+    name,
+    catalog,
+    [name]
+  );
+  module.reserveFamilies(shape.fields, shape.at);
   const keys = itemKeys(shape.id);
   const attributes = [...keys, ...module.attributes(shape.fields, shape.at, keys)];
   const display = shape.displayName ?? `${name} fieldset`;
   module.declare({
     name,
-    doc: `${display}: one value of the fieldset \`${shape.id}\`, as a list's item or an object's value.`,
+    doc: `${display}: one value of the fieldset \`${shape.id}\`, as a list's item, an object's value or a node of rich text.`,
     attributes: attributes.map((attribute) => optional(attribute))
   });
   const doc = `${display}: the fieldset \`${shape.id}\`, written by \`relyio generate-types\` from the schema.`;
   return { content: module.render(doc, options.baseModel ?? "dataclass"), exports: [name] };
 }
+function writeRichText(options) {
+  const nodes = builtInNodes();
+  const family = {
+    name: (node) => RICH_TEXT_NODES[node].name,
+    blocks: [],
+    inline: [],
+    links: false,
+    entryLinkTo: ""
+  };
+  const classes = nodes.map((node) => {
+    const taken = /* @__PURE__ */ new Set();
+    return {
+      name: RICH_TEXT_NODES[node].name,
+      doc: RICH_TEXT_NODES[node].doc,
+      attributes: nodeAttributes(node, family).map((attribute) => ({
+        name: attributeName(attribute.key, taken),
+        ...attribute
+      }))
+    };
+  });
+  return renderModule(
+    "The rich-text tree (version 1): one class per node, written by `relyio generate-types`.",
+    classes,
+    [],
+    options.baseModel ?? "dataclass"
+  );
+}
+function writeReadBlocks(options) {
+  return renderModule(
+    "What a Content API read carries beside its fields, from the API's document, written by `relyio generate-types`.",
+    readBlockClasses().map((spec) => classOf(spec)),
+    [],
+    options.baseModel ?? "dataclass"
+  );
+}
 function shapesIn(ir, warnings) {
   const shapes = /* @__PURE__ */ new Map();
   const written = /* @__PURE__ */ new Map();
@@ -19313,7 +20559,8 @@ function shapesIn(ir, warnings) {
         continue;
       }
       if (typeof member.type !== "string" || typeof member.id !== "string") continue;
-      for (const shape of shapesOf({ id: member.id, type: member.type, config: member.config })) {
+      const places = fieldsetPlacesOf({ id: member.id, type: member.type, config: member.config });
+      for (const { shape } of places) {
         const text = JSON.stringify(shape);
         const seen = written.get(shape.id);
         if (seen !== void 0) {
@@ -19345,15 +20592,32 @@ function shapesIn(ir, warnings) {
   }
   return shapes;
 }
+function entriesIn(ir) {
+  const entries = /* @__PURE__ */ new Map();
+  for (const kind of KINDS) {
+    if (!TARGET_KINDS.has(kind.key)) continue;
+    const declared = ir[kind.key];
+    if (!isRecord22(declared)) continue;
+    for (const id of Object.keys(declared)) {
+      entries.set(id, {
+        directory: kind.directory,
+        module: moduleName(id),
+        // What an include expands it into, where that is not its own read (`Kind['expanded']`)
+        name: kind.expanded === null ? className(id) : expandedClassName(id)
+      });
+    }
+  }
+  return entries;
+}
 async function generatePython(ir, options) {
   const files = [];
   const warnings = [];
-  const shapes = shapesIn(ir, warnings);
+  const catalog = { shapes: shapesIn(ir, warnings), entries: entriesIn(ir) };
   const fieldsetIndex = [];
   const fieldsetNames = [];
-  for (const shape of shapes.values()) {
+  for (const shape of catalog.shapes.values()) {
     const module = moduleName(shape.id);
-    const { content, exports } = writeFieldset(shape, shapes, options);
+    const { content, exports } = writeFieldset(shape, catalog, options);
     files.push({ path: `${FIELDSETS.directory}/${module}.py`, content });
     fieldsetIndex.push(`from .${module} import ${exports.join(", ")}`);
     fieldsetNames.push(...exports);
@@ -19372,7 +20636,7 @@ async function generatePython(ir, options) {
     const names = [];
     for (const element of elementsOf(ir, kind, warnings)) {
       const module = moduleName(element.id);
-      const { content, exports } = writeElement(element, kind, shapes, options);
+      const { content, exports } = writeElement(element, kind, catalog, options);
       files.push({ path: `${kind.directory}/${module}.py`, content });
       index.push(`from .${module} import ${exports.join(", ")}`);
       names.push(...exports);
@@ -19387,15 +20651,25 @@ async function generatePython(ir, options) {
       ].join("\n")
     });
   }
-  const directories = [...KINDS.map((kind) => kind.directory), FIELDSETS.directory].sort();
+  files.push(
+    { path: `${RICH_TEXT_MODULE}.py`, content: writeRichText(options) },
+    { path: `${READ_BLOCKS_MODULE}.py`, content: writeReadBlocks(options) }
+  );
+  const modules = [
+    ...KINDS.map((kind) => kind.directory),
+    FIELDSETS.directory,
+    RICH_TEXT_MODULE,
+    READ_BLOCKS_MODULE
+  ].sort();
   files.unshift({
     path: "__init__.py",
     content: [
       pyDocstring("The types of a RelyIO schema, written by `relyio generate-types`."),
       "",
-      `from . import ${directories.join(", ")}`,
+      `from . import ${modules.join(", ")}`,
+      ...options.baseModel === "pydantic" ? [RESOLVE_POSTPONED_ANNOTATIONS.trimEnd()] : [],
       "",
-      exportList(directories)
+      exportList(modules)
     ].join("\n")
   });
   if (options.includeApiTypes) {
@@ -19489,13 +20763,15 @@ def to_json(instance: Any, indent: Optional[int] = None) -> str:
 
 ${exportList(["validate_data", "to_dict", "to_json"])}`;
 }
-var PYTHON_KEYWORDS, SHADOWED_IN_CLASS_BODY, MODEL_MEMBERS, MODEL_NAMESPACE, IMPORTED_NAMES, escape, REFERENCE, isMulti, ROWS, METADATA, ASSET_FILE, KINDS, ModuleWriter, FIELDSETS, plugin2, index_default2;
+var define_RELYIO_READ_BLOCK_SCHEMAS_default, PYTHON_KEYWORDS, SHADOWED_IN_CLASS_BODY, MODEL_MEMBERS, MODEL_NAMESPACE, IMPORTED_NAMES, escape, always, sometimes, union, keyed, RICH_TEXT_NODES, isMulti, ROWS, READ_BLOCKS_MODULE, REF_PREFIX, ASSET_FILE, KINDS, TARGET_KINDS, RICH_TEXT_MODULE, FIELDSETS, ALIAS_SUFFIX, ModuleWriter, RESOLVE_POSTPONED_ANNOTATIONS, plugin2, index_default2;
 var init_dist5 = __esm({
   "../codegen-python/dist/index.js"() {
     init_dist3();
     init_dist2();
     init_dist3();
     init_dist2();
+    init_dist2();
+    define_RELYIO_READ_BLOCK_SCHEMAS_default = { EntryMetadata: { type: "object", description: "What this service reports about an entry beside its fields.", required: ["id", "type", "entryType", "slug", "status", "version", "locale", "localeHasDraft", "draftLocales", "hasDraft", "defaultLocale", "availableLocales", "createdAt", "updatedAt", "refs"], additionalProperties: false, properties: { id: { type: "string" }, type: { type: "string", description: "The content type." }, entryType: { type: "string", enum: ["asset", "content", "settings", "singleton"] }, slug: { type: ["string", "null"], description: "The slug field\u2019s value at `locale`, or null when the type declares none." }, status: { type: "string", enum: ["active", "archived", "proposed"], description: "Container lifecycle only. Publication is per locale: `localeStatus`." }, version: { type: "integer", description: "The reported locale\u2019s own version counter \u2014 not the entry\u2019s shared-field counter. `0` when that locale has no content of its own. With `id` and `locale`, it is what `X-Entity-Tag` is minted from." }, locale: { type: "string", description: "The locale the fields beside this object were composed for." }, versionCount: { type: "integer", description: "How many versions `locale` has. Sent on a single-entry read; a list leaves it out." }, versions: { type: "array", items: { type: "integer" }, description: "`locale`\u2019s version numbers, newest first, at most 25. Sent on a single-entry read; a list leaves it out." }, localeStatus: { type: "string", enum: ["archived", "draft", "published"], description: "Publication state of `locale`. Absent when that locale has no content of its own: what is visible in it is inherited through the fallback chain." }, localeHasDraft: { type: "boolean", description: "Whether `locale` has unpublished changes of its own." }, draftLocales: { type: "array", items: { type: "string" }, description: "Every locale holding unpublished content of its own, sorted. A shared-field draft is not listed: it is `hasDraft`." }, hasDraft: { type: "boolean", description: "Whether the shared (non-localized) fields have unpublished changes. Publishing any locale makes them live, so they are unpublished work in every locale." }, requestedLocale: { type: "string", description: "The locale the request named, when it named one other than the default. On `?locales=a,b,c` it is always sent: the primary, or `*` when the list names as many locales as the entry has \u2014 as on `?locale=*`." }, defaultLocale: { type: "string", description: "The schema\u2019s default locale." }, localeFallbacksApplied: { type: "object", additionalProperties: { type: "string" }, description: "Each field whose value came from another locale, mapped to that locale. Absent when none did." }, emptyRequiredFields: { type: "array", items: { type: "string" }, description: 'Each required field the entry holds no value for, which this read filled with its kind\u2019s empty value \u2014 `""` for text, the tree holding nothing (`{ _type: "richText", version: 1, children: [] }`) for rich text, `[]` for a list, `false` for a boolean \u2014 so a required field is always present. A draft may leave these empty; publishing refuses it. Each is a value path, a list item named by its key: `title`, `seo.title`, `faq[_key=="k1"].question` \u2014 the spelling a validation error\u2019s path uses, so a path still finds its item after a reorder. Absent when none was filled.' }, availableLocales: { type: "array", items: { $ref: "#/components/schemas/EntryLocale" }, description: "Every locale the entry has content in, the default first." }, localizations: { type: "object", additionalProperties: { type: "object", additionalProperties: true }, description: "The fields of every other locale asked for, keyed by locale \u2014 on `?locales=a,b` and `?locale=*`. A locale with no visible fields is left out." }, createdAt: { type: "string", format: "date-time", description: "When the entry was created." }, updatedAt: { type: "string", format: "date-time", description: "When the entry was last written." }, publishedAt: { type: "string", format: "date-time", description: "When the entry was last published. Absent until it is." }, firstPublishedAt: { type: "string", format: "date-time", description: "When the entry was first published. Absent until it is." }, refs: { type: "array", items: { $ref: "#/components/schemas/EntryRef" }, description: "The entry\u2019s outgoing references, across every locale, each once." } } }, SingletonMetadata: { type: "object", description: "What this service reports about a singleton beside its fields. Narrower than an entry\u2019s: no slug, no default locale, no available locales, no references.", required: ["id", "type", "status", "version", "locale", "localeHasDraft", "draftLocales", "hasDraft", "versionCount", "versions", "createdAt", "updatedAt"], additionalProperties: false, properties: { id: { type: "string" }, type: { type: "string", description: "The singleton type." }, status: { type: "string", enum: ["active", "archived", "proposed"], description: "Container lifecycle only. Publication is per locale: `localeStatus`." }, version: { type: "integer", description: "The reported locale\u2019s own version counter \u2014 not the entry\u2019s shared-field counter. `0` when that locale has no content of its own. With `id` and `locale`, it is what `X-Entity-Tag` is minted from." }, locale: { type: "string", description: "The locale the fields beside this object were composed for." }, versionCount: { type: "integer", description: "How many versions `locale` has." }, versions: { type: "array", items: { type: "integer" }, description: "`locale`\u2019s version numbers, newest first, at most 25." }, localeStatus: { type: "string", enum: ["archived", "draft", "published"], description: "Publication state of `locale`. Absent when that locale has no content of its own: what is visible in it is inherited through the fallback chain." }, localeHasDraft: { type: "boolean", description: "Whether `locale` has unpublished changes of its own." }, draftLocales: { type: "array", items: { type: "string" }, description: "Every locale holding unpublished content of its own, sorted. A shared-field draft is not listed: it is `hasDraft`." }, hasDraft: { type: "boolean", description: "Whether the shared (non-localized) fields have unpublished changes. Publishing any locale makes them live, so they are unpublished work in every locale." }, createdAt: { type: "string", format: "date-time", description: "When the singleton was created." }, updatedAt: { type: "string", format: "date-time", description: "When the singleton was last written." }, publishedAt: { type: "string", format: "date-time", description: "When the singleton was last published. Absent until it is." }, firstPublishedAt: { type: "string", format: "date-time", description: "When the singleton was first published. Absent until it is." }, emptyRequiredFields: { type: "array", items: { type: "string" }, description: "Each required field the singleton holds no value for, which this read filled with its kind\u2019s empty value, as a value path naming a list item by its key \u2014 as on an entry. Absent when none was." } } }, SettingsGroupMetadata: { type: "object", description: "What this service reports about a settings group beside its fields: the group, the per-locale facts and when it was last written.", required: ["id", "groupId", "version", "locale", "localeHasDraft", "draftLocales", "hasDraft", "versionCount", "versions", "updatedAt"], additionalProperties: false, properties: { id: { type: "string" }, groupId: { type: "string", description: "The settings group." }, version: { type: "integer", description: "The reported locale\u2019s own version counter \u2014 not the entry\u2019s shared-field counter. `0` when that locale has no content of its own. With `id` and `locale`, it is what `X-Entity-Tag` is minted from." }, locale: { type: "string", description: "The locale the fields beside this object were composed for." }, versionCount: { type: "integer", description: "How many versions `locale` has." }, versions: { type: "array", items: { type: "integer" }, description: "`locale`\u2019s version numbers, newest first, at most 25." }, localeStatus: { type: "string", enum: ["archived", "draft", "published"], description: "Publication state of `locale`. Absent when that locale has no content of its own: what is visible in it is inherited through the fallback chain." }, localeHasDraft: { type: "boolean", description: "Whether `locale` has unpublished changes of its own." }, draftLocales: { type: "array", items: { type: "string" }, description: "Every locale holding unpublished content of its own, sorted. A shared-field draft is not listed: it is `hasDraft`." }, hasDraft: { type: "boolean", description: "Whether the shared (non-localized) fields have unpublished changes. Publishing any locale makes them live, so they are unpublished work in every locale." }, updatedAt: { type: "string", format: "date-time", description: "When the group was last written." } } }, AssetFile: { type: "object", description: "An asset entry\u2019s `file`: the binary\u2019s lifecycle and what was read from it, at the locale the entry\u2019s fields were composed for. Sent beside the asset\u2019s fields on every read of it, with `urls` once `status` is `ready`. How storage addresses the bytes is not part of it.", required: ["status", "backend", "fileName", "visibility"], additionalProperties: false, properties: { status: { type: "string", enum: ["failed", "pending_upload", "processing", "ready", "uploading"], description: "Where the binary is: `pending_upload` before any bytes, `uploading` once presigned, `processing` once the pipeline has it, then `ready` or `failed`. Independent of the entry\u2019s publication." }, backend: { type: "string", enum: ["r2", "stream"], description: "`r2` for image and file kinds, `stream` for video." }, fileName: { type: "string" }, mimeType: { type: ["string", "null"] }, size: { type: ["integer", "null"], description: "In bytes." }, hash: { type: ["string", "null"], description: "The SHA-256 the client declared: advisory, for duplicate detection only." }, visibility: { type: "string", enum: ["private", "protected", "public"], description: "Enforced by the delivery gateway; a `protected` or `private` URL carries a token." }, extracted: { type: "object", description: "What was read from the file. Enrichment adds keys as its stages finish, so the object is open beyond the ones named here.", additionalProperties: true, properties: { width: { type: "number" }, height: { type: "number" }, format: { type: "string" }, duration: { type: "number" }, hasAlpha: { type: "boolean" }, isAnimated: { type: "boolean" }, orientation: { type: "number" }, placeholder: { type: "string" }, dominantColor: { type: "string" }, palette: { type: "array", items: { type: "string" } }, exif: { type: "object", additionalProperties: true }, video: { type: "object", additionalProperties: true, properties: { codec: { type: "string" }, bitrate: { type: "number" }, framerate: { type: "number" }, audioTracks: { type: "array", items: {} } } }, pageCount: { type: "number" }, text: { type: "string" }, safety: { type: "object", additionalProperties: true, properties: { nsfwScore: { type: "number" }, flagged: { type: "boolean" }, categories: { type: "array", items: { type: "string" } } } } } }, focalPoint: { type: "object", description: "The smart-crop anchor, each axis `0`\u2013`1`.", required: ["x", "y"], additionalProperties: false, properties: { x: { type: "number" }, y: { type: "number" } } }, enrichment: { type: "object", description: "Where metadata enrichment got to. Independent of `status`.", required: ["status"], additionalProperties: false, properties: { status: { type: "string", enum: ["complete", "failed", "partial", "pending", "running"] } } }, scan: { type: "object", description: "The malware scan of a file-kind binding.", required: ["status"], additionalProperties: false, properties: { status: { type: "string", enum: ["clean", "error", "infected", "pending", "skipped"] } } }, processing: { $ref: "#/components/schemas/AssetFileProcessing" }, playback: { type: "object", description: "Whether a video can be played yet.", additionalProperties: false, properties: { ready: { type: "boolean" } } } } }, AssetUrls: { type: "object", description: "An asset entry\u2019s `urls`, sent beside its `file` once `file.status` is `ready`: an image\u2019s `original` and `variants`, a file\u2019s `original`, a video\u2019s `playback`, `poster` and `download`. Every URL is on the delivery gateway; a protected or private asset\u2019s carries a short-lived token minted for this request.", additionalProperties: false, properties: { original: { type: "string", description: "An image or a file: its original bytes." }, variants: { type: "object", description: "An image: each delivery variant\u2019s id, mapped to its URL.", additionalProperties: { type: "string" } }, playback: { type: "string", description: "A video: its HLS/DASH manifest." }, poster: { type: "string", description: "A video: its poster image." }, download: { type: "string", description: "A video: its downloadable MP4, when enabled." } } }, EntryLocale: { type: "object", description: "One locale an entry has content in.", required: ["code", "status", "version"], additionalProperties: false, properties: { code: { type: "string" }, status: { type: "string", enum: ["archived", "draft", "published"] }, version: { type: "integer", description: "That locale\u2019s own version counter." }, publishedAt: { type: "string", format: "date-time", description: "When that locale was last published. Absent until it is." } } }, EntryRef: { type: "object", description: "One outgoing reference.", required: ["path", "entryUid"], additionalProperties: false, properties: { path: { type: "string", description: "The declaring field\u2019s path, spelt as the include path that expands it: `sections.customers` for a reference inside a page builder\u2019s blocks, `sections.media.image` for one inside an object inside a block \u2014 no shape, index or key. Two block types that declare one field id share a path; each row still names its target." }, entryUid: { type: "string", description: "The referenced entry\u2019s id." } } }, AssetFileProcessing: { type: "object", description: "Where the pipeline got to with a file, and why it failed. Present when the pipeline recorded a stage, a progress or an error.", additionalProperties: false, properties: { stage: { type: "string", description: "The stage the pipeline last recorded." }, progress: { type: "number", description: "How far the pipeline got, `0`\u2013`100`, where it reports that (video encoding)." }, error: { type: "object", description: "Why the file failed. Present exactly while `status` is `failed`.", additionalProperties: false, properties: { code: { type: "string", description: "The reason, e.g. `UNSUPPORTED_MIME`, `UPLOAD_TOO_LARGE` or `INTERNAL`." }, message: { type: "string" }, retriable: { type: "boolean", description: "`true` only for `INTERNAL`, a failure no property of the file caused." } } } } } };
     PYTHON_KEYWORDS = /* @__PURE__ */ new Set([
       "False",
       "None",
@@ -19559,22 +20835,205 @@ var init_dist5 = __esm({
       "BaseModel",
       "Field"
     ]);
-    escape = (name, reserved2) => {
+    escape = (name, reserved) => {
       let candidate = name;
-      while (reserved2(candidate)) candidate += "_";
+      while (reserved(candidate)) candidate += "_";
       return candidate;
     };
-    REFERENCE = "Union[str, Dict[str, Any]]";
+    always = (annotation) => ({ required: true, annotation });
+    sometimes = (annotation) => ({ required: false, annotation });
+    union = (members) => `Union[${members.join(", ")}]`;
+    keyed = { _key: always(() => "str") };
+    RICH_TEXT_NODES = {
+      richText: {
+        name: "RichText",
+        perField: true,
+        doc: "A rich-text value: the root of the tree, its blocks in `children`.",
+        attributes: {
+          _type: always(() => literal([RICH_TEXT_TYPE])),
+          version: always(() => literal([RICH_TEXT_VERSION])),
+          children: always((family) => `List[${blockOf(family)}]`)
+        }
+      },
+      paragraph: {
+        name: "RichTextParagraph",
+        perField: true,
+        doc: "A paragraph: inline content.",
+        attributes: {
+          _type: always(() => literal(["paragraph"])),
+          ...keyed,
+          children: always((family) => `List[${inlineOf(family)}]`)
+        }
+      },
+      heading: {
+        name: "RichTextHeading",
+        perField: true,
+        doc: "A heading of `level` 1 to 6: inline content.",
+        attributes: {
+          _type: always(() => literal(["heading"])),
+          ...keyed,
+          level: always(() => literal(RICH_TEXT_HEADING_LEVELS)),
+          children: always((family) => `List[${inlineOf(family)}]`)
+        }
+      },
+      quote: {
+        name: "RichTextQuote",
+        perField: true,
+        doc: "A quote: one block or more.",
+        attributes: {
+          _type: always(() => literal(["quote"])),
+          ...keyed,
+          children: always((family) => `List[${blockOf(family)}]`)
+        }
+      },
+      list: {
+        name: "RichTextList",
+        perField: true,
+        doc: "A list: one item or more. `start` is a numbered list's first number when it is not 1.",
+        attributes: {
+          _type: always(() => literal(["list"])),
+          ...keyed,
+          style: always(() => literal(RICH_TEXT_LIST_STYLES)),
+          start: sometimes(() => "int"),
+          children: always((family) => `List[${family.name("listItem")}]`)
+        }
+      },
+      listItem: {
+        name: "RichTextListItem",
+        perField: true,
+        doc: "A list's item: blocks, the first a paragraph. `checked` is a task list's item's.",
+        attributes: {
+          _type: always(() => literal(["listItem"])),
+          ...keyed,
+          checked: sometimes(() => "bool"),
+          children: always((family) => `List[${blockOf(family)}]`)
+        }
+      },
+      codeBlock: {
+        name: "RichTextCodeBlock",
+        perField: false,
+        doc: "A block of code: its text exactly, the language it is written in, and as a tab its label.",
+        attributes: {
+          _type: always(() => literal(["codeBlock"])),
+          ...keyed,
+          language: sometimes(() => "str"),
+          label: sometimes(() => "str"),
+          filename: sometimes(() => "str"),
+          lines: sometimes((family) => family.name("codeLines")),
+          text: always(() => "str")
+        }
+      },
+      codeLines: {
+        name: "RichTextCodeLines",
+        perField: false,
+        doc: "The lines of a file a code block is, 1-based and inclusive.",
+        attributes: {
+          start: always(() => "int"),
+          end: always(() => "int")
+        }
+      },
+      codeGroup: {
+        name: "RichTextCodeGroup",
+        perField: false,
+        doc: "Code with tabs: one code block or more, each a tab. A `code` field's value.",
+        attributes: {
+          _type: always(() => literal(["codeGroup"])),
+          ...keyed,
+          children: always((family) => `List[${family.name("codeBlock")}]`)
+        }
+      },
+      table: {
+        name: "RichTextTable",
+        perField: true,
+        doc: "A table: one row or more, the first the header where `headerRow` says so. A `table` field's value.",
+        attributes: {
+          _type: always(() => literal(["table"])),
+          ...keyed,
+          headerRow: sometimes(() => literal([true])),
+          children: always((family) => `List[${family.name("tableRow")}]`)
+        }
+      },
+      tableRow: {
+        name: "RichTextTableRow",
+        perField: true,
+        doc: "A table's row: one cell or more.",
+        attributes: {
+          _type: always(() => literal(["tableRow"])),
+          ...keyed,
+          children: always((family) => `List[${family.name("tableCell")}]`)
+        }
+      },
+      tableCell: {
+        name: "RichTextTableCell",
+        perField: true,
+        doc: "A table's cell: one paragraph or more, and its alignment when one is set.",
+        attributes: {
+          _type: always(() => literal(["tableCell"])),
+          ...keyed,
+          align: sometimes(() => literal(RICH_TEXT_CELL_ALIGNMENTS)),
+          children: always((family) => `List[${family.name("paragraph")}]`)
+        }
+      },
+      divider: {
+        name: "RichTextDivider",
+        perField: false,
+        doc: "A horizontal rule between blocks.",
+        attributes: { _type: always(() => literal(["divider"])), ...keyed }
+      },
+      text: {
+        name: "RichTextSpan",
+        perField: true,
+        doc: "A run of text, and the marks on all of it. A run has no key.",
+        attributes: {
+          _type: always(() => literal(["text"])),
+          text: always(() => "str"),
+          marks: sometimes((family) => `List[${markOf(family)}]`)
+        }
+      },
+      lineBreak: {
+        name: "RichTextLineBreak",
+        perField: false,
+        doc: "A line break inside a paragraph or a heading.",
+        attributes: { _type: always(() => literal(["lineBreak"])), ...keyed }
+      },
+      link: {
+        name: "RichTextLinkMark",
+        perField: false,
+        doc: "A link to a URL.",
+        attributes: {
+          _type: always(() => literal(["link"])),
+          href: always(() => "str")
+        }
+      },
+      mark: {
+        name: "RichTextFormatMark",
+        perField: false,
+        doc: "Formatting, by name.",
+        attributes: {
+          _type: always(() => literal(RICH_TEXT_MARK_TYPES.filter((type) => type !== "link")))
+        }
+      },
+      entryLink: {
+        name: "RichTextEntryLink",
+        perField: true,
+        doc: "A link to another entry: a reference, and a heading on it. Only in a field that declares `links`.",
+        attributes: {
+          _type: always(() => literal([RICH_TEXT_ENTRY_LINK_TYPE])),
+          to: always((family) => family.entryLinkTo),
+          anchor: sometimes(() => "str")
+        }
+      }
+    };
     isMulti = (field) => field.config?.multi === true;
     ROWS = {
       shortText: () => "str",
       longText: () => "str",
-      // The version-1 tree (ADR 0013, REL-1803): `{ _type, version, children }`, as the wire sends it
-      richText: () => "Dict[str, Any]",
-      // One of the tree's built-ins as a field's value (REL-1806): `{ _type, _key, children }`, a `Dict`
-      // as the tree is
-      table: () => "Dict[str, Any]",
-      code: () => "Dict[str, Any]",
+      // The version-1 tree (ADR 0013, REL-1803): `{ _type, version, children }`, as the wire sends it,
+      // typed node by node (REL-1812)
+      richText: (field, scope) => scope.richText(field),
+      // One of the tree's built-ins as a field's value (REL-1806): exactly that block's class
+      table: (_field, scope) => scope.builtIn("table"),
+      code: (_field, scope) => scope.builtIn("codeGroup"),
       email: () => "str",
       url: () => "str",
       slug: () => "str",
@@ -19589,7 +21048,10 @@ var init_dist5 = __esm({
       date: () => "str",
       dateTime: () => "str",
       // A single reference whose target was deleted under `onTargetDelete: 'nullify'` reads as null
-      reference: (field) => isMulti(field) ? `List[${REFERENCE}]` : `Optional[${REFERENCE}]`,
+      reference: (field, scope) => {
+        const one = referenceOf(field, field.config?.to, scope);
+        return isMulti(field) ? `List[${one}]` : `Optional[${one}]`;
+      },
       tags: () => "List[str]",
       // A list of a shape (`of`, REL-1796) is a list of its items, each its fieldset's class; a page
       // builder's (REL-1798) a list of a Union of each shape's class; one without is a list of strings,
@@ -19597,7 +21059,7 @@ var init_dist5 = __esm({
       list: (field, scope) => {
         const items = shapesOf(field).map((shape) => scope.shape(shape.id));
         if (items.length === 0) return "List[str]";
-        return items.length === 1 ? `List[${items[0]}]` : `List[${union(items)}]`;
+        return items.length === 1 ? `List[${items[0]}]` : `List[${union2(items)}]`;
       },
       // An object (REL-1799) is one value of its fieldset's class, or of several a Union, told apart by
       // `_type`. `of` is required, so one without is a schema deploy refused: refused here too, rather
@@ -19609,25 +21071,25 @@ var init_dist5 = __esm({
             `${field.id} is an object with no fieldset in its 'of', which deploy refuses and the Python target has no type for.`
           );
         }
-        return values.length === 1 ? values[0] ?? "" : union(values);
-      }
-    };
-    METADATA = {
-      name: "metadata",
-      key: "_metadata",
-      annotation: "Dict[str, Any]",
-      required: true
+        return values.length === 1 ? values[0] ?? "" : union2(values);
+      },
+      // Data nobody models (REL-1811): what its JSON Schema describes — an object with properties a
+      // class of its own (REL-2141) — and `Any`, any JSON value, without one
+      json: (field, scope) => scope.json(field)
     };
+    READ_BLOCKS_MODULE = "read_blocks";
+    REF_PREFIX = "#/components/schemas/";
     ASSET_FILE = [
-      { name: "file", key: "file", annotation: "Dict[str, Any]", required: false },
-      { name: "urls", key: "urls", annotation: "Dict[str, Any]", required: false }
+      { name: "file", key: "file", block: "AssetFile", required: false },
+      { name: "urls", key: "urls", block: "AssetUrls", required: false }
     ];
     KINDS = [
       {
         key: "contentTypes",
         directory: "content_types",
         label: "content type",
-        envelope: [METADATA],
+        envelope: [metadataOf("EntryMetadata")],
+        expanded: null,
         create: true,
         update: true
       },
@@ -19635,7 +21097,8 @@ var init_dist5 = __esm({
         key: "singletonContentTypes",
         directory: "singletons",
         label: "singleton",
-        envelope: [METADATA],
+        envelope: [metadataOf("SingletonMetadata")],
+        expanded: [metadataOf("EntryMetadata")],
         create: false,
         update: true
       },
@@ -19643,7 +21106,8 @@ var init_dist5 = __esm({
         key: "settingsGroups",
         directory: "settings_groups",
         label: "settings group",
-        envelope: [METADATA],
+        envelope: [metadataOf("SettingsGroupMetadata")],
+        expanded: null,
         create: false,
         update: true
       },
@@ -19651,27 +21115,78 @@ var init_dist5 = __esm({
         key: "assetTypes",
         directory: "asset_types",
         label: "asset type",
-        envelope: [METADATA, ...ASSET_FILE],
+        envelope: [metadataOf("EntryMetadata"), ...ASSET_FILE],
+        expanded: null,
         create: true,
         update: true
       }
     ];
+    TARGET_KINDS = /* @__PURE__ */ new Set([
+      "contentTypes",
+      "singletonContentTypes",
+      "assetTypes"
+    ]);
+    RICH_TEXT_MODULE = "rich_text";
+    FIELDSETS = { directory: "fieldsets", label: "fieldset" };
+    ALIAS_SUFFIX = new Map([
+      ...KINDS.map((kind) => [kind.directory, naming.pascal(kind.label)]),
+      [FIELDSETS.directory, naming.pascal(FIELDSETS.label)],
+      [RICH_TEXT_MODULE, "Node"],
+      [READ_BLOCKS_MODULE, "Block"]
+    ]);
     ModuleWriter = class {
-      constructor(fieldsetPackage, shapes, names) {
-        this.fieldsetPackage = fieldsetPackage;
-        this.shapes = shapes;
+      constructor(home, owner, catalog, names) {
+        this.home = home;
+        this.owner = owner;
+        this.catalog = catalog;
         this.taken = new Set(names);
       }
       imports = /* @__PURE__ */ new Set();
       declared = [];
+      families = [];
       taken;
       imported = /* @__PURE__ */ new Map();
+      /** Each rich-text field's family, by field id: the name of each of its nodes. */
+      reserved = /* @__PURE__ */ new Map();
+      /** Each json field's value, by field id: its annotation, its classes written with the families. */
+      json = /* @__PURE__ */ new Map();
+      written = /* @__PURE__ */ new Set();
+      /**
+       * Name the family of every rich-text field among `fields` that declares Blocks, Inline elements or
+       * entry links — `<Owner><Field>` and `<Owner><Field><Node>`, each unique among the module's classes
+       * in declared order — and write the classes of every json field's JSON Schema, its object
+       * `<Owner><Field>` (REL-2141). Before any attribute is typed, so before anything is imported. `path`
+       * is the element's or shape's, which a docstring names a field by.
+       */
+      reserveFamilies(fields, path25) {
+        for (const field of fields) {
+          if (parseFieldType(field.type).key === "json" && !this.json.has(field.id)) {
+            const written = jsonSchemaClasses(
+              field.config?.schema,
+              `${this.owner}${naming.pascal(field.id)}`,
+              `What the json field \`${path25}.${field.id}\` holds.`,
+              { taken: this.taken }
+            );
+            this.json.set(field.id, written.annotation);
+            this.families.push(...written.classes.map((spec) => classOf(spec)));
+            continue;
+          }
+          if (parseFieldType(field.type).key !== "richText" || !declaresAnything(field)) continue;
+          if (this.reserved.has(field.id)) continue;
+          const prefix = `${this.owner}${naming.pascal(field.id)}`;
+          const names = /* @__PURE__ */ new Map();
+          for (const node of familyNodes(linkTargetsOf(field).length > 0)) {
+            names.set(node, uniqueName(familyName(prefix, node), this.taken));
+          }
+          this.reserved.set(field.id, names);
+        }
+      }
       /**
        * Each field as an attribute: named once, so the read model and its write inputs agree, and typed
        * once. `reserved` are the names a read's envelope takes.
        */
-      attributes(fields, path25, reserved2) {
-        const taken = new Set(reserved2.map((attribute) => attribute.name));
+      attributes(fields, path25, reserved) {
+        const taken = new Set(reserved.map((attribute) => attribute.name));
         return fields.map((field) => {
           const name = attributeName(field.id, taken);
           return {
@@ -19685,8 +21200,20 @@ var init_dist5 = __esm({
       declare(spec) {
         this.declared.push(spec);
       }
+      /** What a read carries beside its fields, each a class of `read_blocks.py`, imported. */
+      envelope(attributes) {
+        return attributes.map(({ block, ...attribute }) => ({
+          ...attribute,
+          annotation: this.importClass({ directory: "", module: READ_BLOCKS_MODULE, name: block })
+        }));
+      }
       render(doc, baseModel) {
-        return renderModule(doc, [...this.imports].sort(), this.declared, baseModel);
+        return renderModule(
+          doc,
+          [...this.declared, ...this.families],
+          [...this.imports].sort(),
+          baseModel
+        );
       }
       /**
        * A field's annotation, by what the field-kind declaration's parser reads its `type` as. A type it
@@ -19700,29 +21227,118 @@ var init_dist5 = __esm({
             `${path25}.${field.id} has type '${field.type}', which the Python target has no type for. Field types: ${FIELD_KINDS.join(", ")}.`
           );
         }
-        return pythonTypeOf(field, declared.key, this.scope);
-      }
-      scope = {
-        shape: (shapeId) => {
-          const known = this.imported.get(shapeId);
-          if (known !== void 0) return known;
-          if (!this.shapes.has(shapeId)) {
-            throw new Error(
-              `fieldset '${shapeId}' is named as a shape, but no fieldset class declares it`
-            );
+        return pythonTypeOf(field, declared.key, this.scopeAt(path25));
+      }
+      /** Import `home`'s class into this module, once, and return the name the module knows it by. */
+      importClass(home) {
+        if (home.directory === this.home.directory && home.module === this.home.module) return home.name;
+        const identity = `${home.directory}/${home.module}.${home.name}`;
+        const known = this.imported.get(identity);
+        if (known !== void 0) return known;
+        const local = this.taken.has(home.name) ? uniqueName(
+          `${home.name}${ALIAS_SUFFIX.get(home.directory === "" ? home.module : home.directory) ?? "Class"}`,
+          this.taken
+        ) : home.name;
+        this.taken.add(local);
+        const from = home.directory === this.home.directory ? `.${home.module}` : home.directory === "" ? `..${home.module}` : `..${home.directory}.${home.module}`;
+        this.imports.add(`from ${from} import ${home.name}${local === home.name ? "" : ` as ${local}`}`);
+        this.imported.set(identity, local);
+        return local;
+      }
+      scopeAt(path25) {
+        return {
+          shape: (shapeId) => {
+            if (!this.catalog.shapes.has(shapeId)) {
+              throw new Error(
+                `fieldset '${shapeId}' is named as a shape, but no fieldset class declares it`
+              );
+            }
+            return this.importClass({
+              directory: FIELDSETS.directory,
+              module: moduleName(shapeId),
+              name: className(shapeId)
+            });
+          },
+          entry: (typeId, field) => {
+            const home = this.catalog.entries.get(typeId);
+            if (home === void 0) {
+              throw new Error(
+                `${path25}.${field.id} references '${typeId}', which the schema declares no content type, singleton or asset type for.`
+              );
+            }
+            return this.importClass(home);
+          },
+          richText: (field) => this.richTextOf(field, path25),
+          builtIn: (node) => this.builtIn(node),
+          json: (field) => {
+            const annotation = this.json.get(field.id);
+            if (annotation === void 0) {
+              throw new Error(`${path25}.${field.id} is a json field whose classes were never written`);
+            }
+            return annotation;
           }
-          const name = className(shapeId);
-          const local = this.taken.has(name) ? uniqueName(`${name}Fieldset`, this.taken) : name;
-          this.taken.add(local);
-          this.imports.add(
-            `from ${this.fieldsetPackage}${moduleName(shapeId)} import ${name}${local === name ? "" : ` as ${local}`}`
-          );
-          this.imported.set(shapeId, local);
-          return local;
+        };
+      }
+      builtIn(node) {
+        return this.importClass({
+          directory: "",
+          module: RICH_TEXT_MODULE,
+          name: RICH_TEXT_NODES[node].name
+        });
+      }
+      /**
+       * A rich-text field's class: the built-in root for a field that declares nothing, and otherwise
+       * its family's root, whose classes this writes the first time the field is typed — its read model
+       * and its write inputs share them.
+       */
+      richTextOf(field, path25) {
+        const names = this.reserved.get(field.id);
+        if (names === void 0) return this.builtIn("richText");
+        const root = names.get("richText");
+        if (this.written.has(field.id)) return root;
+        this.written.add(field.id);
+        const scope = this.scopeAt(path25);
+        const { blocks, inline } = richTextShapesOf(field);
+        const targets = linkTargetsOf(field);
+        const family = {
+          name: (node) => names.get(node) ?? this.builtIn(node),
+          blocks: blocks.map((shape) => scope.shape(shape.id)),
+          inline: inline.map((shape) => scope.shape(shape.id)),
+          links: targets.length > 0,
+          entryLinkTo: targets.length > 0 ? referenceOf(field, targets, scope) : ""
+        };
+        for (const [node, name] of names) {
+          const taken = /* @__PURE__ */ new Set();
+          this.families.push({
+            name,
+            doc: `${RICH_TEXT_NODES[node].doc} Of the rich-text field \`${path25}.${field.id}\`.`,
+            attributes: nodeAttributes(node, family).map((attribute) => ({
+              name: attributeName(attribute.key, taken),
+              ...attribute
+            }))
+          });
         }
-      };
+        return root;
+      }
     };
-    FIELDSETS = { directory: "fieldsets", label: "fieldset" };
+    RESOLVE_POSTPONED_ANNOTATIONS = `
+
+def _resolve_postponed_annotations() -> None:
+    """Resolve every model's annotations, now that every module of the package is imported."""
+    import sys
+
+    for name, module in list(sys.modules.items()):
+        if module is None or not (name == __name__ or name.startswith(__name__ + ".")):
+            continue
+        for value in list(vars(module).values()):
+            if isinstance(value, type) and value.__module__ == name:
+                rebuild = getattr(value, "model_rebuild", None) or getattr(value, "update_forward_refs", None)
+                if callable(rebuild):
+                    rebuild()
+
+
+_resolve_postponed_annotations()
+`;
     plugin2 = {
       language: "python",
       async generate(ir, options) {
@@ -19978,20 +21594,6 @@ var init_schema_validation = __esm({
   }
 });
 
-// ../../platform/api-contract/dist/chunk-EHKJTVAS.js
-var HEADER_ROUTING_PROJECT;
-var init_chunk_EHKJTVAS = __esm({
-  "../../platform/api-contract/dist/chunk-EHKJTVAS.js"() {
-    HEADER_ROUTING_PROJECT = {
-      name: "X-RelyIO-Project",
-      in: "request",
-      // Required on every route that declares it: a route declares it exactly when its path names no
-      // project and its subject is one.
-      required: true
-    };
-  }
-});
-
 // ../../platform/api-contract/dist/chunk-46347LG2.js
 function defineRoute(route) {
   if (route.kind === "raw" && route.standardShape === void 0) {
@@ -20050,15 +21652,38 @@ var init_chunk_OWKTFXBY = __esm({
   }
 });
 
-// ../../platform/api-contract/dist/chunk-GWMWA3NP.js
-var init_chunk_GWMWA3NP = __esm({
-  "../../platform/api-contract/dist/chunk-GWMWA3NP.js"() {
+// ../../platform/api-contract/dist/chunk-2LUGULHW.js
+var init_chunk_2LUGULHW = __esm({
+  "../../platform/api-contract/dist/chunk-2LUGULHW.js"() {
     init_chunk_OWKTFXBY();
-    init_chunk_PPSLKRFU();
+    init_chunk_WE6ZXIJM();
     init_chunk_46347LG2();
   }
 });
 
+// ../../platform/api-contract/dist/chunk-FC62S3SW.js
+var HEADER_ROUTING_PROJECT, HEADER_ROUTING_ORGANIZATION;
+var init_chunk_FC62S3SW = __esm({
+  "../../platform/api-contract/dist/chunk-FC62S3SW.js"() {
+    HEADER_ROUTING_PROJECT = {
+      name: "X-RelyIO-Project",
+      in: "request",
+      // Required on every route that declares it: a route declares it exactly when its path names no
+      // project and its subject is one.
+      required: true
+    };
+    HEADER_ROUTING_ORGANIZATION = {
+      name: "X-RelyIO-Organization",
+      in: "request",
+      required: false
+    };
+    [
+      { ...HEADER_ROUTING_PROJECT, required: false },
+      HEADER_ROUTING_ORGANIZATION
+    ];
+  }
+});
+
 // ../../platform/api-contract/dist/chunk-W2KXTDDN.js
 var init_chunk_W2KXTDDN = __esm({
   "../../platform/api-contract/dist/chunk-W2KXTDDN.js"() {
@@ -20069,11 +21694,11 @@ var init_chunk_W2KXTDDN = __esm({
 var HEADER_RETRY_AFTER, MODEL_SETTING_RATES;
 var init_dist6 = __esm({
   "../../platform/api-contract/dist/index.js"() {
-    init_chunk_EHKJTVAS();
-    init_chunk_GWMWA3NP();
+    init_chunk_2LUGULHW();
+    init_chunk_FC62S3SW();
     init_chunk_OWKTFXBY();
     init_chunk_W2KXTDDN();
-    init_chunk_PPSLKRFU();
+    init_chunk_WE6ZXIJM();
     init_chunk_46347LG2();
     HEADER_RETRY_AFTER = { name: "Retry-After" };
     defineRoute({
@@ -20594,8 +22219,8 @@ function similarity(a, b) {
   if (ta.size === 0 && tb.size === 0) return 0;
   let shared = 0;
   for (const t of ta) if (tb.has(t)) shared++;
-  const union2 = (/* @__PURE__ */ new Set([...ta, ...tb])).size;
-  return union2 === 0 ? 0 : shared / union2;
+  const union3 = (/* @__PURE__ */ new Set([...ta, ...tb])).size;
+  return union3 === 0 ? 0 : shared / union3;
 }
 function countAddRemove(lines) {
   let added = 0;
@@ -20997,7 +22622,7 @@ var init_agent_loop = __esm({
         yield { type: "error", error: `Reached maximum turn limit (${MAX_TURNS})` };
       }
       /**
-       * Persist the assistant turn into message history in AI SDK v6 ModelMessage shape.
+       * Persist the assistant turn into message history in the AI SDK ModelMessage shape.
        *
        * Structure preserved:
        * - assistant: [text?, ...all tool-call parts in original order]
@@ -23672,7 +25297,7 @@ var init_banner = __esm({
     init_dev_cockpit_context();
     init_dev_cockpit_format();
     init_startup_info();
-    CLI_VERSION2 = "0.8.0" ;
+    CLI_VERSION2 = "0.9.0" ;
     BRAND_GLYPH = "\u25B6";
     BRAND_NAME = "RelyIO";
     LABEL_WIDTH = 9;
@@ -23863,22 +25488,22 @@ var init_markdown = __esm({
     init_syntax_highlight();
   }
 });
-function clusterHeading(toolName, count) {
+function clusterHeading(toolName, count2) {
   switch (toolName) {
     case "readFile": {
-      return count === 1 ? "Read file" : `Read ${count} files`;
+      return count2 === 1 ? "Read file" : `Read ${count2} files`;
     }
     case "writeFile": {
-      return count === 1 ? "Write file" : `Write ${count} files`;
+      return count2 === 1 ? "Write file" : `Write ${count2} files`;
     }
     case "applyPatch": {
-      return count === 1 ? "Patch file" : `Patch ${count} files`;
+      return count2 === 1 ? "Patch file" : `Patch ${count2} files`;
     }
     case "listFiles": {
-      return count === 1 ? "List directory" : `List ${count} directories`;
+      return count2 === 1 ? "List directory" : `List ${count2} directories`;
     }
     case "runValidation": {
-      return count === 1 ? "Validate schema" : `Validate ${count} times`;
+      return count2 === 1 ? "Validate schema" : `Validate ${count2} times`;
     }
     case "getSchemaReference": {
       return "Schema reference";
@@ -23887,37 +25512,37 @@ function clusterHeading(toolName, count) {
       return "Search docs";
     }
     case "explainContentType": {
-      return count === 1 ? "Explain content type" : `Explain ${count} content types`;
+      return count2 === 1 ? "Explain content type" : `Explain ${count2} content types`;
     }
     case "explainFieldset": {
-      return count === 1 ? "Explain fieldset" : `Explain ${count} fieldsets`;
+      return count2 === 1 ? "Explain fieldset" : `Explain ${count2} fieldsets`;
     }
     case "searchEntries": {
-      return count === 1 ? "Search entries" : `Search entries \xD7 ${count}`;
+      return count2 === 1 ? "Search entries" : `Search entries \xD7 ${count2}`;
     }
     case "listDatasets": {
       return "List datasets";
     }
     case "getDataset": {
-      return count === 1 ? "Get dataset" : `Get ${count} datasets`;
+      return count2 === 1 ? "Get dataset" : `Get ${count2} datasets`;
     }
     case "getSchema": {
-      return count === 1 ? "Get schema" : `Get schema \xD7 ${count}`;
+      return count2 === 1 ? "Get schema" : `Get schema \xD7 ${count2}`;
     }
     case "proposeCreateEntries": {
-      return count === 1 ? "Propose new entries" : `Propose new entries \xD7 ${count}`;
+      return count2 === 1 ? "Propose new entries" : `Propose new entries \xD7 ${count2}`;
     }
     case "proposeEntryUpdate": {
-      return count === 1 ? "Propose entry update" : `Propose ${count} entry updates`;
+      return count2 === 1 ? "Propose entry update" : `Propose ${count2} entry updates`;
     }
     case "proposeDeleteEntry": {
-      return count === 1 ? "Propose entry delete" : `Propose ${count} entry deletes`;
+      return count2 === 1 ? "Propose entry delete" : `Propose ${count2} entry deletes`;
     }
     case "proposePublishEntry": {
-      return count === 1 ? "Propose publish" : `Propose ${count} publishes`;
+      return count2 === 1 ? "Propose publish" : `Propose ${count2} publishes`;
     }
     case "proposeUnpublishEntry": {
-      return count === 1 ? "Propose unpublish" : `Propose ${count} unpublishes`;
+      return count2 === 1 ? "Propose unpublish" : `Propose ${count2} unpublishes`;
     }
     case "suggestAgent": {
       return "Suggest agent";
@@ -24371,10 +25996,10 @@ function StatusBar() {
     /* @__PURE__ */ jsx(Text, { dimColor: true, children: sessionName || "new session" })
   ] });
 }
-function formatTokens(count) {
-  if (count >= 1e6) return `${(count / 1e6).toFixed(1)}M`;
-  if (count >= 1e3) return `${(count / 1e3).toFixed(1)}k`;
-  return String(count);
+function formatTokens(count2) {
+  if (count2 >= 1e6) return `${(count2 / 1e6).toFixed(1)}M`;
+  if (count2 >= 1e3) return `${(count2 / 1e3).toFixed(1)}k`;
+  return String(count2);
 }
 function formatModelLabel(preferredModelId, resolvedModelId) {
   const preferredShort = shortModelName(preferredModelId);
@@ -26224,8 +27849,8 @@ function BranchPicker() {
     }
     return fetch2.branches.map((b) => {
       const isCurrent = b.id === branchId;
-      const count = typeof b.datasetCount === "number" ? b.datasetCount : b.datasetAssignments?.length ?? 0;
-      const datasetSummary = count === 0 ? "no datasets" : `${count} dataset${count === 1 ? "" : "s"}`;
+      const count2 = typeof b.datasetCount === "number" ? b.datasetCount : b.datasetAssignments?.length ?? 0;
+      const datasetSummary = count2 === 0 ? "no datasets" : `${count2} dataset${count2 === 1 ? "" : "s"}`;
       const protectedMark = b.protected ? " \xB7 protected" : "";
       return {
         id: b.id,
@@ -27522,8 +29147,8 @@ var init_session_manager = __esm({
           return [];
         }
       }
-      listRecent(count = 10) {
-        return this.listAll().slice(0, count);
+      listRecent(count2 = 10) {
+        return this.listAll().slice(0, count2);
       }
       delete(sessionId) {
         const filePath = path5.join(this.sessionsDir, `${sessionId}.json`);
@@ -30445,8 +32070,8 @@ function upsertEnv(content, values) {
   return { content: `${lines.join(eol)}${eol}`, written, kept };
 }
 function renderNextTemplate(source, dataset) {
-  const literal = dataset.replaceAll("\\", "\\\\").replaceAll("'", String.raw`\'`);
-  return source.replaceAll(DATASET_PLACEHOLDER, literal);
+  const literal2 = dataset.replaceAll("\\", "\\\\").replaceAll("'", String.raw`\'`);
+  return source.replaceAll(DATASET_PLACEHOLDER, literal2);
 }
 function nextTemplateFiles(templatesDir = getTemplatesDir()) {
   const root = path5.join(templatesDir, FRAMEWORK_DIR);
@@ -31008,7 +32633,7 @@ function loginCommand(program2) {
   );
   cmd.option(
     "--token <apiKey>",
-    "API key for organization authentication (format: rly_org_v1_xxxxx)"
+    "API key for organization authentication (format: rly_org_{region}_v2_xxxxx)"
   );
 }
 
@@ -31958,8 +33583,8 @@ function createDiffJsonOutput(params) {
     },
     diff: projectChangeBuckets(changes, (bucket, key) => ({
       added: bucket.added.map((name) => {
-        const count = fieldCount(key, name);
-        return { name, ...count !== void 0 && { fieldCount: count } };
+        const count2 = fieldCount(key, name);
+        return { name, ...count2 !== void 0 && { fieldCount: count2 } };
       }),
       modified: bucket.modified.map((item) => describeModified(item)),
       deleted: bucket.deleted,
@@ -31970,8 +33595,8 @@ function createDiffJsonOutput(params) {
     plan
   };
 }
-function countOf(count, noun) {
-  return `${count} ${noun}${count === 1 ? "" : "s"}`;
+function countOf(count2, noun) {
+  return `${count2} ${noun}${count2 === 1 ? "" : "s"}`;
 }
 function createValidateJsonOutput(params) {
   const { check, durationMs } = params;
@@ -32200,10 +33825,30 @@ function planNotAcceptedMessage(blockage, command) {
   const accept = acceptPlanFlag(blockage.plan);
   return blockage.kind === "schema-plan-stale" ? `The plan ${blockage.confirmedPlanId} is not this ${command.verb}'s plan any more: the branch's active schema moved, or the schema differs. Nothing was ${command.done}. Read the plan now in effect; to apply it, ${command.verb} again with ${accept}.` : `This ${command.verb} changes stored content, and ${command.unattended}. Nothing was ${command.done}. Read the plan; to apply it, ${command.verb} again with ${accept}.`;
 }
+var REQUIRED_VALUE = {
+  leaves: "would leave required values missing",
+  clear: "declare a default, or keep the option"
+};
+var REFUSAL_KINDS = {
+  REQUIRED_VALUE_MISSING: REQUIRED_VALUE,
+  REQUIRED_OPTION_IN_USE: REQUIRED_VALUE,
+  LIST_BELOW_MIN_ITEMS: {
+    leaves: "would leave lists with fewer items than their minimum",
+    clear: "give those entries other items, or lower minItems"
+  }
+};
 function planRefusedMessage(plan, command) {
-  const count = plan.refusals.length;
   const verb = `${command.verb.charAt(0).toUpperCase()}${command.verb.slice(1)}`;
-  return `${verb} refused: ${count} change${count === 1 ? "" : "s"} would leave required values missing. Declare a default, or keep the option.`;
+  const counts = /* @__PURE__ */ new Map();
+  for (const kind of new Set(Object.values(REFUSAL_KINDS))) {
+    const count2 = plan.refusals.filter((refusal) => REFUSAL_KINDS[refusal.code] === kind).length;
+    if (count2 > 0) counts.set(kind, count2);
+  }
+  const said = [...counts].map(
+    ([kind, count2], index) => index === 0 ? `${count2} change${count2 === 1 ? "" : "s"} ${kind.leaves}` : `${count2} ${kind.leaves}`
+  );
+  const advice = [...counts.keys()].map((kind) => kind.clear).join("; ");
+  return `${verb} refused: ${said.join(", and ")}. ${advice.charAt(0).toUpperCase()}${advice.slice(1)}.`;
 }
 
 // src/commands/promote.ts
@@ -33604,7 +35249,7 @@ function sandboxCommands(program2) {
 }
 
 // src/commands/version.ts
-var CLI_VERSION = "0.8.0" ;
+var CLI_VERSION = "0.9.0" ;
 async function handleVersion(_options) {
   console.log(heading("RelyIO CLI Version Information"));
   const versionInfo = [
@@ -33781,8 +35426,8 @@ function formatDuration2(ms) {
 }
 
 // src/commands/status.ts
-function plural2(count, noun) {
-  return `${count} ${noun}${count === 1 ? "" : "s"}`;
+function plural2(count2, noun) {
+  return `${count2} ${noun}${count2 === 1 ? "" : "s"}`;
 }
 function statusFailure(context) {
   if (context.checkError) {
@@ -33830,8 +35475,8 @@ function formatSchemaSource2(result) {
     return `TypeScript (${relativePath})`;
   }
   const files = result.sourcePath;
-  const count = files.length;
-  return `YAML (${count} file${count === 1 ? "" : "s"})`;
+  const count2 = files.length;
+  return `YAML (${count2} file${count2 === 1 ? "" : "s"})`;
 }
 async function performStatusCheck(branchName, options) {
   const { json = false, verbose = false, watch: watchMode = false } = options;
@@ -34126,10 +35771,10 @@ function displayCompactStatus(context, failure) {
         `"${parentName}" has changed but all changes are additive \u2014 safe to merge.`
       );
     } else if (context.divergence.compatibility?.breakingChanges?.length) {
-      const count = context.divergence.compatibility.breakingChanges.length;
+      const count2 = context.divergence.compatibility.breakingChanges.length;
       statusLine(
         "warning",
-        `"${parentName}" has breaking changes (${count} issue${count === 1 ? "" : "s"}). Review with 'relyio diff --against ${parentName}'.`
+        `"${parentName}" has breaking changes (${count2} issue${count2 === 1 ? "" : "s"}). Review with 'relyio diff --against ${parentName}'.`
       );
     } else {
       statusLine(
@@ -34596,8 +36241,8 @@ function formatSchemaSource3(result) {
     return `TypeScript (${relativePath})`;
   }
   const files = result.sourcePath;
-  const count = files.length;
-  return `YAML (${count} file${count === 1 ? "" : "s"})`;
+  const count2 = files.length;
+  return `YAML (${count2} file${count2 === 1 ? "" : "s"})`;
 }
 function handleGenerationError(error2) {
   if (error2 instanceof Error) {
@@ -36070,7 +37715,7 @@ function handleAliasSet(name, command) {
     console.error(THEME7.error("Invalid alias name. Use letters, numbers, and hyphens only."));
     process.exit(1);
   }
-  const reserved2 = [
+  const reserved = [
     "init",
     "login",
     "logout",
@@ -36091,7 +37736,7 @@ function handleAliasSet(name, command) {
     "config",
     "help"
   ];
-  if (reserved2.includes(name.toLowerCase())) {
+  if (reserved.includes(name.toLowerCase())) {
     console.error(THEME7.error(`Cannot override built-in command: ${name}`));
     process.exit(1);
   }
@@ -37907,7 +39552,7 @@ Examples:
 }
 
 // src/index.ts
-var CLI_VERSION3 = "0.8.0" ;
+var CLI_VERSION3 = "0.9.0" ;
 var program = new Command();
 program.name("relyio").description("RelyIO CLI - Content Management, Simplified").version(CLI_VERSION3);
 registerGlobalOptions(program);