@fluentui/web-components 3.0.0-beta.84 → 3.0.0-beta.86

package/dist/esm/tree-item/tree-item.js

@@ -0,0 +1,65 @@
+import { __decorate } from "tslib";
+import { attr } from '@microsoft/fast-element';
+import { TreeItemAppearance, TreeItemSize } from './tree-item.options.js';
+import { BaseTreeItem } from './tree-item.base';
+export class TreeItem extends BaseTreeItem {
+    constructor() {
+        super(...arguments);
+        /**
+         * The size of the tree item element
+         * @public
+         */
+        this.size = TreeItemSize.small;
+        /**
+         * The size of the tree item element
+         * @public
+         */
+        this.appearance = TreeItemAppearance.subtle;
+    }
+    /**
+     * Handles changes to the size attribute
+     * we update the child tree items' size based on the size
+     *  @internal
+     */
+    sizeChanged() {
+        this.updateSizeAndAppearance();
+    }
+    /**
+     * Handles changes to the appearance attribute
+     *
+     * @internal
+     */
+    appearanceChanged() {
+        this.updateSizeAndAppearance();
+    }
+    /**
+     * child tree items supered change event
+     * @internal
+     */
+    childTreeItemsChanged() {
+        super.childTreeItemsChanged();
+        this.updateSizeAndAppearance();
+    }
+    /**
+     * 1. Update the child items' size based on the tree's size
+     * 2. Update the child items' appearance based on the tree's appearance
+     *
+     * @public
+     */
+    updateSizeAndAppearance() {
+        if (!this.childTreeItems?.length) {
+            return;
+        }
+        this.childTreeItems.forEach(item => {
+            item.size = this.size;
+            item.appearance = this.appearance;
+        });
+    }
+}
+__decorate([
+    attr
+], TreeItem.prototype, "size", void 0);
+__decorate([
+    attr
+], TreeItem.prototype, "appearance", void 0);
+//# sourceMappingURL=tree-item.js.map

package/dist/esm/tree-item/tree-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-item.js","sourceRoot":"","sources":["../../../src/tree-item/tree-item.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,OAAO,QAAS,SAAQ,YAAY;IAA1C;;QACE;;;WAGG;QAEI,SAAI,GAAiB,YAAY,CAAC,KAAK,CAAC;QAW/C;;;WAGG;QAEI,eAAU,GAAuB,kBAAkB,CAAC,MAAM,CAAC;IAoCpE,CAAC;IAlDC;;;;OAIG;IACK,WAAW;QACjB,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACjC,CAAC;IASD;;;;OAIG;IACK,iBAAiB;QACvB,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACjC,CAAC;IAED;;;OAGG;IACI,qBAAqB;QAC1B,KAAK,CAAC,qBAAqB,EAAE,CAAC;QAC9B,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACI,uBAAuB;QAC5B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YAChC,IAAiB,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACnC,IAAiB,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AApDQ;IADN,IAAI;sCAC0C;AAgBxC;IADN,IAAI;4CAC6D"}

package/dist/esm/tree-item/tree-item.options.js

@@ -0,0 +1,24 @@
+export const TreeItemAppearance = {
+    subtle: 'subtle',
+    subtleAlpha: 'subtle-alpha',
+    transparent: 'transparent',
+};
+export const TreeItemSize = {
+    small: 'small',
+    medium: 'medium',
+};
+/**
+ * Predicate function that determines if the element should be considered an tree-item.
+ *
+ * @param element - The element to check.
+ * @param tagName - The tag name to check.
+ * @returns true if the element is a dropdown.
+ * @public
+ */
+export function isTreeItem(element, tagName = '-tree-item') {
+    if (element?.nodeType !== Node.ELEMENT_NODE) {
+        return false;
+    }
+    return element.tagName.toLowerCase().endsWith(tagName);
+}
+//# sourceMappingURL=tree-item.options.js.map

