Initial commit: IdeaSDK TypeScript plugin SDK

examples/hello-plugin/README.md

@@ -0,0 +1,33 @@
+# Hello Plugin
+
+Installable IdeA plugin example rebuilt from the public SDK types.
+
+It exercises the current plugin primitives end to end:
+
+- top-level menu: `Hello Plugin`;
+- menu entry: `hello-plugin`;
+- command: `hello-plugin`, returning `hello-world`;
+- layout contribution: `hello-plugin.hello-world`, rendered as `hello-world`.
+- tooling capability: logs the focused workspace project when `ctx.services` is available.
+
+```sh
+npm run typecheck:examples
+npm run package:hello-plugin
+```
+
+The installable archive is emitted at `examples/hello-plugin/build/hello-plugin-0.1.0.zip`.
+It contains `idea-plugin.json` at the ZIP root and the compiled ESM entrypoint at
+`dist/index.js`, matching the manifest `main` field.
+
+## Diagnostics
+
+During activation the plugin logs:
+
+- whether the command and layout runtime registries are available;
+- successful registration of the `hello-plugin` command;
+- successful registration of the `hello-plugin.hello-world` layout;
+- availability of the workspace service from the `tooling` runtime capability;
+- the first layout render, including project/node identifiers.
+
+These messages are intentionally small and stable so installation, bundle import, activation and
+layout rendering failures can be separated quickly in IdeA logs/devtools.