@poe2-toolkit/tree-extractor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vladislav Rajtmajer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# @poe2-toolkit/tree-extractor
+
+[![npm](https://img.shields.io/npm/v/@poe2-toolkit/tree-extractor.svg)](https://www.npmjs.com/package/@poe2-toolkit/tree-extractor)
+[![types included](https://img.shields.io/badge/types-included-blue.svg)](#)
+[![ESM only](https://img.shields.io/badge/module-ESM-f7df1e.svg)](#)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+Builds the **Path of Exile 2 passive tree** — the node data and the sprite
+atlases — straight from the official GGPK / patch server, in the shape
+[`@poe2-toolkit/tree-core`](../poe2-tree-core) consumes.
+
+It is source-agnostic: it never downloads anything itself. You hand it a
+[`@poe2-toolkit/ggpk`](../poe2-ggpk) source and it returns the data, ready to use or to
+write wherever you publish it.
+
+**Code only.** This package ships no game data and no art. Everything it produces
+is read from the patch server at run time and handed back to you; nothing from
+the game is bundled or stored here.
+
+## Install
+
+```sh
+npm install @poe2-toolkit/tree-extractor @poe2-toolkit/ggpk
+```
+
+Node 18+. ESM only. TypeScript types are included.
+
+## The contract
+
+The library **returns formatted data** — it performs no I/O of its own beyond
+what the source serves, and it never writes to disk. You decide what to do with
+the result.
+
+```ts
+import { createCdnSource } from '@poe2-toolkit/ggpk';
+import { extractTree } from '@poe2-toolkit/tree-extractor';
+
+const source = await createCdnSource({
+  patch: '4.5.3.1.7',
+  tablesDir: './tables/English',
+  cacheDir: './.cache',
+});
+
+const { data, graphics, centre } = await extractTree(source);
+```
+
+`extractTree(source)` returns a `TreeBundle`:
+
+| Field | Type | What it is |
+| --- | --- | --- |
+| `data` | `TreeExport` | The `data.json` payload — `@poe2-toolkit/tree-core`'s normalize input (nodes, groups, classes, jewel slots, attribute choices). |
+| `graphics` | `GraphicsResult` | The four sprite atlases (`skills`, `skills-disabled`, `frame`, `mastery-effect-active`), each a packed PNG plus its frame-map, with a report of what packed or was skipped. |
+| `centre` | `Record<string, Buffer>` | Centre art keyed by output name (`portrait-ranger`, `ascendancy-deadeye`, `ring-static`, …), each a PNG buffer. |
+
+The individual steps are exported too, if you only need one:
+`buildTree(source)`, `buildGraphics(source, data)`, `buildCentre(source)`.
+
+## CLI: write the bundle to disk
+
+When you do want files, the bundled CLI writes the whole bundle to a
+**configurable output directory** — nothing is written inside the package:
+
+```sh
+poe2-tree-extract \
+  --patch 4.5.3.1.7 \
+  --tables ./tables/English \
+  --cache ./.cache \
+  --out ./out/tree
+```
+
+It writes `data.json`, the four atlases as `assets/<name>.png` + `<name>.json`,
+and the centre art as `centre/<name>.png`. Output is PNG + JSON; converting the
+PNGs to WebP for the web is a separate publish step left to you.
+
+## How it works
+
+- **Data** comes from GGPK tables (`PassiveSkills`, `PassiveSkillMasteryGroups`,
+  `Characters`, `Ascendancy`, …) joined to the `.psg` passive-graph geometry,
+  with stat lines rendered through `@poe2-toolkit/ggpk`'s stat-description engine.
+- **Sprites** are decoded from GGPK DDS art and packed into atlases keyed exactly
+  as the renderer expects. A sprite the source cannot serve is skipped and
+  reported — never pulled from a vendored asset.
+
+Released PoE2 classes and ascendancies only; the GGPK's leftover PoE1 placeholder
+classes are filtered out from the data.
+
+## Attributions and legal
+
+This is an unofficial, fan-made project, **not** affiliated with, endorsed by, or
+sponsored by Grinding Gear Games. "Path of Exile 2" is a trademark of Grinding
+Gear Games, and all game content, data, and art are their property. This package
+ships code only and stores nothing derived from the game. Thank you to Grinding
+Gear Games for making Path of Exile 2.
+
+GGPK access is provided by [`@poe2-toolkit/ggpk`](../poe2-ggpk), which builds on
+[`pathofexile-dat`](https://github.com/SnosMe/poe-dat-viewer) (MIT, © SnosMe).
+Full attribution is in the repository [NOTICE](../../NOTICE.md).
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/atlas.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shelf bin-packer: composites decoded sprites into one sheet and emits the
+ * frame-map the renderer reads (`{ frames: { key: { frame: { x, y, w, h } } } }`).
+ */
+/** A decoded sprite to place in an atlas, keyed by its renderer atlas key. */
+export interface AtlasSprite {
+    key: string;
+    width: number;
+    height: number;
+    rgba: Uint8Array;
+}
+/** One placed sprite's pixel rect inside the packed sheet. */
+export interface AtlasFrame {
+    frame: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}
+/** A packed atlas: its PNG bytes and the frame-map keyed by sprite key. */
+export interface PackedAtlas {
+    png: Buffer;
+    frames: Record<string, AtlasFrame>;
+}
+/** Pack sprites into a single sheet, tallest-first, wrapping at `maxWidth`. */
+export declare function packAtlas(sprites: AtlasSprite[], maxWidth?: number): PackedAtlas;
+/** Grayscale (luminance) copy, alpha preserved — the dimmed/inactive look. */
+export declare function desaturate(rgba: Uint8Array): Uint8Array;
+//# sourceMappingURL=atlas.d.ts.map

package/dist/atlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas.d.ts","sourceRoot":"","sources":["../src/atlas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC;AAKD,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,QAAQ,SAAO,GAAG,WAAW,CAoC9E;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAUvD"}

package/dist/atlas.js

@@ -0,0 +1,48 @@
+/**
+ * Shelf bin-packer: composites decoded sprites into one sheet and emits the
+ * frame-map the renderer reads (`{ frames: { key: { frame: { x, y, w, h } } } }`).
+ */
+import { encodePng } from '@poe2-toolkit/ggpk';
+/** Transparent gutter so neighbours never bleed under bilinear sampling. */
+const PAD = 1;
+/** Pack sprites into a single sheet, tallest-first, wrapping at `maxWidth`. */
+export function packAtlas(sprites, maxWidth = 2048) {
+    // Tallest-first shelf packing keeps rows tight and the sheet near-square.
+    const sorted = [...sprites].sort((a, b) => b.height - a.height);
+    let x = 0, y = 0, shelfHeight = 0, sheetWidth = 0;
+    const placed = [];
+    for (const sprite of sorted) {
+        if (x + sprite.width + PAD > maxWidth && x > 0) {
+            x = 0;
+            y += shelfHeight + PAD;
+            shelfHeight = 0;
+        }
+        placed.push({ sprite, x, y });
+        x += sprite.width + PAD;
+        shelfHeight = Math.max(shelfHeight, sprite.height);
+        sheetWidth = Math.max(sheetWidth, x);
+    }
+    const sheetHeight = y + shelfHeight;
+    const sheet = new Uint8Array(sheetWidth * sheetHeight * 4);
+    const frames = {};
+    for (const { sprite, x: sx, y: sy } of placed) {
+        for (let row = 0; row < sprite.height; row++) {
+            const src = row * sprite.width * 4;
+            const dst = ((sy + row) * sheetWidth + sx) * 4;
+            sheet.set(sprite.rgba.subarray(src, src + sprite.width * 4), dst);
+        }
+        frames[sprite.key] = { frame: { x: sx, y: sy, w: sprite.width, h: sprite.height } };
+    }
+    return { png: encodePng(sheetWidth, sheetHeight, sheet), frames };
+}
+/** Grayscale (luminance) copy, alpha preserved — the dimmed/inactive look. */
+export function desaturate(rgba) {
+    const out = new Uint8Array(rgba.length);
+    for (let i = 0; i < rgba.length; i += 4) {
+        const lum = Math.round(0.299 * rgba[i] + 0.587 * rgba[i + 1] + 0.114 * rgba[i + 2]);
+        out[i] = out[i + 1] = out[i + 2] = lum;
+        out[i + 3] = rgba[i + 3];
+    }
+    return out;
+}
+//# sourceMappingURL=atlas.js.map

package/dist/atlas.js.map

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

package/dist/buildCentre.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Extracts the tree's centre art from GGPK: per-class portraits (real PoE2
+ * classes only — those with a released ascendancy), per-ascendancy portraits
+ * (released only), and the two hub-ring sprites. All decoded to PNG.
+ *
+ * Like the rest of the rewrite this is GGPK-only: art the source cannot serve is
+ * skipped, never pulled from a vendored GGG sheet.
+ */
+import type { GgpkImageSource, GgpkSource } from '@poe2-toolkit/ggpk';
+/** A source able to both read tables and fetch images. */
+export type CentreSource = GgpkSource & GgpkImageSource;
+/**
+ * Build the centre art. Returns a map of output name (without extension, e.g.
+ * `portrait-ranger`, `ascendancy-deadeye`, `ring-static`) to its PNG bytes.
+ */
+export declare function buildCentre(source: CentreSource): Promise<Record<string, Buffer>>;
+//# sourceMappingURL=buildCentre.d.ts.map

package/dist/buildCentre.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildCentre.d.ts","sourceRoot":"","sources":["../src/buildCentre.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAC,eAAe,EAAE,UAAU,EAAC,MAAM,oBAAoB,CAAC;AAKpE,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,eAAe,CAAC;AAuBxD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoDvF"}

package/dist/buildCentre.js

@@ -0,0 +1,71 @@
+/**
+ * Extracts the tree's centre art from GGPK: per-class portraits (real PoE2
+ * classes only — those with a released ascendancy), per-ascendancy portraits
+ * (released only), and the two hub-ring sprites. All decoded to PNG.
+ *
+ * Like the rest of the rewrite this is GGPK-only: art the source cannot serve is
+ * skipped, never pulled from a vendored GGG sheet.
+ */
+import { encodePng } from '@poe2-toolkit/ggpk';
+/** The hub-ring sprites, by output name and UIImages logical name. */
+const RING = [
+    { out: 'ring-static', name: 'Art/2DArt/UIImages/InGame/PassiveTree/PassiveTreeMainCircle' },
+    { out: 'ring-active', name: 'Art/2DArt/UIImages/InGame/PassiveTree/PassiveTreeMainCircleActive2' },
+];
+function isReleased(asc) {
+    return Boolean(asc.Name) && !asc.Name.includes('[DNT') && !asc.Disabled;
+}
+/** Decode a DDS path to a PNG buffer, or `null` if the source can't serve it. */
+async function emit(source, ddsPath) {
+    if (!ddsPath?.toLowerCase().endsWith('.dds')) {
+        return null;
+    }
+    const img = await source.dds(ddsPath);
+    return img ? encodePng(img.width, img.height, img.rgba) : null;
+}
+/**
+ * Build the centre art. Returns a map of output name (without extension, e.g.
+ * `portrait-ranger`, `ascendancy-deadeye`, `ring-static`) to its PNG bytes.
+ */
+export async function buildCentre(source) {
+    const Characters = (await source.table('Characters'));
+    const Ascendancy = (await source.table('Ascendancy'));
+    const out = {};
+    // Real PoE2 classes only: the ones with a released ascendancy. GGPK still
+    // carries 4 PoE1 placeholder classes whose ascendancies are all [DNT-UNUSED].
+    const realClassIndex = new Set();
+    for (const asc of Ascendancy) {
+        if (isReleased(asc) && asc.Character != null) {
+            realClassIndex.add(asc.Character);
+        }
+    }
+    for (const [index, character] of Characters.entries()) {
+        if (!realClassIndex.has(index)) {
+            continue;
+        }
+        const png = await emit(source, character.PassiveTreeImage);
+        if (png) {
+            out[`portrait-${character.Name.toLowerCase()}`] = png;
+        }
+    }
+    for (const asc of Ascendancy) {
+        if (!isReleased(asc)) {
+            continue;
+        }
+        const slug = asc.Name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+        const png = await emit(source, asc.PassiveTreeImage);
+        if (png) {
+            out[`ascendancy-${slug}`] = png;
+        }
+    }
+    // Hub ring: static ornate circle + active-class edge marker.
+    for (const { out: name, name: logical } of RING) {
+        const ref = await source.resolveSprite(logical);
+        const png = ref ? await emit(source, ref.path) : null;
+        if (png) {
+            out[name] = png;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=buildCentre.js.map

package/dist/buildCentre.js.map

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

package/dist/buildGraphics.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Builds the passive-tree sprite atlases from GGPK art, in the shape the
+ * renderer reads: skill icons (`skills` + desaturated `skills-disabled`), node
+ * frames (`frame`), and mastery effect patterns (`mastery-effect-active`).
+ * Atlas keys mirror the engine's `spriteKeys`. Source: GGPK only.
+ *
+ * Unlike the legacy script this has no GGG-export fallback: a sprite the source
+ * cannot serve is skipped and reported, never pulled from a vendored asset.
+ */
+import type { GgpkImageSource, GgpkSource } from '@poe2-toolkit/ggpk';
+import type { PackedAtlas } from './atlas.js';
+import type { TreeExport } from './buildTree.js';
+/** The four atlases this build produces, keyed by atlas name. */
+export interface TreeAtlases {
+    skills: PackedAtlas;
+    'skills-disabled': PackedAtlas;
+    frame: PackedAtlas;
+    'mastery-effect-active': PackedAtlas;
+}
+/** Per-atlas counts of sprites packed and sources missing, for reporting. */
+export interface GraphicsReport {
+    skills: {
+        packed: number;
+        missing: number;
+    };
+    frames: {
+        packed: number;
+    };
+    masteryEffects: {
+        packed: number;
+        missing: number;
+    };
+}
+/** The build's atlases plus a report of what was packed or skipped. */
+export interface GraphicsResult {
+    atlases: TreeAtlases;
+    report: GraphicsReport;
+}
+/** A source able to both read tables and fetch images. */
+export type GraphicsSource = GgpkSource & GgpkImageSource;
+export declare function buildGraphics(source: GraphicsSource, tree: TreeExport): Promise<GraphicsResult>;
+//# sourceMappingURL=buildGraphics.d.ts.map

package/dist/buildGraphics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGraphics.d.ts","sourceRoot":"","sources":["../src/buildGraphics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGtE,OAAO,KAAK,EAAc,WAAW,EAAC,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,iBAAiB,EAAE,WAAW,CAAC;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,uBAAuB,EAAE,WAAW,CAAC;CACtC;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,cAAc,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;CACxB;AAcD,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,eAAe,CAAC;AAmB1D,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CA0HrG"}

package/dist/buildGraphics.js

@@ -0,0 +1,124 @@
+/**
+ * Builds the passive-tree sprite atlases from GGPK art, in the shape the
+ * renderer reads: skill icons (`skills` + desaturated `skills-disabled`), node
+ * frames (`frame`), and mastery effect patterns (`mastery-effect-active`).
+ * Atlas keys mirror the engine's `spriteKeys`. Source: GGPK only.
+ *
+ * Unlike the legacy script this has no GGG-export fallback: a sprite the source
+ * cannot serve is skipped and reported, never pulled from a vendored asset.
+ */
+import { desaturate, packAtlas } from './atlas.js';
+/** Engine variant prefix for a node's skill icon (mirrors `iconKeyFor`). */
+function variantOf(node) {
+    if (node.isMastery) {
+        return null; // masteries render as their effect pattern
+    }
+    if (node.isKeystone) {
+        return 'keystone';
+    }
+    if (node.isNotable) {
+        return 'notable';
+    }
+    return 'normal';
+}
+export async function buildGraphics(source, tree) {
+    // --- skill icons: skills (active) + skills-disabled (desaturated) ----------
+    // icon-path -> variant; first node wins, same icon shares a variant.
+    const wanted = new Map();
+    for (const node of Object.values(tree.nodes)) {
+        const variant = variantOf(node);
+        if (variant && node.icon && !wanted.has(`${variant}:${node.icon}`)) {
+            wanted.set(`${variant}:${node.icon}`, { variant, icon: node.icon });
+        }
+    }
+    // +attribute choice icons (Str/Dex/Int) — shown on the node once an attribute
+    // is picked; not a node's own icon, so add them explicitly.
+    for (const override of Object.values(tree.skillOverrides)) {
+        const icon = override.icon;
+        if (typeof icon === 'string' && icon && !wanted.has(`normal:${icon}`)) {
+            wanted.set(`normal:${icon}`, { variant: 'normal', icon });
+        }
+    }
+    const active = [];
+    const inactive = [];
+    let iconsMissing = 0;
+    for (const { variant, icon } of wanted.values()) {
+        const img = await source.dds(icon);
+        if (!img) {
+            iconsMissing += 1;
+            continue;
+        }
+        active.push({ key: `${variant}Active:${icon}`, width: img.width, height: img.height, rgba: img.rgba });
+        inactive.push({ key: `${variant}Inactive:${icon}`, width: img.width, height: img.height, rgba: desaturate(img.rgba) });
+    }
+    // --- node frames: frame atlas ----------------------------------------------
+    // The UIArt "Character" row drives the main tree, "Ascendancy" the disc frames.
+    // NodeFrameArt Normal/CanAllocate/Active map to the renderer's states.
+    const UIArt = (await source.table('PassiveSkillTreeUIArt'));
+    const NodeFrameArt = (await source.table('PassiveSkillTreeNodeFrameArt'));
+    const mainUi = UIArt.find((r) => r.Id === 'Character');
+    const ascUi = UIArt.find((r) => r.Id === 'Ascendancy');
+    const frameSprites = [];
+    const addFrame = async (key, frameArtIndex, state) => {
+        const art = frameArtIndex != null ? NodeFrameArt[frameArtIndex] : undefined;
+        const path = art?.[state];
+        const img = path ? await source.uiSprite(path) : null;
+        if (img) {
+            frameSprites.push({ key, width: img.width, height: img.height, rgba: img.rgba });
+        }
+    };
+    // Main-tree frames (engine keys from frameKeyFor).
+    await addFrame('KeystoneFrameUnallocated', mainUi?.KeystoneFrame, 'Normal');
+    await addFrame('KeystoneFrameCanAllocate', mainUi?.KeystoneFrame, 'CanAllocate');
+    await addFrame('KeystoneFrameAllocated', mainUi?.KeystoneFrame, 'Active');
+    await addFrame('NotableFrameUnallocated', mainUi?.NotableFrame, 'Normal');
+    await addFrame('NotableFrameCanAllocate', mainUi?.NotableFrame, 'CanAllocate');
+    await addFrame('NotableFrameAllocated', mainUi?.NotableFrame, 'Active');
+    await addFrame('JewelFrameUnallocated', mainUi?.JewelFrame, 'Normal');
+    await addFrame('JewelFrameCanAllocate', mainUi?.JewelFrame, 'CanAllocate');
+    await addFrame('JewelFrameAllocated', mainUi?.JewelFrame, 'Active');
+    await addFrame('PSSkillFrame', mainUi?.PassiveFrame, 'Normal');
+    await addFrame('PSSkillFrameHighlighted', mainUi?.PassiveFrame, 'CanAllocate');
+    await addFrame('PSSkillFrameActive', mainUi?.PassiveFrame, 'Active');
+    // Ascendancy disc frames.
+    await addFrame('AscendancyFrameNormalUnallocated', ascUi?.PassiveFrame, 'Normal');
+    await addFrame('AscendancyFrameNormalAllocated', ascUi?.PassiveFrame, 'Active');
+    await addFrame('AscendancyFrameNotableUnallocated', ascUi?.NotableFrame, 'Normal');
+    await addFrame('AscendancyFrameNotableAllocated', ascUi?.NotableFrame, 'Active');
+    await addFrame('AscendancyStartNode', ascUi?.AscendancyStart, 'Active');
+    // --- mastery effect patterns: mastery-effect-active atlas ------------------
+    // Renderer keys them `masteryEffectActive:<ActiveEffectImage>.png`.
+    const effectImages = new Set();
+    for (const node of Object.values(tree.nodes)) {
+        if (node.activeEffectImage) {
+            effectImages.add(node.activeEffectImage);
+        }
+    }
+    const masterySprites = [];
+    let masteryMissing = 0;
+    for (const path of effectImages) {
+        const img = await source.uiSprite(path);
+        if (!img) {
+            masteryMissing += 1;
+            continue;
+        }
+        masterySprites.push({ key: `masteryEffectActive:${path}.png`, width: img.width, height: img.height, rgba: img.rgba });
+    }
+    // Patterns are large (~775²); a wide sheet keeps both dimensions under webp's
+    // 16383px cap.
+    const atlases = {
+        'skills': packAtlas(active),
+        'skills-disabled': packAtlas(inactive),
+        'frame': packAtlas(frameSprites),
+        'mastery-effect-active': packAtlas(masterySprites, 6000),
+    };
+    return {
+        atlases,
+        report: {
+            skills: { packed: active.length, missing: iconsMissing },
+            frames: { packed: frameSprites.length },
+            masteryEffects: { packed: masterySprites.length, missing: masteryMissing },
+        },
+    };
+}
+//# sourceMappingURL=buildGraphics.js.map

package/dist/buildGraphics.js.map

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

package/dist/buildTree.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Builds the passive-tree `data.json` from GGPK tables + the `.psg` graph, in
+ * the shape `@poe2-toolkit/tree-core`'s `normalizeGggTree` expects. Source of truth:
+ * GGPK only.
+ *
+ * Linkage (verified): a node's `skill` = PassiveSkillGraphId; the `.psg` keys
+ * nodes by the same id; PassiveSkills rows join by PassiveSkillGraphId.
+ * Positions are computed from group centre + orbit radius + orbit index (radii
+ * derived from the live tree, exact). Stats render via the passive + base
+ * stat-description files.
+ */
+import type { GgpkSource } from '@poe2-toolkit/ggpk';
+/** A tree node as serialized to `data.json` (graph node, or data-only override). */
+export interface ExportNode {
+    skill: number;
+    name: string;
+    icon: string;
+    stats: string[];
+    group?: number;
+    orbit?: number;
+    orbitIndex?: number;
+    x?: number;
+    y?: number;
+    out?: number[];
+    in?: number[];
+    isNotable?: true;
+    isKeystone?: true;
+    isJewelSocket?: true;
+    isMastery?: true;
+    isGenericAttribute?: true;
+    isAscendancyStart?: true;
+    activeEffectImage?: string;
+    ascendancyId?: string;
+    classStartIndex?: number[];
+    flavourText?: unknown;
+}
+export interface ExportAscendancy {
+    id: string;
+    name: string;
+    offsetX: number;
+    offsetY: number;
+}
+export interface ExportClass {
+    name: string;
+    base_str: number;
+    base_dex: number;
+    base_int: number;
+    ascendancies: ExportAscendancy[];
+    overridePairs: Record<number, number>;
+}
+export interface ExportGroup {
+    x: number;
+    y: number;
+    orbits: number[];
+    nodes: number[];
+}
+/** The full `data.json` payload. */
+export interface TreeExport {
+    tree: string;
+    classes: ExportClass[];
+    groups: Record<number, ExportGroup>;
+    nodes: Record<number, ExportNode>;
+    edges: never[];
+    skillOverrides: Record<number, Record<string, unknown>>;
+    jewelSlots: number[];
+    min_x: number;
+    min_y: number;
+    max_x: number;
+    max_y: number;
+}
+/**
+ * Build the passive-tree export. All data comes from the supplied
+ * {@link GgpkSource}; this function performs no I/O of its own beyond what the
+ * source serves.
+ */
+export declare function buildTree(source: GgpkSource): Promise<TreeExport>;
+//# sourceMappingURL=buildTree.d.ts.map

package/dist/buildTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTree.d.ts","sourceRoot":"","sources":["../src/buildTree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAC,UAAU,EAAY,MAAM,oBAAoB,CAAC;AA+C9D,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,kBAAkB,CAAC,EAAE,IAAI,CAAC;IAC1B,iBAAiB,CAAC,EAAE,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAEhG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE;AAExF,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAaD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAqUvE"}