@3fn/core 13.0.0 → 14.0.0

package/governance/Component-Family-Badge.md

@@ -2,7 +2,6 @@
 id: component-family-badge
 inclusion: manual
 name: Component-Family-Badge
-aliases: badge family work
 description: Badge component family — read-only, non-interactive visual indicators for status, category, or metadata display. Load when working with badge components, status indicators, or notification counts.
 ---
 

package/governance/Component-Family-Button.md

@@ -2,7 +2,6 @@
 id: component-family-button
 inclusion: manual
 name: Component-Family-Button
-aliases: button family work
 description: Button component family — ButtonCTA variants, sizes, icon support, interaction states, and platform implementations. Load when working with button components or button behavioral contracts.
 ---
 
@@ -32,7 +31,7 @@ The Buttons family provides interactive components for triggering user actions w
 
 - **Visual Hierarchy**: Three visual variants (primary, secondary, tertiary) establish clear action hierarchy
 - **Size Variants**: Three sizes (small, medium, large) for different contexts and emphasis levels
-- **Interaction States**: Comprehensive hover, pressed, disabled, and loading states
+- **Interaction States**: Comprehensive hover, pressed, and loading states (no disabled state — DesignerPunk philosophy)
 - **Accessibility First**: WCAG 2.1 AA compliant with keyboard navigation and screen reader support
 - **Cross-Platform Consistent**: Platform-appropriate feedback (ripple on Android, scale on iOS)
 
@@ -98,7 +97,7 @@ Button-CTA uses the `[Family]-[Type]` pattern without a variant suffix because i
 
 ### Base Contracts
 
-All Button-CTA instances implement these 7 foundational contracts:
+All Button-CTA instances implement these 6 foundational contracts:
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
@@ -106,7 +105,6 @@ All Button-CTA instances implement these 7 foundational contracts:
 | `pressable` | Responds to press/click events | 2.1.1 | web, ios, android |
 | `hover_state` | Visual feedback on hover (desktop) | 1.4.13 | web |
 | `pressed_state` | Visual feedback when pressed | 2.4.7 | web, ios, android |
