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

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 (61) hide show
  1. package/generated/components/alert-dialog.d.ts +1 -1
  2. package/generated/components/alert-dialog.js +1 -1
  3. package/generated/components/body-view.d.ts +1 -1
  4. package/generated/components/body-view.js +1 -1
  5. package/generated/components/confirmation-dialog.d.ts +1 -2
  6. package/generated/components/confirmation-dialog.js +1 -2
  7. package/generated/components/date-picker.js +2 -2
  8. package/generated/components/disclosure-group.d.ts +4 -1
  9. package/generated/components/disclosure-group.js +5 -1
  10. package/generated/components/form-view.d.ts +2 -0
  11. package/generated/components/form-view.js +2 -0
  12. package/generated/components/h-stack.d.ts +2 -2
  13. package/generated/components/h-stack.js +2 -2
  14. package/generated/components/image-view.d.ts +4 -0
  15. package/generated/components/image-view.js +4 -0
  16. package/generated/components/label-view.d.ts +3 -3
  17. package/generated/components/label-view.js +3 -3
  18. package/generated/components/labeled-content.d.ts +8 -0
  19. package/generated/components/labeled-content.js +8 -0
  20. package/generated/components/list-view.d.ts +2 -0
  21. package/generated/components/list-view.js +2 -0
  22. package/generated/components/navigation-large-title.d.ts +7 -0
  23. package/generated/components/navigation-large-title.js +7 -0
  24. package/generated/components/navigation-split-view.d.ts +1 -1
  25. package/generated/components/navigation-split-view.js +1 -1
  26. package/generated/components/navigation-stack.d.ts +1 -1
  27. package/generated/components/navigation-stack.js +1 -1
  28. package/generated/components/navigation-title.d.ts +5 -0
  29. package/generated/components/navigation-title.js +5 -0
  30. package/generated/components/progress-view.d.ts +1 -1
  31. package/generated/components/progress-view.js +1 -1
  32. package/generated/components/scroll-view-proxy.d.ts +1 -1
  33. package/generated/components/scroll-view-proxy.js +1 -1
  34. package/generated/components/scroll-view.d.ts +2 -0
  35. package/generated/components/scroll-view.js +2 -0
  36. package/generated/components/sheet-view.d.ts +3 -0
  37. package/generated/components/sheet-view.js +3 -0
  38. package/generated/components/sidebar-toggle.d.ts +3 -0
  39. package/generated/components/sidebar-toggle.js +3 -0
  40. package/generated/components/sidebar-view.d.ts +3 -0
  41. package/generated/components/sidebar-view.js +3 -0
  42. package/generated/components/tab-bar.d.ts +1 -1
  43. package/generated/components/tab-bar.js +1 -1
  44. package/generated/components/tab-item.d.ts +3 -0
  45. package/generated/components/tab-item.js +3 -0
  46. package/generated/components/tab-view.d.ts +1 -0
  47. package/generated/components/tab-view.js +1 -0
  48. package/generated/components/table-view.d.ts +1 -1
  49. package/generated/components/table-view.js +1 -1
  50. package/generated/components/text-field.js +3 -3
  51. package/generated/components/tool-bar-item-group.d.ts +1 -1
  52. package/generated/components/tool-bar-item-group.js +1 -1
  53. package/generated/components/tool-bar-item.d.ts +1 -1
  54. package/generated/components/tool-bar-item.js +1 -1
  55. package/generated/components/tool-bar.d.ts +1 -1
  56. package/generated/components/tool-bar.js +1 -1
  57. package/generated/components/v-stack.d.ts +2 -2
  58. package/generated/components/v-stack.js +2 -2
  59. package/package.json +6 -4
  60. package/web-components.css-data/en.json +28 -0
  61. package/web-components.html-data/en.json +197 -83
@@ -1,6 +1,6 @@
1
1
  import { DialogBase } from '../namespace-browser/base';
2
2
  /**
3
- * @summary A representation of an alert presentation. Use it from the client module like `void alert('Save failed.')`.
3
+ * @summaryA dialog that shows a message. Use it from the client module like `void alert('Save failed.')`.
4
4
  */
