@swiftwc/ui 0.0.0-dev.95 → 0.0.0-dev.97

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/generated/client/index.js +7 -7
  2. package/generated/components/alert-dialog.d.ts +1 -1
  3. package/generated/components/alert-dialog.js +1 -1
  4. package/generated/components/content-unavailable.js +11 -11
  5. package/generated/components/date-picker.js +15 -15
  6. package/generated/components/fine-tooltip.d.ts +3 -0
  7. package/generated/components/fine-tooltip.js +5 -1
  8. package/generated/components/image-view.js +3 -2
  9. package/generated/components/label-view.d.ts +4 -0
  10. package/generated/components/label-view.js +11 -7
  11. package/generated/components/labeled-content.d.ts +5 -0
  12. package/generated/components/labeled-content.js +18 -12
  13. package/generated/components/menu-view.js +12 -12
  14. package/generated/components/navigation-title.js +2 -1
  15. package/generated/components/picker-view.d.ts +1 -1
  16. package/generated/components/picker-view.js +51 -50
  17. package/generated/components/progress-view.js +20 -19
  18. package/generated/components/scroll-view.js +14 -14
  19. package/generated/components/section-view.js +11 -11
  20. package/generated/components/table-view.js +34 -34
  21. package/generated/components/text-field.d.ts +2 -0
  22. package/generated/components/text-field.js +13 -11
  23. package/generated/components/toggle-view.js +30 -13
  24. package/generated/components/tool-bar.js +27 -27
  25. package/generated/css/index.css +67 -15
  26. package/generated/events/alert-dialog.d.ts +3 -0
  27. package/generated/events/confirmation-dialog.d.ts +3 -0
  28. package/generated/events/date-picker.d.ts +3 -0
  29. package/generated/events/lifecycle-observer.d.ts +4 -0
  30. package/generated/events/picker-view.d.ts +6 -0
  31. package/generated/events/scroll-view.d.ts +4 -0
  32. package/generated/events/tab-view.d.ts +10 -0
  33. package/generated/events/text-field.d.ts +3 -0
  34. package/generated/events/toggle-view.d.ts +3 -0
  35. package/generated/internal/utils/cash/index.d.ts +4 -3
  36. package/generated/internal/utils/cash/index.js +4 -2
  37. package/generated/internal/utils/ensure-placeholder.js +2 -1
  38. package/generated/morphdom/index.d.ts +4 -2
  39. package/generated/morphdom/index.js +4 -2
  40. package/generated/morphdom/morph.d.ts +2 -2
  41. package/generated/morphdom/morph.js +3 -2
  42. package/generated/morphdom/query-morph.d.ts +2 -2
  43. package/generated/morphdom/query-morph.js +1 -1
  44. package/generated/morphdom/render-to-string.d.ts +12 -0
  45. package/generated/morphdom/render-to-string.js +48 -0
  46. package/generated/morphdom/unsafe-html.d.ts +2 -0
  47. package/generated/morphdom/unsafe-html.js +4 -0
  48. package/generated/tpl/html.js +4 -0
  49. package/generated/tpl/index.d.ts +2 -0
  50. package/generated/tpl/index.js +2 -0
  51. package/generated/tpl/is-template-result.d.ts +3 -0
  52. package/generated/tpl/is-template-result.js +1 -0
  53. package/package.json +1 -1
  54. package/scss/_maps.scss +19 -13
  55. package/scss/base/_root.scss +1 -1
  56. package/scss/components/_picker-view.scss +7 -1
  57. package/scss/components/_scroll-view-toolbars.scss +8 -2
  58. package/scss/components/_toggle-view.scss +2 -1
  59. package/scss/mixins/_index.scss +8 -2
  60. package/scss/placeholders/_lists.scss +27 -1
  61. package/web-components.html-data/en.json +111 -128
  62. package/generated/morphdom/html.d.ts +0 -8
  63. package/generated/morphdom/html.js +0 -37
@@ -9,7 +9,7 @@
9
9
  "url": "https://swiftwc.github.io/ui/web-components/alert-dialog"
10
10
  }
11
11
  ],
12
- "description": ""
12
+ "description": "A dialog that shows a message. Use it from the client module like `void alert('Save failed.')`.\n---\n\n```ts\ninterface AlertDialogSignature {\n Declaration: '<dialog is=\"alert-dialog\"></dialog>'\n}\n\nclass AlertDialog extends HTMLDialogElement<AlertDialogSignature> {}\n\n```\n"
13
13
  },
14
14
  {
15
15
  "name": "body-view",
@@ -19,7 +19,7 @@
19
19
  "url": "https://swiftwc.github.io/ui/web-components/body-view"
20
20
  }
21
21
  ],
22
- "description": "A container view that wraps a scroll view, marking it as a screen your app can navigate to.\n---"
22
+ "description": "A container view that wraps a scroll view, marking it as a screen your app can navigate to.\n---\n\n```ts\ninterface BodyViewSignature {\n Declaration: '<body-view></body-view>'\n}\n\nclass BodyView extends HTMLElement<BodyViewSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'body-view': BodyView\n }\n}\n\n```\n"
23
23
  },
24
24
  {
25
25
  "name": "bordered-button",
@@ -46,7 +46,7 @@
46
46
  "name": "title-key"
47
47
  }
48
48
  ],
49
- "description": "A control that starts an action. Styled with a standard border, adapting to the button’s surroundings.\n---\n\n### **Slots:**\n- **overlay**\n\n### **Examples:**\n**Creating a bordered button:**\n```html\n<button is=\"bordered-button\">\n <label-view system-image=\"hand-tap\" title=\"Tap Me\"></label-view>\n</button>\n\n```"
49
+ "description": "A control that starts an action. Styled with a standard border, adapting to the button’s surroundings.\n---\n\n```ts\ninterface BorderedButtonSignature {\n Declaration: '<button is=\"bordered-button\"></button>'\n\n Attributes: {\n role?: 'destructive' | 'confirm' // A value that describes the purpose of a button\n 'title-key'?: string\n }\n\n Slots: {\n overlay: HTMLElement[]\n }\n}\n\nclass BorderedButton extends HTMLButtonElement<BorderedButtonSignature> {}\n\n```\n\n### **Examples:**\n**Creating a bordered button:**\n```html\n<button is=\"bordered-button\">\n <label-view system-image=\"hand-tap\" title=\"Tap Me\"></label-view>\n</button>\n\n```\n"
50
50
  },
51
51
  {
52
52
  "name": "bordered-prominent-button",
@@ -73,7 +73,7 @@
73
73
  "name": "title-key"
74
74
  }
75
75
  ],
76
- "description": "A control that starts an action. Styled with a prominent border, adapting to the button’s surroundings.\n---\n\n### **Slots:**\n- **overlay**\n\n### **Examples:**\n**Creating a prominent bordered button:**\n```html\n<button is=\"bordered-prominent-button\">\n <label-view system-image=\"hand-tap\" title=\"Tap Me\"></label-view>\n</button>\n\n```"
76
+ "description": "A control that starts an action. Styled with a prominent border, adapting to the button’s surroundings.\n---\n\n```ts\ninterface BorderedProminentButtonSignature {\n Declaration: '<button is=\"bordered-prominent-button\"></button>'\n\n Attributes: {\n role?: 'destructive' | 'confirm' // A value that describes the purpose of a button\n 'title-key'?: string\n }\n\n Slots: {\n overlay: HTMLElement[]\n }\n}\n\nclass BorderedProminentButton extends HTMLButtonElement<BorderedProminentButtonSignature> {}\n\n```\n\n### **Examples:**\n**Creating a prominent bordered button:**\n```html\n<button is=\"bordered-prominent-button\">\n <label-view system-image=\"hand-tap\" title=\"Tap Me\"></label-view>\n</button>\n\n```\n"
77
77
  },
