paperkite 0.1.4 → 0.3.0

package/dist/src/extensions/manifest.js

@@ -0,0 +1,272 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { CORE_POLICY, evaluateCompatibility, sdkDeclarations } from "./abi.js";
+import { compareVersions, isStableVersion, satisfiesRange } from "./semver.js";
+import { paperkiteHome } from "../config/paths.js";
+import { coreRoot } from "./loader.js";
+export const defaultFetch = (url, init) => fetch(url, init);
+/** core 随包携带的离线快照；读取失败按空清单处理。 */
+export async function readSnapshot(file = join(coreRoot(), "bundles.json")) {
+    try {
+        const document = JSON.parse(await readFile(file, "utf8"));
+        const parsed = parseManifestDocument(document);
+        return { ...parsed, origin: "snapshot", warnings: [] };
+    }
+    catch (error) {
+        return {
+            name: "",
+            origin: "snapshot",
+            dependencies: {},
+            warnings: ["built-in bundle snapshot is unreadable: " + detailOf(error)]
+        };
+    }
+}
+export function parseManifestDocument(document) {
+    if (!isRecord(document))
+        throw new Error("bundle manifest is not an object");
+    const name = typeof document.name === "string" ? document.name : "";
+    const version = typeof document.version === "string" ? document.version : undefined;
+    const dependencies = parseDependencyRecord(document.dependencies);
+    if (!Object.keys(dependencies).length)
+        throw new Error("bundle manifest declares no dependencies");
+    return { name, version, dependencies };
+}
+export async function readBundleManifest(options) {
+    const settings = options.settings;
+    const source = settings.manifest.trim();
+    const snapshot = await readSnapshot();
+    if (!source) {
+        return { ...snapshot, warnings: ["no bundle manifest configured; using the built-in snapshot"] };
+    }
+    const cacheFile = join(cacheDirectory(options), "bundle-manifest.json");
+    const cached = await readJson(cacheFile);
+    const usable = cached && cached.source === source ? cached : undefined;
+    if (options.offline) {
+        return usable
+            ? { ...usable, origin: "cache", warnings: [] }
+            : { ...snapshot, warnings: ["offline: using the built-in snapshot for " + source] };
+    }
+    if (usable && !options.refresh && fresh(usable.fetchedAt, settings.manifestTtlHours, options.now)) {
+        return { ...usable, origin: "cache", warnings: [] };
+    }
+    try {
+        const response = await request(source, settings, usable?.etag, options.fetch ?? defaultFetch);
+        if (response.status === 304 && usable) {
+            const refreshed = { ...usable, fetchedAt: new Date().toISOString() };
+            await writeJson(cacheFile, refreshed);
+            return { ...refreshed, origin: "cache", warnings: [] };
+        }
+        if (!response.ok)
+            throw new Error("HTTP " + response.status);
+        const parsed = parseManifestDocument(response.document);
+        await writeJson(cacheFile, {
+            source,
+            etag: response.etag,
+            fetchedAt: new Date().toISOString(),
+            name: parsed.name,
+            version: parsed.version,
+            dependencies: parsed.dependencies
+        });
+        return { ...parsed, origin: "online", warnings: [] };
+    }
+    catch (error) {
+        const detail = detailOf(error);
+        if (usable) {
+            return {
+                ...usable,
+                origin: "cache",
+                warnings: ["bundle manifest refresh failed (" + detail + "); using the cached manifest"]
+            };
+        }
+        return {
+            ...snapshot,
+            warnings: ["bundle manifest unavailable (" + detail + "); using the built-in snapshot"]
+        };
+    }
+}
+async function request(source, settings, etag, fetcher) {
+    const headers = etag ? { "if-none-match": etag } : {};
+    if (isHttpSource(source)) {
+        const response = await fetcher(source, { headers: { ...headers, accept: "application/json" } });
+        return {
+            ok: response.ok,
+            status: response.status,
+            etag: response.headers.get("etag") ?? undefined,
+            document: response.ok ? await response.json() : undefined
+        };
+    }
+    const response = await fetcher(registryUrl(settings.registry, source), {
+        headers: { ...headers, accept: "application/vnd.npm.install-v1+json" }
+    });
+    if (response.status === 304)
+        return { ok: false, status: 304, etag };
+    if (!response.ok)
+        return { ok: false, status: response.status };
+    return {
+        ok: true,
+        status: response.status,
+        etag: response.headers.get("etag") ?? undefined,
+        document: latestRelease(parsePackument(await response.json()))
+    };
+}
+/** 插件版本的 packument；离线时只读缓存。 */
+export async function readPackument(name, options) {
+    const cacheFile = join(cacheDirectory(options), "packuments", safeName(name) + ".json");
+    const cached = await readJson(cacheFile);
+    if (options.offline) {
+        if (cached)
+            return cached.packument;
+        throw new Error("offline: no cached packument for " + name);
+    }
+    if (cached && !options.refresh && fresh(cached.fetchedAt, options.settings.manifestTtlHours, options.now)) {
+        return cached.packument;
+    }
+    const fetcher = options.fetch ?? defaultFetch;
+    const full = (options.release?.minimumReleaseAgeMinutes ?? 0) > 0;
+    const response = await fetcher(registryUrl(options.settings.registry, name), {
+        headers: { accept: full ? "application/json" : "application/vnd.npm.install-v1+json" }
+    });
+    if (!response.ok)
+        throw new Error("HTTP " + response.status + " for " + name);
+    const packument = parsePackument(await response.json());
+    await writeJson(cacheFile, { fetchedAt: new Date().toISOString(), packument });
+    return packument;
+}
+/** 范围内满足 ABI 的最高稳定版；被 core 拒绝的版本排除。 */
+export function selectPluginVersion(packument, range, options = {}) {
+    const policy = options.policy ?? CORE_POLICY;
+    const release = options.release;
+    const now = (options.now ?? Date.now)();
+    const candidates = Object.entries(packument.versions)
+        .filter(([version]) => isStableVersion(version) && satisfiesRange(version, range))
+        .sort(([left], [right]) => compareVersions(right, left));
+    for (const [version, manifest] of candidates) {
+        if (release && excludedByAge(version, options.name, packument, release, now))
+            continue;
+        const verdict = evaluateCompatibility(sdkDeclarations(manifest), policy);
+        if (verdict.verdict === "reject")
+            continue;
+        return { version, verdict };
+    }
+    return undefined;
+}
+function excludedByAge(version, name, packument, release, now) {
+    if (!release.minimumReleaseAgeMinutes)
+        return false;
+    if (name && release.exclude.includes(name))
+        return false;
+    const published = packument.time[version];
+    if (!published)
+        return true;
+    const at = Date.parse(published);
+    if (!Number.isFinite(at))
+        return true;
+    return now - at < release.minimumReleaseAgeMinutes * 60_000;
+}
+/** 清单 scope 之外的名字跳过；默认只接受 `@paperkite/`。 */
+export function filterScopes(dependencies, scopes) {
+    const accepted = {};
+    const skipped = [];
+    for (const [name, range] of Object.entries(dependencies)) {
+        if (scopes.some((scope) => name.startsWith(scope)))
+            accepted[name] = range;
+        else
+            skipped.push(name);
+    }
+    return { accepted, skipped };
+}
+/** 与 pnpm 对齐的供应链延迟设置，取自 profile 的 pnpm-workspace.yaml。 */
+export async function readReleasePolicy(directory) {
+    try {
+        const data = parseYaml(await readFile(join(directory, "pnpm-workspace.yaml"), "utf8"));
+        if (!isRecord(data))
+            return { minimumReleaseAgeMinutes: 0, exclude: [] };
+        const age = Number(data.minimumReleaseAge ?? 0);
+        const exclude = Array.isArray(data.minimumReleaseAgeExclude)
+            ? data.minimumReleaseAgeExclude.filter((item) => typeof item === "string")
+            : [];
+        return {
+            minimumReleaseAgeMinutes: Number.isFinite(age) && age > 0 ? age : 0,
+            exclude
+        };
+    }
+    catch {
+        return { minimumReleaseAgeMinutes: 0, exclude: [] };
+    }
+}
+export function cacheDirectory(options = {}) {
+    return options.cacheDir ?? join(paperkiteHome(), "cache");
+}
+function registryUrl(registry, name) {
+    const base = (registry.trim() || "https://registry.npmjs.org").replace(/\/+$/, "");
+    return base + "/" + encodeURIComponent(name);
+}
+function isHttpSource(source) {
+    return /^https?:\/\//i.test(source);
+}
+function parsePackument(document) {
+    if (!isRecord(document))
+        throw new Error("packument is not an object");
+    const versions = isRecord(document.versions) ? document.versions : {};
+    const distTags = isRecord(document["dist-tags"])
+        ? Object.fromEntries(Object.entries(document["dist-tags"]).filter((entry) => typeof entry[1] === "string"))
+        : {};
+    const time = isRecord(document.time)
+        ? Object.fromEntries(Object.entries(document.time).filter((entry) => typeof entry[1] === "string"))
+        : {};
+    return {
+        name: typeof document.name === "string" ? document.name : undefined,
+        versions,
+        distTags,
+        time
+    };
+}
+function latestRelease(packument) {
+    const latest = packument.distTags.latest;
+    const entry = latest ? packument.versions[latest] : undefined;
+    if (!entry)
+        throw new Error("packument declares no latest release");
+    const dependencies = parseDependencyRecord(entry.dependencies);
+    if (!Object.keys(dependencies).length)
+        throw new Error("latest release declares no dependencies");
+    return { name: packument.name ?? "", version: entry.version ?? latest, dependencies };
+}
+function parseDependencyRecord(value) {
+    if (!isRecord(value))
+        return {};
+    const dependencies = {};
+    for (const [name, range] of Object.entries(value)) {
+        if (typeof range === "string" && range.trim())
+            dependencies[name] = range.trim();
+    }
+    return dependencies;
+}
+function fresh(fetchedAt, ttlHours, now = Date.now) {
+    const at = Date.parse(fetchedAt);
+    if (!Number.isFinite(at))
+        return false;
+    return now() - at < Math.max(0, ttlHours) * 3_600_000;
+}
+async function readJson(file) {
+    try {
+        return JSON.parse(await readFile(file, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeJson(file, value) {
+    await mkdir(dirname(file), { recursive: true });
+    await writeFile(file, JSON.stringify(value, null, 2) + "\n", "utf8");
+}
+function safeName(name) {
+    return name.replace(/[^0-9A-Za-z._-]+/g, "-");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function detailOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/src/extensions/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/extensions/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,eAAe,EAGhB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAYvC,MAAM,CAAC,MAAM,YAAY,GAAc,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AA2DvE,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC;IACxE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;QACrE,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,UAAU;YAClB,YAAY,EAAE,EAAE;YAChB,QAAQ,EAAE,CAAC,0CAA0C,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAiB;IACrD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,MAAM,YAAY,GAAG,qBAAqB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAClE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACnG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAwB;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,CAAC,4DAA4D,CAAC,EAAE,CAAC;IACnG,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAiB,SAAS,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,MAAM;YACX,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC9C,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,CAAC,2CAA2C,GAAG,MAAM,CAAC,EAAE,CAAC;IACxF,CAAC;IACD,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClG,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC;QAC9F,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,EAAE,CAAC;YACtC,MAAM,SAAS,GAAmB,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACrF,MAAM,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACtC,OAAO,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,SAAS,CAAC,SAAS,EAAE;YACzB,MAAM;YACN,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,YAAY;SACT,CAAC,CAAC;QAC5B,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,GAAG,MAAM;gBACT,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,CAAC,kCAAkC,GAAG,MAAM,GAAG,8BAA8B,CAAC;aACzF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,GAAG,QAAQ;YACX,QAAQ,EAAE,CAAC,+BAA+B,GAAG,MAAM,GAAG,gCAAgC,CAAC;SACxF,CAAC;IACJ,CAAC;AACH,CAAC;AASD,KAAK,UAAU,OAAO,CACpB,MAAc,EACd,QAAwB,EACxB,IAAwB,EACxB,OAAkB;IAElB,MAAM,OAAO,GAA2B,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAChG,OAAO;YACL,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS;YAC/C,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;SAC1D,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;QACrE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,qCAAqC,EAAE;KACvE,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACrE,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAChE,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS;QAC/C,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,OAAsD;IAEtD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACxF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAkB,SAAS,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,SAAS,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,IAAI,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1G,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC9C,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,wBAAwB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE;QAC3E,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,qCAAqC,EAAE;KACvF,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAA4B,CAAC,CAAC;IACzG,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,mBAAmB,CACjC,SAAoB,EACpB,KAAa,EACb,OAAO,GAKH,EAAE;IAEN,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC;SAClD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;SACjF,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3D,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,UAAU,EAAE,CAAC;QAC7C,IAAI,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC;YAAE,SAAS;QACvF,MAAM,OAAO,GAAG,qBAAqB,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACzE,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ;YAAE,SAAS;QAC3C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,aAAa,CACpB,OAAe,EACf,IAAwB,EACxB,SAAoB,EACpB,OAAsB,EACtB,GAAW;IAEX,IAAI,CAAC,OAAO,CAAC,wBAAwB;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,wBAAwB,GAAG,MAAM,CAAC;AAC9D,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,YAAY,CAC1B,YAA8C,EAC9C,MAAyB;IAEzB,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACzD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;;YACtE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,EAAE,MAAM,CAAC,CAAY,CAAC;QAClG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC;YAC1D,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;YAC1F,CAAC,CAAC,EAAE,CAAC;QACP,OAAO;YACL,wBAAwB,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACnE,OAAO;SACR,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,wBAAwB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAO,GAAmC,EAAE;IACzE,OAAO,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,IAAY;IACjD,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,4BAA4B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnF,OAAO,IAAI,GAAG,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,QAAiB;IACvC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,QAAQ,CAAC,QAA6C,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5G,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC9C,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CACjH;QACH,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAClC,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CACzG;QACH,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;QACL,IAAI,EAAE,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACnE,QAAQ;QACR,QAAQ;QACR,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,SAAoB;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAClG,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,MAAM,EAAE,YAAY,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;YAAE,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,KAAK,CAAC,SAAiB,EAAE,QAAgB,EAAE,GAAG,GAAiB,IAAI,CAAC,GAAG;IAC9E,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,QAAQ,CAAI,IAAY;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,KAAc;IACnD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/src/extensions/profile.d.ts

@@ -1,16 +1,33 @@
-export declare const PROFILE_WORKSPACE = "packages:\n  - .\n";
+export declare const PROFILE_WORKSPACE = "packages:\n  - .\n\nnodeLinker: hoisted\nautoInstallPeers: false\n";
+/** profile 目录与共享目录之间的中间层；插件向上查找命中 core 的依赖闭包。 */
+export declare function profilesDirectory(): string;
+export declare function readProfileWorkspace(directory: string): Promise<string | undefined>;
+/** 已存在的 pnpm 设置缺少共享闭包所需的选项时给出的重建路径。 */
+export declare function profileWorkspaceMigration(profile: string): string;
 export declare function defaultProfileManifest(profile: string): ProfileManifest;
 export declare function profileDirectory(profile?: string): string;
-export declare function ensureProfile(profile?: string): Promise<string>;
+export interface ProfileInit {
+    readonly directory: string;
+    /** 本次调用新建了 profile 目录，pnpm 设置由此处写入。 */
+    readonly created: boolean;
+    /** 已有 pnpm 设置与当前布局不符时给出重建或迁移路径。 */
+    readonly migration?: string;
+}
+export declare function ensureProfile(profile?: string): Promise<ProfileInit>;
 export interface ProfileManifest {
     readonly name?: string;
     readonly dependencies?: Record<string, string>;
     readonly paperkite?: {
         readonly profile?: {
             readonly plugins?: readonly string[];
+            readonly bundles?: Readonly<Record<string, string>>;
         };
     };
     [key: string]: unknown;
 }
+/** 由清单管理的插件与范围；sync 只管理这一段。 */
+export declare function bundleRanges(manifest: ProfileManifest): Record<string, string>;
+/** 用户显式安装的插件名，清单接管的同名条目不再计入。 */
+export declare function userPlugins(manifest: ProfileManifest): readonly string[];
 export declare function readProfile(directory: string): Promise<ProfileManifest>;
 export declare function writeProfile(directory: string, value: ProfileManifest): Promise<void>;

package/dist/src/extensions/profile.js

@@ -1,7 +1,29 @@
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { paperkiteHome } from "../config/paths.js";
-export const PROFILE_WORKSPACE = "packages:\n  - .\n";
+export const PROFILE_WORKSPACE = "packages:\n  - .\n\nnodeLinker: hoisted\nautoInstallPeers: false\n";
+/** profile 目录与共享目录之间的中间层；插件向上查找命中 core 的依赖闭包。 */
+export function profilesDirectory() {
+    return resolve(paperkiteHome(), "profiles");
+}
+export async function readProfileWorkspace(directory) {
+    try {
+        return await readFile(join(directory, "pnpm-workspace.yaml"), "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+/** 已存在的 pnpm 设置缺少共享闭包所需的选项时给出的重建路径。 */
+export function profileWorkspaceMigration(profile) {
+    const directory = profileDirectory(profile);
+    return ("paperkite: " + profile + " keeps its existing pnpm-workspace.yaml; plugins resolve host-owned " +
+        "packages from " + directory + "/node_modules unless that file sets nodeLinker: hoisted and " +
+        "autoInstallPeers: false. Rebuild the profile (remove " + directory + " and run paperkite init) " +
+        "or add both options to that file\n");
+}
 export function defaultProfileManifest(profile) {
     return {
         name: "paperkite-profile-" + profile,
@@ -9,7 +31,7 @@ export function defaultProfileManifest(profile) {
         private: true,
         type: "module",
         dependencies: {},
-        paperkite: { profile: { plugins: [] } }
+        paperkite: { profile: { plugins: [], bundles: {} } }
     };
 }
 export function profileDirectory(profile = "default") {
@@ -17,18 +39,37 @@ export function profileDirectory(profile = "default") {
 }
 export async function ensureProfile(profile = "default") {
     const directory = profileDirectory(profile);
+    const created = !(await exists(directory));
     await mkdir(directory, { recursive: true });
     const current = await readProfile(directory);
     if (!Object.keys(current).length)
         await writeProfile(directory, defaultProfileManifest(profile));
-    const workspacePath = join(directory, "pnpm-workspace.yaml");
-    try {
-        await access(workspacePath);
-    }
-    catch {
-        await writeFile(workspacePath, PROFILE_WORKSPACE, "utf8");
+    const workspace = await readProfileWorkspace(directory);
+    if (workspace === undefined)
+        await writeFile(join(directory, "pnpm-workspace.yaml"), PROFILE_WORKSPACE, "utf8");
+    if (created || workspace === PROFILE_WORKSPACE)
+        return { directory, created };
+    return { directory, created, migration: profileWorkspaceMigration(profile) };
+}
+/** 由清单管理的插件与范围；sync 只管理这一段。 */
+export function bundleRanges(manifest) {
+    const bundles = manifest.paperkite?.profile?.bundles;
+    if (typeof bundles !== "object" || bundles === null || Array.isArray(bundles))
+        return {};
+    const ranges = {};
+    for (const [name, range] of Object.entries(bundles)) {
+        if (typeof range === "string" && range.trim())
+            ranges[name] = range.trim();
     }
-    return directory;
+    return ranges;
+}
+/** 用户显式安装的插件名，清单接管的同名条目不再计入。 */
+export function userPlugins(manifest) {
+    const declared = manifest.paperkite?.profile?.plugins;
+    if (!Array.isArray(declared))
+        return [];
+    const managed = new Set(Object.keys(bundleRanges(manifest)));
+    return declared.filter((name) => typeof name === "string" && Boolean(name.trim()) && !managed.has(name));
 }
 export async function readProfile(directory) {
     try {
@@ -51,6 +92,15 @@ async function writeJson(file, value) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 function isNodeError(error) {
     return error instanceof Error && "code" in error;
 }

package/dist/src/extensions/profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/extensions/profile.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/extensions/profile.ts"],"names":[],"mappings":"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"}

package/dist/src/extensions/semver.d.ts

@@ -0,0 +1,25 @@
+export interface Version {
+    readonly major: number;
+    readonly minor: number;
+    readonly patch: number;
+    readonly prerelease: readonly (number | string)[];
+}
+export type Operator = ">" | ">=" | "<" | "<=" | "=";
+export interface Comparator {
+    readonly op: Operator;
+    readonly version: Version;
+}
+export type ComparatorSet = readonly Comparator[];
+export type Range = readonly ComparatorSet[];
+export declare function parseVersion(text: string): Version | undefined;
+export declare function parseRange(text: string): Range | undefined;
+export declare function satisfies(range: Range, current: Version): boolean;
+export declare function compare(left: Version, right: Version): number;
+/** 范围为插件接受的 ABI 代际上限；无上限时取所需的最低代际。 */
+export declare function rangeAbi(range: Range): number;
+/** 版本是否落在范围内；任一侧无法解析都视为不满足。 */
+export declare function satisfiesRange(version: string, range: string): boolean;
+export declare function compareVersions(left: string, right: string): number;
+/** 预发布版本不参与选择。 */
+export declare function isStableVersion(version: string): boolean;
+export declare function maxSatisfying(versions: readonly string[], range: string): string | undefined;