@poe2-toolkit/tree-core 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,426 @@
+/**
+ * Data contracts for the engine.
+ *
+ * Two families of types live here:
+ *  - `TreeData` + friends: the **source** shape, normalised from GGG's official
+ *    skill-tree export (`data.json`). GGG bakes world `x`/`y` into every node;
+ *    the engine consumes those positions directly.
+ *  - `Scene` + friends: the **computed** shape the engine produces, with every
+ *    node/effect already positioned and sized in world space.
+ *
+ * Sizes are still *derived* (Path of Building's `GetNodeTargetSize` cascade);
+ * only positions come baked, because GGG does not ship the orbit-radius
+ * constants needed to recompute them and instead pre-bakes the coordinates.
+ */
+export interface TreeData {
+    /** Tree/patch version, e.g. "0_5". */
+    version: string;
+    /** Geometry backbone shared by every node. */
+    constants: TreeConstants;
+    /** Orbit anchor clusters, keyed by group id. */
+    groups: Record<number, Group>;
+    /** Every node, keyed by skill id. */
+    nodes: Record<number, TreeNode>;
+    /** Central class art + ascendancy metadata. */
+    classes: ClassDef[];
+    /** Skill ids that are jewel sockets. */
+    jewelSlots: number[];
+    /** World-space extent of the whole tree (for fit-to-view). */
+    bounds: WorldRect;
+}
+export interface TreeConstants {
+    /**
+     * Radius of the central opening. PoB ships this as `PSSCentreInnerRadius`;
+     * GGG's export omits it, so normalisation supplies the (stable) game value.
+     */
+    centreInnerRadius: number;
+}
+export interface Group {
+    /** World centre of the orbit cluster. */
+    x: number;
+    y: number;
+    /** Which orbits are populated in this group. */
+    orbits: number[];
+    /** Member skill ids. */
+    nodes: number[];
+}
+export interface TreeNode {
+    /** Canonical skill id (matches GGG `PassiveSkills.id`). */
+    skill: number;
+    /** Owning group id (direct index into {@link TreeData.groups}). */
+    group: number;
+    /** Orbit number within the group. */
+    orbit: number;
+    /** Slot index along the orbit. */
+    orbitIndex: number;
+    /** World x, baked by GGG's export. */
+    x: number;
+    /** World y, baked by GGG's export. */
+    y: number;
+    /** Edges to neighbouring nodes (GGG `in` + `out`, merged). */
+    connections: NodeConnection[];
+    name: string;
+    /** Atlas key into the {@link SpriteManifest}. */
+    icon: string;
+    stats: string[];
+    isNotable?: boolean;
+    isKeystone?: boolean;
+    isJewelSocket?: boolean;
+    /**
+     * Special sockets (e.g. "Sinister Jewel Socket") that are not part of the base
+     * tree and are hidden from the normal render. Derived from the node name, as
+     * GGG carries no dedicated flag (PoB shipped this as `noRadius`).
+     */
+    noRadius?: boolean;
+    /** GGG: `isMastery` (PoB: `isOnlyImage`). */
+    isMastery?: boolean;
+    isAscendancyStart?: boolean;
+    /** GGG: `isGenericAttribute`. */
+    isAttribute?: boolean;
+    /** Background pattern key (masteries AND notables). */
+    activeEffectImage?: string;
+    /**
+     * Ascendancy display name (e.g. "Deadeye"), translated from GGG's internal
+     * `ascendancyId` ("Ranger1") so it matches a build's chosen ascendancy.
+     */
+    ascendancyName?: string;
+    /** Keystone lore. */
+    flavourText?: string;
+    recipe?: string[];
+    /** Attribute nodes: the interchangeable choices (e.g. Str / Dex / Int). */
+    options?: NodeOption[];
+    /**
+     * Conditional node (GGG `unlockConstraint`): not part of the base tree, shown
+     * only when unlocked (e.g. by an ascendancy). The official default tree hides
+     * these.
+     */
+    conditional?: boolean;
+    /** Ascendancy id that unlocks this conditional node, when specified. */
+    unlockAscendancy?: string;
+    /** Present on class-start nodes: names of the classes that start here. */
+    classesStart?: string[];
+}
+/** One selectable variant of an attribute node. */
+export interface NodeOption {
+    id: number;
+    name: string;
+    stats: string[];
+    /** Skill-icon path for this specific choice (e.g. plusintelligence.png). */
+    icon: string;
+}
+/**
+ * An edge to a neighbouring node. GGG's top-level `edges` table marks which edges
+ * are arcs and gives the arc centre directly (`orbitX`/`orbitY`); that centre is
+ * carried here as {@link NodeConnection.arcCentre}. Edges without it draw as a
+ * straight line (or, as a fallback, an arc around the shared group centre — see
+ * {@link placeConnection}).
+ */
+export interface NodeConnection {
+    /** Skill id of the connected node. */
+    id: number;
+    /** World centre of the arc this edge follows (GGG `orbitX`/`orbitY`), if any. */
+    arcCentre?: Point;
+}
+export interface Size {
+    width: number;
+    height: number;
+}
+export interface ClassDef {
+    name: string;
+    /** Integer class id = index in GGG's `classes` array (Witch = 1). */
+    id: number;
+    baseStr: number;
+    baseDex: number;
+    baseInt: number;
+    /** Skill id of this class's start node (derived from `classStartIndex`). */
+    startNode: number;
+    /** Central art + ring geometry for this class. */
+    centre: CentreArt;
+    ascendancies: AscendancyDef[];
+    /**
+     * Per-class node display overrides: base node skill id -> the skill id whose
+     * name/stats/icon this class shows instead (e.g. the Witch sees the generic
+     * "Spell Damage" node as "Spell and Minion Damage"). Geometry is unchanged.
+     */
+    overridePairs?: Record<number, number>;
+}
+/**
+ * The three concentric layers drawn at the tree hub for a class. All share the
+ * same world centre (`x`/`y`, pinned at the origin).
+ *
+ * GGG's `data.json` carries no layer dimensions, so normalisation fills these
+ * from the stable atlas frame sizes: the class portrait (`background-<class>`)
+ * is 1500², the ornate + rotating rings (`group-background`) are 2000². World
+ * radius equals the native width (the DrawAsset 2× rule folds in downstream).
+ */
+export interface CentreArt {
+    /** Class portrait atlas key (e.g. `ClassesRanger`). */
+    image: string;
+    /** World centre of the hub (origin: 0,0). */
+    x: number;
+    y: number;
+    /** Static class-portrait layer native size (1500²). */
+    art: Size;
+    /** Rotating gold ring layer native size (2000²). */
+    active: Size;
+    /** Static ornate frame layer native size (2000²). */
+    frame: Size;
+}
+/**
+ * An ascendancy disc as a relocatable block. GGG bakes each ascendancy's nodes
+ * at a far-flung cluster; `worldAnchor` is where that cluster sits. The renderer
+ * chooses where to draw it — translated into the hub (how the game shows it) or
+ * left at `worldAnchor` (the raw export layout).
+ */
+export interface AscendancyDef {
+    /** Display name, also the build's ascendancy key (e.g. "Deadeye"). */
+    id: string;
+    name: string;
+    /** GGG internal id, e.g. `Ranger1`. */
+    internalId: string;
+    /** Disc background atlas key. */
+    image: string;
+    /**
+     * World anchor of the disc: the centroid of its nodes (GGG bakes each
+     * ascendancy's nodes at a far-flung cluster). The renderer translates this
+     * onto the hub to draw the disc game-style.
+     */
+    worldAnchor: Point;
+    /** Disc native size (1500²). */
+    size: Size;
+}
+export interface SpriteFrame {
+    /** Atlas id the render package resolves to a bitmap. */
+    atlas: string;
+    /** Native pixel sub-rect inside the atlas. */
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface SpriteManifest {
+    /** Atlas key -> native pixel rect. */
+    frames: Record<string, SpriteFrame>;
+}
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface WorldRect {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+export interface Scene {
+    nodes: PlacedNode[];
+    connections: PlacedConnection[];
+    masteryEffects: PlacedEffect[];
+    centre: CentreLayout;
+    /** Extent of the whole tree, including the far-flung ascendancy discs. */
+    bounds: WorldRect;
+    /**
+     * Extent of the main tree only (ascendancy nodes excluded). Use this to fit
+     * the initial view: the ascendancy discs sit thousands of units out, so
+     * fitting `bounds` leaves the main tree tiny in the middle.
+     */
+    mainBounds: WorldRect;
+}
+export interface PlacedNode {
+    skill: number;
+    /** Absolute world centre. */
+    x: number;
+    y: number;
+    kind: NodeKind;
+    /** Skill-icon atlas key (carried through from {@link TreeNode.icon}). */
+    icon: string;
+    /** World diameter of the skill icon. */
+    iconSize: number;
+    /** World diameter of the overlay frame (0 = none, e.g. masteries). */
+    frameSize: number;
+    /** Hit-test radius: half the larger of icon/frame. */
+    radius: number;
+    /** Allocated in the current build. */
+    allocated: boolean;
+    /** Owning ascendancy id, if this node belongs to an ascendancy. */
+    ascendancy?: string;
+    /** Jewel socketed into this node (jewel sockets only), if the build has one. */
+    jewel?: JewelInfo;
+}
+/**
+ * A jewel socketed into a tree socket. Display-only metadata — the engine never
+ * applies a jewel's radius effect to nearby nodes (PoE2 jewels are global stats).
+ */
+export interface JewelInfo {
+    name: string;
+    /** Item rarity, upper-case PoB form: NORMAL / MAGIC / RARE / UNIQUE. */
+    rarity: string;
+    baseType: string;
+    /** Granted modifier lines. */
+    mods: string[];
+    /** Item-icon URL for the jewel's base type, when resolved. */
+    icon?: string;
+}
+export type NodeKind = 'normal' | 'notable' | 'keystone' | 'mastery' | 'jewel' | 'attribute' | 'classStart' | 'ascendancyStart' | 'ascendancyNormal' | 'ascendancyNotable';
+export interface PlacedConnection {
+    from: number;
+    to: number;
+    /** Straight line, or an arc following an orbit. */
+    kind: 'line' | 'arc';
+    a: Point;
+    b: Point;
+    /** Both endpoints allocated — the edge is part of the build. */
+    active: boolean;
+    /** Owning ascendancy id, if this edge is inside an ascendancy. */
+    ascendancy?: string;
+    /** Arc only: centre, radius, signed sweep (radians), and the orbit it follows. */
+    arc?: {
+        cx: number;
+        cy: number;
+        radius: number;
+        startAngle: number;
+        endAngle: number;
+        clockwise: boolean;
+        orbit: number;
+    };
+}
+export interface PlacedEffect {
+    /** Node the effect pattern belongs to. */
+    skill: number;
+    x: number;
+    y: number;
+    /** World diameter of the pattern. */
+    size: number;
+    patternKey: string;
+    /** The mastery's cluster (group) has an allocated node — the pattern is lit. */
+    active: boolean;
+}
+/**
+ * The hub layout: where the centre is, how big the opening is, and one anchor
+ * per class describing how its ring rotates and where it sits on the rim. All
+ * derived from the data — none of it eyeballed.
+ */
+export interface CentreLayout {
+    /** World centre of the hub (the origin). */
+    centre: Point;
+    /** Radius of the central opening. */
+    innerRadius: number;
+    /**
+     * World radii of the three hub layers (shared across classes). Each layer is
+     * drawn at `2 * width` centred on the hub, so the world radius equals the
+     * native `width` — already folded in here so the renderer just scales these.
+     */
+    ring: {
+        artRadius: number;
+        activeRadius: number;
+        frameRadius: number;
+    };
+    classes: ClassAnchor[];
+    /** Every ascendancy disc (relocatable block: world anchor + size). */
+    ascendancies: AscendancyDef[];
+}
+export interface ClassAnchor {
+    classId: number;
+    name: string;
+    /** Class-start skill id. */
+    startNode: number;
+    /** Radians, direction centre -> start node: the class's spot on the rim. */
+    startAngle: number;
+    /** Radians to rotate the active ring onto this class: `π/2 + atan2(dy, dx)`. */
+    ringRotation: number;
+}
+/**
+ * A character's tree state, and the ONLY build input the engine needs. Whatever
+ * produces it — a POB code / `.build` decoder, the GGG OAuth API, a manual
+ * editor — is none of the engine's concern. Gems and items are irrelevant to
+ * drawing the tree and deliberately absent.
+ */
+export interface BuildAllocation {
+    /**
+     * Integer class id (matches `ClassDef.id`). Optional: a read-only allocation
+     * identifies its class by name at the call site (the imported PoB `classId`
+     * is not stable across versions), and only the editable planner needs the id
+     * — to find the class start node for pathing.
+     */
+    classId?: number;
+    /** Active ascendancy id (matches `AscendancyDef.id`), if any. */
+    ascendId?: string;
+    /** Allocated skill ids. */
+    allocated: number[];
+    /**
+     * Chosen attribute per generic +attribute node (node id -> str/dex/int). Lets
+     * the renderer show the specific icon/stat instead of the generic "any".
+     */
+    attributeChoices?: Record<number, AttributeChoice>;
+    /** Jewels socketed into the tree, keyed by socket node id. Display-only. */
+    jewels?: Record<number, JewelInfo>;
+    /** Tree/patch version the allocation was made against, e.g. "0_5". */
+    treeVersion?: string;
+}
+/** The attribute a generic +attribute node was assigned to. */
+export type AttributeChoice = 'str' | 'dex' | 'int';
+/** Inputs to {@link Scene} construction beyond the static tree data. */
+export interface SceneOptions {
+    /** Current build state; omit for an unallocated tree. */
+    allocation?: BuildAllocation;
+}
+/** View transform: `screen = world * scale + (tx, ty)`. */
+export interface Viewport {
+    tx: number;
+    ty: number;
+    scale: number;
+}
+/**
+ * A {@link Scene} projected to screen pixels and culled to the viewport. The
+ * renderer walks these arrays and blits — no `* scale`, no `+ offset`, no math.
+ */
+export interface ScreenScene {
+    /** The viewport scale, for line widths / LOD decisions in the renderer. */
+    scale: number;
+    nodes: ScreenNode[];
+    connections: ScreenConnection[];
+    masteryEffects: ScreenEffect[];
+}
+export interface ScreenNode {
+    skill: number;
+    /** Screen-pixel centre. */
+    x: number;
+    y: number;
+    kind: NodeKind;
+    icon: string;
+    /** Screen-pixel diameters. */
+    iconSize: number;
+    frameSize: number;
+    radius: number;
+    allocated: boolean;
+    /** Jewel socketed into this node (jewel sockets only), if the build has one. */
+    jewel?: JewelInfo;
+}
+export interface ScreenConnection {
+    from: number;
+    to: number;
+    kind: 'line' | 'arc';
+    a: Point;
+    b: Point;
+    active: boolean;
+    /** Arc only, in screen space (angles are unchanged by uniform scale). */
+    arc?: {
+        cx: number;
+        cy: number;
+        radius: number;
+        startAngle: number;
+        endAngle: number;
+        clockwise: boolean;
+        orbit: number;
+    };
+}
+export interface ScreenEffect {
+    skill: number;
+    x: number;
+    y: number;
+    size: number;
+    patternKey: string;
+    /** The mastery's cluster (group) has an allocated node — the pattern is lit. */
+    active: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,16 @@
+/**
+ * Data contracts for the engine.
+ *
+ * Two families of types live here:
+ *  - `TreeData` + friends: the **source** shape, normalised from GGG's official
+ *    skill-tree export (`data.json`). GGG bakes world `x`/`y` into every node;
+ *    the engine consumes those positions directly.
+ *  - `Scene` + friends: the **computed** shape the engine produces, with every
+ *    node/effect already positioned and sized in world space.
+ *
+ * Sizes are still *derived* (Path of Building's `GetNodeTargetSize` cascade);
+ * only positions come baked, because GGG does not ship the orbit-radius
+ * constants needed to recompute them and instead pre-bakes the coordinates.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@poe2-toolkit/tree-core",
+  "version": "0.1.0",
+  "description": "Headless, framework-agnostic geometry engine for the Path of Exile 2 passive tree. Data in, game-accurate scene out. Positions and sizes derived from the source data, never hand-tuned.",
+  "keywords": [
+    "path-of-exile",
+    "poe2",
+    "passive-tree",
+    "skill-tree",
+    "geometry"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./ggg": {
+      "types": "./dist/ggg/normalize.d.ts",
+      "default": "./dist/ggg/normalize.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}