ngwr 6.1.1 → 7.0.0

package/types/ngwr-icon-adapters-lucide.d.ts

@@ -0,0 +1,54 @@
+import { WrIconDef } from 'ngwr/icon';
+
+/**
+ * @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
+ */
+
+/**
+ * Shape of a `lucide` icon export — an array of `[tag, attrs]` tuples
+ * representing the inner SVG children. The outer `<svg>` wrapper is
+ * added by the adapter when converting to a {@link WrIconDef}.
+ */
+type LucideIconNode = readonly (readonly [string, Record<string, string | number | undefined>])[];
+/**
+ * Wrap a single Lucide icon in the {@link WrIconDef} envelope. Use this
+ * when you need fine-grained control over the registered name, or when
+ * the bulk {@link lucideIcons} helper isn't a good fit.
+ *
+ * @example
+ * ```ts
+ * import { Plus } from 'lucide';
+ * import { lucide } from 'ngwr/icon/adapters/lucide';
+ *
+ * provideWrIcons([lucide('plus', Plus)]);
+ * ```
+ */
+declare function lucide(name: string, children: LucideIconNode): WrIconDef;
+/**
+ * Wrap a bag of Lucide icons in one shot. Keys become the registered
+ * names (camelCase → kebab-case), values are the upstream IconNode
+ * tuples. The shape mirrors how you'd write `provideWrIcons` anyway.
+ *
+ * Tree-shaking: every `Plus`, `Trash`, … import lives in *your* file
+ * — ngwr ships only this wrapper, not the icon data. Unused icons in
+ * `lucide` itself get dropped by the bundler.
+ *
+ * @example
+ * ```ts
+ * import { Plus, Trash, ChevronDown } from 'lucide';
+ * import { lucideIcons } from 'ngwr/icon/adapters/lucide';
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideWrIcons(lucideIcons({ plus: Plus, trash: Trash, chevronDown: ChevronDown })),
+ *   ],
+ * });
+ * ```
+ */
+declare function lucideIcons(icons: Record<string, LucideIconNode>): WrIconDef[];
+
+export { lucide, lucideIcons };
+export type { LucideIconNode };

package/types/ngwr-icon.d.ts

