@zeyos/zx 5.6.0 → 5.7.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.
- package/CHANGELOG.md +154 -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/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/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/multi-value-editor/multi-value-editor.d.ts +3 -2
- package/dist/types/components/number-field/number-field.d.ts +17 -6
- 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/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 +1 -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 +16802 -15180
- 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 +498 -134
- package/dist/zx.esm.js +40778 -29654
- package/dist/zx.esm.min.js +36 -23
- package/dist/zx.global.js +40778 -29654
- package/dist/zx.global.min.js +36 -23
- package/dist/zx.layered.css +17302 -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 +851 -121
- package/docs/llms.md +1018 -71
- 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/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/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 +1 -1
- 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/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 +29 -13
- 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/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 +22 -2
- package/src/core/format.js +15 -13
- package/src/core/http.js +29 -20
- package/src/core/i18n.js +83 -10
- 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/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",
|
|
@@ -2928,9 +3038,9 @@
|
|
|
2928
3038
|
},
|
|
2929
3039
|
{
|
|
2930
3040
|
"name": "label",
|
|
2931
|
-
"type": "string",
|
|
2932
|
-
"default": "
|
|
2933
|
-
"description": "Accessible editor label."
|
|
3041
|
+
"type": "string|null",
|
|
3042
|
+
"default": "null",
|
|
3043
|
+
"description": "Accessible editor label; null reads the `codeEditor.label` message (\"Code editor\")."
|
|
2934
3044
|
},
|
|
2935
3045
|
{
|
|
2936
3046
|
"name": "placeholder",
|
|
@@ -3034,6 +3144,18 @@
|
|
|
3034
3144
|
"default": "false",
|
|
3035
3145
|
"description": "Whether an agent is working: Send becomes Stop."
|
|
3036
3146
|
},
|
|
3147
|
+
{
|
|
3148
|
+
"name": "queue",
|
|
3149
|
+
"type": "boolean",
|
|
3150
|
+
"default": "false",
|
|
3151
|
+
"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."
|
|
3152
|
+
},
|
|
3153
|
+
{
|
|
3154
|
+
"name": "queueLimit",
|
|
3155
|
+
"type": "number",
|
|
3156
|
+
"default": "10",
|
|
3157
|
+
"description": "Most messages that wait at once. At the limit the send key is refused, and the hint says why."
|
|
3158
|
+
},
|
|
3037
3159
|
{
|
|
3038
3160
|
"name": "disabled",
|
|
3039
3161
|
"type": "boolean",
|
|
@@ -3134,7 +3256,7 @@
|
|
|
3134
3256
|
"events": [
|
|
3135
3257
|
{
|
|
3136
3258
|
"name": "send",
|
|
3137
|
-
"payload": "{text, files, mentions, context}",
|
|
3259
|
+
"payload": "{text, files, mentions, context, queued}",
|
|
3138
3260
|
"description": "Preventable send listener."
|
|
3139
3261
|
},
|
|
3140
3262
|
{
|
|
@@ -3172,6 +3294,16 @@
|
|
|
3172
3294
|
"payload": "{id, tool}",
|
|
3173
3295
|
"description": "Tool listener."
|
|
3174
3296
|
},
|
|
3297
|
+
{
|
|
3298
|
+
"name": "queue",
|
|
3299
|
+
"payload": "{item, items}",
|
|
3300
|
+
"description": "Listener for a message being queued."
|
|
3301
|
+
},
|
|
3302
|
+
{
|
|
3303
|
+
"name": "dequeue",
|
|
3304
|
+
"payload": "{item, items, reason}",
|
|
3305
|
+
"description": "Listener for a message leaving the queue."
|
|
3306
|
+
},
|
|
3175
3307
|
{
|
|
3176
3308
|
"name": "historyprevious",
|
|
3177
3309
|
"payload": "Record<string, never>",
|
|
@@ -3207,7 +3339,7 @@
|
|
|
3207
3339
|
"name": "setBusy",
|
|
3208
3340
|
"signature": "setBusy(busy)",
|
|
3209
3341
|
"returns": "this",
|
|
3210
|
-
"description": "Shows Stop in place of Send while an agent works; Escape in the text then emits `stop`."
|
|
3342
|
+
"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
3343
|
},
|
|
3212
3344
|
{
|
|
3213
3345
|
"name": "setHint",
|
|
@@ -3263,11 +3395,23 @@
|
|
|
3263
3395
|
"returns": "this",
|
|
3264
3396
|
"description": "Removes a context chip. Emits nothing."
|
|
3265
3397
|
},
|
|
3398
|
+
{
|
|
3399
|
+
"name": "clearQueue",
|
|
3400
|
+
"signature": "clearQueue()",
|
|
3401
|
+
"returns": "this",
|
|
3402
|
+
"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."
|
|
3403
|
+
},
|
|
3404
|
+
{
|
|
3405
|
+
"name": "removeQueued",
|
|
3406
|
+
"signature": "removeQueued(id)",
|
|
3407
|
+
"returns": "this",
|
|
3408
|
+
"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."
|
|
3409
|
+
},
|
|
3266
3410
|
{
|
|
3267
3411
|
"name": "destroy",
|
|
3268
3412
|
"signature": "destroy()",
|
|
3269
3413
|
"returns": "void",
|
|
3270
|
-
"description": "Removes what the composer drew and the launcher it opened, and stops listening."
|
|
3414
|
+
"description": "Removes what the composer drew and the launcher it opened, drops the queue, and stops listening."
|
|
3271
3415
|
}
|
|
3272
3416
|
]
|
|
3273
3417
|
},
|
|
@@ -3406,15 +3550,15 @@
|
|
|
3406
3550
|
},
|
|
3407
3551
|
{
|
|
3408
3552
|
"name": "title",
|
|
3409
|
-
"type": "string",
|
|
3410
|
-
"default":
|
|
3411
|
-
"description": "Accessible name, and the native tooltip on the icon-only form."
|
|
3553
|
+
"type": "string|null",
|
|
3554
|
+
"default": null,
|
|
3555
|
+
"description": "Accessible name, and the native tooltip on the icon-only form; by default the `copy.copy` message (\"Copy\"). Null gives none."
|
|
3412
3556
|
},
|
|
3413
3557
|
{
|
|
3414
3558
|
"name": "feedback",
|
|
3415
|
-
"type": "string",
|
|
3416
|
-
"default":
|
|
3417
|
-
"description": "Confirmation announced and shown after a copy."
|
|
3559
|
+
"type": "string|null",
|
|
3560
|
+
"default": null,
|
|
3561
|
+
"description": "Confirmation announced and shown after a copy; by default the `copy.copied` message (\"Copied\"). Null says nothing."
|
|
3418
3562
|
},
|
|
3419
3563
|
{
|
|
3420
3564
|
"name": "feedbackDuration",
|
|
@@ -3466,15 +3610,15 @@
|
|
|
3466
3610
|
},
|
|
3467
3611
|
{
|
|
3468
3612
|
"name": "feedback",
|
|
3469
|
-
"type": "string",
|
|
3470
|
-
"default":
|
|
3471
|
-
"description": "Confirmation shown after a copy."
|
|
3613
|
+
"type": "string|null",
|
|
3614
|
+
"default": null,
|
|
3615
|
+
"description": "Confirmation shown after a copy, by default the `copy.copied` message (\"Copied\"). Null says nothing."
|
|
3472
3616
|
},
|
|
3473
3617
|
{
|
|
3474
3618
|
"name": "buttonTitle",
|
|
3475
|
-
"type": "string",
|
|
3476
|
-
"default":
|
|
3477
|
-
"description": "Accessible name of the copy button."
|
|
3619
|
+
"type": "string|null",
|
|
3620
|
+
"default": null,
|
|
3621
|
+
"description": "Accessible name of the copy button, by default the `copy.copy` message (\"Copy\"). Null gives none."
|
|
3478
3622
|
},
|
|
3479
3623
|
{
|
|
3480
3624
|
"name": "size",
|
|
@@ -3517,6 +3661,60 @@
|
|
|
3517
3661
|
}
|
|
3518
3662
|
]
|
|
3519
3663
|
},
|
|
3664
|
+
"CountrySelect": {
|
|
3665
|
+
"options": [
|
|
3666
|
+
{
|
|
3667
|
+
"name": "countries",
|
|
3668
|
+
"type": "Array<string|CountryItem>",
|
|
3669
|
+
"default": null,
|
|
3670
|
+
"description": "The countries to offer. Without it, every ISO 3166-1 country (`COUNTRY_CODES`). A code that is not two letters is left out."
|
|
3671
|
+
},
|
|
3672
|
+
{
|
|
3673
|
+
"name": "preferred",
|
|
3674
|
+
"type": "Array<string|CountryItem>",
|
|
3675
|
+
"default": "[]",
|
|
3676
|
+
"description": "Countries pinned above the list, in the order given and kept through filtering — the markets an application serves, say."
|
|
3677
|
+
},
|
|
3678
|
+
{
|
|
3679
|
+
"name": "preferredLabel",
|
|
3680
|
+
"type": "string|null",
|
|
3681
|
+
"default": "null",
|
|
3682
|
+
"description": "Heading above the pinned countries."
|
|
3683
|
+
},
|
|
3684
|
+
{
|
|
3685
|
+
"name": "displayLocale",
|
|
3686
|
+
"type": "string|null",
|
|
3687
|
+
"default": "null",
|
|
3688
|
+
"description": "The language country names are written in. By default the component's `lang` option, then the library language (`setLanguage()`)."
|
|
3689
|
+
},
|
|
3690
|
+
{
|
|
3691
|
+
"name": "flags",
|
|
3692
|
+
"type": "FlagMode",
|
|
3693
|
+
"default": "'auto'",
|
|
3694
|
+
"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."
|
|
3695
|
+
},
|
|
3696
|
+
{
|
|
3697
|
+
"name": "flagUrl",
|
|
3698
|
+
"type": "string|null",
|
|
3699
|
+
"default": "null",
|
|
3700
|
+
"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."
|
|
3701
|
+
},
|
|
3702
|
+
{
|
|
3703
|
+
"name": "showCode",
|
|
3704
|
+
"type": "boolean",
|
|
3705
|
+
"default": "false",
|
|
3706
|
+
"description": "Shows the ISO code as secondary text."
|
|
3707
|
+
},
|
|
3708
|
+
{
|
|
3709
|
+
"name": "sort",
|
|
3710
|
+
"type": "boolean",
|
|
3711
|
+
"default": "true",
|
|
3712
|
+
"description": "Orders the countries by name in the display language; `false` keeps the order given."
|
|
3713
|
+
}
|
|
3714
|
+
],
|
|
3715
|
+
"events": [],
|
|
3716
|
+
"methods": []
|
|
3717
|
+
},
|
|
3520
3718
|
"DataFilter": {
|
|
3521
3719
|
"options": [
|
|
3522
3720
|
{
|
|
@@ -4296,9 +4494,9 @@
|
|
|
4296
4494
|
},
|
|
4297
4495
|
{
|
|
4298
4496
|
"name": "label",
|
|
4299
|
-
"type": "string",
|
|
4300
|
-
"default": "
|
|
4301
|
-
"description": "Accessible name given to every divider."
|
|
4497
|
+
"type": "string|null",
|
|
4498
|
+
"default": "null",
|
|
4499
|
+
"description": "Accessible name given to every divider; null reads the `dock.resize` message (\"Resize panes\")."
|
|
4302
4500
|
}
|
|
4303
4501
|
],
|
|
4304
4502
|
"events": [
|
|
@@ -4541,6 +4739,42 @@
|
|
|
4541
4739
|
}
|
|
4542
4740
|
]
|
|
4543
4741
|
},
|
|
4742
|
+
"ElicitationHandler": {
|
|
4743
|
+
"options": [
|
|
4744
|
+
{
|
|
4745
|
+
"name": "serverName",
|
|
4746
|
+
"type": "string",
|
|
4747
|
+
"default": null,
|
|
4748
|
+
"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."
|
|
4749
|
+
},
|
|
4750
|
+
{
|
|
4751
|
+
"name": "authors",
|
|
4752
|
+
"type": "Record<string, {name: string}>",
|
|
4753
|
+
"default": "{}",
|
|
4754
|
+
"description": "Display names by key; when it lists `serverName`, that entry's name is shown instead."
|
|
4755
|
+
},
|
|
4756
|
+
{
|
|
4757
|
+
"name": "target",
|
|
4758
|
+
"type": "Element|string|null",
|
|
4759
|
+
"default": "null",
|
|
4760
|
+
"description": "Where the surface goes inline; a Dialog without one."
|
|
4761
|
+
},
|
|
4762
|
+
{
|
|
4763
|
+
"name": "open",
|
|
4764
|
+
"type": "(url: string) => boolean|void",
|
|
4765
|
+
"default": null,
|
|
4766
|
+
"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`."
|
|
4767
|
+
},
|
|
4768
|
+
{
|
|
4769
|
+
"name": "msg",
|
|
4770
|
+
"type": "Record<string, string>|Record<string, Record<string, string>>",
|
|
4771
|
+
"default": null,
|
|
4772
|
+
"description": "Localized messages, flat or by language: the `mcp.*` keys, and the `surface.*` keys of the form."
|
|
4773
|
+
}
|
|
4774
|
+
],
|
|
4775
|
+
"events": [],
|
|
4776
|
+
"methods": []
|
|
4777
|
+
},
|
|
4544
4778
|
"EmptyState": {
|
|
4545
4779
|
"options": [
|
|
4546
4780
|
{
|
|
@@ -4641,9 +4875,9 @@
|
|
|
4641
4875
|
},
|
|
4642
4876
|
{
|
|
4643
4877
|
"name": "actionsLabel",
|
|
4644
|
-
"type": "string",
|
|
4645
|
-
"default": "
|
|
4646
|
-
"description": "Accessible name for secondary actions."
|
|
4878
|
+
"type": "string|null",
|
|
4879
|
+
"default": "null",
|
|
4880
|
+
"description": "Accessible name for secondary actions; null reads the `entityRef.actions` message (\"Entity actions\")."
|
|
4647
4881
|
}
|
|
4648
4882
|
],
|
|
4649
4883
|
"events": [
|
|
@@ -4713,9 +4947,9 @@
|
|
|
4713
4947
|
},
|
|
4714
4948
|
{
|
|
4715
4949
|
"name": "recentLabel",
|
|
4716
|
-
"type": "string",
|
|
4717
|
-
"default":
|
|
4718
|
-
"description": "Heading above recent choices."
|
|
4950
|
+
"type": "string|null",
|
|
4951
|
+
"default": null,
|
|
4952
|
+
"description": "Heading above recent choices, by default the `select.recent` message (\"Recent\"); null shows none."
|
|
4719
4953
|
},
|
|
4720
4954
|
{
|
|
4721
4955
|
"name": "create",
|
|
@@ -5251,9 +5485,9 @@
|
|
|
5251
5485
|
},
|
|
5252
5486
|
{
|
|
5253
5487
|
"name": "actionsLabel",
|
|
5254
|
-
"type": "string",
|
|
5255
|
-
"default": "
|
|
5256
|
-
"description": "Accessible name for secondary actions."
|
|
5488
|
+
"type": "string|null",
|
|
5489
|
+
"default": "null",
|
|
5490
|
+
"description": "Accessible name for secondary actions; null reads the `fileItem.actions` message (\"File actions\")."
|
|
5257
5491
|
},
|
|
5258
5492
|
{
|
|
5259
5493
|
"name": "locale",
|
|
@@ -5323,9 +5557,9 @@
|
|
|
5323
5557
|
},
|
|
5324
5558
|
{
|
|
5325
5559
|
"name": "label",
|
|
5326
|
-
"type": "string",
|
|
5327
|
-
"default": "
|
|
5328
|
-
"description": "Accessible collection name."
|
|
5560
|
+
"type": "string|null",
|
|
5561
|
+
"default": "null",
|
|
5562
|
+
"description": "Accessible collection name; null reads the `fileList.label` message (\"Files\")."
|
|
5329
5563
|
},
|
|
5330
5564
|
{
|
|
5331
5565
|
"name": "loading",
|
|
@@ -5341,15 +5575,15 @@
|
|
|
5341
5575
|
},
|
|
5342
5576
|
{
|
|
5343
5577
|
"name": "loadingText",
|
|
5344
|
-
"type": "string",
|
|
5345
|
-
"default":
|
|
5346
|
-
"description": "Loading status text."
|
|
5578
|
+
"type": "string|null",
|
|
5579
|
+
"default": null,
|
|
5580
|
+
"description": "Loading status text, by default the `fileList.loading` message (\"Loading files\"). Null shows none."
|
|
5347
5581
|
},
|
|
5348
5582
|
{
|
|
5349
5583
|
"name": "emptyText",
|
|
5350
5584
|
"type": "string|number|Node|Component|null",
|
|
5351
|
-
"default":
|
|
5352
|
-
"description": "Empty-state content."
|
|
5585
|
+
"default": null,
|
|
5586
|
+
"description": "Empty-state content, by default the `fileList.empty` message (\"No files\"). Null shows none."
|
|
5353
5587
|
}
|
|
5354
5588
|
],
|
|
5355
5589
|
"events": [
|
|
@@ -5798,9 +6032,9 @@
|
|
|
5798
6032
|
},
|
|
5799
6033
|
{
|
|
5800
6034
|
"name": "emptyText",
|
|
5801
|
-
"type": "string",
|
|
5802
|
-
"default":
|
|
5803
|
-
"description": "Text shown in an empty column."
|
|
6035
|
+
"type": "string|null",
|
|
6036
|
+
"default": null,
|
|
6037
|
+
"description": "Text shown in an empty column, by default the `finder.noItems` message (\"Empty\"). Null shows none."
|
|
5804
6038
|
},
|
|
5805
6039
|
{
|
|
5806
6040
|
"name": "msg",
|
|
@@ -5877,6 +6111,36 @@
|
|
|
5877
6111
|
}
|
|
5878
6112
|
]
|
|
5879
6113
|
},
|
|
6114
|
+
"Flag": {
|
|
6115
|
+
"options": [
|
|
6116
|
+
{
|
|
6117
|
+
"name": "kind",
|
|
6118
|
+
"type": "FlagKind",
|
|
6119
|
+
"default": "'auto'",
|
|
6120
|
+
"description": "Drawing; `src` implies `image`."
|
|
6121
|
+
},
|
|
6122
|
+
{
|
|
6123
|
+
"name": "src",
|
|
6124
|
+
"type": "string|null",
|
|
6125
|
+
"default": "null",
|
|
6126
|
+
"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."
|
|
6127
|
+
},
|
|
6128
|
+
{
|
|
6129
|
+
"name": "text",
|
|
6130
|
+
"type": "string|null",
|
|
6131
|
+
"default": "null",
|
|
6132
|
+
"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."
|
|
6133
|
+
},
|
|
6134
|
+
{
|
|
6135
|
+
"name": "label",
|
|
6136
|
+
"type": "string|null",
|
|
6137
|
+
"default": "null",
|
|
6138
|
+
"description": "Accessible name. Without one the flag is decorative (`aria-hidden`) and must sit beside text that names the country or language."
|
|
6139
|
+
}
|
|
6140
|
+
],
|
|
6141
|
+
"events": [],
|
|
6142
|
+
"methods": []
|
|
6143
|
+
},
|
|
5880
6144
|
"Form": {
|
|
5881
6145
|
"options": [
|
|
5882
6146
|
{
|
|
@@ -6135,6 +6399,34 @@
|
|
|
6135
6399
|
}
|
|
6136
6400
|
]
|
|
6137
6401
|
},
|
|
6402
|
+
"InlineSplitter": {
|
|
6403
|
+
"options": [
|
|
6404
|
+
{
|
|
6405
|
+
"name": "maxLine",
|
|
6406
|
+
"type": "number",
|
|
6407
|
+
"default": "262144",
|
|
6408
|
+
"description": "Longest line inside a fence."
|
|
6409
|
+
}
|
|
6410
|
+
],
|
|
6411
|
+
"events": [
|
|
6412
|
+
{
|
|
6413
|
+
"name": "text",
|
|
6414
|
+
"payload": null,
|
|
6415
|
+
"description": "Receives prose, as it arrives, unchanged."
|
|
6416
|
+
},
|
|
6417
|
+
{
|
|
6418
|
+
"name": "line",
|
|
6419
|
+
"payload": null,
|
|
6420
|
+
"description": "Receives each line inside a surface fence."
|
|
6421
|
+
},
|
|
6422
|
+
{
|
|
6423
|
+
"name": "error",
|
|
6424
|
+
"payload": null,
|
|
6425
|
+
"description": "Receives an over-long line inside a fence and a fence still open at `end()`."
|
|
6426
|
+
}
|
|
6427
|
+
],
|
|
6428
|
+
"methods": []
|
|
6429
|
+
},
|
|
6138
6430
|
"KanbanView": {
|
|
6139
6431
|
"options": [
|
|
6140
6432
|
{
|
|
@@ -6465,7 +6757,7 @@
|
|
|
6465
6757
|
"name": "labels",
|
|
6466
6758
|
"type": "Record<string,string>",
|
|
6467
6759
|
"default": "{}",
|
|
6468
|
-
"description": "
|
|
6760
|
+
"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
6761
|
},
|
|
6470
6762
|
{
|
|
6471
6763
|
"name": "columnOrder",
|
|
@@ -6511,9 +6803,9 @@
|
|
|
6511
6803
|
},
|
|
6512
6804
|
{
|
|
6513
6805
|
"name": "label",
|
|
6514
|
-
"type": "string",
|
|
6515
|
-
"default":
|
|
6516
|
-
"description": "Accessible board label."
|
|
6806
|
+
"type": "string|null",
|
|
6807
|
+
"default": null,
|
|
6808
|
+
"description": "Accessible board label, by default the `kanbanView.label` message (\"Kanban board\"). Null leaves the board unnamed."
|
|
6517
6809
|
}
|
|
6518
6810
|
],
|
|
6519
6811
|
"events": [
|
|
@@ -7009,6 +7301,24 @@
|
|
|
7009
7301
|
"events": [],
|
|
7010
7302
|
"methods": []
|
|
7011
7303
|
},
|
|
7304
|
+
"LineSplitter": {
|
|
7305
|
+
"options": [
|
|
7306
|
+
{
|
|
7307
|
+
"name": "maxLine",
|
|
7308
|
+
"type": "number",
|
|
7309
|
+
"default": "262144",
|
|
7310
|
+
"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."
|
|
7311
|
+
}
|
|
7312
|
+
],
|
|
7313
|
+
"events": [
|
|
7314
|
+
{
|
|
7315
|
+
"name": "error",
|
|
7316
|
+
"payload": null,
|
|
7317
|
+
"description": "Receives an over-long line's report."
|
|
7318
|
+
}
|
|
7319
|
+
],
|
|
7320
|
+
"methods": []
|
|
7321
|
+
},
|
|
7012
7322
|
"ListToolbar": {
|
|
7013
7323
|
"options": [
|
|
7014
7324
|
{
|
|
@@ -7182,6 +7492,66 @@
|
|
|
7182
7492
|
}
|
|
7183
7493
|
]
|
|
7184
7494
|
},
|
|
7495
|
+
"LocaleSelect": {
|
|
7496
|
+
"options": [
|
|
7497
|
+
{
|
|
7498
|
+
"name": "locales",
|
|
7499
|
+
"type": "Array<string|LocaleItem>",
|
|
7500
|
+
"default": null,
|
|
7501
|
+
"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."
|
|
7502
|
+
},
|
|
7503
|
+
{
|
|
7504
|
+
"name": "preferred",
|
|
7505
|
+
"type": "Array<string|LocaleItem>",
|
|
7506
|
+
"default": "[]",
|
|
7507
|
+
"description": "Locales pinned above the list, kept through filtering — the application's own languages above a long list, say."
|
|
7508
|
+
},
|
|
7509
|
+
{
|
|
7510
|
+
"name": "preferredLabel",
|
|
7511
|
+
"type": "string|null",
|
|
7512
|
+
"default": "null",
|
|
7513
|
+
"description": "Heading above the pinned locales."
|
|
7514
|
+
},
|
|
7515
|
+
{
|
|
7516
|
+
"name": "displayLocale",
|
|
7517
|
+
"type": "string|null",
|
|
7518
|
+
"default": "null",
|
|
7519
|
+
"description": "The language the secondary name is written in. By default the component's `lang` option, then the library language (`setLanguage()`)."
|
|
7520
|
+
},
|
|
7521
|
+
{
|
|
7522
|
+
"name": "display",
|
|
7523
|
+
"type": "'both'|'native'|'localized'",
|
|
7524
|
+
"default": "'both'",
|
|
7525
|
+
"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."
|
|
7526
|
+
},
|
|
7527
|
+
{
|
|
7528
|
+
"name": "flags",
|
|
7529
|
+
"type": "FlagMode",
|
|
7530
|
+
"default": "'auto'",
|
|
7531
|
+
"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."
|
|
7532
|
+
},
|
|
7533
|
+
{
|
|
7534
|
+
"name": "flagUrl",
|
|
7535
|
+
"type": "string|null",
|
|
7536
|
+
"default": "null",
|
|
7537
|
+
"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."
|
|
7538
|
+
},
|
|
7539
|
+
{
|
|
7540
|
+
"name": "flagRegions",
|
|
7541
|
+
"type": "Record<string, string|null>",
|
|
7542
|
+
"default": "{}",
|
|
7543
|
+
"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."
|
|
7544
|
+
},
|
|
7545
|
+
{
|
|
7546
|
+
"name": "sort",
|
|
7547
|
+
"type": "boolean",
|
|
7548
|
+
"default": "false",
|
|
7549
|
+
"description": "Orders the locales by label rather than as given."
|
|
7550
|
+
}
|
|
7551
|
+
],
|
|
7552
|
+
"events": [],
|
|
7553
|
+
"methods": []
|
|
7554
|
+
},
|
|
7185
7555
|
"MasterPanel": {
|
|
7186
7556
|
"options": [
|
|
7187
7557
|
{
|
|
@@ -7845,9 +8215,9 @@
|
|
|
7845
8215
|
},
|
|
7846
8216
|
{
|
|
7847
8217
|
"name": "addLabel",
|
|
7848
|
-
"type": "string",
|
|
7849
|
-
"default": "
|
|
7850
|
-
"description": "Add-row button text."
|
|
8218
|
+
"type": "string|null",
|
|
8219
|
+
"default": "null",
|
|
8220
|
+
"description": "Add-row button text; null reads the `multiValueEditor.add` message (\"Add value\")."
|
|
7851
8221
|
},
|
|
7852
8222
|
{
|
|
7853
8223
|
"name": "reorder",
|
|
@@ -8059,7 +8429,7 @@
|
|
|
8059
8429
|
"name": "locale",
|
|
8060
8430
|
"type": "string|null",
|
|
8061
8431
|
"default": "null",
|
|
8062
|
-
"description": "Locale for formatting; defaults to the
|
|
8432
|
+
"description": "Locale for formatting; defaults to the active language."
|
|
8063
8433
|
},
|
|
8064
8434
|
{
|
|
8065
8435
|
"name": "msg",
|
|
@@ -8612,6 +8982,61 @@
|
|
|
8612
8982
|
"events": [],
|
|
8613
8983
|
"methods": []
|
|
8614
8984
|
},
|
|
8985
|
+
"PromptStarters": {
|
|
8986
|
+
"options": [
|
|
8987
|
+
{
|
|
8988
|
+
"name": "items",
|
|
8989
|
+
"type": "PromptStarter[]",
|
|
8990
|
+
"default": "[]",
|
|
8991
|
+
"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`."
|
|
8992
|
+
},
|
|
8993
|
+
{
|
|
8994
|
+
"name": "label",
|
|
8995
|
+
"type": "string|null",
|
|
8996
|
+
"default": "null",
|
|
8997
|
+
"description": "Accessible name of the group. Omitted resolves `promptStarters.label`, English `Suggestions`."
|
|
8998
|
+
},
|
|
8999
|
+
{
|
|
9000
|
+
"name": "columns",
|
|
9001
|
+
"type": "'auto'|1|2",
|
|
9002
|
+
"default": "'auto'",
|
|
9003
|
+
"description": "Columns of starters. `'auto'` is two, and one in a container narrower than 32rem."
|
|
9004
|
+
},
|
|
9005
|
+
{
|
|
9006
|
+
"name": "headingLevel",
|
|
9007
|
+
"type": "1|2|3|4|5|6|null",
|
|
9008
|
+
"default": "null",
|
|
9009
|
+
"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."
|
|
9010
|
+
},
|
|
9011
|
+
{
|
|
9012
|
+
"name": "msg",
|
|
9013
|
+
"type": "Record<string, string>|Record<string, Record<string, string>>",
|
|
9014
|
+
"default": null,
|
|
9015
|
+
"description": "Localized messages."
|
|
9016
|
+
}
|
|
9017
|
+
],
|
|
9018
|
+
"events": [
|
|
9019
|
+
{
|
|
9020
|
+
"name": "pick",
|
|
9021
|
+
"payload": "{item: PromptStarter}",
|
|
9022
|
+
"description": "Listener for a starter being picked."
|
|
9023
|
+
}
|
|
9024
|
+
],
|
|
9025
|
+
"methods": [
|
|
9026
|
+
{
|
|
9027
|
+
"name": "setItems",
|
|
9028
|
+
"signature": "setItems(items)",
|
|
9029
|
+
"returns": "this",
|
|
9030
|
+
"description": "Replaces the starters. The focus on a starter stays on the starter with the same `id`. Emits nothing."
|
|
9031
|
+
},
|
|
9032
|
+
{
|
|
9033
|
+
"name": "destroy",
|
|
9034
|
+
"signature": "destroy()",
|
|
9035
|
+
"returns": "void",
|
|
9036
|
+
"description": "Removes what was drawn and stops listening."
|
|
9037
|
+
}
|
|
9038
|
+
]
|
|
9039
|
+
},
|
|
8615
9040
|
"ProseAnchors": {
|
|
8616
9041
|
"options": [
|
|
8617
9042
|
{
|
|
@@ -8622,21 +9047,21 @@
|
|
|
8622
9047
|
},
|
|
8623
9048
|
{
|
|
8624
9049
|
"name": "label",
|
|
8625
|
-
"type": "string",
|
|
8626
|
-
"default":
|
|
8627
|
-
"description": "The link's accessible name; `%1` is the heading."
|
|
9050
|
+
"type": "string|null",
|
|
9051
|
+
"default": null,
|
|
9052
|
+
"description": "The link's accessible name; `%1` is the heading. By default the `prose.copyLinkTo` message (\"Copy link to %1\"). Null gives none."
|
|
8628
9053
|
},
|
|
8629
9054
|
{
|
|
8630
9055
|
"name": "title",
|
|
8631
|
-
"type": "string",
|
|
8632
|
-
"default":
|
|
8633
|
-
"description": "The link's tooltip."
|
|
9056
|
+
"type": "string|null",
|
|
9057
|
+
"default": null,
|
|
9058
|
+
"description": "The link's tooltip, by default the `prose.copyLink` message (\"Copy link\"). Null gives none."
|
|
8634
9059
|
},
|
|
8635
9060
|
{
|
|
8636
9061
|
"name": "feedback",
|
|
8637
|
-
"type": "string",
|
|
8638
|
-
"default":
|
|
8639
|
-
"description": "What the live region says after a copy."
|
|
9062
|
+
"type": "string|null",
|
|
9063
|
+
"default": null,
|
|
9064
|
+
"description": "What the live region says after a copy, by default the `prose.copied` message (\"Link copied\"). Null says nothing."
|
|
8640
9065
|
},
|
|
8641
9066
|
{
|
|
8642
9067
|
"name": "feedbackDuration",
|
|
@@ -8900,9 +9325,9 @@
|
|
|
8900
9325
|
},
|
|
8901
9326
|
{
|
|
8902
9327
|
"name": "label",
|
|
8903
|
-
"type": "string",
|
|
8904
|
-
"default": "
|
|
8905
|
-
"description": "Accessible name of the group."
|
|
9328
|
+
"type": "string|null",
|
|
9329
|
+
"default": "null",
|
|
9330
|
+
"description": "Accessible name of the group; null reads the `rating.label` message (\"Rating\")."
|
|
8906
9331
|
},
|
|
8907
9332
|
{
|
|
8908
9333
|
"name": "icon",
|
|
@@ -9998,6 +10423,30 @@
|
|
|
9998
10423
|
"returns": "this",
|
|
9999
10424
|
"description": "Moves focus to the combobox input."
|
|
10000
10425
|
},
|
|
10426
|
+
{
|
|
10427
|
+
"name": "locale",
|
|
10428
|
+
"signature": "locale(target, [options])",
|
|
10429
|
+
"returns": "Select",
|
|
10430
|
+
"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."
|
|
10431
|
+
},
|
|
10432
|
+
{
|
|
10433
|
+
"name": "localeItems",
|
|
10434
|
+
"signature": "localeItems(locales, [options])",
|
|
10435
|
+
"returns": "ReturnType<typeof localeItems>",
|
|
10436
|
+
"description": "Builds locale items without the DOM, for lists and summaries using the same names."
|
|
10437
|
+
},
|
|
10438
|
+
{
|
|
10439
|
+
"name": "country",
|
|
10440
|
+
"signature": "country(target, [options])",
|
|
10441
|
+
"returns": "Select",
|
|
10442
|
+
"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."
|
|
10443
|
+
},
|
|
10444
|
+
{
|
|
10445
|
+
"name": "countryItems",
|
|
10446
|
+
"signature": "countryItems([countries], [options])",
|
|
10447
|
+
"returns": "ReturnType<typeof countryItems>",
|
|
10448
|
+
"description": "Builds country items without the DOM, defaulting to the ISO country catalogue."
|
|
10449
|
+
},
|
|
10001
10450
|
{
|
|
10002
10451
|
"name": "priority",
|
|
10003
10452
|
"signature": "priority(target, [options])",
|
|
@@ -10601,9 +11050,9 @@
|
|
|
10601
11050
|
},
|
|
10602
11051
|
{
|
|
10603
11052
|
"name": "label",
|
|
10604
|
-
"type": "string",
|
|
10605
|
-
"default":
|
|
10606
|
-
"description": "Accessible field label and direction-name prefix."
|
|
11053
|
+
"type": "string|null",
|
|
11054
|
+
"default": null,
|
|
11055
|
+
"description": "Accessible field label and direction-name prefix, by default the `sortControl.label` message (\"Sort by\"). Null gives neither."
|
|
10607
11056
|
},
|
|
10608
11057
|
{
|
|
10609
11058
|
"name": "labels",
|
|
@@ -10674,9 +11123,9 @@
|
|
|
10674
11123
|
},
|
|
10675
11124
|
{
|
|
10676
11125
|
"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
|
|
11126
|
+
"type": "string|null",
|
|
11127
|
+
"default": null,
|
|
11128
|
+
"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
11129
|
},
|
|
10681
11130
|
{
|
|
10682
11131
|
"name": "layout",
|
|
@@ -10825,9 +11274,9 @@
|
|
|
10825
11274
|
},
|
|
10826
11275
|
{
|
|
10827
11276
|
"name": "label",
|
|
10828
|
-
"type": "string",
|
|
10829
|
-
"default": "
|
|
10830
|
-
"description": "Accessible name of the divider."
|
|
11277
|
+
"type": "string|null",
|
|
11278
|
+
"default": "null",
|
|
11279
|
+
"description": "Accessible name of the divider; null reads the `splitView.resize` message (\"Resize panes\")."
|
|
10831
11280
|
}
|
|
10832
11281
|
],
|
|
10833
11282
|
"events": [
|
|
@@ -11271,6 +11720,201 @@
|
|
|
11271
11720
|
}
|
|
11272
11721
|
]
|
|
11273
11722
|
},
|
|
11723
|
+
"Surface": {
|
|
11724
|
+
"options": [
|
|
11725
|
+
{
|
|
11726
|
+
"name": "document",
|
|
11727
|
+
"type": "SurfaceDocument|Record<string, unknown>|null",
|
|
11728
|
+
"default": "null",
|
|
11729
|
+
"description": "A whole surface, as the `show_surface` and `ask_user` tools take it. Leave it out to stream with `apply()` or `write()`."
|
|
11730
|
+
},
|
|
11731
|
+
{
|
|
11732
|
+
"name": "policy",
|
|
11733
|
+
"type": "SurfacePolicy|null",
|
|
11734
|
+
"default": "null",
|
|
11735
|
+
"description": "What each action needs before it replies; every action is allowed when null. Nothing in a surface can lower what it decides."
|
|
11736
|
+
},
|
|
11737
|
+
{
|
|
11738
|
+
"name": "resolve",
|
|
11739
|
+
"type": "SurfaceResolve",
|
|
11740
|
+
"default": "{}",
|
|
11741
|
+
"description": "How records, links and assets are resolved."
|
|
11742
|
+
},
|
|
11743
|
+
{
|
|
11744
|
+
"name": "authors",
|
|
11745
|
+
"type": "Record<string, {name: string}>",
|
|
11746
|
+
"default": "{}",
|
|
11747
|
+
"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."
|
|
11748
|
+
},
|
|
11749
|
+
{
|
|
11750
|
+
"name": "userInitiated",
|
|
11751
|
+
"type": "boolean",
|
|
11752
|
+
"default": "false",
|
|
11753
|
+
"description": "Whether the surface answers the person's latest message; only then may `openSurface()` honour a request for a sheet or a dialog."
|
|
11754
|
+
},
|
|
11755
|
+
{
|
|
11756
|
+
"name": "headingLevel",
|
|
11757
|
+
"type": "2|3|4|5",
|
|
11758
|
+
"default": "3",
|
|
11759
|
+
"description": "The element level of the surface's title; its `heading` nodes go one and two deeper."
|
|
11760
|
+
},
|
|
11761
|
+
{
|
|
11762
|
+
"name": "locale",
|
|
11763
|
+
"type": "string",
|
|
11764
|
+
"default": null,
|
|
11765
|
+
"description": "Locale for numbers and times."
|
|
11766
|
+
},
|
|
11767
|
+
{
|
|
11768
|
+
"name": "catalog",
|
|
11769
|
+
"type": "SurfaceCatalog",
|
|
11770
|
+
"default": "CATALOG",
|
|
11771
|
+
"description": "A catalog narrowed with `narrowCatalog()`; the full one by default. What lies outside it is refused as unknown."
|
|
11772
|
+
},
|
|
11773
|
+
{
|
|
11774
|
+
"name": "token",
|
|
11775
|
+
"type": "string|null",
|
|
11776
|
+
"default": "null",
|
|
11777
|
+
"description": "The application's opaque string, at most 512 characters, copied unchanged into every reply. A surface cannot set it."
|
|
11778
|
+
},
|
|
11779
|
+
{
|
|
11780
|
+
"name": "reply",
|
|
11781
|
+
"type": "SurfaceReply|null",
|
|
11782
|
+
"default": "null",
|
|
11783
|
+
"description": "A reply the surface already gave, for a surface restored from a stored conversation: it starts as its receipt and replies no more."
|
|
11784
|
+
},
|
|
11785
|
+
{
|
|
11786
|
+
"name": "labelledBy",
|
|
11787
|
+
"type": "string|null",
|
|
11788
|
+
"default": "null",
|
|
11789
|
+
"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."
|
|
11790
|
+
},
|
|
11791
|
+
{
|
|
11792
|
+
"name": "chartAdapter",
|
|
11793
|
+
"type": "ChartAdapter|null",
|
|
11794
|
+
"default": "null",
|
|
11795
|
+
"description": "The engine that draws `chart` nodes; without one a chart shows its data table."
|
|
11796
|
+
},
|
|
11797
|
+
{
|
|
11798
|
+
"name": "msg",
|
|
11799
|
+
"type": "Record<string, string>|Record<string, Record<string, string>>",
|
|
11800
|
+
"default": null,
|
|
11801
|
+
"description": "Localized messages."
|
|
11802
|
+
}
|
|
11803
|
+
],
|
|
11804
|
+
"events": [
|
|
11805
|
+
{
|
|
11806
|
+
"name": "reply",
|
|
11807
|
+
"payload": "{reply: SurfaceReply}",
|
|
11808
|
+
"description": "Reply listener."
|
|
11809
|
+
},
|
|
11810
|
+
{
|
|
11811
|
+
"name": "error",
|
|
11812
|
+
"payload": "{errors: SurfaceError[]}",
|
|
11813
|
+
"description": "Error listener."
|
|
11814
|
+
},
|
|
11815
|
+
{
|
|
11816
|
+
"name": "change",
|
|
11817
|
+
"payload": "{name: string, value: unknown}",
|
|
11818
|
+
"description": "Input listener."
|
|
11819
|
+
},
|
|
11820
|
+
{
|
|
11821
|
+
"name": "ready",
|
|
11822
|
+
"payload": "Record<string, never>",
|
|
11823
|
+
"description": "First-render listener."
|
|
11824
|
+
},
|
|
11825
|
+
{
|
|
11826
|
+
"name": "end",
|
|
11827
|
+
"payload": "Record<string, never>",
|
|
11828
|
+
"description": "End-of-surface listener."
|
|
11829
|
+
}
|
|
11830
|
+
],
|
|
11831
|
+
"methods": [
|
|
11832
|
+
{
|
|
11833
|
+
"name": "apply",
|
|
11834
|
+
"signature": "apply(op)",
|
|
11835
|
+
"returns": "this",
|
|
11836
|
+
"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."
|
|
11837
|
+
},
|
|
11838
|
+
{
|
|
11839
|
+
"name": "write",
|
|
11840
|
+
"signature": "write(chunk)",
|
|
11841
|
+
"returns": "this",
|
|
11842
|
+
"description": "Takes a chunk of operation lines, as streamed: every complete line is parsed and applied."
|
|
11843
|
+
},
|
|
11844
|
+
{
|
|
11845
|
+
"name": "end",
|
|
11846
|
+
"signature": "end()",
|
|
11847
|
+
"returns": "this",
|
|
11848
|
+
"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."
|
|
11849
|
+
},
|
|
11850
|
+
{
|
|
11851
|
+
"name": "getValues",
|
|
11852
|
+
"signature": "getValues()",
|
|
11853
|
+
"returns": "Record<string, unknown>",
|
|
11854
|
+
"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}`."
|
|
11855
|
+
},
|
|
11856
|
+
{
|
|
11857
|
+
"name": "getErrors",
|
|
11858
|
+
"signature": "getErrors()",
|
|
11859
|
+
"returns": "SurfaceError[]",
|
|
11860
|
+
"description": "Every problem collected so far, in a shape an application can return to the model."
|
|
11861
|
+
},
|
|
11862
|
+
{
|
|
11863
|
+
"name": "cancel",
|
|
11864
|
+
"signature": "cancel([reason])",
|
|
11865
|
+
"returns": "this",
|
|
11866
|
+
"description": "Closes the surface unanswered: replies `cancel` (`dismiss` for a `show` surface)."
|
|
11867
|
+
},
|
|
11868
|
+
{
|
|
11869
|
+
"name": "supersede",
|
|
11870
|
+
"signature": "supersede()",
|
|
11871
|
+
"returns": "this",
|
|
11872
|
+
"description": "Ends the surface because a newer one takes its place: replies `dismiss` with the reason `superseded`."
|
|
11873
|
+
},
|
|
11874
|
+
{
|
|
11875
|
+
"name": "focus",
|
|
11876
|
+
"signature": "focus()",
|
|
11877
|
+
"returns": "this",
|
|
11878
|
+
"description": "Moves focus to the first control: the first input, else the first enabled action."
|
|
11879
|
+
},
|
|
11880
|
+
{
|
|
11881
|
+
"name": "toDocument",
|
|
11882
|
+
"signature": "toDocument()",
|
|
11883
|
+
"returns": "SurfaceDocument|null",
|
|
11884
|
+
"description": "The surface as it stands, as a document: what was validated, repairs applied and invalid parts dropped. `null` before it began."
|
|
11885
|
+
},
|
|
11886
|
+
{
|
|
11887
|
+
"name": "getReply",
|
|
11888
|
+
"signature": "getReply()",
|
|
11889
|
+
"returns": "SurfaceReply|null",
|
|
11890
|
+
"description": "The reply the surface gave, or `null` while it waits."
|
|
11891
|
+
},
|
|
11892
|
+
{
|
|
11893
|
+
"name": "destroy",
|
|
11894
|
+
"signature": "destroy()",
|
|
11895
|
+
"returns": "void",
|
|
11896
|
+
"description": "Destroys the surface. An unanswered surface replies `dismiss` first, with the reason `destroyed`, so a waiting agent never hangs."
|
|
11897
|
+
}
|
|
11898
|
+
]
|
|
11899
|
+
},
|
|
11900
|
+
"SurfaceText": {
|
|
11901
|
+
"options": [
|
|
11902
|
+
{
|
|
11903
|
+
"name": "msg",
|
|
11904
|
+
"type": "(key: string, ...args: unknown[]) => string",
|
|
11905
|
+
"default": null,
|
|
11906
|
+
"description": "Resolves a message key; English by default (`SURFACE_MESSAGES`)."
|
|
11907
|
+
},
|
|
11908
|
+
{
|
|
11909
|
+
"name": "entities",
|
|
11910
|
+
"type": "Iterable<string>|null",
|
|
11911
|
+
"default": "null",
|
|
11912
|
+
"description": "The record entities the document may name, as the Surface's `resolve.entities`."
|
|
11913
|
+
}
|
|
11914
|
+
],
|
|
11915
|
+
"events": [],
|
|
11916
|
+
"methods": []
|
|
11917
|
+
},
|
|
11274
11918
|
"TabInsert": {
|
|
11275
11919
|
"options": [
|
|
11276
11920
|
{
|
|
@@ -11435,6 +12079,12 @@
|
|
|
11435
12079
|
"default": "false",
|
|
11436
12080
|
"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
12081
|
},
|
|
12082
|
+
{
|
|
12083
|
+
"name": "virtual",
|
|
12084
|
+
"type": "boolean",
|
|
12085
|
+
"default": "false",
|
|
12086
|
+
"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`."
|
|
12087
|
+
},
|
|
11438
12088
|
{
|
|
11439
12089
|
"name": "responsive",
|
|
11440
12090
|
"type": "false|'sm'|'md'|'lg'|'xl'",
|
|
@@ -11850,6 +12500,12 @@
|
|
|
11850
12500
|
"returns": "number",
|
|
11851
12501
|
"description": "How many rows are currently rendered."
|
|
11852
12502
|
},
|
|
12503
|
+
{
|
|
12504
|
+
"name": "reveal",
|
|
12505
|
+
"signature": "reveal(id)",
|
|
12506
|
+
"returns": "boolean",
|
|
12507
|
+
"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."
|
|
12508
|
+
},
|
|
11853
12509
|
{
|
|
11854
12510
|
"name": "addEventListener",
|
|
11855
12511
|
"signature": "addEventListener(type, listener, [options])",
|
|
@@ -12531,9 +13187,9 @@
|
|
|
12531
13187
|
},
|
|
12532
13188
|
{
|
|
12533
13189
|
"name": "label",
|
|
12534
|
-
"type": "string",
|
|
12535
|
-
"default":
|
|
12536
|
-
"description": "Accessible name of the toolbar."
|
|
13190
|
+
"type": "string|null",
|
|
13191
|
+
"default": null,
|
|
13192
|
+
"description": "Accessible name of the toolbar, by default the `toolbar.label` message (\"Toolbar\"). Null gives none."
|
|
12537
13193
|
},
|
|
12538
13194
|
{
|
|
12539
13195
|
"name": "overflow",
|
|
@@ -12543,9 +13199,9 @@
|
|
|
12543
13199
|
},
|
|
12544
13200
|
{
|
|
12545
13201
|
"name": "overflowLabel",
|
|
12546
|
-
"type": "string",
|
|
12547
|
-
"default":
|
|
12548
|
-
"description": "Accessible name of the overflow menu trigger."
|
|
13202
|
+
"type": "string|null",
|
|
13203
|
+
"default": null,
|
|
13204
|
+
"description": "Accessible name of the overflow menu trigger, by default the `toolbar.more` message (\"More\"). Null gives none."
|
|
12549
13205
|
},
|
|
12550
13206
|
{
|
|
12551
13207
|
"name": "dense",
|
|
@@ -12802,9 +13458,9 @@
|
|
|
12802
13458
|
},
|
|
12803
13459
|
{
|
|
12804
13460
|
"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\")."
|
|
13461
|
+
"type": "string|null",
|
|
13462
|
+
"default": "null",
|
|
13463
|
+
"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
13464
|
},
|
|
12809
13465
|
{
|
|
12810
13466
|
"name": "load",
|
|
@@ -12820,15 +13476,15 @@
|
|
|
12820
13476
|
},
|
|
12821
13477
|
{
|
|
12822
13478
|
"name": "label",
|
|
12823
|
-
"type": "string",
|
|
12824
|
-
"default": "
|
|
12825
|
-
"description": "Accessible name of the tree."
|
|
13479
|
+
"type": "string|null",
|
|
13480
|
+
"default": "null",
|
|
13481
|
+
"description": "Accessible name of the tree; null reads the `tree.label` message (\"Tree\")."
|
|
12826
13482
|
},
|
|
12827
13483
|
{
|
|
12828
13484
|
"name": "emptyText",
|
|
12829
|
-
"type": "string",
|
|
12830
|
-
"default":
|
|
12831
|
-
"description": "Text shown when the tree is empty."
|
|
13485
|
+
"type": "string|null",
|
|
13486
|
+
"default": null,
|
|
13487
|
+
"description": "Text shown when the tree is empty, by default the `tree.noItems` message (\"Nothing to show\"). Null shows none."
|
|
12832
13488
|
},
|
|
12833
13489
|
{
|
|
12834
13490
|
"name": "height",
|
|
@@ -13016,6 +13672,68 @@
|
|
|
13016
13672
|
"events": [],
|
|
13017
13673
|
"methods": []
|
|
13018
13674
|
},
|
|
13675
|
+
"UiMessageStream": {
|
|
13676
|
+
"options": [
|
|
13677
|
+
{
|
|
13678
|
+
"name": "runStatus",
|
|
13679
|
+
"type": "RunStatus|null",
|
|
13680
|
+
"default": "null",
|
|
13681
|
+
"description": "A run status to keep up to date."
|
|
13682
|
+
},
|
|
13683
|
+
{
|
|
13684
|
+
"name": "authors",
|
|
13685
|
+
"type": "Record<string, Author>",
|
|
13686
|
+
"default": "{}",
|
|
13687
|
+
"description": "Who writes; its first author who is not a person is the agent when `agent` is not given."
|
|
13688
|
+
},
|
|
13689
|
+
{
|
|
13690
|
+
"name": "agent",
|
|
13691
|
+
"type": "string|null",
|
|
13692
|
+
"default": "null",
|
|
13693
|
+
"description": "Author key of the assistant's output."
|
|
13694
|
+
},
|
|
13695
|
+
{
|
|
13696
|
+
"name": "tools",
|
|
13697
|
+
"type": "Record<string, (call: ToolCall) => ThreadItem|null>",
|
|
13698
|
+
"default": "{}",
|
|
13699
|
+
"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."
|
|
13700
|
+
},
|
|
13701
|
+
{
|
|
13702
|
+
"name": "showReasoning",
|
|
13703
|
+
"type": "boolean",
|
|
13704
|
+
"default": "false",
|
|
13705
|
+
"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."
|
|
13706
|
+
}
|
|
13707
|
+
],
|
|
13708
|
+
"events": [
|
|
13709
|
+
{
|
|
13710
|
+
"name": "approval",
|
|
13711
|
+
"payload": null,
|
|
13712
|
+
"description": "The person decided. The application sends the answer with its next request."
|
|
13713
|
+
},
|
|
13714
|
+
{
|
|
13715
|
+
"name": "data",
|
|
13716
|
+
"payload": null,
|
|
13717
|
+
"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."
|
|
13718
|
+
},
|
|
13719
|
+
{
|
|
13720
|
+
"name": "metadata",
|
|
13721
|
+
"payload": null,
|
|
13722
|
+
"description": "Metadata of the message."
|
|
13723
|
+
},
|
|
13724
|
+
{
|
|
13725
|
+
"name": "unknown",
|
|
13726
|
+
"payload": null,
|
|
13727
|
+
"description": "A part the adapter does not draw."
|
|
13728
|
+
},
|
|
13729
|
+
{
|
|
13730
|
+
"name": "error",
|
|
13731
|
+
"payload": null,
|
|
13732
|
+
"description": "A part out of order, or a tile that failed."
|
|
13733
|
+
}
|
|
13734
|
+
],
|
|
13735
|
+
"methods": []
|
|
13736
|
+
},
|
|
13019
13737
|
"UploadTransport": {
|
|
13020
13738
|
"options": [
|
|
13021
13739
|
{
|
|
@@ -13058,6 +13776,18 @@
|
|
|
13058
13776
|
"events": [],
|
|
13059
13777
|
"methods": []
|
|
13060
13778
|
},
|
|
13779
|
+
"Upsert": {
|
|
13780
|
+
"options": [
|
|
13781
|
+
{
|
|
13782
|
+
"name": "after",
|
|
13783
|
+
"type": "string|null",
|
|
13784
|
+
"default": "null",
|
|
13785
|
+
"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."
|
|
13786
|
+
}
|
|
13787
|
+
],
|
|
13788
|
+
"events": [],
|
|
13789
|
+
"methods": []
|
|
13790
|
+
},
|
|
13061
13791
|
"ValueList": {
|
|
13062
13792
|
"options": [
|
|
13063
13793
|
{
|