TanStack React Charts 1.3.0: Was neu ist und wie Sie upgraden

TanStack React Charts 1.3.0 ist auf npm veröffentlicht. Dieser Guide zeigt, was das Registry-Record bestätigt, wie Sie upgraden und wie Sie Ihre Version prüfen.

Huifer
Huifer
6. November 202611 min read
Auch verfügbar auf:English · 中文

Geschrieben von Huifer, Solo-Entwickler und Maintainer von TanStack Ship. Ich halte für jede Charting-Abhängigkeit in meinen Templates ein kurzes Upgrade-Notizbuch, weil die Charts, die meine Kunden sehen — Umsatzlinien, Nutzungsbalken, Retention-Kurven — der erste Screenshot sind, den ein churned User macht. Eine stille Renderer-Änderung in einer Charting-Library ist genau die Art von Bug, den Sie erst nach einem Support-Ticket bemerken.

Verifizierte Quellen: TanStack · TanStack Charts · TanStack Charts auf GitHub · @tanstack/react-charts 1.3.0 auf npm · web.dev · Cloudflare Developers

Zuletzt aktualisiert: 6. November 2026

@tanstack/react-charts 1.3.0 ist auf dem npm-Registry veröffentlicht unter dem Paketnamen @tanstack/react-charts, und der Registry-Eintrag verweist in der Quelle auf das offizielle git+https://github.com/TanStack/charts.git-Repository. Der verifizierte Eintrag bestätigt, dass die Version existiert und woher sie kommt; dieser Guide erklärt, wie Sie sie sicher upgraden und wie Sie überprüfen, was bei Ihnen installiert ist — denn die von mir geprüften Registry-Fakten enthalten keinen Feature-Changelog, kein Veröffentlichungsdatum und kein Statement, daher werde ich diese hier nicht erfinden.

TL;DR

  • Measured: @tanstack/react-charts@1.3.0 ist auf npm veröffentlicht; der Registry-Eintrag nennt das Paket und verweist auf git+https://github.com/TanStack/charts.git.
  • Measured: die gepflegte Quelle liegt im offiziellen TanStack/charts-Repository auf GitHub.
  • Measured: die Registry-Fakten, die ich verwendet habe, enthalten keine Featureliste, kein Veröffentlichungsdatum und kein Statement des Maintainers — daher beschreibt dieser Artikel Verifikations- und Upgrade-Schritte, nicht neue Features.
  • Estimated: behandeln Sie jeden Bump einer Charting-Library als Hinweis auf einen Re-Render-Check Ihrer vorhandenen Charts, weil eine Charting-Abhängigkeit Dashboards und Berichte betrifft.
  • User-provided: keine — jede obige Tatsache stammt aus dem öffentlichen npm-Record oder dem offiziellen Repository, nicht von einem Kunden oder Dashboard.

Kurzantwort: @tanstack/react-charts 1.3.0 ist ein veröffentlichter Release von TanStacks React-Charting-Library auf npm. Der Registry-Eintrag bestätigt Version und offizielles Quell-Repository, enthält aber keine Featureliste — prüfen Sie neues Verhalten anhand der offiziellen Release Notes, bevor Sie upgraden.

TanStack React Charts 1.3.0: Was neu ist und wie Sie upgraden

Dieser Guide richtet sich an zwei Leserprofile. Erstens den Entwickler, der @tanstack/react-charts in einer Lockfile gepinnt hat und gerade ein Upgrade-Ticket bekommen hat. Zweitens den Gründer, der eine SaaS-Ausgangsbasis evaluiert und wissen will, ob die Charting-Schicht in einem Template tatsächlich gepflegt wird oder eine von niemandem betreute, handgeschriebene SVG ist. Wenn Sie zur ersten Gruppe gehören, springen Sie zu der Upgrade-Checkliste. Wenn Sie zur zweiten gehören, lesen Sie Welche Template-Funktionalität diese Version unterstützt und überspringen Sie den Rest.

Alles im Folgenden stützt sich auf den npm-Registry-Eintrag für @tanstack/react-charts@1.3.0 und das offizielle Repository. Wo der Eintrag sich bedeckt hält, sage ich das, statt die Lücke aus der Erinnerung zu füllen.

Was der npm-Registry-Eintrag wirklich bestätigt

Die einzige Quelle der Wahrheit für „ist 1.3.0 erschienen, und von wo?“ ist die veröffentlichte Registry-Metadaten. Das ist, was sie beweist.

