Für Anwendungsentwickler

Von v1 migrieren

oria-standard@2 ist der standardmäßige und einzige Standardvertrag: Registrieren Sie eine explizite Migration, überprüfen Sie die Geometrierundung und lassen Sie Bootstrap veraltete Snapshots zurückweisen.

Der Standardvertrag wurde geändert

Seit Core 0.3.0 lösen Core/Runtime-APIs, die ohne Vertrag aufgerufen werden, oria-standard@2 auf: 134 Quelltokens, kleingeschriebene CSS-Variablen und deklarierte abgeleitete Variablen. v1 verbleibt nur als Legacy-Exporte für Migrationseingaben (oriaStandardContractV1, oriaDefaultThemeV1, migrateOriaStandardV1ToV2). Offizielle Voreinstellungen sind native v2 mit unveränderten IDs. v1-camelCase-Variablen (z. B. --oria-color-background, --oria-typography-size-md, --oria-spacing-4) werden nicht mehr ausgegeben; Aktualisieren Sie Ihre eigenen Stile auf v2-Namen (--oria-color-bg, --oria-text-md, calc(var(--oria-space) * 4)).

Registrieren Sie den Migrator explizit

Wenn Ihre Benutzer möglicherweise über benutzerdefinierte Designs der Version 1 verfügen (Speicher oder exportiertes JSON), registrieren Sie den Migrator in der Laufzeitkonfiguration. Persistente v1-Designs werden dann migriert, vollständig validiert, atomar angewendet und beim ersten Start zurückgeschrieben; Ohne Registrierung werden v1-Daten als Ganzes abgelehnt und bleiben bei diesem Start unberührt.

import { migrateOriaStandardV1ToV2 } from "@oriatheme/core";
import { oriaPresetThemes } from "@oriatheme/presets";

createOriaThemeRuntime({
  presets: oriaPresetThemes,
  defaultThemeId: "oria-default",
  migrations: [migrateOriaStandardV1ToV2],
});

Der Fluss „requiresReview“.

v2 speichert nur zwei Geometriequellen, Raum und Radius: Radien sind feste Vielfache und Kontrollgrößen sind ganzzahlige Vielfache des Raums von 1 bis 24. Ein v1-Wert, der nicht genau dargestellt werden kann, rastet auf den nächsten zulässigen Wert ein und gibt eine Warnung pro Feld aus; „requiresReview“ ist immer dann „true“, wenn eine Warnung vorliegt. Das importTheme von Core gibt Warnungen zurück und erfordert eine Überprüfung, damit Benutzer vor dem Speichern eine Vorschau anzeigen und bestätigen können. Das importTheme der Laufzeit wendet registrierte Migrationen automatisch an, enthält jedoch keine Warnungen.

Bootstrap lehnt veraltete Snapshots ab

Durch die Übergabe des v2-Vertrags an bootstrapTheme oder createBootstrapStorageScript werden aktive Snapshots der v1-Ära sicher abgelehnt, wobei der statische Standardwert CSS beibehalten wird, bis die Laufzeit ein v2-Design anwendet und einen neuen Snapshot schreibt. Ohne die Deklaration findet keine solche Prüfung statt.

Weiter: Laufzeitkonfiguration