@anguless/angulux 22.0.0-rc.0

package/types/anguless-angulux-types-button.d.ts

@@ -0,0 +1,124 @@
+import { TemplateRef } from '@angular/core';
+import { PassThrough, PassThroughOption } from '@anguless/angulux/api';
+import { BadgePassThrough } from '@anguless/angulux/types/badge';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Button.pt}
+ * @group Interface
+ */
+interface ButtonPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the host DOM element.
+     */
+    host?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the loading icon's DOM element.
+     */
+    loadingIcon?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the icon's DOM element.
+     */
+    icon?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the label's DOM element.
+     */
+    label?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the Badge component.
+     */
+    pcBadge?: BadgePassThrough;
+}
+/**
+ * Defines valid pass-through options in Button component.
+ * @see {@link ButtonPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type ButtonPassThrough<I = unknown> = PassThrough<I, ButtonPassThroughOptions<I>>;
+/**
+ * Custom icon template context.
+ * @group Interface
+ */
+interface ButtonIconTemplateContext {
+    /**
+     * Style class of the icon.
+     */
+    class: string;
+    /**
+     * Pass-through options for the icon element.
+     */
+    pt: any;
+}
+/**
+ * Custom loading icon template context.
+ * @group Interface
+ */
+interface ButtonLoadingIconTemplateContext {
+    /**
+     * Style class of the loading icon.
+     */
+    class: string;
+    /**
+     * Pass-through options for the loading icon element.
+     */
+    pt: any;
+}
+/**
+ * Defines valid templates in Button.
+ * @group Templates
+ */
+interface ButtonTemplates {
+    /**
+     * Custom content template.
+     */
+    content(): TemplateRef<void>;
+    /**
+     * Custom icon template.
+     * @param {Object} context - icon context.
+     */
+    icon(context: ButtonIconTemplateContext): TemplateRef<ButtonIconTemplateContext>;
+    /**
+     * Custom loading icon template.
+     * @param {Object} context - loading icon context.
+     */
+    loadingicon(context: ButtonLoadingIconTemplateContext): TemplateRef<ButtonLoadingIconTemplateContext>;
+}
+type ButtonIconPosition = 'left' | 'right' | 'top' | 'bottom';
+interface ButtonProps {
+    type?: string;
+    iconPos?: ButtonIconPosition;
+    icon?: string | undefined;
+    badge?: string | undefined;
+    label?: string | undefined;
+    disabled?: boolean | undefined;
+    loading?: boolean;
+    loadingIcon?: string | undefined;
+    raised?: boolean;
+    rounded?: boolean;
+    text?: boolean;
+    plain?: boolean;
+    severity?: ButtonSeverity;
+    outlined?: boolean;
+    link?: boolean;
+    tabindex?: number | undefined;
+    size?: 'small' | 'large' | undefined;
+    style?: {
+        [klass: string]: any;
+    } | null | undefined;
+    styleClass?: string | undefined;
+    badgeClass?: string | undefined;
+    badgeSeverity?: 'success' | 'info' | 'warning' | 'danger' | 'help' | 'primary' | 'secondary' | 'contrast' | null | undefined;
+    ariaLabel?: string | undefined;
+    autofocus?: boolean | undefined;
+    variant?: string | undefined;
+}
+type ButtonSeverity = 'success' | 'info' | 'warn' | 'danger' | 'help' | 'primary' | 'secondary' | 'contrast' | null | undefined;
+
+export type { ButtonIconTemplateContext, ButtonLoadingIconTemplateContext, ButtonPassThrough, ButtonPassThroughOptions, ButtonProps, ButtonSeverity, ButtonTemplates };

package/types/anguless-angulux-types-card.d.ts

