npm - sunpeak - Versions diffs - 0.16.21 → 0.16.24 - Mend

sunpeak 0.16.21 → 0.16.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (68) hide show

package/README.md +4 -3
package/bin/commands/dev.mjs +22 -3
package/bin/commands/new.mjs +6 -2
package/bin/commands/start.mjs +4 -0
package/bin/lib/get-port.mjs +60 -0
package/bin/lib/live/browser-auth.mjs +125 -0
package/bin/lib/live/chatgpt-config.d.mts +5 -0
package/bin/lib/live/chatgpt-config.mjs +12 -0
package/bin/lib/live/chatgpt-fixtures.d.mts +12 -0
package/bin/lib/live/chatgpt-fixtures.mjs +25 -0
package/bin/lib/live/chatgpt-page.mjs +210 -0
package/bin/lib/live/global-setup.mjs +150 -0
package/bin/lib/live/host-fixtures.mjs +61 -0
package/bin/lib/live/host-page.mjs +242 -0
package/bin/lib/live/live-config.d.mts +38 -0
package/bin/lib/live/live-config.mjs +98 -0
package/bin/lib/live/live-fixtures.d.mts +11 -0
package/bin/lib/live/live-fixtures.mjs +102 -0
package/bin/lib/live/test-config.d.mts +10 -0
package/bin/lib/live/test-config.mjs +35 -0
package/bin/lib/live/types.d.mts +54 -0
package/bin/lib/live/utils.mjs +70 -0
package/bin/sunpeak.js +1 -1
package/dist/chatgpt/index.cjs +1 -1
package/dist/chatgpt/index.js +1 -1
package/dist/claude/index.cjs +1 -1
package/dist/claude/index.js +1 -1
package/dist/{index-CX6Z4bED.js → index-B7Qw3Vhh.js} +2 -2
package/dist/index-B7Qw3Vhh.js.map +1 -0
package/dist/{index-B4aC3vjH.js → index-BEHP_bM8.js} +2 -2
package/dist/index-BEHP_bM8.js.map +1 -0
package/dist/{index-bKBBCBK6.cjs → index-SfudQ9Y_.cjs} +2 -2
package/dist/index-SfudQ9Y_.cjs.map +1 -0
package/dist/{index-CKabCJyV.cjs → index-XKHXfBiD.cjs} +2 -2
package/dist/index-XKHXfBiD.cjs.map +1 -0
package/dist/index.cjs +13 -5
package/dist/index.cjs.map +1 -1
package/dist/index.js +13 -5
package/dist/index.js.map +1 -1
package/dist/mcp/index.cjs +38 -13
package/dist/mcp/index.cjs.map +1 -1
package/dist/mcp/index.js +38 -13
package/dist/mcp/index.js.map +1 -1
package/dist/mcp/types.d.ts +2 -0
package/dist/simulator/index.cjs +1 -1
package/dist/simulator/index.js +1 -1
package/dist/simulator/simple-sidebar.d.ts +3 -1
package/dist/{simulator-D8t-r7HH.js → simulator-BCq2iOT-.js} +67 -27
package/dist/simulator-BCq2iOT-.js.map +1 -0
package/dist/{simulator-FFNttkqL.cjs → simulator-DRUsm6IZ.cjs} +67 -27
package/dist/simulator-DRUsm6IZ.cjs.map +1 -0
package/package.json +25 -1
package/template/README.md +24 -2
package/template/_gitignore +1 -0
package/template/package.json +3 -2
package/template/playwright.config.ts +24 -1
package/template/tests/live/albums.spec.ts +53 -0
package/template/tests/live/carousel.spec.ts +52 -0
package/template/tests/live/map.spec.ts +31 -0
package/template/tests/live/playwright.config.ts +3 -0
package/template/tests/live/review.spec.ts +54 -0
package/template/vitest.config.ts +1 -1
package/dist/index-B4aC3vjH.js.map +0 -1
package/dist/index-CKabCJyV.cjs.map +0 -1
package/dist/index-CX6Z4bED.js.map +0 -1
package/dist/index-bKBBCBK6.cjs.map +0 -1
package/dist/simulator-D8t-r7HH.js.map +0 -1
package/dist/simulator-FFNttkqL.cjs.map +0 -1

