@agntcms/next 0.3.1 → 0.3.4

package/dist/{form-BqY0H1V5.d.ts → page-DXF0_SrY.d.ts}

@@ -1,103 +1,3 @@
-/**
- * Per-field override record. Every property is optional; an absent property
- * means "fall back to the form schema's behaviour for this field":
- *
- *   - `label`         — visible label. Defaults to `titleCase(fieldName)`.
- *                       Field NAME (the payload key) is NEVER renamable.
- *   - `placeholder`   — input placeholder text.
- *   - `helpText`      — small text rendered below the input.
- *   - `hidden`        — when `true`, the field is not rendered. If `default`
- *                       is also set, the default value is included in the
- *                       submitted payload exactly as if the user had typed it.
- *                       If no default, the field is omitted entirely (the
- *                       submit handler will reject if required).
- *   - `order`         — sort key. Lower values render first. Fields without
- *                       `order` render last in their original schema order
- *                       (stable). Ties broken by schema order.
- *   - `default`       — initial value seeded into the input. Stored as
- *                       `unknown` because the override record is keyed by
- *                       raw field name with no compile-time link back to
- *                       the form schema. The `<Form>` component narrows
- *                       per descriptor kind at render time and falls back
- *                       to the schema default (with a one-shot console
- *                       warning) when the stored shape doesn't match.
- *
- * Both the interface and the property values are `readonly` — overrides
- * are content (snapshot-versioned, JSON-serialisable) and the runtime
- * never mutates them after read.
- */
-interface FormFieldOverride {
-    readonly label?: string;
-    readonly placeholder?: string;
-    readonly helpText?: string;
-    readonly hidden?: boolean;
-    readonly order?: number;
-    /**
-     * Initial value seeded into the field. Type is `unknown` because there
-     * is no compile-time link from the keyed field name back to the form
-     * schema. See file header for narrowing/fallback policy.
-     */
-    readonly default?: unknown;
-}
-/**
- * Map from field name to override record. Keys are the form schema's
- * raw field names (the payload keys). Fields not present in the map use
- * schema defaults.
- *
- * Stored as a plain `Record` rather than `Readonly<Record<...>>` so it
- * round-trips through `JSON.parse` cleanly (parsed objects are plain
- * mutable objects). The runtime treats it as read-only by convention.
- */
-type FormFieldOverrides = Record<string, FormFieldOverride>;
-/**
- * A field descriptor a section author uses to expose per-section-instance
- * form overrides as content. The `formName` references a registered
- * `FormDefinition` by name (NOT a function reference, so the value is
- * RSC-serialisable and can travel through the section data record like
- * any other field).
- *
- * NOT allowed inside a form schema (forbidden via `FORM_FORBIDDEN_KINDS`
- * in `domain/form.ts`). Forms cannot contain a form-overrides field —
- * that would be a recursive content shape with no ergonomic editor UI.
- *
- * The descriptor's runtime value type is `FormFieldOverrides` (see
- * `FieldValueFor` in `domain/schema.ts`).
- */
-interface FormOverridesFieldDescriptor {
-    readonly kind: 'formOverrides';
-    /**
-     * Name of the form whose fields this descriptor overrides. Must match
-     * a form registered in `defineConfig({ forms: [...] })`. The runtime
-     * does NOT validate this at section-definition time (the form
-     * registry isn't visible to `defineSection`); the editor widget shows
-     * a "form not found" message instead of crashing.
-     */
-    readonly formName: string;
-    /**
-     * Default override map for a freshly inserted section. Defaults to
-     * `{}` (i.e. all fields fall back to schema defaults) when omitted —
-     * the conditional spread in `FormOverridesField()` keeps the property
-     * absent under `exactOptionalPropertyTypes`.
-     */
-    readonly default?: FormFieldOverrides;
-}
-/**
- * Factory for a `FormOverridesFieldDescriptor`.
- *
- * `formName` matches the `name` of the `FormDefinition` produced by
- * `defineForm()`. The factory itself does NOT validate that the name
- * resolves to a registered form — registry lookup happens lazily in
- * the editor widget, with a graceful "form not found" message.
- *
- * Why a factory and not a singleton: every section author binds this
- * descriptor to a specific form name, so there is no useful no-args
- * shape. `LinkField` is a singleton because every link descriptor is
- * structurally identical; `FormOverridesField('contact')` is not.
- */
-declare const FormOverridesField: (formName: string, opts?: {
-    readonly default?: FormFieldOverrides;
-}) => FormOverridesFieldDescriptor;
-
 /**
  * A section schema: a record mapping field names to built-in field
  * descriptors. This is the COMPILE-TIME description authors pass to
@@ -147,16 +47,12 @@ interface ReferenceValue {
  *   select     -> string         (one of the descriptor's option values)
  *   list       -> Array<ListItem<S>>  (each item: derived data shape of S
  *                                      plus opaque `_id`)
- *   formOverrides -> FormFieldOverrides
- *                                     (record of per-field overrides for
- *                                      a section instance pointing at a
- *                                      named form; see domain/formOverrides.ts)
  *
  * The `list` case recurses through the schema. The recursion has to live
  * on this side of the descriptor/value seam because `ListField<S>`'s
  * value depends on `FieldValueFor` applied to every member of `S`.
  */
