From c94fbea3d0f3b5e975d43c945e4202eacefc6a02 Mon Sep 17 00:00:00 2001
From: rdunk <rupert@rupertdunk.com>
Date: Fri, 2 Feb 2024 17:56:13 +0000
Subject: [PATCH 01/15] feat: support visual editing

---
 index.d.ts                                   |  55 ++-
 package.json                                 |   3 +
 playground/cms/sanity.config.ts              |  14 +-
 playground/nuxt.config.js                    |   7 +
 playground/pages/index.vue                   |  49 +--
 playground/pages/movie/[slug].vue            |  15 +-
 pnpm-lock.yaml                               |  88 +++--
 src/module.ts                                | 257 +++++++++++--
 src/runtime/client.ts                        |   1 -
 src/runtime/composables.ts                   |  18 +-
 src/runtime/nitro-imports.ts                 |  15 +-
 src/runtime/plugin.ts                        |   2 +-
 src/runtime/visual-editing/composables.ts    | 358 +++++++++++++++++++
 src/runtime/visual-editing/draft/disable.ts  |   6 +
 src/runtime/visual-editing/draft/enable.ts   |  32 ++
 src/runtime/visual-editing/plugins/client.ts |   6 +
 src/runtime/visual-editing/plugins/server.ts |  21 ++
 src/types/client.ts                          |   3 +
 18 files changed, 858 insertions(+), 92 deletions(-)
 create mode 100644 src/runtime/visual-editing/composables.ts
 create mode 100644 src/runtime/visual-editing/draft/disable.ts
 create mode 100644 src/runtime/visual-editing/draft/enable.ts
 create mode 100644 src/runtime/visual-editing/plugins/client.ts
 create mode 100644 src/runtime/visual-editing/plugins/server.ts
 create mode 100644 src/types/client.ts

diff --git a/index.d.ts b/index.d.ts
index 893e6340..6c094815 100644
--- a/index.d.ts
+++ b/index.d.ts
@@ -1,7 +1,60 @@
-import { SanityHelper } from './src/runtime/composables'
+import type { ClientPerspective, StegaConfig } from '@sanity/client'
+import type { SanityHelper } from '#sanity-composables'
+
+type nullish = null | undefined | void
 
 declare module '#app' {
   interface NuxtApp {
     _sanity?: Record<string, SanityHelper>
   }
 }
