@3fn/core 13.0.0 → 14.1.0

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.
 ---
 
@@ -84,13 +83,13 @@ Chip (Family)
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| renders_pill_container | Renders pill-shaped container with label text | — | web, ios, android |
-| renders_icon | Optionally displays leading icon via Icon-Base at icon.size075 | — | web, ios, android |
-| press_interaction | Responds to press/click/tap events, calls onPress callback | 2.1.1 | web, ios, android |
+| visual_pill_container | Renders pill-shaped container with label text | — | web, ios, android |
+| visual_renders_icon | Optionally displays leading icon via Icon-Base at icon.size075 | — | web, ios, android |
+| interaction_pressable | Responds to press/click/tap events, calls onPress callback | 2.1.1 | web, ios, android |
 | state_styling | Visual feedback for default, hover, pressed states | 1.4.13 | web, ios, android |
-| keyboard_focusable | Can receive keyboard focus via Tab key | 2.1.1, 2.4.7 | web, ios, android |
-| keyboard_activation | Activates on Space/Enter key press | 2.1.1 | web |
-| expanded_tap_area | 48px tap area exceeds WCAG 44px minimum | 2.5.5 | web, ios, android |
+| interaction_focusable | Can receive keyboard focus via Tab key | 2.1.1, 2.4.7 | web, ios, android |
+| interaction_keyboard_activation | Activates on Space/Enter key press | 2.1.1 | web |
+| interaction_expanded_tap_area | 48px tap area exceeds WCAG 44px minimum | 2.5.5 | web, ios, android |
 | accessibility_role | Announces as button to assistive technology | 4.1.2 | web, ios, android |
 
 ### Extended Contracts (Chip-Filter)
@@ -99,10 +98,10 @@ Inherits all contracts from Chip-Base, plus:
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| toggle_selection | Toggles selected state on press, calls onSelectionChange | 4.1.2 | web, ios, android |
-| selected_styling | Visual feedback for selected state using select feedback colors | 1.4.1 | web, ios, android |
-| checkmark_icon | Displays checkmark icon when selected (replaces leading icon) | — | web, ios, android |
-| aria_pressed | Announces selection state via aria-pressed attribute | 4.1.2 | web |
+| interaction_toggle_selection | Toggles selected state on press, calls onSelectionChange | 4.1.2 | web, ios, android |
+| state_selected_styling | Visual feedback for selected state using select feedback colors | 1.4.1 | web, ios, android |
+| visual_checkmark_icon | Displays checkmark icon when selected (replaces leading icon) | — | web, ios, android |
+| accessibility_aria_pressed | Announces selection state via aria-pressed attribute | 4.1.2 | web |
 
 ### Extended Contracts (Chip-Input)
 
@@ -110,10 +109,10 @@ Inherits most contracts from Chip-Base, plus:
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| dismiss_on_press | Dismisses chip on press anywhere, calls onDismiss | 2.1.1 | web, ios, android |
-| trailing_x_icon | Always displays X icon as trailing element | — | web, ios, android |
-| dual_icons | Supports both leading icon AND trailing X icon | — | web, ios, android |
-| x_icon_accessible_label | X icon has accessible label "Remove [label]" | 4.1.2 | web, ios, android |
+| interaction_dismiss | Dismisses chip on press anywhere, calls onDismiss | 2.1.1 | web, ios, android |
+| content_trailing_dismiss_icon | Always displays X icon as trailing element | — | web, ios, android |
+| content_dual_icons | Supports both leading icon AND trailing X icon | — | web, ios, android |
+| accessibility_dismiss_label | X icon has accessible label "Remove [label]" | 4.1.2 | web, ios, android |
 
 ---
 

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.
 ---
 
