@master/internal-site 0.0.0-stage → 0.1.1

package/dist/config.mjs

@@ -0,0 +1,10 @@
+// src/config.ts
+function defineSite(config) {
+	if (!config.id || !config.name) throw new Error("Site id and name are required");
+	const origin = new URL(config.origin);
+	if (!["http:", "https:"].includes(origin.protocol)) throw new Error("Site origin must use HTTP or HTTPS");
+	if (!config.i18n.locales.includes(config.i18n.defaultLocale)) throw new Error("The default locale must be listed in locales");
+	if (!config.sections.home) throw new Error("A homepage section is required");
+	return config;
+}
+export { defineSite };

package/package.json

@@ -1,6 +1,386 @@
 {
   "name": "@master/internal-site",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "description": "First-party Astro and Svelte website framework for Master sites.",
+  "engines": {
+    "node": "^24"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "!src/**/*.test.*"
+  ],
+  "exports": {
+    "./astro": {
+      "types": "./dist/astro.d.mts",
+      "import": "./dist/astro.mjs"
+    },
+    "./config": {
+      "types": "./dist/config.d.mts",
+      "import": "./dist/config.mjs"
+    },
+    "./site": "./src/docs-shell/site.ts",
+    "./styles/*": "./src/styles/*",
+    "./assets/*": "./src/public/*",
+    "./astro/*": "./src/astro/*",
+    "./build/*": "./src/scripts/*",
+    "./utils/cloudflare-image-loader.js": "./src/utils/cloudflare-image-loader.js",
+    "./package.json": "./package.json",
+    "./components/*": "./src/docs-shell/components/*",
+    "./contexts/*": "./src/docs-shell/contexts/*",
+    "./factories/*": "./src/docs-shell/factories/*",
+    "./layouts/*": "./src/docs-shell/layouts/*",
+    "./types/*": "./src/docs-shell/types/*",
+    "./utils/*": "./src/docs-shell/utils/*",
+    "./common/*": "./src/docs-shell/common/*",
+    "./remark/*": "./src/docs-shell/remark/*",
+    "./data/*": "./src/docs-shell/data/*",
+    "./scripts/*": "./src/docs-shell/scripts/*",
+    "./layouts/Document.astro": "./src/layouts/Document.astro",
+    "./components/PageNavs.astro": "./src/docs-shell/components/PageNavs.astro",
+    "./components/PageContentList.svelte": "./src/docs-shell/components/PageContentList.svelte",
+    "./components/DocVersionSelect.svelte": "./src/docs-shell/components/DocVersionSelect.svelte",
+    "./components/Tabs.astro": "./src/docs-shell/components/Tabs.astro",
+    "./components/page-content.svelte.ts": "./src/docs-shell/components/page-content.svelte.ts",
+    "./components/page-content.svelte": "./src/docs-shell/components/page-content.svelte.ts",
+    "./components/Dropped.astro": "./src/docs-shell/components/Dropped.astro",
+    "./components/Callout.astro": "./src/docs-shell/components/Callout.astro",
+    "./components/Link.svelte": "./src/docs-shell/components/Link.svelte",
+    "./components/DocHeading.astro": "./src/docs-shell/components/DocHeading.astro",
+    "./components/StepL.astro": "./src/docs-shell/components/StepL.astro",
+    "./components/Header.svelte": "./src/docs-shell/components/Header.svelte",
+    "./components/ModeImg.astro": "./src/docs-shell/components/ModeImg.astro",
+    "./components/DocMain.astro": "./src/docs-shell/components/DocMain.astro",
+    "./components/ThemeSelect.svelte": "./src/docs-shell/components/ThemeSelect.svelte",
+    "./components/DocHeader.svelte": "./src/docs-shell/components/DocHeader.svelte",
+    "./components/ThemeIcon.astro": "./src/docs-shell/components/ThemeIcon.astro",
+    "./components/SearchDialog.svelte": "./src/docs-shell/components/SearchDialog.svelte",
+    "./components/Info.astro": "./src/docs-shell/components/Info.astro",
+    "./components/StepR.astro": "./src/docs-shell/components/StepR.astro",
+    "./components/HeaderNav.svelte": "./src/docs-shell/components/HeaderNav.svelte",
+    "./components/page-content-bootstrap.ts": "./src/docs-shell/components/page-content-bootstrap.ts",
+    "./components/page-content-bootstrap": "./src/docs-shell/components/page-content-bootstrap.ts",
+    "./components/DocWrapper.astro": "./src/docs-shell/components/DocWrapper.astro",
+    "./components/markdown-components.ts": "./src/docs-shell/components/markdown-components.ts",
+    "./components/markdown-components": "./src/docs-shell/components/markdown-components.ts",
+    "./components/LanguageSelect.svelte": "./src/docs-shell/components/LanguageSelect.svelte",
+    "./components/PageContentDisclosure.astro": "./src/docs-shell/components/PageContentDisclosure.astro",
+    "./components/RenderNode.astro": "./src/docs-shell/components/RenderNode.astro",
+    "./components/ExpandContent.svelte": "./src/docs-shell/components/ExpandContent.svelte",
+    "./components/InlineCode.astro": "./src/docs-shell/components/InlineCode.astro",
+    "./components/FileIcon.astro": "./src/docs-shell/components/FileIcon.astro",
+    "./components/LanguageButton.svelte": "./src/docs-shell/components/LanguageButton.svelte",
+    "./components/Do.astro": "./src/docs-shell/components/Do.astro",
+    "./components/StepSection.astro": "./src/docs-shell/components/StepSection.astro",
+    "./components/ArticleTOC.astro": "./src/docs-shell/components/ArticleTOC.astro",
+    "./components/ExplorerView.astro": "./src/docs-shell/components/ExplorerView.astro",
+    "./components/PageContentProvider.svelte": "./src/docs-shell/components/PageContentProvider.svelte",
+    "./components/PageContentTitle.svelte": "./src/docs-shell/components/PageContentTitle.svelte",
+    "./components/PackageBadges.astro": "./src/docs-shell/components/PackageBadges.astro",
+    "./components/SearchButton.svelte": "./src/docs-shell/components/SearchButton.svelte",
+    "./components/Image.svelte": "./src/docs-shell/components/Image.svelte",
+    "./components/RouteLayers.astro": "./src/docs-shell/components/RouteLayers.astro",
+    "./components/code-props.ts": "./src/docs-shell/components/code-props.ts",
+    "./components/code-props": "./src/docs-shell/components/code-props.ts",
+    "./components/Footer.svelte": "./src/docs-shell/components/Footer.svelte",
+    "./components/CodeTabBar.astro": "./src/docs-shell/components/CodeTabBar.astro",
+    "./components/PMAction.astro": "./src/docs-shell/components/PMAction.astro",
+    "./components/DocArticle.astro": "./src/docs-shell/components/DocArticle.astro",
+    "./components/OverviewButtons.astro": "./src/docs-shell/components/OverviewButtons.astro",
+    "./components/CodeTabs.astro": "./src/docs-shell/components/CodeTabs.astro",
+    "./components/DoNot.astro": "./src/docs-shell/components/DoNot.astro",
+    "./components/DocSidebar.svelte": "./src/docs-shell/components/DocSidebar.svelte",
+    "./components/PageContentBootstrap.astro": "./src/docs-shell/components/PageContentBootstrap.astro",
+    "./components/PageContent.svelte": "./src/docs-shell/components/PageContent.svelte",
+    "./components/CodeView.astro": "./src/docs-shell/components/CodeView.astro",
+    "./components/Tab.astro": "./src/docs-shell/components/Tab.astro",
+    "./components/NotFound.astro": "./src/docs-shell/components/NotFound.astro",
+    "./components/CodeCopyButton.astro": "./src/docs-shell/components/CodeCopyButton.astro",
+    "./components/ArticleHeader.astro": "./src/docs-shell/components/ArticleHeader.astro",
+    "./components/HeaderIcon.astro": "./src/docs-shell/components/HeaderIcon.astro",
+    "./components/TimeAgo.svelte": "./src/docs-shell/components/TimeAgo.svelte",
+    "./components/InteractingIndicator.astro": "./src/docs-shell/components/InteractingIndicator.astro",
+    "./components/PreparedCodeView.astro": "./src/docs-shell/components/PreparedCodeView.astro",
+    "./components/Segments.svelte": "./src/docs-shell/components/Segments.svelte",
+    "./components/Warn.astro": "./src/docs-shell/components/Warn.astro",
+    "./components/DocMenuButton.svelte": "./src/docs-shell/components/DocMenuButton.svelte",
+    "./components/Translate.astro": "./src/docs-shell/components/Translate.astro",
+    "./components/Code.astro": "./src/docs-shell/components/Code.astro",
+    "./components/Step.astro": "./src/docs-shell/components/Step.astro",
+    "./components/markdown/Table.astro": "./src/docs-shell/components/markdown/Table.astro",
+    "./components/markdown/Heading3.astro": "./src/docs-shell/components/markdown/Heading3.astro",
+    "./components/markdown/Heading2.astro": "./src/docs-shell/components/markdown/Heading2.astro",
+    "./components/markdown/Anchor.astro": "./src/docs-shell/components/markdown/Anchor.astro",
+    "./contexts/theme-mode.svelte.ts": "./src/docs-shell/contexts/theme-mode.svelte.ts",
+    "./contexts/theme-mode.svelte": "./src/docs-shell/contexts/theme-mode.svelte.ts",
+    "./contexts/search.ts": "./src/docs-shell/contexts/search.ts",
+    "./contexts/search": "./src/docs-shell/contexts/search.ts",
+    "./factories/Page.astro": "./src/docs-shell/factories/Page.astro",
+    "./factories/create-page.ts": "./src/docs-shell/factories/create-page.ts",
+    "./factories/create-page": "./src/docs-shell/factories/create-page.ts",
+    "./layouts/Doc.astro": "./src/docs-shell/layouts/Doc.astro",
+    "./types/Props.ts": "./src/docs-shell/types/Props.ts",
+    "./types/Props": "./src/docs-shell/types/Props.ts",
+    "./types/StaticImage.ts": "./src/docs-shell/types/StaticImage.ts",
+    "./types/StaticImage": "./src/docs-shell/types/StaticImage.ts",
+    "./types/Metadata.ts": "./src/docs-shell/types/Metadata.ts",
+    "./types/Metadata": "./src/docs-shell/types/Metadata.ts",
+    "./utils/syntax-theme.ts": "./src/docs-shell/utils/syntax-theme.ts",
+    "./utils/syntax-theme": "./src/docs-shell/utils/syntax-theme.ts",
+    "./utils/resolve-heading.js": "./src/docs-shell/utils/resolve-heading.js",
+    "./utils/resolve-heading": "./src/docs-shell/utils/resolve-heading.js",
+    "./utils/beautify-js.ts": "./src/docs-shell/utils/beautify-js.ts",
+    "./utils/beautify-js": "./src/docs-shell/utils/beautify-js.ts",
+    "./utils/prepared-code.ts": "./src/docs-shell/utils/prepared-code.ts",
+    "./utils/prepared-code": "./src/docs-shell/utils/prepared-code.ts",
+    "./utils/isInteractOutside.ts": "./src/docs-shell/utils/isInteractOutside.ts",
+    "./utils/isInteractOutside": "./src/docs-shell/utils/isInteractOutside.ts",
+    "./utils/highlight-code.ts": "./src/docs-shell/utils/highlight-code.ts",
+    "./utils/highlight-code": "./src/docs-shell/utils/highlight-code.ts",
+    "./utils/slot-text.ts": "./src/docs-shell/utils/slot-text.ts",
+    "./utils/slot-text": "./src/docs-shell/utils/slot-text.ts",
+    "./utils/beautify-css.ts": "./src/docs-shell/utils/beautify-css.ts",
+    "./utils/beautify-css": "./src/docs-shell/utils/beautify-css.ts",
+    "./utils/highlight-code-core.ts": "./src/docs-shell/utils/highlight-code-core.ts",
+    "./utils/highlight-code-core": "./src/docs-shell/utils/highlight-code-core.ts",
+    "./utils/i18n.ts": "./src/docs-shell/utils/i18n.ts",
+    "./utils/i18n": "./src/docs-shell/utils/i18n.ts",
+    "./utils/group-page-content.ts": "./src/docs-shell/utils/group-page-content.ts",
+    "./utils/group-page-content": "./src/docs-shell/utils/group-page-content.ts",
+    "./utils/head.ts": "./src/docs-shell/utils/head.ts",
+    "./utils/head": "./src/docs-shell/utils/head.ts",
+    "./utils/i18n-pathname.ts": "./src/docs-shell/utils/i18n-pathname.ts",
+    "./utils/i18n-pathname": "./src/docs-shell/utils/i18n-pathname.ts",
+    "./utils/generate-metadata.ts": "./src/docs-shell/utils/generate-metadata.ts",
+    "./utils/generate-metadata": "./src/docs-shell/utils/generate-metadata.ts",
+    "./utils/is-date-within-seven-days.ts": "./src/docs-shell/utils/is-date-within-seven-days.ts",
+    "./utils/is-date-within-seven-days": "./src/docs-shell/utils/is-date-within-seven-days.ts",
+    "./utils/beautify-html.ts": "./src/docs-shell/utils/beautify-html.ts",
+    "./utils/beautify-html": "./src/docs-shell/utils/beautify-html.ts",
+    "./utils/css-modern-grammar.ts": "./src/docs-shell/utils/css-modern-grammar.ts",
+    "./utils/css-modern-grammar": "./src/docs-shell/utils/css-modern-grammar.ts",
+    "./utils/search-pages.ts": "./src/docs-shell/utils/search-pages.ts",
+    "./utils/search-pages": "./src/docs-shell/utils/search-pages.ts",
+    "./utils/documentation-search.ts": "./src/docs-shell/utils/documentation-search.ts",
+    "./utils/documentation-search": "./src/docs-shell/utils/documentation-search.ts",
+    "./utils/highlighted-code-text.ts": "./src/docs-shell/utils/highlighted-code-text.ts",
+    "./utils/highlighted-code-text": "./src/docs-shell/utils/highlighted-code-text.ts",
+    "./utils/markdown-tree.ts": "./src/docs-shell/utils/markdown-tree.ts",
+    "./utils/markdown-tree": "./src/docs-shell/utils/markdown-tree.ts",
+    "./utils/isBrowser.ts": "./src/docs-shell/utils/isBrowser.ts",
+    "./utils/isBrowser": "./src/docs-shell/utils/isBrowser.ts",
+    "./utils/create-highlighter.ts": "./src/docs-shell/utils/create-highlighter.ts",
+    "./utils/create-highlighter": "./src/docs-shell/utils/create-highlighter.ts",
+    "./utils/anchor.ts": "./src/docs-shell/utils/anchor.ts",
+    "./utils/anchor": "./src/docs-shell/utils/anchor.ts",
+    "./utils/transformer-notation-word-mark.ts": "./src/docs-shell/utils/transformer-notation-word-mark.ts",
+    "./utils/transformer-notation-word-mark": "./src/docs-shell/utils/transformer-notation-word-mark.ts",
+    "./utils/metadata.ts": "./src/docs-shell/utils/metadata.ts",
+    "./utils/metadata": "./src/docs-shell/utils/metadata.ts",
+    "./utils/snackbar.ts": "./src/docs-shell/utils/snackbar.ts",
+    "./utils/snackbar": "./src/docs-shell/utils/snackbar.ts",
+    "./utils/unique-id.ts": "./src/docs-shell/utils/unique-id.ts",
+    "./utils/unique-id": "./src/docs-shell/utils/unique-id.ts",
+    "./common/i18n.config.js": "./src/docs-shell/common/i18n.config.js",
+    "./common/i18n.config": "./src/docs-shell/common/i18n.config.js",
+    "./common/svgo.config.js": "./src/docs-shell/common/svgo.config.js",
+    "./common/svgo.config": "./src/docs-shell/common/svgo.config.js",
+    "./remark/slug-and-toc.js": "./src/docs-shell/remark/slug-and-toc.js",
+    "./remark/slug-and-toc": "./src/docs-shell/remark/slug-and-toc.js",
+    "./remark/markdown-components.js": "./src/docs-shell/remark/markdown-components.js",
+    "./remark/markdown-components": "./src/docs-shell/remark/markdown-components.js",
+    "./data/colors.ts": "./src/docs-shell/data/colors.ts",
+    "./data/colors": "./src/docs-shell/data/colors.ts",
+    "./data/base-colors.ts": "./src/docs-shell/data/base-colors.ts",
+    "./data/base-colors": "./src/docs-shell/data/base-colors.ts",
+    "./data/authors.ts": "./src/docs-shell/data/authors.ts",
+    "./data/authors": "./src/docs-shell/data/authors.ts",
+    "./data/brands.ts": "./src/docs-shell/data/brands.ts",
+    "./data/brands": "./src/docs-shell/data/brands.ts",
+    "./data/color-names.ts": "./src/docs-shell/data/color-names.ts",
+    "./data/color-names": "./src/docs-shell/data/color-names.ts",
+    "./data/color-palette.ts": "./src/docs-shell/data/color-palette.ts",
+    "./data/color-palette": "./src/docs-shell/data/color-palette.ts",
+    "./scripts/document.ts": "./src/docs-shell/scripts/document.ts",
+    "./scripts/document": "./src/docs-shell/scripts/document.ts",
+    "./scripts/document-anchor.ts": "./src/docs-shell/scripts/document-anchor.ts",
+    "./scripts/document-anchor": "./src/docs-shell/scripts/document-anchor.ts",
+    "./scripts/code.ts": "./src/docs-shell/scripts/code.ts",
+    "./scripts/code": "./src/docs-shell/scripts/code.ts",
+    "./scripts/code-tabs-bootstrap.ts": "./src/docs-shell/scripts/code-tabs-bootstrap.ts",
+    "./scripts/code-tabs-bootstrap": "./src/docs-shell/scripts/code-tabs-bootstrap.ts",
+    "./astro/propagated-assets.ts": "./src/astro/propagated-assets.ts",
+    "./astro/propagated-assets": "./src/astro/propagated-assets.ts",
+    "./astro/source-url.ts": "./src/astro/source-url.ts",
+    "./astro/source-url": "./src/astro/source-url.ts",
+    "./astro/server-styles.ts": "./src/astro/server-styles.ts",
+    "./astro/server-styles": "./src/astro/server-styles.ts",
+    "./astro/module-id.ts": "./src/astro/module-id.ts",
+    "./astro/module-id": "./src/astro/module-id.ts",
+    "./astro/site-context.ts": "./src/astro/site-context.ts",
+    "./astro/site-context": "./src/astro/site-context.ts",
+    "./astro/route-paths.ts": "./src/astro/route-paths.ts",
+    "./astro/route-paths": "./src/astro/route-paths.ts",
+    "./astro/svg-markup.ts": "./src/astro/svg-markup.ts",
+    "./astro/svg-markup": "./src/astro/svg-markup.ts",
+    "./astro/index.ts": "./src/astro/index.ts",
+    "./astro/index": "./src/astro/index.ts",
+    "./astro/svelte-renderer.ts": "./src/astro/svelte-renderer.ts",
+    "./astro/svelte-renderer": "./src/astro/svelte-renderer.ts",
+    "./sections/*": "./src/sections/*",
+    "./env": "./src/virtual.d.ts",
+    "./home/*": "./src/home/*",
+    "./blog/*": "./src/blog/*",
+    "./demo/*": "./src/demo/*",
+    "./demo/style": "./src/demo/style.ts",
+    "./blog/article/language": "./src/blog/article/language.ts",
+    "./blog/article/neighbors": "./src/blog/article/neighbors.ts",
+    "./blog/article/title-parts": "./src/blog/article/title-parts.ts",
+    "./home/home-lamp": "./src/home/home-lamp.ts",
+    "./home/hero-title-mask": "./src/home/hero-title-mask.ts",
+    "./home/hero-shaders": "./src/home/hero-shaders.ts",
+    "./benchmarks/*": "./src/benchmarks/*",
+    "./demo/copy-feedback": "./src/demo/copy-feedback.ts",
+    "./demo/demo-waterfall": "./src/demo/demo-waterfall.ts",
+    "./demo/drag-readings": "./src/demo/drag-readings.ts",
+    "./demo/playback": "./src/demo/playback.ts",
+    "./demo/tone": "./src/demo/tone.ts",
+    "./demo/useDemoViewTransition.svelte": "./src/demo/useDemoViewTransition.svelte.ts",
+    "./benchmarks/utils": "./src/benchmarks/utils.ts",
+    "./benchmarks/types": "./src/benchmarks/types.ts",
+    "./components/document-types": "./src/docs-shell/components/document-types.ts",
+    "./css/*": "./src/css/*",
+    "./demo/maintenance-example": "./src/demo/maintenance-example.ts",
+    "./demo/project-style-examples": "./src/demo/project-style-examples.ts",
+    "./demo/reference/sizing": "./src/demo/reference/sizing.ts",
+    "./demo/reference/text-effects": "./src/demo/reference/text-effects.ts",
+    "./demo/reference/source": "./src/demo/reference/source.ts",
+    "./demo/reference/scrolling": "./src/demo/reference/scrolling.ts",
+    "./demo/reference/flexbox": "./src/demo/reference/flexbox.ts",
+    "./demo/reference/layout-html": "./src/demo/reference/layout-html.ts",
+    "./demo/reference/type-specimens": "./src/demo/reference/type-specimens.ts",
+    "./demo/reference/scenes": "./src/demo/reference/scenes.ts",
+    "./demo/reference/document": "./src/demo/reference/document.ts",
+    "./demo/reference/transitions": "./src/demo/reference/transitions.ts",
+    "./demo/reference/clipping": "./src/demo/reference/clipping.ts",
+    "./demo/reference/types": "./src/demo/reference/types.ts",
+    "./demo/reference/edges": "./src/demo/reference/edges.ts",
+    "./demo/reference/html": "./src/demo/reference/html.ts",
+    "./demo/reference/layout": "./src/demo/reference/layout.ts",
+    "./demo/reference/alignment": "./src/demo/reference/alignment.ts",
+    "./demo/reference/interaction": "./src/demo/reference/interaction.ts",
+    "./demo/reference/border-paint": "./src/demo/reference/border-paint.ts",
+    "./demo/reference/text-flow": "./src/demo/reference/text-flow.ts",
+    "./demo/reference/positioning": "./src/demo/reference/positioning.ts",
+    "./demo/reference/backgrounds": "./src/demo/reference/backgrounds.ts",
+    "./demo/reference/shapes": "./src/demo/reference/shapes.ts",
+    "./demo/reference/media": "./src/demo/reference/media.ts",
+    "./demo/reference/transforms": "./src/demo/reference/transforms.ts",
+    "./demo/reference/typography": "./src/demo/reference/typography.ts",
+    "./demo/reference/grid": "./src/demo/reference/grid.ts",
+    "./demo/reference/animations": "./src/demo/reference/animations.ts",
+    "./demo/reference/effects": "./src/demo/reference/effects.ts",
+    "./css/foundation-data/specimens": "./src/css/foundation-data/specimens.ts",
+    "./css/foundation-data/tokens": "./src/css/foundation-data/tokens.ts",
+    "./css/foundation-data/specimen-content": "./src/css/foundation-data/specimen-content.ts",
+    "./css/foundation-data/sizing/scale-data": "./src/css/foundation-data/sizing/scale-data.ts",
+    "./css/foundation-data/elevation/shadow-data": "./src/css/foundation-data/elevation/shadow-data.ts",
+    "./css/preset-manifest": "./src/css/preset-manifest.ts",
+    "./css/theme-variables": "./src/css/theme-variables.ts",
+    "./css/manifest-utilities": "./src/css/manifest-utilities.ts",
+    "./css/variable-namespace-sources": "./src/css/variable-namespace-sources.ts",
+    "./css/preset-css": "./src/css/preset-css.ts",
+    "./css/generate-preset-css": "./src/css/generate-preset-css.ts",
+    "./css/configured-example": "./src/css/configured-example.ts",
+    "./examples/*": "./src/examples/*",
+    "./home/icons/artwork": "./src/home/icons/artwork.ts",
+    "./home/icons/catalog": "./src/home/icons/catalog.ts",
+    "./home/home-illustration": "./src/home/home-illustration.ts",
+    "./css/stylesheet-example": "./src/css/stylesheet-example.ts",
+    "./css/highlight": "./src/css/highlight.ts"
+  },
+  "peerDependencies": {
+    "astro": "7.4.2",
+    "svelte": "5.57.2",
+    "@master/css": "0.0.0 || >=0.0.0-site.1793646900.gdf48b35846c1 <0.0.1",
+    "@master/css-astro": "0.0.0 || >=0.0.0-site.1793646900.gdf48b35846c1 <0.0.1",
+    "vite": "8.3.5",
+    "@master/css-compiler": "0.0.0 || >=0.0.0-site.1793646900.gdf48b35846c1 <0.0.1",
+    "@master/css-tooling": "0.0.0 || >=0.0.0-site.1793646900.gdf48b35846c1 <0.0.1",
+    "@master/css-schema": "0.0.0 || >=0.0.0-site.1793646900.gdf48b35846c1 <0.0.1",
+    "@master/css-preset": "0.0.0 || >=0.0.0-site.1793646900.gdf48b35846c1 <0.0.1",
+    "@master/css-language-service": "0.0.0 || >=0.0.0-site.1793646900.gdf48b35846c1 <0.0.1"
+  },
+  "dependencies": {
+    "@astrojs/svelte": "^9.1.2",
+    "@shikijs/langs": "^4.4.3",
+    "@shikijs/transformers": "^4.4.3",
+    "@tabler/icons-svelte-runes": "^3.50.0",
+    "acorn": "^8.18.0",
+    "clsx": "^2.1.1",
+    "colorjs.io": "^0.7.1",
+    "dayjs": "^1.11.23",
+    "defu": "^6.1.7",
+    "fast-glob": "^3.3.3",
+    "fuse.js": "^7.5.0",
+    "github-slugger": "^2.0.0",
+    "hast-util-to-html": "^9.0.5",
+    "html": "^1.0.0",
+    "js-beautify": "^2.0.3",
+    "mdast-util-from-markdown": "2.0.3",
+    "mdast-util-mdxjs-esm": "^2.0.1",
+    "micromark-extension-mdxjs-esm": "^3.0.0",
+    "package-manager-detector": "^1.8.0",
+    "remark": "^15.0.1",
+    "remark-gfm": "^4.0.1",
+    "shiki": "^4.4.3",
+    "svgo": "^4.1.0",
+    "theme-mode": "^1.1.1",
+    "throttle-debounce": "^5.0.2",
+    "ts-dedent": "^2.3.0",
+    "unist-util-visit": "^5.1.0",
+    "@astrojs/mdx": "^8.1.2",
+    "@astrojs/markdown-remark": "^7.3.4",
+    "@resvg/resvg-js": "2.6.2",
+    "satori": "0.63.2",
+    "mdast-util-mdx-jsx": "^3.2.0",
+    "micromark-extension-mdx-jsx": "^3.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/master-co/master.git",
+    "directory": "packages/internal-site"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "node --import tsx --test 'src/**/*.test.ts'",
+    "type-check": "astro-check --tsconfig tsconfig.json && svelte-check --tsconfig tsconfig.json"
+  },
+  "peerDependenciesMeta": {
+    "@master/css-compiler": {
+      "optional": true
+    },
+    "@master/css-tooling": {
+      "optional": true
+    },
+    "@master/css-schema": {
+      "optional": true
+    },
+    "@master/css-preset": {
+      "optional": true
+    },
+    "@master/css-language-service": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@astrojs/check": "0.9.12",
+    "svelte-check": "4.7.7"
+  }
+}