+
+declare module 'nuxt/schema' {
+  interface RuntimeConfig {
+    sanity: {
+      visualEditing:
+        | {
+            draftMode:
+              | false
+              | {
+                  enable: string
+                  disable: string
+                }
+            mode: 'global' | 'component'
+            studioUrl: string
+            draftModeId: string
+            token: string
+          }
+        | undefined
+    }
+  }
+
+  interface PublicRuntimeConfig {
+    sanity: {
+      additionalClients: Record<string, any>
+      apiVersion: string
+      dataset: string
+      disableSmartCdn: boolean
+      perspective: ClientPerspective
+      projectId: string
+      stega: StegaConfig
+      token: string
+      useCdn: boolean
+      visualEditing:
+        | {
+            draftMode:
+              | false
+              | {
+                  enable: string
+                  disable: string
+                }
+            mode: 'global' | 'component'
+            studioUrl: string
+          }
+        | nullish
+    }
+    withCredentials: boolean
+  }
+}
+
+export {}
diff --git a/package.json b/package.json
index 7163db04..a0878b9c 100755
--- a/package.json
+++ b/package.json
@@ -49,6 +49,9 @@
   "dependencies": {
     "@nuxt/kit": "^3.9.0",
     "@portabletext/types": "^2.0.8",
+    "@sanity/core-loader": "^1.4.0",
+    "@sanity/overlays": "^2.3.9",
+    "@sanity/preview-url-secret": "^1.6.0",
     "chalk": "^5.3.0",
     "defu": "^6.1.3",
     "knitwork": "^1.0.0",
diff --git a/playground/cms/sanity.config.ts b/playground/cms/sanity.config.ts
index 69df8204..a2b3fdd6 100644
--- a/playground/cms/sanity.config.ts
+++ b/playground/cms/sanity.config.ts
@@ -1,7 +1,9 @@
-import { createConfig } from 'sanity'
 import { deskTool } from 'sanity/desk'
+import { presentationTool } from 'sanity/presentation'
+import { createConfig } from 'sanity'
 import { visionTool } from '@sanity/vision'
 import { schemaTypes } from './schemas'
+import { debugSecrets } from '@sanity/preview-url-secret/sanity-plugin-debug-secrets'
 
 export default createConfig({
   name: 'default',
@@ -12,6 +14,16 @@ export default createConfig({
   plugins: [
     deskTool(),
     visionTool(),
+    presentationTool({
+      previewUrl: {
+        origin: 'http://localhost:3000',
+        draftMode: {
+          enable: '/draft/enable',
+          disable: '/draft/disable',
+        },
+      },
+    }),
+    debugSecrets(),
   ],
 
   schema: {
diff --git a/playground/nuxt.config.js b/playground/nuxt.config.js
index 52dc8882..da6ff4f0 100644
--- a/playground/nuxt.config.js
+++ b/playground/nuxt.config.js
@@ -9,8 +9,15 @@ export default defineNuxtConfig({
     globalHelper: true,
     projectId: 'j1o4tmjp',
     dataset: 'production',
+    apiVersion: '2021-03-25',
     additionalClients: {
       another: {},
     },
+    visualEditing: {
+      stega: true,
+      draftMode: true,
+      token: process.env.NUXT_SANITY_VISUAL_EDITING_TOKEN,
+      studioUrl: 'http://localhost:3333',
+    },
   },
 })
diff --git a/playground/pages/index.vue b/playground/pages/index.vue
index fef5a34b..7ede7840 100644
--- a/playground/pages/index.vue
+++ b/playground/pages/index.vue
@@ -1,27 +1,30 @@
 <template>
-  <div
-    class="bg-gray-300 grid grid-flow-col grid-rows-3 p-8 overflow-x-hidden min-h-screen"
-  >
-    <h2>Project ID: {{ $sanity.config.projectId }}</h2>
-    <NuxtLink
-      v-for="{ title, poster, slug } in movies"
-      :key="title"
-      :to="`/movie/${slug}`"
-      class="flex w-64 h-48 relative justify-start"
+  <div>
+    <div
+      class="bg-gray-300 grid grid-flow-col grid-rows-3 p-8 overflow-x-hidden min-h-screen"
     >
-      <div
-        class="py-2 px-4 left-0 bottom-0 mb-4 flex-grow absolute bg-gray-100 rounded shadow-md font-semibold text-gray-800"
+      <h2>Project ID: {{ $sanity.config.projectId }}</h2>
+      <NuxtLink
+        v-for="({ title, poster, slug }, i) in movies"
+        :key="title"
+        :to="`/movie/${slug}`"
+        class="flex w-64 h-48 relative justify-start"
       >
-        {{ title }}
-      </div>
+        <div
+          class="py-2 px-4 left-0 bottom-0 mb-4 flex-grow absolute bg-gray-100 rounded shadow-md font-semibold text-gray-800"
+          :data-sanity="encodeDataAttribute?.([i, 'title'])"
+        >
+          {{ title }}
+        </div>
 
-      <SanityImage
-        class="object-contain w-48"
-        :asset-id="poster"
-        w="128"
-        auto="format"
-      />
-    </NuxtLink>
+        <SanityImage
+          class="object-contain w-48"
+          :asset-id="poster"
+          w="128"
+          auto="format"
+        />
+      </NuxtLink>
+    </div>
   </div>
 </template>
 
@@ -38,7 +41,7 @@ interface QueryResult {
   slug: string
 }
 
-const sanity = useSanity()
-
-const { data: movies } = await useAsyncData<QueryResult[]>('movies', () => sanity.fetch(query))
+const { data: movies, encodeDataAttribute } = await useSanityQuery<
+  QueryResult[]
+>(query)
 </script>
diff --git a/playground/pages/movie/[slug].vue b/playground/pages/movie/[slug].vue
index 90c6b96d..fd6fc1c3 100644
--- a/playground/pages/movie/[slug].vue
+++ b/playground/pages/movie/[slug].vue
@@ -1,7 +1,9 @@
 <template>
   <div class="p-4">
     <template v-if="details">
-      <p><strong>Title</strong>: {{ details.title }}</p>
+      <p :data-sanity="encodeDataAttribute?.(['title'])">
+        <strong>Title</strong>: {{ details.title }}
+      </p>
       <p>
         <strong>Release date</strong>:
         {{
@@ -24,7 +26,9 @@
         project-id="j1o4tmjp"
         asset-id="image-e22a88d23751a84df81f03ef287ae85fc992fe12-780x1170-jpg"
       />
-      <SanityContent :blocks="details.overview" />
+      <div :data-sanity="encodeDataAttribute?.(['overview'])">
+        <SanityContent :blocks="details.overview" />
+      </div>
     </template>
     <template v-else>
       Loading ...
@@ -56,7 +60,8 @@ interface QueryResult {
 }
 
 const route = useRoute()
-const { data: details } = await useSanityQuery<QueryResult>(query, {
-  slug: route.params.slug,
-})
+const { data: details, encodeDataAttribute } =
+  await useSanityQuery<QueryResult>(query, {
+    slug: route.params.slug,
+  })
 </script>
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 18263f03..d0765df4 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -19,6 +19,15 @@ importers:
       '@portabletext/types':
         specifier: ^2.0.8
         version: 2.0.8
+      '@sanity/core-loader':
+        specifier: ^1.4.0
+        version: 1.4.0(@sanity/client@6.12.3)
+      '@sanity/overlays':
+        specifier: ^2.3.9
+        version: 2.3.9
+      '@sanity/preview-url-secret':
+        specifier: ^1.6.0
+        version: 1.6.0(@sanity/client@6.12.3)
       chalk:
         specifier: ^5.3.0
         version: 5.3.0
@@ -2686,8 +2695,8 @@ packages:
       - supports-color
     dev: false
 
-  /@sanity/client@6.10.0:
-    resolution: {integrity: sha512-TavtxGB6NWjro2BTGXSkzXNMKFZbS2il1ItV3IdRvO0luLqS31eIz37+5X4CmCC8hGFe6fDoCjnH/iJ81vKM7g==}
+  /@sanity/client@6.11.2:
+    resolution: {integrity: sha512-loJF1MxnRgFL/vq7EPg/zhttzAy8Ka71Ip0zge1ksmzUt3PeEN27ZCnkYj8O7Mt1x9qALbdj+owXWqcNEF/lIA==}
     engines: {node: '>=14.18'}
     dependencies:
       '@sanity/eventsource': 5.0.1
@@ -2713,6 +2722,16 @@ packages:
     resolution: {integrity: sha512-Mk7FRDtxz/U2SRlRM0BvUI62jU26W62aYsipaKFt/dk0rOyYa9yzfaojSM/QmW0E4W/nOw74RBA/HrapXUw+2Q==}
     engines: {node: '>=18.0.0'}
 
+  /@sanity/core-loader@1.4.0(@sanity/client@6.12.3):
+    resolution: {integrity: sha512-NSjFFaeYeDX03Dj/ltOgh4SqKsemVWEMHCHQuzbwvmkjGJCmXAFpD3vbq6Ys1eAvBl/SMZeP2Kbzsmv41q9+Ig==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      '@sanity/client': ^6.12.3
+    dependencies:
+      '@sanity/client': 6.12.3
+      async-cache-dedupe: 2.0.0
+    dev: false
+
   /@sanity/diff-match-patch@3.1.1:
     resolution: {integrity: sha512-dSZqGeYjHKGIkqAzGqLcG92LZyJGX+nYbs/FWawhBbTBDWi21kvQ0hsL3DJThuFVWtZMWTQijN3z6Cnd44Pf2g==}
     engines: {node: '>=14.18'}
@@ -2753,13 +2772,13 @@ packages:
     resolution: {integrity: sha512-wtMYcV5GIDIhVyF/jjmdwq1GdlK07dRL40XMns73VbrFI7FteRltxv48bhYVZPcLkRXb0SHjpDS/icj9/yzbVA==}
     dev: false
 
-  /@sanity/groq-store@5.3.7(@sanity/client@6.10.0):
+  /@sanity/groq-store@5.3.7(@sanity/client@6.11.2):
     resolution: {integrity: sha512-wrAr7PKfbdRvfiC5m7unjH4x5XGZV+vMkk/CwrdHRs+39kuWWJvkwhVNRTS6iWTrTMgpMIe/H1kRrkle0PieDQ==}
     engines: {node: '>=18'}
     peerDependencies:
       '@sanity/client': ^6.10.0
     dependencies:
-      '@sanity/client': 6.10.0
+      '@sanity/client': 6.11.2
       mnemonist: 0.39.6
     dev: false
 
@@ -2824,6 +2843,17 @@ packages:
       - supports-color
     dev: false
 
+  /@sanity/overlays@2.3.9:
+    resolution: {integrity: sha512-GmZAgB1gCcUcXtAHc7sm2d4m50MGNvj7YpUwdd4xum4pRUQtRs5braw85wqddPh26rgAJ+IGLdhNs8xz9sqaNg==}
+    engines: {node: '>=16.14'}
+    dependencies:
+      '@vercel/stega': 0.1.0
+      react: 18.2.0
+      react-dom: 18.2.0(react@18.2.0)
+      react-is: 18.2.0
+      scroll-into-view-if-needed: 3.1.0
+    dev: false
+
   /@sanity/portable-text-editor@3.23.4(react-dom@18.2.0)(react@18.2.0)(rxjs@7.8.1)(styled-components@6.1.6):
     resolution: {integrity: sha512-mWJ3VFOtJIu7n4ptXeENZOcIT/UPkYlErymEGRKAOtYmswc6/lHvfx+QX/PN0E9zcIgGhcgT8/4OH9tkewY7IA==}
     engines: {node: '>=18'}
@@ -2849,7 +2879,7 @@ packages:
       - supports-color
     dev: false
 
-  /@sanity/presentation@1.4.0(@sanity/client@6.10.0)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(sanity@3.23.4)(styled-components@6.1.6):
+  /@sanity/presentation@1.4.0(@sanity/client@6.11.2)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(sanity@3.23.4)(styled-components@6.1.6):
     resolution: {integrity: sha512-BDT7I7kfWuwqnOl34p0ytyUFrA+0/WT1zm0daSe0g8X8nKi++7HCa2fEbbRy49EG4tkrvWz14/aEtmiOImvMDw==}
     engines: {node: '>=16.14'}
     peerDependencies:
@@ -2868,10 +2898,10 @@ packages:
       styled-components:
         optional: true
     dependencies:
-      '@sanity/client': 6.10.0
-      '@sanity/groq-store': 5.3.7(@sanity/client@6.10.0)
+      '@sanity/client': 6.11.2
+      '@sanity/groq-store': 5.3.7(@sanity/client@6.11.2)
       '@sanity/icons': 2.8.0(react@18.2.0)
-      '@sanity/preview-url-secret': 1.4.1(@sanity/client@6.10.0)(@sanity/icons@2.8.0)(sanity@3.23.4)
+      '@sanity/preview-url-secret': 1.6.0(@sanity/client@6.11.2)
       '@sanity/ui': 2.0.0-beta.13(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6)
       '@types/lodash.isequal': 4.5.8
       framer-motion: 10.16.16(react-dom@18.2.0)(react@18.2.0)
@@ -2887,25 +2917,27 @@ packages:
       - react-is
     dev: false
 
-  /@sanity/preview-url-secret@1.4.1(@sanity/client@6.10.0)(@sanity/icons@2.8.0)(sanity@3.23.4):
-    resolution: {integrity: sha512-EkV90NPBrMFc4YTKQsC3iMM8cw6Rs4ttVyfs2ou5ZKsKnU8bsr1hE/X9UB7nEXKc1h/qCXHVn8oKZ7uFdeI1DA==}
+  /@sanity/preview-url-secret@1.6.0(@sanity/client@6.11.2):
+    resolution: {integrity: sha512-0XCX16w3f/3maxK4RwYY5s7hLXHrDsJeaJFXc2nETxhyG6DUEt5CLyo4mpr6JZ+o31b7crqdgJ11Zd9nVChm+w==}
     engines: {node: '>=18'}
     peerDependencies:
-      '@sanity/client': ^6.10.0
-      '@sanity/icons': ^2.8.0
-      sanity: ^3.23.4
-    peerDependenciesMeta:
-      '@sanity/icons':
-        optional: true
-      sanity:
-        optional: true
+      '@sanity/client': ^6.12.3
     dependencies:
-      '@sanity/client': 6.10.0
-      '@sanity/icons': 2.8.0(react@18.2.0)
+      '@sanity/client': 6.11.2
       '@sanity/uuid': 3.0.2
       sanity: 3.23.4(@types/react@18.2.61)(react-dom@18.2.0)(react@18.2.0)(styled-components@6.1.6)
     dev: false
 
+  /@sanity/preview-url-secret@1.6.0(@sanity/client@6.12.3):
+    resolution: {integrity: sha512-0XCX16w3f/3maxK4RwYY5s7hLXHrDsJeaJFXc2nETxhyG6DUEt5CLyo4mpr6JZ+o31b7crqdgJ11Zd9nVChm+w==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      '@sanity/client': ^6.12.3
+    dependencies:
+      '@sanity/client': 6.12.3
+      '@sanity/uuid': 3.0.2
+    dev: false
+
   /@sanity/schema@3.23.4:
     resolution: {integrity: sha512-QjnMmsK78SeVRomOHOgJwUqqxF4XsURLId0nq+BBk5MMHBcm/3tQYhIlRkRowUkM0gJJvECzSPyqoj/e0xnXZw==}
     dependencies:
@@ -4197,6 +4229,13 @@ packages:
     transitivePeerDependencies:
       - rollup
 
+  /async-cache-dedupe@2.0.0:
+    resolution: {integrity: sha512-SrW6PbmCHRQBSpPG8mkPIZZC5AgC08sbzl56GyGemBLVdVUl8mQW4+WCYHp5XZfixIdkL40jKf3UlT/P6Q3p5w==}
+    dependencies:
+      mnemonist: 0.39.6
+      safe-stable-stringify: 2.4.3
+    dev: false
+
   /async-sema@3.1.1:
     resolution: {integrity: sha512-tLRNUXati5MFePdAk8dw7Qt7DpxPB60ofAgn8WRhW6a2rcimZnYBP9oxHiv0OHy+Wz7kPMG+t4LGdt31+4EmGg==}
 
@@ -9914,6 +9953,11 @@ packages:
   /safe-buffer@5.2.1:
     resolution: {integrity: sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==}
 
+  /safe-stable-stringify@2.4.3:
+    resolution: {integrity: sha512-e2bDA2WJT0wxseVd4lsDP4+3ONX6HpMXQa1ZhFQ7SU+GjvORCmShbCMltrtIDfkYhVHrOcPtj+KhmDBdPdZD1g==}
+    engines: {node: '>=10'}
+    dev: false
+
   /safer-buffer@2.1.2:
     resolution: {integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==}
 
@@ -9944,7 +9988,7 @@ packages:
       '@sanity/bifur-client': 0.3.1
       '@sanity/block-tools': 3.23.4
       '@sanity/cli': 3.23.4
-      '@sanity/client': 6.10.0
+      '@sanity/client': 6.11.2
       '@sanity/color': 3.0.0-beta.9
       '@sanity/diff': 3.23.4
       '@sanity/diff-match-patch': 3.1.1
@@ -9957,7 +10001,7 @@ packages:
       '@sanity/logos': 2.1.4(@sanity/color@3.0.0-beta.9)(react@18.2.0)
       '@sanity/mutator': 3.23.4
       '@sanity/portable-text-editor': 3.23.4(react-dom@18.2.0)(react@18.2.0)(rxjs@7.8.1)(styled-components@6.1.6)
-      '@sanity/presentation': 1.4.0(@sanity/client@6.10.0)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(sanity@3.23.4)(styled-components@6.1.6)
+      '@sanity/presentation': 1.4.0(@sanity/client@6.11.2)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(sanity@3.23.4)(styled-components@6.1.6)
       '@sanity/schema': 3.23.4
       '@sanity/telemetry': 0.7.5
       '@sanity/types': 3.23.4
diff --git a/src/module.ts b/src/module.ts
index ad9c6e94..1b0557e1 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -1,17 +1,63 @@
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
-import { defineNuxtModule, requireModule, addTemplate, addComponentsDir, addImports, isNuxt3, addPlugin, isNuxt2, useLogger } from '@nuxt/kit'
+import crypto from 'crypto'
+import {
+  addComponentsDir,
+  addImports,
+  addPlugin,
+  addServerHandler,
+  addTemplate,
+  defineNuxtModule,
+  isNuxt2,
+  isNuxt3,
+  tryResolveModule,
+  requireModule,
+  resolveModule,
+  useLogger,
+} from '@nuxt/kit'
 
 import chalk from 'chalk'
 import { join, resolve } from 'pathe'
 import { defu } from 'defu'
-import { genExport } from 'knitwork'
+import { genExport, genTypeExport } from 'knitwork'
 
 import { name, version } from '../package.json'
 
 import type { SanityConfiguration } from './runtime/client'
+import type { ClientConfig, StegaConfig } from '@sanity/client'
 
-export interface SanityModuleOptions extends Partial<SanityConfiguration> {
+export interface SanityModuleVisualEditingOptions {
+  /**
+   * Enable draft mode or configure draft endpoints
+   */
+  draftMode?:
+    | boolean
+    | {
+        enable?: string
+        disable?: string
+      }
+  /**
+   * Enable visual editing at app level or per component
+   * @default 'global'
+   */
+  mode?: 'global' | 'component'
+  /**
+   * Read token for server side queries
+   * @required
+   */
+  token?: string
+  /**
+   * The URL of the Sanity Studio
+   * @required
+   */
+  studioUrl?: string
+  /**
+   * Enable stega
+   * @required
+   */
+  stega?: boolean
+}
+export type SanityModuleOptions = Partial<SanityConfiguration | ClientConfig> & {
   /** Globally register a $sanity helper throughout your app */
   globalHelper?: boolean
   /**
@@ -29,7 +75,11 @@ export interface SanityModuleOptions extends Partial<SanityConfiguration> {
   /**
    * Configuration for any additional clients
    */
-  additionalClients?: Record<string, Partial<SanityConfiguration>>
+  additionalClients?: Record<string, Partial<SanityConfiguration | ClientConfig>>
+  /**
+   * Configuration for visual editing
+   */
+  visualEditing?: SanityModuleVisualEditingOptions
 }
 
 export type ModuleOptions = SanityModuleOptions
@@ -57,10 +107,12 @@ export default defineNuxtModule<SanityModuleOptions>({
     },
   },
   defaults: nuxt => ({
-    dataset: 'production',
+    additionalClients: {},
     apiVersion: '1',
+    disableSmartCdn: false,
+    dataset: 'production',
+    perspective: 'raw',
     withCredentials: false,
-    additionalClients: {},
     ...getDefaultSanityConfig(resolve(nuxt.options.rootDir, './sanity.json')),
   }),
   async setup (options, nuxt) {
@@ -77,18 +129,80 @@ export default defineNuxtModule<SanityModuleOptions>({
       logger.info(`Enabling minimal client as ${chalk.bold('@sanity/client')} is not installed.`)
     }
 
+    if (options.visualEditing) {
+      try {
+        if (options.minimal) {
+          throw new Error('Minimal client is enabled.')
+        }
+        if (!options.visualEditing.token) {
+          throw new Error(`'token' is required.`)
+        }
+        if (!options.visualEditing.studioUrl) {
+          throw new Error(`'studioUrl' is required.`)
+        }
+        if (!(await tryResolveModule('@sanity/core-loader'))) {
+          throw new Error(
+            `${chalk.bold('@sanity/core-loader')} is not installed.`,
+          )
+        }
+        if (options.apiVersion === '1') {
+          throw new Error(
+            `The specified API Version must be ${chalk.bold(
+              '2021-03-25',
+            )} or later.`,
+          )
+        }
+      } catch (e) {
+        options.visualEditing = undefined
+        if (e instanceof Error) {
+          logger.warn(`Could not enable visual editing: ${e.message}`)
+        }
+      }
+    }
+
     // Final resolved configuration
-    nuxt.options.runtimeConfig.sanity = nuxt.options.runtimeConfig.sanity || {}
-    const { projectId, dataset } = nuxt.options.runtimeConfig.public.sanity = defu(nuxt.options.runtimeConfig.public.sanity, {
-      useCdn: options.useCdn,
-      projectId: options.projectId,
-      dataset: options.dataset,
-      apiVersion: options.apiVersion,
-      withCredentials: options.withCredentials,
-      token: options.token,
-      perspective: options.perspective || 'raw',
-      additionalClients: options.additionalClients,
-    })
+    const visualEditing = options.visualEditing && {
+      draftMode: (options.visualEditing.draftMode
+        ? defu(options.visualEditing.draftMode, {
+            enable: '/draft/enable',
+            disable: '/draft/disable',
+          })
+        : false) as { enable: string; disable: string } | false,
+      mode: options.visualEditing.mode || 'global',
+      studioUrl: options.visualEditing.studioUrl || '',
+    }
+
+    nuxt.options.runtimeConfig.sanity = {
+      ...(nuxt.options.runtimeConfig.sanity || {}),
+      visualEditing: options.visualEditing && {
+        ...visualEditing!,
+        draftModeId: visualEditing!.draftMode
+          ? crypto.randomBytes(16).toString('hex')
+          : '',
+        token: options.visualEditing.token || '',
+      },
+    }
+
+    const { projectId, dataset } = (nuxt.options.runtimeConfig.public.sanity =
+      defu(nuxt.options.runtimeConfig.public.sanity, {
+        additionalClients: options.additionalClients, // has default
+        apiVersion: options.apiVersion, // has default
+        dataset: options.dataset, // has default
+        disableSmartCdn: options.disableSmartCdn, // has default
+        perspective: options.perspective, // has default
+        projectId: options.projectId || '',
+        stega:
+          (options.visualEditing?.stega === true &&
+            ({
+              enabled: true,
+              studioUrl: options.visualEditing.studioUrl,
+            } as StegaConfig)) ||
+          {},
+        token: options.token || '',
+        useCdn: options.useCdn, // enforced
+        visualEditing: visualEditing,
+        withCredentials: options.withCredentials, // has default
+      }))
 
     if (!projectId) {
       logger.warn(`No Sanity project found. Make sure you specify a ${chalk.bold('projectId')} in your Sanity config.`)
@@ -97,14 +211,29 @@ export default defineNuxtModule<SanityModuleOptions>({
     }
 
     const runtimeDir = fileURLToPath(new URL('./runtime', import.meta.url))
+    const typesDir = fileURLToPath(new URL('./types', import.meta.url))
     nuxt.options.build.transpile.push(runtimeDir, '@nuxtjs/sanity')
+    nuxt.options.build.transpile.push('@sanity/core-loader', '@sanity/preview-url-secret')
+
+    const clientSpecifier = options.minimal
+      ? join(runtimeDir, 'client')
+      : '@sanity/client'
 
     addTemplate({
       filename: 'sanity-client.mjs',
+      getContents: () => genExport(clientSpecifier, ['createClient']),
+    })
+    addTemplate({
+      filename: 'sanity-config.ts',
       getContents: () =>
-        options.minimal
-          ? genExport(join(runtimeDir, 'client'), ['createClient'])
-          : genExport('@sanity/client', [{ name: 'createClient' }]),
+        genTypeExport(clientSpecifier, [
+          {
+            name: options.minimal
+              ? 'SanityConfiguration'
+              : 'ClientConfig',
+            as: 'SanityConfiguration',
+          },
+        ]),
     })
 
     if (options.globalHelper) {
@@ -116,27 +245,43 @@ export default defineNuxtModule<SanityModuleOptions>({
       }
     }
 
+    const visualEditingDir = join(runtimeDir, 'visual-editing')
+    const composablesDir = options.visualEditing ? visualEditingDir : runtimeDir
+
+
     addImports([
       { name: 'createClient', as: 'createSanityClient', from: '#build/sanity-client.mjs' },
       { name: 'groq', as: 'groq', from: join(runtimeDir, 'groq') },
-      { name: 'useSanity', as: 'useSanity', from: join(runtimeDir, 'composables') },
+      { name: 'useSanity', as: 'useSanity', from: join(composablesDir, 'composables') },
       { name: 'useLazySanityQuery', as: 'useLazySanityQuery', from: join(runtimeDir, 'composables') },
-      ...isNuxt3() ? [{ name: 'useSanityQuery', as: 'useSanityQuery', from: join(runtimeDir, 'composables') }] : [],
+      ...isNuxt3() ? [{ name: 'useSanityQuery', as: 'useSanityQuery', from: join(composablesDir, 'composables') }] : [],
     ])
 
-    nuxt.hook('prepare:types', ({ tsConfig }) => {
+    const disabled = !isNuxt3() || !options.visualEditing
+    addImports([
+      { name: 'useSanityLiveMode', as: 'useSanityLiveMode', from: join(visualEditingDir, 'composables'), disabled },
+      { name: 'useSanityOverlays', as: 'useSanityOverlays', from: join(visualEditingDir, 'composables'), disabled },
+      { name: 'useSanityVisualEditing', as: 'useSanityVisualEditing', from: join(visualEditingDir, 'composables'), disabled },
+    ])
+
+    nuxt.hook('prepare:types', async ({ tsConfig }) => {
+      const clientPath = await resolveModule(clientSpecifier)
+
       tsConfig.compilerOptions ||= {}
-      tsConfig.compilerOptions.paths['#sanity-client'] = [join(runtimeDir, 'client')]
+      tsConfig.compilerOptions.paths['#sanity-client'] = [clientPath]
+      tsConfig.compilerOptions.paths['#sanity-client/types'] = [
+        join(typesDir, 'client'),
+      ]
+      tsConfig.compilerOptions.paths['#sanity-composables'] = [
+        join(composablesDir, 'composables'),
+      ]
     })
 
     nuxt.hook('nitro:config', (config) => {
       if (config.imports === false) return
 
       config.virtual ||= {}
-      config.virtual['#sanity-client'] =
-        options.minimal
-          ? genExport(join(runtimeDir, 'client'), ['createClient'])
-          : genExport('@sanity/client', [{ name: 'createClient' }])
+      config.virtual['#sanity-client'] = genExport(clientSpecifier, ['createClient'])
 
       config.externals ||= {}
       config.externals.inline ||= []
@@ -164,5 +309,61 @@ export default defineNuxtModule<SanityModuleOptions>({
       path: join(runtimeDir, 'components'),
       extensions: ['js', 'ts', 'mjs'],
     })
+
+    if (options.visualEditing) {
+      // Plugin to check visual editing on app initialisation
+      addPlugin({
+        mode: 'server',
+        src: join(visualEditingDir, 'plugins', 'server'),
+      })
+
+      if (
+        options.visualEditing.mode === undefined ||
+        options.visualEditing.mode === 'global'
+      ) {
+        addPlugin({
+          mode: 'client',
+          src: join(visualEditingDir, 'plugins', 'client'),
+        })
+        logger.info(`Visual editing enabled globally.`)
+      } else {
+        logger.info(
+          `Call ${chalk.bold(
+            'useVisualEditing()',
+          )} in your application to enable visual editing.`,
+        )
+      }
+
+      if (options.visualEditing?.draftMode) {
+        const draftRoutes = defu(
+          options.visualEditing.draftMode === true
+            ? {}
+            : options.visualEditing.draftMode,
+          {
+            enable: '/draft/enable',
+            disable: '/draft/disable',
+          },
+        )
+
+        const draftRoutesDir = join(visualEditingDir, 'draft')
+
+        addServerHandler({
+          method: 'get',
+          route: draftRoutes.enable,
+          handler: join(draftRoutesDir, 'enable'),
+        })
+        addServerHandler({
+          method: 'get',
+          route: draftRoutes.disable,
+          handler: join(draftRoutesDir, 'disable'),
+        })
+
+        logger.info(
+          `Draft mode enabled. Added routes at: ${Object.values(draftRoutes)
+            .map(route => chalk.bold(route))
+            .join(', ')}.`,
+        )
+      }
+    }
   },
 })
diff --git a/src/runtime/client.ts b/src/runtime/client.ts
index 7e1e6ab7..52db58a7 100644
--- a/src/runtime/client.ts
+++ b/src/runtime/client.ts
@@ -7,7 +7,6 @@ import { $fetch } from 'ofetch'
 const apiHost = 'api.sanity.io'
 const cdnHost = 'apicdn.sanity.io'
 
-export type SanityClient = ReturnType<typeof createClient>
 
 export interface SanityConfiguration {
   useCdn?: boolean
diff --git a/src/runtime/composables.ts b/src/runtime/composables.ts
index 249feb83..7dc26832 100644
--- a/src/runtime/composables.ts
+++ b/src/runtime/composables.ts
@@ -3,8 +3,15 @@ import { hash } from 'ohash'
 import { reactive } from 'vue'
 
 import type { AsyncData, AsyncDataOptions } from 'nuxt/app'
-import type { SanityClient, SanityConfiguration } from './client'
-import { useNuxtApp, useRuntimeConfig, useAsyncData, useLazyAsyncData, createSanityClient } from '#imports'
+import type { SanityClient } from '#sanity-client/types'
+import type { SanityConfiguration } from '#build/sanity-config'
+import {
+  useNuxtApp,
+  useRuntimeConfig,
+  useAsyncData,
+  useLazyAsyncData,
+  createSanityClient,
+} from '#imports'
 
 export interface SanityHelper {
   client: SanityClient
@@ -20,6 +27,7 @@ const createSanityHelper = (options: SanityConfiguration): SanityHelper => {
   return {
     client,
     config,
+    // @ts-expect-error
     fetch: (...args) => client.fetch(...args),
     setToken (token) {
       config.token = token
@@ -44,7 +52,7 @@ export const useSanity = (client = 'default'): SanityHelper => {
   }
 
   if (client === 'default') {
-    nuxtApp._sanity.default = createSanityHelper(options)
+    nuxtApp._sanity.default = createSanityHelper(options as SanityConfiguration) // @todo casting
     return nuxtApp._sanity.default
   }
 
@@ -64,7 +72,7 @@ export const useSanityQuery = <T = unknown, E = Error> (query: string, _params?:
     options.watch = options.watch || []
     options.watch.push(params)
   }
-  return useAsyncData('sanity-' + hash(query + (params ? JSON.stringify(params) : '')), () => sanity.fetch<T>(query, params), options) as AsyncData<T | null, E>
+  return useAsyncData('sanity-' + hash(query + (params ? JSON.stringify(params) : '')), () => sanity.fetch<T>(query, params || {}), options) as AsyncData<T | null, E>
 }
 
 export const useLazySanityQuery = <T = unknown, E = Error> (query: string, _params?: Record<string, any>, _options: UseSanityQueryOptions<T> = {}): AsyncData<T | null, E> => {
@@ -75,5 +83,5 @@ export const useLazySanityQuery = <T = unknown, E = Error> (query: string, _para
     options.watch = options.watch || []
     options.watch.push(params)
   }
-  return useLazyAsyncData('sanity-' + hash(query + (params ? JSON.stringify(params) : '')), () => sanity.fetch<T>(query, params), options) as AsyncData<T | null, E>
+  return useLazyAsyncData('sanity-' + hash(query + (params ? JSON.stringify(params) : '')), () => sanity.fetch<T>(query, params || {}), options) as AsyncData<T | null, E>
 }
diff --git a/src/runtime/nitro-imports.ts b/src/runtime/nitro-imports.ts
index c76be5ba..56d42475 100644
--- a/src/runtime/nitro-imports.ts
+++ b/src/runtime/nitro-imports.ts
@@ -1,7 +1,7 @@
 import { defu } from 'defu'
 
-import type { SanityConfiguration } from './client'
-import type { SanityHelper } from './composables'
+import type { SanityConfiguration } from '#build/sanity-config'
+import type { SanityHelper } from '#sanity-composables'
 
 import { useRuntimeConfig } from '#imports'
 import { createClient } from '#sanity-client'
@@ -16,7 +16,7 @@ const createSanityHelper = (options: SanityConfiguration): SanityHelper => {
   return {
     client,
     config,
-    fetch: (...args) => client.fetch(...args),
+    fetch: client.fetch,
     setToken (token) {
       config.token = token
       client = createClient(config)
@@ -29,10 +29,15 @@ export const useSanity = (client = 'default'): SanityHelper => {
     return clients[client]
   }
 
-  const { additionalClients = {}, ...options } = defu($config.sanity, $config.public.sanity)
+  const {
+    additionalClients = {},
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    visualEditing,
+    ...options
+  } = defu($config.sanity, $config.public.sanity)
 
   if (client === 'default') {
-    clients.default = createSanityHelper(options)
+    clients.default = createSanityHelper(options as SanityConfiguration) // @todo casting
     return clients.default
   }
 
diff --git a/src/runtime/plugin.ts b/src/runtime/plugin.ts
index b0c3a952..b4978e2a 100644
--- a/src/runtime/plugin.ts
+++ b/src/runtime/plugin.ts
@@ -1,4 +1,4 @@
-import type { SanityHelper } from './composables'
+import type { SanityHelper } from '#sanity-composables'
 import { defineNuxtPlugin, useSanity } from '#imports'
 
 export default defineNuxtPlugin((nuxtApp) => {
diff --git a/src/runtime/visual-editing/composables.ts b/src/runtime/visual-editing/composables.ts
new file mode 100644
index 00000000..16f7fe58
--- /dev/null
+++ b/src/runtime/visual-editing/composables.ts
@@ -0,0 +1,358 @@
+import { defu } from 'defu'
+import { hash } from 'ohash'
+import { type Ref, reactive } from 'vue'
+import {
+  createQueryStore as createCoreQueryStore,
+  type QueryStore,
+  type QueryStoreState,
+} from '@sanity/core-loader'
+import {
+  defineEncodeDataAttribute,
+  type EncodeDataAttributeFunction,
+} from '@sanity/core-loader/encode-data-attribute'
+import type {
+  ClientPerspective,
+  ContentSourceMap,
+  QueryParams,
+} from '@sanity/client'
+import { enableOverlays } from '@sanity/overlays'
+import type { AsyncData, AsyncDataOptions } from 'nuxt/app'
+import type { SanityConfiguration } from '#build/sanity-config'
+import type { SanityClient } from '#sanity-client/types'
+import {
+  createSanityClient,
+  useNuxtApp,
+  useRuntimeConfig,
+  useAsyncData,
+} from '#imports'
+
+export interface SanityVisualEditingConfiguration {
+  draftMode:
+    | boolean
+    | {
+        enable?: string
+        disable?: string
+      }
+  mode: 'global' | 'component'
+  token?: string
+  studioUrl: string
+  draftModeId?: string
+}
+
+export interface SanityHelperConfiguration extends SanityConfiguration {
+  visualEditing?: SanityVisualEditingConfiguration
+}
+
+export interface SanityHelper {
+  client: SanityClient
+  config: SanityHelperConfiguration
+  fetch: SanityClient['fetch']
+  setToken: (token: string) => void
+  queryStore?: QueryStore
+}
+
+type AsyncDataRequestStatus = 'idle' | 'pending' | 'success' | 'error'
+interface AsyncDataExecuteOptions {
+  _initial?: boolean
+  dedupe?: boolean
+}
+
+interface UseSanityQueryOptions<T> extends AsyncDataOptions<T> {
+  client?: string
+  perspective?: 'previewDrafts' | 'published' | 'raw'
+}
+
+interface SanityQueryResponse<T> {
+  data: T
+  sourceMap?: ContentSourceMap
+  perspective?: ClientPerspective
+}
+
+type Noop = () => void
+
+interface _AsyncSanityData<DataT, ErrorT> {
+  data: Ref<DataT>
+  sourceMap: Ref<ContentSourceMap | null>
+  encodeDataAttribute: Ref<EncodeDataAttributeFunction | Noop>
+  pending: Ref<boolean>
+  refresh: (opts?: AsyncDataExecuteOptions) => Promise<{
+    data: DataT
+    sourceMap?: ContentSourceMap | null
+  }>
+  execute: (opts?: AsyncDataExecuteOptions) => Promise<{
+    data: DataT
+    sourceMap?: ContentSourceMap | null
+  }>
+  error: Ref<ErrorT | null>
+  status: Ref<AsyncDataRequestStatus>
+}
+
+export type AsyncSanityData<Data, Error> = _AsyncSanityData<Data, Error> &
+  Promise<_AsyncSanityData<Data, Error>>
+
+const createQueryStore = (
+  visualEditing: SanityVisualEditingConfiguration,
+  client: SanityClient,
+  tag?: string,
+) => {
+  const queryStore = createCoreQueryStore({
+    tag: tag || 'nuxt-loader',
+    client: false,
+    ssr: true,
+  })
+
+  if (import.meta.server) {
+    const serverClient = client.withConfig({
+      perspective: 'previewDrafts',
+      token: visualEditing?.token,
+      useCdn: false,
+    })
+    queryStore.setServerClient(serverClient)
+  }
+
+  return queryStore
+}
+
+const createSanityHelper = (
+  options: SanityHelperConfiguration,
+): SanityHelper => {
+  const config = { ...options }
+  const { visualEditing, ...clientConfig } = config;
+  let client = createSanityClient(clientConfig)
+
+  const visualEditingEnabled =
+    visualEditing &&
+    (!visualEditing.draftMode || useState('_sanity_visualEditing').value)
+
+  let queryStore = visualEditingEnabled
+    ? createQueryStore(visualEditing, client)
+    : undefined
+
+  return {
+    client,
+    config,
+    // @ts-expect-error
+    fetch: (...args) => client.fetch(...args),
+    queryStore,
+    setToken(token) {
+      config.token = token
+      client = createSanityClient(clientConfig)
+      if (queryStore && visualEditing) {
+        queryStore = createQueryStore(visualEditing, client)
+      }
+    },
+  }
+}
+
+export const useSanity = (client = 'default'): SanityHelper => {
+  const nuxtApp = useNuxtApp()
+  if (nuxtApp._sanity?.[client]) {
+    return nuxtApp._sanity[client]
+  }
+
+  nuxtApp._sanity = nuxtApp._sanity || {}
+
+  const $config = useRuntimeConfig()
+  const { additionalClients = {}, visualEditing, ...options } = defu(
+    $config.sanity,
+    $config.public.sanity,
+  )
+
+  if (client === 'default') {
+    nuxtApp._sanity.default = createSanityHelper({
+      ...options,
+      visualEditing: visualEditing || undefined,
+    } as SanityConfiguration) // @todo casting
+    return nuxtApp._sanity.default
+  }
+
+  nuxtApp._sanity[client] = createSanityHelper(
+    defu(additionalClients[client], options),
+  )
+  return nuxtApp._sanity[client]
+}
+
+export const useSanityQuery = <T = unknown, E = Error>(
+  query: string,
+  _params?: QueryParams,
+  _options: UseSanityQueryOptions<SanityQueryResponse<T | null>> = {},
+): AsyncSanityData<T | null, E> => {
+  const { client, perspective: _perspective, ...options } = _options
+  const sanity = useSanity(client)
+  const params = _params ? reactive(_params) : undefined
+  if (params) {
+    options.watch = options.watch || []
+    options.watch.push(params)
+  }
+
+  const perspective = (
+    _perspective || sanity.queryStore ? 'previewDrafts' : 'published'
+  ) as ClientPerspective
+
+  const queryKey =
+    'sanity-' + hash(query + (params ? JSON.stringify(params) : ''))
+
+  const data = ref<T | null>(null) as Ref<T | null> // Generic must be cast
+  const sourceMap = ref<ContentSourceMap | null>(null)
+  const encodeDataAttribute = ref<EncodeDataAttributeFunction | Noop>(() => {})
+  const updateRefs = (newData: T | null, newSourceMap?: ContentSourceMap) => {
+    data.value = newData
+    sourceMap.value = newSourceMap || null
+    encodeDataAttribute.value = defineEncodeDataAttribute(
+      newData,
+      newSourceMap,
+      sanity.config.visualEditing?.studioUrl,
+    )
+  }
+
+  let result: AsyncData<SanityQueryResponse<T | null>, E>
+
+  if (!sanity.queryStore) {
+    result = useAsyncData<SanityQueryResponse<T | null>, E>(
+      queryKey,
+      async () => {
+        const data = await sanity.fetch<T>(query, params || {}, {
+          perspective,
+        })
+        return { data }
+      },
+      options,
+    ) as AsyncData<SanityQueryResponse<T | null>, E>
+  } else {
+    let unsubscribe = () => {}
+
+    const setupFetcher = (
+      cb?: (state: Readonly<QueryStoreState<T, E>>) => void,
+    ) => {
+      unsubscribe()
+
+      const fetcher = sanity.queryStore!.createFetcherStore<T, E>(
+        query,
+        _params,
+        undefined,
+      )
+
+      unsubscribe = fetcher.subscribe(newSnapshot => {
+        if (newSnapshot.data) {
+          updateRefs(newSnapshot.data as unknown as T, newSnapshot.sourceMap)
+          cb?.(newSnapshot)
+        }
+      })
+    }
+
+    result = useAsyncData<SanityQueryResponse<T | null>, E>(
+      queryKey,
+      async () => {
+        if (import.meta.server) {
+          const client =
+            sanity.queryStore!.unstable__serverClient.instance || sanity.client
+          const { result: data, resultSourceMap: sourceMap } =
+            await client.fetch<T>(query, params || {}, {
+              perspective,
+              filterResponse: false,
+              resultSourceMap: 'withKeyArraySelector',
+            })
+          return sourceMap ? { data, sourceMap } : { data }
+        } else {
+          return new Promise<{
+            data: T | null
+            sourceMap: ContentSourceMap | undefined
+          }>(resolve => {
+            setupFetcher(newSnapshot => {
+              resolve({
+                data: newSnapshot.data || null,
+                sourceMap: newSnapshot.sourceMap,
+              })
+            })
+          })
+        }
+      },
+      options,
+    ) as AsyncData<SanityQueryResponse<T | null>, E>
+
+    if (result.status.value === 'success' && import.meta.client) {
+      setupFetcher()
+    }
+
+    onScopeDispose(unsubscribe)
+  }
+
+  return new Promise(resolve => {
+    result.then(value => {
+      updateRefs(value.data.value.data, value.data.value.sourceMap)
+      resolve({
+        ...result,
+        data,
+        sourceMap,
+        encodeDataAttribute,
+      })
+    })
+  }) as AsyncSanityData<T | null, E>
+}
+
+export function useSanityLiveMode({ client = 'default' }: { client?: string }) {
+  let disable = () => {}
+
+  if (import.meta.client) {
+    const sanity = useSanity(client)
+    if (sanity.queryStore) {
+      disable = sanity.queryStore.enableLiveMode({
+        client: sanity.client,
+      })
+    }
+  }
+
+  onScopeDispose(disable)
+
+  return disable
+}
+
+export function useSanityOverlays() {
+  let disable = () => {}
+
+  if (import.meta.client) {
+    const router = useRouter()
+    disable = enableOverlays({
+      history: {
+        subscribe: navigate => {
+          router.isReady().then(() => {
+            navigate({
+              type: 'replace',
+              url: router.currentRoute.value.fullPath,
+            })
+          })
+          return router.afterEach(to => {
+            // There is no mechanism to determine navigation type in a Vue Router navigation guard, so just push
+            // https://github.com/vuejs/vue-router/issues/1620
+            navigate({ type: 'push', url: to.fullPath })
+          })
+        },
+        update: update => {
+          if (update.type === 'push' || update.type === 'replace') {
+            router[update.type](update.url)
+          } else if (update.type === 'pop') {
+            router.back()
+          }
+        },
+      },
+    })
+  }
+
+  onScopeDispose(() => {
+    disable()
+  })
+
+  return disable
+}
+
+export function useSanityVisualEditing(
+  options: { client?: string } | Array<{ client?: string }> = {},
+) {
+  const _options = Array.isArray(options) ? options : [options]
+
+  useSanityOverlays()
+
+  _options.forEach(option => {
+    useSanityLiveMode(option)
+  })
+}
diff --git a/src/runtime/visual-editing/draft/disable.ts b/src/runtime/visual-editing/draft/disable.ts
new file mode 100644
index 00000000..163ca364
--- /dev/null
+++ b/src/runtime/visual-editing/draft/disable.ts
@@ -0,0 +1,6 @@
+import { defineEventHandler, deleteCookie, sendRedirect } from 'h3'
+
+export default defineEventHandler(async event => {
+  deleteCookie(event, '__sanity_draft')
+  sendRedirect(event, '/')
+})
diff --git a/src/runtime/visual-editing/draft/enable.ts b/src/runtime/visual-editing/draft/enable.ts
new file mode 100644
index 00000000..d6309370
--- /dev/null
+++ b/src/runtime/visual-editing/draft/enable.ts
@@ -0,0 +1,32 @@
+import { defineEventHandler, setCookie, sendRedirect } from 'h3'
+import { validatePreviewUrl } from '@sanity/preview-url-secret'
+
+export default defineEventHandler(async event => {
+  const $config = useRuntimeConfig()
+  const sanity = useSanity()
+
+  const client = sanity.client.withConfig({
+    token: $config.sanity.visualEditing!.token,
+  })
+
+  const { isValid, redirectTo = '/' } = await validatePreviewUrl(
+    client,
+    getRequestURL(event).toString(),
+  )
+
+  if (!isValid) {
+    throw createError({
+      statusCode: 401,
+      statusMessage: 'Invalid secret',
+    })
+  }
+
+  setCookie(event, '__sanity_draft', $config.sanity.visualEditing!.draftModeId, {
+    httpOnly: true,
+    sameSite: process.env.NODE_ENV !== 'development' ? 'none' : 'lax',
+    secure: process.env.NODE_ENV !== 'development',
+    path: '/',
+  })
+
+  await sendRedirect(event, redirectTo, 307)
+})
diff --git a/src/runtime/visual-editing/plugins/client.ts b/src/runtime/visual-editing/plugins/client.ts
new file mode 100644
index 00000000..5ea0b4bb
--- /dev/null
+++ b/src/runtime/visual-editing/plugins/client.ts
@@ -0,0 +1,6 @@
+// @ts-ignore
+import { defineNuxtPlugin, useSanityVisualEditing } from '#imports'
+
+export default defineNuxtPlugin(() => {
+  useSanityVisualEditing()
+})
diff --git a/src/runtime/visual-editing/plugins/server.ts b/src/runtime/visual-editing/plugins/server.ts
new file mode 100644
index 00000000..d8a83c0c
--- /dev/null
+++ b/src/runtime/visual-editing/plugins/server.ts
@@ -0,0 +1,21 @@
+import {
+  defineNuxtPlugin,
+  useRuntimeConfig,
+  useState,
+  useCookie,
+} from '#imports'
+
+export default defineNuxtPlugin(() => {
+  const enabled = useState('_sanity_visualEditing', () => false)
+
+  const $config = useRuntimeConfig()
+
+  const { visualEditing } = $config.sanity
+
+  if (visualEditing?.draftMode) {
+    const draftModeCookie = useCookie('__sanity_draft')
+    enabled.value = draftModeCookie.value === visualEditing.draftModeId
+  } else if (typeof visualEditing === 'object' && !visualEditing.draftMode) {
+    enabled.value = true
+  }
+})
diff --git a/src/types/client.ts b/src/types/client.ts
new file mode 100644
index 00000000..869db7ee
--- /dev/null
+++ b/src/types/client.ts
@@ -0,0 +1,3 @@
+import { createClient } from '#sanity-client'
+
+export type SanityClient = ReturnType<typeof createClient>

From 5587830f31214c162eef5e9ff9569dd4d8e5a29c Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Sun, 18 Feb 2024 20:30:20 +0000
Subject: [PATCH 02/15] chore: add playground dev command + `.env` example

---
 .gitignore                  | 2 +-
 playground/.env.example     | 2 ++
 playground/cms/package.json | 1 +
 3 files changed, 4 insertions(+), 1 deletion(-)
 create mode 100644 playground/.env.example

diff --git a/.gitignore b/.gitignore
index 3aaad353..e07e212d 100755
--- a/.gitignore
+++ b/.gitignore
@@ -8,5 +8,5 @@ node_modules
 .DS_Store
 coverage
 dist
-
+playground/.env
 .vercel
diff --git a/playground/.env.example b/playground/.env.example
new file mode 100644
index 00000000..7fc10784
--- /dev/null
+++ b/playground/.env.example
@@ -0,0 +1,2 @@
+# add a Viewer token issued from https://www.sanity.io/organizations/<org_id>/project/<project_id>/api#tokens
+NUXT_SANITY_VISUAL_EDITING_TOKEN=
diff --git a/playground/cms/package.json b/playground/cms/package.json
index 44d0a8ff..dd6400d4 100644
--- a/playground/cms/package.json
+++ b/playground/cms/package.json
@@ -7,6 +7,7 @@
   "author": "Daniel Roe <daniel@roe.dev>",
   "license": "MIT",
   "scripts": {
+    "dev": "sanity dev",
     "start": "sanity start",
     "test": "sanity check"
   },

From 5b15cb601f0df2b638ae4409fd21bcb1f7ac0d8d Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Sun, 18 Feb 2024 20:47:33 +0000
Subject: [PATCH 03/15] refactor: add visual editing auto-imports conditionally

---
 src/module.ts | 30 +++++++++++++-----------------
 1 file changed, 13 insertions(+), 17 deletions(-)

diff --git a/src/module.ts b/src/module.ts
index 1b0557e1..fde54e2c 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
-import crypto from 'crypto'
+import crypto from 'node:crypto'
 import {
   addComponentsDir,
   addImports,
@@ -215,9 +215,7 @@ export default defineNuxtModule<SanityModuleOptions>({
     nuxt.options.build.transpile.push(runtimeDir, '@nuxtjs/sanity')
     nuxt.options.build.transpile.push('@sanity/core-loader', '@sanity/preview-url-secret')
 
-    const clientSpecifier = options.minimal
-      ? join(runtimeDir, 'client')
-      : '@sanity/client'
+    const clientSpecifier = options.minimal ? join(runtimeDir, 'client') : '@sanity/client'
 
     addTemplate({
       filename: 'sanity-client.mjs',
@@ -228,9 +226,7 @@ export default defineNuxtModule<SanityModuleOptions>({
       getContents: () =>
         genTypeExport(clientSpecifier, [
           {
-            name: options.minimal
-              ? 'SanityConfiguration'
-              : 'ClientConfig',
+            name: options.minimal ? 'SanityConfiguration' : 'ClientConfig',
             as: 'SanityConfiguration',
           },
         ]),
@@ -248,7 +244,6 @@ export default defineNuxtModule<SanityModuleOptions>({
     const visualEditingDir = join(runtimeDir, 'visual-editing')
     const composablesDir = options.visualEditing ? visualEditingDir : runtimeDir
 
-
     addImports([
       { name: 'createClient', as: 'createSanityClient', from: '#build/sanity-client.mjs' },
       { name: 'groq', as: 'groq', from: join(runtimeDir, 'groq') },
@@ -257,16 +252,8 @@ export default defineNuxtModule<SanityModuleOptions>({
       ...isNuxt3() ? [{ name: 'useSanityQuery', as: 'useSanityQuery', from: join(composablesDir, 'composables') }] : [],
     ])
 
-    const disabled = !isNuxt3() || !options.visualEditing
-    addImports([
-      { name: 'useSanityLiveMode', as: 'useSanityLiveMode', from: join(visualEditingDir, 'composables'), disabled },
-      { name: 'useSanityOverlays', as: 'useSanityOverlays', from: join(visualEditingDir, 'composables'), disabled },
-      { name: 'useSanityVisualEditing', as: 'useSanityVisualEditing', from: join(visualEditingDir, 'composables'), disabled },
-    ])
-
+    const clientPath = await resolveModule(clientSpecifier)
     nuxt.hook('prepare:types', async ({ tsConfig }) => {
-      const clientPath = await resolveModule(clientSpecifier)
-
       tsConfig.compilerOptions ||= {}
       tsConfig.compilerOptions.paths['#sanity-client'] = [clientPath]
       tsConfig.compilerOptions.paths['#sanity-client/types'] = [
@@ -311,6 +298,15 @@ export default defineNuxtModule<SanityModuleOptions>({
     })
 
     if (options.visualEditing) {
+      // Add auto-imports for visual editing
+      if (isNuxt3()) {
+        addImports([
+          { name: 'useSanityLiveMode', as: 'useSanityLiveMode', from: join(visualEditingDir, 'composables') },
+          { name: 'useSanityOverlays', as: 'useSanityOverlays', from: join(visualEditingDir, 'composables') },
+          { name: 'useSanityVisualEditing', as: 'useSanityVisualEditing', from: join(visualEditingDir, 'composables') },
+        ])
+      }
+
       // Plugin to check visual editing on app initialisation
       addPlugin({
         mode: 'server',

From 6b013ff35de02b723f5c685fb797f2e5805a81ab Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Sun, 18 Feb 2024 20:53:30 +0000
Subject: [PATCH 04/15] refactor: use `@sanity/visual-editing`

---
 package.json                              |  2 +-
 pnpm-lock.yaml                            | 21 +++++-------------
 src/runtime/visual-editing/composables.ts | 26 +++++++++++------------
 3 files changed, 19 insertions(+), 30 deletions(-)

diff --git a/package.json b/package.json
index a0878b9c..98407167 100755
--- a/package.json
+++ b/package.json
@@ -50,8 +50,8 @@
     "@nuxt/kit": "^3.9.0",
     "@portabletext/types": "^2.0.8",
     "@sanity/core-loader": "^1.4.0",
-    "@sanity/overlays": "^2.3.9",
     "@sanity/preview-url-secret": "^1.6.0",
+    "@sanity/visual-editing": "^1.3.1",
     "chalk": "^5.3.0",
     "defu": "^6.1.3",
     "knitwork": "^1.0.0",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index d0765df4..5ba5de16 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -21,13 +21,13 @@ importers:
         version: 2.0.8
       '@sanity/core-loader':
         specifier: ^1.4.0
-        version: 1.4.0(@sanity/client@6.12.3)
-      '@sanity/overlays':
-        specifier: ^2.3.9
-        version: 2.3.9
+        version: 1.4.3(@sanity/client@6.13.3)
       '@sanity/preview-url-secret':
         specifier: ^1.6.0
-        version: 1.6.0(@sanity/client@6.12.3)
+        version: 1.6.3(@sanity/client@6.13.3)
+      '@sanity/visual-editing':
+        specifier: ^1.3.1
+        version: 1.3.1
       chalk:
         specifier: ^5.3.0
         version: 5.3.0
@@ -2843,17 +2843,6 @@ packages:
       - supports-color
     dev: false
 
-  /@sanity/overlays@2.3.9:
-    resolution: {integrity: sha512-GmZAgB1gCcUcXtAHc7sm2d4m50MGNvj7YpUwdd4xum4pRUQtRs5braw85wqddPh26rgAJ+IGLdhNs8xz9sqaNg==}
-    engines: {node: '>=16.14'}
-    dependencies:
-      '@vercel/stega': 0.1.0
-      react: 18.2.0
-      react-dom: 18.2.0(react@18.2.0)
-      react-is: 18.2.0
-      scroll-into-view-if-needed: 3.1.0
-    dev: false
-
   /@sanity/portable-text-editor@3.23.4(react-dom@18.2.0)(react@18.2.0)(rxjs@7.8.1)(styled-components@6.1.6):
     resolution: {integrity: sha512-mWJ3VFOtJIu7n4ptXeENZOcIT/UPkYlErymEGRKAOtYmswc6/lHvfx+QX/PN0E9zcIgGhcgT8/4OH9tkewY7IA==}
     engines: {node: '>=18'}
diff --git a/src/runtime/visual-editing/composables.ts b/src/runtime/visual-editing/composables.ts
index 16f7fe58..efe1ba66 100644
--- a/src/runtime/visual-editing/composables.ts
+++ b/src/runtime/visual-editing/composables.ts
@@ -15,7 +15,7 @@ import type {
   ContentSourceMap,
   QueryParams,
 } from '@sanity/client'
-import { enableOverlays } from '@sanity/overlays'
+import { enableVisualEditing } from '@sanity/visual-editing'
 import type { AsyncData, AsyncDataOptions } from 'nuxt/app'
 import type { SanityConfiguration } from '#build/sanity-config'
 import type { SanityClient } from '#sanity-client/types'
@@ -28,11 +28,11 @@ import {
 
 export interface SanityVisualEditingConfiguration {
   draftMode:
-    | boolean
-    | {
-        enable?: string
-        disable?: string
-      }
+  | boolean
+  | {
+    enable?: string
+    disable?: string
+  }
   mode: 'global' | 'component'
   token?: string
   studioUrl: string
@@ -117,7 +117,7 @@ const createSanityHelper = (
   options: SanityHelperConfiguration,
 ): SanityHelper => {
   const config = { ...options }
-  const { visualEditing, ...clientConfig } = config;
+  const { visualEditing, ...clientConfig } = config
   let client = createSanityClient(clientConfig)
 
   const visualEditingEnabled =
@@ -134,7 +134,7 @@ const createSanityHelper = (
     // @ts-expect-error
     fetch: (...args) => client.fetch(...args),
     queryStore,
-    setToken(token) {
+    setToken (token) {
       config.token = token
       client = createSanityClient(clientConfig)
       if (queryStore && visualEditing) {
@@ -172,7 +172,7 @@ export const useSanity = (client = 'default'): SanityHelper => {
   return nuxtApp._sanity[client]
 }
 
-export const useSanityQuery = <T = unknown, E = Error>(
+export const useSanityQuery = <T = unknown, E = Error> (
   query: string,
   _params?: QueryParams,
   _options: UseSanityQueryOptions<SanityQueryResponse<T | null>> = {},
@@ -290,7 +290,7 @@ export const useSanityQuery = <T = unknown, E = Error>(
   }) as AsyncSanityData<T | null, E>
 }
 
-export function useSanityLiveMode({ client = 'default' }: { client?: string }) {
+export function useSanityLiveMode ({ client = 'default' }: { client?: string }) {
   let disable = () => {}
 
   if (import.meta.client) {
@@ -307,12 +307,12 @@ export function useSanityLiveMode({ client = 'default' }: { client?: string }) {
   return disable
 }
 
-export function useSanityOverlays() {
+export function useSanityOverlays () {
   let disable = () => {}
 
   if (import.meta.client) {
     const router = useRouter()
-    disable = enableOverlays({
+    disable = enableVisualEditing({
       history: {
         subscribe: navigate => {
           router.isReady().then(() => {
@@ -345,7 +345,7 @@ export function useSanityOverlays() {
   return disable
 }
 
-export function useSanityVisualEditing(
+export function useSanityVisualEditing (
   options: { client?: string } | Array<{ client?: string }> = {},
 ) {
   const _options = Array.isArray(options) ? options : [options]

From 5e5d35f37e8e4496b1aadd2b51ca29462a8d9df0 Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Sun, 18 Feb 2024 21:01:47 +0000
Subject: [PATCH 05/15] chore: minor stylistic simplifications

---
 playground/pages/index.vue | 48 ++++++++++++++++------------------
 src/module.ts              | 53 +++++++++++++-------------------------
 2 files changed, 40 insertions(+), 61 deletions(-)

diff --git a/playground/pages/index.vue b/playground/pages/index.vue
index 7ede7840..4e1a7271 100644
--- a/playground/pages/index.vue
+++ b/playground/pages/index.vue
@@ -1,30 +1,28 @@
 <template>
-  <div>
-    <div
-      class="bg-gray-300 grid grid-flow-col grid-rows-3 p-8 overflow-x-hidden min-h-screen"
+  <div
+    class="bg-gray-300 grid grid-flow-col grid-rows-3 p-8 overflow-x-hidden min-h-screen"
+  >
+    <h2>Project ID: {{ $sanity.config.projectId }}</h2>
+    <NuxtLink
+      v-for="({ title, poster, slug }, i) in movies"
+      :key="title"
+      :to="`/movie/${slug}`"
+      class="flex w-64 h-48 relative justify-start"
     >
-      <h2>Project ID: {{ $sanity.config.projectId }}</h2>
-      <NuxtLink
-        v-for="({ title, poster, slug }, i) in movies"
-        :key="title"
-        :to="`/movie/${slug}`"
-        class="flex w-64 h-48 relative justify-start"
+      <div
+        class="py-2 px-4 left-0 bottom-0 mb-4 flex-grow absolute bg-gray-100 rounded shadow-md font-semibold text-gray-800"
+        :data-sanity="encodeDataAttribute?.([i, 'title'])"
       >
-        <div
-          class="py-2 px-4 left-0 bottom-0 mb-4 flex-grow absolute bg-gray-100 rounded shadow-md font-semibold text-gray-800"
-          :data-sanity="encodeDataAttribute?.([i, 'title'])"
-        >
-          {{ title }}
-        </div>
+        {{ title }}
+      </div>
 
-        <SanityImage
-          class="object-contain w-48"
-          :asset-id="poster"
-          w="128"
-          auto="format"
-        />
-      </NuxtLink>
-    </div>
+      <SanityImage
+        class="object-contain w-48"
+        :asset-id="poster"
+        w="128"
+        auto="format"
+      />
+    </NuxtLink>
   </div>
 </template>
 
@@ -41,7 +39,5 @@ interface QueryResult {
   slug: string
 }
 
-const { data: movies, encodeDataAttribute } = await useSanityQuery<
-  QueryResult[]
->(query)
+const { data: movies, encodeDataAttribute } = await useSanityQuery<QueryResult[]>(query)
 </script>
diff --git a/src/module.ts b/src/module.ts
index fde54e2c..cfee5152 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -31,11 +31,11 @@ export interface SanityModuleVisualEditingOptions {
    * Enable draft mode or configure draft endpoints
    */
   draftMode?:
-    | boolean
-    | {
-        enable?: string
-        disable?: string
-      }
+  | boolean
+  | {
+    enable?: string
+    disable?: string
+  }
   /**
    * Enable visual editing at app level or per component
    * @default 'global'
@@ -141,16 +141,10 @@ export default defineNuxtModule<SanityModuleOptions>({
           throw new Error(`'studioUrl' is required.`)
         }
         if (!(await tryResolveModule('@sanity/core-loader'))) {
-          throw new Error(
-            `${chalk.bold('@sanity/core-loader')} is not installed.`,
-          )
+          throw new Error(`${chalk.bold('@sanity/core-loader')} is not installed.`)
         }
         if (options.apiVersion === '1') {
-          throw new Error(
-            `The specified API Version must be ${chalk.bold(
-              '2021-03-25',
-            )} or later.`,
-          )
+          throw new Error(`The specified API Version must be ${chalk.bold('2021-03-25')} or later.`)
         }
       } catch (e) {
         options.visualEditing = undefined
@@ -164,24 +158,20 @@ export default defineNuxtModule<SanityModuleOptions>({
     const visualEditing = options.visualEditing && {
       draftMode: (options.visualEditing.draftMode
         ? defu(options.visualEditing.draftMode, {
-            enable: '/draft/enable',
-            disable: '/draft/disable',
-          })
+          enable: '/draft/enable',
+          disable: '/draft/disable',
+        })
         : false) as { enable: string; disable: string } | false,
       mode: options.visualEditing.mode || 'global',
       studioUrl: options.visualEditing.studioUrl || '',
     }
 
-    nuxt.options.runtimeConfig.sanity = {
-      ...(nuxt.options.runtimeConfig.sanity || {}),
+    nuxt.options.runtimeConfig.sanity = defu(nuxt.options.runtimeConfig.sanity, {
       visualEditing: options.visualEditing && {
-        ...visualEditing!,
-        draftModeId: visualEditing!.draftMode
-          ? crypto.randomBytes(16).toString('hex')
-          : '',
+        draftModeId: visualEditing!.draftMode ? crypto.randomBytes(16).toString('hex') : '',
         token: options.visualEditing.token || '',
       },
-    }
+    })
 
     const { projectId, dataset } = (nuxt.options.runtimeConfig.public.sanity =
       defu(nuxt.options.runtimeConfig.public.sanity, {
@@ -255,10 +245,8 @@ export default defineNuxtModule<SanityModuleOptions>({
     const clientPath = await resolveModule(clientSpecifier)
     nuxt.hook('prepare:types', async ({ tsConfig }) => {
       tsConfig.compilerOptions ||= {}
+      tsConfig.compilerOptions.paths['#sanity-client/types'] = [join(typesDir, 'client')]
       tsConfig.compilerOptions.paths['#sanity-client'] = [clientPath]
-      tsConfig.compilerOptions.paths['#sanity-client/types'] = [
-        join(typesDir, 'client'),
-      ]
       tsConfig.compilerOptions.paths['#sanity-composables'] = [
         join(composablesDir, 'composables'),
       ]
@@ -331,15 +319,10 @@ export default defineNuxtModule<SanityModuleOptions>({
       }
 
       if (options.visualEditing?.draftMode) {
-        const draftRoutes = defu(
-          options.visualEditing.draftMode === true
-            ? {}
-            : options.visualEditing.draftMode,
-          {
-            enable: '/draft/enable',
-            disable: '/draft/disable',
-          },
-        )
+        const draftRoutes = defu(options.visualEditing.draftMode, {
+          enable: '/draft/enable',
+          disable: '/draft/disable',
+        })
 
         const draftRoutesDir = join(visualEditingDir, 'draft')
 

From 1b3b2e0b5d6b35b8526556aabc19b466a943bbe1 Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Sun, 18 Feb 2024 21:19:43 +0000
Subject: [PATCH 06/15] refactor: use alias rather than build file for type
 export

---
 src/module.ts                             | 30 ++------
 src/runtime/client.ts                     | 92 +----------------------
 src/runtime/composables.ts                |  9 +--
 src/runtime/minimal-client.ts             | 91 ++++++++++++++++++++++
 src/runtime/nitro-imports.ts              |  9 ++-
 src/runtime/visual-editing/composables.ts | 39 ++++------
 src/types/client.ts                       |  3 -
 test/unit/client.test.ts                  |  2 +-
 test/unit/helpers.test.ts                 |  2 +-
 9 files changed, 127 insertions(+), 150 deletions(-)
 create mode 100644 src/runtime/minimal-client.ts
 delete mode 100644 src/types/client.ts

diff --git a/src/module.ts b/src/module.ts
index cfee5152..52b71e52 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -19,12 +19,12 @@ import {
 import chalk from 'chalk'
 import { join, resolve } from 'pathe'
 import { defu } from 'defu'
-import { genExport, genTypeExport } from 'knitwork'
+import { genExport } from 'knitwork'
 
 import { name, version } from '../package.json'
 
-import type { SanityConfiguration } from './runtime/client'
-import type { ClientConfig, StegaConfig } from '@sanity/client'
+import type { ClientConfig as MinimalClientConfig } from './runtime/minimal-client'
+import type { ClientConfig as SanityClientConfig, StegaConfig } from '@sanity/client'
 
 export interface SanityModuleVisualEditingOptions {
   /**
@@ -57,7 +57,7 @@ export interface SanityModuleVisualEditingOptions {
    */
   stega?: boolean
 }
-export type SanityModuleOptions = Partial<SanityConfiguration | ClientConfig> & {
+export type SanityModuleOptions = Partial<MinimalClientConfig | SanityClientConfig> & {
   /** Globally register a $sanity helper throughout your app */
   globalHelper?: boolean
   /**
@@ -75,7 +75,7 @@ export type SanityModuleOptions = Partial<SanityConfiguration | ClientConfig> &
   /**
    * Configuration for any additional clients
    */
-  additionalClients?: Record<string, Partial<SanityConfiguration | ClientConfig>>
+  additionalClients?: Record<string, Partial<MinimalClientConfig | SanityClientConfig>>
   /**
    * Configuration for visual editing
    */
@@ -201,26 +201,15 @@ export default defineNuxtModule<SanityModuleOptions>({
     }
 
     const runtimeDir = fileURLToPath(new URL('./runtime', import.meta.url))
-    const typesDir = fileURLToPath(new URL('./types', import.meta.url))
     nuxt.options.build.transpile.push(runtimeDir, '@nuxtjs/sanity')
     nuxt.options.build.transpile.push('@sanity/core-loader', '@sanity/preview-url-secret')
 
-    const clientSpecifier = options.minimal ? join(runtimeDir, 'client') : '@sanity/client'
+    const clientSpecifier = options.minimal ? join(runtimeDir, 'minimal-client') : '@sanity/client'
 
     addTemplate({
       filename: 'sanity-client.mjs',
       getContents: () => genExport(clientSpecifier, ['createClient']),
     })
-    addTemplate({
-      filename: 'sanity-config.ts',
-      getContents: () =>
-        genTypeExport(clientSpecifier, [
-          {
-            name: options.minimal ? 'SanityConfiguration' : 'ClientConfig',
-            as: 'SanityConfiguration',
-          },
-        ]),
-    })
 
     if (options.globalHelper) {
       addPlugin({ src: join(runtimeDir, 'plugin') })
@@ -245,7 +234,6 @@ export default defineNuxtModule<SanityModuleOptions>({
     const clientPath = await resolveModule(clientSpecifier)
     nuxt.hook('prepare:types', async ({ tsConfig }) => {
       tsConfig.compilerOptions ||= {}
-      tsConfig.compilerOptions.paths['#sanity-client/types'] = [join(typesDir, 'client')]
       tsConfig.compilerOptions.paths['#sanity-client'] = [clientPath]
       tsConfig.compilerOptions.paths['#sanity-composables'] = [
         join(composablesDir, 'composables'),
@@ -311,11 +299,7 @@ export default defineNuxtModule<SanityModuleOptions>({
         })
         logger.info(`Visual editing enabled globally.`)
       } else {
-        logger.info(
-          `Call ${chalk.bold(
-            'useVisualEditing()',
-          )} in your application to enable visual editing.`,
-        )
+        logger.info(`Call ${chalk.bold('useVisualEditing()')} in your application to enable visual editing.`)
       }
 
       if (options.visualEditing?.draftMode) {
diff --git a/src/runtime/client.ts b/src/runtime/client.ts
index 52db58a7..7c372666 100644
--- a/src/runtime/client.ts
+++ b/src/runtime/client.ts
@@ -1,89 +1,5 @@
-import { $fetch } from 'ofetch'
+import { createClient } from '#sanity-client'
 
-/**
- * Adapted from https://github.com/rexxars/picosanity
- */
-
-const apiHost = 'api.sanity.io'
-const cdnHost = 'apicdn.sanity.io'
-
-
-export interface SanityConfiguration {
-  useCdn?: boolean
-  projectId: string
-  dataset?: string
-  apiVersion: string
-  withCredentials?: boolean
-  token?: string
-  perspective?: 'raw' | 'published' | 'previewDrafts'
-}
-
-const enc = encodeURIComponent
-
-export function getQuery (query: string, params: Record<string, any> = {}) {
-  const baseQs = `?query=${enc(query)}`
-  return Object.keys(params).reduce((current, param) => {
-    return `${current}&${enc(`$${param}`)}=${enc(
-      JSON.stringify(params[param]),
-    )}`
-  }, baseQs)
-}
-
-export const getByteSize = (query: string) =>
-  encodeURI(query).split(/%..|./).length
-
-export function createClient (config: SanityConfiguration) {
-  const {
-    projectId,
-    dataset,
-    apiVersion = '1',
-    withCredentials,
-    token,
-    perspective = 'raw',
-  } = config
-
-  const useCdn = perspective !== 'previewDrafts' && config.useCdn
-
-  const fetchOptions: RequestInit = {
-    credentials: withCredentials ? 'include' : 'omit',
-    headers: {
-      ...(token ? { Authorization: `Bearer ${token}` } : {}),
-      Accept: 'application/json',
-      ...(process.server ? { 'accept-encoding': 'gzip, deflate' } : {}),
-    },
-  }
-
-  return {
-    clone: () =>
-      createClient({
-        useCdn,
-        projectId,
-        dataset,
-        apiVersion,
-        withCredentials,
-        token,
-        perspective,
-      }),
-    /**
-     * Perform a fetch using GROQ syntax.
-     */
-    async fetch<T = unknown> (query: string, params?: Record<string, any>) {
-      const qs = getQuery(query, params)
-      const usePostRequest = getByteSize(qs) > 9000
-
-      const host = useCdn && !usePostRequest ? cdnHost : apiHost
-
-      const urlBase = `https://${projectId}.${host}/v${apiVersion}/data/query/${dataset}`
-
-      const { result } = usePostRequest
-        ? await $fetch<{ result: T }>(urlBase, {
-          ...fetchOptions,
-          method: 'post',
-          body: { query, params },
-          query: { perspective },
-        })
-        : await $fetch<{ result: T }>(`${urlBase}${qs}`, fetchOptions)
-      return result
-    },
-  }
-}
+export type SanityClient = ReturnType<typeof createClient>
+export { createClient } from '#sanity-client'
+export type { ClientConfig } from '#sanity-client'
diff --git a/src/runtime/composables.ts b/src/runtime/composables.ts
index 7dc26832..8b874bdc 100644
--- a/src/runtime/composables.ts
+++ b/src/runtime/composables.ts
@@ -3,8 +3,7 @@ import { hash } from 'ohash'
 import { reactive } from 'vue'
 
 import type { AsyncData, AsyncDataOptions } from 'nuxt/app'
-import type { SanityClient } from '#sanity-client/types'
-import type { SanityConfiguration } from '#build/sanity-config'
+import type { SanityClient, ClientConfig } from './client'
 import {
   useNuxtApp,
   useRuntimeConfig,
@@ -15,12 +14,12 @@ import {
 
 export interface SanityHelper {
   client: SanityClient
-  config: SanityConfiguration
+  config: ClientConfig
   fetch: SanityClient['fetch']
   setToken: (token: string) => void
 }
 
-const createSanityHelper = (options: SanityConfiguration): SanityHelper => {
+const createSanityHelper = (options: ClientConfig): SanityHelper => {
   const config = { ...options }
   let client = createSanityClient(config)
 
@@ -52,7 +51,7 @@ export const useSanity = (client = 'default'): SanityHelper => {
   }
 
   if (client === 'default') {
-    nuxtApp._sanity.default = createSanityHelper(options as SanityConfiguration) // @todo casting
+    nuxtApp._sanity.default = createSanityHelper(options as ClientConfig) // @todo casting
     return nuxtApp._sanity.default
   }
 
diff --git a/src/runtime/minimal-client.ts b/src/runtime/minimal-client.ts
new file mode 100644
index 00000000..de721ffe
--- /dev/null
+++ b/src/runtime/minimal-client.ts
@@ -0,0 +1,91 @@
+import { $fetch } from 'ofetch'
+
+/**
+ * Adapted from https://github.com/rexxars/picosanity
+ */
+
+const apiHost = 'api.sanity.io'
+const cdnHost = 'apicdn.sanity.io'
+
+export interface ClientConfig {
+  useCdn?: boolean
+  projectId: string
+  dataset?: string
+  apiVersion: string
+  withCredentials?: boolean
+  token?: string
+  perspective?: 'raw' | 'published' | 'previewDrafts'
+}
+
+/** @deprecated Prefer `ClientConfig` instead - this will be removed in a future version. */
+export interface SanityConfiguration extends ClientConfig {}
+
+const enc = encodeURIComponent
+
+export function getQuery (query: string, params: Record<string, any> = {}) {
+  const baseQs = `?query=${enc(query)}`
+  return Object.keys(params).reduce((current, param) => {
+    return `${current}&${enc(`$${param}`)}=${enc(
+      JSON.stringify(params[param]),
+    )}`
+  }, baseQs)
+}
+
+export const getByteSize = (query: string) =>
+  encodeURI(query).split(/%..|./).length
+
+export function createClient (config: ClientConfig) {
+  const {
+    projectId,
+    dataset,
+    apiVersion = '1',
+    withCredentials,
+    token,
+    perspective = 'raw',
+  } = config
+
+  const useCdn = perspective !== 'previewDrafts' && config.useCdn
+
+  const fetchOptions: RequestInit = {
+    credentials: withCredentials ? 'include' : 'omit',
+    headers: {
+      ...(token ? { Authorization: `Bearer ${token}` } : {}),
+      Accept: 'application/json',
+      ...(process.server ? { 'accept-encoding': 'gzip, deflate' } : {}),
+    },
+  }
+
+  return {
+    clone: () =>
+      createClient({
+        useCdn,
+        projectId,
+        dataset,
+        apiVersion,
+        withCredentials,
+        token,
+        perspective,
+      }),
+    /**
+     * Perform a fetch using GROQ syntax.
+     */
+    async fetch<T = unknown> (query: string, params?: Record<string, any>) {
+      const qs = getQuery(query, params)
+      const usePostRequest = getByteSize(qs) > 9000
+
+      const host = useCdn && !usePostRequest ? cdnHost : apiHost
+
+      const urlBase = `https://${projectId}.${host}/v${apiVersion}/data/query/${dataset}`
+
+      const { result } = usePostRequest
+        ? await $fetch<{ result: T }>(urlBase, {
+          ...fetchOptions,
+          method: 'post',
+          body: { query, params },
+          query: { perspective },
+        })
+        : await $fetch<{ result: T }>(`${urlBase}${qs}`, fetchOptions)
+      return result
+    },
+  }
+}
diff --git a/src/runtime/nitro-imports.ts b/src/runtime/nitro-imports.ts
index 56d42475..dd3f328f 100644
--- a/src/runtime/nitro-imports.ts
+++ b/src/runtime/nitro-imports.ts
@@ -1,15 +1,16 @@
 import { defu } from 'defu'
 
-import type { SanityConfiguration } from '#build/sanity-config'
 import type { SanityHelper } from '#sanity-composables'
 
 import { useRuntimeConfig } from '#imports'
-import { createClient } from '#sanity-client'
+
+import type { ClientConfig } from './client'
+import { createClient } from './client'
 
 const clients: Record<string, SanityHelper> = {}
 const $config = useRuntimeConfig()
 
-const createSanityHelper = (options: SanityConfiguration): SanityHelper => {
+const createSanityHelper = (options: ClientConfig): SanityHelper => {
   const config = { ...options }
   let client = createClient(config)
 
@@ -37,7 +38,7 @@ export const useSanity = (client = 'default'): SanityHelper => {
   } = defu($config.sanity, $config.public.sanity)
 
   if (client === 'default') {
-    clients.default = createSanityHelper(options as SanityConfiguration) // @todo casting
+    clients.default = createSanityHelper(options as ClientConfig) // @todo casting
     return clients.default
   }
 
diff --git a/src/runtime/visual-editing/composables.ts b/src/runtime/visual-editing/composables.ts
index efe1ba66..15146e2a 100644
--- a/src/runtime/visual-editing/composables.ts
+++ b/src/runtime/visual-editing/composables.ts
@@ -1,30 +1,19 @@
 import { defu } from 'defu'
 import { hash } from 'ohash'
-import { type Ref, reactive } from 'vue'
-import {
-  createQueryStore as createCoreQueryStore,
-  type QueryStore,
-  type QueryStoreState,
-} from '@sanity/core-loader'
-import {
-  defineEncodeDataAttribute,
-  type EncodeDataAttributeFunction,
-} from '@sanity/core-loader/encode-data-attribute'
-import type {
-  ClientPerspective,
-  ContentSourceMap,
-  QueryParams,
-} from '@sanity/client'
+import { reactive } from 'vue'
+import { createQueryStore as createCoreQueryStore } from '@sanity/core-loader'
+import { defineEncodeDataAttribute } from '@sanity/core-loader/encode-data-attribute'
 import { enableVisualEditing } from '@sanity/visual-editing'
+
+import type { Ref } from 'vue'
+import type { QueryStore, QueryStoreState } from '@sanity/core-loader'
+import type { EncodeDataAttributeFunction } from '@sanity/core-loader/encode-data-attribute'
+import type { ClientPerspective, ContentSourceMap, QueryParams } from '@sanity/client'
+
 import type { AsyncData, AsyncDataOptions } from 'nuxt/app'
-import type { SanityConfiguration } from '#build/sanity-config'
-import type { SanityClient } from '#sanity-client/types'
-import {
-  createSanityClient,
-  useNuxtApp,
-  useRuntimeConfig,
-  useAsyncData,
-} from '#imports'
+import type { ClientConfig, SanityClient } from '../client'
+
+import { createSanityClient, useNuxtApp, useRuntimeConfig, useAsyncData } from '#imports'
 
 export interface SanityVisualEditingConfiguration {
   draftMode:
@@ -39,7 +28,7 @@ export interface SanityVisualEditingConfiguration {
   draftModeId?: string
 }
 
-export interface SanityHelperConfiguration extends SanityConfiguration {
+export interface SanityHelperConfiguration extends ClientConfig {
   visualEditing?: SanityVisualEditingConfiguration
 }
 
@@ -162,7 +151,7 @@ export const useSanity = (client = 'default'): SanityHelper => {
     nuxtApp._sanity.default = createSanityHelper({
       ...options,
       visualEditing: visualEditing || undefined,
-    } as SanityConfiguration) // @todo casting
+    } as ClientConfig) // @todo casting
     return nuxtApp._sanity.default
   }
 
diff --git a/src/types/client.ts b/src/types/client.ts
deleted file mode 100644
index 869db7ee..00000000
--- a/src/types/client.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-import { createClient } from '#sanity-client'
-
-export type SanityClient = ReturnType<typeof createClient>
diff --git a/test/unit/client.test.ts b/test/unit/client.test.ts
index b44f0501..e81dbb9f 100644
--- a/test/unit/client.test.ts
+++ b/test/unit/client.test.ts
@@ -1,6 +1,6 @@
 import { afterEach, describe, it, vi, expect } from 'vitest'
 import { $fetch } from 'ofetch'
-import { getQuery, createClient } from '../../src/runtime/client'
+import { getQuery, createClient } from '../../src/runtime/minimal-client'
 import { request as largeRequest } from './fixture/large-request.json'
 
 vi.mock('ofetch', () => ({
diff --git a/test/unit/helpers.test.ts b/test/unit/helpers.test.ts
index e79f9613..4fa0905d 100644
--- a/test/unit/helpers.test.ts
+++ b/test/unit/helpers.test.ts
@@ -1,5 +1,5 @@
 import { expect, describe, it } from 'vitest'
-import { getByteSize } from '../../src/runtime/client'
+import { getByteSize } from '../../src/runtime/minimal-client'
 
 const behaviour = async () => {
   const variable = 'description'

From 287b7033a4f0a766ee896cacb59516df97b37430 Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Sun, 18 Feb 2024 21:24:19 +0000
Subject: [PATCH 07/15] fix: await redirect

---
 src/runtime/visual-editing/draft/disable.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/runtime/visual-editing/draft/disable.ts b/src/runtime/visual-editing/draft/disable.ts
index 163ca364..91027c8a 100644
--- a/src/runtime/visual-editing/draft/disable.ts
+++ b/src/runtime/visual-editing/draft/disable.ts
@@ -2,5 +2,5 @@ import { defineEventHandler, deleteCookie, sendRedirect } from 'h3'
 
 export default defineEventHandler(async event => {
   deleteCookie(event, '__sanity_draft')
-  sendRedirect(event, '/')
+  await sendRedirect(event, '/')
 })

From 7b6a91bf8ed652c23383ad7180a65af48257d318 Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Sun, 18 Feb 2024 21:29:33 +0000
Subject: [PATCH 08/15] chore: single line

---
 src/runtime/composables.ts | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/src/runtime/composables.ts b/src/runtime/composables.ts
index 8b874bdc..f5ed5719 100644
--- a/src/runtime/composables.ts
+++ b/src/runtime/composables.ts
@@ -4,13 +4,7 @@ import { reactive } from 'vue'
 
 import type { AsyncData, AsyncDataOptions } from 'nuxt/app'
 import type { SanityClient, ClientConfig } from './client'
-import {
-  useNuxtApp,
-  useRuntimeConfig,
-  useAsyncData,
-  useLazyAsyncData,
-  createSanityClient,
-} from '#imports'
+import { useNuxtApp, useRuntimeConfig, useAsyncData, useLazyAsyncData, createSanityClient } from '#imports'
 
 export interface SanityHelper {
   client: SanityClient

From 01520e6415c38ea4283cd30f5685a9999fba6bd0 Mon Sep 17 00:00:00 2001
From: rdunk <rupert@rupertdunk.com>
Date: Tue, 5 Mar 2024 17:40:39 +0000
Subject: [PATCH 09/15] feat: support refresh api

---
 package.json                                 |   2 +-
 playground/cms/package.json                  |   4 +-
 playground/cms/sanity.config.ts              |   8 +-
 pnpm-lock.yaml                               | 628 ++++++++++++++-----
 src/module.ts                                |   3 +-
 src/runtime/visual-editing/composables.ts    |  63 +-
 src/runtime/visual-editing/plugins/client.ts |   1 +
 7 files changed, 516 insertions(+), 193 deletions(-)

diff --git a/package.json b/package.json
index 98407167..a3cd7513 100755
--- a/package.json
+++ b/package.json
@@ -51,7 +51,7 @@
     "@portabletext/types": "^2.0.8",
     "@sanity/core-loader": "^1.4.0",
     "@sanity/preview-url-secret": "^1.6.0",
-    "@sanity/visual-editing": "^1.3.1",
+    "@sanity/visual-editing": "^1.5.2",
     "chalk": "^5.3.0",
     "defu": "^6.1.3",
     "knitwork": "^1.0.0",
diff --git a/playground/cms/package.json b/playground/cms/package.json
index dd6400d4..1d20a6ea 100644
--- a/playground/cms/package.json
+++ b/playground/cms/package.json
@@ -19,11 +19,11 @@
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "react-icons": "^4.12.0",
-    "sanity": "3.23.4",
+    "sanity": "3.30.1",
     "styled-components": "^6.1.6"
   },
   "devDependencies": {
-    "@sanity/vision": "3.23.4",
+    "@sanity/vision": "3.30.1",
     "@types/react": "18.2.61",
     "@types/styled-components": "5.1.34"
   }
diff --git a/playground/cms/sanity.config.ts b/playground/cms/sanity.config.ts
index a2b3fdd6..3fed30e6 100644
--- a/playground/cms/sanity.config.ts
+++ b/playground/cms/sanity.config.ts
@@ -1,18 +1,18 @@
-import { deskTool } from 'sanity/desk'
+import { structureTool } from 'sanity/structure'
 import { presentationTool } from 'sanity/presentation'
-import { createConfig } from 'sanity'
+import { defineConfig } from 'sanity'
 import { visionTool } from '@sanity/vision'
 import { schemaTypes } from './schemas'
 import { debugSecrets } from '@sanity/preview-url-secret/sanity-plugin-debug-secrets'
 
-export default createConfig({
+export default defineConfig({
   name: 'default',
 
   projectId: 'j1o4tmjp',
   dataset: 'production',
 
   plugins: [
-    deskTool(),
+    structureTool(),
     visionTool(),
     presentationTool({
       previewUrl: {
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 5ba5de16..28e2a45f 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -21,13 +21,13 @@ importers:
         version: 2.0.8
       '@sanity/core-loader':
         specifier: ^1.4.0
-        version: 1.4.3(@sanity/client@6.13.3)
+        version: 1.4.0(@sanity/client@6.13.3)
       '@sanity/preview-url-secret':
         specifier: ^1.6.0
-        version: 1.6.3(@sanity/client@6.13.3)
+        version: 1.6.0(@sanity/client@6.13.3)
       '@sanity/visual-editing':
-        specifier: ^1.3.1
-        version: 1.3.1
+        specifier: ^1.5.2
+        version: 1.5.2
       chalk:
         specifier: ^5.3.0
         version: 5.3.0
@@ -141,15 +141,15 @@ importers:
         specifier: ^4.12.0
         version: 4.12.0(react@18.2.0)
       sanity:
-        specifier: 3.23.4
-        version: 3.23.4(@types/react@18.2.61)(react-dom@18.2.0)(react@18.2.0)(styled-components@6.1.6)
+        specifier: 3.30.1
+        version: 3.30.1(@types/react@18.2.61)(react-dom@18.2.0)(react@18.2.0)(styled-components@6.1.6)
       styled-components:
         specifier: ^6.1.6
         version: 6.1.6(react-dom@18.2.0)(react@18.2.0)
     devDependencies:
       '@sanity/vision':
-        specifier: 3.23.4
-        version: 3.23.4(@babel/runtime@7.23.7)(@codemirror/lint@6.4.2)(@codemirror/state@6.4.0)(@codemirror/theme-one-dark@6.1.2)(@lezer/common@1.2.0)(codemirror@6.0.1)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6)
+        specifier: 3.30.1
+        version: 3.30.1(@babel/runtime@7.23.7)(@codemirror/lint@6.4.2)(@codemirror/theme-one-dark@6.1.2)(@lezer/common@1.2.0)(codemirror@6.0.1)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6)
       '@types/react':
         specifier: 18.2.61
         version: 18.2.61
@@ -501,6 +501,15 @@ packages:
     resolution: {integrity: sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==}
     dev: true
 
+  /@bjoerge/mutiny@0.5.3:
+    resolution: {integrity: sha512-QBEeUmc5K6kzut0uurwBtJhJW2fc/KEdKhST2/71Ln6V3j4b4qzK1/OeDsUHAt/RM2Dxe5TjWNn82r6WzmrAIQ==}
+    engines: {node: '>=18'}
+    dependencies:
+      diff-match-patch: 1.0.5
+      hotscript: 1.0.13
+      nanoid: 5.0.6
+    dev: false
+
   /@cloudflare/kv-asset-handler@0.3.0:
     resolution: {integrity: sha512-9CB/MKf/wdvbfkUdfrj+OkEwZ5b7rws0eogJ4293h+7b6KX5toPwym+VQKmILafNB9YiehqY0DlNrDcDhdWHSQ==}
     dependencies:
@@ -1314,25 +1323,28 @@ packages:
     dependencies:
       '@floating-ui/utils': 0.1.6
 
-  /@floating-ui/dom@1.5.3:
-    resolution: {integrity: sha512-ClAbQnEqJAKCJOEbbLo5IUlZHkNszqhuxS4fHAVxRPXPya6Ysf2G8KypnYcOTpx6I8xcgF9bbHb6g/2KpbV8qA==}
+  /@floating-ui/dom@1.6.3:
+    resolution: {integrity: sha512-RnDthu3mzPlQ31Ss/BTwQ1zjzIhr3lk1gZB1OC56h/1vEtaXkESrOqL5fQVMfXpwGtRwX+YsZBdyHtJMQnkArw==}
     dependencies:
       '@floating-ui/core': 1.5.2
-      '@floating-ui/utils': 0.1.6
+      '@floating-ui/utils': 0.2.1
 
-  /@floating-ui/react-dom@2.0.4(react-dom@18.2.0)(react@18.2.0):
-    resolution: {integrity: sha512-CF8k2rgKeh/49UrnIBs4BdxPUV6vize/Db1d/YbCLyp9GiVZ0BEwf5AiDSxJRCr6yOkGqTFHtmrULxkEfYZ7dQ==}
+  /@floating-ui/react-dom@2.0.8(react-dom@18.2.0)(react@18.2.0):
+    resolution: {integrity: sha512-HOdqOt3R3OGeTKidaLvJKcgg75S6tibQ3Tif4eyd91QnIJWr0NLvoXFpJA/j8HqkFSL68GDca9AuyWEHlhyClw==}
     peerDependencies:
       react: '>=16.8.0'
       react-dom: '>=16.8.0'
     dependencies:
-      '@floating-ui/dom': 1.5.3
+      '@floating-ui/dom': 1.6.3
       react: 18.2.0
       react-dom: 18.2.0(react@18.2.0)
 
   /@floating-ui/utils@0.1.6:
     resolution: {integrity: sha512-OfX7E2oUDYxtBvsuS4e/jSn4Q9Qb6DzgeYtsAdkPZ47znpoNsMgZw0+tVijiv3uGNR6dgNlty6r9rzIzHjtd/A==}
 
+  /@floating-ui/utils@0.2.1:
+    resolution: {integrity: sha512-9TANp6GPoMtYzQdt54kfAyMmz1+osLlXdg2ENroU7zzrtflTLrrC/lgrIfaSe+Wu0b89GKccT7vxXA0MoAIO+Q==}
+
   /@humanwhocodes/config-array@0.11.13:
     resolution: {integrity: sha512-JSBDMiDKSzQVngfRjOdFXgFfklaXI4K9nLF49Auh21lmBWRLIK3+xTErTWD4KU54pb6coM6ESE7Awz/FNU3zgQ==}
     engines: {node: '>=10.10.0'}
@@ -2670,65 +2682,69 @@ packages:
       rxjs: 7.8.1
     dev: false
 
-  /@sanity/block-tools@3.23.4:
-    resolution: {integrity: sha512-ep6VEcAQJVZvrEWTT92w7qmPmYhXqcvCXYqbaizaSEHPE41g4slZ2/qQTeSW07Qh57rVAK5lWqRogbH00Ml6Ig==}
+  /@sanity/block-tools@3.30.1:
+    resolution: {integrity: sha512-g0w0Tm5yE8zfJWGE0pPjgPCDo9ccEbKBrsJoQFnnQOEkBhBGs077m7A1EfprNPn3lFmp1rPCkYoLz4JALJiRUQ==}
     dependencies:
       get-random-values-esm: 1.0.0
       lodash: 4.17.21
     dev: false
 
-  /@sanity/cli@3.23.4:
-    resolution: {integrity: sha512-wt6GROBl2M+OHVLbErs2ubFOy8Z1i3H3cmDoQPmKNIJfzPv2FG2cPviMmgfS9xDtjLiSfapcypAu8mYSJWGopg==}
+  /@sanity/cli@3.30.1:
+    resolution: {integrity: sha512-9j+HhV1bYel5A7uO8Dk8cbNziJHm0gHAUDo1kiJ+hVlXPaDqZXc6OnYL37jnyHA6V6DJzsugWDY5BnrjXwCrNw==}
     engines: {node: '>=18'}
     hasBin: true
     dependencies:
       '@babel/traverse': 7.23.7
-      '@sanity/telemetry': 0.7.5
+      '@sanity/telemetry': 0.7.7
+      '@sanity/util': 3.30.1
       chalk: 4.1.2
+      decompress: 4.2.1
       esbuild: 0.19.11
       esbuild-register: 3.5.0(esbuild@0.19.11)
-      get-it: 8.4.5
+      get-it: 8.4.10
       golden-fleece: 1.0.9
       node-machine-id: 1.1.12
       pkg-dir: 5.0.0
+      semver: 7.5.4
+      validate-npm-package-name: 3.0.0
     transitivePeerDependencies:
       - supports-color
     dev: false
 
-  /@sanity/client@6.11.2:
-    resolution: {integrity: sha512-loJF1MxnRgFL/vq7EPg/zhttzAy8Ka71Ip0zge1ksmzUt3PeEN27ZCnkYj8O7Mt1x9qALbdj+owXWqcNEF/lIA==}
+  /@sanity/client@6.13.3:
+    resolution: {integrity: sha512-oOkce0xovPe0cwiEQeNPlrZugG69GHB+Dn16IlcnlyOp2GEsTD+Hgk29Z/cOhLbxqxGv9URpd0iuR9cTyEM4AQ==}
     engines: {node: '>=14.18'}
     dependencies:
       '@sanity/eventsource': 5.0.1
       '@vercel/stega': 0.1.0
-      get-it: 8.4.5
+      get-it: 8.4.6
       rxjs: 7.8.1
     transitivePeerDependencies:
       - supports-color
-    dev: false
 
-  /@sanity/client@6.13.3:
-    resolution: {integrity: sha512-oOkce0xovPe0cwiEQeNPlrZugG69GHB+Dn16IlcnlyOp2GEsTD+Hgk29Z/cOhLbxqxGv9URpd0iuR9cTyEM4AQ==}
+  /@sanity/client@6.15.1:
+    resolution: {integrity: sha512-WA85uX8FX7PbWyDyQiTsRn75OLt1GNtQPTzlHyNymAfItDgVmbP7Cwk5aH2B+7gMSkAK7wuK9Ea2YyHl7Kl2WA==}
     engines: {node: '>=14.18'}
     dependencies:
       '@sanity/eventsource': 5.0.1
       '@vercel/stega': 0.1.0
-      get-it: 8.4.6
+      get-it: 8.4.10
       rxjs: 7.8.1
     transitivePeerDependencies:
       - supports-color
+    dev: false
 
-  /@sanity/color@3.0.0-beta.9:
-    resolution: {integrity: sha512-Mk7FRDtxz/U2SRlRM0BvUI62jU26W62aYsipaKFt/dk0rOyYa9yzfaojSM/QmW0E4W/nOw74RBA/HrapXUw+2Q==}
+  /@sanity/color@3.0.0:
+    resolution: {integrity: sha512-JLIsloyyn0lhta/JivmYlxlcN7U3dpBNqtH7uAzM9/kPirFxWJ8LAVuF5vxK5JHwTNbgpVy6AmfIss/av7N96w==}
     engines: {node: '>=18.0.0'}
 
-  /@sanity/core-loader@1.4.0(@sanity/client@6.12.3):
+  /@sanity/core-loader@1.4.0(@sanity/client@6.13.3):
     resolution: {integrity: sha512-NSjFFaeYeDX03Dj/ltOgh4SqKsemVWEMHCHQuzbwvmkjGJCmXAFpD3vbq6Ys1eAvBl/SMZeP2Kbzsmv41q9+Ig==}
     engines: {node: '>=18'}
     peerDependencies:
       '@sanity/client': ^6.12.3
     dependencies:
-      '@sanity/client': 6.12.3
+      '@sanity/client': 6.13.3
       async-cache-dedupe: 2.0.0
     dev: false
 
@@ -2737,8 +2753,8 @@ packages:
     engines: {node: '>=14.18'}
     dev: false
 
-  /@sanity/diff@3.23.4:
-    resolution: {integrity: sha512-P4cuk3MG1NOrhTakdp1yH/SlRZKvsRtxXiQjFNHNeKU39ae9ky4zQLWg3bvAaTT7MHTBapnOsZIXfWmMaqId3Q==}
+  /@sanity/diff@3.30.1:
+    resolution: {integrity: sha512-TQIU7j8dZ69eWAT6RnB5LRdV4Kb5lh2rqXU1dUtucwN1+a5F7RfYTIUWOXXQtF6d859m1zY8GYWrCqrEtSAaCw==}
     engines: {node: '>=18'}
     dependencies:
       '@sanity/diff-match-patch': 3.1.1
@@ -2752,13 +2768,14 @@ packages:
       event-source-polyfill: 1.0.31
       eventsource: 2.0.2
 
-  /@sanity/export@3.23.4:
-    resolution: {integrity: sha512-y3o6+zgC70hLIAzc1J5oQDwKut0jtafT/8hPMhHnVCYDFMDlT6LANUDxoK/eIgOSN1Xc/O2d6Ev7fODJMbWgEw==}
+  /@sanity/export@3.30.1:
+    resolution: {integrity: sha512-xCqEB9kwKDyrL3QEGghP6w2tEw3h1cOGiZQ6oid/iXEAFbp3AEBeOKdc8hsFU8zk/Xa7VWjhYuoaKXjKHoYe9g==}
     engines: {node: '>=18'}
     dependencies:
+      '@sanity/util': 3.30.1
       archiver: 5.3.2
-      debug: 3.2.7
-      get-it: 8.4.5
+      debug: 4.3.4
+      get-it: 8.4.10
       lodash: 4.17.21
       mississippi: 4.0.0
       p-queue: 2.4.2
@@ -2772,15 +2789,13 @@ packages:
     resolution: {integrity: sha512-wtMYcV5GIDIhVyF/jjmdwq1GdlK07dRL40XMns73VbrFI7FteRltxv48bhYVZPcLkRXb0SHjpDS/icj9/yzbVA==}
     dev: false
 
-  /@sanity/groq-store@5.3.7(@sanity/client@6.11.2):
-    resolution: {integrity: sha512-wrAr7PKfbdRvfiC5m7unjH4x5XGZV+vMkk/CwrdHRs+39kuWWJvkwhVNRTS6iWTrTMgpMIe/H1kRrkle0PieDQ==}
-    engines: {node: '>=18'}
+  /@sanity/icons@2.10.3(react@18.2.0):
+    resolution: {integrity: sha512-MH4tSSwkqkPx+L2RjG6/Hcsx80OaESQyl9gBSI4adGh6frZxW8kr4+1GymO5lWoi2IOHgjvxln3XT7BlrRqzLA==}
+    engines: {node: '>=14.0.0'}
     peerDependencies:
-      '@sanity/client': ^6.10.0
+      react: ^18
     dependencies:
-      '@sanity/client': 6.11.2
-      mnemonist: 0.39.6
-    dev: false
+      react: 18.2.0
 
   /@sanity/icons@2.8.0(react@18.2.0):
     resolution: {integrity: sha512-Q8aKg+KPJPDLDR+beYZhtB3gYdq7zIyZQZ6HjaB/63KuidHzkIFuhVv8JS/rJNwWOn5lTuzmd+L/+U/Pv3klWw==}
@@ -2795,17 +2810,17 @@ packages:
     engines: {node: '>=10.0.0'}
     dev: false
 
-  /@sanity/import@3.23.4:
-    resolution: {integrity: sha512-r2GIWRNuH52X60cjHOjCf4pXi+ZqayY96CvMYK7Y74jR3oIewK58jDVDxMBEFuCSTZ1dCHY/cth/F9c/tHyiIw==}
+  /@sanity/import@3.30.1:
+    resolution: {integrity: sha512-co+BIKHet+OEEh6pskr6/qHnAXzttgCtN0hluNyjT9lcpxG6AczucXk/LELM9DpPcA2yDONSprLatbzqhsD5zQ==}
     engines: {node: '>=18'}
     dependencies:
       '@sanity/asset-utils': 1.3.0
       '@sanity/generate-help-url': 3.0.0
-      '@sanity/mutator': 3.23.4
+      '@sanity/mutator': 3.30.1
       '@sanity/uuid': 3.0.2
-      debug: 3.2.7
+      debug: 4.3.4
       file-url: 2.0.2
-      get-it: 8.4.5
+      get-it: 8.4.10
       get-uri: 2.0.4
       globby: 10.0.2
       gunzip-maybe: 1.4.2
@@ -2821,42 +2836,59 @@ packages:
       - supports-color
     dev: false
 
-  /@sanity/logos@2.1.4(@sanity/color@3.0.0-beta.9)(react@18.2.0):
+  /@sanity/logos@2.1.4(@sanity/color@3.0.0)(react@18.2.0):
     resolution: {integrity: sha512-d3/i/UQruNl/rlOrHResAFGv/QHsPA8bmL7zD5E0fkexQnGMSQ+g5JonZm59sLZLLi9AwzwH7GSx09HVJ2D4aw==}
     engines: {node: '>=14.0.0'}
     peerDependencies:
       '@sanity/color': ^2.0 || ^3.0 || ^3.0.0-beta
       react: ^18
     dependencies:
-      '@sanity/color': 3.0.0-beta.9
+      '@sanity/color': 3.0.0
       react: 18.2.0
     dev: false
 
-  /@sanity/mutator@3.23.4:
-    resolution: {integrity: sha512-y5XFzzqxkokaykzwCzaaQPO2zeNSxtH2KAxgnhQDVFrgHgGbz3WIxEEImBlWiwy0ZRwKMsv9bFIbvKL/0fd9yQ==}
+  /@sanity/migrate@3.30.1:
+    resolution: {integrity: sha512-+sdR564HxQCa+G0/8DvdNKIQW9QISST7CiFFRMW1SYETZYYRlD4xin2Rj1StA5r9OLITvmq/HF74Uf9Sui35Zg==}
+    engines: {node: '>=18'}
+    dependencies:
+      '@bjoerge/mutiny': 0.5.3
+      '@sanity/client': 6.15.1
+      '@sanity/types': 3.30.1
+      '@sanity/util': 3.30.1
+      arrify: 2.0.1
+      debug: 4.3.4
+      fast-fifo: 1.3.2
+      groq-js: 1.4.3
+      p-map: 7.0.1
+    transitivePeerDependencies:
+      - supports-color
+    dev: false
+
+  /@sanity/mutator@3.30.1:
+    resolution: {integrity: sha512-VF6cbvFALhUvY9dTdAZ6O1GuUmAjUzN0mAKu33L3Q48Zo7pW9rXREDLgHu4KRB5pWPUFZgABmS3SlIlYUy94nw==}
     dependencies:
       '@sanity/diff-match-patch': 3.1.1
       '@sanity/uuid': 3.0.2
-      debug: 3.2.7
+      debug: 4.3.4
       lodash: 4.17.21
     transitivePeerDependencies:
       - supports-color
     dev: false
 
-  /@sanity/portable-text-editor@3.23.4(react-dom@18.2.0)(react@18.2.0)(rxjs@7.8.1)(styled-components@6.1.6):
-    resolution: {integrity: sha512-mWJ3VFOtJIu7n4ptXeENZOcIT/UPkYlErymEGRKAOtYmswc6/lHvfx+QX/PN0E9zcIgGhcgT8/4OH9tkewY7IA==}
+  /@sanity/portable-text-editor@3.30.1(react-dom@18.2.0)(react@18.2.0)(rxjs@7.8.1)(styled-components@6.1.6):
+    resolution: {integrity: sha512-iyph7n7gIsjAnTGLzTBtWUnlZKkZ/4UqIZWPIZBC8R5tFcKTbs3HEoMR9w7uU+mKZdVWYinrCAh30EPg0hYLYw==}
     engines: {node: '>=18'}
     peerDependencies:
       react: ^16.9 || ^17 || ^18
       rxjs: ^7
       styled-components: ^5.2 || ^6
     dependencies:
-      '@sanity/block-tools': 3.23.4
-      '@sanity/schema': 3.23.4
-      '@sanity/types': 3.23.4
-      '@sanity/util': 3.23.4
+      '@sanity/block-tools': 3.30.1
+      '@sanity/schema': 3.30.1
+      '@sanity/types': 3.30.1
+      '@sanity/util': 3.30.1
       debug: 3.2.7
-      is-hotkey: 0.1.8
+      is-hotkey: 0.2.0
       lodash: 4.17.21
       react: 18.2.0
       rxjs: 7.8.1
@@ -2868,70 +2900,57 @@ packages:
       - supports-color
     dev: false
 
-  /@sanity/presentation@1.4.0(@sanity/client@6.11.2)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(sanity@3.23.4)(styled-components@6.1.6):
-    resolution: {integrity: sha512-BDT7I7kfWuwqnOl34p0ytyUFrA+0/WT1zm0daSe0g8X8nKi++7HCa2fEbbRy49EG4tkrvWz14/aEtmiOImvMDw==}
+  /@sanity/presentation@1.11.2(@sanity/client@6.15.1)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6):
+    resolution: {integrity: sha512-WsjLXFhlUb9M/HIPvLyrAoQtwHAog7SqtkHAMajAwdvHRECRVeAQanE2I2Xgutd/bnA5//OqzB34D2pJ23Z6sA==}
     engines: {node: '>=16.14'}
     peerDependencies:
-      '@sanity/client': ^6.10.0
-      react: ^18.2.0
-      react-dom: ^18.2.0
-      sanity: ^3.23.0
-      styled-components: ^5.2 || ^6.1.1
-    peerDependenciesMeta:
-      react:
-        optional: true
-      react-dom:
-        optional: true
-      sanity:
-        optional: true
-      styled-components:
-        optional: true
+      '@sanity/client': ^6.15.0
     dependencies:
-      '@sanity/client': 6.11.2
-      '@sanity/groq-store': 5.3.7(@sanity/client@6.11.2)
-      '@sanity/icons': 2.8.0(react@18.2.0)
-      '@sanity/preview-url-secret': 1.6.0(@sanity/client@6.11.2)
-      '@sanity/ui': 2.0.0-beta.13(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6)
+      '@sanity/client': 6.15.1
+      '@sanity/icons': 2.10.3(react@18.2.0)
+      '@sanity/preview-url-secret': 1.6.4(@sanity/client@6.15.1)
+      '@sanity/ui': 2.0.7(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6)
+      '@sanity/uuid': 3.0.2
       '@types/lodash.isequal': 4.5.8
-      framer-motion: 10.16.16(react-dom@18.2.0)(react@18.2.0)
+      fast-deep-equal: 3.1.3
+      framer-motion: 11.0.8(react-dom@18.2.0)(react@18.2.0)
       lodash.isequal: 4.5.0
-      mendoza: 3.0.3
-      react: 18.2.0
-      react-dom: 18.2.0(react@18.2.0)
+      mendoza: 3.0.5
+      mnemonist: 0.39.8
       rxjs: 7.8.1
-      sanity: 3.23.4(@types/react@18.2.61)(react-dom@18.2.0)(react@18.2.0)(styled-components@6.1.6)
-      styled-components: 6.1.6(react-dom@18.2.0)(react@18.2.0)
       suspend-react: 0.1.3(react@18.2.0)
     transitivePeerDependencies:
+      - react
+      - react-dom
       - react-is
+      - styled-components
     dev: false
 
-  /@sanity/preview-url-secret@1.6.0(@sanity/client@6.11.2):
+  /@sanity/preview-url-secret@1.6.0(@sanity/client@6.13.3):
     resolution: {integrity: sha512-0XCX16w3f/3maxK4RwYY5s7hLXHrDsJeaJFXc2nETxhyG6DUEt5CLyo4mpr6JZ+o31b7crqdgJ11Zd9nVChm+w==}
     engines: {node: '>=18'}
     peerDependencies:
       '@sanity/client': ^6.12.3
     dependencies:
-      '@sanity/client': 6.11.2
+      '@sanity/client': 6.13.3
       '@sanity/uuid': 3.0.2
-      sanity: 3.23.4(@types/react@18.2.61)(react-dom@18.2.0)(react@18.2.0)(styled-components@6.1.6)
     dev: false
 
-  /@sanity/preview-url-secret@1.6.0(@sanity/client@6.12.3):
-    resolution: {integrity: sha512-0XCX16w3f/3maxK4RwYY5s7hLXHrDsJeaJFXc2nETxhyG6DUEt5CLyo4mpr6JZ+o31b7crqdgJ11Zd9nVChm+w==}
+  /@sanity/preview-url-secret@1.6.4(@sanity/client@6.15.1):
+    resolution: {integrity: sha512-iOu6n5Zt7kuWoOYRliS2o/MDDBWcWkrnwwss2tglIBl744RPRkz0yi9qulnpAqMnWrZyIU8fV1yPCdg0RY+olw==}
     engines: {node: '>=18'}
     peerDependencies:
-      '@sanity/client': ^6.12.3
+      '@sanity/client': ^6.14.4
     dependencies:
-      '@sanity/client': 6.12.3
+      '@sanity/client': 6.15.1
       '@sanity/uuid': 3.0.2
     dev: false
 
-  /@sanity/schema@3.23.4:
-    resolution: {integrity: sha512-QjnMmsK78SeVRomOHOgJwUqqxF4XsURLId0nq+BBk5MMHBcm/3tQYhIlRkRowUkM0gJJvECzSPyqoj/e0xnXZw==}
+  /@sanity/schema@3.30.1:
+    resolution: {integrity: sha512-ludRknYuGskFLdKBdUc3tZOmpBpE4Co31l7AiA68pfZ7796SYA15KiTflIJi4ChK/DAJZT2eeXzdk+FnMTwjEA==}
     dependencies:
       '@sanity/generate-help-url': 3.0.0
-      '@sanity/types': 3.23.4
+      '@sanity/types': 3.30.1
       arrify: 1.0.1
       humanize-list: 1.0.1
       leven: 3.1.0
@@ -2941,8 +2960,8 @@ packages:
       - supports-color
     dev: false
 
-  /@sanity/telemetry@0.7.5:
-    resolution: {integrity: sha512-lY1Lmt2zl9YIIXO2bAFGXR542ovpn8jmLmIos1mQU4D+ItbZsPBxt9g72bJCsUZ7yodMf2K4t4Tp7BTv0as9sg==}
+  /@sanity/telemetry@0.7.7:
+    resolution: {integrity: sha512-YUoAMrl0XEf5C4Jt0n+wmJAR7gDrraic3u7yxog0U2QukgeOn9BDhXF5rF9jMuDllGZmUbBaFq+mh5sW/tACWw==}
     engines: {node: '>=16.0.0'}
     dependencies:
       lodash: 4.17.21
@@ -2952,17 +2971,17 @@ packages:
       typeid-js: 0.3.0
     dev: false
 
-  /@sanity/types@3.23.4:
-    resolution: {integrity: sha512-v3EN73ECxlwHAScOhQhSnnfpZf62LX8vN62V3m6tY7+Umnc9XwKUoTtKiMQUKJy4XuZgarot3kM4/6GfB9Y3Mg==}
+  /@sanity/types@3.30.1:
+    resolution: {integrity: sha512-JrFYZQJShRpmDrhLfoUGU+szhCV1brU/ufS+HZWkfRZB/QeClLkvOwwhi90LQdm+3BD3G/3QvdqzLnfbi9BZiQ==}
     dependencies:
-      '@sanity/client': 6.13.3
+      '@sanity/client': 6.15.1
       '@types/react': 18.2.61
     transitivePeerDependencies:
       - supports-color
     dev: false
 
-  /@sanity/ui@2.0.0-beta.13(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6):
-    resolution: {integrity: sha512-neMMdrcUtcfLnzmRRrqLgdVOHpBqmFeN8wM2tu9fVOEDexXyL/CHFrOYlGG+A7JL6BJbOQxaryeFvmFKskZ2cA==}
+  /@sanity/ui@2.0.7(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6):
+    resolution: {integrity: sha512-Z8V92PHrQayzqh+3NHo0mBmZoFvO/CufYtkd6L83yKaPwq19aDXd5aW3bc7vS99zze1Z+T7BVG75/K6sPGf0hA==}
     engines: {node: '>=14.0.0'}
     peerDependencies:
       react: ^18
@@ -2970,24 +2989,26 @@ packages:
       react-is: ^18
       styled-components: ^5.2 || ^6
     dependencies:
-      '@floating-ui/react-dom': 2.0.4(react-dom@18.2.0)(react@18.2.0)
-      '@sanity/color': 3.0.0-beta.9
-      '@sanity/icons': 2.8.0(react@18.2.0)
+      '@floating-ui/react-dom': 2.0.8(react-dom@18.2.0)(react@18.2.0)
+      '@sanity/color': 3.0.0
+      '@sanity/icons': 2.10.3(react@18.2.0)
       csstype: 3.1.3
-      framer-motion: 10.16.16(react-dom@18.2.0)(react@18.2.0)
+      framer-motion: 11.0.8(react-dom@18.2.0)(react@18.2.0)
       react: 18.2.0
       react-dom: 18.2.0(react@18.2.0)
       react-is: 18.2.0
       react-refractor: 2.1.7(react@18.2.0)
       styled-components: 6.1.6(react-dom@18.2.0)(react@18.2.0)
 
-  /@sanity/util@3.23.4:
-    resolution: {integrity: sha512-ehWW1GifZVJxacyBDaiORogvD7Nzp1/WjzWCtRZ/Gjlt1kXJl4B7ESwPsbOtwRLGBnVB1wHcl7HsCStxEd5aqg==}
+  /@sanity/util@3.30.1:
+    resolution: {integrity: sha512-GLld25WE9+mbXM+hAhLyTbuMuxBRUCAf2i8HqMFSThHj9IVZI3BTRnDvtbLXrkfbSXok71NdrbcUb/M60Bj8tQ==}
     engines: {node: '>=18'}
     dependencies:
-      '@sanity/types': 3.23.4
+      '@sanity/client': 6.15.1
+      '@sanity/types': 3.30.1
       get-random-values-esm: 1.0.0
       moment: 2.30.1
+      rxjs: 7.8.1
     transitivePeerDependencies:
       - supports-color
     dev: false
@@ -2999,8 +3020,8 @@ packages:
       uuid: 8.3.2
     dev: false
 
-  /@sanity/vision@3.23.4(@babel/runtime@7.23.7)(@codemirror/lint@6.4.2)(@codemirror/state@6.4.0)(@codemirror/theme-one-dark@6.1.2)(@lezer/common@1.2.0)(codemirror@6.0.1)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6):
-    resolution: {integrity: sha512-R4eDoJLrFCaFosivAY3cKDlHVv1XGadZ7lfLYi9EjSaPsnaTRiu+QGtJ+NoAtdghEzLdSYLPL0H1FSWDHmeaJQ==}
+  /@sanity/vision@3.30.1(@babel/runtime@7.23.7)(@codemirror/lint@6.4.2)(@codemirror/theme-one-dark@6.1.2)(@lezer/common@1.2.0)(codemirror@6.0.1)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6):
+    resolution: {integrity: sha512-wRKRjxEFLkXM+YRS7QovuN0iTpDKTBTxZ8tsTBSDM9O8Yy/cBNdOFSkMORgoJG7EJzPDrMnByogtmKzyN15p5Q==}
     peerDependencies:
       react: ^18
       styled-components: ^5.2 || ^6
@@ -3010,17 +3031,18 @@ packages:
       '@codemirror/lang-javascript': 6.2.1
       '@codemirror/language': 6.10.0
       '@codemirror/search': 6.5.5
+      '@codemirror/state': 6.4.0
       '@codemirror/view': 6.23.0
       '@juggle/resize-observer': 3.4.0
       '@lezer/highlight': 1.2.0
       '@rexxars/react-json-inspector': 8.0.1(react@18.2.0)
       '@rexxars/react-split-pane': 0.1.93(react-dom@18.2.0)(react@18.2.0)
-      '@sanity/color': 3.0.0-beta.9
+      '@sanity/color': 3.0.0
       '@sanity/icons': 2.8.0(react@18.2.0)
-      '@sanity/ui': 2.0.0-beta.13(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6)
+      '@sanity/ui': 2.0.7(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6)
       '@uiw/react-codemirror': 4.21.21(@babel/runtime@7.23.7)(@codemirror/autocomplete@6.11.1)(@codemirror/language@6.10.0)(@codemirror/lint@6.4.2)(@codemirror/search@6.5.5)(@codemirror/state@6.4.0)(@codemirror/theme-one-dark@6.1.2)(@codemirror/view@6.23.0)(codemirror@6.0.1)(react-dom@18.2.0)(react@18.2.0)
       hashlru: 2.3.0
-      is-hotkey: 0.1.8
+      is-hotkey: 0.2.0
       json5: 2.2.3
       lodash: 4.17.21
       react: 18.2.0
@@ -3028,7 +3050,6 @@ packages:
     transitivePeerDependencies:
       - '@babel/runtime'
       - '@codemirror/lint'
-      - '@codemirror/state'
       - '@codemirror/theme-one-dark'
       - '@lezer/common'
       - codemirror
@@ -3036,6 +3057,26 @@ packages:
       - react-is
     dev: true
 
+  /@sanity/visual-editing@1.5.2:
+    resolution: {integrity: sha512-/eV1AbbvxMxJhgif1NPHptViOKZ2FCp6YDsQRC7A6/6xKDubZ+kFAKiImu2rwF5ZMLYljsWw/xMi20FNRMstlQ==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      '@remix-run/react': '>= 2'
+      next: '>= 13'
+    peerDependenciesMeta:
+      '@remix-run/react':
+        optional: true
+      next:
+        optional: true
+    dependencies:
+      '@vercel/stega': 0.1.0
+      react: 18.2.0
+      react-dom: 18.2.0(react@18.2.0)
+      react-is: 18.2.0
+      scroll-into-view-if-needed: 3.1.0
+      valibot: 0.29.0
+    dev: false
+
   /@sigstore/bundle@2.1.0:
     resolution: {integrity: sha512-89uOo6yh/oxaU8AeOUnVrTdVMcGk9Q1hJa7Hkvalc6G3Z3CupWk4Xe9djSgJm9fMkH69s0P0cVHUoKSOemLdng==}
     engines: {node: ^16.14.0 || >=18.0.0}
@@ -3280,6 +3321,12 @@ packages:
   /@types/stylis@4.2.0:
     resolution: {integrity: sha512-n4sx2bqL0mW1tvDf/loQ+aMX7GQD3lc3fkCMC55VFNDu/vBOabO+LTIeXKM14xK0ppk5TUGcWRjiSpIlUpghKw==}
 
+  /@types/tar-stream@3.1.3:
+    resolution: {integrity: sha512-Zbnx4wpkWBMBSu5CytMbrT5ZpMiF55qgM+EpHzR4yIDu7mv52cej8hTkOc6K+LzpkOAbxwn/m7j3iO+/l42YkQ==}
+    dependencies:
+      '@types/node': 20.10.6
+    dev: false
+
   /@types/unist@2.0.10:
     resolution: {integrity: sha512-IfYcSBWE3hLpBg8+X2SEa8LVkJdJEkT2Ese2aaLs3ptGdVtABxndrMaxuFlQ1qdFf9Q5rDvDpxI3WwgvKFAsQA==}
 
@@ -4168,6 +4215,11 @@ packages:
     engines: {node: '>=0.10.0'}
     dev: false
 
+  /arrify@2.0.1:
+    resolution: {integrity: sha512-3duEwti880xqi4eAMN8AyR4a0ByT90zoYdLlevfrvU43vb0YZwZVfxOgxWrLXXXpyugL0hNZc9G6BiB5B3nUug==}
+    engines: {node: '>=8'}
+    dev: false
+
   /assert@2.1.0:
     resolution: {integrity: sha512-eLHpSK/Y4nhMJ07gDaAzoX/XAKS8PSaojml3M0DM4JpV1LAi5JOJ/p6H/XWrl8L+DzVEvVCW1z3vWAaB9oTsQw==}
     dependencies:
@@ -4225,6 +4277,12 @@ packages:
       safe-stable-stringify: 2.4.3
     dev: false
 
+  /async-mutex@0.4.1:
+    resolution: {integrity: sha512-WfoBo4E/TbCX1G95XTjbWTE3X2XLG0m1Xbv2cwOtuPdyH9CZvnaA5nCt1ucjaKEgW2A5IF71hxrRhr83Je5xjA==}
+    dependencies:
+      tslib: 2.6.2
+    dev: false
+
   /async-sema@3.1.1:
     resolution: {integrity: sha512-tLRNUXati5MFePdAk8dw7Qt7DpxPB60ofAgn8WRhW6a2rcimZnYBP9oxHiv0OHy+Wz7kPMG+t4LGdt31+4EmGg==}
 
@@ -4285,6 +4343,13 @@ packages:
   /birpc@0.2.14:
     resolution: {integrity: sha512-37FHE8rqsYM5JEKCnXFyHpBCzvgHEExwVVTq+nUmloInU7l8ezD1TpOhKpS8oe1DTYFqEK27rFZVKG43oTqXRA==}
 
+  /bl@1.2.3:
+    resolution: {integrity: sha512-pvcNpa0UU69UT341rO6AYy4FVAIkUHuZXRIWbq+zHnsVcRzDDjIAhGuuYoi0d//cwIwtt4pkpKycWEfjdV+vww==}
+    dependencies:
+      readable-stream: 2.3.8
+      safe-buffer: 5.2.1
+    dev: false
+
   /bl@4.1.0:
     resolution: {integrity: sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==}
     dependencies:
@@ -4335,9 +4400,24 @@ packages:
       node-releases: 2.0.14
       update-browserslist-db: 1.0.13(browserslist@4.22.2)
 
+  /buffer-alloc-unsafe@1.1.0:
+    resolution: {integrity: sha512-TEM2iMIEQdJ2yjPJoSIsldnleVaAk1oW3DBVUykyOLsEsFmEc9kn+SFFPz+gl54KQNxlDnAwCXosOS9Okx2xAg==}
+    dev: false
+
+  /buffer-alloc@1.2.0:
+    resolution: {integrity: sha512-CFsHQgjtW1UChdXgbyJGtnm+O/uLQeZdtbDo8mfUgYXCHSM1wgrVxXm6bSyrUuErEb+4sYVGCzASBRot7zyrow==}
+    dependencies:
+      buffer-alloc-unsafe: 1.1.0
+      buffer-fill: 1.0.0
+    dev: false
+
   /buffer-crc32@0.2.13:
     resolution: {integrity: sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ==}
 
+  /buffer-fill@1.0.0:
+    resolution: {integrity: sha512-T7zexNBwiiaCOGDg9xNX9PBmjrubblRkENuptryuI64URkXDFum9il/JGL8Lm8wYfAXpredVXXZz7eMHilimiQ==}
+    dev: false
+
   /buffer-from@1.1.2:
     resolution: {integrity: sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==}
 
@@ -4352,6 +4432,10 @@ packages:
     resolution: {integrity: sha512-zhaCDicdLuWN5UbN5IMnFqNMhNfo919sH85y2/ea+5Yg9TsTkeZxpL+JLbp6cgYFS4sRLp3YV4S6yDuqVWHYOw==}
     engines: {node: '>=6'}
 
+  /builtins@1.0.3:
+    resolution: {integrity: sha512-uYBjakWipfaO/bXI7E8rq6kpwHRZK5cNYrUv2OzZSI/FvmdMyXJ2tG9dKcjEC5YHmHpUAwsargWIZNWdxb/bnQ==}
+    dev: false
+
   /builtins@5.0.1:
     resolution: {integrity: sha512-qwVpFEHNfhYJIzNRBvd2C1kyo6jz3ZSMPyyuR47OPdiKWlbYnZNyDWuyR175qDnAJLiCo5fBBqPb3RiXgWlkOQ==}
     dependencies:
@@ -4839,7 +4923,6 @@ packages:
     dependencies:
       loose-envify: 1.4.0
       object-assign: 4.1.1
-    bundledDependencies: false
 
   /create-require@1.1.1:
     resolution: {integrity: sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==}
@@ -5072,6 +5155,59 @@ packages:
     dependencies:
       mimic-response: 3.1.0
 
+  /decompress-tar@4.1.1:
+    resolution: {integrity: sha512-JdJMaCrGpB5fESVyxwpCx4Jdj2AagLmv3y58Qy4GE6HMVjWz1FeVQk1Ct4Kye7PftcdOo/7U7UKzYBJgqnGeUQ==}
+    engines: {node: '>=4'}
+    dependencies:
+      file-type: 5.2.0
+      is-stream: 1.1.0
+      tar-stream: 1.6.2
+    dev: false
+
+  /decompress-tarbz2@4.1.1:
+    resolution: {integrity: sha512-s88xLzf1r81ICXLAVQVzaN6ZmX4A6U4z2nMbOwobxkLoIIfjVMBg7TeguTUXkKeXni795B6y5rnvDw7rxhAq9A==}
+    engines: {node: '>=4'}
+    dependencies:
+      decompress-tar: 4.1.1
+      file-type: 6.2.0
+      is-stream: 1.1.0
+      seek-bzip: 1.0.6
+      unbzip2-stream: 1.4.3
+    dev: false
+
+  /decompress-targz@4.1.1:
+    resolution: {integrity: sha512-4z81Znfr6chWnRDNfFNqLwPvm4db3WuZkqV+UgXQzSngG3CEKdBkw5jrv3axjjL96glyiiKjsxJG3X6WBZwX3w==}
+    engines: {node: '>=4'}
+    dependencies:
+      decompress-tar: 4.1.1
+      file-type: 5.2.0
+      is-stream: 1.1.0
+    dev: false
+
+  /decompress-unzip@4.0.1:
+    resolution: {integrity: sha512-1fqeluvxgnn86MOh66u8FjbtJpAFv5wgCT9Iw8rcBqQcCo5tO8eiJw7NNTrvt9n4CRBVq7CstiS922oPgyGLrw==}
+    engines: {node: '>=4'}
+    dependencies:
+      file-type: 3.9.0
+      get-stream: 2.3.1
+      pify: 2.3.0
+      yauzl: 2.10.0
+    dev: false
+
+  /decompress@4.2.1:
+    resolution: {integrity: sha512-e48kc2IjU+2Zw8cTb6VZcJQ3lgVbS4uuB1TfCHbiZIP/haNXm+SVyhu+87jts5/3ROpd82GSVCoNs/z8l4ZOaQ==}
+    engines: {node: '>=4'}
+    dependencies:
+      decompress-tar: 4.1.1
+      decompress-tarbz2: 4.1.1
+      decompress-targz: 4.1.1
+      decompress-unzip: 4.0.1
+      graceful-fs: 4.2.11
+      make-dir: 1.3.0
+      pify: 2.3.0
+      strip-dirs: 2.1.0
+    dev: false
+
   /deep-eql@4.1.3:
     resolution: {integrity: sha512-WaEtAOpRA1MQ0eohqZjpGD8zdI0Ovsm8mmFhaDN8dvDZzyoUMcYDnf5Y6iu7HTXxf8JDS23qWa4a+hKCDyOPzw==}
     engines: {node: '>=6'}
@@ -5185,6 +5321,10 @@ packages:
       dequal: 2.0.3
     dev: true
 
+  /diff-match-patch@1.0.5:
+    resolution: {integrity: sha512-IayShXAgj/QMXgB0IWmKx+rOPuGMhqm5w6jvFxmVenXKIzRqTAAsbBPT3kWQeGANj3jGgvcvv4yK6SxqYmikgw==}
+    dev: false
+
   /diff-sequences@29.6.3:
     resolution: {integrity: sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==}
     engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0}
@@ -5743,12 +5883,33 @@ packages:
     dependencies:
       reusify: 1.0.4
 
+  /fd-slicer@1.1.0:
+    resolution: {integrity: sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g==}
+    dependencies:
+      pend: 1.2.0
+    dev: false
+
   /file-entry-cache@6.0.1:
     resolution: {integrity: sha512-7Gps/XWymbLk2QLYK4NzpMOrYjMhdIxXuIvy2QBsLE6ljuodKvdkWs/cpyJJ3CVIVpH0Oi1Hvg1ovbMzLdFBBg==}
     engines: {node: ^10.12.0 || >=12.0.0}
     dependencies:
       flat-cache: 3.2.0
 
+  /file-type@3.9.0:
+    resolution: {integrity: sha512-RLoqTXE8/vPmMuTI88DAzhMYC99I8BWv7zYP4A1puo5HIjEJ5EX48ighy4ZyKMG9EDXxBgW6e++cn7d1xuFghA==}
+    engines: {node: '>=0.10.0'}
+    dev: false
+
+  /file-type@5.2.0:
+    resolution: {integrity: sha512-Iq1nJ6D2+yIO4c8HHg4fyVb8mAJieo1Oloy1mLLaB2PvezNedhBVm+QU7g0qM42aiMbRXTxKKwGD17rjKNJYVQ==}
+    engines: {node: '>=4'}
+    dev: false
+
+  /file-type@6.2.0:
+    resolution: {integrity: sha512-YPcTBDV+2Tm0VqjybVd32MHdlEGAtuxS3VAYsumFokDSMG+ROT5wawGlnHDoz7bfMcMDt9hxuXvXwoKUx2fkOg==}
+    engines: {node: '>=4'}
+    dev: false
+
   /file-uri-to-path@1.0.0:
     resolution: {integrity: sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==}
 
@@ -5855,8 +6016,8 @@ packages:
   /fraction.js@4.3.7:
     resolution: {integrity: sha512-ZsDfxO51wGAXREY55a7la9LScWpwv9RxIrYABrlvOFBlH/ShPnrtsXeuUIfXKKOVicNxQ+o8JTbJvjS4M89yew==}
 
-  /framer-motion@10.16.16(react-dom@18.2.0)(react@18.2.0):
-    resolution: {integrity: sha512-je6j91rd7NmUX7L1XHouwJ4v3R+SO4umso2LUcgOct3rHZ0PajZ80ETYZTajzEXEl9DlKyzjyt4AvGQ+lrebOw==}
+  /framer-motion@11.0.8(react-dom@18.2.0)(react@18.2.0):
+    resolution: {integrity: sha512-1KSGNuqe1qZkS/SWQlDnqK2VCVzRVEoval379j0FiUBJAZoqgwyvqFkfvJbgW2IPFo4wX16K+M0k5jO23lCIjA==}
     peerDependencies:
       react: ^18.0.0
       react-dom: ^18.0.0
@@ -5972,26 +6133,8 @@ packages:
       hasown: 2.0.0
     dev: true
 
-  /get-it@8.4.4:
-    resolution: {integrity: sha512-Pu3pnJfnYuLEhwJgMlFqk19ugvtazzTxh7rg8wATaBL4c5Fy4ahM5B+bGdluiNSNYYK89F5vSa+N3sTa/qqtlg==}
-    engines: {node: '>=14.0.0'}
-    dependencies:
-      debug: 4.3.4
-      decompress-response: 7.0.0
-      follow-redirects: 1.15.4(debug@4.3.4)
-      into-stream: 6.0.0
-      is-plain-object: 5.0.0
-      is-retry-allowed: 2.2.0
-      is-stream: 2.0.1
-      parse-headers: 2.0.5
-      progress-stream: 2.0.0
-      tunnel-agent: 0.6.0
-    transitivePeerDependencies:
-      - supports-color
-    dev: false
-
-  /get-it@8.4.5:
-    resolution: {integrity: sha512-hOoAwSfJXy86QJPEsZFDtBsFBagyTAlYwLJkKZJN5q7ppXRQjq0Wies4d14icDSpVs7QVm4Wtt0XQzjxXlUdgg==}
+  /get-it@8.4.10:
+    resolution: {integrity: sha512-yFcSKM8qyGvycYPcnoQGYC3mxeUxXnlQnA+2DF5TyrEHWN2G5pirXylJX+/AyCQrpctEWu/163fS0g0tFnhYcw==}
     engines: {node: '>=14.0.0'}
     dependencies:
       debug: 4.3.4
@@ -6041,6 +6184,14 @@ packages:
       global: 4.4.0
     dev: false
 
+  /get-stream@2.3.1:
+    resolution: {integrity: sha512-AUGhbbemXxrZJRD5cDvKtQxLuYaIbNtDTK8YqupCI393Q2KSTreEsLUN3ZxAWFGiKTzL6nKuzfcIvieflUX9qA==}
+    engines: {node: '>=0.10.0'}
+    dependencies:
+      object-assign: 4.1.1
+      pinkie-promise: 2.0.1
+    dev: false
+
   /get-stream@5.2.0:
     resolution: {integrity: sha512-nBF+F1rAZVCu/p7rjzgA+Yb4lfYXrpl7a6VmJrU8wF9I1CKvP/QwPNZHnOlwbTkY6dvtFIzFMSyQXbLoTQPRpA==}
     engines: {node: '>=8'}
@@ -6236,6 +6387,11 @@ packages:
     engines: {node: '>= 14'}
     dev: false
 
+  /groq-js@1.4.3:
+    resolution: {integrity: sha512-h2vFXJ/U5VX9bzlqqZLgx/XS0ibNJza4eMxUjZTqkpe3gKafFIJSkMP0RS/XEQR18gJMjXAJNziWdY7JYYfl7w==}
+    engines: {node: '>= 14'}
+    dev: false
+
   /gunzip-maybe@1.4.2:
     resolution: {integrity: sha512-4haO1M4mLO91PW57BMsDFf75UmwoRX0GkdD+Faw+Lr+r/OZrOCS0pIBwOL1xCKQqnQzbNFGgK2V2CpBUPeFNTw==}
     hasBin: true
@@ -6446,6 +6602,10 @@ packages:
     dependencies:
       lru-cache: 10.1.0
 
+  /hotscript@1.0.13:
+    resolution: {integrity: sha512-C++tTF1GqkGYecL+2S1wJTfoH6APGAsbb7PAWQ3iVIwgG/EFseAfEVOKFgAFq4yK3+6j1EjUD4UQ9dRJHX/sSQ==}
+    dev: false
+
   /html-encoding-sniffer@4.0.0:
     resolution: {integrity: sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ==}
     engines: {node: '>=18'}
@@ -6758,12 +6918,8 @@ packages:
     resolution: {integrity: sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==}
     dev: true
 
-  /is-hotkey@0.1.8:
-    resolution: {integrity: sha512-qs3NZ1INIS+H+yeo7cD9pDfwYV/jqRh1JG9S9zYrNudkoUQg7OL7ziXqRKu+InFjUIDoP2o6HIkLYMh1pcWgyQ==}
-
   /is-hotkey@0.2.0:
     resolution: {integrity: sha512-UknnZK4RakDmTgz4PI1wIph5yxSs/mvChWs9ifnlXsKuXgWmOkY/hAE0H/k2MIqH0RlRye0i1oC07MCRSD28Mw==}
-    dev: false
 
   /is-inside-container@1.0.0:
     resolution: {integrity: sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==}
@@ -6793,6 +6949,10 @@ packages:
       define-properties: 1.2.1
     dev: true
 
+  /is-natural-number@4.0.1:
+    resolution: {integrity: sha512-Y4LTamMe0DDQIIAlaer9eKebAlDSV6huy+TWhJVPlzZh2o4tRP5SQWFlLn5N0To4mDD22/qdOq+veo1cSISLgQ==}
+    dev: false
+
   /is-number@7.0.0:
     resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
     engines: {node: '>=0.12.0'}
@@ -6844,6 +7004,11 @@ packages:
     dependencies:
       protocols: 2.0.1
 
+  /is-stream@1.1.0:
+    resolution: {integrity: sha512-uQPm8kcs47jx38atAcWTVxyltQYoPT68y9aWYdV6yWXSyW8mzSat0TL6CiWdZeCdF3KrAvpVtnHbTv4RN+rqdQ==}
+    engines: {node: '>=0.10.0'}
+    dev: false
+
   /is-stream@2.0.1:
     resolution: {integrity: sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==}
     engines: {node: '>=8'}
@@ -7324,6 +7489,13 @@ packages:
       source-map-js: 1.0.2
     dev: true
 
+  /make-dir@1.3.0:
+    resolution: {integrity: sha512-2w31R7SJtieJJnQtGc7RVL2StM2vGYVfqUOvUDxH6bC6aJTxPxTF0GnIgCyu7tjockiUWAYQRbxa7vKn34s5sQ==}
+    engines: {node: '>=4'}
+    dependencies:
+      pify: 3.0.0
+    dev: false
+
   /make-dir@3.1.0:
     resolution: {integrity: sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw==}
     engines: {node: '>=8'}
@@ -7517,6 +7689,11 @@ packages:
     engines: {node: '>=14.18'}
     dev: false
 
+  /mendoza@3.0.5:
+    resolution: {integrity: sha512-kLFy+/zIZXcVZUV0YfsB9RyI/TUuk+ZjOFT6WWVW7Di4XvAOzaYE16seRY5nFV64JTcvcJAsAQSnLcErPRQgXw==}
+    engines: {node: '>=14.18'}
+    dev: false
+
   /merge-stream@2.0.0:
     resolution: {integrity: sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==}
 
@@ -7974,6 +8151,12 @@ packages:
       obliterator: 2.0.4
     dev: false
 
+  /mnemonist@0.39.8:
+    resolution: {integrity: sha512-vyWo2K3fjrUw8YeeZ1zF0fy6Mu59RHokURlld8ymdUPjMlD9EC9ov1/YPqTgqRvUN9nTr3Gqfz29LYAmu0PHPQ==}
+    dependencies:
+      obliterator: 2.0.4
+    dev: false
+
   /module-alias@2.2.3:
     resolution: {integrity: sha512-23g5BFj4zdQL/b6tor7Ji+QY4pEfNH784BMslY9Qb0UnJWRAt+lQGLYmRaM0KDBwIG23ffEBELhZDP2rhi9f/Q==}
     dev: false
@@ -8020,6 +8203,12 @@ packages:
     engines: {node: ^14 || ^16 || >=18}
     hasBin: true
 
+  /nanoid@5.0.6:
+    resolution: {integrity: sha512-rRq0eMHoGZxlvaFOUdK1Ev83Bd1IgzzR+WJ3IbDJ7QOSdAxYjlurSPqFs9s4lJg29RT6nPwizFtJhQS6V5xgiA==}
+    engines: {node: ^18 || >=20}
+    hasBin: true
+    dev: false
+
   /natural-compare@1.4.0:
     resolution: {integrity: sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==}
 
@@ -8648,6 +8837,11 @@ packages:
     dependencies:
       aggregate-error: 3.1.0
 
+  /p-map@7.0.1:
+    resolution: {integrity: sha512-2wnaR0XL/FDOj+TgpDuRb2KTjLnu3Fma6b1ZUwGY7LcqenMcvP/YFpjpbPKY6WVGsbuJZRuoUz8iPrt8ORnAFw==}
+    engines: {node: '>=18'}
+    dev: false
+
   /p-queue@2.4.2:
     resolution: {integrity: sha512-n8/y+yDJwBjoLQe1GSJbbaYQLTI7QHNZI2+rpmCDbe++WLf9HC3gf6iqj5yfPAV71W4UF3ql5W1+UBPXoXTxng==}
     engines: {node: '>=4'}
@@ -8852,6 +9046,10 @@ packages:
       through2: 2.0.5
     dev: false
 
+  /pend@1.2.0:
+    resolution: {integrity: sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==}
+    dev: false
+
   /perfect-debounce@1.0.0:
     resolution: {integrity: sha512-xCy9V055GLEqoFaHoC1SoLIaLmWctgCUaBaWxDZ7/Zx4CTyX7cJQLJOok/orfjZAh9kEYpjJa4d0KcJmCbctZA==}
 
@@ -8872,6 +9070,16 @@ packages:
     hasBin: true
     dev: true
 
+  /pify@2.3.0:
+    resolution: {integrity: sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==}
+    engines: {node: '>=0.10.0'}
+    dev: false
+
+  /pify@3.0.0:
+    resolution: {integrity: sha512-C3FsVNH1udSEX48gGX1xfvwTWfsYWj5U+8/uK15BGzIGrKoUpghX8hWZwa/OFnakBiiVNmBvemTJR5mcy7iPcg==}
+    engines: {node: '>=4'}
+    dev: false
+
   /pinceau@0.18.9(postcss@8.4.32):
     resolution: {integrity: sha512-GJ+l8a5Y+7PP/diwuajJhd2QONTIFkk2YXjrVTh7QKC3sMQEphpLH6ZJfXSeeSonQ0/BnhrrMi9a5e14mmqXug==}
     dependencies:
@@ -8901,6 +9109,18 @@ packages:
       - supports-color
     dev: true
 
+  /pinkie-promise@2.0.1:
+    resolution: {integrity: sha512-0Gni6D4UcLTbv9c57DfxDGdr41XfgUjqWZu492f0cIGr16zDU06BWP/RAEvOuo7CQ0CNjHaLlM59YJJFm3NWlw==}
+    engines: {node: '>=0.10.0'}
+    dependencies:
+      pinkie: 2.0.4
+    dev: false
+
+  /pinkie@2.0.4:
+    resolution: {integrity: sha512-MnUuEycAemtSaeFSjXKW/aroV7akBbY+Sv+RkyqFjgAe73F+MR0TBWKBRDkmfWq/HiFmdavfZ1G7h4SPZXaCSg==}
+    engines: {node: '>=0.10.0'}
+    dev: false
+
   /pirates@4.0.6:
     resolution: {integrity: sha512-saLsH7WeYYPiD25LDuLRRY/i+6HaPYr6G1OUlN39otzkSTxKnubR9RTxS3/Kk50s1g2JTgFwWQDQyplC5/SHZg==}
     engines: {node: '>= 6'}
@@ -9949,6 +10169,7 @@ packages:
 
   /safer-buffer@2.1.2:
     resolution: {integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==}
+    requiresBuild: true
 
   /sanity-diff-patch@3.0.2:
     resolution: {integrity: sha512-Vsx6IPuMepvfaX2/jOFuUrJaloHvSmXavS9SL3iJhhIPAu20VfumCtdH5kpKlXKL1pBgCAZhWHXfLC4Fyg7qFg==}
@@ -9957,8 +10178,8 @@ packages:
       '@sanity/diff-match-patch': 3.1.1
     dev: false
 
-  /sanity@3.23.4(@types/react@18.2.61)(react-dom@18.2.0)(react@18.2.0)(styled-components@6.1.6):
-    resolution: {integrity: sha512-KUzyA4+1/bLiL24HQNBMYtOwzZOaKh/dGDZ/Y9FVPsUFr2iyr8Mer6T1e/UT/4Lw2iQB6myfF4IfnEaqdvuWJA==}
+  /sanity@3.30.1(@types/react@18.2.61)(react-dom@18.2.0)(react@18.2.0)(styled-components@6.1.6):
+    resolution: {integrity: sha512-hf/9EwVbNpuVuCQEOn5yWidz0xVTtnarPUCziu5UO6K4FjQjsGQc2GV/FdM2zvW4S6fYUUF0XruxuLkXPtaqgw==}
     engines: {node: '>=18'}
     hasBin: true
     peerDependencies:
@@ -9975,27 +10196,28 @@ packages:
       '@rexxars/react-json-inspector': 8.0.1(react@18.2.0)
       '@sanity/asset-utils': 1.3.0
       '@sanity/bifur-client': 0.3.1
-      '@sanity/block-tools': 3.23.4
-      '@sanity/cli': 3.23.4
-      '@sanity/client': 6.11.2
-      '@sanity/color': 3.0.0-beta.9
-      '@sanity/diff': 3.23.4
+      '@sanity/block-tools': 3.30.1
+      '@sanity/cli': 3.30.1
+      '@sanity/client': 6.15.1
+      '@sanity/color': 3.0.0
+      '@sanity/diff': 3.30.1
       '@sanity/diff-match-patch': 3.1.1
       '@sanity/eventsource': 5.0.1
-      '@sanity/export': 3.23.4
+      '@sanity/export': 3.30.1
       '@sanity/generate-help-url': 3.0.0
       '@sanity/icons': 2.8.0(react@18.2.0)
       '@sanity/image-url': 1.0.2
-      '@sanity/import': 3.23.4
-      '@sanity/logos': 2.1.4(@sanity/color@3.0.0-beta.9)(react@18.2.0)
-      '@sanity/mutator': 3.23.4
-      '@sanity/portable-text-editor': 3.23.4(react-dom@18.2.0)(react@18.2.0)(rxjs@7.8.1)(styled-components@6.1.6)
-      '@sanity/presentation': 1.4.0(@sanity/client@6.11.2)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(sanity@3.23.4)(styled-components@6.1.6)
-      '@sanity/schema': 3.23.4
-      '@sanity/telemetry': 0.7.5
-      '@sanity/types': 3.23.4
-      '@sanity/ui': 2.0.0-beta.13(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6)
-      '@sanity/util': 3.23.4
+      '@sanity/import': 3.30.1
+      '@sanity/logos': 2.1.4(@sanity/color@3.0.0)(react@18.2.0)
+      '@sanity/migrate': 3.30.1
+      '@sanity/mutator': 3.30.1
+      '@sanity/portable-text-editor': 3.30.1(react-dom@18.2.0)(react@18.2.0)(rxjs@7.8.1)(styled-components@6.1.6)
+      '@sanity/presentation': 1.11.2(@sanity/client@6.15.1)(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6)
+      '@sanity/schema': 3.30.1
+      '@sanity/telemetry': 0.7.7
+      '@sanity/types': 3.30.1
+      '@sanity/ui': 2.0.7(react-dom@18.2.0)(react-is@18.2.0)(react@18.2.0)(styled-components@6.1.6)
+      '@sanity/util': 3.30.1
       '@sanity/uuid': 3.0.2
       '@tanstack/react-virtual': 3.0.0-beta.54(react@18.2.0)
       '@types/is-hotkey': 0.1.10
@@ -10003,8 +10225,12 @@ packages:
       '@types/react-is': 18.2.4
       '@types/shallow-equals': 1.0.3
       '@types/speakingurl': 13.0.6
+      '@types/tar-stream': 3.1.3
       '@types/use-sync-external-store': 0.0.5
       '@vitejs/plugin-react': 4.2.1(vite@4.5.1)
+      archiver: 6.0.1
+      arrify: 1.0.1
+      async-mutex: 0.4.1
       chalk: 4.1.2
       chokidar: 3.5.3
       classnames: 2.5.1
@@ -10014,20 +10240,20 @@ packages:
       console-table-printer: 2.12.0
       dataloader: 2.2.2
       date-fns: 2.30.0
-      debug: 3.2.7
+      debug: 4.3.4
       esbuild: 0.19.11
       esbuild-register: 3.5.0(esbuild@0.19.11)
       execa: 2.1.0
       exif-component: 1.0.1
-      framer-motion: 10.16.16(react-dom@18.2.0)(react@18.2.0)
-      get-it: 8.4.4
+      framer-motion: 11.0.8(react-dom@18.2.0)(react@18.2.0)
+      get-it: 8.4.10
       get-random-values-esm: 1.0.0
       groq-js: 1.3.0
       hashlru: 2.3.0
       history: 5.3.0
       i18next: 23.7.13
       import-fresh: 3.3.0
-      is-hotkey: 0.1.8
+      is-hotkey: 0.2.0
       jsdom: 23.0.1
       jsdom-global: 3.0.2(jsdom@23.0.1)
       json-lexer: 1.2.0
@@ -10042,6 +10268,7 @@ packages:
       observable-callback: 1.0.3(rxjs@7.8.1)
       oneline: 1.0.3
       open: 8.4.2
+      p-map: 7.0.1
       pirates: 4.0.6
       pluralize-esm: 9.0.5
       polished: 4.2.2
@@ -10070,6 +10297,7 @@ packages:
       speakingurl: 14.0.1
       styled-components: 6.1.6(react-dom@18.2.0)(react@18.2.0)
       tar-fs: 2.1.1
+      tar-stream: 3.1.7
       use-device-pixel-ratio: 1.1.2(react@18.2.0)
       use-hot-module-reload: 1.0.3(react@18.2.0)
       use-sync-external-store: 1.2.0(react@18.2.0)
@@ -10112,6 +10340,13 @@ packages:
   /scule@1.1.1:
     resolution: {integrity: sha512-sHtm/SsIK9BUBI3EFT/Gnp9VoKfY6QLvlkvAE6YK7454IF8FSgJEAnJpVdSC7K5/pjI5NfxhzBLW2JAfYA/shQ==}
 
+  /seek-bzip@1.0.6:
+    resolution: {integrity: sha512-e1QtP3YL5tWww8uKaOCQ18UxIT2laNBXHjV/S2WYCiK4udiv8lkG89KRIoCjUagnAmCBurjF4zEVX2ByBbnCjQ==}
+    hasBin: true
+    dependencies:
+      commander: 2.20.3
+    dev: false
+
   /semver@5.7.2:
     resolution: {integrity: sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==}
     hasBin: true
@@ -10560,6 +10795,12 @@ packages:
     dependencies:
       ansi-regex: 6.0.1
 
+  /strip-dirs@2.1.0:
+    resolution: {integrity: sha512-JOCxOeKLm2CAS73y/U4ZeZPTkE+gNVCzKt7Eox84Iej1LT/2pTWYpZKJuxwQpvX1LiZb1xokNR7RLfuBAa7T3g==}
+    dependencies:
+      is-natural-number: 4.0.1
+    dev: false
+
   /strip-final-newline@2.0.0:
     resolution: {integrity: sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==}
     engines: {node: '>=6'}
@@ -10695,6 +10936,19 @@ packages:
       tar-stream: 2.2.0
     dev: false
 
+  /tar-stream@1.6.2:
+    resolution: {integrity: sha512-rzS0heiNf8Xn7/mpdSVVSMAWAoy9bfb1WOTYC78Z0UQKeKa/CWS8FOq0lKGNa8DWKAn9gxjCvMLYc5PGXYlK2A==}
+    engines: {node: '>= 0.8.0'}
+    dependencies:
+      bl: 1.2.3
+      buffer-alloc: 1.2.0
+      end-of-stream: 1.4.4
+      fs-constants: 1.0.0
+      readable-stream: 2.3.8
+      to-buffer: 1.1.1
+      xtend: 4.0.2
+    dev: false
+
   /tar-stream@2.2.0:
     resolution: {integrity: sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==}
     engines: {node: '>=6'}
@@ -10713,6 +10967,14 @@ packages:
       fast-fifo: 1.3.2
       streamx: 2.15.6
 
+  /tar-stream@3.1.7:
+    resolution: {integrity: sha512-qJj60CXt7IU1Ffyc3NJMjh6EkuCFej46zUqJ4J7pqYlThyd9bO0XBTmcOIhSzZJVWfsLks0+nle/j538YAW9RQ==}
+    dependencies:
+      b4a: 1.6.4
+      fast-fifo: 1.3.2
+      streamx: 2.15.6
+    dev: false
+
   /tar@6.2.0:
     resolution: {integrity: sha512-/Wo7DcT0u5HUV486xg675HtjNd3BXZ6xDbzsCUZPt5iw8bTQ63bP0Raut3mvro9u+CUyq7YQd8Cx55fsZXxqLQ==}
     engines: {node: '>=10'}
@@ -10759,6 +11021,10 @@ packages:
       readable-stream: 3.6.2
     dev: false
 
+  /through@2.3.8:
+    resolution: {integrity: sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==}
+    dev: false
+
   /tiny-invariant@1.3.1:
     resolution: {integrity: sha512-AD5ih2NlSssTCwsMznbvwMZpJ1cbhkGd2uueNxzv2jDlEeZdU04JQfRnggJQ8DrcVBGjAsCKwFBbDlVNtEMlzw==}
 
@@ -10788,6 +11054,10 @@ packages:
     resolution: {integrity: sha512-KxVu8EYHDPBdUYdKZdKtU2aj2XfEx9AfjXxE/Aj0vT06w2icA09Vus1rh6eSu1y01akYg6BjIK/hxyLJINoMLQ==}
     engines: {node: '>=12'}
 
+  /to-buffer@1.1.1:
+    resolution: {integrity: sha512-lx9B5iv7msuFYE3dytT+KE5tap+rNYw+K4jVkb9R/asAb+pbBSM17jtunHplhBe6RRJdZx3Pn2Jph24O32mOVg==}
+    dev: false
+
   /to-fast-properties@2.0.0:
     resolution: {integrity: sha512-/OaKK0xYrs3DmxRYqL/yDc+FxFUVYhDlXMhRmv3z915w2HF1tnN1omB354j8VUGO/hbRzyD6Y3sA7v7GS/ceog==}
     engines: {node: '>=4'}
@@ -11001,6 +11271,13 @@ packages:
       - supports-color
     dev: true
 
+  /unbzip2-stream@1.4.3:
+    resolution: {integrity: sha512-mlExGW4w71ebDJviH16lQLtZS32VKqsSfk80GCfUlwT/4/hNRFsoscrF/c++9xinkMzECL1uL9DDwXqFWkruPg==}
+    dependencies:
+      buffer: 5.7.1
+      through: 2.3.8
+    dev: false
+
   /uncrypto@0.1.3:
     resolution: {integrity: sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==}
 
@@ -11420,12 +11697,22 @@ packages:
       convert-source-map: 2.0.0
     dev: true
 
+  /valibot@0.29.0:
+    resolution: {integrity: sha512-JhZn08lwZPhAamOCfBwBkv/btQt4KeQhekULPH8crH053zUCLSOGEF2zKExu3bFf245tsj6J1dY0ysd/jUiMIQ==}
+    dev: false
+
   /validate-npm-package-license@3.0.4:
     resolution: {integrity: sha512-DpKm2Ui/xN7/HQKCtpZxoRWBhZ9Z0kqtygG8XCgNQ8ZlDnxuQmWhj566j8fN4Cu3/JmbhsDo7fcAJq4s9h27Ew==}
     dependencies:
       spdx-correct: 3.2.0
       spdx-expression-parse: 3.0.1
 
+  /validate-npm-package-name@3.0.0:
+    resolution: {integrity: sha512-M6w37eVCMMouJ9V/sdPGnC5H4uDr73/+xdq0FBLO3TFFX1+7wiUY6Es328NN+y43tmY+doUdN9g9J21vqB7iLw==}
+    dependencies:
+      builtins: 1.0.3
+    dev: false
+
   /validate-npm-package-name@5.0.0:
     resolution: {integrity: sha512-YuKoXDAhBYxY7SfOKxHBDoSyENFeW5VvIIQp2TGQuit8gpK6MnWaQelBKxso72DoxTZfZdcP3W90LqpSkgPzLQ==}
     engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0}
@@ -12105,6 +12392,13 @@ packages:
       y18n: 5.0.8
       yargs-parser: 21.1.1
 
+  /yauzl@2.10.0:
+    resolution: {integrity: sha512-p4a9I6X6nu6IhoGmBqAcbJy1mlC4j27vEPZX9F4L4/vZT3Lyq1VkFHw/V/PUcB9Buo+DG3iHkT0x3Qya58zc3g==}
+    dependencies:
+      buffer-crc32: 0.2.13
+      fd-slicer: 1.1.0
+    dev: false
+
   /yocto-queue@0.1.0:
     resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==}
     engines: {node: '>=10'}
diff --git a/src/module.ts b/src/module.ts
index 52b71e52..fddf4c12 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -278,7 +278,6 @@ export default defineNuxtModule<SanityModuleOptions>({
       if (isNuxt3()) {
         addImports([
           { name: 'useSanityLiveMode', as: 'useSanityLiveMode', from: join(visualEditingDir, 'composables') },
-          { name: 'useSanityOverlays', as: 'useSanityOverlays', from: join(visualEditingDir, 'composables') },
           { name: 'useSanityVisualEditing', as: 'useSanityVisualEditing', from: join(visualEditingDir, 'composables') },
         ])
       }
@@ -299,7 +298,7 @@ export default defineNuxtModule<SanityModuleOptions>({
         })
         logger.info(`Visual editing enabled globally.`)
       } else {
-        logger.info(`Call ${chalk.bold('useVisualEditing()')} in your application to enable visual editing.`)
+        logger.info(`Call ${chalk.bold('useSanityVisualEditing()')} in your application to enable visual editing.`)
       }
 
       if (options.visualEditing?.draftMode) {
diff --git a/src/runtime/visual-editing/composables.ts b/src/runtime/visual-editing/composables.ts
index 15146e2a..a4977c30 100644
--- a/src/runtime/visual-editing/composables.ts
+++ b/src/runtime/visual-editing/composables.ts
@@ -3,7 +3,7 @@ import { hash } from 'ohash'
 import { reactive } from 'vue'
 import { createQueryStore as createCoreQueryStore } from '@sanity/core-loader'
 import { defineEncodeDataAttribute } from '@sanity/core-loader/encode-data-attribute'
-import { enableVisualEditing } from '@sanity/visual-editing'
+import { enableVisualEditing, type HistoryRefresh, type VisualEditingOptions } from '@sanity/visual-editing'
 
 import type { Ref } from 'vue'
 import type { QueryStore, QueryStoreState } from '@sanity/core-loader'
@@ -40,6 +40,19 @@ export interface SanityHelper {
   queryStore?: QueryStore
 }
 
+export interface VisualEditingProps
+  extends Omit<VisualEditingOptions, 'history' | 'refresh'> {
+  /**
+   * The refresh API allows smarter refresh logic than the default `location.reload()` behavior.
+   * You can call the refreshDefault argument to trigger the default refresh behavior so you don't have to reimplement it.
+   * @alpha until it's shipped in `sanity/presentation`
+   */
+  refresh?: (
+    payload: HistoryRefresh,
+    refreshDefault: () => false | Promise<void>,
+  ) => false | Promise<void>
+}
+
 type AsyncDataRequestStatus = 'idle' | 'pending' | 'success' | 'error'
 interface AsyncDataExecuteOptions {
   _initial?: boolean
@@ -279,7 +292,9 @@ export const useSanityQuery = <T = unknown, E = Error> (
   }) as AsyncSanityData<T | null, E>
 }
 
-export function useSanityLiveMode ({ client = 'default' }: { client?: string }) {
+export function useSanityLiveMode (options?: { client?: string }) {
+  const { client = 'default' } = options || {}
+
   let disable = () => {}
 
   if (import.meta.client) {
@@ -296,12 +311,39 @@ export function useSanityLiveMode ({ client = 'default' }: { client?: string })
   return disable
 }
 
-export function useSanityOverlays () {
+export function useSanityVisualEditing (
+  options: VisualEditingProps = {},
+) {
+  const { zIndex, refresh } = options
+
   let disable = () => {}
 
   if (import.meta.client) {
     const router = useRouter()
     disable = enableVisualEditing({
+      zIndex,
+      // It is unlikely this API will be used as much by Nuxt users, as
+      // implementing fully fledged visual editing is more straightforward
+      // compared with other frameworks
+      refresh: (payload) => {
+        function refreshDefault() {
+          if (payload.source === 'mutation' && payload.livePreviewEnabled) {
+            // If live mode is enabled, the loader should handle updates via
+            // `useQuery`, so we can ignore it here
+            return false
+          }
+          return new Promise<void>((resolve) => {
+            // Nuxt’s data fetching happens on both client and server, therefore
+            // the default refresh mechanism is necessarily more of a brute
+            // force solution. It would be preferable to use something like
+            // `refreshNuxtData` here if we could use it to trigger a refetch of
+            // data using the server Sanity client instance
+            reloadNuxtApp({ ttl: 1000 })
+            resolve()
+          })
+        }
+        return refresh ? refresh(payload, refreshDefault) : refreshDefault()
+      },
       history: {
         subscribe: navigate => {
           router.isReady().then(() => {
@@ -327,21 +369,8 @@ export function useSanityOverlays () {
     })
   }
 
-  onScopeDispose(() => {
-    disable()
-  })
+  onScopeDispose(disable)
 
   return disable
 }
 
-export function useSanityVisualEditing (
-  options: { client?: string } | Array<{ client?: string }> = {},
-) {
-  const _options = Array.isArray(options) ? options : [options]
-
-  useSanityOverlays()
-
-  _options.forEach(option => {
-    useSanityLiveMode(option)
-  })
-}
diff --git a/src/runtime/visual-editing/plugins/client.ts b/src/runtime/visual-editing/plugins/client.ts
index 5ea0b4bb..9a4eb583 100644
--- a/src/runtime/visual-editing/plugins/client.ts
+++ b/src/runtime/visual-editing/plugins/client.ts
@@ -3,4 +3,5 @@ import { defineNuxtPlugin, useSanityVisualEditing } from '#imports'
 
 export default defineNuxtPlugin(() => {
   useSanityVisualEditing()
+  useSanityLiveMode()
 })

From 6f589a84aa4679a5954af1e1b8c08b1baa8ef0a3 Mon Sep 17 00:00:00 2001
From: rdunk <rupert@rupertdunk.com>
Date: Tue, 5 Mar 2024 18:07:14 +0000
Subject: [PATCH 10/15] refactor: use `preview` over `draft`

---
 index.d.ts                                    |  6 ++--
 playground/cms/sanity.config.ts               |  6 ++--
 playground/nuxt.config.js                     |  2 +-
 src/module.ts                                 | 34 +++++++++----------
 src/runtime/visual-editing/composables.ts     |  6 ++--
 src/runtime/visual-editing/plugins/server.ts  |  8 ++---
 .../{draft => preview}/disable.ts             |  2 +-
 .../{draft => preview}/enable.ts              |  2 +-
 8 files changed, 33 insertions(+), 33 deletions(-)
 rename src/runtime/visual-editing/{draft => preview}/disable.ts (78%)
 rename src/runtime/visual-editing/{draft => preview}/enable.ts (90%)

diff --git a/index.d.ts b/index.d.ts
index 6c094815..69dac426 100644
--- a/index.d.ts
+++ b/index.d.ts
@@ -14,7 +14,7 @@ declare module 'nuxt/schema' {
     sanity: {
       visualEditing:
         | {
-            draftMode:
+            previewMode:
               | false
               | {
                   enable: string
@@ -22,7 +22,7 @@ declare module 'nuxt/schema' {
                 }
             mode: 'global' | 'component'
             studioUrl: string
-            draftModeId: string
+            previewModeId: string
             token: string
           }
         | undefined
@@ -42,7 +42,7 @@ declare module 'nuxt/schema' {
       useCdn: boolean
       visualEditing:
         | {
-            draftMode:
+            previewMode:
               | false
               | {
                   enable: string
diff --git a/playground/cms/sanity.config.ts b/playground/cms/sanity.config.ts
index 3fed30e6..3c060cea 100644
--- a/playground/cms/sanity.config.ts
+++ b/playground/cms/sanity.config.ts
@@ -17,9 +17,9 @@ export default defineConfig({
     presentationTool({
       previewUrl: {
         origin: 'http://localhost:3000',
-        draftMode: {
-          enable: '/draft/enable',
-          disable: '/draft/disable',
+        previewMode: {
+          enable: '/preview/enable',
+          disable: '/preview/disable',
         },
       },
     }),
diff --git a/playground/nuxt.config.js b/playground/nuxt.config.js
index da6ff4f0..145ee289 100644
--- a/playground/nuxt.config.js
+++ b/playground/nuxt.config.js
@@ -15,7 +15,7 @@ export default defineNuxtConfig({
     },
     visualEditing: {
       stega: true,
-      draftMode: true,
+      previewMode: true,
       token: process.env.NUXT_SANITY_VISUAL_EDITING_TOKEN,
       studioUrl: 'http://localhost:3333',
     },
diff --git a/src/module.ts b/src/module.ts
index fddf4c12..86e1f3ed 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -28,9 +28,9 @@ import type { ClientConfig as SanityClientConfig, StegaConfig } from '@sanity/cl
 
 export interface SanityModuleVisualEditingOptions {
   /**
-   * Enable draft mode or configure draft endpoints
+   * Enable preview mode or configure preview endpoints
    */
-  draftMode?:
+  previewMode?:
   | boolean
   | {
     enable?: string
@@ -156,10 +156,10 @@ export default defineNuxtModule<SanityModuleOptions>({
 
     // Final resolved configuration
     const visualEditing = options.visualEditing && {
-      draftMode: (options.visualEditing.draftMode
-        ? defu(options.visualEditing.draftMode, {
-          enable: '/draft/enable',
-          disable: '/draft/disable',
+      previewMode: (options.visualEditing.previewMode
+        ? defu(options.visualEditing.previewMode, {
+          enable: '/preview/enable',
+          disable: '/preview/disable',
         })
         : false) as { enable: string; disable: string } | false,
       mode: options.visualEditing.mode || 'global',
@@ -168,7 +168,7 @@ export default defineNuxtModule<SanityModuleOptions>({
 
     nuxt.options.runtimeConfig.sanity = defu(nuxt.options.runtimeConfig.sanity, {
       visualEditing: options.visualEditing && {
-        draftModeId: visualEditing!.draftMode ? crypto.randomBytes(16).toString('hex') : '',
+        previewModeId: visualEditing!.previewMode ? crypto.randomBytes(16).toString('hex') : '',
         token: options.visualEditing.token || '',
       },
     })
@@ -301,27 +301,27 @@ export default defineNuxtModule<SanityModuleOptions>({
         logger.info(`Call ${chalk.bold('useSanityVisualEditing()')} in your application to enable visual editing.`)
       }
 
-      if (options.visualEditing?.draftMode) {
-        const draftRoutes = defu(options.visualEditing.draftMode, {
-          enable: '/draft/enable',
-          disable: '/draft/disable',
+      if (options.visualEditing?.previewMode) {
+        const previewRoutes = defu(options.visualEditing.previewMode, {
+          enable: '/preview/enable',
+          disable: '/preview/disable',
         })
 
-        const draftRoutesDir = join(visualEditingDir, 'draft')
+        const previewRoutesDir = join(visualEditingDir, 'preview')
 
         addServerHandler({
           method: 'get',
-          route: draftRoutes.enable,
-          handler: join(draftRoutesDir, 'enable'),
+          route: previewRoutes.enable,
+          handler: join(previewRoutesDir, 'enable'),
         })
         addServerHandler({
           method: 'get',
-          route: draftRoutes.disable,
-          handler: join(draftRoutesDir, 'disable'),
+          route: previewRoutes.disable,
+          handler: join(previewRoutesDir, 'disable'),
         })
 
         logger.info(
-          `Draft mode enabled. Added routes at: ${Object.values(draftRoutes)
+          `Preview mode enabled. Added routes at: ${Object.values(previewRoutes)
             .map(route => chalk.bold(route))
             .join(', ')}.`,
         )
diff --git a/src/runtime/visual-editing/composables.ts b/src/runtime/visual-editing/composables.ts
index a4977c30..d5e407b7 100644
--- a/src/runtime/visual-editing/composables.ts
+++ b/src/runtime/visual-editing/composables.ts
@@ -16,7 +16,7 @@ import type { ClientConfig, SanityClient } from '../client'
 import { createSanityClient, useNuxtApp, useRuntimeConfig, useAsyncData } from '#imports'
 
 export interface SanityVisualEditingConfiguration {
-  draftMode:
+  previewMode:
   | boolean
   | {
     enable?: string
@@ -25,7 +25,7 @@ export interface SanityVisualEditingConfiguration {
   mode: 'global' | 'component'
   token?: string
   studioUrl: string
-  draftModeId?: string
+  previewModeId?: string
 }
 
 export interface SanityHelperConfiguration extends ClientConfig {
@@ -124,7 +124,7 @@ const createSanityHelper = (
 
   const visualEditingEnabled =
     visualEditing &&
-    (!visualEditing.draftMode || useState('_sanity_visualEditing').value)
+    (!visualEditing.previewMode || useState('_sanity_visualEditing').value)
 
   let queryStore = visualEditingEnabled
     ? createQueryStore(visualEditing, client)
diff --git a/src/runtime/visual-editing/plugins/server.ts b/src/runtime/visual-editing/plugins/server.ts
index d8a83c0c..d9253482 100644
--- a/src/runtime/visual-editing/plugins/server.ts
+++ b/src/runtime/visual-editing/plugins/server.ts
@@ -12,10 +12,10 @@ export default defineNuxtPlugin(() => {
 
   const { visualEditing } = $config.sanity
 
-  if (visualEditing?.draftMode) {
-    const draftModeCookie = useCookie('__sanity_draft')
-    enabled.value = draftModeCookie.value === visualEditing.draftModeId
-  } else if (typeof visualEditing === 'object' && !visualEditing.draftMode) {
+  if (visualEditing?.previewMode) {
+    const previewModeCookie = useCookie('__sanity_preview')
+    enabled.value = previewModeCookie.value === visualEditing.previewModeId
+  } else if (typeof visualEditing === 'object' && !visualEditing.previewMode) {
     enabled.value = true
   }
 })
diff --git a/src/runtime/visual-editing/draft/disable.ts b/src/runtime/visual-editing/preview/disable.ts
similarity index 78%
rename from src/runtime/visual-editing/draft/disable.ts
rename to src/runtime/visual-editing/preview/disable.ts
index 91027c8a..8cde6052 100644
--- a/src/runtime/visual-editing/draft/disable.ts
+++ b/src/runtime/visual-editing/preview/disable.ts
@@ -1,6 +1,6 @@
 import { defineEventHandler, deleteCookie, sendRedirect } from 'h3'
 
 export default defineEventHandler(async event => {
-  deleteCookie(event, '__sanity_draft')
+  deleteCookie(event, '__sanity_preview')
   await sendRedirect(event, '/')
 })
diff --git a/src/runtime/visual-editing/draft/enable.ts b/src/runtime/visual-editing/preview/enable.ts
similarity index 90%
rename from src/runtime/visual-editing/draft/enable.ts
rename to src/runtime/visual-editing/preview/enable.ts
index d6309370..0df73536 100644
--- a/src/runtime/visual-editing/draft/enable.ts
+++ b/src/runtime/visual-editing/preview/enable.ts
@@ -21,7 +21,7 @@ export default defineEventHandler(async event => {
     })
   }
 
-  setCookie(event, '__sanity_draft', $config.sanity.visualEditing!.draftModeId, {
+  setCookie(event, '__sanity_preview', $config.sanity.visualEditing!.previewModeId, {
     httpOnly: true,
     sameSite: process.env.NODE_ENV !== 'development' ? 'none' : 'lax',
     secure: process.env.NODE_ENV !== 'development',

From dbd3f88249602a3ac469ffb597df44bae43a3423 Mon Sep 17 00:00:00 2001
From: rdunk <rupert@rupertdunk.com>
Date: Tue, 5 Mar 2024 18:19:16 +0000
Subject: [PATCH 11/15] feat: support non-loader based visual editing

---
 index.d.ts                                   | 4 ++--
 src/module.ts                                | 9 ++++-----
 src/runtime/visual-editing/composables.ts    | 2 +-
 src/runtime/visual-editing/plugins/client.ts | 6 ++++--
 4 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/index.d.ts b/index.d.ts
index 69dac426..4b5bf977 100644
--- a/index.d.ts
+++ b/index.d.ts
@@ -20,7 +20,7 @@ declare module 'nuxt/schema' {
                   enable: string
                   disable: string
                 }
-            mode: 'global' | 'component'
+            mode: 'loaders' | 'basic' | 'manual'
             studioUrl: string
             previewModeId: string
             token: string
@@ -48,7 +48,7 @@ declare module 'nuxt/schema' {
                   enable: string
                   disable: string
                 }
-            mode: 'global' | 'component'
+            mode: 'loaders' | 'basic' | 'manual'
             studioUrl: string
           }
         | nullish
diff --git a/src/module.ts b/src/module.ts
index 86e1f3ed..afa2c853 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -38,9 +38,9 @@ export interface SanityModuleVisualEditingOptions {
   }
   /**
    * Enable visual editing at app level or per component
-   * @default 'global'
+   * @default 'loaders'
    */
-  mode?: 'global' | 'component'
+  mode?: 'loaders' | 'basic' | 'manual'
   /**
    * Read token for server side queries
    * @required
@@ -162,7 +162,7 @@ export default defineNuxtModule<SanityModuleOptions>({
           disable: '/preview/disable',
         })
         : false) as { enable: string; disable: string } | false,
-      mode: options.visualEditing.mode || 'global',
+      mode: options.visualEditing.mode || 'loaders',
       studioUrl: options.visualEditing.studioUrl || '',
     }
 
@@ -289,8 +289,7 @@ export default defineNuxtModule<SanityModuleOptions>({
       })
 
       if (
-        options.visualEditing.mode === undefined ||
-        options.visualEditing.mode === 'global'
+        options.visualEditing.mode !== 'manual'
       ) {
         addPlugin({
           mode: 'client',
diff --git a/src/runtime/visual-editing/composables.ts b/src/runtime/visual-editing/composables.ts
index d5e407b7..85483b2d 100644
--- a/src/runtime/visual-editing/composables.ts
+++ b/src/runtime/visual-editing/composables.ts
@@ -22,7 +22,7 @@ export interface SanityVisualEditingConfiguration {
     enable?: string
     disable?: string
   }
-  mode: 'global' | 'component'
+  mode: 'loaders' | 'basic' | 'manual'
   token?: string
   studioUrl: string
   previewModeId?: string
diff --git a/src/runtime/visual-editing/plugins/client.ts b/src/runtime/visual-editing/plugins/client.ts
index 9a4eb583..47bac1e8 100644
--- a/src/runtime/visual-editing/plugins/client.ts
+++ b/src/runtime/visual-editing/plugins/client.ts
@@ -1,7 +1,9 @@
 // @ts-ignore
 import { defineNuxtPlugin, useSanityVisualEditing } from '#imports'
 
-export default defineNuxtPlugin(() => {
+export default defineNuxtPlugin((nuxtApp) => {
   useSanityVisualEditing()
-  useSanityLiveMode()
+  if(nuxtApp.$config.public.sanity.visualEditing?.mode !== 'basic') {
+    useSanityLiveMode()
+  }
 })

From fb98654ce45df42a52667780c732e10dbe70ab7a Mon Sep 17 00:00:00 2001
From: rdunk <rupert@rupertdunk.com>
Date: Tue, 5 Mar 2024 18:32:52 +0000
Subject: [PATCH 12/15] refactor: mode naming

---
 index.d.ts                                | 4 ++--
 src/module.ts                             | 6 +++---
 src/runtime/visual-editing/composables.ts | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/index.d.ts b/index.d.ts
index 4b5bf977..e12aac97 100644
--- a/index.d.ts
+++ b/index.d.ts
@@ -20,7 +20,7 @@ declare module 'nuxt/schema' {
                   enable: string
                   disable: string
                 }
-            mode: 'loaders' | 'basic' | 'manual'
+            mode: 'normal' | 'basic' | 'manual'
             studioUrl: string
             previewModeId: string
             token: string
@@ -48,7 +48,7 @@ declare module 'nuxt/schema' {
                   enable: string
                   disable: string
                 }
-            mode: 'loaders' | 'basic' | 'manual'
+            mode: 'normal' | 'basic' | 'manual'
             studioUrl: string
           }
         | nullish
diff --git a/src/module.ts b/src/module.ts
index afa2c853..0f18c977 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -38,9 +38,9 @@ export interface SanityModuleVisualEditingOptions {
   }
   /**
    * Enable visual editing at app level or per component
-   * @default 'loaders'
+   * @default 'normal'
    */
-  mode?: 'loaders' | 'basic' | 'manual'
+  mode?: 'normal' | 'basic' | 'manual'
   /**
    * Read token for server side queries
    * @required
@@ -162,7 +162,7 @@ export default defineNuxtModule<SanityModuleOptions>({
           disable: '/preview/disable',
         })
         : false) as { enable: string; disable: string } | false,
-      mode: options.visualEditing.mode || 'loaders',
+      mode: options.visualEditing.mode || 'normal',
       studioUrl: options.visualEditing.studioUrl || '',
     }
 
diff --git a/src/runtime/visual-editing/composables.ts b/src/runtime/visual-editing/composables.ts
index 85483b2d..bdd97a05 100644
--- a/src/runtime/visual-editing/composables.ts
+++ b/src/runtime/visual-editing/composables.ts
@@ -22,7 +22,7 @@ export interface SanityVisualEditingConfiguration {
     enable?: string
     disable?: string
   }
-  mode: 'loaders' | 'basic' | 'manual'
+  mode: 'normal' | 'basic' | 'manual'
   token?: string
   studioUrl: string
   previewModeId?: string

From f82a1e66308c215be6bac5ecd1fd3d5bae686e01 Mon Sep 17 00:00:00 2001
From: rdunk <rupert@rupertdunk.com>
Date: Tue, 5 Mar 2024 18:36:50 +0000
Subject: [PATCH 13/15] fix: add missing import

---
 src/runtime/visual-editing/plugins/client.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/runtime/visual-editing/plugins/client.ts b/src/runtime/visual-editing/plugins/client.ts
index 47bac1e8..3e998ed9 100644
--- a/src/runtime/visual-editing/plugins/client.ts
+++ b/src/runtime/visual-editing/plugins/client.ts
@@ -1,5 +1,5 @@
 // @ts-ignore
-import { defineNuxtPlugin, useSanityVisualEditing } from '#imports'
+import { defineNuxtPlugin, useSanityVisualEditing, useSanityLiveMode } from '#imports'
 
 export default defineNuxtPlugin((nuxtApp) => {
   useSanityVisualEditing()

From 26360207673e00bebbfa63c5225cced563c8ab40 Mon Sep 17 00:00:00 2001
From: Rupert Dunk <rupert@rupertdunk.com>
Date: Wed, 6 Mar 2024 18:53:31 +0000
Subject: [PATCH 14/15] feat: improve visual editing types, config and defaults

---
 index.d.ts                                   | 12 +++++-
 playground/nuxt.config.js                    |  2 -
 src/module.ts                                | 44 ++++++++++++++------
 src/runtime/visual-editing/composables.ts    | 21 ++++------
 src/runtime/visual-editing/plugins/client.ts | 24 ++++++++---
 src/runtime/visual-editing/plugins/server.ts |  1 -
 6 files changed, 67 insertions(+), 37 deletions(-)

diff --git a/index.d.ts b/index.d.ts
index e12aac97..836464ff 100644
--- a/index.d.ts
+++ b/index.d.ts
@@ -1,5 +1,10 @@
 import type { ClientPerspective, StegaConfig } from '@sanity/client'
 import type { SanityHelper } from '#sanity-composables'
+import type {
+  SanityVisualEditingMode,
+  SanityVisualEditingRefreshHandler,
+  SanityVisualEditingZIndex,
+} from './src/module'
 
 type nullish = null | undefined | void
 
@@ -20,10 +25,11 @@ declare module 'nuxt/schema' {
                   enable: string
                   disable: string
                 }
-            mode: 'normal' | 'basic' | 'manual'
+            mode: SanityVisualEditingMode
             studioUrl: string
             previewModeId: string
             token: string
+            
           }
         | undefined
     }
@@ -48,8 +54,10 @@ declare module 'nuxt/schema' {
                   enable: string
                   disable: string
                 }
-            mode: 'normal' | 'basic' | 'manual'
+            mode: SanityVisualEditingMode,
             studioUrl: string
+            refresh: SanityVisualEditingRefreshHandler,
+            zIndex: SanityVisualEditingZIndex
           }
         | nullish
     }
diff --git a/playground/nuxt.config.js b/playground/nuxt.config.js
index 145ee289..b10489cc 100644
--- a/playground/nuxt.config.js
+++ b/playground/nuxt.config.js
@@ -14,8 +14,6 @@ export default defineNuxtConfig({
       another: {},
     },
     visualEditing: {
-      stega: true,
-      previewMode: true,
       token: process.env.NUXT_SANITY_VISUAL_EDITING_TOKEN,
       studioUrl: 'http://localhost:3333',
     },
diff --git a/src/module.ts b/src/module.ts
index 0f18c977..c9b93166 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -10,7 +10,6 @@ import {
   defineNuxtModule,
   isNuxt2,
   isNuxt3,
-  tryResolveModule,
   requireModule,
   resolveModule,
   useLogger,
@@ -25,6 +24,16 @@ import { name, version } from '../package.json'
 
 import type { ClientConfig as MinimalClientConfig } from './runtime/minimal-client'
 import type { ClientConfig as SanityClientConfig, StegaConfig } from '@sanity/client'
+import { type HistoryRefresh, type VisualEditingOptions } from '@sanity/visual-editing'
+
+export type SanityVisualEditingMode = 'live-visual-editing' | 'visual-editing' | 'custom'
+
+export type SanityVisualEditingRefreshHandler = (
+    payload: HistoryRefresh,
+    refreshDefault: () => false | Promise<void>,
+) => false | Promise<void>
+  
+export type SanityVisualEditingZIndex = VisualEditingOptions['zIndex']
 
 export interface SanityModuleVisualEditingOptions {
   /**
@@ -38,9 +47,9 @@ export interface SanityModuleVisualEditingOptions {
   }
   /**
    * Enable visual editing at app level or per component
-   * @default 'normal'
+   * @default 'live-visual-editing'
    */
-  mode?: 'normal' | 'basic' | 'manual'
+  mode?: SanityVisualEditingMode
   /**
    * Read token for server side queries
    * @required
@@ -48,14 +57,24 @@ export interface SanityModuleVisualEditingOptions {
   token?: string
   /**
    * The URL of the Sanity Studio
-   * @required
    */
   studioUrl?: string
   /**
    * Enable stega
-   * @required
+   * @default false
    */
   stega?: boolean
+  /**
+   * An optional function for overriding the default handling of refresh events
+   * received from the studio. This is generally not need needed if the `mode`
+   * option is set to `live-visual-editing`.
+   */
+  refresh?: SanityVisualEditingRefreshHandler
+  /**
+   * The CSS z-index on the root node that renders overlays
+   * @default 9999999
+   */
+  zIndex?: SanityVisualEditingZIndex
 }
 export type SanityModuleOptions = Partial<MinimalClientConfig | SanityClientConfig> & {
   /** Globally register a $sanity helper throughout your app */
@@ -140,9 +159,6 @@ export default defineNuxtModule<SanityModuleOptions>({
         if (!options.visualEditing.studioUrl) {
           throw new Error(`'studioUrl' is required.`)
         }
-        if (!(await tryResolveModule('@sanity/core-loader'))) {
-          throw new Error(`${chalk.bold('@sanity/core-loader')} is not installed.`)
-        }
         if (options.apiVersion === '1') {
           throw new Error(`The specified API Version must be ${chalk.bold('2021-03-25')} or later.`)
         }
@@ -156,14 +172,16 @@ export default defineNuxtModule<SanityModuleOptions>({
 
     // Final resolved configuration
     const visualEditing = options.visualEditing && {
-      previewMode: (options.visualEditing.previewMode
+      previewMode: (options.visualEditing.previewMode !== false
         ? defu(options.visualEditing.previewMode, {
           enable: '/preview/enable',
           disable: '/preview/disable',
         })
         : false) as { enable: string; disable: string } | false,
-      mode: options.visualEditing.mode || 'normal',
+      mode: options.visualEditing.mode || 'live-visual-editing',
       studioUrl: options.visualEditing.studioUrl || '',
+      refresh: options.visualEditing.refresh,
+      zIndex: options.visualEditing.zIndex,
     }
 
     nuxt.options.runtimeConfig.sanity = defu(nuxt.options.runtimeConfig.sanity, {
@@ -182,7 +200,7 @@ export default defineNuxtModule<SanityModuleOptions>({
         perspective: options.perspective, // has default
         projectId: options.projectId || '',
         stega:
-          (options.visualEditing?.stega === true &&
+          (options.visualEditing && options.visualEditing?.stega !== false &&
             ({
               enabled: true,
               studioUrl: options.visualEditing.studioUrl,
@@ -289,7 +307,7 @@ export default defineNuxtModule<SanityModuleOptions>({
       })
 
       if (
-        options.visualEditing.mode !== 'manual'
+        options.visualEditing.mode !== 'custom'
       ) {
         addPlugin({
           mode: 'client',
@@ -300,7 +318,7 @@ export default defineNuxtModule<SanityModuleOptions>({
         logger.info(`Call ${chalk.bold('useSanityVisualEditing()')} in your application to enable visual editing.`)
       }
 
-      if (options.visualEditing?.previewMode) {
+      if (options.visualEditing?.previewMode !== false) {
         const previewRoutes = defu(options.visualEditing.previewMode, {
           enable: '/preview/enable',
           disable: '/preview/disable',
diff --git a/src/runtime/visual-editing/composables.ts b/src/runtime/visual-editing/composables.ts
index bdd97a05..76d9ed33 100644
--- a/src/runtime/visual-editing/composables.ts
+++ b/src/runtime/visual-editing/composables.ts
@@ -3,7 +3,7 @@ import { hash } from 'ohash'
 import { reactive } from 'vue'
 import { createQueryStore as createCoreQueryStore } from '@sanity/core-loader'
 import { defineEncodeDataAttribute } from '@sanity/core-loader/encode-data-attribute'
-import { enableVisualEditing, type HistoryRefresh, type VisualEditingOptions } from '@sanity/visual-editing'
+import { enableVisualEditing } from '@sanity/visual-editing'
 
 import type { Ref } from 'vue'
 import type { QueryStore, QueryStoreState } from '@sanity/core-loader'
@@ -12,6 +12,7 @@ import type { ClientPerspective, ContentSourceMap, QueryParams } from '@sanity/c
 
 import type { AsyncData, AsyncDataOptions } from 'nuxt/app'
 import type { ClientConfig, SanityClient } from '../client'
+import type { SanityVisualEditingMode, SanityVisualEditingRefreshHandler, SanityVisualEditingZIndex } from '../../module'
 
 import { createSanityClient, useNuxtApp, useRuntimeConfig, useAsyncData } from '#imports'
 
@@ -22,10 +23,12 @@ export interface SanityVisualEditingConfiguration {
     enable?: string
     disable?: string
   }
-  mode: 'normal' | 'basic' | 'manual'
+  mode: SanityVisualEditingMode,
   token?: string
   studioUrl: string
   previewModeId?: string
+  refresh?: SanityVisualEditingRefreshHandler
+  zIndex?: SanityVisualEditingZIndex
 }
 
 export interface SanityHelperConfiguration extends ClientConfig {
@@ -40,17 +43,9 @@ export interface SanityHelper {
   queryStore?: QueryStore
 }
 
-export interface VisualEditingProps
-  extends Omit<VisualEditingOptions, 'history' | 'refresh'> {
-  /**
-   * The refresh API allows smarter refresh logic than the default `location.reload()` behavior.
-   * You can call the refreshDefault argument to trigger the default refresh behavior so you don't have to reimplement it.
-   * @alpha until it's shipped in `sanity/presentation`
-   */
-  refresh?: (
-    payload: HistoryRefresh,
-    refreshDefault: () => false | Promise<void>,
-  ) => false | Promise<void>
+export interface VisualEditingProps {
+  refresh?: SanityVisualEditingRefreshHandler
+  zIndex?: SanityVisualEditingZIndex
 }
 
 type AsyncDataRequestStatus = 'idle' | 'pending' | 'success' | 'error'
diff --git a/src/runtime/visual-editing/plugins/client.ts b/src/runtime/visual-editing/plugins/client.ts
index 3e998ed9..76e342fb 100644
--- a/src/runtime/visual-editing/plugins/client.ts
+++ b/src/runtime/visual-editing/plugins/client.ts
@@ -1,9 +1,21 @@
 // @ts-ignore
-import { defineNuxtPlugin, useSanityVisualEditing, useSanityLiveMode } from '#imports'
+import { defineNuxtPlugin, useSanityVisualEditing, useSanityLiveMode } from '#imports';
 
-export default defineNuxtPlugin((nuxtApp) => {
-  useSanityVisualEditing()
-  if(nuxtApp.$config.public.sanity.visualEditing?.mode !== 'basic') {
-    useSanityLiveMode()
+export default defineNuxtPlugin(() => {
+  const $config = useRuntimeConfig();
+  const { visualEditing } = $config.public.sanity;
+
+  if (
+    visualEditing?.mode === 'live-visual-editing' ||
+    visualEditing?.mode === 'visual-editing'
+  ) {
+    useSanityVisualEditing({
+      refresh: visualEditing?.refresh,
+      zIndex: visualEditing?.zIndex,
+    });
+  }
+
+  if (visualEditing?.mode === 'live-visual-editing') {
+    useSanityLiveMode();
   }
-})
+});
diff --git a/src/runtime/visual-editing/plugins/server.ts b/src/runtime/visual-editing/plugins/server.ts
index d9253482..59c0dfb4 100644
--- a/src/runtime/visual-editing/plugins/server.ts
+++ b/src/runtime/visual-editing/plugins/server.ts
@@ -9,7 +9,6 @@ export default defineNuxtPlugin(() => {
   const enabled = useState('_sanity_visualEditing', () => false)
 
   const $config = useRuntimeConfig()
-
   const { visualEditing } = $config.sanity
 
   if (visualEditing?.previewMode) {

From 85a654f6a24d32b5066196317da04bb59a094ed5 Mon Sep 17 00:00:00 2001
From: Rupert Dunk <rupert@rupertdunk.com>
Date: Wed, 6 Mar 2024 18:53:42 +0000
Subject: [PATCH 15/15] docs: visual editing

---
 .../1.getting-started/2.configuration.md      |  7 ++
 .../1.getting-started/4.visual-editing.md     | 90 +++++++++++++++++++
 2 files changed, 97 insertions(+)
 create mode 100644 docs/content/1.getting-started/4.visual-editing.md

diff --git a/docs/content/1.getting-started/2.configuration.md b/docs/content/1.getting-started/2.configuration.md
index f0961f15..ade2f40f 100644
--- a/docs/content/1.getting-started/2.configuration.md
+++ b/docs/content/1.getting-started/2.configuration.md
@@ -140,3 +140,10 @@ export default defineNuxtConfig({
   },
 })
 ```
+
+### `visualEditing`
+
+- Type: **Object**
+- Default: **undefined**
+
+Used to enable and configure Visual Editing. See the [Visual Editing](/getting-started/visual-editing) section for more details.
\ No newline at end of file
diff --git a/docs/content/1.getting-started/4.visual-editing.md b/docs/content/1.getting-started/4.visual-editing.md
new file mode 100644
index 00000000..46ea5c29
--- /dev/null
+++ b/docs/content/1.getting-started/4.visual-editing.md
@@ -0,0 +1,90 @@
+# Visual Editing
+
+---
+
+## Overview
+
+`@nuxtjs/sanity` provides a simple method of integrating [visual editing](https://www.sanity.io/docs/visual-editing) in your Nuxt application. Before enabling this feature, make sure you have [Presentation](https://www.sanity.io/docs/presentation) installed in your studio.
+
+::alert{type="warning"}
+Installing `@sanity/client` is required for visual editing. The `minimal` client must not be enabled.
+::
+
+## Configuration
+
+You can configure visual editing via the `sanity.visualEditing` key in your Nuxt config. The following options are available:
+
+#### `studioUrl`
+
+- **Required**
+- Type: **string**
+
+The URL of the Sanity Studio with Presentation installed.
+
+#### `token`
+
+- **Required**
+- Type: **string**
+
+A Sanity read token used for server side queries. This is required in order to fetch draft content. This value will not be exposed to the client.
+
+#### `mode`
+
+- Type: **string**
+- Default: **`'live-visual-editing'`**
+
+Accepts one of the following options:
+
+- **`'live-visual-editing'`** - Default behaviour. Lets the module handle setup to provide fully featured visual editing with live updates. Queries should be executed using `useSanityQuery`.
+- **`'visual-editing'`** - Used to enable visual editing without live updates, for example if fetching data using the Sanity client directly. Passing a custom `refresh` handler is recommended, as by default the entire app will refresh to display updates.
+- **`'custom'`** - The module will not handle any setup, instead the `useSanityVisualEditing` and/or `useSanityLiveMode` composables will need to be called manually.
+
+
+#### `previewMode`
+
+- Type: **boolean**, **object**
+- Default: **true**
+
+To enable preview mode with defaults, or optionally configure the endpoints used to enable and disable preview mode. If passing an object, the options that can be provided are:
+
+- `enable` - the path of the enable endpoint, defaults to `/preview/enable`
+- `disable` - the path of the disable endpoint, defaults to `/preview/disable`
+
+#### `stega`
+
+- Type: **boolean**
+- Default: **true**
+
+Used to enable or disable [stega](https://www.sanity.io/docs/loaders-and-overlays#1dbcc04a7093).
+
+
+#### `refresh`
+
+- Type: **function**
+
+An optional function for overriding the default handling of refresh events received from the studio. This is generally not need needed if the `mode` option is set to `live-visual-editing`.
+
+#### `zIndex`
+
+- Type: **number**, **string**
+- Default: **9999999**
+
+The CSS z-index on the root node that renders overlays.
+
+
+### Recommended Configuration
+
+For most use cases, the following minimum `visualEditing` configuration will suffice:
+
+```ts{}[nuxt.config.ts]
+export default defineNuxtConfig({
+  modules: ['@nuxtjs/sanity'],
+  sanity: {
+    // ... Sanity config
+    visualEditing: {
+      token: process.env.NUXT_SANITY_VISUAL_EDITING_TOKEN,
+      studioUrl: process.env.NUXT_SANITY_VISUAL_EDITING_STUDIO_URL,
+    }
+  },
+})
+```
\ No newline at end of file