photon-grid-core 0.0.1

package/types/row.types.d.ts

@@ -0,0 +1,127 @@
+export type RowNodeType = 'data' | 'group' | 'group-footer' | 'summary' | 'detail' | 'loading';
+/**
+ * Deterministic `nodeId` for a master row's detail node — shared by
+ * `RowModel.createDetailNode` (construction) and `DetailRowRenderer`
+ * (lookup) so the two never drift out of sync.
+ */
+export declare function detailNodeId(parentNodeId: string): string;
+export interface RowNode {
+    nodeId: string;
+    rowIndex: number;
+    data: Record<string, unknown>;
+    type: RowNodeType;
+    selected: boolean;
+    expanded: boolean;
+    editable: boolean;
+    level: number;
+    parent: RowNode | null;
+    children: RowNode[];
+    groupKey?: string;
+    groupField?: string;
+    groupValue?: unknown;
+    childCount?: number;
+    /**
+     * Computed aggregation results for `type === 'group'` nodes.
+     * Keyed by `colDef.field`; value is the aggregated number or `null` when no
+     * qualifying leaf rows existed.  Populated by {@link AggregationEngine};
+     * `undefined` when no columns have {@link ColumnDef.aggFunc} configured.
+     */
+    aggregatedValues?: Record<string, unknown>;
+    height: number;
+    top: number;
+    cssClass?: string;
+    detail?: Record<string, unknown>;
+    /**
+     * For `type === 'detail'` nodes: the `nodeId` of the master row this
+     * detail section belongs to. Enables O(1) lookup without walking `parent`.
+     */
+    parentNodeId?: string;
+    /**
+     * Tree Data only (see `TreeDataService`). `true` when the underlying
+     * hierarchy has 1+ children for this node — distinguishes a genuine leaf
+     * from a node whose children just haven't been lazy-loaded yet, so the
+     * renderer knows to draw a toggle even before `children` is populated.
+     */
+    hasChildren?: boolean;
+    /**
+     * Tree Data only, for `lazyLoadChildren`. `undefined`/`false` means this
+     * node's children haven't been fetched yet — expanding it should trigger
+     * `TreeDataService.loadChildren` instead of reading `children` directly.
+     */
+    childrenLoaded?: boolean;
+    /**
+     * Tree Data only, for `getDataPath` mode. `true` for a synthetic
+     * intermediate node representing a path prefix with no real backing
+     * record (e.g. `"Electronics"` in `["Electronics", "Phones", "iPhone"]`)
+     * — mirrors how `GroupingEngine` synthesizes group-header rows, so the
+     * renderer/selection/drag layers can treat it as non-editable and (for
+     * drag-to-reparent) as read-only.
+     */
+    isTreeFiller?: boolean;
+    /**
+     * Tree Data only. The `top` pixel position where this node's own subtree
+     * ends in the current flattened, laid-out `visibleRows` — i.e. the `top`
+     * of whatever row (sibling, or an ancestor's next sibling) immediately
+     * follows its last visible descendant. Annotated by
+     * `TreeDataService.annotateSubtreeExtents` right after layout, and used by
+     * `TreeStickyRowTracker` to decide when a stuck ancestor row should be
+     * pushed off by the next block — the same "block end" concept
+     * `StickyRowTracker` gets for free from a Master/Detail row's single
+     * fixed-position detail row.
+     */
+    subtreeEndTop?: number;
+}
+export interface RowGroupNode extends RowNode {
+    type: 'group';
+    groupKey: string;
+    groupField: string;
+    groupValue: unknown;
+    childCount: number;
+    aggregatedValues: Record<string, unknown>;
+}
+export interface RowDataNode extends RowNode {
+    type: 'data';
+}
+/**
+ * A read-only summary row rendered **below** the last leaf of an expanded group.
+ * Mirrors the group header's {@link RowNode.aggregatedValues} so the same
+ * totals/averages are visible at the bottom of every group — identical to
+ * AG Grid's `groupIncludeFooter` behaviour.
+ *
+ * Cells are fully selectable and copyable; editing is intentionally blocked
+ * because the values are computed, not stored in `data`.
+ */
+export interface RowGroupFooterNode extends RowNode {
+    type: 'group-footer';
+    groupKey: string;
+    groupField: string;
+    groupValue: unknown;
+    childCount: number;
+    aggregatedValues: Record<string, unknown>;
+}
+export interface RowDetailNode extends RowNode {
+    type: 'detail';
+    parentRow: RowNode;
+    detail: Record<string, unknown>;
+}
+export interface RowRange {
+    startIndex: number;
+    endIndex: number;
+}
+export interface RowDropPayload {
+    draggedRows: RowNode[];
+    targetRow: RowNode;
+    position: 'before' | 'after' | 'inside';
+}
+export interface RowClickPayload {
+    row: RowNode;
+    event: MouseEvent;
+    rowIndex: number;
+}
+export interface RowEditPayload {
+    row: RowNode;
+    field: string;
+    oldValue: unknown;
+    newValue: unknown;
+}
+//# sourceMappingURL=row.types.d.ts.map

