@raybase/cli 0.0.2 → 0.3.4

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 (321) hide show
  1. package/LICENSE +21 -0
  2. package/dist/admin-assets.d.ts +22 -0
  3. package/dist/admin-assets.d.ts.map +1 -0
  4. package/dist/admin-assets.js +285 -0
  5. package/dist/admin-assets.js.map +1 -0
  6. package/dist/agent-remote-mcp-cli.d.ts +71 -0
  7. package/dist/agent-remote-mcp-cli.d.ts.map +1 -0
  8. package/dist/agent-remote-mcp-cli.js +466 -0
  9. package/dist/agent-remote-mcp-cli.js.map +1 -0
  10. package/dist/agent-skills-cli.d.ts +4 -0
  11. package/dist/agent-skills-cli.d.ts.map +1 -0
  12. package/dist/agent-skills-cli.js +144 -0
  13. package/dist/agent-skills-cli.js.map +1 -0
  14. package/dist/agent.d.ts +169 -0
  15. package/dist/agent.d.ts.map +1 -0
  16. package/dist/agent.js +531 -0
  17. package/dist/agent.js.map +1 -0
  18. package/dist/app-manifest.d.ts +41 -0
  19. package/dist/app-manifest.d.ts.map +1 -0
  20. package/dist/app-manifest.js +294 -0
  21. package/dist/app-manifest.js.map +1 -0
  22. package/dist/dev-cron-backstop.d.ts +53 -0
  23. package/dist/dev-cron-backstop.d.ts.map +1 -0
  24. package/dist/dev-cron-backstop.js +364 -0
  25. package/dist/dev-cron-backstop.js.map +1 -0
  26. package/dist/dev-do-watchdog.d.ts +37 -0
  27. package/dist/dev-do-watchdog.d.ts.map +1 -0
  28. package/dist/dev-do-watchdog.js +75 -0
  29. package/dist/dev-do-watchdog.js.map +1 -0
  30. package/dist/dev-inference-tape.d.ts +35 -0
  31. package/dist/dev-inference-tape.d.ts.map +1 -0
  32. package/dist/dev-inference-tape.js +502 -0
  33. package/dist/dev-inference-tape.js.map +1 -0
  34. package/dist/dev-ports.d.ts +25 -0
  35. package/dist/dev-ports.d.ts.map +1 -0
  36. package/dist/dev-ports.js +84 -0
  37. package/dist/dev-ports.js.map +1 -0
  38. package/dist/dev-project-lock.d.ts +24 -0
  39. package/dist/dev-project-lock.d.ts.map +1 -0
  40. package/dist/dev-project-lock.js +307 -0
  41. package/dist/dev-project-lock.js.map +1 -0
  42. package/dist/env-files.d.ts +10 -0
  43. package/dist/env-files.d.ts.map +1 -0
  44. package/dist/env-files.js +108 -0
  45. package/dist/env-files.js.map +1 -0
  46. package/dist/external-json.d.ts +3 -0
  47. package/dist/external-json.d.ts.map +1 -0
  48. package/dist/external-json.js +21 -0
  49. package/dist/external-json.js.map +1 -0
  50. package/dist/frameworks.d.ts +67 -0
  51. package/dist/frameworks.d.ts.map +1 -0
  52. package/dist/frameworks.js +210 -0
  53. package/dist/frameworks.js.map +1 -0
  54. package/dist/guide-corpus-doctor.d.ts +24 -0
  55. package/dist/guide-corpus-doctor.d.ts.map +1 -0
  56. package/dist/guide-corpus-doctor.js +111 -0
  57. package/dist/guide-corpus-doctor.js.map +1 -0
  58. package/dist/hosting.d.ts +85 -0
  59. package/dist/hosting.d.ts.map +1 -0
  60. package/dist/hosting.js +136 -0
  61. package/dist/hosting.js.map +1 -0
  62. package/dist/index.d.ts +253 -0
  63. package/dist/index.d.ts.map +1 -0
  64. package/dist/index.js +11497 -0
  65. package/dist/index.js.map +1 -0
  66. package/dist/kit-doctor.d.ts +19 -0
  67. package/dist/kit-doctor.d.ts.map +1 -0
  68. package/dist/kit-doctor.js +255 -0
  69. package/dist/kit-doctor.js.map +1 -0
  70. package/dist/kit-install.d.ts +67 -0
  71. package/dist/kit-install.d.ts.map +1 -0
  72. package/dist/kit-install.js +409 -0
  73. package/dist/kit-install.js.map +1 -0
  74. package/dist/kit-manifest.d.ts +154 -0
  75. package/dist/kit-manifest.d.ts.map +1 -0
  76. package/dist/kit-manifest.js +252 -0
  77. package/dist/kit-manifest.js.map +1 -0
  78. package/dist/kit-registry.d.ts +42 -0
  79. package/dist/kit-registry.d.ts.map +1 -0
  80. package/dist/kit-registry.js +231 -0
  81. package/dist/kit-registry.js.map +1 -0
  82. package/dist/kit-spec.d.ts +37 -0
  83. package/dist/kit-spec.d.ts.map +1 -0
  84. package/dist/kit-spec.js +48 -0
  85. package/dist/kit-spec.js.map +1 -0
  86. package/dist/kit-state.d.ts +57 -0
  87. package/dist/kit-state.d.ts.map +1 -0
  88. package/dist/kit-state.js +31 -0
  89. package/dist/kit-state.js.map +1 -0
  90. package/dist/kits.d.ts +82 -0
  91. package/dist/kits.d.ts.map +1 -0
  92. package/dist/kits.js +255 -0
  93. package/dist/kits.js.map +1 -0
  94. package/dist/license-keys.d.ts +3 -0
  95. package/dist/license-keys.d.ts.map +1 -0
  96. package/dist/license-keys.js +10 -0
  97. package/dist/license-keys.js.map +1 -0
  98. package/dist/licensing.d.ts +269 -0
  99. package/dist/licensing.d.ts.map +1 -0
  100. package/dist/licensing.js +477 -0
  101. package/dist/licensing.js.map +1 -0
  102. package/dist/local-codex-relay.d.ts +19 -0
  103. package/dist/local-codex-relay.d.ts.map +1 -0
  104. package/dist/local-codex-relay.js +203 -0
  105. package/dist/local-codex-relay.js.map +1 -0
  106. package/dist/module-doctor.d.ts +35 -0
  107. package/dist/module-doctor.d.ts.map +1 -0
  108. package/dist/module-doctor.js +966 -0
  109. package/dist/module-doctor.js.map +1 -0
  110. package/dist/module-install.d.ts +71 -0
  111. package/dist/module-install.d.ts.map +1 -0
  112. package/dist/module-install.js +1133 -0
  113. package/dist/module-install.js.map +1 -0
  114. package/dist/module-manifest.d.ts +33 -0
  115. package/dist/module-manifest.d.ts.map +1 -0
  116. package/dist/module-manifest.js +301 -0
  117. package/dist/module-manifest.js.map +1 -0
  118. package/dist/module-state.d.ts +76 -0
  119. package/dist/module-state.d.ts.map +1 -0
  120. package/dist/module-state.js +162 -0
  121. package/dist/module-state.js.map +1 -0
  122. package/dist/modules.d.ts +52 -0
  123. package/dist/modules.d.ts.map +1 -0
  124. package/dist/modules.js +110 -0
  125. package/dist/modules.js.map +1 -0
  126. package/dist/palette-check.d.ts +42 -0
  127. package/dist/palette-check.d.ts.map +1 -0
  128. package/dist/palette-check.js +217 -0
  129. package/dist/palette-check.js.map +1 -0
  130. package/dist/palette-compile.d.ts +30 -0
  131. package/dist/palette-compile.d.ts.map +1 -0
  132. package/dist/palette-compile.js +149 -0
  133. package/dist/palette-compile.js.map +1 -0
  134. package/dist/pm.d.ts +11 -0
  135. package/dist/pm.d.ts.map +1 -0
  136. package/dist/pm.js +30 -0
  137. package/dist/pm.js.map +1 -0
  138. package/dist/project-local-codex-relay.d.ts +11 -0
  139. package/dist/project-local-codex-relay.d.ts.map +1 -0
  140. package/dist/project-local-codex-relay.js +95 -0
  141. package/dist/project-local-codex-relay.js.map +1 -0
  142. package/dist/shared.d.ts +4 -0
  143. package/dist/shared.d.ts.map +1 -0
  144. package/dist/shared.js +38 -0
  145. package/dist/shared.js.map +1 -0
  146. package/dist/shell-match.d.ts +29 -0
  147. package/dist/shell-match.d.ts.map +1 -0
  148. package/dist/shell-match.js +160 -0
  149. package/dist/shell-match.js.map +1 -0
  150. package/dist/template-doctor.d.ts +40 -0
  151. package/dist/template-doctor.d.ts.map +1 -0
  152. package/dist/template-doctor.js +722 -0
  153. package/dist/template-doctor.js.map +1 -0
  154. package/dist/template-install.d.ts +135 -0
  155. package/dist/template-install.d.ts.map +1 -0
  156. package/dist/template-install.js +1311 -0
  157. package/dist/template-install.js.map +1 -0
  158. package/dist/template-manifest.d.ts +328 -0
  159. package/dist/template-manifest.d.ts.map +1 -0
  160. package/dist/template-manifest.js +533 -0
  161. package/dist/template-manifest.js.map +1 -0
  162. package/dist/template-registry.d.ts +76 -0
  163. package/dist/template-registry.d.ts.map +1 -0
  164. package/dist/template-registry.js +365 -0
  165. package/dist/template-registry.js.map +1 -0
  166. package/dist/template-spec.d.ts +24 -0
  167. package/dist/template-spec.d.ts.map +1 -0
  168. package/dist/template-spec.js +38 -0
  169. package/dist/template-spec.js.map +1 -0
  170. package/dist/template-state.d.ts +108 -0
  171. package/dist/template-state.d.ts.map +1 -0
  172. package/dist/template-state.js +93 -0
  173. package/dist/template-state.js.map +1 -0
  174. package/dist/templates.d.ts +123 -0
  175. package/dist/templates.d.ts.map +1 -0
  176. package/dist/templates.js +541 -0
  177. package/dist/templates.js.map +1 -0
  178. package/dist/theme-match.d.ts +41 -0
  179. package/dist/theme-match.d.ts.map +1 -0
  180. package/dist/theme-match.js +92 -0
  181. package/dist/theme-match.js.map +1 -0
  182. package/dist/wrangler-secrets.d.ts +15 -0
  183. package/dist/wrangler-secrets.d.ts.map +1 -0
  184. package/dist/wrangler-secrets.js +97 -0
  185. package/dist/wrangler-secrets.js.map +1 -0
  186. package/kits/datasheet-grid/file-manifest.json +65 -0
  187. package/kits/datasheet-grid/files/AGENTS.md +6 -0
  188. package/kits/datasheet-grid/files/docs/datasheet-grid.md +15 -0
  189. package/kits/datasheet-grid/files/files/src/kits/datasheet-grid/DatasheetGridRoute.tsx +35 -0
  190. package/kits/datasheet-grid/files/files/src/kits/datasheet-grid/README.md +10 -0
  191. package/kits/datasheet-grid/files/files/src/kits/datasheet-grid/grid-adapter.ts +30 -0
  192. package/kits/datasheet-grid/files/files/src/kits/datasheet-grid/grid-metadata.ts +19 -0
  193. package/kits/datasheet-grid/files/files/src/kits/datasheet-grid/grid-state.ts +24 -0
  194. package/kits/datasheet-grid/files/kit.json +119 -0
  195. package/kits/datasheet-grid/files/skills/datasheet-grid/SKILL.md +16 -0
  196. package/kits/datasheet-grid/files/tests/datasheet-grid.test.ts +15 -0
  197. package/kits/datasheet-grid/kit.json +146 -0
  198. package/kits/index.json +71 -0
  199. package/kits/resend-email/file-manifest.json +47 -0
  200. package/kits/resend-email/files/AGENTS.md +7 -0
  201. package/kits/resend-email/files/docs/resend-email.md +13 -0
  202. package/kits/resend-email/files/files/src/kits/resend-email/README.md +17 -0
  203. package/kits/resend-email/files/files/src/kits/resend-email/send-email.ts +44 -0
  204. package/kits/resend-email/files/kit.json +128 -0
  205. package/kits/resend-email/files/skills/resend-email/SKILL.md +20 -0
  206. package/kits/resend-email/files/tests/resend-email.test.ts +54 -0
  207. package/kits/resend-email/kit.json +159 -0
  208. package/modules/docs/templates/astro-emdash/content/docs/getting-started.mdx +13 -0
  209. package/modules/docs/templates/astro-emdash/content/docs/index.mdx +13 -0
  210. package/modules/docs/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  211. package/modules/docs/templates/astro-emdash/content/docs/meta.json +4 -0
  212. package/modules/docs/templates/astro-emdash/site/content/docs/getting-started.mdx +12 -0
  213. package/modules/docs/templates/astro-emdash/site/content/docs/index.mdx +12 -0
  214. package/modules/docs/templates/astro-emdash/site/content/docs/mcp.mdx +10 -0
  215. package/modules/docs/templates/astro-emdash/site/content/docs/meta.json +4 -0
  216. package/modules/docs/templates/astro-emdash/site/source.config.ts +10 -0
  217. package/modules/docs/templates/astro-emdash/site/src/docs/docs-assets.ts +1 -0
  218. package/modules/docs/templates/astro-emdash/site/src/docs/docs-client.tsx +22 -0
  219. package/modules/docs/templates/astro-emdash/site/src/docs/docs-data.ts +24 -0
  220. package/modules/docs/templates/astro-emdash/site/src/docs/docs-handler.tsx +105 -0
  221. package/modules/docs/templates/astro-emdash/site/src/docs/docs-layout.tsx +56 -0
  222. package/modules/docs/templates/astro-emdash/site/src/docs/docs-mdx.tsx +79 -0
  223. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page-actions.tsx +146 -0
  224. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page.tsx +70 -0
  225. package/modules/docs/templates/astro-emdash/site/src/docs/llm-text.ts +61 -0
  226. package/modules/docs/templates/astro-emdash/site/src/docs/source.ts +7 -0
  227. package/modules/docs/templates/astro-emdash/site/src/pages/docs/[...slug].ts +6 -0
  228. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/markdown.ts +4 -0
  229. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/search.ts +4 -0
  230. package/modules/docs/templates/astro-emdash/site/src/pages/llms.txt.ts +8 -0
  231. package/modules/docs/templates/astro-emdash/site/src/styles-docs.css +3 -0
  232. package/modules/docs/templates/astro-emdash/source.config.ts +10 -0
  233. package/modules/docs/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  234. package/modules/docs/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  235. package/modules/docs/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  236. package/modules/docs/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  237. package/modules/docs/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  238. package/modules/docs/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  239. package/modules/docs/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  240. package/modules/docs/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  241. package/modules/docs/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  242. package/modules/docs/templates/astro-emdash/src/docs/source.ts +7 -0
  243. package/modules/docs/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  244. package/modules/docs/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  245. package/modules/docs/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  246. package/modules/docs/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  247. package/modules/docs/templates/astro-emdash/src/routes/docs.tsx +22 -0
  248. package/modules/docs/templates/astro-emdash/src/styles-docs.css +3 -0
  249. package/modules/docs/templates/react-router/app/components/mdx.tsx +79 -0
  250. package/modules/docs/templates/react-router/app/lib/layout.shared.tsx +54 -0
  251. package/modules/docs/templates/react-router/app/lib/source.ts +7 -0
  252. package/modules/docs/templates/react-router/app/routes/docs.$.tsx +49 -0
  253. package/modules/docs/templates/react-router/app/routes/docs.api.search.ts +10 -0
  254. package/modules/docs/templates/react-router/app/routes/docs.tsx +13 -0
  255. package/modules/docs/templates/react-router/content/docs/getting-started.mdx +8 -0
  256. package/modules/docs/templates/react-router/content/docs/index.mdx +8 -0
  257. package/modules/docs/templates/react-router/content/docs/mcp.mdx +121 -0
  258. package/modules/docs/templates/react-router/content/docs/meta.json +4 -0
  259. package/modules/docs/templates/react-router/source.config.ts +5 -0
  260. package/modules/docs/templates/tanstack-start/content/docs/getting-started.mdx +10 -0
  261. package/modules/docs/templates/tanstack-start/content/docs/index.mdx +8 -0
  262. package/modules/docs/templates/tanstack-start/content/docs/mcp.mdx +121 -0
  263. package/modules/docs/templates/tanstack-start/content/docs/meta.json +4 -0
  264. package/modules/docs/templates/tanstack-start/source.config.ts +10 -0
  265. package/modules/docs/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  266. package/modules/docs/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  267. package/modules/docs/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  268. package/modules/docs/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  269. package/modules/docs/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  270. package/modules/docs/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  271. package/modules/docs/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  272. package/modules/docs/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  273. package/modules/docs/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  274. package/modules/docs/templates/tanstack-start/src/docs/source.ts +7 -0
  275. package/modules/docs/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  276. package/modules/docs/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  277. package/modules/docs/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  278. package/modules/docs/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  279. package/modules/docs/templates/tanstack-start/src/routes/docs.tsx +22 -0
  280. package/modules/docs/templates/tanstack-start/src/styles-docs.css +3 -0
  281. package/modules/guide/templates/astro-emdash/content/guide/capability-map.md +17 -0
  282. package/modules/guide/templates/astro-emdash/src/components/guide-widget.tsx +41 -0
  283. package/modules/guide/templates/astro-emdash/src/guide/actions.ts +8 -0
  284. package/modules/guide/templates/astro-emdash/src/guide/config.ts +21 -0
  285. package/modules/guide/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  286. package/modules/guide/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  287. package/modules/guide/templates/astro-emdash/src/guide/corpus.ts +4 -0
  288. package/modules/guide/templates/astro-emdash/src/guide/resources.json +4 -0
  289. package/modules/guide/templates/react-router/app/components/guide-widget.tsx +29 -0
  290. package/modules/guide/templates/react-router/app/guide/actions.ts +3 -0
  291. package/modules/guide/templates/react-router/app/guide/config.ts +21 -0
  292. package/modules/guide/templates/react-router/app/guide/corpus.gen.ts +4 -0
  293. package/modules/guide/templates/react-router/app/guide/corpus.manifest.json +22 -0
  294. package/modules/guide/templates/react-router/app/guide/corpus.ts +4 -0
  295. package/modules/guide/templates/react-router/app/guide/resources.json +4 -0
  296. package/modules/guide/templates/react-router/content/guide/capability-map.md +13 -0
  297. package/modules/guide/templates/tanstack-start/content/guide/capability-map.md +17 -0
  298. package/modules/guide/templates/tanstack-start/src/components/guide-widget.tsx +41 -0
  299. package/modules/guide/templates/tanstack-start/src/guide/actions.ts +17 -0
  300. package/modules/guide/templates/tanstack-start/src/guide/config.ts +21 -0
  301. package/modules/guide/templates/tanstack-start/src/guide/corpus.gen.ts +4 -0
  302. package/modules/guide/templates/tanstack-start/src/guide/corpus.manifest.json +22 -0
  303. package/modules/guide/templates/tanstack-start/src/guide/corpus.ts +4 -0
  304. package/modules/guide/templates/tanstack-start/src/guide/resources.json +4 -0
  305. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  306. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  307. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  308. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  309. package/modules/openai-subscription/templates/astro-emdash/src/openai-subscription.ts +11 -0
  310. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  311. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  312. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  313. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  314. package/modules/openai-subscription/templates/react-router/app/openai-subscription.ts +11 -0
  315. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  316. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  317. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  318. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  319. package/modules/openai-subscription/templates/tanstack-start/src/openai-subscription.ts +11 -0
  320. package/package.json +34 -8
  321. package/README.md +0 -3
