@nsnanocat/preference-panes 0.1.0 → 0.3.0

package/src/index.d.ts

@@ -0,0 +1,161 @@
+/**
+ * 设置允许的标量值，不包含 null 或对象。
+ * Supported setting scalars, excluding null and objects.
+ */
+export type SettingsScalar = string | number | boolean;
+/**
+ * 单个选择项的存储值与显示标签。
+ * Stored value and display label of a choice.
+ */
+export interface SettingsOption<T extends SettingsScalar = SettingsScalar> {
+	/** 持久化值，保留原始标量类型 / Persisted value with its original scalar type. */
+	key: T;
+	/** 纯文本选项名称 / Plain-text option label. */
+	label: string;
+}
+/**
+ * 控件共同的路径与展示属性。
+ * Shared path and presentation attributes of a control.
+ */
+interface FieldBase {
+	/** 不含存储根的点分路径，例如 Module.Settings.key / Dotted path without the storage root, such as Module.Settings.key. */
+	key: string;
+	/** 纯文本标题 / Plain-text title. */
+	name: string;
+	/** 纯文本说明 / Plain-text description. */
+	description?: string;
+	/** 原始 BoxJS 控件类型，与持久化值类型区分 / Original BoxJS control kind, separate from the stored value type. */
+	control?: "boolean" | "checkboxes" | "selects" | "text" | "textarea" | "number";
+	/** 输入占位文字 / Input placeholder. */
+	placeholder?: string;
+	/** 多行控件的基础行数，必须为正整数 / Positive baseline row count for a textarea. */
+	rows?: number;
+	/** 是否随多行内容自动调整高度 / Whether textarea height follows its contents. */
+	autoGrow?: boolean;
+}
+/**
+ * 归一化字段；默认值和选项必须符合对应 type，缺失默认值保持缺失。
+ * Normalized field; defaults and choices match type, and absent defaults stay absent.
+ */
+export type SettingsField = FieldBase &
+	(
+		| { type: "boolean"; defaultValue?: boolean; options?: SettingsOption<boolean>[] }
+		| { type: "number"; defaultValue?: number; options?: SettingsOption<number>[] }
+		| { type: "string"; defaultValue?: string; options?: SettingsOption<string>[] }
+		| { type: "array"; defaultValue?: SettingsScalar[]; options?: SettingsOption[] }
+	);
+/**
+ * 代理宿主提供的请求；保留字符串方法以便拒绝不支持的方法。
+ * Request provided by the proxy host; string methods allow unsupported methods to be rejected.
+ */
+export interface SettingsRequest {
+	/** 请求的完整 URL / Absolute request URL. */
+	url: string;
+	/** 区分大小写的 HTTP 方法 / Case-sensitive HTTP method. */
+	method: string;
+	/** 头名称在处理器中统一转为小写 / Header names are normalized to lowercase by the handler. */
+	headers?: Record<string, string | undefined>;
+	/** POST 的正文为 JSON 值本身；DELETE 无正文 / POST contains the JSON value itself; DELETE has no body. */
+	body?: string;
+}
+/**
+ * 通用 HTTP 响应，调用方负责转换为代理宿主的 done 格式。
+ * Generic HTTP response; the caller adapts it to the host's done format.
+ */
+export interface SettingsResponse {
+	/** 数字状态码 / Numeric status code. */
+	status: number;
+	/** 响应头 / Response headers. */
+	headers: Record<string, string>;
+	/** JSON 文本；HEAD 始终为空字符串 / JSON text; always an empty string for HEAD. */
+	body: string;
+}
+/**
+ * 由插件安装配置提供的固定存储映射，不接受浏览器指定存储根。
+ * Fixed storage mapping provided by plugin installation, never a browser-selected root.
+ */
+export interface SettingsHandlerOptions {
+	/** 接管 /api/ 路径的 HTTPS 来源 / HTTPS origin serving /api/ paths. */
+	origin: string;
+	/** 顶层持久化键，不能使用 @ 路径语法 / Literal top-level storage key, without @ path syntax. */
+	storageKey: string;
+	/** /api/ 后的模块段，只能访问该模块内的数据 / Module segment following /api/; access stays within this module. */
+	module: string;
+	/** 默认 X-Settings-Client，值必须为 1；不是认证凭据 / Defaults to X-Settings-Client with value 1; not an authentication credential. */
+	requestHeader?: string;
+}
+/**
+ * 属于单个模块的字段、存储根及可选展示元数据。
+ * Fields, storage root and optional display metadata belonging to one module.
+ */
+export interface ModuleDefinition {
+	/** 字段 ID 的模块段，不能由 app 名称推断 / Module segment from field IDs, never inferred from app names. */
+	module: string;
+	/** 由 @root.module.path 中的 root 提取 / Root extracted from @root.module.path. */
+	storageKey: string;
+	/** 保留配置文件中的字段顺序 / Fields in configuration order. */
+	fields: SettingsField[];
+	/** 含模块名的公共父路径片段 / Common parent path segments including the module name. */
+	settingsPath: string[];
+	/** 只有字段来自唯一 app 时提供 / Present only when all fields belong to one app. */
+	metadata?: {
+		/** 应用标识，仅用于展示或溯源 / App identifier for display or provenance only. */
+		id?: string;
+		/** 显示名称 / Display name. */
+		name?: string;
+		/** 作者纯文本 / Plain-text author. */
+		author?: string;
+		/** 项目地址；页面仅接受 HTTP(S) 或相对链接 / Project address; the page accepts only HTTP(S) or relative URLs. */
+		repo?: string;
+		/** 仅保留来源信息，不执行脚本 / Source metadata only; never executed. */
+		script?: string;
+		/** 优先使用的显式图标地址 / Explicit preferred icon URL. */
+		icon?: string;
+		/** 原版透明/彩色顺序，不是亮暗顺序 / Original transparent/color order, not light/dark order. */
+		icons?: string[];
+		/** 多段纯文本说明 / Multiple plain-text paragraphs. */
+		descs?: string[];
+		/** desc 未提供时的说明 / Description used when desc is absent. */
+		description?: string;
+		/** 优先使用的纯文本说明 / Preferred plain-text description. */
+		desc?: string;
+	};
+}
+/**
+ * 将 BoxJS 字段数组、app 或订阅解析为模块定义，不执行脚本或 HTML。
+ * Parse a BoxJS field array, app or subscription into a module definition without executing scripts or HTML.
+ * @param config 外部 JSON 数据，在运行时校验 / External JSON validated at runtime.
+ * @param module 请求路径中的模块标识 / Module identifier from the request path.
+ * @returns 字段、公共路径与元数据 / Fields, common path and metadata.
+ * @throws {TypeError} 配置格式、类型、路径或选项无效 / Invalid configuration shape, types, paths or options.
+ */
+export function normalizeBoxJs(config: unknown, module: string): ModuleDefinition;
+/**
+ * 使用 util 桥接指定模块的持久化存储，不下载或校验 BoxJS。
+ * Bridge module persistence through util without downloading or validating BoxJS.
+ */
+export class SettingsHandler {
+	/**
+	 * 创建实例，不发送请求或读取存储。
+	 * Construct an instance without network requests or storage reads.
+	 * @param options 来源、存储根与模块 / Origin, storage root and module.
+	 * @throws {TypeError} 来源、存储根、模块或头名称无效 / Invalid origin, storage root, module or header name.
+	 */
+	constructor(options: SettingsHandlerOptions);
+	/**
+	 * HEAD 不读存储；GET 返回任意指定值，POST/DELETE 对键或子树读改写一次。
+	 * HEAD avoids storage; GET returns any requested value, and POST/DELETE mutate a key or subtree in one read-modify-write.
+	 * @param request 代理请求 / Proxy request.
+	 * @returns HTTP 响应；非目标来源或非 API 路径返回 undefined / HTTP response, or undefined outside the configured API origin and path.
+	 * @throws {Error} 请求 URL 无效；存储失败以 HTTP 500 返回 / Invalid request URL; storage failures return HTTP 500.
+	 */
+	handle(request: SettingsRequest): Promise<SettingsResponse | undefined>;
+}
+/**
+ * 从完整 URL 解析 /api/ 后的 database 路径。
+ * Parse database path segments following /api/ from an absolute URL.
+ * @param url 完整请求地址 / Absolute request URL.
+ * @returns 已解码的路径片段；非 API 路径返回 undefined / Decoded segments, or undefined for non-API paths.
+ * @throws {TypeError} URL、编码或路径片段非法 / Invalid URL, encoding or path segment.
+ */
+export function parseSettingsPath(url: string): string[] | undefined;