package/bin/lib/live/live-fixtures.mjs ADDED Viewed

@@ -0,0 +1,102 @@
+/**
+ * Host-agnostic Playwright fixtures for live testing.
+ *
+ * Users import from 'sunpeak/test' and get a `live` fixture that
+ * automatically resolves the correct host page object based on the
+ * Playwright project name. Adding a new host never changes user imports.
+ *
+ * Usage:
+ *   import { test, expect } from 'sunpeak/test';
+ *
+ *   test('my resource renders', async ({ live }) => {
+ *     const app = await live.invoke('show me something');
+ *     await expect(app.locator('img').first()).toBeVisible();
+ *   });
+ */
+import { resolvePlaywrightESM, getAppName } from './utils.mjs';
+const projectRoot = process.env.SUNPEAK_PROJECT_ROOT || process.cwd();
+const { test: base, expect } = await resolvePlaywrightESM(projectRoot);
+const appName = getAppName(projectRoot);
+/**
+ * Registry of host page classes and their message formatters.
+ * Classes are lazy-loaded and cached to avoid importing all hosts when only one is used.
+ */
+const HOST_REGISTRY = {
+  chatgpt: {
+    _cached: null,
+    load() {
+      this._cached ??= import('./chatgpt-page.mjs').then((m) => m.ChatGPTPage);
+      return this._cached;
+    },
+    formatMessage: (name, text) => `/${name} ${text}`,
+  },
+  // Future: claude: { _cached: null, load() { ... }, formatMessage: ... }
+};
+/**
+ * Resolve the host ID from the current Playwright project name.
+ * Project names match the host ID directly (e.g., 'chatgpt').
+ */
+function resolveHostId(projectName) {
+  if (!projectName) return 'chatgpt';
+  for (const hostId of Object.keys(HOST_REGISTRY)) {
+    if (projectName.startsWith(hostId)) return hostId;
+  }
+  return 'chatgpt';
+}
+const test = base.extend({
+  live: async ({ page }, use, testInfo) => {
+    const hostId = resolveHostId(testInfo.project.name);
+    const hostEntry = HOST_REGISTRY[hostId];
+    if (!hostEntry) {
+      throw new Error(`Unknown live test host: "${hostId}". Supported: ${Object.keys(HOST_REGISTRY).join(', ')}`);
+    }
+    const HostPageClass = await hostEntry.load();
+    const hostPage = new HostPageClass(page);
+    await hostPage.verifyLoggedIn();
+    const { formatMessage } = hostEntry;
+    const fixture = Object.create(hostPage);
+    fixture.page = page;
+    if (formatMessage) {
+      fixture.sendMessage = async (text) => hostPage.sendMessage(formatMessage(appName, text));
+    }
+    fixture.sendRawMessage = hostPage.sendMessage.bind(hostPage);
+    fixture.invoke = async (prompt, options) => {
+      await hostPage.startNewChat();
+      const message = formatMessage ? formatMessage(appName, prompt) : prompt;
+      await hostPage.sendMessage(message);
+      return hostPage.waitForAppIframe(options);
+    };
+    /**
+     * Switch the browser's color scheme and wait for the app to apply the new theme.
+     * Use this to test both light and dark mode within a single test after invoke(),
+     * avoiding a second tool invocation and resource refresh.
+     *
+     * @param {'light'|'dark'} scheme
+     * @param {object} [appFrame] - FrameLocator returned by invoke(). When provided,
+     *   waits for data-theme on the app's <html> to confirm the theme propagated.
+     */
+    fixture.setColorScheme = async (scheme, appFrame) => {
+      await page.emulateMedia({ colorScheme: scheme });
+      if (appFrame) {
+        try {
+          await appFrame.locator(`html[data-theme="${scheme}"]`).waitFor({ timeout: 10_000 });
+        } catch {
+          // App may not set data-theme; fall back to a short settle wait
+          await page.waitForTimeout(1_500);
+        }
+      }
+    };
+    await use(fixture);
+  },
+});
+export { test, expect };

package/bin/lib/live/test-config.d.mts ADDED Viewed

