@fluentui/web-components 3.0.0-rc.8 → 3.0.0-rc.9

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 (42) hide show
  1. package/CHANGELOG.md +11 -2
  2. package/custom-elements.json +66 -38
  3. package/dist/esm/badge/badge.options.d.ts +3 -1
  4. package/dist/esm/badge/badge.options.js.map +1 -1
  5. package/dist/esm/counter-badge/counter-badge.d.ts +2 -1
  6. package/dist/esm/counter-badge/counter-badge.js +2 -1
  7. package/dist/esm/counter-badge/counter-badge.js.map +1 -1
  8. package/dist/esm/dialog/dialog.d.ts +20 -10
  9. package/dist/esm/dialog/dialog.js +12 -6
  10. package/dist/esm/dialog/dialog.js.map +1 -1
  11. package/dist/esm/drawer/drawer.d.ts +18 -9
  12. package/dist/esm/drawer/drawer.js +12 -6
  13. package/dist/esm/drawer/drawer.js.map +1 -1
  14. package/dist/esm/message-bar/message-bar.d.ts +2 -1
  15. package/dist/esm/message-bar/message-bar.js +2 -1
  16. package/dist/esm/message-bar/message-bar.js.map +1 -1
  17. package/dist/esm/message-bar/message-bar.options.d.ts +6 -3
  18. package/dist/esm/message-bar/message-bar.options.js +6 -3
  19. package/dist/esm/message-bar/message-bar.options.js.map +1 -1
  20. package/dist/esm/progress-bar/progress-bar.base.d.ts +16 -4
  21. package/dist/esm/progress-bar/progress-bar.base.js +4 -1
  22. package/dist/esm/progress-bar/progress-bar.base.js.map +1 -1
  23. package/dist/esm/progress-bar/progress-bar.d.ts +8 -2
  24. package/dist/esm/progress-bar/progress-bar.js.map +1 -1
  25. package/dist/esm/styles/partials/badge.partials.d.ts +2 -1
  26. package/dist/esm/styles/partials/badge.partials.js +2 -1
  27. package/dist/esm/styles/partials/badge.partials.js.map +1 -1
  28. package/dist/esm/textarea/textarea.base.d.ts +5 -0
  29. package/dist/esm/textarea/textarea.base.js +4 -1
  30. package/dist/esm/textarea/textarea.base.js.map +1 -1
  31. package/dist/esm/textarea/textarea.template.js +1 -1
  32. package/dist/esm/textarea/textarea.template.js.map +1 -1
  33. package/dist/esm/tree/tree.d.ts +8 -2
  34. package/dist/esm/tree/tree.js +8 -2
  35. package/dist/esm/tree/tree.js.map +1 -1
  36. package/dist/esm/tree-item/tree-item.base.d.ts +8 -2
  37. package/dist/esm/tree-item/tree-item.base.js +8 -2
  38. package/dist/esm/tree-item/tree-item.base.js.map +1 -1
  39. package/dist/web-components.d.ts +93 -34
  40. package/dist/web-components.js +26 -14
  41. package/dist/web-components.min.js +15 -15
  42. package/package.json +1 -1
