@capillarytech/creatives-library 8.0.340-beta.0 → 8.0.340-beta.0.1

package/v2Containers/Sms/SCHEMA_FORMBUILDER_MAP.md

@@ -0,0 +1,922 @@
+# SMS `initialSchema.js` ↔ `FormBuilder/index.js` Mapping
+
+This document is a one-stop graph of how every node in
+`app/v2Containers/Sms/initialSchema.js` flows into
+`app/components/FormBuilder/index.js`. Use it to predict — for any change
+you make in the schema — exactly which branch of FormBuilder will be hit.
+
+---
+
+## 1. How the schema reaches FormBuilder
+
+```
+app/services/getSchema.js
+   └─ case SMS: import('../v2Containers/Sms/initialSchema')   ← exports `response`
+                                                              { metaEntities: [ { definition: {...} } ] }
+                                                                            │
+                                                                            ▼
+              container code (Sms/Edit etc.) extracts
+                  schema = response.metaEntities[0].definition
+                                                                            │
+                                                                            ▼
+                                          <FormBuilder schema={schema} ... />
+                                                                            │
+                ┌───────────── componentWillMount (101) ─────────────┐
+                │  initialiseForm(schema)                            │
+                │     ├─ initializeStandAloneSections(schema, …)    │
+                │     │    walks parent/multicols/col-label,        │
+                │     │    seeds  formData[col.id] = '' or col.value│
+                │     │    and    errorData[col.id] = false         │
+                │     │    pushes col.id into this.formElements     │
+                │     ├─ initializeContainers(schema, …)            │
+                │     │    only if schema.containers present (no-op │
+                │     │    for SMS)                                 │
+                │     └─ prunes formData keys NOT in formElements   │
+                │        (1302–1314) — schema is the source of truth│
+                └────────────────────────────────────────────────────┘
+                                                                            │
+                                                                            ▼
+                FormBuilder.render()  → renderForm()  (index.js:3164)
+                  └─ schema.standalone          → schema.standalone.sections.map(renderSection)
+                  └─ schema.containers          → renderContainer(...)        ← unused for SMS
+                  └─ schema.channel             → IS read by validateForm (437) — gate that
+                                                  triggers the SMS-specific validation block
+```
+
+The SMS schema only uses the `standalone` branch. `channel: "SMS"` at the
+top of `definition` IS load-bearing: `validateForm` (line 437) checks
+`this.props.schema.channel === 'SMS'` to enter the per-tab content/unicode
+validation loop. Changing this string disables SMS validation entirely.
+
+---
+
+## 1b. Initialization phase (runs BEFORE first render)
+
+Before any field is rendered, FormBuilder walks the schema twice — once to
+build `formData` (default values) and once to build `errorData` (defaults to
+`false` for every field). Both walks recurse the same shape that `render`
+will later traverse.
+
+Entry: `initialiseForm(schema)` (index.js:1273)
+   ├─ `initializeStandAloneSections(schema, …)` (1201) — only called for SMS
+   └─ `initializeContainers(schema, …)` (1219) — no-op for SMS (no `containers`)
+
+```
+initializeStandAloneSections
+   └─ for each schema.standalone.sections[]
+        ├─ "multicols"  → initializeMultiColSection (1089)
+        ├─ "col-label"  → initializeColLabelSection (1162)
+        └─ "parent"     → initializeParentSection (1046)  ← recurses
+```
+
+`initializeMultiColSection` (the one that touches every SMS leaf field):
+
+| Schema key on a `col`             | What happens during init                                       |
+|---|---|
+| `col.id`                          | Becomes a key in `formData` (and in `errorData` on the error pass) |
+| `col.id` starts with `tagList-`   | NOT pushed into `this.formElements` (1116) — survives the prune |
+| `col.onlyDisplay: true`           | Skips creating `formData[col.id]` / `errorData[col.id]` (1115) — so `tagList`, `sms-count`, `sms-preview`, both buttons don't get state slots |
+| `col.value` present + container path | Used as the seeded default (`formData[index][col.id] = col.value`, 1124–1125, 1138–1139). For non-container/SMS standalone path, default is `''`. So `value: ""` on `sms-count` and `value: "Save"` on the buttons are seed values for container flows only — not used in SMS standalone. |
+| `col.type === 'checkbox'`         | Forces `formData[col.id] = false` (1150) regardless of onlyDisplay |
+| any field NOT in `formElements`   | Pruned from final `formData` in `initialiseForm` (1303–1314) — schema is the single source of truth for which keys live in state |
+
+So the practical contract is:
+- An editable field (`onlyDisplay: false`) in the schema → gets a
+  `formData[id]` slot with default `''` (or `false` for checkbox) and a
+  `errorData[id]` slot with default `false`.
+- A display-only field (`onlyDisplay: true`) → gets NO state slot;
+  reads from formData fall back to `undefined`.
+
+This also explains why renaming `id: "template-name"` would not just break
+the validator at 472 — it would also strip the field from `formElements`
+and prune any existing edit-mode value from `formData`.
+
+---
+
+## 2. The dispatcher: `renderSection` (index.js:2493)
+
+Every `section.type` lands here:
+
+```
+section.type
+   ├─ "col-label"   → renderColLabelSection()
+   ├─ "multicols"   → renderMultiColSection()   ← ALL SMS leaf fields go here
+   ├─ "parent"      → renderParentSection()     ← recurses on childSections
+   └─ default       → null   (so an unknown `type` silently disappears)
+```
+
+### Recursion graph for the SMS schema
+
+```
+standalone.sections[0]                            type: "parent"   rowStyle:{flexDirection:'column'}
+└─ renderParentSection                            (index.js:2473)
+   ├─ childSections[0]                            type: "multicols"   width: 16
+   │  └─ renderMultiColSection                    inputFields[0].cols = []   ← empty placeholder
+   │
+   ├─ childSections[1]                            type: "parent"
+   │  └─ renderParentSection
+   │     ├─ childSections[0]                      type: "parent"   id: "kiwi"   width: 14
+   │     │  └─ renderParentSection
+   │     │     ├─ multicols → cols[template-name]                   (input)
+   │     │     ├─ multicols → cols[tagList]                         (tag-list)
+   │     │     └─ multicols → cols[sms-editor, sms-count, unicode-validity]
+   │     │
+   │     └─ childSections[1]                      type: "multicols"   width: 8
+   │        └─ renderMultiColSection
+   │           └─ cols[sms-preview]                                  (sms-preview)
+   │
+   └─ childSections[2]                            type: "multicols"
+      └─ renderMultiColSection
+         └─ cols[save-button, test-and-preview-button]               (button)
+```
+
+**Key takeaway:** changing `type` on any `parent`/`multicols` node will
+re-route the rendering through a different branch of `renderSection`; the
+default branch returns `null`, so a typo (e.g. `"multicol"` instead of
+`"multicols"`) silently removes the whole subtree.
+
+---
+
+## 3. Layout-key wiring (parent / multicols / row-col)
+
+These keys do not reach a leaf field renderer — they are consumed by the
+parent/multicols renderers:
+
+| Schema key (on parent / multicols / row) | Consumer in FormBuilder | Effect |
+|---|---|---|
+| `section.type: "parent"`                | renderParentSection (2473)        | Wraps `childSections` in a `<CapRow>` |
+| `section.type: "multicols"`             | renderMultiColSection (2530)      | Iterates `inputFields[].cols` and `actionFields[]` |
+| `section.rowStyle`                      | renderParentSection (2480)        | Becomes `<CapRow style={rowStyle}>` (root row uses `flexDirection:'column'`) |
+| `section.rowStyle` (on inputField row)  | NOT read directly                 | `sms-count-container.rowStyle` is **dead config** in current code |
+| `section.colStyle` (on childSection)    | renderParentSection (2477)        | Becomes `<CapColumn style={colStyle}>` wrapper |
+| `section.offset` (on childSection)      | renderParentSection (2477)        | Becomes `<CapColumn offset={offset}>` |
+| `section.width` (on childSection)       | renderParentSection (2477)        | Becomes `<CapColumn span={width}>` — controls left-pane (14) vs right-pane (8) split |
+| `inputFields[].rowClassName`            | NOT read (current code)           | `'tag-container'`, `'sms-message-content'`, `'sms-count-container'`, `'creatives-sms-footer'` are **dead className config** |
+| `inputFields[].cols[]`                  | renderMultiColSection (2537)      | Each `val` here is a leaf field → switch(type) |
+| `actionFields[]`                        | renderMultiColSection (2446)      | Switch only handles `case "button"` — anything else is dropped |
+
+---
+
+## 4. Per-field mapping (every leaf in the SMS schema)
+
+For each leaf `val` in `cols[]`, FormBuilder runs the switch at index.js:2576.
+The case is selected by `val.type`. Below: schema field → FormBuilder branch
+→ rendered component → which schema keys are consumed.
+
+### 4.1 `template-name` (Creative name input)
+
+```
+val.type = "input"                       → case "input"           index.js:2577
+                                           AND  val.styling === 'semantic'
+```
+
+| Schema key            | Used as                                              |
+|---|---|
+| `id: "template-name"` | `<CapInput id>`, formData[id], errorData[id] lookup  |
+| `placeholder`         | `<CapInput placeholder>`                              |
+| `label`               | NOT rendered (no label wrapper for input case)       |
+| `metaType: "text"`    | NOT used by input branch                             |
+| `datatype`            | NOT used                                             |
+| `required: true`      | Drives `validateForm` requirement check              |
+| `fluid: true`         | Commented out (`// fluid={val.fluid}`) — dead        |
+| `styling: "semantic"` | Required for the `if (styling==='semantic')` gate    |
+| `order`               | NOT used (cols are rendered in array order)          |
+| `width: 18`           | `<CapColumn span={18}>`                               |
+| `customComponent`     | NOT used                                             |
+| `standalone: true`    | Bypasses version-tab guards (`!val.standalone`)      |
+| `onlyDisplay: false`  | Field is editable; participates in error checks     |
+| `errorMessage`        | `<CapInput errorMessage>` shown when ifError is true |
+| `supportedEvents`     | Recognised by `callChildEvent` (onChange)            |
+
+Wraps in `<CapColumn span={width}>`. `style` (none here) would also flow.
+
+### 4.2 `tagList` (Add label tag chooser)
+
+```
+val.type = "tag-list"                    → case "tag-list"        index.js:2719
+```
+
+| Schema key            | Used as                                              |
+|---|---|
+| `id: "tagList"`       | `<TagList id>`                                        |
+| `label: "Add label"`  | `<TagList label>`                                     |
+| `className: 'add-label'` | `<TagList className>`                              |
+| `style`               | `<CapColumn style>` (defaults to `{marginBottom:'16px'}`) |
+| `width: 18`           | `<CapColumn span={width}>`                            |
+| `metaType, datatype, fluid, styling, order, customComponent` | NOT read by tag-list branch |
+| `required: true`      | Validation hook (validateForm) — but `onlyDisplay:true` makes it bypass |
+| `onlyDisplay: true`   | Skips formData[]/errorData[] guard (2545–2557)       |
+| `supportedEvents: ["onTagSelect"]` | Wired via `onTagSelect={(d)=>callChildEvent(d, val,'onTagSelect')}` |
+
+`rowClassName: 'tag-container'` on the parent row is **not read** — class
+must be added differently (e.g. via wrapper) to take effect.
+
+### 4.3 `sms-editor` (Message textarea)
+
+```
+val.type = "textarea"                    → case "textarea"        index.js:2613
+                                           → renderTextAreaContent(...)
+```
+
+| Schema key            | Used as                                              |
+|---|---|
+| `id: "sms-editor"`    | formData[id] / errorData[id]; key for SMS counter & preview |
+| `label: 'Message'`    | Passed into `renderTextAreaContent` (label rendered inside) |
+| `metaType, datatype, styling` | Branching inside `renderTextAreaContent`     |
+| `style: {marginBottom:'16px'}` | `<CapColumn style>` / inner element style    |
+| `required: true`      | Validation                                            |
+| `errorMessage`        | Error display in textarea wrapper                    |
+| `placeholder`         | Textarea placeholder                                 |
+| `fluid, onlyDisplay`  | Behaviour flags                                      |
+| `width: 18`           | `<CapColumn span={width}>`                           |
+| `autosize: true`      | Enables auto-resizing textarea                       |
+| `autosizeParams`      | `{maxRows:18, minRows:3}` passed to textarea         |
+| `order`               | NOT used                                             |
+| `customComponent: true` | NOT used in this branch                            |
+| `supportedEvents: ["onChange"]` | onChange wired to `updateFormData(value, val)` |
+
+⚠ **Critical convention**: the literal id `"sms-editor"` is hard-coded as a
+lookup key in:
+- `case "contentPreview"` (2276)  reads `formData['sms-editor']`
+- `case "sms-preview"`   (2332,2759) reads `formData[\`sms-editor${tab>1?tab:''}\`]`
+- `validateForm` (447)   reads `formData[count]['sms-editor' + suffix]`
+
+Renaming `id: "sms-editor"` will break the preview, char counter, and
+validation. The version-aware suffix logic (`sms-editor2`, `sms-editor3` …)
+is also tied to this exact prefix.
+
+⚠ **Error-message translation chain** (renderTextAreaContent, 2155–2168):
+the textarea reads `errorData[id]` and translates these tokens
+(written by `validateForm`) into i18n strings:
+
+| `errorData[id]` value       | Rendered errorMessage                          |
+|---|---|
+| `'missingTagsError'`        | `messages.missingTagsValidationError` (with the missing tag names) |
+| `'unsupportedTagsError'`    | `messages.unsupportedTagsValidationError`      |
+| `true`                      | `messages.genericTagsValidationError`          |
+| `false` / falsy             | no error shown                                 |
+
+So `errorMessage: "Template content has unsupported/missing tags!"` from
+the schema is **never displayed** — i18n messages override it. This
+schema field is effectively dead for `sms-editor`. (The check uses
+`val.errorMessage` for input/checkbox via different branches but the
+textarea branch overrides it.)
+
+### 4.4 `sms-count` (character counter div)
+
+```
+val.type = "div"     val.primitive = true  → renderPrimitiveElement (2507)
+                                              → case "div" (2514)
+```
+
+| Schema key            | Used as                                              |
+|---|---|
+| `id: "sms-count"`     | `<div id>`; formData[id] read for value if non-empty |
+| `type: 'div'`         | Selects the `div` branch in `renderPrimitiveElement` |
+| `props: {type:'label3'}` | NOT read by current code                          |
+| `onlyDisplay: true`   | Skips error-data guard                               |
+| `metaType: "label"`   | NOT read                                             |
+| `value: ""`           | Default text rendered inside the div                 |
+| `primitive: true`     | Required so renderMultiColSection routes to `renderPrimitiveElement` (2561) |
+| `width: 18`           | `<CapColumn span={width}>`                           |
+| `style: {float:'right'}` | Inline div style                                  |
+
+### 4.5 `unicode-validity` (Allow Unicode checkbox)
+
+```
+val.type = "checkbox"                    → case "checkbox"        index.js:2618
+                                           AND val.styling === 'semantic'
+```
+
+| Schema key            | Used as                                              |
+|---|---|
+| `id: "unicode-validity"` | formData[id]/errorData[id]; also read by `case "sms-preview"` to set `unicodeEnabled` |
+| `label`               | `<CapCheckbox>{label}</CapCheckbox>`                  |
+| `supportedEvents`     | onChange wired                                       |
+| `labelStyle`          | NOT read by checkbox branch (dead key)               |
+| `metaType, datatype, fluid, styling, order, width, customComponent` | width → CapColumn span; rest unused |
+| `required: true`      | Validation                                           |
+| `onlyDisplay: false`  | Requires entries in formData/errorData               |
+| `errorMessage`        | `<CapCheckbox errorMessage>`                          |
+
+⚠ **Critical convention**: id `"unicode-validity"` is read as a
+hard-coded key by `validateForm` (448) and `sms-preview` (2333, 2760).
+Renaming breaks unicode toggling.
+
+### 4.6 `sms-preview` (right-pane phone preview)
+
+```
+val.type = "sms-preview"                 → case "sms-preview"     index.js:2754
+```
+
+| Schema key            | Used as                                              |
+|---|---|
+| `id: "sms-preview"`   | Component key; formData[id] fallback when not version-tabbed |
+| `type: "sms-preview"` | Selects branch                                       |
+| `customComponent`     | NOT used                                             |
+| `customStyling: {padding:"0"}` | `<TemplatePreview style={customStyling}>`    |
+| `metaType: "preview"` | NOT used                                             |
+| `required, fluid, styling, order` | NOT used                                  |
+| `onlyDisplay: true`   | Skips formData guard                                 |
+| `offset: 7`           | NOT used in this branch (CapColumn offset is hardcoded `1`, span hardcoded `23`) — dead key |
+| `channel: "SMS"`      | `<TemplatePreview channel={val.channel}>`             |
+| `charCounterEnabled: true` | `<TemplatePreview charCounterEnabled>`           |
+
+The preview pulls its `content` from `formData['sms-editor' + suffix]` —
+not from any field on `sms-preview` itself. So changing `id: "sms-preview"`
+is mostly cosmetic, but changing `id: "sms-editor"` breaks the preview.
+
+### 4.7 `save-button` and `test-and-preview-button`
+
+These live under a `multicols` whose `cols[]` is on `inputFields` (not
+`actionFields`). FormBuilder's switch handles `case "button"` in BOTH
+`inputFields` (2738) and `actionFields` (2452) paths.
+
+```
+val.type = "button"                      → case "button"          index.js:2738
+                                           AND val.styling==='semantic'
+                                           AND val.metaType==='submit-button'
+```
+
+| Schema key            | Used as                                              |
+|---|---|
+| `id`                  | Special-cased: `'save-button'` triggers `this.saveForm()`; otherwise `callChildEvent(data, val, val.submitAction)` |
+| `metaType: "submit-button"` | Required for the gate to render the button     |
+| `colStyle`            | `<CapColumn style={colStyle}>`                        |
+| `type: "button"`      | Selects the branch                                   |
+| `buttonType`          | `<CapButton type={buttonType}>` ('primary' / 'secondary') |
+| `value`               | Button label text (children of CapButton)             |
+| `customComponent`     | NOT used                                             |
+| `styling: "semantic"` | Required for the gate                                |
+| `order`               | NOT used                                             |
+| `fluid`               | NOT used (CapButton has no `fluid` prop here)        |
+| `standalone: true`    | Bypasses version-tab guards                          |
+| `onlyDisplay: true`   | Skips formData/errorData guard                       |
+| `submitAction`        | For non-save: passed as event name to `callChildEvent` ('onClick' on the test button) |
+| `supportedEvents`     | Recognised by `callChildEvent`                       |
+
+`width`/`offset`/`icon`/`disabled` would also wire to CapButton if added
+(see 2741–2746).
+
+⚠ **save-button special case**: `id === 'save-button'` (2457, 2746) bypasses
+`callChildEvent` entirely and calls `this.saveForm()` directly, so
+`submitAction: "saveFormData"` and `supportedEvents: ["saveFormData"]` on the
+schema are **never invoked** — they're dead config kept for symmetry with
+other buttons. Only `id: "save-button"` matters for save behaviour.
+
+For `test-and-preview-button`: `submitAction: "onClick"` IS used — it's
+passed as the event name into `callChildEvent`, which then dispatches via
+`val.injectedEvents.onClick(...)` (1977). The container component at
+`v2Containers/Sms/...` must register an `onClick` handler in the
+`injectedEvents` map for this id, or the click is a no-op.
+
+---
+
+## 5. Field-type → render-branch quick reference
+
+This is the table to consult when you change `val.type` in the schema. All
+SMS-relevant cases live in the switch at index.js:2576 (and a near-duplicate
+at 2233 used by `renderTextAreaContent` recursion).
+
+| `val.type`           | Renders                                  | File:line |
+|---|---|---|
+| `input`              | `<CapInput>` inside `<CapColumn>`        | 2577      |
+| `SmsEditor`          | `<SmsEditor>` (legacy)                   | 2602      |
+| `textarea`           | via `renderTextAreaContent`              | 2613      |
+| `contentPreview`     | char-list `<CapColumn>`                  | 2275      |
+| `checkbox`           | `<CapCheckbox>`                          | 2618      |
+| `radio`              | `<CapRadio>`                             | 2638      |
+| `radioGroup`         | `<CapRadioGroup options={val.options}>`  | 2657      |
+| `image`              | `<img>` with placeholder/error           | 2683      |
+| `upload`             | hidden file input + `<CapButton>`        | 2700      |
+| `table`              | `<CapTable>` (uses `val.columns`, `val.pagination`) | 2712 |
+| `tag-list`           | `<TagList>`                              | 2719      |
+| `tabs`               | `<TagList>` (legacy)                     | 2319      |
+| `button`             | `<CapButton>`                            | 2738      |
+| `sms-preview`        | `<TemplatePreview channel="SMS">`        | 2754      |
+| `line-preview`       | `<TemplatePreview channel="LINE">`       | 2776      |
+| `mobile-push-preview`| `<TemplatePreview device=...>`           | 2798      |
+| `popover`            | `<CapPopover>` with recursive sections   | 2824      |
+| `icon`               | icon component                           | 2862      |
+| `select`             | `<CapSelect options={val.options}>`      | 2883      |
+| `ckeditor`           | `<CKEditor>`                             | 2904      |
+| `edmeditor`          | `<EDMEditor>`                            | 2400      |
+| `span` / `div`       | via `renderPrimitiveElement` when `val.primitive=true` | 2507 |
+
+Anything else falls through `default: break;` and renders nothing.
+
+---
+
+## 6. Hard-coded id contracts (DO NOT rename without updating code)
+
+These ids from `initialSchema.js` are read as string literals in
+FormBuilder/index.js. They are not generic schema lookups — renaming the
+`id` will cause runtime breakage that the schema cannot express.
+
+| Schema id            | Hard-coded reads in FormBuilder                                     |
+|---|---|
+| `sms-editor`         | 447 (`validateForm`), 2276 (`contentPreview`), 2332/2759 (`sms-preview`), tab-suffix logic for versions |
+| `unicode-validity`   | 448 (`validateForm`), 2333/2760 (`sms-preview` unicodeEnabled)      |
+| `template-name`      | 472–477 (`validateForm` non-embedded creative-name required check) |
+| `save-button`        | 2457, 2746 (special-cased to `this.saveForm()`)                     |
+| `tab-header`         | 1934 (`callChildEvent` onChange routes to `changeVersionName`) — not in SMS schema today, but reserved |
+| `tagList` / `tags`   | NOT hard-coded — `tags` come from `this.props.tags`                 |
+
+Schema-level hard-coded values:
+
+| Schema location                              | Code reading it           |
+|---|---|
+| `definition.channel === "SMS"`               | `validateForm` (437) — gate for SMS validation block |
+| `definition.channel === "LINE"` / `"EMAIL"`  | other channel branches in `validateForm` (481, 1882, 1893, 1913) |
+
+Other ids (`sms-count`, `sms-preview`, `test-and-preview-button`) are
+referenced only via `val.id` and are safe to rename — but the values of
+`submitAction: "saveFormData"` / `"onClick"` must remain in sync with the
+parent container's `injectedEvents` keys (see `callChildEvent`,
+`val.injectedEvents`).
+
+---
+
+## 7. Keys that look meaningful but are NOT consumed (in the SMS path)
+
+Searching FormBuilder confirms these schema keys are **dead config** for
+SMS rendering today. Setting/removing them changes nothing visible. (Some
+are read by other channels' code paths — but not by anything reachable
+from the SMS schema.)
+
+- Top-level: `_id`, `type:"LAYOUT"`, `isActive`, `createdBy`, `updatedBy`,
+  `createdAt`, `updatedAt` (FormBuilder consumes `metaEntities[0].definition`
+  via the container; the wrapper fields are used only by backend/analytics).
+  NOTE: `definition.channel` is NOT dead — see §6.
+- On rows: `rowClassName` ('tag-container', 'sms-message-content',
+  'sms-count-container', 'creatives-sms-footer') — read only by
+  `renderContainer` (3008), unreachable from SMS standalone.
+- On rows: `rowStyle` on `inputFields[]` rows — also only used at 3008.
+  The section-level `rowStyle` on the outer `parent` IS read (2480).
+- On parents: `id: "kiwi"` on the inner-left `parent` section — never
+  read; pure label/comment.
+- On fields: `metaType` (except `'submit-button'` gate on buttons),
+  `datatype`, `fluid` (commented out), `order`, `customComponent`,
+  `props`, `labelStyle` (on checkbox), `offset` (on `sms-preview`).
+
+If you intend any of these to take effect, they need new code in
+FormBuilder; today they're documentation-only.
+
+---
+
+## 8. Change-impact cheat-sheet
+
+| If you change in `initialSchema.js`…                         | …it will affect in `FormBuilder/index.js`            |
+|---|---|
+| any `section.type`                                            | `renderSection` dispatch (2493) — wrong value silently renders nothing |
+| `parent.childSections[].width` / `offset` / `colStyle`        | `renderParentSection` CapColumn props (2477) — column layout |
+| `parent.rowStyle`                                             | `renderParentSection` CapRow style (2480) — row direction/spacing |
+| any `cols[].type`                                             | `renderMultiColSection` switch (2576) — picks the renderer |
+| `cols[].id` (when id is `sms-editor`/`unicode-validity`/`save-button`) | Hard-coded reads (see §6) — breaks preview / counter / save |
+| `cols[].id` (any other)                                       | formData[id] / errorData[id] keys; safe to rename if you also update upstream consumers |
+| `cols[].width`                                                | `<CapColumn span>` for the field                     |
+| `cols[].style`                                                | `<CapColumn style>` (input/textarea/image/upload)    |
+| `cols[].colStyle`                                             | `<CapColumn style>` (button/select/popover branches) |
+| `cols[].offset`                                               | `<CapColumn offset>` for tag-list/checkbox/radio/image/upload/button (NOT read by sms-preview) |
+| `cols[].placeholder`                                          | `<CapInput>` / textarea placeholder                  |
+| `cols[].errorMessage`                                         | Inline error string when ifError                     |
+| `cols[].label`                                                | tag-list / checkbox / radio / upload label           |
+| `cols[].required`                                             | `validateForm` requirement check                     |
+| `cols[].onlyDisplay`                                          | Bypass guards in `renderMultiColSection` (2545–2557) |
+| `cols[].standalone`                                           | Bypass version-tab guards; sets `isVersionEnable=false` |
+| `cols[].styling === 'semantic'`                               | Required gate for input/checkbox/radio/radioGroup/button branches to render |
+| `cols[].supportedEvents`                                      | Recognised by `callChildEvent` (parent container hooks) |
+| `cols[].submitAction`                                         | Event name used by `callChildEvent` for buttons      |
+| `cols[].buttonType`                                           | `<CapButton type>` ('primary'/'secondary')           |
+| `cols[].channel`                                              | `<TemplatePreview channel>` for sms/line/mobile-push previews |
+| `cols[].charCounterEnabled`                                   | `<TemplatePreview charCounterEnabled>`               |
+| `cols[].autosize` / `autosizeParams`                          | textarea auto-resize behaviour                       |
+| `cols[].primitive: true`                                      | Routes to `renderPrimitiveElement` (2561)            |
+| `cols[].value` (on primitive `div`/`span`)                    | Default text content (overridden by formData[id])    |
+
+---
+
+## 9. Schema-line → FormBuilder-line map
+
+For every line in `app/v2Containers/Sms/initialSchema.js`, this is the
+exact set of lines in `app/components/FormBuilder/index.js` it controls.
+Format: `schema L<n>: <key>=<value>` → `FormBuilder L<n>: <what happens>`.
+
+(Layout-only branches that are not consumed by anything are marked DEAD.)
+
+---
+
+### Schema L1 — `export const response = {`
+- **Consumed by**: `app/services/getSchema.js` (line 6) — `import('../v2Containers/Sms/initialSchema')` then `.response`. The container reads `response.metaEntities[0].definition` and passes it to `<FormBuilder schema=...>`.
+- FormBuilder lines: 3165 (`const schema = this.props.schema`), 3210 (`this.props.schema ? this.renderForm() : ''`).
+
+### Schema L2–L4 — `metaEntities[0]: { _id, type:"LAYOUT" }`
+- **DEAD** in FormBuilder. Wrapper fields `_id`, `type:"LAYOUT"`, `isActive`, `createdBy`, `updatedBy`, `createdAt`, `updatedAt` (L4, L295–299) are not read by any FormBuilder line. The container peels `definition` off and discards them.
+
+### Schema L6 — `definition: {`
+- The object passed in as `props.schema`. Read at FormBuilder L1280–1283 (init), L3165 (render), L437/481/1882/1893/1913 (channel gate).
+
+### Schema L7 — `standalone: {`
+- Read at FormBuilder L1203 (`if (schema.standalone)` in init), L3169 (render).
+
+### Schema L8 — `sections: [`
+- Iterated at FormBuilder L1204 (`_.forEach(schema.standalone.sections, ...)`) and L3170–3172 (`schema.standalone.sections.map(renderSection)`).
+
+### Schema L10 — `type: 'parent'` (outer section)
+- Init: dispatches to `initializeParentSection` at L1210–1211.
+- Render: dispatches to `renderParentSection` at L2499–2500 inside `renderSection`.
+
+### Schema L11–L13 — `rowStyle: { flexDirection: 'column' }`
+- Read at FormBuilder L2480: `<CapRow useLegacy style={section.rowStyle ? section.rowStyle : {}}>`. Sets the outer row to vertical stacking.
+
+### Schema L14 — `childSections: [`
+- Iterated at FormBuilder L1048 (init) and L2475 (`section.childSections.map(...)` in `renderParentSection`).
+
+### Schema L16 — `type: "multicols"` (childSections[0], the empty placeholder)
+- Init: L1206/1051 → `initializeMultiColSection` (no-op because cols is empty).
+- Render: L2497–2498 → `renderMultiColSection`. Since `inputFields[0].cols = []`, the inner `_.forEach(field.cols, ...)` at L2537 produces zero columns. **Effectively renders an empty `<CapRow>`.**
+
+### Schema L17 — `width: 16`
+- Read at FormBuilder L2477: `<CapColumn ... span={childSection.width}>` — wraps this empty multicols in a 16-span column.
+
+### Schema L18 — `inputFields: [`
+- Iterated at FormBuilder L1093 (init) and L2535 (`_.forEach(section.inputFields, ...)` in `renderMultiColSection`).
+
+### Schema L20–L23 — `cols: []`
+- Iterated at FormBuilder L1094 (init) and L2537 (render). Empty array → no fields produced.
+
+### Schema L26–L28 — `actionFields: []`
+- Iterated at FormBuilder L2446 (`_.forEach(section.actionFields, ...)`). Empty → no buttons produced.
+
+### Schema L31 — `type: "parent"` (childSections[1])
+- Same dispatchers as L10 above (L1210/L2499).
+
+### Schema L33 — `childSections: [`
+- L1048 / L2475.
+
+### Schema L36 — `width: 14`
+- L2477 → `<CapColumn span={14}>` — defines the LEFT (form) pane.
+
+### Schema L37 — `type: "parent"`
+- Same as L10 → L1210/L2499 (`renderParentSection` recurses).
+
+### Schema L38 — `id: "kiwi"`
+- **DEAD**. No grep hits in FormBuilder. Pure label.
+
+### Schema L39 — `childSections: [`
+- L1048 / L2475.
+
+---
+
+#### Field 1 — `template-name` (L46–L64)
+
+**Branch chosen**: schema L41 `type: "multicols"` → render at L2497 → leaf switch at L2576 → schema L48 `type: "input"` → `case "input"` at L2577.
+
+| Schema line | Schema content | FormBuilder line(s) — what happens |
+|---|---|---|
+| L41 | `type: "multicols"` | L2497–2498 `renderMultiColSection`; L1206 init |
+| L42 | `inputFields: [`    | L2535 iterate; L1093 init |
+| L44 | `cols: [`           | L2537 iterate; L1094 init |
+| L46 | `id: "template-name"` | **L1117** `formElements.push(col.id)`; **L1132** `formData['template-name'] = ''`; **L1144** `errorData['template-name'] = false` (init pass); render: **L2241** `<CapInput id={val.id}>`; state reads at **L2251–2252** (`defaultValue`/`value`). Hard-coded reads in validateForm: **L472, L473, L476** (and L515/L519/L749/L750/L755 for LINE/EMAIL channel branches — not hit for SMS). updateFormData write: **L1739** `formData[val.id] = data` |
+| L47 | `placeholder: "Enter template name"` | **L2249** `placeholder={val.placeholder}` |
+| L48 | `type: "input"` | **L2577** `case "input":` selects this branch |
+| L49 | `label: "Creative name"` | **DEAD** — input branch never renders a label |
+| L50 | `metaType: "text"` | **DEAD** — only `metaType==='submit-button'` is checked (L2453, L2739) |
+| L51 | `datatype: "string"` | **DEAD** — never grepped |
+| L52 | `required: true` | implicit via L472 (validateForm only fires if formData empty) |
+| L53 | `fluid: true` | **DEAD** — commented out at **L2244** (`// fluid={val.fluid}`) and L2587 |
+| L54 | `styling: "semantic"` | **L2235** `if (styling === 'semantic')` gate; **L2580** in inputFields branch |
+| L55 | `order: 1` | **DEAD** |
+| L56 | `width: 18` | **L2239** `<CapColumn span={val.width}>` (also L2582 in inputFields path) |
+| L57 | `customComponent: false` | **DEAD** |
+| L58 | `standalone: true` | **L2540** `isVersionEnable = (usingTabContainer && !val.standalone)`; also gates L2542, L2545, L2553 (skipping version-tab guards) |
+| L59 | `onlyDisplay: false` | **L1115** init: editable → state slot created; **L2545–L2557** render: required for guards |
+| L60 | `errorMessage: "Template name cannot be empty."` | **L2242** `errorMessage={val.errorMessage && ifError ? val.errorMessage : ''}` (also L2585) |
+| L61–L63 | `supportedEvents: ["onChange"]` | **DEAD as a list** — FormBuilder doesn't read `supportedEvents`. The actual onChange wiring is **L2250** `onChange={(e) => this.updateFormData(e.target.value, val)}` (also L2593). The string `"onChange"` matters only as a key in the parent container's `injectedEvents` map, dispatched at **L1778–1779** (`val.injectedEvents.onChange.call(...)`) |
+
+---
+
+#### Field 2 — `tagList` (L75–L94)
+
+**Branch chosen**: schema L70 `type: "multicols"` → leaf switch → schema L81 `type: "tag-list"` → `case "tag-list"` at **L2719** (inputFields path inside renderMultiColSection).
+
+| Schema line | Schema content | FormBuilder line(s) — what happens |
+|---|---|---|
+| L70 | `type: "multicols"` | L2497, L1206 |
+| L71 | `inputFields: [`     | L2535, L1093 |
+| L73 | `rowClassName: 'tag-container'` | **DEAD** for SMS — only read at **L3008** (in `renderContainer`, not reachable from `standalone`) |
+| L74 | `cols: [`            | L2537, L1094 |
+| L76 | `style: {marginBottom:'unset', height:'24px'}` | **L2721** `<CapColumn ... style={val.style ? val.style : {marginBottom:'16px'}}>` |
+| L77 | `width: 18`          | **L2721** `span={val.width ? val.width : ''}` |
+| L78 | `id: "tagList"`      | Not pushed to formElements (`onlyDisplay:true` at L1115 short-circuits AND L1116 also filters `tagList-` prefix); **L2732** `<TagList id={val.id}>` |
+| L79 | `label: "Add label"` | **L2725** `label={val.label ? val.label : ''}` |
+| L80 | `className: 'add-label'` | **L2731** `className={val.className ? val.className : ''}` |
+| L81 | `type: "tag-list"`   | **L2719** `case "tag-list":` |
+| L82 | `metaType: "List"`   | **DEAD** |
+| L83 | `datatype: "select"` | **DEAD** |
+| L84 | `required: true`     | **DEAD** (no validation hits this id) |
+| L85 | `fluid: true`        | **DEAD** |
+| L86 | `onlyDisplay: true`  | **L1115** init: skips creating state slot; **L2545–L2557** render: bypasses formData/errorData guards so the field renders even with no state entry |
+| L87 | `styling: "semantic"`| **DEAD** for tag-list (no styling gate in this branch) |
+| L88 | `order: 1`           | **DEAD** |
+| L89 | `customComponent: true` | **DEAD** |
+| L90–L92 | `supportedEvents: ["onTagSelect"]` | **DEAD as a list**; the actual wiring is **L2726** `onTagSelect={(data) => this.callChildEvent(data, val, 'onTagSelect')}`, dispatched at **L1877–1879** |
+
+---
+
+#### Field 3 — `sms-editor` (L105–L129)
+
+**Branch chosen**: schema L99 `type: "multicols"` → leaf switch → schema L108 `type: "textarea"` → `case "textarea"` at **L2613** → `renderTextAreaContent` at **L2118** (call site L2616).
+
+| Schema line | Schema content | FormBuilder line(s) — what happens |
+|---|---|---|
+| L99 | `type: "multicols"` | L2497, L1206 |
+| L101 | `inputFields: [`   | L2535, L1093 |
+| L103 | `rowClassName: 'sms-message-content'` | **DEAD** — only L3008 (renderContainer) |
+| L104 | `cols: [`           | L2537, L1094 |
+| L106 | `id: "sms-editor"` | **L1117** push to formElements; **L1132** init seed; **L1144** errorData seed. Render: **L2174** `<CapTextArea id={val.id}>`. Hard-coded literal reads: **L447, L454, L458, L466** (validateForm), **L2276** (`contentPreview` branch), **L2332, L2759** (sms-preview branch). The version-suffix string `\`sms-editor${index>1?index:''}\`` is concatenated at L447, L2332, L2759. updateFormData write: **L1739** (and L1723 in version-tab path) |
+| L107 | `label: 'Message'` | **DEAD in textarea branch** — `renderTextAreaContent` never renders a label |
+| L108 | `type: "textarea"` | **L2613** `case "textarea":` selects branch |
+| L109 | `metaType: "text"` | **DEAD** |
+| L110 | `datatype: "string"`| **DEAD** |
+| L111 | `style: {marginBottom:'16px'}` | **L2180** `style={val.style ? val.style : {}}` |
+| L112 | `required: true`   | implicit via L466 (empty content = error) |
+| L113 | `errorMessage: "Template content has unsupported/missing tags!"` | **DEAD** — overridden by i18n at **L2155–2168** (token translation: `MISSING_TAG_ERROR`/`UNSUPPORTED_TAG_ERROR`/`true` → `messages.*ValidationError`) |
+| L114 | `placeholder: "Please input sms template content."` | **L2176** `placeholder={val.placeholder ? val.placeholder : ''}` |
+| L115 | `fluid: true`      | **DEAD** |
+| L116 | `styling: "semantic"` | **L2170** `if (styling === 'semantic')` gate inside renderTextAreaContent |
+| L117 | `onlyDisplay: false` | **L1115** init creates state slot; **L2545–L2557** render guards |
+| L118 | `width: 18`        | **L2172** `<CapColumn ... span={val.width}>` |
+| L119 | `autosize: true`   | **L2178** `autosize={val.autosize ? val.autosizeParams : false}` |
+| L120–L123 | `autosizeParams: {maxRows:18, minRows:3}` | **L2178** value passed when `autosize` is truthy |
+| L124 | `order: 2`         | **DEAD** |
+| L125 | `customComponent: true` | **DEAD** |
+| L126–L128 | `supportedEvents: ["onChange"]` | onChange wired at **L2179** `onChange={(e) => this.updateFormData(e.target.value, val)}` (the `event` arg is omitted, so `updateFormData` falls through to L1738 / L1739 / L1722–1726 depending on tabContainer state). Container injectedEvents.onChange dispatched at **L1778–1779** |
+
+---
+
+#### Field 4 — `sms-count` (L138–L150)
+
+**Branch chosen**: `val.primitive === true` at **L2561** → `renderPrimitiveElement` at **L2507** → schema L140 `type: 'div'` → `case "div"` at **L2514**.
+
+| Schema line | Schema content | FormBuilder line(s) — what happens |
+|---|---|---|
+| L131 | `rowClassName: 'sms-count-container'` | **DEAD** (L3008 only) |
+| L133–L136 | `rowStyle: { bottom:'8px', fontSize:'12px' }` | **DEAD** for SMS — `inputFields[].rowStyle` only read at L3008 |
+| L137 | `cols: [`           | L2537, L1094 |
+| L139 | `id: 'sms-count'`   | **NOT** pushed to formElements (L1115 skips because `onlyDisplay:true`); render: **L2520** `<div id={val.id}>`; state read at **L2515** `formData[currentTab-1][val.id]` if non-empty trims |
+| L140 | `type: 'div'`       | **L2514** `case "div":` in renderPrimitiveElement |
+| L141 | `props: {type:'label3'}` | **DEAD** |
+| L142 | `onlyDisplay: true` | **L1115** init skip; **L2545–L2557** render bypass |
+| L143 | `metaType: "label"` | **DEAD** |
+| L144 | `value: ""`         | **L2510** `let value = val.dynamicTab ? tabName : val.value;` — used as default text, then overridden at **L2515–2516** if formData has a non-empty value. Also in init at **L1124–1125** seed for container path (not the SMS standalone path) |
+| L145 | `primitive: true`   | **L2561** `if (val.primitive)` — REQUIRED to route through `renderPrimitiveElement` instead of the type switch |
+| L146 | `width: 18`         | **L2569** `<CapColumn span={val.width}>` |
+| L147–L149 | `style: { float:'right' }` | **L2522** `style={val.style ? val.style : {}}` |
+
+Note: `colStyle`/`offset` would also flow at L2569 if added.
+
+---
+
+#### Field 5 — `unicode-validity` (L155–L177)
+
+**Branch chosen**: schema L99 multicols → leaf switch → schema L166 `type: "checkbox"` → `case "checkbox"` at **L2618** (inputFields path).
+
+| Schema line | Schema content | FormBuilder line(s) — what happens |
+|---|---|---|
+| L154 | `cols: [`           | L2537 |
+| L156 | `id: "unicode-validity"` | **L1117** push; **L1132**/**L1144** init seed; checkbox-init override at **L1153–1155** sets `formData[id]=false`; **L1192**/**L1194** also force false in initializeColLabelSection. Render: **L2622** wraps; **L2627** `checked={formData[id]}`; **L2628** `defaultChecked`. Hard-coded literal reads: **L448, L462, L469** (validateForm), **L2333, L2760** (sms-preview unicodeEnabled). Write: **L2626** `onChange={(e) => this.updateFormData(e.target.checked, val)}` → L1739 |
+| L157 | `label: "Allow Unicode characters"` | **L2632** `<CapCheckbox>{val.label}</CapCheckbox>` |
+| L158–L160 | `supportedEvents: ["onChange"]` | onChange wired at **L2626** (see above) |
+| L161–L163 | `labelStyle: { backgroundColor:"white" }` | **DEAD** for SMS — only `renderColLabelSection` uses it at **L2212** |
+| L166 | `type: "checkbox"`  | **L2618** `case "checkbox":` |
+| L167 | `metaType: "text"` | **DEAD** |
+| L168 | `datatype: "boolean"` | **DEAD** |
+| L169 | `required: true`   | implicit (validateForm at L461–470 forces `unicodeCheck` based on content) |
+| L170 | `fluid: true`      | **DEAD** |
+| L171 | `styling: "semantic"` | **L2620** `if (styling === 'semantic')` gate |
+| L172 | `order: 1`         | **DEAD** |
+| L173 | `width: 18`        | **L2622** `<CapColumn span={val.width}>` |
+| L174 | `onlyDisplay: false` | **L1115** init creates slot; **L2545–L2557** render guards |
+| L175 | `errorMessage: "Unicode characters were detected in your content."` | **L2625** `errorMessage={val.errorMessage ? val.errorMessage : ''}` |
+| L176 | `customComponent: false` | **DEAD** |
+
+Notes: `style`/`offset`/`disabled` (none here) would flow at **L2629–L2630** and **L2622** if added.
+
+---
+
+#### Field 6 — `sms-preview` (L194–L210)
+
+**Branch chosen**: schema L189 `type: "multicols"` (under childSections[1] `width: 8`) → leaf switch → schema L196 `type: "sms-preview"` → `case "sms-preview"` at **L2754**.
+
+| Schema line | Schema content | FormBuilder line(s) — what happens |
+|---|---|---|
+| L188 | `width: 8` (on enclosing childSection) | **L2477** `<CapColumn span={8}>` — defines the RIGHT (preview) pane |
+| L189 | `type: "multicols"` | L2497 |
+| L191 | `inputFields: [`    | L2535 |
+| L193 | `cols: [`           | L2537 |
+| L195 | `id: "sms-preview"` | NOT pushed to formElements (`onlyDisplay:true`). Render: **L2764** `key={val.id}`; **L2759** fallback read `formData[val.id]` when `isVersionEnable` is false |
+| L196 | `type: "sms-preview"` | **L2754** `case "sms-preview":` selects branch |
+| L197 | `customComponent: true` | **DEAD** |
+| L198–L200 | `customStyling: {padding:"0"}` | **L2765** `style={val.customStyling ? val.customStyling : {}}` |
+| L201 | `metaType: "preview"` | **DEAD** |
+| L202 | `required: true`   | **DEAD** (no validateForm hit) |
+| L203 | `fluid: true`      | **DEAD** |
+| L204 | `styling: "semantic"` | **DEAD** for this branch (no gate) |
+| L205 | `order: 1`         | **DEAD** |
+| L206 | `onlyDisplay: true`| **L1115** skip; **L2545–L2557** bypass |
+| L207 | `offset: 7`        | **DEAD** — **L2762** hardcodes `offset={1}` and `span={23}` (overrides any schema value) |
+| L208 | `channel: "SMS"`   | **L2766** `channel={val.channel ? val.channel : 'SMS'}` |
+| L209 | `charCounterEnabled: true` | **L2768** `charCounterEnabled={val.charCounterEnabled}` |
+
+Content shown by the preview pulls from `sms-editor`/`unicode-validity` at **L2759, L2760** — not from any `sms-preview` field.
+
+---
+
+#### Field 7 — `save-button` (L223–L240)
+
+**Branch chosen**: schema L218 `type: "multicols"` → leaf switch (cols on `inputFields`, NOT actionFields) → schema L227 `type: "button"` → `case "button"` at **L2738**.
+
+| Schema line | Schema content | FormBuilder line(s) — what happens |
+|---|---|---|
+| L218 | `type: "multicols"` | L2497 |
+| L219 | `inputFields: [`    | L2535 |
+| L221 | `rowClassName: 'creatives-sms-footer'` | **DEAD** (L3008 only) |
+| L222 | `cols: [`           | L2537 |
+| L224 | `id: "save-button"` | NOT pushed to formElements (`onlyDisplay:true`). **Hard-coded special case** at **L2746** `val.id === 'save-button' ? this.saveForm() : ...` (also L2457 in renderColLabelSection branch and L3036 in renderContainer). `this.saveForm()` is defined at **L919** |
+| L225 | `metaType: "submit-button"` | **L2739** `if (styling==='semantic' && val.metaType==='submit-button')` — REQUIRED gate or button doesn't render |
+| L226 | `colStyle: {marginRight:'16px'}` | **L2741** `<CapColumn style={val.colStyle ? val.colStyle : {}}>` |
+| L227 | `type: "button"`   | **L2738** `case "button":` |
+| L228 | `buttonType: "primary"` | **L2743** `<CapButton type={val.buttonType}>` |
+| L229 | `value: "Save"`    | **L2747** `{val.value}` (button label) |
+| L230 | `customComponent: false` | **DEAD** |
+| L231 | `styling: "semantic"` | **L2739** required for the gate |
+| L232 | `order: 3`         | **DEAD** |
+| L233 | `fluid: true`      | **DEAD** |
+| L234 | `standalone: true` | **L2540** sets `isVersionEnable=false`; bypasses guards at L2542, L2545, L2553 |
+| L235 | `onlyDisplay: true`| **L1115** init skip; **L2545–L2557** bypass |
+| L236 | `submitAction: "saveFormData"` | **DEAD** — L2746 special-cases save-button to call `saveForm()` directly, never uses submitAction |
+| L237–L239 | `supportedEvents: ["saveFormData"]` | **DEAD** — same reason |
+
+---
+
+#### Field 8 — `test-and-preview-button` (L241–L258)
+
+**Branch chosen**: same multicols → `case "button"` at **L2738**.
+
+| Schema line | Schema content | FormBuilder line(s) — what happens |
+|---|---|---|
+| L242 | `id: "test-and-preview-button"` | NOT pushed to formElements. **L2746** falls into the else branch: `this.callChildEvent(data, val, val.submitAction)` |
+| L243 | `metaType: "submit-button"` | **L2739** required gate |
+| L244 | `colStyle: {marginRight:'16px'}` | **L2741** `<CapColumn style={val.colStyle}>` |
+| L245 | `type: "button"`   | **L2738** `case "button":` |
+| L246 | `buttonType: "secondary"` | **L2743** `<CapButton type='secondary'>` |
+| L247 | `value: "Preview and Test"` | **L2747** label |
+| L248 | `customComponent: false` | **DEAD** |
+| L249 | `styling: "semantic"` | **L2739** gate |
+| L250 | `order: 4`         | **DEAD** |
+| L251 | `fluid: true`      | **DEAD** |
+| L252 | `standalone: true` | **L2540** isVersionEnable=false |
+| L253 | `onlyDisplay: true`| **L1115** skip; **L2545–L2557** bypass |
+| L254 | `submitAction: "onClick"` | **L2746** `this.callChildEvent(data, val, val.submitAction)` — passes `'onClick'` as the event name; falls through to **L1977** `val.injectedEvents['onClick'].call(this.props.parent, data, val.id)`. Container MUST register `injectedEvents.onClick` for this id, else click is a no-op |
+| L255–L257 | `supportedEvents: ["onClick"]` | **DEAD as a list**; the dispatched event name comes from `submitAction` (L254), not `supportedEvents` |
+
+---
+
+#### Schema L259–L276 — commented-out `discard-button`
+- **DEAD** — entirely commented out. If uncommented, would route to `case "button"` at L2738 with `submitAction: "discardValues"` → L1925 `else if (event === 'discardValues')` branch (special-cased to `resetState`).
+
+### Schema L282–L284 — `actionFields: []` (footer multicols)
+- L2446 `_.forEach(section.actionFields, ...)` — empty.
+
+### Schema L293 — `channel: "SMS"` (on definition)
+- **L437** `if (this.props.schema.channel === 'SMS')` — gates the entire SMS validation block (L437–L478). Without this exact string, validateForm becomes a no-op for the form. Also referenced at:
+  - L1882 `this.props.schema.channel.toUpperCase() === 'EMAIL'` (deleteVersion branch — not hit)
+  - L1893 `this.props.schema.channel.toUpperCase() === 'EMAIL'` (duplicateVersion — not hit)
+  - L1913 `this.props.schema.channel.toUpperCase() === 'EMAIL'` (deleteVersion — not hit)
+
+### Schema L295–L299 — `isActive`, `createdBy`, `updatedBy`, `createdAt`, `updatedAt`
+- **DEAD** in FormBuilder.
+
+---
+
+### Reverse index — every FormBuilder line that touches the SMS schema
+
+| FormBuilder line | What it does | Schema line(s) it depends on |
+|---|---|---|
+| 437              | `schema.channel === 'SMS'` gate           | L293 |
+| 447              | `formData[count]['sms-editor'+suffix]`     | L106 (id) |
+| 448              | `formData[count]['unicode-validity'+suffix]` | L156 (id) |
+| 454, 458, 466    | write `errorData['sms-editor'+suffix]`     | L106 |
+| 462, 469         | write `errorData['unicode-validity'+suffix]` | L156 |
+| 472–476          | `template-name` required check             | L46 (id) |
+| 919–930          | `saveForm()`                                | L224 (special-cased id) |
+| 1115             | `if (!col.onlyDisplay && !ifError)` init filter | L59, L86, L117, L142, L174, L206, L235, L253 (onlyDisplay) |
+| 1116             | filter `tagList-` prefix from formElements  | L78 |
+| 1117             | `formElements.push(col.id)`                 | L46, L106, L156 (the editable ids) |
+| 1132 / 1144      | seed `formData[col.id]=''` / `errorData[col.id]=false` | L46, L106, L156 |
+| 1150–1155        | force checkbox formData = false             | L156 (type:checkbox) |
+| 1203, 1204       | enter standalone walk                       | L7, L8 |
+| 1210–1211        | parent dispatch (init)                      | L10, L31, L37 |
+| 1206–1208        | multicols/col-label dispatch (init)          | L16, L41, L70, L99, L189, L218 |
+| 1739             | `formData[val.id] = data` on every update    | all editable ids |
+| 1977             | `val.injectedEvents[event].call(parent, ...)` | L254 (submitAction:"onClick") |
+| 2174             | `<CapTextArea id>`                          | L106 (id) |
+| 2176             | textarea placeholder                        | L114 |
+| 2178             | autosize/autosizeParams                     | L119, L120 |
+| 2180             | textarea style                              | L111 |
+| 2241             | `<CapInput id>`                             | L46 |
+| 2249             | input placeholder                           | L47 |
+| 2241–2256        | full input render                           | L46–L60 |
+| 2241+L2245-2247  | dvs-module style override                   | L46+`style` (none here) |
+| 2475             | `childSections.map`                         | L14, L33, L39 |
+| 2477             | `<CapColumn span={width}>` for childSection | L36 (width:14), L188 (width:8) (and L17 width:16 for empty multicols) |
+| 2480             | `<CapRow style={section.rowStyle}>`         | L11–L13 |
+| 2497–2498        | multicols dispatch (render)                 | L16, L41, L70, L99, L189, L218 |
+| 2499–2500        | parent dispatch (render)                    | L10, L31, L37 |
+| 2514–2524        | renderPrimitiveElement `case "div"`         | L140 |
+| 2515–2516        | div content from formData                   | L139 (id) |
+| 2520, 2522       | div id, style                               | L139, L147 |
+| 2540             | `isVersionEnable = (usingTabContainer && !standalone)` | L58, L234, L252 |
+| 2545–2557        | onlyDisplay/standalone guard skip           | L59, L86, L117, L142, L174, L206, L235, L253 |
+| 2561             | `if (val.primitive)` → renderPrimitiveElement | L145 |
+| 2569             | primitive `<CapColumn span={width}>`        | L146 |
+| 2576             | leaf type switch                            | L48, L81, L108, L140, L166, L196, L227, L245 |
+| 2577–2601        | `case "input"`                              | L46–L60 |
+| 2613–2617        | `case "textarea"` → renderTextAreaContent    | L106–L128 |
+| 2618–2637        | `case "checkbox"`                           | L155–L176 |
+| 2719–2737        | `case "tag-list"`                           | L75–L93 |
+| 2738–2752        | `case "button"`                             | L223–L257 |
+| 2741             | button colStyle                              | L226, L244 |
+| 2743             | `<CapButton type={buttonType}>`             | L228, L246 |
+| 2746             | save-button special-case OR callChildEvent   | L224, L242, L254 |
+| 2747             | button label (`val.value`)                  | L229, L247 |
+| 2754–2774        | `case "sms-preview"`                        | L194–L210 |
+| 2759             | preview content from `sms-editor`           | L106 (id literal) |
+| 2760             | preview unicodeEnabled from `unicode-validity` | L156 (id literal) |
+| 2762             | hardcoded `span={23} offset={1}`            | overrides L207 |
+| 2765             | preview customStyling                       | L198–L200 |
+| 2766             | preview channel                             | L208 |
+| 2768             | preview charCounterEnabled                  | L209 |
+| 3165             | `const schema = this.props.schema`          | L6 (definition) |
+| 3169–3174        | renderForm walks `standalone.sections`      | L7, L8 |
+
+---
+
+## 10. Visual graph
+
+```
+┌─────────────────────────────────── initialSchema.js (response) ────────────────────────────────────┐
+│                                                                                                    │
+│  metaEntities[0].definition                                                                        │
+│    ├── channel: "SMS"  ────────────────────────────────────────►  validateForm gate (line 437)    │
+│    └── standalone.sections                                                                         │
+│         └── [0] type:"parent" rowStyle:{flexDirection:'column'}                                    │
+│              ├── childSections[0]  type:"multicols" width:16  (empty cols)                         │
+│              │                                                                                     │
+│              ├── childSections[1]  type:"parent"                                                   │
+│              │     ├── childSections[0]  type:"parent"  id:"kiwi"  width:14                        │
+│              │     │     ├── multicols ─► cols[ template-name      (input)    ]                    │
+│              │     │     ├── multicols ─► cols[ tagList            (tag-list) ]                    │
+│              │     │     └── multicols ─► cols[ sms-editor         (textarea) ,                    │
+│              │     │                            sms-count          (div primitive),                │
+│              │     │                            unicode-validity   (checkbox)  ]                   │
+│              │     │                                                                               │
+│              │     └── childSections[1]  type:"multicols"  width:8                                 │
+│              │           └── cols[ sms-preview        (sms-preview) ]                              │
+│              │                                                                                     │
+│              └── childSections[2]  type:"multicols"                                                │
+│                    └── cols[ save-button             (button id-special-cased),                    │
+│                              test-and-preview-button (button -> callChildEvent('onClick')) ]       │
+└────────────────────────────────────────────────────────────────────────────────────────────────────┘
+                                       │
+                                       ▼
+┌─────────────────────────────────── FormBuilder/index.js ───────────────────────────────────────────┐
+│                                                                                                    │
+│  render() (3193) ─► renderForm() (3164) ─► schema.standalone.sections.map(renderSection)           │
+│                                                                                                    │
+│  renderSection (2493) ──┬── "parent"   ► renderParentSection (2473)   ── recurses ──► renderSection│
+│                         ├── "multicols"► renderMultiColSection (2530) ── per-col switch (2576)     │
+│                         └── "col-label"► renderColLabelSection                                     │
+│                                                                                                    │
+│  renderMultiColSection per-col switch:                                                             │
+│      val.primitive=true ─► renderPrimitiveElement (2507) ─► "div"/"span"   (sms-count)             │
+│      val.type "input"        ─► CapColumn>CapInput          (template-name)                        │
+│      val.type "textarea"     ─► renderTextAreaContent       (sms-editor)                           │
+│      val.type "checkbox"     ─► CapColumn>CapCheckbox       (unicode-validity)                     │
+│      val.type "tag-list"     ─► CapColumn>TagList           (tagList)                              │
+│      val.type "sms-preview"  ─► CapColumn>TemplatePreview   (sms-preview)                          │
+│      val.type "button"       ─► CapColumn>CapButton         (save-button, test-and-preview-button) │
+│                                                                                                    │
+│  Init phase (componentWillMount → initialiseForm, 1273):                                           │
+│      initializeStandAloneSections walks parent/multicols/col-label and seeds                       │
+│      formData[col.id]='' (or col.value), errorData[col.id]=false, formElements.push(col.id)        │
+│      then prunes formData keys not in formElements (1303–1314)                                     │
+│                                                                                                    │
+│  Validation/state side channel (uses formData/errorData keyed by val.id):                          │
+│      validateForm (430) channel-gates on schema.channel==='SMS' (437)                              │
+│      validateForm hard-codes: 'sms-editor', 'unicode-validity', 'template-name'                    │
+│      textarea errorMessage translates errorData tokens via i18n messages (2155–2168)               │
+│      saveForm/callChildEvent special-case: id==='save-button'                                      │
+└────────────────────────────────────────────────────────────────────────────────────────────────────┘
+```