@@ -98,17 +97,17 @@ All components in the Containers family inherit these 7 foundational contracts f
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| `contains_children` | Can contain child components | 1.3.1 | web, ios, android |
-| `applies_padding` | Applies consistent internal padding | 1.4.12 | web, ios, android |
-| `applies_background` | Applies background color styling | 1.4.3 | web, ios, android |
-| `applies_shadow` | Applies shadow/elevation styling | 1.4.11 | web, ios, android |
-| `applies_border` | Applies border styling | 1.4.11 | web, ios, android |
-| `applies_radius` | Applies border radius styling | N/A | web, ios, android |
-| `hover_state` | Visual feedback on hover (pointer devices) | 1.4.13 | web, ios, android |
+| `layout_contains_children` | Can contain child components | 1.3.1 | web, ios, android |
+| `layout_padding` | Applies consistent internal padding | 1.4.12 | web, ios, android |
+| `visual_background` | Applies background color styling | 1.4.3 | web, ios, android |
+| `visual_shadow` | Applies shadow/elevation styling | 1.4.11 | web, ios, android |
+| `visual_border` | Applies border styling | 1.4.11 | web, ios, android |
+| `visual_radius` | Applies border radius styling | N/A | web, ios, android |
+| `interaction_hover` | Visual feedback on hover (pointer devices) | 1.4.13 | web, ios, android |
 
 ### Contract Details
 
-#### contains_children
+#### layout_contains_children
 
 **Description**: Container-Base can contain any child components or content.
 
@@ -116,7 +115,7 @@ All components in the Containers family inherit these 7 foundational contracts f
 
 **WCAG Compliance**: 1.3.1 Info and Relationships
 
-#### applies_padding
+#### layout_padding
 
 **Description**: Applies consistent internal padding using space.inset tokens.
 
@@ -124,7 +123,7 @@ All components in the Containers family inherit these 7 foundational contracts f
 
 **WCAG Compliance**: 1.4.12 Text Spacing
 
-#### applies_background
+#### visual_background
 
 **Description**: Applies background color styling.
 
@@ -132,7 +131,7 @@ All components in the Containers family inherit these 7 foundational contracts f
 
 **WCAG Compliance**: 1.4.3 Contrast (Minimum)
 
-#### applies_shadow
+#### visual_shadow
 
 **Description**: Applies shadow/elevation styling.
 
@@ -140,7 +139,7 @@ All components in the Containers family inherit these 7 foundational contracts f
 
 **WCAG Compliance**: 1.4.11 Non-text Contrast
 
-#### hover_state
+#### interaction_hover
 
 **Description**: Visual feedback on hover (pointer devices only).
 

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,23 +102,24 @@ 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 |
 |----------|-------------|------|-----------|
-| `focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
-| `float_label_animation` | Label animates on focus | 2.3.3 | web, ios, android |
-| `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 |
+| `interaction_focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
+| `content_float_label` | Label animates on focus | 2.3.3 | web, ios, android |
+| `validation_on_blur` | Validation triggers on blur | 3.3.1 | web, ios, android |
+| `state_error` | Shows error message and styling | 3.3.1, 1.4.1 | web, ios, android |
+| `state_success` | Shows success styling | 1.4.1 | web, ios, android |
+| `content_trailing_icon` | Shows contextual trailing icons | 1.4.1 | web, ios, android |
+| `interaction_focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
+| `accessibility_reduced_motion` | Respects prefers-reduced-motion | 2.3.3 | web, ios, android |
+
+**Excluded**: `state_disabled` — 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
+#### interaction_focusable
 
 **Description**: Component can receive keyboard focus via Tab key navigation.
 
@@ -126,7 +127,7 @@ All text input components in the Form Inputs family inherit these 9 foundational
 
 **WCAG Compliance**: 2.1.1 Keyboard
 
-#### float_label_animation
+#### content_float_label
 
 **Description**: Label smoothly transitions from placeholder position inside input to floated position above input when focused or filled.
 
@@ -134,7 +135,7 @@ All text input components in the Form Inputs family inherit these 9 foundational
 
 **WCAG Compliance**: 2.3.3 Animation from Interactions
 
-#### error_state_display
+#### state_error
 
 **Description**: When in error state, component displays red border, red label text, error icon, and error message.
 
@@ -142,7 +143,7 @@ All text input components in the Form Inputs family inherit these 9 foundational
 
 **WCAG Compliance**: 3.3.1 Error Identification, 1.4.1 Use of Color
 
-#### focus_ring
+#### interaction_focus_ring
 
 **Description**: When focused via keyboard, component displays a visible focus indicator.
 
@@ -156,24 +157,24 @@ All text input components in the Form Inputs family inherit these 9 foundational
 
 | Contract | Description | WCAG |
 |----------|-------------|------|
