cdb2yugiohcard 1.0.1

package/.eslintignore

@@ -0,0 +1,4 @@
+webpack.config.js
+dist/*
+build/*
+*.js

package/.eslintrc.js

@@ -0,0 +1,25 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: 'tsconfig.json',
+    tsconfigRootDir : __dirname, 
+    sourceType: 'module',
+  },
+  plugins: ['@typescript-eslint/eslint-plugin'],
+  extends: [
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended',
+  ],
+  root: true,
+  env: {
+    node: true,
+    jest: true,
+  },
+  ignorePatterns: ['.eslintrc.js', 'src/vendor/**'],
+  rules: {
+    '@typescript-eslint/interface-name-prefix': 'off',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+  },
+};

package/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

package/AGENTS.md

@@ -0,0 +1,22 @@
+# 项目规范
+
+## 项目目标
+
+把 ygopro-cdb-encode 转换为 yugioh-card 的数据。
+
+## 注意事项
+
+- 不要擅自写 md 文件。
+- 写完代码之后遇到 eslint 报错，不要直接手动修，而是先跑 npm run lint 修复。
+- 和业务无关的逻辑写在 src/utility/ 下
+- 常量写在 src/constants/ 下
+- 类型写在 src/types/ 下
+
+## 参考项目
+
+这些项目只能看，不能进行修改。
+
+- 曾经的成功转换项目: /home/nanahira/ygo/diy
+- ygopro-cdb-encode: /home/nanahira/ygo/ygopro-cdb-encode
+- ygopro 文本: /home/nanahira/ygo/ygopro/strings.conf
+- ygopro-cdb-descgen: /home/nanahira/ygo/ygopro-cdb-descgen

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Nanahira
+
+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,86 @@
+# cdb2yugiohcard
+
+Convert [ygopro-cdb-encode](https://www.npmjs.com/package/ygopro-cdb-encode) card data to [yugioh-card](https://www.npmjs.com/package/yugioh-card) format.
+
+## Installation
+
+```bash
+npm install cdb2yugiohcard ygopro-cdb-encode yugioh-card
+```
+
+`ygopro-cdb-encode` and `yugioh-card` are peer dependencies and must be installed alongside.
+
+## Usage
+
+### Basic Conversion
+
+```typescript
+import { YGOProCdb } from 'ygopro-cdb-encode';
+import { cdbToYugiohCard } from 'cdb2yugiohcard';
+
+// Load CDB database
+const cdb = new YGOProCdb(SQL).from(cdbData);
+const card = cdb.findById(46986414);
+
+// Convert to yugioh-card data
+const data = cdbToYugiohCard(card, { language: 'sc' });
+```
+
+### Supported Languages
+
+| Code | Language |
+|------|----------|
+| `sc` | Simplified Chinese (default) |
+| `tc` | Traditional Chinese (uses SC logic) |
+| `astral` | Astral (uses SC logic) |
+| `jp` | Japanese |
+| `kr` | Korean |
+| `en` | English |
+
+### Passing Extra Fields
+
+The second argument of `cdbToYugiohCard` accepts any additional `yugioh-card` fields such as card image and rarity:
+
+```typescript
+const data = cdbToYugiohCard(card, {
+  language: 'sc',
+  image: '/path/to/card/image.jpg',
+  rare: 'sr',
+});
+```
+
+### Rendering Card Images with yugioh-card
+
+```typescript
+import { YugiohCard } from 'yugioh-card';
+import { Canvas } from 'skia-canvas';
+
+const yugiohCard = new YugiohCard({
+  canvas: new Canvas(400, 580),
+  resourcePath: '/path/to/yugioh-card/static',
+  data,
+});
+await yugiohCard.bindCanvas();
+await yugiohCard.bindData();
+await yugiohCard.render();
+```
+
+## API
+
+### `cdbToYugiohCard(card, extras?)`
+
+- `card` — `CardDataEntry` from `ygopro-cdb-encode`
+- `extras` — `Partial<YugiohCardData>`, optional extra fields. The `language` field selects the locale handler.
+- Returns `Partial<YugiohCardData>`
+
+### `getLocaleHandler(language)`
+
+Get the locale handler instance for a given language code.
+
+### `LocaleHandler`
+
+Abstract base class for locale handlers. Extend this to implement custom language support.
+
+## License
+
+MIT