@ember-eui/core 14.1.3 → 15.0.0

package/declarations/utils/data-grid/row-tree.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Row tree model for EuiDataGrid's nested rows (`@rowTree`) and row grouping
+ * (`@grouping`). Ember EUI extension: upstream EUI has neither.
+ *
+ * Framework free: builds a tree of data rows (from nested `children` arrays
+ * or flat `parentId` references), optionally groups rows by column values,
+ * sorts siblings, and flattens the tree into the list of visible rows given
+ * the expanded ids.
+ */
+export type RowTreeNodeKind = 'row' | 'group';
+export interface RowTreeGroup {
+    /** The grouped column. */
+    columnId: string;
+    /** The column value shared by the group's rows. */
+    value: unknown;
+    /** Number of grouped rows (data rows at the grouped level, in all subgroups). */
+    count: number;
+    /** Data row indexes of the grouped rows. */
+    rowIndices: number[];
+}
+export interface RowTreeNode {
+    id: string;
+    kind: RowTreeNodeKind;
+    /**
+     * Data row index for rows; a stable negative index (`-1`, `-2`, …) for
+     * groups, so per-row grid state (heights, cell props) never collides with
+     * data rows.
+     */
+    rowIndex: number;
+    group?: RowTreeGroup;
+    children: RowTreeNode[];
+    /** Shows a toggle although no children are loaded yet (lazy loading). */
+    canExpand?: boolean;
+}
+export interface RowTreeVisibleRow {
+    id: string;
+    kind: RowTreeNodeKind;
+    rowIndex: number;
+    group?: RowTreeGroup;
+    /** 0 for root rows. */
+    depth: number;
+    hasChildren: boolean;
+    isExpanded: boolean;
+    parentId: string | null;
+    /** 1-based position among its siblings. */
+    posInSet: number;
+    setSize: number;
+}
+export type RowId = string | number;
+export interface RowTreeSource<T = any> {
+    rows: T[];
+    /** Child rows of a row (nested form). Defaults to `row.children` when it is an array. */
+    getChildren?: (row: T) => T[] | null | undefined;
+    /** Parent row id of a row (flat form). Defaults to `row.parentId ?? row.parent`. */
+    getParentId?: (row: T) => RowId | null | undefined;
+    /** Row id. Defaults to `row.id`, else the row's index. */
+    getRowId?: (row: T, rowIndex: number) => RowId | null | undefined;
+    /**
+     * Whether a row can expand before its children are loaded (lazy loading).
+     * Defaults to `row.hasChildren === true`.
+     */
+    hasChildren?: (row: T) => boolean;
+}
+export interface BuiltRowTree {
+    roots: RowTreeNode[];
+    /** Row objects by data row index (pre-order for nested rows, array index for flat rows). */
+    rows: unknown[];
+}
+/** Whether rows nest through `children` (otherwise they reference a `parentId`). */
+export declare function isNestedRowSource(source: RowTreeSource): boolean;
+/**
+ * Builds the data row tree. Nested rows get data row indexes in pre-order
+ * (parents before children); flat rows keep their array index.
+ */
+export declare function buildRowTree<T>(source: RowTreeSource<T>): BuiltRowTree;
+/** Root nodes for `rowCount` flat rows (grouping without `rows`). */
+export declare function buildFlatRows(rowCount: number): RowTreeNode[];
+/** Identifier of a group: its column values from the outermost group down. */
+export declare function groupId(values: unknown[]): string;
+/**
+ * Groups rows by the values of `groupBy` columns (outermost first). Groups
+ * keep the order in which their values first appear; sort them with
+ * `sortRowTree`. Grouped rows keep their own children.
+ */
+export declare function groupRowTree(nodes: RowTreeNode[], groupBy: string[], getValue: (rowIndex: number, columnId: string) => unknown): RowTreeNode[];
+/** Compares group values: empty values last, numbers/dates numerically, text naturally. */
+export declare function compareGroupValues(a: unknown, b: unknown): number;
+/**
+ * Sorts every level of the tree (stable; returns new arrays). Siblings are
+ * compared with `compare`; nodes it ranks equal keep their order.
+ */
+export declare function sortRowTree(nodes: RowTreeNode[], compare: (a: RowTreeNode, b: RowTreeNode) => number): RowTreeNode[];
+/** The visible rows: roots, and the children of expanded rows, depth first. */
+export declare function flattenRowTree(roots: RowTreeNode[], isExpanded: (node: RowTreeNode) => boolean): RowTreeVisibleRow[];
+/** Ids of every node with children, by kind. */
+export declare function collectExpandableIds(roots: RowTreeNode[]): {
+    row: string[];
+    group: string[];
+};
+/** Ancestors (outermost first) of the node with a data row index, or null if absent. */
+export declare function findAncestors(roots: RowTreeNode[], rowIndex: number): RowTreeNode[] | null;
+//# sourceMappingURL=row-tree.d.ts.map

