@takazudo/zudo-doc 5.28.2 → 6.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (511) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/README.md +49 -16
  3. package/bin/gen-z-index.mjs +18 -18
  4. package/dist/agent-docs/identity.d.ts +4 -0
  5. package/dist/agent-docs/identity.js +24 -0
  6. package/dist/agent-docs/index.d.ts +5 -0
  7. package/dist/agent-docs/index.js +5 -0
  8. package/dist/agent-docs/limits.d.ts +11 -0
  9. package/dist/agent-docs/limits.js +24 -0
  10. package/dist/agent-docs/search.d.ts +14 -0
  11. package/dist/agent-docs/search.js +82 -0
  12. package/dist/agent-docs/tokenize.d.ts +2 -0
  13. package/dist/agent-docs/tokenize.js +22 -0
  14. package/dist/agent-docs/types.d.ts +68 -0
  15. package/dist/agent-docs/types.js +0 -0
  16. package/dist/ai-chat-modal/index.d.ts +1 -4
  17. package/dist/ai-chat-modal/index.js +183 -123
  18. package/dist/asset-components/asset-card.d.ts +1 -2
  19. package/dist/asset-components/asset-card.js +12 -12
  20. package/dist/asset-components/asset-code.d.ts +1 -2
  21. package/dist/asset-components/asset-code.js +10 -10
  22. package/dist/asset-components/shared.d.ts +3 -4
  23. package/dist/asset-components/shared.js +4 -4
  24. package/dist/asset-index-page/body.d.ts +5 -6
  25. package/dist/asset-index-page/body.js +6 -6
  26. package/dist/asset-index-page/index.d.ts +1 -2
  27. package/dist/asset-index-page/index.js +1 -1
  28. package/dist/asset-page/body.d.ts +5 -9
  29. package/dist/asset-page/body.js +3 -3
  30. package/dist/asset-page/components.d.ts +16 -17
  31. package/dist/asset-page/components.js +10 -9
  32. package/dist/asset-page/index.d.ts +1 -2
  33. package/dist/asset-page/index.js +1 -1
  34. package/dist/auto-logo/index.d.ts +1 -2
  35. package/dist/auto-logo/index.js +2 -2
  36. package/dist/body-foot-util/body-foot-util-area.d.ts +3 -4
  37. package/dist/body-foot-util/body-foot-util-area.js +1 -2
  38. package/dist/body-foot-util/edit-link.d.ts +2 -3
  39. package/dist/body-foot-util/edit-link.js +1 -2
  40. package/dist/breadcrumb/breadcrumb.d.ts +6 -6
  41. package/dist/breadcrumb/breadcrumb.js +3 -4
  42. package/dist/catalog.js +1 -1
  43. package/dist/category-nav/index.d.ts +1 -2
  44. package/dist/category-nav/index.js +11 -5
  45. package/dist/category-tree-nav/index.d.ts +1 -2
  46. package/dist/category-tree-nav/index.js +3 -3
  47. package/dist/chrome/derive.d.ts +18 -27
  48. package/dist/chrome/derive.js +47 -29
  49. package/dist/chrome/index.d.ts +5 -5
  50. package/dist/chrome/index.js +1 -1
  51. package/dist/chrome/island-data.d.ts +4 -0
  52. package/dist/chrome/island-data.js +52 -0
  53. package/dist/chrome/primary-slots.d.ts +2 -3
  54. package/dist/chrome-bindings.d.ts +30 -22
  55. package/dist/code-group/index.d.ts +3 -4
  56. package/dist/code-group/index.js +3 -7
  57. package/dist/code-syntax/code-block-enhancer.d.ts +1 -2
  58. package/dist/code-syntax/code-block-enhancer.js +2 -2
  59. package/dist/code-syntax/mermaid-init.d.ts +1 -2
  60. package/dist/code-syntax/mermaid-init.js +5 -2
  61. package/dist/code-syntax/tabs-init-script.js +1 -1
  62. package/dist/code-syntax/tabs-init.d.ts +1 -2
  63. package/dist/code-syntax/tabs-init.js +2 -2
  64. package/dist/code-syntax/tabs.d.ts +6 -6
  65. package/dist/code-syntax/tabs.js +8 -8
  66. package/dist/compiled.css +2937 -2942
  67. package/dist/config/component-tokens.d.ts +1 -1
  68. package/dist/config/component-tokens.js +22 -0
  69. package/dist/config-assertions/index.d.ts +13 -0
  70. package/dist/config-assertions/index.js +14 -0
  71. package/dist/config.d.ts +36 -17
  72. package/dist/config.js +23 -95
  73. package/dist/content/content-blockquote.d.ts +2 -3
  74. package/dist/content/content-blockquote.js +3 -3
  75. package/dist/content/content-code.d.ts +3 -4
  76. package/dist/content/content-code.js +5 -5
  77. package/dist/content/content-link.d.ts +3 -4
  78. package/dist/content/content-link.js +10 -10
  79. package/dist/content/content-ol.d.ts +2 -3
  80. package/dist/content/content-ol.js +5 -4
  81. package/dist/content/content-paragraph.d.ts +2 -3
  82. package/dist/content/content-paragraph.js +1 -1
  83. package/dist/content/content-strong.d.ts +2 -3
  84. package/dist/content/content-strong.js +3 -3
  85. package/dist/content/content-table.d.ts +2 -3
  86. package/dist/content/content-table.js +4 -4
  87. package/dist/content/content-ul.d.ts +2 -3
  88. package/dist/content/content-ul.js +4 -4
  89. package/dist/content/heading-h2.d.ts +2 -3
  90. package/dist/content/heading-h2.js +4 -4
  91. package/dist/content/heading-h3.d.ts +2 -3
  92. package/dist/content/heading-h3.js +4 -4
  93. package/dist/content/heading-h4.d.ts +2 -3
  94. package/dist/content/heading-h4.js +4 -4
  95. package/dist/content-admonition/index.d.ts +3 -4
  96. package/dist/content-admonition/index.js +2 -2
  97. package/dist/content.css +35 -33
  98. package/dist/design-token-panel-bootstrap-controller.d.ts +178 -0
  99. package/dist/design-token-panel-bootstrap-controller.js +359 -0
  100. package/dist/design-token-panel-bootstrap-island.d.ts +5 -0
  101. package/dist/design-token-panel-bootstrap-island.js +19 -0
  102. package/dist/design-token-panel-bootstrap.d.ts +5 -195
  103. package/dist/design-token-panel-bootstrap.js +3 -288
  104. package/dist/desktop-sidebar-toggle-island/index.d.ts +2 -7
  105. package/dist/desktop-sidebar-toggle-island/index.js +2 -58
  106. package/dist/desktop-sidebar-toggle-island/island.d.ts +4 -0
  107. package/dist/desktop-sidebar-toggle-island/island.js +43 -0
  108. package/dist/desktop-sidebar-toggle-island/storage.d.ts +4 -0
  109. package/dist/desktop-sidebar-toggle-island/storage.js +29 -0
  110. package/dist/desktop-toc-toggle-island/index.d.ts +2 -7
  111. package/dist/desktop-toc-toggle-island/index.js +2 -58
  112. package/dist/desktop-toc-toggle-island/island.d.ts +4 -0
  113. package/dist/desktop-toc-toggle-island/island.js +43 -0
  114. package/dist/desktop-toc-toggle-island/storage.d.ts +4 -0
  115. package/dist/desktop-toc-toggle-island/storage.js +29 -0
  116. package/dist/details/details.d.ts +3 -4
  117. package/dist/details/details.js +1 -1
  118. package/dist/doc-body-end/index.d.ts +1 -2
  119. package/dist/doc-body-end/index.js +1 -1
  120. package/dist/doc-body-end-islands/design-token-panel-island.d.ts +2 -2
  121. package/dist/doc-body-end-islands/design-token-panel-island.js +3 -7
  122. package/dist/doc-body-end-islands/index.d.ts +4 -21
  123. package/dist/doc-body-end-islands/index.js +5 -3
  124. package/dist/doc-body-end-islands/theme-pack-switcher-island.d.ts +3 -13
  125. package/dist/doc-body-end-islands/theme-pack-switcher-island.js +11 -13
  126. package/dist/doc-content-header/index.d.ts +1 -2
  127. package/dist/doc-content-header/index.js +1 -1
  128. package/dist/doc-history/index.d.ts +1 -1
  129. package/dist/doc-history/index.js +166 -141
  130. package/dist/doc-history-area/index.d.ts +6 -4
  131. package/dist/doc-history-area/index.js +17 -16
  132. package/dist/doc-metainfo-area/index.d.ts +2 -3
  133. package/dist/doc-metainfo-area/index.js +1 -1
  134. package/dist/doc-page-renderer/index.d.ts +13 -7
  135. package/dist/doc-page-renderer/index.js +10 -1
  136. package/dist/doc-page-shell/index.d.ts +20 -7
  137. package/dist/doc-page-shell/index.js +17 -6
  138. package/dist/doc-pager/index.d.ts +1 -2
  139. package/dist/doc-pager/index.js +3 -3
  140. package/dist/doc-tags-area/index.d.ts +2 -3
  141. package/dist/doc-tags-area/index.js +1 -1
  142. package/dist/doclayout/doc-layout-with-defaults.d.ts +9 -9
  143. package/dist/doclayout/doc-layout-with-defaults.js +5 -15
  144. package/dist/doclayout/doc-layout.d.ts +26 -27
  145. package/dist/doclayout/doc-layout.js +23 -14
  146. package/dist/docs-schema/index.d.ts +4 -0
  147. package/dist/docs-schema/index.js +1 -0
  148. package/dist/extract-headings/index.js +43 -12
  149. package/dist/factory-context/index.d.ts +22 -19
  150. package/dist/features.css +75 -8
  151. package/dist/find-in-page/find-bar.d.ts +4 -2
  152. package/dist/find-in-page/find-bar.js +58 -69
  153. package/dist/find-in-page/index.d.ts +2 -8
  154. package/dist/find-in-page/index.js +33 -30
  155. package/dist/footer/footer.d.ts +3 -4
  156. package/dist/footer/footer.js +3 -3
  157. package/dist/footer-with-defaults/index.d.ts +2 -3
  158. package/dist/footer-with-defaults/index.js +1 -1
  159. package/dist/frontmatter-preview-defaults/index.js +1 -0
  160. package/dist/head/doc-head.d.ts +1 -1
  161. package/dist/head/doc-head.js +24 -32
  162. package/dist/head/og-tags.d.ts +1 -1
  163. package/dist/head/og-tags.js +8 -7
  164. package/dist/head/twitter-card.d.ts +1 -1
  165. package/dist/head/twitter-card.js +1 -1
  166. package/dist/head-with-defaults/index.d.ts +7 -2
  167. package/dist/head-with-defaults/index.js +46 -32
  168. package/dist/header/header.d.ts +8 -8
  169. package/dist/header/header.js +9 -11
  170. package/dist/header/types.d.ts +7 -7
  171. package/dist/header-with-defaults/index.d.ts +3 -4
  172. package/dist/header-with-defaults/index.js +27 -14
  173. package/dist/home-intro/index.d.ts +2 -5
  174. package/dist/home-intro/index.js +7 -5
  175. package/dist/home-intro/prepare.js +4 -3
  176. package/dist/home-page/index.d.ts +3 -3
  177. package/dist/home-page/index.js +19 -17
  178. package/dist/html-preview-wrapper/highlighted-code.d.ts +3 -4
  179. package/dist/html-preview-wrapper/highlighted-code.js +19 -17
  180. package/dist/html-preview-wrapper/html-preview-wrapper.d.ts +4 -25
  181. package/dist/html-preview-wrapper/html-preview-wrapper.js +2 -87
  182. package/dist/html-preview-wrapper/html-preview.d.ts +3 -10
  183. package/dist/html-preview-wrapper/html-preview.js +13 -37
  184. package/dist/html-preview-wrapper/index.d.ts +2 -1
  185. package/dist/html-preview-wrapper/index.js +1 -1
  186. package/dist/html-preview-wrapper/preview-base.d.ts +3 -5
  187. package/dist/html-preview-wrapper/preview-base.js +56 -59
  188. package/dist/html-preview-wrapper/wrapper.d.ts +20 -0
  189. package/dist/html-preview-wrapper/wrapper.js +37 -0
  190. package/dist/hydration-pending.d.ts +3 -5
  191. package/dist/hydration-pending.js +7 -5
  192. package/dist/i18n-version/language-switcher.d.ts +5 -32
  193. package/dist/i18n-version/language-switcher.js +5 -106
  194. package/dist/i18n-version/switcher-generated-scripts.d.ts +2 -0
  195. package/dist/i18n-version/switcher-generated-scripts.js +107 -0
  196. package/dist/i18n-version/switcher-url-state.d.ts +76 -0
  197. package/dist/i18n-version/switcher-url-state.js +103 -0
  198. package/dist/i18n-version/version-banner.d.ts +2 -3
  199. package/dist/i18n-version/version-banner.js +1 -1
  200. package/dist/i18n-version/version-switcher.d.ts +5 -50
  201. package/dist/i18n-version/version-switcher.js +5 -157
  202. package/dist/icons/index.d.ts +18 -19
  203. package/dist/icons/index.js +17 -33
  204. package/dist/image-enlarge/index.d.ts +1 -10
  205. package/dist/image-enlarge/index.js +80 -55
  206. package/dist/image-enlarge/public.d.ts +2 -0
  207. package/dist/image-enlarge/public.js +6 -0
  208. package/dist/image-enlarge/ssr-fallback.d.ts +2 -0
  209. package/dist/image-enlarge/ssr-fallback.js +8 -0
  210. package/dist/index.d.ts +11 -4
  211. package/dist/inline-version-switcher/index.d.ts +1 -2
  212. package/dist/inline-version-switcher/index.js +1 -1
  213. package/dist/island-types/index.d.ts +2 -2
  214. package/dist/island-types/index.js +1 -5
  215. package/dist/math-block/index.d.ts +4 -7
  216. package/dist/math-block/index.js +5 -5
  217. package/dist/mcp/handler.d.ts +8 -0
  218. package/dist/mcp/handler.js +129 -0
  219. package/dist/mcp/index.d.ts +4 -0
  220. package/dist/mcp/index.js +7 -0
  221. package/dist/mcp/loader.d.ts +19 -0
  222. package/dist/mcp/loader.js +202 -0
  223. package/dist/mdx-components/index.js +40 -108
  224. package/dist/mermaid-enlarge/index.d.ts +1 -8
  225. package/dist/mermaid-enlarge/index.js +174 -158
  226. package/dist/mermaid-enlarge/public.d.ts +2 -0
  227. package/dist/mermaid-enlarge/public.js +6 -0
  228. package/dist/mermaid-enlarge/ssr-fallback.d.ts +2 -0
  229. package/dist/mermaid-enlarge/ssr-fallback.js +8 -0
  230. package/dist/metainfo/doc-metainfo.d.ts +2 -3
  231. package/dist/metainfo/doc-metainfo.js +1 -4
  232. package/dist/metainfo/doc-tags.d.ts +2 -3
  233. package/dist/metainfo/doc-tags.js +1 -1
  234. package/dist/metainfo/frontmatter-preview.d.ts +3 -4
  235. package/dist/metainfo/frontmatter-preview.js +1 -1
  236. package/dist/nav-data-prep/index.js +6 -4
  237. package/dist/nav-indexing/category-nav.d.ts +2 -3
  238. package/dist/nav-indexing/category-nav.js +1 -2
  239. package/dist/nav-indexing/category-tree-nav.d.ts +2 -3
  240. package/dist/nav-indexing/category-tree-nav.js +1 -1
  241. package/dist/nav-indexing/doc-card-grid.d.ts +2 -3
  242. package/dist/nav-indexing/doc-card-grid.js +1 -2
  243. package/dist/nav-indexing/docs-sitemap.d.ts +2 -3
  244. package/dist/nav-indexing/docs-sitemap.js +2 -2
  245. package/dist/nav-indexing/index.d.ts +1 -1
  246. package/dist/nav-indexing/nav-card-grid.d.ts +2 -3
  247. package/dist/nav-indexing/nav-card-grid.js +1 -2
  248. package/dist/nav-indexing/note-tray-index-parts/card-list.d.ts +1 -2
  249. package/dist/nav-indexing/note-tray-index-parts/card-list.js +4 -4
  250. package/dist/nav-indexing/note-tray-index-parts/date-line.d.ts +2 -3
  251. package/dist/nav-indexing/note-tray-index-parts/date-line.js +1 -1
  252. package/dist/nav-indexing/note-tray-index-parts/index-list.d.ts +1 -2
  253. package/dist/nav-indexing/note-tray-index-parts/index-list.js +2 -2
  254. package/dist/nav-indexing/note-tray-index-parts/timeline.d.ts +1 -2
  255. package/dist/nav-indexing/note-tray-index-parts/timeline.js +2 -2
  256. package/dist/nav-indexing/note-tray-index.d.ts +1 -2
  257. package/dist/nav-indexing/note-tray-index.js +1 -1
  258. package/dist/nav-indexing/site-tree-nav-demo.d.ts +2 -3
  259. package/dist/nav-indexing/site-tree-nav-demo.js +2 -2
  260. package/dist/nav-indexing/tag-nav.d.ts +1 -2
  261. package/dist/nav-indexing/tag-nav.js +1 -1
  262. package/dist/nav-indexing/types.d.ts +2 -2
  263. package/dist/nav-indexing/versions-page-content.d.ts +2 -3
  264. package/dist/nav-indexing/versions-page-content.js +8 -8
  265. package/dist/note-tray-index/index.d.ts +1 -2
  266. package/dist/note-tray-index/index.js +1 -1
  267. package/dist/page-loading/page-loading-overlay.d.ts +1 -2
  268. package/dist/page-loading/page-loading-overlay.js +3 -5
  269. package/dist/plugins/agent-export.d.ts +3 -0
  270. package/dist/plugins/agent-export.js +34 -0
  271. package/dist/plugins/internal/agent-export/chunk.d.ts +5 -0
  272. package/dist/plugins/internal/agent-export/chunk.js +90 -0
  273. package/dist/plugins/internal/agent-export/index.d.ts +24 -0
  274. package/dist/plugins/internal/agent-export/index.js +123 -0
  275. package/dist/plugins/internal/agent-export/normalize.d.ts +5 -0
  276. package/dist/plugins/internal/agent-export/normalize.js +73 -0
  277. package/dist/plugins/internal/llms-txt/dev-middleware.d.ts +6 -0
  278. package/dist/plugins/internal/llms-txt/dev-middleware.js +8 -3
  279. package/dist/plugins/internal/llms-txt/emit.js +23 -6
  280. package/dist/plugins/internal/llms-txt/generate.d.ts +7 -1
  281. package/dist/plugins/internal/llms-txt/generate.js +9 -2
  282. package/dist/plugins/internal/llms-txt/load.d.ts +2 -0
  283. package/dist/plugins/internal/llms-txt/load.js +20 -4
  284. package/dist/plugins/internal/llms-txt/types.d.ts +10 -0
  285. package/dist/plugins/routes.js +4 -0
  286. package/dist/preset.d.ts +19 -9
  287. package/dist/preset.js +20 -1
  288. package/dist/route-context-payload/index.js +1 -1
  289. package/dist/routes/404.d.ts +2 -3
  290. package/dist/routes/404.js +1 -1
  291. package/dist/routes/_chrome.d.ts +5 -5
  292. package/dist/routes/_chrome.js +7 -2
  293. package/dist/routes/_context.d.ts +4 -4
  294. package/dist/routes/_design-token-panel-bootstrap.d.ts +1 -4
  295. package/dist/routes/_design-token-panel-bootstrap.js +9 -1
  296. package/dist/routes/docs-slug.d.ts +2 -3
  297. package/dist/routes/docs-tags-index.d.ts +2 -3
  298. package/dist/routes/docs-tags-index.js +1 -1
  299. package/dist/routes/docs-tags-tag.d.ts +2 -3
  300. package/dist/routes/docs-tags-tag.js +1 -1
  301. package/dist/routes/docs-versions.d.ts +2 -3
  302. package/dist/routes/docs-versions.js +1 -1
  303. package/dist/routes/files-path.d.ts +2 -3
  304. package/dist/routes/files-path.js +1 -1
  305. package/dist/routes/index.d.ts +2 -3
  306. package/dist/routes/index.js +1 -1
  307. package/dist/routes/locale-docs-slug.d.ts +2 -3
  308. package/dist/routes/locale-docs-tags-index.d.ts +2 -3
  309. package/dist/routes/locale-docs-tags-index.js +1 -1
  310. package/dist/routes/locale-docs-tags-tag.d.ts +2 -3
  311. package/dist/routes/locale-docs-tags-tag.js +1 -1
  312. package/dist/routes/locale-docs-versions.d.ts +2 -3
  313. package/dist/routes/locale-docs-versions.js +1 -1
  314. package/dist/routes/locale-files-path.d.ts +2 -3
  315. package/dist/routes/locale-files-path.js +1 -1
  316. package/dist/routes/locale-index.d.ts +2 -3
  317. package/dist/routes/locale-index.js +1 -1
  318. package/dist/routes/mcp.d.ts +5 -0
  319. package/dist/routes/mcp.js +25 -0
  320. package/dist/routes/v-docs-slug.d.ts +2 -3
  321. package/dist/routes/v-locale-docs-slug.d.ts +2 -3
  322. package/dist/search-widget/index.d.ts +1 -2
  323. package/dist/search-widget/index.js +4 -7
  324. package/dist/search-widget-script/generated-script.js +12 -5
  325. package/dist/settings-defaults.d.ts +2 -0
  326. package/dist/settings-defaults.js +93 -0
  327. package/dist/settings.d.ts +8 -2
  328. package/dist/sidebar/client-data.d.ts +18 -0
  329. package/dist/sidebar/client-data.js +47 -0
  330. package/dist/sidebar/index.d.ts +3 -1
  331. package/dist/sidebar/index.js +3 -1
  332. package/dist/sidebar/sidebar.d.ts +12 -44
  333. package/dist/sidebar/sidebar.js +4 -3
  334. package/dist/sidebar/types.d.ts +14 -0
  335. package/dist/sidebar-prepaint/index.d.ts +1 -2
  336. package/dist/sidebar-prepaint/index.js +4 -6
  337. package/dist/sidebar-resizer/sidebar-resizer-init.d.ts +2 -3
  338. package/dist/sidebar-resizer/sidebar-resizer-init.js +3 -3
  339. package/dist/sidebar-toggle-island/index.d.ts +8 -11
  340. package/dist/sidebar-toggle-island/index.js +75 -62
  341. package/dist/sidebar-tree/build-tree.js +5 -6
  342. package/dist/sidebar-tree/types.d.ts +2 -0
  343. package/dist/sidebar-tree-island/index.d.ts +4 -19
  344. package/dist/sidebar-tree-island/index.js +782 -436
  345. package/dist/sidebar-tree-island/scope-state.d.ts +38 -0
  346. package/dist/sidebar-tree-island/scope-state.js +151 -0
  347. package/dist/sidebar-tree-island/sidebar-scroll-preserve.js +6 -2
  348. package/dist/sidebar-utils/index.d.ts +17 -19
  349. package/dist/sidebar-utils/index.js +100 -3
  350. package/dist/sidebar-utils/scope.d.ts +11 -0
  351. package/dist/sidebar-utils/scope.js +67 -0
  352. package/dist/sidebar-with-defaults/index.d.ts +1 -2
  353. package/dist/sidebar-with-defaults/index.js +19 -18
  354. package/dist/site-schema/nav-tree.js +15 -15
  355. package/dist/site-schema/types.d.ts +1 -0
  356. package/dist/site-tree-nav/index.d.ts +2 -3
  357. package/dist/site-tree-nav/index.js +11 -12
  358. package/dist/site-tree-nav/normalize-island-props.d.ts +16 -0
  359. package/dist/site-tree-nav/normalize-island-props.js +122 -0
  360. package/dist/site-tree-nav-island/index.d.ts +3 -3
  361. package/dist/site-tree-nav-island/index.js +243 -144
  362. package/dist/smart-break/index.d.ts +3 -4
  363. package/dist/smart-break/index.js +1 -1
  364. package/dist/tab-item/tab-item.d.ts +3 -4
  365. package/dist/tab-item/tab-item.js +1 -1
  366. package/dist/tag-pages/index.d.ts +3 -3
  367. package/dist/tag-pages/index.js +10 -10
  368. package/dist/theme/color-scheme-provider.d.ts +3 -3
  369. package/dist/theme/color-scheme-provider.js +3 -3
  370. package/dist/theme/theme-pack-provider.d.ts +1 -1
  371. package/dist/theme/theme-pack-provider.js +3 -3
  372. package/dist/theme/theme-toggle.d.ts +2 -3
  373. package/dist/theme/theme-toggle.js +1 -1
  374. package/dist/theme-pack-dialog/index.d.ts +1 -1
  375. package/dist/theme-pack-dialog/index.js +69 -75
  376. package/dist/theme-pack-dialog/theme-pack-card.d.ts +3 -4
  377. package/dist/theme-pack-dialog/theme-pack-card.js +19 -17
  378. package/dist/theme-pack-switcher/index.d.ts +4 -5
  379. package/dist/theme-pack-switcher/index.js +52 -49
  380. package/dist/theme-packs/academia/meta.json +1 -1
  381. package/dist/theme-packs/academia/pack.css +1 -1
  382. package/dist/theme-packs/bauhaus/meta.json +1 -1
  383. package/dist/theme-packs/bauhaus/pack.css +2 -2
  384. package/dist/theme-packs/blueprint/meta.json +1 -1
  385. package/dist/theme-packs/blueprint/pack.css +2 -2
  386. package/dist/theme-packs/botanica/meta.json +1 -1
  387. package/dist/theme-packs/botanica/pack.css +2 -2
  388. package/dist/theme-packs/broadsheet/meta.json +1 -1
  389. package/dist/theme-packs/broadsheet/pack.css +2 -2
  390. package/dist/theme-packs/brutalist/meta.json +1 -1
  391. package/dist/theme-packs/brutalist/pack.css +2 -2
  392. package/dist/theme-packs/eink/meta.json +1 -1
  393. package/dist/theme-packs/eink/pack.css +1 -1
  394. package/dist/theme-packs/futura-editorial/meta.json +1 -1
  395. package/dist/theme-packs/futura-editorial/pack.css +2 -2
  396. package/dist/theme-packs/hearth/meta.json +1 -1
  397. package/dist/theme-packs/hearth/pack.css +2 -2
  398. package/dist/theme-packs/ledger/meta.json +1 -1
  399. package/dist/theme-packs/ledger/pack.css +1 -1
  400. package/dist/theme-packs/manuscript/meta.json +1 -1
  401. package/dist/theme-packs/manuscript/pack.css +1 -1
  402. package/dist/theme-packs/matcha/meta.json +1 -1
  403. package/dist/theme-packs/matcha/pack.css +2 -2
  404. package/dist/theme-packs/nocturne/meta.json +1 -1
  405. package/dist/theme-packs/nocturne/pack.css +2 -2
  406. package/dist/theme-packs/observatory/meta.json +1 -1
  407. package/dist/theme-packs/observatory/pack.css +2 -2
  408. package/dist/theme-packs/onyx/meta.json +1 -1
  409. package/dist/theme-packs/onyx/pack.css +2 -2
  410. package/dist/theme-packs/phosphor/meta.json +1 -1
  411. package/dist/theme-packs/phosphor/pack.css +2 -2
  412. package/dist/theme-packs/riso/meta.json +1 -1
  413. package/dist/theme-packs/riso/pack.css +2 -2
  414. package/dist/theme-packs/sakura/meta.json +1 -1
  415. package/dist/theme-packs/sakura/pack.css +2 -2
  416. package/dist/theme-packs/scandi/meta.json +1 -1
  417. package/dist/theme-packs/scandi/pack.css +1 -1
  418. package/dist/theme-packs/solar/meta.json +1 -1
  419. package/dist/theme-packs/solar/pack.css +1 -1
  420. package/dist/theme-packs/sumi/meta.json +1 -1
  421. package/dist/theme-packs/sumi/pack.css +2 -2
  422. package/dist/theme-packs/swissgrid/meta.json +1 -1
  423. package/dist/theme-packs/swissgrid/pack.css +1 -1
  424. package/dist/theme-packs/timberline/meta.json +1 -1
  425. package/dist/theme-packs/timberline/pack.css +2 -2
  426. package/dist/theme-packs/washi/meta.json +1 -1
  427. package/dist/theme-packs/washi/pack.css +2 -2
  428. package/dist/theme-toggle/index.d.ts +1 -1
  429. package/dist/theme-toggle/index.js +154 -167
  430. package/dist/theme.css +47 -121
  431. package/dist/toc/mobile-toc.d.ts +3 -5
  432. package/dist/toc/mobile-toc.js +29 -27
  433. package/dist/toc/toc.d.ts +3 -4
  434. package/dist/toc/toc.js +18 -18
  435. package/dist/toc/use-active-heading.d.ts +5 -4
  436. package/dist/toc/use-active-heading.js +36 -30
  437. package/dist/toc-prepaint/index.d.ts +1 -2
  438. package/dist/toc-prepaint/index.js +4 -6
  439. package/dist/transitions/nested-island-props-refresh.d.ts +3 -16
  440. package/dist/transitions/nested-island-props-refresh.js +133 -151
  441. package/dist/transitions/page-events.d.ts +8 -13
  442. package/dist/tree-nav-shared/index.d.ts +4 -5
  443. package/dist/tree-nav-shared/index.js +6 -7
  444. package/dist/use-modal-dialog/index.d.ts +9 -63
  445. package/dist/use-modal-dialog/index.js +41 -59
  446. package/dist/versions-page/index.d.ts +3 -3
  447. package/dist/versions-page/index.js +5 -5
  448. package/dist/wind/index.d.ts +5 -0
  449. package/dist/wind/index.js +169 -0
  450. package/dist/wind.json +498 -0
  451. package/dist/z-index-defaults/index.d.ts +4 -4
  452. package/dist/zdtp-loader.d.ts +7 -0
  453. package/dist/zdtp-loader.js +8 -0
  454. package/eject/asset-components/asset-card.tsx +14 -16
  455. package/eject/asset-components/asset-code.tsx +10 -12
  456. package/eject/asset-components/shared.tsx +5 -7
  457. package/eject/breadcrumb/breadcrumb.tsx +15 -16
  458. package/eject/code-group/index.tsx +4 -10
  459. package/eject/content-admonition/index.tsx +5 -6
  460. package/eject/desktop-sidebar-toggle-island/index.ts +4 -0
  461. package/eject/desktop-sidebar-toggle-island/island.tsx +50 -0
  462. package/eject/desktop-sidebar-toggle-island/storage.ts +27 -0
  463. package/eject/details/details.tsx +3 -5
  464. package/eject/doc-history/index.tsx +193 -179
  465. package/eject/doc-pager/index.tsx +3 -4
  466. package/eject/footer/footer.tsx +7 -9
  467. package/eject/header/header.tsx +42 -54
  468. package/eject/header/nav-overflow-script.ts +1 -1
  469. package/eject/header/types.ts +12 -13
  470. package/eject/image-enlarge/index.tsx +84 -69
  471. package/eject/image-enlarge/public.ts +2 -0
  472. package/eject/image-enlarge/ssr-fallback.tsx +7 -0
  473. package/eject/page-loading/page-loading-overlay.tsx +8 -15
  474. package/eject/sidebar/client-data.ts +68 -0
  475. package/eject/sidebar/index.ts +3 -0
  476. package/eject/sidebar/sidebar.tsx +16 -97
  477. package/eject/sidebar/types.ts +15 -0
  478. package/eject/sidebar-toggle-island/index.tsx +103 -102
  479. package/eject/sidebar-tree-island/index.tsx +827 -615
  480. package/eject/sidebar-tree-island/scope-state.ts +154 -0
  481. package/eject/sidebar-tree-island/sidebar-scroll-preserve.ts +8 -2
  482. package/eject/site-tree-nav-island/index.tsx +349 -222
  483. package/eject/tab-item/tab-item.tsx +2 -4
  484. package/eject/theme-toggle/hydration-pending.ts +6 -10
  485. package/eject/theme-toggle/index.tsx +133 -173
  486. package/eject/toc/mobile-toc.tsx +27 -31
  487. package/eject/toc/toc.tsx +21 -24
  488. package/eject/toc/use-active-heading.ts +43 -38
  489. package/package.json +40 -22
  490. package/routes-src/404.tsx +2 -3
  491. package/routes-src/_chrome.tsx +7 -2
  492. package/routes-src/_design-token-panel-bootstrap.tsx +1 -63
  493. package/routes-src/docs-slug.tsx +2 -3
  494. package/routes-src/docs-tags-index.tsx +2 -3
  495. package/routes-src/docs-tags-tag.tsx +2 -3
  496. package/routes-src/docs-versions.tsx +2 -3
  497. package/routes-src/files-path.tsx +2 -4
  498. package/routes-src/index.tsx +2 -3
  499. package/routes-src/locale-docs-slug.tsx +2 -3
  500. package/routes-src/locale-docs-tags-index.tsx +2 -3
  501. package/routes-src/locale-docs-tags-tag.tsx +2 -3
  502. package/routes-src/locale-docs-versions.tsx +2 -3
  503. package/routes-src/locale-files-path.tsx +2 -4
  504. package/routes-src/locale-index.tsx +2 -3
  505. package/routes-src/mcp.tsx +25 -0
  506. package/routes-src/v-docs-slug.tsx +2 -3
  507. package/routes-src/v-locale-docs-slug.tsx +2 -3
  508. package/tsconfig.base.json +1 -1
  509. package/dist/safelist.css +0 -2
  510. package/dist/theme-no-reset.css +0 -379
  511. package/eject/desktop-sidebar-toggle-island/index.tsx +0 -110
