@ludic-labs/assembly 0.0.0-stage → 0.4.0

package/dist/sprite-decompile.d.ts

@@ -0,0 +1,68 @@
+import type { SpriteDocument, SpriteDiagnostic, SpritePoint, SpriteBox } from "./sprite-types.js";
+export interface SpriteFrame {
+    width: number;
+    height: number;
+    rgba: Uint8Array;
+}
+export interface DecompileSpriteOptions {
+    id?: string;
+    animation?: string | null;
+    ms?: number;
+}
+export interface SpriteSummary {
+    size: SpritePoint;
+    frames: number;
+    outline: string | null;
+    ramps: {
+        name: string;
+        steps: {
+            colour: string;
+            pixels: number;
+        }[];
+    }[];
+    parts: {
+        part: string;
+        ramp: string | null;
+        bbox: SpriteBox;
+        pixels: number;
+        shape: string;
+        fill: string | null;
+        bevel: {
+            dir: string;
+            light: string | null;
+            shadow: string | null;
+        } | null;
+        residualPixels: number;
+    }[];
+    frameChanges: {
+        frame: number;
+        shift: SpritePoint;
+        changedPixels: number;
+        partsChanged: string[];
+    }[];
+    normalisedTransparent: number;
+    fallback: string | null;
+    outlineStats?: {
+        pixels: number;
+        operation: boolean;
+        added: number;
+        removed: number;
+    } | null;
+    symmetry?: {
+        axis: number | null;
+        share: number;
+    };
+}
+export interface DecompiledSprite {
+    doc: SpriteDocument;
+    summary: SpriteSummary;
+    verified: boolean;
+    diagnostics: SpriteDiagnostic[];
+}
+/**
+ * Decompiles frames of equal size. Returns { doc, summary, verified }. The
+ * document reproduces every frame exactly; `verified` is the compile check.
+ */
+export declare function decompileSprite(input: readonly SpriteFrame[], { id, animation, ms }?: DecompileSpriteOptions): DecompiledSprite;
+/** Markdown description of a decompiled sprite for a model to read. */
+export declare function describeSprite(summary: SpriteSummary, doc: SpriteDocument): string;