stack-site-builder 1.12.0 → 1.13.0

package/CHANGELOG.md

@@ -11,6 +11,19 @@ content schema, while a consuming site supplies only content, taxonomy data and
 config. Sites track the theme with `pnpm up stack-site-builder`, so each release
 here is a plain version bump they pull in.
 
+## [1.13.0] - 2026-07-20
+
+### Added
+
+- **Optional sections** — a site can turn off any of the secondary sections
+  (concepts, articles, samples, slides, glossary, and the standalone `pages`
+  collection); the core catalog stays on. Disabling one removes both its routes
+  and its header-nav item. Declare `sections` in `src/data/site.ts` (hides the
+  nav item) and forward it to `aasTheme({ sections })` in astro.config (skips the
+  routes); the key type (`SectionKey`) is exported from the theme, so
+  `satisfies Partial<Record<SectionKey, boolean>>` gives autocomplete of the
+  valid keys. The playground drops `slides` to demonstrate.
+
 ## [1.12.0] - 2026-07-20
 
 Locales are now **site-configurable**. The theme was wired to exactly two
@@ -107,6 +120,7 @@ catalog sites from a thin content-only repository.
 - **Standalone development setup** — a devcontainer and a minimal `playground/`
   consuming site for developing and previewing the theme on its own.
 
+[1.13.0]: https://github.com/CodeCompose7/stack-site-builder/compare/v1.12.0...v1.13.0
 [1.12.0]: https://github.com/CodeCompose7/stack-site-builder/compare/v1.11.0...v1.12.0
 [1.11.0]: https://github.com/CodeCompose7/stack-site-builder/compare/v1.10.0...v1.11.0
 [1.10.0]: https://github.com/CodeCompose7/stack-site-builder/releases/tag/v1.10.0

package/README.md

@@ -34,7 +34,7 @@ export const collections = defineAasCollections({ categoryMap });
 
 | Where | What |
 | --- | --- |
-| `src/data/site.ts` | Site identity: name, repo URL, the `locales` it ships, per-locale UI string overrides |
+| `src/data/site.ts` | Site identity: name, repo URL, the `locales` it ships, optional `sections` toggles, per-locale UI string overrides |
 | `src/data/categories.ts` | The tool-catalog category tree (validated against content) |
 | `src/data/concept-categories.ts` · `article-categories.ts` | Taxonomies for concepts / articles |
 | `src/data/glossary.mjs` | `[[Term]]` wikilink targets |
@@ -62,3 +62,31 @@ locale from one source. To add a language (say Japanese):
    labels the same way you did for the built-in locales.
 
 No theme files change — adding a locale is entirely site config and content.
+
+## Sections
+
+The core catalog (home, tool detail, categories, tags, vendors) is always on.
+The rest are opt-out — **concepts, articles, samples, slides, glossary** and the
+standalone **pages** collection (About/소개, …) — so a site can ship only what it
+needs. Turning one off removes both its routes and its header-nav item. (`pages`
+also has finer control: each page's `nav` / `draft` frontmatter, or simply not
+authoring it.)
+
+Declare the toggles once in `src/data/site.ts` and forward them to the theme in
+astro.config (which needs them to skip route injection). Import `SectionKey` from
+the theme so `satisfies` lists the valid keys as you type:
+
+```ts
+// src/data/site.ts
+import type { SectionKey } from 'stack-site-builder';
+export const site = {
+  /* … */
+  sections: { slides: false } satisfies Partial<Record<SectionKey, boolean>>,
+};
+```
+
+```js
+// astro.config.mjs
+import { site } from './src/data/site';
+integrations: [aasTheme({ glossary, sections: site.sections })];
+```

package/index.d.ts

@@ -1,8 +1,18 @@
 import type { AstroIntegration } from 'astro';
 
