@solidjs/compiler 2.0.0-rc.7 → 2.0.0-rc.8

package/README.md

@@ -113,6 +113,7 @@ Pass `sourceMap: true` to receive a JSON source map string in `result.map`. For
 - `generate`: `"dom"`, `"ssr"`, `"universal"`, or `"dynamic"` (default `"dom"`)
 - `hydratable`
 - `dev`
+- `componentNames`: DOM output only — emit the source tag name as `createComponent`'s third argument (`createComponent(Home, props, "Home")`) so dev/observe runtimes label owners after minification; the production runtime ignores it
 - `sourceMap`
 - `contextToCustomElements` (default `true`)
 - `delegateEvents`
@@ -150,7 +151,13 @@ result.code;
 result.functions; // [{ id, name, exports }] for manifest building
 ```
 
-The runtime module defaults to `@solidjs/web/server-functions`. Function IDs use `xxhash32(root-relative path)-<count>` (name-suffixed with `env: "development"`). There are also experimental `transformLazy` and `transformRefresh` passes.
+A function-level `"use server"` function is extracted out of its lexical position, so it may only reference its own parameters and locals, module top-level bindings, and globals. Capturing anything else is a compile error. That includes `this` and `arguments` in a marked arrow, which an arrow takes from the function it was written in. Use a `function` if the server function needs its own `this` or `arguments`.
+
+A function-level directive only works where the pass can extract the function: a function declaration (at any nesting depth), a function expression, or an arrow with a block body. Methods, getters, and setters are never extracted, so a directive on one is a compile error rather than a directive that silently does nothing. Assign a function to a property instead.
+
+A module-level `"use server"` module can only export server functions. Its client build is rebuilt from those exports alone, so anything else would be missing from the browser bundle. Re-exports, `export *`, class and enum exports, destructured exports, and exports declared without an initializer are compile errors naming the export and its position. Type-only and `declare` exports are erased and are fine.
+
+The runtime module defaults to `@solidjs/web/server-functions`. Function IDs are `<name>-<xxhash32(root-relative path)>`, the same in every env. The name is the function's dotted binding path, such as `handlers.save`, built from every named container on the way down (variable bindings, property keys, class names, class members, and named functions), so an id identifies a function by where it is bound rather than by its position in the file. Adding, removing, or reordering functions does not move the ids of the others. There are also experimental `transformLazy` and `transformRefresh` passes.
 
 ## Rust compiler core
 

package/index.js

@@ -261,6 +261,7 @@ const nativeOptionKeys = new Set([
   "generate",
   "hydratable",
   "dev",
+  "componentNames",
   "sourceMap",
   "contextToCustomElements",
   "delegateEvents",

package/package.json

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

package/types.d.ts

@@ -12,6 +12,13 @@ export interface TransformOptions {
   generate?: "dom" | "ssr" | "universal" | "dynamic";
   hydratable?: boolean;
   dev?: boolean;
+  /**
+   * Emit the source tag name as a third `createComponent` argument
+   * (`createComponent(Home, props, "Home")`) so dev/observe runtimes can
+   * label owners after minification renames the function. DOM output only;
+   * the production runtime ignores the argument.
+   */
+  componentNames?: boolean;
   sourceMap?: boolean;
   contextToCustomElements?: boolean;
   delegateEvents?: boolean;
@@ -131,8 +138,12 @@ export interface TransformDirectivesOptions {
 
 /** One extracted server function, for building a bundler manifest. */
 export interface ServerFunctionMeta {
-  /** The wire ID (`<hash>-<count>[-<name>]`). */
+  /** The wire ID (`<name>-<hash>[-<ordinal>]`). */
   id: string;
+  /**
+   * The dotted binding path that names the function, such as
+   * `handlers.save`. `anonymous` when no enclosing binding applies.
+   */
   name: string;
   /** Export names bound to this function (module-level directives only). */
   exports: string[];