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

package/dist/dts/checkbox/checkbox.base.d.ts

@@ -0,0 +1,288 @@
+import { FASTElement } from '@microsoft/fast-element';
+/**
+ * The base class for a component with a toggleable checked state.
+ *
+ * @public
+ */
+export declare class BaseCheckbox extends FASTElement {
+    /**
+     * Indicates that the element should get focus after the page finishes loading.
+     * @see The {@link https://developer.mozilla.org/docs/Web/HTML/Element/input#autofocus | `autofocus`} attribute
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: `autofocus`
+     */
+    autofocus: boolean;
+    /**
+     * The element's current checked state.
+     *
+     * @public
+     */
+    get checked(): boolean;
+    set checked(next: boolean);
+    /**
+     * The disabled state of the control.
+     *
+     * @public
+     */
+    disabled?: boolean;
+    /**
+     * Toggles the disabled state when the user changes the `disabled` property.
+     *
+     * @internal
+     */
+    protected disabledChanged(prev: boolean | undefined, next: boolean | undefined): void;
+    /**
+     * The initial disabled state of the control.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: `disabled`
+     */
+    disabledAttribute?: boolean;
+    /**
+     * Sets the disabled state when the `disabled` attribute changes.
+     *
+     * @param prev - the previous value
+     * @param next - the current value
+     * @internal
+     */
+    protected disabledAttributeChanged(prev: boolean | undefined, next: boolean | undefined): void;
+    /**
+     * The id of a form to associate the element to.
+     * @see The {@link https://developer.mozilla.org/docs/Web/HTML/Element/input#form | `form`} attribute
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: `form`
+     */
+    formAttribute?: string;
+    /**
+     * The initial checked state of the element.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: `checked`
+     */
+    initialChecked?: boolean;
+    /**
+     * Updates the checked state when the `checked` attribute is changed, unless the checked state has been changed by the user.
+     *
+     * @param prev - The previous initial checked state
+     * @param next - The current initial checked state
+     * @internal
+     */
+    protected initialCheckedChanged(prev: boolean | undefined, next: boolean | undefined): void;
+    /**
+     * The initial value of the input.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: `value`
+     */
+    initialValue: string;
+    /**
+     * Sets the value of the input when the `value` attribute changes.
+     *
+     * @param prev - The previous initial value
+     * @param next - The current initial value
+     * @internal
+     */
+    protected initialValueChanged(prev: string, next: string): void;
+    /**
+     * The name of the element. This element's value will be surfaced during form submission under the provided name.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: `name`
+     */
+    name: string;
+    /**
+     * The element's required state.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: `required`
+     */
+    required: boolean;
+    /**
+     * Sets the validity of the control when the required state changes.
+     *
+     * @param prev - The previous required state
+     * @param next - The current required state
+     * @internal
+     */
+    protected requiredChanged(prev: boolean, next: boolean): void;
+    /**
+     * The internal checked state of the control.
+     *
+     * @internal
+     */
+    private _checked?;
+    /**
+     * Indicates that the checked state has been changed by the user.
+     *
+     * @internal
+     */
+    private dirtyChecked;
+    /**
+     * The associated `<form>` element.
+     *
+     * @public
+     * @remarks
+     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/form | `ElementInternals.form`} property.
+     */
+    get form(): HTMLFormElement | null;
+    /**
+     * The internal {@link https://developer.mozilla.org/docs/Web/API/ElementInternals | `ElementInternals`} instance for the component.
+     *
+     * @internal
+     */
+    elementInternals: ElementInternals;
+    /**
+     * The form-associated flag.
+     * @see {@link https://html.spec.whatwg.org/multipage/custom-elements.html#custom-elements-face-example | Form-associated custom elements}
+     *
+     * @public
+     */
+    static formAssociated: boolean;
+    /**
+     * A reference to all associated `<label>` elements.
+     *
+     * @public
+     */
+    get labels(): ReadonlyArray<HTMLLabelElement>;
+    /**
+     * The fallback validation message, taken from a native checkbox `<input>` element.
+     *
+     * @internal
+     */
+    private _validationFallbackMessage;
+    /**
+     * The validation message. Uses the browser's default validation message for native checkboxes if not otherwise
+     * specified (e.g., via `setCustomValidity`).
+     *
+     * @public
+     * @remarks
+     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/validationMessage | `ElementInternals.validationMessage`} property.
+     */
+    get validationMessage(): string;
+    /**
+     * The element's validity state.
+     *
+     * @public
+     * @remarks
+     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/validity | `ElementInternals.validity`} property.
+     */
+    get validity(): ValidityState;
+    /**
+     * The internal value of the input.
+     *
+     * @internal
+     */
+    private _value;
+    /**
+     * The current value of the input.
+     *
+     * @public
+     */
+    get value(): string;
+    set value(value: string);
+    /**
+     * Determines if the control can be submitted for constraint validation.
+     *
+     * @public
+     * @remarks
+     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/willValidate | `ElementInternals.willValidate`} property.
+     */
+    get willValidate(): boolean;
+    /**
+     * Checks the validity of the element and returns the result.
+     *
+     * @public
+     * @remarks
+     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/checkValidity | `HTMLInputElement.checkValidity()`} method.
+     */
+    checkValidity(): boolean;
+    /**
+     * Toggles the checked state when the user clicks the element.
+     *
+     * @param e - the event object
+     * @internal
+     */
+    clickHandler(e: MouseEvent): boolean | void;
+    connectedCallback(): void;
+    /**
+     * Updates the form value when a user changes the `checked` state.
+     *
+     * @param e - the event object
+     * @internal
+     */
+    inputHandler(e: InputEvent): boolean | void;
+    /**
+     * Prevents scrolling when the user presses the space key.
+     *
+     * @param e - the event object
+     * @internal
+     */
+    keydownHandler(e: KeyboardEvent): boolean | void;
+    /**
+     * Toggles the checked state when the user releases the space key.
+     *
+     * @param e - the event object
+     * @internal
+     */
+    keyupHandler(e: KeyboardEvent): boolean | void;
+    /**
+     * Resets the form value to its initial value when the form is reset.
+     *
+     * @internal
+     */
+    formResetCallback(): void;
+    /**
+     * Reports the validity of the element.
+     *
+     * @public
+     * @remarks
+     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/reportValidity | `HTMLInputElement.reportValidity()`} method.
+     */
+    reportValidity(): boolean;
+    /**
+     * Sets the ARIA checked state.
+     *
+     * @param value - The checked state
+     * @internal
+     */
+    protected setAriaChecked(value?: boolean): void;
+    /**
+     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/setFormValue | `ElementInternals.setFormValue()`} method.
+     *
+     * @internal
+     */
+    setFormValue(value: File | string | FormData | null, state?: File | string | FormData | null): void;
+    /**
+     * Sets a custom validity message.
+     *
+     * @param message - The message to set
+     * @public
+     */
+    setCustomValidity(message: string): void;
+    /**
+     * Sets the validity of the control.
+     *
+     * @param flags - Validity flags to set.
+     * @param message - Optional message to supply. If not provided, the control's `validationMessage` will be used.
+     * @param anchor - Optional anchor to use for the validation message.
+     *
+     * @internal
+     */
+    setValidity(flags?: Partial<ValidityState>, message?: string, anchor?: HTMLElement): void;
+    /**
+     * Toggles the checked state of the control.
+     *
+     * @param force - Forces the element to be checked or unchecked
+     * @public
+     */
+    toggleChecked(force?: boolean): void;
+}