package/src/index.mjs

@@ -0,0 +1,8 @@
+export { normalizeBoxJs } from "./lib/boxjs.mjs";
+export { parseSettingsPath } from "./lib/settings-path.mjs";
+/**
+ * 通用代理处理器与配置解析的公开入口。
+ * Public entry for the proxy handler and configuration parsing.
+ * @module @nsnanocat/preference-panes
+ */
+export { SettingsHandler } from "./SettingsHandler.mjs";

package/src/lib/boxjs.mjs

@@ -0,0 +1,141 @@
+import { validatePathParts } from "./settings-path.mjs";
+
+/**
+ * 将 BoxJS 数组、app 或订阅转换为模块字段，保留原文件为唯一字段来源。
+ * Normalize a BoxJS array, app or subscription using the source JSON as the field authority.
+ * @param {unknown} config BoxJS JSON / BoxJS document.
+ * @param {string} module API 第一段模块名 / First API path segment.
+ * @returns {import("../index.js").ModuleDefinition} 存储根和字段 / Storage root and fields.
+ * @throws {TypeError} 配置结构、字段路径、默认值或展示属性无效 / Invalid configuration, field path, default or presentation attribute.
+ */
+export function normalizeBoxJs(config, module) {
+	validatePathParts([module]);
+	const apps = Array.isArray(config) ? [] : (config?.apps ?? [config]);
+	if (!Array.isArray(apps)) throw new TypeError("Expected BoxJS apps array");
+	for (const candidate of apps) {
+		if (!candidate || typeof candidate !== "object") throw new TypeError("Expected BoxJS app object");
+		if (candidate.settings !== undefined && !Array.isArray(candidate.settings)) throw new TypeError("Expected BoxJS settings array");
+	}
+	const owners = apps.filter(candidate => candidate.settings?.some(entry => typeof entry.id === "string" && entry.id.startsWith("@") && entry.id.slice(1).split(".")[1] === module));
+	const entries = Array.isArray(config) ? config : owners.flatMap(candidate => candidate.settings);
+	const app = owners.length === 1 ? owners[0] : undefined;
+	let storageKey;
+	const fields = [];
+	for (const entry of entries) {
+		if (typeof entry.id !== "string" || !entry.id.startsWith("@")) throw new TypeError("BoxJS settings require @root.path IDs");
+		const [root, ...parts] = entry.id.slice(1).split(".");
+		if (parts[0] !== module) continue;
+		if (parts.length < 2) throw new TypeError("A BoxJS setting must be below the module root");
+		validatePathParts(parts);
+		if (!root || (storageKey && root !== storageKey)) throw new TypeError("A module must use one storage root");
+		storageKey = root;
+		const type = { boolean: "boolean", checkboxes: "array", selects: "select", text: "string", textarea: "string", number: "number" }[entry.type];
+		if (!type) throw new TypeError(`Unsupported BoxJS control: ${entry.type}`);
+		const field = {
+			key: parts.join("."),
+			type: type === "select" ? typeof entry.val : type,
+
+			name: entry.name,
+			description: entry.desc ?? "",
+			control: entry.type,
+			...(entry.placeholder === undefined ? {} : { placeholder: entry.placeholder }),
+			...(entry.rows === undefined ? {} : { rows: entry.rows }),
+			...(entry.autoGrow === undefined ? {} : { autoGrow: entry.autoGrow }),
+		};
+		if (type === "select" && !["string", "number", "boolean"].includes(field.type)) throw new TypeError(`Select requires a scalar val: ${entry.id}`);
+		if (entry.items) field.options = entry.items.map(item => ({ key: item.key, label: item.label }));
+		if (Object.hasOwn(entry, "val")) field.defaultValue = normalizeStoredValue(field, entry.val);
+		if (
+			typeof field.name !== "string" ||
+			(field.placeholder !== undefined && typeof field.placeholder !== "string") ||
+			(field.rows !== undefined && (!Number.isInteger(field.rows) || field.rows < 1)) ||
+			(field.autoGrow !== undefined && typeof field.autoGrow !== "boolean") ||
+			fields.some(other => other.key === field.key || other.key.startsWith(`${field.key}.`) || field.key.startsWith(`${other.key}.`))
+		)
+			throw new TypeError(`Invalid or overlapping BoxJS field: ${entry.id}`);
+		if (field.options && (new Set(field.options.map(item => item.key)).size !== field.options.length || field.options.some(item => !scalar(item.key) || typeof item.label !== "string"))) throw new TypeError(`Invalid options: ${entry.id}`);
+		if (Object.hasOwn(field, "defaultValue") && !validValue(field, field.defaultValue)) throw new TypeError(`Invalid BoxJS val: ${entry.id}`);
+		fields.push(field);
+	}
+	if (!fields.length) throw new TypeError(`No BoxJS settings for module: ${module}`);
+	const common = fields[0].key.split(".").slice(0, -1);
+	for (const field of fields) while (!field.key.startsWith(`${common.join(".")}.`)) common.pop();
+	const metadata = {};
+	if (app) {
+		for (const key of ["id", "name", "author", "repo", "script", "icon", "description", "desc", "icons", "descs"]) {
+			if (app[key] === undefined) continue;
+			const multiple = key === "icons" || key === "descs";
+			const values = multiple ? app[key] : [app[key]];
+			if (!Array.isArray(values) || values.some(item => typeof item !== "string")) throw new TypeError(`Invalid BoxJS app ${key}`);
+			metadata[key] = multiple ? [...values] : app[key];
+		}
+	}
+	return {
+		module,
+		storageKey,
+		fields,
+		settingsPath: common,
+		...(Object.keys(metadata).length ? { metadata } : {}),
+	};
+}
+
+/**
+ * 归一化 BoxJS 的字符串存储值，不改变普通文本内容。
+ * Normalize BoxJS string persistence without changing free-text values.
+ * @param {import("../index.js").SettingsField} field 前端字段约束 / Frontend field constraints.
+ * @param {unknown} value 存储值 / Stored value.
+ * @returns {unknown} 转换后的控件值；是否允许写入由 validValue 单独校验 / Converted control value; write eligibility is checked separately by validValue.
+ */
+export function normalizeStoredValue(field, value) {
+	switch (field.type) {
+		case "boolean":
+			if (value === "true" || value === "false") return value === "true";
+			break;
+		case "number":
+			if (typeof value === "string" && value.trim() !== "") return Number(value);
+			break;
+		case "array":
+			if (typeof value === "string") value = value === "" || value === "[]" ? [] : value.split(",");
+			break;
+		default:
+			break;
+	}
+	if (field.options) {
+		const match = item => field.options.find(option => String(option.key) === String(item))?.key ?? item;
+		return field.type === "array" && Array.isArray(value) ? value.map(match) : match(value);
+	}
+	return value;
+}
+
+/**
+ * 校验支持的标量范围，包括文本长度与数值有限性。
+ * Validate supported scalar bounds, including text length and numeric finiteness.
+ * @param {unknown} value 待检查值 / Value to inspect.
+ * @returns {boolean} 是否为有效标量 / Whether the scalar is valid.
+ */
+function scalar(value) {
+	switch (typeof value) {
+		case "boolean":
+			return true;
+		case "string":
+			return value.length <= 2048;
+		case "number":
+			return Number.isFinite(value);
+		default:
+			return false;
+	}
+}
+
+/**
+ * 检查值类型、数组唯一性及声明的选项，不进行转换。
+ * Check value type, array uniqueness and declared choices without coercion.
+ * @param {import("../index.js").SettingsField} field 前端归一化字段 / Normalized frontend field.
+ * @param {unknown} value 待写入的 JSON 值 / JSON value to write.
+ * @returns {boolean} 是否符合字段约束 / Whether the value satisfies field constraints.
+ */
+export function validValue(field, value) {
+	if (field.type === "array") {
+		if (!Array.isArray(value) || value.some(item => !scalar(item)) || new Set(value).size !== value.length) return false;
+	} else if (typeof value !== field.type || !scalar(value)) return false;
+	return !field.options || (field.type === "array" ? value : [value]).every(item => field.options.some(option => option.key === item));
+}

