@sigx/lynx-plugin 0.4.0 → 0.4.1

package/dist/index.js

@@ -1,437 +1,398 @@
-import { networkInterfaces as e } from "node:os";
-import t, { join as n } from "node:path";
-import { fileURLToPath as r, pathToFileURL as i } from "node:url";
-import { createRequire as a } from "node:module";
-import { existsSync as o, promises as s } from "node:fs";
-//#region src/layers.ts
-var c = {
-	BACKGROUND: "sigx:background",
-	MAIN_THREAD: "sigx:main-thread"
-}, l = t.dirname(r(import.meta.url));
-function u(e, n) {
-	let { enableCSSSelector: r, enableCSSInvalidation: i } = n;
-	e.modifyRsbuildConfig((e, { mergeRsbuildConfig: t }) => t(e, { output: { injectStyles: !1 } })), e.modifyBundlerChain(async function(n, { CHAIN_ID: a }) {
-		let { CssExtractRspackPlugin: o, CssExtractWebpackPlugin: s } = await import("@lynx-js/css-extract-webpack-plugin"), u = e.context.bundlerType === "rspack" ? o : s;
-		[
-			a.RULE.CSS,
-			a.RULE.SASS,
-			a.RULE.LESS,
-			a.RULE.STYLUS
-		].filter((e) => n.module.rules.has(e)).forEach((e) => {
-			let r = n.module.rule(e);
-			p(r, a), r.issuerLayer(c.BACKGROUND).use(a.USE.MINI_CSS_EXTRACT).loader(u.loader).end();
-			let i = r.uses.entries(), o = r.entries(), s = i[a.USE.CSS]?.entries();
-			n.module.rule(`${e}:${c.MAIN_THREAD}`).merge(o).issuerLayer(c.MAIN_THREAD).use(a.USE.IGNORE_CSS).loader(t.resolve(l, "./loaders/ignore-css-loader")).end().uses.merge(i).delete(a.USE.MINI_CSS_EXTRACT).delete(a.USE.LIGHTNINGCSS).delete(a.USE.CSS).end(), s && n.module.rule(`${e}:${c.MAIN_THREAD}`).use(a.USE.CSS).after(a.USE.IGNORE_CSS).merge(s).options(d(s.options, !0)).end();
-		});
-		let f = a.RULE;
-		[
-			"CSS_INLINE",
-			"SASS_INLINE",
-			"LESS_INLINE",
-			"STYLUS_INLINE"
-		].map((e) => f[e]).filter((e) => !!e && n.module.rules.has(e)).forEach((e) => {
-			p(n.module.rule(e), a);
-		}), n.plugin(a.PLUGIN.MINI_CSS_EXTRACT).tap((e) => {
-			let [t] = e;
-			return [{
-				...t,
-				enableRemoveCSSScope: !0,
-				enableCSSSelector: r,
-				enableCSSInvalidation: i,
-				cssPlugins: []
-			}];
-		}).init((e, t) => new u(...t)).end().end();
-		function p(e, t) {
-			e.uses.has(t.USE.LIGHTNINGCSS) && e.uses.delete(t.USE.LIGHTNINGCSS);
-		}
-	});
+/**
+ * @packageDocumentation
+ *
+ * An rsbuild / rspeedy plugin that integrates SignalX with Lynx's dual-thread
+ * architecture (Background Thread renderer + Main Thread PAPI executor).
+ *
+ * @example
+ * ```ts
+ * // lynx.config.ts
+ * import { defineConfig } from '@lynx-js/rspeedy'
+ * import { pluginSigxLynx } from '@sigx/lynx-plugin'
+ *
+ * export default defineConfig({
+ *   plugins: [pluginSigxLynx()],
+ * })
+ * ```
+ */
+import { networkInterfaces } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { applyCSS } from './css.js';
+import { applyEntry } from './entry.js';
+import { applyIcons } from './icons.js';
+import { LAYERS } from './layers.js';
+import { createLogWebSocketServer, LOG_ENDPOINT_PATH } from './log-server.js';
+export { LAYERS, applyEntry };
+const _pluginDirname = path.dirname(fileURLToPath(import.meta.url));
+const _sigxLynxRoot = path.resolve(_pluginDirname, '../..');
+/** Wildcard addresses that bind to all interfaces but aren't routable from other devices. */
+const WILDCARD_HOSTS = new Set(['0.0.0.0', '::', '0:0:0:0:0:0:0:0']);
+/**
+ * Interface names that are virtual adapters (Hyper-V, WSL, Docker, VPN, etc.)
+ * and should be skipped when looking for the real LAN address.
+ */
+const VIRTUAL_IF_PATTERNS = /^(vEthernet|veth|docker|br-|virbr|vmnet|VirtualBox|Hyper-V|WSL|ham\d)/i;
+/**
+ * Detect the real LAN IPv4 address on this machine.
+ * Skips virtual/container adapters (Hyper-V, WSL, Docker) and prefers
+ * physical interfaces like Wi-Fi or Ethernet.
+ * Falls back to the first external IPv4 if no physical match is found,
+ * and ultimately to `'127.0.0.1'`.
+ */
+function detectLanIPv4() {
+    const ifaces = networkInterfaces();
+    let fallback;
+    for (const [name, nets] of Object.entries(ifaces)) {
+        for (const net of nets ?? []) {
+            if (net.family !== 'IPv4' || net.internal || !net.address)
+                continue;
+            // Remember first external address as fallback
+            if (!fallback)
+                fallback = net.address;
+            // Skip virtual adapters
+            if (VIRTUAL_IF_PATTERNS.test(name))
+                continue;
+            return net.address;
+        }
+    }
+    return fallback ?? '127.0.0.1';
 }
-var d = (e, t) => {
-	if (e.modules && t) {
-		let { modules: t } = e;
-		return t = t === !0 ? { exportOnlyLocals: !0 } : typeof t == "string" ? {
-			mode: t,
-			exportOnlyLocals: !0
-		} : {
-			...t,
-			exportOnlyLocals: !0
-		}, {
-			...e,
-			modules: t
-		};
-	}
-	return e;
-}, f = "lynx:sigx-template", p = "lynx:sigx-mark-main-thread", m = "lynx:sigx-encode", h = ".rspeedy", g = t.dirname(r(import.meta.url));
-t.resolve(g, "..");
-var _ = class {
-	mainThreadFilenames;
-	constructor(e) {
-		this.mainThreadFilenames = e;
-	}
-	apply(e) {
-		let { RuntimeGlobals: t } = e.webpack;
-		e.hooks.thisCompilation.tap(p, (n) => {
-			n.hooks.additionalTreeRuntimeRequirements.tap(p, (e, n) => {
-				e.getEntryOptions()?.layer === c.MAIN_THREAD && (n.add(t.startup), n.add(t.require));
-			}), n.hooks.processAssets.tap({
-				name: p,
-				stage: e.webpack.Compilation.PROCESS_ASSETS_STAGE_ADDITIONAL
-			}, () => {
-				for (let e of this.mainThreadFilenames) {
-					let t = n.getAsset(e);
-					t && n.updateAsset(e, t.source, {
-						...t.info,
-						"lynx:main-thread": !0
-					});
-				}
-			});
-		});
-	}
-};
-async function v(e, n = {}) {
-	let r;
-	try {
-		r = await import("@lynx-js/template-webpack-plugin");
-	} catch {}
-	let i;
-	try {
-		i = await import("@lynx-js/runtime-wrapper-webpack-plugin");
-	} catch {}
-	e.modifyRsbuildConfig((t, { mergeRsbuildConfig: n }) => e.getRsbuildConfig("original").performance?.chunkSplit?.strategy ? t : n(t, { performance: { chunkSplit: { strategy: "all-in-one" } } })), e.modifyRspackConfig((e) => {
-		if (!e.optimization) return e;
-		if (e.optimization.splitChunks === !1 && (e.optimization.splitChunks = {}), e.optimization.splitChunks) {
-			let t = e.optimization.splitChunks.chunks;
-			e.optimization.splitChunks.chunks = (e) => e.name?.includes("__main-thread") ? !1 : typeof t == "function" ? t(e) : t === "all" || t === "initial";
-		}
-		return e;
-	}), e.modifyBundlerChain((a, { environment: o, isProd: s }) => {
-		if (e.context.callerName !== "rspeedy") return;
-		let l = !s, u = o.name === "lynx" || o.name.startsWith("lynx-"), d = o.name === "web" || o.name.startsWith("web-"), { hmr: v, liveReload: y } = o.config.dev ?? {}, b = l && !d && v !== !1, x = l && !d && y !== !1, S = a.entryPoints.entries() ?? {};
-		a.entryPoints.clear();
-		let C = [];
-		for (let [e, i] of Object.entries(S)) {
-			let l = [], p = i;
-			for (let e of p.values()) if (typeof e == "string") l.push(e);
-			else if (typeof e == "object" && e && "import" in e) {
-				let t = e.import;
-				Array.isArray(t) ? l.push(...t) : t && l.push(t);
-			}
-			let m = u ? h : "", g = `${e}__main-thread`, _ = t.posix.join(m, `${e}/main-thread.js`), v = t.posix.join(m, `${e}/background${s ? ".[contenthash:8]" : ""}.js`);
-			(u || d) && C.push(_);
-			let y = b ? ["@lynx-js/css-extract-webpack-plugin/runtime/hotModuleReplacement.lepus.cjs", ...l] : [...l];
-			a.entry(g).add({
-				layer: c.MAIN_THREAD,
-				import: y,
-				filename: _
-			}).end();
-			let S = [];
-			S.push(...l);
-			let w = a.entry(e).add({
-				layer: c.BACKGROUND,
-				import: S,
-				filename: v
-			});
-			if (b && (w.prepend({
-				layer: c.BACKGROUND,
-				import: "@rspack/core/hot/dev-server"
-			}), w.prepend({
-				layer: c.BACKGROUND,
-				import: "@sigx/lynx-runtime/mt-hmr-bridge"
-			})), (b || x) && w.prepend({
-				layer: c.BACKGROUND,
-				import: "@lynx-js/webpack-dev-transport/client"
-			}), w.end(), (u || d) && r) {
-				let { LynxTemplatePlugin: i } = r, s = (typeof o.config.output.filename == "object" ? o.config.output.filename.bundle : o.config.output.filename) ?? "[name].[platform].bundle";
-				a.plugin(`${f}-${e}`).use(i, [{
-					...i.defaultOptions,
-					dsl: "react_nodiff",
-					chunks: [g, e],
-					filename: s.replaceAll("[name]", e).replaceAll("[platform]", o.name),
-					intermediate: t.posix.join(m, e),
-					debugInfoOutside: n.debugInfoOutside ?? !0,
-					enableCSSSelector: n.enableCSSSelector ?? !0,
-					enableCSSInvalidation: n.enableCSSSelector ?? !0,
-					enableCSSInheritance: n.enableCSSInheritance ?? !1,
-					customCSSInheritanceList: n.customCSSInheritanceList,
-					enableRemoveCSSScope: !0,
-					enableNewGesture: !0,
-					removeDescendantSelectorScope: !0,
-					cssPlugins: []
-				}]).end();
-			}
-		}
-		if ((u || d) && C.length > 0 && a.plugin(p).use(_, [C]).end(), u && i) {
-			let { RuntimeWrapperWebpackPlugin: e } = i;
-			a.plugin("lynx:sigx-runtime-wrapper").use(e, [{ test: /^(?!.*main-thread(?:\.[A-Fa-f0-9]*)?\.js$).*\.js$/ }]).end();
-		}
-		if (u && r) {
-			let { LynxEncodePlugin: e } = r;
-			a.plugin(m).use(e, [{}]).end();
-		}
-		b && a.module.rule("sigx-hmr").test(/\.[jt]sx?$/).issuerLayer(c.BACKGROUND).exclude.add(/node_modules/).add(/dist/).end().enforce("pre").use("sigx-hmr-loader").loader(t.resolve(g, "./loaders/hmr-loader")).end(), a.module.rule("sigx-worklet").test(/\.[jt]sx?$/).issuerLayer(c.BACKGROUND).enforce("pre").use("sigx-worklet-loader").loader(t.resolve(g, "./loaders/worklet-loader")).end(), a.module.rule("sigx-worklet-mt").test(/\.[jt]sx?$/).issuerLayer(c.MAIN_THREAD).enforce("pre").use("sigx-worklet-mt-loader").loader(t.resolve(g, "./loaders/worklet-loader-mt")).end(), a.output.set("iife", !1);
-	});
+/** Extract the hostname from a URL string (may be inside JSON quotes). */
+function extractHost(s) {
+    const m = s.match(/\/\/([^:/]+)/);
+    return m ? m[1] : '';
 }
-//#endregion
-//#region src/icons.ts
-var y = /<Icon\s+[^>]*?\bset\s*=\s*["']([\w-]+)["'][^>]*?\bname\s*=\s*["']([\w-]+)["']/g, b = /<Icon\s+[^>]*?\bname\s*=\s*["']([\w-]+)["'][^>]*?\bset\s*=\s*["']([\w-]+)["']/g, x = new Set([
-	"node_modules",
-	"dist",
-	"ios",
-	"android",
-	"Pods",
-	".git",
-	".cache",
-	".rspeedy"
-]), S = /\.(?:tsx?|jsx?)$/;
-async function C(e) {
-	let t = [];
-	async function r(e) {
-		let i;
-		try {
-			i = await s.readdir(e, { withFileTypes: !0 });
-		} catch {
-			return;
-		}
-		await Promise.all(i.map(async (i) => {
-			if (i.name.startsWith(".") || x.has(i.name)) return;
-			let a = n(e, i.name);
-			if (i.isDirectory()) return r(a);
-			i.isFile() && S.test(i.name) && t.push(a);
-		}));
-	}
-	return await r(e), t;
+/**
+ * Create an rsbuild / rspeedy plugin for SignalX-Lynx dual-thread rendering.
+ *
+ * @public
+ */
+export function pluginSigxLynx(options = {}) {
+    const { enableCSSSelector: _enableCSSSelector = true, enableCSSInheritance: _enableCSSInheritance = false, customCSSInheritanceList: _customCSSInheritanceList, debugInfoOutside: _debugInfoOutside = true, } = options;
+    return {
+        name: 'lynx:sigx',
+        // Must run after rspeedy's own config plugins (including pluginDev for URL fixes)
+        pre: ['lynx:rsbuild:plugin-api', 'lynx:config', 'lynx:rsbuild:dev'],
+        async setup(api) {
+            api.modifyRsbuildConfig((config, { mergeRsbuildConfig }) => {
+                // Compile all JS files (including node_modules) for ES2019 compat
+                // with the Lynx JS engine, unless user explicitly sets source.include.
+                const userConfig = api.getRsbuildConfig('original');
+                if (typeof userConfig.source?.include === 'undefined') {
+                    config = mergeRsbuildConfig(config, {
+                        source: {
+                            include: [/\.(?:js|mjs|cjs)$/],
+                        },
+                    });
+                }
+                // Honour `SIGX_LYNX_DEV_PORT` set by `@sigx/lynx-cli`. Rspeedy's CLI
+                // has no `--port` flag, so the CLI plumbs its computed port (from
+                // `sigx dev --port N` or the lynx-cli default) through this env var
+                // and we override `server.port` here. Without this, `serverState.port`
+                // on the lynx-cli side (used to build the device-launch URL) could
+                // diverge from whatever the user's `lynx.config.ts` set — and the
+                // device would boot pointing at a server that isn't there.
+                const envPort = process.env['SIGX_LYNX_DEV_PORT'];
+                const portOverride = envPort && Number.isFinite(Number(envPort))
+                    ? Number(envPort)
+                    : undefined;
+                if (portOverride !== undefined) {
+                    config = mergeRsbuildConfig(config, {
+                        server: { port: portOverride },
+                    });
+                }
+                return mergeRsbuildConfig(config, {
+                    source: {
+                        define: {
+                            __DEV__: 'process.env.NODE_ENV !== \'production\'',
+                        },
+                    },
+                    tools: {
+                        rspack: {
+                            output: {
+                                iife: false,
+                            },
+                        },
+                        swc: {
+                            jsc: {
+                                target: 'es2019',
+                                transform: {
+                                    react: {
+                                        runtime: 'automatic',
+                                        importSource: '@sigx/lynx',
+                                        throwIfNamespace: false,
+                                    },
+                                },
+                            },
+                        },
+                    },
+                });
+            });
+            // -------------------------------------------------------------------
+            // Dev-only: console log streaming. Two pieces:
+            //   1. `onAfterStartDevServer` boots a tiny `ws` server on
+            //      `devServerPort + 1` that receives batched log entries from
+            //      devices and emits them on stdout for the CLI to pretty-print.
+            //   2. `source.define` bakes the ws URL into the BG bundle so
+            //      `@sigx/lynx-dev-client/install` can pick it up at runtime.
+            // Both are gated on NODE_ENV !== 'production'.
+            //
+            // The Lynx BG runtime on Android has no `fetch` / `XHR` / `lynx.fetch`,
+            // so HTTP isn't an option for the device side. WebSocket is shipped by
+            // `@sigx/lynx-websocket` (URLSessionWebSocketTask on iOS, OkHttp on
+            // Android), which the dev-client imports as a side-effect.
+            // -------------------------------------------------------------------
+            const isDevServer = process.env['NODE_ENV'] !== 'production';
+            if (isDevServer) {
+                const lanIP = detectLanIPv4();
+                let logServer;
+                let wsPort = 0;
+                api.modifyRsbuildConfig((config, { mergeRsbuildConfig }) => {
+                    const envPort = process.env['SIGX_LYNX_DEV_PORT'];
+                    const httpPort = envPort && Number.isFinite(Number(envPort))
+                        ? Number(envPort)
+                        : (config.server?.port ?? 3000);
+                    wsPort = httpPort + 1;
+                    const logUrl = `ws://${lanIP}:${wsPort}${LOG_ENDPOINT_PATH}`;
+                    return mergeRsbuildConfig(config, {
+                        source: {
+                            define: {
+                                __SIGX_DEV_LOG_URL__: JSON.stringify(logUrl),
+                            },
+                        },
+                    });
+                });
+                api.onAfterStartDevServer(async () => {
+                    if (logServer)
+                        return;
+                    try {
+                        logServer = await createLogWebSocketServer({ port: wsPort });
+                        api.logger.info(`[sigx-lynx] device log ws → ws://${lanIP}:${logServer.port}${LOG_ENDPOINT_PATH}`);
+                    }
+                    catch (err) {
+                        api.logger.warn(`[sigx-lynx] device log ws failed to start on port ${wsPort}: ${err.message}`);
+                    }
+                });
+                const stopLogServer = async () => {
+                    if (!logServer)
+                        return;
+                    const s = logServer;
+                    logServer = undefined;
+                    await s.close();
+                };
+                api.onCloseDevServer(stopLogServer);
+                api.onExit(() => { void stopLogServer(); });
+            }
+            api.modifyBundlerChain((chain) => {
+                chain.resolve.alias.set('@sigx/runtime-dom', '@sigx/lynx-runtime');
+            });
+            // rspeedy's pluginDev uses `server.host` as the hostname for HMR
+            // client URLs (publicPath, WebSocket URL, printUrls). When the user
+            // sets server.host to '0.0.0.0' (bind all interfaces), those URLs
+            // become unreachable from external devices (phones, emulators).
+            //
+            // Fix at the rsbuild config level (runs AFTER rspeedy's hooks thanks
+            // to 'lynx:rsbuild:dev' in `pre`): replace wildcard hosts with the
+            // actual LAN IP in dev.assetPrefix, dev.client.host, output.assetPrefix,
+            // and the server.printUrls function.
+            api.modifyRsbuildConfig((config, { mergeRsbuildConfig }) => {
+                const devAssetPrefix = config.dev?.assetPrefix;
+                if (typeof devAssetPrefix !== 'string')
+                    return config;
+                // Only fix if the assetPrefix contains a wildcard host
+                let needsFix = false;
+                for (const wh of WILDCARD_HOSTS) {
+                    if (devAssetPrefix.includes(`//${wh}:`)) {
+                        needsFix = true;
+                        break;
+                    }
+                }
+                if (!needsFix)
+                    return config;
+                const lanIP = detectLanIPv4();
+                const replaceWildcard = (s) => {
+                    for (const wh of WILDCARD_HOSTS) {
+                        s = s.replaceAll(`//${wh}:`, `//${lanIP}:`);
+                    }
+                    return s;
+                };
+                const fixedAssetPrefix = replaceWildcard(devAssetPrefix);
+                // Override printUrls to show the correct LAN IP URL.
+                // rspeedy's printUrls uses closure variables that still hold '0.0.0.0',
+                // so we must replace the function entirely.
+                const existingPrintUrls = config.server?.printUrls;
+                const printUrlsFn = typeof existingPrintUrls === 'function'
+                    ? (param) => {
+                        // Call rspeedy's original printUrls to get the URL list,
+                        // then fix the hostnames in each URL.
+                        const result = existingPrintUrls(param);
+                        if (Array.isArray(result)) {
+                            return result.map((item) => typeof item === 'string'
+                                ? replaceWildcard(item)
+                                : { ...item, url: replaceWildcard(item.url) });
+                        }
+                        return result;
+                    }
+                    : undefined;
+                const merged = mergeRsbuildConfig(config, {
+                    dev: {
+                        assetPrefix: fixedAssetPrefix,
+                        client: {
+                            host: lanIP,
+                        },
+                    },
+                    output: {
+                        assetPrefix: fixedAssetPrefix,
+                    },
+                });
+                // Direct assignment — mergeRsbuildConfig can't reliably merge functions
+                if (printUrlsFn) {
+                    merged.server = { ...merged.server, printUrls: printUrlsFn };
+                }
+                return merged;
+            });
+            // Rspack's default watcher-ignore is only /node_modules|\.git/. In Lynx
+            // app layouts the ios/ Pods tree and dist/ output drown macOS FSEvents,
+            // causing edits to src/*.tsx to silently not fire rebuilds. Narrow the
+            // watched set and stop chasing symlinks through pnpm's .pnpm/ store.
+            //
+            // Upstream: fixed in Rspack 2.0 (`fix(watcher): filter stale FSEvents
+            // with mtime baseline comparison`). Rspeedy 0.14.2 still pins Rspack
+            // 1.7.10, so we can't adopt the real fix yet — revisit when rspeedy
+            // bumps to Rspack 2.0 and we can drop this hook.
+            api.modifyRspackConfig((rspackConfig) => {
+                const existing = rspackConfig.watchOptions ?? {};
+                const existingIgnored = Array.isArray(existing.ignored)
+                    ? existing.ignored
+                    : typeof existing.ignored === 'string'
+                        ? [existing.ignored]
+                        : [];
+                rspackConfig.watchOptions = {
+                    ...existing,
+                    ignored: [
+                        '**/node_modules/**',
+                        '**/.git/**',
+                        '**/dist/**',
+                        '**/ios/**',
+                        '**/android/**',
+                        '**/Pods/**',
+                        '**/.rspeedy/**',
+                        ...existingIgnored,
+                    ],
+                    followSymlinks: existing.followSymlinks ?? false,
+                    poll: existing.poll
+                        ?? (process.env.SIGX_LYNX_WATCH_POLL
+                            ? Number(process.env.SIGX_LYNX_WATCH_POLL) || true
+                            : undefined),
+                };
+            });
+            // Belt-and-suspenders: also patch at the rspack config level in case
+            // the rsbuild-level fix didn't propagate everywhere (e.g. resolve
+            // aliases set by rspeedy's modifyBundlerChain using closure variables).
+            api.modifyRspackConfig((rspackConfig) => {
+                // Check if publicPath or any resolve alias contains a wildcard host
+                let needsFix = false;
+                const publicPath = rspackConfig.output?.publicPath;
+                if (typeof publicPath === 'string') {
+                    for (const wh of WILDCARD_HOSTS) {
+                        if (publicPath.includes(`//${wh}:`)) {
+                            needsFix = true;
+                            break;
+                        }
+                    }
+                }
+                if (!needsFix) {
+                    const aliases = rspackConfig.resolve?.alias;
+                    if (aliases && typeof aliases === 'object' && !Array.isArray(aliases)) {
+                        for (const val of Object.values(aliases)) {
+                            if (typeof val === 'string') {
+                                for (const wh of WILDCARD_HOSTS) {
+                                    if (val.includes(`hostname=${wh}`)) {
+                                        needsFix = true;
+                                        break;
+                                    }
+                                }
+                            }
+                            if (needsFix)
+                                break;
+                        }
+                    }
+                }
+                if (!needsFix)
+                    return;
+                const lanIP = detectLanIPv4();
+                const replaceWildcard = (s) => {
+                    for (const wh of WILDCARD_HOSTS) {
+                        s = s.replaceAll(`//${wh}:`, `//${lanIP}:`);
+                        s = s.replaceAll(`hostname=${wh}`, `hostname=${lanIP}`);
+                    }
+                    return s;
+                };
+                // Fix output.publicPath (used for hot-update fetch URLs)
+                if (rspackConfig.output) {
+                    rspackConfig.output.publicPath = replaceWildcard(rspackConfig.output.publicPath);
+                }
+                // Fix the resolve alias for @lynx-js/webpack-dev-transport/client
+                // which embeds hostname=0.0.0.0 in query params for the WebSocket URL
+                const aliases = rspackConfig.resolve?.alias;
+                if (aliases && typeof aliases === 'object' && !Array.isArray(aliases)) {
+                    for (const [key, val] of Object.entries(aliases)) {
+                        if (typeof val === 'string') {
+                            const fixed = replaceWildcard(val);
+                            if (fixed !== val) {
+                                aliases[key] = fixed;
+                            }
+                        }
+                    }
+                }
+                // Fix ASSET_PREFIX in DefinePlugin definitions — these are stringified
+                // JSON values so the wildcard appears inside quoted strings.
+                for (const plugin of rspackConfig.plugins ?? []) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const defs = plugin?.definitions ?? plugin?._args?.[0];
+                    if (!defs || typeof defs !== 'object')
+                        continue;
+                    for (const [k, v] of Object.entries(defs)) {
+                        if (typeof v === 'string' && WILDCARD_HOSTS.has(extractHost(v))) {
+                            defs[k] = replaceWildcard(v);
+                        }
+                        else if (typeof v === 'object' && v !== null) {
+                            for (const [k2, v2] of Object.entries(v)) {
+                                if (typeof v2 === 'string' && WILDCARD_HOSTS.has(extractHost(v2))) {
+                                    v[k2] = replaceWildcard(v2);
+                                }
+                            }
+                        }
+                    }
+                }
+                // Fix SourceMapDevToolPlugin publicPath
+                for (const plugin of rspackConfig.plugins ?? []) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const opts = plugin?._options ?? plugin?._args?.[0];
+                    if (opts && typeof opts.publicPath === 'string') {
+                        opts.publicPath = replaceWildcard(opts.publicPath);
+                    }
+                }
+            });
+            // Wire CSS handling — forces extraction via @lynx-js/css-extract-webpack-plugin,
+            // strips lightningcss, and configures ignore-css-loader for main-thread layer.
+            applyCSS(api, {
+                enableCSSSelector: _enableCSSSelector,
+                enableCSSInvalidation: _enableCSSInheritance,
+            });
+            // Wire dual-thread entry splitting (worklets skipped in v1)
+            await applyEntry(api, {
+                debugInfoOutside: _debugInfoOutside,
+                enableCSSInheritance: _enableCSSInheritance,
+                customCSSInheritanceList: _customCSSInheritanceList,
+            });
+            // Wire @sigx/lynx-icons — reads iconSets from signalx.config.ts,
+            // scans the project for <Icon> usage, and aliases the runtime's
+            // virtual-module subpaths to generated codepoint / SVG maps.
+            // Safe to call unconditionally; bails out when no iconSets are
+            // configured or @sigx/lynx-cli isn't installed.
+            await applyIcons(api);
+        },
+    };
 }