package/declarations/utils/data-grid/row-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-tree.d.ts","sourceRoot":"","sources":["../../../src/utils/data-grid/row-tree.ts"],"names":[],"mappings":"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"}

package/declarations/utils/data-grid/scheduling.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Run `fn` after the current render. Modifiers install during the render
+ * transaction, so measurements they take must update tracked state later
+ * (Ember forbids updating values already consumed by the same render).
+ */
+export declare function afterRender(owner: object, fn: () => void): void;
+/**
+ * Observe element sizes; the callback runs on the next animation frame so
+ * layout changes it causes never trigger "ResizeObserver loop" errors.
+ */
+export declare function observeResize(elements: Element[], callback: () => void): () => void;
+//# sourceMappingURL=scheduling.d.ts.map

package/declarations/utils/data-grid/scheduling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../../src/utils/data-grid/scheduling.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAK/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,MAAM,IAAI,GACnB,MAAM,IAAI,CAWZ"}

package/declarations/utils/data-grid/schema.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Port of EUI 123.1.0 `components/datagrid/utils/data_grid_schema.tsx`:
+ * default schema detectors/comparators and in-memory schema detection.
+ * Sort labels are i18n `{ token, default }` pairs instead of `<EuiI18n>`.
+ */
+import type { EuiDataGridColumn, EuiDataGridInMemory, EuiDataGridInMemoryValues, EuiDataGridSchema, EuiDataGridSchemaDetector } from './types.ts';
+export declare const schemaDetectors: EuiDataGridSchemaDetector[];
+export declare function defaultComparator<T>(a: T, b: T, direction: 'asc' | 'desc'): number;
+/** Port of `useDetectSchema` (pure): detect column types from in-memory values. */
+export declare function detectSchema({ columns, inMemory, inMemoryValues, schemaDetectors: detectors, autoDetectSchema }: {
+    columns: EuiDataGridColumn[];
+    inMemory?: EuiDataGridInMemory;
+    inMemoryValues: EuiDataGridInMemoryValues;
+    schemaDetectors: EuiDataGridSchemaDetector[];
+    autoDetectSchema: boolean;
+}): EuiDataGridSchema;
+/** Port of `useMergedSchema`: explicit column schemas win over detection. */
+export declare function mergeSchema(detected: EuiDataGridSchema, columns: EuiDataGridColumn[]): EuiDataGridSchema;
+/** Given a provided schema, return the details for the schema. */
+export declare function getDetailsForSchema(detectors: EuiDataGridSchemaDetector[], providedSchema: string | null | undefined): EuiDataGridSchemaDetector | undefined;
+//# sourceMappingURL=schema.d.ts.map

package/declarations/utils/data-grid/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/utils/data-grid/schema.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAiBpB,eAAO,MAAM,eAAe,EAAE,yBAAyB,EAyKtD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,CAAC,EAAE,CAAC,EACJ,CAAC,EAAE,CAAC,EACJ,SAAS,EAAE,KAAK,GAAG,MAAM,GACxB,MAAM,CAIR;AAMD,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,QAAQ,EACR,cAAc,EACd,eAAe,EAAE,SAAS,EAC1B,gBAAgB,EACjB,EAAE;IACD,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,cAAc,EAAE,yBAAyB,CAAC;IAC1C,eAAe,EAAE,yBAAyB,EAAE,CAAC;IAC7C,gBAAgB,EAAE,OAAO,CAAC;CAC3B,GAAG,iBAAiB,CAuDpB;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CACzB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,iBAAiB,EAAE,GAC3B,iBAAiB,CAMnB;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,yBAAyB,EAAE,EACtC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACxC,yBAAyB,GAAG,SAAS,CAEvC"}

package/declarations/utils/data-grid/sorting.d.ts

@@ -0,0 +1,13 @@
+import type { EuiDataGridInMemory, EuiDataGridInMemoryValues, EuiDataGridSchema, EuiDataGridSchemaDetector, EuiDataGridSorting } from './types.ts';
+/**
+ * Row order produced by in-memory sorting: `map[sortedPosition] = dataRowIndex`.
+ * Empty unless `inMemory.level === 'sorting'` and columns are sorted.
+ */
+export declare function computeSortedRowMap({ sorting, inMemory, inMemoryValues, schema, schemaDetectors }: {
+    sorting?: EuiDataGridSorting;
+    inMemory?: EuiDataGridInMemory;
+    inMemoryValues: EuiDataGridInMemoryValues;
+    schema: EuiDataGridSchema;
+    schemaDetectors: EuiDataGridSchemaDetector[];
+}): number[];
+//# sourceMappingURL=sorting.d.ts.map

