opencode-plugin-kit 1.0.0-alpha.6 → 1.0.0-alpha.7

package/README.md

@@ -16,6 +16,12 @@ Published on [npm](https://www.npmjs.com/package/opencode-plugin-kit):
 npm install opencode-plugin-kit
 ```
 
+> **Still a prerelease.** `latest` currently resolves to `1.0.0-alpha.6` — the
+> first OpenCode v2 build. The publish workflow tags every prerelease under
+> its own identifier (`alpha`, `beta`, …) and leaves `latest` alone, so later
+> alphas will _not_ move `latest` automatically. To track the newest build,
+> install `opencode-plugin-kit@alpha`.
+
 Plugins depending on the kit declare it in `dependencies`; the host peer
 (`@opencode/plugin`) must match your OpenCode v2 runtime version (see each
 plugin's README).
@@ -189,6 +195,41 @@ const totals = walkMessages(
 const { input, output, cost } = sumProviderTokens(context, sessionID, "opencode")
 ```
 
+### Collapsible
+
+Imported from the `collapsible` subpath so the Solid JSX stays out of the main
+entry.
+
+```ts
+import { CollapsibleSection, CollapsibleGroup } from "opencode-plugin-kit/collapsible"
+
+// From a host component that already has the plugin context:
+const { theme } = usePlugin()
+
+CollapsibleSection({
+  title: "Skills",
+  count: items.length,
+  threshold: 2,        // Collapse the body at or below this count
+  pinned: <Note />,    // Always visible between header and body
+  theme,               // Header colors; pass the host's theme
+  children: <List />,
+})
+
+CollapsibleGroup({
+  title: "Providers",
+  count: ids.length,
+  defaultCollapsed: true,
+  theme,
+  children: (collapsed) => (collapsed() ? <Summary /> : <List />),
+})
+```
+
+`theme` is optional but **recommended**. Without it the kit falls back to
+`usePlugin()`, which throws when the kit is installed from `node_modules`
+(it resolves its own copy of `@opencode/plugin` / `solid-js`, so the host's
+plugin context is not visible). If the context is missing the header falls back
+to unthemed text rather than throwing.
+
 ## Consuming Plugins
 
 | Plugin                                                                                      | What it does                                                   |
@@ -198,14 +239,30 @@ const { input, output, cost } = sumProviderTokens(context, sessionID, "opencode"
 | [opencode-skill-lister](https://github.com/ranjithrajv/opencode-skill-lister)               | Skills list in sidebar                                         |
 | [opencode-plugin-manager](https://github.com/ranjithrajv/opencode-plugin-manager)           | Plugin manager in sidebar                                      |
 
-Link locally with `"opencode-plugin-kit": "file:../opencode-plugin-kit"` in the
-consumer's `package.json`, then `npm install` (or `bun install`).
+Install from the registry:
+
+```sh
+npm install opencode-plugin-kit@alpha
+```
+
+The `latest` dist-tag tracks the newest v1 alpha; v2 releases ship under the
+`alpha` dist-tag, so pin `opencode-plugin-kit@alpha` (or an explicit range) until
+`latest` moves to v2.
+
+For local development, link the sibling checkout with
+`"opencode-plugin-kit": "file:../opencode-plugin-kit"` in the consumer's
+`package.json`, then `npm install` (or `bun install`). Note that a linked
+checkout shares one module graph with the host, so the collapsible components
+find the plugin context without a `theme` prop; a registry install does not.
 
 ## Compatibility
 
 The OpenCode v2 host plugin API's types are the spec. Kit consumes the context
 structurally — anything the host ships with the expected members satisfies it.
 
+- **Floor: `@opencode/plugin` 2.0.3.** Earlier 2.x releases have no `./tui`
+  subpath export, so nothing that imports `@opencode/plugin/tui` can resolve it.
+  Verified by typecheck and the type-tripwire against 2.0.3, 2.0.10 and 2.0.18.
 - **No runtime dependency** on `@opencode/plugin` — types only
 - **Optional peer** — declared as optional so consumers share one copy
 - **CI tripwire** — `host.test-d.ts` pins published host types against kit's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-plugin-kit",
-  "version": "1.0.0-alpha.6",
+  "version": "1.0.0-alpha.7",
   "description": "Shared building blocks for OpenCode sidebar plugins: provider vocabulary, row formatting, defensive message traversal, connected-provider tracking, polling fetcher, cached resources, and a persisted view/filter picker (registry + slash command + dialog + toast).",
   "keywords": [
     "opencode",
@@ -32,8 +32,9 @@
     "fmt": "vp fmt",
     "lint": "vp lint",
     "typecheck": "tsc --noEmit",
-    "test:types": "vitest run --typecheck",
-    "test:coverage": "vitest run --coverage.enabled"
+    "test": "vp test",
+    "test:types": "vp test --typecheck",
+    "test:coverage": "vp exec vitest run --coverage"
   },
   "devDependencies": {
     "@opencode/plugin": "2.0.15",
@@ -53,7 +54,7 @@
     "zod": "^4.5.4"
   },
   "peerDependencies": {
-    "@opencode/plugin": "^2.0.15",
+    "@opencode/plugin": "^2.0.3",
     "solid-js": "^1.9.12",
     "zod": "^4.5.4"
   },

package/src/collapsible.tsx

@@ -14,6 +14,39 @@ import { createSignal, Show } from "solid-js"
 import type { JSX } from "solid-js"
 import { usePlugin } from "@opencode/plugin/tui"
 
+/**
+ * Theme tokens a collapsible header needs. Derived from the host theme so
+ * callers can pass their `usePlugin().theme` straight through, and so we
+ * don't pin the host's color type (e.g. `RGBA`) here.
+ */
+type HostTheme = ReturnType<typeof usePlugin>["theme"]
+export interface CollapsibleTheme {
+  text: {
+    base?: HostTheme["text"]["base"]
+    muted?: HostTheme["text"]["muted"]
+  }
+}
+
+/**
+ * Resolve the theme for a header.
+ *
+ * Prefer an explicitly passed `theme`. When this package is consumed from
+ * `node_modules`, `usePlugin()` here resolves a different copy of
+ * `@opencode/plugin` (and `solid-js`) than the host renders with, so the
+ * host's plugin context is not visible and `usePlugin()` throws
+ * "PluginContextProvider is missing". Callers that already hold the host
+ * context pass `theme` down; the `usePlugin()` fallback keeps working for
+ * consumers whose module graph is deduped (tests, monorepos).
+ */
+function resolveTheme(explicit?: CollapsibleTheme): CollapsibleTheme {
+  if (explicit) return explicit
+  try {
+    return usePlugin().theme
+  } catch {
+    return { text: {} }
+  }
+}
+
 /** The top-level collapsible sidebar section. */
 export function CollapsibleSection(props: {
   title: string
@@ -26,9 +59,11 @@ export function CollapsibleSection(props: {
   /** Always-visible content between the header and the collapsible body
    * (e.g. the plugin manager's status note). */
   pinned?: JSX.Element
+  /** Header colors; pass the host's `usePlugin().theme` from the consumer. */
+  theme?: CollapsibleTheme
   children: JSX.Element
 }) {
-  const theme = usePlugin().theme
+  const theme = resolveTheme(props.theme)
   const [expanded, setExpanded] = createSignal(false)
   const count = () => props.count ?? 0
   const threshold = () => props.threshold ?? 2
@@ -62,9 +97,11 @@ export function CollapsibleGroup(props: {
   title: string
   count: number
   defaultCollapsed?: boolean
+  /** Header colors; pass the host's `usePlugin().theme` from the consumer. */
+  theme?: CollapsibleTheme
   children: JSX.Element | ((collapsed: () => boolean) => JSX.Element)
 }) {
-  const theme = usePlugin().theme
+  const theme = resolveTheme(props.theme)
   const [collapsed, setCollapsed] = createSignal(props.defaultCollapsed ?? false)
   return (
     <box flexDirection="column">

package/src/toast.ts

@@ -2,7 +2,7 @@
 //
 // The host's toast UI is optional at the edges (beta API): every plugin
 // hand-rolled the same try/catch fallback around `ui.toast.show`.
-import type { KitContext, KitUI, ToastInput } from "./host.ts"
+import type { KitUI, ToastInput } from "./host.ts"
 
 /** Show a toast; silently no-ops when the host has no toast UI or it throws.
  * Takes a minimal structural slice — the full host context's `ui.slot` is