@malva-ui/core 0.1.12

package/page/lib/page/page.d.ts

@@ -0,0 +1,74 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import type { MlvPageScrollState } from './page-scroll.token';
+import * as i0 from "@angular/core";
+/** Controls which element owns vertical page scrolling. */
+export type MlvPageScroll = 'auto' | 'none';
+/** Controls the inset around projected page content. */
+export type MlvPagePadding = 'none' | 's' | 'm' | 'l';
+/** Controls whether the page uses the anchored application-canvas treatment. */
+export type MlvPageSurface = 'anchored' | 'flat';
+/**
+ * Main page surface and scroll owner. Apply it to the page's native `<main>`
+ * landmark and compose headers, content grids, and feature components inside.
+ *
+ * Provides `MLV_PAGE_SCROLL` so descendants such as `mlv-page-header` and
+ * `mlv-page-summary` can react to the page's scroll position, and
+ * `MlvPageSnapController`, whose scroll-scrubbed progress it publishes as the
+ * `--mlv-page-snap` custom property (0 expanded .. 1 snapped) for descendants
+ * to interpolate their snap state from.
+ */
+export declare class MlvPage implements MlvPageScrollState {
+    /** Unique landmark id; set explicitly when targeting the page from a skip link. */
+    readonly id: import("@angular/core").InputSignal<string>;
+    /** Selects whether the page or a consumer-owned region handles scrolling. */
+    readonly scroll: import("@angular/core").InputSignal<MlvPageScroll>;
+    /** Optional maximum width for the centred inner page canvas. */
+    readonly maxWidth: import("@angular/core").InputSignal<string | null>;
+    /** Selects the responsive inset applied around projected page content. */
+    readonly padding: import("@angular/core").InputSignal<MlvPagePadding>;
+    /** Selects the anchored rounded canvas or a completely flat surface. */
+    readonly surface: import("@angular/core").InputSignal<MlvPageSurface>;
+    /** Makes projected page headers sticky within this page's scroll container. */
+    readonly stickyHeader: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Scroll distance in pixels mapped onto the full snap timeline: scrolling
+     * this far takes the top chrome from fully expanded to fully snapped.
+     */
+    readonly snapRange: import("@angular/core").InputSignal<number>;
+    /** Current vertical scroll offset of the page scroll owner, in pixels. */
+    get scrollTop(): MlvPageScrollState['scrollTop'];
+    /** True once the page has scrolled past a small hysteresis threshold. */
+    get scrolled(): MlvPageScrollState['scrolled'];
+    /** @private Writable source behind the public `scrollTop` signal. */
+    private readonly _scrollTop;
+    /** @private Writable source behind the public `scrolled` signal. */
+    private readonly _scrolled;
+    /** @private The page-owned scrollbar whose viewport is observed. */
+    private readonly _scrollbar;
+    /** @private Zone reference; the scroll listener runs outside the zone. */
+    private readonly _ngZone;
+    /** @private Cleans up the native scroll listener. */
+    private readonly _destroyRef;
+    /** @private Snap state provided to descendants and scrubbed from scroll. */
+    private readonly _snap;
+    /** @private Host element carrying the published snap custom property. */
+    private readonly _elementRef;
+    constructor();
+    /** @private Direct chrome children whose snapping height is compensated. */
+    private _snapChrome;
+    /** @private Expanded (progress 0) chrome height, the compensation baseline. */
+    private _snapExpandedHeight;
+    /**
+     * @private Snapping shrinks in-flow chrome (the header with its projected
+     * summary row), which would shift the content and the scroll height while
+     * the user is still scrolling — a feedback loop that reads as mid-scroll
+     * jumping. The removed height is re-added as a spacer after the chrome
+     * (`--mlv-page-snap-offset`), keeping the document geometry stable so
+     * content tracks the scroll 1:1. The controller's `spacerScale` scales the
+     * spacer away while the chrome is manually pinned collapsed — a frozen
+     * chrome never changes height mid-scroll, so the spacer is pure dead space.
+     */
+    private _measureSnapOffset;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPage, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvPage, "main[mlvPage]", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "scroll": { "alias": "scroll"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; "surface": { "alias": "surface"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "snapRange": { "alias": "snapRange"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}

package/page/lib/page-content/page-aside.d.ts

@@ -0,0 +1,7 @@
+import { MlvStructural } from '@malva-ui/cdk/utils';
+import * as i0 from "@angular/core";
+/** Marks content rendered in the complementary page-aside landmark. */
+export declare class MlvPageAside extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageAside, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageAside, "[mlvPageAside]", never, {}, {}, never, never, true, never>;
+}

package/page/lib/page-content/page-content.d.ts

@@ -0,0 +1,37 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import { MlvPageAside } from './page-aside';
+import * as i0 from "@angular/core";
+/** Placement of the complementary page column. */
+export type MlvPageAsidePlacement = 'start' | 'end';
+/** Spacing between the main page column and its complementary aside. */
+export type MlvPageContentGap = 's' | 'm' | 'l';
+/** Responsive main-content and complementary-aside grid. */
+export declare class MlvPageContent {
+    /** Places the complementary column before or after the main content. */
+    readonly asidePlacement: import("@angular/core").InputSignal<MlvPageAsidePlacement>;
+    /** Preferred width of the complementary column while rendered inline. */
+    readonly asideWidth: import("@angular/core").InputSignal<string>;
+    /** Keeps the complementary column visible while the page scrolls. */
+    readonly asideSticky: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Selects the spacing between the main and complementary columns. */
+    readonly gap: import("@angular/core").InputSignal<MlvPageContentGap>;
+    /** Container width in CSS pixels below which the columns stack. */
+    readonly stackBelow: import("@angular/core").InputSignal<number>;
+    /** Accessible name for the complementary `<aside>` landmark. */
+    readonly asideLabel: import("@angular/core").InputSignal<string>;
+    /** @protected Optional complementary content projected via `[mlvPageAside]`. */
+    protected readonly _asideRef: import("@angular/core").Signal<MlvPageAside | undefined>;
+    /** @private Host element observed so responsiveness follows available content width. */
+    private readonly _elementRef;
+    /** @private Shared observer used to measure the page-content container. */
+    private readonly _resizeObserver;
+    /** @private Destroy scope for the resize-observer subscription. */
+    private readonly _destroyRef;
+    /** @private Latest measured inline size in CSS pixels. */
+    private readonly _containerWidth;
+    /** @protected Whether the current container is narrower than `stackBelow`. */
+    protected readonly _stacked: import("@angular/core").Signal<boolean>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageContent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvPageContent, "mlv-page-content", never, { "asidePlacement": { "alias": "asidePlacement"; "required": false; "isSignal": true; }; "asideWidth": { "alias": "asideWidth"; "required": false; "isSignal": true; }; "asideSticky": { "alias": "asideSticky"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "stackBelow": { "alias": "stackBelow"; "required": false; "isSignal": true; }; "asideLabel": { "alias": "asideLabel"; "required": false; "isSignal": true; }; }, {}, ["_asideRef"], ["*"], true, never>;
+}

package/page/lib/page-dock/page-dock.d.ts

@@ -0,0 +1,50 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import * as i0 from "@angular/core";
+/** Visual treatment of the dock surface. */
+export type MlvPageDockAppearance = 'bar' | 'floating';
+/**
+ * Bottom action bar for workflow pages. Projects content marked with
+ * `[mlvPageDockStart]`, `[mlvPageDockCenter]`, and `[mlvPageDockEnd]` into a
+ * three-region row and, by default, sticks to the bottom edge of the owning
+ * page's scroll area. Typical composition: pending-change status at the
+ * start, a floating tool cluster in the center, and discard/schedule/save/
+ * publish actions at the end.
+ *
+ * `appearance="floating"` drops the dock's own glass surface — whatever floats
+ * inside it, e.g. a pill action bar, brings its own — and replaces it with the
+ * `mlvFloatingContainer` recipe from `@malva-ui/cdk/floating-container`: a
+ * gradient-masked backdrop plus safe-area block-end padding, so content fades
+ * out beneath the actions instead of scrolling straight into them. Override
+ * the backdrop fill with `--mlv-page-dock-backdrop` (defaults to
+ * `--mlv-background-base`).
+ *
+ * The dock derives its full-bleed margins from the inherited
+ * `--mlv-page-inset`, so the geometry survives a wrapper element (a `<form>`,
+ * a `<section>`) between the page canvas and the dock, and collapses to zero
+ * outside a page.
+ *
+ * While `sticky`, the dock publishes its measured height as
+ * `--mlv-page-dock-height` on `document.documentElement`; bottom-anchored
+ * toasts offset themselves by it so they are never covered by the dock.
+ */
+export declare class MlvPageDock {
+    /** Keeps the dock attached to the bottom edge of the page scroll area. */
+    readonly sticky: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Solid bar with a top border, or a floating gradient-masked backdrop. */
+    readonly appearance: import("@angular/core").InputSignal<MlvPageDockAppearance>;
+    /** @private Host element whose border-box height is published. */
+    private readonly _host;
+    /** @private Shared resize observation used to track the dock's height. */
+    private readonly _resizeObserver;
+    /** @private Withdraws this dock's height contribution on teardown. */
+    private readonly _destroyRef;
+    /**
+     * @private Latest measured border-box height of the dock, in pixels. Only
+     * written in a browser — during server rendering it stays at 0 and nothing
+     * is published.
+     */
+    private readonly _measuredHeight;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageDock, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvPageDock, "mlv-page-dock", never, { "sticky": { "alias": "sticky"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; }, {}, never, ["[mlvPageDockStart]", "[mlvPageDockCenter]", "[mlvPageDockEnd]"], true, never>;
+}

package/page/lib/page-dock/page-dock.slots.d.ts

@@ -0,0 +1,16 @@
+import * as i0 from "@angular/core";
+/** Marks leading dock content, typically pending-change status text. */
+export declare class MlvPageDockStart {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageDockStart, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageDockStart, "[mlvPageDockStart]", never, {}, {}, never, never, true, never>;
+}
+/** Marks the centered dock content, typically a floating tool cluster. */
+export declare class MlvPageDockCenter {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageDockCenter, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageDockCenter, "[mlvPageDockCenter]", never, {}, {}, never, never, true, never>;
+}
+/** Marks trailing dock content, typically the primary workflow actions. */
+export declare class MlvPageDockEnd {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageDockEnd, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageDockEnd, "[mlvPageDockEnd]", never, {}, {}, never, never, true, never>;
+}

package/page/lib/page-header/page-header.d.ts

@@ -0,0 +1,77 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import { MlvPageSnapController } from '../page/page-snap-controller';
+import { MlvPageBreadcrumb, MlvPageHeaderActions, MlvPageHeaderDescription, MlvPageHeaderIcon, MlvPageHeaderMeta, MlvPageHeaderStatus, MlvPageHeaderTabsActions, MlvPageHeaderTabs, MlvPageTitle } from './page-header.directives';
+import * as i0 from "@angular/core";
+/** Visual scale of the page header. */
+export type MlvPageHeaderSize = 'm' | 's';
+/** Horizontal alignment of the tabs row inside the page header. */
+export type MlvPageHeaderTabsAlign = 'start' | 'center';
+/**
+ * Structured page heading with optional breadcrumb, actions, status, metadata,
+ * and tabs. `size="s"` renders the compact record-editor header.
+ *
+ * Inside `main[mlvPage]` the header participates in the scroll-scrubbed snap
+ * timeline (`--mlv-page-snap`): the title interpolates down one type scale and
+ * the breadcrumb and tabs rows collapse, each over its own stagger window.
+ * With `snapControls`, chevron/pin controls float on the header's bottom edge
+ * — always visible while the header is sticky. The chevron snaps the chrome
+ * open/closed; the pin freezes the current state regardless of scrolling.
+ */
+export declare class MlvPageHeader {
+    /** Optional router destination for the built-in back link. */
+    readonly back: import("@angular/core").InputSignal<string | string[] | null>;
+    /** Accessible and visible text for the built-in back link. */
+    readonly backLabel: import("@angular/core").InputSignal<string>;
+    /** Makes this header sticky independently of the containing page. */
+    readonly sticky: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /**
+     * Visual scale. `'m'` is the default hero header; `'s'` is the compact
+     * single-row variant for record-editor pages, with a smaller title scale.
+     */
+    readonly size: import("@angular/core").InputSignal<MlvPageHeaderSize>;
+    /** Aligns the tabs row to the start (default) or centers it. */
+    readonly tabsAlign: import("@angular/core").InputSignal<MlvPageHeaderTabsAlign>;
+    /**
+     * Shows the floating chevron/pin snap controls on the header's bottom edge.
+     * Requires the header to be inside `main[mlvPage]`.
+     */
+    readonly snapControls: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** Accessible label for the chevron snap-toggle control. */
+    readonly toggleLabel: import("@angular/core").InputSignal<string>;
+    /** Accessible label for the pin control. */
+    readonly pinLabel: import("@angular/core").InputSignal<string>;
+    /** Emits when the built-in back link is activated. */
+    readonly backClick: import("@angular/core").OutputEmitterRef<MouseEvent>;
+    /** @protected Breadcrumb template projected via `[mlvPageBreadcrumb]`. */
+    protected readonly _breadcrumbRef: import("@angular/core").Signal<MlvPageBreadcrumb | undefined>;
+    /** @protected Decorative leading icon projected via `[mlvPageHeaderIcon]`. */
+    protected readonly _iconRef: import("@angular/core").Signal<MlvPageHeaderIcon | undefined>;
+    /** @protected Page title template projected via `[mlvPageTitle]`. */
+    protected readonly _titleRef: import("@angular/core").Signal<MlvPageTitle | undefined>;
+    /** @protected Inline status content projected via `[mlvPageHeaderStatus]`. */
+    protected readonly _statusRef: import("@angular/core").Signal<MlvPageHeaderStatus | undefined>;
+    /** @protected Header actions projected via `[mlvPageHeaderActions]`. */
+    protected readonly _actionsRef: import("@angular/core").Signal<MlvPageHeaderActions | undefined>;
+    /** @protected Description projected via `[mlvPageHeaderDescription]`. */
+    protected readonly _descriptionRef: import("@angular/core").Signal<MlvPageHeaderDescription | undefined>;
+    /** @protected Metadata projected via `[mlvPageHeaderMeta]`. */
+    protected readonly _metaRef: import("@angular/core").Signal<MlvPageHeaderMeta | undefined>;
+    /** @protected Tabs projected via `[mlvPageHeaderTabs]`. */
+    protected readonly _tabsRef: import("@angular/core").Signal<MlvPageHeaderTabs | undefined>;
+    /** @protected Trailing tabs-row actions projected via `[mlvPageHeaderTabsActions]`. */
+    protected readonly _tabsActionsRef: import("@angular/core").Signal<MlvPageHeaderTabsActions | undefined>;
+    /** @private Scroll state of the owning page, when rendered inside one. */
+    private readonly _pageScroll;
+    /** @private Snap controller of the owning page, when rendered inside one. */
+    private readonly _snap;
+    /** @protected Controller behind the floating controls, when enabled. */
+    protected readonly _controls: import("@angular/core").Signal<MlvPageSnapController | null>;
+    /** @protected True while the chrome is closer to snapped than expanded. */
+    protected readonly _snapped: import("@angular/core").Signal<boolean>;
+    /** @protected True while the snap state is frozen against scrolling. */
+    protected readonly _pinned: import("@angular/core").Signal<boolean>;
+    /** @protected True while the owning page is scrolled away from the top. */
+    protected readonly _scrolled: import("@angular/core").Signal<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageHeader, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvPageHeader, "mlv-page-header", never, { "back": { "alias": "back"; "required": false; "isSignal": true; }; "backLabel": { "alias": "backLabel"; "required": false; "isSignal": true; }; "sticky": { "alias": "sticky"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "tabsAlign": { "alias": "tabsAlign"; "required": false; "isSignal": true; }; "snapControls": { "alias": "snapControls"; "required": false; "isSignal": true; }; "toggleLabel": { "alias": "toggleLabel"; "required": false; "isSignal": true; }; "pinLabel": { "alias": "pinLabel"; "required": false; "isSignal": true; }; }, { "backClick": "backClick"; }, ["_breadcrumbRef", "_iconRef", "_titleRef", "_statusRef", "_actionsRef", "_descriptionRef", "_metaRef", "_tabsRef", "_tabsActionsRef"], ["mlv-page-summary"], true, never>;
+}

package/page/lib/page-header/page-header.directives.d.ts

@@ -0,0 +1,50 @@
+import { MlvStructural } from '@malva-ui/cdk/utils';
+import * as i0 from "@angular/core";
+/** Marks the breadcrumb template rendered at the start of a page header. */
+export declare class MlvPageBreadcrumb extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageBreadcrumb, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageBreadcrumb, "[mlvPageBreadcrumb]", never, {}, {}, never, never, true, never>;
+}
+/** Marks the decorative leading icon beside the page title. */
+export declare class MlvPageHeaderIcon extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageHeaderIcon, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageHeaderIcon, "[mlvPageHeaderIcon]", never, {}, {}, never, never, true, never>;
+}
+/** Marks the page title template. Consumers should project one semantic `<h1>`. */
+export declare class MlvPageTitle extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageTitle, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageTitle, "[mlvPageTitle]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Marks inline status content rendered directly after the page title,
+ * such as draft/live badges or an unsaved-changes indicator.
+ */
+export declare class MlvPageHeaderStatus extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageHeaderStatus, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageHeaderStatus, "[mlvPageHeaderStatus]", never, {}, {}, never, never, true, never>;
+}
+/** Marks the primary actions rendered after the page title. */
+export declare class MlvPageHeaderActions extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageHeaderActions, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageHeaderActions, "[mlvPageHeaderActions]", never, {}, {}, never, never, true, never>;
+}
+/** Marks supporting descriptive content below the title row. */
+export declare class MlvPageHeaderDescription extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageHeaderDescription, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageHeaderDescription, "[mlvPageHeaderDescription]", never, {}, {}, never, never, true, never>;
+}
+/** Marks page metadata such as ownership, visibility, or last-updated time. */
+export declare class MlvPageHeaderMeta extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageHeaderMeta, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageHeaderMeta, "[mlvPageHeaderMeta]", never, {}, {}, never, never, true, never>;
+}
+/** Marks navigation tabs rendered at the bottom of the header. */
+export declare class MlvPageHeaderTabs extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageHeaderTabs, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageHeaderTabs, "[mlvPageHeaderTabs]", never, {}, {}, never, never, true, never>;
+}
+/** Marks actions aligned to the trailing edge of the page-tabs row. */
+export declare class MlvPageHeaderTabsActions extends MlvStructural {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageHeaderTabsActions, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageHeaderTabsActions, "[mlvPageHeaderTabsActions]", never, {}, {}, never, never, true, never>;
+}

