@swiftbrowser/native 0.18.3 → 0.21.0

package/README.md

@@ -97,9 +97,16 @@ There is no `window` and no `document`. Code that checks for them takes its
 headless path, which is right here; `@swiftbrowser/react`'s `Host` (React DOM
 inside the tree) renders nothing, as `react-dom` is aliased to a stub.
 
-`fetch` sends the request over the bridge and `URLSession` performs it;
-bodies are whole (no streams), and may be a `Blob` or a `FormData` (sent as
-multipart: a file upload works as written for the page). `URL` is a small
+`fetch` sends the request over the bridge and `URLSession` performs it. A
+body may be a `Blob` or a `FormData` (sent as multipart: a file upload works
+as written for the page), and one holding picked or dropped files still on
+disk (the files themselves, their slices, a `Blob` built from slices of
+several, a form with them) is streamed from disk: the body goes to the host
+as parts, bytes beside the request and ranges of files, and an `InputStream`
+reads them in order as the request sends, so a 2 GB upload holds nothing in
+memory; a host before 0.20 reads the files first. Responses are read whole
+(`response.body` is null; `arrayBuffer()`, `text()`, `json()`, `blob()`).
+An `AbortController`'s abort cancels the task (`fetchCancel`). `URL` is a small
 parser, enough for absolute and relative URLs and query strings, not the
 whole WHATWG algorithm; `URL.createObjectURL` gives a `data:` URL. `WebSocket`
 runs on `URLSessionWebSocketTask`, `crypto.subtle` digests (SHA-1 to
@@ -116,11 +123,15 @@ background, where the system owns the screen, and holds again on return).
 Apple sheet (`ASAuthorizationController`, with the app's
 `com.apple.developer.applesignin` entitlement) and answer the credential;
 `appleCredentialState` asks the provider.
-`fileManager` reaches the app's sandbox through `files` requests, and its
+`fileManager` reaches the app's sandbox through `files` requests (a
+`range` read is `FileHandle`'s seek and read, so a large file goes a piece
+at a time; a picked or dropped file written is copied on disk, `importItem`,
+never through the bridge), and its
 iCloud Drive container (`iCloudDirectory()`) where the app has the
 entitlement: the container's files are read and written under file
 coordination, downloaded first when another device wrote them, and their
-changes come to `__sbFilesChanged` for `fileManager.watch`.
+changes come to `__sbFilesChanged` for `fileManager.watch`, as the app's
+own writes do.
 `navigator.geolocation` asks `CLLocationManager`: `getCurrentPosition` for
 one fix, `watchPosition` for every fix until `clearWatch`, with the API's
 `GeolocationPositionError` codes (the first ask prompts the viewer; the
@@ -271,7 +282,15 @@ the host answers instead, with `UIActivityViewController`, the photo picker
 to Files), `UIPasteboard` and `UIColorPickerViewController`.
 Nothing to write: `run` fills the web renderer's environment with what the
 page has nothing for, so a screen written for the page shares and picks as
-it did. Picked files are `File`s with their bytes.
+it did. A picked file is a `LazyFile`: a `File` whose name, type and size
+are known and whose bytes stay on disk (a document in the app's tmp, a
+photo copied there, a folder opened in place with its security scope kept)
+until `arrayBuffer()`, `text()` or a `slice` reads them by range through the
+files bridge; `fileManager.write` copies it, a `fetch` body or `FormData`
+streams it from disk, `ShareLink` and `fileExporter` copy it. Files dropped on a
+`dropDestination` from another app arrive the same way, a dropped folder's
+named by their paths in it. The app keeps them readable until it asks the
+host to forget them (`files` `release`, or the next folder pick).
 
 ```ts
 import { webAuthenticate, secureStorage } from '@swiftbrowser/native';
@@ -321,6 +340,25 @@ JavaScriptCore lacks. `test/fastRefresh.test.ts` runs the loop in Node.
 Xcode scheme or `simctl launch`), as the Fidelity example does to open one
 screen.
 
+## In CI
+
+```sh
+npx swiftbrowser-native ios-profile com.example.MyApp --profile "MyApp Ad Hoc" --name MyApp
+npx swiftbrowser-native ios-install-page build/MyApp.ipa --out site --url https://ios.my-app.pages.dev \
+  --bundle-id com.example.MyApp --version 1.0.42 [--web https://my-app.pages.dev/] [--commit $GITHUB_SHA]
+```
+
+`ios-profile` makes an ad hoc provisioning profile again through the App
+Store Connect API (`ASC_KEY_ID`, `ASC_ISSUER_ID` and `ASC_KEY_P8` from the
+environment, a key with the Admin or App Manager role) with every enabled
+iOS device and valid distribution certificate of the team, registering the
+bundle ID if the team has none, and installs it where Xcode looks.
+`ios-install-page` writes the over-the-air install page around an exported
+IPA: the IPA, its `manifest.plist`, an `index.html` whose button installs it,
+and the `_headers` Cloudflare Pages serves them with. SwiftBrowser's reusable
+workflow `sb-ios-adhoc.yml` runs both ([docs/native.md](../../docs/native.md),
+"Building and deploying from GitHub Actions").
+
 ## In the browser
 
 ```sh
@@ -349,24 +387,28 @@ the site: a `.symbolset` holding any SVG draws as a symbol there), and
 `--worker <name>=<entry>` (repeatable) for the app's workers, published
 beside the bundle for the page's `Worker`.
 
