@solidjs/compiler 2.0.0-rc.15 → 2.0.0-rc.17

package/README.md

@@ -113,7 +113,8 @@ Pass `sourceMap: true` to receive a JSON source map string in `result.map`. For
 - `generate`: `"dom"`, `"ssr"`, `"universal"`, or `"dynamic"` (default `"dom"`)
 - `hydratable`
 - `dev`
-- `sourceNames` (`boolean | { components?: boolean; bindings?: boolean }`, default follows `dev`): names as written in source, carried into output so dev/observe runtimes can label the reactive graph after minification. Unset, every kind is on when `dev: true` and off otherwise; `true`/`false` sets every kind (`sourceNames: false` opts a dev build out); the object form picks, and each kind it leaves unspecified follows `dev`. Production output (`dev: false`) is byte-identical with the option set or unset. Same shape and defaults as `@solidjs/babel-plugin`'s option. `components` emits the source tag name as `createComponent`'s third argument (`createComponent(Home, props, "Home")`) — DOM and SSR output (SSR keeps the `createComponent` call it otherwise inlines to `Comp(props)`); not universal or dynamic. `bindings` names every compiled binding effect by what it writes — `effect(…, { name: "span.textContent" })`, a hole `insert(el, v, undefined, undefined, { name: "div.children" })`, a spread `spread(el, props, false, undefined, "div")` (labelled `div.spread` / `div.children` by the runtime) — DOM output only. The production runtimes ignore the names. These are the JSX-level kinds only: naming the primitives themselves is the separate `transformSourceNames` pass below, which the build tool runs on every module independently of the JSX compiler
+- `root` (`string`, default the working directory): the project root `sourceNames.locations` paths (and `transformSourceNames`'s `loc`) are made relative to — the same meaning as `transformDirectives`'s `root`.
+- `sourceNames` (`boolean | { components?: boolean; bindings?: boolean; locations?: boolean }`, default follows `dev`): names as written in source, carried into output so dev/observe runtimes can label the reactive graph after minification. Unset, every kind is on when `dev: true` and off otherwise; `true`/`false` sets every kind (`sourceNames: false` opts a dev build out); the object form picks, and each kind it leaves unspecified follows `dev`. Production output (`dev: false`) is byte-identical with the option set or unset. Same shape and defaults as `@solidjs/babel-plugin`'s option. `components` emits the source tag name as `createComponent`'s third argument (`createComponent(Home, props, "Home")`) — DOM and SSR output (SSR keeps the `createComponent` call it otherwise inlines to `Comp(props)`); not universal or dynamic. `bindings` names every compiled binding effect by what it writes — `effect(…, { name: "span.textContent" })`, a hole `insert(el, v, undefined, undefined, { name: "div.children" })`, a spread `spread(el, props, false, undefined, "div")` (labelled `div.spread` / `div.children` by the runtime) — DOM output only. `locations` adds the source position beside each name the other two kinds emit, as `<path>:<line>:<column>` with the path relative to `root` (posix separators, `..` when the file is outside the root) and the column 1-based (the stack-trace and editor convention, so `http://localhost:5173/src/App.tsx:18:3` links to the right place): `createComponent(Home, props, "Home", "src/App.tsx:12:5")` — the start of the opening element — and `loc` right after `name` in a binding's options, `effect(…, { name: "div.class", loc: "src/App.tsx:14:7" })` — the attribute's start, a hole's `{`, a spread's `{...props}` (a spread's location rides as one more positional string after the tag). Nothing is emitted without a `filename`. The production runtimes ignore the names. These are the JSX-level kinds only: naming the primitives themselves is the separate `transformSourceNames` pass below, which the build tool runs on every module independently of the JSX compiler
 - `sourceMap`
 - `contextToCustomElements` (default `true`)
 - `delegateEvents`
@@ -130,7 +131,6 @@ Pass `sourceMap: true` to receive a JSON source map string in `result.map`. For
 - `omitLastClosingTag`
 - `builtIns` (default `["For", "Show", "Switch", "Match", "Loading", "Reveal", "Portal", "Repeat", "Dynamic", "Errored"]`)
 - `requireImportSource`
-- `serverComponents`
 - `hoistProps` (default `true`; SSR only)
 - `renderers`
 
@@ -162,7 +162,7 @@ The runtime module defaults to `@solidjs/web/server-functions`. Function IDs are
 
 ### Source names for primitives
 
-`transformSourceNames(code, { filename?, sourceMap? })` is the pass behind `@solidjs/vite-plugin`'s `sourceNames.primitives` option: it names reactive primitives after the identifier they are declared as, so the dev and observe runtimes label graph nodes `count` / `doubled` / `todos.title` instead of `signal` / `computed` / `store.title`. It is plain JavaScript in and out (JSX passes through untouched), which is why it is its own pass rather than a `transform()` option — primitives live in `.ts`/`.js` modules as much as in components. This standalone pass is the single owner of primitive naming: the build tool runs it on every module — `.ts`, `.js`, and JSX files alike — independently of which JSX compiler (this one or `@solidjs/babel-plugin`) handles the file's JSX, so there is no Babel counterpart and `transform()`'s `sourceNames` covers only the JSX-level kinds. `@solidjs/vite-plugin` (solid-vite-plugin #371, `solid: { sourceNames }`) runs it ahead of the JSX transform for the dev and `observe` postures.
+`transformSourceNames(code, { filename?, locations?, root?, sourceMap? })` is the pass behind `@solidjs/vite-plugin`'s `sourceNames.primitives` option: it names reactive primitives after the identifier they are declared as, so the dev and observe runtimes label graph nodes `count` / `doubled` / `todos.title` instead of `signal` / `computed` / `store.title`. With `locations` (default `true` — the pass only runs for the dev and observe postures) and a `filename`, the options literal also carries the call's position right after the name, `createSignal(0, { name: "count", loc: "src/store.ts:3:22" })` (`filename` relative to `root`, column 1-based); an explicit `name` is kept and `loc` still added, an explicit `loc` is never overridden. It is plain JavaScript in and out (JSX passes through untouched), which is why it is its own pass rather than a `transform()` option — primitives live in `.ts`/`.js` modules as much as in components. This standalone pass is the single owner of primitive naming: the build tool runs it on every module — `.ts`, `.js`, and JSX files alike — independently of which JSX compiler (this one or `@solidjs/babel-plugin`) handles the file's JSX, so there is no Babel counterpart and `transform()`'s `sourceNames` covers only the JSX-level kinds. `@solidjs/vite-plugin` (solid-vite-plugin #371, `solid: { sourceNames }`) runs it ahead of the JSX transform for the dev and `observe` postures.
 
 ```js
 const [count, setCount] = createSignal(0);          // createSignal(0, { name: "count" })

package/index.js

@@ -10,7 +10,7 @@ function transform(code, options) {
     throw new TypeError("@solidjs/compiler transform() expects source code as a string");
   }
 
-  const nativeOptions = validateOptions(code, options);
+  const nativeOptions = hostRoot(validateOptions(code, options));
   const result = native.transform(code, nativeOptions);
   const output = {
     code: result.code,
@@ -71,7 +71,7 @@ function transformDirectives(code, options) {
     throw new TypeError("@solidjs/compiler transformDirectives() expects source code as a string");
   }
 
-  const nativeOptions = validateDirectivesOptions(options);
+  const nativeOptions = hostRoot(validateDirectivesOptions(options));
   const result = native.transformDirectives(code, nativeOptions);
   return {
     code: result.code,
@@ -124,7 +124,7 @@ function transformSourceNames(code, options) {
     throw new TypeError("@solidjs/compiler transformSourceNames() expects source code as a string");
   }
 
-  const nativeOptions = validateSourceNamesOptions(options);
+  const nativeOptions = hostRoot(validateSourceNamesOptions(options));
   const result = native.transformSourceNames(code, nativeOptions);
   return {
     code: result.code,
@@ -136,7 +136,7 @@ function transformSourceNamesAsync(code, options) {
   return Promise.resolve().then(() => transformSourceNames(code, options));
 }
 
-const sourceNamesOptionKeys = new Set(["filename", "sourceMap"]);
+const sourceNamesOptionKeys = new Set(["filename", "locations", "root", "sourceMap"]);
 
 function validateSourceNamesOptions(options) {
   if (options == null) return options;
@@ -149,11 +149,11 @@ function validateSourceNamesOptions(options) {
     if (!sourceNamesOptionKeys.has(key)) {
       throw new Error(`@solidjs/compiler received unknown option \`${key}\``);
     }
-    if (key === "filename" && typeof value !== "string") {
-      throw new TypeError("@solidjs/compiler `filename` option must be a string");
+    if ((key === "filename" || key === "root") && typeof value !== "string") {
+      throw new TypeError(`@solidjs/compiler \`${key}\` option must be a string`);
     }
-    if (key === "sourceMap" && typeof value !== "boolean") {
-      throw new TypeError("@solidjs/compiler `sourceMap` option must be boolean");
+    if ((key === "sourceMap" || key === "locations") && typeof value !== "boolean") {
+      throw new TypeError(`@solidjs/compiler \`${key}\` option must be boolean`);
     }
     nativeOptions[key] = value;
   }
@@ -297,6 +297,7 @@ function validateImportDefinition(key, value) {
 
 const nativeOptionKeys = new Set([
   "filename",
+  "root",
   "moduleName",
   "generate",
   "hydratable",
@@ -317,7 +318,6 @@ const nativeOptionKeys = new Set([
   "staticMarker",
   "omitNestedClosingTags",
   "omitLastClosingTag",
-  "serverComponents",
   "hoistProps",
   "builtIns",
   "renderers"
@@ -368,6 +368,16 @@ function validateOptions(code, options) {
       nativeOptions.sourceNames = value;
       continue;
     }
+    // Removed with binding slots (2026-10-16). Still accepted, and ignored,
+    // because @solidjs/vite-plugin passes it for server-component builds.
+    if (key === "serverComponents") continue;
+    if (key === "root") {
+      if (typeof value !== "string") {
+        throw new TypeError("@solidjs/compiler `root` option must be a string");
+      }
+      nativeOptions.root = value;
+      continue;
+    }
     if (nativeOptionKeys.has(key)) {
       if (key === "renderers") validateRenderers(value);
       nativeOptions[key] = value;
@@ -378,7 +388,7 @@ function validateOptions(code, options) {
   return nativeOptions;
 }
 
-const sourceNameKinds = new Set(["components", "bindings"]);
+const sourceNameKinds = new Set(["components", "bindings", "locations"]);
 
 function validateSourceNames(value) {
   if (typeof value === "boolean") return;
@@ -435,6 +445,23 @@ function tryPackage(packageName) {
   }
 }
 
+// The binding makes `filename` relative to `root` (`loc` paths, directive
+// hashes), resolving both against its own working directory. A WASI binding
+// cannot see the host's (it starts at `/`), so hand it a `root` that needs
+// none: absolute beside an absolute filename (the working directory when
+// unset), relative beside a relative one. The result is unchanged on a native
+// binding.
+function hostRoot(nativeOptions) {
+  if (nativeOptions == null || typeof nativeOptions.filename !== "string") return nativeOptions;
+  const { filename, root } = nativeOptions;
+  if (path.isAbsolute(filename)) {
+    nativeOptions.root = path.resolve(root ?? ".");
+  } else if (root !== undefined && path.isAbsolute(root)) {
+    nativeOptions.root = path.relative(process.cwd(), root) || ".";
+  }
+  return nativeOptions;
+}
+
 function requireBinding() {
   const explicit = process.env.SOLID_COMPILER_NATIVE;
   if (explicit) return require(explicit);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@solidjs/compiler",
   "description": "Solid's native Oxc JSX compiler",
-  "version": "2.0.0-rc.15",
+  "version": "2.0.0-rc.17",
   "author": "Ryan Carniato",
   "license": "MIT",
   "repository": {
@@ -62,11 +62,11 @@
     "emnapi": "^1.11.3"
   },
   "optionalDependencies": {
-    "@solidjs/compiler-darwin-x64": "2.0.0-rc.15",
-    "@solidjs/compiler-darwin-arm64": "2.0.0-rc.15",
-    "@solidjs/compiler-linux-x64-gnu": "2.0.0-rc.15",
-    "@solidjs/compiler-linux-arm64-gnu": "2.0.0-rc.15",
-    "@solidjs/compiler-win32-x64-msvc": "2.0.0-rc.15",
-    "@solidjs/compiler-wasm32-wasi": "2.0.0-rc.15"
+    "@solidjs/compiler-darwin-x64": "2.0.0-rc.17",
+    "@solidjs/compiler-darwin-arm64": "2.0.0-rc.17",
+    "@solidjs/compiler-linux-x64-gnu": "2.0.0-rc.17",
+    "@solidjs/compiler-linux-arm64-gnu": "2.0.0-rc.17",
+    "@solidjs/compiler-win32-x64-msvc": "2.0.0-rc.17",
+    "@solidjs/compiler-wasm32-wasi": "2.0.0-rc.17"
   }
 }

package/types.d.ts

@@ -4,10 +4,22 @@ export interface SourceNamesOptions {
   components?: boolean;
   /** Binding effect labels: the element and attribute (or hole) each compiled effect writes. */
   bindings?: boolean;
+  /**
+   * Source locations beside each emitted name: `file:line:col` (`filename`
+   * relative to `root`, column 1-based) as `createComponent`'s fourth
+   * argument and as `loc` after `name` in a binding's options. Only where
+   * the name is emitted, and only with a `filename`.
+   */
+  locations?: boolean;
 }
 
 export interface TransformOptions {
   filename?: string;
+  /**
+   * Project root the `sourceNames.locations` paths are made relative to.
+   * Defaults to the working directory.
+   */
+  root?: string;
   /** Default `"@solidjs/web"`. */
   moduleName?: string;
   /**
@@ -30,6 +42,10 @@ export interface TransformOptions {
    * binding effect named by what it writes — `span.textContent`,
    * `div.class:active`, a hole `div.children`, a spread `div.spread` — as
    * an options argument on `effect`/`insert`/`spread`; DOM output only.
+   * `locations`: the source position (`src/App.tsx:12:5`, `filename`
+   * relative to `root`) beside each emitted name — a fourth `createComponent`
+   * argument, `loc` after `name` in a binding's options — so a console
+   * report can point at the line; nothing without a `filename`.
    * The production runtimes ignore the names. Defaults to `dev`: unset,
    * every kind is on in dev and off otherwise; `true`/`false` sets every
    * kind; an object picks, and each kind it leaves unspecified follows
@@ -53,6 +69,7 @@ export interface TransformOptions {
   validate?: boolean;
   omitNestedClosingTags?: boolean;
   omitLastClosingTag?: boolean;
+  /** @deprecated Ignored. Binding slots, the only thing it compiled for, are removed. */
   serverComponents?: boolean;
   /** SSR-only, default `true`: component props literals with getters compile to module-level constructors with shared getters (#3511). */
   hoistProps?: boolean;
@@ -275,8 +292,27 @@ export function transformRefreshAsync(
  * `sourceNames` option covers only the JSX-level kinds.
  */
 export interface TransformSourceNamesOptions {
-  /** Picks the parser dialect (`.ts`, `.tsx`, `.js`, `.jsx`); TSX without one. */
+  /**
+   * Picks the parser dialect (`.ts`, `.tsx`, `.js`, `.jsx`); TSX without
+   * one. Also the file the `loc` strings name: without one no `loc` is
+   * written.
+   */
   filename?: string;
+  /**
+   * Write `loc` after `name` in each options literal: the call's
+   * `file:line:col` (`filename` relative to `root`, column 1-based), so
+   * `createSignal(0, { name: "count", loc: "src/store.ts:3:22" })`. An
+   * explicit `name` is kept and `loc` still added; an explicit `loc` is
+   * never overridden. The pass only runs for the dev and observe postures,
+   * so this is on by default.
+   * @default true
+   */
+  locations?: boolean;
+  /**
+   * Project root the `loc` paths are made relative to. Defaults to the
+   * working directory.
+   */
+  root?: string;
   sourceMap?: boolean;
 }