78
78
  {
79
79
  "name": "borderless-button",
@@ -100,7 +100,7 @@
100
100
  "name": "title-key"
101
101
  }
102
102
  ],
103
- "description": "A control that starts an action. Styled without any borders.\n---\n\n### **Slots:**\n- **overlay**\n\n### **Examples:**\n**Use the `is` attribute to style a `button` as a `borderless-button`:**\n```html\n<button is=\"borderless-button\">\n <label-view system-image=\"hand-tap\" title=\"Tap Me\"></label-view>\n</button>\n\n```"
103
+ "description": "A control that starts an action. Styled without any borders.\n---\n\n```ts\ninterface BorderlessButtonSignature {\n Declaration: '<button is=\"borderless-button\"></button>'\n\n Attributes: {\n role?: 'destructive' | 'confirm' // A value that describes the purpose of a button\n 'title-key'?: string\n }\n\n Slots: {\n overlay: HTMLElement[]\n }\n}\n\nclass BorderlessButton extends HTMLButtonElement<BorderlessButtonSignature> {}\n\n```\n\n### **Examples:**\n**Use the `is` attribute to style a `button` as a `borderless-button`:**\n```html\n<button is=\"borderless-button\">\n <label-view system-image=\"hand-tap\" title=\"Tap Me\"></label-view>\n</button>\n\n```\n"
104
104
  },
105
105
  {
106
106
  "name": "color-scheme",
@@ -109,7 +109,7 @@
109
109
  "name": "dark"
110
110
  }
111
111
  ],
112
- "description": ""
112
+ "description": "undefined\n\n```ts\ninterface ColorSchemeSignature {\n Declaration: '<color-scheme></color-scheme>'\n\n Attributes: {\n dark?: string\n }\n}\n\nclass ColorScheme extends HTMLElement<ColorSchemeSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'color-scheme': ColorScheme\n }\n}\n\n```\n"
113
113
  },
114
114
  {
115
115
  "name": "confirmation-dialog",
@@ -124,7 +124,7 @@
124
124
  "name": "anchor"
125
125
  }
126
126
  ],
127
- "description": "A dialog that asks the user to confirm an action. Use it from the client module like `await confirmationDialog(trigger, 'Permanently erase the items in the Trash?')`.\n---"
127
+ "description": "A dialog that asks the user to confirm an action. Use it from the client module like `await confirmationDialog(trigger, 'Permanently erase the items in the Trash?')`.\n---\n\n```ts\ninterface ConfirmationDialogSignature {\n Declaration: '<dialog is=\"confirmation-dialog\"></dialog>'\n\n Attributes: {\n anchor?: string\n }\n}\n\nclass ConfirmationDialog extends HTMLDialogElement<ConfirmationDialogSignature> {}\n\n```\n"
128
128
  },
129
129
  {
130
130
  "name": "content-unavailable",
@@ -139,7 +139,7 @@
139
139
  "name": "search"
140
140
  }
141
141
  ],
142
- "description": "A message with a title and extra information that you show when part of your app can’t be used.\n---\n\n### **Slots:**\n- _default_ — The default slot.\n- **description**\n- **actions**\n\n### **Examples:**\n**Example:**\n```html\n<content-unavailable search></content-unavailable>\n\n```\n**Example:**\n```html\n<content-unavailable search=\"foo\"></content-unavailable>\n\n```\n**Example:**\n```html\n<content-unavailable padding>\n <label-view title=\"No Mail\">\n <i class=\"ph ph-tray\" slot=\"icon\" foreground=\"secondary\"></i>\n </label-view>\n <label-view\n title=\"New mails you receive will appear here.\"\n foreground=\"secondary\"\n slot=\"description\"\n ></label-view>\n <button is=\"borderless-button\" type=\"button\" tabindex=\"0\" slot=\"actions\">\n <label-view title=\"Switch Account\"></label-view>\n </button>\n</content-unavailable>\n\n```\n**Example:**\n```html\n<content-unavailable padding>\n <label-view title=\"No Mail\">\n <svg slot=\"icon\" foreground=\"secondary\" ...>...</svg>\n </label-view>\n <label-view\n title=\"New mails you receive will appear here.\"\n foreground=\"secondary\"\n slot=\"description\"\n ></label-view>\n <button is=\"borderless-button\" type=\"button\" tabindex=\"0\" slot=\"actions\">\n <label-view title=\"Switch Account\"></label-view>\n </button>\n</content-unavailable>\n\n```"
142
+ "description": "A message with a title and extra information that you show when part of your app can’t be used.\n---\n\n```ts\ninterface ContentUnavailableSignature {\n Declaration: '<content-unavailable></content-unavailable>'\n\n Attributes: {\n search?: string\n }\n\n Slots: {\n default: HTMLElement[] // The default slot.\n description: HTMLElement[]\n actions: HTMLElement[]\n }\n}\n\nclass ContentUnavailable extends HTMLElement<ContentUnavailableSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'content-unavailable': ContentUnavailable\n }\n}\n\n```\n\n### **Examples:**\n**Example:**\n```html\n<content-unavailable search></content-unavailable>\n\n```\n**Example:**\n```html\n<content-unavailable search=\"foo\"></content-unavailable>\n\n```\n**Example:**\n```html\n<content-unavailable padding>\n <label-view title=\"No Mail\">\n <i class=\"ph ph-tray\" slot=\"icon\" foreground=\"secondary\"></i>\n </label-view>\n <label-view\n title=\"New mails you receive will appear here.\"\n foreground=\"secondary\"\n slot=\"description\"\n ></label-view>\n <button is=\"borderless-button\" type=\"button\" tabindex=\"0\" slot=\"actions\">\n <label-view title=\"Switch Account\"></label-view>\n </button>\n</content-unavailable>\n\n```\n**Example:**\n```html\n<content-unavailable padding>\n <label-view title=\"No Mail\">\n <svg slot=\"icon\" foreground=\"secondary\" ...>...</svg>\n </label-view>\n <label-view\n title=\"New mails you receive will appear here.\"\n foreground=\"secondary\"\n slot=\"description\"\n ></label-view>\n <button is=\"borderless-button\" type=\"button\" tabindex=\"0\" slot=\"actions\">\n <label-view title=\"Switch Account\"></label-view>\n </button>\n</content-unavailable>\n\n```\n"
143
143
  },
144
144
  {
145
145
  "name": "date-picker",
@@ -167,12 +167,7 @@
167
167
  },
168
168
  {
169
169
  "name": "required",
170
- "description": "Value Type: “boolean”",
171
- "values": [
172
- {
173
- "name": "boolean"
174
- }
175
- ]
170
+ "description": "Value Type: boolean"
176
171
  },
177
172
  {
178
173
  "name": "prompt"
@@ -194,12 +189,7 @@
194
189
  "url": "https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled"
195
190
  }
196
191
  ],
197
- "description": "Value Type: “boolean”",
198
- "values": [
199
- {
200
- "name": "boolean"
201
- }
202
- ]
192
+ "description": "Value Type: boolean"
203
193
  },
204
194
  {
205
195
  "name": "minimum"
@@ -208,7 +198,7 @@
208
198
  "name": "maximum"
209
199
  }
210
200
  ],
