kmcom-nuxt-layers 5.0.4 → 5.0.6

package/README.md

@@ -13,7 +13,7 @@ npm install kmcom-nuxt-layers
 export default defineNuxtConfig({
   extends: [
     'kmcom-nuxt-layers/layers/core',
-    'kmcom-nuxt-layers/layers/ui',
+    'kmcom-nuxt-layers/layers/typography',
     // add more layers as needed
   ]
 })
@@ -23,16 +23,16 @@ export default defineNuxtConfig({
 
 | Layer | Description |
 |-------|-------------|
-| **core** | Foundation — Nuxt UI, VueUse, Pinia, loading screen, error handling, scroll guard |
-| **ui** | Design system — typography, color, media, branding components |
-| **layout** | Page structure — grids, containers, spacing |
-| **motion** | Animations — GSAP, Locomotive Scroll |
-| **shader** | 3D / WebGPU — Three.js, TresJS |
-| **forms** | Validation — Zod-based form system |
-| **database** | Storage — Drizzle ORM + Neon Postgres |
-| **auth** | Authentication — nuxt-auth-utils + GitHub OAuth |
-| **theme** | Theming — color mode, accent colors |
+| **core** | Foundation — Nuxt UI, VueUse, Pinia, loading screen, error handling, Element primitives |
+| **theming** / **typography** / **visual** | Design system — accents, type, gradients, modals |
+| **layout** / **navigation** / **routing** | Structure — grids, stacks, nav components, feature flags |
 | **content** | CMS — @nuxt/content, Nuxt Studio |
+| **database** / **auth** / **metadata** / **mailer** / **forms** | Data — Drizzle + Neon, GitHub OAuth, metadata providers, Resend, Zod forms |
+| **scroll** / **animations** / **transitions** / **page-transitions** / **motion** | Motion — GSAP, Locomotive Scroll |
+| **canvas** / **shader** | Render — TresJS, WebGPU/TSL |
+| **seo** / **scripts** / **feeds** | Delivery — @nuxtjs/seo, @nuxt/scripts, RSS/Atom/JSON feeds |
+
+Upgrading from v2: `ui` → `typography` + `navigation` + `visual`, `theme` → `theming`, `starter` removed.
 
 All layers depend on `core`. Always list `core` first in `extends`.
 

package/docs/USAGE.md

@@ -10,106 +10,146 @@ npm install kmcom-nuxt-layers
 
 ## Basic Usage
 
-Add layers to the `extends` array in your `nuxt.config.ts`. Each layer is referenced by its filesystem path within the package:
+Add layers to the `extends` array in your `nuxt.config.ts`. Each layer is an entry in the package `exports` map:
 
 ```ts
 // nuxt.config.ts
 export default defineNuxtConfig({
-  extends: ['kmcom-nuxt-layers/layers/core', 'kmcom-nuxt-layers/layers/ui'],
+  extends: ['kmcom-nuxt-layers/layers/core', 'kmcom-nuxt-layers/layers/typography'],
 })
 ```
 
-Nuxt resolves each layer via the `package.json` → `"main": "./nuxt.config.ts"` entry. No import maps or special configuration needed.
+Every non-core layer declares its own `extends`, so you only list what you want. A misspelled or
+removed layer name is **not** an error: Nuxt only warns `Cannot extend config from ...` and the
+layer is silently skipped. Check the dev log for that warning after changing `extends`.
 
-## Available Layers
+## Requirements
+
+- `nuxt >= 4.6.1` (older 4.x resolves a mismatched `@nuxt/schema` and breaks Nitro config types).
+- `typescript.strict: true`. The layers' sources are pulled into your `vue-tsc` graph and are
+  written for strict mode.
+- If `@nuxtjs/seo` is enabled, pin `unhead` to a single version (pnpm `overrides`) so Nitro's
+  file trace includes `unhead/dist/legacy.mjs`.
+
+### Expected warning: `NUXT_B5023`
+
+On `nuxt dev`, `build` and `prepare` you will see one warning per layer:
+
+```
+WARN [NUXT_B5023] The config file .../layers/core/nuxt.config.ts was loaded through jiti
+because the runtime could not load it: Stripping types is currently unsupported for files
+under node_modules
+```
 
-| Layer       | Extends Path                       | Depends On | Required Dependencies                                                                 |
-| ----------- | ---------------------------------- | ---------- | ------------------------------------------------------------------------------------- |
-| **core**    | `kmcom-nuxt-layers/layers/core`    | —          | `nuxt`, `@nuxt/ui`, `pinia`, `@vueuse/nuxt`, `@nuxtjs/device`                         |
-| **ui**      | `kmcom-nuxt-layers/layers/ui`      | core       | —                                                                                     |
-| **layout**  | `kmcom-nuxt-layers/layers/layout`  | core       | —                                                                                     |
-| **motion**  | `kmcom-nuxt-layers/layers/motion`  | core       | `gsap`, `locomotive-scroll`                                                           |
-| **shader**  | `kmcom-nuxt-layers/layers/shader`  | core       | `three`, `@tresjs/nuxt`, `@tresjs/core`, `@tresjs/cientos`, `@tresjs/post-processing` |
-| **forms**   | `kmcom-nuxt-layers/layers/forms`   | core       | `zod`                                                                                 |
-| **theme**   | `kmcom-nuxt-layers/layers/theme`   | core       | —                                                                                     |
-| **content** | `kmcom-nuxt-layers/layers/content` | core       | `@nuxt/content`, `better-sqlite3`                                                     |
+This is expected and harmless. The layers ship `.ts` configs, Node refuses to strip types under
+`node_modules`, and Nuxt falls back to jiti. Nothing is broken; startup is slightly slower.
 
-## Layer Dependency Rules
+## Available Layers
 
-1. **Always include `core` first** — all other layers depend on it
-2. **Order matters** — list `core` before any layer that depends on it
-3. **Only include what you need** — each layer is independent (apart from the core dependency)
+| Layer                | Extends Path                                | Depends On                           |
+| -------------------- | ------------------------------------------- | ------------------------------------ |
+| **core**             | `kmcom-nuxt-layers/layers/core`             | —                                    |
+| **theming**          | `kmcom-nuxt-layers/layers/theming`          | core                                 |
+| **typography**       | `kmcom-nuxt-layers/layers/typography`       | core                                 |
+| **visual**           | `kmcom-nuxt-layers/layers/visual`           | core                                 |
+| **layout**           | `kmcom-nuxt-layers/layers/layout`           | core                                 |
+| **navigation**       | `kmcom-nuxt-layers/layers/navigation`       | core, scroll, layout, typography     |
+| **routing**          | `kmcom-nuxt-layers/layers/routing`          | core                                 |
+| **content**          | `kmcom-nuxt-layers/layers/content`          | core                                 |
+| **database**         | `kmcom-nuxt-layers/layers/database`         | core                                 |
+| **auth**             | `kmcom-nuxt-layers/layers/auth`             | core                                 |
+| **metadata**         | `kmcom-nuxt-layers/layers/metadata`         | core                                 |
+| **mailer**           | `kmcom-nuxt-layers/layers/mailer`           | core                                 |
+| **forms**            | `kmcom-nuxt-layers/layers/forms`            | mailer                               |
+| **scroll**           | `kmcom-nuxt-layers/layers/scroll`           | core                                 |
+| **animations**       | `kmcom-nuxt-layers/layers/animations`       | scroll                               |
+| **transitions**      | `kmcom-nuxt-layers/layers/transitions`      | core                                 |
+| **page-transitions** | `kmcom-nuxt-layers/layers/page-transitions` | core                                 |
+| **motion**           | `kmcom-nuxt-layers/layers/motion`           | scroll, animations, transitions, ... |
+| **canvas**           | `kmcom-nuxt-layers/layers/canvas`           | core                                 |
+| **shader**           | `kmcom-nuxt-layers/layers/shader`           | canvas                               |
+| **seo**              | `kmcom-nuxt-layers/layers/seo`              | core                                 |
+| **scripts**          | `kmcom-nuxt-layers/layers/scripts`          | core                                 |
+| **feeds**            | `kmcom-nuxt-layers/layers/feeds`            | core, content                        |
+
+Metadata providers: `kmcom-nuxt-layers/layers/metadata/providers/{comicvine,openlibrary,google-books,themoviedb}`.
+
+### Upgrading from v2
+
+| v2        | v5                                        |
+| --------- | ----------------------------------------- |
+| `ui`      | `typography` + `navigation` + `visual`    |
+| `theme`   | `theming`                                 |
+| `starter` | removed (now `apps/starter`, not a layer) |
 
 ## Layer-Specific Dependencies
 
 Install additional dependencies only for the layers you use:
 
 ```bash
-# Motion layer
+# motion / animations / scroll
 npm install gsap locomotive-scroll
 
-# Shader layer
+# canvas / shader
 npm install three @tresjs/nuxt @tresjs/core @tresjs/cientos @tresjs/post-processing
 
-# Forms layer
+# forms
 npm install zod
 
-# Content layer
+# content
 npm install @nuxt/content better-sqlite3
+
+# scripts (baseline-status badge)
+npm install @nuxt/scripts baseline-status
 ```
 
-## Configuration Examples
+## Content layer contract
 
-### Core + UI (design system)
+The `Blog`, `Portfolio` and `Gallery` components and the `useBlogPosts` / `useGalleryItems`
+composables are typed against collections named `blog`, `portfolio` and `gallery`. Define them in
+your app's `content.config.ts` (empty collections are fine):
 
 ```ts
-export default defineNuxtConfig({
-  extends: ['kmcom-nuxt-layers/layers/core', 'kmcom-nuxt-layers/layers/ui'],
+export default defineContentConfig({
+  collections: {
+    content: defineCollection({ type: 'page', source: '**/*.md' }),
+    blog: defineCollection({ type: 'page', source: 'blog/**/*.md' }),
+    portfolio: defineCollection({ type: 'page', source: 'portfolio/**/*.md' }),
+    gallery: defineCollection({ type: 'page', source: 'gallery/**/*.md' }),
+  },
 })
 ```
 
-### Core + UI + Layout (full page structure)
+Do not pass `schema:` to `defineCollection`; the layer's `collections.d.ts` augments the item types.
+
+## Configuration Examples
+
+### Design system
 
 ```ts
 export default defineNuxtConfig({
   extends: [
     'kmcom-nuxt-layers/layers/core',
-    'kmcom-nuxt-layers/layers/ui',
-    'kmcom-nuxt-layers/layers/layout',
+    'kmcom-nuxt-layers/layers/theming',
+    'kmcom-nuxt-layers/layers/typography',
+    'kmcom-nuxt-layers/layers/visual',
   ],
 })
 ```
 
-### Core + Motion (animations)
-
-```bash
-npm install gsap locomotive-scroll
-```
+### Page structure + navigation
 
 ```ts
 export default defineNuxtConfig({
-  extends: ['kmcom-nuxt-layers/layers/core', 'kmcom-nuxt-layers/layers/motion'],
+  extends: ['kmcom-nuxt-layers/layers/core', 'kmcom-nuxt-layers/layers/navigation'],
 })
 ```
 
-### Full Stack
-
-```bash
-npm install gsap locomotive-scroll three @tresjs/nuxt @tresjs/core @tresjs/cientos @tresjs/post-processing zod @nuxt/content better-sqlite3
-```
+### Motion
 
 ```ts
 export default defineNuxtConfig({
-  extends: [
-    'kmcom-nuxt-layers/layers/core',
-    'kmcom-nuxt-layers/layers/ui',
-    'kmcom-nuxt-layers/layers/layout',
-    'kmcom-nuxt-layers/layers/motion',
-    'kmcom-nuxt-layers/layers/shader',
-    'kmcom-nuxt-layers/layers/forms',
-    'kmcom-nuxt-layers/layers/theme',
-    'kmcom-nuxt-layers/layers/content',
-  ],
+  extends: ['kmcom-nuxt-layers/layers/core', 'kmcom-nuxt-layers/layers/motion'],
 })
 ```
 
@@ -138,7 +178,7 @@ export default defineAppConfig({
     },
   },
 
-  // Theme layer overrides
+  // Theming layer overrides
   themeLayer: {
     defaultAccent: 'indigo', // Change default accent color
     accents: ['blue', 'indigo', 'violet', 'purple'], // Limit palette
@@ -148,19 +188,19 @@ export default defineAppConfig({
 
 ### Available Config Namespaces
 
-| Namespace               | Layer  | Key Options                                                                |
-| ----------------------- | ------ | -------------------------------------------------------------------------- |
-| `coreLayer.loading`     | core   | `enabled`, `minDuration`, `maxDuration`, `background`, `textColor`         |
-| `coreLayer.scrollGuard` | core   | `enabled`, `strict`, `excludeSelectors`, `debug`                           |
-| `coreLayer.errors`      | core   | `logToConsole`, `logToExternal`, `externalUrl`                             |
-| `coreLayer.notFound`    | core   | `icon`, `title`, `description`, `showHomeButton`, `actions`, `suggestions` |
-| `motion`                | motion | `gsapScrollTrigger`, `lenis.*` (duration, smoothWheel, smoothTouch, etc.)  |
-| `themeLayer`            | theme  | `accents`, `defaultAccent`                                                 |
+| Namespace               | Layer   | Key Options                                                                |
+| ----------------------- | ------- | -------------------------------------------------------------------------- |
+| `coreLayer.loading`     | core    | `enabled`, `minDuration`, `maxDuration`, `background`, `textColor`         |
+| `coreLayer.scrollGuard` | core    | `enabled`, `strict`, `excludeSelectors`, `debug`                           |
+| `coreLayer.errors`      | core    | `logToConsole`, `logToExternal`, `externalUrl`                             |
+| `coreLayer.notFound`    | core    | `icon`, `title`, `description`, `showHomeButton`, `actions`, `suggestions` |
+| `motion`                | motion  | `gsapScrollTrigger`, `lenis.*` (duration, smoothWheel, smoothTouch, etc.)  |
+| `themeLayer`            | theming | `accents`, `defaultAccent`                                                 |
 
 ## Optional Modules
 
 Some modules used in the layers are optional or dev-only:
 
 - **`@nuxt/eslint`** — Loaded only in development (`NODE_ENV !== 'production'`). Install if you want layer-provided ESLint config during dev.
-- **`@vite-pwa/nuxt`** — Loaded only in production by the core layer. Install if you want PWA support.
+- **`@vite-pwa/nuxt`** — Currently disabled in the core layer (commented out). Add it to your own `modules` if you want PWA support; the layer does not type the `pwa` config key for you.
 - **`nuxt-studio`** — Optional peer dependency of the content layer. Install for Nuxt Studio CMS integration.

package/layers/content/nuxt.config.ts

@@ -33,6 +33,14 @@ export default defineNuxtConfig({
 
   css: ['#layers/content/app/assets/css/content.css'],
 
+  // Nuxt only references layer .d.ts files that live in generated .nuxt types, so register
+  // the @nuxt/content frontmatter augmentation explicitly for consumers.
+  hooks: {
+    'prepare:types': ({ references }) => {
+      references.push({ path: `${import.meta.dirname}/app/types/collections.d.ts` })
+    },
+  },
+
   compatibilityDate: '2026-01-24',
 
   typescript: {

package/layers/core/app/composables/useBrowser.ts

@@ -2,7 +2,7 @@ import {
   getBrowserVersionParts,
   isBrowserAtLeast,
   parseBrowserInfo,
-  type BrowserInfo,
+  type ParsedBrowserInfo,
 } from '#layers/core/app/utils/browserInfo'
 
 /**
@@ -16,7 +16,7 @@ import {
  * @returns Browser information and helper flags
  */
 export function useBrowser() {
-  const info = ref<BrowserInfo>(parseBrowserInfo())
+  const info = ref<ParsedBrowserInfo>(parseBrowserInfo())
 
   // Helper flags
   const isChrome = computed(() => info.value.name === 'chrome')

package/layers/core/app/utils/browserInfo.ts

@@ -1,4 +1,4 @@
-export type BrowserInfo = {
+export type ParsedBrowserInfo = {
   name: string
   version: string
   engine: string
@@ -7,14 +7,14 @@ export type BrowserInfo = {
 
 type BrowserRule = {
   match: (ua: string) => boolean
-  name: BrowserInfo['name']
-  engine: BrowserInfo['engine']
+  name: ParsedBrowserInfo['name']
+  engine: ParsedBrowserInfo['engine']
   version: (ua: string) => string
 }
 
 type OsRule = {
   match: (ua: string) => boolean
-  os: BrowserInfo['os']
+  os: ParsedBrowserInfo['os']
 }
 
 const OS_RULES: OsRule[] = [
@@ -58,11 +58,11 @@ const BROWSER_RULES: BrowserRule[] = [
   },
 ]
 
-function detectOs(ua: string): BrowserInfo['os'] {
+function detectOs(ua: string): ParsedBrowserInfo['os'] {
   return OS_RULES.find((rule) => rule.match(ua))?.os ?? 'unknown'
 }
 
-function detectBrowser(ua: string): Pick<BrowserInfo, 'name' | 'version' | 'engine'> {
+function detectBrowser(ua: string): Pick<ParsedBrowserInfo, 'name' | 'version' | 'engine'> {
   const rule = BROWSER_RULES.find((candidate) => candidate.match(ua))
   if (!rule) return { name: 'unknown', version: '0', engine: 'unknown' }
   return {
@@ -72,7 +72,7 @@ function detectBrowser(ua: string): Pick<BrowserInfo, 'name' | 'version' | 'engi
   }
 }
 
-export function parseBrowserInfo(userAgent?: string | null): BrowserInfo {
+export function parseBrowserInfo(userAgent?: string | null): ParsedBrowserInfo {
   if (!import.meta.client) {
     return {
       name: 'unknown',

package/layers/data/auth/server/routes/auth/github.get.ts

@@ -1,3 +1,5 @@
+import { sendRedirect } from 'h3'
+
 export default defineOAuthGitHubEventHandler({
   async onSuccess(event, { user }) {
     await setUserSession(event, {

package/layers/data/database/server/utils/drizzle.ts

@@ -1,3 +1,4 @@
+import { useSql } from './sql'
 import { drizzle } from 'drizzle-orm/neon-http'
 
 export function useDrizzle<TSchema extends Record<string, unknown>>(schema: TSchema) {

package/layers/data/database/server/utils/sql.ts

@@ -1,3 +1,5 @@
+import { createError } from 'h3'
+import { useRuntimeConfig } from 'nitropack/runtime'
 import { neon } from '@neondatabase/serverless'
 
 export function useSql() {

package/layers/data/forms/server/api/contact.post.ts

@@ -1,3 +1,4 @@
+import { createError, defineEventHandler, readBody } from 'h3'
 import { sendContactEmail } from '#layers/mailer/server/utils/email'
 import { mailerLayerHooks } from '#layers/mailer/server/utils/hooks'
 

package/layers/data/forms/server/api/forms/status.get.ts

@@ -1,3 +1,4 @@
+import { defineEventHandler } from 'h3'
 import { useMailerConfig } from '#layers/mailer/server/utils/config'
 
 export default defineEventHandler(() => {

package/layers/data/mailer/server/utils/config.ts

@@ -1,3 +1,5 @@
+import { useRuntimeConfig } from 'nitropack/runtime'
+
 type MailerLayerConfig = {
   resendApiKey: string
   emailFrom: string

package/layers/data/metadata/providers/comicvine/server/plugins/comicvine-register.ts

@@ -1,3 +1,7 @@
+import { registerProvider } from '#layers/metadata/server/utils/metadata/provider-registry'
+import { comicVineProvider } from '../utils/metadata-comicvine/provider'
+import { defineNitroPlugin } from 'nitropack/runtime'
+
 export default defineNitroPlugin(() => {
   registerProvider(comicVineProvider)
 })

package/layers/data/metadata/providers/comicvine/server/utils/metadata-comicvine/client.ts

@@ -1,3 +1,4 @@
+import { useRuntimeConfig } from 'nitropack/runtime'
 import type { ComicVineApiResponse, ComicVineIssue, ComicVineVolume } from './types'
 
 const FIELD_LIST_ISSUE =

package/layers/data/metadata/providers/comicvine/server/utils/metadata-comicvine/provider.ts

@@ -1,3 +1,10 @@
+import { normaliseComicVineIssue, normaliseComicVineVolume } from './normalise'
+import {
+  fetchComicVineIssue,
+  fetchComicVineVolume,
+  searchComicVineIssues,
+  searchComicVineVolumes,
+} from './client'
 import type { MetadataProvider } from '#layers/metadata/shared/types'
 
 import type { ComicVineIssue, ComicVineVolume } from './types'

package/layers/data/metadata/providers/google-books/server/plugins/google-books-register.ts

@@ -1,3 +1,7 @@
+import { registerProvider } from '#layers/metadata/server/utils/metadata/provider-registry'
+import { googleBooksProvider } from '../utils/metadata-google-books/provider'
+import { defineNitroPlugin } from 'nitropack/runtime'
+
 export default defineNitroPlugin(() => {
   registerProvider(googleBooksProvider)
 })

package/layers/data/metadata/providers/google-books/server/utils/metadata-google-books/client.ts

@@ -1,3 +1,4 @@
+import { useRuntimeConfig } from 'nitropack/runtime'
 import type { MetadataMediaType } from '#layers/metadata/shared/types'
 
 import type { GoogleBooksSearchResponse, GoogleBooksVolume } from './types'

package/layers/data/metadata/providers/google-books/server/utils/metadata-google-books/normalise.ts

@@ -1,3 +1,4 @@
+import { googleBooksCoverUrl, googleBooksMediaType } from './client'
 import type { MetadataCreator, MetadataRecord } from '#layers/metadata/shared/types'
 
 import type { GoogleBooksVolume, GoogleBooksVolumeInfo } from './types'

package/layers/data/metadata/providers/google-books/server/utils/metadata-google-books/provider.ts

@@ -1,3 +1,5 @@
+import { normaliseGoogleBooksVolume } from './normalise'
+import { fetchGoogleBooksVolume, searchGoogleBooks } from './client'
 import type { MetadataProvider } from '#layers/metadata/shared/types'
 
 export const googleBooksProvider: MetadataProvider = {

package/layers/data/metadata/providers/openlibrary/server/plugins/openlibrary-register.ts

@@ -1,3 +1,7 @@
+import { registerProvider } from '#layers/metadata/server/utils/metadata/provider-registry'
+import { openLibraryProvider } from '../utils/metadata-openlibrary/provider'
+import { defineNitroPlugin } from 'nitropack/runtime'
+
 export default defineNitroPlugin(() => {
   registerProvider(openLibraryProvider)
 })

package/layers/data/metadata/providers/openlibrary/server/utils/metadata-openlibrary/normalise.ts

@@ -1,3 +1,4 @@
+import { openLibraryCoverUrl } from './client'
 import type { MetadataCreator, MetadataRecord } from '#layers/metadata/shared/types'
 
 import type { OpenLibraryEdition, OpenLibrarySearchDoc, OpenLibraryWork } from './types'

package/layers/data/metadata/providers/openlibrary/server/utils/metadata-openlibrary/provider.ts

@@ -1,3 +1,9 @@
+import {
+  normaliseOpenLibraryEdition,
+  normaliseOpenLibrarySearchDoc,
+  normaliseOpenLibraryWork,
+} from './normalise'
+import { lookupOpenLibraryEdition, lookupOpenLibraryWork, searchOpenLibrary } from './client'
 import type { MetadataProvider } from '#layers/metadata/shared/types'
 
 export const openLibraryProvider: MetadataProvider = {

package/layers/data/metadata/providers/themoviedb/server/plugins/tmdb-register.ts

@@ -1,3 +1,7 @@
+import { registerProvider } from '#layers/metadata/server/utils/metadata/provider-registry'
+import { tmdbProvider } from '../utils/metadata-tmdb/provider'
+import { defineNitroPlugin } from 'nitropack/runtime'
+
 export default defineNitroPlugin(() => {
   registerProvider(tmdbProvider)
 })

package/layers/data/metadata/providers/themoviedb/server/utils/metadata-tmdb/client.ts

@@ -1,3 +1,4 @@
+import { useRuntimeConfig } from 'nitropack/runtime'
 import type { TMDBFindResponse, TMDBMovie, TMDBSearchResponse, TMDBTVShow } from './types'
 
 function getConfig() {

package/layers/data/metadata/providers/themoviedb/server/utils/metadata-tmdb/normalise.ts

@@ -1,3 +1,4 @@
+import { tmdbImageUrl } from './client'
 import type { MetadataCreator, MetadataRecord } from '#layers/metadata/shared/types'
 
 import type { TMDBMovie, TMDBSearchMultiResult, TMDBTVShow } from './types'

package/layers/data/metadata/providers/themoviedb/server/utils/metadata-tmdb/provider.ts

@@ -1,3 +1,5 @@
+import { normaliseTmdbMovie, normaliseTmdbSearchResult, normaliseTmdbTV } from './normalise'
+import { fetchTmdbMovie, fetchTmdbTV, findByImdbId, searchTmdb } from './client'
 import type { MetadataProvider } from '#layers/metadata/shared/types'
 
 export const tmdbProvider: MetadataProvider = {

package/layers/data/metadata/server/api/metadata/lookup.get.ts

@@ -1,3 +1,6 @@
+import { getCacheRecord, makeCacheKey, setCacheRecord } from '../../utils/metadata/cache'
+import { getProvider } from '../../utils/metadata/provider-registry'
+import { createError, defineEventHandler, getQuery } from 'h3'
 import type { MetadataProviderId } from '#layers/metadata/shared/types'
 
 // fallow-ignore-next-line complexity

package/layers/data/metadata/server/api/metadata/providers.get.ts

@@ -1,3 +1,6 @@
+import { getProviders } from '../../utils/metadata/provider-registry'
+import { defineEventHandler } from 'h3'
+
 export default defineEventHandler(() => {
   return getProviders().map((p) => ({
     id: p.id,

package/layers/data/metadata/server/api/metadata/search.get.ts

@@ -1,3 +1,5 @@
+import { searchMetadata } from '../../utils/metadata/search'
+import { createError, defineEventHandler, getQuery } from 'h3'
 import type { MetadataMediaType, MetadataProviderId } from '#layers/metadata/shared/types'
 
 // fallow-ignore-next-line complexity

package/layers/data/metadata/server/api/metadata/status.get.ts

@@ -1,3 +1,6 @@
+import { getProviders } from '../../utils/metadata/provider-registry'
+import { defineEventHandler } from 'h3'
+
 export default defineEventHandler(async () => {
   const providers = getProviders()
 

package/layers/data/metadata/server/api/metadata/sync.post.ts

@@ -1,3 +1,6 @@
+import { getCacheRecord, makeCacheKey, setCacheRecord } from '../../utils/metadata/cache'
+import { getProvider } from '../../utils/metadata/provider-registry'
+import { createError, defineEventHandler, readBody } from 'h3'
 import type { MetadataProviderId, MetadataSyncInput } from '#layers/metadata/shared/types'
 
 // fallow-ignore-next-line complexity

package/layers/data/metadata/server/utils/metadata/cache.ts

@@ -1,3 +1,4 @@
+import { useStorage } from 'nitropack/runtime'
 import type { MetadataCacheRecord } from '#layers/metadata/shared/types'
 
 // Cache keys: metadata:{provider}:{resourceType}:{providerId}

package/layers/data/metadata/server/utils/metadata/search.ts

@@ -1,3 +1,5 @@
+import { getSearchCache, hashQuery, makeCacheKey, setSearchCache } from './cache'
+import { getProviders } from './provider-registry'
 import type { MetadataSearchInput, MetadataSearchResult } from '#layers/metadata/shared/types'
 
 // fallow-ignore-next-line complexity

package/layers/delivery/feeds/server/routes/feed/[collection]/atom/all.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../../../utils/cache'
+import { toAtom } from '../../../../utils/formats/atom'
+import { defineEventHandler, getRouterParam, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const collection = getRouterParam(event, 'collection')
   const { items, config } = await buildFeed(event, collection, { unlimited: true })

package/layers/delivery/feeds/server/routes/feed/[collection]/atom.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../../utils/cache'
+import { toAtom } from '../../../utils/formats/atom'
+import { defineEventHandler, getRouterParam, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const collection = getRouterParam(event, 'collection')
   const { items, config } = await buildFeed(event, collection)

package/layers/delivery/feeds/server/routes/feed/[collection]/json/all.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../../../utils/cache'
+import { toJSONFeed } from '../../../../utils/formats/json'
+import { defineEventHandler, getRouterParam, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const collection = getRouterParam(event, 'collection')
   const { items, config } = await buildFeed(event, collection, { unlimited: true })

package/layers/delivery/feeds/server/routes/feed/[collection]/json.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../../utils/cache'
+import { toJSONFeed } from '../../../utils/formats/json'
+import { defineEventHandler, getRouterParam, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const collection = getRouterParam(event, 'collection')
   const { items, config } = await buildFeed(event, collection)

package/layers/delivery/feeds/server/routes/feed/[collection]/rss/all.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../../../utils/cache'
+import { toRSS } from '../../../../utils/formats/rss'
+import { defineEventHandler, getRouterParam, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const collection = getRouterParam(event, 'collection')
   const { items, config } = await buildFeed(event, collection, { unlimited: true })

package/layers/delivery/feeds/server/routes/feed/[collection]/rss.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../../utils/cache'
+import { toRSS } from '../../../utils/formats/rss'
+import { defineEventHandler, getRouterParam, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const collection = getRouterParam(event, 'collection')
   const { items, config } = await buildFeed(event, collection)

package/layers/delivery/feeds/server/routes/feed/atom/all.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../../utils/cache'
+import { toAtom } from '../../../utils/formats/atom'
+import { defineEventHandler, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const { items, config } = await buildFeed(event, undefined, { unlimited: true })
   const content = toAtom(items, config)

package/layers/delivery/feeds/server/routes/feed/atom.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../utils/cache'
+import { toAtom } from '../../utils/formats/atom'
+import { defineEventHandler, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const { items, config } = await buildFeed(event)
   const content = toAtom(items, config)

package/layers/delivery/feeds/server/routes/feed/demo.get.ts

@@ -1,3 +1,7 @@
+import { buildFeed } from '../../utils/feed-service'
+import { defineEventHandler, getRequestURL, setHeader } from 'h3'
+import { useAppConfig } from 'nitropack/runtime'
+
 const RSS_ICON = `<svg viewBox="0 0 16 16" fill="currentColor" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
         <path d="M2.5 3a.5.5 0 0 1 .5-.5h1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5H3a.5.5 0 0 1-.5-.5V3Z"/>
         <path d="M4 8a6 6 0 0 1 6 6H8.5A4.5 4.5 0 0 0 4 9.5V8Z"/>

package/layers/delivery/feeds/server/routes/feed/index.get.ts

@@ -1,3 +1,5 @@
+import { defineEventHandler, sendRedirect } from 'h3'
+
 export default defineEventHandler((event) => {
   return sendRedirect(event, '/feed/rss', 302)
 })

package/layers/delivery/feeds/server/routes/feed/json/all.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../../utils/cache'
+import { toJSONFeed } from '../../../utils/formats/json'
+import { defineEventHandler, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const { items, config } = await buildFeed(event, undefined, { unlimited: true })
   const content = toJSONFeed(items, config)

package/layers/delivery/feeds/server/routes/feed/json.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../utils/cache'
+import { toJSONFeed } from '../../utils/formats/json'
+import { defineEventHandler, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const { items, config } = await buildFeed(event)
   const body = toJSONFeed(items, config)

package/layers/delivery/feeds/server/routes/feed/rss/all.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../../utils/cache'
+import { toRSS } from '../../../utils/formats/rss'
+import { defineEventHandler, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const { items, config } = await buildFeed(event, undefined, { unlimited: true })
   const content = toRSS(items, config)

package/layers/delivery/feeds/server/routes/feed/rss.get.ts

@@ -1,3 +1,8 @@
+import { buildFeed } from '../../utils/feed-service'
+import { setFeedCacheHeaders } from '../../utils/cache'
+import { toRSS } from '../../utils/formats/rss'
+import { defineEventHandler, setHeader } from 'h3'
+
 export default defineEventHandler(async (event) => {
   const { items, config } = await buildFeed(event)
   const content = toRSS(items, config)

package/layers/delivery/feeds/server/routes/feed/style.xsl.get.ts

@@ -1,3 +1,5 @@
+import { defineEventHandler, setHeader } from 'h3'
+
 export default defineEventHandler((event) => {
   setHeader(event, 'Content-Type', 'text/xsl; charset=utf-8')
   setHeader(event, 'Cache-Control', 'public, max-age=3600')

package/layers/delivery/feeds/server/utils/cache.ts

@@ -1,5 +1,5 @@
+import { setHeader, type H3Event } from 'h3'
 import { createHash } from 'node:crypto'
-import type { H3Event } from 'h3'
 
 export function setFeedCacheHeaders(event: H3Event, content: string): void {
   const etag = `"${createHash('md5').update(content).digest('hex')}"`

package/layers/delivery/feeds/server/utils/content-adapter.ts

@@ -1,5 +1,5 @@
+import { createError, type H3Event } from 'h3'
 import { queryCollection } from '@nuxt/content/nitro'
-import type { H3Event } from 'h3'
 
 import { resolveFeedAuthor, resolveFeedDate } from './feed-author'
 import type { FeedItem } from './types'

package/layers/delivery/feeds/server/utils/feed-service.ts

@@ -1,4 +1,6 @@
-import type { H3Event } from 'h3'
+import { getContentFeedItems } from './content-adapter'
+import { getRequestURL, type H3Event } from 'h3'
+import { useAppConfig } from 'nitropack/runtime'
 
 import {
   createFeedConfig,

package/layers/design-system/visual/app/types/index.ts

@@ -2,5 +2,3 @@ export type * from './accent'
 export type * from './breakpoints'
 export type * from './gradient'
 export type * from './media'
-export type { TintLevel, TintColorSlot, TintConfig } from './tint'
-export { TINT_LEVEL_OPACITY } from './tint'

package/layers/motion/scroll/app/components/Motion/ScrollScene.vue

@@ -1,7 +1,8 @@
 <script setup lang="ts">
   import type { ScrollTrigger as GSAPScrollTrigger } from 'gsap/ScrollTrigger'
 
-  import { SCROLL_SCENE_KEY, type ScrollSceneContext } from '../../composables/useScrollSteps'
+  import type { ScrollSceneContext } from '../../types/scroll'
+  import { SCROLL_SCENE_KEY } from '../../composables/useScrollSteps'
 
   const {
     name,

package/layers/motion/scroll/app/components/Motion/ScrollStep.vue

@@ -1,5 +1,6 @@
 <script setup lang="ts">
-  import { SCROLL_SCENE_KEY, type ScrollSceneContext } from '../../composables/useScrollSteps'
+  import type { ScrollSceneContext } from '../../types/scroll'
+  import { SCROLL_SCENE_KEY } from '../../composables/useScrollSteps'
 
   const { index } = defineProps<{
     /**

package/layers/motion/scroll/app/composables/useScrollSteps.ts

@@ -2,8 +2,6 @@ import type { ScrollSceneContext } from '../types/scroll'
 
 export const SCROLL_SCENE_KEY = Symbol('motionScrollScene')
 
-export type { ScrollSceneContext }
-
 /**
  * Step/waypoint state tracking — must be used inside a MotionScrollScene.
  *

package/layers/motion/scroll/app/composables/useSmoothScroll.ts

@@ -1,12 +1,8 @@
 import type { Ref } from 'vue'
 import type LocomotiveScroll from 'locomotive-scroll'
 
-import {
-  runLocomotiveScroll,
-  runNativeScroll,
-  type ScrollTarget,
-  type ScrollToOptions,
-} from '../utils/scroll'
+import { runLocomotiveScroll, runNativeScroll, type ScrollTarget } from '../utils/scroll'
+import type { ScrollToOptions } from '../types/scroll'
 
 /**
  * Unified scroll composable using Locomotive Scroll v5 smooth scrolling

package/layers/motion/scroll/app/types/scroll.ts

@@ -1,11 +1,11 @@
 import type { ComputedRef, Ref } from 'vue'
 
 export type ScrollToOptions = {
-  offset?: number
-  duration?: number
-  immediate?: boolean
-  lock?: boolean
-  onComplete?: () => void
+  offset?: number | undefined
+  duration?: number | undefined
+  immediate?: boolean | undefined
+  lock?: boolean | undefined
+  onComplete?: (() => void) | undefined
 }
 
 export type SectionProgressOptions = {

package/layers/motion/scroll/app/utils/scroll.ts

@@ -1,14 +1,8 @@
 import type LocomotiveScroll from 'locomotive-scroll'
 
-export type ScrollTarget = string | number | HTMLElement
+import type { ScrollToOptions } from '../types/scroll'
 
-export type ScrollToOptions = {
-  offset?: number | undefined
-  duration?: number | undefined
-  immediate?: boolean | undefined
-  lock?: boolean | undefined
-  onComplete?: (() => void) | undefined
-}
+export type ScrollTarget = string | number | HTMLElement
 
 function resolveScrollOffset(options?: ScrollToOptions) {
   return options?.offset ?? 0

package/layers/render/shader/app/types/index.ts

@@ -1,4 +1,4 @@
 export type * from './tsl'
 export type * from './uniforms'
 export type * from './materials'
-export * from '#layers/canvas/types/renderer'
+export * from '../../../canvas/app/types/renderer'

package/layers/render/shader/app/types/renderer.ts

@@ -1 +1 @@
-export * from '#layers/canvas/types/renderer'
+export * from '../../../canvas/app/types/renderer'

package/layers/structure/routing/server/api/feature-flags.get.ts

@@ -1,3 +1,5 @@
+import { defineEventHandler } from 'h3'
+import { useAppConfig } from 'nitropack/runtime'
 import type { FeatureValue } from '../../app/types/routing'
 
 export default defineEventHandler(() => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kmcom-nuxt-layers",
   "private": false,
-  "version": "5.0.4",
+  "version": "5.0.6",
   "description": "Composable Nuxt 4 layers for building scalable Vue applications",
   "exports": {
     "./layers/core": "./layers/core/nuxt.config.ts",
@@ -84,10 +84,11 @@
     "@tresjs/post-processing": "^3.7.2",
     "@vite-pwa/nuxt": "^1.1.1",
     "@vueuse/nuxt": "^14.3.0 || ^15.0.0",
+    "baseline-status": "^1.1.1",
     "better-sqlite3": "^12.10.0 || ^13.0.0",
     "gsap": "^3.15.0",
     "locomotive-scroll": "^5.0.1",
-    "nuxt": "^4.4.7",
+    "nuxt": "^4.6.1",
     "pinia": "^3.0.4 || ^4.1.0",
     "tailwindcss": "^4.3.0",
     "three": ">=0.184.0",
@@ -145,6 +146,9 @@
     },
     "v-gsap-nuxt": {
       "optional": true
+    },
+    "baseline-status": {
+      "optional": true
     }
   },
   "devDependencies": {