xbintsc 0.1.9 → 0.1.10

package/src/codegen/generator/state.ts

@@ -77,6 +77,10 @@ export const RUNTIME_DECLARATIONS: readonly string[] = [
   "declare i64 @xt_number_static(i64, i32, i64*)",
   "declare i64 @xt_string_static(i64, i32, i64*)",
   "declare i64 @xt_date_static(i64, i32, i64*)",
+  "declare i64 @xt_path_static(i64, i32, i64*)",
+  "declare i64 @xt_os_static(i64, i32, i64*)",
+  "declare i64 @xt_process_call(i64, i32, i64*)",
+  "declare i64 @xt_process_get(i64)",
   "declare i64 @xt_map_ctor(i32, i64*)",
   "declare i64 @xt_set_ctor(i32, i64*)",
   "declare i64 @xt_date_ctor(i32, i64*)",
@@ -147,6 +151,7 @@ export const RUNTIME_DECLARATIONS: readonly string[] = [
   "declare i64 @xt_in(i64, i64)",
   "declare i64 @xt_delete(i64, i64)",
   "declare i64 @xt_rest_args(i32, i64*, i32)",
+  "declare void @xt_set_program_args(i32, i8**)",
   "declare i64 @xt_array_new(i32, i64*)",
   "declare i64 @xt_array_push(i64, i64)",
   "declare i64 @xt_array_length(i64)",

package/src/codegen/generator/tables.ts

@@ -89,6 +89,14 @@ export const NAMESPACE_STATICS: Record<string, string> = {
   String: "xt_string_static",
   Date: "xt_date_static",
   Promise: "xt_promise_static",
+  path: "xt_path_static",
+  os: "xt_os_static",
+  process: "xt_process_call",
+};
+
+/** Namespace identifiers whose property access maps to a runtime getter. */
+export const NAMESPACE_PROPERTIES: Record<string, string> = {
+  process: "xt_process_get",
 };
 
 /** Global constructors called as `new X(...)` (all have signature `(i32, i64*)`). */

package/src/extensions/node/fs/fs-ops.ts

@@ -0,0 +1,20 @@
+/**
+ * Builtins for the filesystem operations in Node's `fs` module
+ * (`existsSync`, directory handling, rename/copy, `statSync`, ...).
+ */
+
+import type { BuiltinFunction } from "../../registry.js";
+
+export const fsOpsBuiltins: Readonly<Record<string, BuiltinFunction>> = {
+  existsSync: { symbol: "xt_node_exists" },
+  readdirSync: { symbol: "xt_node_read_dir" },
+  mkdirSync: { symbol: "xt_node_mkdir" },
+  rmSync: { symbol: "xt_node_rm" },
+  unlinkSync: { symbol: "xt_node_unlink" },
+  rmdirSync: { symbol: "xt_node_rmdir" },
+  renameSync: { symbol: "xt_node_rename" },
+  copyFileSync: { symbol: "xt_node_copy_file" },
+  realpathSync: { symbol: "xt_node_realpath" },
+  statSync: { symbol: "xt_node_stat" },
+  lstatSync: { symbol: "xt_node_lstat" },
+};

package/src/extensions/node/fs/index.ts

@@ -1,13 +1,21 @@
 /**
- * Node's `fs` module: text file reads backed by `runtime/ext_node/fs`.
+ * Node's `fs` module: synchronous file and directory operations backed by
+ * `runtime/ext_node/fs`. Asynchronous callbacks are not supported (xbintsc has
+ * no event loop), so only the `*Sync` API is exposed.
  */
 
 import type { NodeModule } from "../module.js";
 import { resolveFrom } from "../module.js";
 import { readFileBuiltins } from "./read-file.js";
+import { writeFileBuiltins } from "./write-file.js";
+import { fsOpsBuiltins } from "./fs-ops.js";
 
 export const fsModule: NodeModule = {
   name: "fs",
-  runtimeSources: () => [resolveFrom(import.meta.url, "../../../../runtime/ext_node/fs/read_file.c")],
-  builtins: () => readFileBuiltins,
+  runtimeSources: () => [
+    resolveFrom(import.meta.url, "../../../../runtime/ext_node/fs/read_file.c"),
+    resolveFrom(import.meta.url, "../../../../runtime/ext_node/fs/write_file.c"),
+    resolveFrom(import.meta.url, "../../../../runtime/ext_node/fs/fs_ops.c"),
+  ],
+  builtins: () => ({ ...readFileBuiltins, ...writeFileBuiltins, ...fsOpsBuiltins }),
 };

package/src/extensions/node/fs/write-file.ts

@@ -0,0 +1,10 @@
+/**
+ * Builtins for Node's `fs` write/append APIs.
+ */
+
+import type { BuiltinFunction } from "../../registry.js";
+
+export const writeFileBuiltins: Readonly<Record<string, BuiltinFunction>> = {
+  writeFileSync: { symbol: "xt_node_write_file" },
+  appendFileSync: { symbol: "xt_node_append_file" },
+};

package/src/extensions/node/index.ts

@@ -5,19 +5,23 @@
  * builtins each module implements, so `readFileSync("...")` in TypeScript
  * resolves to the C implementation without the core compiler knowing anything
  * about Node. Every Node module lives in its own subfolder next to this file
- * (currently `fs/`), with the runtime counterpart under `runtime/ext_node/`.
+ * (`fs/`, `path/`, `os/`, `process/`), with the runtime counterpart under
+ * `runtime/ext_node/`.
  */
 
 import type { BuiltinFunction, Extension } from "../registry.js";
 import type { NodeModule } from "./module.js";
 import { fsModule } from "./fs/index.js";
+import { pathModule } from "./path/index.js";
+import { osModule } from "./os/index.js";
+import { processModule } from "./process/index.js";
 
 /** Every Node module the extension currently provides. */
-const modules: readonly NodeModule[] = [fsModule];
+const modules: readonly NodeModule[] = [fsModule, pathModule, osModule, processModule];
 
 export const nodeExtension: Extension = {
   name: "node",
-  description: "Node.js host APIs (fs, ...)",
+  description: "Node.js host APIs (fs, path, os, process)",
   runtimeSources: () => modules.flatMap((module) => module.runtimeSources()),
   builtins: () => {
     const merged: Record<string, BuiltinFunction> = {};

package/src/extensions/node/os/index.ts

@@ -0,0 +1,16 @@
+/**
+ * Node's `os` module: host information backed by `runtime/ext_node/os`.
+ *
+ * `os` contributes no global builtins; the compiler lowers `os.<name>(...)` to
+ * `xt_os_static(<name>, argc, argv)` (see `NAMESPACE_STATICS` in
+ * `src/codegen/generator/tables.ts`). This module only links the C source.
+ */
+
+import type { NodeModule } from "../module.js";
+import { resolveFrom } from "../module.js";
+
+export const osModule: NodeModule = {
+  name: "os",
+  runtimeSources: () => [resolveFrom(import.meta.url, "../../../../runtime/ext_node/os/os.c")],
+  builtins: () => ({}),
+};

package/src/extensions/node/path/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Node's `path` module: POSIX-style path helpers backed by
+ * `runtime/ext_node/path`.
+ *
+ * `path` contributes no global builtins; the compiler lowers `path.<name>(...)`
+ * to `xt_path_static(<name>, argc, argv)` (see `NAMESPACE_STATICS` in
+ * `src/codegen/generator/tables.ts`). This module only links the C source.
+ */
+
+import type { NodeModule } from "../module.js";
+import { resolveFrom } from "../module.js";
+
+export const pathModule: NodeModule = {
+  name: "path",
+  runtimeSources: () => [resolveFrom(import.meta.url, "../../../../runtime/ext_node/path/path.c")],
+  builtins: () => ({}),
+};

package/src/extensions/node/process/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Node's `process` object backed by `runtime/ext_node/process`.
+ *
+ * The compiler lowers `process.<method>(...)` to
+ * `xt_process_call(<method>, argc, argv)` and `process.<property>` to
+ * `xt_process_get(<property>)` (see `NAMESPACE_STATICS` / `NAMESPACE_PROPERTIES`
+ * in `src/codegen/generator/tables.ts`). This module only links the C source.
+ */
+
+import type { NodeModule } from "../module.js";
+import { resolveFrom } from "../module.js";
+
+export const processModule: NodeModule = {
+  name: "process",
+  runtimeSources: () => [resolveFrom(import.meta.url, "../../../../runtime/ext_node/process/process.c")],
+  builtins: () => ({}),
+};