tree-element 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Marco Braak
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,221 @@
+# Html-tree
+
+Tree widget in plain javascript. No jQuery, no framework, no runtime dependencies.
+
+- Loads data from a javascript array or from a url
+- Drag and drop, with autoscroll
+- Keyboard support
+- Saves the open and selected nodes to local storage
+- Right-to-left support
+- Written in Typescript, ships with type declarations
+
+Full documentation: https://mbraak.github.io/tree-element/
+
+## Install
+
+```sh
+npm install tree-element
+```
+
+Or use the bundle directly with a script tag; it exposes a global `TreeElement`:
+
+```html
+<link rel="stylesheet" href="tree_element.css" />
+<script src="tree_element.js"></script>
+```
+
+## Usage
+
+```js fixture=standalone
+import TreeElement from "tree-element";
+import "tree-element/tree_element.css";
+
+const tree = new TreeElement({
+  htmlElement: document.getElementById("tree"),
+  data: [
+    {
+      name: "Saurischia",
+      id: 1,
+      children: [
+        { name: "Herrerasaurians", id: 2 },
+        { name: "Theropods", id: 3 },
+      ],
+    },
+  ],
+  autoOpen: 0,
+  dragAndDrop: true,
+});
+```
+
+`htmlElement` is required. Every other key is an option.
+
+Nodes are plain objects. `name` is displayed, `children` nests, and `id` is
+optional but needed for `getNodeById` and for saving state. Any other key you
+set is kept on the node and can be read back with `getNodesByProperty`.
+
+### Loading from a url
+
+```js
+new TreeElement({
+  htmlElement: document.getElementById("tree"),
+  dataUrl: "/nodes/",
+});
+```
+
+The url can also be set with a `data-url` attribute on the element. Pass a
+function to compute it per node, which is how load-on-demand works: set
+`load_on_demand: true` on a node and its children are fetched when it opens.
+
+```js
+new TreeElement({
+  htmlElement: document.getElementById("tree"),
+  dataUrl: (node) => (node ? `/nodes/?node=${node.id}` : "/nodes/"),
+});
+```
+
+## Options
+
+| Option            | Default              | Description                                                                       |
+| ----------------- | -------------------- | --------------------------------------------------------------------------------- |
+| `animationSpeed`  | `"fast"`             | `"fast"`, `"slow"`, or a number of milliseconds                                   |
+| `autoEscape`      | `true`               | Escape node names. Set to `false` to render html in a name                        |
+| `autoOpen`        | `false`              | `true` opens everything, a number opens that many levels (`0` is the first level) |
+| `buttonLeft`      | `true`               | Put the open/close button left of the title                                       |
+| `classPrefix`     | `"tree-element"`        | The prefix of all css classes                                                     |
+| `closedIcon`      | `►` (`◄` in rtl)     | Html string or element                                                            |
+| `commonClassName` | `"tree-element-common"` | The class that every element gets                                                 |
+| `data`            |                      | The nodes to display                                                              |
+| `dataFilter`      |                      | Transforms the response of `dataUrl` into node data                               |
+| `dataUrl`         | `data-url` attribute | Url, or a function returning a url                                                |
+| `dragAndDrop`     | `false`              | Enable drag and drop                                                              |
+| `keyboardSupport` | `true`               | Navigate with the arrow keys                                                      |
+| `nodeClass`       | `Node`               | Subclass of `Node` to use for nodes                                               |
+| `openFolderDelay` | `500`                | Milliseconds before a folder opens while dragging over it. `false` disables it    |
+| `openedIcon`      | `▼`                  | Html string or element                                                            |
+| `rtl`             | `data-rtl` attribute | Right-to-left rendering                                                           |
+| `saveState`       | `false`              | `true`, or a string to use as the storage key                                     |
+| `selectable`      | `true`               | Allow selecting nodes                                                             |
+| `showEmptyFolder` | `false`              | Show the open/close button for nodes without children                             |
+| `slide`           | `true`               | Animate opening and closing                                                       |
+| `startDndDelay`   | `300`                | Milliseconds to hold before a drag starts                                         |
+| `tabIndex`        | `0`                  | Tab index of the tree element                                                     |
+| `treeClassName`   | `"tree-element"`        | The class of the root `ul`                                                        |
+| `useContextMenu`  | `true`               | Fire `tree.contextmenu` on right click                                            |
+
+### Callbacks
+
+| Option                  | Signature                                 | Description                                                               |
+| ----------------------- | ----------------------------------------- | ------------------------------------------------------------------------- |
+| `onCanMove`             | `(node) => boolean`                       | May this node be dragged?                                                 |
+| `onCanMoveTo`           | `(node, targetNode, position) => boolean` | May it be dropped here? `position` is `"before"`, `"after"` or `"inside"` |
+| `onCanSelectNode`       | `(node) => boolean`                       | May this node be selected?                                                |
+| `onCreateLi`            | `(node, li, isSelected) => void`          | Customise the `li` element of a node                                      |
+| `onDragMove`            | `(node, event) => void`                   | Called while dragging                                                     |
+| `onDragStop`            | `(node, event) => void`                   | Called when a drag ends                                                   |
+| `onGetStateFromStorage` | `() => string`                            | Read saved state yourself                                                 |
+| `onSetStateFromStorage` | `(data) => void`                          | Write saved state yourself                                                |
+| `onIsMoveHandle`        | `(element) => boolean`                    | Is this element a drag handle?                                            |
+
+## Events
+
+Events are `CustomEvent`s dispatched on the tree element. They bubble, and the
+payload is on `event.detail`.
+
+```js
+element.addEventListener("tree.select", (e) => {
+  console.log(e.detail.node);
+});
+```
+
+| Event               | `detail`                                                                                           |
+| ------------------- | -------------------------------------------------------------------------------------------------- |
+| `tree.init`         |                                                                                                    |
+| `tree.click`        | `node`, `originalEvent`                                                                            |
+| `tree.dblclick`     | `node`, `originalEvent`                                                                            |
+| `tree.contextmenu`  | `node`, `originalEvent`                                                                            |
+| `tree.select`       | `node`, `deselectedNode`                                                                           |
+| `tree.deselect`     | `node`                                                                                             |
+| `tree.open`         | `node`                                                                                             |
+| `tree.close`        | `node`                                                                                             |
+| `tree.move`         | `moveInfo` with `movedNode`, `targetNode`, `position`, `previousParent`, `doMove`, `originalEvent` |
+| `tree.refresh`      |                                                                                                    |
+| `tree.set_data`     | `treeData`, `node`                                                                                 |
+| `tree.loading_data` | `node`, `element`                                                                                  |
+| `tree.loaded_data`  | `node`, `element`                                                                                  |
+| `tree.load_failed`  | `response`                                                                                         |
+
+`tree.click` and `tree.move` act on `event.preventDefault()`: it stops the node
+from being selected, and stops the move. For `tree.move`, call
+`e.detail.moveInfo.doMove()` later to perform the move yourself. The other
+events are dispatched as cancelable, but nothing acts on it.
+
+## Methods
+
+Nodes are `Node` instances. Get one with `getNodeById`, `getNodeByName`,
+`getNodeByCallback`, `getNodesByProperty` or `getNode` (from a dom element).
+
+**Data**: `loadData(data, parentNode?)`, `loadDataFromUrl(url?, parentNode?)`, `toJson()`, `refresh()`
+
+**Nodes**: `appendNode(data, parentNode)`, `prependNode(data, parentNode)`, `addNodeAfter(data, node)`, `addNodeBefore(data, node)`, `addParentNode(data, node)`, `updateNode(node, data)`, `removeNode(node)`, `moveNode(node, targetNode, position)`
+
+**Opening**: `openNode(node, slide?)`, `closeNode(node, slide?)`, `toggle(node, slide?)`
+
+**Selection**: `selectNode(node, options?)`, `getSelectedNode()`, `getSelectedNodes()`, `isNodeSelected(node)`, `addToSelection(node, mustSetFocus?)`, `removeFromSelection(node)`, `moveUp()`, `moveDown()`
+
+**State**: `getState()`, `setState(state)`, `getStateFromStorage()`
+
+**Other**: `scrollToNode(node)`, `isDragging()`, `refreshHitAreas()`, `setOption(name, value)`, `getTree()`, `getVersion()`, `deinit()`
+
+## Typescript
+
+The public types are exported from the package entry point:
+
+```ts fixture=standalone
+import TreeElement from "tree-element";
+import type {
+  TreeElementOptions,
+  Node,
+  NodeData,
+  NodeId,
+  SavedState,
+} from "tree-element";
+
+const options: Partial<TreeElementOptions> = { dragAndDrop: true };
+const data: NodeData[] = [{ name: "root", id: 1 }];
+```
+
+`Node` is exported as a type only, so it cannot be used with `instanceof`.
+
+## Entry points
+
+|                           |                                                              |
+| ------------------------- | ------------------------------------------------------------ |
+| `import "tree-element"`      | `lib/index.js`, unbundled es modules                         |
+| `require`, script tag     | `tree_element.js`, minified iife exposing the global `TreeElement` |
+| `tree-element/tree_element.css` | The stylesheet                                               |
+
+`tree_element.debug.js` is the same bundle without minification.
+
+The es modules in `lib` are minified by your own bundler. Private members are
+prefixed with `_`, so add the same terser setting the bundled build uses to get
+the same size:
+
+```js ignore
+terser({ mangle: { properties: { regex: /^_/ } } });
+```
+
+## Development
+
+```sh
+pnpm install
+pnpm devserver     # http://localhost:8080
+pnpm production    # build the bundles, lib and the css
+pnpm docs-check    # type-check the code snippets in the docs
+pnpm ci            # lint, typecheck, check the docs and test
+```
+
+`pnpm test` runs the vitest unit tests and the playwright browser tests.
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE).