+/** Optional content sections that a site can turn off. `pages` is the
+ *  standalone-pages collection (About/소개, …). */
+export type SectionKey = 'concepts' | 'articles' | 'samples' | 'slides' | 'glossary' | 'pages';
+
 export interface AasThemeOptions {
   /** The site's glossary (`src/data/glossary.mjs`) — `[[wikilink]]` targets. */
   glossary: Record<string, unknown>;
+  /**
+   * Turn optional sections off (all on by default), e.g. `{ slides: false }`.
+   * A disabled section's routes aren't injected; pass the same object to
+   * `src/data/site.ts` `sections` so its header-nav item is hidden too.
+   */
+  sections?: Partial<Record<SectionKey, boolean>>;
 }
 
 /**

package/index.mjs

@@ -54,13 +54,29 @@ function patternOf(file) {
   return `/${p}`.replace(/\/$/, '') || '/';
 }
 
+// Which optional section each page belongs to (null = always-on core route).
+// Mirrors SectionKey in src/lib/sections.ts.
+/** @param {string} file @returns {string | null} */
+function sectionOf(file) {
+  if (file.startsWith('concept/')) return 'concepts';
+  if (file.startsWith('article/')) return 'articles';
+  if (file.startsWith('sample/')) return 'samples';
+  if (file.startsWith('slides/')) return 'slides';
+  if (file === 'glossary.astro') return 'glossary';
+  if (file === '[page].astro') return 'pages';
+  return null;
+}
+
 /**
  * @param {object} opts
  * @param {Record<string, any>} opts.glossary — the site's glossary
  *   (`src/data/glossary.mjs`), used by `[[wikilink]]` resolution.
+ * @param {Partial<Record<string, boolean>>} [opts.sections] — optional-section
+ *   toggles (`{ slides: false }`); a disabled section's routes are not injected.
+ *   Keep it in sync with `src/data/site.ts` `sections` (which hides the nav item).
  * @returns {import('astro').AstroIntegration[]}
  */
