@3fn/core 14.0.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/component/progress.d.ts

@@ -19,16 +19,34 @@
  * @see .kiro/specs/048-progress-family/requirements.md (Requirements 5.7-5.15)
  * @see .kiro/specs/048-progress-family/design.md (Size Variant, Token Usage sections)
  */
+import type { RegisteredComponentToken } from '../../registries/ComponentTokenRegistry';
 /**
- * Progress Indicator component tokens defined using the hybrid authoring API.
+ * ONE CALL PER FAMILY.
+ *
+ * Every token registered by a single defineComponentTokens() call is stamped with that
+ * call's `family`, and the family drives platform output — notably the primitive class
+ * name emitted for reference-path tokens (TokenFileGenerator.getFamilyClassName) and the
+ * Android `.dp` suffix. These 10 tokens span THREE primitive families, so they require
+ * three calls. A single `family: 'spacing'` call previously produced
+ * `SpacingTokens.size150` / `SpacingTokens.borderWidth100` — members no generated platform
+ * file defines — the same defect fixed for Button-Icon in PR #126.
+ *
+ * The three branded results MUST NOT be spread/merged into one registration object: the
+ * rich metadata rides on a non-enumerable brand (src/build/tokens/defineComponentTokens.ts,
+ * TOKEN_CONTRACT_BRAND) that a spread silently drops. The harvest in loadComponentTokens
+ * collects each branded export separately. Use {@link progressTokenValues} for flat
+ * value lookups and {@link getProgressRegisteredTokens} for the rich metadata.
+ *
+ * All three calls declare `component: 'Progress'`, so platform output is still a single
+ * `ProgressTokens` Swift enum / Kotlin object.
+ */
+/**
+ * Node dimension tokens — reference sizing primitives (dimensions, not spacing).
  *
- * 13 tokens organized by concept:
  * - node.size.{sm|md|lg}         — base node dimensions
  * - node.size.{sm|md|lg}.current — emphasized node dimensions (+4px)
- * - node.gap.{sm|md|lg}          — spacing between nodes
- * - connector.thickness           — connector line width
  */
