@servicenow/aiux 22.42.1 → 22.42.3

package/core/commons/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@servicenow/aiux-commons",
-  "version": "3.9.1",
+  "version": "3.9.3",
   "description": "AIUX Common Utilities",
   "type": "module",
   "main": "./index.js",

package/core/sdk/dist/build.browser.js

@@ -313318,6 +313318,17 @@ async function buildPages({
     }
   }
   const lifecycleBundle = applicationFile ? entryMap["application"] : null;
+  let lifecycleRequiredTranslations = [];
+  if (applicationFile) {
+    const { requiredTranslations: appTranslations } = analyzePageSource(applicationFile);
+    lifecycleRequiredTranslations = [...appTranslations];
+    if (lifecycleBundle) {
+      lifecycleRequiredTranslations = mergeRequiredTranslations([
+        lifecycleRequiredTranslations,
+        collectEntryOwnTranslations(lifecycleBundle, chunksByFileName)
+      ]);
+    }
+  }
   const serverDir = path_browser_shim_default.join(distDir, "server");
   if (IS_KARUNA_META_PACKAGE_MODE && fs_browser_shim_default.existsSync(serverDir)) {
     const codemod = rewriteDir(serverDir, fs_browser_shim_default);
@@ -313541,13 +313552,27 @@ async function buildPages({
     ...Object.keys(chunkRequiredTranslations).length > 0 ? { chunkRequiredTranslations } : {},
     ...appDefaultLayout ? { applicationLayout: appDefaultLayout } : {},
     ...lifecycleBundle ? { lifecycleBundle } : {},
+    ...lifecycleRequiredTranslations.length > 0 ? { lifecycleRequiredTranslations } : {},
     ...extLifecycleBundles.length > 0 ? {
-      extensionLifecycleBundles: extLifecycleBundles.map((e) => ({
-        scope: e.scope,
-        host: e.host,
-        ...e.experienceSysId ? { experienceSysId: e.experienceSysId } : {},
-        bundle: e.bundle
-      }))
+      extensionLifecycleBundles: extLifecycleBundles.map((e) => {
+        const { requiredTranslations: extTranslations } = analyzePageSource(
+          e.file
+        );
+        let extRequiredTranslations = [...extTranslations];
+        if (e.bundle) {
+          extRequiredTranslations = mergeRequiredTranslations([
+            extRequiredTranslations,
+            collectEntryOwnTranslations(e.bundle, chunksByFileName)
+          ]);
+        }
+        return {
+          scope: e.scope,
+          host: e.host,
+          ...e.experienceSysId ? { experienceSysId: e.experienceSysId } : {},
+          bundle: e.bundle,
+          ...extRequiredTranslations.length > 0 ? { requiredTranslations: extRequiredTranslations } : {}
+        };
+      })
     } : {},
     ...requiresCheckManifestPath ? { requiresCheck: requiresCheckManifestPath } : {},
     ...appRequirements || appFileRequirements ? {
@@ -315655,7 +315680,10 @@ async function buildLifecycleRecord({ distDir, manifest, shared }) {
       required_plugins: "[]",
       required_user_preferences: "[]",
       category: "internal",
-      purpose: "other"
+      purpose: "other",
+      required_translations: JSON.stringify(
+        manifest.lifecycleRequiredTranslations || []
+      )
     }
   });
   const chunks = extractChunkImports(component2);
@@ -315676,7 +315704,7 @@ async function buildLifecycleRecord({ distDir, manifest, shared }) {
   return { record, lifecycleBundle };
 }
 async function buildExtensionLifecycleRecord({ distDir, entry, shared }) {
-  const { bundle, scope, host, experienceSysId } = entry;
+  const { bundle, scope, host, experienceSysId, requiredTranslations } = entry;
   if (!bundle) return { record: null };
   const { component: component2, sourcemap } = readBundleAndSourcemap(distDir, bundle);
   const keySuffix = experienceSysId || `${scope}-${host}`;
@@ -315700,7 +315728,8 @@ async function buildExtensionLifecycleRecord({ distDir, entry, shared }) {
       required_plugins: "[]",
       required_user_preferences: "[]",
       category: "internal",
-      purpose: "other"
+      purpose: "other",
+      required_translations: JSON.stringify(requiredTranslations || [])
     }
   });
   const chunks = extractChunkImports(component2);

package/core/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@servicenow/aiux-sdk",
-  "version": "4.10.3",
+  "version": "4.10.5",
   "description": "Metadata discovery and transformation pipeline for AIUX widgets",
   "type": "module",
   "exports": {

package/core/sdk/src/build-metadata-records/lifecycle.js

@@ -59,7 +59,10 @@ export async function buildLifecycleRecord({distDir, manifest, shared}) {
       required_plugins: '[]',
       required_user_preferences: '[]',
       category: 'internal',
-      purpose: 'other'
+      purpose: 'other',
+      required_translations: JSON.stringify(
+        manifest.lifecycleRequiredTranslations || []
+      )
     }
   });
 