package/src/lib/settings-path.mjs

@@ -0,0 +1,42 @@
+import { URL } from "@nsnanocat/url";
+
+/**
+ * 将 /api/ 后的 URL 路径转换为 util 的路径片段；非 API 路径不处理。
+ * Convert URL segments after /api/ to util path segments; ignore non-API paths.
+ * @param {string} url 请求完整 URL / Absolute request URL.
+ * @returns {string[] | undefined} 键路径片段 / Key path segments.
+ * @throws {TypeError} API 路径无效或包含危险片段 / Invalid or unsafe API path.
+ */
+export function parseSettingsPath(url) {
+	return parseSettingsPathname(new URL(url).pathname);
+}
+
+/**
+ * 解析已经取得的 pathname，避免重复构造 URL。
+ * Parse an existing pathname without constructing another URL.
+ * @param {string} pathname 以 / 开头的 URL pathname / URL pathname beginning with /.
+ * @returns {string[] | undefined} 解码后的路径，非 API 路径不处理 / Decoded path, or undefined outside /api/.
+ * @throws {TypeError} 转义编码或路径片段非法 / Invalid percent encoding or path segments.
+ */
+export function parseSettingsPathname(pathname) {
+	if (!pathname.startsWith("/api/")) return;
+	let parts;
+	try {
+		parts = pathname.slice(5).replace(/\/$/, "").split("/").map(decodeURIComponent);
+	} catch {
+		throw new TypeError("Invalid encoded key path");
+	}
+	return validatePathParts(parts);
+}
+
+/**
+ * 校验原始路径片段，不进行 URL 编码转换。
+ * Validate raw path segments without URL encoding conversion.
+ * @param {string[]} parts 原始路径片段 / Raw path segments.
+ * @returns {string[]} 同一数组，不复制或修改 / The same array without copying or mutation.
+ * @throws {TypeError} 空片段、非法字符或原型属性名 / Empty segments, invalid characters or prototype property names.
+ */
+export function validatePathParts(parts) {
+	if (!parts.every(part => typeof part === "string" && /^[a-zA-Z0-9_-]+$/.test(part) && !["__proto__", "prototype", "constructor"].includes(part))) throw new TypeError("Invalid key path");
+	return parts;
+}

