@agntcms/next 0.2.0

package/dist/config.cjs

@@ -0,0 +1,240 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/_config.ts
+var config_exports = {};
+__export(config_exports, {
+  BooleanField: () => BooleanField,
+  ButtonField: () => ButtonField,
+  DuplicateFormNameError: () => DuplicateFormNameError,
+  FormOverridesField: () => FormOverridesField,
+  HoneypotCollisionError: () => HoneypotCollisionError,
+  ImageField: () => ImageField,
+  InvalidFormFieldError: () => InvalidFormFieldError,
+  InvalidFormNameError: () => InvalidFormNameError,
+  LinkField: () => LinkField,
+  ListField: () => ListField,
+  NumberField: () => NumberField,
+  ReferenceField: () => ReferenceField,
+  RichTextField: () => RichTextField,
+  SelectField: () => SelectField,
+  SubmissionsNotReadableError: () => SubmissionsNotReadableError,
+  TextField: () => TextField,
+  VideoField: () => VideoField,
+  defineConfig: () => defineConfig,
+  defineForm: () => defineForm,
+  withagntcms: () => withagntcms
+});
+module.exports = __toCommonJS(config_exports);
+
+// src/config/defaults-registry.ts
+var SLOT = /* @__PURE__ */ Symbol.for("@agntcms/next/default-adapter-factories");
+function holder() {
+  return globalThis;
+}
+function getDefaultAdapterFactories(requested) {
+  const f = holder()[SLOT];
+  if (f === void 0) {
+    throw new Error(
+      `[agntcms] defineConfig: cannot fill the default ${requested} adapter because the server-only adapter factories were never registered. Import \`@agntcms/next/server\` (or \`@agntcms/next/handlers\`) before evaluating \`agntcms/config.ts\`, or pass an explicit adapter to \`defineConfig({ contentAdapter, assetAdapter, submissionAdapter })\`.`
+    );
+  }
+  return f;
+}
+
+// src/config/defineConfig.ts
+function defineConfig(config) {
+  if (config.sections.length === 0) {
+    console.warn(
+      "[agntcms] defineConfig: `sections` array is empty. No sections will be available for rendering."
+    );
+  }
+  const contentAdapter = config.contentAdapter ?? getDefaultAdapterFactories("content").content();
+  const assetAdapter = config.assetAdapter ?? getDefaultAdapterFactories("asset").asset();
+  const submissionAdapter = config.submissionAdapter ?? getDefaultAdapterFactories("submission").submission();
+  return {
+    sections: config.sections,
+    contentAdapter,
+    assetAdapter,
+    templates: config.templates ?? [],
+    forms: config.forms ?? [],
+    submissionAdapter,
+    submissionRateLimit: config.submissionRateLimit ?? { perMinute: 5 }
+  };
+}
+
+// src/config/withagntcms.ts
+function withagntcms(nextConfig) {
+  return {
+    ...nextConfig,
+    output: "standalone"
+  };
+}
+
+// src/domain/form.ts
+var FORM_FORBIDDEN_KINDS = /* @__PURE__ */ new Set([
+  "image",
+  "video",
+  "reference",
+  "list",
+  // `formOverrides` is a section-only descriptor (it overrides another
+  // form schema instance). Putting it inside a form would mean a form's
+  // payload could carry overrides for itself or another form — a
+  // recursive shape with no ergonomic editor UI. Section-only by design.
+  "formOverrides",
+  // `button` is a section-only descriptor: a styled CTA with an
+  // optional link. Public-form payloads collect user input — a button
+  // value is authored content, not a submitted answer. Section-only
+  // by design (mirrors `formOverrides`).
+  "button"
+]);
+var SubmissionsNotReadableError = class extends Error {
+  constructor(message = "submission adapter does not support reading") {
+    super(message);
+    this.name = "SubmissionsNotReadableError";
+  }
+};
+
+// src/forms/defineForm.ts
+var InvalidFormFieldError = class extends Error {
+  formName;
+  fieldName;
+  fieldKind;
+  constructor(formName, fieldName, fieldKind) {
+    super(
+      `Form "${formName}": field "${fieldName}" uses kind "${fieldKind}", which is not allowed in a form schema in v1. Allowed kinds: text, richText, number, boolean, select, link. Forbidden kinds: image, reference, list, formOverrides. See ARCHITECTURE.md \xA76.5.`
+    );
+    this.name = "InvalidFormFieldError";
+    this.formName = formName;
+    this.fieldName = fieldName;
+    this.fieldKind = fieldKind;
+  }
+};
+var HoneypotCollisionError = class extends Error {
+  formName;
+  fieldName;
+  reason;
+  constructor(formName, fieldName, reason = "collision") {
+    super(
+      reason === "empty" ? `Form "${formName}": honeypot name must be a non-empty string.` : `Form "${formName}": honeypot name "${fieldName}" collides with a real field. Choose a honeypot name that does not appear in the schema.`
+    );
+    this.name = "HoneypotCollisionError";
+    this.formName = formName;
+    this.fieldName = fieldName;
+    this.reason = reason;
+  }
+};
+var InvalidFormNameError = class extends Error {
+  constructor(name) {
+    super(
+      `Invalid form name ${JSON.stringify(name)}. Use letters, digits, hyphen, and underscore only (no path separators).`
+    );
+    this.name = "InvalidFormNameError";
+  }
+};
+var FORM_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
+function defineForm(input) {
+  if (typeof input.name !== "string" || !FORM_NAME_PATTERN.test(input.name)) {
+    throw new InvalidFormNameError(input.name);
+  }
+  for (const [fieldName, descriptor] of Object.entries(input.schema)) {
+    const kind = descriptor.kind;
+    if (FORM_FORBIDDEN_KINDS.has(kind)) {
+      throw new InvalidFormFieldError(input.name, fieldName, kind);
+    }
+  }
+  if (input.honeypot !== void 0) {
+    if (typeof input.honeypot !== "string" || input.honeypot === "") {
+      throw new HoneypotCollisionError(input.name, input.honeypot, "empty");
+    }
+    if (Object.prototype.hasOwnProperty.call(input.schema, input.honeypot)) {
+      throw new HoneypotCollisionError(input.name, input.honeypot, "collision");
+    }
+  }
+  return input.honeypot !== void 0 ? { name: input.name, schema: input.schema, honeypot: input.honeypot } : { name: input.name, schema: input.schema };
+}
+
+// src/forms/registry.ts
+var DuplicateFormNameError = class extends Error {
+  formName;
+  constructor(name) {
+    super(
+      `Form name "${name}" is registered more than once. Form names must be unique within a config.`
+    );
+    this.name = "DuplicateFormNameError";
+    this.formName = name;
+  }
+};
+
+// src/domain/fields.ts
+var TextField = { kind: "text" };
+var RichTextField = { kind: "richText" };
+var ImageField = { kind: "image" };
+var VideoField = { kind: "video" };
+var ReferenceField = { kind: "reference" };
+var LinkField = { kind: "link" };
+var NumberField = { kind: "number" };
+var BooleanField = { kind: "boolean" };
+var SelectField = (options, opts) => ({
+  kind: "select",
+  options,
+  ...opts?.default !== void 0 ? { default: opts.default } : {}
+});
+var ButtonField = (variants, opts) => ({
+  kind: "button",
+  variants,
+  ...opts?.default !== void 0 ? { default: opts.default } : {}
+});
+var ListField = (itemSchema, opts) => ({
+  kind: "list",
+  itemSchema,
+  ...opts?.min !== void 0 ? { min: opts.min } : {},
+  ...opts?.max !== void 0 ? { max: opts.max } : {},
+  ...opts?.default !== void 0 ? { default: opts.default } : {}
+});
+
+// src/domain/formOverrides.ts
+var FormOverridesField = (formName, opts) => ({
+  kind: "formOverrides",
+  formName,
+  ...opts?.default !== void 0 ? { default: opts.default } : {}
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BooleanField,
+  ButtonField,
+  DuplicateFormNameError,
+  FormOverridesField,
+  HoneypotCollisionError,
+  ImageField,
+  InvalidFormFieldError,
+  InvalidFormNameError,
+  LinkField,
+  ListField,
+  NumberField,
+  ReferenceField,
+  RichTextField,
+  SelectField,
+  SubmissionsNotReadableError,
+  TextField,
+  VideoField,
+  defineConfig,
+  defineForm,
+  withagntcms
+});

