@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

package/dist/esm/core/app-shell/shell-motion/use-shell-motion.js

@@ -0,0 +1,423 @@
+import { useEffect, useLayoutEffect, useRef, useState } from 'react';
+import { ShellRegion } from '@wildo-ai/presets-components-models';
+import { NAVIGATION_STRUCTURAL_ZONES } from '../../navigation/navigation.schemas.js';
+import { installNavigationCommitWrapper } from '../../navigation/navigation-commit.js';
+import { isShellSidePane, SHELL_GHOST_ATTRIBUTE, SHELL_GHOST_LAYER_ATTRIBUTE, SHELL_OBJECT_ATTRIBUTE, SHELL_PANE_SELECTOR, shellPaneSelectorForZone, shellPaneZone, shellRegionSelector, ShellGhostKind, ShellGhostLayer, ShellGhostPose, ShellDialogArrival, ShellMotionDip, ShellPaneArrival, ShellPaneResize, ShellPlaceChange, } from './shell-motion-vocabulary.js';
+import { installShellLayoutStylesheet } from './shell-layout-stylesheet.js';
+import { createShellViewTransitionCommit, SHELL_VIEW_TRANSITION_CSS, shellViewTransitionsAvailable } from './shell-view-transition.js';
+import { cascadeShellRows, flyShellProxy, growShellPane, SHELL_PRESS_ORIGIN_MAX_AGE_MS, slideShellPaneHome, useShellDialogArrival, useShellPressOrigin } from './shell-motion-origins.js';
+/** Every object a layout moves: its own region wrappers, and the navigation panes. */
+const SHELL_MOTION_OBJECTS = `[${SHELL_OBJECT_ATTRIBUTE}], ${SHELL_PANE_SELECTOR}`;
+/**
+ * The last laid-out box of every object, kept so a pane that has just been REMOVED or HIDDEN can still be drawn where
+ * it was (its ghost leaves from there). A zero-size reading never replaces a real one: a hidden pane measures as
+ * nothing, and its last visible box is the one that matters.
+ */
+export const shellStageRects = new WeakMap();
+/** An element's layout offset inside `root`, walking the offset-parent chain (transforms are not part of it). */
+export function offsetWithin(element, root) {
+    let left = 0;
+    let top = 0;
+    let node = element;
+    while (node && node !== root) {
+        left += node.offsetLeft;
+        top += node.offsetTop;
+        const parent = node.offsetParent;
+        if (!parent || (!root.contains(parent) && parent !== root))
+            break;
+        node = parent;
+    }
+    return { left, top };
+}
+/**
+ * Measures every object in the stage — the layout's region wrappers and the navigation panes — whenever anything can
+ * have moved one: the stage or any object resizing (a sidebar collapsing MOVES the content column without resizing the
+ * stage), the DOM changing, the window resizing. Each box lands in {@link shellStageRects}, and `onObject` lets a
+ * layout derive something per object from it (the focal plane writes each object's vanishing-point origin).
+ *
+ * Offsets come from `offsetLeft`/`offsetTop`, which ignore transforms, so an object that is moved right now still
+ * reports where it is laid out.
+ */
+export function useShellStageMeasurement(rootRef, onObject) {
+    const onObjectRef = useRef(onObject);
+    onObjectRef.current = onObject;
+    useLayoutEffect(() => {
+        const root = rootRef.current;
+        if (!root)
+            return undefined;
+        let frame = 0;
+        // Absent in some environments (a test DOM): the window resize and the mutations below still re-measure.
+        const resize = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(() => schedule());
+        const observed = new Set();
+        const measure = () => {
+            frame = 0;
+            const objects = new Set(root.querySelectorAll(SHELL_MOTION_OBJECTS));
+            for (const element of objects)
+                if (!observed.has(element)) {
+                    resize?.observe(element);
+                    observed.add(element);
+                }
+            for (const element of observed)
+                if (!objects.has(element)) {
+                    resize?.unobserve(element);
+                    observed.delete(element);
+                }
+            for (const element of objects) {
+                const offset = offsetWithin(element, root);
+                onObjectRef.current?.(element, offset, root);
+                if (element.offsetWidth > 0 && element.offsetHeight > 0)
+                    shellStageRects.set(element, { ...offset, width: element.offsetWidth, height: element.offsetHeight });
+            }
+        };
+        const schedule = () => {
+            if (!frame)
+                frame = requestAnimationFrame(measure);
+        };
+        measure();
+        resize?.observe(root);
+        const mutations = new MutationObserver(schedule);
+        mutations.observe(root, { childList: true, subtree: true });
+        window.addEventListener('resize', schedule);
+        return () => {
+            cancelAnimationFrame(frame);
+            resize?.disconnect();
+            mutations.disconnect();
+            window.removeEventListener('resize', schedule);
+        };
+    }, [rootRef]);
+}
+/**
+ * Which pane is in front: the one last pressed in or focused, or the one that last opened or changed place
+ * (`bringForward`). Kept by the layout rather than read from the navigation state's `focusedZone` alone, because that
+ * follows only interaction: opening a record beside a list leaves the LIST focused, and a layout brings the new pane
+ * forward. The engine's focus state is never written.
+ */
+export function useShellFrontPane(rootRef, focusedZone) {
+    const [zone, setZone] = useState(focusedZone);
+    useEffect(() => setZone(focusedZone), [focusedZone]);
+    useEffect(() => {
+        const root = rootRef.current;
+        if (!root)
+            return undefined;
+        const fromEvent = (event) => {
+            const target = event.target instanceof Element ? event.target : null;
+            const pane = target?.closest(`${shellRegionSelector(ShellRegion.CONTENT)} :is([data-content-area], [data-panel-id^="nav-"])`);
+            const name = pane ? shellPaneZone(pane) : undefined;
+            if (name)
+                setZone(name);
+        };
+        root.addEventListener('pointerdown', fromEvent, true);
+        root.addEventListener('focusin', fromEvent, true);
+        return () => {
+            root.removeEventListener('pointerdown', fromEvent, true);
+            root.removeEventListener('focusin', fromEvent, true);
+        };
+    }, [rootRef]);
+    return { zone, bringForward: setZone };
+}
+const STRUCTURAL_ZONES = new Set(NAVIGATION_STRUCTURAL_ZONES);
+/**
+ * Reports each structural zone that APPEARS (it held nothing and now holds a place) or CHANGES place (it now shows
+ * another URL path). A place is the top entry's URL path — not its id, which is minted again on every push, and not
+ * its query string, which carries view state on the same content (a section tab, a list mode). The overlay zone is a
+ * dialog, not a pane, and is never reported. Nothing is reported on the first render.
+ */
+export function useShellPlaceChanges(navigation, onPlace) {
+    const zones = Object.keys(navigation.state.zones).filter((zone) => STRUCTURAL_ZONES.has(zone));
+    const places = zones.map((zone) => {
+        const top = navigation.getTopEntry(zone);
+        return top ? (top.urlPath?.split(/[?#]/)[0] ?? top.id) : '';
+    });
+    const signature = zones.map((zone, index) => `${zone}:${places[index]}`).join('|');
+    const previous = useRef(null);
+    const onPlaceRef = useRef(onPlace);
+    onPlaceRef.current = onPlace;
+    useEffect(() => {
+        const current = new Map(zones.map((zone, index) => [zone, places[index] ?? '']));
+        const before = previous.current;
+        previous.current = current;
+        if (!before)
+            return;
+        for (const [zone, place] of current) {
+            const was = before.get(zone) ?? '';
+            if (place === '' || was === place)
+                continue;
+            onPlaceRef.current(zone, was === '' ? ShellPlaceChange.APPEARED : ShellPlaceChange.CHANGED);
+        }
+        // `signature` is the whole dependency: the zones and places are derived from the same render.
+    }, [signature]);
+}
+/**
+ * Makes an element a picture: no ids, no focus, invisible to assistive technology, and none of the markers a query for
+ * the REAL pane would find (a document-level lookup of a pane must never return its image). Embedded frames and media
+ * are dropped rather than loaded a second time.
+ */
+export function makeShellPicture(element) {
+    element.setAttribute('aria-hidden', 'true');
+    element.setAttribute('inert', '');
+    for (const node of [element, ...element.querySelectorAll('*')]) {
+        for (const attribute of ['id', 'data-content-area', 'data-panel-id', 'data-zone-hidden', 'data-zone-emphasized', 'data-component-area', SHELL_OBJECT_ATTRIBUTE])
+            node.removeAttribute(attribute);
+    }
+    for (const media of element.querySelectorAll('iframe, video, audio'))
+        media.remove();
+}
+function applyStyles(element, styles) {
+    for (const [property, value] of Object.entries(styles))
+        element.style.setProperty(property, value);
+}
+/** Two frames: the first lets the ghost render at its start pose, the second changes it, so the transition plays. */
+function afterPaint(run) {
+    requestAnimationFrame(() => requestAnimationFrame(run));
+}
+/**
+ * What a stylesheet cannot do alone, because the engine unmounts or hides a pane at once:
+ *
+ * - **Discard.** A side pane dismissed by its close control is removed from the DOM immediately. The removed node,
+ *   no longer React's, is re-parented into the FRONT ghost layer at the box it last had, and goes to the axis's
+ *   `DISCARDED` pose as it fades.
+ * - **Expand.** An emphasized pane takes the width and the engine HIDES the others (`data-zone-hidden`). When the axis
+ *   draws one (`drawsHiddenPanePicture`), a still, inert image of each hidden pane is left in the BACK ghost layer at
+ *   the axis's `BEHIND` pose. It is a picture, never a
+ *   control: returning to side by side is the pane's own restore control. The image returns to `REST` and fades when
+ *   the emphasis ends.
+ * - **Swap.** `dip(zone)` plays the axis's `PANE_SWAP` dip on a pane whose content changed in place.
+ *
+ * Needs {@link useShellStageMeasurement} running on the same stage (the boxes ghosts leave from), and the two ghost
+ * layers (`[data-shell-ghost-layer="back"]` and `"front"`) inside it. An axis with `durationMs: 0` plays nothing: no
+ * discard ghost and no dip. The picture behind an expanded pane is still drawn — a still picture is not motion — at
+ * its pose at once, and removed at once.
+ */
+export function useShellPaneMotion(rootRef, axis) {
+    useLayoutEffect(() => {
+        const root = rootRef.current;
+        if (!root)
+            return undefined;
+        const back = root.querySelector(`[${SHELL_GHOST_LAYER_ATTRIBUTE}="${ShellGhostLayer.BACK}"]`);
+        const front = root.querySelector(`[${SHELL_GHOST_LAYER_ATTRIBUTE}="${ShellGhostLayer.FRONT}"]`);
+        if (!back || !front)
+            return undefined;
+        const behind = new Map();
+        const duration = axis.durationMs;
+        const createGhost = (kind, rect) => {
+            const ghost = document.createElement('div');
+            ghost.setAttribute(SHELL_GHOST_ATTRIBUTE, kind);
+            ghost.setAttribute('aria-hidden', 'true');
+            Object.assign(ghost.style, { position: 'absolute', left: `${rect.left}px`, top: `${rect.top}px`, width: `${rect.width}px`, height: `${rect.height}px` });
+            applyStyles(ghost, axis.ghostPose(ShellGhostPose.REST, { rect, stage: root }));
+            return ghost;
+        };
+        const discard = (node) => {
+            const rect = shellStageRects.get(node);
+            // Moved rather than removed (taken out and put back in one batch): it is still on screen, not discarded.
+            if (!rect || duration === 0 || node.isConnected)
+                return;
+            const ghost = createGhost(ShellGhostKind.DISCARDED, rect);
+            makeShellPicture(node);
+            ghost.appendChild(node);
+            front.appendChild(ghost);
+            afterPaint(() => {
+                applyStyles(ghost, axis.ghostPose(ShellGhostPose.DISCARDED, { rect, stage: root }));
+                ghost.style.opacity = '0';
+            });
+            setTimeout(() => ghost.remove(), duration + 60);
+        };
+        const syncBehind = () => {
+            const emphasized = root.querySelector('[data-zone-emphasized]');
+            // Only for an axis that draws one (`drawsHiddenPanePicture`). Drawn under reduced motion too: a still picture is
+            // not motion. Only its travel and fade are skipped.
+            const hidden = emphasized && axis.drawsHiddenPanePicture
+                ? [...root.querySelectorAll(SHELL_PANE_SELECTOR)].filter((pane) => pane.hasAttribute('data-zone-hidden'))
+                : [];
+            for (const [pane, ghost] of behind) {
+                if (hidden.includes(pane))
+                    continue;
+                behind.delete(pane);
+                if (duration === 0) {
+                    ghost.remove();
+                    continue;
+                }
+                const rect = shellStageRects.get(pane);
+                if (rect)
+                    applyStyles(ghost, axis.ghostPose(ShellGhostPose.REST, { rect, stage: root }));
+                ghost.style.opacity = '0';
+                setTimeout(() => ghost.remove(), duration);
+            }
+            for (const pane of hidden) {
+                if (behind.has(pane))
+                    continue;
+                const rect = shellStageRects.get(pane);
+                if (!rect)
+                    continue;
+                const ghost = createGhost(ShellGhostKind.BEHIND, rect);
+                const copy = pane.cloneNode(true);
+                makeShellPicture(copy);
+                copy.classList.remove('hidden');
+                copy.style.width = '100%';
+                copy.style.height = '100%';
+                ghost.appendChild(copy);
+                behind.set(pane, ghost);
+                if (duration === 0) {
+                    // Still: placed straight at its pose, with no transition to play.
+                    applyStyles(ghost, axis.ghostPose(ShellGhostPose.BEHIND, { rect, stage: root }));
+                    back.appendChild(ghost);
+                    continue;
+                }
+                ghost.style.opacity = '0';
+                back.appendChild(ghost);
+                afterPaint(() => {
+                    applyStyles(ghost, axis.ghostPose(ShellGhostPose.BEHIND, { rect, stage: root }));
+                    ghost.style.opacity = '1';
+                });
+            }
+        };
+        /** The pane object an emphasis marker belongs to: the zone itself, or the resizable panel holding it. */
+        const paneOf = (element) => (element.matches(SHELL_PANE_SELECTOR) ? element : element.closest('[data-panel-id^="nav-"]'));
+        const observer = new MutationObserver((records) => {
+            for (const record of records) {
+                // An emphasis given or taken: the pane grows to its new width, or slides home (`ShellPaneResize.GROW`). The
+                // stage's last measurement still holds the box it had: measurement waits for the next frame.
+                if (record.type === 'attributes' && record.attributeName === 'data-zone-emphasized' && axis.paneResize === ShellPaneResize.GROW) {
+                    const pane = record.target instanceof Element ? paneOf(record.target) : null;
+                    const before = pane ? shellStageRects.get(pane) : undefined;
+                    if (pane && before) {
+                        if (record.target.hasAttribute('data-zone-emphasized'))
+                            growShellPane(pane, before, root, axis);
+                        else
+                            slideShellPaneHome(pane, before, root, axis);
+                    }
+                    continue;
+                }
+                if (record.type !== 'childList')
+                    continue;
+                for (const node of record.removedNodes) {
+                    // A detached node matches no selector that names its ancestors, so a pane is recognised by the box the
+                    // stage last measured for it: only objects have one. Only a SIDE pane is ever dismissed — the primary pane
+                    // leaves only when the content remounts (a breakpoint flip), which is not a discard.
+                    if (node instanceof HTMLElement && shellStageRects.has(node) && isShellSidePane(node))
+                        discard(node);
+                }
+            }
+            syncBehind();
+        });
+        const content = root.querySelector(shellRegionSelector(ShellRegion.CONTENT)) ?? root;
+        observer.observe(content, { childList: true, subtree: true, attributes: true, attributeFilter: ['data-zone-hidden', 'data-zone-emphasized'] });
+        syncBehind();
+        return () => {
+            observer.disconnect();
+            for (const ghost of behind.values())
+                ghost.remove();
+        };
+    }, [rootRef, axis]);
+    const dipRef = useRef(() => undefined);
+    useEffect(() => {
+        dipRef.current = (zone) => {
+            const root = rootRef.current;
+            if (!root || axis.durationMs === 0)
+                return;
+            const pane = root.querySelector(shellPaneSelectorForZone(zone));
+            if (!pane || typeof pane.animate !== 'function')
+                return;
+            pane.animate([axis.dipPeak(ShellMotionDip.PANE_SWAP, { stage: root })], { duration: axis.durationMs, easing: axis.easing });
+        };
+    }, [rootRef, axis]);
+    return { dip: (zone) => dipRef.current(zone) };
+}
+/** A column's width must change by more than this to count as a fold, not a drag tremor. */
+const COLUMN_RESIZE_THRESHOLD_PX = 24;
+/**
+ * A side column (the sidebar folding to its rail or unfolding, a utility panel) plays the axis's `COLUMN_RESIZE` dip
+ * while the panes re-arrange. The width animates over many frames, so the dip plays once per settled change larger
+ * than a few pixels, and at most once per motion. It runs on the layout's OWN wrapper (`[data-shell-object]`).
+ */
+export function useShellColumnMotion(rootRef, axis) {
+    useEffect(() => {
+        const root = rootRef.current;
+        if (!root || axis.durationMs === 0 || typeof ResizeObserver === 'undefined')
+            return undefined;
+        const columns = [...root.querySelectorAll(`[${SHELL_OBJECT_ATTRIBUTE}]`)].filter((wrapper) => wrapper.querySelector(`:scope > ${shellRegionSelector(ShellRegion.SIDEBAR)}, :scope > ${shellRegionSelector(ShellRegion.UTILITY_PANEL)}`));
+        const settled = new Map();
+        const lastDip = new Map();
+        const observer = new ResizeObserver((entries) => {
+            for (const entry of entries) {
+                const wrapper = entry.target;
+                const width = wrapper.offsetWidth;
+                const previous = settled.get(wrapper);
+                if (previous === undefined || width === 0) {
+                    settled.set(wrapper, width);
+                    continue;
+                }
+                if (Math.abs(width - previous) <= COLUMN_RESIZE_THRESHOLD_PX)
+                    continue;
+                settled.set(wrapper, width);
+                const now = performance.now();
+                if (now - (lastDip.get(wrapper) ?? 0) < axis.durationMs)
+                    continue;
+                lastDip.set(wrapper, now);
+                wrapper.animate([axis.dipPeak(ShellMotionDip.COLUMN_RESIZE, { stage: root })], { duration: axis.durationMs, easing: axis.easing });
+            }
+        });
+        for (const column of columns)
+            observer.observe(column);
+        return () => observer.disconnect();
+    }, [rootRef, axis]);
+}
+/**
+ * Every motion building block an animated layout composes, on one stage: the measurement, the front pane, place
+ * changes (a pane that opens or changes place comes forward, and a change in place dips), the discard and behind
+ * ghosts, the column dip — and, as the axis chooses, a side pane or a dialog growing out of what was pressed, an
+ * emphasized pane growing to its width, and rows cascading in (a side pane's arrival as a browser view transition when
+ * the axis asks, `paneArrivalByViewTransition`). Returns the zone in front, which the layout exposes (as an attribute) for its stylesheet
+ * to recede the others.
+ *
+ * The stage (`rootRef`) must contain the layout's region wrappers marked `data-shell-object`, the content outlet, and
+ * the two ghost layers (`data-shell-ghost-layer="back"` under the regions, `"front"` above them).
+ */
+export function useShellMotion(rootRef, { axis, navigation, onObjectMeasured }) {
+    useShellStageMeasurement(rootRef, onObjectMeasured);
+    const { dip } = useShellPaneMotion(rootRef, axis);
+    const front = useShellFrontPane(rootRef, navigation.focusedZone);
+    useShellColumnMotion(rootRef, axis);
+    const origin = useShellPressOrigin(axis.paneArrival === ShellPaneArrival.FROM_PRESSED_ELEMENT || axis.dialogArrival === ShellDialogArrival.FROM_PRESSED_ELEMENT);
+    useShellDialogArrival(rootRef, axis, origin);
+    // A side pane's arrival carried out as a browser view transition, where the axis asks and the browser can: the
+    // navigation's commit runs inside it. It consumes the press, so the proxy below finds nothing to fly from.
+    useEffect(() => {
+        if (axis.paneArrival !== ShellPaneArrival.FROM_PRESSED_ELEMENT || !axis.paneArrivalByViewTransition || axis.durationMs === 0)
+            return undefined;
+        if (!shellViewTransitionsAvailable())
+            return undefined;
+        const releaseStylesheet = installShellLayoutStylesheet('shell-view-transition', SHELL_VIEW_TRANSITION_CSS);
+        const uninstall = installNavigationCommitWrapper(createShellViewTransitionCommit({ stage: () => rootRef.current, origin, axis }));
+        return () => {
+            uninstall();
+            releaseStylesheet();
+        };
+    }, [rootRef, origin, axis]);
+    // One cascade per zone: two panes changing place together must not cancel each other's.
+    const cascades = useRef(new Map());
+    useEffect(() => () => { for (const stop of cascades.current.values())
+        stop(); cascades.current.clear(); }, []);
+    useShellPlaceChanges(navigation, (zone, how) => {
+        if (how === ShellPlaceChange.CHANGED)
+            dip(zone);
+        front.bringForward(zone);
+        const root = rootRef.current;
+        const pane = root?.querySelector(shellPaneSelectorForZone(zone));
+        if (!root || !pane || axis.durationMs === 0)
+            return;
+        // A side pane that opened grows out of the row pressed to open it (`ShellPaneArrival.FROM_PRESSED_ELEMENT`).
+        if (how === ShellPlaceChange.APPEARED && axis.paneArrival === ShellPaneArrival.FROM_PRESSED_ELEMENT && isShellSidePane(pane)) {
+            const from = origin.takeRow(SHELL_PRESS_ORIGIN_MAX_AGE_MS);
+            if (from)
+                void flyShellProxy(root, from, pane.getBoundingClientRect(), axis, pane);
+        }
+        if (axis.cascadesRows) {
+            cascades.current.get(zone)?.();
+            cascades.current.set(zone, cascadeShellRows(pane, axis));
+        }
+    });
+    return { frontZone: front.zone };
+}
+/** @wildo_source:part:end saas.frontend.app-shell.use-shell-motion */
+//# sourceMappingURL=use-shell-motion.js.map

package/dist/esm/core/app-shell/shell-motion/use-shell-motion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-shell-motion.js","sourceRoot":"","sources":["../../../../../../src/core/app-shell/shell-motion/use-shell-motion.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState, type RefObject } from 'react';\n\nimport { ShellRegion } from '@wildo-ai/presets-components-models';\n\nimport { NAVIGATION_STRUCTURAL_ZONES } from '../../navigation/navigation.schemas';\nimport { installNavigationCommitWrapper } from '../../navigation/navigation-commit';\nimport type { NavigationContextType } from '../../navigation/NavigationContext';\nimport {\n  isShellSidePane,\n  SHELL_GHOST_ATTRIBUTE,\n  SHELL_GHOST_LAYER_ATTRIBUTE,\n  SHELL_OBJECT_ATTRIBUTE,\n  SHELL_PANE_SELECTOR,\n  shellPaneSelectorForZone,\n  shellPaneZone,\n  shellRegionSelector,\n  ShellGhostKind,\n  ShellGhostLayer,\n  ShellGhostPose,\n  ShellDialogArrival,\n  ShellMotionDip,\n  ShellPaneArrival,\n  ShellPaneResize,\n  ShellPlaceChange,\n  type ShellMotionAxis,\n  type ShellStageRect,\n} from './shell-motion-vocabulary';\nimport { installShellLayoutStylesheet } from './shell-layout-stylesheet';\nimport { createShellViewTransitionCommit, SHELL_VIEW_TRANSITION_CSS, shellViewTransitionsAvailable } from './shell-view-transition';\nimport { cascadeShellRows, flyShellProxy, growShellPane, SHELL_PRESS_ORIGIN_MAX_AGE_MS, slideShellPaneHome, useShellDialogArrival, useShellPressOrigin } from './shell-motion-origins';\n\n/** Every object a layout moves: its own region wrappers, and the navigation panes. */\nconst SHELL_MOTION_OBJECTS = `[${SHELL_OBJECT_ATTRIBUTE}], ${SHELL_PANE_SELECTOR}`;\n\n/**\n * The last laid-out box of every object, kept so a pane that has just been REMOVED or HIDDEN can still be drawn where\n * it was (its ghost leaves from there). A zero-size reading never replaces a real one: a hidden pane measures as\n * nothing, and its last visible box is the one that matters.\n */\nexport const shellStageRects = new WeakMap<Element, ShellStageRect>();\n\n/** An element's layout offset inside `root`, walking the offset-parent chain (transforms are not part of it). */\nexport function offsetWithin(element: HTMLElement, root: HTMLElement): { left: number; top: number } {\n  let left = 0;\n  let top = 0;\n  let node: HTMLElement | null = element;\n  while (node && node !== root) {\n    left += node.offsetLeft;\n    top += node.offsetTop;\n    const parent = node.offsetParent as HTMLElement | null;\n    if (!parent || (!root.contains(parent) && parent !== root)) break;\n    node = parent;\n  }\n  return { left, top };\n}\n\n/**\n * Measures every object in the stage — the layout's region wrappers and the navigation panes — whenever anything can\n * have moved one: the stage or any object resizing (a sidebar collapsing MOVES the content column without resizing the\n * stage), the DOM changing, the window resizing. Each box lands in {@link shellStageRects}, and `onObject` lets a\n * layout derive something per object from it (the focal plane writes each object's vanishing-point origin).\n *\n * Offsets come from `offsetLeft`/`offsetTop`, which ignore transforms, so an object that is moved right now still\n * reports where it is laid out.\n */\nexport function useShellStageMeasurement(\n  rootRef: RefObject<HTMLElement | null>,\n  onObject?: (element: HTMLElement, offset: { left: number; top: number }, stage: HTMLElement) => void,\n): void {\n  const onObjectRef = useRef(onObject);\n  onObjectRef.current = onObject;\n  useLayoutEffect(() => {\n    const root = rootRef.current;\n    if (!root) return undefined;\n    let frame = 0;\n    // Absent in some environments (a test DOM): the window resize and the mutations below still re-measure.\n    const resize = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(() => schedule());\n    const observed = new Set<HTMLElement>();\n    const measure = (): void => {\n      frame = 0;\n      const objects = new Set(root.querySelectorAll<HTMLElement>(SHELL_MOTION_OBJECTS));\n      for (const element of objects) if (!observed.has(element)) { resize?.observe(element); observed.add(element); }\n      for (const element of observed) if (!objects.has(element)) { resize?.unobserve(element); observed.delete(element); }\n      for (const element of objects) {\n        const offset = offsetWithin(element, root);\n        onObjectRef.current?.(element, offset, root);\n        if (element.offsetWidth > 0 && element.offsetHeight > 0) shellStageRects.set(element, { ...offset, width: element.offsetWidth, height: element.offsetHeight });\n      }\n    };\n    const schedule = (): void => {\n      if (!frame) frame = requestAnimationFrame(measure);\n    };\n    measure();\n    resize?.observe(root);\n    const mutations = new MutationObserver(schedule);\n    mutations.observe(root, { childList: true, subtree: true });\n    window.addEventListener('resize', schedule);\n    return () => {\n      cancelAnimationFrame(frame);\n      resize?.disconnect();\n      mutations.disconnect();\n      window.removeEventListener('resize', schedule);\n    };\n  }, [rootRef]);\n}\n\n/**\n * Which pane is in front: the one last pressed in or focused, or the one that last opened or changed place\n * (`bringForward`). Kept by the layout rather than read from the navigation state's `focusedZone` alone, because that\n * follows only interaction: opening a record beside a list leaves the LIST focused, and a layout brings the new pane\n * forward. The engine's focus state is never written.\n */\nexport function useShellFrontPane(rootRef: RefObject<HTMLElement | null>, focusedZone: string): { zone: string; bringForward: (zone: string) => void } {\n  const [zone, setZone] = useState<string>(focusedZone);\n  useEffect(() => setZone(focusedZone), [focusedZone]);\n  useEffect(() => {\n    const root = rootRef.current;\n    if (!root) return undefined;\n    const fromEvent = (event: Event): void => {\n      const target = event.target instanceof Element ? event.target : null;\n      const pane = target?.closest(`${shellRegionSelector(ShellRegion.CONTENT)} :is([data-content-area], [data-panel-id^=\"nav-\"])`);\n      const name = pane ? shellPaneZone(pane) : undefined;\n      if (name) setZone(name);\n    };\n    root.addEventListener('pointerdown', fromEvent, true);\n    root.addEventListener('focusin', fromEvent, true);\n    return () => {\n      root.removeEventListener('pointerdown', fromEvent, true);\n      root.removeEventListener('focusin', fromEvent, true);\n    };\n  }, [rootRef]);\n  return { zone, bringForward: setZone };\n}\n\n/** The part of the navigation state place detection reads. */\nexport type ShellPlaceNavigation = Pick<NavigationContextType, 'state' | 'getTopEntry'>;\n\nconst STRUCTURAL_ZONES: ReadonlySet<string> = new Set(NAVIGATION_STRUCTURAL_ZONES);\n\n/**\n * Reports each structural zone that APPEARS (it held nothing and now holds a place) or CHANGES place (it now shows\n * another URL path). A place is the top entry's URL path — not its id, which is minted again on every push, and not\n * its query string, which carries view state on the same content (a section tab, a list mode). The overlay zone is a\n * dialog, not a pane, and is never reported. Nothing is reported on the first render.\n */\nexport function useShellPlaceChanges(navigation: ShellPlaceNavigation, onPlace: (zone: string, how: ShellPlaceChange) => void): void {\n  const zones = Object.keys(navigation.state.zones).filter((zone) => STRUCTURAL_ZONES.has(zone));\n  const places = zones.map((zone) => {\n    const top = navigation.getTopEntry(zone as Parameters<ShellPlaceNavigation['getTopEntry']>[0]);\n    return top ? (top.urlPath?.split(/[?#]/)[0] ?? top.id) : '';\n  });\n  const signature = zones.map((zone, index) => `${zone}:${places[index]}`).join('|');\n  const previous = useRef<Map<string, string> | null>(null);\n  const onPlaceRef = useRef(onPlace);\n  onPlaceRef.current = onPlace;\n  useEffect(() => {\n    const current = new Map(zones.map((zone, index) => [zone, places[index] ?? '']));\n    const before = previous.current;\n    previous.current = current;\n    if (!before) return;\n    for (const [zone, place] of current) {\n      const was = before.get(zone) ?? '';\n      if (place === '' || was === place) continue;\n      onPlaceRef.current(zone, was === '' ? ShellPlaceChange.APPEARED : ShellPlaceChange.CHANGED);\n    }\n    // `signature` is the whole dependency: the zones and places are derived from the same render.\n  }, [signature]);\n}\n\n/**\n * Makes an element a picture: no ids, no focus, invisible to assistive technology, and none of the markers a query for\n * the REAL pane would find (a document-level lookup of a pane must never return its image). Embedded frames and media\n * are dropped rather than loaded a second time.\n */\nexport function makeShellPicture(element: HTMLElement): void {\n  element.setAttribute('aria-hidden', 'true');\n  element.setAttribute('inert', '');\n  for (const node of [element, ...element.querySelectorAll<HTMLElement>('*')]) {\n    for (const attribute of ['id', 'data-content-area', 'data-panel-id', 'data-zone-hidden', 'data-zone-emphasized', 'data-component-area', SHELL_OBJECT_ATTRIBUTE]) node.removeAttribute(attribute);\n  }\n  for (const media of element.querySelectorAll('iframe, video, audio')) media.remove();\n}\n\nfunction applyStyles(element: HTMLElement, styles: Readonly<Record<string, string>>): void {\n  for (const [property, value] of Object.entries(styles)) element.style.setProperty(property, value);\n}\n\n/** Two frames: the first lets the ghost render at its start pose, the second changes it, so the transition plays. */\nfunction afterPaint(run: () => void): void {\n  requestAnimationFrame(() => requestAnimationFrame(run));\n}\n\n/**\n * What a stylesheet cannot do alone, because the engine unmounts or hides a pane at once:\n *\n * - **Discard.** A side pane dismissed by its close control is removed from the DOM immediately. The removed node,\n *   no longer React's, is re-parented into the FRONT ghost layer at the box it last had, and goes to the axis's\n *   `DISCARDED` pose as it fades.\n * - **Expand.** An emphasized pane takes the width and the engine HIDES the others (`data-zone-hidden`). When the axis\n *   draws one (`drawsHiddenPanePicture`), a still, inert image of each hidden pane is left in the BACK ghost layer at\n *   the axis's `BEHIND` pose. It is a picture, never a\n *   control: returning to side by side is the pane's own restore control. The image returns to `REST` and fades when\n *   the emphasis ends.\n * - **Swap.** `dip(zone)` plays the axis's `PANE_SWAP` dip on a pane whose content changed in place.\n *\n * Needs {@link useShellStageMeasurement} running on the same stage (the boxes ghosts leave from), and the two ghost\n * layers (`[data-shell-ghost-layer=\"back\"]` and `\"front\"`) inside it. An axis with `durationMs: 0` plays nothing: no\n * discard ghost and no dip. The picture behind an expanded pane is still drawn — a still picture is not motion — at\n * its pose at once, and removed at once.\n */\nexport function useShellPaneMotion(rootRef: RefObject<HTMLElement | null>, axis: ShellMotionAxis): { dip: (zone: string) => void } {\n  useLayoutEffect(() => {\n    const root = rootRef.current;\n    if (!root) return undefined;\n    const back = root.querySelector<HTMLElement>(`[${SHELL_GHOST_LAYER_ATTRIBUTE}=\"${ShellGhostLayer.BACK}\"]`);\n    const front = root.querySelector<HTMLElement>(`[${SHELL_GHOST_LAYER_ATTRIBUTE}=\"${ShellGhostLayer.FRONT}\"]`);\n    if (!back || !front) return undefined;\n    const behind = new Map<Element, HTMLElement>();\n    const duration = axis.durationMs;\n\n    const createGhost = (kind: ShellGhostKind, rect: ShellStageRect): HTMLElement => {\n      const ghost = document.createElement('div');\n      ghost.setAttribute(SHELL_GHOST_ATTRIBUTE, kind);\n      ghost.setAttribute('aria-hidden', 'true');\n      Object.assign(ghost.style, { position: 'absolute', left: `${rect.left}px`, top: `${rect.top}px`, width: `${rect.width}px`, height: `${rect.height}px` });\n      applyStyles(ghost, axis.ghostPose(ShellGhostPose.REST, { rect, stage: root }));\n      return ghost;\n    };\n\n    const discard = (node: HTMLElement): void => {\n      const rect = shellStageRects.get(node);\n      // Moved rather than removed (taken out and put back in one batch): it is still on screen, not discarded.\n      if (!rect || duration === 0 || node.isConnected) return;\n      const ghost = createGhost(ShellGhostKind.DISCARDED, rect);\n      makeShellPicture(node);\n      ghost.appendChild(node);\n      front.appendChild(ghost);\n      afterPaint(() => {\n        applyStyles(ghost, axis.ghostPose(ShellGhostPose.DISCARDED, { rect, stage: root }));\n        ghost.style.opacity = '0';\n      });\n      setTimeout(() => ghost.remove(), duration + 60);\n    };\n\n    const syncBehind = (): void => {\n      const emphasized = root.querySelector('[data-zone-emphasized]');\n      // Only for an axis that draws one (`drawsHiddenPanePicture`). Drawn under reduced motion too: a still picture is\n      // not motion. Only its travel and fade are skipped.\n      const hidden = emphasized && axis.drawsHiddenPanePicture\n        ? [...root.querySelectorAll<HTMLElement>(SHELL_PANE_SELECTOR)].filter((pane) => pane.hasAttribute('data-zone-hidden'))\n        : [];\n      for (const [pane, ghost] of behind) {\n        if (hidden.includes(pane as HTMLElement)) continue;\n        behind.delete(pane);\n        if (duration === 0) { ghost.remove(); continue; }\n        const rect = shellStageRects.get(pane);\n        if (rect) applyStyles(ghost, axis.ghostPose(ShellGhostPose.REST, { rect, stage: root }));\n        ghost.style.opacity = '0';\n        setTimeout(() => ghost.remove(), duration);\n      }\n      for (const pane of hidden) {\n        if (behind.has(pane)) continue;\n        const rect = shellStageRects.get(pane);\n        if (!rect) continue;\n        const ghost = createGhost(ShellGhostKind.BEHIND, rect);\n        const copy = pane.cloneNode(true) as HTMLElement;\n        makeShellPicture(copy);\n        copy.classList.remove('hidden');\n        copy.style.width = '100%';\n        copy.style.height = '100%';\n        ghost.appendChild(copy);\n        behind.set(pane, ghost);\n        if (duration === 0) {\n          // Still: placed straight at its pose, with no transition to play.\n          applyStyles(ghost, axis.ghostPose(ShellGhostPose.BEHIND, { rect, stage: root }));\n          back.appendChild(ghost);\n          continue;\n        }\n        ghost.style.opacity = '0';\n        back.appendChild(ghost);\n        afterPaint(() => {\n          applyStyles(ghost, axis.ghostPose(ShellGhostPose.BEHIND, { rect, stage: root }));\n          ghost.style.opacity = '1';\n        });\n      }\n    };\n\n    /** The pane object an emphasis marker belongs to: the zone itself, or the resizable panel holding it. */\n    const paneOf = (element: Element): HTMLElement | null =>\n      (element.matches(SHELL_PANE_SELECTOR) ? element : element.closest('[data-panel-id^=\"nav-\"]')) as HTMLElement | null;\n\n    const observer = new MutationObserver((records) => {\n      for (const record of records) {\n        // An emphasis given or taken: the pane grows to its new width, or slides home (`ShellPaneResize.GROW`). The\n        // stage's last measurement still holds the box it had: measurement waits for the next frame.\n        if (record.type === 'attributes' && record.attributeName === 'data-zone-emphasized' && axis.paneResize === ShellPaneResize.GROW) {\n          const pane = record.target instanceof Element ? paneOf(record.target) : null;\n          const before = pane ? shellStageRects.get(pane) : undefined;\n          if (pane && before) {\n            if ((record.target as Element).hasAttribute('data-zone-emphasized')) growShellPane(pane, before, root, axis);\n            else slideShellPaneHome(pane, before, root, axis);\n          }\n          continue;\n        }\n        if (record.type !== 'childList') continue;\n        for (const node of record.removedNodes) {\n          // A detached node matches no selector that names its ancestors, so a pane is recognised by the box the\n          // stage last measured for it: only objects have one. Only a SIDE pane is ever dismissed — the primary pane\n          // leaves only when the content remounts (a breakpoint flip), which is not a discard.\n          if (node instanceof HTMLElement && shellStageRects.has(node) && isShellSidePane(node)) discard(node);\n        }\n      }\n      syncBehind();\n    });\n    const content = root.querySelector(shellRegionSelector(ShellRegion.CONTENT)) ?? root;\n    observer.observe(content, { childList: true, subtree: true, attributes: true, attributeFilter: ['data-zone-hidden', 'data-zone-emphasized'] });\n    syncBehind();\n    return () => {\n      observer.disconnect();\n      for (const ghost of behind.values()) ghost.remove();\n    };\n  }, [rootRef, axis]);\n\n  const dipRef = useRef<(zone: string) => void>(() => undefined);\n  useEffect(() => {\n    dipRef.current = (zone: string): void => {\n      const root = rootRef.current;\n      if (!root || axis.durationMs === 0) return;\n      const pane = root.querySelector<HTMLElement>(shellPaneSelectorForZone(zone));\n      if (!pane || typeof pane.animate !== 'function') return;\n      pane.animate([axis.dipPeak(ShellMotionDip.PANE_SWAP, { stage: root })], { duration: axis.durationMs, easing: axis.easing });\n    };\n  }, [rootRef, axis]);\n  return { dip: (zone) => dipRef.current(zone) };\n}\n\n/** A column's width must change by more than this to count as a fold, not a drag tremor. */\nconst COLUMN_RESIZE_THRESHOLD_PX = 24;\n\n/**\n * A side column (the sidebar folding to its rail or unfolding, a utility panel) plays the axis's `COLUMN_RESIZE` dip\n * while the panes re-arrange. The width animates over many frames, so the dip plays once per settled change larger\n * than a few pixels, and at most once per motion. It runs on the layout's OWN wrapper (`[data-shell-object]`).\n */\nexport function useShellColumnMotion(rootRef: RefObject<HTMLElement | null>, axis: ShellMotionAxis): void {\n  useEffect(() => {\n    const root = rootRef.current;\n    if (!root || axis.durationMs === 0 || typeof ResizeObserver === 'undefined') return undefined;\n    const columns = [...root.querySelectorAll<HTMLElement>(`[${SHELL_OBJECT_ATTRIBUTE}]`)].filter((wrapper) =>\n      wrapper.querySelector(`:scope > ${shellRegionSelector(ShellRegion.SIDEBAR)}, :scope > ${shellRegionSelector(ShellRegion.UTILITY_PANEL)}`));\n    const settled = new Map<HTMLElement, number>();\n    const lastDip = new Map<HTMLElement, number>();\n    const observer = new ResizeObserver((entries) => {\n      for (const entry of entries) {\n        const wrapper = entry.target as HTMLElement;\n        const width = wrapper.offsetWidth;\n        const previous = settled.get(wrapper);\n        if (previous === undefined || width === 0) { settled.set(wrapper, width); continue; }\n        if (Math.abs(width - previous) <= COLUMN_RESIZE_THRESHOLD_PX) continue;\n        settled.set(wrapper, width);\n        const now = performance.now();\n        if (now - (lastDip.get(wrapper) ?? 0) < axis.durationMs) continue;\n        lastDip.set(wrapper, now);\n        wrapper.animate([axis.dipPeak(ShellMotionDip.COLUMN_RESIZE, { stage: root })], { duration: axis.durationMs, easing: axis.easing });\n      }\n    });\n    for (const column of columns) observer.observe(column);\n    return () => observer.disconnect();\n  }, [rootRef, axis]);\n}\n\n/** @wildo_source:part:start saas.frontend.app-shell.use-shell-motion facet:layer:frontend facet:family:app-shell facet:audience:app-developer */\n/** What an animated layout's stage passes to {@link useShellMotion}. */\nexport interface ShellMotionOptions {\n  /** Which way things move, and for how long. Memoize it: the building blocks re-arm when it changes. */\n  axis: ShellMotionAxis;\n  /** The navigation state (`useNavigationState()`): its focused zone, its zones' places. */\n  navigation: ShellPlaceNavigation & Pick<NavigationContextType, 'focusedZone'>;\n  /** Called per object on every measurement, with its offset in the stage (a depth layout derives its origin here). */\n  onObjectMeasured?: (element: HTMLElement, offset: { left: number; top: number }, stage: HTMLElement) => void;\n}\n\n/**\n * Every motion building block an animated layout composes, on one stage: the measurement, the front pane, place\n * changes (a pane that opens or changes place comes forward, and a change in place dips), the discard and behind\n * ghosts, the column dip — and, as the axis chooses, a side pane or a dialog growing out of what was pressed, an\n * emphasized pane growing to its width, and rows cascading in (a side pane's arrival as a browser view transition when\n * the axis asks, `paneArrivalByViewTransition`). Returns the zone in front, which the layout exposes (as an attribute) for its stylesheet\n * to recede the others.\n *\n * The stage (`rootRef`) must contain the layout's region wrappers marked `data-shell-object`, the content outlet, and\n * the two ghost layers (`data-shell-ghost-layer=\"back\"` under the regions, `\"front\"` above them).\n */\nexport function useShellMotion(rootRef: RefObject<HTMLElement | null>, { axis, navigation, onObjectMeasured }: ShellMotionOptions): { frontZone: string } {\n  useShellStageMeasurement(rootRef, onObjectMeasured);\n  const { dip } = useShellPaneMotion(rootRef, axis);\n  const front = useShellFrontPane(rootRef, navigation.focusedZone);\n  useShellColumnMotion(rootRef, axis);\n  const origin = useShellPressOrigin(axis.paneArrival === ShellPaneArrival.FROM_PRESSED_ELEMENT || axis.dialogArrival === ShellDialogArrival.FROM_PRESSED_ELEMENT);\n  useShellDialogArrival(rootRef, axis, origin);\n  // A side pane's arrival carried out as a browser view transition, where the axis asks and the browser can: the\n  // navigation's commit runs inside it. It consumes the press, so the proxy below finds nothing to fly from.\n  useEffect(() => {\n    if (axis.paneArrival !== ShellPaneArrival.FROM_PRESSED_ELEMENT || !axis.paneArrivalByViewTransition || axis.durationMs === 0) return undefined;\n    if (!shellViewTransitionsAvailable()) return undefined;\n    const releaseStylesheet = installShellLayoutStylesheet('shell-view-transition', SHELL_VIEW_TRANSITION_CSS);\n    const uninstall = installNavigationCommitWrapper(createShellViewTransitionCommit({ stage: () => rootRef.current, origin, axis }));\n    return () => {\n      uninstall();\n      releaseStylesheet();\n    };\n  }, [rootRef, origin, axis]);\n  // One cascade per zone: two panes changing place together must not cancel each other's.\n  const cascades = useRef(new Map<string, () => void>());\n  useEffect(() => () => { for (const stop of cascades.current.values()) stop(); cascades.current.clear(); }, []);\n  useShellPlaceChanges(navigation, (zone, how) => {\n    if (how === ShellPlaceChange.CHANGED) dip(zone);\n    front.bringForward(zone);\n    const root = rootRef.current;\n    const pane = root?.querySelector<HTMLElement>(shellPaneSelectorForZone(zone));\n    if (!root || !pane || axis.durationMs === 0) return;\n    // A side pane that opened grows out of the row pressed to open it (`ShellPaneArrival.FROM_PRESSED_ELEMENT`).\n    if (how === ShellPlaceChange.APPEARED && axis.paneArrival === ShellPaneArrival.FROM_PRESSED_ELEMENT && isShellSidePane(pane)) {\n      const from = origin.takeRow(SHELL_PRESS_ORIGIN_MAX_AGE_MS);\n      if (from) void flyShellProxy(root, from, pane.getBoundingClientRect(), axis, pane);\n    }\n    if (axis.cascadesRows) {\n      cascades.current.get(zone)?.();\n      cascades.current.set(zone, cascadeShellRows(pane, axis));\n    }\n  });\n  return { frontZone: front.zone };\n}\n/** @wildo_source:part:end saas.frontend.app-shell.use-shell-motion */\n"]}

package/dist/esm/core/app-shell/useAppShellLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAppShellLayout.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"AAUA,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,uEAAuE,CAAC;AAEtI,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM9D;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,eAAe,EAAE,OAAO,GAAG,kBAAkB,CActF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAqDtD"}
+{"version":3,"file":"useAppShellLayout.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"AAUA,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,uEAAuE,CAAC;AAEtI,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAO9D;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,eAAe,EAAE,OAAO,GAAG,kBAAkB,CActF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAiEtD"}

package/dist/esm/core/app-shell/useAppShellLayout.js

@@ -7,6 +7,7 @@ import { MainContextInitComponents } from '../../core/runtime/runtime.frontend.s
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
 import { isStatusBarPlacement } from '../../core/config/app-level-components.frontend.schemas.js';
 import { isSidebarConfigObject, isStatusBarConfigObject, isUtilityPanelConfigObject } from './app-shell.schemas.js';
+import { isHostedInShellChrome } from './hosted-components.utils.js';
 /** Values already reported, so a render loop reports each unplaceable value once. */
 const reportedStatusBarPlacements = new Set();
 /**
@@ -59,6 +60,8 @@ export function useAppShellLayout() {
                 hasActivityBar: false,
                 hasQuickActionButton: false,
                 hasUtilityPanel: false,
+                quickActionButtonHostedInChrome: false,
+                utilityPanelHostedInChrome: false,
                 sidebarPlacement: HorizontalPlacement.START,
                 statusBarPlacement: VerticalPlacement.BOTTOM,
                 utilityPanelPlacement: HorizontalPlacement.END,
@@ -79,6 +82,8 @@ export function useAppShellLayout() {
             hasActivityBar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.ACTIVITY_BAR]),
             hasQuickActionButton: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]),
             hasUtilityPanel: Boolean(utilityPanelConfig),
+            quickActionButtonHostedInChrome: isHostedInShellChrome(ApplicationLevelComponentType.QUICK_ACTION_BUTTON, appComponentsConfiguration, UIConfig?.currentBreakpoint),
+            utilityPanelHostedInChrome: isHostedInShellChrome(ApplicationLevelComponentType.UTILITY_PANEL, appComponentsConfiguration, UIConfig?.currentBreakpoint),
             sidebarPlacement,
             statusBarPlacement: resolveStatusBarPlacement(statusBarConfig),
             utilityPanelPlacement: isUtilityPanelConfigObject(utilityPanelConfig)
@@ -86,6 +91,6 @@ export function useAppShellLayout() {
                 : HorizontalPlacement.END,
             isLayoutReady: true,
         };
-    }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration]);
+    }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration, UIConfig?.currentBreakpoint]);
 }
 //# sourceMappingURL=useAppShellLayout.js.map

package/dist/esm/core/app-shell/useAppShellLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAppShellLayout.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo } from 'react';\n\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\n\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nimport { isStatusBarPlacement, type StatusBarPlacement } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\n\nimport type { AppShellLayoutInfo } from './app-shell.schemas';\nimport { isSidebarConfigObject, isStatusBarConfigObject, isUtilityPanelConfigObject } from './app-shell.schemas';\n\n/** Values already reported, so a render loop reports each unplaceable value once. */\nconst reportedStatusBarPlacements = new Set<string>();\n\n/**\n * The status bar's placement from its configuration: the shorthand string, or the object form's `placement`.\n *\n * Unconfigured means the bottom edge. A configured value no layout can place — `MIDDLE`, or any other string —\n * used to be passed through and render the status bar NOWHERE (#2037); it is now reported, and the status bar is\n * shown at the bottom edge, where an unconfigured one goes. Reporting rather than refusing: the configuration is\n * the application's to correct, and a missing status bar is a worse outcome than one at its default edge.\n */\nexport function resolveStatusBarPlacement(statusBarConfig: unknown): StatusBarPlacement {\n  const configured = typeof statusBarConfig === 'string'\n    ? statusBarConfig\n    : isStatusBarConfigObject(statusBarConfig) ? statusBarConfig.placement : undefined;\n  if (configured === undefined) return VerticalPlacement.BOTTOM;\n  if (isStatusBarPlacement(configured)) return configured;\n  const value = String(configured);\n  if (!reportedStatusBarPlacements.has(value)) {\n    reportedStatusBarPlacements.add(value);\n    LoggerFrontendService.getLogger().warn(\n      `[app-shell] the status bar is configured at '${value}', which no shell layout places (only '${VerticalPlacement.TOP}' and '${VerticalPlacement.BOTTOM}'); it is shown at '${VerticalPlacement.BOTTOM}'.`,\n    );\n  }\n  return VerticalPlacement.BOTTOM;\n}\n\n/**\n * Pure behavior hook for the app shell layout — computes which app-level\n * components are present and their placement, and gates application\n * initialization via `markComponentInitialized`.\n *\n * `has*` flags reflect *config presence*, not visibility (breakpoint-gated\n * visibility is the preset's responsibility).\n */\nexport function useAppShellLayout(): AppShellLayoutInfo {\n  const { UIConfig, navigationLayout: resolvedNavigationLayout, appComponentsConfiguration } = useUI();\n  const { markComponentInitialized } = useApplication();\n\n  const isLayoutReady = Boolean(resolvedNavigationLayout && appComponentsConfiguration);\n\n  useEffect(() => {\n    if (isLayoutReady) {\n      markComponentInitialized(MainContextInitComponents.APP_MAIN_CONTAINER);\n    }\n  }, [isLayoutReady, markComponentInitialized]);\n\n  return useMemo((): AppShellLayoutInfo => {\n    if (!isLayoutReady || !resolvedNavigationLayout || !appComponentsConfiguration) {\n      return {\n        hasMenubar: false,\n        hasSidebar: false,\n        hasStatusBar: false,\n        hasToolbar: false,\n        hasActivityBar: false,\n        hasQuickActionButton: false,\n        hasUtilityPanel: false,\n        sidebarPlacement: HorizontalPlacement.START,\n        statusBarPlacement: VerticalPlacement.BOTTOM,\n        utilityPanelPlacement: HorizontalPlacement.END,\n        isLayoutReady: false,\n      };\n    }\n\n    const sidebarConfig = appComponentsConfiguration[ApplicationLevelComponentType.SIDEBAR] as unknown;\n    const statusBarConfig = appComponentsConfiguration[ApplicationLevelComponentType.STATUS_BAR];\n    const utilityPanelConfig = appComponentsConfiguration[ApplicationLevelComponentType.UTILITY_PANEL];\n\n    const sidebarPlacement = isSidebarConfigObject(sidebarConfig)\n      ? sidebarConfig.placement\n      : HorizontalPlacement.START;\n\n    return {\n      hasMenubar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.MENUBAR]),\n      hasSidebar: Boolean(sidebarConfig),\n      hasStatusBar: Boolean(statusBarConfig),\n      hasToolbar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.TOOLBAR]),\n      hasActivityBar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.ACTIVITY_BAR]),\n      hasQuickActionButton: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]),\n      hasUtilityPanel: Boolean(utilityPanelConfig),\n      sidebarPlacement,\n      statusBarPlacement: resolveStatusBarPlacement(statusBarConfig),\n      utilityPanelPlacement: isUtilityPanelConfigObject(utilityPanelConfig)\n        ? utilityPanelConfig.position ?? HorizontalPlacement.END\n        : HorizontalPlacement.END,\n      isLayoutReady: true,\n    };\n  }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration]);\n}\n"]}
+{"version":3,"file":"useAppShellLayout.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo } from 'react';\n\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\n\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nimport { isStatusBarPlacement, type StatusBarPlacement } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\n\nimport type { AppShellLayoutInfo } from './app-shell.schemas';\nimport { isSidebarConfigObject, isStatusBarConfigObject, isUtilityPanelConfigObject } from './app-shell.schemas';\nimport { isHostedInShellChrome } from './hosted-components.utils';\n\n/** Values already reported, so a render loop reports each unplaceable value once. */\nconst reportedStatusBarPlacements = new Set<string>();\n\n/**\n * The status bar's placement from its configuration: the shorthand string, or the object form's `placement`.\n *\n * Unconfigured means the bottom edge. A configured value no layout can place — `MIDDLE`, or any other string —\n * used to be passed through and render the status bar NOWHERE (#2037); it is now reported, and the status bar is\n * shown at the bottom edge, where an unconfigured one goes. Reporting rather than refusing: the configuration is\n * the application's to correct, and a missing status bar is a worse outcome than one at its default edge.\n */\nexport function resolveStatusBarPlacement(statusBarConfig: unknown): StatusBarPlacement {\n  const configured = typeof statusBarConfig === 'string'\n    ? statusBarConfig\n    : isStatusBarConfigObject(statusBarConfig) ? statusBarConfig.placement : undefined;\n  if (configured === undefined) return VerticalPlacement.BOTTOM;\n  if (isStatusBarPlacement(configured)) return configured;\n  const value = String(configured);\n  if (!reportedStatusBarPlacements.has(value)) {\n    reportedStatusBarPlacements.add(value);\n    LoggerFrontendService.getLogger().warn(\n      `[app-shell] the status bar is configured at '${value}', which no shell layout places (only '${VerticalPlacement.TOP}' and '${VerticalPlacement.BOTTOM}'); it is shown at '${VerticalPlacement.BOTTOM}'.`,\n    );\n  }\n  return VerticalPlacement.BOTTOM;\n}\n\n/**\n * Pure behavior hook for the app shell layout — computes which app-level\n * components are present and their placement, and gates application\n * initialization via `markComponentInitialized`.\n *\n * `has*` flags reflect *config presence*, not visibility (breakpoint-gated\n * visibility is the preset's responsibility).\n */\nexport function useAppShellLayout(): AppShellLayoutInfo {\n  const { UIConfig, navigationLayout: resolvedNavigationLayout, appComponentsConfiguration } = useUI();\n  const { markComponentInitialized } = useApplication();\n\n  const isLayoutReady = Boolean(resolvedNavigationLayout && appComponentsConfiguration);\n\n  useEffect(() => {\n    if (isLayoutReady) {\n      markComponentInitialized(MainContextInitComponents.APP_MAIN_CONTAINER);\n    }\n  }, [isLayoutReady, markComponentInitialized]);\n\n  return useMemo((): AppShellLayoutInfo => {\n    if (!isLayoutReady || !resolvedNavigationLayout || !appComponentsConfiguration) {\n      return {\n        hasMenubar: false,\n        hasSidebar: false,\n        hasStatusBar: false,\n        hasToolbar: false,\n        hasActivityBar: false,\n        hasQuickActionButton: false,\n        hasUtilityPanel: false,\n        quickActionButtonHostedInChrome: false,\n        utilityPanelHostedInChrome: false,\n        sidebarPlacement: HorizontalPlacement.START,\n        statusBarPlacement: VerticalPlacement.BOTTOM,\n        utilityPanelPlacement: HorizontalPlacement.END,\n        isLayoutReady: false,\n      };\n    }\n\n    const sidebarConfig = appComponentsConfiguration[ApplicationLevelComponentType.SIDEBAR] as unknown;\n    const statusBarConfig = appComponentsConfiguration[ApplicationLevelComponentType.STATUS_BAR];\n    const utilityPanelConfig = appComponentsConfiguration[ApplicationLevelComponentType.UTILITY_PANEL];\n\n    const sidebarPlacement = isSidebarConfigObject(sidebarConfig)\n      ? sidebarConfig.placement\n      : HorizontalPlacement.START;\n\n    return {\n      hasMenubar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.MENUBAR]),\n      hasSidebar: Boolean(sidebarConfig),\n      hasStatusBar: Boolean(statusBarConfig),\n      hasToolbar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.TOOLBAR]),\n      hasActivityBar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.ACTIVITY_BAR]),\n      hasQuickActionButton: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]),\n      hasUtilityPanel: Boolean(utilityPanelConfig),\n      quickActionButtonHostedInChrome: isHostedInShellChrome(\n        ApplicationLevelComponentType.QUICK_ACTION_BUTTON,\n        appComponentsConfiguration as Record<string, unknown>,\n        UIConfig?.currentBreakpoint,\n      ),\n      utilityPanelHostedInChrome: isHostedInShellChrome(\n        ApplicationLevelComponentType.UTILITY_PANEL,\n        appComponentsConfiguration as Record<string, unknown>,\n        UIConfig?.currentBreakpoint,\n      ),\n      sidebarPlacement,\n      statusBarPlacement: resolveStatusBarPlacement(statusBarConfig),\n      utilityPanelPlacement: isUtilityPanelConfigObject(utilityPanelConfig)\n        ? utilityPanelConfig.position ?? HorizontalPlacement.END\n        : HorizontalPlacement.END,\n      isLayoutReady: true,\n    };\n  }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration, UIConfig?.currentBreakpoint]);\n}\n"]}

package/dist/esm/core/app-shell/usePublicShellLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePublicShellLayout.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAQxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAqCjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,UAAQ,EACrB,oBAAoB,CAAC,EAAE,0BAA0B,CAAC,sBAAsB,CAAC,GACxE,qBAAqB,CAyCvB"}
+{"version":3,"file":"usePublicShellLayout.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AASxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAqCjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,UAAQ,EACrB,oBAAoB,CAAC,EAAE,0BAA0B,CAAC,sBAAsB,CAAC,GACxE,qBAAqB,CA+CvB"}