canopycms 0.3.3 → 0.5.0

package/dist/api/reference-options.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { ContentStore } from '../content-store.js';
 import { defineEndpoint } from './route-builder.js';
 import { ReferenceResolver } from '../reference-resolver.js';
+import { referenceSortFieldSchema } from '../config/schemas/field.js';
 import { parseLogicalPath } from '../paths/index.js';
 import { branchNameSchema } from './validators.js';
 const getReferenceOptionsParamsSchema = z.object({
@@ -16,9 +17,18 @@ const getReferenceOptionsHandler = async (gc, ctx, req, _params) => {
         entryTypes: z.string().optional(),
         displayField: z.string().optional(),
         search: z.string().optional(),
+        sort: z.enum(['label', 'collection', 'field']).optional(),
+        sortField: referenceSortFieldSchema.optional(),
+        sortDir: z.enum(['asc', 'desc']).optional(),
     })
         .refine((data) => data.collections || data.entryTypes, {
         message: 'At least one of "collections" or "entryTypes" query parameters is required',
+    })
+        .refine((data) => (data.sort === 'field') === (data.sortField !== undefined), {
+        message: '"sortField" is required with sort=field, and only allowed with it',
+    })
+        .refine((data) => data.sortDir === undefined || data.sort === 'field', {
+        message: '"sortDir" is only allowed with sort=field',
     });
     const queryResult = querySchema.safeParse(req.query ?? {});
     if (!queryResult.success) {
@@ -32,6 +42,13 @@ const getReferenceOptionsHandler = async (gc, ctx, req, _params) => {
     const entryTypesParam = queryResult.data.entryTypes;
     const displayField = queryResult.data.displayField || 'title';
     const search = queryResult.data.search;
+    // The refinements above pair sortField with sort=field, so sortField alone decides.
+    const { sort: sortParam, sortField, sortDir } = queryResult.data;
+    const sort = sortField !== undefined
+        ? { field: sortField, direction: sortDir }
+        : sortParam === 'field'
+            ? undefined
+            : sortParam;
     const flatSchema = branchContext.flatSchema;
     const store = new ContentStore(branchContext.branchRoot, flatSchema, {
         contentRootName: ctx.services.config.contentRoot || 'content',
@@ -70,7 +87,7 @@ const getReferenceOptionsHandler = async (gc, ctx, req, _params) => {
     // for an option the caller isn't allowed to see.
     const checkAccess = await ctx.services.createContentAccessChecker(branchContext, branchContext.branchRoot, req.user);
     const resolver = new ReferenceResolver(store, idIndex);
-    const options = await resolver.loadReferenceOptions(collections, displayField, search, entryTypes, (logicalPath) => checkAccess(logicalPath, 'read').allowed);
+    const options = await resolver.loadReferenceOptions(collections, displayField, search, entryTypes, (logicalPath) => checkAccess(logicalPath, 'read').allowed, { seo: ctx.services.config.seo, sort });
     return {
         ok: true,
         status: 200,
@@ -81,7 +98,9 @@ const getReferenceOptionsHandler = async (gc, ctx, req, _params) => {
  * Get reference options for a field
  * GET /:branch/reference-options
  * Query params: collections (comma-separated, optional), entryTypes (comma-separated, optional),
- *   displayField, search. At least one of collections or entryTypes is required.
+ *   displayField, search. At least one of collections or entryTypes is required. `sort` is
+ *   label (default), collection or field; field takes `sortField` (a dotted path) and `sortDir`
+ *   (asc, the default, or desc). See `ReferenceOptionSort`.
  */
 const getReferenceOptions = defineEndpoint({
     namespace: 'content',

package/dist/api/schema.d.ts

@@ -363,14 +363,14 @@ export declare const updateEntryType: import("./route-builder.js").RouteDefiniti
     default?: boolean | undefined;
     format?: "mdx" | "md" | "json" | "yaml" | undefined;
     label?: string | undefined;
-    schema?: string | undefined;
     maxItems?: number | undefined;
+    schema?: string | undefined;
 }, {
     default?: boolean | undefined;
     format?: "mdx" | "md" | "json" | "yaml" | undefined;
     label?: string | undefined;
-    schema?: string | undefined;
     maxItems?: number | undefined;
+    schema?: string | undefined;
 }>, UpdateEntryTypeApiResponse>;
 /**
  * DELETE /:branch/schema/entry-types/:entryTypeName/...collectionPath - Remove entry type
@@ -640,14 +640,14 @@ export declare const SCHEMA_ROUTES: {
         default?: boolean | undefined;
         format?: "mdx" | "md" | "json" | "yaml" | undefined;
         label?: string | undefined;
-        schema?: string | undefined;
         maxItems?: number | undefined;
+        schema?: string | undefined;
     }, {
         default?: boolean | undefined;
         format?: "mdx" | "md" | "json" | "yaml" | undefined;
         label?: string | undefined;
-        schema?: string | undefined;
         maxItems?: number | undefined;
+        schema?: string | undefined;
     }>, UpdateEntryTypeApiResponse>;
     readonly removeEntryType: import("./route-builder.js").RouteDefinition<z.ZodObject<{
         branch: z.ZodType<import("../paths/index.js").BranchName, z.ZodTypeDef, import("../paths/index.js").BranchName>;

package/dist/build/generate-ai-content.js

@@ -200,6 +200,7 @@ export async function generateAIContentFiles(options) {
         contentRoot: contentRootName,
         config: aiConfig,
         entryLinkUrl: config.entryLinkUrl,
+        seo: config.seo,
         ...resolveBuildStamp(),
     });
     const absoluteOutputDir = path.resolve(outputDir) + path.sep;

package/dist/cli/cli.js

@@ -1223,7 +1223,7 @@ CanopyCMS worker run-once (mode: ${mode}, auth: ${authMode})
   }
   console.log("\nDone");
 }
-var __defProp2, __getOwnPropNames2, __esm2, __export2, active, init_logger, scalarFieldTypes, markdownFieldTypes, primitiveFieldTypes, fieldTypes, init_types, SAFE_HTML_TAGS, COMPONENT_NAME, MDX_BINDINGS, FORBIDDEN_ATTRIBUTES, init_mdx_allowlist, fieldBaseSchema, selectOptionSchema, referenceOptionSchema, primitiveFieldSchema, mdxPropAllowSchema, mdxAllowlistSchema, markdownFieldSchema, ASPECT_RATIO_RE, imageFieldSchema, selectFieldSchema, referenceFieldSchema, fieldHolder, blockSchema, blockFieldSchema, objectFieldSchema, inlineGroupFieldSchema, customFieldSchema, knownFieldSchema, fieldSchema, init_field, relativePathSchema, entryTypeSchema, collectionSchema, init_collection, SENTINEL_BASE, DOT_SEGMENT, init_sanitize_href, uploadTargetUrlSchema, previewPrefixSchema, init_url, mediaSchema, init_media, defaultBranchAccessSchema, defaultPathAccessLevelSchema, defaultPathAccessLevelsSchema, defaultPathAccessSchema, defaultBaseBranchSchema, defaultRemoteNameSchema, defaultRemoteUrlSchema, gitBotAuthorNameSchema, gitBotAuthorEmailSchema, githubTokenEnvVarSchema, operatingModeSchema, deployedAsSchema, contentRootSchema, sourceRootSchema, basePathSchema, deploymentNameSchema, devContentSyncSchema, devConfigSchema, editorConfigSchema, CanopyConfigSchema, DEFAULT_PROD_WORKSPACE, init_config, init_config2, init_error2, init_fs2, templates_exports, __dirname, TEMPLATES_DIR, SCAFFOLD_STACK_NAME, init_templates, project_detect_exports, COMMANDS, MAX_WORKSPACE_DEPTH, PLACEHOLDER_GITHUB_REPO, CDK_DEPENDENCIES, init_project_detect, task_queue_config_exports, init_task_queue_config, envFlag, LOG_LEVELS, DebugLogger, testLogger, init_debug, init_atomic_write, DEFAULT_MAX_RETRIES, nullLogger, init_task_queue, cms_task_queue_exports, debugLogger, cmsTaskQueueLogger, init_cms_task_queue, ProdClientSafeStrategy, DevClientSafeStrategy, warned, VALID_DEPLOYMENT_NAME, isValidDeploymentName, ProdStrategy, DevStrategy, strategyCache;
+var __defProp2, __getOwnPropNames2, __esm2, __export2, active, init_logger, scalarFieldTypes, markdownFieldTypes, primitiveFieldTypes, fieldTypes, init_types, SAFE_HTML_TAGS, COMPONENT_NAME, MDX_BINDINGS, FORBIDDEN_ATTRIBUTES, init_mdx_allowlist, fieldBaseSchema, selectOptionSchema, referenceOptionSchema, primitiveFieldSchema, mdxPropAllowSchema, mdxAllowlistSchema, markdownFieldSchema, ASPECT_RATIO_RE, imageFieldSchema, selectFieldSchema, referenceSortFieldSchema, referenceFieldSchema, fieldHolder, blockSchema, blockFieldSchema, objectFieldSchema, inlineGroupFieldSchema, customFieldSchema, knownFieldSchema, fieldSchema, init_field, relativePathSchema, entryTypeSchema, collectionSchema, init_collection, SENTINEL_BASE, DOT_SEGMENT, init_sanitize_href, uploadTargetUrlSchema, previewPrefixSchema, init_url, mediaSchema, init_media, defaultBranchAccessSchema, defaultPathAccessLevelSchema, defaultPathAccessLevelsSchema, defaultPathAccessSchema, defaultBaseBranchSchema, defaultRemoteNameSchema, defaultRemoteUrlSchema, gitBotAuthorNameSchema, gitBotAuthorEmailSchema, githubTokenEnvVarSchema, operatingModeSchema, deployedAsSchema, contentRootSchema, sourceRootSchema, basePathSchema, deploymentNameSchema, devContentSyncSchema, devConfigSchema, editorConfigSchema, seoFieldNameSchema, seoSchema, CanopyConfigSchema, DEFAULT_PROD_WORKSPACE, init_config, init_config2, init_error2, init_fs2, templates_exports, __dirname, TEMPLATES_DIR, SCAFFOLD_STACK_NAME, init_templates, project_detect_exports, COMMANDS, MAX_WORKSPACE_DEPTH, PLACEHOLDER_GITHUB_REPO, CDK_DEPENDENCIES, init_project_detect, task_queue_config_exports, init_task_queue_config, envFlag, LOG_LEVELS, DebugLogger, testLogger, init_debug, init_atomic_write, DEFAULT_MAX_RETRIES, nullLogger, init_task_queue, cms_task_queue_exports, debugLogger, cmsTaskQueueLogger, init_cms_task_queue, ProdClientSafeStrategy, DevClientSafeStrategy, warned, VALID_DEPLOYMENT_NAME, isValidDeploymentName, ProdStrategy, DevStrategy, strategyCache;
 var init_init = __esm({
   "dist/cli/init.js"() {
     "use strict";
@@ -1361,7 +1361,10 @@ var init_init = __esm({
           required: z.boolean().optional(),
           list: z.boolean().optional(),
           isTitle: z.boolean().optional(),
-          isBody: z.boolean().optional()
+          isBody: z.boolean().optional(),
+          // Listed so a parse keeps it (zod strips unknown keys); which fields may carry it is
+          // `ensureMaxItemsPlacement`'s call (config/validation.ts).
+          maxItems: z.number().int().positive().optional()
         });
         selectOptionSchema = z.union([
           z.string(),
@@ -1419,6 +1422,7 @@ var init_init = __esm({
           type: z.literal("select"),
           options: z.array(selectOptionSchema).min(1)
         });
+        referenceSortFieldSchema = z.string().regex(/^[^.]+(\.[^.]+)*$/, 'must be a field name or a dotted path such as "meta.publishedAt"');
         referenceFieldSchema = fieldBaseSchema.extend({
           type: z.literal("reference"),
           collections: z.array(z.string().min(1)).min(1).optional(),
@@ -1429,7 +1433,14 @@ var init_init = __esm({
           // default, so a consumer that adopts this schema's parse output would silently delete a
           // runtime-consumed flag and the feature would no-op with no error. (`resolvedSchema` is
           // absent on purpose — it is type-inference-only and stripping it changes no behavior.)
-          includeBody: z.boolean().optional()
+          includeBody: z.boolean().optional(),
+          optionSort: z.union([
+            z.enum(["label", "collection"]),
+            z.object({
+              field: referenceSortFieldSchema,
+              direction: z.enum(["asc", "desc"]).optional()
+            }).strict()
+          ]).optional()
         });
         fieldHolder = [z.never()];
         blockSchema = z.object({
@@ -1614,6 +1625,19 @@ var init_init = __esm({
           // Optional: provider sign-in UI for signed-out users (see EditorSignInProps)
           SignInComponent: z5.custom().optional()
         });
+        seoFieldNameSchema = z5.string().min(1).optional();
+        seoSchema = z5.object({
+          group: z5.string().min(1).optional(),
+          fields: z5.object({
+            title: seoFieldNameSchema,
+            description: seoFieldNameSchema,
+            ogImage: seoFieldNameSchema,
+            ogType: seoFieldNameSchema,
+            canonical: seoFieldNameSchema,
+            noindex: seoFieldNameSchema,
+            twitterCard: seoFieldNameSchema
+          }).strict().optional()
+        }).strict();
         CanopyConfigSchema = z5.object({
           media: mediaSchema.optional(),
           // No outer .optional(): both schemas already .default('deny'), so the field is optional on
@@ -1663,6 +1687,7 @@ var init_init = __esm({
           entryLinkUrl: z5.custom().optional(),
           validateEntry: z5.custom().optional(),
           mdxAllow: mdxAllowlistSchema.optional(),
+          seo: seoSchema.optional(),
           dev: devConfigSchema.optional()
         }).strict();
         DEFAULT_PROD_WORKSPACE = "/mnt/efs";
@@ -4552,16 +4577,30 @@ function flattenGroupFields(fields) {
   return result;
 }
 function findBodyFieldName(fields) {
+  return findExplicitBodyFieldName(fields) ?? "body";
+}
+function findExplicitBodyFieldName(fields) {
   for (const field of flattenGroupFields(fields)) {
     if ("isBody" in field && field.isBody)
       return field.name;
   }
-  return "body";
+  return void 0;
+}
+function linkOnlyReferenceData(data, format, fields) {
+  const bodyFieldName = isDataOnlyFormat(format) && fields ? findExplicitBodyFieldName(fields) : void 0;
+  if (bodyFieldName === void 0 || !(bodyFieldName in data))
+    return data;
+  const { [bodyFieldName]: _body, ...rest } = data;
+  return rest;
 }
 function extractSeoFields(entryData, opts = {}) {
-  const names = { ...DEFAULT_SEO_FIELD_NAMES, ...opts.fields };
-  const entry = asRecord(entryData);
-  const source = opts.group ? asRecord(entry?.[opts.group]) : entry;
+  const names = { ...DEFAULT_SEO_FIELD_NAMES };
+  for (const [key, name] of Object.entries(opts.fields ?? {})) {
+    if (typeof name === "string" && name !== "")
+      names[key] = name;
+  }
+  const entry = asRecord2(entryData);
+  const source = opts.group ? asRecord2(entry?.[opts.group]) : entry;
   return {
     title: asText(source?.[names.title]) ?? asText(opts.fallbackTitle),
     description: asText(source?.[names.description]) ?? asText(opts.fallbackDescription),
@@ -6244,7 +6283,7 @@ function createReferenceRendering(idIndex, flatSchema, entryLinkUrl, markdownCop
   };
 }
 async function generateAIContent(options) {
-  const { store, flatSchema, contentRoot, config, entryLinkUrl, generatedAt, buildId } = options;
+  const { store, flatSchema, contentRoot, config, entryLinkUrl, seo, generatedAt, buildId } = options;
   assertValidNoindexConfig(config);
   assertValidReferenceLink(config);
   const files = /* @__PURE__ */ new Map();
@@ -6255,6 +6294,7 @@ async function generateAIContent(options) {
     config,
     idIndex,
     entryLinkUrl,
+    seo,
     resolveTarget: createReferenceTargetResolver(store)
   };
   const collections = flatSchema.filter((item) => item.type === "collection");
@@ -6285,14 +6325,18 @@ async function generateAIContent(options) {
     const pending = pendingById.get(id);
     if (!pending || !exported.has(id))
       return void 0;
-    const { slug } = pending.entry;
-    const target = buildResolvedReference(structuredClone(pending.storedData), {
+    const { format } = pending;
+    const { slug, fields } = pending.entry;
+    const storedData = structuredClone(pending.storedData);
+    const target = buildResolvedReference(linkOnlyReferenceData(storedData, format, fields), {
       id,
       slug,
       collection: pending.collectionPath,
       urlPath: computeEntryUrl(pending.collectionPath, slug, contentRoot)
     });
-    return { target, body: pending.body };
+    const dataBodyField = isDataOnlyFormat(format) ? findExplicitBodyFieldName(fields) : void 0;
+    const dataBody = dataBodyField === void 0 ? void 0 : storedData[dataBodyField];
+    return { target, body: pending.body ?? (typeof dataBody === "string" ? dataBody : void 0) };
   };
   const linkFor = config?.referenceLink ? await decideReferenceLinks(config.referenceLink, allPending, subjectOf, entryLinkUrl) : void 0;
   const bodyLinkUrl = linkFor ? (location) => {
@@ -6402,7 +6446,7 @@ async function collectCollection(read, collection, flatSchema) {
   return { collection, cleanPath, entries, subcollections };
 }
 async function collectEntries(read, collection, cleanPath) {
-  const { store, contentRoot, config, idIndex, entryLinkUrl, resolveTarget: resolveTarget2 } = read;
+  const { store, contentRoot, config, idIndex, entryLinkUrl, seo, resolveTarget: resolveTarget2 } = read;
   const skipNoindex = config?.exclude?.noindex !== false;
   const pending = [];
   const listed = await store.getCollectionEntryPaths(collection.logicalPath);
@@ -6420,7 +6464,7 @@ async function collectEntries(read, collection, cleanPath) {
       const doc = await store.read(listEntry.collection, listEntry.slug, {
         resolveReferences: false
       });
-      if (skipNoindex && isNoindexEntry(doc.data, config?.seo))
+      if (skipNoindex && isNoindexEntry(doc.data, seo))
         continue;
       const storedData = doc.data;
       doc.data = await resolveReferenceFields(doc.data, entryTypeConfig.schema, resolveTarget2);
@@ -6434,6 +6478,7 @@ async function collectEntries(read, collection, cleanPath) {
         entry: aiEntry,
         body,
         storedData,
+        format: doc.format,
         linkedIds: [],
         contentId: extractIdFromFilename(path13.basename(listEntry.relativePath)),
         absolutePath: doc.absolutePath,
@@ -6486,24 +6531,8 @@ function assertValidNoindexConfig(config) {
   if (noindex !== void 0 && typeof noindex !== "boolean") {
     throw new Error(`AI content config: exclude.noindex must be a boolean, got ${typeof noindex}`);
   }
-  const seo = config?.seo;
-  if (seo === void 0)
-    return;
-  if (typeof seo !== "object" || seo === null || Array.isArray(seo)) {
-    throw new Error("AI content config: seo must be an object of { group?, fields? }");
-  }
-  const { group, fields } = seo;
-  if (group !== void 0 && typeof group !== "string") {
-    throw new Error("AI content config: seo.group must be a string");
-  }
-  if (fields === void 0)
-    return;
-  if (typeof fields !== "object" || fields === null || Array.isArray(fields) || Object.values(fields).some((name) => typeof name !== "string")) {
-    throw new Error("AI content config: seo.fields must map SEO fields to field-name strings");
-  }
-  const unknown = Object.keys(fields).filter((key) => !(key in DEFAULT_SEO_FIELD_NAMES));
-  if (unknown.length > 0) {
-    throw new Error(`AI content config: unknown seo.fields key(s): ${unknown.join(", ")}`);
+  if (config && "seo" in config) {
+    throw new Error("AI content config: seo is not an AI content option. Set it once as seo in defineCanopyConfig, where the sitemap, page metadata and AI content all read it.");
   }
 }
 function stripContentRoot(logicalPath, contentRoot) {
@@ -7477,6 +7506,14 @@ function validateEntryData(fields, data, pathPrefix = "", options = {}) {
     }
     if (value === void 0 || value === null)
       continue;
+    if (Array.isArray(value) && "maxItems" in field && typeof field.maxItems === "number" && value.length > field.maxItems) {
+      const cap = field.maxItems;
+      errors.push({
+        fieldPath: path272,
+        message: `At most ${cap} ${cap === 1 ? "item" : "items"}; this list has ${value.length}`,
+        maxItems: { count: value.length, cap }
+      });
+    }
     if (field.type === "block") {
       const blockField = field;
       if (!Array.isArray(value)) {
@@ -7575,14 +7612,34 @@ function assertBuildEntriesValid(items, phaseLabel) {
   const invalid = findInvalidEntries(items);
   if (invalid.length === 0)
     return;
-  const lines = invalid.map(({ entryPath, errors }) => {
-    const [first, ...rest] = errors;
-    const summary = rest.length > 0 ? `${first.fieldPath}: ${first.message} (+${rest.length} more)` : `${first.fieldPath}: ${first.message}`;
-    return `  - ${entryPath} \u2014 ${summary}`;
-  });
+  const lines = [];
+  let hasOverCap = false;
+  let hasOrdinary = false;
+  for (const { entryPath, errors } of invalid) {
+    const ordinary = errors.filter((e) => e.maxItems === void 0);
+    if (ordinary.length > 0) {
+      hasOrdinary = true;
+      const [first, ...rest] = ordinary;
+      const summary = rest.length > 0 ? `${first.fieldPath}: ${first.message} (+${rest.length} more)` : `${first.fieldPath}: ${first.message}`;
+      lines.push(`  - ${entryPath} \u2014 ${summary}`);
+    }
+    for (const { fieldPath, maxItems } of errors) {
+      if (maxItems === void 0)
+        continue;
+      hasOverCap = true;
+      lines.push(`  - ${entryPath} \u2014 ${fieldPath}: ${maxItems.count} items, but maxItems is ${maxItems.cap}`);
+    }
+  }
+  const advice = [];
+  if (hasOverCap) {
+    advice.push(`A list over its maxItems: open the entry in the editor and remove a pick from that list (or remove items) until it holds at most maxItems, then rebuild. This usually happens when two branches each add one item to the same list and are merged one after the other.`);
+  }
+  if (hasOrdinary) {
+    advice.push(`${hasOverCap ? "The other errors are" : "These are"} likely abandoned create-scaffolds (empty entries left behind when a create was started but never finished). Finish editing the entry (fill in its required fields) or delete the abandoned draft, then rebuild.`);
+  }
   throw new Error(`CanopyCMS static build: found ${invalid.length} schema-invalid ${invalid.length === 1 ? "entry" : "entries"} during ${phaseLabel}:
 ${lines.join("\n")}
-These are likely abandoned create-scaffolds (empty entries left behind when a create was started but never finished). Finish editing the entry (fill in its required fields) or delete the abandoned draft, then rebuild.`);
+` + advice.join("\n"));
 }
 async function readGeneratedRecord(outputDir) {
   try {
@@ -7674,6 +7731,7 @@ ${cached.issues.map((issue) => `  - ${issue.message}`).join("\n")}`);
     contentRoot: contentRootName,
     config: aiConfig2,
     entryLinkUrl: config.entryLinkUrl,
+    seo: config.seo,
     ...resolveBuildStamp()
   });
   const absoluteOutputDir = path25.resolve(outputDir) + path25.sep;
@@ -7770,7 +7828,7 @@ async function generateAIContentCLI(options) {
   console.log(`  Output: ${result.outputDir}
 `);
 }
-var __defProp3, __getOwnPropNames3, __esm3, __export3, init_error3, init_atomic_write2, init_field_traversal, ITEM_KEY, ITEM_KEY_PATTERN, isItemKey, BASE58, isListField, init_item_keys, active2, init_logger2, SENTINEL_BASE2, DOT_SEGMENT2, init_sanitize_href2, init_normalize, ROOT_COLLECTION_ID, init_types2, normalizePathValue, flattenSchema, init_flatten, scalarFieldTypes2, markdownFieldTypes2, primitiveFieldTypes2, fieldTypes2, init_types22, SAFE_HTML_TAGS2, COMPONENT_NAME2, MDX_BINDINGS2, FORBIDDEN_ATTRIBUTES2, init_mdx_allowlist2, fieldBaseSchema2, selectOptionSchema2, referenceOptionSchema2, primitiveFieldSchema2, mdxPropAllowSchema2, mdxAllowlistSchema2, markdownFieldSchema2, ASPECT_RATIO_RE2, imageFieldSchema2, selectFieldSchema2, referenceFieldSchema2, fieldHolder2, blockSchema2, blockFieldSchema2, objectFieldSchema2, inlineGroupFieldSchema2, customFieldSchema2, knownFieldSchema2, fieldSchema2, init_field2, relativePathSchema2, entryTypeSchema2, collectionSchema2, init_collection2, uploadTargetUrlSchema2, previewPrefixSchema2, init_url2, mediaSchema2, init_media2, defaultBranchAccessSchema2, defaultPathAccessLevelSchema2, defaultPathAccessLevelsSchema2, defaultPathAccessSchema2, defaultBaseBranchSchema2, defaultRemoteNameSchema2, defaultRemoteUrlSchema2, gitBotAuthorNameSchema2, gitBotAuthorEmailSchema2, githubTokenEnvVarSchema2, operatingModeSchema2, deployedAsSchema2, contentRootSchema2, sourceRootSchema2, basePathSchema2, deploymentNameSchema2, devContentSyncSchema2, devConfigSchema2, editorConfigSchema2, CanopyConfigSchema2, DEFAULT_PROD_WORKSPACE2, init_config3, SERVER_MODE_ENV_VAR, BROWSER_MODE_ENV_VAR, warned2, init_mode_env, forEachReferenceField, init_validation, ProdClientSafeStrategy2, DevClientSafeStrategy2, clientStrategyCache, init_client_safe_strategy, warned3, VALID_DEPLOYMENT_NAME2, isValidDeploymentName2, init_deployment_name, init_config22, ProdStrategy2, DevStrategy2, strategyCache2, init_client_unsafe_strategy, operating_mode_exports, init_operating_mode, task_queue_config_exports2, init_task_queue_config2, worker_status_exports, WORKER_STATUS_FILE, init_worker_status, BLOCK_DISCRIMINATOR_KEYS, BLOCK_STRUCTURAL_KEYS, envFlag2, LOG_LEVELS2, DebugLogger2, testLogger2, END, FRESH, LINE_WIDTH, MIN_LINE_WIDTH, SourceSplicer, log2, MAX_LCS_CELLS, Splicer, log22, EVIDENCE_MAX_DEPTH, log3, locks, PROVISIONING_LOCK_STALE_MS, sleep, META_DIR, CONTENT_WRITE_LOCK_NAME, DEFAULT_CONTENT_WRITE_LOCK_WAIT_MS, ContentWriteLockBusyError, sleep2, CONTENT_WRITE_LOCK_STALE_MS, heldRoots, DEFAULT_SEO_FIELD_NAMES, asRecord, asText, asFlag, asImageUrl, asOgType, asTwitterCard, RESTRICTED_REFERENCE_MARKER, SEO_GROUP_FIELDS, MAX_WARNED, warned4, SchemaUnavailableError, BASE58_PATTERN, CONTENT_ID_PATTERN, PHYSICAL_SEGMENT_PATTERN, isValidId, EMPTY_LOGICAL_PATH, ContentIdIndex, parseTypedFilename, CONTENT_EXTENSIONS, registry, finalization, log4, META_DIR2, entryTypeMetaSchema, collectionMetaSchema, rootCollectionMetaSchema, fingerprints, editDistance, closestName, forEachEntryType, collectEntryTypeNames, validateReferenceEntryTypes, isDeployedStatic, isBuildMode, readsFromCheckout, STATIC_DEPLOY_USER, storage, log5, BaseBranchUnresolvedError, NETWORK_SCHEME_PATTERN, TRANSPORT_HELPER_PATTERN, LEADING_OPTION_PATTERN, WINDOWS_DRIVE_PATTERN, COLON_BEFORE_SLASH_PATTERN, MISSING_REMOTE_REF_REASONS, CANOPY_META_DIR, SCHEMA_CACHE_VERSION, MTIME_CHECK_DEBOUNCE_MS, SCHEMA_CACHE_FILE, SCHEMA_GENERATION_RESOURCE, reportedIssues, BranchSchemaCache, RESOURCE, getFormatExtension, isDataOnlyFormat, asRecord2, RESERVED_SETTINGS_BRANCH_PREFIX, BranchPathError, resolveContentBranchesRoot, ContentStoreError, ContentConflictError, EntryGoneError, BranchSyncingError, DuplicateContentIdError, UrlPathConflictError, isEmptyFieldValue, DEFAULT_INDEX_FRESHNESS_INTERVAL_MS, FORCED_REFRESH_MIN_INTERVAL_MS, STALE_LOOKUP, isMissingReference, createReferenceResolveCache, ContentStore, ATTR_CONTENT, BLOCK_PREFIX, BLOCK_SUFFIX, BLOCK_RESTORE_RE, INLINE_PREFIX, INLINE_SUFFIX, INLINE_RESTORE_RE, DEFAULT_REFERENCE_RENDERING, FLAT_CELL_TYPES, log6, BASE58_CHAR, ENTRY_LINK_PATTERN, INLINE_LINK_TARGET, BranchMetadataCorruptError, BRANCH_META_DIR, BRANCH_META_FILE, branchMetadataFilePath, UNKNOWN_TIME, enumOf, branchMetadataShape, branchMetadataSchema, branchMetadataFileSchema, log7, REGISTRY_FILE, REGISTRY_STALE_FILE, REGISTRY_TEMP_FILE, REGISTRY_VERSION, RESOURCE2, GET_MISS_REFRESH_MIN_INTERVAL_MS, snapshotSchema, reportedUnreadable, BranchRegistry, log8, OccWriteConflictError, CURRENT_SCHEMA_VERSION, BranchMetadataConflictError, BranchMetadataFileManager, loadBranchContext, log9, GIT_ENV_PASSTHROUGH, FORCE_C_LOCALE, GIT_NETWORK_ENV_PASSTHROUGH, NO_AUTO_GC_CONFIG, REMOTE_GIT_CONFIG, REMOTE_GIT_MAX_LOOSE_OBJECTS, REMOTE_GIT_MAX_PACKS, PARALLEL_CHECKOUT_ARGS, remoteInitLocks, GITHUB_TRACKING_REF_PREFIX, GitConflictError, GitRemoteRefMissingError, RemoteNotReadyError, SettingsRemoteUnreadableError, SettingsBranchDivergedError, SETTINGS_BRANCH_FILES, SettingsBranchHasContentHistoryError, GitManager, PUBLISH_LOCK_WAIT_MS, CREATE_RESIDUE_MIN_QUIET_MS, STAGING_MAX_AGE_MS, REPAIR_MAX_AGE_MS, DELETING_MAX_AGE_MS, SETTINGS_TRASH_MAX_AGE_MS, BranchProvisioningBusyError, BranchDirOccupiedError, STAGING_PREFIX, REPAIR_PREFIX, TRASH_PREFIX, stagingDirName, NO_GIT, RENAME_BLOCKED, SPARSE_CONE_RECORD, defaultSink, sink, ProvisionLog, testHooks, provisionsInFlight, BranchWorkspaceManager, log10, normalizePath, readEntryData, createReferenceResolver, withoutUnavailableEntries, resolveCollectionItemReferences, looksLikeMalformedEntry, listCollectionEntries, MAX_INPUT_PIXELS, CROP_PRECISION, KNOWN_FIELD_TYPES, STRING_FIELD_TYPES, selectOptionValues, GENERATED_RECORD_FILENAME, SAFE_BUILD_ID, BUILD_ID_RULE, jiti;
+var __defProp3, __getOwnPropNames3, __esm3, __export3, init_error3, init_atomic_write2, init_field_traversal, ITEM_KEY, ITEM_KEY_PATTERN, isItemKey, BASE58, isListField, init_item_keys, active2, init_logger2, SENTINEL_BASE2, DOT_SEGMENT2, init_sanitize_href2, init_normalize, ROOT_COLLECTION_ID, init_types2, normalizePathValue, flattenSchema, init_flatten, scalarFieldTypes2, markdownFieldTypes2, primitiveFieldTypes2, fieldTypes2, init_types22, SAFE_HTML_TAGS2, COMPONENT_NAME2, MDX_BINDINGS2, FORBIDDEN_ATTRIBUTES2, init_mdx_allowlist2, fieldBaseSchema2, selectOptionSchema2, referenceOptionSchema2, primitiveFieldSchema2, mdxPropAllowSchema2, mdxAllowlistSchema2, markdownFieldSchema2, ASPECT_RATIO_RE2, imageFieldSchema2, selectFieldSchema2, referenceSortFieldSchema2, referenceFieldSchema2, fieldHolder2, blockSchema2, blockFieldSchema2, objectFieldSchema2, inlineGroupFieldSchema2, customFieldSchema2, knownFieldSchema2, fieldSchema2, init_field2, relativePathSchema2, entryTypeSchema2, collectionSchema2, init_collection2, uploadTargetUrlSchema2, previewPrefixSchema2, init_url2, mediaSchema2, init_media2, defaultBranchAccessSchema2, defaultPathAccessLevelSchema2, defaultPathAccessLevelsSchema2, defaultPathAccessSchema2, defaultBaseBranchSchema2, defaultRemoteNameSchema2, defaultRemoteUrlSchema2, gitBotAuthorNameSchema2, gitBotAuthorEmailSchema2, githubTokenEnvVarSchema2, operatingModeSchema2, deployedAsSchema2, contentRootSchema2, sourceRootSchema2, basePathSchema2, deploymentNameSchema2, devContentSyncSchema2, devConfigSchema2, editorConfigSchema2, seoFieldNameSchema2, seoSchema2, CanopyConfigSchema2, DEFAULT_PROD_WORKSPACE2, init_config3, SERVER_MODE_ENV_VAR, BROWSER_MODE_ENV_VAR, warned2, init_mode_env, forEachReferenceField, init_validation, ProdClientSafeStrategy2, DevClientSafeStrategy2, clientStrategyCache, init_client_safe_strategy, warned3, VALID_DEPLOYMENT_NAME2, isValidDeploymentName2, init_deployment_name, init_config22, ProdStrategy2, DevStrategy2, strategyCache2, init_client_unsafe_strategy, operating_mode_exports, init_operating_mode, task_queue_config_exports2, init_task_queue_config2, worker_status_exports, WORKER_STATUS_FILE, init_worker_status, BLOCK_DISCRIMINATOR_KEYS, BLOCK_STRUCTURAL_KEYS, envFlag2, LOG_LEVELS2, DebugLogger2, testLogger2, END, FRESH, LINE_WIDTH, MIN_LINE_WIDTH, SourceSplicer, log2, MAX_LCS_CELLS, Splicer, log22, EVIDENCE_MAX_DEPTH, log3, locks, PROVISIONING_LOCK_STALE_MS, sleep, META_DIR, CONTENT_WRITE_LOCK_NAME, DEFAULT_CONTENT_WRITE_LOCK_WAIT_MS, ContentWriteLockBusyError, sleep2, CONTENT_WRITE_LOCK_STALE_MS, heldRoots, getFormatExtension, isDataOnlyFormat, asRecord, DEFAULT_SEO_FIELD_NAMES, asRecord2, asText, asFlag, asImageUrl, asOgType, asTwitterCard, RESTRICTED_REFERENCE_MARKER, SEO_GROUP_FIELDS, MAX_WARNED, warned4, SchemaUnavailableError, BASE58_PATTERN, CONTENT_ID_PATTERN, PHYSICAL_SEGMENT_PATTERN, isValidId, EMPTY_LOGICAL_PATH, ContentIdIndex, parseTypedFilename, CONTENT_EXTENSIONS, registry, finalization, log4, META_DIR2, entryTypeMetaSchema, collectionMetaSchema, rootCollectionMetaSchema, fingerprints, editDistance, closestName, forEachEntryType, collectEntryTypeNames, validateReferenceEntryTypes, isDeployedStatic, isBuildMode, readsFromCheckout, STATIC_DEPLOY_USER, storage, log5, BaseBranchUnresolvedError, NETWORK_SCHEME_PATTERN, TRANSPORT_HELPER_PATTERN, LEADING_OPTION_PATTERN, WINDOWS_DRIVE_PATTERN, COLON_BEFORE_SLASH_PATTERN, MISSING_REMOTE_REF_REASONS, CANOPY_META_DIR, SCHEMA_CACHE_VERSION, MTIME_CHECK_DEBOUNCE_MS, SCHEMA_CACHE_FILE, SCHEMA_GENERATION_RESOURCE, reportedIssues, BranchSchemaCache, RESOURCE, RESERVED_SETTINGS_BRANCH_PREFIX, BranchPathError, resolveContentBranchesRoot, ContentStoreError, ContentConflictError, EntryGoneError, BranchSyncingError, DuplicateContentIdError, UrlPathConflictError, isEmptyFieldValue, DEFAULT_INDEX_FRESHNESS_INTERVAL_MS, FORCED_REFRESH_MIN_INTERVAL_MS, STALE_LOOKUP, isMissingReference, createReferenceResolveCache, ContentStore, ATTR_CONTENT, BLOCK_PREFIX, BLOCK_SUFFIX, BLOCK_RESTORE_RE, INLINE_PREFIX, INLINE_SUFFIX, INLINE_RESTORE_RE, DEFAULT_REFERENCE_RENDERING, FLAT_CELL_TYPES, log6, BASE58_CHAR, ENTRY_LINK_PATTERN, INLINE_LINK_TARGET, BranchMetadataCorruptError, BRANCH_META_DIR, BRANCH_META_FILE, branchMetadataFilePath, UNKNOWN_TIME, enumOf, branchMetadataShape, branchMetadataSchema, branchMetadataFileSchema, log7, REGISTRY_FILE, REGISTRY_STALE_FILE, REGISTRY_TEMP_FILE, REGISTRY_VERSION, RESOURCE2, GET_MISS_REFRESH_MIN_INTERVAL_MS, snapshotSchema, reportedUnreadable, BranchRegistry, log8, OccWriteConflictError, CURRENT_SCHEMA_VERSION, BranchMetadataConflictError, BranchMetadataFileManager, loadBranchContext, log9, GIT_ENV_PASSTHROUGH, FORCE_C_LOCALE, GIT_NETWORK_ENV_PASSTHROUGH, NO_AUTO_GC_CONFIG, REMOTE_GIT_CONFIG, REMOTE_GIT_MAX_LOOSE_OBJECTS, REMOTE_GIT_MAX_PACKS, PARALLEL_CHECKOUT_ARGS, remoteInitLocks, GITHUB_TRACKING_REF_PREFIX, GitConflictError, GitRemoteRefMissingError, RemoteNotReadyError, SettingsRemoteUnreadableError, SettingsBranchDivergedError, SETTINGS_BRANCH_FILES, SettingsBranchHasContentHistoryError, GitManager, PUBLISH_LOCK_WAIT_MS, CREATE_RESIDUE_MIN_QUIET_MS, STAGING_MAX_AGE_MS, REPAIR_MAX_AGE_MS, DELETING_MAX_AGE_MS, SETTINGS_TRASH_MAX_AGE_MS, BranchProvisioningBusyError, BranchDirOccupiedError, STAGING_PREFIX, REPAIR_PREFIX, TRASH_PREFIX, stagingDirName, NO_GIT, RENAME_BLOCKED, SPARSE_CONE_RECORD, defaultSink, sink, ProvisionLog, testHooks, provisionsInFlight, BranchWorkspaceManager, log10, normalizePath, readEntryData, createReferenceResolver, withoutUnavailableEntries, resolveCollectionItemReferences, looksLikeMalformedEntry, listCollectionEntries, MAX_INPUT_PIXELS, CROP_PRECISION, KNOWN_FIELD_TYPES, STRING_FIELD_TYPES, selectOptionValues, GENERATED_RECORD_FILENAME, SAFE_BUILD_ID, BUILD_ID_RULE, jiti;
 var init_generate_ai_content = __esm({
   "dist/cli/generate-ai-content.js"() {
     "use strict";
@@ -8053,7 +8111,10 @@ var init_generate_ai_content = __esm({
           required: z22.boolean().optional(),
           list: z22.boolean().optional(),
           isTitle: z22.boolean().optional(),
-          isBody: z22.boolean().optional()
+          isBody: z22.boolean().optional(),
+          // Listed so a parse keeps it (zod strips unknown keys); which fields may carry it is
+          // `ensureMaxItemsPlacement`'s call (config/validation.ts).
+          maxItems: z22.number().int().positive().optional()
         });
         selectOptionSchema2 = z22.union([
           z22.string(),
@@ -8111,6 +8172,7 @@ var init_generate_ai_content = __esm({
           type: z22.literal("select"),
           options: z22.array(selectOptionSchema2).min(1)
         });
+        referenceSortFieldSchema2 = z22.string().regex(/^[^.]+(\.[^.]+)*$/, 'must be a field name or a dotted path such as "meta.publishedAt"');
         referenceFieldSchema2 = fieldBaseSchema2.extend({
           type: z22.literal("reference"),
           collections: z22.array(z22.string().min(1)).min(1).optional(),
@@ -8121,7 +8183,14 @@ var init_generate_ai_content = __esm({
           // default, so a consumer that adopts this schema's parse output would silently delete a
           // runtime-consumed flag and the feature would no-op with no error. (`resolvedSchema` is
           // absent on purpose — it is type-inference-only and stripping it changes no behavior.)
-          includeBody: z22.boolean().optional()
+          includeBody: z22.boolean().optional(),
+          optionSort: z22.union([
+            z22.enum(["label", "collection"]),
+            z22.object({
+              field: referenceSortFieldSchema2,
+              direction: z22.enum(["asc", "desc"]).optional()
+            }).strict()
+          ]).optional()
         });
         fieldHolder2 = [z22.never()];
         blockSchema2 = z22.object({
@@ -8299,6 +8368,19 @@ var init_generate_ai_content = __esm({
           // Optional: provider sign-in UI for signed-out users (see EditorSignInProps)
           SignInComponent: z6.custom().optional()
         });
+        seoFieldNameSchema2 = z6.string().min(1).optional();
+        seoSchema2 = z6.object({
+          group: z6.string().min(1).optional(),
+          fields: z6.object({
+            title: seoFieldNameSchema2,
+            description: seoFieldNameSchema2,
+            ogImage: seoFieldNameSchema2,
+            ogType: seoFieldNameSchema2,
+            canonical: seoFieldNameSchema2,
+            noindex: seoFieldNameSchema2,
+            twitterCard: seoFieldNameSchema2
+          }).strict().optional()
+        }).strict();
         CanopyConfigSchema2 = z6.object({
           media: mediaSchema2.optional(),
           // No outer .optional(): both schemas already .default('deny'), so the field is optional on
@@ -8348,6 +8430,7 @@ var init_generate_ai_content = __esm({
           entryLinkUrl: z6.custom().optional(),
           validateEntry: z6.custom().optional(),
           mdxAllow: mdxAllowlistSchema2.optional(),
+          seo: seoSchema2.optional(),
           dev: devConfigSchema2.optional()
         }).strict();
         DEFAULT_PROD_WORKSPACE2 = "/mnt/efs";
@@ -9216,6 +9299,17 @@ var init_generate_ai_content = __esm({
     });
     CONTENT_WRITE_LOCK_STALE_MS = 3e4;
     heldRoots = new AsyncLocalStorage();
+    getFormatExtension = (format) => {
+      if (format === "md")
+        return ".md";
+      if (format === "mdx")
+        return ".mdx";
+      if (format === "yaml")
+        return ".yaml";
+      return ".json";
+    };
+    isDataOnlyFormat = (format) => format === "json" || format === "yaml";
+    asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
     init_item_keys();
     DEFAULT_SEO_FIELD_NAMES = {
       title: "metaTitle",
@@ -9226,7 +9320,7 @@ var init_generate_ai_content = __esm({
       noindex: "noindex",
       twitterCard: "twitterCard"
     };
-    asRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+    asRecord2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
     asText = (value) => {
       if (typeof value !== "string")
         return void 0;
@@ -9238,7 +9332,7 @@ var init_generate_ai_content = __esm({
       const text3 = asText(value);
       if (text3)
         return text3;
-      return asText(asRecord(value)?.src);
+      return asText(asRecord2(value)?.src);
     };
     asOgType = (value) => {
       const text3 = asText(value);
@@ -9939,17 +10033,6 @@ var init_generate_ai_content = __esm({
     RESOURCE = "content-index";
     init_error3();
     init_error3();
-    getFormatExtension = (format) => {
-      if (format === "md")
-        return ".md";
-      if (format === "mdx")
-        return ".mdx";
-      if (format === "yaml")
-        return ".yaml";
-      return ".json";
-    };
-    isDataOnlyFormat = (format) => format === "json" || format === "yaml";
-    asRecord2 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
     init_normalize();
     init_operating_mode();
     RESERVED_SETTINGS_BRANCH_PREFIX = "canopycms-settings-";
@@ -10448,7 +10531,7 @@ var init_generate_ai_content = __esm({
           fields = entryTypeConfig?.schema || [];
         }
         if (format === "json") {
-          const data = asRecord2(JSON.parse(raw));
+          const data = asRecord(JSON.parse(raw));
           doc = {
             collection: schemaItem.logicalPath,
             collectionName: schemaItem.name,
@@ -10458,7 +10541,7 @@ var init_generate_ai_content = __esm({
             absolutePath
           };
         } else if (format === "yaml") {
-          const data = asRecord2(yamlParse(raw));
+          const data = asRecord(yamlParse(raw));
           doc = {
             collection: schemaItem.logicalPath,
             collectionName: schemaItem.name,
@@ -11061,10 +11144,11 @@ var init_generate_ai_content = __esm({
        * Measured (2000 occurrences of one target, local disk, the friendliest case for NOT
        * caching): cloning a snippet-sized target is ~63x cheaper than re-reading and parsing it, a
        * 265KB JSON target ~0.8x -- a wash at the pathological end, never a blow-up, and on the
-       * EFS/NFS this targets the syscall the memo removes dominates both. An md/mdx target
-       * resolves to its FRONTMATTER unless the field sets `includeBody`, which is why
-       * `includeBody` is opt-in per field: an embedded body sits inside the memoized object and is
-       * cloned once per referencing entry.
+       * EFS/NFS this targets the syscall the memo removes dominates both. A target resolves
+       * without its body (an md/mdx target to its frontmatter, a json/yaml one without its `isBody`
+       * field) unless the field sets `includeBody`, which is why `includeBody` is opt-in per
+       * field: an embedded body sits inside the memoized object and is cloned once per referencing
+       * entry.
        */
       resolveSingleReference(id, idIndex, includeBody, cache, access) {
         if (!cache)
@@ -11159,7 +11243,8 @@ var init_generate_ai_content = __esm({
             }));
           }
           const bodyForEmbed = includeBody && "body" in doc ? { fieldName: doc.bodyFieldName, value: doc.body } : void 0;
-          return buildResolvedReference(doc.data, meta, bodyForEmbed);
+          const data = includeBody ? doc.data : linkOnlyReferenceData(doc.data, doc.format, this.entryTypeOf(location.collection, location.relativePath)?.schema);
+          return buildResolvedReference(data, meta, bodyForEmbed);
         } catch (error) {
           if (isNodeError3(error) && error.code === "ENOENT")
             return STALE_LOOKUP;
@@ -13182,10 +13267,10 @@ var init_generate_ai_content = __esm({
       try {
         const raw = await fs20.readFile(filePath, "utf8");
         if (format === "json") {
-          return asRecord2(JSON.parse(raw));
+          return asRecord(JSON.parse(raw));
         }
         if (format === "yaml") {
-          return asRecord2(yamlParse2(raw));
+          return asRecord(yamlParse2(raw));
         }
         const parsed = matter3(raw);
         const data = { ...parsed.data ?? {} };
@@ -15305,7 +15390,7 @@ var init_mdx_allowlist3 = __esm({
 
 // dist/config/schemas/field.js
 import { z as z10 } from "zod";
-var fieldBaseSchema3, selectOptionSchema3, referenceOptionSchema3, primitiveFieldSchema3, mdxPropAllowSchema3, mdxAllowlistSchema3, markdownFieldSchema3, ASPECT_RATIO_RE3, imageFieldSchema3, selectFieldSchema3, referenceFieldSchema3, fieldHolder3, blockSchema3, blockFieldSchema3, objectFieldSchema3, inlineGroupFieldSchema3, customFieldSchema3, knownFieldSchema3, fieldSchema3;
+var fieldBaseSchema3, selectOptionSchema3, referenceOptionSchema3, primitiveFieldSchema3, mdxPropAllowSchema3, mdxAllowlistSchema3, markdownFieldSchema3, ASPECT_RATIO_RE3, imageFieldSchema3, selectFieldSchema3, referenceSortFieldSchema3, referenceFieldSchema3, fieldHolder3, blockSchema3, blockFieldSchema3, objectFieldSchema3, inlineGroupFieldSchema3, customFieldSchema3, knownFieldSchema3, fieldSchema3;
 var init_field3 = __esm({
   "dist/config/schemas/field.js"() {
     "use strict";
@@ -15318,7 +15403,10 @@ var init_field3 = __esm({
       required: z10.boolean().optional(),
       list: z10.boolean().optional(),
       isTitle: z10.boolean().optional(),
-      isBody: z10.boolean().optional()
+      isBody: z10.boolean().optional(),
+      // Listed so a parse keeps it (zod strips unknown keys); which fields may carry it is
+      // `ensureMaxItemsPlacement`'s call (config/validation.ts).
+      maxItems: z10.number().int().positive().optional()
     });
     selectOptionSchema3 = z10.union([
       z10.string(),
@@ -15376,6 +15464,7 @@ var init_field3 = __esm({
       type: z10.literal("select"),
       options: z10.array(selectOptionSchema3).min(1)
     });
+    referenceSortFieldSchema3 = z10.string().regex(/^[^.]+(\.[^.]+)*$/, 'must be a field name or a dotted path such as "meta.publishedAt"');
     referenceFieldSchema3 = fieldBaseSchema3.extend({
       type: z10.literal("reference"),
       collections: z10.array(z10.string().min(1)).min(1).optional(),
@@ -15386,7 +15475,14 @@ var init_field3 = __esm({
       // default, so a consumer that adopts this schema's parse output would silently delete a
       // runtime-consumed flag and the feature would no-op with no error. (`resolvedSchema` is
       // absent on purpose — it is type-inference-only and stripping it changes no behavior.)
-      includeBody: z10.boolean().optional()
+      includeBody: z10.boolean().optional(),
+      optionSort: z10.union([
+        z10.enum(["label", "collection"]),
+        z10.object({
+          field: referenceSortFieldSchema3,
+          direction: z10.enum(["asc", "desc"]).optional()
+        }).strict()
+      ]).optional()
     });
     fieldHolder3 = [z10.never()];
     blockSchema3 = z10.object({
@@ -15620,7 +15716,7 @@ var init_deployment_name2 = __esm({
 
 // dist/config/schemas/config.js
 import { z as z14 } from "zod";
-var defaultBranchAccessSchema3, defaultPathAccessLevelSchema3, defaultPathAccessLevelsSchema3, defaultPathAccessSchema3, defaultBaseBranchSchema3, defaultRemoteNameSchema3, defaultRemoteUrlSchema3, gitBotAuthorNameSchema3, gitBotAuthorEmailSchema3, githubTokenEnvVarSchema3, operatingModeSchema3, deployedAsSchema3, contentRootSchema3, sourceRootSchema3, basePathSchema3, deploymentNameSchema3, devContentSyncSchema3, devConfigSchema3, editorConfigSchema3, CanopyConfigSchema3, DEFAULT_PROD_WORKSPACE3;
+var defaultBranchAccessSchema3, defaultPathAccessLevelSchema3, defaultPathAccessLevelsSchema3, defaultPathAccessSchema3, defaultBaseBranchSchema3, defaultRemoteNameSchema3, defaultRemoteUrlSchema3, gitBotAuthorNameSchema3, gitBotAuthorEmailSchema3, githubTokenEnvVarSchema3, operatingModeSchema3, deployedAsSchema3, contentRootSchema3, sourceRootSchema3, basePathSchema3, deploymentNameSchema3, devContentSyncSchema3, devConfigSchema3, editorConfigSchema3, seoFieldNameSchema3, seoSchema3, CanopyConfigSchema3, DEFAULT_PROD_WORKSPACE3;
 var init_config4 = __esm({
   "dist/config/schemas/config.js"() {
     "use strict";
@@ -15667,6 +15763,19 @@ var init_config4 = __esm({
       // Optional: provider sign-in UI for signed-out users (see EditorSignInProps)
       SignInComponent: z14.custom().optional()
     });
+    seoFieldNameSchema3 = z14.string().min(1).optional();
+    seoSchema3 = z14.object({
+      group: z14.string().min(1).optional(),
+      fields: z14.object({
+        title: seoFieldNameSchema3,
+        description: seoFieldNameSchema3,
+        ogImage: seoFieldNameSchema3,
+        ogType: seoFieldNameSchema3,
+        canonical: seoFieldNameSchema3,
+        noindex: seoFieldNameSchema3,
+        twitterCard: seoFieldNameSchema3
+      }).strict().optional()
+    }).strict();
     CanopyConfigSchema3 = z14.object({
       media: mediaSchema3.optional(),
       // No outer .optional(): both schemas already .default('deny'), so the field is optional on
@@ -15716,6 +15825,7 @@ var init_config4 = __esm({
       entryLinkUrl: z14.custom().optional(),
       validateEntry: z14.custom().optional(),
       mdxAllow: mdxAllowlistSchema3.optional(),
+      seo: seoSchema3.optional(),
       dev: devConfigSchema3.optional()
     }).strict();
     DEFAULT_PROD_WORKSPACE3 = "/mnt/efs";