sibujs 4.4.0 → 4.6.0

package/dist/ecosystem.d.cts

@@ -1,5 +1,6 @@
-import { S as SibuPlugin } from './plugin-D30wlGW5.cjs';
-import { T as TagProps } from './tagFactory-Bzupt4Pj.cjs';
+import { S as SibuPlugin } from './plugin-DVgSnTfK.cjs';
+import { D as DerivedAccessor, T as TagProps, a as NodeChildren } from './tagFactory-DFstCLQV.cjs';
+import './signal-EotCj4hS.cjs';
 
 /** MobX autorun disposer function type. */
 type MobXReactionDisposer = () => void;
@@ -67,8 +68,12 @@ interface ReduxAdapterOptions<S = unknown> {
 interface ReduxAdapterAPI<S = unknown> {
     /** Full store state as a SibuJS reactive getter */
     getState: () => S;
-    /** Create a SibuJS reactive getter from a Redux selector */
-    select: <R>(selector: (state: S) => R) => () => R;
+    /**
+     * Create a SibuJS reactive getter from a Redux selector. The getter is a
+     * `derived()` subscribed to the store state; call its `dispose()` when a
+     * selector is discarded before the adapter.
+     */
+    select: <R>(selector: (state: S) => R) => DerivedAccessor<R>;
     /** Dispatch an action to the Redux store */
     dispatch: ReduxStore<S>["dispatch"];
     /** Unsubscribe from the Redux store */
@@ -110,8 +115,12 @@ interface ZustandAdapterOptions<S> {
 interface ZustandAdapterAPI<S> {
     /** Full Zustand state as a SibuJS reactive getter */
     getState: () => S;
-    /** Create a SibuJS reactive getter from a Zustand selector */
-    select: <R>(selector: (state: S) => R) => () => R;
+    /**
+     * Create a SibuJS reactive getter from a Zustand selector. The getter is a
+     * `derived()` subscribed to the store state; call its `dispose()` when a
+     * selector is discarded before the adapter.
+     */
+    select: <R>(selector: (state: S) => R) => DerivedAccessor<R>;
     /** Set state on the Zustand store */
     setState: ZustandStore<S>["setState"];
     /** Destroy the subscription and the Zustand store */
@@ -155,6 +164,16 @@ interface ThemeAPI {
     setTheme: (config: Partial<ThemeConfig>) => void;
     /** Resolve a component class name using prefix and overrides */
     resolveClass: (component: string, variant?: string) => string;
+    /**
+     * Install the theme's CSS variables on `root` (the theme root — typically the
+     * app container) and keep them in sync: variables added, changed or removed by
+     * `setTheme()` are reflected, and custom properties the theme never set are left
+     * alone. Handles may overlap on one root and be released in any order: the
+     * most recently applied live handle's value wins, and when no handle sets a
+     * property any more, the value and priority it had before are restored.
+     * Returns a function that stops syncing and releases this handle.
+     */
+    applyTo: (root: HTMLElement) => () => void;
 }
 /**
  * Creates a reactive theme for a UI component library adapter.
@@ -186,7 +205,12 @@ interface AdaptedComponentProps extends TagProps {
     /** Component size (e.g., "sm", "md", "lg") */
     size?: string;
 }
-type AdaptedComponent = (props?: AdaptedComponentProps) => Element;
+/**
+ * A component produced by {@link componentAdapter}. Children may be passed
+ * positionally, exactly like a tag factory: `Button({ variant: "primary" }, "Save")`.
+ * Positional children take precedence over a `nodes` prop.
+ */
+type AdaptedComponent = (props?: AdaptedComponentProps, children?: NodeChildren) => Element;
 /**
  * Creates a set of SibuJS components from a CSS framework's class mappings.
  *

package/dist/ecosystem.d.ts

@@ -1,5 +1,6 @@
-import { S as SibuPlugin } from './plugin-D30wlGW5.js';
-import { T as TagProps } from './tagFactory-Bzupt4Pj.js';
+import { S as SibuPlugin } from './plugin-DVgSnTfK.js';
+import { D as DerivedAccessor, T as TagProps, a as NodeChildren } from './tagFactory-DkaNVUNV.js';
+import './signal-EotCj4hS.js';
 
 /** MobX autorun disposer function type. */
 type MobXReactionDisposer = () => void;
@@ -67,8 +68,12 @@ interface ReduxAdapterOptions<S = unknown> {
 interface ReduxAdapterAPI<S = unknown> {
     /** Full store state as a SibuJS reactive getter */
     getState: () => S;
-    /** Create a SibuJS reactive getter from a Redux selector */
-    select: <R>(selector: (state: S) => R) => () => R;
+    /**
+     * Create a SibuJS reactive getter from a Redux selector. The getter is a
+     * `derived()` subscribed to the store state; call its `dispose()` when a
+     * selector is discarded before the adapter.
+     */
+    select: <R>(selector: (state: S) => R) => DerivedAccessor<R>;
     /** Dispatch an action to the Redux store */
     dispatch: ReduxStore<S>["dispatch"];
     /** Unsubscribe from the Redux store */
@@ -110,8 +115,12 @@ interface ZustandAdapterOptions<S> {
 interface ZustandAdapterAPI<S> {
     /** Full Zustand state as a SibuJS reactive getter */
     getState: () => S;
-    /** Create a SibuJS reactive getter from a Zustand selector */
-    select: <R>(selector: (state: S) => R) => () => R;
+    /**
+     * Create a SibuJS reactive getter from a Zustand selector. The getter is a
+     * `derived()` subscribed to the store state; call its `dispose()` when a
+     * selector is discarded before the adapter.
+     */
+    select: <R>(selector: (state: S) => R) => DerivedAccessor<R>;
     /** Set state on the Zustand store */
     setState: ZustandStore<S>["setState"];
     /** Destroy the subscription and the Zustand store */
@@ -155,6 +164,16 @@ interface ThemeAPI {
     setTheme: (config: Partial<ThemeConfig>) => void;
     /** Resolve a component class name using prefix and overrides */
     resolveClass: (component: string, variant?: string) => string;
+    /**
+     * Install the theme's CSS variables on `root` (the theme root — typically the
+     * app container) and keep them in sync: variables added, changed or removed by
+     * `setTheme()` are reflected, and custom properties the theme never set are left
+     * alone. Handles may overlap on one root and be released in any order: the
+     * most recently applied live handle's value wins, and when no handle sets a
+     * property any more, the value and priority it had before are restored.
+     * Returns a function that stops syncing and releases this handle.
+     */
+    applyTo: (root: HTMLElement) => () => void;
 }
 /**
  * Creates a reactive theme for a UI component library adapter.
@@ -186,7 +205,12 @@ interface AdaptedComponentProps extends TagProps {
     /** Component size (e.g., "sm", "md", "lg") */
     size?: string;
 }
-type AdaptedComponent = (props?: AdaptedComponentProps) => Element;
+/**
+ * A component produced by {@link componentAdapter}. Children may be passed
+ * positionally, exactly like a tag factory: `Button({ variant: "primary" }, "Save")`.
+ * Positional children take precedence over a `nodes` prop.
+ */
+type AdaptedComponent = (props?: AdaptedComponentProps, children?: NodeChildren) => Element;
 /**
  * Creates a set of SibuJS components from a CSS framework's class mappings.
  *

package/dist/ecosystem.js

@@ -7,19 +7,19 @@ import {
   mobXAdapter,
   reduxAdapter,
   zustandAdapter
-} from "./chunk-UCALUKB5.js";
-import "./chunk-WWV3SJ3L.js";
-import "./chunk-PNIRUQ4C.js";
-import "./chunk-VCTAEPSB.js";
-import "./chunk-W2EQ7X2L.js";
-import "./chunk-IXKSNWV5.js";
+} from "./chunk-BAAG6ZTI.js";
+import "./chunk-J6FW5TV6.js";
+import "./chunk-VVWPJ543.js";
+import "./chunk-47M47FOM.js";
+import "./chunk-QE4TTDU3.js";
+import "./chunk-2INLLLMZ.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-7GIHSAWB.js";
-import "./chunk-5DXA2J44.js";
-import "./chunk-QKRPLZ2V.js";
-import "./chunk-NVNJH22U.js";
-import "./chunk-3BTTCZ5J.js";
-import "./chunk-2WLZ6757.js";
+import "./chunk-XC4MEKGA.js";
+import "./chunk-7XHATCIH.js";
+import "./chunk-5HZXGZ6T.js";
+import "./chunk-D33YTSX5.js";
+import "./chunk-5Q4R7HCL.js";
+import "./chunk-NYNYSPK7.js";
 export {
   antdAdapter,
   chakraAdapter,