@zeyos/zx 5.8.0 → 5.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 (109) hide show
  1. package/CHANGELOG.md +93 -0
  2. package/dist/types/components/block-view/block-view.d.ts +3 -2
  3. package/dist/types/components/check-button/check-button.d.ts +10 -2
  4. package/dist/types/components/checklist/checklist.d.ts +28 -6
  5. package/dist/types/components/code-editor/code-editor.d.ts +19 -1
  6. package/dist/types/components/dock/dock.d.ts +2 -1
  7. package/dist/types/components/dropdown/dropdown.d.ts +2 -1
  8. package/dist/types/components/field-upload/field-upload.d.ts +6 -0
  9. package/dist/types/components/filter-panel/filter-panel.d.ts +6 -2
  10. package/dist/types/components/module-bar/module-bar.d.ts +53 -2
  11. package/dist/types/components/multi-value-editor/multi-value-editor.d.ts +28 -0
  12. package/dist/types/components/run-status/run-status.d.ts +1 -1
  13. package/dist/types/components/run-trace/run-trace.d.ts +8 -0
  14. package/dist/types/components/select/select.d.ts +18 -5
  15. package/dist/types/components/tabbox/tabbox.d.ts +7 -0
  16. package/dist/types/components/tag-picker/tag-picker.d.ts +21 -5
  17. package/dist/types/components/timebox/timebox.d.ts +9 -0
  18. package/dist/types/core/component.d.ts +4 -1
  19. package/dist/types/internal/focus-stops.d.ts +42 -0
  20. package/dist/zx-zeyos.esm.js +296 -97
  21. package/dist/zx-zeyos.esm.min.js +4 -4
  22. package/dist/zx.core.css +13 -6
  23. package/dist/zx.core.min.css +1 -1
  24. package/dist/zx.css +26 -88
  25. package/dist/zx.esm.js +516 -159
  26. package/dist/zx.esm.min.js +26 -26
  27. package/dist/zx.global.js +516 -159
  28. package/dist/zx.global.min.js +26 -26
  29. package/dist/zx.layered.css +26 -88
  30. package/dist/zx.layered.min.css +1 -1
  31. package/dist/zx.min.css +1 -1
  32. package/docs/api.json +97 -9
  33. package/docs/components/approval-card.md +2 -2
  34. package/docs/components/block-view.md +2 -1
  35. package/docs/components/check-button.md +3 -1
  36. package/docs/components/checklist.md +2 -1
  37. package/docs/components/code-editor.md +4 -3
  38. package/docs/components/composer.md +4 -0
  39. package/docs/components/dock.md +4 -1
  40. package/docs/components/dropdown.md +3 -1
  41. package/docs/components/field-upload.md +2 -1
  42. package/docs/components/modal.md +3 -0
  43. package/docs/components/multi-value-editor.md +5 -2
  44. package/docs/components/navigation-bar.md +5 -0
  45. package/docs/components/questionnaire.md +2 -2
  46. package/docs/components/run-status.md +2 -1
  47. package/docs/components/run-trace.md +2 -1
  48. package/docs/components/select.md +6 -2
  49. package/docs/components/tabbox.md +6 -0
  50. package/docs/components/tag-picker.md +3 -1
  51. package/docs/components/timebox.md +2 -1
  52. package/docs/components/tokens.md +20 -0
  53. package/docs/llms.md +84 -21
  54. package/package.json +1 -1
  55. package/src/components/app-sidebar/app-sidebar.js +1 -1
  56. package/src/components/approval-card/approval-card.css +0 -5
  57. package/src/components/approval-card/approval-card.js +2 -0
  58. package/src/components/block-view/block-view.css +0 -10
  59. package/src/components/block-view/block-view.js +11 -6
  60. package/src/components/card/card.css +3 -0
  61. package/src/components/card/card.js +2 -2
  62. package/src/components/card-view/card-view.css +5 -5
  63. package/src/components/card-view/card-view.js +3 -1
  64. package/src/components/check-button/check-button.js +5 -1
  65. package/src/components/checklist/checklist.js +26 -10
  66. package/src/components/checklist/field-adapter.js +5 -13
  67. package/src/components/code-editor/code-editor.js +24 -3
  68. package/src/components/composer/composer.css +15 -26
  69. package/src/components/copy/copy-input.css +3 -1
  70. package/src/components/dialog/dialog.js +2 -1
  71. package/src/components/dock/dock.css +0 -6
  72. package/src/components/dock/dock.js +22 -7
  73. package/src/components/dropdown/dropdown.js +17 -2
  74. package/src/components/field/field.js +2 -1
  75. package/src/components/field-upload/field-upload.js +15 -0
  76. package/src/components/filter-panel/filter-panel.js +8 -11
  77. package/src/components/master-panel/master-panel.js +3 -1
  78. package/src/components/modal/modal.css +2 -11
  79. package/src/components/modal/modal.js +5 -2
  80. package/src/components/module-bar/module-bar.js +110 -26
  81. package/src/components/multi-value-editor/field-adapter.js +8 -23
  82. package/src/components/multi-value-editor/multi-value-editor.js +63 -5
  83. package/src/components/navigation-bar/navigation-bar.css +0 -4
  84. package/src/components/navigation-bar/navigation-bar.js +11 -2
  85. package/src/components/questionnaire/questionnaire.css +0 -14
  86. package/src/components/questionnaire/questionnaire.js +4 -2
  87. package/src/components/run-status/run-status.css +0 -7
  88. package/src/components/run-status/run-status.js +3 -1
  89. package/src/components/run-trace/run-trace.css +0 -5
  90. package/src/components/run-trace/run-trace.js +23 -2
  91. package/src/components/select/select.js +43 -5
  92. package/src/components/skeleton/skeleton.js +16 -3
  93. package/src/components/surface/surface.css +0 -6
  94. package/src/components/surface/surface.js +1 -1
  95. package/src/components/tabbox/tabbox.css +0 -6
  96. package/src/components/tabbox/tabbox.js +20 -2
  97. package/src/components/table/table.js +5 -0
  98. package/src/components/tag-picker/tag-picker.js +35 -6
  99. package/src/components/timebox/timebox.js +17 -1
  100. package/src/components/view-settings/view-settings.js +1 -1
  101. package/src/core/component.js +22 -2
  102. package/src/core/date.js +1 -4
  103. package/src/core/drag-axis.js +22 -6
  104. package/src/internal/focus-stops.js +108 -0
  105. package/src/zeyos/connect.js +7 -3
  106. package/src/zeyos/icons.js +7 -2
  107. package/styles/base.css +27 -3
  108. package/styles/tokens/dark.css +2 -2
  109. package/styles/tokens/semantic.css +2 -2
