@fluentui/web-components 3.0.0-beta.4 → 3.0.0-beta.40

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,85 @@
-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
+     * Handles changes to align-content attribute custom states
+     * @param prev - the previous state
+     * @param next - the next state
+     */
+    alignContentChanged(prev: DividerAlignContent | undefined, next: DividerAlignContent | undefined): void;
+    /**
+     * @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
+     * Handles changes to appearance attribute custom states
+     * @param prev - the previous state
+     * @param next - the next state
+     */
+    appearanceChanged(prev: DividerAppearance | undefined, next: DividerAppearance | undefined): void;
+    /**
+     * @public
      * @remarks
      * Adds padding to the beginning and end of the divider.
      */
     inset?: boolean;
+    /**
+     * Handles changes to inset custom states
+     * @param prev - the previous state
+     * @param next - the next state
+     */
+    insetChanged(prev: boolean, next: boolean): void;
+    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/drawer/define.d.ts

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

package/dist/dts/drawer/drawer.d.ts

@@ -0,0 +1,93 @@
+import { FASTElement } from '@microsoft/fast-element';
+import { DrawerPosition, DrawerSize, DrawerType } from './drawer.options.js';
+/**
+ * A Drawer component that allows content to be displayed in a side panel. It can be rendered as modal or non-modal.
+ * @extends FASTElement
+ *
+ * @attr {DrawerType} type - Determines whether the drawer should be displayed as modal, non-modal, or alert.
+ * @attr {DrawerPosition} position - Sets the position of the drawer (start/end).
+ * @attr {DrawerSize} size - Sets the size of the drawer (small/medium/large).
+ * @attr {string} ariaDescribedby - The ID of the element that describes the drawer.
+ * @attr {string} ariaLabelledby - The ID of the element that labels the drawer.
+ *
+ * @csspart dialog - The dialog element of the drawer.
+ *
+ * @slot - Default slot for the content of the drawer.
+ *
+ * @fires toggle - Event emitted after the dialog's open state changes.
+ * @fires beforetoggle - Event emitted before the dialog's open state changes.
+ *
+ * @method show - Method to show the drawer.
+ * @method hide - Method to hide the drawer.
+ * @method clickHandler - Handles click events on the drawer.
+ * @method emitToggle - Emits an event after the dialog's open state changes.
+ * @method emitBeforeToggle - Emits an event before the dialog's open state changes.
+ *
+ * @summary A component that provides a drawer for displaying content in a side panel.
+ *
+ * @tag fluent-drawer
+ */
+export declare class Drawer extends FASTElement {
+    /**
+     * @public
+     * Determines whether the drawer should be displayed as modal or non-modal
+     * When rendered as a modal, an overlay is applied over the rest of the view.
+     */
+    type: DrawerType;
+    /**
+     * @public
+     * The ID of the element that labels the drawer.
+     */
+    ariaLabelledby?: string;
+    /**
+     * @public
+     * The ID of the element that describes the drawer.
+     */
+    ariaDescribedby?: string;
+    /**""
+     * @public
+     * @defaultValue start
+     * Sets the position of the drawer (start/end).
+     */
+    position: DrawerPosition;
+    /**
+     * @public
+     * @defaultValue medium
+     * Sets the size of the drawer (small/medium/large).
+     */
+    size: DrawerSize;
+    /**
+     * @public
+     * The dialog element.
+     */
+    dialog: HTMLDialogElement;
+    /**
+     * @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 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 show the drawer
+     */
+    show(): void;
+    /**
+     * @public
+     * Method to hide the drawer
+     */
+    hide(): void;
+    /**
+     * @public
+     * @param event - The click event
+     * @returns boolean - Always returns true
+     * Handles click events on the drawer.
+     */
+    clickHandler(event: Event): boolean;
+}

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

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

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

@@ -0,0 +1,40 @@
+import type { ValuesOf } from '../utils/index.js';
+/**
+ * A drawer can be positioned on the left or right side of the viewport.
+ */
+export declare const DrawerPosition: {
+    readonly start: "start";
+    readonly end: "end";
+};
+/**
+ * The position of the drawer.
+ * @public
+ */
+export type DrawerPosition = ValuesOf<typeof DrawerPosition>;
+/**
+ * A drawer can be different sizes
+ */
+export declare const DrawerSize: {
+    readonly small: "small";
+    readonly medium: "medium";
+    readonly large: "large";
+    readonly full: "full";
+};
+/**
+ * The size of the drawer.
+ * @public
+ */
+export type DrawerSize = ValuesOf<typeof DrawerSize>;
+/**
+ * A drawer can be different sizes
+ */
+export declare const DrawerType: {
+    readonly nonModal: "non-modal";
+    readonly modal: "modal";
+    readonly inline: "inline";
+};
+/**
+ * The size of the drawer.
+ * @public
+ */
+export type DrawerType = ValuesOf<typeof DrawerType>;

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

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

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

@@ -0,0 +1,8 @@
+import { ElementViewTemplate } from '@microsoft/fast-element';
+import type { Drawer } from './drawer.js';
+/**
+ * The template for the Drawer component.
+ * @public
+ */
+export declare function drawerTemplate<T extends Drawer>(): ElementViewTemplate<T>;
+export declare const template: ElementViewTemplate<Drawer>;

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

@@ -0,0 +1,5 @@
+export * from './drawer.js';
+export * from './drawer.options.js';
+export { definition as DrawerDefinition } from './drawer.definition.js';
+export { styles as DrawerStyles } from './drawer.styles.js';
+export { template as DrawerTemplate } from './drawer.template.js';

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

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

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

@@ -0,0 +1,3 @@
+import { FASTElement } from '@microsoft/fast-element';
+export declare class DrawerBody extends FASTElement {
+}

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

@@ -0,0 +1,8 @@
+import { DrawerBody } from './drawer-body.js';
+/**
+ *
+ * @public
+ * @remarks
+ * HTML Element: <fluent-drawer>
+ */
+export declare const definition: import("@microsoft/fast-element").FASTElementDefinition<typeof DrawerBody>;

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

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

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

@@ -0,0 +1,8 @@
+import { ElementViewTemplate } from '@microsoft/fast-element';
+import type { DrawerBody } from './drawer-body.js';
+/**
+ * The template for the Drawer component.
+ * @public
+ */
+export declare function drawerBodyTemplate<T extends DrawerBody>(): ElementViewTemplate<T>;
+export declare const template: ElementViewTemplate<DrawerBody>;

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

@@ -0,0 +1,4 @@
+export * from './drawer-body.js';
+export { definition as DrawerBodyDefinition } from './drawer-body.definition.js';
+export { styles as DrawerBodyStyles } from './drawer-body.styles.js';
+export { template as DrawerBodyTemplate } from './drawer-body.template.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';