@zeyos/zx 5.4.0 → 5.5.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 (113) hide show
  1. package/CHANGELOG.md +80 -0
  2. package/README.md +23 -16
  3. package/dist/types/components/app-sidebar/app-sidebar.d.ts +33 -0
  4. package/dist/types/components/badge/badge.d.ts +5 -4
  5. package/dist/types/components/datebox/date-range-box.d.ts +15 -2
  6. package/dist/types/components/datebox/datebox.d.ts +37 -3
  7. package/dist/types/components/kbd/kbd.d.ts +41 -0
  8. package/dist/types/components/launcher/launcher.d.ts +4 -2
  9. package/dist/types/components/prose/prose.d.ts +69 -0
  10. package/dist/types/components/questionnaire/questionnaire.d.ts +0 -36
  11. package/dist/types/components/stat-tile/stat-tile.d.ts +20 -0
  12. package/dist/types/components/tag-picker/tag-picker.d.ts +11 -5
  13. package/dist/types/components/tree/tree.d.ts +44 -3
  14. package/dist/types/core/icons.d.ts +22 -1
  15. package/dist/types/index.d.ts +4 -2
  16. package/dist/types/internal/app-rail.d.ts +10 -3
  17. package/dist/types/internal/row-actions.d.ts +151 -0
  18. package/dist/zx-zeyos.esm.js +264 -82
  19. package/dist/zx-zeyos.esm.min.js +4 -4
  20. package/dist/zx.css +1225 -433
  21. package/dist/zx.esm.js +952 -392
  22. package/dist/zx.esm.min.js +6 -6
  23. package/dist/zx.global.js +952 -392
  24. package/dist/zx.global.min.js +6 -6
  25. package/dist/zx.min.css +1 -1
  26. package/docs/api.json +112 -4
  27. package/docs/llms.md +243 -37
  28. package/docs/llms.txt +2 -0
  29. package/package.json +1 -1
  30. package/src/components/account-menu/account-menu.js +2 -2
  31. package/src/components/app-rail/app-rail.css +11 -11
  32. package/src/components/app-sidebar/app-sidebar.css +90 -17
  33. package/src/components/app-sidebar/app-sidebar.js +120 -12
  34. package/src/components/badge/badge.css +33 -20
  35. package/src/components/badge/badge.js +5 -4
  36. package/src/components/breadcrumb/breadcrumb.css +28 -3
  37. package/src/components/breadcrumb/breadcrumb.js +2 -2
  38. package/src/components/button/button.css +24 -13
  39. package/src/components/button/button.js +20 -2
  40. package/src/components/calendar/calendar.css +14 -4
  41. package/src/components/card-view/card-view.js +2 -2
  42. package/src/components/chart/chart.js +20 -5
  43. package/src/components/check-button/check-button.css +11 -3
  44. package/src/components/check-button/check-button.js +3 -3
  45. package/src/components/context-menu/context-menu.css +7 -1
  46. package/src/components/date-picker/date-picker.css +6 -0
  47. package/src/components/date-picker/date-picker.js +5 -5
  48. package/src/components/date-picker/date-range-picker.css +6 -0
  49. package/src/components/date-picker/date-range-picker.js +3 -3
  50. package/src/components/date-picker/month-picker.js +3 -3
  51. package/src/components/date-picker/time-picker.css +6 -0
  52. package/src/components/datebox/date-range-box.js +30 -6
  53. package/src/components/datebox/datebox.js +44 -7
  54. package/src/components/dialog/dialog.css +0 -1
  55. package/src/components/dialog/dialog.js +2 -1
  56. package/src/components/dock/dock.js +2 -2
  57. package/src/components/dropdown/dropdown.css +2 -1
  58. package/src/components/entity-ref/entity-ref.css +8 -1
  59. package/src/components/file-item/file-item.css +1 -1
  60. package/src/components/finder/finder.js +2 -2
  61. package/src/components/groupbox/groupbox.js +2 -2
  62. package/src/components/kanban-view/kanban-view.css +8 -4
  63. package/src/components/kanban-view/kanban-view.js +3 -3
  64. package/src/components/kbd/kbd.css +64 -0
  65. package/src/components/kbd/kbd.js +121 -0
  66. package/src/components/launcher/launcher.css +30 -25
  67. package/src/components/launcher/launcher.js +15 -21
  68. package/src/components/list-toolbar/list-toolbar.css +7 -1
  69. package/src/components/menu-button/menu-button.css +9 -2
  70. package/src/components/message/message.js +2 -2
  71. package/src/components/module-bar/module-bar.css +11 -1
  72. package/src/components/multi-value-editor/multi-value-editor.js +4 -4
  73. package/src/components/navigation-bar/navigation-bar.css +3 -2
  74. package/src/components/pagination/pagination.js +2 -2
  75. package/src/components/panel/panel.js +2 -2
  76. package/src/components/prose/prose.css +53 -0
  77. package/src/components/prose/prose.js +152 -0
  78. package/src/components/questionnaire/questionnaire.css +7 -17
  79. package/src/components/questionnaire/questionnaire.js +16 -1
  80. package/src/components/rating/rating.css +3 -1
  81. package/src/components/search/search.js +2 -2
  82. package/src/components/select/glyphs.js +3 -3
  83. package/src/components/select/select.css +35 -7
  84. package/src/components/select/select.js +4 -4
  85. package/src/components/stat-tile/stat-tile.css +56 -2
  86. package/src/components/stat-tile/stat-tile.js +25 -2
  87. package/src/components/stepper/stepper.css +2 -1
  88. package/src/components/stepper/stepper.js +3 -3
  89. package/src/components/tabbox/tabbox.css +2 -2
  90. package/src/components/tabbox/tabbox.js +2 -2
  91. package/src/components/table/table.css +52 -16
  92. package/src/components/table/table.js +7 -5
  93. package/src/components/tag-picker/tag-picker.css +56 -43
  94. package/src/components/tag-picker/tag-picker.js +21 -16
  95. package/src/components/tree/tree.css +44 -0
  96. package/src/components/tree/tree.js +97 -9
  97. package/src/components/value-list/value-list.css +25 -4
  98. package/src/components/value-list/value-list.js +2 -1
  99. package/src/components/view/record-view.js +3 -3
  100. package/src/components/view-settings/view-settings.css +2 -1
  101. package/src/components/workspace-switcher/workspace-switcher.js +3 -3
  102. package/src/core/icons.js +34 -3
  103. package/src/elements/define.js +1 -0
  104. package/src/index.js +4 -2
  105. package/src/internal/app-rail.js +5 -1
  106. package/src/internal/row-actions.js +203 -0
  107. package/styles/base.css +26 -1
  108. package/styles/prose.css +306 -0
  109. package/styles/tokens/dark.css +97 -120
  110. package/styles/tokens/global.css +24 -9
  111. package/styles/tokens/semantic.css +464 -184
  112. package/styles/tokens/themes.css +9 -0
  113. package/styles/zx.css +3 -0
