lpc-forge 1.0.0

package/dist/tileset/registry.js

@@ -0,0 +1,71 @@
+import { mkdir, writeFile, readFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { TileType } from '../map/types.js';
+import { createColorTile } from '../utils/image.js';
+const DEFAULT_TILE_SIZE = 32;
+/** Tile color definitions for procedural generation */
+const TILE_COLORS = {
+    floor: { r: 180, g: 150, b: 110, border: { r: 160, g: 130, b: 90 } },
+    wall: { r: 80, g: 80, b: 90, border: { r: 60, g: 60, b: 70 } },
+    wall_top: { r: 100, g: 100, b: 110, border: { r: 70, g: 70, b: 80 } },
+    door: { r: 140, g: 100, b: 60, border: { r: 100, g: 70, b: 40 } },
+    corridor: { r: 160, g: 135, b: 100, border: { r: 140, g: 115, b: 80 } },
+    water: { r: 60, g: 120, b: 190, border: { r: 40, g: 100, b: 170 } },
+    grass: { r: 80, g: 160, b: 60, border: { r: 60, g: 140, b: 40 } },
+    tree: { r: 30, g: 100, b: 30, border: { r: 20, g: 80, b: 20 } },
+    path: { r: 190, g: 170, b: 130, border: { r: 170, g: 150, b: 110 } },
+    sand: { r: 220, g: 200, b: 140, border: { r: 200, g: 180, b: 120 } },
+    stone: { r: 140, g: 140, b: 150, border: { r: 120, g: 120, b: 130 } },
+    bridge: { r: 150, g: 110, b: 70, border: { r: 130, g: 90, b: 50 } },
+    void: { r: 0, g: 0, b: 0 },
+};
+/** Generate default placeholder tiles programmatically */
+export async function generateDefaultTileset(outputDir) {
+    await mkdir(outputDir, { recursive: true });
+    const manifest = {
+        name: 'default',
+        tileSize: DEFAULT_TILE_SIZE,
+        tiles: {},
+    };
+    for (const [name, color] of Object.entries(TILE_COLORS)) {
+        const fileName = `${name}.png`;
+        const filePath = join(outputDir, fileName);
+        const buffer = await createColorTile(DEFAULT_TILE_SIZE, color.r, color.g, color.b, name === 'void' ? 0 : 255, color.border);
+        await writeFile(filePath, buffer);
+        manifest.tiles[name.toUpperCase()] = fileName;
+    }
+    await writeFile(join(outputDir, 'tileset.json'), JSON.stringify(manifest, null, 2));
+    return manifest;
+}
+/** Load a tileset manifest from a directory */
+export async function loadTileset(tilesetDir) {
+    const manifestPath = join(tilesetDir, 'tileset.json');
+    try {
+        await access(manifestPath);
+    }
+    catch {
+        // Generate default tileset if it doesn't exist
+        return generateDefaultTileset(tilesetDir);
+    }
+    const content = await readFile(manifestPath, 'utf-8');
+    return JSON.parse(content);
+}
+/** Map TileType enum to tile name */
+export function tileTypeToName(t) {
+    const mapping = {
+        [TileType.VOID]: 'VOID',
+        [TileType.FLOOR]: 'FLOOR',
+        [TileType.WALL]: 'WALL',
+        [TileType.DOOR]: 'DOOR',
+        [TileType.CORRIDOR]: 'CORRIDOR',
+        [TileType.WATER]: 'WATER',
+        [TileType.GRASS]: 'GRASS',
+        [TileType.TREE]: 'TREE',
+        [TileType.PATH]: 'PATH',
+        [TileType.SAND]: 'SAND',
+        [TileType.STONE]: 'STONE',
+        [TileType.BRIDGE]: 'BRIDGE',
+    };
+    return mapping[t] ?? 'VOID';
+}
+//# sourceMappingURL=registry.js.map

package/dist/tileset/registry.js.map

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

package/dist/tileset/terrain.d.ts

@@ -0,0 +1,3 @@
+import type { GeneratedMap } from '../map/types.js';
+/** Render a GeneratedMap into a visual PNG */
+export declare function renderMap(map: GeneratedMap, tilesetDir: string, outputPath: string): Promise<void>;

package/dist/tileset/terrain.js

@@ -0,0 +1,110 @@
+import sharp from 'sharp';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { loadTileset, tileTypeToName } from './registry.js';
+/** Render a GeneratedMap into a visual PNG */
+export async function renderMap(map, tilesetDir, outputPath) {
+    const manifest = await loadTileset(tilesetDir);
+    const tileSize = manifest.tileSize;
+    const canvasWidth = map.width * tileSize;
+    const canvasHeight = map.height * tileSize;
+    // Pre-load all tile images
+    const tileBuffers = {};
+    for (const [name, fileName] of Object.entries(manifest.tiles)) {
+        try {
+            const buf = await readFile(join(tilesetDir, fileName));
+            tileBuffers[name] = buf;
+        }
+        catch {
+            // Skip missing tiles
+        }
+    }
+    // Build composites for each tile
+    const composites = [];
+    for (let y = 0; y < map.height; y++) {
+        for (let x = 0; x < map.width; x++) {
+            const tileType = map.tiles[y][x];
+            const tileName = tileTypeToName(tileType);
+            const buf = tileBuffers[tileName];
+            if (buf) {
+                composites.push({
+                    input: buf,
+                    top: y * tileSize,
+                    left: x * tileSize,
+                });
+            }
+        }
+    }
+    // Sharp has a practical limit on composites, batch if needed
+    await mkdir(join(outputPath, '..'), { recursive: true });
+    // If map is large, render in row strips
+    if (composites.length > 5000) {
+        await renderInStrips(map, tileBuffers, tileSize, canvasWidth, canvasHeight, outputPath);
+        return;
+    }
+    const result = await sharp({
+        create: {
+            width: canvasWidth,
+            height: canvasHeight,
+            channels: 4,
+            background: { r: 0, g: 0, b: 0, alpha: 0 },
+        },
+    })
+        .png()
+        .composite(composites)
+        .toBuffer();
+    await writeFile(outputPath, result);
+}
+async function renderInStrips(map, tileBuffers, tileSize, canvasWidth, canvasHeight, outputPath) {
+    const stripHeight = 10; // rows per strip
+    const strips = [];
+    for (let startRow = 0; startRow < map.height; startRow += stripHeight) {
+        const endRow = Math.min(startRow + stripHeight, map.height);
+        const stripPixelH = (endRow - startRow) * tileSize;
+        const composites = [];
+        for (let y = startRow; y < endRow; y++) {
+            for (let x = 0; x < map.width; x++) {
+                const tileName = tileTypeToName(map.tiles[y][x]);
+                const buf = tileBuffers[tileName];
+                if (buf) {
+                    composites.push({
+                        input: buf,
+                        top: (y - startRow) * tileSize,
+                        left: x * tileSize,
+                    });
+                }
+            }
+        }
+        const stripBuf = await sharp({
+            create: {
+                width: canvasWidth,
+                height: stripPixelH,
+                channels: 4,
+                background: { r: 0, g: 0, b: 0, alpha: 0 },
+            },
+        })
+            .png()
+            .composite(composites)
+            .toBuffer();
+        strips.push(stripBuf);
+    }
+    // Stitch strips vertically
+    const stitchComposites = strips.map((buf, i) => ({
+        input: buf,
+        top: i * stripHeight * tileSize,
+        left: 0,
+    }));
+    const final = await sharp({
+        create: {
+            width: canvasWidth,
+            height: canvasHeight,
+            channels: 4,
+            background: { r: 0, g: 0, b: 0, alpha: 0 },
+        },
+    })
+        .png()
+        .composite(stitchComposites)
+        .toBuffer();
+    await writeFile(outputPath, final);
+}
+//# sourceMappingURL=terrain.js.map

package/dist/tileset/terrain.js.map

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

package/dist/utils/credits.d.ts

@@ -0,0 +1,11 @@
+export interface CreditEntry {
+    file: string;
+    authors: string[];
+    licenses: string[];
+    urls: string[];
+    notes?: string;
+}
+/** Parse CREDITS.csv and return structured credit entries */
+export declare function parseCredits(repoRoot: string): Promise<CreditEntry[]>;
+/** Generate a credits text file for used layers */
+export declare function generateCreditsText(credits: CreditEntry[], usedPaths: string[]): string;

package/dist/utils/credits.js

@@ -0,0 +1,74 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** Parse CREDITS.csv and return structured credit entries */
+export async function parseCredits(repoRoot) {
+    const csvPath = join(repoRoot, 'CREDITS.csv');
+    const content = await readFile(csvPath, 'utf-8');
+    const lines = content.split('\n');
+    if (lines.length < 2)
+        return [];
+    const entries = [];
+    // Skip header row
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        const cols = parseCSVLine(line);
+        if (cols.length < 4)
+            continue;
+        entries.push({
+            file: cols[0],
+            authors: cols[1] ? cols[1].split(',').map((a) => a.trim()) : [],
+            licenses: cols[2] ? cols[2].split(',').map((l) => l.trim()) : [],
+            urls: cols[3] ? cols[3].split(',').map((u) => u.trim()) : [],
+            notes: cols[4] || undefined,
+        });
+    }
+    return entries;
+}
+function parseCSVLine(line) {
+    const result = [];
+    let current = '';
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i++) {
+        const ch = line[i];
+        if (ch === '"') {
+            if (inQuotes && line[i + 1] === '"') {
+                current += '"';
+                i++;
+            }
+            else {
+                inQuotes = !inQuotes;
+            }
+        }
+        else if (ch === ',' && !inQuotes) {
+            result.push(current.trim());
+            current = '';
+        }
+        else {
+            current += ch;
+        }
+    }
+    result.push(current.trim());
+    return result;
+}
+/** Generate a credits text file for used layers */
+export function generateCreditsText(credits, usedPaths) {
+    const relevant = credits.filter((c) => usedPaths.some((p) => p.includes(c.file) || c.file.includes(p)));
+    if (relevant.length === 0) {
+        return 'Credits: Based on Liberated Pixel Cup (LPC) assets. See CREDITS.csv for full attribution.\n';
+    }
+    const lines = ['=== Asset Credits ===', ''];
+    for (const entry of relevant) {
+        lines.push(`File: ${entry.file}`);
+        lines.push(`Authors: ${entry.authors.join(', ')}`);
+        lines.push(`Licenses: ${entry.licenses.join(', ')}`);
+        if (entry.urls.length > 0) {
+            lines.push(`URLs: ${entry.urls.join(', ')}`);
+        }
+        lines.push('');
+    }
+    lines.push('Full credits available in CREDITS.csv');
+    return lines.join('\n');
+}
+//# sourceMappingURL=credits.js.map