package/docs/api.json CHANGED
@@ -3551,7 +3551,7 @@
3551
3551
  "name": "label",
3552
3552
  "type": "string|[string, string]",
3553
3553
  "default": "''",
3554
- "description": "A shared label or `[onLabel, offLabel]`.",
3554
+ "description": "A shared label or `[onLabel, offLabel]`. Prefer one label: the button is announced as pressed or not, and the APG toggle-button pattern advises against a name that changes with the state, which a screen reader then reads twice over (\"Disabled, toggle button, not pressed\"). A pair suits a visible state word only where that repetition is acceptable; for an on/off setting a Toggle reads better.",
3555
3555
  "update": {
3556
3556
  "methods": [
3557
3557
  "setLabel()"
@@ -3797,19 +3797,19 @@
3797
3797
  },
3798
3798
  {
3799
3799
  "name": "setValues",
3800
- "signature": "setValues(ids)",
3800
+ "signature": "setValues(ids, [options])",
3801
3801
  "returns": "this",
3802
3802
  "description": "Replaces the checked IDs. IDs that none of the current items carries are kept as requested, and checked as soon as items carrying them arrive — through `setItems()` or the `load` loader — so a value set before the items load is not lost."
3803
3803
  },
3804
3804
  {
3805
3805
  "name": "checkAll",
3806
- "signature": "checkAll()",
3806
+ "signature": "checkAll([options])",
3807
3807
  "returns": "this",
3808
3808
  "description": "Checks every item."
3809
3809
  },
3810
3810
  {
3811
3811
  "name": "uncheckAll",
3812
- "signature": "uncheckAll()",
3812
+ "signature": "uncheckAll([options])",
3813
3813
  "returns": "this",
3814
3814
  "description": "Unchecks every item."
3815
3815
  },
@@ -3833,6 +3833,18 @@
3833
3833
  }
3834
3834
  ]
3835
3835
  },
3836
+ "ChecklistSet": {
3837
+ "options": [
3838
+ {
3839
+ "name": "silent",
3840
+ "type": "boolean",
3841
+ "default": "false",
3842
+ "description": "Update the checked state without emitting `change`."
3843
+ }
3844
+ ],
3845
+ "events": [],
3846
+ "methods": []
3847
+ },
3836
3848
  "CodeEditor": {
3837
3849
  "options": [
3838
3850
  {
@@ -3910,6 +3922,17 @@
3910
3922
  ]
3911
3923
  }
3912
3924
  },
