@iota-uz/sdk 0.8.0 → 0.9.0

package/README.md

@@ -5,6 +5,8 @@ subpath APIs are built from separate internal workspace modules:
 
 - `@iota-uz/sdk/client-host`
 - `@iota-uz/sdk/solid`
+- `@iota-uz/sdk/solid-ui`
+- `@iota-uz/sdk/solid-ui/standalone.css`
 - `@iota-uz/sdk/styles.css`
 - `@iota-uz/sdk/lens`
 - `@iota-uz/sdk/lens/styles.css`
@@ -15,3 +17,12 @@ exports are intentionally absent. Solid is the standard client-route renderer;
 React and ReactDOM remain optional peers for migration compatibility;
 Lens implementation dependencies are contained in lazy Lens chunks and are not
 loaded by client-host imports.
+
+Solid routes rendered inside the standard iota shell can use the component
+exports directly. Standalone applications and the component gallery import the
+compiled stylesheet once at their root:
+
+```ts
+import { Button, Input } from '@iota-uz/sdk/solid-ui'
+import '@iota-uz/sdk/solid-ui/standalone.css'
+```

package/dist/client-host/identity.d.ts

@@ -1,9 +1,9 @@
-export declare const SDK_RELEASE_VERSION = "0.8.0";
-export declare const SDK_SOURCE_COMMIT = "4db430f807b23db5df725e623b23b45ccb30c9db";
+export declare const SDK_RELEASE_VERSION = "0.9.0";
+export declare const SDK_SOURCE_COMMIT = "3a1e16e7bd004b02c27f688654321169d622cb0f";
 export declare const SDK_PROTOCOL_VERSION = "1.0.0";
 export declare const SDK_IDENTITY: Readonly<{
-    releaseVersion: "0.8.0";
-    sourceCommit: "4db430f807b23db5df725e623b23b45ccb30c9db";
+    releaseVersion: "0.9.0";
+    sourceCommit: "3a1e16e7bd004b02c27f688654321169d622cb0f";
     protocolVersion: "1.0.0";
 }>;
 export interface SDKRuntimeIdentity {

package/dist/client-host/identity.js

@@ -1,6 +1,6 @@
 import { CLIENT_HOST_PROTOCOL_VERSION } from './protocol';
-export const SDK_RELEASE_VERSION = '0.8.0';
-export const SDK_SOURCE_COMMIT = '4db430f807b23db5df725e623b23b45ccb30c9db';
+export const SDK_RELEASE_VERSION = '0.9.0';
+export const SDK_SOURCE_COMMIT = '3a1e16e7bd004b02c27f688654321169d622cb0f';
 export const SDK_PROTOCOL_VERSION = CLIENT_HOST_PROTOCOL_VERSION;
 export const SDK_IDENTITY = Object.freeze({
     releaseVersion: SDK_RELEASE_VERSION,

package/dist/client-host/portal-host.d.ts

@@ -0,0 +1,22 @@
+export type PortalSurface = 'modal' | 'drawer' | 'toast' | 'command';
+export declare const WIDGET_SLOT_NAMES: readonly ["navigation-leading", "navigation-trailing", "header-actions", "document-status"];
+export type WidgetSlotName = typeof WIDGET_SLOT_NAMES[number];
+export interface OverlayEntry {
+    id: string;
+    surface: PortalSurface;
+    restore: HTMLElement | null;
+}
+export declare class PortalRegistry {
+    private readonly owner;
+    private readonly background?;
+    private readonly roots;
+    private readonly overlays;
+    private locked;
+    constructor(owner: HTMLElement, background?: HTMLElement | undefined);
+    get ownerDocument(): Document;
+    root(surface: PortalSurface): HTMLElement;
+    mount(entry: OverlayEntry): () => void;
+    destroy(): void;
+    private sync;
+}
+//# sourceMappingURL=portal-host.d.ts.map

package/dist/client-host/portal-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-host.d.ts","sourceRoot":"","sources":["../src/portal-host.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;AACpE,eAAO,MAAM,iBAAiB,6FAA8F,CAAA;AAC5H,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAA;AAI7D,MAAM,WAAW,YAAY;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE;AA4CjG,qBAAa,cAAc;IAKb,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAe,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAJ7E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,MAAM,CAAQ;gBAEO,KAAK,EAAE,WAAW,EAAmB,UAAU,CAAC,EAAE,WAAW,YAAA;IAE1F,IAAI,aAAa,IAAI,QAAQ,CAAoC;IAEjE,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW;IAazC,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,IAAI;IAiBtC,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,IAAI;CAYb"}

package/dist/client-host/portal-host.js

@@ -0,0 +1,118 @@
+export const WIDGET_SLOT_NAMES = ['navigation-leading', 'navigation-trailing', 'header-actions', 'document-status'];
+const zLayers = { drawer: 600, modal: 700, command: 800, toast: 900 };
+const documentLocks = new WeakMap();
+const backgroundLocks = new WeakMap();
+function acquireDocumentLock(owner) {
+    const state = documentLocks.get(owner);
+    if (state) {
+        state.count += 1;
+        return;
+    }
+    documentLocks.set(owner, { count: 1, overflow: owner.documentElement.style.overflow });
+    owner.documentElement.style.overflow = 'hidden';
+}
+function releaseDocumentLock(owner) {
+    const state = documentLocks.get(owner);
+    if (!state)
+        return;
+    state.count -= 1;
+    if (state.count > 0)
+        return;
+    owner.documentElement.style.overflow = state.overflow;
+    documentLocks.delete(owner);
+}
+function acquireBackgroundLock(background) {
+    const state = backgroundLocks.get(background);
+    if (state) {
+        state.count += 1;
+        return;
+    }
+    backgroundLocks.set(background, { count: 1, inert: Boolean(background.inert), ariaHidden: background.getAttribute('aria-hidden') });
+    background.inert = true;
+    background.setAttribute('aria-hidden', 'true');
+}
+function releaseBackgroundLock(background) {
+    const state = backgroundLocks.get(background);
+    if (!state)
+        return;
+    state.count -= 1;
+    if (state.count > 0)
+        return;
+    background.inert = state.inert;
+    if (state.ariaHidden === null)
+        background.removeAttribute('aria-hidden');
+    else
+        background.setAttribute('aria-hidden', state.ariaHidden);
+    backgroundLocks.delete(background);
+}
+function isBlocking(surface) {
+    return surface === 'modal' || surface === 'drawer' || surface === 'command';
+}
+export class PortalRegistry {
+    owner;
+    background;
+    roots = new Map();
+    overlays = [];
+    locked = false;
+    constructor(owner, background) {
+        this.owner = owner;
+        this.background = background;
+    }
+    get ownerDocument() { return this.owner.ownerDocument; }
+    root(surface) {
+        let root = this.roots.get(surface);
+        if (!root) {
+            root = this.owner.ownerDocument.createElement('div');
+            root.dataset.iotaPortal = surface;
+            root.style.position = 'relative';
+            root.style.zIndex = String(zLayers[surface]);
+            this.owner.append(root);
+            this.roots.set(surface, root);
+        }
+        return root;
+    }
+    mount(entry) {
+        this.overlays.push(entry);
+        this.sync();
+        return () => {
+            const index = this.overlays.findIndex((candidate) => candidate.id === entry.id);
+            if (index < 0)
+                return;
+            const wasTopBlocking = isBlocking(entry.surface) && !this.overlays.slice(index + 1).some(({ surface }) => isBlocking(surface));
+            const nextBlocking = this.overlays.slice(index + 1).find(({ surface }) => isBlocking(surface));
+            this.overlays.splice(index, 1);
+            // A nested overlay normally restores into its parent. If that parent is
+            // removed first, preserve the parent's still-connected restore target.
+            if (nextBlocking && !nextBlocking.restore?.isConnected)
+                nextBlocking.restore = entry.restore;
+            this.sync();
+            if (wasTopBlocking && entry.restore?.isConnected)
+                entry.restore.focus();
+        };
+    }
+    destroy() {
+        const restore = this.overlays.find(({ surface }) => isBlocking(surface))?.restore;
+        this.overlays.splice(0);
+        this.sync();
+        for (const root of this.roots.values())
+            root.remove();
+        this.roots.clear();
+        if (restore?.isConnected)
+            restore.focus();
+    }
+    sync() {
+        const blocking = this.overlays.some(({ surface }) => isBlocking(surface));
+        if (blocking && !this.locked) {
+            this.locked = true;
+            acquireDocumentLock(this.owner.ownerDocument);
+            if (this.background)
+                acquireBackgroundLock(this.background);
+        }
+        else if (!blocking && this.locked) {
+            this.locked = false;
+            releaseDocumentLock(this.owner.ownerDocument);
+            if (this.background)
+                releaseBackgroundLock(this.background);
+        }
+    }
+}

package/dist/client-host/portals.d.ts

@@ -1,6 +1,6 @@
 import { type PropsWithChildren, type ReactNode } from 'react';
-export type PortalSurface = 'modal' | 'drawer' | 'toast' | 'command';
-export type WidgetSlotName = 'navigation-leading' | 'navigation-trailing' | 'header-actions' | 'document-status';
+import { type PortalSurface, type WidgetSlotName } from './portal-host';
+export type { PortalSurface, WidgetSlotName } from './portal-host';
 export interface ClientHostProviderProps extends PropsWithChildren {
     portalOwner: HTMLElement;
     background?: HTMLElement | undefined;

package/dist/client-host/portals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portals.d.ts","sourceRoot":"","sources":["../src/portals.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAA2D,MAAM,OAAO,CAAA;AAG1J,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;AACpE,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,qBAAqB,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;AA2EhH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,WAAW,EAAE,WAAW,CAAA;IACxB,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,GAAG,SAAS,CAAA;IACtE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CACrC;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,WAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,uBAAuB,2CAQzH;AAED,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IAAG,OAAO,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE;AAErK,wBAAgB,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,+BA0B3F;AAED;2EAC2E;AAC3E,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,gHAIlH;AAaD,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,sCAG3F"}
+{"version":3,"file":"portals.d.ts","sourceRoot":"","sources":["../src/portals.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAA2D,MAAM,OAAO,CAAA;AAE1J,OAAO,EAAkB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAEvF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAKlE,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,WAAW,EAAE,WAAW,CAAA;IACxB,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,GAAG,SAAS,CAAA;IACtE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CACrC;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,WAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,uBAAuB,2CAazH;AAED,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IAAG,OAAO,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE;AAErK,wBAAgB,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,+BA0B3F;AAED;2EAC2E;AAC3E,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,gHAIlH;AAaD,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,sCAG3F"}

package/dist/client-host/portals.js

@@ -1,90 +1,25 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { createContext, useContext, useEffect, useId, useMemo, useRef, useState } from 'react';
 import { createPortal } from 'react-dom';
-const zLayers = { drawer: 600, modal: 700, command: 800, toast: 900 };
-class PortalRegistry {
-    owner;
-    background;
-    roots = new Map();
-    overlays = [];
-    lockState;
-    constructor(owner, background) {
-        this.owner = owner;
-        this.background = background;
-    }
-    root(surface) {
-        let root = this.roots.get(surface);
-        if (!root) {
-            root = document.createElement('div');
-            root.dataset.iotaPortal = surface;
-            root.style.position = 'relative';
-            root.style.zIndex = String(zLayers[surface]);
-            this.owner.append(root);
-            this.roots.set(surface, root);
-        }
-        return root;
-    }
-    mount(entry) {
-        this.overlays.push(entry);
-        this.sync();
-        return () => {
-            const index = this.overlays.findIndex((candidate) => candidate.id === entry.id);
-            const wasTop = index === this.overlays.length - 1;
-            if (index >= 0)
-                this.overlays.splice(index, 1);
-            this.sync();
-            if (wasTop)
-                entry.restore?.focus();
-        };
-    }
-    destroy() {
-        this.overlays.splice(0);
-        this.sync();
-        for (const root of this.roots.values())
-            root.remove();
-        this.roots.clear();
-    }
-    sync() {
-        const blocking = this.overlays.some(({ surface }) => surface === 'modal' || surface === 'drawer' || surface === 'command');
-        if (blocking && !this.lockState) {
-            this.lockState = {
-                overflow: document.documentElement.style.overflow,
-                ...(this.background ? {
-                    inert: this.background.inert,
-                    ariaHidden: this.background.getAttribute('aria-hidden'),
-                } : {}),
-            };
-            document.documentElement.style.overflow = 'hidden';
-            if (!this.background)
-                return;
-            this.background.inert = blocking;
-            this.background.setAttribute('aria-hidden', 'true');
-            return;
-        }
-        if (!blocking && this.lockState) {
-            document.documentElement.style.overflow = this.lockState.overflow;
-            if (this.background) {
-                this.background.inert = this.lockState.inert ?? false;
-                if (this.lockState.ariaHidden === null || this.lockState.ariaHidden === undefined)
-                    this.background.removeAttribute('aria-hidden');
-                else
-                    this.background.setAttribute('aria-hidden', this.lockState.ariaHidden);
-            }
-            this.lockState = undefined;
-        }
-    }
-}
+import { PortalRegistry } from './portal-host';
 const PortalContext = createContext(undefined);
 const WidgetContext = createContext(new Map());
 /** Owns document-lifetime portal roots; feature roots must never append to body. */
 export function ClientHostProvider({ portalOwner, background, widgetSlots = {}, theme, children }) {
     const registry = useMemo(() => new PortalRegistry(portalOwner, background), [portalOwner, background]);
     const slots = useMemo(() => new Map(Object.entries(widgetSlots)), [widgetSlots]);
+    useEffect(() => () => registry.destroy(), [registry]);
     useEffect(() => {
+        const baseTheme = portalOwner.getAttribute('data-theme');
         if (theme)
             portalOwner.dataset.theme = theme;
-        return () => { registry.destroy(); delete portalOwner.dataset.theme; };
-    }, [portalOwner, registry, theme]);
+        return () => {
+            if (baseTheme === null)
+                delete portalOwner.dataset.theme;
+            else
+                portalOwner.setAttribute('data-theme', baseTheme);
+        };
+    }, [portalOwner, theme]);
     return _jsx(PortalContext.Provider, { value: registry, children: _jsx(WidgetContext.Provider, { value: slots, children: children }) });
 }
 export function Portal({ surface, label, className, onEscape, theme, children }) {
@@ -93,7 +28,7 @@ export function Portal({ surface, label, className, onEscape, theme, children })
         throw new Error('Portal must be rendered inside ClientHostProvider');
     const id = useId();
     const content = useRef(null);
-    useEffect(() => registry.mount({ id, surface, restore: document.activeElement }), [id, registry, surface]);
+    useEffect(() => registry.mount({ id, surface, restore: registry.ownerDocument.activeElement }), [id, registry, surface]);
     useEffect(() => {
         if (surface === 'toast')
             return;
@@ -118,11 +53,11 @@ export function Portal({ surface, label, className, onEscape, theme, children })
         }
         const first = focusable[0];
         const last = focusable.at(-1);
-        if (event.shiftKey && document.activeElement === first) {
+        if (event.shiftKey && registry.ownerDocument.activeElement === first) {
             event.preventDefault();
             last?.focus();
         }
-        else if (!event.shiftKey && document.activeElement === last) {
+        else if (!event.shiftKey && registry.ownerDocument.activeElement === last) {
             event.preventDefault();
             first?.focus();
         }

package/dist/client-host/solid-index.d.ts

@@ -8,6 +8,7 @@ export * from './protocol';
 export * from './rpc-core';
 export * from './services';
 export * from './solid';
+export * from './solid-portals';
 export * from './solid-rpc';
 export * from './transport';
 //# sourceMappingURL=solid-index.d.ts.map

package/dist/client-host/solid-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solid-index.d.ts","sourceRoot":"","sources":["../src/solid-index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"solid-index.d.ts","sourceRoot":"","sources":["../src/solid-index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/client-host/solid-index.js

@@ -8,5 +8,6 @@ export * from './protocol';
 export * from './rpc-core';
 export * from './services';
 export * from './solid';
+export * from './solid-portals';
 export * from './solid-rpc';
 export * from './transport';

package/dist/client-host/solid-portals.d.ts

@@ -0,0 +1,27 @@
+import { type JSX } from 'solid-js';
+import { PortalRegistry, type PortalSurface, type WidgetSlotName } from './portal-host';
+export type { PortalSurface, WidgetSlotName } from './portal-host';
+export interface SolidPortalHost {
+    registry: PortalRegistry;
+    slots: ReadonlyMap<WidgetSlotName, HTMLElement>;
+    registerCleanup(cleanup: () => void): () => void;
+}
+export declare function SolidPortalHostProvider(props: {
+    host: SolidPortalHost;
+    children: JSX.Element;
+}): JSX.Element;
+export interface PortalProps {
+    surface: PortalSurface;
+    label: string;
+    class?: string;
+    className?: string;
+    onEscape?: () => void;
+    theme?: 'light' | 'dark';
+    children?: JSX.Element;
+}
+export declare function Portal(props: PortalProps): JSX.Element;
+export declare function WidgetSlot(props: {
+    name: WidgetSlotName;
+    children?: JSX.Element;
+}): JSX.Element;
+//# sourceMappingURL=solid-portals.d.ts.map

package/dist/client-host/solid-portals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid-portals.d.ts","sourceRoot":"","sources":["../src/solid-portals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgG,KAAK,GAAG,EAAE,MAAM,UAAU,CAAA;AAEjI,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAEvF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAElE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAA;IACxB,KAAK,EAAE,WAAW,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;IAC/C,eAAe,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CACjD;AAID,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAK5G;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,aAAa,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;CACvB;AAID,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,CAAC,OAAO,CAqEtD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CA0B/F"}

package/dist/client-host/solid-portals.js

@@ -0,0 +1,112 @@
+import { createComponent, createContext, createEffect, createUniqueId, onCleanup, onMount, useContext } from 'solid-js';
+import { insert } from 'solid-js/web';
+const PortalHostContext = createContext();
+export function SolidPortalHostProvider(props) {
+    return createComponent(PortalHostContext.Provider, {
+        value: props.host,
+        get children() { return props.children; },
+    });
+}
+const focusableSelector = 'a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])';
+export function Portal(props) {
+    const host = useContext(PortalHostContext);
+    if (!host)
+        throw new Error('Portal must be rendered inside a mounted Solid client route with a portal owner');
+    const id = createUniqueId();
+    const document = host.registry.ownerDocument;
+    const content = document.createElement('div');
+    const marker = document.createTextNode('');
+    const activeElement = document.activeElement;
+    const restore = activeElement && 'focus' in activeElement ? activeElement : null;
+    let unmountOverlay = () => undefined;
+    let unregisterHostCleanup = () => undefined;
+    let cleaned = false;
+    insert(content, () => props.children);
+    createEffect(() => {
+        content.className = props.class ?? props.className ?? '';
+        content.dataset.iotaSurface = props.surface;
+        if (props.theme)
+            content.dataset.theme = props.theme;
+        else
+            delete content.dataset.theme;
+    });
+    content.setAttribute('role', props.surface === 'toast' ? 'status' : 'dialog');
+    content.setAttribute('aria-label', props.label);
+    content.tabIndex = -1;
+    if (props.surface !== 'toast')
+        content.setAttribute('aria-modal', 'true');
+    const onKeyDown = (event) => {
+        if (event.key === 'Escape' && props.onEscape) {
+            event.preventDefault();
+            event.stopPropagation();
+            props.onEscape();
+            return;
+        }
+        if (event.key !== 'Tab' || props.surface === 'toast')
+            return;
+        const focusable = Array.from(content.querySelectorAll(focusableSelector));
+        if (focusable.length === 0) {
+            event.preventDefault();
+            content.focus();
+            return;
+        }
+        const first = focusable[0];
+        const last = focusable.at(-1);
+        if (event.shiftKey && document.activeElement === first) {
+            event.preventDefault();
+            last?.focus();
+        }
+        else if (!event.shiftKey && document.activeElement === last) {
+            event.preventDefault();
+            first?.focus();
+        }
+    };
+    content.addEventListener('keydown', onKeyDown);
+    const cleanup = () => {
+        if (cleaned)
+            return;
+        cleaned = true;
+        content.removeEventListener('keydown', onKeyDown);
+        content.remove();
+        unmountOverlay();
+        unregisterHostCleanup();
+    };
+    onMount(() => {
+        host.registry.root(props.surface).append(content);
+        unmountOverlay = host.registry.mount({ id, surface: props.surface, restore });
+        unregisterHostCleanup = host.registerCleanup(cleanup);
+        if (props.surface !== 'toast')
+            (content.querySelector(focusableSelector) ?? content).focus();
+    });
+    onCleanup(cleanup);
+    return marker;
+}
+export function WidgetSlot(props) {
+    const host = useContext(PortalHostContext);
+    if (!host)
+        throw new Error('WidgetSlot must be rendered inside a mounted Solid client route with a portal owner');
+    const slot = host.slots.get(props.name);
+    if (!slot) {
+        host.registry.ownerDocument.defaultView?.console.warn(`Solid widget slot ${props.name} is unavailable`);
+        return undefined;
+    }
+    const container = slot.ownerDocument.createElement('div');
+    const marker = slot.ownerDocument.createTextNode('');
+    let unregisterHostCleanup = () => undefined;
+    let cleaned = false;
+    container.style.display = 'contents';
+    insert(container, () => props.children);
+    const cleanup = () => {
+        if (cleaned)
+            return;
+        cleaned = true;
+        container.remove();
+        unregisterHostCleanup();
+    };
+    onMount(() => {
+        slot.append(container);
+        unregisterHostCleanup = host.registerCleanup(cleanup);
+    });
+    onCleanup(cleanup);
+    return marker;
+}

package/dist/client-host/solid.d.ts

@@ -1,5 +1,6 @@
 import { type Component } from 'solid-js';
 import { type ClientRouteContext } from './bootstrap';
+import { type WidgetSlotName } from './portal-host';
 import { type ClientHostServices } from './services';
 export declare function useClientHost(): ClientHostServices;
 export interface SolidRouteProps<TInitial = unknown> {
@@ -11,7 +12,21 @@ export interface MountSolidClientRouteOptions<TInitial, TProps extends object> {
     props: TProps;
     context: ClientRouteContext<TInitial>;
     services?: ClientHostServices;
+    portals?: HTMLElement;
+    background?: HTMLElement;
+    widgetSlots?: Partial<Record<WidgetSlotName, HTMLElement>>;
 }
 export declare function mountSolidClientRoute<TInitial, TProps extends object>(options: MountSolidClientRouteOptions<TInitial, TProps>): () => void;
 export declare function mountSolidClientRouteFromDocument<TInitial, TProps extends object>(component: Component<TProps & SolidRouteProps<TInitial>>, props: TProps, owner?: Document): () => void;
+export interface SolidFeatureModule {
+    default: Component<SolidRouteProps<never>>;
+}
+export type SolidFeatureCatalog = Record<string, () => Promise<SolidFeatureModule>>;
+export interface MountSolidFeatureCatalogOptions {
+    catalog: SolidFeatureCatalog;
+    owner?: Document;
+    /** Must navigate or dispose the current mount so Retry does not retain ownership. */
+    reload?: () => void;
+}
+export declare function mountSolidFeatureCatalogFromDocument(options: MountSolidFeatureCatalogOptions): () => void;
 //# sourceMappingURL=solid.d.ts.map

package/dist/client-host/solid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solid.d.ts","sourceRoot":"","sources":["../src/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,SAAS,EAAE,MAAM,UAAU,CAAA;AAErF,OAAO,EAA8C,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACjG,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAI9E,wBAAgB,aAAa,IAAI,kBAAkB,CAIlD;AAED,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO;IACjD,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,4BAA4B,CAAC,QAAQ,EAAE,MAAM,SAAS,MAAM;IAC3E,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAA;IACxD,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAC9B;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,SAAS,MAAM,EAAE,OAAO,EAAE,4BAA4B,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,CAmD1I;AAED,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,SAAS,MAAM,EAC/E,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,EACxD,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,QAAmB,GACzB,MAAM,IAAI,CAIZ"}
+{"version":3,"file":"solid.d.ts","sourceRoot":"","sources":["../src/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,SAAS,EAAE,MAAM,UAAU,CAAA;AAErF,OAAO,EAA8C,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACjG,OAAO,EAAqC,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AACtF,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAK9E,wBAAgB,aAAa,IAAI,kBAAkB,CAIlD;AAED,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO;IACjD,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,4BAA4B,CAAC,QAAQ,EAAE,MAAM,SAAS,MAAM;IAC3E,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAA;IACxD,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,UAAU,CAAC,EAAE,WAAW,CAAA;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAA;CAC3D;AAoED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,SAAS,MAAM,EAAE,OAAO,EAAE,4BAA4B,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,CA6F1I;AAED,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,SAAS,MAAM,EAC/E,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,EACxD,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,QAAmB,GACzB,MAAM,IAAI,CAcZ;AAED,MAAM,WAAW,kBAAkB;IAGjC,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;CAC3C;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAA;AAEnF,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,mBAAmB,CAAA;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB;AAeD,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,+BAA+B,GACvC,MAAM,IAAI,CAsGZ"}