@enslo/sd-parsers-web 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Deepratna Awale (original sd-parsers)
+Copyright (c) 2025 Ernest Croft (browser adaptation)
+
+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/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 d3x-at
+
+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,221 @@
+# SD-Parsers-Web
+
+
+Read structured metadata from images created with stable diffusion - **Browser Edition**.
+
+A TypeScript package for extracting prompt information and generation parameters from AI-generated images in the browser. You need images that are already embedded with generation data to use this library, it does not "predict" anything.
+
+Website & API: https://sd-parsers.vercel.app/
+
+> **Note**: This is a browser-only fork of sd-parsers, designed specifically for use in web applications without Node.js dependencies.
+
+![Example Output](example_output.png)
+
+## Features
+
+Prompts as well as some well-known generation parameters are provided as easily accessible properties.
+
+Supports reading metadata from images generated with:
+* Automatic1111's Stable Diffusion web UI ✅
+* Fooocus ✅
+* ComfyUI ✅
+* InvokeAI ✅
+* NovelAI ✅
+
+## Installation
+
+```bash
+npm install sd-parsers-web
+```
+
+## Usage
+
+### Basic usage:
+
+For a simple query, import `ParserManager` from `sd-parsers-web` and use its `parse()` method to parse an image.
+
+#### Read prompt information from a File object with `parse()`:
+
+```typescript
+import { ParserManager } from 'sd-parsers-web';
+
+const parserManager = new ParserManager();
+
+async function handleFileInput(file: File) {
+  const promptInfo = await parserManager.parse(file);
+  
+  if (promptInfo) {
+    for (const prompt of promptInfo.prompts) {
+      console.log(`Prompt: ${prompt.value}`);
+    }
+  }
+}
+```
+
+#### Read prompt information from an ArrayBuffer:
+
+```typescript
+import { ParserManager } from 'sd-parsers-web';
+
+const parserManager = new ParserManager();
+
+async function handleDrop(event: DragEvent) {
+  const file = event.dataTransfer?.files[0];
+  if (file) {
+    const arrayBuffer = await file.arrayBuffer();
+    const promptInfo = await parserManager.parse(arrayBuffer);
+    
+    if (promptInfo) {
+      console.log(promptInfo);
+    }
+  }
+}
+```
+
+#### Parse a remote image:
+
+```typescript
+import { ParserManager } from 'sd-parsers-web';
+
+const parserManager = new ParserManager();
+
+async function parseRemoteImage(url: string) {
+  const response = await fetch(url);
+  const arrayBuffer = await response.arrayBuffer();
+  const promptInfo = await parserManager.parse(arrayBuffer);
+  
+  if (promptInfo) {
+    console.log(promptInfo);
+  }
+}
+```
+
+### Parsing options:
+
+#### Configure metadata extraction:
+
+```typescript
+import { ParserManager, Eagerness } from 'sd-parsers-web';
+
+const parserManager = new ParserManager({ eagerness: Eagerness.EAGER });
+```
+
+`Eagerness` sets the metadata searching effort:
+
+- **FAST**: cut some corners to save some time
+- **DEFAULT**: try to ensure all metadata is read (default)
+- **EAGER**: include additional methods to try and retrieve metadata (computationally expensive!)
+
+> **Browser Version Note**: Due to browser environment constraints, FAST and EAGER modes have limited functionality. DEFAULT mode (the default setting) is recommended for best results in the browser version.
+
+#### Only use specific parser modules:
+
+```typescript
+import { ParserManager, AUTOMATIC1111Parser } from 'sd-parsers-web';
+
+const parserManager = new ParserManager({
+  managedParsers: [AUTOMATIC1111Parser]
+});
+```
+
+#### Debug mode:
+
+```typescript
+import { ParserManager } from 'sd-parsers-web';
+
+const parserManager = new ParserManager({ debug: true });
+```
+
+### Output
+
+The parser returns a `PromptInfo` object with the following structure:
+
+```typescript
+interface PromptInfo {
+  generator: Generators;
+  samplers: Sampler[];
+  metadata: Record<string, any>;
+  rawParameters: Record<string, any>;
+}
+```
+
+Access parsed data using helper functions:
+
+```typescript
+import { getFullPrompt, getFullNegativePrompt, getModels } from 'sd-parsers-web';
+
+const prompt = getFullPrompt(promptInfo);
+const negativePrompt = getFullNegativePrompt(promptInfo);
+const models = getModels(promptInfo);
+```
+
+## API Reference
+
+### Classes
+
+- `ParserManager`: Main class for parsing images
+- `AUTOMATIC1111Parser`: Parser for AUTOMATIC1111 webui images ✅
+- `FooocusParser`: Parser for Fooocus images ✅
+- `ComfyUIParser`: Parser for ComfyUI images ✅
+- `InvokeAIParser`: Parser for InvokeAI images ✅
+- `NovelAIParser`: Parser for NovelAI images ✅
+
+### Types
+
+- `PromptInfo`: Contains structured image generation parameters
+- `Sampler`: Represents a sampler used during image generation
+- `Model`: Represents a checkpoint model
+- `Prompt`: Represents an image generation prompt
+
+### Enums
+
+- `Generators`: Supported image generators
+- `Eagerness`: Metadata extraction effort levels
+
+## Development
+
+### Building
+
+```bash
+npm run build
+```
+
+### Testing
+
+```bash
+npm test
+```
+
+### Watch mode
+
+```bash
+npm run dev
+```
+
+## Differences from Original sd-parsers
+
+This browser-only fork has the following differences:
+
+1. **Designed for Browsers**: Optimized for browser environments; Node.js compatibility not tested or supported
+2. **Input Types**: Accepts `Blob | ArrayBuffer | Uint8Array` instead of file paths
+3. **No CLI**: Command-line interface removed
+4. **Image Processing**: Uses browser APIs instead of Sharp
+5. **EXIF Parsing**: Uses exifr library for JPEG EXIF data
+6. **Limited Eagerness Modes**: 
+   - FAST mode: PNG IHDR parsing not implemented (returns null)
+   - EAGER mode: Stenographic analysis not available in browsers
+   - DEFAULT mode: Fully functional (recommended)
+
+## Contributing
+
+Contributions are welcome! This is a browser-focused fork of the original sd-parsers library. If you find issues or want to add support for additional image generators, please open an issue or pull request.
+
+## License
+
+MIT License - same as the original version.
+
+## Credits
+
+- Original library: [sd-parsers](https://github.com/d3x-at/sd-parsers) by d3x-at
+- TypeScript port: [sd-parsers](https://github.com/deepratna-awale/sd-parsers) by Deepratna Awale
+- Browser adaptation: Ernest Croft

package/dist/data/generators.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Enumeration of supported image generators
+ */
+export declare enum Generators {
+    AUTOMATIC1111 = "AUTOMATIC1111",
+    COMFYUI = "ComfyUI",
+    FOOOCUS = "Fooocus",
+    INVOKEAI = "InvokeAI",
+    NOVELAI = "NovelAI",
+    UNKNOWN = "unknown"
+}
+//# sourceMappingURL=generators.d.ts.map

package/dist/data/generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/data/generators.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,UAAU;IACpB,aAAa,kBAAkB;IAC/B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB"}

package/dist/data/index.d.ts

@@ -0,0 +1,10 @@
+export { Generators } from './generators';
+export type { Model } from './model';
+export { createModel, modelToString } from './model';
+export type { Prompt } from './prompt';
+export { createPrompt, promptToString } from './prompt';
+export type { Sampler } from './sampler';
+export { createSampler } from './sampler';
+export type { PromptInfo } from './promptInfo';
+export { createPromptInfo, getFullPrompt, getFullNegativePrompt, getPrompts, getNegativePrompts, getModels, promptInfoToDict, promptInfoToJSON } from './promptInfo';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrD,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,cAAc,CAAC"}

package/dist/data/model.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Represents a checkpoint model used during image generation
+ */
+export interface Model {
+    /** Name of the checkpoint model (if found) */
+    name?: string;
+    /** Hash value of the checkpoint model (if found) */
+    hash?: string;
+    /** Model id */
+    modelId?: string;
+    /** Additional generator-specific information. Highly dependent on the respective image generator. */
+    metadata: Record<string, any>;
+}
+/**
+ * Creates a new Model instance
+ */
+export declare function createModel(options: Partial<Model> & {
+    name?: string;
+    hash?: string;
+}): Model;
+/**
+ * Returns string representation of the model
+ */
+export declare function modelToString(model: Model): string;
+//# sourceMappingURL=model.d.ts.map

package/dist/data/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/data/model.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,qGAAqG;IACrG,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAa7F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAKlD"}

package/dist/data/prompt.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Represents an image generation prompt
+ */
+export interface Prompt {
+    /** The value of the prompt */
+    value: string;
+    /** Prompt id */
+    promptId?: string;
+    /** Additional generator-specific information. Highly dependent on the respective image generator. */
+    metadata: Record<string, any>;
+}
+/**
+ * Creates a new Prompt instance
+ */
+export declare function createPrompt(value: string, options?: Partial<Pick<Prompt, 'promptId' | 'metadata'>>): Prompt;
+/**
+ * Returns string representation of the prompt
+ */
+export declare function promptToString(prompt: Prompt): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/data/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/data/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IAEd,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qGAAqG;IACrG,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC,CAAM,GAAG,MAAM,CAQhH;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/data/promptInfo.d.ts

@@ -0,0 +1,56 @@
+import { Generators } from './generators';
+import { Model } from './model';
+import { Prompt } from './prompt';
+import { Sampler } from './sampler';
+/**
+ * Contains structured image generation parameters
+ */
+export interface PromptInfo {
+    /** Image generator which might have produced the parsed image */
+    generator: Generators;
+    /** Samplers used in generating the parsed image */
+    samplers: Sampler[];
+    /** Additional parameters which are found in the image metadata. Highly dependent on the respective image generator. */
+    metadata: Record<string, any>;
+    /** Unprocessed parameters as found in the parsed image */
+    rawParameters: Record<string, any>;
+}
+/**
+ * Creates a new PromptInfo instance
+ */
+export declare function createPromptInfo(generator: Generators, samplers: Sampler[], metadata?: Record<string, any>, rawParameters?: Record<string, any>): PromptInfo;
+/**
+ * Gets the full prompt if present in the image metadata.
+ * Otherwise, returns a simple concatenation of all prompts found in the generation data.
+ *
+ * Reproducibility of the source image using this data is not guaranteed (=rather unlikely).
+ */
+export declare function getFullPrompt(promptInfo: PromptInfo): string;
+/**
+ * Gets the full negative prompt if present in the image metadata.
+ * Otherwise, returns a simple concatenation of all negative prompts found in the generation data.
+ *
+ * Reproducibility of the source image using this data is not guaranteed (=rather unlikely).
+ */
+export declare function getFullNegativePrompt(promptInfo: PromptInfo): string;
+/**
+ * Gets unique prompts used in generating the parsed image
+ */
+export declare function getPrompts(promptInfo: PromptInfo): Prompt[];
+/**
+ * Gets unique negative prompts used in generating the parsed image
+ */
+export declare function getNegativePrompts(promptInfo: PromptInfo): Prompt[];
+/**
+ * Gets unique models used in generating the parsed image
+ */
+export declare function getModels(promptInfo: PromptInfo): Model[];
+/**
+ * Converts PromptInfo to a dictionary representation
+ */
+export declare function promptInfoToDict(promptInfo: PromptInfo): Record<string, any>;
+/**
+ * Converts PromptInfo to JSON string
+ */
+export declare function promptInfoToJSON(promptInfo: PromptInfo): string;
+//# sourceMappingURL=promptInfo.d.ts.map

package/dist/data/promptInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptInfo.d.ts","sourceRoot":"","sources":["../../src/data/promptInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAkB,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,SAAS,EAAE,UAAU,CAAC;IAEtB,mDAAmD;IACnD,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEpB,uHAAuH;IACvH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,UAAU,EACrB,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAClC,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GACtC,UAAU,CAOZ;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAO5D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAOpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAe3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAenE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,EAAE,CAezD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAS5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE/D"}

package/dist/data/sampler.d.ts

@@ -0,0 +1,24 @@
+import { Model } from './model';
+import { Prompt } from './prompt';
+/**
+ * Represents a sampler used during image generation
+ */
+export interface Sampler {
+    /** The name of the sampler */
+    name: string;
+    /** Generation parameters, including cfg_scale, seed, steps and others */
+    parameters: Record<string, any>;
+    /** A unique id for this sampler (if present in the metadata) */
+    samplerId?: string;
+    /** The checkpoint model used */
+    model?: Model;
+    /** Positive prompts used by this sampler */
+    prompts: Prompt[];
+    /** Negative prompts used by this sampler */
+    negativePrompts: Prompt[];
+}
+/**
+ * Creates a new Sampler instance
+ */
+export declare function createSampler(name: string, parameters?: Record<string, any>, options?: Partial<Pick<Sampler, 'samplerId' | 'model' | 'prompts' | 'negativePrompts'>>): Sampler;
+//# sourceMappingURL=sampler.d.ts.map

package/dist/data/sampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.d.ts","sourceRoot":"","sources":["../../src/data/sampler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EACpC,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,iBAAiB,CAAC,CAAM,GAC1F,OAAO,CAWT"}

package/dist/exceptions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Base error class for parser-related errors
+ */
+export declare class ParserError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when metadata did not match our expectations - can be safely ignored
+ */
+export declare class MetadataError extends ParserError {
+    constructor(message: string);
+}
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../src/exceptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/extractors/eagerness.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Enumeration of metadata extraction eagerness levels
+ */
+export declare enum Eagerness {
+    FAST = 1,
+    DEFAULT = 2,
+    EAGER = 3
+}
+//# sourceMappingURL=eagerness.d.ts.map

package/dist/extractors/eagerness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eagerness.d.ts","sourceRoot":"","sources":["../../src/extractors/eagerness.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,SAAS;IACnB,IAAI,IAAI;IACR,OAAO,IAAI;IACX,KAAK,IAAI;CACV"}

package/dist/extractors/extractors.d.ts

@@ -0,0 +1,30 @@
+import { Generators } from '../data';
+/**
+ * Type definition for metadata extractor functions (browser-compatible)
+ */
+export type ExtractorFunction = (buffer: Uint8Array, generator: Generators) => Promise<Record<string, any> | null>;
+/**
+ * Extract metadata from PNG image info
+ *
+ * Browser version note: This function currently returns null as browser APIs
+ * do not provide DPI/density information like Sharp does in Node.js.
+ * Kept for API compatibility with original library and future implementation.
+ */
+export declare function pngImageInfo(buffer: Uint8Array, _: Generators): Promise<Record<string, any> | null>;
+/**
+ * Extract metadata from PNG text chunks
+ */
+export declare function pngImageText(buffer: Uint8Array, _: Generators): Promise<Record<string, any> | null>;
+/**
+ * Extract metadata from PNG stenographic alpha channel
+ *
+ * Browser version note: Stenographic analysis is not implemented in the browser version.
+ * This feature requires specialized image processing that is not available in browsers.
+ * Kept for API compatibility with original library.
+ */
+export declare function pngStenographicAlpha(buffer: Uint8Array, _: Generators): Promise<Record<string, any> | null>;
+/**
+ * Extract metadata from JPEG UserComment EXIF field
+ */
+export declare function jpegUserComment(buffer: Uint8Array, generator: Generators): Promise<Record<string, any> | null>;
+//# sourceMappingURL=extractors.d.ts.map

package/dist/extractors/extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractors.d.ts","sourceRoot":"","sources":["../../src/extractors/extractors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,UAAU,KAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAazG;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CA6DzG;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAQjH;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CA0DpH"}

package/dist/extractors/index.d.ts

@@ -0,0 +1,14 @@
+import { Eagerness } from './eagerness';
+import { ExtractorFunction } from './extractors';
+/**
+ * Metadata extractors organized by image format and eagerness level
+ *
+ * Browser version notes:
+ * - FAST mode: Limited functionality (PNG IHDR parsing not implemented)
+ * - DEFAULT mode: Recommended - fully functional for SD metadata extraction
+ * - EAGER mode: Stenographic features not available in browser environment
+ */
+export declare const METADATA_EXTRACTORS: Record<string, Record<Eagerness, ExtractorFunction[]>>;
+export { Eagerness } from './eagerness';
+export { ExtractorFunction } from './extractors';
+//# sourceMappingURL=index.d.ts.map

package/dist/extractors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extractors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAqE,MAAM,cAAc,CAAC;AAEpH;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAgBtF,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/imageUtils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Browser-compatible image utilities to replace Sharp functionality
+ */
+/**
+ * 画像フォーマットをマジックバイトから検出
+ */
+export declare function detectImageFormat(buffer: Uint8Array): string | null;
+/**
+ * 画像の基本メタデータを取得（ブラウザAPI使用）
+ */
+export declare function getImageMetadata(buffer: Uint8Array): Promise<{
+    width?: number;
+    height?: number;
+    format?: string;
+}>;
+//# sourceMappingURL=imageUtils.d.ts.map

package/dist/imageUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageUtils.d.ts","sourceRoot":"","sources":["../src/imageUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAqBnE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAyBD"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A library to read metadata from images created with Stable Diffusion.
+ *
+ * Basic usage:
+ * ```typescript
+ * import { ParserManager } from 'sd-parsers';
+ *
+ * const parserManager = new ParserManager();
+ *
+ * async function main() {
+ *   const promptInfo = await parserManager.parse('image.png');
+ *   if (promptInfo) {
+ *     console.log(promptInfo);
+ *   }
+ * }
+ * ```
+ */
+export { ParserManager } from './parserManager';
+export { Eagerness } from './extractors';
+export * from './data';
+export * from './parsers';
+export * from './exceptions';
+//# 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;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/parserManager.d.ts

@@ -0,0 +1,26 @@
+import { PromptInfo } from './data';
+import { Eagerness } from './extractors';
+import { Parser } from './parsers';
+/**
+ * Input types that can be parsed (browser-compatible)
+ */
+export type ParseInput = Blob | ArrayBuffer | Uint8Array;
+/**
+ * Provides a simple way of testing multiple parser modules against a given image
+ */
+export declare class ParserManager {
+    private eagerness;
+    private debug;
+    private managedParsers;
+    constructor(options?: {
+        debug?: boolean;
+        eagerness?: Eagerness;
+        managedParsers?: (new (normalizeParameters?: boolean, debug?: boolean) => Parser)[];
+        normalizeParameters?: boolean;
+    });
+    /**
+     * Try to extract image generation parameters from the given image.
+     */
+    parse(input: ParseInput, eagerness?: Eagerness): Promise<PromptInfo | null>;
+}
+//# sourceMappingURL=parserManager.d.ts.map

package/dist/parserManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parserManager.d.ts","sourceRoot":"","sources":["../src/parserManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAuB,SAAS,EAAqB,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,MAAM,EAAmB,MAAM,WAAW,CAAC;AAGpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,WAAW,GAAG,UAAU,CAAC;AAEzD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,cAAc,CAAW;gBAErB,OAAO,GAAE;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,cAAc,CAAC,EAAE,CAAC,KAAK,mBAAmB,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC,EAAE,CAAC;QACpF,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC1B;IAiBN;;OAEG;IACG,KAAK,CACT,KAAK,EAAE,UAAU,EACjB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAiF9B"}

package/dist/parsers/automatic1111.d.ts

@@ -0,0 +1,10 @@
+import { Parser } from './parser';
+import { Generators, PromptInfo } from '../data';
+/**
+ * Parser for images generated by AUTOMATIC1111's stable-diffusion-webui or similar
+ */
+export declare class AUTOMATIC1111Parser extends Parser {
+    readonly generator = Generators.AUTOMATIC1111;
+    parse(parameters: Record<string, any>): Promise<PromptInfo>;
+}
+//# sourceMappingURL=automatic1111.d.ts.map

package/dist/parsers/automatic1111.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automatic1111.d.ts","sourceRoot":"","sources":["../../src/parsers/automatic1111.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA6B,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,UAAU,EAA8D,UAAU,EAAE,MAAM,SAAS,CAAC;AAc7G;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,MAAM;IAC7C,SAAgB,SAAS,4BAA4B;IAE/C,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CA2DlE"}

package/dist/parsers/comfyui.d.ts

@@ -0,0 +1,10 @@
+import { Parser } from './parser';
+import { Generators, PromptInfo } from '../data';
+/**
+ * Parser for images generated by ComfyUI
+ */
+export declare class ComfyUIParser extends Parser {
+    readonly generator = Generators.COMFYUI;
+    parse(parameters: Record<string, any>): Promise<PromptInfo>;
+}
+//# sourceMappingURL=comfyui.d.ts.map

package/dist/parsers/comfyui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comfyui.d.ts","sourceRoot":"","sources":["../../src/parsers/comfyui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,UAAU,EAA8D,UAAU,EAAW,MAAM,SAAS,CAAC;AAatH;;GAEG;AACH,qBAAa,aAAc,SAAQ,MAAM;IACvC,SAAgB,SAAS,sBAAsB;IAEzC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAsBlE"}

package/dist/parsers/dummy.d.ts

@@ -0,0 +1,10 @@
+import { Parser } from './parser';
+import { Generators, PromptInfo } from '../data';
+/**
+ * Example stub for additional parsers
+ */
+export declare class DummyParser extends Parser {
+    readonly generator = Generators.UNKNOWN;
+    parse(parameters: Record<string, any>): Promise<PromptInfo>;
+}
+//# sourceMappingURL=dummy.d.ts.map