@shopify/ui-extensions-tester 2026.4.0-rc.2 → 2026.4.0

package/README.md

@@ -14,6 +14,7 @@ This testing library provides strongly typed mocks of the extension API--like th
 ## 📋 Recommendations
 
 - **TypeScript** — we recommend TypeScript to enforce API compliance against mock objects
+- **Node.js ≥ 22.0.0** and **TypeScript ≥ 5.2** — to use ([Explicit Resource Management](https://github.com/tc39/proposal-explicit-resource-management))
 - **@testing-library/preact** — if your extension uses [Preact](https://preactjs.com/), we recommend installing [`@testing-library/preact`](https://preactjs.com/guide/v10/preact-testing-library/) for its `fireEvent` and `waitFor` helpers
 
 ## 📦 Installation
@@ -72,7 +73,7 @@ Your extension's own `package.json` (inside `extensions/my-extension/`) already
   "devDependencies": {
     "@shopify/ui-extensions-tester": "latest",
     "@testing-library/preact": "^3.2.0",
-    "typescript": "^5.0.0",
+    "typescript": "^5.2.0",
     "vitest": "^3.0.0"
   }
 }
@@ -144,7 +145,34 @@ The path must match the target you pass to `getExtension()`.
 
 ## 🏊‍♀️ Getting started
 
-Every test file follows the same pattern: create an extension harness, call `extension.setUp()` before each test, call `extension.tearDown()` after.
+Every test file follows the same pattern:
+create an extension harness, set it up before
+each test, and tear it down after.
+
+### Quick start with `using` (Node ≥ 22.0.0)
+
+If your runtime supports
+[Explicit Resource Management](https://github.com/tc39/proposal-explicit-resource-management),
+use `setUpExtension` for zero-boilerplate
+setup and automatic teardown:
+
+```ts
+import {setUpExtension} from '@shopify/ui-extensions-tester';
+
+test('rendering the extension', async () => {
+  using extension = setUpExtension(
+    'purchase.checkout.block.render',
+  );
+  await extension.render();
+  // tearDown() is called automatically at the end of the block
+});
+```
+
+### Classic setup
+
+Alternatively, create the harness once and
+manage the lifecycle with `beforeEach` /
+`afterEach`:
 
 ```ts
 import {getExtension} from '@shopify/ui-extensions-tester';
@@ -339,25 +367,31 @@ Each surface exports some helpers:
 
 Exports from `@shopify/ui-extensions-tester`:
 
-### `getExtension(target, options?)`
+### `setUpExtension(target, options?)`
+
+Sets up an extension for testing and returns a
+disposable object that supports automatic
+teardown with the `using` keyword:
+
+```ts
+test('example', async () => {
+  using extension = setUpExtension(
+    'purchase.checkout.block.render',
+  );
+  await extension.render();
+  // tearDown() called automatically
+});
+```
 
-Returns an extension test harness for the given target. It reads `shopify.extension.toml`, finds the module for the given target, and provides helpers to mock the environment and render the extension. It locates `shopify.extension.toml` by walking up from the calling test file's directory, and falls back to searching `extensions/` under the current working directory.
+It reads `shopify.extension.toml`, finds the module for the given target, and provides helpers to mock the environment and render the extension. It locates `shopify.extension.toml` by walking up from the calling test file's directory, and falls back to searching `extensions/` under the current working directory. Results are cached: calling `getExtension` twice with the same target and the same resolved TOML returns the same instance.
 
 | Option            | Type     | Default                       | Description                                                |
 | ----------------- | -------- | ----------------------------- | ---------------------------------------------------------- |
 | `configSearchDir` | `string` | calling test file's directory | Directory to start searching for `shopify.extension.toml`. |
 
-By default `getExtension` walks up from the test file's directory to find `shopify.extension.toml`.
+By default, it walks up from the test file's directory to find `shopify.extension.toml`.
 
-**Returns** an `Extension<T>` object with the following members:
-
-#### `extension.setUp()`
-
-Sets up an extension environment for testing. Creates a mock `shopify` global with some defaults.
-
-#### `extension.tearDown()`
-
-Tears down the extension environment. Resets the `shopify` global and clears `document.body`.
+**Returns** an `Extension` object with the following members:
 
 #### `extension.render()`
 
@@ -367,6 +401,8 @@ Imports and executes the extension module's default export, rendering the extens
 
 A mock `shopify` global, typed correctly for the target under test. You can mutate any property.
 
+When testing `admin.app.intent.render`, the mock `shopify.intents` object also includes `response.ok()`, `response.error()`, and `response.closed()`.
+
 #### `extension.fetch`
 
 A mock `fetch()` function installed as `globalThis.fetch` during `setUp()` and removed during `tearDown()`.
@@ -402,6 +438,22 @@ extension.navigation.currentEntry =
 
 Assigning to `extension.navigation` also updates `globalThis.navigation`, so extension code that calls `navigation.navigate()` directly will use the mock.
 
+### `getExtension(target, options?)`
+
+> ⚠️ Prefer [`setUpExtension`](#setupextensiontarget-options) on Node ≥ 22.0.0. Use `getExtension` only if your runtime does not support [Explicit Resource Management](https://github.com/tc39/proposal-explicit-resource-management).
+
+Accepts the same arguments as `setUpExtension`. You must call `extension.setUp()` and `extension.tearDown()` explicitly.
+
+**Returns** an `Extension` object with the following additional members:
+
+#### `extension.setUp()`
+
+Sets up an extension environment for testing. Creates a mock `shopify` global with some defaults.
+
+#### `extension.tearDown()`
+
+Tears down the extension environment. Resets the `shopify` global and clears `document.body`.
+
 ### `createNavigationHistoryEntry(options?)`
 
 Creates a [`NavigationHistoryEntry`](https://developer.mozilla.org/en-US/docs/Web/API/NavigationHistoryEntry) for mocking `navigation.currentEntry` or other navigation values.

package/build/cjs/_virtual/_rollupPluginBabelHelpers.js

@@ -0,0 +1,15 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+function _classPrivateFieldLooseBase(e, t) {
+  if (!{}.hasOwnProperty.call(e, t)) throw new TypeError("attempted to use private field on non-instance");
+  return e;
+}
+var id = 0;
+function _classPrivateFieldLooseKey(e) {
+  return "__private_" + id++ + "_" + e;
+}
+
+exports.classPrivateFieldLooseBase = _classPrivateFieldLooseBase;
+exports.classPrivateFieldLooseKey = _classPrivateFieldLooseKey;

package/build/cjs/admin/factories.js

@@ -38,6 +38,13 @@ function createConfigApp() {
     applicationUrl: 'https://mock-app.test'
   };
 }
+function createIntentResponseApi() {
+  return {
+    ok: async () => {},
+    error: async () => {},
+    closed: async () => {}
+  };
+}
 function createMockStandardApi(target) {
   return {
     extension: {
@@ -70,6 +77,15 @@ function createMockStandardRenderingApi(target) {
     })
   };
 }
+function createAppIntentRenderMock(target) {
+  return {
+    ...createMockStandardRenderingApi(target),
+    intents: {
+      ...createMockStandardApi(target).intents,
+      response: createIntentResponseApi()
+    }
+  };
+}
 function createMockBlockApi(target) {
   return {
     ...createMockStandardRenderingApi(target),
@@ -214,6 +230,8 @@ const adminMockFactories = {
   // Runnable targets
   'admin.customers.segmentation-templates.data': createCustomerSegmentTemplateMock,
   'admin.app.tools.data': createMockStandardApi,
+  // App render targets
+  'admin.app.intent.render': createAppIntentRenderMock,
   // Block targets
   'admin.product-details.block.render': createMockBlockApi,
   'admin.order-details.block.render': createMockBlockApi,

package/build/cjs/api-version.js

@@ -5,14 +5,14 @@ Object.defineProperty(exports, '__esModule', { value: true });
 /**
  * The API version supported by this version of the library.
  *
- * At build time, `"2026.4.0-rc.2"` is replaced by rollup with the
+ * At build time, `"2026.4.0"` is replaced by rollup with the
  * raw NPM version string from package.json (e.g. `"2026.4.0-rc.1"`).
  *
  * When running from source (e.g. in tests), the placeholder is still
  * present, so we fall back to reading package.json via require.
  */
 
-const npmVersion = "2026.4.0-rc.2";
+const npmVersion = "2026.4.0";
 function npmVersionToApiVersion(version) {
   const [year, minor] = version.split('.');
   return `${year}-${minor.padStart(2, '0')}`;

package/build/cjs/checkout/factories.js

@@ -115,11 +115,6 @@ function createMockStandardApi(target) {
     }),
     selectedPaymentOptions: signals.createSubscribableSignalLike([]),
     settings: signals.createSubscribableSignalLike({}),
-    ui: {
-      overlay: {
-        close: () => {}
-      }
-    },
     version: '0.0.0',
     customerPrivacy: signals.createSubscribableSignalLike({
       allowedProcessing: {

package/build/cjs/index.js

@@ -2,6 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var _rollupPluginBabelHelpers = require('./_virtual/_rollupPluginBabelHelpers.js');
 var fs = require('fs');
 var path = require('path');
 var targets = require('./targets.js');
@@ -31,6 +32,8 @@ function _interopNamespace(e) {
 var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
 var path__namespace = /*#__PURE__*/_interopNamespace(path);
 
+var _dispose;
+
 /**
  * Makes all properties in the API deeply mutable so tests can
  * override any value through the `extension.shopify` proxy:
@@ -39,6 +42,168 @@ var path__namespace = /*#__PURE__*/_interopNamespace(path);
  *   extension.shopify.i18n.translate = (key) => myTranslations[key];
  */
 
+/**
+ * `Symbol.dispose` for runtimes that support it, with a polyfill
+ * fallback so the library works on older Node versions too.
+ */
+const SymbolDispose = (_dispose = Symbol.dispose) !== null && _dispose !== void 0 ? _dispose : Symbol.for('Symbol.dispose');
+
+/**
+ * Members shared by both {@link ExtensionHarness} (returned by
+ * `getExtension`) and {@link DisposableExtensionHarness} (returned
+ * by `setUpExtension`).
+ */
+
+/**
+ * Returned by `getExtension`.  The caller is responsible for calling
+ * `setUp()` before each test and `tearDown()` after.
+ */
+
+/**
+ * Returned by `setUpExtension`.  Already set up — tears down
+ * automatically via `Symbol.dispose` (the `using` keyword):
+ *
+ * ```ts
+ * using extension = setUpExtension('purchase.checkout.block.render');
+ * ```
+ */
+var _target = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("target");
+var _resolvedModule = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("resolvedModule");
+var _modulePath = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("modulePath");
+var _checkout = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("checkout");
+var _networkAccess = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("networkAccess");
+var _apiAccess = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("apiAccess");
+var _fetchImpl = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("fetchImpl");
+var _previousFetch = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("previousFetch");
+var _navigationImpl = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("navigationImpl");
+var _previousNavigation = /*#__PURE__*/_rollupPluginBabelHelpers.classPrivateFieldLooseKey("previousNavigation");
+class Extension {
+  constructor(target, options) {
+    var _options$configSearch;
+    Object.defineProperty(this, _target, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _resolvedModule, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _modulePath, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _checkout, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _networkAccess, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _apiAccess, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _fetchImpl, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _previousFetch, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _navigationImpl, {
+      writable: true,
+      value: navigation.createMockNavigation()
+    });
+    Object.defineProperty(this, _previousNavigation, {
+      writable: true,
+      value: void 0
+    });
+    const configSearchDir = (_options$configSearch = options === null || options === void 0 ? void 0 : options.configSearchDir) !== null && _options$configSearch !== void 0 ? _options$configSearch : path__namespace.dirname(getCallerFile());
+    const tomlPath = findToml(configSearchDir);
+    const tomlDir = path__namespace.dirname(tomlPath);
+    const tomlContent = fs__namespace.readFileSync(tomlPath, 'utf-8');
+    validateApiVersion(tomlContent);
+    const modulePath = parseTargetModule(tomlContent, target);
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _target)[_target] = target;
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _modulePath)[_modulePath] = modulePath;
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _resolvedModule)[_resolvedModule] = path__namespace.resolve(tomlDir, modulePath);
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _checkout)[_checkout] = targets.isCheckoutTarget(target);
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _networkAccess)[_networkAccess] = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _checkout)[_checkout] && parseNetworkAccess(tomlContent);
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _apiAccess)[_apiAccess] = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _checkout)[_checkout] && parseApiAccess(tomlContent);
+  }
+  setUp() {
+    fetchPolyfills.installFetchPolyfills();
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl] = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _checkout)[_checkout] && !_rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _networkAccess)[_networkAccess] && !_rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _apiAccess)[_apiAccess] ? async () => {
+      // Checkout is the only surface that currently enforces
+      // fetch capabilities.
+      throw new Error('fetch() is not available. Add network_access = true or ' + 'api_access = true to [extensions.capabilities] in shopify.extension.toml.');
+    } : async () => new Response();
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch] = globalThis.fetch;
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _previousNavigation)[_previousNavigation] = globalThis.navigation;
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl] = navigation.createMockNavigation();
+    globalThis.shopify = deepWritableProxy(targetApis.createMockTargetApi(_rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _target)[_target]));
+    globalThis.fetch = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl];
+    globalThis.navigation = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl];
+  }
+  get shopify() {
+    if (!globalThis.shopify) {
+      throw new Error('You must call extension.setUp() before accessing extension.shopify.');
+    }
+    return globalThis.shopify;
+  }
+  get fetch() {
+    return _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl];
+  }
+  set fetch(fn) {
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _fetchImpl)[_fetchImpl] = fn;
+    globalThis.fetch = fn;
+  }
+  get navigation() {
+    return _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl];
+  }
+  set navigation(obj) {
+    _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _navigationImpl)[_navigationImpl] = obj;
+    globalThis.navigation = obj;
+  }
+  async render() {
+    const mod = await (function (t) { return Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespace(require(t)); }); })(_rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _resolvedModule)[_resolvedModule]);
+    const renderFn = mod.default;
+    if (typeof renderFn !== 'function') {
+      throw new Error(`Expected default export of ${_rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _modulePath)[_modulePath]} to be a function, got ${typeof renderFn}`);
+    }
+    await renderFn();
+  }
+  tearDown() {
+    // Dynamically import preact to unmount cleanly without requiring
+    // the test file to depend on preact directly.
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const {
+        render
+      } = require('preact');
+      render(null, document.body);
+    } catch {
+      // Fallback if preact isn't available
+      document.body.innerHTML = '';
+    }
+    delete globalThis.shopify;
+    if (_rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch] === undefined) {
+      delete globalThis.fetch;
+    } else {
+      globalThis.fetch = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _previousFetch)[_previousFetch];
+    }
+    if (_rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _previousNavigation)[_previousNavigation] === undefined) {
+      delete globalThis.navigation;
+    } else {
+      globalThis.navigation = _rollupPluginBabelHelpers.classPrivateFieldLooseBase(this, _previousNavigation)[_previousNavigation];
+    }
+    fetchPolyfills.uninstallFetchPolyfills();
+  }
+}
+const extensionCache = new Map();
+
 /**
  * Returns an extension test harness for the given target.
  *
@@ -55,92 +220,46 @@ var path__namespace = /*#__PURE__*/_interopNamespace(path);
  *   `shopify.extension.toml`. Defaults to the calling test file's directory.
  */
 function getExtension(target, options) {
-  var _options$configSearch;
-  const configSearchDir = (_options$configSearch = options === null || options === void 0 ? void 0 : options.configSearchDir) !== null && _options$configSearch !== void 0 ? _options$configSearch : path__namespace.dirname(getCallerFile());
-  const tomlPath = findToml(configSearchDir);
-  const tomlDir = path__namespace.dirname(tomlPath);
-  const tomlContent = fs__namespace.readFileSync(tomlPath, 'utf-8');
-  validateApiVersion(tomlContent);
-  const modulePath = parseTargetModule(tomlContent, target);
-  const resolvedModule = path__namespace.resolve(tomlDir, modulePath);
-  const checkout = targets.isCheckoutTarget(target);
-  const networkAccess = checkout && parseNetworkAccess(tomlContent);
-  const apiAccess = checkout && parseApiAccess(tomlContent);
-  let fetchImpl;
-  let previousFetch;
-  let navigationImpl = navigation.createMockNavigation();
-  let previousNavigation;
-  const ext = {
-    setUp() {
-      fetchPolyfills.installFetchPolyfills();
-      fetchImpl = checkout && !networkAccess && !apiAccess ? async () => {
-        // Checkout is the only surface that currently enforces
-        // fetch capabilities.
-        throw new Error('fetch() is not available. Add network_access = true or ' + 'api_access = true to [extensions.capabilities] in shopify.extension.toml.');
-      } : async () => new Response();
-      previousFetch = globalThis.fetch;
-      previousNavigation = globalThis.navigation;
-      globalThis.shopify = deepWritableProxy(targetApis.createMockTargetApi(target));
-      globalThis.fetch = fetchImpl;
-      globalThis.navigation = navigationImpl;
-    },
-    get shopify() {
-      if (!globalThis.shopify) {
-        throw new Error('You must call extension.setUp() before accessing extension.shopify.');
-      }
-      return globalThis.shopify;
-    },
-    get fetch() {
-      return fetchImpl;
-    },
-    set fetch(fn) {
-      fetchImpl = fn;
-      globalThis.fetch = fn;
-    },
-    get navigation() {
-      return navigationImpl;
-    },
-    set navigation(obj) {
-      navigationImpl = obj;
-      globalThis.navigation = obj;
-    },
-    async render() {
-      const mod = await (function (t) { return Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespace(require(t)); }); })(resolvedModule);
-      const renderFn = mod.default;
-      if (typeof renderFn !== 'function') {
-        throw new Error(`Expected default export of ${modulePath} to be a function, got ${typeof renderFn}`);
-      }
-      await renderFn();
-    },
-    tearDown() {
-      // Dynamically import preact to unmount cleanly without requiring
-      // the test file to depend on preact directly.
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const {
-          render
-        } = require('preact');
-        render(null, document.body);
-      } catch {
-        // Fallback if preact isn't available
-        document.body.innerHTML = '';
-      }
-      delete globalThis.shopify;
-      if (previousFetch === undefined) {
-        delete globalThis.fetch;
-      } else {
-        globalThis.fetch = previousFetch;
-      }
-      if (previousNavigation === undefined) {
-        delete globalThis.navigation;
-      } else {
-        globalThis.navigation = previousNavigation;
-      }
-      fetchPolyfills.uninstallFetchPolyfills();
-    }
-  };
+  var _options$configSearch2;
+  const resolvedConfigSearchDir = (_options$configSearch2 = options === null || options === void 0 ? void 0 : options.configSearchDir) !== null && _options$configSearch2 !== void 0 ? _options$configSearch2 : path__namespace.dirname(getCallerFile());
+  const tomlPath = findToml(resolvedConfigSearchDir);
+  const tomlMtimeMs = fs__namespace.statSync(tomlPath).mtimeMs;
+  const cacheKey = JSON.stringify([target, tomlPath, tomlMtimeMs]);
+  const cached = extensionCache.get(cacheKey);
+  if (cached) {
+    return cached;
+  }
+  const ext = new Extension(target, {
+    configSearchDir: resolvedConfigSearchDir
+  });
+  extensionCache.set(cacheKey, ext);
   return ext;
 }
+
+/**
+ * Sets up an extension for testing and returns a disposable object
+ * that supports automatic teardown with the `using` keyword:
+ *
+ * ```ts
+ * test('rendering the extension', async () => {
+ *   using extension = setUpExtension(
+ *     'purchase.checkout.block.render',
+ *   );
+ *   await extension.render();
+ *   // tearDown() is called automatically at the end of the block
+ * });
+ * ```
+ *
+ * @param target - The extension target to mock.
+ * @param options - Optional configuration (same as {@link getExtension}).
+ */
+function setUpExtension(target, options) {
+  const extension = getExtension(target, options);
+  extension.setUp();
+  return Object.assign(extension, {
+    [SymbolDispose]: () => extension.tearDown()
+  });
+}
 function validateApiVersion(toml) {
   const match = toml.match(/^\s*api_version\s*=\s*"([^"]+)"/m);
   const tomlVersion = match === null || match === void 0 ? void 0 : match[1];
@@ -208,8 +327,10 @@ function getCallerFile() {
     const err = new Error();
     let callerFile = '';
     Error.prepareStackTrace = (_err, stack) => {
-      // stack[0] is getCallerFile, stack[1] is getExtension, stack[2] is the caller
-      for (let i = 2; i < stack.length; i++) {
+      // Walk the stack, skipping all frames that originate from this
+      // package file.  This works regardless of whether the caller is
+      // getExtension() or setUpExtension() → getExtension().
+      for (let i = 1; i < stack.length; i++) {
         const fileName = stack[i].getFileName();
         if (fileName && fileName !== thisPackageFilePath) {
           callerFile = fileName;
@@ -341,4 +462,6 @@ function deepWritableProxy(obj) {
 }
 
 exports.createNavigationHistoryEntry = navigation.createNavigationHistoryEntry;
+exports.SymbolDispose = SymbolDispose;
 exports.getExtension = getExtension;
+exports.setUpExtension = setUpExtension;

package/build/cjs/point-of-sale/factories.js

@@ -57,9 +57,14 @@ function createTransaction() {
     lineItems: []
   };
 }
+function createConnectivityApiContent() {
+  return {
+    current: signals.createReadonlySignalLike(createConnectivityState())
+  };
+}
 function createMockBaseEventData() {
   return {
-    connectivity: createConnectivityState(),
+    connectivity: createConnectivityApiContent(),
     device: {
       name: 'Mock POS Device',
       deviceId: 1,

package/build/esm/_virtual/_rollupPluginBabelHelpers.mjs

@@ -0,0 +1,10 @@
+function _classPrivateFieldLooseBase(e, t) {
+  if (!{}.hasOwnProperty.call(e, t)) throw new TypeError("attempted to use private field on non-instance");
+  return e;
+}
+var id = 0;
+function _classPrivateFieldLooseKey(e) {
+  return "__private_" + id++ + "_" + e;
+}
+
+export { _classPrivateFieldLooseBase as classPrivateFieldLooseBase, _classPrivateFieldLooseKey as classPrivateFieldLooseKey };

package/build/esm/admin/factories.mjs

@@ -34,6 +34,13 @@ function createConfigApp() {
     applicationUrl: 'https://mock-app.test'
   };
 }
+function createIntentResponseApi() {
+  return {
+    ok: async () => {},
+    error: async () => {},
+    closed: async () => {}
+  };
+}
 function createMockStandardApi(target) {
   return {
     extension: {
@@ -66,6 +73,15 @@ function createMockStandardRenderingApi(target) {
     })
   };
 }
+function createAppIntentRenderMock(target) {
+  return {
+    ...createMockStandardRenderingApi(target),
+    intents: {
+      ...createMockStandardApi(target).intents,
+      response: createIntentResponseApi()
+    }
+  };
+}
 function createMockBlockApi(target) {
   return {
     ...createMockStandardRenderingApi(target),
@@ -210,6 +226,8 @@ const adminMockFactories = {
   // Runnable targets
   'admin.customers.segmentation-templates.data': createCustomerSegmentTemplateMock,
   'admin.app.tools.data': createMockStandardApi,
+  // App render targets
+  'admin.app.intent.render': createAppIntentRenderMock,
   // Block targets
   'admin.product-details.block.render': createMockBlockApi,
   'admin.order-details.block.render': createMockBlockApi,

package/build/esm/api-version.mjs

@@ -1,14 +1,14 @@
 /**
  * The API version supported by this version of the library.
  *
- * At build time, `"2026.4.0-rc.2"` is replaced by rollup with the
+ * At build time, `"2026.4.0"` is replaced by rollup with the
  * raw NPM version string from package.json (e.g. `"2026.4.0-rc.1"`).
  *
  * When running from source (e.g. in tests), the placeholder is still
  * present, so we fall back to reading package.json via require.
  */
 
-const npmVersion = "2026.4.0-rc.2";
+const npmVersion = "2026.4.0";
 function npmVersionToApiVersion(version) {
   const [year, minor] = version.split('.');
   return `${year}-${minor.padStart(2, '0')}`;

package/build/esm/checkout/factories.mjs

@@ -111,11 +111,6 @@ function createMockStandardApi(target) {
     }),
     selectedPaymentOptions: createSubscribableSignalLike([]),
     settings: createSubscribableSignalLike({}),
-    ui: {
-      overlay: {
-        close: () => {}
-      }
-    },
     version: '0.0.0',
     customerPrivacy: createSubscribableSignalLike({
       allowedProcessing: {