@knighted/jsx 1.4.1 → 1.5.0

package/README.md

@@ -99,7 +99,7 @@ The React runtime shares the same template semantics as `jsx`, except it returns
 
 - `style` accepts either a string or an object. Object values handle CSS custom properties (`--token`) automatically.
 - `class` and `className` both work and can be strings or arrays.
-- Event handlers use the `on<Event>` naming convention (e.g. `onClick`).
+- Event handlers use the `on<Event>` naming convention (e.g. `onClick`), support capture-phase variants via `on<Event>Capture`, and allow custom events with the `on:custom-event` syntax (descriptor objects with `{ handler, once, capture }` are also accepted).
 - `ref` supports callback refs as well as mutable `{ current }` objects.
 - `dangerouslySetInnerHTML` expects an object with an `__html` field, mirroring React.
 
@@ -286,6 +286,26 @@ import { reactJsx as nodeReactJsx } from '@knighted/jsx/node/react/lite'
 
 Each lite subpath ships the same API as its standard counterpart but is pre-minified and scoped to just that runtime (DOM, React, Node DOM, or Node React). Swap them in when you want the smallest possible bundles; otherwise the default exports keep working as-is.
 
+## Common gotchas
+
+### DocumentFragment reuse (DOM helper)
+
+`jsx` returns actual DOM nodes, so fragments compile down to real `DocumentFragment` instances. The browser treats those fragments as one-time transport containers: append them to a parent, and the fragment empties itself as it moves its children. Unlike VDOM libraries (React, Preact, Solid), we do not clone fragments on your behalf, so storing a fragment and reusing it later will not work the way a React developer might expect.
+
+```ts
+const header = jsx`
+  <>
+    <h1>Title</h1>
+    <p>Reusable? Only if you clone.</p>
+  </>
+`
+
+document.querySelector('header')!.append(header)
+document.querySelector('footer')!.append(header) // footer stays empty
+```
+
+When you need multiple copies, call the template again, wrap it in a helper (``const makeHeader = () => jsx`<...>`; makeHeader()``), or clone the fragment before reusing it (`footer.append(header.cloneNode(true))`). Components that return fragments are unaffected because every invocation produces a fresh fragment.
+
 ## Limitations
 
 - Requires a DOM-like environment (it throws when `document` is missing).

package/dist/cjs/cli/init.cjs

@@ -8,6 +8,9 @@ exports.detectPackageManager = detectPackageManager;
 exports.ensurePackageJson = ensurePackageJson;
 exports.runNpmPack = runNpmPack;
 exports.parsePackageName = parsePackageName;
+exports.resolveBindingSpec = resolveBindingSpec;
+exports.fetchLatestBindingVersion = fetchLatestBindingVersion;
+exports.readLocalOxcParserVersion = readLocalOxcParserVersion;
 exports.installBinding = installBinding;
 exports.installRuntimeDeps = installRuntimeDeps;
 exports.isDependencyInstalled = isDependencyInstalled;
@@ -23,7 +26,10 @@ const promises_1 = __importDefault(require("node:readline/promises"));
 const node_module_1 = require("node:module");
 const node_url_1 = require("node:url");
 const tar_1 = require("tar");
-const DEFAULT_BINDING_SPEC = process.env.WASM_BINDING_PACKAGE ?? '@oxc-parser/binding-wasm32-wasi@^0.99.0';
+const CLI_REQUIRE = (0, node_module_1.createRequire)(typeof __filename !== 'undefined' ? __filename : node_path_1.default.join(process.cwd(), 'noop.js'));
+const DEFAULT_BINDING_PACKAGE_NAME = '@oxc-parser/binding-wasm32-wasi';
+const DEFAULT_BINDING_PACKAGE = process.env.WASM_BINDING_PACKAGE ?? DEFAULT_BINDING_PACKAGE_NAME;
+const DEFAULT_BINDING_SOURCE = process.env.WASM_BINDING_PACKAGE ? 'env' : 'default';
 const RUNTIME_DEPS = ['@napi-rs/wasm-runtime', '@emnapi/runtime', '@emnapi/core'];
 const SUPPORTED_PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'];
 // Node emits a noisy ExperimentalWarning whenever the WASI shim loads; silence just that message.
