@iksnerd/blazon 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (503) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +264 -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-vpzUWoiA.js +13777 -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 +593 -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 +152 -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 +69 -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-BdbihVvH.js +77 -0
  423. package/dist/ui/assets/index-DluSqfla.css +2 -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 +38 -0
  451. package/plugins/blazon.print-book/bin/blazon-blazon.print-book./360/237/224/214 +9262 -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,31 @@
1
+ /** A manifest that section 3.8 refuses. */
2
+ export declare class ManifestError extends Error {
3
+ constructor(message: string);
4
+ }
5
+ /** What a host defines for itself and a manifest must fit. */
6
+ export interface Profile {
7
+ roles: readonly string[];
8
+ /** The request fields a role's schema marks as able to hold a secret, as JSON Pointers. None until a schema marks one */
9
+ secretFields?: readonly string[];
10
+ /** Seconds, for a role whose profile raises the cap on one call. A role not listed has the core's cap */
11
+ timeoutCaps?: Readonly<Record<string, number>>;
12
+ }
13
+ export interface Manifest {
14
+ roles: string[];
15
+ /** 0 when the manifest has none. A value too large for a double is held as the largest safe integer, since a host caps it */
16
+ timeoutMs: number;
17
+ env: string[];
18
+ secretEnv: string[];
19
+ secretFields: string[];
20
+ title: string;
21
+ description: string;
22
+ version: string;
23
+ homepage: string;
24
+ }
25
+ /** Read the one JSON object a plugin printed and refuse anything section 3.8 refuses. */
26
+ export declare function decodeManifest(raw: string | Uint8Array, profile: Profile): Manifest;
27
+ /** The cap on one call of a plugin with these roles: the highest any of them has, never under the core's. */
28
+ export declare function profileTimeoutCap(profile: Profile, roles: readonly string[]): number;
29
+ /** Seconds one call may take: the manifest's `timeout_ms`, or 5 when it has none, never more than the cap. `cap` is a number of seconds, or the profile that gives it. */
30
+ export declare function manifestTimeout(manifest: Manifest, cap: number | Profile): number;
31
+ //# sourceMappingURL=manifest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/plugins/wire/manifest.ts"],"names":[],"mappings":"AAMA,2CAA2C;AAC3C,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,8DAA8D;AAC9D,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,yHAAyH;IACzH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,yGAAyG;IACzG,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6HAA6H;IAC7H,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAiED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,QAAQ,CA0CnF;AAED,6GAA6G;AAC7G,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEpF;AAED,0KAA0K;AAC1K,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAIjF"}
@@ -0,0 +1,36 @@
1
+ import { Profile } from './manifest.js';
2
+ /** One role of the document (RFC 0005 section 2). */
3
+ export interface RoleDocument {
4
+ name: string;
5
+ /** For each exit code the role defines, what it means. A code that is not here is a break */
6
+ exit_codes: Record<string, string>;
7
+ /** Behind the breaker: stops being called for the rest of a run after three breaks in a row */
8
+ breaker?: boolean;
9
+ pinned?: 'always' | 'by_rule';
10
+ /** The cap on one call, in milliseconds, when the role raises the core's */
11
+ timeout_cap_ms?: number;
12
+ /** The most one call may print, in bytes, when the role raises the core's */
13
+ stdout_limit_bytes?: number;
14
+ }
15
+ export interface ProfileDocument {
16
+ v: 1;
17
+ host: string;
18
+ check_command: string;
19
+ roles: RoleDocument[];
20
+ adopts: string[];
21
+ secret_fields?: string[];
22
+ secret_env_prefixes: string[];
23
+ request_cap_bytes: number;
24
+ }
25
+ export declare const BLAZON_PROFILE: ProfileDocument;
26
+ /** What a manifest must fit, built from the document: its roles, the request fields marked as able to hold a secret, and a role's raised timeout cap in seconds. */
27
+ export declare const BLAZON_CORE_PROFILE: Profile;
28
+ /** How one call of a role is held, read from the document: the exit codes that are answers, the stdout limit when the role raises it, and whether the role is behind the breaker. */
29
+ export declare function roleRuntime(role: string): {
30
+ answers: number[];
31
+ stdoutLimit?: number;
32
+ breaker: boolean;
33
+ };
34
+ /** A valid request for each role, as the check command sends it with a canary set. A plugin answers it with its findings. */
35
+ export declare function blazonRequests(): Record<string, string>;
36
+ //# sourceMappingURL=profile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/plugins/wire/profile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAM7C,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,+FAA+F;IAC/F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc,EAAE,eAsB5B,CAAC;AAEF,oKAAoK;AACpK,eAAO,MAAM,mBAAmB,EAAE,OAIjC,CAAC;AAEF,qLAAqL;AACrL,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAIvG;AAED,6HAA6H;AAC7H,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMvD"}
@@ -0,0 +1,14 @@
1
+ /** Check the text a manifest holds for people: no control (Cc) or format (Cf) character, not only white space, 1 to `maximum` grapheme clusters. Throws an Error naming `field`. */
2
+ export declare function plainText(field: string, value: string, maximum: number): void;
3
+ export declare function graphemeCount(value: string): number;
4
+ /** Cut `value` to at most `n` user-perceived characters, never in the middle of one. */
5
+ export declare function truncateGraphemes(value: string, n: number): string;
6
+ export declare const MAX_MESSAGE = 300;
7
+ /**
8
+ * What a host shows for a plugin that exited 2: the first line of stdout, cleaned. Ignored when it is not valid
9
+ * UTF-8. Every control (Cc) and format (Cf) character is removed, white space trimmed, and the rest cut to 300
10
+ * grapheme clusters. Every labelled value in `secrets` is scrubbed after those characters are removed, so a value split by
11
+ * one is found. When nothing is left, `fallback`: a message of the host's own that names the plugin.
12
+ */
13
+ export declare function message(raw: Uint8Array, fallback: string, secrets?: readonly string[]): string;
14
+ //# sourceMappingURL=text.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/plugins/wire/text.ts"],"names":[],"mappings":"AAOA,oLAAoL;AACpL,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAO7E;AA8CD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,CAalG"}
@@ -0,0 +1,13 @@
1
+ import { IncomingMessage, ServerResponse } from 'node:http';
2
+ /**
3
+ * Serves image files from the assets folder under `/brand-assets/`, and a category's files from its own
4
+ * folder when the config gives it one (`categoryDirs`, by category key). The dev server listens on all
5
+ * interfaces, so this is reachable from the network: only image types are served, and a path that
6
+ * resolves outside the folder it is looked up in (`..`, encoded `..`, or a symlink) gets a 404 like any
7
+ * missing file.
8
+ */
9
+ export declare function serveAssetFiles(assetsDir: () => string, categoryDirs?: () => Record<string, string>): (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
10
+ /** The real path of a request below `root`, or undefined when it is missing, not a file, or escapes `root`. */
11
+ export declare function resolveInside(root: string, url: string): string | undefined;
12
+ export declare function notFound(res: ServerResponse): void;
13
+ //# sourceMappingURL=assets.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/server/assets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,MAAM,EAAE,YAAY,GAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAc,IACtG,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,MAAM,IAAI,KAAG,IAAI,CAc3E;AAeD,+GAA+G;AAC/G,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB3E;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAIlD"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Gathers what is added to it and calls `handler` once with all of it, `delayMs` after the last addition. A save is one file event and a `git
3
+ * checkout` is dozens, and each used to compile the brand and send an update of its own; a burst is now one change. The handlers run one at a
4
+ * time, in order, so a burst that ends while the last compile is still running waits for it and does not race it. A failure is passed to
5
+ * `onError` and does not stop the next burst.
6
+ */
7
+ export declare function coalesce<T>(delayMs: number, handler: (items: T[]) => Promise<void> | void, onError: (error: unknown) => void): {
8
+ add(item: T): void;
9
+ /** Drops what is waiting. A handler that is already running finishes. */
10
+ cancel(): void;
11
+ };
12
+ //# sourceMappingURL=coalesce.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"coalesce.d.ts","sourceRoot":"","sources":["../../src/server/coalesce.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;cAa/G,CAAC,GAAG,IAAI;IAOlB,yEAAyE;cAC/D,IAAI;EAMjB"}
@@ -0,0 +1,8 @@
1
+ import { BlazonData } from '../types/index.js';
2
+ /** Id of the inline JSON script the prebuilt viewer reads its BlazonData from. */
3
+ export declare const DATA_SCRIPT_ID = "blazon-data";
4
+ /** JSON safe inside a <script> element: escaping "<" means no "</script>" or "<!--" can end it early. */
5
+ export declare function serializeBlazonData(data: BlazonData): string;
6
+ /** Writes the brand book's data into the prebuilt viewer's index.html. */
7
+ export declare function injectBlazonData(html: string, data: BlazonData): string;
8
+ //# sourceMappingURL=data-script.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"data-script.d.ts","sourceRoot":"","sources":["../../src/server/data-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,kFAAkF;AAClF,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C,yGAAyG;AACzG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAE5D;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAIvE"}
@@ -0,0 +1,34 @@
1
+ import { ViteDevServer } from 'vite';
2
+ import { BlazonConfig } from '../types/index.js';
3
+ export type ViewerSource =
4
+ /** Running blazon from its own source: Vite compiles src/viewer with vite.viewer.config.ts and hot-reloads it */
5
+ {
6
+ kind: 'source';
7
+ configFile: string;
8
+ }
9
+ /** Installed blazon: the viewer was compiled at publish time into dist/ui */
10
+ | {
11
+ kind: 'prebuilt';
12
+ dir: string;
13
+ };
14
+ /**
15
+ * Finds the brand book viewer. Brand books never compile it; only blazon's own source checkout does.
16
+ */
17
+ export declare function resolveViewer(): ViewerSource;
18
+ /** The prebuilt viewer directory, for static builds. A source checkout needs `npm run build` first. */
19
+ export declare function resolvePrebuiltViewerDir(): string;
20
+ /**
21
+ * What the dev server may read over `/@fs/`. Vite's default is the workspace root found above the viewer: for an installed blazon the
22
+ * package root, and only because blazon's own package.json carries a `workspaces` field (the search stops there; without it a folder above
23
+ * would be next). The viewer needs its own folder and nothing else: never the brand (served by /brand-assets and /brand.json) and never a
24
+ * parent folder. `strict` stays on and Vite's `deny` list (.env, keys, .git) is kept.
25
+ */
26
+ export declare function viewerFsOptions(viewer: ViewerSource): {
27
+ strict: true;
28
+ allow: string[];
29
+ };
30
+ export declare function startDevServer(config: BlazonConfig, cwd?: string, options?: {
31
+ strictPort?: boolean;
32
+ host?: string | boolean;
33
+ }): Promise<ViteDevServer>;
34
+ //# sourceMappingURL=dev-server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/server/dev-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAIxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,MAAM,MAAM,YAAY;AACtB,iHAAiH;AAC/G;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACxC,6EAA6E;GAC3E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAQ5C;AAED,uGAAuG;AACvG,wBAAgB,wBAAwB,IAAI,MAAM,CAMjD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAEvF;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,GAAE,MAAsB,EAAE,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA+B/K"}
@@ -0,0 +1,13 @@
1
+ import { IncomingMessage, ServerResponse } from 'node:http';
2
+ import { Plugin } from 'vite';
3
+ /** The route Vite registers for its "open in editor" overlay link. */
4
+ export declare const OPEN_IN_EDITOR_ROUTE = "/__open-in-editor";
5
+ /**
6
+ * Answers 404 on Vite's `/__open-in-editor?file=...`. Vite registers that route on every dev server with no option to turn it off, and
7
+ * a request to it, which any web page can make to localhost, makes a running editor open the named local path. Blazon has no use for it.
8
+ * The hook runs before Vite adds its own middleware, so this one answers first.
9
+ */
10
+ export declare function refuseEditorLauncher(_req: IncomingMessage, res: ServerResponse): void;
11
+ /** The Vite plugin that puts the refusal in front of the dev server's launch-editor middleware, and in front of the preview server's routes. */
12
+ export declare const editorLauncherGuard: () => Plugin;
13
+ //# sourceMappingURL=editor-guard.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"editor-guard.d.ts","sourceRoot":"","sources":["../../src/server/editor-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAIrF;AAED,gJAAgJ;AAChJ,eAAO,MAAM,mBAAmB,QAAO,MAQrC,CAAC"}
@@ -0,0 +1,11 @@
1
+ import { Finding } from '../types/index.js';
2
+ /**
3
+ * What `blazon dev` says in its terminal about the brand as files change. The viewer shows every finding, but a person or an agent
4
+ * watching the terminal saw nothing while the book was broken. Each error is said once, however many saves leave it there, and when
5
+ * the last one is gone it says so. Warnings and notes stay in the viewer and in `blazon check`.
6
+ */
7
+ export declare class ErrorReporter {
8
+ private shown;
9
+ report(findings: Finding[], say: (line: string) => void): void;
10
+ }
11
+ //# sourceMappingURL=error-reporter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error-reporter.d.ts","sourceRoot":"","sources":["../../src/server/error-reporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAajD;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAqB;IAElC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAQ/D"}
@@ -0,0 +1,9 @@
1
+ import { IncomingMessage, ServerResponse } from 'node:http';
2
+ import { IconSetConfig } from '../types/index.js';
3
+ /**
4
+ * Serves an icon set's SVGs from its package under `/brand-assets/icon-sets/<name>/<icon>.svg`. Only a
5
+ * `.svg` directly inside the set's folder is served: anything else in the package (README, package.json,
6
+ * a link out of it) gets a 404 like any missing file.
7
+ */
8
+ export declare function serveIconSets(sets: () => IconSetConfig[], cwd: string): (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
9
+ //# sourceMappingURL=icon-sets.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"icon-sets.d.ts","sourceRoot":"","sources":["../../src/server/icon-sets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,aAAa,EAAE,EAAE,GAAG,EAAE,MAAM,IAC5D,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,MAAM,IAAI,KAAG,IAAI,CAe3E"}
@@ -0,0 +1,4 @@
1
+ import { Plugin } from 'vite';
2
+ import { BlazonConfig } from '../types/index.js';
3
+ export declare function createBlazonVitePlugin(initialConfig: BlazonConfig, cwd?: string): Plugin;
4
+ //# sourceMappingURL=plugin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/server/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,MAAM,EAAiB,MAAM,MAAM,CAAC;AAGrE,OAAO,EAAgC,KAAK,YAAY,EAAmB,MAAM,mBAAmB,CAAC;AA8BrG,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAgOvG"}
@@ -0,0 +1,11 @@
1
+ import { IncomingMessage, ServerResponse } from 'node:http';
2
+ import { Plugin } from 'vite';
3
+ /**
4
+ * Refuses a request for a file of the built site that is a link leaving the site's folder. Vite's preview server follows links, so a
5
+ * `dist/site` that carries `leak.txt -> ~/.ssh/id_rsa` (a built folder is easy to ship in a repository) would serve what it points at. A
6
+ * path that does not exist passes on, to the 404 or the page fallback.
7
+ */
8
+ export declare function guardSiteLinks(outDir: string): (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
9
+ /** The Vite plugin that puts the guard in front of the preview server's own file serving. */
10
+ export declare const siteLinkGuard: (outDir: string) => Plugin;
11
+ //# sourceMappingURL=preview-guard.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"preview-guard.d.ts","sourceRoot":"","sources":["../../src/server/preview-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAInC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,IACnC,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,MAAM,IAAI,KAAG,IAAI,CAc3E;AAED,6FAA6F;AAC7F,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,MAK7C,CAAC"}
@@ -0,0 +1,130 @@
1
+ import { Review } from './tokens.js';
2
+ export type AssetFormat = 'svg' | 'png' | 'jpg' | 'gif' | 'webp' | 'avif';
3
+ /** URL path the brand book serves asset files under, in dev and in the static build. */
4
+ export declare const ASSET_URL_BASE = "brand-assets";
5
+ /** A DTCG dimension as the asset sidecars state it. */
6
+ export interface AssetDimension {
7
+ value: number;
8
+ unit: 'px' | 'rem';
9
+ }
10
+ /**
11
+ * A length a sidecar states: a dimension in the artwork's own pixels, or a multiple of the artwork's
12
+ * `unit`, which is how brand guidelines write it ("clear space equals the height of the star").
13
+ */
14
+ export type AssetMeasure = AssetDimension | {
15
+ units: number;
16
+ };
17
+ /** The shapes a logo comes in (RFC 0001 §10): a standard one, or one the brand added in `vocabulary.lockups`. */
18
+ export type LogoLockup = string;
19
+ export declare const STANDARD_LOGO_LOCKUPS: readonly ["horizontal", "stacked", "mark", "wordmark"];
20
+ /** Where a logo may sit on a layout. */
21
+ export type LogoCorner = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
22
+ export declare const LOGO_CORNERS: readonly LogoCorner[];
23
+ /** How the logo sits beside a partner's: the gap on each side of a divider, and the divider's height. */
24
+ export interface LogoPartnership {
25
+ /** The space on each side of the divider, or between the logos when there is none */
26
+ gap: AssetMeasure;
27
+ /** The divider's height; a partnership without one has no divider */
28
+ dividerHeight?: AssetMeasure;
29
+ /** The partner logo's height; the logo's own height when absent */
30
+ partnerHeight?: AssetMeasure;
31
+ }
32
+ /** Where a program's mark sits against the logo: to its right on one baseline, or under it, left edges aligned. */
33
+ export type InitiativePosition = 'beside' | 'below';
34
+ export declare const INITIATIVE_POSITIONS: readonly InitiativePosition[];
35
+ /** A program the brand runs, drawn with the logo as the program lockup (RFC 0001 §10). */
36
+ export interface LogoInitiative {
37
+ /** The program's name: the label of the lockup and its accessible name */
38
+ name: string;
39
+ /** The program's artwork, as an asset id written category/name */
40
+ mark: string;
41
+ /** The space between the logo and the mark */
42
+ gap: AssetMeasure;
43
+ /** Beside the logo when absent */
44
+ position?: InitiativePosition;
45
+ /** The mark's height; the logo's own height when absent */
46
+ markHeight?: AssetMeasure;
47
+ }
48
+ /** What a `<name>.json` sidecar beside an asset says about it (RFC 0001 §7, §10). */
49
+ export interface AssetMeta {
50
+ /** A name for the asset where the file name will not do: "Lifestyle" for `lifestyle-01.webp` */
51
+ title?: string;
52
+ description?: string;
53
+ /** The qualities the brand asks of this kind of asset, as short plain statements */
54
+ traits?: string[];
55
+ /** What to do, and what not to do, as short plain statements */
56
+ do?: string[];
57
+ dont?: string[];
58
+ /** The background the artwork is made for: `dark` for a white logo */
59
+ background?: 'light' | 'dark';
60
+ /** The artwork's main color as a CSS color (a token alias in the sidecar is resolved), so a logo can be chosen for a background by contrast */
61
+ ink?: string;
62
+ /** The length the brand measures this artwork in, in its own pixels: the star, say */
63
+ unit?: AssetDimension;
64
+ /** Space to keep free around the artwork */
65
+ clearSpace?: AssetMeasure;
66
+ /** The smallest size it may be shown at */
67
+ minSize?: {
68
+ width?: AssetDimension;
69
+ height?: AssetDimension;
70
+ };
71
+ /** The largest it should be shown, as for a logo drawn only for small sizes */
72
+ maxSize?: {
73
+ width?: AssetDimension;
74
+ height?: AssetDimension;
75
+ };
76
+ /** Below this width or height, use the asset `by` names (category/name) instead */
77
+ replacedBelow?: {
78
+ width?: AssetDimension;
79
+ height?: AssetDimension;
80
+ by: string;
81
+ };
82
+ lockup?: LogoLockup;
83
+ /** The corners the logo may sit in */
84
+ placement?: LogoCorner[];
85
+ partnership?: LogoPartnership;
86
+ initiative?: LogoInitiative;
87
+ /** Where the asset sits among the others of its category, lowest first; assets without one follow, by file name */
88
+ order?: number;
89
+ /** What a consumer records of its own, under a reverse-domain key ("com.acme.contrast"): kept as written, never read by blazon */
90
+ extensions?: Record<string, unknown>;
91
+ source?: {
92
+ doc: string;
93
+ locator: string;
94
+ };
95
+ review?: Review;
96
+ /** Provenance of an AI-generated image: the model or tool, and optionally the prompt and the licence it was used under */
97
+ generated?: {
98
+ by: string;
99
+ prompt?: string;
100
+ licence?: string;
101
+ };
102
+ }
103
+ export interface Asset {
104
+ /** Asset identifier e.g. "logos/master-dark" or "icons/arrow-right" */
105
+ id: string;
106
+ /** Name e.g. "master-dark" */
107
+ name: string;
108
+ /** Category: "logos" | "icons" | custom subfolder; "assets" for files at the top of the folder */
109
+ category: string;
110
+ /** Path relative to the assets directory, with forward slashes */
111
+ filePath: string;
112
+ format: AssetFormat;
113
+ mediaType: string;
114
+ /** Relative URL the brand book loads the file from, e.g. "brand-assets/logos/mark.png" */
115
+ url: string;
116
+ /** File size in bytes */
117
+ bytes: number;
118
+ /** Pixel size for raster files; the width/height attributes, when present, for SVG */
119
+ width?: number | string;
120
+ height?: number | string;
121
+ /** SVG only: the viewBox attribute, e.g. "0 0 24 24" */
122
+ viewBox?: string;
123
+ /** SVG only: the markup with the XML prologue stripped, for copy and inline display */
124
+ svg?: string;
125
+ /** From the sidecar `<name>.json` beside the file, when there is one */
126
+ meta?: AssetMeta;
127
+ }
128
+ /** @deprecated Use `Asset`; assets are no longer SVG only. */
129
+ export type SvgAsset = Asset;
130
+ //# sourceMappingURL=assets.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/types/assets.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,95 @@
1
+ import { Asset, AssetFormat } from './assets.js';
2
+ /** An icon package to preview, from `iconSets` in blazon.json (RFC 0001 §9). */
3
+ export interface IconSetConfig {
4
+ /** Name the directive and the URLs use: lowercase letters, digits and hyphens */
5
+ name: string;
6
+ /** An installed npm package, e.g. "lucide-static", "@tabler/icons", "@mdi/svg" */
7
+ package: string;
8
+ /** Folder of `<icon>.svg` files inside the package; known packages have a default */
9
+ dir?: string;
10
+ /** Brand categories: a map of category name to icon names, or a JSON file in the project holding one */
11
+ categories?: Record<string, string[]> | string;
12
+ }
13
+ export interface IconCategory {
14
+ name: string;
15
+ /** Icon names, which are file names without `.svg` */
16
+ icons: string[];
17
+ }
18
+ /** What the brand book knows of an icon set. The files stay in the package; the build copies them. */
19
+ export interface IconSet {
20
+ name: string;
21
+ package: string;
22
+ version?: string;
23
+ license?: string;
24
+ count: number;
25
+ categories: IconCategory[];
26
+ }
27
+ /** What a brand requires of every file in an asset category (RFC 0001 §11); `blazon check` tests each file against it. */
28
+ export interface AssetRules {
29
+ /** The file formats allowed */
30
+ formats?: AssetFormat[];
31
+ /** The smallest pixel size a raster image may have. Vector files are not measured */
32
+ minPixels?: {
33
+ width?: number;
34
+ height?: number;
35
+ };
36
+ /** The aspect ratios allowed, written "16:9". A file matches one within 1% */
37
+ aspectRatios?: string[];
38
+ }
39
+ /** One entry of the `assets` block in blazon.json: settings for an asset category. */
40
+ export interface AssetCategoryConfig {
41
+ /** Sidebar and page title; the humanized folder name when absent */
42
+ label?: string;
43
+ /** Sort key; ordered categories come first, ascending */
44
+ order?: number;
45
+ /** One line under the page title */
46
+ description?: string;
47
+ /** An extra folder to scan as this category, relative to the project or absolute. It may sit outside the project */
48
+ dir?: string;
49
+ rules?: AssetRules;
50
+ /** What the guidelines leave open, as short plain statements */
51
+ notSpecified?: string[];
52
+ /** Where the guidelines say it */
53
+ source?: {
54
+ doc: string;
55
+ locator: string;
56
+ };
57
+ /** The images are kept out of git, and this sentence says how to make them. A checkout without them gets a note, not errors */
58
+ local?: string;
59
+ /** The files are explorations, not the brand's identity: their `review` does not gate the book, and the deliverables leave them out */
60
+ experimental?: boolean;
61
+ /** The files follow the guidelines but are kept for comparison, or were supplied by someone else: their `review` does not gate the book, and the deck leaves them out. Not together with `experimental` */
62
+ reference?: boolean;
63
+ }
64
+ /** An asset category as the brand book shows it */
65
+ export interface AssetCategoryInfo {
66
+ /** The folder name, as directives and URLs use it, e.g. "photography" */
67
+ category: string;
68
+ /** Sidebar and page title, e.g. "Imagery"; the humanized folder name when the config sets none */
69
+ label: string;
70
+ /** Sort key from the config; categories without one follow: logos, icons, then the rest by name */
71
+ order?: number;
72
+ /** One line shown under the page title */
73
+ description?: string;
74
+ /** What the brand requires of the files in it */
75
+ rules?: AssetRules;
76
+ /** What the guidelines leave open */
77
+ notSpecified?: string[];
78
+ source?: {
79
+ doc: string;
80
+ locator: string;
81
+ };
82
+ /** The images are kept out of git, so a reader must not pass them on; this says how to make them */
83
+ local?: string;
84
+ /** The files are explorations, not the brand's identity: the brand book labels them, and the deliverables leave them out */
85
+ experimental?: true;
86
+ /** The files follow the guidelines but are kept for comparison, or were supplied by someone else: the brand book labels them, and the deck leaves them out */
87
+ reference?: true;
88
+ }
89
+ export interface AssetCatalog {
90
+ logos: Asset[];
91
+ icons: Asset[];
92
+ custom: Record<string, Asset[]>;
93
+ all: Asset[];
94
+ }
95
+ //# sourceMappingURL=catalog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/types/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,sGAAsG;AACtG,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,0HAA0H;AAC1H,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,qFAAqF;IACrF,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oHAAoH;IACpH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kCAAkC;IAClC,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,+HAA+H;IAC/H,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uIAAuI;IACvI,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2MAA2M;IAC3M,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,kGAAkG;IAClG,KAAK,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,oGAAoG;IACpG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4HAA4H;IAC5H,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,8JAA8J;IAC9J,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAChC,GAAG,EAAE,KAAK,EAAE,CAAC;CACd"}
@@ -0,0 +1,97 @@
1
+ import { AssetCategoryConfig, IconSetConfig } from './catalog.js';
2
+ import { SectionId } from './docs.js';
3
+ import { ShadcnVariable, ThemeRole } from './theme.js';
4
+ /** One use of a plugin the operator allows: its name, an optional instance id, and the options blazon passes it in every request. */
5
+ export interface PluginConfig {
6
+ name: string;
7
+ /** The instance id (RFC 0014): what this entry is called when the plugin is listed more than once. Default: `name`. Unique in the list; names the entry's output folder and its breaker */
8
+ as?: string;
9
+ options?: Record<string, unknown>;
10
+ /** The environment variables the operator lets this plugin have. A plugin starts with an empty environment; it gets a variable only when its manifest lists the name in `env` and this list approves it (RFC 0002 section 2) */
11
+ env?: string[];
12
+ }
13
+ export interface BlazonConfig {
14
+ /** Title of the brand book (default: package.json name or "Brand Book") */
15
+ title: string;
16
+ /** Subtitle or short tagline */
17
+ description?: string;
18
+ /** Path to design tokens directory (default: "./tokens") */
19
+ tokensDir: string;
20
+ /** Path to documentation markdown directory (default: "./docs") */
21
+ docsDir: string;
22
+ /** Path to assets directory (default: "./assets") */
23
+ assetsDir: string;
24
+ /** Output directory for site build (default: "./dist/site") */
25
+ outDir: string;
26
+ /** Output directory for token artifacts (default: "./dist/tokens") */
27
+ tokensOutDir: string;
28
+ /** CSS variable prefix (default: "--" or "--blazon-") */
29
+ cssPrefix: string;
30
+ /** CSS selector to attach variables to (default: ":root") */
31
+ cssSelector: string;
32
+ /** Dev server port (default: 3000) */
33
+ port: number;
34
+ /** Logo files (SVG or raster), relative to the project root: one path, or a variant per background */
35
+ logo?: string | {
36
+ onLight: string;
37
+ onDark?: string;
38
+ };
39
+ /** Brand book theme: viewer role → token path, e.g. { accent: 'interactive.primary' } */
40
+ theme?: Partial<Record<ThemeRole, string>>;
41
+ /** shadcn/ui variable (`primary`, `chart-1`, ...) → token path. Wins over what the theme roles give that variable; `brand.json` states the result */
42
+ shadcn?: Partial<Record<ShadcnVariable, string>>;
43
+ /** Icon packages to preview in the brand book, read from node_modules */
44
+ iconSets?: IconSetConfig[];
45
+ /** Settings for asset categories: label, order, description, an extra folder, rules */
46
+ assets?: Record<string, AssetCategoryConfig>;
47
+ /** The sections this brand expects a page for, standard or custom; `blazon check` notes each one no page holds. Default: all of them */
48
+ sections?: SectionId[];
49
+ /** Sections of the brand's own, next to the standard ones (RFC 0002 §1) */
50
+ customSections?: {
51
+ id: string;
52
+ title: string;
53
+ }[];
54
+ /** Names the brand adds to the standard lockups and usage roles (RFC 0002 §1) */
55
+ vocabulary?: {
56
+ lockups?: string[];
57
+ usageRoles?: string[];
58
+ };
59
+ /** The plugins that may run, by name: the operator's allowlist (RFC 0002 §2). The config holds no path and no command; a pin is recorded in `blazon.plugins.lock` */
60
+ plugins?: PluginConfig[];
61
+ /** Fonts the brand book loads: a stylesheet URL (e.g. Google Fonts), or a font file of the project that blazon embeds itself */
62
+ fonts?: FontEntry[];
63
+ /** DTCG resolver document (RFC 0001 §3), relative to the project root. Default: blazon.resolver.json when present */
64
+ resolver?: string;
65
+ /** CSS selector per resolver modifier, with {context} as the placeholder. Default: ":lang({context})" for locale, '[data-<modifier>="{context}"]' otherwise */
66
+ contextSelectors?: Record<string, string>;
67
+ /** The email signature the `<!-- blazon:email-signature -->` directive generates: the hosted logo, the accepted domains and the fixed lines */
68
+ emailSignature?: EmailSignatureConfig;
69
+ }
70
+ /** What every signature the brand book generates shares; the person fills in the rest. */
71
+ export interface EmailSignatureConfig {
72
+ /** The logo as mail apps load it: an absolute https URL of a PNG, GIF or JPG. Gmail and Outlook show no SVG and no data URI */
73
+ logoUrl: string;
74
+ /** The size the logo is shown at, in CSS pixels; the file should be twice that for sharp screens */
75
+ logoSize: {
76
+ width: number;
77
+ height: number;
78
+ };
79
+ /** The logo's alternative text, shown when a mail app blocks images */
80
+ logoAlt: string;
81
+ /** The domains an address may have, such as `example.com`. Absent: any */
82
+ domains?: string[];
83
+ /** Fixed lines under the contact details, in order: a company line, a legal notice */
84
+ lines?: string[];
85
+ }
86
+ /** A font file in the project (woff2, woff, ttf or otf), embedded in the brand book as an `@font-face` of this family */
87
+ export interface LocalFont {
88
+ family: string;
89
+ /** Path to the file, relative to the project root */
90
+ file: string;
91
+ /** CSS `font-weight` of this file: 400, or "200 1000" for a variable font */
92
+ weight?: number | string;
93
+ style?: 'normal' | 'italic';
94
+ }
95
+ export type FontEntry = string | LocalFont;
96
+ export type UserBlazonConfig = Partial<BlazonConfig>;
97
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}