fluxplugin 1.0.0 → 1.0.2

package/dist/node/index.js

@@ -17,6 +17,7 @@ import {
   MGMT,
   MemoryStorageBackend,
   MenuRegistry,
+  NotificationCenter,
   PermissionDeniedError,
   PermissionManager,
   PluginManager,
@@ -65,8 +66,10 @@ import {
   serializeError,
   toDisposable,
   validateManifest,
+  videoEmbedUrl,
   withTimeout
-} from "./chunks/chunk-XPLGAEBH.js";
+} from "./chunks/chunk-EVX2O65A.js";
+import "./chunks/chunk-WSFCRVEQ.js";
 export {
   BUILTIN_PERMISSIONS,
   CHANNELS,
@@ -86,6 +89,7 @@ export {
   MGMT,
   MemoryStorageBackend,
   MenuRegistry,
+  NotificationCenter,
   PermissionDeniedError,
   PermissionManager,
   PluginManager,
@@ -134,5 +138,6 @@ export {
   serializeError,
   toDisposable,
   validateManifest,
+  videoEmbedUrl,
   withTimeout
 };

package/dist/node/main.js

@@ -1,5 +1,8 @@
 import {
+  DEFAULT_STORE,
+  DEFAULT_TOPIC,
   FsStorageBackend,
+  GitHubRegistry,
   HttpRegistry,
   IntegrityError,
   JsonStateFile,
@@ -13,13 +16,18 @@ import {
   canonicalJson,
   computeIntegrity,
   copyDir,
+  copyPluginRuntime,
   createLoopbackBridge,
+  createRegistries,
   createTarGz,
   discoverPlugins,
+  entriesFromIndex,
   extractTarGz,
   generateSigningKeyPair,
   importFresh,
+  pruneNonRuntime,
   readPluginDir,
+  readPluginManifest,
   readTarGz,
   registerPluginProtocol,
   resolvePluginAsset,
@@ -27,10 +35,14 @@ import {
   sha256File,
   signManifest,
   verifyPlugin
-} from "./chunks/chunk-BZ7NZF7I.js";
-import "./chunks/chunk-XPLGAEBH.js";
+} from "./chunks/chunk-C7VWZZOX.js";
+import "./chunks/chunk-EVX2O65A.js";
+import "./chunks/chunk-WSFCRVEQ.js";
 export {
+  DEFAULT_STORE,
+  DEFAULT_TOPIC,
   FsStorageBackend,
+  GitHubRegistry,
   HttpRegistry,
   IntegrityError,
   JsonStateFile,
@@ -44,13 +56,18 @@ export {
   canonicalJson,
   computeIntegrity,
   copyDir,
+  copyPluginRuntime,
   createLoopbackBridge,
+  createRegistries,
   createTarGz,
   discoverPlugins,
+  entriesFromIndex,
   extractTarGz,
   generateSigningKeyPair,
   importFresh,
+  pruneNonRuntime,
   readPluginDir,
+  readPluginManifest,
   readTarGz,
   registerPluginProtocol,
   resolvePluginAsset,

package/dist/node/preload.js

@@ -1,6 +1,7 @@
 import {
   CHANNELS
-} from "./chunks/chunk-XPLGAEBH.js";
+} from "./chunks/chunk-EVX2O65A.js";
+import "./chunks/chunk-WSFCRVEQ.js";
 
 // src/preload/index.ts
 var IpcCallError = class extends Error {

package/dist/types/cli/build.d.ts

@@ -1,6 +1,6 @@
 import { type BuildOptions } from "esbuild";
 /** Convention: dist/X is built from src/X (main.ts, renderer.tsx, styles/*.css). */
-export declare function buildOptions(root: string): Promise<BuildOptions[]>;
+export declare function buildOptions(root: string, dev?: boolean): Promise<BuildOptions[]>;
 export declare function buildPlugin(root: string, watch?: boolean, log?: {
     (...data: any[]): void;
     (message?: any, ...optionalParams: any[]): void;

package/dist/types/cli/config.d.ts

@@ -1,6 +1,9 @@
+import { type StoreSpec } from "../main/index.js";
 export interface CliConfig {
     pluginsDir: string;
     dataDir: string;
+    /** Plugin stores used by `search` / `install <id>` (same list your app uses). Default: the GitHub topic store. */
+    stores: StoreSpec[];
 }
 /** Resolves `--dir/--data` flags, then `fluxplugin.config.json` in the cwd, then defaults. */
 export declare function loadConfig(flags: {

package/dist/types/cli/host-files.generated.d.ts

@@ -0,0 +1,2 @@
+export declare const HOST_APP_FILES: Record<string, string>;
+export declare const HOST_TAILWIND_FILES: Record<string, string>;

package/dist/types/cli/host-templates.d.ts

@@ -1,6 +1,9 @@
 export interface HostVars {
     name: string;
     fluxSpec: string;
+    /** Electron semver range (init resolves the latest published version). */
+    electron?: string;
+    tailwind?: boolean;
 }
 /** Files of a new host application (`fluxplugin init`). Plain strings so the CLI stays a single self-contained file. */
 export declare function hostFiles(v: HostVars, withSample?: boolean): Record<string, string>;

package/dist/types/cli/host.d.ts

@@ -5,11 +5,20 @@ export declare function buildHost(cwd: string, opts?: {
     watch?: boolean;
     log?: (m: string) => void;
 }): Promise<() => Promise<void>>;
-/** Starts the app: Electron when available (unless `web`), otherwise browser mode. Resolves when it exits. */
+/**
+ * Returns the Electron binary, downloading it if the package manager skipped Electron's postinstall
+ * (npm 11.16+/12 block install scripts by default, pnpm 10 too). This is the same download `npm i electron` does.
+ */
+export declare function ensureElectron(cwd: string, log?: (m: string) => void): {
+    bin?: string;
+    error?: string;
+};
+/** Starts the app: Electron by default, browser mode with `web`. Throws a readable error if Electron cannot run. */
 export declare function startApp(cwd: string, opts?: {
     web?: boolean;
     dev?: boolean;
     port?: number;
+    log?: (m: string) => void;
 }): {
     child: ChildProcess;
     mode: "electron" | "web";

package/dist/types/cli/package.d.ts

@@ -0,0 +1,18 @@
+import { type PluginManifest } from "../core/index.js";
+export interface PackageResult {
+    file: string;
+    descriptorFile: string;
+    sha256: string;
+    manifest: PluginManifest;
+    shipped: string[];
+    signed: boolean;
+}
+/**
+ * Builds the plugin (no sourcemaps) and writes `<id>-<version>.tgz` + `<id>-<version>.fluxplugin.json` (the descriptor stores
+ * read to list the plugin without downloading it). Only runtime files are packaged: plugin.json, dist/, assets/, README/LICENSE.
+ */
+export declare function packagePlugin(root: string, opts?: {
+    out?: string;
+    signKey?: string;
+    log?: (m: string) => void;
+}): Promise<PackageResult>;

package/dist/types/cli/publish.d.ts

@@ -0,0 +1,23 @@
+export interface PublishOptions {
+    repo?: string;
+    token?: string;
+    signKey?: string;
+    dryRun?: boolean;
+    topic?: string;
+    apiBase?: string;
+    fetchImpl?: typeof fetch;
+    log?: (m: string) => void;
+}
+/** "https://github.com/acme/tool.git" | "git@github.com:acme/tool.git" | "acme/tool" → "acme/tool" */
+export declare function parseGitHubRepo(input: string | undefined): string | undefined;
+/**
+ * Publishes a plugin to the default store: builds + packages it, creates a GitHub release `v<version>` in the plugin's
+ * repository, uploads the package and its descriptor, and adds the discovery topic. Anyone using the store can then find and
+ * install it. Needs a token that can write to the repository (GITHUB_TOKEN / GH_TOKEN / --token).
+ */
+export declare function publishPlugin(root: string, o?: PublishOptions): Promise<{
+    release?: string;
+    repo: string;
+    version: string;
+    id: string;
+}>;

package/dist/types/cli/store.d.ts

@@ -0,0 +1,7 @@
+export declare function storeInit(dir: string): Promise<void>;
+/** Adds (or updates) a package in the store folder and rewrites index.json. */
+export declare function storeAdd(pkgFile: string, dir: string, baseUrl?: string): Promise<{
+    id: string;
+    version: string;
+    sha256: string;
+}>;

package/dist/types/cli/tailwind.d.ts

@@ -0,0 +1,10 @@
+/** Finds `@tailwindcss/cli` (Tailwind v4) from the given folders (a plugin folder usually has no node_modules: the app's is used). */
+export declare function resolveTailwindCli(startDirs: string[]): string | undefined;
+/** Compiles a Tailwind entry CSS to `output`. With `watch` it keeps running and returns a function that stops it. */
+export declare function compileTailwind(opts: {
+    cwd: string;
+    input: string;
+    output: string;
+    watch?: boolean;
+    searchFrom?: string[];
+}, log?: (m: string) => void): () => void;

package/dist/types/cli/templates.d.ts

@@ -8,3 +8,5 @@ export interface TemplateVars {
 }
 export declare const TEMPLATES: Record<TemplateName, (v: TemplateVars) => Record<string, string>>;
 export declare function varsFromName(name: string): TemplateVars;
+/** Adds Tailwind v4 to a plugin: utilities only (no preflight, so the host's styles are never reset). */
+export declare function withTailwind(files: Record<string, string>, v: TemplateVars): Record<string, string>;

package/dist/types/core/index.d.ts

@@ -16,3 +16,4 @@ export * from "./plugin.js";
 export * from "./manager.js";
 export * from "./protocol.js";
 export * from "./api.js";
+export * from "./notifications.js";

package/dist/types/core/manager.d.ts

@@ -10,6 +10,7 @@ import { RouteRegistry } from "./routes.js";
 import { ExtensionPointRegistry, SlotRegistry } from "./slots.js";
 import { type PluginConfig, type PluginState_, type StorageBackend } from "./storage.js";
 import { StyleRegistry } from "./styles.js";
+import { NotificationCenter } from "./notifications.js";
 export interface PluginSource {
     /** Raw manifest (validated on registration). */
     manifest: unknown;
@@ -72,6 +73,7 @@ export declare class PluginManager {
     readonly ipc: IpcRegistry;
     readonly preload: PreloadRegistry;
     readonly styles: StyleRegistry;
+    readonly notifications: NotificationCenter;
     readonly storageBackend: StorageBackend;
     private readonly records;
     private readonly states;

package/dist/types/core/manifest.d.ts

@@ -12,6 +12,10 @@ export declare const manifestSchema: import("./schema.js").Schema<{
     id: string;
     name: string;
     version: string;
+    screenshots: string[];
+    categories: string[];
+    keywords: string[];
+    links: Record<string, string>;
     activationEvents: string[];
     deactivationEvents: string[];
     permissions: Permission[];
@@ -57,6 +61,9 @@ export declare const manifestSchema: import("./schema.js").Schema<{
     } | undefined;
     license?: string | undefined;
     icon?: string | undefined;
+    banner?: string | undefined;
+    readme?: string | undefined;
+    video?: string | undefined;
     main?: string | undefined;
     preload?: string | undefined;
     renderer?: string | undefined;
@@ -86,3 +93,5 @@ export interface ManifestValidation {
 export declare function validateManifest(raw: unknown, opts?: {
     frameworkVersion?: string;
 }): ManifestValidation;
+/** Turns a YouTube/Vimeo URL into a privacy-friendly embed URL; returns undefined for any other host. */
+export declare function videoEmbedUrl(url: string | undefined): string | undefined;

package/dist/types/core/notifications.d.ts

@@ -0,0 +1,48 @@
+import { type Disposable } from "./common.js";
+export type NotificationLevel = "info" | "success" | "warning" | "error";
+export interface NotificationAction {
+    label: string;
+    /** Command executed when the user clicks the action. */
+    command: string;
+    args?: unknown[];
+}
+export interface NotificationInput {
+    id?: string;
+    title: string;
+    body?: string;
+    level?: NotificationLevel;
+    actions?: NotificationAction[];
+    /** Toast duration in ms; 0 keeps it only in the notification center. Default 5000. */
+    timeoutMs?: number;
+}
+export interface NotificationItem extends Required<Pick<NotificationInput, "id" | "title" | "level">> {
+    body?: string;
+    actions: NotificationAction[];
+    timeoutMs: number;
+    owner: string;
+    time: number;
+    read: boolean;
+}
+/** In-app notification center (bell + toasts). Plugins push through `ctx.notifications.push` (permission "notifications"). */
+export declare class NotificationCenter {
+    private readonly capacity;
+    private items;
+    private listeners;
+    private pushListeners;
+    private seq;
+    version: number;
+    constructor(capacity?: number);
+    push(input: NotificationInput, owner?: string): {
+        id: string;
+        dismiss(): void;
+    };
+    list(): NotificationItem[];
+    get unread(): number;
+    markRead(id?: string): void;
+    dismiss(id: string): void;
+    clear(): void;
+    subscribe: (l: () => void) => (() => void);
+    /** Called for every new notification (toast host, native bridges, main→renderer forwarding). */
+    onPush(l: (n: NotificationItem) => void): Disposable;
+    private changed;
+}

package/dist/types/core/plugin.d.ts

@@ -89,6 +89,13 @@ export interface PluginContext<Cfg extends Record<string, any> = Record<string,
     readonly styles: {
         add(style: StyleInput): Disposable;
     };
+    /** Bell + toasts in the host UI (permission "notifications"). */
+    readonly notifications: {
+        push(n: import("./notifications.js").NotificationInput): {
+            id: string;
+            dismiss(): void;
+        };
+    };
     /** Controlled APIs exposed by the host (see `host.provide`), permission-checked per plugin. */
     readonly host: {
         api<T = unknown>(name: string): T;

package/dist/types/core/protocol.d.ts

@@ -70,6 +70,7 @@ export declare const MGMT: {
     readonly configSchema: "flux.plugins.config.schema";
     readonly logs: "flux.plugins.logs";
     readonly diagnostics: "flux.plugins.diagnostics";
+    readonly details: "flux.plugins.details";
     readonly changed: "flux.plugins.changed";
 };
 /** Serializable description of a plugin offered by a registry (marketplace entry). */
@@ -83,4 +84,30 @@ export interface RegistryEntryLike {
     location: string;
     source: string;
     sha256?: string;
+    homepage?: string;
+    stars?: number;
+    icon?: string;
+}
+/** Everything a UI needs to render a plugin "store page": icon, banner, screenshots, video, long description. */
+export interface PluginDetails {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    license?: string;
+    homepage?: string;
+    repository?: string;
+    categories: string[];
+    keywords: string[];
+    links: Record<string, string>;
+    iconUrl?: string;
+    bannerUrl?: string;
+    screenshotUrls: string[];
+    video?: {
+        url: string;
+        embedUrl?: string;
+    };
+    /** Markdown source of the long description (rendered by the UI without raw HTML). */
+    readme?: string;
 }

package/dist/types/main/framework.d.ts

@@ -1,6 +1,7 @@
-import { LogStore, PluginManager, type Bootstrap, type InvokeRequest, type InvokeResponse, type PluginManagerOptions } from "../core/index.js";
+import { LogStore, PluginManager, type Bootstrap, type PluginDetails, type InvokeRequest, type InvokeResponse, type PluginManagerOptions } from "../core/index.js";
 import { type DiscoverOptions } from "./discover.js";
 import { PluginInstaller, type PluginRegistry } from "./registry.js";
+import { type StoreSpec } from "./stores.js";
 export interface MainFrameworkOptions {
     /** Directories scanned for plugins (each sub-directory with a plugin.json). */
     pluginDirs: string[];
@@ -8,7 +9,10 @@ export interface MainFrameworkOptions {
     dataDir: string;
     /** Where installs/uninstalls happen. Defaults to the first of `pluginDirs`. */
     installDir?: string;
+    /** Plugin stores (default: GitHub topic store). Ready-made registries, or `stores` specs below. */
     registries?: PluginRegistry[];
+    /** Store specs, same shape as `fluxplugin.config.json` → "stores". Ignored when `registries` is given. */
+    stores?: StoreSpec[];
     /** Third-party plugins start with no permissions until the user approves them. Default: false (all declared granted). */
     requireApproval?: boolean;
     /** Reject plugins without a valid signature from one of these keys. */
@@ -65,6 +69,8 @@ export declare class MainFramework {
     handleInvoke(req: InvokeRequest, senderId?: number | string): Promise<InvokeResponse>;
     handleSend(channel: string, payload: unknown, caller?: string, senderId?: number | string): void;
     private registerManagementApi;
+    /** Store-page data for one plugin: icon, banner, screenshots, video and the README (Markdown). */
+    details(id: string): Promise<PluginDetails>;
     private requireConfig;
     private installAndLoad;
     /** Channels used by transports. */

package/dist/types/main/github-registry.d.ts

@@ -0,0 +1,49 @@
+import { type PluginRegistry, type RegistryEntry } from "./registry.js";
+import type { PluginManifest } from "../core/index.js";
+export declare const DEFAULT_TOPIC = "fluxplugin-plugin";
+export interface GitHubRegistryOptions {
+    /** Curated catalog: a repository holding `index.json` (see `fluxplugin store add`), e.g. "acme/plugin-store". */
+    repo?: string;
+    ref?: string;
+    indexPath?: string;
+    /** Decentralized discovery: every public repo with this topic and a release containing a `.fluxplugin.json` descriptor. */
+    topic?: string;
+    /** Lifts GitHub's anonymous rate limit (60 req/h). Only ever sent to GitHub hosts. */
+    token?: string;
+    name?: string;
+    apiBase?: string;
+    rawBase?: string;
+    fetchImpl?: typeof fetch;
+}
+export interface PluginDescriptor {
+    id: string;
+    name?: string;
+    version: string;
+    description?: string;
+    author?: string;
+    permissions?: string[];
+    file: string;
+    sha256: string;
+    icon?: string;
+}
+/**
+ * GitHub as a plugin store. Two modes (they can be combined by adding two registries):
+ *  - `topic` (default): developers publish a GitHub *release* in their own repo with `fluxplugin publish`; it is discovered
+ *    through the repository topic. No central approval.
+ *  - `repo`: a curated catalog repository with an `index.json`.
+ */
+export declare class GitHubRegistry implements PluginRegistry {
+    private readonly o;
+    readonly name: string;
+    private cache;
+    constructor(o?: GitHubRegistryOptions);
+    private get api();
+    private get raw();
+    private trusted;
+    private get;
+    private json;
+    search(query?: string): Promise<RegistryEntry[]>;
+    private catalog;
+    private discover;
+    fetch(entry: RegistryEntry, dest: string): Promise<PluginManifest>;
+}

package/dist/types/main/index.d.ts

@@ -6,3 +6,5 @@ export * from "./registry.js";
 export * from "./fs-storage.js";
 export * from "./tar.js";
 export * from "./serve-web.js";
+export * from "./github-registry.js";
+export * from "./stores.js";

package/dist/types/main/registry.d.ts

@@ -12,6 +12,9 @@ export interface RegistryEntry {
     source: string;
     /** sha256 hex of the archive when the registry knows it. */
     sha256?: string;
+    homepage?: string;
+    stars?: number;
+    icon?: string;
 }
 /**
  * Abstraction over where plugins come from. Implement it for npm, GitHub releases, a private HTTP registry,
@@ -23,7 +26,34 @@ export interface PluginRegistry {
     /** Materializes a plugin into `destDir` (which does not exist yet). Returns its manifest. */
     fetch(entry: RegistryEntry, destDir: string): Promise<PluginManifest>;
 }
+export declare function readPluginManifest(dir: string): Promise<{
+    raw: Record<string, unknown>;
+    manifest: PluginManifest;
+}>;
+/**
+ * Copies only what a *distributed* plugin needs at runtime: plugin.json, dist/, assets/, README/LICENSE/CHANGELOG and any
+ * file the manifest references. Source code (`src/`, .ts/.tsx, sourcemaps), node_modules and tooling files never ship.
+ */
+export declare function copyPluginRuntime(src: string, dest: string): Promise<string[]>;
 export declare function copyDir(src: string, dest: string): Promise<void>;
+/** Shape of a store catalog (`index.json`). Used by HTTP stores, GitHub catalog stores and `fluxplugin store add`. */
+export interface StoreIndex {
+    plugins: {
+        id: string;
+        name?: string;
+        version: string;
+        description?: string;
+        author?: string;
+        permissions?: string[];
+        url: string;
+        sha256?: string;
+        homepage?: string;
+        icon?: string;
+    }[];
+}
+export declare function entriesFromIndex(index: StoreIndex, baseUrl: string, source: string, query?: string): RegistryEntry[];
+/** Removes everything that is not runtime code from an extracted plugin: sources, TypeScript, sourcemaps, node_modules. */
+export declare function pruneNonRuntime(dir: string): Promise<string[]>;
 /** A directory whose sub-directories are plugins (e.g. a shared network folder or a repo checkout). */
 export declare class LocalRegistry implements PluginRegistry {
     private readonly dir;

package/dist/types/main/stores.d.ts

@@ -0,0 +1,29 @@
+import { type PluginRegistry } from "./registry.js";
+/**
+ * A plugin store, as written in `fluxplugin.config.json` → `"stores"` (or passed to `MainFramework`).
+ *  - `github` + `topic`: every repo with that topic that published a release with `fluxplugin publish` (default store)
+ *  - `github` + `repo`:  a curated catalog repository ("owner/name") containing `index.json`
+ *  - `http`:             any static host serving `index.json` + `.tgz` files (GitHub Pages, S3, your server)
+ *  - `local`:            a folder (network share, checkout)
+ */
+export type StoreSpec = {
+    type: "github";
+    topic?: string;
+    repo?: string;
+    ref?: string;
+    indexPath?: string;
+    name?: string;
+} | {
+    type: "http";
+    url: string;
+} | {
+    type: "local";
+    path: string;
+};
+export declare const DEFAULT_STORE: StoreSpec;
+/** Builds registries from store specs. The GitHub token (if any) comes from GITHUB_TOKEN / GH_TOKEN, never from config files. */
+export declare function createRegistries(specs?: StoreSpec[], opts?: {
+    env?: Record<string, string | undefined>;
+    baseDir?: string;
+    fetchImpl?: typeof fetch;
+}): PluginRegistry[];

package/dist/types/react/base-css.d.ts

@@ -1,2 +1,2 @@
 /** Minimal CSS for the framework's own components. Uses CSS variables so hosts can theme it; Tailwind is not required. */
-export declare const baseCss = "\n:root{--flux-bg:#fff;--flux-fg:#0f172a;--flux-muted:#64748b;--flux-border:#e2e8f0;--flux-accent:#4f46e5;--flux-accent-fg:#fff;--flux-surface:#f8fafc;--flux-danger:#dc2626;--flux-ok:#16a34a;--flux-warn:#d97706;--flux-radius:10px}\n@media (prefers-color-scheme: dark){:root:not([data-theme=\"light\"]){--flux-bg:#0b1020;--flux-fg:#e5e7eb;--flux-muted:#94a3b8;--flux-border:#1f2a44;--flux-surface:#111936}}\n.fluxplugin-error{padding:8px 12px;border:1px solid var(--flux-danger);border-radius:var(--flux-radius);color:var(--flux-danger);font-size:13px}\n.flux-breadcrumbs{font-size:13px;color:var(--flux-muted)}.flux-breadcrumbs a{color:inherit}\n.flux-not-found,.flux-forbidden,.flux-loading{padding:24px;color:var(--flux-muted)}\n.flux-palette-backdrop{position:fixed;inset:0;background:rgba(2,6,23,.45);display:flex;justify-content:center;align-items:flex-start;padding-top:14vh;z-index:9999}\n.flux-palette{width:min(560px,92vw);background:var(--flux-bg);color:var(--flux-fg);border:1px solid var(--flux-border);border-radius:14px;box-shadow:0 24px 60px rgba(0,0,0,.35);overflow:hidden}\n.flux-palette-input{width:100%;box-sizing:border-box;padding:14px 16px;border:0;border-bottom:1px solid var(--flux-border);background:transparent;color:inherit;font-size:15px;outline:none}\n.flux-palette-list{list-style:none;margin:0;padding:6px;max-height:340px;overflow:auto}\n.flux-palette-item{display:flex;justify-content:space-between;align-items:center;gap:12px;padding:9px 12px;border-radius:8px;cursor:pointer;font-size:14px}\n.flux-palette-item.is-active{background:var(--flux-accent);color:var(--flux-accent-fg)}\n.flux-palette-cat{opacity:.65}.flux-palette-empty{padding:14px;color:var(--flux-muted);font-size:14px}\n.flux-palette kbd{font:11px ui-monospace,monospace;padding:2px 6px;border:1px solid currentColor;border-radius:5px;opacity:.7}\n";
+export declare const baseCss = "\n:root{--flux-bg:#fff;--flux-fg:#0f172a;--flux-muted:#64748b;--flux-border:#e2e8f0;--flux-accent:#4f46e5;--flux-accent-fg:#fff;--flux-surface:#f8fafc;--flux-danger:#dc2626;--flux-ok:#16a34a;--flux-warn:#d97706;--flux-radius:10px}\n@media (prefers-color-scheme: dark){:root:not([data-theme=\"light\"]){--flux-bg:#0b1020;--flux-fg:#e5e7eb;--flux-muted:#94a3b8;--flux-border:#1f2a44;--flux-surface:#111936}}\n.fluxplugin-error{padding:8px 12px;border:1px solid var(--flux-danger);border-radius:var(--flux-radius);color:var(--flux-danger);font-size:13px}\n.flux-breadcrumbs{font-size:13px;color:var(--flux-muted)}.flux-breadcrumbs a{color:inherit}\n.flux-not-found,.flux-forbidden,.flux-loading{padding:24px;color:var(--flux-muted)}\n.flux-palette-backdrop{position:fixed;inset:0;background:rgba(2,6,23,.45);display:flex;justify-content:center;align-items:flex-start;padding-top:14vh;z-index:9999}\n.flux-palette{width:min(560px,92vw);background:var(--flux-bg);color:var(--flux-fg);border:1px solid var(--flux-border);border-radius:14px;box-shadow:0 24px 60px rgba(0,0,0,.35);overflow:hidden}\n.flux-palette-input{width:100%;box-sizing:border-box;padding:14px 16px;border:0;border-bottom:1px solid var(--flux-border);background:transparent;color:inherit;font-size:15px;outline:none}\n.flux-palette-list{list-style:none;margin:0;padding:6px;max-height:340px;overflow:auto}\n.flux-palette-item{display:flex;justify-content:space-between;align-items:center;gap:12px;padding:9px 12px;border-radius:8px;cursor:pointer;font-size:14px}\n.flux-palette-item.is-active{background:var(--flux-accent);color:var(--flux-accent-fg)}\n.flux-palette-cat{opacity:.65}.flux-palette-empty{padding:14px;color:var(--flux-muted);font-size:14px}\n.flux-palette kbd{font:11px ui-monospace,monospace;padding:2px 6px;border:1px solid currentColor;border-radius:5px;opacity:.7}\n\n:root[data-theme=\"dark\"]{--flux-bg:#0b1020;--flux-fg:#e5e7eb;--flux-muted:#94a3b8;--flux-border:#1f2a44;--flux-surface:#111936}\n:root[data-theme=\"light\"]{--flux-bg:#fff;--flux-fg:#0f172a;--flux-muted:#64748b;--flux-border:#e2e8f0;--flux-surface:#f8fafc}\n.flux-icon{flex:none;vertical-align:middle}\n.flux-titlebar{--flux-titlebar-h:40px;height:var(--flux-titlebar-h);box-sizing:border-box;display:grid;grid-template-columns:1fr minmax(160px,400px) 1fr;align-items:center;gap:8px;padding:0 8px;background:var(--flux-surface);border-bottom:1px solid var(--flux-border);color:var(--flux-fg);-webkit-app-region:drag;user-select:none;position:relative;z-index:50}\n.flux-titlebar[data-electron][data-os=\"mac\"]{padding-left:82px}\n.flux-titlebar[data-electron][data-os=\"windows\"],.flux-titlebar[data-electron][data-os=\"linux\"]{padding-right:calc(100vw - env(titlebar-area-x,0px) - env(titlebar-area-width,100vw) + 8px)}\n.flux-titlebar button,.flux-titlebar input,.flux-titlebar select,.flux-titlebar .flux-dropdown{-webkit-app-region:no-drag}\n.flux-tb-left,.flux-tb-right{display:flex;align-items:center;gap:4px;min-width:0}.flux-tb-right{justify-content:flex-end}\n.flux-brand{display:flex;align-items:center;gap:8px;font-weight:600;margin-right:8px;white-space:nowrap}\n.flux-tb-btn{display:inline-flex;align-items:center;gap:6px;border:0;background:transparent;color:inherit;border-radius:6px;padding:5px 9px;font:inherit;cursor:pointer;position:relative}\n.flux-tb-btn:hover,.flux-tb-btn.is-open{background:var(--flux-border)}\n.flux-menubar{display:flex}.flux-menu{position:relative}\n.flux-dropdown{position:absolute;top:calc(100% + 4px);left:0;min-width:220px;max-width:360px;margin:0;padding:6px;list-style:none;background:var(--flux-bg);color:var(--flux-fg);border:1px solid var(--flux-border);border-radius:10px;box-shadow:0 14px 36px rgba(0,0,0,.28);z-index:60}\n.flux-dd-item{display:flex;justify-content:space-between;align-items:center;gap:16px;width:100%;border:0;background:transparent;color:inherit;font:inherit;text-align:left;padding:7px 10px;border-radius:7px;cursor:pointer}\n.flux-dd-item:hover,.flux-dd-item.is-active{background:var(--flux-accent);color:var(--flux-accent-fg)}\n.flux-dd-item kbd,.flux-dd-item small{opacity:.65;font:11px ui-monospace,monospace}.flux-sep{height:1px;background:var(--flux-border);margin:5px 4px}\n.flux-search{position:relative;display:flex;align-items:center;gap:8px;background:var(--flux-bg);border:1px solid var(--flux-border);border-radius:8px;padding:0 10px;height:28px;color:var(--flux-muted)}\n.flux-search input{flex:1;min-width:0;border:0;background:transparent;color:var(--flux-fg);font:inherit;outline:none}\n.flux-search-results{left:0;right:0;max-width:none;top:calc(100% + 6px)}.flux-group{font-size:11px;text-transform:uppercase;letter-spacing:.04em;color:var(--flux-muted);padding:6px 10px 2px}\n.flux-empty{padding:12px;color:var(--flux-muted);font-size:13px}.flux-select{margin-left:4px;background:var(--flux-bg);color:inherit;border:1px solid var(--flux-border);border-radius:6px;padding:3px 4px;font:inherit}\n.flux-bell{position:relative}.flux-badge{position:absolute;top:0;right:0;min-width:15px;height:15px;border-radius:99px;background:var(--flux-danger);color:#fff;font-size:10px;line-height:15px;text-align:center}\n.flux-notif-panel{left:auto;right:0;width:340px;max-height:420px;overflow:auto;padding:0}.flux-notif-head{display:flex;justify-content:space-between;padding:10px 12px;border-bottom:1px solid var(--flux-border)}\n.flux-notif{display:flex;justify-content:space-between;gap:10px;padding:10px 12px;border-bottom:1px solid var(--flux-border);border-left:3px solid var(--flux-accent)}\n.flux-notif.flux-success{border-left-color:var(--flux-ok)}.flux-notif.flux-warning{border-left-color:var(--flux-warn)}.flux-notif.flux-error{border-left-color:var(--flux-danger)}\n.flux-notif p{margin:2px 0 4px;font-size:13px}.flux-notif small{color:var(--flux-muted)}.flux-notif-actions{display:flex;flex-direction:column;align-items:flex-end;gap:4px}\n.flux-link{background:none;border:0;color:var(--flux-accent);cursor:pointer;font:inherit;font-size:12px;padding:0}\n.flux-toasts{position:fixed;top:48px;right:12px;display:flex;flex-direction:column;gap:8px;z-index:40;pointer-events:none}\n.flux-toast{pointer-events:auto;background:var(--flux-bg);color:var(--flux-fg);border:1px solid var(--flux-border);border-left:4px solid var(--flux-accent);border-radius:10px;padding:10px 14px;box-shadow:0 10px 28px rgba(0,0,0,.25);max-width:340px;font-size:13px}\n.flux-toast.flux-success{border-left-color:var(--flux-ok)}.flux-toast.flux-warning{border-left-color:var(--flux-warn)}.flux-toast.flux-error{border-left-color:var(--flux-danger)}\n.flux-md{line-height:1.6}.flux-md h2,.flux-md h3,.flux-md h4,.flux-md h5{margin:1.1em 0 .4em}.flux-md pre{background:var(--flux-surface);padding:10px;border-radius:8px;overflow:auto}\n.flux-md code{background:var(--flux-surface);padding:1px 5px;border-radius:4px;font-size:.92em}.flux-md pre code{padding:0;background:none}.flux-md table{border-collapse:collapse;margin:8px 0;font-size:13px}.flux-md th,.flux-md td{border:1px solid var(--flux-border);padding:5px 10px;text-align:left}.flux-md th{background:var(--flux-surface)}.flux-md blockquote{margin:8px 0;padding:2px 12px;border-left:3px solid var(--flux-border);color:var(--flux-muted)}\n";

package/dist/types/react/icons.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+declare const PATHS: Record<string, string>;
+export type IconName = keyof typeof PATHS | (string & {});
+/** Small built-in icon set (24×24, currentColor). Pass your own SVG path with `d` for custom icons. */
+export declare function Icon({ name, d, size, title }: {
+    name?: IconName;
+    d?: string;
+    size?: number;
+    title?: string;
+}): React.ReactElement;
+export declare const iconNames: string[];
+export {};

package/dist/types/react/index.d.ts

@@ -4,3 +4,8 @@ export * from "./router.js";
 export * from "./palette.js";
 export { baseCss } from "./base-css.js";
 export * from "./http-bridge.js";
+export * from "./os.js";
+export * from "./icons.js";
+export * from "./markdown.js";
+export * from "./theme.js";
+export * from "./titlebar.js";

package/dist/types/react/markdown.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+/**
+ * Small, safe Markdown renderer for plugin descriptions: headings, paragraphs, lists, quotes, code blocks, rules,
+ * bold/italic/inline code and https links. Raw HTML is never interpreted (it is shown as text) and images are not loaded.
+ */
+export declare function Markdown({ source }: {
+    source: string;
+}): React.ReactElement;

package/dist/types/react/os.d.ts

@@ -0,0 +1,5 @@
+export type OS = "mac" | "windows" | "linux" | "other";
+export declare function detectOS(ua?: string): OS;
+export declare const useOS: () => OS;
+/** `Mod+Shift+R` → `⌘⇧R` on macOS, `Ctrl+Shift+R` elsewhere. */
+export declare function formatShortcut(binding: string, os?: OS): string;

package/dist/types/react/runtime.d.ts

@@ -1,4 +1,4 @@
-import { PluginManager, type Bootstrap, type FluxBridge, type IpcContract, type IpcErrorPayload, type Permission, type PluginConfig, type PluginInfo, type PluginManagerOptions, type PreloadApiSpec, type RegistryEntryLike, type RendererPluginDescriptor } from "../core/index.js";
+import { PluginManager, type Bootstrap, type FluxBridge, type IpcContract, type IpcErrorPayload, type Permission, type PluginConfig, type PluginDetails, type PluginInfo, type PluginManagerOptions, type PreloadApiSpec, type RegistryEntryLike, type RendererPluginDescriptor } from "../core/index.js";
 export declare class RemoteError extends Error {
     readonly payload: IpcErrorPayload;
     constructor(payload: IpcErrorPayload);
@@ -35,6 +35,7 @@ export declare class PluginsClient {
     configReset: <T = Record<string, unknown>>(id: string) => Promise<T>;
     configSchema: (id: string) => Promise<import("../core/schema.js").SchemaDescription | null>;
     logs: (id?: string) => Promise<import("../core/common.js").LogEntry[]>;
+    details: (id: string) => Promise<PluginDetails>;
     diagnostics: (id: string) => Promise<{
         info: PluginInfo;
         logs: import("../core/index.js").LogEntry[];