@fluentui/web-components 3.0.0-alpha.6 → 3.0.0-alpha.8

package/dist/web-components.d.ts

@@ -1,8 +1,11 @@
 import { CSSDesignToken } from '@microsoft/fast-foundation';
+import { DividerOrientation } from '@microsoft/fast-foundation';
+import { DividerRole } from '@microsoft/fast-foundation';
 import { ElementStyles } from '@microsoft/fast-element';
 import { ElementViewTemplate } from '@microsoft/fast-element';
 import { FASTAccordion } from '@microsoft/fast-foundation';
 import { FASTAccordionItem } from '@microsoft/fast-foundation';
+import { FASTDivider } from '@microsoft/fast-foundation';
 import { FASTElement } from '@microsoft/fast-element';
 import { FASTElementDefinition } from '@microsoft/fast-element';
 import { FASTProgress } from '@microsoft/fast-foundation';
@@ -44,7 +47,7 @@ export declare class AccordionItem extends FASTAccordionItem {
      * @remarks
      * HTML Attribute: size
      */
-    size: AccordionItemSize;
+    size?: AccordionItemSize;
     /**
      * Sets the width of the focus state.
      *
@@ -61,7 +64,7 @@ export declare class AccordionItem extends FASTAccordionItem {
      * @remarks
      * HTML Attribute: expandIconPosition
      */
-    expandIconPosition: AccordionItemExpandIconPosition;
+    expandIconPosition?: AccordionItemExpandIconPosition;
 }
 
 /**
@@ -117,6 +120,271 @@ export declare const accordionStyles: ElementStyles;
 
 export declare const accordionTemplate: ElementViewTemplate<Accordion>;
 
+/**
+ * The base class used for constructing a fluent-avatar custom element
+ * @public
+ */
+export declare class Avatar extends FASTElement {
+    /**
+     * The name of the person or entity represented by this Avatar. This should always be provided if it is available.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: name
+     */
+    name?: string | undefined;
+    /**
+     * Provide custom initials rather than one generated via the name
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: name
+     */
+    initials?: string | undefined;
+    /**
+     * Size of the avatar in pixels.
+     *
+     * Size is restricted to a limited set of supported values recommended for most uses (see `AvatarSizeValue`) and
+     * based on design guidelines for the Avatar control.
+     *
+     * If a non-supported size is neeeded, set `size` to the next-smaller supported size, and set `width` and `height`
+     * to override the rendered size.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: size
+     *
+     */
+    size?: AvatarSize | undefined;
+    /**
+     * The avatar can have a circular or square shape.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: shape
+     */
+    shape?: AvatarShape | undefined;
+    /**
+     * Optional activity indicator
+     * * active: the avatar will be decorated according to activeAppearance
+     * * inactive: the avatar will be reduced in size and partially transparent
+     * * undefined: normal display
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: active
+     */
+    active?: AvatarActive | undefined;
+    /**
+     * The appearance when `active="active"`
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: appearance
+     */
+    appearance?: AvatarAppearance | undefined;
+    /**
+     * The color when displaying either an icon or initials.
+     * * neutral (default): gray
+     * * brand: color from the brand palette
+     * * colorful: picks a color from a set of pre-defined colors, based on a hash of the name (or colorId if provided)
+     * * [AvatarNamedColor]: a specific color from the theme
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: color
+     */
+    color?: AvatarColor;
+    /**
+     * Specify a string to be used instead of the name, to determine which color to use when color="colorful".
+     * Use this when a name is not available, but there is another unique identifier that can be used instead.
+     */
+    colorId?: AvatarNamedColor | undefined;
+    /**
+     * Sets the data-color attribute used for the visual presentation
+     * @internal
+     */
+    generateColor(): AvatarColor | void;
+    /**
+     * Generates and sets the initials for the template
+     * @internal
+     */
+    generateInitials(): string | void;
+    /**
+     * An array of the available Avatar named colors
+     */
+    static colors: ("anchor" | "dark-red" | "cranberry" | "red" | "pumpkin" | "peach" | "marigold" | "gold" | "brass" | "brown" | "forest" | "seafoam" | "dark-green" | "light-teal" | "teal" | "steel" | "blue" | "royal-blue" | "cornflower" | "navy" | "lavender" | "purple" | "grape" | "lilac" | "pink" | "magenta" | "plum" | "beige" | "mink" | "platinum")[];
+}
+
+/**
+ * The Avatar "active" state
+ */
+export declare const AvatarActive: {
+    readonly active: "active";
+    readonly inactive: "inactive";
+};
+
+/**
+ * The types of Avatar active state
+ */
+export declare type AvatarActive = ValuesOf<typeof AvatarActive>;
+
+/**
+ * The Avatar Appearance when "active"
+ */
+export declare const AvatarAppearance: {
+    readonly ring: "ring";
+    readonly shadow: "shadow";
+    readonly ringShadow: "ring-shadow";
+};
+
+/**
+ * The appearance when "active"
+ */
+export declare type AvatarAppearance = ValuesOf<typeof AvatarAppearance>;
+
+/**
+ * Supported Avatar colors
+ */
+export declare const AvatarColor: {
+    readonly darkRed: "dark-red";
+    readonly cranberry: "cranberry";
+    readonly red: "red";
+    readonly pumpkin: "pumpkin";
+    readonly peach: "peach";
+    readonly marigold: "marigold";
+    readonly gold: "gold";
+    readonly brass: "brass";
+    readonly brown: "brown";
+    readonly forest: "forest";
+    readonly seafoam: "seafoam";
+    readonly darkGreen: "dark-green";
+    readonly lightTeal: "light-teal";
+    readonly teal: "teal";
+    readonly steel: "steel";
+    readonly blue: "blue";
+    readonly royalBlue: "royal-blue";
+    readonly cornflower: "cornflower";
+    readonly navy: "navy";
+    readonly lavender: "lavender";
+    readonly purple: "purple";
+    readonly grape: "grape";
+    readonly lilac: "lilac";
+    readonly pink: "pink";
+    readonly magenta: "magenta";
+    readonly plum: "plum";
+    readonly beige: "beige";
+    readonly mink: "mink";
+    readonly platinum: "platinum";
+    readonly anchor: "anchor";
+    readonly neutral: "neutral";
+    readonly brand: "brand";
+    readonly colorful: "colorful";
+};
+
+/**
+ * The Avatar Color
+ */
+export declare type AvatarColor = ValuesOf<typeof AvatarColor>;
+
+/**
+ * The Fluent Avatar Element.
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<fluent-badge\>
+ */
+export declare const AvatarDefinition: FASTElementDefinition<typeof Avatar>;
+
+/**
+ * A specific named color for the Avatar
+ */
+export declare const AvatarNamedColor: {
+    readonly darkRed: "dark-red";
+    readonly cranberry: "cranberry";
+    readonly red: "red";
+    readonly pumpkin: "pumpkin";
+    readonly peach: "peach";
+    readonly marigold: "marigold";
+    readonly gold: "gold";
+    readonly brass: "brass";
+    readonly brown: "brown";
+    readonly forest: "forest";
+    readonly seafoam: "seafoam";
+    readonly darkGreen: "dark-green";
+    readonly lightTeal: "light-teal";
+    readonly teal: "teal";
+    readonly steel: "steel";
+    readonly blue: "blue";
+    readonly royalBlue: "royal-blue";
+    readonly cornflower: "cornflower";
+    readonly navy: "navy";
+    readonly lavender: "lavender";
+    readonly purple: "purple";
+    readonly grape: "grape";
+    readonly lilac: "lilac";
+    readonly pink: "pink";
+    readonly magenta: "magenta";
+    readonly plum: "plum";
+    readonly beige: "beige";
+    readonly mink: "mink";
+    readonly platinum: "platinum";
+    readonly anchor: "anchor";
+};
+
+/**
+ * An avatar can be one of named colors
+ * @public
+ */
+export declare type AvatarNamedColor = ValuesOf<typeof AvatarNamedColor>;
+
+/**
+ * The Avatar Shape
+ */
+export declare const AvatarShape: {
+    readonly circular: "circular";
+    readonly square: "square";
+};
+
+/**
+ * The types of Avatar Shape
+ */
+export declare type AvatarShape = ValuesOf<typeof AvatarShape>;
+
+/**
+ * The Avatar Sizes
+ * @public
+ */
+export declare const AvatarSize: {
+    readonly _16: 16;
+    readonly _20: 20;
+    readonly _24: 24;
+    readonly _28: 28;
+    readonly _32: 32;
+    readonly _36: 36;
+    readonly _40: 40;
+    readonly _48: 48;
+    readonly _56: 56;
+    readonly _64: 64;
+    readonly _72: 72;
+    readonly _96: 96;
+    readonly _120: 120;
+    readonly _128: 128;
+};
+
+/**
+ * A Avatar can be on of several preset sizes.
+ * @public
+ */
+export declare type AvatarSize = ValuesOf<typeof AvatarSize>;
+
+/** Avatar styles
+ * @public
+ */
+export declare const AvatarStyles: ElementStyles;
+
+export declare const AvatarTemplate: ElementViewTemplate<Avatar>;
+
 /**
  * The base class used for constructing a fluent-badge custom element
  * @public
@@ -145,7 +413,7 @@ export declare class Badge extends FASTElement {
      * @remarks
      * HTML Attribute: shape
      */
