boss-css 0.0.1 → 0.0.2

package/dist/detect-fw/index.mjs

@@ -0,0 +1,379 @@
+import { parseJson } from "../shared/json.mjs";
+import fs from "node:fs/promises";
+import path from "node:path";
+
+//#region src/detect-fw/index.ts
+const jsxFrameworks = [
+	{
+		id: "react",
+		name: "react",
+		label: "React",
+		fileType: "jsx",
+		className: "className",
+		jsx: {
+			importSource: "react",
+			runtimeModule: "react/jsx-runtime",
+			typesModule: "react",
+			typesNamespace: "JSX",
+			elementType: "BossJSX.ElementType",
+			componentProps: "BossJSX.ComponentPropsWithoutRef<C>"
+		},
+		detect: {
+			dependencies: [
+				"react",
+				"react-dom",
+				"react-native"
+			],
+			importSources: ["react"]
+		}
+	},
+	{
+		id: "preact",
+		name: "preact",
+		label: "Preact",
+		fileType: "jsx",
+		className: "className",
+		jsx: {
+			importSource: "preact",
+			runtimeModule: "preact/jsx-runtime",
+			typesModule: "preact",
+			typesNamespace: "JSX"
+		},
+		detect: {
+			dependencies: ["preact"],
+			importSources: ["preact"]
+		}
+	},
+	{
+		id: "solid",
+		name: "solid",
+		label: "Solid",
+		fileType: "jsx",
+		className: "class",
+		jsx: {
+			importSource: "solid-js",
+			runtimeModule: "solid-js/jsx-runtime",
+			typesModule: "solid-js",
+			typesNamespace: "JSX",
+			elementType: "BossJSX.ValidComponent",
+			componentProps: "BossJSX.ComponentProps<C>"
+		},
+		detect: {
+			dependencies: ["solid-js"],
+			importSources: ["solid-js"]
+		}
+	},
+	{
+		id: "qwik",
+		name: "qwik",
+		label: "Qwik",
+		fileType: "jsx",
+		className: "class",
+		jsx: {
+			importSource: "@builder.io/qwik",
+			runtimeModule: "@builder.io/qwik/jsx-runtime",
+			typesModule: "@builder.io/qwik",
+			typesNamespace: "JSX"
+		},
+		detect: {
+			dependencies: ["@builder.io/qwik", "@builder.io/qwik-city"],
+			importSources: ["@builder.io/qwik"]
+		}
+	},
+	{
+		id: "stencil",
+		name: "stencil",
+		label: "Stencil",
+		fileType: "jsx",
+		className: "class",
+		jsx: {
+			importSource: "@stencil/core",
+			runtimeModule: "@stencil/core/internal",
+			typesModule: "@stencil/core",
+			typesNamespace: "JSX"
+		},
+		detect: {
+			dependencies: ["@stencil/core"],
+			importSources: ["@stencil/core"]
+		}
+	}
+];
+const sfcFrameworks = [];
+const frameworkById = new Map(jsxFrameworks.map((entry) => [entry.id, entry]));
+const frameworkByImportSource = new Map(jsxFrameworks.flatMap((entry) => (entry.detect.importSources ?? []).map((source) => [source, entry])));
+const defaultFramework = frameworkById.get("react");
+const defaultElementType = "keyof BossIntrinsicElements | ((props: any) => any) | (new (props: any) => any)";
+const defaultComponentProps = "C extends keyof BossIntrinsicElements ? BossIntrinsicElements[C] : any";
+const stripJsonComments = (input) => {
+	let output = "";
+	let inString = false;
+	let stringChar = "";
+	let escaped = false;
+	let inLineComment = false;
+	let inBlockComment = false;
+	for (let index = 0; index < input.length; index += 1) {
+		const char = input[index];
+		const next = input[index + 1];
+		if (inLineComment) {
+			if (char === "\n") {
+				inLineComment = false;
+				output += char;
+			}
+			continue;
+		}
+		if (inBlockComment) {
+			if (char === "*" && next === "/") {
+				inBlockComment = false;
+				index += 1;
+			}
+			continue;
+		}
+		if (inString) {
+			output += char;
+			if (escaped) {
+				escaped = false;
+				continue;
+			}
+			if (char === "\\") {
+				escaped = true;
+				continue;
+			}
+			if (char === stringChar) {
+				inString = false;
+				stringChar = "";
+			}
+			continue;
+		}
+		if (char === "\"" || char === "'") {
+			inString = true;
+			stringChar = char;
+			output += char;
+			continue;
+		}
+		if (char === "/" && next === "/") {
+			inLineComment = true;
+			index += 1;
+			continue;
+		}
+		if (char === "/" && next === "*") {
+			inBlockComment = true;
+			index += 1;
+			continue;
+		}
+		output += char;
+	}
+	return output;
+};
+const stripTrailingCommas = (input) => {
+	let output = "";
+	let inString = false;
+	let stringChar = "";
+	let escaped = false;
+	for (let index = 0; index < input.length; index += 1) {
+		const char = input[index];
+		if (inString) {
+			output += char;
+			if (escaped) {
+				escaped = false;
+				continue;
+			}
+			if (char === "\\") {
+				escaped = true;
+				continue;
+			}
+			if (char === stringChar) {
+				inString = false;
+				stringChar = "";
+			}
+			continue;
+		}
+		if (char === "\"" || char === "'") {
+			inString = true;
+			stringChar = char;
+			output += char;
+			continue;
+		}
+		if (char === ",") {
+			let lookahead = index + 1;
+			while (lookahead < input.length && /\s/.test(input[lookahead])) lookahead += 1;
+			const nextChar = input[lookahead];
+			if (nextChar === "}" || nextChar === "]") continue;
+		}
+		output += char;
+	}
+	return output;
+};
+const parseJsonLoose = (raw, filePath) => {
+	return parseJson(stripTrailingCommas(stripJsonComments(raw)), {
+		filePath,
+		allowTrailingCommas: true
+	});
+};
+const readPackageJson = async (cwd) => {
+	const filePath = path.join(cwd, "package.json");
+	const raw = await fs.readFile(filePath, "utf8").catch(() => null);
+	if (!raw) return null;
+	try {
+		return parseJson(raw, {
+			filePath,
+			allowTrailingCommas: true
+		});
+	} catch {
+		return null;
+	}
+};
+const readTsconfig = async (cwd, preferredPath) => {
+	const candidates = preferredPath ? [preferredPath] : [
+		"tsconfig.json",
+		"tsconfig.app.json",
+		"tsconfig.base.json"
+	];
+	for (const candidate of candidates) {
+		const filePath = path.isAbsolute(candidate) ? candidate : path.join(cwd, candidate);
+		const raw = await fs.readFile(filePath, "utf8").catch(() => null);
+		if (!raw) continue;
+		try {
+			return parseJsonLoose(raw, filePath);
+		} catch {
+			continue;
+		}
+	}
+	return null;
+};
+const collectDependencies = (packageJson) => {
+	const fields = [
+		"dependencies",
+		"devDependencies",
+		"peerDependencies",
+		"optionalDependencies"
+	];
+	const deps = /* @__PURE__ */ new Set();
+	for (const field of fields) {
+		const value = packageJson[field];
+		if (!value || typeof value !== "object") continue;
+		for (const name of Object.keys(value)) deps.add(name);
+	}
+	return deps;
+};
+const createDescriptorFromImportSource = (importSource) => {
+	const match = frameworkByImportSource.get(importSource);
+	if (match) return match;
+	return {
+		id: "custom",
+		name: importSource,
+		label: importSource,
+		fileType: "jsx",
+		className: "className",
+		jsx: {
+			importSource,
+			runtimeModule: `${importSource}/jsx-runtime`,
+			typesModule: `${importSource}/jsx-runtime`,
+			typesNamespace: "JSX"
+		}
+	};
+};
+const applyFrameworkOverrides = (base, override) => {
+	if (!override) return base;
+	const next = { ...base };
+	if (override.className) next.className = override.className;
+	if (override.fileType) next.fileType = override.fileType;
+	if (override.jsx) next.jsx = {
+		importSource: override.jsx.importSource ?? next.jsx?.importSource ?? "",
+		runtimeModule: override.jsx.runtimeModule ?? next.jsx?.runtimeModule ?? "",
+		typesModule: override.jsx.typesModule ?? next.jsx?.typesModule ?? "",
+		typesNamespace: override.jsx.typesNamespace ?? next.jsx?.typesNamespace ?? "JSX",
+		elementType: override.jsx.elementType ?? next.jsx?.elementType ?? void 0,
+		componentProps: override.jsx.componentProps ?? next.jsx?.componentProps ?? void 0
+	};
+	return next;
+};
+const resolveFrameworkFromConfig = (config) => {
+	if (!config?.framework) return null;
+	const raw = config.framework;
+	if (typeof raw === "string") {
+		if (raw === "auto") return null;
+		const match = frameworkById.get(raw);
+		if (match) return match;
+		return createDescriptorFromImportSource(raw);
+	}
+	if (raw.name && raw.name !== "auto") {
+		const match = frameworkById.get(raw.name);
+		if (match) return applyFrameworkOverrides(match, raw);
+		return applyFrameworkOverrides(createDescriptorFromImportSource(raw.name), raw);
+	}
+	if (raw.jsx?.importSource || raw.jsx?.typesModule) return applyFrameworkOverrides(createDescriptorFromImportSource(raw.jsx.importSource ?? "custom-jsx-runtime"), raw);
+	if (raw.fileType) return applyFrameworkOverrides({
+		id: "unknown",
+		name: "unknown",
+		label: "Unknown",
+		fileType: raw.fileType,
+		className: "className"
+	}, raw);
+	return null;
+};
+const resolveFrameworkFromTsconfig = (tsconfig) => {
+	const compilerOptions = tsconfig?.compilerOptions;
+	if (!compilerOptions || typeof compilerOptions !== "object") return null;
+	const jsxImportSource = compilerOptions.jsxImportSource;
+	if (typeof jsxImportSource !== "string" || !jsxImportSource.trim()) return null;
+	return createDescriptorFromImportSource(jsxImportSource);
+};
+const resolveFrameworkFromPackageJson = (packageJson) => {
+	if (!packageJson) return null;
+	const deps = collectDependencies(packageJson);
+	for (const entry of jsxFrameworks) if (entry.detect.dependencies.some((dep) => deps.has(dep))) return entry;
+	for (const entry of sfcFrameworks) if (entry.detect.dependencies.some((dep) => deps.has(dep))) return entry;
+	return null;
+};
+const getJsxTypes = (framework) => {
+	const jsx = framework.jsx ?? defaultFramework.jsx;
+	return {
+		...jsx,
+		elementType: jsx?.elementType ?? defaultElementType,
+		componentProps: jsx?.componentProps ?? defaultComponentProps
+	};
+};
+const detectFramework = async (options = {}) => {
+	const cwd = options.cwd ?? process.cwd();
+	const notes = [];
+	const configMatch = resolveFrameworkFromConfig(options.config);
+	if (configMatch) return {
+		...configMatch,
+		source: "config",
+		notes
+	};
+	const tsconfigMatch = resolveFrameworkFromTsconfig(await readTsconfig(cwd, options.tsconfigPath));
+	if (tsconfigMatch) {
+		notes.push("tsconfig jsxImportSource");
+		return {
+			...tsconfigMatch,
+			source: "tsconfig",
+			notes
+		};
+	}
+	const packageMatch = resolveFrameworkFromPackageJson(options.packageJson ?? await readPackageJson(cwd));
+	if (packageMatch) {
+		notes.push("package.json dependencies");
+		return {
+			...packageMatch,
+			source: "package.json",
+			notes
+		};
+	}
+	return {
+		...defaultFramework,
+		source: "default",
+		notes
+	};
+};
+const listFrameworks = () => jsxFrameworks.map((entry) => ({
+	id: entry.id,
+	name: entry.name,
+	label: entry.label,
+	fileType: entry.fileType,
+	className: entry.className,
+	jsx: entry.jsx
+}));
+
+//#endregion
+export { detectFramework, getJsxTypes, listFrameworks };

