gt-sanity@4.0.0
Fernando AvilesPanoramica
gt-sanity v4 è pensato per Sanity Studio 6. Con la versione 6.9.2, Sanity è passato da @sanity/ui 3 a @sanity/ui 4 e i pacchetti Studio che includono questa modifica sono singleton di runtime; il plugin ora li risolve dal tuo Studio invece di includerne copie proprie.
Gli Studio con Sanity dalla versione 6.0 alla 6.8 usano ancora la generazione @sanity/ui 3 e dovrebbero rimanere su gt-sanity 3.1.x. Aggiorna prima Sanity alla versione 6.9.2 o successiva, quindi passa alla v4.
In v4 non cambia nulla nell'API del plugin né nei contenuti archiviati. Se il tuo Studio usa Sanity 6.9.2 o una versione successiva, l'aggiornamento richiede solo l'installazione.
Modifiche incompatibili
Sanity 6.9.2 e @sanity/ui 4 richiesti
L'intervallo peer di sanity è ora ^6.9.2. In precedenza era >=5.0.0, che accettava Sanity 6 anche se le dipendenze del plugin fissavano la generazione Sanity 5. Le installazioni venivano risolte senza problemi anziché generare un avviso, per cui poteva comparire un runtime di Studio duplicato senza alcun segnale visibile.
Tieni presente che si tratta di Sanity 6.9.2, non di una qualsiasi versione di Sanity 6. @sanity/ui 4 è stato introdotto nella versione 6.9.2, quindi gli Studio dalla 6.0 alla 6.8 usano ancora la generazione @sanity/ui 3. Aggiorna prima Sanity, quindi passa a gt-sanity 4.
I pacchetti di Studio sono ora dipendenze peer
@sanity/ui, @sanity/icons, @sanity/schema e @sanity/mutator erano dipendenze normali e ora sono dipendenze peer risolte dallo Studio host. Installarli insieme a una generazione diversa di Sanity comportava l'annidamento di una seconda copia, con registri di schema e contesti del tema di styled-components duplicati. Uno Studio Sanity 6.9.2+ fornisce già tutti e quattro i pacchetti, quindi non è necessario installare altro.
Le versioni minime per @sanity/document-internationalization e sanity-plugin-internationalized-array sono state portate rispettivamente a ^6.2.30 e ^5.1.27. Le precedenti versioni minime potevano risolversi in rilasci che supportano solo Sanity 5, creando un'altra situazione che porta a un runtime duplicato. La dipendenza inutilizzata @sanity/util è stata rimossa.
Solo ESM
La build CommonJS e la condizione di esportazione require sono state rimosse, in conformità con @sanity/ui 4. Importa il plugin usando la sintassi ESM import.
Node.js 22.12 o versioni successive
Rispetto alla 18, è in linea con sanity e @sanity/ui 4.
Restare su Sanity 5
gt-sanity 3.1.x resta la versione supportata per gli Studio Sanity 5 e per Sanity dalla 6.0 alla 6.8. Non è deprecata e scegliere di rimanere su questa versione è valido se non sei ancora pronto a migrare il tuo Studio.
npm install gt-sanity@^3.1Il set di funzionalità della v3 rimane invariato. Quando aggiorni Sanity alla versione 6.9.2 o successiva, il passaggio alla v4 non richiede modifiche al codice né ai contenuti.
Correzioni
Alcuni bug sono stati risolti con l'aggiornamento:
- Pubblica traduzioni eliminava interi gruppi di traduzioni quando un'impostazione regionale sorgente veniva rietichettata (ad esempio, da
enaen-US). La pubblicazione identificava la voce sorgente intranslation.metadatain base alla relativa etichetta linguistica, quindi un documento di metadati creato prima della modifica non trovava alcuna corrispondenza e il gruppo veniva ignorato senza errori. Ora le voci sorgente e di traduzione vengono distinte in base al documento a cui fanno riferimento. - Translate All e Import All ora mostrano l'avanzamento. In precedenza entrambi sembravano inattivi mentre un'esecuzione era ancora in corso, poiché ciascuno monitorava solo la propria richiesta anziché il lavoro messo in coda.
gtStructureItemsfissa una versione dell'API Sanity, eliminando un avviso di deprecazione che, secondo Sanity, diventerà un errore.