@@ -1,10 +1,11 @@
1
1
  import { Component } from '../../core/component.js';
2
2
  import { h, safeHref } from '../../core/dom.js';
3
- import { icon } from '../../core/icons.js';
3
+ import { ICON_SIZE, icon } from '../../core/icons.js';
4
4
  import { printf } from '../../core/i18n.js';
5
5
  import { connectedOverlayHost, overlayScope } from '../../core/overlay-host.js';
6
6
  import { pushOverlay } from '../../core/overlay-stack.js';
7
7
  import { uid } from '../../core/util.js';
8
+ import { kbd } from '../kbd/kbd.js';
8
9
 
9
10
  /**
10
11
  * @typedef {Object} LauncherItem
@@ -17,7 +18,8 @@ import { uid } from '../../core/util.js';
17
18
  * @property {string|number} [badge] Compact metadata.
18
19
  * @property {string|number} [hint] Muted text at the end of the row, such as a current value or a project.
19
20
  * @property {string|string[]|{label: string|string[], keys?: string}} [shortcut] Key labels drawn as
20
- * key caps (`['⌘', 'K']`), or Button's `{label, keys}` shape. Display only: the Launcher binds nothing.
21
+ * key caps with `kbd()` (`['⌘', 'K']`; a name such as `'Mod'` or `'Shift'` takes the platform's
22
+ * glyph), or Button's `{label, keys}` shape. Display only: the Launcher binds nothing.
21
23
  * @property {string} [keys] The same shortcut in `aria-keyshortcuts` syntax (`'Meta+K'`), exposed on
22
24
  * the option for assistive technology.
23
25
  * @property {'application'|'record'|'action'} [kind='action'] Tile or row presentation.
@@ -214,7 +216,7 @@ export class Launcher extends Component {
214
216
  ref: 'scopeBack',
215
217
  class: 'zx-icon-btn zx-launcher__scope-back',
216
218
  type: 'button'
217
- }, icon('x'));
219
+ }, icon('x', { size: ICON_SIZE.dismiss }));
218
220
  const scope = h('span', { ref: 'scope', class: 'zx-launcher__scope', hidden: true },
219
221
  h('span', { ref: 'scopeLabel', class: 'zx-launcher__scope-label' }), scopeBack);
220
222
  const close = h('button', {
@@ -222,7 +224,7 @@ export class Launcher extends Component {
222
224
  class: 'zx-icon-btn zx-launcher__close',
223
225
  type: 'button',
224
226
  ariaLabel: this.options.closeLabel ?? this._message('launcher.close', 'Close launcher')
225
- }, icon('x'));
227
+ }, icon('x', { size: ICON_SIZE.dismiss }));
226
228
  const status = h('div', {
227
229
  ref: 'status',
228
230
  class: 'zx-launcher__status',
@@ -245,10 +247,9 @@ export class Launcher extends Component {
245
247
  role: 'listbox',
246
248
  ariaLabel: this.options.resultsLabel ?? this._message('launcher.results', 'Launcher results')
247
249
  });
248
- const shortcut = this.options.shortcut === 'mod+k' ? h('kbd', {
249
- class: 'zx-launcher__shortcut',
250
- ariaHidden: 'true'
251
- }, launcherShortcutLabel()) : null;
250
+ const shortcut = this.options.shortcut === 'mod+k'
251
+ ? h('span', { class: 'zx-launcher__shortcut', ariaHidden: 'true' }, kbd('Mod+K'))
252
+ : null;
252
253
  const footer = launcherHints(this.options.hints, {
253
254
  move: this._message('launcher.hintMove', 'Move'),
254
255
  open: this._message('launcher.hintOpen', 'Open'),
@@ -790,8 +791,8 @@ export class Launcher extends Component {
790
791
  const caps = launcherShortcutCaps(item.shortcut);
791
792
  // Drawn caps are part of the option's name unless `keys` already exposes the shortcut.
792
793
  if (caps.length) children.push(h('span', { class: 'zx-launcher__keys', ariaHidden: keys ? 'true' : null },
793
- caps.map((cap) => h('kbd', { class: 'zx-launcher__key' }, cap))));
794
- if (page) children.push(h('span', { class: 'zx-launcher__chevron', ariaHidden: 'true' }, icon('chevron-right')));
794
+ kbd(caps, { size: 'sm' })));
795
+ if (page) children.push(h('span', { class: 'zx-launcher__chevron', ariaHidden: 'true' }, icon('chevron-right', { size: ICON_SIZE.chevron })));
795
796
  return /** @type {HTMLElement} */ (h(tag, {
796
797
  class: 'zx-launcher__option',
797
798
  type: tag === 'button' ? 'button' : null,
@@ -995,13 +996,6 @@ export class Launcher extends Component {
995
996
  }
996
997
  }
997
998
 
998
- /** @returns {string} */
999
- function launcherShortcutLabel() {
1000
- const platform = String((/** @type {any} */ (navigator)).userAgentData?.platform
1001
- ?? navigator.platform ?? '');
1002
- return /mac|iphone|ipad/i.test(platform) ? '⌘ K' : 'Ctrl K';
1003
- }
1004
-
1005
999
  /**
1006
1000
  * @param {LauncherOptions['hints']} hints Host-supplied hint labels, or false to omit the row.
1007
1001
  * @param {{move: string, open: string, back: string, close: string}} defaults Resolved built-in labels.
@@ -1011,11 +1005,11 @@ function launcherHints(hints, defaults) {
1011
1005
  if (hints === false) return null;
1012
1006
  const labels = hints && typeof hints === 'object' ? hints : {};
1013
1007
  return h('footer', { class: 'zx-launcher__hints', ariaHidden: 'true' },
1014
- h('span', {}, h('kbd', {}, '↑↓←→'), labels.move ?? defaults.move),
1015
- h('span', {}, h('kbd', {}, '↵'), labels.open ?? defaults.open),
1008
+ h('span', {}, kbd(['↑↓←→']), labels.move ?? defaults.move),
1009
+ h('span', {}, kbd('Enter'), labels.open ?? defaults.open),
1016
1010
  // Shown only on a page (`_syncPage()`).
1017
- h('span', { ref: 'backHint', hidden: true }, h('kbd', {}, '⌫'), labels.back ?? defaults.back),
1018
- h('span', {}, h('kbd', {}, 'Esc'), labels.close ?? defaults.close));
1011
+ h('span', { ref: 'backHint', hidden: true }, kbd('Backspace'), labels.back ?? defaults.back),
1012
+ h('span', {}, kbd('Escape'), labels.close ?? defaults.close));
1019
1013
  }
1020
1014
 
1021
1015
  /**
@@ -109,6 +109,11 @@
109
109
  background: var(--zx-color-bg-current);
110
110
  }
111
111
 
112
+ /* Pointed at, a pressed tool keeps its fill and takes the hover step on top of it. */
113
+ .zx-list-toolbar__tool[aria-pressed="true"]:hover:not(:disabled) {
114
+ background: linear-gradient(var(--zx-color-bg-hover), var(--zx-color-bg-hover)), var(--zx-color-bg-current);
115
+ }
116
+
112
117
  .zx-list-toolbar__tool:disabled {
113
118
  color: var(--zx-color-text-placeholder);
114
119
  cursor: default;
@@ -134,7 +139,8 @@
134
139
  min-inline-size: 44px;
135
140
  padding-inline: var(--zx-space-2);
136
141
  border: 0;
137
- border-radius: calc(var(--zx-control-radius) - 2px);
142
+ /* Concentric with the frame: its corner less the 1px border and the 2px padding between them. */
143
+ border-radius: max(0px, calc(var(--zx-control-radius) - 3px));
138
144
  background: none;
139
145
  color: var(--zx-color-text-muted);
140
146
  font-size: var(--zx-control-font-size);
@@ -89,14 +89,20 @@
89
89
  padding-inline: var(--zx-space-1);
90
90
  color: var(--zx-color-text-muted);
91
91
  font-size: var(--zx-text-xs);
92
+ font-variant-numeric: tabular-nums;
92
93
  text-align: center;
93
94
  }
94
95
 
96
+ /* A shortcut is text at the right edge, no box — set the way a keycap's label is, so every key
97
+ hint in the library shares one type treatment. */
95
98
  .zx-menu-button__shortcut {
96
99
  border: 0;
97
100
  background: transparent;
98
101
  padding: 0;
99
- font-family: var(--zx-font-mono);
102
+ font-family: var(--zx-font-sans);
103
+ font-weight: var(--zx-weight-medium);
104
+ font-feature-settings: "case", "tnum";
105
+ white-space: nowrap;
100
106
  }
101
107
 
102
108
  .zx-menu-button__check {
@@ -152,7 +158,8 @@
152
158
  display: inline-flex;
153
159
  flex: none;
154
160
  gap: 2px;
155
- border-radius: var(--zx-radius-md);
161
+ /* The thumb's corner plus the 2px of track around it. */
162
+ border-radius: calc(var(--zx-radius-sm) + 2px);
156
163
  background: var(--zx-color-bg-hover);
157
164
  padding: 2px;
158
165
  }
@@ -1,6 +1,6 @@
1
1
  import { Component } from '../../core/component.js';
2
2
  import { h, resolveElement } from '../../core/dom.js';
3
- import { icon } from '../../core/icons.js';
3
+ import { ICON_SIZE, icon } from '../../core/icons.js';
4
4
  import { overlayScope } from '../../core/overlay-host.js';
5
5
  import { overlayStack } from '../../core/overlay-stack.js';
6
6
  import { button } from '../button/button.js';
@@ -422,7 +422,7 @@ export class Message extends Component {
422
422
  type: 'button',
423
423
  ariaLabel: this._message('message.close', 'Close message'),
424
424
  title: this._message('message.closeTitle', 'Close')
425
- }, icon('x', { size: 14 }));
425
+ }, icon('x', { size: ICON_SIZE.dismiss }));
426
426
  node.append(close);
