sibujs 4.5.0 → 4.6.0

package/dist/performance.d.cts

@@ -1,5 +1,5 @@
-import { T as TrustedHTML } from './ssr-BiPRdZ6n.cjs';
-export { t as trustHTML } from './ssr-BiPRdZ6n.cjs';
+import { T as TrustedHTML } from './ssr-Bli9XRW5.cjs';
+export { t as trustHTML } from './ssr-Bli9XRW5.cjs';
 
 declare const Priority: {
     readonly IMMEDIATE: 0;

package/dist/performance.d.ts

@@ -1,5 +1,5 @@
-import { T as TrustedHTML } from './ssr-BiPRdZ6n.js';
-export { t as trustHTML } from './ssr-BiPRdZ6n.js';
+import { T as TrustedHTML } from './ssr-Bli9XRW5.js';
+export { t as trustHTML } from './ssr-Bli9XRW5.js';
 
 declare const Priority: {
     readonly IMMEDIATE: 0;

package/dist/performance.js

@@ -33,18 +33,17 @@ import {
   transitionState,
   uniqueId,
   yieldToMain
-} from "./chunk-TBYTO6BS.js";
+} from "./chunk-DKGBBKOF.js";
 import {
   trustHTML
-} from "./chunk-NIOYEGBQ.js";
-import "./chunk-IXKSNWV5.js";
+} from "./chunk-HURREPU2.js";
+import "./chunk-2INLLLMZ.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-RIXRAYIU.js";
-import "./chunk-5DXA2J44.js";
-import "./chunk-QKRPLZ2V.js";
-import "./chunk-XZZOBQAY.js";
-import "./chunk-UGRX3S57.js";
-import "./chunk-2WLZ6757.js";
+import "./chunk-XC4MEKGA.js";
+import "./chunk-7XHATCIH.js";
+import "./chunk-D33YTSX5.js";
+import "./chunk-5Q4R7HCL.js";
+import "./chunk-NYNYSPK7.js";
 export {
   DOMPool,
   Features,

package/dist/plugin-DVgSnTfK.d.cts

@@ -0,0 +1,112 @@
+interface PluginContext {
+    /** Register a global hook */
+    onInit: (callback: () => void) => void;
+    onMount: (callback: (element: HTMLElement) => void) => void;
+    onUnmount: (callback: (element: HTMLElement) => void) => void;
+    onError: (callback: (error: Error) => void) => void;
+    /** Provide a value globally */
+    provide: (key: string, value: unknown) => void;
+}
+interface SibuPlugin {
+    name: string;
+    /**
+     * Register hooks and providers. May be async: the plugin is committed only
+     * when the returned promise fulfils, and a rejection commits nothing and
+     * leaves the plugin installable again.
+     */
+    install: (ctx: PluginContext, options?: unknown) => void | PromiseLike<void>;
+}
+interface PluginHooks {
+    init: Array<() => void>;
+    mount: Array<(element: HTMLElement) => void>;
+    unmount: Array<(element: HTMLElement) => void>;
+    error: Array<(error: Error) => void>;
+}
+/** Shared across duplicate copies of this module: see the class below. */
+declare const CANCELLED_BRAND: unique symbol;
+/**
+ * An installation that never took effect because `reset()` (or a newer install
+ * of the same name) invalidated it. Thrown by a synchronous install that reset
+ * its own registry, and the rejection of a cancelled async install — a
+ * deliberate cancellation, not a failure, so it is not reported as a runtime
+ * error.
+ */
+declare class PluginInstallCancelledError extends Error {
+    /** The plugin whose installation was cancelled. */
+    readonly pluginName: string;
+    /**
+     * Brand, not identity: the default registry is shared across duplicate copies
+     * of this module, so the error a caller receives may come from another copy's
+     * constructor. `instanceof` is taught to recognise the brand instead.
+     */
+    readonly [CANCELLED_BRAND] = true;
+    constructor(pluginName: string);
+    static [Symbol.hasInstance](value: unknown): boolean;
+}
+/**
+ * Whether `value` is a cancelled-installation error, from this copy of the
+ * module or any duplicate of it.
+ */
+declare function isPluginInstallCancelledError(value: unknown): value is PluginInstallCancelledError;
+interface PluginRegistry {
+    readonly installedPlugins: Set<string>;
+    readonly hooks: PluginHooks;
+    readonly provided: Map<string, unknown>;
+    /**
+     * Install a plugin. Returns a promise for an async `install()` — awaited, it
+     * fulfils when the plugin is committed, rejects with the install failure, or
+     * rejects with {@link PluginInstallCancelledError} when `reset()` invalidated
+     * it; a synchronous install returns `undefined` and throws on failure.
+     */
+    plugin: (p: SibuPlugin, options?: unknown) => void | Promise<void>;
+    inject: <T = unknown>(key: string, defaultValue?: T) => T;
+    triggerMount: (element: HTMLElement) => void;
+    triggerUnmount: (element: HTMLElement) => void;
+    triggerError: (error: Error) => void;
+    reset: () => void;
+}
+/**
+ * Create an isolated plugin registry. Useful for tests, SSR per-request
+ * isolation, or embedding multiple independent SibuJS apps on one page.
+ */
+declare function createPluginRegistry(): PluginRegistry;
+/**
+ * Creates a plugin definition.
+ */
+declare function createPlugin(name: string, install: (ctx: PluginContext, options?: unknown) => void | PromiseLike<void>): SibuPlugin;
+/**
+ * Installs a plugin into the default (singleton) registry.
+ *
+ * Returns the installation's completion promise when `install()` is async —
+ * await it to know the plugin is ready, or to catch a failed installation — and
+ * `undefined` for a synchronous install (which throws on failure).
+ */
+declare function plugin(plugin: SibuPlugin, options?: unknown): void | Promise<void>;
+/**
+ * Retrieve a value provided by a plugin (from the default registry).
+ */
+declare function inject<T = unknown>(key: string, defaultValue?: T): T;
+/**
+ * Trigger mount hooks for an element (default registry).
+ */
+declare function triggerPluginMount(element: HTMLElement): void;
+/**
+ * Trigger unmount hooks for an element (default registry).
+ */
+declare function triggerPluginUnmount(element: HTMLElement): void;
+/**
+ * Trigger error hooks (default registry).
+ */
+declare function triggerPluginError(error: Error): void;
+/**
+ * Reset the default plugin registry (useful for testing).
+ */
+declare function resetPlugins(): void;
+/**
+ * Replace the default registry with an isolated one. Emits a dev warning
+ * if the default singleton already had plugins installed (to surface
+ * accidental interleaving of singleton + registry use).
+ */
+declare function setDefaultPluginRegistry(registry: PluginRegistry): void;
+
+export { type PluginContext as P, type SibuPlugin as S, PluginInstallCancelledError as a, type PluginRegistry as b, createPlugin as c, createPluginRegistry as d, isPluginInstallCancelledError as e, triggerPluginMount as f, triggerPluginUnmount as g, inject as i, plugin as p, resetPlugins as r, setDefaultPluginRegistry as s, triggerPluginError as t };

package/dist/plugin-DVgSnTfK.d.ts

@@ -0,0 +1,112 @@
+interface PluginContext {
+    /** Register a global hook */
+    onInit: (callback: () => void) => void;
+    onMount: (callback: (element: HTMLElement) => void) => void;
+    onUnmount: (callback: (element: HTMLElement) => void) => void;
+    onError: (callback: (error: Error) => void) => void;
+    /** Provide a value globally */
+    provide: (key: string, value: unknown) => void;
+}
+interface SibuPlugin {
+    name: string;
+    /**
+     * Register hooks and providers. May be async: the plugin is committed only
+     * when the returned promise fulfils, and a rejection commits nothing and
+     * leaves the plugin installable again.
+     */
+    install: (ctx: PluginContext, options?: unknown) => void | PromiseLike<void>;
+}
+interface PluginHooks {
+    init: Array<() => void>;
+    mount: Array<(element: HTMLElement) => void>;
+    unmount: Array<(element: HTMLElement) => void>;
+    error: Array<(error: Error) => void>;
+}
+/** Shared across duplicate copies of this module: see the class below. */
+declare const CANCELLED_BRAND: unique symbol;
+/**
+ * An installation that never took effect because `reset()` (or a newer install
+ * of the same name) invalidated it. Thrown by a synchronous install that reset
+ * its own registry, and the rejection of a cancelled async install — a
+ * deliberate cancellation, not a failure, so it is not reported as a runtime
+ * error.
+ */
+declare class PluginInstallCancelledError extends Error {
+    /** The plugin whose installation was cancelled. */
+    readonly pluginName: string;
+    /**
+     * Brand, not identity: the default registry is shared across duplicate copies
+     * of this module, so the error a caller receives may come from another copy's
+     * constructor. `instanceof` is taught to recognise the brand instead.
+     */
+    readonly [CANCELLED_BRAND] = true;
+    constructor(pluginName: string);
+    static [Symbol.hasInstance](value: unknown): boolean;
+}
+/**
+ * Whether `value` is a cancelled-installation error, from this copy of the
+ * module or any duplicate of it.
+ */
+declare function isPluginInstallCancelledError(value: unknown): value is PluginInstallCancelledError;
+interface PluginRegistry {
+    readonly installedPlugins: Set<string>;
+    readonly hooks: PluginHooks;
+    readonly provided: Map<string, unknown>;
+    /**
+     * Install a plugin. Returns a promise for an async `install()` — awaited, it
+     * fulfils when the plugin is committed, rejects with the install failure, or
+     * rejects with {@link PluginInstallCancelledError} when `reset()` invalidated
+     * it; a synchronous install returns `undefined` and throws on failure.
+     */
+    plugin: (p: SibuPlugin, options?: unknown) => void | Promise<void>;
+    inject: <T = unknown>(key: string, defaultValue?: T) => T;
+    triggerMount: (element: HTMLElement) => void;
+    triggerUnmount: (element: HTMLElement) => void;
+    triggerError: (error: Error) => void;
+    reset: () => void;
+}
+/**
+ * Create an isolated plugin registry. Useful for tests, SSR per-request
+ * isolation, or embedding multiple independent SibuJS apps on one page.
+ */
+declare function createPluginRegistry(): PluginRegistry;
+/**
+ * Creates a plugin definition.
+ */
+declare function createPlugin(name: string, install: (ctx: PluginContext, options?: unknown) => void | PromiseLike<void>): SibuPlugin;
+/**
+ * Installs a plugin into the default (singleton) registry.
+ *
+ * Returns the installation's completion promise when `install()` is async —
+ * await it to know the plugin is ready, or to catch a failed installation — and
+ * `undefined` for a synchronous install (which throws on failure).
+ */
+declare function plugin(plugin: SibuPlugin, options?: unknown): void | Promise<void>;
+/**
+ * Retrieve a value provided by a plugin (from the default registry).
+ */
+declare function inject<T = unknown>(key: string, defaultValue?: T): T;
+/**
+ * Trigger mount hooks for an element (default registry).
+ */
+declare function triggerPluginMount(element: HTMLElement): void;
+/**
+ * Trigger unmount hooks for an element (default registry).
+ */
+declare function triggerPluginUnmount(element: HTMLElement): void;
+/**
+ * Trigger error hooks (default registry).
+ */
+declare function triggerPluginError(error: Error): void;
+/**
+ * Reset the default plugin registry (useful for testing).
+ */
+declare function resetPlugins(): void;
+/**
+ * Replace the default registry with an isolated one. Emits a dev warning
+ * if the default singleton already had plugins installed (to surface
+ * accidental interleaving of singleton + registry use).
+ */
+declare function setDefaultPluginRegistry(registry: PluginRegistry): void;
+
+export { type PluginContext as P, type SibuPlugin as S, PluginInstallCancelledError as a, type PluginRegistry as b, createPlugin as c, createPluginRegistry as d, isPluginInstallCancelledError as e, triggerPluginMount as f, triggerPluginUnmount as g, inject as i, plugin as p, resetPlugins as r, setDefaultPluginRegistry as s, triggerPluginError as t };