@combos-fun/plugin-development-tool 0.0.6 → 0.0.7

package/README.md

@@ -0,0 +1,27 @@
+# @combos-fun/plugin-development-tool
+
+Scene / tagged object tap development tool: outline overlay and parent postMessage
+
+Keywords: `devtool`, `inspector`, `selection`, `outline`, `editor`, `debug`.
+
+## Documentation
+
+- Per-package agent / developer notes: [`agent-skill.md`](./agent-skill.md)
+- Machine-readable manifest: [`combos-plugin.json`](./combos-plugin.json)
+  (validated against `schemas/combos-plugin.schema.json` in the repo
+  root)
+- Entry skill (single source of truth for AI agents working with this
+  monorepo): `skills/combos-engine-development/SKILL.md`
+
+When consumed from npm, the manifest and agent notes are exposed as
+stable subpaths:
+
+```ts
+import manifest from '@combos-fun/plugin-development-tool/plugin-manifest';
+// or fetch the markdown directly:
+// require.resolve('@combos-fun/plugin-development-tool/agent-skill')
+```
+
+## License
+
+Internal workspace package, part of the Combos Fun engine monorepo.

package/agent-skill.md

@@ -0,0 +1,62 @@
+# `@combos-fun/plugin-development-tool` — Agent notes
+
+In-canvas debugging / inspection plugin. Adds a `CombosDevelopmentToolTarget`
+Component that, when tapped, draws an outline overlay around the
+GameObject and posts a parent-frame message identifying the selected node.
+Used by the Combos Fun editor / inspector to wire up two-way selection
+between the editor tree and the running game.
+
+## When to read
+
+Read whenever building tooling, integrating with the Combos editor, or
+debugging which GameObject is being tapped at runtime.
+
+## Public API
+
+```ts
+import {
+  CombosDevelopmentToolSystem,
+  CombosDevelopmentToolTarget,
+  COMBOS_DEVELOPMENT_TOOL_GAMEOBJECT_SELECTED,
+  COMBOS_DEVELOPMENT_TOOL_REFRESH,
+  COMBOS_DEVELOPMENT_TOOL_SET,
+  type CombosDevelopmentToolTargetParams,
+  type CombosDevelopmentToolSystemParams,
+  type CombosDevelopmentToolSelectScope,
+} from '@combos-fun/plugin-development-tool';
+```
+
+- `CombosDevelopmentToolTarget` — Component to attach to any GameObject
+  that should be selectable in editor mode.
+- `CombosDevelopmentToolSystem` — System that listens to taps, draws the
+  outline, and posts `COMBOS_DEVELOPMENT_TOOL_GAMEOBJECT_SELECTED`
+  messages to the parent window.
+
+## Required setup
+
+This plugin depends on `@combos-fun/plugin-renderer-event` (for taps)
+and `@combos-fun/plugin-renderer-graphics` (for the outline). Register
+all of them after `RendererSystem`:
+
+```ts
+new Game({
+  systems: [
+    new RendererSystem({ canvas, width, height }),
+    new EventSystem(),
+    new GraphicsSystem(),
+    new CombosDevelopmentToolSystem({ /* options */ }),
+  ],
+});
+```
+
+## Common pitfalls
+
+| Symptom | Fix |
+|---------|-----|
+| Selection box never appears | Ensure both `EventSystem` and `GraphicsSystem` are registered |
+| Parent frame never receives messages | The page must be in an iframe / embedded context; `window.parent !== window` |
+| Selection stuck on stale node | Listen for `COMBOS_DEVELOPMENT_TOOL_REFRESH` to clear |
+
+## Verification
+
+`pnpm --filter @combos-fun/plugin-development-tool run build`.

package/combos-plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "@combos-fun/plugin-development-tool",
+  "pluginId": "development-tool",
+  "category": "devtool",
+  "dimension": "2d",
+  "isCore": false,
+  "keywords": ["devtool", "inspector", "selection", "outline", "editor", "debug"],
+  "agentSkill": "./agent-skill.md",
+  "requires": [
+    "@combos-fun/engine",
+    "@combos-fun/plugin-renderer-event",
+    "@combos-fun/plugin-renderer-graphics"
+  ],
+  "exports": [
+    "CombosDevelopmentToolSystem",
+    "CombosDevelopmentToolTarget",
+    "COMBOS_DEVELOPMENT_TOOL_GAMEOBJECT_SELECTED",
+    "COMBOS_DEVELOPMENT_TOOL_REFRESH",
+    "COMBOS_DEVELOPMENT_TOOL_SET"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combos-fun/plugin-development-tool",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Scene / tagged object tap development tool: outline overlay and parent postMessage",
   "main": "index.js",
   "module": "dist/plugin-development-tool.esm.js",
@@ -8,8 +8,22 @@
   "unpkg": "dist/CombosFun.plugin.developmentTool.min.js",
   "files": [
     "index.js",
-    "dist"
+    "dist",
+    "agent-skill.md",
+    "combos-plugin.json"
   ],
+  "exports": {
+    ".": {
+      "import": "./dist/plugin-development-tool.esm.js",
+      "require": "./index.js",
+      "types": "./dist/plugin-development-tool.d.ts"
+    },
+    "./plugin-manifest": "./combos-plugin.json",
+    "./agent-skill": "./agent-skill.md"
+  },
+  "combos": {
+    "pluginManifest": "./combos-plugin.json"
+  },
   "types": "dist/plugin-development-tool.d.ts",
   "keywords": [
     "combos-fun",
@@ -18,9 +32,9 @@
   ],
   "author": "sun668 <q947692259@gmail.com>",
   "dependencies": {
-    "@combos-fun/engine": "0.0.6",
-    "@combos-fun/plugin-renderer-event": "0.0.6",
-    "@combos-fun/plugin-renderer-graphics": "0.0.6"
+    "@combos-fun/engine": "0.0.7",
+    "@combos-fun/plugin-renderer-event": "0.0.7",
+    "@combos-fun/plugin-renderer-graphics": "0.0.7"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs"