@swiftbrowser/wasm-compiler 0.0.0-stage → 0.8.0

package/dist/wasm.d.ts

@@ -0,0 +1,24 @@
+/** The custom section the Swift frontend fills with `-l` flags for the linker. */
+export declare const AUTOLINK_SECTION = ".swift1_autolink_entries";
+/** Every custom section of a module or object file, by name, in order. */
+export declare function customSections(module: Uint8Array): {
+    name: string;
+    payload: Uint8Array;
+}[];
+/**
+ * The linker flags an object asks for (`-lswiftCore` and so on), as
+ * `swift-autolink-extract` prints them: NUL-separated in the section.
+ */
+export declare function autolinkEntries(object: Uint8Array): string[];
+/**
+ * The runtime libraries `swift-autolink-extract` recognizes, in the order it
+ * prints them (lib/DriverTool/autolink_extract_main.cpp, Swift 6.4): after
+ * every other flag, each once, so a library comes before the ones it uses.
+ */
+export declare const SWIFT_RUNTIME_LIBRARIES_ORDERED: readonly string[];
+/**
+ * What `swift-autolink-extract` prints for these objects: every flag that is
+ * not a known runtime library, in order and repeats kept, then the runtime
+ * libraries any object named, once each, in SWIFT_RUNTIME_LIBRARIES_ORDERED.
+ */
+export declare function extractAutolink(objects: readonly Uint8Array[]): string[];

package/dist/wasm.js

@@ -0,0 +1,90 @@
+// Reading a WebAssembly object file's custom sections, for the autolink
+// record the Swift frontend writes into every object. `swift-autolink-extract`
+// does this for the native driver; it is a few lines here instead of one more
+// program to port. Plain Uint8Array, no Node APIs, so the browser can use it.
+// The same section layout is parsed by packages/cli/src/wasm.ts for linked
+// modules.
+const MAGIC = [0x00, 0x61, 0x73, 0x6d];
+/** The custom section the Swift frontend fills with `-l` flags for the linker. */
+export const AUTOLINK_SECTION = '.swift1_autolink_entries';
+function readLeb(bytes, pos) {
+    let result = 0;
+    let shift = 0;
+    let byte;
+    do {
+        if (pos.at >= bytes.length)
+            throw new Error('truncated LEB128 number');
+        byte = bytes[pos.at++];
+        result += (byte & 0x7f) * 2 ** shift;
+        shift += 7;
+    } while (byte & 0x80);
+    return result;
+}
+/** Every custom section of a module or object file, by name, in order. */
+export function customSections(module) {
+    if (module.length < 8 || MAGIC.some((b, i) => module[i] !== b))
+        throw new Error('not a WebAssembly module');
+    const sections = [];
+    const decoder = new TextDecoder();
+    const pos = { at: 8 };
+    while (pos.at < module.length) {
+        const id = module[pos.at++];
+        const size = readLeb(module, pos);
+        const end = pos.at + size;
+        if (end > module.length)
+            throw new Error(`section ${id} runs past the end of the module`);
+        if (id === 0) {
+            const nameLength = readLeb(module, pos);
+            const name = decoder.decode(module.subarray(pos.at, pos.at + nameLength));
+            sections.push({ name, payload: module.subarray(pos.at + nameLength, end) });
+        }
+        pos.at = end;
+    }
+    return sections;
+}
+/**
+ * The linker flags an object asks for (`-lswiftCore` and so on), as
+ * `swift-autolink-extract` prints them: NUL-separated in the section.
+ */
+export function autolinkEntries(object) {
+    const section = customSections(object).find((s) => s.name === AUTOLINK_SECTION);
+    if (!section)
+        return [];
+    return new TextDecoder().decode(section.payload).split('\0').filter((entry) => entry.length > 0);
+}
+/**
+ * The runtime libraries `swift-autolink-extract` recognizes, in the order it
+ * prints them (lib/DriverTool/autolink_extract_main.cpp, Swift 6.4): after
+ * every other flag, each once, so a library comes before the ones it uses.
+ */
+export const SWIFT_RUNTIME_LIBRARIES_ORDERED = [
+    '-lswiftSwiftOnoneSupport', '-lswiftCore', '-lswiftObservation', '-lswift_Concurrency',
+    '-lswift_StringProcessing', '-lswiftRegexBuilder', '-lswift_RegexParser', '-lswift_Builtin_float',
+    '-lswift_math', '-lswiftRuntime', '-lswiftSynchronization', '-lswiftGlibc', '-lswiftAndroid',
+    '-lswiftWASILibc', '-lBlocksRuntime', '-ldispatch', '-lDispatchStubs', '-lswiftDispatch',
+    '-l_FoundationICU', '-lCoreFoundation', '-lFoundation', '-lFoundationEssentials',
+    '-lFoundationInternationalization', '-lFoundationNetworking', '-lFoundationXML',
+    '-l_CFXMLInterface', '-l_FoundationCShims', '-l_FoundationCollections', '-lcurl', '-lxml2',
+    '-luuid', '-lTesting', '-lXCTest', '-l_TestingInternals', '-l_TestDiscovery',
+    '-l_Testing_Foundation', '-lm', '-lpthread', '-lutil', '-ldl', '-lz',
+    '-lwasi-emulated-getpid', '-lwasi-emulated-mman', '-lwasi-emulated-signal',
+];
+/**
+ * What `swift-autolink-extract` prints for these objects: every flag that is
+ * not a known runtime library, in order and repeats kept, then the runtime
+ * libraries any object named, once each, in SWIFT_RUNTIME_LIBRARIES_ORDERED.
+ */
+export function extractAutolink(objects) {
+    const runtime = new Set(SWIFT_RUNTIME_LIBRARIES_ORDERED);
+    const flags = [];
+    const seenRuntime = new Set();
+    for (const object of objects) {
+        for (const entry of autolinkEntries(object)) {
+            if (runtime.has(entry))
+                seenRuntime.add(entry);
+            else
+                flags.push(entry);
+        }
+    }
+    return [...flags, ...SWIFT_RUNTIME_LIBRARIES_ORDERED.filter((lib) => seenRuntime.has(lib))];
+}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@swiftbrowser/wasm-compiler",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.8.0",
+  "description": "Compiles Swift with the Swift compiler built as WebAssembly: a driver, WASI hosts and a CLI. See docs/in-browser-compiler.md.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/noya-app/SwiftBrowser.git",
+    "directory": "packages/wasm-compiler"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "default": "./dist/node/index.js"
+    },
+    "./plugin-executable": {
+      "types": "./dist/node/plugin-executable.d.ts",
+      "default": "./dist/node/plugin-executable.js"
+    }
+  },
+  "bin": {
+    "swiftbrowser-wasmc": "bin/swiftbrowser-wasmc.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test:unit": "vitest run",
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@bjorn3/browser_wasi_shim": "^0.4.2",
+    "@swiftbrowser/wasm-tools": "0.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.4",
+    "typescript": "^5.9.2",
+    "vitest": "^5.0.3"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}