canopycms 0.0.67-int.90 → 0.0.67

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

@@ -2,31 +2,6 @@
  * Zod schemas for field configuration validation.
  */
 import { z } from 'zod';
-export declare const fieldBaseSchema: z.ZodObject<{
-    name: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    list: z.ZodOptional<z.ZodBoolean>;
-    isTitle: z.ZodOptional<z.ZodBoolean>;
-    isBody: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    description?: string | undefined;
-    label?: string | undefined;
-    required?: boolean | undefined;
-    list?: boolean | undefined;
-    isTitle?: boolean | undefined;
-    isBody?: boolean | undefined;
-}, {
-    name: string;
-    description?: string | undefined;
-    label?: string | undefined;
-    required?: boolean | undefined;
-    list?: boolean | undefined;
-    isTitle?: boolean | undefined;
-    isBody?: boolean | undefined;
-}>;
 export declare const selectOptionSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     label: z.ZodString;
     value: z.ZodString;
@@ -47,35 +22,6 @@ export declare const referenceOptionSchema: z.ZodUnion<[z.ZodString, z.ZodObject
     value: string;
     label: string;
 }>]>;
-export declare const primitiveFieldSchema: z.ZodObject<{
-    name: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    list: z.ZodOptional<z.ZodBoolean>;
-    isTitle: z.ZodOptional<z.ZodBoolean>;
-    isBody: z.ZodOptional<z.ZodBoolean>;
-} & {
-    type: z.ZodEnum<["string", "number", "boolean", "datetime", "markdown", "mdx", "code"]>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    type: "string" | "number" | "boolean" | "code" | "datetime" | "markdown" | "mdx";
-    description?: string | undefined;
-    label?: string | undefined;
-    required?: boolean | undefined;
-    list?: boolean | undefined;
-    isTitle?: boolean | undefined;
-    isBody?: boolean | undefined;
-}, {
-    name: string;
-    type: "string" | "number" | "boolean" | "code" | "datetime" | "markdown" | "mdx";
-    description?: string | undefined;
-    label?: string | undefined;
-    required?: boolean | undefined;
-    list?: boolean | undefined;
-    isTitle?: boolean | undefined;
-    isBody?: boolean | undefined;
-}>;
 export declare const imageFieldSchema: z.ZodObject<{
     name: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
@@ -111,53 +57,7 @@ export declare const imageFieldSchema: z.ZodObject<{
     aspect?: string | undefined;
     altOptional?: boolean | undefined;
 }>;
-export declare const selectFieldSchema: z.ZodObject<{
-    name: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    list: z.ZodOptional<z.ZodBoolean>;
-    isTitle: z.ZodOptional<z.ZodBoolean>;
-    isBody: z.ZodOptional<z.ZodBoolean>;
-} & {
-    type: z.ZodLiteral<"select">;
-    options: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
-        label: z.ZodString;
-        value: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        value: string;
-        label: string;
-    }, {
-        value: string;
-        label: string;
-    }>]>, "many">;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    options: (string | {
-        value: string;
-        label: string;
-    })[];
-    type: "select";
-    description?: string | undefined;
-    label?: string | undefined;
-    required?: boolean | undefined;
-    list?: boolean | undefined;
-    isTitle?: boolean | undefined;
-    isBody?: boolean | undefined;
-}, {
-    name: string;
-    options: (string | {
-        value: string;
-        label: string;
-    })[];
-    type: "select";
-    description?: string | undefined;
-    label?: string | undefined;
-    required?: boolean | undefined;
-    list?: boolean | undefined;
-    isTitle?: boolean | undefined;
-    isBody?: boolean | undefined;
-}>;
+/** @internal Exported for tests. */
 export declare const referenceFieldSchema: z.ZodObject<{
     name: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
@@ -233,145 +133,5 @@ export declare const blockSchema: z.ZodObject<{
     description?: string | undefined;
     label?: string | undefined;
 }>;
-export declare const blockFieldSchema: z.ZodObject<{
-    name: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    list: z.ZodOptional<z.ZodBoolean>;
-    isTitle: z.ZodOptional<z.ZodBoolean>;
-    isBody: z.ZodOptional<z.ZodBoolean>;
-} & {
-    type: z.ZodLiteral<"block">;
-    templates: z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        label: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
-        fields: z.ZodArray<z.ZodLazy<z.ZodTypeAny>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        fields: any[];
-        description?: string | undefined;
-        label?: string | undefined;
-    }, {
-        name: string;
-        fields: any[];
-        description?: string | undefined;
-        label?: string | undefined;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    type: "block";
-    templates: {
-        name: string;
-        fields: any[];
-        description?: string | undefined;
-        label?: string | undefined;
-    }[];
-    description?: string | undefined;
-    label?: string | undefined;
-    required?: boolean | undefined;
-    list?: boolean | undefined;
-    isTitle?: boolean | undefined;
-    isBody?: boolean | undefined;
-}, {
-    name: string;
-    type: "block";
-    templates: {
-        name: string;
-        fields: any[];
-        description?: string | undefined;
-        label?: string | undefined;
-    }[];
-    description?: string | undefined;
-    label?: string | undefined;
-    required?: boolean | undefined;
-    list?: boolean | undefined;
-    isTitle?: boolean | undefined;
-    isBody?: boolean | undefined;
-}>;
-export declare const objectFieldSchema: z.ZodObject<{
-    name: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    list: z.ZodOptional<z.ZodBoolean>;
-    isTitle: z.ZodOptional<z.ZodBoolean>;
-    isBody: z.ZodOptional<z.ZodBoolean>;
-} & {
-    type: z.ZodLiteral<"object">;
-    fields: z.ZodArray<z.ZodLazy<z.ZodTypeAny>, "many">;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    type: "object";
-    fields: any[];
-    description?: string | undefined;
-    label?: string | undefined;
-    required?: boolean | undefined;
-    list?: boolean | undefined;
-    isTitle?: boolean | undefined;
-    isBody?: boolean | undefined;
-}, {
-    name: string;
-    type: "object";
-    fields: any[];
-    description?: string | undefined;
-    label?: string | undefined;
-    required?: boolean | undefined;
-    list?: boolean | undefined;
-    isTitle?: boolean | undefined;
-    isBody?: boolean | undefined;
-}>;
-export declare const inlineGroupFieldSchema: z.ZodObject<{
-    type: z.ZodLiteral<"group">;
-    name: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    fields: z.ZodArray<z.ZodLazy<z.ZodTypeAny>, "many">;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    type: "group";
-    fields: any[];
-    description?: string | undefined;
-    label?: string | undefined;
-}, {
-    name: string;
-    type: "group";
-    fields: any[];
-    description?: string | undefined;
-    label?: string | undefined;
-}>;
-export declare const customFieldSchema: z.ZodLazy<z.ZodObject<{
-    name: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    list: z.ZodOptional<z.ZodBoolean>;
-    isTitle: z.ZodOptional<z.ZodBoolean>;
-    isBody: z.ZodOptional<z.ZodBoolean>;
-} & {
-    type: z.ZodEffects<z.ZodString, string, string>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    name: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    list: z.ZodOptional<z.ZodBoolean>;
-    isTitle: z.ZodOptional<z.ZodBoolean>;
-    isBody: z.ZodOptional<z.ZodBoolean>;
-} & {
-    type: z.ZodEffects<z.ZodString, string, string>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    name: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    list: z.ZodOptional<z.ZodBoolean>;
-    isTitle: z.ZodOptional<z.ZodBoolean>;
-    isBody: z.ZodOptional<z.ZodBoolean>;
-} & {
-    type: z.ZodEffects<z.ZodString, string, string>;
-}, z.ZodTypeAny, "passthrough">>>;
-declare const knownFieldSchema: z.ZodTypeAny;
 declare const fieldSchema: z.ZodTypeAny;
-export { fieldSchema, knownFieldSchema };
+export { fieldSchema };

package/dist/config/schemas/field.js

@@ -3,8 +3,7 @@
  */
 import { z } from 'zod';
 import { primitiveFieldTypes, fieldTypes } from '../types.js';
-// Base field schema - shared properties
-export const fieldBaseSchema = z.object({
+const fieldBaseSchema = z.object({
     name: z.string().min(1),
     label: z.string().optional(),
     description: z.string().optional(),
@@ -13,7 +12,6 @@ export const fieldBaseSchema = z.object({
     isTitle: z.boolean().optional(),
     isBody: z.boolean().optional(),
 });
-// Select option schema
 export const selectOptionSchema = z.union([
     z.string(),
     z.object({
@@ -21,7 +19,6 @@ export const selectOptionSchema = z.union([
         value: z.string().min(1),
     }),
 ]);
-// Reference option schema
 export const referenceOptionSchema = z.union([
     z.string(),
     z.object({
@@ -29,8 +26,7 @@ export const referenceOptionSchema = z.union([
         value: z.string().min(1),
     }),
 ]);
-// Primitive field (string, number, boolean, etc.)
-export const primitiveFieldSchema = fieldBaseSchema.extend({
+const primitiveFieldSchema = fieldBaseSchema.extend({
     type: z.enum(primitiveFieldTypes),
 });
 // "W:H" aspect ratio, e.g. "16:9" or "1:1" — positive integers on both sides,
@@ -50,13 +46,12 @@ export const imageFieldSchema = fieldBaseSchema.extend({
         .optional(),
     altOptional: z.boolean().optional(),
 });
-// Select field with options
-export const selectFieldSchema = fieldBaseSchema.extend({
+const selectFieldSchema = fieldBaseSchema.extend({
     type: z.literal('select'),
     options: z.array(selectOptionSchema).min(1),
 });
-// Reference field pointing to other collections and/or entry types.
 // At least one of `collections` or `entryTypes` must be specified (enforced by config validation).
+/** @internal Exported for tests. */
 export const referenceFieldSchema = fieldBaseSchema.extend({
     type: z.literal('reference'),
     collections: z.array(z.string().min(1)).min(1).optional(),
@@ -73,33 +68,29 @@ export const referenceFieldSchema = fieldBaseSchema.extend({
 // blockSchema/objectFieldSchema reference fieldHolder[0] via z.lazy, which is resolved
 // after the full fieldSchema is constructed below.
 const fieldHolder = [z.never()];
-// Block template schema
 export const blockSchema = z.object({
     name: z.string().min(1),
     label: z.string().optional(),
     description: z.string().optional(),
     fields: z.array(z.lazy(() => fieldHolder[0])).min(1),
 });
-// Block field with templates
-export const blockFieldSchema = fieldBaseSchema.extend({
+const blockFieldSchema = fieldBaseSchema.extend({
     type: z.literal('block'),
     templates: z.array(blockSchema).min(1),
 });
-// Object field with nested fields
-export const objectFieldSchema = fieldBaseSchema.extend({
+const objectFieldSchema = fieldBaseSchema.extend({
     type: z.literal('object'),
     fields: z.array(z.lazy(() => fieldHolder[0])).min(1),
 });
 // Inline group field: visual grouping only, no data nesting
-export const inlineGroupFieldSchema = z.object({
+const inlineGroupFieldSchema = z.object({
     type: z.literal('group'),
     name: z.string().min(1),
     label: z.string().optional(),
     description: z.string().optional(),
     fields: z.array(z.lazy(() => fieldHolder[0])).min(1),
 });
-// Custom field (user-defined type)
-export const customFieldSchema = z.lazy(() => fieldBaseSchema
+const customFieldSchema = z.lazy(() => fieldBaseSchema
     .extend({
     type: z
         .string()
@@ -109,7 +100,6 @@ export const customFieldSchema = z.lazy(() => fieldBaseSchema
     }),
 })
     .passthrough());
-// Known built-in field types (discriminated union)
 const knownFieldSchema = z.discriminatedUnion('type', [
     primitiveFieldSchema,
     selectFieldSchema,
@@ -119,7 +109,6 @@ const knownFieldSchema = z.discriminatedUnion('type', [
     blockFieldSchema,
     inlineGroupFieldSchema,
 ]);
-// Complete field schema (built-in or custom)
 const fieldSchema = z.lazy(() => z.union([knownFieldSchema, customFieldSchema]));
 fieldHolder[0] = fieldSchema;
-export { fieldSchema, knownFieldSchema };
+export { fieldSchema };

package/dist/config/schemas/media.js

@@ -14,7 +14,7 @@ import { assetMountUrlSchema, uploadTargetUrlSchema } from './url.js';
 //
 // Bucket-prefix layout (asset-originals/, asset-staging/, asset-meta/, assets/) is
 // intentionally NOT configurable here — those are constants in assets/keys.ts, not
-// per-site config (see .claude/future-tasks/assets-media-system.md).
+// per-site config (see .claude/future-tasks/resolved/assets-media-system.md).
 //
 // Every branch is .strict(). This is load-bearing, not tidiness: CanopyConfigSchema's own
 // .strict() does NOT recurse into nested schemas, so until these branches carried their own,

package/dist/config/schemas/permissions.js

@@ -2,12 +2,10 @@
  * Zod schemas for permission configuration validation.
  */
 import { z } from 'zod';
-// Permission target schema
 export const permissionTargetSchema = z.object({
     allowedUsers: z.array(z.string()).optional(),
     allowedGroups: z.array(z.string()).optional(),
 });
-// Path permission schema
 export const pathPermissionSchema = z.object({
     path: z.string().min(1),
     read: permissionTargetSchema.optional(),

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

@@ -28,11 +28,10 @@ export declare const uploadTargetUrlSchema: z.ZodEffects<z.ZodString, string, st
 /**
  * Where `/assets/…` is mounted for the editor's own previews (`media.publicBaseUrl`).
  *
- * Two changes from the `z.string().url()` this replaced, both deliberate. It now accepts a
- * site-relative path, which is what `.claude/future-tasks/editor-asset-mount-topology.md`
- * option 1 asks for — the absolute-only constraint was a validation choice, and the `basePath`
- * fallback in `editor/context/AssetContext.tsx` exists only to work around it. And it now
- * rejects non-http(s) schemes, which `z.string().url()` accepted: `publicBaseUrl: 'mailto:a@b.c'`
- * used to parse and then produce `/mailto:a@b.c/assets/…` at render time.
+ * Accepts an absolute http(s) URL, a protocol-relative `//host` URL, or a site-relative path
+ * (see `.claude/future-tasks/editor-asset-mount-topology.md` option 1 — the `basePath` fallback
+ * in `editor/context/AssetContext.tsx` exists for sites that need one and can't set an absolute
+ * value). Rejects non-http(s) schemes: a plain `z.string().url()` check would accept
+ * `publicBaseUrl: 'mailto:a@b.c'` and produce `/mailto:a@b.c/assets/…` at render time.
  */
 export declare const assetMountUrlSchema: z.ZodEffects<z.ZodString, string, string>;

package/dist/config/schemas/url.js

@@ -34,12 +34,11 @@ export const uploadTargetUrlSchema = z
 /**
  * Where `/assets/…` is mounted for the editor's own previews (`media.publicBaseUrl`).
  *
- * Two changes from the `z.string().url()` this replaced, both deliberate. It now accepts a
- * site-relative path, which is what `.claude/future-tasks/editor-asset-mount-topology.md`
- * option 1 asks for — the absolute-only constraint was a validation choice, and the `basePath`
- * fallback in `editor/context/AssetContext.tsx` exists only to work around it. And it now
- * rejects non-http(s) schemes, which `z.string().url()` accepted: `publicBaseUrl: 'mailto:a@b.c'`
- * used to parse and then produce `/mailto:a@b.c/assets/…` at render time.
+ * Accepts an absolute http(s) URL, a protocol-relative `//host` URL, or a site-relative path
+ * (see `.claude/future-tasks/editor-asset-mount-topology.md` option 1 — the `basePath` fallback
+ * in `editor/context/AssetContext.tsx` exists for sites that need one and can't set an absolute
+ * value). Rejects non-http(s) schemes: a plain `z.string().url()` check would accept
+ * `publicBaseUrl: 'mailto:a@b.c'` and produce `/mailto:a@b.c/assets/…` at render time.
  */
 export const assetMountUrlSchema = z
     .string()

package/dist/config/types.d.ts

@@ -34,7 +34,7 @@ export type ReferenceOption = string | {
     label: string;
     value: string;
 };
-export interface BaseFieldConfig {
+interface BaseFieldConfig {
     name: string;
     label?: string;
     description?: string;
@@ -50,7 +50,7 @@ export interface BaseFieldConfig {
      */
     isBody?: boolean;
 }
-export interface PrimitiveFieldConfig extends BaseFieldConfig {
+interface PrimitiveFieldConfig extends BaseFieldConfig {
     type: PrimitiveFieldType;
 }
 export interface SelectFieldConfig extends BaseFieldConfig {
@@ -234,6 +234,19 @@ export type RootCollectionConfig = {
  * Contrast with EntrySchema, which is the field definitions for a single entry type.
  */
 export type BranchSchema = RootCollectionConfig;
+/**
+ * Props for an auth provider's `SignInComponent`. The editor decides signed-out from the API's
+ * 401s alone; the provider owns the sign-in UI and reports back.
+ */
+export interface EditorSignInProps {
+    /** Call when the provider believes the user is signed in; the editor re-checks with the API. */
+    onSignedIn: () => void;
+    /**
+     * The API rejected the credential after `onSignedIn` (e.g. a mismatched JWT key). Offer
+     * sign-out; calling `onSignedIn` again in response would loop.
+     */
+    sessionRejected: boolean;
+}
 export interface CanopyEditorConfig {
     title?: string;
     subtitle?: string;
@@ -251,6 +264,11 @@ export interface CanopyEditorConfig {
     onAccountClick?: () => void;
     onLogoutClick?: () => void;
     AccountComponent?: React.ComponentType;
+    /**
+     * Shown instead of the editor on a 401, and over it when a session lapses mid-edit. Supplied
+     * by the auth provider; absent, the editor shows a plain notice.
+     */
+    SignInComponent?: React.ComponentType<EditorSignInProps>;
 }
 export type DefaultBranchAccess = 'allow' | 'deny';
 export type DefaultPathAccessLevel = 'allow' | 'deny';
@@ -273,7 +291,7 @@ export type GithubTokenEnvVar = string;
 export type CanopyOperatingMode = OperatingMode;
 export type ContentRoot = string;
 export type SourceRoot = string | undefined;
-export type DeployedAs = 'static' | 'server';
+type DeployedAs = 'static' | 'server';
 /**
  * How the dev server surfaces working-tree content edits that diverge from the branch clone it serves.
  * - 'warn' (default): on startup and on content/** changes, log a warning naming files when the
@@ -286,7 +304,7 @@ export type DeployedAs = 'static' | 'server';
  */
 export type DevContentSyncMode = 'off' | 'warn';
 /** Dev-mode-only behavior. Ignored when `mode !== 'dev'`. */
-export interface DevConfig {
+interface DevConfig {
     contentSync?: DevContentSyncMode;
 }
 /** Issue returned by the `validateEntry` hook. `error` rejects the save; `warning` is returned with it. */
@@ -322,7 +340,7 @@ export interface CanopyConfig {
     defaultBranchAccess?: DefaultBranchAccess;
     defaultPathAccess?: DefaultPathAccess;
     defaultBaseBranch?: DefaultBaseBranch;
-    /** Which workspace to serve content from by default. Auto-detected from git HEAD in dev mode. */
+    /** Which workspace to serve content from by default — see {@link CanopyConfigInput.defaultActiveBranch}. */
     defaultActiveBranch?: string;
     defaultRemoteName?: DefaultRemoteName;
     defaultRemoteUrl?: DefaultRemoteUrl;
@@ -330,45 +348,24 @@ export interface CanopyConfig {
     gitBotAuthorEmail: GitBotAuthorEmail;
     githubTokenEnvVar?: GithubTokenEnvVar;
     mode: CanopyOperatingMode;
-    /** How this build is deployed. 'static' = no request context, no auth. Default: 'server'. */
+    /** How this build is deployed — see {@link CanopyConfigInput.deployedAs}. */
     deployedAs: DeployedAs;
-    /**
-     * Escape hatch: allow git operations in prod mode to target a NETWORK remote
-     * (http(s)://, ssh://, git://, or scp-like `user@host:path`) instead of the
-     * EFS-local `remote.git` the standard AWS Lambda+worker topology expects.
-     * Default false/unset. The standard topology's Lambda has no internet access
-     * and would hang trying to reach a network remote directly — only set this
-     * for prod hosts that DO have internet (e.g. a single-VM deployment) and
-     * intentionally run git against a network remote.
-     */
+    /** Escape hatch for a prod host with real internet access — see {@link CanopyConfigInput.allowNetworkRemoteInProd}. */
     allowNetworkRemoteInProd?: boolean;
     settingsBranch?: string;
     autoCreateSettingsPR?: boolean;
     deploymentName?: string;
     contentRoot: ContentRoot;
     sourceRoot?: SourceRoot;
-    /**
-     * The deployment prefix the host Next.js app is served under (e.g. `/preview-123`), matching
-     * that app's `next.config` `basePath`. CanopyCMS cannot read `next.config` at runtime, so this
-     * must be stated here explicitly if the app sets one — without it, editor requests, the preview
-     * iframe `src`, and preview↔editor path matching all target the un-prefixed root and 404 or
-     * silently stop syncing. Normalized (leading slash added, trailing slashes stripped) via
-     * `joinUrlPrefix` at every use site; unset/empty means the app is served at its origin's root.
-     *
-     * NOT the same option as `collectStaticParams`'s `basePath` in
-     * `packages/canopycms-next/src/static.ts` — that one means "the route prefix of a nested
-     * catch-all route" (e.g. `/docs` for `app/docs/[[...slug]]`) and *filters* enumerated entries
-     * down to that prefix. Passing this deployment basePath to `collectStaticParams` instead would
-     * silently filter out every entry (zero static params, a build that goes green with no pages).
-     */
+    /** Deployment prefix the host app is served under — see {@link CanopyConfigInput.basePath}. */
     basePath?: string;
     editor?: CanopyEditorConfig;
     authPlugin?: AuthPlugin;
-    /** Custom URL resolver for entry links. Overrides the default URL computation. */
+    /** Custom URL resolver for entry links — see {@link CanopyConfigInput.entryLinkUrl}. */
     entryLinkUrl?: EntryLinkUrlResolver;
-    /** Save-time validation hook. 'error' issues reject the save; 'warning' issues are returned with it. */
+    /** Save-time validation hook — see {@link CanopyConfigInput.validateEntry}. */
     validateEntry?: ValidateEntryHook;
-    /** Dev-mode-only behavior (content-sync divergence detection). Ignored when mode !== 'dev'. */
+    /** Dev-mode-only behavior — see {@link CanopyConfigInput.dev}. */
     dev?: DevConfig;
 }
 /**
@@ -409,7 +406,20 @@ export interface CanopyConfigInput {
     deploymentName?: string;
     contentRoot?: string;
     sourceRoot?: string;
-    /** See `CanopyConfig.basePath` — the deployment prefix the host Next.js app is served under. */
+    /**
+     * The deployment prefix the host Next.js app is served under (e.g. `/preview-123`), matching
+     * that app's `next.config` `basePath`. CanopyCMS cannot read `next.config` at runtime, so this
+     * must be stated here explicitly if the app sets one — without it, editor requests, the preview
+     * iframe `src`, and preview↔editor path matching all target the un-prefixed root and 404 or
+     * silently stop syncing. Normalized (leading slash added, trailing slashes stripped) via
+     * `joinUrlPrefix` at every use site; unset/empty means the app is served at its origin's root.
+     *
+     * NOT the same option as `collectStaticParams`'s `basePath` in
+     * `packages/canopycms-next/src/static.ts` — that one means "the route prefix of a nested
+     * catch-all route" (e.g. `/docs` for `app/docs/[[...slug]]`) and *filters* enumerated entries
+     * down to that prefix. Passing this deployment basePath to `collectStaticParams` instead would
+     * silently filter out every entry (zero static params, a build that goes green with no pages).
+     */
     basePath?: string;
     editor?: CanopyEditorConfig;
     authPlugin?: AuthPlugin;
@@ -478,5 +488,7 @@ export interface ClientOnlyFields {
         onAccountClick?: () => void;
         onLogoutClick?: () => void | Promise<void>;
         AccountComponent?: React.ComponentType;
+        SignInComponent?: React.ComponentType<EditorSignInProps>;
     };
 }
+export {};

package/dist/config/types.js

@@ -2,7 +2,6 @@
  * Type definitions for CanopyCMS configuration.
  * These are pure TypeScript types - Zod schemas are in ./schemas/
  */
-// Field types
 export const primitiveFieldTypes = [
     'string',
     'number',

package/dist/config.d.ts

@@ -1,9 +1,2 @@
-/**
- * CanopyCMS Configuration
- *
- * This file re-exports from the config module for backward compatibility.
- * New code should import directly from './config/index.js' or './config'.
- *
- * @module config
- */
+/** Barrel re-export of the config module (`./config/index`). */
 export * from './config/index.js';

package/dist/config.js

@@ -1,10 +1,2 @@
-/**
- * CanopyCMS Configuration
- *
- * This file re-exports from the config module for backward compatibility.
- * New code should import directly from './config/index.js' or './config'.
- *
- * @module config
- */
-// Re-export everything from the config module
+/** Barrel re-export of the config module (`./config/index`). */
 export * from './config/index.js';