-export declare const ProgressTokens: import("../../build/tokens").ComponentTokenValues<{
+export declare const ProgressSizingTokens: import("../../build/tokens").ComponentTokenValues<{
     'node.size.sm': {
         reference: import("../../types").PrimitiveToken;
         reasoning: string;
@@ -53,6 +71,13 @@ export declare const ProgressTokens: import("../../build/tokens").ComponentToken
         reference: import("../../types").PrimitiveToken;
         reasoning: string;
     };
+}>;
+/**
+ * Node gap tokens — reference spacing primitives (gaps are spacing, not sizing).
+ *
+ * - node.gap.{sm|md|lg} — spacing between nodes
+ */
+export declare const ProgressSpacingTokens: import("../../build/tokens").ComponentTokenValues<{
     'node.gap.sm': {
         reference: import("../../types").PrimitiveToken;
         reasoning: string;
@@ -65,11 +90,46 @@ export declare const ProgressTokens: import("../../build/tokens").ComponentToken
         reference: import("../../types").PrimitiveToken;
         reasoning: string;
     };
+}>;
+/**
+ * Connector tokens — line connecting nodes in steppers. References a borderWidth primitive.
+ *
+ * - connector.thickness — connector line width
+ */
+export declare const ProgressBorderWidthTokens: import("../../build/tokens").ComponentTokenValues<{
     'connector.thickness': {
         reference: import("../../types").PrimitiveToken;
         reasoning: string;
     };
 }>;
+/**
+ * Flat value map across all three Progress token calls — a READ-ONLY convenience for
+ * value lookups (`progressTokenValues['node.size.md']`).
+ *
+ * NOT a registration surface: spreading drops the non-enumerable brand, so this object
+ * deliberately harvests to zero and cannot double-register. For the rich metadata use
+ * {@link getProgressRegisteredTokens}, never `getTokenContract(progressTokenValues)`.
+ */
+export declare const progressTokenValues: {
+    'connector.thickness': number;
+    'node.gap.sm': number;
+    'node.gap.md': number;
+    'node.gap.lg': number;
+    'node.size.sm': number;
+    'node.size.md': number;
+    'node.size.lg': number;
+    'node.size.sm.current': number;
+    'node.size.md.current': number;
+    'node.size.lg.current': number;
+};
+/**
+ * All Progress component tokens with their rich metadata, concatenated across the three
+ * family calls in declaration order (sizing → spacing → borderWidth).
+ *
+ * This is the brand-safe replacement for `getTokenContract(ProgressTokens)`, which is no
+ * longer meaningful now that Progress registers through three calls.
+ */
+export declare function getProgressRegisteredTokens(): RegisteredComponentToken[];
 /**
  * Expected token count for governance validation
  *

package/dist/tokens/component/progress.js

@@ -21,7 +21,8 @@
  * @see .kiro/specs/048-progress-family/design.md (Size Variant, Token Usage sections)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.progressComponentTokenNames = exports.PROGRESS_COMPONENT_TOKEN_COUNT = exports.ProgressTokens = void 0;
+exports.progressComponentTokenNames = exports.PROGRESS_COMPONENT_TOKEN_COUNT = exports.progressTokenValues = exports.ProgressBorderWidthTokens = exports.ProgressSpacingTokens = exports.ProgressSizingTokens = void 0;
+exports.getProgressRegisteredTokens = getProgressRegisteredTokens;
 exports.validateProgressComponentTokenCount = validateProgressComponentTokenCount;
 exports.getProgressComponentToken = getProgressComponentToken;
 exports.getAllProgressComponentTokens = getAllProgressComponentTokens;
@@ -30,20 +31,37 @@ const SpacingTokens_1 = require("../../tokens/SpacingTokens");
 const SizingTokens_1 = require("../../tokens/SizingTokens");
 const BorderWidthTokens_1 = require("../../tokens/BorderWidthTokens");
 /**
- * Progress Indicator component tokens defined using the hybrid authoring API.
+ * ONE CALL PER FAMILY.
+ *
+ * Every token registered by a single defineComponentTokens() call is stamped with that
+ * call's `family`, and the family drives platform output — notably the primitive class
+ * name emitted for reference-path tokens (TokenFileGenerator.getFamilyClassName) and the
+ * Android `.dp` suffix. These 10 tokens span THREE primitive families, so they require
+ * three calls. A single `family: 'spacing'` call previously produced
+ * `SpacingTokens.size150` / `SpacingTokens.borderWidth100` — members no generated platform
+ * file defines — the same defect fixed for Button-Icon in PR #126.
+ *
+ * The three branded results MUST NOT be spread/merged into one registration object: the
+ * rich metadata rides on a non-enumerable brand (src/build/tokens/defineComponentTokens.ts,
+ * TOKEN_CONTRACT_BRAND) that a spread silently drops. The harvest in loadComponentTokens
+ * collects each branded export separately. Use {@link progressTokenValues} for flat
+ * value lookups and {@link getProgressRegisteredTokens} for the rich metadata.
+ *
+ * All three calls declare `component: 'Progress'`, so platform output is still a single
+ * `ProgressTokens` Swift enum / Kotlin object.
+ */
+/**
+ * Node dimension tokens — reference sizing primitives (dimensions, not spacing).
  *
- * 13 tokens organized by concept:
  * - node.size.{sm|md|lg}         — base node dimensions
  * - node.size.{sm|md|lg}.current — emphasized node dimensions (+4px)
- * - node.gap.{sm|md|lg}          — spacing between nodes
- * - connector.thickness           — connector line width
  */
-exports.ProgressTokens = (0, tokens_1.defineComponentTokens)({
+exports.ProgressSizingTokens = (0, tokens_1.defineComponentTokens)({
     component: 'Progress',
-    family: 'spacing',
+    family: 'sizing',
     tokens: {
         // ========================================================================
-        // BASE NODE SIZES — reference sizing primitives (dimensions, not spacing)
+        // BASE NODE SIZES
         // ========================================================================
         'node.size.sm': {
             reference: SizingTokens_1.sizingTokens.size150,
@@ -58,7 +76,7 @@ exports.ProgressTokens = (0, tokens_1.defineComponentTokens)({
             reasoning: 'Large node base size (20px). Inactive dots in desktop contexts.',
         },
         // ========================================================================
-        // CURRENT NODE SIZES — reference sizing primitives directly (+4px emphasis)
+        // CURRENT NODE SIZES — +4px emphasis
         // Provides non-color visual differentiation of active position
         // ========================================================================
         'node.size.sm.current': {
@@ -73,9 +91,17 @@ exports.ProgressTokens = (0, tokens_1.defineComponentTokens)({
             reference: SizingTokens_1.sizingTokens.size300,
             reasoning: 'Current node emphasis for lg (24px). +4px over base 20px for non-color visual differentiation.',
         },
-        // ========================================================================
-        // GAP TOKENS — spacing between nodes (gaps are spacing, not sizing)
-        // ========================================================================
+    },
+});
+/**
+ * Node gap tokens — reference spacing primitives (gaps are spacing, not sizing).
+ *
+ * - node.gap.{sm|md|lg} — spacing between nodes
+ */
+exports.ProgressSpacingTokens = (0, tokens_1.defineComponentTokens)({
+    component: 'Progress',
+    family: 'spacing',
+    tokens: {
         'node.gap.sm': {
             reference: SpacingTokens_1.spacingTokens.space075,
             reasoning: 'Small gap between nodes (6px = 0.75× base). Tight spacing for compact pagination dots in mobile contexts.',
@@ -88,15 +114,50 @@ exports.ProgressTokens = (0, tokens_1.defineComponentTokens)({
             reference: SpacingTokens_1.spacingTokens.space150,
             reasoning: 'Large gap between nodes (12px = 1.5× base). Generous spacing for detailed steppers with labels in desktop contexts.',
         },
-        // ========================================================================
-        // CONNECTOR TOKENS — line connecting nodes in steppers
-        // ========================================================================
+    },
+});
+/**
+ * Connector tokens — line connecting nodes in steppers. References a borderWidth primitive.
+ *
+ * - connector.thickness — connector line width
+ */
+exports.ProgressBorderWidthTokens = (0, tokens_1.defineComponentTokens)({
+    component: 'Progress',
+    family: 'borderWidth',
+    tokens: {
         'connector.thickness': {
             reference: BorderWidthTokens_1.borderWidthTokens.borderWidth100,
             reasoning: 'Connector line thickness (1px). References borderDefault primitive for consistent border treatment across the design system.',
         },
     },
 });
+/**
+ * Flat value map across all three Progress token calls — a READ-ONLY convenience for
+ * value lookups (`progressTokenValues['node.size.md']`).
+ *
+ * NOT a registration surface: spreading drops the non-enumerable brand, so this object
+ * deliberately harvests to zero and cannot double-register. For the rich metadata use
+ * {@link getProgressRegisteredTokens}, never `getTokenContract(progressTokenValues)`.
+ */
+exports.progressTokenValues = {
+    ...exports.ProgressSizingTokens,
+    ...exports.ProgressSpacingTokens,
+    ...exports.ProgressBorderWidthTokens,
+};
+/**
+ * All Progress component tokens with their rich metadata, concatenated across the three
+ * family calls in declaration order (sizing → spacing → borderWidth).
+ *
+ * This is the brand-safe replacement for `getTokenContract(ProgressTokens)`, which is no
+ * longer meaningful now that Progress registers through three calls.
+ */
+function getProgressRegisteredTokens() {
+    return [
+        ...((0, tokens_1.getTokenContract)(exports.ProgressSizingTokens) ?? []),
+        ...((0, tokens_1.getTokenContract)(exports.ProgressSpacingTokens) ?? []),
+        ...((0, tokens_1.getTokenContract)(exports.ProgressBorderWidthTokens) ?? []),
+    ];
+}
 // ============================================================================
 // Constants and Utilities
 // ============================================================================
@@ -128,18 +189,18 @@ exports.progressComponentTokenNames = [
  * Validate that the progress component token count matches the expected count (13)
  */
 function validateProgressComponentTokenCount() {
-    return Object.keys(exports.ProgressTokens).length === exports.PROGRESS_COMPONENT_TOKEN_COUNT;
+    return Object.keys(exports.progressTokenValues).length === exports.PROGRESS_COMPONENT_TOKEN_COUNT;
 }
 /**
  * Get a single progress component token value by key
  */
 function getProgressComponentToken(key) {
-    return exports.ProgressTokens[key];
+    return exports.progressTokenValues[key];
 }
 /**
  * Get all progress component token entries as key-value pairs
  */
 function getAllProgressComponentTokens() {
-    return Object.entries(exports.ProgressTokens).map(([name, value]) => ({ name, value }));
+    return Object.entries(exports.progressTokenValues).map(([name, value]) => ({ name, value }));
 }
 //# sourceMappingURL=progress.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