-| `disabled_state` | Prevents interaction when disabled | 4.1.2 | web, ios, android |
 | `loading_state` | Shows loading indicator during async | 4.1.3 | web, ios, android |
 | `focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
 
@@ -116,7 +114,7 @@ All Button-CTA instances implement these 7 foundational contracts:
 
 **Description**: Component can receive keyboard focus via Tab key navigation.
 
-**Behavior**: Focus state is visually indicated with a focus ring. Focus is managed appropriately when disabled state changes. Disabled buttons are not keyboard focusable.
+**Behavior**: Focus state is visually indicated with a focus ring.
 
 **WCAG Compliance**: 2.1.1 Keyboard, 2.4.7 Focus Visible
 
@@ -124,7 +122,7 @@ All Button-CTA instances implement these 7 foundational contracts:
 
 **Description**: Component responds to click, tap, Enter key, and Space key.
 
-**Behavior**: Press triggers the onPress callback when not disabled. Platform-appropriate feedback is provided during press (ripple on Android, scale on iOS).
+**Behavior**: Press triggers the onPress callback. Platform-appropriate feedback is provided during press (ripple on Android, scale on iOS).
 
 **WCAG Compliance**: 2.1.1 Keyboard
 
@@ -144,14 +142,6 @@ All Button-CTA instances implement these 7 foundational contracts:
 
 **WCAG Compliance**: 2.4.7 Focus Visible
 
-#### disabled_state
-
-**Description**: Prevents interaction when disabled.
-
-**Behavior**: When disabled, component cannot receive focus, cannot be clicked/tapped, uses desaturated colors (`blend.disabledDesaturate` - 12% less saturated), shows `cursor: not-allowed` (web), and communicates disabled state to assistive technology.
-
-**WCAG Compliance**: 4.1.2 Name, Role, Value
-
 #### focus_ring
 
 **Description**: WCAG 2.4.7 focus visible indicator.
@@ -179,7 +169,6 @@ All Button-CTA instances implement these 7 foundational contracts:
 | `variant` | `'primary' \| 'secondary' \| 'tertiary'` | No | `'primary'` | Visual variant for hierarchy |
 | `icon` | `IconName` | No | - | Optional leading icon |
 | `noWrap` | `boolean` | No | `false` | Truncate text instead of wrapping |
-| `disabled` | `boolean` | No | `false` | Disabled state |
 | `onPress` | `() => void` | Yes | - | Press callback |
 | `testID` | `string` | No | - | Test identifier |
 
@@ -503,7 +492,6 @@ Button components rely on three semantic concepts:
 | Icon | `icon.size100`, `icon.size125` | Icon sizing |
 | Blend | `blend.hoverDarker` | Hover state (8% darker) |
 | Blend | `blend.pressedDarker` | Pressed state (12% darker) |
-| Blend | `blend.disabledDesaturate` | Disabled state (12% less saturated) |
 
 **Why Semantic Concept Tokens**:
 - **Action concept**: `color.action.primary` clearly indicates emphasized interactive elements
@@ -650,7 +638,6 @@ iOS uses scale transforms + color blends for all press feedback. The ripple dist
 
 All platforms implement the same behavioral contracts:
 - Press feedback timing matches across platforms
-- Disabled state appearance is mathematically equivalent
 - Focus ring appearance is consistent
 - Touch targets meet platform guidelines
 

package/governance/Component-Family-Chip.md

@@ -2,7 +2,6 @@
 id: component-family-chip
 inclusion: manual
 name: Component-Family-Chip
-aliases: chip family work
 description: Chip component family — compact, interactive elements for filtering, selection, or input management (tags, toggles). Load when working with chip components, filter controls, or tag inputs.
 ---
 

package/governance/Component-Family-Container.md

@@ -2,7 +2,6 @@
 id: component-family-container
 inclusion: manual
 name: Component-Family-Container
-aliases: container family work
 description: Container component family — layout and content organization with granular styling props (padding, background, shadow, border, radius, opacity, layering) and semantic HTML support. Load when working with container components or layout composition.
 ---
 

package/governance/Component-Family-Data-Display.md

@@ -2,7 +2,6 @@
 id: component-family-data-display
 inclusion: manual
 name: Component-Family-Data-Display
-aliases: data display family work
 description: Data Display component family (placeholder) — planned components for structured information presentation including text formatting, lists, tables, and media display. Load when planning data display components or reviewing family architecture.
 ---
 
@@ -14,7 +13,7 @@ description: Data Display component family (placeholder) — planned components
 **Scope**: cross-project
 **Layer**: 3
 **Relevant Tasks**: component-development, architecture-planning
-**Last Reviewed**: 2026-01-02
+**Last Reviewed**: 2026-07-08
 
 ---
 

package/governance/Component-Family-Divider.md

@@ -2,7 +2,6 @@
 id: component-family-divider
 inclusion: manual
 name: Component-Family-Divider
-aliases: divider family work
 description: Divider component family (placeholder) — planned components for visual separation between content sections with horizontal and vertical orientations. Load when planning divider components or reviewing family architecture.
 ---
 
@@ -14,7 +13,7 @@ description: Divider component family (placeholder) — planned components for v
 **Scope**: cross-project
 **Layer**: 3
 **Relevant Tasks**: component-development, architecture-planning
-**Last Reviewed**: 2026-01-02
+**Last Reviewed**: 2026-07-08
 
 ---
 

package/governance/Component-Family-Form-Inputs.md

@@ -3,7 +3,7 @@ id: component-family-form-inputs
 inclusion: manual
 name: Component-Family-Form-Inputs
 description: Form Inputs component family — text input (float label pattern), checkbox, and radio components with built-in validation, accessibility, and cross-platform consistency. Load when working with form components, input validation, or selection controls.
-aliases: RTL, internationalization, i18n, bidi, right-to-left, text direction
+aliases: textfield, text field, textbox, form field, input field, form controls
 ---
 
 # Form Inputs Components
@@ -14,7 +14,7 @@ aliases: RTL, internationalization, i18n, bidi, right-to-left, text direction
 **Scope**: cross-project
 **Layer**: 3
 **Relevant Tasks**: component-development, ui-composition, component-implementation
-**Last Reviewed**: 2026-02-07
+**Last Reviewed**: 2026-08-02
 
 ---
 
@@ -102,7 +102,7 @@ Input-Radio-Base (Primitive)
 
 ### Text Input Base Contracts (Inherited by Text Input Components)
 
-All text input components in the Form Inputs family inherit these 9 foundational contracts from Input-Text-Base:
+All text input components in the Form Inputs family inherit these 8 foundational contracts from Input-Text-Base:
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
@@ -111,11 +111,12 @@ All text input components in the Form Inputs family inherit these 9 foundational
 | `validates_on_blur` | Validation triggers on blur | 3.3.1 | web, ios, android |
 | `error_state_display` | Shows error message and styling | 3.3.1, 1.4.1 | web, ios, android |
 | `success_state_display` | Shows success styling | 1.4.1 | web, ios, android |
-| `disabled_state` | Prevents interaction when disabled | 4.1.2 | web, ios, android |
 | `trailing_icon_display` | Shows contextual trailing icons | 1.4.1 | web, ios, android |
 | `focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
 | `reduced_motion_support` | Respects prefers-reduced-motion | 2.3.3 | web, ios, android |
 