package/dist/config.d.cts

@@ -0,0 +1,112 @@
+import { A as AnyFormDefinition, o as SubmissionStorageAdapter } from './form-BqY0H1V5.cjs';
+export { j as BooleanField, B as ButtonField, b as FormDefinition, p as FormFieldDescriptor, q as FormFieldOverride, n as FormFieldOverrides, r as FormOverridesField, m as FormOverridesFieldDescriptor, a as FormSchema, I as ImageField, L as LinkField, l as ListField, N as NumberField, f as ReferenceField, R as RichTextField, k as SelectField, s as Submission, t as SubmissionAdapterInfo, u as SubmissionSummary, v as SubmissionsNotReadableError, T as TextField, V as VideoField } from './form-BqY0H1V5.cjs';
+import { A as AnySectionDefinition } from './defineSection-9qQ5ulAH.cjs';
+import { C as ContentStorageAdapter, A as AssetStorageAdapter } from './assets-Cyt9upqW.cjs';
+export { D as DefineFormInput, H as HoneypotCollisionError, I as InvalidFormFieldError, a as InvalidFormNameError, d as defineForm } from './defineForm-CJ8KZC93.cjs';
+export { D as DuplicateFormNameError } from './registry-CraTTwT7.cjs';
+import './global-CV23g5Bn.cjs';
+
+/**
+ * A named preset that pre-fills sections when creating a new page.
+ *
+ * Templates are a config-level concept only — after creation, the page is a
+ * normal page with no template constraints. The `sectionTypes` array
+ * references section names from the registered `sections` list; unknown
+ * names are silently skipped at list time.
+ */
+interface PageTemplate {
+    readonly name: string;
+    readonly description?: string;
+    /** Ordered list of section type names to pre-fill. */
+    readonly sectionTypes: readonly string[];
+}
+/**
+ * Submission rate-limit configuration knob (ARCHITECTURE.md §6.5).
+ *
+ * Single field on purpose — multiplexing perWindow/windowMs/strategy into
+ * a struct here would invite YAGNI bikeshedding. The window is fixed at
+ * 60 seconds in v1; only the per-window count is user-tunable.
+ */
+interface SubmissionRateLimit {
+    /** Max submissions per minute per (IP, form) pair. Default: 5. */
+    readonly perMinute: number;
+}
+/**
+ * User-facing configuration shape passed to `defineConfig`.
+ *
+ * `sections` is required and must contain at least one definition.
+ * Adapters are optional — when omitted, the default FS adapters are used
+ * with the canonical template paths.
+ */
+interface AgentCmsConfig {
+    /** Registered section definitions. Order does not matter. */
+    readonly sections: readonly AnySectionDefinition[];
+    /** Content storage adapter. Defaults to FS adapter with standard paths. */
+    readonly contentAdapter?: ContentStorageAdapter;
+    /** Asset storage adapter. Defaults to FS adapter with standard paths. */
+    readonly assetAdapter?: AssetStorageAdapter;
+    /** Page creation templates. Optional — defaults to [] (blank pages only). */
+    readonly templates?: readonly PageTemplate[];
+    /**
+     * Registered form definitions (ARCHITECTURE.md §6.5). Optional — when
+     * omitted, no forms are registered and the submit handler returns 404
+     * for every form name.
+     */
+    readonly forms?: readonly AnyFormDefinition[];
+    /**
+     * Submission storage adapter. Defaults to the FS adapter rooted at
+     * `<projectRoot>/content/submissions`. Use `createWebhookSubmissionAdapter`
+     * (or a custom implementation) to send submissions to an external service.
+     */
+    readonly submissionAdapter?: SubmissionStorageAdapter;
+    /**
+     * Rate-limit knob for the submit endpoint. Defaults to `{ perMinute: 5 }`.
+     * The window is always 60 seconds in v1 — only the count is user-tunable.
+     */
+    readonly submissionRateLimit?: SubmissionRateLimit;
+}
+/**
+ * Fully-resolved configuration with all defaults filled in.
+ * Downstream code (runtime factory, handlers) can depend on every
+ * field being present.
+ */
+interface ResolvedConfig {
+    readonly sections: readonly AnySectionDefinition[];
+    readonly contentAdapter: ContentStorageAdapter;
+    readonly assetAdapter: AssetStorageAdapter;
+    /** Page creation templates. Always present (defaults to []). */
+    readonly templates: readonly PageTemplate[];
+    /** Registered forms. Always present (defaults to []). */
+    readonly forms: readonly AnyFormDefinition[];
+    /** Submission storage adapter. Always present. */
+    readonly submissionAdapter: SubmissionStorageAdapter;
+    /** Resolved rate-limit knob. Always present. */
+    readonly submissionRateLimit: SubmissionRateLimit;
+}
+/**
+ * Resolve a user config into a fully-populated config with defaults.
+ *
+ * Default adapters:
+ *   - content: `createFsContentAdapter({ contentRoot: process.cwd() + '/content' })`
+ *   - asset: `createFsAssetAdapter({ assetsRoot: process.cwd() + '/public/assets', publicUrlBase: '/assets' })`
+ *
+ * Validates that `sections` is non-empty (warns in dev, does not throw)
+ * so that a misconfigured template gets a visible signal rather than
+ * silent emptiness at render time.
+ */
+declare function defineConfig(config: AgentCmsConfig): ResolvedConfig;
+
+/**
+ * Wrap a Next.js configuration object for agntcms.
+ *
+ * Sets `output: 'standalone'` so the production Docker build
+ * (which copies `.next/standalone/`) works out of the box.
+ *
+ * In future versions this may also configure webpack aliases,
+ * image optimization domains, or framework-level middleware.
+ */
+declare function withagntcms<T extends Record<string, unknown>>(nextConfig: T): T & {
+    output: 'standalone';
+};
+
+export { type AgentCmsConfig, AnyFormDefinition, type PageTemplate, type ResolvedConfig, type SubmissionRateLimit, SubmissionStorageAdapter, defineConfig, withagntcms };