5
5
  export declare class AlertDialog extends DialogBase {
6
6
  #private;
@@ -3,7 +3,7 @@ import { CleanupRegistry } from '../internal/class/cleanup-registry';
3
3
  import { devFlags, onoff, touchGlass } from '../internal/utils';
4
4
  import { DialogBase } from '../namespace-browser/base';
5
5
  /**
6
- * @summary A representation of an alert presentation. Use it from the client module like `void alert('Save failed.')`.
6
+ * @summaryA dialog that shows a message. Use it from the client module like `void alert('Save failed.')`.
7
7
  */
8
8
  export class AlertDialog extends DialogBase {
9
9
  constructor() {
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @summary The content and behavior of the view.
2
+ * @summary A container view that wraps a scroll view, marking it as a screen your app can navigate to.
3
3
  */
4
4
  export declare class BodyView extends HTMLElement {
5
5
  constructor();
@@ -1,6 +1,6 @@
1
1
  import { devFlags } from '../internal/utils';
2
2
  /**
3
- * @summary The content and behavior of the view.
3
+ * @summary A container view that wraps a scroll view, marking it as a screen your app can navigate to.
4
4
  */
5
5
  export class BodyView extends HTMLElement {
6
6
  constructor() {
@@ -1,7 +1,6 @@
1
1
  import { DialogBase } from '../namespace-browser/base';
2
2
  /**
3
- * A representation of a confirmation presentation.
4
- * Use it from the client module like `await confirmation(trigger, 'Permanently erase the items in the Trash?')`.
3
+ * @summary 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?')`.
5
4
  */
6
5
  export declare class ConfirmationDialog extends DialogBase {
7
6
  #private;
@@ -3,8 +3,7 @@ import { CleanupRegistry } from '../internal/class/cleanup-registry';
3
3
  import { devFlags, isInside, onoff, touchGlass } from '../internal/utils';
4
4
  import { DialogBase } from '../namespace-browser/base';
5
5
  /**
6
- * A representation of a confirmation presentation.
7
- * Use it from the client module like `await confirmation(trigger, 'Permanently erase the items in the Trash?')`.
6
+ * @summary 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?')`.
8
7
  */
9
8
  export class ConfirmationDialog extends DialogBase {
10
9
  static get observedAttributes() {
@@ -18,7 +18,7 @@ export class DatePicker extends FormAssociatedBase {
18
18
  */
19
19
  'date-picker-style',
20
20
  /**
21
- * @type {required}
21
+ * @type {boolean}
22
22
  */
23
23
  'required',
24
24
  'prompt',
@@ -26,7 +26,7 @@ export class DatePicker extends FormAssociatedBase {
26
26
  'name',
27
27
  'selection',
28
28
  /**
29
- * @type {disabled}
29
+ * @type {boolean}
30
30
  */
31
31
  'disabled',
32
32
  'minimum',
@@ -1,8 +1,11 @@
1
1
  import { DetailsBase } from '../namespace-browser/base';
2
2
  /**
3
- * @summary A view that shows or hides another content view, based on the state of a disclosure control.
3
+ * @summary A view that shows or hides another view when the user opens or closes it.
4
4
  *
5
5
  * @example <details is="disclosure-group"><summary><label-view title="Items"></label-view></summary><label-view title="Item 1"></label-view><label-view title="Item 2"></label-view><details is="disclosure-group"><summary><label-view title="Sub-items"></label-view></summary><label-view title="Sub-item 1"></label-view></details></details>
6
+ *
7
+ * @fires is-expanded
8
+ * @fires is-collapsed
6
9
  */
7
10
  export declare class DisclosureGroup extends DetailsBase {
8
11
  #private;
@@ -3,15 +3,19 @@ import { cssTime, devFlags, onoff, timeout } from '../internal/utils';
3
3
  import { DetailsBase } from '../namespace-browser/base';
4
4
  const toggleTimers = new WeakMap();
5
5
  /**
6
- * @summary A view that shows or hides another content view, based on the state of a disclosure control.
6
+ * @summary A view that shows or hides another view when the user opens or closes it.
7
7
  *
8
8
  * @example <details is="disclosure-group"><summary><label-view title="Items"></label-view></summary><label-view title="Item 1"></label-view><label-view title="Item 2"></label-view><details is="disclosure-group"><summary><label-view title="Sub-items"></label-view></summary><label-view title="Sub-item 1"></label-view></details></details>
9
+ *
10
+ * @fires is-expanded
11
+ * @fires is-collapsed
9
12
  */
10
13
  export class DisclosureGroup extends DetailsBase {
11
14
  static get observedAttributes() {
12
15
  return [
13
16
  /**
14
17
  * The status of this element
18
+ * @type {boolean}
15
19
  */
16
20
  'open',
17
21
  ];
@@ -1,5 +1,7 @@
1
1
  import { FormBase } from '../namespace-browser/base';
2
2
  /**
3
+ * @summary A container view that groups controls together for entering data, like a settings screen.
4
+ *
3
5
  * @attr {hidden} navigation-link-indicator-visibility — Hides accessories like right-arrow-chevron on NavigationLink buttons inside.
4
6
  */
5
7
  export declare class FormView extends FormBase {
@@ -2,6 +2,8 @@ import { CleanupRegistry } from '../internal/class/cleanup-registry';
2
2
  import { devFlags, listActive, onoff } from '../internal/utils';
3
3
  import { FormBase } from '../namespace-browser/base';
4
4
  /**
5
+ * @summary A container view that groups controls together for entering data, like a settings screen.
6
+ *
5
7
  * @attr {hidden} navigation-link-indicator-visibility — Hides accessories like right-arrow-chevron on NavigationLink buttons inside.
6
8
  */
7
9
  export class FormView extends FormBase {
@@ -1,9 +1,9 @@
1
1
  /**
2
2
  * @summary A view that arranges its children side by side.
3
3
  *
4
- * @attr {@templateSet} template — The main-axis grid template
4
+ * @attr {@Template} template — The main-axis grid template
5
5
  *
6
- * @attr {@spacingSet} spacing — The gap between the primary axis
6
+ * @attr {@Spacing} spacing — The gap between the primary axis
7
7
  *
8
8
  * @attr {@blockSet} alignment — The cross-axis alignment
9
9
  * @attr {@inlineSet} distribution — The main-axis alignment
@@ -2,9 +2,9 @@ import { devFlags } from '../internal/utils';
2
2
  /**
3
3
  * @summary A view that arranges its children side by side.
4
4
  *
5
- * @attr {@templateSet} template — The main-axis grid template
5
+ * @attr {@Template} template — The main-axis grid template
6
6
  *
7
- * @attr {@spacingSet} spacing — The gap between the primary axis
7
+ * @attr {@Spacing} spacing — The gap between the primary axis
8
8
  *
9
9
  * @attr {@blockSet} alignment — The cross-axis alignment
10
10
  * @attr {@inlineSet} distribution — The main-axis alignment
@@ -1,3 +1,7 @@
1
+ /**
2
+ * @summary A view that displays an image.
3
+ *
4
+ */
1
5
  export declare class ImageView extends HTMLElement {
2
6
  #private;
3
7
  static get observedAttributes(): string[];
@@ -1,5 +1,9 @@
1
1
  import { $, devFlags } from '../internal/utils';
2
2
  import { html, queryMorph } from '../morphdom';
3
+ /**
4
+ * @summary A view that displays an image.
5
+ *
6
+ */
3
7
  export class ImageView extends HTMLElement {
4
8
  static get observedAttributes() {
5
9
  return ['system-name', 'system-weight'];
@@ -6,10 +6,10 @@
6
6
  * @example <label-view system-image="hand-waving"><span>Hello world!</span></label-view> — Creating a label with an icon and a title using the `system-image` attribute
7
7
  * @example <label-view><i slot="icon" class="ph ph-duotone ph-hand-waving"></i><span>Hello world!</span></label-view> — Creating a label with an icon and a title using the `icon` slot
8
8
  *
9
- * @attr {@fontSet} font — Sets the default font for text in this view.
9
+ * @attr {@Font} font — Sets the default font for text in this view.
10
10
  *
11
- * @slot — Any children without a `slot` attribute are placed in the title block of the label.
12
- * @slot icon — Use the `slot="icon"` attribute to place childen in the icon block of the label.
11
+ * @slot — Any children without a `slot` attribute are placed in the title block.
12
+ * @slot icon — Use the `slot="icon"` attribute to place childen in the icon block.
13
13
  *
14
14
  */
15
15
  export declare class LabelView extends HTMLElement {
@@ -8,10 +8,10 @@ import { html, queryMorph } from '../morphdom';
8
8
  * @example <label-view system-image="hand-waving"><span>Hello world!</span></label-view> — Creating a label with an icon and a title using the `system-image` attribute
9
9
  * @example <label-view><i slot="icon" class="ph ph-duotone ph-hand-waving"></i><span>Hello world!</span></label-view> — Creating a label with an icon and a title using the `icon` slot
10
10
  *
11
- * @attr {@fontSet} font — Sets the default font for text in this view.
11
+ * @attr {@Font} font — Sets the default font for text in this view.
12
12
  *
13
- * @slot — Any children without a `slot` attribute are placed in the title block of the label.
14
- * @slot icon — Use the `slot="icon"` attribute to place childen in the icon block of the label.
13
+ * @slot — Any children without a `slot` attribute are placed in the title block.
14
+ * @slot icon — Use the `slot="icon"` attribute to place childen in the icon block.
15
15
  *
16
16
  */
17
17
  export class LabelView extends HTMLElement {
@@ -1,3 +1,11 @@
1
+ /**
2
+ * @summary A container view that pairs a label with a value.
3
+ *
4
+ * @slot — The default slot.
5
+ * @slot label — Use the `slot="label"` attribute to place childen in the label block.
6
+ * @slot header
7
+ * @slot footer
8
+ */
1
9
  export declare class LabeledContent extends HTMLElement {
2
10
  #private;
3
11
  static get observedAttributes(): string[];
@@ -1,5 +1,13 @@
1
1
  import { $, devFlags } from '../internal/utils';
2
2
  import { html, queryMorph } from '../morphdom';
3
+ /**
4
+ * @summary A container view that pairs a label with a value.
5
+ *
6
+ * @slot — The default slot.
7
+ * @slot label — Use the `slot="label"` attribute to place childen in the label block.
8
+ * @slot header
9
+ * @slot footer
10
+ */
3
11
  export class LabeledContent extends HTMLElement {
4
12
  static get observedAttributes() {
5
13
  return [
@@ -1,4 +1,6 @@
1
1
  /**
2
+ * @summary A container view that arranges rows of data in a single column, optionally letting the user select one or more of them.
3
+ *
2
4
  * @attr {hidden} navigation-link-indicator-visibility — Hides accessories like right-arrow-chevron on NavigationLink buttons inside.
3
5
  */
4
6
  export declare class ListView extends HTMLElement {
@@ -1,6 +1,8 @@
1
1
  import { CleanupRegistry } from '../internal/class/cleanup-registry';
2
2
  import { devFlags, listActive, onoff } from '../internal/utils';
3
3
  /**
4
+ * @summary A container view that arranges rows of data in a single column, optionally letting the user select one or more of them.
5
+ *
4
6
  * @attr {hidden} navigation-link-indicator-visibility — Hides accessories like right-arrow-chevron on NavigationLink buttons inside.
5
7
  */
6
8
  export class ListView extends HTMLElement {
@@ -1,3 +1,10 @@
1
+ /**
2
+ *
3
+ * @attr {grouped} background-style
4
+ * @attr {boolean} padding
5
+ * @attr {boolean} navigation-bar-auto-hide
6
+ *
7
+ */
1
8
  export declare class NavigationLargeTitle extends HTMLElement {
2
9
  #private;
3
10
  constructor();
@@ -67,6 +67,13 @@ function isIntersectingWithContainer(el, container, rootMargin = '0px 0px 0px 0p
67
67
  };
68
68
  return !(elRect.bottom < marginRect.top || elRect.top > marginRect.bottom || elRect.right < marginRect.left || elRect.left > marginRect.right);
69
69
  }
70
+ /**
71
+ *
72
+ * @attr {grouped} background-style
73
+ * @attr {boolean} padding
74
+ * @attr {boolean} navigation-bar-auto-hide
75
+ *
76
+ */
70
77
  export class NavigationLargeTitle extends HTMLElement {
71
78
  #styleObserver;
72
79
  #scrollObserver;
@@ -1,6 +1,6 @@
1
1
  import { NavigationView } from '../internal/class/navigation-view';
2
2
  /**
3
- * @summary A view with two or three side-by-side sections, where what you choose in the left section changes what appears in the next section.
3
+ * @summary 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.
4
4
  */
5
5
  export declare class NavigationSplitView extends NavigationView {
6
6
  constructor();
@@ -1,7 +1,7 @@
1
1
  import { NavigationView } from '../internal/class/navigation-view';
2
2
  import { devFlags } from '../internal/utils';
3
3
  /**
4
- * @summary A view with two or three side-by-side sections, where what you choose in the left section changes what appears in the next section.
4
+ * @summary 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.
5
5
  */
6
6
  export class NavigationSplitView extends NavigationView {
7
7
  constructor() {
@@ -1,6 +1,6 @@
1
1
  import { NavigationView } from '../internal/class/navigation-view';
2
2
  /**
3
- * @summary A view that shows a main screen and lets you open other screens on top of it.
3
+ * @summary A container view that shows a main screen and lets the user open other screens on top of it.
4
4
  */
5
5
  export declare class NavigationStack extends NavigationView {
6
6
  constructor();
@@ -1,7 +1,7 @@
1
1
  import { NavigationView } from '../internal/class/navigation-view';
2
2
  import { devFlags } from '../internal/utils';
3
3
  /**
4
- * @summary A view that shows a main screen and lets you open other screens on top of it.
4
+ * @summary A container view that shows a main screen and lets the user open other screens on top of it.
5
5
  */
6
6
  export class NavigationStack extends NavigationView {
7
7
  constructor() {
@@ -1,3 +1,8 @@
1
+ /**
2
+ * @summary A container view.
3
+ *
4
+ * @attr {boolean} padding
5
+ */
1
6
  export declare class NavigationTitle extends HTMLElement {
2
7
  #private;
3
8
  static get observedAttributes(): string[];
@@ -8,6 +8,11 @@ var NavigationTitle_1;
8
8
  import { microtaskOnConnected } from '../internal/decorators';
9
9
  import { devFlags } from '../internal/utils';
10
10
  import { html, queryMorph } from '../morphdom';
11
+ /**
12
+ * @summary A container view.
13
+ *
14
+ * @attr {boolean} padding
15
+ */
11
16
  let NavigationTitle = NavigationTitle_1 = class NavigationTitle extends HTMLElement {
12
17
  static get observedAttributes() {
13
18
  return ['value', 'subtitle', 'system-image', 'system-image-weight'];
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @summary A view that shows the progress toward completion of a task.
2
+ * @summary A view that shows how far along a task is.
3
3
  *
4
4
  * @slot — The default slot.
5
5
  * @slot current-value
@@ -6,7 +6,7 @@ import { html, queryMorph } from '../morphdom';
6
6
  import { Snapshot } from '../snapshot';
7
7
  const progressViewStyles = ['circular', 'linear'];
8
8
  /**
9
- * @summary A view that shows the progress toward completion of a task.
9
+ * @summary A view that shows how far along a task is.
10
10
  *
11
11
  * @slot — The default slot.
12
12
  * @slot current-value
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @summary A wrapper to {hv}-stacks
2
+ * @summary A wrapper for {hv}-stacks
3
3
  */
4
4
  export declare class ScrollViewProxy extends HTMLElement {
5
5
  constructor();
@@ -1,6 +1,6 @@
1
1
  import { devFlags } from '../internal/utils';
2
2
  /**
3
- * @summary A wrapper to {hv}-stacks
3
+ * @summary A wrapper for {hv}-stacks
4
4
  */
5
5
  export class ScrollViewProxy extends HTMLElement {
6
6
  constructor() {
@@ -1,4 +1,6 @@
1
1
  /**
2
+ * @summary A view that scrolls its content when it doesn’t fit the screen.
3
+ *
2
4
  * @slot — The default slot.
3
5
  * @slot top-bar-principal
4
6
  * @slot bottom-bar-principal
@@ -6,6 +6,8 @@ import { $, devFlags, frame, onoff, slowHideShow } from '../internal/utils';
6
6
  import { html, queryMorph } from '../morphdom';
7
7
  const observers = new ResizeObserverSingleton();
8
8
  /**
9
+ * @summary A view that scrolls its content when it doesn’t fit the screen.
10
+ *
9
11
  * @slot — The default slot.
10
12
  * @slot top-bar-principal
11
13
  * @slot bottom-bar-principal
@@ -1,4 +1,7 @@
1
1
  import { DialogBase } from '../namespace-browser/base';
2
+ /**
3
+ * @summary A dialog that slides up over the current screen.
4
+ */
2
5
  export declare class SheetView extends DialogBase {
3
6
  #private;
4
7
  constructor();
@@ -1,6 +1,9 @@
1
1
  import { CleanupRegistry } from '../internal/class/cleanup-registry';
2
2
  import { devFlags, onoff } from '../internal/utils';
3
3
  import { DialogBase } from '../namespace-browser/base';
4
+ /**
5
+ * @summary A dialog that slides up over the current screen.
6
+ */
4
7
  export class SheetView extends DialogBase {
5
8
  constructor() {
6
9
  super();
@@ -1,3 +1,6 @@
1
+ /**
2
+ * @summary A control that shows or hides the sidebar view.
3
+ */
1
4
  export declare class SidebarToggle extends HTMLElement {
2
5
  #private;
3
6
  constructor();
@@ -3,6 +3,9 @@ import { CleanupRegistry } from '../internal/class/cleanup-registry';
3
3
  import { ResizeObserverSingleton } from '../internal/class/resize-observer-singleton';
4
4
  import { debounce, devFlags, onoff } from '../internal/utils';
5
5
  const observers = new ResizeObserverSingleton();
6
+ /**
7
+ * @summary A control that shows or hides the sidebar view.
8
+ */
6
9
  export class SidebarToggle extends HTMLElement {
7
10
  constructor() {
8
11
  super();
@@ -1,4 +1,7 @@
1
1
  import { DialogBase } from '../namespace-browser/base';
2
+ /**
3
+ * @summary A container view that arranges navigation destinations in a single column.
4
+ */
2
5
  export declare class SidebarView extends DialogBase {
3
6
  #private;
4
7
  constructor();
@@ -1,6 +1,9 @@
1
1
  import { CleanupRegistry } from '../internal/class/cleanup-registry';
2
2
  import { devFlags, onoff, touchGlass } from '../internal/utils';
3
3
  import { DialogBase } from '../namespace-browser/base';
4
+ /**
5
+ * @summary A container view that arranges navigation destinations in a single column.
6
+ */
4
7
  export class SidebarView extends DialogBase {
5
8
  constructor() {
6
9
  super();
@@ -1,6 +1,6 @@
1
1
  import { DialogBase } from '../namespace-browser/base';
2
2
  /**
3
- * @summary A screen that lets users switch between different views using buttons, tabs, or other controls.
3
+ * @summary A container view that groups tab-items together along the top or bottom of the screen.
4
4
  */
5
5
  export declare class TabBar extends DialogBase {
6
6
  #private;
@@ -2,7 +2,7 @@ import { CleanupRegistry } from '../internal/class/cleanup-registry';
2
2
  import { devFlags, onoff, touchGlass } from '../internal/utils';
3
3
  import { DialogBase } from '../namespace-browser/base';
4
4
  /**
5
- * @summary A screen that lets users switch between different views using buttons, tabs, or other controls.
5
+ * @summary A container view that groups tab-items together along the top or bottom of the screen.
6
6
  */
7
7
  export class TabBar extends DialogBase {
8
8
  constructor() {
@@ -1,4 +1,7 @@
1
1
  import { ButtonBase } from '../namespace-browser/base';
2
+ /**
3
+ * @summary A control that switches the tab view to this tab.
4
+ */
2
5
  export declare class TabItem extends ButtonBase {
3
6
  #private;
4
7
  constructor();
@@ -2,6 +2,9 @@ import { CleanupRegistry } from '../internal/class/cleanup-registry';
2
2
  import { devFlags, onoff } from '../internal/utils';
3
3
  import { ButtonBase } from '../namespace-browser/base';
4
4
  import { TabView } from './tab-view';
5
+ /**
6
+ * @summary A control that switches the tab view to this tab.
7
+ */
5
8
  export class TabItem extends ButtonBase {
6
9
  constructor() {
7
10
  super();
@@ -3,6 +3,7 @@ import { type NavigationStack } from './navigation-stack';
3
3
  declare const TAB_BAR_PLACEMENTS: readonly ["bottom-bar", "ornament", "sidebar", "top-bar"];
4
4
  export type TabBarPlacement = (typeof TAB_BAR_PLACEMENTS)[number];
5
5
  /**
6
+ * @summary A container view that switches between screens using tabs.
6
7
  *
7
8
  * @cssprop --adaptable-tab-bar-placement
8
9
  *
@@ -6,6 +6,7 @@ import { $, cssTime, debounce, devFlags, frame, onoff, timeout } from '../intern
6
6
  import { Snapshot } from '../snapshot';
7
7
  const TAB_BAR_PLACEMENTS = ['bottom-bar', 'ornament', 'sidebar', 'top-bar'];
8
8
  /**
9
+ * @summary A container view that switches between screens using tabs.
9
10
  *
10
11
  * @cssprop --adaptable-tab-bar-placement
11
12
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @summary Display selectable, sortable data arranged in rows and columns.
2
+ * @summary A container view that arranges data in rows and columns, optionally letting the user select one or more of them.
3
3
  *
4
4
  * @attr {title:trailing:subtitle|trailing:title:subtitle|title:subtitle:trailing|*} preferred-compact-template — Sets the template areas when the table is in compact mode
5
5
  *
@@ -6,7 +6,7 @@ import { $, devFlags, listActive, onoff } from '../internal/utils';
6
6
  import { html, queryMorph } from '../morphdom';
7
7
  import { Snapshot } from '../snapshot';
8
8
  /**
9
- * @summary Display selectable, sortable data arranged in rows and columns.
9
+ * @summary A container view that arranges data in rows and columns, optionally letting the user select one or more of them.
10
10
  *
11
11
  * @attr {title:trailing:subtitle|trailing:title:subtitle|title:subtitle:trailing|*} preferred-compact-template — Sets the template areas when the table is in compact mode
12
12
  *
@@ -25,7 +25,7 @@ export class TextField extends FormAssociatedBase {
25
25
  'text',
26
26
  'text-input-autocapitalization',
27
27
  /**
28
- * @type {""}
28
+ * @type {boolean}
29
29
  */
30
30
  'disable-autocorrection',
31
31
  /**
@@ -33,11 +33,11 @@ export class TextField extends FormAssociatedBase {
33
33
  */
34
34
  'keyboard-type',
35
35
  /**
36
- * @type {required}
36
+ * @type {boolean}
37
37
  */
38
38
  'required',
39
39
  /**
40
- * @type {disabled}
40
+ * @type {boolean}
41
41
  */
42
42
  'disabled',
43
43
  ];
@@ -1,5 +1,5 @@
1
1
  /**
2
- * A model that represents a group of `ToolbarItems` which can be placed in the toolbar or navigation bar.
2
+ * @summary A container view that groups items together in the toolbar or navigation bar.
3
3
  */
4
4
  export declare class ToolBarItemGroup extends HTMLElement {
5
5
  constructor();
@@ -9,7 +9,7 @@ import { CleanupRegistry } from '../internal/class/cleanup-registry';
9
9
  import { adaptiveSlot } from '../internal/decorators';
10
10
  import { devFlags } from '../internal/utils';
11
11
  /**
12
- * A model that represents a group of `ToolbarItems` which can be placed in the toolbar or navigation bar.
12
+ * @summary A container view that groups items together in the toolbar or navigation bar.
13
13
  */
14
14
  let ToolBarItemGroup = ToolBarItemGroup_1 = class ToolBarItemGroup extends HTMLElement {
15
15
  constructor() {
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @summary A model that represents an item which can be placed in the toolbar or navigation bar.
2
+ * @summary A view placed in the toolbar or navigation bar.
3
3
  */
4
4
  export declare class ToolBarItem extends HTMLElement {
5
5
  #private;
@@ -10,7 +10,7 @@ import { adaptiveSlot } from '../internal/decorators';
10
10
  import { devFlags, ensurePlaceholder, onoff, touchGlass } from '../internal/utils';
11
11
  import { Snapshot } from '../snapshot';
12
12
  /**
13
- * @summary A model that represents an item which can be placed in the toolbar or navigation bar.
13
+ * @summary A view placed in the toolbar or navigation bar.
14
14
  */
15
15
  let ToolBarItem = ToolBarItem_1 = class ToolBarItem extends HTMLElement {
16
16
  static get observedAttributes() {
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @summary Populates the toolbar or navigation bar with the specified items.
2
+ * @summary A list of items placed into the toolbar or navigation bar around your content.
3
3
  *
4
4
  * @slot 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
5
5
  * @slot 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
@@ -3,7 +3,7 @@ import { ResizeObserverSingleton } from '../internal/class/resize-observer-singl
3
3
  import { $, devFlags } from '../internal/utils';
4
4
  const observers = new ResizeObserverSingleton();
5
5
  /**
6
- * @summary Populates the toolbar or navigation bar with the specified items.
6
+ * @summary A list of items placed into the toolbar or navigation bar around your content.
7
7
  *
8
8
  * @slot 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
9
9
  * @slot 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