-| `validates_email_format` | Validates email against RFC 5322 pattern | 3.3.1 |
-| `provides_email_autocomplete` | Enables browser/platform email autofill | 1.3.5 |
+| `validation_email_format` | Validates email against RFC 5322 pattern | 3.3.1 |
+| `interaction_email_autocomplete` | Enables browser/platform email autofill | 1.3.5 |
 
 #### Input-Text-Password Extended Contracts
 
 | Contract | Description | WCAG |
 |----------|-------------|------|
-| `provides_secure_input` | Masks password input by default | 3.3.2 |
-| `supports_password_toggle` | Provides show/hide password functionality | 2.1.1, 4.1.2 |
-| `provides_password_autocomplete` | Enables browser/platform password autofill | 1.3.5 |
+| `interaction_secure_input` | Masks password input by default | 3.3.2 |
+| `interaction_password_toggle` | Provides show/hide password functionality | 2.1.1, 4.1.2 |
+| `interaction_password_autocomplete` | Enables browser/platform password autofill | 1.3.5 |
 
 #### Input-Text-PhoneNumber Extended Contracts
 
 | Contract | Description | WCAG |
 |----------|-------------|------|
-| `validates_phone_format` | Validates phone number against country-specific patterns | 3.3.1 |
-| `provides_phone_formatting` | Formats phone numbers as user types | 3.3.2 |
-| `supports_international_formats` | Handles multiple country phone number formats | 3.3.2 |
+| `validation_phone_format` | Validates phone number against country-specific patterns | 3.3.1 |
+| `content_phone_formatting` | Formats phone numbers as user types | 3.3.2 |
+| `content_international_formats` | Handles multiple country phone number formats | 3.3.2 |
 
 ### Checkbox Base Contracts (Inherited by Checkbox Components)
 
@@ -181,19 +182,19 @@ All checkbox components in the Form Inputs family inherit these 9 foundational c
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| `focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
-| `pressable` | Responds to click/tap on entire label area | 2.1.1 | web, ios, android |
-| `hover_state` | Visual feedback on hover (web) | 1.4.13 | web |
-| `pressed_state` | Visual feedback when pressed | 2.4.7 | web, ios, android |
-| `checked_state` | Shows checkmark icon when checked | 1.4.1 | web, ios, android |
-| `indeterminate_state` | Shows minus icon for partial selection | 1.4.1 | web, ios, android |
-| `error_state_display` | Shows error border and message | 3.3.1 | web, ios, android |
-| `focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
-| `form_integration` | Native form submission and reset | 4.1.2 | web, ios, android |
+| `interaction_focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
+| `interaction_pressable` | Responds to click/tap on entire label area | 2.1.1 | web, ios, android |
+| `interaction_hover` | Visual feedback on hover (web) | 1.4.13 | web |
+| `interaction_pressed` | Visual feedback when pressed | 2.4.7 | web, ios, android |
+| `state_checked` | Shows checkmark icon when checked | 1.4.1 | web, ios, android |
+| `state_indeterminate` | Shows minus icon for partial selection | 1.4.1 | web, ios, android |
+| `state_error` | Shows error border and message | 3.3.1 | web, ios, android |
+| `interaction_focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
+| `validation_form_integration` | Native form submission and reset | 4.1.2 | web, ios, android |
 
 ### Checkbox Contract Details
 
-#### checked_state
+#### state_checked
 
 **Description**: When checked, component displays filled background with checkmark icon via Icon-Base.
 
@@ -201,7 +202,7 @@ All checkbox components in the Form Inputs family inherit these 9 foundational c
 
 **WCAG Compliance**: 1.4.1 Use of Color (icon provides non-color indication)
 
-#### indeterminate_state
+#### state_indeterminate
 
 **Description**: When indeterminate, component displays filled background with horizontal minus icon via Icon-Base.
 
@@ -209,7 +210,7 @@ All checkbox components in the Form Inputs family inherit these 9 foundational c
 
 **WCAG Compliance**: 1.4.1 Use of Color (icon provides non-color indication)
 
-#### form_integration
+#### validation_form_integration
 
 **Description**: Checkbox integrates with native form submission and reset.
 
@@ -221,8 +222,8 @@ All checkbox components in the Form Inputs family inherit these 9 foundational c
 
 | Contract | Description | WCAG |
 |----------|-------------|------|