package/declarations/utils/data-grid/sorting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sorting.d.ts","sourceRoot":"","sources":["../../../src/utils/data-grid/sorting.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,QAAQ,EACR,cAAc,EACd,MAAM,EACN,eAAe,EAChB,EAAE;IACD,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,cAAc,EAAE,yBAAyB,CAAC;IAC1C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,eAAe,EAAE,yBAAyB,EAAE,CAAC;CAC9C,GAAG,MAAM,EAAE,CAwCX"}

package/declarations/utils/data-grid/tabular-copy.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Port of EUI 123.1.0 `services/copy/tabular_copy.tsx`: visually hidden
+ * marker characters placed in tabular content are turned into tabs and
+ * newlines when a selection is copied, so it pastes cleanly into a
+ * spreadsheet. The markers are rendered by the grid as
+ * `<span class="euiScreenReaderOnly" aria-hidden="true" data-tabular-copy-marker>`.
+ */
+export declare const CHARS: {
+    readonly NEWLINE: "↵";
+    readonly TAB: "↦";
+    readonly TABULAR_CONTENT_BOUND: "𐘂𐘂";
+    readonly NO_COPY_BOUND: "✄𐘗";
+};
+/**
+ * Finds all content between two no-copy bounds (the `u` flag, unlike
+ * upstream, reads the bound's astral character as one code point).
+ */
+export declare const noCopyBoundsRegex: RegExp;
+/**
+ * Strips existing newlines and replaces the hidden characters with the
+ * spacing needed to paste cleanly into a spreadsheet. Registered on the
+ * document (a static handler, so it is only added once).
+ */
+export declare function onTabularCopy(event: ClipboardEvent): void;
+//# sourceMappingURL=tabular-copy.d.ts.map

package/declarations/utils/data-grid/tabular-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabular-copy.d.ts","sourceRoot":"","sources":["../../../src/utils/data-grid/tabular-copy.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AAIH,eAAO,MAAM,KAAK;;;;;CAMR,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAG7B,CAAC;AASF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAmBzD"}

package/declarations/utils/data-grid/toolbar.d.ts

@@ -0,0 +1,14 @@
+/** Ports of the toolbar option helpers in upstream `data_grid_toolbar.tsx`. */
+import type { EuiDataGridToolBarVisibilityOptions } from './types.ts';
+import type { ComponentLike } from '@glint/template';
+/** Whether a toolbar control is shown (missing options default to shown). */
+export declare function checkOrDefaultToolBarDisplayOptions(arg: boolean | EuiDataGridToolBarVisibilityOptions | undefined, option: keyof EuiDataGridToolBarVisibilityOptions): boolean;
+/** Nested options of selectors (e.g. `showColumnSelector.allowHide`). */
+export declare function getNestedObjectOptions<T extends object>(controlOption: boolean | T | undefined, objectKey: keyof T): boolean;
+/**
+ * Port of upstream `renderAdditionalControls`: the `additionalControls`
+ * component for a toolbar position. A single component (or a single `left`
+ * component) goes to the left append position.
+ */
+export declare function getAdditionalControl(toolbarVisibility: boolean | EuiDataGridToolBarVisibilityOptions | undefined, position: 'left.prepend' | 'left.append' | 'right'): ComponentLike | undefined;
+//# sourceMappingURL=toolbar.d.ts.map

package/declarations/utils/data-grid/toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../../src/utils/data-grid/toolbar.ts"],"names":[],"mappings":"AAQA,+EAA+E;AAC/E,OAAO,KAAK,EAGV,mCAAmC,EACpC,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,6EAA6E;AAC7E,wBAAgB,mCAAmC,CACjD,GAAG,EAAE,OAAO,GAAG,mCAAmC,GAAG,SAAS,EAC9D,MAAM,EAAE,MAAM,mCAAmC,GAChD,OAAO,CAKT;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,aAAa,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS,EACtC,SAAS,EAAE,MAAM,CAAC,GACjB,OAAO,CAOT;AAYD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,OAAO,GAAG,mCAAmC,GAAG,SAAS,EAC5E,QAAQ,EAAE,cAAc,GAAG,aAAa,GAAG,OAAO,GACjD,aAAa,GAAG,SAAS,CAY3B"}