427
427
  this.listen(close, 'click', () => this._close(entry));
428
428
  }
@@ -57,13 +57,23 @@
57
57
  block-size: auto;
58
58
  min-block-size: var(--zx-module-bar-target);
59
59
  padding: var(--zx-space-1) var(--zx-space-2);
60
- color: var(--zx-color-text);
60
+ /* The names rest one ink step under the content, as navigation does, and come up to the full
61
+ text colour when pointed at, focused, current, or open. */
62
+ color: var(--zx-color-text-chrome);
61
63
  font-size: var(--zx-text-md);
62
64
  font-weight: 500;
63
65
  line-height: 1.3;
64
66
  text-align: start;
65
67
  }
66
68
 
69
+ .zx-module-bar[data-labels="beside"] .zx-module-bar__item:is(:hover, :focus-visible, [aria-current], [aria-expanded="true"]):not([aria-disabled="true"]) {
70
+ color: var(--zx-color-text);
71
+ }
72
+
73
+ .zx-module-bar[data-labels="beside"] .zx-module-bar__item[aria-disabled="true"] {
74
+ color: var(--zx-color-text-muted);
75
+ }
76
+
67
77
  .zx-module-bar[data-labels="beside"] .zx-module-bar__label { text-align: start; }
68
78
 
69
79
  .zx-module-bar[data-labels="beside"] .zx-module-bar__badge {
@@ -1,6 +1,6 @@
1
1
  import { Component } from '../../core/component.js';
2
2
  import { h } from '../../core/dom.js';
3
- import { icon } from '../../core/icons.js';
3
+ import { ICON_SIZE, icon } from '../../core/icons.js';
4
4
 
5
5
  /**
6
6
  * @typedef {Object} MultiValueEditorOptions
@@ -153,20 +153,20 @@ export class MultiValueEditor extends Component {
153
153
  ariaDisabled: String(index === 0),
154
154
  ariaLabel: `Move value ${index + 1} up`,
155
155
  dataset: { action: 'up', index }
156
- }, icon('chevron-up', { size: 12 })) : null,
156
+ }, icon('chevron-up', { size: ICON_SIZE.chevron })) : null,
157
157
  buttons ? h('button', {
158
158
  class: 'zx-btn',
159
159
  type: 'button',
160
160
  ariaDisabled: String(index === last),
161
161
  ariaLabel: `Move value ${index + 1} down`,
162
162
  dataset: { action: 'down', index }
163
- }, icon('chevron-down', { size: 12 })) : null,
163
+ }, icon('chevron-down', { size: ICON_SIZE.chevron })) : null,
164
164
  h('button', {
165
165
  class: 'zx-btn',
166
166
  type: 'button',
167
167
  ariaLabel: `Remove value ${index + 1}`,
168
168
  dataset: { action: 'remove', index }
169
- }, icon('x', { size: 12 }))
169
+ }, icon('x', { size: ICON_SIZE.dismiss }))
170
170
  )
171
171
  );
172
172
  });
@@ -29,7 +29,7 @@
29
29
  padding-inline: var(--zx-space-2);
30
30
  color: var(--zx-color-accent);
31
31
  font-size: var(--zx-text-xl);
32
- font-weight: 650;
32
+ font-weight: var(--zx-weight-title);
33
33
  letter-spacing: var(--zx-tracking-title);
34
34
  }
35
35
 
@@ -61,7 +61,8 @@
61
61
  cursor: pointer;
62
62
  }
63
63
 
64
- .zx-navigation-bar__item:hover:not([aria-disabled="true"]) {
64
+ /* The current item is left out, so pointing at it never trades its fill for the lighter hover. */
65
+ .zx-navigation-bar__item:hover:not([aria-disabled="true"], [aria-current="page"], [aria-selected="true"]) {
65
66
  background: var(--zx-color-bg-hover);
66
67
  color: var(--zx-color-text);
67
68
  }
@@ -1,7 +1,7 @@
1
1
  import { Component } from '../../core/component.js';
2
2
  import { h, restoreTarget, snapshotTarget } from '../../core/dom.js';
3
3
  import { printf } from '../../core/i18n.js';
4
- import { icon } from '../../core/icons.js';
4
+ import { ICON_SIZE, icon } from '../../core/icons.js';
5
5
 
6
6
  /** @typedef {'pages'|'loadmore'} PaginationMode */
7
7
 
@@ -336,7 +336,7 @@ export class Pagination extends Component {
336
336
  ref,
337
337
  ariaLabel: label,
338
338
  dataset: { kind: 'default', size: 'sm' }
339
- }, icon(glyph, { size: 14 }));
339
+ }, icon(glyph, { size: ICON_SIZE.chevron }));
340
340
  }