package/dist/esm/tree-item/tree-item.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-item.options.js","sourceRoot":"","sources":["../../../src/tree-item/tree-item.options.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,aAAa;CAClB,CAAC;AAIX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACR,CAAC;AAIX;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,OAAqB,EAAE,UAAkB,YAAY;IAC9E,IAAI,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAQ,OAAmB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACtE,CAAC"}

package/dist/esm/tree-item/tree-item.styles.js

@@ -0,0 +1,157 @@
+import { css } from '@microsoft/fast-element';
+import { borderRadiusMedium, colorNeutralForeground2, colorNeutralForeground2Hover, colorNeutralForeground2Pressed, colorNeutralForeground2Selected, colorNeutralForeground3Selected, colorStrokeFocus2, colorSubtleBackground, colorSubtleBackgroundHover, colorSubtleBackgroundLightAlphaHover, colorSubtleBackgroundLightAlphaPressed, colorSubtleBackgroundLightAlphaSelected, colorSubtleBackgroundPressed, colorSubtleBackgroundSelected, colorTransparentBackground, colorTransparentBackgroundHover, colorTransparentBackgroundPressed, colorTransparentBackgroundSelected, curveEasyEaseMax, durationFaster, fontSizeBase300, lineHeightBase300, spacingHorizontalM, spacingHorizontalXS, spacingHorizontalXXL, spacingHorizontalXXS, spacingVerticalNone, spacingVerticalS, spacingVerticalXXL, spacingVerticalXXS, spacingVerticalXXXL, } from '../theme/design-tokens.js';
+import { display } from '../utils/display.js';
+export const styles = css `
+  ${display('block')}
+
+  :host {
+    outline: none;
+    font-size: ${fontSizeBase300};
+    line-height: ${lineHeightBase300};
+  }
+
+  :host(:focus-visible) .positioning-region {
+    box-shadow: ${spacingVerticalNone} ${spacingVerticalNone} ${spacingVerticalNone} ${spacingVerticalXXS}
+      ${colorStrokeFocus2} inset;
+  }
+
+  /**
+   * Default variants:
+   * Size - medium
+   * Appearance - subtle
+   */
+  .positioning-region {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    cursor: pointer;
+    height: ${spacingVerticalXXXL};
+    padding-inline-start: calc(var(--indent) * ${spacingHorizontalXXL});
+    padding-inline-end: ${spacingVerticalS};
+    border-radius: ${borderRadiusMedium};
+    background-color: ${colorSubtleBackground};
+    color: ${colorNeutralForeground2};
+    gap: ${spacingHorizontalXS};
+  }
+
+  @media (prefers-contrast: more) {
+    :host(:focus-visible) .positioning-region {
+      outline: 1px solid ${colorStrokeFocus2};
+    }
+  }
+
+  .content {
+    display: flex;
+    align-items: center;
+    gap: ${spacingHorizontalXS};
+  }
+
+  .chevron {
+    display: flex;
+    align-items: center;
+    flex-shrink: 0;
+    justify-content: center;
+    width: ${spacingHorizontalXXL};
+    height: ${spacingVerticalXXL};
+    transition: transform ${durationFaster} ${curveEasyEaseMax};
+    transform: rotate(0deg);
+  }
+
+  .chevron:dir(rtl) {
+    transform: rotate(180deg);
+  }
+
+  .aside {
+    display: flex;
+    align-items: center;
+  }
+
+  .positioning-region:hover {
+    background-color: ${colorSubtleBackgroundHover};
+    color: ${colorNeutralForeground2Hover};
+  }
+
+  .positioning-region:active {
+    background-color: ${colorSubtleBackgroundPressed};
+    color: ${colorNeutralForeground2Pressed};
+  }
+
+  ::slotted([slot='start']),
+  ::slotted([slot='end']),
+  ::slotted(:not([slot])) {
+    display: flex;
+    align-items: center;
+    min-width: 0;
+  }
+
+  ::slotted([slot='start']) {
+    flex-shrink: 0;
+  }
+
+  ::slotted(:not([slot])) {
+    padding-inline: ${spacingHorizontalXXS};
+  }
+
+  .items {
+    display: none;
+  }
+
+  :host([expanded]) .items {
+    display: block;
+  }
+
+  :host([empty]) .chevron,
+  :host([empty]) .items {
+    visibility: hidden;
+  }
+
+  :host([selected]) .positioning-region {
+    background-color: ${colorSubtleBackgroundSelected};
+    color: ${colorNeutralForeground2Selected};
+  }
+
+  :host([selected]) .content,
+  :host([selected]) .chevron {
+    color: ${colorNeutralForeground3Selected};
+  }
+
+  :host([size='small']) .positioning-region {
+    height: ${spacingVerticalXXL};
+    padding-inline-start: calc(var(--indent) * ${spacingHorizontalM});
+  }
+
+  :host([appearance='subtle-alpha']) .positioning-region:hover {
+    background-color: ${colorSubtleBackgroundLightAlphaHover};
+  }
+
+  :host([appearance='subtle-alpha']) .positioning-region:active {
+    background-color: ${colorSubtleBackgroundLightAlphaPressed};
+  }
+
+  :host([appearance='subtle-alpha'][selected]) .positioning-region {
+    background-color: ${colorSubtleBackgroundLightAlphaSelected};
+    color: ${colorNeutralForeground2Selected};
+  }
+
+  :host([appearance='transparent']) .positioning-region {
+    background-color: ${colorTransparentBackground};
+  }
+
+  :host([appearance='transparent']) .positioning-region:hover {
+    background-color: ${colorTransparentBackgroundHover};
+  }
+
+  :host([appearance='transparent']) .positioning-region:active {
+    background-color: ${colorTransparentBackgroundPressed};
+  }
+
+  :host([appearance='transparent'][selected]) .positioning-region {
+    background-color: ${colorTransparentBackgroundSelected};
+    color: ${colorNeutralForeground2Selected};
+  }
+
+  :host([expanded]) .chevron {
+    transform: rotate(90deg);
+  }
+`;
+//# sourceMappingURL=tree-item.styles.js.map

