asset-builder-packer 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nonamezzz322
+
+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,37 @@
+# asset-builder-packer
+
+A texture-atlas packer for **Pixi** and **Spine**, built on `sharp`/libvips and
+`maxrects-packer`. It takes decoded RGBA sprites and produces composited atlas pages plus typed
+Pixi spritesheet JSON and Spine `.atlas` output.
+
+Why another packer:
+
+- **sharp/libvips compositing** — raw-RGBA pages end-to-end; encode once per output format
+  (PNG/WebP/AVIF/JPG) downstream, no intermediate re-encoding.
+- **Typed emitters, not templates/regex** — Pixi JSON and Spine `.atlas` are built from data;
+  format variants come from a second emitter call, never string replacement.
+- **First-class trim + rotation for Spine** — correct `offset`/`orig` math with Y-up offsets
+  (many pipelines hardcode `offset: 0,0` and can't trim Spine attachments).
+- **Deterministic** — identical input + options ⇒ byte-identical pages and emitter output, so it
+  composes cleanly with content-hash build caches.
+- **Fill-rate metrics** — per-page efficiency for VRAM budgeting.
+
+Originally built to replace [free-tex-packer-core](https://github.com/odrick/free-tex-packer-core)
+in an internal asset pipeline; published as a standalone library.
+
+```ts
+import { pack, emitPixiJson, emitSpineAtlasPage } from 'asset-builder-packer';
+
+const result = await pack(images, { maxWidth: 4096, maxHeight: 4096, allowTrim: true });
+for (const page of result.pages) {
+    const json = emitPixiJson(page, { imageName: `${name}-${page.pageIndex}.png`, scale: 1 });
+    // page.data is raw RGBA — encode with sharp to png/webp/avif, once per format
+}
+```
+
+Status: phase 0 (contract + emitters + tests). Roadmap: [docs/PLAN.md](docs/PLAN.md).
+Working agreements and invariants: [CLAUDE.md](CLAUDE.md).
+
+- `npm test` — vitest
+- `npm run typecheck` — tsc noEmit
+- `npm run build` — compile to `dist/`

package/dist/autosize.d.ts

@@ -0,0 +1,13 @@
+import type { PackOptions, SizeEvaluation, AutoSizeConfig } from './types.js';
+import { type PlacementInput } from './place.js';
+/** Наименьший квадратный размер, вмещающий самый большой раздутый кадр (нижняя граница кандидатов). */
+export declare function minFeasibleSize(inputs: readonly PlacementInput[], options: PackOptions): number;
+/**
+ * Оценивает кандидатные размеры страницы ЧЕРЕЗ РАЗМЕЩЕНИЕ (без композитинга — дёшево).
+ * Кандидаты меньше минимально допустимого пропускаются. По одной оценке на валидный кандидат,
+ * отсортированы по возрастанию размера.
+ */
+export declare function evaluateSizes(inputs: readonly PlacementInput[], options: PackOptions): SizeEvaluation[];
+/** Выбирает лучшую оценку по цели. При равенстве счёта — меньший размер (детерминизм, меньше риск одной гигантской текстуры). */
+export declare function chooseBestSize(evals: readonly SizeEvaluation[], objective: AutoSizeConfig['objective']): SizeEvaluation;
+//# sourceMappingURL=autosize.d.ts.map

package/dist/autosize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autosize.d.ts","sourceRoot":"","sources":["../src/autosize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAI9D,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAK/F;AAYD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CAqBvG;AAED,iIAAiI;AACjI,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,cAAc,CAkBvH"}

package/dist/autosize.js

@@ -0,0 +1,72 @@
+import { placeFrames } from './place.js';
+import { computeReport } from './metrics.js';
+import { OversizedFrameError } from './errors.js';
+/** Наименьший квадратный размер, вмещающий самый большой раздутый кадр (нижняя граница кандидатов). */
+export function minFeasibleSize(inputs, options) {
+    const g = 2 * (options.padding + options.extrude);
+    let m = 1;
+    for (const i of inputs)
+        m = Math.max(m, i.w + g, i.h + g);
+    return m;
+}
+/** Лестница степеней двойки [min..max], включая сам max (может быть не-POT). */
+function potLadder(min, max) {
+    const out = [];
+    let p = 1;
+    while (p < min)
+        p *= 2;
+    for (; p < max; p *= 2)
+        out.push(p);
+    out.push(max);
+    return out;
+}
+/**
+ * Оценивает кандидатные размеры страницы ЧЕРЕЗ РАЗМЕЩЕНИЕ (без композитинга — дёшево).
+ * Кандидаты меньше минимально допустимого пропускаются. По одной оценке на валидный кандидат,
+ * отсортированы по возрастанию размера.
+ */
+export function evaluateSizes(inputs, options) {
+    if (inputs.length === 0)
+        return [];
+    const areaByName = new Map(inputs.map(i => [i.name, i.w * i.h]));
+    const min = minFeasibleSize(inputs, options);
+    const raw = options.autoSize.candidates ?? potLadder(min, options.maxWidth);
+    const candidates = [...new Set(raw)]
+        .filter(s => s >= min && s <= options.maxWidth)
+        .sort((a, b) => a - b);
+    const evals = [];
+    for (const size of candidates) {
+        try {
+            const placements = placeFrames([...inputs], { ...options, maxWidth: size, maxHeight: size });
+            evals.push({ size, report: computeReport(placements, areaByName, size) });
+        }
+        catch (e) {
+            if (e instanceof OversizedFrameError)
+                continue; // размер слишком мал — пропускаем
+            throw e;
+        }
+    }
+    return evals;
+}
+/** Выбирает лучшую оценку по цели. При равенстве счёта — меньший размер (детерминизм, меньше риск одной гигантской текстуры). */
+export function chooseBestSize(evals, objective) {
+    if (evals.length === 0)
+        throw new Error('chooseBestSize: no candidate size fits the input');
+    const score = (e) => {
+        switch (objective) {
+            case 'vram': return e.report.totalVramBytes;
+            case 'potVram': return e.report.totalPotVramBytes;
+            case 'fill': return -e.report.overallFillRate; // максимизируем fill → минимизируем отрицание
+        }
+    };
+    return evals.reduce((best, e) => {
+        const s = score(e);
+        const bs = score(best);
+        if (s < bs)
+            return e;
+        if (s === bs && e.size < best.size)
+            return e;
+        return best;
+    });
+}
+//# sourceMappingURL=autosize.js.map

package/dist/autosize.js.map

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

package/dist/compose.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import type { InputImage, PackedPage } from './types.js';
+/**
+ * Собирает размещённые кадры в сырой RGBA-буфер страницы (FR-22..FR-24).
+ *
+ * На кадр: извлекается трим-окно из исходника → при rotated поворот 90° CW (sharp.rotate(90),
+ * направление подтверждено пиксельным тестом — соответствует Pixi `rotated:true` / Spine
+ * `rotate:270`) → extrude-кайма репликацией краёв (extendWith:'copy') → композит в позицию.
+ * Один composite-проход на страницу. Aliases не рендерятся отдельно — они ссылаются на тот же
+ * регион на этапе эмиттеров. Выход — сырой RGBA (кодирование форматов — снаружи, FR-24).
+ */
+export declare function composePage(page: Omit<PackedPage, 'data'>, images: Map<string, InputImage>, extrude: number): Promise<Buffer>;
+//# sourceMappingURL=compose.d.ts.map

package/dist/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":";;AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC7B,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAC/B,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAsCjB"}

package/dist/compose.js

@@ -0,0 +1,46 @@
+import sharp from 'sharp';
+/**
+ * Собирает размещённые кадры в сырой RGBA-буфер страницы (FR-22..FR-24).
+ *
+ * На кадр: извлекается трим-окно из исходника → при rotated поворот 90° CW (sharp.rotate(90),
+ * направление подтверждено пиксельным тестом — соответствует Pixi `rotated:true` / Spine
+ * `rotate:270`) → extrude-кайма репликацией краёв (extendWith:'copy') → композит в позицию.
+ * Один composite-проход на страницу. Aliases не рендерятся отдельно — они ссылаются на тот же
+ * регион на этапе эмиттеров. Выход — сырой RGBA (кодирование форматов — снаружи, FR-24).
+ */
+export async function composePage(page, images, extrude) {
+    const composites = [];
+    for (const frame of page.frames) {
+        const src = images.get(frame.name);
+        if (!src)
+            throw new Error(`composePage: no source image for frame "${frame.name}"`);
+        // 1) Материализуем трим-окно (снимает неоднозначность порядка extract/rotate в sharp).
+        const trimmed = await sharp(src.data, { raw: { width: src.width, height: src.height, channels: 4 } })
+            .extract({ left: frame.trimX, top: frame.trimY, width: frame.w, height: frame.h })
+            .raw()
+            .toBuffer();
+        // 2) Свежий pipeline: поворот (90° CW) → extrude.
+        let region = sharp(trimmed, { raw: { width: frame.w, height: frame.h, channels: 4 } });
+        if (frame.rotated) {
+            region = region.rotate(90);
+        }
+        if (extrude > 0) {
+            region = region.extend({ top: extrude, bottom: extrude, left: extrude, right: extrude, extendWith: 'copy' });
+        }
+        const { data, info } = await region.raw().toBuffer({ resolveWithObject: true });
+        // Контент лежит в (frame.x, frame.y); extrude-кайма выступает наружу на `extrude` px.
+        // Слева/сверху места достаточно: frame.x = boxX + (padding+extrude) ≥ extrude.
+        composites.push({
+            input: data,
+            raw: { width: info.width, height: info.height, channels: 4 },
+            left: frame.x - extrude,
+            top: frame.y - extrude,
+        });
+    }
+    const base = sharp({
+        create: { width: page.width, height: page.height, channels: 4, background: { r: 0, g: 0, b: 0, alpha: 0 } },
+    });
+    const { data } = await base.composite(composites).raw().toBuffer({ resolveWithObject: true });
+    return data;
+}
+//# sourceMappingURL=compose.js.map

package/dist/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,IAA8B,EAC9B,MAA+B,EAC/B,OAAe;IAEf,MAAM,UAAU,GAA2B,EAAE,CAAC;IAE9C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QAEpF,uFAAuF;QACvF,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;aAChG,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;aACjF,GAAG,EAAE;aACL,QAAQ,EAAE,CAAC;QAEhB,kDAAkD;QAClD,IAAI,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACvF,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACjH,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhF,sFAAsF;QACtF,+EAA+E;QAC/E,UAAU,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,IAAI;YACX,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;YAC5D,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO;YACvB,GAAG,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO;SACzB,CAAC,CAAC;IACP,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC;QACf,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;KAC9G,CAAC,CAAC;IACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9F,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/emit/pixi.d.ts

@@ -0,0 +1,49 @@
+import type { PackedFrame, PackedPage } from '../types.js';
+export interface PixiFrameEntry {
+    frame: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    rotated: boolean;
+    trimmed: boolean;
+    spriteSourceSize: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    sourceSize: {
+        w: number;
+        h: number;
+    };
+}
+export interface PixiAtlasJson {
+    frames: Record<string, PixiFrameEntry>;
+    meta: {
+        app: string;
+        image: string;
+        format: 'RGBA8888';
+        size: {
+            w: number;
+            h: number;
+        };
+        scale: number;
+        related_multi_packs?: string[];
+    };
+}
+export declare function toPixiFrameEntry(f: PackedFrame): PixiFrameEntry;
+export interface EmitPixiOptions {
+    /** Texture filename referenced by meta.image (variant-specific: .png / _webp.webp / _avif.avif). */
+    imageName: string;
+    scale: number;
+    relatedMultiPacks?: string[];
+}
+/**
+ * Emit a Pixi spritesheet JSON object for one page. Serialization is the caller's business —
+ * format variants (webp/avif/jpg) MUST be produced by calling this again with a different
+ * `imageName`, never by string-replacing serialized output.
+ */
+export declare function emitPixiJson(page: PackedPage, opts: EmitPixiOptions): PixiAtlasJson;
+//# sourceMappingURL=pixi.d.ts.map

package/dist/emit/pixi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixi.d.ts","sourceRoot":"","sources":["../../src/emit/pixi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,IAAI,EAAE;QACF,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,UAAU,CAAC;QACnB,IAAI,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/B,KAAK,EAAE,MAAM,CAAC;QACd,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;KAClC,CAAC;CACL;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,GAAG,cAAc,CAU/D;AAED,MAAM,WAAW,eAAe;IAC5B,oGAAoG;IACpG,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,GAAG,aAAa,CAoBnF"}

package/dist/emit/pixi.js

@@ -0,0 +1,38 @@
+export function toPixiFrameEntry(f) {
+    return {
+        // Pixi convention (same as TexturePacker / free-tex-packer): frame w/h stay in
+        // UNROTATED orientation; the loader swaps them when `rotated` is set.
+        frame: { x: f.x, y: f.y, w: f.w, h: f.h },
+        rotated: f.rotated,
+        trimmed: f.trimmed,
+        spriteSourceSize: { x: f.trimX, y: f.trimY, w: f.w, h: f.h },
+        sourceSize: { w: f.sourceW, h: f.sourceH },
+    };
+}
+/**
+ * Emit a Pixi spritesheet JSON object for one page. Serialization is the caller's business —
+ * format variants (webp/avif/jpg) MUST be produced by calling this again with a different
+ * `imageName`, never by string-replacing serialized output.
+ */
+export function emitPixiJson(page, opts) {
+    const frames = {};
+    for (const f of page.frames) {
+        const entry = toPixiFrameEntry(f);
+        frames[f.name] = entry;
+        for (const alias of f.aliases) {
+            frames[alias] = entry;
+        }
+    }
+    const meta = {
+        app: '@gamzix/packer',
+        image: opts.imageName,
+        format: 'RGBA8888',
+        size: { w: page.width, h: page.height },
+        scale: opts.scale,
+    };
+    if (opts.relatedMultiPacks && opts.relatedMultiPacks.length > 0) {
+        meta.related_multi_packs = opts.relatedMultiPacks;
+    }
+    return { frames, meta };
+}
+//# sourceMappingURL=pixi.js.map

package/dist/emit/pixi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixi.js","sourceRoot":"","sources":["../../src/emit/pixi.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,gBAAgB,CAAC,CAAc;IAC3C,OAAO;QACH,+EAA+E;QAC/E,sEAAsE;QACtE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QACzC,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC5D,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE;KAC7C,CAAC;AACN,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAgB,EAAE,IAAqB;IAChE,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACvB,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;IACL,CAAC;IACD,MAAM,IAAI,GAA0B;QAChC,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,IAAI,CAAC,SAAS;QACrB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE;QACvC,KAAK,EAAE,IAAI,CAAC,KAAK;KACpB,CAAC;IACF,IAAI,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,iBAAiB,CAAC;IACtD,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}

package/dist/emit/spine.d.ts

@@ -0,0 +1,22 @@
+import type { PackedFrame, PackedPage } from '../types.js';
+export interface EmitSpineOptions {
+    /** Texture filename for the page header (variant-specific: .png / _webp.webp / _avif.avif). */
+    textureName: string;
+}
+/**
+ * Emit one Spine `.atlas` page section as text.
+ *
+ * Geometry (see invariants in types.ts):
+ * - `size` / `orig` are in UNROTATED orientation.
+ * - `offset` is in unrotated source space with Spine's Y-UP convention:
+ *   offsetX = left whitespace, offsetY = BOTTOM whitespace = sourceH - trimY - h.
+ *   Rotation does not enter the offset math at all.
+ * - `rotate: 270` is the pinned mapping for our 90° CW page rotation (see types.ts §3);
+ *   verified against production Gamzix runtimes, matches the legacy transcoder.
+ *
+ * Note: free-tex-packer's own Spine exporter hardcodes `offset: 0,0` (broken for trim);
+ * this emitter is the correct replacement, not a port.
+ */
+export declare function emitSpineAtlasPage(page: PackedPage, opts: EmitSpineOptions): string;
+export declare function spineRegionLines(name: string, f: PackedFrame): string[];
+//# sourceMappingURL=spine.d.ts.map

package/dist/emit/spine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spine.d.ts","sourceRoot":"","sources":["../../src/emit/spine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC7B,+FAA+F;IAC/F,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAiBnF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAYvE"}

package/dist/emit/spine.js

@@ -0,0 +1,43 @@
+/**
+ * Emit one Spine `.atlas` page section as text.
+ *
+ * Geometry (see invariants in types.ts):
+ * - `size` / `orig` are in UNROTATED orientation.
+ * - `offset` is in unrotated source space with Spine's Y-UP convention:
+ *   offsetX = left whitespace, offsetY = BOTTOM whitespace = sourceH - trimY - h.
+ *   Rotation does not enter the offset math at all.
+ * - `rotate: 270` is the pinned mapping for our 90° CW page rotation (see types.ts §3);
+ *   verified against production Gamzix runtimes, matches the legacy transcoder.
+ *
+ * Note: free-tex-packer's own Spine exporter hardcodes `offset: 0,0` (broken for trim);
+ * this emitter is the correct replacement, not a port.
+ */
+export function emitSpineAtlasPage(page, opts) {
+    const lines = [];
+    lines.push('');
+    lines.push(opts.textureName);
+    lines.push(`size: ${page.width},${page.height}`);
+    lines.push('format: RGBA8888');
+    lines.push('filter: Linear,Linear');
+    lines.push('repeat: none');
+    for (const f of page.frames) {
+        for (const name of [f.name, ...f.aliases]) {
+            lines.push(...spineRegionLines(name, f));
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+export function spineRegionLines(name, f) {
+    const offsetX = f.trimX;
+    const offsetY = f.sourceH - f.trimY - f.h;
+    return [
+        name,
+        `  rotate: ${f.rotated ? '270' : '0'}`,
+        `  xy: ${f.x}, ${f.y}`,
+        `  size: ${f.w}, ${f.h}`,
+        `  orig: ${f.sourceW}, ${f.sourceH}`,
+        `  offset: ${offsetX}, ${offsetY}`,
+        '  index: -1',
+    ];
+}
+//# sourceMappingURL=spine.js.map

package/dist/emit/spine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spine.js","sourceRoot":"","sources":["../../src/emit/spine.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAgB,EAAE,IAAsB;IACvE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE3B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,CAAc;IACzD,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC;IACxB,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO;QACH,IAAI;QACJ,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE;QACtC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACtB,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACxB,WAAW,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,EAAE;QACpC,aAAa,OAAO,KAAK,OAAO,EAAE;QAClC,aAAa;KAChB,CAAC;AACN,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+/** Ошибки пакера. Типизированные, чтобы вызывающий (билдер) мог реагировать осмысленно. */
+/**
+ * Кадр (с учётом каймы 2*(padding+extrude)) не влезает в maxWidth×maxHeight ни в одной
+ * ориентации. Билдер по этой ошибке решает, поднимать ли maxTextureSize (FR-29).
+ */
+export declare class OversizedFrameError extends Error {
+    readonly frameName: string;
+    /** Минимальный размер страницы (кв.), при котором кадр поместится. */
+    readonly minPageSize: number;
+    constructor(frameName: string, minPageSize: number, maxWidth: number, maxHeight: number);
+}
+/** Некорректный вход: битый RGBA-буфер, дубли имён, небезопасные для формата имена (FR-1/4/30). */
+export declare class InvalidInputError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAS1F;AAED,mGAAmG;AACnG,qBAAa,iBAAkB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI9B"}

package/dist/errors.js

@@ -0,0 +1,25 @@
+/** Ошибки пакера. Типизированные, чтобы вызывающий (билдер) мог реагировать осмысленно. */
+/**
+ * Кадр (с учётом каймы 2*(padding+extrude)) не влезает в maxWidth×maxHeight ни в одной
+ * ориентации. Билдер по этой ошибке решает, поднимать ли maxTextureSize (FR-29).
+ */
+export class OversizedFrameError extends Error {
+    frameName;
+    /** Минимальный размер страницы (кв.), при котором кадр поместится. */
+    minPageSize;
+    constructor(frameName, minPageSize, maxWidth, maxHeight) {
+        super(`Frame "${frameName}" does not fit into ${maxWidth}x${maxHeight} even with padding/extrude; ` +
+            `needs a page of at least ${minPageSize}px.`);
+        this.name = 'OversizedFrameError';
+        this.frameName = frameName;
+        this.minPageSize = minPageSize;
+    }
+}
+/** Некорректный вход: битый RGBA-буфер, дубли имён, небезопасные для формата имена (FR-1/4/30). */
+export class InvalidInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidInputError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACjC,SAAS,CAAS;IAC3B,sEAAsE;IAC7D,WAAW,CAAS;IAE7B,YAAY,SAAiB,EAAE,WAAmB,EAAE,QAAgB,EAAE,SAAiB;QACnF,KAAK,CACD,UAAU,SAAS,uBAAuB,QAAQ,IAAI,SAAS,8BAA8B;YAC7F,4BAA4B,WAAW,KAAK,CAC/C,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;CACJ;AAED,mGAAmG;AACnG,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACpC,CAAC;CACJ"}

package/dist/identical.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Внутрипапочный дедуп (detectIdentical, FR-10..FR-12): побайтово идентичные (после trim) кадры
+ * схлопываются в один размещаемый экземпляр + aliases. Идентичность — по контент-хэшу тримленной
+ * области (см. hashTrimmedRegion), который уже включает размеры окна, поэтому кадры разного размера
+ * не схлопываются даже при совпадении пикселей перекрытия.
+ *
+ * Только в пределах одного вызова pack(). Кросс-атласный дедуп (linkedFrames) — слой выше.
+ */
+export interface IdenticalGroup {
+    /** Имя-представитель — первое по code-unit сортировке; оно размещается и рендерится. */
+    representative: string;
+    /** Остальные имена той же группы (сортированы) — станут aliases кадра-представителя. */
+    aliases: string[];
+}
+/**
+ * Группирует по хэшу. Возвращает по одной группе на уникальный контент (в т.ч. синглтоны с пустыми
+ * aliases), отсортированные по имени представителя — детерминированно (NFR-1).
+ */
+export declare function detectIdentical(items: ReadonlyArray<{
+    name: string;
+    hash: string;
+}>): IdenticalGroup[];
+//# sourceMappingURL=identical.d.ts.map

package/dist/identical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identical.d.ts","sourceRoot":"","sources":["../src/identical.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC3B,wFAAwF;IACxF,cAAc,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,cAAc,EAAE,CAetG"}

package/dist/identical.js

@@ -0,0 +1,33 @@
+/**
+ * Внутрипапочный дедуп (detectIdentical, FR-10..FR-12): побайтово идентичные (после trim) кадры
+ * схлопываются в один размещаемый экземпляр + aliases. Идентичность — по контент-хэшу тримленной
+ * области (см. hashTrimmedRegion), который уже включает размеры окна, поэтому кадры разного размера
+ * не схлопываются даже при совпадении пикселей перекрытия.
+ *
+ * Только в пределах одного вызова pack(). Кросс-атласный дедуп (linkedFrames) — слой выше.
+ */
+/**
+ * Группирует по хэшу. Возвращает по одной группе на уникальный контент (в т.ч. синглтоны с пустыми
+ * aliases), отсортированные по имени представителя — детерминированно (NFR-1).
+ */
+export function detectIdentical(items) {
+    const byHash = new Map();
+    for (const { name, hash } of items) {
+        const bucket = byHash.get(hash);
+        if (bucket)
+            bucket.push(name);
+        else
+            byHash.set(hash, [name]);
+    }
+    const groups = [];
+    for (const names of byHash.values()) {
+        names.sort(codeUnit);
+        groups.push({ representative: names[0], aliases: names.slice(1) });
+    }
+    groups.sort((a, b) => codeUnit(a.representative, b.representative));
+    return groups;
+}
+function codeUnit(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+//# sourceMappingURL=identical.js.map

package/dist/identical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identical.js","sourceRoot":"","sources":["../src/identical.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoD;IAChF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACzB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IAClC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import type { InputImage, PackOptions, PackResult, SizeEvaluation } from './types.js';
+export * from './types.js';
+export { emitPixiJson, toPixiFrameEntry } from './emit/pixi.js';
+export type { PixiAtlasJson, PixiFrameEntry, EmitPixiOptions } from './emit/pixi.js';
+export { emitSpineAtlasPage, spineRegionLines } from './emit/spine.js';
+export type { EmitSpineOptions } from './emit/spine.js';
+export { trimAlphaBounds, hashTrimmedRegion } from './trim.js';
+export { detectIdentical } from './identical.js';
+export type { IdenticalGroup } from './identical.js';
+export { placeFrames } from './place.js';
+export type { PlacementInput, Placement } from './place.js';
+export { validateInput } from './validate.js';
+export { OversizedFrameError, InvalidInputError } from './errors.js';
+export { composePage } from './compose.js';
+export { computeReport, nextPot } from './metrics.js';
+export { evaluateSizes, chooseBestSize, minFeasibleSize } from './autosize.js';
+/**
+ * What-if мониторинг БЕЗ композитинга: для каждого кандидатного размера страницы возвращает
+ * метрики (страницы, fill, VRAM, POT-VRAM). Дёшево (только размещение) — билдер может логировать
+ * это как отчёт заполненности или показывать выбор авто-подбора. Синхронно.
+ */
+export declare function analyzeSizes(images: InputImage[], options?: Partial<PackOptions>): SizeEvaluation[];
+/**
+ * Публичный вход: trim → detectIdentical → place (multi-heuristic, опц. авто-подбор размера) →
+ * compose. Возвращает сырые RGBA-страницы, геометрию кадров и метрики эффективности (report).
+ * См. docs/PLAN.md, docs/REQUIREMENTS.md.
+ */
+export declare function pack(images: InputImage[], options?: Partial<PackOptions>): Promise<PackResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAuC,cAAc,EAAE,MAAM,YAAY,CAAC;AAU3H,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACvE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA0C/E;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,cAAc,EAAE,CAKnG;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAiDpG"}