ngwr 6.1.1 → 7.0.0

package/types/ngwr-toast.d.ts

@@ -0,0 +1,230 @@
+import * as i0 from '@angular/core';
+import { EnvironmentProviders, InjectionToken } from '@angular/core';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+type WrToastType = 'info' | 'success' | 'warning' | 'danger';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+type WrToastPosition = 'top-start' | 'top' | 'top-end' | 'bottom-start' | 'bottom' | 'bottom-end';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Per-toast options passed to {@link WrToast.show}. Any field
+ * omitted falls back to the global {@link WrToastConfig}.
+ */
+interface WrToastOptions {
+    /** Visual type. @default 'info' */
+    readonly type?: WrToastType;
+    /** Heading shown at the top of the toast. */
+    readonly title?: string;
+    /** Body message. */
+    readonly message: string;
+    /** Auto-dismiss after N ms. `0` disables auto-dismiss. Default from global config. */
+    readonly duration?: number;
+    /** Show a close (×) button. @default true */
+    readonly dismissible?: boolean;
+    /** Override the corner for this toast only. */
+    readonly position?: WrToastPosition;
+    /** Override the progress bar visibility for this toast only. */
+    readonly showProgress?: boolean;
+    /** Override the copy button visibility for this toast only. */
+    readonly showCopy?: boolean;
+}
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+/**
+ * How the host arranges multiple toasts.
+ *
+ * - `stack` — Sonner-style: toasts cascade behind the newest one when the
+ *   pointer is outside the host; on hover the stack fans out into a list.
+ * - `list` — classic vertical column, no overlap, no hover transition.
+ */
+type WrToastMode = 'stack' | 'list';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Global toast configuration registered through {@link provideWrToastConfig}.
+ *
+ * Per-toast {@link WrToastOptions} can override individual fields at call
+ * time (`position`, `duration`, `showProgress`, `showCopy`).
+ */
+interface WrToastConfig {
+    /** Corner the stack renders in. @default 'top-end' */
+    readonly position: WrToastPosition;
+    /** Layout mode for multiple toasts. @default 'stack' (Sonner-style hover-to-expand) */
+    readonly mode: WrToastMode;
+    /** Auto-dismiss after N ms. `0` disables auto-dismiss. @default 4000 */
+    readonly duration: number;
+    /** Render a countdown progress bar that pauses on hover. @default true */
+    readonly showProgress: boolean;
+    /** Render a "copy message" button on each toast. @default false */
+    readonly showCopy: boolean;
+    /** Render a "Close all" button when the stack reaches the threshold. @default true */
+    readonly showCloseAll: boolean;
+    /** Minimum number of stacked toasts before "Close all" appears. @default 2 */
+    readonly closeAllThreshold: number;
+    /** Maximum toasts visible at once. Oldest is dismissed when exceeded. `0` = unlimited. @default 5 */
+    readonly maxStack: number;
+    /** Labels rendered in the UI. Keep short — meant to be overridden for i18n. */
+    readonly labels: {
+        readonly close: string;
+        readonly copy: string;
+        readonly copied: string;
+        readonly closeAll: string;
+    };
+}
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Handle returned by `WrToast.show()`. Call `dismiss()` to remove
+ * the toast early. Inspect `options` to see what the caller requested.
+ */
+declare class WrToastRef {
+    readonly id: number;
+    readonly options: WrToastOptions;
+    private readonly onDismiss;
+    constructor(id: number, options: WrToastOptions, onDismiss: (id: number) => void);
+    /** Remove this toast from the stack. */
+    dismiss(): void;
+}
+
+/**
+ * Opens toast notifications in a single shared overlay.
+ *
+ * Global defaults come from {@link WR_TOAST_CONFIG}; register
+ * {@link provideWrToastConfig} once at bootstrap to customise. Each
+ * `show()` call accepts per-toast overrides via {@link WrToastOptions}.
+ *
+ * @example
+ * ```ts
+ * const toast = inject(WrToast);
+ *
+ * toast.show({ type: 'success', title: 'Saved', message: 'Profile updated.' });
+ * toast.show({ type: 'danger', message: 'Network error', duration: 0 });
+ * toast.show({ message: 'Permalink copied', position: 'bottom', showCopy: true });
+ * ```
+ *
+ * @see https://ngwr.dev/components/toast
+ */
+declare class WrToast {
+    private readonly overlay;
+    private readonly config;
+    private overlayRef;
+    private hostRef;
+    private currentPosition;
+    private currentMode;
+    private nextId;
+    private active;
+    /** Open a toast. Returns a handle you can `dismiss()` early. */
+    show(options: WrToastOptions): WrToastRef;
+    /** Dismiss a single toast by id. */
+    dismiss(id: number): void;
+    /** Dismiss every visible toast. Wired to the host's "Close all" button. */
+    dismissAll(): void;
+    /** Change the corner the stack opens in. Affects future toasts. */
+    setPosition(position: WrToastPosition): void;
+    /** Switch the layout mode at runtime. Persists across host re-creation. */
+    setMode(mode: 'stack' | 'list'): void;
+    private startTimer;
+    private pauseTimer;
+    private ensureHost;
+    private enforceMaxStack;
+    private pushToHost;
+    private disposeHost;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrToast, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WrToast>;
+}
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Registers a global {@link WrToastConfig} for {@link WrToast}. Any
+ * field you omit falls back to {@link DEFAULT_TOAST_CONFIG}; the `labels`
+ * sub-object is merged separately so you can override a single string at a
+ * time (useful for i18n).
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideWrToastConfig({
+ *       position: 'bottom-end',
+ *       showCopy: true,
+ *       maxStack: 3,
+ *       labels: { close: 'Закрыть', copy: 'Копировать', copied: 'Скопировано', closeAll: 'Закрыть все' },
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+declare function provideWrToastConfig(config: Partial<WrToastConfig>): EnvironmentProviders;
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Library defaults applied when no {@link provideWrToastConfig} call is
+ * registered. Merged shallowly with the consumer's overrides (the `labels`
+ * sub-object is merged separately so callers can override one string at a
+ * time).
+ */
+declare const DEFAULT_TOAST_CONFIG: WrToastConfig;
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+
+/**
+ * Holds the global {@link WrToastConfig} used by {@link WrToast}.
+ * The default factory returns {@link DEFAULT_TOAST_CONFIG} so the service
+ * works out of the box; override via {@link provideWrToastConfig}.
+ */
+declare const WR_TOAST_CONFIG: InjectionToken<WrToastConfig>;
+
+export { DEFAULT_TOAST_CONFIG, WR_TOAST_CONFIG, WrToast, WrToastRef, provideWrToastConfig };
+export type { WrToastConfig, WrToastMode, WrToastOptions, WrToastPosition, WrToastType };

package/types/ngwr-toolbar.d.ts

@@ -0,0 +1,30 @@
+import * as i0 from '@angular/core';
+
+/**
+ * Action bar with three named zones — `[wrToolbarStart]`,
+ * `[wrToolbarCenter]`, `[wrToolbarEnd]`. Use any one or all three.
+ *
+ * @example
+ * ```html
+ * <wr-toolbar>
+ *   <div wrToolbarStart>
+ *     <button wrButton>Back</button>
+ *     <strong>Items</strong>
+ *   </div>
+ *   <div wrToolbarCenter>
+ *     <wr-segmented [(value)]="view" [options]="['grid', 'list']" />
+ *   </div>
+ *   <div wrToolbarEnd>
+ *     <button wrButton color="primary">New</button>
+ *   </div>
+ * </wr-toolbar>
+ * ```
+ *
+ * @see https://ngwr.dev/components/toolbar
+ */
+declare class WrToolbar {
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrToolbar, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WrToolbar, "wr-toolbar", never, {}, {}, never, ["[wrToolbarStart]", "[wrToolbarCenter]", "[wrToolbarEnd]"], true, never>;
+}
+
+export { WrToolbar };

package/types/ngwr-tree.d.ts

@@ -0,0 +1,150 @@
+import * as ngwr_i18n from 'ngwr/i18n';
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+/** A single node in a {@link WrTree}. Nodes are immutable. */
+interface WrTreeNode<TId = string> {
+    readonly id: TId;
+    readonly label: string;
+    readonly children?: readonly WrTreeNode<TId>[];
+    readonly disabled?: boolean;
+}
+/** Selection mode for {@link WrTree}. */
+type WrTreeSelectionMode = 'none' | 'single' | 'multi';
+
+interface FlatNode<TId> {
+    readonly node: WrTreeNode<TId>;
+    readonly depth: number;
+    readonly hasChildren: boolean;
+}
+interface SelectedChip<TId> {
+    readonly id: TId;
+    readonly label: string;
+}
+/**
+ * Hierarchical tree. Data-driven — pass `[nodes]` with optional `children`
+ * arrays. Supports single / multi selection (two-way `[(selected)]`),
+ * controlled expand state (two-way `[(expanded)]`), and full keyboard
+ * navigation.
+ *
+ * Two render shapes, picked by `[openOn]`:
+ * - `'inline'` (default) — renders the tree list in-place. Use as a display
+ *   widget or form-less hierarchical picker.
+ * - `'overlay'` — renders a `<wr-select>`-style trigger button (with chips
+ *   in multi mode) that opens a popover containing the tree. Acts as a
+ *   `ControlValueAccessor` — bind via `[(ngModel)]`, `[formControl]`, or
+ *   `formControlName`. Replaces the standalone `<wr-tree-select>`.
+ *
+ * Value type in `overlay` mode: `TId | null` in single mode,
+ * `readonly TId[]` in multi mode.
+ *
+ * @example
+ * ```html
+ * <!-- Inline tree (display widget) -->
+ * <wr-tree [nodes]="folders" [(selected)]="picked" [(expanded)]="open" />
+ *
+ * <!-- Form-bound combobox -->
+ * <wr-tree
+ *   openOn="overlay"
+ *   [nodes]="folders"
+ *   selectionMode="single"
+ *   [(ngModel)]="picked"
+ *   placeholder="Pick a folder"
+ * />
+ * ```
+ *
+ * @see https://ngwr.dev/components/tree
+ */
+declare class WrTree<TId = string> implements ControlValueAccessor {
+    /** Tree data. */
+    readonly nodes: _angular_core.InputSignal<readonly WrTreeNode<TId>[]>;
+    /** Selected node ids (two-way bindable). */
+    readonly selected: _angular_core.ModelSignal<readonly TId[]>;
+    /** Expanded node ids (two-way bindable). */
+    readonly expanded: _angular_core.ModelSignal<readonly TId[]>;
+    /** Selection behavior. @default 'single' */
+    readonly selectionMode: _angular_core.InputSignal<WrTreeSelectionMode>;
+    /** Disable the whole tree. @default false */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Render shape. @default 'inline' */
+    readonly openOn: _angular_core.InputSignal<"inline" | "overlay">;
+    /** Placeholder shown on the trigger when no node is selected. */
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Show a clear-all (×) button on the trigger when at least one node is selected. @default true */
+    readonly clearable: _angular_core.InputSignalWithTransform<boolean, any>;
+    /**
+     * Cap on the number of chips rendered on the trigger before
+     * collapsing the rest into `+N more` (multi mode only). `0` = render
+     * every chip. @default 0
+     */
+    readonly maxTagCount: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Auto-expand every node that has children on first open of the overlay. @default false */
+    readonly defaultExpandAll: _angular_core.InputSignalWithTransform<boolean, any>;
+    private readonly host;
+    private readonly overlay;
+    private readonly vcr;
+    private readonly scrollStrategies;
+    private readonly destroyRef;
+    /** Currently focused row's index in the flattened visible list. */
+    protected readonly focusedIndex: _angular_core.WritableSignal<number>;
+    /** Resolved ARIA labels — pick up live locale changes via re-render. */
+    protected readonly clearLabel: string;
+    protected readonly expandLabel: string;
+    protected readonly collapseLabel: string;
+    protected readonly chipRemoveLabel: (params?: ngwr_i18n.WrI18nParams) => string;
+    /** Flattened list of currently visible nodes — what the template renders. */
+    protected readonly flat: _angular_core.Signal<readonly FlatNode<TId>[]>;
+    protected readonly selectedSet: _angular_core.Signal<Set<TId>>;
+    protected readonly expandedSet: _angular_core.Signal<Set<TId>>;
+    protected readonly isOverlay: _angular_core.Signal<boolean>;
+    protected readonly isMulti: _angular_core.Signal<boolean>;
+    protected readonly hasSelection: _angular_core.Signal<boolean>;
+    /** Overlay-mode trigger label / chip map. */
+    private readonly labelMap;
+    protected readonly selectedChips: _angular_core.Signal<readonly SelectedChip<TId>[]>;
+    protected readonly visibleChips: _angular_core.Signal<readonly SelectedChip<TId>[]>;
+    protected readonly hiddenChipCount: _angular_core.Signal<number>;
+    protected readonly singleLabel: _angular_core.Signal<string | null>;
+    /** Overlay open state. Only meaningful when `openOn='overlay'`. */
+    protected readonly open: _angular_core.WritableSignal<boolean>;
+    /** Trigger / panel id for `aria-controls`. */
+    protected readonly panelId: string;
+    private readonly disabledFromCva;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly classes: _angular_core.Signal<string>;
+    protected readonly panelTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
+    private overlayRef;
+    private onChange;
+    /** @internal exposed so the trigger can fire on blur. */
+    protected onTouched: () => void;
+    constructor();
+    writeValue(value: unknown): void;
+    registerOnChange(fn: (value: TId | readonly TId[] | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    protected onRowClick(flat: FlatNode<TId>, event: MouseEvent): void;
+    protected onToggleClick(node: WrTreeNode<TId>, event: MouseEvent): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    protected onTriggerClick(): void;
+    protected removeChip(id: TId, event: Event): void;
+    protected clearSelection(event: Event): void;
+    private toggleExpanded;
+    private select;
+    private emit;
+    private focusIndex;
+    private collectExpandableIds;
+    private openOverlay;
+    private closeOverlay;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrTree<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrTree<any>, "wr-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "openOn": { "alias": "openOn"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "maxTagCount": { "alias": "maxTagCount"; "required": false; "isSignal": true; }; "defaultExpandAll": { "alias": "defaultExpandAll"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; "expanded": "expandedChange"; }, never, never, true, never>;
+}
+
+export { WrTree };
+export type { WrTreeNode, WrTreeSelectionMode };

package/types/ngwr-typewriter.d.ts

@@ -0,0 +1,84 @@
+import * as _angular_core from '@angular/core';
+
+interface WrTypewriterVariableSpeed {
+    readonly min: number;
+    readonly max: number;
+}
+
+/**
+ * Classic typewriter — types out a string char-by-char, optionally
+ * deletes it, then types the next string. Cycles through `[texts]` (or
+ * a single string) with a blinking cursor.
+ *
+ * @example
+ * ```html
+ * <wr-typewriter [texts]="['design.', 'ship.', 'iterate.']" />
+ * <wr-typewriter
+ *   text="Hello, ngwr."
+ *   [loop]="false"
+ *   [typingSpeed]="35"
+ *   cursorCharacter="▎"
+ * />
+ * ```
+ *
+ * @see https://www.reactbits.dev/text-animations/text-type
+ */
+declare class WrTypewriter {
+    /** Single string. Use either `text` or `texts`. */
+    readonly text: _angular_core.InputSignal<string | undefined>;
+    /** Strings to cycle. Use either `text` or `texts`. */
+    readonly texts: _angular_core.InputSignal<readonly string[] | undefined>;
+    /** Per-char typing speed in ms. @default 50 */
+    readonly typingSpeed: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Initial delay before typing starts, in ms. @default 0 */
+    readonly initialDelay: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Pause between sentences (after typing complete, before deleting), in ms. @default 2000 */
+    readonly pauseDuration: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Per-char deletion speed in ms. @default 30 */
+    readonly deletingSpeed: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Loop back to the first string after the last. @default true */
+    readonly loop: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Show the cursor. @default true */
+    readonly showCursor: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Hide the cursor while typing / deleting. @default false */
+    readonly hideCursorWhileTyping: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Cursor glyph. @default '|' */
+    readonly cursorCharacter: _angular_core.InputSignal<string>;
+    /** Cursor blink half-cycle in seconds. @default 0.5 */
+    readonly cursorBlinkDuration: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Cycle through these colours per string. */
+    readonly textColors: _angular_core.InputSignal<readonly string[]>;
+    /** Randomise typing speed per char between `min` and `max`. */
+    readonly variableSpeed: _angular_core.InputSignal<WrTypewriterVariableSpeed | undefined>;
+    /** Reverse the string (type it backwards). @default false */
+    readonly reverseMode: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Start typing only after the host enters the viewport. @default false */
+    readonly startOnVisible: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Emits with `(text, index)` when a string finishes typing. */
+    readonly sentenceComplete: _angular_core.OutputEmitterRef<{
+        text: string;
+        index: number;
+    }>;
+    protected readonly displayed: _angular_core.WritableSignal<string>;
+    protected readonly cursorVisible: _angular_core.Signal<boolean>;
+    protected readonly activeColor: _angular_core.Signal<string>;
+    /** Resolved list of strings (either `texts` or wrap `text` in an array). */
+    private readonly textArray;
+    private readonly currentTextIndex;
+    private readonly phase;
+    private readonly host;
+    private readonly destroyRef;
+    private readonly isBrowser;
+    private readonly platform;
+    private timer;
+    private isVisible;
+    constructor();
+    private boot;
+    private scheduleNext;
+    private tick;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrTypewriter, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrTypewriter, "wr-typewriter", never, { "text": { "alias": "text"; "required": false; "isSignal": true; }; "texts": { "alias": "texts"; "required": false; "isSignal": true; }; "typingSpeed": { "alias": "typingSpeed"; "required": false; "isSignal": true; }; "initialDelay": { "alias": "initialDelay"; "required": false; "isSignal": true; }; "pauseDuration": { "alias": "pauseDuration"; "required": false; "isSignal": true; }; "deletingSpeed": { "alias": "deletingSpeed"; "required": false; "isSignal": true; }; "loop": { "alias": "loop"; "required": false; "isSignal": true; }; "showCursor": { "alias": "showCursor"; "required": false; "isSignal": true; }; "hideCursorWhileTyping": { "alias": "hideCursorWhileTyping"; "required": false; "isSignal": true; }; "cursorCharacter": { "alias": "cursorCharacter"; "required": false; "isSignal": true; }; "cursorBlinkDuration": { "alias": "cursorBlinkDuration"; "required": false; "isSignal": true; }; "textColors": { "alias": "textColors"; "required": false; "isSignal": true; }; "variableSpeed": { "alias": "variableSpeed"; "required": false; "isSignal": true; }; "reverseMode": { "alias": "reverseMode"; "required": false; "isSignal": true; }; "startOnVisible": { "alias": "startOnVisible"; "required": false; "isSignal": true; }; }, { "sentenceComplete": "sentenceComplete"; }, never, never, true, never>;
+}
+
+export { WrTypewriter };
+export type { WrTypewriterVariableSpeed };

package/types/ngwr-typography.d.ts

@@ -0,0 +1,56 @@
+import * as _angular_core from '@angular/core';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+/** Semantic + display variants for {@link WrTypography}. */
+type WrTypographyVariant = 'display' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'lead' | 'body' | 'small' | 'caption' | 'overline' | 'code' | 'list' | 'link';
+/** Horizontal alignment. */
+type WrTypographyAlign = 'start' | 'center' | 'end' | 'justify';
+/** Color tone — maps to a `--wr-color-*` token. */
+type WrTypographyTone = 'dark' | 'medium' | 'primary' | 'success' | 'warning' | 'danger';
+
+/**
+ * Semantic typography directive. Attaches to any native element and
+ * applies the visual treatment for the chosen `variant` (`h1`–`h6`,
+ * `display`, `lead`, `body`, `small`, `caption`, `overline`, `code`).
+ *
+ * Reads from the same `--wr-text-*` / `--wr-font-weight-*` / `--wr-leading-*`
+ * tokens used by the opt-in typography utility classes — themeable by
+ * overriding tokens at `:root`.
+ *
+ * @example
+ * ```html
+ * <h1 wrTypography variant="display">Build interfaces</h1>
+ * <h2 wrTypography variant="h2" tone="primary">that feel alive.</h2>
+ * <p wrTypography variant="lead">A developer-first library.</p>
+ * <span wrTypography variant="caption" tone="medium">v1.6.0 — released today</span>
+ * <code wrTypography variant="code">inject(WrTheme)</code>
+ * ```
+ *
+ * @see https://ngwr.dev/typography/overview
+ */
+declare class WrTypography {
+    /** Visual variant. @default 'body' */
+    readonly variant: _angular_core.InputSignal<WrTypographyVariant>;
+    /**
+     * Color tone. `null` (default) keeps the variant's own color — the base
+     * dark for headings/body, medium for lead/caption, primary for links.
+     */
+    readonly tone: _angular_core.InputSignal<WrTypographyTone | null>;
+    /** Horizontal alignment. */
+    readonly align: _angular_core.InputSignal<WrTypographyAlign | null>;
+    /** Truncate to single line with ellipsis. @default false */
+    readonly truncate: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Render with monospace font. @default false (auto-true for `code`) */
+    readonly mono: _angular_core.InputSignalWithTransform<boolean, any>;
+    protected readonly classes: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrTypography, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrTypography, "[wrTypography]", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "truncate": { "alias": "truncate"; "required": false; "isSignal": true; }; "mono": { "alias": "mono"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { WrTypography };
+export type { WrTypographyAlign, WrTypographyTone, WrTypographyVariant };