3925
+ {
3926
+ "name": "readonly",
3927
+ "type": "boolean",
3928
+ "default": "false",
3929
+ "description": "The same setting under the spelling every other Zx control uses. The editor starts read-only when either `readOnly` or `readonly` is true, so neither spelling can switch off what the other one turned on.",
3930
+ "update": {
3931
+ "methods": [
3932
+ "setReadonly()"
3933
+ ]
3934
+ }
3935
+ },
3913
3936
  {
3914
3937
  "name": "disabled",
3915
3938
  "type": "boolean",
@@ -3999,7 +4022,13 @@
3999
4022
  "name": "setReadOnly",
4000
4023
  "signature": "setReadOnly(value)",
4001
4024
  "returns": "this",
4002
- "description": ""
4025
+ "description": "Makes the text selectable but not editable, or editable again; reflected as `data-readonly` on the root."
4026
+ },
4027
+ {
4028
+ "name": "setReadonly",
4029
+ "signature": "setReadonly(value)",
4030
+ "returns": "this",
4031
+ "description": "`setReadOnly()` under the spelling every other Zx control uses (`Field#setReadonly()`, `NumberField#setReadonly()`, `TagPicker#setReadonly()`); the two are interchangeable."
4003
4032
  },
4004
4033
  {
4005
4034
  "name": "destroy",
@@ -6408,6 +6437,24 @@
6408
6437
  "returns": "this",
6409
6438
  "description": "Enables or disables file selection and dropping."
6410
6439
  },
6440
+ {
6441
+ "name": "disable",
6442
+ "signature": "disable()",
6443
+ "returns": "this",
6444
+ "description": "Disables file selection and dropping; the same as `setDisabled(true)`."
6445
+ },
6446
+ {
6447
+ "name": "enable",
6448
+ "signature": "enable()",
6449
+ "returns": "this",
6450
+ "description": "Enables file selection and dropping; the same as `setDisabled(false)`."
6451
+ },
6452
+ {
6453
+ "name": "isDisabled",
6454
+ "signature": "isDisabled()",
6455
+ "returns": "boolean",
6456
+ "description": "Whether file selection and dropping are disabled."
6457
+ },
6411
6458
  {
6412
6459
  "name": "destroy",
6413
6460
  "signature": "destroy()",
@@ -9983,6 +10030,17 @@
9983
10030
  "type": "'both'|'buttons'|'drag'|'none'",
9984
10031
  "default": "'both'",
9985
10032
  "description": "Reordering affordances each row gets: a drag handle, the up/down buttons, both, or neither."
10033
+ },
10034
+ {
10035
+ "name": "disabled",
10036
+ "type": "boolean",
10037
+ "default": "false",
10038
+ "description": "Whether every row control (values, handles, move and remove buttons) and the add button are disabled; values can still be set from code.",
10039
+ "update": {
10040
+ "methods": [
10041
+ "setDisabled()"
10042
+ ]
10043
+ }
9986
10044
  }
9987
10045
  ],
9988
10046
  "events": [
@@ -10005,6 +10063,30 @@
10005
10063
  "returns": "this",
10006
10064
  "description": "Replaces all rows."
10007
10065
  },
10066
+ {
10067
+ "name": "setDisabled",
10068
+ "signature": "setDisabled(disabled)",
10069
+ "returns": "this",
10070
+ "description": "Disables or enables the editor. Disabled, every value input or select, drag handle, move and remove button and the add button is disabled, the root carries `aria-disabled=\"true\"`, and neither a pointer nor the handle's keys reorder anything. `setValues()` still works, and rows it renders stay disabled."
10071
+ },
10072
+ {
10073
+ "name": "disable",
10074
+ "signature": "disable()",
10075
+ "returns": "this",
10076
+ "description": "Disables the editor; see `setDisabled()`."
10077
+ },
10078
+ {
10079
+ "name": "enable",
10080
+ "signature": "enable()",
10081
+ "returns": "this",
10082
+ "description": "Enables the editor."
10083
+ },
10084
+ {
10085
+ "name": "isDisabled",
10086
+ "signature": "isDisabled()",
10087
+ "returns": "boolean",
10088
+ "description": "Whether the editor is disabled."
10089
+ },
10008
10090
  {
10009
10091
  "name": "destroy",
10010
10092
  "signature": "destroy()",
@@ -12503,9 +12585,9 @@
12503
12585
  },