-| `explicit_consent` | Prevents pre-checking with console warning | N/A |
-| `audit_trail` | Provides ISO 8601 timestamp and metadata | N/A |
+| `validation_explicit_consent` | Prevents pre-checking with console warning | N/A |
+| `validation_audit_trail` | Provides ISO 8601 timestamp and metadata | N/A |
 | `required_indicator` | Shows "Required" indicator by default | 3.3.2 |
 
 ### Radio Base Contracts (Inherited by Radio Components)
@@ -231,18 +232,18 @@ All radio components in the Form Inputs family inherit these 8 foundational cont
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| `focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
-| `pressable` | Responds to click/tap on entire label area | 2.1.1 | web, ios, android |
-| `hover_state` | Visual feedback on hover (web) | 1.4.13 | web |
-| `pressed_state` | Visual feedback when pressed | 2.4.7 | web, ios, android |
-| `selected_state` | Shows filled dot when selected | 1.4.1 | web, ios, android |
-| `error_state` | Shows error border and message | 3.3.1 | web, ios, android |
-| `focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
-| `form_integration` | Native form submission | 4.1.2 | web, ios, android |
+| `interaction_focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
+| `interaction_pressable` | Responds to click/tap on entire label area | 2.1.1 | web, ios, android |
+| `interaction_hover` | Visual feedback on hover (web) | 1.4.13 | web |
+| `interaction_pressed` | Visual feedback when pressed | 2.4.7 | web, ios, android |
+| `state_selected` | Shows filled dot when selected | 1.4.1 | web, ios, android |
+| `state_error` | Shows error border and message | 3.3.1 | web, ios, android |
+| `interaction_focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
+| `validation_form_integration` | Native form submission | 4.1.2 | web, ios, android |
 
 ### Radio Contract Details
 
-#### selected_state
+#### state_selected
 
 **Description**: When selected, component displays a filled circular dot centered within the outer circle.
 
@@ -262,21 +263,21 @@ All radio components in the Form Inputs family inherit these 8 foundational cont
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| `mutual_exclusivity` | Only one radio selected at a time | N/A | web, ios, android |
-| `keyboard_navigation` | Arrow keys navigate within group | 2.1.1 | web, ios, android |
-| `group_validation` | Required validation at group level | 3.3.1 | web, ios, android |
-| `error_announcement` | Error message announced to screen readers | 4.1.3 | web, ios, android |
-| `radiogroup_role` | Proper ARIA role for group | 4.1.2 | web, ios, android |
+| `composition_mutual_exclusivity` | Only one radio selected at a time | N/A | web, ios, android |
+| `interaction_keyboard_navigation` | Arrow keys navigate within group | 2.1.1 | web, ios, android |
+| `validation_group_required` | Required validation at group level | 3.3.1 | web, ios, android |
+| `accessibility_error_announcement` | Error message announced to screen readers | 4.1.3 | web, ios, android |
+| `accessibility_radiogroup_role` | Proper ARIA role for group | 4.1.2 | web, ios, android |
 
 ### Radio Set Contract Details
 
-#### mutual_exclusivity
+#### composition_mutual_exclusivity
 
 **Description**: Only one radio within the group can be selected at any time.
 
 **Behavior**: When a user selects a radio, the previously selected radio becomes unselected. Clicking an already-selected radio does NOT deselect it (radio convention). The Set coordinates this via event listening (web), environment values (iOS), or CompositionLocal (Android).
 
-#### keyboard_navigation
+#### interaction_keyboard_navigation
 
 **Description**: Arrow keys navigate between radios within the group following WAI-ARIA radio group pattern.
 
