@lingxia/types 0.17.0 → 0.19.0

package/src/index.ts

@@ -6,6 +6,7 @@
 
 export * from './generated/logic.js';
 export type { Automation } from './automation/index.js';
+export type { MockAnswer, MockContext, MockHandler, MockRequest, Mocks } from './mocks.js';
 export * from './error.js';
 export * from './generated/error.js';
 export * from './generated/i18n.js';
@@ -18,7 +19,9 @@ import type {
   AppLifecycleName,
   BinaryFileData,
   FsWriteOptions,
+  ManagedPath,
   NoLifecycleTypos,
+  NoReservedPageMembers,
   PageConfig,
   PageInstance,
   PageLifecycleName,
@@ -36,19 +39,24 @@ declare global {
      * signature above covers the string case.
      */
     write(
-      path: string,
+      path: ManagedPath,
       data: BinaryFileData,
-      options?: Omit<FsWriteOptions, 'encoding'>
+      options?: Omit<FsWriteOptions, 'encoding'> & { encoding?: never }
     ): Promise<void>;
   }
 
   interface Lx {
     /**
-     * In-process UI/runtime automation.
+     * In-process UI/runtime automation, as app Logic may use it.
      *
-     * Select the current app with `.lxapp()` or a specific running app with
-     * `.lxapp(appid)`. Host-only surfaces enforce the `host` privilege when
-     * selected; `lingxia dev` and the Runner grant it implicitly.
+     * Select the calling app with `.lxapp()` (requires the `automation`
+     * privilege) or another running app with `.lxapp(appid)`; the host tiers
+     * (`lxapps`, `browser`, `shell`, `device`, `desktop`, `terminal`) require
+     * `host`, checked when the property is read. A privilege holds only when
+     * it is allowed for the app and the native host sealed a session grant
+     * for it; `lingxia dev` and the Runner do not widen that. Test-run-only
+     * members (`network`, nav `waitUntil: 'ready'`) belong to
+     * `HostRunAutomation`, the root of an `lxdev test` program.
      */
     automation(): Automation;
   }
@@ -69,14 +77,15 @@ declare global {
   function getApp<T extends AppInstance = AppInstance>(): T | null;
   /**
    * `TData` comes from `data`, `TCustom` from everything else you declare, so
-   * `this.data` is typed, `this.myMethod()` resolves, and `setData` checks
-   * top-level keys against `data`.
+   * `this.data` is a readonly view of that type, `this.myMethod()` resolves,
+   * and `setData` checks top-level keys against `data`.
    */
-  function Page<TData extends Record<string, unknown>, TCustom>(
+  function Page<TData extends object, TCustom>(
     config: PageConfig<TData> &
       TCustom &
       NoLifecycleTypos<TCustom, PageLifecycleName> &
-      ThisType<PageInstance<TData> & TCustom>
+      NoReservedPageMembers<TCustom> &
+      ThisType<PageInstance<TData> & Omit<TCustom, keyof PageInstance>>
   ): void;
   function getCurrentPages<T extends PageInstance = PageInstance>(): T[];
 }

package/src/mocks.ts

@@ -0,0 +1,62 @@
+/**
+ * Types for an lxapp's `mocks/index.ts`: the complete set of mock
+ * handlers, one per call the app makes, answered in development when the
+ * mock selection says so (`mocks/config.json`, `lingxia dev --mock`,
+ * `lxdev mock`). Import them type-only; mocks never ship:
+ *
+ * ```ts
+ * import type { Mocks } from '@lingxia/types/mocks';
+ *
+ * let signedIn = true; // module state: fresh on save, reset, restart and each spec
+ *
+ * export default {
+ *   'GET **\/devices': () => (signedIn ? { json: DEVICES } : { status: 401 }),
+ *   'DELETE **\/sessions/current': () => { signedIn = false; return { status: 204 }; },
+ *   'GET **\/legal': { json: [] },
+ * } satisfies Mocks;
+ * ```
+ */
+import type { NetworkRouteAnswer } from './automation/index.js';
+
+/**
+ * What a handler answers: exactly a route answer — `{ status?, headers?,
+ * json | body, contentType?, delay? }`, `{ abort: 'failed' }`,
+ * `{ hang: true }`, `{ sse: [...] }`, or `{ continue: true, patchJson? }`
+ * (the real backend answers). One answer per call: `sequence`, `times`,
+ * `match` and `bodyBase64` are scenario fields.
+ */
+export type MockAnswer = NetworkRouteAnswer;
+
+/** The call a handler answers. */
+export type MockRequest = {
+  /** Fetch cancellation when supplied; null otherwise (including SSE). */
+  signal: AbortSignal | null;
+  /** Upper-case. */
+  method: string;
+  url: URL;
+  /** What the app sent. */
+  headers: Headers;
+  /** The body as text; rejects for a stream, `Blob` or `FormData` body. */
+  text(): Promise<string>;
+  json<T = unknown>(): Promise<T>;
+};
+
+/** What a handler can use besides the request. */
+export type MockContext = {
+  /** The original `fetch`, not intercepted: proxy without recursing. */
+  fetch: typeof fetch;
+};
+
+/**
+ * Answers one call. Throwing, returning `undefined` or an invalid answer
+ * fails the request (`TypeError: fetch failed`); it never falls through to
+ * the real backend.
+ */
+export type MockHandler = (req: MockRequest, ctx: MockContext) => MockAnswer | Promise<MockAnswer>;
+
+/**
+ * The default export of `mocks/index.ts`: keys are HTTP targets
+ * (`'GET **\/devices/*'`, `'* **\/x'`, `'POST /regex/'`), tried in order;
+ * values are answers or handlers.
+ */
+export type Mocks = Record<string, MockAnswer | MockHandler>;

package/src/page.ts

@@ -0,0 +1,26 @@
+/**
+ * `T` where every value survives the JSON transfer `setData` makes to the
+ * View; a function, Date, Map, Set, promise or class instance becomes
+ * `never`, so a contract holding one does not compile. `undefined` members
+ * are allowed: the transfer drops them, as an optional member reads.
+ */
+export type JsonData<T> =
+  0 extends 1 & T ? any
+    : unknown extends T ? unknown
+    : T extends string | number | boolean | null | undefined ? T
+    : T extends (...args: never[]) => unknown ? never
+    : T extends Date | RegExp | Map<unknown, unknown> | Set<unknown> | PromiseLike<unknown> | symbol | bigint ? never
+    : T extends readonly unknown[] ? { [K in keyof T]: JsonData<T[K]> }
+    : T extends object ? { [K in keyof T]: JsonData<T[K]> }
+    : never;
+
+/**
+ * A shared, type-only page contract: the page's `data` and public actions,
+ * written once and used by Logic, View and tests. Importing it installs no
+ * Logic globals. `Data` must be JSON (see `JsonData`); otherwise the
+ * contract has no `data`, and every use of it names the problem.
+ */
+export type PageContract<Data = unknown, Actions = unknown> =
+  [Data] extends [JsonData<Data>]
+    ? { readonly data: Data; readonly actions: Actions }
+    : { readonly __pageDataMustBeJson: "PageContract data must be JSON: no functions, Dates, Maps, Sets or class instances" };

package/src/process.ts

@@ -31,6 +31,14 @@ export interface RongSpawnOptionsWithCmd extends RongSpawnOptions {
   cmd: string[];
 }
 
+/** Synchronous spawning cannot deliver async callbacks or react to an AbortSignal. */
+export type RongSpawnSyncOptions = Omit<RongSpawnOptions, 'onExit' | 'signal' | 'killSignal'> & {
+  onExit?: never;
+  signal?: never;
+  killSignal?: never;
+};
+export type RongSpawnSyncOptionsWithCmd = RongSpawnSyncOptions & { cmd: string[] };
+
 export interface RongSyncSubprocess {
   readonly exitCode: number | null;
   readonly success: boolean;
@@ -96,8 +104,10 @@ export interface RongShellCommand extends PromiseLike<RongShellResult> {
 export interface RongShellTag {
   (strings: TemplateStringsArray, ...values: unknown[]): RongShellCommand;
   (command: string): RongShellCommand;
-  cwd(path?: string): string | RongShellTag | undefined;
-  env(values?: RongEnvMap): RongEnvMap | RongShellTag | undefined;
+  cwd(): string | undefined;
+  cwd(path: string): RongShellTag;
+  env(): RongEnvMap | undefined;
+  env(values: RongEnvMap): RongShellTag;
   throws(value?: boolean): RongShellTag;
   nothrow(): RongShellTag;
   quiet(): RongShellTag;
@@ -122,8 +132,8 @@ declare global {
     readonly stderr: RongOutputHandle;
     spawn(cmd: string[], options?: RongSpawnOptions): RongSubprocess;
     spawn(options: RongSpawnOptionsWithCmd): RongSubprocess;
-    spawnSync(cmd: string[], options?: RongSpawnOptions): RongSyncSubprocess;
-    spawnSync(options: RongSpawnOptionsWithCmd): RongSyncSubprocess;
+    spawnSync(cmd: string[], options?: RongSpawnSyncOptions): RongSyncSubprocess;
+    spawnSync(options: RongSpawnSyncOptionsWithCmd): RongSyncSubprocess;
     readonly $: RongShellTag;
     readonly ShellError: {
       new (message: string): RongShellError;

package/src/testing/public-api.ts

@@ -2,6 +2,8 @@ import type {
   Automation,
   BrowserCookies,
   BrowserDriver,
+  ClockDriver,
+  DialogDriver,
   DesktopApp,
   DesktopAx,
   DesktopClipboard,
@@ -14,8 +16,13 @@ import type {
   DeviceDriver,
   LxAppDriver,
   LxAppManager,
+  MockDriver,
   NavDriver,
+  NetworkDriver,
+  NetworkRoute,
+  Scenario,
   PageDriver,
+  ProfileDriver,
   PageKey,
   PagePointer,
   ShellDriver,
@@ -25,18 +32,21 @@ import type {
   AppearanceApi,
   AppCacheApi,
   AutostartApi,
+  BannerApi,
   CompressVideoTask,
   ControlApi,
   ControlAppearanceApi,
   ControlDisplayLanguageApi,
   DisplayLanguageApi,
   DownloadTask,
+  ClipboardApi,
   FileSystemApi,
   HostAppApi,
   HostAppUpdateInfo,
   HostAppUpdateTask,
   LxFile,
   NavigationBarApi,
+  NotificationApi,
   PageMessagePort,
   PreviewMediaHandle,
   TabSurface,
@@ -57,11 +67,16 @@ import type {
 } from '../generated/logic.js';
 
 export const LX_API_NAMES = [
-  'app',
+  'host',
   'automation',
+  'alert',
+  'confirm',
+  'pickFile',
+  'pickFiles',
   'chooseDirectory',
   'chooseFile',
   'chooseMedia',
+  'clipboard',
   'compressImage',
   'compressVideo',
   'connectWifi',
@@ -127,22 +142,40 @@ export const LX_API_NAMES = [
 const HOST_APP_API = [
   'appearance',
   'autostart',
+  'banner',
   'cache',
   'checkUpdate',
+  'claimCustomUpdate',
   'control',
   'displayLanguage',
   'env',
   'exit',
   'getBaseInfo',
+  'getServiceEnv',
+  'notification',
   'screenshot',
   'setBadge',
+  'toggleServiceEnv',
 ] as const;
-// `autostart`, `control`, and `cache` are injected only where they apply, so a
-// runtime walk of `lx.app` must not require them.
+// `autostart`, `banner`, `control`, `cache`, and `notification` are injected
+// only where they apply, so a runtime walk of `lx.host` must not require them.
 const HOST_APP_RUNTIME_API = HOST_APP_API.filter(
-  (name) => name !== 'autostart' && name !== 'control' && name !== 'cache',
+  (name) =>
+    name !== 'autostart' &&
+    name !== 'banner' &&
+    name !== 'control' &&
+    name !== 'cache' &&
+    name !== 'notification',
 );
 const AUTOSTART_API = ['isEnabled', 'setEnabled'] as const;
+const BANNER_API = ['dismiss', 'show'] as const;
+const NOTIFICATION_API = [
+  'cancel',
+  'cancelAll',
+  'getPermission',
+  'requestPermission',
+  'show',
+] as const;
 const APP_CACHE_API = ['clear', 'size'] as const;
 const DISPLAY_LANGUAGE_API = ['get', 'watch'] as const;
 const CONTROL_API = ['appearance', 'displayLanguage'] as const;
@@ -166,10 +199,11 @@ const TERMINAL_FONTS_API = ['list'] as const;
 const TERMINAL_PREVIEW_API = ['clear', 'close', 'show'] as const;
 const WINDOWS_TERMINAL_API = ['install', 'setEnabled', 'status'] as const;
 const ENV_API = ['USER_CACHE_PATH', 'USER_DATA_PATH'] as const;
-const SURFACE_NAMESPACE_API = ['get', 'onContext', 'openDeclared', 'openPage', 'openUrl'] as const;
+const SURFACE_NAMESPACE_API = ['getByKey', 'watchContext', 'openDeclared', 'openPage', 'openUrl'] as const;
 const SHELL_API = ['openApp', 'openBuiltin', 'openDeclared', 'reconfigure', 'sidebarActions'] as const;
 const SHELL_SIDEBAR_ACTIONS_API = ['clear', 'remove', 'replace', 'update'] as const;
-const TRAY_API = ['hide', 'onClick', 'setBadge', 'setIcon', 'setMenu', 'setTitle', 'show'] as const;
+const TRAY_API = ['hide', 'onClick', 'setIcon', 'setMenu', 'setTitle', 'show'] as const;
+const CLIPBOARD_API = ['clear', 'read', 'readText', 'types', 'write', 'writeText'] as const;
 const FILE_SYSTEM_API = [
   'copy',
   'exists',
@@ -212,9 +246,26 @@ const AUTOMATION_API = [
   'shell',
   'terminal',
 ] as const;
-const SHELL_DRIVER_API = ['pins', 'setPin'] as const;
+const SHELL_DRIVER_API = ['pins', 'setPin', 'reorderPins'] as const;
 const TERMINAL_DRIVER_API = ['input', 'newTab', 'setMaximized', 'snapshot', 'split'] as const;
-const LXAPP_DRIVER_API = ['eval', 'info', 'nav', 'page', 'pages', 'surfaceLayout'] as const;
+const LXAPP_DRIVER_API = ['clock', 'dialogs', 'eval', 'info', 'mock', 'nav', 'network', 'page', 'pages', 'profile', 'surfaceLayout'] as const;
+const MOCK_DRIVER_API = ['reset', 'use'] as const;
+const CLOCK_DRIVER_API = ['install', 'runAll', 'setSystemTime', 'tick', 'uninstall'] as const;
+const DIALOG_DRIVER_API = [
+  'actionSheets',
+  'answerNextActionSheet',
+  'answerNextModal',
+  'modals',
+  'setAnswerMode',
+  'toasts',
+  'unanswered',
+  'unwatch',
+  'watch',
+] as const;
+const PROFILE_DRIVER_API = ['checkpoint', 'drop', 'restore'] as const;
+const NETWORK_DRIVER_API = ['captureResponses', 'requests', 'responses', 'route', 'unrouteAll'] as const;
+const NETWORK_ROUTE_API = ['id', 'pattern', 'requests', 'requestsAfter', 'unroute'] as const;
+const SCENARIO_API = ['calls', 'callsAfter', 'name', 'rules', 'unroute', 'variant'] as const;
 const LXAPP_MANAGER_API = [
   'applink',
   'close',
@@ -227,6 +278,7 @@ const LXAPP_MANAGER_API = [
   'windows',
 ] as const;
 const PAGE_DRIVER_API = [
+  'action',
   'click',
   'eval',
   'fill',
@@ -333,9 +385,10 @@ export const LX_RUNTIME_SURFACES = [
     members: LX_API_NAMES,
     optionalMembers: ['terminal'],
     properties: [
-      'app',
+      'clipboard',
       'env',
       'fs',
+      'host',
       'navigationBar',
       'shell',
       'surface',
@@ -345,57 +398,71 @@ export const LX_RUNTIME_SURFACES = [
     ],
   },
   {
-    name: 'lx.app',
+    name: 'lx.host',
     layer: 'logic',
-    expression: 'lx.app',
+    expression: 'lx.host',
     members: HOST_APP_RUNTIME_API,
     properties: ['appearance', 'displayLanguage', 'env'],
   },
   {
-    name: 'lx.app.autostart',
+    name: 'lx.host.autostart',
     layer: 'logic',
-    expression: 'lx.app.autostart',
+    expression: 'lx.host.autostart',
     members: AUTOSTART_API,
     optional: true,
   },
   {
-    name: 'lx.app.cache',
+    name: 'lx.host.banner',
+    layer: 'logic',
+    expression: 'lx.host.banner',
+    members: BANNER_API,
+    optional: true,
+  },
+  {
+    name: 'lx.host.notification',
     layer: 'logic',
-    expression: 'lx.app.cache',
+    expression: 'lx.host.notification',
+    members: NOTIFICATION_API,
+    optional: true,
+  },
+  {
+    name: 'lx.host.cache',
+    layer: 'logic',
+    expression: 'lx.host.cache',
     members: APP_CACHE_API,
     optional: true,
   },
   {
-    name: 'lx.app.displayLanguage',
+    name: 'lx.host.displayLanguage',
     layer: 'logic',
-    expression: 'lx.app.displayLanguage',
+    expression: 'lx.host.displayLanguage',
     members: DISPLAY_LANGUAGE_API,
   },
   {
-    name: 'lx.app.control',
+    name: 'lx.host.control',
     layer: 'logic',
-    expression: 'lx.app.control',
+    expression: 'lx.host.control',
     members: CONTROL_API,
     properties: CONTROL_API,
     optional: true,
   },
   {
-    name: 'lx.app.control.displayLanguage',
+    name: 'lx.host.control.displayLanguage',
     layer: 'logic',
-    expression: 'lx.app.control?.displayLanguage',
+    expression: 'lx.host.control?.displayLanguage',
     members: CONTROL_DISPLAY_LANGUAGE_API,
     optional: true,
   },
   {
-    name: 'lx.app.appearance',
+    name: 'lx.host.appearance',
     layer: 'logic',
-    expression: 'lx.app.appearance',
+    expression: 'lx.host.appearance',
     members: APPEARANCE_API,
   },
   {
-    name: 'lx.app.control.appearance',
+    name: 'lx.host.control.appearance',
     layer: 'logic',
-    expression: 'lx.app.control?.appearance',
+    expression: 'lx.host.control?.appearance',
     members: CONTROL_APPEARANCE_API,
     optional: true,
   },
@@ -476,6 +543,7 @@ export const LX_RUNTIME_SURFACES = [
   },
   { name: 'lx.tray', layer: 'logic', expression: 'lx.tray', members: TRAY_API },
   { name: 'lx.fs', layer: 'logic', expression: 'lx.fs', members: FILE_SYSTEM_API },
+  { name: 'lx.clipboard', layer: 'logic', expression: 'lx.clipboard', members: CLIPBOARD_API },
   { name: 'Storage', layer: 'logic', expression: 'lx.getStorage()', members: STORAGE_API },
   { name: 'UpdateManager', layer: 'logic', expression: 'lx.getUpdateManager()', members: UPDATE_MANAGER_API },
   {
@@ -501,8 +569,9 @@ export const LX_RUNTIME_SURFACES = [
     layer: 'automation',
     expression: 'lx.automation().lxapp()',
     members: LXAPP_DRIVER_API,
-    properties: ['nav', 'page'],
+    properties: ['clock', 'dialogs', 'mock', 'nav', 'network', 'page', 'profile'],
   },
+  { name: 'MockDriver', layer: 'automation', expression: 'lx.automation().lxapp().mock', members: MOCK_DRIVER_API },
   {
     name: 'PageDriver',
     layer: 'automation',
@@ -513,6 +582,44 @@ export const LX_RUNTIME_SURFACES = [
   { name: 'PagePointer', layer: 'automation', expression: 'lx.automation().lxapp().page.pointer', members: PAGE_POINTER_API },
   { name: 'PageKey', layer: 'automation', expression: 'lx.automation().lxapp().page.key', members: PAGE_KEY_API },
   { name: 'NavDriver', layer: 'automation', expression: 'lx.automation().lxapp().nav', members: NAV_DRIVER_API },
+  {
+    name: 'NetworkDriver',
+    layer: 'automation',
+    expression: 'lx.automation().lxapp().network',
+    members: NETWORK_DRIVER_API,
+  },
+  {
+    name: 'ProfileDriver',
+    layer: 'automation',
+    expression: 'lx.automation().lxapp().profile',
+    members: PROFILE_DRIVER_API,
+  },
+  {
+    name: 'ClockDriver',
+    layer: 'automation',
+    expression: 'lx.automation().lxapp().clock',
+    members: CLOCK_DRIVER_API,
+  },
+  {
+    name: 'DialogDriver',
+    layer: 'automation',
+    expression: 'lx.automation().lxapp().dialogs',
+    members: DIALOG_DRIVER_API,
+  },
+  {
+    name: 'NetworkRoute',
+    layer: 'automation',
+    expression: 'lx.automation().lxapp().network.route()',
+    members: NETWORK_ROUTE_API,
+    properties: ['id', 'pattern'],
+  },
+  {
+    name: 'Scenario',
+    layer: 'automation',
+    expression: 'lx.automation().lxapp().mock.use()',
+    members: SCENARIO_API,
+    properties: ['name', 'rules', 'variant'],
+  },
   { name: 'LxAppManager', layer: 'automation', expression: 'lx.automation().lxapps', members: LXAPP_MANAGER_API },
   { name: 'DeviceDriver', layer: 'automation', expression: 'lx.automation().device', members: DEVICE_DRIVER_API },
   {
@@ -549,22 +656,11 @@ export const LX_RUNTIME_CAPABILITY_NAMES = LX_RUNTIME_SURFACES.flatMap(({ name,
 /** Canonical identifiers used by runtime shape automation coverage. */
 export const LX_RUNTIME_SHAPE_NAMES = LX_RUNTIME_CAPABILITY_NAMES.map((name) => `shape:${name}`);
 
-const DOWNLOAD_TASK_API = [
-  'abort',
-  'cancel',
-  'catch',
-  'finally',
-  'next',
-  'pause',
-  'resume',
-  'return',
-  'then',
-  'wait',
-] as const;
-const UPLOAD_TASK_API = ['cancel', 'catch', 'finally', 'next', 'return', 'then', 'wait'] as const;
-const COMPRESS_VIDEO_TASK_API = ['cancel', 'catch', 'finally', 'next', 'return', 'then', 'wait'] as const;
-const HOST_UPDATE_INFO_API = ['apply', 'isForceUpdate', 'releaseNotes', 'size', 'version'] as const;
-const HOST_UPDATE_TASK_API = ['catch', 'finally', 'next', 'return', 'then', 'wait'] as const;
+const DOWNLOAD_TASK_API = ["result", "progress", "pause", "resume", "cancel"] as const;
+const UPLOAD_TASK_API = ["result", "progress", "cancel"] as const;
+const COMPRESS_VIDEO_TASK_API = ["result", "progress", "cancel"] as const;
+const HOST_UPDATE_INFO_API = ['apply', 'channel', 'releaseNotes', 'size', 'version'] as const;
+const HOST_UPDATE_TASK_API = ["result", "progress"] as const;
 const PREVIEW_MEDIA_API = ['completed', 'current', 'onChange', 'presented'] as const;
 const PAGE_SURFACE_API = [
   'alive',
@@ -616,7 +712,7 @@ export const LX_RETURNED_OBJECT_SURFACES = [
   {
     name: 'DownloadTask',
     members: DOWNLOAD_TASK_API,
-    properties: [],
+    properties: ['result', 'progress'],
     optionalProperties: [],
     fixture: 'external-service',
     factory: 'lx.downloadFile',
@@ -624,7 +720,7 @@ export const LX_RETURNED_OBJECT_SURFACES = [
   {
     name: 'UploadTask',
     members: UPLOAD_TASK_API,
-    properties: [],
+    properties: ['result', 'progress'],
     optionalProperties: [],
     fixture: 'external-service',
     factory: 'lx.uploadFile',
@@ -632,7 +728,7 @@ export const LX_RETURNED_OBJECT_SURFACES = [
   {
     name: 'CompressVideoTask',
     members: COMPRESS_VIDEO_TASK_API,
-    properties: [],
+    properties: ['result', 'progress'],
     optionalProperties: [],
     fixture: 'external-media',
     factory: 'lx.compressVideo',
@@ -640,15 +736,15 @@ export const LX_RETURNED_OBJECT_SURFACES = [
   {
     name: 'HostAppUpdateInfo',
     members: HOST_UPDATE_INFO_API,
-    properties: ['isForceUpdate', 'releaseNotes', 'size', 'version'],
+    properties: ['channel', 'releaseNotes', 'size', 'version'],
     optionalProperties: ['releaseNotes', 'size'],
     fixture: 'external-service',
-    factory: 'lx.app.checkUpdate().update',
+    factory: 'lx.host.checkUpdate().update',
   },
   {
     name: 'HostAppUpdateTask',
     members: HOST_UPDATE_TASK_API,
-    properties: [],
+    properties: ['result', 'progress'],
     optionalProperties: [],
     fixture: 'external-service',
     factory: 'HostAppUpdateInfo.apply',
@@ -731,6 +827,8 @@ export type LxApiManifestGate = [
   AssertTrue<Exact<PublishedLx, typeof LX_API_NAMES>>,
   AssertTrue<Exact<HostAppApi, typeof HOST_APP_API>>,
   AssertTrue<Exact<AutostartApi, typeof AUTOSTART_API>>,
+  AssertTrue<Exact<BannerApi, typeof BANNER_API>>,
+  AssertTrue<Exact<NotificationApi, typeof NOTIFICATION_API>>,
   AssertTrue<Exact<AppCacheApi, typeof APP_CACHE_API>>,
   AssertTrue<Exact<DisplayLanguageApi, typeof DISPLAY_LANGUAGE_API>>,
   AssertTrue<Exact<ControlApi, typeof CONTROL_API>>,
@@ -749,6 +847,7 @@ export type LxApiManifestGate = [
   AssertTrue<Exact<ShellApi['sidebarActions'], typeof SHELL_SIDEBAR_ACTIONS_API>>,
   AssertTrue<Exact<TrayApi, typeof TRAY_API>>,
   AssertTrue<Exact<FileSystemApi, typeof FILE_SYSTEM_API>>,
+  AssertTrue<Exact<ClipboardApi, typeof CLIPBOARD_API>>,
   AssertTrue<Exact<LxFile, typeof LX_FILE_API>>,
   AssertTrue<Exact<Storage, typeof STORAGE_API>>,
   AssertTrue<Exact<UpdateManager, typeof UPDATE_MANAGER_API>>,
@@ -762,6 +861,13 @@ export type LxApiManifestGate = [
   AssertTrue<Exact<PagePointer, typeof PAGE_POINTER_API>>,
   AssertTrue<Exact<PageKey, typeof PAGE_KEY_API>>,
   AssertTrue<Exact<NavDriver, typeof NAV_DRIVER_API>>,
+  AssertTrue<Exact<NetworkDriver, typeof NETWORK_DRIVER_API>>,
+  AssertTrue<Exact<NetworkRoute, typeof NETWORK_ROUTE_API>>,
+  AssertTrue<Exact<Scenario, typeof SCENARIO_API>>,
+  AssertTrue<Exact<MockDriver, typeof MOCK_DRIVER_API>>,
+  AssertTrue<Exact<ProfileDriver, typeof PROFILE_DRIVER_API>>,
+  AssertTrue<Exact<ClockDriver, typeof CLOCK_DRIVER_API>>,
+  AssertTrue<Exact<DialogDriver, typeof DIALOG_DRIVER_API>>,
   AssertTrue<Exact<DeviceDriver, typeof DEVICE_DRIVER_API>>,
   AssertTrue<Exact<BrowserDriver, typeof BROWSER_DRIVER_API>>,
   AssertTrue<Exact<BrowserCookies, typeof BROWSER_COOKIES_API>>,
@@ -782,6 +888,6 @@ export type LxApiManifestGate = [
   AssertTrue<Exact<PreviewMediaHandle, typeof PREVIEW_MEDIA_API>>,
   AssertTrue<Exact<SurfaceApi, typeof SURFACE_NAMESPACE_API>>,
   AssertTrue<Exact<PageSurface, typeof PAGE_SURFACE_API>>,
-  AssertTrue<Exact<TabSurface, typeof TAB_SURFACE_API>>,
+  AssertTrue<Exact<Extract<TabSurface, { scope: 'tab' }>, typeof TAB_SURFACE_API>>,
   AssertTrue<Exact<PageMessagePort, typeof PAGE_MESSAGE_PORT_API>>,
 ];

package/dist/automation-test-globals.d.ts

@@ -1,14 +0,0 @@
-/// <reference path="./logic-globals.d.ts" />
-
-import type { Automation } from './automation/index.js';
-
-/** Globals exposed by the `lxdev test` JavaScript runtime. */
-interface AutomationTestLx {
-  automation(): Automation;
-}
-
-declare global {
-  const lx: AutomationTestLx;
-}
-
-export {};