@fluentui/web-components 3.0.0-beta.3 → 3.0.0-beta.31

package/dist/dts/counter-badge/counter-badge.definition.d.ts

@@ -1,9 +1,5 @@
 import { CounterBadge } from './counter-badge.js';
 /**
- * The Fluent CounterBadge Element. Implements {@link @microsoft/fast-foundation#Badge },
- * {@link @microsoft/fast-foundation#badgeTemplate}
- *
- *
  * @public
  * @remarks
  * HTML Element: \<fluent-counter-badge\>

package/dist/dts/counter-badge/counter-badge.options.d.ts

@@ -1,10 +1,10 @@
-import type { ValuesOf } from '@microsoft/fast-foundation/utilities.js';
 import { BadgeOptions } from '../badge/badge.options.js';
+import type { ValuesOf } from '../utils/index.js';
 /**
  * CounterBadge options
  * @public
  */
-export declare type CounterBadgeOptions = BadgeOptions;
+export type CounterBadgeOptions = BadgeOptions;
 /**
  * CounterBadgeAppearance constants
  * @public
@@ -17,7 +17,7 @@ export declare const CounterBadgeAppearance: {
  * A CounterBadge can have an appearance of filled or ghost
  * @public
  */
-export declare type CounterBadgeAppearance = ValuesOf<typeof CounterBadgeAppearance>;
+export type CounterBadgeAppearance = ValuesOf<typeof CounterBadgeAppearance>;
 /**
  * CounterBadgeColor constants
  * @public
@@ -36,7 +36,7 @@ export declare const CounterBadgeColor: {
  * A CounterBadge can be one of preset colors
  * @public
  */
-export declare type CounterBadgeColor = ValuesOf<typeof CounterBadgeColor>;
+export type CounterBadgeColor = ValuesOf<typeof CounterBadgeColor>;
 /**
  * A CounterBadge shape can be circular or rounded.
  * @public
@@ -49,7 +49,7 @@ export declare const CounterBadgeShape: {
  * A CounterBadge can be one of preset colors
  * @public
  */
-export declare type CounterBadgeShape = ValuesOf<typeof CounterBadgeShape>;
+export type CounterBadgeShape = ValuesOf<typeof CounterBadgeShape>;
 /**
  * A CounterBadge can be square, circular or rounded.
  * @public
@@ -66,4 +66,4 @@ export declare const CounterBadgeSize: {
  * A CounterBadge can be on of several preset sizes.
  * @public
  */
-export declare type CounterBadgeSize = ValuesOf<typeof CounterBadgeSize>;
+export type CounterBadgeSize = ValuesOf<typeof CounterBadgeSize>;

package/dist/dts/counter-badge/index.d.ts

@@ -1,5 +1,5 @@
-export * from './counter-badge.js';
-export * from './counter-badge.options.js';
+export { CounterBadge } from './counter-badge.js';
+export { CounterBadgeAppearance, CounterBadgeColor, CounterBadgeShape, CounterBadgeSize, } from './counter-badge.options.js';
 export { template as CounterBadgeTemplate } from './counter-badge.template.js';
 export { styles as CounterBadgeStyles } from './counter-badge.styles.js';
 export { definition as CounterBadgeDefinition } from './counter-badge.definition.js';

package/dist/dts/dialog/define.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/dts/dialog/dialog.bench.d.ts

@@ -0,0 +1,3 @@
+declare const itemRenderer: () => HTMLElement;
+export default itemRenderer;
+export { tests } from '../utils/benchmark-wrapper.js';

package/dist/dts/dialog/dialog.d.ts

