blume 2.0.2 → 2.0.3

package/dist/cli/chunk-akbpwfxc.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/dev-lock.ts"],
+  "sourcesContent": [
+    "import {\n  existsSync,\n  linkSync,\n  mkdirSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\n\nimport { join } from \"pathe\";\n\nimport { resolveRuntimeDir } from \"../core/project.ts\";\nimport { logger } from \"./log.ts\";\n\n/**\n * A best-effort PID lock in the shared `.blume/` runtime dir. `blume dev`\n * regenerates and serves `.blume` continuously, so a concurrent `build`,\n * `eject`, or second `dev` that regenerates or deletes it out from under the\n * running Vite server corrupts the dev session. The lock lets those commands\n * detect a live dev server and refuse — and, because it records the server's\n * port, point the caller (often an agent that just tried to start its own\n * server) at the URL to reuse instead.\n */\n\nexport interface DevLockInfo {\n  pid: number;\n  /** Port the dev server is bound to, when known. */\n  port?: number;\n}\n\nconst lockPath = (outDir: string): string => join(outDir, \"dev.lock\");\n\n/** The mutex a process holds while it clears a stale lock. */\nconst reapPath = (outDir: string): string => join(outDir, \"dev.lock.reap\");\n\n/**\n * How long a lock file that doesn't parse counts as one being written right\n * now. Blume creates a lock with its whole content in place (see\n * {@link createExclusive}), but one left empty or cut off — by a crash, or by\n * an older Blume that opened the file before writing it — would otherwise\n * read as stale the instant it appears. Past this age it's debris.\n */\nconst PARTIAL_LOCK_GRACE_MS = 2000;\n\n/** Pause between claim attempts while another process is mid-claim. */\nconst RETRY_DELAY_MS = 5;\n\nconst pause = (ms: number): void => {\n  // A synchronous sleep: the claim is synchronous, and what it waits on is\n  // another process, so there's nothing in this one to yield to.\n  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);\n};\n\n/** Per-process counter that keeps concurrent temp file names apart. */\nlet tempSequence = 0;\n\n/** A private sibling of `path` to stage a write in. */\nconst tempPath = (path: string): string => {\n  tempSequence += 1;\n  return `${path}.${process.pid}.${tempSequence}.tmp`;\n};\n\n/**\n * Create `path` holding `payload`, atomically and exclusively. The payload\n * goes to a private temp file first, which is then hard-linked into place:\n * the link fails when `path` exists, exactly like a `wx` open, but the file\n * appears with its whole content — no reader ever sees it empty or half\n * written. Returns false when `path` already exists.\n */\nconst createExclusive = (path: string, payload: string): boolean => {\n  const temp = tempPath(path);\n  writeFileSync(temp, payload);\n  try {\n    linkSync(temp, path);\n    return true;\n  } catch (error) {\n    // SAFETY: `linkSync` failures are errno exceptions.\n    if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") {\n      throw error;\n    }\n    return false;\n  } finally {\n    rmSync(temp, { force: true });\n  }\n};\n\n/** Replace `path` with `payload` in one step, so readers see old or new. */\nconst replaceFile = (path: string, payload: string): void => {\n  const temp = tempPath(path);\n  writeFileSync(temp, payload);\n  renameSync(temp, path);\n};\n\n/** A file's text, or null when it doesn't exist (anymore). */\nconst readIfExists = (\n  path: string\n): { raw: string; mtimeMs: number } | null => {\n  try {\n    const raw = readFileSync(path, \"utf-8\");\n    return { mtimeMs: statSync(path).mtimeMs, raw };\n  } catch (error) {\n    // SAFETY: `readFileSync`/`statSync` failures are errno exceptions.\n    if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") {\n      throw error;\n    }\n    return null;\n  }\n};\n\n/** What `JSON.parse` can yield for a lock file body. */\ntype LockFileValue =\n  | string\n  | number\n  | boolean\n  | null\n  | LockFileValue[]\n  | { [key: string]: LockFileValue };\n\nconst isValidPid = (pid: LockFileValue | undefined): pid is number =>\n  typeof pid === \"number\" && Number.isInteger(pid) && pid > 0;\n\nconst isPortNumber = (port: LockFileValue | undefined): port is number =>\n  typeof port === \"number\";\n\nconst isLockRecord = (\n  data: LockFileValue\n): data is { pid?: LockFileValue; port?: LockFileValue } =>\n  typeof data === \"object\" && data !== null;\n\n/**\n * Parse a lock file body. Current locks are JSON (`{\"pid\":123,\"port\":3001}`);\n * a bare integer (the pre-port format) still parses as a pid-only lock.\n */\nconst parseLock = (raw: string): DevLockInfo | null => {\n  let data: LockFileValue;\n  try {\n    data = JSON.parse(raw.trim());\n  } catch {\n    return null;\n  }\n  if (isValidPid(data)) {\n    return { pid: data };\n  }\n  if (isLockRecord(data)) {\n    const { pid, port } = data;\n    if (isValidPid(pid)) {\n      return isPortNumber(port) ? { pid, port } : { pid };\n    }\n  }\n  return null;\n};\n\nconst isProcessAlive = (pid: number): boolean => {\n  try {\n    // Signal 0 probes liveness without actually signaling the process.\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    // EPERM means the process exists but belongs to another user — still\n    // live, so the lock must hold (only ESRCH proves it's gone).\n    // SAFETY: `process.kill` failures are errno exceptions.\n    return (error as NodeJS.ErrnoException).code === \"EPERM\";\n  }\n};\n\n/** What the lock file on a dir says, read once. */\ntype LockState =\n  | { kind: \"absent\" }\n  /** Unparseable but brand new: another process is writing it right now. */\n  | { kind: \"busy\" }\n  | { kind: \"live\"; lock: DevLockInfo }\n  /** A dead holder's lock, or unparseable debris. */\n  | { kind: \"stale\" };\n\nconst inspectLock = (outDir: string): LockState => {\n  const file = readIfExists(lockPath(outDir));\n  if (!file) {\n    return { kind: \"absent\" };\n  }\n  const lock = parseLock(file.raw);\n  if (!lock) {\n    return Date.now() - file.mtimeMs < PARTIAL_LOCK_GRACE_MS\n      ? { kind: \"busy\" }\n      : { kind: \"stale\" };\n  }\n  return isProcessAlive(lock.pid) ? { kind: \"live\", lock } : { kind: \"stale\" };\n};\n\n/**\n * Whether this process may clear the lock to claim the dir: a dead holder's\n * lock and debris, or this process's own leftover.\n */\nconst isClaimable = (state: LockState): boolean =>\n  state.kind === \"stale\" ||\n  (state.kind === \"live\" && state.lock.pid === process.pid);\n\n/**\n * Read the lock on `outDir` held by a live `blume dev`, or null. A lock left\n * by a process that has since exited (stale) is treated as absent.\n */\nexport const readDevLock = (outDir: string): DevLockInfo | null => {\n  const state = inspectLock(outDir);\n  return state.kind === \"live\" ? state.lock : null;\n};\n\n/** Whether another live `blume dev` holds the lock on `outDir`. */\nexport const isDevLocked = (outDir: string): boolean =>\n  readDevLock(outDir) !== null;\n\nconst lockPayload = (port?: number): string => {\n  const info: DevLockInfo = { pid: process.pid };\n  if (port !== undefined) {\n    info.port = port;\n  }\n  return JSON.stringify(info);\n};\n\n/** Thrown when another live `blume dev` already holds the lock. */\nexport class DevLockHeldError extends Error {\n  readonly lock: DevLockInfo;\n\n  constructor(lock: DevLockInfo) {\n    super(`A blume dev server (pid ${lock.pid}) already holds the lock.`);\n    this.name = \"DevLockHeldError\";\n    this.lock = lock;\n  }\n}\n\nconst ownsLock = (outDir: string): boolean => {\n  const path = lockPath(outDir);\n  if (!existsSync(path)) {\n    return false;\n  }\n  try {\n    return parseLock(readFileSync(path, \"utf-8\"))?.pid === process.pid;\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Clear a claimable lock without racing anyone else doing the same. Two\n * processes can both read the same stale lock; if each simply deleted the\n * file, the slower one could delete the lock the faster one had claimed in\n * between, and both would win. So removing a lock takes the reap mutex\n * (created the same atomic way), and whoever holds it reads the lock again\n * first: a live lock claimed since is left alone. A mutex whose holder died\n * mid-reap is cleared for the next attempt.\n */\nconst reapStaleLock = (outDir: string): void => {\n  const mutex = reapPath(outDir);\n  if (!createExclusive(mutex, lockPayload())) {\n    const holder = readIfExists(mutex);\n    const pid = holder ? parseLock(holder.raw)?.pid : undefined;\n    if (pid !== undefined && pid !== process.pid && isProcessAlive(pid)) {\n      pause(RETRY_DELAY_MS);\n    } else if (holder) {\n      rmSync(mutex, { force: true });\n    }\n    return;\n  }\n  try {\n    if (isClaimable(inspectLock(outDir))) {\n      rmSync(lockPath(outDir), { force: true });\n    }\n  } finally {\n    rmSync(mutex, { force: true });\n  }\n};\n\n/**\n * Write the current process's dev lock into `outDir` and return a release\n * function. Two `blume dev` processes starting at the same moment can't both\n * win: the lock appears whole and exclusively (a hard link, which fails when\n * the file exists), a lock still being written is waited on rather than read\n * as stale, and a stale lock (dead pid) or this process's own leftover is only\n * cleared under the reap mutex — the loser gets a {@link DevLockHeldError}\n * naming the live holder. The release only removes the file if it's still\n * ours, so a newer dev server's lock is never clobbered.\n */\nexport const acquireDevLock = (outDir: string, port?: number): (() => void) => {\n  mkdirSync(outDir, { recursive: true });\n  const payload = lockPayload(port);\n  while (!createExclusive(lockPath(outDir), payload)) {\n    const state = inspectLock(outDir);\n    if (isClaimable(state)) {\n      reapStaleLock(outDir);\n    } else if (state.kind === \"live\") {\n      throw new DevLockHeldError(state.lock);\n    } else if (state.kind === \"busy\") {\n      pause(RETRY_DELAY_MS);\n    }\n    // \"absent\": the holder released it just now — race for the claim again.\n  }\n  let released = false;\n  return () => {\n    if (released) {\n      return;\n    }\n    released = true;\n    try {\n      if (ownsLock(outDir)) {\n        rmSync(lockPath(outDir), { force: true });\n      }\n    } catch {\n      // Best-effort cleanup; a stale lock is handled by the liveness check.\n    }\n  };\n};\n\n/**\n * Rewrite this process's lock with the port the server actually bound (the\n * lock is acquired before the server starts, and Vite may bump a busy port).\n * A lock owned by another process is left alone.\n */\nexport const updateDevLockPort = (outDir: string, port: number): void => {\n  if (ownsLock(outDir)) {\n    // Replaced in one step: rewriting in place would leave a moment where a\n    // concurrent claim reads an empty lock.\n    replaceFile(lockPath(outDir), lockPayload(port));\n  }\n};\n\n/** Human-readable location of a locked dev server, e.g. \" at http://localhost:3001\". */\nexport const describeDevLock = (lock: DevLockInfo): string =>\n  lock.port === undefined ? \"\" : ` at http://localhost:${lock.port}`;\n\n/**\n * Exit with an error when a live `blume dev` owns the runtime dir under `root`.\n * `action` names the operation being refused (e.g. \"building\"). `runtimeDir`\n * relocates the checked dir: an isolated verify (`.blume-verify`) targets a dir\n * dev never locks, so it proceeds; a default or `--runtime-dir .blume` run still\n * refuses. Only commands that actually accept `--isolated` (build, check) should\n * set `isolatedHint`, so the refusal never suggests a flag the command ignores.\n */\nexport const refuseIfDevRunning = (\n  root: string,\n  action: string,\n  options: { runtimeDir?: string; isolatedHint?: boolean } = {}\n): void => {\n  const lock = readDevLock(resolveRuntimeDir(root, options.runtimeDir));\n  if (lock) {\n    const remedies = options.isolatedHint\n      ? \"Reuse that server, stop it first, or re-run with --isolated to build/verify against .blume-verify without touching it.\"\n      : \"Reuse that server or stop it first.\";\n    logger.error(\n      `A \\`blume dev\\` server is running${describeDevLock(lock)}; ${action} would corrupt its .blume runtime. ${remedies}`\n    );\n    process.exit(1);\n  }\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "BA0F0BBCC7BD124F64756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-sqw4ekg1.js → chunk-b07cmahc.js}