package/dist/utils/credits.js.map

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

package/dist/utils/image.d.ts

@@ -0,0 +1,17 @@
+/** Create a transparent RGBA canvas of the given size */
+export declare function createCanvas(width: number, height: number): Promise<Buffer>;
+/** Composite multiple image buffers onto a base, all at full size */
+export declare function compositeLayers(width: number, height: number, layers: Buffer[]): Promise<Buffer>;
+/** Stitch multiple images vertically into one tall image */
+export declare function stitchVertical(images: {
+    buffer: Buffer;
+    yOffset: number;
+}[], totalWidth: number, totalHeight: number): Promise<Buffer>;
+/** Extract a rectangular region from an image buffer */
+export declare function extractRegion(buffer: Buffer, left: number, top: number, width: number, height: number): Promise<Buffer>;
+/** Create a solid-color tile with optional border */
+export declare function createColorTile(size: number, r: number, g: number, b: number, alpha?: number, borderColor?: {
+    r: number;
+    g: number;
+    b: number;
+}): Promise<Buffer>;

package/dist/utils/image.js

@@ -0,0 +1,94 @@
+import sharp from 'sharp';
+/** Create a transparent RGBA canvas of the given size */
+export async function createCanvas(width, height) {
+    return sharp({
+        create: {
+            width,
+            height,
+            channels: 4,
+            background: { r: 0, g: 0, b: 0, alpha: 0 },
+        },
+    })
+        .png()
+        .toBuffer();
+}
+/** Composite multiple image buffers onto a base, all at full size */
+export async function compositeLayers(width, height, layers) {
+    if (layers.length === 0) {
+        return createCanvas(width, height);
+    }
+    const composites = layers.map((input) => ({
+        input,
+        top: 0,
+        left: 0,
+        blend: 'over',
+    }));
+    return sharp({
+        create: {
+            width,
+            height,
+            channels: 4,
+            background: { r: 0, g: 0, b: 0, alpha: 0 },
+        },
+    })
+        .png()
+        .composite(composites)
+        .toBuffer();
+}
+/** Stitch multiple images vertically into one tall image */
+export async function stitchVertical(images, totalWidth, totalHeight) {
+    const composites = images.map(({ buffer, yOffset }) => ({
+        input: buffer,
+        top: yOffset,
+        left: 0,
+        blend: 'over',
+    }));
+    return sharp({
+        create: {
+            width: totalWidth,
+            height: totalHeight,
+            channels: 4,
+            background: { r: 0, g: 0, b: 0, alpha: 0 },
+        },
+    })
+        .png()
+        .composite(composites)
+        .toBuffer();
+}
+/** Extract a rectangular region from an image buffer */
+export async function extractRegion(buffer, left, top, width, height) {
+    return sharp(buffer).extract({ left, top, width, height }).png().toBuffer();
+}
+/** Create a solid-color tile with optional border */
+export async function createColorTile(size, r, g, b, alpha = 255, borderColor) {
+    // Create the fill
+    const base = await sharp({
+        create: {
+            width: size,
+            height: size,
+            channels: 4,
+            background: { r, g, b, alpha },
+        },
+    })
+        .png()
+        .toBuffer();
+    if (!borderColor)
+        return base;
+    // Overlay a 1px border by creating border lines
+    const hLine = await sharp({
+        create: { width: size, height: 1, channels: 4, background: { ...borderColor, alpha: 255 } },
+    }).png().toBuffer();
+    const vLine = await sharp({
+        create: { width: 1, height: size, channels: 4, background: { ...borderColor, alpha: 255 } },
+    }).png().toBuffer();
+    return sharp(base)
+        .composite([
+        { input: hLine, top: 0, left: 0 },
+        { input: hLine, top: size - 1, left: 0 },
+        { input: vLine, top: 0, left: 0 },
+        { input: vLine, top: 0, left: size - 1 },
+    ])
+        .png()
+        .toBuffer();
+}
+//# sourceMappingURL=image.js.map

