# List Node
The **List Node** is a specialized 1-dimensional sequence container in Nodestr designed to bridge the gap between monolithic single-value Text Nodes and complex multi-column Table Nodes.
When you need an ordered sequence of entries—such as 10 email subject variations, 5 target keywords, 8 product names, or a list of test questions—the Table Node's multi-column grid is unnecessary overhead, while a Text Node lacks discrete indexing. The List Node provides fluid multi-line data entry with instant formatting and indexing.
---
## 1. Dual Output Architecture
Similar to the Table Node's `All Records` and individual column outputs, the List Node provides two independent output handles:
### A. All Items (`out-list-all` - Amber #F59E0B)
Located on the top right edge, this port outputs the entire collection formatted as a single unified markdown string according to your selected **Style**:
- **• Bullet**: Formats entries as markdown bullet points (`- Item 1\n- Item 2`).
- **1. Number**: Formats entries as an ordered numbered list (`1. Item 1\n2. Item 2`).
- **, Comma**: Formats entries as an inline comma-delimited sequence (`Item 1, Item 2, Item 3`).
- **↵ Line**: Formats entries separated by plain newlines (`Item 1\nItem 2`).
### B. Current Item (`out-list-item` - Green #5ED368)
Located on the bottom right edge, this scalar port emits only the single entry at the active `selectedIndex` (e.g. `Item 2`), making it ideal for direct interpolation into prompt templates.
---
## 2. Fluid Multi-Line Entry & Instant Badges
The List Node is engineered for zero-friction data entry:
1. **Multi-Line Text Area**: Simply type or paste text into the central textarea. Every non-empty line is parsed instantly into an item.
2. **Item Count & Badges**: The header and body render live pill badges showing the total item count and interactive chips: `[0] Item 1`, `[1] Item 2`.
3. **Interactive Stepper**: Cycle through items using the built-in `[ ‹ ] Item X of Y [ › ]` controls or click directly on any item chip to select it.
---
## 3. Table Column Ingestion
The List Node features a dedicated **Data In** target handle (**Sky Blue #38BDF8**) on its top left edge.
Connecting any Table Node column output port (or a File Loader or Text Node) to **Data In** automatically extracts all rows or lines into the list:
- The node displays an active auto-sync banner with the source name and item count.
- Updates made to the upstream data immediately propagate through the list and all downstream consumers.
- The manual multi-line text input is automatically concealed when connected, eliminating redundant controls and presenting a compact, streamlined card layout.
- The 1-click **Copy** formatted list button moves to the Item Chips toolbar so formatted output can still be copied at any time.
---
## 4. Item Character Guardrails & Limits
To protect canvas performance and prevent accidental prompt budget blowouts:
- **Per-Item Limit**: Individual list entries are clamped at **1,000 characters maximum**. If an upstream table cell or pasted line exceeds this threshold, it is automatically truncated and flagged with an alert.
- **Total Capacity**: Capped at **100 items in Local Mode** and **250 items in Cloud Mode**.
---
## 5. Index Node (Master Selector) Synchronization
Connecting an **Index Node** (formerly Record Selector) to the List Node's left **Violet input port** (**Index In #A855F7**) locks the local stepper to **External Index (`🔗`)**.
Advancing the master Index Node synchronizes the active item across all connected lists and tables simultaneously.
---
## 6. Pillar 1 Batch Execution Synergy
When connected to an **Output Hub**, the List Node can serve as an iterable batch driver. Running a batch over a 5-item list evaluates 5 distinct prompt runs, replacing `{{item}}` or `{{value}}` per cycle.