docs: note antora-dark-theme 1.0 and local site-dark-mode alignment

Made-with: Cursor

Author: AMDphreak

docs/modules/ROOT/pages/docs-site-management.adoc

@@ -22,7 +22,7 @@ This repository (`docs`) contains the core configuration for the documentation s
 [[ui-bundle]]
 == UI bundle
 
-The published site uses link:https://github.com/antora-supplemental/antora-dark-theme[antora-supplemental/antora-dark-theme] as the base Antora UI bundle (`ui.bundle.url` in the playbook; use the `releases/latest/download/ui-bundle.zip` asset). FoodTruckNerdz layers custom partials, CSS, and scripts on top via `site/supplemental-ui/`. The `package.json` `prebuild` step runs `site/scripts/sync-antora-dark-theme.cjs`, which copies selected files from the `antora-dark-theme` npm package into that folder, because Antora accepts only a single `ui.supplemental_files` directory.
+The published site uses link:https://github.com/antora-supplemental/antora-dark-theme[antora-supplemental/antora-dark-theme] as the base Antora UI bundle (`ui.bundle.url` in the playbook; use the `releases/latest/download/ui-bundle.zip` asset). FoodTruckNerdz layers custom partials, CSS, and scripts on top via `site/supplemental-ui/`. The `package.json` `prebuild` step runs `site/scripts/sync-antora-dark-theme.cjs`, which copies `site-extra.css` and `img/` from the `antora-dark-theme` npm package into that folder, because Antora accepts only a single `ui.supplemental_files` path. The dark-mode script in `site/supplemental-ui/js/site-dark-mode.js` is **maintained in this repository** in lockstep with **antora-dark-theme 1.0+** (system / override behavior); bump the `antora-dark-theme` devDependency after the package is published, then `pnpm install`.
 
 Optional `site.keys` in the playbook control the footer label and link for the base theme (keep them aligned with the bundle you reference in `ui.bundle`):