@@ -0,0 +1,58 @@
+import { FASTElement } from '@microsoft/fast-element';
+import { DialogType } from './dialog.options.js';
+/**
+ * A Dialog Custom HTML Element.
+ *
+ * @public
+ */
+export declare class Dialog extends FASTElement {
+    /**
+     * @public
+     * The dialog element
+     */
+    dialog: HTMLDialogElement;
+    /**
+     * @public
+     * The ID of the element that describes the dialog
+     */
+    ariaDescribedby?: string;
+    /**
+     * @public
+     * The ID of the element that labels the dialog
+     */
+    ariaLabelledby?: string;
+    /**
+     * @public
+     * The type of the dialog modal
+     */
+    type: DialogType;
+    /**
+     * @public
+     * Method to emit an event before the dialog's open state changes
+     * HTML spec proposal: https://github.com/whatwg/html/issues/9733
+     */
+    emitBeforeToggle: () => void;
+    /**
+     * @public
+     * Method to emit an event after the dialog's open state changes
+     * HTML spec proposal: https://github.com/whatwg/html/issues/9733
+     */
+    emitToggle: () => void;
+    /**
+     * @public
+     * Method to show the dialog
+     */
+    show(): void;
+    /**
+     * @public
+     * Method to hide the dialog
+     */
+    hide(): void;
+    /**
+     * @public
+     * Handles click events on the dialog overlay for light-dismiss
+     * @param event - The click event
+     * @returns boolean
+     */
+    clickHandler(event: Event): boolean;
+}

package/dist/dts/dialog/dialog.definition.d.ts

@@ -0,0 +1,9 @@
+import { Dialog } from './dialog.js';
+/**
+ * The Fluent Dialog Element
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<fluent-dialog\>
+ */
+export declare const definition: import("@microsoft/fast-element").FASTElementDefinition<typeof Dialog>;

package/dist/dts/dialog/dialog.options.d.ts

@@ -0,0 +1,11 @@
+import type { ValuesOf } from '../utils/index.js';
+/**
+ * Dialog modal type
+ * @public
+ */
+export declare const DialogType: {
+    readonly modal: "modal";
+    readonly nonModal: "non-modal";
+    readonly alert: "alert";
+};
+export type DialogType = ValuesOf<typeof DialogType>;

package/dist/dts/dialog/dialog.styles.d.ts

@@ -0,0 +1,4 @@
+/** Dialog styles
+ * @public
+ */
+export declare const styles: import("@microsoft/fast-element").ElementStyles;

package/dist/dts/dialog/dialog.template.d.ts

@@ -0,0 +1,7 @@
+import { ElementViewTemplate } from '@microsoft/fast-element';
+import type { Dialog } from './dialog.js';
+/**
+ * Template for the Dialog component
+ * @public
+ */
+export declare const template: ElementViewTemplate<Dialog>;

package/dist/dts/dialog/index.d.ts

@@ -0,0 +1,5 @@
+export { Dialog } from './dialog.js';
+export { DialogType } from './dialog.options.js';
+export { definition as DialogDefinition } from './dialog.definition.js';
+export { template as DialogTemplate } from './dialog.template.js';
+export { styles as DialogStyles } from './dialog.styles.js';

package/dist/dts/dialog-body/define.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/dts/dialog-body/dialog-body.bench.d.ts

@@ -0,0 +1,3 @@
+declare const itemRenderer: () => HTMLElement;
+export default itemRenderer;
+export { tests } from '../utils/benchmark-wrapper.js';

package/dist/dts/dialog-body/dialog-body.d.ts

@@ -0,0 +1,14 @@
+import { FASTElement } from '@microsoft/fast-element';
+/**
+ * Dialog Body component that extends the FASTElement class.
+ *
+ * @public
+ * @extends FASTElement
+ */
+export declare class DialogBody extends FASTElement {
+    /**
+     * @public
+     * Indicates whether the dialog has a title action
+     */
+    noTitleAction: boolean;
+}

package/dist/dts/dialog-body/dialog-body.definition.d.ts

