@nocode-factory/sanity-kit 2.68.0-rc.1 → 2.70.0-rc.2

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 (40) hide show
  1. package/CHANGELOG.md +37 -18
  2. package/dist/index.d.ts +48 -16
  3. package/dist/index.js +610 -383
  4. package/dist/index.js.map +1 -1
  5. package/package.json +1 -1
  6. package/src/hooks/useAssets.ts +1 -1
  7. package/src/hooks/useCollection.ts +5 -3
  8. package/src/hooks/useComponentDefaults.ts +1 -1
  9. package/src/hooks/useComponentNames.ts +1 -1
  10. package/src/hooks/usePageContents.ts +0 -1
  11. package/src/hooks/usePages.ts +5 -3
  12. package/src/hooks/useQueryData.ts +27 -59
  13. package/src/hooks/useRedirectMap.ts +1 -1
  14. package/src/hooks/useScheduledReleases.ts +27 -0
  15. package/src/hooks/useTranslationTodo.ts +1 -1
  16. package/src/hooks/useTranslationTodos.ts +0 -1
  17. package/src/lib/collectionRows.ts +26 -26
  18. package/src/lib/colors.ts +3 -6
  19. package/src/lib/pages.ts +16 -3
  20. package/src/lib/status.ts +118 -22
  21. package/src/tools/assets/AssetDetail.tsx +4 -4
  22. package/src/tools/assets/AssetTable.tsx +3 -3
  23. package/src/tools/collections/CollectionTable.tsx +53 -30
  24. package/src/tools/components/ComponentsTool.tsx +25 -2
  25. package/src/tools/pages/FieldValue.tsx +2 -2
  26. package/src/tools/pages/PagesTable.tsx +2 -2
  27. package/src/tools/pages/PagesTool.tsx +25 -2
  28. package/src/tools/pages/PathCell.tsx +1 -1
  29. package/src/tools/pages/TagCell.tsx +2 -2
  30. package/src/tools/pages/board/BoardView.tsx +2 -6
  31. package/src/tools/pages/board/PageNode.tsx +1 -1
  32. package/src/tools/pages/board/PagePanel.tsx +2 -2
  33. package/src/tools/presentation/PagesNavigator.tsx +1 -1
  34. package/src/ui/ActorName.tsx +1 -1
  35. package/src/ui/QuietInput.tsx +1 -1
  36. package/src/ui/StatusBadge.tsx +93 -7
  37. package/src/ui/StatusFilter.tsx +68 -0
  38. package/src/ui/formatDate.ts +2 -2
  39. package/src/version.ts +1 -1
  40. package/src/hooks/sharedListener.ts +0 -101
package/CHANGELOG.md CHANGED
@@ -1,29 +1,48 @@
1
1
  # Journal des versions
2
2
 
