fluxplugin 1.0.2 → 1.0.4

package/dist/node/index.js

@@ -57,6 +57,7 @@ import {
   normalizePath,
   parseOrThrow,
   parseVersion,
+  parseVideo,
   pluginApi,
   preloadMember,
   routePatternMatches,
@@ -68,7 +69,7 @@ import {
   validateManifest,
   videoEmbedUrl,
   withTimeout
-} from "./chunks/chunk-EVX2O65A.js";
+} from "./chunks/chunk-SDCGUBEW.js";
 import "./chunks/chunk-WSFCRVEQ.js";
 export {
   BUILTIN_PERMISSIONS,
@@ -129,6 +130,7 @@ export {
   normalizePath,
   parseOrThrow,
   parseVersion,
+  parseVideo,
   pluginApi,
   preloadMember,
   routePatternMatches,

package/dist/node/main.js

@@ -8,6 +8,7 @@ import {
   JsonStateFile,
   LocalRegistry,
   MANIFEST_FILE,
+  MIME,
   MainFramework,
   PLUGIN_SCHEME,
   PluginInstaller,
@@ -21,11 +22,13 @@ import {
   createRegistries,
   createTarGz,
   discoverPlugins,
+  downloadFolder,
   entriesFromIndex,
   extractTarGz,
   generateSigningKeyPair,
   importFresh,
   pruneNonRuntime,
+  readAsset,
   readPluginDir,
   readPluginManifest,
   readTarGz,
@@ -35,8 +38,8 @@ import {
   sha256File,
   signManifest,
   verifyPlugin
-} from "./chunks/chunk-C7VWZZOX.js";
-import "./chunks/chunk-EVX2O65A.js";
+} from "./chunks/chunk-ZLA5XUXN.js";
+import "./chunks/chunk-SDCGUBEW.js";
 import "./chunks/chunk-WSFCRVEQ.js";
 export {
   DEFAULT_STORE,
@@ -48,6 +51,7 @@ export {
   JsonStateFile,
   LocalRegistry,
   MANIFEST_FILE,
+  MIME,
   MainFramework,
   PLUGIN_SCHEME,
   PluginInstaller,
@@ -61,11 +65,13 @@ export {
   createRegistries,
   createTarGz,
   discoverPlugins,
+  downloadFolder,
   entriesFromIndex,
   extractTarGz,
   generateSigningKeyPair,
   importFresh,
   pruneNonRuntime,
+  readAsset,
   readPluginDir,
   readPluginManifest,
   readTarGz,

package/dist/node/preload.js

@@ -1,6 +1,6 @@
 import {
   CHANNELS
-} from "./chunks/chunk-EVX2O65A.js";
+} from "./chunks/chunk-SDCGUBEW.js";
 import "./chunks/chunk-WSFCRVEQ.js";
 
 // src/preload/index.ts

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

@@ -5,3 +5,8 @@ export declare function buildPlugin(root: string, watch?: boolean, log?: {
     (...data: any[]): void;
     (message?: any, ...optionalParams: any[]): void;
 }): Promise<() => Promise<void>>;
+/**
+ * Keeps `<host>/plugins/<id>` in sync with this plugin project (runtime files only): lets you develop a plugin as its own
+ * project and watch it run in the main app (which hot-reloads it). Returns a function that stops syncing.
+ */
+export declare function linkPluginToHost(root: string, hostDir: string, log?: (m: string) => void): Promise<() => void>;

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

@@ -1,2 +1,4 @@
 export declare function readManifest(root: string): Promise<Record<string, unknown>>;
 export declare function run(argv: string[]): Promise<number>;
+/** "github:owner/repo" | "https://host/plugins.json" (JSON link) | "https://host/store/" (folder with index.json) */
+export declare function parseStoreSpec(spec: string | undefined): import("../main/index.js").StoreSpec[] | undefined;

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

@@ -0,0 +1,18 @@
+/** Copies every plugin's runtime files (no src, no .ts, no sourcemaps) to `outDir/<folder>`. Returns the plugin count. */
+export declare function stagePlugins(cwd: string, outDir: string, log?: (m: string) => void): Promise<number>;
+/** Builds the app and packages it into an installer/executable with electron-builder (current OS by default). */
+export declare function distApp(cwd: string, opts?: {
+    win?: boolean;
+    mac?: boolean;
+    linux?: boolean;
+    dir?: boolean;
+    log?: (m: string) => void;
+}): Promise<number>;
+/**
+ * Extracts the app as a static website: the built renderer, every plugin's runtime files and a `bootstrap.json` describing them.
+ * Serve the folder with any static host. Only the browser side runs (no main-process code): renderer-only plugins work fully.
+ */
+export declare function exportWebsite(cwd: string, outDir: string, log?: (m: string) => void): Promise<{
+    plugins: number;
+    out: string;
+}>;

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

@@ -4,6 +4,8 @@ export interface HostVars {
     /** Electron semver range (init resolves the latest published version). */
     electron?: string;
     tailwind?: boolean;
+    /** Stores for fluxplugin.config.json (default: the GitHub topic store). */
+    stores?: import("../main/index.js").StoreSpec[];
 }
 /** 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/store.d.ts

@@ -5,3 +5,16 @@ export declare function storeAdd(pkgFile: string, dir: string, baseUrl?: string)
     version: string;
     sha256: string;
 }>;
+/**
+ * Builds the catalog JSON from a repository of plugin folders (`<dir>/plugins/<name>/plugin.json` + built `dist/`).
+ * One JSON holds every plugin's metadata (icon, screenshots, video, README…), the exact list of runtime files to download
+ * (sources and sourcemaps are never listed) and the sha256 of each file. Commit it next to the folders.
+ */
+export declare function storeBuild(dir: string, opts?: {
+    out?: string;
+    pluginsDir?: string;
+    log?: (m: string) => void;
+}): Promise<{
+    count: number;
+    file: string;
+}>;

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

@@ -10,3 +10,5 @@ export declare const TEMPLATES: Record<TemplateName, (v: TemplateVars) => Record
 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>;
+/** Extra files when a plugin is its own project (outside an app, or created with --standalone). */
+export declare function standaloneExtras(v: TemplateVars): Record<string, string>;

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

@@ -93,5 +93,19 @@ 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 type VideoKind = "youtube" | "vimeo" | "dailymotion" | "loom" | "streamable" | "html5" | "link";
+export interface VideoInfo {
+    kind: VideoKind;
+    url: string;
+    /** iframe URL for hosted players. */
+    embedUrl?: string;
+    /** Direct media URL for the HTML5 <video> player (also a plugin-relative path before it is resolved). */
+    src?: string;
+}
+/**
+ * Classifies a video reference: hosted players that must be embedded in an iframe (YouTube, Vimeo, Dailymotion, Loom,
+ * Streamable), direct media files for the HTML5 player (https URL or a path inside the plugin), or a plain link.
+ */
+export declare function parseVideo(url: string | undefined): VideoInfo | undefined;
+/** Back-compat helper: the iframe URL of a hosted player, if any. */
 export declare function videoEmbedUrl(url: string | undefined): string | undefined;

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

@@ -86,7 +86,21 @@ export interface RegistryEntryLike {
     sha256?: string;
     homepage?: string;
     stars?: number;
-    icon?: string;
+    /** Store metadata (everything a "store page" needs, straight from the catalog). */
+    iconUrl?: string;
+    bannerUrl?: string;
+    screenshots?: string[];
+    video?: string;
+    categories?: string[];
+    keywords?: string[];
+    links?: Record<string, string>;
+    license?: string;
+    /** Markdown (inline in the catalog). */
+    readme?: string;
+    /** Set by the app when the plugin is already installed locally. */
+    installedVersion?: string;
+    folder?: boolean;
+    files?: string[];
 }
 /** Everything a UI needs to render a plugin "store page": icon, banner, screenshots, video, long description. */
 export interface PluginDetails {
@@ -104,10 +118,9 @@ export interface PluginDetails {
     iconUrl?: string;
     bannerUrl?: string;
     screenshotUrls: string[];
-    video?: {
-        url: string;
-        embedUrl?: string;
-    };
+    video?: import("./manifest.js").VideoInfo;
+    /** Base URL of the plugin's files (to resolve relative images/videos). */
+    assetBase?: string;
     /** Markdown source of the long description (rendered by the UI without raw HTML). */
     readme?: string;
 }

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

@@ -66,10 +66,21 @@ export interface MenuItemDefinition {
     badge?: string | number;
     /** Route path, for sidebar entries that navigate without a command. */
     path?: string;
+    /** Id of another item (same location) this one is nested under: builds sub-menus without the parent knowing its children. */
+    parent?: string;
 }
+export type MenuNode = Omit<MenuItemDefinition, "location" | "children"> & {
+    location?: MenuItemDefinition["location"];
+    children?: MenuNode[];
+};
 export declare class MenuRegistry extends Registry<MenuItemDefinition> {
     constructor();
     register(item: MenuItemDefinition, owner?: string): Disposable;
+    /**
+     * Hierarchical view of a location: items that name a `parent`, plus the parent's own `children`, are nested under it
+     * (sorted by order). Unknown parents fall back to top level, so a missing plugin never hides its siblings.
+     */
+    tree(location: MenuLocation): MenuNode[];
     items(location: MenuLocation): MenuItemDefinition[];
 }
 export interface ServiceEntry<T = unknown> {

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

@@ -21,7 +21,9 @@ export interface RouteMeta {
         location?: MenuLocation;
         label?: string;
         order?: number;
-        group?: string;
+        group?: string; /** nest under this menu item id */
+        parent?: string;
+        icon?: unknown;
     };
     [key: string]: unknown;
 }

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

@@ -54,6 +54,9 @@ export declare function resolvePluginAsset(fw: MainFramework, url: string): Prom
 export declare function registerPluginProtocol(fw: MainFramework, protocol: {
     handle(scheme: string, handler: (req: {
         url: string;
+        headers?: {
+            get(name: string): string | null;
+        };
     }) => Promise<Response> | Response): void;
 }): void;
 export interface HttpAdapterOptions {

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

@@ -0,0 +1,8 @@
+export declare const MIME: Record<string, string>;
+export interface AssetResponse {
+    status: 200 | 206 | 416;
+    headers: Record<string, string>;
+    body: Buffer;
+}
+/** Serves a file, honouring `Range` so <video> can seek. Reads only the requested slice. */
+export declare function readAsset(file: string, mime: string, range?: string | null): Promise<AssetResponse>;

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

@@ -30,7 +30,8 @@ export interface PluginDescriptor {
  * 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`.
+ *  - `repo`: a catalog repository: plugin folders + one JSON file (`index.json` by default, see `fluxplugin store build`) with all the
+ *    metadata. Plugins are installed straight from their folders in the repo (every file verified against the catalog hashes).
  */
 export declare class GitHubRegistry implements PluginRegistry {
     private readonly o;

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

@@ -8,3 +8,4 @@ export * from "./tar.js";
 export * from "./serve-web.js";
 export * from "./github-registry.js";
 export * from "./stores.js";
+export * from "./assets.js";

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

@@ -14,7 +14,21 @@ export interface RegistryEntry {
     sha256?: string;
     homepage?: string;
     stars?: number;
-    icon?: string;
+    iconUrl?: string;
+    bannerUrl?: string;
+    screenshots?: string[];
+    video?: string;
+    categories?: string[];
+    keywords?: string[];
+    links?: Record<string, string>;
+    license?: string;
+    readme?: string;
+    /** Filled in by the app: version already installed locally. */
+    installedVersion?: string;
+    /** Folder entry: `location` is a folder URL; download `files` and verify them against `hashes`. */
+    folder?: boolean;
+    files?: string[];
+    hashes?: Record<string, string>;
 }
 /**
  * Abstraction over where plugins come from. Implement it for npm, GitHub releases, a private HTTP registry,
@@ -36,22 +50,39 @@ export declare function readPluginManifest(dir: string): Promise<{
  */
 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`. */
+/** Shape of a store catalog: `{ "plugins": [...] }` or a bare array. Served as a file, built by `fluxplugin store build`, or returned by any API. */
+export interface StoreIndexPlugin {
+    id: string;
+    name?: string;
+    version: string;
+    description?: string;
+    author?: string;
+    permissions?: string[];
+    /** A package (.tgz)… */
+    url?: string;
+    sha256?: string;
+    /** …or a plugin folder in the repository / on the host, with its file list and sha256 of every file. */
+    folder?: string;
+    files?: string[];
+    hashes?: Record<string, string>;
+    homepage?: string;
+    license?: string;
+    icon?: string;
+    banner?: string;
+    screenshots?: string[];
+    video?: string;
+    categories?: string[];
+    keywords?: string[];
+    links?: Record<string, string>;
+    /** Markdown, inline (keep it short) */
+    readme?: string;
+}
 export interface StoreIndex {
-    plugins: {
-        id: string;
-        name?: string;
-        version: string;
-        description?: string;
-        author?: string;
-        permissions?: string[];
-        url: string;
-        sha256?: string;
-        homepage?: string;
-        icon?: string;
-    }[];
+    plugins: StoreIndexPlugin[];
 }
-export declare function entriesFromIndex(index: StoreIndex, baseUrl: string, source: string, query?: string): RegistryEntry[];
+export declare function entriesFromIndex(index: StoreIndex | StoreIndexPlugin[], baseUrl: string, source: string, query?: string): RegistryEntry[];
+/** Downloads a plugin folder file by file, verifying every file against the catalog's sha256 (required). */
+export declare function downloadFolder(entry: RegistryEntry, dest: string, get: (url: string) => Promise<Response>): Promise<void>;
 /** 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). */
@@ -63,14 +94,20 @@ export declare class LocalRegistry implements PluginRegistry {
     fetch(entry: RegistryEntry, dest: string): Promise<PluginManifest>;
 }
 /**
- * HTTP registry: GET `<baseUrl>/index.json` → `{ plugins: [{ id, name, version, description, author, permissions, url, sha256 }] }`
- * where `url` points at a `.tgz` produced by `fluxplugin package`. Downloads are verified against `sha256` when given.
+ * HTTP/JSON store. `url` is either a folder holding `index.json` ("https://plugins.acme.com/") or a direct link to a JSON
+ * document / API endpoint that returns the catalog ("https://api.acme.com/plugins" or ".../plugins.json").
+ * Entries are packages (`url` → .tgz, checked against `sha256`) or plugin folders (`folder` + `files` + `hashes`).
  */
 export declare class HttpRegistry implements PluginRegistry {
     private readonly baseUrl;
     private readonly fetchImpl;
+    private readonly headers;
+    private readonly direct;
     readonly name: string;
-    constructor(baseUrl: string, fetchImpl?: typeof fetch);
+    constructor(baseUrl: string, fetchImpl?: typeof fetch, headers?: Record<string, string>, direct?: boolean);
+    /** Direct link (".json" file, or `direct: true` for an API endpoint) or a folder that contains index.json. */
+    private get catalogUrl();
+    private get;
     search(query?: string): Promise<RegistryEntry[]>;
     fetch(entry: RegistryEntry, dest: string): Promise<PluginManifest>;
 }

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

@@ -3,7 +3,8 @@ 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)
+ *  - `http`:             a static host serving `index.json` + packages/folders (GitHub Pages, S3, your server)
+ *  - `json`:             one URL that returns the catalog as JSON (a file, or your own API); same format as index.json
  *  - `local`:            a folder (network share, checkout)
  */
 export type StoreSpec = {
@@ -16,6 +17,11 @@ export type StoreSpec = {
 } | {
     type: "http";
     url: string;
+    headers?: Record<string, string>;
+} | {
+    type: "json";
+    url: string;
+    headers?: Record<string, string>;
 } | {
     type: "local";
     path: string;

package/dist/types/manager-ui/index.d.ts

@@ -1,7 +1,39 @@
 import React from "react";
-/** Auto-generated settings form from a plugin's config schema (`ctx.config.describe()`). */
+import type { VideoInfo } from "../core/index.js";
+import { type RendererFramework } from "../react/index.js";
+/** Everything the "app page" of a plugin needs, whether it is installed or only listed in a store. */
+export interface PluginView {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    license?: string;
+    iconUrl?: string;
+    bannerUrl?: string;
+    screenshots: string[];
+    video?: VideoInfo;
+    categories: string[];
+    keywords: string[];
+    links: Record<string, string>;
+    readme?: string;
+    permissions: string[];
+    dependencies: Record<string, string>;
+    /** Base URL used to resolve relative images in the README. */
+    assetBase?: string;
+    homepage?: string;
+}
+/** Auto-generated settings form from the plugin's config schema. */
 export declare function ConfigForm({ id }: {
     id: string;
 }): React.ReactElement | null;
-/** Full plugin manager screen. Extensible through the `manager.plugin.actions` / `manager.plugin.details` slots. */
-export declare function PluginManagerUI(): React.ReactElement;
+/** Detail screen of an installed plugin (route `/plugins/:id`). */
+export declare function PluginDetailsPage(): React.ReactElement;
+/** Detail screen of a plugin listed in a store (route `/plugins/store/:id`). */
+export declare function StorePluginPage(): React.ReactElement;
+/** The plugin list: Installed · Discover (stores) · Updates. Rows open the detail screens. */
+export declare function PluginsPage(): React.ReactElement;
+/** Registers `/plugins`, `/plugins/:id` and `/plugins/store/:id` with their breadcrumbs. */
+export declare function registerPluginManagerRoutes(framework: RendererFramework): void;
+/** Back-compat: the list page. */
+export declare const PluginManagerUI: typeof PluginsPage;

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

@@ -1,2 +1,6 @@
-/** 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\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";
+/**
+ * Design system of the framework's components: macOS look (SF-style type, translucent materials, grouped lists, switches,
+ * segmented controls). Everything is driven by CSS variables so hosts, users (Settings → Appearance) and plugin themes can
+ * restyle it: --flux-font, --flux-font-size, --flux-line, --flux-radius, --flux-accent, --flux-bg/-surface/-fg/-muted/-border …
+ */
+export declare const baseCss = "\n:root{--flux-font:-apple-system,BlinkMacSystemFont,\"SF Pro Text\",\"Segoe UI Variable\",\"Segoe UI\",system-ui,Roboto,\"Helvetica Neue\",sans-serif;--flux-font-size:14px;--flux-line:1.5;--flux-radius:10px;--flux-radius-lg:14px;--flux-pad:1;\n--flux-bg:#fff;--flux-surface:#f5f5f7;--flux-surface-2:#e9e9ee;--flux-fg:#1d1d1f;--flux-muted:#6e6e73;--flux-border:rgba(60,60,67,.16);--flux-accent:#007aff;--flux-accent-fg:#fff;--flux-ok:#34c759;--flux-warn:#ff9f0a;--flux-danger:#ff3b30;--flux-shadow:0 10px 34px rgba(0,0,0,.14);--flux-material:rgba(246,246,248,.78)}\n@media (prefers-color-scheme:dark){:root:not([data-theme]){--flux-bg:#1c1c1e;--flux-surface:#2c2c2e;--flux-surface-2:#3a3a3c;--flux-fg:#f5f5f7;--flux-muted:#98989d;--flux-border:rgba(235,235,245,.16);--flux-accent:#0a84ff;--flux-shadow:0 10px 34px rgba(0,0,0,.55);--flux-material:rgba(44,44,46,.72)}}\n:root[data-theme=\"dark\"]{--flux-bg:#1c1c1e;--flux-surface:#2c2c2e;--flux-surface-2:#3a3a3c;--flux-fg:#f5f5f7;--flux-muted:#98989d;--flux-border:rgba(235,235,245,.16);--flux-accent:#0a84ff;--flux-shadow:0 10px 34px rgba(0,0,0,.55);--flux-material:rgba(44,44,46,.72)}\n:root[data-theme=\"light\"]{--flux-bg:#fff;--flux-surface:#f5f5f7;--flux-surface-2:#e9e9ee;--flux-fg:#1d1d1f;--flux-muted:#6e6e73;--flux-border:rgba(60,60,67,.16);--flux-accent:#007aff;--flux-material:rgba(246,246,248,.78)}\n:root[data-radius=\"sharp\"]{--flux-radius:4px;--flux-radius-lg:6px}:root[data-radius=\"round\"]{--flux-radius:14px;--flux-radius-lg:22px}:root[data-density=\"compact\"]{--flux-pad:.7}\n:root[data-motion=\"reduced\"] *{transition:none!important;animation:none!important}\nhtml{font-family:var(--flux-font);font-size:var(--flux-font-size);line-height:var(--flux-line);-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility}\nbody{font-family:var(--flux-font);font-size:1em;line-height:var(--flux-line);color:var(--flux-fg);background:var(--flux-bg)}\nbutton,input,select,textarea{font-family:inherit;font-size:inherit}\n.flux-icon{flex:none;vertical-align:middle}\n.flux-large-title{font-size:2em;font-weight:700;letter-spacing:-.025em;margin:0 0 .6em;line-height:1.15}.flux-title{font-size:1.5em;font-weight:700;letter-spacing:-.02em;margin:0 0 .8em}\n.flux-empty,.flux-not-found,.flux-forbidden,.flux-loading{padding:24px;color:var(--flux-muted)}\n.flux-plugin-error{padding:10px 14px;border-radius:var(--flux-radius);background:color-mix(in srgb,var(--flux-danger) 12%,transparent);color:var(--flux-danger);font-size:.92em}\n.flux-breadcrumbs{font-size:.86em;color:var(--flux-muted);margin-bottom:6px}.flux-breadcrumbs a{color:inherit;text-decoration:none}.flux-breadcrumbs a:hover{color:var(--flux-accent)}\n/* ---- materials (vibrancy) */\n.flux-titlebar,.flux-side,.flux-dropdown,.flux-toast,.flux-palette{background:var(--flux-material);-webkit-backdrop-filter:saturate(180%) blur(24px);backdrop-filter:saturate(180%) blur(24px)}\n:root[data-translucency=\"off\"] .flux-titlebar,:root[data-translucency=\"off\"] .flux-side,:root[data-translucency=\"off\"] .flux-dropdown,:root[data-translucency=\"off\"] .flux-toast,:root[data-translucency=\"off\"] .flux-palette{background:var(--flux-surface);-webkit-backdrop-filter:none;backdrop-filter:none}\n/* ---- buttons / switch / segmented */\n.flux-btn{display:inline-flex;align-items:center;justify-content:center;gap:6px;border:1px solid var(--flux-border);background:var(--flux-bg);color:var(--flux-fg);border-radius:calc(var(--flux-radius) - 2px);padding:calc(5px*var(--flux-pad)) 14px;font-weight:500;cursor:pointer;transition:background .12s,transform .06s}\n.flux-btn:hover{background:var(--flux-surface)}.flux-btn:active{transform:scale(.97)}.flux-btn:disabled{opacity:.5;cursor:default}\n.flux-btn-primary{background:var(--flux-accent);border-color:transparent;color:var(--flux-accent-fg)}.flux-btn-primary:hover{background:var(--flux-accent);filter:brightness(1.08)}\n.flux-btn-destructive{color:var(--flux-danger)}.flux-btn-plain{border-color:transparent;background:transparent;color:var(--flux-accent)}.flux-btn-plain:hover{background:var(--flux-surface)}\n.flux-btn-sm{padding:3px 11px;font-size:.92em;border-radius:99px}.flux-btn-lg{padding:9px 22px;font-size:1.05em;border-radius:99px}\n.flux-switch{position:relative;width:42px;height:26px;border-radius:99px;border:0;background:var(--flux-surface-2);cursor:pointer;transition:background .18s;flex:none;padding:0}\n.flux-switch span{position:absolute;top:2px;left:2px;width:22px;height:22px;border-radius:50%;background:#fff;box-shadow:0 1px 3px rgba(0,0,0,.35);transition:transform .18s}\n.flux-switch[data-on]{background:var(--flux-ok)}.flux-switch[data-on] span{transform:translateX(16px)}.flux-switch:focus-visible{outline:2px solid var(--flux-accent);outline-offset:2px}\n.flux-seg{display:inline-flex;background:var(--flux-surface-2);border-radius:9px;padding:2px;gap:2px}\n.flux-seg button{border:0;background:transparent;color:var(--flux-fg);border-radius:7px;padding:calc(4px*var(--flux-pad)) 14px;font-weight:500;cursor:pointer}\n.flux-seg button[data-on]{background:var(--flux-bg);box-shadow:0 1px 3px rgba(0,0,0,.18)}\n.flux-input{width:100%;box-sizing:border-box;border:1px solid var(--flux-border);background:var(--flux-bg);color:var(--flux-fg);border-radius:var(--flux-radius);padding:calc(7px*var(--flux-pad)) 12px;outline:none}.flux-input:focus{border-color:var(--flux-accent);box-shadow:0 0 0 3px color-mix(in srgb,var(--flux-accent) 25%,transparent)}\n.flux-select{background:var(--flux-bg);color:inherit;border:1px solid var(--flux-border);border-radius:7px;padding:3px 6px}\n/* ---- grouped lists */\n.flux-group-box{margin:0 0 calc(22px*var(--flux-pad))}.flux-group-title{font-size:.78em;text-transform:uppercase;letter-spacing:.06em;color:var(--flux-muted);margin:0 14px 6px;font-weight:600}\n.flux-group-body{background:var(--flux-surface);border-radius:var(--flux-radius-lg);overflow:hidden}.flux-group-footer{font-size:.82em;color:var(--flux-muted);margin:6px 14px 0}\n.flux-row{display:flex;align-items:center;gap:12px;width:100%;box-sizing:border-box;padding:calc(10px*var(--flux-pad)) 14px;border:0;background:transparent;color:inherit;text-align:left;position:relative;min-height:calc(44px*var(--flux-pad))}\n.flux-row+.flux-row::before{content:\"\";position:absolute;top:0;left:14px;right:0;height:1px;background:var(--flux-border)}\n.flux-row.is-link{cursor:pointer}.flux-row.is-link:hover{background:color-mix(in srgb,var(--flux-fg) 5%,transparent)}.flux-row[data-selected]{background:color-mix(in srgb,var(--flux-accent) 14%,transparent)}\n.flux-row-icon{width:28px;height:28px;border-radius:7px;display:inline-flex;align-items:center;justify-content:center;background:var(--flux-accent);color:#fff;flex:none;overflow:hidden}\n.flux-row-text{display:flex;flex-direction:column;min-width:0;flex:1}.flux-row-title{font-weight:500;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.flux-row-sub{font-size:.88em;color:var(--flux-muted);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.flux-row-right{display:flex;align-items:center;gap:8px;color:var(--flux-muted)}\n.flux-img-fallback{display:inline-flex;align-items:center;justify-content:center;background:var(--flux-surface-2);color:var(--flux-muted);border-radius:inherit;min-width:32px;min-height:32px}\n/* ---- title bar */\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 10px;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:2px;min-width:0}.flux-tb-right{justify-content:flex-end}\n.flux-brand{display:flex;align-items:center;gap:8px;font-weight:650;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:4px 9px;font:inherit;cursor:pointer;position:relative}\n.flux-tb-btn:hover,.flux-tb-btn.is-open{background:color-mix(in srgb,var(--flux-fg) 9%,transparent)}\n.flux-menubar{display:flex}.flux-menu{position:relative}\n.flux-dropdown{position:absolute;top:calc(100% + 4px);left:0;min-width:230px;max-width:380px;margin:0;padding:5px;list-style:none;color:var(--flux-fg);border:1px solid var(--flux-border);border-radius:10px;box-shadow:var(--flux-shadow);z-index:60}\n.flux-dd-item{display:flex;justify-content:space-between;align-items:center;gap:18px;width:100%;border:0;background:transparent;color:inherit;font:inherit;text-align:left;padding:5px 10px;border-radius:5px;cursor:pointer}\n.flux-dd-item:hover,.flux-dd-item.is-active{background:var(--flux-accent);color:var(--flux-accent-fg)}.flux-dd-item kbd,.flux-dd-item small{opacity:.6;font:11px ui-monospace,monospace}.flux-sep{height:1px;background:var(--flux-border);margin:5px 6px}\n.flux-search{position:relative;display:flex;align-items:center;gap:8px;background:color-mix(in srgb,var(--flux-fg) 7%,transparent);border-radius:8px;padding:0 10px;height:26px;color:var(--flux-muted)}\n.flux-search input{flex:1;min-width:0;border:0;background:transparent;color:var(--flux-fg);outline:none}.flux-search:focus-within{box-shadow:0 0 0 3px color-mix(in srgb,var(--flux-accent) 30%,transparent)}\n.flux-search-results{left:0;right:0;max-width:none;top:calc(100% + 6px)}.flux-group{font-size:.74em;text-transform:uppercase;letter-spacing:.06em;color:var(--flux-muted);padding:7px 10px 2px;font-weight:600}\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:350px;max-height:440px;overflow:auto;padding:0}.flux-notif-head{display:flex;justify-content:space-between;padding:12px 14px;border-bottom:1px solid var(--flux-border)}\n.flux-notif{display:flex;justify-content:space-between;gap:10px;padding:11px 14px;border-bottom:1px solid var(--flux-border)}.flux-notif p{margin:2px 0 4px;font-size:.92em}.flux-notif small{color:var(--flux-muted)}.flux-notif-actions{display:flex;flex-direction:column;align-items:flex-end;gap:4px}\n.flux-notif.flux-success{box-shadow:inset 3px 0 var(--flux-ok)}.flux-notif.flux-warning{box-shadow:inset 3px 0 var(--flux-warn)}.flux-notif.flux-error{box-shadow:inset 3px 0 var(--flux-danger)}.flux-notif.flux-info{box-shadow:inset 3px 0 var(--flux-accent)}\n.flux-link{background:none;border:0;color:var(--flux-accent);cursor:pointer;font:inherit;font-size:.88em;padding:0}\n.flux-toasts{position:fixed;top:48px;right:14px;display:flex;flex-direction:column;gap:8px;z-index:40;pointer-events:none}\n.flux-toast{pointer-events:auto;color:var(--flux-fg);border:1px solid var(--flux-border);border-radius:14px;padding:11px 15px;box-shadow:var(--flux-shadow);max-width:350px;font-size:.93em}\n.flux-toast.flux-success{border-left:4px solid var(--flux-ok)}.flux-toast.flux-warning{border-left:4px solid var(--flux-warn)}.flux-toast.flux-error{border-left:4px solid var(--flux-danger)}\n/* ---- command palette (Spotlight) */\n.flux-palette-backdrop{position:fixed;inset:0;background:rgba(0,0,0,.28);display:flex;justify-content:center;align-items:flex-start;padding-top:14vh;z-index:9999}\n.flux-palette{width:min(600px,92vw);color:var(--flux-fg);border:1px solid var(--flux-border);border-radius:16px;box-shadow:var(--flux-shadow);overflow:hidden}\n.flux-palette-input{width:100%;box-sizing:border-box;padding:16px 18px;border:0;border-bottom:1px solid var(--flux-border);background:transparent;color:inherit;font-size:1.25em;outline:none}\n.flux-palette-list{list-style:none;margin:0;padding:6px;max-height:360px;overflow:auto}.flux-palette-item{display:flex;justify-content:space-between;align-items:center;gap:12px;padding:8px 12px;border-radius:8px;cursor:pointer}\n.flux-palette-item.is-active{background:var(--flux-accent);color:var(--flux-accent-fg)}.flux-palette-cat{opacity:.65}.flux-palette-empty{padding:16px;color:var(--flux-muted)}.flux-palette kbd{font:11px ui-monospace,monospace;opacity:.7}\n/* ---- sidebar */\n.flux-side{display:flex;flex-direction:column;justify-content:space-between;height:100%;box-sizing:border-box;padding:12px 10px;border-right:1px solid var(--flux-border);overflow-y:auto;overflow-x:hidden;transition:padding .18s}\n.flux-side-nav,.flux-side-bottom{display:flex;flex-direction:column;gap:2px}.flux-side-sep{height:1px;background:var(--flux-border);margin:8px 8px}\n.flux-nav-group{position:relative}\n.flux-nav{display:flex;align-items:center;gap:10px;width:100%;box-sizing:border-box;padding:calc(6px*var(--flux-pad)) 10px;border:0;background:transparent;color:inherit;text-decoration:none;border-radius:8px;cursor:pointer;font-weight:500;text-align:left;white-space:nowrap}\n.flux-nav:hover{background:color-mix(in srgb,var(--flux-fg) 7%,transparent)}.flux-nav[data-active]{background:var(--flux-accent);color:var(--flux-accent-fg)}.flux-nav[data-parent-active]{font-weight:650}\n.flux-nav-icon{display:inline-flex;width:22px;justify-content:center;flex:none}.flux-nav-label{flex:1;overflow:hidden;text-overflow:ellipsis}\n.flux-nav-badge{font-size:.78em;background:var(--flux-danger);color:#fff;border-radius:99px;padding:0 6px}.flux-nav-chev{display:inline-flex;transition:transform .15s;opacity:.6}.flux-nav-chev[data-open]{transform:rotate(90deg)}\n.flux-subnav{margin-left:14px;padding-left:8px;border-left:1px solid var(--flux-border);display:flex;flex-direction:column;gap:2px;margin-top:2px}.flux-subnav .flux-nav{font-weight:450;padding-top:calc(4px*var(--flux-pad));padding-bottom:calc(4px*var(--flux-pad))}\n.flux-side[data-collapsed] .flux-nav{justify-content:center;padding:9px 0}\n.flux-flyout{display:none;position:absolute;left:calc(100% + 6px);top:0;min-width:190px;padding:6px;background:var(--flux-bg);border:1px solid var(--flux-border);border-radius:10px;box-shadow:var(--flux-shadow);z-index:80}.flux-nav-group:hover>.flux-flyout{display:block}\n.flux-flyout-title{font-size:.75em;text-transform:uppercase;letter-spacing:.06em;color:var(--flux-muted);padding:4px 10px}.flux-flyout-item{display:block;padding:6px 10px;border-radius:6px;color:inherit;text-decoration:none}.flux-flyout-item:hover,.flux-flyout-item[data-active]{background:var(--flux-accent);color:var(--flux-accent-fg)}\n.flux-side-footer{font-size:.78em;color:var(--flux-muted);padding:6px 10px}\n/* ---- settings */\n.flux-settings{display:grid;grid-template-columns:240px minmax(0,1fr);gap:28px;align-items:start}.flux-settings-nav{display:flex;flex-direction:column;gap:2px;position:sticky;top:0}\n.flux-settings-item{display:flex;align-items:center;gap:10px;border:0;background:transparent;color:inherit;border-radius:9px;padding:calc(7px*var(--flux-pad)) 10px;cursor:pointer;text-align:left;font-weight:500}.flux-settings-item:hover{background:color-mix(in srgb,var(--flux-fg) 7%,transparent)}.flux-settings-item[data-active]{background:var(--flux-accent);color:var(--flux-accent-fg)}\n.flux-settings-body{min-width:0;max-width:720px}.flux-swatches{display:flex;gap:10px;flex-wrap:wrap}.flux-swatch{width:26px;height:26px;border-radius:50%;border:2px solid transparent;cursor:pointer;box-shadow:inset 0 0 0 2px var(--flux-bg)}.flux-swatch[data-on]{border-color:var(--flux-fg)}\n.flux-theme-card{border:2px solid var(--flux-border);border-radius:12px;overflow:hidden;cursor:pointer;background:none;padding:0;text-align:left;width:128px}.flux-theme-card[data-on]{border-color:var(--flux-accent)}.flux-theme-card .flux-theme-prev{height:62px;display:flex}.flux-theme-card span.cap{display:block;padding:6px 9px;font-size:.84em;font-weight:500}\n.flux-range{width:180px;accent-color:var(--flux-accent)}\n/* ---- plugin pages */\n.flux-pm{max-width:860px;margin:0 auto}.flux-pm-top{display:flex;justify-content:space-between;align-items:center;gap:12px;margin-bottom:14px;flex-wrap:wrap}\n.flux-pm-back{display:inline-flex;align-items:center;gap:2px;border:0;background:none;color:var(--flux-accent);cursor:pointer;font-size:1em;padding:0;margin-bottom:12px}\n.flux-pm-icon{width:56px;height:56px;border-radius:24%;object-fit:cover;flex:none;box-shadow:0 1px 4px rgba(0,0,0,.2);overflow:hidden;display:inline-flex}.flux-pm-icon.lg{width:104px;height:104px;border-radius:23%;box-shadow:0 4px 18px rgba(0,0,0,.22)}\n.flux-pm-hero{display:flex;gap:22px;align-items:center;margin:4px 0 22px;flex-wrap:wrap}.flux-pm-hero h1{margin:0;font-size:2em;letter-spacing:-.02em;line-height:1.15}.flux-pm-hero .by{color:var(--flux-muted);margin:3px 0 12px}.flux-pm-actions{display:flex;gap:10px;align-items:center;flex-wrap:wrap}\n.flux-pm-facts{display:flex;border-top:1px solid var(--flux-border);border-bottom:1px solid var(--flux-border);margin:0 0 22px;overflow:auto}.flux-pm-fact{flex:1;min-width:104px;padding:12px 8px;text-align:center;border-right:1px solid var(--flux-border)}.flux-pm-fact:last-child{border:0}.flux-pm-fact small{display:block;font-size:.7em;letter-spacing:.06em;text-transform:uppercase;color:var(--flux-muted);font-weight:600}.flux-pm-fact b{font-size:1.15em;font-weight:650}\n.flux-pm-shots{display:flex;gap:14px;overflow-x:auto;padding:4px 2px 14px;scroll-snap-type:x mandatory}.flux-pm-shots img,.flux-pm-banner{height:260px;border-radius:var(--flux-radius-lg);border:1px solid var(--flux-border);scroll-snap-align:start;cursor:zoom-in;flex:none}.flux-pm-banner{width:100%;height:auto;max-height:240px;object-fit:cover;cursor:default;margin-bottom:18px}\n.flux-pm h3.sec{font-size:1.3em;font-weight:700;letter-spacing:-.015em;margin:26px 0 10px}\n.flux-pill{display:inline-block;font-size:.76em;padding:2px 9px;border-radius:99px;background:var(--flux-surface-2);color:var(--flux-muted);font-weight:600}.flux-pill.ok{background:color-mix(in srgb,var(--flux-ok) 18%,transparent);color:var(--flux-ok)}.flux-pill.err{background:color-mix(in srgb,var(--flux-danger) 16%,transparent);color:var(--flux-danger)}.flux-pill.warn{background:color-mix(in srgb,var(--flux-warn) 20%,transparent);color:var(--flux-warn)}\n.flux-zoom{position:fixed;inset:0;background:rgba(0,0,0,.82);display:flex;align-items:center;justify-content:center;z-index:9999;cursor:zoom-out}.flux-zoom img{max-width:92vw;max-height:90vh;border-radius:14px}\n.flux-video{width:100%;max-width:640px;aspect-ratio:16/9;border:0;border-radius:var(--flux-radius-lg);background:#000;display:block}.flux-video-link{display:inline-flex;gap:6px;align-items:center;color:var(--flux-accent);text-decoration:none}\n.flux-pre{max-height:200px;overflow:auto;font:12px ui-monospace,monospace;background:var(--flux-surface);padding:12px;border-radius:var(--flux-radius);margin:0;white-space:pre-wrap}\n.flux-fields label{display:flex;gap:12px;align-items:center;justify-content:space-between;padding:10px 14px}\n/* ---- Markdown: app-store style typography */\n.flux-md{font-size:1.04em;line-height:1.68;color:var(--flux-fg);letter-spacing:-.004em;max-width:70ch;overflow-wrap:anywhere}\n.flux-md>:first-child{margin-top:0}.flux-md p{margin:.85em 0}\n.flux-md h2{font-size:1.6em;font-weight:700;letter-spacing:-.022em;line-height:1.2;margin:1.7em 0 .5em}.flux-md h3{font-size:1.28em;font-weight:650;letter-spacing:-.015em;margin:1.5em 0 .4em}.flux-md h4,.flux-md h5{font-size:.82em;font-weight:650;letter-spacing:.07em;text-transform:uppercase;color:var(--flux-muted);margin:1.6em 0 .4em}\n.flux-md a{color:var(--flux-accent);text-decoration:none}.flux-md a:hover{text-decoration:underline;text-underline-offset:3px}\n.flux-md ul,.flux-md ol{padding-left:1.3em;margin:.8em 0}.flux-md li{margin:.4em 0;padding-left:.2em}.flux-md li::marker{color:var(--flux-muted)}.flux-md li.flux-task{list-style:none;margin-left:-1.2em;display:flex;gap:8px;align-items:baseline}\n.flux-md code{font-family:ui-monospace,\"SF Mono\",Menlo,Consolas,monospace;font-size:.86em;background:var(--flux-surface-2);padding:.14em .42em;border-radius:6px}\n.flux-md pre{background:var(--flux-surface);border:1px solid var(--flux-border);border-radius:14px;padding:14px 18px;overflow:auto;line-height:1.55;margin:1.1em 0}.flux-md pre code{background:none;padding:0;font-size:.85em}\n.flux-md blockquote{margin:1.1em 0;padding:.2em 1em;border-left:3px solid var(--flux-border);color:var(--flux-muted)}\n.flux-md hr{border:0;height:1px;background:var(--flux-border);margin:2em 0}\n.flux-md table{width:100%;border-collapse:separate;border-spacing:0;margin:1.2em 0;font-size:.94em;border:1px solid var(--flux-border);border-radius:14px;overflow:hidden}.flux-md th{text-align:left;font-size:.78em;letter-spacing:.06em;text-transform:uppercase;color:var(--flux-muted);background:var(--flux-surface);padding:9px 14px}.flux-md td{padding:10px 14px;border-top:1px solid var(--flux-border)}\n.flux-md-img{max-width:100%;height:auto;border-radius:14px;border:1px solid var(--flux-border);margin:.9em 0;display:block}\n.flux-callout{display:flex;flex-direction:column;gap:2px;margin:1.2em 0;padding:13px 16px;border-radius:14px;background:color-mix(in srgb,var(--c,var(--flux-accent)) 11%,transparent);border-left:4px solid var(--c,var(--flux-accent))}\n.flux-callout strong{color:var(--c,var(--flux-accent));font-size:.82em;letter-spacing:.05em;text-transform:uppercase}.flux-callout[data-kind=\"warning\"],.flux-callout[data-kind=\"caution\"]{--c:var(--flux-warn)}.flux-callout[data-kind=\"tip\"]{--c:var(--flux-ok)}.flux-callout[data-kind=\"important\"]{--c:#af52de}\n";

package/dist/types/react/http-bridge.d.ts

@@ -8,3 +8,8 @@ export declare class HttpBridgeError extends Error {
  * (development, headless E2E tests, screenshots). In Electron the preload bridge is used instead.
  */
 export declare function createHttpBridge(baseUrl?: string): FluxBridge;
+/**
+ * Bridge for a static website export (`fluxplugin export`): reads `bootstrap.json` and has no main process behind it.
+ * Renderer-only plugins work; IPC calls reject with a clear message.
+ */
+export declare function createStaticBridge(bootstrapUrl?: string): FluxBridge;

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

@@ -0,0 +1,33 @@
+import React, { type ReactNode } from "react";
+import type { RendererFramework } from "./runtime.js";
+export interface LanguageDef {
+    code: string;
+    label: string;
+    nativeLabel?: string;
+    rtl?: boolean;
+}
+export interface MessagesDef {
+    locale: string;
+    messages: Record<string, string>;
+}
+export type TFunction = (key: string, fallback?: string, params?: Record<string, string | number>) => string;
+interface I18nCtx {
+    locale: string;
+    setLocale(code: string): void;
+    languages: LanguageDef[];
+    t: TFunction;
+}
+/** Declares the extension points plugins use to add languages and translations. Called by `declareHostPoints`. */
+export declare function declareI18nPoints(framework: RendererFramework): void;
+/**
+ * Translations come from plugins (extension point `i18n`): `languages` lists what the user can pick, `messages` maps keys to text.
+ * Components call `useT()("key", "English fallback")`, so an app without any language plugin simply shows the fallback.
+ */
+export declare function I18nProvider({ children, defaultLocale, storageKey }: {
+    children: ReactNode;
+    defaultLocale?: string;
+    storageKey?: string;
+}): React.ReactElement;
+export declare const useI18n: () => I18nCtx;
+export declare const useT: () => TFunction;
+export {};

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

@@ -9,3 +9,8 @@ export * from "./icons.js";
 export * from "./markdown.js";
 export * from "./theme.js";
 export * from "./titlebar.js";
+export * from "./ui.js";
+export * from "./media.js";
+export * from "./i18n.js";
+export * from "./sidebar.js";
+export * from "./settings.js";

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

@@ -3,6 +3,7 @@ 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 }: {
+export declare function Markdown({ source, baseUrl }: {
     source: string;
+    baseUrl?: string;
 }): React.ReactElement;

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

@@ -0,0 +1,33 @@
+import React from "react";
+import type { VideoInfo } from "../core/index.js";
+export type ImageInput = string | Blob | ArrayBuffer | Uint8Array | null | undefined;
+export interface ResolvedImage {
+    src: string;
+    /** Call when the image is no longer used (revokes object URLs). */
+    release?: () => void;
+}
+/**
+ * Turns any supported image source into something an <img> can show:
+ * https/http URLs, `data:image/*;base64,…`, raw base64 text, `blob:` URLs, Blob/File/ArrayBuffer objects, `file://` URLs,
+ * absolute local paths (C:\… or /…), and relative paths (resolved against `base`, e.g. a plugin's asset URL).
+ * Anything else (javascript:, other data: types…) returns undefined.
+ */
+export declare function toImageSrc(input: ImageInput, opts?: {
+    base?: string;
+}): ResolvedImage | undefined;
+/** <img> that accepts any source accepted by `toImageSrc`, with a graceful placeholder when it fails to load. */
+export declare function Img({ src, base, alt, fallback, className, style, ...rest }: {
+    src: ImageInput;
+    base?: string;
+    alt?: string;
+    fallback?: React.ReactNode;
+} & Omit<React.ImgHTMLAttributes<HTMLImageElement>, "src" | "alt">): React.ReactElement;
+/**
+ * Video player. Hosted players (YouTube, Vimeo, Dailymotion, Loom, Streamable) use a sandboxed iframe; direct media files
+ * (mp4/webm/ogg/mov, https or shipped inside a plugin) use the native HTML5 player; anything else becomes a link.
+ */
+export declare function VideoPlayer({ video, poster, title }: {
+    video: VideoInfo;
+    poster?: string;
+    title?: string;
+}): React.ReactElement;

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

@@ -0,0 +1,6 @@
+import React from "react";
+/**
+ * macOS "System Settings"-style screen. Sections are contributed to the `settings` extension point by the host and by
+ * plugins (language, appearance, your own…). Register the route `/settings/:section` (and `/settings`) with this component.
+ */
+export declare function SettingsPage(): React.ReactElement;