From 73c02df21ea47e979ed6bd736106794589b1655d Mon Sep 17 00:00:00 2001
From: Alex Grozav <alex@grozav.com>
Date: Tue, 28 Jul 2026 07:57:32 +0300
Subject: [PATCH 1/3] refactor(docs): consume layer plumbing instead of forking
 it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`@uxfront/layer-docs` now ships the collections builder options, the
locale files, the Content Studio schema and the Vite prebundle hints, so
the local forks are dead weight. Net -2150 lines.

- `content.config.ts`: 118 lines -> 11. `defineDocsCollections(DOCS_SECTIONS,
  { sitemap: true, changelog: true })`. Section topology stays local in
  `app/constants/sections.ts`; the collection shapes, per-locale fan-out and
  schemas come from the layer.
- Deleted `i18n/locales/` (31 files), `nuxt.schema.ts`,
  `modules/optimizeDeps.ts` and `modules/useDocusI18nOverride.ts`. That
  module's own docblock said to remove it once the package shipped its
  locales; it does now.
- Deleted 18 shadow copies that re-declared layer files at the same relative
  path. Layer precedence meant every upstream fix to those files was
  invisible here — notably the `AppHeader` anchor-nesting a11y fix, which is
  now actually in effect (verified: max anchor nesting depth 1 in the
  prerendered header).
- Deleted `utils/prerender.ts`; the layer's `app/utils/prerender.ts` is
  equivalent and auto-imported, so the explicit relative import goes too.
- `app.config.ts` declares `docsTheme.frameworks` (React/Vanilla/Vue, order
  preserved). The layer no longer ships a default list.

Four shadows are kept deliberately, each now carrying a docblock naming its
delta and its deletion trigger:

- `useDocsSections.ts` — the `THEME_SUBSECTIONS` split is a styleframe
  content shape. Rebased onto the layer copy, which adds the missing
  `hasSectionSwitcher`; without it the layer's `AppSubHeader` read
  `undefined` and the docs sub-header never rendered.
- `DocsAsideLeftBody.vue` — theme-subsection nav filter and the `ProIcon`
  badge.
- both `[...slug].vue` pages — `defineOgImage`; `nuxt-og-image` and the
  `DocsSatori` template are registered here, not in the theme. Rebased to
  take the layer's `USeparator decorative` a11y fix.
- `app/types/non-route-categories.ts` — a deliberate duplicate, because
  `modules/nonRouteCategories.ts` imports it by relative path at build time
  and that module has not moved into the layer yet.

Requires @uxfront/layer-docs@0.2.0, which is not published yet.

Refs UXF-119, UXF-3
---
 apps/docs/app/app.config.ts                   |  14 +
 apps/docs/app/app.vue                         | 164 ------------
 apps/docs/app/components/LanguageSelect.vue   |  74 ------
 apps/docs/app/components/app/AppHeader.vue    | 112 --------
 .../app/components/content/BrowserFrame.vue   |  28 --
 .../components/content/FrameworkSwitcher.vue  |  23 --
 .../components/content/GradientPageHero.vue   |  17 --
 apps/docs/app/components/content/Video.vue    | 106 --------
 .../app/components/docs/DocsAsideLeftBody.vue |   7 +
 .../app/components/docs/DocsAsideLeftTop.vue  |  16 --
 .../components/docs/DocsFrameworkSelect.vue   |  20 --
 apps/docs/app/composables/useDocsSections.ts  |  18 +-
 apps/docs/app/composables/useDocusI18n.ts     |  49 ----
 apps/docs/app/composables/useFramework.ts     |  32 ---
 apps/docs/app/error.vue                       | 166 ------------
 apps/docs/app/layouts/default.vue             |  25 --
 apps/docs/app/pages/[[lang]]/[...slug].vue    |   8 +
 .../[[lang]]/docs/[section]/[...slug].vue     |  14 +-
 apps/docs/app/types/non-route-categories.ts   |   6 +
 apps/docs/app/utils/flattenNavigation.ts      |  24 --
 apps/docs/app/utils/foldNonRouteCategories.ts |  55 ----
 apps/docs/content.config.ts                   | 127 +--------
 apps/docs/i18n/locales/ar.json                |  22 --
 apps/docs/i18n/locales/be.json                |  22 --
 apps/docs/i18n/locales/bn.json                |  22 --
 apps/docs/i18n/locales/ca.json                |  22 --
 apps/docs/i18n/locales/ckb.json               |  18 --
 apps/docs/i18n/locales/cs.json                |  22 --
 apps/docs/i18n/locales/da.json                |  22 --
 apps/docs/i18n/locales/de.json                |  22 --
 apps/docs/i18n/locales/el.json                |  22 --
 apps/docs/i18n/locales/en.json                |  22 --
 apps/docs/i18n/locales/et.json                |  22 --
 apps/docs/i18n/locales/fr.json                |  22 --
 apps/docs/i18n/locales/he.json                |  22 --
 apps/docs/i18n/locales/hi.json                |  22 --
 apps/docs/i18n/locales/hy.json                |  22 --
 apps/docs/i18n/locales/it.json                |  18 --
 apps/docs/i18n/locales/ja.json                |  22 --
 apps/docs/i18n/locales/kk.json                |  22 --
 apps/docs/i18n/locales/km.json                |  22 --
 apps/docs/i18n/locales/ko.json                |  22 --
 apps/docs/i18n/locales/ky.json                |  22 --
 apps/docs/i18n/locales/lb.json                |  22 --
 apps/docs/i18n/locales/ms.json                |  22 --
 apps/docs/i18n/locales/nb.json                |  22 --
 apps/docs/i18n/locales/pl.json                |  22 --
 apps/docs/i18n/locales/ru.json                |  22 --
 apps/docs/i18n/locales/sl.json                |  22 --
 apps/docs/i18n/locales/sv.json                |  22 --
 apps/docs/i18n/locales/uk.json                |  22 --
 apps/docs/i18n/locales/ur.json                |  22 --
 apps/docs/i18n/locales/vi.json                |  22 --
 apps/docs/modules/optimizeDeps.ts             |  21 --
 apps/docs/modules/useDocusI18nOverride.ts     |  28 --
 apps/docs/nuxt.config.ts                      |   3 -
 apps/docs/nuxt.schema.ts                      | 243 ------------------
 apps/docs/package.json                        |   3 +-
 apps/docs/server/plugins/llms-redirect.ts     |  60 -----
 .../server/routes/raw/[...slug].md.get.ts     |  77 ------
 apps/docs/utils/prerender.ts                  |  11 -
 61 files changed, 75 insertions(+), 2150 deletions(-)
 delete mode 100644 apps/docs/app/app.vue
 delete mode 100644 apps/docs/app/components/LanguageSelect.vue
 delete mode 100644 apps/docs/app/components/app/AppHeader.vue
 delete mode 100644 apps/docs/app/components/content/BrowserFrame.vue
 delete mode 100644 apps/docs/app/components/content/FrameworkSwitcher.vue
 delete mode 100644 apps/docs/app/components/content/GradientPageHero.vue
 delete mode 100644 apps/docs/app/components/content/Video.vue
 delete mode 100644 apps/docs/app/components/docs/DocsAsideLeftTop.vue
 delete mode 100644 apps/docs/app/components/docs/DocsFrameworkSelect.vue
 delete mode 100644 apps/docs/app/composables/useDocusI18n.ts
 delete mode 100644 apps/docs/app/composables/useFramework.ts
 delete mode 100644 apps/docs/app/error.vue
 delete mode 100644 apps/docs/app/layouts/default.vue
 delete mode 100644 apps/docs/app/utils/flattenNavigation.ts
 delete mode 100644 apps/docs/app/utils/foldNonRouteCategories.ts
 delete mode 100644 apps/docs/i18n/locales/ar.json
 delete mode 100644 apps/docs/i18n/locales/be.json
 delete mode 100644 apps/docs/i18n/locales/bn.json
 delete mode 100644 apps/docs/i18n/locales/ca.json
 delete mode 100644 apps/docs/i18n/locales/ckb.json
 delete mode 100644 apps/docs/i18n/locales/cs.json
 delete mode 100644 apps/docs/i18n/locales/da.json
 delete mode 100644 apps/docs/i18n/locales/de.json
 delete mode 100644 apps/docs/i18n/locales/el.json
 delete mode 100644 apps/docs/i18n/locales/en.json
 delete mode 100644 apps/docs/i18n/locales/et.json
 delete mode 100644 apps/docs/i18n/locales/fr.json
 delete mode 100644 apps/docs/i18n/locales/he.json
 delete mode 100644 apps/docs/i18n/locales/hi.json
 delete mode 100644 apps/docs/i18n/locales/hy.json
 delete mode 100644 apps/docs/i18n/locales/it.json
 delete mode 100644 apps/docs/i18n/locales/ja.json
 delete mode 100644 apps/docs/i18n/locales/kk.json
 delete mode 100644 apps/docs/i18n/locales/km.json
 delete mode 100644 apps/docs/i18n/locales/ko.json
 delete mode 100644 apps/docs/i18n/locales/ky.json
 delete mode 100644 apps/docs/i18n/locales/lb.json
 delete mode 100644 apps/docs/i18n/locales/ms.json
 delete mode 100644 apps/docs/i18n/locales/nb.json
 delete mode 100644 apps/docs/i18n/locales/pl.json
 delete mode 100644 apps/docs/i18n/locales/ru.json
 delete mode 100644 apps/docs/i18n/locales/sl.json
 delete mode 100644 apps/docs/i18n/locales/sv.json
 delete mode 100644 apps/docs/i18n/locales/uk.json
 delete mode 100644 apps/docs/i18n/locales/ur.json
 delete mode 100644 apps/docs/i18n/locales/vi.json
 delete mode 100644 apps/docs/modules/optimizeDeps.ts
 delete mode 100644 apps/docs/modules/useDocusI18nOverride.ts
 delete mode 100644 apps/docs/nuxt.schema.ts
 delete mode 100644 apps/docs/server/plugins/llms-redirect.ts
 delete mode 100644 apps/docs/server/routes/raw/[...slug].md.get.ts
 delete mode 100644 apps/docs/utils/prerender.ts

diff --git a/apps/docs/app/app.config.ts b/apps/docs/app/app.config.ts
index 84267127..a5b60215 100644
--- a/apps/docs/app/app.config.ts
+++ b/apps/docs/app/app.config.ts
@@ -40,6 +40,20 @@ export default defineAppConfig({
 			},
 		],
 	},
+	/**
+	 * Frameworks offered by the sidebar select and the in-content
+	 * `FrameworkSwitcher`, in display order. `value` is the MDC slot name used
+	 * in content (`#react`, `#other`, `#vue`) and the persisted preference
+	 * token. The layer ships no default list — which frameworks styleframe
+	 * documents is a styleframe fact — so this array is the only source.
+	 */
+	docsTheme: {
+		frameworks: [
+			{ value: "react", label: "React", icon: "i-mdi-react" },
+			{ value: "other", label: "Vanilla", icon: "i-mdi-language-typescript" },
+			{ value: "vue", label: "Vue", icon: "i-mdi-vuejs" },
+		],
+	},
 	/**
 	 * @docs https://www.docus.dev/concepts/configuration#socials-links
 	 */
