@uxfront/layer-docs 0.4.1 → 0.5.0

package/nuxt.config.ts

@@ -1,181 +1,25 @@
-import { createResolver, useNuxt } from "@nuxt/kit";
-
-const { resolve } = createResolver(import.meta.url);
-
 /**
- * `@uxfront/layer-docs` — a neutral, brandable Nuxt-layer documentation theme.
- *
- * Consumers extend it via `extends: ['@uxfront/layer-docs']` and supply their
- * own branding (title, logos, socials, palette) through their `app.config.ts`,
- * merged over the layer's neutral defaults by Nuxt's `defu` layer merge. The
- * section topology (`DOCS_SECTIONS`) and markdown content stay in the consumer.
- *
- * i18n is OFF by default: `@nuxtjs/i18n` is not registered here, so a v1 single
- * locale site "just works". A consumer that wants localisation registers the
- * module itself; `modules/config` + `useDocusI18n` pick it up automatically.
- *
- * ## Styling: the consumer owns the single Tailwind entry
- *
- * This layer deliberately does NOT register `app/assets/css/main.css` in `css`.
- * Its base is palette-free, so a consumer's brand `@theme` only compiles if it
- * lives inside the same Tailwind pass — which means the consumer's CSS file has
- * to *import* this base, not sit beside it. Registering it here as well gave
- * every consumer two Tailwind entries and a byte-for-byte duplicate of every
- * base utility in the shipped stylesheet (+26.7 KB gzip on inkline, UXF-118),
- * and left each consumer to un-register what the layer had just registered.
+ * `@uxfront/layer-docs`: the Nuxt side of UXFront's documentation sites.
  *
- * Consumers therefore register exactly one CSS entry, their own:
- *
- * ```ts
- * // nuxt.config.ts
- * css: ["./app/assets/css/main.css"],
- * ```
- *
- * whose first line imports this base, followed by the brand `@theme`. Both
- * halves are guarded by `@uxfront/layer-docs/test`; see README § Styling.
+ * It extends Docus, which renders `content/docs/` with its header, sidebar,
+ * search and table of contents, and adds a framework switcher on top: a
+ * `::framework-switcher` content component with one slot per framework, and a
+ * Framework select above the sidebar. The app lists its frameworks in
+ * `docsTheme.frameworks` in its `app.config.ts`.
  *
  * https://nuxt.com/docs/getting-started/layers
  */
 export default defineNuxtConfig({
-  compatibilityDate: "2025-07-22",
-  telemetry: false,
-  // Expose `app/constants/` (DOCS_SECTIONS, findDocsSectionBySlug) as
-  // auto-imports. The layer ships a neutral empty default; a consumer's own
-  // `app/constants/` overrides it via auto-import dir precedence.
-  imports: {
-    dirs: ["constants"],
-  },
-  modules: [
-    resolve("./modules/config"),
-    resolve("./modules/routing"),
-    resolve("./modules/optimizeDeps"),
-    "@nuxt/ui",
-    "@nuxt/image",
-    "@nuxt/scripts",
-    "@nuxtjs/robots",
-    "@nuxtjs/sitemap",
-    "@nuxt/content",
-    "nuxt-llms",
-    "nuxt-og-image",
-  ],
-  icon: {
-    serverBundle: "local",
-    fetchTimeout: 10000,
-  },
-  // Syntax-highlighting language set + MDC auto-unwrap. Shared across every
-  // docs consumer; brand-agnostic.
-  content: {
-    build: {
-      markdown: {
-        highlight: {
-          langs: [
-            "bash",
-            "diff",
-            "json",
-            "js",
-            "ts",
-            "tsx",
-            "html",
-            "css",
-            "vue",
-            "svelte",
-            "astro",
-            "shell",
-            "mdc",
-            "md",
-            "yaml",
-          ],
-        },
-        remarkPlugins: {
-          "remark-mdc": {
-            options: {
-              autoUnwrap: true,
-            },
-          },
-        },
-      },
-    },
-  },
-  nitro: {
-    prerender: {
-      crawlLinks: true,
-      failOnError: false,
-      autoSubfolderIndex: false,
-    },
-  },
-  hooks: {
-    // Seed the prerender crawl with the site root(s). Without i18n that's just
-    // "/"; with i18n it's each locale root ("/en", "/fr", ...). Everything else
-    // is reached via crawlLinks.
-    "nitro:config"(nitroConfig) {
-      const nuxt = useNuxt();
-      const i18nOptions = nuxt.options.i18n as
-        | { locales?: Array<string | { code: string }> }
-        | undefined;
-
-      const routes: string[] = [];
-      if (!i18nOptions?.locales?.length) {
-        routes.push("/");
-      } else {
-        routes.push(
-          ...i18nOptions.locales.map((locale) =>
-            typeof locale === "string" ? `/${locale}` : `/${locale.code}`,
-          ),
-        );
-      }
+  extends: ["docus"],
 
-      nitroConfig.prerender = nitroConfig.prerender || {};
-      nitroConfig.prerender.routes = nitroConfig.prerender.routes || [];
-      nitroConfig.prerender.routes.push(...routes);
-    },
-  },
-  /**
-   * OG images are on by default — same class of SEO plumbing as sitemap and
-   * robots, which this layer also registers unasked. A consumer opts out with
-   * the module's own `ogImage: { enabled: false }`; no layer-specific key.
-   *
-   * Prerendering bakes every card at build time, so no runtime generation
-   * endpoint is needed (or exposed unsigned).
-   * @docs https://nuxtseo.com/og-image/guides/zero-runtime
-   */
-  ogImage: {
-    zeroRuntime: true,
-    // 1.91:1, the ratio every major crawler crops to. The module's own default
-    // is 1200×600 (2:1), which gets letterboxed or trimmed on most previews.
-    defaults: {
-      width: 1200,
-      height: 630,
-    },
-  },
-  // Generic sitemap defaults; brand values (url/name) come from the consumer's
-  // `site` config or are inferred in `modules/config`.
-  sitemap: {
-    enabled: true,
-    discoverImages: true,
-    discoverVideos: true,
-  },
-  // Neutral analytics defaults. The PostHog client plugin (ships in this layer)
-  // only initialises in production when `app.config` `analytics.enabled` is true
-  // and a key is present; consumers override the key/host from their own env.
-  runtimeConfig: {
-    public: {
-      posthog: {
-        key: "",
-        host: "https://us.i.posthog.com",
-        defaults: "2025-05-24",
+  icon: {
+    clientBundle: {
+      scan: {
+        // Nuxt Icon's default, plus app config files, where `docsTheme.frameworks`
+        // names its icons. The sidebar's select shows them on every page, so
+        // without this, pages with no switcher fetch them from the Iconify API.
+        globInclude: ["**/*.{vue,jsx,tsx,md,mdc,mdx,yml,yaml}", "**/app.config.{ts,mts,js,mjs}"],
       },
-      // Where `StorybookEmbed` points. Empty here — the host is a consumer
-      // fact, and where a Storybook is deployed changes without a code change,
-      // so this is runtime config (`NUXT_PUBLIC_STORYBOOK_BASE_URL`) rather
-      // than app config. A `{framework}` placeholder addresses per-framework
-      // deployments; a template without one is used as-is.
-      storybookBaseUrl: "",
-      // Migration-only: a brand namespace whose `<ns>:theme` / `<ns>:height`
-      // messages a consumer's Storybook already speaks. Set it and the embed
-      // emits and accepts both those names and the neutral ones, so the docs
-      // site and the Storybook can deploy in either order. Unset it once both
-      // sides are on `@uxfront/layer-docs/storybook`.
-      storybookLegacyMessageNamespace: "",
     },
   },
 });

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "@uxfront/layer-docs",
-  "version": "0.4.1",
-  "description": "Neutral, brandable Nuxt-layer documentation theme. Consumers extend it and supply their own branding, content and section topology.",
+  "version": "0.5.0",
+  "description": "Nuxt layer for UXFront documentation sites: Docus, plus a framework switcher that shows every reader the examples for their framework.",
   "keywords": [
     "docs",
     "documentation",
     "docus",
     "nuxt",
-    "nuxt-layer",
-    "theme"
+    "nuxt-layer"
   ],
   "homepage": "https://github.com/uxfront-com/uxfront/tree/main/packages/layer-docs#readme",
   "bugs": "https://github.com/uxfront-com/uxfront/issues",
@@ -20,18 +19,8 @@
   },
   "files": [
     "app",
-    "i18n",
-    "modules",
-    "server",
-    "storybook",
-    "test",
-    "utils",
     "nuxt.config.ts",
-    "nuxt.schema.ts",
-    "tsconfig.json",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
+    "README.md"
   ],
   "type": "module",
   "main": "./nuxt.config.ts",
@@ -41,77 +30,21 @@
       "types": "./nuxt.config.ts",
       "import": "./nuxt.config.ts"
     },
-    "./content": {
-      "types": "./utils/content.ts",
-      "import": "./utils/content.ts"
-    },
-    "./storybook": {
-      "types": "./storybook/index.ts",
-      "import": "./storybook/index.ts"
-    },
-    "./test": {
-      "types": "./test/brand-palette.ts",
-      "import": "./test/brand-palette.ts"
-    },
-    "./app/assets/css/main.css": "./app/assets/css/main.css",
     "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@vueuse/core": "^14.3.0",
-    "defu": "^6.1.4",
-    "git-url-parse": "^16.1.0",
-    "minimark": "^0.2.0",
-    "motion-v": "^1.7.2",
-    "pkg-types": "^2.3.1",
-    "scule": "^1.3.0",
-    "ufo": "^1.6.4"
+    "@vueuse/core": "^14.4.0",
+    "docus": "^5.13.0"
   },
   "devDependencies": {
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.10"
+    "nuxt": "^4.5.2",
+    "vue": "^3.5.43"
   },
   "peerDependencies": {
-    "@nuxt/content": "^3.14.0",
-    "@nuxt/image": "^1.11.0",
-    "@nuxt/kit": "^4.4.8",
-    "@nuxt/scripts": "^0.11.13",
-    "@nuxt/ui": "^4.8.2",
-    "@nuxtjs/i18n": "^10.4.0",
-    "@nuxtjs/mdc": "^0.22.0",
-    "@nuxtjs/robots": "^6.1.1",
-    "@nuxtjs/sitemap": "^8.2.1",
-    "@resvg/resvg-js": "^2.6.0",
-    "nuxt": "^4.4.8",
-    "nuxt-llms": "^0.2.0",
-    "nuxt-og-image": "^6.6.0",
-    "posthog-js": "^1.386.6",
-    "satori": "^0.26.0",
-    "tailwindcss": "^4.3.1",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.10",
-    "vue": "^3.5.38"
-  },
-  "peerDependenciesMeta": {
-    "@nuxtjs/i18n": {
-      "optional": true
-    },
-    "@nuxtjs/mdc": {
-      "optional": true
-    },
-    "posthog-js": {
-      "optional": true
-    },
-    "typescript": {
-      "optional": true
-    },
-    "vitest": {
-      "optional": true
-    }
-  },
-  "scripts": {
-    "postinstall": "nuxt prepare"
+    "nuxt": "^4.5.0",
+    "vue": "^3.5.0"
   }
 }