3
- ## 2.68.0 : le Studio interroge moins Sanity
3
+ ## 2.70.0 : on voit d'un coup d'œil ce qui est en ligne, modifié, programmé ou en brouillon
4
+
5
+ ### Ajouté
6
+
7
+ - **4 statuts de publication, les mêmes partout** : Draft (gris, jamais publié ou retiré
8
+ du site), Modified (orange, en ligne avec des modifications non publiées), Scheduled
9
+ (bleu, publication programmée), Published (vert, en ligne et à jour). Une seule pastille,
10
+ point de couleur ET libellé (lisible sans connaître le code couleur), dans les
11
+ collections (vue liste et vue tableur), l'onglet Pages, le board et le navigateur de
12
+ Presentation (qui montre désormais aussi les pages publiées).
13
+ - **Scheduled** : lu dans les publications programmées de Sanity (« Scheduled drafts »
14
+ comme Releases, même mécanisme). La date s'affiche à côté de la pastille ; l'infobulle
15
+ dit si l'item est déjà en ligne (mise à jour programmée) et s'il a en plus des
16
+ modifications en brouillon. Il prime sur Modified : c'est ce qui va changer sur le site.
17
+ - **Infobulle au survol** de chaque pastille : ce que veut dire le statut.
18
+ - **Filtres de statut** en haut des collections et de l'onglet Pages : All, Published,
19
+ Modified, Scheduled, Draft, avec le nombre d'items de chacun. Dans l'onglet Pages, les
20
+ nombres suivent la langue choisie.
21
+ - **Vue tableur des collections** : colonne Status juste après le titre, triable.
22
+ - **Onglet Components : vue « By group » ouverte par défaut** (au lieu de tous les
23
+ composants en vrac). Le choix « By group » ou non est mémorisé pour chaque utilisateur
24
+ (navigateur). Sans groupe créé, tout apparaît sous « Sans groupe », avec « New group ».
25
+
26
+ ### Corrigé
27
+
28
+ - Collections : une version programmée (release) créait une ligne en double, et un item
29
+ programmé jamais publié n'apparaissait nulle part. Les deux sont fusionnés comme les
30
+ pages.
31
+ - Collections : l'orange marquait le brouillon jamais publié ; il marque désormais
32
+ « Modified » (et le brouillon est gris).
33
+ - Plus aucun tiret cadratin dessiné dans les tableaux du kit (cellules vides des
34
+ collections, de l'onglet Pages et des médias, dates absentes) : cellule vide à la place.
4
35
 
5
36
  ### Changé
6
37
 
7
- - **Listes du Studio** (onglet Pages, tableaux des collections, médias, traductions,
8
- redirections) : avant, chaque frappe dans n'importe quel document relançait toute la
9
- liste, environ une fois par seconde, et chaque vue envoyait le document entier à chaque
10
- frappe. Désormais :
11
- - Sanity n'envoie qu'un signal « ça a changé », jamais le document ;
12
- - une seule écoute partagée par types, quel que soit le nombre de vues ouvertes, avec
13
- reconnexion automatique si elle tombe (avant : la liste s'arrêtait de suivre sans
14
- rien dire) ;
15
- - au plus un rechargement toutes les 3 secondes pendant une saisie ;
16
- - onglet du navigateur caché : rien n'est rechargé, la liste se met à jour au retour ;
17
- - la liste des redirections (publiées seulement) ne réagit plus aux brouillons.
18
- Pour l'utilisateur : les listes suivent avec 1 à 3 secondes de délai pendant une saisie ;
19
- le bouton de rafraîchissement force toujours la mise à jour.
20
- - **Étiquette sur chaque requête du kit** (`ncf-kit.pages`, `ncf-kit.collection.<type>`,
21
- `ncf-kit.assets`...) : visible dans les journaux de requêtes de Sanity (sanity.io/manage,
22
- projet, Usage, téléchargement des journaux), pour savoir qui consomme quoi.
38
+ - Libellé « Not published » renommé « Draft ».
39
+ - `STATUS_COLORS` (gris, orange, bleu, vert) a une source unique dans le kit
40
+ (`lib/status`), partagée par les pastilles, les filtres, la minimap et les couleurs du
41
+ board.
23
42
 
24
43
  ### À brancher dans le projet
25
44
 
26
- - Rien. Redéployer le Studio (`npm run deploy` dans studio/) : tout se passe dans le Studio.
45
+ - Rien. Mettre à jour le kit et redéployer le Studio (`npm run deploy` dans studio/).
27
46
 
28
47
  ## 2.67.0 : un seul interrupteur d'édition, celui de Sanity
29
48
 
package/dist/index.d.ts CHANGED
@@ -565,7 +565,13 @@ type RedirectMap = Map<string, string>;
565
565
  * Fusion des variantes d'un même document (publié / brouillon / version de
566
566
  * release) pour en déduire un statut unique affichable.
567
567
  */