-    shape: BadgeShape;
+    shape?: BadgeShape;
     /**
      * The size the badge should have.
      *
@@ -153,7 +421,7 @@ export declare class Badge extends FASTElement {
      * @remarks
      * HTML Attribute: size
      */
-    size: BadgeSize;
+    size?: BadgeSize;
 }
 
 /**
@@ -487,8 +755,12 @@ export declare const colorNeutralShadowKeyLighter: CSSDesignToken<string>;
 
 export declare const colorNeutralStencil1: CSSDesignToken<string>;
 
+export declare const colorNeutralStencil1Alpha: CSSDesignToken<string>;
+
 export declare const colorNeutralStencil2: CSSDesignToken<string>;
 
+export declare const colorNeutralStencil2Alpha: CSSDesignToken<string>;
+
 export declare const colorNeutralStroke1: CSSDesignToken<string>;
 
 export declare const colorNeutralStroke1Hover: CSSDesignToken<string>;
@@ -649,6 +921,8 @@ export declare const colorPaletteGreenForeground2: CSSDesignToken<string>;
 
 export declare const colorPaletteGreenForeground3: CSSDesignToken<string>;
 
+export declare const colorPaletteGreenForegroundInverted: CSSDesignToken<string>;
+
 export declare const colorPaletteLavenderBackground2: CSSDesignToken<string>;
 
 export declare const colorPaletteLavenderBorderActive: CSSDesignToken<string>;
@@ -775,6 +1049,8 @@ export declare const colorPaletteRedForeground2: CSSDesignToken<string>;
 
 export declare const colorPaletteRedForeground3: CSSDesignToken<string>;
 
+export declare const colorPaletteRedForegroundInverted: CSSDesignToken<string>;
+
 export declare const colorPaletteRoyalBlueBackground2: CSSDesignToken<string>;
 
 export declare const colorPaletteRoyalBlueBorderActive: CSSDesignToken<string>;
@@ -817,6 +1093,8 @@ export declare const colorPaletteYellowForeground2: CSSDesignToken<string>;
 
 export declare const colorPaletteYellowForeground3: CSSDesignToken<string>;
 
+export declare const colorPaletteYellowForegroundInverted: CSSDesignToken<string>;
+
 export declare const colorScrollbarOverlay: CSSDesignToken<string>;
 
 export declare const colorStrokeFocus1: CSSDesignToken<string>;
@@ -871,7 +1149,7 @@ export declare class CounterBadge extends FASTElement {
      * @remarks
      * HTML Attribute: appearance
      */
