@swiftbrowser/cli 0.1.0 → 0.2.0

package/dist/protobuf.js

@@ -0,0 +1,233 @@
+// A reader for the protocol buffers wire format, as much of it as Core ML's
+// model files need (coreml.ts): a message decodes into its fields by number,
+// and the typed accessors apply proto3's rules (a missing scalar is its zero
+// value, the last occurrence of a scalar wins, repeated numbers may be packed
+// or not). No schema, no code generation, no dependency.
+/** Wire types (the low three bits of a field's key). Groups (3, 4) are long deprecated and rejected. */
+export const WIRE_VARINT = 0;
+export const WIRE_FIXED64 = 1;
+export const WIRE_BYTES = 2;
+export const WIRE_FIXED32 = 5;
+/** A malformed message: truncated, a bad varint, an unknown wire type. */
+export class ProtobufError extends Error {
+    offset;
+    constructor(message, offset) {
+        super(offset === undefined ? message : `${message} at byte ${offset}`);
+        this.offset = offset;
+        this.name = 'ProtobufError';
+    }
+}
+/** Reads a base-128 varint at `offset`; returns the value (unsigned, at most 64 bits) and the offset after it. */
+export function readVarint(buffer, offset) {
+    let result = 0n;
+    let shift = 0n;
+    let position = offset;
+    for (;;) {
+        if (position >= buffer.length)
+            throw new ProtobufError('truncated varint', offset);
+        const byte = buffer[position];
+        position += 1;
+        result |= BigInt(byte & 0x7f) << shift;
+        if ((byte & 0x80) === 0)
+            break;
+        shift += 7n;
+        if (shift >= 70n)
+            throw new ProtobufError('varint longer than 10 bytes', offset);
+    }
+    return [BigInt.asUintN(64, result), position];
+}
+/** A decoded message: its fields by number, in the order they appeared. */
+export class ProtoMessage {
+    buffer;
+    fields = new Map();
+    constructor(buffer) {
+        this.buffer = buffer;
+        let offset = 0;
+        while (offset < buffer.length) {
+            const start = offset;
+            const [key, afterKey] = readVarint(buffer, offset);
+            offset = afterKey;
+            const number = Number(key >> 3n);
+            const wireType = Number(key & 7n);
+            if (number === 0)
+                throw new ProtobufError('field number 0', start);
+            let field;
+            switch (wireType) {
+                case WIRE_VARINT: {
+                    const [value, next] = readVarint(buffer, offset);
+                    offset = next;
+                    field = { wireType, varint: value };
+                    break;
+                }
+                case WIRE_FIXED64:
+                case WIRE_FIXED32: {
+                    const size = wireType === WIRE_FIXED64 ? 8 : 4;
+                    if (offset + size > buffer.length)
+                        throw new ProtobufError('truncated fixed-width field', start);
+                    field = { wireType, bytes: buffer.subarray(offset, offset + size) };
+                    offset += size;
+                    break;
+                }
+                case WIRE_BYTES: {
+                    const [length, next] = readVarint(buffer, offset);
+                    const end = next + Number(length);
+                    if (length > BigInt(buffer.length) || end > buffer.length)
+                        throw new ProtobufError('truncated length-delimited field', start);
+                    field = { wireType, bytes: buffer.subarray(next, end) };
+                    offset = end;
+                    break;
+                }
+                default:
+                    throw new ProtobufError(`unsupported wire type ${wireType} (field ${number})`, start);
+            }
+            let list = this.fields.get(number);
+            if (!list) {
+                list = [];
+                this.fields.set(number, list);
+            }
+            list.push(field);
+        }
+    }
+    has(number) {
+        return this.fields.has(number);
+    }
+    /** The field numbers present, ascending. */
+    numbers() {
+        return [...this.fields.keys()].sort((a, b) => a - b);
+    }
+    last(number) {
+        const list = this.fields.get(number);
+        return list?.[list.length - 1];
+    }
+    /** An embedded message (the last occurrence), or undefined when absent. */
+    message(number) {
+        const field = this.last(number);
+        if (!field)
+            return undefined;
+        return new ProtoMessage(expectBytes(field, number));
+    }
+    /** Every occurrence of a repeated message field. */
+    messages(number) {
+        return (this.fields.get(number) ?? []).map((field) => new ProtoMessage(expectBytes(field, number)));
+    }
+    /** A `bytes` field ('' → empty). */
+    bytes(number) {
+        const field = this.last(number);
+        return field ? expectBytes(field, number) : new Uint8Array();
+    }
+    /** A `string` field (UTF-8; '' when absent). */
+    string(number) {
+        return DECODER.decode(this.bytes(number));
+    }
+    /** A `repeated string` field. */
+    strings(number) {
+        return (this.fields.get(number) ?? []).map((field) => DECODER.decode(expectBytes(field, number)));
+    }
+    /** An unsigned varint field (`uint32`, `uint64`, `bool`, enums): 0n when absent. */
+    uint64(number) {
+        const field = this.last(number);
+        if (!field)
+            return 0n;
+        if (field.wireType !== WIRE_VARINT)
+            throw new ProtobufError(`field ${number} is not a varint`);
+        return field.varint;
+    }
+    /** A signed `int32` / `int64` field (two's complement, not zigzag). */
+    int64(number) {
+        return BigInt.asIntN(64, this.uint64(number));
+    }
+    /** A varint field as a JavaScript number; throws when it does not fit exactly. */
+    int(number) {
+        return safeNumber(this.int64(number), number);
+    }
+    bool(number) {
+        return this.uint64(number) !== 0n;
+    }
+    /** A `double` field: 0 when absent. */
+    double(number) {
+        const field = this.last(number);
+        if (!field)
+            return 0;
+        if (field.wireType !== WIRE_FIXED64)
+            throw new ProtobufError(`field ${number} is not a double`);
+        return view(field.bytes).getFloat64(0, true);
+    }
+    /** A `float` field: 0 when absent. */
+    float(number) {
+        const field = this.last(number);
+        if (!field)
+            return 0;
+        if (field.wireType !== WIRE_FIXED32)
+            throw new ProtobufError(`field ${number} is not a float`);
+        return view(field.bytes).getFloat32(0, true);
+    }
+    /** A `repeated double` field, packed or not. */
+    doubles(number) {
+        return this.fixedList(number, 8, (v, at) => v.getFloat64(at, true));
+    }
+    /** A `repeated float` field, packed or not. */
+    floats(number) {
+        return this.fixedList(number, 4, (v, at) => v.getFloat32(at, true));
+    }
+    /** A `repeated int64` / `uint64` / enum field, packed or not, signed. */
+    int64s(number) {
+        const out = [];
+        for (const field of this.fields.get(number) ?? []) {
+            if (field.wireType === WIRE_VARINT) {
+                out.push(BigInt.asIntN(64, field.varint));
+            }
+            else if (field.wireType === WIRE_BYTES) {
+                const bytes = field.bytes;
+                let offset = 0;
+                while (offset < bytes.length) {
+                    const [value, next] = readVarint(bytes, offset);
+                    out.push(BigInt.asIntN(64, value));
+                    offset = next;
+                }
+            }
+            else {
+                throw new ProtobufError(`field ${number} is not a varint list`);
+            }
+        }
+        return out;
+    }
+    /** `int64s` as JavaScript numbers; throws when one does not fit exactly. */
+    ints(number) {
+        return this.int64s(number).map((value) => safeNumber(value, number));
+    }
+    fixedList(number, size, read) {
+        const out = [];
+        const wire = size === 8 ? WIRE_FIXED64 : WIRE_FIXED32;
+        for (const field of this.fields.get(number) ?? []) {
+            const bytes = field.bytes;
+            if ((field.wireType !== wire && field.wireType !== WIRE_BYTES) || !bytes)
+                throw new ProtobufError(`field ${number} is not a list of ${size === 8 ? 'doubles' : 'floats'}`);
+            if (bytes.length % size !== 0)
+                throw new ProtobufError(`packed field ${number} is not a whole number of values`);
+            const v = view(bytes);
+            for (let at = 0; at < bytes.length; at += size)
+                out.push(read(v, at));
+        }
+        return out;
+    }
+}
+const DECODER = new TextDecoder('utf-8');
+function view(bytes) {
+    return new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+}
+function expectBytes(field, number) {
+    if (field.wireType !== WIRE_BYTES)
+        throw new ProtobufError(`field ${number} is not length-delimited`);
+    return field.bytes;
+}
+function safeNumber(value, number) {
+    if (value > BigInt(Number.MAX_SAFE_INTEGER) || value < BigInt(Number.MIN_SAFE_INTEGER)) {
+        throw new ProtobufError(`field ${number} holds ${value}, too large for this reader`);
+    }
+    return Number(value);
+}
+/** Decodes a message from `bytes`. */
+export function decodeMessage(bytes) {
+    return new ProtoMessage(bytes);
+}
+//# sourceMappingURL=protobuf.js.map

