@thi.ng/wasm-api 1.4.9 → 1.4.11

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-06-14T07:58:51Z
+- **Last updated**: 2023-06-29T08:54:28Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,16 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+### [1.4.10](https://github.com/thi-ng/umbrella/tree/@thi.ng/wasm-api@1.4.10) (2023-06-29)
+
+#### 🩹 Bug fixes
+
+- temporarily disable `WasmLibOpts.out` due to Zig build updates ([cf63c04](https://github.com/thi-ng/umbrella/commit/cf63c04))
+
+#### ♻️ Refactoring
+
+- Zig v0.11-dev syntax updates ([83a1c7b](https://github.com/thi-ng/umbrella/commit/83a1c7b))
+
 ## [1.4.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/wasm-api@1.4.0) (2023-02-17)
 
 #### 🚀 Features

package/README.md

@@ -16,7 +16,6 @@ This project is part of the
   - [API module auto-initialization](#api-module-auto-initialization)
 - [Object indices & handles](#object-indices--handles)
 - [Using the Zig build system](#using-the-zig-build-system)
-  - [Zig v0.10.1 or older](#zig-v0101-or-older)
   - [Zig v0.11.0-dev or newer](#zig-v0110-dev-or-newer)
   - [Example projects](#example-projects)
 - [Naming & structural conventions](#naming--structural-conventions)
@@ -312,44 +311,16 @@ This package provides utilities to simplify using hybrid TS/Zig WASM API modules
 which are distributed as NPM packages. Using these utils, a build file for Zig's
 built-in build system is as simple as:
 
-### Zig v0.10.1 or older
-
-```zig
-const std = @import("std");
-
-pub fn build(b: *std.build.Builder) void {
-    // obtain a standard std.build.LibExeObjStep, pre-configured w/ given options
-    // see source comments in imported build.zig for further details...
-    var lib = @import("node_modules/@thi.ng/wasm-api/zig/build.zig").wasmLib(b, .{
-        // Declare extra WASM API packages to use
-        // Each package can also declare dependencies to other such packages
-        // (wasm-api and wasm-api-bindgen are made available everywhere)
-        .packages = &.{
-            .{ .id = "wasm-api-dom", .path = "@thi.ng/wasm-api-dom/zig/lib.zig" },
-            .{ .id = "wasm-api-schedule", .path = "@thi.ng/wasm-api-schedule/zig/lib.zig" },
-        },
-        // (optional) build mode override
-        // if commented out, we can pass CLI args to choose build mode (default: .Debug)
-        .mode = .ReleaseSmall,
-    });
-    // optionally, add further custom configuration
-    // ...
-
-    // finally trigger build
-    lib.install();
-}
-```
-
 ### Zig v0.11.0-dev or newer
 
-(Note: Several new build options have been added, e.g. initial/max memory
-config, autodoc generation)
+**IMPORTANT:** Due to recent syntax changes in Zig v0.11-dev, support for Zig
+v0.10.1 or older had to be removed...
 
 ```zig
 const std = @import("std");
 
 pub fn build(b: *std.Build) void {
-    // obtain a standard std.Build.CompileStep, pre-configured w/ given options
+    // obtain a standard std.Build.Step.Compile, pre-configured w/ given options
     // see source comments in imported build-v0.11.zig for further details...
     var lib = @import("node_modules/@thi.ng/wasm-api/zig/build-v0.11.zig").wasmLib(b, .{
         // Declare extra WASM API modules to use
@@ -366,8 +337,8 @@ pub fn build(b: *std.Build) void {
     // optionally, add further custom configuration
     // ...
 
-    // finally trigger build
-    lib.install();
+    // finally trigger build & install
+    b.installArtifact(lib);
 }
 ```
 
@@ -378,7 +349,7 @@ via this script. **Please find more details/options in the commented source
 code:**
 
 - [`/zig/build.zig`](https://github.com/thi-ng/umbrella/blob/develop/packages/wasm-api/zig/build.zig)
-- [`/zig/build-v0.11.zig`](https://github.com/thi-ng/umbrella/blob/develop/packages/wasm-api/zig/build-v0.11.zig)
+- [`/zig/build-v0.10.zig`](https://github.com/thi-ng/umbrella/blob/develop/packages/wasm-api/zig/build-v0.10.zig)
 
 ## Naming & structural conventions
 
@@ -501,7 +472,7 @@ folder):
 zig build-lib \
     --pkg-begin wasm-api node_modules/@thi.ng/wasm-api/zig/lib.zig --pkg-end \
     -target wasm32-freestanding \
-    -O ReleaseSmall -dynamic \
+    -O ReleaseSmall -dynamic -rdynamic \
     hello.zig
 
 # disassemble WASM

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/wasm-api",
-  "version": "1.4.9",
+  "version": "1.4.11",
   "description": "Generic, modular, extensible API bridge and infrastructure for hybrid JS & WebAssembly projects",
   "type": "module",
   "module": "./index.js",
@@ -115,5 +115,5 @@
     "status": "alpha",
     "year": 2022
   },
-  "gitHead": "54e825a976c72067a244cff8725ca98f5416d26d\n"
+  "gitHead": "b363e93fb1b9e754957309ab582bba16b8e187ca\n"
 }

package/zig/build-v0.10.zig

@@ -0,0 +1,141 @@
+//! DEPRECATED build helpers for using modules/packages distributed via NPM
+//! Intended for use with https://thi.ng/wasm-api and support packages
+//!
+//! This version of the script is only compatible with Zig v0.10.1 or older
+//! Use build-v0.11.zig (in this same directory) for newer Zig versions
+
+const std = @import("std");
+
+/// Definition for a (usually hybrid) Zig package which will be distributed via NPM
+pub const Pkg = struct {
+    /// Package ID used for @import
+    id: []const u8,
+    /// Package sub path (appended to base path)
+    path: []const u8,
+    /// Package dependencies aka other package IDs.
+    /// All of them must already have been registered
+    deps: ?[]const []const u8 = null,
+};
+
+pub const PkgOpts = struct {
+    /// Base path to common node_modules directory under which
+    /// all to be imported packages are located
+    base: []const u8 = "node_modules",
+    /// Additional WASM API support packages.
+    /// We don't need to specify core wasmapi, only custom/extra ones
+    /// `wasm-api` and `wasm-api-bindgen` are also auto-added
+    /// as dependency for each of these...
+    packages: ?[]const Pkg = null,
+};
+
+/// Dependency graph for WASM API packages
+/// Expands & resolves the more compact/convenient/human friendly format of PkgOpts
+/// into the data structures used by Zig's build system
+/// Provides a `addAllTo()` function to add all declared packages to a build step
+pub const PkgGraph = struct {
+    arena: std.heap.ArenaAllocator,
+    basePath: []const u8,
+    packages: std.StringArrayHashMap(std.build.Pkg),
+
+    const Self = @This();
+
+    pub fn init(opts: PkgOpts) Self {
+        var arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
+        var self = Self{
+            .arena = arena,
+            .basePath = opts.base,
+            .packages = std.StringArrayHashMap(std.build.Pkg).init(arena.allocator()),
+        };
+        const api = "wasm-api";
+        self.packages.put(api, .{
+            .name = api,
+            .source = .{ .path = self.modulePath("@thi.ng/wasm-api/zig/lib.zig") },
+        }) catch unreachable;
+        const apiTypes = "wasm-api-bindgen";
+        self.packages.put(apiTypes, .{
+            .name = apiTypes,
+            .source = .{ .path = self.modulePath("@thi.ng/wasm-api-bindgen/zig/lib.zig") },
+        }) catch unreachable;
+        if (opts.packages) |pkgs| {
+            for (pkgs) |pkg| {
+                self.register(pkg.id, pkg.path, pkg.deps);
+            }
+        }
+        return self;
+    }
+
+    pub fn deinit(self: *const Self) void {
+        self.arena.deinit();
+    }
+
+    /// Registers a single package and its deps (also injects core wasm-api deps)
+    pub fn register(
+        self: *Self,
+        name: []const u8,
+        path: []const u8,
+        dependencies: ?[]const []const u8,
+    ) void {
+        var pkg = std.build.Pkg{
+            .name = name,
+            .source = .{ .path = self.modulePath(path) },
+        };
+        const num = if (dependencies) |deps| deps.len else 0;
+        var dpkgs = self.arena.allocator().alloc(std.build.Pkg, num + 2) catch unreachable;
+        dpkgs[0] = if (self.packages.get("wasm-api")) |p| p else unreachable;
+        dpkgs[1] = if (self.packages.get("wasm-api-bindgen")) |p| p else unreachable;
+        if (dependencies) |deps| {
+            var i: usize = 0;
+            while (i < deps.len) : (i += 1) {
+                if (self.packages.get(deps[i])) |p| {
+                    dpkgs[i + 1] = p;
+                } else @panic("unknown dependency");
+            }
+        }
+        pkg.dependencies = dpkgs;
+        self.packages.put(name, pkg) catch unreachable;
+    }
+
+    /// Adds all registered packages to the given build step
+    pub fn addAllTo(self: *const Self, step: *std.build.LibExeObjStep) void {
+        for (self.packages.values()) |pkg| step.addPackage(pkg);
+    }
+
+    fn modulePath(self: *Self, path: []const u8) []const u8 {
+        return std.fs.path.join(self.arena.allocator(), &.{ self.basePath, path }) catch unreachable;
+    }
+};
+
+/// Config options
+pub const WasmLibOpts = struct {
+    /// Relative path to base directory for WASM API packages
+    base: []const u8 = "node_modules",
+    /// Relative path to root source file
+    root: []const u8 = "zig/main.zig",
+    /// Relative path to output directory
+    out: []const u8 = "src",
+    /// Package definitions for additional WASM API modules
+    packages: ?[]const Pkg = null,
+    /// Build mode override (else allows config via CLI args)
+    mode: ?std.builtin.Mode = null,
+    /// Additional WASM target features, e.g. `.simd128` to enable SIMD
+    features: ?[]const std.Target.wasm.Feature = null,
+};
+
+/// Creates and returns a build step to build a dynamic WASM library, configured
+/// with given options and package declarations. The given package specs will be inserted
+pub fn wasmLib(b: *std.build.Builder, opts: WasmLibOpts) *std.build.LibExeObjStep {
+    const lib = b.addSharedLibrary("main", opts.root, .unversioned);
+    lib.setTarget(.{
+        .cpu_arch = .wasm32,
+        .os_tag = .freestanding,
+        .cpu_features_add = if (opts.features) |features| std.Target.wasm.featureSet(features) else std.Target.Cpu.Feature.Set.empty,
+    });
+    const mode = if (opts.mode) |m| m else b.standardReleaseOptions();
+    lib.setBuildMode(mode);
+    if (mode == .ReleaseSmall or mode == .ReleaseFast) lib.strip = true;
+    const pkgs = PkgGraph.init(.{ .base = opts.base, .packages = opts.packages });
+    defer pkgs.deinit();
+    pkgs.addAllTo(lib);
+    lib.setOutputDir(opts.out);
+    return lib;
+}

package/zig/build.zig

@@ -1,141 +1,132 @@
 //! Build helpers for using modules/packages distributed via NPM
 //! Intended for use with https://thi.ng/wasm-api and support packages
 //!
-//! This version of the script is only compatible with Zig v0.10.1 or older
-//! Use build-v0.11.zig (in this same directory) for newer Zig versions
+//! This version of the script is only compatible with:
+//! Zig v0.11.0-dev.2266+49e33a2f2 or newer
+//!
+//! Use build.zig (in this same directory) for earlier Zig versions
 
 const std = @import("std");
-
-/// Definition for a (usually hybrid) Zig package which will be distributed via NPM
-pub const Pkg = struct {
-    /// Package ID used for @import
-    id: []const u8,
-    /// Package sub path (appended to base path)
-    path: []const u8,
-    /// Package dependencies aka other package IDs.
-    /// All of them must already have been registered
-    deps: ?[]const []const u8 = null,
-};
-
-pub const PkgOpts = struct {
-    /// Base path to common node_modules directory under which
-    /// all to be imported packages are located
-    base: []const u8 = "node_modules",
-    /// Additional WASM API support packages.
-    /// We don't need to specify core wasmapi, only custom/extra ones
-    /// `wasm-api` and `wasm-api-bindgen` are also auto-added
-    /// as dependency for each of these...
-    packages: ?[]const Pkg = null,
-};
-
-/// Dependency graph for WASM API packages
-/// Expands & resolves the more compact/convenient/human friendly format of PkgOpts
-/// into the data structures used by Zig's build system
-/// Provides a `addAllTo()` function to add all declared packages to a build step
-pub const PkgGraph = struct {
-    arena: std.heap.ArenaAllocator,
-    basePath: []const u8,
-    packages: std.StringArrayHashMap(std.build.Pkg),
-
-    const Self = @This();
-
-    pub fn init(opts: PkgOpts) Self {
-        var arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
-        var self = Self{
-            .arena = arena,
-            .basePath = opts.base,
-            .packages = std.StringArrayHashMap(std.build.Pkg).init(arena.allocator()),
-        };
-        const api = "wasm-api";
-        self.packages.put(api, .{
-            .name = api,
-            .source = .{ .path = self.modulePath("@thi.ng/wasm-api/zig/lib.zig") },
-        }) catch unreachable;
-        const apiTypes = "wasm-api-bindgen";
-        self.packages.put(apiTypes, .{
-            .name = apiTypes,
-            .source = .{ .path = self.modulePath("@thi.ng/wasm-api-bindgen/zig/lib.zig") },
-        }) catch unreachable;
-        if (opts.packages) |pkgs| {
-            for (pkgs) |pkg| {
-                self.register(pkg.id, pkg.path, pkg.deps);
-            }
-        }
-        return self;
-    }
-
-    pub fn deinit(self: *const Self) void {
-        self.arena.deinit();
-    }
-
-    /// Registers a single package and its deps (also injects core wasm-api deps)
-    pub fn register(
-        self: *Self,
-        name: []const u8,
-        path: []const u8,
-        dependencies: ?[]const []const u8,
-    ) void {
-        var pkg = std.build.Pkg{
-            .name = name,
-            .source = .{ .path = self.modulePath(path) },
-        };
-        const num = if (dependencies) |deps| deps.len else 0;
-        var dpkgs = self.arena.allocator().alloc(std.build.Pkg, num + 2) catch unreachable;
-        dpkgs[0] = if (self.packages.get("wasm-api")) |p| p else unreachable;
-        dpkgs[1] = if (self.packages.get("wasm-api-bindgen")) |p| p else unreachable;
-        if (dependencies) |deps| {
-            var i: usize = 0;
-            while (i < deps.len) : (i += 1) {
-                if (self.packages.get(deps[i])) |p| {
-                    dpkgs[i + 1] = p;
-                } else @panic("unknown dependency");
-            }
-        }
-        pkg.dependencies = dpkgs;
-        self.packages.put(name, pkg) catch unreachable;
-    }
-
-    /// Adds all registered packages to the given build step
-    pub fn addAllTo(self: *const Self, step: *std.build.LibExeObjStep) void {
-        for (self.packages.values()) |pkg| step.addPackage(pkg);
-    }
-
-    fn modulePath(self: *Self, path: []const u8) []const u8 {
-        return std.fs.path.join(self.arena.allocator(), &.{ self.basePath, path }) catch unreachable;
-    }
-};
+const Build = std.Build;
 
 /// Config options
 pub const WasmLibOpts = struct {
-    /// Relative path to base directory for WASM API packages
+    /// Base path to common node_modules directory under which
+    /// all to be imported modules are located
     base: []const u8 = "node_modules",
     /// Relative path to root source file
     root: []const u8 = "zig/main.zig",
-    /// Relative path to output directory
+    /// CURRENTLY UNUSED - Relative path to output directory
     out: []const u8 = "src",
-    /// Package definitions for additional WASM API modules
-    packages: ?[]const Pkg = null,
+    /// Additional WASM API support modules.
+    /// Only need to specify custom/extra modules
+    /// `wasm-api` and `wasm-api-bindgen` are auto-added as dependency for all...
+    modules: ?[]const ModuleSpec = null,
     /// Build mode override (else allows config via CLI args)
-    mode: ?std.builtin.Mode = null,
+    optimize: ?std.builtin.Mode = null,
     /// Additional WASM target features, e.g. `.simd128` to enable SIMD
     features: ?[]const std.Target.wasm.Feature = null,
+    /// Initial memory (in bytes, MUST be multiple of 0x10000)
+    initialMemory: ?u64 = null,
+    /// Max memory (in bytes, MUST be multiple of 0x10000)
+    maxMemory: ?u64 = null,
+    /// If true, build will also generate docs
+    docs: bool = false,
+};
+
+/// WASM API sub-module declaration
+pub const ModuleSpec = struct {
+    /// module import name/ID
+    name: []const u8,
+    /// Relative path to configured base path
+    path: []const u8,
+    /// Module IDs of other modules this module depends on
+    /// Only need to specify custom/extra modules
+    /// `wasm-api` and `wasm-api-bindgen` are auto-added as dependency for all...
+    dependencies: ?[]const []const u8 = null,
 };
 
+const wasmapi = "wasm-api";
+const wasmbind = "wasm-api-bindgen";
+
 /// Creates and returns a build step to build a dynamic WASM library, configured
 /// with given options and package declarations. The given package specs will be inserted
-pub fn wasmLib(b: *std.build.Builder, opts: WasmLibOpts) *std.build.LibExeObjStep {
-    const lib = b.addSharedLibrary("main", opts.root, .unversioned);
-    lib.setTarget(.{
-        .cpu_arch = .wasm32,
-        .os_tag = .freestanding,
-        .cpu_features_add = if (opts.features) |features| std.Target.wasm.featureSet(features) else std.Target.Cpu.Feature.Set.empty,
+pub fn wasmLib(b: *Build, opts: WasmLibOpts) *Build.Step.Compile {
+    const lib = b.addSharedLibrary(.{
+        .name = "main",
+        .root_source_file = .{ .path = opts.root },
+        .target = .{
+            .cpu_arch = .wasm32,
+            .os_tag = .freestanding,
+            .cpu_features_add = if (opts.features) |features| std.Target.wasm.featureSet(features) else std.Target.Cpu.Feature.Set.empty,
+        },
+        .optimize = if (opts.optimize) |m| m else b.standardOptimizeOption(.{}),
     });
-    const mode = if (opts.mode) |m| m else b.standardReleaseOptions();
-    lib.setBuildMode(mode);
-    if (mode == .ReleaseSmall or mode == .ReleaseFast) lib.strip = true;
-    const pkgs = PkgGraph.init(.{ .base = opts.base, .packages = opts.packages });
-    defer pkgs.deinit();
-    pkgs.addAllTo(lib);
-    lib.setOutputDir(opts.out);
+    if (lib.optimize == .ReleaseSmall or lib.optimize == .ReleaseFast) lib.strip = true;
+
+    // FIXME re-enable once workaround has been identified
+    // lib.setOutputDir(opts.out);
+
+    // build flags
+    lib.rdynamic = true;
+    lib.import_symbols = true;
+    lib.initial_memory = opts.initialMemory;
+    lib.max_memory = opts.maxMemory;
+    if (opts.docs) lib.emit_docs = .emit;
+
+    // add default dependencies
+    lib.addModule(
+        wasmapi,
+        b.createModule(.{
+            .source_file = modulePath(b.allocator, opts.base, "@thi.ng/wasm-api/zig/lib.zig"),
+        }),
+    );
+    lib.addModule(
+        wasmbind,
+        b.createModule(.{
+            .source_file = modulePath(b.allocator, opts.base, "@thi.ng/wasm-api-bindgen/zig/lib.zig"),
+        }),
+    );
+    if (opts.modules) |modules| {
+        for (modules) |mod| {
+            register(lib, mod, opts);
+        }
+    }
     return lib;
 }
+
+/// Registers a single package and its deps (also injects core wasm-api deps)
+pub fn register(step: *Build.CompileStep, mod: ModuleSpec, opts: WasmLibOpts) void {
+    const num = if (mod.dependencies) |ids| ids.len else 0;
+    var dpkgs = step.step.owner.allocator.alloc(Build.ModuleDependency, num + 2) catch unreachable;
+    dpkgs[0] = if (step.modules.get(wasmapi)) |m| .{ .name = wasmapi, .module = m } else unreachable;
+    dpkgs[1] = if (step.modules.get(wasmbind)) |m| .{ .name = wasmbind, .module = m } else unreachable;
+    var i: usize = 2;
+    if (mod.dependencies) |ids| {
+        for (ids) |id| {
+            if (step.modules.get(id)) |m| {
+                if (isDuplicateId(dpkgs[0..i], id)) {
+                    std.log.info("ignoring duplicate dependency: {s}", .{id});
+                    continue;
+                }
+                dpkgs[i] = .{ .name = id, .module = m };
+                i += 1;
+            } else @panic("unknown dependency");
+        }
+    }
+    step.addModule(mod.name, step.step.owner.createModule(.{
+        .source_file = modulePath(step.step.owner.allocator, opts.base, mod.path),
+        .dependencies = dpkgs[0..i],
+    }));
+}
+
+fn isDuplicateId(deps: []Build.ModuleDependency, name: []const u8) bool {
+    for (deps) |d| {
+        if (std.mem.eql(u8, d.name, name)) return true;
+    }
+    return false;
+}
+
+fn modulePath(allocator: std.mem.Allocator, base: []const u8, path: []const u8) Build.FileSource {
+    return .{ .path = std.fs.path.join(allocator, &.{ base, path }) catch unreachable };
+}

package/zig/lib.zig

@@ -13,7 +13,7 @@ pub fn ptrCast(comptime T: type, ptr: ?*anyopaque) ?T {
     if (ptr == null) return null;
     const info = @typeInfo(T);
     if (info != .Pointer) @compileError("require pointer type");
-    return @ptrCast(T, @alignCast(@alignOf(info.Pointer.child), ptr));
+    return @ptrCast(@alignCast(ptr));
 }
 
 /// JS external part of the custom panic handler
@@ -52,7 +52,7 @@ pub inline fn allocator() ?std.mem.Allocator {
 pub export fn _wasm_allocate(numBytes: usize) usize {
     if (allocator()) |alloc| {
         var mem = alloc.alignedAlloc(u8, 16, numBytes) catch return 0;
-        return @ptrToInt(mem.ptr);
+        return @intFromPtr(mem.ptr);
     }
     return 0;
 }
@@ -62,8 +62,8 @@ pub export fn _wasm_allocate(numBytes: usize) usize {
 /// Note: This is a no-op if no allocator is configured (see `allocator()`)
 pub export fn _wasm_free(addr: [*]u8, numBytes: usize) void {
     if (allocator()) |alloc| {
-        var mem = [2]usize{ @ptrToInt(addr), numBytes };
-        alloc.free(@ptrCast(*[]u8, &mem).*);
+        var mem = [2]usize{ @intFromPtr(addr), numBytes };
+        alloc.free(@as(*[]u8, @ptrCast(&mem)).*);
     }
 }
 
@@ -102,7 +102,7 @@ pub extern "wasmapi" fn printF64(x: f64) void;
 
 /// Prints pointer as hex number using configured JS logger
 pub fn printPtr(ptr: *const anyopaque) void {
-    printU32Hex(@ptrToInt(ptr));
+    printU32Hex(@intFromPtr(ptr));
 }
 
 /// Prints number array using configured JS logger

package/zig/managed-index.zig

@@ -68,12 +68,12 @@ pub fn ManagedIndex(comptime T: type, comptime I: type) type {
                 self.freeID = self.list.items[id].id;
                 self.list.items[id] = .{ .value = item };
                 self.used += 1;
-                return @intCast(I, id);
+                return @intCast(id);
             } else {
                 const id = self.list.items.len;
                 try self.list.append(.{ .value = item });
                 self.used += 1;
-                return @intCast(I, id);
+                return @intCast(id);
             }
         }
 

package/zig/build-v0.11.zig

@@ -1,128 +0,0 @@
-//! Build helpers for using modules/packages distributed via NPM
-//! Intended for use with https://thi.ng/wasm-api and support packages
-//!
-//! This version of the script is only compatible with:
-//! Zig v0.11.0-dev.2266+49e33a2f2 or newer
-//!
-//! Use build.zig (in this same directory) for earlier Zig versions
-
-const std = @import("std");
-const Build = std.Build;
-
-/// Config options
-pub const WasmLibOpts = struct {
-    /// Base path to common node_modules directory under which
-    /// all to be imported modules are located
-    base: []const u8 = "node_modules",
-    /// Relative path to root source file
-    root: []const u8 = "zig/main.zig",
-    /// Relative path to output directory
-    out: []const u8 = "src",
-    /// Additional WASM API support modules.
-    /// Only need to specify custom/extra modules
-    /// `wasm-api` and `wasm-api-bindgen` are auto-added as dependency for all...
-    modules: ?[]const ModuleSpec = null,
-    /// Build mode override (else allows config via CLI args)
-    optimize: ?std.builtin.Mode = null,
-    /// Additional WASM target features, e.g. `.simd128` to enable SIMD
-    features: ?[]const std.Target.wasm.Feature = null,
-    /// Initial memory (in bytes, MUST be multiple of 0x10000)
-    initialMemory: ?u64 = null,
-    /// Max memory (in bytes, MUST be multiple of 0x10000)
-    maxMemory: ?u64 = null,
-    /// If true, build will also generate docs
-    docs: bool = false,
-};
-
-/// WASM API sub-module declaration
-pub const ModuleSpec = struct {
-    /// module import name/ID
-    name: []const u8,
-    /// Relative path to configured base path
-    path: []const u8,
-    /// Module IDs of other modules this module depends on
-    /// Only need to specify custom/extra modules
-    /// `wasm-api` and `wasm-api-bindgen` are auto-added as dependency for all...
-    dependencies: ?[]const []const u8 = null,
-};
-
-const wasmapi = "wasm-api";
-const wasmbind = "wasm-api-bindgen";
-
-/// Creates and returns a build step to build a dynamic WASM library, configured
-/// with given options and package declarations. The given package specs will be inserted
-pub fn wasmLib(b: *Build, opts: WasmLibOpts) *Build.CompileStep {
-    const lib = b.addSharedLibrary(.{
-        .name = "main",
-        .root_source_file = .{ .path = opts.root },
-        .target = .{
-            .cpu_arch = .wasm32,
-            .os_tag = .freestanding,
-            .cpu_features_add = if (opts.features) |features| std.Target.wasm.featureSet(features) else std.Target.Cpu.Feature.Set.empty,
-        },
-        .optimize = if (opts.optimize) |m| m else b.standardOptimizeOption(.{}),
-    });
-    if (lib.optimize == .ReleaseSmall or lib.optimize == .ReleaseFast) lib.strip = true;
-    lib.setOutputDir(opts.out);
-    // build flags
-    lib.rdynamic = true;
-    lib.import_symbols = true;
-    lib.initial_memory = opts.initialMemory;
-    lib.max_memory = opts.maxMemory;
-    if (opts.docs) lib.emit_docs = .emit;
-    // add default dependencies
-    lib.addModule(
-        wasmapi,
-        b.createModule(.{
-            .source_file = modulePath(b.allocator, opts.base, "@thi.ng/wasm-api/zig/lib.zig"),
-        }),
-    );
-    lib.addModule(
-        wasmbind,
-        b.createModule(.{
-            .source_file = modulePath(b.allocator, opts.base, "@thi.ng/wasm-api-bindgen/zig/lib.zig"),
-        }),
-    );
-    if (opts.modules) |modules| {
-        for (modules) |mod| {
-            register(lib, mod, opts);
-        }
-    }
-    return lib;
-}
-
-/// Registers a single package and its deps (also injects core wasm-api deps)
-pub fn register(step: *Build.CompileStep, mod: ModuleSpec, opts: WasmLibOpts) void {
-    const num = if (mod.dependencies) |ids| ids.len else 0;
-    var dpkgs = step.step.owner.allocator.alloc(Build.ModuleDependency, num + 2) catch unreachable;
-    dpkgs[0] = if (step.modules.get(wasmapi)) |m| .{ .name = wasmapi, .module = m } else unreachable;
-    dpkgs[1] = if (step.modules.get(wasmbind)) |m| .{ .name = wasmbind, .module = m } else unreachable;
-    var i: usize = 2;
-    if (mod.dependencies) |ids| {
-        for (ids) |id| {
-            if (step.modules.get(id)) |m| {
-                if (isDuplicateId(dpkgs[0..i], id)) {
-                    std.log.info("ignoring duplicate dependency: {s}", .{id});
-                    continue;
-                }
-                dpkgs[i] = .{ .name = id, .module = m };
-                i += 1;
-            } else @panic("unknown dependency");
-        }
-    }
-    step.addModule(mod.name, step.step.owner.createModule(.{
-        .source_file = modulePath(step.step.owner.allocator, opts.base, mod.path),
-        .dependencies = dpkgs[0..i],
-    }));
-}
-
-fn isDuplicateId(deps: []Build.ModuleDependency, name: []const u8) bool {
-    for (deps) |d| {
-        if (std.mem.eql(u8, d.name, name)) return true;
-    }
-    return false;
-}
-
-fn modulePath(allocator: std.mem.Allocator, base: []const u8, path: []const u8) Build.FileSource {
-    return .{ .path = std.fs.path.join(allocator, &.{ base, path }) catch unreachable };
-}

package/zig/zig-cache/o/2c5b3cc6481e0814680f4a94232505ec/dependencies.zig

@@ -1,4 +0,0 @@
-pub const imports = struct {
-};
-pub const build_root = struct {
-};

package/zig/zig-cache/o/3badba3a6b220350270427b08f0d6826/builtin.zig

@@ -1,115 +0,0 @@
-const std = @import("std");
-/// Zig version. When writing code that supports multiple versions of Zig, prefer
-/// feature detection (i.e. with `@hasDecl` or `@hasField`) over version checks.
-pub const zig_version = std.SemanticVersion.parse(zig_version_string) catch unreachable;
-pub const zig_version_string = "0.11.0-dev.2271+3a7fe0d01";
-pub const zig_backend = std.builtin.CompilerBackend.stage2_llvm;
-
-pub const output_mode = std.builtin.OutputMode.Exe;
-pub const link_mode = std.builtin.LinkMode.Dynamic;
-pub const is_test = false;
-pub const single_threaded = false;
-pub const abi = std.Target.Abi.none;
-pub const cpu: std.Target.Cpu = .{
-    .arch = .aarch64,
-    .model = &std.Target.aarch64.cpu.apple_a14,
-    .features = std.Target.aarch64.featureSet(&[_]std.Target.aarch64.Feature{
-        .aes,
-        .aggressive_fma,
-        .alternate_sextload_cvt_f32_pattern,
-        .altnzcv,
-        .am,
-        .arith_bcc_fusion,
-        .arith_cbz_fusion,
-        .ccdp,
-        .ccidx,
-        .ccpp,
-        .complxnum,
-        .contextidr_el2,
-        .crc,
-        .crypto,
-        .disable_latency_sched_heuristic,
-        .dit,
-        .dotprod,
-        .el2vmsa,
-        .el3,
-        .flagm,
-        .fp16fml,
-        .fp_armv8,
-        .fptoint,
-        .fullfp16,
-        .fuse_address,
-        .fuse_adrp_add,
-        .fuse_aes,
-        .fuse_arith_logic,
-        .fuse_crypto_eor,
-        .fuse_csel,
-        .fuse_literals,
-        .jsconv,
-        .lor,
-        .lse,
-        .lse2,
-        .mpam,
-        .neon,
-        .nv,
-        .pan,
-        .pan_rwv,
-        .pauth,
-        .perfmon,
-        .predres,
-        .ras,
-        .rcpc,
-        .rcpc_immo,
-        .rdm,
-        .sb,
-        .sel2,
-        .sha2,
-        .sha3,
-        .specrestrict,
-        .ssbs,
-        .tlb_rmi,
-        .tracev8_4,
-        .uaops,
-        .v8_1a,
-        .v8_2a,
-        .v8_3a,
-        .v8_4a,
-        .v8a,
-        .vh,
-        .zcm,
-        .zcz,
-        .zcz_gp,
-    }),
-};
-pub const os = std.Target.Os{
-    .tag = .macos,
-    .version_range = .{ .semver = .{
-        .min = .{
-            .major = 12,
-            .minor = 6,
-            .patch = 0,
-        },
-        .max = .{
-            .major = 12,
-            .minor = 6,
-            .patch = 0,
-        },
-    }},
-};
-pub const target = std.Target{
-    .cpu = cpu,
-    .os = os,
-    .abi = abi,
-    .ofmt = object_format,
-};
-pub const object_format = std.Target.ObjectFormat.macho;
-pub const mode = std.builtin.Mode.Debug;
-pub const link_libc = true;
-pub const link_libcpp = false;
-pub const have_error_return_tracing = true;
-pub const valgrind_support = false;
-pub const sanitize_thread = false;
-pub const position_independent_code = true;
-pub const position_independent_executable = true;
-pub const strip_debug_info = false;
-pub const code_model = std.builtin.CodeModel.default;

package/zig/zig-cache/o/436d1d779b9beb6e530e684e246a5d30/builtin.zig

@@ -1,115 +0,0 @@
-const std = @import("std");
-/// Zig version. When writing code that supports multiple versions of Zig, prefer
-/// feature detection (i.e. with `@hasDecl` or `@hasField`) over version checks.
-pub const zig_version = std.SemanticVersion.parse(zig_version_string) catch unreachable;
-pub const zig_version_string = "0.11.0-dev.2460+55a8b7e1f";
-pub const zig_backend = std.builtin.CompilerBackend.stage2_llvm;
-
-pub const output_mode = std.builtin.OutputMode.Exe;
-pub const link_mode = std.builtin.LinkMode.Dynamic;
-pub const is_test = false;
-pub const single_threaded = false;
-pub const abi = std.Target.Abi.none;
-pub const cpu: std.Target.Cpu = .{
-    .arch = .aarch64,
-    .model = &std.Target.aarch64.cpu.apple_a14,
-    .features = std.Target.aarch64.featureSet(&[_]std.Target.aarch64.Feature{
-        .aes,
-        .aggressive_fma,
-        .alternate_sextload_cvt_f32_pattern,
-        .altnzcv,
-        .am,
-        .arith_bcc_fusion,
-        .arith_cbz_fusion,
-        .ccdp,
-        .ccidx,
-        .ccpp,
-        .complxnum,
-        .contextidr_el2,
-        .crc,
-        .crypto,
-        .disable_latency_sched_heuristic,
-        .dit,
-        .dotprod,
-        .el2vmsa,
-        .el3,
-        .flagm,
-        .fp16fml,
-        .fp_armv8,
-        .fptoint,
-        .fullfp16,
-        .fuse_address,
-        .fuse_adrp_add,
-        .fuse_aes,
-        .fuse_arith_logic,
-        .fuse_crypto_eor,
-        .fuse_csel,
-        .fuse_literals,
-        .jsconv,
-        .lor,
-        .lse,
-        .lse2,
-        .mpam,
-        .neon,
-        .nv,
-        .pan,
-        .pan_rwv,
-        .pauth,
-        .perfmon,
-        .predres,
-        .ras,
-        .rcpc,
-        .rcpc_immo,
-        .rdm,
-        .sb,
-        .sel2,
-        .sha2,
-        .sha3,
-        .specrestrict,
-        .ssbs,
-        .tlb_rmi,
-        .tracev8_4,
-        .uaops,
-        .v8_1a,
-        .v8_2a,
-        .v8_3a,
-        .v8_4a,
-        .v8a,
-        .vh,
-        .zcm,
-        .zcz,
-        .zcz_gp,
-    }),
-};
-pub const os = std.Target.Os{
-    .tag = .macos,
-    .version_range = .{ .semver = .{
-        .min = .{
-            .major = 13,
-            .minor = 3,
-            .patch = 1,
-        },
-        .max = .{
-            .major = 13,
-            .minor = 3,
-            .patch = 1,
-        },
-    }},
-};
-pub const target = std.Target{
-    .cpu = cpu,
-    .os = os,
-    .abi = abi,
-    .ofmt = object_format,
-};
-pub const object_format = std.Target.ObjectFormat.macho;
-pub const mode = std.builtin.Mode.Debug;
-pub const link_libc = true;
-pub const link_libcpp = false;
-pub const have_error_return_tracing = true;
-pub const valgrind_support = false;
-pub const sanitize_thread = false;
-pub const position_independent_code = true;
-pub const position_independent_executable = true;
-pub const strip_debug_info = false;
-pub const code_model = std.builtin.CodeModel.default;

package/zig/zig-cache/o/acdd995b96100aa4acdf8b4c71f8cc3f/dependencies.zig

@@ -1,4 +0,0 @@
-pub const imports = struct {
-};
-pub const build_root = struct {
-};