xbintsc 0.1.0

package/scripts/build-runtime.mjs

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * Prerequisite: compile the C runtime (and the node extension) into
+ * object files under build/runtime. The driver normally compiles these lazily
+ * into its cache; this script is for development and CI smoke checks.
+ */
+
+import { mkdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const runtimeDir = join(root, "runtime");
+const outDir = join(root, "build", "runtime");
+mkdirSync(outDir, { recursive: true });
+
+const clang = process.env.xbintsc_CLANG ?? "clang";
+
+const sources = [
+  ["xt_runtime.c", "xt_runtime.o"],
+  ["ext_node.c", "ext_node.o"],
+];
+
+for (const [source, object] of sources) {
+  const args = ["-O2", "-c", join(runtimeDir, source), "-o", join(outDir, object), `-I${runtimeDir}`];
+  const result = spawnSync(clang, args, { stdio: "inherit" });
+  if (result.status !== 0) {
+    console.error(`xbintsc: failed to compile ${source}`);
+    process.exit(result.status ?? 1);
+  }
+}
+
+console.log(`xbintsc: runtime objects written to ${outDir}`);

package/src/ast/factory.ts

@@ -0,0 +1,37 @@
+import { SyntaxKind, type Node, type Range } from "./nodes.js";
+
+/**
+ * Small helpers used by the parser and by the code generators to build AST
+ * nodes. Keeping construction in one place means the shape of every node is
+ * defined exactly once and is easy to evolve.
+ */
+
+export function node<T extends Node>(value: T): T {
+  return value;
+}
+
+export function range(start: number, end: number): Range {
+  return { start, end };
+}
+
+/** Concatenate the ranges of several nodes into one span. */
+export function span(...nodes: (Node | Range | number | undefined)[]): Range {
+  let start = Number.POSITIVE_INFINITY;
+  let end = Number.NEGATIVE_INFINITY;
+  for (const item of nodes) {
+    if (item === undefined) continue;
+    if (typeof item === "number") {
+      start = Math.min(start, item);
+      end = Math.max(end, item);
+    } else {
+      start = Math.min(start, item.start);
+      end = Math.max(end, item.end);
+    }
+  }
+  if (!Number.isFinite(start)) return { start: 0, end: 0 };
+  return { start, end };
+}
+
+export function isIdentifier(node: Node): node is import("./nodes.js").Identifier {
+  return node.kind === SyntaxKind.Identifier;
+}