@bcts/lifehash-cli 1.0.0-alpha.17

package/dist/index.d.cts

@@ -0,0 +1,191 @@
+import { Image, Image as Image$1, Version, Version as Version$1, makeFromUtf8 } from "@bcts/lifehash";
+
+//#region src/png-writer.d.ts
+/**
+ * Writes a LifeHash image to a PNG file.
+ *
+ * Port of `write_image()` from lifehash.cpp lines 174-186 and
+ * PNGWriter class from png-writer.hpp.
+ *
+ * @param image - The LifeHash image to write
+ * @param filename - The output filename
+ * @category PNG Encoding
+ *
+ * @example
+ * ```typescript
+ * import { makeFromUtf8 } from "@bcts/lifehash";
+ *
+ * const image = makeFromUtf8("Hello");
+ * writeImage(image, "Hello.png");
+ * ```
+ */
+declare function writeImage(image: Image$1, filename: string): void;
+/**
+ * Generates a PNG buffer from a LifeHash image without writing to disk.
+ *
+ * @param image - The LifeHash image to encode
+ * @returns A Buffer containing the PNG data
+ * @category PNG Encoding
+ *
+ * @example
+ * ```typescript
+ * import { makeFromUtf8 } from "@bcts/lifehash";
+ *
+ * const image = makeFromUtf8("Hello");
+ * const pngBuffer = generatePNG(image);
+ * ```
+ */
+declare function generatePNG(image: Image$1): Buffer;
+//#endregion
+//#region src/main.d.ts
+/**
+ * CLI options interface.
+ *
+ * Port of Parameters struct from lifehash.cpp lines 86-91.
+ *
+ * @category CLI
+ */
+interface CliOptions {
+  /** LifeHash version to generate */
+  version: string;
+  /** Size of each module ("pixel") */
+  module: string;
+  /** Output directory path */
+  path: string;
+}
+/**
+ * Parses a version string to the Version enum.
+ *
+ * Port of version parsing logic from lifehash.cpp lines 130-145.
+ *
+ * @param versionString - The version string from CLI
+ * @returns The corresponding Version enum value
+ * @throws Error if the version string is invalid
+ * @category CLI
+ *
+ * @example
+ * ```typescript
+ * parseVersion("version2") // => Version.version2
+ * parseVersion("detailed") // => Version.detailed
+ * parseVersion("invalid") // throws Error
+ * ```
+ */
+declare function parseVersion(versionString: string): Version$1;
+/**
+ * Main execution function that generates a LifeHash image.
+ *
+ * Port of `run()` from lifehash.cpp lines 188-192.
+ *
+ * @param input - Input string to hash (or empty for random)
+ * @param options - CLI options
+ * @category CLI
+ *
+ * @example
+ * ```typescript
+ * run("Hello", { version: "version2", module: "1", path: "." });
+ * // Generates Hello.png in current directory
+ * ```
+ */
+declare function run(input: string, options: CliOptions): void;
+//#endregion
+//#region src/utils.d.ts
+/**
+ * Utility functions for the LifeHash CLI.
+ *
+ * Ported from bc-lifehash-cli C++ implementation.
+ *
+ * @module
+ */
+/**
+ * Appends a path component to a path, handling trailing slashes correctly.
+ *
+ * Port of `appending_path_component()` from lifehash.cpp lines 18-24.
+ *
+ * @param path - The base path
+ * @param component - The component to append
+ * @returns The combined path
+ * @category Utilities
+ *
+ * @example
+ * ```typescript
+ * appendingPathComponent("", "file.png") // => "file.png"
+ * appendingPathComponent("/tmp/", "file.png") // => "/tmp/file.png"
+ * appendingPathComponent("/tmp", "file.png") // => "/tmp/file.png"
+ * ```
+ */
+declare function appendingPathComponent(path: string, component: string): string;
+/**
+ * Selects a random element from an array.
+ *
+ * Port of `random_element()` template from lifehash.cpp lines 38-50.
+ *
+ * @param array - The array to select from
+ * @returns A random element from the array
+ * @category Utilities
+ *
+ * @example
+ * ```typescript
+ * randomElement(["A", "B", "C"]) // => "A" or "B" or "C"
+ * ```
+ */
+declare function randomElement<T>(array: T[]): T;
+/**
+ * Generates a random input string in "XXX-XXX" format where X is a random uppercase letter.
+ *
+ * Port of `make_random_input()` from lifehash.cpp lines 52-57.
+ *
+ * @returns A random string in "XXX-XXX" format
+ * @category Utilities
+ *
+ * @example
+ * ```typescript
+ * makeRandomInput() // => "ABC-DEF" (random letters)
+ * ```
+ */
+declare function makeRandomInput(): string;
+//#endregion
+//#region src/index.d.ts
+/**
+ * Options for generating a LifeHash image.
+ *
+ * @category Image Generation
+ */
+interface GenerateOptions {
+  /**
+   * LifeHash version to generate.
+   * @default "version2"
+   */
+  version?: "version1" | "version2" | "detailed" | "fiducial" | "grayscaleFiducial";
+  /**
+   * Size of each module ("pixel").
+   * @default 1
+   */
+  moduleSize?: number;
+}
+/**
+ * Generates a LifeHash PNG buffer from an input string.
+ *
+ * This is the main programmatic API for generating LifeHash images.
+ *
+ * @param input - The input string to hash
+ * @param options - Generation options
+ * @returns A Buffer containing the PNG data
+ * @category Image Generation
+ *
+ * @example
+ * ```typescript
+ * import { generateLifeHash } from "@bcts/lifehash-cli";
+ * import { writeFileSync } from "fs";
+ *
+ * const pngBuffer = generateLifeHash("Hello", {
+ *   version: "version2",
+ *   moduleSize: 1,
+ * });
+ *
+ * writeFileSync("Hello.png", pngBuffer);
+ * ```
+ */
+declare function generateLifeHash(input: string, options?: GenerateOptions): Buffer;
+//#endregion
+export { type CliOptions, GenerateOptions, type Image, Version, appendingPathComponent, generateLifeHash, generatePNG, makeFromUtf8, makeRandomInput, parseVersion, randomElement, run, writeImage };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/png-writer.ts","../src/main.ts","../src/utils.ts","../src/index.ts"],"mappings":";;;;;;AA4EA;;;;;;;;;;;;ACxDA;;;iBDWgB,UAAA,CAAW,KAAA,EAAO,OAAA,EAAO,QAAA;;;;;;ACezC;;;;;AAgCA;;;;;iBDFgB,WAAA,CAAY,KAAA,EAAO,OAAA,GAAQ,MAAA;;;;;;;AAA3C;;;UCxDiB,UAAA;EDwDkB;ECtDjC,OAAA;EDsDyC;ECpDzC,MAAA;EDoD+C;EClD/C,IAAA;AAAA;;AANF;;;;;;;;;AA0BA;;;;;AAgCA;;iBAhCgB,YAAA,CAAa,aAAA,WAAwB,SAAA;;;;;;;;;;ACrBrD;;;;;AAwBA;iBD6BgB,GAAA,CAAI,KAAA,UAAe,OAAA,EAAS,UAAA;;;;;;AD/C5C;;;;;;;;;AA6CA;;;;;;;;;;;;iBEnDgB,sBAAA,CAAuB,IAAA,UAAc,SAAA;;;;;;;;;ADqBrD;;;;;AAgCA;iBC7BgB,aAAA,GAAA,CAAiB,KAAA,EAAO,CAAA,KAAM,CAAA;;;;;;;;;;;AAxB9C;;;iBA0CgB,eAAA,CAAA;;;;;;;;UCNC,eAAA;EDpCD;;;;ECyCd,OAAA;EDjBc;;;;ECsBd,UAAA;AAAA;;;;;ADJF;;;;;;;;ACNA;;;;;AAoCA;;;;;;iBAAgB,gBAAA,CAAiB,KAAA,UAAe,OAAA,GAAS,eAAA,GAAuB,MAAA"}