-type FieldValueFor<F extends FieldDescriptor> = F extends TextField ? string : F extends RichTextField ? string : F extends ImageField ? ImageValue : F extends VideoField ? VideoValue : F extends ReferenceField ? ReferenceValue : F extends LinkField ? LinkValue : F extends ButtonField ? ButtonValue : F extends NumberField ? number : F extends BooleanField ? boolean : F extends SelectField ? string : F extends ListField<infer S> ? ReadonlyArray<ListItem<S>> : F extends FormOverridesFieldDescriptor ? FormFieldOverrides : never;
+type FieldValueFor<F extends FieldDescriptor> = F extends TextField ? string : F extends RichTextField ? string : F extends ImageField ? ImageValue : F extends VideoField ? VideoValue : F extends ReferenceField ? ReferenceValue : F extends LinkField ? LinkValue : F extends ButtonField ? ButtonValue : F extends NumberField ? number : F extends BooleanField ? boolean : F extends SelectField ? string : F extends ListField<infer S> ? ReadonlyArray<ListItem<S>> : never;
 /**
  * The runtime shape of a single item in a `ListField<S>` value.
  *
@@ -281,15 +177,8 @@ type ListItemDefault<S extends SectionSchema> = {
  * This is the v1 vocabulary for describing a section's schema. It is closed
  * on purpose: consistency of the editing UI depends on the runtime knowing
  * every possible field type ahead of time.
- *
- * `FormOverridesFieldDescriptor` is section-only: it is a member of this
- * union (so a section schema can carry it) but is explicitly listed in
- * `FORM_FORBIDDEN_KINDS` (see `domain/form.ts`), so a form schema cannot
- * carry one. The descriptor lives in `domain/formOverrides.ts` to keep
- * the override-shape types (`FormFieldOverride`, `FormFieldOverrides`) in
- * the same file as the descriptor that produces them.
  */
-type FieldDescriptor = TextField | RichTextField | ImageField | VideoField | ReferenceField | LinkField | ButtonField | NumberField | BooleanField | SelectField | ListField | FormOverridesFieldDescriptor;
+type FieldDescriptor = TextField | RichTextField | ImageField | VideoField | ReferenceField | LinkField | ButtonField | NumberField | BooleanField | SelectField | ListField;
 /** String literal union of every descriptor's `kind` — useful for maps and tables. */
 type FieldKind = FieldDescriptor['kind'];
 /** Plain inline text (single-line or small multi-line without formatting). */
