@cdevhub/ngx-tw 0.2.0

package/types/cdevhub-ngx-tw-menu.d.ts

@@ -0,0 +1,99 @@
+import * as i0 from '@angular/core';
+import * as i1 from '@angular/cdk/menu';
+import { CdkMenuItemCheckbox, CdkMenuItemRadio } from '@angular/cdk/menu';
+import { TwSize, TwColor } from '@cdevhub/ngx-tw/core';
+
+declare class MenuComponent {
+    /** Controls item density and padding. Defaults to `'md'`. */
+    readonly size: i0.InputSignal<TwSize>;
+    /** Accessible label for the menu panel. Use when no visible heading describes the menu (e.g. a kebab-icon trigger). */
+    readonly ariaLabel: i0.InputSignal<string | undefined>;
+    /** ID of an element that labels the menu panel. Ignored when `ariaLabel` is set. */
+    readonly ariaLabelledBy: i0.InputSignal<string | undefined>;
+    readonly classes: i0.Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MenuComponent, "tw-menu", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledBy": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof i1.CdkMenu; inputs: {}; outputs: { "closed": "closed"; }; }]>;
+}
+declare class MenuTriggerDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuTriggerDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuTriggerDirective, "[twMenuTrigger]", never, {}, {}, never, never, true, [{ directive: typeof i1.CdkMenuTrigger; inputs: { "cdkMenuTriggerFor": "twMenuTrigger"; "cdkMenuPosition": "position"; "cdkMenuTriggerData": "data"; }; outputs: { "cdkMenuOpened": "opened"; "cdkMenuClosed": "closed"; }; }]>;
+}
+declare class ContextMenuTriggerDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ContextMenuTriggerDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ContextMenuTriggerDirective, "[twContextMenuTrigger]", never, {}, {}, never, never, true, [{ directive: typeof i1.CdkContextMenuTrigger; inputs: { "cdkContextMenuTriggerFor": "twContextMenuTrigger"; "cdkContextMenuDisabled": "disabled"; "cdkContextMenuPosition": "position"; "cdkContextMenuTriggerData": "data"; }; outputs: { "cdkContextMenuOpened": "opened"; "cdkContextMenuClosed": "closed"; }; }]>;
+}
+declare class MenuItemDirective {
+    /**
+     * Semantic role tint applied to the item. Use `'error'` for destructive actions.
+     * Defaults to `undefined` — no role tint is applied and the item inherits the
+     * base `text-fg` styling at full prominence; `'neutral'` (the explicit muted
+     * variant) is a distinct value with `text-fg-muted` + `bg-surface-muted` hovers.
+     */
+    readonly color: i0.InputSignal<TwColor | undefined>;
+    /** Whether this item is disabled. Defaults to `false`. */
+    readonly disabled: i0.InputSignal<boolean>;
+    private readonly menu;
+    private readonly cdkItem;
+    constructor();
+    readonly classes: i0.Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuItemDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuItemDirective, "[twMenuItem]", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.CdkMenuItem; inputs: {}; outputs: { "cdkMenuItemTriggered": "triggered"; }; }]>;
+}
+declare class MenuItemCheckboxComponent {
+    /** Whether this item is disabled. Defaults to `false`. */
+    readonly disabled: i0.InputSignal<boolean>;
+    /** Fires when the item is activated, carrying the new `checked` value after CDK toggles it. */
+    readonly checkedChange: i0.OutputEmitterRef<boolean>;
+    protected readonly cdkCheckbox: CdkMenuItemCheckbox;
+    private readonly menu;
+    private readonly resolvedSize;
+    constructor();
+    readonly classes: i0.Signal<string>;
+    readonly indicatorClasses: i0.Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuItemCheckboxComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MenuItemCheckboxComponent, "[twMenuItemCheckbox]", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "checkedChange": "checkedChange"; }, never, ["*"], true, [{ directive: typeof i1.CdkMenuItemCheckbox; inputs: { "cdkMenuItemChecked": "checked"; }; outputs: { "cdkMenuItemTriggered": "triggered"; }; }]>;
+}
+declare class MenuItemRadioComponent {
+    /** Whether this item is disabled. Defaults to `false`. */
+    readonly disabled: i0.InputSignal<boolean>;
+    /** Fires when the item is activated, carrying the new `checked` value after CDK selects it. */
+    readonly checkedChange: i0.OutputEmitterRef<boolean>;
+    protected readonly cdkRadio: CdkMenuItemRadio;
+    private readonly menu;
+    private readonly resolvedSize;
+    constructor();
+    readonly classes: i0.Signal<string>;
+    readonly indicatorClasses: i0.Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuItemRadioComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MenuItemRadioComponent, "[twMenuItemRadio]", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "checkedChange": "checkedChange"; }, never, ["*"], true, [{ directive: typeof i1.CdkMenuItemRadio; inputs: { "cdkMenuItemChecked": "checked"; }; outputs: { "cdkMenuItemTriggered": "triggered"; }; }]>;
+}
+declare class MenuGroupDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuGroupDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuGroupDirective, "[twMenuGroup]", never, {}, {}, never, never, true, [{ directive: typeof i1.CdkMenuGroup; inputs: {}; outputs: {}; }]>;
+}
+/** Styles a leading icon inside a menu item. */
+declare class MenuItemIconDirective {
+    private readonly menu;
+    readonly classes: i0.Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuItemIconDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuItemIconDirective, "[twMenuItemIcon]", never, {}, {}, never, never, true, never>;
+}
+/** Styles secondary description text inside a menu item. */
+declare class MenuItemDescriptionDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuItemDescriptionDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuItemDescriptionDirective, "[twMenuItemDescription]", never, {}, {}, never, never, true, never>;
+}
+/** Right-aligns and mutes keyboard shortcut hint text. */
+declare class MenuItemShortcutDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuItemShortcutDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuItemShortcutDirective, "[twMenuItemShortcut]", never, {}, {}, never, never, true, never>;
+}
+/** Styles the trailing chevron for submenu triggers. */
+declare class MenuItemSubmenuIndicatorDirective {
+    private readonly menu;
+    readonly classes: i0.Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuItemSubmenuIndicatorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuItemSubmenuIndicatorDirective, "[twMenuItemSubmenuIcon]", never, {}, {}, never, never, true, never>;
+}
+
+export { ContextMenuTriggerDirective, MenuComponent, MenuGroupDirective, MenuItemCheckboxComponent, MenuItemDescriptionDirective, MenuItemDirective, MenuItemIconDirective, MenuItemRadioComponent, MenuItemShortcutDirective, MenuItemSubmenuIndicatorDirective, MenuTriggerDirective };