-export default function aasTheme({ glossary }) {
+export default function aasTheme({ glossary, sections = {} }) {
   /** @type {import('astro').AstroIntegration} */
   const core = {
     name: 'stack-site-builder',
@@ -77,7 +93,10 @@ export default function aasTheme({ glossary }) {
         // A single physical page tree under `[...lang]/` serves every locale: the
         // default at the root, each other under `/<code>/`. Each page's
         // getStaticPaths enumerates the locales, so adding one needs no new files.
+        // Skip a page whose optional section the site turned off (`{ slides: false }`).
         for (const file of PAGES) {
+          const section = sectionOf(file);
+          if (section && sections[section] === false) continue;
           injectRoute({
             pattern: patternOf(`[...lang]/${file}`),
             entrypoint: `stack-site-builder/pages/[...lang]/${file}`,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stack-site-builder",
   "type": "module",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "license": "MIT",
   "description": "The engine behind the awesome-*-stack catalog sites: an Astro theme with the catalog/concepts/articles/slides/samples routes, components, styles and markdown pipeline. Sites provide content, taxonomy data and config.",
   "repository": {

package/src/layouts/BaseLayout.astro

@@ -7,6 +7,7 @@ import LanguageSwitcher from '../components/LanguageSwitcher.astro';
 import ThemeToggle from '../components/ThemeToggle.astro';
 import BackToTop from '../components/BackToTop.astro';
 import { getNavPages, pageSlugOf } from '../lib/pages';
+import { sectionEnabled, type SectionKey } from '../lib/sections';
 
 interface Props {
   title: string;
@@ -43,12 +44,13 @@ const navPages = await getNavPages(lang);
 // layouts never drift: an icon-only row (≥sm) and a labelled dropdown menu
 // (<sm, so a phone header stays to a few controls instead of a long icon run).
 // `svg` is the icon's inner markup (drawn into a shared <svg> shell below).
-const navItems: {
+const allNavItems: {
   href: string;
   label: string;
   svg: string;
   external?: boolean;
   keepFilters?: boolean;
+  section?: SectionKey;
 }[] = [
   {
     href: `${home}#categories`,
@@ -59,31 +61,37 @@ const navItems: {
   {
     href: getRelativeLocaleUrl(lang, 'concept/'),
     label: t('nav.concepts'),
+    section: 'concepts',
     svg: '<path d="M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83Z"/><path d="m22 17.65-9.17 4.16a2 2 0 0 1-1.66 0L2 17.65"/><path d="m22 12.65-9.17 4.16a2 2 0 0 1-1.66 0L2 12.65"/>',
   },
   {
     href: getRelativeLocaleUrl(lang, 'article/'),
     label: t('nav.blog'),
+    section: 'articles',
     svg: '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M16 13H8"/><path d="M16 17H8"/><path d="M10 9H8"/>',
   },
   {
     href: getRelativeLocaleUrl(lang, 'sample/'),
     label: t('nav.samples'),
+    section: 'samples',
     svg: '<polyline points="4 17 10 11 4 5"/><line x1="12" x2="20" y1="19" y2="19"/>',
   },
   {
     href: getRelativeLocaleUrl(lang, 'slides/'),
     label: t('nav.slides'),
+    section: 'slides',
     svg: '<path d="M2 3h20"/><path d="M21 3v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V3"/><path d="m7 21 5-5 5 5"/><path d="M12 12v9"/>',
   },
   {
     href: getRelativeLocaleUrl(lang, 'glossary/'),
     label: t('nav.glossary'),
+    section: 'glossary',
     svg: '<path d="M12 7v14"/><path d="M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z"/>',
   },
   ...navPages.map((p) => ({
     href: getRelativeLocaleUrl(lang, `${pageSlugOf(p)}/`),
     label: p.data.navLabel ?? p.data.title,
+    section: 'pages' as SectionKey,
     svg: '<circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/>',
   })),
   {
@@ -93,6 +101,8 @@ const navItems: {
     svg: '<path d="M15 22v-4a4.8 4.8 0 0 0-1-3.5c3 0 6-2 6-5.5.08-1.25-.27-2.48-1-3.5.28-1.15.28-2.35 0-3.5 0 0-1 0-3 1.5-2.64-.5-5.36-.5-8 0C4 2 3 2 3 2c-.3 1.15-.3 2.35 0 3.5A5.4 5.4 0 0 0 2 9c0 3.5 3 5.5 6 5.5-.39.49-.68 1.05-.85 1.65-.17.6-.22 1.23-.15 1.85v4"/><path d="M9 18c-4.51 2-5-2-7-2"/>',
   },
 ];
+// Drop the nav links for sections the site turned off (their routes aren't built).
+const navItems = allNavItems.filter((item) => !item.section || sectionEnabled(item.section));
 ---
 
 <!doctype html>

package/src/lib/sections.ts

@@ -0,0 +1,34 @@
+import { site } from '@aas-data/site';
+
+/**
+ * Optional content sections a site can turn off. The core catalog (home, stack
+ * detail, categories, tags, vendors) is always on; these are opt-out. Disabling
+ * one removes both its routes and its header-nav item (routes are skipped in the
+ * integration, the nav link in BaseLayout).
+ *
+ * `pages` is the standalone-pages collection (About/소개, contact, …); turning it
+ * off drops every page and its nav item at once — finer control is per-page via
+ * the `nav` / `draft` frontmatter, or by not authoring the page.
+ *
+ * A site sets overrides in `src/data/site.ts` (`sections`), which astro.config
+ * also forwards to the theme integration for route filtering. Omitted = enabled.
+ */
+export type SectionKey = 'concepts' | 'articles' | 'samples' | 'slides' | 'glossary' | 'pages';
+
+const DEFAULTS: Record<SectionKey, boolean> = {
+  concepts: true,
+  articles: true,
+  samples: true,
+  slides: true,
+  glossary: true,
+  pages: true,
+};
+
+/** Whether each optional section is enabled, after applying the site's overrides. */
+export const sections: Record<SectionKey, boolean> = {
+  ...DEFAULTS,
+  ...((site as { sections?: Partial<Record<SectionKey, boolean>> }).sections ?? {}),
+};
+
+/** True unless the site explicitly turned `key` off. */
+export const sectionEnabled = (key: SectionKey): boolean => sections[key];