pi-extension-utils 0.7.5 → 0.7.7

package/dist/src/ui/client.js

@@ -76,6 +76,7 @@ export function createUiClient(fullscreen, ctx, capture = createTuiModeCapture()
                             if (restored)
                                 return;
                             restored = true;
+                            priorRoot?.invalidate?.();
                             layoutTui.setLayoutRoot(priorRoot);
                             layoutTui.requestRender?.(true);
                         };

package/dist/src/widgets/client.js

@@ -22,11 +22,59 @@ export function connectWidgetCoordinator(pi, opts) {
             factory: record.factory,
         });
     }
+    function emitHello() {
+        pi.events.emit(EVENTS.hello, basePayload(clientId));
+    }
+    function createWidgetRecord(placement, key, factory, order) {
+        const record = {
+            placement,
+            key,
+            factory,
+            fallbackFactory: (tui, theme) => {
+                const mount = {
+                    tui,
+                    theme,
+                    component: record.factory(tui, theme),
+                    disposed: false,
+                };
+                record.fallbackMount = mount;
+                return {
+                    render: (width) => (mount.disposed ? [] : mount.component.render(width)),
+                    invalidate: () => {
+                        if (!mount.disposed)
+                            mount.component.invalidate?.();
+                    },
+                    dispose: () => {
+                        if (mount.disposed)
+                            return;
+                        mount.disposed = true;
+                        mount.component.dispose?.();
+                        if (record.fallbackMount === mount)
+                            record.fallbackMount = undefined;
+                    },
+                };
+            },
+            order,
+        };
+        return record;
+    }
+    function updateFallback(record) {
+        const mount = record.fallbackMount;
+        if (!mount || mount.disposed) {
+            restoreFallback(record);
+            return;
+        }
+        mount.disposed = true;
+        mount.component.dispose?.();
+        mount.component = record.factory(mount.tui, mount.theme);
+        mount.disposed = false;
+        mount.tui?.requestRender?.();
+    }
     function clearFallback(record) {
         opts.ctx.ui.setWidget(record.key, undefined, { placement: record.placement });
     }
     function restoreFallback(record) {
-        opts.ctx.ui.setWidget(record.key, record.factory, { placement: record.placement });
+        opts.ctx.ui.setWidget(record.key, record.fallbackFactory, { placement: record.placement });
     }
     function attach() {
         if (disposed || coordinated)
@@ -45,7 +93,7 @@ export function connectWidgetCoordinator(pi, opts) {
             return;
         attach();
     });
-    pi.events.emit(EVENTS.hello, basePayload(clientId));
+    emitHello();
     const fullscreen = {
         acquire() {
             const token = `${clientId}-lease-${nextLeaseId++}`;
@@ -59,6 +107,8 @@ export function connectWidgetCoordinator(pi, opts) {
                 for (const record of widgets.values())
                     clearFallback(record);
             }
+            if (!coordinated)
+                emitHello();
             return {
                 release() {
                     if (released)
@@ -84,19 +134,31 @@ export function connectWidgetCoordinator(pi, opts) {
             set(placement, key, factory, setOpts = {}) {
                 if (disposed)
                     return;
-                const record = {
-                    placement,
-                    key,
-                    factory: opts.tui ? withTuiCapture(factory, opts.tui) : factory,
-                    order: setOpts.order ?? 0,
-                };
-                widgets.set(widgetId(placement, key), record);
+                const id = widgetId(placement, key);
+                const wrappedFactory = opts.tui ? withTuiCapture(factory, opts.tui) : factory;
+                let record = widgets.get(id);
+                const isNew = !record;
+                if (record) {
+                    record.factory = wrappedFactory;
+                    record.order = setOpts.order ?? 0;
+                }
+                else {
+                    record = createWidgetRecord(placement, key, wrappedFactory, setOpts.order ?? 0);
+                    widgets.set(id, record);
+                }
                 if (coordinated) {
                     emitRegister(record);
                 }
                 else if (leases.size === 0) {
-                    opts.ctx.ui.setWidget(key, record.factory, { placement });
+                    if (isNew) {
+                        restoreFallback(record);
+                    }
+                    else {
+                        updateFallback(record);
+                    }
                 }
+                if (!coordinated)
+                    emitHello();
             },
             remove(placement, key) {
                 const id = widgetId(placement, key);

package/docs/client.md

@@ -45,7 +45,7 @@ await client.ui.fullscreen((tui, theme, keybindings, done) => new MyComponent(tu
 - acquires a fullscreen lease
 - blanks coordinated widgets
 - preserves the regular-TUI editor-slot mount
-- temporarily replaces a capable fullscreen viewport TUI's layout root with the dashboard and forces redraws on install and restoration
+- temporarily replaces a capable fullscreen viewport TUI's layout root with the dashboard; restoration invalidates the prior root when supported, reinstalls that exact root, then forces a redraw
 - uses the overlay path as the safe cold-start/fallback mount without rendering the real dashboard twice
 - releases the lease in `finally`
 

package/docs/widgets.md

@@ -50,7 +50,7 @@ await client.ui.fullscreen((tui, theme, keybindings, done) => new MyComponent(tu
 
 ## Fallback
 
-If the host is not ready yet, widget calls use the extension's own `ctx.ui.setWidget`. When the host announces readiness, the client clears the fallback widget and re-registers through the coordinator.
+If the host is not ready yet, each logical widget registers one stable proxy through the extension's own `ctx.ui.setWidget`. Later `widgets.set` calls replace the proxy's delegated component and request a redraw without re-registering the raw widget, preserving cross-extension insertion order on Pi versions that delete before setting. Set and fullscreen-acquire activity also retry the hello handshake without a polling timer. When the host announces readiness, the client clears the fallback widget and re-registers through the coordinator.
 
 ## Example
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-extension-utils",
-	"version": "0.7.5",
+	"version": "0.7.7",
 	"description": "Shared Pi extension utilities for coordinated widgets, fullscreen leases, and logging.",
 	"type": "module",
 	"main": "./dist/src/index.js",