+**Excluded**: `disabled_state` — DesignerPunk does not support disabled states for usability and accessibility reasons. If an input is unavailable, it should not be rendered (adjudicated 2026-07-15; see `.kiro/issues/button-cta-disabled-state-adjudication.md`).
+
 ### Contract Details
 
 #### focusable
@@ -908,7 +909,6 @@ Components in the Form Inputs family consume these design tokens:
 | Accessibility | `accessibility.focus.color` | Focus ring color |
 | Icon | `icon.size100` | Icon size |
 | Blend | `blend.focusSaturate` | Focus state saturation |
-| Blend | `blend.disabledDesaturate` | Disabled state desaturation |
 
 #### Checkbox Tokens
 

package/governance/Component-Family-Icon.md

@@ -2,7 +2,6 @@
 id: component-family-icon
 inclusion: manual
 name: Component-Family-Icon
-aliases: icon family work
 description: Icon component family — inline SVG icons with automatic color inheritance and typography-aligned sizing across 11 size variants. Load when working with icon components, icon sizing, or icon color integration.
 ---
 
@@ -14,7 +13,7 @@ description: Icon component family — inline SVG icons with automatic color inh
 **Scope**: cross-project
 **Layer**: 3
 **Relevant Tasks**: component-development, ui-composition, component-implementation
-**Last Reviewed**: 2026-01-02
+**Last Reviewed**: 2026-07-08
 
 ---
 

package/governance/Component-Family-Loading.md

@@ -2,7 +2,6 @@
 id: component-family-loading
 inclusion: manual
 name: Component-Family-Loading
-aliases: loading family work
 description: Loading component family (placeholder) — planned components for progress indication including indeterminate spinners, determinate progress bars, and skeleton placeholders. Load when planning loading components or reviewing family architecture.
 ---
 
@@ -14,7 +13,7 @@ description: Loading component family (placeholder) — planned components for p
 **Scope**: cross-project
 **Layer**: 3
 **Relevant Tasks**: component-development, architecture-planning
-**Last Reviewed**: 2026-01-02
+**Last Reviewed**: 2026-07-08
 
 ---
 

package/governance/Component-Family-Modal.md

@@ -2,7 +2,6 @@
 id: component-family-modal
 inclusion: manual
 name: Component-Family-Modal
-aliases: modal family work
 description: Modal component family (placeholder) — planned overlay components for focused user interactions with focus trapping, backdrop interactions, and accessible dismissal patterns. Load when planning modal components or reviewing family architecture.
 ---
 
@@ -14,7 +13,7 @@ description: Modal component family (placeholder) — planned overlay components
 **Scope**: cross-project
 **Layer**: 3
 **Relevant Tasks**: component-development, architecture-planning
-**Last Reviewed**: 2026-01-02
+**Last Reviewed**: 2026-07-08
 
 ---
 

package/governance/Component-Family-Navigation.md

@@ -2,7 +2,6 @@
 id: component-family-navigation
 inclusion: manual
 name: Component-Family-Navigation
-aliases: navigation family work
 description: Navigation component family — wayfinding and view-switching components including segmented controls and tab bars. Load when building navigation components or reviewing family architecture.
 ---
 

package/governance/Component-Family-Progress.md

@@ -1,7 +1,6 @@
 ---
 id: progress-indicator-components
 inclusion: manual
-aliases: progress family work
 ---
 
 # Progress Indicator Components