211
- "description": "A control that selects an absolute date.\n---\n\n### **Properties:**\n- readonly **template** — DocumentFragment\n- readonly **datePickerStyle** — \"graphical\" | \"field\" | \"automatic\"\n- readonly **name** — string\n- readonly **value** — { year: string; month: string; day: string; }\n- readonly **valueAsDate** — Date | null\n- readonly **minimum** — { year: string; month: string; day: string; } | null\n- readonly **maximum** — { year: string; month: string; day: string; } | null"
201
+ "description": "A control that selects an absolute date.\n---\n\n```ts\ninterface DatePickerSignature {\n Declaration: '<date-picker></date-picker>'\n\n Attributes: {\n 'date-picker-style'?: 'graphical' | 'field' | 'automatic' // The style of this element\n required?: boolean\n prompt?: string\n label?: string\n name?: string\n selection?: string\n disabled?: boolean\n minimum?: string\n maximum?: string\n }\n}\n\nclass DatePicker extends HTMLElement<DatePickerSignature> {\n static formAssociated = true\n\n readonly template: DocumentFragment\n readonly datePickerStyle: 'graphical' | 'field' | 'automatic'\n readonly name: string // Form participation property\n readonly value: { year: string; month: string; day: string }\n readonly valueAsDate: Date | null // Returns the value as a Date object.\n readonly minimum: { year: string; month: string; day: string } | null\n readonly maximum: { year: string; month: string; day: string } | null\n\n setValidity(): void\n setCustomValidity(): void\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'date-picker': DatePicker\n }\n}\n\n```\n"
212
202
  },
213
203
  {
214
204
  "name": "disclosure-group",
@@ -221,19 +211,20 @@
221
211
  "attributes": [
222
212
  {
223
213
  "name": "open",
224
- "description": "Value Type: “boolean”\nDescription: The status of this element",
225
- "values": [
226
- {
227
- "name": "boolean"
228
- }
229
- ]
214
+ "description": "Value Type: boolean\nDescription: The status of this element"
230
215
  }
231
216
  ],
232
- "description": "A view that shows or hides another view when the user opens or closes it.\n---\n\n### **Events:**\n- **is-expanded**\n- **is-collapsed**\n\n### **Examples:**\n**Example:**\n```html\n<details is=\"disclosure-group\">\n <summary><label-view title=\"Items\"></label-view></summary>\n <label-view title=\"Item 1\"></label-view>\n <label-view title=\"Item 2\"></label-view>\n <details is=\"disclosure-group\">\n <summary><label-view title=\"Sub-items\"></label-view></summary>\n <label-view title=\"Sub-item 1\"></label-view>\n </details>\n</details>\n\n```"
217
+ "description": "A view that shows or hides another view when the user opens or closes it.\n---\n\n```ts\ninterface DisclosureGroupSignature {\n Declaration: '<details is=\"disclosure-group\"></details>'\n\n Attributes: {\n open?: boolean // The status of this element\n }\n\n Events: {\n 'is-expanded': CustomEvent\n 'is-collapsed': CustomEvent\n }\n}\n\nclass DisclosureGroup extends HTMLDetailsElement<DisclosureGroupSignature> {}\n\n```\n\n### **Examples:**\n**Example:**\n```html\n<details is=\"disclosure-group\">\n <summary><label-view title=\"Items\"></label-view></summary>\n <label-view title=\"Item 1\"></label-view>\n <label-view title=\"Item 2\"></label-view>\n <details is=\"disclosure-group\">\n <summary><label-view title=\"Sub-items\"></label-view></summary>\n <label-view title=\"Sub-item 1\"></label-view>\n </details>\n</details>\n\n```\n"
233
218
  },
234
219
  {
235
220
  "name": "fine-tooltip",
236
- "description": ""
221
+ "references": [
222
+ {
223
+ "name": "Documentation",
224
+ "url": "https://swiftwc.github.io/ui/web-components/fine-tooltip"
225
+ }
226
+ ],
227
+ "description": "A tooltip that shows an unobtrusive helpful message on pointer:fine screens. Use it by adding a `help` attribute to any element.\n---\n\n```ts\ninterface FineTooltipSignature {\n Declaration: '<fine-tooltip></fine-tooltip>'\n}\n\nclass FineTooltip extends HTMLElement<FineTooltipSignature> {\n hidePopover(): void\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'fine-tooltip': FineTooltip\n }\n}\n\n```\n"
237
228
  },
238
229
  {
239
230
  "name": "form-view",
@@ -254,7 +245,7 @@
254
245
  ]
255
246
  }
256
247
  ],
257
- "description": "A container view that groups controls together for entering data, like a settings screen.\n---"
248
+ "description": "A container view that groups controls together for entering data, like a settings screen.\n---\n\n```ts\ninterface FormViewSignature {\n Declaration: '<form is=\"form-view\"></form>'\n\n Attributes: {\n 'navigation-link-indicator-visibility'?: 'hidden' // Hides accessories like right-arrow-chevron on NavigationLink buttons inside.\n }\n}\n\nclass FormView extends HTMLFormElement<FormViewSignature> {}\n\n```\n"
258
249
  },
259
250
  {
260
251
  "name": "glass-button",
@@ -281,7 +272,7 @@
281
272
  "name": "title-key"
282
273
  }
283
274
  ],
284
- "description": "A control that starts an action. Styled with a glass border, adapting to the button’s surroundings.\n---\n\n### **Slots:**\n- **overlay**\n\n### **Examples:**\n**Creating a glass button:**\n```html\n<button is=\"glass-button\">\n <label-view system-image=\"hand-tap\" title=\"Tap Me\"></label-view>\n</button>\n\n```"
275
+ "description": "A control that starts an action. Styled with a glass border, adapting to the button’s surroundings.\n---\n\n```ts\ninterface GlassButtonSignature {\n Declaration: '<button is=\"glass-button\"></button>'\n\n Attributes: {\n role?: 'destructive' | 'confirm' // A value that describes the purpose of a button\n 'title-key'?: string\n }\n\n Slots: {\n overlay: HTMLElement[]\n }\n}\n\nclass GlassButton extends HTMLButtonElement<GlassButtonSignature> {}\n\n```\n\n### **Examples:**\n**Creating a glass button:**\n```html\n<button is=\"glass-button\">\n <label-view system-image=\"hand-tap\" title=\"Tap Me\"></label-view>\n</button>\n\n```\n"
285
276
  },
286
277
  {
287
278
  "name": "glass-prominent-button",
@@ -308,7 +299,7 @@
308
299
  "name": "title-key"
309
300
  }
310
301
  ],
311
- "description": "A control that starts an action. Styled with a prominent glass border, adapting to the button’s surroundings.\n---\n\n### **Slots:**\n- **overlay**\n\n### **Examples:**\n**Creating a prominent glass button:**\n```html\n<button is=\"glass-prominent-button\">\n <label-view system-image=\"hand-tap\" title=\"Tap Me\"></label-view>\n</button>\n\n```"
302
+ "description": "A control that starts an action. Styled with a prominent glass border, adapting to the button’s surroundings.\n---\n\n```ts\ninterface GlassProminentButtonSignature {\n Declaration: '<button is=\"glass-prominent-button\"></button>'\n\n Attributes: {\n role?: 'destructive' | 'confirm' // A value that describes the purpose of a button\n 'title-key'?: string\n }\n\n Slots: {\n overlay: HTMLElement[]\n }\n}\n\nclass GlassProminentButton extends HTMLButtonElement<GlassProminentButtonSignature> {}\n\n```\n\n### **Examples:**\n**Creating a prominent glass button:**\n```html\n<button is=\"glass-prominent-button\">\n <label-view system-image=\"hand-tap\" title=\"Tap Me\"></label-view>\n</button>\n\n```\n"
312
303
  },
313
304
  {
314
305
  "name": "h-stack",
@@ -345,7 +336,7 @@
345
336
  "valueSet": "inlinePlacementSet"
346
337
  }
347
338
  ],
348
- "description": "A view that arranges its children side by side.\n---"
339
+ "description": "A view that arranges its children side by side.\n---\n\n```ts\ninterface HStackSignature {\n Declaration: '<h-stack></h-stack>'\n\n Attributes: {\n template?: Template // The main-axis grid template\n spacing?: Spacing // The gap between the primary axis\n alignment?: blockSet // The cross-axis alignment\n distribution?: inlineSet // The main-axis alignment\n placement?: inlinePlacementSet // The main-axis alignment\n }\n}\n\nclass HStack extends HTMLElement<HStackSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'h-stack': HStack\n }\n}\n\n```\n"
349
340
  },