@@ -5,7 +5,7 @@ import {
 import {
   commandsFor,
   detectProjectPackageManager
-} from "./chunk-v6ya5kcb.js";
+} from "./chunk-pv29h0wf.js";
 
 // src/astro/islands.ts
 import { readFile } from "node:fs/promises";
@@ -142,4 +142,4 @@ var missingDependencyDiagnostic = async (config, root, severity, frameworks = []
 export { readClientMode, discoverIslands, missingDependencyDiagnostic };
 
 //# debugId=137E521D7DE6F81064756E2164756E21
-//# sourceMappingURL=chunk-sqw4ekg1.js.map
+//# sourceMappingURL=chunk-b07cmahc.js.map

package/dist/cli/{chunk-xh43dwgw.js → chunk-c8chx29p.js}

@@ -6,6 +6,7 @@ import {
   enrichDiagnostic
 } from "./index.js";
 import {
+  resolveFallbackLocale,
   OPENAPI_PATH,
   API_PAGES_PATH,
   API_PAGE_PATH,
@@ -26,7 +27,6 @@ import {
   routeIsTaken,
   hasGeneratedChangelog,
   customOgRoutes,
-  resolveFallbackLocale,
   resolveAskBackend,
   GOOGLE_FONTS,
   isFontSlug,
@@ -49,22 +49,23 @@ import {
   isOpenApiSource,
   buildRawMarkdown,
   markdownRoutePaths
-} from "./chunk-v6ya5kcb.js";
+} from "./chunk-pv29h0wf.js";
 import {
   trimChar,
   normalizeBasePath,
   withBasePath,
+  mountBasePath,
   siteRoot,
   absoluteUrl2
-} from "./chunk-gs7r695n.js";
+} from "./chunk-3em5wd2y.js";
 import {
   validateSearchPopularIcons,
   validateNavTargets
-} from "./chunk-5r8g91qn.js";
+} from "./chunk-j85vccga.js";
 import {
   buildSearchDocuments,
   buildMcpData
-} from "./chunk-ddndchfr.js";
+} from "./chunk-yfyb25rh.js";
 import {
   planComponentSlots,
   publishRuntimeModules,
@@ -104,22 +105,22 @@ import {
   examplesPageTemplate,
   runtimePackageTemplate,
   runtimeTsconfigTemplate
-} from "./chunk-hr8ne106.js";
+} from "./chunk-5m5nmvyq.js";
 import {
   emptyComponentOverrides,
   analyzeComponentOverrides
-} from "./chunk-00gs3wqs.js";
+} from "./chunk-8ktnccpt.js";
 import {
   writeTextAtomic
 } from "./chunk-jq5n4avg.js";
 import {
   registry
-} from "./chunk-fsmrqk8a.js";
+} from "./chunk-r20tn01b.js";
 import {
   readClientMode,
   discoverIslands,
   missingDependencyDiagnostic
-} from "./chunk-sqw4ekg1.js";
+} from "./chunk-b07cmahc.js";
 
 // src/astro/integration.ts
 import { join as join3, relative, resolve as resolve2 } from "pathe";
