@telesign/boreal-web-components 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/types/components/forms/bds-radio-card/bds-radio-card.d.ts

@@ -0,0 +1,57 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+import { IRadioCard, RadioCardChangeDetail } from './types/IRadioCard';
+/**
+ * Radio card component is a selectable card-based radio option.
+ * It presents a mutually exclusive choice with optional descriptive text and icon,
+ * designed for integration with bds-radio-group for orchestration.
+ * Can also be used standalone with the `name`, `value`, and `checked` props.
+ *
+ * @slot - Label content when no `label` prop is provided.
+ * @slot icon - Optional icon rendered to the left of the label.
+ * @slot description - Optional descriptive text rendered below the label.
+ *
+ * @fires bdsChange - Emitted when the user selects this radio card. Listened to by the parent bds-radio-group to enforce single selection.
+ */
+export declare class BdsRadioCard implements IRadioCard {
+    el: HTMLBdsRadioCardElement;
+    /**
+     * Value submitted with the form when this radio is selected.
+     */
+    readonly value: IRadioCard['value'];
+    /**
+     * Tooltip content attached to the radio card content. If empty, the info icon will not be rendered.
+     */
+    readonly info: IRadioCard['info'];
+    /**
+     * Name attribute stamped by the parent bds-radio-group. Set directly when used standalone.
+     */
+    readonly name: IRadioCard['name'];
+    /**
+     * Label text displayed next to the radio indicator. Falls back to the default slot when empty.
+     */
+    readonly label: IRadioCard['label'];
+    /**
+     * Whether this radio card is selected. Managed by bds-radio-group; can be set directly when used standalone.
+     */
+    checked: IRadioCard['checked'];
+    /**
+     * Disables the radio card, preventing it from being selected and interacted with.
+     */
+    readonly disabled: IRadioCard['disabled'];
+    /**
+     * Whether the radio card is in an error state.
+     */
+    readonly error: IRadioCard['error'];
+    /**
+     * Emitted when the user selects this radio. Listened to by the parent bds-radio-group to enforce single selection.
+     */
+    bdsChange: EventEmitter<RadioCardChangeDetail>;
+    private select;
+    private handleClick;
+    private handleKeyDown;
+    componentDidLoad(): void;
+    private get isError();
+    private get hostClasses();
+    render(): any;
+}
+//# sourceMappingURL=bds-radio-card.d.ts.map

package/dist/types/components/forms/bds-radio-card/types/IRadioCard.d.ts

@@ -0,0 +1,14 @@
+export interface RadioCardChangeDetail {
+    checked: boolean;
+    value: string;
+}
+export interface IRadioCard {
+    checked: boolean;
+    disabled: boolean;
+    error: boolean;
+    value: string;
+    name: string;
+    info: string;
+    label: string;
+}
+//# sourceMappingURL=IRadioCard.d.ts.map

package/dist/types/components/forms/bds-radio-group/bds-radio-group.d.ts

