@nexterajs/ui 0.0.1

package/types/nexterajs-ui-dropdowns.d.ts

@@ -0,0 +1,334 @@
+import * as _angular_core from '@angular/core';
+import { OnDestroy, TemplateRef, InjectionToken, OnInit } from '@angular/core';
+import { NxeFormControlBase } from '@nexterajs/ui/core';
+import { Subject } from 'rxjs';
+
+/** DevExtreme-shaped selection-changed payload (handlers read `selectedItem`). */
+interface NxeSelectionChangedEvent {
+    selectedItem: unknown;
+    previousValue: unknown;
+    value: unknown;
+}
+/**
+ * `nxe-select-box` — drop-in replacement for DevExtreme `dx-select-box`.
+ *
+ * A signal-CVA single-select dropdown over a plain array (`[dataSource]`). It bakes in the app's
+ * global `dxSelectBox.defaultOptions` (`displayExpr='lovName'`, `valueExpr='lovCode'`,
+ * `searchEnabled`, `showClearButton`), so the bound control value is the `valueExpr` field
+ * (a string code) and the field shows the `displayExpr` field. Dropdown is a CDK overlay with
+ * an in-field search filter. Emits `(valueChange)` (the code) and `(onSelectionChanged)`
+ * (`{selectedItem}`). Hosts a projected `nxe-validator` via {@link NXE_VALIDATION_TARGET}.
+ */
+declare class NxeSelectBoxComponent extends NxeFormControlBase<unknown> implements OnDestroy {
+    private readonly overlay;
+    private readonly viewContainerRef;
+    private readonly dropdownTemplate;
+    private readonly inputEl;
+    private readonly templates;
+    /** The source array (plain JS array of `Lov`-shaped objects, or primitives). */
+    readonly dataSource: _angular_core.InputSignal<readonly unknown[]>;
+    /** Field shown in the box/list (DevExtreme default `lovName`). Empty => the item itself. */
+    readonly displayExprInput: _angular_core.InputSignal<string>;
+    readonly displayExpr: _angular_core.Signal<string>;
+    /** Field bound as the control value (DevExtreme default `lovCode`). Empty => the whole item. */
+    readonly valueExprInput: _angular_core.InputSignal<string>;
+    readonly valueExpr: _angular_core.Signal<string>;
+    /** Field matched while searching (DevExtreme default `lovName`). */
+    readonly searchExprInput: _angular_core.InputSignal<string>;
+    readonly searchExpr: _angular_core.Signal<string>;
+    readonly searchEnabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly searchEnabled: _angular_core.Signal<boolean>;
+    readonly showClearButtonInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showClearButton: _angular_core.Signal<boolean>;
+    /** dx parity: dx-select-box shows its drop-down arrow unless showDropDownButton=false. */
+    readonly showDropDownButtonInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showDropDownButton: _angular_core.Signal<boolean>;
+    readonly placeholderInput: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.Signal<string>;
+    /** Named template ('displayItem') for dropdown rows; `$implicit` = the item. */
+    readonly itemTemplate: _angular_core.InputSignal<string>;
+    /** Named template ('inputField') for the closed field; `$implicit` = the selected item. */
+    readonly fieldTemplate: _angular_core.InputSignal<string>;
+    /** DevExtreme parity, cosmetic. */
+    readonly hoverStateEnabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly onSelectionChanged: _angular_core.OutputEmitterRef<NxeSelectionChangedEvent>;
+    readonly focused: _angular_core.WritableSignal<boolean>;
+    readonly open: _angular_core.WritableSignal<boolean>;
+    /** What the user has typed to filter (null = not actively searching → show display text). */
+    readonly searchText: _angular_core.WritableSignal<string>;
+    readonly activeIndex: _angular_core.WritableSignal<number>;
+    readonly panelWidth: _angular_core.WritableSignal<number>;
+    /** DevExtreme `.instance` facade — only `focus()` is used (via the customAutofocus directive). */
+    get instance(): this;
+    private overlayRef?;
+    private closeSub?;
+    private flipSub?;
+    private readonly items;
+    protected display(item: unknown): string;
+    private extractValue;
+    readonly selectedItem: _angular_core.Signal<unknown>;
+    readonly hasValue: _angular_core.Signal<boolean>;
+    /** Display text when the field is not being searched. */
+    protected readonly displayText: _angular_core.Signal<string>;
+    /** Value bound to the input element. */
+    protected readonly inputDisplay: _angular_core.Signal<string>;
+    protected readonly filteredItems: _angular_core.Signal<readonly unknown[]>;
+    protected readonly itemTemplateRef: _angular_core.Signal<TemplateRef<unknown>>;
+    protected readonly fieldTemplateRef: _angular_core.Signal<TemplateRef<unknown>>;
+    protected isSelected(item: unknown): boolean;
+    /** Imperative focus (DevExtreme `.instance.focus()` via customAutofocus). */
+    focus(): void;
+    protected onFieldMousedown(event: MouseEvent): void;
+    protected onSearchInput(event: Event): void;
+    protected onBlur(): void;
+    protected selectItem(item: unknown, event: Event): void;
+    protected onClear(event: Event): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    private openPanel;
+    private close;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NxeSelectBoxComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NxeSelectBoxComponent, "nxe-select-box", never, { "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; "displayExprInput": { "alias": "displayExpr"; "required": false; "isSignal": true; }; "valueExprInput": { "alias": "valueExpr"; "required": false; "isSignal": true; }; "searchExprInput": { "alias": "searchExpr"; "required": false; "isSignal": true; }; "searchEnabledInput": { "alias": "searchEnabled"; "required": false; "isSignal": true; }; "showClearButtonInput": { "alias": "showClearButton"; "required": false; "isSignal": true; }; "showDropDownButtonInput": { "alias": "showDropDownButton"; "required": false; "isSignal": true; }; "placeholderInput": { "alias": "placeholder"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "fieldTemplate": { "alias": "fieldTemplate"; "required": false; "isSignal": true; }; "hoverStateEnabled": { "alias": "hoverStateEnabled"; "required": false; "isSignal": true; }; }, { "onSelectionChanged": "onSelectionChanged"; }, ["templates"], ["*"], true, never>;
+}
+
+/**
+ * `nxe-tag-box` — drop-in replacement for DevExtreme `dx-tag-box` (multi-select sibling of
+ * `nxe-select-box`). The bound value is an **array of `valueExpr` keys** (`lovCode` strings).
+ * Bakes in the app's global `dxTagBox.defaultOptions` (display/search `lovName`, value `lovCode`,
+ * search + clear + selection-controls on). Selected items render as removable chips; the dropdown
+ * shows a checkbox per row. Provides {@link NXE_VALIDATION_TARGET} for a projected `nxe-validator`.
+ */
+declare class NxeTagBoxComponent extends NxeFormControlBase<unknown[]> implements OnDestroy {
+    private readonly overlay;
+    private readonly viewContainerRef;
+    private readonly dropdownTemplate;
+    private readonly inputEl;
+    readonly dataSource: _angular_core.InputSignal<readonly unknown[]>;
+    readonly displayExprInput: _angular_core.InputSignal<string>;
+    readonly displayExpr: _angular_core.Signal<string>;
+    readonly valueExprInput: _angular_core.InputSignal<string>;
+    readonly valueExpr: _angular_core.Signal<string>;
+    readonly searchExprInput: _angular_core.InputSignal<string>;
+    readonly searchExpr: _angular_core.Signal<string>;
+    readonly searchEnabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly searchEnabled: _angular_core.Signal<boolean>;
+    readonly showClearButtonInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showClearButton: _angular_core.Signal<boolean>;
+    /** dx parity: dx-tag-box does NOT show a drop-down arrow unless showDropDownButton is set. */
+    readonly showDropDownButtonInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showDropDownButton: _angular_core.Signal<boolean>;
+    readonly placeholderInput: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.Signal<string>;
+    readonly focused: _angular_core.WritableSignal<boolean>;
+    readonly open: _angular_core.WritableSignal<boolean>;
+    readonly searchText: _angular_core.WritableSignal<string>;
+    readonly panelWidth: _angular_core.WritableSignal<number>;
+    private overlayRef?;
+    private closeSub?;
+    private flipSub?;
+    private readonly items;
+    /** The selected keys (always an array). */
+    private readonly selectedKeys;
+    protected display(item: unknown): string;
+    private extractValue;
+    /** Selected items resolved from the value keys (for chip rendering). */
+    protected readonly selectedItems: _angular_core.Signal<unknown[]>;
+    protected readonly hasValue: _angular_core.Signal<boolean>;
+    protected readonly filteredItems: _angular_core.Signal<readonly unknown[]>;
+    protected isSelected(item: unknown): boolean;
+    protected onFieldMousedown(event: MouseEvent): void;
+    protected onSearchInput(event: Event): void;
+    protected onBlur(): void;
+    protected toggle(item: unknown, event: Event): void;
+    protected removeTag(item: unknown, event: Event): void;
+    protected onClear(event: Event): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    private openPanel;
+    private close;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NxeTagBoxComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NxeTagBoxComponent, "nxe-tag-box", never, { "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; "displayExprInput": { "alias": "displayExpr"; "required": false; "isSignal": true; }; "valueExprInput": { "alias": "valueExpr"; "required": false; "isSignal": true; }; "searchExprInput": { "alias": "searchExpr"; "required": false; "isSignal": true; }; "searchEnabledInput": { "alias": "searchEnabled"; "required": false; "isSignal": true; }; "showClearButtonInput": { "alias": "showClearButton"; "required": false; "isSignal": true; }; "showDropDownButtonInput": { "alias": "showDropDownButton"; "required": false; "isSignal": true; }; "placeholderInput": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * `nxe-drop-down-options` — drop-in for DevExtreme `dxo-drop-down-options`, a no-template config
+ * child of `nxe-drop-down-box`. Only `wrapperAttr` (a `{class}` applied to the overlay panel) and
+ * `width` are used in this codebase.
+ */
+declare class NxeDropDownOptionsComponent {
+    readonly wrapperAttr: _angular_core.InputSignal<{
+        class?: string;
+        id?: string;
+    }>;
+    readonly width: _angular_core.InputSignal<string | number>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NxeDropDownOptionsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NxeDropDownOptionsComponent, "nxe-drop-down-options", never, { "wrapperAttr": { "alias": "wrapperAttr"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * `nxe-drop-down-box` — drop-in replacement for DevExtreme `dx-drop-down-box`.
+ *
+ * A signal-CVA editor whose dropdown hosts ARBITRARY projected content (a `nxeTemplate="content"`
+ * block — usually a data-grid picker) in a CDK overlay. The closed field shows the value's
+ * `displayExpr` (looked up in `[dataSource]`), or the raw value when no `displayExpr`. The inner
+ * grid sets the bound form value and closes the popup via `#ref.instance.close()` (16 call sites),
+ * so this exposes an `.instance` facade + `close()`, and an `(onClosed)` output. Projects
+ * `nxe-validator` via {@link NXE_VALIDATION_TARGET}.
+ */
+declare class NxeDropDownBoxComponent extends NxeFormControlBase<unknown> implements OnDestroy {
+    private readonly overlay;
+    private readonly viewContainerRef;
+    private readonly panelTemplate;
+    private readonly templates;
+    private readonly options;
+    readonly dataSource: _angular_core.InputSignal<readonly unknown[]>;
+    /** Field name shown in the closed box; empty => the raw value string. */
+    readonly displayExprInput: _angular_core.InputSignal<string>;
+    readonly displayExpr: _angular_core.Signal<string>;
+    readonly valueExprInput: _angular_core.InputSignal<string>;
+    readonly valueExpr: _angular_core.Signal<string>;
+    readonly placeholderInput: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.Signal<string>;
+    /** DevExtreme `[dropDownOptions]` — accepted for parity (popup-class hook). */
+    readonly dropDownOptions: _angular_core.InputSignal<unknown>;
+    /**
+     * DevExtreme `showClearButton` — a × left of the arrow that sets the value to null, matching
+     * {@link NxeSelectBoxComponent}/`nxe-tag-box`.
+     *
+     * Defaults to **false**, unlike those two: this component's dropdown hosts arbitrary content, and
+     * every existing call site picks from a grid where clearing was never offered. Opt in where null
+     * is a value the field can legitimately hold.
+     */
+    readonly showClearButtonInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showClearButton: _angular_core.Signal<boolean>;
+    /**
+     * DevExtreme `[opened]` (orbit addition): programmatic open/close. Reflects the panel state
+     * outward and opens/closes the panel when the binding changes.
+     */
+    readonly opened: _angular_core.ModelSignal<boolean>;
+    readonly onClosed: _angular_core.OutputEmitterRef<void>;
+    readonly focused: _angular_core.WritableSignal<boolean>;
+    readonly open: _angular_core.WritableSignal<boolean>;
+    readonly panelWidth: _angular_core.WritableSignal<number>;
+    /** DevExtreme `.instance` facade — only `close()` is used (from inner-grid selection handlers). */
+    get instance(): this;
+    constructor();
+    private overlayRef?;
+    private closeSub?;
+    private flipSub?;
+    protected readonly contentTemplateRef: _angular_core.Signal<TemplateRef<unknown>>;
+    /**
+     * DevExtreme sizes the popup to the editor, and every call site that says anything says
+     * `width="100%"` — which means that same thing. So the panel is fixed at the field's width and
+     * the content fits inside it (a grid picker lays its columns out to the panel) rather than the
+     * panel growing to whatever the content wants. Only an explicit px/em/rem width overrides.
+     */
+    protected readonly panelStyleWidth: _angular_core.Signal<string>;
+    readonly displayText: _angular_core.Signal<string>;
+    protected readonly hasValue: _angular_core.Signal<boolean>;
+    protected onFieldMousedown(event: MouseEvent): void;
+    /** Stops the mousedown reaching the field, which would otherwise toggle the panel open. */
+    protected onClear(event: Event): void;
+    protected onBlur(): void;
+    /** Imperative close (DevExtreme `.instance.close()`). */
+    close(): void;
+    private openPanel;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NxeDropDownBoxComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NxeDropDownBoxComponent, "nxe-drop-down-box", never, { "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; "displayExprInput": { "alias": "displayExpr"; "required": false; "isSignal": true; }; "valueExprInput": { "alias": "valueExpr"; "required": false; "isSignal": true; }; "placeholderInput": { "alias": "placeholder"; "required": false; "isSignal": true; }; "dropDownOptions": { "alias": "dropDownOptions"; "required": false; "isSignal": true; }; "showClearButtonInput": { "alias": "showClearButton"; "required": false; "isSignal": true; }; "opened": { "alias": "opened"; "required": false; "isSignal": true; }; }, { "opened": "openedChange"; "onClosed": "onClosed"; }, ["templates", "options"], ["*"], true, never>;
+}
+
+/** DevExtreme-shaped `onItemClick` payload (handlers read `itemData`). */
+interface NxeListItemClickEvent {
+    itemData: unknown;
+}
+/**
+ * `nxe-list` — drop-in replacement for DevExtreme `dx-list` as used in this codebase: an action
+ * menu rendered inside `nxe-menu` (100% of usages). Renders each `[dataSource]` item with the
+ * named `itemTemplate` (`*nxeTemplate`), emits `(onItemClick)` (`{itemData}`), and closes the
+ * parent `nxe-menu` on click. Emits `.nxe-list`/`.nxe-list-item-row`/`.nxe-list-item-content` classes so
+ * the app's existing menu/list CSS applies unchanged.
+ */
+declare class NxeListComponent {
+    private readonly menu;
+    private readonly templates;
+    readonly dataSource: _angular_core.InputSignal<readonly unknown[]>;
+    /** Named template ('listItem'/'actionButton') for each row; `$implicit` = the item. */
+    readonly itemTemplate: _angular_core.InputSignal<string>;
+    /** DevExtreme `[elementAttr]` — `{ id, class }` applied to the host. */
+    readonly elementAttr: _angular_core.InputSignal<{
+        id?: string;
+        class?: string;
+    }>;
+    readonly onItemClick: _angular_core.OutputEmitterRef<NxeListItemClickEvent>;
+    protected readonly items: _angular_core.Signal<readonly unknown[]>;
+    protected readonly itemTemplateRef: _angular_core.Signal<_angular_core.TemplateRef<unknown>>;
+    protected text(item: unknown): string;
+    /** dx parity: dx-list honors `item.disabled` (grayed, non-interactive). */
+    protected isDisabled(item: unknown): boolean;
+    protected select(item: unknown): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NxeListComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NxeListComponent, "nxe-list", never, { "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "elementAttr": { "alias": "elementAttr"; "required": false; "isSignal": true; }; }, { "onItemClick": "onItemClick"; }, ["templates"], never, true, never>;
+}
+
+/** What an `nxe-option` needs from its parent autocomplete: a way to request close on select. */
+interface NxeAutocompletePanel {
+    closeFromOption(): void;
+}
+/** DI token the autocomplete provides so projected `nxe-option`s can close it on click. */
+declare const NXE_AUTOCOMPLETE: InjectionToken<NxeAutocompletePanel>;
+/**
+ * `nxe-autocomplete` — drop-in replacement for Material's `mat-autocomplete` (as used by the global
+ * search). Holds the dropdown panel as a `TemplateRef` that the `[nxeAutocomplete]` trigger renders
+ * in a CDK overlay; projects `nxe-option`s. Emits the Material panel/option classes so Material's
+ * loaded autocomplete CSS + the consumer's classes apply. Exposes `isOpen` (read by the search).
+ */
+declare class NxeAutocompleteComponent implements NxeAutocompletePanel, OnInit {
+    private readonly elementRef;
+    readonly templateRef: _angular_core.Signal<TemplateRef<any>>;
+    /** Open state (the `[nxeAutocomplete]` trigger drives this; the search reads `isOpen`). */
+    readonly opened: _angular_core.WritableSignal<boolean>;
+    /** Fires when a projected `nxe-option` is selected, so the trigger closes the panel. */
+    readonly optionSelected: Subject<void>;
+    /** Panel classes: Material's + the consumer's class on `<nxe-autocomplete>`. */
+    readonly panelClass: _angular_core.WritableSignal<string>;
+    get isOpen(): boolean;
+    ngOnInit(): void;
+    closeFromOption(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NxeAutocompleteComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NxeAutocompleteComponent, "nxe-autocomplete", ["nxeAutocomplete"], {}, {}, never, ["*"], true, never>;
+}
+
+/**
+ * `[nxeAutocomplete]` — drop-in for Material's `matAutocomplete` trigger. Applied to a text input;
+ * opens the referenced {@link NxeAutocompleteComponent}'s panel in a CDK overlay (width-matched to
+ * the input) on focus/input, closes on blur/Escape/option-select.
+ */
+declare class NxeAutocompleteTriggerDirective implements OnDestroy {
+    readonly autocomplete: _angular_core.InputSignal<NxeAutocompleteComponent>;
+    private readonly overlay;
+    private readonly elementRef;
+    private readonly viewContainerRef;
+    private overlayRef?;
+    private sub?;
+    protected openPanel(): void;
+    protected closePanel(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NxeAutocompleteTriggerDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NxeAutocompleteTriggerDirective, "input[nxeAutocomplete], textarea[nxeAutocomplete]", ["nxeAutocompleteTrigger"], { "autocomplete": { "alias": "nxeAutocomplete"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * `nxe-option` — drop-in for Material's `mat-option` inside an `nxe-autocomplete`. Emits the MDC
+ * option classes (so Material's option CSS applies) and closes the parent autocomplete on click;
+ * the consumer's own `(click)` (e.g. navigate) still fires.
+ */
+declare class NxeOptionComponent {
+    private readonly autocomplete;
+    protected select(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NxeOptionComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NxeOptionComponent, "nxe-option", ["nxeOption"], {}, {}, never, ["*"], true, never>;
+}
+
+export { NXE_AUTOCOMPLETE, NxeAutocompleteComponent, NxeAutocompleteTriggerDirective, NxeDropDownBoxComponent, NxeDropDownOptionsComponent, NxeListComponent, NxeOptionComponent, NxeSelectBoxComponent, NxeTagBoxComponent };
+export type { NxeAutocompletePanel, NxeListItemClickEvent, NxeSelectionChangedEvent };

package/types/nexterajs-ui-excel.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Public value types for the in-repo .xlsx writer. These mirror the narrow slice of the exceljs
+ * `Cell` shape the app actually uses (verified across every call site), so existing code migrates by
+ * import path only — see {@link NxeWorkbook} (aliased as `Workbook`).
+ */
+/** A cell's value. `null`/`undefined`/`''` render as blank. */
+type NxeCellValue = string | number | Date | null | undefined;
+/** Font facet. Default font (when unset) is undefined, NOT `{}` — `formatExcel` reads `font?.name`. */
+interface NxeFont {
+    name?: string;
+    bold?: boolean;
+    size?: number;
+}
+/** Solid pattern fill, matching the exceljs `{ type, pattern, fgColor: { argb } }` shape. */
+interface NxeFill {
+    type: 'pattern';
+    pattern: 'solid';
+    fgColor: {
+        argb: string;
+    };
+}
+/** Cell alignment. `vertical: 'middle'` maps to Excel's `center`. */
+interface NxeAlignment {
+    horizontal?: 'left' | 'center' | 'right';
+    vertical?: 'top' | 'middle' | 'bottom';
+    /** Text indent level. Like exceljs, emitted as-is; Excel only renders it with left/right/distributed horizontal. */
+    indent?: number;
+}
+/** Auto-filter range, object form (`{ from: {row, column}, to: {row, column} }`), 1-based. */
+interface NxeAutoFilter {
+    from: {
+        row: number;
+        column: number;
+    };
+    to: {
+        row: number;
+        column: number;
+    };
+}
+
+/**
+ * Zero-dependency, in-repo `.xlsx` writer — a drop-in for the narrow exceljs surface this app uses
+ * (verified across every call site). Replaces the `exceljs` package: callers migrate by import path
+ * only, via the `Workbook` alias below.
+ *
+ * The object model ({@link NxeWorkbook} / {@link NxeWorksheet} / {@link NxeRow} / {@link NxeCell})
+ * mirrors exceljs (`addWorksheet`, `addRow`, `getCell` 1-based + auto-extend, `mergeCells`,
+ * `autoFilter`, `eachSheet`/`eachRow`/`eachCell`, `rowCount`, cell `value`/`numFmt`/`font`/`fill`/
+ * `alignment`, `xlsx.writeBuffer()`). {@link NxeWorkbook.serialize} emits a flat 6-part OOXML
+ * (SpreadsheetML) package using inline strings — no `sharedStrings.xml` — and packs it as a STORE
+ * (uncompressed) ZIP via {@link writeZip}.
+ *
+ * Scope is deliberately exactly what the app needs: string/number/Date/'' cells, custom number
+ * formats, fonts (name + bold, per cell or per row), solid fills, alignment (incl. indent), merged
+ * cells, auto-filter, column widths. No borders, formulas, images, rich text.
+ */
+
+/** 1 → A, 27 → AA. */
+declare function colLetter(n: number): string;
+declare class StyleRegistry {
+    private numFmts;
+    private numFmtIndex;
+    private fonts;
+    private fontIndex;
+    private fills;
+    private fillIndex;
+    private xfs;
+    private xfIndex;
+    private numFmtId;
+    private fontId;
+    private fillId;
+    /** Resolve the 0-based cellXfs index for a cell's facets; 0 means "all default" (omit `s`). */
+    cellStyle(cell: NxeCell): number;
+    toXml(): string;
+}
+declare class NxeCell {
+    value: NxeCellValue;
+    numFmt?: string;
+    /** Default MUST be undefined (never a shared `{}`) — `formatExcel` reads `cell.font?.name`. */
+    font?: NxeFont;
+    fill?: NxeFill;
+    alignment?: NxeAlignment;
+}
+declare class NxeRow {
+    /** 1-based column → cell (only accessed columns exist). */
+    private cells;
+    private _font?;
+    /**
+     * exceljs parity: setting `row.font` overwrites every existing cell's font and seeds cells
+     * created later in this row. Each cell gets its own copy — `formatExcel`-style passes mutate
+     * `cell.font` in place, so cells must not alias one object.
+     */
+    get font(): NxeFont | undefined;
+    set font(f: NxeFont | undefined);
+    getCell(col: number): NxeCell;
+    eachCell(cb: (cell: NxeCell, colNumber: number) => void): void;
+}
+/** Column facet (exceljs `Column` slice) — only `width` (Excel character units) is supported. */
+declare class NxeColumn {
+    readonly number: number;
+    width?: number;
+    constructor(number: number);
+}
+declare class NxeWorksheet {
+    name: string;
+    autoFilter?: NxeAutoFilter;
+    private rows;
+    private maxRow;
+    private merges;
+    /** 1-based column → column facet (only accessed columns exist). */
+    private colMap;
+    constructor(name: string);
+    /** Highest populated row (0 when empty) — `getCell` auto-extends past the `addRow` cursor. */
+    get rowCount(): number;
+    private rowAt;
+    addRow(values: NxeCellValue[]): NxeRow;
+    /** 1-based (row, col); auto-extends the sheet (the pivot exporter writes past the cursor). */
+    getCell(row: number, col: number): NxeCell;
+    /** Lazily-created column facet, 1-based (exceljs `getColumn`); may point past the used range. */
+    getColumn(n: number): NxeColumn;
+    /** exceljs parity: one entry per column touched so far (via `addRow`/`getCell`/`getColumn`). */
+    get columns(): NxeColumn[];
+    mergeCells(r1: number, c1: number, r2: number, c2: number): void;
+    eachRow(cb: (row: NxeRow, rowNumber: number) => void): void;
+    /** @internal Serialize this sheet to its worksheet XML, registering styles as it goes. */
+    toXml(styles: StyleRegistry): string;
+}
+declare class NxeWorkbook {
+    worksheets: NxeWorksheet[];
+    /** Mirrors `workbook.xlsx.writeBuffer()` — resolves to the packed `.xlsx` bytes. */
+    readonly xlsx: {
+        writeBuffer: () => Promise<Uint8Array<ArrayBuffer>>;
+    };
+    addWorksheet(name?: string): NxeWorksheet;
+    eachSheet(cb: (sheet: NxeWorksheet, id: number) => void): void;
+    /** Build the full OOXML package and pack it as a STORE ZIP. */
+    serialize(): Uint8Array<ArrayBuffer>;
+}
+
+type Worksheet = NxeWorksheet;
+
+/** True when the bytes begin with the ZIP local-file-header magic (`PK\x03\x04`) — i.e. an `.xlsx`. */
+declare function isXlsxBytes(buf: Uint8Array): boolean;
+/**
+ * Read the FIRST worksheet of an `.xlsx` into a dense, positional array-of-arrays (matching SheetJS
+ * `sheet_to_json(ws, { header: 1 })`). Numeric cells are returned as numbers; string cells as
+ * strings; missing leading/intermediate cells as `''`.
+ */
+declare function readXlsxFirstSheet(input: ArrayBuffer | Uint8Array): Promise<(string | number)[][]>;
+
+/**
+ * Tiny in-repo replacement for `file-saver-es`'s `saveAs`. Triggers a browser download of a Blob by
+ * clicking a synthetic anchor with an object URL, then revoking it. Callers keep building their own
+ * Blob (so the MIME type is preserved).
+ */
+declare function nxeSaveAs(blob: Blob, fileName: string): void;
+
+export { NxeCell, NxeColumn, NxeRow, NxeWorkbook, NxeWorksheet, NxeWorkbook as Workbook, colLetter, isXlsxBytes, nxeSaveAs, readXlsxFirstSheet };
+export type { NxeAlignment, NxeAutoFilter, NxeCellValue, NxeFill, NxeFont, Worksheet };

package/types/nexterajs-ui-file-uploader.d.ts

@@ -0,0 +1,47 @@
+import * as _angular_core from '@angular/core';
+import { NxeValidationTarget } from '@nexterajs/ui/core';
+
+/**
+ * `nxe-file-uploader` — drop-in replacement for DevExtreme `dx-file-uploader`.
+ *
+ * Both usages run `uploadMode="useForm"` (the widget never POSTs — the picked File is read by the
+ * parent and appended to a FormData) and bind the NATIVE `(change)` event, reading
+ * `$event.target.files[0]`. So this re-emits the inner `<input type=file>` change event verbatim
+ * via a `change` output, preserving `$event.target.files[0]`. Drag-drop assigns the dropped
+ * files to the hidden input and dispatches a change, keeping the same contract. Provides
+ * {@link NXE_VALIDATION_TARGET} (value = the selected File) so a nested `nxe-validator`'s
+ * `required` rule works — invalid while no file is chosen.
+ */
+declare class NxeFileUploaderComponent implements NxeValidationTarget {
+    readonly allowCanceling: _angular_core.InputSignal<boolean>;
+    readonly accept: _angular_core.InputSignal<string>;
+    readonly labelText: _angular_core.InputSignal<string>;
+    readonly selectButtonText: _angular_core.InputSignal<string>;
+    /** Accepted for parity; only `useForm` is used (no server upload by the widget). */
+    readonly uploadMode: _angular_core.InputSignal<"instantly" | "useButtons" | "useForm">;
+    readonly multiple: _angular_core.InputSignal<boolean>;
+    readonly name: _angular_core.InputSignal<string>;
+    /** Group for a nested nxe-validator (none used today → bare default group). */
+    readonly validationGroupInput: _angular_core.InputSignal<string>;
+    /** Re-emits the native `<input type=file>` change so `$event.target.files[0]` keeps working. */
+    readonly change: _angular_core.OutputEmitterRef<Event>;
+    private readonly fileInput;
+    readonly file: _angular_core.WritableSignal<File>;
+    readonly dragOver: _angular_core.WritableSignal<boolean>;
+    readonly focused: _angular_core.WritableSignal<boolean>;
+    readonly validationError: _angular_core.WritableSignal<string>;
+    getValue(): unknown;
+    validationGroup(): string | undefined;
+    setValidationError(message: string | null): void;
+    protected browse(): void;
+    protected onNativeChange(event: Event): void;
+    protected cancel(): void;
+    protected onDragOver(event: DragEvent): void;
+    protected onDragLeave(): void;
+    protected onDrop(event: DragEvent): void;
+    protected formatSize(bytes: number): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NxeFileUploaderComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NxeFileUploaderComponent, "nxe-file-uploader", never, { "allowCanceling": { "alias": "allowCanceling"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "labelText": { "alias": "labelText"; "required": false; "isSignal": true; }; "selectButtonText": { "alias": "selectButtonText"; "required": false; "isSignal": true; }; "uploadMode": { "alias": "uploadMode"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "validationGroupInput": { "alias": "validationGroup"; "required": false; "isSignal": true; }; }, { "change": "change"; }, never, ["*"], true, never>;
+}
+
+export { NxeFileUploaderComponent };