package/dist/config.d.ts

@@ -0,0 +1,112 @@
+import { A as AnyFormDefinition, o as SubmissionStorageAdapter } from './form-BqY0H1V5.js';
+export { j as BooleanField, B as ButtonField, b as FormDefinition, p as FormFieldDescriptor, q as FormFieldOverride, n as FormFieldOverrides, r as FormOverridesField, m as FormOverridesFieldDescriptor, a as FormSchema, I as ImageField, L as LinkField, l as ListField, N as NumberField, f as ReferenceField, R as RichTextField, k as SelectField, s as Submission, t as SubmissionAdapterInfo, u as SubmissionSummary, v as SubmissionsNotReadableError, T as TextField, V as VideoField } from './form-BqY0H1V5.js';
+import { A as AnySectionDefinition } from './defineSection-Kr0pWqMY.js';
+import { C as ContentStorageAdapter, A as AssetStorageAdapter } from './assets-P8OCigDG.js';
+export { D as DefineFormInput, H as HoneypotCollisionError, I as InvalidFormFieldError, a as InvalidFormNameError, d as defineForm } from './defineForm-Bp9vzW56.js';
+export { D as DuplicateFormNameError } from './registry-DMujGqt0.js';
+import './global-CV23g5Bn.js';
+
+/**
+ * A named preset that pre-fills sections when creating a new page.
+ *
+ * Templates are a config-level concept only — after creation, the page is a
+ * normal page with no template constraints. The `sectionTypes` array
+ * references section names from the registered `sections` list; unknown
+ * names are silently skipped at list time.
+ */
+interface PageTemplate {
+    readonly name: string;
+    readonly description?: string;
+    /** Ordered list of section type names to pre-fill. */
+    readonly sectionTypes: readonly string[];
+}
+/**
+ * Submission rate-limit configuration knob (ARCHITECTURE.md §6.5).
+ *
+ * Single field on purpose — multiplexing perWindow/windowMs/strategy into
+ * a struct here would invite YAGNI bikeshedding. The window is fixed at
+ * 60 seconds in v1; only the per-window count is user-tunable.
+ */
+interface SubmissionRateLimit {
+    /** Max submissions per minute per (IP, form) pair. Default: 5. */
+    readonly perMinute: number;
+}
+/**
+ * User-facing configuration shape passed to `defineConfig`.
+ *
+ * `sections` is required and must contain at least one definition.
+ * Adapters are optional — when omitted, the default FS adapters are used
+ * with the canonical template paths.
+ */
+interface AgentCmsConfig {
+    /** Registered section definitions. Order does not matter. */
+    readonly sections: readonly AnySectionDefinition[];
+    /** Content storage adapter. Defaults to FS adapter with standard paths. */
+    readonly contentAdapter?: ContentStorageAdapter;
+    /** Asset storage adapter. Defaults to FS adapter with standard paths. */
+    readonly assetAdapter?: AssetStorageAdapter;
+    /** Page creation templates. Optional — defaults to [] (blank pages only). */
+    readonly templates?: readonly PageTemplate[];
+    /**
+     * Registered form definitions (ARCHITECTURE.md §6.5). Optional — when
+     * omitted, no forms are registered and the submit handler returns 404
+     * for every form name.
+     */
+    readonly forms?: readonly AnyFormDefinition[];
+    /**
+     * Submission storage adapter. Defaults to the FS adapter rooted at
+     * `<projectRoot>/content/submissions`. Use `createWebhookSubmissionAdapter`
+     * (or a custom implementation) to send submissions to an external service.
+     */
+    readonly submissionAdapter?: SubmissionStorageAdapter;
+    /**
+     * Rate-limit knob for the submit endpoint. Defaults to `{ perMinute: 5 }`.
+     * The window is always 60 seconds in v1 — only the count is user-tunable.
+     */
+    readonly submissionRateLimit?: SubmissionRateLimit;
+}
+/**
+ * Fully-resolved configuration with all defaults filled in.
+ * Downstream code (runtime factory, handlers) can depend on every
+ * field being present.
+ */
+interface ResolvedConfig {
+    readonly sections: readonly AnySectionDefinition[];
+    readonly contentAdapter: ContentStorageAdapter;
+    readonly assetAdapter: AssetStorageAdapter;
+    /** Page creation templates. Always present (defaults to []). */
+    readonly templates: readonly PageTemplate[];
+    /** Registered forms. Always present (defaults to []). */
+    readonly forms: readonly AnyFormDefinition[];
+    /** Submission storage adapter. Always present. */
+    readonly submissionAdapter: SubmissionStorageAdapter;
+    /** Resolved rate-limit knob. Always present. */
+    readonly submissionRateLimit: SubmissionRateLimit;
+}
+/**
+ * Resolve a user config into a fully-populated config with defaults.
+ *
+ * Default adapters:
+ *   - content: `createFsContentAdapter({ contentRoot: process.cwd() + '/content' })`
+ *   - asset: `createFsAssetAdapter({ assetsRoot: process.cwd() + '/public/assets', publicUrlBase: '/assets' })`
+ *
+ * Validates that `sections` is non-empty (warns in dev, does not throw)
+ * so that a misconfigured template gets a visible signal rather than
+ * silent emptiness at render time.
+ */
+declare function defineConfig(config: AgentCmsConfig): ResolvedConfig;
+
+/**
+ * Wrap a Next.js configuration object for agntcms.
+ *
+ * Sets `output: 'standalone'` so the production Docker build
+ * (which copies `.next/standalone/`) works out of the box.
+ *
+ * In future versions this may also configure webpack aliases,
+ * image optimization domains, or framework-level middleware.
+ */
+declare function withagntcms<T extends Record<string, unknown>>(nextConfig: T): T & {
+    output: 'standalone';
+};
+
+export { type AgentCmsConfig, AnyFormDefinition, type PageTemplate, type ResolvedConfig, type SubmissionRateLimit, SubmissionStorageAdapter, defineConfig, withagntcms };