diff --git a/apps/docs/app/app.vue b/apps/docs/app/app.vue
deleted file mode 100644
index 0fe0a1cb..00000000
--- a/apps/docs/app/app.vue
+++ /dev/null
@@ -1,164 +0,0 @@
-<script setup lang="ts">
-import type { ContentNavigationItem, PageCollections } from "@nuxt/content";
-import * as nuxtUiLocales from "@nuxt/ui/locale";
-import { flattenNavigation } from "~/utils/flattenNavigation";
-import { foldNonRouteCategories } from "~/utils/foldNonRouteCategories";
-
-const appConfig = useAppConfig();
-const { seo } = appConfig;
-const site = useSiteConfig();
-const { locale, locales, isEnabled, switchLocalePath } = useDocusI18n();
-
-const lang = computed(
-	() => nuxtUiLocales[locale.value as keyof typeof nuxtUiLocales]?.code || "en",
-);
-const dir = computed(
-	() => nuxtUiLocales[locale.value as keyof typeof nuxtUiLocales]?.dir || "ltr",
-);
-
-const getCollectionName = (key: string) =>
-	(isEnabled.value
-		? `docs_${key}_${locale.value}`
-		: `docs_${key}`) as keyof PageCollections;
-
-useHead({
-	meta: [{ name: "viewport", content: "width=device-width, initial-scale=1" }],
-	link: [{ rel: "icon", href: "/favicon.ico" }],
-	htmlAttrs: {
-		lang,
-		dir,
-	},
-});
-
-useSeoMeta({
-	titleTemplate: seo.titleTemplate,
-	title: seo.title,
-	description: seo.description,
-	ogSiteName: site.name,
-	twitterCard: "summary_large_image",
-});
-
-if (isEnabled.value) {
-	const route = useRoute();
-	const defaultLocale = (
-		useRuntimeConfig().public.i18n as { defaultLocale: string }
-	).defaultLocale;
-	onMounted(() => {
-		const currentLocale = route.path.split("/")[1];
-		if (!locales.some((locale) => locale.code === currentLocale)) {
-			return navigateTo(switchLocalePath(defaultLocale) as string);
-		}
-	});
-}
-
-const { data: navigation } = await useAsyncData(
-	() => `navigation_${locale.value}`,
-	async () => {
-		const results = await Promise.all(
-			DOCS_SECTIONS.map(async (section) => {
-				const collectionName = getCollectionName(section.key);
-				const data = await queryCollectionNavigation(collectionName);
-				const rootResult =
-					data.find((item) => item.path === `/docs/${section.slug}`)
-						?.children ||
-					data.find((item) => item.path === "/docs")?.children ||
-					data ||
-					[];
-				const localeResult =
-					rootResult.find((item) => item.path === `/${locale.value}`)
-						?.children || rootResult;
-				const sectionPath = `/docs/${section.slug}`;
-				let result: ContentNavigationItem[];
-				if (Array.isArray(section.folder)) {
-					const rootIdx =
-						"rootFolder" in section ? (section.rootFolder as number) : -1;
-					const rootWrapper =
-						localeResult.length === 1 && localeResult[0]?.path === sectionPath
-							? localeResult[0]
-							: null;
-					const allItems = rootWrapper
-						? (rootWrapper.children ?? [])
-						: localeResult;
-
-					if (rootIdx >= 0) {
-						const nonRootPaths = new Set(
-							section.folder
-								.filter((_, i) => i !== rootIdx)
-								.map((f) => `${sectionPath}/${f.replace(/^\d+\./, "")}`),
-						);
-						const items: ContentNavigationItem[] = [];
-						for (let i = 0; i < section.folder.length; i++) {
-							if (i === rootIdx) {
-								items.push({
-									...(rootWrapper ?? {}),
-									title: rootWrapper?.title ?? section.label,
-									path: sectionPath,
-									children: allItems.filter(
-										(item) => !nonRootPaths.has(item.path),
-									),
-								} as ContentNavigationItem);
-							} else {
-								const found = allItems.find(
-									(item) =>
-										item.path ===
-										`${sectionPath}/${section.folder[i]?.replace(/^\d+\./, "")}`,
-								);
-								if (found) items.push(found);
-							}
-						}
-						result = items;
-					} else {
-						result = section.folder
-							.map((folder) =>
-								allItems.find(
-									(item) =>
-										item.path ===
-										`${sectionPath}/${folder.replace(/^\d+\./, "")}`,
-								),
-							)
-							.filter(
-								(item): item is ContentNavigationItem => item !== undefined,
-							);
-					}
-				} else {
-					result = localeResult;
-				}
-				return [
-					section.key,
-					foldNonRouteCategories(
-						flattenNavigation(result),
-						appConfig.nonRouteCategories ?? {},
-					),
-				] as const;
-			}),
-		);
-		return Object.fromEntries(results) as Record<
-			string,
-			ContentNavigationItem[]
-		>;
-	},
-	{
-		watch: [locale],
-	},
-);
-
-const flatNavigation = computed(() =>
-	navigation.value ? Object.values(navigation.value).flat() : [],
-);
-
-provide("navigation", navigation);
-</script>
-
-<template>
-	<UApp :locale="nuxtUiLocales[locale as keyof typeof nuxtUiLocales]">
-		<NuxtLoadingIndicator color="var(--ui-primary)" />
-
-		<NuxtLayout>
-			<NuxtPage />
-		</NuxtLayout>
-
-		<ClientOnly>
-			<AppSearch :navigation="flatNavigation" />
-		</ClientOnly>
-	</UApp>
-</template>
diff --git a/apps/docs/app/components/LanguageSelect.vue b/apps/docs/app/components/LanguageSelect.vue
deleted file mode 100644
index 015dc133..00000000
--- a/apps/docs/app/components/LanguageSelect.vue
+++ /dev/null
@@ -1,74 +0,0 @@
-<script setup lang="ts">
-const { locale, locales, switchLocalePath } = useDocusI18n();
-
-function getEmojiFlag(locale: string): string {
-	const languageToCountry: Record<string, string> = {
-		ar: "sa", // Arabic -> Saudi Arabia
-		bn: "bd", // Bengali -> Bangladesh
-		ca: "es", // Catalan -> Spain
-		ckb: "iq", // Central Kurdish -> Iraq
-		cs: "cz", // Czech -> Czech Republic (note: modern country code is actually 'cz')
-		da: "dk", // Danish -> Denmark
-		el: "gr", // Greek -> Greece
-		en: "gb", // English -> Great Britain
-		et: "ee", // Estonian -> Estonia
-		he: "il", // Hebrew -> Israel
-		hi: "in", // Hindi -> India
-		hy: "am", // Armenian -> Armenia
-		ja: "jp", // Japanese -> Japan
-		kk: "kz", // Kazakh -> Kazakhstan
-		km: "kh", // Khmer -> Cambodia
-		ko: "kr", // Korean -> South Korea
-		ky: "kg", // Kyrgyz -> Kyrgyzstan
-		lb: "lu", // Luxembourgish -> Luxembourg
-		ms: "my", // Malay -> Malaysia
-		nb: "no", // Norwegian Bokmål -> Norway
-		sl: "si", // Slovenian -> Slovenia
-		sv: "se", // Swedish -> Sweden
-		uk: "ua", // Ukrainian -> Ukraine
-		ur: "pk", // Urdu -> Pakistan
-		vi: "vn", // Vietnamese -> Vietnam
-	};
-
-	const baseLanguage = locale.split("-")[0]?.toLowerCase() || locale;
-	const countryCode =
-		languageToCountry[baseLanguage] || locale.replace(/^.*-/, "").slice(0, 2);
-
-	return countryCode
-		.toUpperCase()
-		.split("")
-		.map((char) => String.fromCodePoint(0x1f1a5 + char.charCodeAt(0)))
-		.join("");
-}
-</script>
-
-<template>
-	<UPopover mode="hover" :content="{ align: 'end' }">
-		<UButton color="neutral" variant="ghost" class="size-8">
-			<template #trailing>
-				<span class="text-lg">
-					{{ getEmojiFlag(locale) }}
-				</span>
-			</template>
-		</UButton>
-
-		<template #content>
-			<ul class="flex flex-col">
-				<li v-for="localeItem in locales" :key="localeItem.code">
-					<NuxtLink
-						class="flex justify-between py-1.5 px-2 gap-1 hover:bg-muted"
-						:to="switchLocalePath(localeItem.code) as string"
-						:aria-label="localeItem.name"
-					>
-						<span class="text-sm">
-							{{ localeItem.name }}
-						</span>
-						<span class="size-5 text-center">
-							{{ getEmojiFlag(localeItem.code) }}
-						</span>
-					</NuxtLink>
-				</li>
-			</ul>
-		</template>
-	</UPopover>
-</template>
diff --git a/apps/docs/app/components/app/AppHeader.vue b/apps/docs/app/components/app/AppHeader.vue
deleted file mode 100644
index e2d8d64a..00000000
--- a/apps/docs/app/components/app/AppHeader.vue
+++ /dev/null
@@ -1,112 +0,0 @@
-<script setup lang="ts">
-import { useResizeObserver } from "@vueuse/core";
-import { useDocusI18n } from "../../composables/useDocusI18n";
-
-const appConfig = useAppConfig();
-const site = useSiteConfig();
-
-const { localePath, isEnabled, locales } = useDocusI18n();
-
-const route = useRoute();
-const isDocs = computed(() => route.path.startsWith("/docs"));
-
-const headerEl = ref<HTMLElement | null>(null);
-
-onMounted(() => {
-	headerEl.value = document.querySelector<HTMLElement>("header");
-});
-
-useResizeObserver(headerEl, ([entry]) => {
-	if (!isDocs.value || !entry) return;
-	const height = entry.contentRect.height;
-	if (height > 0) {
-		document.documentElement.style.setProperty(
-			"--ui-header-height",
-			`${height}px`,
-		);
-	}
-});
-
-watch(isDocs, (docs) => {
-	if (!docs) {
-		document.documentElement.style.removeProperty("--ui-header-height");
-	}
-});
-
-const links = computed(() =>
-	appConfig.github && appConfig.github.url
-		? [
-				{
-					icon: "i-simple-icons-github",
-					to: appConfig.github.url,
-					target: "_blank",
-					"aria-label": "GitHub",
-				},
-			]
-		: [],
-);
-</script>
-
-<template>
-	<UHeader
-		:ui="{ center: 'flex-1', root: isDocs ? 'h-auto' : '', container: 'h-16' }"
-		:to="localePath('/')"
-		:title="appConfig.header?.title || site.name"
-	>
-		<AppHeaderCenter />
-
-		<template #title>
-			<AppHeaderLogo class="h-6 w-auto shrink-0" />
-		</template>
-
-		<template #right>
-			<AppHeaderCTA class="max-sm:hidden" />
-
-			<template v-if="isEnabled && locales.length > 1">
-				<ClientOnly>
-					<LanguageSelect />
-
-					<template #fallback>
-						<div
-							class="h-8 w-8 animate-pulse bg-neutral-200 dark:bg-neutral-800 rounded-md"
-						/>
-					</template>
-				</ClientOnly>
-
-				<USeparator orientation="vertical" class="h-8" />
-			</template>
-
-			<UContentSearchButton class="lg:hidden" />
-
-			<ClientOnly>
-				<UColorModeButton />
-
-				<template #fallback>
-					<div
-						class="h-8 w-8 animate-pulse bg-neutral-200 dark:bg-neutral-800 rounded-md"
-					/>
-				</template>
-			</ClientOnly>
-
-			<template v-if="links?.length">
-				<UButton
-					v-for="(link, index) of links"
-					:key="index"
-					v-bind="{ color: 'neutral', variant: 'ghost', ...link }"
-				/>
-			</template>
-		</template>
-
-		<template #toggle="{ open, toggle }">
-			<IconMenuToggle :open="open" class="lg:hidden" @click="toggle" />
-		</template>
-
-		<template #body>
-			<AppHeaderBody />
-		</template>
-
-		<template v-if="isDocs" #bottom>
-			<AppSubHeader />
-		</template>
-	</UHeader>
-</template>
diff --git a/apps/docs/app/components/content/BrowserFrame.vue b/apps/docs/app/components/content/BrowserFrame.vue
deleted file mode 100644
index 565357a9..00000000
--- a/apps/docs/app/components/content/BrowserFrame.vue
+++ /dev/null
@@ -1,28 +0,0 @@
-<script setup lang="ts">
-interface Props {
-	title?: string;
-}
-
-defineProps<Props>();
-</script>
-
-<template>
-	<div class="p-1 border border-default rounded text-sm bg-default/70">
-		<div
-			v-if="title"
-			class="flex items-center bg-slate-100 dark:bg-slate-800 p-2 rounded font-bold"
-		>
-			<span class="flex gap-1 absolute">
-				<span class="rounded-full bg-error inline-flex w-3 h-3" />
-				<span class="rounded-full bg-warning inline-flex w-3 h-3" />
-				<span class="rounded-full bg-success inline-flex w-3 h-3" />
-			</span>
-			<span class="flex w-full align-center justify-center">
-				{{ title }}
-			</span>
-		</div>
-		<div class="px-3 overflow-auto">
-			<slot mdc-unwrap="p" />
-		</div>
-	</div>
-</template>
diff --git a/apps/docs/app/components/content/FrameworkSwitcher.vue b/apps/docs/app/components/content/FrameworkSwitcher.vue
deleted file mode 100644
index 6951ea68..00000000
--- a/apps/docs/app/components/content/FrameworkSwitcher.vue
+++ /dev/null
@@ -1,23 +0,0 @@
-<script setup lang="ts">
-const { framework, frameworks } = useFramework();
-const slots = useSlots();
-
-const current = computed(
-	() => frameworks.find((f) => f.value === framework.value) ?? frameworks[0],
-);
-
-const fallback = computed(() => {
-	if (slots[framework.value]) return null;
-	return frameworks.find((f) => slots[f.value]) ?? null;
-});
-</script>
-
-<template>
-	<div class="framework-switcher">
-		<p v-if="fallback" class="text-sm text-muted mb-2">
-			Not available for {{ current?.label }} — showing {{ fallback.label }}.
-		</p>
-		<slot v-if="!fallback" :name="framework" />
-		<slot v-else :name="fallback.value" />
-	</div>
-</template>
diff --git a/apps/docs/app/components/content/GradientPageHero.vue b/apps/docs/app/components/content/GradientPageHero.vue
deleted file mode 100644
index 1d63a0e0..00000000
--- a/apps/docs/app/components/content/GradientPageHero.vue
+++ /dev/null
@@ -1,17 +0,0 @@
-<script setup lang="ts">
-defineOptions({
-	inheritAttrs: false,
-});
-</script>
-
-<template>
-	<MorphingGradientBackground v-slot="{ onMousemove }">
-		<UPageHero v-bind="$attrs" @mousemove="onMousemove">
-			<slot />
-			<template #title><slot name="title" /></template>
-			<template #description><slot name="description" /></template>
-			<template #headline><slot name="headline" /></template>
-			<template #links><slot name="links" /></template>
-		</UPageHero>
-	</MorphingGradientBackground>
-</template>
diff --git a/apps/docs/app/components/content/Video.vue b/apps/docs/app/components/content/Video.vue
deleted file mode 100644
index 15f9230d..00000000
--- a/apps/docs/app/components/content/Video.vue
+++ /dev/null
@@ -1,106 +0,0 @@
-<script setup lang="ts">
-import { useIntersectionObserver } from "@vueuse/core";
-
-interface Props {
-	poster?: string;
-	src?: string;
-	sources?: string[];
-	controls?: boolean;
-	autoplay?: boolean;
-	loop?: boolean;
-	muted?: boolean;
-	playsinline?: boolean;
-	pauseOnExit?: boolean;
-}
-
-const props = withDefaults(defineProps<Props>(), {
-	poster: "",
-	src: "",
-	sources: undefined,
-	controls: false,
-	autoplay: false,
-	loop: false,
-	muted: true,
-	playsinline: true,
-	pauseOnExit: true,
-});
-
-const playing = ref(false);
-const loaded = ref(false);
-const isIntersecting = ref(false);
-const posterLoaded = ref(false);
-
-const videoRef = useTemplateRef<HTMLVideoElement | null>("video");
-
-const { stop } = useIntersectionObserver(
-	videoRef,
-	([entry], observerElement) => {
-		isIntersecting.value = entry?.isIntersecting || false;
-	},
-);
-
-const allSources = computed(() => props.sources ?? [props.src]);
-
-const lazyPoster = computed(() => {
-	if (isIntersecting.value && !posterLoaded.value) {
-		posterLoaded.value = true;
-		return props.poster;
-	} else if (posterLoaded.value) {
-		return props.poster;
-	} else {
-		return "";
-	}
-});
-
-onUnmounted(() => {
-	stop();
-});
-
-watch(isIntersecting, (currentValue, previousValue) => {
-	// Pause video if it was playing and is no longer intersecting
-	if (props.pauseOnExit) {
-		if (previousValue && playing.value) {
-			videoRef.value?.pause();
-		} else if (currentValue && !playing.value) {
-			videoRef.value?.play();
-		}
-	}
-
-	// Load if video is intersecting
-	if (currentValue && !loaded.value) {
-		videoRef.value?.load();
-	}
-});
-
-const onPlay = () => {
-	playing.value = true;
-};
-
-const onPause = () => {
-	playing.value = false;
-};
-
-const onLoaded = () => {
-	loaded.value = true;
-};
-</script>
-
-<template>
-	<video
-		ref="video"
-		class="w-full h-full object-cover"
-		preload="none"
-		:poster="lazyPoster"
-		:src="allSources[0]"
-		:controls="controls"
-		:autoplay="autoplay"
-		:loop="loop"
-		:muted="muted"
-		playsinline
-		@play="onPlay"
-		@pause="onPause"
-		@loadeddata="onLoaded"
-	>
-		<source v-for="source in allSources" :src="source" :key="source" />
-	</video>
-</template>
diff --git a/apps/docs/app/components/docs/DocsAsideLeftBody.vue b/apps/docs/app/components/docs/DocsAsideLeftBody.vue
index 8977985c..54970172 100644
--- a/apps/docs/app/components/docs/DocsAsideLeftBody.vue
+++ b/apps/docs/app/components/docs/DocsAsideLeftBody.vue
@@ -1,4 +1,11 @@
 <script setup lang="ts">
