primenglab 22.0.0-beta.1

package/types/primenglab-ts-helpers.d.ts

@@ -0,0 +1,6 @@
+declare type Booleanish = boolean | 'true' | 'false';
+declare type Numberish = number | string;
+declare type Nullable<T = void> = T | null | undefined;
+declare type VoidListener = VoidFunction | null | undefined;
+
+export type { Booleanish, Nullable, Numberish, VoidListener };

package/types/primenglab-types-accordion.d.ts

@@ -0,0 +1,135 @@
+import { MotionOptions } from '@primeuix/motion';
+import { PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Defines the value type for Accordion component.
+ * @group Types
+ */
+type AccordionValue = string | number | (string | number)[] | null | undefined;
+/**
+ * Custom tab open event.
+ * @see {@link onOpen}
+ * @group Interface
+ */
+interface AccordionTabOpenEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Opened tab index.
+     */
+    index: number;
+}
+/**
+ * Custom tab close event.
+ * @see {@link onClose}
+ * @extends {AccordionTabOpenEvent}
+ * @group Interface
+ */
+interface AccordionTabCloseEvent extends AccordionTabOpenEvent {
+}
+/**
+ * Toggle icon template context.
+ * @group Interface
+ */
+interface AccordionToggleIconTemplateContext {
+    /**
+     * Represents the active status of the panel.
+     */
+    active: boolean;
+}
+/**
+ * Defines valid pass-through options in Accordion component.
+ * @template I Type of instance.
+ *
+ * @group Interface
+ */
+interface AccordionPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass options to the motion component/directive.
+     */
+    motion?: MotionOptions;
+}
+/**
+ * Defines valid pass-through options in Accordion component.
+ * @see {@link AccordionPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type AccordionPassThrough<I = unknown> = PassThrough<I, AccordionPassThroughOptions<I>>;
+/**
+ * Defines valid pass-through options in AccordionPanel component.
+ * @template I Type of instance.
+ *
+ * @group Interface
+ */
+interface AccordionPanelPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the panel's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+}
+/**
+ * Defines valid pass-through options in AccordionPanel component.
+ * @see {@link AccordionPanelPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type AccordionPanelPassThrough<I = unknown> = PassThrough<I, AccordionPanelPassThroughOptions<I>>;
+/**
+ * Defines valid pass-through options in AccordionHeader component.
+ * @template I Type of instance.
+ *
+ * @group Interface
+ */
+interface AccordionHeaderPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the header's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the toggle icon's DOM element.
+     */
+    toggleicon?: PassThroughOption<SVGElement, I>;
+}
+/**
+ * Defines valid pass-through options in AccordionHeader component.
+ * @see {@link AccordionHeaderPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type AccordionHeaderPassThrough<I = unknown> = PassThrough<I, AccordionHeaderPassThroughOptions<I>>;
+/**
+ * Defines valid pass-through options in AccordionContent component.
+ * @template I Type of instance.
+ *
+ * @group Interface
+ */
+interface AccordionContentPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the content container's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the content wrapper DOM element.
+     */
+    contentWrapper?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the content's DOM element.
+     */
+    content?: PassThroughOption<HTMLDivElement, I>;
+}
+/**
+ * Defines valid pass-through options in AccordionContent component.
+ * @see {@link AccordionContentPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type AccordionContentPassThrough<I = unknown> = PassThrough<I, AccordionContentPassThroughOptions<I>>;
+
+export type { AccordionContentPassThrough, AccordionContentPassThroughOptions, AccordionHeaderPassThrough, AccordionHeaderPassThroughOptions, AccordionPanelPassThrough, AccordionPanelPassThroughOptions, AccordionPassThrough, AccordionPassThroughOptions, AccordionTabCloseEvent, AccordionTabOpenEvent, AccordionToggleIconTemplateContext, AccordionValue };

package/types/primenglab-types-autocomplete.d.ts

@@ -0,0 +1,312 @@
+import { TemplateRef } from '@angular/core';
+import { ScrollerOptions, PassThrough, PassThroughOption } from 'primenglab/api';
+import { ChipPassThrough } from 'primenglab/types/chip';
+import { InputTextPassThrough } from 'primenglab/types/inputtext';
+import { OverlayPassThrough } from 'primenglab/types/overlay';
+import { VirtualScrollerPassThrough } from 'primenglab/types/scroller';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link AutoComplete.pt}
+ * @group Interface
+ */
+interface AutoCompletePassThroughOptions<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 InputText component.
+     * @see {@link InputTextPassThrough}
+     */
+    pcInputText?: InputTextPassThrough;
+    /**
+     * Used to pass attributes to the input multiple's DOM element.
+     */
+    inputMultiple?: PassThroughOption<HTMLUListElement, I>;
+    /**
+     * Used to pass attributes to the chip item's DOM element.
+     */
+    chipItem?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass attributes to the Chip component.
+     * @see {@link ChipPassThrough}
+     */
+    pcChip?: ChipPassThrough;
+    /**
+     * Used to pass attributes to the chip icon's DOM element.
+     */
+    chipIcon?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the input chip's DOM element.
+     */
+    inputChip?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass attributes to the clear icon's DOM element.
+     */
+    clearIcon?: PassThroughOption<SVGElement, I>;
+    /**
+     * Used to pass attributes to the loader's DOM element.
+     */
+    loader?: PassThroughOption<SVGElement, I>;
+    /**
+     * Used to pass attributes to the dropdown button's DOM element.
+     */
+    dropdown?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the Overlay component.
+     * @see {@link OverlayPassThrough}
+     */
+    pcOverlay?: OverlayPassThrough;
+    /**
+     * 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 Scroller component.
+     * @see {@link VirtualScrollerPassThrough}
+     */
+    pcScroller?: VirtualScrollerPassThrough;
+    /**
+     * Used to pass attributes to the list's DOM element.
+     */
+    list?: PassThroughOption<HTMLUListElement, I>;
+    /**
+     * Used to pass attributes to the option group's DOM element.
+     */
+    optionGroup?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass attributes to the option's DOM element.
+     */
+    option?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass attributes to the empty message's DOM element.
+     */
+    emptyMessage?: PassThroughOption<HTMLLIElement, I>;
+}
+/**
+ * Defines valid pass-through options in AutoComplete.
+ * @see {@link AutoCompletePassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type AutoCompletePassThrough<I = unknown> = PassThrough<I, AutoCompletePassThroughOptions<I>>;
+/**
+ * Custom complete event.
+ * @see {@link AutoComplete.completeMethod}
+ * @group Events
+ */
+interface AutoCompleteCompleteEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Selected option value.
+     */
+    query: string;
+}
+/**
+ * Custom click event.
+ * @see {@link AutoComplete.onDropdownClick}
+ * @group Events
+ */
+interface AutoCompleteDropdownClickEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Selected option value.
+     */
+    query?: string;
+}
+/**
+ * Custom select event.
+ * @see {@link AutoComplete.onSelect}
+ * @group Events
+ */
+interface AutoCompleteSelectEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Selected value.
+     */
+    value: any;
+}
+/**
+ * Custom unselect event.
+ * @see {@link AutoComplete.onUnSelect}
+ * @group Events
+ */
+interface AutoCompleteUnselectEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Removed value.
+     */
+    value: any;
+}
+/**
+ * Custom add event.
+ * @see {@link AutoComplete.onAdd}
+ * @group Events
+ */
+interface AutoCompleteAddEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Added value.
+     */
+    value: any;
+}
+/**
+ * Custom lazy load event.
+ * @see {@link AutoComplete.onLazyLoad}
+ * @group Events
+ */
+interface AutoCompleteLazyLoadEvent {
+    /**
+     * First element in viewport.
+     */
+    first: any;
+    /**
+     * Last element in viewport.
+     */
+    last: any;
+}
+/**
+ * Custom item template context.
+ * @group Interface
+ */
+interface AutoCompleteItemTemplateContext<T = any> {
+    /**
+     * Data of the option.
+     */
+    $implicit: T;
+    /**
+     * Index of the option.
+     */
+    index: number;
+}
+/**
+ * Custom group template context.
+ * @group Interface
+ */
+interface AutoCompleteGroupTemplateContext<T = any> {
+    /**
+     * Group option.
+     */
+    $implicit: T;
+}
+/**
+ * Custom selected item template context.
+ * @group Interface
+ */
+interface AutoCompleteSelectedItemTemplateContext<T = any> {
+    /**
+     * Selected option value.
+     */
+    $implicit: T;
+}
+/**
+ * Custom loader template context.
+ * @group Interface
+ */
+interface AutoCompleteLoaderTemplateContext {
+    /**
+     * Virtual scroller options.
+     */
+    options: ScrollerOptions;
+}
+/**
+ * Custom remove icon template context.
+ * @group Interface
+ */
+interface AutoCompleteRemoveIconTemplateContext {
+    /**
+     * Style class of the icon.
+     */
+    class: string;
+    /**
+     * Callback to remove the item.
+     */
+    removeCallback: (event: Event, index: number) => void;
+    /**
+     * Index of the item.
+     */
+    index: number;
+}
+/**
+ * Defines valid templates in AutoComplete.
+ * @group Templates
+ */
+interface AutoCompleteTemplates<T = any> {
+    /**
+     * Custom item template.
+     * @param {Object} context - option data.
+     */
+    item(context: AutoCompleteItemTemplateContext<T>): TemplateRef<AutoCompleteItemTemplateContext<T>>;
+    /**
+     * Custom group template.
+     * @param {Object} context - group data.
+     */
+    group(context: AutoCompleteGroupTemplateContext<T>): TemplateRef<AutoCompleteGroupTemplateContext<T>>;
+    /**
+     * Custom selected item template, only supported in multiple mode.
+     * @param {Object} context - selected item data.
+     */
+    selecteditem(context: AutoCompleteSelectedItemTemplateContext<T>): TemplateRef<AutoCompleteSelectedItemTemplateContext<T>>;
+    /**
+     * Custom header template.
+     */
+    header(): TemplateRef<void>;
+    /**
+     * Custom empty template.
+     */
+    empty(): TemplateRef<void>;
+    /**
+     * Custom footer template.
+     */
+    footer(): TemplateRef<void>;
+    /**
+     * Custom loader template.
+     * @param {Object} context - scroller options.
+     */
+    loader(context: AutoCompleteLoaderTemplateContext): TemplateRef<AutoCompleteLoaderTemplateContext>;
+    /**
+     * Custom remove icon template.
+     * @param {Object} context - icon context.
+     */
+    removeicon(context: AutoCompleteRemoveIconTemplateContext): TemplateRef<AutoCompleteRemoveIconTemplateContext>;
+    /**
+     * Custom loading icon template.
+     */
+    loadingicon(): TemplateRef<void>;
+    /**
+     * Custom clear icon template.
+     */
+    clearicon(): TemplateRef<void>;
+    /**
+     * Custom dropdown icon template.
+     */
+    dropdownicon(): TemplateRef<void>;
+}
+
+export type { AutoCompleteAddEvent, AutoCompleteCompleteEvent, AutoCompleteDropdownClickEvent, AutoCompleteGroupTemplateContext, AutoCompleteItemTemplateContext, AutoCompleteLazyLoadEvent, AutoCompleteLoaderTemplateContext, AutoCompletePassThrough, AutoCompletePassThroughOptions, AutoCompleteRemoveIconTemplateContext, AutoCompleteSelectEvent, AutoCompleteSelectedItemTemplateContext, AutoCompleteTemplates, AutoCompleteUnselectEvent };

