@nocode-factory/sanity-kit 2.22.1 → 2.23.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/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
- export type { PreviewBannerProps };
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
- export { NcfPreviewBanner };
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":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nocode-factory/sanity-kit",
3
- "version": "2.22.1",
3
+ "version": "2.23.0",
4
4
  "description": "Outils Studio de NoCode Factory : Pages (liste + board), Composants, Historique",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
package/src/version.ts CHANGED
@@ -3,4 +3,4 @@
3
3
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
4
4
  * le vérifie.
5
5
  */
6
- export const KIT_VERSION = '2.22.1'
6
+ export const KIT_VERSION = '2.23.0'
package/src/web/index.ts CHANGED
@@ -13,3 +13,5 @@
13
13
  */
14
14
  export {NcfPreviewBanner} from './PreviewBanner'
15
15
  export type {PreviewBannerProps} from './PreviewBanner'
16
+ export {useNcfPreviewRefresh, createPreviewRefresh} from './previewRefresh'
17
+ export type {PreviewRefreshPayload} from './previewRefresh'
@@ -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
+ }