341
341
 
342
342
  /** @returns {HTMLElement} The append-style trigger. */
@@ -1,6 +1,6 @@
1
1
  import { Component } from '../../core/component.js';
2
2
  import { h } from '../../core/dom.js';
3
- import { icon } from '../../core/icons.js';
3
+ import { ICON_SIZE, icon } from '../../core/icons.js';
4
4
  import { isElement, uid } from '../../core/util.js';
5
5
  import { button } from '../button/button.js';
6
6
 
@@ -83,7 +83,7 @@ export class Panel extends Component {
83
83
  toggleChildren.push(h('span', {
84
84
  class: 'zx-panel__chevron',
85
85
  ariaHidden: 'true'
86
- }, icon('chevron-right', { size: 16 })));
86
+ }, icon('chevron-right', { size: ICON_SIZE.chevron })));
87
87
  }
88
88
  toggleChildren.push(title);
89
89
 
@@ -0,0 +1,53 @@
1
+ /*
2
+ * Section links (`proseAnchors()`). A heading with an id ends in a small link to itself; the heading
3
+ * is the reveal host (base.css), so the link rests out of sight, keeps its room, and shows while the
4
+ * heading is pointed at or the link has focus — and always on a touch screen or under a contrast
5
+ * preference. The link is a square a little smaller than a control, sized so that a heading's line
6
+ * never grows to hold it.
7
+ */
8
+ .zx-prose__anchor {
9
+ --zx-prose-anchor-size: calc(var(--zx-control-height) - var(--zx-space-1) - 2px);
10
+ display: inline-grid;
11
+ place-items: center;
12
+ inline-size: var(--zx-prose-anchor-size);
13
+ block-size: var(--zx-prose-anchor-size);
14
+ margin-block: calc((1lh - var(--zx-prose-anchor-size)) / 2);
15
+ margin-inline-start: 0.2em;
16
+ border-radius: var(--zx-radius-sm);
17
+ color: var(--zx-color-text-muted);
18
+ text-decoration: none;
19
+ vertical-align: bottom;
20
+ transition: opacity var(--zx-dur-fast) var(--zx-ease), color var(--zx-dur-fast) var(--zx-ease);
21
+ }
22
+
23
+ .zx-prose__anchor:hover {
24
+ background: var(--zx-color-bg-hover);
25
+ color: var(--zx-color-text);
26
+ }
27
+
28
+ .zx-prose__anchor:focus-visible {
29
+ outline-color: transparent;
30
+ box-shadow: var(--zx-focus-ring);
31
+ }
32
+
33
+ .zx-prose__anchor[data-copied] {
34
+ color: var(--zx-color-success);
35
+ }
36
+
37
+ /* The confirmation is spoken, not drawn: the tick already shows it. */
38
+ .zx-prose__status {
39
+ position: absolute;
40
+ inset-block-start: 0;
41
+ inset-inline-start: 0;
42
+ clip-path: inset(50%);
43
+ inline-size: 1px;
44
+ block-size: 1px;
45
+ overflow: hidden;
46
+ white-space: nowrap;
47
+ }
48
+
49
+ @media print {
50
+ .zx-prose__anchor {
51
+ display: none;
52
+ }
53
+ }
@@ -0,0 +1,152 @@
1
+ import { h } from '../../core/dom.js';
2
+ import { copyToClipboard } from '../../core/export.js';
3
+ import { icon } from '../../core/icons.js';
4
+
5
+ /**
6
+ * @typedef {Object} ProseAnchorsOptions
7
+ * @property {string} [selector='h2[id], h3[id], h4[id]'] The headings that get a link, inside a
8
+ * `.zx-prose` under the root. A heading without an `id` has nothing to link to and is skipped.
9
+ * @property {string} [label='Copy link to %1'] The link's accessible name; `%1` is the heading.
10
+ * @property {string} [title='Copy link'] The link's tooltip.
11
+ * @property {string} [feedback='Link copied'] What the live region says after a copy.
12
+ * @property {number} [feedbackDuration=2000] Milliseconds the tick and the message stay.
13
+ * @property {(id: string) => string} [href] The address copied for a heading id. Defaults to the
14
+ * current address with its hash replaced (`sectionHref(location.href, id)`).
15
+ * @property {(url: string, copied: boolean) => void} [oncopy] Called with the address and whether
16
+ * the clipboard took it.
17
+ */
18
+
19
+ /**
20
+ * @typedef {Object} ProseAnchors
21
+ * @property {() => void} refresh Links headings added since, re-attaches the live region if the
22
+ * content was replaced, and updates the address of every link. Call it after re-rendering.
23
+ * @property {() => void} destroy Removes every link, the live region, and the listener.
24
+ */
25
+
26
+ /** @type {Readonly<Required<Omit<ProseAnchorsOptions, 'href'|'oncopy'>>>} */
27
+ const defaults = Object.freeze({
28
+ selector: 'h2[id], h3[id], h4[id]',
29
+ label: 'Copy link to %1',
30
+ title: 'Copy link',
31
+ feedback: 'Link copied',
32
+ feedbackDuration: 2000
33
+ });
34
+
35
+ /**
36
+ * The address of a section: `base` with its hash replaced by the heading's id. The query is kept,
37
+ * and the id is encoded as a fragment.
38
+ * @param {string} base Absolute address, usually `location.href`.
39
+ * @param {string} id Heading id.
40
+ * @returns {string}
41
+ */
42
+ export function sectionHref(base, id) {
43
+ const url = new URL(String(base));
44
+ url.hash = String(id);
45
+ return url.href;
46
+ }
47
+
48
+ /**
49
+ * Gives every section heading of authored content a link to itself. Each `h2`–`h4` with an `id`
50
+ * inside a `.zx-prose` under `root` ends in a small link (`<a class="zx-prose__anchor" href="#id">`)
51
+ * that rests out of sight and shows while the heading is pointed at or the link has focus. A plain
52
+ * click copies the section's address and confirms in place, without moving the page or touching
53
+ * the location, so an application's own routing is left alone; a middle or modified click is left
54
+ * to the browser, which opens the address.
55
+ *
56
+ * The heading becomes the reveal host (`data-zx-reveal-host`), so the link is always visible on a
57
+ * touch screen and under a contrast preference, and it stays in the Tab order.
58
+ *
59
+ * @param {Element|string} root The content, or an element holding it; a selector is resolved in
60
+ * the document.
61
+ * @param {ProseAnchorsOptions} [options={}] Anchor options.
62
+ * @returns {ProseAnchors}
63
+ */
64
+ export function proseAnchors(root, options = {}) {
65
+ const target = typeof root === 'string' ? document.querySelector(root) : root;
66
+ if (!(target instanceof Element)) throw new TypeError('proseAnchors root could not be resolved');
67
+ const settings = { ...defaults, ...options };
68
+ const abort = new AbortController();
69
+ /** @type {Map<HTMLAnchorElement, HTMLElement>} Link → its heading. */
70
+ const anchors = new Map();
71
+ /** @type {Set<HTMLElement>} Headings this call made reveal hosts. */
72
+ const hosts = new Set();
73
+ const status = h('span', { class: 'zx-prose__status', role: 'status' });
74
+ let timer = 0;
75
+
76
+ const hrefFor = (/** @type {string} */ id) => (typeof settings.href === 'function'
77
+ ? String(settings.href(id))
78
+ : sectionHref(globalThis.location?.href ?? 'about:blank', id));
79
+
80
+ const refresh = () => {
81
+ if (abort.signal.aborted) return;
82
+ for (const [anchor, heading] of anchors) {
83
+ if (anchor.isConnected && heading.contains(anchor) && heading.id) {
84
+ anchor.setAttribute('href', `#${heading.id}`);
85
+ continue;
86
+ }
87
+ anchor.remove();
88
+ anchors.delete(anchor);
89
+ }
90
+ const headings = /** @type {HTMLElement[]} */ ([...target.querySelectorAll(String(settings.selector))]);
91
+ for (const heading of headings) {
92
+ if (!heading.id || !heading.closest('.zx-prose')) continue;
93
+ if ([...anchors.values()].includes(heading)) continue;
94
+ const text = (heading.textContent ?? '').trim();
95
+ const anchor = /** @type {HTMLAnchorElement} */ (h('a', {
96
+ class: 'zx-prose__anchor',
97
+ href: `#${heading.id}`,
98
+ ariaLabel: String(settings.label).replace('%1', text),
99
+ title: String(settings.title),
100
+ 'data-zx-reveal': ''
101
+ }, icon('link-2')));
102
+ if (!heading.hasAttribute('data-zx-reveal-host')) {
103
+ heading.setAttribute('data-zx-reveal-host', '');
104
+ hosts.add(heading);
105
+ }
106
+ heading.append(anchor);
107
+ anchors.set(anchor, heading);
108
+ }
109
+ // The live region sits beside the content, never inside a heading, whose name it would join.
110
+ if (!status.isConnected) target.append(status);
111
+ };
112
+
113
+ target.addEventListener('click', async (event) => {
114
+ const anchor = /** @type {Element} */ (event.target)?.closest?.('.zx-prose__anchor');
115
+ if (!(anchor instanceof HTMLAnchorElement) || !anchors.has(anchor)) return;
116
+ if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;
117
+ event.preventDefault();
118
+ const heading = anchors.get(anchor);
119
+ const url = hrefFor(heading?.id ?? '');
120
+ const copied = await copyToClipboard(url);
121
+ if (abort.signal.aborted) return;
122
+ settings.oncopy?.(url, copied);
123
+ if (!copied) return;
124
+ clearTimeout(timer);
125
+ for (const other of anchors.keys()) delete other.dataset.copied;
126
+ anchor.dataset.copied = 'true';
127
+ anchor.replaceChildren(icon('check'));
128
+ if (!status.isConnected) target.append(status);
129
+ status.textContent = String(settings.feedback);
130
+ timer = setTimeout(() => {
131
+ delete anchor.dataset.copied;
132
+ anchor.replaceChildren(icon('link-2'));
133
+ status.textContent = '';
134
+ }, Math.max(0, Number(settings.feedbackDuration) || 0));
135
+ }, { signal: abort.signal });
136
+
137
+ refresh();
138
+
139
+ return {
140
+ refresh,
141
+ destroy() {
142
+ if (abort.signal.aborted) return;
143
+ abort.abort();
144
+ clearTimeout(timer);
145
+ for (const anchor of anchors.keys()) anchor.remove();
146
+ anchors.clear();
147
+ for (const heading of hosts) heading.removeAttribute('data-zx-reveal-host');
148
+ hosts.clear();
149
+ status.remove();
150
+ }
151
+ };
152
+ }
@@ -223,27 +223,17 @@
223
223
  line-height: 1.45;
