@iksnerd/blazon 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (503) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +259 -2
  3. package/THIRD-PARTY-NOTICES.md +60 -0
  4. package/bin/blazon.js +4 -0
  5. package/dist/builder/site-builder.d.ts +10 -0
  6. package/dist/builder/site-builder.d.ts.map +1 -0
  7. package/dist/chunks/site-builder-CPfjBOmR.js +13804 -0
  8. package/dist/cli/commands/approvals.d.ts +8 -0
  9. package/dist/cli/commands/approvals.d.ts.map +1 -0
  10. package/dist/cli/commands/build.d.ts +8 -0
  11. package/dist/cli/commands/build.d.ts.map +1 -0
  12. package/dist/cli/commands/check.d.ts +33 -0
  13. package/dist/cli/commands/check.d.ts.map +1 -0
  14. package/dist/cli/commands/cwd.d.ts +14 -0
  15. package/dist/cli/commands/cwd.d.ts.map +1 -0
  16. package/dist/cli/commands/dev.d.ts +5 -0
  17. package/dist/cli/commands/dev.d.ts.map +1 -0
  18. package/dist/cli/commands/doctor.d.ts +34 -0
  19. package/dist/cli/commands/doctor.d.ts.map +1 -0
  20. package/dist/cli/commands/drift.d.ts +11 -0
  21. package/dist/cli/commands/drift.d.ts.map +1 -0
  22. package/dist/cli/commands/explain.d.ts +5 -0
  23. package/dist/cli/commands/explain.d.ts.map +1 -0
  24. package/dist/cli/commands/init.d.ts +46 -0
  25. package/dist/cli/commands/init.d.ts.map +1 -0
  26. package/dist/cli/commands/mcp-check.d.ts +57 -0
  27. package/dist/cli/commands/mcp-check.d.ts.map +1 -0
  28. package/dist/cli/commands/mcp.d.ts +13 -0
  29. package/dist/cli/commands/mcp.d.ts.map +1 -0
  30. package/dist/cli/commands/pin.d.ts +7 -0
  31. package/dist/cli/commands/pin.d.ts.map +1 -0
  32. package/dist/cli/commands/plugin.d.ts +32 -0
  33. package/dist/cli/commands/plugin.d.ts.map +1 -0
  34. package/dist/cli/commands/preview.d.ts +5 -0
  35. package/dist/cli/commands/preview.d.ts.map +1 -0
  36. package/dist/cli/commands/tokens.d.ts +5 -0
  37. package/dist/cli/commands/tokens.d.ts.map +1 -0
  38. package/dist/cli/errors.d.ts +53 -0
  39. package/dist/cli/errors.d.ts.map +1 -0
  40. package/dist/cli/handlers/brand.d.ts +7 -0
  41. package/dist/cli/handlers/brand.d.ts.map +1 -0
  42. package/dist/cli/handlers/can.d.ts +7 -0
  43. package/dist/cli/handlers/can.d.ts.map +1 -0
  44. package/dist/cli/handlers/fonts.d.ts +4 -0
  45. package/dist/cli/handlers/fonts.d.ts.map +1 -0
  46. package/dist/cli/handlers/get.d.ts +7 -0
  47. package/dist/cli/handlers/get.d.ts.map +1 -0
  48. package/dist/cli/handlers/index.d.ts +8 -0
  49. package/dist/cli/handlers/index.d.ts.map +1 -0
  50. package/dist/cli/handlers/list.d.ts +7 -0
  51. package/dist/cli/handlers/list.d.ts.map +1 -0
  52. package/dist/cli/handlers/logo.d.ts +4 -0
  53. package/dist/cli/handlers/logo.d.ts.map +1 -0
  54. package/dist/cli/handlers/rules.d.ts +10 -0
  55. package/dist/cli/handlers/rules.d.ts.map +1 -0
  56. package/dist/cli/handlers/types.d.ts +17 -0
  57. package/dist/cli/handlers/types.d.ts.map +1 -0
  58. package/dist/cli/help.d.ts +18 -0
  59. package/dist/cli/help.d.ts.map +1 -0
  60. package/dist/cli/index.d.ts +2 -0
  61. package/dist/cli/index.d.ts.map +1 -0
  62. package/dist/cli/index.js +3850 -0
  63. package/dist/cli/init-flow.d.ts +24 -0
  64. package/dist/cli/init-flow.d.ts.map +1 -0
  65. package/dist/cli/init-ui.d.ts +20 -0
  66. package/dist/cli/init-ui.d.ts.map +1 -0
  67. package/dist/cli/json.d.ts +18 -0
  68. package/dist/cli/json.d.ts.map +1 -0
  69. package/dist/cli/operations.d.ts +11 -0
  70. package/dist/cli/operations.d.ts.map +1 -0
  71. package/dist/cli/options.d.ts +8 -0
  72. package/dist/cli/options.d.ts.map +1 -0
  73. package/dist/cli/project.d.ts +8 -0
  74. package/dist/cli/project.d.ts.map +1 -0
  75. package/dist/cli/read.d.ts +13 -0
  76. package/dist/cli/read.d.ts.map +1 -0
  77. package/dist/cli/where.d.ts +10 -0
  78. package/dist/cli/where.d.ts.map +1 -0
  79. package/dist/core/assets/categories.d.ts +47 -0
  80. package/dist/core/assets/categories.d.ts.map +1 -0
  81. package/dist/core/assets/fields.d.ts +12 -0
  82. package/dist/core/assets/fields.d.ts.map +1 -0
  83. package/dist/core/assets/image-size.d.ts +10 -0
  84. package/dist/core/assets/image-size.d.ts.map +1 -0
  85. package/dist/core/assets/measure.d.ts +22 -0
  86. package/dist/core/assets/measure.d.ts.map +1 -0
  87. package/dist/core/assets/scanner.d.ts +26 -0
  88. package/dist/core/assets/scanner.d.ts.map +1 -0
  89. package/dist/core/assets/sidecar.d.ts +22 -0
  90. package/dist/core/assets/sidecar.d.ts.map +1 -0
  91. package/dist/core/blazon-pin.d.ts +36 -0
  92. package/dist/core/blazon-pin.d.ts.map +1 -0
  93. package/dist/core/brand/export.d.ts +128 -0
  94. package/dist/core/brand/export.d.ts.map +1 -0
  95. package/dist/core/brand/schema.d.ts +1000 -0
  96. package/dist/core/brand/schema.d.ts.map +1 -0
  97. package/dist/core/brand-theme.d.ts +16 -0
  98. package/dist/core/brand-theme.d.ts.map +1 -0
  99. package/dist/core/checker/approvals.d.ts +15 -0
  100. package/dist/core/checker/approvals.d.ts.map +1 -0
  101. package/dist/core/checker/cascade.d.ts +8 -0
  102. package/dist/core/checker/cascade.d.ts.map +1 -0
  103. package/dist/core/checker/catalogue.d.ts +609 -0
  104. package/dist/core/checker/catalogue.d.ts.map +1 -0
  105. package/dist/core/checker/contrast.d.ts +30 -0
  106. package/dist/core/checker/contrast.d.ts.map +1 -0
  107. package/dist/core/checker/duplicates.d.ts +3 -0
  108. package/dist/core/checker/duplicates.d.ts.map +1 -0
  109. package/dist/core/checker/fixes.d.ts +6 -0
  110. package/dist/core/checker/fixes.d.ts.map +1 -0
  111. package/dist/core/checker/font-meta.d.ts +8 -0
  112. package/dist/core/checker/font-meta.d.ts.map +1 -0
  113. package/dist/core/checker/index.d.ts +23 -0
  114. package/dist/core/checker/index.d.ts.map +1 -0
  115. package/dist/core/checker/location.d.ts +7 -0
  116. package/dist/core/checker/location.d.ts.map +1 -0
  117. package/dist/core/checker/logo-rules.d.ts +19 -0
  118. package/dist/core/checker/logo-rules.d.ts.map +1 -0
  119. package/dist/core/checker/logo-surfaces.d.ts +7 -0
  120. package/dist/core/checker/logo-surfaces.d.ts.map +1 -0
  121. package/dist/core/checker/page-tokens.d.ts +5 -0
  122. package/dist/core/checker/page-tokens.d.ts.map +1 -0
  123. package/dist/core/checker/print.d.ts +9 -0
  124. package/dist/core/checker/print.d.ts.map +1 -0
  125. package/dist/core/checker/proportion.d.ts +3 -0
  126. package/dist/core/checker/proportion.d.ts.map +1 -0
  127. package/dist/core/checker/review.d.ts +40 -0
  128. package/dist/core/checker/review.d.ts.map +1 -0
  129. package/dist/core/checker/source.d.ts +4 -0
  130. package/dist/core/checker/source.d.ts.map +1 -0
  131. package/dist/core/checker/spdx.d.ts +8 -0
  132. package/dist/core/checker/spdx.d.ts.map +1 -0
  133. package/dist/core/checker/tier.d.ts +3 -0
  134. package/dist/core/checker/tier.d.ts.map +1 -0
  135. package/dist/core/checker/usage.d.ts +4 -0
  136. package/dist/core/checker/usage.d.ts.map +1 -0
  137. package/dist/core/checker/variables.d.ts +8 -0
  138. package/dist/core/checker/variables.d.ts.map +1 -0
  139. package/dist/core/colors.d.ts +10 -0
  140. package/dist/core/colors.d.ts.map +1 -0
  141. package/dist/core/config/defaults.d.ts +3 -0
  142. package/dist/core/config/defaults.d.ts.map +1 -0
  143. package/dist/core/config/index.d.ts +15 -0
  144. package/dist/core/config/index.d.ts.map +1 -0
  145. package/dist/core/config/validate.d.ts +21 -0
  146. package/dist/core/config/validate.d.ts.map +1 -0
  147. package/dist/core/config/vocabulary.d.ts +10 -0
  148. package/dist/core/config/vocabulary.d.ts.map +1 -0
  149. package/dist/core/confine.d.ts +25 -0
  150. package/dist/core/confine.d.ts.map +1 -0
  151. package/dist/core/docs/directives.d.ts +161 -0
  152. package/dist/core/docs/directives.d.ts.map +1 -0
  153. package/dist/core/docs/parser.d.ts +7 -0
  154. package/dist/core/docs/parser.d.ts.map +1 -0
  155. package/dist/core/docs/sections.d.ts +11 -0
  156. package/dist/core/docs/sections.d.ts.map +1 -0
  157. package/dist/core/drift/compare.d.ts +30 -0
  158. package/dist/core/drift/compare.d.ts.map +1 -0
  159. package/dist/core/drift/read.d.ts +22 -0
  160. package/dist/core/drift/read.d.ts.map +1 -0
  161. package/dist/core/email-signature.d.ts +35 -0
  162. package/dist/core/email-signature.d.ts.map +1 -0
  163. package/dist/core/emit.d.ts +22 -0
  164. package/dist/core/emit.d.ts.map +1 -0
  165. package/dist/core/fonts.d.ts +43 -0
  166. package/dist/core/fonts.d.ts.map +1 -0
  167. package/dist/core/icons/icon-sets.d.ts +22 -0
  168. package/dist/core/icons/icon-sets.d.ts.map +1 -0
  169. package/dist/core/index.d.ts +9 -0
  170. package/dist/core/index.d.ts.map +1 -0
  171. package/dist/core/init/answers.d.ts +45 -0
  172. package/dist/core/init/answers.d.ts.map +1 -0
  173. package/dist/core/init/from-site/apply.d.ts +7 -0
  174. package/dist/core/init/from-site/apply.d.ts.map +1 -0
  175. package/dist/core/init/from-site/clean-colors.d.ts +21 -0
  176. package/dist/core/init/from-site/clean-colors.d.ts.map +1 -0
  177. package/dist/core/init/from-site/colors.d.ts +10 -0
  178. package/dist/core/init/from-site/colors.d.ts.map +1 -0
  179. package/dist/core/init/from-site/context.d.ts +24 -0
  180. package/dist/core/init/from-site/context.d.ts.map +1 -0
  181. package/dist/core/init/from-site/fonts.d.ts +10 -0
  182. package/dist/core/init/from-site/fonts.d.ts.map +1 -0
  183. package/dist/core/init/from-site/html.d.ts +10 -0
  184. package/dist/core/init/from-site/html.d.ts.map +1 -0
  185. package/dist/core/init/from-site/index.d.ts +6 -0
  186. package/dist/core/init/from-site/index.d.ts.map +1 -0
  187. package/dist/core/init/from-site/inspect.d.ts +4 -0
  188. package/dist/core/init/from-site/inspect.d.ts.map +1 -0
  189. package/dist/core/init/from-site/logo.d.ts +20 -0
  190. package/dist/core/init/from-site/logo.d.ts.map +1 -0
  191. package/dist/core/init/from-site/sections/colors.d.ts +4 -0
  192. package/dist/core/init/from-site/sections/colors.d.ts.map +1 -0
  193. package/dist/core/init/from-site/sections/config.d.ts +10 -0
  194. package/dist/core/init/from-site/sections/config.d.ts.map +1 -0
  195. package/dist/core/init/from-site/sections/directives.d.ts +3 -0
  196. package/dist/core/init/from-site/sections/directives.d.ts.map +1 -0
  197. package/dist/core/init/from-site/sections/fonts.d.ts +8 -0
  198. package/dist/core/init/from-site/sections/fonts.d.ts.map +1 -0
  199. package/dist/core/init/from-site/sections/intro.d.ts +4 -0
  200. package/dist/core/init/from-site/sections/intro.d.ts.map +1 -0
  201. package/dist/core/init/from-site/sections/logo.d.ts +9 -0
  202. package/dist/core/init/from-site/sections/logo.d.ts.map +1 -0
  203. package/dist/core/init/from-site/sections/placeholder.d.ts +5 -0
  204. package/dist/core/init/from-site/sections/placeholder.d.ts.map +1 -0
  205. package/dist/core/init/from-site/tree.d.ts +14 -0
  206. package/dist/core/init/from-site/tree.d.ts.map +1 -0
  207. package/dist/core/init/from-site/types.d.ts +37 -0
  208. package/dist/core/init/from-site/types.d.ts.map +1 -0
  209. package/dist/core/init/palette.d.ts +34 -0
  210. package/dist/core/init/palette.d.ts.map +1 -0
  211. package/dist/core/init/prompts.d.ts +78 -0
  212. package/dist/core/init/prompts.d.ts.map +1 -0
  213. package/dist/core/init/shared/google-fonts.d.ts +4 -0
  214. package/dist/core/init/shared/google-fonts.d.ts.map +1 -0
  215. package/dist/core/init/shared/hex.d.ts +6 -0
  216. package/dist/core/init/shared/hex.d.ts.map +1 -0
  217. package/dist/core/init/shared/svg.d.ts +3 -0
  218. package/dist/core/init/shared/svg.d.ts.map +1 -0
  219. package/dist/core/init/vocabulary.d.ts +42 -0
  220. package/dist/core/init/vocabulary.d.ts.map +1 -0
  221. package/dist/core/inputs.d.ts +25 -0
  222. package/dist/core/inputs.d.ts.map +1 -0
  223. package/dist/core/logo/lockup.d.ts +54 -0
  224. package/dist/core/logo/lockup.d.ts.map +1 -0
  225. package/dist/core/logo.d.ts +23 -0
  226. package/dist/core/logo.d.ts.map +1 -0
  227. package/dist/core/mcp-config.d.ts +65 -0
  228. package/dist/core/mcp-config.d.ts.map +1 -0
  229. package/dist/core/operations/check.d.ts +8 -0
  230. package/dist/core/operations/check.d.ts.map +1 -0
  231. package/dist/core/operations/index.d.ts +7 -0
  232. package/dist/core/operations/index.d.ts.map +1 -0
  233. package/dist/core/operations/limits.d.ts +6 -0
  234. package/dist/core/operations/limits.d.ts.map +1 -0
  235. package/dist/core/operations/list.d.ts +8 -0
  236. package/dist/core/operations/list.d.ts.map +1 -0
  237. package/dist/core/operations/project.d.ts +10 -0
  238. package/dist/core/operations/project.d.ts.map +1 -0
  239. package/dist/core/operations/types.d.ts +96 -0
  240. package/dist/core/operations/types.d.ts.map +1 -0
  241. package/dist/core/operations/validate.d.ts +4 -0
  242. package/dist/core/operations/validate.d.ts.map +1 -0
  243. package/dist/core/order.d.ts +9 -0
  244. package/dist/core/order.d.ts.map +1 -0
  245. package/dist/core/outputs.d.ts +22 -0
  246. package/dist/core/outputs.d.ts.map +1 -0
  247. package/dist/core/package-name.d.ts +3 -0
  248. package/dist/core/package-name.d.ts.map +1 -0
  249. package/dist/core/package-root.d.ts +3 -0
  250. package/dist/core/package-root.d.ts.map +1 -0
  251. package/dist/core/plugin-name.d.ts +27 -0
  252. package/dist/core/plugin-name.d.ts.map +1 -0
  253. package/dist/core/preflight.d.ts +10 -0
  254. package/dist/core/preflight.d.ts.map +1 -0
  255. package/dist/core/read/can.d.ts +44 -0
  256. package/dist/core/read/can.d.ts.map +1 -0
  257. package/dist/core/read/fonts.d.ts +47 -0
  258. package/dist/core/read/fonts.d.ts.map +1 -0
  259. package/dist/core/read/index.d.ts +8 -0
  260. package/dist/core/read/index.d.ts.map +1 -0
  261. package/dist/core/read/list.d.ts +28 -0
  262. package/dist/core/read/list.d.ts.map +1 -0
  263. package/dist/core/read/logo.d.ts +34 -0
  264. package/dist/core/read/logo.d.ts.map +1 -0
  265. package/dist/core/read/lookup.d.ts +9 -0
  266. package/dist/core/read/lookup.d.ts.map +1 -0
  267. package/dist/core/read/rules.d.ts +80 -0
  268. package/dist/core/read/rules.d.ts.map +1 -0
  269. package/dist/core/read/token.d.ts +46 -0
  270. package/dist/core/read/token.d.ts.map +1 -0
  271. package/dist/core/shipped-names.d.ts +9 -0
  272. package/dist/core/shipped-names.d.ts.map +1 -0
  273. package/dist/core/starter.d.ts +31 -0
  274. package/dist/core/starter.d.ts.map +1 -0
  275. package/dist/core/suggest.d.ts +7 -0
  276. package/dist/core/suggest.d.ts.map +1 -0
  277. package/dist/core/tokens/alias.d.ts +18 -0
  278. package/dist/core/tokens/alias.d.ts.map +1 -0
  279. package/dist/core/tokens/contexts.d.ts +10 -0
  280. package/dist/core/tokens/contexts.d.ts.map +1 -0
  281. package/dist/core/tokens/formatters/css.d.ts +15 -0
  282. package/dist/core/tokens/formatters/css.d.ts.map +1 -0
  283. package/dist/core/tokens/formatters/json.d.ts +4 -0
  284. package/dist/core/tokens/formatters/json.d.ts.map +1 -0
  285. package/dist/core/tokens/formatters/tailwind.d.ts +37 -0
  286. package/dist/core/tokens/formatters/tailwind.d.ts.map +1 -0
  287. package/dist/core/tokens/formatters/ts.d.ts +6 -0
  288. package/dist/core/tokens/formatters/ts.d.ts.map +1 -0
  289. package/dist/core/tokens/groups.d.ts +44 -0
  290. package/dist/core/tokens/groups.d.ts.map +1 -0
  291. package/dist/core/tokens/key-lines.d.ts +8 -0
  292. package/dist/core/tokens/key-lines.d.ts.map +1 -0
  293. package/dist/core/tokens/load.d.ts +12 -0
  294. package/dist/core/tokens/load.d.ts.map +1 -0
  295. package/dist/core/tokens/merge.d.ts +17 -0
  296. package/dist/core/tokens/merge.d.ts.map +1 -0
  297. package/dist/core/tokens/names.d.ts +5 -0
  298. package/dist/core/tokens/names.d.ts.map +1 -0
  299. package/dist/core/tokens/resolve.d.ts +8 -0
  300. package/dist/core/tokens/resolve.d.ts.map +1 -0
  301. package/dist/core/tokens/resolver/compile.d.ts +17 -0
  302. package/dist/core/tokens/resolver/compile.d.ts.map +1 -0
  303. package/dist/core/tokens/resolver/inputs.d.ts +7 -0
  304. package/dist/core/tokens/resolver/inputs.d.ts.map +1 -0
  305. package/dist/core/tokens/resolver/parse.d.ts +34 -0
  306. package/dist/core/tokens/resolver/parse.d.ts.map +1 -0
  307. package/dist/core/tokens/resolver/sources.d.ts +17 -0
  308. package/dist/core/tokens/resolver/sources.d.ts.map +1 -0
  309. package/dist/core/tokens/shadcn.d.ts +43 -0
  310. package/dist/core/tokens/shadcn.d.ts.map +1 -0
  311. package/dist/core/tokens/theme.d.ts +17 -0
  312. package/dist/core/tokens/theme.d.ts.map +1 -0
  313. package/dist/core/tokens/values/color.d.ts +2 -0
  314. package/dist/core/tokens/values/color.d.ts.map +1 -0
  315. package/dist/core/tokens/values/composite.d.ts +7 -0
  316. package/dist/core/tokens/values/composite.d.ts.map +1 -0
  317. package/dist/core/tokens/values/font.d.ts +3 -0
  318. package/dist/core/tokens/values/font.d.ts.map +1 -0
  319. package/dist/core/tokens/values/index.d.ts +9 -0
  320. package/dist/core/tokens/values/index.d.ts.map +1 -0
  321. package/dist/core/tokens/values/shared.d.ts +5 -0
  322. package/dist/core/tokens/values/shared.d.ts.map +1 -0
  323. package/dist/core/tokens/values/simple.d.ts +3 -0
  324. package/dist/core/tokens/values/simple.d.ts.map +1 -0
  325. package/dist/core/tokens/values/units.d.ts +3 -0
  326. package/dist/core/tokens/values/units.d.ts.map +1 -0
  327. package/dist/core/tokens/walk.d.ts +30 -0
  328. package/dist/core/tokens/walk.d.ts.map +1 -0
  329. package/dist/core/version.d.ts +3 -0
  330. package/dist/core/version.d.ts.map +1 -0
  331. package/dist/index.d.ts +27 -0
  332. package/dist/index.d.ts.map +1 -0
  333. package/dist/index.js +40 -0
  334. package/dist/plugins/host/admit.d.ts +35 -0
  335. package/dist/plugins/host/admit.d.ts.map +1 -0
  336. package/dist/plugins/host/call.d.ts +59 -0
  337. package/dist/plugins/host/call.d.ts.map +1 -0
  338. package/dist/plugins/host/check.d.ts +54 -0
  339. package/dist/plugins/host/check.d.ts.map +1 -0
  340. package/dist/plugins/host/scrub.d.ts +17 -0
  341. package/dist/plugins/host/scrub.d.ts.map +1 -0
  342. package/dist/plugins/index.d.ts +14 -0
  343. package/dist/plugins/index.d.ts.map +1 -0
  344. package/dist/plugins/pins/interpreter.d.ts +49 -0
  345. package/dist/plugins/pins/interpreter.d.ts.map +1 -0
  346. package/dist/plugins/pins/lock.d.ts +47 -0
  347. package/dist/plugins/pins/lock.d.ts.map +1 -0
  348. package/dist/plugins/pins/pin.d.ts +65 -0
  349. package/dist/plugins/pins/pin.d.ts.map +1 -0
  350. package/dist/plugins/pins/shipped.d.ts +40 -0
  351. package/dist/plugins/pins/shipped.d.ts.map +1 -0
  352. package/dist/plugins/roles/breaker.d.ts +18 -0
  353. package/dist/plugins/roles/breaker.d.ts.map +1 -0
  354. package/dist/plugins/roles/check-cases.d.ts +4 -0
  355. package/dist/plugins/roles/check-cases.d.ts.map +1 -0
  356. package/dist/plugins/roles/dev.d.ts +35 -0
  357. package/dist/plugins/roles/dev.d.ts.map +1 -0
  358. package/dist/plugins/roles/fixes.d.ts +24 -0
  359. package/dist/plugins/roles/fixes.d.ts.map +1 -0
  360. package/dist/plugins/roles/gate.d.ts +26 -0
  361. package/dist/plugins/roles/gate.d.ts.map +1 -0
  362. package/dist/plugins/roles/integrate.d.ts +12 -0
  363. package/dist/plugins/roles/integrate.d.ts.map +1 -0
  364. package/dist/plugins/roles/roles.d.ts +73 -0
  365. package/dist/plugins/roles/roles.d.ts.map +1 -0
  366. package/dist/plugins/wire/environment.d.ts +9 -0
  367. package/dist/plugins/wire/environment.d.ts.map +1 -0
  368. package/dist/plugins/wire/forms.d.ts +13 -0
  369. package/dist/plugins/wire/forms.d.ts.map +1 -0
  370. package/dist/plugins/wire/limits.d.ts +11 -0
  371. package/dist/plugins/wire/limits.d.ts.map +1 -0
  372. package/dist/plugins/wire/manifest.d.ts +31 -0
  373. package/dist/plugins/wire/manifest.d.ts.map +1 -0
  374. package/dist/plugins/wire/profile.d.ts +36 -0
  375. package/dist/plugins/wire/profile.d.ts.map +1 -0
  376. package/dist/plugins/wire/text.d.ts +14 -0
  377. package/dist/plugins/wire/text.d.ts.map +1 -0
  378. package/dist/server/assets.d.ts +13 -0
  379. package/dist/server/assets.d.ts.map +1 -0
  380. package/dist/server/coalesce.d.ts +12 -0
  381. package/dist/server/coalesce.d.ts.map +1 -0
  382. package/dist/server/data-script.d.ts +8 -0
  383. package/dist/server/data-script.d.ts.map +1 -0
  384. package/dist/server/dev-server.d.ts +34 -0
  385. package/dist/server/dev-server.d.ts.map +1 -0
  386. package/dist/server/editor-guard.d.ts +13 -0
  387. package/dist/server/editor-guard.d.ts.map +1 -0
  388. package/dist/server/error-reporter.d.ts +11 -0
  389. package/dist/server/error-reporter.d.ts.map +1 -0
  390. package/dist/server/icon-sets.d.ts +9 -0
  391. package/dist/server/icon-sets.d.ts.map +1 -0
  392. package/dist/server/plugin.d.ts +4 -0
  393. package/dist/server/plugin.d.ts.map +1 -0
  394. package/dist/server/preview-guard.d.ts +11 -0
  395. package/dist/server/preview-guard.d.ts.map +1 -0
  396. package/dist/types/assets.d.ts +130 -0
  397. package/dist/types/assets.d.ts.map +1 -0
  398. package/dist/types/catalog.d.ts +95 -0
  399. package/dist/types/catalog.d.ts.map +1 -0
  400. package/dist/types/config.d.ts +97 -0
  401. package/dist/types/config.d.ts.map +1 -0
  402. package/dist/types/data.d.ts +38 -0
  403. package/dist/types/data.d.ts.map +1 -0
  404. package/dist/types/docs.d.ts +47 -0
  405. package/dist/types/docs.d.ts.map +1 -0
  406. package/dist/types/findings.d.ts +18 -0
  407. package/dist/types/findings.d.ts.map +1 -0
  408. package/dist/types/index.d.ts +13 -0
  409. package/dist/types/index.d.ts.map +1 -0
  410. package/dist/types/parsed.d.ts +86 -0
  411. package/dist/types/parsed.d.ts.map +1 -0
  412. package/dist/types/theme.d.ts +19 -0
  413. package/dist/types/theme.d.ts.map +1 -0
  414. package/dist/types/tokens.d.ts +101 -0
  415. package/dist/types/tokens.d.ts.map +1 -0
  416. package/dist/ui/assets/geist-OFL.txt +93 -0
  417. package/dist/ui/assets/geist-cyrillic-ext-wght-normal-DjL33-gN.woff2 +0 -0
  418. package/dist/ui/assets/geist-cyrillic-wght-normal-BEAKL7Jp.woff2 +0 -0
  419. package/dist/ui/assets/geist-latin-ext-wght-normal-DC-KSUi6.woff2 +0 -0
  420. package/dist/ui/assets/geist-latin-wght-normal-BgDaEnEv.woff2 +0 -0
  421. package/dist/ui/assets/geist-vietnamese-wght-normal-6IgcOCM7.woff2 +0 -0
  422. package/dist/ui/assets/index-D0WCUmtA.css +2 -0
  423. package/dist/ui/assets/index-DhSc0Zxv.js +75 -0
  424. package/dist/ui/index.html +14 -0
  425. package/package.json +151 -4
  426. package/plugins/blazon.brand-deck/README.md +38 -0
  427. package/plugins/blazon.brand-deck/bin/blazon-blazon.brand-deck./360/237/224/214 +2695 -0
  428. package/plugins/blazon.brand-deck/package.json +3 -0
  429. package/plugins/blazon.copy/README.md +29 -0
  430. package/plugins/blazon.copy/bin/blazon-blazon.copy./360/237/224/214 +438 -0
  431. package/plugins/blazon.copy/package.json +3 -0
  432. package/plugins/blazon.favicons/README.md +13 -0
  433. package/plugins/blazon.favicons/bin/blazon-blazon.favicons./360/237/224/214 +8816 -0
  434. package/plugins/blazon.favicons/package.json +3 -0
  435. package/plugins/blazon.logo-geometry/README.md +5 -0
  436. package/plugins/blazon.logo-geometry/bin/blazon-blazon.logo-geometry./360/237/224/214 +1522 -0
  437. package/plugins/blazon.logo-geometry/package.json +3 -0
  438. package/plugins/blazon.logo-kit/README.md +5 -0
  439. package/plugins/blazon.logo-kit/bin/blazon-blazon.logo-kit./360/237/224/214 +617 -0
  440. package/plugins/blazon.logo-kit/package.json +3 -0
  441. package/plugins/blazon.office-template/README.md +29 -0
  442. package/plugins/blazon.office-template/bin/blazon-blazon.office-template./360/237/224/214 +1788 -0
  443. package/plugins/blazon.office-template/package.json +3 -0
  444. package/plugins/blazon.platform-tokens/README.md +22 -0
  445. package/plugins/blazon.platform-tokens/bin/blazon-blazon.platform-tokens./360/237/224/214 +8418 -0
  446. package/plugins/blazon.platform-tokens/package.json +3 -0
  447. package/plugins/blazon.press-kit/README.md +17 -0
  448. package/plugins/blazon.press-kit/bin/blazon-blazon.press-kit./360/237/224/214 +897 -0
  449. package/plugins/blazon.press-kit/package.json +3 -0
  450. package/plugins/blazon.print-book/README.md +40 -0
  451. package/plugins/blazon.print-book/bin/blazon-blazon.print-book./360/237/224/214 +9268 -0
  452. package/plugins/blazon.print-book/package.json +3 -0
  453. package/plugins/blazon.social-cards/README.md +5 -0
  454. package/plugins/blazon.social-cards/bin/blazon-blazon.social-cards./360/237/224/214 +1165 -0
  455. package/plugins/blazon.social-cards/package.json +3 -0
  456. package/plugins/shipped.lock +75 -0
  457. package/template/AGENTS.md +55 -0
  458. package/template/CLAUDE.md +1 -0
  459. package/template/assets/backgrounds/aurora.json +5 -0
  460. package/template/assets/backgrounds/aurora.svg +39 -0
  461. package/template/assets/construction/blazon-mark.json +9 -0
  462. package/template/assets/construction/blazon-mark.svg +54 -0
  463. package/template/assets/icons/arrow-right.json +5 -0
  464. package/template/assets/icons/arrow-right.svg +1 -0
  465. package/template/assets/icons/check.json +5 -0
  466. package/template/assets/icons/check.svg +1 -0
  467. package/template/assets/icons/download.json +5 -0
  468. package/template/assets/icons/download.svg +1 -0
  469. package/template/assets/icons/file.json +5 -0
  470. package/template/assets/icons/file.svg +1 -0
  471. package/template/assets/icons/token.json +5 -0
  472. package/template/assets/icons/token.svg +1 -0
  473. package/template/assets/icons/warning.json +5 -0
  474. package/template/assets/icons/warning.svg +1 -0
  475. package/template/assets/logos/blazon-bone.json +6 -0
  476. package/template/assets/logos/blazon-bone.svg +1 -0
  477. package/template/assets/logos/blazon-graphite.json +6 -0
  478. package/template/assets/logos/blazon-graphite.svg +1 -0
  479. package/template/assets/logos/blazon-mark.json +6 -0
  480. package/template/assets/logos/blazon-mark.svg +1 -0
  481. package/template/blazon.json +104 -0
  482. package/template/blazon.resolver.json +46 -0
  483. package/template/docs/01-principles.md +47 -0
  484. package/template/docs/02-logo.md +43 -0
  485. package/template/docs/03-color.md +79 -0
  486. package/template/docs/04-type.md +36 -0
  487. package/template/docs/05-form.md +80 -0
  488. package/template/docs/06-layout.md +28 -0
  489. package/template/docs/07-icons.md +22 -0
  490. package/template/docs/08-diagrams.md +20 -0
  491. package/template/docs/09-social.md +21 -0
  492. package/template/docs/10-applications.md +20 -0
  493. package/template/docs/11-voice.md +74 -0
  494. package/template/docs/12-web.md +167 -0
  495. package/template/fonts/IBMPlexMono-Regular-latin.woff2 +0 -0
  496. package/template/fonts/IBMPlexMono-SemiBold-latin.woff2 +0 -0
  497. package/template/fonts/OFL.txt +93 -0
  498. package/template/tokens/colors.json +257 -0
  499. package/template/tokens/form.json +199 -0
  500. package/template/tokens/social.json +26 -0
  501. package/template/tokens/spacing.json +65 -0
  502. package/template/tokens/theme/dark.json +121 -0
  503. package/template/tokens/typography.json +233 -0