package/src/astro/Page.astro

@@ -0,0 +1,12 @@
+---
+import Document from '../layouts/Document.astro'
+import RouteLayers from '../docs-shell/components/RouteLayers.astro'
+import { getStaticPaths as getRoutePaths, loadRoute } from 'virtual:master-site/routes'
+
+export const getStaticPaths = getRoutePaths
+const route = await loadRoute(Astro.props)
+---
+
+<Document metadata={route.metadata} assets={route.assets} bodyClass={route.bodyClass} locales={route.locales} bare={route.bare}>
+  <RouteLayers layers={route.layers} props={route.props} />
+</Document>

package/src/astro/content-pages.ts

@@ -0,0 +1,75 @@
+import { readdir, readFile, mkdir, writeFile, unlink } from 'node:fs/promises'
+import { join, relative, dirname } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import type { SiteConfig } from '../config'
+
+export async function contentFiles(directory: string): Promise<string[]> {
+  const files: string[] = []
+  for (const entry of await readdir(directory, { withFileTypes: true })) {
+    const path = join(directory, entry.name)
+    if (entry.isDirectory()) files.push(...await contentFiles(path))
+    else if (entry.isFile()) files.push(path)
+  }
+  return files
+}
+
+const specifier = (url: URL) => JSON.stringify('/@fs/' + fileURLToPath(url))
+
+/** Generate only ordinary MDX wrappers; content and metadata remain statically imported. */
+export async function prepareContentPages(site: SiteConfig, root: string, contentPrefix: string) {
+  const content = fileURLToPath(site.content)
+  const files = new Set(await contentFiles(content))
+  const destination = join(root, '.astro/master-site/pages')
+  const pages: Record<string, URL> = {}
+  const wanted = new Set<string>()
+  for (const file of files) {
+    if (!file.endsWith('/content.mdx')) continue
+    const directory = dirname(file)
+    if (files.has(join(directory, 'page.astro'))) continue
+    const metadata = join(directory, 'metadata.ts')
+    if (!files.has(metadata)) throw new Error(`${file} requires metadata.ts or an explicit page.astro`)
+    const route = relative(content, directory).replaceAll('\\', '/')
+    const section = route.split('/').find(segment => !/^\(.+\)$/.test(segment)) ?? 'home'
+    const config = site.documents?.[section]
+    if (!config) throw new Error(`${file} requires documents.${section} configuration or an explicit page.astro`)
+    const output = join(destination, route, 'page.astro')
+    const source = `---
+// Generated by @master/internal-site; edit the content or site config.
+import Page from '@master/internal-site/factories/Page.astro'
+import { createPageMetadata } from '@master/internal-site/factories/create-page'
+import Layout from ${specifier(config.layout)}
+import dictionaries from ${specifier(config.dictionaries)}
+import metadata from ${specifier(pathToFileURL(metadata))}
+import * as content from ${specifier(pathToFileURL(file))}
+${config.categories ? `import categories from ${specifier(config.categories)}` : 'const categories = undefined'}
+export const generateMetadata = createPageMetadata(metadata, dictionaries)
+---
+<Page {...Astro.props} {metadata} {dictionaries} {categories} {content} {Layout} />
+`
+    await mkdir(dirname(output), { recursive: true })
+    if (await readFile(output, 'utf8').catch(() => '') !== source) await writeFile(output, source)
+    wanted.add(output)
+    pages[`${contentPrefix}/${route ? route + '/' : ''}page.astro`] = pathToFileURL(output)
+  }
+  for (const stale of await contentFiles(destination).catch(() => [])) {
+    if (stale.endsWith('/page.astro') && !wanted.has(stale)) await unlink(stale)
+  }
+  const availableLocales: Record<string, readonly string[]> = {}
+  for (const file of files) {
+    if (!file.endsWith('/content.mdx')) continue
+    const directory = dirname(file)
+    const route = relative(content, directory).replaceAll('\\', '/')
+    const section = route.split('/').find(segment => !/^\(.+\)$/.test(segment)) ?? 'home'
+    if (!site.i18n.translatedOnly?.includes(section)) continue
+    availableLocales[`${contentPrefix}/${route ? route + '/' : ''}page.astro`] = site.i18n.locales.filter(locale =>
+      locale === site.i18n.defaultLocale || files.has(join(directory, `content.${locale}.mdx`)))
+  }
+  // A translated archive exists only when at least one article is translated.
+  for (const section of site.i18n.translatedOnly ?? []) {
+    const key = `${contentPrefix}/${section}/page.astro`
+    if (!files.has(join(content, section, 'page.astro'))) continue
+    const published = Object.entries(availableLocales).filter(([page]) => page.startsWith(`${contentPrefix}/${section}/`))
+    availableLocales[key] = site.i18n.locales.filter(locale => locale === site.i18n.defaultLocale || published.some(([, locales]) => locales.includes(locale)))
+  }
+  return { pages, availableLocales }
+}

