@dogsbay/ssg 0.2.0-beta.139 → 0.2.0-beta.141

package/dist/package/THIRD-PARTY-NOTICES.txt

@@ -1,31 +1,31 @@
 Third-party software in @dogsbay/ssg (dist/package/)
 
 ========================================================================
-@dogsbay/elements@0.2.0-beta.139 (MIT)
+@dogsbay/elements@0.2.0-beta.141 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/primitives@0.2.0-beta.139 (MIT)
+@dogsbay/primitives@0.2.0-beta.141 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/render-html@0.2.0-beta.139 (MIT)
+@dogsbay/render-html@0.2.0-beta.141 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/search@0.2.0-beta.139 (MIT)
+@dogsbay/search@0.2.0-beta.141 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/ui@0.2.0-beta.139 (MIT)
+@dogsbay/ui@0.2.0-beta.141 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.

package/dist/package/browser.mjs

@@ -1085,31 +1085,31 @@ var CLIENT_CANDIDATES = ['""', '"&"', '"\\\\$&")).join("|")})', '"\\\\$&")}"', '
 var SITE_NOTICES = `Third-party software in this site's _dogsbay/ files (dogsbay.js, site.css) and pages
 
 ========================================================================
-@dogsbay/elements@0.2.0-beta.139 (MIT)
+@dogsbay/elements@0.2.0-beta.141 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/primitives@0.2.0-beta.139 (MIT)
+@dogsbay/primitives@0.2.0-beta.141 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/render-html@0.2.0-beta.139 (MIT)
+@dogsbay/render-html@0.2.0-beta.141 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/search@0.2.0-beta.139 (MIT)
+@dogsbay/search@0.2.0-beta.141 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/ui@0.2.0-beta.139 (MIT)
+@dogsbay/ui@0.2.0-beta.141 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
@@ -3486,6 +3486,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
   const diagrams = state.diagrams;
   const taxonomies = cfg.taxonomies.length ? new TaxonomyCollector(cfg.taxonomies) : void 0;
   const blog = cfg.blog ? new BlogCollector(cfg.blog) : void 0;
+  state.scanned?.(unit, "start");
   const infos = /* @__PURE__ */ new Map();
   const stubTargets = /* @__PURE__ */ new Map();
   const frontMatter = /* @__PURE__ */ new Map();
@@ -3782,6 +3783,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
   let search = cfg.search && cfg.searchEngine !== "pagefind" ? new SearchIndexBuilder({ lang: unit.locale ?? cfg.defaultLocale ?? "en" }) : void 0;
   const siteDepthPrefix = unit.prefix ? "../".repeat(unit.prefix.split("/").length) : "";
   phase.scan = (phase.scan ?? 0) + now() - t;
+  state.scanned?.(unit, "end");
   input.onUnitAssets?.(unit.prefix, assetPaths);
   if (diagrams) {
     t = now();
@@ -4879,6 +4881,14 @@ async function openDevSession(input, o = {}) {
   let buildError;
   let buildProblem;
   let diagnosed = /* @__PURE__ */ new Map();
+  let scanProblems = /* @__PURE__ */ new Map();
+  const watchScan = (c, into) => {
+    let from = 0;
+    c.state.scanned = (unit, at) => {
+      if (at === "start") from = c.problems.length;
+      else into.set(unit.prefix, c.problems.slice(from));
+    };
+  };
   const failed = (e) => {
     buildError = e.message || String(e);
     buildProblem = problemOf(e, buildError);
@@ -4887,6 +4897,7 @@ async function openDevSession(input, o = {}) {
     const next = /* @__PURE__ */ new Map();
     const nextUnits = /* @__PURE__ */ new Map();
     const nextDiagnosed = /* @__PURE__ */ new Map();
+    const nextScan = /* @__PURE__ */ new Map();
     let nextCtx;
     const sink = async (path, content) => {
       next.set(path, isStream(content) ? await joinChunks(content.chunks()) : content);
@@ -4908,7 +4919,10 @@ async function openDevSession(input, o = {}) {
         {
           keep: true,
           lazy: o.lazy,
-          context: (c) => nextCtx = c,
+          context: (c) => {
+            nextCtx = c;
+            watchScan(c, nextScan);
+          },
           diagnostics: (f, list) => nextDiagnosed.set(f, list),
           // A copy: the build keeps adding the classes of pages it renders later to its own set.
           unitBuilt: (unit, handle, classes) => nextUnits.set(unit.prefix, { unit, handle, classes: new Set(classes) })
@@ -4922,6 +4936,7 @@ async function openDevSession(input, o = {}) {
     units = nextUnits;
     ctx = nextCtx;
     diagnosed = nextDiagnosed;
+    scanProblems = nextScan;
     config = nextCtx?.cfg ?? nextConfig;
     taken = 0;
     takenProblems = 0;
@@ -5052,7 +5067,11 @@ async function openDevSession(input, o = {}) {
     get,
     async change(paths) {
       const t0 = Date.now();
-      const done = (r) => ({ ...r, ms: Date.now() - t0 });
+      const before = allFiles();
+      const done = (r, marked) => {
+        const stale2 = marked ?? /* @__PURE__ */ new Set([...before, ...allFiles()]);
+        return { ...r, stale: [...stale2].sort(), ms: Date.now() - t0 };
+      };
       try {
         if (buildError !== void 0) {
           await full();
@@ -5060,14 +5079,33 @@ async function openDevSession(input, o = {}) {
           buildProblem = void 0;
           return done({ css: true, handled: "full" });
         }
-        return done(await budgeted(() => changeParts(paths)));
+        const marked = /* @__PURE__ */ new Set();
+        const r = await budgeted(() => changeParts(paths, marked));
+        return done(r, r.handled === "full" ? void 0 : marked);
       } catch (e) {
         failed(e);
-        return done({ css: false, handled: "full" });
+        return done({ css: false, handled: "full" }, /* @__PURE__ */ new Set());
       }
     }
   };
-  async function changeParts(paths) {
+  function allFiles() {
+    const all = /* @__PURE__ */ new Set();
+    for (const u of units.values()) for (const o2 of u.handle.pageOuts) {
+      const src = u.handle.sourceForPage(o2);
+      if (src !== void 0) all.add(src);
+    }
+    for (const list of scanProblems.values()) for (const p of list) if (p.file !== void 0) all.add(p.file);
+    return all;
+  }
+  async function changeParts(paths, marked) {
+    const again = /* @__PURE__ */ new Map();
+    const markStale = (page, u = unitForSitePath(page), rebuilt = false) => {
+      stale.add(page);
+      const src = u?.handle.sourceForPage(page);
+      if (src === void 0) return;
+      marked.add(src);
+      if (!rebuilt) again.set(src, u.unit.prefix);
+    };
     const themeDir = config.themeDir ? config.themeDir.replace(/\/+$/, "") + "/" : void 0;
     const extraCss = new Set(config.css.map((c) => c.replace(/^\.\//, "")));
     const lazy = /* @__PURE__ */ new Set();
@@ -5113,7 +5151,7 @@ async function openDevSession(input, o = {}) {
           }
           x.handle.invalidateData();
           for (const page of x.handle.dataReaders(p)) {
-            stale.add(page);
+            markStale(page, x);
             mark("page");
           }
         }
@@ -5126,7 +5164,7 @@ async function openDevSession(input, o = {}) {
         const page = u.handle.pageForSource(p);
         const text = content === void 0 ? void 0 : await textOf(content);
         if (page && text !== void 0 && u.handle.sameFrontMatter(p, text) && !u.handle.included(p)) {
-          stale.add(page);
+          markStale(page, u);
           mark("page");
         } else {
           u.handle.forget(p);
@@ -5157,21 +5195,30 @@ async function openDevSession(input, o = {}) {
         if (unitForSitePath(key) === u) out.delete(key);
       }
       for (const s of [...stale]) if (unitForSitePath(s) === u) stale.delete(s);
+      for (const o2 of u.handle.pageOuts) {
+        const src = u.handle.sourceForPage(o2);
+        if (src !== void 0) marked.add(src);
+      }
+      const named = (list) => {
+        for (const p of list ?? []) if (p.file !== void 0) marked.add(p.file);
+      };
+      named(scanProblems.get(prefix));
       const handle = await rebuildUnitLazy({ ...ctx, emit: emitInto }, u.unit);
+      named(scanProblems.get(prefix));
       const next = { ...u, handle };
       units.set(prefix, next);
-      for (const o2 of handle.pageOuts) stale.add(o2);
+      for (const o2 of handle.pageOuts) markStale(o2, next, true);
     }
     if (config.defaultVersion && [...lazy].some((prefix) => units.get(prefix)?.unit.version === config.defaultVersion)) {
       const all = [...units.values()].map((u) => u.unit);
       ctx.state.canonical = await defaultTables(config, all, all, input.files, readText);
-      for (const u of units.values()) if (u.unit.version !== config.defaultVersion) for (const o2 of u.handle.pageOuts) stale.add(o2);
+      for (const u of units.values()) if (u.unit.version !== config.defaultVersion) for (const o2 of u.handle.pageOuts) markStale(o2, u);
     }
     if (lazy.size && ctx.state.languages) {
       const all = [...units.values()].map((u) => u.unit);
       const versions = new Set([...lazy].map((prefix) => units.get(prefix)?.unit.version));
       ctx.state.languages = await languageTables(config, all, all, input.files, readText);
-      for (const u of units.values()) if (versions.has(u.unit.version) && !lazy.has(u.unit.prefix)) for (const o2 of u.handle.pageOuts) stale.add(o2);
+      for (const u of units.values()) if (versions.has(u.unit.version) && !lazy.has(u.unit.prefix)) for (const o2 of u.handle.pageOuts) markStale(o2, u);
     }
     if (lazy.size) {
       const all = [...units.values()].map((u) => u.unit);
@@ -5187,6 +5234,14 @@ async function openDevSession(input, o = {}) {
         (p) => stale.has(p)
       );
     }
+    for (const [src, prefix] of again) {
+      if (lazy.has(prefix)) continue;
+      for (const p of scanProblems.get(prefix) ?? []) {
+        if (p.file !== src) continue;
+        ctx.problems.push(p);
+        ctx.warnings.push(p.text);
+      }
+    }
     return { css: false, handled };
   }
   async function attributesOnly() {

package/dist/package/types/core/build.d.ts

@@ -226,6 +226,8 @@ export interface SiteState {
     stubs: string[];
     /** A dev session's: what pass 1 read from each page, kept between its rebuilds (src/core/scan-cache.ts). */
     scan?: ScanCache;
+    /** A dev session's: called as each unit's pass 1 starts and ends, so it knows which problems pass 1 reported (src/core/dev.ts). */
+    scanned?: (unit: BuildUnit, at: "start" | "end") => void;
     /** Included templates' parses (false: none kept), kept as long as the state: a dev session's unit rebuilds keep it. */
     parseCache: ParseCache | false;
     /** Template time left for the build, or for a dev session's current request. */

package/dist/package/types/core/dev.d.ts

@@ -76,6 +76,15 @@ export interface ChangeResult {
      * their pages), `page` (pages marked stale), `asset` (files replaced), `none` (nothing it builds).
      */
     handled: "full" | "unit" | "page" | "asset" | "none";
+    /**
+     * The source files (project paths) of the pages whose earlier warnings no longer stand: drop
+     * them, then read `takeProblems()`. A listed page that still exists renders again when asked for
+     * (`get`, `diagnostics`), and its warnings are in `takeProblems()` once that resolves, so one that
+     * brings none is clean. Removed pages are listed too. After a `full` change, every page before
+     * and after, and `takeProblems()` starts again from the first. Pages with no source file (tag
+     * pages, translation stubs) are not listed; pages not listed keep their warnings.
+     */
+    stale: string[];
     ms: number;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/ssg",
-  "version": "0.2.0-beta.139",
+  "version": "0.2.0-beta.141",
   "type": "module",
   "description": "Documentation static site generator for Dogsbay-MD that builds inside Cloudflare Workers and publishes sites that work offline",
   "license": "Apache-2.0",
@@ -49,38 +49,38 @@
     "tailwindcss": "^4.3.2"
   },
   "peerDependencies": {
-    "@dogsbay/elements": "0.2.0-beta.139",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.139",
-    "@dogsbay/format-openapi": "0.2.0-beta.139",
-    "@dogsbay/format-topicmap": "0.2.0-beta.139",
-    "@dogsbay/highlight": "0.2.0-beta.139",
-    "@dogsbay/minja": "0.2.0-beta.139",
-    "@dogsbay/primitives": "0.2.0-beta.139",
-    "@dogsbay/render-html": "0.2.0-beta.139",
-    "@dogsbay/search": "0.2.0-beta.139",
-    "@dogsbay/serialize-core": "0.2.0-beta.139",
-    "@dogsbay/site-check": "0.2.0-beta.139",
-    "@dogsbay/site-files": "0.2.0-beta.139",
-    "@dogsbay/types": "0.2.0-beta.139"
+    "@dogsbay/elements": "0.2.0-beta.141",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.141",
+    "@dogsbay/format-openapi": "0.2.0-beta.141",
+    "@dogsbay/format-topicmap": "0.2.0-beta.141",
+    "@dogsbay/highlight": "0.2.0-beta.141",
+    "@dogsbay/minja": "0.2.0-beta.141",
+    "@dogsbay/primitives": "0.2.0-beta.141",
+    "@dogsbay/render-html": "0.2.0-beta.141",
+    "@dogsbay/search": "0.2.0-beta.141",
+    "@dogsbay/serialize-core": "0.2.0-beta.141",
+    "@dogsbay/site-check": "0.2.0-beta.141",
+    "@dogsbay/site-files": "0.2.0-beta.141",
+    "@dogsbay/types": "0.2.0-beta.141"
   },
   "devDependencies": {
     "@axe-core/playwright": "^4.12.1",
     "@cloudflare/workers-types": "^5.20260921.1",
-    "@dogsbay/elements": "0.2.0-beta.139",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.139",
-    "@dogsbay/format-openapi": "0.2.0-beta.139",
-    "@dogsbay/format-topicmap": "0.2.0-beta.139",
-    "@dogsbay/highlight": "0.2.0-beta.139",
-    "@dogsbay/icons": "0.2.0-beta.139",
-    "@dogsbay/minja": "0.2.0-beta.139",
-    "@dogsbay/primitives": "0.2.0-beta.139",
-    "@dogsbay/render-html": "0.2.0-beta.139",
-    "@dogsbay/search": "0.2.0-beta.139",
-    "@dogsbay/serialize-core": "0.2.0-beta.139",
-    "@dogsbay/site-check": "0.2.0-beta.139",
-    "@dogsbay/site-files": "0.2.0-beta.139",
-    "@dogsbay/types": "0.2.0-beta.139",
-    "@dogsbay/ui": "0.2.0-beta.139",
+    "@dogsbay/elements": "0.2.0-beta.141",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.141",
+    "@dogsbay/format-openapi": "0.2.0-beta.141",
+    "@dogsbay/format-topicmap": "0.2.0-beta.141",
+    "@dogsbay/highlight": "0.2.0-beta.141",
+    "@dogsbay/icons": "0.2.0-beta.141",
+    "@dogsbay/minja": "0.2.0-beta.141",
+    "@dogsbay/primitives": "0.2.0-beta.141",
+    "@dogsbay/render-html": "0.2.0-beta.141",
+    "@dogsbay/search": "0.2.0-beta.141",
+    "@dogsbay/serialize-core": "0.2.0-beta.141",
+    "@dogsbay/site-check": "0.2.0-beta.141",
+    "@dogsbay/site-files": "0.2.0-beta.141",
+    "@dogsbay/types": "0.2.0-beta.141",
+    "@dogsbay/ui": "0.2.0-beta.141",
     "@mermanjs/web": "0.7.0",
     "@playwright/test": "1.61.1",
     "@types/node": "^22.10.0",