@itwin/presentation-hierarchies-react 2.0.0-alpha.52 → 2.0.0-alpha.54

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/lib/esm/presentation-hierarchies-react/Renderers.d.ts +62 -55
  3. package/lib/esm/presentation-hierarchies-react/Renderers.d.ts.map +1 -1
  4. package/lib/esm/presentation-hierarchies-react/TreeNode.d.ts +33 -29
  5. package/lib/esm/presentation-hierarchies-react/TreeNode.d.ts.map +1 -1
  6. package/lib/esm/presentation-hierarchies-react/UseIModelTree.d.ts +27 -16
  7. package/lib/esm/presentation-hierarchies-react/UseIModelTree.d.ts.map +1 -1
  8. package/lib/esm/presentation-hierarchies-react/UseIModelTree.js +181 -54
  9. package/lib/esm/presentation-hierarchies-react/UseIModelTree.js.map +1 -1
  10. package/lib/esm/presentation-hierarchies-react/UseNodeHighlighting.d.ts +12 -6
  11. package/lib/esm/presentation-hierarchies-react/UseNodeHighlighting.d.ts.map +1 -1
  12. package/lib/esm/presentation-hierarchies-react/UseNodeHighlighting.js +54 -49
  13. package/lib/esm/presentation-hierarchies-react/UseNodeHighlighting.js.map +1 -1
  14. package/lib/esm/presentation-hierarchies-react/UseSelectionHandler.d.ts +7 -30
  15. package/lib/esm/presentation-hierarchies-react/UseSelectionHandler.d.ts.map +1 -1
  16. package/lib/esm/presentation-hierarchies-react/UseSelectionHandler.js +116 -74
  17. package/lib/esm/presentation-hierarchies-react/UseSelectionHandler.js.map +1 -1
  18. package/lib/esm/presentation-hierarchies-react/UseTree.d.ts +67 -54
  19. package/lib/esm/presentation-hierarchies-react/UseTree.d.ts.map +1 -1
  20. package/lib/esm/presentation-hierarchies-react/UseTree.js +283 -226
  21. package/lib/esm/presentation-hierarchies-react/UseTree.js.map +1 -1
  22. package/lib/esm/presentation-hierarchies-react/Utils.js +44 -27
  23. package/lib/esm/presentation-hierarchies-react/Utils.js.map +1 -1
  24. package/lib/esm/presentation-hierarchies-react/internal/DisposePolyfill.js +6 -7
  25. package/lib/esm/presentation-hierarchies-react/internal/DisposePolyfill.js.map +1 -1
  26. package/lib/esm/presentation-hierarchies-react/internal/TreeActions.js +271 -298
  27. package/lib/esm/presentation-hierarchies-react/internal/TreeActions.js.map +1 -1
  28. package/lib/esm/presentation-hierarchies-react/internal/TreeLoader.js +91 -82
  29. package/lib/esm/presentation-hierarchies-react/internal/TreeLoader.js.map +1 -1
  30. package/lib/esm/presentation-hierarchies-react/internal/TreeModel.d.ts +3 -47
  31. package/lib/esm/presentation-hierarchies-react/internal/TreeModel.js +114 -151
  32. package/lib/esm/presentation-hierarchies-react/internal/TreeModel.js.map +1 -1
  33. package/lib/esm/presentation-hierarchies-react/internal/UseUnifiedSelection.d.ts +32 -37
  34. package/lib/esm/presentation-hierarchies-react/internal/UseUnifiedSelection.d.ts.map +1 -1
  35. package/lib/esm/presentation-hierarchies-react/internal/UseUnifiedSelection.js +128 -101
  36. package/lib/esm/presentation-hierarchies-react/internal/UseUnifiedSelection.js.map +1 -1
  37. package/lib/esm/presentation-hierarchies-react/internal/Utils.js +29 -44
  38. package/lib/esm/presentation-hierarchies-react/internal/Utils.js.map +1 -1
  39. package/lib/esm/presentation-hierarchies-react/stratakit/ErrorItemRenderer.d.ts +24 -13
  40. package/lib/esm/presentation-hierarchies-react/stratakit/ErrorItemRenderer.d.ts.map +1 -1
  41. package/lib/esm/presentation-hierarchies-react/stratakit/ErrorItemRenderer.js +344 -67
  42. package/lib/esm/presentation-hierarchies-react/stratakit/ErrorItemRenderer.js.map +1 -1
  43. package/lib/esm/presentation-hierarchies-react/stratakit/FlatTreeNode.d.ts +16 -15
  44. package/lib/esm/presentation-hierarchies-react/stratakit/FlatTreeNode.d.ts.map +1 -1
  45. package/lib/esm/presentation-hierarchies-react/stratakit/FlatTreeNode.js +78 -60
  46. package/lib/esm/presentation-hierarchies-react/stratakit/FlatTreeNode.js.map +1 -1
  47. package/lib/esm/presentation-hierarchies-react/stratakit/LocalizationContext.d.ts +122 -117
  48. package/lib/esm/presentation-hierarchies-react/stratakit/LocalizationContext.d.ts.map +1 -1
  49. package/lib/esm/presentation-hierarchies-react/stratakit/LocalizationContext.js +59 -38
  50. package/lib/esm/presentation-hierarchies-react/stratakit/LocalizationContext.js.map +1 -1
  51. package/lib/esm/presentation-hierarchies-react/stratakit/RootErrorRenderer.d.ts +16 -5
  52. package/lib/esm/presentation-hierarchies-react/stratakit/RootErrorRenderer.d.ts.map +1 -1
  53. package/lib/esm/presentation-hierarchies-react/stratakit/RootErrorRenderer.js +161 -35
  54. package/lib/esm/presentation-hierarchies-react/stratakit/RootErrorRenderer.js.map +1 -1
  55. package/lib/esm/presentation-hierarchies-react/stratakit/TreeAction.d.ts +21 -17
  56. package/lib/esm/presentation-hierarchies-react/stratakit/TreeAction.d.ts.map +1 -1
  57. package/lib/esm/presentation-hierarchies-react/stratakit/TreeAction.js +84 -31
  58. package/lib/esm/presentation-hierarchies-react/stratakit/TreeAction.js.map +1 -1
  59. package/lib/esm/presentation-hierarchies-react/stratakit/TreeErrorRenderer.d.ts +22 -14
  60. package/lib/esm/presentation-hierarchies-react/stratakit/TreeErrorRenderer.d.ts.map +1 -1
  61. package/lib/esm/presentation-hierarchies-react/stratakit/TreeErrorRenderer.js +61 -26
  62. package/lib/esm/presentation-hierarchies-react/stratakit/TreeErrorRenderer.js.map +1 -1
  63. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeFilterAction.d.ts +15 -6
  64. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeFilterAction.d.ts.map +1 -1
  65. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeFilterAction.js +75 -25
  66. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeFilterAction.js.map +1 -1
  67. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeRenameAction.d.ts +16 -40
  68. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeRenameAction.d.ts.map +1 -1
  69. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeRenameAction.js +140 -61
  70. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeRenameAction.js.map +1 -1
  71. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeRenderer.d.ts +14 -42
  72. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeRenderer.d.ts.map +1 -1
  73. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeRenderer.js +489 -121
  74. package/lib/esm/presentation-hierarchies-react/stratakit/TreeNodeRenderer.js.map +1 -1
  75. package/lib/esm/presentation-hierarchies-react/stratakit/TreeRenderer.d.ts +58 -55
  76. package/lib/esm/presentation-hierarchies-react/stratakit/TreeRenderer.d.ts.map +1 -1
  77. package/lib/esm/presentation-hierarchies-react/stratakit/TreeRenderer.js +412 -181
  78. package/lib/esm/presentation-hierarchies-react/stratakit/TreeRenderer.js.map +1 -1
  79. package/lib/esm/presentation-hierarchies-react.d.ts +17 -17
  80. package/lib/esm/presentation-hierarchies-react.js +15 -18
  81. package/package.json +17 -14
  82. package/lib/esm/presentation-hierarchies-react/Renderers.js +0 -6
  83. package/lib/esm/presentation-hierarchies-react/Renderers.js.map +0 -1
  84. package/lib/esm/presentation-hierarchies-react/TreeNode.js +0 -6
  85. package/lib/esm/presentation-hierarchies-react/TreeNode.js.map +0 -1
  86. package/lib/esm/presentation-hierarchies-react/Utils.d.ts +0 -8
  87. package/lib/esm/presentation-hierarchies-react/Utils.d.ts.map +0 -1
  88. package/lib/esm/presentation-hierarchies-react/internal/DisposePolyfill.d.ts +0 -2
  89. package/lib/esm/presentation-hierarchies-react/internal/DisposePolyfill.d.ts.map +0 -1
  90. package/lib/esm/presentation-hierarchies-react/internal/TreeActions.d.ts +0 -53
  91. package/lib/esm/presentation-hierarchies-react/internal/TreeActions.d.ts.map +0 -1
  92. package/lib/esm/presentation-hierarchies-react/internal/TreeLoader.d.ts +0 -62
  93. package/lib/esm/presentation-hierarchies-react/internal/TreeLoader.d.ts.map +0 -1
  94. package/lib/esm/presentation-hierarchies-react/internal/TreeModel.d.ts.map +0 -1
  95. package/lib/esm/presentation-hierarchies-react/internal/Utils.d.ts +0 -23
  96. package/lib/esm/presentation-hierarchies-react/internal/Utils.d.ts.map +0 -1
  97. package/lib/esm/presentation-hierarchies-react.d.ts.map +0 -1
  98. package/lib/esm/presentation-hierarchies-react.js.map +0 -1