package/dist/protobuf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protobuf.js","sourceRoot":"","sources":["../src/protobuf.ts"],"names":[],"mappings":"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"}

package/dist/stage.d.ts

@@ -1,15 +1,36 @@
+import { type CompiledModel } from './coreml.js';
 import { type ICUData } from './icu.js';
 import type { ResolvedApp } from './project.js';
+import type { Vendored } from './vendor.js';
 export interface StagedApp {
     /** The staging package directory (holds Package.swift, Sources/, .build/). */
     dir: string;
-    /** Staged file → original file, for mapping compiler diagnostics back. */
+    /** Staged file (or copied local package folder, with a trailing separator) → the original, for mapping compiler diagnostics back. */
     originals: Map<string, string>;
     /** `#Preview` blocks removed, in total. */
     previewsStripped: number;
+    /**
+     * The `<language>.lproj` folders of string tables compiled from the app's
+     * catalogs and `.strings` files (strings.ts), published with its bundle.
+     */
+    localizations: string[];
+    /** What compiling the string tables reported. */
+    localizationWarnings: string[];
 }
-/** Where an app's staging package lives. */
+/**
+ * `$SWIFTBROWSER_BUILD_ROOT`, resolved; unset by default. With it, every app is
+ * staged at `<root>/<App>/` and built with one SwiftPM scratch path,
+ * `<root>/.build`, so a run that compiles several apps compiles the
+ * SwiftBrowser package once. SwiftPM recompiles a dependency whenever the
+ * root package's parent directory changes, so apps staged in their own
+ * projects cannot share it even with a common scratch path. One build at a
+ * time per root: SwiftPM locks the scratch path.
+ */
+export declare function buildRoot(): string | undefined;
+/** Where an app's staging package lives: `<project>/.swiftbrowser/<App>/`, or under the build root. */
 export declare function stagingDir(app: ResolvedApp): string;