12504
12586
  {
12505
12587
  "name": "filter",
12506
- "type": "false|'local'|((query: string) => Promise<SelectItem[]>|SelectItem[])",
12588
+ "type": "false|'local'|SelectFilter",
12507
12589
  "default": "false",
12508
- "description": "Filtering mode.",
12590
+ "description": "Filtering mode: no filtering (a read-only input that opens the list), `'local'` matching against `items`, or a function that returns the items for a query (see `SelectFilter`).",
12509
12591
  "update": {
12510
12592
  "rebuild": true
12511
12593
  }
@@ -15198,9 +15280,9 @@
15198
15280
  },
15199
15281
  {
15200
15282
  "name": "filter",
15201
- "type": "'local'|((query: string) => Promise<TagItem[]>|TagItem[])",
15283
+ "type": "'local'|TagPickerFilter",
15202
15284
  "default": "'local'",
15203
- "description": "Filtering mode."
15285
+ "description": "Filtering mode: `'local'` matches against `items`; a function returns the items for each query (see `TagPickerFilter`)."
15204
15286
  },
15205
15287
  {
15206
15288
  "name": "minQuery",
@@ -15567,6 +15649,12 @@
15567
15649
  "returns": "this",
15568
15650
  "description": "Sets the current duration."
15569
15651
  },
15652
+ {
15653
+ "name": "focus",
15654
+ "signature": "focus()",
15655
+ "returns": "this",
15656
+ "description": "Moves focus to the hours segment, the first one a duration is typed into (the sign toggle of a `signed` timebox sits before it and stays one Shift+Tab away). Focusing selects the segment's digits, as a click into it does. A disabled timebox does not take focus."
15657
+ },
15570
15658
  {
15571
15659
  "name": "enable",
15572
15660
  "signature": "enable()",
@@ -37,8 +37,8 @@ the answer, and the application carries it out.
37
37
  now; closes any of the card's open dialogs), `getStatus()`, `getValues()` (a copy, edits
38
38
  included), `getEditedKeys()` (`[]` when not edited, `null` when every field is listed),