package/lib/animation.d.ts

@@ -0,0 +1,5 @@
+export type AnimationSpeed = "fast" | "slow" | number;
+export declare const getAnimationDuration: (duration: AnimationSpeed) => number;
+export declare const slideDown: (element: HTMLElement, animationSpeed: AnimationSpeed, onFinished: () => void) => void;
+export declare const slideUp: (element: HTMLElement, animationSpeed: AnimationSpeed, onFinished: () => void) => void;
+//# sourceMappingURL=animation.d.ts.map

package/lib/animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,eAAO,MAAM,oBAAoB,GAAI,UAAU,cAAc,KAAG,MAM/D,CAAC;AAEF,eAAO,MAAM,SAAS,GACpB,SAAS,WAAW,EACpB,gBAAgB,cAAc,EAC9B,YAAY,MAAM,IAAI,KACrB,IAcF,CAAC;AAEF,eAAO,MAAM,OAAO,GAClB,SAAS,WAAW,EACpB,gBAAgB,cAAc,EAC9B,YAAY,MAAM,IAAI,KACrB,IAaF,CAAC"}

package/lib/animation.js

@@ -0,0 +1,39 @@
+const getAnimationDuration = duration => {
+  if (typeof duration === "number") {
+    return duration;
+  }
+  return duration === "slow" ? 600 : 200;
+};
+const slideDown = (element, animationSpeed, onFinished) => {
+  element.style.display = "block";
+  const animation = element.animate([{
+    height: "0",
+    overflow: "hidden"
+  }, {
+    height: `${element.scrollHeight}px`,
+    overflow: "hidden"
+  }], {
+    duration: getAnimationDuration(animationSpeed)
+  });
+  animation.onfinish = () => {
+    onFinished();
+  };
+};
+const slideUp = (element, animationSpeed, onFinished) => {
+  const animation = element.animate([{
+    height: `${element.scrollHeight}px`,
+    overflow: "hidden"
+  }, {
+    height: "0",
+    overflow: "hidden"
+  }], {
+    duration: getAnimationDuration(animationSpeed)
+  });
+  animation.onfinish = () => {
+    element.style.display = "none";
+    onFinished();
+  };
+};
+
+export { getAnimationDuration, slideDown, slideUp };
+//# sourceMappingURL=animation.js.map

