ngwr 6.1.1 → 7.0.0

package/types/ngwr-drawer.d.ts

@@ -0,0 +1,155 @@
+import * as _angular_core from '@angular/core';
+import { TemplateRef } 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
+ */
+/** Side of the viewport the drawer slides in from. */
+type WrDrawerPosition = 'left' | 'right' | 'top' | 'bottom';
+
+/**
+ * Side panel that slides in from an edge of the viewport. Two-way binds
+ * `open` and renders into a CDK overlay so it sits above page content.
+ *
+ * Compose the body with `<wrDrawerTitle>`, `<wrDrawerContent>`, and
+ * `<wrDrawerFooter>` directives.
+ *
+ * @example
+ * ```html
+ * <wr-drawer [(open)]="settingsOpen" position="right" width="24rem">
+ *   <h2 wrDrawerTitle>Settings</h2>
+ *   <div wrDrawerContent>...</div>
+ *   <div wrDrawerFooter>
+ *     <wr-btn wrDrawerClose>Close</wr-btn>
+ *   </div>
+ * </wr-drawer>
+ * ```
+ *
+ * @see https://ngwr.dev/components/drawer
+ */
+declare class WrDrawer {
+    /** Two-way bindable open state. */
+    readonly open: _angular_core.ModelSignal<boolean>;
+    /** Side the drawer slides in from. @default 'right' */
+    readonly position: _angular_core.InputSignal<WrDrawerPosition>;
+    /** Width when position is left/right. Any CSS length. @default '20rem' */
+    readonly width: _angular_core.InputSignal<string>;
+    /** Height when position is top/bottom. Any CSS length. @default '16rem' */
+    readonly height: _angular_core.InputSignal<string>;
+    /**
+     * Upper cap on height (top/bottom positions). Useful for bottom sheets
+     * that should grow with content up to a viewport-relative max.
+     * Any CSS length. @default null (no cap)
+     */
+    readonly maxHeight: _angular_core.InputSignal<string | null>;
+    /**
+     * Round the leading corners — the edge facing the viewport interior.
+     * Common bottom-sheet styling. @default false
+     */
+    readonly rounded: _angular_core.InputSignalWithTransform<boolean, any>;
+    /**
+     * Render a grab handle at the leading edge. Visual affordance for
+     * "swipe to dismiss" patterns. Cosmetic — no swipe logic attached.
+     * @default false
+     */
+    readonly showHandle: _angular_core.InputSignalWithTransform<boolean, any>;
+    /**
+     * Pad the trailing edge with `env(safe-area-inset-*)` so content
+     * doesn't sit under the iOS home indicator. @default false
+     */
+    readonly safeArea: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Show the dimming backdrop. @default true */
+    readonly hasBackdrop: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Close when the backdrop is clicked. @default true */
+    readonly closeOnBackdropClick: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Close on Escape. @default true */
+    readonly closeOnEscape: _angular_core.InputSignalWithTransform<boolean, any>;
+    protected readonly panelTpl: _angular_core.Signal<TemplateRef<any>>;
+    protected panelClass(): string;
+    private readonly overlay;
+    private readonly vcr;
+    private readonly destroyRef;
+    private readonly focusTrapFactory;
+    private readonly isBrowser;
+    private overlayRef;
+    private focusTrap;
+    private previouslyFocused;
+    constructor();
+    private openOverlay;
+    private closeOverlay;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDrawer, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrDrawer, "wr-drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "showHandle": { "alias": "showHandle"; "required": false; "isSignal": true; }; "safeArea": { "alias": "safeArea"; "required": false; "isSignal": true; }; "hasBackdrop": { "alias": "hasBackdrop"; "required": false; "isSignal": true; }; "closeOnBackdropClick": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
+}
+
+/**
+ * Marks an element as the drawer's title row. Applies the `wr-drawer__title`
+ * class so the drawer's stylesheet can lay it out alongside content and
+ * footer slots. Auto-assigns an `id` so the drawer panel references it via
+ * `aria-labelledby`.
+ *
+ * @example
+ * ```html
+ * <wr-drawer [(open)]="open">
+ *   <h2 wrDrawerTitle>Settings</h2>
+ *   <div wrDrawerContent>…</div>
+ * </wr-drawer>
+ * ```
+ */
+declare class WrDrawerTitle {
+    /** Generated id used by the drawer panel for `aria-labelledby`. */
+    readonly id: string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDrawerTitle, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrDrawerTitle, "[wrDrawerTitle]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Marks the scrollable body of the drawer. Applies the `wr-drawer__content`
+ * class so the panel's flex layout can stretch it between the title and the
+ * footer.
+ */
+declare class WrDrawerContent {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDrawerContent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrDrawerContent, "[wrDrawerContent]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Marks the action row pinned to the bottom of the drawer. Adds the
+ * `wr-drawer__footer` class plus an alignment modifier so action buttons
+ * can sit at the start, center, or end of the row.
+ *
+ * @example
+ * ```html
+ * <div wrDrawerFooter align="end">
+ *   <wr-btn wrDrawerClose>Cancel</wr-btn>
+ *   <wr-btn color="primary" (click)="save()">Save</wr-btn>
+ * </div>
+ * ```
+ */
+declare class WrDrawerFooter {
+    /** Horizontal alignment of footer content. @default 'end' */
+    readonly align: _angular_core.InputSignal<"center" | "start" | "end">;
+    protected readonly classes: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDrawerFooter, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrDrawerFooter, "[wrDrawerFooter]", never, { "align": { "alias": "align"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Closes the parent drawer on click. Attach to any clickable element.
+ *
+ * @example
+ * ```html
+ * <wr-btn wrDrawerClose>Close</wr-btn>
+ * ```
+ */
+declare class WrDrawerClose {
+    private readonly drawer;
+    protected close(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDrawerClose, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrDrawerClose, "[wrDrawerClose]", never, {}, {}, never, never, true, never>;
+}
+
+export { WrDrawer, WrDrawerClose, WrDrawerContent, WrDrawerFooter, WrDrawerTitle };
+export type { WrDrawerPosition };

package/types/ngwr-dropdown.d.ts

@@ -0,0 +1,124 @@
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+
+/**
+ * Holds the menu content rendered when a {@link WrDropdown} opens.
+ *
+ * The component itself doesn't render anywhere — the directive grabs its
+ * internal `<ng-template>` and portals it into an overlay.
+ *
+ * @example
+ * ```html
+ * <button [wrDropdown]="menu">Actions</button>
+ * <wr-dropdown-menu #menu>
+ *   <wr-dropdown-item icon="copy">Copy</wr-dropdown-item>
+ *   <wr-dropdown-item icon="trash">Delete</wr-dropdown-item>
+ * </wr-dropdown-menu>
+ * ```
+ *
+ * @see https://ngwr.dev/components/dropdown
+ */
+declare class WrDropdownMenu {
+    /** The internal template the directive portals into the overlay. @internal */
+    readonly contentTpl: _angular_core.Signal<TemplateRef<any>>;
+    /** Stable id used on the menu element and referenced from the trigger's `aria-controls`. */
+    readonly menuId: _angular_core.WritableSignal<string>;
+    /** Trigger element id, set by the directive for `aria-labelledby` wiring. */
+    readonly triggerId: _angular_core.WritableSignal<string | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDropdownMenu, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrDropdownMenu, "wr-dropdown-menu", ["wrDropdownMenu"], {}, {}, 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
+ */
+
+/**
+ * Where the dropdown menu opens, relative to the trigger.
+ */
+type WrDropdownPosition = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'right';
+
+/**
+ * @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 dropdown menu is opened.
+ */
+type WrDropdownTrigger = 'click' | 'hover';
+
+declare class WrDropdown {
+    /** Menu to open. Pass a `<wr-dropdown-menu>` template reference. */
+    readonly menu: _angular_core.InputSignal<WrDropdownMenu>;
+    /** How the menu opens. @default 'click' */
+    readonly trigger: _angular_core.InputSignal<WrDropdownTrigger>;
+    /** Where the menu anchors relative to the trigger. @default 'bottom-start' */
+    readonly position: _angular_core.InputSignal<WrDropdownPosition>;
+    /** Fires after the menu opens. */
+    readonly opened: _angular_core.OutputEmitterRef<void>;
+    /** Fires after the menu closes. */
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    private readonly host;
+    private readonly overlay;
+    private readonly vcr;
+    private readonly scrollStrategies;
+    private readonly destroyRef;
+    /** @internal Public so host bindings can read it. */
+    readonly isOpen: _angular_core.WritableSignal<boolean>;
+    /** Auto-generated id for `aria-labelledby` wiring on the menu. */
+    protected readonly triggerId: string;
+    private overlayRef;
+    constructor();
+    /** Open the menu. */
+    open(): void;
+    /** Close the menu. */
+    close(): void;
+    /** Toggle the menu. */
+    toggle(): void;
+    /** @internal */
+    protected onClick(event: MouseEvent): void;
+    /** @internal */
+    protected onMouseEnter(): void;
+    /** @internal */
+    protected onMouseLeave(event: MouseEvent): void;
+    private openOverlay;
+    private closeOverlay;
+    /** @internal Trigger keydown — ArrowDown/Up/Enter/Space open the menu. */
+    protected onKeydown(event: KeyboardEvent): void;
+    private handleMenuKeydown;
+    private getItems;
+    private focusItemAt;
+    private readonly onOverlayMouseLeave;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDropdown, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<WrDropdown, "[wrDropdown]", never, { "menu": { "alias": "wrDropdown"; "required": true; "isSignal": true; }; "trigger": { "alias": "trigger"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; }, { "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
+}
+
+/**
+ * Single row inside a `<wr-dropdown-menu>`.
+ *
+ * @example
+ * ```html
+ * <wr-dropdown-item icon="copy" (click)="copy()">Copy</wr-dropdown-item>
+ * <wr-dropdown-item icon="trash" disabled>Delete</wr-dropdown-item>
+ * ```
+ */
+declare class WrDropdownItem {
+    /** Optional leading icon name. @default null */
+    readonly icon: _angular_core.InputSignal<string | null>;
+    /** Disable interaction (suppresses pointer + keyboard). @default false */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
+    protected readonly classes: _angular_core.Signal<string>;
+    private readonly host;
+    /** @internal Keyboard activation — fires the same click consumers bind to. */
+    protected activate(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrDropdownItem, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrDropdownItem, "wr-dropdown-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { WrDropdown, WrDropdownItem, WrDropdownMenu };
+export type { WrDropdownPosition, WrDropdownTrigger };

package/types/ngwr-empty.d.ts

@@ -0,0 +1,38 @@
+import * as _angular_core from '@angular/core';
+
+/**
+ * Empty-state placeholder. Drop into any container where the underlying
+ * data is missing (search yielded nothing, table is empty, etc.).
+ *
+ * Slots:
+ *
+ * - **Default** — primary description / instructions.
+ * - **`[wrEmptyActions]`** — action row rendered below the description.
+ *
+ * Localization: the default headline reads from the `empty.noData` key in
+ * the registered `WrI18n` catalog, falling back to `'No data'` when no
+ * `WrI18n` is provided. The `[title]` input always wins when set.
+ *
+ * @example
+ * ```html
+ * <wr-empty icon="search" title="No results">
+ *   Try a different query or clear filters.
+ *   <ng-container wrEmptyActions>
+ *     <wr-btn (click)="reset()">Reset filters</wr-btn>
+ *   </ng-container>
+ * </wr-empty>
+ * ```
+ *
+ * @see https://ngwr.dev/components/empty
+ */
+declare class WrEmpty {
+    /** Icon name shown above the title. @default 'folder' */
+    readonly icon: _angular_core.InputSignal<string | null>;
+    /** Headline. Falls back to `empty.noData` from WrI18n, then `'No data'`. */
+    readonly title: _angular_core.InputSignal<string | null>;
+    protected readonly resolvedTitle: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrEmpty, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrEmpty, "wr-empty", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; }, {}, never, ["*", "[wrEmptyActions]"], true, never>;
+}
+
+export { WrEmpty };

package/types/ngwr-falling-text.d.ts

@@ -0,0 +1,63 @@
+import * as _angular_core from '@angular/core';
+
+type WrFallingTextTrigger = 'auto' | 'scroll' | 'hover' | 'click';
+
+/**
+ * Words fall like physical bodies — gravity, wall/floor collision, and
+ * cursor drag-to-pick-up. Words start at their typeset position then
+ * release into the simulator on trigger.
+ *
+ * Triggers:
+ *  - `'auto'`   release immediately on mount
+ *  - `'scroll'` release on viewport entry
+ *  - `'hover'`  release on first hover
+ *  - `'click'`  release on first click
+ *
+ * Highlight specific words by passing prefix-matched keywords via
+ * `[highlightWords]` — matched spans get `wr-falling-text__word--hl`.
+ *
+ * @example
+ * ```html
+ * <wr-falling-text
+ *   text="React-Bits is a library of animated and interactive React components."
+ *   [highlightWords]="['React', 'animated', 'components']"
+ *   trigger="hover"
+ *   [gravity]="0.6"
+ * />
+ * ```
+ *
+ * @see https://www.reactbits.dev/text-animations/falling-text
+ */
+declare class WrFallingText {
+    /** Text to render. Words are separated by spaces. */
+    readonly text: _angular_core.InputSignal<string>;
+    /** Prefix-match keywords; any word starting with one of these gets the highlight class. */
+    readonly highlightWords: _angular_core.InputSignal<readonly string[]>;
+    /** When to release the words into the simulator. @default 'auto' */
+    readonly trigger: _angular_core.InputSignal<WrFallingTextTrigger>;
+    /** Gravity in pixels/sec². @default 980 */
+    readonly gravity: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Font size as a CSS length. @default '1rem' */
+    readonly fontSize: _angular_core.InputSignal<string>;
+    private readonly wordsRef;
+    private readonly host;
+    private readonly destroyRef;
+    private readonly isBrowser;
+    private readonly platform;
+    private started;
+    private teardownLoop;
+    protected readonly words: _angular_core.Signal<readonly {
+        text: string;
+        highlighted: boolean;
+    }[]>;
+    constructor();
+    private start;
+    /** Apply the body's position + angle to the DOM. */
+    private commit;
+    private toLocal;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrFallingText, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrFallingText, "wr-falling-text", never, { "text": { "alias": "text"; "required": true; "isSignal": true; }; "highlightWords": { "alias": "highlightWords"; "required": false; "isSignal": true; }; "trigger": { "alias": "trigger"; "required": false; "isSignal": true; }; "gravity": { "alias": "gravity"; "required": false; "isSignal": true; }; "fontSize": { "alias": "fontSize"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { WrFallingText };
+export type { WrFallingTextTrigger };

package/types/ngwr-file-upload.d.ts

@@ -0,0 +1,94 @@
+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
+ */
+/** Why a dropped / picked file was rejected. */
+type WrFileUploadRejectionReason = 'type' | 'size' | 'count';
+/** A single rejected file + the reason. Emitted via `(rejected)`. */
+interface WrFileUploadRejection {
+    readonly file: File;
+    readonly reason: WrFileUploadRejectionReason;
+}
+
+/** Human-readable byte size (e.g. `1.2 MB`). */
+declare function formatBytes(bytes: number): string;
+/**
+ * Drag-and-drop file upload zone. Click to browse, drag-and-drop to add,
+ * with an optional file list + remove buttons.
+ *
+ * Implements `ControlValueAccessor` — value is `File | File[] | null`
+ * (single or array, governed by `multiple`).
+ *
+ * @example
+ * ```html
+ * <wr-file-upload [(ngModel)]="files" [multiple]="true" accept="image/*" />
+ * <wr-file-upload [(ngModel)]="avatar" accept=".png,.jpg" [maxSize]="2 * 1024 * 1024" />
+ * ```
+ *
+ * @see https://ngwr.dev/components/file-upload
+ */
+declare class WrFileUpload implements ControlValueAccessor {
+    /** Allow multiple files. Single mode replaces on each add. @default false */
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** `accept` attribute — comma-separated MIME types or extensions. @default '' */
+    readonly accept: _angular_core.InputSignal<string>;
+    /** Max bytes per file. `0` disables the check. @default 0 */
+    readonly maxSize: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Max files (multi mode only). `0` disables the check. @default 0 */
+    readonly maxFiles: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Render the picked-files list below the zone. @default true */
+    readonly showList: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Disable interaction. @default false */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Primary call-to-action label. Falls back to `fileUpload.browse`. */
+    readonly pickLabel: _angular_core.InputSignal<string | null>;
+    /** Secondary instruction below the CTA. Falls back to `fileUpload.dropZone`. */
+    readonly dropLabel: _angular_core.InputSignal<string | null>;
+    /** Drop-zone host aria-label. Falls back to `fileUpload.dropZoneLabel`. */
+    readonly dropZoneLabel: _angular_core.InputSignal<string | null>;
+    /** Remove-file button aria-label. Falls back to `fileUpload.removeFile`. */
+    readonly removeFileLabel: _angular_core.InputSignal<string | null>;
+    protected readonly resolvedPick: _angular_core.Signal<string>;
+    protected readonly resolvedDrop: _angular_core.Signal<string>;
+    protected readonly resolvedDropZone: _angular_core.Signal<string>;
+    protected readonly resolvedRemove: _angular_core.Signal<string>;
+    /** Optional helper text shown below the labels (e.g. accepted formats). */
+    readonly helperText: _angular_core.InputSignal<string>;
+    /** Emitted when files are rejected for type / size / count reasons. */
+    readonly rejected: _angular_core.OutputEmitterRef<readonly WrFileUploadRejection[]>;
+    protected readonly picker: _angular_core.Signal<ElementRef<HTMLInputElement>>;
+    protected readonly files: _angular_core.WritableSignal<readonly File[]>;
+    protected readonly dragging: _angular_core.WritableSignal<boolean>;
+    private readonly disabledFromCva;
+    protected readonly effectiveDisabled: _angular_core.Signal<boolean>;
+    protected readonly classes: _angular_core.Signal<string>;
+    protected readonly formatBytes: typeof formatBytes;
+    private onChange;
+    private onTouched;
+    writeValue(value: File | readonly File[] | null): void;
+    registerOnChange(fn: (value: File | readonly File[] | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    protected openPicker(): void;
+    protected onZoneKey(event: KeyboardEvent): void;
+    protected onPickerChange(event: Event): void;
+    protected onDragEnter(event: DragEvent): void;
+    protected onDragOver(event: DragEvent): void;
+    protected onDragLeave(event: DragEvent): void;
+    protected onDrop(event: DragEvent): void;
+    protected removeAt(index: number): void;
+    private acceptFiles;
+    private reject;
+    private emit;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrFileUpload, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrFileUpload, "wr-file-upload", never, { "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "showList": { "alias": "showList"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "pickLabel": { "alias": "pickLabel"; "required": false; "isSignal": true; }; "dropLabel": { "alias": "dropLabel"; "required": false; "isSignal": true; }; "dropZoneLabel": { "alias": "dropZoneLabel"; "required": false; "isSignal": true; }; "removeFileLabel": { "alias": "removeFileLabel"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; }, { "rejected": "rejected"; }, never, never, true, never>;
+}
+
+export { WrFileUpload };
+export type { WrFileUploadRejection, WrFileUploadRejectionReason };

package/types/ngwr-form.d.ts

@@ -0,0 +1,95 @@
+import * as _angular_core from '@angular/core';
+import * as _angular_forms from '@angular/forms';
+import { NgControl } from '@angular/forms';
+
+/**
+ * Wraps a label + control + error message into a single field row.
+ *
+ * Toggle `hasError` to apply error styling to the projected label and
+ * any descendant input / textarea / checkbox.
+ *
+ * @example
+ * ```html
+ * <wr-form-item [hasError]="form.controls.email.invalid">
+ *   <label>Email</label>
+ *   <wr-input formControlName="email" />
+ *   <wr-form-error>Invalid email</wr-form-error>
+ * </wr-form-item>
+ * ```
+ *
+ * @see https://ngwr.dev/components/form
+ */
+declare class WrFormItem {
+    /**
+     * When `true`, applies error coloring to the projected label and inputs.
+     *
+     * @default false
+     */
+    readonly hasError: _angular_core.InputSignalWithTransform<boolean, any>;
+    protected readonly classes: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrFormItem, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrFormItem, "wr-form-item", never, { "hasError": { "alias": "hasError"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Wraps a label + control + hint + error messages into a single block —
+ * the layout primitive every form ends up reinventing.
+ *
+ * - Auto-binds `label[for]` to the projected control via a generated id
+ *   (or use the form-control's `[id]` if you set one).
+ * - Reads the projected control's `NgControl` to surface validation
+ *   errors only when the control has been touched / submitted.
+ * - Optional `[required]` / `[optional]` markers next to the label.
+ *
+ * @example
+ * ```html
+ * <wr-form-field label="Email" hint="We'll never share it.">
+ *   <input wrInput [formControl]="email" type="email" />
+ *   <wr-form-error key="required">Email is required.</wr-form-error>
+ *   <wr-form-error key="email">Not a valid email.</wr-form-error>
+ * </wr-form-field>
+ * ```
+ *
+ * @see https://ngwr.dev/components/form-field
+ */
+declare class WrFormField {
+    /** Label text shown above the control. */
+    readonly label: _angular_core.InputSignal<string>;
+    /** Hint text shown below the control. Hidden when an error is visible. */
+    readonly hint: _angular_core.InputSignal<string>;
+    /** Show a `*` next to the label. @default false */
+    readonly required: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Show `(optional)` next to the label. Mutually exclusive with `required`. @default false */
+    readonly optional: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Force a specific id on the label's `for` attribute. Auto-generated otherwise. */
+    readonly controlId: _angular_core.InputSignal<string>;
+    /** Projected `NgControl` — used to read touched / dirty / errors. */
+    protected readonly ngControl: _angular_core.Signal<NgControl | undefined>;
+    protected readonly errors: _angular_core.Signal<_angular_forms.ValidationErrors | null>;
+    protected readonly hasError: _angular_core.Signal<boolean>;
+    protected readonly classes: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrFormField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrFormField, "wr-form-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; }, {}, ["ngControl"], ["*", "wr-form-error"], true, never>;
+}
+/**
+ * One error message tied to a validator key. Renders only when the
+ * parent form-field has a matching error in `control.errors`.
+ *
+ * @example
+ * ```html
+ * <wr-form-error key="required">This field is required.</wr-form-error>
+ * <wr-form-error key="email">That doesn't look right.</wr-form-error>
+ * ```
+ */
+declare class WrFormError {
+    /**
+     * Validator key this message corresponds to (e.g. `'required'`).
+     * Optional — without a key the message always renders, which is the
+     * plain inline-error usage inside `<wr-form-item>`.
+     */
+    readonly key: _angular_core.InputSignal<string | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrFormError, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrFormError, "wr-form-error", never, { "key": { "alias": "key"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { WrFormError, WrFormField, WrFormItem };

package/types/ngwr-fuzzy-text.d.ts

@@ -0,0 +1,74 @@
+import * as _angular_core from '@angular/core';
+
+type WrFuzzyTextDirection = 'horizontal' | 'vertical' | 'both';
+
+/**
+ * Canvas-rendered "fuzzy" text — each row/column of glyphs is offset by
+ * a random amount per frame, giving the text a TV-static or motion-blur
+ * appearance. Intensity ramps up on hover, click, and during periodic
+ * glitch bursts (configurable).
+ *
+ * @example
+ * ```html
+ * <wr-fuzzy-text text="404" />
+ * <wr-fuzzy-text
+ *   text="HELLO"
+ *   color="#0ea5e9"
+ *   [fuzzRange]="50"
+ *   [hoverIntensity]="0.8"
+ *   [glitchMode]="true"
+ * />
+ * ```
+ *
+ * @see https://www.reactbits.dev/text-animations/fuzzy-text
+ */
+declare class WrFuzzyText {
+    /** Text to render. */
+    readonly text: _angular_core.InputSignal<string>;
+    /** Font size as CSS length (`'4rem'`, `'72px'`, …) or px number. @default 'clamp(2rem, 10vw, 10rem)' */
+    readonly fontSize: _angular_core.InputSignal<string | number>;
+    /** Font weight. @default 900 */
+    readonly fontWeight: _angular_core.InputSignal<string | number>;
+    /** Font family. `'inherit'` reads the canvas's computed style. @default 'inherit' */
+    readonly fontFamily: _angular_core.InputSignal<string>;
+    /** Text colour. Ignored if `[gradient]` is set. @default '#fff' */
+    readonly color: _angular_core.InputSignal<string>;
+    /** Optional horizontal gradient stops. */
+    readonly gradient: _angular_core.InputSignal<readonly string[] | null>;
+    /** Enable hover / touch reactivity. @default true */
+    readonly enableHover: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Base intensity (0..1) when idle. @default 0.18 */
+    readonly baseIntensity: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Intensity (0..1) while the pointer hovers the text. @default 0.5 */
+    readonly hoverIntensity: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Max pixel displacement per row/column at intensity 1. @default 30 */
+    readonly fuzzRange: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Frame rate cap. @default 60 */
+    readonly fps: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Fuzz direction. @default 'horizontal' */
+    readonly direction: _angular_core.InputSignal<WrFuzzyTextDirection>;
+    /** Ms to ease intensity toward target. `0` snaps. @default 0 */
+    readonly transitionDuration: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Spike to full intensity briefly on click. @default false */
+    readonly clickEffect: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Periodic "glitch" bursts at full intensity. @default false */
+    readonly glitchMode: _angular_core.InputSignalWithTransform<boolean, any>;
+    /** Ms between glitch bursts. @default 2000 */
+    readonly glitchInterval: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Ms a glitch burst lasts. @default 200 */
+    readonly glitchDuration: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Extra pixels between glyphs. @default 0 */
+    readonly letterSpacing: _angular_core.InputSignalWithTransform<number, unknown>;
+    private readonly canvasRef;
+    private readonly destroyRef;
+    private readonly isBrowser;
+    private readonly platform;
+    private teardown;
+    constructor();
+    private init;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrFuzzyText, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrFuzzyText, "wr-fuzzy-text", never, { "text": { "alias": "text"; "required": true; "isSignal": true; }; "fontSize": { "alias": "fontSize"; "required": false; "isSignal": true; }; "fontWeight": { "alias": "fontWeight"; "required": false; "isSignal": true; }; "fontFamily": { "alias": "fontFamily"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "gradient": { "alias": "gradient"; "required": false; "isSignal": true; }; "enableHover": { "alias": "enableHover"; "required": false; "isSignal": true; }; "baseIntensity": { "alias": "baseIntensity"; "required": false; "isSignal": true; }; "hoverIntensity": { "alias": "hoverIntensity"; "required": false; "isSignal": true; }; "fuzzRange": { "alias": "fuzzRange"; "required": false; "isSignal": true; }; "fps": { "alias": "fps"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "transitionDuration": { "alias": "transitionDuration"; "required": false; "isSignal": true; }; "clickEffect": { "alias": "clickEffect"; "required": false; "isSignal": true; }; "glitchMode": { "alias": "glitchMode"; "required": false; "isSignal": true; }; "glitchInterval": { "alias": "glitchInterval"; "required": false; "isSignal": true; }; "glitchDuration": { "alias": "glitchDuration"; "required": false; "isSignal": true; }; "letterSpacing": { "alias": "letterSpacing"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { WrFuzzyText };
+export type { WrFuzzyTextDirection };