-## The escape hatch
+## Registered views
 
 ```tsx
-import { Native } from '@swiftbrowser/native';
+import { RegisteredView } from '@swiftbrowser/react';
 
-<Native name="MapView" props={{ region }} onEvent={(value) => console.log('map said', value)}>
+<RegisteredView name="MapView" props={{ region }} onEvent={(value) => console.log('map said', value)}>
   <Text>Children are SwiftUI views inside the native view</Text>
-</Native>
+</RegisteredView>
 ```
 
 The Swift app registers the view once:
 
 ```swift
-NativeRegistry.register("MapView") { context in
+ViewRegistry.register("MapView") { context in
     MapView(region: context.props["region"]) { context.send(["tapped": true]) }
 }
 ```
 
+and a page can register its own element under the same name
+(`ViewRegistry.register('MapView', (context) => ({ element, update, dispose }))`,
+also from @swiftbrowser/react), so the same element draws on both.
+
 Swift that is not a view registers as a function, before the bundle loads
 (`swiftbrowser native init` writes an `ios/NativeFunctions.swift` for them):
 

package/bin/swiftbrowser-native.mjs

@@ -10,11 +10,58 @@
 // `--catalog <dir.xcassets>`, repeatable, for the app's named images). All
 // three take `--worker <name>=<entry>`, repeatable: a worker bundle
 // `<name>.worker.js` beside app.js, for `createWorker(name)`.
+//
+// For CI (src/ios.ts; the reusable workflow sb-ios-adhoc.yml runs them):
+// `swiftbrowser-native ios-profile <bundle id> --profile <name> [--name <App>]`
+// makes the ad hoc provisioning profile again with every registered device
+// (ASC_KEY_ID, ASC_ISSUER_ID and ASC_KEY_P8 from the environment), and
+// `swiftbrowser-native ios-install-page <App.ipa> --out <dir> --url <base>
+// --bundle-id <id> --version <v> [--title <App>] [--web <url>] [--commit <sha>]`
+// writes the over-the-air install page around an exported IPA.
 
 import { basename, resolve } from 'node:path';
 import { buildApp, serve, workerOutfile } from '../dist/build.js';
 
 const [command, entry, ...rest] = process.argv.slice(2);
