kmcom-nuxt-layers 2.2.5 → 2.2.8

package/layers/routing/app/plugins/feature-flags.client.ts

@@ -4,15 +4,15 @@ import type { FeatureValue } from '../types/routing'
 export default defineNuxtPlugin({
   name: 'routing:feature-flags',
   async setup() {
-  const { config } = useRoutingConfig()
-  if (!config.runtimeFlags) return
+    const { config } = useRoutingConfig()
+    if (!config.runtimeFlags) return
 
-  const { runtimeFlags } = useFeatureFlags()
-  try {
-    const data = await $fetch<Record<string, FeatureValue>>('/api/feature-flags')
-    runtimeFlags.value = data
-  } catch (e) {
-    if (config.debug) console.warn('[routing] Failed to fetch feature flags', e)
-  }
+    const { runtimeFlags } = useFeatureFlags()
+    try {
+      const data = await $fetch<Record<string, FeatureValue>>('/api/feature-flags')
+      runtimeFlags.value = data
+    } catch (e) {
+      if (config.debug) console.warn('[routing] Failed to fetch feature flags', e)
+    }
   },
 })

package/layers/routing/app/types/app-config.d.ts

@@ -1,5 +1,7 @@
+import type { RoutingLayerConfig } from './routing'
+
 declare module '@nuxt/schema' {
   interface AppConfigInput {
-    routingLayer?: Partial<import('./routing').RoutingLayerConfig>
+    routingLayer?: Partial<RoutingLayerConfig>
   }
 }

package/layers/routing/app/types/index.ts

@@ -0,0 +1 @@
+export type * from './routing'

package/layers/routing/package.json

@@ -4,6 +4,7 @@
   "type": "module",
   "main": "./nuxt.config.ts",
   "scripts": {
-    "typecheck": "vue-tsc --noEmit -p ../../tsconfig.typecheck.json"
+    "typecheck": "vue-tsc --noEmit -p ../../tsconfig.typecheck.json",
+    "lint": "eslint ."
   }
 }

package/layers/scripts/app/composables/useGtm.ts

