@hirobius/design-system 0.22.0 → 0.23.1

package/upgrade/releases/0.23.1.json

@@ -0,0 +1,108 @@
+{
+  "version": "0.23.1",
+  "date": "2026-10-11",
+  "bump": "patch",
+  "summary": "6 that look different.",
+  "backfilled": false,
+  "steps": [
+    {
+      "id": "0.23.1/value-changed/--hds-font-family",
+      "kind": "value-changed",
+      "impact": "look",
+      "plain": "The scoped HDS font variable now names Plus Jakarta Sans first instead of Satoshi.",
+      "detect": {
+        "cssVars": [
+          "--hds-font-family"
+        ],
+        "cssVarWrites": [
+          "--hds-font-family"
+        ]
+      },
+      "facts": [
+        "css-var-changed:--hds-font-family::root"
+      ],
+      "source": "CHANGELOG.md:20"
+    },
+    {
+      "id": "0.23.1/value-changed/--primitive-typography-family-display",
+      "kind": "value-changed",
+      "impact": "look",
+      "plain": "Display and title text now renders in Plus Jakarta Sans instead of Satoshi.",
+      "detect": {
+        "cssVars": [
+          "--primitive-typography-family-display"
+        ],
+        "cssVarWrites": [
+          "--primitive-typography-family-display"
+        ]
+      },
+      "facts": [
+        "css-var-changed:--primitive-typography-family-display::root"
+      ],
+      "source": "CHANGELOG.md:20"
+    },
+    {
+      "id": "0.23.1/value-changed/--primitive-typography-family-primary",
+      "kind": "value-changed",
+      "impact": "look",
+      "plain": "Body, UI and caption text now renders in Plus Jakarta Sans instead of Satoshi.",
+      "detect": {
+        "cssVars": [
+          "--primitive-typography-family-primary"
+        ],
+        "cssVarWrites": [
+          "--primitive-typography-family-primary"
+        ]
+      },
+      "facts": [
+        "css-var-changed:--primitive-typography-family-primary::root"
+      ],
+      "source": "CHANGELOG.md:20"
+    },
+    {
+      "id": "0.23.1/look/font-face-Satoshi-400-normal",
+      "kind": "look",
+      "impact": "look",
+      "plain": "fonts.css no longer declares Satoshi 400; it declares Plus Jakarta Sans 400 instead, so drop any font-family: Satoshi of your own.",
+      "detect": {
+        "regex": [
+          "Satoshi"
+        ]
+      },
+      "facts": [
+        "font-face-removed:Satoshi/400/normal"
+      ],
+      "source": "CHANGELOG.md:20"
+    },
+    {
+      "id": "0.23.1/look/font-face-Satoshi-500-normal",
+      "kind": "look",
+      "impact": "look",
+      "plain": "fonts.css no longer declares Satoshi 500; it declares Plus Jakarta Sans 500 instead, so drop any font-family: Satoshi of your own.",
+      "detect": {
+        "regex": [
+          "Satoshi"
+        ]
+      },
+      "facts": [
+        "font-face-removed:Satoshi/500/normal"
+      ],
+      "source": "CHANGELOG.md:20"
+    },
+    {
+      "id": "0.23.1/look/font-face-Satoshi-700-normal",
+      "kind": "look",
+      "impact": "look",
+      "plain": "fonts.css no longer declares Satoshi 700; it declares Plus Jakarta Sans 700 instead, so drop any font-family: Satoshi of your own.",
+      "detect": {
+        "regex": [
+          "Satoshi"
+        ]
+      },
+      "facts": [
+        "font-face-removed:Satoshi/700/normal"
+      ],
+      "source": "CHANGELOG.md:20"
+    }
+  ]
+}

package/upgrade/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "@hirobius/design-system upgrade ledger",
-  "description": "Generated from scripts/upgrade/schema.mjs; do not edit. The root validates a release ledger (upgrade/releases/<version>.json); $defs.index validates upgrade/index.json, $defs.snapshot a release snapshot (docs/api/releases/<version>.json), $defs.pendingNote a changeset's upgrade note (upgrade/pending/<changeset>.json) and $defs.upgradeReport what the upgrade command prints with --json.",
+  "description": "Generated from scripts/upgrade/schema.mjs; do not edit. The root validates a release ledger (upgrade/releases/<version>.json); $defs.index validates upgrade/index.json, $defs.snapshot a release snapshot (docs/api/releases/<version>.json), $defs.cssContract dist/css-contract.json, $defs.pendingNote a changeset's upgrade note (upgrade/pending/<changeset>.json) and $defs.upgradeReport what the upgrade command prints with --json.",
   "$ref": "#/$defs/release",
   "$defs": {
     "auto": {
@@ -27,6 +27,115 @@
       "additionalProperties": false,
       "description": "The codemod that applies this step for the consumer."
     },
+    "cssContract": {
+      "type": "object",
+      "properties": {
+        "format": {
+          "type": "number",
+          "const": 1
+        },
+        "bundles": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "pattern": "\\.css$"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "classes": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "description": "Every class name a selector names, unescaped as written in className, sorted."
+              },
+              "fontFaces": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "family": {
+                      "type": "string"
+                    },
+                    "weight": {
+                      "type": "string"
+                    },
+                    "style": {
+                      "type": "string"
+                    },
+                    "src": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Each url() basename, data:<type> for an inlined face, or local(<name>)."
+                    }
+                  },
+                  "required": [
+                    "family",
+                    "weight",
+                    "style",
+                    "src"
+                  ],
+                  "additionalProperties": false
+                },
+                "description": "Each @font-face, sorted."
+              },
+              "layers": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "description": "The @layer names, in declaration order."
+              },
+              "variables": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string",
+                  "pattern": "^--"
+                },
+                "additionalProperties": {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                },
+                "description": "Each custom property declared in a context rule: context (the selector, after its enclosing at-rules, as minified) -> the value that wins there."
+              }
+            },
+            "required": [
+              "classes",
+              "fontFaces",
+              "layers",
+              "variables"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Each stylesheet package.json#exports names, by its exports key."
+        },
+        "publicClasses": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Classes the manifest declares public beyond the hds-* prefix (public/hds-manifest.json publicClasses)."
+        }
+      },
+      "required": [
+        "format",
+        "bundles",
+        "publicClasses"
+      ],
+      "additionalProperties": false,
+      "description": "dist/css-contract.json (scripts/build-css-contract.mjs, hds#449): the CSS surface of the stylesheets a release ships."
+    },
     "detect": {
       "type": "object",
       "properties": {
@@ -500,6 +609,10 @@
             "type": "string"
           },
           "description": "package.json#files."
+        },
+        "css": {
+          "description": "The CSS contract of its stylesheets; absent for a snapshot read from source, which has no built CSS.",
+          "$ref": "#/$defs/cssContract"
         }
       },
       "required": [