@wtfalch/threads 0.1.0

package/dist/tree.js

@@ -0,0 +1,75 @@
+/**
+ * The comment tree, from rows to nodes and back to the pieces a page shows.
+ *
+ * `path` is the chain of zero-padded comment ids from the top of the thread
+ * to the comment, written by a trigger, so rows ordered by `path` are already
+ * depth-first in creation order. Building the tree is one pass over that
+ * order; nothing here touches the database.
+ */
+export const LABEL_WIDTH = 12;
+export function label(id) {
+    return String(id).padStart(LABEL_WIDTH, '0');
+}
+export function depthOf(path) {
+    return path.split('.').length - 1;
+}
+/**
+ * Rows to a forest. Pass `root` to build only the subtree under one comment,
+ * with that comment at depth 0; the rows must already be that subtree, or the
+ * thread's whole set, either way ordered by `path`.
+ */
+export function buildTree(rows, opts = {}) {
+    const sorted = [...rows].sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    const byId = new Map();
+    const top = [];
+    const rootPath = opts.root === undefined ? null : sorted.find((r) => r.id === opts.root)?.path;
+    if (opts.root !== undefined && rootPath === undefined)
+        return [];
+    const base = rootPath ? depthOf(rootPath) : 0;
+    for (const row of sorted) {
+        if (rootPath && !(row.path === rootPath || row.path.startsWith(`${rootPath}.`)))
+            continue;
+        const node = { ...row, depth: depthOf(row.path) - base, children: [], descendants: 0 };
+        byId.set(row.id, node);
+        const parent = row.replyTo === null ? undefined : byId.get(row.replyTo);
+        if (parent && node.depth > 0)
+            parent.children.push(node);
+        else
+            top.push(node);
+    }
+    for (const node of byId.values()) {
+        let up = node.replyTo === null ? undefined : byId.get(node.replyTo);
+        while (up) {
+            up.descendants += 1;
+            up = up.replyTo === null ? undefined : byId.get(up.replyTo);
+        }
+    }
+    return top;
+}
+/** Every node in depth-first order, which is the order the page draws them. */
+export function walk(nodes) {
+    const out = [];
+    const visit = (n) => {
+        out.push(n);
+        for (const c of n.children)
+            visit(c);
+    };
+    for (const n of nodes)
+        visit(n);
+    return out;
+}
+/**
+ * What a page draws past the depth it is willing to indent: the node stays,
+ * its children are replaced by a count and a link. Eight is the reference
+ * rendering's choice; a place that renders flat passes 0, one that never
+ * folds passes Infinity.
+ */
+export function collapse(nodes, at) {
+    const fold = (n) => {
+        if (n.depth >= at && n.children.length > 0) {
+            return { ...n, children: [], folded: n.descendants };
+        }
+        return { ...n, children: n.children.map(fold), folded: 0 };
+    };
+    return nodes.map(fold);
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@wtfalch/threads",
+  "version": "0.1.0",
+  "description": "Threads, comments, votes and subscriptions attached to a subject the host names: a forum, a feedback board, a comment section. Per-app Postgres, host-supplied gates, React on @wtfalch/design.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wtfalch/threads",
+    "directory": "packages/threads"
+  },
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "threads-migrations": "./dist/bin/migrations.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./migrations/*.sql": "./dist/migrations/*.sql",
+    "./threads.css": "./dist/threads.css"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "peerDependencies": {
+    "@wtfalch/design": ">=0.3.0",
+    "drizzle-orm": ">=0.39.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@wtfalch/design": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@electric-sql/pglite": "^0.5.8",
+    "@types/node": "^22",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@wtfalch/design": "^0.3.0",
+    "drizzle-orm": "^0.39.3",
+    "jsdom": "^30.0.1",
+    "react": "^19",
+    "react-dom": "^19",
+    "typescript": "^5.9.0",
+    "vitest": "^4.1.6"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && mkdir -p dist/migrations && cp src/migrations/*.sql dist/migrations/ && cp src/react/threads.css dist/threads.css",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}