-    appearance: CounterBadgeAppearance;
+    appearance?: CounterBadgeAppearance;
     /**
      * The color the badge should have.
      *
@@ -879,7 +1157,7 @@ export declare class CounterBadge extends FASTElement {
      * @remarks
      * HTML Attribute: color
      */
-    color: CounterBadgeColor;
+    color?: CounterBadgeColor;
     /**
      * The shape the badge should have.
      *
@@ -887,7 +1165,7 @@ export declare class CounterBadge extends FASTElement {
      * @remarks
      * HTML Attribute: shape
      */
-    shape: CounterBadgeShape;
+    shape?: CounterBadgeShape;
     /**
      * The size the badge should have.
      *
@@ -895,7 +1173,7 @@ export declare class CounterBadge extends FASTElement {
      * @remarks
      * HTML Attribute: size
      */
-    size: CounterBadgeSize;
+    size?: CounterBadgeSize;
     /**
      * The count the badge should have.
      *
@@ -1073,6 +1351,93 @@ export declare const curveLinear: CSSDesignToken<string>;
  */
 export declare const definition: FASTElementDefinition<typeof Switch>;
 
+/**
+ * @class Divider component
+ *
+ * @remarks
+ * This class extends the FASTDivider. A divider groups sections of content to create visual rhythm and hierarchy. Use dividers along with spacing and headers to organize content in your layout.
+ */
+export declare class Divider extends FASTDivider {
+    /**
+     * @property alignContent
+     * @default center
+     * @remarks
+     * Determines the alignment of the content within the divider. Select from start or end. When not specified, the content will be aligned to the center.
+     */
+    alignContent?: DividerAlignContent;
+    /**
+     * @property appearance
+     * @default default
+     * @remarks
+     * A divider can have one of the preset appearances. Select from strong, brand, subtle. When not specified, the divider has its default appearance.
+     */
+    appearance?: DividerAppearance;
+    /**
+     * @property inset
+     * @default false
+     * @remarks
+     * Adds padding to the beginning and end of the divider.
+     */
+    inset?: boolean;
+}
+
+/**
+ * Align content within divider
+ * @public
+ */
+export declare const DividerAlignContent: {
+    readonly center: "center";
+    readonly start: "start";
+    readonly end: "end";
+};
+
+/**
+ * The types for DividerAlignContent
+ * @public
+ */
+export declare type DividerAlignContent = ValuesOf<typeof DividerAlignContent>;
+
+/**
+ * DividerAppearance - divider color defined by a design token alias.
+ * @public
+ */
+export declare const DividerAppearance: {
+    readonly strong: "strong";
+    readonly brand: "brand";
+    readonly subtle: "subtle";
+    readonly default: "default";
+};
+
+/**
+ * The types for Appearance
+ * @public
+ */
+export declare type DividerAppearance = ValuesOf<typeof DividerAppearance>;
+
+/**
+ * The Fluent Divider Element
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<fluent-divider\>
+ */
+export declare const DividerDefinition: FASTElementDefinition<typeof Divider>;
+
+export { DividerOrientation }
+
+export { DividerRole }
+
+/** Divider styles
+ * @public
+ */
+export declare const DividerStyles: ElementStyles;
+
+/**
+ * Template for the Divider component
+ * @public
+ */
+export declare const DividerTemplate: ElementViewTemplate<Divider>;
+
 export declare const durationFast: CSSDesignToken<string>;
 
 export declare const durationFaster: CSSDesignToken<string>;