package/dist/index.d.mts

@@ -0,0 +1,191 @@
+import { Image, Image as Image$1, Version, Version as Version$1, makeFromUtf8 } from "@bcts/lifehash";
+
+//#region src/png-writer.d.ts
+/**
+ * Writes a LifeHash image to a PNG file.
+ *
+ * Port of `write_image()` from lifehash.cpp lines 174-186 and
+ * PNGWriter class from png-writer.hpp.
+ *
+ * @param image - The LifeHash image to write
+ * @param filename - The output filename
+ * @category PNG Encoding
+ *
+ * @example
+ * ```typescript
+ * import { makeFromUtf8 } from "@bcts/lifehash";
+ *
+ * const image = makeFromUtf8("Hello");
+ * writeImage(image, "Hello.png");
+ * ```
+ */
+declare function writeImage(image: Image$1, filename: string): void;
+/**
+ * Generates a PNG buffer from a LifeHash image without writing to disk.
+ *
+ * @param image - The LifeHash image to encode
+ * @returns A Buffer containing the PNG data
+ * @category PNG Encoding
+ *
+ * @example
+ * ```typescript
+ * import { makeFromUtf8 } from "@bcts/lifehash";
+ *
+ * const image = makeFromUtf8("Hello");
+ * const pngBuffer = generatePNG(image);
+ * ```
+ */
+declare function generatePNG(image: Image$1): Buffer;
+//#endregion
+//#region src/main.d.ts
+/**
+ * CLI options interface.
+ *
+ * Port of Parameters struct from lifehash.cpp lines 86-91.
+ *
+ * @category CLI
+ */
+interface CliOptions {
+  /** LifeHash version to generate */
+  version: string;
+  /** Size of each module ("pixel") */
+  module: string;
+  /** Output directory path */
+  path: string;
+}
+/**
+ * Parses a version string to the Version enum.
+ *
+ * Port of version parsing logic from lifehash.cpp lines 130-145.
+ *
+ * @param versionString - The version string from CLI
+ * @returns The corresponding Version enum value
+ * @throws Error if the version string is invalid
+ * @category CLI
+ *
+ * @example
+ * ```typescript
+ * parseVersion("version2") // => Version.version2
+ * parseVersion("detailed") // => Version.detailed
+ * parseVersion("invalid") // throws Error
+ * ```
+ */
+declare function parseVersion(versionString: string): Version$1;
+/**
+ * Main execution function that generates a LifeHash image.
+ *
+ * Port of `run()` from lifehash.cpp lines 188-192.
+ *
+ * @param input - Input string to hash (or empty for random)
+ * @param options - CLI options
+ * @category CLI
+ *
+ * @example
+ * ```typescript
+ * run("Hello", { version: "version2", module: "1", path: "." });
+ * // Generates Hello.png in current directory
+ * ```
+ */
+declare function run(input: string, options: CliOptions): void;
+//#endregion
+//#region src/utils.d.ts
+/**
+ * Utility functions for the LifeHash CLI.
+ *
+ * Ported from bc-lifehash-cli C++ implementation.
+ *
+ * @module
+ */
+/**
+ * Appends a path component to a path, handling trailing slashes correctly.
+ *
+ * Port of `appending_path_component()` from lifehash.cpp lines 18-24.
+ *
+ * @param path - The base path
+ * @param component - The component to append
+ * @returns The combined path
+ * @category Utilities
+ *
+ * @example
+ * ```typescript
+ * appendingPathComponent("", "file.png") // => "file.png"
+ * appendingPathComponent("/tmp/", "file.png") // => "/tmp/file.png"
+ * appendingPathComponent("/tmp", "file.png") // => "/tmp/file.png"
+ * ```
+ */
+declare function appendingPathComponent(path: string, component: string): string;
+/**
+ * Selects a random element from an array.
+ *
+ * Port of `random_element()` template from lifehash.cpp lines 38-50.
+ *
+ * @param array - The array to select from
+ * @returns A random element from the array
+ * @category Utilities
+ *
+ * @example
+ * ```typescript
+ * randomElement(["A", "B", "C"]) // => "A" or "B" or "C"
+ * ```
+ */
+declare function randomElement<T>(array: T[]): T;
+/**
+ * Generates a random input string in "XXX-XXX" format where X is a random uppercase letter.
+ *
+ * Port of `make_random_input()` from lifehash.cpp lines 52-57.
+ *
+ * @returns A random string in "XXX-XXX" format
+ * @category Utilities
+ *
+ * @example
+ * ```typescript
+ * makeRandomInput() // => "ABC-DEF" (random letters)
+ * ```
+ */
+declare function makeRandomInput(): string;
+//#endregion
+//#region src/index.d.ts
+/**
+ * Options for generating a LifeHash image.
+ *
+ * @category Image Generation
+ */
+interface GenerateOptions {
+  /**
+   * LifeHash version to generate.
+   * @default "version2"
+   */
+  version?: "version1" | "version2" | "detailed" | "fiducial" | "grayscaleFiducial";
+  /**
+   * Size of each module ("pixel").
+   * @default 1
+   */
+  moduleSize?: number;
+}
+/**
+ * Generates a LifeHash PNG buffer from an input string.
+ *
+ * This is the main programmatic API for generating LifeHash images.
+ *
+ * @param input - The input string to hash
+ * @param options - Generation options
+ * @returns A Buffer containing the PNG data
+ * @category Image Generation
+ *
+ * @example
+ * ```typescript
+ * import { generateLifeHash } from "@bcts/lifehash-cli";
+ * import { writeFileSync } from "fs";
+ *
+ * const pngBuffer = generateLifeHash("Hello", {
+ *   version: "version2",
+ *   moduleSize: 1,
+ * });
+ *
+ * writeFileSync("Hello.png", pngBuffer);
+ * ```
+ */
+declare function generateLifeHash(input: string, options?: GenerateOptions): Buffer;
+//#endregion
+export { type CliOptions, GenerateOptions, type Image, Version, appendingPathComponent, generateLifeHash, generatePNG, makeFromUtf8, makeRandomInput, parseVersion, randomElement, run, writeImage };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/png-writer.ts","../src/main.ts","../src/utils.ts","../src/index.ts"],"mappings":";;;;;;AA4EA;;;;;;;;;;;;ACxDA;;;iBDWgB,UAAA,CAAW,KAAA,EAAO,OAAA,EAAO,QAAA;;;;;;ACezC;;;;;AAgCA;;;;;iBDFgB,WAAA,CAAY,KAAA,EAAO,OAAA,GAAQ,MAAA;;;;;;;AAA3C;;;UCxDiB,UAAA;EDwDkB;ECtDjC,OAAA;EDsDyC;ECpDzC,MAAA;EDoD+C;EClD/C,IAAA;AAAA;;AANF;;;;;;;;;AA0BA;;;;;AAgCA;;iBAhCgB,YAAA,CAAa,aAAA,WAAwB,SAAA;;;;;;;;;;ACrBrD;;;;;AAwBA;iBD6BgB,GAAA,CAAI,KAAA,UAAe,OAAA,EAAS,UAAA;;;;;;AD/C5C;;;;;;;;;AA6CA;;;;;;;;;;;;iBEnDgB,sBAAA,CAAuB,IAAA,UAAc,SAAA;;;;;;;;;ADqBrD;;;;;AAgCA;iBC7BgB,aAAA,GAAA,CAAiB,KAAA,EAAO,CAAA,KAAM,CAAA;;;;;;;;;;;AAxB9C;;;iBA0CgB,eAAA,CAAA;;;;;;;;UCNC,eAAA;EDpCD;;;;ECyCd,OAAA;EDjBc;;;;ECsBd,UAAA;AAAA;;;;;ADJF;;;;;;;;ACNA;;;;;AAoCA;;;;;;iBAAgB,gBAAA,CAAiB,KAAA,UAAe,OAAA,GAAS,eAAA,GAAuB,MAAA"}

