From 59775f0235852dac3c2f11f5a14fc789045f8317 Mon Sep 17 00:00:00 2001 From: "Ronald A. Richardson" Date: Wed, 27 May 2026 14:24:53 +0800 Subject: [PATCH] fix(api-docs): indent every line of multi-line Param descriptions The generator only prefixed the first line of descriptions with the JSX content indent, so multi-line descriptions (e.g. an intro line followed by a markdown bullet list) left subsequent lines at a shallower column than the JSX block. MDX treated the dedent as exiting the JSX element, leaving the closing tag orphaned and failing the build. Re-indent every line of the description with the JSX content indent so markdown blocks stay inside the . Also bumps vendor/postman to f00acb0 (PR #7: Customers + Order Configs) which is the input that surfaced this bug. Co-Authored-By: Claude Opus 4.7 (1M context) --- scripts/generate-api-docs.mjs | 6 +++++- vendor/postman | 2 +- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/scripts/generate-api-docs.mjs b/scripts/generate-api-docs.mjs index b927b69b..6962a4d1 100644 --- a/scripts/generate-api-docs.mjs +++ b/scripts/generate-api-docs.mjs @@ -914,7 +914,11 @@ function renderParam(field, indent) { const lines = [head]; if (desc) { - lines.push(`${indent} ${escapeJsxText(desc)}`); + const escaped = escapeJsxText(desc); + const descLines = escaped.split('\n'); + for (const dl of descLines) { + lines.push(dl.length ? `${indent} ${dl}` : ''); + } } if (Array.isArray(nested) && nested.length > 0) { diff --git a/vendor/postman b/vendor/postman index f2b8cdb3..f00acb05 160000 --- a/vendor/postman +++ b/vendor/postman @@ -1 +1 @@ -Subproject commit f2b8cdb35fc849507a7fd42cfd3c146cd2b6ec53 +Subproject commit f00acb05d7da53f1b58a72e21df257bc4935df44