package/page/lib/page-shell/page-shell-color.d.ts

@@ -0,0 +1,48 @@
+/** Internal normalized representation of a browser-resolved sRGB color. */
+export interface MlvRgbaColor {
+    /** Red channel in the inclusive range 0–255. */
+    red: number;
+    /** Green channel in the inclusive range 0–255. */
+    green: number;
+    /** Blue channel in the inclusive range 0–255. */
+    blue: number;
+    /** Alpha channel in the inclusive range 0–1. */
+    alpha: number;
+}
+/**
+ * Parses an RGB value emitted by the browser CSSOM.
+ *
+ * @param value Computed `rgb(...)` or `rgba(...)` string.
+ * @returns The normalized color, or `null` when the value is not parseable.
+ */
+export declare function parseComputedColor(value: string): MlvRgbaColor | null;
+/**
+ * Composites one sRGB color over another using source-over alpha blending.
+ *
+ * @param foreground Color painted above the background.
+ * @param background Color painted below the foreground.
+ * @returns The effective blended color.
+ */
+export declare function compositeColors(foreground: MlvRgbaColor, background: MlvRgbaColor): MlvRgbaColor;
+/**
+ * Serializes a normalized color to modern CSS RGB syntax.
+ *
+ * @param color Color to serialize.
+ * @returns A CSS `rgb(...)` value.
+ */
+export declare function toCssColor(color: MlvRgbaColor): string;
+/**
+ * Computes the WCAG contrast ratio between two opaque effective colors.
+ *
+ * @param first First effective color.
+ * @param second Second effective color.
+ * @returns Contrast ratio in the inclusive range 1–21.
+ */
+export declare function contrastRatio(first: MlvRgbaColor, second: MlvRgbaColor): number;
+/**
+ * Selects the black or white endpoint with the strongest WCAG contrast.
+ *
+ * @param background Opaque effective background color.
+ * @returns An opaque CSS black or white value.
+ */
+export declare function chooseContrastForeground(background: MlvRgbaColor): string;