-function w(e, t, n) {
-	let r = e.get(t);
-	r || (r = /* @__PURE__ */ new Set(), e.set(t, r)), r.add(n);
-}
-function T(e) {
-	if (!e.includes("<Icon")) return [];
-	let t = /* @__PURE__ */ new Set(), n = [], r = (e, r) => {
-		let i = `${e}\0${r}`;
-		t.has(i) || (t.add(i), n.push({
-			set: e,
-			name: r
-		}));
-	};
-	for (let t of e.matchAll(y)) r(t[1], t[2]);
-	for (let t of e.matchAll(b)) r(t[2], t[1]);
-	return n;
-}
-async function E(e) {
-	let t = /* @__PURE__ */ new Map(), n = await C(e);
-	return await Promise.all(n.map(async (e) => {
-		let n = await s.readFile(e, "utf8").catch(() => "");
-		for (let { set: e, name: r } of T(n)) w(t, e, r);
-	})), t;
-}
-async function D(e, t) {
-	try {
-		let r = await import(i(a(n(e, "noop.js")).resolve(t)).href);
-		return r.default ?? r;
-	} catch (e) {
-		return process.env.SIGX_DEBUG_ICONS && console.warn(`[@sigx/lynx-plugin] icons: failed to load adapter "${t}":`, e), null;
-	}
-}
-function O(e, t, n) {
-	let r = {}, i = {}, a = t.styles ?? e.styles;
-	for (let t of n) {
-		let n = null;
-		for (let r of a) if (n = e.getGlyph(r, t), n) break;
-		n && (i[t] = { svg: n.svg });
-	}
-	return {
-		codepoints: r,
-		svgs: i
-	};
-}
-async function k(e, t = {}) {
-	let r = t.cwd ?? process.cwd();
-	if (![
-		"signalx.config.ts",
-		"signalx.config.js",
-		"signalx.config.mjs"
-	].some((e) => o(n(r, e)))) return;
-	let i;
-	try {
-		i = await import("@sigx/lynx-cli");
-	} catch {
-		return;
-	}
-	let a = await i.loadConfig(r), c = i.resolveConfig(a);
-	if (!c.iconSets || c.iconSets.length === 0) return;
-	let l = await E(r), u = {}, d = {};
-	for (let e of c.iconSets) {
-		let t = await D(r, e.source);
-		if (!t) continue;
-		let n = new Set(l.get(e.id) ?? []);
-		for (let t of e.include) n.add(t);
-		if (e.include.includes("*")) {
-			n.delete("*");
-			let r = e.styles ?? t.styles;
-			for (let e of r) for (let r of t.listGlyphs(e)) n.add(r);
-			console.log(`[@sigx/lynx-plugin] icons: ${e.id} bundling ${n.size} glyphs (include: ['*'])`);
-		}
-		if (n.size === 0) continue;
-		let { codepoints: i, svgs: a } = O(t, e, n);
-		Object.keys(i).length > 0 && (u[e.id] = i), Object.keys(a).length > 0 && (d[e.id] = a);
-	}
-	let f = n(r, "node_modules", ".cache", "sigx-lynx-icons");
-	await s.mkdir(f, { recursive: !0 });
-	let p = n(f, "codepoints.mjs"), m = n(f, "svgs.mjs"), h = n(f, "font-face.css");
-	await s.writeFile(p, `// Auto-generated by @sigx/lynx-plugin — do not edit.\nexport const codepoints = ${JSON.stringify(u)};\n`), await s.writeFile(m, `// Auto-generated by @sigx/lynx-plugin — do not edit.\nexport const svgs = ${JSON.stringify(d)};\n`), await s.writeFile(h, "/* Auto-generated by @sigx/lynx-plugin — font mode lands in v1.1. */\n"), e.modifyBundlerChain((e) => {
-		e.resolve.alias.set("@sigx/lynx-icons/__codepoints", p), e.resolve.alias.set("@sigx/lynx-icons/__svgs", m), e.resolve.alias.set("@sigx/lynx-icons/__font-face.css", h);
-	});
-}
-//#endregion
-//#region src/index.ts
-var A = t.dirname(r(import.meta.url));
-t.resolve(A, "../..");
-var j = new Set([
-	"0.0.0.0",
-	"::",
-	"0:0:0:0:0:0:0:0"
-]), M = /^(vEthernet|veth|docker|br-|virbr|vmnet|VirtualBox|Hyper-V|WSL|ham\d)/i;
-function N() {
-	let t = e(), n;
-	for (let [e, r] of Object.entries(t)) for (let t of r ?? []) if (!(t.family !== "IPv4" || t.internal || !t.address) && (n ||= t.address, !M.test(e))) return t.address;
-	return n ?? "127.0.0.1";
-}
-function P(e) {
-	let t = e.match(/\/\/([^:/]+)/);
-	return t ? t[1] : "";
-}
-function F(e = {}) {
-	let { enableCSSSelector: t = !0, enableCSSInheritance: n = !1, customCSSInheritanceList: r, debugInfoOutside: i = !0 } = e;
-	return {
-		name: "lynx:sigx",
-		pre: [
-			"lynx:rsbuild:plugin-api",
-			"lynx:config",
-			"lynx:rsbuild:dev"
-		],
-		async setup(e) {
-			e.modifyRsbuildConfig((t, { mergeRsbuildConfig: n }) => {
-				e.getRsbuildConfig("original").source?.include === void 0 && (t = n(t, { source: { include: [/\.(?:js|mjs|cjs)$/] } }));
-				let r = process.env.SIGX_LYNX_DEV_PORT, i = r && Number.isFinite(Number(r)) ? Number(r) : void 0;
-				return i !== void 0 && (t = n(t, { server: { port: i } })), n(t, {
-					source: { define: { __DEV__: "process.env.NODE_ENV !== 'production'" } },
-					tools: {
-						rspack: { output: { iife: !1 } },
-						swc: { jsc: {
-							target: "es2019",
-							transform: { react: {
-								runtime: "automatic",
-								importSource: "@sigx/lynx",
-								throwIfNamespace: !1
-							} }
-						} }
-					}
-				});
-			}), e.modifyBundlerChain((e) => {
-				e.resolve.alias.set("@sigx/runtime-dom", "@sigx/lynx-runtime");
-			}), e.modifyRsbuildConfig((e, { mergeRsbuildConfig: t }) => {
-				let n = e.dev?.assetPrefix;
-				if (typeof n != "string") return e;
-				let r = !1;
-				for (let e of j) if (n.includes(`//${e}:`)) {
-					r = !0;
-					break;
-				}
-				if (!r) return e;
-				let i = N(), a = (e) => {
-					for (let t of j) e = e.replaceAll(`//${t}:`, `//${i}:`);
-					return e;
-				}, o = a(n), s = e.server?.printUrls, c = typeof s == "function" ? (e) => {
-					let t = s(e);
-					return Array.isArray(t) ? t.map((e) => typeof e == "string" ? a(e) : {
-						...e,
-						url: a(e.url)
-					}) : t;
-				} : void 0, l = t(e, {
-					dev: {
-						assetPrefix: o,
-						client: { host: i }
-					},
-					output: { assetPrefix: o }
-				});
-				return c && (l.server = {
-					...l.server,
-					printUrls: c
-				}), l;
-			}), e.modifyRspackConfig((e) => {
-				let t = e.watchOptions ?? {}, n = Array.isArray(t.ignored) ? t.ignored : typeof t.ignored == "string" ? [t.ignored] : [];
-				e.watchOptions = {
-					...t,
-					ignored: [
-						"**/node_modules/**",
-						"**/.git/**",
-						"**/dist/**",
-						"**/ios/**",
-						"**/android/**",
-						"**/Pods/**",
-						"**/.rspeedy/**",
-						...n
-					],
-					followSymlinks: t.followSymlinks ?? !1,
-					poll: t.poll ?? (process.env.SIGX_LYNX_WATCH_POLL ? Number(process.env.SIGX_LYNX_WATCH_POLL) || !0 : void 0)
-				};
-			}), e.modifyRspackConfig((e) => {
-				let t = !1, n = e.output?.publicPath;
-				if (typeof n == "string") {
-					for (let e of j) if (n.includes(`//${e}:`)) {
-						t = !0;
-						break;
-					}
-				}
-				if (!t) {
-					let n = e.resolve?.alias;
-					if (n && typeof n == "object" && !Array.isArray(n)) for (let e of Object.values(n)) {
-						if (typeof e == "string") {
-							for (let n of j) if (e.includes(`hostname=${n}`)) {
-								t = !0;
-								break;
-							}
-						}
-						if (t) break;
-					}
-				}
-				if (!t) return;
-				let r = N(), i = (e) => {
-					for (let t of j) e = e.replaceAll(`//${t}:`, `//${r}:`), e = e.replaceAll(`hostname=${t}`, `hostname=${r}`);
-					return e;
-				};
-				e.output && (e.output.publicPath = i(e.output.publicPath));
-				let a = e.resolve?.alias;
-				if (a && typeof a == "object" && !Array.isArray(a)) {
-					for (let [e, t] of Object.entries(a)) if (typeof t == "string") {
-						let n = i(t);
-						n !== t && (a[e] = n);
-					}
-				}
-				for (let t of e.plugins ?? []) {
-					let e = t?.definitions ?? t?._args?.[0];
-					if (!(!e || typeof e != "object")) {
-						for (let [t, n] of Object.entries(e)) if (typeof n == "string" && j.has(P(n))) e[t] = i(n);
-						else if (typeof n == "object" && n) for (let [e, t] of Object.entries(n)) typeof t == "string" && j.has(P(t)) && (n[e] = i(t));
-					}
-				}
-				for (let t of e.plugins ?? []) {
-					let e = t?._options ?? t?._args?.[0];
-					e && typeof e.publicPath == "string" && (e.publicPath = i(e.publicPath));
-				}
-			}), u(e, {
-				enableCSSSelector: t,
-				enableCSSInvalidation: n
-			}), await v(e, {
-				debugInfoOutside: i,
-				enableCSSInheritance: n,
-				customCSSInheritanceList: r
-			}), await k(e);
-		}
-	};
-}
-//#endregion
-export { c as LAYERS, v as applyEntry, F as pluginSigxLynx };
-
-//# sourceMappingURL=index.js.map