package/CHANGELOG.md

@@ -1,192 +0,0 @@
-# @uxfront/layer-docs
-
-## 0.4.1
-
-### Patch Changes
-
-- Republish the `0.4.0` code through automated release tooling. No code changes.
-
-  `0.4.0` and every version before it were published by hand from a maintainer's machine. Nothing linked a version on the registry back to the commit it was built from, and the release depended on a long-lived npm token.
-
-  `0.4.1` is the first version published from CI, by Changesets, over npm trusted publishing. No npm token takes part: the registry credential is minted for each run from a GitHub OIDC token. Every shipped file is byte-identical to `0.4.0` except this changelog entry and the `version` field.
-
-  This release carries **no provenance attestation**. npm does not generate provenance for a package built from a private source repository, and `uxfront` is private. Provenance becomes available if the repository becomes public. It is not a property of this version.
-
-## 0.4.0
-
-### Minor Changes
-
-- a4caf06: Ship OG image support and the two satori card templates.
-
-  Every consumer was registering `nuxt-og-image` itself and carrying its own copy of the templates, which meant carrying a page override too — `defineOgImage` cannot be called from the layer if the module is not registered by it. The layer now registers the module beside `@nuxtjs/sitemap` and `@nuxtjs/robots` (same class of SEO plumbing it already turns on unasked) and calls `defineOgImage` from its own docs and landing pages, so a consumer that extends the layer gets branded cards without writing anything. Opt out with the module's own switch, `ogImage: { enabled: false }`.
-
-  **The accent is a brand token, not a hardcoded colour.** The existing copies hardcoded a Tailwind class, which was wrong in a way that only showed up on the rendered card: every consumer shadows stock Tailwind scale names with its own values in `@theme`, so `text-teal-500` renders Tailwind's teal, not the brand's. Custom properties are not an option either — satori has no CSS cascade, and `var(--ui-primary)` resolves to nothing. The accent is therefore resolved to a literal at build time by following `--ui-primary` to the `--color-<scale>` declaration it aliases in the consumer's registered CSS, the same two hops the browser does and the same pair `describeBrandPaletteCss` already asserts. Override it with a literal via `ogImage.accent` in `app.config.ts`.
-
-  Two parts of the card are components rather than props, because `defineOgImage` serialises its arguments and a Vue slot cannot cross that boundary. Shadow `app/AppOgDecoration.vue` (a neutral radial wash) or `app/AppOgLogo.vue` (a wordmark from `header.title`) at the same path to replace either.
-
-  Cards render at 1200×630 rather than the module's 1200×600 default — 1.91:1 is the ratio crawlers crop to.
-
-  New peer dependencies: `nuxt-og-image`, `satori`, and `@resvg/resvg-js`. Satori renders the template to SVG and needs a separate rasteriser for the PNG; without one, prerendering logs `renderer.createImage error` per card and emits nothing.
-
-- 5cc11f2: Add `StorybookEmbed` and the `@uxfront/layer-docs/storybook` bridge.
-
-  `StorybookEmbed` embeds a deployed Storybook story in a docs page, in one of
-  three modes — `preview` (canvas only), `full` (manager without the sidebar), and
-  `panel` (manager with the controls panel). It mounts lazily, keeps the
-  Storybook's colour mode in sync with the page's, and grows to fit its story
-  without shifting layout. The Storybook host comes from
-  `NUXT_PUBLIC_STORYBOOK_BASE_URL`, with an optional `{framework}` placeholder for
-  per-framework deployments.
-
-  The `/storybook` subpath export ships the other half of that contract:
-  `installDocsEmbedPreviewBridge` and `installDocsEmbedManagerBridge`, which are
-  framework-free and import nothing from Nuxt. A Storybook that already speaks a
-  branded message namespace can name it via
-  `NUXT_PUBLIC_STORYBOOK_LEGACY_MESSAGE_NAMESPACE`, and both sides accept and emit
-  both spellings so the two can deploy in either order.
-
-## 0.3.0
-
-### Minor Changes
-
-- 751810d: Stop registering the layer's own `main.css`, and ship the brand-palette guards consumers were each expected to write themselves.
-
-  **Breaking for any consumer that does not already register its own CSS entry.** The layer registered `app/assets/css/main.css` in `css` while every consumer also imported that same base from its brand CSS — because a brand `@theme` only compiles into real `:root` custom properties when it lives inside a Tailwind pass, which means importing the base rather than sitting beside it. Two entries, two Tailwind passes, and a byte-for-byte duplicate of every base utility in the shipped stylesheet: **+212 KB raw / +26.7 KB gzip (+94%)** on inkline's render-blocking `entry.css`, on every page, for every visitor (UXF-118).
-
-  The layer no longer registers it. Consumers register exactly one CSS entry of their own, whose first line imports the layer base — which is what all three consumers were already doing, one of them via a `modules:done` hook that un-registered what the layer had just registered. That hook can now be deleted.
-
-  **Migration.** If your app already has `css: ["./app/assets/css/main.css"]` pointing at a file that starts with `@import "@uxfront/layer-docs/app/assets/css/main.css"`, nothing changes except that your stylesheet halves; drop any hook that stripped the layer's entry. If it does not, add both — see README § Styling. There is no silent middle state: without a CSS entry the app ships no Tailwind utilities at all.
-
-  **What the duplication actually cost.** Payload, not layout. The duplicate pass measured on inkline was a complete superset of the first and was emitted wholly after it, so the last `sm:`/`lg:` variant still landed after the last conflicting base and won by source order — computed-style A/B across 4 pages × 4 viewports found zero rendering difference. That rescue was incidental rather than designed, which is why the cause is fixed rather than the symptom.
-
-  **New: `@uxfront/layer-docs/test`.** The two guards that would have caught this before ship, now parameterised by brand scale instead of copy-pasted per repo. `describeBrandPaletteCss` asserts, without a build, that your CSS entry imports the layer base before its `@theme` and defines the scale it maps onto `--ui-primary`. `describeSingleTailwindPass` reads the built stylesheet and asserts every base utility is emitted **exactly once** — catching a duplicate pass and a CSS entry that never reached the bundle with the same assertion. `vitest` is an optional peer dependency, needed only for these.
-
-  Also fixed: three code comments claimed the second pass "kills every `sm:`/`lg:` responsive variant". It does not, in the equal-superset case measured; the guards now describe the duplicate payload they actually guard.
-
-## 0.2.1
-
-### Patch Changes
-
-- Stop the optional `posthog-js` peer from killing the client bundle of every consumer that omits it.
-
-  `app/plugins/posthog.client.ts` imported `posthog-js` statically at module scope while declaring it an **optional** `peerDependency`. Rollup has no module to resolve for a consumer that skipped the optional peer, so it emits the specifier as a module-scope throw:
-
-  ```js
-  const HB = {};
-  throw new Error('Could not resolve "posthog-js" imported by "@uxfront/layer-docs".');
-  ```
-
-  That throw runs on evaluation, before the plugin body — so neither the `analytics.enabled` guard nor the `posthog.key` guard ever executed, and the failure was not confined to analytics. The whole client entry died with it: **the site did not hydrate at all**. Every page served as a dead static document — theme toggle stuck on its loading skeleton, framework tabs inert, no client-side routing, `localStorage` never written — with one console error per route as the only signal. Present in `0.1.0`, `0.1.1` and `0.2.0`.
-
-  `posthog-js` is now imported dynamically, inside the branch that has already confirmed analytics is enabled and a key is provisioned. The unresolvable specifier moves out of the client entry into its own lazy chunk that a consumer without the peer never evaluates — it is emitted, prefetched at most, and never run. The import is also wrapped, which keeps the failure proportional to what failed: a missing or broken module degrades to a console warning and no analytics, instead of a dead app.
-
-  `modules/optimizeDeps` carried the same assumption from the other direction — it named `posthog-js` in `optimizeDeps.include` unconditionally, which is a hard dev-server error when the package is not installed. The hint is now added only when the dependency actually resolves.
-
-  Consumers who do not use PostHog need no changes and should upgrade. Consumers who do use it are unaffected: `$posthog()` is provided exactly as before once the client initialises.
-
-## 0.2.0
-
-### Minor Changes
-
-- Absorb documentation-site plumbing that consumers were re-declaring by hand.
-
-  - `defineDocsCollections(sections, options)` gains `{ sitemap?, changelog? }`. With
-    `sitemap: true` the landing and docs collections carry `defineSitemapSchema()`;
-    with `changelog: true` a `changelog` collection is registered over
-    `changelog/*.md`. Both default to `false`, so existing single-argument calls are
-    unchanged. Per-locale collections are now gated on `locales.length > 0` rather
-    than the array's mere presence.
-  - 30 additional locales ship with the layer (ar, be, bn, ca, ckb, cs, da, de, el,
-    et, fr, he, hi, hy, it, ja, kk, km, ko, ky, lb, ms, nb, pl, ru, sl, sv, uk, ur,
-    vi), each complete against `en.json`.
-  - `nuxt.schema.ts` ships with the layer, so the Content Studio preview schema for
-    `app.config.ts` is described once instead of per consumer.
-  - New `modules/optimizeDeps` module pre-bundles the layer's own heavier runtime
-    dependencies; registered automatically.
-  - New `DocsAsideLeftTop` / `DocsFrameworkSelect` render a persistent framework
-    selector above the sidebar navigation, and `GradientPageHero` puts `UPageHero`
-    on `MorphingGradientBackground`. Both render only when the consumer opts in.
-
-  **Breaking-ish:** `useFramework()` no longer ships a built-in React/Vue/Vanilla
-  default list. `frameworks` is now `appConfig.docsTheme.frameworks ?? []`, making
-  app config the single source of truth. Sites that relied on the implicit default
-  must declare `docsTheme.frameworks` in their own `app.config.ts`; `FrameworkSwitcher`
-  renders no tab bar when the list is empty.
-
-### Patch Changes
-
-- Correct the changelog so it matches what was actually published. `0.1.1` shipped
-  with no entry of its own while an entry for a `0.1.2` that was never published
-  sat at the top of the file, so consumers had no way to learn from the changelog
-  that `0.1.1` contains accessibility fixes for `button-name` and
-  `nested-interactive` violations. `0.1.1` now has a complete entry, and the
-  `AppHeaderCTA.vue` typecheck fix previously filed under `0.1.2` is recorded
-  under `0.1.0`, the release it actually shipped in.
-
-Note: `0.2.0` was versioned by a hand `chore: bump version` commit that bypassed
-`changeset version`, so it published with no changelog entry at all — the tarball
-topped out at a `## 0.1.2` heading for a version that was versioned but never
-published. The entry above is the accurate, reconstructed record of what `0.2.0`
-actually contains, and the changelog-only correction previously filed under
-`0.1.2` is folded in here because `0.2.0` is the release it shipped in. Every
-heading in this file now corresponds to a version that exists on the registry.
-Second occurrence of UXF-67; see UXF-168.
-
-## 0.1.1
-
-### Minor Changes
-
-- Add `header.attribution` so a consuming app can render a partially-linked
-  wordmark, e.g. "uxd by UXFront" where only "UXFront" links out. The header now
-  owns UHeader's `#left` slot instead of `#title`, because `#title` is rendered
-  inside UHeader's own home link and an attribution link there would nest
-  anchors. Apps that do not set `attribution` render exactly as before.
-
-### Patch Changes
-
-- Fix accessible names on icon-only navigation controls and hide the section
-  sub-header when there is nothing to switch between.
-
-  - The mobile menu toggle and the "copy page" dropdown trigger now expose
-    accessible names (sourced from the active locale), clearing two critical
-    `button-name` violations that shipped on every page. **Consumers on `0.1.0`
-    should upgrade** — those violations were present on every page of every
-    site extending this layer.
-  - The page footer separator is now `decorative`, clearing a serious
-    `nested-interactive` violation caused by focusable links inside an element
-    with `role="separator"`.
-  - The docs sub-header no longer renders when the consumer declares one section
-    or none, so a single-section site gets no empty bar and no extra header
-    height.
-
-- Skip PostHog initialisation when no key is provisioned
-  (`NUXT_PUBLIC_POSTHOG_KEY` unset), instead of initialising a client that fires
-  requests at nothing.
-
-Note: `0.1.1` was versioned by hand rather than through `changeset version`, so
-it published as a patch even though `header.attribution` is additive and would
-have produced `0.2.0`. The published number stands; the entry above is the
-accurate record of its contents. See UXF-67.
-
-## 0.1.0
-
-### Minor Changes
-
-- Initial scaffold of the neutral Nuxt-layer docs theme: auto-config module
-  (site metadata / SEO / git inference), neutral `app.config` defaults and UI
-  polish, base `main.css` (Tailwind + Nuxt UI wiring, palette-free),
-  `MorphingGradientBackground`, and opt-out-gated i18n-redirect and PostHog
-  plugins. Nuxt documentation stack declared as pinned `peerDependencies`.
-
-### Patch Changes
-
-- Fix `nuxt typecheck` failure in `AppHeaderCTA.vue`: the config module seeds a
-  partial `header` (`{ title }`), so defu narrows the resolved `AppConfig` header
-  to `{ title, logo }` and drops the array-valued `links`. Read `links` through a
-  cast on `header` itself instead of the `.links` result, so consumers extending
-  the layer typecheck cleanly. Runtime behaviour is unchanged.
-
-  This fix was previously filed under a `## 0.1.2` heading that no published
-  release ever carried. It was written while the package was still named
-  `@uxfront/docs-theme` — a name that was never published — and it shipped in
-  `@uxfront/layer-docs@0.1.0`, the first release under the current name.

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 uxfront
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/app/app.vue

@@ -1,138 +0,0 @@
-<script setup lang="ts">
-import type { ContentNavigationItem, PageCollections } from "@nuxt/content";
-import * as nuxtUiLocales from "@nuxt/ui/locale";
-
-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((_: string, i: number) => i !== rootIdx)
-                .map((f: string) => `${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: string) =>
-                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>