npm - numbl - Versions diffs - 0.3.0 → 0.4.0 - Mend

numbl 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (403) hide show

package/dist-site-viewer/coi-serviceworker.js ADDED Viewed

@@ -0,0 +1,70 @@
+/*
+ * Cross-Origin Isolation Service Worker
+ *
+ * Adds COOP/COEP headers to responses so that SharedArrayBuffer is available
+ * on hosts that don't allow custom response headers (e.g. GitHub Pages).
+ *
+ * Based on https://github.com/niccokunzmann/coi-serviceworker (MIT).
+ */
+/* global self, caches, fetch, Response, clients */
+if (typeof window === "undefined") {
+  // --- Service Worker scope ---
+  self.addEventListener("install", () => self.skipWaiting());
+  self.addEventListener("activate", event =>
+    event.waitUntil(self.clients.claim())
+  );
+  self.addEventListener("fetch", event => {
+    const request = event.request;
+    if (request.cache === "only-if-cached" && request.mode !== "same-origin") {
+      return; // Chrome bug workaround
+    }
+    // Only add isolation headers to same-origin responses.
+    // Wrapping cross-origin responses in a new Response strips CORS
+    // internal flags, which breaks cross-origin fetch requests.
+    if (new URL(request.url).origin !== self.location.origin) {
+      return; // let the browser handle cross-origin requests normally
+    }
+    event.respondWith(
+      fetch(request).then(response => {
+        if (response.status === 0) return response; // opaque response
+        const headers = new Headers(response.headers);
+        headers.set("Cross-Origin-Embedder-Policy", "credentialless");
+        headers.set("Cross-Origin-Opener-Policy", "same-origin");
+        return new Response(response.body, {
+          status: response.status,
+          statusText: response.statusText,
+          headers,
+        });
+      })
+    );
+  });
+} else {
+  // --- Window scope (registration) ---
+  // Capture currentScript synchronously — it becomes null after script runs.
+  const scriptUrl = document.currentScript && document.currentScript.src;
+  if (!window.crossOriginIsolated && navigator.serviceWorker) {
+    navigator.serviceWorker.register(scriptUrl || "/coi-serviceworker.js").then(
+      reg => {
+        if (reg.installing || reg.waiting) {
+          const sw = reg.installing || reg.waiting;
+          sw.addEventListener("statechange", () => {
+            if (sw.state === "activated") window.location.reload();
+          });
+        } else if (reg.active && !navigator.serviceWorker.controller) {
+          // Active but not yet controlling — reload to let it intercept.
+          window.location.reload();
+        }
+      },
+      err => console.error("COI service worker registration failed:", err)
+    );
+  }
+}

package/dist-site-viewer/favicon.svg ADDED Viewed

@@ -0,0 +1,23 @@
+<svg width="32" height="32" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background -->
+  <rect width="32" height="32" fill="#64748b" rx="4"/>
+  <!-- Matrix brackets and dots (white on blue) -->
+  <g stroke="white" stroke-width="2" fill="none" stroke-linecap="round">
+    <!-- Left bracket -->
+    <path d="M 8 9 L 6 9 L 6 23 L 8 23"/>
+    <!-- Right bracket -->
+    <path d="M 24 9 L 26 9 L 26 23 L 24 23"/>
+  </g>
+  <!-- Matrix dots -->
+  <g fill="white">
+    <circle cx="12" cy="13" r="1.5"/>
+    <circle cx="16" cy="13" r="1.5"/>
+    <circle cx="20" cy="13" r="1.5"/>
+    <circle cx="12" cy="19" r="1.5"/>
+    <circle cx="16" cy="19" r="1.5"/>
+    <circle cx="20" cy="19" r="1.5"/>
+  </g>
+</svg>

package/dist-site-viewer/index.html ADDED Viewed

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="./favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>numbl project</title>
+    <!-- numbl:base -->
+    <script src="./coi-serviceworker.js"></script>
+    <script type="module" crossorigin src="./assets/index-CgBUy7v7.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-D5YY8PKx.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist-site-viewer/logo.svg ADDED Viewed