@@ -571,183 +460,4 @@ interface Page {
  */
 type PageSummary = Omit<Page, 'sections'>;
 
-/**
- * Closed union of field descriptors allowed in a form schema in v1.
- *
- * Why this is a strict subset of `FieldDescriptor`:
- *   - `image`     → file upload is deferred (§6.5, §12).
- *   - `video`     → forms collect text/numbers/etc. from end users; a
- *                   public submission carrying an embed URL is a semantic
- *                   outlier (videos are authoring content, not user input).
- *   - `reference` → semantically odd for user input — references are an
- *                   authoring construct, not a public-site concern.
- *   - `list`      → payload validation becomes recursive; YAGNI for the
- *                   newsletter/contact use cases v1 targets.
- *
- * Keeping this set closed at the type level makes the restriction visible
- * to authors at compile time. The runtime check in `defineForm()` provides
- * the same guarantee for callers that erase types via `as`.
- */
-type FormFieldDescriptor = TextField | RichTextField | NumberField | BooleanField | SelectField | LinkField;
-/**
- * A form schema: a record mapping field names to allowed form-field descriptors.
- *
- * Defined as a plain `Record` (no `Readonly<>`) for the same `keyof S`
- * preservation reason described in `domain/schema.ts`'s `SectionSchema`.
- */
-type FormSchema = Record<string, FormFieldDescriptor>;
-/**
- * Registration record produced by `defineForm`. The runtime registry
- * (`forms/registry.ts`) stores these keyed by `name`, mirroring the
- * section registry.
- *
- * `honeypot` is the OPTIONAL name of an additional hidden field the
- * frontend renders out-of-schema (e.g. `<input name="website" style="display:none">`).
- * If a non-empty value arrives in a submit payload at that key, the server
- * suppresses the submission silently. On the wire the response is
- * indistinguishable from a successful no-op (200 OK with `{ ok: true,
- * stored: false }`) — by design, so a bot cannot tell from the response
- * whether it was filtered. The `suppressed: 'honeypot'` marker is INTERNAL
- * to the runtime's `SubmitFormResult` discriminant (see
- * `runtime/submitForm.ts`); the submit route handler strips it before
- * returning. The honeypot field name MUST NOT collide with any real schema
- * field name — `defineForm()` enforces this.
- */
-interface FormDefinition<S extends FormSchema = FormSchema> {
-    /** Unique name. Used as the URL-safe identifier in submit/list/read endpoints. */
-    readonly name: string;
-    /** Field descriptors. */
-    readonly schema: S;
-    /** Optional honeypot field name (out-of-schema). See type doc. */
-    readonly honeypot?: string;
-}
-/**
- * Erased/heterogeneous form definition for use in lists (e.g.
- * `defineConfig({ forms: [Contact, Newsletter] })`). Mirrors the
- * `AnySectionDefinition` pattern in `sections/defineSection.ts`.
- */
-interface AnyFormDefinition {
-    readonly name: string;
-    readonly schema: FormSchema;
-    readonly honeypot?: string;
-}
-/**
- * Minimal lookup interface for a registry of form definitions.
- *
- * Lives in `domain/` because the runtime (`runtime/submitForm.ts`) needs
- * to depend on "something that can look up a form by name" without having
- * to import from the `forms/` sibling. This keeps the dependency graph
- * `runtime → domain, storage` (ARCHITECTURE.md §8) intact.
- *
- * The concrete registry built by `forms/registry.ts` (`FormRegistry`)
- * structurally satisfies this interface — no wrapping needed at the call
- * site. `definitions` is included so handlers can enumerate registered
- * forms (for `forms/list`).
- */
-interface FormLookup {
-    readonly definitions: ReadonlyArray<AnyFormDefinition>;
-    get(name: string): AnyFormDefinition | undefined;
-    has(name: string): boolean;
-}
-/**
- * A single form submission stored by a `SubmissionStorageAdapter`.
- *
- * Shape is intentionally flat:
- *   - `formName` selects the form schema this submission belongs to.
- *   - `payload` is the validated record of field values, opaque to the
- *     storage layer (storage doesn't know schemas; the runtime validates
- *     before calling the adapter).
- *   - `submittedAt` is an ISO-8601 string. We use a string rather than a
- *     `Date` because submissions cross JSON boundaries (route handler →
- *     adapter → potentially webhook → potentially admin UI) and
- *     `Date.toISOString()` round-tripping has known edge cases.
- *   - `id` is an opaque, lex-sortable identifier. The FS adapter uses it
- *     as a tie-breaker when two submissions share a `submittedAt`
- *     millisecond.
- *
- * Privacy note: the IP address is NOT stored by default (ARCHITECTURE.md
- * §6.5 / §11). Adding it would be a config-flag change.
- */
-interface Submission {
-    readonly formName: string;
-    /**
-     * Validated payload. Each value type matches the runtime type of its
-     * declared `FormFieldDescriptor` (see `formPayloadValueFor`). Stored
-     * as `unknown` here so the storage layer stays schema-agnostic.
-     */
-    readonly payload: Readonly<Record<string, unknown>>;
-    /** ISO-8601 timestamp of when the submit handler accepted the payload. */
-    readonly submittedAt: string;
-    /** Lex-sortable opaque identifier (ULID-like). */
-    readonly id: string;
-}
-/**
- * Lightweight summary of a stored submission, returned by
- * `SubmissionStorageAdapter.list`. The full payload is fetched on demand
- * via `read` so the AdminModal list view stays cheap even when a form
- * accumulates thousands of entries.
- */
-interface SubmissionSummary {
-    readonly id: string;
-    readonly submittedAt: string;
-}
-/**
- * Public adapter-info descriptor surfaced through the runtime so handlers
- * (notably the frozen `forms/list` route) can tell the AdminModal whether
- * submissions are locally readable. Two shapes:
- *   - `{ kind: 'fs' }`               — local FS submissions; readable.
- *   - `{ kind: 'webhook', host }`    — webhook adapter; not locally readable.
- *
- * The host is the `URL.host` portion of the configured webhook (no path,
- * no query, no credentials) — surfaced so the AdminModal can render a
- * "POSTed to <host>" hint without leaking secrets.
- */
-type SubmissionAdapterInfo = {
-    readonly kind: 'fs';
-} | {
-    readonly kind: 'webhook';
-    readonly host: string;
-};
-/**
- * Storage adapter for form submissions (ARCHITECTURE.md §5, §6.5).
- *
- * Implementations:
- *   - FS: writes `<root>/<formName>/<submittedAt>-<id>.json`. Default.
- *   - Webhook: POSTs each submission to a configured URL; does NOT write
- *              to disk. `list`/`read` throw if called (no local copy).
- *
- * `store` is the only mandatory write path. `list`/`read` are required
- * to satisfy AdminModal's "Submissions" tab (Dispatch 2). A webhook-only
- * setup signals "no local copies" by throwing a typed error so the route
- * handler can return a clean 405.
- *
- * `info` is a small introspection field. Frozen route handlers wire the
- * adapter into `createFormsListHandler` so the AdminModal knows whether
- * to attempt `/forms/read` (FS) or render a "remote" hint (webhook).
- * Without it the handler would default to `kind: 'fs'` and the modal
- * would issue 501-returning fetches against a webhook adapter.
- *
- * Implementations MUST NOT throw for "form has no submissions"; `list`
- * MUST return an empty array in that case. `read(formName, id)` MUST
- * return `null` for an unknown id (mirrors `ContentStorageAdapter.readPage`).
- */
-interface SubmissionStorageAdapter {
-    /** Static descriptor of this adapter. See `SubmissionAdapterInfo`. */
-    readonly info: SubmissionAdapterInfo;
-    /** Persist a submission. Returns void; the runtime stamps id+submittedAt. */
-    store(submission: Submission): Promise<void>;
-    /** List submissions for a form, newest first. Returns [] if none. */
-    list(formName: string): Promise<ReadonlyArray<SubmissionSummary>>;
-    /** Read a single submission. Returns `null` if the id is unknown. */
-    read(formName: string, id: string): Promise<Submission | null>;
-}
-/**
- * Thrown by adapters that have no local read surface (e.g. webhook-only).
- * The route handler maps this to HTTP 501 / 405 so the AdminModal can
- * surface a helpful message.
- */
-declare class SubmissionsNotReadableError extends Error {
-    constructor(message?: string);
-}
-
-export { type AnyFormDefinition as A, ButtonField as B, type PageSeo as C, type Section as D, type SelectOption as E, type FormLookup as F, ImageField as I, LinkField as L, NumberField as N, type Page as P, RichTextField as R, type SectionSchema as S, TextField as T, VideoField as V, type FormSchema as a, type FormDefinition as b, type FieldDescriptor as c, type ImageValue as d, type VideoValue as e, ReferenceField as f, type ReferenceValue as g, type LinkValue as h, type ButtonValue as i, BooleanField as j, SelectField as k, ListField as l, type FormOverridesFieldDescriptor as m, type FormFieldOverrides as n, type SubmissionStorageAdapter as o, type FormFieldDescriptor as p, type FormFieldOverride as q, FormOverridesField as r, type Submission as s, type SubmissionAdapterInfo as t, type SubmissionSummary as u, SubmissionsNotReadableError as v, type PageSummary as w, type FieldValueFor as x, type FieldKind as y, type ListItem as z };
+export { ButtonField as B, type FieldDescriptor as F, ImageField as I, LinkField as L, NumberField as N, type Page as P, RichTextField as R, type SectionSchema as S, TextField as T, VideoField as V, type ImageValue as a, type VideoValue as b, ReferenceField as c, type ReferenceValue as d, type LinkValue as e, type ButtonValue as f, BooleanField as g, SelectField as h, ListField as i, type PageSummary as j, type FieldValueFor as k, type FieldKind as l, type ListItem as m, type PageSeo as n, type Section as o, type SelectOption as p };