@nocode-factory/sanity-kit 2.0.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.
Files changed (95) hide show
  1. package/bin/ncf-kit.mjs +201 -0
  2. package/dist/index.d.ts +1643 -0
  3. package/dist/index.js +6632 -0
  4. package/dist/index.js.map +1 -0
  5. package/dist/web-server.d.ts +46 -0
  6. package/dist/web-server.js +51 -0
  7. package/dist/web-server.js.map +1 -0
  8. package/dist/web.d.ts +27 -0
  9. package/dist/web.js +117 -0
  10. package/dist/web.js.map +1 -0
  11. package/package.json +90 -0
  12. package/scripts/use-client.mjs +20 -0
  13. package/src/config/defaults.ts +74 -0
  14. package/src/config/resolve.ts +153 -0
  15. package/src/config/types.ts +290 -0
  16. package/src/config/validate.ts +193 -0
  17. package/src/context/BoardLayoutContext.tsx +24 -0
  18. package/src/context/KitContext.tsx +30 -0
  19. package/src/context/PreviewTargetContext.tsx +27 -0
  20. package/src/hooks/useAnnotations.ts +60 -0
  21. package/src/hooks/useBoardLayout.ts +398 -0
  22. package/src/hooks/useColumnOptions.ts +47 -0
  23. package/src/hooks/useDocumentColumns.ts +61 -0
  24. package/src/hooks/useHistory.ts +89 -0
  25. package/src/hooks/useInternalColumns.ts +19 -0
  26. package/src/hooks/useKitClient.ts +15 -0
  27. package/src/hooks/useOccurrences.ts +62 -0
  28. package/src/hooks/usePageContents.ts +65 -0
  29. package/src/hooks/usePages.ts +41 -0
  30. package/src/hooks/usePreviewTarget.ts +162 -0
  31. package/src/hooks/useQueryData.ts +103 -0
  32. package/src/hooks/useRegistration.ts +50 -0
  33. package/src/index.ts +280 -0
  34. package/src/lib/blocks.ts +38 -0
  35. package/src/lib/colors.ts +103 -0
  36. package/src/lib/columns.ts +137 -0
  37. package/src/lib/diff.ts +200 -0
  38. package/src/lib/elkLayout.ts +124 -0
  39. package/src/lib/graph.ts +238 -0
  40. package/src/lib/grouping.ts +116 -0
  41. package/src/lib/links.ts +70 -0
  42. package/src/lib/occurrences.ts +93 -0
  43. package/src/lib/pageThumbnail.ts +43 -0
  44. package/src/lib/pages.ts +199 -0
  45. package/src/lib/paths.ts +68 -0
  46. package/src/lib/query.ts +113 -0
  47. package/src/lib/schemaColumns.ts +162 -0
  48. package/src/lib/schemaTypes.ts +75 -0
  49. package/src/lib/sectionsMap.ts +83 -0
  50. package/src/lib/service.ts +88 -0
  51. package/src/lib/siteRoutes.ts +43 -0
  52. package/src/lib/status.ts +122 -0
  53. package/src/lib/studioLinks.ts +137 -0
  54. package/src/schema/boardLayout.ts +190 -0
  55. package/src/tools/components/BlockCard.tsx +79 -0
  56. package/src/tools/components/ComponentsTool.tsx +171 -0
  57. package/src/tools/components/map/SectionNode.tsx +109 -0
  58. package/src/tools/components/map/SectionsMap.tsx +339 -0
  59. package/src/tools/createToolComponent.tsx +67 -0
  60. package/src/tools/history/ChangeRow.tsx +87 -0
  61. package/src/tools/history/DiffPanel.tsx +227 -0
  62. package/src/tools/history/HistoryTool.tsx +230 -0
  63. package/src/tools/more/MoreTool.tsx +82 -0
  64. package/src/tools/pages/ColumnHeader.tsx +216 -0
  65. package/src/tools/pages/ColumnVisibility.tsx +173 -0
  66. package/src/tools/pages/FieldValue.tsx +327 -0
  67. package/src/tools/pages/PagesTable.tsx +394 -0
  68. package/src/tools/pages/PagesTool.tsx +333 -0
  69. package/src/tools/pages/PagesToolbar.tsx +53 -0
  70. package/src/tools/pages/PathCell.tsx +71 -0
  71. package/src/tools/pages/PreviewTarget.tsx +226 -0
  72. package/src/tools/pages/TagCell.tsx +124 -0
  73. package/src/tools/pages/ViewTabs.tsx +57 -0
  74. package/src/tools/pages/board/BoardView.tsx +661 -0
  75. package/src/tools/pages/board/PageNode.tsx +306 -0
  76. package/src/tools/pages/board/PagePanel.tsx +228 -0
  77. package/src/tools/presentation/PreviewHeader.tsx +75 -0
  78. package/src/tools/shared/AnnotationNode.tsx +126 -0
  79. package/src/ui/ActorName.tsx +20 -0
  80. package/src/ui/ConfigIssues.tsx +41 -0
  81. package/src/ui/InlineCode.tsx +22 -0
  82. package/src/ui/Popover.tsx +85 -0
  83. package/src/ui/ProjectStatusNotice.tsx +58 -0
  84. package/src/ui/QueryError.tsx +16 -0
  85. package/src/ui/QuietInput.tsx +64 -0
  86. package/src/ui/StatusBadge.tsx +11 -0
  87. package/src/ui/ToolPlaceholder.tsx +23 -0
  88. package/src/ui/formatDate.ts +14 -0
  89. package/src/ui/tokens.ts +54 -0
  90. package/src/version.ts +5 -0
  91. package/src/web/PreviewBanner.tsx +115 -0
  92. package/src/web/draftModeToggle.ts +56 -0
  93. package/src/web/environment.ts +21 -0
  94. package/src/web/index.ts +15 -0
  95. package/src/web/server.ts +11 -0