@@ -0,0 +1,10 @@
+import type { PlaywrightTestConfig } from '@playwright/test';
+import type { LiveConfigOptions } from './live-config.d.mts';
+export interface TestConfigOptions extends LiveConfigOptions {
+  /** Hosts to test against. Default: ['chatgpt'] */
+  hosts?: string[];
+}
+/** Create a complete Playwright config with one project per host. */
+export declare function defineLiveConfig(options?: TestConfigOptions): PlaywrightTestConfig;

package/bin/lib/live/test-config.mjs ADDED Viewed

@@ -0,0 +1,35 @@
+/**
+ * Host-agnostic Playwright config factory for live tests.
+ *
+ * Generates one Playwright project per host. Tests switch color scheme,
+ * viewport, and other host state internally via live.setColorScheme() and
+ * live.page so each resource is only invoked once per host.
+ *
+ * Usage in playwright.config.ts:
+ *   import { defineLiveConfig } from 'sunpeak/test/config';
+ *   export default defineLiveConfig();                                    // ChatGPT
+ *   export default defineLiveConfig({ hosts: ['chatgpt', 'claude'] });   // Both hosts
+ */
+import { createLiveConfig } from './live-config.mjs';
+/** Default hosts to test against. */
+const DEFAULT_HOSTS = ['chatgpt'];
+/**
+ * Create a complete Playwright config with one project per host.
+ *
+ * @param {Object} [options]
+ * @param {string[]} [options.hosts=['chatgpt']] - Hosts to test against
+ * @param {import('./live-config.d.mts').LiveConfigOptions} [options] - All other options passed to createLiveConfig
+ */
+export function defineLiveConfig(options = {}) {
+  const { hosts = DEFAULT_HOSTS, ...configOptions } = options;
+  // Use the first host for the base config (shared settings like webServer, globalSetup)
+  const baseConfig = createLiveConfig({ hostId: hosts[0] }, configOptions);
+  return {
+    ...baseConfig,
+    projects: hosts.map((host) => ({ name: host })),
+  };
+}

package/bin/lib/live/types.d.mts ADDED Viewed

@@ -0,0 +1,54 @@
+/** Playwright Locator subset used in live test assertions. */
+export interface Locator {
+  first(): Locator;
+  nth(index: number): Locator;
+  last(): Locator;
+  count(): Promise<number>;
+  click(options?: Record<string, any>): Promise<void>;
+  isVisible(options?: Record<string, any>): Promise<boolean>;
+  waitFor(options?: Record<string, any>): Promise<void>;
+  evaluate<R>(fn: (el: HTMLElement) => R): Promise<R>;
+  textContent(): Promise<string | null>;
+  innerText(): Promise<string>;
+  getAttribute(name: string): Promise<string | null>;
+}
+/** Playwright FrameLocator subset used in live test assertions. */
+export interface FrameLocator {
+  locator(selector: string): Locator;
+  getByText(text: string | RegExp, options?: Record<string, any>): Locator;
+  getByRole(role: string, options?: Record<string, any>): Locator;
+  getByTestId(testId: string): Locator;
+}
+/** Common fixture interface shared by all host-specific and generic live fixtures. */
+export interface LiveFixture {
+  /**
+   * The underlying Playwright Page. Exposed for advanced host-state changes
+   * (e.g., page.setViewportSize(), page.emulateMedia()) that don't have
+   * dedicated fixture helpers yet.
+   */
+  page: import('@playwright/test').Page;
+  /** Start a new chat, send the prompt, and return the app FrameLocator. */
+  invoke(prompt: string, options?: { timeout?: number }): Promise<FrameLocator>;
+  /** Start a new conversation. */
+  startNewChat(): Promise<void>;
+  /** Send a message (with host-appropriate formatting). */
+  sendMessage(text: string): Promise<void>;
+  /** Send a message without any prefix. */
+  sendRawMessage(text: string): Promise<void>;
+  /** Wait for the MCP app iframe to render and return a FrameLocator. */
+  waitForAppIframe(options?: { timeout?: number }): Promise<FrameLocator>;
+  /** Get the app iframe FrameLocator. */
+  getAppIframe(): FrameLocator;
+  /**
+   * Switch the browser's color scheme and wait for the app to apply the new theme.
+   * Use this to test both light and dark mode within a single test after invoke(),
+   * avoiding a second tool invocation and resource refresh.
+   *
+   * @param scheme - 'light' or 'dark'
+   * @param appFrame - FrameLocator returned by invoke(). When provided, waits for
+   *   data-theme on the app's <html> element to confirm the theme propagated.
+   */
+  setColorScheme(scheme: 'light' | 'dark', appFrame?: FrameLocator): Promise<void>;
+}

