canopycms 0.4.0 → 0.6.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";
@@ -2980,7 +3005,11 @@ 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 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 {
@@ -6723,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();
@@ -6734,6 +6763,7 @@ async function generateAIContent(options) {
     config,
     idIndex,
     entryLinkUrl,
+    seo,
     resolveTarget: createReferenceTargetResolver(store)
   };
   const collections = flatSchema.filter((item) => item.type === "collection");
@@ -6885,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);
@@ -6903,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);
@@ -6970,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) {
@@ -10138,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)) {
@@ -10238,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
@@ -10342,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";
@@ -632,9 +657,13 @@ async function canopyContext(options) {
     "// authenticated request instead of silently falling back to unauthenticated dev auth.",
     "// CLERK_SECRET_KEY is read only where Clerk's backend API is called: the auth-cache",
     "// refresh (the worker in prod, lazily on the dev server in dev).",
+    "// useOrganizationsAsGroups needs Organizations enabled on the Clerk instance and offers",
+    "// every organization in the instance as a group. In an AWS deployment the worker reads",
+    "// the setting from `clerkOrganizationsAsGroups` in the CDK stack, which governs there;",
+    "// keep the two equal.",
     "const authPlugin =",
     "  config.server.mode === 'prod' || process.env.CANOPY_AUTH_MODE === 'clerk'",
-    "    ? createClerkAuthPlugin({ useOrganizationsAsGroups: true })",
+    "    ? createClerkAuthPlugin({ useOrganizationsAsGroups: false })",
     "    : createDevAuthPlugin()"
   ].join("\n") : "const authPlugin = createDevAuthPlugin()";
   return template.replace("{{AUTH_IMPORTS}}", authImports).replace("{{AUTH_PLUGIN_SETUP}}", authPluginSetup).replace("{{CONFIG_IMPORT}}", options.configImport);

package/dist/cli/template-files/cms-stack.ts.template

@@ -172,6 +172,9 @@ export class CmsStack extends Stack {
       ].filter((arn): arn is string => arn !== undefined),
       githubTokenSecretArn: githubToken?.secretArn,
       clerkSecretKeySecretArn: clerkSecretKey.secretArn,
+      // Whether the worker maps Clerk Organizations onto Canopy groups. It needs Organizations
+      // enabled on the Clerk instance; keep it equal to useOrganizationsAsGroups in canopy.ts.
+      clerkOrganizationsAsGroups: false,
       // GitHub App auth, when configured instead of the token above. Undefined
       // unless the adopter set all three; CanopyCmsService refuses a partial
       // set, and refuses an App alongside githubTokenSecretArn.

package/dist/cli/templates.js

@@ -41,9 +41,13 @@ export async function canopyContext(options) {
             '// authenticated request instead of silently falling back to unauthenticated dev auth.',
             "// CLERK_SECRET_KEY is read only where Clerk's backend API is called: the auth-cache",
             '// refresh (the worker in prod, lazily on the dev server in dev).',
+            '// useOrganizationsAsGroups needs Organizations enabled on the Clerk instance and offers',
+            '// every organization in the instance as a group. In an AWS deployment the worker reads',
+            '// the setting from `clerkOrganizationsAsGroups` in the CDK stack, which governs there;',
+            '// keep the two equal.',
             'const authPlugin =',
             "  config.server.mode === 'prod' || process.env.CANOPY_AUTH_MODE === 'clerk'",
-            '    ? createClerkAuthPlugin({ useOrganizationsAsGroups: true })',
+            '    ? createClerkAuthPlugin({ useOrganizationsAsGroups: false })',
             '    : createDevAuthPlugin()',
         ].join('\n')
         : 'const authPlugin = createDevAuthPlugin()';

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();

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

@@ -33,6 +33,7 @@ export declare const imageFieldSchema: z.ZodObject<{
     list: z.ZodOptional<z.ZodBoolean>;
     isTitle: z.ZodOptional<z.ZodBoolean>;
     isBody: z.ZodOptional<z.ZodBoolean>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
 } & {
     type: z.ZodLiteral<"image">;
     aspect: z.ZodOptional<z.ZodString>;
@@ -46,6 +47,7 @@ export declare const imageFieldSchema: z.ZodObject<{
     list?: boolean | undefined;
     isTitle?: boolean | undefined;
     isBody?: boolean | undefined;
+    maxItems?: number | undefined;
     aspect?: string | undefined;
     altOptional?: boolean | undefined;
 }, {
@@ -57,9 +59,16 @@ export declare const imageFieldSchema: z.ZodObject<{
     list?: boolean | undefined;
     isTitle?: boolean | undefined;
     isBody?: boolean | undefined;
+    maxItems?: number | undefined;
     aspect?: string | undefined;
     altOptional?: boolean | undefined;
 }>;
+/**
+ * A dotted field path for `optionSort: { field }`: non-empty segments, so `'a..b'` and `'.a'`
+ * fail at config time rather than sorting on a value no entry has.
+ * @internal Exported for the reference-options endpoint, which validates `sortField` the same way.
+ */
+export declare const referenceSortFieldSchema: z.ZodString;
 /** @internal Exported for tests. */
 export declare const referenceFieldSchema: z.ZodObject<{
     name: z.ZodString;
@@ -69,6 +78,7 @@ export declare const referenceFieldSchema: z.ZodObject<{
     list: z.ZodOptional<z.ZodBoolean>;
     isTitle: z.ZodOptional<z.ZodBoolean>;
     isBody: z.ZodOptional<z.ZodBoolean>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
 } & {
     type: z.ZodLiteral<"reference">;
     collections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -85,6 +95,16 @@ export declare const referenceFieldSchema: z.ZodObject<{
         label: string;
     }>]>, "many">>;
     includeBody: z.ZodOptional<z.ZodBoolean>;
+    optionSort: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["label", "collection"]>, z.ZodObject<{
+        field: z.ZodString;
+        direction: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+    }, "strict", z.ZodTypeAny, {
+        field: string;
+        direction?: "asc" | "desc" | undefined;
+    }, {
+        field: string;
+        direction?: "asc" | "desc" | undefined;
+    }>]>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     type: "reference";
@@ -98,10 +118,15 @@ export declare const referenceFieldSchema: z.ZodObject<{
     list?: boolean | undefined;
     isTitle?: boolean | undefined;
     isBody?: boolean | undefined;
+    maxItems?: number | undefined;
     collections?: string[] | undefined;
     entryTypes?: string[] | undefined;
     displayField?: string | undefined;
     includeBody?: boolean | undefined;
+    optionSort?: "collection" | "label" | {
+        field: string;
+        direction?: "asc" | "desc" | undefined;
+    } | undefined;
 }, {
     name: string;
     type: "reference";
@@ -115,10 +140,15 @@ export declare const referenceFieldSchema: z.ZodObject<{
     list?: boolean | undefined;
     isTitle?: boolean | undefined;
     isBody?: boolean | undefined;
+    maxItems?: number | undefined;
     collections?: string[] | undefined;
     entryTypes?: string[] | undefined;
     displayField?: string | undefined;
     includeBody?: boolean | undefined;
+    optionSort?: "collection" | "label" | {
+        field: string;
+        direction?: "asc" | "desc" | undefined;
+    } | undefined;
 }>;
 export declare const blockSchema: z.ZodObject<{
     name: z.ZodString;

package/dist/config/schemas/field.js

@@ -12,6 +12,9 @@ const fieldBaseSchema = z.object({
     list: z.boolean().optional(),
     isTitle: 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(),
 });
 export const selectOptionSchema = z.union([
     z.string(),
@@ -94,6 +97,14 @@ const selectFieldSchema = fieldBaseSchema.extend({
     type: z.literal('select'),
     options: z.array(selectOptionSchema).min(1),
 });
+/**
+ * A dotted field path for `optionSort: { field }`: non-empty segments, so `'a..b'` and `'.a'`
+ * fail at config time rather than sorting on a value no entry has.
+ * @internal Exported for the reference-options endpoint, which validates `sortField` the same way.
+ */
+export const referenceSortFieldSchema = z
+    .string()
+    .regex(/^[^.]+(\.[^.]+)*$/, 'must be a field name or a dotted path such as "meta.publishedAt"');
 // At least one of `collections` or `entryTypes` must be specified (enforced by config validation).
 /** @internal Exported for tests. */
 export const referenceFieldSchema = fieldBaseSchema.extend({
@@ -107,6 +118,17 @@ export const referenceFieldSchema = fieldBaseSchema.extend({
     // 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(),
+    optionSort: z
+        .union([
+        z.enum(['label', 'collection']),
+        z
+            .object({
+            field: referenceSortFieldSchema,
+            direction: z.enum(['asc', 'desc']).optional(),
+        })
+            .strict(),
+    ])
+        .optional(),
 });
 // Use a mutable holder to enable forward references in recursive z.lazy() closures.
 // blockSchema/objectFieldSchema reference fieldHolder[0] via z.lazy, which is resolved