spacefn-docs 0.0.0-stage → 0.11.0

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 (366) hide show
  1. package/LICENSE +200 -0
  2. package/README.md +15 -2
  3. package/assets/reader.css +1131 -0
  4. package/assets/reader.js +324 -0
  5. package/content/1-getting-started.md +107 -0
  6. package/content/2-conventions.md +138 -0
  7. package/content/3-best-practices.md +68 -0
  8. package/content/4-folders/1-app/1-entry.md +48 -0
  9. package/content/4-folders/1-app/2-routes.md +92 -0
  10. package/content/4-folders/1-app/3-db.md +81 -0
  11. package/content/4-folders/1-app/4-queues.md +46 -0
  12. package/content/4-folders/1-app/5-crons.md +30 -0
  13. package/content/4-folders/1-app/6-assets.md +53 -0
  14. package/content/4-folders/1-app/7-durable-objects.md +60 -0
  15. package/content/4-folders/1-app/8-workflows.md +46 -0
  16. package/content/4-folders/1-app/index.md +43 -0
  17. package/content/4-folders/2-modules.md +71 -0
  18. package/content/4-folders/3-lib.md +60 -0
  19. package/content/4-folders/4-public.md +24 -0
  20. package/content/4-folders/5-docs.md +23 -0
  21. package/content/4-folders/6-configs.md +57 -0
  22. package/content/4-folders/7-space.md +34 -0
  23. package/content/4-folders/8-env.md +34 -0
  24. package/content/4-folders/9-package-json.md +37 -0
  25. package/content/4-folders/index.md +50 -0
  26. package/content/5-deployment/1-cloudflare.md +56 -0
  27. package/content/5-deployment/2-bun.md +68 -0
  28. package/content/5-deployment/3-infrastructure.md +67 -0
  29. package/content/5-deployment/4-ci-cd.md +131 -0
  30. package/content/5-deployment/index.md +48 -0
  31. package/content/6-guides/1-entry.md +113 -0
  32. package/content/6-guides/2-routes.md +162 -0
  33. package/content/6-guides/3-pages.md +148 -0
  34. package/content/6-guides/4-frontend.md +232 -0
  35. package/content/6-guides/5-database.md +178 -0
  36. package/content/6-guides/6-services.md +125 -0
  37. package/content/6-guides/7-jobs.md +61 -0
  38. package/content/6-guides/8-auth.md +111 -0
  39. package/content/6-guides/9-testing.md +70 -0
  40. package/content/6-guides/index.md +21 -0
  41. package/content/7-reference/1-config.md +67 -0
  42. package/content/7-reference/2-cli.md +27 -0
  43. package/content/7-reference/3-writing-docs.md +206 -0
  44. package/content/7-reference/index.md +15 -0
  45. package/content/index.md +49 -0
  46. package/content/logo.svg +12 -0
  47. package/dist/index.d.mts +72 -0
  48. package/dist/index.mjs +713 -0
  49. package/examples/README.md +18 -0
  50. package/examples/datastar/.env.example +2 -0
  51. package/examples/datastar/README.md +17 -0
  52. package/examples/datastar/app/assets/main.ts +4 -0
  53. package/examples/datastar/app/assets/site.css +3 -0
  54. package/examples/datastar/app/db/main/config.json +5 -0
  55. package/examples/datastar/app/db/main/migrations/0001_votes.sql +8 -0
  56. package/examples/datastar/app/db/main/queries/add-vote.sql +3 -0
  57. package/examples/datastar/app/db/main/queries/tally.sql +1 -0
  58. package/examples/datastar/app/entry.ts +28 -0
  59. package/examples/datastar/app/routes/_middleware.ts +4 -0
  60. package/examples/datastar/app/routes/health.ts +7 -0
  61. package/examples/datastar/app/routes/index.ts +43 -0
  62. package/examples/datastar/configs/env.ts +6 -0
  63. package/examples/datastar/configs/infra.ts +85 -0
  64. package/examples/datastar/configs/tsconfig.json +15 -0
  65. package/examples/datastar/configs/vite.ts +4 -0
  66. package/examples/datastar/configs/vitest.ts +9 -0
  67. package/examples/datastar/lib/types/rocket.d.ts +30 -0
  68. package/examples/datastar/lib/ui/base.css +17 -0
  69. package/examples/datastar/lib/ui/layout.ts +27 -0
  70. package/examples/datastar/modules/poll/client/poll-meter.ts +39 -0
  71. package/examples/datastar/modules/poll/poll.css +13 -0
  72. package/examples/datastar/modules/poll/poll.test.ts +48 -0
  73. package/examples/datastar/modules/poll/poll.ts +62 -0
  74. package/examples/datastar/modules/poll/views.ts +52 -0
  75. package/examples/datastar/package.json +33 -0
  76. package/examples/datastar/tsconfig.json +4 -0
  77. package/examples/lightningcss/.env.example +1 -0
  78. package/examples/lightningcss/README.md +15 -0
  79. package/examples/lightningcss/app/assets/site.css +3 -0
  80. package/examples/lightningcss/app/entry.ts +28 -0
  81. package/examples/lightningcss/app/routes/_middleware.ts +4 -0
  82. package/examples/lightningcss/app/routes/health.ts +7 -0
  83. package/examples/lightningcss/app/routes/index.ts +12 -0
  84. package/examples/lightningcss/configs/Dockerfile +26 -0
  85. package/examples/lightningcss/configs/Dockerfile.dockerignore +9 -0
  86. package/examples/lightningcss/configs/env.ts +4 -0
  87. package/examples/lightningcss/configs/infra.ts +55 -0
  88. package/examples/lightningcss/configs/tsconfig.json +15 -0
  89. package/examples/lightningcss/configs/vite.ts +19 -0
  90. package/examples/lightningcss/configs/vitest.ts +9 -0
  91. package/examples/lightningcss/lib/ui/layout.ts +17 -0
  92. package/examples/lightningcss/lib/ui/tokens.css +23 -0
  93. package/examples/lightningcss/modules/releases/releases.css +20 -0
  94. package/examples/lightningcss/modules/releases/releases.test.ts +18 -0
  95. package/examples/lightningcss/modules/releases/releases.ts +21 -0
  96. package/examples/lightningcss/modules/releases/views.ts +25 -0
  97. package/examples/lightningcss/package.json +33 -0
  98. package/examples/lightningcss/tsconfig.json +4 -0
  99. package/examples/mini-shopify/.env.example +6 -0
  100. package/examples/mini-shopify/README.md +19 -0
  101. package/examples/mini-shopify/app/assets/site.css +2 -0
  102. package/examples/mini-shopify/app/db/platform/config.json +5 -0
  103. package/examples/mini-shopify/app/db/platform/migrations/0001_shops.sql +10 -0
  104. package/examples/mini-shopify/app/db/platform/queries/add-shop.sql +4 -0
  105. package/examples/mini-shopify/app/db/platform/queries/find-shop.sql +3 -0
  106. package/examples/mini-shopify/app/db/platform/queries/list-shops.sql +1 -0
  107. package/examples/mini-shopify/app/db/shop/config.json +6 -0
  108. package/examples/mini-shopify/app/db/shop/migrations/0001_products.sql +11 -0
  109. package/examples/mini-shopify/app/db/shop/queries/add-product.sql +4 -0
  110. package/examples/mini-shopify/app/db/shop/queries/list-products.sql +1 -0
  111. package/examples/mini-shopify/app/db/shop/queries/sell-product.sql +2 -0
  112. package/examples/mini-shopify/app/entry.ts +25 -0
  113. package/examples/mini-shopify/app/routes/_middleware.ts +4 -0
  114. package/examples/mini-shopify/app/routes/health.ts +7 -0
  115. package/examples/mini-shopify/app/routes/index.ts +26 -0
  116. package/examples/mini-shopify/app/routes/s/[shop]/_middleware.ts +6 -0
  117. package/examples/mini-shopify/app/routes/s/[shop]/index.ts +32 -0
  118. package/examples/mini-shopify/configs/Dockerfile +26 -0
  119. package/examples/mini-shopify/configs/Dockerfile.dockerignore +9 -0
  120. package/examples/mini-shopify/configs/env.ts +14 -0
  121. package/examples/mini-shopify/configs/infra.ts +55 -0
  122. package/examples/mini-shopify/configs/tsconfig.json +15 -0
  123. package/examples/mini-shopify/configs/vite.ts +4 -0
  124. package/examples/mini-shopify/configs/vitest.ts +9 -0
  125. package/examples/mini-shopify/lib/ui/base.css +19 -0
  126. package/examples/mini-shopify/lib/ui/layout.ts +17 -0
  127. package/examples/mini-shopify/modules/catalog/catalog.ts +31 -0
  128. package/examples/mini-shopify/modules/catalog/views.ts +39 -0
  129. package/examples/mini-shopify/modules/shops/host.test.ts +38 -0
  130. package/examples/mini-shopify/modules/shops/host.ts +73 -0
  131. package/examples/mini-shopify/modules/shops/shops.test.ts +63 -0
  132. package/examples/mini-shopify/modules/shops/shops.ts +64 -0
  133. package/examples/mini-shopify/modules/shops/views.ts +28 -0
  134. package/examples/mini-shopify/package.json +35 -0
  135. package/examples/mini-shopify/tsconfig.json +4 -0
  136. package/examples/react/.env.example +2 -0
  137. package/examples/react/README.md +18 -0
  138. package/examples/react/app/assets/site.css +3 -0
  139. package/examples/react/app/entry.ts +28 -0
  140. package/examples/react/app/routes/_middleware.ts +4 -0
  141. package/examples/react/app/routes/about.ts +10 -0
  142. package/examples/react/app/routes/health.ts +7 -0
  143. package/examples/react/app/routes/index.ts +12 -0
  144. package/examples/react/configs/Dockerfile +26 -0
  145. package/examples/react/configs/Dockerfile.dockerignore +9 -0
  146. package/examples/react/configs/env.ts +6 -0
  147. package/examples/react/configs/infra.ts +55 -0
  148. package/examples/react/configs/tsconfig.json +16 -0
  149. package/examples/react/configs/vite.ts +7 -0
  150. package/examples/react/configs/vitest.ts +9 -0
  151. package/examples/react/lib/ui/base.css +12 -0
  152. package/examples/react/lib/ui/layout.ts +18 -0
  153. package/examples/react/modules/about/views.ts +8 -0
  154. package/examples/react/modules/shop/products.ts +18 -0
  155. package/examples/react/modules/shop/shop.css +13 -0
  156. package/examples/react/modules/shop/shop.test.ts +28 -0
  157. package/examples/react/modules/shop/shop.ts +13 -0
  158. package/examples/react/modules/shop/ui/Cart.island.tsx +31 -0
  159. package/examples/react/modules/shop/views.ts +16 -0
  160. package/examples/react/package.json +38 -0
  161. package/examples/react/tsconfig.json +4 -0
  162. package/examples/services-bun/README.md +10 -0
  163. package/examples/services-bun/app/assets/main.ts +4 -0
  164. package/examples/services-bun/app/assets/style.css +1 -0
  165. package/examples/services-bun/app/crons/nightly.ts +5 -0
  166. package/examples/services-bun/app/entry.ts +9 -0
  167. package/examples/services-bun/app/queues/jobs.ts +5 -0
  168. package/examples/services-bun/app/routes/index.ts +10 -0
  169. package/examples/services-bun/app/routes/runtime.ts +5 -0
  170. package/examples/services-bun/app/routes/send.ts +8 -0
  171. package/examples/services-bun/app/routes/version.ts +5 -0
  172. package/examples/services-bun/configs/Dockerfile +10 -0
  173. package/examples/services-bun/configs/Dockerfile.dockerignore +4 -0
  174. package/examples/services-bun/configs/infra.ts +28 -0
  175. package/examples/services-bun/configs/tsconfig.json +15 -0
  176. package/examples/services-bun/configs/vite.ts +4 -0
  177. package/examples/services-bun/lib/ui/base.css +3 -0
  178. package/examples/services-bun/lib/ui/layout.ts +13 -0
  179. package/examples/services-bun/modules/status/client/ready.ts +4 -0
  180. package/examples/services-bun/modules/status/status.ts +20 -0
  181. package/examples/services-bun/modules/status/views.ts +4 -0
  182. package/examples/services-bun/package.json +30 -0
  183. package/examples/services-bun/public/robots.txt +1 -0
  184. package/examples/services-bun/tsconfig.json +4 -0
  185. package/examples/services-cloudflare/README.md +9 -0
  186. package/examples/services-cloudflare/app/assets/main.ts +4 -0
  187. package/examples/services-cloudflare/app/crons/nightly.ts +5 -0
  188. package/examples/services-cloudflare/app/db/main/config.json +4 -0
  189. package/examples/services-cloudflare/app/db/main/migrations/0001_notes.sql +2 -0
  190. package/examples/services-cloudflare/app/db/main/queries/add-note.sql +1 -0
  191. package/examples/services-cloudflare/app/db/main/queries/count-notes.sql +3 -0
  192. package/examples/services-cloudflare/app/entry.ts +10 -0
  193. package/examples/services-cloudflare/app/queues/jobs.ts +5 -0
  194. package/examples/services-cloudflare/app/routes/files.ts +5 -0
  195. package/examples/services-cloudflare/app/routes/index.ts +10 -0
  196. package/examples/services-cloudflare/app/routes/limited.ts +7 -0
  197. package/examples/services-cloudflare/app/routes/send.ts +8 -0
  198. package/examples/services-cloudflare/configs/env.ts +3 -0
  199. package/examples/services-cloudflare/configs/infra.ts +85 -0
  200. package/examples/services-cloudflare/configs/tsconfig.json +15 -0
  201. package/examples/services-cloudflare/configs/vite.ts +4 -0
  202. package/examples/services-cloudflare/lib/ui/layout.ts +12 -0
  203. package/examples/services-cloudflare/modules/files/files.ts +9 -0
  204. package/examples/services-cloudflare/modules/status/client/ready.ts +4 -0
  205. package/examples/services-cloudflare/modules/status/status.ts +27 -0
  206. package/examples/services-cloudflare/modules/status/views.ts +8 -0
  207. package/examples/services-cloudflare/package.json +30 -0
  208. package/examples/services-cloudflare/public/robots.txt +1 -0
  209. package/examples/services-cloudflare/tsconfig.json +4 -0
  210. package/examples/solid/.env.example +2 -0
  211. package/examples/solid/README.md +18 -0
  212. package/examples/solid/app/assets/site.css +3 -0
  213. package/examples/solid/app/entry.ts +28 -0
  214. package/examples/solid/app/routes/_middleware.ts +4 -0
  215. package/examples/solid/app/routes/about.ts +10 -0
  216. package/examples/solid/app/routes/health.ts +7 -0
  217. package/examples/solid/app/routes/index.ts +12 -0
  218. package/examples/solid/configs/Dockerfile +26 -0
  219. package/examples/solid/configs/Dockerfile.dockerignore +9 -0
  220. package/examples/solid/configs/env.ts +6 -0
  221. package/examples/solid/configs/infra.ts +55 -0
  222. package/examples/solid/configs/tsconfig.json +17 -0
  223. package/examples/solid/configs/vite.ts +7 -0
  224. package/examples/solid/configs/vitest.ts +12 -0
  225. package/examples/solid/lib/ui/base.css +12 -0
  226. package/examples/solid/lib/ui/layout.ts +18 -0
  227. package/examples/solid/modules/about/views.ts +8 -0
  228. package/examples/solid/modules/shop/products.ts +18 -0
  229. package/examples/solid/modules/shop/shop.css +13 -0
  230. package/examples/solid/modules/shop/shop.test.ts +28 -0
  231. package/examples/solid/modules/shop/shop.ts +13 -0
  232. package/examples/solid/modules/shop/ui/Cart.island.tsx +31 -0
  233. package/examples/solid/modules/shop/views.ts +16 -0
  234. package/examples/solid/package.json +35 -0
  235. package/examples/solid/tsconfig.json +4 -0
  236. package/examples/starter-bun/.env.example +2 -0
  237. package/examples/starter-bun/AGENTS.md +9 -0
  238. package/examples/starter-bun/README.md +47 -0
  239. package/examples/starter-bun/app/assets/site.css +3 -0
  240. package/examples/starter-bun/app/db/main/config.json +5 -0
  241. package/examples/starter-bun/app/db/main/migrations/0001_todos.sql +9 -0
  242. package/examples/starter-bun/app/db/main/queries/add-todo.sql +2 -0
  243. package/examples/starter-bun/app/db/main/queries/list-todos.sql +2 -0
  244. package/examples/starter-bun/app/db/main/queries/toggle-todo.sql +2 -0
  245. package/examples/starter-bun/app/entry.ts +28 -0
  246. package/examples/starter-bun/app/routes/_middleware.ts +4 -0
  247. package/examples/starter-bun/app/routes/health.ts +7 -0
  248. package/examples/starter-bun/app/routes/index.ts +44 -0
  249. package/examples/starter-bun/configs/Dockerfile +26 -0
  250. package/examples/starter-bun/configs/Dockerfile.dockerignore +9 -0
  251. package/examples/starter-bun/configs/env.ts +6 -0
  252. package/examples/starter-bun/configs/infra.ts +55 -0
  253. package/examples/starter-bun/configs/tsconfig.json +15 -0
  254. package/examples/starter-bun/configs/vite.ts +4 -0
  255. package/examples/starter-bun/configs/vitest.ts +9 -0
  256. package/examples/starter-bun/docs/index.md +5 -0
  257. package/examples/starter-bun/lib/ui/base.css +17 -0
  258. package/examples/starter-bun/lib/ui/layout.ts +22 -0
  259. package/examples/starter-bun/modules/todos/todos.css +16 -0
  260. package/examples/starter-bun/modules/todos/todos.test.ts +33 -0
  261. package/examples/starter-bun/modules/todos/todos.ts +31 -0
  262. package/examples/starter-bun/modules/todos/views.ts +38 -0
  263. package/examples/starter-bun/package.json +32 -0
  264. package/examples/starter-bun/public/favicon.svg +1 -0
  265. package/examples/starter-bun/tsconfig.json +4 -0
  266. package/examples/starter-cloudflare/.env.example +2 -0
  267. package/examples/starter-cloudflare/AGENTS.md +9 -0
  268. package/examples/starter-cloudflare/README.md +47 -0
  269. package/examples/starter-cloudflare/app/assets/site.css +3 -0
  270. package/examples/starter-cloudflare/app/db/main/config.json +5 -0
  271. package/examples/starter-cloudflare/app/db/main/migrations/0001_todos.sql +9 -0
  272. package/examples/starter-cloudflare/app/db/main/queries/add-todo.sql +2 -0
  273. package/examples/starter-cloudflare/app/db/main/queries/list-todos.sql +2 -0
  274. package/examples/starter-cloudflare/app/db/main/queries/toggle-todo.sql +2 -0
  275. package/examples/starter-cloudflare/app/entry.ts +28 -0
  276. package/examples/starter-cloudflare/app/routes/_middleware.ts +4 -0
  277. package/examples/starter-cloudflare/app/routes/health.ts +7 -0
  278. package/examples/starter-cloudflare/app/routes/index.ts +44 -0
  279. package/examples/starter-cloudflare/configs/env.ts +6 -0
  280. package/examples/starter-cloudflare/configs/infra.ts +85 -0
  281. package/examples/starter-cloudflare/configs/tsconfig.json +15 -0
  282. package/examples/starter-cloudflare/configs/vite.ts +4 -0
  283. package/examples/starter-cloudflare/configs/vitest.ts +9 -0
  284. package/examples/starter-cloudflare/docs/index.md +5 -0
  285. package/examples/starter-cloudflare/lib/ui/base.css +17 -0
  286. package/examples/starter-cloudflare/lib/ui/layout.ts +22 -0
  287. package/examples/starter-cloudflare/modules/todos/todos.css +16 -0
  288. package/examples/starter-cloudflare/modules/todos/todos.test.ts +33 -0
  289. package/examples/starter-cloudflare/modules/todos/todos.ts +31 -0
  290. package/examples/starter-cloudflare/modules/todos/views.ts +38 -0
  291. package/examples/starter-cloudflare/package.json +32 -0
  292. package/examples/starter-cloudflare/public/favicon.svg +1 -0
  293. package/examples/starter-cloudflare/tsconfig.json +4 -0
  294. package/examples/svelte/.env.example +2 -0
  295. package/examples/svelte/README.md +18 -0
  296. package/examples/svelte/app/assets/site.css +3 -0
  297. package/examples/svelte/app/entry.ts +28 -0
  298. package/examples/svelte/app/routes/_middleware.ts +4 -0
  299. package/examples/svelte/app/routes/about.ts +10 -0
  300. package/examples/svelte/app/routes/health.ts +7 -0
  301. package/examples/svelte/app/routes/index.ts +12 -0
  302. package/examples/svelte/configs/env.ts +6 -0
  303. package/examples/svelte/configs/infra.ts +85 -0
  304. package/examples/svelte/configs/tsconfig.json +15 -0
  305. package/examples/svelte/configs/vite.ts +9 -0
  306. package/examples/svelte/configs/vitest.ts +9 -0
  307. package/examples/svelte/lib/types/svelte.d.ts +8 -0
  308. package/examples/svelte/lib/ui/base.css +12 -0
  309. package/examples/svelte/lib/ui/layout.ts +18 -0
  310. package/examples/svelte/modules/about/views.ts +8 -0
  311. package/examples/svelte/modules/shop/products.ts +18 -0
  312. package/examples/svelte/modules/shop/shop.css +13 -0
  313. package/examples/svelte/modules/shop/shop.test.ts +28 -0
  314. package/examples/svelte/modules/shop/shop.ts +13 -0
  315. package/examples/svelte/modules/shop/ui/Cart.island.svelte +23 -0
  316. package/examples/svelte/modules/shop/views.ts +16 -0
  317. package/examples/svelte/package.json +35 -0
  318. package/examples/svelte/tsconfig.json +4 -0
  319. package/examples/tailwind/.env.example +2 -0
  320. package/examples/tailwind/README.md +16 -0
  321. package/examples/tailwind/app/assets/site.css +2 -0
  322. package/examples/tailwind/app/entry.ts +28 -0
  323. package/examples/tailwind/app/routes/_middleware.ts +4 -0
  324. package/examples/tailwind/app/routes/health.ts +7 -0
  325. package/examples/tailwind/app/routes/index.ts +30 -0
  326. package/examples/tailwind/configs/Dockerfile +26 -0
  327. package/examples/tailwind/configs/Dockerfile.dockerignore +9 -0
  328. package/examples/tailwind/configs/env.ts +6 -0
  329. package/examples/tailwind/configs/infra.ts +55 -0
  330. package/examples/tailwind/configs/tsconfig.json +15 -0
  331. package/examples/tailwind/configs/vite.ts +7 -0
  332. package/examples/tailwind/configs/vitest.ts +9 -0
  333. package/examples/tailwind/lib/ui/components.ts +21 -0
  334. package/examples/tailwind/lib/ui/layout.ts +21 -0
  335. package/examples/tailwind/lib/ui/theme.css +10 -0
  336. package/examples/tailwind/modules/team/team.test.ts +30 -0
  337. package/examples/tailwind/modules/team/team.ts +34 -0
  338. package/examples/tailwind/modules/team/views.ts +45 -0
  339. package/examples/tailwind/package.json +35 -0
  340. package/examples/tailwind/tsconfig.json +4 -0
  341. package/examples/vue/.env.example +2 -0
  342. package/examples/vue/README.md +18 -0
  343. package/examples/vue/app/assets/site.css +3 -0
  344. package/examples/vue/app/entry.ts +28 -0
  345. package/examples/vue/app/routes/_middleware.ts +4 -0
  346. package/examples/vue/app/routes/about.ts +10 -0
  347. package/examples/vue/app/routes/health.ts +7 -0
  348. package/examples/vue/app/routes/index.ts +12 -0
  349. package/examples/vue/configs/env.ts +6 -0
  350. package/examples/vue/configs/infra.ts +85 -0
  351. package/examples/vue/configs/tsconfig.json +15 -0
  352. package/examples/vue/configs/vite.ts +7 -0
  353. package/examples/vue/configs/vitest.ts +9 -0
  354. package/examples/vue/lib/types/vue.d.ts +8 -0
  355. package/examples/vue/lib/ui/base.css +12 -0
  356. package/examples/vue/lib/ui/layout.ts +18 -0
  357. package/examples/vue/modules/about/views.ts +8 -0
  358. package/examples/vue/modules/shop/products.ts +18 -0
  359. package/examples/vue/modules/shop/shop.css +13 -0
  360. package/examples/vue/modules/shop/shop.test.ts +28 -0
  361. package/examples/vue/modules/shop/shop.ts +13 -0
  362. package/examples/vue/modules/shop/ui/Cart.island.vue +27 -0
  363. package/examples/vue/modules/shop/views.ts +16 -0
  364. package/examples/vue/package.json +35 -0
  365. package/examples/vue/tsconfig.json +4 -0
  366. package/package.json +44 -3