@@ -1121,6 +1486,105 @@ export declare const fontWeightRegular: CSSDesignToken<string>;
 
 export declare const fontWeightSemibold: CSSDesignToken<string>;
 
+/**
+ * The base class used for constucting a fluent image custom element
+ * @public
+ */
+declare class Image_2 extends FASTElement {
+    /**
+     * Image layout
+     *
+     * @public
+     * @remarks
+     * HTML attribute: block.
+     */
+    block?: boolean;
+    /**
+     * Image border
+     *
+     * @public
+     * @remarks
+     * HTML attribute: border.
+     */
+    bordered?: boolean;
+    /**
+     * Image shadow
+     *
+     * @public
+     * @remarks
+     * HTML attribute: shadow.
+     */
+    shadow?: boolean;
+    /**
+     * Image fit
+     *
+     * @public
+     * @remarks
+     * HTML attribute: fit.
+     */
+    fit?: ImageFit;
+    /**
+     * Image shape
+     *
+     * @public
+     * @remarks
+     * HTML attribute: shape.
+     */
+    shape?: ImageShape;
+}
+export { Image_2 as Image }
+
+/**
+ * The Fluent Image Element
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<fluent-image\>
+ */
+export declare const ImageDefinition: FASTElementDefinition<typeof Image_2>;
+
+/**
+ * Image fit
+ * @public
+ */
+export declare const ImageFit: {
+    readonly none: "none";
+    readonly center: "center";
+    readonly contain: "contain";
+    readonly cover: "cover";
+    readonly default: "default";
+};
+
+/**
+ * Types for image fit
+ * @public
+ */
+export declare type ImageFit = ValuesOf<typeof ImageFit>;
+
+/**
+ * Image shape
+ * @public
+ */
+export declare const ImageShape: {
+    readonly circular: "circular";
+    readonly rounded: "rounded";
+    readonly square: "square";
+};
+
+export declare type ImageShape = ValuesOf<typeof ImageShape>;
+
+/** Image styles
+ *
+ * @public
+ */
+export declare const ImageStyles: ElementStyles;
+
+/**
+ * Template for the Image component
+ * @public
+ */
+export declare const ImageTemplate: ElementViewTemplate<Image_2>;
+
 export declare const lineHeightBase100: CSSDesignToken<string>;
 
 export declare const lineHeightBase200: CSSDesignToken<string>;