package/dist/index.mjs

@@ -0,0 +1,308 @@
+import { writeFileSync } from "fs";
+import { PNG } from "pngjs";
+import { Command } from "commander";
+import { Version, Version as Version$1, makeFromUtf8, makeFromUtf8 as makeFromUtf8$1 } from "@bcts/lifehash";
+
+//#region src/png-writer.ts
+/**
+* PNG writer for LifeHash images.
+*
+* Ported from bc-lifehash-cli C++ implementation (png-writer.hpp).
+* Uses pngjs instead of libpng.
+*
+* @module
+*/
+/**
+* Writes a LifeHash image to a PNG file.
+*
+* Port of `write_image()` from lifehash.cpp lines 174-186 and
+* PNGWriter class from png-writer.hpp.
+*
+* @param image - The LifeHash image to write
+* @param filename - The output filename
+* @category PNG Encoding
+*
+* @example
+* ```typescript
+* import { makeFromUtf8 } from "@bcts/lifehash";
+*
+* const image = makeFromUtf8("Hello");
+* writeImage(image, "Hello.png");
+* ```
+*/
+function writeImage(image, filename) {
+	const png = new PNG({
+		width: image.width,
+		height: image.height,
+		colorType: 2,
+		bitDepth: 8,
+		inputColorType: 2,
+		inputHasAlpha: false
+	});
+	for (let y = 0; y < image.height; y++) for (let x = 0; x < image.width; x++) {
+		const srcOffset = (y * image.width + x) * 3;
+		const dstOffset = (y * image.width + x) * 4;
+		png.data[dstOffset] = image.colors[srcOffset];
+		png.data[dstOffset + 1] = image.colors[srcOffset + 1];
+		png.data[dstOffset + 2] = image.colors[srcOffset + 2];
+		png.data[dstOffset + 3] = 255;
+	}
+	writeFileSync(filename, PNG.sync.write(png));
+}
+/**
+* Generates a PNG buffer from a LifeHash image without writing to disk.
+*
+* @param image - The LifeHash image to encode
+* @returns A Buffer containing the PNG data
+* @category PNG Encoding
+*
+* @example
+* ```typescript
+* import { makeFromUtf8 } from "@bcts/lifehash";
+*
+* const image = makeFromUtf8("Hello");
+* const pngBuffer = generatePNG(image);
+* ```
+*/
+function generatePNG(image) {
+	const png = new PNG({
+		width: image.width,
+		height: image.height,
+		colorType: 2,
+		bitDepth: 8,
+		inputColorType: 2,
+		inputHasAlpha: false
+	});
+	for (let y = 0; y < image.height; y++) for (let x = 0; x < image.width; x++) {
+		const srcOffset = (y * image.width + x) * 3;
+		const dstOffset = (y * image.width + x) * 4;
+		png.data[dstOffset] = image.colors[srcOffset];
+		png.data[dstOffset + 1] = image.colors[srcOffset + 1];
+		png.data[dstOffset + 2] = image.colors[srcOffset + 2];
+		png.data[dstOffset + 3] = 255;
+	}
+	return PNG.sync.write(png);
+}
+
+//#endregion
+//#region src/utils.ts
+/**
+* Utility functions for the LifeHash CLI.
+*
+* Ported from bc-lifehash-cli C++ implementation.
+*
+* @module
+*/
+/**
+* Appends a path component to a path, handling trailing slashes correctly.
+*
+* Port of `appending_path_component()` from lifehash.cpp lines 18-24.
+*
+* @param path - The base path
+* @param component - The component to append
+* @returns The combined path
+* @category Utilities
+*
+* @example
+* ```typescript
+* appendingPathComponent("", "file.png") // => "file.png"
+* appendingPathComponent("/tmp/", "file.png") // => "/tmp/file.png"
+* appendingPathComponent("/tmp", "file.png") // => "/tmp/file.png"
+* ```
+*/
+function appendingPathComponent(path, component) {
+	if (path === "") return component;
+	if (path.endsWith("/")) return `${path}${component}`;
+	return `${path}/${component}`;
+}
+/**
+* Selects a random element from an array.
+*
+* Port of `random_element()` template from lifehash.cpp lines 38-50.
+*
+* @param array - The array to select from
+* @returns A random element from the array
+* @category Utilities
+*
+* @example
+* ```typescript
+* randomElement(["A", "B", "C"]) // => "A" or "B" or "C"
+* ```
+*/
+function randomElement(array) {
+	return array[Math.floor(Math.random() * array.length)];
+}
+/**
+* Generates a random input string in "XXX-XXX" format where X is a random uppercase letter.
+*
+* Port of `make_random_input()` from lifehash.cpp lines 52-57.
+*
+* @returns A random string in "XXX-XXX" format
+* @category Utilities
+*
+* @example
+* ```typescript
+* makeRandomInput() // => "ABC-DEF" (random letters)
+* ```
+*/
+function makeRandomInput() {
+	const letters = "ABCDEFGHIJKLMNOPQRSTUVWXYZ".split("");
+	const letter = () => randomElement(letters);
+	const cluster = () => `${letter()}${letter()}${letter()}`;
+	return `${cluster()}-${cluster()}`;
+}
+
+//#endregion
+//#region src/main.ts
+/**
+* LifeHash CLI - Command line tool for generating LifeHash PNG images.
+*
+* Ported from bc-lifehash-cli C++ implementation (lifehash.cpp).
+*
+* @module
+*/
+/**
+* Parses a version string to the Version enum.
+*
+* Port of version parsing logic from lifehash.cpp lines 130-145.
+*
+* @param versionString - The version string from CLI
+* @returns The corresponding Version enum value
+* @throws Error if the version string is invalid
+* @category CLI
+*
+* @example
+* ```typescript
+* parseVersion("version2") // => Version.version2
+* parseVersion("detailed") // => Version.detailed
+* parseVersion("invalid") // throws Error
+* ```
+*/
+function parseVersion(versionString) {
+	switch (versionString) {
+		case "version1": return Version$1.version1;
+		case "version2": return Version$1.version2;
+		case "detailed": return Version$1.detailed;
+		case "fiducial": return Version$1.fiducial;
+		case "grayscaleFiducial": return Version$1.grayscale_fiducial;
+		default: throw new Error("Invalid version.");
+	}
+}
+/**
+* Main execution function that generates a LifeHash image.
+*
+* Port of `run()` from lifehash.cpp lines 188-192.
+*
+* @param input - Input string to hash (or empty for random)
+* @param options - CLI options
+* @category CLI
+*
+* @example
+* ```typescript
+* run("Hello", { version: "version2", module: "1", path: "." });
+* // Generates Hello.png in current directory
+* ```
+*/
+function run(input, options) {
+	const version = parseVersion(options.version);
+	const moduleSize = parseInt(options.module, 10);
+	if (moduleSize < 1 || isNaN(moduleSize)) throw new Error("Illegal value.");
+	const actualInput = input !== "" ? input : makeRandomInput();
+	const outputFilename = `${actualInput}.png`;
+	const outputFile = appendingPathComponent(options.path, outputFilename);
+	writeImage(makeFromUtf8$1(actualInput, version, moduleSize), outputFile);
+}
+/**
+* CLI entry point.
+*
+* Port of `main()` from lifehash.cpp lines 194-206.
+*
+* @category CLI
+*/
+function main() {
+	const program = new Command();
+	program.name("lifehash").description("Generate LifeHash PNG images from input strings").argument("[input]", "Input string to hash (default: random XXX-XXX)").option("-v, --version <version>", "LifeHash version: version1, version2, detailed, fiducial, grayscaleFiducial", "version2").option("-m, --module <size>", "Size of each module (\"pixel\")", "1").option("-p, --path <path>", "Output directory path", "").action((input, options) => {
+		try {
+			run(input ?? "", options);
+		} catch (error) {
+			if (error instanceof Error) {
+				console.log(`\u{1F928} ${error.message}`);
+				console.log();
+				program.help();
+			}
+			process.exit(1);
+		}
+	});
+	program.parse();
+}
+if (typeof process !== "undefined" && typeof process.argv[1] === "string" && (process.argv[1].endsWith("/main.mjs") || process.argv[1].endsWith("/main.js") || process.argv[1].includes("lifehash-cli"))) main();
+
+//#endregion
+//#region src/index.ts
+/**
+* @bcts/lifehash-cli - Command line tool for generating LifeHash PNG images.
+*
+* This package provides both a CLI tool and a programmatic API for generating
+* LifeHash visual hash images as PNG files.
+*
+* @packageDocumentation
+* @module @bcts/lifehash-cli
+*
+* @example CLI Usage
+* ```bash
+* # Generate a LifeHash from a string
+* lifehash Hello
+*
+* # Generate with specific version and module size
+* lifehash -v detailed -m 8 Hello
+*
+* # Generate with random input
+* lifehash
+* ```
+*
+* @example Programmatic Usage
+* ```typescript
+* import { generateLifeHash } from "@bcts/lifehash-cli";
+* import { writeFileSync } from "fs";
+*
+* // Generate a PNG buffer
+* const pngBuffer = generateLifeHash("Hello", {
+*   version: "version2",
+*   moduleSize: 1,
+* });
+*
+* // Write to file
+* writeFileSync("Hello.png", pngBuffer);
+* ```
+*/
+/**
+* Generates a LifeHash PNG buffer from an input string.
+*
+* This is the main programmatic API for generating LifeHash images.
+*
+* @param input - The input string to hash
+* @param options - Generation options
+* @returns A Buffer containing the PNG data
+* @category Image Generation
+*
+* @example
+* ```typescript
+* import { generateLifeHash } from "@bcts/lifehash-cli";
+* import { writeFileSync } from "fs";
+*
+* const pngBuffer = generateLifeHash("Hello", {
+*   version: "version2",
+*   moduleSize: 1,
+* });
+*
+* writeFileSync("Hello.png", pngBuffer);
+* ```
+*/
+function generateLifeHash(input, options = {}) {
+	const { version = "version2", moduleSize = 1 } = options;
+	return generatePNG(makeFromUtf8(input, parseVersion(version), moduleSize));
+}
+
+//#endregion
+export { Version, appendingPathComponent, generateLifeHash, generatePNG, makeFromUtf8, makeRandomInput, parseVersion, randomElement, run, writeImage };
+//# sourceMappingURL=index.mjs.map