@poe2-toolkit/tree-core 0.1.0

package/dist/geometry/framing.js

@@ -0,0 +1,101 @@
+/**
+ * World-space framing helpers: compute the bounding box the view should focus
+ * on, so callers can pan/zoom to a build's allocation or a single class's
+ * region instead of the whole tree.
+ */
+/** Grow a rect to include a node's footprint (centre ± hit radius). */
+function extend(rect, node) {
+    const reach = node.radius > 0 ? node.radius : 1;
+    rect.minX = Math.min(rect.minX, node.x - reach);
+    rect.minY = Math.min(rect.minY, node.y - reach);
+    rect.maxX = Math.max(rect.maxX, node.x + reach);
+    rect.maxY = Math.max(rect.maxY, node.y + reach);
+}
+function emptyRect() {
+    return { minX: Infinity, minY: Infinity, maxX: -Infinity, maxY: -Infinity };
+}
+function finalize(rect) {
+    if (rect.minX > rect.maxX) {
+        return null;
+    }
+    return { minX: rect.minX, minY: rect.minY, maxX: rect.maxX, maxY: rect.maxY };
+}
+/**
+ * Bounds of the allocated main-tree nodes (ascendancy nodes excluded — they live
+ * in the relocated hub panel). `null` when nothing is allocated.
+ */
+export function allocatedBounds(scene) {
+    const rect = emptyRect();
+    for (const node of scene.nodes) {
+        if (node.allocated && !node.ascendancy) {
+            extend(rect, node);
+        }
+    }
+    return finalize(rect);
+}
+/**
+ * Allocated bounds grown to include the centre hub, so a view framed on a fresh
+ * import keeps the class portrait at the tree's centre in shot. `allocatedBounds`
+ * alone hugs only the outlying nodes and pushes the portrait off-screen — the
+ * very art the import is meant to reveal. `null` when nothing main-tree is
+ * allocated (callers fall back to the renderer's default hub-centred view).
+ */
+export function allocatedBoundsWithCentre(scene) {
+    const bounds = allocatedBounds(scene);
+    if (!bounds) {
+        return null;
+    }
+    const { centre, ring } = scene.centre;
+    const reach = ring.frameRadius;
+    return {
+        minX: Math.min(bounds.minX, centre.x - reach),
+        minY: Math.min(bounds.minY, centre.y - reach),
+        maxX: Math.max(bounds.maxX, centre.x + reach),
+        maxY: Math.max(bounds.maxY, centre.y + reach),
+    };
+}
+/** Shortest signed distance between two angles, in (-π, π]. */
+function angleDelta(a, b) {
+    let delta = a - b;
+    while (delta > Math.PI) {
+        delta -= 2 * Math.PI;
+    }
+    while (delta <= -Math.PI) {
+        delta += 2 * Math.PI;
+    }
+    return delta;
+}
+/**
+ * Bounds of the tree sector belonging to one class. The tree radiates from the
+ * hub and each class owns a rim direction (`ClassAnchor.startAngle`); a main
+ * node belongs to the class whose direction its bearing from the centre is
+ * closest to. `null` for an unknown class or an empty sector.
+ */
+export function classBounds(scene, classId) {
+    const anchors = scene.centre.classes;
+    if (anchors.length === 0) {
+        return null;
+    }
+    const { centre } = scene.centre;
+    const rect = emptyRect();
+    for (const node of scene.nodes) {
+        if (node.ascendancy) {
+            continue;
+        }
+        const bearing = Math.atan2(node.y - centre.y, node.x - centre.x);
+        let nearest = anchors[0];
+        let nearestDelta = Math.abs(angleDelta(bearing, nearest.startAngle));
+        for (const anchor of anchors) {
+            const delta = Math.abs(angleDelta(bearing, anchor.startAngle));
+            if (delta < nearestDelta) {
+                nearest = anchor;
+                nearestDelta = delta;
+            }
+        }
+        if (nearest.classId === classId) {
+            extend(rect, node);
+        }
+    }
+    return finalize(rect);
+}
+//# sourceMappingURL=framing.js.map

package/dist/geometry/framing.js.map

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