Das Paket und seine offizielle Quelle

Registry-FeldWert in @tanstack/react-charts@1.3.0
Paket@tanstack/react-charts
Version1.3.0
Quell-Repositorygit+https://github.com/TanStack/charts.git
Offizielle Seiteregistry.npmjs.org/@tanstack/react-charts/1.3.0
Upstream-OrgTanStack auf GitHub

Diese Tabelle ist alles, was die mir vorliegenden Registry-Fakten bestätigen. Das Repository-Feld ist operativ der wichtige Eintrag: eine Version, die von der offiziellen TanStack/charts-Org veröffentlicht wurde, stammt aus derselben Quelllinie, die Sie auf GitHub prüfen — und das macht ein Upgrade überprüfbar.

Was der Eintrag nicht enthält

Ich möchte die Lücke konkret benennen, denn „Release-Guide“ impliziert üblicherweise eine Featureliste, und ich schreibe bewusst keine:

  • Kein Feature-Changelog. Der README-Auszug der Faktendatei ist leer, daher gibt es in der von mir geprüften Quelle keine dokumentierte Liste dessen, was sich in 1.3.0 geändert hat.
  • Kein Veröffentlichungs-Timestamp. Anders als bei Releases, deren Registry-Payload einen Veröffentlichungszeitpunkt trägt, enthalten die von mir verwendeten Fakten keinen — daher werde ich kein Datum angeben.
  • Kein Statement oder Benchmark des Maintainers. Nichts im Eintrag stützt eine Performance- oder Migrationsaussage.

Wenn Sie den tatsächlichen Delta brauchen, sind die autoritativen Orte die Release Notes des TanStack/charts-Repositorys und die offiziellen Charts-Dokumente. Ich verlinke diese, statt sie zu paraphrasieren, denn das Paraphrasieren eines leeren Eintrags würde bedeuten, ihn zu erfinden.

Was bei 1.3.0 neu ist — und was der Eintrag nicht sagt

Warum ich keine Features aus dem Gedächtnis aufliste

Ein Charting-Release kann das Achsenverhalten, das Tooltip-Rendering oder den Headless-Core verändern, auf dem der React-Wrapper basiert. Jede davon wäre relevant für Ihre App. Aber die verifizierten Fakten für 1.3.0 beschreiben sie nicht, und die Regel für diesen Artikel ist streng: jede Release-Aussage an die Faktendatei anhängen; Release-Details niemals erfinden. Die ehrliche „Was neu ist“-Antwort lautet also: das Registry bestätigt, dass 1.3.0 existiert und woher sie kommt; es dokumentiert den Feature-Delta nicht im mir vorliegenden Eintrag.

Wo die echte Changelog steht

Um zu erfahren, was sich tatsächlich geändert hat, gehen Sie zur Quelle, nicht zu einer Zusammenfassung:

  1. Öffnen Sie die offizielle @tanstack/react-charts 1.3.0-Registry auf npm und lesen Sie die Metadaten der Version.
  2. Öffnen Sie die TanStack/charts Releases-Seite auf GitHub für die getaggten Notes.
  3. Lesen Sie die TanStack Charts Dokumentation für alle in den Notes erwähnten API- oder Prop-Änderungen.

Behandeln Sie diese drei als kanonische Referenzen. Alles andere — auch dieser Artikel — ist ein Verifikationshilfsmittel, kein Changelog.

So upgraden Sie @tanstack/react-charts auf 1.3.0

Sie brauchen keine Featureliste für ein sicheres Upgrade. Sie müssen wissen, was Sie haben, in einem einzigen Commit ändern und Ihre Charts neu rendern.

Schritt 1 — Prüfen Sie Ihre aktuell installierte Version

Bevor Sie die Version anheben, prüfen Sie, was in Ihrem Tree tatsächlich aufgelöst ist:

bash
# Welche Version des Charting-Pakets ist gerade installiert?
npm ls @tanstack/react-charts

# Oder lesen Sie sie direkt aus node_modules
node -p "require('@tanstack/react-charts/package.json').version"

# Zeigen Sie, ob eine neuere Version verfügbar ist
npm outdated @tanstack/react-charts

Wenn npm ls eine Version zeigt, die Sie nicht erwartet haben (z. B. einen transitiven Pin aus einem anderen Paket), ist das das, was Sie vor dem Bump lösen müssen — nicht danach.