39
39
  `focus()` (the root is `tabindex="-1"`, so a thread can move focus to a request when a run
40
- starts waiting), `handleKey(event)` → `boolean`, and `destroy()` (also destroys the card's
41
- dialogs, including an open confirmation).
40
+ starts waiting; it is a container and draws no focus ring), `handleKey(event)` → `boolean`, and
41
+ `destroy()` (also destroys the card's dialogs, including an open confirmation).
42
42
  - **Update in place** — `update()` is for a request the agent revises while it waits, or a record
43
43
  that changed. It redraws only what changed: values equal to what is drawn (compared by content,
44
44
  so a fresh copy of the same blocks or fields counts as equal) are left alone, and focus stays
@@ -21,7 +21,8 @@ the answer arriving.
21
21
  blank line starts a new paragraph.
22
22
  - **Events** — `cite {n, source}` from a citation button, `artifact {id}` from an artifact card,
23
23
  `end` when a streamed answer is marked finished.
24
- - **Rendering** — code is a figure with its language, a copy button and a focusable `<pre>`
24
+ - **Rendering** — code is a figure with its language, a copy button and a `<pre>` that is a Tab
25
+ stop only while a long line scrolls it
25
26
  (`lines: true` on a code block numbers its lines and wraps long ones under their own indent, for
26
27
  code read at length in an inspector),
27
28
  coloured for js, ts, json, sql, python, shell and css (anything else stays plain); a wide table
@@ -10,7 +10,9 @@ reads as a two-state control. Pressed, the button goes neutral (the `--zx-color-
10
10
  a stronger border, the text colour); only the check glyph, the mark, keeps the accent.
11
11
 
12
12
  - **Options** — `label: '' | [onLabel, offLabel]`, `checked: false`, `icon: true`,
13
- `disabled: false`.
13
+ `disabled: false`. Prefer one label: the pressed state is announced already, and a name that
14
+ changes with it is read twice over, which the APG toggle-button pattern advises against; an
15
+ on/off setting reads better as a Toggle.
14
16
  - **Methods** — `get()`, `set(checked, {silent})`, `toggle()`, `setLabel()`, `enable()`/`disable()`.
15
17
  - **Events** — `change {checked}`, fired only on a real state change.
16
18
  - **Keyboard** — Space/Enter.
@@ -12,7 +12,8 @@ Searchable multi-check list with optional async loading.
12
12
  the heading; the group keeps its text as `aria-label`), `load: async ()=>items`.
13
13
  - **In a Field** — field type `checklist` draws no heading of its own: the field's label names the
14
14
  group (`aria-labelledby`).
15
- - **Methods** — `setItems()`, `getValues()`, `setValues(ids)`, `checkAll()`/`uncheckAll()`,
15
+ - **Methods** — `setItems()`, `getValues()`, `setValues(ids, {silent})`,
16
+ `checkAll({silent})`/`uncheckAll({silent})` (`silent` updates the boxes without a `change`),
16
17
  `search(query)`, `reload()`, `setLabel(text)`, `enable()`/`disable()`, `isDisabled()`. Disabled,
17
18
  the search field and every checkbox are disabled (`aria-disabled="true"` on the group) through
18
19
  searches, `setItems()` and reloads; values can still be set from code.
@@ -12,9 +12,10 @@ stays a separate policy decision.
12
12
  - **Options** — `value`, `name`, `language` (shown to the reader and exposed as data),
13
13
  `label`, `placeholder`, `rows` (clamped 2–100), `indent: '\t'` (inserted by Tab, removed by
14
14
  Shift+Tab; `' '` for two spaces, `''` to leave Tab alone), `wrap: 'off'|'soft'|'hard'`,
15
- `spellcheck`, `readOnly`, `disabled`, `status` (the line/column readout).
16
- - **Methods** — `setValue()`, `getValue()`, `setLanguage()`, `setReadOnly()`,
17
- `enable()`/`disable()`, `getInput()` (the
15
+ `spellcheck`, `readOnly` (also spelled `readonly`, as on every other control; either one set to
16
+ true makes the editor read-only), `disabled`, `status` (the line/column readout).
17
+ - **Methods** — `setValue()`, `getValue()`, `setLanguage()`, `setReadOnly()` (also spelled
18
+ `setReadonly()`), `enable()`/`disable()`, `getInput()` (the
18
19
  native textarea: the element that carries the name, validity and description, and the one a
19
20
  `<label for>` names), `setHighlight(message, kind = 'danger')`, `clearHighlight()`, `focus()`.
20
21
  - **Events** — `input {value}`, `change {value}`, `invalid {message}`.
@@ -94,6 +94,10 @@ the application, which owns the conversation and the transport.
94
94
  - **Files** — the Attach button, pasting files, and dropping files on the composer (the root shows
95
95
  `data-state="dropping"` and a drop label meanwhile) add attachments, filtered by `accept` and
96
96
  capped by `maxFiles`.
97
+ - **Focus** — the box is a tray on the chrome tone; the text inside it is a field with the control
98
+ edge and fill, and it alone draws the focus ring while it is typed into. The box, the chips, the
99
+ queue and the bar never light up; Attach, Commands, the tools and Send ring only when they hold
100
+ the focus themselves.
97
101
  - **Accessibility** — the `<textarea>` keeps its textbox role. While suggestions show it carries
98
102
  `aria-autocomplete="list"`, `aria-controls` (the listbox) and `aria-activedescendant` (the
99
103
  highlighted `role="option"`), and a polite status says how many there are. Attachments and
@@ -48,7 +48,10 @@ detail side of a master–detail screen. Give the root a size of its own (a grid
48
48
  a release that added or removed panes.
49
49
  - **Keyboard and screen readers** — each pane header is a row, not one big button, so the collapse
50
50
  toggle and the tab strip can coexist; the toggle carries `aria-expanded` and `aria-controls`.
51
- Tabs follow the APG tab pattern with one roving tab stop, Left/Right moving between them.
51
+ Tabs follow the APG tab pattern with one roving tab stop, Left/Right moving between them. The
52
+ active panel is a Tab stop itself only while nothing inside it is focusable, with the ring
53
+ inside its edge, so its text can be read and scrolled; a panel holding a control is not. A scrolling pane
54
+ body that the browser makes a Tab stop (nothing focusable inside) rings the same way.
52
55
  Dividers are focusable `separator`s carrying live `aria-valuenow`/`aria-valuemin`/`aria-valuemax`
53
56
  in pixels: Up/Down (or Left/Right when horizontal) resize by 16px, Shift by 64px, and Enter or
54
57
  Space collapses the pane before the divider. A divider with nothing to resize is taken out of the
@@ -28,7 +28,9 @@ DOM child of the anchor's nearest Zx theme scope while the browser lifts it into
28
28
  not opened from it) leaves the panel open; nothing below an open modal reacts at all. A panel
29
29
  opened from inside another overlay closes with that overlay.
30
30
  - **Keyboard** — the panel follows its trigger in the Tab order: Tab on the anchor of an open panel
31
- moves to the panel's first Tab stop, or onto the panel itself when it has a `tabindex`; Tab past
31
+ moves to the panel's first Tab stop, or onto the panel itself when it has a `tabindex` of 0 or
32
+ more (it then shows focus as a region, with the ring inside its edge; a panel only a script
33
+ focuses draws none); Tab past
32
34
  the last stop continues with whatever follows the anchor; Shift+Tab from the first
33
35
  stop returns to the anchor. A Tab stop is what the browser itself stops at: a `tabindex="-1"` part
34
36
  of a composite (a Select's toggle), a roving toolbar's inactive items, disabled, hidden and inert
@@ -13,6 +13,7 @@ Aborted uploads ignore late progress and success callbacks.
13
13
 
14
14
  - **Options** — `url`, `paramName: 'upload'`, `params`, `headers`, `multiple: false`, `accept`,
15
15
  `maxSize`, `autoUpload: true`, `preview: true`, `http`.
16
- - **Methods** — `upload(files?)`, `abort()`, `clear()`, `setDisabled()`.
16
+ - **Methods** — `upload(files?)`, `abort()`, `clear()`, `setDisabled(bool)`,
17
+ `enable()`/`disable()`, `isDisabled()`.
17
18
  - **Events** — `select {files}`, `progress {percent}`, `success {response}`, `error {error}`,
18
19
  `abort`.
@@ -13,6 +13,9 @@ panel material; the backdrop uses `--zx-color-overlay-backdrop`, and focus retur
13
13
  dialog detached until then, rather than parking it on `<body>` outside the theme.
14
14
  - **Methods** — `open()`, `close(result?)`, `setContent()`, `isOpen()`.
15
15
  - **Events** — `open`, `close {result}`, `cancel {reason}`.
16
+ - **Focus** — opening focuses an `autofocus` control, else the first focusable one. A panel with
17
+ nothing focusable takes focus itself (`tabindex="-1"`, outside the Tab order) and draws no focus
18
+ ring, keeping its elevation: the panel is a surface, not a control (`data-zx-focus="container"`).
16
19
  - **Dismissal** — everything the reader does to dismiss an overlay raises `cancel` first, with
17
20
  `reason` `'escape'`, `'close-button'` (Dialog/Sheet header ✕), `'button'` (a footer button whose
18
21
  action is `'cancel'`), `'backdrop'` (`lightDismiss`), `'outside'` or `'drag'` (Sheet).
@@ -8,8 +8,11 @@ Ordered value editor with explicit rows (add / remove / move).
8
8
 
9
9
  - **Options** — `values`, `options` (allowed values, which turns the rows into selects),
10
10
  `addLabel`, `reorder: 'both'` (`'both'` | `'buttons'` | `'drag'` | `'none'` — a drag handle, the
11
- up/down buttons, both, or neither).
12
- - **Methods** — `getValues()`, `setValues()`.
11
+ up/down buttons, both, or neither), `disabled: false`.
12
+ - **Methods** — `getValues()`, `setValues(values, {silent})`, `setDisabled(bool)`,
13
+ `enable()`/`disable()`, `isDisabled()`. Disabled, every value input or select, handle, move and
14
+ remove button and the add button is disabled (`aria-disabled="true"` on the root) and nothing
15
+ reorders; values can still be set from code.
13
16
  - **Events** — `change {values}`.
14
17
  - Dragging goes through a dedicated handle, so text selection inside a row's input still works. The
15
18
  handle is also a keyboard control (Arrow keys, Home, End), which is what keeps `reorder: 'drag'`
@@ -11,6 +11,11 @@ menu on narrow widths.
11
11
  `overflow: true`, `overflowBelow: '44rem'`, `minVisible: 0`.
12
12
  - **Methods** — `setTitle()`, `setItems()`, `setActive()`, `setBadge()`, `setActions()`.
13
13
  - **Events** — `change {name}`.
14
+ - **Panels** — items that all carry `content` (a Node, a Component, or a factory called on first
15
+ selection) make the items an APG tab list with a panel each: ArrowLeft/Right and Home/End move
16
+ focus, Enter/Space select. The active panel is a Tab stop itself only while nothing inside it is
17
+ focusable, with the ring inside its edge, so its text can be read and scrolled; a panel holding a
18
+ control is not, and Tab reaches its first control after the bar's own actions.
14
19
 
15
20
  **Overflow is a default, not a law.** Collapsing every item behind "More" is right for a top app
16
21
  bar and wrong for a phone bottom bar, where the navigation is the point. `overflow: false` keeps
@@ -111,5 +111,5 @@ can be any registered `Field` type, and its validation may be asynchronous.
111
111
  cap on each choice; the caps are `aria-hidden`, since a screen-reader user moves through the
112
112
  group with the arrow keys the radios already provide. `Enter` continues, except in a `multiline`
113
113
  input. Shortcuts are suppressed while focus is in a text control. Navigating moves focus to the
114
- new question's fieldset, which is what gets the prompt announced; failing validation moves it to
115
- the first answer control instead.
114
+ new question's fieldset, which is what gets the prompt announced (it draws no focus ring: it is
115
+ not a control); failing validation moves it to the first answer control instead.
@@ -43,7 +43,8 @@ announces nothing itself; the thread the run belongs to announces its milestones
43
43
  - **Focus** — `update()` keeps focus where it was: an action row whose labels, kinds, and icons did
44
44
  not change is kept as it is, so the focused button never leaves the DOM; otherwise focus goes to
45
45
  the action at the same index, or the nearest one left. When no action is left the panel itself
46
- holds focus (`tabindex="-1"`, removed again once focus moves on).
46
+ holds focus (`tabindex="-1"` with `data-zx-focus="container"`, so no focus ring; both removed
47
+ again once focus moves on).
47
48
  - **Methods** — `update(values)` merges new values and redraws (the clock carries on unless the
48
49
  update brings a new `workMs`; `locale`, `msg`, `now`, and `onaction` are fixed), `getState()`
49
50
  (the values as copies, `tokenBudget` included, `workMs` counted up to now), `destroy()`.
@@ -52,7 +52,8 @@ only when the application calls `setSteps()`, `upsert()` or `setLabel()`.
52
52
  label, icon?, entity?}`) are quiet underlined link buttons under its words, with the glyph when
53
53
  `icon` is set. A step with `args`, `result`, `error` or `detail` is a disclosure holding the tool
54
54
  name (mono), the detail, the arguments (pretty-printed when they parse as JSON, verbatim
55
- otherwise) and the result or the error, each in a focusable `<pre>` with a copy button. A
55
+ otherwise) and the result or the error, each in a `<pre>` with a copy button, a Tab stop while
56
+ its text scrolls. A
56
57
  `handoff` step reads "Finance agent handed over to Collections agent" beside both authors'
