@swipt/api 0.1.0-nightly.41 → 0.1.0-nightly.43

package/device.d.ts

@@ -39,6 +39,7 @@ export declare function unlock(options?: CallOptions): Promise<void>;
 
 export declare function applicationEvents(options?: CallOptions): AsyncIterable<ApplicationStateEvent>;
 export declare function installedApplications(options?: CallOptions): Promise<InstalledApplication[]>;
+/** Answers a PNG file in cacheDirectory. */
 export declare function applicationIcon(bundleId: string, options?: CallOptions): Promise<FileHandle>;
 export declare function launchApplication(bundleId: string, options?: CallOptions & { url?: string; restart?: boolean }): Promise<void>;
 

package/file-system.d.ts

@@ -1,4 +1,9 @@
 export declare const dataDirectory: DirectoryHandle;
+/**
+ * Holds the files Swipt keeps for the Swiplet by default: screen recordings and their exports, and application icons.
+ * The system may delete its contents when storage runs low; clearing the Swiplet's data or deleting the Swiplet removes it.
+ */
+export declare const cacheDirectory: DirectoryHandle;
 export declare const assets: DirectoryHandle;
 
 export interface FileStat {
@@ -23,7 +28,8 @@ export interface FileHandle {
   stat(): Promise<FileStat | null>;
   text(): Promise<string>;
   bytes(): Promise<Uint8Array>;
-  write(data: string | Uint8Array | Blob): Promise<void>;
+  stream(): ReadableStream<Uint8Array>;
+  write(data: string | ArrayBuffer | ArrayBufferView | Blob | ReadableStream<ArrayBuffer | ArrayBufferView>): Promise<void>;
   copy(to: FileHandle): Promise<void>;
   move(to: FileHandle): Promise<void>;
   delete(): Promise<void>;

package/file-system.mjs

@@ -1,2 +1,3 @@
 export const dataDirectory = undefined;
+export const cacheDirectory = undefined;
 export const assets = undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swipt/api",
-  "version": "0.1.0-nightly.41",
+  "version": "0.1.0-nightly.43",
   "license": "GPL-3.0-or-later",
   "repository": {
     "type": "git",
@@ -54,9 +54,9 @@
     "@standard-schema/spec": "^1.1.0"
   },
   "peerDependencies": {
-    "@expo/ui": "~58.0.25",
+    "@expo/ui": "~58.0.26",
     "@types/react": "~19.3.0",
-    "expo": "~58.0.21",
+    "expo": "~58.0.22",
     "expo-localization": "~58.0.5",
     "expo-sqlite": "~58.0.15",
     "react": "19.3.0",

package/repl.d.ts

@@ -2,8 +2,10 @@ declare global {
   const accessibility: typeof import("@swipt/api/accessibility");
   const input: typeof import("@swipt/api/input");
   const device: typeof import("@swipt/api/device");
-  const screen: typeof import("@swipt/api/screen");
+  var screen: Screen;
+  interface Screen extends Readonly<typeof import("@swipt/api/screen")> {}
   const image: typeof import("@swipt/api/image");
+  const dataDirectory: import("@swipt/api/file-system").DirectoryHandle;
   const dialog: import("@swipt/api/swiplet").IntentDialog;
   const args: readonly string[];
 

package/screen.d.ts

@@ -40,6 +40,7 @@ export interface ScreenRecording {
   diff(from: number, to: number, options?: CallOptions & { readonly threshold?: number }): Promise<ImageDifference>;
   find(target: ScreenTarget | readonly ScreenTarget[], options?: Omit<ScreenFindOptions, "timeoutMs"> & { readonly from?: number; readonly to?: number }): Promise<(ScreenMatch & { readonly time: number }) | null>;
   export(options?: CallOptions & {
+    /** Omitted, the export goes to a new file in cacheDirectory. */
     readonly file?: FileHandle | string;
     readonly from?: number;
     readonly to?: number;
@@ -85,5 +86,8 @@ export declare const frames: ObservableState<RasterImage>;
 export declare function waitFor(predicate: (frame: RasterImage) => boolean | Promise<boolean>, options?: CallOptions & { readonly timeoutMs?: number }): Promise<RasterImage>;
 export declare function waitForChange(options?: WaitOptions & { readonly from?: RasterImage }): Promise<RasterImage>;
 export declare function waitForStable(options?: WaitOptions & { readonly durationMs?: number }): Promise<RasterImage>;
-export declare function record(options?: CallOptions & { readonly file?: FileHandle | string }): Promise<RecordingSession>;
+export declare function record(options?: CallOptions & {
+  /** Omitted, the recording goes to a new file in cacheDirectory. */
+  readonly file?: FileHandle | string;
+}): Promise<RecordingSession>;
 export declare function openRecording(file: FileHandle | string, options?: CallOptions): Promise<ScreenRecording>;

package/swiplet.d.ts

@@ -108,3 +108,5 @@ export declare function useService<E extends Extension<any, true>>(): ServiceHan
 export declare function exit(): void;
 
 export declare function preferredLocalizations(localizations: readonly string[]): string[];
+
+export {};