Schritt 2 — Heben Sie das Paket in einem Commit an

Ändern Sie die Version und committen Sie dazu die Lockfile. Eine Version, die in package.json steht, aber nicht in der Lockfile, ist kein Upgrade:

json
{
  "dependencies": {
    "@tanstack/react-charts": "1.3.0"
  }
}

Nach dem Bearbeiten installieren Sie neu, damit die Lockfile hinterherkommt, und führen Sie dann die Prüfung aus Schritt 1 erneut aus, um zu bestätigen, dass der Tree jetzt 1.3.0 auflöst:

bash
npm install
npm ls @tanstack/react-charts

Wenn Ihr Projekt von einem Headless-Core abhängt, auf dem das React-Wrapper aufbaut, heben Sie auch diesen in demselben Commit an — aber nur, nachdem die offiziellen Notes die exakt kompatible Version bestätigt haben. Die von mir geprüften Registry-Fakten nannten keine Version des Begleitpakets, daher behaupte ich hier keine.

Schritt 3 — Rendern Sie Ihre Charts neu, bevor Sie shippen

Ein Charting-Bump ist eines der wenigen Upgrades, bei denen „es kompiliert“ nicht „es funktioniert“ heißt. Rendern Sie die Charts neu, die Ihre Nutzer tatsächlich sehen — Dashboards, Abrechnungsberichte, Admin-Screens — und bestätigen Sie, dass Achsen, Tooltips und Legenden korrekt aussehen. Wenn das ohne menschliches Auge geschehen soll, fängt ein winziger Pre-Deploy-Guard eine fehlende oder unerwartete Version ab:

typescript
// scripts/check-charts-version.ts — läuft vor einem Deploy in der CI
import { readFileSync } from 'node:fs'

const pkg = JSON.parse(readFileSync('package.json', 'utf8'))
const installed = pkg.dependencies?.['@tanstack/react-charts']

if (installed !== '1.3.0') {
  console.error('Expected @tanstack/react-charts 1.3.0, found:', installed)
  process.exit(1)
}
console.log('@tanstack/react-charts aligned:', installed)

Welche Template-Funktionalität diese Version unterstützt

Eine Charting-Schicht ist kein Feature, das Sie am Ende noch anbauen — sie ist die Oberfläche, auf die Ihre Nutzer starren, wenn sie fragen „läuft das Business gut?“. Die Kauffrage, die dieser Release beantwortet, ist konkret: liefert das Template, das Sie evaluieren, eine gepflegte, quellüberprüfbare Charting-Library — oder eine handgeschriebene SVG, die niemand betreut?

Drei Dinge trennen ein echtes Charting-Setup von einem Bespoke-Aufbau, und genau das liefert ein versioniertes, offiziell bezogenes Paket wie @tanstack/react-charts: die Quelle ist bis zum offiziellen TanStack/charts-Repository nachvollziehbar, der Upgrade-Weg ist ein einzelner, auditierbarer Versionsanstieg statt eines Forks, und das Verhalten ist in der offiziellen Charts-Dokumentation dokumentiert statt im Kopf eines einzelnen Entwicklers.

Deshalb ist bei dem Blick darauf, welche SaaS-Templates eine gepflegte Charting-Schicht liefern die Datenvisualisierungs-Zeile eine, die ich früh prüfe: ein Template, das eine Charting-Abhängigkeit ohne klare Upgrade-Geschichte ausliefert oder eine von niemandem betreute Custom-Chart bereitstellt, kostet im ersten Monat mehr, als es beim Kauf spart. Um ein stimmiges Setup in einer fertigen App zu sehen, stöbern Sie in den Templates und prüfen Sie, wie die Charts gekabelt sind, bevor Sie irgendetwas anderes tun. Der Caveat: eine gut versionierte Upstream-Library beweist nicht für sich allein die Versionsdisziplin eines darauf aufgebauten Produkts.

Einschränkungen und Offenlegung

In diesem Artikel verwendete Aussagekategorien. Measured bedeutet, direkt aus dem npm-Registry-Eintrag oder dem Feld des offiziellen Repositorys gelesen. Estimated meint meine Einschätzung zum Upgrade-Risiko. User-provided bedeutet nichts: keine Kennzahl in diesem Artikel stammt von einem Kunden, Dashboard oder Dritten. Calculated- und proxy-Aussagen kommen nicht vor, weil der von mir geprüfte Eintrag keine Zahlen zum Berechnen oder als Proxy lieferte.