+/**
+ * Local override of the layer's sidebar navigation body.
+ *
+ * Two styleframe-only deltas, both content facts rather than theme features:
+ * the `theme` section's tree is sliced per `THEME_SUBSECTIONS` tab, and Pro-only
+ * pages get a `<ProIcon>` badge. Everything else tracks the layer copy.
+ */
 import type { ContentNavigationItem } from "@nuxt/content";
 
 const route = useRoute();
diff --git a/apps/docs/app/components/docs/DocsAsideLeftTop.vue b/apps/docs/app/components/docs/DocsAsideLeftTop.vue
deleted file mode 100644
index 06d4bf58..00000000
--- a/apps/docs/app/components/docs/DocsAsideLeftTop.vue
+++ /dev/null
@@ -1,16 +0,0 @@
-<template>
-	<div>
-		<span
-			class="group relative w-full pr-2.5 py-1.5 flex items-center gap-1.5 text-sm text-muted cursor-default hover:text-highlighted transition-colors font-normal"
-		>
-			<span class="truncate"> Framework </span>
-		</span>
-
-		<DocsFrameworkSelect class="mb-2" />
-
-		<!-- <USeparator
-			type="dashed"
-			class="my-6"
-		/> -->
-	</div>
-</template>
diff --git a/apps/docs/app/components/docs/DocsFrameworkSelect.vue b/apps/docs/app/components/docs/DocsFrameworkSelect.vue
deleted file mode 100644
index bd39b505..00000000
--- a/apps/docs/app/components/docs/DocsFrameworkSelect.vue
+++ /dev/null
@@ -1,20 +0,0 @@
-<script setup lang="ts">
-const { framework, frameworks } = useFramework();
-
-const current = computed(
-	() =>
-		frameworks.find((option) => option.value === framework.value) ??
-		frameworks[0],
-);
-</script>
-
-<template>
-	<USelect
-		v-model="framework"
-		:items="[...frameworks]"
-		variant="ghost"
-		color="neutral"
-		:icon="current?.icon"
-		class="w-full"
-	/>
-</template>
diff --git a/apps/docs/app/composables/useDocsSections.ts b/apps/docs/app/composables/useDocsSections.ts
index 5f5fa88f..a1312b10 100644
--- a/apps/docs/app/composables/useDocsSections.ts
+++ b/apps/docs/app/composables/useDocsSections.ts
@@ -22,6 +22,15 @@ function findFirstLeafPath(
 	return items[0]?.path;
 }
 
+/**
+ * Local override of the layer's `useDocsSections`.
+ *
+ * The delta is the `theme` branch: styleframe splits one content collection into
+ * four sub-header tabs via `THEME_SUBSECTIONS`, which is a styleframe content
+ * shape, not a theme feature. The rest of the shape — including
+ * `hasSectionSwitcher` — must stay identical to the layer copy, since the
+ * layer's `AppSubHeader` consumes it.
+ */
 export function useDocsSections() {
 	const route = useRoute();
 	const navigation =
@@ -67,5 +76,12 @@ export function useDocsSections() {
 		sections.value.find((section) => section.active),
 	);
 
-	return { sections, activeSection };
+	/**
+	 * Whether the section switcher is worth rendering. A single section (or none)
+	 * gives the reader nothing to switch between, so the sub-header is suppressed
+	 * entirely rather than rendering an empty bar.
+	 */
+	const hasSectionSwitcher = computed(() => sections.value.length > 1);
+
+	return { sections, activeSection, hasSectionSwitcher };
 }
