@domandigital/craft 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @domandigital/craft
 
+## 0.5.0
+
+### Minor Changes
+
+- f49922c: A font size in `em` or `%` counts against its own budget, not the type scale's.
+
+  `code { font-size: 0.875em }` does not add a step to a scale. It states one
+  relationship — code is 87.5% of whatever it sits in — and applies it wherever
+  code appears. Counting it as a step is the same category error section 9 already
+  corrected once for the framework's theme: a number that is not part of the
+  vocabulary a reader has to hold.
+
+  They are still counted, under `maxRelativeFontSizes` (house value 3), because
+  the failure they can cause is real — eight competing ratios is as unreadable as
+  eight competing steps. Split, not dropped. A value that stops being reported is
+  a value that grows.
+
+  `counts.relativeFontSizes` is new; `counts.fontSizes` now excludes them, so a
+  surface using `em` will report a lower scale count than under 0.4.0.
+
+  Only bare ratios move: `0.875em` and `75%` are relative, `0.875rem` is not, and
+  neither is a composite like `max(16px, 1em)`.
+
 ## 0.4.0
 
 ### Minor Changes

package/STANDARD.md

@@ -113,6 +113,14 @@ Images: AVIF and WebP, in that order.
 Per surface: **≤10 font sizes, ≤3 weights, ≤2 families** (plus mono),
 **≤4 radii, ≤4 shadows**, accent hues clustered within **15° OKLCh**.
 
+A size written in `em` or `%` counts separately, **≤3**. It is a ratio, not a
+step: `code { font-size: 0.875em }` states one relationship and applies it
+wherever code appears, rather than adding a rung to the ladder. Counting it
+against the scale is the same category error as counting the framework's theme.
+It is still counted, because eight competing ratios is as unreadable as eight
+competing steps — split, not dropped. A value that stops being reported is a
+value that grows.
+
 Differentiation guards pass anything that differs from its siblings, however
 ugly. What they cannot see is accumulation — eighteen font sizes, six shadows,
 four competing accents, each added reasonably, together reading as noise.
@@ -168,6 +176,7 @@ A rule here has to be one that is wrong to break. Everything else is a default.
 {
   "budget": {
     "maxFontSizes": 10,
+    "maxRelativeFontSizes": 3,
     "maxFontWeights": 3,
     "maxFontFamilies": 2,
     "maxRadii": 4,

package/dist/index.cjs

@@ -812,6 +812,7 @@ function densityTokens(name, rootPx = 16) {
 // src/restraint/index.ts
 var HOUSE_BUDGET = {
   maxFontSizes: 10,
+  maxRelativeFontSizes: 3,
   maxFontWeights: 3,
   maxFontFamilies: 2,
   maxRadii: 4,
@@ -963,7 +964,17 @@ function checkRestraint(input) {
   const push = (rule, severity, message, found) => {
     violations.push({ rule, severity, message, found });
   };
-  const fontSizes = distinctValues(css, "font-size", props, unresolved);
+  const allSizes = distinctValues(css, "font-size", props, unresolved);
+  const relativeSizes = allSizes.filter((v) => /^[\d.]+(em|%)$/.test(v));
+  const fontSizes = allSizes.filter((v) => !relativeSizes.includes(v));
+  if (relativeSizes.length > budget.maxRelativeFontSizes) {
+    push(
+      "relative-font-sizes",
+      "error",
+      `${relativeSizes.length} context-relative font sizes, budget ${budget.maxRelativeFontSizes}. A ratio is a relationship; more than a few and it is a second scale nobody named.`,
+      relativeSizes
+    );
+  }
   if (fontSizes.length > budget.maxFontSizes) {
     push(
       "font-sizes",
@@ -1146,6 +1157,7 @@ function checkRestraint(input) {
     violations,
     counts: {
       fontSizes: fontSizes.length,
+      relativeFontSizes: relativeSizes.length,
       fontWeights: allWeights.length,
       fontFamilies: families.length,
       radii: radii.length,

package/dist/index.d.cts

@@ -600,6 +600,8 @@ declare function densityTokens(name: DensityName, rootPx?: number): Record<strin
  */
 interface RestraintBudget {
     maxFontSizes: number;
+    /** Context-relative font sizes (`em`, `%`) -- ratios, not steps. See section 9. */
+    maxRelativeFontSizes: number;
     maxFontWeights: number;
     /** Excludes the monospace face, which is a functional choice not a stylistic one. */
     maxFontFamilies: number;

package/dist/index.d.ts

@@ -600,6 +600,8 @@ declare function densityTokens(name: DensityName, rootPx?: number): Record<strin
  */
 interface RestraintBudget {
     maxFontSizes: number;
+    /** Context-relative font sizes (`em`, `%`) -- ratios, not steps. See section 9. */
+    maxRelativeFontSizes: number;
     maxFontWeights: number;
     /** Excludes the monospace face, which is a functional choice not a stylistic one. */
     maxFontFamilies: number;

package/dist/index.js

@@ -740,6 +740,7 @@ function densityTokens(name, rootPx = 16) {
 // src/restraint/index.ts
 var HOUSE_BUDGET = {
   maxFontSizes: 10,
+  maxRelativeFontSizes: 3,
   maxFontWeights: 3,
   maxFontFamilies: 2,
   maxRadii: 4,
@@ -891,7 +892,17 @@ function checkRestraint(input) {
   const push = (rule, severity, message, found) => {
     violations.push({ rule, severity, message, found });
   };
-  const fontSizes = distinctValues(css, "font-size", props, unresolved);
+  const allSizes = distinctValues(css, "font-size", props, unresolved);
+  const relativeSizes = allSizes.filter((v) => /^[\d.]+(em|%)$/.test(v));
+  const fontSizes = allSizes.filter((v) => !relativeSizes.includes(v));
+  if (relativeSizes.length > budget.maxRelativeFontSizes) {
+    push(
+      "relative-font-sizes",
+      "error",
+      `${relativeSizes.length} context-relative font sizes, budget ${budget.maxRelativeFontSizes}. A ratio is a relationship; more than a few and it is a second scale nobody named.`,
+      relativeSizes
+    );
+  }
   if (fontSizes.length > budget.maxFontSizes) {
     push(
       "font-sizes",
@@ -1074,6 +1085,7 @@ function checkRestraint(input) {
     violations,
     counts: {
       fontSizes: fontSizes.length,
+      relativeFontSizes: relativeSizes.length,
       fontWeights: allWeights.length,
       fontFamilies: families.length,
       radii: radii.length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domandigital/craft",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "private": false,
   "description": "The Doman Digital house craft standard as numbers: OKLCh colour ramps that snap to existing anchors, derived semantic tokens with measured WCAG and APCA contrast, one shared motion vocabulary for CSS and JS, and a base stylesheet. Zero dependencies.",
   "license": "Apache-2.0",