@vectoriox/iox-ui 5.29.0 → 5.30.0

package/forms-core/index.d.ts

@@ -403,7 +403,7 @@ interface FormPresetField {
     rows?: number;
 }
 interface FormPresetDef {
-    id: string;
+    id: `${FormPresetId}`;
     name: string;
     icon: string;
     /** One line in the panel: what it collects and where it goes. */
@@ -419,5 +419,48 @@ declare const FORM_PRESETS: readonly FormPresetDef[];
 /** The preset with this id, or undefined. */
 declare function formPresetById(id: string | null | undefined): FormPresetDef | undefined;
 
-export { ControlType, DEFAULT_EN_MESSAGES, FIELD_NODE_TYPE, FORM_ERROR_KEYS, FORM_NODE_TYPE, FORM_PRESETS, FeedbackTiming, FormPresetId, 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, formPresetById, interpretSubmitResponse, onFieldBlur, onFieldChange, onSubmitAttempt, parseFieldOptions, resetFormState, rulesFor, shouldShowError, submitEndpointPath, uniqueFieldName, validateField, validateForm, withAntiSpamFields };
-export type { FieldError, FieldOption, FieldOptionSource, FieldResult, FieldSpec, FormNodeLike, FormPresetDef, FormPresetField, FormResult, FormRuntimeState, FormSpec, FormTransport, RuleDescriptor, SubmitAction, SubmitRequest, SubmitResponse, ValidationRule };
+declare enum InteractiveTag {
+    Anchor = "a",
+    Button = "button"
+}
+/**
+ * Every node type that renders as an interactive element, and the element(s) it can render. A ButtonBlock
+ * renders `<a>` or `<button>` by its `tag` trait — both interactive, so switching the tag never lifts the
+ * rule. Pinned to the engine components' selectors by `interactive-hosts.spec.ts`.
+ */
+declare const INTERACTIVE_HOST_TAGS: Readonly<Record<string, readonly InteractiveTag[]>>;
+declare const FIELD_GROUP_NODE_TYPE = "FieldGroup";
+declare const SUBMIT_BUTTON_NODE_TYPE = "SubmitButton";
+/**
+ * Form content — what a link or a button must never hold: a Form (its controls), a Field (an input, select
+ * or textarea), a SubmitButton (a `<button>`) and a FieldGroup (it exists only to hold fields, so it moves as
+ * one). A Success / Error block is text and lives only inside its form, so it is not on the list.
+ */
+declare const FORM_CONTENT_TYPES: ReadonlySet<string>;
+/** The minimum a node must look like — a builder ComponentNode and a saved layout node both do. */
+interface NestingNode {
+    id?: string;
+    type?: string;
+    label?: string;
+    children?: NestingNode[] | null;
+}
+declare function isInteractiveHost(node: NestingNode | null | undefined): boolean;
+declare function isFormContent(node: NestingNode | null | undefined): boolean;
+/**
+ * The first form-content node in `node`'s subtree that sits inside an interactive host, or null. `insideHost`
+ * is true when `node` is placed under a host already — so a Form dropped into a link and a link that holds a
+ * Form are the same finding.
+ */
+declare function formContentInHost(node: NestingNode | null | undefined, insideHost?: boolean): NestingNode | null;
+/** One place a tree holds form content inside a link or a button. */
+interface MisplacedFormContent<N extends NestingNode = NestingNode> {
+    /** The OUTERMOST interactive host holding it. */
+    host: N;
+    /** A MAXIMAL form-content subtree inside it — the Form, never each of its fields. */
+    content: N;
+}
+/** 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_CONTENT_TYPES, FORM_ERROR_KEYS, FORM_NODE_TYPE, FORM_PRESETS, FeedbackTiming, FormPresetId, 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, addableRules, applyServerErrors, collectFieldNodes, collectFormSpec, deriveFieldName, fieldOptionsOf, findFormContentInHosts, firstInvalidField, formContentInHost, formPresetById, interpretSubmitResponse, isFormContent, isInteractiveHost, onFieldBlur, onFieldChange, onSubmitAttempt, parseFieldOptions, resetFormState, rulesFor, shouldShowError, submitEndpointPath, uniqueFieldName, validateField, validateForm, withAntiSpamFields };
+export type { FieldError, FieldOption, FieldOptionSource, FieldResult, FieldSpec, FormNodeLike, FormPresetDef, FormPresetField, FormResult, FormRuntimeState, FormSpec, FormTransport, MisplacedFormContent, NestingNode, RuleDescriptor, SubmitAction, SubmitRequest, SubmitResponse, ValidationRule };

package/index.d.ts

@@ -1371,6 +1371,7 @@ declare class IoxComponentRegistryService {
     private readonly map;
     getComponent(type: string): Type<any> | undefined;
     hasComponent(type: string): boolean;
+    registeredTypes(): string[];
     static ɵfac: i0.ɵɵFactoryDeclaration<IoxComponentRegistryService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<IoxComponentRegistryService>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "5.29.0",
+  "version": "5.30.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",

package/src/forms-core/form-presets.ts

@@ -25,7 +25,7 @@ export interface FormPresetField {
 }
 
 export interface FormPresetDef {
-    id: string;
+    id: `${FormPresetId}`;
     name: string;
     icon: string;
     /** One line in the panel: what it collects and where it goes. */
@@ -38,9 +38,13 @@ export interface FormPresetDef {
     errorText: string;
 }
 
-export const FORM_PRESETS: readonly FormPresetDef[] = Object.freeze([
+// forms-core is imported by both renderers (the field runtime), and a renderer that never reads the presets
+// must drop them: the call is `@__PURE__`, and the ids are written as the enum's VALUES (typed by it, pinned
+// to it by form-presets.spec) — a read of `FormPresetId.X` counts as a side effect to a bundler and kept the
+// whole list in the engine's bundle.
+export const FORM_PRESETS: readonly FormPresetDef[] = /* @__PURE__ */ Object.freeze([
     {
-        id: FormPresetId.Contact, name: 'Contact', icon: 'ph-thin ph-envelope-simple',
+        id: 'contact', name: 'Contact', icon: 'ph-thin ph-envelope-simple',
         description: 'Name, email and a message. Stored, and emailed to you.',
         formName: 'Contact form',
         fields: [
@@ -53,7 +57,7 @@ export const FORM_PRESETS: readonly FormPresetDef[] = Object.freeze([
         errorText: 'We couldn’t send your message. Please try again — your answers are still here.',
     },
     {
-        id: FormPresetId.Newsletter, name: 'Newsletter', icon: 'ph-thin ph-paper-plane-tilt',
+        id: 'newsletter', name: 'Newsletter', icon: 'ph-thin ph-paper-plane-tilt',
         description: 'One email field plus consent. Stored.',
         formName: 'Newsletter signup',
         fields: [
@@ -67,7 +71,7 @@ export const FORM_PRESETS: readonly FormPresetDef[] = Object.freeze([
         errorText: 'We couldn’t sign you up. Please try again.',
     },
     {
-        id: FormPresetId.Application, name: 'Application', icon: 'ph-thin ph-read-cv-logo',
+        id: 'application', name: 'Application', icon: 'ph-thin ph-read-cv-logo',
         description: 'Details plus a CV upload. Stored, with an auto-reply.',
         formName: 'Application',
         fields: [
@@ -83,7 +87,7 @@ export const FORM_PRESETS: readonly FormPresetDef[] = Object.freeze([
         errorText: 'We couldn’t submit your application. Please try again.',
     },
     {
-        id: FormPresetId.Booking, name: 'Booking request', icon: 'ph-thin ph-calendar-check',
+        id: 'booking', name: 'Booking request', icon: 'ph-thin ph-calendar-check',
         description: 'Date and party size. Stored, and it notifies you.',
         formName: 'Booking request',
         fields: [

package/src/forms-core/nesting.ts

@@ -0,0 +1,92 @@
+// Where form content may NOT render (Doron, 2026-10-20): inside a link or a button.
+//
+// HTML forbids interactive content inside `<a>` and `<button>`, and a click in a field may follow the
+// link. ONE table and ONE walk, shared by the builder's insert rule (refuse it), the builder's audit
+// (find it in a page saved before the rule) and the engine (warn about it, never rewrite it).
+
+import { FIELD_NODE_TYPE, FORM_NODE_TYPE } from './collect';
+
+export enum InteractiveTag {
+    Anchor = 'a',
+    Button = 'button',
+}
+
+/**
+ * Every node type that renders as an interactive element, and the element(s) it can render. A ButtonBlock
+ * renders `<a>` or `<button>` by its `tag` trait — both interactive, so switching the tag never lifts the
+ * rule. Pinned to the engine components' selectors by `interactive-hosts.spec.ts`.
+ */
+export const INTERACTIVE_HOST_TAGS: Readonly<Record<string, readonly InteractiveTag[]>> = Object.freeze({
+    LinkedContainer: [InteractiveTag.Anchor],
+    Link: [InteractiveTag.Anchor],
+    Button: [InteractiveTag.Anchor],
+    ButtonBlock: [InteractiveTag.Anchor, InteractiveTag.Button],
+    SubmitButton: [InteractiveTag.Button],
+});
+
+export const FIELD_GROUP_NODE_TYPE = 'FieldGroup';
+export const SUBMIT_BUTTON_NODE_TYPE = 'SubmitButton';
+
+/**
+ * Form content — what a link or a button must never hold: a Form (its controls), a Field (an input, select
+ * or textarea), a SubmitButton (a `<button>`) and a FieldGroup (it exists only to hold fields, so it moves as
+ * one). A Success / Error block is text and lives only inside its form, so it is not on the list.
+ */
+export const FORM_CONTENT_TYPES: ReadonlySet<string> = new Set([
+    FORM_NODE_TYPE, FIELD_NODE_TYPE, FIELD_GROUP_NODE_TYPE, SUBMIT_BUTTON_NODE_TYPE,
+]);
+
+/** The minimum a node must look like — a builder ComponentNode and a saved layout node both do. */
+export interface NestingNode {
+    id?: string;
+    type?: string;
+    label?: string;
+    children?: NestingNode[] | null;
+}
+
+export function isInteractiveHost(node: NestingNode | null | undefined): boolean {
+    return !!node?.type && Object.prototype.hasOwnProperty.call(INTERACTIVE_HOST_TAGS, node.type);
+}
+
+export function isFormContent(node: NestingNode | null | undefined): boolean {
+    return !!node?.type && FORM_CONTENT_TYPES.has(node.type);
+}
+
+/**
+ * The first form-content node in `node`'s subtree that sits inside an interactive host, or null. `insideHost`
+ * is true when `node` is placed under a host already — so a Form dropped into a link and a link that holds a
+ * Form are the same finding.
+ */
+export function formContentInHost(node: NestingNode | null | undefined, insideHost = false): NestingNode | null {
+    if (!node) return null;
+    if (insideHost && isFormContent(node)) return node;
+    const nowInside = insideHost || isInteractiveHost(node);
+    for (const child of node.children ?? []) {
+        const found = formContentInHost(child, nowInside);
+        if (found) return found;
+    }
+    return null;
+}
+
+/** One place a tree holds form content inside a link or a button. */
+export interface MisplacedFormContent<N extends NestingNode = NestingNode> {
+    /** The OUTERMOST interactive host holding it. */
+    host: N;
+    /** A MAXIMAL form-content subtree inside it — the Form, never each of its fields. */
+    content: N;
+}
+
+/** Every form-content subtree a tree holds inside an interactive host, in document order. */
+export function findFormContentInHosts<N extends NestingNode>(roots: readonly N[] | null | undefined): MisplacedFormContent<N>[] {
+    const out: MisplacedFormContent<N>[] = [];
+    const visit = (node: N, host: N | null): void => {
+        if (host && isFormContent(node)) {
+            out.push({ host, content: node });
+            return;
+        }
+        const nextHost = host ?? (isInteractiveHost(node) ? node : null);
+        for (const child of (node.children ?? []) as N[]) visit(child, nextHost);
+    };
+    for (const root of roots ?? []) visit(root, null);
+    return out;
+}

package/src/forms-core/public-api.ts

@@ -19,3 +19,4 @@ export * from './runtime';
 export * from './rule-catalog';
 export * from './transport';
 export * from './form-presets';
+export * from './nesting';