@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/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.24.0",
4
4
  "description": "Outils Studio de NoCode Factory : Pages (liste + board), Composants, Historique",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
@@ -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
- return config.i18n ? withTranslationTodo(KitInput, config) : KitInput
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
+ }
@@ -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
@@ -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.24.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
+ }