0.2.7

Release notes for 0.2.7.

Released: 2026-06-15

Features

• Adopt a semantic z-index token system — a single source-of-truth token set with codegen, a drift check, and a generated @theme block; migrate every z-index usage onto the tokens and add a lint rule that prohibits raw numeric z-{n} Tailwind utilities (#2148, 1ba07ea1)

• Generator now emits a search header item by default (#2139, 45d496f4)

• Wire the mermaid, onBrokenLinks, and sitemap settings through config, and document the reserved ones (#2140, 7c56eee3)

Bug Fixes

• Close the search dialog on result click and harden its overlay z-index (#2148, 794827f1)

• Apply the dialog SPA-swap z-index defense (z-modal / z-modal-backdrop) to the doc-history, ai-chat, and image-enlarge dialogs (#2157, 0f91b276)

• Restore lint:tokens enforcement via a symlink-tolerant pnpm patch (#2156, e16e122e)

• Use onInput for the sidebar live filter so it works under non-compat Preact builds (348ae115)

• Islands: fix modal-nav churn, image-enlarge gating/teardown, and accessibility issues (#2136, 03a6a36d)

• Harden the ai-chat API with a locale guard plus input/URL validation (#2142, f240b64e)

• doc-history / search: add timeouts, bound fan-out, and guard batch parsing (#2141, 1c4c39be)

• Harden doc-history postBuild and locales validation, and fix header casing (#2137, 68221856)

• Bound the claude-resources CLAUDE.md walk to claudeDir when projectRoot is omitted (#2115, dfb4c28b)

Other Changes

• Bump the @takazudo/zfb family from 0.1.0-next.44 to 0.1.0-next.47 — additive (dual light/dark syntect themes, dev boot-lazy mode, client-router timer fixes), no consumer-facing breaking change (#2159, 650b17fb)

• Decouple zdtp from the public type surface and guard the package safelist (#2138, feeb0d40)

• Add icon-size tokens, tokenize literal sizes, and clean up the lint config (#2143, fcfb3d91)

• CI: pin wrangler, disable workers_dev, add a production link check, and guard fork PRs (#2144, 283b1963); drop the stale npm next dist-tag on stable graduation (#2121, 08c8f6ef); fix the exam Full-E2E reporter passthrough and make issue filing jq-free (#2122, 509176d5)

• Expand documentation — code-group name/groupId and custom directive registration; configuration options (defaultLocale, defaultLocaleOnlyPrefixes, metaTags, bodyFootUtilArea, headerRightItems, tag settings); advanced resolve-links dirs/routePrefix; the admonitions important variant; i18n defaultLocale; and the available color schemes — plus fixes to stale counts, grammar, and references (#2134, #2145)

• Make the create-zudo-doc preset-swap test resilient to registry flakes (#2123, bda63e20)