@openmrs/esm-styleguide 10.0.1-pre.5704 → 10.0.1-pre.5707

package/.turbo/turbo-build.log

@@ -1,3 +1,3 @@
-[0] Successfully compiled: 115 files, copied 169 files with swc (278.14ms)
+[0] Successfully compiled: 117 files, copied 170 files with swc (252.19ms)
 [0] swc --strip-leading-paths --copy-files src -d dist && svgo -rf dist --quiet exited with code 0
 [1] tsc --project tsconfig.build.json exited with code 0

package/dist/public.d.ts

@@ -23,5 +23,5 @@ export * from './pictograms/pictograms';
 export * from './responsive-wrapper';
 export { showSnackbar, type SnackbarDescriptor, type SnackbarType, type SnackbarMeta } from './snackbars';
 export { showToast, type ToastDescriptor, type ToastType, type ToastNotificationMeta } from './toasts';
-export { launchWorkspace2, launchWorkspaceGroup2, closeWorkspaceGroup2, getRegisteredWorkspace2Names, useWorkspace2Context, ActionMenuButton2, Workspace2, type Workspace2Definition, type Workspace2DefinitionProps, } from './workspaces2';
+export { launchWorkspace2, launchWorkspaceGroup2, closeWorkspaceGroup2, getRegisteredWorkspace2Names, useWorkspace2Context, ActionMenuButton2, Workspace2, type Workspace2Definition, type Workspace2DefinitionProps, ExportedWorkspace, type ExportedWorkspaceProps, type ExportedWorkspaceWindowInfo, } from './workspaces2';
 //# sourceMappingURL=public.d.ts.map

package/dist/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,cAAc,SAAS,CAAC;AACxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,GAChC,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,KAAK,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAClH,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1G,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACvG,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,eAAe,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,cAAc,SAAS,CAAC;AACxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EACL,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,GAChC,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,KAAK,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAClH,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1G,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACvG,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,GACjC,MAAM,eAAe,CAAC"}

package/dist/public.js

@@ -20,4 +20,4 @@ export * from "./pictograms/pictograms.js";
 export * from "./responsive-wrapper/index.js";
 export { showSnackbar } from "./snackbars/index.js";
 export { showToast } from "./toasts/index.js";
-export { launchWorkspace2, launchWorkspaceGroup2, closeWorkspaceGroup2, getRegisteredWorkspace2Names, useWorkspace2Context, ActionMenuButton2, Workspace2 } from "./workspaces2/index.js";
+export { launchWorkspace2, launchWorkspaceGroup2, closeWorkspaceGroup2, getRegisteredWorkspace2Names, useWorkspace2Context, ActionMenuButton2, Workspace2, ExportedWorkspace } from "./workspaces2/index.js";

package/dist/workspaces2/active-workspace-window.component.d.ts

@@ -1,11 +1,21 @@
 import React from 'react';
 import { type OpenedWindow } from '@openmrs/esm-extensions';
+import { type WorkspaceWindowActions } from './workspace-window-actions';
 interface WorkspaceWindowProps {
     openedWindow: OpenedWindow;
+    groupProps: Record<string, any> | null;
+    actions: WorkspaceWindowActions;
+    /**
+     * Whether to render the workspace window "chrome" (containers, title bar, maximize / hide / close).
+     * Only the global workspace window system renders it; an `<ExportedWorkspace>` renders the bare
+     * workspace content.
+     */
+    renderChrome: boolean;
     showActionMenu: boolean;
 }
 /**
- * Renders an opened workspace window.
+ * Renders an opened workspace window. `actions` determines which store the window's workspaces
+ * navigate within: the global workspace window system, or an `<ExportedWorkspace>`'s local store.
  */
 declare const ActiveWorkspaceWindow: React.FC<WorkspaceWindowProps>;
 export default ActiveWorkspaceWindow;

