@adia-ai/web-components 0.8.41 → 0.8.43

package/components/toggle-group/toggle-group.yaml

@@ -1,135 +0,0 @@
-# Generated by scripts/migrate-yamls-to-v1.mjs — migrated to v1 contract.
-# Edit this file; run `npm run build:components` to regenerate a2ui.json.
-#
-# ADR-0056 (gh#1303): <toggle-option-ui>'s current-state surface converges
-# onto <segment-ui>'s declared, reflected `[selected]` prop (see
-# toggle-option.yaml). This container sets that prop, keeping `value` as the
-# single source of truth.
-#
-# DEPRECATED (gh#1369, #1363 C1, ADR-0057): superseded by
-# <segmented-ui multiple> + <segment-ui> — same comma-separated value
-# encoding, same corpus/catalog presence. Kept working as-is (no behavior
-# change, one-time console.warn on connect); status: deprecated per the
-# yaml deprecation contract rather than a literal JS-level delegation —
-# see PR body "Rejected alternatives" for why.
-$schema: ../../../../scripts/schemas/component.yaml.schema.json
-name: UIToggleGroup
-tag: toggle-group-ui
-status: deprecated
-component: ToggleGroup
-category: navigation
-version: 1
-description: >-
-  DEPRECATED (gh#1369) — use <segmented-ui multiple> + <segment-ui>
-  instead. Multi-select button group (unlike <segmented-ui> which is
-  single-select by default). Hosts <toggle-option-ui> children, each
-  independently toggleable; emits change events with the active value
-  set.
-props:
-  single:
-    description: "When true, restrict to one active option (single-select) — clicking the already-selected option again CLEARS it (empty value), unlike a native radiogroup. Migration (gh#1369): [single]=true maps to plain <segmented-ui> (no [multiple]) — note segmented-ui's single-select never clears on re-click, it's standard radiogroup semantics; the default (false, multi-select) maps to <segmented-ui multiple>."
-    type: boolean
-    default: false
-    reflect: false  # declarative presentational attribute — CSS/author-time read, non-reactive by design
-  value:
-    description: Comma-separated selected values
-    type: string
-    default: ""
-events:
-  change:
-    description: "Fired when selection changes. detail: { value }"
-    detail:
-      value:
-        type: string
-        description: New toggle-group value.
-slots:
-  default:
-    description: "Default slot — primary child content."
-states:
-  - name: idle
-    description: Default, ready for interaction.
-traits: []
-tokens:
-  --toggle-group-border:
-    description: Border color of the group container
-  --toggle-group-height:
-    description: Height of the group container
-  --toggle-group-radius:
-    description: Border radius of the group container
-  --toggle-option-bg-hover:
-    description: Background color on hover
-  --toggle-option-border:
-    description: Border color between adjacent options
-  --toggle-option-duration:
-    description: Transition duration
-  --toggle-option-easing:
-    description: Transition easing function
-  --toggle-option-fg:
-    description: Default text color
-  --toggle-option-fg-disabled:
-    description: Text color when disabled
-  --toggle-option-fg-hover:
-    description: Text color on hover
-  --toggle-option-focus-ring:
-    description: Focus ring box-shadow
-  --toggle-option-font-size:
-    description: Font size for option text and icons
-  --toggle-option-gap:
-    description: Gap between icon and text within an option
-  --toggle-option-height:
-    description: Min-height of each option
-  --toggle-option-px:
-    description: Horizontal padding of each option
-  --toggle-option-selected-bg:
-    description: Background color when selected
-  --toggle-option-selected-fg:
-    description: Text color when selected
-a2ui:
-  allowedChildren:
-    - ToggleOption
-  rules:
-    - rule: 'DEPRECATED (gh#1369, #1363 C1) — generate <segmented-ui multiple> + <segment-ui> children instead when [single] is false/absent (the default, multi-select). When [single] is true, generate plain <segmented-ui> (no [multiple]) instead — single-select toggle-group maps to segmented''s own single-select mode, not the multiple axis; note segmented-ui single-select never clears on re-click (toggle-group[single] does). Same comma-separated value encoding either way; toggle-group is kept working for existing consumers but should not appear in new generated output.'
-      reason: 'Deprecation redirect — this is the primary rule for this component now.'
-    - rule: 'Multi-select button cluster — hosts <toggle-option-ui> children, each independently toggleable.'
-      reason: 'Multi-select cluster contract (legacy).'
-    - rule: 'Use for filter chips, multi-flag toggles, day-of-week pickers; for binary on/off use <switch-ui>.'
-      reason: 'Capacity guidance (legacy).'
-    - rule: 'Sets the child <toggle-option-ui>''s declared [selected] prop to reflect the group value (ADR-0056) — do not author [selected] directly in generated markup; author the group''s value instead.'
-      reason: 'Parent-managed declared state — group value stays the single source of truth (legacy).'
-anti_patterns: []
-examples:
-  - name: basic-toggle-group
-    description: Basic ToggleGroup usage
-    a2ui: >-
-      [
-        {
-          "id": "root",
-          "component": "Card",
-          "children": [
-            "sec"
-          ]
-        },
-        {
-          "id": "sec",
-          "component": "Section",
-          "children": [
-            "comp"
-          ]
-        },
-        {
-          "id": "comp",
-          "component": "ToggleGroup",
-          "value": ""
-        }
-      ]
-keywords:
-  - togglegroup
-  - toggle-group
-  - toggle
-  - group
-synonyms:
-  toggle-group: [segmented-control, option-group, toggle-set]
-related:
-  - ToggleOption
-  - Segmented
-  - Radio

package/components/toggle-group/toggle-option.a2ui.json

@@ -1,86 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://adiaui.dev/a2ui/v0_9/components/ToggleOption.json",
-  "title": "ToggleOption",
-  "description": "DEPRECATED (gh#1369) — use `<segment-ui>` inside `<segmented-ui multiple>` instead. Child of `<toggle-group-ui>`. One toggleable option inside a single-select or multi-select group. Pressed state mirrors `value` against the parent's selection.",
-  "type": "object",
-  "allOf": [
-    {
-      "$ref": "common_types.json#/$defs/ComponentCommon"
-    },
-    {
-      "$ref": "common_types.json#/$defs/CatalogComponentCommon"
-    }
-  ],
-  "properties": {
-    "component": {
-      "const": "ToggleOption"
-    },
-    "disabled": {
-      "description": "Disabled state — blocks pointer + keyboard activation.",
-      "type": "boolean",
-      "default": false
-    },
-    "icon": {
-      "description": "Optional Phosphor icon name; renders as a leading icon.",
-      "type": "string",
-      "default": ""
-    },
-    "selected": {
-      "description": "Whether this option is currently selected. Managed by the parent\n<toggle-group-ui> container (ADR-0056) — don't set directly; the group's\n`value` is the single source of truth. Converges onto <segment-ui>'s\ndeclared reflected-prop mechanism.",
-      "type": "boolean",
-      "default": false
-    },
-    "text": {
-      "description": "Visible label text.",
-      "type": "string",
-      "default": ""
-    },
-    "value": {
-      "description": "Stable identifier matched against the parent group's `value`.",
-      "type": "string",
-      "default": ""
-    }
-  },
-  "required": [
-    "component"
-  ],
-  "unevaluatedProperties": false,
-  "x-adiaui": {
-    "allowedParents": [
-      "ToggleGroup"
-    ],
-    "anti_patterns": [],
-    "category": "form",
-    "composes": [],
-    "events": {},
-    "examples": [],
-    "keywords": [
-      "toggle-option",
-      "toggle-segment",
-      "option-toggle",
-      "segmented-option"
-    ],
-    "name": "UIToggleOption",
-    "parts": {},
-    "related": [
-      "ToggleGroup",
-      "Segment",
-      "Radio"
-    ],
-    "slots": {},
-    "states": [],
-    "status": "deprecated",
-    "synonyms": {
-      "toggle-option": [
-        "toggle-segment",
-        "option-button",
-        "segmented-option"
-      ]
-    },
-    "tag": "toggle-option-ui",
-    "tokens": {},
-    "traits": [],
-    "version": 1
-  }
-}

