@swifttui/web 0.0.14 → 0.0.16

package/dist/src/WebHostTerminalStyle.d.ts

@@ -0,0 +1,92 @@
+//#region src/WebHostTerminalStyle.d.ts
+type WebHostTerminalCursorStyle = "block" | "bar" | "underline";
+interface WebHostANSIColors {
+  black?: string;
+  red?: string;
+  green?: string;
+  yellow?: string;
+  blue?: string;
+  magenta?: string;
+  cyan?: string;
+  white?: string;
+  brightBlack?: string;
+  brightRed?: string;
+  brightGreen?: string;
+  brightYellow?: string;
+  brightBlue?: string;
+  brightMagenta?: string;
+  brightCyan?: string;
+  brightWhite?: string;
+}
+interface WebHostTerminalPalette {
+  foreground?: string;
+  background?: string;
+  cursor?: string;
+  selectionBackground?: string;
+  selectionForeground?: string;
+  ansi?: WebHostANSIColors;
+}
+interface WebHostTerminalTheme {
+  foreground?: string;
+  background?: string;
+  tint?: string;
+  separator?: string;
+  selection?: string;
+  placeholder?: string;
+  link?: string;
+  fill?: string;
+  windowBackground?: string;
+  success?: string;
+  warning?: string;
+  danger?: string;
+  info?: string;
+  muted?: string;
+}
+interface WebHostTerminalStyle {
+  fontSize?: number;
+  fontFamily?: string;
+  cursorStyle?: WebHostTerminalCursorStyle;
+  cursorBlink?: boolean;
+  backgroundOpacity?: number;
+  palette?: WebHostTerminalPalette;
+  theme?: WebHostTerminalTheme;
+}
+interface ResolvedWebHostTerminalPalette {
+  foreground: string;
+  background: string;
+  cursor: string;
+  selectionBackground: string;
+  selectionForeground: string;
+  ansi: Required<WebHostANSIColors>;
+}
+interface ResolvedWebHostTerminalStyle {
+  fontSize: number;
+  fontFamily: string;
+  cursorStyle: WebHostTerminalCursorStyle;
+  cursorBlink: boolean;
+  backgroundOpacity: number;
+  palette: ResolvedWebHostTerminalPalette;
+  theme: Required<WebHostTerminalTheme>;
+}
+interface WebHostTerminalRenderStyle {
+  appearance: WebHostTerminalAppearance;
+  theme?: WebHostTerminalTheme;
+}
+interface WebHostTerminalAppearance {
+  foregroundColor: string;
+  backgroundColor: string;
+  tintColor: string;
+  palette: Record<string, string>;
+  colorSchemeContrast: "standard" | "increased";
+  source: "activeQuery" | "environmentHeuristics" | "fallback" | "override";
+}
+declare function normalizeWebHostTerminalStyle(style?: WebHostTerminalStyle): ResolvedWebHostTerminalStyle;
+declare function mergeWebHostTerminalStyle(base: WebHostTerminalStyle, patch: WebHostTerminalStyle): ResolvedWebHostTerminalStyle;
+declare function resolveWebHostTerminalRenderStyle(style: WebHostTerminalStyle): WebHostTerminalRenderStyle;
+declare function encodeWebHostTerminalRenderStyleBase64(style: WebHostTerminalStyle): string;
+declare function decodeWebHostTerminalRenderStyleBase64(encoded: string): WebHostTerminalRenderStyle | undefined;
+declare function webTUITerminalBackgroundColor(style: WebHostTerminalStyle): string;
+declare function applyWebHostTerminalStyle(element: HTMLElement, style: WebHostTerminalStyle): void;
+//#endregion
+export { ResolvedWebHostTerminalPalette, ResolvedWebHostTerminalStyle, WebHostANSIColors, WebHostTerminalAppearance, WebHostTerminalCursorStyle, WebHostTerminalPalette, WebHostTerminalRenderStyle, WebHostTerminalStyle, WebHostTerminalTheme, applyWebHostTerminalStyle, decodeWebHostTerminalRenderStyleBase64, encodeWebHostTerminalRenderStyleBase64, mergeWebHostTerminalStyle, normalizeWebHostTerminalStyle, resolveWebHostTerminalRenderStyle, webTUITerminalBackgroundColor };
+//# sourceMappingURL=WebHostTerminalStyle.d.ts.map

package/dist/src/WebHostTerminalStyle.js