package/dist/config.mjs

@@ -0,0 +1,194 @@
+// src/config/defaults-registry.ts
+var SLOT = /* @__PURE__ */ Symbol.for("@agntcms/next/default-adapter-factories");
+function holder() {
+  return globalThis;
+}
+function getDefaultAdapterFactories(requested) {
+  const f = holder()[SLOT];
+  if (f === void 0) {
+    throw new Error(
+      `[agntcms] defineConfig: cannot fill the default ${requested} adapter because the server-only adapter factories were never registered. Import \`@agntcms/next/server\` (or \`@agntcms/next/handlers\`) before evaluating \`agntcms/config.ts\`, or pass an explicit adapter to \`defineConfig({ contentAdapter, assetAdapter, submissionAdapter })\`.`
+    );
+  }
+  return f;
+}
+
+// src/config/defineConfig.ts
+function defineConfig(config) {
+  if (config.sections.length === 0) {
+    console.warn(
+      "[agntcms] defineConfig: `sections` array is empty. No sections will be available for rendering."
+    );
+  }
+  const contentAdapter = config.contentAdapter ?? getDefaultAdapterFactories("content").content();
+  const assetAdapter = config.assetAdapter ?? getDefaultAdapterFactories("asset").asset();
+  const submissionAdapter = config.submissionAdapter ?? getDefaultAdapterFactories("submission").submission();
+  return {
+    sections: config.sections,
+    contentAdapter,
+    assetAdapter,
+    templates: config.templates ?? [],
+    forms: config.forms ?? [],
+    submissionAdapter,
+    submissionRateLimit: config.submissionRateLimit ?? { perMinute: 5 }
+  };
+}
+
+// src/config/withagntcms.ts
+function withagntcms(nextConfig) {
+  return {
+    ...nextConfig,
+    output: "standalone"
+  };
+}
+
+// src/domain/form.ts
+var FORM_FORBIDDEN_KINDS = /* @__PURE__ */ new Set([
+  "image",
+  "video",
+  "reference",
+  "list",
+  // `formOverrides` is a section-only descriptor (it overrides another
+  // form schema instance). Putting it inside a form would mean a form's
+  // payload could carry overrides for itself or another form — a
+  // recursive shape with no ergonomic editor UI. Section-only by design.
+  "formOverrides",
+  // `button` is a section-only descriptor: a styled CTA with an
+  // optional link. Public-form payloads collect user input — a button
+  // value is authored content, not a submitted answer. Section-only
+  // by design (mirrors `formOverrides`).
+  "button"
+]);
+var SubmissionsNotReadableError = class extends Error {
+  constructor(message = "submission adapter does not support reading") {
+    super(message);
+    this.name = "SubmissionsNotReadableError";
+  }
+};
+
+// src/forms/defineForm.ts
+var InvalidFormFieldError = class extends Error {
+  formName;
+  fieldName;
+  fieldKind;
+  constructor(formName, fieldName, fieldKind) {
+    super(
+      `Form "${formName}": field "${fieldName}" uses kind "${fieldKind}", which is not allowed in a form schema in v1. Allowed kinds: text, richText, number, boolean, select, link. Forbidden kinds: image, reference, list, formOverrides. See ARCHITECTURE.md \xA76.5.`
+    );
+    this.name = "InvalidFormFieldError";
+    this.formName = formName;
+    this.fieldName = fieldName;
+    this.fieldKind = fieldKind;
+  }
+};
+var HoneypotCollisionError = class extends Error {
+  formName;
+  fieldName;
+  reason;
+  constructor(formName, fieldName, reason = "collision") {
+    super(
+      reason === "empty" ? `Form "${formName}": honeypot name must be a non-empty string.` : `Form "${formName}": honeypot name "${fieldName}" collides with a real field. Choose a honeypot name that does not appear in the schema.`
+    );
+    this.name = "HoneypotCollisionError";
+    this.formName = formName;
+    this.fieldName = fieldName;
+    this.reason = reason;
+  }
+};
+var InvalidFormNameError = class extends Error {
+  constructor(name) {
+    super(
+      `Invalid form name ${JSON.stringify(name)}. Use letters, digits, hyphen, and underscore only (no path separators).`
+    );
+    this.name = "InvalidFormNameError";
+  }
+};
+var FORM_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
+function defineForm(input) {
+  if (typeof input.name !== "string" || !FORM_NAME_PATTERN.test(input.name)) {
+    throw new InvalidFormNameError(input.name);
+  }
+  for (const [fieldName, descriptor] of Object.entries(input.schema)) {
+    const kind = descriptor.kind;
+    if (FORM_FORBIDDEN_KINDS.has(kind)) {
+      throw new InvalidFormFieldError(input.name, fieldName, kind);
+    }
+  }
+  if (input.honeypot !== void 0) {
+    if (typeof input.honeypot !== "string" || input.honeypot === "") {
+      throw new HoneypotCollisionError(input.name, input.honeypot, "empty");
+    }
+    if (Object.prototype.hasOwnProperty.call(input.schema, input.honeypot)) {
+      throw new HoneypotCollisionError(input.name, input.honeypot, "collision");
+    }
+  }
+  return input.honeypot !== void 0 ? { name: input.name, schema: input.schema, honeypot: input.honeypot } : { name: input.name, schema: input.schema };
+}
+
+// src/forms/registry.ts
+var DuplicateFormNameError = class extends Error {
+  formName;
+  constructor(name) {
+    super(
+      `Form name "${name}" is registered more than once. Form names must be unique within a config.`
+    );
+    this.name = "DuplicateFormNameError";
+    this.formName = name;
+  }
+};
+
+// src/domain/fields.ts
+var TextField = { kind: "text" };
+var RichTextField = { kind: "richText" };
+var ImageField = { kind: "image" };
+var VideoField = { kind: "video" };
+var ReferenceField = { kind: "reference" };
+var LinkField = { kind: "link" };
+var NumberField = { kind: "number" };
+var BooleanField = { kind: "boolean" };
+var SelectField = (options, opts) => ({
+  kind: "select",
+  options,
+  ...opts?.default !== void 0 ? { default: opts.default } : {}
+});
+var ButtonField = (variants, opts) => ({
+  kind: "button",
+  variants,
+  ...opts?.default !== void 0 ? { default: opts.default } : {}
+});
+var ListField = (itemSchema, opts) => ({
+  kind: "list",
+  itemSchema,
+  ...opts?.min !== void 0 ? { min: opts.min } : {},
+  ...opts?.max !== void 0 ? { max: opts.max } : {},
+  ...opts?.default !== void 0 ? { default: opts.default } : {}
+});
+
+// src/domain/formOverrides.ts
+var FormOverridesField = (formName, opts) => ({
+  kind: "formOverrides",
+  formName,
+  ...opts?.default !== void 0 ? { default: opts.default } : {}
+});
+export {
+  BooleanField,
+  ButtonField,
+  DuplicateFormNameError,
+  FormOverridesField,
+  HoneypotCollisionError,
+  ImageField,
+  InvalidFormFieldError,
+  InvalidFormNameError,
+  LinkField,
+  ListField,
+  NumberField,
+  ReferenceField,
+  RichTextField,
+  SelectField,
+  SubmissionsNotReadableError,
+  TextField,
+  VideoField,
+  defineConfig,
+  defineForm,
+  withagntcms
+};