package/types/primenglab-types-avatar.d.ts

@@ -0,0 +1,50 @@
+import { PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Defines the size of the avatar.
+ * @group Types
+ */
+type AvatarSize = 'normal' | 'large' | 'xlarge';
+/**
+ * Defines the shape of the avatar.
+ * @group Types
+ */
+type AvatarShape = 'square' | 'circle';
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Avatar.pt}
+ * @group Interface
+ */
+interface AvatarPassThroughOptions<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<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the label's DOM element.
+     */
+    label?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the icon's DOM element.
+     */
+    icon?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the image's DOM element.
+     */
+    image?: PassThroughOption<HTMLImageElement, I>;
+}
+/**
+ * Defines valid pass-through options in Avatar component.
+ * @see {@link AvatarPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type AvatarPassThrough<I = unknown> = PassThrough<I, AvatarPassThroughOptions<I>>;
+
+export type { AvatarPassThrough, AvatarPassThroughOptions, AvatarShape, AvatarSize };

package/types/primenglab-types-avatargroup.d.ts

@@ -0,0 +1,28 @@
+import { PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link AvatarGroupProps.pt}
+ * @group Interface
+ */
+interface AvatarGroupPassThroughOptions<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<HTMLDivElement, I>;
+}
+/**
+ * Defines valid pass-through options in AvatarGroup.
+ * @see {@link AvatarGroupPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type AvatarGroupPassThrough<I = unknown> = PassThrough<I, AvatarGroupPassThroughOptions<I>>;
+
+export type { AvatarGroupPassThrough, AvatarGroupPassThroughOptions };

package/types/primenglab-types-badge.d.ts

@@ -0,0 +1,36 @@
+import { PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Defines the size of the badge.
+ * @group Types
+ */
+type BadgeSize = 'small' | 'large' | 'xlarge' | null;
+/**
+ * Defines the severity of the badge.
+ * @group Types
+ */
+type BadgeSeverity = 'secondary' | 'info' | 'success' | 'warn' | 'danger' | 'contrast' | null;
+/**
+ * Custom passthrough(pt) options.
+ * @see {@link Badge.pt}
+ * @group Interface
+ */
+interface BadgePassThroughOptions<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>;
+}
+/**
+ * Defines valid pass-through options in Badge component.
+ * @see {@link BadgePassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type BadgePassThrough<I = unknown> = PassThrough<I, BadgePassThroughOptions<I>>;
+
+export type { BadgePassThrough, BadgePassThroughOptions, BadgeSeverity, BadgeSize };

package/types/primenglab-types-blockui.d.ts

@@ -0,0 +1,39 @@
+import { TemplateRef } from '@angular/core';
+import { PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link BlockUI.pt}
+ * @group Interface
+ */
+interface BlockUIPassThroughOptions<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<HTMLDivElement, I>;
+}
+/**
+ * Defines valid pass-through options in BlockUI component.
+ * @see {@link BlockUIPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type BlockUIPassThrough<I = unknown> = PassThrough<I, BlockUIPassThroughOptions<I>>;
+/**
+ * Defines valid templates in BlockUI.
+ * @group Templates
+ */
+interface BlockUITemplates {
+    /**
+     * Custom template of content.
+     */
+    content(): TemplateRef<any>;
+}
+
+export type { BlockUIPassThrough, BlockUIPassThroughOptions, BlockUITemplates };