package/components/toggle-group/toggle-option.yaml

@@ -1,75 +0,0 @@
-# Edit this file; run `npm run build:components` to regenerate a2ui.json.
-#
-# §228 (v0.5.9): authored to close the §229 baseline class-export-undeclared
-# drift for UIToggleOption. Ships as a sibling class in toggle-group/toggle-group.class.js
-# + is registered alongside UIToggleGroup.
-#
-# ADR-0056 (gh#1303): `selected` converges onto <segment-ui>'s declared,
-# parent-managed, reflected-prop convention.
-#
-# DEPRECATED (gh#1369, #1363 C1, ADR-0057): superseded by <segment-ui>
-# (used as a child of <segmented-ui multiple>). Kept working as-is; see
-# toggle-group.yaml's header for the deprecation rationale.
-
-# Child component of <toggle-group-ui>. Surface only inside that parent.
-$schema: ../../../../scripts/schemas/component.yaml.schema.json
-name: UIToggleOption
-tag: toggle-option-ui
-status: deprecated
-component: ToggleOption
-category: form
-version: 1
-description: |-
-  DEPRECATED (gh#1369) — use `<segment-ui>` inside `<segmented-ui multiple>` instead. Child of `<toggle-group-ui>`. One toggleable option inside a single-select or multi-select group. Pressed state mirrors `value` against the parent's selection.
-
-props:
-  value:
-    description: Stable identifier matched against the parent group's `value`.
-    type: string
-    default: ""
-  text:
-    description: Visible label text.
-    type: string
-    default: ""
-  icon:
-    description: Optional Phosphor icon name; renders as a leading icon.
-    type: string
-    default: ""
-  disabled:
-    description: Disabled state — blocks pointer + keyboard activation.
-    type: boolean
-    default: false
-  selected:
-    description: |-
-      Whether this option is currently selected. Managed by the parent
-      <toggle-group-ui> container (ADR-0056) — don't set directly; the group's
-      `value` is the single source of truth. Converges onto <segment-ui>'s
-      declared reflected-prop mechanism.
-    type: boolean
-    default: false
-    reflect: true
-
-keywords:
-  - toggle-option
-  - toggle-segment
-  - option-toggle
-  - segmented-option
-
-synonyms:
-  toggle-option: [toggle-segment, option-button, segmented-option]
-
-related:
-  - ToggleGroup
-  - Segment
-  - Radio
-
-a2ui:
-  allowedParents:
-    - ToggleGroup
-  rules:
-    - rule: 'DEPRECATED (gh#1369, #1363 C1) — generate <segment-ui> instead, as a child of <segmented-ui multiple> (or plain <segmented-ui>, no [multiple], if the parent toggle-group had [single] — see toggle-group.yaml). toggle-option is kept working for existing consumers but should not appear in new generated output.'
-      reason: 'Deprecation redirect — this is the primary rule for this component now.'
-    - rule: 'Child of <toggle-group-ui> — one independently-toggleable button in a multi-select cluster.'
-      reason: 'Multi-select cluster contract (legacy).'
-    - rule: 'Selected state exposed via its own declared [selected] reflected prop, set by the parent <toggle-group-ui> (ADR-0056) — mirrors <segment-ui>''s convention. Do not set [selected] directly; drive the group''s value instead.'
-      reason: 'Parent-managed declared state — group value stays the single source of truth (legacy).'