@@ -0,0 +1,9 @@
+import { DialogBody } from './dialog-body.js';
+/**
+ * The Fluent Dialog Body Element
+ *
+ * @public
+ * @remarks
+ * HTML Element: \<fluent-dialog-body\>
+ */
+export declare const definition: import("@microsoft/fast-element").FASTElementDefinition<typeof DialogBody>;

package/dist/dts/dialog-body/dialog-body.styles.d.ts

@@ -0,0 +1,4 @@
+/** Dialog Body styles
+ * @public
+ */
+export declare const styles: import("@microsoft/fast-element").ElementStyles;

package/dist/dts/dialog-body/dialog-body.template.d.ts

@@ -0,0 +1,6 @@
+import { ElementViewTemplate } from '@microsoft/fast-element';
+/**
+ * Template for the dialog form
+ * @public
+ */
+export declare const template: ElementViewTemplate;

package/dist/dts/dialog-body/index.d.ts

@@ -0,0 +1,4 @@
+export { DialogBody } from './dialog-body.js';
+export { definition as DialogBodyDefinition } from './dialog-body.definition.js';
+export { template as DialogBodyTemplate } from './dialog-body.template.js';
+export { styles as DialogBodyStyles } from './dialog-body.styles.js';

package/dist/dts/divider/divider.bench.d.ts

@@ -0,0 +1,3 @@
+declare const itemRenderer: () => HTMLElement;
+export default itemRenderer;
+export { tests } from '../utils/benchmark-wrapper.js';

package/dist/dts/divider/divider.d.ts

@@ -1,31 +1,67 @@
-import { FASTDivider } from '@microsoft/fast-foundation/divider.js';
-import { DividerAlignContent, DividerAppearance } from './divider.options.js';
+import { FASTElement } from '@microsoft/fast-element';
+import { DividerAlignContent, DividerAppearance, DividerOrientation, DividerRole } from './divider.options.js';
 /**
- * @class Divider component
+ * A Divider Custom HTML Element.
  *
  * @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.
+ * 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 {
+export declare class Divider extends FASTElement {
     /**
-     * @property alignContent
-     * @default center
+     * The internal {@link https://developer.mozilla.org/docs/Web/API/ElementInternals | `ElementInternals`} instance for the component.
+     *
+     * @internal
+     */
+    elementInternals: ElementInternals;
+    /**
+     * The role of the element.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: role
+     */
+    role: DividerRole;
+    /**
+     * The orientation of the divider.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: orientation
+     */
+    orientation?: DividerOrientation;
+    /**
+     * @public
      * @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
+     * @public
      * @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
+     * @public
      * @remarks
      * Adds padding to the beginning and end of the divider.
      */
     inset?: boolean;
+    connectedCallback(): void;
+    /**
+     * Sets the element's internal role when the role attribute changes.
+     *
+     * @param previous - the previous role value
+     * @param next - the current role value
+     * @internal
+     */
+    roleChanged(previous: string | null, next: string | null): void;
+    /**
+     * Sets the element's internal orientation when the orientation attribute changes.
+     *
+     * @param previous - the previous orientation value
+     * @param next - the current orientation value
+     * @internal
+     */
+    orientationChanged(previous: string | null, next: string | null): void;
 }

package/dist/dts/divider/divider.options.d.ts

@@ -1,15 +1,39 @@
-import { DividerOrientation, DividerRole } from '@microsoft/fast-foundation/divider.js';
-import type { ValuesOf } from '@microsoft/fast-foundation/utilities.js';
+import type { ValuesOf } from '../utils/index.js';
 /**
- * Fast Foundation DividerRole property
+ * Divider roles
  * @public
  */
-export { DividerRole };
+export declare const DividerRole: {
+    /**
+     * The divider semantically separates content
+     */
+    readonly separator: "separator";
+    /**
+     * The divider has no semantic value and is for visual presentation only.
+     */
+    readonly presentation: "presentation";
+};
+/**
+ * The types for Divider roles
+ * @public
+ */
+export type DividerRole = ValuesOf<typeof DividerRole>;
+/**
+ * Divider orientation
+ * @public
+ */
+export declare const DividerOrientation: {
+    readonly horizontal: "horizontal"; /**
+     * Divider roles
+     * @public
+     */
+    readonly vertical: "vertical";
+};
 /**
- * Fast Foundation Orientation property
+ * The types for Divider orientation
  * @public
  */