Was ich nicht getan habe. Ich habe keine neuen Features, Performance-Zugewinne oder Migrationsschritte für 1.3.0 beschrieben, weil die mir vorliegenden Registry-Fakten keinen Changelog, Datum oder Statement enthalten, an die man sie anhängen könnte. Ich habe auch nichts benchmarked, weil es keine dokumentierte Verhaltensänderung im Eintrag gibt, die man benchmarken könnte. Wenn die Maintainer eine Änderung ausgeliefert haben, die der Registry-Payload nicht zeigt, wird dieser Guide sie nicht zeigen — sehen Sie im TanStack/charts-Repository nach dem Source-Diff und den Release Notes.

Offenlegung. Ich betreibe TanStack Ship, und die oben verlinkten Templates sind meine eigenen Produkte. Ich habe keine materielle Verbindung zu irgendeinem in diesem Artikel genannten Dritten, und dieser Post ersetzt nicht das Lesen der offiziellen Release Notes.

Fazit und nächste Schritte

@tanstack/react-charts 1.3.0 ist ein realer, quellüberprüfbarer Release auf npm: das Registry bestätigt Version und offizielle Herkunft, auch wenn der von mir geprüfte Eintrag den Feature-Delta nicht dokumentiert. Upgraden Sie ihn so sorgfältig wie jede Charting-Abhängigkeit — prüfen Sie, was installiert ist, heben Sie ihn in einem Commit mit der Lockfile an und rendern Sie Ihre Charts neu, bevor Sie shippen.

Nächste Schritte: sehen Sie, welche SaaS-Templates eine gepflegte Charting-Schicht ausliefern und prüfen Sie in jedem die Datenvisualisierungs-Zeile, dann stöbern Sie in den Templates und sehen Sie sich dasjenige im Preview an, dessen Charting-Setup Sie nicht neu schreiben müssten. Für die Library selbst lesen Sie die TanStack Charts Übersicht, bevor Sie sie adoptieren.

FAQ: TanStack React Charts 1.3.0

Ist @tanstack/react-charts 1.3.0 ein Breaking Change?

Ich kann das aus den von mir geprüften Registry-Fakten nicht bestätigen, weil sie keinen Changelog oder API-Delta enthalten. Was ich bestätigen kann: 1.3.0 wird vom offiziellen TanStack/charts-Repository auf npm veröffentlicht. Lesen Sie vor dem Upgrade die Release Notes auf GitHub und die Charts-Dokumentation; wenn die Notes eine Major-Version- oder API-Änderung beschreiben, behandeln Sie es als Breaking und planen eine Migration statt eines stillen Bumps.

Wie prüfe ich, welche Version bei mir installiert ist?

Führen Sie in Ihrem Projekt npm ls @tanstack/react-charts aus, oder drucken Sie die aufgelöste Version mit node -p "require('@tanstack/react-charts/package.json').version". Mit npm outdated @tanstack/react-charts sehen Sie, ob eine neuere Version verfügbar ist. Prüfen Sie nach jedem Bump, ob die Lockfile die erwartete Version auflöst, denn eine Version in package.json ohne passenden Lockfile-Eintrag ist kein echtes Upgrade.

Soll ich auf 1.3.0 upgraden oder auf eine neuere Linie?

Nach der Versionsreihenfolge ist 1.3.0 ein älterer Release als 1.4.0 — wenn Sie neu starten oder modernisieren, prüfen Sie daher, ob eine neuere Linie das bessere Ziel ist, bevor Sie 1.3.0 pinnen. Die von mir geprüften Registry-Fakten beschreiben nicht, was sich zwischen beiden geändert hat — prüfen Sie den Delta daher zuerst in den offiziellen Notes, heben Sie in einem Commit an und bestätigen Sie visuell, dass Ihre Dashboards weiterhin korrekt rendern.

Wo ist der offizielle Changelog für diesen Release?

Die autoritativen Referenzen sind der npm-Eintrag für @tanstack/react-charts@1.3.0, die TanStack/charts Releases-Seite auf GitHub und die TanStack Charts Dokumentation. Ich verlinke diese, statt sie zusammenzufassen, weil die Registry-Fakten, die ich verwendet habe, keinen Feature-Changelog zum Zusammenfassen enthielten.

Mehr zu diesem Thema

Dieser Artikel ist der Hub zum Thema. Die folgenden Beiträge vertiefen einzelne Aspekte.