primenglab 22.0.0-beta.1

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

@@ -0,0 +1,120 @@
+import { PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Defines the scrolling behavior when the active tab changes.
+ * @group Types
+ */
+type TabsScrollStrategy = 'nearest' | 'center' | false;
+/**
+ * Defines valid pass-through options in Tabs component.
+ * @template I Type of instance.
+ *
+ * @group Interface
+ */
+interface TabsPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+}
+/**
+ * Defines valid pass-through options in Tabs component.
+ * @see {@link TabsPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type TabsPassThrough<I = unknown> = PassThrough<I, TabsPassThroughOptions<I>>;
+/**
+ * Defines valid pass-through options in TabList component.
+ * @template I Type of instance.
+ *
+ * @group Interface
+ */
+interface TabListPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the previous button's DOM element.
+     */
+    prevButton?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the content's DOM element.
+     */
+    content?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the active bar's DOM element.
+     */
+    activeBar?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the next button's DOM element.
+     */
+    nextButton?: PassThroughOption<HTMLButtonElement, I>;
+}
+/**
+ * Defines valid pass-through options in TabList component.
+ * @see {@link TabListPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type TabListPassThrough<I = unknown> = PassThrough<I, TabListPassThroughOptions<I>>;
+/**
+ * Defines valid pass-through options in Tab component.
+ * @template I Type of instance.
+ *
+ * @group Interface
+ */
+interface TabPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+}
+/**
+ * Defines valid pass-through options in Tab component.
+ * @see {@link TabPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type TabPassThrough<I = unknown> = PassThrough<I, TabPassThroughOptions<I>>;
+/**
+ * Defines valid pass-through options in TabPanel component.
+ * @template I Type of instance.
+ *
+ * @group Interface
+ */
+interface TabPanelPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+}
+/**
+ * Defines valid pass-through options in TabPanel component.
+ * @see {@link TabPanelPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type TabPanelPassThrough<I = unknown> = PassThrough<I, TabPanelPassThroughOptions<I>>;
+/**
+ * Defines valid pass-through options in TabPanels component.
+ * @template I Type of instance.
+ *
+ * @group Interface
+ */
+interface TabPanelsPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLElement, I>;
+}
+/**
+ * Defines valid pass-through options in TabPanels component.
+ * @see {@link TabPanelsPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type TabPanelsPassThrough<I = unknown> = PassThrough<I, TabPanelsPassThroughOptions<I>>;
+
+export type { TabListPassThrough, TabListPassThroughOptions, TabPanelPassThrough, TabPanelPassThroughOptions, TabPanelsPassThrough, TabPanelsPassThroughOptions, TabPassThrough, TabPassThroughOptions, TabsPassThrough, TabsPassThroughOptions, TabsScrollStrategy };

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

@@ -0,0 +1,48 @@
+import { TemplateRef } from '@angular/core';
+import { PassThrough, PassThroughOption } from 'primenglab/api';
+
+type TagSeverity = 'success' | 'secondary' | 'info' | 'warn' | 'danger' | 'contrast';
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Tag.pt}
+ * @group Interface
+ */
+interface TagPassThroughOptions<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<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>;
+}
+/**
+ * Defines valid pass-through options in Tag.
+ * @see {@link TagPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type TagPassThrough<I = unknown> = PassThrough<I, TagPassThroughOptions<I>>;
+/**
+ * Defines valid templates in Tag.
+ * @group Templates
+ */
+interface TagTemplates {
+    /**
+     * Custom icon template.
+     */
+    icon(): TemplateRef<void>;
+}
+
+export type { TagPassThrough, TagPassThroughOptions, TagSeverity, TagTemplates };

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