@@ -4,7 +4,7 @@ export function useGtm() {
 
   const gtmConfig = scriptsLayer?.gtm
   if (!gtmConfig?.enabled || !gtmConfig?.id) {
-    return { push: (_data: Record<string, unknown>) => {}, load: () => {} }
+    return { push: () => {}, load: () => {} }
   }
 
   // Load on Nuxt ready unless consent is required and not yet granted

package/layers/scripts/app/types/index.ts

@@ -0,0 +1 @@
+export type * from './scripts'

package/layers/scripts/app/types/scripts.ts

@@ -0,0 +1,14 @@
+export type LoadStrategy = 'onNuxtReady' | 'idle' | 'manual'
+
+export type ScriptLoaderOptions = {
+  src: string
+  key?: string
+  strategy?: LoadStrategy
+  crossorigin?: 'anonymous' | 'use-credentials'
+  integrity?: string
+}
+
+export type AnalyticsProxy = {
+  track: (event: string, params?: Record<string, unknown>) => void
+  load: () => void
+}

package/layers/scripts/package.json

@@ -6,7 +6,8 @@
   "scripts": {
     "dev": "nuxi dev",
     "dev:playground": "PLAYGROUND_LAYERS=core,scripts pnpm -F playground dev",
-    "typecheck": "vue-tsc --noEmit -p ../../tsconfig.typecheck.json"
+    "typecheck": "vue-tsc --noEmit -p ../../tsconfig.typecheck.json",
+    "lint": "eslint ."
   },
   "dependencies": {
     "@nuxt/scripts": "catalog:"

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

@@ -1,4 +1,6 @@
 <script setup lang="ts">
+  import type { ScrollTrigger as GSAPScrollTrigger } from 'gsap/ScrollTrigger'
+
   import { SCROLL_SCENE_KEY, type ScrollSceneContext } from '../../composables/useScrollSteps'
 
   const {
@@ -72,7 +74,7 @@
     unregisterStep,
   })
 
-  let st: { kill: () => void } | null = null
+  let st: GSAPScrollTrigger | null = null
 
   onMounted(() => {
     if (!containerRef.value) return

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

@@ -1,15 +1,8 @@
-import type { ComputedRef, Ref } from 'vue'
+import type { ScrollSceneContext } from '../types/scroll'
 
 export const SCROLL_SCENE_KEY = Symbol('motionScrollScene')
 
-export type ScrollSceneContext = {
-  progress: Ref<number>
-  active: Ref<boolean>
-  name: string
-  stepCount: ComputedRef<number>
-  registerStep: (index: number) => void
-  unregisterStep: (index: number) => void
-}
+export type { ScrollSceneContext }
 
 /**
  * Step/waypoint state tracking — must be used inside a MotionScrollScene.

package/layers/scroll/app/composables/useSectionProgress.ts

@@ -1,3 +1,4 @@
+import type { ScrollTrigger } from 'gsap/ScrollTrigger'
 import type { MaybeRef } from 'vue'
 
 type SectionProgressOptions = {
@@ -27,7 +28,7 @@ export function useSectionProgress(
   const entering = computed(() => active.value && direction.value > 0)
   const leaving = computed(() => active.value && direction.value < 0)
 
-  let st: { kill: () => void } | null = null
+  let st: ScrollTrigger | null = null
 
   onMounted(() => {
     const el = unref(trigger)

package/layers/scroll/app/plugins/locomotive-scroll.client.ts

@@ -1,78 +1,71 @@
 import { ScrollTrigger } from 'gsap/ScrollTrigger'
 import LocomotiveScroll from 'locomotive-scroll'
-
-export type ScrollState = {
-  scroll: number
-  limit: number
-  velocity: number
-  direction: number
-  progress: number
-}
+import type { ScrollState } from '../types/scroll'
 
 export default defineNuxtPlugin({
   name: 'scroll:locomotive-scroll',
   setup() {
-  const scrollState = reactive<ScrollState>({
-    scroll: 0,
-    limit: 0,
-    velocity: 0,
-    direction: 0,
-    progress: 0,
-  })
+    const scrollState = reactive<ScrollState>({
+      scroll: 0,
+      limit: 0,
+      velocity: 0,
+      direction: 0,
+      progress: 0,
+    })
 
-  const instance = shallowRef<LocomotiveScroll | null>(null)
+    const instance = shallowRef<LocomotiveScroll | null>(null)
 
-  function init() {
-    if (instance.value) return
-    instance.value = new LocomotiveScroll({
-      lenisOptions: {
-        lerp: 0.1,
-        smoothWheel: true,
-        wheelMultiplier: 1,
-      },
-      scrollCallback: ({ scroll, limit, velocity, direction, progress }) => {
-        scrollState.scroll = scroll
-        scrollState.limit = limit
-        scrollState.velocity = velocity
-        scrollState.direction = direction
-        scrollState.progress = progress
-        ScrollTrigger.update()
-      },
-    })
-  }
+    function init() {
+      if (instance.value) return
+      instance.value = new LocomotiveScroll({
+        lenisOptions: {
+          lerp: 0.1,
+          smoothWheel: true,
+          wheelMultiplier: 1,
+        },
+        scrollCallback: ({ scroll, limit, velocity, direction, progress }) => {
+          scrollState.scroll = scroll
+          scrollState.limit = limit
+          scrollState.velocity = velocity
+          scrollState.direction = direction
+          scrollState.progress = progress
+          ScrollTrigger.update()
+        },
+      })
+    }
 
-  function destroy() {
-    instance.value?.destroy()
-    instance.value = null
-  }
+    function destroy() {
+      instance.value?.destroy()
+      instance.value = null
+    }
 
-  const router = useRouter()
-  const appConfig = useAppConfig()
-  const smoothScroll: boolean | string[] = appConfig.scroll?.smoothScroll ?? true
+    const router = useRouter()
+    const appConfig = useAppConfig()
+    const smoothScroll: boolean | string[] = appConfig.scroll?.smoothScroll ?? true
 
-  const nuxtApp = useNuxtApp()
+    const nuxtApp = useNuxtApp()
 
-  if (smoothScroll === true) {
-    nuxtApp.hook('app:mounted', () => nextTick(init))
-    nuxtApp.hook('page:finish', () => nextTick(() => ScrollTrigger.refresh()))
-  } else if (Array.isArray(smoothScroll)) {
-    addRouteMiddleware((to, from) => {
-      if (smoothScroll.includes(to.path)) {
-        nextTick(init)
-      } else if (from?.path && smoothScroll.includes(from.path)) {
-        destroy()
-      }
-    })
-    if (smoothScroll.includes(router.currentRoute.value.path)) {
+    if (smoothScroll === true) {
       nuxtApp.hook('app:mounted', () => nextTick(init))
+      nuxtApp.hook('page:finish', () => nextTick(() => ScrollTrigger.refresh()))
+    } else if (Array.isArray(smoothScroll)) {
+      addRouteMiddleware((to, from) => {
+        if (smoothScroll.includes(to.path)) {
+          nextTick(init)
+        } else if (from?.path && smoothScroll.includes(from.path)) {
+          destroy()
+        }
+      })
+      if (smoothScroll.includes(router.currentRoute.value.path)) {
+        nuxtApp.hook('app:mounted', () => nextTick(init))
+      }
     }
-  }
 
-  return {
-    provide: {
-      locomotiveScroll: instance,
-      scrollState,
-    },
-  }
+    return {
+      provide: {
+        locomotiveScroll: instance,
+        scrollState,
+      },
+    }
   },
 })

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

@@ -0,0 +1 @@
+export type * from './scroll'

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

@@ -0,0 +1,32 @@
+import type { ComputedRef, Ref } from 'vue'
+
+export type ScrollToOptions = {
+  offset?: number
+  duration?: number
+  immediate?: boolean
+  lock?: boolean
+  onComplete?: () => void
+}
+
+export type SectionProgressOptions = {
+  start?: string
+  end?: string
+  markers?: boolean
+}
+
+export type ScrollSceneContext = {
+  progress: Ref<number>
+  active: Ref<boolean>
+  name: string
+  stepCount: ComputedRef<number>
+  registerStep: (index: number) => void
+  unregisterStep: (index: number) => void
+}
+
+export type ScrollState = {
+  scroll: number
+  limit: number
+  velocity: number
+  direction: number
+  progress: number
+}

package/layers/scroll/package.json

@@ -7,5 +7,8 @@
     "gsap": "catalog:",
     "locomotive-scroll": "catalog:",
     "v-gsap-nuxt": "catalog:"
+  },
+  "scripts": {
+    "lint": "eslint ."
   }
 }

package/layers/seo/package.json

@@ -6,7 +6,8 @@
   "scripts": {
     "dev": "nuxi dev",
     "dev:playground": "PLAYGROUND_LAYERS=core,seo pnpm -F playground dev",
-    "typecheck": "vue-tsc --noEmit -p ../../tsconfig.typecheck.json"
+    "typecheck": "vue-tsc --noEmit -p ../../tsconfig.typecheck.json",
+    "lint": "eslint ."
   },
   "dependencies": {
     "@nuxtjs/seo": "catalog:"

package/layers/shader/app/components/Material/Fresnel.client.vue

@@ -73,7 +73,7 @@
     // Mix colors based on fresnel using reactive uniforms
     const colorNode = mix(vec3(baseColorUniform), vec3(fresnelColorUniform), fresnelFactor)
 
-    mat.colorNode = colorNode as any
+    mat.colorNode = colorNode as TSLNode
     mat.transparent = transparent
     mat.side = DoubleSide
 

package/layers/shader/app/components/Material/Image.client.vue

@@ -146,7 +146,7 @@
         loadedTexture.value = await loader.loadAsync(src)
       } catch (e) {
         error.value = e as Error
-        console.error('Failed to load texture:', e)
+        void e
       } finally {
         isLoading.value = false
       }

package/layers/shader/app/components/Material/Node.client.vue

@@ -6,13 +6,13 @@
 
   const {
     type = 'basic',
-    colorNode,
-    opacityNode,
-    normalNode,
-    emissiveNode,
-    metalnessNode,
-    roughnessNode,
-    positionNode,
+    colorNode = undefined,
+    opacityNode = undefined,
+    normalNode = undefined,
+    emissiveNode = undefined,
+    metalnessNode = undefined,
+    roughnessNode = undefined,
+    positionNode = undefined,
     transparent = false,
     side = 'front',
     wireframe = false,

package/layers/shader/app/components/Material/Noise.client.vue

@@ -125,7 +125,7 @@
     // Mix colors based on noise using reactive uniforms
     const colorNode = mix(vec3(baseColorUniform), vec3(peakColorUniform), normalizedNoise)
 
-    mat.colorNode = colorNode as any
+    mat.colorNode = colorNode as TSLNode
     mat.transparent = transparent
     mat.side = DoubleSide
 

package/layers/shader/app/components/Node/Color.client.vue

@@ -4,38 +4,35 @@
 
   import type { TSLNode } from '../../shaders/types'
 
-  const props = withDefaults(
-    defineProps<{
-      id?: string
-      color?: string
-      order?: number
-      blend?: 'normal' | 'add' | 'multiply' | 'screen' | 'overlay' | 'mix'
-      opacity?: number
-    }>(),
-    {
-      id: 'color',
-      color: '#ffffff',
-      order: 0,
-      blend: 'normal',
-      opacity: 1.0,
-    }
-  )
+  const {
+    id = 'color',
+    color = '#ffffff',
+    order = 0,
+    blend = 'normal',
+    opacity = 1.0,
+  } = defineProps<{
+    id?: string
+    color?: string
+    order?: number
+    blend?: 'normal' | 'add' | 'multiply' | 'screen' | 'overlay' | 'mix'
+    opacity?: number
+  }>()
 
   const graph = useShaderGraphContext()
 
   // Create uniform once
-  const colorValue = new Color(props.color)
+  const colorValue = new Color(color)
   const colorNode: TSLNode = uniform(colorValue)
 
   // Build TSL node once (references uniform by pointer)
   const node = vec3(colorNode)
 
   // Register in graph
-  graph.register(props.id, node, props.order, props.blend, props.opacity)
+  graph.register(id, node, order, blend, opacity)
 
   // Watch props to update uniform value (no recompilation)
   watch(
-    () => props.color,
+    () => color,
     (hex) => {
       colorValue.set(hex)
       colorNode.value = colorValue
@@ -43,7 +40,7 @@
   )
 
   onUnmounted(() => {
-    graph.unregister(props.id)
+    graph.unregister(id)
   })
 </script>
 

package/layers/shader/app/components/Node/Noise.client.vue

@@ -8,34 +8,31 @@
   } from '#layers/shader/app/shaders/common/noise'
   import { add, mul, time, uniform, uv, vec2, vec3 } from 'three/tsl'
 
-  const props = withDefaults(
-    defineProps<{
-      id?: string
-      type?: 'simplex' | 'fbm' | 'voronoi' | 'ridged' | 'fbm3d'
-      scale?: number
-      speed?: number
-      octaves?: number
-      order?: number
-      blend?: 'normal' | 'add' | 'multiply' | 'screen' | 'overlay' | 'mix'
-      opacity?: number
-    }>(),
-    {
-      id: 'noise',
-      type: 'simplex',
-      scale: 3.0,
-      speed: 0.2,
-      octaves: 4,
-      order: 0,
-      blend: 'normal',
-      opacity: 1.0,
-    }
-  )
+  const {
+    id = 'noise',
+    type = 'simplex',
+    scale = 3.0,
+    speed = 0.2,
+    octaves = 4,
+    order = 0,
+    blend = 'normal',
+    opacity = 1.0,
+  } = defineProps<{
+    id?: string
+    type?: 'simplex' | 'fbm' | 'voronoi' | 'ridged' | 'fbm3d'
+    scale?: number
+    speed?: number
+    octaves?: number
+    order?: number
+    blend?: 'normal' | 'add' | 'multiply' | 'screen' | 'overlay' | 'mix'
+    opacity?: number
+  }>()
 
   const graph = useShaderGraphContext()
 
   // Create uniforms once
-  const uScale = uniform(props.scale)
-  const uSpeed = uniform(props.speed)
+  const uScale = uniform(scale)
+  const uSpeed = uniform(speed)
 
   // Build TSL node
   function buildNode() {
@@ -46,9 +43,9 @@
 
     let noiseValue
 
-    switch (props.type) {
+    switch (type) {
       case 'fbm':
-        noiseValue = fbm2D(animatedUV, { octaves: props.octaves, frequency: 1.0 }).mul(0.5).add(0.5)
+        noiseValue = fbm2D(animatedUV, { octaves, frequency: 1.0 }).mul(0.5).add(0.5)
         break
       case 'voronoi': {
         const { distance } = voronoi2D(animatedUV, 1.0)
@@ -56,10 +53,10 @@
         break
       }
       case 'ridged':
-        noiseValue = ridgedFbm2d(animatedUV, { octaves: props.octaves, frequency: 1.0 })
+        noiseValue = ridgedFbm2d(animatedUV, { octaves, frequency: 1.0 })
         break
       case 'fbm3d':
-        noiseValue = fbm3dSimplex(vec3(scaledUV, t), { octaves: props.octaves }).mul(0.5).add(0.5)
+        noiseValue = fbm3dSimplex(vec3(scaledUV, t), { octaves }).mul(0.5).add(0.5)
         break
       case 'simplex':
       default:
@@ -71,17 +68,17 @@
   }
 
   const node = buildNode()
-  graph.register(props.id, node, props.order, props.blend, props.opacity)
+  graph.register(id, node, order, blend, opacity)
 
   // Watch uniform-driven props (no recompilation)
   watch(
-    () => props.scale,
+    () => scale,
     (v) => {
       uScale.value = v
     }
   )
   watch(
-    () => props.speed,
+    () => speed,
     (v) => {
       uSpeed.value = v
     }
@@ -89,15 +86,15 @@
 
   // Watch topology-changing props (requires graph update)
   watch(
-    () => [props.type, props.octaves] as const,
+    () => [type, octaves] as const,
     () => {
       const newNode = buildNode()
-      graph.update(props.id, newNode)
+      graph.update(id, newNode)
     }
   )
 
   onUnmounted(() => {
-    graph.unregister(props.id)
+    graph.unregister(id)
   })
 </script>
 

package/layers/shader/app/components/Pipeline/Aurora.client.vue

@@ -1,8 +1,9 @@
 <script setup lang="ts">
-  import { Color, Vector3 } from 'three'
+  import { Color } from 'three'
   import { clamp, float, mix, time, uniform, vec2, vec4 } from 'three/tsl'
 
   import { fbm2D } from '../../shaders/common/noise'
+  import { hexToVec3Uniform } from '../../utils/tsl/color'
 
   /**
    * Aurora borealis — layered animated colour bands across the upper screen.
@@ -32,13 +33,8 @@
     order?: number
   }>()
 
-  function toVec3Node(hex: string) {
-    const c = new Color(hex)
-    return uniform(new Vector3(c.r, c.g, c.b))
-  }
-
-  const colorANode = toVec3Node(colorA)
-  const colorBNode = toVec3Node(colorB)
+  const colorANode = hexToVec3Uniform(colorA)
+  const colorBNode = hexToVec3Uniform(colorB)
   const bandYNode = uniform(bandY)
   const bandHNode = uniform(bandHeight)
   const speedNode = uniform(speed)

package/layers/shader/app/components/Pipeline/BilinearGradient.client.vue

@@ -1,6 +1,8 @@
 <script setup lang="ts">
-  import { Color, Vector3 } from 'three'
-  import { mix, uniform, vec4 } from 'three/tsl'
+  import { Color } from 'three'
+  import { mix, vec4 } from 'three/tsl'
+
+  import { hexToVec3Uniform } from '../../utils/tsl/color'
 
   const {
     bottomLeft = '#000000',
@@ -20,15 +22,10 @@
     order?: number
   }>()
 
-  function toVec3Node(hex: string) {
-    const c = new Color(hex)
-    return uniform(new Vector3(c.r, c.g, c.b))
-  }
-
-  const blNode = toVec3Node(bottomLeft)
-  const brNode = toVec3Node(bottomRight)
-  const tlNode = toVec3Node(topLeft)
-  const trNode = toVec3Node(topRight)
+  const blNode = hexToVec3Uniform(bottomLeft)
+  const brNode = hexToVec3Uniform(bottomRight)
+  const tlNode = hexToVec3Uniform(topLeft)
+  const trNode = hexToVec3Uniform(topRight)
   watch(
     () => bottomLeft,
     (v) => {

package/layers/shader/app/components/Pipeline/BillowNoise.client.vue

@@ -1,8 +1,9 @@
 <script setup lang="ts">
-  import { Color, Vector3 } from 'three'
+  import { Color } from 'three'
   import { float, mix, time, uniform, vec4 } from 'three/tsl'
 
   import { turbulence2D } from '../../shaders/common/noise'
+  import { hexToVec3Uniform } from '../../utils/tsl/color'
 
   /** Billow/turbulence noise — folded abs() of FBM, producing cloud-like forms. */
   const {
@@ -19,13 +20,8 @@
     order?: number
   }>()
 
-  function toVec3Node(hex: string) {
-    const c = new Color(hex)
-    return uniform(new Vector3(c.r, c.g, c.b))
-  }
-
-  const colorANode = toVec3Node(colorA)
-  const colorBNode = toVec3Node(colorB)
+  const colorANode = hexToVec3Uniform(colorA)
+  const colorBNode = hexToVec3Uniform(colorB)
   const scaleNode = uniform(scale)
   const speedNode = uniform(speed)
   watch(