package/dist/workspaces2/active-workspace-window.component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"active-workspace-window.component.d.ts","sourceRoot":"","sources":["../../src/workspaces2/active-workspace-window.component.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAK5D,OAAO,EAAE,KAAK,YAAY,EAA8D,MAAM,yBAAyB,CAAC;AAOxH,UAAU,oBAAoB;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;CACzB;AACD;;GAEG;AACH,QAAA,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA4CzD,CAAC;AA4IF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"active-workspace-window.component.d.ts","sourceRoot":"","sources":["../../src/workspaces2/active-workspace-window.component.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuD,MAAM,OAAO,CAAC;AAM5E,OAAO,EACL,KAAK,YAAY,EAKlB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGzE,UAAU,oBAAoB;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACvC,OAAO,EAAE,sBAAsB,CAAC;IAChC;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB;AAKD;;;GAGG;AACH,QAAA,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA4DzD,CAAC;AAoRF,eAAe,qBAAqB,CAAC"}

package/dist/workspaces2/active-workspace-window.component.js

@@ -2,15 +2,21 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import React, { useEffect, useMemo, useState } from "react";
 import classNames from "classnames";
 import Parcel from "single-spa-react/parcel";
-import { InlineLoading } from "@carbon/react";
+import { Header, HeaderGlobalAction, HeaderGlobalBar, HeaderName, InlineLoading } from "@carbon/react";
+import { DownToBottom, Maximize, Minimize } from "@carbon/react/icons";
 import { createParcelMounter, workspace2Store } from "@openmrs/esm-extensions";
+import { isDesktop, useLayoutType, useStore } from "@openmrs/esm-react-utils";
 import { loadLifeCycles } from "@openmrs/esm-routes";
 import { getCoreTranslation } from "@openmrs/esm-translations";
-import { promptForClosingWorkspaces, useWorkspace2Store } from "./workspace2.js";
+import { ArrowRightIcon, CloseIcon } from "../icons/index.js";
+import { closeWorkspaceGroup2, useWorkspace2Store } from "./workspace2.js";
 import styles from "./workspace2.module.scss";
+// module-level so the store subscription's snapshot getter stays stable across renders
+const selectRegisteredWorkspacesByName = (state)=>state.registeredWorkspacesByName;
 /**
- * Renders an opened workspace window.
- */ const ActiveWorkspaceWindow = ({ openedWindow, showActionMenu })=>{
+ * Renders an opened workspace window. `actions` determines which store the window's workspaces
+ * navigate within: the global workspace window system, or an `<ExportedWorkspace>`'s local store.
+ */ const ActiveWorkspaceWindow = ({ openedWindow, groupProps, actions, renderChrome, showActionMenu })=>{
     const { openedWorkspaces } = openedWindow;
     // Keyed by opened workspace uuid rather than stack index. The lifecycles load
     // asynchronously, so when the stack changes (a workspace at some position is
@@ -20,30 +26,39 @@ import styles from "./workspace2.module.scss";
     // mounts whatever config it first receives, so the wrong component would then
     // render with the new workspace's props.
     const [lifeCyclesByUuid, setLifeCyclesByUuid] = useState({});
-    const { registeredWorkspacesByName } = workspace2Store.getState();
+    // Reactive so the effect retries when a workspace registers after mount.
+    const registeredWorkspacesByName = useStore(workspace2Store, selectRegisteredWorkspacesByName);
     useEffect(()=>{
         let cancelled = false;
         Promise.all(openedWorkspaces.map(async (openedWorkspace)=>{
-            const { moduleName, component } = registeredWorkspacesByName[openedWorkspace.workspaceName];
+            const workspaceDef = registeredWorkspacesByName[openedWorkspace.workspaceName];
+            if (!workspaceDef) {
+                return null;
+            }
+            const { moduleName, component } = workspaceDef;
             return [
                 openedWorkspace.uuid,
                 await loadLifeCycles(moduleName, component)
             ];
         })).then((entries)=>{
             if (!cancelled) {
-                setLifeCyclesByUuid(Object.fromEntries(entries));
+                setLifeCyclesByUuid(Object.fromEntries(entries.filter((entry)=>entry != null)));
             }
         });
         return ()=>{
             cancelled = true;
         };
     }, [
-        openedWorkspaces
+        openedWorkspaces,
+        registeredWorkspacesByName
     ]);
     return /*#__PURE__*/ _jsx(_Fragment, {
         children: openedWorkspaces.map((openedWorkspace, i)=>/*#__PURE__*/ _jsx(ActiveWorkspace, {
                 openedWorkspace: openedWorkspace,
                 openedWindow: openedWindow,
+                groupProps: groupProps,
+                actions: actions,
+                renderChrome: renderChrome,
                 lifeCycle: lifeCyclesByUuid[openedWorkspace.uuid],
                 isRootWorkspace: i === 0,
                 isLeafWorkspace: i === openedWorkspaces.length - 1,
@@ -52,31 +67,21 @@ import styles from "./workspace2.module.scss";
     });
 };
 const mountParcel = createParcelMounter();
-const ActiveWorkspace = ({ lifeCycle, openedWorkspace, openedWindow, isRootWorkspace, isLeafWorkspace, showActionMenu })=>{
-    const { openedGroup, closeWorkspace, openChildWorkspace } = useWorkspace2Store();
+const ActiveWorkspace = ({ lifeCycle, openedWorkspace, openedWindow, groupProps, actions, renderChrome, isRootWorkspace, isLeafWorkspace, showActionMenu })=>{
     const props = useMemo(()=>openedWorkspace && {
             closeWorkspace: async (options = {})=>{
                 const { closeWindow = false, discardUnsavedChanges = false } = options;
                 if (closeWindow) {
-                    const okToCloseWorkspaces = discardUnsavedChanges || await promptForClosingWorkspaces({
-                        reason: 'CLOSE_WINDOW',
-                        explicit: true,
-                        windowName: openedWindow.windowName
-                    });
+                    const okToCloseWorkspaces = discardUnsavedChanges || await actions.promptForClosingWorkspaces();
                     if (okToCloseWorkspaces) {
-                        closeWorkspace(openedWindow.openedWorkspaces[0].workspaceName);
+                        actions.closeWorkspace(openedWindow.openedWorkspaces[0].workspaceName);
                         return true;
                     }
                     return false;
                 } else {
-                    const okToCloseWorkspaces = discardUnsavedChanges || await promptForClosingWorkspaces({
-                        reason: 'CLOSE_WORKSPACE',
-                        explicit: true,
-                        windowName: openedWindow.windowName,
-                        workspaceName: openedWorkspace.workspaceName
-                    });
+                    const okToCloseWorkspaces = discardUnsavedChanges || await actions.promptForClosingWorkspaces(openedWorkspace.workspaceName);
                     if (okToCloseWorkspaces) {
-                        closeWorkspace(openedWorkspace.workspaceName);
+                        actions.closeWorkspace(openedWorkspace.workspaceName);
                         return true;
                     }
                     return false;
@@ -95,23 +100,20 @@ const ActiveWorkspace = ({ lifeCycle, openedWorkspace, openedWindow, isRootWorks
                     // Prompt if any of them have unsaved changes.
                     const workspacesAboveParent = openedWorkspaces.slice(parentIndex + 1);
                     if (workspacesAboveParent.some((w)=>w.hasUnsavedChanges)) {
-                        const okToClose = await promptForClosingWorkspaces({
-                            reason: 'CLOSE_WORKSPACE',
-                            explicit: true,
-                            windowName: openedWindow.windowName,
-                            workspaceName: openedWorkspaces[parentIndex + 1].workspaceName
-                        });
+                        const okToClose = await actions.promptForClosingWorkspaces(openedWorkspaces[parentIndex + 1].workspaceName);
                         if (!okToClose) {
                             return;
                         }
                     }
                 }
-                openChildWorkspace(parentWorkspaceName, childWorkspaceName, childWorkspaceProps || {});
+                actions.openChildWorkspace(parentWorkspaceName, childWorkspaceName, childWorkspaceProps || {});
             },
+            setWorkspaceTitle: (title)=>actions.setWorkspaceTitle(openedWorkspace.uuid, title),
+            setHasUnsavedChanges: (hasUnsavedChanges)=>actions.setHasUnsavedChanges(openedWorkspace.uuid, hasUnsavedChanges),
             workspaceName: openedWorkspace.workspaceName,
             workspaceProps: openedWorkspace.props,
             windowProps: openedWindow.props,
-            groupProps: openedGroup && openedGroup.props ? openedGroup.props : null,
+            groupProps,
             workspaceMeta: workspace2Store.getState().registeredWorkspacesByName[openedWorkspace.workspaceName]?.meta ?? {},
             isRootWorkspace,
             isLeafWorkspace,
@@ -119,51 +121,160 @@ const ActiveWorkspace = ({ lifeCycle, openedWorkspace, openedWindow, isRootWorks
             showActionMenu
         }, [
         openedWorkspace,
-        closeWorkspace,
-        openedGroup,
-        openedWindow
+        openedWindow,
+        groupProps,
+        actions,
+        isRootWorkspace,
+        isLeafWorkspace,
+        showActionMenu
+    ]);
+    // In bare mode (<ExportedWorkspace>) there is no chrome to stack workspaces, so every non-leaf
+    // workspace is hidden (not unmounted, so it keeps its state) and the leaf covers them. In chrome
+    // mode the absolute-positioned WorkspaceChrome containers handle stacking, so this class is not
+    // applied there.
+    const hideBehindLeaf = !renderChrome && !isLeafWorkspace;
+    const content = useMemo(()=>lifeCycle ? /*#__PURE__*/ _jsx(Parcel, {
+            config: lifeCycle,
+            mountParcel: mountParcel,
+            wrapWith: "div",
+            wrapClassName: classNames(styles.workspaceContent, {
+                [styles.hiddenExtraWorkspace]: hideBehindLeaf
+            }),
+            ...props
+        }, openedWorkspace.workspaceName) : null, [
+        lifeCycle,
+        openedWorkspace.workspaceName,
+        props,
+        hideBehindLeaf
     ]);
-    if (!lifeCycle) {
-        const { registeredWorkspacesByName } = workspace2Store.getState();
-        const workspaceDef = registeredWorkspacesByName[openedWorkspace.workspaceName];
-        const windowName = workspaceDef && workspaceDef.window ? workspaceDef.window : undefined;
-        const { registeredWindowsByName } = workspace2Store.getState();
-        const windowDef = windowName ? registeredWindowsByName[windowName] : undefined;
-        const width = windowDef && windowDef.width ? windowDef.width : 'narrow';
-        const isActionMenuOpened = Object.values(registeredWindowsByName).some((window)=>window.group === openedGroup?.groupName && window.icon !== undefined);
-        return /*#__PURE__*/ _jsxs("div", {
-            className: classNames(styles.workspaceOuterContainer, {
-                [styles.narrowWorkspace]: width === 'narrow',
-                [styles.widerWorkspace]: width === 'wider',
-                [styles.extraWideWorkspace]: width === 'extra-wide',
-                [styles.isActionMenuOpened]: isActionMenuOpened
+    if (!renderChrome) {
+        return content ?? /*#__PURE__*/ _jsx(InlineLoading, {
+            className: classNames(styles.loader, {
+                [styles.hiddenExtraWorkspace]: hideBehindLeaf
+            }),
+            description: `${getCoreTranslation('loading')}`
+        });
+    }
+    return /*#__PURE__*/ _jsx(WorkspaceChrome, {
+        openedWorkspace: openedWorkspace,
+        openedWindow: openedWindow,
+        isRootWorkspace: isRootWorkspace,
+        showActionMenu: showActionMenu,
+        closeWindow: ()=>props.closeWorkspace({
+                closeWindow: true
+            }),
+        children: content
+    });
+};
+/**
+ * Renders the containers, title bar and window buttons around a workspace in the global workspace
+ * window system.
+ */ const WorkspaceChrome = ({ openedWorkspace, openedWindow, isRootWorkspace, showActionMenu, closeWindow, children })=>{
+    const layout = useLayoutType();
+    const { openedGroup, openedWindows, registeredWindowsByName, registeredGroupsByName, isMostRecentlyOpenedWindowHidden, setWindowMaximized, hideWindow } = useWorkspace2Store();
+    const windowName = openedWindow.windowName;
+    const { maximized } = openedWindow;
+    const title = openedWorkspace.title ?? '';
+    const windowDef = registeredWindowsByName[windowName];
+    const width = windowDef?.width ?? 'narrow';
+    const icon = windowDef?.icon;
+    const canMaximize = windowDef?.canMaximize;
+    const canCloseGroup = openedGroup ? registeredGroupsByName[openedGroup.groupName]?.persistence === 'closable' : false;
+    const canHide = !!icon && !canCloseGroup;
+    const openedWindowIndex = openedWindows.findIndex((w)=>w.windowName === windowName);
+    const isWindowHidden = openedWindowIndex < openedWindows.length - 1 || isMostRecentlyOpenedWindowHidden;
+    const isActionMenuOpened = Object.values(registeredWindowsByName).some((window)=>window.group === openedGroup?.groupName && window.icon !== undefined);
+    return /*#__PURE__*/ _jsxs("div", {
+        className: classNames(styles.workspaceOuterContainer, {
+            [styles.narrowWorkspace]: width === 'narrow',
+            [styles.widerWorkspace]: width === 'wider',
+            [styles.extraWideWorkspace]: width === 'extra-wide',
+            [styles.isActionMenuOpened]: isActionMenuOpened
+        }),
+        children: [
+            /*#__PURE__*/ _jsx("div", {
+                className: classNames(styles.workspaceSpacer, {
+                    [styles.hidden]: isWindowHidden
+                })
             }),
-            children: [
-                /*#__PURE__*/ _jsx("div", {
-                    className: styles.workspaceSpacer
+            /*#__PURE__*/ _jsx("div", {
+                className: classNames(styles.workspaceMiddleContainer, {
+                    [styles.maximized]: maximized,
+                    [styles.hidden]: isWindowHidden,
+                    [styles.isRootWorkspace]: isRootWorkspace,
+                    [styles.showActionMenu]: showActionMenu
                 }),
-                /*#__PURE__*/ _jsx("div", {
-                    className: classNames(styles.workspaceMiddleContainer, {
-                        [styles.isRootWorkspace]: isRootWorkspace,
-                        [styles.showActionMenu]: showActionMenu
+                children: /*#__PURE__*/ _jsx("div", {
+                    className: classNames(styles.workspaceInnerContainer, {
+                        [styles.maximized]: maximized,
+                        [styles.hidden]: isWindowHidden,
+                        [styles.isRootWorkspace]: isRootWorkspace
                     }),
-                    children: /*#__PURE__*/ _jsx("div", {
-                        className: classNames(styles.workspaceInnerContainer, {
-                            [styles.isRootWorkspace]: isRootWorkspace
-                        }),
-                        children: /*#__PURE__*/ _jsx(InlineLoading, {
-                            className: styles.loader,
-                            description: `${getCoreTranslation('loading')} ...`
-                        })
+                    children: children ? /*#__PURE__*/ _jsxs(_Fragment, {
+                        children: [
+                            /*#__PURE__*/ _jsxs(Header, {
+                                "aria-label": getCoreTranslation('workspaceHeader'),
+                                className: styles.header,
+                                children: [
+                                    /*#__PURE__*/ _jsx(HeaderName, {
+                                        prefix: "",
+                                        children: title
+                                    }),
+                                    /*#__PURE__*/ _jsx("div", {
+                                        className: styles.overlayHeaderSpacer
+                                    }),
+                                    /*#__PURE__*/ _jsx(HeaderGlobalBar, {
+                                        className: styles.headerButtons,
+                                        children: isDesktop(layout) ? /*#__PURE__*/ _jsxs(_Fragment, {
+                                            children: [
+                                                (canMaximize || maximized) && /*#__PURE__*/ _jsx(HeaderGlobalAction, {
+                                                    "aria-label": maximized ? getCoreTranslation('minimize') : getCoreTranslation('maximize'),
+                                                    onClick: ()=>setWindowMaximized(windowName, !maximized),
+                                                    children: maximized ? /*#__PURE__*/ _jsx(Minimize, {}) : /*#__PURE__*/ _jsx(Maximize, {})
+                                                }),
+                                                canHide && /*#__PURE__*/ _jsx(HeaderGlobalAction, {
+                                                    "aria-label": getCoreTranslation('hide'),
+                                                    onClick: ()=>hideWindow(),
+                                                    children: /*#__PURE__*/ _jsx(ArrowRightIcon, {})
+                                                }),
+                                                !canCloseGroup && /*#__PURE__*/ _jsx(HeaderGlobalAction, {
+                                                    "aria-label": getCoreTranslation('close'),
+                                                    onClick: closeWindow,
+                                                    children: /*#__PURE__*/ _jsx(CloseIcon, {})
+                                                })
+                                            ]
+                                        }) : /*#__PURE__*/ _jsxs(_Fragment, {
+                                            children: [
+                                                canHide && /*#__PURE__*/ _jsx(HeaderGlobalAction, {
+                                                    "aria-label": getCoreTranslation('hide'),
+                                                    onClick: ()=>hideWindow(),
+                                                    children: /*#__PURE__*/ _jsx(DownToBottom, {})
+                                                }),
+                                                /*#__PURE__*/ _jsx(HeaderGlobalAction, {
+                                                    "aria-label": getCoreTranslation('close'),
+                                                    onClick: ()=>{
+                                                        if (canCloseGroup) {
+                                                            void closeWorkspaceGroup2();
+                                                        } else {
+                                                            closeWindow();
+                                                        }
+                                                    },
+                                                    children: /*#__PURE__*/ _jsx(CloseIcon, {})
+                                                })
+                                            ]
+                                        })
+                                    })
+                                ]
+                            }),
+                            children
+                        ]
+                    }) : /*#__PURE__*/ _jsx(InlineLoading, {
+                        className: styles.loader,
+                        description: `${getCoreTranslation('loading')} ...`
                     })
                 })
-            ]
-        });
-    }
-    return /*#__PURE__*/ _jsx(Parcel, {
-        config: lifeCycle,
-        mountParcel: mountParcel,
-        ...props
-    }, openedWorkspace.workspaceName);
+            })
+        ]
+    });
 };
 export default ActiveWorkspaceWindow;

package/dist/workspaces2/exported-workspace.component.d.ts

@@ -0,0 +1,42 @@
+import React from 'react';
+import { type WorkspaceWindow2Width } from '@openmrs/esm-globals';
+export interface ExportedWorkspaceWindowInfo {
+    /** The name of the currently-rendered (leaf) workspace, or `null` when all workspaces are closed. */
+    workspaceName: string | null;
+    /**
+     * The emulated workspace window's configured width. Note that this is a static property of the
+     * emulated workspace window, and does not change for the duration of the app.
+     */
+    windowWidth: WorkspaceWindow2Width;
+    /** The title of the currently-rendered (leaf) workspace, or `''` when all workspaces are closed. */
+    title: string;
+    /** The `hasUnsavedChanges` of every workspace in the window, OR'd together. */
+    hasUnsavedChanges: boolean;
+}
+export interface ExportedWorkspaceProps {
+    /**
+     * The name of the workspace to open. Changing it (like changing `workspaceProps`, `windowProps` or
+     * `groupProps`) discards the current workspaces, without prompting for unsaved changes, and opens
+     * `name` afresh. To force a fresh instance without changing any of these, change the React `key`.
+     */
+    name: string;
+    /**
+     * The props passed into the workspace. Changing these (compared shallowly), or `windowProps` /
+     * `groupProps`, discards the current workspaces and opens `name` afresh with the new props.
+     */
+    workspaceProps: Record<string, any>;
+    windowProps?: Record<string, any>;
+    groupProps?: Record<string, any>;
+    /** Callback fired when the emulated window's state changes. */
+    onWindowChanged?(info: ExportedWorkspaceWindowInfo): void;
+}
+/**
+ * Renders the content of a registered workspace (the `children` of its `<Workspace2>`) within its own
+ * DOM subtree, independent of the real global workspace window system. It emulates the workspace
+ * window that contains `name`: opening/closing child workspaces (via `launchChildWorkspace()` /
+ * `closeWorkspace()` from within the workspace) navigates within this component, in a window held in
+ * its own local store. It renders no chrome (no title bar, maximize, hide, close, or icon); callers can
+ * render their own around it.
+ */
+export declare const ExportedWorkspace: React.FC<ExportedWorkspaceProps>;
+//# sourceMappingURL=exported-workspace.component.d.ts.map

package/dist/workspaces2/exported-workspace.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exported-workspace.component.d.ts","sourceRoot":"","sources":["../../src/workspaces2/exported-workspace.component.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAE1D,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AASlE,MAAM,WAAW,2BAA2B;IAC1C,qGAAqG;IACrG,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,WAAW,EAAE,qBAAqB,CAAC;IACnC,oGAAoG;IACpG,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC,+DAA+D;IAC/D,eAAe,CAAC,CAAC,IAAI,EAAE,2BAA2B,GAAG,IAAI,CAAC;CAC3D;AAOD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAiF9D,CAAC"}

package/dist/workspaces2/exported-workspace.component.js

@@ -0,0 +1,110 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { useEffect, useMemo, useRef } from "react";
+import { workspace2Store } from "@openmrs/esm-extensions";
+import { useStore } from "@openmrs/esm-react-utils";
+import { createLocalStore } from "@openmrs/esm-state";
+import { shallowEqual } from "@openmrs/esm-utils";
+import ActiveWorkspaceWindow from "./active-workspace-window.component.js";
+import { createExportedWorkspaceWindow } from "./workspace2.js";
+import { createLocalWindowActions } from "./workspace-window-actions.js";
+import styles from "./exported-workspace.module.scss";
+// module-level so the store subscription's snapshot getter stays stable across renders
+const selectRegisteredWorkspacesByName = (state)=>state.registeredWorkspacesByName;
+/**
+ * Renders the content of a registered workspace (the `children` of its `<Workspace2>`) within its own
+ * DOM subtree, independent of the real global workspace window system. It emulates the workspace
+ * window that contains `name`: opening/closing child workspaces (via `launchChildWorkspace()` /
+ * `closeWorkspace()` from within the workspace) navigates within this component, in a window held in
+ * its own local store. It renders no chrome (no title bar, maximize, hide, close, or icon); callers can
+ * render their own around it.
+ */ export const ExportedWorkspace = ({ name, workspaceProps, windowProps, groupProps, onWindowChanged })=>{
+    // Reactive so the seed effect below retries when `name` registers after this component mounts.
+    const registeredWorkspacesByName = useStore(workspace2Store, selectRegisteredWorkspacesByName);
+    const windowDef = useStore(workspace2Store, (state)=>{
+        const windowName = state.registeredWorkspacesByName[name]?.window;
+        return windowName ? state.registeredWindowsByName[windowName] : undefined;
+    });
+    const seedInputs = {
+        name,
+        workspaceProps,
+        windowProps,
+        groupProps
+    };
+    const storeRef = useRef();
+    // The inputs this instance has already seeded, so we re-seed when the caller changes any of them,
+    // but do NOT clobber the user's own navigation/close of the current one.
+    const seededInputsRef = useRef(null);
+    if (!storeRef.current) {
+        const openedWindow = createExportedWorkspaceWindow(name, workspaceProps, windowProps);
+        storeRef.current = createLocalStore({
+            openedWindow,
+            groupProps: groupProps ?? null
+        });
+        if (openedWindow) {
+            seededInputsRef.current = seedInputs;
+        }
+    }
+    const store = storeRef.current;
+    useEffect(()=>{
+        const seeded = seededInputsRef.current;
+        // Props are compared shallowly so that callers passing inline object literals do not re-seed on
+        // every render.
+        if (seeded && seeded.name === name && shallowEqual(seeded.workspaceProps, workspaceProps) && shallowEqual(seeded.windowProps, windowProps) && shallowEqual(seeded.groupProps, groupProps)) {
+            // Already seeded these inputs; leave the user's navigation/close alone.
+            return;
+        }
+        // When `name` is not registered yet, this shows nothing and leaves the inputs unmarked, so we seed
+        // once it registers. Changes to props resets the state (like navigation) and bypassed the unsaved-changes prompt
+        const openedWindow = createExportedWorkspaceWindow(name, workspaceProps, windowProps);
+        store.setState({
+            openedWindow,
+            groupProps: groupProps ?? null
+        }, true);
+        // Clear the inputs when nothing was seeded, so switching back to previously seeded inputs re-seeds.
+        seededInputsRef.current = openedWindow ? seedInputs : null;
+    }, [
+        name,
+        workspaceProps,
+        windowProps,
+        groupProps,
+        registeredWorkspacesByName,
+        store
+    ]);
+    const actions = useMemo(()=>createLocalWindowActions(store), [
+        store
+    ]);
+    const { openedWindow, groupProps: openedGroupProps } = useStore(store);
+    const leaf = openedWindow?.openedWorkspaces[openedWindow.openedWorkspaces.length - 1];
+    const workspaceName = leaf?.workspaceName ?? null;
+    const title = leaf?.title ?? '';
+    const hasUnsavedChanges = openedWindow?.openedWorkspaces.some((w)=>w.hasUnsavedChanges) ?? false;
+    const windowWidth = windowDef?.width ?? 'narrow';
+    // Hold the callback in a ref so an inline-arrow identity does not retrigger the notify effect.
+    const onWindowChangedRef = useRef(onWindowChanged);
+    useEffect(()=>{
+        onWindowChangedRef.current = onWindowChanged;
+    });
+    useEffect(()=>{
+        onWindowChangedRef.current?.({
+            workspaceName,
+            windowWidth,
+            title,
+            hasUnsavedChanges
+        });
+    }, [
+        workspaceName,
+        windowWidth,
+        title,
+        hasUnsavedChanges
+    ]);
+    return /*#__PURE__*/ _jsx("div", {
+        className: styles.exportedWorkspace,
+        children: openedWindow ? /*#__PURE__*/ _jsx(ActiveWorkspaceWindow, {
+            openedWindow: openedWindow,
+            groupProps: openedGroupProps,
+            actions: actions,
+            renderChrome: false,
+            showActionMenu: false
+        }) : null
+    });
+};

package/dist/workspaces2/exported-workspace.module.scss

@@ -0,0 +1,8 @@
+// The <ExportedWorkspace> renders only the workspace content (no chrome). It fills its parent as a
+// flex column so that the workspace content (which uses flex-grow / height: 100%) is sized correctly.
+// The caller is responsible for sizing the parent and rendering any title / close controls it wants.
+.exportedWorkspace {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+}

package/dist/workspaces2/index.d.ts

@@ -1,4 +1,5 @@
 export * from './workspace2.component';
 export * from './workspace2';
+export * from './exported-workspace.component';
 export * from './action-menu2/action-menu-button2.component';
 //# sourceMappingURL=index.d.ts.map

package/dist/workspaces2/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspaces2/index.tsx"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,8CAA8C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspaces2/index.tsx"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8CAA8C,CAAC"}

package/dist/workspaces2/index.js

@@ -1,3 +1,4 @@
 export * from "./workspace2.component.js";
 export * from "./workspace2.js";
+export * from "./exported-workspace.component.js";
 export * from "./action-menu2/action-menu-button2.component.js";

package/dist/workspaces2/workspace-window-actions.d.ts

@@ -0,0 +1,36 @@
+import { type OpenedWindow } from '@openmrs/esm-extensions';
+import { type StoreApi } from '@openmrs/esm-state';
+/**
+ * The operations the workspace render components (`ActiveWorkspaceWindow` / `ActiveWorkspace`) perform
+ * on the one workspace window they render. There is an implementation for a window in the global
+ * workspace window system, and one for the window held in an `<ExportedWorkspace>`'s local store.
+ * Each implementation reads the current window from its own store at call time.
+ */
+export interface WorkspaceWindowActions {
+    /** Closes the named workspace, along with its children. */
+    closeWorkspace(workspaceName: string): void;
+    openChildWorkspace(parentWorkspaceName: string, childWorkspaceName: string, props: Record<string, any>): void;
+    setWorkspaceTitle(uuid: string, title: string): void;
+    setHasUnsavedChanges(uuid: string, hasUnsavedChanges: boolean): void;
+    /**
+     * Prompts for confirmation to close the workspaces with unsaved changes in the window: the whole
+     * window, or, if `upToWorkspaceName` is given, just that workspace and its children.
+     * @returns a Promise that resolves to true if the user confirmed, or there was nothing to confirm.
+     */
+    promptForClosingWorkspaces(upToWorkspaceName?: string): Promise<boolean>;
+}
+/** The state of an `<ExportedWorkspace>`'s local store. */
+export interface ExportedWorkspaceState {
+    /** `null` before the workspace registers, and after its root workspace is closed. */
+    openedWindow: OpenedWindow | null;
+    groupProps: Record<string, any> | null;
+}
+/**
+ * @param windowName The name of a window in the global workspace window system.
+ */
+export declare function createGlobalWindowActions(windowName: string): WorkspaceWindowActions;
+/**
+ * @param store The local store of an `<ExportedWorkspace>`.
+ */
+export declare function createLocalWindowActions(store: StoreApi<ExportedWorkspaceState>): WorkspaceWindowActions;
+//# sourceMappingURL=workspace-window-actions.d.ts.map

package/dist/workspaces2/workspace-window-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-window-actions.d.ts","sourceRoot":"","sources":["../../src/workspaces2/workspace-window-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AASnD;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,kBAAkB,CAAC,mBAAmB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC9G,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;IACrE;;;;OAIG;IACH,0BAA0B,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACrC,qFAAqF;IACrF,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAwBpF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,sBAAsB,CAmCxG"}