Product media placeholder
Replace this area with a screenshot or short walkthrough video during the media sweep.
Pure text-data transform. Splits one or more source strings into an array of strings by granularity (char/word/sentence/line) and optionally reshapes into a cumulative pyramid (prefixes/suffixes). Decouples the data-shape problem from animation — feed items[] into textSequence, variantStagger, or any index-driven consumer. Example: granularity=char, shape=prefixes on "Sunny" → ["S","Su","Sun","Sunn","Sunny"] (classic typewriter). Input precedence (highest wins): `sources` stringArray port (multi-source — typically wired from domStringArrayRead for i18n cycles), `sources` string[] param, `text` string port (single-source wire), `text` string param. Multi-source mode decomposes each entry and concatenates — one graph chain types through every word in order. Emits a parallel `itemSources: floatArray` output that tags each item with its source index — lets downstream nodes drive per-source side effects (per-word colors, opacities, etc.) without re-deriving boundaries.
Type textDecomposeCategory textContext sharedDynamic ports noCompound no
Inputs
| Port | Type | Description |
|---|---|---|
text | string | Text |
sources | stringArray | Sources |
Outputs
| Port | Type | Description |
|---|---|---|
items | stringArray | Items |
count | float | Count |
itemSources | floatArray | Item → Source |
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
text | string | "" | Source text (fallback) |
granularity | enum | "char" | Granularity options char, word, sentence, line |
shape | enum | "atoms" | Shape options atoms, prefixes, suffixes |
includeEmpty | bool | false | Prepend empty entry |
stripWhitespace | bool | false | Strip whitespace-only entries |
separator | string | - | Custom separator (overrides granularity) |
Envelope
Use textDecompose as the node type inside a graph node envelope. Add id, optional params, optional connections, and optional activeWhen based on the guide context.
Generated source
Registry faster-motion-docs/node-registry.jsonCategory page /help/faster-motion/faster-motion-node-category-text/