package/dist/dev/client.cjs

@@ -0,0 +1,39 @@
+
+//#region src/dev/client.ts
+const DEVTOOLS_ATTR = "data-boss-devtools";
+const ROOT_ID = "boss-devtools-root";
+function startDevClient({ port }) {
+	if (typeof window === "undefined") return;
+	const nextPort = Number(port);
+	if (!Number.isFinite(nextPort)) return;
+	const container = ensureRoot();
+	loadDevtools().then((mount) => {
+		if (!mount) return;
+		mount(container, nextPort);
+	});
+}
+function ensureRoot() {
+	let container = document.getElementById(ROOT_ID);
+	if (!container) {
+		container = document.createElement("div");
+		container.id = ROOT_ID;
+		container.setAttribute(DEVTOOLS_ATTR, "true");
+		document.body.appendChild(container);
+	}
+	return container;
+}
+async function loadDevtools() {
+	const globalMount = globalThis.__bossDevtoolsApp?.mountDevtoolsApp;
+	if (typeof globalMount === "function") return globalMount;
+	try {
+		const module = await import("boss-css/devtools-app");
+		if (typeof module.mountDevtoolsApp === "function") return module.mountDevtoolsApp;
+		const fallback = globalThis.__bossDevtoolsApp?.mountDevtoolsApp;
+		return typeof fallback === "function" ? fallback : null;
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+exports.startDevClient = startDevClient;

package/dist/dev/client.mjs

@@ -0,0 +1,38 @@
+//#region src/dev/client.ts
+const DEVTOOLS_ATTR = "data-boss-devtools";
+const ROOT_ID = "boss-devtools-root";
+function startDevClient({ port }) {
+	if (typeof window === "undefined") return;
+	const nextPort = Number(port);
+	if (!Number.isFinite(nextPort)) return;
+	const container = ensureRoot();
+	loadDevtools().then((mount) => {
+		if (!mount) return;
+		mount(container, nextPort);
+	});
+}
+function ensureRoot() {
+	let container = document.getElementById(ROOT_ID);
+	if (!container) {
+		container = document.createElement("div");
+		container.id = ROOT_ID;
+		container.setAttribute(DEVTOOLS_ATTR, "true");
+		document.body.appendChild(container);
+	}
+	return container;
+}
+async function loadDevtools() {
+	const globalMount = globalThis.__bossDevtoolsApp?.mountDevtoolsApp;
+	if (typeof globalMount === "function") return globalMount;
+	try {
+		const module = await import("boss-css/devtools-app");
+		if (typeof module.mountDevtoolsApp === "function") return module.mountDevtoolsApp;
+		const fallback = globalThis.__bossDevtoolsApp?.mountDevtoolsApp;
+		return typeof fallback === "function" ? fallback : null;
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+export { startDevClient };

package/dist/dev/plugin/browser.cjs

@@ -0,0 +1,11 @@
+
+//#region src/dev/plugin/browser.ts
+const name = "devtools";
+const onBrowserObjectStart = (api, { output = {}, contexts = [] }) => {
+	if (contexts.length) return;
+	output["data-boss"] = "true";
+};
+
+//#endregion
+exports.name = name;
+exports.onBrowserObjectStart = onBrowserObjectStart;

package/dist/dev/plugin/browser.mjs

@@ -0,0 +1,9 @@
+//#region src/dev/plugin/browser.ts
+const name = "devtools";
+const onBrowserObjectStart = (api, { output = {}, contexts = [] }) => {
+	if (contexts.length) return;
+	output["data-boss"] = "true";
+};
+
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/dev/plugin/server.cjs

@@ -0,0 +1,86 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_shared = require('../shared.cjs');
+const require_dev_server = require('../server.cjs');
+const require_port = require('../port.cjs');
+
+//#region src/dev/plugin/server.ts
+var server_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	name: () => name,
+	onBoot: () => onBoot,
+	onSession: () => onSession
+});
+const name = "devtools";
+let devServer = null;
+let starting = null;
+let handlersInstalled = false;
+const onBoot = async (api) => {
+	if (process.env.NODE_ENV === "production") return;
+	api.file.js.import({ from: "boss-css/dev/runtime" });
+	api.file.js.importAndConfig({
+		name: "onBrowserObjectStart",
+		from: "boss-css/dev/plugin/browser"
+	});
+	const hostApiVar = api.file.js.import({
+		name: "api",
+		from: "boss-css/api/browser"
+	});
+	api.file.js.set("body", "devtools:globalThis", `globalThis.host$$ = ${hostApiVar}`);
+	const port = Number(api.devServer?.port);
+	if (Number.isFinite(port) && port !== require_shared.DEFAULT_DEV_PORT) api.file.js.config({
+		from: "boss-css/dev/plugin",
+		config: { devServer: { port } }
+	});
+};
+const ensureDevServer = async (api, session) => {
+	if (devServer) return devServer;
+	if (starting) return starting;
+	const basePort = Number.isFinite(Number(api.devServer?.port)) ? Number(api.devServer?.port) : require_shared.DEFAULT_DEV_PORT;
+	starting = require_dev_server.startDevServer({
+		port: basePort,
+		maxPort: basePort + 49
+	}).catch((err) => {
+		starting = null;
+		throw err;
+	});
+	devServer = await starting;
+	starting = null;
+	const shouldInsert = devServer.port !== require_shared.DEFAULT_DEV_PORT;
+	if (session?.configPath) await require_port.updateDevPort(session.configPath, devServer.port, shouldInsert);
+	if (session?.runtimePath) await require_port.updateRuntimePort(session.runtimePath, devServer.port);
+	if (!handlersInstalled) {
+		handlersInstalled = true;
+		const closeServer = () => {
+			if (!devServer) return;
+			devServer.server.close();
+			devServer = null;
+		};
+		process.once("exit", closeServer);
+		process.once("SIGINT", () => {
+			closeServer();
+			process.exit();
+		});
+		process.once("SIGTERM", () => {
+			closeServer();
+			process.exit();
+		});
+	}
+	return devServer;
+};
+const onSession = async (api, session) => {
+	if (process.env.NODE_ENV === "production") return;
+	if (!session || session.phase !== "start") return;
+	if (session.kind !== "watch" && session.kind !== "postcss") return;
+	if (api?.devServer?.autoStart === false) return;
+	await ensureDevServer(api, session);
+};
+
+//#endregion
+exports.name = name;
+exports.onBoot = onBoot;
+exports.onSession = onSession;
+Object.defineProperty(exports, 'server_exports', {
+  enumerable: true,
+  get: function () {
+    return server_exports;
+  }
+});

package/dist/dev/plugin/server.mjs

@@ -0,0 +1,78 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.mjs";
+import { DEFAULT_DEV_PORT } from "../shared.mjs";
+import { startDevServer } from "../server.mjs";
+import { updateDevPort, updateRuntimePort } from "../port.mjs";
+
+//#region src/dev/plugin/server.ts
+var server_exports = /* @__PURE__ */ __exportAll({
+	name: () => name,
+	onBoot: () => onBoot,
+	onSession: () => onSession
+});
+const name = "devtools";
+let devServer = null;
+let starting = null;
+let handlersInstalled = false;
+const onBoot = async (api) => {
+	if (process.env.NODE_ENV === "production") return;
+	api.file.js.import({ from: "boss-css/dev/runtime" });
+	api.file.js.importAndConfig({
+		name: "onBrowserObjectStart",
+		from: "boss-css/dev/plugin/browser"
+	});
+	const hostApiVar = api.file.js.import({
+		name: "api",
+		from: "boss-css/api/browser"
+	});
+	api.file.js.set("body", "devtools:globalThis", `globalThis.host$$ = ${hostApiVar}`);
+	const port = Number(api.devServer?.port);
+	if (Number.isFinite(port) && port !== DEFAULT_DEV_PORT) api.file.js.config({
+		from: "boss-css/dev/plugin",
+		config: { devServer: { port } }
+	});
+};
+const ensureDevServer = async (api, session) => {
+	if (devServer) return devServer;
+	if (starting) return starting;
+	const basePort = Number.isFinite(Number(api.devServer?.port)) ? Number(api.devServer?.port) : DEFAULT_DEV_PORT;
+	starting = startDevServer({
+		port: basePort,
+		maxPort: basePort + 49
+	}).catch((err) => {
+		starting = null;
+		throw err;
+	});
+	devServer = await starting;
+	starting = null;
+	const shouldInsert = devServer.port !== DEFAULT_DEV_PORT;
+	if (session?.configPath) await updateDevPort(session.configPath, devServer.port, shouldInsert);
+	if (session?.runtimePath) await updateRuntimePort(session.runtimePath, devServer.port);
+	if (!handlersInstalled) {
+		handlersInstalled = true;
+		const closeServer = () => {
+			if (!devServer) return;
+			devServer.server.close();
+			devServer = null;
+		};
+		process.once("exit", closeServer);
+		process.once("SIGINT", () => {
+			closeServer();
+			process.exit();
+		});
+		process.once("SIGTERM", () => {
+			closeServer();
+			process.exit();
+		});
+	}
+	return devServer;
+};
+const onSession = async (api, session) => {
+	if (process.env.NODE_ENV === "production") return;
+	if (!session || session.phase !== "start") return;
+	if (session.kind !== "watch" && session.kind !== "postcss") return;
+	if (api?.devServer?.autoStart === false) return;
+	await ensureDevServer(api, session);
+};
+
+//#endregion
+export { name, onBoot, onSession, server_exports };

package/dist/dev/port.cjs

@@ -0,0 +1,46 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_rolldown_runtime.__toESM(node_fs_promises);
+
+//#region src/dev/port.ts
+const updateDevPort = async (configPath, port, allowInsert) => {
+	const raw = await node_fs_promises.default.readFile(configPath, "utf8");
+	const portPattern = /(devServer\s*:\s*{[^}]*port\s*:\s*)(\d+)/m;
+	if (portPattern.test(raw)) {
+		const next = raw.replace(portPattern, `$1${port}`);
+		await node_fs_promises.default.writeFile(configPath, next);
+		return true;
+	}
+	if (!allowInsert) return true;
+	const folderLine = raw.match(/^[ \t]*folder\s*:[^\n]*$/m);
+	if (folderLine) {
+		const insert = `${folderLine[0].match(/^[ \t]*/)?.[0] ?? "    "}devServer: { port: ${port} },\n`;
+		const next = raw.replace(folderLine[0], `${folderLine[0]}\n${insert}`);
+		await node_fs_promises.default.writeFile(configPath, next);
+		return true;
+	}
+	const defaultExport = raw.match(/export default\s*{\s*/m);
+	if (defaultExport) {
+		const insert = `export default {\n    devServer: { port: ${port} },\n`;
+		const next = raw.replace(defaultExport[0], insert);
+		await node_fs_promises.default.writeFile(configPath, next);
+		return true;
+	}
+	return false;
+};
+const updateRuntimePort = async (runtimePath, port) => {
+	try {
+		const raw = await node_fs_promises.default.readFile(runtimePath, "utf8");
+		const markerPattern = /port:\s*\d+(?=[^\n]*boss-dev-port)/;
+		if (!markerPattern.test(raw)) return false;
+		const next = raw.replace(markerPattern, `port: ${port}`);
+		await node_fs_promises.default.writeFile(runtimePath, next);
+		return true;
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+exports.updateDevPort = updateDevPort;
+exports.updateRuntimePort = updateRuntimePort;