@jam-overture/loom 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 (401) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +743 -0
  3. package/dist/catalogue.d.ts +70 -0
  4. package/dist/catalogue.js +88 -0
  5. package/dist/cli/args.d.ts +17 -0
  6. package/dist/cli/args.js +83 -0
  7. package/dist/cli/filesystem.d.ts +15 -0
  8. package/dist/cli/filesystem.js +31 -0
  9. package/dist/cli/index.d.ts +12 -0
  10. package/dist/cli/index.js +12 -0
  11. package/dist/cli/main.d.ts +3 -0
  12. package/dist/cli/main.js +30 -0
  13. package/dist/cli/namespace.d.ts +40 -0
  14. package/dist/cli/namespace.js +40 -0
  15. package/dist/cli/plan.d.ts +84 -0
  16. package/dist/cli/plan.js +113 -0
  17. package/dist/cli/run.d.ts +17 -0
  18. package/dist/cli/run.js +75 -0
  19. package/dist/cli/templates.d.ts +43 -0
  20. package/dist/cli/templates.js +134 -0
  21. package/dist/closed-set.d.ts +34 -0
  22. package/dist/closed-set.js +34 -0
  23. package/dist/data/adapter.d.ts +123 -0
  24. package/dist/data/adapter.js +91 -0
  25. package/dist/data/binding.d.ts +48 -0
  26. package/dist/data/binding.js +39 -0
  27. package/dist/data/catalogue.d.ts +26 -0
  28. package/dist/data/catalogue.js +6 -0
  29. package/dist/data/index.d.ts +14 -0
  30. package/dist/data/index.js +14 -0
  31. package/dist/data/plan.d.ts +58 -0
  32. package/dist/data/plan.js +0 -0
  33. package/dist/data/resolution.d.ts +91 -0
  34. package/dist/data/resolution.js +96 -0
  35. package/dist/data/resolve.d.ts +46 -0
  36. package/dist/data/resolve.js +37 -0
  37. package/dist/data/source.d.ts +40 -0
  38. package/dist/data/source.js +45 -0
  39. package/dist/deadline.d.ts +57 -0
  40. package/dist/deadline.js +78 -0
  41. package/dist/frame/catalogue.d.ts +24 -0
  42. package/dist/frame/catalogue.js +5 -0
  43. package/dist/frame/index.d.ts +12 -0
  44. package/dist/frame/index.js +12 -0
  45. package/dist/frame/origin.d.ts +87 -0
  46. package/dist/frame/origin.js +114 -0
  47. package/dist/frame/resolution.d.ts +85 -0
  48. package/dist/frame/resolution.js +79 -0
  49. package/dist/grammar.d.ts +26 -0
  50. package/dist/grammar.js +28 -0
  51. package/dist/ids.d.ts +57 -0
  52. package/dist/ids.js +104 -0
  53. package/dist/index.d.ts +26 -0
  54. package/dist/index.js +26 -0
  55. package/dist/interactivity.d.ts +50 -0
  56. package/dist/interactivity.js +22 -0
  57. package/dist/interpretation/anthropic.d.ts +22 -0
  58. package/dist/interpretation/anthropic.js +76 -0
  59. package/dist/interpretation/client.d.ts +83 -0
  60. package/dist/interpretation/client.js +2 -0
  61. package/dist/interpretation/draft.d.ts +234 -0
  62. package/dist/interpretation/draft.js +84 -0
  63. package/dist/interpretation/index.d.ts +15 -0
  64. package/dist/interpretation/index.js +15 -0
  65. package/dist/interpretation/interpreter.d.ts +62 -0
  66. package/dist/interpretation/interpreter.js +151 -0
  67. package/dist/interpretation/materialize.d.ts +42 -0
  68. package/dist/interpretation/materialize.js +107 -0
  69. package/dist/interpretation/prompt.d.ts +229 -0
  70. package/dist/interpretation/prompt.js +285 -0
  71. package/dist/interpretation/render.d.ts +76 -0
  72. package/dist/interpretation/render.js +272 -0
  73. package/dist/interpretation/schema.d.ts +49 -0
  74. package/dist/interpretation/schema.js +131 -0
  75. package/dist/json.d.ts +35 -0
  76. package/dist/json.js +11 -0
  77. package/dist/paging.d.ts +60 -0
  78. package/dist/paging.js +49 -0
  79. package/dist/primitive-type.d.ts +32 -0
  80. package/dist/primitive-type.js +39 -0
  81. package/dist/render/addressing.d.ts +59 -0
  82. package/dist/render/addressing.js +60 -0
  83. package/dist/render/anchor.d.ts +105 -0
  84. package/dist/render/anchor.js +84 -0
  85. package/dist/render/behaviour-adjust.d.ts +62 -0
  86. package/dist/render/behaviour-adjust.js +78 -0
  87. package/dist/render/behaviour-copy.d.ts +53 -0
  88. package/dist/render/behaviour-copy.js +75 -0
  89. package/dist/render/behaviour-disclose.d.ts +74 -0
  90. package/dist/render/behaviour-disclose.js +77 -0
  91. package/dist/render/behaviour-present.d.ts +123 -0
  92. package/dist/render/behaviour-present.js +173 -0
  93. package/dist/render/behaviour.d.ts +243 -0
  94. package/dist/render/behaviour.js +284 -0
  95. package/dist/render/control.d.ts +81 -0
  96. package/dist/render/control.js +80 -0
  97. package/dist/render/decorative.d.ts +62 -0
  98. package/dist/render/decorative.js +2 -0
  99. package/dist/render/diagnostics.d.ts +260 -0
  100. package/dist/render/diagnostics.js +61 -0
  101. package/dist/render/disclosed.d.ts +37 -0
  102. package/dist/render/disclosed.js +37 -0
  103. package/dist/render/editable.d.ts +34 -0
  104. package/dist/render/editable.js +35 -0
  105. package/dist/render/frame.d.ts +42 -0
  106. package/dist/render/frame.js +31 -0
  107. package/dist/render/index.d.ts +35 -0
  108. package/dist/render/index.js +35 -0
  109. package/dist/render/inline-variables.d.ts +77 -0
  110. package/dist/render/inline-variables.js +220 -0
  111. package/dist/render/presented.d.ts +82 -0
  112. package/dist/render/presented.js +82 -0
  113. package/dist/render/primitive.d.ts +228 -0
  114. package/dist/render/primitive.js +36 -0
  115. package/dist/render/props.d.ts +48 -0
  116. package/dist/render/props.js +2 -0
  117. package/dist/render/reads.d.ts +73 -0
  118. package/dist/render/reads.js +45 -0
  119. package/dist/render/render.d.ts +164 -0
  120. package/dist/render/render.js +571 -0
  121. package/dist/render/request.d.ts +111 -0
  122. package/dist/render/request.js +60 -0
  123. package/dist/render/text.d.ts +91 -0
  124. package/dist/render/text.js +44 -0
  125. package/dist/render/theme.d.ts +61 -0
  126. package/dist/render/theme.js +52 -0
  127. package/dist/reserved-props.d.ts +35 -0
  128. package/dist/reserved-props.js +45 -0
  129. package/dist/result.d.ts +27 -0
  130. package/dist/result.js +30 -0
  131. package/dist/role.d.ts +71 -0
  132. package/dist/role.js +22 -0
  133. package/dist/runtime/analysis.d.ts +149 -0
  134. package/dist/runtime/analysis.js +187 -0
  135. package/dist/runtime/assessment.d.ts +35 -0
  136. package/dist/runtime/assessment.js +13 -0
  137. package/dist/runtime/disposition.d.ts +102 -0
  138. package/dist/runtime/disposition.js +59 -0
  139. package/dist/runtime/events.d.ts +187 -0
  140. package/dist/runtime/events.js +7 -0
  141. package/dist/runtime/gate.d.ts +43 -0
  142. package/dist/runtime/gate.js +169 -0
  143. package/dist/runtime/index.d.ts +27 -0
  144. package/dist/runtime/index.js +27 -0
  145. package/dist/runtime/intent.d.ts +60 -0
  146. package/dist/runtime/intent.js +36 -0
  147. package/dist/runtime/interpreter.d.ts +117 -0
  148. package/dist/runtime/interpreter.js +46 -0
  149. package/dist/runtime/inverse-interpreter.d.ts +90 -0
  150. package/dist/runtime/inverse-interpreter.js +56 -0
  151. package/dist/runtime/inverse.d.ts +87 -0
  152. package/dist/runtime/inverse.js +48 -0
  153. package/dist/runtime/narration.d.ts +24 -0
  154. package/dist/runtime/narration.js +36 -0
  155. package/dist/runtime/nesting.d.ts +31 -0
  156. package/dist/runtime/nesting.js +46 -0
  157. package/dist/runtime/pipeline.d.ts +124 -0
  158. package/dist/runtime/pipeline.js +178 -0
  159. package/dist/runtime/policy-fingerprint.d.ts +29 -0
  160. package/dist/runtime/policy-fingerprint.js +119 -0
  161. package/dist/runtime/policy-source.d.ts +42 -0
  162. package/dist/runtime/policy-source.js +8 -0
  163. package/dist/runtime/policy.d.ts +156 -0
  164. package/dist/runtime/policy.js +107 -0
  165. package/dist/runtime/proposal.d.ts +423 -0
  166. package/dist/runtime/proposal.js +109 -0
  167. package/dist/runtime/redirection.d.ts +53 -0
  168. package/dist/runtime/redirection.js +38 -0
  169. package/dist/runtime/repointing.d.ts +71 -0
  170. package/dist/runtime/repointing.js +0 -0
  171. package/dist/runtime/reversibility.d.ts +36 -0
  172. package/dist/runtime/reversibility.js +39 -0
  173. package/dist/runtime/stake-level.d.ts +33 -0
  174. package/dist/runtime/stake-level.js +58 -0
  175. package/dist/runtime/stakes.d.ts +47 -0
  176. package/dist/runtime/stakes.js +305 -0
  177. package/dist/runtime/vocabulary.d.ts +122 -0
  178. package/dist/runtime/vocabulary.js +87 -0
  179. package/dist/sdk/audit.d.ts +195 -0
  180. package/dist/sdk/audit.js +128 -0
  181. package/dist/sdk/catalogue.d.ts +37 -0
  182. package/dist/sdk/catalogue.js +16 -0
  183. package/dist/sdk/conformance.d.ts +342 -0
  184. package/dist/sdk/conformance.js +494 -0
  185. package/dist/sdk/copy.d.ts +105 -0
  186. package/dist/sdk/copy.js +90 -0
  187. package/dist/sdk/definition.d.ts +242 -0
  188. package/dist/sdk/definition.js +64 -0
  189. package/dist/sdk/index.d.ts +19 -0
  190. package/dist/sdk/index.js +19 -0
  191. package/dist/sdk/interactivity.d.ts +29 -0
  192. package/dist/sdk/interactivity.js +34 -0
  193. package/dist/sdk/pairings.d.ts +124 -0
  194. package/dist/sdk/pairings.js +81 -0
  195. package/dist/sdk/registry.d.ts +162 -0
  196. package/dist/sdk/registry.js +329 -0
  197. package/dist/sdk/selection.d.ts +46 -0
  198. package/dist/sdk/selection.js +24 -0
  199. package/dist/sdk/text.d.ts +100 -0
  200. package/dist/sdk/text.js +105 -0
  201. package/dist/sdk/vocabulary.d.ts +39 -0
  202. package/dist/sdk/vocabulary.js +36 -0
  203. package/dist/signals/broadcast.d.ts +134 -0
  204. package/dist/signals/broadcast.js +451 -0
  205. package/dist/signals/collect.d.ts +184 -0
  206. package/dist/signals/collect.js +196 -0
  207. package/dist/signals/deliver.d.ts +64 -0
  208. package/dist/signals/deliver.js +85 -0
  209. package/dist/signals/fold.d.ts +112 -0
  210. package/dist/signals/fold.js +76 -0
  211. package/dist/signals/index.d.ts +31 -0
  212. package/dist/signals/index.js +31 -0
  213. package/dist/signals/ingest.d.ts +51 -0
  214. package/dist/signals/ingest.js +70 -0
  215. package/dist/signals/intake.d.ts +149 -0
  216. package/dist/signals/intake.js +154 -0
  217. package/dist/signals/journal.d.ts +94 -0
  218. package/dist/signals/journal.js +11 -0
  219. package/dist/signals/kinds.d.ts +22 -0
  220. package/dist/signals/kinds.js +22 -0
  221. package/dist/signals/ledger.d.ts +46 -0
  222. package/dist/signals/ledger.js +81 -0
  223. package/dist/signals/memory.d.ts +17 -0
  224. package/dist/signals/memory.js +99 -0
  225. package/dist/signals/migrate.d.ts +27 -0
  226. package/dist/signals/migrate.js +78 -0
  227. package/dist/signals/postgres.d.ts +7 -0
  228. package/dist/signals/postgres.js +295 -0
  229. package/dist/signals/rollup.d.ts +142 -0
  230. package/dist/signals/rollup.js +0 -0
  231. package/dist/signals/schema.d.ts +534 -0
  232. package/dist/signals/schema.js +92 -0
  233. package/dist/signals/signal.d.ts +381 -0
  234. package/dist/signals/signal.js +150 -0
  235. package/dist/signals/tally.d.ts +70 -0
  236. package/dist/signals/tally.js +2 -0
  237. package/dist/signals/view.d.ts +51 -0
  238. package/dist/signals/view.js +54 -0
  239. package/dist/store/attribution.d.ts +125 -0
  240. package/dist/store/attribution.js +116 -0
  241. package/dist/store/database.d.ts +14 -0
  242. package/dist/store/database.js +2 -0
  243. package/dist/store/driver.d.ts +29 -0
  244. package/dist/store/driver.js +39 -0
  245. package/dist/store/errors.d.ts +56 -0
  246. package/dist/store/errors.js +37 -0
  247. package/dist/store/index.d.ts +16 -0
  248. package/dist/store/index.js +16 -0
  249. package/dist/store/memory.d.ts +3 -0
  250. package/dist/store/memory.js +115 -0
  251. package/dist/store/migrate.d.ts +54 -0
  252. package/dist/store/migrate.js +122 -0
  253. package/dist/store/postgres-holds.d.ts +4 -0
  254. package/dist/store/postgres-holds.js +192 -0
  255. package/dist/store/postgres.d.ts +8 -0
  256. package/dist/store/postgres.js +262 -0
  257. package/dist/store/replay.d.ts +94 -0
  258. package/dist/store/replay.js +82 -0
  259. package/dist/store/revert.d.ts +116 -0
  260. package/dist/store/revert.js +243 -0
  261. package/dist/store/schema.d.ts +371 -0
  262. package/dist/store/schema.js +78 -0
  263. package/dist/store/source.d.ts +23 -0
  264. package/dist/store/source.js +37 -0
  265. package/dist/store/store.d.ts +231 -0
  266. package/dist/store/store.js +52 -0
  267. package/dist/store/undone.d.ts +18 -0
  268. package/dist/store/undone.js +89 -0
  269. package/dist/submit/catalogue.d.ts +20 -0
  270. package/dist/submit/catalogue.js +5 -0
  271. package/dist/submit/declaration.d.ts +39 -0
  272. package/dist/submit/declaration.js +30 -0
  273. package/dist/submit/endpoint.d.ts +131 -0
  274. package/dist/submit/endpoint.js +160 -0
  275. package/dist/submit/index.d.ts +13 -0
  276. package/dist/submit/index.js +13 -0
  277. package/dist/submit/plan.d.ts +49 -0
  278. package/dist/submit/plan.js +47 -0
  279. package/dist/submit/resolution.d.ts +61 -0
  280. package/dist/submit/resolution.js +64 -0
  281. package/dist/submit/resolve.d.ts +45 -0
  282. package/dist/submit/resolve.js +36 -0
  283. package/dist/telemetry/calibration.d.ts +132 -0
  284. package/dist/telemetry/calibration.js +151 -0
  285. package/dist/telemetry/episode.d.ts +140 -0
  286. package/dist/telemetry/episode.js +272 -0
  287. package/dist/telemetry/event.d.ts +2310 -0
  288. package/dist/telemetry/event.js +405 -0
  289. package/dist/telemetry/index.d.ts +15 -0
  290. package/dist/telemetry/index.js +15 -0
  291. package/dist/telemetry/journal.d.ts +116 -0
  292. package/dist/telemetry/journal.js +11 -0
  293. package/dist/telemetry/memory.d.ts +24 -0
  294. package/dist/telemetry/memory.js +75 -0
  295. package/dist/telemetry/migrate.d.ts +26 -0
  296. package/dist/telemetry/migrate.js +40 -0
  297. package/dist/telemetry/postgres.d.ts +6 -0
  298. package/dist/telemetry/postgres.js +139 -0
  299. package/dist/telemetry/retention.d.ts +131 -0
  300. package/dist/telemetry/retention.js +217 -0
  301. package/dist/telemetry/schema.d.ts +113 -0
  302. package/dist/telemetry/schema.js +33 -0
  303. package/dist/telemetry/sink.d.ts +42 -0
  304. package/dist/telemetry/sink.js +61 -0
  305. package/dist/testing/contracts.d.ts +34 -0
  306. package/dist/testing/contracts.js +34 -0
  307. package/dist/testing/definitions.d.ts +15 -0
  308. package/dist/testing/definitions.js +48 -0
  309. package/dist/testing/doubles.d.ts +94 -0
  310. package/dist/testing/doubles.js +141 -0
  311. package/dist/testing/episode-harness.d.ts +49 -0
  312. package/dist/testing/episode-harness.js +65 -0
  313. package/dist/testing/filesystem.d.ts +17 -0
  314. package/dist/testing/filesystem.js +17 -0
  315. package/dist/testing/fixtures.d.ts +57 -0
  316. package/dist/testing/fixtures.js +84 -0
  317. package/dist/testing/hold-contract.d.ts +19 -0
  318. package/dist/testing/hold-contract.js +374 -0
  319. package/dist/testing/index.d.ts +41 -0
  320. package/dist/testing/index.js +41 -0
  321. package/dist/testing/journal-contract.d.ts +17 -0
  322. package/dist/testing/journal-contract.js +353 -0
  323. package/dist/testing/model-replies.d.ts +34 -0
  324. package/dist/testing/model-replies.js +101 -0
  325. package/dist/testing/primitives.d.ts +7 -0
  326. package/dist/testing/primitives.js +29 -0
  327. package/dist/testing/reader-signal-contract.d.ts +38 -0
  328. package/dist/testing/reader-signal-contract.js +318 -0
  329. package/dist/testing/row-security.d.ts +17 -0
  330. package/dist/testing/row-security.js +21 -0
  331. package/dist/testing/store-contract.d.ts +25 -0
  332. package/dist/testing/store-contract.js +500 -0
  333. package/dist/theme/apply.d.ts +17 -0
  334. package/dist/theme/apply.js +60 -0
  335. package/dist/theme/contrast.d.ts +197 -0
  336. package/dist/theme/contrast.js +259 -0
  337. package/dist/theme/derive.d.ts +77 -0
  338. package/dist/theme/derive.js +167 -0
  339. package/dist/theme/faces.d.ts +73 -0
  340. package/dist/theme/faces.js +119 -0
  341. package/dist/theme/font-packs.d.ts +25 -0
  342. package/dist/theme/font-packs.js +257 -0
  343. package/dist/theme/index.d.ts +20 -0
  344. package/dist/theme/index.js +20 -0
  345. package/dist/theme/lab.d.ts +30 -0
  346. package/dist/theme/lab.js +46 -0
  347. package/dist/theme/library.d.ts +114 -0
  348. package/dist/theme/library.js +300 -0
  349. package/dist/theme/measure.d.ts +144 -0
  350. package/dist/theme/measure.js +145 -0
  351. package/dist/theme/palettes.d.ts +64 -0
  352. package/dist/theme/palettes.js +497 -0
  353. package/dist/theme/registry.d.ts +59 -0
  354. package/dist/theme/registry.js +60 -0
  355. package/dist/theme/separation.d.ts +177 -0
  356. package/dist/theme/separation.js +203 -0
  357. package/dist/theme/style-presets.d.ts +60 -0
  358. package/dist/theme/style-presets.js +124 -0
  359. package/dist/theme/theme.d.ts +253 -0
  360. package/dist/theme/theme.js +171 -0
  361. package/dist/tree/apply.d.ts +16 -0
  362. package/dist/tree/apply.js +104 -0
  363. package/dist/tree/builders.d.ts +19 -0
  364. package/dist/tree/builders.js +20 -0
  365. package/dist/tree/compare.d.ts +68 -0
  366. package/dist/tree/compare.js +75 -0
  367. package/dist/tree/configuration.d.ts +25 -0
  368. package/dist/tree/configuration.js +108 -0
  369. package/dist/tree/delta.d.ts +288 -0
  370. package/dist/tree/delta.js +88 -0
  371. package/dist/tree/errors.d.ts +69 -0
  372. package/dist/tree/errors.js +34 -0
  373. package/dist/tree/identity.d.ts +117 -0
  374. package/dist/tree/identity.js +145 -0
  375. package/dist/tree/index.d.ts +21 -0
  376. package/dist/tree/index.js +21 -0
  377. package/dist/tree/inverse.d.ts +24 -0
  378. package/dist/tree/inverse.js +112 -0
  379. package/dist/tree/mutation.d.ts +18 -0
  380. package/dist/tree/mutation.js +49 -0
  381. package/dist/tree/naming.d.ts +4 -0
  382. package/dist/tree/naming.js +35 -0
  383. package/dist/tree/navigation.d.ts +38 -0
  384. package/dist/tree/navigation.js +83 -0
  385. package/dist/tree/node.d.ts +103 -0
  386. package/dist/tree/node.js +46 -0
  387. package/dist/tree/outline.d.ts +28 -0
  388. package/dist/tree/outline.js +10 -0
  389. package/dist/tree/tree.d.ts +83 -0
  390. package/dist/tree/tree.js +62 -0
  391. package/dist/write/commit.d.ts +124 -0
  392. package/dist/write/commit.js +234 -0
  393. package/dist/write/held.d.ts +674 -0
  394. package/dist/write/held.js +185 -0
  395. package/dist/write/index.d.ts +11 -0
  396. package/dist/write/index.js +11 -0
  397. package/dist/write/liveness.d.ts +132 -0
  398. package/dist/write/liveness.js +91 -0
  399. package/dist/write/revert.d.ts +79 -0
  400. package/dist/write/revert.js +134 -0
  401. package/package.json +160 -0