package/src/proxy/request.mjs

@@ -0,0 +1,30 @@
+import { $app } from "@nsnanocat/util/lib/app.mjs";
+import { done } from "@nsnanocat/util/lib/done.mjs";
+import { qs } from "@nsnanocat/util/polyfill/qs.mjs";
+import { SettingsHandler } from "../SettingsHandler.mjs";
+
+/**
+ * 读取代理参数、执行处理器并将响应交给宿主 done。
+ * Read proxy arguments, execute the handler and pass the response to the host's done function.
+ * @returns {Promise<void>} 代理脚本执行结束 / Proxy script execution completion.
+ */
+(async () => {
+	let response;
+	try {
+		const { origin, storageKey, module } = qs.parse(globalThis.$argument);
+		const handler = new SettingsHandler({ origin, storageKey, module });
+		response = await handler.handle(globalThis.$request);
+	} catch (error) {
+		console.error(`PreferencePanes: ${error.message}`);
+		response = {
+			status: 500,
+			headers: { "Content-Type": "application/json; charset=utf-8", "Cache-Control": "no-store" },
+			body: globalThis.$request.method === "HEAD" ? "" : JSON.stringify({ error: "Settings execution failed" }),
+		};
+	}
+	if (!response) {
+		done({});
+		return;
+	}
+	done($app === "Quantumult X" ? response : { response });
+})();