@@ -1,8 +1,10 @@
1
+ import { TreeNode } from "./TreeNode.js";
2
+ import { RootErrorRendererProps, TreeRendererProps } from "./Renderers.js";
3
+ import { UseUnifiedTreeSelectionProps } from "./internal/UseUnifiedSelection.js";
1
4
  import { GenericInstanceFilter, HierarchyProvider, HierarchySearchPath } from "@itwin/presentation-hierarchies";
2
5
  import { IPrimitiveValueFormatter } from "@itwin/presentation-shared";
3
- import { UseUnifiedTreeSelectionProps } from "./internal/UseUnifiedSelection.js";
4
- import { RootErrorRendererProps, TreeRendererProps } from "./Renderers.js";
5
- import { TreeNode } from "./TreeNode.js";
6
+
7
+ //#region src/presentation-hierarchies-react/UseTree.d.ts
6
8
  /**
7
9
  * A React hook that creates state for a tree component.
8
10
  *
@@ -15,7 +17,7 @@ import { TreeNode } from "./TreeNode.js";
15
17
  * @see `useIModelTree`
16
18
  * @public
17
19
  */
18
- export declare function useTree(props: UseTreeProps): UseTreeResult;
20
+ declare function useTree(props: UseTreeProps): UseTreeResult;
19
21
  /**
20
22
  * A React hook that creates state for a tree component, that is integrated with unified selection
21
23
  * through the given selection storage (previously the storage was provided through the, now
@@ -31,64 +33,75 @@ export declare function useTree(props: UseTreeProps): UseTreeResult;
31
33
  * @see `UnifiedSelectionProvider`
32
34
  * @public
33
35
  */