224
224
  }
225
225
 
226
- /* The key cap advertises the shortcut. It is `aria-hidden`: a screen-reader user navigates the
227
- group with the arrow keys, and reading "one" before every answer would only be noise. */
226
+ /* The keycap advertises the shortcut (`kbd()`, the one key-hint construction); it is
227
+ `aria-hidden`, since a screen-reader user moves through the group with the arrow keys. A chosen
228
+ answer draws its cap in the accent, through the keycap's own hooks. */
228
229
  .zx-questionnaire__key {
229
- flex: none;
230
- display: grid;
231
- place-items: center;
232
- border: 1px solid var(--zx-color-border);
233
- border-radius: var(--zx-radius-sm);
234
- background: var(--zx-color-bg-muted);
235
- padding-inline: var(--zx-space-2);
236
- min-inline-size: 22px;
237
- block-size: 22px;
238
- color: var(--zx-color-text-muted);
239
- font-family: inherit;
240
- font-size: var(--zx-text-xs);
241
- text-transform: uppercase;
230
+ /* Centred on the label's first line, as the marker is. */
231
+ margin-block-start: calc((var(--zx-control-font-size) * 1.4 - var(--zx-kbd-size)) / 2);
242
232
  }
243
233
 
244
234
  .zx-questionnaire__choice:has(.zx-questionnaire__control:checked) .zx-questionnaire__key {
245
- border-color: var(--zx-color-accent);
246
- color: var(--zx-color-accent);
235
+ --zx-kbd-ink: var(--zx-color-accent);
236
+ --zx-kbd-line: var(--zx-color-accent);
247
237
  }