package/bin/lib/live/utils.mjs ADDED Viewed

@@ -0,0 +1,70 @@
+import { readFileSync, rmSync } from 'fs';
+import { join } from 'path';
+import { createRequire } from 'module';
+/**
+ * Recursively remove a directory (rm -rf equivalent).
+ */
+export function rimrafSync(dir) {
+  rmSync(dir, { recursive: true, force: true });
+}
+/**
+ * Browser launch args that bypass Cloudflare/ChatGPT bot detection.
+ * Used in browser-auth, global-setup, and live-config.
+ */
+export const ANTI_BOT_ARGS = [
+  '--disable-blink-features=AutomationControlled',
+  '--no-first-run',
+  '--no-default-browser-check',
+];
+/**
+ * Real Chrome user agent string to avoid Cloudflare challenges.
+ * Update periodically to match the Playwright-bundled Chromium version.
+ */
+export const CHROME_USER_AGENT =
+  'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36';
+/**
+ * Resolve @playwright/test from the user's project via CJS require.
+ * Use for non-test code (global-setup, config) where duplicate instances don't matter.
+ */
+export function resolvePlaywright(projectRoot) {
+  const require = createRequire(join(projectRoot, 'package.json'));
+  return require('@playwright/test');
+}
+/**
+ * Resolve @playwright/test ESM module from the user's project.
+ * Use for test fixtures that call test.extend() — avoids CJS/ESM duplicate module issues.
+ * Cached: safe to call multiple times.
+ */
+let _cachedPlaywright = null;
+let _cachedProjectRoot = null;
+export async function resolvePlaywrightESM(projectRoot) {
+  if (_cachedPlaywright && _cachedProjectRoot === projectRoot) return _cachedPlaywright;
+  const require = createRequire(join(projectRoot, 'package.json'));
+  const playwrightPath = require.resolve('@playwright/test');
+  const mod = await import(playwrightPath);
+  // Dynamic import() of @playwright/test (CJS) puts the test function at mod.default.
+  // The test function doubles as the module namespace — test.extend, test.expect, etc.
+  // Normalize so callers can destructure { test, expect } directly.
+  const pw = mod.default || mod;
+  _cachedPlaywright = { test: pw, expect: pw.expect };
+  _cachedProjectRoot = projectRoot;
+  return _cachedPlaywright;
+}
+/**
+ * Read the app name from the project's package.json.
+ * Cached: safe to call multiple times.
+ */
+let _cachedAppName = null;
+let _cachedAppNameRoot = null;
+export function getAppName(projectRoot) {
+  if (_cachedAppName && _cachedAppNameRoot === projectRoot) return _cachedAppName;
+  _cachedAppName = JSON.parse(readFileSync(join(projectRoot, 'package.json'), 'utf-8')).name;
+  _cachedAppNameRoot = projectRoot;
+  return _cachedAppName;
+}

package/bin/sunpeak.js CHANGED Viewed

@@ -104,7 +104,7 @@ Usage:
   sunpeak --version        Show version number
   Resources: ${resources.join(', ')} (comma/space separated)
