Changelog

This changelog records notable changes to the D Lang Supplemental documentation portal itself, including playbook additions, configuration changes, and global reorganizations.

Facto-stack v0.2.40 (search dock layout)

  • Bump @antora-supplemental/facto-stack to v0.2.40 (search bar stays on screen above the footer).

Lockfile check before pnpm antora

  • pnpm antora installs when the lockfile is newer than node_modules (git tag bumps). It does not move the facto-stack pin by itself; pull the repo first.

Facto-stack v0.2.39 (desktop disk-search dialog)

  • Bump @antora-supplemental/facto-stack to v0.2.39 (Windows disk search uses a dialog instead of the Y/n banner).

Facto-stack v0.2.38 (banner wrap)

  • Bump @antora-supplemental/facto-stack to v0.2.38 (disk-search banner wraps inside the frame).

Facto-stack v0.2.37 (local content banner)

  • Bump @antora-supplemental/facto-stack to v0.2.37 (disk-search banner prints once, as ASCII, on Windows).

Facto-stack v0.2.36 (opaque search chrome)

  • Bump @antora-supplemental/facto-stack to v0.2.36.

Local content via facto-stack

  • Removed antora-playbook-local.yml and build:local. Pin @antora-supplemental/facto-stack v0.2.34 (registers antora-local-content-sources). Hub repo adds .antora-source-id; content repos should add markers for hive clone discovery.

Provider dedupe

  • Drop the overrides entry for link-validator; facto-stack v0.2.21+ pins link-validator v0.2.2 itself. package.json declares facto-stack (plus tooling), nothing else from the pack.

Facto-stack v0.2.22 (linkinator v0.1.10)

  • Bump @antora-supplemental/facto-stack to v0.2.22 — Wayback chip stays opaque on hover/focus (no transparent --adt-accent-soft on the floating control).

2026-10-17

Hub GitHub topics (direct deps only).

Repository topics

  • Retag playbook repo: facto-stack only (provider rule; removed valentus-theme and transitive pack-member topics). Policy: Hub GitHub topics.

Facto-stack pack pins (linkinator, page-edit).

Facto-stack v0.2.18 (linkinator v0.1.7)

  • Bump @antora-supplemental/facto-stack to v0.2.18 — @antora-supplemental/linkinator v0.1.7: idle Wayback overlay uses zero layout footprint so link rows stay aligned.

  • Pack includes @antora-supplemental/page-edit v0.2.5 (View | Edit when tag-pinned sources supply forge blob URLs in src.editUrl).

Facto-stack v0.2.16 (linkinator v0.1.6)

  • Bump @antora-supplemental/facto-stack to v0.2.16 — @antora-supplemental/linkinator v0.1.6: link-only hover tint, floating ⧉ Wayback control above the anchor (not inline in prose or whole list items).

Hub link-cache invalidation and link-validator v0.2.2 override.

  • Deploy listens for repository_dispatch type link-cache-invalidate; maps payload sources / urls / ref to link-validator env and checkout. How-to: Notify the docs hub of link changes. Reusable dispatch: dlang-supplemental/.github; exemplar caller dlang-supplemental/asciidoctor-d.

  • pnpm override pins @antora-supplemental/link-validator#v0.2.2 through Facto stack (surgical invalidation env).

Facto-stack compose pack pin.

Hub optional diagram members (facto-stack v0.2.8)

  • Bump @antora-supplemental/facto-stack to v0.2.8 — hub profile registers mermaid-client/antora and diagram-lightbox as disabled pack members (enable via mermaidClient / diagramLightbox pack config when supplemental-ui ships the partials).

Facto-stack v0.2.9 (site-nav-tree v0.6.1)

  • Bump @antora-supplemental/facto-stack to v0.2.9 — pack pins @antora-supplemental/site-nav-tree v0.6.1 for hubs that enable siteNavTree (unchanged for this hub until site-nav-tree is opted in).

2026-10-16

Portal hub updates.