@@ -0,0 +1,277 @@
+//#region src/WebHostTerminalStyle.ts
+const defaultFontFamily = "\"SFMono-Regular\", \"SF Mono\", \"Menlo\", \"Monaco\", \"Consolas\", \"Liberation Mono\", monospace";
+const defaultPalette = {
+	foreground: "#eceff4",
+	background: "#1e222a",
+	cursor: "#56b6c2",
+	selectionBackground: "#2e3440",
+	selectionForeground: "#eceff4",
+	ansi: {
+		black: "#20242c",
+		red: "#e05757",
+		green: "#61c67b",
+		yellow: "#ebb33c",
+		blue: "#5ba3ff",
+		magenta: "#b46eff",
+		cyan: "#56b6c2",
+		white: "#eceff4",
+		brightBlack: "#8c92ac",
+		brightRed: "#ff7b72",
+		brightGreen: "#7ee787",
+		brightYellow: "#f2cc60",
+		brightBlue: "#79c0ff",
+		brightMagenta: "#d2a8ff",
+		brightCyan: "#7de2d1",
+		brightWhite: "#ffffff"
+	}
+};
+const defaultTheme = {
+	foreground: "#eceff4",
+	background: "#1e222a",
+	tint: "#56b6c2",
+	separator: "#4c566a",
+	selection: "#2e3440",
+	placeholder: "#8c92ac",
+	link: "#5ba3ff",
+	fill: "#2b303b",
+	windowBackground: "#15181e",
+	success: "#61c67b",
+	warning: "#ebb33c",
+	danger: "#e05757",
+	info: "#56b6c2",
+	muted: "#8c92ac"
+};
+function normalizeWebHostTerminalStyle(style = {}) {
+	const palette = normalizePalette(style.palette, defaultPalette);
+	const theme = normalizeTheme(style.theme, palette, defaultTheme);
+	return {
+		fontSize: normalizeFontSize(style.fontSize ?? 14),
+		fontFamily: style.fontFamily ?? defaultFontFamily,
+		cursorStyle: style.cursorStyle ?? "block",
+		cursorBlink: style.cursorBlink ?? false,
+		backgroundOpacity: normalizeOpacity(style.backgroundOpacity ?? 1),
+		palette,
+		theme
+	};
+}
+function mergeWebHostTerminalStyle(base, patch) {
+	const resolvedBase = normalizeWebHostTerminalStyle(base);
+	return normalizeWebHostTerminalStyle({
+		...resolvedBase,
+		...patch,
+		palette: mergePalette(resolvedBase.palette, patch.palette),
+		theme: patch.theme ? {
+			...resolvedBase.theme,
+			...patch.theme
+		} : resolvedBase.theme
+	});
+}
+function resolveWebHostTerminalRenderStyle(style) {
+	const normalized = normalizeWebHostTerminalStyle(style);
+	return {
+		appearance: {
+			foregroundColor: normalized.theme.foreground,
+			backgroundColor: normalized.theme.background,
+			tintColor: normalized.theme.tint,
+			palette: paletteToIndexedMap(normalized.palette.ansi),
+			colorSchemeContrast: contrastRatio(normalized.theme.foreground, normalized.theme.background) >= 7 ? "increased" : "standard",
+			source: "override"
+		},
+		theme: { ...normalized.theme }
+	};
+}
+function encodeWebHostTerminalRenderStyleBase64(style) {
+	return encodeBase64(JSON.stringify(resolveWebHostTerminalRenderStyle(style)));
+}
+function decodeWebHostTerminalRenderStyleBase64(encoded) {
+	const json = decodeBase64(encoded);
+	if (!json) return;
+	try {
+		return JSON.parse(json);
+	} catch {
+		return;
+	}
+}
+function webTUITerminalBackgroundColor(style) {
+	const normalized = normalizeWebHostTerminalStyle(style);
+	return hexToRgba(normalized.theme.background, normalized.backgroundOpacity);
+}
+function applyWebHostTerminalStyle(element, style) {
+	const normalized = normalizeWebHostTerminalStyle(style);
+	element.style.fontFamily = normalized.fontFamily;
+	element.style.fontSize = `${normalized.fontSize}px`;
+	element.style.background = hexToRgba(normalized.theme.background, normalized.backgroundOpacity);
+	element.style.color = normalized.theme.foreground;
+}
+function normalizePalette(input, defaults) {
+	return {
+		foreground: normalizeHexColor(input?.foreground ?? defaults.foreground),
+		background: normalizeHexColor(input?.background ?? defaults.background),
+		cursor: normalizeHexColor(input?.cursor ?? defaults.cursor),
+		selectionBackground: normalizeHexColor(input?.selectionBackground ?? defaults.selectionBackground),
+		selectionForeground: normalizeHexColor(input?.selectionForeground ?? defaults.selectionForeground),
+		ansi: normalizeANSI(input?.ansi, defaults.ansi)
+	};
+}
+function mergePalette(base, patch) {
+	if (!patch) return base;
+	return {
+		...base,
+		...patch,
+		ansi: patch.ansi ? {
+			...base.ansi,
+			...patch.ansi
+		} : base.ansi
+	};
+}
+function normalizeANSI(input, defaults) {
+	return {
+		black: normalizeHexColor(input?.black ?? defaults.black),
+		red: normalizeHexColor(input?.red ?? defaults.red),
+		green: normalizeHexColor(input?.green ?? defaults.green),
+		yellow: normalizeHexColor(input?.yellow ?? defaults.yellow),
+		blue: normalizeHexColor(input?.blue ?? defaults.blue),
+		magenta: normalizeHexColor(input?.magenta ?? defaults.magenta),
+		cyan: normalizeHexColor(input?.cyan ?? defaults.cyan),
+		white: normalizeHexColor(input?.white ?? defaults.white),
+		brightBlack: normalizeHexColor(input?.brightBlack ?? defaults.brightBlack),
+		brightRed: normalizeHexColor(input?.brightRed ?? defaults.brightRed),
+		brightGreen: normalizeHexColor(input?.brightGreen ?? defaults.brightGreen),
+		brightYellow: normalizeHexColor(input?.brightYellow ?? defaults.brightYellow),
+		brightBlue: normalizeHexColor(input?.brightBlue ?? defaults.brightBlue),
+		brightMagenta: normalizeHexColor(input?.brightMagenta ?? defaults.brightMagenta),
+		brightCyan: normalizeHexColor(input?.brightCyan ?? defaults.brightCyan),
+		brightWhite: normalizeHexColor(input?.brightWhite ?? defaults.brightWhite)
+	};
+}
+function normalizeTheme(input, palette, defaults) {
+	const derived = themeFromPalette(palette, defaults);
+	return {
+		foreground: normalizeHexColor(input?.foreground ?? derived.foreground),
+		background: normalizeHexColor(input?.background ?? derived.background),
+		tint: normalizeHexColor(input?.tint ?? derived.tint),
+		separator: normalizeHexColor(input?.separator ?? derived.separator),
+		selection: normalizeHexColor(input?.selection ?? derived.selection),
+		placeholder: normalizeHexColor(input?.placeholder ?? derived.placeholder),
+		link: normalizeHexColor(input?.link ?? derived.link),
+		fill: normalizeHexColor(input?.fill ?? derived.fill),
+		windowBackground: normalizeHexColor(input?.windowBackground ?? derived.windowBackground),
+		success: normalizeHexColor(input?.success ?? derived.success),
+		warning: normalizeHexColor(input?.warning ?? derived.warning),
+		danger: normalizeHexColor(input?.danger ?? derived.danger),
+		info: normalizeHexColor(input?.info ?? derived.info),
+		muted: normalizeHexColor(input?.muted ?? derived.muted)
+	};
+}
+function themeFromPalette(palette, defaults) {
+	return {
+		foreground: palette.foreground,
+		background: palette.background,
+		tint: palette.cursor,
+		separator: palette.ansi.brightBlack,
+		selection: palette.selectionBackground,
+		placeholder: palette.ansi.brightBlack,
+		link: palette.ansi.blue,
+		fill: defaults.fill,
+		windowBackground: palette.background,
+		success: palette.ansi.green,
+		warning: palette.ansi.yellow,
+		danger: palette.ansi.red,
+		info: palette.ansi.cyan,
+		muted: palette.ansi.brightBlack
+	};
+}
+function paletteToIndexedMap(ansi) {
+	return {
+		0: ansi.black,
+		1: ansi.red,
+		2: ansi.green,
+		3: ansi.yellow,
+		4: ansi.blue,
+		5: ansi.magenta,
+		6: ansi.cyan,
+		7: ansi.white,
+		8: ansi.brightBlack,
+		9: ansi.brightRed,
+		10: ansi.brightGreen,
+		11: ansi.brightYellow,
+		12: ansi.brightBlue,
+		13: ansi.brightMagenta,
+		14: ansi.brightCyan,
+		15: ansi.brightWhite
+	};
+}
+function normalizeFontSize(fontSize) {
+	return Number.isFinite(fontSize) && fontSize > 0 ? fontSize : 14;
+}
+function normalizeOpacity(opacity) {
+	if (!Number.isFinite(opacity)) return 1;
+	return Math.min(1, Math.max(0, opacity));
+}
+function normalizeHexColor(value) {
+	const trimmed = value.trim();
+	const normalized = trimmed.startsWith("#") ? trimmed : `#${trimmed}`;
+	if (!/^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(normalized)) throw new Error(`Invalid hex color: ${value}`);
+	return normalized.toLowerCase();
+}
+function hexToRgba(color, opacity) {
+	const normalized = normalizeHexColor(color);
+	const alpha = normalizeOpacity(opacity);
+	const channels = parseHexColor(normalized);
+	if (!channels) return normalized;
+	const finalAlpha = Math.round(channels.alpha * alpha * 1e3) / 1e3;
+	return `rgba(${channels.red}, ${channels.green}, ${channels.blue}, ${finalAlpha})`;
+}
+function parseHexColor(color) {
+	const hex = color.startsWith("#") ? color.slice(1) : color;
+	const normalized = hex.length === 3 || hex.length === 4 ? hex.split("").map((ch) => ch + ch).join("") : hex;
+	if (normalized.length !== 6 && normalized.length !== 8) return;
+	return {
+		red: Number.parseInt(normalized.slice(0, 2), 16),
+		green: Number.parseInt(normalized.slice(2, 4), 16),
+		blue: Number.parseInt(normalized.slice(4, 6), 16),
+		alpha: normalized.length === 8 ? Number.parseInt(normalized.slice(6, 8), 16) / 255 : 1
+	};
+}
+function contrastRatio(foreground, background) {
+	const fg = relativeLuminance(foreground);
+	const bg = relativeLuminance(background);
+	const lighter = Math.max(fg, bg);
+	const darker = Math.min(fg, bg);
+	return (lighter + .05) / (darker + .05);
+}
+function relativeLuminance(color) {
+	const channels = parseHexColor(normalizeHexColor(color));
+	if (!channels) return 0;
+	const toLinear = (channel) => {
+		const value = channel / 255;
+		return value <= .03928 ? value / 12.92 : ((value + .055) / 1.055) ** 2.4;
+	};
+	return .2126 * toLinear(channels.red) + .7152 * toLinear(channels.green) + .0722 * toLinear(channels.blue);
+}
+function encodeBase64(value) {
+	if (typeof btoa === "function") {
+		const bytes = new TextEncoder().encode(value);
+		let binary = "";
+		for (const byte of bytes) binary += String.fromCharCode(byte);
+		return btoa(binary);
+	}
+	return Buffer.from(value, "utf8").toString("base64");
+}
+function decodeBase64(value) {
+	try {
+		if (typeof atob === "function") {
+			const binary = atob(value);
+			const bytes = new Uint8Array(binary.length);
+			for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
+			return new TextDecoder().decode(bytes);
+		}
+		return Buffer.from(value, "base64").toString("utf8");
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { applyWebHostTerminalStyle, decodeWebHostTerminalRenderStyleBase64, encodeWebHostTerminalRenderStyleBase64, mergeWebHostTerminalStyle, normalizeWebHostTerminalStyle, resolveWebHostTerminalRenderStyle, webTUITerminalBackgroundColor };
+
+//# sourceMappingURL=WebHostTerminalStyle.js.map

package/dist/src/WebHostTerminalStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebHostTerminalStyle.js","names":[],"sources":["../../src/WebHostTerminalStyle.ts"],"sourcesContent":["export type WebHostTerminalCursorStyle = \"block\" | \"bar\" | \"underline\";\n\nexport interface WebHostANSIColors {\n  black?: string;\n  red?: string;\n  green?: string;\n  yellow?: string;\n  blue?: string;\n  magenta?: string;\n  cyan?: string;\n  white?: string;\n  brightBlack?: string;\n  brightRed?: string;\n  brightGreen?: string;\n  brightYellow?: string;\n  brightBlue?: string;\n  brightMagenta?: string;\n  brightCyan?: string;\n  brightWhite?: string;\n}\n\nexport interface WebHostTerminalPalette {\n  foreground?: string;\n  background?: string;\n  cursor?: string;\n  selectionBackground?: string;\n  selectionForeground?: string;\n  ansi?: WebHostANSIColors;\n}\n\nexport interface WebHostTerminalTheme {\n  foreground?: string;\n  background?: string;\n  tint?: string;\n  separator?: string;\n  selection?: string;\n  placeholder?: string;\n  link?: string;\n  fill?: string;\n  windowBackground?: string;\n  success?: string;\n  warning?: string;\n  danger?: string;\n  info?: string;\n  muted?: string;\n}\n\nexport interface WebHostTerminalStyle {\n  fontSize?: number;\n  fontFamily?: string;\n  cursorStyle?: WebHostTerminalCursorStyle;\n  cursorBlink?: boolean;\n  backgroundOpacity?: number;\n  palette?: WebHostTerminalPalette;\n  theme?: WebHostTerminalTheme;\n}\n\nexport interface ResolvedWebHostTerminalPalette {\n  foreground: string;\n  background: string;\n  cursor: string;\n  selectionBackground: string;\n  selectionForeground: string;\n  ansi: Required<WebHostANSIColors>;\n}\n\nexport interface ResolvedWebHostTerminalStyle {\n  fontSize: number;\n  fontFamily: string;\n  cursorStyle: WebHostTerminalCursorStyle;\n  cursorBlink: boolean;\n  backgroundOpacity: number;\n  palette: ResolvedWebHostTerminalPalette;\n  theme: Required<WebHostTerminalTheme>;\n}\n\nexport interface WebHostTerminalRenderStyle {\n  appearance: WebHostTerminalAppearance;\n  theme?: WebHostTerminalTheme;\n}\n\nexport interface WebHostTerminalAppearance {\n  foregroundColor: string;\n  backgroundColor: string;\n  tintColor: string;\n  palette: Record<string, string>;\n  colorSchemeContrast: \"standard\" | \"increased\";\n  source: \"activeQuery\" | \"environmentHeuristics\" | \"fallback\" | \"override\";\n}\n\nconst defaultFontFamily =\n  '\"SFMono-Regular\", \"SF Mono\", \"Menlo\", \"Monaco\", \"Consolas\", \"Liberation Mono\", monospace';\n\nconst defaultANSI: Required<WebHostANSIColors> = {\n  black: \"#20242c\",\n  red: \"#e05757\",\n  green: \"#61c67b\",\n  yellow: \"#ebb33c\",\n  blue: \"#5ba3ff\",\n  magenta: \"#b46eff\",\n  cyan: \"#56b6c2\",\n  white: \"#eceff4\",\n  brightBlack: \"#8c92ac\",\n  brightRed: \"#ff7b72\",\n  brightGreen: \"#7ee787\",\n  brightYellow: \"#f2cc60\",\n  brightBlue: \"#79c0ff\",\n  brightMagenta: \"#d2a8ff\",\n  brightCyan: \"#7de2d1\",\n  brightWhite: \"#ffffff\",\n};\n\nconst defaultPalette: ResolvedWebHostTerminalPalette = {\n  foreground: \"#eceff4\",\n  background: \"#1e222a\",\n  cursor: \"#56b6c2\",\n  selectionBackground: \"#2e3440\",\n  selectionForeground: \"#eceff4\",\n  ansi: defaultANSI,\n};\n\nconst defaultTheme: Required<WebHostTerminalTheme> = {\n  foreground: \"#eceff4\",\n  background: \"#1e222a\",\n  tint: \"#56b6c2\",\n  separator: \"#4c566a\",\n  selection: \"#2e3440\",\n  placeholder: \"#8c92ac\",\n  link: \"#5ba3ff\",\n  fill: \"#2b303b\",\n  windowBackground: \"#15181e\",\n  success: \"#61c67b\",\n  warning: \"#ebb33c\",\n  danger: \"#e05757\",\n  info: \"#56b6c2\",\n  muted: \"#8c92ac\",\n};\n\nexport function normalizeWebHostTerminalStyle(\n  style: WebHostTerminalStyle = {}\n): ResolvedWebHostTerminalStyle {\n  const palette = normalizePalette(style.palette, defaultPalette);\n  const theme = normalizeTheme(style.theme, palette, defaultTheme);\n  return {\n    fontSize: normalizeFontSize(style.fontSize ?? 14),\n    fontFamily: style.fontFamily ?? defaultFontFamily,\n    cursorStyle: style.cursorStyle ?? \"block\",\n    cursorBlink: style.cursorBlink ?? false,\n    backgroundOpacity: normalizeOpacity(style.backgroundOpacity ?? 1),\n    palette,\n    theme,\n  };\n}\n\nexport function mergeWebHostTerminalStyle(\n  base: WebHostTerminalStyle,\n  patch: WebHostTerminalStyle\n): ResolvedWebHostTerminalStyle {\n  const resolvedBase = normalizeWebHostTerminalStyle(base);\n  return normalizeWebHostTerminalStyle({\n    ...resolvedBase,\n    ...patch,\n    palette: mergePalette(resolvedBase.palette, patch.palette),\n    theme: patch.theme ? { ...resolvedBase.theme, ...patch.theme } : resolvedBase.theme,\n  });\n}\n\nexport function resolveWebHostTerminalRenderStyle(\n  style: WebHostTerminalStyle\n): WebHostTerminalRenderStyle {\n  const normalized = normalizeWebHostTerminalStyle(style);\n  return {\n    appearance: {\n      foregroundColor: normalized.theme.foreground,\n      backgroundColor: normalized.theme.background,\n      tintColor: normalized.theme.tint,\n      palette: paletteToIndexedMap(normalized.palette.ansi),\n      colorSchemeContrast: contrastRatio(normalized.theme.foreground, normalized.theme.background) >= 7\n        ? \"increased\"\n        : \"standard\",\n      source: \"override\",\n    },\n    theme: { ...normalized.theme },\n  };\n}\n\nexport function encodeWebHostTerminalRenderStyleBase64(\n  style: WebHostTerminalStyle\n): string {\n  return encodeBase64(JSON.stringify(resolveWebHostTerminalRenderStyle(style)));\n}\n\nexport function decodeWebHostTerminalRenderStyleBase64(\n  encoded: string\n): WebHostTerminalRenderStyle | undefined {\n  const json = decodeBase64(encoded);\n  if (!json) {\n    return undefined;\n  }\n\n  try {\n    return JSON.parse(json) as WebHostTerminalRenderStyle;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function webTUITerminalBackgroundColor(\n  style: WebHostTerminalStyle\n): string {\n  const normalized = normalizeWebHostTerminalStyle(style);\n  return hexToRgba(normalized.theme.background, normalized.backgroundOpacity);\n}\n\nexport function applyWebHostTerminalStyle(\n  element: HTMLElement,\n  style: WebHostTerminalStyle\n): void {\n  const normalized = normalizeWebHostTerminalStyle(style);\n  element.style.fontFamily = normalized.fontFamily;\n  element.style.fontSize = `${normalized.fontSize}px`;\n  element.style.background = hexToRgba(normalized.theme.background, normalized.backgroundOpacity);\n  element.style.color = normalized.theme.foreground;\n}\n\nfunction normalizePalette(\n  input: WebHostTerminalPalette | undefined,\n  defaults: ResolvedWebHostTerminalPalette\n): ResolvedWebHostTerminalPalette {\n  return {\n    foreground: normalizeHexColor(input?.foreground ?? defaults.foreground),\n    background: normalizeHexColor(input?.background ?? defaults.background),\n    cursor: normalizeHexColor(input?.cursor ?? defaults.cursor),\n    selectionBackground: normalizeHexColor(\n      input?.selectionBackground ?? defaults.selectionBackground\n    ),\n    selectionForeground: normalizeHexColor(\n      input?.selectionForeground ?? defaults.selectionForeground\n    ),\n    ansi: normalizeANSI(input?.ansi, defaults.ansi),\n  };\n}\n\nfunction mergePalette(\n  base: ResolvedWebHostTerminalPalette,\n  patch: WebHostTerminalPalette | undefined\n): WebHostTerminalPalette {\n  if (!patch) {\n    return base;\n  }\n\n  return {\n    ...base,\n    ...patch,\n    ansi: patch.ansi ? { ...base.ansi, ...patch.ansi } : base.ansi,\n  };\n}\n\nfunction normalizeANSI(\n  input: WebHostANSIColors | undefined,\n  defaults: Required<WebHostANSIColors>\n): Required<WebHostANSIColors> {\n  return {\n    black: normalizeHexColor(input?.black ?? defaults.black),\n    red: normalizeHexColor(input?.red ?? defaults.red),\n    green: normalizeHexColor(input?.green ?? defaults.green),\n    yellow: normalizeHexColor(input?.yellow ?? defaults.yellow),\n    blue: normalizeHexColor(input?.blue ?? defaults.blue),\n    magenta: normalizeHexColor(input?.magenta ?? defaults.magenta),\n    cyan: normalizeHexColor(input?.cyan ?? defaults.cyan),\n    white: normalizeHexColor(input?.white ?? defaults.white),\n    brightBlack: normalizeHexColor(input?.brightBlack ?? defaults.brightBlack),\n    brightRed: normalizeHexColor(input?.brightRed ?? defaults.brightRed),\n    brightGreen: normalizeHexColor(input?.brightGreen ?? defaults.brightGreen),\n    brightYellow: normalizeHexColor(input?.brightYellow ?? defaults.brightYellow),\n    brightBlue: normalizeHexColor(input?.brightBlue ?? defaults.brightBlue),\n    brightMagenta: normalizeHexColor(input?.brightMagenta ?? defaults.brightMagenta),\n    brightCyan: normalizeHexColor(input?.brightCyan ?? defaults.brightCyan),\n    brightWhite: normalizeHexColor(input?.brightWhite ?? defaults.brightWhite),\n  };\n}\n\nfunction normalizeTheme(\n  input: WebHostTerminalTheme | undefined,\n  palette: ResolvedWebHostTerminalPalette,\n  defaults: Required<WebHostTerminalTheme>\n): Required<WebHostTerminalTheme> {\n  const derived = themeFromPalette(palette, defaults);\n  return {\n    foreground: normalizeHexColor(input?.foreground ?? derived.foreground),\n    background: normalizeHexColor(input?.background ?? derived.background),\n    tint: normalizeHexColor(input?.tint ?? derived.tint),\n    separator: normalizeHexColor(input?.separator ?? derived.separator),\n    selection: normalizeHexColor(input?.selection ?? derived.selection),\n    placeholder: normalizeHexColor(input?.placeholder ?? derived.placeholder),\n    link: normalizeHexColor(input?.link ?? derived.link),\n    fill: normalizeHexColor(input?.fill ?? derived.fill),\n    windowBackground: normalizeHexColor(input?.windowBackground ?? derived.windowBackground),\n    success: normalizeHexColor(input?.success ?? derived.success),\n    warning: normalizeHexColor(input?.warning ?? derived.warning),\n    danger: normalizeHexColor(input?.danger ?? derived.danger),\n    info: normalizeHexColor(input?.info ?? derived.info),\n    muted: normalizeHexColor(input?.muted ?? derived.muted),\n  };\n}\n\nfunction themeFromPalette(\n  palette: ResolvedWebHostTerminalPalette,\n  defaults: Required<WebHostTerminalTheme>\n): Required<WebHostTerminalTheme> {\n  return {\n    foreground: palette.foreground,\n    background: palette.background,\n    tint: palette.cursor,\n    separator: palette.ansi.brightBlack,\n    selection: palette.selectionBackground,\n    placeholder: palette.ansi.brightBlack,\n    link: palette.ansi.blue,\n    fill: defaults.fill,\n    windowBackground: palette.background,\n    success: palette.ansi.green,\n    warning: palette.ansi.yellow,\n    danger: palette.ansi.red,\n    info: palette.ansi.cyan,\n    muted: palette.ansi.brightBlack,\n  };\n}\n\nfunction paletteToIndexedMap(\n  ansi: Required<WebHostANSIColors>\n): Record<string, string> {\n  return {\n    0: ansi.black,\n    1: ansi.red,\n    2: ansi.green,\n    3: ansi.yellow,\n    4: ansi.blue,\n    5: ansi.magenta,\n    6: ansi.cyan,\n    7: ansi.white,\n    8: ansi.brightBlack,\n    9: ansi.brightRed,\n    10: ansi.brightGreen,\n    11: ansi.brightYellow,\n    12: ansi.brightBlue,\n    13: ansi.brightMagenta,\n    14: ansi.brightCyan,\n    15: ansi.brightWhite,\n  };\n}\n\nfunction normalizeFontSize(fontSize: number): number {\n  return Number.isFinite(fontSize) && fontSize > 0 ? fontSize : 14;\n}\n\nfunction normalizeOpacity(opacity: number): number {\n  if (!Number.isFinite(opacity)) {\n    return 1;\n  }\n\n  return Math.min(1, Math.max(0, opacity));\n}\n\nfunction normalizeHexColor(value: string): string {\n  const trimmed = value.trim();\n  const normalized = trimmed.startsWith(\"#\") ? trimmed : `#${trimmed}`;\n  if (!/^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(normalized)) {\n    throw new Error(`Invalid hex color: ${value}`);\n  }\n\n  return normalized.toLowerCase();\n}\n\nfunction hexToRgba(\n  color: string,\n  opacity: number\n): string {\n  const normalized = normalizeHexColor(color);\n  const alpha = normalizeOpacity(opacity);\n  const channels = parseHexColor(normalized);\n  if (!channels) {\n    return normalized;\n  }\n\n  const finalAlpha = Math.round(channels.alpha * alpha * 1000) / 1000;\n  return `rgba(${channels.red}, ${channels.green}, ${channels.blue}, ${finalAlpha})`;\n}\n\nfunction parseHexColor(\n  color: string\n): {\n  red: number;\n  green: number;\n  blue: number;\n  alpha: number;\n} | undefined {\n  const hex = color.startsWith(\"#\") ? color.slice(1) : color;\n  const normalized = hex.length === 3 || hex.length === 4\n    ? hex.split(\"\").map((ch) => ch + ch).join(\"\")\n    : hex;\n\n  if (normalized.length !== 6 && normalized.length !== 8) {\n    return undefined;\n  }\n\n  const red = Number.parseInt(normalized.slice(0, 2), 16);\n  const green = Number.parseInt(normalized.slice(2, 4), 16);\n  const blue = Number.parseInt(normalized.slice(4, 6), 16);\n  const alpha = normalized.length === 8\n    ? Number.parseInt(normalized.slice(6, 8), 16) / 255\n    : 1;\n  return { red, green, blue, alpha };\n}\n\nfunction contrastRatio(\n  foreground: string,\n  background: string\n): number {\n  const fg = relativeLuminance(foreground);\n  const bg = relativeLuminance(background);\n  const lighter = Math.max(fg, bg);\n  const darker = Math.min(fg, bg);\n  return (lighter + 0.05) / (darker + 0.05);\n}\n\nfunction relativeLuminance(color: string): number {\n  const channels = parseHexColor(normalizeHexColor(color));\n  if (!channels) {\n    return 0;\n  }\n\n  const toLinear = (channel: number) => {\n    const value = channel / 255;\n    return value <= 0.03928\n      ? value / 12.92\n      : ((value + 0.055) / 1.055) ** 2.4;\n  };\n\n  return 0.2126 * toLinear(channels.red) + 0.7152 * toLinear(channels.green)\n    + 0.0722 * toLinear(channels.blue);\n}\n\nfunction encodeBase64(value: string): string {\n  if (typeof btoa === \"function\") {\n    const bytes = new TextEncoder().encode(value);\n    let binary = \"\";\n    for (const byte of bytes) {\n      binary += String.fromCharCode(byte);\n    }\n    return btoa(binary);\n  }\n\n  return Buffer.from(value, \"utf8\").toString(\"base64\");\n}\n\nfunction decodeBase64(value: string): string | undefined {\n  try {\n    if (typeof atob === \"function\") {\n      const binary = atob(value);\n      const bytes = new Uint8Array(binary.length);\n      for (let index = 0; index < binary.length; index += 1) {\n        bytes[index] = binary.charCodeAt(index);\n      }\n      return new TextDecoder().decode(bytes);\n    }\n\n    return Buffer.from(value, \"base64\").toString(\"utf8\");\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":"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"}

package/dist/src/WebHostTestFixtures.d.ts

@@ -0,0 +1,5 @@
+//#region src/WebHostTestFixtures.d.ts
+declare function transportFixture(basename: string): string;
+//#endregion
+export { transportFixture };
+//# sourceMappingURL=WebHostTestFixtures.d.ts.map

package/dist/src/WebHostTestFixtures.js

@@ -0,0 +1,9 @@
+import { readFileSync } from "node:fs";
+//#region src/WebHostTestFixtures.ts
+function transportFixture(basename) {
+	return readFileSync(new URL(`../../../Fixtures/Transport/${basename}.txt`, import.meta.url), "utf8").replaceAll("\\u001E", "");
+}
+//#endregion
+export { transportFixture };
+
+//# sourceMappingURL=WebHostTestFixtures.js.map

package/dist/src/WebHostTestFixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebHostTestFixtures.js","names":[],"sources":["../../src/WebHostTestFixtures.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\n\nexport function transportFixture(\n  basename: string\n): string {\n  return readFileSync(\n    new URL(`../../../Fixtures/Transport/${basename}.txt`, import.meta.url),\n    \"utf8\"\n  ).replaceAll(\"\\\\u001E\", \"\\u001E\");\n}\n"],"mappings":";;AAEA,SAAgB,iBACd,UACQ;CACR,OAAO,aACL,IAAI,IAAI,+BAA+B,SAAS,OAAO,OAAO,KAAK,GAAG,GACtE,MACF,CAAC,CAAC,WAAW,WAAW,GAAQ;AAClC"}

package/dist/src/WebSocketSceneBridge.d.ts

@@ -0,0 +1,53 @@
+import { WebHostTerminalStyle } from "./WebHostTerminalStyle.js";
+import { WebHostOutputSink } from "./WebHostSurfaceTransport.js";
+import { WebHostSceneBridge } from "./WebHostSceneRuntime.js";
+
+//#region src/WebSocketSceneBridge.d.ts
+interface WebSocketSceneBridgeOptions {
+  sceneId: string;
+  token: string;
+  baseURL?: string | URL;
+  webSocketURL?: string | URL;
+  webSocketFactory?: WebSocketSceneBridgeFactory;
+}
+type WebSocketSceneBridgeFactory = (url: string | URL) => WebSocketSceneSocket;
+interface WebSocketSceneSocket {
+  binaryType: BinaryType;
+  readonly readyState: number;
+  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;
+  close(code?: number, reason?: string): void;
+  addEventListener(type: "open", listener: (event: Event) => void): void;
+  addEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+  addEventListener(type: "close", listener: (event: CloseEvent) => void): void;
+  addEventListener(type: "error", listener: (event: Event) => void): void;
+  removeEventListener(type: "open", listener: (event: Event) => void): void;
+  removeEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+  removeEventListener(type: "close", listener: (event: CloseEvent) => void): void;
+  removeEventListener(type: "error", listener: (event: Event) => void): void;
+}
+declare class WebSocketSceneBridge implements WebHostSceneBridge {
+  readonly url: URL;
+  private readonly socket;
+  private readonly decoder;
+  private readonly queuedInput;
+  private readonly queuedOutput;
+  private sink?;
+  private disposed;
+  private readonly handleOpen;
+  private readonly handleMessage;
+  private readonly handleClose;
+  private readonly handleError;
+  constructor(options: WebSocketSceneBridgeOptions);
+  bindOutput(sink: WebHostOutputSink): void;
+  resize(columns: number, rows: number, cellWidth?: number, cellHeight?: number): void;
+  updateRenderStyle(style: WebHostTerminalStyle): void;
+  sendInput(chunk: Uint8Array): void;
+  dispose(): void;
+  private receive;
+  private deliver;
+  private flushQueuedInput;
+}
+declare function webSocketSceneURL(options: Pick<WebSocketSceneBridgeOptions, "baseURL" | "webSocketURL" | "sceneId" | "token">): URL;
+//#endregion
+export { WebSocketSceneBridge, WebSocketSceneBridgeFactory, WebSocketSceneBridgeOptions, WebSocketSceneSocket, webSocketSceneURL };
+//# sourceMappingURL=WebSocketSceneBridge.d.ts.map

package/dist/src/WebSocketSceneBridge.js

@@ -0,0 +1,124 @@
+import { WebHostOutputDecoder, encodeRenderStyleControlMessage, encodeResizeControlMessage } from "./WebHostSurfaceTransport.js";
+//#region src/WebSocketSceneBridge.ts
+const socketOpenState = 1;
+const textEncoder = new TextEncoder();
+var WebSocketSceneBridge = class {
+	url;
+	socket;
+	decoder = new WebHostOutputDecoder();
+	queuedInput = [];
+	queuedOutput = [];
+	sink;
+	disposed = false;
+	handleOpen = () => {
+		this.flushQueuedInput();
+	};
+	handleMessage = (event) => {
+		this.receive(event.data);
+	};
+	handleClose = () => {
+		for (const record of this.decoder.flush()) this.deliver(record);
+	};
+	handleError = () => {};
+	constructor(options) {
+		this.url = webSocketSceneURL(options);
+		this.socket = (options.webSocketFactory ?? defaultWebSocketFactory)(this.url);
+		this.socket.binaryType = "arraybuffer";
+		this.socket.addEventListener("open", this.handleOpen);
+		this.socket.addEventListener("message", this.handleMessage);
+		this.socket.addEventListener("close", this.handleClose);
+		this.socket.addEventListener("error", this.handleError);
+	}
+	bindOutput(sink) {
+		this.sink = sink;
+		while (this.queuedOutput.length > 0) this.deliver(this.queuedOutput.shift());
+	}
+	resize(columns, rows, cellWidth, cellHeight) {
+		this.sendInput(encodeResizeControlMessage(columns, rows, cellWidth, cellHeight));
+	}
+	updateRenderStyle(style) {
+		this.sendInput(encodeRenderStyleControlMessage(style));
+	}
+	sendInput(chunk) {
+		if (this.disposed) return;
+		const copy = new Uint8Array(chunk);
+		if (this.socket.readyState === socketOpenState) this.socket.send(copy);
+		else this.queuedInput.push(copy);
+	}
+	dispose() {
+		if (this.disposed) return;
+		this.disposed = true;
+		this.socket.removeEventListener("open", this.handleOpen);
+		this.socket.removeEventListener("message", this.handleMessage);
+		this.socket.removeEventListener("close", this.handleClose);
+		this.socket.removeEventListener("error", this.handleError);
+		this.queuedInput.length = 0;
+		this.queuedOutput.length = 0;
+		this.socket.close(1e3, "WebHost scene disposed");
+	}
+	async receive(message) {
+		if (this.disposed) return;
+		const bytes = await bytesFromWebSocketMessage(message);
+		if (!bytes) return;
+		for (const record of this.decoder.feed(bytes)) this.deliver(record);
+	}
+	deliver(record) {
+		const sink = this.sink;
+		if (!sink) {
+			this.queuedOutput.push(record);
+			return;
+		}
+		switch (record.type) {
+			case "surface":
+				sink.presentSurface(record.frame);
+				break;
+			case "clipboard":
+				sink.writeClipboard?.(record.text);
+				break;
+			case "runtimeIssue":
+				sink.notifyRuntimeIssue?.(record.issue);
+				break;
+			case "frameDiagnostic":
+				sink.recordFrameDiagnostic?.(record.diagnostic);
+				break;
+			case "text":
+				sink.writeOutput?.(record.text);
+				break;
+		}
+	}
+	flushQueuedInput() {
+		if (this.disposed || this.socket.readyState !== socketOpenState) return;
+		while (this.queuedInput.length > 0) this.socket.send(this.queuedInput.shift());
+	}
+};
+function webSocketSceneURL(options) {
+	if (options.webSocketURL) {
+		const explicit = new URL(String(options.webSocketURL), currentPageURL());
+		explicit.searchParams.set("token", options.token);
+		return explicit;
+	}
+	const url = new URL(String(options.baseURL ?? currentPageURL()), currentPageURL());
+	url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+	url.pathname = `${url.pathname.endsWith("/") ? url.pathname.slice(0, -1) : url.pathname}/ws/scene/${encodeURIComponent(options.sceneId)}`;
+	url.search = "";
+	url.searchParams.set("token", options.token);
+	return url;
+}
+async function bytesFromWebSocketMessage(message) {
+	if (typeof message === "string") return textEncoder.encode(message);
+	if (message instanceof Uint8Array) return message;
+	if (message instanceof ArrayBuffer) return new Uint8Array(message);
+	if (ArrayBuffer.isView(message)) return new Uint8Array(message.buffer, message.byteOffset, message.byteLength);
+	if (typeof Blob !== "undefined" && message instanceof Blob) return new Uint8Array(await message.arrayBuffer());
+}
+function defaultWebSocketFactory(url) {
+	if (typeof WebSocket === "undefined") throw new Error("WebSocket is not available");
+	return new WebSocket(url);
+}
+function currentPageURL() {
+	return globalThis.location?.href ?? "http://127.0.0.1/";
+}
+//#endregion
+export { WebSocketSceneBridge, webSocketSceneURL };
+
+//# sourceMappingURL=WebSocketSceneBridge.js.map

package/dist/src/WebSocketSceneBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketSceneBridge.js","names":[],"sources":["../../src/WebSocketSceneBridge.ts"],"sourcesContent":["import {\n  WebHostOutputDecoder,\n  encodeRenderStyleControlMessage,\n  encodeResizeControlMessage,\n  type WebHostOutputRecord,\n  type WebHostOutputSink,\n} from \"./WebHostSurfaceTransport.ts\";\nimport type { WebHostTerminalStyle } from \"./WebHostTerminalStyle.ts\";\nimport type { WebHostSceneBridge } from \"./WebHostSceneRuntime.ts\";\n\nexport interface WebSocketSceneBridgeOptions {\n  sceneId: string;\n  token: string;\n  baseURL?: string | URL;\n  webSocketURL?: string | URL;\n  webSocketFactory?: WebSocketSceneBridgeFactory;\n}\n\nexport type WebSocketSceneBridgeFactory = (url: string | URL) => WebSocketSceneSocket;\n\nexport interface WebSocketSceneSocket {\n  binaryType: BinaryType;\n  readonly readyState: number;\n  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;\n  close(code?: number, reason?: string): void;\n  addEventListener(type: \"open\", listener: (event: Event) => void): void;\n  addEventListener(type: \"message\", listener: (event: MessageEvent) => void): void;\n  addEventListener(type: \"close\", listener: (event: CloseEvent) => void): void;\n  addEventListener(type: \"error\", listener: (event: Event) => void): void;\n  removeEventListener(type: \"open\", listener: (event: Event) => void): void;\n  removeEventListener(type: \"message\", listener: (event: MessageEvent) => void): void;\n  removeEventListener(type: \"close\", listener: (event: CloseEvent) => void): void;\n  removeEventListener(type: \"error\", listener: (event: Event) => void): void;\n}\n\nconst socketOpenState = 1;\nconst textEncoder = new TextEncoder();\n\nexport class WebSocketSceneBridge implements WebHostSceneBridge {\n  readonly url: URL;\n\n  private readonly socket: WebSocketSceneSocket;\n  private readonly decoder = new WebHostOutputDecoder();\n  private readonly queuedInput: Uint8Array[] = [];\n  private readonly queuedOutput: WebHostOutputRecord[] = [];\n  private sink?: WebHostOutputSink;\n  private disposed = false;\n\n  private readonly handleOpen = () => {\n    this.flushQueuedInput();\n  };\n\n  private readonly handleMessage = (event: MessageEvent) => {\n    void this.receive(event.data);\n  };\n\n  private readonly handleClose = () => {\n    for (const record of this.decoder.flush()) {\n      this.deliver(record);\n    }\n  };\n\n  private readonly handleError = () => {};\n\n  constructor(options: WebSocketSceneBridgeOptions) {\n    this.url = webSocketSceneURL(options);\n    this.socket = (options.webSocketFactory ?? defaultWebSocketFactory)(this.url);\n    this.socket.binaryType = \"arraybuffer\";\n    this.socket.addEventListener(\"open\", this.handleOpen);\n    this.socket.addEventListener(\"message\", this.handleMessage);\n    this.socket.addEventListener(\"close\", this.handleClose);\n    this.socket.addEventListener(\"error\", this.handleError);\n  }\n\n  bindOutput(\n    sink: WebHostOutputSink\n  ): void {\n    this.sink = sink;\n    while (this.queuedOutput.length > 0) {\n      this.deliver(this.queuedOutput.shift()!);\n    }\n  }\n\n  resize(\n    columns: number,\n    rows: number,\n    cellWidth?: number,\n    cellHeight?: number\n  ): void {\n    this.sendInput(encodeResizeControlMessage(columns, rows, cellWidth, cellHeight));\n  }\n\n  updateRenderStyle(\n    style: WebHostTerminalStyle\n  ): void {\n    this.sendInput(encodeRenderStyleControlMessage(style));\n  }\n\n  sendInput(\n    chunk: Uint8Array\n  ): void {\n    if (this.disposed) {\n      return;\n    }\n\n    const copy = new Uint8Array(chunk);\n    if (this.socket.readyState === socketOpenState) {\n      this.socket.send(copy);\n    } else {\n      this.queuedInput.push(copy);\n    }\n  }\n\n  dispose(): void {\n    if (this.disposed) {\n      return;\n    }\n    this.disposed = true;\n    this.socket.removeEventListener(\"open\", this.handleOpen);\n    this.socket.removeEventListener(\"message\", this.handleMessage);\n    this.socket.removeEventListener(\"close\", this.handleClose);\n    this.socket.removeEventListener(\"error\", this.handleError);\n    this.queuedInput.length = 0;\n    this.queuedOutput.length = 0;\n    this.socket.close(1000, \"WebHost scene disposed\");\n  }\n\n  private async receive(\n    message: unknown\n  ): Promise<void> {\n    if (this.disposed) {\n      return;\n    }\n\n    const bytes = await bytesFromWebSocketMessage(message);\n    if (!bytes) {\n      return;\n    }\n\n    for (const record of this.decoder.feed(bytes)) {\n      this.deliver(record);\n    }\n  }\n\n  private deliver(\n    record: WebHostOutputRecord\n  ): void {\n    const sink = this.sink;\n    if (!sink) {\n      this.queuedOutput.push(record);\n      return;\n    }\n\n    switch (record.type) {\n    case \"surface\":\n      sink.presentSurface(record.frame);\n      break;\n    case \"clipboard\":\n      void sink.writeClipboard?.(record.text);\n      break;\n    case \"runtimeIssue\":\n      sink.notifyRuntimeIssue?.(record.issue);\n      break;\n    case \"frameDiagnostic\":\n      sink.recordFrameDiagnostic?.(record.diagnostic);\n      break;\n    case \"text\":\n      sink.writeOutput?.(record.text);\n      break;\n    }\n  }\n\n  private flushQueuedInput(): void {\n    if (this.disposed || this.socket.readyState !== socketOpenState) {\n      return;\n    }\n    while (this.queuedInput.length > 0) {\n      this.socket.send(this.queuedInput.shift()!);\n    }\n  }\n}\n\nexport function webSocketSceneURL(\n  options: Pick<WebSocketSceneBridgeOptions, \"baseURL\" | \"webSocketURL\" | \"sceneId\" | \"token\">\n): URL {\n  if (options.webSocketURL) {\n    const explicit = new URL(String(options.webSocketURL), currentPageURL());\n    explicit.searchParams.set(\"token\", options.token);\n    return explicit;\n  }\n\n  const url = new URL(String(options.baseURL ?? currentPageURL()), currentPageURL());\n  url.protocol = url.protocol === \"https:\" ? \"wss:\" : \"ws:\";\n  const basePath = url.pathname.endsWith(\"/\") ? url.pathname.slice(0, -1) : url.pathname;\n  url.pathname = `${basePath}/ws/scene/${encodeURIComponent(options.sceneId)}`;\n  url.search = \"\";\n  url.searchParams.set(\"token\", options.token);\n  return url;\n}\n\nasync function bytesFromWebSocketMessage(\n  message: unknown\n): Promise<Uint8Array | undefined> {\n  if (typeof message === \"string\") {\n    return textEncoder.encode(message);\n  }\n  if (message instanceof Uint8Array) {\n    return message;\n  }\n  if (message instanceof ArrayBuffer) {\n    return new Uint8Array(message);\n  }\n  if (ArrayBuffer.isView(message)) {\n    return new Uint8Array(message.buffer, message.byteOffset, message.byteLength);\n  }\n  if (typeof Blob !== \"undefined\" && message instanceof Blob) {\n    return new Uint8Array(await message.arrayBuffer());\n  }\n  return undefined;\n}\n\nfunction defaultWebSocketFactory(\n  url: string | URL\n): WebSocketSceneSocket {\n  if (typeof WebSocket === \"undefined\") {\n    throw new Error(\"WebSocket is not available\");\n  }\n  return new WebSocket(url) as WebSocketSceneSocket;\n}\n\nfunction currentPageURL(): string {\n  return globalThis.location?.href ?? \"http://127.0.0.1/\";\n}\n"],"mappings":"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"}