350
341
  {
351
342
  "name": "image-view",
@@ -363,7 +354,7 @@
363
354
  "name": "system-weight"
364
355
  }
365
356
  ],
366
- "description": "A view that displays an image.\n---"
357
+ "description": "A view that displays an image.\n---\n\n```ts\ninterface ImageViewSignature {\n Declaration: '<image-view></image-view>'\n\n Attributes: {\n 'system-name'?: string\n 'system-weight'?: string\n }\n}\n\nclass ImageView extends HTMLElement<ImageViewSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'image-view': ImageView\n }\n}\n\n```\n"
367
358
  },
368
359
  {
369
360
  "name": "label-view",
@@ -390,15 +381,10 @@
390
381
  },
391
382
  {
392
383
  "name": "truncation-mode",
393
- "description": "Value Type: “tail”",
394
- "values": [
395
- {
396
- "name": "tail"
397
- }
398
- ]
384
+ "description": "Value Type: \"tail\""
399
385
  }
400
386
  ],
401
- "description": "A view that labels items with an icon and a title.\n---\n\n### **Slots:**\n- _default_ — Any children without a `slot` attribute are placed in the title block.\n- **icon** — Use the `slot=\"icon\"` attribute to place childen in the icon block.\n\n### **Examples:**\n**Creating a label using a `span` element:**\n```html\n<label-view><span>Hello world!</span></label-view>\n\n```\n**Creating a label using the `title` attribute:**\n```html\n<label-view title=\"Hello world!\"></label-view>\n\n```\n**Creating a label with an icon and a title using the `system-image` attribute:**\n```html\n<label-view system-image=\"hand-waving\"><span>Hello world!</span></label-view>\n\n```\n**Creating a label with an icon and a title using the `icon` slot:**\n```html\n<label-view>\n <i slot=\"icon\" class=\"ph ph-duotone ph-hand-waving\"></i>\n <span>Hello world!</span>\n</label-view>\n\n```"
387
+ "description": "A view that labels items with an icon and a title.\n---\n\n```ts\ninterface LabelViewSignature {\n Declaration: '<label-view></label-view>'\n\n Attributes: {\n font?: Font // Sets the default font for text in this view.\n 'system-image'?: string\n title?: string\n 'line-limit'?: string\n 'truncation-mode'?: 'tail'\n }\n\n Slots: {\n default: HTMLElement[] // Any children without a `slot` attribute are placed in the title block.\n icon: HTMLElement[] // Use the `slot=\"icon\"` attribute to place childen in the icon block.\n }\n\n CSSProperties: {\n '--label-gap'?: string // The gap between the icon and the title.\n '--label-image-size'?: string // The size of the icon.\n '--label-padding-inline'?: string // The padding inline of the label.\n }\n}\n\nclass LabelView extends HTMLElement<LabelViewSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'label-view': LabelView\n }\n}\n\n```\n\n### **Examples:**\n**Creating a label using a `span` element:**\n```html\n<label-view><span>Hello world!</span></label-view>\n\n```\n**Creating a label using the `title` attribute:**\n```html\n<label-view title=\"Hello world!\"></label-view>\n\n```\n**Creating a label with an icon and a title using the `system-image` attribute:**\n```html\n<label-view system-image=\"hand-waving\"><span>Hello world!</span></label-view>\n\n```\n**Creating a label with an icon and a title using the `icon` slot:**\n```html\n<label-view>\n <i slot=\"icon\" class=\"ph ph-duotone ph-hand-waving\"></i>\n <span>Hello world!</span>\n</label-view>\n\n```\n"
402
388
  },
403
389
  {
404
390
  "name": "labeled-content",
@@ -437,7 +423,7 @@
437
423
  "name": "format"
438
424
  }
439
425
  ],
440
- "description": "A container view that pairs a label with a value.\n---\n\n### **Slots:**\n- _default_ — The default slot.\n- **label** — Use the `slot=\"label\"` attribute to place childen in the label block.\n- **header**\n- **footer**"
426
+ "description": "A container view that pairs a label with a value.\n---\n\n```ts\ninterface LabeledContentSignature {\n Declaration: '<labeled-content></labeled-content>'\n\n Attributes: {\n value?: string\n label?: string\n header?: string\n footer?: string\n 'labeled-content-style'?: 'vertical' | 'horizontal'\n format?: string\n }\n\n Slots: {\n default: HTMLElement[] // The default slot.\n label: HTMLElement[] // Use the `slot=\"label\"` attribute to place childen in the label block.\n header: HTMLElement[]\n footer: HTMLElement[]\n }\n\n Parts: {\n 'labeled-content-container': never\n 'labeled-content-stack': never\n 'labeled-content-label-stack': never\n 'labeled-content-value-stack': never\n }\n}\n\nclass LabeledContent extends HTMLElement<LabeledContentSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'labeled-content': LabeledContent\n }\n}\n\n```\n"
441
427
  },
442
428
  {
443
429
  "name": "list-view",
@@ -458,7 +444,7 @@
458
444
  ]
459
445
  }
460
446
  ],
461
- "description": "A container view that arranges rows of data in a single column, optionally letting the user select one or more of them.\n---"
447
+ "description": "A container view that arranges rows of data in a single column, optionally letting the user select one or more of them.\n---\n\n```ts\ninterface ListViewSignature {\n Declaration: '<list-view></list-view>'\n\n Attributes: {\n 'navigation-link-indicator-visibility'?: 'hidden' // Hides accessories like right-arrow-chevron on NavigationLink buttons inside.\n }\n}\n\nclass ListView extends HTMLElement<ListViewSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'list-view': ListView\n }\n}\n\n```\n"
462
448
  },
463
449
  {
464
450
  "name": "menu-view",
@@ -479,7 +465,7 @@
479
465
  "name": "label"
480
466
  }
481
467
  ],
482
- "description": "A control that opens a menu of actions.\n---\n\n### **Slots:**\n- _default_ — The default slot.\n- **label**"
468
+ "description": "A control that opens a menu of actions.\n---\n\n```ts\ninterface MenuViewSignature {\n Declaration: '<menu-view></menu-view>'\n\n Attributes: {\n open?: string\n closing?: string\n label?: string\n }\n\n Slots: {\n default: HTMLElement[] // The default slot.\n label: HTMLElement[]\n }\n}\n\nclass MenuView extends HTMLElement<MenuViewSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'menu-view': MenuView\n }\n}\n\n```\n"
483
469
  },
484
470
  {
485
471
  "name": "navigation-large-title",
@@ -501,24 +487,14 @@
501
487
  },
502
488
  {
503
489
  "name": "padding",
504
- "description": "Value Type: “boolean”",
505
- "values": [
506
- {
507
- "name": "boolean"
508
- }
509
- ]
490
+ "description": "Value Type: boolean"
510
491
  },
511
492
  {
512
493
  "name": "navigation-bar-auto-hide",
513
- "description": "Value Type: “boolean”",
514
- "values": [
515
- {
516
- "name": "boolean"
517
- }
518
- ]
494
+ "description": "Value Type: boolean"
519
495
  }
520
496
  ],
521
- "description": ""
497
+ "description": "undefined\n\n```ts\ninterface NavigationLargeTitleSignature {\n Declaration: '<navigation-large-title></navigation-large-title>'\n\n Attributes: {\n 'background-style'?: 'grouped'\n padding?: boolean\n 'navigation-bar-auto-hide'?: boolean\n }\n}\n\nclass NavigationLargeTitle extends HTMLElement<NavigationLargeTitleSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'navigation-large-title': NavigationLargeTitle\n }\n}\n\n```\n"
522
498
  },
523
499
  {
524
500
  "name": "navigation-split-view",
@@ -528,7 +504,7 @@
528
504
  "url": "https://swiftwc.github.io/ui/web-components/navigation-split-view"
529
505
  }