package/browser/client.mjs

@@ -1,112 +0,0 @@
-import { Lodash as _ } from "@nsnanocat/util/polyfill/Lodash.mjs";
-import { normalizeBoxJs, normalizeStoredValue, validValue } from "../lib/boxjs.mjs";
-import { parseSettingsPath } from "../lib/settings-path.mjs";
-
-/**
- * 创建页面会话缓存；打开时重读，选项操作仅在 HTTP 200 后更新缓存。
- * Create a page-session cache; reload on open and mutate cache only after HTTP 200.
- * @param {import("../types/browser.js").PreferencesClientOptions} options 请求与通知 / Requests and notifications.
- * @returns {import("../types/browser.js").PreferencesClient} 通用客户端 / Generic client.
- */
-export function createPreferencesClient({ fetch: request = globalThis.fetch.bind(globalThis), notify = () => {}, timeout = 10000 } = {}) {
-  const sessions = new Map();
-  async function send(path, method, body, signal, resource = false) {
-    const controller = new AbortController();
-    const abort = () => controller.abort();
-    if (signal?.aborted) abort();
-    signal?.addEventListener("abort", abort, { once: true });
-    const timer = setTimeout(abort, timeout);
-    try {
-      const response = await request(path, {
-        method,
-        credentials: "omit",
-        cache: "no-store",
-        signal: controller.signal,
-        headers: resource ? {} : { "X-Settings-Client": "1", ...(method === "POST" ? { "Content-Type": "application/json" } : {}) },
-        ...(method === "POST" ? { body: JSON.stringify(body) } : {}),
-      });
-      if (response.status !== 200) throw new Error(`HTTP ${response.status}`);
-      return response;
-    } finally {
-      clearTimeout(timer);
-      signal?.removeEventListener("abort", abort);
-    }
-  }
-  const configPath = (module) => {
-    if (typeof module !== "string" || !module) throw new TypeError("module is required");
-    const parts = parseSettingsPath(`https://example.invalid/api/${encodeURIComponent(module)}/`);
-    if (parts.length !== 1) throw new TypeError("Expected a module name");
-    return `/configs/${encodeURIComponent(module)}`;
-  };
-  const snapshot = (module) => {
-    const state = sessions.get(module);
-    if (!state?.definition) throw new Error("Open the module first");
-    return structuredClone({ definition: state.definition, values: state.values });
-  };
-  async function change(module, key, method, value) {
-    const state = sessions.get(module);
-    if (!state?.definition) throw new Error("Open the module first");
-    if (state.saving) throw new Error("A settings write is already in progress");
-    const field = state.definition.fields.find((field) => field.key === key);
-    state.saving = true;
-    try {
-      if (!field || (method === "POST" && !validValue(field, value))) throw new TypeError("Invalid setting value");
-      await send(`/api/${key.split(".").map(encodeURIComponent).join("/")}`, method, value);
-      if (sessions.get(module) === state) {
-        if (method === "DELETE") {
-          delete state.values[key];
-          if (Object.hasOwn(field, "defaultValue")) state.values[key] = structuredClone(field.defaultValue);
-        } else state.values[key] = structuredClone(value);
-      }
-      notify({ kind: "success", operation: method === "DELETE" ? "delete" : "write", module, key });
-    } catch (error) {
-      notify({ kind: "error", operation: method === "DELETE" ? "delete" : "write", module, key, message: error.message });
-      throw error;
-    } finally {
-      state.saving = false;
-    }
-  }
-  return {
-    async probe(module) {
-      try {
-        await send(configPath(module), "HEAD", undefined, undefined, true);
-        return true;
-      } catch {
-        return false;
-      }
-    },
-    async open(module) {
-      const previous = sessions.get(module);
-      if (previous?.saving) throw new Error("Cannot refresh while saving");
-      previous?.controller.abort();
-      const state = { controller: new AbortController(), definition: null, values: {}, saving: false };
-      sessions.set(module, state);
-      try {
-        const resource = configPath(module);
-        const definition = normalizeBoxJs(await (await send(resource, "GET", undefined, state.controller.signal, true)).json(), module);
-        if (definition.settingsPath.length < 2) throw new TypeError("BoxJS fields must share a settings subtree below the module root");
-        const subtree = await (
-          await send(`/api/${definition.settingsPath.map(encodeURIComponent).join("/")}/`, "GET", undefined, state.controller.signal)
-        ).json();
-        if (!subtree || typeof subtree !== "object" || Array.isArray(subtree)) throw new TypeError("Expected a settings subtree object");
-        if (sessions.get(module) !== state) throw new Error("Module session was replaced");
-        state.definition = definition;
-        for (const field of definition.fields) {
-          const value = _.get(subtree, field.key.split(".").slice(definition.settingsPath.length), field.defaultValue);
-          if (value !== undefined) state.values[field.key] = normalizeStoredValue(field, value);
-        }
-        return snapshot(module);
-      } catch (error) {
-        if (sessions.get(module) === state) sessions.delete(module);
-        throw error;
-      }
-    },
-    snapshot,
-    leave(module) {
-      sessions.get(module)?.controller.abort();
-      sessions.delete(module);
-    },
-    set: (module, key, value) => change(module, key, "POST", value),
-    remove: (module, key) => change(module, key, "DELETE"),
-  };
-}