@@ -0,0 +1,1131 @@
1
+ /* The spacefn docs reader. Light and dark share one set of tokens. */
2
+ :root {
3
+ --bg: #ffffff;
4
+ --bg-soft: #fafafa;
5
+ --bg-muted: #f4f4f5;
6
+ --bg-code: #fafafa;
7
+ --border: #e4e4e7;
8
+ --border-strong: #d4d4d8;
9
+ --text: #3f3f46;
10
+ --text-strong: #18181b;
11
+ --text-muted: #71717a;
12
+ --accent: #e11d48;
13
+ --accent-soft: rgba(225, 29, 72, 0.08);
14
+ --accent-text: #be123c;
15
+ --note: #2563eb;
16
+ --tip: #16a34a;
17
+ --important: #7c3aed;
18
+ --warning: #d97706;
19
+ --caution: #dc2626;
20
+ --header-h: 64px;
21
+ --radius: 8px;
22
+ --font: "Inter", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
23
+ --mono: ui-monospace, "SF Mono", Menlo, Consolas, monospace;
24
+ --code-pad: 1.1rem;
25
+ color-scheme: light;
26
+ }
27
+ html.dark {
28
+ --bg: #0a0a0b;
29
+ --bg-soft: #111113;
30
+ --bg-muted: #18181b;
31
+ --bg-code: #111113;
32
+ --border: #232327;
33
+ --border-strong: #3f3f46;
34
+ --text: #d4d4d8;
35
+ --text-strong: #fafafa;
36
+ --text-muted: #a1a1aa;
37
+ --accent: #fb7185;
38
+ --accent-soft: rgba(251, 113, 133, 0.1);
39
+ --accent-text: #fda4af;
40
+ --note: #60a5fa;
41
+ --tip: #4ade80;
42
+ --important: #a78bfa;
43
+ --warning: #fbbf24;
44
+ --caution: #f87171;
45
+ color-scheme: dark;
46
+ }
47
+ *,
48
+ *::before,
49
+ *::after {
50
+ box-sizing: border-box;
51
+ }
52
+ html {
53
+ scroll-padding-top: calc(var(--header-h) + 1.5rem);
54
+ -webkit-text-size-adjust: 100%;
55
+ }
56
+ body {
57
+ margin: 0;
58
+ background: var(--bg);
59
+ color: var(--text);
60
+ font: 15px/1.7 var(--font);
61
+ -webkit-font-smoothing: antialiased;
62
+ }
63
+ a {
64
+ color: inherit;
65
+ text-decoration: none;
66
+ }
67
+ button {
68
+ font: inherit;
69
+ color: inherit;
70
+ }
71
+ svg.icon {
72
+ width: 1.1em;
73
+ height: 1.1em;
74
+ flex: none;
75
+ }
76
+
77
+ /* Top bar */
78
+ .topbar {
79
+ position: sticky;
80
+ top: 0;
81
+ z-index: 30;
82
+ height: var(--header-h);
83
+ display: flex;
84
+ align-items: center;
85
+ gap: 1rem;
86
+ padding: 0 1.5rem;
87
+ border-bottom: 1px solid var(--border);
88
+ background: color-mix(in srgb, var(--bg) 82%, transparent);
89
+ backdrop-filter: blur(12px);
90
+ -webkit-backdrop-filter: blur(12px);
91
+ }
92
+ .brand {
93
+ display: flex;
94
+ align-items: center;
95
+ gap: 0.6rem;
96
+ font-weight: 650;
97
+ font-size: 1rem;
98
+ color: var(--text-strong);
99
+ letter-spacing: -0.01em;
100
+ min-width: 0;
101
+ }
102
+ .brand img {
103
+ height: 28px;
104
+ width: auto;
105
+ max-width: 120px;
106
+ object-fit: contain;
107
+ }
108
+ .brand-tag {
109
+ font-size: 0.7rem;
110
+ font-weight: 600;
111
+ padding: 0.05rem 0.45rem;
112
+ border-radius: 999px;
113
+ border: 1px solid var(--border);
114
+ color: var(--text-muted);
115
+ }
116
+ .topbar-sources {
117
+ display: flex;
118
+ gap: 0.25rem;
119
+ }
120
+ .source-tab {
121
+ display: inline-flex;
122
+ align-items: center;
123
+ gap: 0.4rem;
124
+ padding: 0.3rem 0.7rem;
125
+ border-radius: var(--radius);
126
+ font-size: 0.875rem;
127
+ font-weight: 550;
128
+ color: var(--text-muted);
129
+ }
130
+ .source-tab:hover {
131
+ color: var(--text-strong);
132
+ background: var(--bg-muted);
133
+ }
134
+ .source-tab.active {
135
+ color: var(--accent-text);
136
+ background: var(--accent-soft);
137
+ }
138
+ .version {
139
+ font: 500 0.7rem var(--mono);
140
+ opacity: 0.8;
141
+ }
142
+ .topbar-search {
143
+ margin-left: auto;
144
+ display: flex;
145
+ align-items: center;
146
+ gap: 0.5rem;
147
+ width: min(100%, 18rem);
148
+ height: 36px;
149
+ padding: 0 0.5rem 0 0.75rem;
150
+ border: 1px solid var(--border);
151
+ border-radius: var(--radius);
152
+ background: var(--bg-soft);
153
+ color: var(--text-muted);
154
+ cursor: pointer;
155
+ font-size: 0.875rem;
156
+ transition: border-color 0.15s;
157
+ }
158
+ .topbar-search:hover {
159
+ border-color: var(--border-strong);
160
+ }
161
+ .topbar-search span {
162
+ flex: 1;
163
+ text-align: left;
164
+ }
165
+ kbd {
166
+ font: 500 0.75em var(--mono);
167
+ padding: 0.1rem 0.35rem;
168
+ border: 1px solid var(--border);
169
+ border-bottom-width: 2px;
170
+ border-radius: 5px;
171
+ background: var(--bg);
172
+ color: var(--text-muted);
173
+ }
174
+ .icon-btn {
175
+ display: inline-flex;
176
+ align-items: center;
177
+ justify-content: center;
178
+ width: 36px;
179
+ height: 36px;
180
+ border: 0;
181
+ border-radius: var(--radius);
182
+ background: transparent;
183
+ color: var(--text-muted);
184
+ cursor: pointer;
185
+ }
186
+ .icon-btn:hover {
187
+ background: var(--bg-muted);
188
+ color: var(--text-strong);
189
+ }
190
+ .menu-btn {
191
+ display: none;
192
+ }
193
+ html:not(.dark) .icon-sun,
194
+ html.dark .icon-moon {
195
+ display: none;
196
+ }
197
+
198
+ /* Layout */
199
+ .shell {
200
+ max-width: 90rem;
201
+ margin: 0 auto;
202
+ display: grid;
203
+ grid-template-columns: 17rem minmax(0, 1fr) 15rem;
204
+ gap: 0 2.5rem;
205
+ padding: 0 1.5rem;
206
+ }
207
+ .sidebar {
208
+ position: sticky;
209
+ top: var(--header-h);
210
+ height: calc(100vh - var(--header-h));
211
+ overflow-y: auto;
212
+ padding: 1.75rem 0.5rem 3rem 0;
213
+ font-size: 0.875rem;
214
+ scrollbar-width: thin;
215
+ }
216
+ .nav-sources {
217
+ display: none;
218
+ gap: 0.25rem;
219
+ margin-bottom: 1.25rem;
220
+ padding-bottom: 1rem;
221
+ border-bottom: 1px solid var(--border);
222
+ }
223
+ .nav-group {
224
+ margin-bottom: 1.5rem;
225
+ }
226
+ .nav-group-title {
227
+ display: flex;
228
+ align-items: center;
229
+ margin: 0 0 0.5rem;
230
+ padding: 0.25rem 0.75rem;
231
+ border-radius: var(--radius);
232
+ font-size: 0.8125rem;
233
+ font-weight: 600;
234
+ color: var(--text-strong);
235
+ list-style: none;
236
+ cursor: pointer;
237
+ user-select: none;
238
+ }
239
+ .nav-group-title::-webkit-details-marker {
240
+ display: none;
241
+ }
242
+ .nav-group-title:hover {
243
+ background: var(--bg-muted);
244
+ }
245
+ /* The same chevron as a folder inside a group. */
246
+ .nav-group-title::after {
247
+ content: "";
248
+ width: 0.4rem;
249
+ height: 0.4rem;
250
+ margin-left: auto;
251
+ border-right: 1.5px solid currentColor;
252
+ border-bottom: 1.5px solid currentColor;
253
+ transform: rotate(-45deg);
254
+ transition: transform 0.15s;
255
+ opacity: 0.6;
256
+ }
257
+ .nav-group[open] > .nav-group-title::after {
258
+ transform: rotate(45deg);
259
+ }
260
+ .nav-group:not([open]) {
261
+ margin-bottom: 0.5rem;
262
+ }
263
+ .nav-list {
264
+ list-style: none;
265
+ margin: 0 0 0 0.75rem;
266
+ padding: 0;
267
+ border-left: 1px solid var(--border);
268
+ }
269
+ .nav-list .nav-list {
270
+ margin-left: 0.75rem;
271
+ }
272
+ .nav-list a {
273
+ display: block;
274
+ margin-left: -1px;
275
+ padding: 0.3rem 0.75rem;
276
+ border-left: 1px solid transparent;
277
+ color: var(--text-muted);
278
+ line-height: 1.45;
279
+ transition:
280
+ color 0.12s,
281
+ border-color 0.12s;
282
+ }
283
+ .nav-list a:hover {
284
+ color: var(--text-strong);
285
+ border-left-color: var(--border-strong);
286
+ }
287
+ .nav-list a.active {
288
+ color: var(--accent-text);
289
+ border-left-color: var(--accent);
290
+ font-weight: 550;
291
+ }
292
+ .nav-list details > summary {
293
+ list-style: none;
294
+ display: flex;
295
+ align-items: center;
296
+ justify-content: space-between;
297
+ margin-left: -1px;
298
+ padding: 0.3rem 0.75rem;
299
+ color: var(--text);
300
+ cursor: pointer;
301
+ font-weight: 500;
302
+ }
303
+ .nav-list details > summary::-webkit-details-marker {
304
+ display: none;
305
+ }
306
+ .nav-list details > summary::after {
307
+ content: "";
308
+ width: 0.4rem;
309
+ height: 0.4rem;
310
+ border-right: 1.5px solid currentColor;
311
+ border-bottom: 1.5px solid currentColor;
312
+ transform: rotate(-45deg);
313
+ transition: transform 0.15s;
314
+ opacity: 0.6;
315
+ }
316
+ .nav-list details[open] > summary::after {
317
+ transform: rotate(45deg);
318
+ }
319
+ /* A page's Tabler icon, drawn in the link's color. */
320
+ .nav-icon {
321
+ display: inline-block;
322
+ width: 16px;
323
+ height: 16px;
324
+ margin-right: 0.5rem;
325
+ vertical-align: -3px;
326
+ flex: none;
327
+ background-color: currentColor;
328
+ -webkit-mask: var(--icon) center / contain no-repeat;
329
+ mask: var(--icon) center / contain no-repeat;
330
+ }
331
+ .nav-top {
332
+ list-style: none;
333
+ margin: 0 0 1.5rem;
334
+ padding: 0;
335
+ }
336
+ .nav-top a {
337
+ display: block;
338
+ padding: 0.35rem 0.75rem;
339
+ border-radius: var(--radius);
340
+ color: var(--text-muted);
341
+ font-weight: 500;
342
+ }
343
+ .nav-top a:hover {
344
+ color: var(--text-strong);
345
+ background: var(--bg-muted);
346
+ }
347
+ .nav-top a.active {
348
+ color: var(--accent-text);
349
+ background: var(--accent-soft);
350
+ }
351
+
352
+ /* Content */
353
+ .content {
354
+ min-width: 0;
355
+ padding: 2.5rem 0 4rem;
356
+ }
357
+ .eyebrow {
358
+ margin-bottom: 0.75rem;
359
+ font-size: 0.8125rem;
360
+ font-weight: 550;
361
+ color: var(--accent-text);
362
+ }
363
+ .prose {
364
+ max-width: 48rem;
365
+ }
366
+ .prose > *:first-child {
367
+ margin-top: 0;
368
+ }
369
+ .prose h1 {
370
+ margin: 0 0 0.75rem;
371
+ font-size: 2.25rem;
372
+ line-height: 1.2;
373
+ font-weight: 700;
374
+ letter-spacing: -0.025em;
375
+ color: var(--text-strong);
376
+ }
377
+ .prose h1 + p {
378
+ font-size: 1.125rem;
379
+ color: var(--text-muted);
380
+ margin: 0 0 2.25rem;
381
+ }
382
+ .prose h2,
383
+ .prose h3,
384
+ .prose h4 {
385
+ position: relative;
386
+ color: var(--text-strong);
387
+ letter-spacing: -0.015em;
388
+ line-height: 1.35;
389
+ }
390
+ .prose h2 {
391
+ margin: 3rem 0 1rem;
392
+ padding-top: 1.5rem;
393
+ border-top: 1px solid var(--border);
394
+ font-size: 1.5rem;
395
+ font-weight: 650;
396
+ }
397
+ .prose h3 {
398
+ margin: 2.25rem 0 0.75rem;
399
+ font-size: 1.2rem;
400
+ font-weight: 600;
401
+ }
402
+ .prose h4 {
403
+ margin: 1.75rem 0 0.5rem;
404
+ font-size: 1rem;
405
+ font-weight: 600;
406
+ }
407
+ .heading-anchor {
408
+ position: absolute;
409
+ left: -1.25em;
410
+ padding-right: 0.4em;
411
+ color: var(--accent);
412
+ opacity: 0;
413
+ font-weight: 500;
414
+ transition: opacity 0.12s;
415
+ }
416
+ .prose :is(h2, h3, h4):hover .heading-anchor {
417
+ opacity: 1;
418
+ }
419
+ .prose p,
420
+ .prose ul,
421
+ .prose ol {
422
+ margin: 1.1rem 0;
423
+ }
424
+ .prose ul,
425
+ .prose ol {
426
+ padding-left: 1.4rem;
427
+ }
428
+ .prose li {
429
+ margin: 0.35rem 0;
430
+ }
431
+ .prose li::marker {
432
+ color: var(--text-muted);
433
+ }
434
+ .prose strong {
435
+ color: var(--text-strong);
436
+ font-weight: 600;
437
+ }
438
+ .prose a {
439
+ color: var(--accent-text);
440
+ font-weight: 500;
441
+ border-bottom: 1px solid color-mix(in srgb, var(--accent) 35%, transparent);
442
+ transition: border-color 0.12s;
443
+ }
444
+ .prose a:hover {
445
+ border-bottom-color: var(--accent);
446
+ }
447
+ .prose a.heading-anchor {
448
+ border: 0;
449
+ }
450
+ .prose hr {
451
+ border: 0;
452
+ border-top: 1px solid var(--border);
453
+ margin: 2.5rem 0;
454
+ }
455
+ .prose img,
456
+ .prose video {
457
+ max-width: 100%;
458
+ border-radius: var(--radius);
459
+ }
460
+ .prose :not(pre) > code {
461
+ font: 500 0.85em var(--mono);
462
+ padding: 0.15em 0.4em;
463
+ border-radius: 6px;
464
+ background: var(--bg-muted);
465
+ border: 1px solid var(--border);
466
+ color: var(--text-strong);
467
+ word-break: break-word;
468
+ }
469
+ .prose blockquote {
470
+ margin: 1.5rem 0;
471
+ padding: 0.25rem 1rem;
472
+ border-left: 3px solid var(--border-strong);
473
+ color: var(--text-muted);
474
+ }
475
+ .prose blockquote > p {
476
+ margin: 0.6rem 0;
477
+ }
478
+
479
+ /* Code */
480
+ .code-block {
481
+ position: relative;
482
+ margin: 1.5rem 0;
483
+ border: 1px solid var(--border);
484
+ border-radius: var(--radius);
485
+ background: var(--bg-code);
486
+ overflow: hidden;
487
+ }
488
+ .code-head {
489
+ display: flex;
490
+ align-items: center;
491
+ gap: 0.75rem;
492
+ height: 38px;
493
+ padding: 0 5rem 0 0.9rem;
494
+ border-bottom: 1px solid var(--border);
495
+ font: 500 0.75rem var(--mono);
496
+ color: var(--text-muted);
497
+ }
498
+ .code-title {
499
+ color: var(--text);
500
+ }
501
+ .code-lang {
502
+ margin-left: auto;
503
+ opacity: 0.7;
504
+ }
505
+ .code-block pre {
506
+ margin: 0;
507
+ padding: 1rem 0;
508
+ overflow-x: auto;
509
+ font: 13.5px/1.7 var(--mono);
510
+ background: transparent !important;
511
+ tab-size: 3;
512
+ }
513
+ .code-block pre code {
514
+ display: block;
515
+ width: max-content;
516
+ min-width: 100%;
517
+ font: inherit;
518
+ }
519
+ .code-block .line {
520
+ display: inline-block;
521
+ /* On the baseline, each line would add the font's descent below it. */
522
+ vertical-align: top;
523
+ width: 100%;
524
+ padding: 0 var(--code-pad);
525
+ }
526
+ .shiki {
527
+ background-color: transparent !important;
528
+ }
529
+ html.dark .shiki,
530
+ html.dark .shiki span {
531
+ color: var(--shiki-dark) !important;
532
+ font-style: var(--shiki-dark-font-style) !important;
533
+ font-weight: var(--shiki-dark-font-weight) !important;
534
+ }
535
+ .shiki .line.highlighted {
536
+ background: color-mix(in srgb, var(--note) 12%, transparent);
537
+ box-shadow: inset 2px 0 var(--note);
538
+ }
539
+ .shiki .line.highlighted.error {
540
+ background: color-mix(in srgb, var(--caution) 14%, transparent);
541
+ box-shadow: inset 2px 0 var(--caution);
542
+ }
543
+ .shiki .line.highlighted.warning {
544
+ background: color-mix(in srgb, var(--warning) 14%, transparent);
545
+ box-shadow: inset 2px 0 var(--warning);
546
+ }
547
+ .shiki .line.diff {
548
+ position: relative;
549
+ }
550
+ .shiki .line.diff::before {
551
+ position: absolute;
552
+ left: 0.35rem;
553
+ }
554
+ .shiki .line.diff.add {
555
+ background: color-mix(in srgb, var(--tip) 13%, transparent);
556
+ }
557
+ .shiki .line.diff.add::before {
558
+ content: "+";
559
+ color: var(--tip);
560
+ }
561
+ .shiki .line.diff.remove {
562
+ background: color-mix(in srgb, var(--caution) 12%, transparent);
563
+ opacity: 0.75;
564
+ }
565
+ .shiki .line.diff.remove::before {
566
+ content: "-";
567
+ color: var(--caution);
568
+ }
569
+ .shiki.has-focused .line:not(.focused) {
570
+ opacity: 0.45;
571
+ filter: blur(0.5px);
572
+ transition:
573
+ opacity 0.2s,
574
+ filter 0.2s;
575
+ }
576
+ .shiki.has-focused:hover .line:not(.focused) {
577
+ opacity: 1;
578
+ filter: none;
579
+ }
580
+ .copy-btn {
581
+ position: absolute;
582
+ top: 4px;
583
+ right: 6px;
584
+ height: 30px;
585
+ padding: 0 0.55rem;
586
+ border: 0;
587
+ border-radius: 6px;
588
+ background: transparent;
589
+ color: var(--text-muted);
590
+ font-size: 0.75rem;
591
+ cursor: pointer;
592
+ opacity: 0.75;
593
+ }
594
+ .copy-btn:hover {
595
+ opacity: 1;
596
+ background: var(--bg-muted);
597
+ color: var(--text-strong);
598
+ }
599
+ .copy-btn.copied {
600
+ color: var(--tip);
601
+ opacity: 1;
602
+ }
603
+ .code-block:not(:has(.code-head)) .copy-btn {
604
+ top: 8px;
605
+ }
606
+
607
+ /* Code groups */
608
+ .code-group {
609
+ margin: 1.5rem 0;
610
+ border: 1px solid var(--border);
611
+ border-radius: var(--radius);
612
+ background: var(--bg-code);
613
+ overflow: hidden;
614
+ }
615
+ .code-tabs {
616
+ display: flex;
617
+ overflow-x: auto;
618
+ border-bottom: 1px solid var(--border);
619
+ padding: 0 0.5rem;
620
+ }
621
+ .code-tabs button {
622
+ position: relative;
623
+ flex: none;
624
+ padding: 0.55rem 0.7rem;
625
+ border: 0;
626
+ background: none;
627
+ font: 500 0.8125rem var(--mono);
628
+ color: var(--text-muted);
629
+ cursor: pointer;
630
+ }
631
+ .code-tabs button:hover {
632
+ color: var(--text-strong);
633
+ }
634
+ .code-tabs button[aria-selected="true"] {
635
+ color: var(--accent-text);
636
+ }
637
+ .code-tabs button[aria-selected="true"]::after {
638
+ content: "";
639
+ position: absolute;
640
+ left: 0.5rem;
641
+ right: 0.5rem;
642
+ bottom: -1px;
643
+ height: 2px;
644
+ border-radius: 2px;
645
+ background: var(--accent);
646
+ }
647
+ .code-group .code-block {
648
+ margin: 0;
649
+ border: 0;
650
+ border-radius: 0;
651
+ }
652
+ .code-group .code-head {
653
+ display: none;
654
+ }
655
+ .code-group .copy-btn {
656
+ top: 8px;
657
+ }
658
+
659
+ /* Mermaid */
660
+ .mermaid-block {
661
+ margin: 1.5rem 0;
662
+ padding: 1.25rem;
663
+ border: 1px solid var(--border);
664
+ border-radius: var(--radius);
665
+ background: var(--bg-soft);
666
+ overflow-x: auto;
667
+ text-align: center;
668
+ }
669
+ .mermaid-block pre.mermaid {
670
+ margin: 0;
671
+ font: 13px/1.6 var(--mono);
672
+ text-align: left;
673
+ white-space: pre;
674
+ }
675
+ .mermaid-block pre.mermaid[data-processed] {
676
+ text-align: center;
677
+ white-space: normal;
678
+ }
679
+ .mermaid-block svg {
680
+ max-width: 100%;
681
+ height: auto;
682
+ }
683
+
684
+ /* Tables */
685
+ .table-wrap {
686
+ margin: 1.5rem 0;
687
+ overflow-x: auto;
688
+ border: 1px solid var(--border);
689
+ border-radius: var(--radius);
690
+ }
691
+ .prose table {
692
+ width: 100%;
693
+ border-collapse: collapse;
694
+ font-size: 0.875rem;
695
+ }
696
+ .prose th {
697
+ text-align: left;
698
+ font-weight: 600;
699
+ color: var(--text-strong);
700
+ background: var(--bg-soft);
701
+ }
702
+ .prose th,
703
+ .prose td {
704
+ padding: 0.6rem 0.9rem;
705
+ border-bottom: 1px solid var(--border);
706
+ vertical-align: top;
707
+ }
708
+ .prose tr:last-child td {
709
+ border-bottom: 0;
710
+ }
711
+
712
+ /* Callouts: GitHub alerts, and <div class="callout tip"> in HTML */
713
+ .prose .callout {
714
+ --c: var(--note);
715
+ margin: 1.5rem 0;
716
+ padding: 0.4rem 1rem;
717
+ border: 1px solid color-mix(in srgb, var(--c) 30%, transparent);
718
+ border-left: 3px solid var(--c);
719
+ border-radius: var(--radius);
720
+ background: color-mix(in srgb, var(--c) 7%, transparent);
721
+ color: var(--text);
722
+ }
723
+ .prose .callout > p {
724
+ margin: 0.5rem 0;
725
+ }
726
+ .callout-title {
727
+ font-weight: 600;
728
+ color: var(--c);
729
+ margin-bottom: 0.25rem !important;
730
+ }
731
+ .prose :is(.callout-tip, .callout.tip) {
732
+ --c: var(--tip);
733
+ }
734
+ .prose :is(.callout-important, .callout.important) {
735
+ --c: var(--important);
736
+ }
737
+ .prose :is(.callout-warning, .callout.warning) {
738
+ --c: var(--warning);
739
+ }
740
+ .prose :is(.callout-caution, .callout.caution) {
741
+ --c: var(--caution);
742
+ }
743
+
744
+ /* <details> */
745
+ .prose details:not(.nav-list details) {
746
+ margin: 1.5rem 0;
747
+ border: 1px solid var(--border);
748
+ border-radius: var(--radius);
749
+ background: var(--bg-soft);
750
+ }
751
+ .prose details > summary {
752
+ padding: 0.65rem 1rem;
753
+ font-weight: 600;
754
+ color: var(--text-strong);
755
+ cursor: pointer;
756
+ }
757
+ .prose details[open] > summary {
758
+ border-bottom: 1px solid var(--border);
759
+ }
760
+ .prose details > :not(summary) {
761
+ margin-left: 1rem;
762
+ margin-right: 1rem;
763
+ }
764
+ .prose details > .code-block,
765
+ .prose details > .code-group {
766
+ margin: 1rem;
767
+ }
768
+
769
+ /* Badges: <span class="badge tip">new</span> */
770
+ .badge {
771
+ --c: var(--note);
772
+ display: inline-block;
773
+ margin: 0 0.15rem;
774
+ padding: 0 0.5rem;
775
+ border: 1px solid color-mix(in srgb, var(--c) 35%, transparent);
776
+ border-radius: 999px;
777
+ background: color-mix(in srgb, var(--c) 10%, transparent);
778
+ color: var(--c);
779
+ font-size: 0.75rem;
780
+ font-weight: 600;
781
+ line-height: 1.6;
782
+ vertical-align: 0.15em;
783
+ }
784
+ .badge.tip {
785
+ --c: var(--tip);
786
+ }
787
+ .badge.warning {
788
+ --c: var(--warning);
789
+ }
790
+ .badge.caution {
791
+ --c: var(--caution);
792
+ }
793
+ .badge.important {
794
+ --c: var(--important);
795
+ }
796
+
797
+ /* Steps: <div class="steps"> around h3 sections */
798
+ .prose .steps {
799
+ margin: 1.5rem 0 1.5rem 0.75rem;
800
+ padding-left: 1.75rem;
801
+ border-left: 1px solid var(--border);
802
+ counter-reset: step;
803
+ }
804
+ .prose .steps h3 {
805
+ counter-increment: step;
806
+ margin-top: 2rem;
807
+ }
808
+ .prose .steps h3::before {
809
+ content: counter(step);
810
+ position: absolute;
811
+ left: -2.6rem;
812
+ top: -0.1rem;
813
+ display: grid;
814
+ place-items: center;
815
+ width: 1.7rem;
816
+ height: 1.7rem;
817
+ border: 1px solid var(--border-strong);
818
+ border-radius: 50%;
819
+ background: var(--bg);
820
+ font-size: 0.8rem;
821
+ font-weight: 600;
822
+ }
823
+ .prose .steps h3 .heading-anchor {
824
+ display: none;
825
+ }
826
+
827
+ /* Cards: an index page, or <div class="cards"> around a list of links */
828
+ ul.cards,
829
+ .prose div.cards > ul {
830
+ display: grid;
831
+ grid-template-columns: repeat(auto-fill, minmax(14rem, 1fr));
832
+ gap: 1rem;
833
+ margin: 2rem 0;
834
+ padding: 0;
835
+ list-style: none;
836
+ }
837
+ .card,
838
+ .prose .cards > ul > li {
839
+ position: relative;
840
+ display: flex;
841
+ flex-direction: column;
842
+ gap: 0.35rem;
843
+ height: 100%;
844
+ margin: 0;
845
+ padding: 1.1rem 1.2rem;
846
+ border: 1px solid var(--border);
847
+ border-radius: var(--radius);
848
+ background: var(--bg-soft);
849
+ color: var(--text-muted);
850
+ font-size: 0.875rem;
851
+ transition:
852
+ border-color 0.15s,
853
+ transform 0.15s;
854
+ }
855
+ .prose .cards > ul > li > a {
856
+ border: 0;
857
+ color: var(--text-strong);
858
+ font-size: 0.9375rem;
859
+ font-weight: 600;
860
+ }
861
+ /* The whole card is the link. */
862
+ .prose .cards > ul > li > a::after {
863
+ content: "";
864
+ position: absolute;
865
+ inset: 0;
866
+ }
867
+ .prose .cards > ul > li br {
868
+ display: none;
869
+ }
870
+ .card:hover,
871
+ .prose .cards > ul > li:hover {
872
+ border-color: var(--accent);
873
+ transform: translateY(-1px);
874
+ }
875
+ .card-title {
876
+ display: flex;
877
+ align-items: center;
878
+ gap: 0.5rem;
879
+ font-weight: 600;
880
+ color: var(--text-strong);
881
+ }
882
+ .card-meta {
883
+ font-size: 0.8125rem;
884
+ font-weight: 400;
885
+ color: var(--text-muted);
886
+ }
887
+
888
+ /* Footer */
889
+ .page-foot {
890
+ max-width: 48rem;
891
+ margin-top: 3rem;
892
+ }
893
+ .pager {
894
+ display: grid;
895
+ grid-template-columns: 1fr 1fr;
896
+ gap: 1rem;
897
+ }
898
+ .pager a {
899
+ display: flex;
900
+ flex-direction: column;
901
+ gap: 0.2rem;
902
+ padding: 1rem 1.2rem;
903
+ border: 1px solid var(--border);
904
+ border-radius: var(--radius);
905
+ transition: border-color 0.15s;
906
+ }
907
+ .pager a:hover {
908
+ border-color: var(--accent);
909
+ }
910
+ .pager .next {
911
+ grid-column: 2;
912
+ text-align: right;
913
+ align-items: flex-end;
914
+ }
915
+ .pager small {
916
+ font-size: 0.8rem;
917
+ color: var(--text-muted);
918
+ }
919
+ .pager strong {
920
+ font-weight: 600;
921
+ color: var(--text-strong);
922
+ }
923
+
924
+ /* On this page */
925
+ .toc {
926
+ position: sticky;
927
+ top: var(--header-h);
928
+ height: calc(100vh - var(--header-h));
929
+ overflow-y: auto;
930
+ padding: 2.5rem 0 2rem;
931
+ font-size: 0.8125rem;
932
+ scrollbar-width: thin;
933
+ }
934
+ .toc-title {
935
+ display: flex;
936
+ align-items: center;
937
+ gap: 0.4rem;
938
+ margin: 0 0 0.75rem;
939
+ font-weight: 600;
940
+ color: var(--text-strong);
941
+ }
942
+ .toc ul {
943
+ list-style: none;
944
+ margin: 0;
945
+ padding: 0;
946
+ }
947
+ .toc li a {
948
+ display: block;
949
+ padding: 0.28rem 0;
950
+ color: var(--text-muted);
951
+ line-height: 1.4;
952
+ transition: color 0.12s;
953
+ }
954
+ .toc li.depth-3 a {
955
+ padding-left: 0.85rem;
956
+ }
957
+ .toc li a:hover {
958
+ color: var(--text-strong);
959
+ }
960
+ .toc li a.active {
961
+ color: var(--accent-text);
962
+ font-weight: 550;
963
+ }
964
+
965
+ /* Search */
966
+ .search-dialog {
967
+ width: min(42rem, calc(100vw - 2rem));
968
+ max-height: min(34rem, calc(100vh - 6rem));
969
+ margin: 5rem auto auto;
970
+ padding: 0;
971
+ border: 1px solid var(--border);
972
+ border-radius: 12px;
973
+ background: var(--bg);
974
+ color: var(--text);
975
+ box-shadow: 0 24px 64px -12px rgba(0, 0, 0, 0.35);
976
+ overflow: hidden;
977
+ }
978
+ .search-dialog::backdrop {
979
+ background: rgba(0, 0, 0, 0.45);
980
+ backdrop-filter: blur(2px);
981
+ }
982
+ .search-dialog[open] {
983
+ display: flex;
984
+ flex-direction: column;
985
+ }
986
+ .search-field {
987
+ display: flex;
988
+ align-items: center;
989
+ gap: 0.6rem;
990
+ padding: 0 1rem;
991
+ border-bottom: 1px solid var(--border);
992
+ color: var(--text-muted);
993
+ }
994
+ .search-field input::-webkit-search-cancel-button {
995
+ display: none;
996
+ }
997
+ .search-field input {
998
+ flex: 1;
999
+ height: 52px;
1000
+ border: 0;
1001
+ outline: 0;
1002
+ background: transparent;
1003
+ color: var(--text-strong);
1004
+ font: inherit;
1005
+ font-size: 1rem;
1006
+ }
1007
+ .search-results {
1008
+ list-style: none;
1009
+ margin: 0;
1010
+ padding: 0.5rem;
1011
+ overflow-y: auto;
1012
+ }
1013
+ .search-results a {
1014
+ display: flex;
1015
+ flex-direction: column;
1016
+ gap: 0.1rem;
1017
+ padding: 0.6rem 0.75rem;
1018
+ border-radius: var(--radius);
1019
+ }
1020
+ .search-results a[aria-selected="true"] {
1021
+ background: var(--accent-soft);
1022
+ }
1023
+ .search-results a[aria-selected="true"] .r-title {
1024
+ color: var(--accent-text);
1025
+ }
1026
+ .r-title {
1027
+ font-weight: 550;
1028
+ color: var(--text-strong);
1029
+ }
1030
+ .r-meta {
1031
+ font-size: 0.75rem;
1032
+ color: var(--text-muted);
1033
+ }
1034
+ .r-snippet {
1035
+ font-size: 0.8125rem;
1036
+ color: var(--text-muted);
1037
+ overflow: hidden;
1038
+ text-overflow: ellipsis;
1039
+ white-space: nowrap;
1040
+ }
1041
+ .search-empty {
1042
+ padding: 2rem 1rem;
1043
+ text-align: center;
1044
+ color: var(--text-muted);
1045
+ font-size: 0.9rem;
1046
+ }
1047
+ mark {
1048
+ background: transparent;
1049
+ color: var(--accent-text);
1050
+ font-weight: 650;
1051
+ }
1052
+
1053
+ /* Narrow screens */
1054
+ @media (max-width: 1279px) {
1055
+ .shell {
1056
+ grid-template-columns: 16rem minmax(0, 1fr);
1057
+ }
1058
+ .toc {
1059
+ display: none;
1060
+ }
1061
+ }
1062
+ @media (max-width: 899px) {
1063
+ .topbar {
1064
+ padding: 0 1rem;
1065
+ gap: 0.5rem;
1066
+ }
1067
+ .menu-btn {
1068
+ display: inline-flex;
1069
+ }
1070
+ .topbar-sources {
1071
+ display: none;
1072
+ }
1073
+ .nav-sources {
1074
+ display: flex;
1075
+ }
1076
+ .topbar-search {
1077
+ width: auto;
1078
+ }
1079
+ .topbar-search span,
1080
+ .topbar-search kbd {
1081
+ display: none;
1082
+ }
1083
+ .shell {
1084
+ display: block;
1085
+ padding: 0 1rem;
1086
+ }
1087
+ .sidebar {
1088
+ position: fixed;
1089
+ inset: var(--header-h) auto 0 0;
1090
+ z-index: 25;
1091
+ width: min(20rem, 85vw);
1092
+ height: auto;
1093
+ padding: 1.5rem 1rem 3rem;
1094
+ background: var(--bg);
1095
+ border-right: 1px solid var(--border);
1096
+ transform: translateX(-100%);
1097
+ transition: transform 0.2s ease;
1098
+ visibility: hidden;
1099
+ }
1100
+ body.nav-open .sidebar {
1101
+ transform: none;
1102
+ visibility: visible;
1103
+ }
1104
+ body.nav-open::after {
1105
+ content: "";
1106
+ position: fixed;
1107
+ inset: var(--header-h) 0 0 0;
1108
+ z-index: 20;
1109
+ background: rgba(0, 0, 0, 0.4);
1110
+ }
1111
+ .content {
1112
+ padding-top: 1.75rem;
1113
+ }
1114
+ .prose h1 {
1115
+ font-size: 1.85rem;
1116
+ }
1117
+ .heading-anchor {
1118
+ display: none;
1119
+ }
1120
+ .pager {
1121
+ grid-template-columns: 1fr;
1122
+ }
1123
+ .pager .next {
1124
+ grid-column: 1;
1125
+ }
1126
+ }
1127
+ @media (prefers-reduced-motion: reduce) {
1128
+ * {
1129
+ transition: none !important;
1130
+ }
1131
+ }