diff --git a/apps/docs/app/composables/useDocusI18n.ts b/apps/docs/app/composables/useDocusI18n.ts
deleted file mode 100644
index 242f498a..00000000
--- a/apps/docs/app/composables/useDocusI18n.ts
+++ /dev/null
@@ -1,49 +0,0 @@
-import type { LocaleObject } from "@nuxtjs/i18n";
-import type { Ref } from "vue";
-import en from "../../i18n/locales/en.json";
-
-/**
- * `@nuxtjs/i18n` auto-imports. This app ships with i18n disabled — the module is
- * not registered (see apps/shared/modules/config.ts) — so the enabled branch
- * below is inert. These declarations let the file typecheck without the module
- * generating the globals; when i18n is enabled the real composables are used.
- */
-declare function useI18n(): { locale: Ref<string>; t: (key: string) => string };
-declare function useLocalePath(): (route: string, locale?: string) => string;
-declare function useSwitchLocalePath(): (locale: string) => string;
-
-export const useDocusI18n = () => {
-	const config = useRuntimeConfig().public;
-	const isEnabled = ref(!!config.i18n);
-
-	if (!isEnabled.value) {
-		return {
-			isEnabled,
-			locale: ref("en"),
-			locales: [],
-			localePath: (path: string) => path,
-			switchLocalePath: (_locale?: string): string => "",
-			t: (key: string): string => {
-				const path = key.split(".");
-				return path.reduce(
-					(acc: unknown, curr) => (acc as Record<string, unknown>)?.[curr],
-					en,
-				) as string;
-			},
-		};
-	}
-
-	const { locale, t } = useI18n();
-	const filteredLocales =
-		(config.docus as { filteredLocales: LocaleObject<string>[] })
-			?.filteredLocales || [];
-
-	return {
-		isEnabled,
-		locale,
-		locales: filteredLocales,
-		t,
-		localePath: useLocalePath(),
-		switchLocalePath: useSwitchLocalePath(),
-	};
-};
diff --git a/apps/docs/app/composables/useFramework.ts b/apps/docs/app/composables/useFramework.ts
deleted file mode 100644
index e43c1c9d..00000000
--- a/apps/docs/app/composables/useFramework.ts
+++ /dev/null
@@ -1,32 +0,0 @@
-import { useLocalStorage } from "@vueuse/core";
-
-export type Framework = "vue" | "react" | "other";
-
-export interface FrameworkOption {
-	value: Framework;
-	label: string;
-	icon: string;
-}
-
-export const FRAMEWORKS: readonly FrameworkOption[] = [
-	{ value: "react", label: "React", icon: "i-mdi-react" },
-	{
-		value: "other",
-		label: "Vanilla",
-		icon: "i-mdi-language-typescript",
-	},
-	{ value: "vue", label: "Vue", icon: "i-mdi-vuejs" },
-] as const;
-
-const STORAGE_KEY = "styleframe-docs:framework";
-
-export const useFramework = () => {
-	const framework = useLocalStorage<Framework>(STORAGE_KEY, "react", {
-		initOnMounted: true,
-	});
-
-	return {
-		framework,
-		frameworks: FRAMEWORKS,
-	};
-};
diff --git a/apps/docs/app/error.vue b/apps/docs/app/error.vue
deleted file mode 100644
index bec74e08..00000000
--- a/apps/docs/app/error.vue
+++ /dev/null
@@ -1,166 +0,0 @@
-<script setup lang="ts">
-import type { NuxtError } from "#app";
-import type { ContentNavigationItem, PageCollections } from "@nuxt/content";
-import * as nuxtUiLocales from "@nuxt/ui/locale";
-import { flattenNavigation } from "~/utils/flattenNavigation";
-import { foldNonRouteCategories } from "~/utils/foldNonRouteCategories";
-
-const props = defineProps<{
-	error: NuxtError;
-}>();
-
-const { locale, locales, isEnabled, t, switchLocalePath } = useDocusI18n();
-const appConfig = useAppConfig();
-
-const lang = computed(
-	() => nuxtUiLocales[locale.value as keyof typeof nuxtUiLocales]?.code || "en",
-);
-const dir = computed(
-	() => nuxtUiLocales[locale.value as keyof typeof nuxtUiLocales]?.dir || "ltr",
-);
-useHead({
-	htmlAttrs: {
-		lang,
-		dir,
-	},
-});
-
-const localizedError = computed(() => {
-	return {
-		...props.error,
-		statusMessage: t("common.error.title"),
-	};
-});
-
-useSeoMeta({
-	title: () => t("common.error.title"),
-	description: () => t("common.error.description"),
-});
-
-if (isEnabled.value) {
-	const route = useRoute();
-	const defaultLocale = (
-		useRuntimeConfig().public.i18n as { defaultLocale: string }
-	).defaultLocale;
-	onMounted(() => {
-		const currentLocale = route.path.split("/")[1];
-		if (!locales.some((locale) => locale.code === currentLocale)) {
-			return navigateTo(switchLocalePath(defaultLocale) as string);
-		}
-	});
-}
-
-const getCollectionName = (key: string) =>
-	(isEnabled.value
-		? `docs_${key}_${locale.value}`
-		: `docs_${key}`) as keyof PageCollections;
-
-const { data: navigation } = await useAsyncData(
-	() => `navigation_${locale.value}`,
-	async () => {
-		const results = await Promise.all(
-			DOCS_SECTIONS.map(async (section) => {
-				const collectionName = getCollectionName(section.key);
-				const data = await queryCollectionNavigation(collectionName);
-				const rootResult =
-					data.find((item) => item.path === `/docs/${section.slug}`)
-						?.children ||
-					data.find((item) => item.path === "/docs")?.children ||
-					data ||
-					[];
-				const localeResult =
-					rootResult.find((item) => item.path === `/${locale.value}`)
-						?.children || rootResult;
-				const sectionPath = `/docs/${section.slug}`;
-				let result: ContentNavigationItem[];
-				if (Array.isArray(section.folder)) {
-					const rootIdx =
-						"rootFolder" in section ? (section.rootFolder as number) : -1;
-					const rootWrapper =
-						localeResult.length === 1 && localeResult[0]?.path === sectionPath
-							? localeResult[0]
-							: null;
-					const allItems = rootWrapper
-						? (rootWrapper.children ?? [])
-						: localeResult;
-
-					if (rootIdx >= 0) {
-						const nonRootPaths = new Set(
-							section.folder
-								.filter((_, i) => i !== rootIdx)
-								.map((f) => `${sectionPath}/${f.replace(/^\d+\./, "")}`),
-						);
-						const items: ContentNavigationItem[] = [];
-						for (let i = 0; i < section.folder.length; i++) {
-							if (i === rootIdx) {
-								items.push({
-									...(rootWrapper ?? {}),
-									title: rootWrapper?.title ?? section.label,
-									path: sectionPath,
-									children: allItems.filter(
-										(item) => !nonRootPaths.has(item.path),
-									),
-								} as ContentNavigationItem);
-							} else {
-								const found = allItems.find(
-									(item) =>
-										item.path ===
-										`${sectionPath}/${section.folder[i]?.replace(/^\d+\./, "")}`,
-								);
-								if (found) items.push(found);
-							}
-						}
-						result = items;
-					} else {
-						result = section.folder
-							.map((folder) =>
-								allItems.find(
-									(item) =>
-										item.path ===
-										`${sectionPath}/${folder.replace(/^\d+\./, "")}`,
-								),
-							)
-							.filter(
-								(item): item is ContentNavigationItem => item !== undefined,
-							);
-					}
-				} else {
-					result = localeResult;
-				}
-				return [
-					section.key,
-					foldNonRouteCategories(
-						flattenNavigation(result),
-						appConfig.nonRouteCategories ?? {},
-					),
-				] as const;
-			}),
-		);
-		return Object.fromEntries(results) as Record<
-			string,
-			ContentNavigationItem[]
-		>;
-	},
-	{ watch: [locale] },
-);
-
-const flatNavigation = computed(() =>
-	navigation.value ? Object.values(navigation.value).flat() : [],
-);
-
-provide("navigation", navigation);
-</script>
-
-<template>
-	<UApp>
-		<AppHeader />
-
-		<UError :error="localizedError" />
-
-		<AppFooter />
-
-		<ClientOnly>
-			<AppSearch :navigation="flatNavigation" />
-		</ClientOnly>
-	</UApp>
-</template>
diff --git a/apps/docs/app/layouts/default.vue b/apps/docs/app/layouts/default.vue
deleted file mode 100644
index 7e000d1c..00000000
--- a/apps/docs/app/layouts/default.vue
+++ /dev/null
@@ -1,25 +0,0 @@
-<script setup lang="ts">
-const route = useRoute();
-const isDocs = computed(() => route.path.startsWith("/docs"));
-</script>
-
-<template>
-	<AppHeader />
-	<UMain>
-		<slot v-if="!isDocs" />
-		<UContainer v-else>
-			<UPage>
-				<template #left>
-					<UPageAside>
-						<DocsAsideLeftTop />
-
-						<DocsAsideLeftBody />
-					</UPageAside>
-				</template>
-
-				<slot />
-			</UPage>
-		</UContainer>
-	</UMain>
-	<AppFooter />
-</template>
diff --git a/apps/docs/app/pages/[[lang]]/[...slug].vue b/apps/docs/app/pages/[[lang]]/[...slug].vue
index d882756f..e83a5600 100644
--- a/apps/docs/app/pages/[[lang]]/[...slug].vue
+++ b/apps/docs/app/pages/[[lang]]/[...slug].vue
@@ -1,4 +1,12 @@
 <script setup lang="ts">
+/**
+ * Local override of the `@uxfront/layer-docs` landing page.
+ *
+ * The ONLY delta against the layer copy is the `defineOgImage` fallback below:
+ * `nuxt-og-image` and the `DocsSatori` template are registered by this app, not
+ * by the theme package. Everything else is the layer's file verbatim — keep it
+ * that way, and delete this override once OG image support lands in the layer.
+ */
 import type { Collections } from "@nuxt/content";
 import { kebabCase } from "scule";
 
diff --git a/apps/docs/app/pages/[[lang]]/docs/[section]/[...slug].vue b/apps/docs/app/pages/[[lang]]/docs/[section]/[...slug].vue
index 09e2ed5f..94500d39 100644
--- a/apps/docs/app/pages/[[lang]]/docs/[section]/[...slug].vue
+++ b/apps/docs/app/pages/[[lang]]/docs/[section]/[...slug].vue
@@ -1,4 +1,12 @@
 <script setup lang="ts">