@@ -0,0 +1,27 @@
1
+ /** Whether `name` is a plugin name: dotted lowercase words, such as `acme.house-style`. */
2
+ export declare function isPluginName(name: string): boolean;
3
+ /**
4
+ * Whether `id` is the name of a file `blazon build` writes in `tokensOutDir` (`planTokenOutputs`, `src/core/emit.ts`): `theme.css`,
5
+ * `tokens.ts`, `tokens.json`, `typography.css`, `tailwind.css`, `tailwind-reset.css` and `tokens.<modifier>.<context>.json`. Each has the form of a
6
+ * plugin name, and an instance's id names a folder in the same place, which is emptied before its call: a folder there would replace the file.
7
+ */
8
+ export declare function isTokenOutputName(id: string): boolean;
9
+ /** The longest an instance id may be (RFC 0014 section 3.1): every id, whether it is an `as` or a plugin's name. */
10
+ export declare const MAX_INSTANCE_ID = 64;
11
+ /** Why `id` cannot be an instance id, or undefined when it can: the length, for an id that has the form of a plugin name. */
12
+ export declare function instanceIdTooLong(id: string): string | undefined;
13
+ /** The extension of a plugin's program in a plugin folder (RFC 0005 section 3.6): `bin/blazon-<name>.🔌`. */
14
+ export declare const PLUGIN_EXTENSION = ".\uD83D\uDD0C";
15
+ /** The path, inside its folder, of the program of the plugin `name` that ships in blazon's package. */
16
+ export declare function pluginEntry(name: string): string;
17
+ /** The plugin name in a program's file name (`blazon-acme.first.🔌` gives `acme.first`), or undefined for any other name. */
18
+ export declare function pluginNameOfEntry(file: string): string | undefined;
19
+ /**
20
+ * Whether the program at `program` sits in the layout of a shipped plugin (`<name>/bin/blazon-<something>`, RFC 0005
21
+ * section 3.6) with a file name other than `blazon-<name>.🔌`, and if so what the file name should be. Undefined for
22
+ * a correct name and for any path that is not in that layout: a plugin kept anywhere else, such as one script beside
23
+ * its README or a pinned copy under `.blazon/plugins/`, is not the business of this rule. The folder must itself be a
24
+ * plugin name, so `bin/blazon-x` in an ordinary project is left alone.
25
+ */
26
+ export declare function shippedLayoutProblem(program: string): string | undefined;
27
+ //# sourceMappingURL=plugin-name.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-name.d.ts","sourceRoot":"","sources":["../../src/core/plugin-name.ts"],"names":[],"mappings":"AAIA,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,oHAAoH;AACpH,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,6HAA6H;AAC7H,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,6GAA6G;AAC7G,eAAO,MAAM,gBAAgB,kBAAQ,CAAC;AAEtC,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,6HAA6H;AAC7H,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIlE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOxE"}
@@ -0,0 +1,10 @@
1
+ import { BlazonConfig, BlazonData } from '../types/index.js';
2
+ export interface WriteOptions {
3
+ /** Write although the brand has errors in its findings. The unsafe-output and pin refusals still stand */
4
+ allowErrors?: boolean;
5
+ }
6
+ /** Why blazon may not write now, as sentences; empty when it may. */
7
+ export declare function writeBlockers(data: BlazonData, config: BlazonConfig, cwd: string, options?: WriteOptions): string[];
8
+ /** Throws, naming every reason, when blazon may not write. */
9
+ export declare function assertCanWrite(data: BlazonData, config: BlazonConfig, cwd: string, options?: WriteOptions): void;
10
+ //# sourceMappingURL=preflight.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/core/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAa3E,MAAM,WAAW,YAAY;IAC3B,0GAA0G;IAC1G,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAUD,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,EAAE,CAYvH;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI,CAGpH"}
@@ -0,0 +1,44 @@
1
+ import { ContrastLevel, BlazonData } from '../../types/index.js';
2
+ export interface CanCheck {
3
+ rule: 'usage' | 'pairs' | 'contrast';
4
+ ok: boolean;
5
+ message: string;
6
+ /** The token or group that states the rule */
7
+ from?: string;
8
+ }
9
+ export interface CanAnswer {
10
+ fg: string;
11
+ bg: string;
12
+ allowed: boolean;
13
+ /** The first rule that denies it, or what allows it */
14
+ reason: string;
15
+ checks: CanCheck[];
16
+ /** Foreground on background, WCAG 2.x, and the strictest level that ratio meets ('fail' when it meets none) */
17
+ contrast: {
18
+ ratio: number;
19
+ level: ContrastLevel | 'fail';
20
+ /** The ratio the pair had to meet. Set for the `ui` role only: a text pair's minimum is the one its listed pair names. */ threshold?: number;
21
+ };
22
+ /** What the foreground is judged as: `text`, or `ui` for a border, focus ring or icon stroke */
23
+ role: CanRole;
24
+ /** The `theme` context the pair was judged in. Absent for the default tokens. */
25
+ theme?: string;
26
+ }
27
+ export type CanRole = 'text' | 'ui';
28
+ export declare const CAN_ROLES: readonly CanRole[];
29
+ /** WCAG 1.4.11 asks 3:1 of a graphic and of a control's boundary, the same figure as large text. */
30
+ export declare const NON_TEXT_MINIMUM: number;
31
+ /** The modifier `--theme` names a context of. */
32
+ export declare const THEME_MODIFIER = "theme";
33
+ /**
34
+ * Whether the foreground token may be used as text on the background token, from the brand's own rules and nothing else: the `usage` rules
35
+ * on the foreground (role "text") and the background (role "background"), and the `pairs`. Pairs are a list, as the brand book treats them: when
36
+ * the brand lists any, a combination none of them names is denied. A pair listed on a token that the foreground or background aliases counts.
37
+ *
38
+ * With `role` `ui` the foreground is a non-text element (focus ring, border, icon stroke): the contrast must reach {@link NON_TEXT_MINIMUM}, the `usage`
39
+ * rule is read for the roles `border`, `icon` and `interactive`, and `pairs` do not apply, because they are text pairs.
40
+ *
41
+ * With `theme` the pair is judged in that context of the resolver's `theme` modifier: its colors, not the default's.
42
+ */
43
+ export declare function canUse(data: BlazonData, typedFg: string, typedBg: string, role?: CanRole, theme?: string): CanAnswer;
44
+ //# sourceMappingURL=can.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"can.d.ts","sourceRoot":"","sources":["../../../src/core/read/can.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAa,MAAM,sBAAsB,CAAC;AAOjF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,+GAA+G;IAC/G,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC;QAC9B,0HAA0H,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;KAC/I,CAAC;IACF,gGAAgG;IAChG,IAAI,EAAE,OAAO,CAAC;IACd,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;AACpC,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAAmB,CAAC;AAE5D,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,QAA+B,CAAC;AAkC7D,iDAAiD;AACjD,eAAO,MAAM,cAAc,UAAU,CAAC;AAkBtC;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,OAAgB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAyD5H"}
@@ -0,0 +1,47 @@
1
+ import { BlazonConfig, BlazonData, ThemeRole } from '../../types/index.js';
2
+ export interface FontFileEntry {
3
+ family: string;
4
+ /** From the project root */
5
+ file: string;
6
+ weight?: number | string;
7
+ style?: 'normal' | 'italic';
8
+ }
9
+ export interface FamilyUse {
10
+ family: string;
11
+ /** The tokens that name it first: a font family token, or the family of a typography token */
12
+ tokens: string[];
13
+ /** The whole stack of the first font family token that names it, for the fallbacks */
14
+ stack?: string[];
15
+ /** A family the browser has without a download (a keyword or a common system font) */
16
+ system: boolean;
17
+ /** Whether an entry of `fonts` loads it. Null when a stylesheet blazon cannot read is listed, so what it loads is not known */
18
+ loaded: boolean | null;
19
+ /** The token's own word on it: `webFont: false` or a sentence, and its `font` source and license */
20
+ webFont?: false | string;
21
+ font?: {
22
+ source?: string;
23
+ license?: string;
24
+ licenseUrl?: string;
25
+ };
26
+ }
27
+ export interface FontsDescription {
28
+ /** The stylesheet addresses the brand loads, as the config lists them */
29
+ stylesheets: string[];
30
+ /** The font files of the project that blazon embeds */
31
+ files: FontFileEntry[];
32
+ /** The brand book roles that are fonts, with the token behind each */
33
+ roles: Partial<Record<Extract<ThemeRole, 'fontDisplay' | 'fontBody'>, {
34
+ token?: string;
35
+ value?: string;
36
+ }>>;
37
+ families: FamilyUse[];
38
+ }
39
+ /** The fonts the brand loads, from `fonts` in the config, and the families its tokens name. */
40
+ export declare function describeFonts(data: BlazonData, config: BlazonConfig, cwd: string): FontsDescription;
41
+ /**
42
+ * The `@font-face` rules for the font files of `description`, for a site that serves them itself. `src` is the path as the config
43
+ * gives it, from the brand folder; with `base` it is `base` and the file's name, so a site can point it at its own public folder.
44
+ * A stylesheet is a comment with its address: blazon does not fetch it, so it has no rule. A file that is not a font blazon embeds is a comment too.
45
+ */
46
+ export declare function fontFaceCss(description: Pick<FontsDescription, 'stylesheets' | 'files'>, base?: string): string;
47
+ //# sourceMappingURL=fonts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../../src/core/read/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGhF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,sFAAsF;IACtF,MAAM,EAAE,OAAO,CAAC;IAChB,+HAA+H;IAC/H,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,oGAAoG;IACpG,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAED,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,uDAAuD;IACvD,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,GAAG,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3G,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAwCnG;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAY/G"}
@@ -0,0 +1,8 @@
1
+ export { LookupError, cleanPath, findToken } from './lookup.js';
2
+ export { describeToken, tokenNames, type TokenDescription, type TokenNames } from './token.js';
3
+ export { listTokens, isGroupPath, type TokenList, type TokenListing } from './list.js';
4
+ export { ruleEntries, tokenRules, allPairs, type RuleEntry, type TokenRules, type PairRule, type UsageRule, type LogoRule, type ReviewRule } from './rules.js';
5
+ export { canUse, CAN_ROLES, NON_TEXT_MINIMUM, type CanAnswer, type CanCheck, type CanRole } from './can.js';
6
+ export { describeFonts, fontFaceCss, type FontsDescription, type FamilyUse, type FontFileEntry } from './fonts.js';
7
+ export { describeLogo, type LogoDescription, type LogoAsset, type LogoVariant } from './logo.js';
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/read/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/J,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACnH,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC"}
@@ -0,0 +1,28 @@
1
+ import { BlazonData, TokenType } from '../../types/index.js';
2
+ /** One line of the token list: enough to pick a path, and to use its value without a second call. */
3
+ export interface TokenListing {
4
+ path: string;
5
+ type?: TokenType;
6
+ /** CSS-ready, aliases resolved */
7
+ value: string | number;
8
+ /** The token this one aliases directly */
9
+ aliasOf?: string;
10
+ }
11
+ export interface TokenList {
12
+ /** The group asked for, as a clean path; absent for the whole brand */
13
+ group?: string;
14
+ /** The type asked for; absent for every type */
15
+ type?: TokenType;
16
+ tokens: TokenListing[];
17
+ }
18
+ /** Whether `typed` names a group of tokens and not a token. A path that is both is a token. */
19
+ export declare function isGroupPath(data: BlazonData, typed: string): boolean;
20
+ /**
21
+ * The tokens of the brand, or of one group, in the order the token files write them, optionally only one `$type`.
22
+ * Throws a LookupError for a group that is not there, or a type blazon does not know. Lets an agent find a path to give `describeToken`.
23
+ */
24
+ export declare function listTokens(data: BlazonData, options?: {
25
+ group?: string;
26
+ type?: string;
27
+ }): TokenList;
28
+ //# sourceMappingURL=list.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/core/read/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAIpF,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,kCAAkC;IAClC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAYD,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,CAmBvG"}
@@ -0,0 +1,34 @@
1
+ import { AssetMeta, BlazonConfig, BlazonData } from '../../types/index.js';
2
+ export interface LogoVariant {
3
+ variant: 'onLight' | 'onDark';
4
+ /** As the config names it, from the project root */
5
+ file: string;
6
+ /** Whether blazon could read the file */
7
+ found: boolean;
8
+ /** The `logos` asset this file is, when it is one */
9
+ asset?: string;
10
+ /** The color the asset's sidecar declares for it; without one a reader judges the file as black on light or white on dark */
11
+ ink?: string;
12
+ }
13
+ export interface LogoAsset {
14
+ id: string;
15
+ /** From the project root */
16
+ file: string;
17
+ /** The configured variants that use this file */
18
+ variants: ('onLight' | 'onDark')[];
19
+ /** What the sidecar says, as brand.json carries it: clearSpace, minSize, maxSize, replacedBelow, lockup, placement, partnership, initiative, unit, ink, background, do, dont */
20
+ rules: AssetMeta;
21
+ }
22
+ export interface LogoDescription {
23
+ variants: LogoVariant[];
24
+ assets: LogoAsset[];
25
+ /** Backgrounds that forbid a logo variant, whatever their contrast: the token or group, the variants and the reason */
26
+ forbidden: {
27
+ at: string;
28
+ deny: string[];
29
+ reason?: string;
30
+ }[];
31
+ }
32
+ /** The configured logo variants, each logo asset with the rules of its sidecar, and the backgrounds that forbid a variant. */
33
+ export declare function describeLogo(data: BlazonData, config: BlazonConfig, cwd: string): LogoDescription;
34
+ //# sourceMappingURL=logo.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../../../src/core/read/logo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKhF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6HAA6H;IAC7H,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,QAAQ,EAAE,CAAC,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC;IACnC,gLAAgL;IAChL,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,uHAAuH;IACvH,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED,8HAA8H;AAC9H,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CA6BjG"}
@@ -0,0 +1,9 @@
1
+ import { BlazonData, TokenItem } from '../../types/index.js';
2
+ /** What the read commands cannot answer because of what they were asked: no such token, or not a color. The CLI ends these with exit 2. */
3
+ export declare class LookupError extends Error {
4
+ }
5
+ /** A token path as typed: `{color.brand}` and `color.brand` are the same path. */
6
+ export declare const cleanPath: (typed: string) => string;
7
+ /** The token at `typed`, or a LookupError that names the closest path when there is one near. */
8
+ export declare function findToken(data: BlazonData, typed: string): TokenItem;
9
+ //# sourceMappingURL=lookup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../../src/core/read/lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGlE,2IAA2I;AAC3I,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAEzC,kFAAkF;AAClF,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAI/B,CAAC;AAEZ,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAYpE"}
@@ -0,0 +1,80 @@
1
+ import { ContrastLevel, BlazonData, BlazonExtension, TokenItem } from '../../types/index.js';
2
+ /** The rules the brand writes as data (RFC 0001 section 2), each with the token or group it is written on. */
3
+ export interface UsageRule {
4
+ allow?: string[];
5
+ deny?: string[];
6
+ /** The token or group that states it; a token under that group has it too */
7
+ from: string;
8
+ }
9
+ export interface LogoRule {
10
+ deny: string[];
11
+ reason?: string;
12
+ from: string;
13
+ }
14
+ export interface PairRule {
15
+ fg: string;
16
+ bg: string;
17
+ min: ContrastLevel;
18
+ /** The group that lists the pair */
19
+ from: string;
20
+ }
21
+ export interface ReviewRule {
22
+ status: 'ok' | 'needs-review';
23
+ note?: string;
24
+ by?: string;
25
+ at?: string;
26
+ /** The token or group the review is written on. A group's review covers the tokens under it */
27
+ from: string;
28
+ }
29
+ /** The rules that apply to one token: what it carries from its groups, and the pairs that name it. */
30
+ export interface TokenRules {
31
+ role?: {
32
+ value: string;
33
+ from: string;
34
+ };
35
+ usage?: UsageRule;
36
+ logo?: LogoRule;
37
+ /** Every pair, in any group, that has this token as foreground or background (`.*` expanded) */
38
+ pairs: (PairRule & {
39
+ as: 'fg' | 'bg';
40
+ })[];
41
+ review?: ReviewRule;
42
+ }
43
+ /**
44
+ * The path of the node that wrote `field` for this token: the token itself, else the nearest group above it. It follows how the token's
45
+ * `blazon` is merged (nearest wins, field by field). `review` does not pass down, so there it is the nearest group that has one.
46
+ */
47
+ export declare function writtenOn(data: BlazonData, item: TokenItem, field: keyof BlazonExtension): string | undefined;
48
+ export declare function usageOf(data: BlazonData, item: TokenItem): UsageRule | undefined;
49
+ /** Every pair the brand lists, in the order of its groups. */
50
+ export declare function allPairs(data: BlazonData): PairRule[];
51
+ /** The rules that apply to a token, with where each is written. */
52
+ export declare function tokenRules(data: BlazonData, item: TokenItem): TokenRules;
53
+ /** One node that writes rules: a group, or a token with rules of its own. */
54
+ export interface RuleEntry {
55
+ at: string;
56
+ kind: 'group' | 'token';
57
+ /** True for a group above the path asked about, whose rules pass down to it */
58
+ inherited?: boolean;
59
+ role?: string;
60
+ usage?: {
61
+ allow?: string[];
62
+ deny?: string[];
63
+ };
64
+ logo?: {
65
+ deny: string[];
66
+ reason?: string;
67
+ };
68
+ /** Pairs the group lists (a token lists none) */
69
+ pairs?: {
70
+ fg: string;
71
+ bg: string;
72
+ min: ContrastLevel;
73
+ }[];
74
+ }
75
+ /**
76
+ * The rules written at or under a group, or on the whole brand when `prefix` is empty: one entry for each group and each token that writes
77
+ * a `role`, `usage`, `logo` or `pairs`. A group under a path also lists the groups above it that pass rules down, marked `inherited`.
78
+ */
79
+ export declare function ruleEntries(data: BlazonData, prefix: string): RuleEntry[];
80
+ //# sourceMappingURL=rules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/core/read/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKlG,8GAA8G;AAE9G,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,aAAa,CAAC;IACnB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,IAAI,GAAG,cAAc,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sGAAsG;AACtG,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,gGAAgG;IAChG,KAAK,EAAE,CAAC,QAAQ,GAAG;QAAE,EAAE,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,EAAE,CAAC;IAC1C,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAKD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,CAI7G;AAID,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAOhF;AAUD,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,EAAE,CAErD;AAmBD,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,UAAU,CAYxE;AAED,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9C,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,iDAAiD;IACjD,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,aAAa,CAAA;KAAE,EAAE,CAAC;CAC1D;AAmBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAyBzE"}
@@ -0,0 +1,46 @@
1
+ import { BlazonData, TokenItem, TokenType } from '../../types/index.js';
2
+ import { TokenRules } from './rules.js';
3
+ /** The names a token has in the two CSS files `blazon tokens` writes. */
4
+ export interface TokenNames {
5
+ theme: {
6
+ /** In theme.css, from the token's path */
7
+ variable: string;
8
+ /** A composite token also writes one variable for each part: `{ fontSize: '--type-h1-font-size' }` */
9
+ parts?: Record<string, string>;
10
+ };
11
+ /** In tailwind.css, from Tailwind's namespace. Null when the token maps to none (only colors, font families, radii and spacing do) */
12
+ tailwind: {
13
+ variable: string;
14
+ shadowedBy?: string;
15
+ } | null;
16
+ /** In typography.css, for a typography token */
17
+ typographyClass?: string;
18
+ }
19
+ export declare function tokenNames(data: BlazonData, item: TokenItem): TokenNames;
20
+ export interface TokenDescription {
21
+ path: string;
22
+ type?: TokenType;
23
+ /** CSS-ready, aliases resolved */
24
+ value: string | number;
25
+ /** A composite token's parts, CSS-ready */
26
+ parts?: Record<string, string | number>;
27
+ description?: string;
28
+ deprecated?: boolean | string;
29
+ /** The token this one aliases directly */
30
+ aliasOf?: string;
31
+ tier?: string;
32
+ names: TokenNames;
33
+ rules: TokenRules;
34
+ /** Other values this token has in a resolver context, with the selector the context's CSS block uses */
35
+ contexts?: {
36
+ modifier: string;
37
+ context: string;
38
+ selector: string;
39
+ value: string | number;
40
+ }[];
41
+ /** The token file, from the project root */
42
+ sourceFile: string;
43
+ }
44
+ /** Everything the brand says about one token, from the same compile every other command uses. */
45
+ export declare function describeToken(data: BlazonData, typedPath: string): TokenDescription;
46
+ //# sourceMappingURL=token.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/core/read/token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAK7E,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE;QACL,0CAA0C;QAC1C,QAAQ,EAAE,MAAM,CAAC;QACjB,sGAAsG;QACtG,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;IACF,sIAAsI;IACtI,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,UAAU,CAUxE;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,kCAAkC;IAClC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,wGAAwG;IACxG,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7F,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAmBnF"}
@@ -0,0 +1,9 @@
1
+ /** The file in plugins/ at the package root that lists the plugins blazon ships (RFC 0005 section 3.6). */
2
+ export declare const SHIPPED_LOCK = "shipped.lock";
3
+ /**
4
+ * The names of the plugins blazon ships, sorted; empty when the lock cannot be read. Only for a hint to the person who
5
+ * wrote the config ("blazon ships: ..."): it reads the names and trusts nothing, so a damaged lock still lists what it
6
+ * names. The host checks the lock strictly before it runs anything (src/plugins/pins/shipped.ts).
7
+ */
8
+ export declare function shippedNames(): string[];
9
+ //# sourceMappingURL=shipped-names.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shipped-names.d.ts","sourceRoot":"","sources":["../../src/core/shipped-names.ts"],"names":[],"mappings":"AAKA,2GAA2G;AAC3G,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CASvC"}
@@ -0,0 +1,31 @@
1
+ import { Finding } from '../types/index.js';
2
+ /** The starter's folder: `examples/blazon/` when run from source, else the package's `template/`. */
3
+ export declare function getTemplateDir(): string;
4
+ /**
5
+ * The example's config as a new book's: its `plugins` list cut to the ones in `STARTER_PLUGINS`. The others draw in Google Chrome or
6
+ * write kits a new book has no use for yet, so a first `blazon build` does not need a browser; JSON has no comments, so they are
7
+ * left out, and the manual (chapter 12) says how to add one. A config already cut comes back as it is.
8
+ */
9
+ export declare function starterConfig(source: string): string;
10
+ /** The starter's files, as paths relative to its folder. */
11
+ export declare function starterFiles(template?: string): string[];
12
+ /** Copies the starter into `dest`, leaving a file that is already there as it is; returns the files it wrote and the ones it kept (absolute). */
13
+ export declare function copyStarter(dest: string, template?: string): {
14
+ written: string[];
15
+ kept: string[];
16
+ };
17
+ /**
18
+ * A warning when a configured logo file is byte for byte the starter's: the book would show blazon's mark under another
19
+ * brand's name. The `starter-file-unchanged` note says the same in passing, and is easy to miss among the others.
20
+ */
21
+ export declare function starterLogoFindings(cwd: string, logoFiles: string[], template?: string): Finding[];
22
+ /**
23
+ * One info finding for each file in the docs, tokens, assets or fonts folder (sidecars included) that is byte for byte the
24
+ * file `blazon init` put there. The fonts folder is `fonts/` beside the config, as `init` makes it. The config is left out,
25
+ */
26
+ export declare function starterFileFindings(cwd: string, folders: {
27
+ docs: string;
28
+ tokens: string;
29
+ assets: string;
30
+ }, template?: string): Finding[];
31
+ //# sourceMappingURL=starter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"starter.d.ts","sourceRoot":"","sources":["../../src/core/starter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAWjD,qGAAqG;AACrG,wBAAgB,cAAc,IAAI,MAAM,CAWvC;AAKD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,QAAQ,GAAE,MAAyB,GAAG,MAAM,EAAE,CAI1E;AAED,iJAAiJ;AACjJ,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAyB,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAepH;AA6BD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,MAAyB,GAAG,OAAO,EAAE,CAiBpH;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,GAAE,MAAyB,GAAG,OAAO,EAAE,CAc1J"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * The name that `typed` was most likely meant to be, or undefined when none is near. A name is near when it is within a third
3
+ * of the longer word's length (at least one letter) of what was typed: `chek` is `check`, `zzzzzzzz` is nothing. The first
4
+ * of two equally near names wins.
5
+ */
6
+ export declare function closest(typed: string, names: string[]): string | undefined;
7
+ //# sourceMappingURL=suggest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/core/suggest.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAQ1E"}
@@ -0,0 +1,18 @@
1
+ import { Finding, TokenType } from '../../types/index.js';
2
+ import { DeclaredToken } from './walk.js';
3
+ import { CheckCode } from '../checker/catalogue.js';
4
+ /** Returns the target path when `value` is exactly one alias, e.g. "{color.brand.indigo}". */
5
+ export declare function aliasTarget(value: unknown): string | undefined;
6
+ export declare class Resolver {
7
+ private readonly declared;
8
+ private readonly resolved;
9
+ private readonly resolving;
10
+ readonly problems: Finding[];
11
+ constructor(tokens: DeclaredToken[]);
12
+ /** Resolves a token's `$value`, following aliases through nested composite values. */
13
+ token(path: string): unknown;
14
+ private value;
15
+ typeOf(token: DeclaredToken, seen?: Set<string>): TokenType | undefined;
16
+ report(path: string, code: CheckCode, message: string): void;
17
+ }
18
+ //# sourceMappingURL=alias.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"alias.d.ts","sourceRoot":"","sources":["../../../src/core/tokens/alias.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAMlE,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAM;gBAEtB,MAAM,EAAE,aAAa,EAAE;IAInC,sFAAsF;IACtF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU5B,OAAO,CAAC,KAAK;IA2Bb,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,cAAoB,GAAG,SAAS,GAAG,SAAS;IAS7E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAG7D"}
@@ -0,0 +1,10 @@
1
+ import { TokenContext, TokenItem } from '../../types/index.js';
2
+ /**
3
+ * The default's tokens with the changes of `contexts` in place, in the default's order, then any token only a context has.
4
+ *
5
+ * A change is applied field by field: what a context's token has that the default's does not, and what it lacks that the default's has. So two
6
+ * contexts that change one token in different ways (one its value, one its description) both show, whichever comes first, and where they change
7
+ * the same field the later context wins.
8
+ */
9
+ export declare function contextItems(items: readonly TokenItem[], contexts: readonly Pick<TokenContext, 'tokens' | 'metadataChanges'>[]): TokenItem[];
10
+ //# sourceMappingURL=contexts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contexts.d.ts","sourceRoot":"","sources":["../../../src/core/tokens/contexts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAWpE;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,SAAS,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,iBAAiB,CAAC,EAAE,GAAG,SAAS,EAAE,CAmB5I"}
@@ -0,0 +1,15 @@
1
+ import { ParsedTokens, TokenItem } from '../../../types/index.js';
2
+ export interface CssFormatterOptions {
3
+ selector?: string;
4
+ prefix?: string;
5
+ }
6
+ /** Every custom property a token writes in theme.css: its own, then one per composite part. */
7
+ export declare function tokenVariables(token: TokenItem): string[];
8
+ /** Formats resolved tokens as CSS custom properties, one commented block per top-level group. */
9
+ export declare function formatCssTokens(parsed: ParsedTokens, options?: CssFormatterOptions): string;
10
+ /**
11
+ * Formats one utility class per typography token, e.g. `.type-h1 { font: var(--type-h1); ... }`.
12
+ * Returns undefined when there are no typography tokens.
13
+ */
14
+ export declare function formatTypographyCss(parsed: ParsedTokens): string | undefined;
15
+ //# sourceMappingURL=css.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/css.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,CAEzD;AAaD,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAa/F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAY5E"}
@@ -0,0 +1,4 @@
1
+ import { ParsedTokens } from '../../../types/index.js';
2
+ /** Formats resolved tokens as a DTCG document: aliases replaced, `$extensions` kept for other tools. */
3
+ export declare function formatJsonTokens(parsed: ParsedTokens): string;
4
+ //# sourceMappingURL=json.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,wGAAwG;AACxG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAoB7D"}
@@ -0,0 +1,37 @@
1
+ import { ParsedTokens, TokenItem } from '../../../types/index.js';
2
+ interface Namespace {
3
+ /** The prefix of the variables written: `color` for `--color-brand` */
4
+ prefix: string;
5
+ /** What the reset in tailwind-reset.css writes for it, and what chapter 8 names; undefined where nothing is reset */
6
+ reset?: string;
7
+ /** The token types and groups it takes, for chapter 8 */
8
+ takes: string;
9
+ /** Whether a token belongs to it; `path` is the token's path in kebab-case */
10
+ match: (token: TokenItem, path: string[]) => boolean;
11
+ /** Leading path words that repeat the namespace and are left out of the variable name */
12
+ drop: string[];
13
+ /** Words anywhere in the path that are left out too (a `family` in `font.family.sans`) */
14
+ dropAnywhere?: boolean;
15
+ }
16
+ /**
17
+ * Every Tailwind v4 theme namespace a token can fill. The order is the order of the tables in chapter 8 and of the reset file.
18
+ * A token type with no Tailwind namespace (border, transition and typography composites, gradients, other dimensions and numbers) is not here.
19
+ */
20
+ export declare const TAILWIND_NAMESPACES: readonly Namespace[];
21
+ /** The namespaces that at least one token of the brand fills, in the order of TAILWIND_NAMESPACES. */
22
+ export declare function filledNamespaces(parsed: ParsedTokens): Namespace[];
23
+ /** The variable a token writes in tailwind.css, or undefined where the token maps to no Tailwind namespace. */
24
+ export declare function tailwindVariable(token: TokenItem): string | undefined;
25
+ /**
26
+ * Formats the tokens that fill a namespace of TAILWIND_NAMESPACES as a Tailwind v4 `@theme` block, with the default
27
+ * context's values. A variable named like one in theme.css (`--color-indigo`) holds the same value.
28
+ * Returns undefined when no token maps to a Tailwind namespace.
29
+ */
30
+ export declare function formatTailwindTheme(parsed: ParsedTokens): string | undefined;
31
+ /**
32
+ * A `@theme` block that sets `initial` on each Tailwind namespace the brand fills, so only the brand's values remain once tailwind.css is
33
+ * imported after it. Returns undefined when no token maps to a namespace.
34
+ */
35
+ export declare function formatTailwindReset(parsed: ParsedTokens): string | undefined;
36
+ export {};
37
+ //# sourceMappingURL=tailwind.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tailwind.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/tailwind.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAWvE,UAAU,SAAS;IACjB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,qHAAqH;IACrH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,KAAK,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IACrD,yFAAyF;IACzF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,0FAA0F;IAC1F,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAMD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,SAAS,EAoDnD,CAAC;AAQF,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,EAAE,CAElE;AAED,+GAA+G;AAC/G,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAUrE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAY5E;AAmBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAI5E"}
@@ -0,0 +1,6 @@
1
+ import { ParsedTokens } from '../../../types/index.js';
2
+ /**
3
+ * Formats resolved tokens into strongly-typed TypeScript
4
+ */
5
+ export declare function formatTsTokens(parsed: ParsedTokens): string;
6
+ //# sourceMappingURL=ts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ts.d.ts","sourceRoot":"","sources":["../../../../src/core/tokens/formatters/ts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAkB5D;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAkD3D"}