package/lib/animation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.js","sources":["../src/animation.ts"],"sourcesContent":["export type AnimationSpeed = \"fast\" | \"slow\" | number;\n\nexport const getAnimationDuration = (duration: AnimationSpeed): number => {\n  if (typeof duration === \"number\") {\n    return duration;\n  }\n\n  return duration === \"slow\" ? 600 : 200;\n};\n\nexport const slideDown = (\n  element: HTMLElement,\n  animationSpeed: AnimationSpeed,\n  onFinished: () => void,\n): void => {\n  element.style.display = \"block\";\n\n  const animation = element.animate(\n    [\n      { height: \"0\", overflow: \"hidden\" },\n      { height: `${element.scrollHeight}px`, overflow: \"hidden\" },\n    ],\n    { duration: getAnimationDuration(animationSpeed) },\n  );\n\n  animation.onfinish = () => {\n    onFinished();\n  };\n};\n\nexport const slideUp = (\n  element: HTMLElement,\n  animationSpeed: AnimationSpeed,\n  onFinished: () => void,\n): void => {\n  const animation = element.animate(\n    [\n      { height: `${element.scrollHeight}px`, overflow: \"hidden\" },\n      { height: \"0\", overflow: \"hidden\" },\n    ],\n    { duration: getAnimationDuration(animationSpeed) },\n  );\n\n  animation.onfinish = () => {\n    element.style.display = \"none\";\n    onFinished();\n  };\n};"],"names":[],"mappings":"AAEO,MAAM,oBAAoB,GAAI,QAAwB,IAAa;AACxE,EAAA,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;AAChC,IAAA,OAAO,QAAQ;AACjB,EAAA;AAEA,EAAA,OAAO,QAAQ,KAAK,MAAM,GAAG,GAAG,GAAG,GAAG;AACxC;AAEO,MAAM,SAAS,GAAG,CACvB,OAAoB,EACpB,cAA8B,EAC9B,UAAsB,KACb;AACT,EAAA,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO;AAE/B,EAAA,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAC/B,CACE;AAAE,IAAA,MAAM,EAAE,GAAG;AAAE,IAAA,QAAQ,EAAE;AAAS,GAAC,EACnC;AAAE,IAAA,MAAM,EAAE,CAAA,EAAG,OAAO,CAAC,YAAY,CAAA,EAAA,CAAI;AAAE,IAAA,QAAQ,EAAE;AAAS,GAAC,CAC5D,EACD;IAAE,QAAQ,EAAE,oBAAoB,CAAC,cAAc;AAAE,GACnD,CAAC;EAED,SAAS,CAAC,QAAQ,GAAG,MAAM;AACzB,IAAA,UAAU,EAAE;EACd,CAAC;AACH;AAEO,MAAM,OAAO,GAAG,CACrB,OAAoB,EACpB,cAA8B,EAC9B,UAAsB,KACb;AACT,EAAA,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAC/B,CACE;AAAE,IAAA,MAAM,EAAE,CAAA,EAAG,OAAO,CAAC,YAAY,CAAA,EAAA,CAAI;AAAE,IAAA,QAAQ,EAAE;AAAS,GAAC,EAC3D;AAAE,IAAA,MAAM,EAAE,GAAG;AAAE,IAAA,QAAQ,EAAE;AAAS,GAAC,CACpC,EACD;IAAE,QAAQ,EAAE,oBAAoB,CAAC,cAAc;AAAE,GACnD,CAAC;EAED,SAAS,CAAC,QAAQ,GAAG,MAAM;AACzB,IAAA,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM;AAC9B,IAAA,UAAU,EAAE;EACd,CAAC;AACH;;"}

