@3fn/core 13.0.0 → 14.0.0

package/dist/browser/tokens.css

@@ -1,6 +1,6 @@
 /**
  * DesignerPunk Design System - Web Tokens
- * Generated: 2026-07-05T14:35:59.888Z
+ * Generated: 2026-08-12T03:23:16.987Z
  * Version: 1.0.0
  * Platform: Web (CSS Custom Properties)
  *

package/dist/components/core/Avatar-Base/platforms/web/Avatar.web.js

@@ -643,11 +643,30 @@ class AvatarBaseElement extends HTMLElement {
         // Generate aria-hidden attribute for decorative avatars
         // @see Requirements: 9.2 - Apply aria-hidden="true" when decorative prop is true
         const ariaHiddenAttr = decorative ? ' aria-hidden="true"' : '';
-        // Warn in development if src is provided without alt
-        // @see Requirements: 5.4 - Require alt prop when src is provided
-        if (src && !alt && typeof console !== 'undefined') {
-            console.warn('AvatarBaseElement: "alt" prop is required when "src" is provided for accessibility. ' +
-                'Please add an alt attribute describing the image.');
+        // Warn in development if a human-type avatar is missing alt text for its image.
+        // @see Requirements: 5.4 - Human type + src SHALL require alt for accessibility
+        // @see Requirements: 5 AC 5 - Agent type SHALL ignore src entirely (src not
+        //   rendered as an image), so agent-type avatars never warn regardless of alt.
+        //
+        // Settled edge semantics (Spec 126, O2, ratified 2026-07-09):
+        // - Scope is human-type only — Req 5.4 is human-type-scoped, and Req 5 AC 5
+        //   affirmatively establishes that agent-type SHALL ignore src, so a src+no-alt
+        //   agent avatar is not a violation of anything.
+        // - `alt == null` (loose equality — also excludes `undefined`), not `!alt`, is the
+        //   test. The `alt` attribute getter returns `getAttribute('alt')`. Raw
+        //   `setAttribute('alt', '')` yields `alt === ''`, which is the HTML-idiomatic
+        //   explicit-empty-alt signal and must NOT warn. The `alt` *property setter*
+        //   (see below) treats a falsy value as "remove the attribute," so
+        //   `avatar.alt = ''` collapses to `alt === null` — indistinguishable from
+        //   omitting alt entirely, and DOES warn under this condition.
+        // - `!decorative` is the operative fix for the confirmed false positive: a
+        //   `decorative` avatar is the component's official signal that the image is
+        //   non-informative (Req 9.2 applies `aria-hidden="true"`), so it must never warn
+        //   regardless of alt.
+        if (type === 'human' && src && alt == null && !decorative && typeof console !== 'undefined') {
+            console.warn('AvatarBaseElement: "alt" is required when "src" is provided. ' +
+                'Add an alt description of the image; or, if this avatar is purely decorative ' +
+                '(non-informative), set the "decorative" prop to hide it from screen readers.');
         }
         // Render different structures based on type
         // Agent type uses SVG-based hexagon with Bézier curves for true rounded corners

package/dist/components/core/Button-CTA/examples/BasicUsage.d.ts

@@ -19,7 +19,6 @@
  * - size: 'medium' (48px height)
  * - variant: 'primary' (filled background with primary color)
  * - noWrap: false (text wraps if needed)
- * - disabled: false (interactive)
  *
  * @example
  * ```html
@@ -54,7 +53,6 @@ export declare function customLabelButton(): void;
  *
  * The 'press' event:
  * - Bubbles up through the DOM
- * - Is not called when button is disabled
  * - Works with click, tap, Enter key, and Space key
  * - Provides originalEvent in event.detail for advanced use cases
  *
@@ -67,39 +65,29 @@ export declare function customLabelButton(): void;
  */
 export declare function buttonWithHandler(): void;
 /**
- * Example 4: Disabled Button
+ * Example 4: Unavailable Actions (no disabled state)
  *
- * Demonstrates how to disable a button to prevent user interaction.
- * Disabled buttons are commonly used during form submission, when prerequisites
- * aren't met, or when an action is temporarily unavailable.
+ * DesignerPunk does not support disabled states for usability and
+ * accessibility reasons. If an action is unavailable, the component
+ * should not be rendered.
  *
- * Disabled button behavior:
- * - Not keyboard focusable (skipped in Tab order)
- * - Does not respond to clicks or keyboard activation
- * - Visual styling indicates non-interactive state
- * - Screen readers announce disabled state
- * - onPress handler is not called
- *
- * Common use cases:
- * - Form submission in progress
- * - Required fields not filled
- * - User lacks permissions
- * - Action temporarily unavailable
- *
- * @example
- * ```html
- * <button-cta label="Submit" disabled></button-cta>
- * ```
+ * For in-flight async operations (e.g. form submission), use the loading
+ * state instead of disabling the button. For actions the user cannot take
+ * yet, keep the button interactive and validate on press, or do not render
+ * the button at all.
  *
  * @example
  * ```typescript
- * // Conditional disable based on form state
- * const button = document.createElement('button-cta') as ButtonCTA;
- * button.label = 'Submit';
- * button.disabled = isSubmitting || !isFormValid;
+ * // Conditionally render instead of disabling
+ * if (userCanSubmit) {
+ *   const button = document.createElement('button-cta') as ButtonCTA;
+ *   button.label = 'Submit';
+ *   button.addEventListener('press', handleSubmit);
+ *   document.body.appendChild(button);
+ * }
  * ```
  */