+/**
+ * Local override of the `@uxfront/layer-docs` docs page.
+ *
+ * The ONLY delta against the layer copy is the `defineOgImage` call below:
+ * `nuxt-og-image` and the `DocsSatori` template are registered by this app, not
+ * by the theme package. Everything else is the layer's file verbatim — keep it
+ * that way, and delete this override once OG image support lands in the layer.
+ */
 import { kebabCase } from "scule";
 import type {
 	ContentNavigationItem,
@@ -16,7 +24,6 @@ type DocsPageItem = PageCollectionItemBase & {
 	seo?: { title?: string; description?: string };
 };
 import { findPageHeadline } from "@nuxt/content/utils";
-import { addPrerenderPath } from "../../../../../utils/prerender";
 
 definePageMeta({
 	layout: "default",
@@ -149,7 +156,10 @@ const editLink = computed(() => {
 		<UPageBody>
 			<ContentRenderer v-if="page" :value="page" />
 
-			<USeparator>
+			<!-- `decorative` drops the `separator` role: the rule is decoration around
+			     the edit/report actions, and a separator with focusable descendants is
+			     a `nested-interactive` violation. -->
+			<USeparator decorative>
 				<div v-if="github" class="flex items-center gap-2 text-sm text-muted">
 					<UButton
 						variant="link"
diff --git a/apps/docs/app/types/non-route-categories.ts b/apps/docs/app/types/non-route-categories.ts
index ab699da0..8be85acc 100644
--- a/apps/docs/app/types/non-route-categories.ts
+++ b/apps/docs/app/types/non-route-categories.ts
@@ -1,3 +1,9 @@
+/**
+ * Duplicate of the layer's `app/types/non-route-categories.ts`, kept only
+ * because `modules/nonRouteCategories.ts` imports it by relative path at build
+ * time and the layer publishes no subpath export for it. Deletes itself the day
+ * that module moves into `@uxfront/layer-docs`.
+ */
 export interface NonRouteCategoryMeta {
 	title: string;
 	icon?: string | false;
diff --git a/apps/docs/app/utils/flattenNavigation.ts b/apps/docs/app/utils/flattenNavigation.ts
deleted file mode 100644
index 335f9520..00000000
--- a/apps/docs/app/utils/flattenNavigation.ts
+++ /dev/null
@@ -1,24 +0,0 @@
-import type { ContentNavigationItem } from "@nuxt/content";
-
-/**
- * Flatten navigation items that are false-positive groups.
- * Nuxt Content's index detection regex matches filenames containing "index"
- * as a substring (e.g. "z-index"), incorrectly nesting them as groups.
- * This flattens groups with a single child sharing the same path.
- */
-export function flattenNavigation(
-	items: ContentNavigationItem[],
-): ContentNavigationItem[] {
-	return items.map((item) => {
-		if (item.children?.length === 1 && item.children[0]?.path === item.path) {
-			const { children: _, ...parent } = item;
-			return { ...parent, ...item.children[0], children: undefined };
-		}
-
-		if (item.children?.length) {
-			return { ...item, children: flattenNavigation(item.children) };
-		}
-
-		return item;
-	});
-}
diff --git a/apps/docs/app/utils/foldNonRouteCategories.ts b/apps/docs/app/utils/foldNonRouteCategories.ts
deleted file mode 100644
index 0005b3d5..00000000
--- a/apps/docs/app/utils/foldNonRouteCategories.ts
+++ /dev/null
@@ -1,55 +0,0 @@
-import type { ContentNavigationItem } from "@nuxt/content";
-import type { NonRouteCategoryMeta } from "~/types/non-route-categories";
-
-/**
- * Rebuilds the sidebar grouping for non-route categories.
- *
- * Pages under a `route: false` folder are flattened in the URL, so the native
- * navigation tree lists them as direct children with the category level gone.
- * This re-nests each such page under a synthetic group node (rendered as a
- * non-navigating accordion header), matching pages to categories by `stem`.
- */
-export function foldNonRouteCategories(
-	items: ContentNavigationItem[],
-	categories: Record<string, NonRouteCategoryMeta>,
-): ContentNavigationItem[] {
-	return items.map((node) => {
-		if (!node.children?.length) {
-			return node;
-		}
-		const passthrough: ContentNavigationItem[] = [];
-		const groups = new Map<
-			string,
-			{ meta: NonRouteCategoryMeta; children: ContentNavigationItem[] }
-		>();
-		for (const child of node.children) {
-			const dir = child.stem
-				? child.stem.split("/").slice(0, -1).join("/")
-				: "";
-			const meta = categories[dir];
-			if (meta && child.page !== false) {
-				const group = groups.get(dir) ?? { meta, children: [] };
-				group.children.push(child);
-				groups.set(dir, group);
-			} else {
-				passthrough.push(foldNonRouteCategories([child], categories)[0]!);
-			}
-		}
-		const groupNodes = [...groups.values()]
-			.sort(
-				(a, b) =>
-					a.meta.order - b.meta.order ||
-					a.meta.title.localeCompare(b.meta.title),
-			)
-			.map(({ meta, children }) => ({
-				title: meta.title,
-				...(meta.icon ? { icon: meta.icon } : {}),
-				...(meta.defaultOpen !== undefined
-					? { defaultOpen: meta.defaultOpen }
-					: {}),
-				page: false as const,
-				children,
-			})) as ContentNavigationItem[];
-		return { ...node, children: [...passthrough, ...groupNodes] };
-	});
-}
diff --git a/apps/docs/content.config.ts b/apps/docs/content.config.ts
index d5670cf2..53e1c587 100644
--- a/apps/docs/content.config.ts
+++ b/apps/docs/content.config.ts
@@ -1,118 +1,11 @@
-import type { DefinedCollection } from "@nuxt/content";
-import { defineContentConfig, defineCollection, z } from "@nuxt/content";
-import { defineSitemapSchema } from "@nuxtjs/sitemap/content";
-import { useNuxt } from "@nuxt/kit";
-import { DOCS_SECTIONS, type DocsSection } from "./app/constants/sections";
-
-const { options } = useNuxt();
-const locales = options.i18n?.locales;
-
-const createDocsSchema = () =>
-	z.object({
-		links: z
-			.array(
-				z.object({
-					label: z.string(),
-					icon: z.string(),
-					to: z.string(),
-					target: z.string().optional(),
-				}),
-			)
-			.optional(),
-	});
-
-const buildDocsSource = (
-	section: DocsSection,
-	pathPrefix = "",
-	urlPrefix = "",
-) => {
-	const folders = Array.isArray(section.folder)
-		? section.folder
-		: [section.folder];
-	const baseUrl = `${urlPrefix}/docs/${section.slug}`;
-
-	if (folders.length === 1) {
-		return {
-			include: `${pathPrefix}docs/${folders[0]}/**/*.{md,yml}`,
-			prefix: baseUrl,
-		};
-	}
-
-	const rootIndex =
-		"rootFolder" in section ? (section.rootFolder as number) : -1;
-
-	return folders.map((folder, index) => ({
-		include: `${pathPrefix}docs/${folder}/**/*.{md,yml}`,
-		prefix:
-			index === rootIndex
-				? baseUrl
-				: `${baseUrl}/${folder.replace(/^\d+\./, "")}`,
-	}));
-};
-
-let collections: Record<string, DefinedCollection>;
-
-if (locales && Array.isArray(locales)) {
-	collections = {};
-	for (const locale of locales) {
-		const code = typeof locale === "string" ? locale : locale.code;
-
-		collections[`landing_${code}`] = defineCollection({
-			type: "page",
-			source: [{ include: `${code}/*.md` }],
-			schema: z.object({
-				sitemap: defineSitemapSchema(),
-			}),
-		});
-
-		for (const section of DOCS_SECTIONS) {
-			collections[`docs_${section.key}_${code}`] = defineCollection({
-				type: "page",
-				source: buildDocsSource(section, `${code}/`, `/${code}`),
-				schema: createDocsSchema().extend({
-					sitemap: defineSitemapSchema(),
-				}),
-			});
-		}
-	}
-} else {
-	collections = {
-		landing: defineCollection({
-			type: "page",
-			source: [{ include: "*.md" }],
-			schema: z.object({
-				sitemap: defineSitemapSchema(),
-			}),
-		}),
-	};
-
-	for (const section of DOCS_SECTIONS) {
-		collections[`docs_${section.key}`] = defineCollection({
-			type: "page",
-			source: buildDocsSource(section),
-			schema: createDocsSchema().extend({
-				sitemap: defineSitemapSchema(),
-			}),
-		});
-	}
-}
-
-// The changelog is a single, locale-independent collection. Each entry is one
-// released version. The `/changelog` index queries it directly and renders every
-// body inline; each entry also has a deep-linkable detail route at
-// `/changelog/<version>` (app/pages/[[lang]]/changelog/[slug].vue). Both read
-// from this same collection — no content duplication — and both are prerendered.
-collections.changelog = defineCollection({
-	type: "page",
-	source: { include: "changelog/*.md" },
-	schema: z.object({
-		version: z.string(),
-		date: z.string(),
-		// Optional override for the GitHub release URL. Releases are tagged
-		// `styleframe@<version>` and the link is derived from that; the two
-		// earliest releases predate that tag convention and set this instead.
-		releaseUrl: z.string().url().optional(),
-	}),
+import { defineDocsCollections } from "@uxfront/layer-docs/content";
+import { DOCS_SECTIONS } from "./app/constants/sections";
+
+// Section topology lives in `app/constants/sections.ts`; the collection shapes,
+// per-locale fan-out and schemas live in the layer. `changelog` adds the
+// locale-independent release-history collection read by `/changelog` and
+// `/changelog/<version>`.
+export default defineDocsCollections(DOCS_SECTIONS, {
+	sitemap: true,
+	changelog: true,
 });
-
-export default defineContentConfig({ collections });
diff --git a/apps/docs/i18n/locales/ar.json b/apps/docs/i18n/locales/ar.json
deleted file mode 100644
index 649c8f7f..00000000
--- a/apps/docs/i18n/locales/ar.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "أو",
-		"error": {
-			"title": "الصفحة غير موجودة",
-			"description": "نأسف، لكن الصفحة التي تبحث عنها غير موجودة."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "نسخ الصفحة",
-			"link": "نسخ صفحة Markdown",
-			"view": "عرض كـ Markdown",
-			"gpt": "فتح في ChatGPT",
-			"claude": "فتح في Claude"
-		},
-		"links": "المجتمع",
-		"toc": "في هذه الصفحة",
-		"report": "الإبلاغ عن مشكلة",
-		"edit": "تحرير هذه الصفحة"
-	}
-}
diff --git a/apps/docs/i18n/locales/be.json b/apps/docs/i18n/locales/be.json
deleted file mode 100644
index 45689ad8..00000000
--- a/apps/docs/i18n/locales/be.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "або",
-		"error": {
-			"title": "Старонка не знойдзена",
-			"description": "Прабачце, але старонка, якую вы шукаеце, не знойдзена."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Скапіраваць старонку",
-			"link": "Скапіраваць Markdown-старонку",
-			"view": "Праглядзець як Markdown",
-			"gpt": "Адкрыць у ChatGPT",
-			"claude": "Адкрыць у Claude"
-		},
-		"links": "Супольнасць",
-		"toc": "На гэтай старонцы",
-		"report": "Паведаміць пра праблему",
-		"edit": "Рэдагаваць гэтую старонку"
-	}
-}
diff --git a/apps/docs/i18n/locales/bn.json b/apps/docs/i18n/locales/bn.json
deleted file mode 100644
index 58c17a48..00000000
--- a/apps/docs/i18n/locales/bn.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "অথবা",
-		"error": {
-			"title": "পেজ খুঁজে পাওয়া যায়নি",
-			"description": "দুঃখিত, আপনি যে পেজটি খুঁজছেন সেটি পাওয়া যায়নি।"
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "পেজ কপি করুন",
-			"link": "Markdown পেজ কপি করুন",
-			"view": "Markdown হিসেবে দেখুন",
-			"gpt": "ChatGPT এ খুলুন",
-			"claude": "Claude এ খুলুন"
-		},
-		"links": "কমিউনিটি",
-		"toc": "এই পেজে",
-		"report": "সমস্যা রিপোর্ট করুন",
-		"edit": "এই পেজ সম্পাদনা করুন"
-	}
-}
diff --git a/apps/docs/i18n/locales/ca.json b/apps/docs/i18n/locales/ca.json
deleted file mode 100644
index 1fabc59d..00000000
--- a/apps/docs/i18n/locales/ca.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "o",
-		"error": {
-			"title": "Pàgina no trobada",
-			"description": "Ho sentim, però la pàgina que cerques no existeix."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Copiar pàgina",
-			"link": "Copiar pàgina Markdown",
-			"view": "Veure com a Markdown",
-			"gpt": "Obrir a ChatGPT",
-			"claude": "Obrir a Claude"
-		},
-		"links": "Comunitat",
-		"toc": "En aquesta pàgina",
-		"report": "Informar d'un problema",
-		"edit": "Editar aquesta pàgina"
-	}
-}
diff --git a/apps/docs/i18n/locales/ckb.json b/apps/docs/i18n/locales/ckb.json
deleted file mode 100644
index 244a6cdc..00000000
--- a/apps/docs/i18n/locales/ckb.json
+++ /dev/null
@@ -1,18 +0,0 @@
-{
-	"common": {
-		"or": "یان"
-	},
-	"docs": {
-		"copy": {
-			"page": "کۆپیکردنی پەڕە",
-			"link": "کۆپیکردنی پەڕەی Markdown",
-			"view": "بینین وەک Markdown",
-			"gpt": "کردنەوە لە ChatGPT",
-			"claude": "کردنەوە لە Claude"
-		},
-		"links": "کۆمەڵگا",
-		"toc": "لەم پەڕەدا",
-		"report": "ڕاپۆرتکردنی کێشە",
-		"edit": "دەستکاریکردنی ئەم پەڕەیە"
-	}
-}
diff --git a/apps/docs/i18n/locales/cs.json b/apps/docs/i18n/locales/cs.json
deleted file mode 100644
index bc289800..00000000
--- a/apps/docs/i18n/locales/cs.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "nebo",
-		"error": {
-			"title": "Stránka nenalezena",
-			"description": "Je nám líto, ale stránka, kterou hledáte, nebyla nalezena."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Kopírovat stránku",
-			"link": "Kopírovat Markdown stránku",
-			"view": "Zobrazit jako Markdown",
-			"gpt": "Otevřít v ChatGPT",
-			"claude": "Otevřít v Claude"
-		},
-		"links": "Komunita",
-		"toc": "Na této stránce",
-		"report": "Nahlásit problém",
-		"edit": "Upravit tuto stránku"
-	}
-}
diff --git a/apps/docs/i18n/locales/da.json b/apps/docs/i18n/locales/da.json
deleted file mode 100644
index 7b70301d..00000000
--- a/apps/docs/i18n/locales/da.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "eller",
-		"error": {
-			"title": "Side ikke fundet",
-			"description": "Vi beklager, men siden du leder efter kunne ikke findes."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Kopier side",
-			"link": "Kopier Markdown side",
-			"view": "Vis som Markdown",
-			"gpt": "Åbn i ChatGPT",
-			"claude": "Åbn i Claude"
-		},
-		"links": "Fællesskab",
-		"toc": "På denne side",
-		"report": "Rapporter et problem",
-		"edit": "Rediger denne side"
-	}
-}
diff --git a/apps/docs/i18n/locales/de.json b/apps/docs/i18n/locales/de.json
deleted file mode 100644
index 982868de..00000000
--- a/apps/docs/i18n/locales/de.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "oder",
-		"error": {
-			"title": "Seite nicht gefunden",
-			"description": "Es tut uns leid, aber diese Seite konnte nicht gefunden werden."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Seite kopieren",
-			"link": "Markdown-Seite kopieren",
-			"view": "Als Markdown anzeigen",
-			"gpt": "In ChatGPT öffnen",
-			"claude": "In Claude öffnen"
-		},
-		"links": "Community",
-		"toc": "Auf dieser Seite",
-		"report": "Problem melden",
-		"edit": "Diese Seite bearbeiten"
-	}
-}
diff --git a/apps/docs/i18n/locales/el.json b/apps/docs/i18n/locales/el.json
deleted file mode 100644
index f7127575..00000000
--- a/apps/docs/i18n/locales/el.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "ή",
-		"error": {
-			"title": "Η σελίδα δεν βρέθηκε",
-			"description": "Λυπούμαστε, αλλά η σελίδα που αναζητάτε δεν υπάρχει."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Αντιγραφή σελίδας",
-			"link": "Αντιγραφή σελίδας Markdown",
-			"view": "Προβολή ως Markdown",
-			"gpt": "Άνοιγμα στο ChatGPT",
-			"claude": "Άνοιγμα στο Claude"
-		},
-		"links": "Κοινότητα",
-		"toc": "Σε αυτή τη σελίδα",
-		"report": "Αναφορά προβλήματος",
-		"edit": "Επεξεργασία αυτής της σελίδας"
-	}
-}
diff --git a/apps/docs/i18n/locales/en.json b/apps/docs/i18n/locales/en.json
deleted file mode 100644
index cc455e01..00000000
--- a/apps/docs/i18n/locales/en.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "or",
-		"error": {
-			"title": "Page not found",
-			"description": "We are sorry but this page could not be found."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Copy page",
-			"link": "Copy Markdown page",
-			"view": "View as Markdown",
-			"gpt": "Open in ChatGPT",
-			"claude": "Open in Claude"
-		},
-		"links": "Community",
-		"toc": "On this page",
-		"report": "Report an issue",
-		"edit": "Edit this page"
-	}
-}
diff --git a/apps/docs/i18n/locales/et.json b/apps/docs/i18n/locales/et.json
deleted file mode 100644
index b5776c4e..00000000
--- a/apps/docs/i18n/locales/et.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "või",
-		"error": {
-			"title": "Lehekülge ei leitud",
-			"description": "Vabandame, kuid otsitavat lehekülge ei leitud."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Kopeeri lehekülg",
-			"link": "Kopeeri Markdown lehekülg",
-			"view": "Vaata Markdownina",
-			"gpt": "Ava ChatGPT-s",
-			"claude": "Ava Claude'is"
-		},
-		"links": "Kogukond",
-		"toc": "Sellel lehel",
-		"report": "Teata probleemist",
-		"edit": "Muuda seda lehekülge"
-	}
-}
diff --git a/apps/docs/i18n/locales/fr.json b/apps/docs/i18n/locales/fr.json
deleted file mode 100644
index b08b7734..00000000
--- a/apps/docs/i18n/locales/fr.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "ou",
-		"error": {
-			"title": "Page non trouvée",
-			"description": "Nous sommes désolés, mais la page que vous cherchez n'existe pas."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Copier la page",
-			"link": "Copier le lien Markdown",
-			"view": "Voir en Markdown",
-			"gpt": "Ouvrir dans ChatGPT",
-			"claude": "Ouvrir dans Claude"
-		},
-		"links": "Communauté",
-		"toc": "Sur cette page",
-		"report": "Signaler un problème",
-		"edit": "Éditer cette page"
-	}
-}
diff --git a/apps/docs/i18n/locales/he.json b/apps/docs/i18n/locales/he.json
deleted file mode 100644
index 381a5b8e..00000000
--- a/apps/docs/i18n/locales/he.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "או",
-		"error": {
-			"title": "העמוד לא נמצא",
-			"description": "אנו מתנצלים, אך העמוד שאתה מחפש לא קיים."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "העתק עמוד",
-			"link": "העתק עמוד Markdown",
-			"view": "הצג כ-Markdown",
-			"gpt": "פתח ב-ChatGPT",
-			"claude": "פתח ב-Claude"
-		},
-		"links": "קהילה",
-		"toc": "בעמוד זה",
-		"report": "דווח על בעיה",
-		"edit": "ערוך עמוד זה"
-	}
-}
diff --git a/apps/docs/i18n/locales/hi.json b/apps/docs/i18n/locales/hi.json
deleted file mode 100644
index 4c458934..00000000
--- a/apps/docs/i18n/locales/hi.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "या",
-		"error": {
-			"title": "पृष्ठ नहीं मिला",
-			"description": "हमें खुशी है, लेकिन आप जो पृष्ठ खोज रहे हैं वह मौजूद नहीं है।"
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "पृष्ठ कॉपी करें",
-			"link": "Markdown पृष्ठ कॉपी करें",
-			"view": "Markdown के रूप में देखें",
-			"gpt": "ChatGPT में खोलें",
-			"claude": "Claude में खोलें"
-		},
-		"links": "समुदाय",
-		"toc": "इस पृष्ठ पर",
-		"report": "समस्या की रिपोर्ट करें",
-		"edit": "इस पृष्ठ को संपादित करें"
-	}
-}
diff --git a/apps/docs/i18n/locales/hy.json b/apps/docs/i18n/locales/hy.json
deleted file mode 100644
index 54ebe471..00000000
--- a/apps/docs/i18n/locales/hy.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "կամ",
-		"error": {
-			"title": "Էջը չի գտնվել",
-			"description": "Ներողություն, բայց այն էջը, որը փնտրում եք, չի գտնվել:"
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Պատճենել էջը",
-			"link": "Պատճենել Markdown էջը",
-			"view": "Դիտել որպես Markdown",
-			"gpt": "Բացել ChatGPT-ում",
-			"claude": "Բացել Claude-ում"
-		},
-		"links": "Համայնք",
-		"toc": "Այս էջում",
-		"report": "Հաղորդել խնդրի մասին",
-		"edit": "Խմբագրել այս էջը"
-	}
-}
diff --git a/apps/docs/i18n/locales/it.json b/apps/docs/i18n/locales/it.json
deleted file mode 100644
index 98f36b9d..00000000
--- a/apps/docs/i18n/locales/it.json
+++ /dev/null
@@ -1,18 +0,0 @@
-{
-	"common": {
-		"or": "o"
-	},
-	"docs": {
-		"copy": {
-			"page": "Copia pagina",
-			"link": "Copia pagina Markdown",
-			"view": "Visualizza come Markdown",
-			"gpt": "Apri in ChatGPT",
-			"claude": "Apri in Claude"
-		},
-		"links": "Comunità",
-		"toc": "In questa pagina",
-		"report": "Segnala un problema",
-		"edit": "Modifica questa pagina"
-	}
-}
diff --git a/apps/docs/i18n/locales/ja.json b/apps/docs/i18n/locales/ja.json
deleted file mode 100644
index bbb0e67c..00000000
--- a/apps/docs/i18n/locales/ja.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "または",
-		"error": {
-			"title": "ページが見つかりません",
-			"description": "申し訳ございませんが、お探しのページは見つかりませんでした。"
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "ページをコピー",
-			"link": "Markdownページをコピー",
-			"view": "Markdownとして表示",
-			"gpt": "ChatGPTで開く",
-			"claude": "Claudeで開く"
-		},
-		"links": "コミュニティ",
-		"toc": "このページの内容",
-		"report": "問題を報告",
-		"edit": "このページを編集"
-	}
-}
diff --git a/apps/docs/i18n/locales/kk.json b/apps/docs/i18n/locales/kk.json
deleted file mode 100644
index cd88bb66..00000000
--- a/apps/docs/i18n/locales/kk.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "немесе",
-		"error": {
-			"title": "Бет табылмады",
-			"description": "Кешіріңіз, бірақ сіз іздеген бет табылмады."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Бетті көшіру",
-			"link": "Markdown бетін көшіру",
-			"view": "Markdown ретінде көру",
-			"gpt": "ChatGPT-те ашу",
-			"claude": "Claude-те ашу"
-		},
-		"links": "Қауымдастық",
-		"toc": "Осы бетте",
-		"report": "Мәселе туралы хабарлау",
-		"edit": "Осы бетті өңдеу"
-	}
-}
diff --git a/apps/docs/i18n/locales/km.json b/apps/docs/i18n/locales/km.json
deleted file mode 100644
index 54aaa0c3..00000000
--- a/apps/docs/i18n/locales/km.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "ឬ",
-		"error": {
-			"title": "រកមិនឃើញទំព័រ",
-			"description": "យើងសុំទោស ប៉ុន្តែទំព័រដែលអ្នកកំពុងស្វែងរកមិនអាចរកឃើញទេ។"
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "ចម្លងទំព័រ",
-			"link": "ចម្លងទំព័រ Markdown",
-			"view": "មើលជា Markdown",
-			"gpt": "បើកនៅ ChatGPT",
-			"claude": "បើកនៅ Claude"
-		},
-		"links": "សហគមន៍",
-		"toc": "នៅលើទំព័រនេះ",
-		"report": "រាយការណ៍បញ្ហា",
-		"edit": "កែសម្រួលទំព័រនេះ"
-	}
-}
diff --git a/apps/docs/i18n/locales/ko.json b/apps/docs/i18n/locales/ko.json
deleted file mode 100644
index 6d67e47e..00000000
--- a/apps/docs/i18n/locales/ko.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "또는",
-		"error": {
-			"title": "페이지를 찾을 수 없습니다",
-			"description": "죄송합니다. 찾고 계신 페이지를 찾을 수 없습니다."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "페이지 복사",
-			"link": "Markdown 페이지 복사",
-			"view": "Markdown으로 보기",
-			"gpt": "ChatGPT에서 열기",
-			"claude": "Claude에서 열기"
-		},
-		"links": "커뮤니티",
-		"toc": "이 페이지에서",
-		"report": "문제 신고",
-		"edit": "이 페이지 편집"
-	}
-}
diff --git a/apps/docs/i18n/locales/ky.json b/apps/docs/i18n/locales/ky.json
deleted file mode 100644
index bbe50899..00000000
--- a/apps/docs/i18n/locales/ky.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "же",
-		"error": {
-			"title": "Барак табылган жок",
-			"description": "Кечиресиз, бирок сиз издеген барак табылган жок."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Баракты көчүрүү",
-			"link": "Markdown барагын көчүрүү",
-			"view": "Markdown катары көрүү",
-			"gpt": "ChatGPT'те ачуу",
-			"claude": "Claude'да ачуу"
-		},
-		"links": "Коом",
-		"toc": "Бул барактта",
-		"report": "Көйгөй туурасында кабарлоо",
-		"edit": "Бул баракты түзөтүү"
-	}
-}
diff --git a/apps/docs/i18n/locales/lb.json b/apps/docs/i18n/locales/lb.json
deleted file mode 100644
index 9817c64c..00000000
--- a/apps/docs/i18n/locales/lb.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "oder",
-		"error": {
-			"title": "Säit net fonnt",
-			"description": "Et deet ons leed, awer d'Säit déi Dir sicht gëtt et net."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Säit kopéieren",
-			"link": "Markdown Säit kopéieren",
-			"view": "Als Markdown kucken",
-			"gpt": "An ChatGPT opmaachen",
-			"claude": "An Claude opmaachen"
-		},
-		"links": "Gemeinschaft",
-		"toc": "Op dëser Säit",
-		"report": "Problem mellen",
-		"edit": "Dës Säit änneren"
-	}
-}
diff --git a/apps/docs/i18n/locales/ms.json b/apps/docs/i18n/locales/ms.json
deleted file mode 100644
index 851e80a6..00000000
--- a/apps/docs/i18n/locales/ms.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "atau",
-		"error": {
-			"title": "Halaman tidak dijumpai",
-			"description": "Kami mohon maaf, tetapi halaman yang anda cari tidak dapat dijumpai."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Salin halaman",
-			"link": "Salin halaman Markdown",
-			"view": "Lihat sebagai Markdown",
-			"gpt": "Buka di ChatGPT",
-			"claude": "Buka di Claude"
-		},
-		"links": "Komuniti",
-		"toc": "Dalam halaman ini",
-		"report": "Laporkan masalah",
-		"edit": "Edit halaman ini"
-	}
-}
diff --git a/apps/docs/i18n/locales/nb.json b/apps/docs/i18n/locales/nb.json
deleted file mode 100644
index 62f58523..00000000
--- a/apps/docs/i18n/locales/nb.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "eller",
-		"error": {
-			"title": "Side ikke funnet",
-			"description": "Vi beklager, men siden du leter etter kunne ikke finnes."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Kopier side",
-			"link": "Kopier Markdown-side",
-			"view": "Vis som Markdown",
-			"gpt": "Åpne i ChatGPT",
-			"claude": "Åpne i Claude"
-		},
-		"links": "Fellesskap",
-		"toc": "På denne siden",
-		"report": "Rapporter et problem",
-		"edit": "Rediger denne siden"
-	}
-}
diff --git a/apps/docs/i18n/locales/pl.json b/apps/docs/i18n/locales/pl.json
deleted file mode 100644
index 84e2829b..00000000
--- a/apps/docs/i18n/locales/pl.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "lub",
-		"error": {
-			"title": "Nie znaleziono strony",
-			"description": "Przepraszamy, ale nie znaleziono tej strony."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Skopiuj stronę",
-			"link": "Skopiuj stronę Markdown",
-			"view": "Wyświetl jako Markdown",
-			"gpt": "Otwórz w ChatGPT",
-			"claude": "Otwórz w Claude"
-		},
-		"links": "Społeczność",
-		"toc": "Na tej stronie",
-		"report": "Zgłoś problem",
-		"edit": "Edytuj tę stronę"
-	}
-}
diff --git a/apps/docs/i18n/locales/ru.json b/apps/docs/i18n/locales/ru.json
deleted file mode 100644
index 978337e4..00000000
--- a/apps/docs/i18n/locales/ru.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "или",
-		"error": {
-			"title": "Страница не найдена",
-			"description": "Извините, но запрашиваемая страница не найдена."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Копировать страницу",
-			"link": "Копировать Markdown-страницу",
-			"view": "Просмотреть как Markdown",
-			"gpt": "Открыть в ChatGPT",
-			"claude": "Открыть в Claude"
-		},
-		"links": "Сообщество",
-		"toc": "На этой странице",
-		"report": "Сообщить о проблеме",
-		"edit": "Редактировать эту страницу"
-	}
-}
diff --git a/apps/docs/i18n/locales/sl.json b/apps/docs/i18n/locales/sl.json
deleted file mode 100644
index 5ed0ac7f..00000000
--- a/apps/docs/i18n/locales/sl.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "ali",
-		"error": {
-			"title": "Stran ni bila najdena",
-			"description": "Opravičujemo se, vendar stran, ki jo iščete, ni bila najdena."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Kopiraj stran",
-			"link": "Kopiraj Markdown stran",
-			"view": "Prikaži kot Markdown",
-			"gpt": "Odpri v ChatGPT",
-			"claude": "Odpri v Claude"
-		},
-		"links": "Skupnost",
-		"toc": "Na tej strani",
-		"report": "Prijavi težavo",
-		"edit": "Uredi to stran"
-	}
-}
diff --git a/apps/docs/i18n/locales/sv.json b/apps/docs/i18n/locales/sv.json
deleted file mode 100644
index d0e63438..00000000
--- a/apps/docs/i18n/locales/sv.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "eller",
-		"error": {
-			"title": "Sidan hittades inte",
-			"description": "Vi ber om ursäkt, men sidan du letar efter kunde inte hittas."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Kopiera sida",
-			"link": "Kopiera Markdown-sida",
-			"view": "Visa som Markdown",
-			"gpt": "Öppna i ChatGPT",
-			"claude": "Öppna i Claude"
-		},
-		"links": "Gemenskap",
-		"toc": "På denna sida",
-		"report": "Rapportera ett problem",
-		"edit": "Redigera denna sida"
-	}
-}
diff --git a/apps/docs/i18n/locales/uk.json b/apps/docs/i18n/locales/uk.json
deleted file mode 100644
index 9537c76c..00000000
--- a/apps/docs/i18n/locales/uk.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "або",
-		"error": {
-			"title": "Сторінку не знайдено",
-			"description": "Вибачте, але сторінку, яку ви шукаєте, не знайдено."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Скопіювати сторінку",
-			"link": "Скопіювати Markdown сторінку",
-			"view": "Переглянути як Markdown",
-			"gpt": "Відкрити в ChatGPT",
-			"claude": "Відкрити в Claude"
-		},
-		"links": "Спільнота",
-		"toc": "На цій сторінці",
-		"report": "Повідомити про проблему",
-		"edit": "Редагувати цю сторінку"
-	}
-}
diff --git a/apps/docs/i18n/locales/ur.json b/apps/docs/i18n/locales/ur.json
deleted file mode 100644
index 873873f3..00000000
--- a/apps/docs/i18n/locales/ur.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "یا",
-		"error": {
-			"title": "صفحہ نہیں ملا",
-			"description": "ہمیں افسوس ہے، لیکن آپ جو صفحہ تلاش کر رہے ہیں وہ موجود نہیں ہے۔"
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "صفحہ کاپی کریں",
-			"link": "Markdown صفحہ کاپی کریں",
-			"view": "Markdown کے طور پر دیکھیں",
-			"gpt": "ChatGPT میں کھولیں",
-			"claude": "Claude میں کھولیں"
-		},
-		"links": "کمیونٹی",
-		"toc": "اس صفحے پر",
-		"report": "مسئلہ کی اطلاع دیں",
-		"edit": "اس صفحے کو ترمیم کریں"
-	}
-}
diff --git a/apps/docs/i18n/locales/vi.json b/apps/docs/i18n/locales/vi.json
deleted file mode 100644
index 6b88560d..00000000
--- a/apps/docs/i18n/locales/vi.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-	"common": {
-		"or": "hoặc",
-		"error": {
-			"title": "Không tìm thấy trang",
-			"description": "Chúng tôi xin lỗi, nhưng trang bạn đang tìm kiếm không tồn tại."
-		}
-	},
-	"docs": {
-		"copy": {
-			"page": "Sao chép trang",
-			"link": "Sao chép trang Markdown",
-			"view": "Xem dưới dạng Markdown",
-			"gpt": "Mở trong ChatGPT",
-			"claude": "Mở trong Claude"
-		},
-		"links": "Cộng đồng",
-		"toc": "Trên trang này",
-		"report": "Báo cáo sự cố",
-		"edit": "Chỉnh sửa trang này"
-	}
-}
diff --git a/apps/docs/modules/optimizeDeps.ts b/apps/docs/modules/optimizeDeps.ts
deleted file mode 100644
index e39f6590..00000000
--- a/apps/docs/modules/optimizeDeps.ts
+++ /dev/null
@@ -1,21 +0,0 @@
-import { defineNuxtModule, extendViteConfig } from "@nuxt/kit";
-
-export default defineNuxtModule({
-	async setup() {
-		// Update @nuxt/content optimizeDeps options
-		extendViteConfig((config) => {
-			config.optimizeDeps ||= {};
-			config.optimizeDeps.include ||= [];
-			config.optimizeDeps.include.push(
-				"@nuxt/content > slugify",
-				"@vueuse/core",
-				"motion-v",
-				"posthog-js",
-			);
-			config.optimizeDeps.include = config.optimizeDeps.include.map(
-				(id: string) =>
-					id.replace(/^@nuxt\/content > /, "docus > @nuxt/content > "),
-			);
-		});
-	},
-});
diff --git a/apps/docs/modules/useDocusI18nOverride.ts b/apps/docs/modules/useDocusI18nOverride.ts
deleted file mode 100644
index 4fe8587f..00000000
--- a/apps/docs/modules/useDocusI18nOverride.ts
+++ /dev/null
@@ -1,28 +0,0 @@
-import { defineNuxtModule, createResolver } from "@nuxt/kit";
-
-/**
- * Pin the `useDocusI18n` auto-import to this app's local composable.
- *
- * The `@uxfront/layer-docs` layer's `routing` module registers `useDocusI18n`
- * from the package itself, whose copy statically imports
- * `../../i18n/locales/en.json`. That locale file is not shipped in the
- * published package (its `files` array omits `i18n/`), so bundling the package
- * copy fails to resolve. This app already ships a working `useDocusI18n` that
- * resolves the JSON from its own `i18n/locales/`, so we repoint the import to
- * it. Remove this module once the package ships its `i18n/` locales.
- */
-export default defineNuxtModule({
-	meta: {
-		name: "use-docus-i18n-override",
-	},
-	setup(_options, nuxt) {
-		const { resolve } = createResolver(import.meta.url);
-		const local = resolve("../app/composables/useDocusI18n");
-
-		nuxt.hook("imports:extend", (imports) => {
-			const kept = imports.filter((i) => i.name !== "useDocusI18n");
-			imports.length = 0;
-			imports.push(...kept, { name: "useDocusI18n", from: local });
-		});
-	},
-});
diff --git a/apps/docs/nuxt.config.ts b/apps/docs/nuxt.config.ts
index 43a94cc0..0dd068df 100644
--- a/apps/docs/nuxt.config.ts
+++ b/apps/docs/nuxt.config.ts
@@ -17,15 +17,12 @@ export default defineNuxtConfig({
 	extends: ["@uxfront/layer-docs"],
 	compatibilityDate: "2025-07-22",
 	modules: [
-		resolve("./modules/optimizeDeps"),
 		"@nuxtjs/sitemap",
 		"@nuxt/content",
 		// The shared layer used to ship OG image support; the theme package
 		// does not, so styleframe registers it locally (see ogImage below).
 		"nuxt-og-image",
 		resolve("./modules/nonRouteCategories"),
-		// Must run after the theme's `routing` module — see module docblock.
-		resolve("./modules/useDocusI18nOverride"),
 	],
 	content: {
 		build: {
diff --git a/apps/docs/nuxt.schema.ts b/apps/docs/nuxt.schema.ts
deleted file mode 100644
index a5e30b04..00000000
--- a/apps/docs/nuxt.schema.ts
+++ /dev/null
@@ -1,243 +0,0 @@
-import { field, group } from "@nuxt/content/preview";
-
-export default defineNuxtSchema({
-	appConfig: {
-		ui: group({
-			title: "UI",
-			description: "UI Customization.",
-			icon: "i-lucide-palette",
-			fields: {
-				colors: group({
-					title: "Colors",
-					description: "Manage main colors of your application",
-					icon: "i-lucide-palette",
-					fields: {
-						primary: field({
-							type: "string",
-							title: "Primary",
-							description: "Primary color of your UI.",
-							icon: "i-lucide-palette",
-							default: "green",
-							required: [
-								"red",
-								"orange",
-								"amber",
-								"yellow",
-								"lime",
-								"green",
-								"emerald",
-								"teal",
-								"cyan",
-								"sky",
-								"blue",
-								"indigo",
-								"violet",
-								"purple",
-								"fuchsia",
-								"pink",
-								"rose",
-							],
-						}),
-						neutral: field({
-							type: "string",
-							title: "Neutral",
-							description: "Neutral color of your UI.",
-							icon: "i-lucide-palette",
-							default: "slate",
-							required: ["slate", "gray", "zinc", "neutral", "stone"],
-						}),
-					},
-				}),
-				icons: group({
-					title: "Icons",
-					description: "Manage icons used in the application.",
-					icon: "i-lucide-settings",
-					fields: {
-						search: field({
-							type: "icon",
-							title: "Search Bar",
-							description: "Icon to display in the search bar.",
-							icon: "i-lucide-search",
-							default: "i-lucide-search",
-						}),
-						dark: field({
-							type: "icon",
-							title: "Dark mode",
-							description: "Icon of color mode button for dark mode.",
-							icon: "i-lucide-moon",
-							default: "i-lucide-moon",
-						}),
-						light: field({
-							type: "icon",
-							title: "Light mode",
-							description: "Icon of color mode button for light mode.",
-							icon: "i-lucide-sun",
-							default: "i-lucide-sun",
-						}),
-						external: field({
-							type: "icon",
-							title: "External Link",
-							description: "Icon for external link.",
-							icon: "i-lucide-external-link",
-							default: "i-lucide-external-link",
-						}),
-						chevron: field({
-							type: "icon",
-							title: "Chevron",
-							description: "Icon for chevron.",
-							icon: "i-lucide-chevron-down",
-							default: "i-lucide-chevron-down",
-						}),
-						hash: field({
-							type: "icon",
-							title: "Hash",
-							description: "Icon for hash anchors.",
-							icon: "i-lucide-hash",
-							default: "i-lucide-hash",
-						}),
-					},
-				}),
-			},
-		}),
-		seo: group({
-			title: "SEO",
-			description: "SEO configuration.",
-			icon: "i-lucide-search",
-			fields: {
-				title: field({
-					type: "string",
-					title: "Title",
-					description: "Title to display in the header.",
-					icon: "i-lucide-type",
-					default: "",
-				}),
-				description: field({
-					type: "string",
-					title: "Description",
-					description: "Description to display in the header.",
-					icon: "i-lucide-type",
-					default: "",
-				}),
-			},
-		}),
-		header: group({
-			title: "Header",
-			description: "Header configuration.",
-			icon: "i-lucide-layout",
-			fields: {
-				title: field({
-					type: "string",
-					title: "Title",
-					description: "Title to display in the header.",
-					icon: "i-lucide-type",
-					default: "",
-				}),
-				logo: group({
-					title: "Logo",
-					description: "Header logo configuration.",
-					icon: "i-lucide-image",
-					fields: {
-						light: field({
-							type: "media",
-							title: "Light Mode Logo",
-							description: "Pick an image from your gallery.",
-							icon: "i-lucide-sun",
-							default: "",
-						}),
-						dark: field({
-							type: "media",
-							title: "Dark Mode Logo",
-							description: "Pick an image from your gallery.",
-							icon: "i-lucide-moon",
-							default: "",
-						}),
-						alt: field({
-							type: "string",
-							title: "Alt",
-							description: "Alt to display for accessibility.",
-							icon: "i-lucide-text",
-							default: "",
-						}),
-					},
-				}),
-				links: field({
-					type: "array",
-					title: "Links",
-					description: "Navigation links to display in the header.",
-					icon: "i-lucide-link",
-					default: [],
-				}),
-			},
-		}),
-		socials: field({
-			type: "object",
-			title: "Social Networks",
-			description: "Social links configuration.",
-			icon: "i-lucide-network",
-			default: {},
-		}),
-		toc: group({
-			title: "Table of contents",
-			description: "TOC configuration.",
-			icon: "i-lucide-list",
-			fields: {
-				title: field({
-					type: "string",
-					title: "Title",
-					description: "Title of the table of contents.",
-					icon: "i-lucide-heading",
-					default: "On this page",
-				}),
-				bottom: group({
-					title: "Bottom",
-					description: "Bottom section of the table of contents.",
-					icon: "i-lucide-list",
-					fields: {
-						title: field({
-							type: "string",
-							title: "Title",
-							description: "Title of the bottom section.",
-							icon: "i-lucide-heading",
-							default: "Community",
-						}),
-						links: field({
-							type: "array",
-							title: "Links",
-							description: "Links to display in the bottom section.",
-							icon: "i-lucide-link",
-							default: [],
-						}),
-					},
-				}),
-			},
-		}),
-		github: group({
-			title: "GitHub",
-			description: "GitHub configuration.",
-			icon: "i-simple-icons-github",
-			fields: {
-				url: field({
-					type: "string",
-					title: "URL",
-					description: "GitHub URL.",
-					icon: "i-simple-icons-github",
-					default: "",
-				}),
-				branch: field({
-					type: "string",
-					title: "Branch",
-					description: "GitHub branch.",
-					icon: "i-lucide-git-branch",
-					default: "main",
-				}),
-				rootDir: field({
-					type: "string",
-					title: "Root Directory",
-					description: "Root directory of the GitHub repository.",
-					icon: "i-lucide-folder",
-					default: "",
-				}),
-			},
-		}),
-	},
-});
diff --git a/apps/docs/package.json b/apps/docs/package.json
index b82a368d..feaca03c 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -23,7 +23,7 @@
 		"@nuxtjs/robots": "catalog:nuxt",
 		"@nuxtjs/sitemap": "catalog:nuxt",
 		"@unhead/vue": "catalog:nuxt",
-		"@uxfront/layer-docs": "^0.1.0",
+		"@uxfront/layer-docs": "^0.2.0",
 		"@vueuse/core": "catalog:nuxt",
 		"defu": "catalog:",
 		"motion-v": "catalog:nuxt",
@@ -61,7 +61,6 @@
 	},
 	"files": [
 		"LICENSE",
-		"utils",
 		"app"
 	]
 }
diff --git a/apps/docs/server/plugins/llms-redirect.ts b/apps/docs/server/plugins/llms-redirect.ts
deleted file mode 100644
index 76c0d7dc..00000000
--- a/apps/docs/server/plugins/llms-redirect.ts
+++ /dev/null
@@ -1,60 +0,0 @@
-import type { H3Event } from "h3";
-import { withoutTrailingSlash } from "ufo";
-
-/**
- * Serve `/llms.txt` from the homepage for AI agents and crawlers.
- *
- * Human browsers still get the rendered homepage; only clients that ask for
- * markdown (`Accept: text/markdown`) or identify as `curl` are redirected to
- * the `nuxt-llms` entry point. This mirrors Docus's agent-friendly behaviour
- * but works across Nitro presets (we deploy the node-server output), where the
- * upstream Vercel-config rewrite does not apply.
- *
- * It runs on the `request` hook rather than as route middleware so it fires
- * before Nitro's public-asset handler serves the prerendered homepage — route
- * middleware would never see a request for a statically generated page.
- */
-export default defineNitroPlugin((nitroApp) => {
-	nitroApp.hooks.hook("request", (event) => {
-		if (event.method !== "GET" && event.method !== "HEAD") {
-			return;
-		}
-
-		const path = withoutTrailingSlash(event.path.split("?")[0]) || "/";
-		if (!isRootPath(event, path)) {
-			return;
-		}
-
-		const accept = getHeader(event, "accept") ?? "";
-		const userAgent = getHeader(event, "user-agent") ?? "";
-
-		const wantsMarkdown = accept.includes("text/markdown");
-		const isCurl = /^curl\//i.test(userAgent);
-
-		if (wantsMarkdown || isCurl) {
-			return sendRedirect(event, "/llms.txt", 302);
-		}
-	});
-});
-
-/**
- * True for `/` and, when i18n is enabled, each locale homepage (e.g. `/en`).
- */
-function isRootPath(event: H3Event, path: string) {
-	if (path === "/") {
-		return true;
-	}
-
-	const i18n = useRuntimeConfig(event).public.i18n as
-		| { locales?: (string | { code: string })[] }
-		| undefined;
-
-	if (!i18n?.locales) {
-		return false;
-	}
-
-	return i18n.locales.some((locale) => {
-		const code = typeof locale === "string" ? locale : locale.code;
-		return path === `/${code}`;
-	});
-}
diff --git a/apps/docs/server/routes/raw/[...slug].md.get.ts b/apps/docs/server/routes/raw/[...slug].md.get.ts
deleted file mode 100644
index 8a617a54..00000000
--- a/apps/docs/server/routes/raw/[...slug].md.get.ts
+++ /dev/null
@@ -1,77 +0,0 @@
-import { withLeadingSlash } from "ufo";
-import { stringify } from "minimark/stringify";
-import { queryCollection } from "@nuxt/content/nitro";
-import type { Collections } from "@nuxt/content";
-import { DOCS_SECTIONS } from "~/constants/sections";
-
-export default eventHandler(async (event) => {
-	const slug = getRouterParams(event)["slug.md"];
-	if (!slug?.endsWith(".md")) {
-		throw createError({
-			statusCode: 404,
-			statusMessage: "Page not found",
-			fatal: true,
-		});
-	}
-
-	const path = withLeadingSlash(slug.replace(".md", ""));
-	const config = useRuntimeConfig(event).public;
-
-	const pathSegments = path.split("/").filter(Boolean);
-	let localeSegment: string | undefined;
-	let sectionIndex = 1; // expect /docs/<section>/...
-
-	const i18n = config.i18n as
-		| { locales?: (string | { code: string })[]; defaultLocale?: string }
-		| undefined;
-
-	if (i18n?.locales) {
-		const availableLocales = i18n.locales.map((locale) =>
-			typeof locale === "string" ? locale : locale.code,
-		);
-		const firstSegment = pathSegments[0];
-		if (firstSegment && availableLocales.includes(firstSegment)) {
-			localeSegment = firstSegment;
-			sectionIndex = 2;
-		} else if (i18n.defaultLocale) {
-			localeSegment = i18n.defaultLocale;
-		}
-	}
-
-	const sectionSlug = pathSegments[sectionIndex];
-	const section = DOCS_SECTIONS.find((s) => s.slug === sectionSlug);
-	if (!section) {
-		throw createError({
-			statusCode: 404,
-			statusMessage: "Page not found",
-			fatal: true,
-		});
-	}
-
-	const collectionName = localeSegment
-		? `docs_${section.key}_${localeSegment}`
-		: `docs_${section.key}`;
-
-	const page = await queryCollection(event, collectionName as keyof Collections)
-		.path(path)
-		.first();
-	if (!page) {
-		throw createError({
-			statusCode: 404,
-			statusMessage: "Page not found",
-			fatal: true,
-		});
-	}
-
-	// Add title and description to the top of the page if missing
-	if (page.body.value[0]?.[0] !== "h1") {
-		page.body.value.unshift(["blockquote", {}, page.description]);
-		page.body.value.unshift(["h1", {}, page.title]);
-	}
-
-	setHeader(event, "Content-Type", "text/markdown; charset=utf-8");
-	return stringify(
-		{ ...page.body, type: "minimark" },
-		{ format: "markdown/html" },
-	);
-});
diff --git a/apps/docs/utils/prerender.ts b/apps/docs/utils/prerender.ts
deleted file mode 100644
index ca9cd3d5..00000000
--- a/apps/docs/utils/prerender.ts
+++ /dev/null
@@ -1,11 +0,0 @@
-export const addPrerenderPath = (path: string) => {
-	const event = useRequestEvent();
-	if (event) {
-		event.node.res.setHeader(
-			"x-nitro-prerender",
-			[event.node.res.getHeader("x-nitro-prerender"), path]
-				.filter(Boolean)
-				.join(","),
-		);
-	}
-};

From 8e8aec37f124eb40ca3dbe21a5f55c4b8f81d8e4 Mon Sep 17 00:00:00 2001
From: Alex Grozav <alex@grozav.com>
Date: Tue, 28 Jul 2026 08:12:50 +0300
Subject: [PATCH 2/3] chore(docs): drop the unused useAppI18n composable
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

It imported `~~/i18n/locales/en.json`, which moved into
`@uxfront/layer-docs` with the rest of the locale files, and it had zero
call sites — the layer's `useDocusI18n` is what the components actually
use. Its docblock also referenced `apps/shared/modules/config.ts`, a path
that does not exist in this repo, so it had been dead for a while.
---
 apps/docs/app/composables/useAppI18n.ts | 49 -------------------------
 1 file changed, 49 deletions(-)
 delete mode 100644 apps/docs/app/composables/useAppI18n.ts

diff --git a/apps/docs/app/composables/useAppI18n.ts b/apps/docs/app/composables/useAppI18n.ts
deleted file mode 100644
index 96b614a5..00000000
--- a/apps/docs/app/composables/useAppI18n.ts
+++ /dev/null
@@ -1,49 +0,0 @@
-import type { LocaleObject } from "@nuxtjs/i18n";
-import type { Ref } from "vue";
-import en from "~~/i18n/locales/en.json";
-
-/**
- * `@nuxtjs/i18n` auto-imports. This app ships with i18n disabled — the module is
- * not registered (see apps/shared/modules/config.ts) — so the enabled branch
- * below is inert. These declarations let the file typecheck without the module
- * generating the globals; when i18n is enabled the real composables are used.
- */
-declare function useI18n(): { locale: Ref<string>; t: (key: string) => string };
-declare function useLocalePath(): (route: string, locale?: string) => string;
-declare function useSwitchLocalePath(): (locale: string) => string;
-
-export const useAppI18n = () => {
-	const config = useRuntimeConfig().public;
-	const isEnabled = ref(!!config.i18n);
-
-	if (!isEnabled.value) {
-		return {
-			isEnabled,
-			locale: ref("en"),
-			locales: [],
-			localePath: (path: string) => path,
-			switchLocalePath: (_locale?: string): string => "",
-			t: (key: string): string => {
-				const path = key.split(".");
-				return path.reduce(
-					(acc: unknown, curr) => (acc as Record<string, unknown>)?.[curr],
-					en,
-				) as string;
-			},
-		};
-	}
-
-	const { locale, t } = useI18n();
-	const filteredLocales =
-		(config.docus as { filteredLocales: LocaleObject<string>[] })
-			?.filteredLocales || [];
-
-	return {
-		isEnabled,
-		locale,
-		locales: filteredLocales,
-		t,
-		localePath: useLocalePath(),
-		switchLocalePath: useSwitchLocalePath(),
-	};
-};

From bbf8d10b28ccd70eb48049a7381e5caa0c768248 Mon Sep 17 00:00:00 2001
From: Alex Grozav <alex@grozav.com>
Date: Thu, 6 Aug 2026 08:48:07 +0300
Subject: [PATCH 3/3] chore(deps): lock @uxfront/layer-docs to the published
 0.2.0
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The pin moved to ^0.2.0 with the layer extraction, but the lockfile still
resolved 0.1.0 because that release did not exist yet. It does now, so
the entry is regenerated against the registry — no local override.
---
 pnpm-lock.yaml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index fc89eacd..332012e6 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -422,8 +422,8 @@ importers:
         specifier: catalog:nuxt
         version: 2.0.19(vue@3.5.38(typescript@6.0.3))
       '@uxfront/layer-docs':
-        specifier: ^0.1.0
-        version: 0.1.0(85e3e4239b7356efe0ee0e8a759b4dba)
+        specifier: ^0.2.0
+        version: 0.2.0(85e3e4239b7356efe0ee0e8a759b4dba)
       '@vueuse/core':
         specifier: catalog:nuxt
         version: 14.3.0(vue@3.5.38(typescript@6.0.3))
@@ -6289,8 +6289,8 @@ packages:
   '@unocss/core@66.7.0':
     resolution: {integrity: sha512-j6MFMx5C3iIwW4T4hVbh+30fKWgSGkmS3bCcdjlfqM88lRT+dHFBN9nkfNOBJT6e6IHN9415nexuzcQvTjJXxw==}
 
-  '@uxfront/layer-docs@0.1.0':
-    resolution: {integrity: sha512-UTWvToIFLPqmwmnAZoiXET2+om6EFHi9FpsIt20z5XLNZ1BlLMeO/hT0VyFGhN8hXJoG3rX3G/w/2B0zZlY0zQ==}
+  '@uxfront/layer-docs@0.2.0':
+    resolution: {integrity: sha512-AW2yNCaxGrQ9OGG2W2IlVocCZtOmzYg/f/sFahOA3Gju5VKh6SaNEcBrgEHv+JSWRj2jD397w3LtCrmiM+Ij8Q==}
     peerDependencies:
       '@nuxt/content': ^3.14.0
       '@nuxt/image': ^1.11.0
@@ -18571,7 +18571,7 @@ snapshots:
 
   '@unocss/core@66.7.0': {}
 
-  '@uxfront/layer-docs@0.1.0(85e3e4239b7356efe0ee0e8a759b4dba)':
+  '@uxfront/layer-docs@0.2.0(85e3e4239b7356efe0ee0e8a759b4dba)':
     dependencies:
       '@nuxt/content': 3.14.0(@valibot/to-json-schema@1.7.0(valibot@1.4.1(typescript@6.0.3)))(better-sqlite3@12.10.1)(magicast@0.3.5)(valibot@1.4.1(typescript@6.0.3))
       '@nuxt/image': 1.11.0(@netlify/blobs@9.1.2)(db0@0.3.4(better-sqlite3@12.10.1))(ioredis@5.10.1)(magicast@0.3.5)