@malva-ui/core 0.1.12

package/number-input/lib/number-input/number-input.d.ts

@@ -0,0 +1,162 @@
+import type { ElementRef } from '@angular/core';
+import type { BooleanInput } from '@angular/cdk/coercion';
+import type { MlvFormControl } from '@malva-ui/core/form-utils';
+import { MlvSignalFormControlBase } from '@malva-ui/core/form-utils';
+import * as i0 from "@angular/core";
+import * as i1 from "@malva-ui/cdk/density";
+/** MlvLayout direction for the increment/decrement controls. */
+export type MlvNumberInputControlStack = 'horizontal' | 'vertical';
+/** Side used for the vertical control stack. */
+export type MlvNumberInputControlAlignment = 'left' | 'right';
+export declare class MlvNumberInput extends MlvSignalFormControlBase<number | null> implements MlvFormControl {
+    /** @protected The component's i18n strings signal. */
+    protected readonly _i18n: import("@angular/core").Signal<import("@malva-ui/i18n").MlvNumberInputI18n>;
+    /**
+     * Minimum allowed value. Also a signal-forms field binding: a `min` schema
+     * rule on the bound field binds this input (`NonNullable<number>|undefined`),
+     * so the write type widens to accept `undefined` (normalised to `null`).
+     */
+    readonly min: import("@angular/core").InputSignalWithTransform<number | null, number | null | undefined>;
+    /**
+     * Maximum allowed value. Also a signal-forms field binding: a `max` schema
+     * rule on the bound field binds this input (`NonNullable<number>|undefined`),
+     * so the write type widens to accept `undefined` (normalised to `null`).
+     */
+    readonly max: import("@angular/core").InputSignalWithTransform<number | null, number | null | undefined>;
+    /**
+     * Step increment for arrow keys and stepper buttons. Default: 1. Write type
+     * widened to accept `undefined` (normalised to the `1` default) for
+     * signal-forms constraint-binding parity with the other numeric inputs.
+     */
+    readonly step: import("@angular/core").InputSignalWithTransform<number, number | null | undefined>;
+    /**
+     * Large step for Shift+Arrow keys.
+     * Defaults to 10 × step when null.
+     */
+    readonly largeStep: import("@angular/core").InputSignal<number | null>;
+    /** Placeholder text shown when the input is empty. */
+    readonly placeholder: import("@angular/core").InputSignal<string>;
+    /**
+     * Decimal precision for displayed value.
+     * When null, precision is inferred from the step value.
+     */
+    readonly precision: import("@angular/core").InputSignal<number | null>;
+    /**
+     * Whether scroll-wheel stepping is enabled when the input is focused.
+     * Default: true.
+     */
+    readonly scrollable: import("@angular/core").InputSignalWithTransform<boolean, BooleanInput>;
+    /** MlvLayout direction for the increment/decrement controls. */
+    readonly stack: import("@angular/core").InputSignal<MlvNumberInputControlStack>;
+    /**
+     * Side used for the vertical control stack.
+     * Has no visual effect while `stack` is `'horizontal'`.
+     */
+    readonly controlAlignment: import("@angular/core").InputSignal<MlvNumberInputControlAlignment>;
+    /** @private Reference to the native input element. */
+    protected readonly _inputRef: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
+    /**
+     * The committed numeric value — the signal-forms `FormValueControl` model
+     * (`null` when empty/cleared). Kept in sync with the bound field by
+     * `[formField]` / `[formControl]` / `ngModel`. Out-of-range form-side writes
+     * are re-clamped into `[min, max]` by the constructor effect (the
+     * replacement for the old CVA `writeValue` clamp).
+     */
+    readonly value: import("@angular/core").ModelSignal<number | null>;
+    /** @private Raw string held while the user is typing. */
+    protected readonly _internalStringValue: import("@angular/core").WritableSignal<string>;
+    /** @private Whether the input currently has focus. */
+    protected readonly _isFocused: import("@angular/core").WritableSignal<boolean>;
+    /** True when the current value equals or is below min. */
+    readonly isAtMin: import("@angular/core").Signal<boolean>;
+    /** True when the current value equals or is above max. */
+    readonly isAtMax: import("@angular/core").Signal<boolean>;
+    /** Effective large step: largeStep input or 10 × step. */
+    readonly effectiveLargeStep: import("@angular/core").Signal<number>;
+    /**
+     * Effective decimal precision.
+     * Uses the precision input if set; otherwise infers from the step string.
+     */
+    readonly effectivePrecision: import("@angular/core").Signal<number>;
+    /** @private DestroyRef used for long-press timer cleanup. */
+    private readonly _destroyRef;
+    /** @private Long-press delay timer handle. */
+    private _longPressDelayTimer;
+    /** @private Long-press repeat interval handle. */
+    private _longPressIntervalTimer;
+    /** @private Timestamp when long-press started (for large-step threshold). */
+    private _longPressStartTime;
+    constructor();
+    /**
+     * Clears the current value. Called by the MlvFormControlWrapper clear button.
+     */
+    clearValue(): void;
+    /** Whether the control holds a clearable value — A numeric value is set. */
+    readonly hasValue: import("@angular/core").Signal<boolean>;
+    /**
+     * @protected Handles native input events — stores raw string while typing.
+     */
+    protected _onNativeInput(event: Event): void;
+    /**
+     * @protected Commits typed value on blur: parse, clamp, round, emit, then
+     * reports {@link MlvSignalFormUiControlBase.touch} (replaces CVA `onTouched`).
+     */
+    protected _onBlur(): void;
+    /**
+     * @protected Commits on Enter key press.
+     */
+    protected _onEnter(): void;
+    /**
+     * @protected Handles keyboard navigation on the native input.
+     */
+    protected _onKeydown(event: KeyboardEvent): void;
+    /**
+     * @protected Handles scroll-wheel input when scrollable and focused.
+     * The wheel listener is attached via fromEvent with { passive: false } so
+     * preventDefault() actually suppresses page scroll.
+     */
+    protected _onWheel(event: WheelEvent): void;
+    /**
+     * @protected Starts a long-press sequence for increment (positive delta) or decrement.
+     */
+    protected _onStepperPointerDown(delta: 1 | -1): void;
+    /**
+     * @protected Cancels long-press on pointer release.
+     */
+    protected _onStepperPointerUp(): void;
+    /**
+     * @private Parses the typed string, clamps, rounds, and commits to `value`.
+     */
+    private _commitTypedValue;
+    /**
+     * @private Applies a numeric delta to the current value, clamping the result.
+     */
+    private _step;
+    /**
+     * @private Sets the numeric value: clamp → round → commit to the `value`
+     * model (which propagates to the bound field).
+     */
+    private _setValue;
+    /**
+     * @private Clamps a value to [min, max].
+     */
+    private _clamp;
+    /**
+     * @private Rounds a value to the effective precision.
+     */
+    private _round;
+    /**
+     * @private Formats a number to the effective precision string.
+     */
+    private _format;
+    /**
+     * @private Clears long-press timers.
+     */
+    private _clearLongPress;
+    /**
+     * @private Focuses the native input after a stepper button click.
+     */
+    private _refocusInput;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvNumberInput, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MlvNumberInput, "mlv-number-input", never, { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "largeStep": { "alias": "largeStep"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "precision": { "alias": "precision"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "controlAlignment": { "alias": "controlAlignment"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof i1.MlvCompactComfortableDensity; inputs: { "mlvDensity": "mlvDensity"; }; outputs: {}; }]>;
+}

package/number-input/malva-ui-core-number-input.d.ts

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

package/package.json

@@ -0,0 +1,315 @@
+{
+  "name": "@malva-ui/core",
+  "version": "0.1.12",
+  "schematics": "./schematics/collection.json",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@angular/aria": "22.0.5",
+    "@angular/cdk": "22.0.5",
+    "@angular/common": "22.0.7",
+    "@angular/core": "22.0.7",
+    "@angular/forms": "22.0.7",
+    "@lucide/angular": "^1.25.0",
+    "@malva-ui/cdk": "0.1.12",
+    "@malva-ui/i18n": "0.1.12",
+    "rxjs": "~7.8.0"
+  },
+  "sideEffects": false,
+  "module": "esm2022/malva-ui-core.js",
+  "typings": "malva-ui-core.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./malva-ui-core.d.ts",
+      "default": "./esm2022/malva-ui-core.js"
+    },
+    "./accordion": {
+      "types": "./accordion/malva-ui-core-accordion.d.ts",
+      "default": "./esm2022/accordion/malva-ui-core-accordion.js"
+    },
+    "./action-bar": {
+      "types": "./action-bar/malva-ui-core-action-bar.d.ts",
+      "default": "./esm2022/action-bar/malva-ui-core-action-bar.js"
+    },
+    "./alert": {
+      "types": "./alert/malva-ui-core-alert.d.ts",
+      "default": "./esm2022/alert/malva-ui-core-alert.js"
+    },
+    "./autocomplete": {
+      "types": "./autocomplete/malva-ui-core-autocomplete.d.ts",
+      "default": "./esm2022/autocomplete/malva-ui-core-autocomplete.js"
+    },
+    "./avatar": {
+      "types": "./avatar/malva-ui-core-avatar.d.ts",
+      "default": "./esm2022/avatar/malva-ui-core-avatar.js"
+    },
+    "./avatar-group": {
+      "types": "./avatar-group/malva-ui-core-avatar-group.d.ts",
+      "default": "./esm2022/avatar-group/malva-ui-core-avatar-group.js"
+    },
+    "./badge": {
+      "types": "./badge/malva-ui-core-badge.d.ts",
+      "default": "./esm2022/badge/malva-ui-core-badge.js"
+    },
+    "./bottom-nav": {
+      "types": "./bottom-nav/malva-ui-core-bottom-nav.d.ts",
+      "default": "./esm2022/bottom-nav/malva-ui-core-bottom-nav.js"
+    },
+    "./breadcrumb": {
+      "types": "./breadcrumb/malva-ui-core-breadcrumb.d.ts",
+      "default": "./esm2022/breadcrumb/malva-ui-core-breadcrumb.js"
+    },
+    "./button": {
+      "types": "./button/malva-ui-core-button.d.ts",
+      "default": "./esm2022/button/malva-ui-core-button.js"
+    },
+    "./calendar": {
+      "types": "./calendar/malva-ui-core-calendar.d.ts",
+      "default": "./esm2022/calendar/malva-ui-core-calendar.js"
+    },
+    "./card": {
+      "types": "./card/malva-ui-core-card.d.ts",
+      "default": "./esm2022/card/malva-ui-core-card.js"
+    },
+    "./chat": {
+      "types": "./chat/malva-ui-core-chat.d.ts",
+      "default": "./esm2022/chat/malva-ui-core-chat.js"
+    },
+    "./checkbox": {
+      "types": "./checkbox/malva-ui-core-checkbox.d.ts",
+      "default": "./esm2022/checkbox/malva-ui-core-checkbox.js"
+    },
+    "./chip": {
+      "types": "./chip/malva-ui-core-chip.d.ts",
+      "default": "./esm2022/chip/malva-ui-core-chip.js"
+    },
+    "./color-picker": {
+      "types": "./color-picker/malva-ui-core-color-picker.d.ts",
+      "default": "./esm2022/color-picker/malva-ui-core-color-picker.js"
+    },
+    "./combobox": {
+      "types": "./combobox/malva-ui-core-combobox.d.ts",
+      "default": "./esm2022/combobox/malva-ui-core-combobox.js"
+    },
+    "./copy-to-clipboard": {
+      "types": "./copy-to-clipboard/malva-ui-core-copy-to-clipboard.d.ts",
+      "default": "./esm2022/copy-to-clipboard/malva-ui-core-copy-to-clipboard.js"
+    },
+    "./data-table": {
+      "types": "./data-table/malva-ui-core-data-table.d.ts",
+      "default": "./esm2022/data-table/malva-ui-core-data-table.js"
+    },
+    "./date-range-picker": {
+      "types": "./date-range-picker/malva-ui-core-date-range-picker.d.ts",
+      "default": "./esm2022/date-range-picker/malva-ui-core-date-range-picker.js"
+    },
+    "./day-picker": {
+      "types": "./day-picker/malva-ui-core-day-picker.d.ts",
+      "default": "./esm2022/day-picker/malva-ui-core-day-picker.js"
+    },
+    "./dialog": {
+      "types": "./dialog/malva-ui-core-dialog.d.ts",
+      "default": "./esm2022/dialog/malva-ui-core-dialog.js"
+    },
+    "./divider": {
+      "types": "./divider/malva-ui-core-divider.d.ts",
+      "default": "./esm2022/divider/malva-ui-core-divider.js"
+    },
+    "./drawer": {
+      "types": "./drawer/malva-ui-core-drawer.d.ts",
+      "default": "./esm2022/drawer/malva-ui-core-drawer.js"
+    },
+    "./dropdown": {
+      "types": "./dropdown/malva-ui-core-dropdown.d.ts",
+      "default": "./esm2022/dropdown/malva-ui-core-dropdown.js"
+    },
+    "./empty-state": {
+      "types": "./empty-state/malva-ui-core-empty-state.d.ts",
+      "default": "./esm2022/empty-state/malva-ui-core-empty-state.js"
+    },
+    "./expand": {
+      "types": "./expand/malva-ui-core-expand.d.ts",
+      "default": "./esm2022/expand/malva-ui-core-expand.js"
+    },
+    "./file-upload": {
+      "types": "./file-upload/malva-ui-core-file-upload.d.ts",
+      "default": "./esm2022/file-upload/malva-ui-core-file-upload.js"
+    },
+    "./filter": {
+      "types": "./filter/malva-ui-core-filter.d.ts",
+      "default": "./esm2022/filter/malva-ui-core-filter.js"
+    },
+    "./form": {
+      "types": "./form/malva-ui-core-form.d.ts",
+      "default": "./esm2022/form/malva-ui-core-form.js"
+    },
+    "./form-utils": {
+      "types": "./form-utils/malva-ui-core-form-utils.d.ts",
+      "default": "./esm2022/form-utils/malva-ui-core-form-utils.js"
+    },
+    "./form-utils/testing": {
+      "types": "./form-utils/testing/malva-ui-core-form-utils-testing.d.ts",
+      "default": "./esm2022/form-utils/testing/malva-ui-core-form-utils-testing.js"
+    },
+    "./input": {
+      "types": "./input/malva-ui-core-input.d.ts",
+      "default": "./esm2022/input/malva-ui-core-input.js"
+    },
+    "./kbd": {
+      "types": "./kbd/malva-ui-core-kbd.d.ts",
+      "default": "./esm2022/kbd/malva-ui-core-kbd.js"
+    },
+    "./layout": {
+      "types": "./layout/malva-ui-core-layout.d.ts",
+      "default": "./esm2022/layout/malva-ui-core-layout.js"
+    },
+    "./link": {
+      "types": "./link/malva-ui-core-link.d.ts",
+      "default": "./esm2022/link/malva-ui-core-link.js"
+    },
+    "./list": {
+      "types": "./list/malva-ui-core-list.d.ts",
+      "default": "./esm2022/list/malva-ui-core-list.js"
+    },
+    "./loader": {
+      "types": "./loader/malva-ui-core-loader.d.ts",
+      "default": "./esm2022/loader/malva-ui-core-loader.js"
+    },
+    "./menu": {
+      "types": "./menu/malva-ui-core-menu.d.ts",
+      "default": "./esm2022/menu/malva-ui-core-menu.js"
+    },
+    "./notification": {
+      "types": "./notification/malva-ui-core-notification.d.ts",
+      "default": "./esm2022/notification/malva-ui-core-notification.js"
+    },
+    "./number-input": {
+      "types": "./number-input/malva-ui-core-number-input.d.ts",
+      "default": "./esm2022/number-input/malva-ui-core-number-input.js"
+    },
+    "./page": {
+      "types": "./page/malva-ui-core-page.d.ts",
+      "default": "./esm2022/page/malva-ui-core-page.js"
+    },
+    "./pagination": {
+      "types": "./pagination/malva-ui-core-pagination.d.ts",
+      "default": "./esm2022/pagination/malva-ui-core-pagination.js"
+    },
+    "./pin-input": {
+      "types": "./pin-input/malva-ui-core-pin-input.d.ts",
+      "default": "./esm2022/pin-input/malva-ui-core-pin-input.js"
+    },
+    "./popup": {
+      "types": "./popup/malva-ui-core-popup.d.ts",
+      "default": "./esm2022/popup/malva-ui-core-popup.js"
+    },
+    "./progress": {
+      "types": "./progress/malva-ui-core-progress.d.ts",
+      "default": "./esm2022/progress/malva-ui-core-progress.js"
+    },
+    "./radio": {
+      "types": "./radio/malva-ui-core-radio.d.ts",
+      "default": "./esm2022/radio/malva-ui-core-radio.js"
+    },
+    "./rating": {
+      "types": "./rating/malva-ui-core-rating.d.ts",
+      "default": "./esm2022/rating/malva-ui-core-rating.js"
+    },
+    "./scrollbar": {
+      "types": "./scrollbar/malva-ui-core-scrollbar.d.ts",
+      "default": "./esm2022/scrollbar/malva-ui-core-scrollbar.js"
+    },
+    "./search-field": {
+      "types": "./search-field/malva-ui-core-search-field.d.ts",
+      "default": "./esm2022/search-field/malva-ui-core-search-field.js"
+    },
+    "./segmented": {
+      "types": "./segmented/malva-ui-core-segmented.d.ts",
+      "default": "./esm2022/segmented/malva-ui-core-segmented.js"
+    },
+    "./select": {
+      "types": "./select/malva-ui-core-select.d.ts",
+      "default": "./esm2022/select/malva-ui-core-select.js"
+    },
+    "./sidebar": {
+      "types": "./sidebar/malva-ui-core-sidebar.d.ts",
+      "default": "./esm2022/sidebar/malva-ui-core-sidebar.js"
+    },
+    "./skeleton": {
+      "types": "./skeleton/malva-ui-core-skeleton.d.ts",
+      "default": "./esm2022/skeleton/malva-ui-core-skeleton.js"
+    },
+    "./slider": {
+      "types": "./slider/malva-ui-core-slider.d.ts",
+      "default": "./esm2022/slider/malva-ui-core-slider.js"
+    },
+    "./split-pane": {
+      "types": "./split-pane/malva-ui-core-split-pane.d.ts",
+      "default": "./esm2022/split-pane/malva-ui-core-split-pane.js"
+    },
+    "./status-indicator": {
+      "types": "./status-indicator/malva-ui-core-status-indicator.d.ts",
+      "default": "./esm2022/status-indicator/malva-ui-core-status-indicator.js"
+    },
+    "./stepper": {
+      "types": "./stepper/malva-ui-core-stepper.d.ts",
+      "default": "./esm2022/stepper/malva-ui-core-stepper.js"
+    },
+    "./switch": {
+      "types": "./switch/malva-ui-core-switch.d.ts",
+      "default": "./esm2022/switch/malva-ui-core-switch.js"
+    },
+    "./tabs": {
+      "types": "./tabs/malva-ui-core-tabs.d.ts",
+      "default": "./esm2022/tabs/malva-ui-core-tabs.js"
+    },
+    "./textarea": {
+      "types": "./textarea/malva-ui-core-textarea.d.ts",
+      "default": "./esm2022/textarea/malva-ui-core-textarea.js"
+    },
+    "./tile": {
+      "types": "./tile/malva-ui-core-tile.d.ts",
+      "default": "./esm2022/tile/malva-ui-core-tile.js"
+    },
+    "./time-picker": {
+      "types": "./time-picker/malva-ui-core-time-picker.d.ts",
+      "default": "./esm2022/time-picker/malva-ui-core-time-picker.js"
+    },
+    "./timeline": {
+      "types": "./timeline/malva-ui-core-timeline.d.ts",
+      "default": "./esm2022/timeline/malva-ui-core-timeline.js"
+    },
+    "./title": {
+      "types": "./title/malva-ui-core-title.d.ts",
+      "default": "./esm2022/title/malva-ui-core-title.js"
+    },
+    "./toast": {
+      "types": "./toast/malva-ui-core-toast.d.ts",
+      "default": "./esm2022/toast/malva-ui-core-toast.js"
+    },
+    "./tokenizer": {
+      "types": "./tokenizer/malva-ui-core-tokenizer.d.ts",
+      "default": "./esm2022/tokenizer/malva-ui-core-tokenizer.js"
+    },
+    "./toolbar": {
+      "types": "./toolbar/malva-ui-core-toolbar.d.ts",
+      "default": "./esm2022/toolbar/malva-ui-core-toolbar.js"
+    },
+    "./tooltip": {
+      "types": "./tooltip/malva-ui-core-tooltip.d.ts",
+      "default": "./esm2022/tooltip/malva-ui-core-tooltip.js"
+    },
+    "./tree": {
+      "types": "./tree/malva-ui-core-tree.d.ts",
+      "default": "./esm2022/tree/malva-ui-core-tree.js"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/page/README.md

@@ -0,0 +1,8 @@
+# @malva-ui/core/page
+
+Composable page-surface, page-header, and responsive content/aside primitives
+for Malva UI application shells.
+
+## Running unit tests
+
+Run `yarn nx test core-page` to execute the unit tests.

package/page/index.d.ts

@@ -0,0 +1,14 @@
+export * from './lib/page/page';
+export * from './lib/page/page-scroll.token';
+export * from './lib/page/page-snap-controller';
+export * from './lib/page/page-snap.directive';
+export * from './lib/page-shell/page-shell';
+export * from './lib/page-shell/page-shell.slots';
+export * from './lib/page-header/page-header';
+export * from './lib/page-header/page-header.directives';
+export * from './lib/page-content/page-content';
+export * from './lib/page-content/page-aside';
+export * from './lib/page-summary/page-summary';
+export * from './lib/page-summary/page-summary-item';
+export * from './lib/page-dock/page-dock';
+export * from './lib/page-dock/page-dock.slots';

package/page/lib/page/page-scroll.token.d.ts

@@ -0,0 +1,19 @@
+import { InjectionToken, type Signal } from '@angular/core';
+/**
+ * Scroll state of the owning page's scroll container, exposed to descendants
+ * such as `mlv-page-header` and `mlv-page-summary` for scroll-linked
+ * behaviour (sticky snap shadows, auto-collapsing summary strips).
+ */
+export interface MlvPageScrollState {
+    /** Current vertical scroll offset of the page scroll owner, in pixels. */
+    readonly scrollTop: Signal<number>;
+    /** True once the page has scrolled past a small hysteresis threshold. */
+    readonly scrolled: Signal<boolean>;
+}
+/**
+ * Injection token provided by `main[mlvPage]` so descendants can react to the
+ * page's scroll position without knowing which element owns scrolling.
+ * Inject optionally — components keep working outside a page, just without
+ * scroll-linked behaviour.
+ */
+export declare const MLV_PAGE_SCROLL: InjectionToken<MlvPageScrollState>;

package/page/lib/page/page-snap-controller.d.ts

@@ -0,0 +1,87 @@
+import type { Signal } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Owns the snap progress of a page's collapsing top chrome.
+ *
+ * Progress is **scroll-scrubbed**: `main[mlvPage]` maps its scroll offset onto
+ * a 0..1 timeline (`snapRange` pixels of scroll = the full timeline), so
+ * chrome motion is proportional to scrolling instead of a time-based
+ * animation. The effective value is published as the `--mlv-page-snap` CSS
+ * custom property on the page host; elements interpolate their own state from
+ * it (see `MlvPageSnap`).
+ *
+ * Pinning distinguishes its origin:
+ * - **Manual** (chevron toggle): an explicit choice — while manually pinned
+ *   collapsed, the geometry-compensation spacer is reclaimed (`spacerScale`
+ *   tweens to 0) so no dead space remains above the content, including at the
+ *   top of the page.
+ * - **Scroll** (pin button freezing a scroll-derived state): the frozen state
+ *   is a scroll artifact — when the user returns to the top, the controller
+ *   unpins automatically and the chrome expands.
+ *
+ * Provided by `MlvPage`. Inject optionally from header/summary components and
+ * snap directives — absence simply means "no scroll-linked behaviour".
+ */
+export declare class MlvPageSnapController {
+    /** @private Raw scroll-derived progress, 0 (top) .. 1 (fully snapped). */
+    private readonly _scrollProgress;
+    /**
+     * @private Frozen progress while pinned or after a manual toggle;
+     * `null` means the progress follows the scroll position.
+     */
+    private readonly _frozen;
+    /** @private How the current frozen state was produced. */
+    private _pinOrigin;
+    /**
+     * @private Scale applied by `MlvPage` to the geometry-compensation spacer;
+     * tweens to 0 while manually pinned collapsed (dead space reclaimed).
+     */
+    private readonly _spacerScale;
+    /** @private Frame handles of the running tweens, per animated signal. */
+    private readonly _tweenFrames;
+    /** @private Adapter so the frozen tween can share the signal tween helper. */
+    private readonly _frozenNumber;
+    /** @private Cancels pending tweens when the owning page is destroyed. */
+    private readonly _destroyRef;
+    /** Effective snap progress: 0 fully expanded, 1 fully snapped. */
+    readonly progress: Signal<number>;
+    /** True while the chrome state is frozen and ignores scrolling. */
+    readonly pinned: Signal<boolean>;
+    /** True once the chrome is closer to its snapped state than the open one. */
+    readonly snapped: Signal<boolean>;
+    /**
+     * Multiplier for the geometry-compensation spacer, 1 (full compensation)
+     * .. 0 (reclaimed). Consumed by `MlvPage`.
+     */
+    readonly spacerScale: Signal<number>;
+    constructor();
+    /**
+     * @internal Called by `MlvPage` on every scroll event of its viewport.
+     * A pinned controller keeps reporting the frozen value; a scroll-origin
+     * pin releases itself once the user returns to the top, where the frozen
+     * scroll artifact would only leave dead space.
+     */
+    updateFromScroll(scrollTop: number, snapRange: number): void;
+    /**
+     * Pins the chrome at its current progress (`true`) or releases it back to
+     * scroll-following (`false`, animating to the scroll-derived value). A pin
+     * taken from a scroll-following state is a scroll-origin pin; pinning while
+     * already frozen by the chevron keeps the manual origin.
+     */
+    setPinned(pinned: boolean): void;
+    /**
+     * Snaps the chrome fully open or closed (the chevron control). The result
+     * is a manual pin — otherwise the very next scroll event would undo the
+     * choice. Collapsing manually also reclaims the compensation spacer so no
+     * dead space remains above the content.
+     */
+    toggle(): void;
+    /** @private Tweens the frozen progress via the shared signal tween. */
+    private _animateFrozenTo;
+    /** @private rAF tween so manual state changes stay smooth. */
+    private _animateSignal;
+    /** @private Stops the running tween of one signal, if any. */
+    private _cancelTween;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageSnapController, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MlvPageSnapController>;
+}

package/page/lib/page/page-snap.directive.d.ts

@@ -0,0 +1,40 @@
+import * as i0 from "@angular/core";
+/** How an element behaves while the page chrome snaps. */
+export type MlvPageSnapMode = 'hide' | 'fade' | 'keep';
+/**
+ * Lets any element inside `main[mlvPage]` define its own state on the snap
+ * timeline. The element reads the page-level `--mlv-page-snap` progress,
+ * remaps it into its own stagger window (`snapFrom`..`snapTo`), and applies
+ * the chosen behaviour with pure CSS `calc()` interpolation — so the motion
+ * is scrubbed by scrolling, not played on a clock.
+ *
+ * ```html
+ * <div mlvPageSnap="hide" [snapFrom]="0.2" [snapTo]="0.7" snapSize="3rem">…</div>
+ * ```
+ */
+export declare class MlvPageSnap {
+    /** Behaviour on the snap timeline. An empty attribute value means `hide`. */
+    readonly mlvPageSnap: import("@angular/core").InputSignal<"" | MlvPageSnapMode>;
+    /** Progress at which this element starts reacting (0..1). */
+    readonly snapFrom: import("@angular/core").InputSignal<number>;
+    /** Progress at which this element reaches its final state (0..1). */
+    readonly snapTo: import("@angular/core").InputSignal<number>;
+    /**
+     * Nominal expanded size used by the `hide` behaviour's height scrub.
+     * Must be at least the element's natural height.
+     */
+    readonly snapSize: import("@angular/core").InputSignal<string>;
+    /** @private Snap state of the owning page, when rendered inside one. */
+    private readonly _controller;
+    /** @protected Effective behaviour; the bare attribute defaults to `hide`. */
+    protected readonly _mode: import("@angular/core").Signal<MlvPageSnapMode>;
+    /** @protected Multiplier remapping page progress into the stagger window. */
+    protected readonly _scale: import("@angular/core").Signal<number>;
+    /**
+     * @protected Removes hidden elements from the accessibility tree and tab
+     * order once their window of the timeline has fully elapsed.
+     */
+    protected readonly _hidden: import("@angular/core").Signal<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MlvPageSnap, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MlvPageSnap, "[mlvPageSnap]", never, { "mlvPageSnap": { "alias": "mlvPageSnap"; "required": false; "isSignal": true; }; "snapFrom": { "alias": "snapFrom"; "required": false; "isSignal": true; }; "snapTo": { "alias": "snapTo"; "required": false; "isSignal": true; }; "snapSize": { "alias": "snapSize"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}