-export { DividerOrientation };
+export type DividerOrientation = ValuesOf<typeof DividerOrientation>;
 /**
  * Align content within divider
  * @public
@@ -23,7 +47,7 @@ export declare const DividerAlignContent: {
  * The types for DividerAlignContent
  * @public
  */
-export declare type DividerAlignContent = ValuesOf<typeof DividerAlignContent>;
+export type DividerAlignContent = ValuesOf<typeof DividerAlignContent>;
 /**
  * DividerAppearance - divider color defined by a design token alias.
  * @public
@@ -38,4 +62,4 @@ export declare const DividerAppearance: {
  * The types for Appearance
  * @public
  */
-export declare type DividerAppearance = ValuesOf<typeof DividerAppearance>;
+export type DividerAppearance = ValuesOf<typeof DividerAppearance>;

package/dist/dts/divider/divider.template.d.ts

@@ -1,5 +1,6 @@
 import { ElementViewTemplate } from '@microsoft/fast-element';
 import type { Divider } from './divider.js';
+export declare function dividerTemplate<T extends Divider>(): ElementViewTemplate<T>;
 /**
  * Template for the Divider component
  * @public

package/dist/dts/divider/index.d.ts

@@ -1,5 +1,5 @@
-export * from './divider.js';
-export * from './divider.options.js';
+export { Divider } from './divider.js';
+export { DividerAlignContent, DividerAppearance, DividerOrientation, DividerRole } from './divider.options.js';
 export { definition as DividerDefinition } from './divider.definition.js';
 export { template as DividerTemplate } from './divider.template.js';
 export { styles as DividerStyles } from './divider.styles.js';

package/dist/dts/field/define.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/dts/field/field.bench.d.ts

@@ -0,0 +1,3 @@
+declare const itemRenderer: () => HTMLElement;
+export default itemRenderer;
+export { tests } from '../utils/benchmark-wrapper.js';

package/dist/dts/field/field.d.ts

@@ -0,0 +1,99 @@
+import { FASTElement } from '@microsoft/fast-element';
+import { LabelPosition, SlottableInput } from './field.options.js';
+/**
+ * A Field Custom HTML Element.
+ *
+ * @public
+ */
+export declare class Field extends FASTElement {
+    /**
+     * The position of the label relative to the input.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: `label-position`
+     */
+    labelPosition: LabelPosition;
+    /**
+     * The slotted message elements. Filtered to only include elements with a `flag` attribute.
+     *
+     * @internal
+     */
+    messageSlot: Element[];
+    /**
+     * Adds or removes the `invalid` event listener based on the presence of slotted message elements.
+     *
+     * @param prev - the previous list of slotted message elements
+     * @param next - the current list of slotted message elements
+     * @internal
+     */
+    messageSlotChanged(prev: Element[], next: Element[]): void;
+    /**
+     * The slotted inputs.
+     *
+     * @internal
+     * @privateRemarks
+     * This field is populated with the `children` directive in the template rather than `slotted`.
+     */
+    slottedInputs: SlottableInput[];
+    /**
+     * Sets the `input` property to the first slotted input.
+     *
+     * @param prev - The previous collection of inputs.
+     * @param next - The current collection of inputs.
+     * @internal
+     */
+    slottedInputsChanged(prev: SlottableInput[] | undefined, next: SlottableInput[] | undefined): void;
+    /**
+     * The internal {@link https://developer.mozilla.org/docs/Web/API/ElementInternals | `ElementInternals`} instance for the component.
+     *
+     * @internal
+     */
+    elementInternals: ElementInternals;
+    /**
+     * Reference to the first slotted input.
+     *
+     * @public
+     */
+    input: SlottableInput;
+    /**
+     * Calls the `setStates` method when a `change` event is emitted from the slotted input.
+     *
+     * @param e - the event object
+     * @internal
+     */
+    changeHandler(e: Event): void;
+    /**
+     * Redirects `click` events to the slotted input.
+     *
+     * @internal
+     */
+    clickHandler(e: MouseEvent): boolean | void;
+    /**
+     * Applies the `focus-visible` state to the element when the slotted input receives visible focus.
+     *
+     * @param e - the focus event
+     * @internal
+     */
+    focusinHandler(e: FocusEvent): boolean | void;
+    /**
+     * Removes the `focus-visible` state from the field when a slotted input loses focus.
+     *
+     * @param e - the focus event
+     * @internal
+     */
+    focusoutHandler(e: FocusEvent): boolean | void;
+    /**
+     * Toggles validity state flags on the element when the slotted input emits an `invalid` event (if slotted validation messages are present).
+     *
+     * @param e - the event object
+     * @internal
+     */
+    invalidHandler(e: Event): boolean | void;
+    /**
+     * Toggles the field's states based on the slotted input.
+     *
+     * @internal
+     */
+    setStates(): void;
+}