568
- type PageStatus = 'published' | 'draft' | 'modified';
568
+ type PageStatus = 'published' | 'modified' | 'scheduled' | 'draft';
569
+ /**
570
+ * Publications programmées en cours : nom de la release -> date de publication
571
+ * (ISO). Seules les releases à l'état `scheduled` y figurent (« Scheduled
572
+ * drafts » comme Releases : c'est le même mécanisme dans Sanity).
573
+ */
574
+ type ScheduleMap = ReadonlyMap<string, string>;
569
575
  interface VersionedDoc {
570
576
  _id: string;
571
577
  _type: string;
@@ -589,23 +595,37 @@ interface MergedDoc<T extends VersionedDoc> {
589
595
  versions: Record<string, T>;
590
596
  /** Date de la modification la plus récente, toutes variantes confondues. */
591
597
  updatedAt?: string;
598
+ /** Date de publication programmée la plus proche (statut `scheduled`). */
599
+ scheduledAt?: string;
600
+ /** Une version publiée existe : l'item est sur le site. */
601
+ live: boolean;
602
+ /** Un brouillon existe (modifications non publiées). */
603
+ hasDraft: boolean;
592
604
  }
593
605
  /**
594
606
  * Regroupe les documents par identifiant de base.
595
607
  *
596
- * - publié seul -> 'published'
597
- * - brouillon seul -> 'draft' (jamais publié, absent du site)
608
+ * - publication programmée -> 'scheduled' (prime sur tout : c'est ce qui va changer)
598
609
  * - publié + brouillon -> 'modified' (modifications non publiées)
610
+ * - brouillon seul -> 'draft' (jamais publié ou retiré du site)
611
+ * - publié seul -> 'published'
599
612
  *
600
- * Les versions de release sont conservées mais n'influencent pas le statut :
601
- * elles ne sont ni en ligne, ni des modifications en attente au sens du Studio.
613
+ * Une version de release ne compte que si sa release est programmée
614
+ * (`schedules`) : une release en préparation n'est ni en ligne ni attendue.
615
+ * Un item qui n'existe QUE dans une release programmée (brouillon programmé,
616
+ * jamais publié) est bien listé, en `scheduled`.
602
617
  */
603
- export declare function mergeVersions<T extends VersionedDoc>(docs: readonly T[]): MergedDoc<T>[];
618
+ export declare function mergeVersions<T extends VersionedDoc>(docs: readonly T[], schedules?: ScheduleMap): MergedDoc<T>[];
604
619
  export declare const STATUS_LABELS: Record<PageStatus, {
605
620
  label: string;
606
- tone: 'positive' | 'caution' | 'default';
621
+ tone: 'positive' | 'caution' | 'primary' | 'default';
607
622
  help: string;
608
623
  }>;
624
+ /**
625
+ * Couleur de chaque statut, SOURCE UNIQUE pour le kit (pastilles, filtres,
626
+ * minimap et couleurs du board) : gris, orange, bleu, vert.
627
+ */
628
+ export declare const STATUS_COLORS: Record<PageStatus, string>;
609
629
  /** Document tel que le renvoie `buildPagesQuery`. */
610
630
  interface PageDoc extends VersionedDoc {
611
631
  ncfTitle?: string | null;
@@ -626,6 +646,12 @@ interface PageRow {
626
646
  url: string | null;
627
647
  locale: string | null;
628
648
  status: PageStatus;
649
+ /** Date de publication programmée (statut `scheduled`). */
650
+ scheduledAt?: string | null;
651
+ /** Une version publiée existe (l'item est en ligne). */
652
+ live?: boolean;
653
+ /** Un brouillon existe (modifications non publiées). */
654
+ hasDraft?: boolean;
629
655
  updatedAt: string | null;
630
656
  blockCount: number;
631
657
  /** Marquée non indexable dans le CMS. */
@@ -641,7 +667,7 @@ interface PageRow {
641
667
  * qu'une cellule vide.
642
668
  */
643
669
  export declare function formatDocumentValue(value: unknown, type: 'text' | 'boolean' | 'number', invert?: boolean): string;
644
- export declare function buildPageRows(docs: readonly PageDoc[], config: ResolvedKitConfig, documentColumns?: readonly ResolvedDocumentColumn[], redirects?: RedirectMap | null): PageRow[];
670
+ export declare function buildPageRows(docs: readonly PageDoc[], config: ResolvedKitConfig, documentColumns?: readonly ResolvedDocumentColumn[], redirects?: RedirectMap | null, schedules?: ScheduleMap): PageRow[];
645
671
  /**
646
672
  * `structure` reproduit l'ordre du Studio : les types dans l'ordre où
647
673
  * `pageTypes` les déclare, puis les titres. C'est l'ordre par défaut, celui
@@ -1483,7 +1509,7 @@ export declare function ActorName(props: {
1483
1509
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
1484
1510
  * le vérifie.
1485
1511
  */
1486
- export declare const KIT_VERSION = "2.68.0-rc.1";
1512
+ export declare const KIT_VERSION = "2.70.0-rc.2";
1487
1513
  /**
1488
1514
  * Données de la page proposées comme colonnes.
1489
1515
  *
@@ -1697,8 +1723,6 @@ export declare function groupValue(row: PageRow, groupBy: GroupBy, options: Grou
1697
1723
  export declare function groupPageRows(rows: readonly PageRow[], groupBy: GroupBy, options: GroupOptions): RowGroup[];
1698
1724
  /** Critère qui donne sa couleur à une page. */
1699
1725
  type ColorBy = 'tag' | 'status' | `field:${string}`;
1700
- /** Couleurs des statuts, alignées sur les tons des badges. */
1701
- export declare const STATUS_COLORS: Record<PageRow['status'], string>;
1702
1726
  /**
1703
1727
  * Applique une opacité à une couleur hexadécimale.
1704
1728
  *
@@ -2043,8 +2067,14 @@ interface CollectionRow {
2043
2067
  /** Id de base (sans `drafts.`), pour ouvrir le document. */
2044
2068
  id: string;
2045
2069
  updatedAt: string | null;
2046
- /** Vrai si l'item n'existe qu'en brouillon (jamais publié). */
2047
- draftOnly: boolean;
2070
+ /** Statut de publication (Draft, Modified, Scheduled, Published). */
2071
+ status: PageStatus;
2072
+ /** Date de publication programmée (statut `scheduled`). */
2073
+ scheduledAt?: string | null;
2074
+ /** Une version publiée existe (l'item est en ligne). */
2075
+ live?: boolean;
2076
+ /** Un brouillon existe (modifications non publiées). */
2077
+ hasDraft?: boolean;
2048
2078
  cells: Record<string, CollectionCell>;
2049
2079
  }
2050
2080
  /** Document tel que renvoyé par `buildCollectionQuery`. */
@@ -2055,10 +2085,12 @@ interface CollectionDoc {
2055
2085
  }
2056
2086
  /**
2057
2087
  * Documents → lignes, une par item. Le client (perspective `raw`) renvoie le
2058
- * brouillon ET la version publiée : on les fusionne par id de base, en gardant
2059
- * le brouillon s'il existe (valeurs les plus fraîches).
2088
+ * brouillon, la version publiée et les versions de release : on les fusionne
2089
+ * par id de base (`mergeVersions`, même règle que les pages), en gardant le
2090
+ * brouillon s'il existe (valeurs les plus fraîches). Une version de release non
2091
+ * programmée ne crée jamais de ligne à part.
2060
2092
  */
2061
- export declare function buildCollectionRows(docs: readonly CollectionDoc[], columns: readonly CollectionColumn[]): CollectionRow[];
2093
+ export declare function buildCollectionRows(docs: readonly CollectionDoc[], columns: readonly CollectionColumn[], schedules?: ScheduleMap): CollectionRow[];
2062
2094
  interface CollectionState {
2063
2095
  /** Toutes les colonnes possibles du type (pour le sélecteur). */
2064
2096
  allColumns: CollectionColumn[];