chore: update project state and prepare for image support development

- Add comprehensive image test document with various image types - Update project structure with development artifacts - Prepare foundation for image support enhancement phase - Include test files for validating image editing workflows 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-26 08:06:22 +01:00
parent ff6b807f3b
commit d0abaab63a
2730 changed files with 218268 additions and 174 deletions
--- a/node_modules/dedent/LICENSE.md
+++ b/node_modules/dedent/LICENSE.md
@@ -0,0 +1,20 @@
+# MIT License
+
+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.
--- a/node_modules/dedent/README.md
+++ b/node_modules/dedent/README.md
@@ -0,0 +1,244 @@
+<h1 align="center">dedent</h1>
+
+<p align="center">A string tag that strips indentation from multi-line strings. ⬅️</p>
+
+<p align="center">
+	<!-- prettier-ignore-start -->
+	<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+	<a href="#contributors" target="_blank"><img alt="All Contributors: 18 👪" src="https://img.shields.io/badge/all_contributors-18_👪-21bb42.svg" /></a>
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+	<!-- prettier-ignore-end -->
+	<a href="https://github.com/dmnd/dedent/blob/main/.github/CODE_OF_CONDUCT.md" target="_blank"><img alt="🤝 Code of Conduct: Kept" src="https://img.shields.io/badge/code_of_conduct-enforced-21bb42" /></a>
+	<a href="https://codecov.io/gh/dmnd/dedent" target="_blank"><img alt="🧪 Coverage" src="https://codecov.io/gh/dmnd/dedent/branch/main/graph/badge.svg"/></a>
+	<a href="https://github.com/dmnd/dedent/blob/main/LICENSE.md" target="_blank"><img alt="📝 License: MIT" src="https://img.shields.io/github/license/dmnd/dedent?color=21bb42"></a>
+	<a href="http://npmjs.com/package/dedent" target="_blank"><img alt="📦 npm version" src="https://img.shields.io/npm/v/dedent?color=21bb42" /></a>
+	<img alt="💪 TypeScript: Strict" src="https://img.shields.io/badge/typescript-strict-21bb42.svg" />
+</p>
+
+## Usage
+
+```shell
+npm i dedent
+```
+
+```js
+import dedent from "dedent";
+
+function usageExample() {
+	const first = dedent`A string that gets so long you need to break it over
+											 multiple lines. Luckily dedent is here to keep it
+											 readable without lots of spaces ending up in the string
+											 itself.`;
+
+	const second = dedent`
+		Leading and trailing lines will be trimmed, so you can write something like
+		this and have it work as you expect:
+
+			* how convenient it is
+			* that I can use an indented list
+				 - and still have it do the right thing
+
+		That's all.
+	`;
+
+	const third = dedent(`
+		Wait! I lied. Dedent can also be used as a function.
+	`);
+
+	return first + "\n\n" + second + "\n\n" + third;
+}
+
+console.log(usageExample());
+```
+
+```plaintext
+A string that gets so long you need to break it over
+multiple lines. Luckily dedent is here to keep it
+readable without lots of spaces ending up in the string
+itself.
+
+Leading and trailing lines will be trimmed, so you can write something like
+this and have it work as you expect:
+
+	* how convenient it is
+	* that I can use an indented list
+		- and still have it do the right thing
+
+That's all.
+
+Wait! I lied. Dedent can also be used as a function.
+```
+
+## Options
+
+You can customize the options `dedent` runs with by calling its `withOptions` method with an object:
+
+<!-- prettier-ignore -->
+```js
+import dedent from 'dedent';
+
+dedent.withOptions({ /* ... */ })`input`;
+dedent.withOptions({ /* ... */ })(`input`);
+```
+
+`options` returns a new `dedent` function, so if you'd like to reuse the same options, you can create a dedicated `dedent` function:
+
+<!-- prettier-ignore -->
+```js
+import dedent from 'dedent';
+
+const dedenter = dedent.withOptions({ /* ... */ });
+
+dedenter`input`;
+dedenter(`input`);
+```
+
+### `alignValues`
+
+When an interpolation evaluates to a multi-line string, only its first line is placed where the `${...}` appears. Subsequent lines keep whatever indentation they already had inside that value (often none), so they can appear “shifted left”.
+
+Enable `alignValues` to fix that visual jump. When `true`, for every multi-line interpolated value, each line after the first gets extra indentation appended so it starts in the same column as the first line.
+
+```js
+import dedent from "dedent";
+
+const list = dedent`
+	- apples
+	- bananas
+	- cherries
+`;
+
+const withoutAlign = dedent`
+	List without alignValues (default):
+		${list}
+	Done.
+`;
+
+const withAlign = dedent.withOptions({ alignValues: true })`
+	List with alignValues: true
+		${list}
+	Done.
+`;
+
+console.log(withoutAlign);
+console.log("---");
+console.log(withAlign);
+```
+
+```plaintext
+List without alignValues (default):
+	- apples
+- bananas
+- cherries
+Done.
+---
+List with alignValues: true
+	- apples
+	- bananas
+	- cherries
+Done.
+```
+
+### `escapeSpecialCharacters`
+
+JavaScript string tags by default add an extra `\` escape in front of some special characters such as `$` dollar signs.
+`dedent` will escape those special characters when called as a string tag.
+
+If you'd like to change the behavior, an `escapeSpecialCharacters` option is available.
+It defaults to:
+
+- `false`: when `dedent` is called as a function
+- `true`: when `dedent` is called as a string tag
+
+```js
+import dedent from "dedent";
+
+// "$hello!"
+dedent`
+	$hello!
+`;
+
+// "\$hello!"
+dedent.withOptions({ escapeSpecialCharacters: false })`
+	$hello!
+`;
+
+// "$hello!"
+dedent.withOptions({ escapeSpecialCharacters: true })`
+	$hello!
+`;
+```
+
+For more context, see [🚀 Feature: Add an option to disable special character escaping](https://github.com/dmnd/dedent/issues/63).
+
+### `trimWhitespace`
+
+By default, dedent will trim leading and trailing whitespace from the overall string.
+
+This can be disabled by setting `trimWhitespace: false`.
+
+```js
+import dedent from "dedent";
+
+// "hello!"
+dedent`
+	hello! 
+`;
+
+// "\nhello! \n"
+dedent.withOptions({ trimWhitespace: false })`
+	hello! 
+`;
+
+// "hello!"
+dedent.withOptions({ trimWhitespace: true })`
+	hello! 
+`;
+```
+
+## License
+
+MIT
+
+## Contributors
+
+<!-- spellchecker: disable -->
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+	<tbody>
+		<tr>
+			<td align="center" valign="top" width="14.28%"><a href="https://adrianjost.dev/"><img src="https://avatars.githubusercontent.com/u/22987140?v=4?s=100" width="100px;" alt="Adrian Jost"/><br /><sub><b>Adrian Jost</b></sub></a><br /><a href="https://github.com/dmnd/dedent/commits?author=adrianjost" title="Code">💻</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://m811.com/"><img src="https://avatars.githubusercontent.com/u/156837?v=4?s=100" width="100px;" alt="Andri Möll"/><br /><sub><b>Andri Möll</b></sub></a><br /><a href="https://github.com/dmnd/dedent/issues?q=author%3Amoll" title="Bug reports">🐛</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://bennypowers.dev/"><img src="https://avatars.githubusercontent.com/u/1466420?v=4?s=100" width="100px;" alt="Benny Powers - עם ישראל חי!"/><br /><sub><b>Benny Powers - עם ישראל חי!</b></sub></a><br /><a href="#tool-bennypowers" title="Tools">🔧</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://github.com/phenomnomnominal"><img src="https://avatars.githubusercontent.com/u/1086286?v=4?s=100" width="100px;" alt="Craig Spence"/><br /><sub><b>Craig Spence</b></sub></a><br /><a href="https://github.com/dmnd/dedent/commits?author=phenomnomnominal" title="Code">💻</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://synthesis.com/"><img src="https://avatars.githubusercontent.com/u/4427?v=4?s=100" width="100px;" alt="Desmond Brand"/><br /><sub><b>Desmond Brand</b></sub></a><br /><a href="https://github.com/dmnd/dedent/issues?q=author%3Admnd" title="Bug reports">🐛</a> <a href="https://github.com/dmnd/dedent/commits?author=dmnd" title="Code">💻</a> <a href="https://github.com/dmnd/dedent/commits?author=dmnd" title="Documentation">📖</a> <a href="#ideas-dmnd" title="Ideas, Planning, & Feedback">🤔</a> <a href="#infra-dmnd" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#maintenance-dmnd" title="Maintenance">🚧</a> <a href="#projectManagement-dmnd" title="Project Management">📆</a> <a href="#tool-dmnd" title="Tools">🔧</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://github.com/G-Rath"><img src="https://avatars.githubusercontent.com/u/3151613?v=4?s=100" width="100px;" alt="Gareth Jones"/><br /><sub><b>Gareth Jones</b></sub></a><br /><a href="https://github.com/dmnd/dedent/commits?author=G-Rath" title="Code">💻</a> <a href="https://github.com/dmnd/dedent/issues?q=author%3AG-Rath" title="Bug reports">🐛</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://github.com/otakustay"><img src="https://avatars.githubusercontent.com/u/639549?v=4?s=100" width="100px;" alt="Gray Zhang"/><br /><sub><b>Gray Zhang</b></sub></a><br /><a href="https://github.com/dmnd/dedent/issues?q=author%3Aotakustay" title="Bug reports">🐛</a></td>
+		</tr>
+		<tr>
+			<td align="center" valign="top" width="14.28%"><a href="https://haroen.me/"><img src="https://avatars.githubusercontent.com/u/6270048?v=4?s=100" width="100px;" alt="Haroen Viaene"/><br /><sub><b>Haroen Viaene</b></sub></a><br /><a href="https://github.com/dmnd/dedent/commits?author=Haroenv" title="Code">💻</a> <a href="#maintenance-Haroenv" title="Maintenance">🚧</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://blog.cometkim.kr/"><img src="https://avatars.githubusercontent.com/u/9696352?v=4?s=100" width="100px;" alt="Hyeseong Kim"/><br /><sub><b>Hyeseong Kim</b></sub></a><br /><a href="#tool-cometkim" title="Tools">🔧</a> <a href="#infra-cometkim" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://github.com/jlarmstrongiv"><img src="https://avatars.githubusercontent.com/u/20903247?v=4?s=100" width="100px;" alt="John L. Armstrong IV"/><br /><sub><b>John L. Armstrong IV</b></sub></a><br /><a href="https://github.com/dmnd/dedent/issues?q=author%3Ajlarmstrongiv" title="Bug reports">🐛</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="http://www.joshuakgoldberg.com/"><img src="https://avatars.githubusercontent.com/u/3335181?v=4?s=100" width="100px;" alt="Josh Goldberg ✨"/><br /><sub><b>Josh Goldberg ✨</b></sub></a><br /><a href="https://github.com/dmnd/dedent/issues?q=author%3AJoshuaKGoldberg" title="Bug reports">🐛</a> <a href="https://github.com/dmnd/dedent/commits?author=JoshuaKGoldberg" title="Code">💻</a> <a href="https://github.com/dmnd/dedent/commits?author=JoshuaKGoldberg" title="Documentation">📖</a> <a href="#ideas-JoshuaKGoldberg" title="Ideas, Planning, & Feedback">🤔</a> <a href="#infra-JoshuaKGoldberg" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#maintenance-JoshuaKGoldberg" title="Maintenance">🚧</a> <a href="#projectManagement-JoshuaKGoldberg" title="Project Management">📆</a> <a href="#tool-JoshuaKGoldberg" title="Tools">🔧</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://pratapvardhan.com/"><img src="https://avatars.githubusercontent.com/u/3757165?v=4?s=100" width="100px;" alt="Pratap Vardhan"/><br /><sub><b>Pratap Vardhan</b></sub></a><br /><a href="https://github.com/dmnd/dedent/commits?author=pratapvardhan" title="Code">💻</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://github.com/lydell"><img src="https://avatars.githubusercontent.com/u/2142817?v=4?s=100" width="100px;" alt="Simon Lydell"/><br /><sub><b>Simon Lydell</b></sub></a><br /><a href="https://github.com/dmnd/dedent/issues?q=author%3Alydell" title="Bug reports">🐛</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://github.com/yinm"><img src="https://avatars.githubusercontent.com/u/13295106?v=4?s=100" width="100px;" alt="Yusuke Iinuma"/><br /><sub><b>Yusuke Iinuma</b></sub></a><br /><a href="https://github.com/dmnd/dedent/commits?author=yinm" title="Code">💻</a></td>
+		</tr>
+		<tr>
+			<td align="center" valign="top" width="14.28%"><a href="https://github.com/yvele"><img src="https://avatars.githubusercontent.com/u/4225430?v=4?s=100" width="100px;" alt="Yves M."/><br /><sub><b>Yves M.</b></sub></a><br /><a href="#tool-yvele" title="Tools">🔧</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://github.com/d07RiV"><img src="https://avatars.githubusercontent.com/u/3448203?v=4?s=100" width="100px;" alt="d07riv"/><br /><sub><b>d07riv</b></sub></a><br /><a href="https://github.com/dmnd/dedent/issues?q=author%3Ad07RiV" title="Bug reports">🐛</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://mizdra.net/"><img src="https://avatars.githubusercontent.com/u/9639995?v=4?s=100" width="100px;" alt="mizdra"/><br /><sub><b>mizdra</b></sub></a><br /><a href="https://github.com/dmnd/dedent/commits?author=mizdra" title="Code">💻</a></td>
+			<td align="center" valign="top" width="14.28%"><a href="https://github.com/sirian"><img src="https://avatars.githubusercontent.com/u/897643?v=4?s=100" width="100px;" alt="sirian"/><br /><sub><b>sirian</b></sub></a><br /><a href="https://github.com/dmnd/dedent/issues?q=author%3Asirian" title="Bug reports">🐛</a></td>
+		</tr>
+	</tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+<!-- spellchecker: enable -->
+
+> 💙 This package was templated with [create-typescript-app](https://github.com/JoshuaKGoldberg/create-typescript-app).
--- a/node_modules/dedent/macro.js
+++ b/node_modules/dedent/macro.js
@@ -0,0 +1,32 @@
+const { MacroError, createMacro } = require("babel-plugin-macros");
+const dedent = require("./dist/dedent.js").default;
+
+module.exports = createMacro(prevalMacros);
+
+function prevalMacros({ babel, references, state }) {
+	references.default.forEach((referencePath) => {
+		if (referencePath.parentPath.type === "TaggedTemplateExpression") {
+			asTag(referencePath.parentPath.get("quasi"), state, babel);
+		} else if (referencePath.parentPath.type === "CallExpression") {
+			asFunction(referencePath.parentPath.get("arguments"), state, babel);
+		} else {
+			throw new MacroError(
+				`dedent.macro can only be used as tagged template expression or function call. You tried ${referencePath.parentPath.type}.`,
+			);
+		}
+	});
+}
+
+function asTag(quasiPath, _, babel) {
+	const string = quasiPath.parentPath.get("quasi").evaluate().value;
+	const { types: t } = babel;
+
+	quasiPath.parentPath.replaceWith(t.stringLiteral(dedent(string)));
+}
+
+function asFunction(argumentsPaths, _, babel) {
+	const string = argumentsPaths[0].evaluate().value;
+	const { types: t } = babel;
+
+	argumentsPaths[0].parentPath.replaceWith(t.stringLiteral(dedent(string)));
+}
--- a/node_modules/dedent/package.json
+++ b/node_modules/dedent/package.json
@@ -0,0 +1,118 @@
+{
+  "name": "dedent",
+  "version": "1.7.0",
+  "description": "A string tag that strips indentation from multi-line strings. ⬅️",
+  "keywords": [
+    "dedent",
+    "tag",
+    "multi-line string",
+    "es6"
+  ],
+  "homepage": "https://github.com/dmnd/dedent",
+  "bugs": {
+    "url": "https://github.com/dmnd/dedent/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dmnd/dedent"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Desmond Brand",
+    "email": "dmnd@desmondbrand.com",
+    "url": "http://desmondbrand.com"
+  },
+  "type": "commonjs",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/dedent.d.mts",
+        "require": "./dist/dedent.d.ts"
+      },
+      "import": "./dist/dedent.mjs",
+      "require": "./dist/dedent.js"
+    }
+  },
+  "main": "./dist/dedent.js",
+  "module": "./dist/dedent.mjs",
+  "types": "./dist/dedent.d.mts",
+  "files": [
+    "dist/",
+    "macro.js",
+    "package.json",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "lint-staged": {
+    "*": "prettier --ignore-unknown --write"
+  },
+  "devDependencies": {
+    "@babel/cli": "^7.21.5",
+    "@babel/preset-env": "^7.23.3",
+    "@babel/preset-typescript": "^7.23.3",
+    "@release-it/conventional-changelog": "^8.0.1",
+    "@types/babel-plugin-macros": "^3.1.0",
+    "@types/eslint": "^8.44.7",
+    "@types/jest": "^29.5.3",
+    "@typescript-eslint/eslint-plugin": "^6.10.0",
+    "@typescript-eslint/parser": "^6.10.0",
+    "babel-plugin-add-module-exports": "^1.0.4",
+    "babel-plugin-tester": "^11.0.4",
+    "console-fail-test": "^0.2.3",
+    "cspell": "^8.0.0",
+    "eslint": "^8.53.0",
+    "eslint-plugin-deprecation": "^2.0.0",
+    "eslint-plugin-eslint-comments": "^3.2.0",
+    "eslint-plugin-jest": "^27.6.0",
+    "eslint-plugin-jsdoc": "^46.9.0",
+    "eslint-plugin-jsonc": "^2.10.0",
+    "eslint-plugin-markdown": "^3.0.1",
+    "eslint-plugin-n": "^16.3.1",
+    "eslint-plugin-no-only-tests": "^3.1.0",
+    "eslint-plugin-perfectionist": "^2.3.0",
+    "eslint-plugin-regexp": "^2.1.1",
+    "eslint-plugin-yml": "^1.10.0",
+    "husky": "^8.0.3",
+    "jest": "^29.7.0",
+    "jsonc-eslint-parser": "^2.4.0",
+    "knip": "^2.41.0",
+    "lint-staged": "^15.1.0",
+    "markdownlint": "^0.31.1",
+    "markdownlint-cli": "^0.37.0",
+    "npm-package-json-lint": "^7.1.0",
+    "npm-package-json-lint-config-default": "^6.0.0",
+    "prettier": "^3.0.3",
+    "prettier-plugin-curly": "^0.1.3",
+    "prettier-plugin-packagejson": "^2.4.6",
+    "release-it": "^17.0.0",
+    "should-semantic-release": "^0.2.1",
+    "tsup": "^7.2.0",
+    "typescript": "^5.2.2",
+    "yaml-eslint-parser": "^1.2.2"
+  },
+  "peerDependencies": {
+    "babel-plugin-macros": "^3.1.0"
+  },
+  "peerDependenciesMeta": {
+    "babel-plugin-macros": {
+      "optional": true
+    }
+  },
+  "packageManager": "pnpm@8.7.0",
+  "scripts": {
+    "build": "pnpm build:legacy && pnpm build:modern && pnpm build:types",
+    "build:legacy": "BABEL_ENV=legacy babel src/dedent.ts --out-file dist/dedent.js",
+    "build:modern": "BABEL_ENV=modern babel src/dedent.ts --out-file dist/dedent.mjs",
+    "build:types": "tsup src/dedent.ts --dts-only",
+    "format": "prettier \"**/*\" --ignore-unknown",
+    "lint": "eslint . .*js --max-warnings 0 --report-unused-disable-directives",
+    "lint:knip": "knip",
+    "lint:md": "markdownlint \"**/*.md\" \".github/**/*.md\"",
+    "lint:package-json": "npmPkgJsonLint .",
+    "lint:packages": "pnpm dedupe --check",
+    "lint:spelling": "cspell \"**\" \".github/**/*\"",
+    "should-semantic-release": "should-semantic-release --verbose",
+    "test": "jest",
+    "tsc": "tsc"
+  }
+}