@cute-widgets/base 20.0.1

package/card/index.d.ts

@@ -0,0 +1,163 @@
+import * as i0 from '@angular/core';
+import { CuteLayoutControl } from '@cute-widgets/base/abstract';
+import { ThemeColor, ContentAlignment } from '@cute-widgets/base/core';
+import * as i1 from '@angular/common';
+
+/**
+ * Header region of a card, intended for use within `<cute-card>`.
+ * This component is an optional convenience for use with other convenience elements, such as `<cute-card-footer>`;
+ * any custom header block element may be used in its place.
+ *
+ * `CuteCardHeader` provides no behaviors, instead serving as a purely visual treatment.
+ */
+declare class CuteCardHeader {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardHeader, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteCardHeader, "cute-card-header", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Footer area a card, intended for use within `<cute-card>`.
+ * This component is an optional convenience for use with other convenience elements, such as
+ * `<cute-card-content>`; any custom footer block element may be used in its place.
+ *
+ * CuteCardFooter provides no behaviors, instead serving as a purely visual treatment.
+ */
+declare class CuteCardFooter {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardFooter, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteCardFooter, "cute-card-footer", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * A flexible and extensible content container with multiple variants and options.
+ */
+declare class CuteCard extends CuteLayoutControl {
+    private _sanitizer;
+    get backgroundImage(): string | undefined;
+    set backgroundImage(value: string | undefined);
+    private _backgroundImage;
+    /** `CuteCardHeader` element if it was defined in the `CuteCard` template. */
+    readonly _header: CuteCardHeader | undefined;
+    /** `CuteCardFooter` element if it was defined in the `CuteCard` template. */
+    readonly _footer: CuteCardFooter | undefined;
+    constructor();
+    protected generateId(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCard, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteCard, "cute-card", ["cuteCard"], { "backgroundImage": { "alias": "backgroundImage"; "required": false; }; }, {}, ["_header", "_footer"], ["cute-card-header", "img[position=top], [role=img][position=top]", "*", "img[position=bottom], [role=img][position=bottom]", "cute-card-footer"], true, never>;
+}
+
+/**
+ * Avatar image content for a card, intended for use within `<cute-card>`. Can be applied to
+ * any media element, such as `<img>` or `<picture>`.
+ *
+ * This component is an optional convenience for use with other convenience elements, such as
+ * `<cute-card-title>`; any custom media element may be used in its place.
+ *
+ * CuteCardAvatar provides no behaviors, instead serving as a purely visual treatment.
+ */
+declare class CuteCardAvatar {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardAvatar, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteCardAvatar, "[cute-card-avatar], [cuteCardAvatar]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Primary image content for a card, intended for use within `<cute-card>`. Can be applied to
+ * any media element, such as `<img>` or `<picture>`.
+ *
+ * This component is an optional convenience for use with other convenience elements, such as
+ * `<cute-card-body>`; any custom media element may be used in its place.
+ *
+ * `CuteCardImage` provides no behaviors, instead serving as a purely visual treatment.
+ */
+declare class CuteCardImage {
+    protected card: CuteCard;
+    /** Image position in the card layout */
+    position: "top" | "bottom" | "fluid";
+    /** Image height in pixels */
+    get height(): number | undefined;
+    set height(value: number | string | undefined);
+    private _height;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardImage, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteCardImage, "[cute-card-image], [cuteCardImage]", never, { "position": { "alias": "position"; "required": false; }; "height": { "alias": "height"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Content of a card, intended for use within `<cute-card>`. This component is an optional
+ * convenience for use with other convenience elements, such as `<cute-card-title>`; any custom
+ * content block element may be used in its place.
+ *
+ * CuteCardContent provides no behaviors, instead serving as a purely visual treatment.
+ */
+declare class CuteCardBody {
+    /** Card body text color */
+    color: ThemeColor | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardBody, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteCardBody, "cute-card-body, cute-card-content", ["cuteCardBody"], { "color": { "alias": "color"; "required": false; }; }, {}, never, ["cute-card-title,  cute-card-subtitle,\n                   [cute-card-title], [cute-card-subtitle],\n                   [cuteCardTitle],   [cuteCardSubtitle]", "*"], true, never>;
+}
+
+/**
+ * Bottom area of a card that contains action buttons, intended for use within `<cute-card>`.
+ * This component is an optional convenience for use with other convenience elements, such as
+ * `<cute-card-content>`; any custom action block element may be used in its place.
+ *
+ * `CuteCardActions` provides no behaviors, instead serving as a purely visual treatment.
+ */
+declare class CuteCardActions {
+    /** Position of the actions inside the card. */
+    align: ContentAlignment;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardActions, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteCardActions, "cute-card-actions, [cute-card-actions], [cuteCardActions]", ["cuteCardActions"], { "align": { "alias": "align"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Use _card groups_ to render cards as a single, attached element with equal width and height columns.
+ * When using card groups with footers, their content will automatically line up.
+ */
+declare class CuteCardGroup {
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardGroup, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteCardGroup, "cute-card-group", ["cuteCardGroup"], {}, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Title of a card, intended for use within `<cute-card-body>`. This component is an optional
+ * convenience for one variety of card titles; any custom title element may be used in its place.
+ *
+ * CuteCardTitle provides no behaviors, instead serving as a purely visual treatment.
+ */
+declare class CuteCardTitle {
+    /** Title text color */
+    color: ThemeColor | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardTitle, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteCardTitle, "cute-card-title, [cute-card-title], [cuteCardTitle]", never, { "color": { "alias": "color"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Subtitle of a card, intended for use within `<cute-card-body>` beneath a `<cute-card-title>`. This
+ * component is an optional convenience for use with other convenience elements, such as
+ * `<cute-card-title>`.
+ *
+ * CuteCardSubtitle provides no behaviors, instead serving as a purely visual treatment.
+ */
+declare class CuteCardSubtitle {
+    /** Subtitle text color */
+    color: ThemeColor;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardSubtitle, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteCardSubtitle, "cute-card-subtitle, [cute-card-subtitle], [cuteCardSubtitle]", never, { "color": { "alias": "color"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Turn an image into a card background and overlay the card’s text.
+ */
+declare class CuteCardOverlay {
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardOverlay, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteCardOverlay, "cute-card-overlay", ["cuteCardOverlay"], {}, {}, never, never, true, never>;
+}
+
+declare class CuteCardModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCardModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<CuteCardModule, never, [typeof i1.CommonModule, typeof CuteCard, typeof CuteCardTitle, typeof CuteCardSubtitle, typeof CuteCardFooter, typeof CuteCardHeader, typeof CuteCardActions, typeof CuteCardBody, typeof CuteCardOverlay, typeof CuteCardImage, typeof CuteCardAvatar, typeof CuteCardGroup], [typeof CuteCard, typeof CuteCardTitle, typeof CuteCardSubtitle, typeof CuteCardFooter, typeof CuteCardHeader, typeof CuteCardActions, typeof CuteCardBody, typeof CuteCardOverlay, typeof CuteCardImage, typeof CuteCardAvatar, typeof CuteCardGroup]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<CuteCardModule>;
+}
+
+export { CuteCard, CuteCardActions, CuteCardAvatar, CuteCardBody, CuteCardFooter, CuteCardGroup, CuteCardHeader, CuteCardImage, CuteCardModule, CuteCardOverlay, CuteCardSubtitle, CuteCardTitle };

package/checkbox/index.d.ts

@@ -0,0 +1,174 @@
+import * as i0 from '@angular/core';
+import { EventEmitter, ElementRef, SimpleChanges, InjectionToken } from '@angular/core';
+import { Validator, AbstractControl, ValidationErrors } from '@angular/forms';
+import { CuteInputControl } from '@cute-widgets/base/abstract';
+import { RelativeSize, ThemeColor } from '@cute-widgets/base/core';
+import * as i1 from '@angular/common';
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * This code is a modification of the `@angular/material` original
+ * code licensed under MIT-style License (https://angular.dev/license).
+ */
+
+/** Change event object emitted by checkbox. */
+interface CuteCheckboxChange {
+    /** The source checkbox of the event. */
+    source: CuteCheckbox;
+    /** The new `checked` value of the checkbox. */
+    checked: boolean;
+}
+declare class CuteCheckbox extends CuteInputControl implements Validator {
+    private readonly _options;
+    private _validatorChangeFn;
+    /** Users can specify the `aria-expanded` attribute which will be forwarded to the input element  */
+    ariaExpanded: boolean | undefined;
+    /** Users can specify the `aria-controls` attribute which will be forwarded to the input element */
+    ariaControls: string | undefined;
+    /** Users can specify the `aria-owns` attribute which will be forwarded to the input element */
+    ariaOwns: string | undefined;
+    get value(): any;
+    set value(v: any);
+    private _value;
+    get valueOn(): unknown;
+    set valueOn(v: unknown);
+    private _valueOn;
+    get valueOff(): unknown;
+    set valueOff(v: unknown);
+    private _valueOff;
+    /** Group checkboxes on the same horizontal row */
+    inline: boolean;
+    /** Whether the checkbox is checked. */
+    get checked(): boolean;
+    set checked(newVal: boolean);
+    private _checked;
+    /**
+     * Whether the checkbox is indeterminate. This is also known as "mixed" mode and can be used to
+     * represent a checkbox with three states, e.g. a checkbox that represents a nested list of
+     * checkable items. Note that whenever checkbox is manually clicked, indeterminate is immediately
+     * set to false.
+     */
+    get indeterminate(): boolean;
+    set indeterminate(value: boolean);
+    private _indeterminate;
+    /** Whether the label should appear after or before the checkbox. Defaults to 'after' */
+    labelPosition: 'before' | 'after';
+    /** Whether the checkbox should remain interactive when it is disabled. */
+    disabledInteractive: boolean;
+    /** Relative size of the checkbox icon. */
+    iconSize: RelativeSize;
+    /** Event emitted when the checkbox's `checked` value changes. */
+    readonly change: EventEmitter<CuteCheckboxChange>;
+    /** Event emitted when the checkbox's `indeterminate` value changes. */
+    readonly indeterminateChange: EventEmitter<boolean>;
+    /** The native `<input type="checkbox">` element */
+    readonly _inputElement: ElementRef<HTMLInputElement> | undefined;
+    /** The native `<label>` element */
+    private _labelElement;
+    constructor(...args: unknown[]);
+    ngOnChanges(changes: SimpleChanges): void;
+    ngAfterViewInit(): void;
+    validate(control: AbstractControl<boolean>): ValidationErrors | null;
+    registerOnValidatorChange(fn: () => void): void;
+    writeValue(value: any): void;
+    generateId(): string;
+    private _emitChangeEvent;
+    /** Toggles the `checked` state of the checkbox. */
+    toggle(): void;
+    /** Sets the `checked` state of the checkbox. */
+    check(): void;
+    /** Clears the `checked` state of the checkbox. */
+    uncheck(): void;
+    private _handleInputClick;
+    /** Method being called whenever the label text changes. */
+    _onLabelTextChange(): void;
+    protected _onInputChange(event: Event): void;
+    protected _onInputBlur(event: Event): void;
+    protected _onInputClick(event: Event): void;
+    protected _onTouchTargetClick(event: Event): void;
+    /**
+     *  Prevent click events that come from the `<label/>` element from bubbling. This prevents the
+     *  click handler on the host from triggering twice when clicking on the `<label/>` element. After
+     *  the click event on the `<label/>` propagates, the browsers dispatches click on the associated
+     *  `<input/>`. By preventing clicks on the label by bubbling, we ensure only one click event
+     *  bubbles when the label is clicked.
+     */
+    protected _preventBubblingFromLabel(event: MouseEvent): void;
+    /**
+     * Syncs the indeterminate value with the checkbox DOM node.
+     *
+     * We sync `indeterminate` directly on the DOM node, because in Ivy the check for whether a
+     * property is supported on an element boils down to `if (propName in an element)`. Domino's
+     * HTMLInputElement doesn't have an `indeterminate` property, so Ivy will warn during
+     * server-side rendering.
+     */
+    private _syncIndeterminate;
+    /** Creates the change event that will be emitted by the checkbox. */
+    protected _createChangeEvent(isChecked: boolean): CuteCheckboxChange;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCheckbox, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteCheckbox, "cute-checkbox, cute-slide-toggle:not([cuteToggleSwitch])", ["cuteCheckbox"], { "ariaExpanded": { "alias": "aria-expanded"; "required": false; }; "ariaControls": { "alias": "aria-controls"; "required": false; }; "ariaOwns": { "alias": "aria-owns"; "required": false; }; "value": { "alias": "value"; "required": false; }; "valueOn": { "alias": "valueOn"; "required": false; }; "valueOff": { "alias": "valueOff"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; "labelPosition": { "alias": "labelPosition"; "required": false; }; "disabledInteractive": { "alias": "disabledInteractive"; "required": false; }; "iconSize": { "alias": "iconSize"; "required": false; }; }, { "change": "change"; "indeterminateChange": "indeterminateChange"; }, never, ["*"], true, never>;
+    static ngAcceptInputType_ariaExpanded: unknown;
+    static ngAcceptInputType_inline: unknown;
+    static ngAcceptInputType_checked: unknown;
+    static ngAcceptInputType_indeterminate: unknown;
+    static ngAcceptInputType_disabledInteractive: unknown;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * This code is a modification of the `@angular/material` original
+ * code licensed under MIT-style License (https://angular.dev/license).
+ */
+
+/**
+ * Checkbox click action when a user clicks on an input element.
+ * noop: Do not toggle checked or indeterminate.
+ * check: Only toggle checked status, ignore indeterminate.
+ * check-indeterminate: Toggle checked status, set indeterminate to false. Default behavior.
+ * undefined: Same as `check-indeterminate`.
+ */
+type CuteCheckboxClickAction = 'noop' | 'check' | 'check-indeterminate' | undefined;
+/** Default `cute-checkbox` options that can be overridden. */
+interface CuteCheckboxDefaultOptions {
+    /** Default theme color palette to be used for checkboxes. */
+    color?: ThemeColor;
+    /** Default checkbox click action for checkboxes. */
+    clickAction?: CuteCheckboxClickAction;
+    /** Whether disabled checkboxes should be interactive. */
+    disabledInteractive?: boolean;
+}
+/** Injection token to be used to override the default options for `cute-checkbox`. */
+declare const CUTE_CHECKBOX_DEFAULT_OPTIONS: InjectionToken<CuteCheckboxDefaultOptions>;
+/** @docs-private */
+declare function CUTE_CHECKBOX_DEFAULT_OPTIONS_FACTORY(): CuteCheckboxDefaultOptions;
+
+/**
+ * A switch has the markup of a custom checkbox but uses the .form-switch class to render a toggle switch.
+ */
+declare class CuteToggleSwitch {
+    private _checkBox;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteToggleSwitch, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteToggleSwitch, "cute-checkbox[cuteToggleSwitch]", ["cuteToggleSwitch"], {}, {}, never, never, true, never>;
+}
+
+declare class CuteCheckboxModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCheckboxModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<CuteCheckboxModule, never, [typeof i1.CommonModule, typeof CuteCheckbox, typeof CuteToggleSwitch], [typeof CuteCheckbox, typeof CuteToggleSwitch]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<CuteCheckboxModule>;
+}
+
+export { CUTE_CHECKBOX_DEFAULT_OPTIONS, CUTE_CHECKBOX_DEFAULT_OPTIONS_FACTORY, CuteCheckbox, CuteCheckboxModule, CuteToggleSwitch };
+export type { CuteCheckboxChange, CuteCheckboxClickAction, CuteCheckboxDefaultOptions };