@@ -156,18 +157,29 @@ var publishDevNegotiation = (negotiation) => {
     homeLinkHeader: negotiation.homeLinkHeader
   } : null;
 };
+var overlayChannelOf = (server) => server?.ws ?? server?.hot;
+var DATA_STORE_MODULE_ID = "\x00astro:data-layer-content";
+var invalidateDataStore = (server) => {
+  for (const { moduleGraph } of Object.values(server.environments)) {
+    const mod = moduleGraph.getModuleById(DATA_STORE_MODULE_ID);
+    if (mod) {
+      moduleGraph.invalidateModule(mod);
+    }
+  }
+  overlayChannelOf(server)?.send({ type: "full-reload" });
+};
 var refreshBlumeContent = async () => {
-  const { refreshContent } = registry2();
+  const { overlay, refreshContent } = registry2();
   if (!refreshContent) {
     return false;
   }
   await refreshContent({});
+  if (overlay) {
+    invalidateDataStore(overlay);
+  }
   return true;
 };
-var overlayChannel = () => {
-  const { overlay } = registry2();
-  return overlay?.ws ?? overlay?.hot;
-};
+var overlayChannel = () => overlayChannelOf(registry2().overlay);
 var showBlumeErrorOverlay = (diagnostics) => {
   const errors = [];
   for (const diagnostic of diagnostics) {
@@ -774,7 +786,7 @@ var buildApiSpec = (input) => {
   if (input.site) {
     document.externalDocs = {
       description: `${input.name} documentation`,
-      url: absoluteUrl2(input.site, withBasePath(input.base, "/"))
+      url: absoluteUrl2(input.site, mountBasePath(input.base, "/"))
     };
   }
   return document;
@@ -1270,10 +1282,14 @@ var localeFamily = (locale) => {
   }
   return localeFontSubsets([locale]).length > 1 ? "Noto Sans" : null;
 };
-var localeOgFonts = (locales) => {
+var DEFAULT_FALLBACKS = [
+  "Noto Sans",
+  ...new Set(Object.values(SCRIPT_FAMILIES)),
+  "Noto Sans TC"
+];
+var ogFallbackFonts = (locales) => {
   const names = new Set;
-  for (const locale of locales) {
-    const family = localeFamily(locale);
+  for (const family of [...locales.map(localeFamily), ...DEFAULT_FALLBACKS]) {
     if (family) {
       names.add(family);
     }
@@ -1282,18 +1298,15 @@ var localeOgFonts = (locales) => {
 };
 var isGoogleFamilyName = (font) => typeof font === "string";
 var ogFontName = (font) => isGoogleFamilyName(font) ? font : font.name;
-var withLocaleFonts = (derived, locales) => {
+var withFallbacks = (derived, locales) => {
   const loaded = new Set(derived.fonts.map(ogFontName));
-  const fallbacks = localeOgFonts(locales).filter((font) => !loaded.has(ogFontName(font)));
-  if (fallbacks.length === 0) {
-    return derived;
-  }
   return {
+    fallbacks: ogFallbackFonts(locales).filter((font) => !loaded.has(font.name)),
     families: derived.families ?? {
       body: BUILT_IN_FAMILY,
       title: BUILT_IN_FAMILY
     },
-    fonts: [...derived.fonts, ...fallbacks]
+    fonts: derived.fonts
   };
 };
 var resolveOgFontSources = (fonts, root) => fonts.map((font) => isLocalOgFont(font) ? { ...font, src: absoluteSrc(root, font.src) } : font);
@@ -1302,7 +1315,7 @@ var resolveOgFonts = (options, root) => {
     return { fonts: resolveOgFontSources(options.ogFonts, root) };
   }
   const derived = options.themeFontsConfigured ? deriveOgFonts(options.themeFonts, root) : { fonts: [] };
-  return withLocaleFonts(derived, options.locales ?? []);
+  return withFallbacks(derived, options.locales ?? []);
 };
 var missingFontFiles = (options, root) => {
   const sources = [];
@@ -3442,7 +3455,7 @@ var generateRuntime = async (project) => {
   const modules = new Map;
   const depsLinkWarning = await ensureDepsLink(out);
   const contentRoutes = markdownRoutePaths(project);
-  const homeLinkHeader = buildHomeLinkHeader(config, contentRoutes) ?? undefined;
+  const homeLinkHeader = buildHomeLinkHeader(config, contentRoutes, "dev") ?? undefined;
   const assistantEnabled = config.ai.assistant?.enabled ?? false;
   const exportPdf = config.export.pdf;
   const exportEpub = config.export.epub;
@@ -3673,7 +3686,7 @@ var generateRuntime = async (project) => {
   return { structuralChange: structural.some(Boolean), warnings };
 };
 
-export { publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, ogCacheDir, pruneCardCache, cardCacheTally, buildAskData, buildThemeCss, buildReferenceFiles, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, packageDirFrom, detectNeedsReact, detectUsesMath, collectStaged, buildRuntimeData, PLAYGROUND_PROXY_ENTRY, playgroundProxyPattern, specOrigins, proxyAllowlistWarnings, analyzeComponentsFile, languageIconCssFor, clientFeaturesFor, generateRuntime };
+export { publishBuildProject, refreshBlumeContent, showBlumeErrorOverlay, ogCacheDir, pruneCardCache, cardCacheTally, buildApiSpec, buildAskData, resolveOgFonts, buildThemeCss, buildReferenceFiles, tailwindEntryTemplate, examplesEntryTemplate, rebaseSourceDirectives, twoslashCss, EXAMPLE_SCAN_GLOB, exampleScanRoots, discoverExamples, exampleMarkdownLookup, packageDirFrom, detectNeedsReact, detectUsesMath, collectStaged, buildRuntimeData, PLAYGROUND_PROXY_ENTRY, playgroundProxyPattern, specOrigins, proxyAllowlistWarnings, analyzeComponentsFile, languageIconCssFor, clientFeaturesFor, generateRuntime };
 
-//# debugId=0D8B04D4ECFE76CE64756E2164756E21
-//# sourceMappingURL=chunk-xh43dwgw.js.map
+//# debugId=067C177A5C0052FA64756E2164756E21
+//# sourceMappingURL=chunk-c8chx29p.js.map