@@ -144,7 +144,7 @@ html[data-theme-pack="scandi"] header[data-header] {
144
144
  border-bottom-color: color-mix(in srgb, var(--zd-muted) 26%, transparent);
145
145
  }
146
146
  html[data-theme-pack="scandi"] [data-header-logo] {
147
- font-weight: 800;
147
+ font-weight: var(--zdc-header-logo-weight, 800);
148
148
  letter-spacing: -0.02em;
149
149
  }
150
150
  html[data-theme-pack="scandi"] [data-nav-item] {
@@ -4,7 +4,7 @@
4
4
  "name": "Solar",
5
5
  "description": "Solarized precision — low-eyestrain paper tones, blue/cyan/orange accents, mono labels, technical calm in both modes.",
6
6
  "mode": "light",
7
- "version": "1.0.1",
7
+ "version": "1.0.2",
8
8
  "fonts": {
9
9
  "sans": "Source Sans 3",
10
10
  "mono": "Source Code Pro",
@@ -190,7 +190,7 @@ html[data-theme-pack="solar"] body {
190
190
 
191
191
  /* logo gets the sun glyph in solarized orange */
192
192
  html[data-theme-pack="solar"] [data-header-logo] {
193
- font-weight: 600;
193
+ font-weight: var(--zdc-header-logo-weight, 600);
194
194
  letter-spacing: -0.01em;
195
195
  }
196
196
  html[data-theme-pack="solar"] [data-header-logo]::after {
@@ -4,7 +4,7 @@
4
4
  "name": "Sumi",
5
5
  "description": "Sumi-e ink on washi — bold mincho brush headings, deep black strokes, one vermillion hanko seal accent.",
6
6
  "mode": "light",
7
- "version": "1.0.3",
7
+ "version": "1.0.4",
8
8
  "fonts": {
9
9
  "sans": "Zen Kaku Gothic New",
10
10
  "mono": "IBM Plex Mono",
@@ -253,8 +253,8 @@ html[data-theme-pack="sumi"] header[data-header] {
253
253
  border-bottom: 3px solid var(--zd-fg);
254
254
  }
255
255
  html[data-theme-pack="sumi"] [data-header-logo] {
256
- font-family: var(--font-display);
257
- font-weight: 800;
256
+ font-family: var(--zdc-header-logo-font, var(--font-display));
257
+ font-weight: var(--zdc-header-logo-weight, 800);
258
258
  letter-spacing: 0.02em;
259
259
  }
260
260
  html[data-theme-pack="sumi"] [data-header-logo]::after {
@@ -4,7 +4,7 @@
4
4
  "name": "Swissgrid",
5
5
  "description": "International Typographic Style — grid discipline, black on white, one hot Swiss-red accent, oversized section numbers.",
6
6
  "mode": "light",
7
- "version": "1.0.1",
7
+ "version": "1.0.2",
8
8
  "fonts": {
9
9
  "sans": "Inter",
10
10
  "mono": "IBM Plex Mono",
@@ -204,7 +204,7 @@ html[data-theme-pack="swissgrid"] header[data-header] {
204
204
  border-bottom: 3px solid var(--zd-fg);
205
205
  }
206
206
  html[data-theme-pack="swissgrid"] [data-header-logo] {
207
- font-weight: 900;
207
+ font-weight: var(--zdc-header-logo-weight, 900);
208
208
  letter-spacing: -0.03em;
209
209
  }
210
210
  html[data-theme-pack="swissgrid"] [data-header-logo]::before {
@@ -4,7 +4,7 @@
4
4
  "name": "Timberline",
5
5
  "description": "Forest cabin after dark — pine & umber planks, cream prose, and matte lantern-amber accents; light mode is the same lodge at morning.",
6
6
  "mode": "dark",
7
- "version": "1.0.1",
7
+ "version": "1.0.2",
8
8
  "fonts": {
9
9
  "sans": "Source Sans 3",
10
10
  "mono": "JetBrains Mono",
@@ -212,8 +212,8 @@ html[data-theme-pack="timberline"] header[data-header] {
212
212
  box-shadow: 0 1px 0 0 light-dark(oklch(0.988 0.008 95 / 0.85), oklch(0.87 0.07 80 / 0.13));
213
213
  }
214
214
  html[data-theme-pack="timberline"] [data-header-logo] {
215
- font-family: var(--font-display);
216
- font-weight: 620;
215
+ font-family: var(--zdc-header-logo-font, var(--font-display));
216
+ font-weight: var(--zdc-header-logo-weight, 620);
217
217
  letter-spacing: -0.005em;
218
218
  color: var(--zd-accent);
219
219
  }
@@ -4,7 +4,7 @@
4
4
  "name": "Washi",
5
5
  "description": "Warm washi paper, sumi ink, and ai-iro indigo seals — quiet Japanese stationery for calm documentation.",
6
6
  "mode": "light",
7
- "version": "1.0.3",
7
+ "version": "1.0.4",
8
8
  "fonts": {
9
9
  "sans": "Zen Kaku Gothic New",
10
10
  "mono": "M PLUS 1 Code",
@@ -276,8 +276,8 @@ html[data-theme-pack="washi"] header[data-header] {
276
276
 
277
277
  /* header logo: mincho wordmark with a small square indigo mark */
278
278
  html[data-theme-pack="washi"] [data-header-logo] {
279
- font-family: var(--font-display);
280
- font-weight: 700;
279
+ font-family: var(--zdc-header-logo-font, var(--font-display));
280
+ font-weight: var(--zdc-header-logo-weight, 700);
281
281
  letter-spacing: 0.02em;
282
282
  }
283
283
  html[data-theme-pack="washi"] [data-header-logo]::before {
@@ -13,7 +13,7 @@ export interface ThemeToggleProps {
13
13
  /** Keep activation pending until the first successful mount. @default true */
14
14
  pendingUntilHydrated?: boolean;
15
15
  }
16
- export declare function ThemeToggle({ defaultMode, respectPrefersColorScheme, labels, pendingUntilHydrated, }: ThemeToggleProps): import("preact").JSX.Element;
16
+ export declare function ThemeToggle({ defaultMode, respectPrefersColorScheme, labels, pendingUntilHydrated }: ThemeToggleProps): import("@takazudo/zfb").Description;
17
17
  export declare namespace ThemeToggle {
18
18
  var displayName: string;
19
19
  }
@@ -1,8 +1,7 @@
1
1
  "use client";
2
- import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
3
- import { useState, useEffect, useRef } from "preact/hooks";
4
- import { createPortal } from "preact/compat";
5
- import { useHydrationPending } from "../hydration-pending.js";
2
+ import { Fragment, jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
3
+ import { computed, getScope, Show, signal } from "@takazudo/zfb/zudo-react";
4
+ import { hydrationPending } from "../hydration-pending.js";
6
5
  import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
7
6
  import {
8
7
  applyThemePreference,
@@ -14,23 +13,26 @@ import {
14
13
  const preferences = ["light", "dark", "system"];
15
14
  let menuSequence = 0;
16
15
  function PreferenceIcon({ preference }) {
17
- return /* @__PURE__ */ jsx(
16
+ return /* @__PURE__ */ jsxs(
18
17
  "svg",
19
18
  {
20
19
  "aria-hidden": "true",
21
- xmlns: "http://www.w3.org/2000/svg",
22
20
  width: "20",
23
21
  height: "20",
24
22
  viewBox: "0 0 24 24",
25
23
  fill: "none",
26
24
  stroke: "currentColor",
27
- strokeWidth: "1.2",
28
- strokeLinecap: "square",
29
- strokeLinejoin: "miter",
30
- children: preference === "light" ? /* @__PURE__ */ jsxs(Fragment, { children: [
31
- /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "3.6" }),
32
- /* @__PURE__ */ jsx("path", { d: "M12 2.5V6M12 18V21.5M2.5 12H6M18 12H21.5M5.3 5.3L7.8 7.8M16.2 16.2L18.7 18.7M5.3 18.7L7.8 16.2M16.2 7.8L18.7 5.3" })
33
- ] }) : preference === "dark" ? /* @__PURE__ */ jsx("path", { d: "M10.2 2.9C5.7 3.9 2.6 7.9 3 12.6C3.4 17.7 7.9 21.5 13 21.1C16.9 20.7 20.1 17.9 21 14.1C18.6 15.7 15.6 15.8 13.2 14.3C9.3 12 8 6.8 10.2 2.9Z" }) : /* @__PURE__ */ jsx("path", { d: "M2.5 3.5H21.5V16.5H2.5ZM12 16.5V20.5M7.5 20.5H16.5" })
25
+ "stroke-width": "1.2",
26
+ "stroke-linecap": "square",
27
+ "stroke-linejoin": "miter",
28
+ children: [
29
+ /* @__PURE__ */ jsx(Show, { when: computed(() => preference === "light"), children: () => /* @__PURE__ */ jsxs(Fragment, { children: [
30
+ /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "3.6" }),
31
+ /* @__PURE__ */ jsx("path", { d: "M12 2.5V6M12 18V21.5M2.5 12H6M18 12H21.5M5.3 5.3L7.8 7.8M16.2 16.2L18.7 18.7M5.3 18.7L7.8 16.2M16.2 7.8L18.7 5.3" })
32
+ ] }) }),
33
+ /* @__PURE__ */ jsx(Show, { when: computed(() => preference === "dark"), children: () => /* @__PURE__ */ jsx("path", { d: "M10.2 2.9C5.7 3.9 2.6 7.9 3 12.6C3.4 17.7 7.9 21.5 13 21.1C16.9 20.7 20.1 17.9 21 14.1C18.6 15.7 15.6 15.8 13.2 14.3C9.3 12 8 6.8 10.2 2.9Z" }) }),
34
+ /* @__PURE__ */ jsx(Show, { when: computed(() => preference === "system"), children: () => /* @__PURE__ */ jsx("path", { d: "M2.5 3.5H21.5V16.5H2.5ZM12 16.5V20.5M7.5 20.5H16.5" }) })
35
+ ]
34
36
  }
35
37
  );
36
38
  }
@@ -41,207 +43,192 @@ const englishLabels = {
41
43
  system: "System",
42
44
  systemHelper: "Follows device \xB7 currently {mode}"
43
45
  };
44
- function ThemeToggle({
45
- defaultMode = "dark",
46
- respectPrefersColorScheme = true,
47
- labels = englishLabels,
48
- pendingUntilHydrated = true
49
- }) {
50
- const pending = useHydrationPending(pendingUntilHydrated);
51
- const menuId = useRef("");
52
- const ensureMenuId = () => {
53
- if (!menuId.current) menuId.current = `zd-appearance-${++menuSequence}`;
54
- };
55
- const rootRef = useRef(null);
56
- const menuRef = useRef(null);
57
- const triggerRef = useRef(null);
58
- const itemRefs = useRef([]);
59
- const restoreFocusRef = useRef(false);
60
- const [preference, setPreference] = useState(
61
- respectPrefersColorScheme ? "system" : defaultMode
62
- );
63
- const [resolved, setResolved] = useState(defaultMode);
64
- const [open, setOpen] = useState(false);
65
- const [activeIndex, setActiveIndex] = useState(0);
66
- const [placement, setPlacement] = useState(null);
67
- useEffect(() => {
68
- const sync = () => {
69
- setPreference(readThemePreference(defaultMode, respectPrefersColorScheme));
70
- setResolved(readColorSchemeFromDom(defaultMode));
71
- };
72
- sync();
73
- const unsubscribePreference = subscribeThemePreferenceChanged(() => {
74
- sync();
75
- setOpen(false);
76
- });
77
- const unsubscribeScheme = subscribeColorSchemeChanged(sync);
78
- return () => {
79
- unsubscribePreference();
80
- unsubscribeScheme();
81
- };
82
- }, [defaultMode, respectPrefersColorScheme]);
83
- useEffect(() => {
84
- if (!open) return;
46
+ function AppearanceMenu({ id, labels, preference, resolved, activeIndex, triggerRef, rootRef, close, select, move }) {
47
+ const scope = getScope();
48
+ const menuRef = { current: null };
49
+ const itemRefs = preferences.map(() => ({ current: null }));
50
+ const placement = signal({ visibility: "hidden", left: "0px", top: "0px", right: "auto", bottom: "auto", margin: "0", width: "260px", "max-height": "none" });
51
+ scope.onActivate(() => {
85
52
  const menu = menuRef.current;
86
- menu?.showPopover?.();
53
+ if (!menu) return;
54
+ menu.showPopover?.();
87
55
  const position = () => {
88
56
  const rect = triggerRef.current?.getBoundingClientRect();
89
57
  if (!rect) return;
90
58
  const gap = 8;
91
- const width = Math.min(260, window.innerWidth - gap * 2);
92
- const desiredHeight = menu?.scrollHeight ?? 280;
59
+ const width = Math.max(0, Math.min(260, window.innerWidth - gap * 2));
60
+ const desiredHeight = menu.scrollHeight || 280;
93
61
  const roomBelow = window.innerHeight - rect.bottom - gap * 2;
94
62
  const roomAbove = rect.top - gap * 2;
95
63
  const above = roomBelow < desiredHeight && roomAbove > roomBelow;
96
64
  const maxHeight = Math.max(80, Math.min(desiredHeight, above ? roomAbove : roomBelow));
97
- setPlacement({
98
- left: Math.max(gap, Math.min(rect.right - width, window.innerWidth - width - gap)),
99
- top: above ? Math.max(gap, rect.top - gap - maxHeight) : rect.bottom + gap,
100
- width,
101
- maxHeight
102
- });
65
+ const left = Math.max(gap, Math.min(rect.right - width, window.innerWidth - width - gap));
66
+ const top = above ? Math.max(gap, rect.top - gap - maxHeight) : rect.bottom + gap;
67
+ placement.value = { visibility: "visible", left: `${left}px`, top: `${top}px`, right: "auto", bottom: "auto", margin: "0", width: `${width}px`, "max-height": `${maxHeight}px` };
103
68
  };
104
69
  const onPointerDown = (event) => {
105
- if (!rootRef.current?.contains(event.target) && !menuRef.current?.contains(event.target)) setOpen(false);
70
+ if (!rootRef.current?.contains(event.target) && !menu.contains(event.target)) close();
106
71
  };
107
- const onNavigate = () => setOpen(false);
72
+ const onNavigate = () => close();
108
73
  position();
74
+ const focusFrame = requestAnimationFrame(() => {
75
+ if (!scope.abortSignal.aborted) itemRefs[activeIndex.value]?.current?.focus();
76
+ });
109
77
  document.addEventListener("pointerdown", onPointerDown);
110
78
  window.addEventListener("resize", position);
111
79
  window.addEventListener("scroll", position, true);
112
80
  document.addEventListener(AFTER_NAVIGATE_EVENT, onNavigate);
113
81
  return () => {
114
- if (menu?.hidePopover && menu.matches(":popover-open")) menu.hidePopover();
82
+ cancelAnimationFrame(focusFrame);
83
+ if (menu.hidePopover && menu.matches(":popover-open")) menu.hidePopover();
115
84
  document.removeEventListener("pointerdown", onPointerDown);
116
85
  window.removeEventListener("resize", position);
117
86
  window.removeEventListener("scroll", position, true);
118
87
  document.removeEventListener(AFTER_NAVIGATE_EVENT, onNavigate);
119
88
  };
120
- }, [open]);
121
- useEffect(() => {
122
- if (open && placement) itemRefs.current[activeIndex]?.focus();
123
- }, [open, placement]);
124
- useEffect(() => {
125
- if (open || !restoreFocusRef.current) return;
126
- restoreFocusRef.current = false;
127
- requestAnimationFrame(() => triggerRef.current?.focus());
128
- }, [open]);
89
+ });
90
+ const onMenuKeyDown = (event) => {
91
+ const keyboard = event;
92
+ if (keyboard.isComposing) return;
93
+ if (keyboard.key === "Escape") {
94
+ keyboard.preventDefault();
95
+ keyboard.stopPropagation();
96
+ close(true);
97
+ } else if (keyboard.key === "Tab") {
98
+ window.setTimeout(() => close(), 0);
99
+ } else if (keyboard.key === "ArrowDown" || keyboard.key === "ArrowUp" || keyboard.key === "Home" || keyboard.key === "End") {
100
+ keyboard.preventDefault();
101
+ const next = keyboard.key === "Home" ? 0 : keyboard.key === "End" ? 2 : activeIndex.value + (keyboard.key === "ArrowDown" ? 1 : -1);
102
+ move(next);
103
+ itemRefs[(next + preferences.length) % preferences.length]?.current?.focus();
104
+ }
105
+ };
106
+ return /* @__PURE__ */ jsxs(
107
+ "div",
108
+ {
109
+ ref: menuRef,
110
+ id,
111
+ role: "menu",
112
+ "aria-label": labels.appearance,
113
+ "on:keydown": onMenuKeyDown,
114
+ class: "fixed z-tooltip overflow-y-auto rounded-lg border border-muted bg-surface p-hsp-xs text-fg shadow-lg",
115
+ style: placement,
116
+ popover: "manual",
117
+ children: [
118
+ /* @__PURE__ */ jsx("div", { class: "px-hsp-sm py-vsp-xs text-small font-semibold", "aria-hidden": "true", children: labels.appearance }),
119
+ preferences.map((option, index) => /* @__PURE__ */ jsxs(
120
+ "button",
121
+ {
122
+ ref: itemRefs[index],
123
+ type: "button",
124
+ role: "menuitemradio",
125
+ "aria-checked": computed(() => preference.value === option),
126
+ "on:focus": () => move(index),
127
+ "on:click": () => select(option),
128
+ class: computed(() => `flex min-h-[44px] w-full items-center gap-hsp-sm rounded px-hsp-sm text-left text-small ${preference.value === option ? "bg-accent/10" : ""} hover:bg-accent/10 focus-visible:bg-accent/10 focus-visible:outline-2 focus-visible:outline-accent`),
129
+ children: [
130
+ /* @__PURE__ */ jsx(PreferenceIcon, { preference: option }),
131
+ /* @__PURE__ */ jsx("span", { class: "flex-1", children: labels[option] }),
132
+ /* @__PURE__ */ jsx("span", { "aria-hidden": "true", class: "text-accent", children: computed(() => preference.value === option ? "\u2713" : "") })
133
+ ]
134
+ }
135
+ )),
136
+ /* @__PURE__ */ jsx("div", { class: "px-hsp-sm py-vsp-xs text-small text-muted", children: computed(() => labels.systemHelper.replace("{mode}", labels[resolved.value])) })
137
+ ]
138
+ }
139
+ );
140
+ }
141
+ function ThemeToggle({ defaultMode = "dark", respectPrefersColorScheme = true, labels = englishLabels, pendingUntilHydrated = true }) {
142
+ const scope = getScope();
143
+ const pending = hydrationPending(scope, pendingUntilHydrated);
144
+ const rootRef = { current: null };
145
+ const triggerRef = { current: null };
146
+ const preference = signal(respectPrefersColorScheme ? "system" : defaultMode);
147
+ const resolved = signal(defaultMode);
148
+ const open = signal(false);
149
+ const activeIndex = signal(0);
150
+ let menuId = "";
151
+ const ensureMenuId = () => {
152
+ if (!menuId) menuId = `zd-appearance-${++menuSequence}`;
153
+ };
154
+ scope.onActivate(() => {
155
+ const sync = () => {
156
+ preference.value = readThemePreference(defaultMode, respectPrefersColorScheme);
157
+ resolved.value = readColorSchemeFromDom(defaultMode);
158
+ };
159
+ sync();
160
+ const unsubscribePreference = subscribeThemePreferenceChanged(() => {
161
+ sync();
162
+ open.value = false;
163
+ });
164
+ const unsubscribeScheme = subscribeColorSchemeChanged(sync);
165
+ return () => {
166
+ unsubscribePreference();
167
+ unsubscribeScheme();
168
+ };
169
+ });
129
170
  const close = (restoreFocus = false) => {
130
- restoreFocusRef.current = restoreFocus;
131
- setOpen(false);
171
+ open.value = false;
172
+ if (restoreFocus) requestAnimationFrame(() => {
173
+ if (!scope.abortSignal.aborted && !open.value) triggerRef.current?.focus();
174
+ });
132
175
  };
133
176
  const select = (next) => {
134
177
  close(true);
135
178
  applyThemePreference(next);
136
- setPreference(next);
137
- setResolved(readColorSchemeFromDom(defaultMode));
179
+ preference.value = next;
180
+ resolved.value = readColorSchemeFromDom(defaultMode);
138
181
  };
139
182
  const move = (index) => {
140
- const next = (index + preferences.length) % preferences.length;
141
- setActiveIndex(next);
142
- itemRefs.current[next]?.focus();
183
+ activeIndex.value = (index + preferences.length) % preferences.length;
143
184
  };
144
- const onMenuKeyDown = (event) => {
145
- if (event.key === "Escape") {
146
- event.preventDefault();
147
- event.stopPropagation();
148
- close(true);
149
- } else if (event.key === "Tab") {
150
- window.setTimeout(() => close(), 0);
151
- } else if (event.key === "ArrowDown") {
152
- event.preventDefault();
153
- move(activeIndex + 1);
154
- } else if (event.key === "ArrowUp") {
155
- event.preventDefault();
156
- move(activeIndex - 1);
157
- } else if (event.key === "Home") {
158
- event.preventDefault();
159
- move(0);
160
- } else if (event.key === "End") {
161
- event.preventDefault();
162
- move(2);
163
- }
185
+ const show = (index) => {
186
+ ensureMenuId();
187
+ move(index);
188
+ open.value = true;
164
189
  };
165
- return /* @__PURE__ */ jsxs("div", { ref: rootRef, className: "relative inline-flex", "data-zd-theme-menu": "", children: [
166
- /* @__PURE__ */ jsx(
190
+ return /* @__PURE__ */ jsxs("div", { ref: rootRef, class: "relative inline-flex", "data-zd-theme-menu": "", children: [
191
+ /* @__PURE__ */ jsxs(
167
192
  "button",
168
193
  {
169
194
  ref: triggerRef,
170
195
  type: "button",
171
196
  "aria-haspopup": "menu",
172
197
  "aria-expanded": open,
173
- "aria-controls": open ? menuId.current : void 0,
174
- "aria-label": `${labels.appearance}: ${labels[preference]}`,
175
- "aria-disabled": pending ? "true" : void 0,
176
- "data-zd-pending": pending ? "" : void 0,
177
- onClick: () => {
178
- if (pending) return;
179
- if (open) close(true);
180
- else {
181
- setPlacement(null);
182
- ensureMenuId();
183
- setActiveIndex(preferences.indexOf(preference));
184
- setOpen(true);
185
- }
198
+ "aria-controls": computed(() => open.value ? menuId : void 0),
199
+ "aria-label": computed(() => `${labels.appearance}: ${labels[preference.value]}`),
200
+ "aria-disabled": computed(() => pending.value ? "true" : void 0),
201
+ "data-zd-pending": computed(() => pending.value ? "" : void 0),
202
+ "on:click": () => {
203
+ if (pending.value) return;
204
+ if (open.value) close(true);
205
+ else show(preferences.indexOf(preference.value));
186
206
  },
187
- onKeyDown: (event) => {
188
- if (pending) {
189
- if (event.key === "Enter" || event.key === " ") event.preventDefault();
207
+ "on:keydown": (event) => {
208
+ const keyboard = event;
209
+ if (keyboard.isComposing) return;
210
+ if (pending.value) {
211
+ if (keyboard.key === "Enter" || keyboard.key === " ") keyboard.preventDefault();
190
212
  return;
191
213
  }
192
- if (event.key === "ArrowDown" || event.key === "ArrowUp") {
193
- event.preventDefault();
194
- setPlacement(null);
195
- ensureMenuId();
196
- setActiveIndex(event.key === "ArrowDown" ? 0 : 2);
197
- setOpen(true);
198
- } else if (event.key === "Escape" && open) {
199
- event.preventDefault();
200
- event.stopPropagation();
214
+ if (keyboard.key === "ArrowDown" || keyboard.key === "ArrowUp") {
215
+ keyboard.preventDefault();
216
+ show(keyboard.key === "ArrowDown" ? 0 : 2);
217
+ } else if (keyboard.key === "Escape" && open.value) {
218
+ keyboard.preventDefault();
219
+ keyboard.stopPropagation();
201
220
  close(true);
202
221
  }
203
222
  },
204
- className: "inline-flex h-[40px] w-[40px] shrink-0 items-center justify-center text-muted hover:text-fg focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2",
205
- children: /* @__PURE__ */ jsx(PreferenceIcon, { preference })
206
- }
207
- ),
208
- open && createPortal(/* @__PURE__ */ jsxs(
209
- "div",
210
- {
211
- ref: menuRef,
212
- id: menuId.current,
213
- role: "menu",
214
- "aria-label": labels.appearance,
215
- popover: typeof HTMLElement !== "undefined" && "showPopover" in HTMLElement.prototype ? "manual" : void 0,
216
- onKeyDown: onMenuKeyDown,
217
- className: "fixed z-tooltip overflow-y-auto rounded-lg border border-muted bg-surface p-hsp-xs text-fg shadow-lg",
218
- style: placement ? { left: placement.left, top: placement.top, right: "auto", bottom: "auto", margin: 0, width: placement.width, maxHeight: placement.maxHeight } : { visibility: "hidden", left: 0, top: 0, right: "auto", bottom: "auto", margin: 0, width: Math.min(260, window.innerWidth - 16) },
223
+ class: "inline-flex h-[40px] w-[40px] shrink-0 items-center justify-center text-muted hover:text-fg focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2",
219
224
  children: [
220
- /* @__PURE__ */ jsx("div", { className: "px-hsp-sm py-vsp-xs text-small font-semibold", "aria-hidden": "true", children: labels.appearance }),
221
- preferences.map((option, index) => /* @__PURE__ */ jsxs(
222
- "button",
223
- {
224
- ref: (node) => {
225
- itemRefs.current[index] = node;
226
- },
227
- type: "button",
228
- role: "menuitemradio",
229
- "aria-checked": preference === option,
230
- onFocus: () => setActiveIndex(index),
231
- onClick: () => select(option),
232
- className: `flex min-h-[44px] w-full items-center gap-hsp-sm rounded px-hsp-sm text-left text-small ${preference === option ? "bg-accent/10" : ""} hover:bg-accent/10 focus-visible:bg-accent/10 focus-visible:outline-2 focus-visible:outline-accent`,
233
- children: [
234
- /* @__PURE__ */ jsx(PreferenceIcon, { preference: option }),
235
- /* @__PURE__ */ jsx("span", { className: "flex-1", children: labels[option] }),
236
- /* @__PURE__ */ jsx("span", { "aria-hidden": "true", className: "text-accent", children: preference === option ? "\u2713" : "" })
237
- ]
238
- },
239
- option
240
- )),
241
- /* @__PURE__ */ jsx("div", { className: "px-hsp-sm py-vsp-xs text-small text-muted", children: labels.systemHelper.replace("{mode}", labels[resolved]) })
225
+ /* @__PURE__ */ jsx(Show, { when: computed(() => preference.value === "light"), children: () => /* @__PURE__ */ jsx(PreferenceIcon, { preference: "light" }) }),
226
+ /* @__PURE__ */ jsx(Show, { when: computed(() => preference.value === "dark"), children: () => /* @__PURE__ */ jsx(PreferenceIcon, { preference: "dark" }) }),
227
+ /* @__PURE__ */ jsx(Show, { when: computed(() => preference.value === "system"), children: () => /* @__PURE__ */ jsx(PreferenceIcon, { preference: "system" }) })
242
228
  ]
243
229
  }
244
- ), document.body)
230
+ ),
231
+ /* @__PURE__ */ jsx(Show, { when: open, children: () => /* @__PURE__ */ jsx(AppearanceMenu, { id: menuId, labels, preference, resolved, activeIndex, triggerRef, rootRef, close, select, move }) })
245
232
  ] });
246
233
  }
247
234
  ThemeToggle.displayName = "ThemeToggle";