package/page/lib/page-shell/page-shell-css-color.d.ts

@@ -0,0 +1,20 @@
+import { type MlvRgbaColor } from './page-shell-color';
+/**
+ * Resolves a CSS color in an element's actual inheritance context.
+ * Two inherited sentinel colors distinguish a valid result from an unresolved
+ * value that silently falls back to `inherit`.
+ *
+ * @param host Element whose cascade resolves custom properties.
+ * @param value Candidate CSS color.
+ * @returns Browser-resolved sRGB channels, or `null` when unresolved.
+ */
+export declare function resolveCssColor(host: HTMLElement, value: string | null): MlvRgbaColor | null;
+/**
+ * Resolves the visible backdrop beneath a translucent shell color.
+ * Ancestor backgrounds are composited from nearest to farthest before the
+ * stable shell default is used as the final opaque base.
+ *
+ * @param host Shell whose ancestor cascade supplies the backdrop.
+ * @returns Opaque effective backdrop.
+ */
+export declare function resolveBackdropBackground(host: HTMLElement): MlvRgbaColor;

package/page/lib/page-shell/page-shell.d.ts

@@ -0,0 +1,44 @@
+import * as i0 from "@angular/core";
+/**
+ * Application-page shell that joins global top navigation, one or two sidebars,
+ * and the Page canvas without taking ownership of their component behaviour.
+ */
+export declare class MlvPageShell {
+    /**
+     * Optional CSS color for the shell chrome background.
+     * Browser-resolved values such as `var(--brand-color)` are supported.
+     */
+    readonly color: import("@angular/core").InputSignal<string | null>;
+    /**
+     * Optional CSS color overriding the automatically selected chrome foreground.
+     */
+    readonly foreground: import("@angular/core").InputSignal<string | null>;
+    /** @protected Browser-resolved background applied through the host style. */
+    protected readonly _resolvedBackground: import("@angular/core").WritableSignal<string | null>;
+    /** @protected Browser-resolved foreground applied through the host style. */
+    protected readonly _resolvedForeground: import("@angular/core").WritableSignal<string | null>;
+    /** @private Native shell host used as the CSS inheritance context. */
+    private readonly _host;
+    /** @private Angular destruction hook for frame and observer cleanup. */
+    private readonly _destroyRef;
+    /** @private Identifier of the pending color-resolution animation frame. */
+    private _resolutionFrameId;
+    /** @private Watches theme and custom-property changes in the shell cascade. */
+    private _mutationObserver;
+    constructor();
+    /**
+     * @private Observes the shell and its ancestors for cascade-affecting
+     * attribute changes. One observer can watch every node in the chain.
+     */
+    private _startColorObservation;
+    /**
+     * @private Coalesces CSS reads and signal writes into the next render frame.
+     */
+    private _scheduleColorResolution;
+    /**
+     * @private Resolves the input colors and updates the internal host variables.
+     */
+    private _resolveColors;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageShell, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvPageShell, "mlv-page-shell", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "foreground": { "alias": "foreground"; "required": false; "isSignal": true; }; }, {}, never, ["[mlvPageTopbar]", "[mlvPageSidebar]", "*", "[mlvPageEndSidebar]"], true, never>;
+}