package/dist/esm/tree-item/tree-item.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-item.styles.js","sourceRoot":"","sources":["../../../src/tree-item/tree-item.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,+BAA+B,EAI/B,+BAA+B,EAC/B,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,oCAAoC,EACpC,sCAAsC,EACtC,uCAAuC,EACvC,4BAA4B,EAC5B,6BAA6B,EAC7B,0BAA0B,EAC1B,+BAA+B,EAC/B,iCAAiC,EACjC,kCAAkC,EAClC,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;IACrB,OAAO,CAAC,OAAO,CAAC;;;;iBAIH,eAAe;mBACb,iBAAiB;;;;kBAIlB,mBAAmB,IAAI,mBAAmB,IAAI,mBAAmB,IAAI,kBAAkB;QACjG,iBAAiB;;;;;;;;;;;;;cAaX,mBAAmB;iDACgB,oBAAoB;0BAC3C,gBAAgB;qBACrB,kBAAkB;wBACf,qBAAqB;aAChC,uBAAuB;WACzB,mBAAmB;;;;;2BAKH,iBAAiB;;;;;;;WAOjC,mBAAmB;;;;;;;;aAQjB,oBAAoB;cACnB,kBAAkB;4BACJ,cAAc,IAAI,gBAAgB;;;;;;;;;;;;;;wBActC,0BAA0B;aACrC,4BAA4B;;;;wBAIjB,4BAA4B;aACvC,8BAA8B;;;;;;;;;;;;;;;;sBAgBrB,oBAAoB;;;;;;;;;;;;;;;;;wBAiBlB,6BAA6B;aACxC,+BAA+B;;;;;aAK/B,+BAA+B;;;;cAI9B,kBAAkB;iDACiB,kBAAkB;;;;wBAI3C,oCAAoC;;;;wBAIpC,sCAAsC;;;;wBAItC,uCAAuC;aAClD,+BAA+B;;;;wBAIpB,0BAA0B;;;;wBAI1B,+BAA+B;;;;wBAI/B,iCAAiC;;;;wBAIjC,kCAAkC;aAC7C,+BAA+B;;;;;;CAM3C,CAAC"}

