@vectoriox/iox-builder 4.18.2 → 4.19.0

package/fesm2022/vectoriox-iox-builder.mjs

@@ -872,6 +872,13 @@ var PanelEventTypes;
      *  would (`string` component type, or a block / symbol object). The builder resolves WHERE from
      *  the current selection — see `resolveInsertTarget`. */
     PanelEventTypes["INSERT_COMPONENT"] = "insertcomponent";
+    /** A panel wants to select a NODE it already has a reference to (e.g. the Form's nested field
+     *  list). Carries `{ node }`. `OverlayService.setSelect()` alone only updates the overlay's own
+     *  visual state — `selectedItem`/`selectedPath` (breadcrumb) and every other panel's idea of
+     *  "what's selected" stay stale unless the SAME `_emitElementSelect` a real canvas click goes
+     *  through also runs. This event is that path for code outside `BuilderComponent` itself,
+     *  mirroring what `onTreeNodeSelect`/`onCrumbSelect` already do internally. */
+    PanelEventTypes["SELECT_NODE"] = "selectnode";
 })(PanelEventTypes || (PanelEventTypes = {}));
 class PanelEventService {
     constructor() {
@@ -7077,6 +7084,19 @@ class BuilderComponent {
             this.insertFromPanel(panelEvent.data);
             return;
         }
+        // A panel (e.g. the Form's nested field list) wants to select a node it already holds a
+        // reference to — same path onTreeNodeSelect/onCrumbSelect use, so selectedItem/selectedPath
+        // and every panel stay in sync, not just the overlay's own visual selection box.
+        if (panelEvent.type === PanelEventTypes.SELECT_NODE) {
+            const node = panelEvent.data?.node;
+            const ref = node ? this.overlayService.getNodeRef(node) : undefined;
+            if (node && ref) {
+                this.selectedItem = node;
+                this.overlayService.setSelect(ref.element, node.type, this.activeMode, node, ref.componentRef);
+                this._emitElementSelect(node, ref.componentRef);
+            }
+            return;
+        }
         // Every style or structural edit — including a breakpoint override — emits LAYOUT_CHANGED.
         if (panelEvent.type === PanelEventTypes.LAYOUT_CHANGED) {
             this.refreshBreakpointCounts();
@@ -9752,7 +9772,7 @@ class FormComponentConfig extends ComponentConfig {
             // Stable identity the submit endpoint resolves the saved spec by. Generated on create;
             // shown read-only-ish so an author can copy it into a webhook consumer.
             new TraitConfig('formId', 'Form ID', TraitInputType.Text, undefined, ''),
-            new TraitConfig('feedback', 'Validation feedback', TraitInputType.Select, [
+            new TraitConfig('feedback', 'Tell them about mistakes', TraitInputType.Select, [
                 { label: 'Smart — on submit, then live once touched', value: 'smart' },
                 { label: 'On submit only', value: 'submit' },
                 { label: 'As you type', value: 'live' },
@@ -9762,7 +9782,7 @@ class FormComponentConfig extends ComponentConfig {
             // On by default and invisible to the visitor (decision D12).
             new TraitConfig('honeypot', 'Honeypot field', TraitInputType.Checkbox, undefined, true),
             new TraitConfig('minFillMs', 'Minimum fill time (ms)', TraitInputType.Number, undefined, 1200),
-            new TraitConfig('__afterSubmitLabel', 'After submit', TraitInputType.SectionLabel),
+            new TraitConfig('__afterSubmitLabel', 'Where the answers go', TraitInputType.SectionLabel),
             // The ordered destination list. `store` is always first and cannot be removed — it is
             // the safety net the whole store-first design rests on.
             new TraitConfig('actions', 'Destinations', TraitInputType.ActionList, undefined, [{ type: 'store' }]),
@@ -9800,7 +9820,7 @@ class FieldComponentConfig extends ComponentConfig {
             new TraitConfig('label', 'Label', TraitInputType.Text, undefined, 'Label'),
             // Choosing the control also chooses the validation — an Email field validates email
             // with nothing configured.
-            new TraitConfig('control', 'Type', TraitInputType.Select, [
+            new TraitConfig('control', 'Kind of answer', TraitInputType.Select, [
                 { label: 'Text', value: 'text' },
                 { label: 'Email', value: 'email' },
                 { label: 'Phone', value: 'tel' },
@@ -9820,7 +9840,7 @@ class FieldComponentConfig extends ComponentConfig {
                 // enforcement nor the file. See forms-and-inputs-plan.md → Remaining work P0/1.
                 { label: 'Hidden', value: 'hidden' },
             ], 'text'),
-            new TraitConfig('placeholder', 'Placeholder', TraitInputType.Text, undefined, '', false, { trait: 'control', values: ['text', 'email', 'tel', 'url', 'number', 'password', 'textarea', 'select'] }),
+            new TraitConfig('placeholder', 'Hint inside the box', TraitInputType.Text, undefined, '', false, { trait: 'control', values: ['text', 'email', 'tel', 'url', 'number', 'password', 'textarea', 'select'] }),
             new TraitConfig('help', 'Help text', TraitInputType.Text, undefined, ''),
             new TraitConfig('rows', 'Rows', TraitInputType.Number, undefined, 4, false, { trait: 'control', values: 'textarea' }),
             new TraitConfig('labelHidden', 'Hide label (screen readers still read it)', TraitInputType.Checkbox, undefined, false),
@@ -9831,8 +9851,8 @@ class FieldComponentConfig extends ComponentConfig {
             // One per line, `value|Label` or just the label. A richer editor arrives with bound
             // options in Phase 2; this keeps v1 to one control instead of a new trait type.
             new TraitConfig('optionsText', 'Choices (one per line)', TraitInputType.Textarea, undefined, '', false, { trait: 'control', values: ['select', 'radio'] }),
-            new TraitConfig('__validationLabel', 'Validation', TraitInputType.SectionLabel),
-            new TraitConfig('required', 'Required', TraitInputType.Checkbox, undefined, false),
+            new TraitConfig('__validationLabel', 'What this field demands', TraitInputType.SectionLabel),
+            new TraitConfig('required', 'They must fill it in', TraitInputType.Checkbox, undefined, false),
             // The additive rule list (minLength, pattern, matches, …). Unused rules are invisible
             // rather than a wall of empty controls — the Effects-group pattern.
             new TraitConfig('rules', 'Rules', TraitInputType.RuleList, undefined, []),