@@ -1153,14 +1617,14 @@ declare class ProgressBar_2 extends FASTProgress {
      * @remarks
      * HTML Attribute: thickness
      */
-    thickness: ProgressBarThickness;
+    thickness?: ProgressBarThickness;
     /**
      * The shape of the progress bar
      * @public
      * @remarks
      * HTML Attribute: shape
      */
-    shape: ProgressBarShape;
+    shape?: ProgressBarShape;
     /**
      * The validation state of the progress bar
      * @public
@@ -1321,7 +1785,7 @@ export declare class Spinner extends FASTProgressRing {
      * @remarks
      * HTML Attribute: size
      */
-    size: SpinnerSize;
+    size?: SpinnerSize;
     /**
      * The appearance of the spinner
      * @public
@@ -1329,7 +1793,7 @@ export declare class Spinner extends FASTProgressRing {
      * @remarks
      * HTML Attribute: appearance
      */
-    appearance: SpinnerAppearance;
+    appearance?: SpinnerAppearance;
 }
 
 /**
@@ -1485,7 +1949,7 @@ declare class Text_2 extends FASTElement {
      * HTML Attribute: size
      *
      */
-    size: TextSize;
+    size?: TextSize;
     /**
      * THe Text font
      *
@@ -1493,7 +1957,7 @@ declare class Text_2 extends FASTElement {
      * @remarks
      * HTML Attribute: font
      */
-    font: TextFont;
+    font?: TextFont;
     /**
      * THe Text weight
      *
@@ -1501,7 +1965,7 @@ declare class Text_2 extends FASTElement {
      * @remarks
      * HTML Attribute: weight
      */
-    weight: TextWeight;
+    weight?: TextWeight;
     /**
      * THe Text align
      *
@@ -1509,7 +1973,7 @@ declare class Text_2 extends FASTElement {
      * @remarks
      * HTML Attribute: align
      */
-    align: TextAlign;
+    align?: TextAlign;
 }
 export { Text_2 as Text }