Migration from 0.x

The 0.x line is in maintenance mode on the 0.x branch. It targets Solid 1.x and receives fixes only. Version 1.0 targets Solid 2.0 and has no other new features of its own to port.

Version 1.0 rewrites the compiler from Babel to Oxc (oxc-parser + magic-string) and retargets the API surface at Solid 2.0. Two feature families were removed on purpose:

• Labels (signal: x = 0, effect: { ... }). Removed.
• Comment pragmas (/* @signal */, // @memo). Removed.

Compile-time functions (CTFs) are the single remaining syntax. They are explicit call sites, easier to type-check, and they survive formatters and linters that labels and comments never played well with.

CTF names now mirror Solid 2.0 keywords exactly (onSettled → $settled, snapshot → $snapshot). One name per API. The 1.x-flavored aliases ($mount, $unwrap) are gone.

#Dropped (the Solid 1.x API no longer exists)

#Translated (same idea, 2.0 name and semantics)

#Decided (was undecided)

#$effect / $renderEffect: capture compilation

Solid 2.0 split createEffect into a tracked compute phase and an untracked apply phase. Instead of aliasing one of the phases, $effect now compiles the single-callback form into both phases mechanically: the compiler collects every outer identifier the callback uses, reads them (tracking signals) in a generated compute phase, and hands the raw values to the callback.

let bar = $signal(someValue());
$effect(() => {
  foo(bar);
});

import { createSignal as _createSignal } from "solid-js";
import { createEffect as _createEffect } from "solid-js";
let [bar, setbar_1] = _createSignal(() => someValue());
_createEffect(() => [bar()], effectCallback_1);
function effectCallback_1([bar]) {
  foo(bar);
}

import { createSignal as _createSignal } from "solid-js";
import { createEffect as _createEffect } from "solid-js";
let [bar, setbar_1] = _createSignal(() => someValue(), { name: "bar" });
_createEffect(() => [bar()], effectCallback_1);
function effectCallback_1([bar]) {
  foo(bar);
}

The callback is hoisted to module level when possible (no this, arguments, super, and no writes to plain outer variables); otherwise it stays inline with a destructured parameter list. See the $effect reference for the full rules.

$renderEffect and the $(expr); statement compile through the same capture mechanism ($ treats the expression as the callback body). There is no alias for createTrackedEffect, which Solid deprecates. Use $effect, or $settled for one-time DOM work.

#Output changes from the Babel era

• Signal/memo variables keep their original names. Only setters get generated names (setcount_1 instead of renaming count to count_1).
• $getter / $setter / $property emit plain own getters/setters instead of the shared-__proto__ objects the Babel compiler produced.
• $destructure rest uses omit(target, "a", "b"); the splitProps tuple-index form is gone.
• Output preserves your formatting (span edits, not re-printing), and source maps come from magic-string in high-resolution mode.

#Compiler API

compile() from solid-labels/compiler is now synchronous and returns CompileOutput directly. Drop the await.

#Plugin packages

vite-plugin-solid-labels and rollup-plugin-solid-labels are discontinued. Use unplugin-solid-labels for every bundler. The options are the same.

import solidLabels from 'unplugin-solid-labels';

// Vite
solidLabels.vite({ ... });

// Rollup
solidLabels.rollup({ ... });

#Plugin options

disabled.label and disabled.pragma are gone. Only disabled.ctf remains:

solidLabels({
  disabled: {
    ctf: {
      $signal: true,
    },
  },
});