package/types/primenglab-types-breadcrumb.d.ts

@@ -0,0 +1,96 @@
+import { TemplateRef } from '@angular/core';
+import { MenuItem, PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Breadcrumb.pt}
+ * @group Interface
+ */
+interface BreadcrumbPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the list's DOM element.
+     */
+    list?: PassThroughOption<HTMLOListElement, I>;
+    /**
+     * Used to pass attributes to the home item's DOM element.
+     */
+    homeItem?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass attributes to the item's DOM element.
+     */
+    item?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass attributes to the item link's DOM element.
+     */
+    itemLink?: PassThroughOption<HTMLAnchorElement, I>;
+    /**
+     * Used to pass attributes to the item icon's DOM element.
+     */
+    itemIcon?: PassThroughOption<HTMLSpanElement | SVGElement, I>;
+    /**
+     * Used to pass attributes to the item label's DOM element.
+     */
+    itemLabel?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the separator's DOM element.
+     */
+    separator?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass attributes to the separator icon's DOM element.
+     */
+    separatorIcon?: PassThroughOption<SVGElement, I>;
+}
+/**
+ * Defines valid pass-through options in Breadcrumb.
+ * @see {@link BreadcrumbPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type BreadcrumbPassThrough<I = unknown> = PassThrough<I, BreadcrumbPassThroughOptions<I>>;
+/**
+ * Defines clicked item event.
+ * @see {@link BreadcrumbEmitsOptions.itemClick}
+ */
+interface BreadcrumbItemClickEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Clicked item instance.
+     */
+    item: MenuItem;
+}
+/**
+ * Custom item template context.
+ * @group Interface
+ */
+interface BreadcrumbItemTemplateContext {
+    /**
+     * Menu item instance.
+     */
+    $implicit: MenuItem;
+}
+/**
+ * Defines valid templates in Breadcrumb.
+ * @group Templates
+ */
+interface BreadcrumbTemplates {
+    /**
+     * Custom item template.
+     * @param {Object} context - item data.
+     */
+    item(context: BreadcrumbItemTemplateContext): TemplateRef<BreadcrumbItemTemplateContext>;
+    /**
+     * Custom separator template.
+     */
+    separator(): TemplateRef<void>;
+}
+
+export type { BreadcrumbItemClickEvent, BreadcrumbItemTemplateContext, BreadcrumbPassThrough, BreadcrumbPassThroughOptions, BreadcrumbTemplates };