@vectoriox/iox-ui 5.26.0 → 5.28.0

package/forms-core/index.d.ts

@@ -208,6 +208,18 @@ declare function collectFormSpec(node: FormNodeLike | null | undefined): FormSpe
 /** Every Field in this subtree, in document order, not descending into a nested Form. */
 declare function collectFieldNodes(nodes: readonly FormNodeLike[]): FormNodeLike[];
 
+/**
+ * A Field's `optionsText` trait — the author's choices, one per line — as options. ONE parser for the
+ * builder canvas, both engine paths and iox-cms: until 2026-10-19 nothing parsed the trait, so a Radio
+ * group or a Dropdown from the tray rendered no choices at all on the canvas and on the live site.
+ */
+declare function parseFieldOptions(text: unknown): FieldOption[];
+/** The choices a saved Field offers: an explicit `options` list wins, else its `optionsText` parsed. */
+declare function fieldOptionsOf(props: {
+    options?: unknown;
+    optionsText?: unknown;
+} | null | undefined): FieldOption[];
+
 /** Everything the runtime needs to remember. Immutable — each transition returns a new state. */
 interface FormRuntimeState {
     /** Field names the visitor has left (blurred) at least once. */
@@ -343,7 +355,11 @@ type FormTransport = (request: SubmitRequest) => Promise<SubmitResponse>;
  * The public submit path. Built here rather than interpolated at each call site, so the engine and
  * any future host cannot disagree about it — and so changing it is one edit.
  *
- * Deliberately relative and WITHOUT a leading slash: the engine mounts under a per-org base href.
+ * ⚠️ ROOT-relative (leading slash), never base-relative. A live site is served under a per-org
+ * `<base href="/<label>/">`, so a relative `api/…` resolved to `/<label>/api/…` — a path the reverse
+ * proxy (`/api` → iox-cms, everything else → the engine) hands to the ENGINE, which answers a POST with
+ * 404: no visitor submission ever reached iox-cms from an org path (found 2026-10-19 by
+ * e2e:forminsert:real). The org is already in the path segment after `site/`.
  */
 declare function submitEndpointPath(orgId: string, formId: string): string;
 /**
@@ -363,5 +379,5 @@ declare function withAntiSpamFields(values: Record<string, any>, renderedAt: num
  */
 declare function interpretSubmitResponse(body: any): SubmitResponse;
 
-export { ControlType, DEFAULT_EN_MESSAGES, FIELD_NODE_TYPE, FORM_ERROR_KEYS, FORM_NODE_TYPE, FeedbackTiming, HONEYPOT_FIELD, IMPLIED_PATTERN, INITIAL_FORM_STATE, 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, addableRules, applyServerErrors, collectFieldNodes, collectFormSpec, deriveFieldName, firstInvalidField, interpretSubmitResponse, onFieldBlur, onFieldChange, onSubmitAttempt, resetFormState, rulesFor, shouldShowError, submitEndpointPath, uniqueFieldName, validateField, validateForm, withAntiSpamFields };
+export { ControlType, DEFAULT_EN_MESSAGES, FIELD_NODE_TYPE, FORM_ERROR_KEYS, FORM_NODE_TYPE, FeedbackTiming, HONEYPOT_FIELD, IMPLIED_PATTERN, INITIAL_FORM_STATE, 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, addableRules, applyServerErrors, collectFieldNodes, collectFormSpec, deriveFieldName, fieldOptionsOf, firstInvalidField, interpretSubmitResponse, onFieldBlur, onFieldChange, onSubmitAttempt, parseFieldOptions, resetFormState, rulesFor, shouldShowError, submitEndpointPath, uniqueFieldName, validateField, validateForm, withAntiSpamFields };
 export type { FieldError, FieldOption, FieldOptionSource, FieldResult, FieldSpec, FormNodeLike, FormResult, FormRuntimeState, FormSpec, FormTransport, RuleDescriptor, SubmitAction, SubmitRequest, SubmitResponse, ValidationRule };