package/dist/utils/image.js.map

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

package/dist/utils/rng.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Seeded pseudo-random number generator using mulberry32.
+ */
+export declare class SeededRNG {
+    private state;
+    constructor(seed: string | number);
+    private hashString;
+    /** Returns a float in [0, 1) */
+    random(): number;
+    /** Returns an integer in [min, max] (inclusive) */
+    randomInt(min: number, max: number): number;
+    /** Returns a float in [min, max) */
+    randomFloat(min: number, max: number): number;
+    /** Fisher-Yates shuffle (in-place) */
+    shuffle<T>(array: T[]): T[];
+    /** Pick a random element from an array */
+    pick<T>(array: readonly T[]): T;
+}

package/dist/utils/rng.js

@@ -0,0 +1,48 @@
+/**
+ * Seeded pseudo-random number generator using mulberry32.
+ */
+export class SeededRNG {
+    state;
+    constructor(seed) {
+        this.state = typeof seed === 'string' ? this.hashString(seed) : seed;
+        if (this.state === 0)
+            this.state = 1;
+    }
+    hashString(s) {
+        let hash = 0;
+        for (let i = 0; i < s.length; i++) {
+            const ch = s.charCodeAt(i);
+            hash = ((hash << 5) - hash + ch) | 0;
+        }
+        return Math.abs(hash) || 1;
+    }
+    /** Returns a float in [0, 1) */
+    random() {
+        this.state |= 0;
+        this.state = (this.state + 0x6d2b79f5) | 0;
+        let t = Math.imul(this.state ^ (this.state >>> 15), 1 | this.state);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    }
+    /** Returns an integer in [min, max] (inclusive) */
+    randomInt(min, max) {
+        return Math.floor(this.random() * (max - min + 1)) + min;
+    }
+    /** Returns a float in [min, max) */
+    randomFloat(min, max) {
+        return this.random() * (max - min) + min;
+    }
+    /** Fisher-Yates shuffle (in-place) */
+    shuffle(array) {
+        for (let i = array.length - 1; i > 0; i--) {
+            const j = this.randomInt(0, i);
+            [array[i], array[j]] = [array[j], array[i]];
+        }
+        return array;
+    }
+    /** Pick a random element from an array */
+    pick(array) {
+        return array[this.randomInt(0, array.length - 1)];
+    }
+}
+//# sourceMappingURL=rng.js.map