+/** The `swift build` arguments that select the shared scratch path under the build root, if any. */
+export declare function scratchPathArgs(): string[];
 /** The built module, optimized or not. */
 export declare function wasmOutput(app: ResolvedApp): string;
 export interface TransformResult {
@@ -21,52 +42,155 @@ export interface TransformResult {
 /**
  * Adjusts one source for the shim without moving any line, so compiler
  * diagnostics keep their line numbers:
- * - `import SwiftUI` also imports the Foundation modules (lean: FoundationEssentials
- *   + FoundationLite; full: Foundation + FoundationBridge), as Apple's SwiftUI
- *   re-exports Foundation;
- * - lean: `import Foundation` → `import FoundationEssentials; import FoundationLite`,
- *   which is what the SwiftBrowser examples import by hand; in both modes the
- *   line also imports Observation (Apple's Foundation re-exports it, so
- *   `@Observable` works in a file that imports Foundation alone);
- * - full: `import FoundationLite` → `import FoundationBridge` (the examples'
- *   `#if canImport(FoundationEssentials)` branch, against the real Foundation);
+ * - `import SwiftUI` also imports Foundation, FoundationBridge and Observation,
+ *   as Apple's SwiftUI re-exports Foundation (and Foundation re-exports
+ *   Observation, so `@Observable` works in a file that imports either alone);
+ * - `import Foundation` also imports Observation, for the same reason, and
+ *   (`bridged`: in a module built against the bridge) FoundationBridge, whose
+ *   `URLSession`, `UserDefaults`… the alias file names: a public default
+ *   argument (`session: URLSession = .shared`) may only use a member of a
+ *   module its own file imports;
+ * - `import CoreImage.CIFilterBuiltins` → `import CoreImage`, and likewise
+ *   `import UIKit.UIImage`, `import os.log`, `import CoreGraphics.CGImage`:
+ *   on Apple platforms those are Clang submodules; the shim's frameworks are
+ *   Swift modules, which have no submodules to import;
+ * - `delegate?.urlSession?(…)` → `delegate?.urlSession(…)`: the delegate
+ *   methods are `@objc optional` on Apple platforms, plain requirements with
+ *   default implementations in FoundationBridge;
+ * - `ProcessInfo.processInfo.physicalMemory` → `_swiftBrowserPhysicalMemory` (the alias file's):
+ *   swift-foundation answers 0 on WASI, and limits sized from it refuse everything;
+ * - `import Dispatch` → `import FoundationBridge`: the SDK has no Dispatch on
+ *   WASI, and the bridge's queues run on the main actor (a package that
+ *   imports it is built from a copy, vendor.ts);
+ * - `import ObjectiveC` → `import FoundationBridge`, which has the associated
+ *   objects (CoreFoundation.swift), and `unsafeBitCast(Selector(…), to:
+ *   UnsafeRawPointer.self)` → `Selector(…)._uniquePointer`: on Apple platforms
+ *   a selector is a uniqued pointer, the usual key of an associated object;
+ *   here it is a struct, which the bit cast would trap on (`selectorPointers`;
+ *   a package that imports ObjectiveC is built from a copy, vendor.ts);
+ * - `import FoundationLite` → `import FoundationBridge`: FoundationLite was the
+ *   lean mode's formatting layer (Phase 14 folded it into Foundation); a file
+ *   that still names it gets the bridge, which holds what remains;
+ * - `configuration.delegateClass = SceneDelegate.self` records how to make
+ *   the scene delegate (`sceneDelegateClasses`);
+ * - `x as? AnyObject` → `x as? _AnyObjectValue` in a file that reads a number
+ *   off it (`.doubleValue`, `.intValue`…): Objective-C finds those members on
+ *   any object at run time, which the browser's Swift cannot (`numberCasts`);
+ * - `@objc` protocols become class-bound, with their `optional` requirements
+ *   as plain ones that have default implementations, and calls of those
+ *   requirements (`delegate?.method?(…)`, in any of the module's files:
+ *   `optionalRequirements`) plain calls; an `override` in an extension is
+ *   blanked; `#keyPath(Type.property)` becomes `"property"` (objc.ts);
+ * - `ProcessInfo()` → `ProcessInfo.processInfo`;
  * - `#Preview { … }` blocks (and `#Preview("name", traits: …) { … }`) become
  *   blank lines: the shim has no preview macro and previews are not part of
- *   the app.
+ *   the app. So do the older `struct …: PreviewProvider { … }` declarations,
+ *   which packages still carry (with preview-only modifiers inside).
  */
-export declare function transformSource(text: string, options: {
-    foundation: 'lean' | 'full';
+export declare function transformSource(text: string, options?: {
+    bridged?: boolean;
+    optionalRequirements?: ReadonlySet<string>;
 }): TransformResult;
-/** Replaces every `#Preview …{ … }` block with blank lines of the same count. */
+/**
+ * `configuration.delegateClass = SceneDelegate.self` →
+ * `configuration._setDelegateClass(SceneDelegate.self) { SceneDelegate() }`:
+ * UIKit makes the scene delegate through the Objective-C runtime, and Swift
+ * without it can only make an instance from a metatype through a `required`
+ * initializer (UIKit/SceneDelegates.swift). Same line, so diagnostics keep
+ * their places.
+ */
+export declare function sceneDelegateClasses(text: string): string;
+/**
+ * `as? AnyObject` → `as? _AnyObjectValue` where the file reads a number from
+ * the result: `(dict[key] as? AnyObject)?.doubleValue` looks the member up on
+ * any object through Objective-C (nil where there is none); FoundationBridge's
+ * `_AnyObjectValue` (Selector.swift) has those members, optional likewise, on
+ * the numbers, booleans and strings a dictionary of `Any` holds.
+ */
+export declare function numberCasts(text: string): string;
+/** Whether a source uses the Objective-C runtime's selectors or attributes. */
+export declare function usesObjC(text: string): boolean;
+/**
+ * Whether a source calls POSIX mutex functions. WASI's libc module leaves
+ * `pthread.h` out, so a package that does is built from a copy: there
+ * `#if os(iOS)` holds (Darwin's `os_unfair_lock` branch) and FoundationBridge
+ * declares the mutex functions for the page's single thread (Locks.swift).
+ */
+/**
+ * `unsafeBitCast(Selector(#function), to: UnsafeRawPointer.self)` →
+ * `Selector(#function)._uniquePointer`: the address that stands for the
+ * selector's name (FoundationBridge/Selector.swift), which on Apple
+ * platforms the bit cast gives, the selector being a uniqued pointer.
+ */
+export declare function selectorPointers(text: string): string;
+/** Whether a source imports ObjectiveC, which the SDK does not have on WASI (transformSource). */
+export declare function importsObjectiveC(text: string): boolean;
+/** Whether a source imports Dispatch, which the SDK does not have on WASI (transformSource). */
+export declare function importsDispatch(text: string): boolean;
+export declare function usesPosixMutex(text: string): boolean;
+/**
+ * Objective-C without its runtime (FoundationBridge/Selector.swift). The
+ * browser's Swift has no Objective-C interop, so `@objc` (and the Interface
+ * Builder attributes that imply it) is dropped, and `#selector(handle(_:))`
+ * becomes `Selector(Self.handle(_:), name: "handle(_:)")`: the method itself,
+ * which the target/selector APIs call on their target. A qualified method
+ * (`Type.method`) is used as it is; one of another object
+ * (`#selector(model.refresh)`) is called bound; `getter:`/`setter:`
+ * selectors only have a name. A method the file declares `@MainActor` is
+ * bound to its target in a closure instead,
+ * `Selector(name: "tick", isolated: { (target: Self) in target.tick })`:
+ * Swift 6 rejects naming a main-actor method of a class that is not
+ * `Sendable` unapplied (Gifu's display link proxy).
+ */
+export declare function rewriteObjC(text: string): string;
+/** Replaces every `#Preview …{ … }` block and `PreviewProvider` struct with blank lines of the same count. */
 export declare function stripPreviews(text: string): {
     text: string;
     count: number;
 };
 /** Index of the `}` closing the `{` at `open`, skipping strings and comments; -1 when unbalanced. */
 export declare function matchingBrace(text: string, open: number): number;
+/** What the app's sources use beyond the shim, which decides what the staging links. */
+export interface StageFeatures {
+    /**
+     * Some file imports SwiftData: the app links the SwiftData product (and so
+     * builds its macros, against swift-syntax), and the generated file routes
+     * `#Predicate` to SwiftData's copy of the macro.
+     */
+    swiftData: boolean;
+    /** The stand-in frameworks (StoreKit, CoreLocation, LocalAuthentication, CoreML, PhotosUI, CoreImage, UserNotifications, …) some file imports; each is linked. */
+    frameworks: readonly string[];
+}
+/** The features `sources` (their text) call for. */
+export declare function featuresOf(sources: readonly string[]): StageFeatures;
 /** The Package.swift of the staging package. */
-export declare function packageManifest(app: ResolvedApp, swiftPackagePath: string): string;
+export declare function packageManifest(app: ResolvedApp, swiftPackagePath: string, features?: StageFeatures, vendored?: Vendored): string;
+/** Where the compiled string tables go in the staging directory (`<language>.lproj` folders). */
+export declare const LOCALIZATION_DIR = "Localization";
 /** The staged file that settles names declared by both the shim and Foundation. */
 export declare const FULL_FOUNDATION_FILE = "_SwiftBrowserFoundation.swift";
 /**
- * In full mode the app imports both the shim and the real Foundation, and
- * both declare a few names (the shim cannot import Foundation itself, which
- * would link it into every lean app; and a module does not shadow another's
- * declarations, only the current module's do). A typealias in the app module
- * does: these point the shared names at the shim's types (what its
- * `frame(width:)` and friends take) and at FoundationBridge's `Timer` and
- * `RunLoop`, which Foundation lacks on WASI (`RunLoop` is marked unavailable,
- * its `Timer` needs CFRunLoop and does not link).
+ * The app imports both the shim and Foundation, and both declare a few names
+ * (a module does not shadow another's declarations, only the current module's
+ * do). A typealias in the app module does: these point the shared names at
+ * the shim's types (what its `frame(width:)` and friends take) and at
+ * FoundationBridge's `Timer` and `RunLoop`, which Foundation lacks on WASI
+ * (`RunLoop` is marked unavailable, its `Timer` needs CFRunLoop and does not
+ * link).
  */
-export declare function fullFoundationSource(): string;
+export declare function fullFoundationSource(features?: StageFeatures, declared?: ReadonlySet<string>): string;
+/** The type names a module's sources declare at the top level (lines that start with the declaration). */
+export declare function declaredTypeNames(sources: readonly string[]): Set<string>;
 /** The directory the staged sources keep their layout relative to. */
 export declare function commonSourceBase(app: ResolvedApp): string;
 export interface StageOptions {
     /**
-     * The trimmed ICU data for a full-Foundation wasm build (`prepareICUData`);
-     * without it a full-mode staging builds on the host only.
+     * The trimmed ICU data for a wasm build (`prepareICUData`); without it the
+     * staging builds on the host only.
      */
     icu?: ICUData | null;
+    /** The packages copied and adjusted for the shim (`vendorPackages`), by identity. */
+    vendored?: Vendored;
 }
 /**
  * Writes (or refreshes) the staging package. Files are written only when
@@ -74,5 +198,9 @@ export interface StageOptions {
  * staged files whose source is gone are removed.
  */
 export declare function stage(app: ResolvedApp, swiftPackagePath: string, options?: StageOptions): StagedApp;
+/** The staged file of a model's generated class: `<Class>.mlmodel.swift`, a name no app source has. */
+export declare function modelSourceName(model: CompiledModel): string;
+/** Compiles each Core ML model of the app (coreml.ts); two models may not make the same class. */
+export declare function compileModels(files: readonly string[]): CompiledModel[];
 /** Rewrites staged paths in compiler output back to the user's files. */
 export declare function remapDiagnostics(output: string, staged: StagedApp): string;