-export declare function disabledButton(): void;
+export declare function conditionallyRenderedButton(): void;
 /**
  * Example 5: All Examples Together
  *

package/dist/components/core/Button-CTA/examples/BasicUsage.js

@@ -14,7 +14,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultButton = defaultButton;
 exports.customLabelButton = customLabelButton;
 exports.buttonWithHandler = buttonWithHandler;
-exports.disabledButton = disabledButton;
+exports.conditionallyRenderedButton = conditionallyRenderedButton;
 exports.renderAllBasicExamples = renderAllBasicExamples;
 /**
  * Example 1: Default Button (Medium, Primary)
@@ -26,7 +26,6 @@ exports.renderAllBasicExamples = renderAllBasicExamples;
  * - size: 'medium' (48px height)
  * - variant: 'primary' (filled background with primary color)
  * - noWrap: false (text wraps if needed)
- * - disabled: false (interactive)
  *
  * @example
  * ```html
@@ -77,7 +76,6 @@ function customLabelButton() {
  *
  * The 'press' event:
  * - Bubbles up through the DOM
- * - Is not called when button is disabled
  * - Works with click, tap, Enter key, and Space key
  * - Provides originalEvent in event.detail for advanced use cases
  *
@@ -105,52 +103,35 @@ function buttonWithHandler() {
     document.body.appendChild(button);
 }
 /**
- * Example 4: Disabled Button
+ * Example 4: Unavailable Actions (no disabled state)
  *
- * Demonstrates how to disable a button to prevent user interaction.
- * Disabled buttons are commonly used during form submission, when prerequisites
- * aren't met, or when an action is temporarily unavailable.
+ * DesignerPunk does not support disabled states for usability and
+ * accessibility reasons. If an action is unavailable, the component
+ * should not be rendered.
  *
- * Disabled button behavior:
- * - Not keyboard focusable (skipped in Tab order)
- * - Does not respond to clicks or keyboard activation
- * - Visual styling indicates non-interactive state
- * - Screen readers announce disabled state
- * - onPress handler is not called
- *
- * Common use cases:
- * - Form submission in progress
- * - Required fields not filled
- * - User lacks permissions
- * - Action temporarily unavailable
- *
- * @example
- * ```html
- * <button-cta label="Submit" disabled></button-cta>
- * ```
+ * For in-flight async operations (e.g. form submission), use the loading
+ * state instead of disabling the button. For actions the user cannot take
+ * yet, keep the button interactive and validate on press, or do not render
+ * the button at all.
  *
  * @example
  * ```typescript
- * // Conditional disable based on form state
- * const button = document.createElement('button-cta') as ButtonCTA;
- * button.label = 'Submit';
- * button.disabled = isSubmitting || !isFormValid;
+ * // Conditionally render instead of disabling
+ * if (userCanSubmit) {
+ *   const button = document.createElement('button-cta') as ButtonCTA;
+ *   button.label = 'Submit';
+ *   button.addEventListener('press', handleSubmit);
+ *   document.body.appendChild(button);
+ * }
  * ```
  */
-function disabledButton() {
+function conditionallyRenderedButton() {
     const button = document.createElement('button-cta');
     button.label = 'Submit';
-    button.disabled = true; // Button is non-interactive
-    // This handler will NOT be called when button is disabled
     button.addEventListener('press', () => {
-        console.log('This will not be logged when button is disabled');
+        console.log('Submitted');
     });
     document.body.appendChild(button);
-    // Example: Enable button after 3 seconds (simulating async operation)
-    setTimeout(() => {
-        button.disabled = false;
-        console.log('Button is now enabled');
-    }, 3000);
 }
 /**
  * Example 5: All Examples Together
@@ -188,12 +169,6 @@ function renderAllBasicExamples() {
         alert('Form submitted successfully!');
     });
     container.appendChild(handlerBtn);
-    // Example 4: Disabled
-    const disabledBtn = document.createElement('button-cta');
-    disabledBtn.label = 'Disabled Button';
-    disabledBtn.disabled = true;
-    disabledBtn.addEventListener('press', () => console.log('This will not log'));
-    container.appendChild(disabledBtn);
     // Add container to document
     document.body.appendChild(container);
 }

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

@@ -12,7 +12,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.
  *
@@ -32,13 +32,12 @@ import '../../../Icon-Base/platforms/web/IconBase.web';
  * - 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
@@ -52,7 +51,6 @@ import '../../../Icon-Base/platforms/web/IconBase.web';
  *   variant="primary"
  *   icon="arrow-right"
  *   no-wrap="false"
- *   disabled="false"
  *   test-id="submit-button"
  * ></button-cta>
  * ```
@@ -77,7 +75,6 @@ export declare class ButtonCTA extends HTMLElement {
     private _blendUtils;
     private _hoverColor;
     private _pressedColor;
-    private _disabledColor;
     private _iconColor;
     private _iconOpticalBalanceColor;
     /**
@@ -108,7 +105,7 @@ export declare 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.
@@ -116,7 +113,6 @@ export declare 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
@@ -180,14 +176,6 @@ export declare class ButtonCTA extends HTMLElement {
      * Set the no-wrap state.
      */
     set noWrap(value: boolean);
-    /**
-     * Get the disabled state.
-     */
-    get disabled(): boolean;
-    /**
-     * Set the disabled state.
-     */
-    set disabled(value: boolean);
     /**
      * Get the test ID.
      */

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/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/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-02T19:49:06.802Z
 /// Version: 1.0.0
 /// Platform: iOS (Swift Constants)
 ///