gsd-pi 2.58.0 → 2.59.0-dev.023bd39

package/packages/native/dist/native.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Native addon loader.
  *
@@ -7,12 +8,48 @@
  *   2. native/addon/gsd_engine.{platform}.node (local release build)
  *   3. native/addon/gsd_engine.dev.node (local debug build)
  */
-import { createRequire } from "node:module";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const require = createRequire(import.meta.url);
-const addonDir = path.resolve(__dirname, "..", "..", "..", "native", "addon");
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.native = void 0;
+const path = __importStar(require("node:path"));
+// __dirname and require are available in both execution contexts:
+//   - CJS (production build via tsc): provided natively by Node
+//   - ESM (CI test loader): injected by the dist-redirect.mjs preamble
+const _dirname = __dirname;
+const _require = require;
+const addonDir = path.resolve(_dirname, "..", "..", "..", "native", "addon");
 const platformTag = `${process.platform}-${process.arch}`;
 /** Map Node.js platform/arch to the npm package suffix */
 const platformPackageMap = {
@@ -30,7 +67,7 @@ function loadNative() {
     if (packageSuffix) {
         try {
             _loadedSuccessfully = true;
-            return require(`@gsd-build/engine-${packageSuffix}`);
+            return _require(`@gsd-build/engine-${packageSuffix}`);
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
@@ -41,7 +78,7 @@ function loadNative() {
     const releasePath = path.join(addonDir, `gsd_engine.${platformTag}.node`);
     try {
         _loadedSuccessfully = true;
-        return require(releasePath);
+        return _require(releasePath);
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
@@ -51,7 +88,7 @@ function loadNative() {
     const devPath = path.join(addonDir, "gsd_engine.dev.node");
     try {
         _loadedSuccessfully = true;
-        return require(devPath);
+        return _require(devPath);
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
@@ -73,4 +110,4 @@ function loadNative() {
         },
     });
 }
-export const native = loadNative();
+exports.native = loadNative();

package/packages/native/dist/ps/index.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Cross-platform process tree management via N-API.
  *
@@ -5,7 +6,12 @@
  * using platform-native APIs (libproc on macOS, /proc on Linux,
  * Toolhelp32 on Windows).
  */
-import { native } from "../native.js";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.killTree = killTree;
+exports.listDescendants = listDescendants;
+exports.processGroupId = processGroupId;
+exports.killProcessGroup = killProcessGroup;
+const native_js_1 = require("../native.js");
 /**
  * Kill a process tree (the process and all its descendants).
  *
@@ -14,8 +20,8 @@ import { native } from "../native.js";
  * @param signal - Signal to send (e.g. 9 for SIGKILL, 15 for SIGTERM). Ignored on Windows.
  * @returns Number of processes successfully killed.
  */
-export function killTree(pid, signal) {
-    return native.killTree(pid, signal);
+function killTree(pid, signal) {
+    return native_js_1.native.killTree(pid, signal);
 }
 /**
  * List all descendant PIDs of a process.
@@ -23,8 +29,8 @@ export function killTree(pid, signal) {
  * @param pid - Parent process ID
  * @returns Array of descendant PIDs (empty if no children or process doesn't exist).
  */
-export function listDescendants(pid) {
-    return native.listDescendants(pid);
+function listDescendants(pid) {
+    return native_js_1.native.listDescendants(pid);
 }
 /**
  * Get the process group ID for a process.
@@ -32,8 +38,8 @@ export function listDescendants(pid) {
  * @param pid - Process ID
  * @returns Process group ID, or null if the process doesn't exist or on Windows.
  */
-export function processGroupId(pid) {
-    return native.processGroupId(pid);
+function processGroupId(pid) {
+    return native_js_1.native.processGroupId(pid);
 }
 /**
  * Kill an entire process group.
@@ -42,6 +48,6 @@ export function processGroupId(pid) {
  * @param signal - Signal to send
  * @returns true if the signal was delivered, false on failure or Windows.
  */
-export function killProcessGroup(pgid, signal) {
-    return native.killProcessGroup(pgid, signal);
+function killProcessGroup(pgid, signal) {
+    return native_js_1.native.killProcessGroup(pgid, signal);
 }

package/packages/native/dist/ps/types.js

@@ -1 +1,2 @@
-export {};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/packages/native/dist/stream-process/index.js

@@ -1,9 +1,14 @@
+"use strict";
 /**
  * Bash stream processor — single-pass UTF-8 decode + ANSI strip + binary sanitization.
  *
  * Handles chunk boundaries for incomplete UTF-8 and ANSI escape sequences.
  */
-import { native } from "../native.js";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processStreamChunk = processStreamChunk;
+exports.stripAnsiNative = stripAnsiNative;
+exports.sanitizeBinaryOutputNative = sanitizeBinaryOutputNative;
+const native_js_1 = require("../native.js");
 /**
  * Process a raw bash output chunk in a single pass.
  *
@@ -14,7 +19,7 @@ import { native } from "../native.js";
  * Pass the returned `state` to the next call to handle sequences split
  * across chunk boundaries.
  */
-export function processStreamChunk(chunk, state) {
+function processStreamChunk(chunk, state) {
     // Convert StreamState arrays to the format napi expects (Vec<u8>)
     const napiState = state
         ? {
@@ -22,7 +27,7 @@ export function processStreamChunk(chunk, state) {
             ansiPending: Array.from(state.ansiPending),
         }
         : undefined;
-    const result = native.processStreamChunk(chunk, napiState);
+    const result = native_js_1.native.processStreamChunk(chunk, napiState);
     return {
         text: result.text,
         state: {
@@ -34,8 +39,8 @@ export function processStreamChunk(chunk, state) {
 /**
  * Strip ANSI escape sequences from a string.
  */
-export function stripAnsiNative(text) {
-    return native.stripAnsiNative(text);
+function stripAnsiNative(text) {
+    return native_js_1.native.stripAnsiNative(text);
 }
 /**
  * Remove binary garbage and control characters from a string.
@@ -43,6 +48,6 @@ export function stripAnsiNative(text) {
  * Keeps tab and newline. Removes carriage return, all other control
  * characters, Unicode format characters (U+FFF9-U+FFFB), and lone surrogates.
  */
-export function sanitizeBinaryOutputNative(text) {
-    return native.sanitizeBinaryOutputNative(text);
+function sanitizeBinaryOutputNative(text) {
+    return native_js_1.native.sanitizeBinaryOutputNative(text);
 }

package/packages/native/dist/text/index.js

@@ -1,11 +1,21 @@
+"use strict";
 /**
  * ANSI-aware text measurement and slicing.
  *
  * High-performance UTF-16 native implementation with ASCII fast-paths,
  * single-pass ANSI scanning, and proper Unicode grapheme cluster support.
  */
-import { native } from "../native.js";
-export { EllipsisKind } from "./types.js";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EllipsisKind = void 0;
+exports.wrapTextWithAnsi = wrapTextWithAnsi;
+exports.truncateToWidth = truncateToWidth;
+exports.sliceWithWidth = sliceWithWidth;
+exports.extractSegments = extractSegments;
+exports.sanitizeText = sanitizeText;
+exports.visibleWidth = visibleWidth;
+const native_js_1 = require("../native.js");
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "EllipsisKind", { enumerable: true, get: function () { return types_js_1.EllipsisKind; } });
 /**
  * Word-wrap text to a visible width, preserving ANSI escape codes across
  * line breaks.
@@ -14,8 +24,8 @@ export { EllipsisKind } from "./types.js";
  * Underline and strikethrough are reset at line ends and restored on the
  * next line.
  */
-export function wrapTextWithAnsi(text, width, tabWidth) {
-    return native.wrapTextWithAnsi(text, width, tabWidth);
+function wrapTextWithAnsi(text, width, tabWidth) {
+    return native_js_1.native.wrapTextWithAnsi(text, width, tabWidth);
 }
 /**
  * Truncate text to a visible width with an optional ellipsis.
@@ -26,8 +36,8 @@ export function wrapTextWithAnsi(text, width, tabWidth) {
  * @param pad        When true, pad with spaces to exactly `maxWidth`.
  * @param tabWidth   Tab stop width (default 3, range 1-16).
  */
-export function truncateToWidth(text, maxWidth, ellipsisKind, pad, tabWidth) {
-    return native.truncateToWidth(text, maxWidth, ellipsisKind, pad, tabWidth);
+function truncateToWidth(text, maxWidth, ellipsisKind, pad, tabWidth) {
+    return native_js_1.native.truncateToWidth(text, maxWidth, ellipsisKind, pad, tabWidth);
 }
 /**
  * Slice a range of visible columns from a line.
@@ -35,8 +45,8 @@ export function truncateToWidth(text, maxWidth, ellipsisKind, pad, tabWidth) {
  * Counts terminal cells (skipping ANSI escapes). When `strict` is true,
  * wide characters that would exceed the range are excluded.
  */
-export function sliceWithWidth(line, startCol, length, strict, tabWidth) {
-    return native.sliceWithWidth(line, startCol, length, strict, tabWidth);
+function sliceWithWidth(line, startCol, length, strict, tabWidth) {
+    return native_js_1.native.sliceWithWidth(line, startCol, length, strict, tabWidth);
 }
 /**
  * Extract the before/after segments around an overlay region.
@@ -44,8 +54,8 @@ export function sliceWithWidth(line, startCol, length, strict, tabWidth) {
  * ANSI state is tracked so the `after` segment renders correctly even when
  * the overlay truncates styled text.
  */
-export function extractSegments(line, beforeEnd, afterStart, afterLen, strictAfter, tabWidth) {
-    return native.extractSegments(line, beforeEnd, afterStart, afterLen, strictAfter, tabWidth);
+function extractSegments(line, beforeEnd, afterStart, afterLen, strictAfter, tabWidth) {
+    return native_js_1.native.extractSegments(line, beforeEnd, afterStart, afterLen, strictAfter, tabWidth);
 }
 /**
  * Strip ANSI escape sequences, remove control characters and lone
@@ -53,14 +63,14 @@ export function extractSegments(line, beforeEnd, afterStart, afterLen, strictAft
  *
  * Returns the original string when no changes are needed (zero-copy).
  */
-export function sanitizeText(text) {
-    return native.sanitizeText(text);
+function sanitizeText(text) {
+    return native_js_1.native.sanitizeText(text);
 }
 /**
  * Calculate visible width of text excluding ANSI escape sequences.
  *
  * Tabs count as `tabWidth` cells (default 3).
  */
-export function visibleWidth(text, tabWidth) {
-    return native.visibleWidth(text, tabWidth);
+function visibleWidth(text, tabWidth) {
+    return native_js_1.native.visibleWidth(text, tabWidth);
 }

package/packages/native/dist/text/types.js

@@ -1,5 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EllipsisKind = void 0;
 /** Ellipsis style for truncation. */
-export var EllipsisKind;
+var EllipsisKind;
 (function (EllipsisKind) {
     /** Unicode ellipsis character: \u2026 (width 1) */
     EllipsisKind[EllipsisKind["Unicode"] = 0] = "Unicode";
@@ -7,4 +10,4 @@ export var EllipsisKind;
     EllipsisKind[EllipsisKind["Ascii"] = 1] = "Ascii";
     /** No ellipsis (hard truncate) */
     EllipsisKind[EllipsisKind["None"] = 2] = "None";
-})(EllipsisKind || (EllipsisKind = {}));
+})(EllipsisKind || (exports.EllipsisKind = EllipsisKind = {}));

package/packages/native/dist/truncate/index.js

@@ -1,25 +1,30 @@
+"use strict";
 /**
  * Line-boundary-aware output truncation (native Rust).
  *
  * Truncates tool output at line boundaries, counting by UTF-8 bytes.
  * Three modes: head (keep end), tail (keep start), both (keep start+end).
  */
-import { native } from "../native.js";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.truncateTail = truncateTail;
+exports.truncateHead = truncateHead;
+exports.truncateOutput = truncateOutput;
+const native_js_1 = require("../native.js");
 /**
  * Keep the first `maxBytes` worth of complete lines.
  */
-export function truncateTail(text, maxBytes) {
-    return native.truncateTail(text, maxBytes);
+function truncateTail(text, maxBytes) {
+    return native_js_1.native.truncateTail(text, maxBytes);
 }
 /**
  * Keep the last `maxBytes` worth of complete lines.
  */
-export function truncateHead(text, maxBytes) {
-    return native.truncateHead(text, maxBytes);
+function truncateHead(text, maxBytes) {
+    return native_js_1.native.truncateHead(text, maxBytes);
 }
 /**
  * Main entry point: truncate tool output with head/tail/both modes.
  */
-export function truncateOutput(text, maxBytes, mode) {
-    return native.truncateOutput(text, maxBytes, mode);
+function truncateOutput(text, maxBytes, mode) {
+    return native_js_1.native.truncateOutput(text, maxBytes, mode);
 }

package/packages/native/dist/ttsr/index.js

@@ -1,17 +1,22 @@
+"use strict";
 /**
  * Native TTSR regex engine.
  *
  * Pre-compiles all rule condition patterns into a single Rust RegexSet for
  * O(1)-style matching per buffer check, replacing per-rule JS regex iteration.
  */
-import { native } from "../native.js";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ttsrCompileRules = ttsrCompileRules;
+exports.ttsrCheckBuffer = ttsrCheckBuffer;
+exports.ttsrFreeRules = ttsrFreeRules;
+const native_js_1 = require("../native.js");
 /**
  * Compile TTSR rules into an optimized native regex engine.
  *
  * Returns an opaque handle for use with `ttsrCheckBuffer` and `ttsrFreeRules`.
  */
-export function ttsrCompileRules(rules) {
-    return native.ttsrCompileRules(rules);
+function ttsrCompileRules(rules) {
+    return native_js_1.native.ttsrCompileRules(rules);
 }
 /**
  * Check a buffer against compiled TTSR rules.
@@ -19,14 +24,14 @@ export function ttsrCompileRules(rules) {
  * Returns an array of unique rule names whose conditions matched.
  * All patterns are tested in a single pass via Rust's RegexSet.
  */
-export function ttsrCheckBuffer(handle, buffer) {
-    return native.ttsrCheckBuffer(handle, buffer);
+function ttsrCheckBuffer(handle, buffer) {
+    return native_js_1.native.ttsrCheckBuffer(handle, buffer);
 }
 /**
  * Free a compiled TTSR rule set, releasing native memory.
  *
  * Call when rules are no longer needed (e.g., session end).
  */
-export function ttsrFreeRules(handle) {
-    native.ttsrFreeRules(handle);
+function ttsrFreeRules(handle) {
+    native_js_1.native.ttsrFreeRules(handle);
 }

package/packages/native/dist/ttsr/types.js

@@ -1 +1,2 @@
-export {};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/packages/native/dist/xxhash/index.js

@@ -1,9 +1,13 @@
+"use strict";
 /**
  * Native xxHash32 — Rust implementation via napi-rs, with a pure-JS fallback.
  *
  * Hashes the UTF-8 representation of the input string with the given seed.
  */
-import { native } from "../native.js";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.xxHash32Fallback = xxHash32Fallback;
+exports.xxHash32 = xxHash32;
+const native_js_1 = require("../native.js");
 // ─── Pure-JS xxHash32 fallback ────────────────────────────────────────────────
 // Used when the native addon is present but does not export xxHash32
 // (e.g. an older build or an unsupported platform variant).
@@ -62,12 +66,12 @@ function xxHash32JS(input, seed) {
  * Pure-JS xxHash32 implementation. Exposed for testing to allow CI to validate
  * the fallback path independently of native addon availability.
  */
-export function xxHash32Fallback(input, seed) {
+function xxHash32Fallback(input, seed) {
     return xxHash32JS(input, seed);
 }
 // Resolve once at module load: prefer native, fall back to JS.
-const _xxHash32Impl = typeof native.xxHash32 === "function"
-    ? (input, seed) => native.xxHash32(input, seed)
+const _xxHash32Impl = typeof native_js_1.native.xxHash32 === "function"
+    ? (input, seed) => native_js_1.native.xxHash32(input, seed)
     : xxHash32JS;
 /**
  * Compute xxHash32 of a UTF-8 string.
@@ -80,6 +84,6 @@ const _xxHash32Impl = typeof native.xxHash32 === "function"
  * @param seed   32-bit seed value.
  * @returns      32-bit unsigned hash.
  */
-export function xxHash32(input, seed) {
+function xxHash32(input, seed) {
     return _xxHash32Impl(input, seed);
 }

package/packages/native/package.json

@@ -2,7 +2,7 @@
   "name": "@gsd/native",
   "version": "0.1.0",
   "description": "Native Rust bindings for GSD \u2014 high-performance native modules via N-API",
-  "type": "module",
+  "type": "commonjs",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
@@ -14,75 +14,75 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "default": "./dist/index.js"
     },
     "./grep": {
       "types": "./dist/grep/index.d.ts",
-      "import": "./dist/grep/index.js"
+      "default": "./dist/grep/index.js"
     },
     "./ps": {
       "types": "./dist/ps/index.d.ts",
-      "import": "./dist/ps/index.js"
+      "default": "./dist/ps/index.js"
     },
     "./glob": {
       "types": "./dist/glob/index.d.ts",
-      "import": "./dist/glob/index.js"
+      "default": "./dist/glob/index.js"
     },
     "./clipboard": {
       "types": "./dist/clipboard/index.d.ts",
-      "import": "./dist/clipboard/index.js"
+      "default": "./dist/clipboard/index.js"
     },
     "./ast": {
       "types": "./dist/ast/index.d.ts",
-      "import": "./dist/ast/index.js"
+      "default": "./dist/ast/index.js"
     },
     "./html": {
       "types": "./dist/html/index.d.ts",
-      "import": "./dist/html/index.js"
+      "default": "./dist/html/index.js"
     },
     "./text": {
       "types": "./dist/text/index.d.ts",
-      "import": "./dist/text/index.js"
+      "default": "./dist/text/index.js"
     },
     "./fd": {
       "types": "./dist/fd/index.d.ts",
-      "import": "./dist/fd/index.js"
+      "default": "./dist/fd/index.js"
     },
     "./image": {
       "types": "./dist/image/index.d.ts",
-      "import": "./dist/image/index.js"
+      "default": "./dist/image/index.js"
     },
     "./xxhash": {
       "types": "./dist/xxhash/index.d.ts",
-      "import": "./dist/xxhash/index.js"
+      "default": "./dist/xxhash/index.js"
     },
     "./diff": {
       "types": "./dist/diff/index.d.ts",
-      "import": "./dist/diff/index.js"
+      "default": "./dist/diff/index.js"
     },
     "./gsd-parser": {
       "types": "./dist/gsd-parser/index.d.ts",
-      "import": "./dist/gsd-parser/index.js"
+      "default": "./dist/gsd-parser/index.js"
     },
     "./highlight": {
       "types": "./dist/highlight/index.d.ts",
-      "import": "./dist/highlight/index.js"
+      "default": "./dist/highlight/index.js"
     },
     "./json-parse": {
       "types": "./dist/json-parse/index.d.ts",
-      "import": "./dist/json-parse/index.js"
+      "default": "./dist/json-parse/index.js"
     },
     "./stream-process": {
       "types": "./dist/stream-process/index.d.ts",
-      "import": "./dist/stream-process/index.js"
+      "default": "./dist/stream-process/index.js"
     },
     "./truncate": {
       "types": "./dist/truncate/index.d.ts",
-      "import": "./dist/truncate/index.js"
+      "default": "./dist/truncate/index.js"
     },
     "./ttsr": {
       "types": "./dist/ttsr/index.d.ts",
-      "import": "./dist/ttsr/index.js"
+      "default": "./dist/ttsr/index.js"
     }
   },
   "files": [

package/packages/native/src/__tests__/module-compat.test.mjs

@@ -0,0 +1,91 @@
+/**
+ * Tests that the @gsd/native package.json is correctly configured
+ * for Node.js module resolution (ESM/CJS compatibility).
+ *
+ * Regression test for #2861: "type": "module" + "import"-only export
+ * conditions caused crashes on Node.js v24 when the parent package also
+ * declared "type": "module" and strict ESM resolution was enforced.
+ */
+
+import { test, describe } from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkgPath = path.resolve(__dirname, "..", "..", "package.json");
+const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+
+describe("@gsd/native module compatibility (#2861)", () => {
+  test("package.json must not declare type: module (compiled output is CJS-compatible)", () => {
+    // The compiled output uses createRequire() to load .node addons.
+    // Declaring "type": "module" forces Node.js to treat .js files as ESM,
+    // but the package needs "type": "commonjs" to override the parent
+    // package's "type": "module" and ensure correct CJS semantics.
+    assert.notEqual(
+      pkg.type,
+      "module",
+      'package.json must not set "type": "module" — this causes crashes on Node.js v24 ' +
+        "when the parent package also declares ESM (see #2861)",
+    );
+  });
+
+  test("package.json should explicitly declare type: commonjs", () => {
+    // When installed as a dependency under a parent with "type": "module"
+    // (e.g. gsd-pi), an absent "type" field would inherit the parent's
+    // ESM setting. Explicit "commonjs" overrides this.
+    assert.equal(
+      pkg.type,
+      "commonjs",
+      'package.json must explicitly set "type": "commonjs" to override ' +
+        "the parent package's ESM declaration",
+    );
+  });
+
+  test("all export conditions must use 'default' (not 'import'-only)", () => {
+    // The "import" condition key restricts resolution to ESM import
+    // statements only. Using "default" ensures the export works for both
+    // require() and import, which is essential for a CJS package that may
+    // be consumed from ESM code via Node's CJS interop.
+    const exportsMap = pkg.exports;
+    assert.ok(exportsMap, "package.json must have an exports map");
+
+    for (const [subpath, conditions] of Object.entries(exportsMap)) {
+      assert.ok(
+        !conditions.import || conditions.default,
+        `exports["${subpath}"] uses "import" condition without "default" — ` +
+          `this breaks CJS consumers and Node.js v24 strict resolution`,
+      );
+    }
+  });
+
+  test("native.ts source must not use bare import.meta.url (parse-time error in CJS)", () => {
+    // When compiled to CJS, import.meta is a *parse-time* syntax error --
+    // typeof guards don't help because Node rejects the syntax before
+    // executing any code.  The source must wrap import.meta access in
+    // an indirect eval so the CJS parser never sees the bare syntax.
+    const nativeSrc = readFileSync(
+      path.resolve(__dirname, "..", "native.ts"),
+      "utf8",
+    );
+
+    // Bare import.meta.url (NOT wrapped) would crash at parse time in CJS.
+    // These regexes match direct usage like fileURLToPath(import.meta.url)
+    // and createRequire(import.meta.url), but NOT indirect patterns that
+    // hide import.meta from the CJS parser.
+    const hasBareImportMetaDirname = /path\.dirname\(.*fileURLToPath\(import\.meta\.url\)\)/.test(nativeSrc);
+    const hasBareImportMetaRequire = /createRequire\(import\.meta\.url\)/.test(nativeSrc);
+
+    assert.ok(
+      !hasBareImportMetaDirname,
+      "native.ts must not use bare import.meta.url in fileURLToPath() -- " +
+        "this is a parse-time syntax error in CJS; use indirect eval",
+    );
+    assert.ok(
+      !hasBareImportMetaRequire,
+      "native.ts must not use bare import.meta.url in createRequire() -- " +
+        "this is a parse-time syntax error in CJS; use indirect eval",
+    );
+  });
+});