package/dist/utils/rng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng.js","sourceRoot":"","sources":["../../src/utils/rng.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,SAAS;IACZ,KAAK,CAAS;IAEtB,YAAY,IAAqB;QAC/B,IAAI,CAAC,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrE,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACvC,CAAC;IAEO,UAAU,CAAC,CAAS;QAC1B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,gCAAgC;IAChC,MAAM;QACJ,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC/C,CAAC;IAED,mDAAmD;IACnD,SAAS,CAAC,GAAW,EAAE,GAAW;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IAC3D,CAAC;IAED,oCAAoC;IACpC,WAAW,CAAC,GAAW,EAAE,GAAW;QAClC,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3C,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAI,KAAU;QACnB,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/B,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAI,KAAmB;QACzB,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;CACF"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "lpc-forge",
+  "version": "1.0.0",
+  "description": "Complete 2D RPG asset pipeline — character compositor, procedural map generator, and Godot 4.6 exporter. Built on Liberated Pixel Cup sprites.",
+  "type": "module",
+  "bin": {
+    "lpc-forge": "./dist/cli.js"
+  },
+  "files": [
+    "dist/cli.js",
+    "dist/cli.d.ts",
+    "dist/character/**",
+    "dist/map/**",
+    "dist/export/**",
+    "dist/tileset/**",
+    "dist/utils/**",
+    "dist/license.js",
+    "dist/license.d.ts",
+    "assets/**",
+    "README.md",
+    "LICENSE",
+    "CREDITS.csv",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "lint": "eslint src/"
+  },
+  "keywords": [
+    "lpc",
+    "liberated-pixel-cup",
+    "spritesheet",
+    "character-generator",
+    "godot",
+    "godot-4",
+    "gamedev",
+    "pixel-art",
+    "rpg",
+    "2d",
+    "procedural-generation",
+    "dungeon-generator",
+    "tilemap",
+    "indie-game",
+    "game-assets",
+    "sprite-compositor"
+  ],
+  "author": "LaunchDay Studio <info@launchdaystudio.com> (https://blueth.online)",
+  "license": "GPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LaunchDay-Studio-Inc/lpc-forge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/LaunchDay-Studio-Inc/lpc-forge/issues"
+  },
+  "homepage": "https://blueth.online",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "chalk": "^5.4.0",
+    "commander": "^13.0.0",
+    "glob": "^11.0.0",
+    "jsfxr": "^1.4.0",
+    "ora": "^8.2.0",
+    "sharp": "^0.34.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  }
+}