boss-css 0.0.1 → 0.0.2

package/dist/dev/server.cjs

@@ -0,0 +1,808 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_api_server = require('../api/server.cjs');
+const require_api_config = require('../api/config.cjs');
+const require_use_token_server = require('../use/token/server.cjs');
+const require_shared = require('./shared.cjs');
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_rolldown_runtime.__toESM(node_fs_promises);
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path);
+let node_url = require("node:url");
+let ws = require("ws");
+
+//#region src/dev/server.ts
+const DEFAULT_MAX_PORT = require_shared.DEFAULT_DEV_PORT + 49;
+async function startDevServer({ port = require_shared.DEFAULT_DEV_PORT, maxPort = DEFAULT_MAX_PORT, host = "127.0.0.1" } = {}) {
+	let currentPort = port;
+	let server = null;
+	while (currentPort <= maxPort) try {
+		server = await listenOnPort(currentPort, host);
+		break;
+	} catch (error) {
+		if (isAddressInUse(error)) {
+			currentPort += 1;
+			continue;
+		}
+		throw error;
+	}
+	if (!server) throw new Error(`No available ports in range ${port}-${maxPort}`);
+	server.on("connection", (socket) => {
+		socket.on("message", async (data) => {
+			const message = parseClientMessage(data);
+			if (!message) return;
+			try {
+				if (message.type === "select") {
+					const entries = await inspectSelection(message.source);
+					socket.send(JSON.stringify({
+						type: "select-result",
+						id: message.id,
+						props: entries
+					}));
+				} else if (message.type === "edit") {
+					await applyEdit(message);
+					socket.send(JSON.stringify({
+						type: "edit-result",
+						id: message.id,
+						ok: true
+					}));
+				} else if (message.type === "add-prop") {
+					await applyAddProp(message);
+					socket.send(JSON.stringify({
+						type: "add-prop-result",
+						id: message.id,
+						ok: true
+					}));
+				} else if (message.type === "read-file") {
+					const content = await readFileForClient(message.path);
+					socket.send(JSON.stringify({
+						type: "read-file-result",
+						id: message.id,
+						content
+					}));
+				} else if (message.type === "write-file") {
+					await writeFileForClient(message.path, message.content);
+					socket.send(JSON.stringify({
+						type: "write-file-result",
+						id: message.id,
+						ok: true
+					}));
+				} else if (message.type === "tokens") {
+					const tokens = await getTokenSnapshot();
+					socket.send(JSON.stringify({
+						type: "tokens-result",
+						id: message.id,
+						tokens
+					}));
+				} else if (message.type === "boss-types") {
+					const content = await getBossTypes();
+					socket.send(JSON.stringify({
+						type: "boss-types-result",
+						id: message.id,
+						content
+					}));
+				}
+			} catch (error) {
+				const err = error instanceof Error ? error.message : String(error);
+				socket.send(JSON.stringify({
+					type: "error",
+					id: message.id,
+					message: err
+				}));
+			}
+		});
+	});
+	return {
+		server,
+		port: currentPort
+	};
+}
+const listenOnPort = (port, host) => {
+	return new Promise((resolve, reject) => {
+		const server = new ws.WebSocketServer({
+			port,
+			host
+		});
+		const onError = (error) => {
+			server.removeListener("listening", onListening);
+			server.close();
+			reject(error);
+		};
+		const onListening = () => {
+			server.removeListener("error", onError);
+			resolve(server);
+		};
+		server.once("error", onError);
+		server.once("listening", onListening);
+	});
+};
+const isAddressInUse = (error) => {
+	return Boolean(error && typeof error === "object" && "code" in error && error.code === "EADDRINUSE");
+};
+const parseClientMessage = (data) => {
+	try {
+		const parsed = JSON.parse(data.toString());
+		if (!parsed || typeof parsed.type !== "string") return null;
+		return parsed;
+	} catch {
+		return null;
+	}
+};
+async function readFileForClient(filePath) {
+	if (!filePath || typeof filePath !== "string") return null;
+	const resolved = await resolveSourcePath(filePath);
+	if (!await fileExists(resolved)) return null;
+	return node_fs_promises.default.readFile(resolved, "utf8");
+}
+async function writeFileForClient(filePath, content) {
+	if (!filePath || typeof filePath !== "string") throw new Error("Missing file path for write.");
+	const resolved = await resolveSourcePath(filePath);
+	await node_fs_promises.default.writeFile(resolved, content ?? "");
+}
+async function getTokenSnapshot() {
+	await require_api_server.createApi(await require_api_config.loadConfig());
+	return {
+		tokens: require_use_token_server.getTokens() || {},
+		propGroups: Array.from(require_use_token_server.propMap.entries()).reduce((acc, [group, values]) => {
+			acc[group] = Array.from(values);
+			return acc;
+		}, {})
+	};
+}
+async function getBossTypes() {
+	const config = await require_api_config.loadConfig();
+	const baseDir = process.cwd();
+	const typesPath = node_path.default.join(baseDir, config.configDir ?? ".bo$$", "index.d.ts");
+	if (!await fileExists(typesPath)) return null;
+	return node_fs_promises.default.readFile(typesPath, "utf8");
+}
+async function inspectSelection(source) {
+	const { code, offset, filePath, lineNumber, columnNumber, lineRange } = await readSourceFile(source);
+	const tag = findBossTagAtOffset(code, offset, lineRange);
+	if (!tag) throw new Error(`Unable to find <$$> element in ${filePath}:${lineNumber}:${columnNumber}`);
+	return buildPropEntries(tag, code).entries;
+}
+async function applyEdit(message) {
+	const { source, path: propPath, value: rawValue, kind } = message;
+	const { code, offset, filePath, lineNumber, columnNumber, lineRange } = await readSourceFile(source);
+	const tag = findBossTagAtOffset(code, offset, lineRange);
+	if (!tag) throw new Error(`Unable to find <$$> element in ${filePath}:${lineNumber}:${columnNumber}`);
+	const { index } = buildPropEntries(tag, code);
+	const target = index.get(propPath.join("."));
+	if (!target) throw new Error(`Unable to find prop "${propPath.join(".")}" for edit.`);
+	const parsedValue = parseValue(rawValue, kind);
+	const replacement = formatValue(parsedValue, kind, target.meta);
+	let start = 0;
+	let end = 0;
+	if (target.range) {
+		start = target.range.start;
+		end = target.range.end;
+	} else if (target.attrRange) {
+		start = target.attrRange.start;
+		end = target.attrRange.end;
+		const nextAttr = `${target.attrName ?? propPath[0] ?? "prop"}${kind === "boolean" && parsedValue === true ? "" : `={${replacement}}`}`;
+		const updated$1 = replaceText(code, start, end, nextAttr);
+		await node_fs_promises.default.writeFile(filePath, updated$1);
+		return;
+	}
+	const updated = replaceText(code, start, end, replacement);
+	await node_fs_promises.default.writeFile(filePath, updated);
+}
+async function applyAddProp(message) {
+	const { source, path: propPath, value: rawValue, kind } = message;
+	if (!propPath?.length) throw new Error("Missing prop path for add.");
+	if (propPath.length > 1) throw new Error("Nested prop insertion is not supported yet.");
+	const { code, offset, filePath, lineNumber, columnNumber, lineRange } = await readSourceFile(source);
+	const tag = findBossTagAtOffset(code, offset, lineRange);
+	if (!tag) throw new Error(`Unable to find <$$> element in ${filePath}:${lineNumber}:${columnNumber}`);
+	const { index } = buildPropEntries(tag, code);
+	const propKey = propPath.join(".");
+	if (index.get(propKey)) {
+		await applyEdit({
+			...message,
+			type: "edit"
+		});
+		return;
+	}
+	const parsedValue = parseValue(rawValue, kind);
+	const replacement = formatValue(parsedValue, kind);
+	const attrName = propPath[0];
+	const attrText = formatAttribute(attrName, parsedValue, kind, replacement);
+	const insertAt = code[tag.end - 2] === "/" ? tag.end - 2 : tag.end - 1;
+	const updated = replaceText(code, insertAt, insertAt, `${insertAt > 0 && !/\s/.test(code[insertAt - 1]) ? " " : ""}${attrText}`);
+	await node_fs_promises.default.writeFile(filePath, updated);
+}
+async function readSourceFile(source) {
+	if (!source?.fileName) throw new Error("Missing source file name for selection.");
+	const resolvedPath = await resolveSourcePath(source.fileName);
+	const lineNumber = Number.isFinite(source.lineNumber) ? Math.max(1, source.lineNumber) : 1;
+	const columnNumber = Number.isFinite(source.columnNumber) ? Math.max(1, source.columnNumber) : 1;
+	const code = await node_fs_promises.default.readFile(resolvedPath, "utf8");
+	const lineOffsets = buildLineOffsets(code);
+	return {
+		code,
+		filePath: resolvedPath,
+		offset: offsetFromLineColumn(lineNumber, columnNumber - 1, lineOffsets),
+		lineRange: getLineRange(lineNumber, lineOffsets, code.length),
+		lineNumber,
+		columnNumber
+	};
+}
+const decodePath = (value) => {
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		return value;
+	}
+};
+const isExplicitSource = (value) => {
+	return value.startsWith("file://") || value.startsWith("webpack://") || value.startsWith("webpack-internal://") || value.startsWith("http://") || value.startsWith("https://") || value.startsWith("[project]/") || node_path.default.isAbsolute(value);
+};
+const normalizeWebpackPath = (value) => {
+	let cleaned = value.replace(/^webpack-internal:\/\//, "").replace(/^webpack:\/\//, "");
+	cleaned = cleaned.replace(/^_N_E\//, "");
+	cleaned = cleaned.replace(/^\.\//, "");
+	cleaned = cleaned.replace(/^\/+/, "");
+	return decodePath(cleaned);
+};
+const stripQueryHash = (value) => value.split("?")[0].split("#")[0];
+const resolveSourcePath = async (fileName, sourceRoot) => {
+	let candidate = stripQueryHash(fileName);
+	if (sourceRoot && !isExplicitSource(candidate)) {
+		let root = sourceRoot;
+		if (root.startsWith("file://")) root = (0, node_url.fileURLToPath)(root);
+		else if (root.startsWith("webpack://")) root = normalizeWebpackPath(root);
+		else if (root.startsWith("[project]/")) root = root.slice(10);
+		candidate = node_path.default.join(root, candidate);
+	}
+	if (candidate.startsWith("file://")) return (0, node_url.fileURLToPath)(candidate);
+	if (candidate.startsWith("http://") || candidate.startsWith("https://")) try {
+		const trimmed = decodePath(new URL(candidate).pathname).replace(/^\/+/, "");
+		return await findExistingPath(trimmed) ?? node_path.default.resolve(trimmed);
+	} catch {
+		return node_path.default.resolve(candidate);
+	}
+	if (candidate.startsWith("webpack://")) {
+		const cleaned = normalizeWebpackPath(candidate);
+		return await findExistingPath(cleaned) ?? node_path.default.resolve(cleaned);
+	}
+	if (candidate.startsWith("webpack-internal://")) {
+		const cleaned = normalizeWebpackPath(candidate);
+		return await findExistingPath(cleaned) ?? node_path.default.resolve(cleaned);
+	}
+	if (candidate.startsWith("[project]/")) {
+		const cleaned = decodePath(candidate.slice(10));
+		return await findExistingPath(cleaned) ?? node_path.default.resolve(cleaned);
+	}
+	if (node_path.default.isAbsolute(candidate)) return candidate;
+	return await findExistingPath(candidate) ?? node_path.default.resolve(candidate);
+};
+const findExistingPath = async (relativePath) => {
+	let current = process.cwd();
+	for (let i = 0; i < 8; i++) {
+		const candidate = node_path.default.resolve(current, relativePath);
+		if (await fileExists(candidate)) return candidate;
+		const parent = node_path.default.dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+	return null;
+};
+const fileExists = async (filePath) => {
+	try {
+		await node_fs_promises.default.access(filePath);
+		return true;
+	} catch {
+		return false;
+	}
+};
+const buildLineOffsets = (code) => {
+	const offsets = [0];
+	for (let i = 0; i < code.length; i++) if (code[i] === "\n") offsets.push(i + 1);
+	return offsets;
+};
+const offsetFromLineColumn = (lineNumber, columnNumber, offsets) => {
+	return (offsets[Math.max(0, lineNumber - 1)] ?? offsets[offsets.length - 1] ?? 0) + Math.max(0, columnNumber);
+};
+const getLineRange = (lineNumber, offsets, codeLength) => {
+	const lineIndex = Math.max(0, lineNumber - 1);
+	return {
+		start: offsets[lineIndex] ?? 0,
+		end: offsets[lineIndex + 1] ?? codeLength
+	};
+};
+const findBossTagAtOffset = (code, offset, lineRange) => {
+	const startIndex = Math.min(Math.max(offset, 0), code.length);
+	const minIndex = 0;
+	for (let i = startIndex; i >= minIndex; i--) {
+		if (code[i] !== "<") continue;
+		const next = code[i + 1];
+		if (next === "/" || next == null) continue;
+		if (!code.startsWith("$$", i + 1)) continue;
+		const tag = parseBossTag(code, i);
+		if (!tag) continue;
+		if (offset >= tag.start && offset <= tag.end) return tag;
+		if (lineRange && tag.start <= lineRange.end && tag.end >= lineRange.start) return tag;
+	}
+	return null;
+};
+const parseBossTag = (code, start) => {
+	let i = start + 1;
+	if (!code.startsWith("$$", i)) return null;
+	i += 2;
+	while (i < code.length && isTagNameChar(code[i])) i++;
+	const attrs = [];
+	while (i < code.length) {
+		i = skipWhitespace(code, i);
+		if (code[i] === "/" && code[i + 1] === ">") return {
+			start,
+			end: i + 2,
+			attrs
+		};
+		if (code[i] === ">") return {
+			start,
+			end: i + 1,
+			attrs
+		};
+		if (code[i] === "{" && code.slice(i, i + 4) === "{...") {
+			const end = findMatchingBrace(code, i);
+			if (end === -1) return null;
+			i = end + 1;
+			continue;
+		}
+		const nameStart = i;
+		while (i < code.length && isAttrNameChar(code[i])) i++;
+		if (i === nameStart) return null;
+		const name = code.slice(nameStart, i);
+		let attrRange = {
+			start: nameStart,
+			end: i
+		};
+		i = skipWhitespace(code, i);
+		let value = null;
+		if (code[i] === "=") {
+			i += 1;
+			i = skipWhitespace(code, i);
+			const valueStart = i;
+			if (code[i] === "\"" || code[i] === "'") {
+				const parsed = parseStringLiteral(code, i);
+				if (!parsed) return null;
+				value = parsed.node;
+				i = parsed.next;
+			} else if (code[i] === "{") {
+				const end = findMatchingBrace(code, i);
+				if (end === -1) return null;
+				value = parseExpression(code, i + 1, end);
+				i = end + 1;
+			} else {
+				const end = findAttributeValueEnd(code, i);
+				value = {
+					kind: "unknown",
+					range: {
+						start: valueStart,
+						end
+					},
+					code: code.slice(valueStart, end)
+				};
+				i = end;
+			}
+			attrRange = {
+				start: nameStart,
+				end: i
+			};
+		}
+		attrs.push({
+			name,
+			value,
+			range: attrRange
+		});
+	}
+	return null;
+};
+const isTagNameChar = (char) => /[A-Za-z0-9_$.\-]/.test(char);
+const isAttrNameChar = (char) => /[A-Za-z0-9_$:\-]/.test(char);
+const skipWhitespace = (code, index) => {
+	let i = index;
+	while (i < code.length && /\s/.test(code[i])) i++;
+	return i;
+};
+const findAttributeValueEnd = (code, index) => {
+	let i = index;
+	while (i < code.length && !/\s/.test(code[i]) && code[i] !== ">" && code[i] !== "/") i++;
+	return i;
+};
+const findMatchingBrace = (code, start) => {
+	let depth = 0;
+	let quote = null;
+	for (let i = start; i < code.length; i++) {
+		const char = code[i];
+		if (quote) {
+			if (char === "\\") {
+				i += 1;
+				continue;
+			}
+			if (char === quote) quote = null;
+			continue;
+		}
+		if (char === "\"" || char === "'" || char === "`") {
+			quote = char;
+			continue;
+		}
+		if (char === "{") depth += 1;
+		if (char === "}") {
+			depth -= 1;
+			if (depth === 0) return i;
+		}
+	}
+	return -1;
+};
+const parseStringLiteral = (code, start) => {
+	const quote = code[start];
+	let i = start + 1;
+	let value = "";
+	while (i < code.length) {
+		const char = code[i];
+		if (char === "\\") {
+			const next = code[i + 1];
+			if (next) {
+				value += next;
+				i += 2;
+				continue;
+			}
+		}
+		if (char === quote) {
+			const end = i + 1;
+			return {
+				node: {
+					kind: "string",
+					value,
+					range: {
+						start,
+						end
+					},
+					quote
+				},
+				next: end
+			};
+		}
+		value += char;
+		i += 1;
+	}
+	return null;
+};
+const parseExpression = (code, start, end) => {
+	const parser = new ExpressionParser(code, start, end);
+	const node = parser.parseValue();
+	parser.skipWhitespace();
+	if (!node || parser.index < end) return {
+		kind: "unknown",
+		range: {
+			start,
+			end
+		},
+		code: code.slice(start, end)
+	};
+	return node;
+};
+var ExpressionParser = class {
+	code;
+	index;
+	end;
+	constructor(code, start, end) {
+		this.code = code;
+		this.index = start;
+		this.end = end;
+	}
+	skipWhitespace() {
+		this.index = skipWhitespace(this.code, this.index);
+	}
+	parseValue() {
+		this.skipWhitespace();
+		if (this.index >= this.end) return null;
+		const char = this.code[this.index];
+		if (char === "\"" || char === "'") {
+			const parsed = parseStringLiteral(this.code, this.index);
+			if (!parsed || parsed.next > this.end) return null;
+			this.index = parsed.next;
+			return parsed.node;
+		}
+		if (char === "[") return this.parseArray();
+		if (char === "{") return this.parseObject();
+		if (char === "-" || /\d/.test(char)) return this.parseNumber();
+		if (this.code.startsWith("true", this.index)) {
+			const range = {
+				start: this.index,
+				end: this.index + 4
+			};
+			this.index += 4;
+			return {
+				kind: "boolean",
+				value: true,
+				range
+			};
+		}
+		if (this.code.startsWith("false", this.index)) {
+			const range = {
+				start: this.index,
+				end: this.index + 5
+			};
+			this.index += 5;
+			return {
+				kind: "boolean",
+				value: false,
+				range
+			};
+		}
+		return null;
+	}
+	parseNumber() {
+		const start = this.index;
+		let i = this.index;
+		if (this.code[i] === "-") i++;
+		while (i < this.end && /\d/.test(this.code[i])) i++;
+		if (i < this.end && this.code[i] === ".") {
+			i++;
+			while (i < this.end && /\d/.test(this.code[i])) i++;
+		}
+		const raw = this.code.slice(start, i);
+		const value = Number(raw);
+		if (Number.isNaN(value)) return null;
+		this.index = i;
+		return {
+			kind: "number",
+			value,
+			range: {
+				start,
+				end: i
+			}
+		};
+	}
+	parseArray() {
+		const start = this.index;
+		this.index += 1;
+		const values = [];
+		while (this.index < this.end) {
+			this.skipWhitespace();
+			if (this.code[this.index] === "]") {
+				const end = this.index + 1;
+				this.index = end;
+				return {
+					kind: "array",
+					value: values,
+					range: {
+						start,
+						end
+					}
+				};
+			}
+			const value = this.parseValue();
+			if (!value) return null;
+			values.push(value);
+			this.skipWhitespace();
+			if (this.code[this.index] === ",") {
+				this.index += 1;
+				continue;
+			}
+			if (this.code[this.index] === "]") continue;
+			return null;
+		}
+		return null;
+	}
+	parseObject() {
+		const start = this.index;
+		this.index += 1;
+		const value = {};
+		while (this.index < this.end) {
+			this.skipWhitespace();
+			if (this.code[this.index] === "}") {
+				const end = this.index + 1;
+				this.index = end;
+				return {
+					kind: "object",
+					value,
+					range: {
+						start,
+						end
+					}
+				};
+			}
+			const key = this.parseObjectKey();
+			if (!key) return null;
+			this.skipWhitespace();
+			if (this.code[this.index] !== ":") return null;
+			this.index += 1;
+			const val = this.parseValue();
+			if (!val) return null;
+			value[key] = val;
+			this.skipWhitespace();
+			if (this.code[this.index] === ",") {
+				this.index += 1;
+				continue;
+			}
+			if (this.code[this.index] === "}") continue;
+			return null;
+		}
+		return null;
+	}
+	parseObjectKey() {
+		this.skipWhitespace();
+		const char = this.code[this.index];
+		if (char === "\"" || char === "'") {
+			const parsed = parseStringLiteral(this.code, this.index);
+			if (!parsed || parsed.next > this.end) return null;
+			this.index = parsed.next;
+			return parsed.node.value;
+		}
+		const start = this.index;
+		if (!/[A-Za-z_$]/.test(char)) return null;
+		let i = this.index + 1;
+		while (i < this.end && /[A-Za-z0-9_$]/.test(this.code[i])) i++;
+		this.index = i;
+		return this.code.slice(start, i);
+	}
+};
+const buildPropEntries = (tag, code) => {
+	const entries = [];
+	const index = /* @__PURE__ */ new Map();
+	for (const attr of tag.attrs) {
+		if (!attr.value) {
+			entries.push({
+				path: [attr.name],
+				value: true,
+				editable: true,
+				kind: "boolean"
+			});
+			index.set(attr.name, {
+				attrName: attr.name,
+				attrRange: attr.range,
+				kind: "boolean"
+			});
+			continue;
+		}
+		collectParsedNode(attr.value, [attr.name], attr, entries, index, code);
+	}
+	return {
+		entries,
+		index
+	};
+};
+const collectParsedNode = (node, path, attr, entries, index, code) => {
+	if (node.kind === "string") {
+		entries.push({
+			path,
+			value: node.value,
+			editable: true,
+			kind: "string"
+		});
+		index.set(path.join("."), {
+			attrName: attr.name,
+			attrRange: attr.range,
+			range: node.range,
+			kind: "string",
+			meta: { quote: node.quote }
+		});
+		return;
+	}
+	if (node.kind === "number") {
+		entries.push({
+			path,
+			value: node.value,
+			editable: true,
+			kind: "number"
+		});
+		index.set(path.join("."), {
+			attrName: attr.name,
+			attrRange: attr.range,
+			range: node.range,
+			kind: "number"
+		});
+		return;
+	}
+	if (node.kind === "boolean") {
+		entries.push({
+			path,
+			value: node.value,
+			editable: true,
+			kind: "boolean"
+		});
+		index.set(path.join("."), {
+			attrName: attr.name,
+			attrRange: attr.range,
+			range: node.range,
+			kind: "boolean"
+		});
+		return;
+	}
+	if (node.kind === "array") {
+		if (node.value.every(isPrimitiveNode)) {
+			entries.push({
+				path,
+				value: node.value.map((item) => item.value),
+				editable: true,
+				kind: "array"
+			});
+			index.set(path.join("."), {
+				attrName: attr.name,
+				attrRange: attr.range,
+				range: node.range,
+				kind: "array"
+			});
+		} else entries.push({
+			path,
+			value: null,
+			editable: false,
+			kind: "expression",
+			code: codeFromRange(code, node.range)
+		});
+		return;
+	}
+	if (node.kind === "object") {
+		for (const [key, value] of Object.entries(node.value)) collectParsedNode(value, [...path, key], attr, entries, index, code);
+		return;
+	}
+	entries.push({
+		path,
+		value: null,
+		editable: false,
+		kind: "expression",
+		code: node.code
+	});
+};
+const isPrimitiveNode = (node) => node.kind === "string" || node.kind === "number" || node.kind === "boolean";
+const codeFromRange = (code, range) => {
+	return code.slice(range.start, range.end);
+};
+const parseValue = (rawValue, kind) => {
+	if (kind === "number") {
+		const num = typeof rawValue === "number" ? rawValue : Number(rawValue);
+		if (Number.isNaN(num)) throw new Error("Invalid number value.");
+		return num;
+	}
+	if (kind === "boolean") {
+		if (typeof rawValue === "boolean") return rawValue;
+		if (rawValue === "true") return true;
+		if (rawValue === "false") return false;
+		throw new Error("Invalid boolean value.");
+	}
+	if (kind === "array") {
+		if (Array.isArray(rawValue)) return rawValue;
+		if (typeof rawValue === "string") {
+			const parsed = JSON.parse(rawValue);
+			if (!Array.isArray(parsed)) throw new Error("Array value must be a JSON array.");
+			return parsed;
+		}
+		throw new Error("Invalid array value.");
+	}
+	if (kind === "string") return String(rawValue);
+	return rawValue;
+};
+const formatValue = (value, kind, meta) => {
+	if (kind === "string") return formatString(String(value ?? ""), meta?.quote);
+	if (kind === "number") return String(value);
+	if (kind === "boolean") return value ? "true" : "false";
+	if (kind === "array") {
+		if (!Array.isArray(value)) throw new Error("Array value must be an array.");
+		return `[${value.map(formatArrayItem).join(", ")}]`;
+	}
+	return String(value);
+};
+const formatAttribute = (name, value, kind, formattedValue) => {
+	if (kind === "boolean" && value === true) return name;
+	if (kind === "string") return `${name}=${formattedValue}`;
+	return `${name}={${formattedValue}}`;
+};
+const formatArrayItem = (value) => {
+	if (typeof value === "string") return formatString(value, "\"");
+	if (typeof value === "number") return String(value);
+	if (typeof value === "boolean") return value ? "true" : "false";
+	return "null";
+};
+const formatString = (value, quote) => {
+	const useQuote = quote ?? "\"";
+	return `${useQuote}${value.replace(/\\/g, "\\\\").replace(new RegExp(useQuote, "g"), `\\${useQuote}`).replace(/\n/g, "\\n").replace(/\r/g, "\\r")}${useQuote}`;
+};
+const replaceText = (code, start, end, replacement) => {
+	return code.slice(0, start) + replacement + code.slice(end);
+};
+
+//#endregion
+exports.startDevServer = startDevServer;