@@ -48,7 +54,9 @@ function parseArgs(argv) {
         verbose: false,
         force: false,
         skipConfig: true,
-        wasmPackage: DEFAULT_BINDING_SPEC,
+        wasmPackage: DEFAULT_BINDING_PACKAGE,
+        wasmVersion: undefined,
+        wasmPackageSource: DEFAULT_BINDING_SOURCE,
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
@@ -82,6 +90,14 @@ function parseArgs(argv) {
             if (!pkg)
                 throw new Error('Missing value for --wasm-package');
             options.wasmPackage = pkg;
+            options.wasmPackageSource = 'flag';
+            i += 1;
+        }
+        else if (arg === '--wasm-version') {
+            const version = argv[i + 1];
+            if (!version)
+                throw new Error('Missing value for --wasm-version');
+            options.wasmVersion = version;
             i += 1;
         }
         else if (arg === '--help' || arg === '-h') {
@@ -92,7 +108,7 @@ function parseArgs(argv) {
     return options;
 }
 function printHelp() {
-    console.log(`\nUsage: npx @knighted/jsx init [options]\n\nOptions:\n  --package-manager, --pm <name>  Choose npm | pnpm | yarn | bun\n  --wasm-package <spec>           Override binding package spec\n  --config                        Prompt to help with loader config\n  --skip-config                   Skip any loader config prompts (default)\n  --dry-run                       Print actions without executing\n  --force, --yes                  Assume yes for prompts\n  --verbose                       Log extra detail\n  -h, --help                      Show this help message\n`);
+    console.log(`\nUsage: npx @knighted/jsx init [options]\n\nOptions:\n  --package-manager, --pm <name>  Choose npm | pnpm | yarn | bun\n  --wasm-package <spec>           Override binding package spec\n  --wasm-version <version>        Pin version for the default binding\n  --config                        Prompt to help with loader config\n  --skip-config                   Skip any loader config prompts (default)\n  --dry-run                       Print actions without executing\n  --force, --yes                  Assume yes for prompts\n  --verbose                       Log extra detail\n  -h, --help                      Show this help message\n`);
 }
 function log(message) {
     console.log(message);
@@ -148,6 +164,73 @@ function parsePackageName(spec) {
     const [, name, version] = match;
     return { name, version };
 }
+function readLocalOxcParserVersion(resolver = CLI_REQUIRE) {
+    try {
+        const pkg = resolver('oxc-parser/package.json');
+        if (pkg && typeof pkg.version === 'string') {
+            return pkg.version;
+        }
+    }
+    catch {
+        // Ignore resolution failures and fall back to registry lookup later.
+    }
+    return undefined;
+}
+function isRegistryResolvablePackage(name) {
+    if (!name)
+        return false;
+    if (name.startsWith('.') || name.startsWith('/'))
+        return false;
+    if (node_path_1.default.isAbsolute(name))
+        return false;
+    const blockedPrefixes = [
+        'file:',
+        'link:',
+        'git+',
+        'github:',
+        'workspace:',
+        'http://',
+        'https://',
+    ];
+    return !blockedPrefixes.some(prefix => name.startsWith(prefix));
+}
+function fetchLatestBindingVersion(pkgName, execFn = node_child_process_1.execFileSync) {
+    const output = execFn('npm', ['view', pkgName, 'version', '--json'], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'inherit'],
+    }).trim();
+    if (!output) {
+        throw new Error(`Unable to determine latest version for ${pkgName}`);
+    }
+    const parsed = JSON.parse(output);
+    if (typeof parsed === 'string')
+        return parsed;
+    if (Array.isArray(parsed) && parsed.length > 0) {
+        const last = parsed[parsed.length - 1];
+        if (typeof last === 'string')
+            return last;
+    }
+    throw new Error(`Unable to determine latest version for ${pkgName}`);
+}
+function resolveBindingSpec(spec, explicitVersion, fetchLatest = fetchLatestBindingVersion) {
+    let combinedSpec = spec;
+    if (explicitVersion) {
+        const { name } = parsePackageName(spec);
+        if (!name) {
+            throw new Error(`Unable to parse binding package spec: ${spec}`);
+        }
+        combinedSpec = `${name}@${explicitVersion}`;
+    }
+    const { name, version } = parsePackageName(combinedSpec);
+    if (!name) {
+        throw new Error(`Unable to parse binding package spec: ${spec}`);
+    }
+    if (version || !isRegistryResolvablePackage(name)) {
+        return { spec: combinedSpec, name, version };
+    }
+    const latest = fetchLatest(name);
+    return { spec: `${name}@${latest}`, name, version: latest };
+}
 async function installBinding(spec, cwd, dryRun, verbose, pack = runNpmPack) {
     const { name, version } = parsePackageName(spec);
     const tarballName = pack(spec, cwd, dryRun, verbose);
@@ -248,13 +331,17 @@ async function maybeHandleConfigPrompt(skipConfig, force) {
     console.log(LOADER_CONFIG_EXAMPLE);
 }
 async function main(overrides = {}) {
-    const { parseArgs: parseArgsImpl = parseArgs, ensurePackageJson: ensurePackageJsonImpl = ensurePackageJson, detectPackageManager: detectPackageManagerImpl = detectPackageManager, installRuntimeDeps: installRuntimeDepsImpl = installRuntimeDeps, installBinding: installBindingImpl = installBinding, persistBindingSpec: persistBindingSpecImpl = persistBindingSpec, verifyBinding: verifyBindingImpl = verifyBinding, maybeHandleConfigPrompt: maybeHandleConfigPromptImpl = maybeHandleConfigPrompt, log: logImpl = log, } = overrides;
+    const { parseArgs: parseArgsImpl = parseArgs, ensurePackageJson: ensurePackageJsonImpl = ensurePackageJson, detectPackageManager: detectPackageManagerImpl = detectPackageManager, installRuntimeDeps: installRuntimeDepsImpl = installRuntimeDeps, installBinding: installBindingImpl = installBinding, persistBindingSpec: persistBindingSpecImpl = persistBindingSpec, verifyBinding: verifyBindingImpl = verifyBinding, maybeHandleConfigPrompt: maybeHandleConfigPromptImpl = maybeHandleConfigPrompt, resolveBindingSpec: resolveBindingSpecImpl = resolveBindingSpec, readLocalOxcParserVersion: readLocalOxcParserVersionImpl = readLocalOxcParserVersion, log: logImpl = log, } = overrides;
     const options = parseArgsImpl(process.argv.slice(2));
     ensurePackageJsonImpl(options.cwd);
+    const bundledParserVersion = readLocalOxcParserVersionImpl();
+    const desiredBindingVersion = options.wasmVersion ??
+        (options.wasmPackageSource === 'default' ? bundledParserVersion : undefined);
+    const resolvedBinding = resolveBindingSpecImpl(options.wasmPackage, desiredBindingVersion);
     const packageManager = detectPackageManagerImpl(options.cwd, options.packageManager);
     logImpl(`> Using package manager: ${packageManager}`);
     const installedRuntimeDeps = installRuntimeDepsImpl(packageManager, RUNTIME_DEPS, options.cwd, options.dryRun, options.verbose);
-    const binding = await installBindingImpl(options.wasmPackage, options.cwd, options.dryRun, options.verbose);
+    const binding = await installBindingImpl(resolvedBinding.spec, options.cwd, options.dryRun, options.verbose);
     persistBindingSpecImpl(options.cwd, binding.name, binding.version, options.dryRun, options.verbose);
     let resolvedPath;
     if (!options.dryRun) {

package/dist/cjs/cli/init.d.cts

@@ -1,4 +1,5 @@
 import { execFileSync, spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
 declare const SUPPORTED_PACKAGE_MANAGERS: readonly ["npm", "pnpm", "yarn", "bun"];
 type PackageManager = (typeof SUPPORTED_PACKAGE_MANAGERS)[number];
 type CliOptions = {
@@ -9,6 +10,8 @@ type CliOptions = {
     skipConfig: boolean;
     packageManager?: PackageManager;
     wasmPackage: string;
+    wasmVersion?: string;
+    wasmPackageSource: 'default' | 'env' | 'flag';
 };
 declare function parseArgs(argv: string[]): CliOptions;
 declare function log(message: string): void;
@@ -22,6 +25,14 @@ declare function parsePackageName(spec: string): {
     name: string;
     version: string;
 };
+type NodeRequireFn = ReturnType<typeof createRequire>;
+declare function readLocalOxcParserVersion(resolver?: NodeRequireFn): string | undefined;
+declare function fetchLatestBindingVersion(pkgName: string, execFn?: typeof execFileSync): string;
+declare function resolveBindingSpec(spec: string, explicitVersion?: string, fetchLatest?: typeof fetchLatestBindingVersion): {
+    spec: string;
+    name: string;
+    version: string | undefined;
+};
 type PackFunction = (spec: string, cwd: string, dryRun: boolean, verbose: boolean) => string;
 declare function installBinding(spec: string, cwd: string, dryRun: boolean, verbose: boolean, pack?: PackFunction): Promise<{
     targetDir: string;
@@ -45,7 +56,9 @@ type MainDeps = {
     persistBindingSpec: typeof persistBindingSpec;
     verifyBinding: typeof verifyBinding;
     maybeHandleConfigPrompt: typeof maybeHandleConfigPrompt;
+    resolveBindingSpec: typeof resolveBindingSpec;
+    readLocalOxcParserVersion: typeof readLocalOxcParserVersion;
     log: typeof log;
 };
 declare function main(overrides?: Partial<MainDeps>): Promise<void>;
-export { parseArgs, detectPackageManager, ensurePackageJson, runNpmPack, parsePackageName, installBinding, installRuntimeDeps, isDependencyInstalled, persistBindingSpec, verifyBinding, promptYesNo, maybeHandleConfigPrompt, main, };
+export { parseArgs, detectPackageManager, ensurePackageJson, runNpmPack, parsePackageName, resolveBindingSpec, fetchLatestBindingVersion, readLocalOxcParserVersion, installBinding, installRuntimeDeps, isDependencyInstalled, persistBindingSpec, verifyBinding, promptYesNo, maybeHandleConfigPrompt, main, };

package/dist/cjs/jsx-runtime.d.cts

@@ -9,8 +9,25 @@ type DataAttributes = {
 type AriaAttributes = {
     [K in `aria-${string}`]?: string | number | boolean | null | undefined;
 };
+type JsxEventListener<EV extends Event> = ((event: EV) => void) | {
+    handleEvent(event: EV): void;
+};
+type JsxEventDescriptor<EV extends Event> = {
+    handler: JsxEventListener<EV>;
+    capture?: boolean;
+    once?: boolean;
+    passive?: boolean;
+    signal?: AbortSignal;
+};
+type JsxEventProp<EV extends Event> = JsxEventListener<EV> | JsxEventDescriptor<EV>;
 type EventHandlers<T extends EventTarget> = {
-    [K in keyof GlobalEventHandlersEventMap as `on${Capitalize<string & K>}`]?: (event: GlobalEventHandlersEventMap[K]) => void;
+    [K in keyof GlobalEventHandlersEventMap as `on${Capitalize<string & K>}`]?: JsxEventProp<GlobalEventHandlersEventMap[K]>;
+} & {
+    [K in keyof GlobalEventHandlersEventMap as `on${Capitalize<string & K>}Capture`]?: JsxEventProp<GlobalEventHandlersEventMap[K]>;
+} & {
+    [K in string as K extends '' ? never : `on:${K}`]?: JsxEventProp<CustomEvent<unknown>>;
+} & {
+    [K in string as K extends '' ? never : `on:${K}Capture`]?: JsxEventProp<CustomEvent<unknown>>;
 };
 type ElementProps<Tag extends keyof HTMLElementTagNameMap> = Omit<Partial<HTMLElementTagNameMap[Tag]>, 'children'> & EventHandlers<HTMLElementTagNameMap[Tag]> & DataAttributes & AriaAttributes & {
     class?: string;

package/dist/cjs/jsx.cjs

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.jsx = void 0;
 const oxc_parser_1 = require("oxc-parser");
 const shared_js_1 = require("./runtime/shared.cjs");
+const property_information_1 = require("property-information");
 const ensureDomAvailable = () => {
     if (typeof document === 'undefined' || typeof document.createElement !== 'function') {
         throw new Error('The jsx template tag requires a DOM-like environment (document missing).');
@@ -26,8 +27,131 @@ const isPromiseLike = (value) => {
     }
     return typeof value.then === 'function';
 };
-const setDomProp = (element, name, value) => {
-    if (value === false || value === null || value === undefined) {
+const ATTRIBUTE_NAMESPACE_URIS = {
+    xlink: 'http://www.w3.org/1999/xlink',
+    xml: 'http://www.w3.org/XML/1998/namespace',
+    xmlns: 'http://www.w3.org/2000/xmlns/',
+};
+const getAttributeNamespace = (space) => {
+    if (!space || space === 'html' || space === 'svg') {
+        return undefined;
+    }
+    return ATTRIBUTE_NAMESPACE_URIS[space];
+};
+const getSchemaForNamespace = (namespace) => namespace === 'svg' ? property_information_1.svg : property_information_1.html;
+const setAttributeValue = (element, info, value) => {
+    const namespaceUri = getAttributeNamespace(info.space);
+    const attrValue = String(value);
+    if (namespaceUri) {
+        element.setAttributeNS(namespaceUri, info.attribute, attrValue);
+        return;
+    }
+    element.setAttribute(info.attribute, attrValue);
+};
+const removeAttributeValue = (element, info) => {
+    const namespaceUri = getAttributeNamespace(info.space);
+    if (namespaceUri) {
+        element.removeAttributeNS(namespaceUri, info.attribute);
+        return;
+    }
+    element.removeAttribute(info.attribute);
+};
+const joinTokenList = (value, delimiter) => {
+    if (!Array.isArray(value)) {
+        return value;
+    }
+    return value.filter(Boolean).join(delimiter);
+};
+const shouldAssignProperty = (element, namespace, info) => {
+    if (namespace === 'svg') {
+        return false;
+    }
+    if (!info.property || info.property.includes(':')) {
+        return false;
+    }
+    return info.property in element;
+};
+const captureSuffix = 'Capture';
+const stripCaptureSuffix = (rawName) => {
+    if (rawName.endsWith(captureSuffix) && rawName.length > captureSuffix.length) {
+        return { eventName: rawName.slice(0, -captureSuffix.length), capture: true };
+    }
+    return { eventName: rawName, capture: false };
+};
+const parseEventPropName = (name) => {
+    if (!name.startsWith('on')) {
+        return null;
+    }
+    if (name.startsWith('on:')) {
+        const raw = name.slice(3);
+        if (!raw) {
+            return null;
+        }
+        const parsed = stripCaptureSuffix(raw);
+        if (!parsed.eventName) {
+            return null;
+        }
+        return parsed;
+    }
+    const raw = name.slice(2);
+    if (!raw) {
+        return null;
+    }
+    const parsed = stripCaptureSuffix(raw);
+    if (!parsed.eventName) {
+        return null;
+    }
+    return {
+        eventName: parsed.eventName.toLowerCase(),
+        capture: parsed.capture,
+    };
+};
+const isEventListenerObject = (value) => {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    return ('handleEvent' in value &&
+        typeof value.handleEvent === 'function');
+};
+const isEventHandlerDescriptor = (value) => {
+    if (!value || typeof value !== 'object' || !('handler' in value)) {
+        return false;
+    }
+    const handler = value.handler;
+    if (typeof handler === 'function') {
+        return true;
+    }
+    return isEventListenerObject(handler);
+};
+const resolveEventHandlerValue = (value) => {
+    if (typeof value === 'function' || isEventListenerObject(value)) {
+        return { listener: value };
+    }
+    if (!isEventHandlerDescriptor(value)) {
+        return null;
+    }
+    const descriptor = value;
+    let options = descriptor.options ? { ...descriptor.options } : undefined;
+    const assignOption = (key, optionValue) => {
+        if (optionValue === undefined || optionValue === null) {
+            return;
+        }
+        if (!options) {
+            options = {};
+        }
+        options[key] = optionValue;
+    };
+    assignOption('capture', descriptor.capture);
+    assignOption('once', descriptor.once);
+    assignOption('passive', descriptor.passive);
+    assignOption('signal', descriptor.signal ?? undefined);
+    return {
+        listener: descriptor.handler,
+        options,
+    };
+};
+const setDomProp = (element, name, value, namespace) => {
+    if (value === null || value === undefined) {
         return;
     }
     if (name === 'dangerouslySetInnerHTML' &&
@@ -67,27 +191,75 @@ const setDomProp = (element, name, value) => {
         });
         return;
     }
-    if (typeof value === 'function' && name.startsWith('on')) {
-        const eventName = name.slice(2).toLowerCase();
-        element.addEventListener(eventName, value);
+    const eventBinding = parseEventPropName(name);
+    if (eventBinding) {
+        const handlerValue = resolveEventHandlerValue(value);
+        if (handlerValue) {
+            let options = handlerValue.options ? { ...handlerValue.options } : undefined;
+            if (eventBinding.capture) {
+                if (!options) {
+                    options = { capture: true };
+                }
+                else {
+                    options.capture = true;
+                }
+            }
+            element.addEventListener(eventBinding.eventName, handlerValue.listener, options);
+            return;
+        }
+    }
+    const info = (0, property_information_1.find)(getSchemaForNamespace(namespace), name);
+    const elementWithIndex = element;
+    const canAssignProperty = shouldAssignProperty(element, namespace, info);
+    if (info.mustUseProperty) {
+        const nextValue = info.boolean ? Boolean(value) : value;
+        elementWithIndex[info.property] = nextValue;
         return;
     }
-    if (name === 'class' || name === 'className') {
-        const classValue = Array.isArray(value)
-            ? value.filter(Boolean).join(' ')
-            : String(value);
-        element.setAttribute('class', classValue);
+    if (info.boolean) {
+        const boolValue = Boolean(value);
+        if (canAssignProperty) {
+            elementWithIndex[info.property] = boolValue;
+        }
+        if (boolValue) {
+            setAttributeValue(element, info, '');
+        }
+        else {
+            removeAttributeValue(element, info);
+        }
         return;
     }
-    if (name === 'htmlFor') {
-        element.setAttribute('for', String(value));
+    let normalizedValue = value;
+    if (info.spaceSeparated) {
+        normalizedValue = joinTokenList(value, ' ');
+    }
+    else if (info.commaSeparated) {
+        normalizedValue = joinTokenList(value, ',');
+    }
+    else if (info.commaOrSpaceSeparated) {
+        normalizedValue = joinTokenList(value, ' ');
+    }
+    if (info.booleanish && typeof normalizedValue === 'boolean') {
+        normalizedValue = normalizedValue ? 'true' : 'false';
+    }
+    if (info.overloadedBoolean) {
+        if (normalizedValue === false) {
+            removeAttributeValue(element, info);
+            return;
+        }
+        if (normalizedValue === true) {
+            setAttributeValue(element, info, '');
+            return;
+        }
+    }
+    if (canAssignProperty) {
+        elementWithIndex[info.property] = normalizedValue;
         return;
     }
-    if (name in element && !name.includes('-')) {
-        element[name] = value;
+    if (normalizedValue === false) {
         return;
     }
-    element.setAttribute(name, value === true ? '' : String(value));
+    setAttributeValue(element, info, normalizedValue);
 };
 const appendChildValue = (parent, value) => {
     if (value === null || value === undefined) {
@@ -154,7 +326,7 @@ const applyDomAttributes = (element, attributes, ctx, namespace) => {
             appendChildValue(element, value);
             return;
         }
-        setDomProp(element, name, value);
+        setDomProp(element, name, value, namespace);
     });
 };
 const evaluateJsxChildren = (children, ctx, namespace) => {

package/dist/cli/init.d.ts

@@ -1,4 +1,5 @@
 import { execFileSync, spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
 declare const SUPPORTED_PACKAGE_MANAGERS: readonly ["npm", "pnpm", "yarn", "bun"];
 type PackageManager = (typeof SUPPORTED_PACKAGE_MANAGERS)[number];
 type CliOptions = {
@@ -9,6 +10,8 @@ type CliOptions = {
     skipConfig: boolean;
     packageManager?: PackageManager;
     wasmPackage: string;
+    wasmVersion?: string;
+    wasmPackageSource: 'default' | 'env' | 'flag';
 };
 declare function parseArgs(argv: string[]): CliOptions;
 declare function log(message: string): void;
@@ -22,6 +25,14 @@ declare function parsePackageName(spec: string): {
     name: string;
     version: string;
 };
+type NodeRequireFn = ReturnType<typeof createRequire>;
+declare function readLocalOxcParserVersion(resolver?: NodeRequireFn): string | undefined;
+declare function fetchLatestBindingVersion(pkgName: string, execFn?: typeof execFileSync): string;
+declare function resolveBindingSpec(spec: string, explicitVersion?: string, fetchLatest?: typeof fetchLatestBindingVersion): {
+    spec: string;
+    name: string;
+    version: string | undefined;
+};
 type PackFunction = (spec: string, cwd: string, dryRun: boolean, verbose: boolean) => string;
 declare function installBinding(spec: string, cwd: string, dryRun: boolean, verbose: boolean, pack?: PackFunction): Promise<{
     targetDir: string;
@@ -45,7 +56,9 @@ type MainDeps = {
     persistBindingSpec: typeof persistBindingSpec;
     verifyBinding: typeof verifyBinding;
     maybeHandleConfigPrompt: typeof maybeHandleConfigPrompt;
+    resolveBindingSpec: typeof resolveBindingSpec;
+    readLocalOxcParserVersion: typeof readLocalOxcParserVersion;
     log: typeof log;
 };
 declare function main(overrides?: Partial<MainDeps>): Promise<void>;
-export { parseArgs, detectPackageManager, ensurePackageJson, runNpmPack, parsePackageName, installBinding, installRuntimeDeps, isDependencyInstalled, persistBindingSpec, verifyBinding, promptYesNo, maybeHandleConfigPrompt, main, };
+export { parseArgs, detectPackageManager, ensurePackageJson, runNpmPack, parsePackageName, resolveBindingSpec, fetchLatestBindingVersion, readLocalOxcParserVersion, installBinding, installRuntimeDeps, isDependencyInstalled, persistBindingSpec, verifyBinding, promptYesNo, maybeHandleConfigPrompt, main, };

package/dist/cli/init.js

@@ -7,7 +7,12 @@ import { createRequire } from 'module';
 import { pathToFileURL } from 'url';
 import { extract } from 'tar';
 
-var DEFAULT_BINDING_SPEC = process.env.WASM_BINDING_PACKAGE ?? "@oxc-parser/binding-wasm32-wasi@^0.99.0";
+var CLI_REQUIRE = createRequire(
+  typeof __filename !== "undefined" ? __filename : path.join(process.cwd(), "noop.js")
+);
+var DEFAULT_BINDING_PACKAGE_NAME = "@oxc-parser/binding-wasm32-wasi";
+var DEFAULT_BINDING_PACKAGE = process.env.WASM_BINDING_PACKAGE ?? DEFAULT_BINDING_PACKAGE_NAME;
+var DEFAULT_BINDING_SOURCE = process.env.WASM_BINDING_PACKAGE ? "env" : "default";
 var RUNTIME_DEPS = ["@napi-rs/wasm-runtime", "@emnapi/runtime", "@emnapi/core"];
 var SUPPORTED_PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var WASI_WARNING_SNIPPET = "WASI is an experimental feature";
@@ -31,7 +36,9 @@ function parseArgs(argv) {
     verbose: false,
     force: false,
     skipConfig: true,
-    wasmPackage: DEFAULT_BINDING_SPEC
+    wasmPackage: DEFAULT_BINDING_PACKAGE,
+    wasmVersion: void 0,
+    wasmPackageSource: DEFAULT_BINDING_SOURCE
   };
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
@@ -57,6 +64,12 @@ function parseArgs(argv) {
       const pkg = argv[i + 1];
       if (!pkg) throw new Error("Missing value for --wasm-package");
       options.wasmPackage = pkg;
+      options.wasmPackageSource = "flag";
+      i += 1;
+    } else if (arg === "--wasm-version") {
+      const version = argv[i + 1];
+      if (!version) throw new Error("Missing value for --wasm-version");
+      options.wasmVersion = version;
       i += 1;
     } else if (arg === "--help" || arg === "-h") {
       printHelp();
@@ -73,6 +86,7 @@ Usage: npx @knighted/jsx init [options]
 Options:
   --package-manager, --pm <name>  Choose npm | pnpm | yarn | bun
   --wasm-package <spec>           Override binding package spec
+  --wasm-version <version>        Pin version for the default binding
   --config                        Prompt to help with loader config
   --skip-config                   Skip any loader config prompts (default)
   --dry-run                       Print actions without executing
@@ -128,6 +142,66 @@ function parsePackageName(spec) {
   const [, name, version] = match;
   return { name, version };
 }
+function readLocalOxcParserVersion(resolver = CLI_REQUIRE) {
+  try {
+    const pkg = resolver("oxc-parser/package.json");
+    if (pkg && typeof pkg.version === "string") {
+      return pkg.version;
+    }
+  } catch {
+  }
+  return void 0;
+}
+function isRegistryResolvablePackage(name) {
+  if (!name) return false;
+  if (name.startsWith(".") || name.startsWith("/")) return false;
+  if (path.isAbsolute(name)) return false;
+  const blockedPrefixes = [
+    "file:",
+    "link:",
+    "git+",
+    "github:",
+    "workspace:",
+    "http://",
+    "https://"
+  ];
+  return !blockedPrefixes.some((prefix) => name.startsWith(prefix));
+}
+function fetchLatestBindingVersion(pkgName, execFn = execFileSync) {
+  const output = execFn("npm", ["view", pkgName, "version", "--json"], {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "inherit"]
+  }).trim();
+  if (!output) {
+    throw new Error(`Unable to determine latest version for ${pkgName}`);
+  }
+  const parsed = JSON.parse(output);
+  if (typeof parsed === "string") return parsed;
+  if (Array.isArray(parsed) && parsed.length > 0) {
+    const last = parsed[parsed.length - 1];
+    if (typeof last === "string") return last;
+  }
+  throw new Error(`Unable to determine latest version for ${pkgName}`);
+}
+function resolveBindingSpec(spec, explicitVersion, fetchLatest = fetchLatestBindingVersion) {
+  let combinedSpec = spec;
+  if (explicitVersion) {
+    const { name: name2 } = parsePackageName(spec);
+    if (!name2) {
+      throw new Error(`Unable to parse binding package spec: ${spec}`);
+    }
+    combinedSpec = `${name2}@${explicitVersion}`;
+  }
+  const { name, version } = parsePackageName(combinedSpec);
+  if (!name) {
+    throw new Error(`Unable to parse binding package spec: ${spec}`);
+  }
+  if (version || !isRegistryResolvablePackage(name)) {
+    return { spec: combinedSpec, name, version };
+  }
+  const latest = fetchLatest(name);
+  return { spec: `${name}@${latest}`, name, version: latest };
+}
 async function installBinding(spec, cwd, dryRun, verbose, pack = runNpmPack) {
   const { name, version } = parsePackageName(spec);
   const tarballName = pack(spec, cwd, dryRun, verbose);
@@ -240,10 +314,18 @@ async function main(overrides = {}) {
     persistBindingSpec: persistBindingSpecImpl = persistBindingSpec,
     verifyBinding: verifyBindingImpl = verifyBinding,
     maybeHandleConfigPrompt: maybeHandleConfigPromptImpl = maybeHandleConfigPrompt,
+    resolveBindingSpec: resolveBindingSpecImpl = resolveBindingSpec,
+    readLocalOxcParserVersion: readLocalOxcParserVersionImpl = readLocalOxcParserVersion,
     log: logImpl = log
   } = overrides;
   const options = parseArgsImpl(process.argv.slice(2));
   ensurePackageJsonImpl(options.cwd);
+  const bundledParserVersion = readLocalOxcParserVersionImpl();
+  const desiredBindingVersion = options.wasmVersion ?? (options.wasmPackageSource === "default" ? bundledParserVersion : void 0);
+  const resolvedBinding = resolveBindingSpecImpl(
+    options.wasmPackage,
+    desiredBindingVersion
+  );
   const packageManager = detectPackageManagerImpl(options.cwd, options.packageManager);
   logImpl(`> Using package manager: ${packageManager}`);
   const installedRuntimeDeps = installRuntimeDepsImpl(
@@ -254,7 +336,7 @@ async function main(overrides = {}) {
     options.verbose
   );
   const binding = await installBindingImpl(
-    options.wasmPackage,
+    resolvedBinding.spec,
     options.cwd,
     options.dryRun,
     options.verbose
@@ -303,4 +385,4 @@ function suppressExperimentalWasiWarning() {
   });
 }
 
-export { detectPackageManager, ensurePackageJson, installBinding, installRuntimeDeps, isDependencyInstalled, main, maybeHandleConfigPrompt, parseArgs, parsePackageName, persistBindingSpec, promptYesNo, runNpmPack, verifyBinding };
+export { detectPackageManager, ensurePackageJson, fetchLatestBindingVersion, installBinding, installRuntimeDeps, isDependencyInstalled, main, maybeHandleConfigPrompt, parseArgs, parsePackageName, persistBindingSpec, promptYesNo, readLocalOxcParserVersion, resolveBindingSpec, runNpmPack, verifyBinding };

package/dist/jsx-runtime.d.ts

@@ -9,8 +9,25 @@ type DataAttributes = {
 type AriaAttributes = {
     [K in `aria-${string}`]?: string | number | boolean | null | undefined;
 };
+type JsxEventListener<EV extends Event> = ((event: EV) => void) | {
+    handleEvent(event: EV): void;
+};
+type JsxEventDescriptor<EV extends Event> = {
+    handler: JsxEventListener<EV>;
+    capture?: boolean;
+    once?: boolean;
+    passive?: boolean;
+    signal?: AbortSignal;
+};
+type JsxEventProp<EV extends Event> = JsxEventListener<EV> | JsxEventDescriptor<EV>;
 type EventHandlers<T extends EventTarget> = {
-    [K in keyof GlobalEventHandlersEventMap as `on${Capitalize<string & K>}`]?: (event: GlobalEventHandlersEventMap[K]) => void;
+    [K in keyof GlobalEventHandlersEventMap as `on${Capitalize<string & K>}`]?: JsxEventProp<GlobalEventHandlersEventMap[K]>;
+} & {
+    [K in keyof GlobalEventHandlersEventMap as `on${Capitalize<string & K>}Capture`]?: JsxEventProp<GlobalEventHandlersEventMap[K]>;
+} & {
+    [K in string as K extends '' ? never : `on:${K}`]?: JsxEventProp<CustomEvent<unknown>>;
+} & {
+    [K in string as K extends '' ? never : `on:${K}Capture`]?: JsxEventProp<CustomEvent<unknown>>;
 };
 type ElementProps<Tag extends keyof HTMLElementTagNameMap> = Omit<Partial<HTMLElementTagNameMap[Tag]>, 'children'> & EventHandlers<HTMLElementTagNameMap[Tag]> & DataAttributes & AriaAttributes & {
     class?: string;

package/dist/jsx.js

@@ -1,5 +1,6 @@
 import { parseSync } from 'oxc-parser';
 import { buildTemplate, evaluateExpression, extractRootNode, formatParserError, getIdentifierName, normalizeJsxTextSegments, parserOptions, } from './runtime/shared.js';
+import { find as findPropertyInfo, html as htmlProperties, svg as svgProperties, } from 'property-information';
 const ensureDomAvailable = () => {
     if (typeof document === 'undefined' || typeof document.createElement !== 'function') {
         throw new Error('The jsx template tag requires a DOM-like environment (document missing).');
@@ -23,8 +24,131 @@ const isPromiseLike = (value) => {
     }
     return typeof value.then === 'function';
 };
-const setDomProp = (element, name, value) => {
-    if (value === false || value === null || value === undefined) {
+const ATTRIBUTE_NAMESPACE_URIS = {
+    xlink: 'http://www.w3.org/1999/xlink',
+    xml: 'http://www.w3.org/XML/1998/namespace',
+    xmlns: 'http://www.w3.org/2000/xmlns/',
+};
+const getAttributeNamespace = (space) => {
+    if (!space || space === 'html' || space === 'svg') {
+        return undefined;
+    }
+    return ATTRIBUTE_NAMESPACE_URIS[space];
+};
+const getSchemaForNamespace = (namespace) => namespace === 'svg' ? svgProperties : htmlProperties;
+const setAttributeValue = (element, info, value) => {
+    const namespaceUri = getAttributeNamespace(info.space);
+    const attrValue = String(value);
+    if (namespaceUri) {
+        element.setAttributeNS(namespaceUri, info.attribute, attrValue);
+        return;
+    }
+    element.setAttribute(info.attribute, attrValue);
+};
+const removeAttributeValue = (element, info) => {
+    const namespaceUri = getAttributeNamespace(info.space);
+    if (namespaceUri) {
+        element.removeAttributeNS(namespaceUri, info.attribute);
+        return;
+    }
+    element.removeAttribute(info.attribute);
+};
+const joinTokenList = (value, delimiter) => {
+    if (!Array.isArray(value)) {
+        return value;
+    }
+    return value.filter(Boolean).join(delimiter);
+};
+const shouldAssignProperty = (element, namespace, info) => {
+    if (namespace === 'svg') {
+        return false;
+    }
+    if (!info.property || info.property.includes(':')) {
+        return false;
+    }
+    return info.property in element;
+};
+const captureSuffix = 'Capture';
+const stripCaptureSuffix = (rawName) => {
+    if (rawName.endsWith(captureSuffix) && rawName.length > captureSuffix.length) {
+        return { eventName: rawName.slice(0, -captureSuffix.length), capture: true };
+    }
+    return { eventName: rawName, capture: false };
+};
+const parseEventPropName = (name) => {
+    if (!name.startsWith('on')) {
+        return null;
+    }
+    if (name.startsWith('on:')) {
+        const raw = name.slice(3);
+        if (!raw) {
+            return null;
+        }
+        const parsed = stripCaptureSuffix(raw);
+        if (!parsed.eventName) {
+            return null;
+        }
+        return parsed;
+    }
+    const raw = name.slice(2);
+    if (!raw) {
+        return null;
+    }
+    const parsed = stripCaptureSuffix(raw);
+    if (!parsed.eventName) {
+        return null;
+    }
+    return {
+        eventName: parsed.eventName.toLowerCase(),
+        capture: parsed.capture,
+    };
+};
+const isEventListenerObject = (value) => {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    return ('handleEvent' in value &&
+        typeof value.handleEvent === 'function');
+};
+const isEventHandlerDescriptor = (value) => {
+    if (!value || typeof value !== 'object' || !('handler' in value)) {
+        return false;
+    }
+    const handler = value.handler;
+    if (typeof handler === 'function') {
+        return true;
+    }
+    return isEventListenerObject(handler);
+};
+const resolveEventHandlerValue = (value) => {
+    if (typeof value === 'function' || isEventListenerObject(value)) {
+        return { listener: value };
+    }
+    if (!isEventHandlerDescriptor(value)) {
+        return null;
+    }
+    const descriptor = value;
+    let options = descriptor.options ? { ...descriptor.options } : undefined;
+    const assignOption = (key, optionValue) => {
+        if (optionValue === undefined || optionValue === null) {
+            return;
+        }
+        if (!options) {
+            options = {};
+        }
+        options[key] = optionValue;
+    };
+    assignOption('capture', descriptor.capture);
+    assignOption('once', descriptor.once);
+    assignOption('passive', descriptor.passive);
+    assignOption('signal', descriptor.signal ?? undefined);
+    return {
+        listener: descriptor.handler,
+        options,
+    };
+};
+const setDomProp = (element, name, value, namespace) => {
+    if (value === null || value === undefined) {
         return;
     }
     if (name === 'dangerouslySetInnerHTML' &&
@@ -64,27 +188,75 @@ const setDomProp = (element, name, value) => {
         });
         return;
     }
-    if (typeof value === 'function' && name.startsWith('on')) {
-        const eventName = name.slice(2).toLowerCase();
-        element.addEventListener(eventName, value);
+    const eventBinding = parseEventPropName(name);
+    if (eventBinding) {
+        const handlerValue = resolveEventHandlerValue(value);
+        if (handlerValue) {
+            let options = handlerValue.options ? { ...handlerValue.options } : undefined;
+            if (eventBinding.capture) {
+                if (!options) {
+                    options = { capture: true };
+                }
+                else {
+                    options.capture = true;
+                }
+            }
+            element.addEventListener(eventBinding.eventName, handlerValue.listener, options);
+            return;
+        }
+    }
+    const info = findPropertyInfo(getSchemaForNamespace(namespace), name);
+    const elementWithIndex = element;
+    const canAssignProperty = shouldAssignProperty(element, namespace, info);
+    if (info.mustUseProperty) {
+        const nextValue = info.boolean ? Boolean(value) : value;
+        elementWithIndex[info.property] = nextValue;
         return;
     }
-    if (name === 'class' || name === 'className') {
-        const classValue = Array.isArray(value)
-            ? value.filter(Boolean).join(' ')
-            : String(value);
-        element.setAttribute('class', classValue);
+    if (info.boolean) {
+        const boolValue = Boolean(value);
+        if (canAssignProperty) {
+            elementWithIndex[info.property] = boolValue;
+        }
+        if (boolValue) {
+            setAttributeValue(element, info, '');
+        }
+        else {
+            removeAttributeValue(element, info);
+        }
         return;
     }
-    if (name === 'htmlFor') {
-        element.setAttribute('for', String(value));
+    let normalizedValue = value;
+    if (info.spaceSeparated) {
+        normalizedValue = joinTokenList(value, ' ');
+    }
+    else if (info.commaSeparated) {
+        normalizedValue = joinTokenList(value, ',');
+    }
+    else if (info.commaOrSpaceSeparated) {
+        normalizedValue = joinTokenList(value, ' ');
+    }
+    if (info.booleanish && typeof normalizedValue === 'boolean') {
+        normalizedValue = normalizedValue ? 'true' : 'false';
+    }
+    if (info.overloadedBoolean) {
+        if (normalizedValue === false) {
+            removeAttributeValue(element, info);
+            return;
+        }
+        if (normalizedValue === true) {
+            setAttributeValue(element, info, '');
+            return;
+        }
+    }
+    if (canAssignProperty) {
+        elementWithIndex[info.property] = normalizedValue;
         return;
     }
-    if (name in element && !name.includes('-')) {
-        element[name] = value;
+    if (normalizedValue === false) {
         return;
     }
-    element.setAttribute(name, value === true ? '' : String(value));
+    setAttributeValue(element, info, normalizedValue);
 };
 const appendChildValue = (parent, value) => {
     if (value === null || value === undefined) {
@@ -151,7 +323,7 @@ const applyDomAttributes = (element, attributes, ctx, namespace) => {
             appendChildValue(element, value);
             return;
         }
-        setDomProp(element, name, value);
+        setDomProp(element, name, value, namespace);
     });
 };
 const evaluateJsxChildren = (children, ctx, namespace) => {

package/dist/lite/index.js

@@ -1,4 +1,4 @@
-import {parseSync}from'oxc-parser';var $=/<\s*$/,_=/<\/\s*$/,C="__KX_EXPR__",S=new RegExp(`${C}\\d+_\\d+__`,"g"),F=0,b={lang:"jsx",sourceType:"module",range:true,preserveParens:true},w=e=>{let n=`[oxc-parser] ${e.message}`;if(e.labels?.length){let t=e.labels[0];t.message&&(n+=`
+import {parseSync}from'oxc-parser';import {find,svg,html}from'property-information';var F=/<\s*$/,B=/<\/\s*$/,T="__KX_EXPR__",C=new RegExp(`${T}\\d+_\\d+__`,"g"),M=0,N={lang:"jsx",sourceType:"module",range:true,preserveParens:true},A=e=>{let n=`[oxc-parser] ${e.message}`;if(e.labels?.length){let t=e.labels[0];t.message&&(n+=`
 ${t.message}`);}return e.codeframe&&(n+=`
-${e.codeframe}`),n},T=e=>{for(let n of e.body)if(n.type==="ExpressionStatement"){let t=n.expression;if(t.type==="JSXElement"||t.type==="JSXFragment")return t}throw new Error("The jsx template must contain a single JSX element or fragment.")},x=e=>{switch(e.type){case "JSXIdentifier":return e.name;case "JSXNamespacedName":return `${e.namespace.name}:${e.name.name}`;case "JSXMemberExpression":return `${x(e.object)}.${e.property.name}`;default:return ""}},h=(e,n)=>{if(!e||typeof e!="object")return;let t=e;typeof t.type=="string"&&(n(t),Object.values(t).forEach(r=>{if(r){if(Array.isArray(r)){r.forEach(o=>h(o,n));return}typeof r=="object"&&h(r,n);}}));},X=(e,n)=>{let t=e.replace(/\r/g,"").replace(/\n\s+/g," "),r=e.match(/^\s*/)?.[0]??"",o=e.match(/\s*$/)?.[0]??"",a=/\n/.test(r),s=/\n/.test(o),i=t;if(a&&(i=i.replace(/^\s+/,"")),s&&(i=i.replace(/\s+$/,"")),i.length===0||i.trim().length===0)return [];let p=[];S.lastIndex=0;let c=0,l;for(;l=S.exec(i);){let m=l.index,f=i.slice(c,m);f&&p.push(f);let u=l[0];n.has(u)?p.push(n.get(u)):p.push(u),c=m+u.length;}let d=i.slice(c);return d&&p.push(d),p},P=(e,n)=>{let t=new Set;return h(e,r=>{r.type==="Identifier"&&n.placeholders.has(r.name)&&t.add(r.name);}),Array.from(t)},N=(e,n,t)=>{if(e.type==="JSXElement"||e.type==="JSXFragment")return t(e);if(!("range"in e)||!e.range)throw new Error("Unable to evaluate expression: missing source range information.");let[r,o]=e.range,a=n.source.slice(r,o),s=P(e,n);try{let i=new Function(...s,`"use strict"; return (${a});`),p=s.map(c=>n.placeholders.get(c));return i(...p)}catch(i){throw new Error(`Failed to evaluate expression ${a}: ${i.message}`)}},I=e=>{let n=e.replace(/[^a-zA-Z0-9_$]/g,"");return n?/[A-Za-z_$]/.test(n[0])?n:`Component${n}`:"Component"},O=(e,n,t)=>{let r=t.get(e);if(r)return r;let o=e.displayName||e.name||`Component${n.length}`,a=I(o??""),s=a,i=1;for(;n.some(c=>c.name===s);)s=`${a}${i++}`;let p={name:s,value:e};return n.push(p),t.set(e,p),p},k=(e,n)=>{let t=e.raw??e,r=new Map,o=[],a=new Map,s=t[0]??"",i=F++,p=0;for(let c=0;c<n.length;c++){let l=t[c]??"",d=t[c+1]??"",m=n[c],f=$.test(l)||_.test(l);if(f&&typeof m=="function"){let j=O(m,o,a);s+=j.name+d;continue}if(f&&typeof m=="string"){s+=m+d;continue}let u=`${C}${i}_${p++}__`;r.set(u,m),s+=u+d;}return {source:s,placeholders:r,bindings:o}};var D=()=>{if(typeof document>"u"||typeof document.createElement!="function")throw new Error("The jsx template tag requires a DOM-like environment (document missing).")},L=e=>typeof Node>"u"?false:e instanceof Node||e instanceof DocumentFragment,B=e=>!e||typeof e=="string"?false:typeof e[Symbol.iterator]=="function",A=e=>!e||typeof e!="object"&&typeof e!="function"?false:typeof e.then=="function",W=(e,n,t)=>{if(!(t===false||t===null||t===void 0)){if(n==="dangerouslySetInnerHTML"&&typeof t=="object"&&t&&"__html"in t){e.innerHTML=String(t.__html??"");return}if(n==="ref"){if(typeof t=="function"){t(e);return}if(t&&typeof t=="object"){t.current=e;return}}if(n==="style"&&typeof t=="object"&&t!==null){let r=t,o=e.style;if(!o)return;let a=o;Object.entries(r).forEach(([s,i])=>{if(i!=null){if(s.startsWith("--")){o.setProperty(s,String(i));return}a[s]=i;}});return}if(typeof t=="function"&&n.startsWith("on")){let r=n.slice(2).toLowerCase();e.addEventListener(r,t);return}if(n==="class"||n==="className"){let r=Array.isArray(t)?t.filter(Boolean).join(" "):String(t);e.setAttribute("class",r);return}if(n==="htmlFor"){e.setAttribute("for",String(t));return}if(n in e&&!n.includes("-")){e[n]=t;return}e.setAttribute(n,t===true?"":String(t));}},g=(e,n)=>{if(n!=null&&typeof n!="boolean"){if(A(n))throw new Error("Async values are not supported inside jsx template results.");if(Array.isArray(n)){n.forEach(t=>g(e,t));return}if(B(n)){for(let t of n)g(e,t);return}if(L(n)){e.appendChild(n);return}e.appendChild(document.createTextNode(String(n)));}},y=(e,n,t)=>N(e,n,r=>J(r,n,t)),R=(e,n,t)=>{let r={};return e.forEach(o=>{if(o.type==="JSXSpreadAttribute"){let s=y(o.argument,n,t);s&&typeof s=="object"&&!Array.isArray(s)&&Object.assign(r,s);return}let a=x(o.name);if(!o.value){r[a]=true;return}if(o.value.type==="Literal"){r[a]=o.value.value;return}if(o.value.type==="JSXExpressionContainer"){if(o.value.expression.type==="JSXEmptyExpression")return;r[a]=y(o.value.expression,n,t);}}),r},z=(e,n,t,r)=>{let o=R(n,t,r);Object.entries(o).forEach(([a,s])=>{if(a!=="key"){if(a==="children"){g(e,s);return}W(e,a,s);}});},E=(e,n,t)=>{let r=[];return e.forEach(o=>{switch(o.type){case "JSXText":{X(o.value,n.placeholders).forEach(s=>{r.push(s);});break}case "JSXExpressionContainer":{if(o.expression.type==="JSXEmptyExpression")break;r.push(y(o.expression,n,t));break}case "JSXSpreadChild":{let a=y(o.expression,n,t);a!=null&&r.push(a);break}case "JSXElement":case "JSXFragment":{r.push(J(o,n,t));break}}}),r},V=(e,n,t,r)=>{let o=R(e.openingElement.attributes,n,r),a=E(e.children,n,r);a.length===1?o.children=a[0]:a.length>1&&(o.children=a);let s=t(o);if(A(s))throw new Error("Async jsx components are not supported.");return s},H=(e,n,t)=>{let r=e.openingElement,o=x(r.name),a=n.components.get(o);if(a)return V(e,n,a,t);if(/[A-Z]/.test(o[0]??""))throw new Error(`Unknown component "${o}". Did you interpolate it with the template literal?`);let s=o==="svg"?"svg":t,i=o==="foreignObject"?null:s,p=s==="svg"?document.createElementNS("http://www.w3.org/2000/svg",o):document.createElement(o);return z(p,r.attributes,n,s),E(e.children,n,i).forEach(l=>g(p,l)),p},J=(e,n,t)=>{if(e.type==="JSXFragment"){let r=document.createDocumentFragment();return E(e.children,n,t).forEach(a=>g(r,a)),r}return H(e,n,t)},Z=(e,...n)=>{D();let t=k(e,n),r=parseSync("inline.jsx",t.source,b);if(r.errors.length>0)throw new Error(w(r.errors[0]));let o=T(r.program),a={source:t.source,placeholders:t.placeholders,components:new Map(t.bindings.map(s=>[s.name,s.value]))};return J(o,a,null)};
-export{Z as jsx};
+${e.codeframe}`),n},k=e=>{for(let n of e.body)if(n.type==="ExpressionStatement"){let t=n.expression;if(t.type==="JSXElement"||t.type==="JSXFragment")return t}throw new Error("The jsx template must contain a single JSX element or fragment.")},y=e=>{switch(e.type){case "JSXIdentifier":return e.name;case "JSXNamespacedName":return `${e.namespace.name}:${e.name.name}`;case "JSXMemberExpression":return `${y(e.object)}.${e.property.name}`;default:return ""}},E=(e,n)=>{if(!e||typeof e!="object")return;let t=e;typeof t.type=="string"&&(n(t),Object.values(t).forEach(r=>{if(r){if(Array.isArray(r)){r.forEach(o=>E(o,n));return}typeof r=="object"&&E(r,n);}}));},X=(e,n)=>{let t=e.replace(/\r/g,"").replace(/\n\s+/g," "),r=e.match(/^\s*/)?.[0]??"",o=e.match(/\s*$/)?.[0]??"",s=/\n/.test(r),a=/\n/.test(o),c=t;if(s&&(c=c.replace(/^\s+/,"")),a&&(c=c.replace(/\s+$/,"")),c.length===0||c.trim().length===0)return [];let i=[];C.lastIndex=0;let p=0,l;for(;l=C.exec(c);){let u=l.index,m=c.slice(p,u);m&&i.push(m);let f=l[0];n.has(f)?i.push(n.get(f)):i.push(f),p=u+f.length;}let d=c.slice(p);return d&&i.push(d),i},D=(e,n)=>{let t=new Set;return E(e,r=>{r.type==="Identifier"&&n.placeholders.has(r.name)&&t.add(r.name);}),Array.from(t)},P=(e,n,t)=>{if(e.type==="JSXElement"||e.type==="JSXFragment")return t(e);if(!("range"in e)||!e.range)throw new Error("Unable to evaluate expression: missing source range information.");let[r,o]=e.range,s=n.source.slice(r,o),a=D(e,n);try{let c=new Function(...a,`"use strict"; return (${s});`),i=a.map(p=>n.placeholders.get(p));return c(...i)}catch(c){throw new Error(`Failed to evaluate expression ${s}: ${c.message}`)}},W=e=>{let n=e.replace(/[^a-zA-Z0-9_$]/g,"");return n?/[A-Za-z_$]/.test(n[0])?n:`Component${n}`:"Component"},H=(e,n,t)=>{let r=t.get(e);if(r)return r;let o=e.displayName||e.name||`Component${n.length}`,s=W(o??""),a=s,c=1;for(;n.some(p=>p.name===a);)a=`${s}${c++}`;let i={name:a,value:e};return n.push(i),t.set(e,i),i},R=(e,n)=>{let t=e.raw??e,r=new Map,o=[],s=new Map,a=t[0]??"",c=M++,i=0;for(let p=0;p<n.length;p++){let l=t[p]??"",d=t[p+1]??"",u=n[p],m=F.test(l)||B.test(l);if(m&&typeof u=="function"){let $=H(u,o,s);a+=$.name+d;continue}if(m&&typeof u=="string"){a+=u+d;continue}let f=`${T}${c}_${i++}__`;r.set(f,u),a+=f+d;}return {source:a,placeholders:r,bindings:o}};var Z=()=>{if(typeof document>"u"||typeof document.createElement!="function")throw new Error("The jsx template tag requires a DOM-like environment (document missing).")},G=e=>typeof Node>"u"?false:e instanceof Node||e instanceof DocumentFragment,q=e=>!e||typeof e=="string"?false:typeof e[Symbol.iterator]=="function",v=e=>!e||typeof e!="object"&&typeof e!="function"?false:typeof e.then=="function",Q={xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace",xmlns:"http://www.w3.org/2000/xmlns/"},I=e=>{if(!(!e||e==="html"||e==="svg"))return Q[e]},Y=e=>e==="svg"?svg:html,h=(e,n,t)=>{let r=I(n.space),o=String(t);if(r){e.setAttributeNS(r,n.attribute,o);return}e.setAttribute(n.attribute,o);},j=(e,n)=>{let t=I(n.space);if(t){e.removeAttributeNS(t,n.attribute);return}e.removeAttribute(n.attribute);},b=(e,n)=>Array.isArray(e)?e.filter(Boolean).join(n):e,ee=(e,n,t)=>n==="svg"||!t.property||t.property.includes(":")?false:t.property in e,S="Capture",O=e=>e.endsWith(S)&&e.length>S.length?{eventName:e.slice(0,-S.length),capture:true}:{eventName:e,capture:false},ne=e=>{if(!e.startsWith("on"))return null;if(e.startsWith("on:")){let r=e.slice(3);if(!r)return null;let o=O(r);return o.eventName?o:null}let n=e.slice(2);if(!n)return null;let t=O(n);return t.eventName?{eventName:t.eventName.toLowerCase(),capture:t.capture}:null},L=e=>!e||typeof e!="object"?false:"handleEvent"in e&&typeof e.handleEvent=="function",te=e=>{if(!e||typeof e!="object"||!("handler"in e))return  false;let n=e.handler;return typeof n=="function"?true:L(n)},re=e=>{if(typeof e=="function"||L(e))return {listener:e};if(!te(e))return null;let n=e,t=n.options?{...n.options}:void 0,r=(o,s)=>{s!=null&&(t||(t={}),t[o]=s);};return r("capture",n.capture),r("once",n.once),r("passive",n.passive),r("signal",n.signal??void 0),{listener:n.handler,options:t}},oe=(e,n,t,r)=>{if(t==null)return;if(n==="dangerouslySetInnerHTML"&&typeof t=="object"&&t&&"__html"in t){e.innerHTML=String(t.__html??"");return}if(n==="ref"){if(typeof t=="function"){t(e);return}if(t&&typeof t=="object"){t.current=e;return}}if(n==="style"&&typeof t=="object"&&t!==null){let p=t,l=e.style;if(!l)return;let d=l;Object.entries(p).forEach(([u,m])=>{if(m!=null){if(u.startsWith("--")){l.setProperty(u,String(m));return}d[u]=m;}});return}let o=ne(n);if(o){let p=re(t);if(p){let l=p.options?{...p.options}:void 0;o.capture&&(l?l.capture=true:l={capture:true}),e.addEventListener(o.eventName,p.listener,l);return}}let s=find(Y(r),n),a=e,c=ee(e,r,s);if(s.mustUseProperty){let p=s.boolean?!!t:t;a[s.property]=p;return}if(s.boolean){let p=!!t;c&&(a[s.property]=p),p?h(e,s,""):j(e,s);return}let i=t;if(s.spaceSeparated?i=b(t," "):s.commaSeparated?i=b(t,","):s.commaOrSpaceSeparated&&(i=b(t," ")),s.booleanish&&typeof i=="boolean"&&(i=i?"true":"false"),s.overloadedBoolean){if(i===false){j(e,s);return}if(i===true){h(e,s,"");return}}if(c){a[s.property]=i;return}i!==false&&h(e,s,i);},g=(e,n)=>{if(n!=null&&typeof n!="boolean"){if(v(n))throw new Error("Async values are not supported inside jsx template results.");if(Array.isArray(n)){n.forEach(t=>g(e,t));return}if(q(n)){for(let t of n)g(e,t);return}if(G(n)){e.appendChild(n);return}e.appendChild(document.createTextNode(String(n)));}},x=(e,n,t)=>P(e,n,r=>w(r,n,t)),_=(e,n,t)=>{let r={};return e.forEach(o=>{if(o.type==="JSXSpreadAttribute"){let a=x(o.argument,n,t);a&&typeof a=="object"&&!Array.isArray(a)&&Object.assign(r,a);return}let s=y(o.name);if(!o.value){r[s]=true;return}if(o.value.type==="Literal"){r[s]=o.value.value;return}if(o.value.type==="JSXExpressionContainer"){if(o.value.expression.type==="JSXEmptyExpression")return;r[s]=x(o.value.expression,n,t);}}),r},se=(e,n,t,r)=>{let o=_(n,t,r);Object.entries(o).forEach(([s,a])=>{if(s!=="key"){if(s==="children"){g(e,a);return}oe(e,s,a,r);}});},J=(e,n,t)=>{let r=[];return e.forEach(o=>{switch(o.type){case "JSXText":{X(o.value,n.placeholders).forEach(a=>{r.push(a);});break}case "JSXExpressionContainer":{if(o.expression.type==="JSXEmptyExpression")break;r.push(x(o.expression,n,t));break}case "JSXSpreadChild":{let s=x(o.expression,n,t);s!=null&&r.push(s);break}case "JSXElement":case "JSXFragment":{r.push(w(o,n,t));break}}}),r},ae=(e,n,t,r)=>{let o=_(e.openingElement.attributes,n,r),s=J(e.children,n,r);s.length===1?o.children=s[0]:s.length>1&&(o.children=s);let a=t(o);if(v(a))throw new Error("Async jsx components are not supported.");return a},ie=(e,n,t)=>{let r=e.openingElement,o=y(r.name),s=n.components.get(o);if(s)return ae(e,n,s,t);if(/[A-Z]/.test(o[0]??""))throw new Error(`Unknown component "${o}". Did you interpolate it with the template literal?`);let a=o==="svg"?"svg":t,c=o==="foreignObject"?null:a,i=a==="svg"?document.createElementNS("http://www.w3.org/2000/svg",o):document.createElement(o);return se(i,r.attributes,n,a),J(e.children,n,c).forEach(l=>g(i,l)),i},w=(e,n,t)=>{if(e.type==="JSXFragment"){let r=document.createDocumentFragment();return J(e.children,n,t).forEach(s=>g(r,s)),r}return ie(e,n,t)},pe=(e,...n)=>{Z();let t=R(e,n),r=parseSync("inline.jsx",t.source,N);if(r.errors.length>0)throw new Error(A(r.errors[0]));let o=k(r.program),s={source:t.source,placeholders:t.placeholders,components:new Map(t.bindings.map(a=>[a.name,a.value]))};return w(o,s,null)};
+export{pe as jsx};

package/dist/lite/node/index.js

@@ -1,4 +1,4 @@
-import {parseSync}from'oxc-parser';var C="<!doctype html><html><body></body></html>",$=["window","self","document","HTMLElement","Element","Node","DocumentFragment","customElements","Text","Comment","MutationObserver","navigator"],L=()=>typeof document<"u"&&typeof document.createElement=="function",F=e=>{let n=globalThis,t=e;$.forEach(r=>{n[r]===void 0&&t[r]!==void 0&&(n[r]=t[r]);});},E=async()=>{let{parseHTML:e}=await import('linkedom'),{window:n}=e(C);return n},S=async()=>{let{JSDOM:e}=await import('jsdom'),{window:n}=new e(C);return n},W=()=>{let e=typeof process<"u"&&process.env?.KNIGHTED_JSX_NODE_SHIM?process.env.KNIGHTED_JSX_NODE_SHIM.toLowerCase():void 0;return e==="linkedom"||e==="jsdom"?e:"auto"},B=()=>{let e=W();return e==="linkedom"?[E,S]:e==="jsdom"?[S,E]:[E,S]},H=async()=>{let e=[];for(let t of B())try{return await t()}catch(r){e.push(r);}let n='Unable to bootstrap a DOM-like environment. Install "linkedom" or "jsdom" (both optional peer dependencies) or set KNIGHTED_JSX_NODE_SHIM to pick one explicitly.';throw new AggregateError(e,n)},x=null,T=async()=>{if(!L())return x||(x=(async()=>{let e=await H();F(e);})().catch(e=>{throw x=null,e})),x};var G=/<\s*$/,z=/<\/\s*$/,X="__KX_EXPR__",N=new RegExp(`${X}\\d+_\\d+__`,"g"),K=0,k={lang:"jsx",sourceType:"module",range:true,preserveParens:true},A=e=>{let n=`[oxc-parser] ${e.message}`;if(e.labels?.length){let t=e.labels[0];t.message&&(n+=`
+import {parseSync}from'oxc-parser';import {find,svg,html}from'property-information';var k="<!doctype html><html><body></body></html>",V=["window","self","document","HTMLElement","Element","Node","DocumentFragment","customElements","Text","Comment","MutationObserver","navigator"],K=()=>typeof document<"u"&&typeof document.createElement=="function",U=e=>{let n=globalThis,t=e;V.forEach(r=>{n[r]===void 0&&t[r]!==void 0&&(n[r]=t[r]);});},E=async()=>{let{parseHTML:e}=await import('linkedom'),{window:n}=e(k);return n},S=async()=>{let{JSDOM:e}=await import('jsdom'),{window:n}=new e(k);return n},z=()=>{let e=typeof process<"u"&&process.env?.KNIGHTED_JSX_NODE_SHIM?process.env.KNIGHTED_JSX_NODE_SHIM.toLowerCase():void 0;return e==="linkedom"||e==="jsdom"?e:"auto"},G=()=>{let e=z();return e==="linkedom"?[E,S]:e==="jsdom"?[S,E]:[E,S]},Z=async()=>{let e=[];for(let t of G())try{return await t()}catch(r){e.push(r);}let n='Unable to bootstrap a DOM-like environment. Install "linkedom" or "jsdom" (both optional peer dependencies) or set KNIGHTED_JSX_NODE_SHIM to pick one explicitly.';throw new AggregateError(e,n)},y=null,A=async()=>{if(!K())return y||(y=(async()=>{let e=await Z();U(e);})().catch(e=>{throw y=null,e})),y};var q=/<\s*$/,Y=/<\/\s*$/,P="__KX_EXPR__",X=new RegExp(`${P}\\d+_\\d+__`,"g"),Q=0,O={lang:"jsx",sourceType:"module",range:true,preserveParens:true},R=e=>{let n=`[oxc-parser] ${e.message}`;if(e.labels?.length){let t=e.labels[0];t.message&&(n+=`
 ${t.message}`);}return e.codeframe&&(n+=`
-${e.codeframe}`),n},R=e=>{for(let n of e.body)if(n.type==="ExpressionStatement"){let t=n.expression;if(t.type==="JSXElement"||t.type==="JSXFragment")return t}throw new Error("The jsx template must contain a single JSX element or fragment.")},y=e=>{switch(e.type){case "JSXIdentifier":return e.name;case "JSXNamespacedName":return `${e.namespace.name}:${e.name.name}`;case "JSXMemberExpression":return `${y(e.object)}.${e.property.name}`;default:return ""}},w=(e,n)=>{if(!e||typeof e!="object")return;let t=e;typeof t.type=="string"&&(n(t),Object.values(t).forEach(r=>{if(r){if(Array.isArray(r)){r.forEach(o=>w(o,n));return}typeof r=="object"&&w(r,n);}}));},_=(e,n)=>{let t=e.replace(/\r/g,"").replace(/\n\s+/g," "),r=e.match(/^\s*/)?.[0]??"",o=e.match(/\s*$/)?.[0]??"",a=/\n/.test(r),s=/\n/.test(o),i=t;if(a&&(i=i.replace(/^\s+/,"")),s&&(i=i.replace(/\s+$/,"")),i.length===0||i.trim().length===0)return [];let c=[];N.lastIndex=0;let p=0,m;for(;m=N.exec(i);){let l=m.index,f=i.slice(p,l);f&&c.push(f);let d=m[0];n.has(d)?c.push(n.get(d)):c.push(d),p=l+d.length;}let u=i.slice(p);return u&&c.push(u),c},V=(e,n)=>{let t=new Set;return w(e,r=>{r.type==="Identifier"&&n.placeholders.has(r.name)&&t.add(r.name);}),Array.from(t)},j=(e,n,t)=>{if(e.type==="JSXElement"||e.type==="JSXFragment")return t(e);if(!("range"in e)||!e.range)throw new Error("Unable to evaluate expression: missing source range information.");let[r,o]=e.range,a=n.source.slice(r,o),s=V(e,n);try{let i=new Function(...s,`"use strict"; return (${a});`),c=s.map(p=>n.placeholders.get(p));return i(...c)}catch(i){throw new Error(`Failed to evaluate expression ${a}: ${i.message}`)}},U=e=>{let n=e.replace(/[^a-zA-Z0-9_$]/g,"");return n?/[A-Za-z_$]/.test(n[0])?n:`Component${n}`:"Component"},Z=(e,n,t)=>{let r=t.get(e);if(r)return r;let o=e.displayName||e.name||`Component${n.length}`,a=U(o??""),s=a,i=1;for(;n.some(p=>p.name===s);)s=`${a}${i++}`;let c={name:s,value:e};return n.push(c),t.set(e,c),c},P=(e,n)=>{let t=e.raw??e,r=new Map,o=[],a=new Map,s=t[0]??"",i=K++,c=0;for(let p=0;p<n.length;p++){let m=t[p]??"",u=t[p+1]??"",l=n[p],f=G.test(m)||z.test(m);if(f&&typeof l=="function"){let D=Z(l,o,a);s+=D.name+u;continue}if(f&&typeof l=="string"){s+=l+u;continue}let d=`${X}${i}_${c++}__`;r.set(d,l),s+=d+u;}return {source:s,placeholders:r,bindings:o}};var Y=()=>{if(typeof document>"u"||typeof document.createElement!="function")throw new Error("The jsx template tag requires a DOM-like environment (document missing).")},Q=e=>typeof Node>"u"?false:e instanceof Node||e instanceof DocumentFragment,v=e=>!e||typeof e=="string"?false:typeof e[Symbol.iterator]=="function",O=e=>!e||typeof e!="object"&&typeof e!="function"?false:typeof e.then=="function",ee=(e,n,t)=>{if(!(t===false||t===null||t===void 0)){if(n==="dangerouslySetInnerHTML"&&typeof t=="object"&&t&&"__html"in t){e.innerHTML=String(t.__html??"");return}if(n==="ref"){if(typeof t=="function"){t(e);return}if(t&&typeof t=="object"){t.current=e;return}}if(n==="style"&&typeof t=="object"&&t!==null){let r=t,o=e.style;if(!o)return;let a=o;Object.entries(r).forEach(([s,i])=>{if(i!=null){if(s.startsWith("--")){o.setProperty(s,String(i));return}a[s]=i;}});return}if(typeof t=="function"&&n.startsWith("on")){let r=n.slice(2).toLowerCase();e.addEventListener(r,t);return}if(n==="class"||n==="className"){let r=Array.isArray(t)?t.filter(Boolean).join(" "):String(t);e.setAttribute("class",r);return}if(n==="htmlFor"){e.setAttribute("for",String(t));return}if(n in e&&!n.includes("-")){e[n]=t;return}e.setAttribute(n,t===true?"":String(t));}},g=(e,n)=>{if(n!=null&&typeof n!="boolean"){if(O(n))throw new Error("Async values are not supported inside jsx template results.");if(Array.isArray(n)){n.forEach(t=>g(e,t));return}if(v(n)){for(let t of n)g(e,t);return}if(Q(n)){e.appendChild(n);return}e.appendChild(document.createTextNode(String(n)));}},h=(e,n,t)=>j(e,n,r=>b(r,n,t)),I=(e,n,t)=>{let r={};return e.forEach(o=>{if(o.type==="JSXSpreadAttribute"){let s=h(o.argument,n,t);s&&typeof s=="object"&&!Array.isArray(s)&&Object.assign(r,s);return}let a=y(o.name);if(!o.value){r[a]=true;return}if(o.value.type==="Literal"){r[a]=o.value.value;return}if(o.value.type==="JSXExpressionContainer"){if(o.value.expression.type==="JSXEmptyExpression")return;r[a]=h(o.value.expression,n,t);}}),r},ne=(e,n,t,r)=>{let o=I(n,t,r);Object.entries(o).forEach(([a,s])=>{if(a!=="key"){if(a==="children"){g(e,s);return}ee(e,a,s);}});},J=(e,n,t)=>{let r=[];return e.forEach(o=>{switch(o.type){case "JSXText":{_(o.value,n.placeholders).forEach(s=>{r.push(s);});break}case "JSXExpressionContainer":{if(o.expression.type==="JSXEmptyExpression")break;r.push(h(o.expression,n,t));break}case "JSXSpreadChild":{let a=h(o.expression,n,t);a!=null&&r.push(a);break}case "JSXElement":case "JSXFragment":{r.push(b(o,n,t));break}}}),r},te=(e,n,t,r)=>{let o=I(e.openingElement.attributes,n,r),a=J(e.children,n,r);a.length===1?o.children=a[0]:a.length>1&&(o.children=a);let s=t(o);if(O(s))throw new Error("Async jsx components are not supported.");return s},re=(e,n,t)=>{let r=e.openingElement,o=y(r.name),a=n.components.get(o);if(a)return te(e,n,a,t);if(/[A-Z]/.test(o[0]??""))throw new Error(`Unknown component "${o}". Did you interpolate it with the template literal?`);let s=o==="svg"?"svg":t,i=o==="foreignObject"?null:s,c=s==="svg"?document.createElementNS("http://www.w3.org/2000/svg",o):document.createElement(o);return ne(c,r.attributes,n,s),J(e.children,n,i).forEach(m=>g(c,m)),c},b=(e,n,t)=>{if(e.type==="JSXFragment"){let r=document.createDocumentFragment();return J(e.children,n,t).forEach(a=>g(r,a)),r}return re(e,n,t)},M=(e,...n)=>{Y();let t=P(e,n),r=parseSync("inline.jsx",t.source,k);if(r.errors.length>0)throw new Error(A(r.errors[0]));let o=R(r.program),a={source:t.source,placeholders:t.placeholders,components:new Map(t.bindings.map(s=>[s.name,s.value]))};return b(o,a,null)};await T();var le=M;
-export{le as jsx};
+${e.codeframe}`),n},j=e=>{for(let n of e.body)if(n.type==="ExpressionStatement"){let t=n.expression;if(t.type==="JSXElement"||t.type==="JSXFragment")return t}throw new Error("The jsx template must contain a single JSX element or fragment.")},h=e=>{switch(e.type){case "JSXIdentifier":return e.name;case "JSXNamespacedName":return `${e.namespace.name}:${e.name.name}`;case "JSXMemberExpression":return `${h(e.object)}.${e.property.name}`;default:return ""}},w=(e,n)=>{if(!e||typeof e!="object")return;let t=e;typeof t.type=="string"&&(n(t),Object.values(t).forEach(r=>{if(r){if(Array.isArray(r)){r.forEach(o=>w(o,n));return}typeof r=="object"&&w(r,n);}}));},v=(e,n)=>{let t=e.replace(/\r/g,"").replace(/\n\s+/g," "),r=e.match(/^\s*/)?.[0]??"",o=e.match(/\s*$/)?.[0]??"",s=/\n/.test(r),i=/\n/.test(o),p=t;if(s&&(p=p.replace(/^\s+/,"")),i&&(p=p.replace(/\s+$/,"")),p.length===0||p.trim().length===0)return [];let a=[];X.lastIndex=0;let c=0,l;for(;l=X.exec(p);){let m=l.index,u=p.slice(c,m);u&&a.push(u);let f=l[0];n.has(f)?a.push(n.get(f)):a.push(f),c=m+f.length;}let d=p.slice(c);return d&&a.push(d),a},ee=(e,n)=>{let t=new Set;return w(e,r=>{r.type==="Identifier"&&n.placeholders.has(r.name)&&t.add(r.name);}),Array.from(t)},L=(e,n,t)=>{if(e.type==="JSXElement"||e.type==="JSXFragment")return t(e);if(!("range"in e)||!e.range)throw new Error("Unable to evaluate expression: missing source range information.");let[r,o]=e.range,s=n.source.slice(r,o),i=ee(e,n);try{let p=new Function(...i,`"use strict"; return (${s});`),a=i.map(c=>n.placeholders.get(c));return p(...a)}catch(p){throw new Error(`Failed to evaluate expression ${s}: ${p.message}`)}},ne=e=>{let n=e.replace(/[^a-zA-Z0-9_$]/g,"");return n?/[A-Za-z_$]/.test(n[0])?n:`Component${n}`:"Component"},te=(e,n,t)=>{let r=t.get(e);if(r)return r;let o=e.displayName||e.name||`Component${n.length}`,s=ne(o??""),i=s,p=1;for(;n.some(c=>c.name===i);)i=`${s}${p++}`;let a={name:i,value:e};return n.push(a),t.set(e,a),a},_=(e,n)=>{let t=e.raw??e,r=new Map,o=[],s=new Map,i=t[0]??"",p=Q++,a=0;for(let c=0;c<n.length;c++){let l=t[c]??"",d=t[c+1]??"",m=n[c],u=q.test(l)||Y.test(l);if(u&&typeof m=="function"){let W=te(m,o,s);i+=W.name+d;continue}if(u&&typeof m=="string"){i+=m+d;continue}let f=`${P}${p}_${a++}__`;r.set(f,m),i+=f+d;}return {source:i,placeholders:r,bindings:o}};var ae=()=>{if(typeof document>"u"||typeof document.createElement!="function")throw new Error("The jsx template tag requires a DOM-like environment (document missing).")},ce=e=>typeof Node>"u"?false:e instanceof Node||e instanceof DocumentFragment,pe=e=>!e||typeof e=="string"?false:typeof e[Symbol.iterator]=="function",M=e=>!e||typeof e!="object"&&typeof e!="function"?false:typeof e.then=="function",le={xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace",xmlns:"http://www.w3.org/2000/xmlns/"},$=e=>{if(!(!e||e==="html"||e==="svg"))return le[e]},me=e=>e==="svg"?svg:html,b=(e,n,t)=>{let r=$(n.space),o=String(t);if(r){e.setAttributeNS(r,n.attribute,o);return}e.setAttribute(n.attribute,o);},I=(e,n)=>{let t=$(n.space);if(t){e.removeAttributeNS(t,n.attribute);return}e.removeAttribute(n.attribute);},J=(e,n)=>Array.isArray(e)?e.filter(Boolean).join(n):e,ue=(e,n,t)=>n==="svg"||!t.property||t.property.includes(":")?false:t.property in e,C="Capture",D=e=>e.endsWith(C)&&e.length>C.length?{eventName:e.slice(0,-C.length),capture:true}:{eventName:e,capture:false},de=e=>{if(!e.startsWith("on"))return null;if(e.startsWith("on:")){let r=e.slice(3);if(!r)return null;let o=D(r);return o.eventName?o:null}let n=e.slice(2);if(!n)return null;let t=D(n);return t.eventName?{eventName:t.eventName.toLowerCase(),capture:t.capture}:null},F=e=>!e||typeof e!="object"?false:"handleEvent"in e&&typeof e.handleEvent=="function",fe=e=>{if(!e||typeof e!="object"||!("handler"in e))return  false;let n=e.handler;return typeof n=="function"?true:F(n)},ge=e=>{if(typeof e=="function"||F(e))return {listener:e};if(!fe(e))return null;let n=e,t=n.options?{...n.options}:void 0,r=(o,s)=>{s!=null&&(t||(t={}),t[o]=s);};return r("capture",n.capture),r("once",n.once),r("passive",n.passive),r("signal",n.signal??void 0),{listener:n.handler,options:t}},ye=(e,n,t,r)=>{if(t==null)return;if(n==="dangerouslySetInnerHTML"&&typeof t=="object"&&t&&"__html"in t){e.innerHTML=String(t.__html??"");return}if(n==="ref"){if(typeof t=="function"){t(e);return}if(t&&typeof t=="object"){t.current=e;return}}if(n==="style"&&typeof t=="object"&&t!==null){let c=t,l=e.style;if(!l)return;let d=l;Object.entries(c).forEach(([m,u])=>{if(u!=null){if(m.startsWith("--")){l.setProperty(m,String(u));return}d[m]=u;}});return}let o=de(n);if(o){let c=ge(t);if(c){let l=c.options?{...c.options}:void 0;o.capture&&(l?l.capture=true:l={capture:true}),e.addEventListener(o.eventName,c.listener,l);return}}let s=find(me(r),n),i=e,p=ue(e,r,s);if(s.mustUseProperty){let c=s.boolean?!!t:t;i[s.property]=c;return}if(s.boolean){let c=!!t;p&&(i[s.property]=c),c?b(e,s,""):I(e,s);return}let a=t;if(s.spaceSeparated?a=J(t," "):s.commaSeparated?a=J(t,","):s.commaOrSpaceSeparated&&(a=J(t," ")),s.booleanish&&typeof a=="boolean"&&(a=a?"true":"false"),s.overloadedBoolean){if(a===false){I(e,s);return}if(a===true){b(e,s,"");return}}if(p){i[s.property]=a;return}a!==false&&b(e,s,a);},g=(e,n)=>{if(n!=null&&typeof n!="boolean"){if(M(n))throw new Error("Async values are not supported inside jsx template results.");if(Array.isArray(n)){n.forEach(t=>g(e,t));return}if(pe(n)){for(let t of n)g(e,t);return}if(ce(n)){e.appendChild(n);return}e.appendChild(document.createTextNode(String(n)));}},x=(e,n,t)=>L(e,n,r=>N(r,n,t)),B=(e,n,t)=>{let r={};return e.forEach(o=>{if(o.type==="JSXSpreadAttribute"){let i=x(o.argument,n,t);i&&typeof i=="object"&&!Array.isArray(i)&&Object.assign(r,i);return}let s=h(o.name);if(!o.value){r[s]=true;return}if(o.value.type==="Literal"){r[s]=o.value.value;return}if(o.value.type==="JSXExpressionContainer"){if(o.value.expression.type==="JSXEmptyExpression")return;r[s]=x(o.value.expression,n,t);}}),r},he=(e,n,t,r)=>{let o=B(n,t,r);Object.entries(o).forEach(([s,i])=>{if(s!=="key"){if(s==="children"){g(e,i);return}ye(e,s,i,r);}});},T=(e,n,t)=>{let r=[];return e.forEach(o=>{switch(o.type){case "JSXText":{v(o.value,n.placeholders).forEach(i=>{r.push(i);});break}case "JSXExpressionContainer":{if(o.expression.type==="JSXEmptyExpression")break;r.push(x(o.expression,n,t));break}case "JSXSpreadChild":{let s=x(o.expression,n,t);s!=null&&r.push(s);break}case "JSXElement":case "JSXFragment":{r.push(N(o,n,t));break}}}),r},xe=(e,n,t,r)=>{let o=B(e.openingElement.attributes,n,r),s=T(e.children,n,r);s.length===1?o.children=s[0]:s.length>1&&(o.children=s);let i=t(o);if(M(i))throw new Error("Async jsx components are not supported.");return i},Ee=(e,n,t)=>{let r=e.openingElement,o=h(r.name),s=n.components.get(o);if(s)return xe(e,n,s,t);if(/[A-Z]/.test(o[0]??""))throw new Error(`Unknown component "${o}". Did you interpolate it with the template literal?`);let i=o==="svg"?"svg":t,p=o==="foreignObject"?null:i,a=i==="svg"?document.createElementNS("http://www.w3.org/2000/svg",o):document.createElement(o);return he(a,r.attributes,n,i),T(e.children,n,p).forEach(l=>g(a,l)),a},N=(e,n,t)=>{if(e.type==="JSXFragment"){let r=document.createDocumentFragment();return T(e.children,n,t).forEach(s=>g(r,s)),r}return Ee(e,n,t)},H=(e,...n)=>{ae();let t=_(e,n),r=parseSync("inline.jsx",t.source,O);if(r.errors.length>0)throw new Error(R(r.errors[0]));let o=j(r.program),s={source:t.source,placeholders:t.placeholders,components:new Map(t.bindings.map(i=>[i.name,i.value]))};return N(o,s,null)};await A();var Ae=H;
+export{Ae as jsx};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knighted/jsx",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "Runtime JSX tagged template that renders DOM or React trees anywhere without a build step.",
   "keywords": [
     "jsx runtime",
@@ -89,6 +89,7 @@
     "check-types:lib": "tsc --noEmit --project tsconfig.json",
     "check-types:demo": "tsc --noEmit --project examples/browser/tsconfig.json",
     "lint": "eslint src test",
+    "cycles": "madge src --circular --extensions ts,tsx,js,jsx --ts-config tsconfig.json",
     "prettier": "prettier -w .",
     "prettier:check": "prettier --check .",
     "test": "KNIGHTED_JSX_CLI_TEST=1 vitest run --coverage",
@@ -107,7 +108,7 @@
   "devDependencies": {
     "@eslint/js": "^9.39.1",
     "@knighted/duel": "^2.1.6",
-    "@oxc-project/types": "^0.99.0",
+    "@oxc-project/types": "^0.105.0",
     "@playwright/test": "^1.57.0",
     "@rspack/core": "^1.0.5",
     "@types/jsdom": "^27.0.0",
@@ -115,14 +116,17 @@
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "@vitest/coverage-v8": "^4.0.14",
+    "@vitest/eslint-plugin": "^1.6.4",
     "eslint": "^9.39.1",
     "eslint-plugin-n": "^17.10.3",
     "eslint-plugin-playwright": "^2.4.0",
+    "eslint-plugin-unicorn": "^62.0.0",
     "http-server": "^14.1.1",
     "husky": "^9.1.7",
     "jsdom": "^27.2.0",
     "lint-staged": "^16.2.7",
     "lit": "^3.2.1",
+    "madge": "^8.0.0",
     "next": "^16.0.0",
     "prettier": "^3.7.3",
     "react": "^19.0.0",
@@ -135,7 +139,8 @@
   },
   "dependencies": {
     "magic-string": "^0.30.21",
-    "oxc-parser": "^0.99.0",
+    "oxc-parser": "^0.105.0",
+    "property-information": "^7.1.0",
     "tar": "^7.4.3"
   },
   "peerDependencies": {
@@ -155,9 +160,14 @@
     }
   },
   "optionalDependencies": {
-    "@oxc-parser/binding-darwin-arm64": "^0.99.0",
-    "@oxc-parser/binding-linux-x64-gnu": "^0.99.0",
-    "@oxc-parser/binding-wasm32-wasi": "^0.99.0"
+    "@oxc-parser/binding-darwin-arm64": "^0.105.0",
+    "@oxc-parser/binding-linux-x64-gnu": "^0.105.0",
+    "@oxc-parser/binding-wasm32-wasi": "0.105.0"
+  },
+  "overrides": {
+    "module-lookup-amd": {
+      "glob": "^9.0.0"
+    }
   },
   "files": [
     "dist"
@@ -178,6 +188,7 @@
     "singleQuote": true
   },
   "lint-staged": {
+    "src/**/*.{ts,tsx,js,jsx}": "npm run cycles",
     "*.{js,jsx,ts,tsx,mjs,cjs,cts,mts}": "eslint --max-warnings=0",
     "*.{js,jsx,ts,tsx,mjs,cjs,cts,mts,json,md,css,scss,html}": "prettier --check"
   }