34
- export declare function useUnifiedSelectionTree({ sourceName, selectionStorage, createSelectableForGenericNode, ...props }: UseTreeProps & UseUnifiedTreeSelectionProps): UseTreeResult;
36
+ declare function useUnifiedSelectionTree({
37
+ sourceName,
38
+ selectionStorage,
39
+ createSelectableForGenericNode,
40
+ ...props
41
+ }: UseTreeProps & UseUnifiedTreeSelectionProps): UseTreeResult;
35
42
  /** @public */
36
- export interface UseTreeProps {
37
- /** Provides the hierarchy provider for the tree. */
38
- getHierarchyProvider: () => HierarchyProvider;
39
- /** Provides paths to search nodes. */
40
- getSearchPaths?: ({ abortSignal }: {
41
- abortSignal: AbortSignal;
42
- }) => Promise<HierarchySearchPath[] | undefined>;
43
- /**
44
- * Callback that is called just after a certain action is finished.
45
- * Can be used for performance tracking.
46
- */
47
- onPerformanceMeasured?: (action: "initial-load" | "hierarchy-level-load" | "reload", duration: number) => void;
48
- /** Action to perform when hierarchy level contains more items that the specified limit. */
49
- onHierarchyLimitExceeded?: (props: {
50
- parentId?: string;
51
- filter?: GenericInstanceFilter;
52
- limit?: number | "unbounded";
53
- }) => void;
54
- /** Action to perform when an error occurs while loading hierarchy. */
55
- onHierarchyLoadError?: (props: {
56
- parentId?: string;
57
- type: "timeout" | "unknown";
58
- error: unknown;
59
- }) => void;
43
+ interface UseTreeProps {
44
+ /** Provides the hierarchy provider for the tree. */
45
+ getHierarchyProvider: () => HierarchyProvider;
46
+ /** Provides paths to search nodes. */
47
+ getSearchPaths?: ({
48
+ abortSignal
49
+ }: {
50
+ abortSignal: AbortSignal;
51
+ }) => Promise<HierarchySearchPath[] | undefined>;
52
+ /**
53
+ * Callback that is called just after a certain action is finished.
54
+ * Can be used for performance tracking.
55
+ */
56
+ onPerformanceMeasured?: (action: "initial-load" | "hierarchy-level-load" | "reload", duration: number) => void;
57
+ /** Action to perform when hierarchy level contains more items that the specified limit. */
58
+ onHierarchyLimitExceeded?: (props: {
59
+ parentId?: string;
60
+ filter?: GenericInstanceFilter;
61
+ limit?: number | "unbounded";
62
+ }) => void;
63
+ /** Action to perform when an error occurs while loading hierarchy. */
64
+ onHierarchyLoadError?: (props: {
65
+ parentId?: string;
66
+ type: "timeout" | "unknown";
67
+ error: unknown;
68
+ }) => void;
60
69
  }
61
70
  /** @public */
62
- export type UseTreeResult = {
63
- /**
64
- * Specifies whether tree is reloading or not. It is set to `false` when initial tree load is in progress to check if
65
- * or tree is reloading.
66
- */
67
- isReloading: boolean;
68
- /** Get a tree node by id */
69
- getNode: (nodeId: string) => TreeNode | undefined;
70
- /** Sets a formatter for the primitive values that are displayed in the hierarchy. */
71
- setFormatter: (formatter: IPrimitiveValueFormatter | undefined) => void;
71
+ type UseTreeResult = {
72
+ /**
73
+ * Specifies whether tree is reloading or not. It is set to `false` when initial tree load is in progress to check if
74
+ * or tree is reloading.
75
+ */
76
+ isReloading: boolean;
77
+ /**
78
+ * Get a tree node by id
79
+ */
80
+ getNode: (nodeId: string) => TreeNode | undefined;
81
+ /**
82
+ * Sets a formatter for the primitive values that are displayed in the hierarchy.
83
+ */
84
+ setFormatter: (formatter: IPrimitiveValueFormatter | undefined) => void;
72
85
  } & RendererProps;
73
86
  /**.
74
87
  * @alpha
75
88
  */
76
89
  type RendererProps = {
77
- /**
78
- * An object containing information used to render root error handling UI.
79
- * Use in combination with `RootErrorRenderer` or your custom implementation.
80
- * Defined when root nodes fail to load.
81
- */
82
- rootErrorRendererProps: RootErrorRendererProps;
90
+ /**
91
+ * An object containing information used to render root error handling UI.
92
+ * Use in combination with `RootErrorRenderer` or your custom implementation.
93
+ * Defined when root nodes fail to load.
94
+ */
95
+ rootErrorRendererProps: RootErrorRendererProps;
83
96
  } | {
84
- /** Is undefined when rootNodes where successfully loaded or are in initial loading process */
85
- rootErrorRendererProps: undefined;
86
- /**
87
- * An object containing information used to render tree.
88
- * Use with `TreeRenderer` or your custom implementation.
89
- * Is undefined on initial loading process.
90
- */
91
- treeRendererProps?: TreeRendererProps;
97
+ /** Is undefined when rootNodes where successfully loaded or are in initial loading process */rootErrorRendererProps: undefined;
98
+ /**
99
+ * An object containing information used to render tree.
100
+ * Use with `TreeRenderer` or your custom implementation.
101
+ * Is undefined on initial loading process.
102
+ */
103
+ treeRendererProps?: TreeRendererProps;
92
104
  };
93
- export {};
105
+ //#endregion
106
+ export { UseTreeProps, UseTreeResult, useTree, useUnifiedSelectionTree };
94
107
  //# sourceMappingURL=UseTree.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"UseTree.d.ts","sourceRoot":"","sources":["../../../src/presentation-hierarchies-react/UseTree.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAiB,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC/H,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAA2B,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAE1G,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAG1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,UAAU,EACV,gBAAgB,EAChB,8BAA8B,EAC9B,GAAG,KAAK,EACT,EAAE,YAAY,GAAG,4BAA4B,GAAG,aAAa,CAa7D;AAED,cAAc;AACd,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;IAC9C,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,mBAAmB,EAAE,GAAG,SAAS,CAAC,CAAC;IAC/G;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,GAAG,sBAAsB,GAAG,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/G,2FAA2F;IAC3F,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,KAAK,IAAI,CAAC;IAChI,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC5G;AAED,cAAc;AACd,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;IAClD,qFAAqF;IACrF,YAAY,EAAE,CAAC,SAAS,EAAE,wBAAwB,GAAG,SAAS,KAAK,IAAI,CAAC;CACzE,GAAG,aAAa,CAAC;AAElB;;GAEG;AACH,KAAK,aAAa,GACd;IACE;;;;OAIG;IACH,sBAAsB,EAAE,sBAAsB,CAAC;CAChD,GACD;IACE,8FAA8F;IAC9F,sBAAsB,EAAE,SAAS,CAAC;IAClC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,CAAC"}
1
+ {"version":3,"file":"UseTree.d.ts","names":[],"sources":["../../../src/presentation-hierarchies-react/UseTree.ts"],"mappings":";;;;;;;;;AAiCA;;;;;;;;;AAoBA;iBApBgB,OAAA,CAAQ,KAAA,EAAO,YAAA,GAAe,aAAA;;;;;;;;;;;;;;;;iBAoB9B,uBAAA,CAAA;EACd,UAAA;EACA,gBAAA;EACA,8BAAA;EAAA,GACG;AAAA,GACF,YAAA,GAAe,4BAAA,GAA+B,aAAA;;UAgBhC,YAAA;EAhBgC;EAkB/C,oBAAA,QAA4B,iBAAA;EAlBgC;EAoB5D,cAAA;IAAoB;EAAA;IAAiB,WAAA,EAAa,WAAA;EAAA,MAAkB,OAAA,CAAQ,mBAAA;EAFhD;;;;EAO5B,qBAAA,IAAyB,MAAA,sDAA4D,QAAA;EAEpB;EAAjE,wBAAA,IAA4B,KAAA;IAAS,QAAA;IAAmB,MAAA,GAAS,qBAAA;IAAuB,KAAA;EAAA;EAPpE;EASpB,oBAAA,IAAwB,KAAA;IAAS,QAAA;IAAmB,IAAA;IAA6B,KAAA;EAAA;AAAA;;KAIvE,aAAA;EANV;;;;EAWA,WAAA;EAX4B;;;EAe5B,OAAA,GAAU,MAAA,aAAmB,QAAA;EAboD;;;EAiBjF,YAAA,GAAe,SAAA,EAAW,wBAAA;AAAA,IACxB,aAAA;;;;KAKC,aAAA;EALD;;;;;EAYE,sBAAA,EAAwB,sBAAA;AAAA;EAb5B,8FAiBI,sBAAA;EAjBW;;;;AACC;EAsBZ,iBAAA,GAAoB,iBAAA;AAAA"}