package/dist/geometry/orbit.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Node positions.
+ *
+ * GGG's skill-tree export bakes a world `x`/`y` into every node, so the engine
+ * reads those directly rather than recomputing them from orbit radii + angles.
+ * (GGG omits the orbit-radius constants PoB used for that computation; baking the
+ * coordinates is GGG's substitute.)
+ *
+ * Convention (matches GGG and PoB): angle `0` points straight up and increases
+ * clockwise, so a node on `orbit`/`orbitIndex` sits at
+ *
+ *   x = group.x + radius * sin(angle)
+ *   y = group.y - radius * cos(angle)
+ *
+ * which is exactly what the baked coordinates already encode.
+ */
+import type { Point, TreeData } from '../types.js';
+/**
+ * World position of a node identified by skill id, read from its baked
+ * coordinates. Throws if the node is missing.
+ */
+export declare function nodePosition(data: TreeData, skill: number): Point;
+//# sourceMappingURL=orbit.d.ts.map

package/dist/geometry/orbit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbit.d.ts","sourceRoot":"","sources":["../../src/geometry/orbit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAQjE"}

package/dist/geometry/orbit.js

@@ -0,0 +1,28 @@
+/**
+ * Node positions.
+ *
+ * GGG's skill-tree export bakes a world `x`/`y` into every node, so the engine
+ * reads those directly rather than recomputing them from orbit radii + angles.
+ * (GGG omits the orbit-radius constants PoB used for that computation; baking the
+ * coordinates is GGG's substitute.)
+ *
+ * Convention (matches GGG and PoB): angle `0` points straight up and increases
+ * clockwise, so a node on `orbit`/`orbitIndex` sits at
+ *
+ *   x = group.x + radius * sin(angle)
+ *   y = group.y - radius * cos(angle)
+ *
+ * which is exactly what the baked coordinates already encode.
+ */
+/**
+ * World position of a node identified by skill id, read from its baked
+ * coordinates. Throws if the node is missing.
+ */
+export function nodePosition(data, skill) {
+    const node = data.nodes[skill];
+    if (!node) {
+        throw new RangeError(`unknown skill id ${skill}`);
+    }
+    return { x: node.x, y: node.y };
+}
+//# sourceMappingURL=orbit.js.map

package/dist/geometry/orbit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbit.js","sourceRoot":"","sources":["../../src/geometry/orbit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc,EAAE,KAAa;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,UAAU,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/dist/geometry/project.d.ts

@@ -0,0 +1,20 @@
+/**
+ * World <-> screen projection and hit-testing.
+ *
+ * `project` turns a world-space {@link Scene} into a {@link ScreenScene} of
+ * pixel coordinates, culled to the viewport, so the renderer can blit without
+ * any maths of its own. `nodeAt` answers "which node is under this pixel?" by
+ * going the other way.
+ */
+import type { Point, Scene, ScreenScene, Size, Viewport } from '../types.js';
+/** Project a world point to screen pixels. */
+export declare function projectPoint(viewport: Viewport, p: Point): Point;
+/** Inverse of {@link projectPoint}: screen pixels to a world point. */
+export declare function screenToWorld(viewport: Viewport, sx: number, sy: number): Point;
+export declare function project(scene: Scene, viewport: Viewport, size: Size): ScreenScene;
+/**
+ * The skill id of the node under a screen pixel, or null. Returns the closest
+ * node whose footprint contains the point (topmost on overlap).
+ */
+export declare function nodeAt(scene: Scene, viewport: Viewport, sx: number, sy: number): number | null;
+//# sourceMappingURL=project.d.ts.map

package/dist/geometry/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/geometry/project.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,KAAK,EAIL,WAAW,EACX,IAAI,EACJ,QAAQ,EACT,MAAM,aAAa,CAAC;AAErB,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK,CAEhE;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAE/E;AAKD,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,CAyFjF;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyB9F"}

package/dist/geometry/project.js

@@ -0,0 +1,149 @@
+/**
+ * World <-> screen projection and hit-testing.
+ *
+ * `project` turns a world-space {@link Scene} into a {@link ScreenScene} of
+ * pixel coordinates, culled to the viewport, so the renderer can blit without
+ * any maths of its own. `nodeAt` answers "which node is under this pixel?" by
+ * going the other way.
+ */
+/** Project a world point to screen pixels. */
+export function projectPoint(viewport, p) {
+    return { x: p.x * viewport.scale + viewport.tx, y: p.y * viewport.scale + viewport.ty };
+}
+/** Inverse of {@link projectPoint}: screen pixels to a world point. */
+export function screenToWorld(viewport, sx, sy) {
+    return { x: (sx - viewport.tx) / viewport.scale, y: (sy - viewport.ty) / viewport.scale };
+}
+/** Nodes whose projected radius is below this many pixels are dropped (LOD). */
+const MIN_VISIBLE_RADIUS_PX = 0.4;
+export function project(scene, viewport, size) {
+    const { scale } = viewport;
+    const view = worldViewport(viewport, size);
+    const nodes = [];
+    for (const node of scene.nodes) {
+        // Ascendancy nodes live far out in world space; the renderer relocates the
+        // active disc into the hub itself, so they are not part of the main map.
+        if (node.ascendancy) {
+            continue;
+        }
+        const screenRadius = node.radius * scale;
+        if (screenRadius < MIN_VISIBLE_RADIUS_PX) {
+            continue;
+        }
+        if (!within(view, node.x, node.y, node.radius)) {
+            continue;
+        }
+        const p = projectPoint(viewport, node);
+        nodes.push({
+            skill: node.skill,
+            x: p.x,
+            y: p.y,
+            kind: node.kind,
+            icon: node.icon,
+            iconSize: node.iconSize * scale,
+            frameSize: node.frameSize * scale,
+            radius: screenRadius,
+            allocated: node.allocated,
+            ...(node.jewel ? { jewel: node.jewel } : {}),
+        });
+    }
+    const connections = [];
+    for (const conn of scene.connections) {
+        // Ascendancy edges are relocated into the hub by the renderer, like nodes.
+        if (conn.ascendancy) {
+            continue;
+        }
+        if (!segmentTouches(view, conn.a, conn.b)) {
+            continue;
+        }
+        const a = projectPoint(viewport, conn.a);
+        const b = projectPoint(viewport, conn.b);
+        if (conn.kind === 'arc' && conn.arc) {
+            const centre = projectPoint(viewport, { x: conn.arc.cx, y: conn.arc.cy });
+            connections.push({
+                from: conn.from,
+                to: conn.to,
+                kind: 'arc',
+                a,
+                b,
+                active: conn.active,
+                arc: {
+                    cx: centre.x,
+                    cy: centre.y,
+                    radius: conn.arc.radius * scale,
+                    startAngle: conn.arc.startAngle,
+                    endAngle: conn.arc.endAngle,
+                    clockwise: conn.arc.clockwise,
+                    orbit: conn.arc.orbit,
+                },
+            });
+        }
+        else {
+            connections.push({ from: conn.from, to: conn.to, kind: 'line', a, b, active: conn.active });
+        }
+    }
+    const masteryEffects = [];
+    for (const effect of scene.masteryEffects) {
+        if (!within(view, effect.x, effect.y, effect.size / 2)) {
+            continue;
+        }
+        const p = projectPoint(viewport, effect);
+        masteryEffects.push({ skill: effect.skill, x: p.x, y: p.y, size: effect.size * scale, patternKey: effect.patternKey, active: effect.active });
+    }
+    return { scale, nodes, connections, masteryEffects };
+}
+/**
+ * The skill id of the node under a screen pixel, or null. Returns the closest
+ * node whose footprint contains the point (topmost on overlap).
+ */
+export function nodeAt(scene, viewport, sx, sy) {
+    const world = screenToWorld(viewport, sx, sy);
+    let best = null;
+    let bestDistSq = Infinity;
+    for (const node of scene.nodes) {
+        // Ascendancy nodes aren't on the main map (the renderer relocates them and
+        // hit-tests them there); don't match them at their far-out world position.
+        // Masteries are drawn as a large background pattern, not an interactive
+        // disc — their huge footprint would otherwise hijack the hover.
+        if (node.radius <= 0 || node.ascendancy || node.kind === 'mastery') {
+            continue;
+        }
+        const dx = node.x - world.x;
+        const dy = node.y - world.y;
+        const distSq = dx * dx + dy * dy;
+        if (distSq <= node.radius * node.radius && distSq < bestDistSq) {
+            best = node.skill;
+            bestDistSq = distSq;
+        }
+    }
+    return best;
+}
+/** The world-space rectangle currently visible in the viewport. */
+function worldViewport(viewport, size) {
+    const topLeft = screenToWorld(viewport, 0, 0);
+    const bottomRight = screenToWorld(viewport, size.width, size.height);
+    return {
+        minX: Math.min(topLeft.x, bottomRight.x),
+        minY: Math.min(topLeft.y, bottomRight.y),
+        maxX: Math.max(topLeft.x, bottomRight.x),
+        maxY: Math.max(topLeft.y, bottomRight.y),
+    };
+}
+/** Whether a world circle (centre + radius) intersects the view rect. */
+function within(view, x, y, radius) {
+    return (x + radius >= view.minX &&
+        x - radius <= view.maxX &&
+        y + radius >= view.minY &&
+        y - radius <= view.maxY);
+}
+/** Cheap bounding-box test for whether a segment could touch the view rect. */
+function segmentTouches(view, a, b) {
+    if (Math.max(a.x, b.x) < view.minX || Math.min(a.x, b.x) > view.maxX) {
+        return false;
+    }
+    if (Math.max(a.y, b.y) < view.minY || Math.min(a.y, b.y) > view.maxY) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=project.js.map

package/dist/geometry/project.js.map

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

package/dist/ggg/normalize.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Normalise GGG's official skill-tree export (`data.json`) into the engine's
+ * {@link TreeData}.
+ *
+ * This is the only place that knows GGG's field names and quirks. Everything
+ * downstream works against the clean {@link TreeData} contract. The transform is
+ * deliberately tolerant: optional fields come and go across patches and missing
+ * data should never throw.
+ *
+ * The GGG quirks handled here:
+ *  - node positions are **baked** (`node.x`/`node.y`); the export ships none of
+ *    the orbit-radius constants needed to recompute them, so they are read as-is;
+ *  - edges are split across `in` + `out` id lists, merged into one set here;
+ *  - arc geometry lives in a separate top-level `edges` table, not on the node;
+ *  - attribute choices live in a global `skillOverrides` table, not per node;
+ *  - ascendancy ids are internal (`Ranger1`) and mapped to display names here;
+ *  - centre/ring dimensions are absent — filled from stable atlas frame sizes.
+ */
+import type { TreeData } from '../types.js';
+export interface GggTreeJson {
+    groups: Record<string, GggGroup>;
+    nodes: Record<string, GggNode>;
+    classes: GggClass[];
+    /** Per-edge geometry: arcs carry `orbit` + the arc centre `orbitX`/`orbitY`. */
+    edges?: GggEdge[];
+    /** Global attribute-choice definitions, keyed by the (shared) override id. */
+    skillOverrides?: Record<string, GggSkillOverride>;
+    jewelSlots?: (string | number)[];
+    min_x: number;
+    min_y: number;
+    max_x: number;
+    max_y: number;
+}
+interface GggEdge {
+    from: string | number;
+    to: string | number;
+    /** Present when the edge is an arc; the orbit it follows. */
+    orbit?: number;
+    /** World centre of the arc, when GGG provides it. */
+    orbitX?: number;
+    orbitY?: number;
+}
+interface GggGroup {
+    x: number;
+    y: number;
+    orbits?: number[];
+    nodes?: (string | number)[];
+}
+interface GggNode {
+    skill?: number;
+    name?: string;
+    icon?: string;
+    stats?: string[];
+    x?: number;
+    y?: number;
+    group?: number;
+    orbit?: number;
+    orbitIndex?: number;
+    in?: (string | number)[];
+    out?: (string | number)[];
+    isNotable?: boolean;
+    isKeystone?: boolean;
+    isMastery?: boolean;
+    isJewelSocket?: boolean;
+    isGenericAttribute?: boolean;
+    isAscendancyStart?: boolean;
+    activeEffectImage?: string;
+    ascendancyId?: string;
+    /** Class indices (into `classes`) that start at this node. */
+    classStartIndex?: number[];
+    flavourText?: string[] | string;
+    recipe?: string[];
+    unlockConstraint?: {
+        ascendancy?: string;
+        nodes?: number[];
+    };
+}
+interface GggSkillOverride {
+    id?: string;
+    skill?: number;
+    name?: string;
+    icon?: string;
+    stats?: string[];
+}
+interface GggAscendancy {
+    id: string;
+    name?: string;
+    /** Hub-relative position of the disc centre (radius ~1332 toward the class). */
+    offsetX?: number;
+    offsetY?: number;
+}
+interface GggClass {
+    name: string;
+    base_str: number;
+    base_dex: number;
+    base_int: number;
+    image?: string;
+    ascendancies?: GggAscendancy[];
+    /** Per-class node display overrides: base skill id -> override skill id. */
+    overridePairs?: Record<string | number, number>;
+}
+/**
+ * @param raw     parsed GGG `data.json`
+ * @param version tree/patch version (e.g. "0_5") — GGG does not store it inside
+ *                the file, so it is supplied here
+ */
+export declare function normalizeGggTree(raw: GggTreeJson, version: string): TreeData;
+export {};
+//# sourceMappingURL=normalize.d.ts.map

package/dist/ggg/normalize.d.ts.map

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