@@ -0,0 +1,82 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+import type { IRadioGroup, RadioGroupChangeDetail } from './types/IRadioGroup';
+import { type IFormControl } from "../../../mixins/form-associated.mixin";
+import { type Orientation } from "../../../types/index";
+import { RadioGroupType } from './types/types';
+declare const BdsRadioGroup_base: abstract new (...args: any[]) => {
+    formDisabledCallback(disabled: boolean): void;
+};
+/**
+ * Radio group component that orchestrates single-selection across a set of `bds-radio` children.
+ *
+ * @slot - Default slot for `bds-radio` child elements.
+ */
+export declare class BdsRadioGroup extends BdsRadioGroup_base implements IRadioGroup, IFormControl<string> {
+    private readonly _id;
+    internals: ElementInternals;
+    el: HTMLBdsRadioGroupElement;
+    /** Internal mirror of the `disabled` prop, kept in sync via `@Watch` and `formDisabledCallback`. */
+    private isDisabled;
+    /** Set to true when native form validation fires the `invalid` event; cleared on reset or when value becomes valid. */
+    private isInvalid;
+    /** Disables all child radios and prevents selection. Also mirrored to isDisabled @State for form-level disable support. */
+    readonly disabled = false;
+    /** Shows error styling on the group helper text. Propagated to all child radios. */
+    readonly error = false;
+    /** Error message rendered below the radio options when error is true. Replaces helperText. */
+    readonly errorMessage = "";
+    /** Helper text rendered below the radio options. Shown in default state; replaced by errorMessage in error state. */
+    readonly helperText = "";
+    /** Tooltip text shown on the group label info icon. */
+    readonly info = "";
+    /** Group label rendered above the radio options. */
+    readonly label = "";
+    /** Name of the form control; submitted as the field key in FormData. */
+    readonly name: string;
+    /** Layout direction of the radio options. */
+    readonly orientation: Orientation;
+    /** Marks the group as required for form submission. Triggers validity error when no radio is selected. */
+    readonly required = false;
+    /** Identifies this group variant. 'radio' renders circular bds-radio children; 'radiobutton' renders bds-radio-button segmented control; 'radiocard' renders bds-radio-card element. */
+    readonly type: RadioGroupType;
+    /** Currently selected radio value. Synced to children on change. */
+    value: string;
+    checkPropValues(): void;
+    onDisabledChange(next: boolean): void;
+    onErrorChange(val: boolean): void;
+    onValueChange(val: string): void;
+    /** Emitted when the selected radio changes. Payload includes the new value. */
+    bdsChange: EventEmitter<RadioGroupChangeDetail>;
+    /** Emitted when the selected radio changes. Used for v-model two-way binding in Vue. */
+    valueChange: EventEmitter<string>;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    formAssociatedCallback(): void;
+    formResetCallback(): void;
+    formStateRestoreCallback(state: unknown, _mode: string): void;
+    formDisabledCallback(disabled: boolean): void;
+    handleRadioChange(event: CustomEvent<{
+        checked: boolean;
+        value: string;
+    }>): void;
+    handleInvalid(event: Event): void;
+    private handleKeyDown;
+    private handleSlotChange;
+    /** Returns whether the group's current value satisfies the browser's built-in constraint validation. */
+    checkValidity(): Promise<boolean>;
+    /** Reports the group's validity state to the user, showing native validation UI if invalid. */
+    reportValidity(): Promise<boolean>;
+    private navigateTo;
+    private _buttonCount;
+    private insertDividers;
+    private get radioElements();
+    private syncFormValue;
+    private updateFormValidity;
+    private updateLayoutCount;
+    private updateTabIndexes;
+    private get isError();
+    private get classMap();
+    render(): any;
+}
+export {};
+//# sourceMappingURL=bds-radio-group.d.ts.map

package/dist/types/components/forms/bds-radio-group/types/IRadioGroup.d.ts

@@ -0,0 +1,19 @@
+import { Orientation } from "../../../../types/index";
+import { RadioGroupType } from './types';
+export interface RadioGroupChangeDetail {
+    value: string;
+}
+export interface IRadioGroup {
+    name: string;
+    value: string;
+    label: string;
+    helperText: string;
+    errorMessage: string;
+    info: string;
+    orientation: Orientation;
+    type: RadioGroupType;
+    disabled: boolean;
+    required: boolean;
+    error: boolean;
+}
+//# sourceMappingURL=IRadioGroup.d.ts.map

package/dist/types/components/forms/bds-radio-group/types/enum.d.ts

@@ -0,0 +1,6 @@
+export declare const RADIO_GROUP_TYPES: {
+    readonly RADIO: "radio";
+    readonly RADIO_BUTTON: "radiobutton";
+    readonly RADIO_CARD: "radiocard";
+};
+//# sourceMappingURL=enum.d.ts.map

package/dist/types/components/forms/bds-radio-group/types/types.d.ts

@@ -0,0 +1,3 @@
+import { RADIO_GROUP_TYPES } from './enum';
+export type RadioGroupType = (typeof RADIO_GROUP_TYPES)[keyof typeof RADIO_GROUP_TYPES];
+//# sourceMappingURL=types.d.ts.map