package/types/cdevhub-ngx-tw-paginator.d.ts

@@ -0,0 +1,305 @@
+import * as _angular_core from '@angular/core';
+import { TemplateRef, ElementRef } from '@angular/core';
+import { FocusableOption } from '@angular/cdk/a11y';
+import { TwSize, TwColor } from '@cdevhub/ngx-tw/core';
+
+/** Rendering type. `'basic'` shows prev/next + page info only. `'numbered'` shows page buttons with ellipsis range. */
+type TwPaginatorType = 'basic' | 'numbered';
+/** Layout density. `'compact'` stacks regions left-to-right. `'spread'` distributes regions across the full container width. */
+type TwPaginatorLayout = 'compact' | 'spread';
+/** Responsive mode. `'auto'` collapses numbered pages to basic visuals on narrow containers via CSS container queries. `'off'` disables collapsing. */
+type TwPaginatorResponsive = 'auto' | 'off';
+/** Named slot accepted by `*twPaginatorLabel`. */
+type TwPaginatorLabelSlot = 'pageInfo' | 'previous' | 'next' | 'first' | 'last' | 'pageSizeLabel';
+/** String labels used throughout the paginator. All are optional on the `labels` input — unset keys fall back to the English defaults. */
+interface TwPaginatorLabels {
+    /** Accessible name for the `<nav>` landmark. */
+    ariaLabel: string;
+    /** Label on the Previous button. */
+    previous: string;
+    /** Label on the Next button. */
+    next: string;
+    /** Label on the First-page button. */
+    first: string;
+    /** Label on the Last-page button. */
+    last: string;
+    /** Visible label before the current-page indicator. Used as `"{pageInfo} {page}{pageInfoSeparator}{totalPages}"`. */
+    pageInfo: string;
+    /** Text that joins the current page and total. */
+    pageInfoSeparator: string;
+    /** Range-style page info template. Variables: `{start}`, `{end}`, `{total}`. */
+    pageRange: string;
+    /** Visible label next to the page-size selector. */
+    pageSizeLabel: string;
+    /** `LiveAnnouncer` template used on every page change. Variables: `{page}`, `{totalPages}`, `{start}`, `{end}`, `{total}`. */
+    announcement: string;
+    /** Accessible label per numbered page button. Variable: `{page}`. */
+    pageButtonAriaLabel: string;
+    /** Accessible label for the current numbered page button. Variable: `{page}`. */
+    currentPageAriaLabel: string;
+    /** Accessible label applied to ellipsis items. */
+    ellipsis: string;
+    /** Rendered when `hideOnEmpty` is `false` and `totalItems === 0`. */
+    empty: string;
+}
+/** Emitted by `pageChange`. */
+interface TwPaginatorPageChangeEvent {
+    /** The new 1-based page. */
+    page: number;
+    /** The new items-per-page. */
+    pageSize: number;
+    /** The previous 1-based page. */
+    previousPage: number;
+    /** The previous items-per-page. */
+    previousPageSize: number;
+    /** Total number of items. */
+    totalItems: number;
+    /** Total number of pages given the current `totalItems` and `pageSize`. */
+    totalPages: number;
+    /** 1-based index of the first item on the new page (inclusive). */
+    start: number;
+    /** 1-based index of the last item on the new page (inclusive). */
+    end: number;
+    /** What triggered the change. */
+    source: 'click' | 'keyboard' | 'pageSizeChange' | 'programmatic';
+}
+/** Template context provided to every `*twPaginatorLabel` and `*twPaginatorEmpty` template. */
+interface TwPaginatorLabelContext {
+    /** 1-based current page. */
+    page: number;
+    /** Total pages. */
+    totalPages: number;
+    /** 1-based index of the first item on the current page (inclusive). */
+    start: number;
+    /** 1-based index of the last item on the current page (inclusive). */
+    end: number;
+    /** Total number of items. */
+    totalItems: number;
+    /** Current items per page. */
+    pageSize: number;
+    /** Whether the paginator is globally disabled. */
+    disabled: boolean;
+}
+/** Template context provided to `*twPaginatorPageSizeSelector`. */
+interface TwPaginatorPageSizeSelectorContext {
+    /** Current page size. */
+    pageSize: number;
+    /** Available page-size options. */
+    options: readonly number[];
+    /** Updates the page size and re-anchors the current page to keep the same first visible item. */
+    setPageSize: (size: number) => void;
+}
+type PaginationRangeItem = number | 'ellipsis-left' | 'ellipsis-right';
+type PageChangeSource = TwPaginatorPageChangeEvent['source'];
+/**
+ * Structural directive on an `<ng-template>` that replaces a specific label slot.
+ * Usage: `<ng-template twPaginatorLabel slot="pageInfo" let-ctx> … </ng-template>`.
+ */
+declare class PaginatorLabelDirective {
+    /** The label slot this template overrides. */
+    readonly slot: _angular_core.InputSignal<TwPaginatorLabelSlot>;
+    /** @internal */
+    readonly templateRef: TemplateRef<any>;
+    /** @internal */
+    static ngTemplateContextGuard(_dir: PaginatorLabelDirective, _ctx: unknown): _ctx is {
+        $implicit: TwPaginatorLabelContext;
+    };
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginatorLabelDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PaginatorLabelDirective, "ng-template[twPaginatorLabel]", never, { "slot": { "alias": "slot"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/**
+ * Structural directive on an `<ng-template>` that renders when `totalItems === 0`
+ * and `hideOnEmpty` is `false`. When absent, `labels.empty` renders as fallback.
+ */
+declare class PaginatorEmptyDirective {
+    /** @internal */
+    readonly templateRef: TemplateRef<any>;
+    /** @internal */
+    static ngTemplateContextGuard(_dir: PaginatorEmptyDirective, _ctx: unknown): _ctx is {
+        $implicit: TwPaginatorLabelContext;
+    };
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginatorEmptyDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PaginatorEmptyDirective, "ng-template[twPaginatorEmpty]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Structural directive on an `<ng-template>` that replaces the default page-size
+ * selector UI entirely. Context `$implicit` exposes `{ pageSize, options, setPageSize }`.
+ */
+declare class PaginatorPageSizeSelectorDirective {
+    /** @internal */
+    readonly templateRef: TemplateRef<any>;
+    /** @internal */
+    static ngTemplateContextGuard(_dir: PaginatorPageSizeSelectorDirective, _ctx: unknown): _ctx is {
+        $implicit: TwPaginatorPageSizeSelectorContext;
+    };
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginatorPageSizeSelectorDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PaginatorPageSizeSelectorDirective, "ng-template[twPaginatorPageSizeSelector]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * @internal Wraps every nav-group focusable (first/prev/page/next/last) as a CDK
+ * `FocusableOption` so `FocusKeyManager` can drive roving focus across the group.
+ * Applied via attribute selector on the existing `data-tw-paginator-focusable`
+ * marker so the spec's button queries continue to match.
+ */
+declare class PaginatorFocusableDirective implements FocusableOption {
+    readonly elementRef: ElementRef<any>;
+    /** When true, the element is skipped by `FocusKeyManager` roving focus. */
+    readonly isDisabled: _angular_core.InputSignal<boolean>;
+    focus(): void;
+    /**
+     * `FocusableOption.disabled` resolver. NOTE: returning the signal function
+     * itself would always be truthy, so `FocusKeyManager` would skip every
+     * element. Call the signal here so the manager sees the actual value.
+     */
+    get disabled(): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginatorFocusableDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PaginatorFocusableDirective, "[data-tw-paginator-focusable]", never, { "isDisabled": { "alias": "isDisabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+declare class PaginatorComponent {
+    /** Total number of items across all pages. Defaults to `0`. */
+    readonly totalItems: _angular_core.InputSignal<number>;
+    /** Items per page. Two-way bindable via `[(pageSize)]`. Defaults to `10`. */
+    readonly pageSize: _angular_core.ModelSignal<number>;
+    /** 1-based current page. Two-way bindable via `[(page)]`. Clamped internally. Defaults to `1`. */
+    readonly page: _angular_core.ModelSignal<number>;
+    /** Rendering type. Defaults to `'numbered'`. */
+    readonly type: _angular_core.InputSignal<TwPaginatorType>;
+    /** Layout density. Defaults to `'compact'`. */
+    readonly layout: _angular_core.InputSignal<TwPaginatorLayout>;
+    /** Controls padding, font size, and icon size. Defaults to `'md'`. */
+    readonly size: _angular_core.InputSignal<TwSize>;
+    /** Semantic color used for the active page indicator. Defaults to `'primary'`. */
+    readonly color: _angular_core.InputSignal<TwColor>;
+    /** How many sibling pages to show on each side of the current page. Defaults to `1`. */
+    readonly siblingCount: _angular_core.InputSignal<number>;
+    /** How many pages to always show at the start and end boundaries. Defaults to `1`. */
+    readonly boundaryCount: _angular_core.InputSignal<number>;
+    /** When true, renders jump-to-first and jump-to-last buttons. Defaults to `true`. */
+    readonly showFirstLastButtons: _angular_core.InputSignal<boolean>;
+    /** When true, renders the page-size selector region. Defaults to `false`. */
+    readonly showPageSizeSelector: _angular_core.InputSignal<boolean>;
+    /** Options for the default page-size selector. Ignored when `*twPaginatorPageSizeSelector` is projected. Defaults to `[10, 25, 50, 100]`. */
+    readonly pageSizeOptions: _angular_core.InputSignal<readonly number[]>;
+    /** When true, renders the page-info text region. Defaults to `true`. */
+    readonly showPageInfo: _angular_core.InputSignal<boolean>;
+    /** When true, renders nothing when `totalItems === 0`. Defaults to `true`. */
+    readonly hideOnEmpty: _angular_core.InputSignal<boolean>;
+    /** When true, renders nothing when `totalPages <= 1`. Defaults to `false`. */
+    readonly hideOnSinglePage: _angular_core.InputSignal<boolean>;
+    /** Responsive collapse mode. Defaults to `'auto'`. */
+    readonly responsive: _angular_core.InputSignal<TwPaginatorResponsive>;
+    /** When true, every button is disabled. Defaults to `false`. */
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    /** Partial string labels object for i18n. Unset keys fall back to English defaults. Defaults to `{}`. */
+    readonly labels: _angular_core.InputSignal<Partial<TwPaginatorLabels>>;
+    /** When provided, buttons render as anchor links using the returned `href`. Defaults to `undefined` (renders as buttons). */
+    readonly linkFactory: _angular_core.InputSignal<((page: number) => string) | undefined>;
+    /** Overrides `labels.ariaLabel` for the root `<nav>` element. */
+    readonly customAriaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Fires when `page` or `pageSize` changes. Payload includes derived helpers (`start`, `end`, `totalPages`, `source`). Use `[(page)]` / `[(pageSize)]` for two-way binding; subscribe to this for the rich event payload. */
+    readonly paginated: _angular_core.OutputEmitterRef<TwPaginatorPageChangeEvent>;
+    /** @internal */
+    readonly labelDirectives: _angular_core.Signal<readonly PaginatorLabelDirective[]>;
+    /** @internal */
+    readonly emptyDirective: _angular_core.Signal<PaginatorEmptyDirective | undefined>;
+    /** @internal */
+    readonly pageSizeSelectorDirective: _angular_core.Signal<PaginatorPageSizeSelectorDirective | undefined>;
+    private readonly _liveAnnouncer;
+    private readonly _elementRef;
+    /** @internal All nav-group focusables (first/prev/page/next/last) for `FocusKeyManager`. */
+    readonly focusableItems: _angular_core.Signal<readonly PaginatorFocusableDirective[]>;
+    private readonly _componentId;
+    /** @internal */
+    readonly pageSizeSelectId: string;
+    /** @internal Effective page size, coerced to at least 1. */
+    readonly effectivePageSize: _angular_core.Signal<number>;
+    /** @internal Total number of pages; always ≥ 1 to keep clamping math well-defined. */
+    readonly totalPages: _angular_core.Signal<number>;
+    /** @internal Current page clamped into `[1, totalPages]`. */
+    readonly clampedPage: _angular_core.Signal<number>;
+    /** @internal 1-based start item index on the current page. `0` when empty. */
+    readonly startItem: _angular_core.Signal<number>;
+    /** @internal 1-based end item index on the current page. `0` when empty. */
+    readonly endItem: _angular_core.Signal<number>;
+    /** @internal Visible page range for the numbered type. */
+    readonly range: _angular_core.Signal<PaginationRangeItem[]>;
+    /** @internal Merged labels. */
+    readonly resolvedLabels: _angular_core.Signal<TwPaginatorLabels>;
+    /** @internal Resolved aria-label for the root. */
+    readonly resolvedAriaLabel: _angular_core.Signal<string>;
+    /** @internal `container-name` for the CSS container query (set only when responsive="auto"). */
+    readonly containerName: _angular_core.Signal<"paginator" | null>;
+    readonly isEmpty: _angular_core.Signal<boolean>;
+    readonly isAtFirstPage: _angular_core.Signal<boolean>;
+    readonly isAtLastPage: _angular_core.Signal<boolean>;
+    /** @internal Target page for the Previous button (clamped to `[1, totalPages]`). */
+    readonly previousTarget: _angular_core.Signal<number>;
+    /** @internal Target page for the Next button (clamped to `[1, totalPages]`). */
+    readonly nextTarget: _angular_core.Signal<number>;
+    /** @internal Whether the component should render at all. */
+    readonly shouldRender: _angular_core.Signal<boolean>;
+    private readonly _variantResult;
+    readonly rootClasses: _angular_core.Signal<string>;
+    readonly innerClasses: _angular_core.Signal<string>;
+    readonly pageSizeGroupClasses: _angular_core.Signal<string>;
+    readonly pageSizeLabelClasses: _angular_core.Signal<string>;
+    readonly pageSizeSelectClasses: _angular_core.Signal<string>;
+    readonly pageInfoClasses: _angular_core.Signal<string>;
+    readonly navGroupClasses: _angular_core.Signal<string>;
+    readonly pageListClasses: _angular_core.Signal<string>;
+    readonly navButtonClasses: _angular_core.Signal<string>;
+    readonly ellipsisClasses: _angular_core.Signal<string>;
+    readonly emptyStateClasses: _angular_core.Signal<string>;
+    readonly iconClasses: _angular_core.Signal<string>;
+    /** @internal Applies active-color classes to the current page button. */
+    pageButtonClasses(active: boolean): string;
+    /** @internal */
+    labelTemplateFor(slot: TwPaginatorLabelSlot): TemplateRef<{
+        $implicit: TwPaginatorLabelContext;
+    }> | null;
+    /** @internal Template-context wrapper so projected templates receive `$implicit: TwPaginatorLabelContext`. */
+    readonly labelContext: _angular_core.Signal<{
+        $implicit: TwPaginatorLabelContext;
+    }>;
+    /** @internal */
+    readonly pageSizeContext: _angular_core.Signal<{
+        $implicit: TwPaginatorPageSizeSelectorContext;
+    }>;
+    /** @internal Default page-info string (type-aware). */
+    readonly formattedPageInfo: _angular_core.Signal<string>;
+    /** @internal ARIA label for a numbered page button. */
+    formatPageButtonLabel(page: number): string;
+    /** @internal ARIA label for the current page button. */
+    formatCurrentPageLabel(page: number): string;
+    /** @internal Returns the anchor href for a page when `linkFactory` is set and the page is navigable. */
+    hrefFor(page: number): string | null;
+    private _previousPage;
+    private _previousPageSize;
+    private _pendingSource;
+    private _initialized;
+    /** @internal */
+    private _keyManager;
+    constructor();
+    /** @internal Navigate to a specific page (click/keyboard handler). */
+    goTo(target: number, source: Exclude<PageChangeSource, 'pageSizeChange'>): void;
+    /** @internal Click handler for anchor-link mode. Suppresses navigation for disabled targets. */
+    onLinkClick(event: MouseEvent, target: number, disabled: boolean, source: Exclude<PageChangeSource, 'pageSizeChange'>): void;
+    /** @internal Handler for the default page-size `<select>`. */
+    onPageSizeSelectChange(event: Event): void;
+    private _setPageSize;
+    /**
+     * @internal Keyboard navigation inside the nav group. Delegates ArrowLeft /
+     * ArrowRight / Home / End to CDK `FocusKeyManager`. The manager skips
+     * disabled controls automatically via the `disabled` getter on
+     * `PaginatorFocusableDirective`.
+     */
+    onKeydown(event: KeyboardEvent): void;
+    private _emitChange;
+    private _announce;
+    private _runDevWarnings;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginatorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginatorComponent, "tw-paginator", ["twPaginator"], { "totalItems": { "alias": "totalItems"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "siblingCount": { "alias": "siblingCount"; "required": false; "isSignal": true; }; "boundaryCount": { "alias": "boundaryCount"; "required": false; "isSignal": true; }; "showFirstLastButtons": { "alias": "showFirstLastButtons"; "required": false; "isSignal": true; }; "showPageSizeSelector": { "alias": "showPageSizeSelector"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageInfo": { "alias": "showPageInfo"; "required": false; "isSignal": true; }; "hideOnEmpty": { "alias": "hideOnEmpty"; "required": false; "isSignal": true; }; "hideOnSinglePage": { "alias": "hideOnSinglePage"; "required": false; "isSignal": true; }; "responsive": { "alias": "responsive"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "linkFactory": { "alias": "linkFactory"; "required": false; "isSignal": true; }; "customAriaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "page": "pageChange"; "paginated": "paginated"; }, ["labelDirectives", "emptyDirective", "pageSizeSelectorDirective"], never, true, never>;
+}
+
+export { PaginatorComponent, PaginatorEmptyDirective, PaginatorLabelDirective, PaginatorPageSizeSelectorDirective };
+export type { TwPaginatorLabelContext, TwPaginatorLabelSlot, TwPaginatorLabels, TwPaginatorLayout, TwPaginatorPageChangeEvent, TwPaginatorPageSizeSelectorContext, TwPaginatorResponsive, TwPaginatorType };

package/types/cdevhub-ngx-tw-popover.d.ts

@@ -0,0 +1,157 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken, TemplateRef, Type, OnInit, OnDestroy } from '@angular/core';
+import { TwSize, TwColor } from '@cdevhub/ngx-tw/core';
+
+/** Context object provided to popover template content. */
+interface PopoverTemplateContext<T = unknown> {
+    /** The data passed via `twPopoverData` input. */
+    $implicit: T;
+    /** Closes the popover. */
+    close: () => void;
+}
+/** Reference to control the popover from inside component content. */
+interface PopoverRef {
+    /** Closes the popover. */
+    close(): void;
+    /** @internal — used by `PopoverTitleDirective` to register itself with `aria-labelledby`. */
+    _addAriaLabelledBy?: (id: string) => void;
+    /** @internal — used by `PopoverTitleDirective` to unregister itself. */
+    _removeAriaLabelledBy?: (id: string) => void;
+}
+/** Injection token providing arbitrary data to popover component content. */
+declare const POPOVER_DATA: InjectionToken<unknown>;
+/** Injection token providing a `PopoverRef` to popover component content. */
+declare const POPOVER_REF: InjectionToken<PopoverRef>;
+
+/** Placement position of the popover relative to its trigger element. */
+type PopoverPosition = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
+/** Scroll strategy for the popover overlay. */
+type PopoverScrollStrategy = 'reposition' | 'close' | 'block' | 'noop';
+/** Backdrop behavior for the popover. */
+type PopoverBackdrop = 'transparent' | 'dimmed' | 'none';
+/** Trigger interaction that opens the popover. */
+type PopoverTrigger = 'click' | 'focus' | 'manual';
+declare class PopoverDirective {
+    /** The content to render. An `ng-template` receives context with `$implicit` (data) and `close` (function). A component class receives data and a ref via injection tokens. */
+    readonly twPopover: _angular_core.InputSignal<TemplateRef<PopoverTemplateContext<unknown>> | Type<unknown>>;
+    /** Preferred placement relative to the trigger. CDK handles fallback when space is insufficient. Defaults to `'bottom'`. */
+    readonly twPopoverPosition: _angular_core.InputSignal<PopoverPosition>;
+    /** What user interaction opens the popover. `'manual'` means consumers call `open()`/`close()` programmatically. Defaults to `'click'`. */
+    readonly twPopoverTriggerOn: _angular_core.InputSignal<PopoverTrigger>;
+    /** When true, all trigger interactions are suppressed. Defaults to `false`. */
+    readonly twPopoverDisabled: _angular_core.InputSignal<boolean>;
+    /** Two-way bindable open state. Setting to `true` opens the popover; the popover sets it to `false` on close. */
+    readonly twPopoverOpen: _angular_core.ModelSignal<boolean>;
+    /** Controls panel padding using the standard spacing scale. Defaults to `'md'`. */
+    readonly twPopoverSize: _angular_core.InputSignal<TwSize>;
+    /** Pixel distance between trigger and panel edge. Defaults to `8`. */
+    readonly twPopoverOffset: _angular_core.InputSignal<number>;
+    /** Whether to render a directional arrow pointing at the trigger. Defaults to `true`. */
+    readonly twPopoverArrow: _angular_core.InputSignal<boolean>;
+    /** Backdrop behavior. `'transparent'` catches outside clicks invisibly. `'dimmed'` adds a semi-transparent overlay. `'none'` disables the backdrop. Defaults to `'transparent'`. */
+    readonly twPopoverBackdrop: _angular_core.InputSignal<PopoverBackdrop>;
+    /** Whether clicking outside the panel closes the popover. Only relevant when backdrop is `'none'`. Defaults to `true`. */
+    readonly twPopoverCloseOnOutside: _angular_core.InputSignal<boolean>;
+    /** Whether pressing Escape closes the popover. Defaults to `true`. */
+    readonly twPopoverCloseOnEscape: _angular_core.InputSignal<boolean>;
+    /** CDK scroll strategy for the overlay. Defaults to `'reposition'`. */
+    readonly twPopoverScrollStrategy: _angular_core.InputSignal<PopoverScrollStrategy>;
+    /** Whether to trap focus inside the popover panel using CDK FocusTrapFactory. Defaults to `true`. */
+    readonly twPopoverTrapFocus: _angular_core.InputSignal<boolean>;
+    /** Arbitrary data passed to template context or component via `POPOVER_DATA` token. */
+    readonly twPopoverData: _angular_core.InputSignal<unknown>;
+    /** Additional CSS classes applied to the overlay panel for consumer customization. */
+    readonly twPopoverPanelClass: _angular_core.InputSignal<string | string[]>;
+    /** Optional semantic color. When set, adds a colored top border accent to the panel. */
+    readonly twPopoverColor: _angular_core.InputSignal<TwColor | undefined>;
+    /** Explicit `aria-label` for the dialog panel. */
+    readonly twPopoverAriaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Fires after the popover becomes visible. */
+    readonly twPopoverOpened: _angular_core.OutputEmitterRef<void>;
+    /** Fires after the popover is fully removed. */
+    readonly twPopoverClosed: _angular_core.OutputEmitterRef<void>;
+    private readonly overlay;
+    private readonly elementRef;
+    private readonly viewContainerRef;
+    private readonly injector;
+    private readonly destroyRef;
+    private readonly focusTrapFactory;
+    private overlayRef;
+    private popoverInstance;
+    private focusTrap;
+    private perOpenSubs;
+    private closing;
+    private closeTimer;
+    /** Tracked focus-blur close timer; cleared on destroy so it can't fire post-teardown. */
+    private blurCloseTimer;
+    private readonly overlayId;
+    /** The overlay component's id for aria-controls binding. */
+    protected readonly overlayComponentId: _angular_core.Signal<string | null>;
+    constructor();
+    /** Programmatically open the popover. */
+    open(): void;
+    /** Programmatically close the popover. */
+    close(): void;
+    /** Toggle open/close. */
+    toggle(): void;
+    /** Force CDK to recalculate overlay position. */
+    reposition(): void;
+    protected onHostClick(): void;
+    protected onHostFocus(): void;
+    protected onHostBlur(): void;
+    protected onEscape(): void;
+    private openPopover;
+    private closePopover;
+    private currentPositionStrategy;
+    private buildPositionStrategy;
+    private ensureOverlay;
+    private updatePositionStrategy;
+    private subscribePerOpen;
+    private attachContent;
+    private setupFocusTrap;
+    private destroyFocusTrap;
+    private disposeOverlay;
+    private clearCloseTimer;
+    private resolveScrollStrategy;
+    private resolvePanelClass;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverDirective, "[twPopover]", ["twPopover"], { "twPopover": { "alias": "twPopover"; "required": true; "isSignal": true; }; "twPopoverPosition": { "alias": "twPopoverPosition"; "required": false; "isSignal": true; }; "twPopoverTriggerOn": { "alias": "twPopoverTriggerOn"; "required": false; "isSignal": true; }; "twPopoverDisabled": { "alias": "twPopoverDisabled"; "required": false; "isSignal": true; }; "twPopoverOpen": { "alias": "twPopoverOpen"; "required": false; "isSignal": true; }; "twPopoverSize": { "alias": "twPopoverSize"; "required": false; "isSignal": true; }; "twPopoverOffset": { "alias": "twPopoverOffset"; "required": false; "isSignal": true; }; "twPopoverArrow": { "alias": "twPopoverArrow"; "required": false; "isSignal": true; }; "twPopoverBackdrop": { "alias": "twPopoverBackdrop"; "required": false; "isSignal": true; }; "twPopoverCloseOnOutside": { "alias": "twPopoverCloseOnOutside"; "required": false; "isSignal": true; }; "twPopoverCloseOnEscape": { "alias": "twPopoverCloseOnEscape"; "required": false; "isSignal": true; }; "twPopoverScrollStrategy": { "alias": "twPopoverScrollStrategy"; "required": false; "isSignal": true; }; "twPopoverTrapFocus": { "alias": "twPopoverTrapFocus"; "required": false; "isSignal": true; }; "twPopoverData": { "alias": "twPopoverData"; "required": false; "isSignal": true; }; "twPopoverPanelClass": { "alias": "twPopoverPanelClass"; "required": false; "isSignal": true; }; "twPopoverColor": { "alias": "twPopoverColor"; "required": false; "isSignal": true; }; "twPopoverAriaLabel": { "alias": "twPopoverAriaLabel"; "required": false; "isSignal": true; }; }, { "twPopoverOpen": "twPopoverOpenChange"; "twPopoverOpened": "twPopoverOpened"; "twPopoverClosed": "twPopoverClosed"; }, never, never, true, never>;
+}
+
+/**
+ * Convenience directive that closes the enclosing popover when the host element is clicked.
+ * Place on any element inside popover content.
+ *
+ * ```html
+ * <button twPopoverClose>Cancel</button>
+ * ```
+ */
+declare class PopoverCloseDirective {
+    private readonly popoverRef;
+    protected closePopover(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverCloseDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverCloseDirective, "[twPopoverClose]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Popover title. Registers its ID with the enclosing popover overlay's
+ * `aria-labelledby` queue so screen readers announce it automatically.
+ *
+ * Mirrors `DialogTitleDirective` and is the recommended way to label a
+ * popover whose content has a heading. Use `twPopoverAriaLabel` when no
+ * heading is present.
+ */
+declare class PopoverTitleDirective implements OnInit, OnDestroy {
+    private readonly generatedId;
+    private readonly elementRef;
+    private readonly popoverRef;
+    /** Custom id for the title element. Defaults to a generated unique id. */
+    readonly id: _angular_core.InputSignal<string>;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverTitleDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverTitleDirective, "[twPopoverTitle], tw-popover-title", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { POPOVER_DATA, POPOVER_REF, PopoverCloseDirective, PopoverDirective, PopoverTitleDirective };
+export type { PopoverBackdrop, PopoverPosition, PopoverRef, PopoverScrollStrategy, PopoverTemplateContext, PopoverTrigger };