@@ -0,0 +1,26 @@
+<svg width="200" height="200" viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background circle -->
+  <circle cx="100" cy="100" r="90" fill="#64748b" opacity="0.1"/>
+  <!-- Matrix brackets (left and right) -->
+  <g stroke="#64748b" stroke-width="4" fill="none" stroke-linecap="round">
+    <!-- Left bracket -->
+    <path d="M 50 60 L 40 60 L 40 140 L 50 140"/>
+    <!-- Right bracket -->
+    <path d="M 150 60 L 160 60 L 160 140 L 150 140"/>
+  </g>
+  <!-- Matrix elements (stylized dots) -->
+  <g fill="#64748b">
+    <circle cx="70" cy="80" r="6"/>
+    <circle cx="100" cy="80" r="6"/>
+    <circle cx="130" cy="80" r="6"/>
+    <circle cx="70" cy="110" r="6"/>
+    <circle cx="100" cy="110" r="6"/>
+    <circle cx="130" cy="110" r="6"/>
+  </g>
+  <!-- Text: "Numbl" -->
+  <text x="100" y="175" font-family="sans-serif" font-size="32" font-weight="700" fill="#475569" text-anchor="middle">Numbl</text>
+</svg>

package/dist-site-viewer/numbl-embed.js ADDED Viewed

@@ -0,0 +1,111 @@
+/*
+Define a custom HTML element <numbl-embed> that embeds a numbl iframe.
+Usage:
+<numbl-embed>
+<iframe width="100%" height="500" frameborder="0"></iframe>
+<script type="text/plain" class="matlab-script">
+... MATLAB script ...
+</script>
+</numbl-embed>
+You can also specify the MATLAB script URL via attribute:
+<numbl-embed script="relative-or-absolute-url-to-matlab-script">
+<iframe width="100%" height="500" frameborder="0"></iframe>
+</numbl-embed>
+*/
+class NumblEmbed extends HTMLElement {
+  constructor() {
+    super();
+  }
+  connectedCallback() {
+    if (document.readyState === "loading") {
+      document.addEventListener("DOMContentLoaded", () => this.initialize());
+    } else {
+      this.initialize();
+    }
+  }
+  initialize() {
+    this.iframe = this.querySelector("iframe");
+    if (!this.iframe) {
+      console.error("Missing iframe element in numbl-embed");
+      return;
+    }
+    const defaultNumblUrl = "https://numbl.org";
+    const numblUrl = this.attributes["numbl-url"]?.value || defaultNumblUrl;
+    const cacheBust = `_cb=${Date.now()}`;
+    const mode = this.getAttribute("mode");
+    // REPL mode: no script needed, just load the REPL page
+    if (mode === "repl") {
+      this.iframe.src = `${numblUrl}/embed-repl?${cacheBust}`;
+      return;
+    }
+    const encodePlain = text => {
+      const text2 = text.replace(/&lt;/g, "<").replace(/&gt;/g, ">");
+      return btoa(text2);
+    };
+    const scriptElement = this.querySelector("script.matlab-script");
+    let scriptBase64;
+    if (scriptElement) {
+      const matlabScript = scriptElement.textContent.trim();
+      scriptBase64 = encodePlain(matlabScript);
+    } else if (this.attributes.script) {
+      const scriptUrl = this.attributes.script.value;
+      this.loadScriptFromUrl(scriptUrl);
+      return;
+    } else {
+      scriptBase64 = null;
+    }
+    if (scriptBase64) {
+      this.iframe.src = `${numblUrl}/embed?script=${scriptBase64}&${cacheBust}`;
+    } else {
+      this.iframe.src = `${numblUrl}/embed?${cacheBust}`;
+    }
+  }
+  async loadScriptFromUrl(url) {
+    try {
+      let absoluteUrl = url;
+      if (url.startsWith("./") || url.startsWith("../")) {
+        const baseUrl = window.location.href;
+        absoluteUrl = new URL(url, baseUrl).href;
+      }
+      const response = await fetch(absoluteUrl);
+      if (!response.ok) {
+        throw new Error(`Failed to fetch script: ${response.statusText}`);
+      }
+      const scriptContent = await response.text();
+      const scriptBase64 = btoa(scriptContent);
+      const defaultNumblUrl = "https://numbl.org";
+      const numblUrl = this.attributes["numbl-url"]?.value || defaultNumblUrl;
+      const cacheBust = `_cb=${Date.now()}`;
+      this.iframe.src = `${numblUrl}/embed?script=${scriptBase64}&${cacheBust}`;
+    } catch (error) {
+      console.error("Error loading MATLAB script:", error);
+      this.iframe.srcdoc = `
+        <html>
+          <body style="font-family: Arial; padding: 20px;">
+            <h3>Error loading MATLAB script</h3>
+            <p>${error.message}</p>
+          </body>
+        </html>
+      `;
+    }
+  }
+}
+customElements.define("numbl-embed", NumblEmbed);