57
58
  avatars joined by a dotted line — round for a `person`, a rounded square for an agent or a
58
59
  model, and an agent author with `face` as its still `AgentAvatar` — and its own label moves to
@@ -10,8 +10,12 @@ Unifies single-select, local filtering, and async loading.
10
10
  `labelKey: 'name'` (string or `(item)=>string`), `renderItem`, `renderValue`,
11
11
  `renderValueAdornment`, `renderNone`, `noneLabel`, `actions`, `value`, `disabled`, `placeholder`,
12
12
  `label` (accessible combobox name; defaults to the placeholder or "Select"),
13
- `clearable: false`, `filter: false | 'local' | async (query)=>items`, `searchKeys`,
13
+ `clearable: false`, `filter: false | 'local' | async (query, {signal})=>items`, `searchKeys`,
14
14
  `minQuery: 0`, `debounce: 200`, `listHeight: 280`, `groupKey`.
15
+ - **Async filter** — the function's second argument carries an `AbortSignal` that aborts once the
16
+ answer would be ignored: a newer query starts, the list closes (or the Select is disabled), or the
17
+ Select is destroyed. Pass it on (`fetch(url, { signal })`) to cancel the request; a late result
18
+ is discarded either way.
15
19
  - **Getters** — `.value`, `.selected`.
