next2d-development-mcp 1.1.8 → 1.3.0

package/dist/references/develop-specs.md

@@ -1286,6 +1286,94 @@ export class TopBtnMolecule extends ButtonAtom {
 }
 ```
 
+### DisplayObject の中心点基準配置（scale・rotation アニメーション必須）
+
+`scaleX` / `scaleY` / `rotation` を変更すると `width` / `height` の値が変わる。
+**addChild より前にスケール・回転を確定させないと、オフセット計算がずれる。**
+
+実装手順（順序厳守）:
+
+```typescript
+// ステップ a: scaleX / scaleY / rotation を先に設定（width/height を確定させる）
+child.scaleX  = 2;
+child.scaleY  = 2;
+child.rotation = 45;
+
+// ステップ b: 確定した width/height でオフセットを計算し、原点を中心に移動
+child.x = -child.width  / 2;
+child.y = -child.height / 2;
+
+// ステップ c: 親 Sprite に addChild（この時点で中心点基準の配置が完成）
+sprite.addChild(child);
+```
+
+#### Tween で中心点基準のスケールアニメーションを行う場合
+
+```typescript
+export class YourScaleAnimation
+{
+    private readonly _job: Job;
+
+    constructor (sprite: Sprite, child: Sprite, callback?: () => void)
+    {
+        // ステップ a: 初期スケールを設定して width/height を確定
+        child.scaleX = 0;
+        child.scaleY = 0;
+
+        // ステップ b: 中心点オフセットを計算
+        //   scaleX=0 のとき width=0 になるため、最終サイズで計算する
+        //   → scaleX=1 にした上で取得し、その後に戻す
+        child.scaleX = 1;
+        child.scaleY = 1;
+        child.x = -child.width  / 2;
+        child.y = -child.height / 2;
+        child.scaleX = 0;
+        child.scaleY = 0;
+
+        // ステップ c: addChild してから Tween を設定
+        sprite.addChild(child);
+
+        this._job = Tween.add(child,
+            { "scaleX": 0, "scaleY": 0 },
+            { "scaleX": 1, "scaleY": 1 },
+            0.3, 0, Easing.outBack
+        );
+
+        if (callback) {
+            this._job.addEventListener(Event.COMPLETE, callback);
+        }
+    }
+
+    start (): void
+    {
+        this._job.start();
+    }
+}
+```
+
+#### Anti-Patterns
+
+```typescript
+// NG: addChild 後にスケールを変更 → width/height が変わりオフセットがずれる
+sprite.addChild(child);
+child.scaleX = 2;
+child.scaleY = 2;
+child.x = -child.width / 2; // この時点の width は scaleX=2 適用後なので正しいが、
+                              // addChild 済みなので描画順が保証されない
+
+// NG: スケール設定前にオフセットを計算 → width/height がデフォルト値のまま
+child.x = -child.width / 2; // scaleX 未設定の width で計算してしまう
+child.scaleX = 2;
+sprite.addChild(child);
+
+// OK: a → b → c の順序を守る
+child.scaleX = 2;           // a: スケール確定
+child.scaleY = 2;
+child.x = -child.width / 2; // b: オフセット計算
+child.y = -child.height / 2;
+sprite.addChild(child);      // c: addChild
+```
+
 ---
 
 ## Content (Animation Tool)

package/dist/references/player-specs.md

@@ -241,6 +241,7 @@ DisplayObjectは、Next2D Playerにおける全ての表示オブジェクトの
 | `mouseX` | number | 対象のDisplayObjectの基準点からのマウスのX座標（ピクセル） |
 | `mouseY` | number | 対象のDisplayObjectの基準点からのマウスのY座標（ピクセル） |
 | `root` | MovieClip \| Sprite \| null | DisplayObjectのルートであるDisplayObjectContainer |
+| `namespace` | string | クラスの空間名（例: `"next2d.display.Sprite"`）を返却。クラス判定に使用する（詳細は[クラス判定](#クラス判定namespace)を参照） |
 
 ### 読み書きプロパティ
 
@@ -480,6 +481,45 @@ sprite.cacheAsBitmap = null;
 - `stage.rendererScale`が変更されるとキャッシュが自動的に無効化されます
 - `filter`と`cacheAsBitmap`を同時に設定した場合、`cacheAsBitmap`が優先されます
 
+## クラス判定（namespace）
+
+クラスの種類を判定する際に `constructor.name` を使用してはいけません。プロダクションビルドでは minify によってクラス名が短縮・変更されるため、開発環境では動作してもビルド後に判定が壊れます。
+
+代わりに `namespace` プロパティを使用します。`namespace` はハードコードされた文字列（例: `"next2d.display.Stage"`）を返すため、minify の影響を受けません。インスタンスの getter と static getter の両方が用意されています。
+
+```typescript
+const { Stage, Sprite } = next2d.display;
+
+// ❌ NG: minify でクラス名が変わるため、ビルド後に判定が壊れる
+if (displayObject.constructor.name === "Stage") { /* ... */ }
+
+// ✅ OK: インスタンスの namespace で判定
+if (displayObject.namespace === "next2d.display.Stage") { /* ... */ }
+
+// ✅ OK: static の namespace と比較するとタイポも防げる
+if (displayObject.namespace === Stage.namespace) { /* ... */ }
+
+// ✅ OK: Sprite かどうかの判定
+if (displayObject.namespace === Sprite.namespace) { /* ... */ }
+
+// ✅ OK: Stage 判定は isStage フラグも使用可能（Stage のみが持つ readonly プロパティ）
+if (displayObject.isStage) { /* ... */ }
+```
+
+**namespace を持つ主なクラス:**
+
+| クラス | namespace の値 |
+|--------|----------------|
+| `Stage` | `"next2d.display.Stage"` |
+| `Sprite` | `"next2d.display.Sprite"` |
+| `MovieClip` | `"next2d.display.MovieClip"` |
+| `Shape` | `"next2d.display.Shape"` |
+| `Loader` | `"next2d.display.Loader"` |
+| `TextField` | `"next2d.display.TextField"` |
+| `Video` | `"next2d.media.Video"` |
+
+**補足:** 継承を含めた機能判定（「Sprite の機能を持っているか」など）には `isStage` / `isSprite` / `isShape` / `isText` / `isVideo` / `isContainerEnabled` / `isTimelineEnabled` の各フラグを使用します。`namespace` は完全一致のクラス判定に使用します。
+
 ## 関連項目
 
 - [MovieClip](/ja/reference/player/movie-clip)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "next2d-development-mcp",
   "displayName": "Next2D Development MCP",
-  "version": "1.1.8",
+  "version": "1.3.0",
   "description": "MCP server for Next2D application development assistance",
   "type": "module",
   "author": "Toshiyuki Ienaga <ienaga@next2d.app>",
@@ -52,16 +52,16 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.9.1",
-    "@types/vscode": "^1.120.0",
-    "@typescript-eslint/eslint-plugin": "^8.60.0",
-    "@typescript-eslint/parser": "^8.60.0",
-    "@vscode/vsce": "^3.9.1",
-    "eslint": "^10.4.0",
+    "@types/node": "^25.9.3",
+    "@types/vscode": "^1.115.0",
+    "@typescript-eslint/eslint-plugin": "^8.61.0",
+    "@typescript-eslint/parser": "^8.61.0",
+    "@vscode/vsce": "^3.9.2",
+    "eslint": "^10.4.1",
     "eslint-plugin-unused-imports": "^4.4.1",
     "globals": "^17.6.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=22.0.0",