package/dist/esm/tree-item/tree-item.template.js

@@ -0,0 +1,39 @@
+import { children, html } from '@microsoft/fast-element';
+import { isTreeItem } from './tree-item.options';
+const chevronIcon = html `
+  <svg width="12" height="12" xmlns="http://www.w3.org/2000/svg" fill="currentColor">
+    <path
+      d="M4.65 2.15a.5.5 0 000 .7L7.79 6 4.65 9.15a.5.5 0 10.7.7l3.5-3.5a.5.5 0 000-.7l-3.5-3.5a.5.5 0 00-.7 0z"
+    ></path>
+  </svg>
+`;
+export const template = html `
+  <template
+    tabindex="-1"
+    slot="${x => (x.isNestedItem ? 'item' : void 0)}"
+    @focusin="${(x, c) => x.focusHandler(c.event)}"
+    @focusout="${(x, c) => x.blurHandler(c.event)}"
+    ${children({
+    property: 'childTreeItems',
+    filter: node => isTreeItem(node),
+})}
+  >
+    <div class="positioning-region" part="positioning-region">
+      <div class="content" part="content">
+        <span class="chevron" part="chevron">
+          <slot name="chevron">${chevronIcon}</slot>
+        </span>
+        <slot name="start"></slot>
+        <slot></slot>
+        <slot name="end"></slot>
+      </div>
+      <div class="aside" part="aside">
+        <slot name="aside"></slot>
+      </div>
+    </div>
+    <div role="group" class="items" part="items">
+      <slot name="item"></slot>
+    </div>
+  </template>
+`;
+//# sourceMappingURL=tree-item.template.js.map

package/dist/esm/tree-item/tree-item.template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-item.template.js","sourceRoot":"","sources":["../../../src/tree-item/tree-item.template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAY,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,WAAW,GAAG,IAAI,CAAA;;;;;;CAMvB,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAU;;;YAG1B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAmB,CAAC;iBAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAmB,CAAC;MACzD,QAAQ,CAAC;IACT,QAAQ,EAAE,gBAAgB;IAC1B,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;CACjC,CAAC;;;;;iCAK2B,WAAW;;;;;;;;;;;;;;CAc3C,CAAC"}

package/dist/web-components.d.ts

@@ -3261,6 +3261,105 @@ export declare class BaseTextInput extends FASTElement {
     setValidity(flags?: Partial<ValidityState>, message?: string, anchor?: HTMLElement): void;
 }
 
