@vectoriox/iox-ui 5.82.2 → 5.83.1

package/forms-core/index.d.ts

@@ -16,6 +16,11 @@ declare enum ControlType {
     /** A slider over a numeric range — min/max/step ride the field. */
     Range = "range",
     Radio = "radio",
+    /** One or several of a few visible choices — chips (the default) or a list of radios / checkboxes (premium N1).
+     *  Its `multiple` trait picks the value's shape: a string, or a list of strings. */
+    Choices = "choices",
+    /** A date the visitor picks from the look's calendar (premium N8) — a button that reads the date in words and a
+     *  hidden input carrying the ISO `YYYY-MM-DD` value. Never the browser's own date box. */
     Date = "date",
     Time = "time",
     File = "file",
@@ -35,7 +40,19 @@ declare enum RuleName {
     /** A checkbox that must be ticked — terms, consent. */
     Accepted = "accepted",
     FileType = "fileType",
-    FileSize = "fileSize"
+    FileSize = "fileSize",
+    /** IMPLIED, never authored: an answer of a Choices / Radio / Dropdown must be one of the field's own options
+     *  (premium N1) — a hand-crafted POST cannot file a value the form never offered. */
+    OneOf = "oneOf",
+    /** IMPLIED, never authored: a Date's answer is a real `YYYY-MM-DD` day (premium N8). */
+    ValidDate = "validDate"
+}
+/** How a Choices field draws its options (premium N1). */
+declare enum ChoiceAppearance {
+    /** Each option a chip — the label is the chip; the native input inside it is visually hidden. */
+    Chips = "chips",
+    /** The options as rows of the look's own radio / checkbox (DS9.1). */
+    List = "list"
 }
 /** Named regexes so an author picks "Email" rather than writing one. */
 declare enum PatternPreset {
@@ -81,6 +98,8 @@ interface FieldSpec {
     options?: FieldOption[];
     optionsSource?: FieldOptionSource;
     defaultValue?: any;
+    /** A Choices field that takes several answers: its value is a list (premium N1). */
+    multiple?: boolean;
 }
 /** When a field is validated, once the author has stopped deciding it per field. */
 declare enum FeedbackTiming {
@@ -117,8 +136,15 @@ interface FormSpec {
  * validation — the single biggest reason the panel can stay empty and still validate well.
  */
 declare const IMPLIED_PATTERN: Readonly<Partial<Record<ControlType, PatternPreset>>>;
-/** Controls whose value is a list rather than a scalar. */
-declare const MULTI_VALUE_CONTROLS: ReadonlySet<ControlType>;
+/**
+ * Whether this field's answer is a LIST rather than one value — a file list, or a Choices field that takes several
+ * (premium N1). Per FIELD, not per control: the same Choices control is single or multiple by its `multiple` trait.
+ * ONE reading for collect, validate, the runtimes' transport and the server (replaced the control-only
+ * `MULTI_VALUE_CONTROLS`, which nothing read).
+ */
+declare function isMultiValueField(field: Pick<FieldSpec, 'control' | 'multiple'> | null | undefined): boolean;
+/** The controls whose answers must be one of the field's own options (the implied `oneOf` rule). */
+declare const OPTION_CONTROLS: ReadonlySet<ControlType>;
 
 /** Namespace for every forms validation key. Keep in sync with `en.json` / `he.json`. */
 declare const MESSAGE_NAMESPACE = "forms.validation";
@@ -127,6 +153,24 @@ declare const MESSAGE_NAMESPACE = "forms.validation";
  * can place the number wherever its grammar needs it, rather than having it baked into the string.
  */
 declare const RULE_MESSAGE_KEYS: Readonly<Record<RuleName, string>>;
+/**
+ * What "required" says on a field you CHOOSE rather than type into (premium N1 / N8): "Choose an option", "Choose at
+ * least one", "Choose a date" — never "This field is required" beside a row of chips.
+ */
+declare const CHOICE_MESSAGE_KEYS: Readonly<{
+    One: "forms.validation.choose";
+    Some: "forms.validation.chooseSome";
+    Date: "forms.validation.chooseDate";
+}>;
+/** A Date outside its Earliest / Latest. The calendar refuses those days, so this is a stale page or a hand POST. */
+declare const DATE_MESSAGE_KEYS: Readonly<{
+    Min: "forms.validation.dateMin";
+    Max: "forms.validation.dateMax";
+}>;
+/** The submit button's own words (premium N2): what it says once its form has sent, when the author wrote none. */
+declare const SUBMIT_MESSAGE_KEYS: Readonly<{
+    Sent: "forms.submit.sent";
+}>;
 /**
  * A pattern failure deserves better than "Invalid format". Each preset gets its own key so the
  * message can say what a valid value looks like, which is the difference between a visitor fixing
@@ -158,6 +202,15 @@ interface FormResult {
     /** Keyed by field name. Empty when valid. */
     errors: Record<string, FieldError>;
 }
+/**
+ * When "today" is, for a Date's relative bounds (premium N8). A browser leaves it out: its own local day is the
+ * visitor's. The SERVER passes `dateSlackDays: 1` — it cannot know the visitor's time zone, so a day either side of
+ * its own today is still accepted.
+ */
+interface ValidateOptions {
+    today?: string;
+    dateSlackDays?: number;
+}
 /**
  * Validate one field's value.
  *
@@ -169,12 +222,19 @@ interface FormResult {
  * number" at someone who simply left it blank — the single most common validation-UX bug.
  * The FIRST failure wins: a visitor fixes one thing at a time.
  */
-declare function validateField(value: unknown, spec: FieldSpec, form?: Record<string, unknown>): FieldResult;
+declare function validateField(value: unknown, spec: FieldSpec, form?: Record<string, unknown>, options?: ValidateOptions): FieldResult;
 /**
  * Validate a whole submission. Every field is checked (not short-circuited at the first bad one) so
  * the visitor sees every problem at once instead of fixing them one reload at a time.
  */
-declare function validateForm(values: Record<string, unknown>, spec: FormSpec): FormResult;
+declare function validateForm(values: Record<string, unknown>, spec: FormSpec, options?: ValidateOptions): FormResult;
+/**
+ * The answers in the shape each field takes (premium N1): a field that takes several answers gets a LIST (one answer
+ * posted on its own is a list of one; nothing is an empty list). ONE reading for a host's transport and the server,
+ * before validation — `isMultiValueField` decides. A single-answer field is left as posted: two answers to it is the
+ * validator's to refuse, never quietly cut to one.
+ */
+declare function normaliseAnswers(values: Record<string, unknown> | null | undefined, spec: Pick<FormSpec, 'fields'>): Record<string, unknown>;
 /** The name of the first field with an error, in spec order — what the browser should focus. */
 declare function firstInvalidField(spec: FormSpec, errors: Record<string, FieldError>): string | null;
 
@@ -198,6 +258,27 @@ declare const STORE_ACTION: SubmitAction;
 declare function deriveFieldName(label: string): string;
 /** Make `name` unique within `taken`, appending 2, 3, … — two "Email" fields must not collide. */
 declare function uniqueFieldName(name: string, taken: ReadonlySet<string>): string;
+/** A Field's own key, before the form makes it unique: the author's override, else derived from the label. */
+declare function baseFieldName(props: {
+    name?: unknown;
+    label?: unknown;
+} | null | undefined): string;
+/**
+ * THE naming rule (vectoriox/iox-ui#43): a form's fields, in document order, each its base name made unique against
+ * the names before it — `email`, `email2`. The spec (`collectFormSpec`), the component path's runtime and the engine's
+ * string renderer all name a field from here, so the input's `name` and the saved spec's key can never differ.
+ */
+declare function uniqueFieldNames(baseNames: ReadonlyArray<string>): string[];
+/** The submitted name of every Field of a Form, in document order — `uniqueFieldNames` over its fields. */
+declare function formFieldNames(node: FormNodeLike | null | undefined): string[];
+/** Each Field node of a Form → the name it submits under (`formFieldNames`, by node). */
+declare function formFieldNameMap<N extends FormNodeLike>(node: N | null | undefined): Map<FormNodeLike, string>;
+/**
+ * A Field's spec from its props and the name its form gave it — ONE reading for the saved spec and the component
+ * path's runtime (it was written twice: `IoxFieldComponent.toSpec` never carried the options source, the default or a
+ * Date's bounds). A Date's Earliest / Latest (`earliest` / `latest`) become its `min` / `max` rules (premium N8).
+ */
+declare function fieldSpecOf(props: Record<string, any> | null | undefined, name: string): FieldSpec;
 /**
  * Walk a Form subtree and produce its spec.
  *
@@ -428,28 +509,45 @@ declare const FORM_FIELDS_ATTRIBUTE = "data-iox-form-fields";
 declare function clientFormSpec(spec: Pick<FormSpec, 'feedback' | 'fields'>): ClientFormSpec;
 /** The attribute's value back into a spec, or null when it is missing or not one. */
 declare function parseClientFormSpec(raw: string | null | undefined): ClientFormSpec | null;
-/** How a submit button wears its form's state (vectoriox/iox-ui#42). */
+/** How a submit button wears its form's state (vectoriox/iox-ui#42, premium N2). */
 interface SubmitButtonView {
     busy: boolean;
     disabled: boolean;
 }
-/** While its form sends, a submit button is busy, and disabled unless its author turned that off — ONE rule for the
- *  canvas's Sending state, the component path and the string path. Its "Sending…" label is the shared CSS's, keyed on
- *  the same `data-iox-state`. */
+/**
+ * While its form sends, a submit button is busy, and disabled unless its author turned that off; once the form has
+ * SENT it stays disabled, reading "Sent" with its check — nothing sends a lead twice (premium N2, the success in place).
+ * ONE rule for the canvas's Sending / Success states, the component path and the string path. Its labels are the shared
+ * CSS's, keyed on the same `data-iox-state`.
+ */
 declare function submitButtonView(state: FormRenderState | string | null | undefined, disableWhileSubmitting?: boolean): SubmitButtonView;
 /** On a submit button whose author turned "Disable while sending" off. */
 declare const SUBMIT_KEEP_ENABLED_ATTRIBUTE = "data-iox-keep-enabled";
 declare enum SubmitLabelClass {
     Labels = "iox-submit__labels",
     Idle = "iox-submit__idle",
-    Busy = "iox-submit__busy"
+    Busy = "iox-submit__busy",
+    Sent = "iox-submit__sent",
+    Check = "iox-submit__check"
+}
+/** The check the Sent label draws once (premium N2 — the rare-tier beat, Emil 135/136): one stroke, `pathLength` 100 so
+ *  the shared CSS draws it by `stroke-dashoffset` whatever its real length. */
+declare const SUBMIT_CHECK_SVG: string;
+declare function sentWord(lang: string | null | undefined): string;
+/** A submit button's three labels: what it says at rest, while its form sends, and once it has sent. */
+interface SubmitLabels {
+    idle: string;
+    /** "While sending" — none: the button keeps its idle words while sending. */
+    busy?: string | null;
+    /** "Sent" — none: the catalog's word, translated by the host (`SUBMIT_MESSAGE_KEYS.Sent`). */
+    sent: string;
 }
 /**
- * A submit button's words, as markup: its label, or — when it has a "While sending" label — both, stacked in one
- * cell (the button keeps the longer one's width and never jumps). The string renderer's copy of
- * `IoxSubmitButtonComponent`'s template; `escape` is the renderer's.
+ * A submit button's words, as markup: its three labels stacked in one grid cell (the button keeps the longest one's
+ * width and never jumps), each shown by the form's state through the shared CSS — swapped in place behind a 2px blur
+ * (Emil 87/139). The string renderer's copy of `IoxSubmitButtonComponent`'s template; `escape` is the renderer's.
  */
-declare function submitButtonLabelsHtml(label: string, loadingLabel: string | null | undefined, escape: (v: string) => string): string;
+declare function submitButtonLabelsHtml(labels: SubmitLabels, escape: (v: string) => string): string;
 declare const FORM_HONEYPOT_CLASS = "iox-form__hp";
 declare const FORM_ANNOUNCER_ATTRIBUTE = "data-iox-form-announcer";
 /**
@@ -460,6 +558,44 @@ declare const FORM_ANNOUNCER_ATTRIBUTE = "data-iox-form-announcer";
  */
 declare function formChromeHtml(honeypotField: string): string;
 
+/**
+ * THE SECOND CHANNEL (premium components N2) — "or message us on WhatsApp", the button a form keeps beside its submit,
+ * before AND after it sends.
+ *
+ * It is an ordinary node in the form's actions row (a ButtonBlock that links) carrying the ROLE `form.channel`, so the
+ * shared CSS keeps it on screen when the form succeeds and the Publishable gate can find it. Its address is the
+ * OWNER's fact: the builder builds it from what the author types (a number, an address, a link) and never invents one —
+ * inserted empty, it blocks publishing until it is filled (generation-core `auditSite`, `empty-channel`).
+ *
+ * Framework-free, like the rest of forms-core.
+ */
+/** The role the channel's node carries (`iox-role-form-channel`). */
+declare const FORM_CHANNEL_ROLE = "form.channel";
+/** The role of the row that holds the submit button and the channel (`iox-role-form-actions`). */
+declare const FORM_ACTIONS_ROLE = "form.actions";
+declare enum ChannelKind {
+    WhatsApp = "whatsapp",
+    Phone = "phone",
+    Email = "email",
+    Link = "link"
+}
+declare const CHANNEL_KINDS: ReadonlyArray<ChannelKind>;
+/**
+ * The address a channel links to, built from what the author typed — or `''` when it gives nothing a visitor could
+ * use (no digits, not an email). Never a guess: a WhatsApp number keeps exactly the digits typed (the panel asks for
+ * the country code), a link without a scheme gets `https://`.
+ */
+declare function channelHref(kind: ChannelKind | string, input: unknown): string;
+/** A channel's address back into what the panel shows: its kind and the value the author typed. */
+declare function parseChannelHref(href: unknown): {
+    kind: ChannelKind;
+    value: string;
+};
+/** True when the channel goes somewhere a visitor can use — the gate's "filled". */
+declare function isChannelFilled(href: unknown): boolean;
+/** A WhatsApp or web channel opens in a new tab; a call or an email hands over to the device. */
+declare function channelOpensNewTab(kind: ChannelKind | string): boolean;
+
 /**
  * FORM PRESETS — a complete, working form as one insert: its fields, its submit label and the words of
  * its Success and Error blocks. ONE definition (W1.1): the builder's Forms tray builds a preset from
@@ -467,11 +603,15 @@ declare function formChromeHtml(honeypotField: string): string;
  * into a composed page, so a generated contact form is the real one — never a second, drifting copy.
  * Data only: framework-free, like the rest of forms-core.
  */
+
 declare enum FormPresetId {
     Contact = "contact",
     Newsletter = "newsletter",
     Application = "application",
-    Booking = "booking"
+    Booking = "booking",
+    /** Premium N2: modelled on Doron's iox.studio brief — name, a phone that is also WhatsApp, the business, what they
+     *  need and a budget as chips, Send with WhatsApp beside it. */
+    Lead = "lead"
 }
 interface FormPresetField {
     label: string;
@@ -479,9 +619,21 @@ interface FormPresetField {
     required?: boolean;
     help?: string;
     placeholder?: string;
-    /** Choices for select/radio, `value|Label` per line — the Field's `optionsText` trait. */
+    /** Choices for select/radio/choices, `value|Label` per line — the Field's `optionsText` trait. */
     optionsText?: string;
     rows?: number;
+    /** A Choices field that takes several answers (N1). */
+    multiple?: boolean;
+    /** A Choices field's appearance — `chips` (the default) or `list` (N1). */
+    appearance?: string;
+    /** A Date's first and last day — '' any · an integer: days from today · an ISO day (N8, `dates.ts`). */
+    earliest?: string;
+    latest?: string;
+}
+/** The second way to reach the studio, beside Send (N2). Its address is the studio's own and starts EMPTY. */
+interface FormPresetChannel {
+    kind: `${ChannelKind}`;
+    label: string;
 }
 interface FormPresetDef {
     id: `${FormPresetId}`;
@@ -495,7 +647,13 @@ interface FormPresetDef {
     submitLabel: string;
     successText: string;
     errorText: string;
+    channel?: FormPresetChannel;
+    /** `false`: the AI plan wire does not offer it yet (the lead preset ships in the builder in M3; generation takes it
+     *  up in premium M8 — the wire's enum is model-facing and does not change before then). */
+    inPlan?: false;
 }
+/** The presets a generated plan may name (the plan wire's `form` enum) — every preset not held back by `inPlan`. */
+declare function planFormPresetIds(): string[];
 declare const FORM_PRESETS: readonly FormPresetDef[];
 /** The preset with this id, or undefined. */
 declare function formPresetById(id: string | null | undefined): FormPresetDef | undefined;
@@ -543,5 +701,195 @@ interface MisplacedFormContent<N extends NestingNode = NestingNode> {
 /** Every form-content subtree a tree holds inside an interactive host, in document order. */
 declare function findFormContentInHosts<N extends NestingNode>(roots: readonly N[] | null | undefined): MisplacedFormContent<N>[];
 
-export { ControlType, DEFAULT_EN_MESSAGES, FIELD_GROUP_NODE_TYPE, FIELD_NODE_TYPE, FORM_ANNOUNCER_ATTRIBUTE, FORM_CONTENT_TYPES, FORM_ERROR_KEYS, FORM_FIELDS_ATTRIBUTE, FORM_HONEYPOT_CLASS, FORM_NODE_TYPE, FORM_PRESETS, FORM_STATE_ATTRIBUTE, FeedbackTiming, FormPresetId, FormRenderState, HONEYPOT_FIELD, IMPLIED_PATTERN, INITIAL_FORM_STATE, INTERACTIVE_HOST_TAGS, InteractiveTag, MESSAGE_NAMESPACE, MULTI_VALUE_CONTROLS, PATTERN_MESSAGE_KEYS, PATTERN_PRESETS, PATTERN_PRESET_OPTIONS, PatternPreset, RENDERED_AT_FIELD, RULE_DESCRIPTORS, RULE_MESSAGE_KEYS, RuleName, RuleParamKind, STORE_ACTION, SUBMIT_BUTTON_NODE_TYPE, SUBMIT_KEEP_ENABLED_ATTRIBUTE, SubmitLabelClass, addableRules, applyServerErrors, clientFormSpec, collectFieldNodes, collectFormSpec, deriveFieldName, failureAnnouncement, fieldOptionsOf, findFormContentInHosts, firstInvalidField, formChromeHtml, formContentInHost, formPresetById, interpretSubmitResponse, isFormContent, isInteractiveHost, onFieldBlur, onFieldChange, onSubmitAttempt, parseClientFormSpec, parseFieldOptions, resetFormState, rulesFor, shouldShowError, submitButtonLabelsHtml, submitButtonView, submitEndpointPath, submitOutcome, uniqueFieldName, validateField, validateForm, withAntiSpamFields };
-export type { ClientFormSpec, FieldError, FieldOption, FieldOptionSource, FieldResult, FieldSpec, FormNodeLike, FormPresetDef, FormPresetField, FormResult, FormRuntimeState, FormSpec, FormTransport, MisplacedFormContent, NestingNode, RuleDescriptor, SubmitAction, SubmitButtonView, SubmitOutcome, SubmitRequest, SubmitResponse, ValidationRule };
+/**
+ * DATES — the date picker's pure half (premium components N8) and the date rules' one reading.
+ *
+ * A Date field's value is an ISO day, `YYYY-MM-DD`, compared as a string (the format sorts as the calendar does).
+ * Its `min` / `max` rules take an ISO day OR an offset in days from today (`{ offsetDays: 0 }` = today), so "from
+ * today on" stays true tomorrow without a re-save. ONE reading for the validator (client AND iox-cms), the calendar
+ * (which days it refuses) and the builder's Earliest / Latest controls.
+ *
+ * The calendar model (six rows of seven, roving focus, the APG keys) lives here too, so the DOM runtime only draws
+ * what this decides — the canvas, the engine's component path and its string path draw the SAME month.
+ *
+ * ⚠️ Framework-free, like the rest of forms-core. Local-time `Date` objects are used only to walk the calendar; a
+ * day leaves this file as an ISO string.
+ */
+
+/** Always six rows, so the panel never changes size between months (APG; Emil 74 — one object, one size). */
+declare const CALENDAR_ROWS = 6;
+/** The ISO day of a local `Date`. */
+declare function isoOfDate(d: Date): string;
+/** A local `Date` at midnight for an ISO day, or null when it is not one (2026-02-30 is not). */
+declare function dateOfIso(iso: unknown): Date | null;
+/** True for a real calendar day written `YYYY-MM-DD`. */
+declare function isIsoDate(value: unknown): boolean;
+/** Today, as the device that runs this sees it (the visitor's local day in a browser; the server's on iox-cms). */
+declare function todayIso(now?: Date): string;
+/** `iso` moved by `days` (negative goes back). */
+declare function addDaysIso(iso: string, days: number): string;
+/** `iso` moved by `months`, its day clamped to the target month's last (31 Jan + 1 month = 28/29 Feb). */
+declare function addMonthsIso(iso: string, months: number): string;
+/** `iso` held inside [min, max] (either may be absent). */
+declare function clampIso(iso: string, min?: string | null, max?: string | null): string;
+/** A date rule's parameter: an ISO day, or a number of days from today. */
+interface DateBoundParams {
+    date?: string;
+    offsetDays?: number;
+}
+/**
+ * A Field's `earliest` / `latest` trait → the rule parameter. The trait is one string so the panel and a saved page
+ * stay simple: `''` = any day · an integer = that many days from today (`'0'` = today, `'30'` = a month ahead) · an
+ * ISO day. Anything else reads as no bound.
+ */
+declare function parseDateBound(raw: unknown): DateBoundParams | null;
+/** The `min` / `max` rules a Date field's Earliest / Latest traits give it (none for "any"). */
+declare function dateBoundRules(earliest: unknown, latest: unknown): ValidationRule[];
+/** True when a rule's params are a DATE bound (an ISO day or an offset), never a number bound. */
+declare function isDateBoundParams(params: Record<string, any> | null | undefined): boolean;
+/** The ISO day a bound names today, or null when it names none. */
+declare function resolveDateBound(params: Record<string, any> | null | undefined, today: string): string | null;
+/** The first and last day a Date field accepts today — the calendar's refused days and the validator's range. */
+declare function fieldDateRange(field: Pick<FieldSpec, 'rules'> | null | undefined, today: string): {
+    min: string | null;
+    max: string | null;
+};
+/** True when the field is a date picker (the control that reads these rules as days). */
+declare function isDateField(field: Pick<FieldSpec, 'control'> | null | undefined): boolean;
+/**
+ * The first day of the week for a locale, 0 = Sunday … 6 = Saturday. `Intl.Locale(…).getWeekInfo()` (or the older
+ * `weekInfo` getter) when the runtime has it, else a small region table; a bare `en` reads as the US.
+ */
+declare function weekStartFor(locale: string | null | undefined): number;
+/** One cell of the month grid. */
+interface CalendarDay {
+    iso: string;
+    day: number;
+    today: boolean;
+    selected: boolean;
+    /** Outside Earliest / Latest: shown, announced as unavailable, never picked. */
+    disabled: boolean;
+    /** The roving tab stop — exactly one day of the month has it. */
+    focus: boolean;
+}
+interface CalendarMonth {
+    year: number;
+    /** 0-based, as `Date` counts. */
+    month: number;
+    /** `CALENDAR_ROWS` × 7; null where the month has no day. */
+    weeks: Array<Array<CalendarDay | null>>;
+    /** The weekday of each column, 0 = Sunday — the header row reads these. */
+    weekdays: number[];
+    canPrev: boolean;
+    canNext: boolean;
+}
+interface CalendarOptions {
+    weekStart: number;
+    today: string;
+    min?: string | null;
+    max?: string | null;
+    selected?: string | null;
+}
+/** The month `focus` sits in, as six rows of seven — the ONE grid every renderer draws. */
+declare function calendarMonth(focus: string, options: CalendarOptions): CalendarMonth;
+/** The keys the grid answers (APG date picker dialog). */
+declare enum CalendarKey {
+    Left = "ArrowLeft",
+    Right = "ArrowRight",
+    Up = "ArrowUp",
+    Down = "ArrowDown",
+    Home = "Home",
+    End = "End",
+    PageUp = "PageUp",
+    PageDown = "PageDown"
+}
+/**
+ * Where a key moves the focused day, held inside [min, max] — or null for a key the grid does not answer (Enter,
+ * Space and Escape are the runtime's: they pick or close, they never move).
+ */
+declare function calendarKeyTarget(key: string, focus: string, options: {
+    weekStart: number;
+    rtl?: boolean;
+    shift?: boolean;
+    min?: string | null;
+    max?: string | null;
+}): string | null;
+/** The date in words, in the site's language: "Thu, 20 November" — the year only when it is not this year's. */
+declare function formatDateInWords(iso: string, locale: string | null | undefined, today: string): string;
+/** The calendar's own words, by the site's language — the media-core `videoWords` precedent (a string-rendered
+ *  site has no translation service; the document's `lang` picks). */
+interface DatePickerWords {
+    choose: string;
+    previousMonth: string;
+    nextMonth: string;
+    close: string;
+}
+declare const DATE_PICKER_WORDS: Readonly<Record<'en' | 'he', DatePickerWords>>;
+/** The words for a language tag (`he-IL` → Hebrew); English for anything else. */
+declare function datePickerWords(lang: string | null | undefined): DatePickerWords;
+
+/**
+ * A Field as MARKUP — the string renderer's copy of `IoxFieldComponent`'s template, in ONE place (it lived in the
+ * engine's `layout-renderer.service.ts`, a second copy beside the component). The engine's string path writes it; the
+ * component mirrors it element for element, so hydration replaces like with like and the shared CSS (iox-forms.css,
+ * the contract's field baseline) reaches both.
+ *
+ * Choices (premium N1): a `<fieldset>` whose `<legend>` is the label, its options native radios (one answer — the
+ * arrow keys move and pick, with no script) or checkboxes (several), each inside a `<label>` that IS the chip; the
+ * input is visually hidden, never removed. Date (N8): a `<button>` that says the date in words and opens the look's
+ * calendar, with a hidden input carrying the ISO day — the raw SSR is the final markup (nothing shifts on hydrate).
+ *
+ * Framework-free, like the rest of forms-core: `escape` is the caller's.
+ */
+
+/** The classes the markup carries — the runtimes and the shared CSS key on these, never on a literal. */
+declare enum FieldClass {
+    Root = "iox-field",
+    Label = "iox-field__label",
+    LabelHidden = "iox-field__label--hidden",
+    Required = "iox-field__required",
+    Control = "iox-field__control",
+    Help = "iox-field__help",
+    Error = "iox-field__error",
+    Group = "iox-field__group",
+    Option = "iox-field__option",
+    Choices = "iox-field__choices",
+    ChoicesChips = "iox-field__choices--chips",
+    ChoicesList = "iox-field__choices--list",
+    Chips = "iox-field__chips",
+    Chip = "iox-field__chip",
+    ChipInput = "iox-field__control--chip",
+    DateButton = "iox-field__control--date",
+    DateValue = "iox-field__date-value",
+    DateIcon = "iox-field__date-icon",
+    DateInput = "iox-field__date-input"
+}
+/** On the date button: the raw Earliest / Latest (`'0'`, an ISO day), resolved by the visitor's own today. */
+declare const DATE_MIN_ATTRIBUTE = "data-iox-date-min";
+declare const DATE_MAX_ATTRIBUTE = "data-iox-date-max";
+/** On the date's words while no day is chosen (the placeholder's colour keys on it). */
+declare const DATE_EMPTY_ATTRIBUTE = "data-iox-empty";
+/** The calendar glyph inside the date button: one path set, drawn in currentColor, never announced. */
+declare const DATE_ICON_SVG: string;
+/** The `<input type>` of a control that renders as a plain input. */
+declare function inputTypeOf(control: string): string;
+/** A Choices field's appearance; anything unknown reads as chips (the default). */
+declare function choiceAppearanceOf(props: Record<string, any> | null | undefined): ChoiceAppearance;
+interface FieldMarkupOptions {
+    /** The name the field submits under — its FORM's unique name for it (`formFieldNames`, vectoriox/iox-ui#43). */
+    name: string;
+    /** The control's id; the label, help and error ids derive from it. */
+    id: string;
+    /** The node's classes (`iox-node-…`, the element-style marker…). */
+    cls: string;
+    /** Anything else the host element carries, written verbatim (an entrance's style). */
+    attrs?: string;
+    /** The site's language (the date's words). */
+    lang?: string | null;
+    escape: (value: string) => string;
+}
+/** A Field's whole element, as the string renderer writes it. */
+declare function fieldHtml(props: Record<string, any> | null | undefined, options: FieldMarkupOptions): string;
+
+export { CALENDAR_ROWS, CHANNEL_KINDS, CHOICE_MESSAGE_KEYS, CalendarKey, ChannelKind, ChoiceAppearance, ControlType, DATE_EMPTY_ATTRIBUTE, DATE_ICON_SVG, DATE_MAX_ATTRIBUTE, DATE_MESSAGE_KEYS, DATE_MIN_ATTRIBUTE, DATE_PICKER_WORDS, DEFAULT_EN_MESSAGES, FIELD_GROUP_NODE_TYPE, FIELD_NODE_TYPE, FORM_ACTIONS_ROLE, FORM_ANNOUNCER_ATTRIBUTE, FORM_CHANNEL_ROLE, FORM_CONTENT_TYPES, FORM_ERROR_KEYS, FORM_FIELDS_ATTRIBUTE, FORM_HONEYPOT_CLASS, FORM_NODE_TYPE, FORM_PRESETS, FORM_STATE_ATTRIBUTE, FeedbackTiming, FieldClass, FormPresetId, FormRenderState, HONEYPOT_FIELD, IMPLIED_PATTERN, INITIAL_FORM_STATE, INTERACTIVE_HOST_TAGS, InteractiveTag, MESSAGE_NAMESPACE, OPTION_CONTROLS, PATTERN_MESSAGE_KEYS, PATTERN_PRESETS, PATTERN_PRESET_OPTIONS, PatternPreset, RENDERED_AT_FIELD, RULE_DESCRIPTORS, RULE_MESSAGE_KEYS, RuleName, RuleParamKind, STORE_ACTION, SUBMIT_BUTTON_NODE_TYPE, SUBMIT_CHECK_SVG, SUBMIT_KEEP_ENABLED_ATTRIBUTE, SUBMIT_MESSAGE_KEYS, SubmitLabelClass, addDaysIso, addMonthsIso, addableRules, applyServerErrors, baseFieldName, calendarKeyTarget, calendarMonth, channelHref, channelOpensNewTab, choiceAppearanceOf, clampIso, clientFormSpec, collectFieldNodes, collectFormSpec, dateBoundRules, dateOfIso, datePickerWords, deriveFieldName, failureAnnouncement, fieldDateRange, fieldHtml, fieldOptionsOf, fieldSpecOf, findFormContentInHosts, firstInvalidField, formChromeHtml, formContentInHost, formFieldNameMap, formFieldNames, formPresetById, formatDateInWords, inputTypeOf, interpretSubmitResponse, isChannelFilled, isDateBoundParams, isDateField, isFormContent, isInteractiveHost, isIsoDate, isMultiValueField, isoOfDate, normaliseAnswers, onFieldBlur, onFieldChange, onSubmitAttempt, parseChannelHref, parseClientFormSpec, parseDateBound, parseFieldOptions, planFormPresetIds, resetFormState, resolveDateBound, rulesFor, sentWord, shouldShowError, submitButtonLabelsHtml, submitButtonView, submitEndpointPath, submitOutcome, todayIso, uniqueFieldName, uniqueFieldNames, validateField, validateForm, weekStartFor, withAntiSpamFields };
+export type { CalendarDay, CalendarMonth, CalendarOptions, ClientFormSpec, DateBoundParams, DatePickerWords, FieldError, FieldMarkupOptions, FieldOption, FieldOptionSource, FieldResult, FieldSpec, FormNodeLike, FormPresetChannel, FormPresetDef, FormPresetField, FormResult, FormRuntimeState, FormSpec, FormTransport, MisplacedFormContent, NestingNode, RuleDescriptor, SubmitAction, SubmitButtonView, SubmitLabels, SubmitOutcome, SubmitRequest, SubmitResponse, ValidateOptions, ValidationRule };

package/generation-core/index.d.ts

@@ -6929,6 +6929,9 @@ declare enum SiteFindingCode {
     NoHeader = "no-header",
     NoPhoneMenu = "no-phone-menu",
     FormWithoutId = "form-without-id",
+    /** Premium N2: a form's second way to reach you (WhatsApp, a phone, an email) has no address yet — the studio's own
+     *  fact, never written for it. */
+    EmptyChannel = "empty-channel",
     EmailNeedsMailer = "email-needs-mailer",
     TrackerWithoutBanner = "tracker-without-banner",
     NoTitle = "no-title",