@vectoriox/iox-builder 9.0.0 → 9.1.0

package/index.d.ts

@@ -969,14 +969,17 @@ declare const EDITOR_CHROME_ATTRIBUTE = "data-iox-chrome";
 
 /**
  * What may NOT be placed where — the ONE rule every insert path asks (drag, click-to-insert, quick-add,
- * the Form presets, paste, duplicate). Everything not refused here is accepted: any container-capable
- * node takes any child, a Form included.
+ * the Form presets, paste, duplicate, layer-tree moves, Wrap in ▸). Everything not refused here is accepted:
+ * any container-capable node takes any child, a Form included.
  */
 declare enum InsertRefusal {
     /** A form inside a form — fields belong to their NEAREST form (forms plan D1), and HTML forbids it. */
     NestedForm = "nestedForm",
     /** A Success / Error block is part of its form's state machine; it is never placed on its own. */
-    StateBlockAlone = "stateBlockAlone"
+    StateBlockAlone = "stateBlockAlone",
+    /** Form content inside a link or a button (Doron, 2026-10-20) — HTML forbids interactive content in
+     *  `<a>`/`<button>`, and a click in a field would follow the link. The table is forms-core's. */
+    FormInInteractive = "formInInteractive"
 }
 declare const FORM_STATE_BLOCK_TYPES: ReadonlySet<string>;
 /** The builder-chrome label that says each refusal on screen (English in `BUILDER_CHROME_EN`). */