@@ -91,7 +94,7 @@ export async function buildLifecycleRecord({distDir, manifest, shared}) {
  * @returns {{record: object|null}}
  */
 export async function buildExtensionLifecycleRecord({distDir, entry, shared}) {
-  const {bundle, scope, host, experienceSysId} = entry;
+  const {bundle, scope, host, experienceSysId, requiredTranslations} = entry;
   if (!bundle) return {record: null};
 
   const {component, sourcemap} = readBundleAndSourcemap(distDir, bundle);
@@ -120,7 +123,8 @@ export async function buildExtensionLifecycleRecord({distDir, entry, shared}) {
       required_plugins: '[]',
       required_user_preferences: '[]',
       category: 'internal',
-      purpose: 'other'
+      purpose: 'other',
+      required_translations: JSON.stringify(requiredTranslations || [])
     }
   });
 

package/core/sdk/src/build-runtime-manifest/build.js

@@ -3113,6 +3113,22 @@ async function buildPages({
 
   const lifecycleBundle = applicationFile ? entryMap['application'] : null;
 
+  // Extract required translations from application.js
+  let lifecycleRequiredTranslations = [];
+  if (applicationFile) {
+    const {requiredTranslations: appTranslations} =
+      analyzePageSource(applicationFile);
+    lifecycleRequiredTranslations = [...appTranslations];
+
+    // Recover strings from components imported by only the lifecycle bundle
+    if (lifecycleBundle) {
+      lifecycleRequiredTranslations = mergeRequiredTranslations([
+        lifecycleRequiredTranslations,
+        collectEntryOwnTranslations(lifecycleBundle, chunksByFileName)
+      ]);
+    }
+  }
+
   // Karuna meta-package codemod: rewrite bare-specifier imports of
   // @servicenow/aiux-* in the compiled SSR output to @servicenow/karuna
   // subpath imports. This lets Node's standard ESM resolver locate
@@ -3478,14 +3494,38 @@ async function buildPages({
       : {}),
     ...(appDefaultLayout ? {applicationLayout: appDefaultLayout} : {}),
     ...(lifecycleBundle ? {lifecycleBundle} : {}),
+    ...(lifecycleRequiredTranslations.length > 0
+      ? {lifecycleRequiredTranslations}
+      : {}),
     ...(extLifecycleBundles.length > 0
       ? {
-          extensionLifecycleBundles: extLifecycleBundles.map(e => ({
-            scope: e.scope,
-            host: e.host,
-            ...(e.experienceSysId ? {experienceSysId: e.experienceSysId} : {}),
-            bundle: e.bundle
-          }))
+          extensionLifecycleBundles: extLifecycleBundles.map(e => {
+            // Extract translations from each extension lifecycle file
+            const {requiredTranslations: extTranslations} = analyzePageSource(
+              e.file
+            );
+            let extRequiredTranslations = [...extTranslations];
+
+            // Recover strings from components imported by only this extension lifecycle bundle
+            if (e.bundle) {
+              extRequiredTranslations = mergeRequiredTranslations([
+                extRequiredTranslations,
+                collectEntryOwnTranslations(e.bundle, chunksByFileName)
+              ]);
+            }
+
+            return {
+              scope: e.scope,
+              host: e.host,
+              ...(e.experienceSysId
+                ? {experienceSysId: e.experienceSysId}
+                : {}),
+              bundle: e.bundle,
+              ...(extRequiredTranslations.length > 0
+                ? {requiredTranslations: extRequiredTranslations}
+                : {})
+            };
+          })
         }
       : {}),
     ...(requiresCheckManifestPath

package/libraries/aiux-devtools/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@servicenow/aiux-devtools",
-  "version": "1.12.1",
+  "version": "1.12.2",
   "description": "Runtime devtools for AIUX Lit-based widgets — inspect widget trees, properties, lifecycle timing, events, console output, and network requests",
   "type": "module",
   "main": "./src/index.js",

package/libraries/aiux-devtools/src/index.js

@@ -166,7 +166,11 @@ export async function openPictureInPictureWindow() {
   try {
     pipWin = await window.documentPictureInPicture.requestWindow({
       width: 1200,
-      height: 700
+      height: 700,
+      // "back to tab" and close fire the identical pagehide event, so we
+      // can't treat them differently — hide it, leaving one unambiguous
+      // close; the in-panel dock dropdown is what redocks instead.
+      disallowReturnToOpener: true
     });
   } catch (err) {
     // Rejected (no transient activation, blocked by Permissions Policy, or
@@ -234,6 +238,11 @@ export async function openPictureInPictureWindow() {
     return null;
   }
 
+  // Remember that PiP is the last-used surface, so an inspect-widget request
+  // (or re-open) after the PiP window is closed restores PiP rather than
+  // falling back to the docked panel.
+  preferences.set({detached: true});
+
   // Suppress the in-page overlay while the PiP window owns the panel.
   overlayManager.setDetachedActive(true);
   overlayManager.hide();
@@ -246,14 +255,26 @@ export async function openPictureInPictureWindow() {
 }
 
 /**
- * Restore the in-page panel after the PiP window closes. The host panel never
- * left the page, so we just clear detached state and re-show the overlay.
+ * Handle the PiP window closing. Closes devtools by default; re-shows the
+ * in-page panel only when overlayManager.markRedockPending() was set first
+ * (the dock dropdown's position picks) — see the comment below.
  */
 function _redockFromPip() {
   _pipWindowRef = null;
   _pipPageHideHandler = null;
   detachedHostApi.uninstall();
   overlayManager.setDetachedActive(false);
+
+  // Default: any popup close fully closes devtools. Exception: picking a
+  // dock position marks redockPending before calling window.close(), so
+  // the panel returns docked instead of staying hidden.
+  //
+  // Closing the PiP window (no redock) leaves the `detached` preference set,
+  // so a subsequent inspect-widget request reopens in PiP. Only an explicit
+  // redock to a dock position switches the remembered surface back to docked.
+  if (!overlayManager.consumeRedockPending()) return;
+
+  preferences.set({detached: false});
   overlayManager.show();
   // Safety net in case the overlay state callback was lost.
   if (_panelElement) {
@@ -288,6 +309,11 @@ function _destroy() {
     if (!_pipWindowRef.closed) _pipWindowRef.close();
     _pipWindowRef = null;
     overlayManager.setDetachedActive(false);
+    // The pagehide listener above is what normally consumes redockPending
+    // (set by picking a dock position inside PiP, just before this teardown
+    // raced ahead of it) — clear it here too, or it would wrongly redock a
+    // later, unrelated PiP session's close.
+    overlayManager.consumeRedockPending();
   }
   overlayManager.hide();
   // Unmount panel first — triggers disconnectedCallback so panels
@@ -331,6 +357,25 @@ function _destroy() {
   shared.initialized = false;
 }
 
+/**
+ * Open devtools for an inspect-widget request on the last-used surface.
+ *
+ * If devtools was last shown in a Picture-in-Picture window (the `detached`
+ * preference) and the browser supports PiP, reopen in PiP; otherwise show the
+ * docked panel. Must be called from a user-gesture call stack for the PiP
+ * branch to satisfy Document PiP's transient-activation requirement.
+ *
+ * @param {string} widgetId
+ */
+function _openInspectSurface(widgetId) {
+  sessionManager.setActiveWidget(widgetId);
+  if (preferences.get().detached && 'documentPictureInPicture' in window) {
+    openPictureInPictureWindow();
+  } else {
+    overlayManager.show();
+  }
+}
+
 /** @type {HTMLElement|null} Active context menu element */
 let _contextMenuEl = null;
 
@@ -407,8 +452,7 @@ function _showContextMenu(x, y, widgetId) {
   });
   item.addEventListener('click', () => {
     _dismissContextMenu();
-    sessionManager.setActiveWidget(widgetId);
-    overlayManager.show();
+    _openInspectSurface(widgetId);
   });
 
   menu.appendChild(item);
@@ -633,6 +677,12 @@ export {registerAdapter, getAdapterFor};
 export {toggleDevtools};
 export {openPictureInPictureWindow as openPip};
 
+/**
+ * Test-only internals. Not part of the public API.
+ * @see CLAUDE.md — "Reach internals through the `_testOnly` export".
+ */
+export const _testOnly = {openInspectSurface: _openInspectSurface};
+
 // Auto-initialize when loaded in the browser.
 // The full bundle is an ES module loaded by the bootstrap script.
 if (typeof window !== 'undefined' && !getShared().initialized) {

package/libraries/aiux-devtools/src/store/preferences.js

@@ -106,6 +106,7 @@ export const EXTENDED_EVENT_TYPES = Object.freeze(
  * @property {'dark'|'light'} theme - UI theme preference
  * @property {'bottom'|'top'|'left'|'right'} dockPosition - Devtools panel dock position
  * @property {boolean} panelVisible - Whether the devtools panel was open
+ * @property {boolean} detached - Whether devtools was last shown in a Picture-in-Picture window (so inspect/re-open restores that surface)
  * @property {boolean} timelineRecording - @deprecated Unified into `recording`. Kept for backward compat.
  * @property {string|null} activeTab - Last selected primary tab
  * @property {string|null} activeSubTab - Last selected inspector sub-tab
@@ -122,6 +123,7 @@ const DEFAULTS = {
   dockPosition: 'bottom',
   timelineRecording: false, // deprecated — unified into `recording`
   panelVisible: false,
+  detached: false,
   activeTab: null,
   activeSubTab: null
 };

package/libraries/aiux-devtools/src/ui/shell/devtools-panel.js

@@ -1106,8 +1106,10 @@ export class DevtoolsPanel extends LitElement {
   }
 
   /**
-   * Dock back from detached mode — close the popup/PiP window.
-   * The main page's close-detection (or pagehide handler) re-shows the overlay.
+   * Close the popup/PiP window. By itself this fully closes devtools (the
+   * host's pagehide handler in index.js) — callers that want to redock
+   * instead must call overlayManager.markRedockPending() first (see the
+   * dock-position click handler in _renderDockBtn).
    */
   _onDockBack() {
     window.close();
@@ -1424,6 +1426,15 @@ export class DevtoolsPanel extends LitElement {
     right: svg`<rect x="9.5" y="1.5" width="5" height="11" rx="0.75" fill="currentColor" opacity="0.85"/>`
   };
 
+  /**
+   * Pip icon — Chrome's "undock into separate window" glyph: two overlapping
+   * windows. The front window is a full outline; the back window is drawn as
+   * an open path (top/right/partial-bottom edges only) so it tucks behind the
+   * front without needing a background-colored mask — keeping it correct on
+   * hover and across light/dark themes.
+   */
+  static _pipIcon = svg`<path d="M5.8,4.2 L5.8,3 Q5.8,1.8 7,1.8 L13,1.8 Q14.2,1.8 14.2,3 L14.2,8.6 Q14.2,9.8 13,9.8 L10.2,9.8" stroke="currentColor" stroke-width="1.2" fill="none" stroke-linejoin="round" stroke-linecap="round"/><rect x="1.8" y="4.2" width="8.4" height="8" rx="1.3" stroke="currentColor" stroke-width="1.2" fill="none"/>`;
+
   /** Close the dock overflow menu and remove outside-click listener. */
   _closeDockMenu() {
     if (!this._dockMenuOpen) return;
@@ -1467,42 +1478,85 @@ export class DevtoolsPanel extends LitElement {
 
   _renderDockBtn(position, activeDock) {
     const labels = {bottom: 'bottom', top: 'top', left: 'left', right: 'right'};
+    const isPip = position === 'pip';
     return html`
       <button
         class="dock-btn ${activeDock === position ? 'active' : ''}"
         @click=${() => {
-          overlayManager.setDockPosition(position);
+          if (isPip) {
+            // Already in PiP when this is the current-state indicator.
+            if (this.mode !== 'detached') this._onPopOut();
+          } else {
+            overlayManager.setDockPosition(position);
+            // Redock (not full close) when picking a position from PiP.
+            if (this.mode === 'detached') {
+              overlayManager.markRedockPending();
+              this._onDockBack();
+            }
+          }
           this._closeDockMenu();
         }}
-        title="Dock to ${labels[position]}"
-        aria-label="Dock to ${labels[position]}"
-        role="radio"
-        aria-checked=${activeDock === position ? 'true' : 'false'}
+        title=${isPip
+          ? this.mode === 'detached'
+            ? 'Currently in Picture-in-Picture'
+            : 'Undock into separate window'
+          : `Dock to ${labels[position]}`}
+        aria-label=${isPip
+          ? this.mode === 'detached'
+            ? 'Currently in Picture-in-Picture'
+            : 'Open devtools in a Picture-in-Picture window'
+          : `Dock to ${labels[position]}`}
+        role=${isPip ? 'menuitem' : 'radio'}
+        aria-checked=${isPip
+          ? nothing
+          : activeDock === position
+            ? 'true'
+            : 'false'}
       >
         <svg viewBox="0 0 16 14" fill="none">
-          <rect
-            x="1"
-            y="1"
-            width="14"
-            height="12"
-            rx="1.5"
-            stroke="currentColor"
-            stroke-width="1.2"
-          />
-          ${DevtoolsPanel._dockFills[position]}
+          ${isPip
+            ? DevtoolsPanel._pipIcon
+            : svg`
+                <rect
+                  x="1"
+                  y="1"
+                  width="14"
+                  height="12"
+                  rx="1.5"
+                  stroke="currentColor"
+                  stroke-width="1.2"
+                />
+                ${DevtoolsPanel._dockFills[position]}
+              `}
         </svg>
       </button>
     `;
   }
 
   /**
-   * Render dock toggle — always compact: active icon + dropdown.
+   * Render dock toggle — active icon + dropdown. Pip is a non-radio option
+   * in the same dropdown. While detached, the indicator shows Pip (not the
+   * stale dock position) and the dropdown offers the dock positions instead.
+   * Menu order is fixed: undock (PiP), left, bottom, right, top.
    */
   _renderDockToggle(dock) {
-    const others = ['bottom', 'top', 'left', 'right'].filter(p => p !== dock);
+    const isDetached = this.mode === 'detached';
+    const current = isDetached ? 'pip' : dock;
+    // Canonical dropdown order: undock (PiP) first, then left/bottom/right,
+    // with top last. Pip is only offered when supported and not already
+    // detached; the current surface is shown as the indicator, not repeated
+    // in the menu.
+    const showPip = this._pipSupported && !isDetached;
+    const others = ['pip', 'left', 'bottom', 'right', 'top'].filter(
+      p => p !== current && (p !== 'pip' || showPip)
+    );
     return html`
-      <div class="dock-toggle" role="radiogroup" aria-label="Dock position">
-        ${this._renderDockBtn(dock, dock)}
+      <div
+        class="dock-toggle"
+        role=${isDetached ? nothing : 'radiogroup'}
+        aria-label="Dock position"
+      >
+        ${this._renderDockBtn(current, current)}
         <div class="dock-more">
           <button
             class="dock-btn"
@@ -1521,7 +1575,7 @@ export class DevtoolsPanel extends LitElement {
           ${this._dockMenuOpen
             ? html`
                 <div class="dock-menu">
-                  ${others.map(p => this._renderDockBtn(p, dock))}
+                  ${others.map(p => this._renderDockBtn(p, current))}
                 </div>
               `
             : nothing}
@@ -1606,6 +1660,10 @@ export class DevtoolsPanel extends LitElement {
                 Export
               </button>
 
+              <span class="toolbar-separator"></span>
+
+              ${this._renderDockToggle(dock)}
+
               <button
                 class="theme-btn"
                 @click=${this._onToggleTheme}
@@ -1618,15 +1676,6 @@ export class DevtoolsPanel extends LitElement {
               >
                 ${this.theme === 'dark' ? '🌙' : '☀️'}
               </button>
-
-              <button
-                class="toolbar-btn"
-                @click=${this._onDockBack}
-                title="Dock back into page"
-                aria-label="Dock back into page"
-              >
-                ${svg`<svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="2" width="12" height="12" rx="1.5"/><path d="M8 5v6M5 8h6"/></svg>`}
-              </button>
             </div>
             <div class="inspector-layout">
               ${this._primaryTab === 'inspector'
@@ -1738,18 +1787,6 @@ export class DevtoolsPanel extends LitElement {
             <span class="tab-spacer"></span>
             <span class="toolbar-separator"></span>
 
-            ${this._pipSupported
-              ? html`
-                  <button
-                    class="toolbar-btn"
-                    @click=${this._onPopOut}
-                    title="Open in a Picture-in-Picture window"
-                    aria-label="Open devtools in a Picture-in-Picture window"
-                  >
-                    ${svg`<svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M9 2h5v5"/><path d="M14 2L7 9"/><path d="M12 9v4.5a.5.5 0 01-.5.5h-9a.5.5 0 01-.5-.5v-9a.5.5 0 01.5-.5H7"/></svg>`}
-                  </button>
-                `
-              : nothing}
             <button
               class="record-btn ${this._globalRecording ? 'recording' : ''}"
               @click=${this._onToggleGlobalRecording}

package/libraries/aiux-devtools/src/ui/shell/overlay-manager.js

@@ -15,7 +15,13 @@ import * as preferences from '../../store/preferences.js';
 
 const _o = getShared().overlay;
 
-// Restore persisted state from preferences
+/** @type {Set<(state: object) => void>} */
+const _stateCallbacks = _o.stateCallbacks;
+
+// Restore persisted state. Uses show() rather than a raw `_o.visible = true`
+// — this module can be re-evaluated mid-session (e.g. by a bundler), and a
+// raw write would silently clobber an in-progress PiP session. Must run
+// after _stateCallbacks above: show() -> _notifyState() reads it.
 try {
   const saved = preferences.get();
   if (
@@ -25,7 +31,7 @@ try {
     _o.dockPosition = saved.dockPosition;
   }
   if (saved.panelVisible) {
-    _o.visible = true;
+    show();
   }
 } catch {
   /* preferences may not be available yet */
@@ -37,9 +43,6 @@ const MIN_SIZE = 150;
 /** @type {number} Max panel size (fraction of viewport) */
 const MAX_SIZE_FRACTION = 0.7;
 
-/** @type {Set<(state: object) => void>} */
-const _stateCallbacks = _o.stateCallbacks;
-
 function _notifyState() {
   const state = getState();
   // Snapshot the Set — a callback may unsubscribe (delete from the Set)
@@ -71,7 +74,10 @@ export function getState() {
 export function toggle() {
   if (_o.detachedActive) return;
   _o.visible = !_o.visible;
-  preferences.set({panelVisible: _o.visible});
+  // Interacting with the docked panel makes it the last-used surface, so
+  // clear the detached (Picture-in-Picture) preference — a later inspect
+  // should reopen docked, not in PiP.
+  preferences.set({panelVisible: _o.visible, detached: false});
   _notifyState();
 }
 
@@ -82,7 +88,9 @@ export function show() {
   if (_o.detachedActive) return;
   if (!_o.visible) {
     _o.visible = true;
-    preferences.set({panelVisible: true});
+    // Showing the docked panel makes it the last-used surface — clear the
+    // detached (PiP) preference so a later inspect reopens docked.
+    preferences.set({panelVisible: true, detached: false});
     _notifyState();
   }
 }
@@ -170,6 +178,25 @@ export function onStateChange(callback) {
   return () => _stateCallbacks.delete(callback);
 }
 
+/**
+ * Mark that the PiP popup is closing to redock at a picked dock position,
+ * not to close devtools outright. Consumed once by `index.js`'s pagehide
+ * handler, which otherwise treats any popup close as closing devtools.
+ */
+export function markRedockPending() {
+  _o.redockPending = true;
+}
+
+/**
+ * Read and clear the redock-pending flag.
+ * @returns {boolean} Whether the popup close should redock vs. fully close.
+ */
+export function consumeRedockPending() {
+  const pending = !!_o.redockPending;
+  _o.redockPending = false;
+  return pending;
+}
+
 /**
  * Reset state. Used for teardown/testing.
  */
@@ -179,5 +206,6 @@ export function reset() {
   _o.panelWidth = 420;
   _o.dockPosition = 'bottom';
   _o.detachedActive = false;
+  _o.redockPending = false;
   _stateCallbacks.clear();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@servicenow/aiux",
-  "version": "22.42.1",
+  "version": "22.42.3",
   "description": "Public dev server for AINPX applications — SSR, HMR, and AIEL/chat support",
   "type": "module",
   "keywords": [

package/public-dev-server/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@servicenow/aiux-public-dev-server",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Single-process, main-thread local dev server for AIUX apps. Self-contained: no proprietary server internals. Local dev tool, not the production runtime.",
   "type": "module",
   "main": "./index.js",