@furystack/shades 12.2.5 → 12.4.0

package/esm/shade.spec.js

@@ -1,6 +1,6 @@
 import { Injector } from '@furystack/inject';
-import { sleepAsync, usingAsync } from '@furystack/utils';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { ObservableValue, sleepAsync, usingAsync } from '@furystack/utils';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { initializeShadeRoot } from './initialize.js';
 import { createComponent } from './shade-component.js';
 import { flushUpdates, Shade } from './shade.js';
@@ -82,6 +82,97 @@ describe('Shade edge cases', () => {
             });
         });
     });
+    describe('disconnected component should not re-render', () => {
+        it('should not re-render when updateComponent is called after removal', async () => {
+            await usingAsync(new Injector(), async (injector) => {
+                const rootElement = document.getElementById('root');
+                const renderCounter = vi.fn();
+                const ExampleComponent = Shade({
+                    shadowDomName: 'shade-no-render-after-disconnect',
+                    render: () => {
+                        renderCounter();
+                        return createComponent("div", null, "content");
+                    },
+                });
+                initializeShadeRoot({
+                    injector,
+                    rootElement,
+                    jsxElement: createComponent(ExampleComponent, null),
+                });
+                await flushUpdates();
+                const element = document.querySelector('shade-no-render-after-disconnect');
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+                element.remove();
+                await flushUpdates();
+                element.updateComponent();
+                await flushUpdates();
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+            });
+        });
+        it('should not re-render when updateComponentSync is called after removal', async () => {
+            await usingAsync(new Injector(), async (injector) => {
+                const rootElement = document.getElementById('root');
+                const renderCounter = vi.fn();
+                const ExampleComponent = Shade({
+                    shadowDomName: 'shade-no-sync-render-after-disconnect',
+                    render: () => {
+                        renderCounter();
+                        return createComponent("div", null, "content");
+                    },
+                });
+                initializeShadeRoot({
+                    injector,
+                    rootElement,
+                    jsxElement: createComponent(ExampleComponent, null),
+                });
+                await flushUpdates();
+                const element = document.querySelector('shade-no-sync-render-after-disconnect');
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+                element.remove();
+                await flushUpdates();
+                element.updateComponentSync();
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+            });
+        });
+        it('should not re-render when an observable fires during disposal', async () => {
+            await usingAsync(new Injector(), async (injector) => {
+                const rootElement = document.getElementById('root');
+                const renderCounter = vi.fn();
+                const obs = new ObservableValue(0);
+                const ExampleComponent = Shade({
+                    shadowDomName: 'shade-no-render-during-disposal',
+                    render: ({ useObservable, useDisposable }) => {
+                        useObservable('obs', obs);
+                        useDisposable('cleanup', () => ({
+                            [Symbol.dispose]: () => {
+                                obs.setValue(999);
+                            },
+                        }));
+                        renderCounter();
+                        return createComponent("div", null, obs.getValue());
+                    },
+                });
+                initializeShadeRoot({
+                    injector,
+                    rootElement,
+                    jsxElement: createComponent(ExampleComponent, null),
+                });
+                await flushUpdates();
+                const element = document.querySelector('shade-no-render-during-disposal');
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+                element.remove();
+                await flushUpdates();
+                await sleepAsync(10);
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+            });
+        });
+    });
     describe('BroadcastChannel cross-tab communication', () => {
         it('should update stored state when receiving BroadcastChannel message with matching key', async () => {
             const mockedStorage = new Map();

package/esm/shade.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"shade.spec.js","sourceRoot":"","sources":["../src/shade.spec.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"shade.spec.js","sourceRoot":"","sources":["../src/shade.spec.tsx"],"names":[],"mappings":"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"}

package/esm/view-transition.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Configuration for the View Transition API integration.
+ * When provided as an object, allows specifying transition types for CSS targeting
+ * via the `:active-view-transition-type()` pseudo-class.
+ */
+export type ViewTransitionConfig = {
+    types?: string[];
+};
+/**
+ * Wraps a DOM update in `document.startViewTransition()` when the View Transition API
+ * is available and `config` is truthy. Falls back to calling `update()` directly otherwise.
+ *
+ * Returns the `updateCallbackDone` promise when a transition is started, allowing callers
+ * that need to wait for the DOM update (e.g. to run lifecycle hooks) to `await` the result.
+ * Returns `undefined` when no transition is used (the update runs synchronously).
+ *
+ * @param config - The view transition configuration (boolean or object with types)
+ * @param update - The synchronous DOM update callback
+ * @returns A promise that resolves after the update callback completes inside the transition, or `undefined`
+ */
+export declare const maybeViewTransition: (config: boolean | ViewTransitionConfig | undefined, update: () => void) => Promise<void> | undefined;
+/**
+ * Keeps a "displayed" copy of `value` that is updated through a view transition
+ * whenever the value changes and `shouldTransition` returns true.
+ *
+ * When the transition is skipped (config is falsy or `shouldTransition` returns false),
+ * the displayed value is updated synchronously without an animation.
+ *
+ * @param useState - The component's `useState` hook
+ * @param key - Unique state key for caching the displayed value
+ * @param value - The latest source value (e.g. from `useObservable` or derived from props)
+ * @param config - View transition configuration forwarded to `maybeViewTransition`
+ * @param shouldTransition - Predicate that decides whether a value change warrants a transition.
+ *   Defaults to `() => true` (always transition).
+ * @returns The currently displayed value
+ */
+export declare const transitionedValue: <T>(useState: <S>(key: string, initialValue: S) => [S, (v: S) => void], key: string, value: T, config: boolean | ViewTransitionConfig | undefined, shouldTransition?: (prev: T, next: T) => boolean) => T;
+//# sourceMappingURL=view-transition.d.ts.map

package/esm/view-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-transition.d.ts","sourceRoot":"","sources":["../src/view-transition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,OAAO,GAAG,oBAAoB,GAAG,SAAS,EAClD,QAAQ,MAAM,IAAI,KACjB,OAAO,CAAC,IAAI,CAAC,GAAG,SAQlB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,EAClE,KAAK,MAAM,EACX,OAAO,CAAC,EACR,QAAQ,OAAO,GAAG,oBAAoB,GAAG,SAAS,EAClD,mBAAkB,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,OAAoB,KAC3D,CAUF,CAAA"}

package/esm/view-transition.js

@@ -0,0 +1,50 @@
+/**
+ * Wraps a DOM update in `document.startViewTransition()` when the View Transition API
+ * is available and `config` is truthy. Falls back to calling `update()` directly otherwise.
+ *
+ * Returns the `updateCallbackDone` promise when a transition is started, allowing callers
+ * that need to wait for the DOM update (e.g. to run lifecycle hooks) to `await` the result.
+ * Returns `undefined` when no transition is used (the update runs synchronously).
+ *
+ * @param config - The view transition configuration (boolean or object with types)
+ * @param update - The synchronous DOM update callback
+ * @returns A promise that resolves after the update callback completes inside the transition, or `undefined`
+ */
+export const maybeViewTransition = (config, update) => {
+    if (config && document.startViewTransition) {
+        const types = typeof config === 'object' && config.types?.length ? config.types : undefined;
+        const transition = types ? document.startViewTransition({ update, types }) : document.startViewTransition(update);
+        return transition.updateCallbackDone;
+    }
+    else {
+        update();
+    }
+};
+/**
+ * Keeps a "displayed" copy of `value` that is updated through a view transition
+ * whenever the value changes and `shouldTransition` returns true.
+ *
+ * When the transition is skipped (config is falsy or `shouldTransition` returns false),
+ * the displayed value is updated synchronously without an animation.
+ *
+ * @param useState - The component's `useState` hook
+ * @param key - Unique state key for caching the displayed value
+ * @param value - The latest source value (e.g. from `useObservable` or derived from props)
+ * @param config - View transition configuration forwarded to `maybeViewTransition`
+ * @param shouldTransition - Predicate that decides whether a value change warrants a transition.
+ *   Defaults to `() => true` (always transition).
+ * @returns The currently displayed value
+ */
+export const transitionedValue = (useState, key, value, config, shouldTransition = () => true) => {
+    const [displayed, setDisplayed] = useState(key, value);
+    if (value !== displayed) {
+        if (shouldTransition(displayed, value)) {
+            void maybeViewTransition(config, () => setDisplayed(value));
+        }
+        else {
+            setDisplayed(value);
+        }
+    }
+    return displayed;
+};
+//# sourceMappingURL=view-transition.js.map

package/esm/view-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-transition.js","sourceRoot":"","sources":["../src/view-transition.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAAkD,EAClD,MAAkB,EACS,EAAE;IAC7B,IAAI,MAAM,IAAI,QAAQ,CAAC,mBAAmB,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;QAC3F,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;QACjH,OAAO,UAAU,CAAC,kBAAkB,CAAA;IACtC,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,CAAA;IACV,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,QAAkE,EAClE,GAAW,EACX,KAAQ,EACR,MAAkD,EAClD,mBAAkD,GAAG,EAAE,CAAC,IAAI,EACzD,EAAE;IACL,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;YACvC,KAAK,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA;QAC7D,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA"}

package/esm/view-transition.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=view-transition.spec.d.ts.map

package/esm/view-transition.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-transition.spec.d.ts","sourceRoot":"","sources":["../src/view-transition.spec.ts"],"names":[],"mappings":""}

package/esm/view-transition.spec.js

@@ -0,0 +1,184 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { maybeViewTransition, transitionedValue } from './view-transition.js';
+describe('maybeViewTransition', () => {
+    afterEach(() => {
+        delete document.startViewTransition;
+    });
+    const mockStartViewTransition = () => {
+        const spy = vi.fn((optionsOrCallback) => {
+            const update = typeof optionsOrCallback === 'function' ? optionsOrCallback : optionsOrCallback.update;
+            update?.();
+            return {
+                finished: Promise.resolve(),
+                ready: Promise.resolve(),
+                updateCallbackDone: Promise.resolve(),
+                skipTransition: vi.fn(),
+            };
+        });
+        document.startViewTransition = spy;
+        return spy;
+    };
+    it('should call update directly when config is undefined', () => {
+        const spy = mockStartViewTransition();
+        const update = vi.fn();
+        const result = maybeViewTransition(undefined, update);
+        expect(update).toHaveBeenCalledTimes(1);
+        expect(spy).not.toHaveBeenCalled();
+        expect(result).toBeUndefined();
+    });
+    it('should call update directly when config is false', () => {
+        const spy = mockStartViewTransition();
+        const update = vi.fn();
+        const result = maybeViewTransition(false, update);
+        expect(update).toHaveBeenCalledTimes(1);
+        expect(spy).not.toHaveBeenCalled();
+        expect(result).toBeUndefined();
+    });
+    it('should call update directly when startViewTransition is not available', () => {
+        const update = vi.fn();
+        const result = maybeViewTransition(true, update);
+        expect(update).toHaveBeenCalledTimes(1);
+        expect(result).toBeUndefined();
+    });
+    it('should call startViewTransition when config is true and API is available', () => {
+        const spy = mockStartViewTransition();
+        const update = vi.fn();
+        const result = maybeViewTransition(true, update);
+        expect(spy).toHaveBeenCalledTimes(1);
+        expect(update).toHaveBeenCalledTimes(1);
+        expect(result).toBeInstanceOf(Promise);
+    });
+    it('should use callback form when config is true', () => {
+        const spy = mockStartViewTransition();
+        const update = vi.fn();
+        void maybeViewTransition(true, update);
+        expect(spy).toHaveBeenCalledWith(update);
+    });
+    it('should pass types when config is an object with types', () => {
+        const spy = mockStartViewTransition();
+        const update = vi.fn();
+        const config = { types: ['slide', 'fade'] };
+        void maybeViewTransition(config, update);
+        expect(spy).toHaveBeenCalledWith({ update, types: ['slide', 'fade'] });
+    });
+    it('should use callback form when config object has empty types array', () => {
+        const spy = mockStartViewTransition();
+        const update = vi.fn();
+        const config = { types: [] };
+        void maybeViewTransition(config, update);
+        expect(spy).toHaveBeenCalledWith(update);
+    });
+    it('should use callback form when config object has no types', () => {
+        const spy = mockStartViewTransition();
+        const update = vi.fn();
+        const config = {};
+        void maybeViewTransition(config, update);
+        expect(spy).toHaveBeenCalledWith(update);
+    });
+    it('should return updateCallbackDone promise when transition is started', async () => {
+        mockStartViewTransition();
+        const update = vi.fn();
+        const result = maybeViewTransition(true, update);
+        expect(result).toBeInstanceOf(Promise);
+        await expect(result).resolves.toBeUndefined();
+    });
+});
+describe('transitionedValue', () => {
+    afterEach(() => {
+        delete document.startViewTransition;
+    });
+    const mockStartViewTransition = () => {
+        const spy = vi.fn((optionsOrCallback) => {
+            const update = typeof optionsOrCallback === 'function' ? optionsOrCallback : optionsOrCallback.update;
+            update?.();
+            return {
+                finished: Promise.resolve(),
+                ready: Promise.resolve(),
+                updateCallbackDone: Promise.resolve(),
+                skipTransition: vi.fn(),
+            };
+        });
+        document.startViewTransition = spy;
+        return spy;
+    };
+    const createMockUseState = () => {
+        const store = new Map();
+        const setters = new Map();
+        const mockUseState = (key, initialValue) => {
+            if (!store.has(key)) {
+                store.set(key, initialValue);
+            }
+            const setValue = (v) => {
+                store.set(key, v);
+            };
+            setters.set(key, setValue);
+            return [store.get(key), setValue];
+        };
+        return { mockUseState, store };
+    };
+    it('should return the value when it equals the displayed value', () => {
+        const { mockUseState } = createMockUseState();
+        const result = transitionedValue(mockUseState, 'key', 'hello', true);
+        expect(result).toBe('hello');
+    });
+    it('should not call startViewTransition when value has not changed', () => {
+        const spy = mockStartViewTransition();
+        const { mockUseState } = createMockUseState();
+        transitionedValue(mockUseState, 'key', 'hello', true);
+        expect(spy).not.toHaveBeenCalled();
+    });
+    it('should call startViewTransition when value changes and config is truthy', () => {
+        const spy = mockStartViewTransition();
+        const { mockUseState, store } = createMockUseState();
+        transitionedValue(mockUseState, 'key', 'initial', true);
+        store.set('key', 'initial');
+        transitionedValue(mockUseState, 'key', 'updated', true);
+        expect(spy).toHaveBeenCalledTimes(1);
+        expect(store.get('key')).toBe('updated');
+    });
+    it('should not call startViewTransition when config is falsy', () => {
+        const spy = mockStartViewTransition();
+        const { mockUseState, store } = createMockUseState();
+        transitionedValue(mockUseState, 'key', 'initial', undefined);
+        store.set('key', 'initial');
+        transitionedValue(mockUseState, 'key', 'updated', undefined);
+        expect(spy).not.toHaveBeenCalled();
+        expect(store.get('key')).toBe('updated');
+    });
+    it('should not call startViewTransition when shouldTransition returns false', () => {
+        const spy = mockStartViewTransition();
+        const { mockUseState, store } = createMockUseState();
+        transitionedValue(mockUseState, 'key', 'initial', true, () => false);
+        store.set('key', 'initial');
+        transitionedValue(mockUseState, 'key', 'updated', true, () => false);
+        expect(spy).not.toHaveBeenCalled();
+        expect(store.get('key')).toBe('updated');
+    });
+    it('should call startViewTransition when shouldTransition returns true', () => {
+        const spy = mockStartViewTransition();
+        const { mockUseState, store } = createMockUseState();
+        transitionedValue(mockUseState, 'key', 'initial', true, () => true);
+        store.set('key', 'initial');
+        transitionedValue(mockUseState, 'key', 'updated', true, () => true);
+        expect(spy).toHaveBeenCalledTimes(1);
+        expect(store.get('key')).toBe('updated');
+    });
+    it('should pass prev and next values to shouldTransition', () => {
+        mockStartViewTransition();
+        const { mockUseState, store } = createMockUseState();
+        const shouldTransition = vi.fn(() => true);
+        transitionedValue(mockUseState, 'key', 'initial', true, shouldTransition);
+        store.set('key', 'initial');
+        transitionedValue(mockUseState, 'key', 'updated', true, shouldTransition);
+        expect(shouldTransition).toHaveBeenCalledWith('initial', 'updated');
+    });
+    it('should default shouldTransition to always true', () => {
+        const spy = mockStartViewTransition();
+        const { mockUseState, store } = createMockUseState();
+        transitionedValue(mockUseState, 'key', 'a', true);
+        store.set('key', 'a');
+        transitionedValue(mockUseState, 'key', 'b', true);
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=view-transition.spec.js.map

package/esm/view-transition.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-transition.spec.js","sourceRoot":"","sources":["../src/view-transition.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE5D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7E,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,SAAS,CAAC,GAAG,EAAE;QACb,OAAQ,QAA+C,CAAC,mBAAmB,CAAA;IAC7E,CAAC,CAAC,CAAA;IAEF,MAAM,uBAAuB,GAAG,GAAG,EAAE;QACnC,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,iBAA4D,EAAE,EAAE;YACjF,MAAM,MAAM,GAAG,OAAO,iBAAiB,KAAK,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAA;YACrG,MAAM,EAAE,EAAE,CAAA;YACV,OAAO;gBACL,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE;gBAC3B,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE;gBACxB,kBAAkB,EAAE,OAAO,CAAC,OAAO,EAAE;gBACrC,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;aACK,CAAA;QAChC,CAAC,CAAC,CAAA;QACF,QAAQ,CAAC,mBAAmB,GAAG,GAA0C,CAAA;QACzE,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IAED,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACjD,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACtB,KAAK,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACtB,MAAM,MAAM,GAAyB,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAA;QACjE,KAAK,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACtB,MAAM,MAAM,GAAyB,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;QAClD,KAAK,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACtB,MAAM,MAAM,GAAyB,EAAE,CAAA;QACvC,KAAK,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,uBAAuB,EAAE,CAAA;QACzB,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QACtC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAA;IAC/C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,SAAS,CAAC,GAAG,EAAE;QACb,OAAQ,QAA+C,CAAC,mBAAmB,CAAA;IAC7E,CAAC,CAAC,CAAA;IAEF,MAAM,uBAAuB,GAAG,GAAG,EAAE;QACnC,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,iBAA4D,EAAE,EAAE;YACjF,MAAM,MAAM,GAAG,OAAO,iBAAiB,KAAK,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAA;YACrG,MAAM,EAAE,EAAE,CAAA;YACV,OAAO;gBACL,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE;gBAC3B,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE;gBACxB,kBAAkB,EAAE,OAAO,CAAC,OAAO,EAAE;gBACrC,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;aACK,CAAA;QAChC,CAAC,CAAC,CAAA;QACF,QAAQ,CAAC,mBAAmB,GAAG,GAA0C,CAAA;QACzE,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IAED,MAAM,kBAAkB,GAAG,GAAG,EAAE;QAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAA;QACxC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAA;QACvD,MAAM,YAAY,GAAG,CAAI,GAAW,EAAE,YAAe,EAAuB,EAAE;YAC5E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;YAC9B,CAAC;YACD,MAAM,QAAQ,GAAG,CAAC,CAAI,EAAE,EAAE;gBACxB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;YACnB,CAAC,CAAA;YACD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAgC,CAAC,CAAA;YAClD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAM,EAAE,QAAQ,CAAC,CAAA;QACxC,CAAC,CAAA;QACD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC,CAAA;IAED,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,EAAE,YAAY,EAAE,GAAG,kBAAkB,EAAE,CAAA;QAC7C,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QACpE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,EAAE,YAAY,EAAE,GAAG,kBAAkB,EAAE,CAAA;QAC7C,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QACrD,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,CAAA;QAEpD,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;QACvD,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QAE3B,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;QACvD,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,CAAA;QAEpD,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;QAC5D,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QAE3B,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;QAC5D,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAClC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,CAAA;QAEpD,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QACpE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QAE3B,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QACpE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAClC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,CAAA;QAEpD,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QACnE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QAE3B,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QACnE,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,uBAAuB,EAAE,CAAA;QACzB,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,CAAA;QACpD,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QAE1C,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAA;QACzE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QAE3B,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAA;QACzE,MAAM,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;QACrC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,CAAA;QAEpD,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;QACjD,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAErB,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;QACjD,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@furystack/shades",
-  "version": "12.2.5",
+  "version": "12.4.0",
   "description": "A lightweight UI framework for FuryStack with JSX support",
   "type": "module",
   "scripts": {

package/src/components/lazy-load.spec.tsx

@@ -13,6 +13,7 @@ describe('Lazy Load', () => {
   })
   afterEach(() => {
     document.body.innerHTML = ''
+    delete (document as unknown as Record<string, unknown>).startViewTransition
   })
 
   it('Shuld display the loader and completed state', async () => {
@@ -72,7 +73,7 @@ describe('Lazy Load', () => {
     })
   })
 
-  it('Shuld display the failed state with a retryer', async () => {
+  it('Should succeed on retry after initial failure', async () => {
     await usingAsync(new Injector(), async (injector) => {
       const rootElement = document.getElementById('root') as HTMLDivElement
       let counter = 0
@@ -111,4 +112,80 @@ describe('Lazy Load', () => {
       expect(document.body.innerHTML).toBe('<div id="root"><lazy-load><div>success</div></lazy-load></div>')
     })
   })
+
+  it('should call startViewTransition when viewTransition is enabled and component loads', async () => {
+    const startViewTransitionSpy = vi.fn((optionsOrCallback: StartViewTransitionOptions | (() => void)) => {
+      const update = typeof optionsOrCallback === 'function' ? optionsOrCallback : optionsOrCallback.update
+      update?.()
+      return {
+        finished: Promise.resolve(),
+        ready: Promise.resolve(),
+        updateCallbackDone: Promise.resolve(),
+        skipTransition: vi.fn(),
+      } as unknown as ViewTransition
+    })
+    document.startViewTransition = startViewTransitionSpy as typeof document.startViewTransition
+
+    await usingAsync(new Injector(), async (injector) => {
+      const rootElement = document.getElementById('root') as HTMLDivElement
+
+      initializeShadeRoot({
+        injector,
+        rootElement,
+        jsxElement: (
+          <LazyLoad
+            viewTransition
+            loader={<div>Loading...</div>}
+            component={async () => {
+              await sleepAsync(50)
+              return <div>Loaded</div>
+            }}
+          />
+        ),
+      })
+      await flushUpdates()
+      expect(document.body.innerHTML).toContain('Loading...')
+
+      await sleepAsync(100)
+      expect(startViewTransitionSpy).toHaveBeenCalledTimes(1)
+      expect(document.body.innerHTML).toContain('Loaded')
+    })
+  })
+
+  it('should not call startViewTransition when viewTransition is not set', async () => {
+    const startViewTransitionSpy = vi.fn((optionsOrCallback: StartViewTransitionOptions | (() => void)) => {
+      const update = typeof optionsOrCallback === 'function' ? optionsOrCallback : optionsOrCallback.update
+      update?.()
+      return {
+        finished: Promise.resolve(),
+        ready: Promise.resolve(),
+        updateCallbackDone: Promise.resolve(),
+        skipTransition: vi.fn(),
+      } as unknown as ViewTransition
+    })
+    document.startViewTransition = startViewTransitionSpy as typeof document.startViewTransition
+
+    await usingAsync(new Injector(), async (injector) => {
+      const rootElement = document.getElementById('root') as HTMLDivElement
+
+      initializeShadeRoot({
+        injector,
+        rootElement,
+        jsxElement: (
+          <LazyLoad
+            loader={<div>Loading...</div>}
+            component={async () => {
+              await sleepAsync(50)
+              return <div>Loaded</div>
+            }}
+          />
+        ),
+      })
+      await flushUpdates()
+      await sleepAsync(100)
+
+      expect(startViewTransitionSpy).not.toHaveBeenCalled()
+      expect(document.body.innerHTML).toContain('Loaded')
+    })
+  })
 })

package/src/components/lazy-load.tsx

@@ -1,9 +1,12 @@
 import { Shade } from '../shade.js'
+import type { ViewTransitionConfig } from '../view-transition.js'
+import { maybeViewTransition } from '../view-transition.js'
 
 export interface LazyLoadProps {
   loader: JSX.Element
   error?: (error: unknown, retry: () => Promise<void>) => JSX.Element
   component: () => Promise<JSX.Element>
+  viewTransition?: boolean | ViewTransitionConfig
 }
 
 export const LazyLoad = Shade<LazyLoadProps>({
@@ -36,8 +39,10 @@ export const LazyLoad = Shade<LazyLoadProps>({
       factory()
         .then((loaded) => {
           if (tracker.active && tracker.factory === factory) {
-            setError(undefined)
-            setComponent(loaded)
+            void maybeViewTransition(props.viewTransition, () => {
+              setError(undefined)
+              setComponent(loaded)
+            })
           }
         })
         .catch((err: unknown) => {
@@ -60,7 +65,9 @@ export const LazyLoad = Shade<LazyLoadProps>({
           setComponent(undefined)
           const loaded = await factory()
           if (tracker.active && tracker.factory === factory) {
-            setComponent(loaded)
+            void maybeViewTransition(props.viewTransition, () => {
+              setComponent(loaded)
+            })
           }
         } catch (e) {
           if (tracker.active && tracker.factory === factory) {