@@ -2232,8 +2232,11 @@ export declare class BaseProgressBar extends FASTElement {
2232
2232
  elementInternals: ElementInternals;
2233
2233
  /**
2234
2234
  * The validation state of the progress bar
2235
- * @public
2235
+ * The validation state of the progress bar
2236
+ *
2236
2237
  * HTML Attribute: `validation-state`
2238
+ *
2239
+ * @public
2237
2240
  */
2238
2241
  validationState: ProgressBarValidationState | null;
2239
2242
  /**
@@ -2244,8 +2247,11 @@ export declare class BaseProgressBar extends FASTElement {
2244
2247
  validationStateChanged(prev: ProgressBarValidationState | undefined, next: ProgressBarValidationState | undefined): void;
2245
2248
  /**
2246
2249
  * The value of the progress
2247
- * @internal
2250
+ * The value of the progress
2251
+ *
2248
2252
  * HTML Attribute: `value`
2253
+ *
2254
+ * @internal
2249
2255
  */
2250
2256
  value?: number;
2251
2257
  /**
@@ -2256,8 +2262,11 @@ export declare class BaseProgressBar extends FASTElement {
2256
2262
  protected valueChanged(prev: number | undefined, next: number | undefined): void;
2257
2263
  /**
2258
2264
  * The minimum value
2259
- * @internal
2265
+ * The minimum value
2266
+ *
2260
2267
  * HTML Attribute: `min`
2268
+ *
2269
+ * @internal
2261
2270
  */
2262
2271
  min?: number;
2263
2272
  /**
@@ -2269,8 +2278,11 @@ export declare class BaseProgressBar extends FASTElement {
2269
2278
  protected minChanged(prev: number | undefined, next: number | undefined): void;
2270
2279
  /**
2271
2280
  * The maximum value
2272
- * @internal
2281
+ * The maximum value
2282
+ *
2273
2283
  * HTML Attribute: `max`
2284
+ *
2285
+ * @internal
2274
2286
  */
2275
2287
  max?: number;
2276
2288
  /**
@@ -2600,6 +2612,11 @@ export declare class BaseTextArea extends FASTElement {
2600
2612
  * @internal
2601
2613
  */
2602
2614
  labelEl: HTMLLabelElement;
2615
+ /**
2616
+ * The root container element.
2617
+ * @internal
2618
+ */
2619
+ rootEl: HTMLDivElement;
2603
2620
  /**
2604
2621
  * The `<textarea>` element.
2605
2622
  * @internal
@@ -3399,8 +3416,11 @@ declare class BaseTreeItem extends FASTElement {
3399
3416
  constructor();
3400
3417
  /**
3401
3418
  * When true, the control will be appear expanded by user interaction.
3402
- * @public
3419
+ * When true, the control will be appear expanded by user interaction.
3420
+ *
3403
3421
  * HTML Attribute: `expanded`
3422
+ *
3423
+ * @public
3404
3424
  */
3405
3425
  expanded: boolean;
3406
3426
  /**
@@ -3428,8 +3448,11 @@ declare class BaseTreeItem extends FASTElement {
3428
3448
  protected selectedChanged(prev: boolean, next: boolean): void;
3429
3449
  /**
3430
3450
  * When true, the control has no child tree items
3431
- * @public
3451
+ * When true, the control has no child tree items
3452
+ *
3432
3453
  * HTML Attribute: empty
3454
+ *
3455
+ * @public
3433
3456
  */
3434
3457
  empty: boolean;
3435
3458
  private styles;
@@ -6168,10 +6191,11 @@ export declare class CounterBadge extends FASTElement {
6168
6191
  */
6169
6192
  dot: boolean;
6170
6193
  /**
6171
- * @internal
6172
6194
  * Function to set the count
6173
6195
  * This is the default slotted content for the counter badge
6174
6196
  * If children are slotted, that will override the value returned
6197
+ *
6198
+ * @internal
6175
6199
  */
6176
6200
  setCount(): string | void;
6177
6201
  }
@@ -6348,58 +6372,68 @@ export declare const darkModeStylesheetBehavior: (styles: ElementStyles) => Matc
6348
6372
  */
6349
6373
  export declare class Dialog extends FASTElement {
6350
6374
  /**
6351
- * @public
6352
6375
  * The dialog element
6376
+ *
6377
+ * @public
6353
6378
  */
6354
6379
  dialog: HTMLDialogElement;
6355
6380
  /**
6356
- * @public
6357
6381
  * The ID of the element that describes the dialog
6382
+ *
6383
+ * @public
6358
6384
  */
6359
6385
  ariaDescribedby?: string;
6360
6386
  /**
6361
- * @public
6362
6387
  * The ID of the element that labels the dialog
6388
+ *
6389
+ * @public
6363
6390
  */
6364
6391
  ariaLabelledby?: string;
6365
6392
  /**
6366
- * @public
6367
6393
  * The label of the dialog
6394
+ *
6395
+ * @public
6368
6396
  */
6369
6397
  ariaLabel: string | null;
6370
6398
  /**
6371
- * @public
6372
6399
  * The type of the dialog modal
6400
+ *
6401
+ * @public
6373
6402
  */
6374
6403
  type: DialogType;
6375
6404
  protected typeChanged(prev: DialogType | undefined, next: DialogType | undefined): void;
6376
6405
  /** @internal */
6377
6406
  connectedCallback(): void;
6378
6407
  /**
6379
- * @public
6380
6408
  * Method to emit an event before the dialog's open state changes
6381
6409
  * HTML spec proposal: https://github.com/whatwg/html/issues/9733
6410
+ *
6411
+ * @public
6382
6412
  */
6383
6413
  emitBeforeToggle: () => void;
6384
6414
  /**
6385
- * @public
6386
6415
  * Method to emit an event after the dialog's open state changes
6387
6416
  * HTML spec proposal: https://github.com/whatwg/html/issues/9733
6417
+ *
6418
+ * @public
6388
6419
  */
6389
6420
  emitToggle: () => void;
6390
6421
  /**
6391
- * @public
6392
6422
  * Method to show the dialog
6423
+ *
6424
+ * @public
6393
6425
  */
6394
6426
  show(): void;
6395
6427
  /**
6396
- * @public
6397
6428
  * Method to hide the dialog
6429
+ *
6430
+ * @public
6398
6431
  */
6399
6432
  hide(): void;
6400
6433
  /**
6401
- * @public
6402
6434
  * Handles click events on the dialog overlay for light-dismiss
6435
+ *
6436
+ * @public
6403
6437
  * @param event - The click event
6404
6438
  * @returns boolean
6405
6439
  */
@@ -6635,20 +6669,23 @@ export declare const DividerTemplate: ElementViewTemplate<Divider>;
6635
6669
  export declare class Drawer extends FASTElement {
6636
6670
  protected roleAttrObserver: MutationObserver;
6637
6671
  /**
6638
- * @public
6639
6672
  * Determines whether the drawer should be displayed as modal or non-modal
6640
6673
  * When rendered as a modal, an overlay is applied over the rest of the view.
6674
+ *
6675
+ * @public
6641
6676
  */
6642
6677
  type: DrawerType;
6643
6678
  protected typeChanged(): void;
6644
6679
  /**
6645
- * @public
6646
6680
  * The ID of the element that labels the drawer.
6681
+ *
6682
+ * @public
6647
6683
  */
6648
6684
  ariaLabelledby?: string;
6649
6685
  /**
6650
- * @public
6651
6686
  * The ID of the element that describes the drawer.
6687
+ *
6688
+ * @public
6652
6689
  */
6653
6690
  ariaDescribedby?: string;
6654
6691
  /**""
@@ -6664,8 +6701,9 @@ export declare class Drawer extends FASTElement {
6664
6701
  */
6665
6702
  size: DrawerSize;
6666
6703
  /**
6667
- * @public
6668
6704
  * The dialog element.
6705
+ *
6706
+ * @public
6669
6707
  */
6670
6708
  dialog: HTMLDialogElement;
6671
6709
  /** @internal */
@@ -6673,25 +6711,29 @@ export declare class Drawer extends FASTElement {
6673
6711
  /** @internal */
6674
6712
  disconnectedCallback(): void;
6675
6713
  /**
6676
- * @public
6677
6714
  * Method to emit an event after the dialog's open state changes
6678
6715
  * HTML spec proposal: https://github.com/whatwg/html/issues/9733
6716
+ *
6717
+ * @public
6679
6718
  */
6680
6719
  emitToggle: () => void;
6681
6720
  /**
6682
- * @public
6683
6721
  * Method to emit an event before the dialog's open state changes
6684
6722
  * HTML spec proposal: https://github.com/whatwg/html/issues/9733
6723
+ *
6724
+ * @public
6685
6725
  */
6686
6726
  emitBeforeToggle: () => void;
6687
6727
  /**
6688
- * @public
6689
6728
  * Method to show the drawer
6729
+ *
6730
+ * @public
6690
6731
  */
6691
6732
  show(): void;
6692
6733
  /**
6693
- * @public
6694
6734
  * Method to hide the drawer
6735
+ *
6736
+ * @public
6695
6737
  */
6696
6738
  hide(): void;
6697
6739
  /**
@@ -6702,8 +6744,9 @@ export declare class Drawer extends FASTElement {
6702
6744
  */
6703
6745
  clickHandler(event: Event): boolean;
6704
6746
  /**
6705
- * @public
6706
6747
  * Handles cancel events on the drawer.
6748
+ *
6749
+ * @public
6707
6750
  */
6708
6751
  cancelHandler(): void;
6709
6752
  protected observeRoleAttr(): void;
@@ -8773,8 +8816,9 @@ export declare class MessageBar extends FASTElement {
8773
8816
  */
8774
8817
  intent?: MessageBarIntent;
8775
8818
  /**
8776
- * @public
8777
8819
  * Method to emit a `dismiss` event when the message bar is dismissed
8820
+ *
8821
+ * @public
8778
8822
  */
8779
8823
  dismissMessageBar: () => void;
8780
8824
  }
@@ -8789,8 +8833,9 @@ export declare class MessageBar extends FASTElement {
8789
8833
  export declare const MessageBarDefinition: FASTElementDefinition<typeof MessageBar>;
8790
8834
 
8791
8835
  /**
8792
- * @public
8793
8836
  * The `intent` variations for the MessageBar component.
8837
+ *
8838
+ * @public
8794
8839
  */
8795
8840
  export declare const MessageBarIntent: {
8796
8841
  readonly success: "success";
@@ -8802,8 +8847,9 @@ export declare const MessageBarIntent: {
8802
8847
  export declare type MessageBarIntent = ValuesOf<typeof MessageBarIntent>;
8803
8848
 
8804
8849
  /**
8805
- * @public
8806
8850
  * The `layout` variations for the MessageBar component.
8851
+ *
8852
+ * @public
8807
8853
  */
8808
8854
  export declare const MessageBarLayout: {
8809
8855
  readonly multiline: "multiline";
@@ -8813,8 +8859,9 @@ export declare const MessageBarLayout: {
8813
8859
  export declare type MessageBarLayout = ValuesOf<typeof MessageBarLayout>;
8814
8860
 
8815
8861
  /**
8816
- * @public
8817
8862
  * The `shape` variations for the MessageBar component.
8863
+ *
8864
+ * @public
8818
8865
  */
8819
8866
  export declare const MessageBarShape: {
8820
8867
  readonly rounded: "rounded";
@@ -8848,14 +8895,20 @@ export declare class ProgressBar extends BaseProgressBar {
8848
8895
  /**
8849
8896
  * The thickness of the progress bar
8850
8897
  *
8851
- * @public
8898
+ * The thickness of the progress bar
8899
+ *
8852
8900
  * HTML Attribute: `thickness`
8901
+ *
8902
+ * @public
8853
8903
  */
8854
8904
  thickness?: ProgressBarThickness;
8855
8905
  /**
8856
8906
  * The shape of the progress bar
8857
- * @public
8907
+ * The shape of the progress bar
8908
+ *
8858
8909
  * HTML Attribute: `shape`
8910
+ *
8911
+ * @public
8859
8912
  */
8860
8913
  shape?: ProgressBarShape;
8861
8914
  }
@@ -11360,15 +11413,21 @@ export declare const TooltipTemplate: ViewTemplate<Tooltip, any>;
11360
11413
  export declare class Tree extends BaseTree {
11361
11414
  /**
11362
11415
  * The size of the tree item element
11363
- * @public
11416
+ * The size of the tree item element
11417
+ *
11364
11418
  * HTML Attribute: size
11419
+ *
11420
+ * @public
11365
11421
  */
11366
11422
  size: TreeItemSize;
11367
11423
  protected sizeChanged(): void;
11368
11424
  /**
11369
11425
  * The appearance variants of the tree item element
11370
- * @public
11426
+ * The appearance variants of the tree item element
11427
+ *
11371
11428
  * HTML Attribute: appearance
11429
+ *
11430
+ * @public
11372
11431
  */
11373
11432
  appearance: TreeItemAppearance;
11374
11433
  protected appearanceChanged(): void;
@@ -6583,10 +6583,11 @@ class CounterBadge extends FASTElement {
6583
6583
  this.setCount();
6584
6584
  }
6585
6585
  /**
6586
- * @internal
6587
6586
  * Function to set the count
6588
6587
  * This is the default slotted content for the counter badge
6589
6588
  * If children are slotted, that will override the value returned
6589
+ *
6590
+ * @internal
6590
6591
  */
6591
6592
  setCount() {
6592
6593
  const count = this.count ?? 0;
@@ -6664,9 +6665,10 @@ class Dialog extends FASTElement {
6664
6665
  super(...arguments);
6665
6666
  this.type = DialogType.modal;
6666
6667
  /**
6667
- * @public
6668
6668
  * Method to emit an event before the dialog's open state changes
6669
6669
  * HTML spec proposal: https://github.com/whatwg/html/issues/9733
6670
+ *
6671
+ * @public
6670
6672
  */
6671
6673
  this.emitBeforeToggle = () => {
6672
6674
  this.$emit("beforetoggle", {
@@ -6675,9 +6677,10 @@ class Dialog extends FASTElement {
6675
6677
  });
6676
6678
  };
6677
6679
  /**
6678
- * @public
6679
6680
  * Method to emit an event after the dialog's open state changes
6680
6681
  * HTML spec proposal: https://github.com/whatwg/html/issues/9733
6682
+ *
6683
+ * @public
6681
6684
  */
6682
6685
  this.emitToggle = () => {
6683
6686
  this.$emit("toggle", {
@@ -6707,8 +6710,9 @@ class Dialog extends FASTElement {
6707
6710
  this.typeChanged(void 0, this.type);
6708
6711
  }
6709
6712
  /**
6710
- * @public
6711
6713
  * Method to show the dialog
6714
+ *
6715
+ * @public
6712
6716
  */
6713
6717
  show() {
6714
6718
  Updates.enqueue(() => {
@@ -6722,8 +6726,9 @@ class Dialog extends FASTElement {
6722
6726
  });
6723
6727
  }
6724
6728
  /**
6725
- * @public
6726
6729
  * Method to hide the dialog
6730
+ *
6731
+ * @public
6727
6732
  */
6728
6733
  hide() {
6729
6734
  this.emitBeforeToggle();
@@ -6731,8 +6736,9 @@ class Dialog extends FASTElement {
6731
6736
  this.emitToggle();
6732
6737
  }
6733
6738
  /**
6734
- * @public
6735
6739
  * Handles click events on the dialog overlay for light-dismiss
6740
+ *
6741
+ * @public
6736
6742
  * @param event - The click event
6737
6743
  * @returns boolean
6738
6744
  */
@@ -6936,9 +6942,10 @@ class Drawer extends FASTElement {
6936
6942
  this.position = DrawerPosition.start;
6937
6943
  this.size = DrawerSize.medium;
6938
6944
  /**
6939
- * @public
6940
6945
  * Method to emit an event after the dialog's open state changes
6941
6946
  * HTML spec proposal: https://github.com/whatwg/html/issues/9733
6947
+ *
6948
+ * @public
6942
6949
  */
6943
6950
  this.emitToggle = () => {
6944
6951
  this.$emit("toggle", {
@@ -6947,9 +6954,10 @@ class Drawer extends FASTElement {
6947
6954
  });
6948
6955
  };
6949
6956
  /**
6950
- * @public
6951
6957
  * Method to emit an event before the dialog's open state changes
6952
6958
  * HTML spec proposal: https://github.com/whatwg/html/issues/9733
6959
+ *
6960
+ * @public
6953
6961
  */
6954
6962
  this.emitBeforeToggle = () => {
6955
6963
  this.$emit("beforetoggle", {
@@ -6981,8 +6989,9 @@ class Drawer extends FASTElement {
6981
6989
  this.roleAttrObserver.disconnect();
6982
6990
  }
6983
6991
  /**
6984
- * @public
6985
6992
  * Method to show the drawer
6993
+ *
6994
+ * @public
6986
6995
  */
6987
6996
  show() {
6988
6997
  Updates.enqueue(() => {
@@ -6996,8 +7005,9 @@ class Drawer extends FASTElement {
6996
7005
  });
6997
7006
  }
6998
7007
  /**
6999
- * @public
7000
7008
  * Method to hide the drawer
7009
+ *
7010
+ * @public
7001
7011
  */
7002
7012
  hide() {
7003
7013
  this.emitBeforeToggle();
@@ -7018,8 +7028,9 @@ class Drawer extends FASTElement {
7018
7028
  return true;
7019
7029
  }
7020
7030
  /**
7021
- * @public
7022
7031
  * Handles cancel events on the drawer.
7032
+ *
7033
+ * @public
7023
7034
  */
7024
7035
  cancelHandler() {
7025
7036
  this.hide();
@@ -9397,8 +9408,9 @@ class MessageBar extends FASTElement {
9397
9408
  */
9398
9409
  this.elementInternals = this.attachInternals();
9399
9410
  /**
9400
- * @public
9401
9411
  * Method to emit a `dismiss` event when the message bar is dismissed
9412
+ *
9413
+ * @public
9402
9414
  */
9403
9415
  this.dismissMessageBar = () => {
9404
9416
  this.$emit("dismiss", {});
@@ -12558,7 +12570,7 @@ class BaseTextArea extends FASTElement {
12558
12570
  this.autoSizerEl.classList.add("auto-sizer");
12559
12571
  this.autoSizerEl.ariaHidden = "true";
12560
12572
  }
12561
- this.shadowRoot.prepend(this.autoSizerEl);
12573
+ this.rootEl?.prepend(this.autoSizerEl);
12562
12574
  if (!this.autoSizerObserver) {
12563
12575
  this.autoSizerObserver = new ResizeObserver((_, observer) => {
12564
12576
  const blockSizePropName = window.getComputedStyle(this).writingMode.startsWith("horizontal") ? "height" : "width";
@@ -12707,7 +12719,7 @@ const styles$6 = css`
12707
12719
  :host{--border-color:FieldText;--border-block-end-color:FieldText;--focus-indicator-color:Highlight;--placeholder-color:FieldText}:host(:hover),:host(:active),:host(:focus-within){--border-color:Highlight;--border-block-end-color:Highlight}:host(:disabled){--color:GrayText;--border-color:GrayText;--border-block-end-color:GrayText;--placeholder-color:GrayText}`));
12708
12720
 
12709
12721
  function textAreaTemplate() {
12710
- return html`<template><label ${ref("labelEl")} for="control" part="label"><slot name="label" ${slotted("labelSlottedNodes")}></slot></label><div class="root" part="root"><textarea ${ref("controlEl")} id="control" class="control" part="control" ?required="${x => x.required}" ?disabled="${x => x.disabled}" ?readonly="${x => x.readOnly}" ?spellcheck="${x => x.spellcheck}" autocomplete="${x => x.autocomplete}" maxlength="${x => x.maxLength}" minlength="${x => x.minLength}" placeholder="${x => x.placeholder}" @change="${x => x.handleControlChange()}" @select="${x => x.handleControlSelect()}" @input="${x => x.handleControlInput()}"></textarea></div><div hidden><slot ${slotted("defaultSlottedNodes")}></slot></div></template>`;
12722
+ return html`<template><label ${ref("labelEl")} for="control" part="label"><slot name="label" ${slotted("labelSlottedNodes")}></slot></label><div class="root" part="root" ${ref("rootEl")}><textarea ${ref("controlEl")} id="control" class="control" part="control" ?required="${x => x.required}" ?disabled="${x => x.disabled}" ?readonly="${x => x.readOnly}" ?spellcheck="${x => x.spellcheck}" autocomplete="${x => x.autocomplete}" maxlength="${x => x.maxLength}" minlength="${x => x.minLength}" placeholder="${x => x.placeholder}" @change="${x => x.handleControlChange()}" @select="${x => x.handleControlSelect()}" @input="${x => x.handleControlInput()}"></textarea></div><div hidden><slot ${slotted("defaultSlottedNodes")}></slot></div></template>`;
12711
12723
  }
12712
12724
  const template$6 = textAreaTemplate();
12713
12725