@@ -0,0 +1,162 @@
1
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
2
+ import { dirname, join } from "node:path";
3
+ import { stableJson } from "./kit-manifest.js";
4
+ const firstPartyModulePackages = {
5
+ docs: "@raybase/docs",
6
+ guide: "@raybase/guide",
7
+ api: "@raybase/api",
8
+ "openai-subscription": "@raybase/openai-subscription"
9
+ };
10
+ export function inferFirstPartyModuleFileMode(id, template, path) {
11
+ if (id === "docs") {
12
+ if (path.startsWith("content/docs/") || path.startsWith("site/content/docs/"))
13
+ return "editable";
14
+ return "copy";
15
+ }
16
+ if (id === "guide") {
17
+ const guideRoot = template === "react-router" ? "app/guide" : "src/guide";
18
+ if (path === `${guideRoot}/actions.ts` || path === `${guideRoot}/resources.json` || path === `${guideRoot}/config.ts` || path === "content/guide/capability-map.md")
19
+ return "editable";
20
+ if (path === `${guideRoot}/corpus.manifest.json`)
21
+ return "generated";
22
+ return "copy";
23
+ }
24
+ return "copy";
25
+ }
26
+ export function moduleFileMode(installed, file) {
27
+ const inferred = inferFirstPartyModuleFileMode(installed.id, installed.template, file.path);
28
+ if (inferred !== "copy")
29
+ return inferred;
30
+ return file.mode === "editable" || file.mode === "generated" ? file.mode : "copy";
31
+ }
32
+ export function normalizedInstalledModuleFile(installed, file) {
33
+ return {
34
+ ...file,
35
+ mode: moduleFileMode(installed, file)
36
+ };
37
+ }
38
+ export function normalizedInstalledModuleLock(installed) {
39
+ return {
40
+ ...installed,
41
+ placement: installed.id === "docs" ? installed.placement ?? "spine" : installed.placement,
42
+ files: installed.files.map((file) => normalizedInstalledModuleFile(installed, file))
43
+ };
44
+ }
45
+ export function moduleLockPath(projectRoot) {
46
+ return join(projectRoot, ".raybase/modules.json");
47
+ }
48
+ export function readModuleLock(projectRoot) {
49
+ const file = moduleLockPath(projectRoot);
50
+ if (!existsSync(file))
51
+ return null;
52
+ const parsed = JSON.parse(readFileSync(file, "utf8"));
53
+ if (Number(parsed.schemaVersion) > 1)
54
+ throw new Error(".raybase/modules.json schemaVersion is newer than this raybase CLI. Upgrade raybase.");
55
+ if (parsed.schemaVersion !== 1 || !parsed.modules || typeof parsed.modules !== "object") {
56
+ throw new Error(".raybase/modules.json is not a valid Raybase Modules lock file.");
57
+ }
58
+ for (const [id, installed] of Object.entries(parsed.modules)) {
59
+ if (id !== "docs" && id !== "guide" && id !== "api" && id !== "openai-subscription")
60
+ continue;
61
+ if (installed.id !== id || !installed.packageName || !Array.isArray(installed.files)) {
62
+ throw new Error(".raybase/modules.json is not a valid Raybase Modules lock file.");
63
+ }
64
+ parsed.modules[id] = normalizedInstalledModuleLock(installed);
65
+ }
66
+ return parsed;
67
+ }
68
+ export function readModulePackageJson(projectRoot) {
69
+ const file = join(projectRoot, "package.json");
70
+ if (!existsSync(file))
71
+ throw new Error("package.json is missing; Raybase module declarations cannot be resolved.");
72
+ let parsed;
73
+ try {
74
+ parsed = JSON.parse(readFileSync(file, "utf8"));
75
+ }
76
+ catch (error) {
77
+ throw new Error(`package.json is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
78
+ }
79
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
80
+ throw new Error("package.json must contain a JSON object.");
81
+ }
82
+ const packageJson = parsed;
83
+ const raybase = packageJson.raybase;
84
+ if (raybase !== undefined && (!raybase || typeof raybase !== "object" || Array.isArray(raybase))) {
85
+ throw new Error("package.json raybase must be an object.");
86
+ }
87
+ const modules = raybase?.modules;
88
+ if (modules !== undefined && (!modules || typeof modules !== "object" || Array.isArray(modules))) {
89
+ throw new Error("package.json raybase.modules must be an object.");
90
+ }
91
+ return packageJson;
92
+ }
93
+ export function packageModuleDeclaration(packageJson, id) {
94
+ const modules = packageJson.raybase?.modules;
95
+ if (!modules || !Object.prototype.hasOwnProperty.call(modules, id))
96
+ return { declared: false, declaration: null };
97
+ const value = modules[id];
98
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
99
+ throw moduleDeclarationError(id, "must be an object");
100
+ }
101
+ const declaration = value;
102
+ if (declaration.enabled !== undefined && typeof declaration.enabled !== "boolean") {
103
+ throw moduleDeclarationError(id, 'enabled must be true or false');
104
+ }
105
+ if (declaration.package !== undefined && (typeof declaration.package !== "string" || !declaration.package.trim())) {
106
+ throw moduleDeclarationError(id, "package must be a non-empty package name");
107
+ }
108
+ if (declaration.integration !== undefined && declaration.integration !== "installed" && declaration.integration !== "runtime") {
109
+ throw moduleDeclarationError(id, 'integration must be "installed" or "runtime"');
110
+ }
111
+ if (declaration.placement !== undefined && declaration.placement !== "spine" && declaration.placement !== "site") {
112
+ throw moduleDeclarationError(id, 'placement must be "spine" or "site"');
113
+ }
114
+ return { declared: true, declaration: declaration };
115
+ }
116
+ export function resolveFirstPartyModuleState(projectRoot, id, options = {}) {
117
+ const lock = options.lock === undefined ? readModuleLock(projectRoot) : options.lock;
118
+ const packageJson = options.packageJson ?? readModulePackageJson(projectRoot);
119
+ const installed = lock?.modules[id] ?? null;
120
+ const { declared, declaration } = packageModuleDeclaration(packageJson, id);
121
+ if (installed && declaration?.integration === "runtime") {
122
+ throw moduleDeclarationError(id, 'integration is "runtime", but .raybase/modules.json records an exact scaffold installation; remove the runtime declaration or remove the installed module with raybase modules remove');
123
+ }
124
+ const integration = installed ? "installed" : declaration?.integration ?? "installed";
125
+ return {
126
+ id,
127
+ declared,
128
+ declaration,
129
+ enabled: installed ? installed.enabled === true : declaration?.enabled === true,
130
+ packageName: installed?.packageName ?? declaration?.package ?? firstPartyModulePackages[id],
131
+ integration,
132
+ installed,
133
+ exactInstallLock: Boolean(installed)
134
+ };
135
+ }
136
+ export function packageProductionDependencies(packageJson) {
137
+ if (!packageJson.dependencies || typeof packageJson.dependencies !== "object" || Array.isArray(packageJson.dependencies))
138
+ return {};
139
+ return Object.fromEntries(Object.entries(packageJson.dependencies).filter((entry) => typeof entry[1] === "string"));
140
+ }
141
+ export function packageAllDependencies(packageJson) {
142
+ const devDependencies = packageJson.devDependencies && typeof packageJson.devDependencies === "object" && !Array.isArray(packageJson.devDependencies)
143
+ ? Object.fromEntries(Object.entries(packageJson.devDependencies).filter((entry) => typeof entry[1] === "string"))
144
+ : {};
145
+ return { ...packageProductionDependencies(packageJson), ...devDependencies };
146
+ }
147
+ function moduleDeclarationError(id, message) {
148
+ return new Error(`package.json raybase.modules[${JSON.stringify(id)}] ${message}.`);
149
+ }
150
+ export function writeModuleLock(projectRoot, lock) {
151
+ const file = moduleLockPath(projectRoot);
152
+ mkdirSync(dirname(file), { recursive: true });
153
+ writeFileSync(file, stableJson(lock));
154
+ }
155
+ export function emptyModuleLock(now = new Date()) {
156
+ return {
157
+ schemaVersion: 1,
158
+ updatedAt: now.toISOString(),
159
+ modules: {}
160
+ };
161
+ }
162
+ //# sourceMappingURL=module-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"module-state.js","sourceRoot":"","sources":["../src/module-state.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ import { doctorModules, type ModuleDoctorResult } from "./module-doctor.js";
2
+ import { firstPartyModuleEnabled, installFirstPartyModule, removeFirstPartyModule, setFirstPartyModuleEnabled, updateFirstPartyModules, type ModuleInstallResult, type ModuleRemoveResult, type ModuleUpdateResult } from "./module-install.js";
3
+ import { parseFirstPartyModuleId } from "./module-manifest.js";
4
+ import { type DocsPlacement, type FirstPartyModuleId, type ModuleIntegration } from "./module-state.js";
5
+ import type { FrameworkKind } from "./frameworks.js";
6
+ export { doctorModules, firstPartyModuleEnabled, installFirstPartyModule, parseFirstPartyModuleId, removeFirstPartyModule, setFirstPartyModuleEnabled, updateFirstPartyModules };
7
+ export type { FirstPartyModuleId };
8
+ export type ModuleStatusResult = {
9
+ ok: true;
10
+ projectDir: string;
11
+ lockFile: string;
12
+ source: "modules-lock" | "package-json-fallback" | "none";
13
+ modules: Array<{
14
+ id: FirstPartyModuleId;
15
+ packageName: string;
16
+ version: string | null;
17
+ enabled: boolean;
18
+ installed: boolean;
19
+ integration: ModuleIntegration;
20
+ files: number;
21
+ updatedAt: string | null;
22
+ skills: string[];
23
+ commands: string[];
24
+ }>;
25
+ warnings: string[];
26
+ };
27
+ export declare function moduleStatus(projectRoot: string): ModuleStatusResult;
28
+ export declare function addModule(projectRoot: string, options: {
29
+ id: FirstPartyModuleId;
30
+ template: FrameworkKind;
31
+ dryRun?: boolean;
32
+ overwrite?: boolean;
33
+ placement?: DocsPlacement;
34
+ }): ModuleInstallResult;
35
+ export declare function updateModules(projectRoot: string, options: {
36
+ modules?: FirstPartyModuleId[];
37
+ template: FrameworkKind;
38
+ dryRun?: boolean;
39
+ overwrite?: boolean;
40
+ }): ModuleUpdateResult;
41
+ export declare function removeModule(projectRoot: string, options: {
42
+ id: FirstPartyModuleId;
43
+ dryRun?: boolean;
44
+ force?: boolean;
45
+ }): ModuleRemoveResult;
46
+ export declare function doctorInstalledModules(projectRoot: string, options: Parameters<typeof doctorModules>[1]): ModuleDoctorResult;
47
+ export declare function formatModuleStatus(result: ModuleStatusResult): string;
48
+ export declare function formatModuleInstall(result: ModuleInstallResult): string;
49
+ export declare function formatModuleUpdate(result: ModuleUpdateResult): string;
50
+ export declare function formatModuleRemove(result: ModuleRemoveResult): string;
51
+ export declare function formatModuleDoctor(result: ModuleDoctorResult): string;
52
+ //# sourceMappingURL=modules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../src/modules.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,110 @@
1
+ import { doctorModules } from "./module-doctor.js";
2
+ import { firstPartyModuleEnabled, installFirstPartyModule, removeFirstPartyModule, setFirstPartyModuleEnabled, updateFirstPartyModules } from "./module-install.js";
3
+ import { FIRST_PARTY_MODULE_IDS, firstPartyModuleManifests, parseFirstPartyModuleId } from "./module-manifest.js";
4
+ import { moduleLockPath, readModuleLock, readModulePackageJson, resolveFirstPartyModuleState } from "./module-state.js";
5
+ export { doctorModules, firstPartyModuleEnabled, installFirstPartyModule, parseFirstPartyModuleId, removeFirstPartyModule, setFirstPartyModuleEnabled, updateFirstPartyModules };
6
+ export function moduleStatus(projectRoot) {
7
+ const lock = readModuleLock(projectRoot);
8
+ const packageJson = readModulePackageJson(projectRoot);
9
+ return {
10
+ ok: true,
11
+ projectDir: projectRoot,
12
+ lockFile: moduleLockPath(projectRoot),
13
+ source: lock ? "modules-lock" : packageJson.raybase?.modules ? "package-json-fallback" : "none",
14
+ modules: FIRST_PARTY_MODULE_IDS.map((id) => statusFromResolved(resolveFirstPartyModuleState(projectRoot, id, { lock, packageJson }))),
15
+ warnings: []
16
+ };
17
+ }
18
+ export function addModule(projectRoot, options) {
19
+ return installFirstPartyModule(projectRoot, options);
20
+ }
21
+ export function updateModules(projectRoot, options) {
22
+ return updateFirstPartyModules(projectRoot, options);
23
+ }
24
+ export function removeModule(projectRoot, options) {
25
+ return removeFirstPartyModule(projectRoot, options);
26
+ }
27
+ export function doctorInstalledModules(projectRoot, options) {
28
+ return doctorModules(projectRoot, options);
29
+ }
30
+ export function formatModuleStatus(result) {
31
+ if (!result.modules.some((module) => module.installed || module.enabled))
32
+ return "No Raybase modules are installed.";
33
+ return result.modules
34
+ .map((module) => {
35
+ const state = module.enabled && module.integration === "runtime" ? "runtime-registered" : module.enabled ? "enabled" : module.installed ? "disabled" : "not installed";
36
+ return `${module.id}: ${state}${module.version ? ` (${module.packageName}@${module.version})` : ` (${module.packageName})`} files=${module.files}`;
37
+ })
38
+ .join("\n");
39
+ }
40
+ export function formatModuleInstall(result) {
41
+ return [
42
+ `${result.dryRun ? "Planned" : "Installed"} ${result.module}@${result.version}.`,
43
+ "",
44
+ result.dryRun ? "Files to add:" : "Changed files:",
45
+ ...(result.changedFiles.length ? result.changedFiles.map((file) => ` ${file}`) : [" none"]),
46
+ "",
47
+ "Plan:",
48
+ ...(result.plan.length ? result.plan.map((entry) => ` ${entry.status} ${entry.action}${entry.target ? ` ${entry.target}` : ""}`) : [" none"]),
49
+ "",
50
+ "Next steps:",
51
+ ...result.nextSteps.map((step) => ` ${step}`)
52
+ ].join("\n");
53
+ }
54
+ export function formatModuleUpdate(result) {
55
+ if (!result.updates.length)
56
+ return result.warnings[0] ?? "No Raybase modules are installed.";
57
+ return result.updates
58
+ .map((update) => {
59
+ const suffix = update.latestVersion ? ` -> ${update.latestVersion}` : "";
60
+ const conflicts = update.conflicts.length ? `\n${update.conflicts.map((conflict) => ` - ${conflict}`).join("\n")}` : "";
61
+ const warnings = update.warnings.length ? `\n${update.warnings.map((warning) => ` - ${warning}`).join("\n")}` : "";
62
+ return `${update.module}: ${update.status} (${update.currentVersion}${suffix})${conflicts}${warnings}`;
63
+ })
64
+ .join("\n");
65
+ }
66
+ export function formatModuleRemove(result) {
67
+ if (!result.removed && result.warnings.length)
68
+ return result.warnings.join("\n");
69
+ return [
70
+ `${result.dryRun ? "Planned removal for" : "Removed"} ${result.module}.`,
71
+ result.conflicts.length ? `Conflicts:\n${result.conflicts.map((conflict) => ` - ${conflict}`).join("\n")}` : null,
72
+ "",
73
+ "Removed files:",
74
+ ...(result.removedFiles.length ? result.removedFiles.map((file) => ` ${file}`) : [" none"]),
75
+ "",
76
+ "Plan:",
77
+ ...(result.plan.length ? result.plan.map((entry) => ` ${entry.status} ${entry.action}${entry.target ? ` ${entry.target}` : ""}`) : [" none"]),
78
+ "",
79
+ "Next steps:",
80
+ ...result.nextSteps.map((step) => ` ${step}`)
81
+ ]
82
+ .filter((line) => line !== null)
83
+ .join("\n");
84
+ }
85
+ export function formatModuleDoctor(result) {
86
+ if (!result.issues.length)
87
+ return "raybase modules doctor passed.";
88
+ return result.issues
89
+ .map((issue) => issue.level === "info"
90
+ ? `info ${issue.check}: ${issue.message}`
91
+ : `[${issue.level.toUpperCase()}] ${issue.check}: ${issue.message}\nFix: ${issue.fix}`)
92
+ .join("\n");
93
+ }
94
+ function statusFromResolved(state) {
95
+ const manifest = firstPartyModuleManifests[state.id];
96
+ const installed = state.installed;
97
+ return {
98
+ id: state.id,
99
+ packageName: state.packageName,
100
+ version: installed?.version ?? null,
101
+ enabled: state.enabled,
102
+ installed: state.integration === "installed" && (state.exactInstallLock || state.enabled),
103
+ integration: state.integration,
104
+ files: installed?.files.length ?? 0,
105
+ updatedAt: installed?.updatedAt ?? null,
106
+ skills: installed?.skills ?? manifest.skills,
107
+ commands: installed?.commands ?? manifest.commands
108
+ };
109
+ }
110
+ //# sourceMappingURL=modules.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"modules.js","sourceRoot":"","sources":["../src/modules.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,42 @@
1
+ export type Rgb = {
2
+ r: number;
3
+ g: number;
4
+ b: number;
5
+ };
6
+ export type PairResult = {
7
+ label: string;
8
+ wcag: number | null;
9
+ wcagThreshold: number;
10
+ wcagPass: boolean;
11
+ advisory?: boolean;
12
+ apca: number | null;
13
+ skipped?: string;
14
+ };
15
+ export type SchemeResult = {
16
+ scheme: "light" | "dark";
17
+ pairs: PairResult[];
18
+ failures: number;
19
+ };
20
+ export type PaletteResult = {
21
+ palette: string;
22
+ schemes: SchemeResult[];
23
+ failures: number;
24
+ };
25
+ export type PaletteCheckResult = {
26
+ ok: boolean;
27
+ path: string | null;
28
+ palettes: PaletteResult[];
29
+ warnings: string[];
30
+ };
31
+ export declare function formatPaletteCheck(result: PaletteCheckResult): string;
32
+ export declare function checkProjectPalettes(projectRoot: string): PaletteCheckResult;
33
+ export declare function checkPaletteCss(css: string): Omit<PaletteCheckResult, "path">;
34
+ export declare function parseColor(value: string): Rgb | null;
35
+ export declare function oklchToRgb(oklch: {
36
+ l: number;
37
+ c: number;
38
+ h: number;
39
+ }): Rgb;
40
+ export declare function wcagContrast(a: Rgb, b: Rgb): number;
41
+ export declare function apcaContrast(text: Rgb, bg: Rgb): number;
42
+ //# sourceMappingURL=palette-check.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"palette-check.d.ts","sourceRoot":"","sources":["../src/palette-check.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,GAAG,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAoBtD,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/F,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3F,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAErH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuBrE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAO5E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAyB7E;AAuCD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CASpD;AA0BD,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,CAc1E;AAiBD,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAMnD;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,GAAG,MAAM,CAmBvD"}
@@ -0,0 +1,217 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ // Text pairs need WCAG AA (4.5:1) and are gated. border-vs-background is
4
+ // non-text UI: WCAG 1.4.11 wants 3:1 for *essential* boundaries, but ordinary
5
+ // decorative borders sit far below that by design, so it is reported as an
6
+ // advisory (3:1 target) rather than a hard failure.
7
+ const TOKEN_PAIRS = [
8
+ { fg: "foreground", bg: "background", label: "background/foreground", wcag: 4.5, text: true },
9
+ { fg: "card-foreground", bg: "card", label: "card/card-foreground", wcag: 4.5, text: true },
10
+ { fg: "popover-foreground", bg: "popover", label: "popover/popover-foreground", wcag: 4.5, text: true },
11
+ { fg: "primary-foreground", bg: "primary", label: "primary/primary-foreground", wcag: 4.5, text: true },
12
+ { fg: "secondary-foreground", bg: "secondary", label: "secondary/secondary-foreground", wcag: 4.5, text: true },
13
+ { fg: "muted-foreground", bg: "muted", label: "muted/muted-foreground", wcag: 4.5, text: true },
14
+ { fg: "accent-foreground", bg: "accent", label: "accent/accent-foreground", wcag: 4.5, text: true },
15
+ { fg: "destructive-foreground", bg: "destructive", label: "destructive/destructive-foreground", wcag: 4.5, text: true },
16
+ { fg: "border", bg: "background", label: "border vs background", wcag: 3, text: false, advisory: true }
17
+ ];
18
+ export function formatPaletteCheck(result) {
19
+ const lines = [];
20
+ for (const warning of result.warnings)
21
+ lines.push(`Warning: ${warning}`);
22
+ for (const palette of result.palettes) {
23
+ lines.push(`${palette.palette}: ${palette.failures === 0 ? "PASS" : `${palette.failures} contrast failure(s)`}`);
24
+ for (const scheme of palette.schemes) {
25
+ for (const pair of scheme.pairs) {
26
+ if (pair.skipped) {
27
+ lines.push(` [${scheme.scheme}] ${pair.label}: skipped (${pair.skipped})`);
28
+ continue;
29
+ }
30
+ if (pair.advisory) {
31
+ const advisoryMark = (pair.wcag ?? 0) >= pair.wcagThreshold ? "✓" : "◐";
32
+ lines.push(` [${scheme.scheme}] ${pair.label}: WCAG ${pair.wcag}:1 ${advisoryMark} advisory (target ${pair.wcagThreshold}:1) · APCA Lc ${pair.apca}`);
33
+ continue;
34
+ }
35
+ const mark = pair.wcagPass ? "✓" : "✗";
36
+ lines.push(` [${scheme.scheme}] ${pair.label}: WCAG ${pair.wcag}:1 ${mark} (need ${pair.wcagThreshold}:1) · APCA Lc ${pair.apca}`);
37
+ }
38
+ }
39
+ }
40
+ if (!result.palettes.length && !result.warnings.length)
41
+ lines.push("No palettes to check.");
42
+ return lines.join("\n");
43
+ }
44
+ export function checkProjectPalettes(projectRoot) {
45
+ const rel = "site/src/styles/palettes.gen.css";
46
+ const path = join(projectRoot, rel);
47
+ if (!existsSync(path)) {
48
+ return { ok: true, path: null, palettes: [], warnings: [`No generated palette CSS at ${rel}; run raybase templates theme add first.`] };
49
+ }
50
+ return { ...checkPaletteCss(readFileSync(path, "utf8")), path: rel };
51
+ }
52
+ export function checkPaletteCss(css) {
53
+ const blocks = parsePaletteBlocks(css);
54
+ const byPalette = new Map();
55
+ for (const block of blocks) {
56
+ const entry = byPalette.get(block.palette) ?? {};
57
+ entry[block.dark ? "dark" : "light"] = block.tokens;
58
+ byPalette.set(block.palette, entry);
59
+ }
60
+ const warnings = [];
61
+ const palettes = [];
62
+ for (const [palette, entry] of byPalette) {
63
+ const schemes = [];
64
+ // A palette with only a base block (no .dark) is single-scheme; check it once.
65
+ const targets = [];
66
+ if (entry.light)
67
+ targets.push({ scheme: "light", tokens: entry.light });
68
+ if (entry.dark)
69
+ targets.push({ scheme: "dark", tokens: entry.dark });
70
+ for (const target of targets) {
71
+ const pairs = TOKEN_PAIRS.map((pair) => evaluatePair(pair, target.tokens));
72
+ schemes.push({ scheme: target.scheme, pairs, failures: pairs.filter((pair) => pair.wcagPass === false).length });
73
+ }
74
+ palettes.push({ palette, schemes, failures: schemes.reduce((sum, scheme) => sum + scheme.failures, 0) });
75
+ }
76
+ if (!palettes.length)
77
+ warnings.push("No [data-palette] blocks found in the palette CSS.");
78
+ return { ok: palettes.every((palette) => palette.failures === 0), palettes, warnings };
79
+ }
80
+ function evaluatePair(pair, tokens) {
81
+ const fg = tokens.get(pair.fg);
82
+ const bg = tokens.get(pair.bg);
83
+ const fgRgb = fg ? parseColor(fg) : null;
84
+ const bgRgb = bg ? parseColor(bg) : null;
85
+ if (!fgRgb || !bgRgb) {
86
+ return { label: pair.label, wcag: null, wcagThreshold: pair.wcag, wcagPass: true, apca: null, skipped: !fg || !bg ? "missing token" : "unparseable color" };
87
+ }
88
+ const wcag = round(wcagContrast(fgRgb, bgRgb), 2);
89
+ const apca = round(apcaContrast(fgRgb, bgRgb), 1);
90
+ // Advisory pairs (decorative borders) report their ratio but never fail the gate.
91
+ const wcagPass = pair.advisory ? true : wcag >= pair.wcag;
92
+ return { label: pair.label, wcag, wcagThreshold: pair.wcag, wcagPass, ...(pair.advisory ? { advisory: true } : {}), apca };
93
+ }
94
+ function parsePaletteBlocks(css) {
95
+ const blocks = [];
96
+ const selectorRe = /\[data-palette="([^"]+)"\](\.dark)?\s*\{([^}]*)\}/g;
97
+ let match;
98
+ while ((match = selectorRe.exec(css)) !== null) {
99
+ const tokens = new Map();
100
+ for (const decl of match[3].split(";")) {
101
+ const colon = decl.indexOf(":");
102
+ if (colon < 0)
103
+ continue;
104
+ const name = decl.slice(0, colon).trim();
105
+ if (!name.startsWith("--"))
106
+ continue;
107
+ tokens.set(name.slice(2), decl.slice(colon + 1).trim());
108
+ }
109
+ blocks.push({ palette: match[1], dark: Boolean(match[2]), tokens });
110
+ }
111
+ return blocks;
112
+ }
113
+ // --- Color parsing + contrast -------------------------------------------------
114
+ export function parseColor(value) {
115
+ const trimmed = value.trim();
116
+ const oklch = parseOklch(trimmed);
117
+ if (oklch)
118
+ return oklchToRgb(oklch);
119
+ const hex = parseHex(trimmed);
120
+ if (hex)
121
+ return hex;
122
+ const rgb = parseRgb(trimmed);
123
+ if (rgb)
124
+ return rgb;
125
+ return null;
126
+ }
127
+ function parseOklch(value) {
128
+ const match = value.match(/^oklch\(\s*([0-9.]+%?)\s+([0-9.]+)\s+([0-9.]+)/i);
129
+ if (!match)
130
+ return null;
131
+ const l = match[1].endsWith("%") ? Number.parseFloat(match[1]) / 100 : Number.parseFloat(match[1]);
132
+ const c = Number.parseFloat(match[2]);
133
+ const h = Number.parseFloat(match[3]);
134
+ if ([l, c, h].some((component) => Number.isNaN(component)))
135
+ return null;
136
+ return { l, c, h };
137
+ }
138
+ function parseHex(value) {
139
+ const match = value.match(/^#([0-9a-f]{3}|[0-9a-f]{6})$/i);
140
+ if (!match)
141
+ return null;
142
+ const hex = match[1].length === 3 ? match[1].split("").map((char) => char + char).join("") : match[1];
143
+ return { r: parseInt(hex.slice(0, 2), 16), g: parseInt(hex.slice(2, 4), 16), b: parseInt(hex.slice(4, 6), 16) };
144
+ }
145
+ function parseRgb(value) {
146
+ const match = value.match(/^rgba?\(\s*([0-9.]+)[,\s]+([0-9.]+)[,\s]+([0-9.]+)/i);
147
+ if (!match)
148
+ return null;
149
+ return { r: Number.parseFloat(match[1]), g: Number.parseFloat(match[2]), b: Number.parseFloat(match[3]) };
150
+ }
151
+ // OKLCH -> sRGB (Björn Ottosson's OKLab), ported from the lab's palette machinery.
152
+ export function oklchToRgb(oklch) {
153
+ const a = oklch.c * Math.cos((oklch.h * Math.PI) / 180);
154
+ const b = oklch.c * Math.sin((oklch.h * Math.PI) / 180);
155
+ const lPrime = oklch.l + 0.3963377774 * a + 0.2158037573 * b;
156
+ const mPrime = oklch.l - 0.1055613458 * a - 0.0638541728 * b;
157
+ const sPrime = oklch.l - 0.0894841775 * a - 1.291485548 * b;
158
+ const l = lPrime ** 3;
159
+ const m = mPrime ** 3;
160
+ const s = sPrime ** 3;
161
+ return {
162
+ r: clamp255(255 * linearToSrgb(4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s)),
163
+ g: clamp255(255 * linearToSrgb(-1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s)),
164
+ b: clamp255(255 * linearToSrgb(-0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s))
165
+ };
166
+ }
167
+ function linearToSrgb(value) {
168
+ return value <= 0.0031308 ? value * 12.92 : 1.055 * value ** (1 / 2.4) - 0.055;
169
+ }
170
+ function srgbToLinear(value) {
171
+ return value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
172
+ }
173
+ function relativeLuminance(rgb) {
174
+ const r = srgbToLinear(rgb.r / 255);
175
+ const g = srgbToLinear(rgb.g / 255);
176
+ const b = srgbToLinear(rgb.b / 255);
177
+ return 0.2126 * r + 0.7152 * g + 0.0722 * b;
178
+ }
179
+ export function wcagContrast(a, b) {
180
+ const la = relativeLuminance(a);
181
+ const lb = relativeLuminance(b);
182
+ const lighter = Math.max(la, lb);
183
+ const darker = Math.min(la, lb);
184
+ return (lighter + 0.05) / (darker + 0.05);
185
+ }
186
+ // APCA 0.1.9 (advisory Lc). Positive polarity = dark text on light; the sign is
187
+ // dropped for the advisory magnitude.
188
+ export function apcaContrast(text, bg) {
189
+ const mainTRC = 2.4;
190
+ const apcaY = (rgb) => 0.2126729 * (rgb.r / 255) ** mainTRC + 0.7151522 * (rgb.g / 255) ** mainTRC + 0.072175 * (rgb.b / 255) ** mainTRC;
191
+ const blkThrs = 0.022;
192
+ const blkClmp = 1.414;
193
+ let txtY = apcaY(text);
194
+ let bgY = apcaY(bg);
195
+ txtY = txtY > blkThrs ? txtY : txtY + (blkThrs - txtY) ** blkClmp;
196
+ bgY = bgY > blkThrs ? bgY : bgY + (blkThrs - bgY) ** blkClmp;
197
+ if (Math.abs(bgY - txtY) < 0.0005)
198
+ return 0;
199
+ let output;
200
+ if (bgY > txtY) {
201
+ const sapc = (bgY ** 0.56 - txtY ** 0.57) * 1.14;
202
+ output = sapc < 0.1 ? 0 : sapc - 0.027;
203
+ }
204
+ else {
205
+ const sapc = (bgY ** 0.65 - txtY ** 0.62) * 1.14;
206
+ output = sapc > -0.1 ? 0 : sapc + 0.027;
207
+ }
208
+ return Math.abs(output * 100);
209
+ }
210
+ function clamp255(value) {
211
+ return Math.min(255, Math.max(0, Math.round(value)));
212
+ }
213
+ function round(value, digits) {
214
+ const factor = 10 ** digits;
215
+ return Math.round(value * factor) / factor;
216
+ }
217
+ //# sourceMappingURL=palette-check.js.map