@@ -371,8 +372,8 @@ InputTextBase(
 
 | Contract | Description | Platforms |
 |----------|-------------|-----------|
-| `validates_email_format` | Validates email against RFC 5322 pattern on blur | web, ios, android |
-| `provides_email_autocomplete` | Enables browser/platform email autofill | web, ios, android |
+| `validation_email_format` | Validates email against RFC 5322 pattern on blur | web, ios, android |
+| `interaction_email_autocomplete` | Enables browser/platform email autofill | web, ios, android |
 
 #### Usage Example
 
@@ -425,9 +426,9 @@ InputTextEmail(
 
 | Contract | Description | Platforms |
 |----------|-------------|-----------|
-| `provides_secure_input` | Masks password input by default | web, ios, android |
-| `supports_password_toggle` | Provides show/hide password functionality | web, ios, android |
-| `provides_password_autocomplete` | Enables browser/platform password autofill | web, ios, android |
+| `interaction_secure_input` | Masks password input by default | web, ios, android |
+| `interaction_password_toggle` | Provides show/hide password functionality | web, ios, android |
+| `interaction_password_autocomplete` | Enables browser/platform password autofill | web, ios, android |
 
 #### Usage Example
 
@@ -479,9 +480,9 @@ InputTextPassword(
 
 | Contract | Description | Platforms |
 |----------|-------------|-----------|
-| `validates_phone_format` | Validates phone number against country-specific patterns | web, ios, android |
-| `provides_phone_formatting` | Formats phone numbers as user types | web, ios, android |
-| `supports_international_formats` | Handles multiple country phone number formats | web, ios, android |
+| `validation_phone_format` | Validates phone number against country-specific patterns | web, ios, android |
+| `content_phone_formatting` | Formats phone numbers as user types | web, ios, android |
+| `content_international_formats` | Handles multiple country phone number formats | web, ios, android |
 
 #### Supported Countries
 
@@ -665,8 +666,8 @@ interface ConsentChangeData {
 
 | Contract | Description | Platforms |
 |----------|-------------|-----------|
-| `explicit_consent` | Prevents pre-checking with console warning | web, ios, android |
-| `audit_trail` | Provides ISO 8601 timestamp and metadata | web, ios, android |
+| `validation_explicit_consent` | Prevents pre-checking with console warning | web, ios, android |
+| `validation_audit_trail` | Provides ISO 8601 timestamp and metadata | web, ios, android |
 | `required_indicator` | Shows "Required" indicator by default | web, ios, android |
 
 #### Usage Example
@@ -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
 
 ---
 
@@ -85,15 +84,15 @@ All components in the Icons family inherit these 5 foundational contracts from I
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| `renders_svg` | Renders inline SVG with correct viewBox and stroke | N/A | web, ios, android |
-| `color_inheritance` | Inherits color from parent via currentColor | 1.4.1 | web, ios, android |
-| `size_variants` | Supports 11 size variants from typography scale | N/A | web, ios, android |
-| `optical_balance` | Optional 8% lighter blend for icon-text pairing | 1.4.3 | web, ios, android |
+| `visual_renders_svg` | Renders inline SVG with correct viewBox and stroke | N/A | web, ios, android |
+| `visual_color_inheritance` | Inherits color from parent via currentColor | 1.4.1 | web, ios, android |
+| `visual_size_variants` | Supports 11 size variants from typography scale | N/A | web, ios, android |
+| `visual_optical_balance` | Optional 8% lighter blend for icon-text pairing | 1.4.3 | web, ios, android |
 | `accessibility_hidden` | Decorative icons hidden from assistive technology | 1.1.1 | web, ios, android |
 
 ### Contract Details
 
-#### renders_svg
+#### visual_renders_svg
 
 **Description**: Renders inline SVG with correct viewBox and stroke attributes.
 
@@ -101,7 +100,7 @@ All components in the Icons family inherit these 5 foundational contracts from I
 
 **WCAG Compliance**: N/A
 
-#### color_inheritance
+#### visual_color_inheritance
 
 **Description**: Inherits color from parent via currentColor.
 
@@ -109,7 +108,7 @@ All components in the Icons family inherit these 5 foundational contracts from I
 
 **WCAG Compliance**: 1.4.1 Use of Color
 
-#### size_variants
+#### visual_size_variants
 
 **Description**: Supports 11 size variants calculated from typography scale.
 
@@ -126,7 +125,7 @@ All components in the Icons family inherit these 5 foundational contracts from I
 
 **WCAG Compliance**: N/A
 
-#### optical_balance
+#### visual_optical_balance
 
 **Description**: Optional 8% lighter blend for icon-text pairing.
 

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.
 ---
 
@@ -144,7 +143,7 @@ Nav-Header-Base (Primitive) [PLANNED]
 | `accessibility_touch_target` | accessibility | 2.5.5 | web, ios, android |
 | `validation_selection_constraints` | validation | — | web, ios, android |
 
-**Exclusions**: `state_disabled`, `interaction_hoverable` — No disabled or hover states on tab bar.
+**Exclusions**: `state_disabled`, `interaction_hover` — No disabled or hover states on tab bar.
 
 ---
 

package/governance/Component-Family-Progress.md

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