@malva-ui/core 0.1.12 → 0.1.14

package/types/malva-ui-core-sidebar.d.ts

@@ -0,0 +1,698 @@
+import * as _angular_core from '@angular/core';
+import { Signal, InjectionToken, TemplateRef, ElementRef } from '@angular/core';
+import * as _malva_ui_i18n from '@malva-ui/i18n';
+import { BooleanInput } from '@angular/cdk/coercion';
+import { MlvBreakpoint, MlvStructural } from '@malva-ui/cdk/utils';
+import { MlvPopupContainer, MlvPopup } from '@malva-ui/core/popup';
+import { MlvBadgeTone } from '@malva-ui/core/badge';
+
+/** MlvLayout mode controlling how the sidebar renders and collapses. */
+type MlvSidebarMode = 'icon' | 'offcanvas' | 'floating' | 'fixed';
+
+interface MlvSidebarContextValue {
+    /** Whether the sidebar is collapsed. */
+    readonly collapsed: Signal<boolean>;
+    /** Whether the current rendering context is inside a flyout popup. */
+    readonly inFlyout?: Signal<boolean>;
+    /** The layout mode requested by the author. */
+    readonly mode: Signal<MlvSidebarMode>;
+    /**
+     * The layout mode actually in effect. Equals {@link mode} unless a
+     * responsive override (`MlvSidebar.collapseBelow`) is active, in which case
+     * it reports `'offcanvas'`. Optional so externally implemented contexts stay
+     * valid — read it as `effectiveMode?.() ?? mode()`.
+     */
+    readonly effectiveMode?: Signal<MlvSidebarMode>;
+    /** Toggle between collapsed and expanded. */
+    toggle(): void;
+    /** Set the sidebar width in pixels (used by the rail during drag). */
+    setWidth(px: number): void;
+}
+declare const SIDEBAR_CONTEXT: InjectionToken<MlvSidebarContextValue>;
+
+/** Outer surface treatment of an inline Sidebar. */
+type MlvSidebarAppearance = 'raised' | 'flat';
+
+/**
+ * Marks a sticky top region inside the sidebar.
+ * Applied to a container element that should remain visible at the top when content scrolls.
+ */
+declare class MlvSidebarHeader {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarHeader, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MlvSidebarHeader, "[mlvSidebarHeader]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Marks a sticky bottom region inside the sidebar.
+ * Applied to a container element that should remain visible at the bottom when content scrolls.
+ */
+declare class MlvSidebarFooter {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarFooter, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MlvSidebarFooter, "[mlvSidebarFooter]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Marks the scrollable middle region between header and footer inside the sidebar.
+ * Gets `flex: 1 1 0` so it fills the remaining space. Intended to hold sidebar items and groups.
+ */
+declare class MlvSidebarContent {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarContent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvSidebarContent, "[mlvSidebarContent]", never, {}, {}, never, ["*"], true, never>;
+}
+
+declare class MlvSidebar implements MlvSidebarContextValue {
+    /** @protected The component's i18n strings signal. */
+    protected readonly _i18n: _angular_core.Signal<_malva_ui_i18n.MlvSidebarI18n>;
+    /**
+     * @private Signal-based viewport breakpoint service. Wraps the CDK
+     * `BreakpointObserver`, so it is SSR-safe — no direct `matchMedia` access.
+     */
+    private readonly _breakpoint;
+    private readonly _rtlService;
+    /** @private Owning document used to preserve focus when activation opens another modal. */
+    private readonly _document;
+    /**
+     * @private Collapsed value captured when the responsive override kicked in,
+     * so leaving the breakpoint restores what the author/user had before.
+     * `null` while no responsive override is active.
+     */
+    private _collapsedBeforeAutoOffcanvas;
+    /**
+     * Controls expanded vs. collapsed (icon-only) mode.
+     * Accepts truthy strings via `coerceBooleanProperty`.
+     * Two-way bindable via `[(collapsed)]`.
+     */
+    readonly collapsed: _angular_core.ModelSignal<boolean>;
+    /**
+     * Total width of the sidebar host when expanded, including border and padding.
+     * Two-way bindable — updated by `setWidth()` during rail drag.
+     */
+    readonly width: _angular_core.ModelSignal<string>;
+    /**
+     * Total width of the sidebar host when collapsed, including border and padding.
+     */
+    readonly collapsedWidth: _angular_core.InputSignal<string>;
+    /**
+     * MlvLayout mode controlling how the sidebar renders and collapses.
+     * - `'icon'` — collapses to an icon-only rail (default).
+     * - `'offcanvas'` — slides off-screen when collapsed.
+     * - `'floating'` — floats over content when expanded.
+     * - `'fixed'` — always fully expanded; collapse is a no-op.
+     */
+    readonly mode: _angular_core.InputSignal<MlvSidebarMode>;
+    /** Outer surface treatment for an inline sidebar. */
+    readonly appearance: _angular_core.InputSignal<MlvSidebarAppearance>;
+    /**
+     * Viewport breakpoint below which the sidebar automatically behaves as an
+     * `'offcanvas'` drawer, regardless of {@link mode}.
+     *
+     * `null` (the default) keeps the sidebar on {@link mode} at every width.
+     * Setting it to `'md'` makes the sidebar an overlay drawer below 768px — it
+     * closes itself on entering that range, opens from a `mlv-sidebar-trigger`,
+     * and dismisses on Escape, backdrop click, or focus leaving the drawer, like
+     * any `mode="offcanvas"` sidebar. The previous collapsed state is restored
+     * when the viewport grows back past the breakpoint.
+     *
+     * Thresholds come from `MLV_BREAKPOINT_CONFIG` (`provideMlvBreakpoints()`),
+     * so they stay in sync with the SCSS `breakpoint-*` mixins.
+     */
+    readonly collapseBelow: _angular_core.InputSignal<MlvBreakpoint | null>;
+    /**
+     * Closes an open offcanvas Sidebar when an enabled projected action is
+     * activated. Inline Sidebar modes are unaffected.
+     *
+     * Disabled by default so existing navigation keeps its authored behavior.
+     */
+    readonly closeOnActivation: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * When true, the sidebar stretches to full viewport height.
+     * Adds the `mlv-sidebar--full-height` modifier class.
+     */
+    readonly fullHeight: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Accessible name for the `navigation` landmark.
+     *
+     * Set this whenever a page renders more than one sidebar (or another
+     * `navigation` landmark) so assistive technology can tell them apart.
+     * When omitted, the localized `MLV_SIDEBAR_I18N.navigation` default is used.
+     *
+     * Note: a plain `aria-label` attribute on `<mlv-sidebar>` cannot be used for
+     * this — the host binding owns the attribute and would overwrite it.
+     */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Minimum width in pixels the sidebar may be resized to via the drag rail.
+     */
+    readonly minWidth: _angular_core.InputSignal<number>;
+    /**
+     * Maximum width in pixels the sidebar may be resized to via the drag rail.
+     */
+    readonly maxWidth: _angular_core.InputSignal<number>;
+    /**
+     * @private True when {@link collapseBelow} is set and the viewport is
+     * narrower than that breakpoint.
+     */
+    private readonly _isBelowCollapseBreakpoint;
+    /**
+     * The layout mode actually in effect.
+     *
+     * Equals {@link mode} unless {@link collapseBelow} is set and the viewport is
+     * narrower than that breakpoint, in which case it is `'offcanvas'`. Bind
+     * against this (not `mode`) when mirroring the sidebar's layout elsewhere.
+     */
+    readonly effectiveMode: _angular_core.Signal<MlvSidebarMode>;
+    /**
+     * Effective collapsed state. Always `false` in `'fixed'` mode so the sidebar
+     * never visually collapses regardless of the `collapsed` model value.
+     */
+    protected readonly _effectiveCollapsed: _angular_core.Signal<boolean>;
+    /**
+     * @protected Accessible name bound to the host `aria-label`. Prefers the
+     * author-supplied {@link ariaLabel} and falls back to the localized default.
+     */
+    protected readonly _resolvedAriaLabel: _angular_core.Signal<string>;
+    /** @protected Header slot directive reference. */
+    protected readonly _headerRef: _angular_core.Signal<MlvSidebarHeader | undefined>;
+    /** @protected Footer slot directive reference. */
+    protected readonly _footerRef: _angular_core.Signal<MlvSidebarFooter | undefined>;
+    /** @protected Content slot directive reference. */
+    protected readonly _contentRef: _angular_core.Signal<MlvSidebarContent | undefined>;
+    /** @protected True when at least one slot directive is projected. */
+    protected readonly _hasSlots: _angular_core.Signal<boolean>;
+    /** @protected Whether the current drawer leave was requested by projected activation. */
+    protected readonly _activationClosePending: _angular_core.WritableSignal<boolean>;
+    constructor();
+    /**
+     * Toggles the sidebar between collapsed and expanded.
+     * This is a no-op when the effective mode is `'fixed'`.
+     */
+    toggle(): void;
+    /** Set the sidebar width in pixels. Clamps to the [minWidth, maxWidth] range. */
+    setWidth(px: number): void;
+    /** @protected Syncs drawer open/close back to collapsed model. */
+    protected _onDrawerOpenedChange(opened: boolean): void;
+    /**
+     * @protected Closes only an open offcanvas Sidebar after a real enabled
+     * projected action. Search fields and non-interactive layout do not dismiss.
+     */
+    protected _onContainerClick(event: MouseEvent): void;
+    /** @private Finds a modal that an activation opened above the closing Drawer. */
+    private _findOpenModal;
+    /**
+     * @protected Lets a newly opened modal retain focus; otherwise the Drawer
+     * restores the external Sidebar trigger that opened it.
+     */
+    protected _shouldRestoreDrawerFocus(): boolean;
+    /**
+     * @protected Clears activation-specific focus policy after Drawer disposal
+     * and keeps focus in a still-open modal if removing the projected opener
+     * caused the browser to drop focus.
+     */
+    protected _onDrawerAfterClosed(): void;
+    /**
+     * @protected Handles `ArrowDown`/`ArrowUp` keydown events on the sidebar container
+     * to move focus between focusable sidebar items and group triggers in DOM order.
+     * Wraps around at the list boundaries and skips elements inside `.cdk-overlay-container`.
+     */
+    protected onContainerKeydown(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvSidebar, "mlv-sidebar", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "collapsedWidth": { "alias": "collapsedWidth"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "collapseBelow": { "alias": "collapseBelow"; "required": false; "isSignal": true; }; "closeOnActivation": { "alias": "closeOnActivation"; "required": false; "isSignal": true; }; "fullHeight": { "alias": "fullHeight"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; "width": "widthChange"; }, ["_headerRef", "_footerRef", "_contentRef"], ["*"], true, never>;
+}
+
+declare class MlvSidebarItemIcon extends MlvStructural {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarItemIcon, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MlvSidebarItemIcon, "[mlvSidebarItemIcon]", never, {}, {}, never, never, true, never>;
+}
+
+declare class MlvSidebarItemHost {
+    /** Whether the item is the currently active navigation target. */
+    readonly active: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarItemHost, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MlvSidebarItemHost, "[mlvSidebarItem]", never, { "active": { "alias": "active"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+declare class MlvSidebarItemTitle extends MlvStructural {
+    /**
+     * Optional active state on the directive (available but not currently
+     * consumed by `MlvSidebarItem`).
+     */
+    readonly active: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarItemTitle, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MlvSidebarItemTitle, "[mlvSidebarItemTitle]", never, { "active": { "alias": "active"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class MlvSidebarItem {
+    /** @private Parent sidebar context providing collapsed/flyout state. */
+    private readonly _ctx;
+    /** @private Host element, scanned for a genuinely focusable projected control. */
+    private readonly _host;
+    /** Accessible label; used as aria-label, fallback text, and tooltip in collapsed mode. */
+    readonly label: _angular_core.InputSignal<string>;
+    /** Explicit active state; combined with router link detection in computedActive. */
+    readonly active: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Optional badge/count shown on this item. Rendered as a trailing
+     * `mlv-badge` when the sidebar is expanded, and as a `mlv-status-indicator`
+     * dot (top-right of the icon) when the sidebar is collapsed — where a full
+     * badge does not fit the icon rail. `null`/`''` renders nothing.
+     *
+     * This is the sanctioned way to attach a badge; it composes with a projected
+     * `[mlvSidebarItemTitle]` (the badge renders after the custom title).
+     */
+    readonly badge: _angular_core.InputSignal<string | number | null>;
+    /** Semantic tone applied to both the expanded badge and the collapsed status dot. */
+    readonly badgeTone: _angular_core.InputSignal<MlvBadgeTone>;
+    /** When true, the collapsed-mode status dot pulses to draw attention. */
+    readonly badgePulse: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    /** @private Sidebar i18n slice (used to phrase the badge count in the aria-label). */
+    private readonly _i18n;
+    /** @private ICU resolver for the pluralised notification count. */
+    private readonly _resolver;
+    /** @protected Icon slot template projected via `[mlvSidebarItemIcon]`. */
+    protected readonly iconRef: _angular_core.Signal<MlvSidebarItemIcon | undefined>;
+    /** @protected Custom title template projected via `[mlvSidebarItemTitle]`. */
+    protected readonly titleRef: _angular_core.Signal<MlvSidebarItemTitle | undefined>;
+    /** @private Detects Angular router active state from a projected routerLinkActive directive. */
+    private readonly _routerLink;
+    /** True if active() or the nested RouterLinkActive reports active. */
+    readonly computedActive: _angular_core.Signal<boolean>;
+    /** True when the sidebar is collapsed and this item is not inside a flyout. */
+    readonly isCollapsed: _angular_core.Signal<boolean>;
+    /**
+     * @private True when the projected content contains a genuinely focusable
+     * control (an `<a href>`, `<button>`, form field, or `[tabindex="0"]`).
+     * Populated after render by scanning the host subtree — a projected
+     * `[mlvSidebarItemTitle]` that only contains text/badges does NOT count.
+     */
+    protected readonly _hasProjectedFocusable: _angular_core.WritableSignal<boolean>;
+    /**
+     * Whether the host itself is the interactive control. `true` unless the
+     * projected content already contains its own focusable control — the host
+     * then behaves as a `role="button"` (or `role="menuitem"` inside a flyout)
+     * row with `tabindex="0"` and an `aria-label`. When a focusable control IS
+     * projected (e.g. a router `<a>` link), that element is the single
+     * interactive target and the host stays a presentational wrapper, avoiding an
+     * invalid `role="listitem"` (no `role="list"` ancestor) and nested focusable
+     * controls. Detection is by actual focusable content, not by the mere
+     * presence of a title template, so text/badge-only titles stay interactive.
+     */
+    protected readonly _interactiveHost: _angular_core.Signal<boolean>;
+    /** @protected True while this item renders inside a collapsed-mode group flyout (a `role="menu"`). */
+    protected readonly _inFlyout: _angular_core.Signal<boolean>;
+    /**
+     * @protected Resolved host `role`. `null` when the host is a presentational
+     * wrapper around a projected focusable control; otherwise `menuitem` inside a
+     * flyout menu, or `button` for a standalone interactive row.
+     */
+    protected readonly _hostRole: _angular_core.Signal<"menuitem" | "button" | null>;
+    /** @protected True when a non-empty badge value is set. */
+    protected readonly _hasBadge: _angular_core.Signal<boolean>;
+    /**
+     * @protected Resolved host `aria-label`. `null` when the host is a
+     * presentational wrapper around a projected control. Otherwise the item
+     * `label()`, with the badge folded in when set (e.g. `"Inbox, 3
+     * notifications"`) — since the host `aria-label` overrides the visible badge
+     * text, this keeps the count announced in both expanded and collapsed states,
+     * and is the only carrier of the count when the collapsed dot replaces the
+     * badge.
+     */
+    protected readonly _resolvedAriaLabel: _angular_core.Signal<string | null>;
+    /** @private Router link active state tracked via afterRenderEffect. */
+    private readonly _routerLinkActive;
+    /** @private Reference to the tooltip container for programmatic open/close. */
+    protected readonly _tooltipContainer: _angular_core.Signal<MlvPopupContainer | undefined>;
+    /** @private Registered for automatic cleanup of the routerLinkActive subscription. */
+    private readonly _destroyRef;
+    constructor();
+    /**
+     * @private Phrases a badge value for the accessible name. A pure numeric
+     * value is pluralised via the `notifications` ICU key (e.g. `"3
+     * notifications"`); any other value is announced verbatim (e.g. `"New"`).
+     */
+    private _announceBadge;
+    /** @protected Activates the host on Enter/Space when it is the interactive control. */
+    protected _onKeyActivate(event: Event): void;
+    /** @protected Opens the collapsed-mode tooltip on hover/focus. */
+    protected _onMouseEnter(): void;
+    /** @protected Closes the collapsed-mode tooltip on mouse-leave/blur. */
+    protected _onMouseLeave(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarItem, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvSidebarItem, "mlv-sidebar-item", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "badgeTone": { "alias": "badgeTone"; "required": false; "isSignal": true; }; "badgePulse": { "alias": "badgePulse"; "required": false; "isSignal": true; }; }, {}, ["iconRef", "titleRef", "_routerLink"], never, true, never>;
+}
+
+declare class MlvSidebarGroup {
+    /** @private Parent sidebar context (skipSelf) used to read collapsed/mode state and proxy toggles. */
+    private readonly _parentCtx;
+    /** @private Document handle used to resolve the overlay-rendered flyout panel by id. */
+    private readonly _document;
+    private readonly _rtlService;
+    /** @protected Stable id linking the collapsed-mode flyout panel so its focusable items can be resolved. */
+    protected readonly _flyoutId: string;
+    /** Required label for the group header and flyout title. */
+    readonly label: _angular_core.InputSignal<string>;
+    /**
+     * Optional badge/count for the group. Rendered as a trailing `mlv-badge` in
+     * the expanded accordion header and next to the flyout title, and as a
+     * `mlv-status-indicator` dot (top-right of the icon button) when the sidebar
+     * is collapsed. `null`/`''` renders nothing.
+     */
+    readonly badge: _angular_core.InputSignal<string | number | null>;
+    /** Semantic tone applied to the group badge and the collapsed status dot. */
+    readonly badgeTone: _angular_core.InputSignal<MlvBadgeTone>;
+    /** When true, the collapsed-mode status dot pulses to draw attention. */
+    readonly badgePulse: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
+    /** @private Sidebar i18n slice (used to phrase the badge count in the aria-label). */
+    private readonly _i18n;
+    /** @private ICU resolver for the pluralised notification count. */
+    private readonly _resolver;
+    /** @protected True when a non-empty badge value is set. */
+    protected readonly _hasBadge: _angular_core.Signal<boolean>;
+    /**
+     * @protected Collapsed icon-button `aria-label`: the group `label()` with the
+     * badge count folded in (e.g. `"Projects, 3 notifications"`), since the
+     * collapsed dot is decorative and carries no text.
+     */
+    protected readonly _resolvedAriaLabel: _angular_core.Signal<string>;
+    /** @protected Projected group icon template, rendered in the header and flyout. */
+    protected readonly iconRef: _angular_core.Signal<MlvSidebarItemIcon | undefined>;
+    /** @protected Projected sidebar items, used to derive the active-child highlight. */
+    protected readonly _childItems: _angular_core.Signal<readonly MlvSidebarItem[]>;
+    /** @protected Template of the group's child items, rendered in the accordion and flyout. */
+    protected readonly childrenTpl: _angular_core.Signal<TemplateRef<unknown>>;
+    /** @protected Icon trigger button element, used as the flyout/tooltip anchor and focus target. */
+    protected readonly _triggerBtn: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
+    /** @protected Reference to the flyout popup container (collapsed mode). */
+    protected readonly _flyoutContainer: _angular_core.Signal<MlvPopupContainer | undefined>;
+    /** @protected Reference to the flyout popup component for state reading. */
+    protected readonly _flyoutPopup: _angular_core.Signal<MlvPopup | undefined>;
+    /** @protected Tooltip popup shown on hover in collapsed mode. */
+    protected readonly _tooltipContainer: _angular_core.Signal<MlvPopupContainer | undefined>;
+    /** Whether the accordion is expanded (expanded sidebar mode). */
+    readonly expanded: _angular_core.WritableSignal<boolean>;
+    /**
+     * Whether the flyout popup is currently open.
+     * Derived from the popup component's `opened` signal.
+     */
+    readonly flyoutOpen: _angular_core.Signal<boolean>;
+    /** True when the parent sidebar is in collapsed (icon-only) mode. */
+    readonly isSidebarCollapsed: _angular_core.Signal<boolean>;
+    /** True when at least one child item is active — drives active highlight on the group. */
+    readonly hasActiveChild: _angular_core.Signal<boolean>;
+    /**
+     * @protected Effective open state of the accordion panel.
+     *
+     * `expanded` is public and writable, so a host that auto-expands the group
+     * owning the active route can set it while the sidebar is collapsed. The
+     * accordion stays mounted in that state (its header fades but keeps the icon
+     * column in place), so honouring the write would open an empty panel inside
+     * the icon rail — a ghost tree line and reserved height — and, because
+     * `#childrenRef` can only be projected once, it would also pull the children
+     * out of the open flyout and leave it showing just its header. Gating on the
+     * collapsed state here makes that unreachable regardless of write order; the
+     * constructor effect still resets `expanded` when collapse begins.
+     */
+    protected readonly _accordionOpen: _angular_core.Signal<boolean>;
+    constructor();
+    /**
+     * @private Phrases a badge value for the accessible name. A pure numeric
+     * value is pluralised via the `notifications` ICU key (e.g. `"3
+     * notifications"`); any other value is announced verbatim (e.g. `"New"`).
+     */
+    private _announceBadge;
+    /** Toggles the accordion open/closed state. */
+    toggle(): void;
+    /** @protected Roving keyboard navigation (Arrow/Home/End/Escape) within the open flyout panel. */
+    protected onFlyoutKeydown(event: Event): void;
+    /**
+     * @protected Handles Enter/Space (toggle) and ArrowRight (open) on the
+     * collapsed-mode icon trigger. When the flyout is already open, ArrowDown
+     * enters it (focuses the first item) instead of bubbling to the sidebar
+     * container's roving nav — so an open flyout is never skipped past.
+     */
+    protected onTriggerKeydown(event: Event): void;
+    /**
+     * @protected Closes the flyout and returns focus to the icon trigger when a
+     * child item inside it is activated.
+     *
+     * The menu-button pattern expects the menu to close once a command is
+     * chosen — without this a `routerLink` navigation left the flyout hanging
+     * over the new page. Enter/Space are covered too: `MlvSidebarItem` activates
+     * a button-style row by calling `.click()` on its host, and a projected
+     * anchor dispatches a real click, so both reach this bubbling handler.
+     *
+     * Clicks on the flyout header or on empty panel space are ignored — only a
+     * target inside a `.mlv-sidebar-item` (its host, projected link or button)
+     * counts as an activation.
+     */
+    protected onFlyoutClick(event: Event): void;
+    /**
+     * @protected Closes the flyout when keyboard focus leaves it entirely (Tab
+     * out, or focus moving to another trigger) so it is never left orphaned-open.
+     * Focus moves between items inside the panel, or back to the owning trigger,
+     * are ignored.
+     */
+    protected onFlyoutFocusOut(event: Event): void;
+    /** @private Moves focus to the first focusable item inside the open flyout panel. */
+    private _focusFirstFlyoutItem;
+    /** Opens the tooltip when hovering the icon button (collapsed mode, flyout not open). */
+    protected onIconBtnMouseEnter(): void;
+    /** Closes the tooltip when the pointer leaves the icon button. */
+    protected onIconBtnMouseLeave(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarGroup, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvSidebarGroup, "mlv-sidebar-group", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "badgeTone": { "alias": "badgeTone"; "required": false; "isSignal": true; }; "badgePulse": { "alias": "badgePulse"; "required": false; "isSignal": true; }; }, {}, ["iconRef", "_childItems"], ["*"], true, never>;
+}
+
+declare class MlvSidebarRail {
+    /** Minimum sidebar width in px during drag. */
+    readonly minWidth: _angular_core.InputSignal<number>;
+    /** Maximum sidebar width in px during drag. */
+    readonly maxWidth: _angular_core.InputSignal<number>;
+    /** Width below which the sidebar snaps to collapsed. */
+    readonly snapThreshold: _angular_core.InputSignal<number>;
+    /** @private Sidebar context for reading/writing state. */
+    private readonly _context;
+    /** @private Reference to the host element. */
+    private readonly _elementRef;
+    /** @private Angular zone for running outside zone during drag. */
+    private readonly _ngZone;
+    /** @private Destroy reference for cleanup. */
+    private readonly _destroyRef;
+    /** @private Normalizes horizontal resize arrows for RTL layouts. */
+    private readonly _rtlService;
+    /** @protected Whether a drag is in progress. */
+    protected readonly _isDragging: _angular_core.WritableSignal<boolean>;
+    /** @protected Current sidebar width in pixels (for ARIA). */
+    protected readonly _currentWidthPx: _angular_core.WritableSignal<number>;
+    /** @private Sidebar container element reference, resolved on first drag. */
+    private _sidebarEl;
+    /** @private Stored transition value to restore after drag. */
+    private _savedTransition;
+    /** @private Bound pointermove handler for cleanup. */
+    private readonly _onPointerMoveBound;
+    /** @private Bound pointerup handler for cleanup. */
+    private readonly _onPointerUpBound;
+    /** @private Animation frame ID for drag throttle. */
+    private _rafId;
+    /** @private Whether to snap to collapsed on pointerup. */
+    private _shouldSnap;
+    /** @private Whether to expand from collapsed on pointerup. */
+    private _shouldExpand;
+    /** @private Width to apply after expanding from collapsed state. */
+    private _expandWidth;
+    constructor();
+    /** @protected Handle double-click to toggle collapsed state. */
+    protected _onDoubleClick(): void;
+    /** @protected Handle keyboard navigation. */
+    protected _onKeydown(event: KeyboardEvent): void;
+    /** @protected Handle pointer down to start drag. */
+    protected _onPointerDown(event: PointerEvent): void;
+    /** @private Handle pointer move during drag. */
+    private _onPointerMove;
+    /** @private Handle pointer up to end drag. */
+    private _onPointerUp;
+    /** @private Remove document listeners and reset drag state. */
+    private _cleanup;
+    /** @private Adjust width by a delta, clamping to min/max. */
+    private _adjustWidth;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarRail, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvSidebarRail, "mlv-sidebar-rail", never, { "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "snapThreshold": { "alias": "snapThreshold"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Sidebar trigger button that toggles the sidebar's collapsed state.
+ * Renders as a transparent icon button visually matching collapsed sidebar
+ * items, so it sits flush with the rest of the sidebar chrome.
+ * Automatically hides itself in fixed mode.
+ *
+ * When the sidebar's effective mode is `'offcanvas'` (either `mode="offcanvas"`
+ * or a `collapseBelow` breakpoint override) the trigger renders as a
+ * hamburger/close menu button instead of the rail collapse chevrons.
+ *
+ * Usage:
+ * ```html
+ * <mlv-sidebar [collapsed]="collapsed()">
+ *   <mlv-sidebar-trigger />
+ * </mlv-sidebar>
+ * ```
+ *
+ * An offcanvas sidebar does not render its projected content while closed, so
+ * a trigger that must reopen the drawer has to live outside `<mlv-sidebar>`.
+ * Point it at the sidebar with the `sidebar` input:
+ *
+ * ```html
+ * <mlv-sidebar #nav collapseBelow="md">…</mlv-sidebar>
+ * <mlv-sidebar-trigger [sidebar]="nav" />
+ * ```
+ */
+declare class MlvSidebarTrigger {
+    /** @private Native button query backing the public focus target. */
+    private readonly _triggerButton;
+    /**
+     * The sidebar this trigger controls, for triggers rendered outside
+     * `<mlv-sidebar>`. Pass the sidebar's template reference
+     * (`<mlv-sidebar #nav />` → `[sidebar]="nav"`). Required whenever the sidebar
+     * can be an offcanvas drawer, because a closed drawer does not render its
+     * projected content — an inner trigger would disappear with it.
+     *
+     * When omitted, the trigger uses the `SIDEBAR_CONTEXT` of its ancestor
+     * sidebar.
+     */
+    readonly sidebar: _angular_core.InputSignal<MlvSidebarContextValue | undefined>;
+    /**
+     * The connected native button rendered by this trigger, or `null` before
+     * its view exists. Pass this to an overlay's explicit focus-restoration
+     * option when the activating control can disappear with an offcanvas view.
+     */
+    readonly focusTarget: _angular_core.Signal<HTMLButtonElement | null>;
+    /** @protected Localised labels for the sidebar trigger. */
+    protected readonly _i18n: _angular_core.Signal<_malva_ui_i18n.MlvSidebarI18n>;
+    /** @private Ancestor sidebar context, when this trigger is nested in one. */
+    private readonly _injectedContext;
+    /**
+     * @private The context actually driven by this trigger — the explicit
+     * `sidebar` input wins over the injected ancestor context.
+     */
+    private readonly _context;
+    /** @protected Whether the sidebar is collapsed (drawer closed in offcanvas). */
+    protected readonly _collapsed: _angular_core.Signal<boolean>;
+    /** @private The sidebar's effective layout mode, responsive override included. */
+    private readonly _mode;
+    /**
+     * @protected True when the sidebar currently behaves as an overlay drawer, so
+     * the trigger renders as a menu button rather than a rail collapse toggle.
+     */
+    protected readonly _isDrawerTrigger: _angular_core.Signal<boolean>;
+    /**
+     * The connected native trigger button while its sidebar currently behaves
+     * as an offcanvas drawer; otherwise `null`. Use this as an explicit overlay
+     * focus fallback when a projected activator can disappear with the drawer,
+     * while retaining the overlay's default opener restoration in inline modes.
+     */
+    offcanvasFocusTarget(): HTMLButtonElement | null;
+    /**
+     * Late-bound overlay focus policy. Pass the function itself to a dynamic
+     * restore-focus option: it resolves to the connected external trigger in
+     * offcanvas mode and to the overlay's captured-opener default otherwise.
+     */
+    readonly restoreFocusResolver: () => true | HTMLButtonElement;
+    /** @protected Whether the trigger should be hidden (fixed mode). */
+    protected readonly _isHidden: _angular_core.Signal<boolean>;
+    /** @protected Accessible name matching the current affordance and state. */
+    protected readonly _resolvedAriaLabel: _angular_core.Signal<string>;
+    /** @protected Toggle the sidebar collapsed state. */
+    protected _toggle(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarTrigger, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvSidebarTrigger, "mlv-sidebar-trigger", never, { "sidebar": { "alias": "sidebar"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Workspace data understood by `mlv-sidebar-workspace`.
+ * Consumers may structurally extend this interface with application-specific
+ * fields; `label` remains the accessible name used by the switcher.
+ */
+interface MlvSidebarWorkspaceOption {
+    /** Stable identifier used to track and compare workspaces. */
+    readonly id: string;
+    /** Human-readable and accessible workspace name. */
+    readonly label: string;
+    /** Optional secondary line rendered by the default text template. */
+    readonly description?: string;
+}
+/** Context supplied to workspace logo and text structural templates. */
+interface MlvSidebarWorkspaceTemplateContext {
+    /** Workspace being rendered; available through `let-workspace`. */
+    readonly $implicit: MlvSidebarWorkspaceOption;
+    /** Whether this workspace is currently active. */
+    readonly selected: boolean;
+}
+
+declare class MlvSidebarWorkspaceLogo {
+    /** Template rendered in both the active trigger and every workspace option. */
+    readonly templateRef: TemplateRef<any>;
+    /** Enables strongly typed `let-workspace` and `let-selected="selected"`. */
+    static ngTemplateContextGuard(_directive: MlvSidebarWorkspaceLogo, _context: unknown): _context is MlvSidebarWorkspaceTemplateContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarWorkspaceLogo, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MlvSidebarWorkspaceLogo, "[mlvSidebarWorkspaceLogo]", never, {}, {}, never, never, true, never>;
+}
+declare class MlvSidebarWorkspaceText {
+    /** Template rendered in both the active trigger and every workspace option. */
+    readonly templateRef: TemplateRef<any>;
+    /** Enables strongly typed `let-workspace` and `let-selected="selected"`. */
+    static ngTemplateContextGuard(_directive: MlvSidebarWorkspaceText, _context: unknown): _context is MlvSidebarWorkspaceTemplateContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarWorkspaceText, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MlvSidebarWorkspaceText, "[mlvSidebarWorkspaceText]", never, {}, {}, never, never, true, never>;
+}
+
+declare class MlvSidebarWorkspace {
+    /** @private Parent sidebar context supplying the effective collapsed state. */
+    private readonly _sidebarContext;
+    /** @protected Localized strings for the workspace switcher. */
+    protected readonly _i18n: _angular_core.Signal<_malva_ui_i18n.MlvSidebarI18n>;
+    /** @private ICU message resolver used by the trigger's accessible name. */
+    private readonly _i18nResolver;
+    /**
+     * Workspaces available to the user. A switcher menu is rendered only when
+     * the collection contains more than one workspace.
+     */
+    readonly workspaces: _angular_core.InputSignal<readonly MlvSidebarWorkspaceOption[]>;
+    /**
+     * Currently active workspace. Two-way bind with `[(workspace)]` to receive
+     * user selections made in the workspace menu.
+     */
+    readonly workspace: _angular_core.ModelSignal<MlvSidebarWorkspaceOption>;
+    /** @protected Optional structural template for workspace logos. */
+    protected readonly _logoTemplate: _angular_core.Signal<MlvSidebarWorkspaceLogo | undefined>;
+    /** @protected Optional structural template for workspace text. */
+    protected readonly _textTemplate: _angular_core.Signal<MlvSidebarWorkspaceText | undefined>;
+    /** @protected Whether the switcher menu is currently open. */
+    protected readonly _opened: _angular_core.WritableSignal<boolean>;
+    /** @protected True when choosing between multiple workspaces is possible. */
+    protected readonly _hasMultiple: _angular_core.Signal<boolean>;
+    /**
+     * @protected Whether the parent sidebar is collapsed. Workspace switchers
+     * outside a sidebar remain expanded.
+     */
+    protected readonly _isCollapsed: _angular_core.Signal<boolean>;
+    /**
+     * @protected Accessible trigger name including the current workspace.
+     */
+    protected readonly _triggerAriaLabel: _angular_core.Signal<string>;
+    /**
+     * @protected Selects a workspace from the menu. The menu item directive
+     * closes the overlay and restores focus to the trigger after this handler.
+     */
+    protected _selectWorkspace(workspace: MlvSidebarWorkspaceOption): void;
+    /** @protected Tracks whether an option represents the active workspace. */
+    protected _isSelected(workspace: MlvSidebarWorkspaceOption): boolean;
+    /**
+     * @protected Builds the strongly typed context supplied to the logo and text
+     * structural templates.
+     */
+    protected _templateContext(workspace: MlvSidebarWorkspaceOption): MlvSidebarWorkspaceTemplateContext;
+    /** @protected Produces a compact fallback monogram when no logo is supplied. */
+    protected _initials(label: string): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MlvSidebarWorkspace, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MlvSidebarWorkspace, "mlv-sidebar-workspace", never, { "workspaces": { "alias": "workspaces"; "required": true; "isSignal": true; }; "workspace": { "alias": "workspace"; "required": true; "isSignal": true; }; }, { "workspace": "workspaceChange"; }, ["_logoTemplate", "_textTemplate"], never, true, never>;
+}
+
+export { MlvSidebar, MlvSidebarContent, MlvSidebarFooter, MlvSidebarGroup, MlvSidebarHeader, MlvSidebarItem, MlvSidebarItemHost, MlvSidebarItemIcon, MlvSidebarItemTitle, MlvSidebarRail, MlvSidebarTrigger, MlvSidebarWorkspace, MlvSidebarWorkspaceLogo, MlvSidebarWorkspaceText, SIDEBAR_CONTEXT, MlvSidebarContent as SidebarContentDirective };
+export type { MlvSidebarAppearance, MlvSidebarContextValue, MlvSidebarMode, MlvSidebarWorkspaceOption, MlvSidebarWorkspaceTemplateContext };