@3fn/core 14.1.0 → 15.0.0

package/dist/tokens/BlurTokens.d.ts

@@ -17,7 +17,9 @@
  * - blur200: 32   (base × 2)
  * - blur250: 40   (base × 2.5)
  *
- * All values are multiples of 4 (baseline grid aligned).
+ * All values are multiples of 4 (the 4-unit subgrid). The `baselineGridAlignment`
+ * flag tracks the 8-unit baseline grid, so the 4/12/20 steps carry `false` — see
+ * the predicate on `PrimitiveToken.baselineGridAlignment`.
  */
 import { PrimitiveToken } from '../types/PrimitiveToken';
 export declare const BLUR_BASE_VALUE = 16;

package/dist/tokens/BlurTokens.js

@@ -18,7 +18,9 @@
  * - blur200: 32   (base × 2)
  * - blur250: 40   (base × 2.5)
  *
- * All values are multiples of 4 (baseline grid aligned).
+ * All values are multiples of 4 (the 4-unit subgrid). The `baselineGridAlignment`
+ * flag tracks the 8-unit baseline grid, so the 4/12/20 steps carry `false` — see
+ * the predicate on `PrimitiveToken.baselineGridAlignment`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.blurNames = exports.blur = exports.BLUR_BASE_VALUE = void 0;
@@ -53,7 +55,7 @@ exports.blur = {
         familyBaseValue: exports.BLUR_BASE_VALUE,
         description: 'Blur 025 - minimal blur',
         mathematicalRelationship: `base × 0.25 = ${exports.BLUR_BASE_VALUE} × 0.25 = ${exports.BLUR_BASE_VALUE * 0.25}`,
-        baselineGridAlignment: true,
+        baselineGridAlignment: false, // 4-unit subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateBlurPlatformValues(exports.BLUR_BASE_VALUE * 0.25)
@@ -77,7 +79,7 @@ exports.blur = {
         familyBaseValue: exports.BLUR_BASE_VALUE,
         description: 'Blur 075 - moderate blur',
         mathematicalRelationship: `base × 0.75 = ${exports.BLUR_BASE_VALUE} × 0.75 = ${exports.BLUR_BASE_VALUE * 0.75}`,
-        baselineGridAlignment: true,
+        baselineGridAlignment: false, // 4-unit subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateBlurPlatformValues(exports.BLUR_BASE_VALUE * 0.75)
@@ -101,7 +103,7 @@ exports.blur = {
         familyBaseValue: exports.BLUR_BASE_VALUE,
         description: 'Blur 125 - strong blur',
         mathematicalRelationship: `base × 1.25 = ${exports.BLUR_BASE_VALUE} × 1.25 = ${exports.BLUR_BASE_VALUE * 1.25}`,
-        baselineGridAlignment: true,
+        baselineGridAlignment: false, // 4-unit subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateBlurPlatformValues(exports.BLUR_BASE_VALUE * 1.25)

package/dist/tokens/ShadowOffsetTokens.js

@@ -54,7 +54,7 @@ exports.shadowOffsetX = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Sunrise shadow offset - large left offset',
         mathematicalRelationship: 'base × -3 = 4 × -3 = -12',
-        baselineGridAlignment: true, // 12 is 4px baseline grid aligned
+        baselineGridAlignment: false, // 4-unit shadow subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE * -3)
@@ -66,7 +66,7 @@ exports.shadowOffsetX = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Strategic flexibility - medium-large left offset',
         mathematicalRelationship: 'base × -2 = 4 × -2 = -8',
-        baselineGridAlignment: true, // 8 is 4px baseline grid aligned
+        baselineGridAlignment: true, // 8 aligns with the 8-unit baseline grid
         isStrategicFlexibility: true,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE * -2)
@@ -78,7 +78,7 @@ exports.shadowOffsetX = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Morning shadow offset - medium left offset',
         mathematicalRelationship: 'base × -1.5 = 4 × -1.5 = -6',
-        baselineGridAlignment: false, // 6 is not 4px baseline grid aligned (strategic flexibility)
+        baselineGridAlignment: false, // 6 is a strategic flexibility value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: true,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE * -1.5)
@@ -90,7 +90,7 @@ exports.shadowOffsetX = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Strategic flexibility - small left offset',
         mathematicalRelationship: 'base × -1 = 4 × -1 = -4',
-        baselineGridAlignment: true, // 4 is 4px baseline grid aligned
+        baselineGridAlignment: false, // 4-unit shadow subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: true,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE * -1)
@@ -102,7 +102,7 @@ exports.shadowOffsetX = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Noon shadow offset - no horizontal offset',
         mathematicalRelationship: 'base × 0 = 4 × 0 = 0',
-        baselineGridAlignment: true, // 0 is baseline grid aligned
+        baselineGridAlignment: true, // 0 aligns with the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(0)
@@ -114,7 +114,7 @@ exports.shadowOffsetX = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Strategic flexibility - small right offset',
         mathematicalRelationship: 'base × 1 = 4 × 1 = 4',
-        baselineGridAlignment: true, // 4 is 4px baseline grid aligned
+        baselineGridAlignment: false, // 4-unit shadow subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: true,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE)
@@ -126,7 +126,7 @@ exports.shadowOffsetX = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Dusk shadow offset - medium right offset',
         mathematicalRelationship: 'base × 1.5 = 4 × 1.5 = 6',
-        baselineGridAlignment: false, // 6 is not 4px baseline grid aligned (strategic flexibility)
+        baselineGridAlignment: false, // 6 is a strategic flexibility value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: true,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE * 1.5)
@@ -138,7 +138,7 @@ exports.shadowOffsetX = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Strategic flexibility - medium-large right offset',
         mathematicalRelationship: 'base × 2 = 4 × 2 = 8',
-        baselineGridAlignment: true, // 8 is 4px baseline grid aligned
+        baselineGridAlignment: true, // 8 aligns with the 8-unit baseline grid
         isStrategicFlexibility: true,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE * 2)
@@ -150,7 +150,7 @@ exports.shadowOffsetX = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Sunset shadow offset - large right offset',
         mathematicalRelationship: 'base × 3 = 4 × 3 = 12',
-        baselineGridAlignment: true, // 12 is 4px baseline grid aligned
+        baselineGridAlignment: false, // 4-unit shadow subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE * 3)
@@ -175,7 +175,7 @@ exports.shadowOffsetY = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'No vertical offset - flat surface with no shadow',
         mathematicalRelationship: 'base × 0 = 4 × 0 = 0',
-        baselineGridAlignment: true, // 0 is baseline grid aligned
+        baselineGridAlignment: true, // 0 aligns with the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(0)
@@ -187,7 +187,7 @@ exports.shadowOffsetY = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Depth 100 / Noon - short shadow',
         mathematicalRelationship: 'base × 1 = 4 × 1 = 4',
-        baselineGridAlignment: true, // 4 is 4px baseline grid aligned
+        baselineGridAlignment: false, // 4-unit shadow subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE)
@@ -199,7 +199,7 @@ exports.shadowOffsetY = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Depth 200 - medium shadow',
         mathematicalRelationship: 'base × 2 = 4 × 2 = 8',
-        baselineGridAlignment: true, // 8 is 4px baseline grid aligned
+        baselineGridAlignment: true, // 8 aligns with the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE * 2)
@@ -211,7 +211,7 @@ exports.shadowOffsetY = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Morning/Dusk - medium-long shadow',
         mathematicalRelationship: 'base × 3 = 4 × 3 = 12',
-        baselineGridAlignment: true, // 12 is 4px baseline grid aligned
+        baselineGridAlignment: false, // 4-unit shadow subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE * 3)
@@ -223,7 +223,7 @@ exports.shadowOffsetY = {
         familyBaseValue: exports.SHADOW_OFFSET_BASE_VALUE,
         description: 'Depth 300 / Sunrise/Sunset - long shadow',
         mathematicalRelationship: 'base × 4 = 4 × 4 = 16',
-        baselineGridAlignment: true, // 16 is 4px baseline grid aligned
+        baselineGridAlignment: true, // 16 aligns with the 8-unit baseline grid (8 × 2)
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateShadowOffsetPlatformValues(exports.SHADOW_OFFSET_BASE_VALUE * 4)

package/dist/tokens/SizingTokens.js

@@ -48,7 +48,7 @@ exports.sizingTokens = {
         familyBaseValue: exports.SIZING_BASE_VALUE,
         description: 'Size 050 - smallest component dimension',
         mathematicalRelationship: `base × 0.5 = ${exports.SIZING_BASE_VALUE} × 0.5 = ${exports.SIZING_BASE_VALUE * 0.5}`,
-        baselineGridAlignment: true,
+        baselineGridAlignment: false, // 4-unit subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateSizingPlatformValues(exports.SIZING_BASE_VALUE * 0.5)
@@ -72,7 +72,7 @@ exports.sizingTokens = {
         familyBaseValue: exports.SIZING_BASE_VALUE,
         description: 'Size 150 - small component dimension',
         mathematicalRelationship: `base × 1.5 = ${exports.SIZING_BASE_VALUE} × 1.5 = ${exports.SIZING_BASE_VALUE * 1.5}`,
-        baselineGridAlignment: true,
+        baselineGridAlignment: false, // 4-unit subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateSizingPlatformValues(exports.SIZING_BASE_VALUE * 1.5)
@@ -96,7 +96,7 @@ exports.sizingTokens = {
         familyBaseValue: exports.SIZING_BASE_VALUE,
         description: 'Size 250 - medium component dimension',
         mathematicalRelationship: `base × 2.5 = ${exports.SIZING_BASE_VALUE} × 2.5 = ${exports.SIZING_BASE_VALUE * 2.5}`,
-        baselineGridAlignment: true,
+        baselineGridAlignment: false, // 4-unit subgrid value; not a multiple of the 8-unit baseline grid
         isStrategicFlexibility: false,
         isPrecisionTargeted: false,
         platforms: generateSizingPlatformValues(exports.SIZING_BASE_VALUE * 2.5)

package/dist/tokens/TapAreaTokens.d.ts

@@ -3,12 +3,14 @@
  *
  * Tap area tokens use precision multipliers to achieve specific accessibility targets
  * while maintaining baseline grid alignment where possible.
- * Base value: 44 units (WCAG 2.1 AA minimum tap target size)
+ * Base value: 44 units — WCAG 2.5.5 Target Size (Level AAA), which also exceeds the
+ * WCAG 2.2 AA minimum of 24×24 (SC 2.5.8 Target Size (Minimum)).
  * Mathematical progression: Precision-targeted multipliers for accessibility compliance
  */
 import { PrimitiveToken } from '../types/PrimitiveToken';
 /**
- * Tap area token base value for mathematical calculations (WCAG 2.1 AA minimum)
+ * Tap area token base value for mathematical calculations
+ * (WCAG 2.5.5 Target Size, Level AAA — 44×44)
  */
 export declare const TAP_AREA_BASE_VALUE = 44;
 /**
@@ -29,6 +31,15 @@ export declare function getTapAreaToken(name: string): PrimitiveToken | undefine
 export declare function getAllTapAreaTokens(): PrimitiveToken[];
 /**
  * Validate tap area meets accessibility requirements
+ *
+ * Thresholds follow the WCAG success criteria, not platform guidelines:
+ * - ≥44: SC 2.5.5 Target Size (Level AAA)
+ * - ≥24: SC 2.5.8 Target Size (Minimum) (Level AA, WCAG 2.2)
+ * - <24: below the AA minimum
+ *
+ * Note: SC 2.5.8 additionally allows targets under 24×24 when sufficient spacing
+ * or an equivalent alternative exists. This function checks size only; spacing
+ * exceptions must be evaluated in component context.
  */
 export declare function validateTapAreaAccessibility(tapAreaValue: number): {
     isAccessible: boolean;

package/dist/tokens/TapAreaTokens.js

@@ -4,7 +4,8 @@
  *
  * Tap area tokens use precision multipliers to achieve specific accessibility targets
  * while maintaining baseline grid alignment where possible.
- * Base value: 44 units (WCAG 2.1 AA minimum tap target size)
+ * Base value: 44 units — WCAG 2.5.5 Target Size (Level AAA), which also exceeds the
+ * WCAG 2.2 AA minimum of 24×24 (SC 2.5.8 Target Size (Minimum)).
  * Mathematical progression: Precision-targeted multipliers for accessibility compliance
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -14,7 +15,8 @@ exports.getAllTapAreaTokens = getAllTapAreaTokens;
 exports.validateTapAreaAccessibility = validateTapAreaAccessibility;
 const PrimitiveToken_1 = require("../types/PrimitiveToken");
 /**
- * Tap area token base value for mathematical calculations (WCAG 2.1 AA minimum)
+ * Tap area token base value for mathematical calculations
+ * (WCAG 2.5.5 Target Size, Level AAA — 44×44)
  */
 exports.TAP_AREA_BASE_VALUE = 44;
 /**
@@ -36,7 +38,7 @@ exports.tapAreaTokens = {
         category: PrimitiveToken_1.TokenCategory.TAP_AREA,
         baseValue: exports.TAP_AREA_BASE_VALUE,
         familyBaseValue: exports.TAP_AREA_BASE_VALUE,
-        description: 'Minimum tap area - WCAG 2.1 AA compliance (44pt)',
+        description: 'Minimum tap area - WCAG 2.5.5 Target Size, Level AAA (44pt); exceeds the 24pt WCAG 2.2 AA minimum (SC 2.5.8)',
         mathematicalRelationship: 'base × 1 = 44 × 1 = 44',
         baselineGridAlignment: false,
         isStrategicFlexibility: false,
@@ -98,18 +100,27 @@ function getAllTapAreaTokens() {
 }
 /**
  * Validate tap area meets accessibility requirements
+ *
+ * Thresholds follow the WCAG success criteria, not platform guidelines:
+ * - ≥44: SC 2.5.5 Target Size (Level AAA)
+ * - ≥24: SC 2.5.8 Target Size (Minimum) (Level AA, WCAG 2.2)
+ * - <24: below the AA minimum
+ *
+ * Note: SC 2.5.8 additionally allows targets under 24×24 when sufficient spacing
+ * or an equivalent alternative exists. This function checks size only; spacing
+ * exceptions must be evaluated in component context.
  */
 function validateTapAreaAccessibility(tapAreaValue) {
-    if (tapAreaValue >= 44) {
-        if (tapAreaValue >= 48) {
-            return { isAccessible: true, level: 'AAA' };
-        }
+    if (tapAreaValue >= exports.TAP_AREA_BASE_VALUE) {
+        return { isAccessible: true, level: 'AAA' };
+    }
+    if (tapAreaValue >= 24) {
         return { isAccessible: true, level: 'AA' };
     }
     return {
         isAccessible: false,
         level: 'Below AA',
-        recommendation: `Increase tap area to at least ${exports.TAP_AREA_BASE_VALUE}pt for WCAG 2.1 AA compliance`
+        recommendation: `Increase tap area to at least 24pt for WCAG 2.2 AA compliance (SC 2.5.8), or ${exports.TAP_AREA_BASE_VALUE}pt for Level AAA (SC 2.5.5)`
     };
 }
 //# sourceMappingURL=TapAreaTokens.js.map

package/dist/tokens/semantic/ColorTokens.js

@@ -97,12 +97,23 @@ exports.colorTokens = {
      * @see .kiro/specs/051-semantic-token-naming-restructure/design-outline.md
      */
     // Feedback - Success (3 tokens)
+    /**
+     * WCAG remediation (2026-09-12, Spec 112 audit finding F4):
+     * This token previously referenced green400 (OKLCH 0.66 0.18 154), which measures
+     * 2.84:1 against color.structure.canvas (white100) — below the 4.5:1 AA floor for
+     * normal text. Remapped to green500 (OKLCH 0.54 0.14 154) = 4.72:1 on white100.
+     * The dark theme carries a Level 2 override to green300 (4.63:1 on the dark canvas,
+     * gray400) — see src/tokens/themes/dark/SemanticOverrides.ts.
+     *
+     * Guarded by src/tokens/__tests__/SemanticColorContrast.test.ts.
+     * No primitive OKLCH values were changed; green400 remains the ramp step it was.
+     */
     'color.feedback.success.text': {
         name: 'color.feedback.success.text',
-        primitiveReferences: { value: 'green400' },
+        primitiveReferences: { value: 'green500' },
         category: SemanticToken_1.SemanticCategory.COLOR,
         context: 'Text color for success feedback messages and indicators',
-        description: 'Green text color for success states - form validation, confirmation messages, positive feedback'
+        description: 'Green text color for success states - form validation, confirmation messages, positive feedback. References green500 for WCAG AA contrast (4.72:1) against the light canvas; dark theme overrides to green300 (4.63:1 against the dark canvas).'
     },
     'color.feedback.success.background': {
         name: 'color.feedback.success.background',
@@ -350,26 +361,60 @@ exports.colorTokens = {
         description: 'Purple for data visualization, metrics, and data-related elements'
     },
     // Text Hierarchy (4 tokens)
+    /**
+     * WCAG remediation (2026-09-13, interim dark-text-hierarchy fix, Peter-ratified;
+     * .kiro/issues/2026-09-12-semantic-contrast-adjudication-queue.md):
+     * The light-mode primitive (gray300) is unchanged and remains AA-passing against
+     * the light canvas. Against the dark canvas (color.structure.canvas → gray400) it
+     * measured 1.536:1 — well below the 4.5:1 AA floor for normal text. The dark theme
+     * carries a Level 2 override to white100 (8.46:1 on gray400) — see
+     * src/tokens/themes/dark/SemanticOverrides.ts.
+     *
+     * Guarded by src/tokens/__tests__/SemanticColorContrast.test.ts.
+     * No primitive OKLCH values were changed.
+     */
     'color.text.default': {
         name: 'color.text.default',
         primitiveReferences: { value: 'gray300' },
         category: SemanticToken_1.SemanticCategory.COLOR,
         context: 'Primary text color for body content',
-        description: 'Primary gray for main text content'
+        description: 'Primary gray for main text content. Dark theme overrides to white100 (8.46:1 against the dark canvas) for WCAG AA.'
     },
+    /**
+     * WCAG remediation (2026-09-13, interim dark-text-hierarchy fix, Peter-ratified;
+     * .kiro/issues/2026-09-12-semantic-contrast-adjudication-queue.md):
+     * The light-mode primitive (gray200) is unchanged. Against the dark canvas it
+     * measured 2.324:1 — below the 4.5:1 AA floor. The dark theme carries a Level 2
+     * override to white300 (6.28:1 on gray400) — see
+     * src/tokens/themes/dark/SemanticOverrides.ts.
+     *
+     * Guarded by src/tokens/__tests__/SemanticColorContrast.test.ts.
+     * No primitive OKLCH values were changed.
+     */
     'color.text.muted': {
         name: 'color.text.muted',
         primitiveReferences: { value: 'gray200' },
         category: SemanticToken_1.SemanticCategory.COLOR,
         context: 'Muted text color for secondary content',
-        description: 'Muted gray for secondary and less prominent text'
+        description: 'Muted gray for secondary and less prominent text. Dark theme overrides to white300 (6.28:1 against the dark canvas) for WCAG AA.'
     },
+    /**
+     * WCAG remediation (2026-09-13, interim dark-text-hierarchy fix, Peter-ratified;
+     * .kiro/issues/2026-09-12-semantic-contrast-adjudication-queue.md):
+     * The light-mode primitive (gray100) is unchanged. Against the dark canvas it
+     * measured 3.411:1 — below the 4.5:1 AA floor. The dark theme carries a Level 2
+     * override to white500 (4.53:1 on gray400) — see
+     * src/tokens/themes/dark/SemanticOverrides.ts.
+     *
+     * Guarded by src/tokens/__tests__/SemanticColorContrast.test.ts.
+     * No primitive OKLCH values were changed.
+     */
     'color.text.subtle': {
         name: 'color.text.subtle',
         primitiveReferences: { value: 'gray100' },
         category: SemanticToken_1.SemanticCategory.COLOR,
         context: 'Subtle text color for tertiary content',
-        description: 'Subtle gray for tertiary and very subtle text elements'
+        description: 'Subtle gray for tertiary and very subtle text elements. Dark theme overrides to white500 (4.53:1 against the dark canvas) for WCAG AA.'
     },
     // ============================================================================
     // CONTRAST CONCEPT: Content on colored backgrounds

package/dist/tokens/semantic/TypographyTokens.js

@@ -45,7 +45,7 @@ exports.typographyTokens = {
         },
         category: SemanticToken_1.SemanticCategory.TYPOGRAPHY,
         context: 'Small body text for secondary content and compact layouts',
-        description: 'Small body typography with 14px font size, 1.25 line height, body font family, normal weight'
+        description: 'Small body typography with 14px font size, 1.429 line height, body font family, normal weight'
     },
     'typography.bodyMd': {
         name: 'typography.bodyMd',
@@ -71,7 +71,7 @@ exports.typographyTokens = {
         },
         category: SemanticToken_1.SemanticCategory.TYPOGRAPHY,
         context: 'Large body text for emphasis, lead paragraphs, and prominent content',
-        description: 'Large body typography with 18px font size, 1.75 line height, body font family, normal weight'
+        description: 'Large body typography with 18px font size, 1.556 line height, body font family, normal weight'
     },
     // Heading Hierarchy (H1-H6 following HTML semantics)
     'typography.h1': {
@@ -205,7 +205,7 @@ exports.typographyTokens = {
         },
         category: SemanticToken_1.SemanticCategory.TYPOGRAPHY,
         context: 'Small button text for compact buttons and tertiary actions',
-        description: 'Small button typography with 14px font size, 1.25 line height, body font family, medium weight'
+        description: 'Small button typography with 14px font size, 1.429 line height, body font family, medium weight'
     },
     'typography.buttonMd': {
         name: 'typography.buttonMd',
@@ -231,7 +231,7 @@ exports.typographyTokens = {
         },
         category: SemanticToken_1.SemanticCategory.TYPOGRAPHY,
         context: 'Large button text for prominent CTAs and hero buttons',
-        description: 'Large button typography with 18px font size, 1.75 line height, body font family, medium weight'
+        description: 'Large button typography with 18px font size, 1.556 line height, body font family, medium weight'
     },
     'typography.input': {
         name: 'typography.input',
@@ -258,7 +258,7 @@ exports.typographyTokens = {
         },
         category: SemanticToken_1.SemanticCategory.TYPOGRAPHY,
         context: 'Extra small labels for floating label patterns in form inputs',
-        description: 'Extra small label typography with 13px font size, 1.0 line height, body font family, medium weight for floating labels'
+        description: 'Extra small label typography with 13px font size, 1.538 line height, body font family, medium weight for floating labels'
     },
     'typography.labelSm': {
         name: 'typography.labelSm',
@@ -271,7 +271,7 @@ exports.typographyTokens = {
         },
         category: SemanticToken_1.SemanticCategory.TYPOGRAPHY,
         context: 'Small labels for compact form fields and UI elements',
-        description: 'Small label typography with 14px font size, 1.25 line height, body font family, medium weight'
+        description: 'Small label typography with 14px font size, 1.429 line height, body font family, medium weight'
     },
     'typography.labelMd': {
         name: 'typography.labelMd',
@@ -301,7 +301,7 @@ exports.typographyTokens = {
         },
         category: SemanticToken_1.SemanticCategory.TYPOGRAPHY,
         context: 'Floated label state for text input fields with float label pattern',
-        description: `Medium label typography scaled to ${labelMdFloatFontSize}px (fontSize100 × scale088) for floated label state, maintains same lineHeight, fontFamily, fontWeight, and letterSpacing as labelMd to prevent layout shift during animation`
+        description: `Medium label typography scaled to ${labelMdFloatFontSize}px (fontSize100 × scale088) for floated label state, 1.429 line height (lineHeight075, the pairing for the scaled fontSize), body font family, medium weight, default letter spacing — fontFamily, fontWeight, and letterSpacing match labelMd`
     },
     'typography.labelLg': {
         name: 'typography.labelLg',
@@ -314,7 +314,7 @@ exports.typographyTokens = {
         },
         category: SemanticToken_1.SemanticCategory.TYPOGRAPHY,
         context: 'Large labels for prominent form sections and UI headers',
-        description: 'Large label typography with 18px font size, 1.75 line height, body font family, medium weight'
+        description: 'Large label typography with 18px font size, 1.556 line height, body font family, medium weight'
     },
     // Code Text Size Variants
     'typography.codeSm': {
@@ -328,7 +328,7 @@ exports.typographyTokens = {
         },
         category: SemanticToken_1.SemanticCategory.TYPOGRAPHY,
         context: 'Small code text for inline code in compact layouts',
-        description: 'Small code typography with 14px font size, 1.25 line height, monospace font family, normal weight'
+        description: 'Small code typography with 14px font size, 1.429 line height, monospace font family, normal weight'
     },
     'typography.codeMd': {
         name: 'typography.codeMd',
@@ -354,7 +354,7 @@ exports.typographyTokens = {
         },
         category: SemanticToken_1.SemanticCategory.TYPOGRAPHY,
         context: 'Large code text for prominent code examples and documentation',
-        description: 'Large code typography with 18px font size, 1.75 line height, monospace font family, normal weight'
+        description: 'Large code typography with 18px font size, 1.556 line height, monospace font family, normal weight'
     }
 };
 /**

package/dist/tokens/themes/dark/SemanticOverrides.js

@@ -17,7 +17,7 @@ exports.darkSemanticOverrides = void 0;
 // ======================================================================
 // FEEDBACK — SUCCESS
 // ======================================================================
-// color.feedback.success.text: { value: 'green400' }
+// color.feedback.success.text: { value: 'green500' }  [OVERRIDDEN below → green300]
 // color.feedback.success.background: { value: 'green100' }
 // color.feedback.success.border: { value: 'green400' }
 // ======================================================================
@@ -76,9 +76,9 @@ exports.darkSemanticOverrides = void 0;
 // ======================================================================
 // TEXT HIERARCHY
 // ======================================================================
-// color.text.default: { value: 'gray300' }
-// color.text.muted: { value: 'gray200' }
-// color.text.subtle: { value: 'gray100' }
+// color.text.default: { value: 'gray300' }  [OVERRIDDEN below → white100]
+// color.text.muted: { value: 'gray200' }  [OVERRIDDEN below → white300]
+// color.text.subtle: { value: 'gray100' }  [OVERRIDDEN below → white500]
 // ======================================================================
 // CONTRAST
 // ======================================================================
@@ -139,6 +139,23 @@ exports.darkSemanticOverrides = void 0;
 // Add populated overrides here as they are confirmed by component specs.
 // Each key must match a semantic token name in the registry.
 exports.darkSemanticOverrides = {
+    // WCAG AA remediation (2026-09-12, Spec 112 audit finding F4)
+    // Light base is green500 (4.72:1 on white100). Against the dark canvas
+    // (color.structure.canvas → gray400) green500 measures only 1.79:1, so dark mode
+    // needs a LIGHTER step: green300 = 4.63:1 on gray400. Guarded by
+    // src/tokens/__tests__/SemanticColorContrast.test.ts.
+    'color.feedback.success.text': { primitiveReferences: { value: 'green300' } },
+    // WCAG AA remediation (2026-09-13, interim dark-text-hierarchy fix; Peter-ratified;
+    // .kiro/issues/2026-09-12-semantic-contrast-adjudication-queue.md)
+    // Light base primitives (gray300/gray200/gray100) render on the dark canvas
+    // (color.structure.canvas → gray400) at 1.536:1 / 2.324:1 / 3.411:1 — all below the
+    // 4.5:1 AA floor for normal text. Remapped to white-ramp steps measured against
+    // gray400: white100 = 8.46:1, white300 = 6.28:1, white500 = 4.53:1. Interim fix —
+    // the other adjudication-queue exemption pairs remain deferred to a future spec.
+    // Guarded by src/tokens/__tests__/SemanticColorContrast.test.ts.
+    'color.text.default': { primitiveReferences: { value: 'white100' } },
+    'color.text.muted': { primitiveReferences: { value: 'white300' } },
+    'color.text.subtle': { primitiveReferences: { value: 'white500' } },
     // Nav-TabBar-Base overrides (Spec 050 Ada R2, 2026-03-17)
     'color.structure.canvas': { primitiveReferences: { value: 'gray400' } },
     'color.action.navigation': { primitiveReferences: { value: 'cyan100' } },

package/dist/tools/integrity/Invariants.d.ts

@@ -11,7 +11,7 @@
  *     This is exactly how Finding 1 hid (216 rgba in both committed and fresh).
  *
  *   - P5 (theme-varying rule): the index's `themeVarying` set must be the
- *     dist base-mode set (5 keys), NOT the registry-wide set (10 keys). A future
+ *     dist base-mode set (EXPECTED_BASE_THEME_VARYING), NOT the registry-wide set. A future
  *     "simplification" that pipes the registry-wide Set through to the index would
  *     reproduce identically committed-vs-fresh while silently re-breaking R5.
  *     (§4.1 residual risk, Task 3 completion.)
@@ -30,14 +30,29 @@
 export declare const SHADOW_COLOR_PRIMITIVES: readonly ["shadowBlack100", "shadowBlue100", "shadowOrange100", "shadowGray100"];
 /**
  * The base-scoped theme-varying set the INDEX must mark `themeVarying: true`
- * (the 5 dist base-mode dark-override keys). This is the readout the index uses;
- * it is deliberately NOT the registry-wide 10 (which over-includes WCAG-only
+ * (the dist base-mode dark-override keys). This is the readout the index uses;
+ * it is deliberately NOT the registry-wide set (which over-includes WCAG-only
  * contrast keys). See Task 3 completion §"Why two theme-varying sets coexist".
+ *
+ * This list grows when a token gains a genuine base-mode DARK override in
+ * src/tokens/themes/dark/SemanticOverrides.ts — that is the invariant holding, not
+ * breaking. It must NEVER grow by absorbing a WCAG_ONLY_OVERMARKS key; that is the
+ * §4.1 regression the anti-conflation sentinel below names.
+ *
+ * 5 → 6 on 2026-09-12: `color.feedback.success.text` gained a dark override
+ * (green500 → green300) as part of the WCAG AA remediation of the Spec 112
+ * completion-claims audit finding F4. See
+ * .kiro/issues/2026-09-12-spec-112-completion-claims-audit.md § F4.
+ *
+ * 6 → 9 on 2026-09-13: `color.text.default`, `color.text.muted`, and
+ * `color.text.subtle` each gained a dark override (white100/white300/white500) as
+ * part of the interim dark-text-hierarchy fix, Peter-ratified. See
+ * .kiro/issues/2026-09-12-semantic-contrast-adjudication-queue.md.
  */
-export declare const EXPECTED_BASE_THEME_VARYING: readonly ["color.action.navigation", "color.background.primary.subtle", "color.icon.navigation.inactive", "color.structure.border.subtle", "color.structure.canvas"];
+export declare const EXPECTED_BASE_THEME_VARYING: readonly ["color.action.navigation", "color.background.primary.subtle", "color.feedback.success.text", "color.icon.navigation.inactive", "color.structure.border.subtle", "color.structure.canvas", "color.text.default", "color.text.muted", "color.text.subtle"];
 /**
- * Sentinel WCAG-only over-marks: keys that the registry-wide set (10) marks but
- * the base-scoped set (5) must NOT. If any of these is `themeVarying: true`, the
+ * Sentinel WCAG-only over-marks: keys that the registry-wide set marks but
+ * the base-scoped set must NOT. If any of these is `themeVarying: true`, the
  * index has been silently re-wired to the registry-wide Set — the §4.1 regression.
  * (This is the anti-conflation guard's negative assertion.)
  */
@@ -63,12 +78,12 @@ export declare function rgbaColorPrimitives(primitivesYaml: string): string[];
  * P5 — theme-varying is the base-scoped set, NOT the registry-wide set.
  *
  * Two assertions (both must hold):
- *   (a) the index's `themeVarying: true` set equals EXACTLY the expected 5 base keys
+ *   (a) the index's `themeVarying: true` set equals EXACTLY the expected base keys
  *       (a missing or extra key is a divergence from the dist base-mode set); and
  *   (b) NONE of the known WCAG-only over-marks is `themeVarying: true` — the
  *       anti-conflation guard. (b) is redundant with (a) when (a) holds, but it
  *       is the explicit, named regression sentinel: if a future change pipes the
- *       registry-wide 10 through to the index, (b) names exactly which over-marks
+ *       registry-wide set through to the index, (b) names exactly which over-marks
  *       reappeared, making the §4.1 re-break legible rather than a generic "extra key".
  */
 export declare function assertThemeVaryingBaseScoped(semanticsYaml: string): InvariantViolation[];