@enslo/sd-metadata 2.1.1 → 2.3.0

package/CHANGELOG.md

@@ -5,6 +5,46 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.3.0] - 2026-05-30
+
+### Improved
+
+- **ComfyUI metadata parsing** (#219): Improved accuracy and coverage for
+  non-standard workflow topologies and custom nodes (`ShowText|pysssss`,
+  `PromptStashSaver`). Several edge cases that previously caused parse failures
+  or incorrect results — including workflows with `NaN`-containing JSON, node
+  references in model fields, and workflow-only PNG files — are now handled
+  correctly.
+
+### Maintenance
+
+- Add `index.d.ts.map` (declaration sourcemaps) to the published output (#216)
+- Update development dependencies
+
+## [2.2.0] - 2026-02-27
+
+### Added
+
+- **Draw Things parser** (#181): Read and write metadata from [Draw Things](https://drawthings.ai/) (macOS/iOS) generated images
+  - Extract generation parameters from XMP (Adobe XML Metadata) packets
+  - Native XMP read/write for JPEG (APP1 segment) and WebP (XMP chunk)
+  - XMP reading from PNG iTXt chunks
+
+### Potentially Breaking Changes
+
+- **New `GenerationSoftware` member** (#181): `'draw-things'` added. TypeScript users with exhaustive `switch` or `Record<GenerationSoftware, ...>` will need to handle the new value.
+- **New `MetadataSegmentSource` variant** (#181): `{ type: 'xmpPacket' }` added for XMP segment tracking. Exhaustive patterns on `MetadataSegmentSource` will need updating.
+
+### Security
+
+- **XMP regex ReDoS protection** (#181): Add 64KB size limit on XMP text input to prevent exponential backtracking on malformed XML
+- **XML entity decoder hardening** (#181): Catch `RangeError` from `String.fromCodePoint` on invalid Unicode code points in XMP entities
+- **JPEG COM segment overflow guard** (#181): Add 64KB size limit check to `buildComSegment`, matching the existing guard on `buildXmpApp1Segment`
+
+### Maintenance
+
+- Update development dependencies
+
 ## [2.1.1] - 2026-02-24
 
 ### Fixed
@@ -380,6 +420,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Biome for code formatting and linting
 - CONTRIBUTING.md for community contributions
 
+[2.2.0]: https://github.com/enslo/sd-metadata/releases/tag/core@2.2.0
 [2.1.1]: https://github.com/enslo/sd-metadata/releases/tag/core@2.1.1
 [2.1.0]: https://github.com/enslo/sd-metadata/releases/tag/v2.1.0
 [2.0.1]: https://github.com/enslo/sd-metadata/releases/tag/v2.0.1

package/README.ja.md

@@ -1,4 +1,4 @@
-# sd-metadata
+# @enslo/sd-metadata
 
 [![npm version](https://img.shields.io/npm/v/@enslo/sd-metadata.svg)](https://www.npmjs.com/package/@enslo/sd-metadata)
 [![npm downloads](https://img.shields.io/npm/dm/@enslo/sd-metadata.svg)](https://www.npmjs.com/package/@enslo/sd-metadata)
@@ -6,6 +6,8 @@
 
 🌐 **[English version](./README.md)**
 
+🔗 **[ライブデモ](https://sd-metadata.pages.dev/)**
+
 AI生成画像に埋め込まれたメタデータを読み書きするためのTypeScriptライブラリです。
 
 ## 特徴
@@ -45,6 +47,7 @@ npm install @enslo/sd-metadata
 | [Fooocus](https://github.com/lllyasviel/Fooocus) | ⚠️ | ⚠️ | ⚠️ |
 | [Ruined Fooocus](https://github.com/runew0lf/RuinedFooocus) | ✅ | 🔄️ | 🔄️ |
 | [Easy Diffusion](https://github.com/easydiffusion/easydiffusion) | ⚠️ | ⚠️ | ⚠️ |
+| [Draw Things](https://drawthings.ai/) | ⚠️ | ⚠️ | ⚠️ |
 
 **凡例:**
 
@@ -145,7 +148,7 @@ fileInput.addEventListener('change', async (e) => {
 // ==UserScript==
 // @name        My Script
 // @namespace   https://example.com
-// @require     https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@2.1.1/dist/index.global.js
+// @require     https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@2.3.0/dist/index.global.js
 // ==/UserScript==
 
 const response = await fetch(imageUrl);
@@ -362,7 +365,8 @@ if (text) {
 **パラメータ:**
 
 - `input` - 画像ファイルデータ（PNG、JPEG、またはWebP）
-- `options` - オプションの読み込み設定（詳細は[型ドキュメント](./docs/types.ja.md)を参照）
+- `options` - オプションの読み込み設定
+  - `strict?: boolean`（デフォルト: `false`）— `true` の場合、寸法（`width` / `height`）はメタデータからのみ取得します。`false` の場合、メタデータに寸法がなければ画像ヘッダーから取得します。
 
 **戻り値:**
 
@@ -557,7 +561,8 @@ type GenerationSoftware =
   | 'novelai' | 'comfyui' | 'swarmui' | 'tensorart' | 'stability-matrix'
   | 'sd-webui' | 'forge' | 'forge-classic' | 'forge-neo' 
   | 'reforge'| 'easy-reforge' | 'sd-next' | 'civitai' | 'hf-space'
-  | 'invokeai' | 'easydiffusion' | 'fooocus' | 'ruined-fooocus';
+  | 'invokeai' | 'easydiffusion' | 'fooocus' | 'ruined-fooocus'
+  | 'draw-things';
 ```
 
 ### `EmbedMetadata`

package/README.md

@@ -1,10 +1,12 @@
-# sd-metadata
+# @enslo/sd-metadata
 
 [![npm version](https://img.shields.io/npm/v/@enslo/sd-metadata.svg)](https://www.npmjs.com/package/@enslo/sd-metadata)
 [![npm downloads](https://img.shields.io/npm/dm/@enslo/sd-metadata.svg)](https://www.npmjs.com/package/@enslo/sd-metadata)
 [![license](https://img.shields.io/npm/l/@enslo/sd-metadata.svg)](https://github.com/enslo/sd-metadata/blob/main/LICENSE)
 
-🇯🇵 **[日本語版はこちら](./README.ja.md)**
+🌐 **[日本語版はこちら](./README.ja.md)**
+
+🔗 **[Live Demo](https://sd-metadata.pages.dev/)**
 
 A TypeScript library to read and write metadata embedded in AI-generated images.
 
@@ -45,6 +47,7 @@ npm install @enslo/sd-metadata
 | [Fooocus](https://github.com/lllyasviel/Fooocus) | ⚠️ | ⚠️ | ⚠️ |
 | [Ruined Fooocus](https://github.com/runew0lf/RuinedFooocus) | ✅ | 🔄️ | 🔄️ |
 | [Easy Diffusion](https://github.com/easydiffusion/easydiffusion) | ⚠️ | ⚠️ | ⚠️ |
+| [Draw Things](https://drawthings.ai/) | ⚠️ | ⚠️ | ⚠️ |
 
 **Legend:**
 
@@ -145,7 +148,7 @@ For userscripts (Tampermonkey, Violentmonkey, etc.), load the IIFE build via `@r
 // ==UserScript==
 // @name        My Script
 // @namespace   https://example.com
-// @require     https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@2.1.1/dist/index.global.js
+// @require     https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@2.3.0/dist/index.global.js
 // ==/UserScript==
 
 const response = await fetch(imageUrl);
@@ -359,7 +362,8 @@ Reads and parses metadata from an image file.
 **Parameters:**
 
 - `input` - Image file data (PNG, JPEG, or WebP)
-- `options` - Optional read options (see [Type Documentation](./docs/types.md) for details)
+- `options` - Optional read options
+  - `strict?: boolean` (default: `false`) — When `true`, dimensions (`width` / `height`) are taken strictly from metadata only. When `false`, missing dimensions are extracted from image headers.
 
 **Returns:**
 
@@ -557,7 +561,8 @@ type GenerationSoftware =
   | 'novelai' | 'comfyui' | 'swarmui' | 'tensorart' | 'stability-matrix'
   | 'sd-webui' | 'forge' | 'forge-classic' | 'forge-neo' 
   | 'reforge'| 'easy-reforge' | 'sd-next' | 'civitai' | 'hf-space'
-  | 'invokeai' | 'easydiffusion' | 'fooocus' | 'ruined-fooocus';
+  | 'invokeai' | 'easydiffusion' | 'fooocus' | 'ruined-fooocus'
+  | 'draw-things';
 ```
 
 ### `EmbedMetadata`