Hub index nav label Overview

  • Hub Overview uses :navtitle: Overview and the first nav entry Overview; the page H1 is D Lang Supplemental Portal (Dev-Centr-style split: component Home, portal name in content, overview label in the sidebar).

Hub component home (avoid /docs/docs/)

  • AGENTS.md links the canonical Dev-Centr write-up Hub home component and skill hub-home-overview.

  • Hub Antora component name is home (was docs), matching Dev-Centr and antora-supplemental hub conventions. Meta-docs stay in this repo’s docs/ content tree; the published URL segment is /home/ under the GitHub Pages site base (…/docs/home/), not …/docs/docs/.

  • Post-build step mirrors hub HTML under …/docs/docs/ with client redirects to the matching …/docs/home/ page so old bookmarks keep working.

  • site.start_page is home::index.adoc; hub docs/antora.yml keeps start_page: ROOT:index.adoc.

  • Keyword listings still use lib/page-context-keywords-host.js on the home component at /docs/keywords/ (page-context-keyword-base unchanged).

Portal as site and component home

  • site.start_page points at Overview (was asciidoctor-d:ROOT:index.adoc), so the site root redirect, header title link, and breadcrumb home chip land on the hub instead of a product component.

SoftNav breadcrumbs and page TOC

  • Detail links append Changelog in the breadcrumb (… / Changelog / Detail title) instead of replacing that crumb with the detail title.

  • Right-rail page TOC rebuilds after a soft navigation. The previous heading selector threw, so the rail stayed on the page you left.

  • @antora-supplemental/facto-stack v0.2.4 pulls @antora-supplemental/soft-nav-page-toc v0.1.6 (script URL, :hide-page: meta, and the parent crumb on a hard load).

Changelog heading format

  • Index and detail pages use == YYYY-MM-DD (date only) and === topic lines with short descriptions; :toclevels: 3 lists topics in the page TOC.

  • Changelog detail pages declare :hide-page: and :navtree-parent: changelog.adoc for nav-drift audits, breadcrumb trails, and SoftNav nav-tree injection.

Linkinator hover bar and chrome exclusions

  • @antora-supplemental/linkinator v0.1.2+ shows Wayback controls in a hover bar on article links only (not header, footer, or page-context metadata).

  • Extension display name is Linkinator (v0.1.3 registry metadata; npm package id unchanged).

Learning about D media page

  • Playbook requires @antora-supplemental/facto-stack once (compose Antora extension); Lunr, @antora-supplemental/antora-search-chat, page-context, nav typology, link tooling, and related members register from the pack so the footer lists depth-1 imports.

SoftNav TOC and in-page hash jumps

  • Fixed hub soft-nav.js treating sidebar TOC hash links as cross-page soft loads when folder URLs used a trailing slash (/changelog/section vs /changelog/). Same-page clicks now scroll the article; soft fetch applies # after swaps when needed.

SoftNav scroll, TOC, and nav-hidden children

  • Hub soft-nav.js keeps the left nav tree stable on soft loads (swapNav off), scrolls to top on cross-page navigation, rebuilds the right-rail TOC, soft-navigates same-component nav links, patches breadcrumbs for :hide-page: entries, and injects them under their :navtree-parent: (Changelog → detail) on hard and soft loads.

Nav tree parent registry

  • navtree-registry.json and a ;; navtree-parent-association: line in nav.adoc declare parent links for :hide-page: entries when path heuristics are not enough (for example tgc design 0.1.0 under Proposals).

Left nav text filter (site-nav-tree)

  • Removed hub-only filter assets (supplemental nav-menu, nav-tree-filter CSS/JS). A sticky label filter belongs on @antora-supplemental/site-nav-tree with filter: true when that extension is registered (this hub still uses facto-stack single-component sidebar per page).

  • @antora-supplemental/facto-stack v0.2.5 ships site-nav-tree with filter: true by default when you enable pack siteNavTree (unchanged for this single-component hub until site-nav-tree is opted in).

