v0.28.1

0.28.1 — 2026-10-30

Upgrade: Existing projects remain compatible. Rebuild and redeploy. Author syntax for figures is unchanged.

• Rename the control parts the figure widget generates. Icon buttons, the scrubber, the step count and the run box output carry wg_fx__* classes instead of fx__icon, fx__scrub, fx__count and fx__out. The run box editor, selected before as .fx[data-fx="run"] textarea, now carries wg_fx__editor, and a bar the widget builds carries wg_fx__bar next to fx__bar. Site CSS that targeted the old undocumented fx__icon, fx__scrub, fx__count or fx__out classes, or aria-disabled buttons inside fx__bar, loses that styling. The authoring vocabulary (fx, fx-*, fx__stage, fx__captions, fx__range, fx__bar, fx--ready, is-on, is-hl, data-*, --fx-*) moved into its own stylesheet, which is the documented contract.

Install

pnpm add -D --save-exact for-humanity@0.28.1

npm | Documentation

v0.28.0

0.28.0 — 2026-10-29

Upgrade: Existing projects remain compatible. Rebuild and redeploy to get the figure widget. A site that already carries its own copy of a figure runtime script in its documents must remove it, or step figures and run boxes get two sets of controls. CLI commands, configuration, document syntax and Node.js requirements are unchanged.

• Add interactive figures. A <figure class="fx" data-fx="steps"> written in raw HTML gets a bar with play, previous, next, a scrubber and the step count, and its elements show, highlight or move per step with data-on, data-hl and data-pos; data-labels turns the bar into tabs. data-fx="range" wires a slider to the --fx-v variable and an <output>, data-fx="run" runs the code block above it in a sandboxed iframe and shows the console, and data-fx="custom" leaves the scene to the author's own module script. The widget ships in the inline browser bundle like table sorting, so every page carries about 11 KB more script (under 4 KB compressed). Without JavaScript the page shows the elements marked to the end and every caption. Control names are English, or Korean when the page language is ko or a regional form such as ko-KR. See Figures.

Install

pnpm add -D --save-exact for-humanity@0.28.0

npm | Documentation

v0.27.0

0.27.0 — 2026-10-29

Upgrade: Existing projects remain compatible. Rebuild and redeploy to apply the larger text, the body font change and table sorting. Text struck through with a single ~ on each side needs ~~ now. CLI commands, configuration and Node.js requirements are unchanged.

• Enlarge text for reading: body text is 16px instead of 12px, navigation, outline, tables, code blocks and metadata are 14px, group labels 13px, part titles 17px, subheadings 18px, section headings 20px, page titles 26px, the site name 20px and a centered README title 32px. Diagram labels are 14px instead of 13px, and body letter spacing loosens from -0.03em to -0.02em.
• Set Latin, digits and punctuation in body text, labels and diagrams in IBM Plex Sans KR, the Latin its Hangul was designed with, instead of the monospaced Monoplex KR. Inline code, document navigation, the outline, code blocks, code file titles, reference chips and the status code keep Monoplex KR for Latin next to IBM Plex Sans KR Hangul, so code and the sidebars frame the text like a terminal; inline code is 15/16 of the surrounding size so it reads at the same height, and the outline narrows its word spaces so Hangul headings keep about their body spacing. A page that has not received the fonts yet shows the system sans-serif instead of the system monospace.
• Keep the hover shade of a Details title between its top and bottom lines. The title row used to reach 6px past both ends of the lines.
• Sort a table by clicking a column header. A table with a header row and at least two body rows shows an arrow at the right edge of a header when pointed at: the first click sorts that column ascending, the second descending and the third restores the written order, and the arrow turns as the direction changes. Numbers and dates in cell text sort by value, empty cells and - stay at the end, the sorted column is exposed as aria-sort, and the written order stays without JavaScript. A table with merged cells or a link in a header keeps its written order.
• Keep a single ~ as written, so a range such as 10~11개월 or 400~600 is no longer struck through. Strikethrough needs ~~ on each side.

Install

pnpm add -D --save-exact for-humanity@0.27.0

npm | Documentation

v0.26.3

0.26.3 — 2026-10-28

Upgrade: Existing projects remain compatible. Rebuild and redeploy to apply the new card type. CLI commands, configuration, document syntax and Node.js requirements are unchanged.

• Show the link preview image at full width on Slack and X. With image set, pages declare the summary_large_image Twitter card instead of summary, which those services drew as a small thumbnail beside the text. Sites without image keep summary.

Install

pnpm add -D --save-exact for-humanity@0.26.3

npm | Documentation

v0.26.2

0.26.2 — 2026-10-28