package/src/astro/index.ts

@@ -0,0 +1,124 @@
+import type { AstroIntegration } from 'astro'
+import { svgoOptimizer } from 'astro/config'
+import svelte from '@astrojs/svelte'
+import mdx from '@astrojs/mdx'
+import { unified } from '@astrojs/markdown-remark'
+import masterCSS from '@master/css-astro'
+import { fileURLToPath } from 'node:url'
+import { extname, relative, resolve, sep } from 'node:path'
+import { readFile, cp, mkdir } from 'node:fs/promises'
+import { createReadStream, existsSync } from 'node:fs'
+import { searchForWorkspaceRoot, transformWithOxc, type Plugin } from 'vite'
+import type { SiteConfig } from '../config'
+import sourceURL from './source-url'
+import { prepareContentPages } from './content-pages'
+import serverStyles from './server-styles'
+import svgMarkup from './svg-markup'
+import remarkSlugAndTOC from '../docs-shell/remark/slug-and-toc.js'
+import remarkMarkdownComponents from '../docs-shell/remark/markdown-components.js'
+import svgoConfig from '../docs-shell/common/svgo.config.js'
+
+const packageSource = fileURLToPath(new URL('..', import.meta.url))
+const fsImport = (url: URL) => '/@fs/' + fileURLToPath(url)
+const moduleImport = (url: URL) => `export { default } from ${JSON.stringify(fsImport(url))}`
+const propagated = (url: URL) => `() => import(${JSON.stringify(fsImport(url) + '?astroPropagatedAssets')}).then(m => m.default)`
+
+export default function masterSite(site: SiteConfig): AstroIntegration {
+  let output: URL
+  return {
+    name: '@master/internal-site',
+    hooks: {
+      'astro:config:setup': async ({ config, updateConfig, addRenderer, injectRoute }) => {
+        const root = fileURLToPath(config.root)
+        const contentRelative = relative(root, fileURLToPath(site.content)).split(sep).join('/')
+        if (contentRelative.startsWith('..')) throw new Error('Site content must be inside the Astro project root')
+        const contentPrefix = '/' + contentRelative.replace(/\/$/, '')
+        const prepared = await prepareContentPages(site, root, contentPrefix)
+        const routeOptions = { contentRoot: contentPrefix + '/', defaultLocale: site.i18n.defaultLocale, locales: site.i18n.locales, sectionLocales: site.i18n.sectionLocales, availableLocales: prepared.availableLocales }
+        const imports = {
+          'virtual:master-site/navigation': Object.entries(site.navigation ?? {}).map(([key, url], index) => `import data${index} from ${JSON.stringify(fsImport(url))}`).join('\n') + `\nexport default {${Object.keys(site.navigation ?? {}).map((key, index) => `${JSON.stringify(key)}: data${index}`).join(',')}}`,
+          'virtual:master-site/config': `export default ${JSON.stringify(site)}`,
+          'virtual:master-site/app': moduleImport(site.app),
+          'virtual:master-site/highlight': moduleImport(site.highlighter ?? new URL('../docs-shell/utils/highlight-code-core.ts', import.meta.url)),
+          'virtual:master-site/translations': `export default import.meta.glob(${JSON.stringify(`${contentPrefix}/**/content.*.mdx`)})`,
+        }
+        const plugin: Plugin = {
+          name: '@master/internal-site:modules',
+          resolveId(id) {
+            if (id === 'virtual:master-site/routes') return '\0' + id + '.ts'
+            if (id in imports) return '\0' + id
+          },
+          async load(id) {
+            if (id.slice(1) in imports) return imports[id.slice(1) as keyof typeof imports]
+            if (id !== '\0virtual:master-site/routes.ts') return
+            let source = await readFile(new URL('./routes.template.ts', import.meta.url), 'utf8')
+            source = source.replaceAll('__CONTENT_PREFIX__', contentPrefix)
+            source = source.replace('__ROUTE_OPTIONS__', JSON.stringify(routeOptions))
+            source = source.replace('__GENERATED_PAGES__', `{${Object.entries(prepared.pages).map(([name, url]) => `${JSON.stringify(name)}: ${propagated(url)}`).join(',\n')}}`)
+            const sections = Object.entries(site.sections).map(([name, url]) => `${JSON.stringify(`/sections/${name}.astro`)}: ${propagated(url)}`).join(',\n')
+            source = source.replace('__SECTION_IMPORTS__', `{${sections}}`)
+            for (const boundary of ['site', 'interface', 'documents'] as const) {
+              const url = site.styles?.[boundary] ?? new URL(`../styles/${boundary}.ts`, import.meta.url)
+              source = source.replace(`__${boundary.toUpperCase()}_IMPORT__`, `{${JSON.stringify(`/styles/${boundary}.ts`)}: ${propagated(url)}}`)
+            }
+            source = source.replace('__SECTION_SHELLS__', JSON.stringify(Object.fromEntries(Object.keys(site.sections).map(key => [key, key]))))
+            return transformWithOxc(source, 'master-site-routes.ts')
+          },
+          configureServer(server) {
+            // Adding/removing an ordinary document changes generated route imports.
+            // Restart through Vite so Astro rebuilds config and its lazy route map.
+            const routeFile = /(?:^|\/)(?:content(?:\.[^/]+)?\.mdx|metadata\.ts|page\.astro|params\.ts|layout\.astro)$/
+            let restart: ReturnType<typeof setTimeout> | undefined
+            const refresh = (file: string) => {
+              if (!file.startsWith(fileURLToPath(site.content)) || !routeFile.test(file.replaceAll('\\', '/'))) return
+              clearTimeout(restart)
+              restart = setTimeout(() => { void server.restart() }, 100)
+            }
+            server.watcher.on('add', refresh).on('unlink', refresh)
+            server.httpServer?.once('close', () => {
+              clearTimeout(restart)
+              server.watcher.off('add', refresh).off('unlink', refresh)
+            })
+            // Serve package-owned assets without copying them into the consumer's source tree.
+            // A consumer's public asset takes precedence at the same URL.
+            server.middlewares.use((request, response, next) => {
+              let pathname: string
+              try { pathname = decodeURIComponent(new URL(request.url ?? '/', 'http://localhost').pathname) }
+              catch { return next() }
+              if (!/^\/(fonts|icons|images|brand|demo)\//.test(pathname)) return next()
+              const directory = resolve(packageSource, 'public') + sep
+              const file = resolve(directory, '.' + pathname)
+              if (!file.startsWith(directory) || !existsSync(file) || existsSync(resolve(root, 'public', '.' + pathname))) return next()
+              const contentTypes: Record<string, string> = { '.woff2': 'font/woff2', '.ttf': 'font/ttf', '.css': 'text/css', '.svg': 'image/svg+xml', '.png': 'image/png', '.jpg': 'image/jpeg', '.webp': 'image/webp', '.ico': 'image/x-icon', '.json': 'application/json' }
+              const type = contentTypes[extname(file)]
+              if (!type) return next()
+              response.setHeader('Content-Type', type)
+              createReadStream(file).pipe(response)
+            })
+          }
+        }
+        addRenderer({
+          name: '@master/internal-site:svelte',
+          serverEntrypoint: fileURLToPath(new URL('./svelte-renderer.ts', import.meta.url)),
+          clientEntrypoint: '@astrojs/svelte/client.js'
+        })
+        injectRoute({ pattern: '/[...path]', entrypoint: new URL('./Page.astro', import.meta.url), prerender: true })
+        updateConfig({
+          site: site.origin,
+          trailingSlash: 'never',
+          build: { format: 'file' },
+          markdown: { processor: unified({ remarkPlugins: [remarkSlugAndTOC, remarkMarkdownComponents], gfm: true, smartypants: false }), syntaxHighlight: false },
+          experimental: { svgOptimizer: svgoOptimizer(svgoConfig as Parameters<typeof svgoOptimizer>[0]) },
+          vite: { plugins: [plugin, sourceURL(), serverStyles([root, packageSource]), svgMarkup()], resolve: { dedupe: ['svelte'] }, server: { fs: { allow: [searchForWorkspaceRoot(root), packageSource] } } },
+          integrations: [svelte(), mdx(), masterCSS({ mode: 'progressive' })]
+        })
+      },
+      'astro:config:done': ({ config }) => { output = config.outDir },
+      'astro:build:done': async () => {
+        const destination = output
+        await mkdir(destination, { recursive: true })
+        await cp(new URL('../public/', import.meta.url), destination, { recursive: true, force: false })
+      }
+    }
+  }
+}