Facto stack pin v0.2.6

  • Bump @antora-supplemental/facto-stack to v0.2.6 (continues to pin @antora-supplemental/soft-nav-page-toc v0.1.6 for aside TOC rebuild and nav-hidden compose).

2026-10-06

Diagrams rebuilt with Mermaid CLI 12

  • Regenerated all six tgc Mermaid diagrams with @mermaid-js/mermaid-cli 12.0.0 (Mermaid 12, Puppeteer 25). The diagram config pins Mermaid 12 to the previous dagre layout, classic look, and 200px label wrapping, so the diagrams keep their existing appearance; the middle dot in the shared-heap comparison now renders correctly.

  • The site build and diagram toolchain now run on Node.js 24 (Mermaid CLI 12 requires Node.js 22.13 or later).

2026-09-10

Dark-mode diagram box fills

  • Regenerated all six tgc Mermaid diagrams with @dev-centr/themed-svg 0.2.3 so node fill/stroke inline !important values become theme CSS variables (fixes light boxes with dark-mode text).

  • Progressive delivery CDN and package pins move from 0.1.1 to 0.2.3 (@dev-centr/mermaid-svg-css-vars 0.1.3).

Publish robots.txt with sitemap

  • Antora site.robots now emits /robots.txt with an absolute Sitemap: line for the production host.

2026-09-08

Mermaid sources and Themed SVG for tgc diagrams

  • Migrated all six canonical tgc diagrams to Mermaid sources with explicit Themed SVG manifests, adaptive image artifacts, host artifacts, sanitized progressive delivery, and warning-free cross-platform Mermaid CLI invocation. The prior fixed drawings remain available for comparison.

2026-09-07

tgc hardening and timeline theming.

tgc 0.2.3 audit hardening

tgc 0.2.2 lookup and correctness

  • Updated the tgc design for 0.2.2 with layered block lookup, safer fixpoint marking, corrected append metadata, and remote-free coverage.

tgc timeline theming

  • Remade the stop-the-world timeline in the tgc article with separated thread labels and light/dark theme-aware SVG colors.

2026-09-01

tgc design through 0.2.0 demo.

tgc 0.1.x prototype and canonical design

tgc demo and 0.2.0 design notes

2026-08-17

avalonia-d in the hub

2026-08-15

Proposals index and tgc figures

Tagged proposal catalog

2026-08-03

tgc articles and SymGC context

  • Updated the tgc blog and news articles to acknowledge SymGC / DConf “We Need a New GC” work and how it relates to pause-isolation goals.

2026-08-02

Blog, news, and tgc launch articles

2026-07-31

Publishing D packages from the CLI

2026-07-24

Org logo and Valentus theme

  • Added the org D+ mark (supplemental-ui/img/logo.svg, D-lang red #B03931) and wired it into the Valentus header via ui.supplemental_files and site.keys.header_logo.

  • Switched the Antora UI bundle from the retired antora-dark-theme URL (now dark-mode-only Default UI) to valentus-theme v1 (ui-bundle.zip).

opentui-d in the hub

  • Registered opentui-d in the Antora playbooks and portal component list.

2026-03-22

Flutter Skia and Impeller guide

  • Added Flutter rendering: Skia and Impeller, a guide covering Skia vs Impeller, transitional “Skia + Impeller” architecture, embedding Impeller from D, and layered decoupling for desktop tooling.

  • Linked the guide from the portal page and from the ROOT module navigation.

2026-03-14

GraphRAG indexer in documentation playbooks

  • Configured the new graphrag-indexer Antora source in the global playbooks and initialized the portal changelog.

  • See Detailed changelog.

2026-03-07

Split local and online playbooks

  • Created a local-development specific playbook mapped to sibling repositories.

  • See Detailed changelog.

2026-03-05

Portal genesis and CI

  • Bootstrapped D Lang Supplemental documentation portal with centralized CI/CD processing and GitHub Pages deployments.

  • See Detailed changelog.