@3fn/core 13.0.0 → 14.1.0

package/dist/components/core/Button-CTA/platforms/web/ButtonCTA.web.js

@@ -13,7 +13,7 @@
  * composition pattern as iOS and Android platforms. This ensures cross-platform
  * consistency and single source of truth for icon rendering.
  *
- * Uses theme-aware blend utilities for state colors (hover, pressed, disabled, icon)
+ * Uses theme-aware blend utilities for state colors (hover, pressed, icon)
  * instead of opacity or filter workarounds. This ensures cross-platform consistency
  * with iOS and Android implementations.
  *
@@ -83,13 +83,12 @@ function getIconSizeForButton(buttonSize) {
  * - Semantic `<button>` element with proper accessibility
  * - Token-based styling via CSS custom properties
  * - Supports text wrapping by default (accessibility-first)
- * - Uses blend utilities for state colors (hover, pressed, disabled, icon)
+ * - Uses blend utilities for state colors (hover, pressed, icon)
  * - WCAG 2.1 AA compliant:
  *   - Keyboard navigation (Tab, Enter, Space)
  *   - Focus indicators with 3:1 contrast ratio
  *   - Color contrast 4.5:1 for all styles
  *   - Screen reader support with ARIA attributes
- *   - Proper disabled state handling
  *
  * @example
  * ```html
@@ -103,7 +102,6 @@ function getIconSizeForButton(buttonSize) {
  *   variant="primary"
  *   icon="arrow-right"
  *   no-wrap="false"
- *   disabled="false"
  *   test-id="submit-button"
  * ></button-cta>
  * ```
@@ -125,7 +123,7 @@ class ButtonCTA extends HTMLElement {
      * When these attributes change, attributeChangedCallback is invoked.
      */
     static get observedAttributes() {
-        return ['label', 'size', 'variant', 'icon', 'no-wrap', 'disabled', 'test-id'];
+        return ['label', 'size', 'variant', 'icon', 'no-wrap', 'test-id'];
     }
     constructor() {
         super();
@@ -141,7 +139,6 @@ class ButtonCTA extends HTMLElement {
         // Cached blend colors for state styling
         this._hoverColor = '';
         this._pressedColor = '';
-        this._disabledColor = '';
         this._iconColor = '';
         this._iconOpticalBalanceColor = '';
         /**
@@ -150,12 +147,6 @@ class ButtonCTA extends HTMLElement {
          * Dispatches a custom 'press' event that bubbles up to parent elements.
          */
         this._handleClick = (event) => {
-            // Don't dispatch if disabled
-            if (this.disabled) {
-                event.preventDefault();
-                event.stopPropagation();
-                return;
-            }
             // Dispatch custom 'press' event
             this.dispatchEvent(new CustomEvent('press', {
                 bubbles: true,
@@ -173,10 +164,6 @@ class ButtonCTA extends HTMLElement {
          * @param event - The keyboard event
          */
         this._handleKeyDown = (event) => {
-            // Don't handle if disabled
-            if (this.disabled) {
-                return;
-            }
             // Handle Enter and Space keys (WCAG 2.1 AA keyboard navigation)
             if (event.key === 'Enter' || event.key === ' ') {
                 event.preventDefault(); // Prevent default space scrolling
@@ -247,7 +234,7 @@ class ButtonCTA extends HTMLElement {
      * Calculate blend colors from CSS custom properties.
      *
      * Reads base colors from CSS custom properties and applies theme-aware blend
-     * utilities to generate state colors (hover, pressed, disabled, icon).
+     * utilities to generate state colors (hover, pressed, icon).
      *
      * Uses getBlendUtilities() factory functions instead of direct blend calculations
      * for cross-platform consistency with iOS and Android implementations.
@@ -255,7 +242,6 @@ class ButtonCTA extends HTMLElement {
      * State color mappings:
      * - Hover: darkerBlend(color.action.primary, blend.hoverDarker) - 8% darker
      * - Pressed: darkerBlend(color.action.primary, blend.pressedDarker) - 12% darker
-     * - Disabled: desaturate(color.action.primary, blend.disabledDesaturate) - 12% less saturated
      * - Icon: lighterBlend(color.contrast.onAction, blend.iconLighter) - 8% lighter
      *
      * @see Requirements: 7.1, 7.2, 7.3, 7.4 - Button-CTA state colors
@@ -282,8 +268,6 @@ class ButtonCTA extends HTMLElement {
         this._hoverColor = this._blendUtils.hoverColor(primaryColor);
         // @see Requirements: 7.2 - Pressed uses darkerBlend(color.action.primary, blend.pressedDarker)
         this._pressedColor = this._blendUtils.pressedColor(primaryColor);
-        // @see Requirements: 7.3 - Disabled uses desaturate(color.action.primary, blend.disabledDesaturate)
-        this._disabledColor = this._blendUtils.disabledColor(primaryColor);
         // @see Requirements: 7.4 - Icon uses lighterBlend(color.contrast.onAction, blend.iconLighter)
         // Icon for primary buttons: provides optical balance for icons on primary background
         this._iconColor = this._blendUtils.iconColor(onActionColor);
@@ -380,23 +364,6 @@ class ButtonCTA extends HTMLElement {
     set noWrap(value) {
         this.setAttribute('no-wrap', value.toString());
     }
-    /**
-     * Get the disabled state.
-     */
-    get disabled() {
-        return this.hasAttribute('disabled');
-    }
-    /**
-     * Set the disabled state.
-     */
-    set disabled(value) {
-        if (value) {
-            this.setAttribute('disabled', '');
-        }
-        else {
-            this.removeAttribute('disabled');
-        }
-    }
     /**
      * Get the test ID.
      */
@@ -457,15 +424,13 @@ class ButtonCTA extends HTMLElement {
         const variant = this.buttonVariant;
         const icon = this.icon;
         const noWrap = this.noWrap;
-        const disabled = this.disabled;
         const testID = this.testID;
         // Generate class names
         const buttonClasses = [
             'button-cta',
             `button-cta--${size}`,
-            `button-cta--${variant}`,
-            disabled ? 'button-cta--disabled' : ''
-        ].filter(Boolean).join(' ');
+            `button-cta--${variant}`
+        ].join(' ');
         // Get icon size for button size variant
         // Icon sizes are type-safe mapped from button size:
         // - Small/Medium: 24px (iconBaseSize100)
@@ -481,7 +446,6 @@ class ButtonCTA extends HTMLElement {
         const blendColorStyles = `
       --_cta-hover-bg: ${this._hoverColor};
       --_cta-pressed-bg: ${this._pressedColor};
-      --_cta-disabled-bg: ${this._disabledColor};
       --_cta-icon-color: ${this._iconColor};
       --_cta-icon-optical: ${this._iconOpticalBalanceColor};
     `;
@@ -491,11 +455,10 @@ class ButtonCTA extends HTMLElement {
         // @see Requirements: 8.2, 8.3 (components render correctly with interactivity)
         this._shadowRoot.innerHTML = `
       <style>${ButtonCTA_web_css_1.default}</style>
-      <button 
+      <button
         class="${buttonClasses}"
         type="button"
         role="button"
-        ${disabled ? 'disabled aria-disabled="true"' : 'aria-disabled="false"'}
         ${testIDAttr}
         aria-label="${label}"
         style="${blendColorStyles}"
@@ -534,7 +497,6 @@ class ButtonCTA extends HTMLElement {
         const variant = this.buttonVariant;
         const icon = this.icon;
         const noWrap = this.noWrap;
-        const disabled = this.disabled;
         const testID = this.testID;
         // Get icon size for button size variant
         const iconSize = getIconSizeForButton(size);
@@ -545,19 +507,9 @@ class ButtonCTA extends HTMLElement {
         const buttonClasses = [
             'button-cta',
             `button-cta--${size}`,
-            `button-cta--${variant}`,
-            disabled ? 'button-cta--disabled' : ''
-        ].filter(Boolean).join(' ');
+            `button-cta--${variant}`
+        ].join(' ');
         this._button.className = buttonClasses;
-        // Update disabled state
-        if (disabled) {
-            this._button.setAttribute('disabled', '');
-            this._button.setAttribute('aria-disabled', 'true');
-        }
-        else {
-            this._button.removeAttribute('disabled');
-            this._button.setAttribute('aria-disabled', 'false');
-        }
         // Update aria-label
         this._button.setAttribute('aria-label', label);
         // Update test ID
@@ -570,7 +522,6 @@ class ButtonCTA extends HTMLElement {
         // Update blend color CSS custom properties
         this._button.style.setProperty('--_cta-hover-bg', this._hoverColor);
         this._button.style.setProperty('--_cta-pressed-bg', this._pressedColor);
-        this._button.style.setProperty('--_cta-disabled-bg', this._disabledColor);
         this._button.style.setProperty('--_cta-icon-color', this._iconColor);
         this._button.style.setProperty('--_cta-icon-optical', this._iconOpticalBalanceColor);
         // ─────────────────────────────────────────────────────────────────

package/dist/components/core/Button-CTA/types.d.ts

@@ -78,7 +78,6 @@ export type ButtonStyle = 'primary' | 'secondary' | 'tertiary';
  *   variant="primary"
  *   icon="arrow-right"
  *   noWrap={false}
- *   disabled={false}
  *   testID="submit-button"
  *   onPress={handleSubmit}
  * />
@@ -190,11 +189,9 @@ export interface ButtonProps {
      * Click/tap handler (required)
      *
      * Callback function invoked when the button is clicked or tapped.
-     * Not called when button is disabled.
      *
      * @remarks
      * - Function signature: `() => void`
-     * - Not invoked when `disabled` is true
      * - Triggered by click, tap, Enter key, or Space key
      *
      * @example
@@ -222,26 +219,5 @@ export interface ButtonProps {
      * ```
      */
     testID?: string;
-    /**
-     * Optional disabled state (default: false)
-     *
-     * When true, the button is non-interactive and visually indicates
-     * disabled state. The onPress handler is not called when disabled.
-     *
-     * @defaultValue false
-     *
-     * @remarks
-     * - Disabled buttons are not keyboard focusable
-     * - Screen readers announce disabled state
-     * - Visual styling indicates non-interactive state
-     *
-     * @example
-     * ```typescript
-     * disabled={false}  // Interactive (default)
-     * disabled={true}   // Non-interactive
-     * disabled={isSubmitting}  // Conditional disable
-     * ```
-     */
-    disabled?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/components/core/Button-CTA/types.js

@@ -11,4 +11,10 @@
  * @module Button-CTA/types
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+// NO DISABLED STATES
+// DesignerPunk does not support disabled states for usability and
+// accessibility reasons. If an action is unavailable, the component
+// should not be rendered. For in-flight async actions, use the loading
+// state (state_loading) instead.
+// Ruled by Peter 2026-07-15 (Button-CTA disabled-state adjudication).
 //# sourceMappingURL=types.js.map

package/dist/components/core/Button-Icon/buttonIcon.tokens.d.ts

@@ -8,18 +8,27 @@
  * Uses the defineComponentTokens() API to register tokens with the global
  * ComponentTokenRegistry for pipeline integration.
  *
+ * Two separate defineComponentTokens() calls are used — one per token family
+ * (spacing, sizing) — following the Avatar-Base pattern (avatar.tokens.ts). Every
+ * token registered by a single call is stamped with that call's `family`, so inset
+ * (spacing) and size (sizing) tokens must NOT share a call even though they live in
+ * the same file. The two branded results are exported separately and must NOT be
+ * spread/merged into one object — the rich metadata rides on a non-enumerable brand
+ * (see src/build/tokens/defineComponentTokens.ts, TOKEN_CONTRACT_BRAND) that a spread
+ * would silently drop.
+ *
  * The build system generates platform-specific values from these definitions:
  * - Web: CSS custom properties (var(--buttonicon-inset-large))
  * - iOS: Swift constants (ButtonIconTokens.insetLarge)
  * - Android: Kotlin constants (ButtonIconTokens.insetLarge)
  *
  * Token Relationships:
- * - buttonIcon.inset.large (12px) references space150
- * - buttonIcon.inset.medium (10px) references space125 (strategic flexibility token)
- * - buttonIcon.inset.small (8px) references space100
- * - buttonIcon.size.large (48px) references size600
- * - buttonIcon.size.medium (40px) references size500
- * - buttonIcon.size.small (32px) references size400
+ * - buttonIcon.inset.large (12px) references space150 — family: spacing
+ * - buttonIcon.inset.medium (10px) references space125 (strategic flexibility token) — family: spacing
+ * - buttonIcon.inset.small (8px) references space100 — family: spacing
+ * - buttonIcon.size.large (48px) references size600 — family: sizing
+ * - buttonIcon.size.medium (40px) references size500 — family: sizing
+ * - buttonIcon.size.small (32px) references size400 — family: sizing
  *
  * @see .kiro/specs/035-button-icon-component/design.md for token consumption strategy
  * @see .kiro/specs/034-component-architecture-system for Stemma System details
@@ -27,24 +36,18 @@
  * @see .kiro/specs/040-component-alignment/requirements.md Requirements 6.1, 6.2, 6.3
  */
 /**
- * Button-Icon component tokens defined using the hybrid authoring API.
+ * Button-Icon inset (padding) tokens — reference spacing primitives.
  *
  * Each token references a primitive token and includes reasoning
  * explaining why the token exists and its purpose in the component.
  *
- * Inset (padding) token values — reference spacing primitives:
  * - inset.large: 12px (1.5 × base, references space150)
  * - inset.medium: 10px (1.25 × base, references space125 strategic flexibility token)
  * - inset.small: 8px (1 × base, references space100)
  *
- * Size (width/height) token values:
- * - size.large: 48px (6 × base, references size600)
- * - size.medium: 40px (5 × base, references size500)
- * - size.small: 32px (4 × base, references size400)
- *
  * @see Requirements 6.1, 6.2, 6.3 in .kiro/specs/040-component-alignment/requirements.md
  */
-export declare const ButtonIconTokens: import("../../../build/tokens").ComponentTokenValues<{
+export declare const ButtonIconInsetTokens: import("../../../build/tokens").ComponentTokenValues<{
     'inset.large': {
         reference: import("../../../types").PrimitiveToken;
         reasoning: string;
@@ -57,6 +60,17 @@ export declare const ButtonIconTokens: import("../../../build/tokens").Component
         reference: import("../../../types").PrimitiveToken;
         reasoning: string;
     };
+}>;
+/**
+ * Button-Icon size (width/height) tokens — reference sizing primitives, not spacing.
+ *
+ * - size.large: 48px (6 × base, references size600)
+ * - size.medium: 40px (5 × base, references size500)
+ * - size.small: 32px (4 × base, references size400)
+ *
+ * @see Requirements 6.1, 6.2, 6.3 in .kiro/specs/040-component-alignment/requirements.md
+ */
+export declare const ButtonIconSizeTokens: import("../../../build/tokens").ComponentTokenValues<{
     'size.large': {
         reference: import("../../../types").PrimitiveToken;
         reasoning: string;

package/dist/components/core/Button-Icon/buttonIcon.tokens.js

@@ -9,18 +9,27 @@
  * Uses the defineComponentTokens() API to register tokens with the global
  * ComponentTokenRegistry for pipeline integration.
  *
+ * Two separate defineComponentTokens() calls are used — one per token family
+ * (spacing, sizing) — following the Avatar-Base pattern (avatar.tokens.ts). Every
+ * token registered by a single call is stamped with that call's `family`, so inset
+ * (spacing) and size (sizing) tokens must NOT share a call even though they live in
+ * the same file. The two branded results are exported separately and must NOT be
+ * spread/merged into one object — the rich metadata rides on a non-enumerable brand
+ * (see src/build/tokens/defineComponentTokens.ts, TOKEN_CONTRACT_BRAND) that a spread
+ * would silently drop.
+ *
  * The build system generates platform-specific values from these definitions:
  * - Web: CSS custom properties (var(--buttonicon-inset-large))
  * - iOS: Swift constants (ButtonIconTokens.insetLarge)
  * - Android: Kotlin constants (ButtonIconTokens.insetLarge)
  *
  * Token Relationships:
- * - buttonIcon.inset.large (12px) references space150
- * - buttonIcon.inset.medium (10px) references space125 (strategic flexibility token)
- * - buttonIcon.inset.small (8px) references space100
- * - buttonIcon.size.large (48px) references size600
- * - buttonIcon.size.medium (40px) references size500
- * - buttonIcon.size.small (32px) references size400
+ * - buttonIcon.inset.large (12px) references space150 — family: spacing
+ * - buttonIcon.inset.medium (10px) references space125 (strategic flexibility token) — family: spacing
+ * - buttonIcon.inset.small (8px) references space100 — family: spacing
+ * - buttonIcon.size.large (48px) references size600 — family: sizing
+ * - buttonIcon.size.medium (40px) references size500 — family: sizing
+ * - buttonIcon.size.small (32px) references size400 — family: sizing
  *
  * @see .kiro/specs/035-button-icon-component/design.md for token consumption strategy
  * @see .kiro/specs/034-component-architecture-system for Stemma System details
@@ -28,7 +37,7 @@
  * @see .kiro/specs/040-component-alignment/requirements.md Requirements 6.1, 6.2, 6.3
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ButtonIconSizeTokenReferences = exports.ButtonIconInsetTokenReferences = exports.ButtonIconTokens = void 0;
+exports.ButtonIconSizeTokenReferences = exports.ButtonIconInsetTokenReferences = exports.ButtonIconSizeTokens = exports.ButtonIconInsetTokens = void 0;
 exports.getButtonIconInset = getButtonIconInset;
 exports.getButtonIconSize = getButtonIconSize;
 exports.getButtonIconInsetTokenReference = getButtonIconInsetTokenReference;
@@ -37,28 +46,21 @@ const tokens_1 = require("../../../build/tokens");
 const SpacingTokens_1 = require("../../../tokens/SpacingTokens");
 const SizingTokens_1 = require("../../../tokens/SizingTokens");
 /**
- * Button-Icon component tokens defined using the hybrid authoring API.
+ * Button-Icon inset (padding) tokens — reference spacing primitives.
  *
  * Each token references a primitive token and includes reasoning
  * explaining why the token exists and its purpose in the component.
  *
- * Inset (padding) token values — reference spacing primitives:
  * - inset.large: 12px (1.5 × base, references space150)
  * - inset.medium: 10px (1.25 × base, references space125 strategic flexibility token)
  * - inset.small: 8px (1 × base, references space100)
  *
- * Size (width/height) token values:
- * - size.large: 48px (6 × base, references size600)
- * - size.medium: 40px (5 × base, references size500)
- * - size.small: 32px (4 × base, references size400)
- *
  * @see Requirements 6.1, 6.2, 6.3 in .kiro/specs/040-component-alignment/requirements.md
  */
-exports.ButtonIconTokens = (0, tokens_1.defineComponentTokens)({
+exports.ButtonIconInsetTokens = (0, tokens_1.defineComponentTokens)({
     component: 'ButtonIcon',
     family: 'spacing',
     tokens: {
-        // Inset (padding) tokens
         'inset.large': {
             reference: SpacingTokens_1.spacingTokens.space150,
             reasoning: 'Large button variant requires 12px padding (1.5× base) for comfortable touch target and visual balance with larger icon sizes',
@@ -71,8 +73,21 @@ exports.ButtonIconTokens = (0, tokens_1.defineComponentTokens)({
             reference: SpacingTokens_1.spacingTokens.space100,
             reasoning: 'Small button variant uses 8px padding (1× base) for minimal footprint in dense UI layouts while meeting minimum touch target requirements',
         },
-        // Size (width/height) tokens — reference sizing primitives, not spacing
-        // @see Requirements 6.1, 6.2, 6.3
+    },
+});
+/**
+ * Button-Icon size (width/height) tokens — reference sizing primitives, not spacing.
+ *
+ * - size.large: 48px (6 × base, references size600)
+ * - size.medium: 40px (5 × base, references size500)
+ * - size.small: 32px (4 × base, references size400)
+ *
+ * @see Requirements 6.1, 6.2, 6.3 in .kiro/specs/040-component-alignment/requirements.md
+ */
+exports.ButtonIconSizeTokens = (0, tokens_1.defineComponentTokens)({
+    component: 'ButtonIcon',
+    family: 'sizing',
+    tokens: {
         'size.large': {
             reference: SizingTokens_1.sizingTokens.size600,
             reasoning: 'Large button size (48px = 6× base) provides generous touch target exceeding tapAreaRecommended, calculated as icon (24px) + padding (12px × 2)',
@@ -101,7 +116,7 @@ exports.ButtonIconTokens = (0, tokens_1.defineComponentTokens)({
  * ```
  */
 function getButtonIconInset(variant) {
-    return exports.ButtonIconTokens[`inset.${variant}`];
+    return exports.ButtonIconInsetTokens[`inset.${variant}`];
 }
 /**
  * Get Button-Icon size (width/height) value for a given size variant
@@ -119,7 +134,7 @@ function getButtonIconInset(variant) {
  * @see Requirements 6.1, 6.2, 6.3 in .kiro/specs/040-component-alignment/requirements.md
  */
 function getButtonIconSize(variant) {
-    return exports.ButtonIconTokens[`size.${variant}`];
+    return exports.ButtonIconSizeTokens[`size.${variant}`];
 }
 /**
  * Semantic token references for Button-Icon inset values

package/dist/components/core/Input-Text-Base/types.d.ts

@@ -40,7 +40,19 @@ export interface InputTextBaseProps {
     autocomplete?: string;
     /** Placeholder text (only shown when label is floated and input is empty) */
     placeholder?: string;
-    /** Read-only state (alternative to disabled) */
+    /**
+     * Read-only state (state_readonly contract): the value is displayed
+     * non-editably while remaining perceivable, selectable, and copyable —
+     * never rendered with disabled semantics on any platform.
+     *
+     * Platform note: web and Android readOnly fields participate in keyboard
+     * focus order; iOS renders readOnly as selectable static text in the
+     * field chrome and is not in focus order (declared carve-out — see
+     * contracts.yaml interaction_focusable).
+     *
+     * NOT supported by Input-Text-Password: readOnly is contracted out of the
+     * Password variant (see its contracts.yaml excludes) and is ignored there.
+     */
     readOnly?: boolean;
     /** Required field indicator */
     required?: boolean;

package/dist/components/core/Input-Text-Password/platforms/web/InputTextPassword.web.js

@@ -152,6 +152,9 @@ class InputTextPassword extends HTMLElement {
             'error-message',
             'is-success',
             'show-info-icon',
+            // read-only is accepted for API stability but IGNORED — readOnly is
+            // contracted out of Input-Text-Password (see render(), and
+            // contracts.yaml excludes.state_readonly).
             'read-only',
             'required',
             'max-length',
@@ -225,7 +228,14 @@ class InputTextPassword extends HTMLElement {
         const propsErrorMessage = this.getAttribute('error-message') || '';
         const isSuccess = this.getAttribute('is-success') === 'true';
         const showInfoIcon = this.getAttribute('show-info-icon') === 'true';
-        const readOnly = this.hasAttribute('read-only');
+        // read-only is NOT read or forwarded: readOnly is contracted out of
+        // Input-Text-Password (adjudication condition 4:
+        // .kiro/issues/input-text-base-ios-readonly-adjudication.md — RULED
+        // B-prime, Peter 2026-07-15). On web this is contract conformance, not a
+        // security fix — a readonly password input stays masked and browsers
+        // block copy from type=password — but the exclusion holds uniformly on
+        // all three platforms. The attribute is accepted (observedAttributes)
+        // for API stability and ignored.
         const required = this.hasAttribute('required');
         const maxLength = this.getAttribute('max-length');
         const showToggle = this.getAttribute('show-toggle') !== 'false'; // Default true
@@ -264,7 +274,6 @@ class InputTextPassword extends HTMLElement {
           ${errorMessage ? `error-message="${errorMessage}"` : ''}
           ${isSuccess ? 'is-success="true"' : ''}
           ${showInfoIcon ? 'show-info-icon="true"' : ''}
-          ${readOnly ? 'read-only' : ''}
           ${required ? 'required' : ''}
           ${maxLength ? `max-length="${maxLength}"` : ''}
         ></input-text-base>

package/dist/generators/DTCGFormatGenerator.js

@@ -686,6 +686,14 @@ class DTCGFormatGenerator {
             else if (token.direction === 'lighter') {
                 extensions.blendType = 'lighterBlend';
             }
+            // Deprecation metadata (e.g. blend.disabledDesaturate) — lets includeDeprecated: false strip it
+            if (token.deprecated) {
+                extensions.deprecated = true;
+                if (token.deprecatedSince)
+                    extensions.deprecatedSince = token.deprecatedSince;
+                if (token.deprecatedReason)
+                    extensions.deprecatedReason = token.deprecatedReason;
+            }
             group[key] = this.toDTCGToken(aliasValue, 'number', token.description, extensions);
         }
         return group;

package/dist/generators/TokenFileGenerator.js

@@ -400,6 +400,7 @@ class TokenFileGenerator {
     getiOSComponentTokenType(token) {
         switch (token.family) {
             case 'spacing':
+            case 'sizing':
             case 'radius':
             case 'fontSize':
             case 'tapArea':
@@ -449,8 +450,12 @@ class TokenFileGenerator {
             const familyClass = this.getFamilyClassName(token.family);
             return `${familyClass}.${token.primitiveReference}`;
         }
-        // Dimensional families need .dp suffix to match primitive token output (Task 1.4)
-        const dimensionalFamilies = ['spacing', 'radius', 'tapArea', 'fontSize', 'borderWidth'];
+        // Dimensional families need .dp suffix to match primitive token output (Task 1.4).
+        // 'sizing' is dimensional (component width/height) and belongs here: without it, a
+        // value-path sizing token emits a bare Int, which fails to compile against consumers
+        // that type the member as Dp (e.g. Avatar.android.kt's
+        // `val iconSizeXs: Dp = GeneratedAvatarTokens.iconSizeXs`).
+        const dimensionalFamilies = ['spacing', 'sizing', 'radius', 'tapArea', 'fontSize', 'borderWidth'];
         if (dimensionalFamilies.includes(token.family)) {
             return `${token.value}.dp`;
         }

package/dist/integration/BuildErrorHandler.js

@@ -149,7 +149,7 @@ class BuildErrorHandler {
                 'Validate configuration against schema'
             ],
             documentation: [
-                'https://github.com/3fn/DesignerPunkv2/docs/build-integration.md'
+                'https://github.com/3fn/DesignerPunk/docs/build-integration.md'
             ]
         };
     }
@@ -169,7 +169,7 @@ class BuildErrorHandler {
                 'Ensure platform files are generated correctly'
             ],
             documentation: [
-                `https://github.com/3fn/DesignerPunkv2/docs/platforms/${platform}.md`
+                `https://github.com/3fn/DesignerPunk/docs/platforms/${platform}.md`
             ]
         };
     }

package/dist/ios/DesignTokens.ios.swift

@@ -1,6 +1,6 @@
 ///
 /// DesignerPunk Design System - iOS Tokens
-/// Generated: 2026-07-05T13:53:05.401Z
+/// Generated: 2026-08-26T02:25:48.234Z
 /// Version: 1.0.0
 /// Platform: iOS (Swift Constants)
 ///

package/dist/mcp/application-mcp.js

@@ -19238,6 +19238,30 @@ var ComponentMCPServer = class {
     this.stalenessGate.markIndexed();
     await this.server.connect(transport);
     console.error(`[${SERVER_NAME}] Server running on stdio`);
+    this.setupShutdownHandlers();
+  }
+  /**
+   * Self-exit on stdin EOF and fatal signals. A stdio MCP server whose parent client
+   * died (or gracefully closed the pipe) has no one to serve, but the file watcher
+   * keeps the event loop alive forever — found live at Spec 122 U3 (~230 orphaned
+   * servers accumulated across harness runs). Exiting on EOF also makes graceful
+   * client closes immediate: the MCP SDK's StdioClientTransport.close() ends stdin
+   * and waits up to 2s for exactly this exit before escalating to SIGTERM.
+   */
+  setupShutdownHandlers() {
+    let shuttingDown = false;
+    const shutdown = async () => {
+      if (shuttingDown) return;
+      shuttingDown = true;
+      console.error(`[${SERVER_NAME}] Shutting down...`);
+      this.fileWatcher.stop();
+      await this.server.close();
+      process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    process.stdin.on("end", shutdown);
+    process.stdin.on("close", shutdown);
   }
   registerHandlers() {
     this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));