248
238
 
249
239
  /* -------------------------------------------------------------- freeform */
@@ -5,6 +5,7 @@ import { icon as createIcon } from '../../core/icons.js';
5
5
  import { uid } from '../../core/util.js';
6
6
  import { button } from '../button/button.js';
7
7
  import { Field } from '../field/field.js';
8
+ import { kbd } from '../kbd/kbd.js';
8
9
  import { ProgressBar } from '../loading/progress-bar.js';
9
10
  import {
10
11
  applyExclusive, isEmptyAnswer, normalizeItems, progressOf, resolveFlow, resolveNext, validateAnswer
@@ -61,6 +62,20 @@ const AUTO_ADVANCE_DELAY = 260;
61
62
  /** @typedef {{answers: Record<string, unknown>, path: string[]}} QuestionnaireSubmitDetail */
62
63
  /** @typedef {{answers: Record<string, unknown>, path: string[]}} QuestionnaireCompleteDetail */
63
64
 
65
+ /**
66
+ * The keycap that advertises a choice's shortcut, drawn by `kbd()` like every other key hint. It
67
+ * is `aria-hidden`: a screen-reader user moves through the group with the arrow keys, and hearing
68
+ * the key before every answer would only be noise.
69
+ * @param {string} key The single character that picks the choice.
70
+ * @returns {HTMLElement}
71
+ */
72
+ function keyHint(key) {
73
+ const hint = kbd([key]);
74
+ hint.classList.add('zx-questionnaire__key');
75
+ hint.setAttribute('aria-hidden', 'true');
76
+ return hint;
77
+ }
78
+
64
79
  /**
65
80
  * A guided, one-question-at-a-time flow: onboarding intake, a service-call checklist, an audit
66
81
  * form, a feedback survey. The questionnaire owns the ordered items, the active one, the answers,
@@ -741,7 +756,7 @@ export class Questionnaire extends Component {
741
756
  h('span', { class: 'zx-questionnaire__text' },
742
757
  h('span', { class: 'zx-questionnaire__label' }, choice.label),
743
758
  choice.description ? h('span', { class: 'zx-questionnaire__hint' }, choice.description) : null),
744
- choice.key ? h('kbd', { class: 'zx-questionnaire__key', ariaHidden: 'true' }, choice.key) : null)));
759
+ choice.key ? keyHint(choice.key) : null)));
745
760
 
746
761
  if (item.input) {
747
762
  const inputId = `${this._uid}-freeform`;
@@ -20,9 +20,11 @@
20
20
 
21
21
  /* Both glyphs sit in the same grid cell; the "on" copy is clipped to the filled fraction, which
22
22
  is what makes half steps work without a second icon. */
23
+ /* An empty star is still a mark the value is read from, so it takes the subtle icon role (3:1)
24
+ rather than a border colour. */
23
25
  .zx-rating__glyph {
24
26
  grid-area: 1 / 1;
25
- color: var(--zx-color-border-strong);
27
+ color: var(--zx-color-text-subtle);
26
28
  }
27
29
 
28
30
  .zx-rating__glyph[data-part="on"] {
@@ -1,6 +1,6 @@
1
1
  import { Component } from '../../core/component.js';
2
2
  import { h } from '../../core/dom.js';
3
- import { icon } from '../../core/icons.js';
3
+ import { ICON_SIZE, icon } from '../../core/icons.js';
4
4
 
5
5
  /**
6
6
  * @typedef {Object} SearchOptions
@@ -54,7 +54,7 @@ export class Search extends Component {
54
54
  type: 'button',
55
55
  ariaLabel: clearLabel,
56
56
  title: clearLabel
57
- }, icon('x', { size: 15 })) : null;
57
+ }, icon('x', { size: ICON_SIZE.dismiss })) : null;
58
58
  const submit = h('button', {
59
59
  class: 'zx-search__submit',
60
60
  ref: 'submit',
@@ -1,5 +1,5 @@
1
1
  import { h } from '../../core/dom.js';
2
- import { icon } from '../../core/icons.js';
2
+ import { ICON_SIZE, icon } from '../../core/icons.js';
3
3
 
4
4
  /**
5
5
  * The shapes a workflow-status glyph can take. Each status reads by shape first and colour
@@ -123,8 +123,8 @@ export function statusIcon(status, options = {}) {
123
123
  class: 'zx-status-icon',
124
124
  dataset: { indicator, tone }
125
125
  }));
126
- if (indicator === 'done') marker.append(icon('check', { size: 8 }));
127
- if (indicator === 'canceled') marker.append(icon('x', { size: 7 }));
126
+ if (indicator === 'done') marker.append(icon('check', { size: ICON_SIZE.marker }));
127
+ if (indicator === 'canceled') marker.append(icon('x', { size: ICON_SIZE.marker }));
128
128
  return name(marker, options?.label);
129
129
  }
130
130