@@ -0,0 +1,75 @@
+import { TemplateRef } from '@angular/core';
+import { PassThrough, PassThroughOption } from '@anguless/angulux/api';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Card.pt}
+ * @group Interface
+ */
+interface CardPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the header's DOM element.
+     */
+    header?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the body's DOM element.
+     */
+    body?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the subtitle's DOM element.
+     */
+    subtitle?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the title's DOM element.
+     */
+    title?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the content's DOM element.
+     */
+    content?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the footer's DOM element.
+     */
+    footer?: PassThroughOption<HTMLDivElement, I>;
+}
+/**
+ * Defines valid pass-through options in Card component.
+ * @see {@link CardPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type CardPassThrough<I = unknown> = PassThrough<I, CardPassThroughOptions<I>>;
+/**
+ * Defines valid templates in Card.
+ * @group Templates
+ */
+interface CardTemplates {
+    /**
+     * Custom header template.
+     */
+    header(): TemplateRef<void>;
+    /**
+     * Custom title template.
+     */
+    title(): TemplateRef<void>;
+    /**
+     * Custom subtitle template.
+     */
+    subtitle(): TemplateRef<void>;
+    /**
+     * Custom content template.
+     */
+    content(): TemplateRef<void>;
+    /**
+     * Custom footer template.
+     */
+    footer(): TemplateRef<void>;
+}
+
+export type { CardPassThrough, CardPassThroughOptions, CardTemplates };

package/types/anguless-angulux-types-carousel.d.ts

@@ -0,0 +1,143 @@
+import { TemplateRef } from '@angular/core';
+import { PassThrough, PassThroughOption } from '@anguless/angulux/api';
+import { ButtonPassThroughOptions } from '@anguless/angulux/types/button';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Carousel.pt}
+ * @group Interface
+ */
+interface CarouselPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the header's DOM element.
+     */
+    header?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the content container's DOM element.
+     */
+    contentContainer?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the content's DOM element.
+     */
+    content?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the previous button's DOM element.
+     */
+    pcPrevButton?: ButtonPassThroughOptions;
+    /**
+     * Used to pass attributes to the viewport's DOM element.
+     */
+    viewport?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the item list's DOM element.
+     */
+    itemList?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the item's DOM element.
+     */
+    item?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the item clone's DOM element.
+     */
+    itemClone?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the next button's DOM element.
+     */
+    pcNextButton?: ButtonPassThroughOptions;
+    /**
+     * Used to pass attributes to the indicator list's DOM element.
+     */
+    indicatorList?: PassThroughOption<HTMLUListElement, I>;
+    /**
+     * Used to pass attributes to the indicator's DOM element.
+     */
+    indicator?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass attributes to the indicator button's DOM element.
+     */
+    indicatorButton?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the footer's DOM element.
+     */
+    footer?: PassThroughOption<HTMLDivElement, I>;
+}
+/**
+ * Defines valid pass-through options in Carousel.
+ * @see {@link CarouselPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type CarouselPassThrough<I = unknown> = PassThrough<I, CarouselPassThroughOptions<I>>;
+/**
+ * Responsive options of the component.
+ * @group Interface
+ */
+interface CarouselResponsiveOptions {
+    /**
+     * Breakpoint for responsive mode. Exp; @media screen and (max-width: ${breakpoint}) {...}
+     */
+    breakpoint: string;
+    /**
+     * The number of visible items on breakpoint.
+     */
+    numVisible: number;
+    /**
+     * The number of scrolled items on breakpoint.
+     */
+    numScroll: number;
+}
+/**
+ * Custom page event.
+ * @group Events
+ */
+interface CarouselPageEvent {
+    /**
+     * Current page.
+     */
+    page?: number;
+}
+/**
+ * Custom item template context.
+ * @group Interface
+ */
+interface CarouselItemTemplateContext<T = any> {
+    /**
+     * Data of the item.
+     */
+    $implicit: T;
+}
+/**
+ * Defines valid templates in Carousel.
+ * @group Templates
+ */
+interface CarouselTemplates<T = any> {
+    /**
+     * Custom header template.
+     */
+    header(): TemplateRef<void>;
+    /**
+     * Custom item template.
+     * @param {Object} context - item data.
+     */
+    item(context: CarouselItemTemplateContext<T>): TemplateRef<CarouselItemTemplateContext<T>>;
+    /**
+     * Custom previous icon template.
+     */
+    previousicon(): TemplateRef<void>;
+    /**
+     * Custom next icon template.
+     */
+    nexticon(): TemplateRef<void>;
+    /**
+     * Custom footer template.
+     */
+    footer(): TemplateRef<void>;
+}
+
+export type { CarouselItemTemplateContext, CarouselPageEvent, CarouselPassThrough, CarouselPassThroughOptions, CarouselResponsiveOptions, CarouselTemplates };

