/generate-project-plan

Block: Text primitives (body, H3, bulleted list)

The text elements that appear inside almost every section.

Typography constants — STRICT (matches reference board)

Why three different H3 sizes? The reference board uses 40px for sub-section heads inside an otherwise full-width section (matches H2 visually for emphasis). Column titles in narrow contexts must be 24px so they don't wrap or overflow. Nested-section headers sit between — 32px reads as a section header without overflowing the child section.

All text uses the same font family and style. Size is the only variable for headers.

Load the font ONCE per use_figma script, before creating any text:

const font = { family: 'Inter', style: 'Medium' };
await figma.loadFontAsync(font);

Body paragraph

const body = figma.createText();
body.fontName = font;
body.fontSize = 16;
body.characters = BODY_TEXT;
body.fills = [{ type: 'SOLID', color: CHARCOAL }];
body.textAutoResize = 'HEIGHT';
section.appendChild(body);
body.x = 32;
body.y = h2.y + h2.height + 16;
body.resize(800 - 64, body.height); // wrap at inner width = 736

H3 subheader — pick the size for the context

// Full-width subhead inside a single-column section (e.g. "Resources" in Motivation)
const h3Full = figma.createText();
h3Full.fontName = font;
h3Full.fontSize = 40;                          // STRICT: 40, NOT 24
h3Full.characters = "Resources";
h3Full.fills = [{ type: 'SOLID', color: CHARCOAL }];
section.appendChild(h3Full);
h3Full.x = 32;
h3Full.y = body.y + body.height + 24;

// Nested-section header (e.g. "Design Decision 1: Delivery Surface")
h3Nested.fontSize = 32;                        // STRICT: 32 (fits in 736-wide child section)

// Column title in a multi-column layout (e.g. "Goals", "Risks", "Open Questions")
h3Col.fontSize = 24;                           // STRICT: 24 (fits in 224-px columns without wrapping)

Bulleted list

FigJam text supports list formatting via setRangeListOptions. Each line is a list item. Load font first.

const items = ["Item one", "Item two", "Item three"];
const text = items.join('\n');

const list = figma.createText();
list.fontName = font;
list.fontSize = 16;
list.characters = text;
list.fills = [{ type: 'SOLID', color: CHARCOAL }];
list.textAutoResize = 'HEIGHT';
list.setRangeListOptions(0, text.length, { type: 'UNORDERED' });
list.setRangeIndentation(0, text.length, 1);
section.appendChild(list);
list.x = 32;
list.y = h3.y + h3.height + 16;
list.resize(800 - 64, list.height);

Ordered list

Same as bulleted, but type: 'ORDERED'.

list.setRangeListOptions(0, text.length, { type: 'ORDERED' });

Stacking rule — STRICT 24px between blocks

Every gap between sibling blocks inside a section is 24px. No exceptions. Use prevChild.y + prevChild.height + 24.

NEVER use a fixed offset. Read prevChild.height after the font size is set, then add 24. If you later change a header's fontSize, you must re-position every downstream child or they'll overlap.

Pre-flight checklist

• Font loaded before any characters / fontSize / fills on text nodes.
• Every text node appended to its parent BEFORE setting x/y / resize.
• textAutoResize = 'HEIGHT' + resize(w, text.height) for wrapped body / list nodes. H2/H3 use textAutoResize = 'WIDTH_AND_HEIGHT' or skip resize if they fit on one line.
• Return text node IDs in mutatedNodeIds.