バージョニングポリシー

Sparkle DesignのバージョニングはSemantic Versioning 2.0.0open_in_newの原則に準じます。

バージョン番号はx.y.zのように表記します。

3つの数字を左から順に判定し、上位の変更ほど影響範囲が大きいことを示します。

セマンティック バージョニング 2.0.0Semantic Versioning spec and websitesemver.org

MAJOR.MINOR.PATCH
例: 2.4.1

Sparkle Design全体のバージョンです。チームが公式にサポートするAPIの挙動や整合性、全体最適を保証する境界を示すことが狙いです。

MAJOR.MINOR.SYSTEMPATCH-ARTIFACTPATCH
例: figma-lib@2.4.0-3

Figmaファイル, Figmaプラグイン, npmパッケージなどの個別要素のバージョンです。SystemVersion‑patch方式を採用しています。

Artifact内でのみ破壊的な変更を行う場合もSystem Versionを上げる対応を行います。

成果物ごとの独立したアップデートを許容しつつ、System Versionとの互換を即座に読み取れるようにすることが狙いです。

• コンポーネントのAPI (プロパティ) 修正
  • コンポーネントの特定のプロパティを廃止
  • コンポーネントの特定のプロパティの命名を変更

プラグインの後方互換性が破壊される修正や既に使用している箇所でビルドエラーが発生する変更も該当します

• 新規コンポーネントを追加
• コンポーネントに新規プロパティを追加

• バグ修正
• ドキュメントの誤字修正