@zeyos/zx 5.6.0 → 5.7.1
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.
- package/CHANGELOG.md +188 -0
- package/README.md +73 -7
- package/bin/zx-css.js +328 -0
- package/dist/types/components/account-menu/account-menu.d.ts +4 -2
- package/dist/types/components/activity-list/activity-list.d.ts +14 -8
- package/dist/types/components/agent-thread/ag-ui.d.ts +340 -0
- package/dist/types/components/agent-thread/agent-thread.d.ts +142 -14
- package/dist/types/components/agent-thread/ui-message-stream.d.ts +401 -0
- package/dist/types/components/app-sidebar/app-sidebar.d.ts +14 -8
- package/dist/types/components/breadcrumb/breadcrumb.d.ts +3 -3
- package/dist/types/components/calendar/calendar-model.d.ts +9 -2
- package/dist/types/components/calendar/calendar.d.ts +12 -4
- package/dist/types/components/chart/chart.d.ts +25 -13
- package/dist/types/components/checklist/checklist.d.ts +29 -0
- package/dist/types/components/code-editor/code-editor.d.ts +7 -2
- package/dist/types/components/composer/composer.d.ts +206 -4
- package/dist/types/components/composer/queue.d.ts +76 -0
- package/dist/types/components/copy/copy-button.d.ts +6 -4
- package/dist/types/components/copy/copy-input.d.ts +10 -6
- package/dist/types/components/datebox/date-range-box.d.ts +33 -0
- package/dist/types/components/datebox/placeholder.d.ts +7 -0
- package/dist/types/components/dialog/dialog.d.ts +2 -2
- package/dist/types/components/dock/dock.d.ts +12 -3
- package/dist/types/components/entity-ref/entity-ref.d.ts +5 -3
- package/dist/types/components/field-upload/field-upload.d.ts +3 -2
- package/dist/types/components/file-item/file-item.d.ts +3 -2
- package/dist/types/components/file-list/file-list.d.ts +14 -8
- package/dist/types/components/filter/filter-model.d.ts +31 -1
- package/dist/types/components/filter/filter.d.ts +20 -2
- package/dist/types/components/finder/finder.d.ts +14 -6
- package/dist/types/components/flag/flag.d.ts +99 -0
- package/dist/types/components/grid/grid.d.ts +1 -1
- package/dist/types/components/kanban-view/kanban-view.d.ts +8 -66
- package/dist/types/components/launcher/launcher.d.ts +2 -0
- package/dist/types/components/modal/modal.d.ts +34 -8
- package/dist/types/components/multi-value-editor/multi-value-editor.d.ts +3 -2
- package/dist/types/components/number-field/number-field.d.ts +41 -7
- package/dist/types/components/prompt-starters/prompt-starters.d.ts +107 -0
- package/dist/types/components/prose/prose.d.ts +9 -6
- package/dist/types/components/questionnaire/conditions.d.ts +270 -0
- package/dist/types/components/questionnaire/items.d.ts +52 -30
- package/dist/types/components/questionnaire/questionnaire.d.ts +44 -4
- package/dist/types/components/rating/rating.d.ts +5 -3
- package/dist/types/components/select/country.d.ts +106 -0
- package/dist/types/components/select/field-adapter.d.ts +2 -1
- package/dist/types/components/select/locale.d.ts +102 -0
- package/dist/types/components/select/select.d.ts +41 -2
- package/dist/types/components/sheet/sheet.d.ts +2 -2
- package/dist/types/components/slider/slider.d.ts +1 -0
- package/dist/types/components/sort-control/sort-control.d.ts +7 -3
- package/dist/types/components/source-list/source-list.d.ts +7 -5
- package/dist/types/components/split-view/split-view.d.ts +5 -3
- package/dist/types/components/surface/catalog.d.ts +260 -0
- package/dist/types/components/surface/elicit.d.ts +81 -0
- package/dist/types/components/surface/mcp.d.ts +165 -0
- package/dist/types/components/surface/schema.d.ts +314 -0
- package/dist/types/components/surface/stream.d.ts +118 -0
- package/dist/types/components/surface/surface.d.ts +718 -0
- package/dist/types/components/surface/text.d.ts +277 -0
- package/dist/types/components/surface/validate.d.ts +339 -0
- package/dist/types/components/table/table.d.ts +55 -3
- package/dist/types/components/table/window.d.ts +203 -0
- package/dist/types/components/toolbar/toolbar.d.ts +10 -6
- package/dist/types/components/tooltip/tooltip.d.ts +2 -2
- package/dist/types/components/tree/tree.d.ts +20 -13
- package/dist/types/core/component.d.ts +10 -0
- package/dist/types/core/date.d.ts +8 -1
- package/dist/types/core/dom.d.ts +15 -0
- package/dist/types/core/http.d.ts +10 -0
- package/dist/types/core/i18n.d.ts +38 -0
- package/dist/types/core/messages.d.ts +344 -1
- package/dist/types/core/storage.d.ts +7 -2
- package/dist/types/elements/define.d.ts +21 -46
- package/dist/types/elements/definitions.d.ts +147 -0
- package/dist/types/elements/kit.d.ts +7 -0
- package/dist/types/elements/reflect.d.ts +6 -3
- package/dist/types/index.d.ts +10 -1
- package/dist/types/internal/date-locale.d.ts +7 -0
- package/dist/types/internal/json-patch.d.ts +146 -0
- package/dist/types/locales/de.d.ts +13 -0
- package/dist/types/locales/en.d.ts +2 -0
- package/dist/types/locales/index.d.ts +823 -0
- package/dist/types/zeyos/view.d.ts +8 -1
- package/dist/zx-zeyos.esm.js +16852 -15131
- package/dist/zx-zeyos.esm.min.js +5 -5
- package/dist/zx.core.css +1276 -0
- package/dist/zx.core.min.css +1 -0
- package/dist/zx.css +520 -143
- package/dist/zx.esm.js +40940 -29684
- package/dist/zx.esm.min.js +36 -23
- package/dist/zx.global.js +40940 -29684
- package/dist/zx.global.min.js +36 -23
- package/dist/zx.layered.css +17315 -0
- package/dist/zx.layered.min.css +1 -0
- package/dist/zx.min.css +1 -1
- package/docs/agent-catalog.json +12501 -0
- package/docs/agent-surfaces.md +340 -0
- package/docs/api.json +909 -137
- package/docs/llms.md +1046 -80
- package/docs/llms.txt +30 -9
- package/package.json +29 -6
- package/src/components/account-menu/account-menu.js +6 -3
- package/src/components/activity-item/activity-item.js +2 -1
- package/src/components/activity-list/activity-list.js +16 -10
- package/src/components/agent-thread/ag-ui.js +1439 -0
- package/src/components/agent-thread/agent-thread.js +359 -54
- package/src/components/agent-thread/ui-message-stream.js +1281 -0
- package/src/components/app-sidebar/app-sidebar.js +18 -8
- package/src/components/approval-card/approval-card.js +3 -2
- package/src/components/block-view/block-view.js +7 -6
- package/src/components/breadcrumb/breadcrumb.js +8 -5
- package/src/components/button/button.css +24 -11
- package/src/components/calendar/calendar-model.js +8 -2
- package/src/components/calendar/calendar.js +53 -18
- package/src/components/chart/chart.js +54 -23
- package/src/components/checklist/checklist.css +9 -1
- package/src/components/checklist/checklist.js +59 -3
- package/src/components/checklist/field-adapter.js +2 -11
- package/src/components/code-editor/code-editor.js +45 -8
- package/src/components/code-editor/field-adapter.js +1 -1
- package/src/components/composer/composer.css +80 -1
- package/src/components/composer/composer.js +390 -16
- package/src/components/composer/queue.js +78 -0
- package/src/components/context-menu/context-menu.js +12 -1
- package/src/components/copy/copy-button.js +9 -7
- package/src/components/copy/copy-input.js +10 -6
- package/src/components/date-picker/date-picker.js +2 -1
- package/src/components/date-picker/date-range-picker.js +8 -7
- package/src/components/datebox/date-range-box.js +3 -9
- package/src/components/datebox/datebox.js +18 -21
- package/src/components/datebox/placeholder.js +18 -0
- package/src/components/dialog/dialog.js +4 -5
- package/src/components/dock/dock.js +34 -13
- package/src/components/entity-ref/entity-ref.js +16 -5
- package/src/components/field-upload/field-upload.js +81 -38
- package/src/components/file-item/file-item.js +70 -40
- package/src/components/file-list/file-list.js +15 -9
- package/src/components/filter/filter-model.js +46 -8
- package/src/components/filter/filter.css +3 -3
- package/src/components/filter/filter.js +29 -10
- package/src/components/filter-panel/filter-panel.js +13 -5
- package/src/components/finder/finder.js +50 -26
- package/src/components/flag/flag.css +40 -0
- package/src/components/flag/flag.js +177 -0
- package/src/components/form/form.js +1 -1
- package/src/components/grid/grid.js +22 -8
- package/src/components/kanban-view/kanban-view.js +51 -81
- package/src/components/launcher/launcher.js +17 -2
- package/src/components/list-toolbar/list-toolbar.js +2 -1
- package/src/components/master-panel/master-panel.js +1 -1
- package/src/components/menu-button/menu-button.js +4 -0
- package/src/components/message/message.js +3 -0
- package/src/components/modal/modal.js +62 -8
- package/src/components/multi-value-editor/multi-value-editor.js +10 -9
- package/src/components/navigation-bar/navigation-bar.js +3 -3
- package/src/components/number-field/number-field.js +98 -29
- package/src/components/prompt-starters/prompt-starters.css +91 -0
- package/src/components/prompt-starters/prompt-starters.js +206 -0
- package/src/components/prose/prose.js +14 -10
- package/src/components/questionnaire/conditions.js +666 -0
- package/src/components/questionnaire/items.js +150 -41
- package/src/components/questionnaire/questionnaire.js +126 -32
- package/src/components/rating/rating.js +5 -4
- package/src/components/run-status/run-status.js +2 -2
- package/src/components/select/country.js +136 -0
- package/src/components/select/field-adapter.js +7 -2
- package/src/components/select/locale.js +219 -0
- package/src/components/select/select.css +20 -22
- package/src/components/select/select.js +94 -12
- package/src/components/sheet/sheet-stack.js +10 -1
- package/src/components/sheet/sheet.js +12 -5
- package/src/components/slider/slider.js +7 -2
- package/src/components/sort-control/sort-control.js +15 -5
- package/src/components/source-list/source-list.js +7 -4
- package/src/components/split-view/split-view.js +5 -3
- package/src/components/surface/catalog.js +1334 -0
- package/src/components/surface/elicit.js +107 -0
- package/src/components/surface/mcp.js +243 -0
- package/src/components/surface/schema.js +644 -0
- package/src/components/surface/stream.js +245 -0
- package/src/components/surface/surface.css +308 -0
- package/src/components/surface/surface.js +2291 -0
- package/src/components/surface/text.js +513 -0
- package/src/components/surface/validate.js +2218 -0
- package/src/components/tabbox/tabbox.js +9 -0
- package/src/components/table/table.css +63 -3
- package/src/components/table/table.js +167 -28
- package/src/components/table/window.js +317 -0
- package/src/components/toolbar/toolbar.js +12 -7
- package/src/components/tooltip/tooltip.css +2 -3
- package/src/components/tooltip/tooltip.js +32 -5
- package/src/components/tree/tree.js +53 -23
- package/src/core/component.js +25 -1
- package/src/core/date.js +62 -16
- package/src/core/dom.js +67 -4
- package/src/core/format.js +15 -13
- package/src/core/http.js +29 -20
- package/src/core/i18n.js +83 -10
- package/src/core/icons.js +13 -2
- package/src/core/keyboard.js +79 -8
- package/src/core/messages.js +376 -2
- package/src/core/overlay-host.js +1 -0
- package/src/core/position.js +3 -2
- package/src/core/storage.js +59 -6
- package/src/elements/define.js +178 -130
- package/src/elements/definitions.js +229 -0
- package/src/elements/kit.js +444 -0
- package/src/elements/reflect.js +8 -3
- package/src/index.js +10 -1
- package/src/internal/date-locale.js +11 -0
- package/src/internal/json-patch.js +405 -0
- package/src/locales/de.js +911 -0
- package/src/locales/en.js +2 -0
- package/src/locales/index.js +7 -0
- package/src/zeyos/calendar.js +2 -1
- package/src/zeyos/form.js +2 -1
- package/src/zeyos/launcher.js +7 -6
- package/src/zeyos/module-bar.js +2 -1
- package/src/zeyos/schema.js +37 -23
- package/src/zeyos/select.js +4 -3
- package/src/zeyos/table.js +2 -13
- package/src/zeyos/view.js +57 -17
- package/styles/core.css +11 -0
- package/styles/tokens/semantic.css +1 -0
- package/styles/zeyos.css +2 -0
- package/styles/zx.css +4 -8
- package/styles/zx.layered.css +1 -0
package/docs/api.json
CHANGED
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
"name": "label",
|
|
24
24
|
"type": "string|null",
|
|
25
25
|
"default": "null",
|
|
26
|
-
"description": "Trigger label;
|
|
26
|
+
"description": "Trigger label; null reads the `accountMenu.labelFor` message (\"Account menu for <name>\"), or `accountMenu.label` without a name."
|
|
27
27
|
},
|
|
28
28
|
{
|
|
29
29
|
"name": "placement",
|
|
@@ -249,9 +249,9 @@
|
|
|
249
249
|
},
|
|
250
250
|
{
|
|
251
251
|
"name": "label",
|
|
252
|
-
"type": "string",
|
|
253
|
-
"default": "
|
|
254
|
-
"description": "Accessible collection name."
|
|
252
|
+
"type": "string|null",
|
|
253
|
+
"default": "null",
|
|
254
|
+
"description": "Accessible collection name; null reads the `activityList.label` message (\"Activity\")."
|
|
255
255
|
},
|
|
256
256
|
{
|
|
257
257
|
"name": "variant",
|
|
@@ -273,15 +273,15 @@
|
|
|
273
273
|
},
|
|
274
274
|
{
|
|
275
275
|
"name": "loadingText",
|
|
276
|
-
"type": "string",
|
|
277
|
-
"default":
|
|
278
|
-
"description": "Loading status text."
|
|
276
|
+
"type": "string|null",
|
|
277
|
+
"default": null,
|
|
278
|
+
"description": "Loading status text, by default the `activityList.loading` message (\"Loading activity\"). Null shows none."
|
|
279
279
|
},
|
|
280
280
|
{
|
|
281
281
|
"name": "emptyText",
|
|
282
282
|
"type": "ActivityListContent",
|
|
283
|
-
"default":
|
|
284
|
-
"description": "Empty-state content."
|
|
283
|
+
"default": null,
|
|
284
|
+
"description": "Empty-state content, by default the `activityList.empty` message (\"No activity yet\"). Null shows none."
|
|
285
285
|
},
|
|
286
286
|
{
|
|
287
287
|
"name": "groupHeadingLevel",
|
|
@@ -360,6 +360,93 @@
|
|
|
360
360
|
}
|
|
361
361
|
]
|
|
362
362
|
},
|
|
363
|
+
"AgUi": {
|
|
364
|
+
"options": [
|
|
365
|
+
{
|
|
366
|
+
"name": "runStatus",
|
|
367
|
+
"type": "{update: (values: Record<string, unknown>) => unknown}|null",
|
|
368
|
+
"default": "null",
|
|
369
|
+
"description": "A RunStatus the run's lifecycle drives: `running` when it starts, `done`, `waiting` (an interrupt, or calls of the run still without a result), `stopped` (cancelled) or `failed`."
|
|
370
|
+
},
|
|
371
|
+
{
|
|
372
|
+
"name": "authors",
|
|
373
|
+
"type": "Record<string, Author>",
|
|
374
|
+
"default": "{}",
|
|
375
|
+
"description": "The thread's authors. A text message whose `name` is one of their keys is written by that author; every other item by `agent`."
|
|
376
|
+
},
|
|
377
|
+
{
|
|
378
|
+
"name": "agent",
|
|
379
|
+
"type": "string|null",
|
|
380
|
+
"default": "null",
|
|
381
|
+
"description": "The author key of the agent's output; the thread's first agent when null."
|
|
382
|
+
},
|
|
383
|
+
{
|
|
384
|
+
"name": "requiresApproval",
|
|
385
|
+
"type": "((call: ToolCall) => unknown)|null",
|
|
386
|
+
"default": "null",
|
|
387
|
+
"description": "Asked once a call's arguments are complete: any truthy answer holds the call at an ApprovalCard until the person decides. Nothing is approved by default: a check that throws holds the call too, and so does a Promise, whatever it resolves to, so an asynchronous check never lets a call through. Not asked for surface tools, whose surface is the person's say."
|
|
388
|
+
},
|
|
389
|
+
{
|
|
390
|
+
"name": "showReasoning",
|
|
391
|
+
"type": "boolean",
|
|
392
|
+
"default": "false",
|
|
393
|
+
"description": "Show the reasoning text in its trace step. Without it, reasoning is one collapsed \"Thought for 12 s\" step."
|
|
394
|
+
},
|
|
395
|
+
{
|
|
396
|
+
"name": "surfaceEvent",
|
|
397
|
+
"type": "string",
|
|
398
|
+
"default": "'zx.surface'",
|
|
399
|
+
"description": "The name of the custom event that carries surface operations: its `value` is one operation, or `{ops: [...], token?}`. The token of the event that opens a surface is kept; later ones are ignored. Give these surfaces ids a model cannot predict: a surface belongs to the source that opened it, and a `begin` for an id the model already took is refused."
|
|
400
|
+
},
|
|
401
|
+
{
|
|
402
|
+
"name": "tools",
|
|
403
|
+
"type": "Record<string, ToolTileRenderer>",
|
|
404
|
+
"default": "{}",
|
|
405
|
+
"description": "The tools whose calls the application draws itself, by name. The renderer is called at each status change of the call, never while its arguments stream; its first item that is not `null` is inserted after the call's step, later ones replace it where it stands, and the step links to it."
|
|
406
|
+
},
|
|
407
|
+
{
|
|
408
|
+
"name": "surfaceTools",
|
|
409
|
+
"type": "string[]",
|
|
410
|
+
"default": "['show_surface','ask_user']",
|
|
411
|
+
"description": "The tools whose arguments are a whole surface document. The surface is drawn once the arguments are complete, and its reply is the call's result."
|
|
412
|
+
},
|
|
413
|
+
{
|
|
414
|
+
"name": "inlineSurfaces",
|
|
415
|
+
"type": "boolean",
|
|
416
|
+
"default": "false",
|
|
417
|
+
"description": "Split surface fences out of answer text."
|
|
418
|
+
},
|
|
419
|
+
{
|
|
420
|
+
"name": "catalog",
|
|
421
|
+
"type": "SurfaceCatalog",
|
|
422
|
+
"default": null,
|
|
423
|
+
"description": "A narrowed catalog, given to every surface the adapter creates."
|
|
424
|
+
}
|
|
425
|
+
],
|
|
426
|
+
"events": [
|
|
427
|
+
{
|
|
428
|
+
"name": "toolresult",
|
|
429
|
+
"payload": null,
|
|
430
|
+
"description": "What the person decided, for the application to send back to the agent. An approval answers `{approved: true}` or `{approved: false, reason?}`; a surface tool its reply, with `errors` when the surface had any; a `show` surface with no actions answers at once with `{shown: true, surface, errors?}` and stays on screen; a surface tool whose arguments are not a surface answers at once with `{error: 'invalid-arguments'}`, and one the thread cannot draw with `{error: 'surface-unavailable'}`. It fires once for a call. In AG-UI 1.0 the application turns it into a `resume` entry (`{interruptId, status: 'resolved', payload}`) when the run ended with an interrupt for the call, or into a tool message (`{role: 'tool', toolCallId, content}`) when it ended with the call among its `pendingToolCallIds`; either goes in the next run's input."
|
|
431
|
+
},
|
|
432
|
+
{
|
|
433
|
+
"name": "state",
|
|
434
|
+
"payload": null,
|
|
435
|
+
"description": "The application state after each snapshot or delta."
|
|
436
|
+
},
|
|
437
|
+
{
|
|
438
|
+
"name": "unknown",
|
|
439
|
+
"payload": null,
|
|
440
|
+
"description": "Every event the adapter does not draw: unknown types, and known ones without a place in the thread (steps, message snapshots, activities, raw and encrypted values, subagents, custom events of another name)."
|
|
441
|
+
},
|
|
442
|
+
{
|
|
443
|
+
"name": "error",
|
|
444
|
+
"payload": null,
|
|
445
|
+
"description": "Problems found in the stream."
|
|
446
|
+
}
|
|
447
|
+
],
|
|
448
|
+
"methods": []
|
|
449
|
+
},
|
|
363
450
|
"AgentThread": {
|
|
364
451
|
"options": [
|
|
365
452
|
{
|
|
@@ -458,6 +545,12 @@
|
|
|
458
545
|
"default": null,
|
|
459
546
|
"description": "Locale for times."
|
|
460
547
|
},
|
|
548
|
+
{
|
|
549
|
+
"name": "surfaceOptions",
|
|
550
|
+
"type": "Omit<SurfaceOptions, 'document'|'token'|'catalog'|'reply'>",
|
|
551
|
+
"default": "{}",
|
|
552
|
+
"description": "Options handed to every Surface the thread draws: the application's `policy`, `resolve`, `chartAdapter` and `msg`. Its authors, heading level and locale are the thread's unless given here."
|
|
553
|
+
},
|
|
461
554
|
{
|
|
462
555
|
"name": "msg",
|
|
463
556
|
"type": "Record<string, string>|Record<string, Record<string, string>>",
|
|
@@ -471,6 +564,11 @@
|
|
|
471
564
|
"payload": "{item: ThreadItem, action: string, value?: unknown}",
|
|
472
565
|
"description": "Answer action listener."
|
|
473
566
|
},
|
|
567
|
+
{
|
|
568
|
+
"name": "reply",
|
|
569
|
+
"payload": "{item: ThreadItem, reply: SurfaceReply}",
|
|
570
|
+
"description": "Surface reply listener."
|
|
571
|
+
},
|
|
474
572
|
{
|
|
475
573
|
"name": "approve",
|
|
476
574
|
"payload": "{item: ThreadItem, values: Record<string, unknown>}",
|
|
@@ -512,31 +610,31 @@
|
|
|
512
610
|
"name": "register",
|
|
513
611
|
"signature": "register(type, render)",
|
|
514
612
|
"returns": "typeof AgentThread",
|
|
515
|
-
"description": "Registers how items of another type are drawn
|
|
613
|
+
"description": "Registers how items of another type are drawn. An application's own renderer for `surface` replaces the library's drawing of that type; the types the library always draws cannot be replaced."
|
|
516
614
|
},
|
|
517
615
|
{
|
|
518
616
|
"name": "has",
|
|
519
617
|
"signature": "has(type)",
|
|
520
618
|
"returns": "boolean",
|
|
521
|
-
"description": "Reports whether a type has a registered renderer."
|
|
619
|
+
"description": "Reports whether a type has a registered renderer. `surface` answers false until an application registers its own, so a guarded `register()` still takes effect."
|
|
522
620
|
},
|
|
523
621
|
{
|
|
524
622
|
"name": "setItems",
|
|
525
623
|
"signature": "setItems(items)",
|
|
526
624
|
"returns": "this",
|
|
527
|
-
"description": "Replaces the conversation."
|
|
625
|
+
"description": "Replaces the conversation. Everything is dropped and then drawn anew, except a surface already drawn, which stays so that one still matching keeps answering."
|
|
528
626
|
},
|
|
529
627
|
{
|
|
530
628
|
"name": "upsert",
|
|
531
|
-
"signature": "upsert(item)",
|
|
629
|
+
"signature": "upsert(item, [options])",
|
|
532
630
|
"returns": "this",
|
|
533
|
-
"description": "Adds an item, or replaces the item with the same id where it stands."
|
|
631
|
+
"description": "Adds an item, or replaces the item with the same id where it stands. A new item goes at the end, or right after the item `options.after` names."
|
|
534
632
|
},
|
|
535
633
|
{
|
|
536
634
|
"name": "patch",
|
|
537
635
|
"signature": "patch(id, partial)",
|
|
538
636
|
"returns": "this",
|
|
539
|
-
"description": "Changes part of an item. The common changes are made in place — an answer finishing or
|
|
637
|
+
"description": "Changes part of an item. The common changes are made in place — an answer finishing, stopping or writing on, a trace's steps, an approval's status — so what the reader opened, and focus and selection where the blocks stay, survive; anything else redraws the item. Metadata patches retain an answer's live blocks; explicit `blocks` or `versions` remain authoritative."
|
|
540
638
|
},
|
|
541
639
|
{
|
|
542
640
|
"name": "appendText",
|
|
@@ -560,7 +658,7 @@
|
|
|
560
658
|
"name": "remove",
|
|
561
659
|
"signature": "remove(id)",
|
|
562
660
|
"returns": "this",
|
|
563
|
-
"description": "Removes an item."
|
|
661
|
+
"description": "Removes an item. Focus inside it moves to the item above, or the one below when it was the first, so that a keyboard user is not thrown back to the top of the page."
|
|
564
662
|
},
|
|
565
663
|
{
|
|
566
664
|
"name": "get",
|
|
@@ -574,11 +672,17 @@
|
|
|
574
672
|
"returns": "Component|null",
|
|
575
673
|
"description": "The main component drawn for an item: an answer's BlockView, a trace's RunTrace, an approval's ApprovalCard."
|
|
576
674
|
},
|
|
675
|
+
{
|
|
676
|
+
"name": "surface",
|
|
677
|
+
"signature": "surface(id)",
|
|
678
|
+
"returns": "Surface|null",
|
|
679
|
+
"description": "The Surface drawn for a `surface` item, to stream its operations into with `apply()` or `write()`."
|
|
680
|
+
},
|
|
577
681
|
{
|
|
578
682
|
"name": "reveal",
|
|
579
683
|
"signature": "reveal(target)",
|
|
580
684
|
"returns": "boolean",
|
|
581
|
-
"description": "Brings something into view and moves focus to it: `item:<id>` an item, `step:<id>` a trace step (in whichever trace holds it), `source:<n>` a source of the latest answer that has one
|
|
685
|
+
"description": "Brings something into view and moves focus to it: `item:<id>` an item, `step:<id>` a trace step (in whichever trace holds it), `source:<n>` a source of the latest answer that has one, `source:<n>:<id>` a source in the list of the answer `id`."
|
|
582
686
|
},
|
|
583
687
|
{
|
|
584
688
|
"name": "setArtifactState",
|
|
@@ -785,15 +889,15 @@
|
|
|
785
889
|
},
|
|
786
890
|
{
|
|
787
891
|
"name": "label",
|
|
788
|
-
"type": "string",
|
|
789
|
-
"default":
|
|
790
|
-
"description": "Navigation accessible label."
|
|
892
|
+
"type": "string|null",
|
|
893
|
+
"default": null,
|
|
894
|
+
"description": "Navigation accessible label, by default the `appSidebar.label` message (\"Applications\"). Null leaves the navigation unnamed."
|
|
791
895
|
},
|
|
792
896
|
{
|
|
793
897
|
"name": "moreLabel",
|
|
794
|
-
"type": "string",
|
|
795
|
-
"default": "
|
|
796
|
-
"description": "Name of a destination's overflow menu when its `actions` fold; every action name is followed by the destination's label."
|
|
898
|
+
"type": "string|null",
|
|
899
|
+
"default": "null",
|
|
900
|
+
"description": "Name of a destination's overflow menu when its `actions` fold; every action name is followed by the destination's label. Null reads the `appSidebar.more` message (\"More actions\")."
|
|
797
901
|
},
|
|
798
902
|
{
|
|
799
903
|
"name": "header",
|
|
@@ -1810,7 +1914,7 @@
|
|
|
1810
1914
|
"name": "locale",
|
|
1811
1915
|
"type": "string|string[]",
|
|
1812
1916
|
"default": null,
|
|
1813
|
-
"description": "Intl locale override."
|
|
1917
|
+
"description": "Intl locale override. Unset, dates follow `setLanguage()`, and the browser's language under an English one."
|
|
1814
1918
|
},
|
|
1815
1919
|
{
|
|
1816
1920
|
"name": "weekStart",
|
|
@@ -2193,6 +2297,12 @@
|
|
|
2193
2297
|
"type": "'milliseconds'|'seconds'",
|
|
2194
2298
|
"default": "'milliseconds'",
|
|
2195
2299
|
"description": "Unit used for numeric dates."
|
|
2300
|
+
},
|
|
2301
|
+
{
|
|
2302
|
+
"name": "untitledTitle",
|
|
2303
|
+
"type": "string",
|
|
2304
|
+
"default": null,
|
|
2305
|
+
"description": "Title of an event without one, by default the `calendar.untitled` message (\"Untitled event\")."
|
|
2196
2306
|
}
|
|
2197
2307
|
],
|
|
2198
2308
|
"events": [],
|
|
@@ -2557,9 +2667,9 @@
|
|
|
2557
2667
|
},
|
|
2558
2668
|
{
|
|
2559
2669
|
"name": "label",
|
|
2560
|
-
"type": "string",
|
|
2561
|
-
"default": "
|
|
2562
|
-
"description": "Accessible canvas and summary label; blank text
|
|
2670
|
+
"type": "string|null",
|
|
2671
|
+
"default": "null",
|
|
2672
|
+
"description": "Accessible canvas and summary label; null or blank text reads the `chart.label` message (\"Chart\")."
|
|
2563
2673
|
},
|
|
2564
2674
|
{
|
|
2565
2675
|
"name": "description",
|
|
@@ -2581,21 +2691,21 @@
|
|
|
2581
2691
|
},
|
|
2582
2692
|
{
|
|
2583
2693
|
"name": "emptyText",
|
|
2584
|
-
"type": "string",
|
|
2585
|
-
"default":
|
|
2586
|
-
"description": "Empty-state text."
|
|
2694
|
+
"type": "string|null",
|
|
2695
|
+
"default": null,
|
|
2696
|
+
"description": "Empty-state text, by default the `chart.empty` message (\"No chart data\"). Null shows none."
|
|
2587
2697
|
},
|
|
2588
2698
|
{
|
|
2589
2699
|
"name": "loadingText",
|
|
2590
|
-
"type": "string",
|
|
2591
|
-
"default":
|
|
2592
|
-
"description": "Loading-state text."
|
|
2700
|
+
"type": "string|null",
|
|
2701
|
+
"default": null,
|
|
2702
|
+
"description": "Loading-state text, by default the `chart.loading` message (\"Loading chart…\"). Null shows none."
|
|
2593
2703
|
},
|
|
2594
2704
|
{
|
|
2595
2705
|
"name": "errorText",
|
|
2596
|
-
"type": "string",
|
|
2597
|
-
"default":
|
|
2598
|
-
"description": "Error fallback text."
|
|
2706
|
+
"type": "string|null",
|
|
2707
|
+
"default": null,
|
|
2708
|
+
"description": "Error fallback text, by default the `chart.error` message (\"Unable to render chart\"). Null shows none."
|
|
2599
2709
|
},
|
|
2600
2710
|
{
|
|
2601
2711
|
"name": "aspectRatio",
|
|
@@ -2824,6 +2934,18 @@
|
|
|
2824
2934
|
"default": "false",
|
|
2825
2935
|
"description": "Fallback initial checked state."
|
|
2826
2936
|
},
|
|
2937
|
+
{
|
|
2938
|
+
"name": "label",
|
|
2939
|
+
"type": "string|null",
|
|
2940
|
+
"default": "null",
|
|
2941
|
+
"description": "Heading text, which is also the group's accessible name; null uses the `checklist.label` message."
|
|
2942
|
+
},
|
|
2943
|
+
{
|
|
2944
|
+
"name": "disabled",
|
|
2945
|
+
"type": "boolean",
|
|
2946
|
+
"default": "false",
|
|
2947
|
+
"description": "Whether the search field and every checkbox are disabled."
|
|
2948
|
+
},
|
|
2827
2949
|
{
|
|
2828
2950
|
"name": "hideLabel",
|
|
2829
2951
|
"type": "boolean",
|
|
@@ -2862,6 +2984,30 @@
|
|
|
2862
2984
|
"returns": "this",
|
|
2863
2985
|
"description": "Replaces items and derives checked state from `checkedKey` and `defaultChecked`."
|
|
2864
2986
|
},
|
|
2987
|
+
{
|
|
2988
|
+
"name": "setLabel",
|
|
2989
|
+
"signature": "setLabel(label)",
|
|
2990
|
+
"returns": "this",
|
|
2991
|
+
"description": "Replaces the heading text, which is also the group's accessible name."
|
|
2992
|
+
},
|
|
2993
|
+
{
|
|
2994
|
+
"name": "enable",
|
|
2995
|
+
"signature": "enable()",
|
|
2996
|
+
"returns": "this",
|
|
2997
|
+
"description": "Enables the search field and the checkboxes."
|
|
2998
|
+
},
|
|
2999
|
+
{
|
|
3000
|
+
"name": "disable",
|
|
3001
|
+
"signature": "disable()",
|
|
3002
|
+
"returns": "this",
|
|
3003
|
+
"description": "Disables the search field and the checkboxes; values can still be set programmatically."
|
|
3004
|
+
},
|
|
3005
|
+
{
|
|
3006
|
+
"name": "isDisabled",
|
|
3007
|
+
"signature": "isDisabled()",
|
|
3008
|
+
"returns": "boolean",
|
|
3009
|
+
"description": "Whether the checklist is disabled."
|
|
3010
|
+
},
|
|
2865
3011
|
{
|
|
2866
3012
|
"name": "getValues",
|
|
2867
3013
|
"signature": "getValues()",
|
|
@@ -2928,9 +3074,9 @@
|
|
|
2928
3074
|
},
|
|
2929
3075
|
{
|
|
2930
3076
|
"name": "label",
|
|
2931
|
-
"type": "string",
|
|
2932
|
-
"default": "
|
|
2933
|
-
"description": "Accessible editor label."
|
|
3077
|
+
"type": "string|null",
|
|
3078
|
+
"default": "null",
|
|
3079
|
+
"description": "Accessible editor label; null reads the `codeEditor.label` message (\"Code editor\")."
|
|
2934
3080
|
},
|
|
2935
3081
|
{
|
|
2936
3082
|
"name": "placeholder",
|
|
@@ -3034,6 +3180,18 @@
|
|
|
3034
3180
|
"default": "false",
|
|
3035
3181
|
"description": "Whether an agent is working: Send becomes Stop."
|
|
3036
3182
|
},
|
|
3183
|
+
{
|
|
3184
|
+
"name": "queue",
|
|
3185
|
+
"type": "boolean",
|
|
3186
|
+
"default": "false",
|
|
3187
|
+
"description": "Whether the send key holds a message back while the agent works. It is sent when the agent is no longer busy, one message each time busy ends, in order. The queue lives as long as the composer: it is not kept with the draft."
|
|
3188
|
+
},
|
|
3189
|
+
{
|
|
3190
|
+
"name": "queueLimit",
|
|
3191
|
+
"type": "number",
|
|
3192
|
+
"default": "10",
|
|
3193
|
+
"description": "Most messages that wait at once. At the limit the send key is refused, and the hint says why."
|
|
3194
|
+
},
|
|
3037
3195
|
{
|
|
3038
3196
|
"name": "disabled",
|
|
3039
3197
|
"type": "boolean",
|
|
@@ -3134,7 +3292,7 @@
|
|
|
3134
3292
|
"events": [
|
|
3135
3293
|
{
|
|
3136
3294
|
"name": "send",
|
|
3137
|
-
"payload": "{text, files, mentions, context}",
|
|
3295
|
+
"payload": "{text, files, mentions, context, queued}",
|
|
3138
3296
|
"description": "Preventable send listener."
|
|
3139
3297
|
},
|
|
3140
3298
|
{
|
|
@@ -3172,6 +3330,16 @@
|
|
|
3172
3330
|
"payload": "{id, tool}",
|
|
3173
3331
|
"description": "Tool listener."
|
|
3174
3332
|
},
|
|
3333
|
+
{
|
|
3334
|
+
"name": "queue",
|
|
3335
|
+
"payload": "{item, items}",
|
|
3336
|
+
"description": "Listener for a message being queued."
|
|
3337
|
+
},
|
|
3338
|
+
{
|
|
3339
|
+
"name": "dequeue",
|
|
3340
|
+
"payload": "{item, items, reason}",
|
|
3341
|
+
"description": "Listener for a message leaving the queue."
|
|
3342
|
+
},
|
|
3175
3343
|
{
|
|
3176
3344
|
"name": "historyprevious",
|
|
3177
3345
|
"payload": "Record<string, never>",
|
|
@@ -3207,7 +3375,7 @@
|
|
|
3207
3375
|
"name": "setBusy",
|
|
3208
3376
|
"signature": "setBusy(busy)",
|
|
3209
3377
|
"returns": "this",
|
|
3210
|
-
"description": "Shows Stop in place of Send while an agent works; Escape in the text then emits `stop`."
|
|
3378
|
+
"description": "Shows Stop in place of Send while an agent works; Escape in the text then emits `stop`. When busy ends, the first queued message is sent; the next waits for the next time it ends."
|
|
3211
3379
|
},
|
|
3212
3380
|
{
|
|
3213
3381
|
"name": "setHint",
|
|
@@ -3263,11 +3431,23 @@
|
|
|
3263
3431
|
"returns": "this",
|
|
3264
3432
|
"description": "Removes a context chip. Emits nothing."
|
|
3265
3433
|
},
|
|
3434
|
+
{
|
|
3435
|
+
"name": "clearQueue",
|
|
3436
|
+
"signature": "clearQueue()",
|
|
3437
|
+
"returns": "this",
|
|
3438
|
+
"description": "Removes every queued message. Emits `dequeue` for each, with `reason: 'cleared'`. Stop does not do this: call it from a `stop` listener to drop what was waiting along with the run."
|
|
3439
|
+
},
|
|
3440
|
+
{
|
|
3441
|
+
"name": "removeQueued",
|
|
3442
|
+
"signature": "removeQueued(id)",
|
|
3443
|
+
"returns": "this",
|
|
3444
|
+
"description": "Removes one queued message. Emits `dequeue` with `reason: 'removed'`. An id that is not queued, because the message has been sent, say, changes nothing."
|
|
3445
|
+
},
|
|
3266
3446
|
{
|
|
3267
3447
|
"name": "destroy",
|
|
3268
3448
|
"signature": "destroy()",
|
|
3269
3449
|
"returns": "void",
|
|
3270
|
-
"description": "Removes what the composer drew and the launcher it opened, and stops listening."
|
|
3450
|
+
"description": "Removes what the composer drew and the launcher it opened, drops the queue, and stops listening."
|
|
3271
3451
|
}
|
|
3272
3452
|
]
|
|
3273
3453
|
},
|
|
@@ -3406,15 +3586,15 @@
|
|
|
3406
3586
|
},
|
|
3407
3587
|
{
|
|
3408
3588
|
"name": "title",
|
|
3409
|
-
"type": "string",
|
|
3410
|
-
"default":
|
|
3411
|
-
"description": "Accessible name, and the native tooltip on the icon-only form."
|
|
3589
|
+
"type": "string|null",
|
|
3590
|
+
"default": null,
|
|
3591
|
+
"description": "Accessible name, and the native tooltip on the icon-only form; by default the `copy.copy` message (\"Copy\"). Null gives none."
|
|
3412
3592
|
},
|
|
3413
3593
|
{
|
|
3414
3594
|
"name": "feedback",
|
|
3415
|
-
"type": "string",
|
|
3416
|
-
"default":
|
|
3417
|
-
"description": "Confirmation announced and shown after a copy."
|
|
3595
|
+
"type": "string|null",
|
|
3596
|
+
"default": null,
|
|
3597
|
+
"description": "Confirmation announced and shown after a copy; by default the `copy.copied` message (\"Copied\"). Null says nothing."
|
|
3418
3598
|
},
|
|
3419
3599
|
{
|
|
3420
3600
|
"name": "feedbackDuration",
|
|
@@ -3466,15 +3646,15 @@
|
|
|
3466
3646
|
},
|
|
3467
3647
|
{
|
|
3468
3648
|
"name": "feedback",
|
|
3469
|
-
"type": "string",
|
|
3470
|
-
"default":
|
|
3471
|
-
"description": "Confirmation shown after a copy."
|
|
3649
|
+
"type": "string|null",
|
|
3650
|
+
"default": null,
|
|
3651
|
+
"description": "Confirmation shown after a copy, by default the `copy.copied` message (\"Copied\"). Null says nothing."
|
|
3472
3652
|
},
|
|
3473
3653
|
{
|
|
3474
3654
|
"name": "buttonTitle",
|
|
3475
|
-
"type": "string",
|
|
3476
|
-
"default":
|
|
3477
|
-
"description": "Accessible name of the copy button."
|
|
3655
|
+
"type": "string|null",
|
|
3656
|
+
"default": null,
|
|
3657
|
+
"description": "Accessible name of the copy button, by default the `copy.copy` message (\"Copy\"). Null gives none."
|
|
3478
3658
|
},
|
|
3479
3659
|
{
|
|
3480
3660
|
"name": "size",
|
|
@@ -3517,6 +3697,60 @@
|
|
|
3517
3697
|
}
|
|
3518
3698
|
]
|
|
3519
3699
|
},
|
|
3700
|
+
"CountrySelect": {
|
|
3701
|
+
"options": [
|
|
3702
|
+
{
|
|
3703
|
+
"name": "countries",
|
|
3704
|
+
"type": "Array<string|CountryItem>",
|
|
3705
|
+
"default": null,
|
|
3706
|
+
"description": "The countries to offer. Without it, every ISO 3166-1 country (`COUNTRY_CODES`). A code that is not two letters is left out."
|
|
3707
|
+
},
|
|
3708
|
+
{
|
|
3709
|
+
"name": "preferred",
|
|
3710
|
+
"type": "Array<string|CountryItem>",
|
|
3711
|
+
"default": "[]",
|
|
3712
|
+
"description": "Countries pinned above the list, in the order given and kept through filtering — the markets an application serves, say."
|
|
3713
|
+
},
|
|
3714
|
+
{
|
|
3715
|
+
"name": "preferredLabel",
|
|
3716
|
+
"type": "string|null",
|
|
3717
|
+
"default": "null",
|
|
3718
|
+
"description": "Heading above the pinned countries."
|
|
3719
|
+
},
|
|
3720
|
+
{
|
|
3721
|
+
"name": "displayLocale",
|
|
3722
|
+
"type": "string|null",
|
|
3723
|
+
"default": "null",
|
|
3724
|
+
"description": "The language country names are written in. By default the component's `lang` option, then the library language (`setLanguage()`)."
|
|
3725
|
+
},
|
|
3726
|
+
{
|
|
3727
|
+
"name": "flags",
|
|
3728
|
+
"type": "FlagMode",
|
|
3729
|
+
"default": "'auto'",
|
|
3730
|
+
"description": "What stands before each country: its flag (`auto` draws flag emoji where the platform has them and a code chip where it does not; `emoji` forces the emoji), the code chip (`code`), nothing (`none`), or a function returning the content."
|
|
3731
|
+
},
|
|
3732
|
+
{
|
|
3733
|
+
"name": "flagUrl",
|
|
3734
|
+
"type": "string|null",
|
|
3735
|
+
"default": "null",
|
|
3736
|
+
"description": "Flag image URL template, such as `'/flags/{code}.svg'`; `{code}` is the lower-case code, `{CODE}` the upper-case. Draws flags from the application's own flag set instead of emoji."
|
|
3737
|
+
},
|
|
3738
|
+
{
|
|
3739
|
+
"name": "showCode",
|
|
3740
|
+
"type": "boolean",
|
|
3741
|
+
"default": "false",
|
|
3742
|
+
"description": "Shows the ISO code as secondary text."
|
|
3743
|
+
},
|
|
3744
|
+
{
|
|
3745
|
+
"name": "sort",
|
|
3746
|
+
"type": "boolean",
|
|
3747
|
+
"default": "true",
|
|
3748
|
+
"description": "Orders the countries by name in the display language; `false` keeps the order given."
|
|
3749
|
+
}
|
|
3750
|
+
],
|
|
3751
|
+
"events": [],
|
|
3752
|
+
"methods": []
|
|
3753
|
+
},
|
|
3520
3754
|
"DataFilter": {
|
|
3521
3755
|
"options": [
|
|
3522
3756
|
{
|
|
@@ -4159,7 +4393,7 @@
|
|
|
4159
4393
|
},
|
|
4160
4394
|
{
|
|
4161
4395
|
"name": "cancel",
|
|
4162
|
-
"payload": "
|
|
4396
|
+
"payload": "import('../modal/modal.js').ModalCancelDetail",
|
|
4163
4397
|
"description": "Cancel event listener."
|
|
4164
4398
|
}
|
|
4165
4399
|
],
|
|
@@ -4296,9 +4530,9 @@
|
|
|
4296
4530
|
},
|
|
4297
4531
|
{
|
|
4298
4532
|
"name": "label",
|
|
4299
|
-
"type": "string",
|
|
4300
|
-
"default": "
|
|
4301
|
-
"description": "Accessible name given to every divider."
|
|
4533
|
+
"type": "string|null",
|
|
4534
|
+
"default": "null",
|
|
4535
|
+
"description": "Accessible name given to every divider; null reads the `dock.resize` message (\"Resize panes\")."
|
|
4302
4536
|
}
|
|
4303
4537
|
],
|
|
4304
4538
|
"events": [
|
|
@@ -4541,6 +4775,42 @@
|
|
|
4541
4775
|
}
|
|
4542
4776
|
]
|
|
4543
4777
|
},
|
|
4778
|
+
"ElicitationHandler": {
|
|
4779
|
+
"options": [
|
|
4780
|
+
{
|
|
4781
|
+
"name": "serverName",
|
|
4782
|
+
"type": "string",
|
|
4783
|
+
"default": null,
|
|
4784
|
+
"description": "The name of the server that asks, as the client knows it; shown as \"Asked by <server>\". Required: the person must always see who asks."
|
|
4785
|
+
},
|
|
4786
|
+
{
|
|
4787
|
+
"name": "authors",
|
|
4788
|
+
"type": "Record<string, {name: string}>",
|
|
4789
|
+
"default": "{}",
|
|
4790
|
+
"description": "Display names by key; when it lists `serverName`, that entry's name is shown instead."
|
|
4791
|
+
},
|
|
4792
|
+
{
|
|
4793
|
+
"name": "target",
|
|
4794
|
+
"type": "Element|string|null",
|
|
4795
|
+
"default": "null",
|
|
4796
|
+
"description": "Where the surface goes inline; a Dialog without one."
|
|
4797
|
+
},
|
|
4798
|
+
{
|
|
4799
|
+
"name": "open",
|
|
4800
|
+
"type": "(url: string) => boolean|void",
|
|
4801
|
+
"default": null,
|
|
4802
|
+
"description": "Opens the page in URL mode, after the person agreed. It receives the normalised address and must open it in a new browsing context that cannot reach the application; returning `false` or throwing means it was not opened, and the request answers `cancel`. The default opens a new tab with `noopener` and `noreferrer`."
|
|
4803
|
+
},
|
|
4804
|
+
{
|
|
4805
|
+
"name": "msg",
|
|
4806
|
+
"type": "Record<string, string>|Record<string, Record<string, string>>",
|
|
4807
|
+
"default": null,
|
|
4808
|
+
"description": "Localized messages, flat or by language: the `mcp.*` keys, and the `surface.*` keys of the form."
|
|
4809
|
+
}
|
|
4810
|
+
],
|
|
4811
|
+
"events": [],
|
|
4812
|
+
"methods": []
|
|
4813
|
+
},
|
|
4544
4814
|
"EmptyState": {
|
|
4545
4815
|
"options": [
|
|
4546
4816
|
{
|
|
@@ -4641,9 +4911,9 @@
|
|
|
4641
4911
|
},
|
|
4642
4912
|
{
|
|
4643
4913
|
"name": "actionsLabel",
|
|
4644
|
-
"type": "string",
|
|
4645
|
-
"default": "
|
|
4646
|
-
"description": "Accessible name for secondary actions."
|
|
4914
|
+
"type": "string|null",
|
|
4915
|
+
"default": "null",
|
|
4916
|
+
"description": "Accessible name for secondary actions; null reads the `entityRef.actions` message (\"Entity actions\")."
|
|
4647
4917
|
}
|
|
4648
4918
|
],
|
|
4649
4919
|
"events": [
|
|
@@ -4713,9 +4983,9 @@
|
|
|
4713
4983
|
},
|
|
4714
4984
|
{
|
|
4715
4985
|
"name": "recentLabel",
|
|
4716
|
-
"type": "string",
|
|
4717
|
-
"default":
|
|
4718
|
-
"description": "Heading above recent choices."
|
|
4986
|
+
"type": "string|null",
|
|
4987
|
+
"default": null,
|
|
4988
|
+
"description": "Heading above recent choices, by default the `select.recent` message (\"Recent\"); null shows none."
|
|
4719
4989
|
},
|
|
4720
4990
|
{
|
|
4721
4991
|
"name": "create",
|
|
@@ -5251,9 +5521,9 @@
|
|
|
5251
5521
|
},
|
|
5252
5522
|
{
|
|
5253
5523
|
"name": "actionsLabel",
|
|
5254
|
-
"type": "string",
|
|
5255
|
-
"default": "
|
|
5256
|
-
"description": "Accessible name for secondary actions."
|
|
5524
|
+
"type": "string|null",
|
|
5525
|
+
"default": "null",
|
|
5526
|
+
"description": "Accessible name for secondary actions; null reads the `fileItem.actions` message (\"File actions\")."
|
|
5257
5527
|
},
|
|
5258
5528
|
{
|
|
5259
5529
|
"name": "locale",
|
|
@@ -5323,9 +5593,9 @@
|
|
|
5323
5593
|
},
|
|
5324
5594
|
{
|
|
5325
5595
|
"name": "label",
|
|
5326
|
-
"type": "string",
|
|
5327
|
-
"default": "
|
|
5328
|
-
"description": "Accessible collection name."
|
|
5596
|
+
"type": "string|null",
|
|
5597
|
+
"default": "null",
|
|
5598
|
+
"description": "Accessible collection name; null reads the `fileList.label` message (\"Files\")."
|
|
5329
5599
|
},
|
|
5330
5600
|
{
|
|
5331
5601
|
"name": "loading",
|
|
@@ -5341,15 +5611,15 @@
|
|
|
5341
5611
|
},
|
|
5342
5612
|
{
|
|
5343
5613
|
"name": "loadingText",
|
|
5344
|
-
"type": "string",
|
|
5345
|
-
"default":
|
|
5346
|
-
"description": "Loading status text."
|
|
5614
|
+
"type": "string|null",
|
|
5615
|
+
"default": null,
|
|
5616
|
+
"description": "Loading status text, by default the `fileList.loading` message (\"Loading files\"). Null shows none."
|
|
5347
5617
|
},
|
|
5348
5618
|
{
|
|
5349
5619
|
"name": "emptyText",
|
|
5350
5620
|
"type": "string|number|Node|Component|null",
|
|
5351
|
-
"default":
|
|
5352
|
-
"description": "Empty-state content."
|
|
5621
|
+
"default": null,
|
|
5622
|
+
"description": "Empty-state content, by default the `fileList.empty` message (\"No files\"). Null shows none."
|
|
5353
5623
|
}
|
|
5354
5624
|
],
|
|
5355
5625
|
"events": [
|
|
@@ -5798,9 +6068,9 @@
|
|
|
5798
6068
|
},
|
|
5799
6069
|
{
|
|
5800
6070
|
"name": "emptyText",
|
|
5801
|
-
"type": "string",
|
|
5802
|
-
"default":
|
|
5803
|
-
"description": "Text shown in an empty column."
|
|
6071
|
+
"type": "string|null",
|
|
6072
|
+
"default": null,
|
|
6073
|
+
"description": "Text shown in an empty column, by default the `finder.noItems` message (\"Empty\"). Null shows none."
|
|
5804
6074
|
},
|
|
5805
6075
|
{
|
|
5806
6076
|
"name": "msg",
|
|
@@ -5877,23 +6147,53 @@
|
|
|
5877
6147
|
}
|
|
5878
6148
|
]
|
|
5879
6149
|
},
|
|
5880
|
-
"
|
|
6150
|
+
"Flag": {
|
|
5881
6151
|
"options": [
|
|
5882
6152
|
{
|
|
5883
|
-
"name": "
|
|
5884
|
-
"type": "
|
|
5885
|
-
"default": "
|
|
5886
|
-
"description": "
|
|
6153
|
+
"name": "kind",
|
|
6154
|
+
"type": "FlagKind",
|
|
6155
|
+
"default": "'auto'",
|
|
6156
|
+
"description": "Drawing; `src` implies `image`."
|
|
5887
6157
|
},
|
|
5888
6158
|
{
|
|
5889
|
-
"name": "
|
|
5890
|
-
"type": "
|
|
5891
|
-
"default": "
|
|
5892
|
-
"description": "
|
|
6159
|
+
"name": "src",
|
|
6160
|
+
"type": "string|null",
|
|
6161
|
+
"default": "null",
|
|
6162
|
+
"description": "Image URL. `{code}` in it is replaced by the lower-case region code and `{CODE}` by the upper-case one, so `'/flags/{code}.svg'` serves a whole flag set."
|
|
5893
6163
|
},
|
|
5894
6164
|
{
|
|
5895
|
-
"name": "
|
|
5896
|
-
"type": "
|
|
6165
|
+
"name": "text",
|
|
6166
|
+
"type": "string|null",
|
|
6167
|
+
"default": "null",
|
|
6168
|
+
"description": "Text of the code chip, by default the region code. A chip also stands in for a flag when there is no valid region, as for a language without a country."
|
|
6169
|
+
},
|
|
6170
|
+
{
|
|
6171
|
+
"name": "label",
|
|
6172
|
+
"type": "string|null",
|
|
6173
|
+
"default": "null",
|
|
6174
|
+
"description": "Accessible name. Without one the flag is decorative (`aria-hidden`) and must sit beside text that names the country or language."
|
|
6175
|
+
}
|
|
6176
|
+
],
|
|
6177
|
+
"events": [],
|
|
6178
|
+
"methods": []
|
|
6179
|
+
},
|
|
6180
|
+
"Form": {
|
|
6181
|
+
"options": [
|
|
6182
|
+
{
|
|
6183
|
+
"name": "fieldsets",
|
|
6184
|
+
"type": "Array<Fieldset|import('../fieldset/fieldset.js').FieldsetOptions>",
|
|
6185
|
+
"default": "[]",
|
|
6186
|
+
"description": "Initial fieldsets."
|
|
6187
|
+
},
|
|
6188
|
+
{
|
|
6189
|
+
"name": "actions",
|
|
6190
|
+
"type": "FormAction[]",
|
|
6191
|
+
"default": "[]",
|
|
6192
|
+
"description": "Form action descriptors."
|
|
6193
|
+
},
|
|
6194
|
+
{
|
|
6195
|
+
"name": "novalidate",
|
|
6196
|
+
"type": "boolean",
|
|
5897
6197
|
"default": "true",
|
|
5898
6198
|
"description": "Native `novalidate` state."
|
|
5899
6199
|
},
|
|
@@ -6135,6 +6435,34 @@
|
|
|
6135
6435
|
}
|
|
6136
6436
|
]
|
|
6137
6437
|
},
|
|
6438
|
+
"InlineSplitter": {
|
|
6439
|
+
"options": [
|
|
6440
|
+
{
|
|
6441
|
+
"name": "maxLine",
|
|
6442
|
+
"type": "number",
|
|
6443
|
+
"default": "262144",
|
|
6444
|
+
"description": "Longest line inside a fence."
|
|
6445
|
+
}
|
|
6446
|
+
],
|
|
6447
|
+
"events": [
|
|
6448
|
+
{
|
|
6449
|
+
"name": "text",
|
|
6450
|
+
"payload": null,
|
|
6451
|
+
"description": "Receives prose, as it arrives, unchanged."
|
|
6452
|
+
},
|
|
6453
|
+
{
|
|
6454
|
+
"name": "line",
|
|
6455
|
+
"payload": null,
|
|
6456
|
+
"description": "Receives each line inside a surface fence."
|
|
6457
|
+
},
|
|
6458
|
+
{
|
|
6459
|
+
"name": "error",
|
|
6460
|
+
"payload": null,
|
|
6461
|
+
"description": "Receives an over-long line inside a fence and a fence still open at `end()`."
|
|
6462
|
+
}
|
|
6463
|
+
],
|
|
6464
|
+
"methods": []
|
|
6465
|
+
},
|
|
6138
6466
|
"KanbanView": {
|
|
6139
6467
|
"options": [
|
|
6140
6468
|
{
|
|
@@ -6465,7 +6793,7 @@
|
|
|
6465
6793
|
"name": "labels",
|
|
6466
6794
|
"type": "Record<string,string>",
|
|
6467
6795
|
"default": "{}",
|
|
6468
|
-
"description": "
|
|
6796
|
+
"description": "Per-instance overrides of the board's text. Each key is the part after `kanbanView.` in the message catalogue, where every visible and announced string lives, and a value may reorder or drop the named placeholders."
|
|
6469
6797
|
},
|
|
6470
6798
|
{
|
|
6471
6799
|
"name": "columnOrder",
|
|
@@ -6511,9 +6839,9 @@
|
|
|
6511
6839
|
},
|
|
6512
6840
|
{
|
|
6513
6841
|
"name": "label",
|
|
6514
|
-
"type": "string",
|
|
6515
|
-
"default":
|
|
6516
|
-
"description": "Accessible board label."
|
|
6842
|
+
"type": "string|null",
|
|
6843
|
+
"default": null,
|
|
6844
|
+
"description": "Accessible board label, by default the `kanbanView.label` message (\"Kanban board\"). Null leaves the board unnamed."
|
|
6517
6845
|
}
|
|
6518
6846
|
],
|
|
6519
6847
|
"events": [
|
|
@@ -7009,6 +7337,24 @@
|
|
|
7009
7337
|
"events": [],
|
|
7010
7338
|
"methods": []
|
|
7011
7339
|
},
|
|
7340
|
+
"LineSplitter": {
|
|
7341
|
+
"options": [
|
|
7342
|
+
{
|
|
7343
|
+
"name": "maxLine",
|
|
7344
|
+
"type": "number",
|
|
7345
|
+
"default": "262144",
|
|
7346
|
+
"description": "Longest line, in characters, that is buffered. A longer one is reported once and dropped up to its end rather than held in memory."
|
|
7347
|
+
}
|
|
7348
|
+
],
|
|
7349
|
+
"events": [
|
|
7350
|
+
{
|
|
7351
|
+
"name": "error",
|
|
7352
|
+
"payload": null,
|
|
7353
|
+
"description": "Receives an over-long line's report."
|
|
7354
|
+
}
|
|
7355
|
+
],
|
|
7356
|
+
"methods": []
|
|
7357
|
+
},
|
|
7012
7358
|
"ListToolbar": {
|
|
7013
7359
|
"options": [
|
|
7014
7360
|
{
|
|
@@ -7182,6 +7528,66 @@
|
|
|
7182
7528
|
}
|
|
7183
7529
|
]
|
|
7184
7530
|
},
|
|
7531
|
+
"LocaleSelect": {
|
|
7532
|
+
"options": [
|
|
7533
|
+
{
|
|
7534
|
+
"name": "locales",
|
|
7535
|
+
"type": "Array<string|LocaleItem>",
|
|
7536
|
+
"default": null,
|
|
7537
|
+
"description": "The locales to offer, in the order given. Tags are canonicalized (`'de_at'` → `'de-AT'`); an invalid tag is left out. Without it the picker offers a short list of widely used languages."
|
|
7538
|
+
},
|
|
7539
|
+
{
|
|
7540
|
+
"name": "preferred",
|
|
7541
|
+
"type": "Array<string|LocaleItem>",
|
|
7542
|
+
"default": "[]",
|
|
7543
|
+
"description": "Locales pinned above the list, kept through filtering — the application's own languages above a long list, say."
|
|
7544
|
+
},
|
|
7545
|
+
{
|
|
7546
|
+
"name": "preferredLabel",
|
|
7547
|
+
"type": "string|null",
|
|
7548
|
+
"default": "null",
|
|
7549
|
+
"description": "Heading above the pinned locales."
|
|
7550
|
+
},
|
|
7551
|
+
{
|
|
7552
|
+
"name": "displayLocale",
|
|
7553
|
+
"type": "string|null",
|
|
7554
|
+
"default": "null",
|
|
7555
|
+
"description": "The language the secondary name is written in. By default the component's `lang` option, then the library language (`setLanguage()`)."
|
|
7556
|
+
},
|
|
7557
|
+
{
|
|
7558
|
+
"name": "display",
|
|
7559
|
+
"type": "'both'|'native'|'localized'",
|
|
7560
|
+
"default": "'both'",
|
|
7561
|
+
"description": "`native` names each locale in its own language (\"Deutsch\"), `localized` in the display language (\"German\"), and `both` shows the native name with the localized one beneath it where the two differ — so a reader finds their language whichever language the interface is in."
|
|
7562
|
+
},
|
|
7563
|
+
{
|
|
7564
|
+
"name": "flags",
|
|
7565
|
+
"type": "FlagMode",
|
|
7566
|
+
"default": "'auto'",
|
|
7567
|
+
"description": "What stands before each locale: the flag of its region (`auto` draws flag emoji where the platform has them and a language chip where it does not; `emoji` forces the emoji), a language chip (`code`, the honest choice where a language is not a country), nothing (`none`), or a function returning the content."
|
|
7568
|
+
},
|
|
7569
|
+
{
|
|
7570
|
+
"name": "flagUrl",
|
|
7571
|
+
"type": "string|null",
|
|
7572
|
+
"default": "null",
|
|
7573
|
+
"description": "Flag image URL template, such as `'/flags/{code}.svg'`; `{code}` is the lower-case region, `{CODE}` the upper-case. Draws flags from the application's own flag set instead of emoji."
|
|
7574
|
+
},
|
|
7575
|
+
{
|
|
7576
|
+
"name": "flagRegions",
|
|
7577
|
+
"type": "Record<string, string|null>",
|
|
7578
|
+
"default": "{}",
|
|
7579
|
+
"description": "Flag region per tag or language, for a language whose likely region is not the one the application means: `{ en: 'GB' }`. A tag with a region of its own (`en-US`) keeps it unless it is listed here itself."
|
|
7580
|
+
},
|
|
7581
|
+
{
|
|
7582
|
+
"name": "sort",
|
|
7583
|
+
"type": "boolean",
|
|
7584
|
+
"default": "false",
|
|
7585
|
+
"description": "Orders the locales by label rather than as given."
|
|
7586
|
+
}
|
|
7587
|
+
],
|
|
7588
|
+
"events": [],
|
|
7589
|
+
"methods": []
|
|
7590
|
+
},
|
|
7185
7591
|
"MasterPanel": {
|
|
7186
7592
|
"options": [
|
|
7187
7593
|
{
|
|
@@ -7495,7 +7901,7 @@
|
|
|
7495
7901
|
"name": "lightDismiss",
|
|
7496
7902
|
"type": "boolean",
|
|
7497
7903
|
"default": "false",
|
|
7498
|
-
"description": "Whether a backdrop click closes the modal."
|
|
7904
|
+
"description": "Whether a backdrop click closes the modal. Like every dismissal by the reader, it raises a preventable `cancel` first."
|
|
7499
7905
|
},
|
|
7500
7906
|
{
|
|
7501
7907
|
"name": "destroyOnClose",
|
|
@@ -7523,7 +7929,7 @@
|
|
|
7523
7929
|
},
|
|
7524
7930
|
{
|
|
7525
7931
|
"name": "cancel",
|
|
7526
|
-
"payload": "
|
|
7932
|
+
"payload": "{reason}",
|
|
7527
7933
|
"description": "Cancel event listener."
|
|
7528
7934
|
}
|
|
7529
7935
|
],
|
|
@@ -7845,9 +8251,9 @@
|
|
|
7845
8251
|
},
|
|
7846
8252
|
{
|
|
7847
8253
|
"name": "addLabel",
|
|
7848
|
-
"type": "string",
|
|
7849
|
-
"default": "
|
|
7850
|
-
"description": "Add-row button text."
|
|
8254
|
+
"type": "string|null",
|
|
8255
|
+
"default": "null",
|
|
8256
|
+
"description": "Add-row button text; null reads the `multiValueEditor.add` message (\"Add value\")."
|
|
7851
8257
|
},
|
|
7852
8258
|
{
|
|
7853
8259
|
"name": "reorder",
|
|
@@ -8001,6 +8407,12 @@
|
|
|
8001
8407
|
"default": "null",
|
|
8002
8408
|
"description": "Decimal places; derived from `step` when null."
|
|
8003
8409
|
},
|
|
8410
|
+
{
|
|
8411
|
+
"name": "snap",
|
|
8412
|
+
"type": "boolean",
|
|
8413
|
+
"default": "true",
|
|
8414
|
+
"description": "Whether a typed or assigned value is moved onto the `step` grid. With `false` the value is kept exactly as entered — `step` is then only the increment of the buttons and arrow keys, and decimals are rounded only to an explicit `precision`. `min` and `max` still apply. Use it for values that are not multiples of anything: an identifier, a seed, a measurement."
|
|
8415
|
+
},
|
|
8004
8416
|
{
|
|
8005
8417
|
"name": "wrap",
|
|
8006
8418
|
"type": "boolean",
|
|
@@ -8059,7 +8471,7 @@
|
|
|
8059
8471
|
"name": "locale",
|
|
8060
8472
|
"type": "string|null",
|
|
8061
8473
|
"default": "null",
|
|
8062
|
-
"description": "Locale for formatting; defaults to the
|
|
8474
|
+
"description": "Locale for formatting; defaults to the active language."
|
|
8063
8475
|
},
|
|
8064
8476
|
{
|
|
8065
8477
|
"name": "msg",
|
|
@@ -8091,7 +8503,7 @@
|
|
|
8091
8503
|
"name": "set",
|
|
8092
8504
|
"signature": "set(next, [options])",
|
|
8093
8505
|
"returns": "this",
|
|
8094
|
-
"description": "Sets the value,
|
|
8506
|
+
"description": "Sets the value, clamping it into `[min, max]` and — unless `snap` is off — moving it onto the `step` grid."
|
|
8095
8507
|
},
|
|
8096
8508
|
{
|
|
8097
8509
|
"name": "stepUp",
|
|
@@ -8612,6 +9024,61 @@
|
|
|
8612
9024
|
"events": [],
|
|
8613
9025
|
"methods": []
|
|
8614
9026
|
},
|
|
9027
|
+
"PromptStarters": {
|
|
9028
|
+
"options": [
|
|
9029
|
+
{
|
|
9030
|
+
"name": "items",
|
|
9031
|
+
"type": "PromptStarter[]",
|
|
9032
|
+
"default": "[]",
|
|
9033
|
+
"description": "The starters. An entry without `id`, `title` or `text` is left out, as is a repeated id; any other field on an item is handed back in `pick`."
|
|
9034
|
+
},
|
|
9035
|
+
{
|
|
9036
|
+
"name": "label",
|
|
9037
|
+
"type": "string|null",
|
|
9038
|
+
"default": "null",
|
|
9039
|
+
"description": "Accessible name of the group. Omitted resolves `promptStarters.label`, English `Suggestions`."
|
|
9040
|
+
},
|
|
9041
|
+
{
|
|
9042
|
+
"name": "columns",
|
|
9043
|
+
"type": "'auto'|1|2",
|
|
9044
|
+
"default": "'auto'",
|
|
9045
|
+
"description": "Columns of starters. `'auto'` is two, and one in a container narrower than 32rem."
|
|
9046
|
+
},
|
|
9047
|
+
{
|
|
9048
|
+
"name": "headingLevel",
|
|
9049
|
+
"type": "1|2|3|4|5|6|null",
|
|
9050
|
+
"default": "null",
|
|
9051
|
+
"description": "Shows `label` above the starters as a heading of this level, which then names the group. Null keeps the label for assistive technology only."
|
|
9052
|
+
},
|
|
9053
|
+
{
|
|
9054
|
+
"name": "msg",
|
|
9055
|
+
"type": "Record<string, string>|Record<string, Record<string, string>>",
|
|
9056
|
+
"default": null,
|
|
9057
|
+
"description": "Localized messages."
|
|
9058
|
+
}
|
|
9059
|
+
],
|
|
9060
|
+
"events": [
|
|
9061
|
+
{
|
|
9062
|
+
"name": "pick",
|
|
9063
|
+
"payload": "{item: PromptStarter}",
|
|
9064
|
+
"description": "Listener for a starter being picked."
|
|
9065
|
+
}
|
|
9066
|
+
],
|
|
9067
|
+
"methods": [
|
|
9068
|
+
{
|
|
9069
|
+
"name": "setItems",
|
|
9070
|
+
"signature": "setItems(items)",
|
|
9071
|
+
"returns": "this",
|
|
9072
|
+
"description": "Replaces the starters. The focus on a starter stays on the starter with the same `id`. Emits nothing."
|
|
9073
|
+
},
|
|
9074
|
+
{
|
|
9075
|
+
"name": "destroy",
|
|
9076
|
+
"signature": "destroy()",
|
|
9077
|
+
"returns": "void",
|
|
9078
|
+
"description": "Removes what was drawn and stops listening."
|
|
9079
|
+
}
|
|
9080
|
+
]
|
|
9081
|
+
},
|
|
8615
9082
|
"ProseAnchors": {
|
|
8616
9083
|
"options": [
|
|
8617
9084
|
{
|
|
@@ -8622,21 +9089,21 @@
|
|
|
8622
9089
|
},
|
|
8623
9090
|
{
|
|
8624
9091
|
"name": "label",
|
|
8625
|
-
"type": "string",
|
|
8626
|
-
"default":
|
|
8627
|
-
"description": "The link's accessible name; `%1` is the heading."
|
|
9092
|
+
"type": "string|null",
|
|
9093
|
+
"default": null,
|
|
9094
|
+
"description": "The link's accessible name; `%1` is the heading. By default the `prose.copyLinkTo` message (\"Copy link to %1\"). Null gives none."
|
|
8628
9095
|
},
|
|
8629
9096
|
{
|
|
8630
9097
|
"name": "title",
|
|
8631
|
-
"type": "string",
|
|
8632
|
-
"default":
|
|
8633
|
-
"description": "The link's tooltip."
|
|
9098
|
+
"type": "string|null",
|
|
9099
|
+
"default": null,
|
|
9100
|
+
"description": "The link's tooltip, by default the `prose.copyLink` message (\"Copy link\"). Null gives none."
|
|
8634
9101
|
},
|
|
8635
9102
|
{
|
|
8636
9103
|
"name": "feedback",
|
|
8637
|
-
"type": "string",
|
|
8638
|
-
"default":
|
|
8639
|
-
"description": "What the live region says after a copy."
|
|
9104
|
+
"type": "string|null",
|
|
9105
|
+
"default": null,
|
|
9106
|
+
"description": "What the live region says after a copy, by default the `prose.copied` message (\"Link copied\"). Null says nothing."
|
|
8640
9107
|
},
|
|
8641
9108
|
{
|
|
8642
9109
|
"name": "feedbackDuration",
|
|
@@ -8900,9 +9367,9 @@
|
|
|
8900
9367
|
},
|
|
8901
9368
|
{
|
|
8902
9369
|
"name": "label",
|
|
8903
|
-
"type": "string",
|
|
8904
|
-
"default": "
|
|
8905
|
-
"description": "Accessible name of the group."
|
|
9370
|
+
"type": "string|null",
|
|
9371
|
+
"default": "null",
|
|
9372
|
+
"description": "Accessible name of the group; null reads the `rating.label` message (\"Rating\")."
|
|
8906
9373
|
},
|
|
8907
9374
|
{
|
|
8908
9375
|
"name": "icon",
|
|
@@ -9998,6 +10465,30 @@
|
|
|
9998
10465
|
"returns": "this",
|
|
9999
10466
|
"description": "Moves focus to the combobox input."
|
|
10000
10467
|
},
|
|
10468
|
+
{
|
|
10469
|
+
"name": "locale",
|
|
10470
|
+
"signature": "locale(target, [options])",
|
|
10471
|
+
"returns": "Select",
|
|
10472
|
+
"description": "Creates a locale Select with native/localized names, pinned choices, and optional flags. Values are canonical BCP 47 tags; initial values and `set()` accept underscores and any case."
|
|
10473
|
+
},
|
|
10474
|
+
{
|
|
10475
|
+
"name": "localeItems",
|
|
10476
|
+
"signature": "localeItems(locales, [options])",
|
|
10477
|
+
"returns": "ReturnType<typeof localeItems>",
|
|
10478
|
+
"description": "Builds locale items without the DOM, for lists and summaries using the same names."
|
|
10479
|
+
},
|
|
10480
|
+
{
|
|
10481
|
+
"name": "country",
|
|
10482
|
+
"signature": "country(target, [options])",
|
|
10483
|
+
"returns": "Select",
|
|
10484
|
+
"description": "Creates a country Select with localized names, pinned choices, and optional flags. Search includes the English name, ISO code, and descriptions; initial values and `set()` accept either case."
|
|
10485
|
+
},
|
|
10486
|
+
{
|
|
10487
|
+
"name": "countryItems",
|
|
10488
|
+
"signature": "countryItems([countries], [options])",
|
|
10489
|
+
"returns": "ReturnType<typeof countryItems>",
|
|
10490
|
+
"description": "Builds country items without the DOM, defaulting to the ISO country catalogue."
|
|
10491
|
+
},
|
|
10001
10492
|
{
|
|
10002
10493
|
"name": "priority",
|
|
10003
10494
|
"signature": "priority(target, [options])",
|
|
@@ -10148,7 +10639,7 @@
|
|
|
10148
10639
|
},
|
|
10149
10640
|
{
|
|
10150
10641
|
"name": "cancel",
|
|
10151
|
-
"payload": "
|
|
10642
|
+
"payload": "import('../modal/modal.js').ModalCancelDetail",
|
|
10152
10643
|
"description": "Cancel event listener."
|
|
10153
10644
|
},
|
|
10154
10645
|
{
|
|
@@ -10601,9 +11092,9 @@
|
|
|
10601
11092
|
},
|
|
10602
11093
|
{
|
|
10603
11094
|
"name": "label",
|
|
10604
|
-
"type": "string",
|
|
10605
|
-
"default":
|
|
10606
|
-
"description": "Accessible field label and direction-name prefix."
|
|
11095
|
+
"type": "string|null",
|
|
11096
|
+
"default": null,
|
|
11097
|
+
"description": "Accessible field label and direction-name prefix, by default the `sortControl.label` message (\"Sort by\"). Null gives neither."
|
|
10607
11098
|
},
|
|
10608
11099
|
{
|
|
10609
11100
|
"name": "labels",
|
|
@@ -10674,9 +11165,9 @@
|
|
|
10674
11165
|
},
|
|
10675
11166
|
{
|
|
10676
11167
|
"name": "label",
|
|
10677
|
-
"type": "string",
|
|
10678
|
-
"default":
|
|
10679
|
-
"description": "The visible label the list is named by. Empty hides it and names the list with
|
|
11168
|
+
"type": "string|null",
|
|
11169
|
+
"default": null,
|
|
11170
|
+
"description": "The visible label the list is named by, by default the `sourceList.label` message (\"Sources\"). Empty or null hides it and names the list with that message instead."
|
|
10680
11171
|
},
|
|
10681
11172
|
{
|
|
10682
11173
|
"name": "layout",
|
|
@@ -10825,9 +11316,9 @@
|
|
|
10825
11316
|
},
|
|
10826
11317
|
{
|
|
10827
11318
|
"name": "label",
|
|
10828
|
-
"type": "string",
|
|
10829
|
-
"default": "
|
|
10830
|
-
"description": "Accessible name of the divider."
|
|
11319
|
+
"type": "string|null",
|
|
11320
|
+
"default": "null",
|
|
11321
|
+
"description": "Accessible name of the divider; null reads the `splitView.resize` message (\"Resize panes\")."
|
|
10831
11322
|
}
|
|
10832
11323
|
],
|
|
10833
11324
|
"events": [
|
|
@@ -11271,6 +11762,201 @@
|
|
|
11271
11762
|
}
|
|
11272
11763
|
]
|
|
11273
11764
|
},
|
|
11765
|
+
"Surface": {
|
|
11766
|
+
"options": [
|
|
11767
|
+
{
|
|
11768
|
+
"name": "document",
|
|
11769
|
+
"type": "SurfaceDocument|Record<string, unknown>|null",
|
|
11770
|
+
"default": "null",
|
|
11771
|
+
"description": "A whole surface, as the `show_surface` and `ask_user` tools take it. Leave it out to stream with `apply()` or `write()`."
|
|
11772
|
+
},
|
|
11773
|
+
{
|
|
11774
|
+
"name": "policy",
|
|
11775
|
+
"type": "SurfacePolicy|null",
|
|
11776
|
+
"default": "null",
|
|
11777
|
+
"description": "What each action needs before it replies; every action is allowed when null. Nothing in a surface can lower what it decides."
|
|
11778
|
+
},
|
|
11779
|
+
{
|
|
11780
|
+
"name": "resolve",
|
|
11781
|
+
"type": "SurfaceResolve",
|
|
11782
|
+
"default": "{}",
|
|
11783
|
+
"description": "How records, links and assets are resolved."
|
|
11784
|
+
},
|
|
11785
|
+
{
|
|
11786
|
+
"name": "authors",
|
|
11787
|
+
"type": "Record<string, {name: string}>",
|
|
11788
|
+
"default": "{}",
|
|
11789
|
+
"description": "Who may compose a surface, by the key its `author` names; the byline shows the name, or the key when it is not listed."
|
|
11790
|
+
},
|
|
11791
|
+
{
|
|
11792
|
+
"name": "userInitiated",
|
|
11793
|
+
"type": "boolean",
|
|
11794
|
+
"default": "false",
|
|
11795
|
+
"description": "Whether the surface answers the person's latest message; only then may `openSurface()` honour a request for a sheet or a dialog."
|
|
11796
|
+
},
|
|
11797
|
+
{
|
|
11798
|
+
"name": "headingLevel",
|
|
11799
|
+
"type": "2|3|4|5",
|
|
11800
|
+
"default": "3",
|
|
11801
|
+
"description": "The element level of the surface's title; its `heading` nodes go one and two deeper."
|
|
11802
|
+
},
|
|
11803
|
+
{
|
|
11804
|
+
"name": "locale",
|
|
11805
|
+
"type": "string",
|
|
11806
|
+
"default": null,
|
|
11807
|
+
"description": "Locale for numbers and times."
|
|
11808
|
+
},
|
|
11809
|
+
{
|
|
11810
|
+
"name": "catalog",
|
|
11811
|
+
"type": "SurfaceCatalog",
|
|
11812
|
+
"default": "CATALOG",
|
|
11813
|
+
"description": "A catalog narrowed with `narrowCatalog()`; the full one by default. What lies outside it is refused as unknown."
|
|
11814
|
+
},
|
|
11815
|
+
{
|
|
11816
|
+
"name": "token",
|
|
11817
|
+
"type": "string|null",
|
|
11818
|
+
"default": "null",
|
|
11819
|
+
"description": "The application's opaque string, at most 512 characters, copied unchanged into every reply. A surface cannot set it."
|
|
11820
|
+
},
|
|
11821
|
+
{
|
|
11822
|
+
"name": "reply",
|
|
11823
|
+
"type": "SurfaceReply|null",
|
|
11824
|
+
"default": "null",
|
|
11825
|
+
"description": "A reply the surface already gave, for a surface restored from a stored conversation: it starts as its receipt and replies no more."
|
|
11826
|
+
},
|
|
11827
|
+
{
|
|
11828
|
+
"name": "labelledBy",
|
|
11829
|
+
"type": "string|null",
|
|
11830
|
+
"default": "null",
|
|
11831
|
+
"description": "The id of an element that already shows the title, such as a Dialog's; the surface then draws no title of its own and is labelled by it."
|
|
11832
|
+
},
|
|
11833
|
+
{
|
|
11834
|
+
"name": "chartAdapter",
|
|
11835
|
+
"type": "ChartAdapter|null",
|
|
11836
|
+
"default": "null",
|
|
11837
|
+
"description": "The engine that draws `chart` nodes; without one a chart shows its data table."
|
|
11838
|
+
},
|
|
11839
|
+
{
|
|
11840
|
+
"name": "msg",
|
|
11841
|
+
"type": "Record<string, string>|Record<string, Record<string, string>>",
|
|
11842
|
+
"default": null,
|
|
11843
|
+
"description": "Localized messages."
|
|
11844
|
+
}
|
|
11845
|
+
],
|
|
11846
|
+
"events": [
|
|
11847
|
+
{
|
|
11848
|
+
"name": "reply",
|
|
11849
|
+
"payload": "{reply: SurfaceReply}",
|
|
11850
|
+
"description": "Reply listener."
|
|
11851
|
+
},
|
|
11852
|
+
{
|
|
11853
|
+
"name": "error",
|
|
11854
|
+
"payload": "{errors: SurfaceError[]}",
|
|
11855
|
+
"description": "Error listener."
|
|
11856
|
+
},
|
|
11857
|
+
{
|
|
11858
|
+
"name": "change",
|
|
11859
|
+
"payload": "{name: string, value: unknown}",
|
|
11860
|
+
"description": "Input listener."
|
|
11861
|
+
},
|
|
11862
|
+
{
|
|
11863
|
+
"name": "ready",
|
|
11864
|
+
"payload": "Record<string, never>",
|
|
11865
|
+
"description": "First-render listener."
|
|
11866
|
+
},
|
|
11867
|
+
{
|
|
11868
|
+
"name": "end",
|
|
11869
|
+
"payload": "Record<string, never>",
|
|
11870
|
+
"description": "End-of-surface listener."
|
|
11871
|
+
}
|
|
11872
|
+
],
|
|
11873
|
+
"methods": [
|
|
11874
|
+
{
|
|
11875
|
+
"name": "apply",
|
|
11876
|
+
"signature": "apply(op)",
|
|
11877
|
+
"returns": "this",
|
|
11878
|
+
"description": "Applies one operation, as parsed from its line. It is validated against the catalog first: what is invalid is dropped and reported through `error`, and only the valid rest is drawn. Operations for another surface, and any after the surface was answered, are ignored."
|
|
11879
|
+
},
|
|
11880
|
+
{
|
|
11881
|
+
"name": "write",
|
|
11882
|
+
"signature": "write(chunk)",
|
|
11883
|
+
"returns": "this",
|
|
11884
|
+
"description": "Takes a chunk of operation lines, as streamed: every complete line is parsed and applied."
|
|
11885
|
+
},
|
|
11886
|
+
{
|
|
11887
|
+
"name": "end",
|
|
11888
|
+
"signature": "end()",
|
|
11889
|
+
"returns": "this",
|
|
11890
|
+
"description": "Ends the stream: applies a last line without a line break. A surface whose `end` never arrived is reported and keeps its actions disabled; Cancel still replies."
|
|
11891
|
+
},
|
|
11892
|
+
{
|
|
11893
|
+
"name": "getValues",
|
|
11894
|
+
"signature": "getValues()",
|
|
11895
|
+
"returns": "Record<string, unknown>",
|
|
11896
|
+
"description": "The values of the visible inputs by name, as a reply would carry them: JSON, hidden inputs left out. A questionnaire's are `{answers, path}`."
|
|
11897
|
+
},
|
|
11898
|
+
{
|
|
11899
|
+
"name": "getErrors",
|
|
11900
|
+
"signature": "getErrors()",
|
|
11901
|
+
"returns": "SurfaceError[]",
|
|
11902
|
+
"description": "Every problem collected so far, in a shape an application can return to the model."
|
|
11903
|
+
},
|
|
11904
|
+
{
|
|
11905
|
+
"name": "cancel",
|
|
11906
|
+
"signature": "cancel([reason])",
|
|
11907
|
+
"returns": "this",
|
|
11908
|
+
"description": "Closes the surface unanswered: replies `cancel` (`dismiss` for a `show` surface)."
|
|
11909
|
+
},
|
|
11910
|
+
{
|
|
11911
|
+
"name": "supersede",
|
|
11912
|
+
"signature": "supersede()",
|
|
11913
|
+
"returns": "this",
|
|
11914
|
+
"description": "Ends the surface because a newer one takes its place: replies `dismiss` with the reason `superseded`."
|
|
11915
|
+
},
|
|
11916
|
+
{
|
|
11917
|
+
"name": "focus",
|
|
11918
|
+
"signature": "focus()",
|
|
11919
|
+
"returns": "this",
|
|
11920
|
+
"description": "Moves focus to the first control: the first input, else the first enabled action."
|
|
11921
|
+
},
|
|
11922
|
+
{
|
|
11923
|
+
"name": "toDocument",
|
|
11924
|
+
"signature": "toDocument()",
|
|
11925
|
+
"returns": "SurfaceDocument|null",
|
|
11926
|
+
"description": "The surface as it stands, as a document: what was validated, repairs applied and invalid parts dropped. `null` before it began."
|
|
11927
|
+
},
|
|
11928
|
+
{
|
|
11929
|
+
"name": "getReply",
|
|
11930
|
+
"signature": "getReply()",
|
|
11931
|
+
"returns": "SurfaceReply|null",
|
|
11932
|
+
"description": "The reply the surface gave, or `null` while it waits."
|
|
11933
|
+
},
|
|
11934
|
+
{
|
|
11935
|
+
"name": "destroy",
|
|
11936
|
+
"signature": "destroy()",
|
|
11937
|
+
"returns": "void",
|
|
11938
|
+
"description": "Destroys the surface. An unanswered surface replies `dismiss` first, with the reason `destroyed`, so a waiting agent never hangs."
|
|
11939
|
+
}
|
|
11940
|
+
]
|
|
11941
|
+
},
|
|
11942
|
+
"SurfaceText": {
|
|
11943
|
+
"options": [
|
|
11944
|
+
{
|
|
11945
|
+
"name": "msg",
|
|
11946
|
+
"type": "(key: string, ...args: unknown[]) => string",
|
|
11947
|
+
"default": null,
|
|
11948
|
+
"description": "Resolves a message key; English by default (`SURFACE_MESSAGES`)."
|
|
11949
|
+
},
|
|
11950
|
+
{
|
|
11951
|
+
"name": "entities",
|
|
11952
|
+
"type": "Iterable<string>|null",
|
|
11953
|
+
"default": "null",
|
|
11954
|
+
"description": "The record entities the document may name, as the Surface's `resolve.entities`."
|
|
11955
|
+
}
|
|
11956
|
+
],
|
|
11957
|
+
"events": [],
|
|
11958
|
+
"methods": []
|
|
11959
|
+
},
|
|
11274
11960
|
"TabInsert": {
|
|
11275
11961
|
"options": [
|
|
11276
11962
|
{
|
|
@@ -11435,6 +12121,12 @@
|
|
|
11435
12121
|
"default": "false",
|
|
11436
12122
|
"description": "Number of rows to render at first, with a control that appends the next batch on demand. A result set an ERP query returns happily — tens of thousands of rows — costs more to lay out than anyone will ever scroll through."
|
|
11437
12123
|
},
|
|
12124
|
+
{
|
|
12125
|
+
"name": "virtual",
|
|
12126
|
+
"type": "boolean",
|
|
12127
|
+
"default": "false",
|
|
12128
|
+
"description": "Windowed rendering: only the rows in view and one viewport of overscan above and below are in the DOM, with spacer rows keeping the scroll height. The table stays one grid over all of its rows, so this implies `interactive`, the header checkbox and Ctrl/Cmd+A take every row, drawn or not, and the row that has focus or is being edited stays drawn wherever it is. It needs a bounded scroll region: give it `height`, or the region stops at the height of the window. Every row takes the height of one measured row, rows of differing height are not supported, and column widths cannot follow content that is not drawn, so `auto` columns share the width evenly. Find-in-page does not see rows that are not drawn. Wins over `growing`."
|
|
12129
|
+
},
|
|
11438
12130
|
{
|
|
11439
12131
|
"name": "responsive",
|
|
11440
12132
|
"type": "false|'sm'|'md'|'lg'|'xl'",
|
|
@@ -11850,6 +12542,12 @@
|
|
|
11850
12542
|
"returns": "number",
|
|
11851
12543
|
"description": "How many rows are currently rendered."
|
|
11852
12544
|
},
|
|
12545
|
+
{
|
|
12546
|
+
"name": "reveal",
|
|
12547
|
+
"signature": "reveal(id)",
|
|
12548
|
+
"returns": "boolean",
|
|
12549
|
+
"description": "Scrolls a row into view. A windowed table draws it first, so a row that is not in the DOM can be reached by id; rows outside the data, in a collapsed branch, or held back by `growing` cannot."
|
|
12550
|
+
},
|
|
11853
12551
|
{
|
|
11854
12552
|
"name": "addEventListener",
|
|
11855
12553
|
"signature": "addEventListener(type, listener, [options])",
|
|
@@ -12531,9 +13229,9 @@
|
|
|
12531
13229
|
},
|
|
12532
13230
|
{
|
|
12533
13231
|
"name": "label",
|
|
12534
|
-
"type": "string",
|
|
12535
|
-
"default":
|
|
12536
|
-
"description": "Accessible name of the toolbar."
|
|
13232
|
+
"type": "string|null",
|
|
13233
|
+
"default": null,
|
|
13234
|
+
"description": "Accessible name of the toolbar, by default the `toolbar.label` message (\"Toolbar\"). Null gives none."
|
|
12537
13235
|
},
|
|
12538
13236
|
{
|
|
12539
13237
|
"name": "overflow",
|
|
@@ -12543,9 +13241,9 @@
|
|
|
12543
13241
|
},
|
|
12544
13242
|
{
|
|
12545
13243
|
"name": "overflowLabel",
|
|
12546
|
-
"type": "string",
|
|
12547
|
-
"default":
|
|
12548
|
-
"description": "Accessible name of the overflow menu trigger."
|
|
13244
|
+
"type": "string|null",
|
|
13245
|
+
"default": null,
|
|
13246
|
+
"description": "Accessible name of the overflow menu trigger, by default the `toolbar.more` message (\"More\"). Null gives none."
|
|
12549
13247
|
},
|
|
12550
13248
|
{
|
|
12551
13249
|
"name": "dense",
|
|
@@ -12802,9 +13500,9 @@
|
|
|
12802
13500
|
},
|
|
12803
13501
|
{
|
|
12804
13502
|
"name": "moreLabel",
|
|
12805
|
-
"type": "string",
|
|
12806
|
-
"default": "
|
|
12807
|
-
"description": "Name of a row's overflow menu; every action name is followed by the row's name (\"More actions: Q3 plan\")."
|
|
13503
|
+
"type": "string|null",
|
|
13504
|
+
"default": "null",
|
|
13505
|
+
"description": "Name of a row's overflow menu; every action name is followed by the row's name (\"More actions: Q3 plan\"). Null reads the `tree.more` message."
|
|
12808
13506
|
},
|
|
12809
13507
|
{
|
|
12810
13508
|
"name": "load",
|
|
@@ -12820,15 +13518,15 @@
|
|
|
12820
13518
|
},
|
|
12821
13519
|
{
|
|
12822
13520
|
"name": "label",
|
|
12823
|
-
"type": "string",
|
|
12824
|
-
"default": "
|
|
12825
|
-
"description": "Accessible name of the tree."
|
|
13521
|
+
"type": "string|null",
|
|
13522
|
+
"default": "null",
|
|
13523
|
+
"description": "Accessible name of the tree; null reads the `tree.label` message (\"Tree\")."
|
|
12826
13524
|
},
|
|
12827
13525
|
{
|
|
12828
13526
|
"name": "emptyText",
|
|
12829
|
-
"type": "string",
|
|
12830
|
-
"default":
|
|
12831
|
-
"description": "Text shown when the tree is empty."
|
|
13527
|
+
"type": "string|null",
|
|
13528
|
+
"default": null,
|
|
13529
|
+
"description": "Text shown when the tree is empty, by default the `tree.noItems` message (\"Nothing to show\"). Null shows none."
|
|
12832
13530
|
},
|
|
12833
13531
|
{
|
|
12834
13532
|
"name": "height",
|
|
@@ -13016,6 +13714,68 @@
|
|
|
13016
13714
|
"events": [],
|
|
13017
13715
|
"methods": []
|
|
13018
13716
|
},
|
|
13717
|
+
"UiMessageStream": {
|
|
13718
|
+
"options": [
|
|
13719
|
+
{
|
|
13720
|
+
"name": "runStatus",
|
|
13721
|
+
"type": "RunStatus|null",
|
|
13722
|
+
"default": "null",
|
|
13723
|
+
"description": "A run status to keep up to date."
|
|
13724
|
+
},
|
|
13725
|
+
{
|
|
13726
|
+
"name": "authors",
|
|
13727
|
+
"type": "Record<string, Author>",
|
|
13728
|
+
"default": "{}",
|
|
13729
|
+
"description": "Who writes; its first author who is not a person is the agent when `agent` is not given."
|
|
13730
|
+
},
|
|
13731
|
+
{
|
|
13732
|
+
"name": "agent",
|
|
13733
|
+
"type": "string|null",
|
|
13734
|
+
"default": "null",
|
|
13735
|
+
"description": "Author key of the assistant's output."
|
|
13736
|
+
},
|
|
13737
|
+
{
|
|
13738
|
+
"name": "tools",
|
|
13739
|
+
"type": "Record<string, (call: ToolCall) => ThreadItem|null>",
|
|
13740
|
+
"default": "{}",
|
|
13741
|
+
"description": "Tiles by tool name: the application's renderer for a tool's calls, called at each status change. Its item joins the thread as `tool:<toolCallId>`, and the call's step links to it."
|
|
13742
|
+
},
|
|
13743
|
+
{
|
|
13744
|
+
"name": "showReasoning",
|
|
13745
|
+
"type": "boolean",
|
|
13746
|
+
"default": "false",
|
|
13747
|
+
"description": "Shows the model's reasoning text. Without it the text is not kept, and the reasoning is one step that says how long it took."
|
|
13748
|
+
}
|
|
13749
|
+
],
|
|
13750
|
+
"events": [
|
|
13751
|
+
{
|
|
13752
|
+
"name": "approval",
|
|
13753
|
+
"payload": null,
|
|
13754
|
+
"description": "The person decided. The application sends the answer with its next request."
|
|
13755
|
+
},
|
|
13756
|
+
{
|
|
13757
|
+
"name": "data",
|
|
13758
|
+
"payload": null,
|
|
13759
|
+
"description": "A `data-<name>` part. With an `id` it replaces the earlier value of that name and id. What went out here stays with the application: a `reset-step` takes back what was drawn, not what was delivered."
|
|
13760
|
+
},
|
|
13761
|
+
{
|
|
13762
|
+
"name": "metadata",
|
|
13763
|
+
"payload": null,
|
|
13764
|
+
"description": "Metadata of the message."
|
|
13765
|
+
},
|
|
13766
|
+
{
|
|
13767
|
+
"name": "unknown",
|
|
13768
|
+
"payload": null,
|
|
13769
|
+
"description": "A part the adapter does not draw."
|
|
13770
|
+
},
|
|
13771
|
+
{
|
|
13772
|
+
"name": "error",
|
|
13773
|
+
"payload": null,
|
|
13774
|
+
"description": "A part out of order, or a tile that failed."
|
|
13775
|
+
}
|
|
13776
|
+
],
|
|
13777
|
+
"methods": []
|
|
13778
|
+
},
|
|
13019
13779
|
"UploadTransport": {
|
|
13020
13780
|
"options": [
|
|
13021
13781
|
{
|
|
@@ -13058,6 +13818,18 @@
|
|
|
13058
13818
|
"events": [],
|
|
13059
13819
|
"methods": []
|
|
13060
13820
|
},
|
|
13821
|
+
"Upsert": {
|
|
13822
|
+
"options": [
|
|
13823
|
+
{
|
|
13824
|
+
"name": "after",
|
|
13825
|
+
"type": "string|null",
|
|
13826
|
+
"default": "null",
|
|
13827
|
+
"description": "The id of the item to insert the new item right after; the end of the thread when null or unknown. An item already in the thread stays where it is."
|
|
13828
|
+
}
|
|
13829
|
+
],
|
|
13830
|
+
"events": [],
|
|
13831
|
+
"methods": []
|
|
13832
|
+
},
|
|
13061
13833
|
"ValueList": {
|
|
13062
13834
|
"options": [
|
|
13063
13835
|
{
|