package/dist/dts/field/field.definition.d.ts

@@ -0,0 +1,9 @@
+import { Field } from './field.js';
+/**
+ * The Fluent Field Element
+ *
+ * @public
+ * @remarks
+ * HTML Element: `<fluent-field>`
+ */
+export declare const definition: import("@microsoft/fast-element").FASTElementDefinition<typeof Field>;

package/dist/dts/field/field.options.d.ts

@@ -0,0 +1,41 @@
+import type { ValuesOf } from '../utils/typings.js';
+/**
+ * Label position values
+ * @public
+ */
+export declare const LabelPosition: {
+    readonly above: "above";
+    readonly after: "after";
+    readonly before: "before";
+};
+/** @public */
+export type LabelPosition = ValuesOf<typeof LabelPosition>;
+/**
+ * Synthetic type for slotted input elements
+ * @public
+ */
+export type SlottableInput = HTMLElement & ElementInternals & {
+    elementInternals?: ElementInternals;
+    required: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+};
+/**
+ * Synthetic type for slotted message elements
+ * @public
+ */
+export declare const ValidationFlags: {
+    readonly badInput: "bad-input";
+    readonly customError: "custom-error";
+    readonly patternMismatch: "pattern-mismatch";
+    readonly rangeOverflow: "range-overflow";
+    readonly rangeUnderflow: "range-underflow";
+    readonly stepMismatch: "step-mismatch";
+    readonly tooLong: "too-long";
+    readonly tooShort: "too-short";
+    readonly typeMismatch: "type-mismatch";
+    readonly valueMissing: "value-missing";
+    readonly valid: "valid";
+};
+/** @public */
+export type ValidationFlags = ValuesOf<typeof ValidationFlags>;

package/dist/dts/field/field.styles.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The styles for the {@link Field} component.
+ *
+ * @public
+ */
+export declare const styles: import("@microsoft/fast-element").ElementStyles;

package/dist/dts/field/field.template.d.ts

@@ -0,0 +1,6 @@
+import { ElementViewTemplate } from '@microsoft/fast-element';
+/**
+ * Template for the Field component
+ * @public
+ */
+export declare const template: ElementViewTemplate;

package/dist/dts/field/index.d.ts

@@ -0,0 +1,6 @@
+export { Field } from './field.js';
+export { LabelPosition as FieldLabelPosition, ValidationFlags } from './field.options.js';
+export type { SlottableInput } from './field.options.js';
+export { definition as FieldDefinition } from './field.definition.js';
+export { styles as FieldStyles } from './field.styles.js';
+export { template as FieldTemplate } from './field.template.js';