elowen-plugin-ui-kit 0.2.0 → 0.5.0

package/index.d.ts

@@ -10,7 +10,36 @@ import type { ComponentType } from 'react';
 /** See index.js — bump on incompatible changes to `ElowenUiRuntime`. Deliberately a LITERAL type:
  *  the web app re-declares the value and annotates it with `typeof PLUGIN_UI_API_VERSION`, so a kit
  *  bump that forgets the host fails the web typecheck instead of drifting silently. */
-export declare const PLUGIN_UI_API_VERSION: 1;
+export declare const PLUGIN_UI_API_VERSION: 6;
+
+/** Project metadata exposed to a contextual plugin panel. The Project remains core-owned; a panel uses
+ *  this identity to address only its own project-scoped API data. */
+export interface PluginUiProject {
+  id: number;
+  slug: string;
+  path: string;
+  notes: string;
+  icon?: string;
+}
+
+/** The selected core User DTO exposed only to administrator user-detail panels. Compatibility fields stay
+ * present because plugins receive the same object as the host Users screen, not a second partial identity. */
+export interface PluginUiUser {
+  id: number;
+  username: string;
+  created_at: string;
+  is_admin: boolean;
+  allowed_execs: string[];
+  disabled_tools: string[];
+  allowed_tools: string[];
+  granted_plugins: string[];
+  name: string;
+  email: string;
+  avatar: string;
+  default_exec: string;
+  advisor_exec: string;
+  advisor_autostart: boolean;
+}
 
 /** Props every plugin page/settings component receives. */
 export interface PluginPageProps {
@@ -33,12 +62,32 @@ export interface PluginPageProps {
   onSaveState?: (status: 'idle' | 'saving' | 'saved' | 'error', retry?: () => void) => void;
 }
 
+/** Props for a contextual Project panel. It is never a standalone route: the selected Project and panel
+ *  id come from the host's Project detail rail. */
+export interface PluginProjectPanelProps {
+  plugin: string;
+  panelId: string;
+  project: PluginUiProject;
+  surface: 'project';
+}
+
+/** Props for an administrator panel mounted for one selected core User. */
+export interface PluginUserPanelProps {
+  plugin: string;
+  panelId: string;
+  user: PluginUiUser;
+  surface: 'user';
+}
+
 /** What a bundle hands to window.__elowenRegisterPluginUi. Routes are `/`-joined segment patterns
- *  (`''` = the root page, `detail/:id` captures params). `settings` components are keyed by the
- *  manifest's `web.settings[].id` and render inside the Settings page's control deck. */
+ *  (`''` = the root page, `detail/:id` captures params). Contextual component maps are keyed by their
+ *  matching manifest panel ids and mount only in the corresponding host surface. */
 export interface PluginUiRegistration {
   requiresApiVersion: number;
   pages?: Record<string, ComponentType<PluginPageProps>>;
+  account?: Record<string, ComponentType<PluginPageProps>>;
+  user?: Record<string, ComponentType<PluginUserPanelProps>>;
+  project?: Record<string, ComponentType<PluginProjectPanelProps>>;
   settings?: Record<string, ComponentType<PluginPageProps>>;
 }
 

package/index.js

@@ -2,4 +2,4 @@
  *  `window.ElowenUiRuntime` stamped with this number; a bundle whose `requiresApiVersion` is NEWER
  *  renders a placeholder instead of executing against a contract it was not built for. Bump on
  *  incompatible changes to the `ElowenUiRuntime` surface (see index.d.ts). */
-export const PLUGIN_UI_API_VERSION = 1;
+export const PLUGIN_UI_API_VERSION = 5;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elowen-plugin-ui-kit",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "description": "Contract types and esbuild toolchain for building Elowen plugin browser-UI bundles.",
   "license": "MIT",
   "type": "module",