@dogsbay/ssg 0.2.0-beta.151.1 → 0.2.0-beta.153

package/dist/package/types/theme/docs-layout/site-chrome.d.ts

@@ -50,3 +50,15 @@ export declare const isMenu: (l: SiteChromeLink | SiteChromeMenu) => l is SiteCh
 export declare const isExternal: (href: string) => boolean;
 /** The announcement's colours by tone: the callout tokens, so the theme and dark mode apply. */
 export declare const ANNOUNCEMENT_TONE_CLASS: Record<string, string>;
+/** The width the header's links show in the bar from (in the sidebar's list below it); `never`: the list only. */
+export type LinksFrom = "lg" | "xl" | "2xl" | "never";
+/**
+ * Where the header's links fit: the first width at which their estimated width fits beside what
+ * else the header holds, or `never`. Estimated from the labels (about 6.2 px a character at the
+ * header's text size, 28 px padding a link, 14 px a dropdown's chevron) against the header beside
+ * the 256 px sidebar, less the trigger and padding (80 px) and the menus: about 520 px for a
+ * crowded header (product, version, page actions, icons), 210 px otherwise (search with its
+ * text, the icons). A crowded header starts at xl. Measured on Tigera's (47 characters, 4 links:
+ * xl) and the products fixture; a long navbar stays in the sidebar rather than push the page wide.
+ */
+export declare function headerLinksFrom(links: Array<SiteChromeLink | SiteChromeMenu>, crowded: boolean): LinksFrom;

package/dist/package/types/theme/docs-layout/tag-list-data.d.ts

@@ -88,25 +88,11 @@ export declare function resolveTagDisplayLabel(tag: string, labels?: Record<stri
  */
 export declare function resolveTagKeywords(tags: readonly unknown[] | undefined, labels?: Record<string, string>): string[];
 /**
- * Resolve the display label for a term identified by its fullPath
- * array (e.g. `["concept"]` or `["concept", "a11y"]`).
- *
- * Used by `<TaxonomyIndex>` term-cloud chips, `<TaxonomyTerm>`
- * page headings and breadcrumbs, and sub-tag pills — anywhere a
- * structural slug needs to render as a human label.
- *
- * Resolution order:
- * 1. `labels[fullSlug]` (joined fullPath) — explicit override
- *    wins, regardless of depth.
- * 2. For top-level terms (`fullPath.length === 1`):
- *    `prefixes[segment].label` — lets a top-level segment
- *    (`concept`, `difficulty`) render as "Concept", "Difficulty".
- * 3. The leaf segment of the path — the rendered fallback for
- *    deeper terms with no override.
- *
- * URLs continue to use the slug-form `fullPath`. Display only.
+ * Display label of a term path (`labels` override, then a top-level
+ * `prefixes` label, then the leaf). One implementation, shared with the
+ * search facet column: `@dogsbay/search/facets`.
  */
-export declare function resolveTermLabel(fullPath: readonly string[], prefixes?: Record<string, PrefixDisplay>, labels?: Record<string, string>): string;
+export { resolveTermLabel } from "@dogsbay/search/facets";
 /**
  * Map raw tag slugs to render-ready chip models, applying prefix
  * + label config rules.

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

@@ -14,6 +14,7 @@ export declare function sidebar(opts: {
     nav: string;
     label: string;
     links?: string;
+    linksClass?: string;
 }): string;
 export declare function sidebarTrigger(label: string): string;
 export interface NavOptions {
@@ -54,7 +55,8 @@ export declare function navTree(nodes: NavNode[], o: NavOptions): string;
 export type CompactNav = [string, string | null, CompactNav[]?, 1?];
 export declare function compactNav(nodes: NavNode[], href: (slug: string) => string | undefined): CompactNav[];
 export declare function navSize(nodes: NavNode[]): number;
-export declare function searchButton(label: string): string;
+/** `compact`: a crowded header (SearchDialog's `compact`), the label and key only from 2xl. */
+export declare function searchButton(label: string, compact?: boolean): string;
 export declare function themeToggle(label: string): string;
 export interface SwitchOption {
     label: string;
@@ -67,6 +69,7 @@ export interface SwitchOption {
     /** A versionMenu link after the versions: the client goes straight to it. */
     link?: boolean;
 }
+/** `compact`: a crowded header, the button an icon below 2xl (PageActions.astro `compact`; its aria-label names it). */
 export declare function pageActions(o: {
     mdHref: string;
     label: string;
@@ -77,11 +80,32 @@ export declare function pageActions(o: {
         href: string;
     }[];
     copy: boolean;
+    compact?: boolean;
 }): string;
 export declare function h1(title: string): string;
 export declare function lede(text: string): string;
 export declare function banner(html: string): string;
-export declare function searchDialog(t: (k: string) => string): string;
+/** The strings the search UI reads from its result list (src/client/search.ts), shared by the dialog and the page. */
+/**
+ * The facet column's display (`data-facets`, src/client/search-facets.ts FacetDisplay): each
+ * taxonomy a query can filter on, with its title and labels. Undefined without taxonomies.
+ */
+type FacetDef = {
+    name: string;
+    hierarchical: boolean;
+    prefixes?: Record<string, {
+        label?: string;
+    }>;
+    labels?: Record<string, string>;
+};
+export declare function facetDisplay(defs: ReadonlyArray<FacetDef>): string | undefined;
+/** `searchPage`: the unit's search page from this page, for the dialog's "See all N results". */
+export declare function searchDialog(t: (k: string) => string, searchPage?: string, facets?: string): string;
+/**
+ * The search page's body (`search.html`, src/client/search.ts initSearchPage): a form whose input
+ * carries the query (`?q=`, so it also works as a plain GET form), the status, and the results.
+ */
+export declare function searchPageBody(t: (k: string) => string, facets?: string): string;
 export declare function skipLink(label: string): string;
 /** A section page with no body lists its child topics (LinkCard look). */
 export declare function childLinks(items: {
@@ -89,3 +113,4 @@ export declare function childLinks(items: {
     href: string;
     description?: string;
 }[]): string;
+export {};

package/package.json

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