530
506
  ],
531
- "description": "A container view with two or three side-by-side screens, where what the user chooses in the left screen changes what appears in the next screen.\n---"
507
+ "description": "A container view with two or three side-by-side screens, where what the user chooses in the left screen changes what appears in the next screen.\n---\n\n```ts\ninterface NavigationSplitViewSignature {\n Declaration: '<navigation-split-view></navigation-split-view>'\n}\n\nclass NavigationSplitView extends HTMLElement<NavigationSplitViewSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'navigation-split-view': NavigationSplitView\n }\n}\n\n```\n"
532
508
  },
533
509
  {
534
510
  "name": "navigation-stack",
@@ -538,7 +514,7 @@
538
514
  "url": "https://swiftwc.github.io/ui/web-components/navigation-stack"
539
515
  }
540
516
  ],
541
- "description": "A container view that shows a main screen and lets the user open other screens on top of it.\n---"
517
+ "description": "A container view that shows a main screen and lets the user open other screens on top of it.\n---\n\n```ts\ninterface NavigationStackSignature {\n Declaration: '<navigation-stack></navigation-stack>'\n}\n\nclass NavigationStack extends HTMLElement<NavigationStackSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'navigation-stack': NavigationStack\n }\n}\n\n```\n"
542
518
  },
543
519
  {
544
520
  "name": "navigation-title",
@@ -551,12 +527,7 @@
551
527
  "attributes": [
552
528
  {
553
529
  "name": "padding",
554
- "description": "Value Type: “boolean”",
555
- "values": [
556
- {
557
- "name": "boolean"
558
- }
559
- ]
530
+ "description": "Value Type: boolean"
560
531
  },
561
532
  {
562
533
  "name": "value"
@@ -571,7 +542,7 @@
571
542
  "name": "system-image-weight"
572
543
  }
573
544
  ],
574
- "description": "A container view.\n---"
545
+ "description": "A container view.\n---\n\n```ts\ninterface NavigationTitleSignature {\n Declaration: '<navigation-title></navigation-title>'\n\n Attributes: {\n padding?: boolean\n value?: string\n subtitle?: string\n 'system-image'?: string\n 'system-image-weight'?: string\n }\n}\n\nclass NavigationTitle extends HTMLElement<NavigationTitleSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'navigation-title': NavigationTitle\n }\n}\n\n```\n"
575
546
  },
576
547
  {
577
548
  "name": "picker-view",
@@ -605,12 +576,7 @@
605
576
  },
606
577
  {
607
578
  "name": "help",
608
- "description": "Value Type: “string”\n\nDescription: Adds a help tooltip to the trigger of the picker, if style supports one",
609
- "values": [
610
- {
611
- "name": "string"
612
- }
613
- ]
579
+ "description": "\nDescription: Adds a help tooltip to the trigger of the picker, if style supports one"
614
580
  },
615
581
  {
616
582
  "name": "dictionary",
@@ -637,11 +603,11 @@
637
603
  ]
638
604
  }
639
605
  ],
640
- "description": "A control that selects one value from a set of options.\n---\n\n### **Slots:**\n- _default_ — The default slot.\n- **label**\n- **list**\n- **validity-options**\n\n### **Properties:**\n- **selection** — string\n- readonly **template** — DocumentFragment\n- readonly **pickerStyle** — \"automatic\" | \"menu\" | \"inline\" | \"navigation-link\" | \"sheet\"\n- readonly **name** — string"
606
+ "description": "A control that selects one value from a set of options.\n---\n\n```ts\ninterface PickerViewSignature {\n Declaration: '<picker-view></picker-view>'\n\n Attributes: {\n 'picker-style'?:\n | 'menu'\n | 'inline'\n | 'navigation-link'\n | 'sheet'\n | 'automatic'\n dictionary?: 'DictEntry[]' // Renders all options using this array\n 'label-value-placement'?: 'vertical' | 'horizontal' | 'auto'\n }\n\n Slots: {\n default: HTMLElement[] // The default slot.\n label: HTMLElement[]\n list: HTMLElement[]\n 'validity-options': HTMLElement[]\n }\n}\n\nclass PickerView extends HTMLElement<PickerViewSignature> {\n static formAssociated = true\n\n selection: string\n readonly template: DocumentFragment\n readonly pickerStyle:\n | 'automatic'\n | 'menu'\n | 'inline'\n | 'navigation-link'\n | 'sheet'\n readonly name: string // Form participation property\n\n setValidity(): void\n setCustomValidity(): void\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'picker-view': PickerView\n }\n}\n\n```\n"
641
607
  },
642
608
  {
643
609
  "name": "plain-button",
644
- "description": ""
610
+ "description": "undefined\n\n```ts\ninterface PlainButtonSignature {\n Declaration: '<button is=\"plain-button\"></button>'\n}\n\nclass PlainButton extends HTMLButtonElement<PlainButtonSignature> {}\n\n```\n"
645
611
  },
646
612
  {
647
613
  "name": "progress-view",
@@ -662,11 +628,11 @@
662
628
  "name": "value"
663
629
  }
664
630
  ],
665
- "description": "A view that shows how far along a task is.\n---\n\n### **Slots:**\n- _default_ — The default slot.\n- **current-value**\n\n### **Properties:**\n- readonly **progressViewStyle** — \"circular\" | \"linear\"\n- readonly **template** — DocumentFragment"
631
+ "description": "A view that shows how far along a task is.\n---\n\n```ts\ninterface ProgressViewSignature {\n Declaration: '<progress-view></progress-view>'\n\n Attributes: {\n label?: string\n 'current-value-label'?: string\n value?: string\n }\n\n Slots: {\n default: HTMLElement[] // The default slot.\n 'current-value': HTMLElement[]\n }\n}\n\nclass ProgressView extends HTMLElement<ProgressViewSignature> {\n readonly progressViewStyle: 'circular' | 'linear'\n readonly template: DocumentFragment\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'progress-view': ProgressView\n }\n}\n\n```\n"
666
632
  },
667
633
  {
668
634
  "name": "screen-view",
669
- "description": ""
635
+ "description": "undefined\n\n```ts\ninterface ScreenViewSignature {\n Declaration: '<dialog is=\"screen-view\"></dialog>'\n}\n\nclass ScreenView extends HTMLDialogElement<ScreenViewSignature> {}\n\n```\n"
670
636
  },
671
637
  {
672
638
  "name": "scroll-view-proxy",
@@ -676,7 +642,7 @@
676
642
  "url": "https://swiftwc.github.io/ui/web-components/scroll-view-proxy"
677
643
  }
678
644
  ],
679
- "description": "A wrapper for {hv}-stacks\n---"
645
+ "description": "A wrapper for {hv}-stacks\n---\n\n```ts\ninterface ScrollViewProxySignature {\n Declaration: '<scroll-view-proxy></scroll-view-proxy>'\n}\n\nclass ScrollViewProxy extends HTMLElement<ScrollViewProxySignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'scroll-view-proxy': ScrollViewProxy\n }\n}\n\n```\n"
680
646
  },
681
647
  {
682
648
  "name": "scroll-view",
@@ -704,11 +670,11 @@
704
670
  "name": "navigation-bar-title-display-mode"
705
671
  }
706
672
  ],