@@ -0,0 +1,60 @@
+import { PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Terminal.pt}
+ * @group Interface
+ */
+interface TerminalPassThroughOptions<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 welcome message's DOM element.
+     */
+    welcomeMessage?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the command list's DOM element.
+     */
+    commandList?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the command's DOM element.
+     */
+    command?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the prompt label's DOM element.
+     */
+    promptLabel?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the command value's DOM element.
+     */
+    commandValue?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the command response's DOM element.
+     */
+    commandResponse?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the prompt's DOM element.
+     */
+    prompt?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the prompt value's DOM element.
+     */
+    promptValue?: PassThroughOption<HTMLInputElement, I>;
+}
+/**
+ * Defines valid pass-through options in Terminal.
+ * @see {@link TerminalPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type TerminalPassThrough<I = unknown> = PassThrough<I, TerminalPassThroughOptions<I>>;
+
+export type { TerminalPassThrough, TerminalPassThroughOptions };

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

@@ -0,0 +1,28 @@
+import { PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Textarea.pt}
+ * @group Interface
+ */
+interface TextareaPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the host's DOM element.
+     */
+    host?: PassThroughOption<HTMLTextAreaElement, I>;
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLTextAreaElement, I>;
+}
+/**
+ * Defines valid pass-through options in Textarea.
+ * @see {@link TextareaPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type TextareaPassThrough<I = unknown> = PassThrough<I, TextareaPassThroughOptions<I>>;
+
+export type { TextareaPassThrough, TextareaPassThroughOptions };

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

@@ -0,0 +1,203 @@
+import { TemplateRef } from '@angular/core';
+import { MotionOptions } from '@primeuix/motion';
+import { MenuItem, PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Processed menu item used internally.
+ */
+interface TieredMenuProcessedItem {
+    /**
+     * Menu item instance.
+     */
+    item: MenuItem;
+    /**
+     * Index of the item in its parent.
+     */
+    index: number;
+    /**
+     * Nesting level of the item.
+     */
+    level: number;
+    /**
+     * Unique key of the item.
+     */
+    key: string;
+    /**
+     * Parent processed item.
+     */
+    parent: TieredMenuProcessedItem | Record<string, never>;
+    /**
+     * Parent key.
+     */
+    parentKey: string;
+    /**
+     * Child processed items.
+     */
+    items: TieredMenuProcessedItem[];
+}
+/**
+ * Focused item info used internally.
+ */
+interface TieredMenuFocusedItemInfo {
+    /**
+     * Index of the focused item.
+     */
+    index: number;
+    /**
+     * Nesting level of the focused item.
+     */
+    level?: number;
+    /**
+     * Parent key of the focused item.
+     */
+    parentKey: string;
+    /**
+     * Focused item instance.
+     */
+    item?: MenuItem | null;
+}
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link TieredMenu.pt}
+ * @group Interface
+ */
+interface TieredMenuPassThroughOptions<I = unknown> {
+    /**
+     * Used to pass attributes to the root's DOM element.
+     */
+    root?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the root list's DOM element.
+     */
+    rootList?: PassThroughOption<HTMLUListElement, I>;
+    /**
+     * Used to pass attributes to the submenu's DOM element.
+     */
+    submenu?: PassThroughOption<HTMLUListElement, I>;
+    /**
+     * Used to pass attributes to the item's DOM element.
+     */
+    item?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass attributes to the item content's DOM element.
+     */
+    itemContent?: PassThroughOption<HTMLDivElement, 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, I>;
+    /**
+     * Used to pass attributes to the item label's DOM element.
+     */
+    itemLabel?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the submenu icon's DOM element.
+     */
+    submenuIcon?: PassThroughOption<HTMLSpanElement, I>;
+    /**
+     * Used to pass attributes to the separator's DOM element.
+     */
+    separator?: PassThroughOption<HTMLLIElement, I>;
+    /**
+     * Used to pass options to the motion component/directive.
+     */
+    motion?: MotionOptions;
+}
+/**
+ * Defines valid pass-through options in TieredMenu.
+ * @see {@link TieredMenuPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type TieredMenuPassThrough<I = unknown> = PassThrough<I, TieredMenuPassThroughOptions<I>>;
+/**
+ * Item click event.
+ * @group Interface
+ */
+interface TieredMenuItemClickEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Processed item instance.
+     */
+    processedItem: TieredMenuProcessedItem;
+    /**
+     * Whether to focus the menu.
+     */
+    isFocus?: boolean;
+}
+/**
+ * Item mouse enter event.
+ * @group Interface
+ */
+interface TieredMenuItemMouseEnterEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent: Event;
+    /**
+     * Processed item instance.
+     */
+    processedItem: TieredMenuProcessedItem;
+    /**
+     * Whether to focus the menu.
+     */
+    focus?: boolean;
+}
+/**
+ * Toggle event.
+ * @group Interface
+ */
+interface TieredMenuToggleEvent {
+    /**
+     * Current target element.
+     */
+    currentTarget?: EventTarget | null;
+    /**
+     * Related target element.
+     */
+    relatedTarget?: EventTarget | null;
+    /**
+     * Whether to use relative alignment.
+     */
+    relativeAlign?: boolean;
+}
+/**
+ * Custom item template context.
+ * @group Interface
+ */
+interface TieredMenuItemTemplateContext {
+    /**
+     * Item instance.
+     */
+    $implicit: MenuItem;
+    /**
+     * Whether the item has a submenu.
+     */
+    hasSubmenu: boolean;
+}
+/**
+ * Defines valid templates in TieredMenu.
+ * @group Templates
+ */
+interface TieredMenuTemplates {
+    /**
+     * Custom item template.
+     * @param {TieredMenuItemTemplateContext} context - item context.
+     */
+    item(context: TieredMenuItemTemplateContext): TemplateRef<TieredMenuItemTemplateContext>;
+    /**
+     * Custom submenu icon template.
+     */
+    submenuicon(): TemplateRef<void>;
+}
+
+export type { TieredMenuFocusedItemInfo, TieredMenuItemClickEvent, TieredMenuItemMouseEnterEvent, TieredMenuItemTemplateContext, TieredMenuPassThrough, TieredMenuPassThroughOptions, TieredMenuProcessedItem, TieredMenuTemplates, TieredMenuToggleEvent };

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