package/types/anguless-angulux-types-cascadeselect.d.ts

@@ -0,0 +1,215 @@
+import { ElementRef, TemplateRef } from '@angular/core';
+import { PassThrough, PassThroughOption } from '@anguless/angulux/api';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link CascadeSelect.pt}
+ * @group Interface
+ */
+interface CascadeSelectPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the hidden input wrapper's DOM element.
+     */
+    hiddenInputWrapper?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the hidden input's DOM element.
+     */
+    hiddenInput?: PassThroughOption<HTMLInputElement, I>;
+    /**
+     * Used to pass attributes to the label's DOM element.
+     */
+    label?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the dropdown's DOM element.
+     */
+    dropdown?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the loading icon's DOM element.
+     */
+    loadingIcon?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the dropdown icon's DOM element.
+     */
+    dropdownIcon?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the clear icon's DOM element.
+     */
+    clearIcon?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the overlay's DOM element.
+     */
+    overlay?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the list container's DOM element.
+     */
+    listContainer?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the list's DOM element.
+     */
+    list?: PassThroughOption<HTMLUListElement, I>;
+    /**
+     * Used to pass attributes to the option list's DOM element.
+     */
+    optionList?: PassThroughOption<HTMLUListElement, I>;
+    /**
+     * Used to pass attributes to the option's DOM element.
+     */
+    option?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass attributes to the option content's DOM element.
+     */
+    optionContent?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the option text's DOM element.
+     */
+    optionText?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the group icon's DOM element.
+     */
+    groupIcon?: PassThroughOption<HTMLElement, I>;
+}
+/**
+ * Defines valid pass-through options in CascadeSelect.
+ * @see {@link CascadeSelectPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type CascadeSelectPassThrough<I = unknown> = PassThrough<I, CascadeSelectPassThroughOptions<I>>;
+/**
+ * Custom panel show event.
+ * @see {@link CascadeSelect.onShow}
+ * @group Events
+ */
+interface CascadeSelectShowEvent {
+    /**
+     * Overlay element.
+     */
+    overlay?: ElementRef | TemplateRef<any> | HTMLElement | null | undefined;
+    /**
+     * Target element.
+     */
+    target?: ElementRef | TemplateRef<any> | HTMLElement | null | undefined;
+    /**
+     * Overlay mode.
+     */
+    overlayMode?: 'modal' | 'overlay' | string;
+}
+/**
+ * Custom panel hide event.
+ * @see {@link CascadeSelect.onHide}
+ * @extends {CascadeSelectShowEvent}
+ * @group Events
+ */
+interface CascadeSelectHideEvent extends CascadeSelectShowEvent {
+}
+/**
+ * Custom panel show event emits right before the panel is shown.
+ * @see {@link CascadeSelect.onBeforeShow}
+ * @extends {CascadeSelectShowEvent}
+ * @group Events
+ */
+interface CascadeSelectBeforeShowEvent extends CascadeSelectShowEvent {
+}
+/**
+ * Custom panel hide event emits right before the panel is hidden.
+ * @see {@link CascadeSelect.onBeforeHide}
+ * @extends {CascadeSelectShowEvent}
+ * @group Events
+ */
+interface CascadeSelectBeforeHideEvent extends CascadeSelectShowEvent {
+}
+/**
+ * Custom panel change event emits when selection changed.
+ * @see {@link CascadeSelect.onChange}
+ * @group Events
+ */
+interface CascadeSelectChangeEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent?: Event;
+    /**
+     * Selected value.
+     */
+    value?: any;
+    /**
+     * Focus state.
+     */
+    isFocus?: boolean;
+}
+/**
+ * Custom value template context.
+ * @group Interface
+ */
+interface CascadeSelectValueTemplateContext<T = any> {
+    /**
+     * Selected value.
+     */
+    $implicit: T;
+    /**
+     * Placeholder text.
+     */
+    placeholder: string;
+}
+/**
+ * Custom option template context.
+ * @group Interface
+ */
+interface CascadeSelectOptionTemplateContext<T = any> {
+    /**
+     * Option instance.
+     */
+    $implicit: T;
+    /**
+     * Level of the option in the hierarchy.
+     */
+    level: number;
+}
+/**
+ * Defines valid templates in CascadeSelect.
+ * @group Templates
+ */
+interface CascadeSelectTemplates<T = any> {
+    /**
+     * Custom value template.
+     * @param {Object} context - value data.
+     */
+    value(context: CascadeSelectValueTemplateContext<T>): TemplateRef<CascadeSelectValueTemplateContext<T>>;
+    /**
+     * Custom option template.
+     * @param {Object} context - option data.
+     */
+    option(context: CascadeSelectOptionTemplateContext<T>): TemplateRef<CascadeSelectOptionTemplateContext<T>>;
+    /**
+     * Custom header template.
+     */
+    header(): TemplateRef<void>;
+    /**
+     * Custom footer template.
+     */
+    footer(): TemplateRef<void>;
+    /**
+     * Custom dropdown trigger icon template.
+     */
+    triggericon(): TemplateRef<void>;
+    /**
+     * Custom clear icon template.
+     */
+    clearicon(): TemplateRef<void>;
+    /**
+     * Custom option group icon template.
+     */
+    optiongroupicon(): TemplateRef<void>;
+    /**
+     * Custom loading icon template.
+     */
+    loadingicon(): TemplateRef<void>;
+}
+
+export type { CascadeSelectBeforeHideEvent, CascadeSelectBeforeShowEvent, CascadeSelectChangeEvent, CascadeSelectHideEvent, CascadeSelectOptionTemplateContext, CascadeSelectPassThrough, CascadeSelectPassThroughOptions, CascadeSelectShowEvent, CascadeSelectTemplates, CascadeSelectValueTemplateContext };