707
- "description": "A view that scrolls its content when it doesn’t fit the screen.\n---\n\n### **Slots:**\n- _default_ — The default slot.\n- **top-bar-principal**\n- **bottom-bar-principal**"
673
+ "description": "A view that scrolls its content when it doesn’t fit the screen.\n---\n\n```ts\ninterface ScrollViewSignature {\n Declaration: '<scroll-view></scroll-view>'\n\n Attributes: {\n 'navigation-title'?: string // Configures the view’s title for purposes of navigation. Shorthand for `<v-stack spacing=\"0\" alignment=\"fill\" slot=\"top-bar-principal\"><label-view line-limit=\"1\" truncation-mode=\"tail\" font=\"headline\"><span>Navigation Title</span></label-view></v-stack>`\n 'navigation-inline-title'?: string\n 'navigation-inline-subtitle'?: string\n 'navigation-icon'?: string\n 'navigation-bar-title-display-mode'?: string\n }\n\n Slots: {\n default: HTMLElement[] // The default slot.\n 'top-bar-principal': HTMLElement[]\n 'bottom-bar-principal': HTMLElement[]\n }\n}\n\nclass ScrollView extends HTMLElement<ScrollViewSignature> {\n centerScrollToElement(): void\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'scroll-view': ScrollView\n }\n}\n\n```\n"
708
674
  },
709
675
  {
710
676
  "name": "search-view",
711
- "description": ""
677
+ "description": "undefined\n\n```ts\ninterface SearchViewSignature {\n Declaration: '<search-view></search-view>'\n}\n\nclass SearchView extends HTMLInputElement<SearchViewSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'search-view': SearchView\n }\n}\n\n```\n"
712
678
  },
713
679
  {
714
680
  "name": "section-view",
@@ -726,7 +692,7 @@
726
692
  "name": "footer"
727
693
  }
728
694
  ],
729
- "description": "A container view that groups related content together.\n---\n\n### **Slots:**\n- _default_ — The default slot.\n- **header**\n- **footer**"
695
+ "description": "A container view that groups related content together.\n---\n\n```ts\ninterface SectionViewSignature {\n Declaration: '<section-view></section-view>'\n\n Attributes: {\n header?: string\n footer?: string\n }\n\n Slots: {\n default: HTMLElement[] // The default slot.\n header: HTMLElement[]\n footer: HTMLElement[]\n }\n}\n\nclass SectionView extends HTMLElement<SectionViewSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'section-view': SectionView\n }\n}\n\n```\n"
730
696
  },
731
697
  {
732
698
  "name": "sheet-view",
@@ -736,7 +702,7 @@
736
702
  "url": "https://swiftwc.github.io/ui/web-components/sheet-view"
737
703
  }
738
704
  ],
739
- "description": "A dialog that slides up over the current screen.\n---"
705
+ "description": "A dialog that slides up over the current screen.\n---\n\n```ts\ninterface SheetViewSignature {\n Declaration: '<dialog is=\"sheet-view\"></dialog>'\n}\n\nclass SheetView extends HTMLDialogElement<SheetViewSignature> {}\n\n```\n"
740
706
  },
741
707
  {
742
708
  "name": "sidebar-toggle",
@@ -746,7 +712,7 @@
746
712
  "url": "https://swiftwc.github.io/ui/web-components/sidebar-toggle"
747
713
  }
748
714
  ],
749
- "description": "A control that shows or hides the sidebar view.\n---"
715
+ "description": "A control that shows or hides the sidebar view.\n---\n\n```ts\ninterface SidebarToggleSignature {\n Declaration: '<sidebar-toggle></sidebar-toggle>'\n}\n\nclass SidebarToggle extends HTMLElement<SidebarToggleSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'sidebar-toggle': SidebarToggle\n }\n}\n\n```\n"
750
716
  },
751
717
  {
752
718
  "name": "sidebar-view",
@@ -756,11 +722,11 @@
756
722
  "url": "https://swiftwc.github.io/ui/web-components/sidebar-view"
757
723
  }
758
724
  ],
759
- "description": "A container view that arranges navigation destinations in a single column.\n---"
725
+ "description": "A container view that arranges navigation destinations in a single column.\n---\n\n```ts\ninterface SidebarViewSignature {\n Declaration: '<dialog is=\"sidebar-view\"></dialog>'\n}\n\nclass SidebarView extends HTMLDialogElement<SidebarViewSignature> {}\n\n```\n"
760
726
  },
761
727
  {
762
728
  "name": "sticky-container",
763
- "description": ""
729
+ "description": "undefined\n\n```ts\ninterface StickyContainerSignature {\n Declaration: '<sticky-container></sticky-container>'\n}\n\nclass StickyContainer extends HTMLElement<StickyContainerSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'sticky-container': StickyContainer\n }\n}\n\n```\n"
764
730
  },
765
731
  {
766
732
  "name": "tab-bar",
@@ -770,7 +736,7 @@
770
736
  "url": "https://swiftwc.github.io/ui/web-components/tab-bar"
771
737
  }
772
738
  ],
773
- "description": "A container view that groups tab-items together along the top or bottom of the screen.\n---"
739
+ "description": "A container view that groups tab-items together along the top or bottom of the screen.\n---\n\n```ts\ninterface TabBarSignature {\n Declaration: '<dialog is=\"tab-bar\"></dialog>'\n}\n\nclass TabBar extends HTMLDialogElement<TabBarSignature> {}\n\n```\n"
774
740
  },
775
741
  {
776
742
  "name": "tab-item",
@@ -780,7 +746,7 @@
780
746
  "url": "https://swiftwc.github.io/ui/web-components/tab-item"
781
747
  }
782
748
  ],
783
- "description": "A control that switches the tab view to this tab.\n---"
749
+ "description": "A control that switches the tab view to this tab.\n---\n\n```ts\ninterface TabItemSignature {\n Declaration: '<button is=\"tab-item\"></button>'\n}\n\nclass TabItem extends HTMLButtonElement<TabItemSignature> {}\n\n```\n"
784
750
  },
785
751
  {
786
752
  "name": "tab-view",
@@ -790,7 +756,7 @@
790
756
  "url": "https://swiftwc.github.io/ui/web-components/tab-view"
791
757
  }
792
758
  ],
793
- "description": "A container view that switches between screens using tabs.\n---\n\n### **Properties:**\n- readonly **tabBarPlacement** — \"bottom-bar\" | \"ornament\" | \"sidebar\" | \"top-bar\" | undefined\n- readonly **moreTab** — NavigationStack | null\n- **selectedTab** — (NavigationSplitView | NavigationStack)[]\n\n### **Events:**\n- **tabshow** — A Tab is shown\n- **tabhide** — A Tab is hidden\n- **tab-view:toggle**\n- **tab-view:adaptable-tab-bar-placement-change**"
759
+ "description": "A container view that switches between screens using tabs.\n---\n\n```ts\ninterface TabViewSignature {\n Declaration: '<tab-view></tab-view>'\n\n Events: {\n tabshow: CustomEvent // A Tab is shown\n tabhide: CustomEvent // A Tab is hidden\n 'tab-view:toggle': CustomEvent\n 'tab-view:adaptable-tab-bar-placement-change': CustomEvent\n }\n\n CSSProperties: {\n '--adaptable-tab-bar-placement'?: string\n }\n}\n\nclass TabView extends HTMLElement<TabViewSignature> {\n readonly tabBarPlacement:\n | 'bottom-bar'\n | 'ornament'\n | 'sidebar'\n | 'top-bar'\n | undefined\n readonly moreTab: NavigationStack | null\n selectedTab: (NavigationSplitView | NavigationStack)[]\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'tab-view': TabView\n }\n}\n\n```\n"
794
760
  },
795
761
  {
796
762
  "name": "table-view",
@@ -820,7 +786,7 @@
820
786
  ]
821
787
  }
822
788
  ],
