@nocode-factory/sanity-kit 2.22.1 → 2.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/ncf-kit.mjs +11 -0
- package/dist/index.d.ts +28 -2
- package/dist/index.js +100 -7
- package/dist/index.js.map +1 -1
- package/dist/web.d.ts +31 -1
- package/dist/web.js +39 -3
- package/dist/web.js.map +1 -1
- package/package.json +1 -1
- package/src/form/PublishedHint.tsx +35 -0
- package/src/index.ts +6 -1
- package/src/lib/mainDocuments.ts +72 -0
- package/src/lib/siteRoutes.ts +1 -1
- package/src/tools/navbar/DraftsOnLoad.tsx +25 -0
- package/src/tools/navbar/PreviewLauncher.tsx +2 -0
- package/src/version.ts +1 -1
- package/src/web/index.ts +2 -0
- package/src/web/previewRefresh.ts +60 -0
package/dist/web.d.ts
CHANGED
|
@@ -23,5 +23,35 @@ interface PreviewBannerProps {
|
|
|
23
23
|
* `isPreviewSite()`.
|
|
24
24
|
*/
|
|
25
25
|
export declare function NcfPreviewBanner(props: PreviewBannerProps): import("react").JSX.Element | null;
|
|
26
|
-
|
|
26
|
+
/** Ce que l'édition visuelle de Sanity passe à `refresh` (next-sanity <VisualEditing/>). */
|
|
27
|
+
interface PreviewRefreshPayload {
|
|
28
|
+
source: 'manual' | 'mutation' | string;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Rafraîchissement de l'aperçu (Presentation) à CHAQUE modification faite dans le
|
|
32
|
+
* Studio, regroupée : une rafale de frappes = un seul rafraîchissement.
|
|
33
|
+
*
|
|
34
|
+
* Sans lui, <VisualEditing/> de next-sanity ignore les modifications du Studio et
|
|
35
|
+
* compte sur le signal live, qui ne part pas toujours : un champ remis à sa valeur
|
|
36
|
+
* par défaut (vidé, la pastille bleue) ne s'affichait qu'après un rechargement.
|
|
37
|
+
* Pur et testable : `refresh` et les minuteries sont injectés.
|
|
38
|
+
*/
|
|
39
|
+
export declare function createPreviewRefresh(refresh: () => void, delay?: number, timers?: {
|
|
40
|
+
set: (fn: () => void, ms: number) => unknown;
|
|
41
|
+
clear: (id: unknown) => void;
|
|
42
|
+
}): (payload: PreviewRefreshPayload) => false | Promise<void>;
|
|
43
|
+
/**
|
|
44
|
+
* À passer à <VisualEditing refresh={...}/> (next-sanity), dans un composant client :
|
|
45
|
+
*
|
|
46
|
+
* ```tsx
|
|
47
|
+
* 'use client'
|
|
48
|
+
* import {VisualEditing} from 'next-sanity/visual-editing'
|
|
49
|
+
* import {useNcfPreviewRefresh} from '@nocode-factory/sanity-kit/web'
|
|
50
|
+
* export function PreviewEditing() {
|
|
51
|
+
* return <VisualEditing refresh={useNcfPreviewRefresh()} />
|
|
52
|
+
* }
|
|
53
|
+
* ```
|
|
54
|
+
*/
|
|
55
|
+
export declare function useNcfPreviewRefresh(delay?: number): (payload: PreviewRefreshPayload) => false | Promise<void>;
|
|
56
|
+
export type { PreviewBannerProps, PreviewRefreshPayload };
|
|
27
57
|
//# sourceMappingURL=web.d.ts.map
|
package/dist/web.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
'use client'
|
|
2
|
-
import { useEffect, useState, useSyncExternalStore } from "react";
|
|
2
|
+
import { useCallback, useEffect, useMemo, useState, useSyncExternalStore } from "react";
|
|
3
3
|
import { Fragment, jsx, jsxs } from "react/jsx-runtime";
|
|
4
|
-
import { usePathname } from "next/navigation.js";
|
|
4
|
+
import { usePathname, useRouter } from "next/navigation.js";
|
|
5
5
|
/** Mêmes noms que le garde (`previewGrant.ts`), sans importer de code serveur. */
|
|
6
6
|
const GRANT_PARAM = "ncf_preview", noSubscribe = () => () => {};
|
|
7
7
|
function readGrant() {
|
|
@@ -166,6 +166,42 @@ const anchor = (position) => ({
|
|
|
166
166
|
textDecoration: "underline",
|
|
167
167
|
textUnderlineOffset: 3
|
|
168
168
|
};
|
|
169
|
-
|
|
169
|
+
/**
|
|
170
|
+
* Rafraîchissement de l'aperçu (Presentation) à CHAQUE modification faite dans le
|
|
171
|
+
* Studio, regroupée : une rafale de frappes = un seul rafraîchissement.
|
|
172
|
+
*
|
|
173
|
+
* Sans lui, <VisualEditing/> de next-sanity ignore les modifications du Studio et
|
|
174
|
+
* compte sur le signal live, qui ne part pas toujours : un champ remis à sa valeur
|
|
175
|
+
* par défaut (vidé, la pastille bleue) ne s'affichait qu'après un rechargement.
|
|
176
|
+
* Pur et testable : `refresh` et les minuteries sont injectés.
|
|
177
|
+
*/
|
|
178
|
+
function createPreviewRefresh(refresh, delay = 300, timers = {
|
|
179
|
+
set: (fn, ms) => setTimeout(fn, ms),
|
|
180
|
+
clear: (id) => clearTimeout(id)
|
|
181
|
+
}) {
|
|
182
|
+
let pending = null, waiting = [], flush = () => {
|
|
183
|
+
pending = null, refresh();
|
|
184
|
+
let done = waiting;
|
|
185
|
+
waiting = [], timers.set(() => done.forEach((resolve) => resolve()), 1e3);
|
|
186
|
+
};
|
|
187
|
+
return (payload) => payload.source !== "manual" && payload.source !== "mutation" ? !1 : (pending !== null && timers.clear(pending), pending = timers.set(flush, payload.source === "manual" ? 0 : delay), new Promise((resolve) => waiting.push(resolve)));
|
|
188
|
+
}
|
|
189
|
+
/**
|
|
190
|
+
* À passer à <VisualEditing refresh={...}/> (next-sanity), dans un composant client :
|
|
191
|
+
*
|
|
192
|
+
* ```tsx
|
|
193
|
+
* 'use client'
|
|
194
|
+
* import {VisualEditing} from 'next-sanity/visual-editing'
|
|
195
|
+
* import {useNcfPreviewRefresh} from '@nocode-factory/sanity-kit/web'
|
|
196
|
+
* export function PreviewEditing() {
|
|
197
|
+
* return <VisualEditing refresh={useNcfPreviewRefresh()} />
|
|
198
|
+
* }
|
|
199
|
+
* ```
|
|
200
|
+
*/
|
|
201
|
+
function useNcfPreviewRefresh(delay = 300) {
|
|
202
|
+
let router = useRouter(), handler = useMemo(() => createPreviewRefresh(() => router.refresh(), delay), [router, delay]);
|
|
203
|
+
return useCallback((payload) => handler(payload), [handler]);
|
|
204
|
+
}
|
|
205
|
+
export { NcfPreviewBanner, createPreviewRefresh, useNcfPreviewRefresh };
|
|
170
206
|
|
|
171
207
|
//# sourceMappingURL=web.js.map
|
package/dist/web.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"web.js","names":[],"sources":["../src/web/PreviewBanner.tsx"],"sourcesContent":["'use client'\n\nimport {usePathname} from 'next/navigation'\nimport {useEffect, useState, useSyncExternalStore, type CSSProperties} from 'react'\n\n/** Mêmes noms que le garde (`previewGrant.ts`), sans importer de code serveur. */\nconst GRANT_PARAM = 'ncf_preview'\nconst GRANT_COOKIE = 'ncf_preview_grant'\n\nconst noSubscribe = () => () => {}\nfunction readGrant(): string | null {\n const match = document.cookie.match(new RegExp(`(?:^|; )${GRANT_COOKIE}=([^;]*)`))\n return match?.[1] ? decodeURIComponent(match[1]) : null\n}\n\n/**\n * Page affichée DANS le Studio (Presentation l'encastre dans un iframe) : le\n * Studio a déjà sa propre bascule brouillons / en ligne, le bandeau ferait doublon\n * et masquerait le bas de la page. Faux au rendu serveur (bandeau rendu), vrai\n * dès l'hydratation dans un iframe (bandeau retiré).\n */\nconst readEmbedded = () => {\n try {\n return window.self !== window.top\n } catch {\n // Accès refusé au parent : on est forcément encastré.\n return true\n }\n}\n\n/** Adresse courante avec la clé de préversion (partageable telle quelle). */\nfunction shareableUrl(grant: string): string {\n const url = new URL(window.location.href)\n url.searchParams.set(GRANT_PARAM, grant)\n return url.toString()\n}\n\nexport interface PreviewBannerProps {\n /** Le site affiche-t-il actuellement les brouillons ? */\n isDraft: boolean\n /** Chemin de la route de bascule. Défaut : `/api/draft-mode/toggle`. */\n togglePath?: string\n /** Libellé de l'environnement. Défaut : « Préversion ». */\n label?: string\n position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right'\n}\n\n/**\n * Bandeau des environnements de test : il dit où l'on est, et laisse choisir\n * ce qu'on regarde.\n *\n * Sur une préversion, la question du relecteur est toujours la même :\n * « qu'est-ce qui sortira quand je publierai ? ». Y répondre demande de voir\n * les brouillons sur le vrai site, pas dans un aperçu encastré.\n *\n * Les styles sont en ligne, délibérément. Des classes utilitaires obligeraient\n * chaque site à déclarer ce paquet dans ses globs de scan — une dépendance\n * invisible dont l'oubli ne se verrait qu'à l'exécution, par un bandeau nu.\n *\n * Rendu hors production seulement : c'est à l'appelant de s'en assurer, avec\n * `isPreviewSite()`.\n */\nexport function NcfPreviewBanner(props: PreviewBannerProps) {\n const {isDraft, togglePath = '/api/draft-mode/toggle', label = 'Préversion'} = props\n const pathname = usePathname()\n // Clé de préversion mémorisée par le garde (absente avec une session Presentation).\n const grant = useSyncExternalStore(noSubscribe, readGrant, () => null)\n const [copied, setCopied] = useState(false)\n const embedded = useSyncExternalStore(noSubscribe, readEmbedded, () => false)\n\n // Après une navigation côté client, Next affiche l'URL du lien, sans la clé : on\n // la remet, pour que l'adresse copiée depuis la barre ouvre la préversion chez\n // n'importe qui (un client, sans compte).\n useEffect(() => {\n if (!grant) return\n const url = new URL(window.location.href)\n if (url.searchParams.get(GRANT_PARAM) === grant) return\n url.searchParams.set(GRANT_PARAM, grant)\n window.history.replaceState(window.history.state, '', url.toString())\n }, [grant, pathname])\n\n // Retour de bascule sur la même page, clé comprise.\n const backPath = grant ? `${pathname || '/'}?${GRANT_PARAM}=${encodeURIComponent(grant)}` : pathname || '/'\n const back = encodeURIComponent(backPath)\n\n const share = async () => {\n if (!grant) return\n try {\n await navigator.clipboard.writeText(shareableUrl(grant))\n setCopied(true)\n window.setTimeout(() => setCopied(false), 2000)\n } catch {\n // Presse-papiers refusé : l'adresse de la barre contient déjà la clé.\n }\n }\n\n const href = (enable: boolean) => `${togglePath}?enable=${enable}&redirect=${back}`\n\n // Dans le Studio : rien (voir readEmbedded).\n if (embedded) return null\n\n return (\n <div style={{...anchor(props.position ?? 'bottom-left'), zIndex: 2147483000}}>\n <div style={shell}>\n <span style={{display: 'inline-flex', alignItems: 'center', gap: 6, fontWeight: 500}}>\n {/* Pastille pleine plutôt qu'un caractère décoratif : elle se lit à\n toutes les tailles et ne dépend d'aucune police. */}\n <span aria-hidden style={dot} />\n {label}\n </span>\n\n <span aria-hidden style={divider} />\n <span style={{opacity: 0.75}}>Données</span>\n\n <span role=\"group\" aria-label=\"Données affichées\" style={{display: 'inline-flex', gap: 2}}>\n <a\n href={href(true)}\n title=\"Ce qui sortira après publication\"\n aria-current={isDraft ? 'true' : undefined}\n style={isDraft ? segmentOn : segmentOff}\n >\n Brouillons\n </a>\n <a\n href={href(false)}\n title=\"Ce que voit le public aujourd'hui\"\n aria-current={isDraft ? undefined : 'true'}\n style={isDraft ? segmentOff : segmentOn}\n >\n En ligne\n </a>\n </span>\n\n {grant && (\n <>\n <span aria-hidden style={divider} />\n <button type=\"button\" onClick={share} title=\"Copier l'adresse de cette page, clé de préversion comprise\" style={shareButton}>\n {copied ? 'Lien copié' : 'Copier le lien'}\n </button>\n </>\n )}\n </div>\n </div>\n )\n}\n\nconst anchor = (position: NonNullable<PreviewBannerProps['position']>): CSSProperties => ({\n position: 'fixed',\n ...(position.startsWith('bottom') ? {bottom: 16} : {top: 16}),\n ...(position.endsWith('left') ? {left: 16} : {right: 16}),\n})\n\nconst shell: CSSProperties = {\n display: 'flex',\n alignItems: 'center',\n gap: 10,\n padding: '6px 12px',\n borderRadius: 999,\n // Ambre : la couleur des environnements de test, assez saturée pour ne pas\n // se confondre avec le site, assez sobre pour ne pas le masquer.\n background: '#fef3c7',\n color: '#451a03',\n border: '1px solid #fcd34d',\n boxShadow: '0 4px 16px rgba(0,0,0,0.14)',\n font: '500 12px/1 ui-sans-serif, system-ui, -apple-system, Segoe UI, sans-serif',\n}\n\nconst dot: CSSProperties = {\n width: 7,\n height: 7,\n borderRadius: '50%',\n background: '#d97706',\n flex: 'none',\n}\n\nconst divider: CSSProperties = {width: 1, height: 14, background: '#00000022'}\n\nconst segmentBase: CSSProperties = {\n padding: '4px 10px',\n borderRadius: 999,\n textDecoration: 'none',\n fontSize: 12,\n lineHeight: 1,\n whiteSpace: 'nowrap',\n}\n\nconst segmentOn: CSSProperties = {...segmentBase, background: '#451a03', color: '#fffbeb'}\nconst segmentOff: CSSProperties = {...segmentBase, color: '#451a03', opacity: 0.7}\n\nconst shareButton: CSSProperties = {\n ...segmentBase,\n border: 'none',\n background: 'transparent',\n color: '#451a03',\n cursor: 'pointer',\n font: 'inherit',\n textDecoration: 'underline',\n textUnderlineOffset: 3,\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"web.js","names":[],"sources":["../src/web/PreviewBanner.tsx","../src/web/previewRefresh.ts"],"sourcesContent":["'use client'\n\nimport {usePathname} from 'next/navigation'\nimport {useEffect, useState, useSyncExternalStore, type CSSProperties} from 'react'\n\n/** Mêmes noms que le garde (`previewGrant.ts`), sans importer de code serveur. */\nconst GRANT_PARAM = 'ncf_preview'\nconst GRANT_COOKIE = 'ncf_preview_grant'\n\nconst noSubscribe = () => () => {}\nfunction readGrant(): string | null {\n const match = document.cookie.match(new RegExp(`(?:^|; )${GRANT_COOKIE}=([^;]*)`))\n return match?.[1] ? decodeURIComponent(match[1]) : null\n}\n\n/**\n * Page affichée DANS le Studio (Presentation l'encastre dans un iframe) : le\n * Studio a déjà sa propre bascule brouillons / en ligne, le bandeau ferait doublon\n * et masquerait le bas de la page. Faux au rendu serveur (bandeau rendu), vrai\n * dès l'hydratation dans un iframe (bandeau retiré).\n */\nconst readEmbedded = () => {\n try {\n return window.self !== window.top\n } catch {\n // Accès refusé au parent : on est forcément encastré.\n return true\n }\n}\n\n/** Adresse courante avec la clé de préversion (partageable telle quelle). */\nfunction shareableUrl(grant: string): string {\n const url = new URL(window.location.href)\n url.searchParams.set(GRANT_PARAM, grant)\n return url.toString()\n}\n\nexport interface PreviewBannerProps {\n /** Le site affiche-t-il actuellement les brouillons ? */\n isDraft: boolean\n /** Chemin de la route de bascule. Défaut : `/api/draft-mode/toggle`. */\n togglePath?: string\n /** Libellé de l'environnement. Défaut : « Préversion ». */\n label?: string\n position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right'\n}\n\n/**\n * Bandeau des environnements de test : il dit où l'on est, et laisse choisir\n * ce qu'on regarde.\n *\n * Sur une préversion, la question du relecteur est toujours la même :\n * « qu'est-ce qui sortira quand je publierai ? ». Y répondre demande de voir\n * les brouillons sur le vrai site, pas dans un aperçu encastré.\n *\n * Les styles sont en ligne, délibérément. Des classes utilitaires obligeraient\n * chaque site à déclarer ce paquet dans ses globs de scan — une dépendance\n * invisible dont l'oubli ne se verrait qu'à l'exécution, par un bandeau nu.\n *\n * Rendu hors production seulement : c'est à l'appelant de s'en assurer, avec\n * `isPreviewSite()`.\n */\nexport function NcfPreviewBanner(props: PreviewBannerProps) {\n const {isDraft, togglePath = '/api/draft-mode/toggle', label = 'Préversion'} = props\n const pathname = usePathname()\n // Clé de préversion mémorisée par le garde (absente avec une session Presentation).\n const grant = useSyncExternalStore(noSubscribe, readGrant, () => null)\n const [copied, setCopied] = useState(false)\n const embedded = useSyncExternalStore(noSubscribe, readEmbedded, () => false)\n\n // Après une navigation côté client, Next affiche l'URL du lien, sans la clé : on\n // la remet, pour que l'adresse copiée depuis la barre ouvre la préversion chez\n // n'importe qui (un client, sans compte).\n useEffect(() => {\n if (!grant) return\n const url = new URL(window.location.href)\n if (url.searchParams.get(GRANT_PARAM) === grant) return\n url.searchParams.set(GRANT_PARAM, grant)\n window.history.replaceState(window.history.state, '', url.toString())\n }, [grant, pathname])\n\n // Retour de bascule sur la même page, clé comprise.\n const backPath = grant ? `${pathname || '/'}?${GRANT_PARAM}=${encodeURIComponent(grant)}` : pathname || '/'\n const back = encodeURIComponent(backPath)\n\n const share = async () => {\n if (!grant) return\n try {\n await navigator.clipboard.writeText(shareableUrl(grant))\n setCopied(true)\n window.setTimeout(() => setCopied(false), 2000)\n } catch {\n // Presse-papiers refusé : l'adresse de la barre contient déjà la clé.\n }\n }\n\n const href = (enable: boolean) => `${togglePath}?enable=${enable}&redirect=${back}`\n\n // Dans le Studio : rien (voir readEmbedded).\n if (embedded) return null\n\n return (\n <div style={{...anchor(props.position ?? 'bottom-left'), zIndex: 2147483000}}>\n <div style={shell}>\n <span style={{display: 'inline-flex', alignItems: 'center', gap: 6, fontWeight: 500}}>\n {/* Pastille pleine plutôt qu'un caractère décoratif : elle se lit à\n toutes les tailles et ne dépend d'aucune police. */}\n <span aria-hidden style={dot} />\n {label}\n </span>\n\n <span aria-hidden style={divider} />\n <span style={{opacity: 0.75}}>Données</span>\n\n <span role=\"group\" aria-label=\"Données affichées\" style={{display: 'inline-flex', gap: 2}}>\n <a\n href={href(true)}\n title=\"Ce qui sortira après publication\"\n aria-current={isDraft ? 'true' : undefined}\n style={isDraft ? segmentOn : segmentOff}\n >\n Brouillons\n </a>\n <a\n href={href(false)}\n title=\"Ce que voit le public aujourd'hui\"\n aria-current={isDraft ? undefined : 'true'}\n style={isDraft ? segmentOff : segmentOn}\n >\n En ligne\n </a>\n </span>\n\n {grant && (\n <>\n <span aria-hidden style={divider} />\n <button type=\"button\" onClick={share} title=\"Copier l'adresse de cette page, clé de préversion comprise\" style={shareButton}>\n {copied ? 'Lien copié' : 'Copier le lien'}\n </button>\n </>\n )}\n </div>\n </div>\n )\n}\n\nconst anchor = (position: NonNullable<PreviewBannerProps['position']>): CSSProperties => ({\n position: 'fixed',\n ...(position.startsWith('bottom') ? {bottom: 16} : {top: 16}),\n ...(position.endsWith('left') ? {left: 16} : {right: 16}),\n})\n\nconst shell: CSSProperties = {\n display: 'flex',\n alignItems: 'center',\n gap: 10,\n padding: '6px 12px',\n borderRadius: 999,\n // Ambre : la couleur des environnements de test, assez saturée pour ne pas\n // se confondre avec le site, assez sobre pour ne pas le masquer.\n background: '#fef3c7',\n color: '#451a03',\n border: '1px solid #fcd34d',\n boxShadow: '0 4px 16px rgba(0,0,0,0.14)',\n font: '500 12px/1 ui-sans-serif, system-ui, -apple-system, Segoe UI, sans-serif',\n}\n\nconst dot: CSSProperties = {\n width: 7,\n height: 7,\n borderRadius: '50%',\n background: '#d97706',\n flex: 'none',\n}\n\nconst divider: CSSProperties = {width: 1, height: 14, background: '#00000022'}\n\nconst segmentBase: CSSProperties = {\n padding: '4px 10px',\n borderRadius: 999,\n textDecoration: 'none',\n fontSize: 12,\n lineHeight: 1,\n whiteSpace: 'nowrap',\n}\n\nconst segmentOn: CSSProperties = {...segmentBase, background: '#451a03', color: '#fffbeb'}\nconst segmentOff: CSSProperties = {...segmentBase, color: '#451a03', opacity: 0.7}\n\nconst shareButton: CSSProperties = {\n ...segmentBase,\n border: 'none',\n background: 'transparent',\n color: '#451a03',\n cursor: 'pointer',\n font: 'inherit',\n textDecoration: 'underline',\n textUnderlineOffset: 3,\n}\n","import {useCallback, useMemo} from 'react'\nimport {useRouter} from 'next/navigation'\n\n/** Ce que l'édition visuelle de Sanity passe à `refresh` (next-sanity <VisualEditing/>). */\nexport interface PreviewRefreshPayload {\n source: 'manual' | 'mutation' | string\n}\n\n/**\n * Rafraîchissement de l'aperçu (Presentation) à CHAQUE modification faite dans le\n * Studio, regroupée : une rafale de frappes = un seul rafraîchissement.\n *\n * Sans lui, <VisualEditing/> de next-sanity ignore les modifications du Studio et\n * compte sur le signal live, qui ne part pas toujours : un champ remis à sa valeur\n * par défaut (vidé, la pastille bleue) ne s'affichait qu'après un rechargement.\n * Pur et testable : `refresh` et les minuteries sont injectés.\n */\nexport function createPreviewRefresh(\n refresh: () => void,\n delay = 300,\n timers: {set: (fn: () => void, ms: number) => unknown; clear: (id: unknown) => void} = {\n set: (fn, ms) => setTimeout(fn, ms),\n clear: (id) => clearTimeout(id as ReturnType<typeof setTimeout>),\n },\n): (payload: PreviewRefreshPayload) => false | Promise<void> {\n let pending: unknown = null\n let waiting: (() => void)[] = []\n const flush = () => {\n pending = null\n refresh()\n const done = waiting\n waiting = []\n // Laisse le temps au rendu serveur d'arriver avant d'éteindre l'indicateur.\n timers.set(() => done.forEach((resolve) => resolve()), 1000)\n }\n return (payload) => {\n if (payload.source !== 'manual' && payload.source !== 'mutation') return false\n if (pending !== null) timers.clear(pending)\n pending = timers.set(flush, payload.source === 'manual' ? 0 : delay)\n return new Promise<void>((resolve) => waiting.push(resolve))\n }\n}\n\n/**\n * À passer à <VisualEditing refresh={...}/> (next-sanity), dans un composant client :\n *\n * ```tsx\n * 'use client'\n * import {VisualEditing} from 'next-sanity/visual-editing'\n * import {useNcfPreviewRefresh} from '@nocode-factory/sanity-kit/web'\n * export function PreviewEditing() {\n * return <VisualEditing refresh={useNcfPreviewRefresh()} />\n * }\n * ```\n */\nexport function useNcfPreviewRefresh(delay = 300): (payload: PreviewRefreshPayload) => false | Promise<void> {\n const router = useRouter()\n const handler = useMemo(() => createPreviewRefresh(() => router.refresh(), delay), [router, delay])\n return useCallback((payload: PreviewRefreshPayload) => handler(payload), [handler])\n}\n"],"mappings":";;;;AAMA,MAAM,cAAc,eAGd,0BAA0B,CAAC;AACjC,SAAS,YAA2B;CAClC,IAAM,QAAQ,SAAS,OAAO,MAAM,gBAAI,OAAO,mCAAiC,CAAC;CACjF,OAAO,QAAQ,KAAK,mBAAmB,MAAM,EAAE,IAAI;AACrD;;;;;;;AAQA,MAAM,qBAAqB;CACzB,IAAI;EACF,OAAO,OAAO,SAAS,OAAO;CAChC,QAAQ;EAEN,OAAO;CACT;AACF;;AAGA,SAAS,aAAa,OAAuB;CAC3C,IAAM,MAAM,IAAI,IAAI,OAAO,SAAS,IAAI;CAExC,OADA,IAAI,aAAa,IAAI,aAAa,KAAK,GAChC,IAAI,SAAS;AACtB;;;;;;;;;;;;;;;;AA2BA,SAAgB,iBAAiB,OAA2B;CAC1D,IAAM,EAAC,SAAS,aAAa,0BAA0B,QAAQ,iBAAgB,OACzE,WAAW,YAAY,GAEvB,QAAQ,qBAAqB,aAAa,iBAAiB,IAAI,GAC/D,CAAC,QAAQ,aAAa,SAAS,EAAK,GACpC,WAAW,qBAAqB,aAAa,oBAAoB,EAAK;CAK5E,gBAAgB;EACd,IAAI,CAAC,OAAO;EACZ,IAAM,MAAM,IAAI,IAAI,OAAO,SAAS,IAAI;EACpC,IAAI,aAAa,IAAI,WAAW,MAAM,UAC1C,IAAI,aAAa,IAAI,aAAa,KAAK,GACvC,OAAO,QAAQ,aAAa,OAAO,QAAQ,OAAO,IAAI,IAAI,SAAS,CAAC;CACtE,GAAG,CAAC,OAAO,QAAQ,CAAC;CAGpB,IAAM,WAAW,QAAQ,GAAG,YAAY,IAAI,GAAG,YAAY,GAAG,mBAAmB,KAAK,MAAM,YAAY,KAClG,OAAO,mBAAmB,QAAQ,GAElC,QAAQ,YAAY;EACnB,WACL,IAAI;GAGF,AAFA,MAAM,UAAU,UAAU,UAAU,aAAa,KAAK,CAAC,GACvD,UAAU,EAAI,GACd,OAAO,iBAAiB,UAAU,EAAK,GAAG,GAAI;EAChD,QAAQ,CAER;CACF,GAEM,QAAQ,WAAoB,GAAG,WAAW,UAAU,OAAO,YAAY;CAK7E,OAFI,WAAiB,OAGnB,oBAAC,OAAD;EAAK,OAAO;GAAC,GAAG,OAAO,MAAM,YAAY,aAAa;GAAG,QAAQ;EAAU;EACzE,UAAA,qBAAC,OAAD;GAAK,OAAO;GAAZ,UAAA;IACE,qBAAC,QAAD;KAAM,OAAO;MAAC,SAAS;MAAe,YAAY;MAAU,KAAK;MAAG,YAAY;KAAG;KAAnF,UAAA,CAGE,oBAAC,QAAD;MAAM,eAAA;MAAY,OAAO;KAAM,CAAA,GAC9B,KACG;;IAEN,oBAAC,QAAD;KAAM,eAAA;KAAY,OAAO;IAAU,CAAA;IACnC,oBAAC,QAAD;KAAM,OAAO,EAAC,SAAS,IAAI;KAAG,UAAA;IAAa,CAAA;IAE3C,qBAAC,QAAD;KAAM,MAAK;KAAQ,cAAW;KAAoB,OAAO;MAAC,SAAS;MAAe,KAAK;KAAC;KAAxF,UAAA,CACE,oBAAC,KAAD;MACE,MAAM,KAAK,EAAI;MACf,OAAM;MACN,gBAAc,UAAU,SAAS,KAAA;MACjC,OAAO,UAAU,YAAY;MAC9B,UAAA;KAEE,CAAA,GACH,oBAAC,KAAD;MACE,MAAM,KAAK,EAAK;MAChB,OAAM;MACN,gBAAc,UAAU,KAAA,IAAY;MACpC,OAAO,UAAU,aAAa;MAC/B,UAAA;KAEE,CAAA,CACC;;IAEL,SACC,qBAAA,UAAA,EAAA,UAAA,CACE,oBAAC,QAAD;KAAM,eAAA;KAAY,OAAO;IAAU,CAAA,GACnC,oBAAC,UAAD;KAAQ,MAAK;KAAS,SAAS;KAAO,OAAM;KAA6D,OAAO;KAC7G,UAAA,SAAS,eAAe;IACnB,CAAA,CACR,EAAA,CAAA;GAED;;CACF,CAAA;AAET;AAEA,MAAM,UAAU,cAA0E;CACxF,UAAU;CACV,GAAI,SAAS,WAAW,QAAQ,IAAI,EAAC,QAAQ,GAAE,IAAI,EAAC,KAAK,GAAE;CAC3D,GAAI,SAAS,SAAS,MAAM,IAAI,EAAC,MAAM,GAAE,IAAI,EAAC,OAAO,GAAE;AACzD,IAEM,QAAuB;CAC3B,SAAS;CACT,YAAY;CACZ,KAAK;CACL,SAAS;CACT,cAAc;CAGd,YAAY;CACZ,OAAO;CACP,QAAQ;CACR,WAAW;CACX,MAAM;AACR,GAEM,MAAqB;CACzB,OAAO;CACP,QAAQ;CACR,cAAc;CACd,YAAY;CACZ,MAAM;AACR,GAEM,UAAyB;CAAC,OAAO;CAAG,QAAQ;CAAI,YAAY;AAAW,GAEvE,cAA6B;CACjC,SAAS;CACT,cAAc;CACd,gBAAgB;CAChB,UAAU;CACV,YAAY;CACZ,YAAY;AACd,GAEM,YAA2B;CAAC,GAAG;CAAa,YAAY;CAAW,OAAO;AAAS,GACnF,aAA4B;CAAC,GAAG;CAAa,OAAO;CAAW,SAAS;AAAG,GAE3E,cAA6B;CACjC,GAAG;CACH,QAAQ;CACR,YAAY;CACZ,OAAO;CACP,QAAQ;CACR,MAAM;CACN,gBAAgB;CAChB,qBAAqB;AACvB;;;;;;;;;;ACrLA,SAAgB,qBACd,SACA,QAAQ,KACR,SAAuF;CACrF,MAAM,IAAI,OAAO,WAAW,IAAI,EAAE;CAClC,QAAQ,OAAO,aAAa,EAAmC;AACjE,GAC2D;CAC3D,IAAI,UAAmB,MACnB,UAA0B,CAAC,GACzB,cAAc;EAElB,AADA,UAAU,MACV,QAAQ;EACR,IAAM,OAAO;EAGb,AAFA,UAAU,CAAC,GAEX,OAAO,UAAU,KAAK,SAAS,YAAY,QAAQ,CAAC,GAAG,GAAI;CAC7D;CACA,QAAQ,YACF,QAAQ,WAAW,YAAY,QAAQ,WAAW,aAAmB,MACrE,YAAY,QAAM,OAAO,MAAM,OAAO,GAC1C,UAAU,OAAO,IAAI,OAAO,QAAQ,WAAW,WAAW,IAAI,KAAK,GAC5D,IAAI,SAAe,YAAY,QAAQ,KAAK,OAAO,CAAC;AAE/D;;;;;;;;;;;;;AAcA,SAAgB,qBAAqB,QAAQ,KAAgE;CAC3G,IAAM,SAAS,UAAU,GACnB,UAAU,cAAc,2BAA2B,OAAO,QAAQ,GAAG,KAAK,GAAG,CAAC,QAAQ,KAAK,CAAC;CAClG,OAAO,aAAa,YAAmC,QAAQ,OAAO,GAAG,CAAC,OAAO,CAAC;AACpF"}
|
package/package.json
CHANGED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import {createElement, type ComponentType} from 'react'
|
|
2
|
+
import {usePerspective, type InputProps} from 'sanity'
|
|
3
|
+
import {Box, Text} from '@sanity/ui'
|
|
4
|
+
import {Tooltip} from '@sanity/ui/tooltip'
|
|
5
|
+
|
|
6
|
+
// Champs « simples » (texte, nombre, case, date...) : la bulle sur un objet ou une
|
|
7
|
+
// liste doublerait celle de chacun de ses champs.
|
|
8
|
+
const LEAF = new Set(['string', 'number', 'boolean'])
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Vue « Published » : le formulaire est en lecture seule et rien ne dit pourquoi.
|
|
12
|
+
* Au survol d'un champ : « Switch to Drafts to edit ». La structure ne change
|
|
13
|
+
* qu'avec la vue (jamais pendant la frappe : le champ n'est pas recréé).
|
|
14
|
+
*/
|
|
15
|
+
export function withPublishedHint(Inner: ComponentType<InputProps>): ComponentType<InputProps> {
|
|
16
|
+
function PublishedHint(props: InputProps) {
|
|
17
|
+
const {selectedPerspectiveName} = usePerspective()
|
|
18
|
+
const inner = createElement(Inner, props)
|
|
19
|
+
if (selectedPerspectiveName !== 'published' || !LEAF.has(props.schemaType.jsonType)) return inner
|
|
20
|
+
return (
|
|
21
|
+
<Tooltip
|
|
22
|
+
portal
|
|
23
|
+
placement="top"
|
|
24
|
+
content={
|
|
25
|
+
<Box padding={2}>
|
|
26
|
+
<Text size={1}>Switch to Drafts to edit</Text>
|
|
27
|
+
</Box>
|
|
28
|
+
}
|
|
29
|
+
>
|
|
30
|
+
<div>{inner}</div>
|
|
31
|
+
</Tooltip>
|
|
32
|
+
)
|
|
33
|
+
}
|
|
34
|
+
return PublishedHint
|
|
35
|
+
}
|
package/src/index.ts
CHANGED
|
@@ -44,6 +44,7 @@ import {createOverrideInput} from './form/OverrideInput'
|
|
|
44
44
|
import {RemoveFromSiteAction} from './actions/RemoveFromSite'
|
|
45
45
|
import {createSlugUrlInput, isSlugInput} from './form/SlugUrlInput'
|
|
46
46
|
import {withTranslationTodo} from './form/TranslationTodoInput'
|
|
47
|
+
import {withPublishedHint} from './form/PublishedHint'
|
|
47
48
|
import {withPropagation} from './actions/PropagatePublish'
|
|
48
49
|
|
|
49
50
|
/** Champs du formulaire : adresse sous le Slug d'une page, pastille sur les sections. */
|
|
@@ -54,7 +55,8 @@ function createKitInput(config: Parameters<typeof createOverrideInput>[0]): Comp
|
|
|
54
55
|
return isSlugInput(props) ? createElement(SlugUrl, props) : createElement(Override, props)
|
|
55
56
|
}
|
|
56
57
|
// Traductions : pastille « À traduire » sur les champs modifiés dans la version principale.
|
|
57
|
-
|
|
58
|
+
// Vue « Published » : « Switch to Drafts to edit » au survol d'un champ.
|
|
59
|
+
return withPublishedHint(config.i18n ? withTranslationTodo(KitInput, config) : KitInput)
|
|
58
60
|
}
|
|
59
61
|
|
|
60
62
|
export const ncfKit = definePlugin<NcfKitConfig>((options) => {
|
|
@@ -365,3 +367,6 @@ export type {Annotation} from './lib/graph'
|
|
|
365
367
|
export type {AddColumnInput} from './lib/columns'
|
|
366
368
|
export type {AnnotationsState} from './hooks/useAnnotations'
|
|
367
369
|
export type {PathInput} from './lib/paths'
|
|
370
|
+
|
|
371
|
+
export {ncfMainDocuments} from './lib/mainDocuments'
|
|
372
|
+
export type {MainDocumentRoute} from './lib/mainDocuments'
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import type {NcfKitConfig} from '../config/types'
|
|
2
|
+
import {resolveConfig} from '../config/resolve'
|
|
3
|
+
import type {SiteRoutesRegistry} from './siteRoutes'
|
|
4
|
+
|
|
5
|
+
/** Une entrée de `presentationTool({resolve: {mainDocuments: defineDocuments([...])}})`. */
|
|
6
|
+
export interface MainDocumentRoute {
|
|
7
|
+
route: string
|
|
8
|
+
filter: string
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
const SAFE = /^[A-Za-z0-9_.-]+$/
|
|
12
|
+
const quote = (value: string) => JSON.stringify(value)
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* Presentation : le document du panneau de droite est TOUJOURS celui de la page
|
|
16
|
+
* affichée, DANS SA LANGUE. Sans cette liste, changer de langue (ou de page) dans
|
|
17
|
+
* l'aperçu laisse le panneau sur l'ancien document : on modifie le français en
|
|
18
|
+
* regardant l'anglais.
|
|
19
|
+
*
|
|
20
|
+
* Une route par adresse et par langue (langue principale sans préfixe, les autres
|
|
21
|
+
* sous /<langue>) : accueil, pages codées du registre (`pageSlug`), collections
|
|
22
|
+
* (`<préfixe>/:slug`), design system (valeurs par défaut des composants). Ordre :
|
|
23
|
+
* langues préfixées d'abord, puis du plus précis au plus général (`/:slug` en
|
|
24
|
+
* dernier), pour que `/en` ne soit pas lu comme la page de slug « en ».
|
|
25
|
+
*
|
|
26
|
+
* ```ts
|
|
27
|
+
* presentationTool({resolve: {mainDocuments: defineDocuments(ncfMainDocuments(ncfOptions, {siteRoutes: routes}))}})
|
|
28
|
+
* ```
|
|
29
|
+
*/
|
|
30
|
+
export function ncfMainDocuments(
|
|
31
|
+
options: NcfKitConfig,
|
|
32
|
+
extra: {siteRoutes?: SiteRoutesRegistry; designSystemRoutes?: string[]} = {},
|
|
33
|
+
): MainDocumentRoute[] {
|
|
34
|
+
const config = resolveConfig(options)
|
|
35
|
+
const i18n = config.i18n
|
|
36
|
+
const field = i18n?.field ?? 'language'
|
|
37
|
+
const locales = i18n ? [...i18n.locales.filter((l) => l !== i18n.defaultLocale), i18n.defaultLocale] : [null]
|
|
38
|
+
const slugTypes = config.pageTypes.filter((t) => t.slugField && !t.path)
|
|
39
|
+
const defaultsType = config.componentPreview.defaultsType
|
|
40
|
+
const designSystem = extra.designSystemRoutes ?? ['/design-system/composant', '/design-system']
|
|
41
|
+
|
|
42
|
+
const out: MainDocumentRoute[] = []
|
|
43
|
+
for (const locale of locales) {
|
|
44
|
+
if (locale !== null && !SAFE.test(locale)) continue
|
|
45
|
+
const prefix = locale === null || locale === i18n?.defaultLocale ? '' : `/${locale}`
|
|
46
|
+
const lang = locale === null ? '' : ` && ${field} == ${quote(locale)}`
|
|
47
|
+
const at = (path: string) => (path === '/' || path === '' ? prefix || '/' : `${prefix}${path}`)
|
|
48
|
+
|
|
49
|
+
// Design system : valeurs par défaut des composants de la langue affichée.
|
|
50
|
+
for (const route of designSystem) out.push({route: at(route), filter: `_type == ${quote(defaultsType)}${lang}`})
|
|
51
|
+
|
|
52
|
+
// Pages codées du registre qui portent un document « Page » (pageSlug).
|
|
53
|
+
for (const fixed of extra.siteRoutes?.fixed ?? []) {
|
|
54
|
+
if (!fixed.pageSlug || fixed.system || fixed.notFound || !SAFE.test(fixed.pageSlug)) continue
|
|
55
|
+
// Le document d'une page codée est une page « à la racine » (Page, Legal page).
|
|
56
|
+
const types = slugTypes.filter((t) => !t.pathPrefix || t.pathPrefix === '/').map((t) => quote(t.type)).join(', ')
|
|
57
|
+
if (!types) continue
|
|
58
|
+
out.push({route: at(fixed.path), filter: `_type in [${types}] && slug.current == ${quote(fixed.pageSlug)}${lang}`})
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
// Pages à chemin fixe (l'accueil).
|
|
62
|
+
for (const t of config.pageTypes) if (t.path) out.push({route: at(t.path), filter: `_type == ${quote(t.type)}${lang}`})
|
|
63
|
+
|
|
64
|
+
// Collections : préfixe le plus long d'abord, la racine (`/:slug`) en dernier.
|
|
65
|
+
const collections = [...slugTypes].sort((a, b) => (b.pathPrefix ?? '').length - (a.pathPrefix ?? '').length)
|
|
66
|
+
for (const t of collections) {
|
|
67
|
+
const base = t.pathPrefix && t.pathPrefix !== '/' ? t.pathPrefix : ''
|
|
68
|
+
out.push({route: at(`${base}/:slug`), filter: `_type == ${quote(t.type)} && ${t.slugField}.current == $slug${lang}`})
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
return out
|
|
72
|
+
}
|
package/src/lib/siteRoutes.ts
CHANGED
|
@@ -6,7 +6,7 @@ import type {NcfPageTypeInput} from '../config/types'
|
|
|
6
6
|
* (sections, titres, noindex) qui ne concernent pas le kit.
|
|
7
7
|
*/
|
|
8
8
|
export interface SiteRoutesRegistry {
|
|
9
|
-
fixed?: {path: string; homePage?: boolean; system?: boolean; notFound?: boolean}[]
|
|
9
|
+
fixed?: {path: string; homePage?: boolean; system?: boolean; notFound?: boolean; pageSlug?: string}[]
|
|
10
10
|
collections?: {type: string; pathPrefix?: string}[]
|
|
11
11
|
}
|
|
12
12
|
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import {useEffect} from 'react'
|
|
2
|
+
import {usePerspective, useSetPerspective} from 'sanity'
|
|
3
|
+
|
|
4
|
+
// Une fois par chargement de page (la barre d'outils est rendue deux fois : barre
|
|
5
|
+
// du haut et volet latéral).
|
|
6
|
+
let checked = false
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* À l'ouverture du Studio, on édite : vue « Drafts », jamais « Published ». Un lien
|
|
10
|
+
* « Prod · En ligne » (perspective=published dans l'adresse) ou un Studio rechargé
|
|
11
|
+
* sur cette vue rouvrait sinon en lecture seule. Ensuite, le choix de l'utilisateur
|
|
12
|
+
* est respecté jusqu'au prochain chargement.
|
|
13
|
+
*/
|
|
14
|
+
export function DraftsOnLoad() {
|
|
15
|
+
const {selectedPerspectiveName} = usePerspective()
|
|
16
|
+
const setPerspective = useSetPerspective()
|
|
17
|
+
useEffect(() => {
|
|
18
|
+
if (checked) return
|
|
19
|
+
checked = true
|
|
20
|
+
// L'adresse fait foi dès le premier rendu (la vue choisie peut arriver après).
|
|
21
|
+
const fromUrl = typeof window !== 'undefined' && new URLSearchParams(window.location.search).get('perspective') === 'published'
|
|
22
|
+
if (selectedPerspectiveName === 'published' || fromUrl) setPerspective('drafts')
|
|
23
|
+
}, [selectedPerspectiveName, setPerspective])
|
|
24
|
+
return null
|
|
25
|
+
}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import {DraftsOnLoad} from './DraftsOnLoad'
|
|
1
2
|
import {Box, Button, Flex, Stack, Text} from '@sanity/ui'
|
|
2
3
|
import {useRouter} from 'sanity/router'
|
|
3
4
|
import type {ToolMenuProps} from 'sanity'
|
|
@@ -156,6 +157,7 @@ export function createPreviewLauncher(config: ResolvedKitConfig, issues: ConfigI
|
|
|
156
157
|
return function NcfToolMenu(props: ToolMenuProps) {
|
|
157
158
|
return (
|
|
158
159
|
<KitProvider config={config} issues={issues}>
|
|
160
|
+
<DraftsOnLoad />
|
|
159
161
|
<NcfPreviewLauncher {...props} />
|
|
160
162
|
</KitProvider>
|
|
161
163
|
)
|
package/src/version.ts
CHANGED
package/src/web/index.ts
CHANGED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import {useCallback, useMemo} from 'react'
|
|
2
|
+
import {useRouter} from 'next/navigation'
|
|
3
|
+
|
|
4
|
+
/** Ce que l'édition visuelle de Sanity passe à `refresh` (next-sanity <VisualEditing/>). */
|
|
5
|
+
export interface PreviewRefreshPayload {
|
|
6
|
+
source: 'manual' | 'mutation' | string
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Rafraîchissement de l'aperçu (Presentation) à CHAQUE modification faite dans le
|
|
11
|
+
* Studio, regroupée : une rafale de frappes = un seul rafraîchissement.
|
|
12
|
+
*
|
|
13
|
+
* Sans lui, <VisualEditing/> de next-sanity ignore les modifications du Studio et
|
|
14
|
+
* compte sur le signal live, qui ne part pas toujours : un champ remis à sa valeur
|
|
15
|
+
* par défaut (vidé, la pastille bleue) ne s'affichait qu'après un rechargement.
|
|
16
|
+
* Pur et testable : `refresh` et les minuteries sont injectés.
|
|
17
|
+
*/
|
|
18
|
+
export function createPreviewRefresh(
|
|
19
|
+
refresh: () => void,
|
|
20
|
+
delay = 300,
|
|
21
|
+
timers: {set: (fn: () => void, ms: number) => unknown; clear: (id: unknown) => void} = {
|
|
22
|
+
set: (fn, ms) => setTimeout(fn, ms),
|
|
23
|
+
clear: (id) => clearTimeout(id as ReturnType<typeof setTimeout>),
|
|
24
|
+
},
|
|
25
|
+
): (payload: PreviewRefreshPayload) => false | Promise<void> {
|
|
26
|
+
let pending: unknown = null
|
|
27
|
+
let waiting: (() => void)[] = []
|
|
28
|
+
const flush = () => {
|
|
29
|
+
pending = null
|
|
30
|
+
refresh()
|
|
31
|
+
const done = waiting
|
|
32
|
+
waiting = []
|
|
33
|
+
// Laisse le temps au rendu serveur d'arriver avant d'éteindre l'indicateur.
|
|
34
|
+
timers.set(() => done.forEach((resolve) => resolve()), 1000)
|
|
35
|
+
}
|
|
36
|
+
return (payload) => {
|
|
37
|
+
if (payload.source !== 'manual' && payload.source !== 'mutation') return false
|
|
38
|
+
if (pending !== null) timers.clear(pending)
|
|
39
|
+
pending = timers.set(flush, payload.source === 'manual' ? 0 : delay)
|
|
40
|
+
return new Promise<void>((resolve) => waiting.push(resolve))
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* À passer à <VisualEditing refresh={...}/> (next-sanity), dans un composant client :
|
|
46
|
+
*
|
|
47
|
+
* ```tsx
|
|
48
|
+
* 'use client'
|
|
49
|
+
* import {VisualEditing} from 'next-sanity/visual-editing'
|
|
50
|
+
* import {useNcfPreviewRefresh} from '@nocode-factory/sanity-kit/web'
|
|
51
|
+
* export function PreviewEditing() {
|
|
52
|
+
* return <VisualEditing refresh={useNcfPreviewRefresh()} />
|
|
53
|
+
* }
|
|
54
|
+
* ```
|
|
55
|
+
*/
|
|
56
|
+
export function useNcfPreviewRefresh(delay = 300): (payload: PreviewRefreshPayload) => false | Promise<void> {
|
|
57
|
+
const router = useRouter()
|
|
58
|
+
const handler = useMemo(() => createPreviewRefresh(() => router.refresh(), delay), [router, delay])
|
|
59
|
+
return useCallback((payload: PreviewRefreshPayload) => handler(payload), [handler])
|
|
60
|
+
}
|