+
+if (command === 'ios-profile' || command === 'ios-install-page') {
+  const values = {};
+  for (let i = 0; i < rest.length; i++) {
+    if (rest[i].startsWith('--')) values[rest[i].slice(2)] = rest[++i];
+  }
+  const ios = await import('../dist/ios.js');
+  const fail = (message) => {
+    console.error(message);
+    process.exit(2);
+  };
+  if (command === 'ios-profile') {
+    if (!entry || !values.profile) fail('usage: swiftbrowser-native ios-profile <bundle id> --profile <name> [--name <App>]');
+    const env = (name) => process.env[name] || fail(`${name} is not set (the App Store Connect API key)`);
+    await ios.makeAdhocProfile({
+      bundleId: entry,
+      profileName: values.profile,
+      appName: values.name ?? values.profile,
+      keyId: env('ASC_KEY_ID'),
+      issuer: env('ASC_ISSUER_ID'),
+      key: env('ASC_KEY_P8'),
+    });
+  } else {
+    if (!entry || !values.out || !values.url || !values['bundle-id'] || !values.version) {
+      fail('usage: swiftbrowser-native ios-install-page <App.ipa> --out <dir> --url <base> --bundle-id <id> --version <v> [--title <App>] [--web <url>] [--commit <sha>]');
+    }
+    const files = ios.writeInstallPage(resolve(values.out), {
+      ipa: resolve(entry),
+      url: values.url,
+      bundleId: values['bundle-id'],
+      version: values.version,
+      ...(values.title ? { title: values.title } : {}),
+      ...(values.web ? { web: values.web } : {}),
+      ...(values.commit ? { commit: values.commit } : {}),
+    });
+    console.log(`install page written to ${values.out}: ${files.join(', ')}`);
+  }
+  process.exit(0);
+}
 const flags = { catalog: [], worker: [] };
 for (let i = 0; i < rest.length; i++) {
   const arg = rest[i];

package/dist/blob.d.ts

@@ -1,25 +1,49 @@
 /**
  * `Blob`, `File` and `FormData` for the native app: bytes with a type, a
- * named one, and a form whose entries `fetch` sends as multipart. A body is
- * still whole (no streams); `URL.createObjectURL` gives a `data:` URL, which
- * the host's image loader and `URLSession` both read, and
- * `revokeObjectURL` has nothing to free.
+ * named one, and a form whose entries `fetch` sends as multipart. A blob is
+ * a list of parts, each bytes in memory or a range of a file on disk (a
+ * `LazyFile`, as the pickers and drops answer), so a `Blob` built from
+ * picked files' slices holds nothing in memory and `fetch` streams it from
+ * disk (fetch.ts). `URL.createObjectURL` gives a `data:` URL, which the
+ * host's image loader and `URLSession` both read, and `revokeObjectURL` has
+ * nothing to free.
  */
 export type BlobPartLike = string | ArrayBuffer | ArrayBufferView | SimpleBlob;
+/** What a blob, and so a request body, is made of: bytes here, or a range of a file on disk. */
+export type BodyPart = {
+    bytes: Uint8Array;
+} | {
+    file: LazyFile;
+};
 export interface BlobOptions {
     type?: string;
 }
 export interface FileOptions extends BlobOptions {
     lastModified?: number;
 }
-/** The browser's `Blob`: bytes and a MIME type. */
+export declare const partSize: (part: BodyPart) => number;
+/** Whether any part is a file on disk, which only an asynchronous read reaches. */
+export declare const partsAreLazy: (parts: readonly BodyPart[]) => boolean;
+/** The parts' bytes, whole: those on disk read through the files bridge. */
+export declare function partsBytes(parts: readonly BodyPart[]): Promise<Uint8Array>;
+/** The browser's `Blob`: parts (bytes, or files on disk) and a MIME type. */
 export declare class SimpleBlob {
-    private readonly data;
+    private readonly parts_;
+    /** The parts joined, once asked for (a blob with nothing on disk). */
+    private joined;
     readonly type: string;
     constructor(parts?: Iterable<BlobPartLike>, options?: BlobOptions);
+    /** A blob straight from parts (a slice). */
+    protected static fromParts(parts: BodyPart[], type: string): SimpleBlob;
     get size(): number;
-    /** The bytes (a view; callers must not write into it). */
+    /** The parts, in order: what a request body sends, each from memory or from disk. */
+    parts(): BodyPart[];
+    /** Whether any part is still on disk, so `bytes()` cannot answer and `bytesAsync()` reads it. */
+    get isLazy(): boolean;
+    /** The bytes (a view; callers must not write into it). Throws for a blob holding a file on disk: read it with `bytesAsync`. */
     bytes(): Uint8Array;
+    /** The bytes, the parts on disk read now. */
+    bytesAsync(): Promise<Uint8Array>;
     slice(start?: number, end?: number, contentType?: string): SimpleBlob;
     arrayBuffer(): Promise<ArrayBuffer>;
     text(): Promise<string>;
@@ -32,11 +56,49 @@ export declare class SimpleFile extends SimpleBlob {
     constructor(parts: Iterable<BlobPartLike>, name: string, options?: FileOptions);
     get [Symbol.toStringTag](): string;
 }
+/**
+ * A file the viewer picked or dropped, still on disk: its name, type and size
+ * are known, its bytes are read through the host's files bridge only when
+ * asked (`arrayBuffer`, `bytesAsync`, or a `fetch` body), a range at a time
+ * for a `slice`, so a large file never sits in memory whole. `fileManager.write`
+ * copies one on disk instead of reading it. `bytes()` (synchronous) is not
+ * available: it throws, as the bytes are not here.
+ */
+export declare class LazyFile extends SimpleFile {
+    /** The `file:` URL the host reads it at. */
+    readonly url: string;
+    /** The range of the file on disk this stands for (`slice` narrows it). */
+    readonly start: number;
+    readonly end: number;
+    private readonly reader;
+    constructor(url: string, name: string, size: number, reader: (url: string, start: number, end: number) => Promise<Uint8Array>, options?: FileOptions, range?: {
+        start: number;
+        end: number;
+    });
+    /** Whether this is the whole file on disk, not a slice of it. */
+    get isWhole(): boolean;
+    private sizeOnDisk;
+    /** Sets the file's size on disk (the constructor's `size`); the range defaults to all of it. */
+    static make(url: string, name: string, size: number, reader: (url: string, start: number, end: number) => Promise<Uint8Array>, options?: FileOptions): LazyFile;
+    get size(): number;
+    parts(): BodyPart[];
+    get isLazy(): boolean;
+    bytes(): Uint8Array;
+    /** The bytes, read from disk now. */
+    bytesAsync(): Promise<Uint8Array>;
+    slice(start?: number, end?: number, contentType?: string): LazyFile;
+    /** The same file under another name (a form's `filename`), still on disk. */
+    renamed(name: string): LazyFile;
+}
+/** A blob's bytes, read from disk where it holds a `LazyFile`. */
+export declare function blobBytes(blob: SimpleBlob): Promise<Uint8Array>;
 export type FormDataEntryValueLike = string | SimpleFile;
 /** The browser's `FormData`, as far as a request body needs it. */
 export declare class SimpleFormData {
     private entries_;
     private static value;
+    /** Whether an entry is a picked file still on disk (or a blob holding one), which the form's body streams from there. */
+    get hasLazyFiles(): boolean;
     append(name: string, value: unknown, filename?: string): void;
     set(name: string, value: unknown, filename?: string): void;
     get(name: string): FormDataEntryValueLike | null;
@@ -50,11 +112,23 @@ export declare class SimpleFormData {
     [Symbol.iterator](): IterableIterator<[string, FormDataEntryValueLike]>;
     get [Symbol.toStringTag](): string;
 }
-/** A multipart/form-data body for the form, with the boundary `random` makes unique. */
-export declare function encodeMultipart(form: SimpleFormData, random: (count: number) => Uint8Array): {
-    bytes: Uint8Array;
+/** The boundary of a multipart body, unique by `random`'s bytes. */
+export declare function multipartBoundary(random: (count: number) => Uint8Array): string;
+/**
+ * A multipart/form-data body for the form, with the boundary `random` makes
+ * unique, as parts: the heads and the fields in memory, a file still on disk
+ * as the range of it (`fetch` streams those from disk, or reads them first
+ * for a host that cannot).
+ */
+export declare function encodeMultipart(form: SimpleFormData, random: (count: number) => Uint8Array, boundary?: string): {
+    parts: BodyPart[];
     contentType: string;
 };
-/** `URL.createObjectURL`: a `data:` URL holding the blob. */
+/** `encodeMultipart` with the body whole: a form's files on disk are read first. */
+export declare function encodeMultipartAsync(form: SimpleFormData, random: (count: number) => Uint8Array, boundary?: string): Promise<{
+    bytes: Uint8Array;
+    contentType: string;
+}>;
+/** `URL.createObjectURL`: a `data:` URL holding the blob; a picked file still on disk is its own `file:` URL. */
 export declare function objectURL(blob: SimpleBlob): string;
 //# sourceMappingURL=blob.d.ts.map

package/dist/blob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAqBD,mDAAmD;AACnD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,KAAK,GAAE,QAAQ,CAAC,YAAY,CAAM,EAAE,OAAO,GAAE,WAAgB;IAOzE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,0DAA0D;IAC1D,KAAK,IAAI,UAAU;IAInB,KAAK,CAAC,KAAK,SAAI,EAAE,GAAG,SAAY,EAAE,WAAW,SAAK,GAAG,UAAU;IAMzD,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAInC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CACF;AAED,kDAAkD;AAClD,qBAAa,UAAW,SAAQ,UAAU;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB;IAMlF,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAE1C;CACF;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEzD,mEAAmE;AACnE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA0C;IAE1D,OAAO,CAAC,MAAM,CAAC,KAAK;IAQpB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAY1D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAIhD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAI9C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAI7D,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAIhC,MAAM,IAAI,gBAAgB,CAAC,sBAAsB,CAAC;IAInD,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAIpG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAIvE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CACF;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAavI;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAElD"}
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,UAAU,CAAC;AAE/E,gGAAgG;AAChG,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAElE,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAWD,eAAO,MAAM,QAAQ,GAAI,MAAM,QAAQ,KAAG,MAAoE,CAAC;AAE/G,mFAAmF;AACnF,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,QAAQ,EAAE,KAAG,OAA+C,CAAC;AAE1G,4EAA4E;AAC5E,wBAAsB,UAAU,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAIhF;AAaD,6EAA6E;AAC7E,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,sEAAsE;IACtE,OAAO,CAAC,MAAM,CAA2B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,KAAK,GAAE,QAAQ,CAAC,YAAY,CAAM,EAAE,OAAO,GAAE,WAAgB;IAOzE,4CAA4C;IAC5C,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;IAMvE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,qFAAqF;IACrF,KAAK,IAAI,QAAQ,EAAE;IAInB,iGAAiG;IACjG,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,+HAA+H;IAC/H,KAAK,IAAI,UAAU;IAMnB,6CAA6C;IACvC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAIvC,KAAK,CAAC,KAAK,SAAI,EAAE,GAAG,SAAY,EAAE,WAAW,SAAK,GAAG,UAAU;IAkBzD,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAKnC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CACF;AAED,kDAAkD;AAClD,qBAAa,UAAW,SAAQ,UAAU;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB;IAMlF,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAE1C;CACF;AAED;;;;;;;GAOG;AACH,qBAAa,QAAS,SAAQ,UAAU;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmE;gBAGxF,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,EACxE,OAAO,GAAE,WAAgB,EACzB,KAAK,GAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAA4B;IASjE,iEAAiE;IACjE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,UAAU,CAAK;IAEvB,gGAAgG;IAChG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,GAAE,WAAgB,GAAG,QAAQ;IAMnK,IAAa,IAAI,IAAI,MAAM,CAE1B;IAEQ,KAAK,IAAI,QAAQ,EAAE;IAI5B,IAAa,MAAM,IAAI,OAAO,CAE7B;IAEQ,KAAK,IAAI,UAAU;IAI5B,qCAAqC;IACtB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAIvC,KAAK,CAAC,KAAK,SAAI,EAAE,GAAG,SAAY,EAAE,WAAW,SAAK,GAAG,QAAQ;IAYtE,6EAA6E;IAC7E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;CAMhC;AAED,kEAAkE;AAClE,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAErE;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEzD,mEAAmE;AACnE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA0C;IAE1D,OAAO,CAAC,MAAM,CAAC,KAAK;IASpB,yHAAyH;IACzH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAY1D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAIhD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAI9C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAI7D,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAIhC,MAAM,IAAI,gBAAgB,CAAC,sBAAsB,CAAC;IAInD,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAIpG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAIvE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CACF;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,GAAG,MAAM,CAE/E;AASD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,EAAE,QAAQ,SAA4B,GAAG;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAU7K;AAED,oFAAoF;AACpF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,EACrC,QAAQ,SAA4B,GACnC,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAGrD;AAED,iHAAiH;AACjH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGlD"}

package/dist/blob.js

@@ -1,21 +1,35 @@
 /**
  * `Blob`, `File` and `FormData` for the native app: bytes with a type, a
- * named one, and a form whose entries `fetch` sends as multipart. A body is
- * still whole (no streams); `URL.createObjectURL` gives a `data:` URL, which
- * the host's image loader and `URLSession` both read, and
- * `revokeObjectURL` has nothing to free.
+ * named one, and a form whose entries `fetch` sends as multipart. A blob is
+ * a list of parts, each bytes in memory or a range of a file on disk (a
+ * `LazyFile`, as the pickers and drops answer), so a `Blob` built from
+ * picked files' slices holds nothing in memory and `fetch` streams it from
+ * disk (fetch.ts). `URL.createObjectURL` gives a `data:` URL, which the
+ * host's image loader and `URLSession` both read, and `revokeObjectURL` has
+ * nothing to free.
  */
 import { base64Encode, utf8Decode, utf8Encode } from './encoding';
-function partBytes(part) {
+/** A constructor part as body parts: a blob's own parts are taken as they are (a file on disk stays there). */
+function toParts(part) {
     if (typeof part === 'string')
-        return utf8Encode(part);
+        return [{ bytes: utf8Encode(part) }];
     if (part instanceof SimpleBlob)
-        return part.bytes();
+        return part.parts();
     if (part instanceof ArrayBuffer)
-        return new Uint8Array(part.slice(0));
+        return [{ bytes: new Uint8Array(part.slice(0)) }];
     if (ArrayBuffer.isView(part))
-        return new Uint8Array(part.buffer.slice(part.byteOffset, part.byteOffset + part.byteLength));
-    return utf8Encode(String(part));
+        return [{ bytes: new Uint8Array(part.buffer.slice(part.byteOffset, part.byteOffset + part.byteLength)) }];
+    return [{ bytes: utf8Encode(String(part)) }];
+}
+export const partSize = (part) => ('bytes' in part ? part.bytes.byteLength : part.file.size);
+/** Whether any part is a file on disk, which only an asynchronous read reaches. */
+export const partsAreLazy = (parts) => parts.some((part) => 'file' in part);
+/** The parts' bytes, whole: those on disk read through the files bridge. */
+export async function partsBytes(parts) {
+    const read = [];
+    for (const part of parts)
+        read.push('bytes' in part ? part.bytes : await part.file.bytesAsync());
+    return concat(read);
 }
 function concat(parts) {
     const total = parts.reduce((sum, part) => sum + part.byteLength, 0);
@@ -27,33 +41,71 @@ function concat(parts) {
     }
     return out;
 }
-/** The browser's `Blob`: bytes and a MIME type. */
+/** The browser's `Blob`: parts (bytes, or files on disk) and a MIME type. */
 export class SimpleBlob {
-    data;
+    parts_;
+    /** The parts joined, once asked for (a blob with nothing on disk). */
+    joined = null;
     type;
     constructor(parts = [], options = {}) {
-        this.data = concat([...parts].map(partBytes));
+        this.parts_ = [...parts].flatMap(toParts);
         // As the browser does: lowercased, and empty when it is not printable ASCII.
         const type = options.type ?? '';
         this.type = /^[\x20-\x7e]*$/.test(type) ? type.toLowerCase() : '';
     }
+    /** A blob straight from parts (a slice). */
+    static fromParts(parts, type) {
+        const blob = new SimpleBlob([], { type });
+        blob.parts_.push(...parts);
+        return blob;
+    }
     get size() {
-        return this.data.byteLength;
+        return this.parts_.reduce((sum, part) => sum + partSize(part), 0);
+    }
+    /** The parts, in order: what a request body sends, each from memory or from disk. */
+    parts() {
+        return [...this.parts_];
+    }
+    /** Whether any part is still on disk, so `bytes()` cannot answer and `bytesAsync()` reads it. */
+    get isLazy() {
+        return partsAreLazy(this.parts_);
     }
-    /** The bytes (a view; callers must not write into it). */
+    /** The bytes (a view; callers must not write into it). Throws for a blob holding a file on disk: read it with `bytesAsync`. */
     bytes() {
-        return this.data;
+        if (this.isLazy)
+            throw new Error('unsupported: the blob holds a picked file, which is read asynchronously (arrayBuffer); it is not in memory');
+        if (!this.joined)
+            this.joined = this.parts_.length === 1 && 'bytes' in this.parts_[0] ? this.parts_[0].bytes : concat(this.parts_.map((part) => ('bytes' in part ? part.bytes : new Uint8Array(0))));
+        return this.joined;
+    }
+    /** The bytes, the parts on disk read now. */
+    async bytesAsync() {
+        return this.isLazy ? partsBytes(this.parts_) : this.bytes();
     }
     slice(start = 0, end = this.size, contentType = '') {
-        const from = start < 0 ? Math.max(this.size + start, 0) : Math.min(start, this.size);
-        const to = end < 0 ? Math.max(this.size + end, 0) : Math.min(end, this.size);
-        return new SimpleBlob([this.data.subarray(from, Math.max(from, to))], { type: contentType });
+        const size = this.size;
+        const from = start < 0 ? Math.max(size + start, 0) : Math.min(start, size);
+        const to = Math.max(from, end < 0 ? Math.max(size + end, 0) : Math.min(end, size));
+        const out = [];
+        let at = 0;
+        for (const part of this.parts_) {
+            const length = partSize(part);
+            const partStart = at;
+            at += length;
+            if (at <= from || partStart >= to)
+                continue;
+            const a = Math.max(from, partStart) - partStart;
+            const b = Math.min(to, at) - partStart;
+            out.push('bytes' in part ? { bytes: part.bytes.subarray(a, b) } : { file: part.file.slice(a, b) });
+        }
+        return SimpleBlob.fromParts(out, contentType);
     }
     async arrayBuffer() {
-        return this.data.buffer.slice(this.data.byteOffset, this.data.byteOffset + this.data.byteLength);
+        const bytes = await this.bytesAsync();
+        return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
     }
     async text() {
-        return utf8Decode(this.data);
+        return utf8Decode(await this.bytesAsync());
     }
     get [Symbol.toStringTag]() {
         return 'Blob';
@@ -72,16 +124,93 @@ export class SimpleFile extends SimpleBlob {
         return 'File';
     }
 }
+/**
+ * A file the viewer picked or dropped, still on disk: its name, type and size
+ * are known, its bytes are read through the host's files bridge only when
+ * asked (`arrayBuffer`, `bytesAsync`, or a `fetch` body), a range at a time
+ * for a `slice`, so a large file never sits in memory whole. `fileManager.write`
+ * copies one on disk instead of reading it. `bytes()` (synchronous) is not
+ * available: it throws, as the bytes are not here.
+ */
+export class LazyFile extends SimpleFile {
+    /** The `file:` URL the host reads it at. */
+    url;
+    /** The range of the file on disk this stands for (`slice` narrows it). */
+    start;
+    end;
+    reader;
+    constructor(url, name, size, reader, options = {}, range = { start: 0, end: size }) {
+        super([], name, options);
+        this.url = url;
+        this.reader = reader;
+        this.start = range.start;
+        this.end = range.end;
+    }
+    /** Whether this is the whole file on disk, not a slice of it. */
+    get isWhole() {
+        return this.start === 0 && this.end === this.sizeOnDisk;
+    }
+    sizeOnDisk = 0;
+    /** Sets the file's size on disk (the constructor's `size`); the range defaults to all of it. */
+    static make(url, name, size, reader, options = {}) {
+        const file = new LazyFile(url, name, size, reader, options);
+        file.sizeOnDisk = size;
+        return file;
+    }
+    get size() {
+        return this.end - this.start;
+    }
+    parts() {
+        return [{ file: this }];
+    }
+    get isLazy() {
+        return true;
+    }
+    bytes() {
+        throw new Error('unsupported: a picked file is read asynchronously (arrayBuffer); it is not in memory');
+    }
+    /** The bytes, read from disk now. */
+    async bytesAsync() {
+        return this.reader(this.url, this.start, this.end);
+    }
+    slice(start = 0, end = this.size, contentType = '') {
+        const size = this.size;
+        const from = start < 0 ? Math.max(size + start, 0) : Math.min(start, size);
+        const to = end < 0 ? Math.max(size + end, 0) : Math.min(end, size);
+        const sliced = new LazyFile(this.url, this.name, this.sizeOnDisk, this.reader, { type: contentType, lastModified: this.lastModified }, {
+            start: this.start + from,
+            end: this.start + Math.max(from, to),
+        });
+        sliced.sizeOnDisk = this.sizeOnDisk;
+        return sliced;
+    }
+    /** The same file under another name (a form's `filename`), still on disk. */
+    renamed(name) {
+        const copy = new LazyFile(this.url, name, this.sizeOnDisk, this.reader, { type: this.type, lastModified: this.lastModified }, { start: this.start, end: this.end });
+        copy.sizeOnDisk = this.sizeOnDisk;
+        return copy;
+    }
+}
+/** A blob's bytes, read from disk where it holds a `LazyFile`. */
+export async function blobBytes(blob) {
+    return blob.bytesAsync();
+}
 /** The browser's `FormData`, as far as a request body needs it. */
 export class SimpleFormData {
     entries_ = [];
     static value(value, filename) {
         if (value instanceof SimpleBlob) {
             const name = filename ?? (value instanceof SimpleFile ? value.name : 'blob');
+            if (value instanceof LazyFile)
+                return filename === undefined ? value : value.renamed(filename);
             return value instanceof SimpleFile && filename === undefined ? value : new SimpleFile([value], name, { type: value.type });
         }
         return String(value);
     }
+    /** Whether an entry is a picked file still on disk (or a blob holding one), which the form's body streams from there. */
+    get hasLazyFiles() {
+        return this.entries_.some(([, value]) => typeof value !== 'string' && value.isLazy);
+    }
     append(name, value, filename) {
         this.entries_.push([String(name), SimpleFormData.value(value, filename)]);
     }
@@ -130,24 +259,45 @@ export class SimpleFormData {
         return 'FormData';
     }
 }
-/** A multipart/form-data body for the form, with the boundary `random` makes unique. */
-export function encodeMultipart(form, random) {
-    const boundary = `----SwiftBrowserFormBoundary${Array.from(random(16), (byte) => byte.toString(16).padStart(2, '0')).join('')}`;
+/** The boundary of a multipart body, unique by `random`'s bytes. */
+export function multipartBoundary(random) {
+    return `----SwiftBrowserFormBoundary${Array.from(random(16), (byte) => byte.toString(16).padStart(2, '0')).join('')}`;
+}
+function multipartHead(boundary, name, value) {
     const escape = (text) => text.replace(/\r/g, '%0D').replace(/\n/g, '%0A').replace(/"/g, '%22');
+    const head = [`--${boundary}`, `Content-Disposition: form-data; name="${escape(name)}"` + (typeof value === 'string' ? '' : `; filename="${escape(value.name)}"`)];
+    if (typeof value !== 'string')
+        head.push(`Content-Type: ${value.type || 'application/octet-stream'}`);
+    return utf8Encode(`${head.join('\r\n')}\r\n\r\n`);
+}
+/**
+ * A multipart/form-data body for the form, with the boundary `random` makes
+ * unique, as parts: the heads and the fields in memory, a file still on disk
+ * as the range of it (`fetch` streams those from disk, or reads them first
+ * for a host that cannot).
+ */
+export function encodeMultipart(form, random, boundary = multipartBoundary(random)) {
     const parts = [];
     for (const [name, value] of form.entries()) {
-        const head = [`--${boundary}`, `Content-Disposition: form-data; name="${escape(name)}"` + (typeof value === 'string' ? '' : `; filename="${escape(value.name)}"`)];
-        if (typeof value !== 'string')
-            head.push(`Content-Type: ${value.type || 'application/octet-stream'}`);
-        parts.push(utf8Encode(`${head.join('\r\n')}\r\n\r\n`));
-        parts.push(typeof value === 'string' ? utf8Encode(value) : value.bytes());
-        parts.push(utf8Encode('\r\n'));
-    }
-    parts.push(utf8Encode(`--${boundary}--\r\n`));
-    return { bytes: concat(parts), contentType: `multipart/form-data; boundary=${boundary}` };
+        parts.push({ bytes: multipartHead(boundary, name, value) });
+        if (typeof value === 'string')
+            parts.push({ bytes: utf8Encode(value) });
+        else
+            parts.push(...value.parts());
+        parts.push({ bytes: utf8Encode('\r\n') });
+    }
+    parts.push({ bytes: utf8Encode(`--${boundary}--\r\n`) });
+    return { parts, contentType: `multipart/form-data; boundary=${boundary}` };
+}
+/** `encodeMultipart` with the body whole: a form's files on disk are read first. */
+export async function encodeMultipartAsync(form, random, boundary = multipartBoundary(random)) {
+    const { parts, contentType } = encodeMultipart(form, random, boundary);
+    return { bytes: await partsBytes(parts), contentType };
 }
-/** `URL.createObjectURL`: a `data:` URL holding the blob. */
+/** `URL.createObjectURL`: a `data:` URL holding the blob; a picked file still on disk is its own `file:` URL. */
 export function objectURL(blob) {
+    if (blob instanceof LazyFile && blob.isWhole)
+        return blob.url;
     return `data:${blob.type || 'application/octet-stream'};base64,${base64Encode(blob.bytes())}`;
 }
 //# sourceMappingURL=blob.js.map