package/dist-site-viewer/vite.svg ADDED Viewed

@@ -0,0 +1 @@

+ <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/native/lapack_linsolve.cpp CHANGED Viewed

@@ -9,7 +9,7 @@
  *                   BRe: Float64Array, BIm: Float64Array, nrhs: number): {re, im}
  *
  *   A is m×n in column-major order; B is m×nrhs.
- *   Returns X (n×nrhs) in a new Float64Array in column-major order.
+ *   Returns X (n×nrhs) in a allocFloat64Array in column-major order.
  *
  *   Square (m == n):
  *     Uses dgesv / zgesv (LU with partial pivoting).  Throws if A is singular.

package/native/numbl_addon_common.h CHANGED Viewed

@@ -227,14 +227,14 @@ inline std::vector<lapack_complex_double> splitToInterleaved(
   return out;
 }
-// Create a new Float64Array from a std::vector<double>.
+// Create a allocFloat64Array from a std::vector<double>.
 inline Napi::Float64Array vecToF64(Napi::Env env, const std::vector<double>& v) {
   auto arr = Napi::Float64Array::New(env, v.size());
   std::memcpy(arr.Data(), v.data(), v.size() * sizeof(double));
   return arr;
 }
-// Create a new Float64Array from raw pointer + count.
+// Create a allocFloat64Array from raw pointer + count.
 inline Napi::Float64Array ptrToF64(Napi::Env env, const double* data, size_t n) {
   auto arr = Napi::Float64Array::New(env, n);
   std::memcpy(arr.Data(), data, n * sizeof(double));

package/native/ops/comparison.c CHANGED Viewed

@@ -1,6 +1,6 @@
 /**
  * Real + complex comparison ops.  Output is a logical tensor stored as
- * 0.0 / 1.0 in a double buffer (numbl stores logicals as FloatXArray with
+ * 0.0 / 1.0 in a double buffer (numbl stores logicals as Float64Array with
  * an _isLogical flag on the runtime tensor).
  *
  * Caller-allocated input/output buffers; never copies.

package/native/ops/real_unary_elemwise.c CHANGED Viewed

@@ -8,7 +8,9 @@
 #include <math.h>
 static inline double rsign(double x) {
-  return x > 0.0 ? 1.0 : x < 0.0 ? -1.0 : 0.0;
+  // MATLAB: sign(NaN) is NaN; sign(0) is 0. The bare comparison chain
+  // would map NaN -> 0 (both x>0 and x<0 are false), so guard NaN first.
+  return x > 0.0 ? 1.0 : x < 0.0 ? -1.0 : (x == 0.0 ? 0.0 : NAN);
 }
 int numbl_real_unary_elemwise(int op, size_t n,

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "numbl",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Run .m source files in the browser and on the command line by compiling to JavaScript",
   "license": "Apache-2.0",
   "type": "module",
@@ -33,20 +33,25 @@
     "dist-lib/",
     "dist-cli/",
     "dist-plot-viewer/",
+    "dist-site-viewer/",
     "native/",
     "binding.gyp"
   ],
   "scripts": {
-    "dev": "npm run bundle:stdlib && vite",
-    "build": "npm run build:web && npm run build:test-runner && npm run copy:test-scripts && npm run build:cli && npm run build:plot-viewer",
+    "dev": "npm run build:snippets && npm run bundle:stdlib && vite",
+    "build": "npm run build:web && npm run build:test-runner && npm run copy:test-scripts && npm run build:cli && npm run build:plot-viewer && npm run build:site-viewer",
     "build:plot-viewer": "vite build --config vite.plot-viewer.config.ts",
-    "build:test-runner": "npm run bundle:stdlib && vite build --config vite.test-runner.config.ts",
-    "dev:test-runner": "npm run bundle:stdlib && vite --config vite.test-runner.config.ts",
+    "build:site-viewer": "npm run build:snippets && npm run bundle:stdlib && vite build --config vite.site-viewer.config.ts",
+    "dev:site-viewer": "npm run build:snippets && npm run bundle:stdlib && vite --config vite.site-viewer.config.ts",
+    "build:test-runner": "npm run build:snippets && npm run bundle:stdlib && vite build --config vite.test-runner.config.ts",
+    "dev:test-runner": "npm run build:snippets && npm run bundle:stdlib && vite --config vite.test-runner.config.ts",
     "copy:test-scripts": "tsx scripts/copy-test-scripts.ts",
     "bundle:stdlib": "tsx scripts/bundle-stdlib.ts",
-    "build:web": "npm run bundle:stdlib && tsc -b && vite build",
-    "build:lib": "npm run bundle:stdlib && esbuild src/lib.ts --bundle --platform=neutral --format=esm --outfile=dist-lib/lib.js --loader:.wasm=file && tsc -p tsconfig.lib.json",
-    "build:cli": "npm run bundle:stdlib && esbuild src/cli.ts --bundle --platform=node --format=esm --outfile=dist-cli/cli.js --packages=external --loader:.wasm=file",
+    "build:snippets": "tsx scripts/build_runtime_snippets.ts",
+    "build:snippets:check": "tsx scripts/build_runtime_snippets.ts --check",
+    "build:web": "npm run build:snippets && npm run bundle:stdlib && tsc -b && vite build",
+    "build:lib": "npm run build:snippets && npm run bundle:stdlib && esbuild src/lib.ts --bundle --platform=node --format=esm --outfile=dist-lib/lib.js --packages=external --loader:.wasm=file && tsc -p tsconfig.lib.json",
+    "build:cli": "npm run build:snippets && npm run bundle:stdlib && esbuild src/cli.ts --bundle --platform=node --format=esm --outfile=dist-cli/cli.js --packages=external --loader:.wasm=file",
     "install": "true",
     "build:addon": "node-gyp rebuild",
     "format": "prettier --write .",
@@ -54,19 +59,17 @@
     "lint": "eslint .",
     "typecheck": "tsc -b",
     "preview": "vite preview",
-    "test": "npm run test:float64",
-    "test:float32": "NUMBL_USE_FLOAT32=true vitest run",
-    "test:float64": "NUMBL_USE_FLOAT32=false vitest run",
+    "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "test:coverage:all": "bash scripts/coverage-all.sh",
     "test:scripts": "bash numbl_test_scripts/run_all.sh",
+    "jit-parity": "node jit_parity/run.mjs",
     "test:browser": "playwright test",
-    "test:scripts:e1": "bash numbl_test_scripts/run_e1.sh",
     "build:wasm": "bash numbl_test_scripts/build_wasm.sh",
     "update-readme": "tsx scripts/update-readme-usage.ts",
     "check-readme": "tsx scripts/update-readme-usage.ts --check",
     "bump": "tsx scripts/bump-version.ts",
-    "prepublishOnly": "npm run build:lib && npm run build:cli && npm run build:plot-viewer",
+    "prepublishOnly": "npm run build:lib && npm run build:cli && npm run build:plot-viewer && npm run build:site-viewer",
     "prepare": "husky"
   },
   "dependencies": {

package/dist-lib/numbl-core/jit/c/abi.d.ts DELETED Viewed

@@ -1,90 +0,0 @@
-/**
- * The native ABI as an explicit slot schema — one source of truth shared
- * between the C-signature builder (assemble.ts) and the JS wrapper
- * marshaller (install.ts).
- *
- * Each `AbiSlot` carries everything either side needs: the C type for
- * the signature, the koffi type string (with `_Out_` prefix for
- * out-pointers), the identifier name in the emitted C, and a backref
- * (paramIdx / outputIdx) so the JS wrapper can locate the source value
- * or output buffer without reconstructing the param-to-slot mapping
- * itself.
- *
- * Adding a new ABI shape = add a slot kind here, emit it in
- * `buildAbiSlots`, and handle it in the JS marshaller.
- */
-import type { ClassificationResult } from "./classify.js";
-export type AbiSlotKind = "scalar" | "complexScalarRe" | "complexScalarIm" | "tensorData"
-/** Imaginary data pointer for a complex tensor param. Paired with
- *  `tensorData`. Marshaller passes the RuntimeTensor's `.imag` (a
- *  Float64Array) or NULL when `.imag === undefined`; the numbl_ops
- *  complex kernels treat NULL imag as all-zero. */
- | "tensorDataIm" | "tensorLen" | "tensorD0" | "tensorD1" | "scalarOut" | "complexScalarReOut" | "complexScalarImOut" | "fixedOutBuf"
-/** Imaginary fixed-output buffer (complex tensor output, non-dynamic). */
- | "fixedOutBufIm" | "fixedOutLen" | "dynOutBuf"
-/** Imaginary buffer pointer for a dynamic complex tensor output. C
- *  mallocs, transfers ownership via `double **`; wrapper decodes+copies
- *  into a fresh Float64Array then frees. */
- | "dynOutBufIm" | "dynOutLen" | "dynOutD0" | "dynOutD1" | "ticState" | "errFlag"
-/** Callback for `disp(...)` — JS-registered function pointer. The C
- *  body invokes it directly; the JS wrapper supplies a koffi-registered
- *  pointer that routes into `rt.output`. Signature:
- *    void __disp_cb(const char *s, double num, int kind)
- *  kind=0 => use `s`, kind=1 => use `num`. */
- | "dispCb";
-export interface AbiSlot {
-    kind: AbiSlotKind;
-    /** C type string for the signature, e.g. "double", "const double *",
-     *  "double **". */
-    cType: string;
-    /** Identifier as it appears in the C signature. */
-    cName: string;
-    /** koffi type string, with `_Out_` prefix where koffi must treat the
-     *  pointer as an out-param. */
-    koffiType: string;
-    /** Index into paramDescs, for "scalar" / "tensor*" kinds. */
-    paramIdx?: number;
-    /** Index into outputDescs, for output-allocated kinds. */
-    outputIdx?: number;
-}
-export interface CParamDesc {
-    name: string;
-    kind: "scalar" | "complexScalar" | "tensor";
-    /** For tensor params: max indexing arity the body uses (1, 2, or 3).
-     *  Drives the extra `_d0` / `_d1` shape args the JS wrapper must
-     *  marshal. `undefined` means the tensor is only used in whole-tensor
-     *  ops (legacy data/len ABI). */
-    ndim?: number;
-    /** True for complex tensor params. Adds an imag-data slot right after
-     *  the real-data slot; the marshaller supplies the tensor's `.imag`
-     *  Float64Array or NULL. Ignored for scalar kinds. */
-    isComplex?: boolean;
-    /** Ordered slots this param contributes to the ABI. One slot for a
-     *  scalar; two for a complex scalar (re + im); two or more
-     *  (data + [imag for complex] + len + optional d0/d1) for a tensor. */
-    slots: AbiSlot[];
-}
-/** Per-output descriptor. Tells the JS wrapper how to marshal outputs. */
-export interface COutputDesc {
-    name: string;
-    kind: "scalar" | "boolean" | "complexScalar" | "tensor";
-    /** True for tensor outputs using the dynamic-output ABI: the C code
-     *  malloc's the buffer and transfers ownership via `double **` and
-     *  extra d0/d1 out-slots. The JS wrapper decodes the pointer, copies
-     *  into a fresh Float64Array, and frees the C allocation. */
-    dynamic?: boolean;
-    /** True for complex tensor outputs. Fixed outputs add a paired imag
-     *  Float64Array buffer; dynamic outputs add a paired imag `double **`
-     *  out-pointer the caller decodes + frees after the call. */
-    isComplex?: boolean;
-    /** Ordered slots this output contributes to the ABI. One for scalars,
-     *  two for complex scalars (reOut + imOut), two for fixed real tensor
-     *  outputs (buf + lenOut), three for fixed complex (buf + bufIm +
-     *  lenOut), four for dynamic real tensor outputs, five for dynamic
-     *  complex (dynBuf + dynBufIm + dynLen + dynD0 + dynD1). */
-    slots: AbiSlot[];
-}
-/** Build the ABI schema for one generated function. Mutates paramDescs /
- *  outputDescs in place by filling in `slots`; returns the complete
- *  `abiSlots` array in calling order (params, then outputs, then trailers). */
-export declare function buildAbiSlots(paramDescs: CParamDesc[], outputDescs: COutputDesc[], cls: ClassificationResult, paramOutputTensors: Set<string>, unshareTensorParams: Set<string>, needsTicState: boolean, needsErrorFlag: boolean, needsDispCb: boolean): AbiSlot[];

package/dist-lib/numbl-core/jit/c/assemble.d.ts DELETED Viewed

@@ -1,56 +0,0 @@
-/**
- * JIT IR → pure C code generation (koffi path).
- *
- * Orchestration only: this file wires the classify / ABI / emit pieces
- * together and assembles the final C source (headers + per-callee
- * static functions + outer function).
- *
- *   classify.ts     — TensorMeta / analyzeTensorUsage, the single pass
- *                     feeding every downstream decision.
- *   abi.ts          — AbiSlot / CParamDesc / COutputDesc, buildAbiSlots.
- *                     The one schema walked by both signature and JS.
- *   emit/           — per-statement / per-expression C emission, split
- *                     by concern (scalar, complexScalar, tensor, assign,
- *                     userCall, stmt, fused). Reads ctx.cls for every
- *                     classification decision.
- *   context.ts   — EmitCtx + shared name/opcode helpers.
- *
- * UserCall support: when a feasible user-defined function is called
- * from the outer body, its lowered IR is already in `generatedIRBodies`
- * (populated by `lowerUserFuncCall` in jitLower.ts). We emit each
- * reachable callee as a `static void jit_<jitName>(...)` in the same
- * .c file, in post-order so callees are defined before callers. The
- * shared `__err_flag` pointer flows from outer to every callee.
- */
-import { type JitStmt, type JitType } from "../jitTypes.js";
-import type { GeneratedFn } from "../jitLower.js";
-import { type AbiSlot, type CParamDesc, type COutputDesc } from "./abi.js";
-export type { AbiSlot, AbiSlotKind } from "./abi.js";
-export type { CParamDesc, COutputDesc } from "./abi.js";
-export { mangle, mangleIm, tensorData, tensorDataIm, tensorLen, tensorD0, tensorD1, formatNumberLiteral, C_SCALAR_TARGET, } from "./context.js";
-export interface GenerateCResult {
-    cSource: string;
-    cFnName: string;
-    paramDescs: CParamDesc[];
-    outputDescs: COutputDesc[];
-    /** The full ABI slot list in calling order:
-     *    paramDescs[0].slots ++ paramDescs[1].slots ++ ...
-     *    ++ outputDescs[0].slots ++ ... ++ trailer slots (ticState/errFlag).
-     *  The JS wrapper walks this list to marshal values. */
-    abiSlots: AbiSlot[];
-    /** True when any tensor is involved (params, locals, or outputs). */
-    usesTensors: boolean;
-    /** koffi function signature string for declaring the C function. */
-    koffiSignature: string;
-    /** True when tic/toc are used — the function has an extra `double*` param. */
-    needsTicState: boolean;
-    /** True when any Index read was emitted — the function has an extra
-     *  `double *__err_flag` trailing param. */
-    needsErrorFlag: boolean;
-    /** True when a `disp(...)` call was emitted — the function has an
-     *  extra `void (*__disp_cb)(const char *, double, int)` trailing
-     *  param. The JS wrapper registers a callback that routes back to
-     *  `rt.output`. */
-    needsDispCb: boolean;
-}
-export declare function generateC(body: JitStmt[], params: string[], outputs: string[], nargout: number, localVars: Set<string>, argTypes: JitType[], _outputType: JitType | null, outputTypes: JitType[], fnName: string, fuse?: boolean, openmp?: boolean, generatedIRBodies?: Map<string, GeneratedFn>): GenerateCResult;

package/dist-lib/numbl-core/jit/c/classify.d.ts DELETED Viewed

@@ -1,70 +0,0 @@
-/**
- * C-JIT: unified classification pass for tensor names.
- *
- * Replaces the ten ad-hoc sets/maps (`tensorVars`, `paramTensorNames`,
- * `outputTensorNames`, `localTensorNames`, `assignIndexTargets`,
- * `unshareTensorParams`, `tensorMaxDim`, `freshAllocTensors`,
- * `dynamicOutputs`, `paramOutputTensors`) that the codegen used to
- * build from 7+ body walks. Everything downstream — signature builder,
- * prelude, epilogue, emit helpers, fusion call — now reads from the
- * `TensorMeta` table this pass produces.
- */
-import type { JitExpr, JitStmt, JitType } from "../jitTypes.js";
-export type TensorKind =
-/** Tensor param, never appears in the output list. */
-"param"
-/** Tensor param whose name is also in the output list. */
- | "paramOutput"
-/** Pure tensor output (not a param). */
- | "output"
-/** Tensor local (neither param nor output). */
- | "local";
-export interface TensorMeta {
-    kind: TensorKind;
-    /** Max index arity on this name (1/2/3). 0 means the name is never
-     *  used as an Index or AssignIndex base. */
-    maxIndexDim: number;
-    /** True when any `Assign(name, RHS)` has RHS ∈ {TensorLiteral,
-     *  VConcatGrow, Call(zeros|ones), Var(src) where src.hasFreshAlloc,
-     *  RangeSliceRead}. Propagated to fixed point. */
-    hasFreshAlloc: boolean;
-    /** True when any AssignIndex / AssignIndexRange / AssignIndexCol
-     *  uses this name as the base. */
-    isAssignIndexTarget: boolean;
-    /** Derived: `kind === "param"` and (`isAssignIndexTarget` or
-     *  `hasFreshAlloc`). Triggers the unshare-at-entry malloc+memcpy
-     *  prelude so writes don't leak to the caller's buffer. */
-    needsUnshare: boolean;
-    /** Derived: `hasFreshAlloc` and (`kind === "output"` or
-     *  `kind === "paramOutput"`). Triggers the `double **` dynamic-output
-     *  ABI. */
-    isDynamicOutput: boolean;
-    /** True when this tensor's `JitType.isComplex === true` — either at
-     *  the boundary (param / output type) or propagated from a complex
-     *  RHS for locals. Drives paired imag-buffer plumbing: every complex
-     *  tensor gets a `v_name_data_im` companion pointer, an extra ABI
-     *  slot for boundaries, and imag malloc / free / copy parallel to
-     *  the existing real path. */
-    isComplex: boolean;
-}
-export interface ClassificationResult {
-    /** All names with a tensor role, in insertion order (params first,
-     *  then outputs, then locals in body order). */
-    tensorNames: string[];
-    /** Per-name metadata. */
-    meta: Map<string, TensorMeta>;
-    /** True iff any name has `hasFreshAlloc`. Lets callers skip the
-     *  dynamic-output marshalling when no name uses it. */
-    hasAnyDynamic: boolean;
-    /** Name → is any tensor role. `meta.has(name)`. */
-    tensorVars: Set<string>;
-    /** Names with `kind === "param"` or `"paramOutput"`. */
-    paramTensorNames: Set<string>;
-    /** Names with `kind === "output"` or `"paramOutput"`. */
-    outputTensorNames: Set<string>;
-    /** Names with `kind === "local"`. */
-    localTensorNames: Set<string>;
-}
-/** Does this Assign RHS allocate a fresh C-owned buffer? */
-export declare function isFreshTensorRhs(expr: JitExpr): boolean;
-export declare function analyzeTensorUsage(body: JitStmt[], params: string[], argTypes: JitType[], outputNames: string[], outputTypes: JitType[]): ClassificationResult;

package/dist-lib/numbl-core/jit/c/compile.d.ts DELETED Viewed

@@ -1,37 +0,0 @@
-/**
- * C-JIT compilation driver (koffi path).
- *
- * Takes generated C source, compiles it into a `.so` shared library,
- * loads it via koffi, and returns the declared function.
- *
- * Strategy:
- *   1. Content-addressed cache under ~/.cache/numbl/c-jit/ — the hash
- *      includes the source bytes plus compiler/platform/numbl versions,
- *      so any input change forces a recompile.
- *   2. On cache miss, write `src.c` into a fresh tmpdir and shell out to
- *      the C compiler (`$NUMBL_CC` or `cc`) with `-shared -fPIC`.
- *   3. Load with koffi.load() and declare the function.
- *
- * No Node API headers are needed — functions are plain C with raw types.
- * No NAPI_MODULE_INIT, no module registration, no exit hooks.
- */
-export interface CompiledCFn {
-    fn: (...args: unknown[]) => unknown;
-    cachedPath: string;
-    /** The loaded koffi library handle, for declaring additional exports. */
-    lib: any;
-}
-/**
- * Compile + load a C function via koffi. Returns null on any failure.
- *
- * `koffiSignature` is the koffi type-string for the C function, e.g.:
- *   "void jit_fn(double, double *, int64_t, double *)"
- */
-export declare function compileAndLoad(cSource: string, koffiSignature: string, _cFnName: string, log?: (m: string) => void, extraFlags?: string[]): CompiledCFn | null;
-export declare function resetCEnvForTesting(): void;
-export declare function cJitUnavailableReason(): string | undefined;
-export declare function cJitCacheSize(): number;
-export declare function readCachedBuild(cachedPath: string): Buffer;
-/** True when the C compiler supports `-fopenmp` (thread-level parallelism).
- *  Triggers env discovery on first call so it can be used before compileAndLoad. */
-export declare function cJitOpenmpAvailable(log?: (m: string) => void): boolean;