Immutable Tree Data Structures for API Workflows

import { findNode, filterTree, flattenTree, sortTree } from "@powerduck/tree";

const tree = {
  id: "root", label: "API",
  children: [
    { id: "users", label: "Users", children: [
      { id: "get-users", label: "GET /users" },
      { id: "create-user", label: "POST /users" },
    ]},
  ],
};

const node = findNode(tree, "get-users");
const flat = flattenTree(tree);
const sorted = sortTree(tree, (a, b) => a.label.localeCompare(b.label));

import { buildOpenApiTree } from "@powerduck/tree";

// Build a navigation tree from an OpenAPI document
const result = buildOpenApiTree(openApiDocument);
// result.tree: OpenApiTreeNode[] — grouped by tags, paths, operations
// result.warnings: OpenApiNodeMetadata[] — unresolved refs, etc.

import { buildSchemaTree, findSchemaNodeByPath, formatSchemaType } from "@powerduck/tree";

// Visualize a JSON Schema as an expandable tree
const result = buildSchemaTree(jsonSchema);
const node = findSchemaNodeByPath(result.tree, ["properties", "name"]);
console.log(formatSchemaType(node.schema)); // "string"

import { buildDocTree } from "@powerduck/tree";

// Build a documentation navigation tree
const result = buildDocTree(files, {
  basePath: "/docs",
});
// result.tree: DocTreeNode[] — sidebar navigation structure