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

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

@@ -22,6 +22,8 @@ export interface VersionDef {
     path?: string;
     /** The version's own banner text (`content.products:` only), instead of the standard one. */
     banner?: string;
+    /** Show "Version: <label>" above the title of the version's pages (Docusaurus's version badge). */
+    badge?: boolean;
 }
 /** 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;
@@ -29,12 +31,27 @@ export declare function shared<T>(f: () => T): T;
 export interface ProductVersions {
     versions: VersionDef[];
     defaultVersion?: string;
+    /** The version menu's extras: the product's own `versionMenu:`, else the site's. */
+    menu?: VersionMenu;
+}
+/**
+ * `versionMenu:` (content, or a product in `content.products:`): links listed after the versions
+ * ("All versions" → /archive, Docusaurus's dropdownItemsAfter), and how many versions to list.
+ */
+export interface VersionMenu {
+    /** `href` is a site path (`/archive`, `/archive/`) or an http(s) address. */
+    links: {
+        label: string;
+        href: string;
+    }[];
+    /** List the first `limit` versions (in config order), plus the page's own when it is further down. */
+    limit?: number;
 }
 /**
  * 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 declare function versionsOf(cfg: Pick<SiteConfig, "versions" | "defaultVersion" | "productVersions" | "versionMenu">, product: string | undefined): ProductVersions;
 export interface LocaleDef {
     id: string;
     label: string;
@@ -90,6 +107,8 @@ export interface SiteConfig {
     routablesFrom: "all" | "nav";
     versions: VersionDef[];
     defaultVersion?: string;
+    /** `content.versionMenu:` (VersionMenu), for every product without its own. */
+    versionMenu?: VersionMenu;
     /** `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`. */
@@ -131,6 +150,14 @@ export interface SiteConfig {
     /** Extra stylesheets, project-relative, appended after the theme. */
     css: string[];
     breadcrumbs: boolean;
+    /**
+     * UI string overrides (ssg.strings): `{ key: text }` for every language, and `{ <locale>: { key: text } }`
+     * for one, which wins. Keys are those of strings.ts.
+     */
+    strings: {
+        all: Record<string, string>;
+        byLocale: Record<string, Record<string, string>>;
+    };
     /** Fail the build when a layout or partial reads a variable that does not exist (ssg.strictTemplates). */
     strictTemplates: boolean;
     /** Line under the site name in the sidebar header ("Documentation" in the Astro sites). */
@@ -181,6 +208,11 @@ export interface SiteConfig {
      */
     dataDir: string;
     dataDirSet: boolean;
+    /**
+     * `content.static`: a folder served as it is at the site root (Docusaurus `static/`, Astro
+     * `public/`), shared with the Astro pipeline (site-files static-folder.ts). Project-relative.
+     */
+    staticDir?: string;
     /** Click-to-zoom images, from `plugins: [@dogsbay/plugin-image-zoom]` with its options. */
     imageZoom?: {
         background: string;
@@ -272,6 +304,8 @@ export interface RedirectDef {
 }
 export declare class ConfigError extends Error {
 }
+/** `versionMenu:` (links and limit), read and checked by site-files for both pipelines. */
+export declare function versionMenuOf(raw: unknown, where: string): VersionMenu | undefined;
 export declare function parseConfig(text: string | undefined, overrides?: Partial<SiteConfig>): SiteConfig;
 /**
  * The unit a site path belongs to: the one with the longest prefix that

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

@@ -24,6 +24,13 @@ export interface LinkTable {
      * would silently turn `/1/install` (another version) into this unit's page.
      */
     stripPrefixes?: string[];
+    /**
+     * `content.static`: the file a root-absolute link names in the static folder (a site path without
+     * its leading slash: `files/x.yaml`, `about/` for `about/index.html`), else undefined. Links from
+     * any unit resolve to it, relative to the page's place in the site (`unitPrefix`).
+     */
+    staticFile?: (sitePath: string) => string | undefined;
+    unitPrefix?: string;
 }
 /** URL for `targetOut` as seen from the page at `fromOut`, both unit-relative files. */
 export declare function hrefBetween(fromOut: string, targetOut: string, style: LinkStyle): string;

package/dist/package/types/theme/compose.d.ts

@@ -68,9 +68,13 @@ export interface PageModel {
         updatedDatetime?: string;
         hero?: string;
     };
+    /** The product switcher (content.products:); none when absent. */
+    products?: R.SwitchOption[];
     versions: R.SwitchOption[];
     locales: R.SwitchOption[];
     banner?: string;
+    /** The version's label, when the version has `badge: true`: "Version: <label>" above the title. */
+    versionBadge?: string;
     editUrl?: string;
     /** Page URL relative to the page itself, for .md mirror links. */
     mdHref?: string;

package/dist/package/types/theme/regions.d.ts

@@ -59,6 +59,10 @@ export interface SwitchOption {
     current: boolean;
     prefix: string;
     note?: string;
+    /** Shown but not choosable: the product switcher's "none" entry on a page outside every product. */
+    disabled?: boolean;
+    /** A versionMenu link after the versions: the client goes straight to it. */
+    link?: boolean;
 }
 export declare function pageActions(o: {
     mdHref: string;

package/package.json

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