@@ -0,0 +1,180 @@
+import * as i0 from '@angular/core';
+import { Provider } from '@angular/core';
+
+/**
+ * Renders a registered SVG icon.
+ *
+ * Icons must be registered via {@link provideWrIcons} before use —
+ * either at the application root or on any ancestor component.
+ *
+ * @example
+ * ```html
+ * <wr-icon name="home" />
+ * ```
+ *
+ * @see https://ngwr.dev/components/icon
+ */
+declare class WrIcon {
+    readonly name: i0.InputSignal<string>;
+    private readonly host;
+    /**
+     * Merged view of every `WR_ICONS` multi-provider visible from this
+     * injector position — element-level first overlay, environment-level
+     * (app/lazy-route bootstrap) as the base.
+     *
+     * Angular's default `inject(WR_ICONS)` only returns the **closest**
+     * injector's contribution; if a component declares its own
+     * `provideWrIcons(...)`, the root registration is **shadowed**, not
+     * appended. That contradicts the docstring's "each call adds to the
+     * registry" promise and silently breaks any page that overrides while
+     * still relying on root-registered icons.
+     *
+     * We work around it by also asking the environment injector directly
+     * (`envInjector.get(WR_ICONS, null, …)`). When no element-level
+     * provider exists both calls return the same array reference and we
+     * skip the redundant pass. Otherwise we lay element on top of env so
+     * a page's local icons can override a root-registered name.
+     *
+     * One known limitation: multiple element-injector levels in between
+     * still shadow each other — but the showcase doesn't nest providers
+     * that deep, and the env+local merge fixes the dominant case.
+     */
+    private readonly iconSets;
+    private readonly registry;
+    private readonly icon;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrIcon, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WrIcon, "wr-icon", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * @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
+ */
+/**
+ * Any icon name registered via {@link provideWrIcons}.
+ *
+ * Kept as a string alias so consumers can pass any name they've wired
+ * — there are no built-ins shipped by ngwr. Bring an icon set via one
+ * of the adapters under `ngwr/icon/adapters/<set>` or via `svgIcon()`.
+ */
+type WrIconName = 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
+ */
+
+/**
+ * Shape of an icon registered with the icon registry.
+ *
+ * The library ships a set of built-in icons, but consumers can also
+ * provide their own custom icons with the same shape.
+ *
+ * @example
+ * ```ts
+ * const myIcon: WrIconDef = {
+ *   name: 'my-custom-logo',
+ *   data: '<svg viewBox="0 0 24 24">...</svg>',
+ * };
+ *
+ * provideWrIcons([myIcon]);
+ * ```
+ */
+interface WrIconDef {
+    name: WrIconName;
+    data: 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
+ */
+
+/**
+ * Registers a set of icons for use by `<wr-icon>`.
+ *
+ * Can be called multiple times — each call adds to the registry.
+ * Works at both the application root and at the component level,
+ * so a feature module or a single component can bring its own icons
+ * without polluting the global config.
+ *
+ * In dev mode, each icon is validated for common issues (missing
+ * `viewBox`, malformed root). Validation is dropped from production
+ * builds via `isDevMode()` tree-shaking.
+ *
+ * @example
+ * ```ts
+ * // App-level registration
+ * import { home, user, cog, provideWrIcons } from 'ngwr/icon';
+ *
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideWrIcons([home, user, cog]),
+ *   ],
+ * };
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Component-level registration
+ * import { logoGithub, logoNpm, provideWrIcons, WrIconDef } from 'ngwr/icon';
+ *
+ * @Component({
+ *   selector: 'ngwr-header',
+ *   imports: [WrIcon],
+ *   providers: [provideWrIcons([logoGithub, logoNpm])],
+ *   template: `<wr-icon name="logo-github" />`,
+ * })
+ * export class HeaderComponent {}
+ * ```
+ */
+declare function provideWrIcons(icons: WrIconDef[]): Provider[];
+
+/**
+ * @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
+ */
+
+/**
+ * Wrap a raw SVG string in the {@link WrIconDef} envelope. Use this when
+ * importing icons from sources that ship full `<svg>` files — Tabler,
+ * Phosphor, Heroicons, Iconoir, Radix, Bootstrap Icons, your designer.
+ *
+ * Pair with a bundler's raw-SVG import (Vite's `?raw`, Webpack's
+ * `raw-loader`, esbuild's `--loader:.svg=text`) so the SVG file becomes
+ * a string at build time.
+ *
+ * For sets with a non-SVG shape (Lucide's IconNode tuples, Feather's
+ * inner-only SVG), use the dedicated adapter under
+ * `ngwr/icon/adapters/<set>` instead.
+ *
+ * @example
+ * ```ts
+ * import { svgIcon, provideWrIcons } from 'ngwr/icon';
+ * // Vite: the `?raw` suffix returns the file as a string.
+ * import plusSvg from '@tabler/icons/icons/plus.svg?raw';
+ * import phosphorPlusSvg from '@phosphor-icons/core/assets/regular/plus.svg?raw';
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideWrIcons([
+ *       svgIcon('plus', plusSvg),
+ *       svgIcon('plus-phosphor', phosphorPlusSvg),
+ *     ]),
+ *   ],
+ * });
+ * ```
+ */
+declare function svgIcon(name: string, svg: string): WrIconDef;
+
+export { WrIcon, provideWrIcons, svgIcon };
+export type { WrIconDef, WrIconName };

package/types/ngwr-image-cropper.d.ts

@@ -0,0 +1,110 @@
+import * as _angular_core from '@angular/core';
+import { ElementRef } 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
+ */
+/** Crop rectangle in source-image (natural) pixel coordinates. */
+interface WrCropRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/** Possible drag handles on the crop overlay. */
+type WrCropHandle = 'move' | 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw';
+/** Supported output MIME types for {@link WrImageCropper.toBlob}. */
+type WrImageOutputType = 'image/png' | 'image/jpeg' | 'image/webp';
+
+interface RectPx {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/**
+ * Image crop UI. Pass `[src]` (URL, `File`, or `Blob`); the user drags
+ * the crop window or any of its eight handles. Optionally lock the crop
+ * to a fixed `[aspectRatio]`.
+ *
+ * `(cropped)` fires after each drag end with a freshly-rendered `Blob`
+ * of the cropped region. For one-off reads use `toBlob()` / `toDataUrl()`.
+ *
+ * @example
+ * ```html
+ * <wr-image-cropper
+ *   [src]="file"
+ *   [aspectRatio]="1"
+ *   (cropped)="onBlob($event)"
+ * />
+ * ```
+ *
+ * @see https://ngwr.dev/components/image-cropper
+ */
+declare class WrImageCropper {
+    /** Image source — URL string, `File`, or `Blob`. */
+    readonly src: _angular_core.InputSignal<string | File | Blob | null>;
+    /** Aspect ratio (width / height). `null` = free. @default null */
+    readonly aspectRatio: _angular_core.InputSignal<number | null>;
+    /** Minimum crop width in display pixels. @default 32 */
+    readonly minWidth: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Minimum crop height in display pixels. @default 32 */
+    readonly minHeight: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Default output type for `(cropped)`. @default 'image/png' */
+    readonly outputType: _angular_core.InputSignal<WrImageOutputType>;
+    /** JPEG / WebP quality for `(cropped)` in [0, 1]. @default 0.92 */
+    readonly outputQuality: _angular_core.InputSignal<number>;
+    /** Emits a Blob after each drag end. */
+    readonly cropped: _angular_core.OutputEmitterRef<Blob>;
+    protected readonly imgEl: _angular_core.Signal<ElementRef<HTMLImageElement>>;
+    /** Resolved object URL for `src` (so File / Blob render in `<img>`). */
+    protected readonly objectUrl: _angular_core.WritableSignal<string | null>;
+    /** Previous object URL we created — kept off-signal so the resolve
+     *  effect doesn't depend on its own writes (which would loop). */
+    private previousObjectUrl;
+    /** Natural (source) pixel dimensions. */
+    protected readonly natural: _angular_core.WritableSignal<{
+        w: number;
+        h: number;
+    }>;
+    /** Display (rendered) pixel dimensions. */
+    protected readonly display: _angular_core.WritableSignal<{
+        w: number;
+        h: number;
+    }>;
+    /** Crop rect in display coordinates. */
+    protected readonly cropDisplay: _angular_core.WritableSignal<RectPx>;
+    /** Currently active drag handle. */
+    private active;
+    private startPointer;
+    private startRect;
+    private readonly destroyRef;
+    /** Resolved crop rect in natural (source) pixel coordinates. */
+    readonly cropRect: _angular_core.Signal<WrCropRect>;
+    constructor();
+    protected onImageLoad(): void;
+    /** Compute a sensible initial crop — centered, respecting aspectRatio. */
+    private initialCrop;
+    protected readonly handles: readonly WrCropHandle[];
+    protected onPointerDown(handle: WrCropHandle, event: PointerEvent): void;
+    protected onPointerMove(event: PointerEvent): void;
+    protected onPointerUp(event: PointerEvent): void;
+    private applyMove;
+    private applyResize;
+    /** Render the current crop as a Blob. */
+    toBlob(type?: WrImageOutputType, quality?: number): Promise<Blob>;
+    /** Render the current crop as a data URL. */
+    toDataUrl(type?: WrImageOutputType, quality?: number): string;
+    /** Re-emit the crop without waiting for a drag (e.g. after a programmatic change). */
+    refresh(): Promise<void>;
+    private toCanvas;
+    private emitCropped;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrImageCropper, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrImageCropper, "wr-image-cropper", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "minHeight": { "alias": "minHeight"; "required": false; "isSignal": true; }; "outputType": { "alias": "outputType"; "required": false; "isSignal": true; }; "outputQuality": { "alias": "outputQuality"; "required": false; "isSignal": true; }; }, { "cropped": "cropped"; }, never, never, true, never>;
+}
+
+export { WrImageCropper };
+export type { WrCropHandle, WrCropRect, WrImageOutputType };

package/types/ngwr-input-number.d.ts

@@ -0,0 +1,77 @@
+import * as _angular_core from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+
+/**
+ * Numeric input with locale-aware formatting + ▲▼ stepper buttons.
+ *
+ * Implements `ControlValueAccessor` — value type is `number | null`.
+ * Parses leniently while typing (allows partial input like `"1."` or `"-"`),
+ * re-formats with grouping + fixed decimals on blur.
+ *
+ * Locale comes from Angular's `LOCALE_ID` — input-number intentionally does
+ * NOT depend on `ngwr/date-adapter` so it can be used in date-free apps.
+ *
+ * @example
+ * ```html
+ * <wr-input-number [(ngModel)]="qty" [min]="0" [max]="100" />
+ * <wr-input-number [(ngModel)]="price" [decimals]="2" suffix="USD" />
+ * ```
+ *
+ * @see https://ngwr.dev/components/input-number
+ */
+declare class WrInputNumber implements ControlValueAccessor {
+    /** Minimum allowed value. @default -Infinity */
+    readonly min: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Maximum allowed value. @default Infinity */
+    readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Step used by stepper buttons + arrow keys. @default 1 */
+    readonly step: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Fixed number of decimals shown on blur. `null` keeps the entered precision. @default null */
+    readonly decimals: _angular_core.InputSignal<number | null>;
+    /** Render the ▲▼ stepper column. @default true */
+    readonly showSteppers: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Optional prefix label (e.g. `"$"`). */
+    readonly prefix: _angular_core.InputSignal<string>;
+    /** Optional suffix label (e.g. `"kg"`). */
+    readonly suffix: _angular_core.InputSignal<string>;
+    /** Placeholder shown when the input is empty. */
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Disable interaction. @default false */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Read-only — values cannot be changed (steppers + typing disabled). @default false */
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, any>;
+    private readonly locale;
+    private readonly separators;
+    /** Current numeric value mirrored from the CVA. */
+    protected readonly value: _angular_core.WritableSignal<number | null>;
+    /** Text currently in the input (may be partial / invalid mid-type). */
+    protected readonly text: _angular_core.WritableSignal<string>;
+    private readonly disabledFromCva;
+    protected readonly effectiveDisabled: _angular_core.Signal<boolean>;
+    protected readonly interactive: _angular_core.Signal<boolean>;
+    protected readonly atMin: _angular_core.Signal<boolean>;
+    protected readonly atMax: _angular_core.Signal<boolean>;
+    protected readonly classes: _angular_core.Signal<string>;
+    private onChange;
+    private onTouched;
+    writeValue(value: number | null): void;
+    registerOnChange(fn: (value: number | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    protected onInput(event: Event): void;
+    protected onBlur(): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    protected stepBy(direction: 1 | -1): void;
+    private bump;
+    /** Choose a sensible starting point when bumping from `null`. */
+    private fallbackBase;
+    private constrain;
+    /** Parse a locale-formatted string. Returns `null` for partial / not-yet-numeric input. */
+    private parse;
+    /** Format a value using `Intl.NumberFormat` for the active locale. */
+    private format;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrInputNumber, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrInputNumber, "wr-input-number", never, { "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "decimals": { "alias": "decimals"; "required": false; "isSignal": true; }; "showSteppers": { "alias": "showSteppers"; "required": false; "isSignal": true; }; "prefix": { "alias": "prefix"; "required": false; "isSignal": true; }; "suffix": { "alias": "suffix"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { WrInputNumber };

package/types/ngwr-input-otp.d.ts

@@ -0,0 +1,78 @@
+import * as _angular_core from '@angular/core';
+import { ElementRef } 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
+ */
+/**
+ * Character set accepted by `<wr-input-otp>`:
+ * - `numeric` — digits only (also sets `inputmode="numeric"` so mobile keyboards
+ *   show the number pad)
+ * - `alphanumeric` — letters + digits
+ * - `text` — any single character per cell
+ */
+type WrInputOtpMode = 'numeric' | 'alphanumeric' | 'text';
+
+/**
+ * Fixed-length one-time-code input. Renders one `<input>` per character,
+ * auto-advances focus on typing, handles paste of a full code, and supports
+ * masking like a password field.
+ *
+ * Implements `ControlValueAccessor` — emits the joined string through
+ * `[(ngModel)]` / `formControl`. Emits `completed` once all cells are
+ * filled (useful for auto-submission).
+ *
+ * @example
+ * ```html
+ * <wr-input-otp [(ngModel)]="code" length="6" (completed)="verify($event)" />
+ * ```
+ *
+ * @see https://ngwr.dev/components/input-otp
+ */
+declare class WrInputOtp implements ControlValueAccessor {
+    /** Number of cells to render. Clamped to `[1, 20]`. @default 6 */
+    readonly length: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Character set per cell. @default 'numeric' */
+    readonly mode: _angular_core.InputSignal<WrInputOtpMode>;
+    /** Mask the typed characters like a password. @default false */
+    readonly mask: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Disable interaction. @default false */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Character shown in empty cells. @default '•' */
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Fires once when every cell holds a character. */
+    readonly completed: _angular_core.OutputEmitterRef<string>;
+    protected readonly cells: _angular_core.WritableSignal<readonly string[]>;
+    private readonly disabledFromCva;
+    protected readonly effectiveDisabled: _angular_core.Signal<boolean>;
+    protected readonly classes: _angular_core.Signal<string>;
+    protected readonly cellType: _angular_core.Signal<"text" | "password">;
+    protected readonly cellInputMode: _angular_core.Signal<"numeric" | "text">;
+    protected readonly cellRefs: _angular_core.Signal<readonly ElementRef<HTMLInputElement>[]>;
+    constructor();
+    private onChange;
+    private onTouched;
+    writeValue(v: string | null): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    protected onInput(event: Event, index: number): void;
+    protected onKeyDown(event: KeyboardEvent, index: number): void;
+    protected onPaste(event: ClipboardEvent): void;
+    protected onBlur(): void;
+    protected trackIndex(index: number): number;
+    private update;
+    private emitChange;
+    private focusCell;
+    /** Drop a character that doesn't match the configured mode. */
+    private sanitiseChar;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrInputOtp, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrInputOtp, "wr-input-otp", never, { "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, { "completed": "completed"; }, never, never, true, never>;
+}
+
+export { WrInputOtp };
+export type { WrInputOtpMode };

package/types/ngwr-input.d.ts

@@ -0,0 +1,131 @@
+import * as i0 from '@angular/core';
+
+/**
+ * Applies NGWR input styling to a native `<input>` element.
+ *
+ * Because this is an attribute directive on the real `<input>` (not a wrapper
+ * component), any other directive that targets `input` — `[(ngModel)]`,
+ * `[formControl]`, validators, third-party libraries like `ngx-mask` — composes
+ * naturally on the same element.
+ *
+ * @example
+ * ```html
+ * <input wrInput [(ngModel)]="name" placeholder="Your name" />
+ *
+ * <!-- Works with ngx-mask, validators, etc. -->
+ * <input wrInput [(ngModel)]="phone" mask="(000) 000-0000" />
+ * ```
+ *
+ * For prefix / suffix / password-toggle layouts, wrap the input in
+ * `<wr-input-group>`.
+ *
+ * @see https://ngwr.dev/components/input
+ */
+declare class WrInput {
+    /** Pill-shaped corners. @default false */
+    readonly rounded: i0.InputSignalWithTransform<boolean, any>;
+    protected readonly classes: i0.Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrInput, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<WrInput, "input[wrInput], textarea[wrInput]", never, { "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Marks an element as the **left** decoration inside `<wr-input-group>`.
+ * Adds the `.wr-input-group__affix` class so the group's layout flexes it
+ * to the input's left edge.
+ *
+ * @example
+ * ```html
+ * <wr-input-group>
+ *   <span wrInputPrefix>$</span>
+ *   <input wrInput [(ngModel)]="amount" type="number" />
+ * </wr-input-group>
+ * ```
+ */
+declare class WrInputPrefix {
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrInputPrefix, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<WrInputPrefix, "[wrInputPrefix]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Marks an element as the **right** decoration inside `<wr-input-group>`.
+ * Adds the `.wr-input-group__affix` class so the group's layout flexes it
+ * to the input's right edge.
+ *
+ * @example
+ * ```html
+ * <wr-input-group>
+ *   <input wrInput [(ngModel)]="amount" type="number" />
+ *   <span wrInputSuffix>USD</span>
+ * </wr-input-group>
+ * ```
+ */
+declare class WrInputSuffix {
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrInputSuffix, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<WrInputSuffix, "[wrInputSuffix]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Container for `<input wrInput>` + `[wrInputPrefix]` / `[wrInputSuffix]` /
+ * `<wr-password-toggle>` siblings. Renders the border and focus ring; the
+ * inner native input drops its own border so it visually melts into the
+ * group.
+ *
+ * Pure layout — no signals shared with the inner directive, focus styling is
+ * driven entirely by `:focus-within` so any focusable child counts.
+ *
+ * @example
+ * ```html
+ * <wr-input-group>
+ *   <span wrInputPrefix>$</span>
+ *   <input wrInput [(ngModel)]="amount" type="number" />
+ *   <span wrInputSuffix>USD</span>
+ * </wr-input-group>
+ * ```
+ *
+ * @see https://ngwr.dev/components/input
+ */
+declare class WrInputGroup {
+    /** Pill-shaped corners. @default false */
+    readonly rounded: i0.InputSignalWithTransform<boolean, any>;
+    protected readonly classes: i0.Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrInputGroup, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WrInputGroup, "wr-input-group", never, { "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Self-contained eye-toggle button. Flips the linked `<input>`'s `type`
+ * attribute between `password` and `text`. Drop it inside an
+ * `<wr-input-group>` next to a password input.
+ *
+ * @example
+ * ```html
+ * <wr-input-group>
+ *   <input wrInput type="password" [(ngModel)]="pw" #pwInput />
+ *   <wr-password-toggle [for]="pwInput" />
+ * </wr-input-group>
+ * ```
+ */
+declare class WrPasswordToggle {
+    /** Reference to the linked password input. */
+    readonly for: i0.InputSignal<HTMLInputElement>;
+    protected readonly revealed: i0.WritableSignal<boolean>;
+    protected readonly ariaLabel: i0.Signal<"Hide password" | "Show password">;
+    protected toggle(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WrPasswordToggle, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WrPasswordToggle, "wr-password-toggle", never, { "for": { "alias": "for"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * @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
+ */
+/**
+ * Native input `type` values supported by `<wr-input>`.
+ */
+type WrInputType = 'text' | 'number' | 'password' | 'email' | 'search' | 'tel' | 'url';
+
+export { WrInput, WrInputGroup, WrInputPrefix, WrInputSuffix, WrPasswordToggle };
+export type { WrInputType };

package/types/ngwr-keyboard.d.ts

@@ -0,0 +1,34 @@
+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
+ */
+/** Visual size variant. */
+type WrKbdSize = 'sm' | 'md' | 'lg';
+
+/**
+ * Tiny keycap chip — renders projected content (`⌘`, `K`, `Enter`, etc.) in
+ * a beveled rectangle that reads as a physical key. Stack multiple `<wr-kbd>`
+ * with a plain `+` between them for chords.
+ *
+ * @example
+ * ```html
+ * <wr-kbd>⌘</wr-kbd> + <wr-kbd>K</wr-kbd>
+ * <wr-kbd size="lg">Esc</wr-kbd>
+ * ```
+ *
+ * @see https://ngwr.dev/components/keyboard
+ */
+declare class WrKbd {
+    /** Visual size variant. @default 'md' */
+    readonly size: _angular_core.InputSignal<WrKbdSize>;
+    protected readonly classes: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrKbd, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrKbd, "wr-kbd", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { WrKbd };
+export type { WrKbdSize };