package/types/row.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row.types.d.ts","sourceRoot":"","sources":["../../src/types/row.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/F;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,WAAW,CAAC;IAElB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IAEZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAa,SAAQ,OAAO;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,WAAY,SAAQ,OAAO;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IACjD,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,aAAc,SAAQ,OAAO;IAC5C,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/types/row.types.js

@@ -0,0 +1,9 @@
+/**
+ * Deterministic `nodeId` for a master row's detail node — shared by
+ * `RowModel.createDetailNode` (construction) and `DetailRowRenderer`
+ * (lookup) so the two never drift out of sync.
+ */
+export function detailNodeId(parentNodeId) {
+    return `detail_${parentNodeId}`;
+}
+//# sourceMappingURL=row.types.js.map

package/types/row.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row.types.js","sourceRoot":"","sources":["../../src/types/row.types.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,OAAO,UAAU,YAAY,EAAE,CAAC;AAClC,CAAC"}

package/types/theme.types.d.ts

@@ -0,0 +1,159 @@
+export interface ColorTokens {
+    primary: string;
+    primaryHover: string;
+    primaryActive: string;
+    primaryText: string;
+    secondary: string;
+    secondaryHover: string;
+    surface: string;
+    surfaceRaised: string;
+    surfaceOverlay: string;
+    surfaceSunken: string;
+    background: string;
+    backgroundAlt: string;
+    border: string;
+    borderStrong: string;
+    borderFocus: string;
+    textPrimary: string;
+    textSecondary: string;
+    textDisabled: string;
+    textInverse: string;
+    headerBackground: string;
+    headerText: string;
+    headerBorder: string;
+    headerHover: string;
+    rowBackground: string;
+    rowBackgroundAlt: string;
+    rowHover: string;
+    rowSelected: string;
+    rowSelectedBorder: string;
+    cellEditBackground: string;
+    cellEditBorder: string;
+    selectionBackground: string;
+    selectionBorder: string;
+    selectionCorner: string;
+    footerBackground: string;
+    footerText: string;
+    footerBorder: string;
+    pinnedBackground: string;
+    pinnedShadow: string;
+    filterBackground: string;
+    filterBorder: string;
+    filterActiveBackground: string;
+    filterActiveBorder: string;
+    scrollbarTrack: string;
+    scrollbarThumb: string;
+    scrollbarThumbHover: string;
+    resizeHandleColor: string;
+    resizeHandleActiveColor: string;
+    dragPreviewBackground: string;
+    dragPreviewBorder: string;
+    dragOverHighlight: string;
+    checkboxBackground: string;
+    checkboxCheckedBackground: string;
+    checkboxBorder: string;
+    badgeBackground: string;
+    badgeText: string;
+    groupRowBackground: string;
+    groupRowBorder: string;
+    tooltipBackground: string;
+    tooltipText: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+    successLight: string;
+    warningLight: string;
+    errorLight: string;
+    infoLight: string;
+}
+export interface TypographyTokens {
+    fontFamily: string;
+    fontFamilyMono: string;
+    fontSizeXs: string;
+    fontSizeSm: string;
+    fontSizeMd: string;
+    fontSizeLg: string;
+    fontSizeXl: string;
+    fontWeightRegular: string;
+    fontWeightMedium: string;
+    fontWeightSemiBold: string;
+    fontWeightBold: string;
+    lineHeightTight: string;
+    lineHeightBase: string;
+    lineHeightRelaxed: string;
+    letterSpacingTight: string;
+    letterSpacingBase: string;
+    letterSpacingWide: string;
+}
+export interface SpacingTokens {
+    xs: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    xxl: string;
+}
+export interface SizingTokens {
+    rowHeightSm: string;
+    rowHeightMd: string;
+    rowHeightLg: string;
+    headerRowHeight: string;
+    footerRowHeight: string;
+    filterRowHeight: string;
+    scrollbarWidth: string;
+    resizeHandleWidth: string;
+    columnMinWidth: string;
+    checkboxSize: string;
+    iconSizeSm: string;
+    iconSizeMd: string;
+    iconSizeLg: string;
+}
+export interface BorderTokens {
+    radiusSm: string;
+    radiusMd: string;
+    radiusLg: string;
+    radiusPill: string;
+    widthThin: string;
+    widthBase: string;
+    widthThick: string;
+    styleBase: string;
+}
+export interface ShadowTokens {
+    none: string;
+    xs: string;
+    sm: string;
+    md: string;
+    lg: string;
+    pinnedLeft: string;
+    pinnedRight: string;
+    dropdown: string;
+    tooltip: string;
+    dragPreview: string;
+}
+export interface TransitionTokens {
+    durationFast: string;
+    durationBase: string;
+    durationSlow: string;
+    easingBase: string;
+    easingDecelerate: string;
+    easingAccelerate: string;
+}
+export interface ThemeTokens {
+    colors: ColorTokens;
+    typography: TypographyTokens;
+    spacing: SpacingTokens;
+    sizing: SizingTokens;
+    borders: BorderTokens;
+    shadows: ShadowTokens;
+    transitions: TransitionTokens;
+}
+export interface Theme {
+    name: string;
+    displayName: string;
+    mode: 'light' | 'dark';
+    tokens: ThemeTokens;
+    cssClass?: string;
+}
+export type BuiltInThemeName = 'light' | 'dark' | 'contrast' | 'material-light' | 'material-dark';
+//# sourceMappingURL=theme.types.d.ts.map