package/lib/classNames.d.ts

@@ -0,0 +1,34 @@
+export interface ClassNames {
+    border: string;
+    circle: string;
+    closed: string;
+    common: string;
+    dnd: string;
+    dragging: string;
+    element: string;
+    folder: string;
+    ghost: string;
+    inside: string;
+    line: string;
+    loading: string;
+    moving: string;
+    rtl: string;
+    selected: string;
+    title: string;
+    titleButtonLeft: string;
+    titleButtonRight: string;
+    titleFolder: string;
+    toggler: string;
+    togglerLeft: string;
+    togglerRight: string;
+    tree: string;
+}
+export interface ClassNamesOptions {
+    classPrefix: string;
+    commonClassName?: string;
+    treeClassName?: string;
+}
+export declare const DEFAULT_CLASS_PREFIX = "tree-element";
+declare const createClassNames: ({ classPrefix, commonClassName, treeClassName, }: ClassNamesOptions) => ClassNames;
+export default createClassNames;
+//# sourceMappingURL=classNames.d.ts.map

package/lib/classNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.d.ts","sourceRoot":"","sources":["../src/classNames.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAOnD,QAAA,MAAM,gBAAgB,GAAI,kDAIvB,iBAAiB,KAAG,UAwBrB,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/lib/classNames.js

