@vectoriox/iox-builder 4.12.1 → 4.14.0

package/fesm2022/vectoriox-iox-builder.mjs

@@ -180,6 +180,12 @@ var TraitInputType;
     /** Ordered list of images (URL / one-by-one / filebox; per-item binding in a later phase).
      *  Controller registered in the consumer (iox-cms-client) as `mediaList`. Value: GalleryImage[]. */
     TraitInputType["MediaList"] = "mediaList";
+    /** Additive validation rules for a Field (`ValidationRule[]` from forms-core). Controller
+     *  registered in the consumer (iox-cms-client) as `ruleList`. */
+    TraitInputType["RuleList"] = "ruleList";
+    /** The ordered "After submit" action list on a Form (`SubmitAction[]`). Controller registered
+     *  in the consumer as `actionList`. */
+    TraitInputType["ActionList"] = "actionList";
     TraitInputType["FontFamily"] = "fontFamily";
     TraitInputType["GridTemplate"] = "gridTemplate";
     TraitInputType["SectionLabel"] = "sectionLabel";
@@ -701,15 +707,42 @@ const freshId = () => Math.random().toString(36).substr(2, 9);
  * A reference pointing OUTSIDE the cloned subtree (id not in the map) is left untouched — the copy
  * intentionally still points at the external node.
  *
+ * TRAIT values are NOT ids and are copied verbatim — with one exception. A trait that carries an
+ * IDENTITY rather than a setting must be reissued, or the copy silently shares the original's
+ * identity. `formId` is the first: two forms with the same id share one submissions stream, and the
+ * server resolves a submission against whichever page it reaches first. See REGENERATED_TRAITS.
+ *
  * `styleId` strategy:
  *   - `'clear'` (default) — drop styleId so the clone OWNS its own CSS rule (independent copy).
  *   - `'regenerate'`      — keep a styleId but give it a fresh value (legacy builder.component path).
  */
+/**
+ * Trait names whose value is an IDENTITY, not a setting, and must therefore be reissued on every
+ * clone. Add a name here the moment a trait starts identifying something rather than describing it.
+ *
+ * `formId` — a form's submissions stream. Duplicating a page, pasting a form or dropping a saved
+ * block twice used to produce two forms claiming the same stream.
+ */
+const REGENERATED_TRAITS = new Set(['formId']);
+/** Reissue identity-carrying traits on a node, preserving the original's prefix where it had one. */
+function reissueIdentityTraits(node) {
+    for (const trait of (node.traits ?? [])) {
+        if (!trait?.name || !REGENERATED_TRAITS.has(trait.name))
+            continue;
+        if (trait.default === undefined || trait.default === '')
+            continue;
+        // Keep the human-readable prefix a preset gave it (`contact-a1b2c3` → `contact-<new>`), so a
+        // duplicated contact form is still recognisably a contact form in the inbox.
+        const prefix = String(trait.default).split('-')[0];
+        trait.default = `${prefix}-${freshId()}`;
+    }
+}
 function regenerateNodeIds(root, opts = {}) {
     const idMap = new Map();
     const assign = (node) => {
         const oldId = node.id;
         node.id = freshId();
+        reissueIdentityTraits(node);
         if (opts.styleId === 'regenerate') {
             if (node.styleId)
                 node.styleId = freshId();
@@ -9663,6 +9696,10 @@ 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),
+            // 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' }]),
             new TraitConfig('__dataLabel', 'Data', TraitInputType.SectionLabel),
             // Absent means keep forever — the confirmed default. A number opts into purging.
             new TraitConfig('retentionDays', 'Delete submissions after (days)', TraitInputType.Number, undefined, ''),
@@ -9710,13 +9747,16 @@ class FieldComponentConfig extends ComponentConfig {
                 { label: 'Radio group', value: 'radio' },
                 { label: 'Date', value: 'date' },
                 { label: 'Time', value: 'time' },
-                { label: 'File upload', value: 'file' },
+                // ⚠️ 'file' is DELIBERATELY ABSENT until uploads are implemented. A file input's
+                // `value` is the browser's fake path (`C:\fakepath\cv.pdf`), and `fileType`/
+                // `fileSize` operate on a file list — so on a string they pass vacuously. Offering
+                // it meant an author could set "PDF only, 5MB" and silently get neither the
+                // 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('help', 'Help text', TraitInputType.Text, undefined, ''),
             new TraitConfig('rows', 'Rows', TraitInputType.Number, undefined, 4, false, { trait: 'control', values: 'textarea' }),
-            new TraitConfig('accept', 'Accepted file types', TraitInputType.Text, undefined, '', false, { trait: 'control', values: 'file' }),
             new TraitConfig('labelHidden', 'Hide label (screen readers still read it)', TraitInputType.Checkbox, undefined, false),
             // The submitted key. Derived from the label; editable for external integrations.
             new TraitConfig('name', 'Submitted key', TraitInputType.Text, undefined, ''),
@@ -9727,9 +9767,9 @@ class FieldComponentConfig extends ComponentConfig {
             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),
-            // `rules` is the additive list (minLength, pattern, matches, …). Its editor is a panel
-            // concern; the node just carries the array.
-            new TraitConfig('rules', 'Rules', TraitInputType.Textarea, undefined, ''),
+            // 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, []),
         ];
         this.styleTraits = fullStyles();
         this.applyStyleDefaults({