canopycms 0.3.3 → 0.5.0

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

@@ -599,7 +599,7 @@ var init_mdx_allowlist = __esm({
 
 // dist/config/schemas/field.js
 import { z as z2 } from "zod";
-var fieldBaseSchema, selectOptionSchema, referenceOptionSchema, primitiveFieldSchema, mdxPropAllowSchema, mdxAllowlistSchema, markdownFieldSchema, ASPECT_RATIO_RE, imageFieldSchema, selectFieldSchema, referenceFieldSchema, fieldHolder, blockSchema, blockFieldSchema, objectFieldSchema, inlineGroupFieldSchema, customFieldSchema, knownFieldSchema, fieldSchema;
+var fieldBaseSchema, selectOptionSchema, referenceOptionSchema, primitiveFieldSchema, mdxPropAllowSchema, mdxAllowlistSchema, markdownFieldSchema, ASPECT_RATIO_RE, imageFieldSchema, selectFieldSchema, referenceSortFieldSchema, referenceFieldSchema, fieldHolder, blockSchema, blockFieldSchema, objectFieldSchema, inlineGroupFieldSchema, customFieldSchema, knownFieldSchema, fieldSchema;
 var init_field = __esm({
   "dist/config/schemas/field.js"() {
     "use strict";
@@ -612,7 +612,10 @@ var init_field = __esm({
       required: z2.boolean().optional(),
       list: z2.boolean().optional(),
       isTitle: z2.boolean().optional(),
-      isBody: z2.boolean().optional()
+      isBody: z2.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: z2.number().int().positive().optional()
     });
     selectOptionSchema = z2.union([
       z2.string(),
@@ -670,6 +673,7 @@ var init_field = __esm({
       type: z2.literal("select"),
       options: z2.array(selectOptionSchema).min(1)
     });
+    referenceSortFieldSchema = z2.string().regex(/^[^.]+(\.[^.]+)*$/, 'must be a field name or a dotted path such as "meta.publishedAt"');
     referenceFieldSchema = fieldBaseSchema.extend({
       type: z2.literal("reference"),
       collections: z2.array(z2.string().min(1)).min(1).optional(),
@@ -680,7 +684,14 @@ var init_field = __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: z2.boolean().optional()
+      includeBody: z2.boolean().optional(),
+      optionSort: z2.union([
+        z2.enum(["label", "collection"]),
+        z2.object({
+          field: referenceSortFieldSchema,
+          direction: z2.enum(["asc", "desc"]).optional()
+        }).strict()
+      ]).optional()
     });
     fieldHolder = [z2.never()];
     blockSchema = z2.object({
@@ -828,7 +839,7 @@ var init_media = __esm({
 
 // dist/config/schemas/config.js
 import { z as z6 } from "zod";
-var defaultBranchAccessSchema, defaultPathAccessLevelSchema, defaultPathAccessLevelsSchema, defaultPathAccessSchema, defaultBaseBranchSchema, defaultRemoteNameSchema, defaultRemoteUrlSchema, gitBotAuthorNameSchema, gitBotAuthorEmailSchema, githubTokenEnvVarSchema, operatingModeSchema, deployedAsSchema, contentRootSchema, sourceRootSchema, basePathSchema, deploymentNameSchema, devContentSyncSchema, devConfigSchema, editorConfigSchema, CanopyConfigSchema, DEFAULT_PROD_WORKSPACE;
+var 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;
 var init_config = __esm({
   "dist/config/schemas/config.js"() {
     "use strict";
@@ -875,6 +886,19 @@ var init_config = __esm({
       // Optional: provider sign-in UI for signed-out users (see EditorSignInProps)
       SignInComponent: z6.custom().optional()
     });
+    seoFieldNameSchema = z6.string().min(1).optional();
+    seoSchema = z6.object({
+      group: z6.string().min(1).optional(),
+      fields: z6.object({
+        title: seoFieldNameSchema,
+        description: seoFieldNameSchema,
+        ogImage: seoFieldNameSchema,
+        ogType: seoFieldNameSchema,
+        canonical: seoFieldNameSchema,
+        noindex: seoFieldNameSchema,
+        twitterCard: seoFieldNameSchema
+      }).strict().optional()
+    }).strict();
     CanopyConfigSchema = z6.object({
       media: mediaSchema.optional(),
       // No outer .optional(): both schemas already .default('deny'), so the field is optional on
@@ -924,6 +948,7 @@ var init_config = __esm({
       entryLinkUrl: z6.custom().optional(),
       validateEntry: z6.custom().optional(),
       mdxAllow: mdxAllowlistSchema.optional(),
+      seo: seoSchema.optional(),
       dev: devConfigSchema.optional()
     }).strict();
     DEFAULT_PROD_WORKSPACE = "/mnt/efs";
@@ -2912,13 +2937,36 @@ function flattenGroupFields(fields) {
   return result;
 }
 
+// dist/utils/format.js
+var getFormatExtension = (format) => {
+  if (format === "md")
+    return ".md";
+  if (format === "mdx")
+    return ".mdx";
+  if (format === "yaml")
+    return ".yaml";
+  return ".json";
+};
+var isDataOnlyFormat = (format) => format === "json" || format === "yaml";
+var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
+
 // dist/utils/body-field.js
 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;
 }
 
 // dist/content-store.js
@@ -2934,7 +2982,7 @@ var DEFAULT_SEO_FIELD_NAMES = {
   noindex: "noindex",
   twitterCard: "twitterCard"
 };
-var asRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+var asRecord2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
 var asText = (value) => {
   if (typeof value !== "string")
     return void 0;
@@ -2946,7 +2994,7 @@ var asImageUrl = (value) => {
   const text = asText(value);
   if (text)
     return text;
-  return asText(asRecord(value)?.src);
+  return asText(asRecord2(value)?.src);
 };
 var asOgType = (value) => {
   const text = asText(value);
@@ -2957,9 +3005,13 @@ var asTwitterCard = (value) => {
   return text === "summary" || text === "summary_large_image" ? text : void 0;
 };
 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),
@@ -4459,19 +4511,6 @@ async function readFileWithMtimeIfExists(filePath) {
   }
 }
 
-// dist/utils/format.js
-var getFormatExtension = (format) => {
-  if (format === "md")
-    return ".md";
-  if (format === "mdx")
-    return ".mdx";
-  if (format === "yaml")
-    return ".yaml";
-  return ".json";
-};
-var isDataOnlyFormat = (format) => format === "json" || format === "yaml";
-var asRecord2 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
-
 // dist/paths/index.js
 init_normalize();
 
@@ -5085,7 +5124,7 @@ var ContentStore = class {
       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,
@@ -5095,7 +5134,7 @@ var ContentStore = class {
         absolutePath
       };
     } else if (format === "yaml") {
-      const data = asRecord2(yamlParse(raw));
+      const data = asRecord(yamlParse(raw));
       doc = {
         collection: schemaItem.logicalPath,
         collectionName: schemaItem.name,
@@ -5698,10 +5737,11 @@ var ContentStore = class {
    * 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)
@@ -5796,7 +5836,8 @@ var ContentStore = class {
         }));
       }
       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 (isNodeError(error) && error.code === "ENOENT")
         return STALE_LOOKUP;
@@ -6711,7 +6752,7 @@ function createReferenceRendering(idIndex, flatSchema, entryLinkUrl, markdownCop
 
 // dist/ai/generate.js
 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();
@@ -6722,6 +6763,7 @@ async function generateAIContent(options) {
     config,
     idIndex,
     entryLinkUrl,
+    seo,
     resolveTarget: createReferenceTargetResolver(store)
   };
   const collections = flatSchema.filter((item) => item.type === "collection");
@@ -6752,14 +6794,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) => {
@@ -6869,7 +6915,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 } = read;
+  const { store, contentRoot, config, idIndex, entryLinkUrl, seo, resolveTarget } = read;
   const skipNoindex = config?.exclude?.noindex !== false;
   const pending = [];
   const listed = await store.getCollectionEntryPaths(collection.logicalPath);
@@ -6887,7 +6933,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, resolveTarget);
@@ -6901,6 +6947,7 @@ async function collectEntries(read, collection, cleanPath) {
         entry: aiEntry,
         body,
         storedData,
+        format: doc.format,
         linkedIds: [],
         contentId: extractIdFromFilename(path13.basename(listEntry.relativePath)),
         absolutePath: doc.absolutePath,
@@ -6953,24 +7000,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) {
@@ -9794,10 +9825,10 @@ var readEntryData = async (filePath, format, bodyFieldName = "body") => {
   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 ?? {} };
@@ -10121,6 +10152,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: path27,
+        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)) {
@@ -10221,14 +10260,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"));
 }
 
 // dist/build/generate-ai-content.js
@@ -10325,6 +10384,7 @@ ${cached.issues.map((issue) => `  - ${issue.message}`).join("\n")}`);
     contentRoot: contentRootName,
     config: aiConfig,
     entryLinkUrl: config.entryLinkUrl,
+    seo: config.seo,
     ...resolveBuildStamp()
   });
   const absoluteOutputDir = path25.resolve(outputDir) + path25.sep;

package/dist/cli/init.js

@@ -160,7 +160,7 @@ var init_mdx_allowlist = __esm({
 
 // dist/config/schemas/field.js
 import { z } from "zod";
-var fieldBaseSchema, selectOptionSchema, referenceOptionSchema, primitiveFieldSchema, mdxPropAllowSchema, mdxAllowlistSchema, markdownFieldSchema, ASPECT_RATIO_RE, imageFieldSchema, selectFieldSchema, referenceFieldSchema, fieldHolder, blockSchema, blockFieldSchema, objectFieldSchema, inlineGroupFieldSchema, customFieldSchema, knownFieldSchema, fieldSchema;
+var fieldBaseSchema, selectOptionSchema, referenceOptionSchema, primitiveFieldSchema, mdxPropAllowSchema, mdxAllowlistSchema, markdownFieldSchema, ASPECT_RATIO_RE, imageFieldSchema, selectFieldSchema, referenceSortFieldSchema, referenceFieldSchema, fieldHolder, blockSchema, blockFieldSchema, objectFieldSchema, inlineGroupFieldSchema, customFieldSchema, knownFieldSchema, fieldSchema;
 var init_field = __esm({
   "dist/config/schemas/field.js"() {
     "use strict";
@@ -173,7 +173,10 @@ var init_field = __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(),
@@ -231,6 +234,7 @@ var init_field = __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(),
@@ -241,7 +245,14 @@ var init_field = __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({
@@ -439,7 +450,7 @@ var init_media = __esm({
 
 // dist/config/schemas/config.js
 import { z as z5 } from "zod";
-var defaultBranchAccessSchema, defaultPathAccessLevelSchema, defaultPathAccessLevelsSchema, defaultPathAccessSchema, defaultBaseBranchSchema, defaultRemoteNameSchema, defaultRemoteUrlSchema, gitBotAuthorNameSchema, gitBotAuthorEmailSchema, githubTokenEnvVarSchema, operatingModeSchema, deployedAsSchema, contentRootSchema, sourceRootSchema, basePathSchema, deploymentNameSchema, devContentSyncSchema, devConfigSchema, editorConfigSchema, CanopyConfigSchema, DEFAULT_PROD_WORKSPACE;
+var 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;
 var init_config = __esm({
   "dist/config/schemas/config.js"() {
     "use strict";
@@ -486,6 +497,19 @@ var init_config = __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
@@ -535,6 +559,7 @@ var init_config = __esm({
       entryLinkUrl: z5.custom().optional(),
       validateEntry: z5.custom().optional(),
       mdxAllow: mdxAllowlistSchema.optional(),
+      seo: seoSchema.optional(),
       dev: devConfigSchema.optional()
     }).strict();
     DEFAULT_PROD_WORKSPACE = "/mnt/efs";

package/dist/config/index.d.ts

@@ -8,7 +8,7 @@
  * import { defineCanopyConfig, type FieldConfig } from 'canopycms'
  * ```
  */
-export type { PrimitiveFieldType, FieldType, ContentFormat, MediaAdapterKind, PermissionLevel, PermissionTarget, PathPermission, SelectOption, ReferenceOption, FieldConfig, BlockConfig, BlockFieldConfig, SelectFieldConfig, ReferenceFieldConfig, ImageFieldConfig, MarkdownFieldConfig, MdxAllowlist, MdxComponentAllow, MdxPropAllow, ImageFieldValue, ObjectFieldConfig, InlineGroupFieldConfig, CustomFieldConfig, EntrySchema, BranchSchema, EntryTypeConfig, EntryTypeUnavailable, CollectionConfig, RootCollectionConfig, MediaConfig, CanopyEditorConfig, DefaultBranchAccess, DefaultPathAccess, DefaultPathAccessLevel, DefaultPathAccessLevels, DefaultBaseBranch, DefaultRemoteName, DefaultRemoteUrl, GitBotAuthorName, GitBotAuthorEmail, GithubTokenEnvVar, CanopyOperatingMode, ContentRoot, SourceRoot, CanopyConfig, CanopyConfigInput, CanopyConfigFragment, FlatSchemaItem, CanopyClientConfig, ClientOnlyFields, EditorSignInProps, EntryValidationIssue, ValidateEntryInput, ValidateEntryHook, } from './types.js';
+export type { PrimitiveFieldType, FieldType, ContentFormat, MediaAdapterKind, PermissionLevel, PermissionTarget, PathPermission, SelectOption, ReferenceOption, FieldConfig, BlockConfig, BlockFieldConfig, SelectFieldConfig, ReferenceFieldConfig, ReferenceOptionSort, ImageFieldConfig, MarkdownFieldConfig, MdxAllowlist, MdxComponentAllow, MdxPropAllow, ImageFieldValue, ObjectFieldConfig, InlineGroupFieldConfig, CustomFieldConfig, EntrySchema, BranchSchema, EntryTypeConfig, EntryTypeUnavailable, CollectionConfig, RootCollectionConfig, MediaConfig, CanopyEditorConfig, DefaultBranchAccess, DefaultPathAccess, DefaultPathAccessLevel, DefaultPathAccessLevels, DefaultBaseBranch, DefaultRemoteName, DefaultRemoteUrl, GitBotAuthorName, GitBotAuthorEmail, GithubTokenEnvVar, CanopyOperatingMode, ContentRoot, SourceRoot, CanopyConfig, CanopyConfigInput, CanopyConfigFragment, FlatSchemaItem, CanopyClientConfig, ClientOnlyFields, EditorSignInProps, EntryValidationIssue, ValidateEntryInput, ValidateEntryHook, } from './types.js';
 export { primitiveFieldTypes, fieldTypes } from './types.js';
 export { CanopyConfigSchema, getConfigDefaults, DEFAULT_PROD_WORKSPACE } from './schemas/config.js';
 export { fieldSchema, blockSchema, selectOptionSchema, referenceOptionSchema, imageFieldSchema, } from './schemas/field.js';

package/dist/config/schemas/config.d.ts

@@ -105,6 +105,56 @@ export declare const CanopyConfigSchema: z.ZodObject<{
     entryLinkUrl: z.ZodOptional<z.ZodType<EntryLinkUrlResolver, z.ZodTypeDef, EntryLinkUrlResolver>>;
     validateEntry: z.ZodOptional<z.ZodType<ValidateEntryHook, z.ZodTypeDef, ValidateEntryHook>>;
     mdxAllow: z.ZodOptional<z.ZodType<import("../index.js").MdxAllowlist, z.ZodTypeDef, import("../index.js").MdxAllowlist>>;
+    seo: z.ZodOptional<z.ZodObject<{
+        group: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            ogImage: z.ZodOptional<z.ZodString>;
+            ogType: z.ZodOptional<z.ZodString>;
+            canonical: z.ZodOptional<z.ZodString>;
+            noindex: z.ZodOptional<z.ZodString>;
+            twitterCard: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            description?: string | undefined;
+            title?: string | undefined;
+            ogImage?: string | undefined;
+            ogType?: string | undefined;
+            canonical?: string | undefined;
+            noindex?: string | undefined;
+            twitterCard?: string | undefined;
+        }, {
+            description?: string | undefined;
+            title?: string | undefined;
+            ogImage?: string | undefined;
+            ogType?: string | undefined;
+            canonical?: string | undefined;
+            noindex?: string | undefined;
+            twitterCard?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        fields?: {
+            description?: string | undefined;
+            title?: string | undefined;
+            ogImage?: string | undefined;
+            ogType?: string | undefined;
+            canonical?: string | undefined;
+            noindex?: string | undefined;
+            twitterCard?: string | undefined;
+        } | undefined;
+        group?: string | undefined;
+    }, {
+        fields?: {
+            description?: string | undefined;
+            title?: string | undefined;
+            ogImage?: string | undefined;
+            ogType?: string | undefined;
+            canonical?: string | undefined;
+            noindex?: string | undefined;
+            twitterCard?: string | undefined;
+        } | undefined;
+        group?: string | undefined;
+    }>>;
     dev: z.ZodOptional<z.ZodObject<{
         contentSync: z.ZodOptional<z.ZodDefault<z.ZodEnum<["off", "warn"]>>>;
     }, "strip", z.ZodTypeAny, {
@@ -167,6 +217,18 @@ export declare const CanopyConfigSchema: z.ZodObject<{
     entryLinkUrl?: EntryLinkUrlResolver | undefined;
     validateEntry?: ValidateEntryHook | undefined;
     mdxAllow?: import("../index.js").MdxAllowlist | undefined;
+    seo?: {
+        fields?: {
+            description?: string | undefined;
+            title?: string | undefined;
+            ogImage?: string | undefined;
+            ogType?: string | undefined;
+            canonical?: string | undefined;
+            noindex?: string | undefined;
+            twitterCard?: string | undefined;
+        } | undefined;
+        group?: string | undefined;
+    } | undefined;
 }, {
     gitBotAuthorName: string;
     gitBotAuthorEmail: string;
@@ -222,6 +284,18 @@ export declare const CanopyConfigSchema: z.ZodObject<{
     entryLinkUrl?: EntryLinkUrlResolver | undefined;
     validateEntry?: ValidateEntryHook | undefined;
     mdxAllow?: import("../index.js").MdxAllowlist | undefined;
+    seo?: {
+        fields?: {
+            description?: string | undefined;
+            title?: string | undefined;
+            ogImage?: string | undefined;
+            ogType?: string | undefined;
+            canonical?: string | undefined;
+            noindex?: string | undefined;
+            twitterCard?: string | undefined;
+        } | undefined;
+        group?: string | undefined;
+    } | undefined;
 }>;
 /**
  * Default workspace path for prod mode (used when CANOPYCMS_WORKSPACE_ROOT is not set): where

package/dist/config/schemas/config.js

@@ -61,6 +61,26 @@ const editorConfigSchema = z.object({
     // Optional: provider sign-in UI for signed-out users (see EditorSignInProps)
     SignInComponent: z.custom().optional(),
 });
+const seoFieldNameSchema = z.string().min(1).optional();
+// Strict, so a misspelled key (`noIndex`) fails the parse instead of leaving every surface
+// reading the default field name.
+const seoSchema = z
+    .object({
+    group: z.string().min(1).optional(),
+    fields: z
+        .object({
+        title: seoFieldNameSchema,
+        description: seoFieldNameSchema,
+        ogImage: seoFieldNameSchema,
+        ogType: seoFieldNameSchema,
+        canonical: seoFieldNameSchema,
+        noindex: seoFieldNameSchema,
+        twitterCard: seoFieldNameSchema,
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
 export const CanopyConfigSchema = z
     .object({
     media: mediaSchema.optional(),
@@ -110,6 +130,7 @@ export const CanopyConfigSchema = z
     entryLinkUrl: z.custom().optional(),
     validateEntry: z.custom().optional(),
     mdxAllow: mdxAllowlistSchema.optional(),
+    seo: seoSchema.optional(),
     dev: devConfigSchema.optional(),
 })
     .strict();