package/dist/dts/checkbox/checkbox.d.ts

@@ -1,292 +1,5 @@
-import { FASTElement } from '@microsoft/fast-element';
+import { BaseCheckbox } from './checkbox.base.js';
 import { CheckboxShape, CheckboxSize } from './checkbox.options.js';
-/**
- * The base class for a component with a toggleable checked state.
- *
- * @public
- */
-export declare class BaseCheckbox extends FASTElement {
-    /**
-     * Indicates that the element should get focus after the page finishes loading.
-     * @see The {@link https://developer.mozilla.org/docs/Web/HTML/Element/input#autofocus | `autofocus`} attribute
-     *
-     * @public
-     * @remarks
-     * HTML Attribute: `autofocus`
-     */
-    autofocus: boolean;
-    /**
-     * The element's current checked state.
-     *
-     * @public
-     */
-    get checked(): boolean;
-    set checked(next: boolean);
-    /**
-     * The disabled state of the control.
-     *
-     * @public
-     */
-    disabled?: boolean;
-    /**
-     * Toggles the disabled state when the user changes the `disabled` property.
-     *
-     * @internal
-     */
-    protected disabledChanged(prev: boolean | undefined, next: boolean | undefined): void;
-    /**
-     * The initial disabled state of the control.
-     *
-     * @public
-     * @remarks
-     * HTML Attribute: `disabled`
-     */
-    disabledAttribute?: boolean;
-    /**
-     * Sets the disabled state when the `disabled` attribute changes.
-     *
-     * @param prev - the previous value
-     * @param next - the current value
-     * @internal
-     */
-    protected disabledAttributeChanged(prev: boolean | undefined, next: boolean | undefined): void;
-    /**
-     * The id of a form to associate the element to.
-     * @see The {@link https://developer.mozilla.org/docs/Web/HTML/Element/input#form | `form`} attribute
-     *
-     * @public
-     * @remarks
-     * HTML Attribute: `form`
-     */
-    formAttribute?: string;
-    /**
-     * The initial checked state of the element.
-     *
-     * @public
-     * @remarks
-     * HTML Attribute: `checked`
-     */
-    initialChecked?: boolean;
-    /**
-     * Updates the checked state when the `checked` attribute is changed, unless the checked state has been changed by the user.
-     *
-     * @param prev - The previous initial checked state
-     * @param next - The current initial checked state
-     * @internal
-     */
-    protected initialCheckedChanged(prev: boolean | undefined, next: boolean | undefined): void;
-    /**
-     * The initial value of the input.
-     *
-     * @public
-     * @remarks
-     * HTML Attribute: `value`
-     */
-    initialValue: string;
-    /**
-     * Sets the value of the input when the `value` attribute changes.
-     *
-     * @param prev - The previous initial value
-     * @param next - The current initial value
-     * @internal
-     */
-    protected initialValueChanged(prev: string, next: string): void;
-    /**
-     * The name of the element. This element's value will be surfaced during form submission under the provided name.
-     *
-     * @public
-     * @remarks
-     * HTML Attribute: `name`
-     */
-    name: string;
-    /**
-     * The element's required state.
-     *
-     * @public
-     * @remarks
-     * HTML Attribute: `required`
-     */
-    required: boolean;
-    /**
-     * Sets the validity of the control when the required state changes.
-     *
-     * @param prev - The previous required state
-     * @param next - The current required state
-     * @internal
-     */
-    protected requiredChanged(prev: boolean, next: boolean): void;
-    /**
-     * The internal checked state of the control.
-     *
-     * @internal
-     */
-    private _checked?;
-    /**
-     * Indicates that the checked state has been changed by the user.
-     *
-     * @internal
-     */
-    private dirtyChecked;
-    /**
-     * The associated `<form>` element.
-     *
-     * @public
-     * @remarks
-     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/form | `ElementInternals.form`} property.
-     */
-    get form(): HTMLFormElement | null;
-    /**
-     * The internal {@link https://developer.mozilla.org/docs/Web/API/ElementInternals | `ElementInternals`} instance for the component.
-     *
-     * @internal
-     */
-    elementInternals: ElementInternals;
-    /**
-     * The form-associated flag.
-     * @see {@link https://html.spec.whatwg.org/multipage/custom-elements.html#custom-elements-face-example | Form-associated custom elements}
-     *
-     * @public
-     */
-    static formAssociated: boolean;
-    /**
-     * A reference to all associated `<label>` elements.
-     *
-     * @public
-     */
-    get labels(): ReadonlyArray<HTMLLabelElement>;
-    /**
-     * The fallback validation message, taken from a native checkbox `<input>` element.
-     *
-     * @internal
-     */
-    private _validationFallbackMessage;
-    /**
-     * The validation message. Uses the browser's default validation message for native checkboxes if not otherwise
-     * specified (e.g., via `setCustomValidity`).
-     *
-     * @public
-     * @remarks
-     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/validationMessage | `ElementInternals.validationMessage`} property.
-     */
-    get validationMessage(): string;
-    /**
-     * The element's validity state.
-     *
-     * @public
-     * @remarks
-     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/validity | `ElementInternals.validity`} property.
-     */
-    get validity(): ValidityState;
-    /**
-     * The internal value of the input.
-     *
-     * @internal
-     */
-    private _value;
-    /**
-     * The current value of the input.
-     *
-     * @public
-     */
-    get value(): string;
-    set value(value: string);
-    /**
-     * Determines if the control can be submitted for constraint validation.
-     *
-     * @public
-     * @remarks
-     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/willValidate | `ElementInternals.willValidate`} property.
-     */
-    get willValidate(): boolean;
-    /**
-     * Checks the validity of the element and returns the result.
-     *
-     * @public
-     * @remarks
-     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/checkValidity | `HTMLInputElement.checkValidity()`} method.
-     */
-    checkValidity(): boolean;
-    /**
-     * Toggles the checked state when the user clicks the element.
-     *
-     * @param e - the event object
-     * @internal
-     */
-    clickHandler(e: MouseEvent): boolean | void;
-    connectedCallback(): void;
-    /**
-     * Updates the form value when a user changes the `checked` state.
-     *
-     * @param e - the event object
-     * @internal
-     */
-    inputHandler(e: InputEvent): boolean | void;
-    /**
-     * Prevents scrolling when the user presses the space key.
-     *
-     * @param e - the event object
-     * @internal
-     */
-    keydownHandler(e: KeyboardEvent): boolean | void;
-    /**
-     * Toggles the checked state when the user releases the space key.
-     *
-     * @param e - the event object
-     * @internal
-     */
-    keyupHandler(e: KeyboardEvent): boolean | void;
-    /**
-     * Resets the form value to its initial value when the form is reset.
-     *
-     * @internal
-     */
-    formResetCallback(): void;
-    /**
-     * Reports the validity of the element.
-     *
-     * @public
-     * @remarks
-     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/reportValidity | `HTMLInputElement.reportValidity()`} method.
-     */
-    reportValidity(): boolean;
-    /**
-     * Sets the ARIA checked state.
-     *
-     * @param value - The checked state
-     * @internal
-     */
-    protected setAriaChecked(value?: boolean): void;
-    /**
-     * Reflects the {@link https://developer.mozilla.org/docs/Web/API/ElementInternals/setFormValue | `ElementInternals.setFormValue()`} method.
-     *
-     * @internal
-     */
-    setFormValue(value: File | string | FormData | null, state?: File | string | FormData | null): void;
-    /**
-     * Sets a custom validity message.
-     *
-     * @param message - The message to set
-     * @public
-     */
-    setCustomValidity(message: string): void;
-    /**
-     * Sets the validity of the control.
-     *
-     * @param flags - Validity flags to set.
-     * @param message - Optional message to supply. If not provided, the control's `validationMessage` will be used.
-     * @param anchor - Optional anchor to use for the validation message.
-     *
-     * @internal
-     */
-    setValidity(flags?: Partial<ValidityState>, message?: string, anchor?: HTMLElement): void;
-    /**
-     * Toggles the checked state of the control.
-     *
-     * @param force - Forces the element to be checked or unchecked
-     * @public
-     */
-    toggleChecked(force?: boolean): void;
-}
 /**
  * A Checkbox Custom HTML Element.
  * Implements the {@link https://w3c.github.io/aria/#checkbox | ARIA checkbox }.

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

@@ -1,5 +1,6 @@
 export { definition as CheckboxDefinition } from './checkbox.definition.js';
-export { BaseCheckbox, Checkbox } from './checkbox.js';
+export { BaseCheckbox } from './checkbox.base.js';
+export { Checkbox } from './checkbox.js';
 export { CheckboxShape, CheckboxSize } from './checkbox.options.js';
 export type { CheckboxOptions } from './checkbox.options.js';
 export { styles as CheckboxStyles } from './checkbox.styles.js';

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

@@ -0,0 +1,49 @@
+import { FASTElement } from '@microsoft/fast-element';
+import { DividerOrientation, DividerRole } from './divider.options.js';
+/**
+ * A Divider Custom HTML Element.
+ * 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.
+ *
+ * @public
+ */
+export declare class BaseDivider extends FASTElement {
+    /**
+     * 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;
+    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: DividerRole | undefined, next: DividerRole | undefined): void;
+}

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

@@ -1,52 +1,5 @@
-import { FASTElement } from '@microsoft/fast-element';
-import { DividerAlignContent, DividerAppearance, DividerOrientation, DividerRole } from './divider.options.js';
-/**
- * A Divider Custom HTML Element.
- * 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.
- *
- * @public
- */
-export declare class BaseDivider extends FASTElement {
-    /**
-     * 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;
-    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: DividerRole | undefined, next: DividerRole | undefined): void;
-}
+import { DividerAlignContent, DividerAppearance } from './divider.options.js';
+import { BaseDivider } from './divider.base.js';
 /**
  * A Divider Custom HTML Element.
  * Based on BaseDivider and includes style and layout specific attributes

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

@@ -1,4 +1,5 @@
-export { BaseDivider, Divider } from './divider.js';
+export { BaseDivider } from './divider.base.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';