@inandu-solutions/grid-react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Inandu SAS (https://inandu.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# inandu-grid-react
+
+The React port of [`@inandu-solutions/grid-angular`](https://github.com/inandusolutions/inandu-grid) —
+a standalone data grid: sorting, filtering, grouping, pagination, virtual scroll, inline editing,
+CSV/Excel/PDF export and i18n, with a deliberately small dependency footprint.
+
+[![license](https://img.shields.io/badge/license-MIT-0e7c74.svg)](LICENSE)
+![React](https://img.shields.io/badge/React-18%20%7C%2019-61dafb)
+[![Open in StackBlitz](https://img.shields.io/badge/StackBlitz-open%20example-1389FD?logo=stackblitz&logoColor=white)](https://stackblitz.com/github/inandusolutions/inandu-grid-react/tree/main/examples/stackblitz)
+
+**Feature-complete with grid-angular — not yet published to npm** (see the "Package" bullet
+below). The framework-agnostic core (sorting, filtering, aggregation, export, i18n) is
+ported from grid-angular's
+[`core/`](https://github.com/inandusolutions/inandu-grid/tree/main/projects/inandu-grid/src/lib/core)
+folder and kept in sync by hand across the two repos. The React-specific layer — the `<InanduGrid>`
+component and the `useInanduGrid()` headless hook — covers sorting (single- and, via shift-click,
+multi-column), free-text search, per-column filtering, pagination, single-column grouping with
+aggregates, row selection, CSV/Excel(.xls)/PDF export, print, i18n (the 5 built-in languages, via a
+`lang` prop), inline row editing/creation/deletion with validation
+(required/min/max/pattern/custom/async), Excel-style Ctrl+C/Ctrl+V clipboard copy/paste, runtime
+column show/hide, sticky (pinned left/right) columns, column drag-reorder, column resize (drag a
+header's handle) and autosize (double-click it to fit content), row drag-reorder, tree data
+(`treeChildrenKey`, display + expand only — no inline editing/drag/clipboard on tree rows, same
+restriction as grid-angular), master-detail (`renderDetail`), and row virtualization
+(`virtualScroll`) for large datasets.
+
+Two things work slightly differently from grid-angular because they need a real browser layout
+engine that a unit-test environment can't provide: virtual scroll's row height isn't
+auto-measured — pass `virtualRowHeight` explicitly — and autosize's content measurement itself is
+trusted (ported verbatim, same DOM APIs) rather than end-to-end tested; see
+[`measureColumn.ts`](src/utils/measureColumn.ts)'s doc comment for exactly what its test suite does
+and doesn't cover.
+
+- **Angular version:** [`inandu-grid`](https://github.com/inandusolutions/inandu-grid) — the
+  original, feature-complete, MIT-licensed grid. Start there if you need something production-ready
+  today.
+- **Commercial add-ons for React:** `@inandu-solutions/grid-pro-react` *(private, paid, not released
+  yet)* — the React port of `@inandu-solutions/grid-pro`, depends on this package the same way
+  grid-pro depends on grid-angular.
+- **Package:** will ship as [`@inandu-solutions/grid-react`](https://www.npmjs.com/package/@inandu-solutions/grid-react)
+  (MIT) — npm publishing is deferred until the API stabilizes.
+- **⚡ StackBlitz:** [a minimal editable example](https://stackblitz.com/github/inandusolutions/inandu-grid-react/tree/main/examples/stackblitz) —
+  the grid in a bare React app; edit `src/App.tsx` and it updates live ([source](examples/stackblitz)).
+  Imports straight from this repo's source (not npm — the package isn't published yet).
+
+## Development
+
+```bash
+npm install
+npm run dev        # Vite dev server
+npm test           # Vitest + React Testing Library
+npm run build      # library build (dist/)
+```
+
+## API shape
+
+```tsx
+import { InanduGrid, useInanduGrid } from '@inandu-solutions/grid-react';
+
+// Component: batteries-included table.
+<InanduGrid rows={rows} columns={columns} />;
+
+// Hook: headless — bring your own markup.
+const { visibleRows, filteredRowCount, sort, setSort, filterValues, setFilterValue, page, setPage, pageCount } =
+  useInanduGrid({ rows, columns, pageSize: 25 });
+```
+
+## License
+
+MIT © [Inandu SAS](https://inandu.com)

package/dist/components/InanduGrid.d.ts

@@ -0,0 +1,97 @@
+import { ReactNode } from 'react';
+import { InanduGridRow } from '../core';
+import { InanduGridCellPaste, InanduGridColumn, InanduGridRowSave } from '../hooks/useInanduGrid';
+export interface InanduGridProps {
+    rows: InanduGridRow[];
+    columns: InanduGridColumn[];
+    /** Drives number/date formatting (`Intl`-based). Default: 'en'. */
+    locale?: string;
+    /** Drives built-in UI string translation (one of `INANDU_GRID_TRANSLATIONS`'s keys). Default: `locale`'s primary subtag. */
+    lang?: string;
+    /** 0 (default) disables pagination — every filtered/sorted row renders. Ignored while grouped. */
+    pageSize?: number;
+    /** Adds a checkbox column with row + select-all selection. Default: false. */
+    selectable?: boolean;
+    /** Called after every selection change with the current full selection, as an array. */
+    onSelectionChange?: (selectedRows: InanduGridRow[]) => void;
+    /** Adds a CSV/Excel/PDF export toolbar above the table. Default: false. */
+    exportable?: boolean;
+    /** Base filename (without extension) for exports. Default: 'inandu-grid'. */
+    exportFilenameBase?: string;
+    /** Adds a per-row "Delete" button. Default: false. */
+    deletable?: boolean;
+    /** `window.confirm()`-gates a single row's delete. Unset: deletes immediately. */
+    deleteConfirmMessage?: string;
+    /** `window.confirm()`-gates the "Delete selected" bulk action (shown when `selectable && deletable` with at least one row selected). Unset: deletes immediately. */
+    bulkDeleteConfirmMessage?: string;
+    /** Adds an "Add row" trigger with a blank draft row. Default: false. Has no effect unless at least one column is `editable`. */
+    creatable?: boolean;
+    /** Called once a row edit passes validation. The grid never mutates `rows` itself — applying `values` onto `row` is the caller's job. */
+    onRowSave?: (event: InanduGridRowSave) => void;
+    /** Called once a new row's draft passes validation. No row reference — it doesn't exist in `rows` yet. */
+    onRowCreate?: (values: Record<string, unknown>) => void;
+    /** Called after a single-row delete is confirmed (or clicked, if no `deleteConfirmMessage`). */
+    onRowDelete?: (row: InanduGridRow) => void;
+    /** Called after the bulk "Delete selected" action is confirmed (or clicked, if no `bulkDeleteConfirmMessage`). */
+    onRowsDelete?: (rows: InanduGridRow[]) => void;
+    /** Opts into `Ctrl+C`/`Ctrl+V` cell copy/paste (Excel-style TSV). Default: false. */
+    clipboard?: boolean;
+    /** Called with every parsed cell update from a `Ctrl+V`. The grid never mutates `rows` itself. */
+    onCellsPaste?: (updates: InanduGridCellPaste[]) => void;
+    /** Adds a "Columns" toolbar button + popup letting the user show/hide individual columns at runtime. Default: false. */
+    columnToggle?: boolean;
+    /** Adds a per-row drag handle to reorder rows. Default: false. Auto-disabled while grouped, same as grid-angular. */
+    rowReorder?: boolean;
+    /** Called with the fully reordered row array after a row drag-and-drop. The grid never mutates `rows` itself. */
+    onRowOrderChange?: (rows: InanduGridRow[]) => void;
+    /**
+     * Turns on tree mode: the field on each row holding its child rows (a nested array of the same
+     * shape). `rows` is then the root rows. Auto-disabled while grouped. Tree rows are display +
+     * expand only — inline editing, drag-reorder and clipboard don't apply to them, same as
+     * grid-angular.
+     */
+    treeChildrenKey?: string;
+    /** Initial expand state for tree mode. Default: `'none'`. */
+    treeDefaultExpanded?: 'none' | 'all' | number;
+    /**
+     * Enables master-detail: renders a leading expand/collapse toggle per row, and (while expanded)
+     * a full-width detail row right below it, with whatever this returns. Auto-disabled while
+     * grouped, same as grid-angular's `detailTemplate`/`hasMasterDetail`. Unset (default): off.
+     */
+    renderDetail?: (row: InanduGridRow) => ReactNode;
+    /** Collapses any other expanded row first, accordion-style, when a new one expands. Off (any number of rows can be expanded at once) by default. */
+    singleDetailExpand?: boolean;
+    /**
+     * Opt-in row virtualization for large datasets — only rows scrolled into view (plus a small
+     * overscan runway) are actually mounted. Bypasses pagination entirely, same as grouping.
+     * Auto-disabled while grouped (this port doesn't interleave group headers into the virtualized
+     * window the way grid-angular does); also disables master-detail, row drag-reorder, tree data,
+     * and the totals `<tfoot>`, same restrictions grid-angular's `virtualScroll` has. Default: false.
+     */
+    virtualScroll?: boolean;
+    /**
+     * Fixed row height (px) the virtualization math uses to compute scroll position and how many
+     * rows to render. Unlike grid-angular, this port doesn't auto-measure a rendered row's real
+     * height (that needs a real layout engine to verify, which unit tests can't provide) — pass the
+     * actual rendered row height for correct scrolling. Default: 40.
+     */
+    virtualRowHeight?: number;
+    /** The scrollable viewport's own height (px) — only used while `virtualScroll`. Default: 400. */
+    height?: number;
+    /** Extra rows rendered above/below the visible window, so a fast scroll doesn't flash empty space before the next render catches up. Default: 4. */
+    overscan?: number;
+    /**
+     * Double-click a column's resize handle to fit its width to its widest currently-rendered value
+     * (header included). Measures real rendered text width via the DOM (`measureColumnContentWidth`)
+     * — like grid-angular's own autosize, this only measures what's actually mounted (one page, or
+     * the virtual window), not the full dataset. Default: false.
+     */
+    autosize?: boolean;
+}
+/**
+ * Batteries-included table over `useInanduGrid`: sorting, free-text search, a per-column filter
+ * row, pagination, single-column grouping with per-group + grand-total aggregates, row selection,
+ * CSV/Excel/PDF export, i18n, inline row editing/creation/deletion with validation, and row
+ * virtualization for large datasets.
+ */
+export declare function InanduGrid({ rows, columns, locale, lang, pageSize, selectable, onSelectionChange, exportable, exportFilenameBase, deletable, deleteConfirmMessage, bulkDeleteConfirmMessage, creatable, onRowSave, onRowCreate, onRowDelete, onRowsDelete, clipboard, onCellsPaste, columnToggle, rowReorder, onRowOrderChange, treeChildrenKey, treeDefaultExpanded, renderDetail, singleDetailExpand, virtualScroll, virtualRowHeight, height, overscan, autosize, }: InanduGridProps): import('react').JSX.Element;

package/dist/core/aggregate.d.ts

@@ -0,0 +1,5 @@
+import { ColumnConfig, InanduColumnAggregate, InanduGridRow } from './types';
+/** Short, language-agnostic symbol shown for each `InanduColumnAggregate` kind — deliberately not translated (the same way units like "CSV"/"PDF" aren't). */
+export declare const AGGREGATE_SYMBOLS: Record<Exclude<InanduColumnAggregate, ''>, string>;
+/** One numeric aggregate per `aggregateColumns` entry, computed over `rows` — `'count'` just counts rows (works for any column type); the rest ignore rows whose raw value isn't a finite number. */
+export declare function computeGroupAggregates(rows: InanduGridRow[], aggregateColumns: readonly ColumnConfig[]): Record<string, number>;

package/dist/core/columns.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Columns with an explicit `order` land at that 0-based slot; columns without one
+ * fill the remaining slots in declaration order. Equal/out-of-range `order` values
+ * degrade gracefully by falling back to declaration order among themselves.
+ *
+ * Generic over the column type: works for `InanduColumnComponent` instances or any object with
+ * an `order()` accessor.
+ */
+export declare function placeColumnsByOrder<C extends {
+    order(): number | undefined;
+}>(columns: readonly C[]): C[];

package/dist/core/constants.d.ts

@@ -0,0 +1,14 @@
+/** Floor enforced while dragging a resize handle, so a column can never be shrunk to zero/negative width. */
+export declare const MIN_COLUMN_WIDTH = 30;
+/** Ceiling `autosize` (double-click a resize handle to fit content) will grow a column to, so one
+ *  very long value can't blow the column out to the width of the page. The drag handle itself is
+ *  not capped by this. */
+export declare const MAX_COLUMN_WIDTH = 600;
+/** Must match `.inandu-select-column`'s CSS width — used by `stickyOffset()` to account for the (always-sticky) checkbox column. */
+export declare const SELECT_COLUMN_WIDTH = 36;
+/** Must match `.inandu-row-drag-column`'s CSS width — used by `stickyOffset()` to account for the (always-leading, when enabled) drag-handle column. */
+export declare const ROW_DRAG_COLUMN_WIDTH = 32;
+/** Must match `.inandu-detail-toggle-column`'s CSS width — used by `stickyOffset()` to account for the (always-leading-most, when enabled) master-detail expand/collapse column. */
+export declare const DETAIL_TOGGLE_COLUMN_WIDTH = 32;
+/** `localStorage` key prefix for `stateKey`-based persistence, so this library's own saved blobs don't collide with anything else a host app stores. */
+export declare const STATE_STORAGE_PREFIX = "inandu-grid-state:";

package/dist/core/export/csv.d.ts

@@ -0,0 +1,2 @@
+/** Quotes `value` for a CSV cell (doubling internal quotes) only if it contains a comma, quote, or newline. */
+export declare function escapeCsvValue(value: string): string;

package/dist/core/export/download.d.ts

@@ -0,0 +1,2 @@
+/** Triggers a browser download of `content` as `filename`, via a throwaway object URL + `<a>` click. */
+export declare function downloadBlob(content: string | Blob, filename: string, mimeType?: string): void;

package/dist/core/export/markup.d.ts

@@ -0,0 +1,2 @@
+/** Escapes `&`/`</>` for safe use as XML/HTML element text content — shared by `exportExcel()` and `printTable()`. */
+export declare function escapeMarkup(value: string): string;

package/dist/core/export/pdf.d.ts

@@ -0,0 +1,3 @@
+import { jsPDF } from 'jspdf';
+/** Shortens `text` with a trailing "…" until it fits `maxWidth` (in the PDF's current font), unchanged if it already fits. */
+export declare function truncatePdfText(doc: jsPDF, text: string, maxWidth: number): string;

package/dist/core/filter.d.ts

@@ -0,0 +1,26 @@
+import { ColumnConfig, InanduGridColumnFilterValue, InanduGridRow } from './types';
+import { NumberFormatter } from './format';
+/**
+ * Whether `value` has at least one non-empty key — an entry can exist (e.g. after typing then
+ * clearing) without actually narrowing anything. `values` is the one exception: unlike every other
+ * key, an *empty* array is still meaningful (see `matchesColumnFilter`) — the presence of the key
+ * at all is what counts, not its length. Only an entirely absent/`undefined` `values` reads as "no
+ * set-filter constraint".
+ */
+export declare function hasMeaningfulFilterValue(value: InanduGridColumnFilterValue | undefined): boolean;
+/**
+ * Whether `row` satisfies `column`'s own filter control. An empty/absent `filterValue` (no
+ * constraint entered for this column yet) always matches. Range checks (`'number'`/`'date'`) are
+ * inclusive on both ends; a cell that can't be parsed as that column's type never matches once at
+ * least one bound is set.
+ *
+ * `filterValue.values` (the set filter) is the one key that's *present-vs-absent*, not
+ * *non-empty-vs-empty*: an `undefined` `values` falls through to the type-specific checks below,
+ * same as omitting it; a *defined* `values` — even `[]` — takes over matching for the column
+ * entirely, checked against the formatted display value. This is deliberate: `[]` is how "every
+ * checkbox is unchecked" (match nothing) is told apart from "the set filter was never touched"
+ * (match everything, i.e. don't constrain) — collapsing them to the same "no constraint" meaning,
+ * like every other filter key's blank state does, would make unchecking every box a no-op instead
+ * of the empty result a consumer building a set-filter checklist actually needs.
+ */
+export declare function matchesColumnFilter(column: ColumnConfig, row: InanduGridRow, filterValue: InanduGridColumnFilterValue, locale: string, numberFormatter?: NumberFormatter): boolean;

package/dist/core/format.d.ts

@@ -0,0 +1,24 @@
+import { InanduColumnType } from './types';
+/**
+ * Turns a raw numeric value into its display string. `digitsInfo` is a `DecimalPipe`-style
+ * `'{minInt}.{minFrac}-{maxFrac}'` string (e.g. `"1.2-2"`), or empty for the default.
+ *
+ * Injected into `formatCellValue()` so the framework layer can choose the implementation: the
+ * Angular component passes one backed by `@angular/common`'s `formatNumber` (honouring whatever
+ * locale data the host app registered), keeping its output byte-identical to before this folder
+ * existed. `defaultNumberFormatter` below is the standalone fallback for a non-Angular consumer.
+ */
+export type NumberFormatter = (value: number, locale: string, digitsInfo?: string) => string;
+/** `Intl.NumberFormat`-based `NumberFormatter`. Parses the `digitsInfo` mini-syntax; falls back to Angular's own default of up to 3 fraction digits (`'1.0-3'`) when it's absent. */
+export declare function defaultNumberFormatter(value: number, locale: string, digitsInfo?: string): string;
+/**
+ * Coerces a raw cell value to a `Date` for `type="date"` columns — accepts a `Date`, a timestamp,
+ * or a string. Safari's `Date` string parser is stricter than Chrome's; notably it returns an
+ * Invalid Date for a space-separated `"yyyy-mm-dd hh:mm[:ss]"` that Chrome happily parses. That one
+ * common case is normalised to the ISO `T` form before parsing, so a `type="date"` column renders
+ * and filters identically in both. Anything still unparseable comes back as an Invalid Date — every
+ * caller already guards with `Number.isNaN(date.getTime())`.
+ */
+export declare function coerceToDate(value: unknown): Date;
+export declare function formatDateValue(date: Date, format: string): string;
+export declare function formatCellValue(value: unknown, type: InanduColumnType, format: string, locale: string, numberFormatter?: NumberFormatter): string;

package/dist/core/i18n/en.d.ts

@@ -0,0 +1,46 @@
+export declare const en: {
+    MsgNoData: string;
+    MsgFirstPage: string;
+    MsgPreviousPage: string;
+    MsgNextPage: string;
+    MsgLastPage: string;
+    MsgSortBy: string;
+    MsgPageOf: string;
+    MsgFilterPlaceholder: string;
+    MsgFilterColumn: string;
+    MsgFilterMin: string;
+    MsgFilterMax: string;
+    MsgFilterFrom: string;
+    MsgFilterTo: string;
+    MsgAll: string;
+    MsgCancelFilter: string;
+    MsgCancelAllFilters: string;
+    MsgGroupByHint: string;
+    MsgGroupedBy: string;
+    MsgGroupHeader: string;
+    MsgCancelGrouping: string;
+    MsgSelectAll: string;
+    MsgSelectRow: string;
+    MsgExportCsv: string;
+    MsgExportExcel: string;
+    MsgExportPdf: string;
+    MsgPrint: string;
+    MsgToggleColumns: string;
+    MsgToggleColumn: string;
+    MsgEditCell: string;
+    MsgEditRow: string;
+    MsgSaveRow: string;
+    MsgCancelRowEdit: string;
+    MsgDeleteRow: string;
+    MsgAddRow: string;
+    MsgLoading: string;
+    MsgDragRow: string;
+    MsgAutosizeColumn: string;
+    MsgExpandDetail: string;
+    MsgCollapseDetail: string;
+    MsgDeleteSelected: string;
+    MsgValidationRequired: string;
+    MsgValidationMin: string;
+    MsgValidationMax: string;
+    MsgValidationPattern: string;
+};

package/dist/core/i18n/es.d.ts

@@ -0,0 +1,46 @@
+export declare const es: {
+    MsgNoData: string;
+    MsgFirstPage: string;
+    MsgPreviousPage: string;
+    MsgNextPage: string;
+    MsgLastPage: string;
+    MsgSortBy: string;
+    MsgPageOf: string;
+    MsgFilterPlaceholder: string;
+    MsgFilterColumn: string;
+    MsgFilterMin: string;
+    MsgFilterMax: string;
+    MsgFilterFrom: string;
+    MsgFilterTo: string;
+    MsgAll: string;
+    MsgCancelFilter: string;
+    MsgCancelAllFilters: string;
+    MsgGroupByHint: string;
+    MsgGroupedBy: string;
+    MsgGroupHeader: string;
+    MsgCancelGrouping: string;
+    MsgSelectAll: string;
+    MsgSelectRow: string;
+    MsgExportCsv: string;
+    MsgExportExcel: string;
+    MsgExportPdf: string;
+    MsgPrint: string;
+    MsgToggleColumns: string;
+    MsgToggleColumn: string;
+    MsgEditCell: string;
+    MsgEditRow: string;
+    MsgSaveRow: string;
+    MsgCancelRowEdit: string;
+    MsgDeleteRow: string;
+    MsgAddRow: string;
+    MsgLoading: string;
+    MsgDragRow: string;
+    MsgAutosizeColumn: string;
+    MsgExpandDetail: string;
+    MsgCollapseDetail: string;
+    MsgDeleteSelected: string;
+    MsgValidationRequired: string;
+    MsgValidationMin: string;
+    MsgValidationMax: string;
+    MsgValidationPattern: string;
+};

package/dist/core/i18n/fr.d.ts

@@ -0,0 +1,46 @@
+export declare const fr: {
+    MsgNoData: string;
+    MsgFirstPage: string;
+    MsgPreviousPage: string;
+    MsgNextPage: string;
+    MsgLastPage: string;
+    MsgSortBy: string;
+    MsgPageOf: string;
+    MsgFilterPlaceholder: string;
+    MsgFilterColumn: string;
+    MsgFilterMin: string;
+    MsgFilterMax: string;
+    MsgFilterFrom: string;
+    MsgFilterTo: string;
+    MsgAll: string;
+    MsgCancelFilter: string;
+    MsgCancelAllFilters: string;
+    MsgGroupByHint: string;
+    MsgGroupedBy: string;
+    MsgGroupHeader: string;
+    MsgCancelGrouping: string;
+    MsgSelectAll: string;
+    MsgSelectRow: string;
+    MsgExportCsv: string;
+    MsgExportExcel: string;
+    MsgExportPdf: string;
+    MsgPrint: string;
+    MsgToggleColumns: string;
+    MsgToggleColumn: string;
+    MsgEditCell: string;
+    MsgEditRow: string;
+    MsgSaveRow: string;
+    MsgCancelRowEdit: string;
+    MsgDeleteRow: string;
+    MsgAddRow: string;
+    MsgLoading: string;
+    MsgDragRow: string;
+    MsgAutosizeColumn: string;
+    MsgExpandDetail: string;
+    MsgCollapseDetail: string;
+    MsgDeleteSelected: string;
+    MsgValidationRequired: string;
+    MsgValidationMin: string;
+    MsgValidationMax: string;
+    MsgValidationPattern: string;
+};

package/dist/core/i18n/index.d.ts

@@ -0,0 +1,8 @@
+import { en } from './en';
+import { es } from './es';
+import { fr } from './fr';
+import { it } from './it';
+import { zh } from './zh';
+export { en, es, fr, it, zh };
+/** Every built-in dictionary, keyed by primary language subtag. */
+export declare const INANDU_GRID_TRANSLATIONS: Record<string, Record<string, string>>;

package/dist/core/i18n/it.d.ts

@@ -0,0 +1,46 @@
+export declare const it: {
+    MsgNoData: string;
+    MsgFirstPage: string;
+    MsgPreviousPage: string;
+    MsgNextPage: string;
+    MsgLastPage: string;
+    MsgSortBy: string;
+    MsgPageOf: string;
+    MsgFilterPlaceholder: string;
+    MsgFilterColumn: string;
+    MsgFilterMin: string;
+    MsgFilterMax: string;
+    MsgFilterFrom: string;
+    MsgFilterTo: string;
+    MsgAll: string;
+    MsgCancelFilter: string;
+    MsgCancelAllFilters: string;
+    MsgGroupByHint: string;
+    MsgGroupedBy: string;
+    MsgGroupHeader: string;
+    MsgCancelGrouping: string;
+    MsgSelectAll: string;
+    MsgSelectRow: string;
+    MsgExportCsv: string;
+    MsgExportExcel: string;
+    MsgExportPdf: string;
+    MsgPrint: string;
+    MsgToggleColumns: string;
+    MsgToggleColumn: string;
+    MsgEditCell: string;
+    MsgEditRow: string;
+    MsgSaveRow: string;
+    MsgCancelRowEdit: string;
+    MsgDeleteRow: string;
+    MsgAddRow: string;
+    MsgLoading: string;
+    MsgDragRow: string;
+    MsgAutosizeColumn: string;
+    MsgExpandDetail: string;
+    MsgCollapseDetail: string;
+    MsgDeleteSelected: string;
+    MsgValidationRequired: string;
+    MsgValidationMin: string;
+    MsgValidationMax: string;
+    MsgValidationPattern: string;
+};

package/dist/core/i18n/zh.d.ts

@@ -0,0 +1,46 @@
+export declare const zh: {
+    MsgNoData: string;
+    MsgFirstPage: string;
+    MsgPreviousPage: string;
+    MsgNextPage: string;
+    MsgLastPage: string;
+    MsgSortBy: string;
+    MsgPageOf: string;
+    MsgFilterPlaceholder: string;
+    MsgFilterColumn: string;
+    MsgFilterMin: string;
+    MsgFilterMax: string;
+    MsgFilterFrom: string;
+    MsgFilterTo: string;
+    MsgAll: string;
+    MsgCancelFilter: string;
+    MsgCancelAllFilters: string;
+    MsgGroupByHint: string;
+    MsgGroupedBy: string;
+    MsgGroupHeader: string;
+    MsgCancelGrouping: string;
+    MsgSelectAll: string;
+    MsgSelectRow: string;
+    MsgExportCsv: string;
+    MsgExportExcel: string;
+    MsgExportPdf: string;
+    MsgPrint: string;
+    MsgToggleColumns: string;
+    MsgToggleColumn: string;
+    MsgEditCell: string;
+    MsgEditRow: string;
+    MsgSaveRow: string;
+    MsgCancelRowEdit: string;
+    MsgDeleteRow: string;
+    MsgAddRow: string;
+    MsgLoading: string;
+    MsgDragRow: string;
+    MsgAutosizeColumn: string;
+    MsgExpandDetail: string;
+    MsgCollapseDetail: string;
+    MsgDeleteSelected: string;
+    MsgValidationRequired: string;
+    MsgValidationMin: string;
+    MsgValidationMax: string;
+    MsgValidationPattern: string;
+};

package/dist/core/index.d.ts

@@ -0,0 +1,16 @@
+export type { InanduColumnType, InanduColumnStickySide, InanduColumnAggregate, InanduGridRow, InanduGridColumnFilterValue, ColumnConfig, } from './types';
+export { MIN_COLUMN_WIDTH, MAX_COLUMN_WIDTH, SELECT_COLUMN_WIDTH, ROW_DRAG_COLUMN_WIDTH, DETAIL_TOGGLE_COLUMN_WIDTH, STATE_STORAGE_PREFIX, } from './constants';
+export { coerceToDate, formatDateValue, formatCellValue, defaultNumberFormatter, } from './format';
+export type { NumberFormatter } from './format';
+export { compareCellValues } from './sort';
+export { flattenTree, collectTreeRows } from './tree';
+export type { TreeVisibleRow, FlattenTreeOptions } from './tree';
+export { hasMeaningfulFilterValue, matchesColumnFilter } from './filter';
+export { AGGREGATE_SYMBOLS, computeGroupAggregates } from './aggregate';
+export { placeColumnsByOrder } from './columns';
+export { parseDraftValue, parsePastedCellValue } from './parse';
+export { escapeCsvValue } from './export/csv';
+export { escapeMarkup } from './export/markup';
+export { truncatePdfText } from './export/pdf';
+export { downloadBlob } from './export/download';
+export { en, es, fr, it, zh, INANDU_GRID_TRANSLATIONS } from './i18n';

package/dist/core/parse.d.ts

@@ -0,0 +1,14 @@
+import { InanduColumnType } from './types';
+/**
+ * Parses a row-edit draft's raw control value (a string for text/number/date, a boolean for the
+ * checkbox — see `InanduGridComponent.onRowFieldChange`) per the column's `type`. Returns `undefined` for
+ * an unparseable `'number'`/`'date'`, the signal `saveRow()` uses to omit that field from `values`
+ * rather than committing garbage.
+ */
+export declare function parseDraftValue(raw: unknown, type: InanduColumnType): unknown;
+/**
+ * Parses one pasted TSV cell's raw text per `type` — like `parseDraftValue()`, except `'boolean'`:
+ * a pasted cell is always plain text (`"true"`/`"false"`, whatever the clipboard actually held),
+ * never an already-boolean checkbox `.checked` the way a manual row edit's draft value is.
+ */
+export declare function parsePastedCellValue(raw: string, type: InanduColumnType): unknown;

package/dist/core/sort.d.ts

@@ -0,0 +1 @@
+export declare function compareCellValues(a: unknown, b: unknown, locale?: string): number;

package/dist/core/tree.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tree-data flattening (#3) — pure, framework-agnostic. Walks a nested-children hierarchy into the
+ * flat list of rows that should render right now: a node's children appear directly below it, but
+ * only while that node is expanded. Filtering keeps a node when it (or any descendant) matches, and
+ * force-expands the ancestors of a match so it's visible; an optional comparator sorts each level.
+ */
+export interface TreeVisibleRow<T> {
+    row: T;
+    /** 0 for a root, +1 per level. Drives the first cell's indentation. */
+    depth: number;
+    /** Has at least one (surviving) child — i.e. worth showing a toggle. */
+    expandable: boolean;
+    /** Currently showing its children. */
+    expanded: boolean;
+}
+export interface FlattenTreeOptions<T> {
+    /** A node's children array (or `undefined` / `[]` for a leaf). */
+    getChildren: (row: T) => readonly T[] | undefined;
+    /** Whether `row` is expanded — consulted only when there is no active `match`. */
+    isExpanded: (row: T) => boolean;
+    /** When set, a node survives iff it or a descendant returns `true`; matches render expanded. */
+    match?: (row: T) => boolean;
+    /** Sorts the siblings at every level (applied after filtering). */
+    compare?: (a: T, b: T) => number;
+}
+export declare function flattenTree<T>(roots: readonly T[], options: FlattenTreeOptions<T>): TreeVisibleRow<T>[];
+/** Every node in the hierarchy, depth-first — used for "expand all" / counting. */
+export declare function collectTreeRows<T>(roots: readonly T[], getChildren: (row: T) => readonly T[] | undefined): T[];