@@ -0,0 +1,39 @@
+const DEFAULT_CLASS_PREFIX = "tree-element";
+
+/* Create the class names that the widget puts on the elements it creates.
+ * They are all derived from classPrefix, except for the class of the root
+ * element and the class that every element gets, which have an option of
+ * their own.
+ */
+const createClassNames = ({
+  classPrefix,
+  commonClassName,
+  treeClassName
+}) => ({
+  border: `${classPrefix}-border`,
+  circle: `${classPrefix}-circle`,
+  closed: `${classPrefix}-closed`,
+  common: commonClassName ?? `${classPrefix}-common`,
+  dnd: `${classPrefix}-dnd`,
+  dragging: `${classPrefix}-dragging`,
+  element: `${classPrefix}-element`,
+  folder: `${classPrefix}-folder`,
+  ghost: `${classPrefix}-ghost`,
+  inside: `${classPrefix}-inside`,
+  line: `${classPrefix}-line`,
+  loading: `${classPrefix}-loading`,
+  moving: `${classPrefix}-moving`,
+  rtl: `${classPrefix}-rtl`,
+  selected: `${classPrefix}-selected`,
+  title: `${classPrefix}-title`,
+  titleButtonLeft: `${classPrefix}-title-button-left`,
+  titleButtonRight: `${classPrefix}-title-button-right`,
+  titleFolder: `${classPrefix}-title-folder`,
+  toggler: `${classPrefix}-toggler`,
+  togglerLeft: `${classPrefix}-toggler-left`,
+  togglerRight: `${classPrefix}-toggler-right`,
+  tree: treeClassName ?? classPrefix
+});
+
+export { DEFAULT_CLASS_PREFIX, createClassNames as default };
+//# sourceMappingURL=classNames.js.map

package/lib/classNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.js","sources":["../src/classNames.ts"],"sourcesContent":["export interface ClassNames {\n    border: string;\n    circle: string;\n    closed: string;\n    common: string;\n    dnd: string;\n    dragging: string;\n    element: string;\n    folder: string;\n    ghost: string;\n    inside: string;\n    line: string;\n    loading: string;\n    moving: string;\n    rtl: string;\n    selected: string;\n    title: string;\n    titleButtonLeft: string;\n    titleButtonRight: string;\n    titleFolder: string;\n    toggler: string;\n    togglerLeft: string;\n    togglerRight: string;\n    tree: string;\n}\n\nexport interface ClassNamesOptions {\n    classPrefix: string;\n    commonClassName?: string;\n    treeClassName?: string;\n}\n\nexport const DEFAULT_CLASS_PREFIX = \"tree-element\";\n\n/* Create the class names that the widget puts on the elements it creates.\n * They are all derived from classPrefix, except for the class of the root\n * element and the class that every element gets, which have an option of\n * their own.\n */\nconst createClassNames = ({\n    classPrefix,\n    commonClassName,\n    treeClassName,\n}: ClassNamesOptions): ClassNames => ({\n    border: `${classPrefix}-border`,\n    circle: `${classPrefix}-circle`,\n    closed: `${classPrefix}-closed`,\n    common: commonClassName ?? `${classPrefix}-common`,\n    dnd: `${classPrefix}-dnd`,\n    dragging: `${classPrefix}-dragging`,\n    element: `${classPrefix}-element`,\n    folder: `${classPrefix}-folder`,\n    ghost: `${classPrefix}-ghost`,\n    inside: `${classPrefix}-inside`,\n    line: `${classPrefix}-line`,\n    loading: `${classPrefix}-loading`,\n    moving: `${classPrefix}-moving`,\n    rtl: `${classPrefix}-rtl`,\n    selected: `${classPrefix}-selected`,\n    title: `${classPrefix}-title`,\n    titleButtonLeft: `${classPrefix}-title-button-left`,\n    titleButtonRight: `${classPrefix}-title-button-right`,\n    titleFolder: `${classPrefix}-title-folder`,\n    toggler: `${classPrefix}-toggler`,\n    togglerLeft: `${classPrefix}-toggler-left`,\n    togglerRight: `${classPrefix}-toggler-right`,\n    tree: treeClassName ?? classPrefix,\n});\n\nexport default createClassNames;\n"],"names":[],"mappings":"AAgCO,MAAM,oBAAoB,GAAG;;AAEpC;AACA;AACA;AACA;AACA;AACA,MAAM,gBAAgB,GAAG,CAAC;EACtB,WAAW;EACX,eAAe;AACf,EAAA;AACe,CAAC,MAAkB;EAClC,MAAM,EAAE,CAAA,EAAG,WAAW,CAAA,OAAA,CAAS;EAC/B,MAAM,EAAE,CAAA,EAAG,WAAW,CAAA,OAAA,CAAS;EAC/B,MAAM,EAAE,CAAA,EAAG,WAAW,CAAA,OAAA,CAAS;AAC/B,EAAA,MAAM,EAAE,eAAe,IAAI,CAAA,EAAG,WAAW,CAAA,OAAA,CAAS;EAClD,GAAG,EAAE,CAAA,EAAG,WAAW,CAAA,IAAA,CAAM;EACzB,QAAQ,EAAE,CAAA,EAAG,WAAW,CAAA,SAAA,CAAW;EACnC,OAAO,EAAE,CAAA,EAAG,WAAW,CAAA,QAAA,CAAU;EACjC,MAAM,EAAE,CAAA,EAAG,WAAW,CAAA,OAAA,CAAS;EAC/B,KAAK,EAAE,CAAA,EAAG,WAAW,CAAA,MAAA,CAAQ;EAC7B,MAAM,EAAE,CAAA,EAAG,WAAW,CAAA,OAAA,CAAS;EAC/B,IAAI,EAAE,CAAA,EAAG,WAAW,CAAA,KAAA,CAAO;EAC3B,OAAO,EAAE,CAAA,EAAG,WAAW,CAAA,QAAA,CAAU;EACjC,MAAM,EAAE,CAAA,EAAG,WAAW,CAAA,OAAA,CAAS;EAC/B,GAAG,EAAE,CAAA,EAAG,WAAW,CAAA,IAAA,CAAM;EACzB,QAAQ,EAAE,CAAA,EAAG,WAAW,CAAA,SAAA,CAAW;EACnC,KAAK,EAAE,CAAA,EAAG,WAAW,CAAA,MAAA,CAAQ;EAC7B,eAAe,EAAE,CAAA,EAAG,WAAW,CAAA,kBAAA,CAAoB;EACnD,gBAAgB,EAAE,CAAA,EAAG,WAAW,CAAA,mBAAA,CAAqB;EACrD,WAAW,EAAE,CAAA,EAAG,WAAW,CAAA,aAAA,CAAe;EAC1C,OAAO,EAAE,CAAA,EAAG,WAAW,CAAA,QAAA,CAAU;EACjC,WAAW,EAAE,CAAA,EAAG,WAAW,CAAA,aAAA,CAAe;EAC1C,YAAY,EAAE,CAAA,EAAG,WAAW,CAAA,cAAA,CAAgB;EAC5C,IAAI,EAAE,aAAa,IAAI;AAC3B,CAAC;;"}