@@ -0,0 +1,46 @@
1
+ interface DraftModeToggleOptions {
2
+ /**
3
+ * Chemin de repli après la bascule, quand la page d'origine est inconnue.
4
+ * Défaut : la racine.
5
+ */
6
+ fallbackPath?: string;
7
+ }
8
+ /**
9
+ * Route qui bascule le mode brouillon depuis le site.
10
+ *
11
+ * ```ts
12
+ * // app/api/draft-mode/toggle/route.ts
13
+ * export const {GET} = ncfDraftModeToggle()
14
+ * ```
15
+ *
16
+ * **Refusée en production.** Activer le mode brouillon rend le contenu non
17
+ * publié visible à qui atteint l'URL : acceptable sur une préversion, jamais
18
+ * sur le site public. Ce refus est le seul garde-fou du dispositif — il ne
19
+ * dépend d'aucune configuration, et se trompe du bon côté.
20
+ *
21
+ * La route de Sanity, `defineEnableDraftMode`, reste préférable quand on entre
22
+ * par Presentation : elle vérifie un secret lié à la session de l'éditeur.
23
+ * Celle-ci sert le cas où l'on est déjà sur le site, sans Studio.
24
+ */
25
+ export declare function ncfDraftModeToggle(options?: DraftModeToggleOptions): {
26
+ GET(request: Request): Promise<Response>;
27
+ };
28
+ /**
29
+ * Outils destinés au **front** d'un site, pas au Studio.
30
+ *
31
+ * Ce point d'entrée n'importe ni `sanity` ni `@sanity/ui` : un site qui
32
+ * l'utilise n'embarque pas le Studio dans son bundle.
33
+ */
34
+ /**
35
+ * Vrai sur le déploiement public du site.
36
+ *
37
+ * `VERCEL_ENV` plutôt qu'une comparaison d'URL : un alias, un domaine ajouté
38
+ * plus tard ou une préversion nommée comme la production feraient mentir la
39
+ * seconde. Hors Vercel, on considère qu'on n'est pas en production — un
40
+ * environnement inconnu mérite le bandeau plutôt que le silence.
41
+ */
42
+ export declare function isProductionSite(): boolean;
43
+ /** L'inverse, pour se lire à l'endroit dans un layout. */
44
+ export declare const isPreviewSite: () => boolean;
45
+ export type { DraftModeToggleOptions };
46
+ //# sourceMappingURL=web-server.d.ts.map
@@ -0,0 +1,51 @@
1
+ import { draftMode } from "next/headers.js";
2
+ import { NextResponse } from "next/server.js";
3
+ /**
4
+ * Outils destinés au **front** d'un site, pas au Studio.
5
+ *
6
+ * Ce point d'entrée n'importe ni `sanity` ni `@sanity/ui` : un site qui
7
+ * l'utilise n'embarque pas le Studio dans son bundle.
8
+ */
9
+ /**
10
+ * Vrai sur le déploiement public du site.
11
+ *
12
+ * `VERCEL_ENV` plutôt qu'une comparaison d'URL : un alias, un domaine ajouté
13
+ * plus tard ou une préversion nommée comme la production feraient mentir la
14
+ * seconde. Hors Vercel, on considère qu'on n'est pas en production — un
15
+ * environnement inconnu mérite le bandeau plutôt que le silence.
16
+ */
17
+ function isProductionSite() {
18
+ return process.env.VERCEL_ENV === "production";
19
+ }
20
+ /** L'inverse, pour se lire à l'endroit dans un layout. */
21
+ const isPreviewSite = () => !isProductionSite();
22
+ /**
23
+ * Route qui bascule le mode brouillon depuis le site.
24
+ *
25
+ * ```ts
26
+ * // app/api/draft-mode/toggle/route.ts
27
+ * export const {GET} = ncfDraftModeToggle()
28
+ * ```
29
+ *
30
+ * **Refusée en production.** Activer le mode brouillon rend le contenu non
31
+ * publié visible à qui atteint l'URL : acceptable sur une préversion, jamais
32
+ * sur le site public. Ce refus est le seul garde-fou du dispositif — il ne
33
+ * dépend d'aucune configuration, et se trompe du bon côté.
34
+ *
35
+ * La route de Sanity, `defineEnableDraftMode`, reste préférable quand on entre
36
+ * par Presentation : elle vérifie un secret lié à la session de l'éditeur.
37
+ * Celle-ci sert le cas où l'on est déjà sur le site, sans Studio.
38
+ */
39
+ function ncfDraftModeToggle(options = {}) {
40
+ let fallback = options.fallbackPath ?? "/";
41
+ return { async GET(request) {
42
+ if (isProductionSite()) return NextResponse.json({ error: "Le mode brouillon est désactivé en production." }, { status: 403 });
43
+ let url = new URL(request.url), draft = await draftMode();
44
+ url.searchParams.get("enable") === "false" ? draft.disable() : draft.enable();
45
+ let back = url.searchParams.get("redirect"), target = back && back.startsWith("/") && !back.startsWith("//") ? back : fallback;
46
+ return NextResponse.redirect(new URL(target, request.url));
47
+ } };
48
+ }
49
+ export { isPreviewSite, isProductionSite, ncfDraftModeToggle };
50
+
51
+ //# sourceMappingURL=web-server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web-server.js","names":[],"sources":["../src/web/environment.ts","../src/web/draftModeToggle.ts"],"sourcesContent":["/**\n * Outils destinés au **front** d'un site, pas au Studio.\n *\n * Ce point d'entrée n'importe ni `sanity` ni `@sanity/ui` : un site qui\n * l'utilise n'embarque pas le Studio dans son bundle.\n */\n\n/**\n * Vrai sur le déploiement public du site.\n *\n * `VERCEL_ENV` plutôt qu'une comparaison d'URL : un alias, un domaine ajouté\n * plus tard ou une préversion nommée comme la production feraient mentir la\n * seconde. Hors Vercel, on considère qu'on n'est pas en production — un\n * environnement inconnu mérite le bandeau plutôt que le silence.\n */\nexport function isProductionSite(): boolean {\n return process.env.VERCEL_ENV === 'production'\n}\n\n/** L'inverse, pour se lire à l'endroit dans un layout. */\nexport const isPreviewSite = (): boolean => !isProductionSite()\n","import {draftMode} from 'next/headers'\nimport {NextResponse} from 'next/server'\nimport {isProductionSite} from './environment'\n\nexport interface DraftModeToggleOptions {\n /**\n * Chemin de repli après la bascule, quand la page d'origine est inconnue.\n * Défaut : la racine.\n */\n fallbackPath?: string\n}\n\n/**\n * Route qui bascule le mode brouillon depuis le site.\n *\n * ```ts\n * // app/api/draft-mode/toggle/route.ts\n * export const {GET} = ncfDraftModeToggle()\n * ```\n *\n * **Refusée en production.** Activer le mode brouillon rend le contenu non\n * publié visible à qui atteint l'URL : acceptable sur une préversion, jamais\n * sur le site public. Ce refus est le seul garde-fou du dispositif — il ne\n * dépend d'aucune configuration, et se trompe du bon côté.\n *\n * La route de Sanity, `defineEnableDraftMode`, reste préférable quand on entre\n * par Presentation : elle vérifie un secret lié à la session de l'éditeur.\n * Celle-ci sert le cas où l'on est déjà sur le site, sans Studio.\n */\nexport function ncfDraftModeToggle(options: DraftModeToggleOptions = {}) {\n const fallback = options.fallbackPath ?? '/'\n\n return {\n async GET(request: Request): Promise<Response> {\n if (isProductionSite()) {\n return NextResponse.json(\n {error: 'Le mode brouillon est désactivé en production.'},\n {status: 403},\n )\n }\n\n const url = new URL(request.url)\n const draft = await draftMode()\n\n if (url.searchParams.get('enable') === 'false') draft.disable()\n else draft.enable()\n\n // On revient d'où l'on vient : basculer les données ne doit pas faire\n // perdre sa place au relecteur. Un chemin relatif seulement — une URL\n // absolue ferait de cette route une redirection ouverte.\n const back = url.searchParams.get('redirect')\n const target = back && back.startsWith('/') && !back.startsWith('//') ? back : fallback\n return NextResponse.redirect(new URL(target, request.url))\n },\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,SAAgB,mBAA4B;CAC1C,OAAO,QAAQ,IAAI,eAAe;AACpC;;AAGA,MAAa,sBAA+B,CAAC,iBAAiB;;;;;;;;;;;;;;;;;;ACS9D,SAAgB,mBAAmB,UAAkC,CAAC,GAAG;CACvE,IAAM,WAAW,QAAQ,gBAAgB;CAEzC,OAAO,EACL,MAAM,IAAI,SAAqC;EAC7C,IAAI,iBAAiB,GACnB,OAAO,aAAa,KAClB,EAAC,OAAO,iDAAgD,GACxD,EAAC,QAAQ,IAAG,CACd;EAGF,IAAM,MAAM,IAAI,IAAI,QAAQ,GAAG,GACzB,QAAQ,MAAM,UAAU;EAE9B,AAAI,IAAI,aAAa,IAAI,QAAQ,MAAM,UAAS,MAAM,QAAQ,IACzD,MAAM,OAAO;EAKlB,IAAM,OAAO,IAAI,aAAa,IAAI,UAAU,GACtC,SAAS,QAAQ,KAAK,WAAW,GAAG,KAAK,CAAC,KAAK,WAAW,IAAI,IAAI,OAAO;EAC/E,OAAO,aAAa,SAAS,IAAI,IAAI,QAAQ,QAAQ,GAAG,CAAC;CAC3D,EACF;AACF"}
package/dist/web.d.ts ADDED
@@ -0,0 +1,27 @@
1
+ interface PreviewBannerProps {
2
+ /** Le site affiche-t-il actuellement les brouillons ? */
3
+ isDraft: boolean;
4
+ /** Chemin de la route de bascule. Défaut : `/api/draft-mode/toggle`. */
5
+ togglePath?: string;
6
+ /** Libellé de l'environnement. Défaut : « Préversion ». */
7
+ label?: string;
8
+ position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
9
+ }
10
+ /**
11
+ * Bandeau des environnements de test : il dit où l'on est, et laisse choisir
12
+ * ce qu'on regarde.
13
+ *
14
+ * Sur une préversion, la question du relecteur est toujours la même :
15
+ * « qu'est-ce qui sortira quand je publierai ? ». Y répondre demande de voir
16
+ * les brouillons sur le vrai site, pas dans un aperçu encastré.
17
+ *
18
+ * Les styles sont en ligne, délibérément. Des classes utilitaires obligeraient
19
+ * chaque site à déclarer ce paquet dans ses globs de scan — une dépendance
20
+ * invisible dont l'oubli ne se verrait qu'à l'exécution, par un bandeau nu.
21
+ *
22
+ * Rendu hors production seulement : c'est à l'appelant de s'en assurer, avec
23
+ * `isPreviewSite()`.
24
+ */
25
+ export declare function NcfPreviewBanner(props: PreviewBannerProps): import("react").JSX.Element;
26
+ export type { PreviewBannerProps };
27
+ //# sourceMappingURL=web.d.ts.map
package/dist/web.js ADDED
@@ -0,0 +1,117 @@
1
+ 'use client'
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { usePathname } from "next/navigation.js";
4
+ /**
5
+ * Bandeau des environnements de test : il dit où l'on est, et laisse choisir
6
+ * ce qu'on regarde.
7
+ *
8
+ * Sur une préversion, la question du relecteur est toujours la même :
9
+ * « qu'est-ce qui sortira quand je publierai ? ». Y répondre demande de voir
10
+ * les brouillons sur le vrai site, pas dans un aperçu encastré.
11
+ *
12
+ * Les styles sont en ligne, délibérément. Des classes utilitaires obligeraient
13
+ * chaque site à déclarer ce paquet dans ses globs de scan — une dépendance
14
+ * invisible dont l'oubli ne se verrait qu'à l'exécution, par un bandeau nu.
15
+ *
16
+ * Rendu hors production seulement : c'est à l'appelant de s'en assurer, avec
17
+ * `isPreviewSite()`.
18
+ */
19
+ function NcfPreviewBanner(props) {
20
+ let { isDraft, togglePath = "/api/draft-mode/toggle", label = "Préversion" } = props, pathname = usePathname(), back = encodeURIComponent(pathname || "/"), href = (enable) => `${togglePath}?enable=${enable}&redirect=${back}`;
21
+ return /* @__PURE__ */ jsx("div", {
22
+ style: {
23
+ ...anchor(props.position ?? "bottom-left"),
24
+ zIndex: 2147483e3
25
+ },
26
+ children: /* @__PURE__ */ jsxs("div", {
27
+ style: shell,
28
+ children: [
29
+ /* @__PURE__ */ jsxs("span", {
30
+ style: {
31
+ display: "inline-flex",
32
+ alignItems: "center",
33
+ gap: 6,
34
+ fontWeight: 500
35
+ },
36
+ children: [/* @__PURE__ */ jsx("span", {
37
+ "aria-hidden": !0,
38
+ style: dot
39
+ }), label]
40
+ }),
41
+ /* @__PURE__ */ jsx("span", {
42
+ "aria-hidden": !0,
43
+ style: divider
44
+ }),
45
+ /* @__PURE__ */ jsx("span", {
46
+ style: { opacity: .75 },
47
+ children: "Données"
48
+ }),
49
+ /* @__PURE__ */ jsxs("span", {
50
+ role: "group",
51
+ "aria-label": "Données affichées",
52
+ style: {
53
+ display: "inline-flex",
54
+ gap: 2
55
+ },
56
+ children: [/* @__PURE__ */ jsx("a", {
57
+ href: href(!0),
58
+ title: "Ce qui sortira après publication",
59
+ "aria-current": isDraft ? "true" : void 0,
60
+ style: isDraft ? segmentOn : segmentOff,
61
+ children: "Brouillons"
62
+ }), /* @__PURE__ */ jsx("a", {
63
+ href: href(!1),
64
+ title: "Ce que voit le public aujourd'hui",
65
+ "aria-current": isDraft ? void 0 : "true",
66
+ style: isDraft ? segmentOff : segmentOn,
67
+ children: "En ligne"
68
+ })]
69
+ })
70
+ ]
71
+ })
72
+ });
73
+ }
74
+ const anchor = (position) => ({
75
+ position: "fixed",
76
+ ...position.startsWith("bottom") ? { bottom: 16 } : { top: 16 },
77
+ ...position.endsWith("left") ? { left: 16 } : { right: 16 }
78
+ }), shell = {
79
+ display: "flex",
80
+ alignItems: "center",
81
+ gap: 10,
82
+ padding: "6px 12px",
83
+ borderRadius: 999,
84
+ background: "#fef3c7",
85
+ color: "#451a03",
86
+ border: "1px solid #fcd34d",
87
+ boxShadow: "0 4px 16px rgba(0,0,0,0.14)",
88
+ font: "500 12px/1 ui-sans-serif, system-ui, -apple-system, Segoe UI, sans-serif"
89
+ }, dot = {
90
+ width: 7,
91
+ height: 7,
92
+ borderRadius: "50%",
93
+ background: "#d97706",
94
+ flex: "none"
95
+ }, divider = {
96
+ width: 1,
97
+ height: 14,
98
+ background: "#00000022"
99
+ }, segmentBase = {
100
+ padding: "4px 10px",
101
+ borderRadius: 999,
102
+ textDecoration: "none",
103
+ fontSize: 12,
104
+ lineHeight: 1,
105
+ whiteSpace: "nowrap"
106
+ }, segmentOn = {
107
+ ...segmentBase,
108
+ background: "#451a03",
109
+ color: "#fffbeb"
110
+ }, segmentOff = {
111
+ ...segmentBase,
112
+ color: "#451a03",
113
+ opacity: .7
114
+ };
115
+ export { NcfPreviewBanner };
116
+
117
+ //# sourceMappingURL=web.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web.js","names":[],"sources":["../src/web/PreviewBanner.tsx"],"sourcesContent":["'use client'\n\nimport {usePathname} from 'next/navigation'\nimport type {CSSProperties} from 'react'\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 const back = encodeURIComponent(pathname || '/')\n\n const href = (enable: boolean) => `${togglePath}?enable=${enable}&redirect=${back}`\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 </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"],"mappings":";;;;;;;;;;;;;;;;;AA8BA,SAAgB,iBAAiB,OAA2B;CAC1D,IAAM,EAAC,SAAS,aAAa,0BAA0B,QAAQ,iBAAgB,OACzE,WAAW,YAAY,GACvB,OAAO,mBAAmB,YAAY,GAAG,GAEzC,QAAQ,WAAoB,GAAG,WAAW,UAAU,OAAO,YAAY;CAE7E,OACE,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;;GACH;;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"}
package/package.json ADDED
@@ -0,0 +1,90 @@
1
+ {
2
+ "name": "@nocode-factory/sanity-kit",
3
+ "version": "2.0.0",
4
+ "description": "Outils Studio de NoCode Factory : Pages (liste + board), Composants, Historique",
5
+ "license": "UNLICENSED",
6
+ "private": false,
7
+ "type": "module",
8
+ "sideEffects": false,
9
+ "exports": {
10
+ ".": {
11
+ "source": "./src/index.ts",
12
+ "default": "./dist/index.js"
13
+ },
14
+ "./web": {
15
+ "source": "./src/web/index.ts",
16
+ "default": "./dist/web.js"
17
+ },
18
+ "./web/server": {
19
+ "source": "./src/web/server.ts",
20
+ "default": "./dist/web-server.js"
21
+ },
22
+ "./package.json": "./package.json"
23
+ },
24
+ "main": "./dist/index.js",
25
+ "module": "./dist/index.js",
26
+ "types": "./dist/index.d.ts",
27
+ "files": [
28
+ "README.md",
29
+ "bin",
30
+ "dist",
31
+ "scripts",
32
+ "src"
33
+ ],
34
+ "engines": {
35
+ "node": ">=22.18"
36
+ },
37
+ "scripts": {
38
+ "build": "pkg-utils build --check --clean && node scripts/use-client.mjs",
39
+ "dev": "pkg-utils watch",
40
+ "typecheck": "tsc --noEmit",
41
+ "test": "vitest run",
42
+ "test:watch": "vitest"
43
+ },
44
+ "dependencies": {
45
+ "@sanity/icons": "^5.2.2",
46
+ "@sanity/ui": "^4.2.0",
47
+ "@xyflow/react": "12.11.6",
48
+ "elkjs": "0.12.0"
49
+ },
50
+ "peerDependencies": {
51
+ "next": ">=15",
52
+ "react": "^19.2",
53
+ "sanity": "^6.0.0"
54
+ },
55
+ "devDependencies": {
56
+ "@sanity/pkg-utils": "13.0.1",
57
+ "@types/node": "^26.6.3",
58
+ "@types/react": "^19.2.14",
59
+ "next": "^16.3.8",
60
+ "react": "^19.2.4",
61
+ "react-dom": "^19.2.4",
62
+ "sanity": "6.15.0",
63
+ "styled-components": "^6.1.18",
64
+ "typescript": "^5.9.3",
65
+ "vitest": "^4.1.11"
66
+ },
67
+ "publishConfig": {
68
+ "registry": "https://registry.npmjs.org",
69
+ "access": "public",
70
+ "exports": {
71
+ ".": "./dist/index.js",
72
+ "./package.json": "./package.json",
73
+ "./web": "./dist/web.js",
74
+ "./web/server": "./dist/web-server.js"
75
+ }
76
+ },
77
+ "repository": {
78
+ "type": "git",
79
+ "url": "git+https://github.com/nocode-factory/ncf-sanity-kit.git",
80
+ "directory": "packages/sanity-kit"
81
+ },
82
+ "bin": {
83
+ "ncf-kit": "./bin/ncf-kit.mjs"
84
+ },
85
+ "peerDependenciesMeta": {
86
+ "next": {
87
+ "optional": true
88
+ }
89
+ }
90
+ }
@@ -0,0 +1,20 @@
1
+ // pkg-utils ne préserve pas les directives de module : la mention
2
+ // `'use client'` disparaît du bundle, et Next traite alors le bandeau comme
3
+ // un composant serveur — `usePathname` échoue au rendu.
4
+ //
5
+ // On la réinjecte après construction, sur le seul point d'entrée client.
6
+ import {readFile, writeFile} from 'node:fs/promises'
7
+
8
+ const targets = ['dist/web.js', 'dist/web.mjs', 'dist/web.cjs']
9
+
10
+ for (const file of targets) {
11
+ let code
12
+ try {
13
+ code = await readFile(file, 'utf8')
14
+ } catch {
15
+ continue
16
+ }
17
+ if (/^['"]use client['"]/.test(code)) continue
18
+ await writeFile(file, `'use client'\n${code}`)
19
+ console.log(`'use client' réinjecté dans ${file}`)
20
+ }
@@ -0,0 +1,74 @@
1
+ import type {
2
+ NcfBoardTag,
3
+ NcfInternalField,
4
+ NcfComponentPreviewConfig,
5
+ NcfI18nConfig,
6
+ NcfToolsConfig,
7
+ } from './types'
8
+
9
+ export const DEFAULT_PAGE_BUILDER_FIELD = 'sections'
10
+ export const DEFAULT_SLUG_FIELD = 'slug'
11
+ export const DEFAULT_TITLE_FIELD = 'title'
12
+ export const DEFAULT_BLOCK_NAMESPACE = ''
13
+
14
+ /**
15
+ * Chemins essayés pour savoir si une page est indexable. Le premier
16
+ * correspond à la convention du starter (`seo.noindex`), le second couvre les
17
+ * schémas qui portent le drapeau à la racine.
18
+ */
19
+ export const DEFAULT_NOINDEX_FIELDS = ['seo.noindex', 'noindex']
20
+
21
+ export const DEFAULT_I18N: Required<NcfI18nConfig> = {
22
+ field: 'language',
23
+ defaultLocale: 'fr',
24
+ locales: [],
25
+ }
26
+
27
+ /**
28
+ * Convention NoCode Factory : page `/design-system` dans le front, captures
29
+ * dans `/sections/<nom>.png` générées au push par GitHub Actions.
30
+ */
31
+ export const DEFAULT_COMPONENT_PREVIEW: Required<NcfComponentPreviewConfig> = {
32
+ provider: 'designSystemPage',
33
+ path: '/design-system',
34
+ anchor: '{name}',
35
+ thumbnail: '/sections/{name}.png',
36
+ }
37
+
38
+ export const DEFAULT_TOOLS: Required<NcfToolsConfig> = {
39
+ pages: true,
40
+ components: true,
41
+ history: true,
42
+ }
43
+
44
+ /**
45
+ * Étiquettes de suivi par défaut : l'avancement d'une refonte, pas un statut
46
+ * de publication. Elles vivent dans le document de disposition du kit, donc
47
+ * aucun schéma client n'est modifié.
48
+ */
49
+ export const DEFAULT_BOARD_TAGS: NcfBoardTag[] = [
50
+ {id: 'en-cours', label: 'En cours', color: '#f5a623'},
51
+ {id: 'fait', label: 'Fait', color: '#43d675'},
52
+ {id: 'a-relire', label: 'À relire', color: '#2276fc'},
53
+ {id: 'a-refondre', label: 'À refondre', color: '#f03e3e'},
54
+ ]
55
+
56
+ /**
57
+ * Colonnes de gestion interne par défaut. Volontairement peu nombreuses : ce
58
+ * sont celles qu'on redemande sur tous les projets. `internalFields` les
59
+ * remplace entièrement.
60
+ */
61
+ export const DEFAULT_INTERNAL_FIELDS: NcfInternalField[] = [
62
+ {id: 'owner', label: 'Responsable', type: 'text'},
63
+ {id: 'audience', label: 'Cible', type: 'text'},
64
+ {id: 'role', label: 'Rôle de la page', type: 'text'},
65
+ ]
66
+
67
+ /**
68
+ * Service du kit, hébergé par NoCode Factory.
69
+ *
70
+ * Renseigné d'office pour qu'un Studio n'ait rien à configurer : il se
71
+ * signale au démarrage, et c'est ce qui permet de savoir quels projets
72
+ * utilisent le kit. `endpoint` le remplace pour une instance privée.
73
+ */
74
+ export const DEFAULT_SERVICE_ENDPOINT = 'https://dkoxgivytgsmvqmjvmjt.supabase.co/functions/v1'
@@ -0,0 +1,153 @@
1
+ import {
2
+ DEFAULT_BLOCK_NAMESPACE,
3
+ DEFAULT_BOARD_TAGS,
4
+ DEFAULT_INTERNAL_FIELDS,
5
+ DEFAULT_SERVICE_ENDPOINT,
6
+ DEFAULT_COMPONENT_PREVIEW,
7
+ DEFAULT_I18N,
8
+ DEFAULT_NOINDEX_FIELDS,
9
+ DEFAULT_PAGE_BUILDER_FIELD,
10
+ DEFAULT_SLUG_FIELD,
11
+ DEFAULT_TITLE_FIELD,
12
+ DEFAULT_TOOLS,
13
+ } from './defaults'
14
+ import type {
15
+ NcfEnvironment,
16
+ NcfKitConfig,
17
+ NcfPageTypeConfig,
18
+ ResolvedKitConfig,
19
+ ResolvedPageType,
20
+ } from './types'
21
+
22
+ const trimTrailingSlash = (url: string) => url.replace(/\/+$/, '')
23
+
24
+ /** Garantit un chemin absolu ('accueil' -> '/accueil', '' -> '/'). */
25
+ export const normalizePath = (path: string): string => {
26
+ const trimmed = path.trim()
27
+ if (!trimmed || trimmed === '/') return '/'
28
+ const withSlash = trimmed.startsWith('/') ? trimmed : `/${trimmed}`
29
+ return withSlash.length > 1 ? trimTrailingSlash(withSlash) : withSlash
30
+ }
31
+
32
+ function resolvePageType(
33
+ entry: NcfPageTypeConfig,
34
+ defaults: {slugField: string; titleField: string},
35
+ ): ResolvedPageType {
36
+ if (typeof entry === 'string') {
37
+ return {
38
+ type: entry.trim(),
39
+ slugField: defaults.slugField,
40
+ path: null,
41
+ pathPrefix: null,
42
+ titleField: defaults.titleField,
43
+ }
44
+ }
45
+
46
+ // `path` gagne sur `slugField` : une page à chemin fixe (l'accueil) n'a pas
47
+ // de slug à lire, même si le type en porte un par ailleurs.
48
+ const path = typeof entry.path === 'string' ? normalizePath(entry.path) : null
49
+ const slugField =
50
+ entry.slugField === null ? null : (entry.slugField?.trim() || defaults.slugField)
51
+
52
+ // Un préfixe vide ou '/' vaut « à la racine » : pas de préfixe.
53
+ const prefix = typeof entry.pathPrefix === 'string' ? normalizePath(entry.pathPrefix) : '/'
54
+
55
+ return {
56
+ type: (entry.type ?? '').trim(),
57
+ slugField: path ? null : slugField,
58
+ path,
59
+ // Conservé même avec `path` (qui gagne au calcul du chemin) : la validation
60
+ // peut ainsi signaler le préfixe inutile.
61
+ pathPrefix: prefix === '/' ? null : prefix,
62
+ titleField: entry.titleField?.trim() || defaults.titleField,
63
+ }
64
+ }
65
+
66
+ /** Applique les valeurs par défaut. Ne valide rien : voir `validateConfig`. */
67
+ export function resolveConfig(input: NcfKitConfig): ResolvedKitConfig {
68
+ const slugField = input.slugField?.trim() || DEFAULT_SLUG_FIELD
69
+ const titleField = input.titleField?.trim() || DEFAULT_TITLE_FIELD
70
+
71
+ const pageTypes = (Array.isArray(input.pageTypes) ? input.pageTypes : []).map((entry) =>
72
+ resolvePageType(entry, {slugField, titleField}),
73
+ )
74
+
75
+ const i18n =
76
+ input.i18n === false || input.i18n === undefined
77
+ ? null
78
+ : {
79
+ field: input.i18n.field?.trim() || DEFAULT_I18N.field,
80
+ defaultLocale: input.i18n.defaultLocale?.trim() || DEFAULT_I18N.defaultLocale,
81
+ locales: input.i18n.locales ?? DEFAULT_I18N.locales,
82
+ }
83
+
84
+ return {
85
+ pageTypes,
86
+ pageTypeNames: pageTypes.map((p) => p.type).filter(Boolean),
87
+ pageBuilderField: input.pageBuilderField?.trim() || DEFAULT_PAGE_BUILDER_FIELD,
88
+ blockNamespace: input.blockNamespace ?? DEFAULT_BLOCK_NAMESPACE,
89
+ noindexFields: input.noindexField
90
+ ? [input.noindexField].flat().map((field) => field.trim()).filter(Boolean)
91
+ : DEFAULT_NOINDEX_FIELDS,
92
+ previewUrl: input.previewUrl ? trimTrailingSlash(input.previewUrl.trim()) : null,
93
+ environments: resolveEnvironments(input),
94
+ pageThumbnail: input.pageThumbnail?.trim() || null,
95
+ i18n,
96
+ componentPreview: {
97
+ provider: input.componentPreview?.provider ?? DEFAULT_COMPONENT_PREVIEW.provider,
98
+ path: input.componentPreview?.path ?? DEFAULT_COMPONENT_PREVIEW.path,
99
+ anchor: input.componentPreview?.anchor ?? DEFAULT_COMPONENT_PREVIEW.anchor,
100
+ thumbnail: input.componentPreview?.thumbnail ?? DEFAULT_COMPONENT_PREVIEW.thumbnail,
101
+ },
102
+ serviceEndpoint:
103
+ input.serviceEndpoint === false
104
+ ? null
105
+ : trimTrailingSlash((input.serviceEndpoint || DEFAULT_SERVICE_ENDPOINT).trim()),
106
+ history: input.history?.projectKey?.trim()
107
+ ? {
108
+ projectKey: input.history.projectKey.trim(),
109
+ endpoint: trimTrailingSlash(
110
+ (input.history.endpoint || input.serviceEndpoint || DEFAULT_SERVICE_ENDPOINT).trim(),
111
+ ),
112
+ }
113
+ : null,
114
+ tools: {...DEFAULT_TOOLS, ...input.tools},
115
+ boardTags: input.boardTags?.length ? input.boardTags : DEFAULT_BOARD_TAGS,
116
+ internalFields: input.internalFields?.length
117
+ ? input.internalFields
118
+ : DEFAULT_INTERNAL_FIELDS,
119
+ // Additif : le schéma du client fournit déjà l'essentiel, ceci ne sert
120
+ // qu'à ce qu'un parcours de schéma ne sait pas exprimer.
121
+ documentColumns: (input.documentColumns ?? []).map((column) => ({
122
+ key: column.key.trim(),
123
+ label: column.label?.trim() || column.key.trim(),
124
+ paths: [column.path].flat().map((path) => path.trim()).filter(Boolean),
125
+ type: column.type ?? 'text',
126
+ })),
127
+ }
128
+ }
129
+
130
+
131
+ /**
132
+ * Environnements d'aperçu.
133
+ *
134
+ * `previewUrl` en fournit toujours un, nommé « Production » : un projet qui
135
+ * n'en déclare pas d'autres doit quand même pouvoir basculer entre brouillons
136
+ * et contenu en ligne.
137
+ *
138
+ * Quand `environments` mentionne déjà `previewUrl`, on ne le double pas.
139
+ */
140
+ function resolveEnvironments(input: NcfKitConfig): NcfEnvironment[] {
141
+ const declared = (input.environments ?? [])
142
+ .map((environment) => ({
143
+ id: environment.id.trim(),
144
+ label: environment.label?.trim() || environment.id.trim(),
145
+ url: trimTrailingSlash((environment.url ?? '').trim()),
146
+ }))
147
+ .filter((environment) => environment.id && environment.url)
148
+
149
+ const preview = input.previewUrl ? trimTrailingSlash(input.previewUrl.trim()) : null
150
+ if (!preview || declared.some((environment) => environment.url === preview)) return declared
151
+
152
+ return [{id: 'production', label: 'Production', url: preview}, ...declared]
153
+ }