package/browser/index.mjs

@@ -1,2 +0,0 @@
-export { createPreferencesClient } from "./client.mjs";
-export { mountPreferencePanes } from "./panel.mjs";

package/browser/panel.css

@@ -1,103 +0,0 @@
-.pp-panel {
-  font:
-    15px / 1.5 system-ui,
-    sans-serif;
-  color: var(--pp-text, #18191c);
-  background: var(--pp-background, #f6f7f8);
-  max-width: 760px;
-  margin: auto;
-  position: relative;
-}
-.pp-panel * {
-  box-sizing: border-box;
-}
-.pp-header {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-  padding: 12px 16px;
-  background: var(--pp-surface, #fff);
-}
-.pp-title {
-  font-size: 18px;
-  margin: 0;
-}
-.pp-viewport {
-  max-height: 80vh;
-  overflow: auto;
-  padding: 16px;
-}
-.pp-panel button {
-  font: inherit;
-  cursor: pointer;
-  border: 1px solid var(--pp-border, #d8dce0);
-  border-radius: 8px;
-  padding: 8px 12px;
-  color: inherit;
-  background: var(--pp-surface, #fff);
-}
-.pp-panel button:disabled {
-  opacity: 0.45;
-  cursor: default;
-}
-.pp-field {
-  margin: 0 0 16px;
-  padding: 16px;
-  border: 1px solid var(--pp-border, #d8dce0);
-  border-radius: 10px;
-  background: var(--pp-surface, #fff);
-  min-width: 0;
-}
-.pp-description {
-  font-size: 13px;
-  opacity: 0.7;
-  margin: 0 0 8px;
-}
-.pp-input:not([type="checkbox"]) {
-  width: 100%;
-  font: inherit;
-  padding: 8px;
-  border: 1px solid var(--pp-border, #d8dce0);
-  border-radius: 6px;
-  background: var(--pp-surface, #fff);
-  color: inherit;
-}
-.pp-choice {
-  display: block;
-  margin: 6px 0;
-}
-.pp-choice input {
-  margin-right: 8px;
-}
-.pp-actions {
-  display: flex;
-  gap: 8px;
-  margin-top: 12px;
-}
-.pp-toast {
-  position: fixed;
-  bottom: 32px;
-  left: 50%;
-  transform: translateX(-50%);
-  padding: 10px 18px;
-  border-radius: 10px;
-  background: #252525;
-  color: #fff;
-  max-width: 90vw;
-  z-index: 1000;
-}
-.pp-toast[data-kind="error"] {
-  background: #8d2424;
-}
-.pp-panel :focus-visible {
-  outline: 2px solid #008ac5;
-  outline-offset: 2px;
-}
-@media (prefers-color-scheme: dark) {
-  .pp-panel {
-    --pp-text: #eee;
-    --pp-background: #18191c;
-    --pp-surface: #25262a;
-    --pp-border: #47494e;
-  }
-}