package/lib/dataLoader.d.ts

@@ -0,0 +1,25 @@
+import type { ClassNames } from "./classNames.js";
+import type { LoadData, TriggerEvent } from "./methodTypes.js";
+import type { Node } from "./node.js";
+import type { DataFilter } from "./options.js";
+import type RequestUrl from "./requestUrl.js";
+interface DataLoaderParams {
+    classNames: ClassNames;
+    dataFilter?: DataFilter;
+    loadData: LoadData;
+    treeElement: HTMLElement;
+    triggerEvent: TriggerEvent;
+}
+export default class DataLoader {
+    private abortController;
+    private classNames;
+    private dataFilter?;
+    private loadData;
+    private treeElement;
+    private triggerEvent;
+    constructor({ classNames, dataFilter, loadData, treeElement, triggerEvent, }: DataLoaderParams);
+    deinit(): void;
+    loadFromUrl(url: RequestUrl, node?: Node): Promise<void>;
+}
+export {};
+//# sourceMappingURL=dataLoader.d.ts.map

package/lib/dataLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataLoader.d.ts","sourceRoot":"","sources":["../src/dataLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C,UAAU,gBAAgB;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;CAC9B;AAED,MAAM,CAAC,OAAO,OAAO,UAAU;IAC3B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;gBAEvB,EACR,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,GACf,EAAE,gBAAgB;IASZ,MAAM,IAAI,IAAI;IAIR,WAAW,CACpB,GAAG,EAAE,UAAU,EACf,IAAI,CAAC,EAAE,IAAI,GACZ,OAAO,CAAC,IAAI,CAAC;CA+CnB"}