package/types/theme.types.d.ts.map

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

package/types/theme.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=theme.types.js.map

package/types/theme.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.types.js","sourceRoot":"","sources":["../../src/types/theme.types.ts"],"names":[],"mappings":""}

package/types/tree-data.types.d.ts

@@ -0,0 +1,94 @@
+import type { RowNode } from './row.types';
+import type { ColumnDef } from './column.types';
+/**
+ * How raw row data maps onto a hierarchy. All four map onto one of two
+ * construction algorithms internally (see `tree-node.ts`):
+ *
+ * - `'parentId'`, `'dataPath'`, and `'custom'` are all "flat array + a way to
+ *   compute a per-record `(id, parentId)` pair" — they share the exact same
+ *   two-pass O(n) tree builder, differing only in how that pair is derived.
+ * - `'childrenField'` is the one genuinely different shape (already-nested
+ *   input), needing a single O(n) flattening walk before the same builder
+ *   runs.
+ */
+export type TreeDataMode = 'parentId' | 'childrenField' | 'dataPath' | 'custom';
+/**
+ * Pluggable hierarchy resolver for `mode: 'custom'` — an escape hatch for
+ * shapes `parentId`/`childrenField`/`dataPath` don't cover (e.g. deriving a
+ * parent from two composite fields, or from a lookup table external to the
+ * row itself).
+ */
+export interface TreeHierarchyProvider {
+    /** Returns a stable, unique identifier for `data`. */
+    getId(data: Record<string, unknown>): string;
+    /** Returns the identifier of `data`'s parent, or `null`/`undefined` for a root. */
+    getParentKey(data: Record<string, unknown>): string | null | undefined;
+}
+/**
+ * Configures Tree Data for one grid instance, supplied via
+ * `GridOptions.treeData`. Exactly one `mode` is active at a time; the
+ * fields relevant to the other three modes are ignored.
+ */
+export interface TreeDataConfig {
+    /** Master switch — `false`/omitted leaves the grid in normal flat/grouped mode. */
+    enabled: boolean;
+    mode: TreeDataMode;
+    /** `'parentId'` mode: field holding each record's own id. Default `'id'`. */
+    idField?: string;
+    /** `'parentId'` mode: field holding the parent's id (`null`/absent = root). Default `'parentId'`. */
+    parentIdField?: string;
+    /** `'childrenField'` mode: field holding a record's nested child records. Default `'children'`. */
+    childrenField?: string;
+    /**
+     * `'dataPath'` mode: returns the full ancestor path for a record, e.g.
+     * `['Electronics', 'Phones', 'iPhone 15']`. Intermediate path segments
+     * with no record of their own are synthesized as `isTreeFiller` nodes.
+     */
+    getDataPath?: (data: Record<string, unknown>) => string[];
+    /** `'custom'` mode: supplies id/parent resolution directly. */
+    hierarchyProvider?: TreeHierarchyProvider;
+    /**
+     * Which column shows the expand/collapse toggle and indentation.
+     * Defaults to the first visible column, mirroring Master/Detail's
+     * `toggleColumnId` convention.
+     */
+    toggleColumnId?: string;
+    /**
+     * Initial expansion: `true` expands every node, a `number` expands every
+     * node whose `level` is less than it (e.g. `1` expands just the roots),
+     * omitted/`false` starts fully collapsed.
+     */
+    defaultExpanded?: boolean | number;
+    /**
+     * When provided, a node's children are fetched on first expand instead of
+     * being derived up front — a single `type: 'loading'` placeholder child is
+     * shown until the promise resolves. Only meaningful for `'parentId'` and
+     * `'childrenField'` modes (the other two derive the full hierarchy from
+     * data already in hand).
+     */
+    lazyLoadChildren?: (node: RowNode) => Promise<Record<string, unknown>[]>;
+}
+/** Emitted on `TREE_NODE_TOGGLE_CLICKED` — the raw click, before expansion state changes. */
+export interface TreeNodeToggleClickedPayload {
+    row: RowNode;
+    colDef: ColumnDef;
+}
+/** Emitted on `TREE_NODE_EXPANDED` / `TREE_NODE_COLLAPSED`, after expansion state has changed. */
+export interface TreeNodeTogglePayload {
+    nodeId: string;
+    row: RowNode;
+}
+/** Emitted on `TREE_CHILDREN_LOADED` once a `lazyLoadChildren` promise resolves. */
+export interface TreeChildrenLoadedPayload {
+    nodeId: string;
+    children: Record<string, unknown>[];
+}
+/** One resolved `(id, parentId)` edge — the shared intermediate shape both hierarchy-source algorithms converge on before `buildTree` runs. */
+export interface TreeEdge {
+    id: string;
+    parentId: string | null;
+    record: Record<string, unknown>;
+    /** `true` for a `getDataPath` filler segment with no real backing record. */
+    isFiller?: boolean;
+}
+//# sourceMappingURL=tree-data.types.d.ts.map

package/types/tree-data.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-data.types.d.ts","sourceRoot":"","sources":["../../src/types/tree-data.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAC7C,mFAAmF;IACnF,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACxE;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IAEnB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,mGAAmG;IACnG,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;IAE1D,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAE1C;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAEnC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CAC1E;AAED,6FAA6F;AAC7F,MAAM,WAAW,4BAA4B;IAC3C,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,kGAAkG;AAClG,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd;AAED,oFAAoF;AACpF,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACrC;AAED,+IAA+I;AAC/I,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/types/tree-data.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tree-data.types.js.map

package/types/tree-data.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-data.types.js","sourceRoot":"","sources":["../../src/types/tree-data.types.ts"],"names":[],"mappings":""}