@wordrhyme/plugin 0.1.0-alpha.10

package/dist/chunk-7EM22QYB.js

@@ -0,0 +1,333 @@
+// src/dev-utils.ts
+var DEV_ADMIN_ENTRY_CHUNK_PATHS = [
+  "/static/js/admin.js",
+  "/static/js/src_admin_index_tsx.js"
+];
+var DEV_WEB_ENTRY_CHUNK_PATHS = [
+  "/static/js/web.js",
+  "/static/js/client.js",
+  "/static/js/src_web_index_tsx.js",
+  "/static/js/src_web_client_tsx.js"
+];
+var DEV_REMOTE_FAILURE_TTL_MS = 3e4;
+var ACTIVE_DEV_REMOTE_PROBE_ATTEMPTS = 20;
+var ACTIVE_DEV_REMOTE_RETRY_DELAY_MS = 250;
+var DEV_PROBE_CACHE_STORAGE_KEY = "wr.plugin-dev-probe-cache";
+var DEV_REMOTE_OPT_IN_QUERY_KEY = "pluginDevRemote";
+var DEV_REMOTE_OPT_IN_STORAGE_KEY = "wr.plugin-dev-remote";
+var devProbeCache = /* @__PURE__ */ new Map();
+function pluginReactOptions() {
+  return {
+    swcReactOptions: {
+      development: false
+    }
+  };
+}
+function pluginReactShared(requiredVersion = ">=18.0.0 <20.0.0") {
+  const shared = {
+    singleton: true,
+    eager: true,
+    import: false,
+    requiredVersion
+  };
+  return {
+    react: { ...shared },
+    "react-dom": { ...shared },
+    "react/jsx-runtime": { ...shared }
+  };
+}
+function pluginPublicWebShared(reactRequiredVersion = ">=18.0.0 <20.0.0") {
+  const hostShared = {
+    singleton: true,
+    eager: true,
+    import: false,
+    requiredVersion: "*"
+  };
+  return {
+    ...pluginReactShared(reactRequiredVersion),
+    "@wordrhyme/plugin/react": { ...hostShared },
+    "@trpc/client": { ...hostShared },
+    "@trpc/react-query": { ...hostShared },
+    "@tanstack/react-query": { ...hostShared }
+  };
+}
+function getPluginDevPort(pluginId) {
+  const BASE_PORT = 3010;
+  const PORT_RANGE = 100;
+  const hash = pluginId.split("").reduce((acc, char) => {
+    return acc + char.charCodeAt(0);
+  }, 0);
+  return BASE_PORT + hash % PORT_RANGE;
+}
+function getPluginDevRemoteEntry(pluginId) {
+  const port = getPluginDevPort(pluginId);
+  return `http://localhost:${port}/remoteEntry.js`;
+}
+function getPluginWebDevPort(pluginId) {
+  return getPluginDevPort(pluginId) + 100;
+}
+function getPluginWebDevRemoteEntry(pluginId) {
+  return `http://localhost:${getPluginWebDevPort(pluginId)}/remoteEntry.js`;
+}
+function getPluginMfName(pluginId) {
+  const shortId = pluginId.replace(/^com\.wordrhyme\./, "");
+  const normalized = shortId.replace(/[^a-zA-Z0-9_$]/g, "_");
+  return `plugin_${normalized}`;
+}
+function runtime() {
+  return globalThis;
+}
+function readQueryValue(search, key) {
+  const query = search?.replace(/^\?/, "");
+  if (!query) return null;
+  for (const part of query.split("&")) {
+    const [rawKey, rawValue = ""] = part.split("=");
+    if (!rawKey) continue;
+    try {
+      if (decodeURIComponent(rawKey.replace(/\+/g, " ")) === key) {
+        return decodeURIComponent(rawValue.replace(/\+/g, " "));
+      }
+    } catch {
+      if (rawKey === key) return rawValue;
+    }
+  }
+  return null;
+}
+function matchesPluginOptIn(rawValue, pluginId) {
+  const value = rawValue?.trim();
+  if (!value) return false;
+  return value === "1" || value.toLowerCase() === "true" || value.toLowerCase() === "all" || value === pluginId;
+}
+function isPluginListed(pluginId, rawValue) {
+  return parsePluginList(rawValue).includes(pluginId);
+}
+function parsePluginList(rawValue) {
+  if (typeof rawValue !== "string") return [];
+  return Array.from(new Set(
+    rawValue.split(",").map((value) => value.trim()).filter(Boolean)
+  ));
+}
+function getPluginDevRuntimeConfig() {
+  const value = runtime().__WORDRHYME_PLUGIN_DEV__;
+  if (!value || typeof value !== "object") {
+    return { enabled: false, remotePlugins: [] };
+  }
+  const config = value;
+  const remotePlugins = Array.isArray(config.remotePlugins) ? Array.from(new Set(config.remotePlugins.filter((pluginId) => typeof pluginId === "string" && pluginId.trim().length > 0).map((pluginId) => pluginId.trim()))) : parsePluginList(config.remotePlugins);
+  return {
+    enabled: config.enabled === true,
+    remotePlugins
+  };
+}
+function isPluginDevRemoteSelected(pluginId) {
+  const config = getPluginDevRuntimeConfig();
+  return config.enabled && config.remotePlugins.includes(pluginId);
+}
+function isPluginDevRemoteEnabled(pluginId) {
+  const host = runtime();
+  if (matchesPluginOptIn(readQueryValue(host.location?.search, DEV_REMOTE_OPT_IN_QUERY_KEY), pluginId)) {
+    return true;
+  }
+  try {
+    if (matchesPluginOptIn(host.sessionStorage?.getItem(DEV_REMOTE_OPT_IN_STORAGE_KEY) ?? null, pluginId)) {
+      return true;
+    }
+  } catch {
+  }
+  try {
+    if (matchesPluginOptIn(host.localStorage?.getItem(DEV_REMOTE_OPT_IN_STORAGE_KEY) ?? null, pluginId)) {
+      return true;
+    }
+  } catch {
+  }
+  return false;
+}
+function readStoredProbeCache() {
+  try {
+    const raw = runtime().sessionStorage?.getItem(DEV_PROBE_CACHE_STORAGE_KEY);
+    if (!raw) return {};
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+function writeStoredProbeCache(cache) {
+  try {
+    runtime().sessionStorage?.setItem(DEV_PROBE_CACHE_STORAGE_KEY, JSON.stringify(cache));
+  } catch {
+  }
+}
+function probeCacheKey(surface, pluginId, devRemoteEntry) {
+  return `${surface}:${pluginId}:${devRemoteEntry}`;
+}
+function getCachedProbeResult(key, now) {
+  const cached = devProbeCache.get(key);
+  if (cached) {
+    if (cached.expiresAt <= now) {
+      devProbeCache.delete(key);
+    } else {
+      return cached.result;
+    }
+  }
+  const storedCache = readStoredProbeCache();
+  const stored = storedCache[key];
+  if (!stored) return null;
+  if (stored.expiresAt <= now) {
+    delete storedCache[key];
+    writeStoredProbeCache(storedCache);
+    devProbeCache.delete(key);
+    return null;
+  }
+  devProbeCache.set(key, stored);
+  return stored.result;
+}
+function cacheProbeResult(key, result, ttlMs) {
+  const entry = {
+    result,
+    expiresAt: Date.now() + ttlMs
+  };
+  devProbeCache.set(key, entry);
+  const storedCache = readStoredProbeCache();
+  storedCache[key] = entry;
+  writeStoredProbeCache(storedCache);
+}
+function createTimeoutSignal(timeoutMs) {
+  const host = runtime();
+  const timeout = host.AbortSignal?.timeout;
+  if (timeout) {
+    return { signal: timeout(timeoutMs), cleanup: () => {
+    } };
+  }
+  const Controller = host.AbortController;
+  if (!Controller || !host.setTimeout || !host.clearTimeout) {
+    return { cleanup: () => {
+    } };
+  }
+  const probeController = new Controller();
+  const timeoutId = host.setTimeout(() => probeController.abort(), timeoutMs);
+  return {
+    signal: probeController.signal,
+    cleanup: () => host.clearTimeout?.(timeoutId)
+  };
+}
+function waitForRetry(delayMs) {
+  const schedule = runtime().setTimeout;
+  if (!schedule || delayMs <= 0) return Promise.resolve();
+  return new Promise((resolve) => {
+    schedule(() => resolve(), delayMs);
+  });
+}
+function resolveChunkUrl(path, devRemoteEntry) {
+  const originMatch = devRemoteEntry.match(/^(https?:\/\/[^/?#]+)(?:[/?#]|$)/);
+  if (originMatch?.[1] && path.startsWith("/")) {
+    return `${originMatch[1]}${path}`;
+  }
+  const base = devRemoteEntry.replace(/[?#].*$/, "").replace(/\/[^/]*$/, "/");
+  return `${base}${path.replace(/^\//, "")}`;
+}
+async function requestOk(url, signal) {
+  const fetcher = runtime().fetch;
+  if (!fetcher) return false;
+  const response = await fetcher(url, {
+    method: "HEAD",
+    ...signal ? { signal } : {}
+  });
+  if (response.ok) return true;
+  if (response.status !== 405) return false;
+  const fallbackResponse = await fetcher(url, {
+    method: "GET",
+    ...signal ? { signal } : {}
+  });
+  return fallbackResponse.ok;
+}
+async function canLoadDevRemote(devRemoteEntry, surface, signal, entryChunkPaths) {
+  if (!await requestOk(devRemoteEntry, signal)) {
+    return false;
+  }
+  const chunkPaths = entryChunkPaths ?? (surface === "web" ? DEV_WEB_ENTRY_CHUNK_PATHS : DEV_ADMIN_ENTRY_CHUNK_PATHS);
+  for (const path of chunkPaths) {
+    if (await requestOk(resolveChunkUrl(path, devRemoteEntry), signal)) {
+      return true;
+    }
+  }
+  return false;
+}
+function defaultDevRemoteEntry(pluginId, surface) {
+  return surface === "web" ? getPluginWebDevRemoteEntry(pluginId) : getPluginDevRemoteEntry(pluginId);
+}
+async function resolvePluginRemoteEntry({
+  pluginId,
+  manifestRemoteEntry,
+  devRemoteEntry,
+  surface = "admin",
+  isDev = false,
+  devRemoteEnabled = false,
+  probeTimeoutMs = 1500,
+  probeAttempts,
+  probeRetryDelayMs = ACTIVE_DEV_REMOTE_RETRY_DELAY_MS,
+  entryChunkPaths
+}) {
+  const manifestResult = {
+    remoteEntry: manifestRemoteEntry,
+    source: "manifest"
+  };
+  if (!isDev || !devRemoteEnabled && !isPluginDevRemoteEnabled(pluginId)) {
+    return manifestResult;
+  }
+  const devUrl = devRemoteEntry?.trim() || defaultDevRemoteEntry(pluginId, surface);
+  const cacheKey = probeCacheKey(surface, pluginId, devUrl);
+  const cachedResult = getCachedProbeResult(cacheKey, Date.now());
+  if (cachedResult && !(devRemoteEnabled && cachedResult.source === "manifest")) {
+    return cachedResult;
+  }
+  const attempts = Math.max(
+    1,
+    Math.trunc(probeAttempts ?? (devRemoteEnabled ? ACTIVE_DEV_REMOTE_PROBE_ATTEMPTS : 1))
+  );
+  for (let attempt = 0; attempt < attempts; attempt += 1) {
+    const { signal, cleanup } = createTimeoutSignal(probeTimeoutMs);
+    try {
+      if (await canLoadDevRemote(devUrl, surface, signal, entryChunkPaths)) {
+        return {
+          remoteEntry: devUrl,
+          source: "dev"
+        };
+      }
+    } catch {
+    } finally {
+      cleanup();
+    }
+    if (attempt + 1 < attempts) {
+      await waitForRetry(probeRetryDelayMs);
+    }
+  }
+  console.info(`[Plugin] ${pluginId}: ${surface} dev server \u4E0D\u5728\u7EBF\uFF0C\u4F7F\u7528\u9884\u6784\u5EFA\u9759\u6001\u6587\u4EF6`);
+  if (!devRemoteEnabled) {
+    cacheProbeResult(cacheKey, manifestResult, DEV_REMOTE_FAILURE_TTL_MS);
+  }
+  return manifestResult;
+}
+function appendRemoteEntryCacheBust(remoteEntry, value) {
+  const separator = remoteEntry.includes("?") ? "&" : "?";
+  return `${remoteEntry}${separator}t=${encodeURIComponent(String(value))}`;
+}
+
+export {
+  pluginReactOptions,
+  pluginReactShared,
+  pluginPublicWebShared,
+  getPluginDevPort,
+  getPluginDevRemoteEntry,
+  getPluginWebDevPort,
+  getPluginWebDevRemoteEntry,
+  getPluginMfName,
+  isPluginListed,
+  parsePluginList,
+  getPluginDevRuntimeConfig,
+  isPluginDevRemoteSelected,
+  isPluginDevRemoteEnabled,
+  resolvePluginRemoteEntry,
+  appendRemoteEntryCacheBust
+};
+//# sourceMappingURL=chunk-7EM22QYB.js.map

package/dist/chunk-7EM22QYB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dev-utils.ts"],"sourcesContent":["/**\n * Plugin Development Utilities\n * \n * Shared utilities for plugin development, including automatic port assignment.\n */\n\nexport type PluginRemoteSurface = 'admin' | 'web';\n\nexport interface PluginDevRuntimeConfig {\n    enabled: boolean;\n    remotePlugins: string[];\n}\n\nexport interface PluginReactOptions {\n    swcReactOptions: {\n        development: boolean;\n    };\n}\n\nexport interface PluginReactSharedOptions {\n    singleton: true;\n    eager: true;\n    import: false;\n    requiredVersion: string;\n}\n\nexport type PluginPublicWebSharedName =\n    | 'react'\n    | 'react-dom'\n    | 'react/jsx-runtime'\n    | '@wordrhyme/plugin/react'\n    | '@trpc/client'\n    | '@trpc/react-query'\n    | '@tanstack/react-query';\n\nexport interface ResolvedPluginRemoteEntry {\n    remoteEntry: string;\n    source: 'dev' | 'manifest';\n}\n\nexport interface ResolvePluginRemoteEntryOptions {\n    pluginId: string;\n    manifestRemoteEntry: string;\n    devRemoteEntry?: string | undefined;\n    surface?: PluginRemoteSurface | undefined;\n    isDev?: boolean | undefined;\n    devRemoteEnabled?: boolean | undefined;\n    probeTimeoutMs?: number | undefined;\n    probeAttempts?: number | undefined;\n    probeRetryDelayMs?: number | undefined;\n    entryChunkPaths?: readonly string[] | undefined;\n}\n\ninterface DevProbeCacheEntry {\n    result: ResolvedPluginRemoteEntry;\n    expiresAt: number;\n}\n\ninterface StorageLike {\n    getItem(key: string): string | null;\n    setItem(key: string, value: string): void;\n}\n\ninterface RuntimeLike {\n    __WORDRHYME_PLUGIN_DEV__?: unknown;\n    location?: { search?: string | undefined } | undefined;\n    sessionStorage?: StorageLike | undefined;\n    localStorage?: StorageLike | undefined;\n    fetch?: ((url: string, init: { method: 'HEAD' | 'GET'; signal?: unknown }) => Promise<{ ok: boolean; status: number }>) | undefined;\n    AbortSignal?: { timeout?: (ms: number) => unknown } | undefined;\n    AbortController?: (new () => { signal: unknown; abort: () => void }) | undefined;\n    setTimeout?: ((handler: () => void, timeoutMs: number) => unknown) | undefined;\n    clearTimeout?: ((handle: unknown) => void) | undefined;\n}\n\nconst DEV_ADMIN_ENTRY_CHUNK_PATHS = [\n    '/static/js/admin.js',\n    '/static/js/src_admin_index_tsx.js',\n] as const;\n\nconst DEV_WEB_ENTRY_CHUNK_PATHS = [\n    '/static/js/web.js',\n    '/static/js/client.js',\n    '/static/js/src_web_index_tsx.js',\n    '/static/js/src_web_client_tsx.js',\n] as const;\n\nconst DEV_REMOTE_FAILURE_TTL_MS = 30_000;\nconst ACTIVE_DEV_REMOTE_PROBE_ATTEMPTS = 20;\nconst ACTIVE_DEV_REMOTE_RETRY_DELAY_MS = 250;\nconst DEV_PROBE_CACHE_STORAGE_KEY = 'wr.plugin-dev-probe-cache';\nconst DEV_REMOTE_OPT_IN_QUERY_KEY = 'pluginDevRemote';\nconst DEV_REMOTE_OPT_IN_STORAGE_KEY = 'wr.plugin-dev-remote';\nconst devProbeCache = new Map<string, DevProbeCacheEntry>();\n\n/**\n * Keep plugin remotes on the production-compatible JSX runtime even while the\n * remote dev server and React Fast Refresh are active. A prebuilt Dev Host uses\n * production React, which cannot execute react-jsx-dev-runtime safely.\n */\nexport function pluginReactOptions(): PluginReactOptions {\n    return {\n        swcReactOptions: {\n            development: false,\n        },\n    };\n}\n\nexport function pluginReactShared(\n    requiredVersion = '>=18.0.0 <20.0.0',\n): Record<'react' | 'react-dom' | 'react/jsx-runtime', PluginReactSharedOptions> {\n    const shared = {\n        singleton: true,\n        eager: true,\n        import: false,\n        requiredVersion,\n    } as const;\n\n    return {\n        react: { ...shared },\n        'react-dom': { ...shared },\n        'react/jsx-runtime': { ...shared },\n    };\n}\n\n/**\n * Module Federation shared contract for public Web React remotes.\n *\n * The public Host injects its tRPC client into @wordrhyme/plugin/react, so Web\n * remotes must consume the Host copy of the SDK and its query dependencies.\n */\nexport function pluginPublicWebShared(\n    reactRequiredVersion = '>=18.0.0 <20.0.0',\n): Record<PluginPublicWebSharedName, PluginReactSharedOptions> {\n    const hostShared = {\n        singleton: true,\n        eager: true,\n        import: false,\n        requiredVersion: '*',\n    } as const;\n\n    return {\n        ...pluginReactShared(reactRequiredVersion),\n        '@wordrhyme/plugin/react': { ...hostShared },\n        '@trpc/client': { ...hostShared },\n        '@trpc/react-query': { ...hostShared },\n        '@tanstack/react-query': { ...hostShared },\n    };\n}\n\n/**\n * Calculate a deterministic dev port for a plugin based on its ID.\n * \n * This allows multiple plugins to run simultaneously without port conflicts,\n * while keeping the port assignment automatic and predictable.\n * \n * Port range: 3010-3109 (100 possible ports)\n * \n * @param pluginId - Full plugin ID (e.g., \"com.wordrhyme.hello-world\")\n * @returns Port number for the plugin's dev server\n * \n * @example\n * getPluginDevPort('com.wordrhyme.hello-world')  // e.g., 3042\n * getPluginDevPort('com.wordrhyme.analytics')    // e.g., 3015\n */\nexport function getPluginDevPort(pluginId: string): number {\n    const BASE_PORT = 3010;\n    const PORT_RANGE = 100;\n\n    // Simple hash based on character codes\n    const hash = pluginId.split('').reduce((acc, char) => {\n        return acc + char.charCodeAt(0);\n    }, 0);\n\n    return BASE_PORT + (hash % PORT_RANGE);\n}\n\n/**\n * Get the dev remote entry URL for a plugin.\n * \n * @param pluginId - Full plugin ID\n * @returns Full URL to the plugin's remoteEntry.js in dev mode\n */\nexport function getPluginDevRemoteEntry(pluginId: string): string {\n    const port = getPluginDevPort(pluginId);\n    return `http://localhost:${port}/remoteEntry.js`;\n}\n\n/**\n * Calculate a deterministic public web dev port for a plugin.\n *\n * Public web remotes run beside admin remotes, so they use the same stable\n * plugin hash with a +100 offset.\n */\nexport function getPluginWebDevPort(pluginId: string): number {\n    return getPluginDevPort(pluginId) + 100;\n}\n\n/**\n * Get the public web dev remote entry URL for a plugin.\n */\nexport function getPluginWebDevRemoteEntry(pluginId: string): string {\n    return `http://localhost:${getPluginWebDevPort(pluginId)}/remoteEntry.js`;\n}\n\n/**\n * Normalize plugin ID to a valid Module Federation name.\n * \n * MF names must be valid JavaScript identifiers.\n * \"com.wordrhyme.hello-world\" → \"plugin_hello_world\"\n * \n * @param pluginId - Full plugin ID\n * @returns Valid MF module name\n */\nexport function getPluginMfName(pluginId: string): string {\n    // Keep the established short name for official plugins, while accepting\n    // every valid reverse-domain plugin id from the public Plugin Contract.\n    const shortId = pluginId.replace(/^com\\.wordrhyme\\./, '');\n    const normalized = shortId.replace(/[^a-zA-Z0-9_$]/g, '_');\n    return `plugin_${normalized}`;\n}\n\nfunction runtime(): RuntimeLike {\n    return globalThis as unknown as RuntimeLike;\n}\n\nfunction readQueryValue(search: string | undefined, key: string): string | null {\n    const query = search?.replace(/^\\?/, '');\n    if (!query) return null;\n\n    for (const part of query.split('&')) {\n        const [rawKey, rawValue = ''] = part.split('=');\n        if (!rawKey) continue;\n        try {\n            if (decodeURIComponent(rawKey.replace(/\\+/g, ' ')) === key) {\n                return decodeURIComponent(rawValue.replace(/\\+/g, ' '));\n            }\n        } catch {\n            if (rawKey === key) return rawValue;\n        }\n    }\n\n    return null;\n}\n\nfunction matchesPluginOptIn(rawValue: string | null, pluginId: string): boolean {\n    const value = rawValue?.trim();\n    if (!value) return false;\n\n    return value === '1'\n        || value.toLowerCase() === 'true'\n        || value.toLowerCase() === 'all'\n        || value === pluginId;\n}\n\nexport function isPluginListed(pluginId: string, rawValue: unknown): boolean {\n    return parsePluginList(rawValue).includes(pluginId);\n}\n\nexport function parsePluginList(rawValue: unknown): string[] {\n    if (typeof rawValue !== 'string') return [];\n\n    return Array.from(new Set(\n        rawValue\n            .split(',')\n            .map((value) => value.trim())\n            .filter(Boolean),\n    ));\n}\n\nexport function getPluginDevRuntimeConfig(): PluginDevRuntimeConfig {\n    const value = runtime().__WORDRHYME_PLUGIN_DEV__;\n    if (!value || typeof value !== 'object') {\n        return { enabled: false, remotePlugins: [] };\n    }\n\n    const config = value as { enabled?: unknown; remotePlugins?: unknown };\n    const remotePlugins = Array.isArray(config.remotePlugins)\n        ? Array.from(new Set(config.remotePlugins.filter((pluginId): pluginId is string => (\n            typeof pluginId === 'string' && pluginId.trim().length > 0\n        )).map((pluginId) => pluginId.trim())))\n        : parsePluginList(config.remotePlugins);\n\n    return {\n        enabled: config.enabled === true,\n        remotePlugins,\n    };\n}\n\nexport function isPluginDevRemoteSelected(pluginId: string): boolean {\n    const config = getPluginDevRuntimeConfig();\n    return config.enabled && config.remotePlugins.includes(pluginId);\n}\n\nexport function isPluginDevRemoteEnabled(pluginId: string): boolean {\n    const host = runtime();\n    if (matchesPluginOptIn(readQueryValue(host.location?.search, DEV_REMOTE_OPT_IN_QUERY_KEY), pluginId)) {\n        return true;\n    }\n\n    try {\n        if (matchesPluginOptIn(host.sessionStorage?.getItem(DEV_REMOTE_OPT_IN_STORAGE_KEY) ?? null, pluginId)) {\n            return true;\n        }\n    } catch {\n        // Ignore storage access failures.\n    }\n\n    try {\n        if (matchesPluginOptIn(host.localStorage?.getItem(DEV_REMOTE_OPT_IN_STORAGE_KEY) ?? null, pluginId)) {\n            return true;\n        }\n    } catch {\n        // Ignore storage access failures.\n    }\n\n    return false;\n}\n\nfunction readStoredProbeCache(): Record<string, DevProbeCacheEntry> {\n    try {\n        const raw = runtime().sessionStorage?.getItem(DEV_PROBE_CACHE_STORAGE_KEY);\n        if (!raw) return {};\n        const parsed = JSON.parse(raw) as Record<string, DevProbeCacheEntry> | null;\n        return parsed && typeof parsed === 'object' ? parsed : {};\n    } catch {\n        return {};\n    }\n}\n\nfunction writeStoredProbeCache(cache: Record<string, DevProbeCacheEntry>) {\n    try {\n        runtime().sessionStorage?.setItem(DEV_PROBE_CACHE_STORAGE_KEY, JSON.stringify(cache));\n    } catch {\n        // Ignore storage failures and rely on in-memory cache.\n    }\n}\n\nfunction probeCacheKey(surface: PluginRemoteSurface, pluginId: string, devRemoteEntry: string): string {\n    return `${surface}:${pluginId}:${devRemoteEntry}`;\n}\n\nfunction getCachedProbeResult(key: string, now: number): ResolvedPluginRemoteEntry | null {\n    const cached = devProbeCache.get(key);\n    if (cached) {\n        if (cached.expiresAt <= now) {\n            devProbeCache.delete(key);\n        } else {\n            return cached.result;\n        }\n    }\n\n    const storedCache = readStoredProbeCache();\n    const stored = storedCache[key];\n    if (!stored) return null;\n    if (stored.expiresAt <= now) {\n        delete storedCache[key];\n        writeStoredProbeCache(storedCache);\n        devProbeCache.delete(key);\n        return null;\n    }\n    devProbeCache.set(key, stored);\n    return stored.result;\n}\n\nfunction cacheProbeResult(key: string, result: ResolvedPluginRemoteEntry, ttlMs: number) {\n    const entry = {\n        result,\n        expiresAt: Date.now() + ttlMs,\n    };\n    devProbeCache.set(key, entry);\n\n    const storedCache = readStoredProbeCache();\n    storedCache[key] = entry;\n    writeStoredProbeCache(storedCache);\n}\n\nfunction createTimeoutSignal(timeoutMs: number): { signal?: unknown; cleanup: () => void } {\n    const host = runtime();\n    const timeout = host.AbortSignal?.timeout;\n    if (timeout) {\n        return { signal: timeout(timeoutMs), cleanup: () => {} };\n    }\n\n    const Controller = host.AbortController;\n    if (!Controller || !host.setTimeout || !host.clearTimeout) {\n        return { cleanup: () => {} };\n    }\n\n    const probeController = new Controller();\n    const timeoutId = host.setTimeout(() => probeController.abort(), timeoutMs);\n    return {\n        signal: probeController.signal,\n        cleanup: () => host.clearTimeout?.(timeoutId),\n    };\n}\n\nfunction waitForRetry(delayMs: number): Promise<void> {\n    const schedule = runtime().setTimeout;\n    if (!schedule || delayMs <= 0) return Promise.resolve();\n\n    return new Promise((resolve) => {\n        schedule(() => resolve(), delayMs);\n    });\n}\n\nfunction resolveChunkUrl(path: string, devRemoteEntry: string): string {\n    const originMatch = devRemoteEntry.match(/^(https?:\\/\\/[^/?#]+)(?:[/?#]|$)/);\n    if (originMatch?.[1] && path.startsWith('/')) {\n        return `${originMatch[1]}${path}`;\n    }\n\n    const base = devRemoteEntry.replace(/[?#].*$/, '').replace(/\\/[^/]*$/, '/');\n    return `${base}${path.replace(/^\\//, '')}`;\n}\n\nasync function requestOk(url: string, signal: unknown): Promise<boolean> {\n    const fetcher = runtime().fetch;\n    if (!fetcher) return false;\n\n    const response = await fetcher(url, {\n        method: 'HEAD',\n        ...(signal ? { signal } : {}),\n    });\n\n    if (response.ok) return true;\n    if (response.status !== 405) return false;\n\n    const fallbackResponse = await fetcher(url, {\n        method: 'GET',\n        ...(signal ? { signal } : {}),\n    });\n    return fallbackResponse.ok;\n}\n\nasync function canLoadDevRemote(\n    devRemoteEntry: string,\n    surface: PluginRemoteSurface,\n    signal: unknown,\n    entryChunkPaths?: readonly string[] | undefined,\n): Promise<boolean> {\n    if (!await requestOk(devRemoteEntry, signal)) {\n        return false;\n    }\n\n    const chunkPaths = entryChunkPaths\n        ?? (surface === 'web' ? DEV_WEB_ENTRY_CHUNK_PATHS : DEV_ADMIN_ENTRY_CHUNK_PATHS);\n    for (const path of chunkPaths) {\n        if (await requestOk(resolveChunkUrl(path, devRemoteEntry), signal)) {\n            return true;\n        }\n    }\n\n    return false;\n}\n\nfunction defaultDevRemoteEntry(pluginId: string, surface: PluginRemoteSurface): string {\n    return surface === 'web'\n        ? getPluginWebDevRemoteEntry(pluginId)\n        : getPluginDevRemoteEntry(pluginId);\n}\n\nexport async function resolvePluginRemoteEntry({\n    pluginId,\n    manifestRemoteEntry,\n    devRemoteEntry,\n    surface = 'admin',\n    isDev = false,\n    devRemoteEnabled = false,\n    probeTimeoutMs = 1500,\n    probeAttempts,\n    probeRetryDelayMs = ACTIVE_DEV_REMOTE_RETRY_DELAY_MS,\n    entryChunkPaths,\n}: ResolvePluginRemoteEntryOptions): Promise<ResolvedPluginRemoteEntry> {\n    const manifestResult = {\n        remoteEntry: manifestRemoteEntry,\n        source: 'manifest',\n    } as const;\n\n    if (!isDev || (!devRemoteEnabled && !isPluginDevRemoteEnabled(pluginId))) {\n        return manifestResult;\n    }\n\n    const devUrl = devRemoteEntry?.trim() || defaultDevRemoteEntry(pluginId, surface);\n    const cacheKey = probeCacheKey(surface, pluginId, devUrl);\n    const cachedResult = getCachedProbeResult(cacheKey, Date.now());\n    if (cachedResult && !(devRemoteEnabled && cachedResult.source === 'manifest')) {\n        return cachedResult;\n    }\n\n    const attempts = Math.max(\n        1,\n        Math.trunc(probeAttempts ?? (devRemoteEnabled ? ACTIVE_DEV_REMOTE_PROBE_ATTEMPTS : 1)),\n    );\n\n    for (let attempt = 0; attempt < attempts; attempt += 1) {\n        const { signal, cleanup } = createTimeoutSignal(probeTimeoutMs);\n\n        try {\n            if (await canLoadDevRemote(devUrl, surface, signal, entryChunkPaths)) {\n                return {\n                    remoteEntry: devUrl,\n                    source: 'dev',\n                };\n            }\n        } catch {\n            // The selected dev process may still be starting. Retry below when explicitly active.\n        } finally {\n            cleanup();\n        }\n\n        if (attempt + 1 < attempts) {\n            await waitForRetry(probeRetryDelayMs);\n        }\n    }\n\n    console.info(`[Plugin] ${pluginId}: ${surface} dev server 不在线，使用预构建静态文件`);\n    if (!devRemoteEnabled) {\n        cacheProbeResult(cacheKey, manifestResult, DEV_REMOTE_FAILURE_TTL_MS);\n    }\n    return manifestResult;\n}\n\nexport function appendRemoteEntryCacheBust(remoteEntry: string, value: string | number): string {\n    const separator = remoteEntry.includes('?') ? '&' : '?';\n    return `${remoteEntry}${separator}t=${encodeURIComponent(String(value))}`;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-BI7E5CVM.js

@@ -0,0 +1,26 @@
+// src/locale.ts
+var DEFAULT_LOCALE = "zh-CN";
+function canonicalizeLocale(value) {
+  if (typeof value !== "string") return void 0;
+  const locale = value.trim();
+  if (!locale || locale === "*") return void 0;
+  try {
+    return Intl.getCanonicalLocales(locale)[0];
+  } catch {
+    return void 0;
+  }
+}
+function isLocale(value) {
+  return canonicalizeLocale(value) !== void 0;
+}
+function normalizeLocale(value, fallback = DEFAULT_LOCALE) {
+  return canonicalizeLocale(value) ?? canonicalizeLocale(fallback) ?? DEFAULT_LOCALE;
+}
+
+export {
+  DEFAULT_LOCALE,
+  canonicalizeLocale,
+  isLocale,
+  normalizeLocale
+};
+//# sourceMappingURL=chunk-BI7E5CVM.js.map

package/dist/chunk-BI7E5CVM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/locale.ts"],"sourcesContent":["/**\n * Shared locale contract for every WordRhyme runtime surface.\n *\n * Locale parsing delegates to the platform Intl implementation so every\n * caller accepts the same BCP 47 grammar and produces the same casing.\n */\n\nexport const DEFAULT_LOCALE = 'zh-CN';\n\n/** Return the canonical BCP 47 representation of a locale value. */\nexport function canonicalizeLocale(value: unknown): string | undefined {\n    if (typeof value !== 'string') return undefined;\n\n    const locale = value.trim();\n    if (!locale || locale === '*') return undefined;\n\n    try {\n        return Intl.getCanonicalLocales(locale)[0];\n    } catch {\n        return undefined;\n    }\n}\n\n/** Check whether a value is a valid BCP 47 locale. */\nexport function isLocale(value: unknown): value is string {\n    return canonicalizeLocale(value) !== undefined;\n}\n\n/** Canonicalize a locale or use the shared system fallback. */\nexport function normalizeLocale(value: unknown, fallback = DEFAULT_LOCALE): string {\n    return canonicalizeLocale(value) ?? canonicalizeLocale(fallback) ?? DEFAULT_LOCALE;\n}\n"],"mappings":";AAOO,IAAM,iBAAiB;AAGvB,SAAS,mBAAmB,OAAoC;AACnE,MAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,QAAM,SAAS,MAAM,KAAK;AAC1B,MAAI,CAAC,UAAU,WAAW,IAAK,QAAO;AAEtC,MAAI;AACA,WAAO,KAAK,oBAAoB,MAAM,EAAE,CAAC;AAAA,EAC7C,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;AAGO,SAAS,SAAS,OAAiC;AACtD,SAAO,mBAAmB,KAAK,MAAM;AACzC;AAGO,SAAS,gBAAgB,OAAgB,WAAW,gBAAwB;AAC/E,SAAO,mBAAmB,KAAK,KAAK,mBAAmB,QAAQ,KAAK;AACxE;","names":[]}

package/dist/chunk-BVOTSKM2.js

@@ -0,0 +1,254 @@
+import {
+  DEFAULT_LOCALE,
+  canonicalizeLocale,
+  normalizeLocale
+} from "./chunk-BI7E5CVM.js";
+
+// src/globalization.ts
+import Decimal from "decimal.js";
+Decimal.set({
+  precision: 28,
+  rounding: Decimal.ROUND_HALF_EVEN
+});
+var DEFAULT_CURRENCY = {
+  code: "USD",
+  nameI18n: { "en-US": "US Dollar", "zh-CN": "\u7F8E\u5143" },
+  symbol: "$",
+  decimalDigits: 2,
+  isBase: true,
+  currentRate: "1"
+};
+var RTL_LANGUAGE_CODES = /* @__PURE__ */ new Set(["ar", "he", "fa", "ur"]);
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function isCurrencyInfo(value) {
+  return isRecord(value) && typeof value["code"] === "string";
+}
+function isCurrencyCatalog(value) {
+  return Array.isArray(value);
+}
+function readRate(currency) {
+  if (currency.isBase) return new Decimal(1);
+  try {
+    const rate = new Decimal(currency.currentRate ?? "1");
+    return rate.gt(0) ? rate : new Decimal(1);
+  } catch {
+    return new Decimal(1);
+  }
+}
+function minorUnitFactor(currency) {
+  return new Decimal(10).pow(Math.max(0, currency.decimalDigits));
+}
+function getTextDirection(locale) {
+  const languageCode = normalizeLocale(locale, DEFAULT_LOCALE).split("-")[0]?.toLowerCase();
+  return languageCode && RTL_LANGUAGE_CODES.has(languageCode) ? "rtl" : "ltr";
+}
+function normalizeCurrencyInfo(currency, fallback = DEFAULT_CURRENCY) {
+  const code = currency.code.toUpperCase();
+  return {
+    code,
+    nameI18n: currency.nameI18n ?? (code === fallback.code ? fallback.nameI18n : {}),
+    symbol: currency.symbol ?? (code === fallback.code ? fallback.symbol : code),
+    decimalDigits: typeof currency.decimalDigits === "number" ? currency.decimalDigits : fallback.decimalDigits,
+    isBase: currency.isBase ?? code === fallback.code,
+    currentRate: currency.isBase ? "1" : currency.currentRate ?? null
+  };
+}
+function normalizeCurrencies(currencies) {
+  if (currencies.length === 0) return [DEFAULT_CURRENCY];
+  const normalized = currencies.map((currency) => normalizeCurrencyInfo(currency));
+  const hasBase = normalized.some((currency) => currency.isBase);
+  if (hasBase) return normalized;
+  return normalized.map((currency, index) => ({
+    ...currency,
+    isBase: index === 0,
+    currentRate: index === 0 ? "1" : currency.currentRate
+  }));
+}
+function findCurrency(currencies, currencyCode) {
+  if (!currencyCode) return void 0;
+  const normalizedCode = currencyCode.toUpperCase();
+  return currencies.find((currency) => currency.code.toUpperCase() === normalizedCode);
+}
+function getBaseCurrency(currencies) {
+  return currencies.find((currency) => currency.isBase) ?? currencies[0] ?? DEFAULT_CURRENCY;
+}
+function resolveCurrencyInfo(currency, currencies, fallback = getBaseCurrency(currencies)) {
+  if (isCurrencyInfo(currency)) return normalizeCurrencyInfo(currency, fallback);
+  return findCurrency(currencies, currency) ?? normalizeCurrencyInfo({ code: currency ?? fallback.code }, fallback);
+}
+function bankersRound(value, decimalDigits) {
+  const decimal = new Decimal(value);
+  const factor = new Decimal(10).pow(decimalDigits);
+  return decimal.times(factor).round().div(factor).toNumber();
+}
+function toCents(displayAmount, decimalDigits) {
+  const factor = new Decimal(10).pow(decimalDigits);
+  return new Decimal(displayAmount).times(factor).round().toNumber();
+}
+function fromCents(cents, decimalDigits) {
+  const factor = new Decimal(10).pow(decimalDigits);
+  return new Decimal(cents).div(factor).toNumber();
+}
+function convertCurrency(cents, fromCurrency, toCurrency, currenciesOrBaseCurrency) {
+  if (fromCurrency.code === toCurrency.code) return cents;
+  const catalog = isCurrencyCatalog(currenciesOrBaseCurrency) ? currenciesOrBaseCurrency : [currenciesOrBaseCurrency, fromCurrency, toCurrency];
+  const baseCurrency = isCurrencyCatalog(currenciesOrBaseCurrency) ? getBaseCurrency(catalog) : currenciesOrBaseCurrency;
+  const from = normalizeCurrencyInfo(fromCurrency, baseCurrency);
+  const to = normalizeCurrencyInfo(toCurrency, baseCurrency);
+  const sourceMinor = new Decimal(cents);
+  const sourceMajor = sourceMinor.div(minorUnitFactor(from));
+  const baseMajor = sourceMajor.div(readRate(from));
+  const targetMajor = baseMajor.times(readRate(to));
+  return targetMajor.times(minorUnitFactor(to)).round().toNumber();
+}
+function formatCurrencyAmount(cents, currency, locale, options = {}) {
+  const {
+    showSymbol = true,
+    currencyDisplay = "symbol",
+    notation = "standard",
+    signDisplay = "auto",
+    decimalDigits
+  } = options;
+  const digits = decimalDigits ?? currency.decimalDigits;
+  const displayAmount = fromCents(cents, currency.decimalDigits);
+  try {
+    const formatter = new Intl.NumberFormat(locale, showSymbol ? {
+      style: "currency",
+      currency: currency.code,
+      currencyDisplay,
+      notation,
+      signDisplay,
+      minimumFractionDigits: digits,
+      maximumFractionDigits: digits
+    } : {
+      style: "decimal",
+      notation,
+      signDisplay,
+      minimumFractionDigits: digits,
+      maximumFractionDigits: digits
+    });
+    return formatter.format(displayAmount);
+  } catch {
+    const symbol = showSymbol ? currency.symbol : "";
+    return `${symbol}${displayAmount.toFixed(digits)}`;
+  }
+}
+function formatPrice(cents, fromCurrency, state, options = {}) {
+  const currencies = normalizeCurrencies(state.currencies.length ? state.currencies : [state.baseCurrency]);
+  const baseCurrency = normalizeCurrencyInfo(state.baseCurrency, getBaseCurrency(currencies));
+  const sourceCurrency = resolveCurrencyInfo(fromCurrency, currencies, baseCurrency);
+  const targetCurrency = resolveCurrencyInfo(options.toCurrency ?? state.currency, currencies, baseCurrency);
+  const converted = convertCurrency(cents, sourceCurrency, targetCurrency, currencies);
+  return formatCurrencyAmount(
+    converted,
+    targetCurrency,
+    options.locale ?? state.locale,
+    options
+  );
+}
+function getI18nText(field, locale, fallbackLocale = "en-US") {
+  if (typeof field === "string") return field;
+  if (!field || typeof field !== "object") return "";
+  const normalizedLocale = normalizeLocale(locale, fallbackLocale);
+  const normalizedFallbackLocale = normalizeLocale(fallbackLocale);
+  const languageCode = normalizedLocale.split("-")[0];
+  const fallbackLanguageCode = normalizedFallbackLocale.split("-")[0];
+  const candidates = [
+    field[normalizedLocale],
+    languageCode ? field[languageCode] : void 0,
+    field[normalizedFallbackLocale],
+    fallbackLanguageCode ? field[fallbackLanguageCode] : void 0,
+    ...Object.values(field)
+  ];
+  return candidates.find((value) => typeof value === "string" && value.length > 0) ?? "";
+}
+function resolveMessageKey(messages, key, params, locale) {
+  const context = typeof params?.["context"] === "string" ? params["context"] : void 0;
+  const count = typeof params?.["count"] === "number" ? params["count"] : void 0;
+  const candidates = [];
+  if (count !== void 0) {
+    const category = new Intl.PluralRules(locale).select(count);
+    if (context) candidates.push(`${key}_${context}_${category}`, `${key}_${context}_other`);
+    candidates.push(`${key}_${category}`, `${key}_other`);
+  }
+  if (context) candidates.push(`${key}_${context}`);
+  candidates.push(key);
+  return candidates.find((candidate) => messages[candidate] !== void 0) ?? key;
+}
+function createTranslator(messages, locale = DEFAULT_LOCALE) {
+  const translations = messages ?? {};
+  const normalizedLocale = canonicalizeLocale(locale) ?? DEFAULT_LOCALE;
+  return (key, paramsOrFallback) => {
+    const params = paramsOrFallback && typeof paramsOrFallback === "object" ? paramsOrFallback : void 0;
+    const resolvedKey = resolveMessageKey(translations, key, params, normalizedLocale);
+    let value = translations[resolvedKey];
+    if (!value) {
+      return typeof paramsOrFallback === "string" ? paramsOrFallback : key;
+    }
+    if (params) {
+      for (const [name, replacement] of Object.entries(params)) {
+        value = value.replace(new RegExp(`\\{\\{${name}\\}\\}`, "g"), String(replacement)).replace(new RegExp(`\\{${name}\\}`, "g"), String(replacement));
+      }
+    }
+    return value;
+  };
+}
+function isFormatPriceOptions(value) {
+  return isRecord(value) && !("code" in value);
+}
+function createPriceFormatter(state, defaultFromCurrency) {
+  return (cents, fromCurrencyOrOptions, options) => {
+    const fromCurrency = isFormatPriceOptions(fromCurrencyOrOptions) ? defaultFromCurrency ?? state.baseCurrency : fromCurrencyOrOptions ?? defaultFromCurrency ?? state.baseCurrency;
+    const formatOptions = isFormatPriceOptions(fromCurrencyOrOptions) ? fromCurrencyOrOptions : options;
+    return formatPrice(cents, fromCurrency, state, formatOptions);
+  };
+}
+function withGlobalizationHelpers(state, handlers = {}) {
+  return {
+    ...state,
+    t: state.t ?? createTranslator(state.messages, state.locale),
+    p: state.p ?? createPriceFormatter(state),
+    ...handlers
+  };
+}
+function buildGlobalizationUrl(url, updates) {
+  const raw = String(url);
+  const isAbsolute = /^[a-z][a-z\d+\-.]*:/i.test(raw);
+  const parsed = new URL(raw, "https://wordrhyme.local");
+  if (updates.locale === null) {
+    parsed.searchParams.delete("lang");
+  } else if (updates.locale) {
+    parsed.searchParams.set("lang", updates.locale);
+  }
+  if (updates.currency === null) {
+    parsed.searchParams.delete("currency");
+  } else if (updates.currency) {
+    parsed.searchParams.set("currency", updates.currency.toUpperCase());
+  }
+  return isAbsolute ? parsed.toString() : `${parsed.pathname}${parsed.search}${parsed.hash}`;
+}
+
+export {
+  Decimal,
+  DEFAULT_CURRENCY,
+  getTextDirection,
+  normalizeCurrencyInfo,
+  normalizeCurrencies,
+  findCurrency,
+  getBaseCurrency,
+  resolveCurrencyInfo,
+  bankersRound,
+  toCents,
+  fromCents,
+  convertCurrency,
+  formatCurrencyAmount,
+  formatPrice,
+  getI18nText,
+  createTranslator,
+  createPriceFormatter,
+  withGlobalizationHelpers,
+  buildGlobalizationUrl
+};
+//# sourceMappingURL=chunk-BVOTSKM2.js.map