823
- "description": "A container view that arranges data in rows and columns, optionally letting the user select one or more of them.\n---\n\n### **Slots:**\n- _default_ — The default slot.\n- **header-leading**\n- **header-principal**\n- **header-trailing**\n- **column**\n- **footer-leading**\n- **footer-principal**\n- **footer-trailing**"
789
+ "description": "A container view that arranges data in rows and columns, optionally letting the user select one or more of them.\n---\n\n```ts\ninterface TableViewSignature {\n Declaration: '<table-view></table-view>'\n\n Attributes: {\n 'preferred-compact-template'?:\n | 'title:trailing:subtitle'\n | 'trailing:title:subtitle'\n | 'title:subtitle:trailing'\n | '*' // Sets the template areas when the table is in compact mode\n }\n\n Slots: {\n default: HTMLElement[] // The default slot.\n 'header-leading': HTMLElement[]\n 'header-principal': HTMLElement[]\n 'header-trailing': HTMLElement[]\n column: HTMLElement[]\n 'footer-leading': HTMLElement[]\n 'footer-principal': HTMLElement[]\n 'footer-trailing': HTMLElement[]\n }\n}\n\nclass TableView extends HTMLElement<TableViewSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'table-view': TableView\n }\n}\n\n```\n"
824
790
  },
825
791
  {
826
792
  "name": "text-field",
@@ -860,12 +826,7 @@
860
826
  },
861
827
  {
862
828
  "name": "disable-autocorrection",
863
- "description": "Value Type: “boolean”",
864
- "values": [
865
- {
866
- "name": "boolean"
867
- }
868
- ]
829
+ "description": "Value Type: boolean"
869
830
  },
870
831
  {
871
832
  "name": "keyboard-type",
@@ -884,12 +845,7 @@
884
845
  },
885
846
  {
886
847
  "name": "required",
887
- "description": "Value Type: “boolean”",
888
- "values": [
889
- {
890
- "name": "boolean"
891
- }
892
- ]
848
+ "description": "Value Type: boolean"
893
849
  },
894
850
  {
895
851
  "name": "disabled",
@@ -899,15 +855,10 @@
899
855
  "url": "https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled"
900
856
  }
901
857
  ],
902
- "description": "Value Type: “boolean”",
903
- "values": [
904
- {
905
- "name": "boolean"
906
- }
907
- ]
858
+ "description": "Value Type: boolean"
908
859
  }
909
860
  ],
910
- "description": "A control that displays an editable text area.\n---\n\n### **Slots:**\n- **label**\n- **validity-options**\n\n### **Properties:**\n- readonly **keyboardType** — \"decimal-pad\" | \"number-pad\" | \"default\"\n- **text** — string\n- readonly **name** — string\n- readonly **value** — string\n- readonly **valueAsNumber** — number | \"\"\n- readonly **negativeNumbersAllowed** — boolean"
861
+ "description": "A control that displays an editable text area.\n---\n\n```ts\ninterface TextFieldSignature {\n Declaration: '<text-field></text-field>'\n\n Attributes: {\n prompt?: string\n minimum?: string\n maximum?: string\n 'min-length'?: string\n 'max-length'?: string\n label?: string\n name?: string\n text?: string\n 'text-input-autocapitalization'?: string\n 'disable-autocorrection'?: boolean\n 'keyboard-type'?: 'decimal-pad' | 'number-pad' | 'default'\n required?: boolean\n disabled?: boolean\n }\n\n Slots: {\n label: HTMLElement[]\n 'validity-options': HTMLElement[]\n }\n\n Events: {\n commit: CustomEvent<{ detail: { text: string } }> // Triggered when user interacts with the input area\n }\n}\n\nclass TextField extends HTMLElement<TextFieldSignature> {\n static formAssociated = true\n\n readonly keyboardType: 'decimal-pad' | 'number-pad' | 'default'\n text: string\n readonly name: string // Form participation property\n readonly value: string\n readonly valueAsNumber: number | ''\n readonly negativeNumbersAllowed: boolean\n\n setValidity(): void\n setCustomValidity(): void\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'text-field': TextField\n }\n}\n\n```\n"
911
862
  },
912
863
  {
913
864
  "name": "toggle-view",
@@ -928,13 +879,15 @@
928
879
  "name": "value"
929
880
  },
930
881
  {
931
- "name": "is-on"
882
+ "name": "is-on",
883
+ "description": "Value Type: boolean"
932
884
  },
933
885
  {
934
886
  "name": "keyboard-type"
935
887
  },
936
888
  {
937
- "name": "required"
889
+ "name": "required",
890
+ "description": "Value Type: boolean"
938
891
  },
939
892
  {
940
893
  "name": "disabled",
@@ -943,10 +896,11 @@
943
896
  "name": "MDN — disabled",
944
897
  "url": "https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled"
945
898
  }
946
- ]
899
+ ],
900
+ "description": "Value Type: boolean"
947
901
  }
948
902
  ],
949
- "description": "A control that switches between on and off states.\n---\n\n### **Slots:**\n- **label**\n- **validity-options**\n\n### **Properties:**\n- readonly **toggleStyle** — \"button\" | \"switch\"\n- **isOn** — boolean\n- readonly **name** — string\n- **value** — string | null\n\n### **Events:**\n- **toggle:change** — User toggled the control"
903
+ "description": "A control that switches between on and off states.\n---\n\n```ts\ninterface ToggleViewSignature {\n Declaration: '<toggle-view></toggle-view>'\n\n Attributes: {\n label?: string\n name?: string\n value?: string\n 'is-on'?: boolean\n 'keyboard-type'?: string\n required?: boolean\n disabled?: boolean\n }\n\n Slots: {\n label: HTMLElement[]\n 'validity-options': HTMLElement[]\n }\n\n Events: {\n 'toggle:change': CustomEvent // User toggled the control\n }\n}\n\nclass ToggleView extends HTMLElement<ToggleViewSignature> {\n static formAssociated = true\n\n readonly toggleStyle: 'button' | 'switch'\n isOn: boolean\n readonly name: string // Form participation property\n value: string | null\n\n setValidity(): void\n setCustomValidity(): void\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'toggle-view': ToggleView\n }\n}\n\n```\n"
950
904
  },
951
905
  {
952
906
  "name": "tool-bar-item-group",
@@ -956,7 +910,7 @@
956
910
  "url": "https://swiftwc.github.io/ui/web-components/tool-bar-item-group"
957
911
  }
958
912
  ],
959
- "description": "A container view that groups items together in the toolbar or navigation bar.\n---"
913
+ "description": "A container view that groups items together in the toolbar or navigation bar.\n---\n\n```ts\ninterface ToolBarItemGroupSignature {\n Declaration: '<tool-bar-item-group></tool-bar-item-group>'\n}\n\nclass ToolBarItemGroup extends HTMLElement<ToolBarItemGroupSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'tool-bar-item-group': ToolBarItemGroup\n }\n}\n\n```\n"
960
914
  },
961
915
  {
962
916
  "name": "tool-bar-item",
@@ -977,7 +931,7 @@
977
931
  "name": "title-key"
978
932
  }
979
933
  ],
980
- "description": "A view placed in the toolbar or navigation bar.\n---"
934
+ "description": "A view placed in the toolbar or navigation bar.\n---\n\n```ts\ninterface ToolBarItemSignature {\n Declaration: '<tool-bar-item></tool-bar-item>'\n\n Attributes: {\n slot?: string\n 'data-previous-slot'?: string\n 'title-key'?: string\n }\n}\n\nclass ToolBarItem extends HTMLElement<ToolBarItemSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'tool-bar-item': ToolBarItem\n }\n}\n\n```\n"
981
935
  },
982
936
  {
983
937
  "name": "tool-bar",
@@ -987,7 +941,7 @@
987
941
  "url": "https://swiftwc.github.io/ui/web-components/tool-bar"
988
942
  }
989
943
  ],
