feat(nuxt): add setLayout utility

docs/content/3.api/1.composables/use-layout.md

@@ -0,0 +1,15 @@
+# `useLayout`
+
+Within your pages, components, and plugins you can use useLayout to get access to data that resolves asynchronously.
+
+**Usage:**
+
+```vue
+<template>
+  <button @click="useLayout('default')"></button>
+</template>
+```
+
+## Params
+
+* **layout**: A `layout` name to ensure that `layout` can be set correctly.

packages/nuxt/src/app/composables/index.ts

@@ -2,6 +2,7 @@ export { defineNuxtComponent } from './component'
 export { useAsyncData, useLazyAsyncData, refreshNuxtData } from './asyncData'
 export type { AsyncDataOptions, AsyncData } from './asyncData'
 export { useHydration } from './hydrate'
+export { useLayout } from './layout'
 export { useState } from './state'
 export { clearError, createError, isNuxtError, throwError, showError, useError } from './error'
 export type { NuxtError } from './error'

packages/nuxt/src/app/composables/layout.ts

@@ -0,0 +1,6 @@
+import { useRoute } from '#app'
+
+export function useLayout (layout: string) {
+  const route = useRoute()
+  route.meta.layout = layout
+}

packages/nuxt/src/auto-imports/presets.ts

@@ -25,6 +25,7 @@ const appPreset = defineUnimportPreset({
     'useAsyncData',
     'useLazyAsyncData',
     'refreshNuxtData',
+    'useLayout',
     'defineNuxtComponent',
     'useNuxtApp',
     'defineNuxtPlugin',