@@ -0,0 +1,93 @@
+import { TemplateRef } from '@angular/core';
+import { PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Defines valid align values for Timeline.
+ */
+type TimelineAlign = 'left' | 'right' | 'top' | 'bottom' | 'alternate';
+/**
+ * Defines valid layout values for Timeline.
+ */
+type TimelineLayout = 'vertical' | 'horizontal';
+/**
+ * Custom pass-through(pt) options.
+ * @template I Type of instance.
+ *
+ * @see {@link Timeline.pt}
+ * @group Interface
+ */
+interface TimelinePassThroughOptions<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 event's DOM element.
+     */
+    event?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the event opposite's DOM element.
+     */
+    eventOpposite?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the event separator's DOM element.
+     */
+    eventSeparator?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the event marker's DOM element.
+     */
+    eventMarker?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the event connector's DOM element.
+     */
+    eventConnector?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the event content's DOM element.
+     */
+    eventContent?: PassThroughOption<HTMLDivElement, I>;
+}
+/**
+ * Defines valid pass-through options in Timeline.
+ * @see {@link TimelinePassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type TimelinePassThrough<I = unknown> = PassThrough<I, TimelinePassThroughOptions<I>>;
+/**
+ * Custom item template context.
+ * @template T Type of item.
+ * @group Interface
+ */
+interface TimelineItemTemplateContext<T = any> {
+    /**
+     * Item instance.
+     */
+    $implicit: T;
+}
+/**
+ * Defines valid templates in Timeline.
+ * @group Templates
+ */
+interface TimelineTemplates<T = any> {
+    /**
+     * Custom content template.
+     * @param {TimelineItemTemplateContext} context - item data.
+     */
+    content(context: TimelineItemTemplateContext<T>): TemplateRef<TimelineItemTemplateContext<T>>;
+    /**
+     * Custom opposite item template.
+     * @param {TimelineItemTemplateContext} context - item data.
+     */
+    opposite(context: TimelineItemTemplateContext<T>): TemplateRef<TimelineItemTemplateContext<T>>;
+    /**
+     * Custom marker template.
+     * @param {TimelineItemTemplateContext} context - item data.
+     */
+    marker(context: TimelineItemTemplateContext<T>): TemplateRef<TimelineItemTemplateContext<T>>;
+}
+
+export type { TimelineAlign, TimelineItemTemplateContext, TimelineLayout, TimelinePassThrough, TimelinePassThroughOptions, TimelineTemplates };

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