16
20
  - **Methods** — `get()` (the same as `.value`), `set(id, {silent})`, `setItems()`,
17
21
  `setFixedItems()`, `setActions()`, `reset()`, `open()`/`close()`, `enable()`/`disable()`,
@@ -32,7 +36,7 @@ Unifies single-select, local filtering, and async loading.
32
36
  and accepts replacement `items` (each `{ID, name, indicator, tone, description?, shortcut?}`);
33
37
  `Select.permission(target, {groups, value})` pins Private and
34
38
  Public above record-access groups. Its value is the tri-state ZeyOS stores (`false` private,
35
- `true` public, or a group ID), and `groups` takes an array or loader `(query)=>items`.
39
+ `true` public, or a group ID), and `groups` takes an array or loader `(query, {signal})=>items`.
36
40
  - **Glyphs** — `statusIcon(status, {tone?, indicator?, label?})` and `priorityIcon(level, {label?})`
37
41
  return the exact glyphs the two presets draw (`.zx-status-icon`, `.zx-priority-icon`; inside a
38
42
  Select they also carry `.zx-select__status-indicator` / `.zx-select__priority-icon`), for list
@@ -31,3 +31,9 @@ restores rounded corners without forking the stylesheet.
31
31
  - **Keyboard** — ArrowLeft/Right and Home/End move focus, Enter/Space activate, Delete closes a
32
32
  closable tab. The × is a plain glyph rather than a nested button (buttons cannot nest), so