package/types/anguless-angulux-types-chart.d.ts

@@ -0,0 +1,32 @@
+import { PassThrough, PassThroughOption } from '@anguless/angulux/api';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link UIChart.pt}
+ * @group Interface
+ */
+interface ChartPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the host's DOM element.
+     */
+    host?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the canvas DOM element.
+     */
+    canvas?: PassThroughOption<HTMLCanvasElement, I>;
+}
+/**
+ * Defines valid pass-through options in Chart.
+ * @see {@link ChartPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type ChartPassThrough<I = unknown> = PassThrough<I, ChartPassThroughOptions<I>>;
+
+export type { ChartPassThrough, ChartPassThroughOptions };

package/types/anguless-angulux-types-checkbox.d.ts

@@ -0,0 +1,81 @@
+import { TemplateRef } from '@angular/core';
+import { PassThrough, PassThroughOption } from '@anguless/angulux/api';
+
+/**
+ * Custom change event.
+ * @see {@link Checkbox.onChange}
+ * @group Events
+ */
+interface CheckboxChangeEvent {
+    /**
+     * Checked value.
+     */
+    checked?: any;
+    /**
+     * Browser event.
+     */
+    originalEvent?: Event;
+}
+/**
+ * Custom checkbox icon template context.
+ * @group Interface
+ */
+interface CheckboxIconTemplateContext {
+    /**
+     * State of the checkbox.
+     */
+    checked: boolean;
+    /**
+     * Style class of the icon.
+     */
+    class: string;
+    /**
+     * DataP attributes.
+     */
+    dataP: string;
+}
+/**
+ * Defines valid templates in Checkbox.
+ * @group Templates
+ */
+interface CheckboxTemplates {
+    /**
+     * Custom checkbox icon template.
+     * @param {Object} context - icon context.
+     */
+    icon(context: CheckboxIconTemplateContext): TemplateRef<CheckboxIconTemplateContext>;
+}
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link CheckboxProps.pt}
+ * @group Interface
+ */
+interface CheckboxPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the input's DOM element.
+     */
+    input?: PassThroughOption<HTMLInputElement, I>;
+    /**
+     * Used to pass attributes to the box's DOM element.
+     */
+    box?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the icon's DOM element.
+     */
+    icon?: PassThroughOption<HTMLElement, I>;
+}
+/**
+ * Defines valid pass-through options in Checkbox.
+ * @see {@link CheckboxPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type CheckboxPassThrough<I = unknown> = PassThrough<I, CheckboxPassThroughOptions<I>>;
+
+export type { CheckboxChangeEvent, CheckboxIconTemplateContext, CheckboxPassThrough, CheckboxPassThroughOptions, CheckboxTemplates };