@rtorcato/repo-tooling 4.8.0 → 5.0.1

package/tooling/docusaurus/sync-changelog.mjs

@@ -1,106 +0,0 @@
-// Canonical sync-changelog for @rtorcato/* docs sites (shipped by
-// @rtorcato/repo-tooling — copy via `repo-tooling copy docusaurus-sync-changelog`).
-//
-// Builds the docs site's changelog page from **GitHub Releases**, not from
-// CHANGELOG.md. The output file is gitignored — it is regenerated on every docs
-// build (wire it into the docs app's `build`/`start` scripts; pnpm 8 doesn't run
-// `pre*` hooks reliably, so chain it explicitly).
-//
-// Why Releases and not the file: the shipped semantic-release github preset
-// does not use @semantic-release/git, because the `code-scanning-main` ruleset
-// rejects the release commit with GH013 (see tooling/semantic-release/github.mjs
-// and rtorcato/repo-tooling#417). Nothing commits CHANGELOG.md back, so it is
-// frozen at whatever the last release with that plugin wrote — and it freezes at
-// a *real* release, which is why it reads as current. @semantic-release/github
-// writes Releases from the same notes that used to build CHANGELOG.md, so
-// concatenating their bodies reproduces the old page and cannot go stale.
-//
-// The target defaults to Docusaurus's `apps/docs/docs/changelog.md`. Override
-// with the CHANGELOG_TARGET env var (path relative to the repo root) for other
-// layouts — e.g. a Fumadocs content root:
-//   CHANGELOG_TARGET=apps/web/content/docs/changelog.mdx node scripts/sync-changelog.mjs
-// The title/description frontmatter is framework-neutral (both Docusaurus and
-// Fumadocs read it), so only the path changes between frameworks.
-//
-// The docs workflow must rebuild on `release: types: [published]` — with no
-// release commit landing on the default branch, a `push` trigger never fires.
-
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { dirname, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const here = dirname(fileURLToPath(import.meta.url))
-const repoRoot = resolve(here, '..')
-const target = resolve(repoRoot, process.env.CHANGELOG_TARGET ?? 'apps/docs/docs/changelog.md')
-
-/** `owner/name` — from CI, else from package.json `repository`. */
-function resolveRepo() {
-	if (process.env.GITHUB_REPOSITORY) return process.env.GITHUB_REPOSITORY
-	const pkg = JSON.parse(readFileSync(resolve(repoRoot, 'package.json'), 'utf8'))
-	const url = typeof pkg.repository === 'string' ? pkg.repository : pkg.repository?.url
-	const match = /github\.com[/:]([^/]+\/[^/.]+)/.exec(url ?? '')
-	if (!match) throw new Error('no GITHUB_REPOSITORY and no github repository in package.json')
-	return match[1]
-}
-
-const frontmatter = `---
-title: Changelog
-description: Release notes, generated by semantic-release and published to GitHub Releases.
----
-
-`
-
-const footer = (repo, note) =>
-	`\n\n---\n\n${note}Every entry above is generated by semantic-release and published to [GitHub Releases](https://github.com/${repo}/releases). Anything older than the first GitHub Release is recorded in [CHANGELOG.md](https://github.com/${repo}/blob/main/CHANGELOG.md).\n`
-
-async function fetchReleases(repo) {
-	const headers = { Accept: 'application/vnd.github+json' }
-	// Optional: lifts the 60/hr unauthenticated rate limit. CI passes it; local
-	// builds work fine without it at a typical repo's release count.
-	// ponytail: one page of 100. Paginate when a repo outgrows it.
-	const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN
-	if (token) headers.Authorization = `Bearer ${token}`
-
-	const res = await fetch(`https://api.github.com/repos/${repo}/releases?per_page=100`, { headers })
-	if (!res.ok) throw new Error(`GitHub API ${res.status} ${res.statusText}`)
-	return res.json()
-}
-
-function render(releases) {
-	// The API does not guarantee date order, and a release body already carries
-	// its own version heading and date — so sort here and emit bodies verbatim.
-	const sorted = releases
-		.filter((r) => !r.draft && r.body?.trim())
-		.sort((a, b) => new Date(b.published_at) - new Date(a.published_at))
-
-	if (sorted.length === 0) throw new Error('no releases with a body')
-	return sorted.map((r) => r.body.trim()).join('\n\n')
-}
-
-let repo = ''
-let body
-try {
-	repo = resolveRepo()
-	body = render(await fetchReleases(repo)) + footer(repo, '')
-	console.log(`sync-changelog: built from ${repo} GitHub Releases`)
-} catch (error) {
-	// Never fail the docs build on a network blip — fall back to the frozen file
-	// and say so on the page rather than shipping a silently truncated one.
-	console.warn(`sync-changelog: ${error.message} — falling back to CHANGELOG.md`)
-	try {
-		body =
-			readFileSync(resolve(repoRoot, 'CHANGELOG.md'), 'utf8').trim() +
-			(repo
-				? footer(
-						repo,
-						'**This page was built from the repository CHANGELOG.md because GitHub Releases could not be reached, and may be out of date.** '
-					)
-				: '')
-	} catch {
-		body = '# Changelog\n\nNo releases recorded yet.\n'
-	}
-}
-
-mkdirSync(dirname(target), { recursive: true })
-writeFileSync(target, frontmatter + body)
-console.log(`sync-changelog: wrote ${target}`)

package/tooling/docusaurus/theme-tokens.css

@@ -1,79 +0,0 @@
-/**
- * Shared @rtorcato Docusaurus design tokens (shipped by @rtorcato/repo-tooling —
- * copy via `repo-tooling copy docusaurus-theme-tokens`).
- *
- * The Geist font + navy-surface design-token base every sibling docs site
- * shares. `@import` this from your `src/css/custom.css`, then override the
- * accent (`--ifm-color-primary*` and `--jt-accent*`) with your brand colour:
- *
- *   @import "./_jt-tokens.css";
- *   :root            { --ifm-color-primary: #F38020; --jt-accent: #F38020; }
- *   [data-theme=dark]{ --ifm-color-primary: #ff9a4d; --jt-accent: #ff9a4d; }
- *
- * The default accent below is Docusaurus's neutral green — meant to be replaced.
- */
-
-/* ---------- Fonts ---------- */
-@import url("https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700;800&family=Geist+Mono:wght@400;500;600&display=swap");
-
-/* ---------- Light (default) ---------- */
-:root {
-	--ifm-color-primary: #2e8555;
-
-	--ifm-font-family-base: "Geist", system-ui, -apple-system, sans-serif;
-	--ifm-font-family-monospace: "Geist Mono", ui-monospace, SFMono-Regular, monospace;
-	--ifm-heading-font-weight: 800;
-	--ifm-code-font-size: 92%;
-
-	--ifm-background-color: #ffffff;
-	--ifm-background-surface-color: #ffffff;
-	--ifm-navbar-background-color: rgba(255, 255, 255, 0.8);
-	--ifm-heading-color: #0a0e16;
-	--ifm-font-color-base: #374253;
-	--ifm-toc-border-color: rgba(12, 18, 28, 0.1);
-	--ifm-code-background: #f3f6f9;
-
-	/* Design tokens (surfaces/text/borders are shared; accent is per-project). */
-	--jt-accent: var(--ifm-color-primary);
-	--jt-on-accent: #ffffff;
-	--jt-bg: #ffffff;
-	--jt-bg2: #f6f8fb;
-	--jt-surface: #ffffff;
-	--jt-surface2: #f3f6f9;
-	--jt-code-bg: #f3f6f9;
-	--jt-border: rgba(12, 18, 28, 0.1);
-	--jt-border2: rgba(12, 18, 28, 0.16);
-	--jt-heading: #0a0e16;
-	--jt-text: #374253;
-	--jt-muted: #5b6675;
-	--jt-faint: #8a95a5;
-	--jt-shadow: 0 22px 50px -26px rgba(20, 28, 44, 0.3);
-}
-
-/* ---------- Dark ---------- */
-[data-theme="dark"] {
-	--ifm-color-primary: #25c2a0;
-
-	--ifm-background-color: #0a0e16;
-	--ifm-background-surface-color: #111824;
-	--ifm-navbar-background-color: #0a0e16;
-	--ifm-heading-color: #ffffff;
-	--ifm-font-color-base: #dfe5ee;
-	--ifm-toc-border-color: rgba(255, 255, 255, 0.08);
-	--ifm-code-background: #0d131d;
-
-	--jt-accent: var(--ifm-color-primary);
-	--jt-on-accent: #0a0e16;
-	--jt-bg: #0a0e16;
-	--jt-bg2: #0b101a;
-	--jt-surface: #111824;
-	--jt-surface2: #0d131d;
-	--jt-code-bg: #0c111b;
-	--jt-border: rgba(255, 255, 255, 0.08);
-	--jt-border2: rgba(255, 255, 255, 0.14);
-	--jt-heading: #ffffff;
-	--jt-text: #dfe5ee;
-	--jt-muted: #94a1b4;
-	--jt-faint: #647184;
-	--jt-shadow: 0 30px 70px -30px rgba(0, 0, 0, 0.75);
-}

package/tooling/docusaurus/theme.css

@@ -1,390 +0,0 @@
-/**
- * Shared @rtorcato Docusaurus component theme (shipped by @rtorcato/repo-tooling —
- * copy via `repo-tooling copy docusaurus-theme`).
- *
- * The accent-agnostic component-override sheet every sibling docs site shares:
- * navbar, doc cards, sidebar, TOC, pagination, footer, code blocks, markdown
- * tables, buttons, and the hardened navy dark surfaces. Every rule references
- * the `--jt-*` / `--ifm-*` tokens from `_jt-tokens.css` (see
- * `copy docusaurus-theme-tokens`) — it defines NO accent colours.
- *
- * Usage in your `src/css/custom.css`:
- *
- *   @import "./_jt-tokens.css";   // shared design tokens
- *   @import "./theme.css";        // this file — shared component styling
- *   :root            { --ifm-color-primary: #YOURHEX; --jt-accent: #YOURHEX; ... }
- *   [data-theme=dark]{ --ifm-color-primary: #YOURHEX; --jt-accent: #YOURHEX; ... }
- *   ::selection      { background: rgba(R, G, B, 0.24); }  // accent — keep local
- *
- * The single-flat mobile drawer (the `.navbar-sidebar__items` transform lock +
- * the repo-namespaced `.xx-mobile-menu` rules) is NOT here — it ships with the
- * Navbar/MobileSidebar swizzle files, since its class prefix is per-repo.
- */
-
-/* ---------- Navbar ---------- */
-.navbar {
-	border-bottom: 1px solid var(--jt-border);
-	box-shadow: none;
-}
-.navbar__link--active {
-	color: var(--jt-heading);
-}
-
-/* Configuration Reference / index cards (generated-index). Match the clean
-   "install box" look — near-page-bg fill + thin border instead of infima's dull
-   surface fill — with an accent-border hover. Full description (no one-line
-   `text--truncate` clamp) and equal card heights per row. */
-.theme-doc-card-container {
-	height: 100%;
-	background: var(--jt-code-bg);
-	border: 1px solid var(--jt-border);
-	border-radius: 14px;
-	box-shadow: none;
-	transition:
-		border-color 0.15s ease,
-		background 0.15s ease,
-		transform 0.15s ease;
-}
-.theme-doc-card-container:hover {
-	background: var(--jt-surface2);
-	border-color: var(--jt-accent-border);
-	transform: translateY(-2px);
-}
-.theme-doc-card-description.text--truncate {
-	white-space: normal;
-	overflow: visible;
-	text-overflow: unset;
-}
-
-/* ---------- Backgrounds ---------- */
-html,
-body,
-#__docusaurus,
-.main-wrapper {
-	background: var(--ifm-background-color);
-}
-/* Sidebar container: match page background, clean 1px right border, and
-   ensure a long sidebar list scrolls without clipping the page footer. The
-   sticky positioning + bounded height come from Infima defaults; the explicit
-   overflow rule here defends against any inner container with overflow: hidden. */
-.theme-doc-sidebar-container {
-	background: var(--ifm-background-color) !important;
-	border-right: 1px solid var(--jt-border) !important;
-}
-.theme-doc-sidebar-container > div,
-.theme-doc-sidebar-container nav,
-.theme-doc-sidebar-menu,
-.menu,
-.menu__list {
-	background: var(--ifm-background-color);
-}
-/* The sticky inner wrapper that holds the scrollable menu list. */
-.theme-doc-sidebar-container > div:first-child {
-	height: 100%;
-	overflow-y: auto;
-	overscroll-behavior: contain;
-}
-
-/* ---------- Sidebar ---------- */
-.menu {
-	font-size: 14px;
-	background: transparent;
-	padding: 16px 12px;
-}
-.menu__list .menu__list {
-	padding-left: 8px;
-}
-.menu__link {
-	border-radius: 8px;
-	color: var(--jt-muted);
-	line-height: 1.4;
-}
-.menu__link:hover {
-	background: var(--jt-surface2);
-	color: var(--jt-heading);
-}
-.menu__link--active:not(.menu__link--sublist) {
-	color: var(--jt-accent);
-	background: var(--jt-accent-soft);
-	font-weight: 600;
-}
-.menu__list-item-collapsible .menu__link {
-	font-weight: 600;
-	color: var(--jt-heading);
-	background: transparent;
-}
-.menu__list-item-collapsible .menu__link--active {
-	color: var(--jt-accent);
-	background: transparent;
-}
-.menu__list-item-collapsible:hover {
-	background: var(--jt-surface2);
-	border-radius: 8px;
-}
-.menu__caret:hover {
-	background: transparent;
-}
-
-/* ---------- Table of contents ---------- */
-.table-of-contents__link--active {
-	color: var(--jt-accent);
-	font-weight: 600;
-}
-.table-of-contents .table-of-contents__link:hover {
-	color: var(--jt-heading);
-}
-
-/* ---------- Pagination ---------- */
-.pagination-nav__link {
-	border: 1px solid var(--jt-border);
-	border-radius: 8px;
-	background: var(--jt-surface);
-}
-.pagination-nav__link:hover {
-	border-color: var(--jt-accent-border);
-	background: var(--jt-surface2);
-}
-
-/* ---------- Footer ---------- */
-.footer,
-.footer--dark {
-	--ifm-footer-background-color: var(--jt-bg2);
-	--ifm-footer-color: var(--jt-text);
-	--ifm-footer-link-color: var(--jt-text);
-	--ifm-footer-title-color: var(--jt-faint);
-	border-top: 1px solid var(--jt-border);
-}
-.footer__title {
-	font-size: 12px;
-	font-weight: 700;
-	letter-spacing: 0.08em;
-	text-transform: uppercase;
-	color: var(--jt-faint);
-}
-.footer__link-item {
-	color: var(--jt-text);
-}
-.footer__link-item:hover {
-	color: var(--jt-accent);
-	text-decoration: none;
-}
-.footer__copyright {
-	color: var(--jt-faint);
-	font-size: 13px;
-	text-align: left;
-}
-.footer__col {
-	font-size: 14px;
-}
-/* Hide the external-link "↗" SVG Docusaurus auto-appends to footer href links —
-   the design uses clean text labels only. The class is CSS-module hashed
-   (iconExternalLink_<hash>), so we target by attribute prefix. */
-.footer__link-item svg,
-.footer__link-item [class*="iconExternalLink"] {
-	display: none;
-}
-
-/* ---------- Code ----------
-   Every surface and text colour here comes from the theme tokens, which already
-   flip between light and dark — the values that used to be hardcoded (#0c111b,
-   #dfe5ee, #94a1b4) were simply the dark side of tokens that existed all along.
-
-   This pairs with `prism.theme: vsLight` / `prism.darkTheme: vsDark` in
-   docusaurus.config.ts. The two must move together (#324): vsDark tokens on a
-   light surface are pale and unreadable, which is why the background was pinned
-   dark in both modes in the first place. If a fenced block still renders dark in
-   light mode, that config is the thing to check. */
-code {
-	background: var(--jt-code-bg);
-	border: 1px solid var(--jt-border);
-	border-radius: 4px;
-	padding: 1px 6px;
-	font-size: var(--ifm-code-font-size);
-	font-family: var(--ifm-font-family-monospace);
-}
-.theme-code-block,
-div[class*="codeBlockContainer"],
-pre[class*="language-"] {
-	border: 1px solid var(--jt-border);
-	border-radius: 12px;
-	/* !important beats the inline background the Prism theme sets on the <pre>. */
-	background: var(--jt-code-bg) !important;
-}
-.theme-code-block code,
-pre[class*="language-"] code {
-	background: transparent !important;
-	border: none !important;
-	/* Base colour for anything Prism does not tokenise. */
-	color: var(--jt-text);
-}
-div[class*="codeBlockTitle"] {
-	background: var(--jt-surface2) !important;
-	color: var(--jt-muted) !important;
-	border-bottom: 1px solid var(--jt-border);
-}
-/* In dark the title sits a shade *below* the block; in light there is no token
-   darker than --jt-code-bg, so the bottom border does the separating instead. */
-[data-theme="dark"] div[class*="codeBlockTitle"] {
-	background: var(--jt-bg) !important;
-}
-[data-theme="light"] .theme-code-block,
-[data-theme="light"] div[class*="codeBlockContainer"],
-[data-theme="light"] pre[class*="language-"] {
-	border-color: var(--jt-border2);
-	box-shadow: 0 8px 24px -18px rgba(12, 18, 28, 0.5);
-}
-
-/* ---------- Markdown tables ----------
-   Rounded container, horizontal row dividers only (no heavy cell gridlines). */
-.markdown table,
-.theme-doc-markdown table,
-article table {
-	display: table;
-	width: 100%;
-	border-collapse: separate;
-	border-spacing: 0;
-	margin: 22px 0;
-	border: 1px solid var(--jt-border);
-	border-radius: 12px;
-	overflow: hidden;
-	font-size: 14px;
-}
-.markdown table thead,
-article table thead {
-	background: var(--jt-bg2);
-}
-.markdown table thead tr,
-article table thead tr {
-	border: none;
-	background: transparent;
-}
-.markdown table th,
-article table th {
-	text-align: left;
-	font-weight: 700;
-	font-size: 12px;
-	letter-spacing: 0.06em;
-	text-transform: uppercase;
-	color: var(--jt-faint);
-	border: none;
-	border-bottom: 1px solid var(--jt-border);
-	padding: 14px 18px;
-}
-.markdown table tbody tr,
-article table tbody tr {
-	background: transparent !important;
-	border: none;
-}
-.markdown table td,
-article table td {
-	border: none;
-	border-bottom: 1px solid var(--jt-border);
-	padding: 13px 18px;
-	vertical-align: middle;
-	color: var(--jt-text);
-}
-.markdown table tbody tr:last-child td,
-article table tbody tr:last-child td {
-	border-bottom: none;
-}
-.markdown table td:first-child,
-article table td:first-child {
-	font-weight: 600;
-	color: var(--jt-heading);
-	white-space: nowrap;
-}
-.markdown table td code,
-.markdown table th code,
-article table td code {
-	background: transparent !important;
-	border: none !important;
-	padding: 0 !important;
-	font-size: 13px;
-}
-.markdown table td:nth-child(2) code,
-article table td:nth-child(2) code {
-	color: var(--jt-accent);
-}
-.markdown table td:nth-child(3),
-article table td:nth-child(3) {
-	color: var(--jt-muted);
-	line-height: 1.9;
-}
-.markdown table td:nth-child(3) code,
-article table td:nth-child(3) code {
-	color: var(--jt-muted);
-}
-
-/* ---------- Buttons ---------- */
-.button--primary {
-	background: var(--jt-accent-fill);
-	border-color: var(--jt-accent-fill);
-	color: var(--jt-on-accent);
-	font-weight: 700;
-}
-.button--primary:hover {
-	background: var(--ifm-color-primary-light);
-	border-color: var(--ifm-color-primary-light);
-	color: var(--jt-on-accent);
-}
-.button--secondary {
-	background: transparent;
-	border-color: var(--jt-border2);
-	color: var(--jt-heading);
-}
-
-/* ============================================================
-   HARDENED DARK SURFACES
-   Infima's dark defaults are grey (#1b1b1d) and the footer is
-   slate. These explicit overrides force the navy palette even
-   if a default loads after this file.
-   ============================================================ */
-[data-theme="dark"] {
-	--ifm-background-color: #0a0e16;
-	--ifm-background-surface-color: #111824;
-	--ifm-navbar-background-color: #0a0e16;
-	--ifm-footer-background-color: #0b101a;
-}
-[data-theme="dark"],
-[data-theme="dark"] body,
-[data-theme="dark"] #__docusaurus,
-[data-theme="dark"] .main-wrapper,
-[data-theme="dark"] .navbar,
-[data-theme="dark"] main {
-	background-color: #0a0e16;
-}
-/* Footer follows the theme: soft grey panel in light mode, page-matching navy
-   in dark mode. Selectors are theme-scoped so the config's `style: 'dark'`
-   (which adds .footer--dark in BOTH modes) can't drag the light-mode footer
-   into a dark slate. */
-html[data-theme="light"] .footer,
-html[data-theme="light"] .footer--dark {
-	background-color: var(--jt-bg2) !important;
-	border-top: 1px solid var(--jt-border);
-}
-html[data-theme="light"] .footer__link-item {
-	color: var(--jt-text) !important;
-}
-html[data-theme="light"] .footer__title {
-	color: var(--jt-faint) !important;
-}
-html[data-theme="light"] .footer__copyright {
-	color: var(--jt-faint) !important;
-}
-html[data-theme="dark"] .footer,
-html[data-theme="dark"] .footer--dark {
-	background-color: #0a0e16 !important;
-	border-top: 1px solid var(--jt-border);
-}
-html[data-theme="dark"] .footer__link-item {
-	color: var(--jt-text) !important;
-}
-html[data-theme="dark"] .footer__title {
-	color: var(--jt-faint) !important;
-}
-html[data-theme="dark"] .footer__copyright {
-	color: var(--jt-faint) !important;
-}
-.footer__link-item:hover {
-	color: var(--jt-accent) !important;
-}