33
33
  keyboard and screen-reader users close through Delete; focus lands on the neighbouring tab.
34
+ - **Panel focus** — a panel holding a control is not a Tab stop itself, so Tab from the tab list
35
+ reaches the control. A panel with nothing focusable inside is a Tab stop (`tabindex="0"`), drawn
36
+ with the ring inside its edge, so its text can be read and scrolled from the keyboard. This is
37
+ settled whenever a panel is shown and again as Tab leaves the tab list, so content that changes
38
+ inside a panel is taken into account. Controls inside a custom element's shadow root are not
39
+ seen, so a panel whose only controls sit there stays a Tab stop as well.
@@ -12,7 +12,9 @@ yet. Field type: `tagpicker`.
12
12
 
13
13
  - **Options** — `items`, `values: []`, `valueKey: 'ID'`, `labelKey: 'name'`, `iconKey: 'icon'`,
14
14
  `colorKey: 'color'`, `toneKey: 'tone'`, `searchKeys`,
15
- `filter: 'local'|(query)=>Promise<items>`, `minQuery: 0`, `debounce: 200`, `allowCreate: false`,
15
+ `filter: 'local'|(query, {signal})=>Promise<items>` (the signal aborts when a newer query
16
+ starts, the list closes, `setItems()` replaces the catalogue, or the picker is destroyed; a late
17
+ result is discarded either way), `minQuery: 0`, `debounce: 200`, `allowCreate: false`,
16
18
  `max` (maximum tags; further options become `aria-disabled`), `closeOnSelect: false`,
17
19
  `placeholder`, `listHeight: 260`, `disabled`, `readonly`, `renderItem`, `renderTag`.
18
20
  - **Tags are Badges** — every selected tag is built by `badge()` (`.zx-badge.zx-tag-picker__tag`):
@@ -9,7 +9,8 @@ use `TimePicker` or `DateTimeBox`.
9
9
 
10
10
  - **Options** — `value: 0`, `unit: 'minutes'|'seconds'|'hours'`, `seconds: false`, `signed: false`,
11
11
  `disabled`.
12
- - **Methods** — `get(unit)`, `set(value, unit?, {silent})`, `enable()`/`disable()`.
12
+ - **Methods** — `get(unit)`, `set(value, unit?, {silent})`, `focus()` (the hours segment),
13
+ `enable()`/`disable()`.
13
14
  - **Events** — `change {value}`, in `options.unit`.
14
15
  - **Also exported** — the pure helpers `splitTime` and `joinTime`.
15
16
  - **Quiet fields** — inside `[data-zx-fields="quiet"]` the segments (native inputs) and the sign
@@ -80,3 +80,23 @@ stays in the tab order, so focusing it shows it. On touch screens, under `prefer
80
80
  and in forced colours it is always visible. Use it only for repeated, secondary per-row actions
81
81
  that are reachable another way (a context menu, a keyboard shortcut); a primary action stays
82
82
  visible. Hosts do not nest.
83
+
84
+ **Focus targets.** `.zx-scope` draws the focus ring on whatever matches `:focus-visible`, and
85
+ Chrome matches any focused element once a key has been pressed — even Shift — so a click into a
86
+ focusable panel followed by a keystroke would ring the whole panel like a field. An element that
87
+ takes focus without being a control says which kind it is with `data-zx-focus`:
88
+ - `data-zx-focus="container"` — only a script focuses it (`tabindex="-1"`, never a Tab stop): a
89
+ view root that keeps its shortcuts reachable, a heading a route change moves the reader to, a
90
+ panel holding focus after the control in it went away. It draws no ring and no outline, in forced
91
+ colours either; its own box-shadow (an overlay's elevation) stays.
92
+ - `data-zx-focus="region"` — a Tab stop that is not a control: a scroll region the keyboard has to
93
+ reach, a tab panel with nothing inside to operate. Keyboard focus there stays visible as a ring
94
+ inside its edge, drawn as an outline so the region's own content cannot cover it; forced colours
95
+ paint it in the system highlight.
96
+
97
+ Set it when the element is created; it only matters while the element has focus. It works on the
98
+ `.zx-scope` element itself as well as on anything inside it. Zx components
99
+ mark their own: the Modal, Dialog and Sheet panel, a Dropdown panel only a script focuses, the
100
+ ApprovalCard and RunStatus roots, Questionnaire's question and review, Surface's verdict and the
101
+ emptied Table and CardView bodies are containers; tab panels, code blocks, a Dropdown panel with a
102
+ `tabindex` of 0 or more, and the scroll regions of Table, Dock and MasterPanel are regions.