@@ -990,7 +993,7 @@ interface TypedNode {
 /**
  * Why `node` may not be inserted under `ancestors` (outermost first, the new parent last; empty = the page),
  * or null when it may. `node` is the whole subtree being placed — a Container holding a Form is refused
- * inside a Form just as a bare Form is. Reordering a node inside its CURRENT parent is not an insert and
+ * inside a Form just as a bare Form is, and a link that holds a form is refused wherever it goes. Reordering a node inside its CURRENT parent is not an insert and
  * never asks.
  */
 declare function insertRefusal(node: TypedNode | null | undefined, ancestors: readonly TypedNode[]): InsertRefusal | null;
@@ -1779,7 +1782,14 @@ declare enum AuditCode {
     /** A slider showing more slides than the width can carry — each one unreadably narrow. */
     SlidesOverflow = "slides-overflow",
     /** An out-of-flow node whose box lands outside the frame, so it is unreachable at this width. */
-    OffscreenAbsolute = "offscreen-absolute"
+    OffscreenAbsolute = "offscreen-absolute",
+    /** Form content inside a link or a button — a STRUCTURE finding, true at every width (form-nesting-audit.util). */
+    FormInLink = "form-in-link"
+}
+/** A fix that changes the tree, not a style or a trait — applied as one page-history step. */
+declare enum StructureFix {
+    /** Move the form out of the link or button holding it, to right after it. */
+    MoveFormOut = "move-form-out"
 }
 declare enum AuditSeverity {
     Error = "error",
@@ -1815,6 +1825,10 @@ interface AuditFinding {
     /** TRAIT values to write into this breakpoint's layer — some failures are not fixable with CSS.
      *  Applied through `setInputOverride`, the trait twin of `setOverride`. */
     inputFix?: Record<string, any>;
+    /** A fix that moves nodes — never part of "Fix all", the author applies each one. */
+    structureFix?: StructureFix;
+    /** The fix button's words, when they are not the generic "Fix". */
+    fixLabel?: string;
 }
 /**
  * Audit nodes laid out at `viewportWidth`. Returns findings ordered by severity (errors first),
@@ -1923,6 +1937,7 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     private selectoCanvas;
     private styleRegistry;
     private contextStore;
+    private labels;
     /**
      * Re-apply context-bound inputs on the CANVAS when a slot changes — the builder twin of the
      * engine's effect. The canvas is a live runtime, so hovering a repeater row while editing must
@@ -1986,6 +2001,9 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     browseComponents(): void;
     /** Findings for the width being edited; the panel is open while `auditOpen`. */
     auditFindings: AuditFinding[];
+    /** Width-independent findings (a form inside a link), kept current on every load and edit so the
+     *  audit button shows them before the audit is ever opened. */
+    structureFindings: AuditFinding[];
     auditOpen: boolean;
     auditRunning: boolean;
     get auditBreakpointLabel(): string;
@@ -1999,6 +2017,9 @@ declare class BuilderComponent implements OnInit, AfterViewInit, OnChanges, OnDe
     runAudit(): void;
     /** The node's OWN trait values — the Base layer the responsive `inputs` cascade sits on top of. */
     private baseInputMapOf;
+    private refreshStructureFindings;
+    /** A structure fix moves nodes on the page: ONE layout change, so ONE undo step. */
+    private applyStructureFix;
     /** Apply one finding's fix into the current breakpoint's layer (or the base styles at Base). */
     applyAuditFix(finding: AuditFinding): void;
     /** Apply every fixable finding, then re-measure. */
@@ -3143,8 +3164,9 @@ declare class AuditPanelComponent {
     closePanel: EventEmitter<void>;
     readonly severities: typeof AuditSeverity;
     trackFinding(_index: number, finding: AuditFinding): string;
-    /** Findings that carry a safe auto-fix — what "Fix all" would apply. */
+    /** Findings that carry a safe auto-fix — what "Fix all" applies (a structure fix is the author's call). */
     get fixableCount(): number;
+    hasFix(finding: AuditFinding): boolean;
     iconFor(severity: AuditSeverity): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<AuditPanelComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AuditPanelComponent, "app-audit-panel", never, { "findings": { "alias": "findings"; "required": false; }; "breakpointLabel": { "alias": "breakpointLabel"; "required": false; }; "running": { "alias": "running"; "required": false; }; }, { "select": "select"; "fix": "fix"; "fixAll": "fixAll"; "rerun": "rerun"; "closePanel": "closePanel"; }, never, never, false, never>;
@@ -3655,5 +3677,5 @@ declare class TextBlockComponentConfig extends ComponentConfig {
     constructor();
 }
 
-export { ACTION_TYPE_OPTIONS, AuditCode, AuditPanelComponent, AuditSeverity, BODY_CRUMB_LABEL, BREAKPOINT_PRESENTATION, BUILDER_CANVAS_CONTAINER, BUILDER_CHROME_EN, BUILDER_FONT_LINK_ATTR, BUILDER_TOKEN_SCOPE_CLASS, BackgroundGroupStyleConfig, BorderGroupStyleConfig, BreadcrumbBarComponent, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDataSourceService, BuilderDialogComponent, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CANVAS_EMPTY_IMAGE_LABEL_EN, CANVAS_EMPTY_IMAGE_LABEL_KEY, CANVAS_ROOT_RESET_CSS, CardComponentConfig, ChildLayoutGroupStyleConfig, ComponentConfig, ComponentRegistryService, DEFAULT_ESSENTIAL_TRAITS, DRAG_HANDLE_ATTR, DROP_REFUSED_CLASS, DataSourceRegistryService, DataSourceType, DialogComponentConfig, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, EDITOR_CHROME_ATTRIBUTE, ESSENTIAL_TRAITS_BY_TYPE, EffectsGroupStyleConfig, FIELD_KIND_PRESETS, FIELD_PARTS, FORM_STATE_BLOCK_TYPES, FORM_TYPE, FieldComponentConfig, FieldGroupComponentConfig, FormComponentConfig, FormErrorComponentConfig, FormStateService, FormSuccessComponentConfig, GalleryConfig, GroupStyleConfig, INSERT_REFUSAL_LABEL_KEYS, INTERACTION_STATES, INVERSE_ACTION, IOX_BUILDER_CANVAS, IOX_BUILDER_LABELS, IOX_DATA_SOURCE_ENDPOINTS, InsertRefusal, InteractionEngineService, InteractionPresetRegistryService, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LAYOUT_PRESETS, LayerTreeComponent, LayoutGroupStyleConfig, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PALETTE_PRESET_DEFS, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PositionGroupStyleConfig, PresetRegistryService, RELATIONAL_STATES, RELATIONAL_STATE_BASE, ROOT_ESCAPE_PX, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, RootZone, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, SizeGroupStyleConfig, SliderContainerComponent, SliderContainerConfig, SliderSlideComponent, SliderSlideConfig, SpacingGroupStyleConfig, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, SubmitButtonComponentConfig, SymbolRegistryService, TARGETED_STATES, TARGETED_STATE_BASE, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, TypographyGroupStyleConfig, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, VALIDATION_STATES, VALIDATION_STATE_CLASS, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, auditNodes, buildConsentPreset, buildElementStyleSpecimen, buildFieldKindPreset, buildFlavorSpecimen, buildFormPreset, buildFullStyleTraits, buildLayoutPreset, buildPalettePreset, buildPresetStyleTraits, canFluidise, canvasEmptyImageLabel, collapseColumnsProps, columnCountOf, defaultBuilderLabels, defaultPageSettings, dropTargetLabel, escapesRoot, essentialTraitsFor, findNodeLocation, findParentOf, flattenSchemaFields, fluidiseProps, generateNodeId, insertRefusal, insertRefusalLabel, isHiddenAt, isSpecimen, markSpecimen, matchesControlSearch, nearestFormNode, nodeAncestorPath, nodeAncestorPathInEither, reorderProps, resolveInsertTarget, resolveTraitControllerType, resolveTraitOptions, rootEscapeBand, rootZone, setStyleTrait, setTrait, stackChildrenProps, summarise, syncEmptyImagePlaceholder, syncNodeDesign, textNode, visibilityProps, wrapNode };
+export { ACTION_TYPE_OPTIONS, AuditCode, AuditPanelComponent, AuditSeverity, BODY_CRUMB_LABEL, BREAKPOINT_PRESENTATION, BUILDER_CANVAS_CONTAINER, BUILDER_CHROME_EN, BUILDER_FONT_LINK_ATTR, BUILDER_TOKEN_SCOPE_CLASS, BackgroundGroupStyleConfig, BorderGroupStyleConfig, BreadcrumbBarComponent, BuilderButtonBlockComponent, BuilderButtonComponentConfig, BuilderClipboardService, BuilderComponent, BuilderContainerComponent, BuilderContainerComponentConfig, BuilderDataSourceService, BuilderDialogComponent, BuilderDividerComponentConfig, BuilderHeadingComponentConfig, BuilderHistoryService, BuilderIconComponentConfig, BuilderImageComponentConfig, BuilderLinkComponentConfig, BuilderLinkedContainerComponent, BuilderLinkedContainerConfig, BuilderListComponentConfig, BuilderListItemComponentConfig, BuilderMode, BuilderRepeaterComponent, BuilderSpacerComponentConfig, ButtonBlockComponentConfig, CANVAS_EMPTY_IMAGE_LABEL_EN, CANVAS_EMPTY_IMAGE_LABEL_KEY, CANVAS_ROOT_RESET_CSS, CardComponentConfig, ChildLayoutGroupStyleConfig, ComponentConfig, ComponentRegistryService, DEFAULT_ESSENTIAL_TRAITS, DRAG_HANDLE_ATTR, DROP_REFUSED_CLASS, DataSourceRegistryService, DataSourceType, DialogComponentConfig, DimensionsGroupStyleConfig, DragEngineService, EASING_OPTIONS, EDITOR_CHROME_ATTRIBUTE, ESSENTIAL_TRAITS_BY_TYPE, EffectsGroupStyleConfig, FIELD_KIND_PRESETS, FIELD_PARTS, FORM_STATE_BLOCK_TYPES, FORM_TYPE, FieldComponentConfig, FieldGroupComponentConfig, FormComponentConfig, FormErrorComponentConfig, FormStateService, FormSuccessComponentConfig, GalleryConfig, GroupStyleConfig, INSERT_REFUSAL_LABEL_KEYS, INTERACTION_STATES, INVERSE_ACTION, IOX_BUILDER_CANVAS, IOX_BUILDER_LABELS, IOX_DATA_SOURCE_ENDPOINTS, InsertRefusal, InteractionEngineService, InteractionPresetRegistryService, IoxBuilderModule, IoxDraggableDirective, IoxDropzoneDirective, LAYOUT_PRESETS, LayerTreeComponent, LayoutGroupStyleConfig, ListGroupStyleConfig, NodeAction, OverlayComponent, OverlayService, PALETTE_PRESET_DEFS, PanelChildComponent, PanelComponent, PanelEventService, PanelEventTypes, PanelTypes, PositionGroupStyleConfig, PresetRegistryService, RELATIONAL_STATES, RELATIONAL_STATE_BASE, ROOT_ESCAPE_PX, ROUTE_ANIMATION_OPTIONS, RenderDirective, RepeaterComponentConfig, RootZone, SCREEN_WIDTH_OPTIONS, STRUCTURAL_STATES, SUPPORTED_STATES, SectionComponent, SectionComponentConfig, SizeGroupStyleConfig, SliderContainerComponent, SliderContainerConfig, SliderSlideComponent, SliderSlideConfig, SpacingGroupStyleConfig, StructureFix, StyleCategory, StyleRegistryService, TraitConfig as StyleTraitConfig, SubmitButtonComponentConfig, SymbolRegistryService, TARGETED_STATES, TARGETED_STATE_BASE, TRIGGER_OPTIONS, TextBlockComponentConfig, ToolbarAction, ToolbarComponent, TraitConfig, TraitInputType, TypographyGroupStyleConfig, UNITS_ALL, UNITS_DEG, UNITS_FIXED, UNITS_NO_VW, VALIDATION_STATES, VALIDATION_STATE_CLASS, ViewportService, ZOOM_OPTIONS, arrayItemSchemaFields, arraySchemaFields, auditNodes, buildConsentPreset, buildElementStyleSpecimen, buildFieldKindPreset, buildFlavorSpecimen, buildFormPreset, buildFullStyleTraits, buildLayoutPreset, buildPalettePreset, buildPresetStyleTraits, canFluidise, canvasEmptyImageLabel, collapseColumnsProps, columnCountOf, defaultBuilderLabels, defaultPageSettings, dropTargetLabel, escapesRoot, essentialTraitsFor, findNodeLocation, findParentOf, flattenSchemaFields, fluidiseProps, generateNodeId, insertRefusal, insertRefusalLabel, isHiddenAt, isSpecimen, markSpecimen, matchesControlSearch, nearestFormNode, nodeAncestorPath, nodeAncestorPathInEither, reorderProps, resolveInsertTarget, resolveTraitControllerType, resolveTraitOptions, rootEscapeBand, rootZone, setStyleTrait, setTrait, stackChildrenProps, summarise, syncEmptyImagePlaceholder, syncNodeDesign, textNode, visibilityProps, wrapNode };
 export type { AuditFinding, AuditNode, BreakpointPresentation, BuilderClipboard, BuilderLabelResolver, ComponentEventDef, ComponentMethodDef, ComponentNode, ComponentTrait, ConsentPreset, CreateConfig, Crumb, DesignSpecimenCopy, DragPayload, DsFilterByQueryParam, DsFilterByRouteParam, ElementState, FieldKindDef, FormStateSnapshot, HistoryChange, HistoryEntry, HistoryStep, InsertRefusedEvent, InsertTarget, InteractionAction, InteractionActionType, InteractionPreset, InteractionTrigger, IoxBinding, IoxDataSource, IoxDropEvent, IoxInteraction, IoxSymbol, LayoutPresetChildStyles, LayoutPresetDef, NodeRef, OverlayBoxModel, OverlayBoxSpacing, OverlayEntry, PageRouteAnimationSettings, PageScrollSettings, PageSettings, PalettePresetDef, PanelEvent, QuadSizeSegment, RootEscapeMemory, RouteAnimationPreset, ScreenWidthOption, SelectionBadge, StyleMap, StylePart, StylePreset, StyleTrait, StyleTraitGroup, TraitOptionMap, TraitSelectOption, TraitShowCondition, TreePathNode, UpsertTokensOptions, ViewportState, ZoomOption };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@vectoriox/iox-builder",
-  "version": "9.0.0",
+  "version": "9.1.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",
     "@angular/animations": ">=20.0.0",
     "@angular/cdk": ">=20.0.0",
-    "@vectoriox/iox-ui": ">=5.22.0",
+    "@vectoriox/iox-ui": ">=5.30.0",
     "interactjs": "^1.10.27",
     "primeng": ">=20.0.0",
     "swiper": ">=12.0.0",