+declare class BaseTreeItem extends FASTElement {
+    /**
+     * The internal {@link https://developer.mozilla.org/docs/Web/API/ElementInternals | `ElementInternals`} instance for the component.
+     *
+     * @internal
+     */
+    elementInternals: ElementInternals;
+    constructor();
+    /**
+     * When true, the control will be appear expanded by user interaction.
+     * @public
+     * HTML Attribute: `expanded`
+     */
+    expanded: boolean;
+    /**
+     * Handles changes to the expanded attribute
+     * @param prev - the previous state
+     * @param next - the next state
+     *
+     * @public
+     */
+    expandedChanged(prev: boolean, next: boolean): void;
+    /**
+     * When true, the control will appear selected by user interaction.
+     * @public
+     * @remarks
+     * HTML Attribute: selected
+     */
+    selected: boolean;
+    /**
+     * Handles changes to the selected attribute
+     * @param prev - the previous state
+     * @param next - the next state
+     *
+     * @internal
+     */
+    protected selectedChanged(prev: boolean, next: boolean): void;
+    /**
+     * When true, the control has no child tree items
+     * @public
+     * HTML Attribute: empty
+     */
+    empty: boolean;
+    private styles;
+    /**
+     * The indent of the tree item element.
+     * This is not needed once css attr() is supported (--indent: attr(data-indent type(<number>)));
+     * @public
+     */
+    dataIndent: number | undefined;
+    private dataIndentChanged;
+    childTreeItems: BaseTreeItem[] | undefined;
+    /**
+     * Handles changes to the child tree items
+     *
+     * @public
+     */
+    childTreeItemsChanged(): void;
+    /**
+     * Updates the childrens indent
+     *
+     * @public
+     */
+    updateChildTreeItems(): void;
+    /**
+     * Sets the indent for each item
+     */
+    private setIndent;
+    /**
+     * Handle focus events
+     *
+     * @public
+     */
+    focusHandler(e: FocusEvent): void;
+    /**
+     * Handle blur events
+     *
+     * @public
+     */
+    blurHandler(e: FocusEvent): void;
+    /**
+     * Toggle the expansion state of the tree item
+     *
+     * @public
+     */
+    toggleExpansion(): void;
+    /**
+     * Toggle the single selection state of the tree item
+     *
+     * @public
+     */
+    toggleSelection(): void;
+    /**
+     * Whether the tree is nested
+     * @internal
+     */
+    get isNestedItem(): boolean;
+}
+
 /**
  * CSS custom property value for the {@link @fluentui/tokens#borderRadiusCircular | `borderRadiusCircular`} design token.
  * @public
@@ -7371,6 +7470,16 @@ export declare function isDropdownOption(value: Node | null, tagName?: string):
  */
 export declare function isListbox(element?: Node | null, tagName?: string): element is Listbox;
 
+/**
+ * Predicate function that determines if the element should be considered an tree-item.
+ *
+ * @param element - The element to check.
+ * @param tagName - The tag name to check.
+ * @returns true if the element is a dropdown.
+ * @public
+ */
+export declare function isTreeItem(element?: Node | null, tagName?: string): element is BaseTreeItem;
+
 /**
  * The base class used for constructing a fluent-label custom element
  * @public
@@ -11149,6 +11258,70 @@ export declare const TooltipStyles: ElementStyles;
  */
 export declare const TooltipTemplate: ViewTemplate<Tooltip, any>;
 
+export declare class TreeItem extends BaseTreeItem {
+    /**
+     * The size of the tree item element
+     * @public
+     */
+    size: TreeItemSize;
+    /**
+     * Handles changes to the size attribute
+     * we update the child tree items' size based on the size
+     *  @internal
+     */
+    private sizeChanged;
+    /**
+     * The size of the tree item element
+     * @public
+     */
+    appearance: TreeItemAppearance;
+    /**
+     * Handles changes to the appearance attribute
+     *
+     * @internal
+     */
+    private appearanceChanged;
+    /**
+     * child tree items supered change event
+     * @internal
+     */
+    childTreeItemsChanged(): void;
+    /**
+     * 1. Update the child items' size based on the tree's size
+     * 2. Update the child items' appearance based on the tree's appearance
+     *
+     * @public
+     */
+    updateSizeAndAppearance(): void;
+}
+
+export declare const TreeItemAppearance: {
+    readonly subtle: "subtle";
+    readonly subtleAlpha: "subtle-alpha";
+    readonly transparent: "transparent";
+};
+
+export declare type TreeItemAppearance = ValuesOf<typeof TreeItemAppearance>;
+
+/**
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<fluent-tree-item\>
+ */
+export declare const TreeItemDefinition: FASTElementDefinition<typeof TreeItem>;
+
+export declare const TreeItemSize: {
+    readonly small: "small";
+    readonly medium: "medium";
+};
+
+export declare type TreeItemSize = ValuesOf<typeof TreeItemSize>;
+
+export declare const TreeItemStyles: ElementStyles;
+
+export declare const TreeItemTemplate: ViewTemplate<TreeItem, any>;
+
 export declare const typographyBody1StrongerStyles: CSSDirective;
 
 export declare const typographyBody1StrongStyles: CSSDirective;