-  Example: sunpeak new my-app "${resources.slice(0, 2).join(',')}"
+  Example: sunpeak new sunpeak-app "${resources.slice(0, 2).join(',')}"
 `);
       }
       break;

package/dist/chatgpt/index.cjs CHANGED Viewed

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const simulator = require("../simulator-FFNttkqL.cjs");
+const simulator = require("../simulator-DRUsm6IZ.cjs");
 const simulatorUrl = require("../simulator-url-DcSYRl-P.cjs");
 const discovery = require("../discovery-D1gpaVz4.cjs");
 exports.IframeResource = simulator.IframeResource;

package/dist/chatgpt/index.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { I, M, a, S, T, j, m, n } from "../simulator-D8t-r7HH.js";
+import { I, M, a, S, T, j, m, n } from "../simulator-BCq2iOT-.js";
 import { c } from "../simulator-url-j_XV3EoP.js";
 import { b, a as a2, c as c2, d, e, f, g, h, i, t } from "../discovery-BVqD-JsT.js";
 export {

package/dist/claude/index.cjs CHANGED Viewed

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const simulator = require("../simulator-FFNttkqL.cjs");
+const simulator = require("../simulator-DRUsm6IZ.cjs");
 exports.Simulator = simulator.Simulator;
 //# sourceMappingURL=index.cjs.map

package/dist/claude/index.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { S } from "../simulator-D8t-r7HH.js";
+import { S } from "../simulator-BCq2iOT-.js";
 export {
   S as Simulator
 };

package/dist/{index-CX6Z4bED.js → index-B7Qw3Vhh.js} RENAMED Viewed

@@ -1,4 +1,4 @@
-import { I as IframeResource, M as McpAppHost, a as SCREEN_WIDTHS, S as Simulator, T as ThemeProvider, j as extractResourceCSP, m as resolveServerToolResult, n as useThemeContext } from "./simulator-D8t-r7HH.js";
+import { I as IframeResource, M as McpAppHost, a as SCREEN_WIDTHS, S as Simulator, T as ThemeProvider, j as extractResourceCSP, m as resolveServerToolResult, n as useThemeContext } from "./simulator-BCq2iOT-.js";
 import { c as createSimulatorUrl } from "./simulator-url-j_XV3EoP.js";
 import { b as buildDevSimulations, a as buildResourceMap, c as buildSimulations, d as createResourceExports, e as extractResourceKey, f as extractSimulationKey, g as findResourceDirs, h as findResourceKey, i as getComponentName, t as toPascalCase } from "./discovery-BVqD-JsT.js";
 const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -26,4 +26,4 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
 export {
   index as i
 };
-//# sourceMappingURL=index-CX6Z4bED.js.map
+//# sourceMappingURL=index-B7Qw3Vhh.js.map

package/dist/index-B7Qw3Vhh.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index-B7Qw3Vhh.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/{index-B4aC3vjH.js → index-BEHP_bM8.js} RENAMED Viewed

@@ -1,4 +1,4 @@
-import { I as IframeResource, M as McpAppHost, a as SCREEN_WIDTHS, b as SidebarCheckbox, c as SidebarCollapsibleControl, d as SidebarControl, e as SidebarInput, f as SidebarSelect, g as SidebarTextarea, h as SidebarToggle, i as SimpleSidebar, S as Simulator, T as ThemeProvider, j as extractResourceCSP, k as getHostShell, l as getRegisteredHosts, r as registerHostShell, m as resolveServerToolResult, u as useSimulatorState, n as useThemeContext } from "./simulator-D8t-r7HH.js";
+import { I as IframeResource, M as McpAppHost, a as SCREEN_WIDTHS, b as SidebarCheckbox, c as SidebarCollapsibleControl, d as SidebarControl, e as SidebarInput, f as SidebarSelect, g as SidebarTextarea, h as SidebarToggle, i as SimpleSidebar, S as Simulator, T as ThemeProvider, j as extractResourceCSP, k as getHostShell, l as getRegisteredHosts, r as registerHostShell, m as resolveServerToolResult, u as useSimulatorState, n as useThemeContext } from "./simulator-BCq2iOT-.js";
 import { c as createSimulatorUrl } from "./simulator-url-j_XV3EoP.js";
 import { b as buildDevSimulations, a as buildResourceMap, c as buildSimulations, d as createResourceExports, e as extractResourceKey, f as extractSimulationKey, g as findResourceDirs, h as findResourceKey, i as getComponentName, t as toPascalCase } from "./discovery-BVqD-JsT.js";
 const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -38,4 +38,4 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
 export {
   index as i
 };
-//# sourceMappingURL=index-B4aC3vjH.js.map
+//# sourceMappingURL=index-BEHP_bM8.js.map

package/dist/index-BEHP_bM8.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index-BEHP_bM8.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/{index-bKBBCBK6.cjs → index-SfudQ9Y_.cjs} RENAMED Viewed

@@ -1,5 +1,5 @@
 "use strict";
-const simulator = require("./simulator-FFNttkqL.cjs");
+const simulator = require("./simulator-DRUsm6IZ.cjs");
 const simulatorUrl = require("./simulator-url-DcSYRl-P.cjs");
 const discovery = require("./discovery-D1gpaVz4.cjs");
 const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -25,4 +25,4 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
   useThemeContext: simulator.useThemeContext
 }, Symbol.toStringTag, { value: "Module" }));
 exports.index = index;
-//# sourceMappingURL=index-bKBBCBK6.cjs.map
+//# sourceMappingURL=index-SfudQ9Y_.cjs.map

package/dist/index-SfudQ9Y_.cjs.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index-SfudQ9Y_.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/{index-CKabCJyV.cjs → index-XKHXfBiD.cjs} RENAMED Viewed

@@ -1,5 +1,5 @@
 "use strict";
-const simulator = require("./simulator-FFNttkqL.cjs");
+const simulator = require("./simulator-DRUsm6IZ.cjs");
 const simulatorUrl = require("./simulator-url-DcSYRl-P.cjs");
 const discovery = require("./discovery-D1gpaVz4.cjs");
 const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -37,4 +37,4 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
   useThemeContext: simulator.useThemeContext
 }, Symbol.toStringTag, { value: "Module" }));
 exports.index = index;
-//# sourceMappingURL=index-CKabCJyV.cjs.map
+//# sourceMappingURL=index-XKHXfBiD.cjs.map

package/dist/index-XKHXfBiD.cjs.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index-XKHXfBiD.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.cjs CHANGED Viewed

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const useApp = require("./use-app-D09O2swh.cjs");
 const host_index = require("./host/index.cjs");
-const simulator_index = require("./index-CKabCJyV.cjs");
-const chatgpt_index = require("./index-bKBBCBK6.cjs");
+const simulator_index = require("./index-XKHXfBiD.cjs");
+const chatgpt_index = require("./index-SfudQ9Y_.cjs");
 const jsxRuntime = require("react/jsx-runtime");
 const React = require("react");
-const simulator = require("./simulator-FFNttkqL.cjs");
+const simulator = require("./simulator-DRUsm6IZ.cjs");
 const discovery = require("./discovery-D1gpaVz4.cjs");
 const protocol = require("./protocol-DkDHRwOW.cjs");
 function _interopNamespaceDefault(e) {
@@ -177,6 +177,7 @@ function getRegistry$1(app) {
     if (ctx?.styles?.css?.fonts) {
       useApp.TQ(ctx.styles.css.fonts);
     }
+    let debounceTimer = null;
     app.onhostcontextchanged = () => {
       const ctx2 = app.getHostContext();
       if (ctx2?.theme) {
@@ -186,7 +187,11 @@ function getRegistry$1(app) {
       if (ctx2?.styles?.css?.fonts) {
         useApp.TQ(ctx2.styles.css.fonts);
       }
-      for (const fn of subs) fn();
+      if (debounceTimer) clearTimeout(debounceTimer);
+      debounceTimer = setTimeout(() => {
+        debounceTimer = null;
+        for (const fn of subs) fn();
+      }, 50);
     };
   }
   return subs;
@@ -373,7 +378,7 @@ const SafeArea = React.forwardRef(function SafeArea2({ children, style, ...props
   const viewport = useViewport();
   const displayMode = useDisplayMode();
   const isFullscreen = displayMode === "fullscreen";
-  const height = viewport?.height ?? (isFullscreen ? "100dvh" : void 0);
+  const height = isFullscreen ? viewport?.height ?? "100dvh" : void 0;
   return /* @__PURE__ */ jsxRuntime.jsx(
     "div",
     {
@@ -386,7 +391,10 @@ const SafeArea = React.forwardRef(function SafeArea2({ children, style, ...props
         paddingLeft: safeArea.left || void 0,
         paddingRight: safeArea.right || void 0,
         height,
+        // overflow:hidden ensures content doesn't escape the maxHeight boundary,
+        // which also lets apps fill the space with their own scrollable container.
         maxHeight: viewport?.maxHeight,
+        overflow: viewport?.maxHeight != null ? "hidden" : void 0,
         width: viewport?.width,
         maxWidth: viewport?.maxWidth,
         ...style