990
- "description": "A list of items placed into the toolbar or navigation bar around your content.\n---\n\n### **Slots:**\n- **cancellation-action** — The item represents a cancellation action for a modal interface. Places the item in the leading edge of the top bar and on the trailing edge of the bottom bar when fine modal\n- **primary-action** — The item represents a primary action. Places the item in the trailing edge of the top bar and on the trailing edge of the bottom bar when fine modal\n- **confirmation-action** — The item represents a confirmation action for a modal interface. Places the item in the trailing edge of the top bar and on the trailing edge of the bottom bar when fine modal\n- **destructive-action** — The item represents a destructive action for a modal interface. Places the item in the leading edge of the top bar and on the leading edge of the bottom bar when fine modal\n- **top-bar-leading** — Places the item in the leading edge of the top bar\n- **top-bar-principal** — Places the item in the middle of the top bar\n- **top-bar-trailing** — Places the item in the trailing edge of the top bar\n- **bottom-bar-leading** — Places the item in the leading edge of the bottom bar\n- **bottom-bar-principal** — Places the item in the middle of the bottom bar\n- **bottom-bar-trailing** — Places the item in the trailing edge of the bottom bar"
944
+ "description": "A list of items placed into the toolbar or navigation bar around your content.\n---\n\n```ts\ninterface ToolBarSignature {\n Declaration: '<tool-bar></tool-bar>'\n\n Slots: {\n 'cancellation-action': HTMLElement[] // The item represents a cancellation action for a modal interface. Places the item in the leading edge of the top bar and on the trailing edge of the bottom bar when fine modal\n 'primary-action': HTMLElement[] // The item represents a primary action. Places the item in the trailing edge of the top bar and on the trailing edge of the bottom bar when fine modal\n 'confirmation-action': HTMLElement[] // The item represents a confirmation action for a modal interface. Places the item in the trailing edge of the top bar and on the trailing edge of the bottom bar when fine modal\n 'destructive-action': HTMLElement[] // The item represents a destructive action for a modal interface. Places the item in the leading edge of the top bar and on the leading edge of the bottom bar when fine modal\n 'top-bar-leading': HTMLElement[] // Places the item in the leading edge of the top bar\n 'top-bar-principal': HTMLElement[] // Places the item in the middle of the top bar\n 'top-bar-trailing': HTMLElement[] // Places the item in the trailing edge of the top bar\n 'bottom-bar-leading': HTMLElement[] // Places the item in the leading edge of the bottom bar\n 'bottom-bar-principal': HTMLElement[] // Places the item in the middle of the bottom bar\n 'bottom-bar-trailing': HTMLElement[] // Places the item in the trailing edge of the bottom bar\n }\n}\n\nclass ToolBar extends HTMLElement<ToolBarSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'tool-bar': ToolBar\n }\n}\n\n```\n"
991
945
  },
992
946
  {
993
947
  "name": "v-keyboard",
@@ -1008,7 +962,7 @@
1008
962
  ]
1009
963
  }
1010
964
  ],
1011
- "description": "Required component, used to handle the virtual keyboard on touch devices.\n---"
965
+ "description": "Required component, used to handle the virtual keyboard on touch devices.\n---\n\n```ts\ninterface VKeyboardSignature {\n Declaration: '<v-keyboard></v-keyboard>'\n\n Attributes: {\n 'system-font'?: 'Inter' // Prefers the \"Inter\" font family, if loaded.\n }\n}\n\nclass VKeyboard extends HTMLElement<VKeyboardSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'v-keyboard': VKeyboard\n }\n}\n\n```\n"
1012
966
  },
1013
967
  {
1014
968
  "name": "v-stack",
@@ -1069,7 +1023,7 @@
1069
1023
  "valueSet": "blockPlacementSet"
1070
1024
  }
1071
1025
  ],
1072
- "description": "A view that arranges its children one on top of the other.\n---"
1026
+ "description": "A view that arranges its children one on top of the other.\n---\n\n```ts\ninterface VStackSignature {\n Declaration: '<v-stack></v-stack>'\n\n Attributes: {\n distribution?:\n | 'leading'\n | 'leading fill'\n | 'center'\n | 'trailing'\n | 'fill'\n | 'space-between' // The distribution of cols\n template?: Template // The main-axis grid template\n spacing?: Spacing // The gap between the primary axis\n alignment?: inlineSet // The cross-axis alignment\n distribution?: blockSet // The main-axis alignment\n placement?: blockPlacementSet // The main-axis alignment\n }\n}\n\nclass VStack extends HTMLElement<VStackSignature> {}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n 'v-stack': VStack\n }\n}\n\n```\n"
1073
1027
  }
1074
1028
  ],
1075
1029
  "globalAttributes": [
@@ -1105,51 +1059,55 @@
1105
1059
  "values": [
1106
1060
  {
1107
1061
  "name": "footnote",
1108
- "description": "A font with the footnote text style"
1062
+ "description": "The font used in footnotes"
1109
1063
  },
1110
1064
  {
1111
1065
  "name": "caption2",
1112
- "description": "Create a font with the alternate caption text style"
1066
+ "description": "The font used the caption2 size"
1113
1067
  },
1114
1068
  {
1115
1069
  "name": "caption",
1116
- "description": "A font with the caption text style"
1070
+ "description": "The font used for standard captions"
1117
1071
  },
1118
1072
  {
1119
1073
  "name": "callout",
1120
- "description": "A font with the callout text style"
1074
+ "description": "The font used for callouts"
1121
1075
  },
1122
1076
  {
1123
1077
  "name": "body",
1124
- "description": "A font with the body text style"
1078
+ "description": "The font used body text"
1125
1079
  },
1126
1080
  {
1127
1081
  "name": "subheadline",
1128
- "description": "A font with the subheadline text style"
1082
+ "description": "The font used subheadings"
1129
1083
  },
1130
1084
  {
1131
1085
  "name": "headline",
1132
- "description": "A font with the headline text style"
1086
+ "description": "The font used headings"
1133
1087
  },
1134
1088
  {
1135
1089
  "name": "title3",
1136
- "description": "Create a font for third level hierarchical headings"
1090
+ "description": "The font used third level hierarchical headings"
1137
1091
  },
1138
1092
  {
1139
1093
  "name": "title2",
1140
- "description": "Create a font for second level hierarchical headings"
1094
+ "description": "The font used second level hierarchical headings"
1141
1095
  },
1142
1096
  {
1143
1097
  "name": "title",
1144
- "description": "A font with the title text style"
1098
+ "description": "The font used first level hierarchical headings"
1145
1099
  },
1146
1100
  {
1147
1101
  "name": "large-title",
1148
- "description": "A font with the large title text style"
1102
+ "description": "The font used large titles"
1149
1103
  },
1150
1104
  {
1151
1105
  "name": "extra-large-title",
1152
- "description": "Create a font with the extra large title text style"
1106
+ "description": "The font used extra large titles"
1107
+ },
1108
+ {
1109
+ "name": "extra-large-title2",
1110
+ "description": "The font used second level extra large titles"
1153
1111
  }
1154
1112
  ]
1155
1113
  },
@@ -1394,6 +1352,10 @@
1394
1352
  {
1395
1353
  "name": "Foreground",
1396
1354
  "values": [
1355
+ {
1356
+ "name": "primary",
1357
+ "description": "Applies the system primary color (`--primary`)"
1358
+ },
1397
1359
  {
1398
1360
  "name": "secondary",
1399
1361
  "description": "Applies the system secondary color (`--secondary`)"
@@ -1600,6 +1562,27 @@
1600
1562
  }
1601
1563
  ]
1602
1564
  },
1565
+ {
1566
+ "name": "ControlSize",
1567
+ "values": [
1568
+ {
1569
+ "name": "mini",
1570
+ "description": "A control version that is minimally sized"
1571
+ },
1572
+ {
1573
+ "name": "regular",
1574
+ "description": "A control version that is the regular size"
1575
+ },
1576
+ {
1577
+ "name": "small",
1578
+ "description": "A control version that is proportionally smaller size for space-constrained views"
1579
+ },
1580
+ {
1581
+ "name": "large",
1582
+ "description": "A control version that is prominently sized"
1583
+ }
1584
+ ]
1585
+ },
1603
1586
  {
1604
1587
  "name": "Template",
1605
1588
  "values": [