@gjermundgaraba-designs/plain-garden 0.7.0 → 0.9.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 (221) hide show
  1. package/DESIGN.md +8 -4
  2. package/dist/src/box/box.d.ts +1 -1
  3. package/dist/src/box/box.d.ts.map +1 -1
  4. package/dist/src/box/index.d.ts.map +1 -1
  5. package/dist/src/changes/changes.d.ts +1 -1
  6. package/dist/src/changes/changes.d.ts.map +1 -1
  7. package/dist/src/changes/index.d.ts.map +1 -1
  8. package/dist/src/{codeFigure/codeFigure.d.ts → code-figure/code-figure.d.ts} +3 -3
  9. package/dist/src/code-figure/code-figure.d.ts.map +1 -0
  10. package/dist/src/{codeFigure/codeFigure.js → code-figure/code-figure.js} +10 -5
  11. package/dist/src/code-figure/index.d.ts +3 -0
  12. package/dist/src/code-figure/index.d.ts.map +1 -0
  13. package/dist/src/code-figure/index.js +1 -0
  14. package/dist/src/copy/copy.d.ts.map +1 -1
  15. package/dist/src/copy/copy.js +1 -7
  16. package/dist/src/{copyButton/copyButton.d.ts → copy-button/copy-button.d.ts} +8 -2
  17. package/dist/src/copy-button/copy-button.d.ts.map +1 -0
  18. package/dist/src/copy-button/copy-button.js +37 -0
  19. package/dist/src/copy-button/index.d.ts +3 -0
  20. package/dist/src/copy-button/index.d.ts.map +1 -0
  21. package/dist/src/{copyButton → copy-button}/index.js +1 -1
  22. package/dist/src/diagram/diagram.d.ts +1 -1
  23. package/dist/src/diagram/diagram.d.ts.map +1 -1
  24. package/dist/src/diagram/diagram.js +10 -1
  25. package/dist/src/diagram/index.d.ts.map +1 -1
  26. package/dist/src/drawing/drawing.d.ts +3 -3
  27. package/dist/src/drawing/drawing.d.ts.map +1 -1
  28. package/dist/src/drawing/drawing.js +6 -5
  29. package/dist/src/drawing/fnv1a-utf16.d.ts +2 -0
  30. package/dist/src/drawing/fnv1a-utf16.d.ts.map +1 -0
  31. package/dist/src/drawing/fnv1a-utf16.js +8 -0
  32. package/dist/src/drawing/index.d.ts +1 -1
  33. package/dist/src/drawing/index.d.ts.map +1 -1
  34. package/dist/src/drawing/render.d.ts +4 -9
  35. package/dist/src/drawing/render.d.ts.map +1 -1
  36. package/dist/src/drawing/render.js +221 -200
  37. package/dist/src/drawing/scene.d.ts +11 -7
  38. package/dist/src/drawing/scene.d.ts.map +1 -1
  39. package/dist/src/drawing/scene.js +8 -5
  40. package/dist/src/{drawnTitle/drawnTitle.d.ts → drawn-title/drawn-title.d.ts} +3 -2
  41. package/dist/src/drawn-title/drawn-title.d.ts.map +1 -0
  42. package/dist/src/{drawnTitle/drawnTitle.js → drawn-title/drawn-title.js} +3 -3
  43. package/dist/src/drawn-title/index.d.ts +3 -0
  44. package/dist/src/drawn-title/index.d.ts.map +1 -0
  45. package/dist/src/drawn-title/index.js +1 -0
  46. package/dist/src/{figRef/figRef.d.ts → fig-ref/fig-ref.d.ts} +1 -1
  47. package/dist/src/fig-ref/fig-ref.d.ts.map +1 -0
  48. package/dist/src/{figRef/figRef.js → fig-ref/fig-ref.js} +1 -1
  49. package/dist/src/fig-ref/index.d.ts +3 -0
  50. package/dist/src/fig-ref/index.d.ts.map +1 -0
  51. package/dist/src/fig-ref/index.js +1 -0
  52. package/dist/src/figure/figure.d.ts +3 -3
  53. package/dist/src/figure/figure.d.ts.map +1 -1
  54. package/dist/src/figure/figure.js +4 -2
  55. package/dist/src/figure/figures.d.ts +0 -1
  56. package/dist/src/figure/figures.d.ts.map +1 -1
  57. package/dist/src/figure/figures.js +2 -2
  58. package/dist/src/figure/index.d.ts.map +1 -1
  59. package/dist/src/illustration/illustration.d.ts +1 -0
  60. package/dist/src/illustration/illustration.d.ts.map +1 -1
  61. package/dist/src/illustration/illustration.js +2 -2
  62. package/dist/src/illustration/index.d.ts.map +1 -1
  63. package/dist/src/index.d.ts +9 -9
  64. package/dist/src/index.d.ts.map +1 -1
  65. package/dist/src/index.js +9 -9
  66. package/dist/src/links-here/index.d.ts +3 -0
  67. package/dist/src/links-here/index.d.ts.map +1 -0
  68. package/dist/src/links-here/index.js +1 -0
  69. package/dist/src/{linksHere/linksHere.d.ts → links-here/links-here.d.ts} +2 -2
  70. package/dist/src/links-here/links-here.d.ts.map +1 -0
  71. package/dist/src/{linksHere/linksHere.js → links-here/links-here.js} +2 -2
  72. package/dist/src/margin-note/index.d.ts +3 -0
  73. package/dist/src/margin-note/index.d.ts.map +1 -0
  74. package/dist/src/margin-note/index.js +1 -0
  75. package/dist/src/{marginNote/marginNote.d.ts → margin-note/margin-note.d.ts} +2 -1
  76. package/dist/src/margin-note/margin-note.d.ts.map +1 -0
  77. package/dist/src/{marginNote/marginNote.js → margin-note/margin-note.js} +4 -1
  78. package/dist/src/masthead/index.d.ts.map +1 -1
  79. package/dist/src/masthead/masthead.d.ts +1 -1
  80. package/dist/src/masthead/masthead.d.ts.map +1 -1
  81. package/dist/src/masthead/masthead.js +1 -3
  82. package/dist/src/note-header/index.d.ts +3 -0
  83. package/dist/src/note-header/index.d.ts.map +1 -0
  84. package/dist/src/note-header/index.js +1 -0
  85. package/dist/src/{noteHeader/noteHeader.d.ts → note-header/note-header.d.ts} +2 -1
  86. package/dist/src/note-header/note-header.d.ts.map +1 -0
  87. package/dist/src/{noteHeader/noteHeader.js → note-header/note-header.js} +12 -4
  88. package/dist/src/note-list/index.d.ts +3 -0
  89. package/dist/src/note-list/index.d.ts.map +1 -0
  90. package/dist/src/note-list/index.js +1 -0
  91. package/dist/src/{noteList/noteList.d.ts → note-list/note-list.d.ts} +2 -2
  92. package/dist/src/note-list/note-list.d.ts.map +1 -0
  93. package/dist/src/{noteList/noteList.js → note-list/note-list.js} +8 -3
  94. package/dist/src/ring/index.d.ts.map +1 -1
  95. package/dist/src/ring/ring.d.ts +1 -1
  96. package/dist/src/ring/ring.d.ts.map +1 -1
  97. package/dist/src/scheme/index.d.ts +1 -1
  98. package/dist/src/scheme/index.d.ts.map +1 -1
  99. package/dist/src/scheme/index.js +1 -1
  100. package/dist/src/scheme/{schemeSwitch.d.ts → scheme-switch.d.ts} +3 -2
  101. package/dist/src/scheme/scheme-switch.d.ts.map +1 -0
  102. package/dist/src/scheme/{schemeSwitch.js → scheme-switch.js} +7 -6
  103. package/dist/src/scheme/scheme.d.ts +0 -2
  104. package/dist/src/scheme/scheme.d.ts.map +1 -1
  105. package/dist/src/scheme/scheme.js +0 -2
  106. package/dist/src/scheme/switch.d.ts.map +1 -1
  107. package/dist/src/scheme/switch.js +12 -17
  108. package/dist/src/skip-link/index.d.ts +2 -0
  109. package/dist/src/skip-link/index.d.ts.map +1 -0
  110. package/dist/src/skip-link/index.js +1 -0
  111. package/dist/src/{skipLink/skipLink.d.ts → skip-link/skip-link.d.ts} +1 -1
  112. package/dist/src/skip-link/skip-link.d.ts.map +1 -0
  113. package/dist/src/{skipLink/skipLink.js → skip-link/skip-link.js} +1 -1
  114. package/dist/src/stage/index.d.ts.map +1 -1
  115. package/dist/src/stage/stage.d.ts +0 -2
  116. package/dist/src/stage/stage.d.ts.map +1 -1
  117. package/dist/src/stage/stage.js +0 -2
  118. package/dist/src/summary/index.d.ts.map +1 -1
  119. package/dist/src/summary/summary.d.ts +1 -1
  120. package/dist/src/summary/summary.d.ts.map +1 -1
  121. package/dist/src/time/time.d.ts +0 -3
  122. package/dist/src/time/time.d.ts.map +1 -1
  123. package/dist/src/time/time.js +0 -1
  124. package/package.json +13 -13
  125. package/src/box/box.ts +6 -3
  126. package/src/box/index.ts +1 -0
  127. package/src/changes/changes.ts +10 -4
  128. package/src/changes/index.ts +1 -0
  129. package/src/{codeFigure/codeFigure.ts → code-figure/code-figure.ts} +19 -8
  130. package/src/code-figure/index.ts +3 -0
  131. package/src/copy/copy.ts +8 -17
  132. package/src/copy-button/copy-button.ts +96 -0
  133. package/src/{copyButton → copy-button}/index.ts +4 -2
  134. package/src/diagram/diagram.ts +20 -4
  135. package/src/diagram/index.ts +1 -0
  136. package/src/drawing/drawing.ts +18 -8
  137. package/src/drawing/fnv1a-utf16.ts +9 -0
  138. package/src/drawing/index.ts +11 -1
  139. package/src/drawing/render.ts +460 -270
  140. package/src/drawing/scene.ts +20 -12
  141. package/src/{drawnTitle/drawnTitle.ts → drawn-title/drawn-title.ts} +8 -3
  142. package/src/drawn-title/index.ts +3 -0
  143. package/src/{figRef/figRef.ts → fig-ref/fig-ref.ts} +4 -2
  144. package/src/fig-ref/index.ts +3 -0
  145. package/src/figure/figure.ts +21 -12
  146. package/src/figure/figures.ts +3 -2
  147. package/src/figure/index.ts +2 -0
  148. package/src/illustration/illustration.ts +9 -4
  149. package/src/illustration/index.ts +1 -0
  150. package/src/index.ts +28 -9
  151. package/src/links-here/index.ts +3 -0
  152. package/src/{linksHere/linksHere.ts → links-here/links-here.ts} +12 -5
  153. package/src/margin-note/index.ts +3 -0
  154. package/src/{marginNote/marginNote.ts → margin-note/margin-note.ts} +9 -2
  155. package/src/masthead/index.ts +1 -0
  156. package/src/masthead/masthead.ts +12 -7
  157. package/src/note-header/index.ts +3 -0
  158. package/src/{noteHeader/noteHeader.ts → note-header/note-header.ts} +24 -8
  159. package/src/note-list/index.ts +3 -0
  160. package/src/{noteList/noteList.ts → note-list/note-list.ts} +17 -9
  161. package/src/plain-garden.css +9 -87
  162. package/src/ring/index.ts +1 -0
  163. package/src/ring/ring.ts +9 -5
  164. package/src/scheme/index.ts +3 -1
  165. package/src/scheme/{schemeSwitch.ts → scheme-switch.ts} +22 -11
  166. package/src/scheme/scheme.ts +3 -4
  167. package/src/scheme/switch.ts +9 -20
  168. package/src/skip-link/index.ts +1 -0
  169. package/src/stage/index.ts +1 -0
  170. package/src/stage/stage.ts +9 -6
  171. package/src/summary/index.ts +1 -0
  172. package/src/summary/summary.ts +5 -2
  173. package/src/time/time.ts +8 -5
  174. package/src/tokens.css +14 -61
  175. package/dist/src/codeFigure/codeFigure.d.ts.map +0 -1
  176. package/dist/src/codeFigure/index.d.ts +0 -3
  177. package/dist/src/codeFigure/index.d.ts.map +0 -1
  178. package/dist/src/codeFigure/index.js +0 -1
  179. package/dist/src/copyButton/copyButton.d.ts.map +0 -1
  180. package/dist/src/copyButton/copyButton.js +0 -30
  181. package/dist/src/copyButton/index.d.ts +0 -3
  182. package/dist/src/copyButton/index.d.ts.map +0 -1
  183. package/dist/src/drawnTitle/drawnTitle.d.ts.map +0 -1
  184. package/dist/src/drawnTitle/index.d.ts +0 -3
  185. package/dist/src/drawnTitle/index.d.ts.map +0 -1
  186. package/dist/src/drawnTitle/index.js +0 -1
  187. package/dist/src/figRef/figRef.d.ts.map +0 -1
  188. package/dist/src/figRef/index.d.ts +0 -3
  189. package/dist/src/figRef/index.d.ts.map +0 -1
  190. package/dist/src/figRef/index.js +0 -1
  191. package/dist/src/linksHere/index.d.ts +0 -3
  192. package/dist/src/linksHere/index.d.ts.map +0 -1
  193. package/dist/src/linksHere/index.js +0 -1
  194. package/dist/src/linksHere/linksHere.d.ts.map +0 -1
  195. package/dist/src/marginNote/index.d.ts +0 -3
  196. package/dist/src/marginNote/index.d.ts.map +0 -1
  197. package/dist/src/marginNote/index.js +0 -1
  198. package/dist/src/marginNote/marginNote.d.ts.map +0 -1
  199. package/dist/src/noteHeader/index.d.ts +0 -3
  200. package/dist/src/noteHeader/index.d.ts.map +0 -1
  201. package/dist/src/noteHeader/index.js +0 -1
  202. package/dist/src/noteHeader/noteHeader.d.ts.map +0 -1
  203. package/dist/src/noteList/index.d.ts +0 -3
  204. package/dist/src/noteList/index.d.ts.map +0 -1
  205. package/dist/src/noteList/index.js +0 -1
  206. package/dist/src/noteList/noteList.d.ts.map +0 -1
  207. package/dist/src/scheme/schemeSwitch.d.ts.map +0 -1
  208. package/dist/src/skipLink/index.d.ts +0 -2
  209. package/dist/src/skipLink/index.d.ts.map +0 -1
  210. package/dist/src/skipLink/index.js +0 -1
  211. package/dist/src/skipLink/skipLink.d.ts.map +0 -1
  212. package/src/codeFigure/index.ts +0 -2
  213. package/src/copyButton/copyButton.ts +0 -59
  214. package/src/drawnTitle/index.ts +0 -2
  215. package/src/figRef/index.ts +0 -2
  216. package/src/linksHere/index.ts +0 -2
  217. package/src/marginNote/index.ts +0 -2
  218. package/src/noteHeader/index.ts +0 -2
  219. package/src/noteList/index.ts +0 -2
  220. package/src/skipLink/index.ts +0 -1
  221. /package/src/{skipLink/skipLink.ts → skip-link/skip-link.ts} +0 -0
