@nsnanocat/preference-panes 1.0.0 → 1.1.1

package/src/index.d.ts

@@ -268,25 +268,3 @@ export interface BoxJSSubscription extends BoxJSMetadata {
  * The sole data configuration input.
  */
 export type BoxJSInput = BoxJSSetting[] | BoxJSApp | BoxJSSubscription;
-/**
- * 模块 API 返回的原始 BoxJS 与当前值模型。
- * Raw BoxJS and current-value model returned by the module API.
- */
-export interface ModuleModel {
-    /** 模块路径段 / Module path segment. */
-    module: string;
-    /** API 获取的原始 BoxJS JSON / Raw BoxJS JSON fetched by the API. */
-    boxjs: BoxJSInput;
-    /** API 读取到的原始已保存字段值 / Raw persisted field values read by the API. */
-    values: Record<string, JsonValue>;
-    /** 后续 API 动作使用的 BoxJS JSON 地址 / BoxJS JSON URL used by later API actions. */
-    configURL: string;
-}
-/**
- * 生成模块前端文件，不复制配置、不生成绑定模块的代理脚本。
- * Build module frontend files without copying configuration or producing bound proxy scripts.
- * @param boxjs 恰好包含一个模块的 BoxJS JSON / BoxJS JSON describing exactly one module.
- * @param css 可选 CSS 正文 / Optional CSS text.
- * @returns 相对路径到文件内容的映射 / Relative paths mapped to file contents.
- */
-export function build(boxjs: BoxJSInput, css?: string): Promise<Record<string, string>>;

package/src/index.mjs

@@ -1,6 +1,6 @@
 /**
- * 仅接收 BoxJS JSON 与可选 CSS 的构建入口。
- * Build entry accepting only BoxJS JSON and optional CSS.
+ * PreferencePanes 公共类型根入口；浏览器运行时由子路径导出。
+ * PreferencePanes public type root; browser runtimes are exported from subpaths.
  * @module @nsnanocat/preference-panes
  */
-export { build } from "./build.mjs";
+export {};

package/src/web.mjs

@@ -2,7 +2,6 @@ import { URL } from "@nsnanocat/url";
 import { $app } from "@nsnanocat/util/lib/app.mjs";
 import { done } from "@nsnanocat/util/lib/done.mjs";
 import assets from "#assets";
-import { pageInputs } from "./lib/page-inputs.mjs";
 
 /**
  * 返回模块页面及其公共浏览器资源，不处理 API、网络或持久化。
@@ -16,10 +15,7 @@ function run() {
         const url = new URL(request.url);
         if (/^\/settings\/[a-zA-Z0-9_-]+\/?$/.test(url.pathname)) {
             if (!["GET", "HEAD"].includes(request.method)) result = response(request, 405, { error: "Method not allowed" });
-            else {
-                const inputs = encodeURIComponent(JSON.stringify(pageInputs(url, request.headers)));
-                result = response(request, 200, assets.page.body.replace("</head>", `<meta name="preference-panes-inputs" content="${inputs}"></head>`), "text/html");
-            }
+            else result = response(request, 200, assets.page.body, "text/html");
         } else {
             const asset = assets[url.pathname];
             if (asset) result = ["GET", "HEAD"].includes(request.method) ? response(request, 200, asset.body, asset.type) : response(request, 405, { error: "Method not allowed" });

package/src/browser/app.mjs

@@ -1,49 +0,0 @@
-import { pageInputs } from "../lib/page-inputs.mjs";
-import { statusView } from "./components.mjs";
-import { mount } from "./index.mjs";
-import { installDefaultStyles } from "./styles.mjs";
-
-installDefaultStyles(document);
-let view;
-/**
- * 从 URL 或代理传递的 Header 导入 JSON/CSS，支持独立文档与 srcdoc。
- * Import JSON/CSS from the URL or proxy-carried headers in standalone and srcdoc documents.
- * @returns {Promise<void>} 启动完成 / Startup completion.
- */
-async function start() {
-    try {
-        view?.destroy();
-        view = undefined;
-        document.querySelector("#preferences").replaceChildren(statusView("读取设置…"));
-        const context = document.querySelector('meta[name="preference-panes-inputs"]');
-        const embedded = window.frameElement?.dataset.preferencePanes;
-        let inputs;
-        switch (true) {
-            case embedded !== undefined:
-                inputs = JSON.parse(embedded);
-                document.documentElement.dataset.preferencePanesEmbedded = "";
-                break;
-            case context !== null:
-                inputs = JSON.parse(decodeURIComponent(context.content));
-                break;
-            default:
-                inputs = pageInputs(new URL(location.href));
-        }
-        const apiURL = new URL(`/api/${encodeURIComponent(inputs.module)}`, inputs.url).href;
-        const resources = [inputs.css].map(source => {
-            if (!source) return null;
-            const url = new URL(source, inputs.url);
-            if (!["http:", "https:"].includes(url.protocol)) throw new TypeError("Resources must use HTTP(S) URLs");
-            return url.href;
-        });
-        const [style, modelResponse] = await Promise.all([...resources.map(url => (url ? fetch(url, { cache: "no-store", credentials: "omit" }) : null)), fetch(apiURL, { cache: "no-store", credentials: "omit", headers: { Accept: "application/json", "X-PreferencePanes-JSON": inputs.json } })]);
-        if ((style && style.status !== 200) || modelResponse.status !== 200) throw new Error(`HTTP ${modelResponse.status !== 200 ? modelResponse.status : style.status}`);
-        view = mount(await modelResponse.json(), style ? await style.text() : "");
-    } catch (error) {
-        document.querySelector("#preferences").replaceChildren(statusView(`加载失败：${error.message}`, start));
-    }
-}
-start();
-window.addEventListener("pageshow", event => {
-    if (event.persisted) start();
-});

package/src/build.mjs

@@ -1,20 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { normalizeBoxJs } from "./browser/boxjs.mjs";
-
-/**
- * 仅生成模块前端文件，不复制配置或生成绑定业务的读写脚本。
- * Build module frontend files without copying configuration or generating bound storage scripts.
- * @param {unknown} boxjs 仅包含一个模块的 BoxJS JSON / BoxJS JSON containing exactly one module.
- * @param {string} [css] 可选自定义 CSS 正文 / Optional custom CSS text.
- * @returns {Promise<Record<string, string>>} 相对路径到文件正文的映射 / Relative file paths mapped to file contents.
- */
-export async function build(boxjs, css = "") {
-    if (typeof css !== "string") throw new TypeError("CSS must be a string");
-    const module = normalizeBoxJs(boxjs).module;
-    const [html, app] = await Promise.all([readFile(new URL("../dist/module/index.html", import.meta.url), "utf8"), readFile(new URL("../dist/module/app.mjs", import.meta.url), "utf8")]);
-    return {
-        [`settings/${module}/index.html`]: html,
-        "settings/assets/app.mjs": app,
-        [`settings/assets/${module}.css`]: css,
-    };
-}

package/src/lib/page-inputs.mjs

@@ -1,17 +0,0 @@
-/**
- * 统一解析模块页的资源地址：Header 优先于查询参数，再使用模块约定。
- * Resolve module resource locations: headers override query parameters and module conventions.
- * @param {URL} url 已解析的页面请求地址 / Parsed page request URL.
- * @param {Record<string, string | undefined>} [headers] 请求头，名称不区分大小写 / Case-insensitive request headers.
- * @returns {{url: string, module: string, json: string, css: string}} 页面上下文与两个资源输入 / Page context and two resource inputs.
- */
-export function pageInputs(url, headers = {}) {
-    const match = /^\/settings\/([a-zA-Z0-9_-]+)\/?$/.exec(url.pathname);
-    if (!match) throw new TypeError("Open a concrete module URL");
-    const module = match[1];
-    const values = Object.fromEntries(Object.entries(headers).map(([key, value]) => [key.toLowerCase(), value]));
-    const json = values["x-preferencepanes-json"] ?? url.searchParams.get("json") ?? `/configs/${module}`;
-    const css = values["x-preferencepanes-css"] ?? url.searchParams.get("css") ?? "";
-    if (!json.trim()) throw new TypeError("JSON resource URL is required");
-    return { url: url.href, module, json, css };
-}