package/page/lib/page-shell/page-shell.slots.d.ts

@@ -0,0 +1,16 @@
+import * as i0 from "@angular/core";
+/** Marks the global top-navigation element projected into `mlv-page-shell`. */
+export declare class MlvPageTopbar {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageTopbar, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageTopbar, "[mlvPageTopbar]", never, {}, {}, never, never, true, never>;
+}
+/** Marks the primary navigation sidebar projected into `mlv-page-shell`. */
+export declare class MlvPageSidebar {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageSidebar, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageSidebar, "[mlvPageSidebar]", never, {}, {}, never, never, true, never>;
+}
+/** Marks an optional second, trailing sidebar projected into `mlv-page-shell`. */
+export declare class MlvPageEndSidebar {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageEndSidebar, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageEndSidebar, "[mlvPageEndSidebar]", never, {}, {}, never, never, true, never>;
+}

package/page/lib/page-summary/page-summary-item.d.ts

@@ -0,0 +1,11 @@
+import * as i0 from "@angular/core";
+/**
+ * One labelled key fact inside `mlv-page-summary`. The label renders above
+ * the projected value content.
+ */
+export declare class MlvPageSummaryItem {
+    /** Visible label describing the projected value. */
+    readonly label: import("@angular/core").InputSignal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageSummaryItem, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvPageSummaryItem, "mlv-page-summary-item", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}