@@ -0,0 +1,145 @@
1
+ import { relativeLuminance, contrastRatio } from "./contrast.js";
2
+ import { labOf } from "./lab.js";
3
+ /**
4
+ * What a palette *is*, as numbers a stylesheet can use.
5
+ *
6
+ * A palette hands a primitive seventeen strings. `var(--loom-accent-strong)` is
7
+ * a colour to a reader and an opaque token to everything else: CSS cannot ask
8
+ * how much colour is in it, and a primitive that spreads it over half a band has
9
+ * no way to find out before it does.
10
+ *
11
+ * Two things the library builds needed exactly that and could not have it, both
12
+ * filed on 11 September by the lane that builds the primitives:
13
+ *
14
+ * - **A paint assumes there is chroma to spend.** The same aurora that is
15
+ * luminous behind `bold`'s gold and red is a grey blob behind `editorial`'s
16
+ * two slates, because a low-chroma tint spread over a light canvas is
17
+ * indistinguishable from dirt. One opacity was serving both, and no primitive
18
+ * could know which palette it was in.
19
+ * - **A dark wash is not expressible.** `bg-overlay` is a *surface* — white
20
+ * under most of the starter palettes — so reading it as a scrim gives white
21
+ * text on a white veil. A hard-coded black would render one page correctly and
22
+ * break re-theming for every other palette (0049).
23
+ *
24
+ * Both are answered here, and answered the same way: **measured from the
25
+ * palette, never declared on it.** A declared field would have to be added to
26
+ * `paletteSchema`, which every palette must satisfy in full — so every host
27
+ * palette in existence would stop validating, and a host that did fill it in
28
+ * could fill it in wrongly. Nothing checks a claim about how much colour a
29
+ * colour has. Measuring it cannot be wrong and costs a host nothing (0131).
30
+ *
31
+ * It reports; it does not decide — the bargain `auditPalette` and
32
+ * `auditSeparation` both make, for the same reason (0076). How strong a wash to
33
+ * draw with these numbers is the primitive's call, and which pair to hand a
34
+ * reader is the palette's.
35
+ */
36
+ /**
37
+ * The greatest chroma sRGB can reach: pure blue, `#0000ff`, at C* 133.82.
38
+ *
39
+ * Chroma is reported as a fraction of it, so `1` means *as saturated as a screen
40
+ * goes* and the scale does not depend on which palettes happen to be registered.
41
+ * A normalisation against the library's own maximum would be a number that moved
42
+ * whenever somebody added a palette.
43
+ */
44
+ export const MAX_SRGB_CHROMA = 133.82;
45
+ /**
46
+ * The slots a palette puts its colour in, and the only ones whose chroma tells
47
+ * anybody anything.
48
+ *
49
+ * The neutral tiers are near-grey **on purpose** — `derivePalette` builds every
50
+ * background, ink and rule from the canvas hue at a saturation it caps in the
51
+ * teens, so measuring them would report the tint of the paper rather than what a
52
+ * paint has to work with. The accent tier and the brand tier are where a palette
53
+ * spends its chroma, and they are what a band spreads behind content.
54
+ *
55
+ * Declared rather than derived, for the reason `PALETTE_TEXT_GROUNDS` is: which
56
+ * slots mean *colour* rather than *paper* is what the vocabulary means, not
57
+ * something a probe can read off a component.
58
+ */
59
+ export const PALETTE_CHROMA_SLOTS = [
60
+ "accent",
61
+ "accent-strong",
62
+ "accent-subtle",
63
+ "brand-secondary",
64
+ "brand-secondary-strong",
65
+ ];
66
+ /**
67
+ * Relative luminance at or under which a wash genuinely darkens what is beneath
68
+ * it.
69
+ *
70
+ * Derived rather than chosen. A wash drawn at full strength brings what is under
71
+ * it to its own luminance `L`; for the ink it carries to clear the body-text bar
72
+ * against that, the ink needs a luminance of at least `4.5 × (L + 0.05) − 0.05`,
73
+ * which at `L = 0.15` is 0.85 — a near-white and nothing else. Above this a
74
+ * "dark" scrim is dark in name only, so the pair is reported as one that does not
75
+ * darken rather than silently offered as one that does.
76
+ *
77
+ * Every starter palette's scrim sits under 0.015, two orders of magnitude
78
+ * inside it; the ceiling exists for host palettes, where it is a real question.
79
+ */
80
+ export const SCRIM_DARK_CEILING = 0.15;
81
+ /**
82
+ * How much colour is in one slot, as a fraction of the most sRGB can hold, or
83
+ * `undefined` when the colour is a form `channelsOf` declines to guess at.
84
+ *
85
+ * CIELAB chroma rather than HSL saturation: a palette is judged by eye, and
86
+ * `hsl()`'s saturation says a pale mint and a deep forest hold the same amount
87
+ * of colour when a reader can see that one of them is grey. This is the space
88
+ * `separation.ts` already measures difference in, for the same reason.
89
+ */
90
+ export const slotChroma = (colour) => {
91
+ const lab = labOf(colour);
92
+ if (lab === undefined)
93
+ return undefined;
94
+ const [, green, blue] = lab;
95
+ return Math.min(1, Math.hypot(green, blue) / MAX_SRGB_CHROMA);
96
+ };
97
+ /**
98
+ * The palette's scrim pair, or `undefined` when either end is a colour this
99
+ * cannot measure — `undefined` rather than a guess, so a host whose palette is
100
+ * written in `hsl()` is told the wash is unavailable instead of being handed a
101
+ * pair that might be the wrong way round.
102
+ */
103
+ export const paletteScrim = (palette) => {
104
+ const ink = palette.slots["fg-default"] ?? "";
105
+ const page = palette.slots["bg-canvas"] ?? "";
106
+ const inkLuminance = relativeLuminance(ink);
107
+ const pageLuminance = relativeLuminance(page);
108
+ const ratio = contrastRatio(ink, page);
109
+ if (inkLuminance === undefined || pageLuminance === undefined || ratio === undefined) {
110
+ return undefined;
111
+ }
112
+ const inkIsDarker = inkLuminance < pageLuminance;
113
+ const luminance = inkIsDarker ? inkLuminance : pageLuminance;
114
+ return {
115
+ ground: inkIsDarker ? "fg-default" : "bg-canvas",
116
+ foreground: inkIsDarker ? "bg-canvas" : "fg-default",
117
+ luminance,
118
+ ratio,
119
+ darkens: luminance <= SCRIM_DARK_CEILING,
120
+ };
121
+ };
122
+ /** Measures one palette. Refuses nothing, and reports what it could not measure by leaving it out. */
123
+ export const paletteMeasures = (palette) => {
124
+ const chroma = {};
125
+ for (const slot of PALETTE_CHROMA_SLOTS) {
126
+ const measured = slotChroma(palette.slots[slot] ?? "");
127
+ if (measured !== undefined)
128
+ chroma[slot] = measured;
129
+ }
130
+ return { palette: palette.id, chroma, scrim: paletteScrim(palette) };
131
+ };
132
+ /**
133
+ * The decimal places a chroma is emitted to.
134
+ *
135
+ * Fixed rather than trimmed, and the reason is not tidiness: a variable whose
136
+ * text length varied with the palette would make the page describing a tree a
137
+ * few bytes longer in one palette than in another, and *the same tree in every
138
+ * palette, byte for byte* is a promise the theme model makes and a marketing
139
+ * page now measures and prints (0049). Three places resolve a step of 0.4 in
140
+ * C*, finer than the 1/255 a hex can express.
141
+ */
142
+ export const CHROMA_PLACES = 3;
143
+ /** A chroma as a stylesheet reads it: unitless, so `calc()` can multiply by it. */
144
+ export const chromaValue = (chroma) => chroma.toFixed(CHROMA_PLACES);
145
+ //# sourceMappingURL=measure.js.map
@@ -0,0 +1,64 @@
1
+ import { type Palette } from "./theme.js";
2
+ /**
3
+ * The eighteen palettes the starter library ships beyond the first three.
4
+ *
5
+ * They are **derived rather than picked**, and the derivation is the reason to
6
+ * trust them. `derive.ts` authors a palette in HSL from a
7
+ * canvas hue, an accent hue and a secondary hue, then binary-searches the
8
+ * lightness of every slot a primitive reads as text until it clears 4.75:1
9
+ * against the tightest ground it is ever rendered on — a margin over
10
+ * [0074](../../decisions/0074-a-palette-slot-that-carries-text-meets-aa.md)'s
11
+ * 4.5:1, so a later nudge to a background does not silently drop one under the
12
+ * bar. `auditPalette` then checks the result against the twelve pairings the
13
+ * primitives actually put together, and `library.test.ts` checks it again on
14
+ * every run.
15
+ *
16
+ * **The values below are the source of truth, not the tool.** They are literals
17
+ * because a palette is reviewed by looking at it and diffed by reading it, and
18
+ * because a palette generated at import time is a page whose colours depend on
19
+ * a function nobody read. The tool is how a *new* one is derived — a host with
20
+ * a brand colour and no time to solve twelve contrast constraints by hand — and
21
+ * it is documented for that, not run here.
22
+ *
23
+ * Two conventions worth knowing before editing one, both learned the expensive
24
+ * way (see 0072 and the aurora finding of 20 August):
25
+ *
26
+ * - **`accent` is ink.** Eyebrows, kickers, the disclosure marker, the current
27
+ * nav item. It is dark on a light palette and light on a dark one, and it is
28
+ * the slot people are most tempted to fill with their brand colour. If the
29
+ * brand colour cannot carry text, it belongs in `border-accent` or
30
+ * `brand-secondary`, which is exactly what `minimal` does with its mint.
31
+ * - **`accent-strong` and `brand-secondary` are areas.** `loom.hero`'s aurora
32
+ * is the one place in the library that paints a slot as a large field, and it
33
+ * reads those two. Every palette here gives both real chroma for that reason.
34
+ *
35
+ * Ten are light and eight are dark. A dark palette is not a mode — nothing
36
+ * switches on `prefers-color-scheme` — it is a palette whose canvas is dark,
37
+ * chosen by id like any other (0049).
38
+ */
39
+ export declare const paperPalette: Palette;
40
+ export declare const slatePalette: Palette;
41
+ export declare const sagePalette: Palette;
42
+ export declare const blushPalette: Palette;
43
+ export declare const harbourPalette: Palette;
44
+ export declare const citrusPalette: Palette;
45
+ export declare const lilacPalette: Palette;
46
+ export declare const graphitePalette: Palette;
47
+ export declare const clayPalette: Palette;
48
+ export declare const linenPalette: Palette;
49
+ export declare const midnightPalette: Palette;
50
+ export declare const carbonPalette: Palette;
51
+ export declare const plumPalette: Palette;
52
+ export declare const forestPalette: Palette;
53
+ export declare const emberPalette: Palette;
54
+ export declare const duskPalette: Palette;
55
+ export declare const obsidianPalette: Palette;
56
+ export declare const tidePalette: Palette;
57
+ /**
58
+ * In the order a catalogue reads best: the light palettes, then the dark ones,
59
+ * each run from the most neutral to the most committed. A model reading down
60
+ * this list meets `paper` and `slate` before `plum`, which is the order a
61
+ * person would offer them in.
62
+ */
63
+ export declare const DERIVED_PALETTES: readonly Palette[];
64
+ //# sourceMappingURL=palettes.d.ts.map