@@ -0,0 +1,148 @@
+import { TemplateRef } from '@angular/core';
+import { MotionOptions } from '@primeuix/motion';
+import { ToastMessageOptions, PassThrough, PassThroughOption } from 'primenglab/api';
+
+/**
+ * Custom pass-through(pt) options for Toast.
+ * @template I Type of instance.
+ *
+ * @see {@link Toast.pt}
+ * @group Interface
+ */
+interface ToastPassThroughOptions<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 message's DOM element.
+     */
+    message?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the message content's DOM element.
+     */
+    messageContent?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the message icon's DOM element.
+     */
+    messageIcon?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass attributes to the message text's DOM element.
+     */
+    messageText?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the summary's DOM element.
+     */
+    summary?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the detail's DOM element.
+     */
+    detail?: PassThroughOption<HTMLDivElement, I>;
+    /**
+     * Used to pass attributes to the close button's DOM element.
+     */
+    closeButton?: PassThroughOption<HTMLButtonElement, I>;
+    /**
+     * Used to pass attributes to the close icon's DOM element.
+     */
+    closeIcon?: PassThroughOption<HTMLElement, I>;
+    /**
+     * Used to pass options to the motion component/directive.
+     */
+    motion?: MotionOptions;
+}
+/**
+ * Defines valid pass-through options in Toast.
+ * @see {@link ToastPassThroughOptions}
+ *
+ * @template I Type of instance.
+ */
+type ToastPassThrough<I = unknown> = PassThrough<I, ToastPassThroughOptions<I>>;
+/**
+ * Custom message template context.
+ * @group Interface
+ */
+interface ToastMessageTemplateContext {
+    /**
+     * Message instance.
+     */
+    $implicit: ToastMessageOptions | null | undefined;
+    /**
+     * Callback to close this toast.
+     */
+    closeFn: (event?: Event) => void;
+}
+/**
+ * Custom headless template context.
+ * @group Interface
+ */
+interface ToastHeadlessTemplateContext {
+    /**
+     * Message instance.
+     */
+    $implicit: ToastMessageOptions | null | undefined;
+    /**
+     * Callback to close the toast.
+     */
+    closeFn: (event: Event) => void;
+}
+/**
+ * Defines valid templates in Toast.
+ * @group Templates
+ */
+interface ToastTemplates {
+    /**
+     * Custom message template.
+     * @param {ToastMessageTemplateContext} context - message context.
+     */
+    message(context: ToastMessageTemplateContext): TemplateRef<ToastMessageTemplateContext>;
+    /**
+     * Custom headless template.
+     * @param {ToastHeadlessTemplateContext} context - headless context.
+     */
+    headless(context: ToastHeadlessTemplateContext): TemplateRef<ToastHeadlessTemplateContext>;
+}
+/**
+ * Defines the position type for Toast.
+ */
+type ToastPositionType = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' | 'center';
+/**
+ * Defines the layout mode for the Toast.
+ * - `stacked`: toasts collapse into a stack and expand on hover/focus.
+ * - `expanded`: every toast renders expanded; auto-dismiss only pauses while hovered.
+ */
+type ToastModeType = 'stacked' | 'expanded';
+/**
+ * Breakpoints configuration for responsive Toast styling.
+ * Keys are media query breakpoints (e.g., '960px', '640px').
+ * Values are CSS style objects.
+ * @group Types
+ */
+type ToastBreakpoints = Record<string, Partial<CSSStyleDeclaration>>;
+/**
+ * Custom close event.
+ * @see {@link Toast.onClose}
+ * @group Events
+ */
+interface ToastCloseEvent {
+    /**
+     * Message of the closed element.
+     */
+    message: ToastMessageOptions;
+}
+/**
+ * Custom close event.
+ * @see {@link ToastItem.onClose}
+ */
+interface ToastItemCloseEvent extends ToastCloseEvent {
+    /**
+     * Index of the closed element.
+     */
+    index: number;
+}
+
+export type { ToastBreakpoints, ToastCloseEvent, ToastHeadlessTemplateContext, ToastItemCloseEvent, ToastMessageTemplateContext, ToastModeType, ToastPassThrough, ToastPassThroughOptions, ToastPositionType, ToastTemplates };