@@ -1 +1 @@
1
- {"version":3,"file":"ring.d.ts","sourceRoot":"","sources":["../../../src/ring/ring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAEtD,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC,CAAC;AAEH;;uBAEuB;AACvB,eAAO,MAAM,IAAI,GAAI,OAAO,UAAU,UAAU,KAAK,WAAW,CAAC,OAAO,CAAC,KAAG,IAwB3E,CAAC"}
1
+ {"version":3,"file":"ring.d.ts","sourceRoot":"","sources":["../../../src/ring/ring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAExD,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC,CAAC;AAEH;;uBAEuB;AACvB,eAAO,MAAM,IAAI,GAAI,OAAO,UAClB,UAAU,KACf,WAAW,CAAC,OAAO,CAAC,KACtB,IAyBF,CAAC"}
@@ -1,4 +1,4 @@
1
1
  export { Scheme } from "./scheme.ts";
2
2
  export { schemeScript } from "./script.ts";
3
- export * as SchemeSwitch from "./schemeSwitch.ts";
3
+ export * as SchemeSwitch from "./scheme-switch.ts";
4
4
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scheme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scheme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC"}
@@ -1,3 +1,3 @@
1
1
  export { Scheme } from "./scheme.js";
2
2
  export { schemeScript } from "./script.js";
3
- export * as SchemeSwitch from "./schemeSwitch.js";
3
+ export * as SchemeSwitch from "./scheme-switch.js";
@@ -1,4 +1,5 @@
1
- export * from "./switch.ts";
1
+ export { Message, Model, PinScheme, ReadScheme, id, init, update, } from "./switch.ts";
2
+ export type { InitConfig } from "./switch.ts";
2
3
  /** "Colour scheme: Light Dark System", three text buttons after a plain label, each built on
3
4
  `@foldkit/ui`'s Button; the current choice is set in ink. Put `schemeScript` in the page's
4
5
  `<head>` so a remembered choice applies before first paint. */
@@ -14,4 +15,4 @@ export declare const view: import("foldkit/submodel").View<{
14
15
  readonly _tag: "SelectedScheme";
15
16
  readonly scheme: "Dark" | "Light" | "System";
16
17
  }, void>;
17
- //# sourceMappingURL=schemeSwitch.d.ts.map
18
+ //# sourceMappingURL=scheme-switch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scheme-switch.d.ts","sourceRoot":"","sources":["../../../src/scheme/scheme-switch.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,OAAO,EACP,KAAK,EACL,SAAS,EACT,UAAU,EACV,EAAE,EACF,IAAI,EACJ,MAAM,GACP,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C;;kEAEkE;AAClE,eAAO,MAAM,IAAI;;;;;;;;;;;QAuBhB,CAAC"}
@@ -2,9 +2,7 @@ import { brandViewResult as __foldkitBrandViewResult } from 'foldkit/brand'
2
2
  import { Button as UiButton } from "@foldkit/ui";
3
3
  import { defineView } from "foldkit/submodel";
4
4
  import { Message } from "./switch.js";
5
- export * from "./switch.js";
6
- // VIEW
7
- // In the order a reader sees them; each button reads as its scheme's name.
5
+ export { Message, Model, PinScheme, ReadScheme, id, init, update, } from "./switch.js";
8
6
  const CHOICES = ["Light", "Dark", "System"];
9
7
  /** "Colour scheme: Light Dark System", three text buttons after a plain label, each built on
10
8
  `@foldkit/ui`'s Button; the current choice is set in ink. Put `schemeScript` in the page's
@@ -13,6 +11,9 @@ export const view = defineView((model, h) => __foldkitBrandViewResult((h.p([h.Cl
13
11
  h.span([h.Id(`${model.id}-label`)], ["Colour scheme:"]),
14
12
  ...CHOICES.map((choice) => __foldkitBrandViewResult((UiButton.view({
15
13
  onClick: Message.SelectedScheme({ scheme: choice }),
16
- toView: ({ button }) => __foldkitBrandViewResult((h.button([...button, h.AriaPressed(choice === model.scheme ? "true" : "false")], [choice])), "@gjermundgaraba-designs/plain-garden/src/scheme/schemeSwitch.js#toView"),
17
- }, h)), "@gjermundgaraba-designs/plain-garden/src/scheme/schemeSwitch.js#anonymous~2")),
18
- ])), "@gjermundgaraba-designs/plain-garden/src/scheme/schemeSwitch.js#anonymous"));
14
+ toView: ({ button }) => __foldkitBrandViewResult((h.button([
15
+ ...button,
16
+ h.AriaPressed(choice === model.scheme ? "true" : "false"),
17
+ ], [choice])), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme-switch.js#toView"),
18
+ }, h)), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme-switch.js#anonymous~2")),
19
+ ])), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme-switch.js#anonymous"));
@@ -3,8 +3,6 @@ import { Option, Schema } from "effect";
3
3
  follows the reader's system in CSS alone. */
4
4
  export declare const Scheme: Schema.Literals<readonly ["System", "Light", "Dark"]>;
5
5
  export type Scheme = typeof Scheme.Type;
6
- /** The `data-scheme` value a scheme pins, or none for `System`. */
7
6
  export declare const toPinnedValue: (scheme: Scheme) => Option.Option<string>;
8
- /** The scheme a `data-scheme` value pins. Anything else, or nothing, is `System`. */
9
7
  export declare const fromPinnedValue: (value: string | null | undefined) => Scheme;
10
8
  //# sourceMappingURL=scheme.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"scheme.d.ts","sourceRoot":"","sources":["../../../src/scheme/scheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE/C;gDACgD;AAChD,eAAO,MAAM,MAAM,uDAA+C,CAAC;AACnE,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,IAAI,CAAC;AAExC,mEAAmE;AACnE,eAAO,MAAM,aAAa,WAAY,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAOhE,CAAC;AAEJ,qFAAqF;AACrF,eAAO,MAAM,eAAe,UAAW,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAMhE,CAAC"}
1
+ {"version":3,"file":"scheme.d.ts","sourceRoot":"","sources":["../../../src/scheme/scheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE/C;gDACgD;AAChD,eAAO,MAAM,MAAM,uDAA+C,CAAC;AAEnE,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,IAAI,CAAC;AAExC,eAAO,MAAM,aAAa,WAAY,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAOhE,CAAC;AAEJ,eAAO,MAAM,eAAe,UAAW,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAMhE,CAAC"}
@@ -3,7 +3,5 @@ import { Match, Option, Schema } from "effect";
3
3
  /** The colour scheme: `Light` or `Dark` pinned on `<html data-scheme>`, or `System`, which
4
4
  follows the reader's system in CSS alone. */
5
5
  export const Scheme = Schema.Literals(["System", "Light", "Dark"]);
6
- /** The `data-scheme` value a scheme pins, or none for `System`. */
7
6
  export const toPinnedValue = (scheme) => __foldkitBrandViewResult((Match.value(scheme).pipe(Match.withReturnType(), Match.when("System", () => __foldkitBrandViewResult((Option.none()), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme.js#anonymous")), Match.when("Light", () => __foldkitBrandViewResult((Option.some("light")), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme.js#anonymous~2")), Match.when("Dark", () => __foldkitBrandViewResult((Option.some("dark")), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme.js#anonymous~3")), Match.exhaustive)), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme.js#toPinnedValue");
8
- /** The scheme a `data-scheme` value pins. Anything else, or nothing, is `System`. */
9
7
  export const fromPinnedValue = (value) => __foldkitBrandViewResult((Match.value(value).pipe(Match.withReturnType(), Match.when("light", () => __foldkitBrandViewResult(("Light"), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme.js#anonymous~4")), Match.when("dark", () => __foldkitBrandViewResult(("Dark"), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme.js#anonymous~5")), Match.orElse(() => __foldkitBrandViewResult(("System"), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme.js#anonymous~6")))), "@gjermundgaraba-designs/plain-garden/src/scheme/scheme.js#fromPinnedValue");
@@ -1 +1 @@
1
- {"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/scheme/switch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAG3C,OAAO,KAAK,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAU9C;YACY;AACZ,eAAO,MAAM,KAAK;;;EAGhB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAC;AAItC,2DAA2D;AAC3D,eAAO,MAAM,OAAO;;QACA,MAAM;;;;QAED,MAAM;;EAC7B,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAI1C;;;kBAGkB;AAClB,eAAO,MAAM,SAAS;;;;iBAgBpB,CAAC;AAEH;4CAC4C;AAC5C,eAAO,MAAM,UAAU;;;iBAOrB,CAAC;AAIH,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAElD;;4FAE4F;AAC5F,eAAO,MAAM,IAAI,WAAY,UAAU,KAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAGpE,CAAC;AAIH,uBAAuB;AACvB,eAAO,MAAM,EAAE,UAAW,KAAK,KAAG,MAAkB,CAAC;AAIrD,iFAAiF;AACjF,eAAO,MAAM,MAAM,UAAW,KAAK,WAAW,OAAO;;;;;;;;;;;;;;;EAUjD,CAAC"}
1
+ {"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/scheme/switch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAG3C,OAAO,KAAK,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAK9C;YACY;AACZ,eAAO,MAAM,KAAK;;;EAGhB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAC;AAEtC,2DAA2D;AAC3D,eAAO,MAAM,OAAO;;QACA,MAAM;;;;QAED,MAAM;;EAC7B,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAE1C;;;kBAGkB;AAClB,eAAO,MAAM,SAAS;;;;iBAgBpB,CAAC;AAEH;4CAC4C;AAC5C,eAAO,MAAM,UAAU;;;iBASrB,CAAC;AAEH,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAElD;;4FAE4F;AAC5F,eAAO,MAAM,IAAI,WAAY,UAAU,KAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAGpE,CAAC;AAEH,uBAAuB;AACvB,eAAO,MAAM,EAAE,UAAW,KAAK,KAAG,MAAkB,CAAC;AAErD,iFAAiF;AACjF,eAAO,MAAM,MAAM,UAAW,KAAK,WAAW,OAAO;;;;;;;;;;;;;;;EAUjD,CAAC"}
@@ -5,23 +5,18 @@ import { defineMessageUnion } from "foldkit/message";
5
5
  import { modifyFields } from "foldkit/struct";
6
6
  import { Scheme, fromPinnedValue, toPinnedValue } from "./scheme.js";
7
7
  import { SCHEME_ATTRIBUTE, SCHEME_STORAGE_KEY } from "./script.js";
8
- // The scheme switch without its view, the same file in every system that has it; the view
9
- // is the system's own, in schemeSwitch.ts, which also passes all of this on.
10
- // MODEL
11
8
  /** Schema for the scheme switch: its id, and the scheme in force as far as the page has
12
9
  seen. */
13
10
  export const Model = Schema.Struct({
14
11
  id: Schema.String,
15
12
  scheme: Scheme,
16
13
  });
17
- // MESSAGE
18
14
  /** Union of all Messages the scheme switch can produce. */
19
15
  export const Message = defineMessageUnion({
20
16
  SelectedScheme: { scheme: Scheme },
21
17
  CompletedPinScheme: {},
22
18
  CompletedReadScheme: { scheme: Scheme },
23
19
  });
24
- // COMMAND
25
20
  /** Pins a scheme on `<html data-scheme>` and remembers it on this device in `localStorage`
26
21
  under the key `schemeScript` reads; `System` removes both. The attribute is written first,
27
22
  so storage that refuses (blocked or full) still switches the page; the choice is just not
@@ -29,16 +24,18 @@ export const Message = defineMessageUnion({
29
24
  export const PinScheme = Command.define("PinScheme", {
30
25
  args: { scheme: Scheme },
31
26
  messages: [Message.CompletedPinScheme],
32
- execute: ({ scheme }) => __foldkitBrandViewResult((Effect.try(() => __foldkitBrandViewResult((Option.match(toPinnedValue(scheme), {
33
- onNone: () => {
34
- document.documentElement.removeAttribute(SCHEME_ATTRIBUTE);
35
- localStorage.removeItem(SCHEME_STORAGE_KEY);
36
- },
37
- onSome: (value) => {
38
- document.documentElement.setAttribute(SCHEME_ATTRIBUTE, value);
39
- localStorage.setItem(SCHEME_STORAGE_KEY, value);
40
- },
41
- })), "@gjermundgaraba-designs/plain-garden/src/scheme/switch.js#anonymous")).pipe(Effect.ignore, Effect.as(Message.CompletedPinScheme()))), "@gjermundgaraba-designs/plain-garden/src/scheme/switch.js#execute"),
27
+ execute: ({ scheme }) => __foldkitBrandViewResult((Effect.try(() => {
28
+ Option.match(toPinnedValue(scheme), {
29
+ onNone: () => {
30
+ document.documentElement.removeAttribute(SCHEME_ATTRIBUTE);
31
+ localStorage.removeItem(SCHEME_STORAGE_KEY);
32
+ },
33
+ onSome: (value) => {
34
+ document.documentElement.setAttribute(SCHEME_ATTRIBUTE, value);
35
+ localStorage.setItem(SCHEME_STORAGE_KEY, value);
36
+ },
37
+ });
38
+ }).pipe(Effect.ignore, Effect.as(Message.CompletedPinScheme()))), "@gjermundgaraba-designs/plain-garden/src/scheme/switch.js#execute"),
42
39
  });
43
40
  /** Reads the scheme in force from `<html data-scheme>`: what `schemeScript` pinned before
44
41
  the page ran, or `System` without it. */
@@ -55,10 +52,8 @@ export const init = (config) => (__foldkitBrandViewResult(({
55
52
  model: { id: config.id, scheme: "System" },
56
53
  commands: [ReadScheme()],
57
54
  }), "@gjermundgaraba-designs/plain-garden/src/scheme/switch.js#init"));
58
- // ACCESSORS
59
55
  /** The switch's id. */
60
56
  export const id = (model) => __foldkitBrandViewResult((model.id), "@gjermundgaraba-designs/plain-garden/src/scheme/switch.js#id");
61
- // UPDATE
62
57
  /** Processes a scheme switch Message and returns the next Model and Commands. */
63
58
  export const update = (model, message) => __foldkitBrandViewResult((Message.match(message, {
64
59
  SelectedScheme: ({ scheme }) => (__foldkitBrandViewResult(({
@@ -0,0 +1,2 @@
1
+ export { view } from "./skip-link.ts";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/skip-link/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC"}
@@ -0,0 +1 @@
1
+ export { view } from "./skip-link.js";
@@ -5,4 +5,4 @@ import type { Html, HtmlBuilder } from "foldkit/html";
5
5
  routes every link click through its own update, so it must hand a fragment on the page
6
6
  being read back to the browser: `load(href)` from `foldkit/navigation`. */
7
7
  export declare const view: <Message>(h: HtmlBuilder<Message>) => Html;
8
- //# sourceMappingURL=skipLink.d.ts.map
8
+ //# sourceMappingURL=skip-link.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skip-link.d.ts","sourceRoot":"","sources":["../../../src/skip-link/skip-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtD;;;;8EAI8E;AAC9E,eAAO,MAAM,IAAI,GAAI,OAAO,KAAK,WAAW,CAAC,OAAO,CAAC,KAAG,IACW,CAAC"}
@@ -4,4 +4,4 @@ import { brandViewResult as __foldkitBrandViewResult } from 'foldkit/brand'
4
4
  following it the next Tab starts past the masthead, in the page. A Foldkit application
5
5
  routes every link click through its own update, so it must hand a fragment on the page
6
6
  being read back to the browser: `load(href)` from `foldkit/navigation`. */
7
- export const view = (h) => __foldkitBrandViewResult((h.a([h.Class("skip-link"), h.Href("#main")], ["Skip to content"])), "@gjermundgaraba-designs/plain-garden/src/skipLink/skipLink.js#view");
7
+ export const view = (h) => __foldkitBrandViewResult((h.a([h.Class("skip-link"), h.Href("#main")], ["Skip to content"])), "@gjermundgaraba-designs/plain-garden/src/skip-link/skip-link.js#view");
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEhD,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
@@ -3,8 +3,6 @@ import type { Html, HtmlBuilder } from "foldkit/html";
3
3
  export declare const STAGES: readonly ["rough", "growing", "settled"];
4
4
  /** How far along a note is. */
5
5
  export type StageName = (typeof STAGES)[number];
6
- /** The stage's drawn mark: an open ring, a half, a full disc. Drawn, not read; the word
7
- beside it is what is read. */
8
6
  export declare const markView: <Message>(stage: StageName, h: HtmlBuilder<Message>) => Html;
9
7
  /** A note's stage: its mark and its word. */
10
8
  export declare const view: <Message>(stage: StageName, h: HtmlBuilder<Message>) => Html;
@@ -1 +1 @@
1
- {"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../../src/stage/stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtD,gEAAgE;AAChE,eAAO,MAAM,MAAM,YAAI,OAAO,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAE/D,+BAA+B;AAC/B,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAQhD;iCACiC;AACjC,eAAO,MAAM,QAAQ,GAAI,OAAO,SAAS,SAAS,KAAK,WAAW,CAAC,OAAO,CAAC,KAAG,IAY3E,CAAC;AAEJ,6CAA6C;AAC7C,eAAO,MAAM,IAAI,GAAI,OAAO,SAAS,SAAS,KAAK,WAAW,CAAC,OAAO,CAAC,KAAG,IACV,CAAC;AAEjE,8DAA8D;AAC9D,eAAO,MAAM,IAAI,UAAW,SAAS,KAAG,MAAsB,CAAC"}
1
+ {"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../../src/stage/stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtD,gEAAgE;AAChE,eAAO,MAAM,MAAM,YAAI,OAAO,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAE/D,+BAA+B;AAC/B,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAQhD,eAAO,MAAM,QAAQ,GAAI,OAAO,SACvB,SAAS,KACb,WAAW,CAAC,OAAO,CAAC,KACtB,IAYA,CAAC;AAEJ,6CAA6C;AAC7C,eAAO,MAAM,IAAI,GAAI,OAAO,SACnB,SAAS,KACb,WAAW,CAAC,OAAO,CAAC,KACtB,IAAsE,CAAC;AAE1E,8DAA8D;AAC9D,eAAO,MAAM,IAAI,UAAW,SAAS,KAAG,MAAsB,CAAC"}
@@ -6,8 +6,6 @@ const WORDS = {
6
6
  growing: "Growing",
7
7
  settled: "Settled",
8
8
  };
9
- /** The stage's drawn mark: an open ring, a half, a full disc. Drawn, not read; the word
10
- beside it is what is read. */
11
9
  export const markView = (stage, h) => __foldkitBrandViewResult((h.svg([h.Class("stage-mark"), h.ViewBox("0 0 12 12"), h.AriaHidden(true)], [
12
10
  h.circle([h.Cx("6"), h.Cy("6"), h.R("4.75")]),
13
11
  ...(stage === "growing"
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/summary/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/summary/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
@@ -5,5 +5,5 @@ export type ViewConfig = Readonly<{
5
5
  }>;
6
6
  /** "In short": the points a long piece holds, as a plain numbered list under its header.
7
7
  Two elements, a heading and a list: spread them into the article. */
8
- export declare const view: <Message>(config: ViewConfig, h: HtmlBuilder<Message>) => ReadonlyArray<Html>;
8
+ export declare const view: <Message>(config: ViewConfig, h: HtmlBuilder<Message>) => readonly Html[];
9
9
  //# sourceMappingURL=summary.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/summary/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtD,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAE5E;wEACwE;AACxE,eAAO,MAAM,IAAI,GAAI,OAAO,UAAU,UAAU,KAAK,WAAW,CAAC,OAAO,CAAC,KAAG,aAAa,CAAC,IAAI,CAM7F,CAAC"}
1
+ {"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/summary/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtD,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAE5E;wEACwE;AACxE,eAAO,MAAM,IAAI,GAAI,OAAO,UAClB,UAAU,KACf,WAAW,CAAC,OAAO,CAAC,KACtB,SAAS,IAAI,EAMf,CAAC"}
@@ -1,9 +1,6 @@
1
1
  import type { Html, HtmlBuilder } from "foldkit/html";
2
- /** Configuration for rendering a date with `view`. */
3
2
  export type ViewConfig = Readonly<{
4
- /** ISO date, e.g. "2026-08-21". */
5
3
  datetime: string;
6
4
  }>;
7
- /** A date written out ("21 August 2026") over its machine-readable form. */
8
5
  export declare const view: <Message>(config: ViewConfig, h: HtmlBuilder<Message>) => Html;
9
6
  //# sourceMappingURL=time.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/time/time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAStD,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,IAAI,GAAI,OAAO,UAAU,UAAU,KAAK,WAAW,CAAC,OAAO,CAAC,KAAG,IACK,CAAC"}
1
+ {"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/time/time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAStD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,eAAO,MAAM,IAAI,GAAI,OAAO,UAClB,UAAU,KACf,WAAW,CAAC,OAAO,CAAC,KACtB,IAIA,CAAC"}
@@ -5,5 +5,4 @@ const LONG = new Intl.DateTimeFormat("en-GB", {
5
5
  year: "numeric",
6
6
  timeZone: "UTC",
7
7
  });
8
- /** A date written out ("21 August 2026") over its machine-readable form. */
9
8
  export const view = (config, h) => __foldkitBrandViewResult((h.time([h.Datetime(config.datetime)], [LONG.format(new Date(config.datetime))])), "@gjermundgaraba-designs/plain-garden/src/time/time.js#view");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gjermundgaraba-designs/plain-garden",
3
- "version": "0.7.0",
3
+ "version": "0.9.0",
4
4
  "license": "MIT",
5
5
  "repository": {
6
6
  "type": "git",
@@ -35,23 +35,23 @@
35
35
  "access": "public"
36
36
  },
37
37
  "devDependencies": {
38
- "@effect/platform-browser": "4.0.2",
39
- "@foldkit/ui": "0.168.0",
40
- "@foldkit/vite-plugin": "0.27.1",
38
+ "@effect/platform-browser": "4.0.6",
39
+ "@foldkit/ui": "0.169.0",
40
+ "@foldkit/vite-plugin": "0.28.0",
41
41
  "@my-designs/specimen": "0.0.0",
42
- "@types/node": "^26.6.2",
43
- "effect": "4.0.2",
44
- "foldkit": "0.168.0",
45
- "happy-dom": "^20.14.5",
46
- "typescript": "^7.0.2",
47
- "vite": "npm:@voidzero-dev/vite-plus-core@1.0.0",
48
- "vite-plus": "1.0.0"
42
+ "@types/node": "26.6.5",
43
+ "effect": "4.0.6",
44
+ "foldkit": "0.169.0",
45
+ "happy-dom": "21.0.4",
46
+ "typescript": "7.0.2",
47
+ "vite": "npm:@voidzero-dev/vite-plus-core@1.4.0",
48
+ "vite-plus": "1.4.0"
49
49
  },
50
50
  "peerDependencies": {
51
51
  "@effect/platform-browser": "^4.0.0",
52
- "@foldkit/ui": "^0.168.0",
52
+ "@foldkit/ui": "^0.169.0",
53
53
  "effect": "^4.0.0",
54
- "foldkit": "^0.168.0"
54
+ "foldkit": "^0.169.0"
55
55
  },
56
56
  "scripts": {
57
57
  "dev": "vp dev",
package/src/box/box.ts CHANGED
@@ -5,13 +5,16 @@ export type ViewConfig = Readonly<{
5
5
  /** The heading's id, which names the box; unique in the document. */
6
6
  id: string;
7
7
  heading: string;
8
- body: ReadonlyArray<Html>;
8
+ body: readonly Html[];
9
9
  }>;
10
10
 
11
11
  /** A set-apart group under a hairline and a small heading: What's new, the pages that
12
12
  link here. */
13
- export const view = <Message>(config: ViewConfig, h: HtmlBuilder<Message>): Html =>
13
+ export const view = <Message>(
14
+ config: ViewConfig,
15
+ h: HtmlBuilder<Message>
16
+ ): Html =>
14
17
  h.section(
15
18
  [h.Class("box"), h.AriaLabelledBy(config.id)],
16
- [h.h2([h.Id(config.id)], [config.heading]), ...config.body],
19
+ [h.h2([h.Id(config.id)], [config.heading]), ...config.body]
17
20
  );
package/src/box/index.ts CHANGED
@@ -1,2 +1,3 @@
1
1
  export { view } from "./box.ts";
2
+
2
3
  export type { ViewConfig } from "./box.ts";
@@ -9,14 +9,20 @@ export type Change = Readonly<{
9
9
  }>;
10
10
 
11
11
  /** Configuration for rendering the changes with `view`. */
12
- export type ViewConfig = Readonly<{ changes: ReadonlyArray<Change> }>;
12
+ export type ViewConfig = Readonly<{ changes: readonly Change[] }>;
13
13
 
14
14
  /** What's new: what changed in the garden, a date and a line each. Newest first is the
15
15
  writer's call; the list keeps the order it is given. */
16
- export const view = <Message>(config: ViewConfig, h: HtmlBuilder<Message>): Html =>
16
+ export const view = <Message>(
17
+ config: ViewConfig,
18
+ h: HtmlBuilder<Message>
19
+ ): Html =>
17
20
  h.ul(
18
21
  [h.Class("changes")],
19
22
  config.changes.map((change) =>
20
- h.li([], [Time.view({ datetime: change.date }, h), h.span([], change.body)]),
21
- ),
23
+ h.li(
24
+ [],
25
+ [Time.view({ datetime: change.date }, h), h.span([], change.body)]
26
+ )
27
+ )
22
28
  );
@@ -1,2 +1,3 @@
1
1
  export { view } from "./changes.ts";
2
+
2
3
  export type { Change, ViewConfig } from "./changes.ts";
@@ -1,6 +1,6 @@
1
1
  import type { Html, HtmlBuilder } from "foldkit/html";
2
2
 
3
- import type { ViewInputs as CopyInputs } from "../copyButton/copyButton.ts";
3
+ import type { ViewInputs as CopyInputs } from "../copy-button/copy-button.ts";
4
4
  import * as Figure from "../figure/figure.ts";
5
5
  import { noteId } from "../figure/figures.ts";
6
6
 
@@ -9,35 +9,46 @@ export type ViewConfig = Readonly<{
9
9
  number: number;
10
10
  caption: string;
11
11
  code: string;
12
- notes?: ReadonlyArray<Figure.Note> | undefined;
12
+ notes?: readonly Figure.Note[] | undefined;
13
13
  /** The Copy button: the page's `CopyButton`, rendered with what the figure gives it (its
14
14
  name and its code). Without one the caption is just the caption. */
15
15
  copy?: ((inputs: CopyInputs) => Html) | undefined;
16
16
  }>;
17
17
 
18
18
  /** Code with numbered lines, a caption, Copy, and notes that link to single lines. */
19
- export const view = <Message>(config: ViewConfig, h: HtmlBuilder<Message>): Html => {
19
+ export const view = <Message>(
20
+ config: ViewConfig,
21
+ h: HtmlBuilder<Message>
22
+ ): Html => {
20
23
  const { number, caption, code, notes, copy } = config;
24
+
21
25
  const lines = code
22
26
  .split("\n")
23
27
  .flatMap((line, index) => [
24
28
  ...(index > 0 ? ["\n"] : []),
25
29
  h.span([h.Class("line"), h.Id(noteId(number, index + 1))], [line]),
26
30
  ]);
31
+
27
32
  return Figure.view(
28
33
  {
29
34
  number,
30
35
  caption,
31
36
  notes,
32
- tools: copy === undefined ? [] : [copy({ name: `Fig. ${number}`, text: code })],
33
- // A scrolling region the keyboard can reach.
37
+ tools:
38
+ copy === undefined
39
+ ? []
40
+ : [copy({ name: `Fig. ${number}`, text: code })],
34
41
  body: [
35
42
  h.pre(
36
- [h.Tabindex(0), h.Role("region"), h.AriaLabel(`Fig. ${number}, code`)],
37
- [h.code([], lines)],
43
+ [
44
+ h.Tabindex(0),
45
+ h.Role("region"),
46
+ h.AriaLabel(`Fig. ${number}, code`),
47
+ ],
48
+ [h.code([], lines)]
38
49
  ),
39
50
  ],
40
51
  },
41
- h,
52
+ h
42
53
  );
43
54
  };
@@ -0,0 +1,3 @@
1
+ export { view } from "./code-figure.ts";
2
+
3
+ export type { ViewConfig } from "./code-figure.ts";
package/src/copy/copy.ts CHANGED
@@ -6,10 +6,6 @@ import { defineTaggedUnion } from "foldkit/schema";
6
6
  import { modifyFields } from "foldkit/struct";
7
7
  import type * as Update from "foldkit/update";
8
8
 
9
- // A copy to the clipboard, without its view: the system's own control renders it.
10
-
11
- // MODEL
12
-
13
9
  /** Where a copy is: nothing yet, writing to the clipboard, just copied, or just refused. */
14
10
  export const CopyState = defineTaggedUnion({
15
11
  Idle: {},
@@ -17,6 +13,7 @@ export const CopyState = defineTaggedUnion({
17
13
  Copied: {},
18
14
  Failed: {},
19
15
  });
16
+
20
17
  export type CopyState = typeof CopyState.Type;
21
18
 
22
19
  /** Schema for a copy control: what it says it just did. */
@@ -24,9 +21,8 @@ export const Model = Schema.Struct({
24
21
  id: Schema.String,
25
22
  state: CopyState,
26
23
  });
27
- export type Model = typeof Model.Type;
28
24
 
29
- // MESSAGE
25
+ export type Model = typeof Model.Type;
30
26
 
31
27
  /** Union of all Messages a copy control can produce. */
32
28
  export const Message = defineMessageUnion({
@@ -35,9 +31,8 @@ export const Message = defineMessageUnion({
35
31
  FailedCopyText: {},
36
32
  CompletedWaitBeforeSettling: {},
37
33
  });
38
- export type Message = typeof Message.Type;
39
34
 
40
- // INIT
35
+ export type Message = typeof Message.Type;
41
36
 
42
37
  /** Configuration for creating a copy control with `init`: its id, unique in the document. */
43
38
  export type InitConfig = Readonly<{ id: string }>;
@@ -48,14 +43,9 @@ export const init = (config: InitConfig): Model => ({
48
43
  state: CopyState.Idle(),
49
44
  });
50
45
 
51
- // ACCESSORS
52
-
53
46
  /** The control's id, unique in the document. */
54
47
  export const id = (model: Model): string => model.id;
55
48
 
56
- // COMMAND
57
-
58
- /** How long the control answers for: that it copied, or that the copy failed. */
59
49
  const WORD_BEAT = Duration.millis(1600);
60
50
 
61
51
  /** Writes the text to the clipboard through Effect's `Clipboard` port. Provide
@@ -67,18 +57,19 @@ export const CopyText = Command.define("CopyText", {
67
57
  Effect.gen(function* () {
68
58
  const clipboard = yield* Clipboard.Clipboard;
69
59
  yield* clipboard.writeString(text);
60
+
70
61
  return Message.SucceededCopyText();
71
- }).pipe(Effect.catch(() => Effect.succeed(Message.FailedCopyText()))),
62
+ }).pipe(Effect.orElseSucceed(() => Message.FailedCopyText())),
72
63
  });
73
64
 
74
65
  /** Waits out the beat the answer shows for. */
75
66
  export const WaitBeforeSettling = Command.define("WaitBeforeSettling", {
76
67
  messages: [Message.CompletedWaitBeforeSettling],
77
- execute: Effect.sleep(WORD_BEAT).pipe(Effect.as(Message.CompletedWaitBeforeSettling())),
68
+ execute: Effect.sleep(WORD_BEAT).pipe(
69
+ Effect.as(Message.CompletedWaitBeforeSettling())
70
+ ),
78
71
  });
79
72
 
80
- // UPDATE
81
-
82
73
  type UpdateReturn = Update.Return<Model, Message, Clipboard.Clipboard>;
83
74
 
84
75
  const holdAnswer = (model: Model, state: CopyState): UpdateReturn => ({
@@ -0,0 +1,96 @@
1
+ import { Button as UiButton } from "@foldkit/ui";
2
+ import type { Attribute, Html, HtmlBuilder } from "foldkit/html";
3
+ import { defineView } from "foldkit/submodel";
4
+
5
+ import { CopyState, Message } from "../copy/copy.ts";
6
+ import type { Model } from "../copy/copy.ts";
7
+
8
+ export {
9
+ CopyState,
10
+ CopyText,
11
+ Message,
12
+ Model,
13
+ WaitBeforeSettling,
14
+ id,
15
+ init,
16
+ update,
17
+ } from "../copy/copy.ts";
18
+
19
+ export type { InitConfig } from "../copy/copy.ts";
20
+
21
+ /** Per-render inputs passed to `view` through `h.submodel`'s `viewInputs`. */
22
+ export type ViewInputs = Readonly<{
23
+ /** What is copied: the figure's name ("Fig. 4"), for the button's name and what is said. */
24
+ name: string;
25
+ /** What goes on the clipboard. */
26
+ text: string;
27
+ }>;
28
+
29
+ const word = (state: CopyState): string =>
30
+ CopyState.match(state, {
31
+ Idle: () => "Copy",
32
+ Copying: () => "Copy",
33
+ Copied: () => "Copied",
34
+ Failed: () => "Copy",
35
+ });
36
+
37
+ const said = (state: CopyState, name: string): string =>
38
+ CopyState.match(state, {
39
+ Idle: () => "",
40
+ Copying: () => "",
41
+ Copied: () => `${name} copied`,
42
+ Failed: () => "copy failed",
43
+ });
44
+
45
+ type ButtonConfig<ParentMessage> = Readonly<{
46
+ attributes: ReadonlyArray<Attribute<ParentMessage>>;
47
+ onClick?: ParentMessage;
48
+ }>;
49
+
50
+ const buttonView = <ParentMessage>(
51
+ state: CopyState,
52
+ { attributes, ...press }: ButtonConfig<ParentMessage>,
53
+ h: HtmlBuilder<ParentMessage>
54
+ ): Html =>
55
+ UiButton.view(
56
+ {
57
+ ...press,
58
+ isDisabled: !CopyState.guards.Idle(state),
59
+ toView: ({ button }) =>
60
+ h.button([...button, h.Class("copy"), ...attributes], [word(state)]),
61
+ },
62
+ h
63
+ );
64
+
65
+ /** Copy, a button built on `@foldkit/ui`'s Button and dressed as a link, that reads Copied
66
+ in ink for a beat and says so to screen readers; held while it does. Where the clipboard
67
+ is refused it still reads Copy, held for the same beat, and the status says "copy failed".
68
+ Its `CopyText` Command needs `Clipboard.layer` in the application's resources. Spread it
69
+ into a figure's `tools`: a button, then the status region that is announced, not shown. */
70
+ export const view = defineView<Model, Message, ViewInputs>(
71
+ (model, { name, text }, h): Html =>
72
+ h.span(
73
+ [h.Id(model.id)],
74
+ [
75
+ buttonView(
76
+ model.state,
77
+ {
78
+ attributes: [h.AriaLabel(`Copy ${name}`)],
79
+ onClick: Message.ClickedCopy({ text }),
80
+ },
81
+ h
82
+ ),
83
+ h.span(
84
+ [h.Class("sr-only"), h.Role("status")],
85
+ [said(model.state, name)]
86
+ ),
87
+ ]
88
+ )
89
+ );
90
+
91
+ /** The button as it prints in one state, inert: a picture for a specimen, with no Model and
92
+ nothing to press or announce. */
93
+ export const stateView = <ParentMessage>(
94
+ state: CopyState,
95
+ h: HtmlBuilder<ParentMessage>
96
+ ): Html => buttonView(state, { attributes: [h.Inert(true)] }, h);
@@ -6,7 +6,9 @@ export {
6
6
  WaitBeforeSettling,
7
7
  id,
8
8
  init,
9
+ stateView,
9
10
  update,
10
11
  view,
11
- } from "./copyButton.ts";
12
- export type { InitConfig, ViewInputs } from "./copyButton.ts";
12
+ } from "./copy-button.ts";
13
+
14
+ export type { InitConfig, ViewInputs } from "./copy-button.ts";