package/page/lib/page-summary/page-summary.d.ts

@@ -0,0 +1,36 @@
+import * as i0 from "@angular/core";
+/**
+ * Key-facts strip rendered under a page header. Projects
+ * `mlv-page-summary-item` children in a wrapping row.
+ *
+ * Inside `main[mlvPage]` the strip participates in the scroll-scrubbed snap
+ * timeline: its height and opacity are interpolated from the page-level
+ * `--mlv-page-snap` progress over the `snapFrom`..`snapTo` stagger window.
+ * Collapse/expand and pinning are controlled by the header's snap controls
+ * (`mlv-page-header[snapControls]`) through `MlvPageSnapController` — the
+ * strip itself is purely presentational.
+ */
+export declare class MlvPageSummary {
+    /** Accessible name for the facts region. */
+    readonly summaryLabel: import("@angular/core").InputSignal<string>;
+    /** Progress at which the strip starts collapsing (0..1). */
+    readonly snapFrom: import("@angular/core").InputSignal<number>;
+    /** Progress at which the strip is fully collapsed (0..1). */
+    readonly snapTo: import("@angular/core").InputSignal<number>;
+    /** @protected Multiplier remapping page progress into the stagger window. */
+    protected readonly _scale: import("@angular/core").Signal<number>;
+    /** @private Snap state of the owning page, when rendered inside one. */
+    private readonly _snap;
+    /**
+     * @protected True once the strip has fully collapsed; also removes it from
+     * the accessibility tree and tab order.
+     */
+    protected readonly _snapped: import("@angular/core").Signal<boolean>;
+    /** @protected Natural height of the items row, driving the height scrub. */
+    protected readonly _measuredHeight: import("@angular/core").WritableSignal<number | null>;
+    /** @private The measured items row. */
+    private readonly _items;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageSummary, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvPageSummary, "mlv-page-summary", never, { "summaryLabel": { "alias": "summaryLabel"; "required": false; "isSignal": true; }; "snapFrom": { "alias": "snapFrom"; "required": false; "isSignal": true; }; "snapTo": { "alias": "snapTo"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}

package/page/malva-ui-core-page.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="@malva-ui/core/page" />
+export * from './index';

package/pagination/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/pagination/pagination';
+export * from './lib/pagination/pagination.service';
+export * from './lib/pagination/pagination.model';
+export * from './lib/pagination/pagination.directives';