@forgeax/engine-pack 0.1.2

package/dist/atlas/run-atlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-atlas.d.ts","sourceRoot":"","sources":["../../src/atlas/run-atlas.ts"],"names":[],"mappings":"AAyCA,UAAU,QAAQ;IAChB,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAqRD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC7E"}

package/dist/atlas/shelf-pack.d.ts

@@ -0,0 +1,55 @@
+import type { ImageErrorCode } from '@forgeax/engine-types';
+/**
+ * Decoded image input for shelfPack. `pixels` length must equal
+ * `width * height * 4` (RGBA8); the field is carried so the caller can
+ * blit into the atlas buffer without re-decoding inside this module.
+ */
+export interface AtlasImageInput {
+    readonly name: string;
+    readonly width: number;
+    readonly height: number;
+    readonly pixels: Uint8Array;
+}
+/**
+ * One placed sprite inside the packed atlas. `(x, y)` is the top-left
+ * corner in pixel coordinates; `(w, h)` mirrors the source dimensions.
+ */
+export interface AtlasRegion {
+    readonly name: string;
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+export interface ShelfPackResult {
+    readonly atlasWidth: number;
+    readonly atlasHeight: number;
+    readonly regions: ReadonlyArray<AtlasRegion>;
+}
+/**
+ * Detail shape used by both `atlas-empty-input` and `atlas-size-exceeded`
+ * branches. Fields are optional because the two codes carry different
+ * subsets; the caller projects each branch onto the matching
+ * `ImageErrorDetail` variant before emitting the structured error.
+ */
+export interface ShelfPackError {
+    readonly code: Extract<ImageErrorCode, 'atlas-empty-input' | 'atlas-size-exceeded'>;
+    readonly detail: {
+        readonly name?: string;
+        readonly width?: number;
+        readonly height?: number;
+        readonly maxAtlasSize?: number;
+        readonly receivedCount?: number;
+    };
+}
+export type ShelfPackOutcome = {
+    readonly ok: true;
+    readonly value: ShelfPackResult;
+} | {
+    readonly ok: false;
+    readonly error: ShelfPackError;
+};
+export declare function shelfPack(images: ReadonlyArray<AtlasImageInput>, opts: {
+    readonly maxAtlasSize: number;
+}): ShelfPackOutcome;
+//# sourceMappingURL=shelf-pack.d.ts.map

package/dist/atlas/shelf-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shelf-pack.d.ts","sourceRoot":"","sources":["../../src/atlas/shelf-pack.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,mBAAmB,GAAG,qBAAqB,CAAC,CAAC;IACpF,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAS3D,wBAAgB,SAAS,CACvB,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,IAAI,EAAE;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACtC,gBAAgB,CAiFlB"}

package/dist/bridge.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/bridge.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=bridge.mjs.map
+//# sourceMappingURL=bridge.mjs.map

package/dist/bridge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"bridge.mjs"}

package/dist/builtin.d.ts

@@ -0,0 +1,24 @@
+import type { AssetGuid } from './guid.js';
+export declare const FORGEAX_NAMESPACE: AssetGuid;
+/**
+ * Derive a stable UUIDv5 AssetGuid from a name within the ForgeaX namespace.
+ * Uses SHA-1 via Node.js `node:crypto` or Web Crypto API (RFC 4122 §4.3).
+ * Deterministic: same name always produces the same bytes.
+ */
+export declare function deriveBuiltin(name: string): Promise<AssetGuid>;
+/**
+ * Pre-computed compile-time constant for the HANDLE_CUBE builtin GUID.
+ * Derived from: deriveBuiltin('HANDLE_CUBE') under FORGEAX_NAMESPACE.
+ */
+export declare const BUILTIN_HANDLE_CUBE: string;
+/**
+ * Pre-computed compile-time constant for the HANDLE_TRIANGLE builtin GUID.
+ * Derived from: deriveBuiltin('HANDLE_TRIANGLE') under FORGEAX_NAMESPACE.
+ */
+export declare const BUILTIN_HANDLE_TRIANGLE: string;
+/**
+ * Pre-computed compile-time constant for the HANDLE_QUAD builtin GUID.
+ * Derived from: deriveBuiltin('HANDLE_QUAD') under FORGEAX_NAMESPACE.
+ */
+export declare const BUILTIN_HANDLE_QUAD: string;
+//# sourceMappingURL=builtin.d.ts.map

package/dist/builtin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../src/builtin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAU3C,eAAO,MAAM,iBAAiB,EAAE,SAA2B,CAAC;AAE5D;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAmCpE;AAUD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAkC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAsC,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAkC,CAAC"}

package/dist/cli-asset.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+export interface PackEntry {
+    readonly guid: string;
+    readonly kind: string;
+    readonly sourcePath: string;
+    readonly name?: string;
+}
+interface AssetCtx {
+    readonly stdoutWrite: (line: string) => void;
+    readonly stderrWrite: (line: string) => void;
+    /** Optional cwd override (defaults to `process.cwd()`); enables hermetic tests. */
+    readonly cwd?: string;
+}
+export declare function scanEntries(roots: readonly string[], ctx: AssetCtx): Promise<{
+    ok: true;
+    value: PackEntry[];
+} | {
+    ok: false;
+}>;
+export declare function runCliAsset(rest: string[], ctx: AssetCtx): Promise<number>;
+export {};
+//# sourceMappingURL=cli-asset.d.ts.map

package/dist/cli-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-asset.d.ts","sourceRoot":"","sources":["../src/cli-asset.ts"],"names":[],"mappings":";AAgCA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,QAAQ;IAChB,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,mFAAmF;IACnF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAoBD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC,CAqG3D;AA2BD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAiChF"}