@dogsbay/ssg 0.2.0-beta.144 → 0.2.0-beta.146

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.144 (MIT)
+@dogsbay/elements@0.2.0-beta.146 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/primitives@0.2.0-beta.144 (MIT)
+@dogsbay/primitives@0.2.0-beta.146 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/render-html@0.2.0-beta.144 (MIT)
+@dogsbay/render-html@0.2.0-beta.146 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/search@0.2.0-beta.144 (MIT)
+@dogsbay/search@0.2.0-beta.146 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/ui@0.2.0-beta.144 (MIT)
+@dogsbay/ui@0.2.0-beta.146 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.

package/dist/package/browser.mjs

@@ -18,6 +18,7 @@ import {
 
 // src/core/build.ts
 import { dogsbayMdToTree, splitFrontmatter as splitFrontmatter2, treeToDogsbayMd } from "@dogsbay/format-dogsbay-md/browser";
+import { mergeHeaders, mergeRedirects, productRootRedirects, siteFiles, siteRootTarget, toScript, unitOf } from "@dogsbay/site-files";
 import { buildHreflangLinks, isMountRoot, missingTranslations, mountRefs, mountRootNote, namespaceNavGroup, namespacePrefixes, placeMountedNav, prefixSlug as prefixSlug2, rewriteContentRefs } from "@dogsbay/site-files";
 
 // src/core/canonical.ts
@@ -26,7 +27,7 @@ import { declaresParams, splitFrontmatter } from "@dogsbay/format-dogsbay-md/bro
 
 // src/core/config.ts
 import { scriptUrl } from "@dogsbay/render-html";
-import { assertLeafSitemap, checkVersionSeo, isNamespaceAxisActive, namespaceSegments, parseMount } from "@dogsbay/site-files";
+import { assertLeafSitemap, checkVersionSeo, isNamespaceAxisActive, namespaceSegments, parseMount, ProductConfigError, productModel, productOf, sourceNamespace, sourceUnit, unitSegments } from "@dogsbay/site-files";
 
 // src/core/yaml.ts
 import { load } from "js-yaml";
@@ -36,6 +37,17 @@ function loadYaml(text) {
 }
 
 // src/core/config.ts
+function shared(f) {
+  try {
+    return f();
+  } catch (e) {
+    if (e instanceof ProductConfigError) throw new ConfigError(e.message);
+    throw e;
+  }
+}
+function versionsOf(cfg, product) {
+  return cfg.productVersions?.get(product ?? "") ?? { versions: cfg.versions, defaultVersion: cfg.defaultVersion };
+}
 var ConfigError = class extends Error {
 };
 function sourceTemplates(v, path) {
@@ -67,10 +79,10 @@ function unitId(kind, v) {
   if (!/^[a-z0-9][a-z0-9._-]*$/i.test(id)) throw new ConfigError(`${kind}: id "${id.slice(0, 80)}" must be one URL segment of letters, digits, dots, dashes and underscores`);
   return id;
 }
-function sourceMount(s) {
+function sourceMount(s, products) {
   const at = `content.sources[${String(s.path)}]`;
   if (s.from !== "openapi") throw new ConfigError(`${at}: mount is only for a "from: openapi" source`);
-  if (s.name != null) throw new ConfigError(`${at} has both name and mount: a mounted source goes inside its version, so it takes no name`);
+  if (s.name != null && !products) throw new ConfigError(`${at} has both name and mount: a mounted source goes inside its version, so it takes no name (with content.products:, it names its product)`);
   const parsed = parseMount(s.mount);
   if ("error" in parsed) throw new ConfigError(`${at}: ${parsed.error}`);
   return parsed.segments.join("/");
@@ -140,6 +152,7 @@ function parseConfig(text, overrides = {}) {
   if (navMode !== void 0 && navMode !== "client" && navMode !== "ssr-full") throw new ConfigError(`build.navMode must be "client" or "ssr-full"; got ${JSON.stringify(navMode)}`);
   const site = raw.site ?? {};
   const content = raw.content ?? {};
+  const productsBlock = content.products != null;
   const ssg = raw.ssg ?? {};
   const agent = raw.agent ?? {};
   const signal = agent.contentSignal ?? {};
@@ -147,7 +160,7 @@ function parseConfig(text, overrides = {}) {
     path: sourcePath(s),
     ...s.name != null ? { name: sourceName(s.name) } : {},
     ...s.from != null ? { from: sourceFrom(s.from, String(s.path)) } : {},
-    ...s.mount != null ? { mount: sourceMount(s) } : {},
+    ...s.mount != null ? { mount: sourceMount(s, productsBlock) } : {},
     version: s.version != null ? unitId("version", s.version) : void 0,
     locale: s.locale != null ? unitId("locale", s.locale) : void 0,
     attributes: s.attributes ?? void 0,
@@ -164,7 +177,7 @@ function parseConfig(text, overrides = {}) {
     hidden: v.hidden || void 0,
     removed: removedOf(v.removed, String(v.id)),
     ...versionSeoOf(v, String(v.id)),
-    ...versionPathOf(v, String(v.id))
+    ...versionPathOf(v, String(v.id), productsBlock)
   }));
   const locales = (content.locales ?? raw.locales ?? []).map((l) => ({
     id: unitId("locales", l.id),
@@ -267,6 +280,7 @@ function parseConfig(text, overrides = {}) {
     }
     if (dv.noindex) throw new ConfigError(`versions: "${dv.id}" is the defaultVersion and has noindex: true; older versions' pages name it as their canonical`);
   }
+  if (productsBlock) Object.assign(cfg, productsOf(content, raw, cfg));
   return cfg;
 }
 var TAG_COLORS = /* @__PURE__ */ new Set(["blue", "amber", "emerald", "violet", "rose", "slate"]);
@@ -392,11 +406,41 @@ function versionSeoOf(v, id) {
     ...typeof v.sitemap === "boolean" ? { sitemap: v.sitemap } : {}
   };
 }
-function versionPathOf(v, id) {
+function versionPathOf(v, id, products = false) {
   if (v.path === void 0 || v.path === null) return {};
-  if (v.path !== "") throw new ConfigError(`versions: "${id}".path can only be "" (serve the version at the root)`);
+  if (products && v.path !== "") return { path: String(v.path) };
+  if (v.path !== "") throw new ConfigError(`versions: "${id}".path can only be "" (serve the version at the root); another segment needs content.products:`);
   return { path: "" };
 }
+function productsOf(content, raw, cfg) {
+  const siteVersions = content.versions ?? raw.versions;
+  const written = (Array.isArray(content.sources) ? content.sources : []).filter((s) => typeof s?.path === "string");
+  const sources = written.length ? written : [{ path: "content" }];
+  const model = shared(() => productModel({ products: content.products, sources, versions: siteVersions, defaultVersion: content.defaultVersion ?? raw.defaultVersion, locales: cfg.locales, defaultLocale: cfg.defaultLocale }));
+  if (!model) return {};
+  const productVersions = /* @__PURE__ */ new Map();
+  for (const p of model.products) {
+    const rawList = (p.name ? content.products[p.name]?.versions : void 0) ?? siteVersions ?? [];
+    const versions = p.versions.map((v) => {
+      const r = rawList.find((x) => String(x?.id) === v.id) ?? {};
+      return {
+        id: v.id,
+        label: v.label,
+        ...v.eol ? { eol: true } : {},
+        ...v.prerelease ? { prerelease: true } : {},
+        ...v.hidden ? { hidden: true } : {},
+        ...r.removed != null ? { removed: removedOf(r.removed, v.id) } : {},
+        ...v.canonical ? { canonical: v.canonical } : {},
+        ...v.noindex !== void 0 ? { noindex: v.noindex } : {},
+        ...v.sitemap !== void 0 ? { sitemap: v.sitemap } : {},
+        ...v.path !== v.id ? { path: v.path } : {},
+        ...v.banner ? { banner: v.banner } : {}
+      };
+    });
+    productVersions.set(p.name ?? "", { versions, ...p.defaultVersion ? { defaultVersion: p.defaultVersion } : {} });
+  }
+  return { products: model, productVersions };
+}
 function unitOfPath(units, sitePath2) {
   let best;
   for (const u of units) {
@@ -406,7 +450,12 @@ function unitOfPath(units, sitePath2) {
   }
   return best;
 }
+function groupPrefix(u) {
+  return [u.product, u.locale].filter(Boolean).join("/");
+}
+var sameProduct = (a, b) => (a.product ?? "") === (b.product ?? "");
 function buildUnits(cfg) {
+  if (cfg.products) return productUnits(cfg, cfg.products);
   const withDefaults2 = cfg.sources.map((s) => ({
     source: s,
     version: s.version ?? cfg.defaultVersion,
@@ -424,26 +473,26 @@ function buildUnits(cfg) {
     }
   }
   const namespaces = isNamespaceAxisActive(cfg.sources.filter((s) => !s.mount));
-  if (namespaces && (versionAxis || localeAxis)) {
-    throw new ConfigError("named sources (content.sources name:) cannot be combined with versions or locales yet (plans/openapi-sources.md)");
-  }
+  const products = namespaces && (versionAxis || localeAxis);
   for (const s of cfg.sources) {
     if (s.from === "openapi" && cfg.sources.length > 1 && !s.name && !s.mount) throw new ConfigError(`content.sources[${s.path}]: an OpenAPI source beside other sources needs a name: or a mount:, so its pages do not land on theirs`);
   }
   const units = /* @__PURE__ */ new Map();
   for (const u of withDefaults2) {
     const atRoot = cfg.versions.find((v) => v.id === u.version)?.path === "";
-    const prefix = [localeAxis ? u.locale : void 0, versionAxis && !atRoot ? u.version : void 0].filter(Boolean).join("/");
-    const member = u.source.mount ? { source: u.source, namespace: "", mount: u.source.mount } : { source: u.source, namespace: namespaceSegments(u.source, cfg.sources).join("/") };
+    const product = products && !u.source.mount ? sourceNamespace(u.source) : void 0;
+    const prefix = [product, localeAxis ? u.locale : void 0, versionAxis && !atRoot ? u.version : void 0].filter(Boolean).join("/");
+    const member = u.source.mount ? { source: u.source, namespace: "", mount: u.source.mount } : { source: u.source, namespace: products ? "" : namespaceSegments(u.source, cfg.sources).join("/") };
     const unit = units.get(prefix);
     if (!unit) {
-      units.set(prefix, { source: u.source, members: [member], version: versionAxis ? u.version : void 0, locale: localeAxis ? u.locale : void 0, prefix });
+      units.set(prefix, { source: u.source, members: [member], version: versionAxis ? u.version : void 0, ...versionAxis && u.version ? { versionPath: atRoot ? "" : u.version } : {}, locale: localeAxis ? u.locale : void 0, ...product ? { product } : {}, prefix });
       continue;
     }
     if (member.mount) {
       const taken = unit.members.find((m) => m.mount === member.mount);
       if (taken) throw new ConfigError(`two sources are mounted at "${member.mount}" in the same version and locale (${taken.source.path}, ${u.source.path})`);
     } else if (unit.members.some((m) => !m.mount)) {
+      if (products) throw new ConfigError(`two sources publish to "${prefix || "/"}" (${unit.members.find((m) => !m.mount).source.path}, ${u.source.path}): give each its own name, version or locale`);
       if (!namespaces) throw new ConfigError(`two sources publish to the same prefix "${prefix || "/"}"`);
       if (unit.members.some((m) => !m.mount && m.namespace === member.namespace)) {
         throw new ConfigError(member.namespace ? `two sources are named "${member.namespace}"` : `two unnamed sources publish to the same prefix "${prefix || "/"}"`);
@@ -453,6 +502,16 @@ function buildUnits(cfg) {
     const main = unit.members.find((m) => m.source === unit.source);
     if (!member.namespace && !member.mount && (main.namespace || main.mount)) unit.source = u.source;
   }
+  if (products) {
+    const names = new Set([...units.values()].map((u) => u.product).filter(Boolean));
+    for (const unit of units.values()) {
+      const main = unit.members.find((m) => !m.mount);
+      for (const m of unit.members.filter((x) => x.mount)) {
+        if (!main) throw new ConfigError(`content.sources[${m.source.path}]: a mounted source goes beside the unnamed source of its version and locale, and there is none at "${unit.prefix || "/"}"; a mount inside a named source's version is not supported yet`);
+        if (names.has(m.mount.split("/")[0])) throw new ConfigError(`content.sources[${m.source.path}]: mount "${m.mount}" starts with the name of a source, where that source's pages are; mount it elsewhere`);
+      }
+    }
+  }
   for (const unit of units.values()) {
     for (const m of unit.members) {
       const ns = m.mount && unit.members.find((o) => o.namespace && m.mount.split("/")[0] === o.namespace);
@@ -461,6 +520,43 @@ function buildUnits(cfg) {
   }
   return [...units.values()];
 }
+function productUnits(cfg, model) {
+  const units = /* @__PURE__ */ new Map();
+  for (const s of cfg.sources) {
+    const key = shared(() => sourceUnit(model, s, cfg.defaultLocale));
+    const prefix = shared(() => unitSegments(model, key)).join("/");
+    const member = s.mount ? { source: s, namespace: "", mount: s.mount } : { source: s, namespace: "" };
+    const unit = units.get(prefix);
+    if (!unit) {
+      const versionPath = key.version === void 0 ? void 0 : shared(() => productOf(model, key.product)).versions.find((v) => v.id === key.version)?.path;
+      units.set(prefix, {
+        source: s,
+        members: [member],
+        ...key.version !== void 0 ? { version: key.version, versionPath } : {},
+        ...key.locale !== void 0 ? { locale: key.locale } : {},
+        ...key.product ? { product: key.product } : {},
+        prefix
+      });
+      continue;
+    }
+    if (member.mount) {
+      const taken = unit.members.find((m) => m.mount === member.mount);
+      if (taken) throw new ConfigError(`two sources are mounted at "${member.mount}" in the same version and locale (${taken.source.path}, ${s.path})`);
+    } else if (unit.members.some((m) => !m.mount)) {
+      throw new ConfigError(`two sources publish to "${prefix || "/"}" (${unit.members.find((m) => !m.mount).source.path}, ${s.path}): give each its own name, version or locale`);
+    }
+    unit.members.push(member);
+    if (!member.mount) unit.source = s;
+  }
+  const names = new Set(model.products.map((p) => p.name).filter(Boolean));
+  for (const unit of units.values()) {
+    if (unit.prefix !== "") continue;
+    for (const m of unit.members) {
+      if (m.mount && names.has(m.mount.split("/")[0])) throw new ConfigError(`content.sources[${m.source.path}]: mount "${m.mount}" starts with the name of a product, where that product's pages are; mount it elsewhere`);
+    }
+  }
+  return [...units.values()];
+}
 function memberPath(unit, projectPath2) {
   let best;
   for (const m of unit.members) {
@@ -1069,16 +1165,19 @@ function parseFrontMatter(text) {
     return {};
   }
 }
+var tableKey = (u) => u.product ? `${u.product}\0${u.locale ?? ""}` : u.locale ?? "";
 async function defaultTables(cfg, units, built, files, read, warn = () => {
 }, fm) {
   const tables = /* @__PURE__ */ new Map();
-  if (!cfg.defaultVersion || !built.some((u) => u.version && u.version !== cfg.defaultVersion)) return tables;
-  for (const unit of units.filter((u) => u.version === cfg.defaultVersion)) {
+  const dv = (u) => versionsOf(cfg, u.product).defaultVersion;
+  const older = (u) => !!u.version && !!dv(u) && u.version !== dv(u);
+  if (!built.some(older)) return tables;
+  for (const unit of units.filter((u) => u.version !== void 0 && u.version === dv(u))) {
     const t = await scan(cfg, unit, units, files, fm ?? frontMatterCache(read), read);
-    if (!t.pages.size && built.some((u) => u.version !== cfg.defaultVersion && u.locale === unit.locale)) {
-      warn(`[canonical] the default version "${cfg.defaultVersion}" has no pages under ${unit.source.path}, so older versions' pages keep themselves as canonical`);
+    if (!t.pages.size && built.some((u) => older(u) && u.locale === unit.locale && sameProduct(u, unit))) {
+      warn(`[canonical] the default version "${dv(unit)}" has no pages under ${unit.source.path}, so older versions' pages keep themselves as canonical`);
     }
-    tables.set(unit.locale ?? "", t);
+    tables.set(tableKey(unit), t);
   }
   return tables;
 }
@@ -1163,11 +1262,12 @@ async function scan(cfg, unit, units, files, frontMatterOf, read, mode = { kind:
   return { prefix: unit.prefix, pages, redirects };
 }
 function pageCanonical(cfg, unit, tables, page, urls) {
-  const table = tables.get(unit.locale ?? "");
-  const version = cfg.versions.find((v) => v.id === unit.version);
+  const table = tables.get(tableKey(unit));
+  const { versions, defaultVersion } = versionsOf(cfg, unit.product);
+  const version = versions.find((v) => v.id === unit.version);
   const fmCanonical = typeof page.frontmatter.canonicalUrl === "string" ? page.frontmatter.canonicalUrl : void 0;
   const d = decideCanonical({
-    isDefault: !unit.version || unit.version === cfg.defaultVersion || !table,
+    isDefault: !unit.version || unit.version === defaultVersion || !table,
     path: page.slug || "index",
     version,
     frontmatter: fmCanonical,
@@ -1312,31 +1412,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.144 (MIT)
+@dogsbay/elements@0.2.0-beta.146 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/primitives@0.2.0-beta.144 (MIT)
+@dogsbay/primitives@0.2.0-beta.146 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/render-html@0.2.0-beta.144 (MIT)
+@dogsbay/render-html@0.2.0-beta.146 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/search@0.2.0-beta.144 (MIT)
+@dogsbay/search@0.2.0-beta.146 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/ui@0.2.0-beta.144 (MIT)
+@dogsbay/ui@0.2.0-beta.146 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
@@ -2498,6 +2598,8 @@ var EN = {
   prerelease: "pre-release",
   latest: "latest",
   oldVersion: "You are viewing documentation for an older version.",
+  eolVersion: "This version is no longer maintained.",
+  prereleaseVersion: "This version is not released yet.",
   goLatest: "Go to the latest version",
   notFound: "Page not found",
   notFoundBody: "The page you asked for does not exist in this version of the documentation.",
@@ -3064,7 +3166,8 @@ function diagramStore(input, cfg) {
 async function siteCssBuilder(input) {
   return input.css ?? (await import("./chunks/tailwind-fallback-KPRFHW3C.mjs")).buildSiteCss;
 }
-var SITE_FILES = /* @__PURE__ */ new Set(["robots.txt", "_headers", "_redirects", "sitemap-index.xml"]);
+var SITE_FILES = /* @__PURE__ */ new Set(["robots.txt", "sitemap-index.xml"]);
+var MERGED_FILES = /* @__PURE__ */ new Set(["_headers", "_redirects"]);
 function reporter(warnings, problems) {
   return (code, text, at = {}) => {
     const t = detach(text);
@@ -3210,6 +3313,7 @@ async function build(input, hooks = {}) {
   const allUnits = buildUnits(cfg);
   const units = selectUnits(allUnits, input.units);
   checkRootVersion(allUnits, input.files);
+  checkProductFolders(allUnits, input.files);
   const out = /* @__PURE__ */ new Map();
   const sink = input.sink;
   let classes = new Set(CLIENT_CANDIDATES);
@@ -3238,7 +3342,7 @@ async function build(input, hooks = {}) {
   phase.init = now() - t0;
   let pages = 0;
   let assets = 0;
-  const state = { redirects: [], notes: /* @__PURE__ */ new Map(), navCache: navCache(), written: /* @__PURE__ */ new Set(), stubs: [], pageOut: /* @__PURE__ */ new Map(), sitemaps: /* @__PURE__ */ new Map(), supplied: /* @__PURE__ */ new Set(), usedMath: false, diagrams: diagramStore(input, cfg), scan: hooks.keep || hooks.lazy ? new ScanCache() : void 0, parseCache: input.parseCacheBytes === 0 ? false : new ParseCache(input.parseCacheBytes ?? DEFAULT_PARSE_CACHE_BYTES), templateBudget: templateBudget(input.untrusted === true, input.templateMs), dataCache: new DataCache(input.dataCacheBytes ?? DEFAULT_DATA_CACHE_BYTES) };
+  const state = { redirects: [], notes: /* @__PURE__ */ new Map(), navCache: navCache(), written: /* @__PURE__ */ new Set(), stubs: [], pageOut: /* @__PURE__ */ new Map(), sitemaps: /* @__PURE__ */ new Map(), supplied: /* @__PURE__ */ new Set(), hostFiles: /* @__PURE__ */ new Map(), usedMath: false, diagrams: diagramStore(input, cfg), scan: hooks.keep || hooks.lazy ? new ScanCache() : void 0, parseCache: input.parseCacheBytes === 0 ? false : new ParseCache(input.parseCacheBytes ?? DEFAULT_PARSE_CACHE_BYTES), templateBudget: templateBudget(input.untrusted === true, input.templateMs), dataCache: new DataCache(input.dataCacheBytes ?? DEFAULT_DATA_CACHE_BYTES) };
   for (const r of cfg.redirects) {
     const from = sitePath(r.from, cfg.basePath);
     if (!from) {
@@ -3292,20 +3396,36 @@ async function build(input, hooks = {}) {
       defaultLocale: cfg.defaultLocale,
       versions: cfg.versions,
       locales: cfg.locales,
-      units: allUnits.map((u) => ({ prefix: u.prefix, version: u.version, locale: u.locale }))
+      units: allUnits.map((u) => ({ prefix: u.prefix, version: u.version, locale: u.locale, ...u.product ? { product: u.product } : {}, ...cfg.products && u.versionPath !== u.version ? { versionPath: u.versionPath } : {} })),
+      // With content.products, each product's own versions and default (key "" for the unnamed source's).
+      ...cfg.productVersions ? { products: Object.fromEntries(cfg.productVersions) } : {}
       // As nav.js: a host may inline the script, and a name with "<\/script>" must not close it.
     }).replace(/<\//g, "<\\/")};
 `
   );
+  if (cfg.products) await emit("_dogsbay/versions.js", `${toScript("__DOGSBAY_VERSIONS__", siteFiles(cfg.products, []).versions)}
+`);
   const def = defaultUnit(allUnits, cfg);
   const tSite = now();
+  const rootUnit = allUnits.find((u) => u.prefix === "");
+  if (rootUnit && !input.untrusted) {
+    for (const n of MERGED_FILES) {
+      const own = input.files.get(sourceRoot(rootUnit.source) + n);
+      if (own !== void 0) state.hostFiles.set(n, own);
+    }
+  }
   await emitSiteFiles(cfg, allUnits, units, def, state, emit, report, input.onRedirects);
   phase.site = (phase.site ?? 0) + now() - tSite;
   if (def && def.prefix) {
     await emit("index.html", redirectPage(`${def.prefix}/index.html`, cfg.name));
     await emit("404.html", redirectPage(`${def.prefix}/404.html`, cfg.name));
+  }
+  if (cfg.products) {
+    for (const [from, to] of productRootRedirects(cfg.products)) await emit(`${from.slice(1)}index.html`, redirectPage(`${relativeHome(from, to)}index.html`, cfg.name));
+  } else if (def && def.prefix) {
     for (const u of allUnits) {
-      if (u.locale && u.version && u.version === cfg.defaultVersion && u.prefix !== u.locale) await emit(`${u.locale}/index.html`, redirectPage(`${u.version}/index.html`, cfg.name));
+      const root = groupPrefix(u);
+      if (root && u.version && u.version === cfg.defaultVersion && u.prefix !== root) await emit(`${root}/index.html`, redirectPage(`${u.version}/index.html`, cfg.name));
     }
   }
   state.stubs = await writeTranslationStubs(cfg, allUnits, units, translations, state, emit);
@@ -3322,7 +3442,10 @@ async function build(input, hooks = {}) {
 }
 function selectUnits(allUnits, names) {
   if (!names) return allUnits;
-  const named = (u, name) => u.prefix === name || u.version !== void 0 && u.version === name && u.prefix === (u.locale ?? "");
+  const named = (u, name) => {
+    if (u.product) return u.product === name || u.prefix === name && u.prefix !== groupPrefix(u) || u.version !== void 0 && name === `${groupPrefix(u)}/${u.version}`;
+    return u.prefix === name || u.version !== void 0 && (u.version === name && u.prefix === groupPrefix(u) || [groupPrefix(u), u.version].filter(Boolean).join("/") === name);
+  };
   const unknown = names.filter((p) => !allUnits.some((u) => named(u, p)));
   if (unknown.length) {
     const list = allUnits.map((u) => u.prefix ? `"${u.prefix}"` : `"${u.version ?? ""}" (at the root)`).join(", ");
@@ -3332,13 +3455,13 @@ function selectUnits(allUnits, names) {
 }
 function checkRootVersion(allUnits, files) {
   const rootOf = (x) => x.source.path === "." ? "" : x.source.path.replace(/^\.\//, "").replace(/\/+$/, "") + "/";
-  for (const u of allUnits.filter((x) => x.version && x.prefix === (x.locale ?? ""))) {
+  for (const u of allUnits.filter((x) => x.version && x.prefix === groupPrefix(x))) {
     const root = rootOf(u);
     const nested = allUnits.find((x) => x !== u && rootOf(x).startsWith(root) && rootOf(x) !== root);
     if (nested) {
       throw new ConfigError(`source "${nested.source.path}" is inside "${u.source.path}", the source of version "${u.version}" served at the root; give each version its own folder`);
     }
-    const segs = new Set(allUnits.filter((x) => x !== u && x.locale === u.locale && x.version).map((x) => x.version));
+    const segs = new Set(allUnits.filter((x) => x !== u && x.locale === u.locale && sameProduct(x, u) && x.versionPath).map((x) => x.versionPath));
     if (!segs.size) continue;
     for (const k of files.keys()) {
       if (!k.startsWith(root)) continue;
@@ -3346,7 +3469,26 @@ function checkRootVersion(allUnits, files) {
       if (rel.split("/").some((s) => s.startsWith("_") || s.startsWith("."))) continue;
       const first = rel.split("/")[0].replace(/\.(md|markdown)$/i, "");
       if (segs.has(first) && (rel.includes("/") || /\.(md|markdown)$/i.test(rel))) {
-        throw new ConfigError(`${k} is at ${[u.prefix, first].filter(Boolean).join("/")}/\u2026, where version "${first}" is served (version "${u.version}" is at the root); rename the folder or the page`);
+        const other = allUnits.find((x) => x.versionPath === first && x.locale === u.locale && sameProduct(x, u));
+        throw new ConfigError(`${k} is at ${[u.prefix, first].filter(Boolean).join("/")}/\u2026, where version "${other.version}" is served (version "${u.version}" is at the root); rename the folder or the page`);
+      }
+    }
+  }
+}
+function checkProductFolders(allUnits, files) {
+  const names = new Set(allUnits.map((u) => u.product).filter((p) => !!p));
+  if (!names.size) return;
+  for (const u of allUnits.filter((x) => !x.product && x.prefix === "")) {
+    const roots = u.members.filter((m) => !m.mount && m.source.from !== "openapi").map((m) => sourceRoot(m.source));
+    const others = allUnits.filter((x) => x !== u).flatMap((x) => x.members.map((m) => sourceRoot(m.source))).filter(Boolean);
+    for (const k of files.keys()) {
+      const root = roots.find((r) => k.startsWith(r));
+      if (root === void 0 || others.some((o) => k.startsWith(o) && o.length > root.length)) continue;
+      const rel = k.slice(root.length);
+      if (rel.split("/").some((seg) => seg.startsWith("_") || seg.startsWith("."))) continue;
+      const first = rel.split("/")[0].replace(/\.(md|markdown)$/i, "");
+      if (names.has(first) && (rel.includes("/") || /\.(md|markdown)$/i.test(rel))) {
+        throw new ConfigError(`${k} is at ${first}/\u2026, where the source named "${first}" is published; rename the folder or the page`);
       }
     }
   }
@@ -3357,15 +3499,23 @@ async function emitSiteFiles(cfg, all, built, def, state, emit, report, onRedire
     if (state.supplied.has(p)) report("site", `[site] ${p} comes from the content, so the generated one is not written`);
     else await emit(p, content);
   };
+  const cloudflare = cfg.deployTarget === "cloudflare-workers";
+  const merged = async (p, generated, merge) => {
+    const own = state.hostFiles.get(p);
+    if (own === void 0 && generated === void 0) return;
+    const { text, notes } = merge(own === void 0 ? "" : await readText(own), generated, cloudflare);
+    for (const n of notes) report("site", `[site] ${n}`);
+    await emit(p, text);
+  };
   await put("robots.txt", buildRobotsTxt(cfg, defPrefix));
-  if (cfg.llmsTxt) await put("_headers", buildHeadersFile(cfg, defPrefix));
+  await merged("_headers", cfg.llmsTxt ? buildHeadersFile(cfg, defPrefix) : void 0, mergeHeaders);
   if (siteBase(cfg)) {
     const maps = all.flatMap((u) => state.sitemaps.get(u.prefix) ?? [[u.prefix, "sitemap-0.xml"].filter(Boolean).join("/")]);
     await put("sitemap-index.xml", buildSitemapIndex(cfg, maps));
   } else if (cfg.url) {
     report("config", `[site] site.url "${cfg.url}" has no http:// or https://, so canonical links, the sitemap and absolute llms.txt links are left out`);
   }
-  if (!state.redirects.length) return;
+  if (!state.redirects.length) return merged("_redirects", void 0, mergeRedirects);
   const known = (p) => {
     const u = unitOfPath(all, p);
     return !!u && built.includes(u);
@@ -3375,9 +3525,15 @@ async function emitSiteFiles(cfg, all, built, def, state, emit, report, onRedire
   for (const m of w) report("redirects", `[redirects] ${m}`);
   onRedirects?.(rules);
   for (const r of rules) await emit(stubFile(r), renderRedirectPage(r, cfg));
-  if (cfg.deployTarget === "cloudflare-workers" && rules.length) await put("_redirects", renderRedirectsFile(rules, cfg));
+  const ownRedirects = state.hostFiles.has("_redirects");
+  await merged("_redirects", (cloudflare || ownRedirects) && rules.length ? renderRedirectsFile(rules, cfg) : void 0, mergeRedirects);
 }
 function defaultUnit(units, cfg) {
+  if (cfg.products) {
+    const target = siteRootTarget(cfg.products);
+    if (target) return units.find((u) => `/${u.prefix}/` === target || u.prefix === "" && target === "/") ?? units[0];
+    units = units.filter((u) => !u.product);
+  }
   return units.find((u) => (u.version ?? cfg.defaultVersion) === cfg.defaultVersion && (u.locale ?? cfg.defaultLocale) === cfg.defaultLocale) ?? units[0];
 }
 var mathLoad;
@@ -4351,6 +4507,8 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
   t = now();
   for (const a of assetPaths) {
     if (SITE_FILES.has(prefix + a)) state.supplied.add(prefix + a);
+    if (MERGED_FILES.has(prefix + a)) continue;
+    if (MERGED_FILES.has(a)) warn("site", `${a} is copied to ${prefix}${a}, where hosts do not read it: they read _headers and _redirects at the site root only, from the unit served there`, { file: abs(a) });
     await emit(prefix + a, files.get(a));
   }
   const pagesJs = `(window.__DOGSBAY_PAGES__=window.__DOGSBAY_PAGES__||{})[${JSON.stringify(unit.prefix)}]=${JSON.stringify([...[...infos.values()].filter((i) => i.slug !== replaced).map((i) => i.out), ...generatedOuts])};
@@ -4863,13 +5021,14 @@ function switchOptions(kind, unit, all, cfg, out, siteRoot, t) {
   const axis = kind === "version" ? "version" : "locale";
   const other = kind === "version" ? "locale" : "version";
   if (!unit[axis]) return [];
-  const peers = all.filter((u) => u[other] === unit[other] && u[axis]);
-  const defs = kind === "version" ? cfg.versions : cfg.locales;
+  const peers = all.filter((u) => u[other] === unit[other] && sameProduct(u, unit) && u[axis]);
+  const { versions, defaultVersion } = versionsOf(cfg, unit.product);
+  const defs = kind === "version" ? versions : cfg.locales;
   const ordered = defs.length ? defs.map((d) => peers.find((u) => u[axis] === d.id)).filter((u) => !!u) : peers;
-  return ordered.filter((u) => !(kind === "version" && cfg.versions.find((v) => v.id === u.version)?.hidden && u !== unit)).map((u) => {
-    const v = kind === "version" ? cfg.versions.find((d) => d.id === u.version) : void 0;
+  return ordered.filter((u) => !(kind === "version" && versions.find((v) => v.id === u.version)?.hidden && u !== unit)).map((u) => {
+    const v = kind === "version" ? versions.find((d) => d.id === u.version) : void 0;
     const l = kind === "locale" ? cfg.locales.find((d) => d.id === u.locale) : void 0;
-    const note = v?.eol ? t("eol") : v?.prerelease ? t("prerelease") : v && v.id === cfg.defaultVersion && v.id !== "latest" ? t("latest") : void 0;
+    const note = v?.eol ? t("eol") : v?.prerelease ? t("prerelease") : v && v.id === defaultVersion && v.id !== "latest" ? t("latest") : void 0;
     return {
       label: v?.label ?? l?.label ?? String(u[axis]),
       href: `${siteRoot}${u.prefix ? u.prefix + "/" : ""}${out}`,
@@ -4880,19 +5039,28 @@ function switchOptions(kind, unit, all, cfg, out, siteRoot, t) {
   });
 }
 function versionBanner(unit, all, cfg, out, siteRoot, t) {
+  const link = (latest2) => ` <a href="${esc3(`${siteRoot}${latest2.prefix ? latest2.prefix + "/" : ""}${out}`)}" data-db-version-link data-prefix="${esc3(latest2.prefix)}">${esc3(t("goLatest"))}</a>`;
+  if (cfg.products) {
+    if (unit.version === void 0 || versionsOf(cfg, unit.product).versions.find((d) => d.id === unit.version)?.hidden) return void 0;
+    const b = shared(() => unitOf(cfg.products, { product: unit.product, locale: unit.locale, version: unit.version })).banner;
+    if (!b) return void 0;
+    const text = esc3(b.kind === "custom" ? b.text : t(b.kind === "eol" ? "eolVersion" : b.kind === "prerelease" ? "prereleaseVersion" : "oldVersion"));
+    const latest2 = b.latest && all.find((u) => `/${u.prefix ? u.prefix + "/" : ""}` === b.latest.home);
+    return latest2 ? text + link(latest2) : text;
+  }
   if (!unit.version || !cfg.defaultVersion || unit.version === cfg.defaultVersion) return void 0;
   const v = cfg.versions.find((d) => d.id === unit.version);
   if (v?.hidden) return void 0;
-  const latest = all.find((u) => u.version === cfg.defaultVersion && u.locale === unit.locale);
+  const latest = all.find((u) => u.version === cfg.defaultVersion && u.locale === unit.locale && sameProduct(u, unit));
   if (!latest) return void 0;
-  return `${esc3(t("oldVersion"))} <a href="${esc3(`${siteRoot}${latest.prefix ? latest.prefix + "/" : ""}${out}`)}" data-db-version-link data-prefix="${esc3(latest.prefix)}">${esc3(t("goLatest"))}</a>`;
+  return esc3(t("oldVersion")) + link(latest);
 }
 async function writeTranslationStubs(cfg, all, built, tables, state, emit, exists = () => false) {
   const def = cfg.defaultLocale;
   if (!def || !tables.size) return [];
-  const unitOf = (locale, version) => all.find((u) => u.locale === locale && u.version === version);
+  const unitOf2 = (locale, version) => all.find((u) => u.locale === locale && u.version === version && !u.product);
   const missing = missingTranslations(
-    all.filter((u) => u.locale).map((u) => {
+    all.filter((u) => u.locale && !u.product).map((u) => {
       const t = tables.get(u.prefix);
       return { locale: u.locale, version: u.version, pages: !t ? [] : u.locale === def ? t.pages.keys() : [...t.pages.keys(), ...t.redirects.keys()] };
     }),
@@ -4903,9 +5071,9 @@ async function writeTranslationStubs(cfg, all, built, tables, state, emit, exist
   const written = [];
   for (const m of missing) {
     if (m.page === "404") continue;
-    const home = unitOf(def, m.version);
+    const home = unitOf2(def, m.version);
     const out = tables.get(home.prefix).pages.get(m.page);
-    const target = unitOf(m.locale, m.version);
+    const target = unitOf2(m.locale, m.version);
     if (!built.includes(target ?? home)) continue;
     const to = join(home.prefix, out);
     if (built.includes(home) && !pageFiles.has(to)) continue;
@@ -4916,6 +5084,10 @@ async function writeTranslationStubs(cfg, all, built, tables, state, emit, exist
   }
   return written;
 }
+function relativeHome(from, to) {
+  if (to.startsWith(from)) return to.slice(from.length);
+  return "../".repeat(from.split("/").filter(Boolean).length) + to.slice(1);
+}
 function redirectPage(target, name) {
   const u = esc3(target);
   return `<!doctype html><html><head><meta charset="utf-8"><title>${esc3(name)}</title><meta name="robots" content="noindex"><meta http-equiv="refresh" content="0; url=${u}"><link rel="canonical" href="${u}"><link rel="icon" href="data:,"></head><body><p><a href="${u}">${esc3(name)}</a></p></body></html>
@@ -4991,7 +5163,7 @@ function hreflangFor(cfg, unit, all, languages, slug) {
   const path = slug || "index";
   const alts = [];
   for (const u of all) {
-    if (!u.locale || u.version !== unit.version) continue;
+    if (!u.locale || u.version !== unit.version || !sameProduct(u, unit)) continue;
     const out = languages.get(u.prefix)?.get(path);
     const url = out ? absoluteUrl(cfg, u.prefix, servedPath(out, cfg.linkStyle)) : void 0;
     if (url) alts.push({ lang: u.locale, url });
@@ -5003,7 +5175,7 @@ function hreflangFor(cfg, unit, all, languages, slug) {
 var CONFIG_FILES = /* @__PURE__ */ new Set(["dogsbay.config.yml", "dogsbay.config.yaml"]);
 var NAV_FILES2 = /(^|\/)nav\.(ya?ml|json)$/;
 var START_ONLY = /(^|\/)(_dogsbay\/search\/|llms(-full)?\.txt$)/;
-var SITE_WIDE = /^(_dogsbay\/assets\/|_dogsbay\/site\.js$|robots\.txt$|_headers$|_redirects$|sitemap-index\.xml$)/;
+var SITE_WIDE = /^(_dogsbay\/assets\/|_dogsbay\/(site|versions)\.js$|robots\.txt$|_headers$|_redirects$|sitemap-index\.xml$)/;
 var UNIT_CSS = /(^|\/)_dogsbay\/site\.css$/;
 async function openDevSession(input, o = {}) {
   let out = /* @__PURE__ */ new Map();
@@ -5082,7 +5254,7 @@ async function openDevSession(input, o = {}) {
     if (o.lazy) for (const u of units.values()) for (const p of u.handle.pageOuts) stale.add(p);
   };
   const noteItems = () => [...ctx?.state.notes.values() ?? []].flat().map((n) => ({ ...n }));
-  const unitOf = (path) => {
+  const unitOf2 = (path) => {
     let best;
     let bestLen = -1;
     for (const u of units.values()) {
@@ -5167,7 +5339,7 @@ async function openDevSession(input, o = {}) {
     const lazy = await textOf(c);
     return lazy ?? c;
   };
-  const pageFor = (source) => unitOf(source)?.handle.pageForSource(source);
+  const pageFor = (source) => unitOf2(source)?.handle.pageForSource(source);
   return {
     get config() {
       return config;
@@ -5278,7 +5450,7 @@ async function openDevSession(input, o = {}) {
       if (CONFIG_FILES.has(p)) continue;
       const readers = [...units.values()].filter((u2) => u2.handle.navInputs.includes(p) || u2.unit.members.some((m) => m.source.nav === p));
       if (readers.length) {
-        for (const u2 of [...readers, unitOf(p)]) if (u2) lazy.add(u2.unit.prefix);
+        for (const u2 of [...readers, unitOf2(p)]) if (u2) lazy.add(u2.unit.prefix);
         mark("unit");
         continue;
       }
@@ -5300,7 +5472,7 @@ async function openDevSession(input, o = {}) {
         }
         continue;
       }
-      const u = unitOf(p);
+      const u = unitOf2(p);
       if (!u) continue;
       const content = input.files.get(p);
       if (/\.(md|markdown)$/i.test(p)) {
@@ -5326,6 +5498,7 @@ async function openDevSession(input, o = {}) {
         const at = memberPath(u.unit, p)?.path ?? p.slice(sourceRoot(u.unit.source).length);
         const key = u.unit.prefix ? `${u.unit.prefix}/${at}` : at;
         const sanitizing = (config.html ?? input.defaultHtml ?? "keep") === "sanitize";
+        if (key === "_headers" || key === "_redirects") continue;
         if (copiedPath(at) && await assetVerdict(at, content, input.untrusted === true, sanitizing) === "copy") out.set(key, content);
         else out.delete(key);
       }
@@ -5352,10 +5525,12 @@ async function openDevSession(input, o = {}) {
       units.set(prefix, next);
       for (const o2 of handle.pageOuts) markStale(o2, next, true);
     }
-    if (config.defaultVersion && [...lazy].some((prefix) => units.get(prefix)?.unit.version === config.defaultVersion)) {
+    const isDefault = (u) => u.version !== void 0 && u.version === versionsOf(config, u.product).defaultVersion;
+    const changedDefaults = [...lazy].map((prefix) => units.get(prefix)?.unit).filter((u) => !!u && isDefault(u));
+    if (changedDefaults.length) {
       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) markStale(o2, u);
+      for (const u of units.values()) if (u.unit.version !== void 0 && !isDefault(u.unit) && changedDefaults.some((d) => (d.product ?? "") === (u.unit.product ?? ""))) for (const o2 of u.handle.pageOuts) markStale(o2, u);
     }
     if (lazy.size && ctx.state.languages) {
       const all = [...units.values()].map((u) => u.unit);

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

@@ -220,8 +220,10 @@ export interface SiteState {
     pageOut: Map<string, string>;
     /** Sitemap files, relative to the site root, by unit prefix. */
     sitemaps: Map<string, string[]>;
-    /** Site-level files a content root supplies itself (robots.txt, _headers…); they win over generated ones. */
+    /** Site-level files a content root supplies itself (robots.txt, the sitemap index); they win over generated ones. */
     supplied: Set<string>;
+    /** The root's own `_headers` and `_redirects`, merged with the generated ones (@dogsbay/site-files host-files.ts). */
+    hostFiles: Map<string, FileContent>;
     /** A page rendered math, so the KaTeX stylesheet and fonts are written. */
     usedMath: boolean;
     /** Rendered diagrams, shared by the units of the build. */
@@ -423,10 +425,10 @@ export interface BuildHooks {
 /** Build one unit again without rendering its pages (they are rendered on request). */
 export declare function rebuildUnitLazy(ctx: BuildContext, unit: BuildUnit): Promise<UnitHandle>;
 export declare function build(input: BuildInput, hooks?: BuildHooks): Promise<BuildResult>;
-/** robots.txt, _headers, the sitemap index and redirects: the files that belong to the whole site. */
 /**
- * The units `--unit` names: by prefix, and a version served at the root
- * (prefix "" or the locale) also by its id. Throws on a name that is no unit.
+ * The units `--unit` names: by prefix; a version served at the root (prefix "", the locale or
+ * the product) also by its id, and inside a product by `<product>/<id>`; and a product by its
+ * name, which is all its versions and locales. Throws on a name that is no unit.
  */
 export declare function selectUnits(allUnits: BuildUnit[], names: string[] | undefined): BuildUnit[];
 /**

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

@@ -31,8 +31,7 @@ export type FrontMatterOf = (path: string, c: FileContent) => Promise<Record<str
  */
 export declare function frontMatterCache(read: Read): FrontMatterOf;
 /**
- * One table per language of the default version, keyed by locale (`""`
- * without a locale axis). Empty when none of the units being built is an
+ * One table per language of the default version and per product, keyed by `tableKey`. Empty when none of the units being built is an
  * older version (then nothing points elsewhere, and nothing is read).
  */
 export declare function defaultTables(cfg: SiteConfig, units: BuildUnit[], built: BuildUnit[], files: Map<string, FileContent>, read: Read, warn?: (m: string) => void, fm?: FrontMatterOf): Promise<Map<string, DefaultTable>>;

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

@@ -1,3 +1,4 @@
+import { type ProductModel } from "@dogsbay/site-files";
 export type LinkStyle = "html" | "pretty";
 export type TocMode = "top" | "popover" | "rail" | "off";
 export interface VersionDef {
@@ -14,9 +15,26 @@ export interface VersionDef {
     noindex?: boolean;
     /** Override whether the version's pages are in the sitemap. */
     sitemap?: boolean;
-    /** `""`: the version is served at the root (no version segment). Only the default version may set it. */
-    path?: "";
+    /**
+     * The version's URL segment when it is not its id. `""`: served at the root (no version segment),
+     * only on the default version. Any other segment (`latest`) only inside `content.products:`.
+     */
+    path?: string;
+    /** The version's own banner text (`content.products:` only), instead of the standard one. */
+    banner?: string;
+}
+/** A call into @dogsbay/site-files' product model, its config errors reported as ours (dev and the CLI tell them apart). */
+export declare function shared<T>(f: () => T): T;
+/** The versions a unit's product has, and its default. */
+export interface ProductVersions {
+    versions: VersionDef[];
+    defaultVersion?: string;
 }
+/**
+ * A product's versions and default: its own with `content.products:`, else the site-wide `versions:`
+ * and `defaultVersion` (the unnamed source's, and every product's without the block).
+ */
+export declare function versionsOf(cfg: Pick<SiteConfig, "versions" | "defaultVersion" | "productVersions">, product: string | undefined): ProductVersions;
 export interface LocaleDef {
     id: string;
     label: string;
@@ -72,6 +90,10 @@ export interface SiteConfig {
     routablesFrom: "all" | "nav";
     versions: VersionDef[];
     defaultVersion?: string;
+    /** `content.products:`, read by @dogsbay/site-files' `productModel` (plans/product-versions-ssg.md). Undefined without the block. */
+    products?: ProductModel;
+    /** With `products`: each product's versions and default (key `""` for the unnamed source's), read through `versionsOf`. */
+    productVersions?: Map<string, ProductVersions>;
     locales: LocaleDef[];
     defaultLocale?: string;
     search: boolean;
@@ -274,10 +296,26 @@ export interface BuildUnit {
     /** Every source the unit builds, the main one included, in config order. */
     members: UnitMember[];
     version?: string;
+    /** The version's URL segment: its id, its `path` (`latest`), or `""` when served without one. */
+    versionPath?: string;
     locale?: string;
-    /** Output prefix inside the site, e.g. "en/3.31" or "" when neither axis is active. */
+    /**
+     * The named source the unit publishes, when named sources are combined with versions or locales
+     * (a product): its first prefix segment, as the CLI's `/<name>/<locale>/<version>/` order.
+     * Units of one product share it; the unnamed source's units have none.
+     */
+    product?: string;
+    /** Output prefix inside the site, e.g. "en/3.31", "calico/3.31", or "" when no axis is active. */
     prefix: string;
 }
+/**
+ * The prefix of a unit's product and locale, without its version: where the unit's
+ * versions sit side by side ("calico/en", "en", or ""). A version served at the root
+ * (`path: ""`) has this as its prefix.
+ */
+export declare function groupPrefix(u: Pick<BuildUnit, "product" | "locale">): string;
+/** Whether two units are versions or languages of the same product (or both of no product). */
+export declare const sameProduct: (a: Pick<BuildUnit, "product">, b: Pick<BuildUnit, "product">) => boolean;
 /**
  * Expand sources into units. An axis is "active" (adds a URL segment)
  * when the sources carry two or more distinct values for it, or when

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/ssg",
-  "version": "0.2.0-beta.144",
+  "version": "0.2.0-beta.146",
   "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.144",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.144",
-    "@dogsbay/format-openapi": "0.2.0-beta.144",
-    "@dogsbay/format-topicmap": "0.2.0-beta.144",
-    "@dogsbay/highlight": "0.2.0-beta.144",
-    "@dogsbay/minja": "0.2.0-beta.144",
-    "@dogsbay/primitives": "0.2.0-beta.144",
-    "@dogsbay/render-html": "0.2.0-beta.144",
-    "@dogsbay/search": "0.2.0-beta.144",
-    "@dogsbay/serialize-core": "0.2.0-beta.144",
-    "@dogsbay/site-check": "0.2.0-beta.144",
-    "@dogsbay/site-files": "0.2.0-beta.144",
-    "@dogsbay/types": "0.2.0-beta.144"
+    "@dogsbay/elements": "0.2.0-beta.146",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.146",
+    "@dogsbay/format-openapi": "0.2.0-beta.146",
+    "@dogsbay/format-topicmap": "0.2.0-beta.146",
+    "@dogsbay/highlight": "0.2.0-beta.146",
+    "@dogsbay/minja": "0.2.0-beta.146",
+    "@dogsbay/primitives": "0.2.0-beta.146",
+    "@dogsbay/render-html": "0.2.0-beta.146",
+    "@dogsbay/search": "0.2.0-beta.146",
+    "@dogsbay/serialize-core": "0.2.0-beta.146",
+    "@dogsbay/site-check": "0.2.0-beta.146",
+    "@dogsbay/site-files": "0.2.0-beta.146",
+    "@dogsbay/types": "0.2.0-beta.146"
   },
   "devDependencies": {
     "@axe-core/playwright": "^4.12.1",
     "@cloudflare/workers-types": "^5.20260921.1",
-    "@dogsbay/elements": "0.2.0-beta.144",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.144",
-    "@dogsbay/format-openapi": "0.2.0-beta.144",
-    "@dogsbay/format-topicmap": "0.2.0-beta.144",
-    "@dogsbay/highlight": "0.2.0-beta.144",
-    "@dogsbay/icons": "0.2.0-beta.144",
-    "@dogsbay/minja": "0.2.0-beta.144",
-    "@dogsbay/primitives": "0.2.0-beta.144",
-    "@dogsbay/render-html": "0.2.0-beta.144",
-    "@dogsbay/search": "0.2.0-beta.144",
-    "@dogsbay/serialize-core": "0.2.0-beta.144",
-    "@dogsbay/site-check": "0.2.0-beta.144",
-    "@dogsbay/site-files": "0.2.0-beta.144",
-    "@dogsbay/types": "0.2.0-beta.144",
-    "@dogsbay/ui": "0.2.0-beta.144",
+    "@dogsbay/elements": "0.2.0-beta.146",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.146",
+    "@dogsbay/format-openapi": "0.2.0-beta.146",
+    "@dogsbay/format-topicmap": "0.2.0-beta.146",
+    "@dogsbay/highlight": "0.2.0-beta.146",
+    "@dogsbay/icons": "0.2.0-beta.146",
+    "@dogsbay/minja": "0.2.0-beta.146",
+    "@dogsbay/primitives": "0.2.0-beta.146",
+    "@dogsbay/render-html": "0.2.0-beta.146",
+    "@dogsbay/search": "0.2.0-beta.146",
+    "@dogsbay/serialize-core": "0.2.0-beta.146",
+    "@dogsbay/site-check": "0.2.0-beta.146",
+    "@dogsbay/site-files": "0.2.0-beta.146",
+    "@dogsbay/types": "0.2.0-beta.146",
+    "@dogsbay/ui": "0.2.0-beta.146",
     "@mermanjs/web": "0.7.0",
     "@playwright/test": "1.61.1",
     "@types/node": "^22.10.0",