@hachej/boring-ui-plugin-cli 0.1.31 → 0.1.32

package/templates/plugin/src/test-setup.ts

@@ -0,0 +1,43 @@
+// Vitest setup for this plugin. Each plugin owns its own copy of this
+// file; keep them in sync with packages/plugin-cli/templates/plugin/src/test-setup.ts when
+// the canonical setup changes (rare — see the comment below).
+//
+// Extends vitest's `expect` with jest-dom matchers manually rather than
+// via `import "@testing-library/jest-dom/vitest"`. The shorthand
+// re-imports `vitest` through jest-dom's own resolution path, which —
+// after lockfile churn in this monorepo — lands on a *different* copy
+// of vitest than test files do. Extensions go nowhere and you get
+// `Invalid Chai property: toBeInTheDocument` everywhere. Doing the
+// extend manually pins both sides to the same expect.
+import { expect, afterEach } from "vitest"
+import * as matchers from "@testing-library/jest-dom/matchers"
+import { cleanup } from "@testing-library/react"
+
+expect.extend(matchers)
+
+if (typeof globalThis.ResizeObserver === "undefined") {
+  globalThis.ResizeObserver = class ResizeObserver {
+    observe() {}
+    unobserve() {}
+    disconnect() {}
+  }
+}
+
+// jsdom doesn't implement layout. Plugins using tiptap / ProseMirror
+// call getClientRects on Range/Element instances during scrollIntoView;
+// stub them so transactions don't throw.
+if (typeof Range !== "undefined" && !Range.prototype.getClientRects) {
+  Range.prototype.getClientRects = function () {
+    return { length: 0, item: () => null, [Symbol.iterator]: function* () {} } as any
+  }
+  Range.prototype.getBoundingClientRect = function () {
+    return {
+      x: 0, y: 0, top: 0, left: 0, right: 0, bottom: 0,
+      width: 0, height: 0, toJSON: () => ({}),
+    } as DOMRect
+  }
+}
+
+afterEach(() => {
+  cleanup()
+})

package/templates/plugin/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "types": ["vitest/globals", "@testing-library/jest-dom"],
+    "paths": {
+      "@hachej/boring-workspace": ["../../packages/workspace/src/index.ts"],
+      "@hachej/boring-workspace/server": ["../../packages/workspace/src/server/index.ts"],
+      "@hachej/boring-workspace/events": ["../../packages/workspace/src/front/events/index.ts"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/plugin/tsup.config.ts

@@ -0,0 +1,21 @@
+import { defineConfig } from "tsup"
+
+export default defineConfig({
+  entry: {
+    "front/index": "src/front/index.ts",
+    "server/index": "src/server/index.ts",
+    "shared/index": "src/shared/index.ts",
+  },
+  format: ["esm"],
+  dts: true,
+  splitting: false,
+  clean: true,
+  platform: "neutral",
+  target: "es2022",
+  external: [
+    /^@hachej\/boring-/,
+    "react",
+    "react-dom",
+    "react/jsx-runtime",
+  ],
+})

package/templates/plugin/vitest.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig } from "vitest/config"
+import { resolve } from "node:path"
+import react from "@vitejs/plugin-react"
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      "@hachej/boring-workspace/server": resolve(__dirname, "../../packages/workspace/src/server/index.ts"),
+      "@hachej/boring-workspace/events": resolve(__dirname, "../../packages/workspace/src/front/events/index.ts"),
+      "@hachej/boring-workspace/plugin": resolve(__dirname, "../../packages/workspace/src/plugin.ts"),
+      "@hachej/boring-workspace": resolve(__dirname, "../../packages/workspace/src/index.ts"),
+    },
+  },
+  test: {
+    environment: "jsdom",
+    globals: true,
+    setupFiles: ["./src/test-setup.ts"],
+  },
+})

package/templates/server-canonical.ts

@@ -0,0 +1,42 @@
+// CANONICAL server/index.ts for advanced boring-ui server integration.
+// This is boot-time/static composition only for .pi/extensions plugins:
+// /reload does NOT hot-register these routes or agent tools. Prefer
+// pi.extensions for hot-reloadable agent behavior.
+// Copy this shape only when the host will compose/restart the plugin.
+
+import { defineServerPlugin, type WorkspaceServerPlugin } from "@hachej/boring-workspace/server"
+
+export default function (
+  _options: unknown,
+  ctx: { workspaceRoot: string; bridge: unknown },
+): WorkspaceServerPlugin {
+  return defineServerPlugin({
+    id: "<kebab-name>", // contribution namespace; matching package name is recommended
+    agentTools: [
+      {
+        name: "<snake_case_tool_name>",
+        description: "<what the tool does>",
+        parameters: { type: "object", properties: {} },
+        async execute() {
+          return { content: [{ type: "text", text: "..." }] }
+        },
+      },
+    ],
+    systemPrompt: "Use <snake_case_tool_name> when …",
+  })
+}
+
+// Key rules — agents commonly get these wrong:
+//   - Method is `execute` (NOT `handler`).
+//   - Return shape MUST be `{ content: [{ type: "text", text: "..." }] }`
+//     (NOT a bare string and NOT `{ result: ... }`).
+//   - Import from `@hachej/boring-workspace/server`
+//     (NOT `@hachej/boring-pi` and NOT `@boring-ui/*`).
+//   - Default-export a FUNCTION that returns the plugin object —
+//     do NOT `export const eval_cross_ping = { ... }`.
+//   - package.json must set `boring.server: "server/index.ts"`
+//     (a relative path string). NOT `true` — the manifest validator
+//     rejects `true` with `INVALID_PLUGIN_METADATA`. Valid values:
+//     a path string, OR `false` (no server), OR omit.
+//   - For .pi/extensions user plugins, /reload only refreshes front/Pi
+//     assets. Server entries require static composition plus restart.