Upgrade: Existing projects remain compatible. Rebuild and redeploy to apply the new heading sizes, lines, code font and diagram style. CLI commands, configuration, document syntax and Node.js requirements are unchanged.

• Make headings easier to tell apart from body text: page titles are 20px, section headings 17px and subheadings 14px instead of 16px, 15px and 12px. A subheading now leaves about three lines (60px) of space above it, and a subheading right under a section heading stays close to it. The site name in the sidebar keeps its 16px size.
• Replace the dotted lines with solid gray ones under the document head, between parts, for --- and around Details. Hovering a Details title shades the whole row, and an open Details draws a thin line down its content, indented to the title text, so it is clear where the folded content ends.
• Set Hangul in code blocks and code file titles in IBM Plex Sans KR like body text; Latin stays in Monoplex KR. Hangul in code no longer lines up to exactly two Latin columns.
• Draw diagrams in the same black-and-white style as the rest of the page instead of soft blue: boxes on the light warm gray used for row hover with one-color gray borders (Mermaid 12's left-to-right border gradient is off), square corners, no shadows, thin gray connectors ending in small open arrowheads, subgraphs on the page background and notes in the highlighter yellow. Sequence diagrams use the same font and 13px size as flowcharts instead of Mermaid's 16px Trebuchet. Dark mode uses the matching dark values. A diagram that sets its own theme in frontmatter keeps it.
• Trim the side padding of inline code so a Hangul particle right after it no longer looks detached.

Install

pnpm add -D --save-exact for-humanity@0.26.2

npm | Documentation

v0.26.1

0.26.1 — 2026-10-27

Upgrade: Same package as 0.26.0, which was tagged but never published to npm because the release check failed. Install this version.

• Publish the 0.26.0 changes: flowchart labels longer than 120px are no longer cut off, and diagrams use the site's palette and font.

Install

pnpm add -D --save-exact for-humanity@0.26.1

npm | Documentation

v0.25.0

0.25.0 — 2026-10-27

Upgrade: Existing projects remain compatible. Rebuild and redeploy to apply the heading chips. CLI commands, configuration, document syntax and Node.js requirements are unchanged.

• Show a heading whose whole text is a configured refs prefix and a number, such as ### Q3, as the same chip as a link to it, at the heading's size, so a numbered question and the chips that point to it look alike. Raw HTML links whose text is a prefix and a number become chips too.

Install

pnpm add -D --save-exact for-humanity@0.25.0

npm | Documentation

v0.24.0

0.24.0 — 2026-10-27

Upgrade: Existing projects remain compatible. The status configuration accepts two more kind values, refs is a new optional key, and hash links to missing headings now print a build warning. Rebuild and redeploy to apply the new badge and chip styles. CLI commands, document syntax and Node.js requirements are unchanged.

• Add blocked (red) and neutral (gray) status badge kinds next to verified and unverified, so a document can mark blocked work and settled outcomes in their own colors.
• Add the refs configuration. A link whose text is a configured uppercase prefix and a number, such as [Q3](questions.md#q3), is shown as a small chip in gray, blue, violet or amber, so numbered decisions and questions stand out where the body refers to them. The link address is unchanged and documents without refs render as before.
• Warn at build time when a #hash link points to a heading that does not exist, in the same document or in another document, with the file and line number. Links to headings on the home page are not checked. The build continues as it does for a link to a missing document.

Install

pnpm add -D --save-exact for-humanity@0.24.0

npm | Documentation

v0.23.2

0.23.2 — 2026-10-27

Upgrade: Existing projects remain compatible. Rebuild and redeploy to apply the new code colors, date labels and heading spacing. CLI commands, configuration, document syntax and Node.js requirements are unchanged.

• Color code blocks with GitHub's light and dark syntax themes, following the system color scheme. Comments and purple tokens use the darker values github.com uses today, so they stay readable on the code box background. The code box keeps its own background and border.
• Label document dates on Korean pages as 작성일 and 수정일 instead of 처음 작성 and 다시 정리. Pages in other languages keep Created and Revised.
• Give body headings more room: a section heading sits 28px below its divider and 14px above its text, and subheadings and h4 headings leave 10px above their text.

Install

pnpm add -D --save-exact for-humanity@0.23.2

npm | Documentation

v0.23.1

0.23.1 — 2026-10-27

Upgrade: Existing projects remain compatible. Rebuild and redeploy to apply the figure border. CLI commands, configuration, document syntax and Node.js requirements are unchanged.

• Draw an SVG figure in a box with the same border and padding as Mermaid diagrams, and center it in the box. Raster images keep their current layout.

Install

pnpm add -D --save-exact for-humanity@0.23.1

npm | Documentation