@mtdt/observeops-ds-spec 0.1.0

package/components/registry/radio.json

@@ -0,0 +1,238 @@
+{
+  "name": "radio",
+  "component": "MRadioGroup",
+  "display": "Radio",
+  "tier": "atom",
+  "source": "mkit",
+  "sourceFile": "ui/components/Radio/RadioGroup.vue",
+  "status": "core",
+  "maturity": "stable",
+  "summary": "One-of-many selection control. Use MRadioGroup with :options + v-model; as-button renders a segmented control. Standalone MRadio is unused.",
+  "variants": [
+    {
+      "name": "list",
+      "what": "vertical/inline radio list",
+      "usage": "225×"
+    },
+    {
+      "name": "segmented",
+      "what": "joined buttons (as-button)",
+      "usage": "255×"
+    },
+    {
+      "name": "segmented-with-icons",
+      "what": "segmented + icon per option",
+      "usage": "14×"
+    },
+    {
+      "name": "severity-switch",
+      "what": "borderless segmented w/ separators",
+      "usage": "2×"
+    }
+  ],
+  "sizes": [
+    {
+      "name": "small",
+      "value": "dense",
+      "note": "segmented only"
+    },
+    {
+      "name": "default",
+      "value": "normal",
+      "note": ""
+    },
+    {
+      "name": "large",
+      "value": "expanded",
+      "note": ""
+    }
+  ],
+  "states": [
+    {
+      "name": "unchecked",
+      "what": "empty dot"
+    },
+    {
+      "name": "checked",
+      "what": "cyan dot (list) / navy fill (segmented)"
+    },
+    {
+      "name": "focus",
+      "what": "no visible ring (SF-001)"
+    },
+    {
+      "name": "disabled",
+      "what": "muted"
+    }
+  ],
+  "family": "Selection Controls",
+  "model": {
+    "prop": "value",
+    "event": "change"
+  },
+  "optionShape": {
+    "value": "value",
+    "label": "text || label || title",
+    "disabled": "option.disabled"
+  },
+  "props": {
+    "options": {
+      "type": "array",
+      "note": "{ value, text|label|title, disabled? }"
+    },
+    "value": {
+      "type": "any",
+      "note": "v-model — the selected value"
+    },
+    "asButton": {
+      "type": "boolean",
+      "default": false,
+      "note": "segmented control vs radio list; 255x"
+    },
+    "size": {
+      "type": "string",
+      "default": "default",
+      "enum": [
+        "small",
+        "default",
+        "large"
+      ],
+      "note": "mainly affects segmented buttons"
+    },
+    "disabled": {
+      "type": "boolean",
+      "default": false,
+      "note": "whole group; per-option via option.disabled"
+    },
+    "buttonStyle": {
+      "type": "string",
+      "default": "solid",
+      "enum": [
+        "solid",
+        "outline"
+      ],
+      "note": "never set to outline in product (F2)"
+    },
+    "name": {
+      "type": "string"
+    },
+    "defaultValue": {
+      "type": "any"
+    }
+  },
+  "events": [
+    "change"
+  ],
+  "slots": [
+    "default (custom a-radio/a-radio-button)",
+    "option (custom row)"
+  ],
+  "anatomy": [
+    "radio list (a-radio per option)",
+    "OR segmented buttons (a-radio-button, selected fills brand)"
+  ],
+  "tokensUsed": [
+    "--primary",
+    "--border-color",
+    "@primary-color"
+  ],
+  "accessibility": {
+    "semantics": "native input type=radio grouped by name; Arrow keys move selection, Space selects",
+    "focus": "no visible ring (SF-001)",
+    "label": "give the group a field label or aria-label"
+  },
+  "decisionFlow": [
+    "Multi-select (pick any number)? -> Checkbox.",
+    "Instant on/off? -> Switch.",
+    "Many options or space-tight? -> DropdownPicker.",
+    "Pick exactly one from a few visible options? -> Radio.",
+    "[Radio style] >6 options? -> DropdownPicker instead.",
+    "[Radio style] Longer labels / vertical form field? -> radio list (default).",
+    "[Radio style] Alert severity filter (Critical/Major/Warning)? -> Severity switch (radio-toggle-shadow + alert-severity-buttons, as-button).",
+    "[Radio style] Each option clearer with an icon (view/mode toggle)? -> Segmented with icons (as-button + icon in option slot).",
+    "[Radio style] Otherwise small compact set (2-5)? -> plain segmented (as-button)."
+  ],
+  "usageRules": {
+    "radio-list(default)": {
+      "useWhen": "pick one of a few options with a vertical/inline list; longer labels OK",
+      "example": "severity Low/Medium/High on a form"
+    },
+    "segmented(as-button)": {
+      "useWhen": "a small set (2-5) of always-visible, mutually-exclusive choices; compact",
+      "example": "time range 1h/24h/7d/30d, view-mode toggle"
+    },
+    "segmented+icons": {
+      "useWhen": "segmented where each option reads better with an icon (icon via option slot; without-icon-margin context, 14x)",
+      "example": "grid/list/map view toggle"
+    },
+    "severity-switch": {
+      "useWhen": "borderless segmented with separators (real combo: radio-toggle-shadow + alert-severity-buttons, as-button)",
+      "example": "severity-switch.vue (Critical/Major/Warning)"
+    },
+    "disabled": {
+      "useWhen": "whole group not changeable; or option.disabled for one option"
+    },
+    "size=small": {
+      "useWhen": "dense toolbars (segmented)"
+    }
+  },
+  "do": [
+    "Use MRadioGroup with :options for one-of-many; v-model the value.",
+    "Use as-button for a small set of always-visible exclusive choices.",
+    "Disable individual options with option.disabled."
+  ],
+  "dont": [
+    "Don't use radio for multi-select (Checkbox) or instant on/off (Switch).",
+    "Don't use radio for many options / tight space (DropdownPicker).",
+    "Don't render standalone MRadio — go through the group."
+  ],
+  "whenToUse": "Choosing exactly one option from a small, visible set.",
+  "insteadOf": [
+    "raw a-radio-group",
+    "standalone MRadio"
+  ],
+  "usage": {
+    "total": 225,
+    "files": 136,
+    "standaloneMRadio": 0,
+    "asButton": 255,
+    "buttonStyleOutline": 0
+  },
+  "knownIssues": [
+    "F1 (low): standalone MRadio + its variant=info/type=button are unused (0x); the group is the real API.",
+    "F2 (low): buttonStyle outline never used (always solid).",
+    "F3 (high, a11y): no visible focus indicator (SF-001).",
+    "F4 (medium): segmented selected style is context-dependent — standalone = kit .ant-radio-group-solid (navy #111c2c @0.8 opacity); inside form/panel contexts form.less overrides to solid --primary !important + 11px padding + icon spacing. Same markup renders the same in Storybook as the product; divergence is the missing form ancestor. Move the canonical segmented style into the component to make it consistent."
+  ],
+  "segmentedVariants": {
+    "plain": "as-button; selected navy #111c2c @0.8 (kit default)",
+    "with-icons": "icon per option via option slot (without-icon-margin, 14x)",
+    "severity-switch": "radio-toggle-shadow + alert-severity-buttons + as-button (severity-switch.vue): borderless, separators, tinted rounded selected chip",
+    "radio-list-dot": "cyan #099dd9 (Ant @primary-color) — matches product",
+    "outline": "buttonStyle=outline exists but unused"
+  },
+  "related": [
+    "MCheckbox",
+    "MSwitch",
+    "FlotoDropdownPicker",
+    "MButton (segmented = this with as-button)"
+  ],
+  "changelog": [
+    "2026-06-07: added (decision-grade from the start). 225x; standalone MRadio 0x; as-button 255x. Verified list + segmented light/dark. F1-F3. Closes Button's segmented-control relative."
+  ],
+  "storybook": "Atoms/Radio",
+  "figma": {
+    "status": "todo",
+    "component": "Radio"
+  },
+  "kitAccent": "the selected list-dot is painted with Ant's @primary-color = cyan #099dd9 (both themes) — NOT --primary (navy). Not in variables.json; see tokens/kit-accents.json.",
+  "$tokensNote": "Selected fill = --primary (#111c2c light / #e3e8f2 dark); the radio dot/check uses the kit Ant accent @primary-color (#099dd9, kit-accents.json), which is not in variables.json.",
+  "a11y": {
+    "summary": "Tab to the group, Arrow keys move selection; each option role=radio with label, shared name groups them. Selected segment = --primary fill.",
+    "issues": [
+      "No visible focus ring (SF-001)."
+    ],
+    "doc": "Atoms/Radio/Accessibility",
+    "$note": "Catalogue-wide gap SF-001 = no visible :focus-visible ring; tracked in findings/."
+  }
+}

package/components/registry/scheduler.json

@@ -0,0 +1,188 @@
+{
+  "name": "scheduler",
+  "display": "Scheduler (Recurrence)",
+  "tier": "molecule",
+  "family": "Scheduler",
+  "source": "src/components/schedule-input/index.vue (ScheduleInput) + once-input.vue / weekly-input.vue / monthly-input.vue (the sub-forms).",
+  "status": "stable",
+  "summary": "A composite recurrence builder. A 'Scheduler Type' segmented control (MRadioGroup as-button: Once · Daily · Weekly · Monthly) swaps in a sub-form. Once/Daily = Start Date + Hours; Weekly adds Days (Mon-Sun); Monthly adds Months + Dates (1-31). Hours = the custom dropdown TimePicker (multi-select times); Days/Months/Dates = FlotoDropdownPicker multi-selects; Start Date = MDatePicker (date-only, min-date today). Used for backups, network discovery, compliance audits, monitor (re)discovery, reports, runbooks.",
+  "variants": [
+    {
+      "name": "Once",
+      "what": "single run",
+      "usage": ""
+    },
+    {
+      "name": "Daily",
+      "what": "every day",
+      "usage": ""
+    },
+    {
+      "name": "Weekly",
+      "what": "Days + Start + Hours",
+      "usage": ""
+    },
+    {
+      "name": "Monthly",
+      "what": "Months + Dates + Start + Hours",
+      "usage": ""
+    }
+  ],
+  "sizes": [],
+  "states": [
+    {
+      "name": "default",
+      "what": "segmented type control"
+    },
+    {
+      "name": "disabled",
+      "what": "fields not interactive"
+    }
+  ],
+  "usage": {
+    "total": 16,
+    "consumers": [
+      "backup-profile-form",
+      "device-inventory-schedule-backup",
+      "discovery-schedules",
+      "compliance-audit-schedules",
+      "monitor-schedule-form",
+      "rediscover custom-schedule-form",
+      "topology-scanner schedule-form",
+      "runbook-schedules",
+      "report-form",
+      "policy-form basic-info"
+    ],
+    "renders": "REFERENCE REPRODUCTION in Storybook — importing the real ScheduleInput pulls the local DB (lokijs -> Node fs), so it can't render live (like TimeRangePicker / the Kendo grid). Reproduced from the REAL primitives (MRadioGroup as-button + MDatePicker + FlotoDropdownPicker)."
+  },
+  "scheduleTypes": {
+    "Once": "single run — Start Date + Hours",
+    "Daily": "every day — Start Date + Hours (same sub-form as Once)",
+    "Weekly": "Days (Mon-Sun multi) + Start Date + Hours",
+    "Monthly": "Months (Jan-Dec multi) + Dates (1-31 multi) + Start Date + Hours"
+  },
+  "props": {
+    "ScheduleInput": {
+      "value": {
+        "type": "object",
+        "note": "v-model (model event=change): { scheduleType, scheduleInfo }"
+      },
+      "excludedScheduleOptions": {
+        "type": "array",
+        "default": [],
+        "note": "drop schedule types from the segmented control, e.g. ['Weekly','Monthly'] (1x)"
+      },
+      "showOnlyOnce": {
+        "type": "boolean",
+        "default": false,
+        "note": "collapse to the Once type only (no recurrence) (1x)"
+      },
+      "disabled": {
+        "type": "boolean",
+        "note": "passthrough ($attrs) — disables the fields (2x)"
+      },
+      "$attrs": "passed to the sub-form: disabled (2x), time-options (2x), use-single-selection (1x), hide-date-time (1x), multiple"
+    },
+    "subForms": {
+      "value": "object (scheduleInfo)",
+      "hideDateTime": "bool — hide Start Date + Hours",
+      "timeOptions": "array — override the Hours options (external-options on the TimePicker)",
+      "multiple": "bool — allow multiple Hours (use-single-selection caps to 1)"
+    }
+  },
+  "emit": "change -> { scheduleType:'Once'|'Daily'|'Weekly'|'Monthly', scheduleInfo: { startDate:<ms>, times:[…], days:[…](weekly), months:[…]+dates:[…](monthly) } }. On type change, scheduleInfo resets to { startDate: now }.",
+  "builtFrom": [
+    "MRadioGroup (as-button / segmented) — the type control",
+    "MDatePicker (show-time:false, min-date today) — Start Date",
+    "custom TimePicker (time-picker.vue, a FlotoDropdownPicker of times, multiple) — Hours",
+    "FlotoDropdownPicker (multiple, searchable) — Days / Months / Dates",
+    "FlotoFormItem (rules='required') — each field"
+  ],
+  "decisionFlow": [
+    "Need a RECURRING schedule (run X every day/week/month)? -> ScheduleInput.",
+    "Only certain recurrences valid? -> :excluded-schedule-options=['Weekly','Monthly'].",
+    "A single, one-off run (no recurrence)? -> :show-only-once.",
+    "Just a date or date+time value (not a recurrence)? -> MDatePicker (Date & Time Pickers family), not this.",
+    "A chart/dashboard TIME WINDOW? -> TimeRangePicker, not this."
+  ],
+  "usageRules": {
+    "recurring": {
+      "useWhen": "a job runs on a recurrence",
+      "how": "<ScheduleInput v-model>",
+      "example": "nightly backup, weekly compliance audit, monthly report"
+    },
+    "restrictTypes": {
+      "useWhen": "only some recurrences make sense",
+      "how": ":excluded-schedule-options",
+      "example": "a feature that only supports Daily/Weekly"
+    },
+    "oneOff": {
+      "useWhen": "a single scheduled run",
+      "how": ":show-only-once",
+      "example": "a one-time discovery run"
+    }
+  },
+  "do": [
+    "Use for recurring jobs (backups, discovery, audits, reports).",
+    "Drop unsupported recurrences with :excluded-schedule-options.",
+    "Use :show-only-once for a single non-recurring run.",
+    "Keep it inside a form (FlotoFormItem fields are required)."
+  ],
+  "dont": [
+    "Don't use it for a plain date/time value — that's MDatePicker.",
+    "Don't use it for a chart time window — that's TimeRangePicker.",
+    "Don't hand-roll a Once/Daily/Weekly/Monthly switcher — reuse ScheduleInput."
+  ],
+  "knownIssues": {
+    "F1": {
+      "severity": "Low",
+      "issue": "The three sub-forms (once/weekly/monthly-input.vue) all carry name:'OnceForm' — a copy-paste leftover; harmless but should be unique."
+    },
+    "F2": {
+      "severity": "Low",
+      "issue": "ScheduleInput pulls the local DB (lokijs) transitively, so it can't render in Storybook — reproduced from primitives."
+    }
+  },
+  "accessibility": {
+    "providedBy": "MRadioGroup (radio semantics / arrow-key selection for the type), MDatePicker / FlotoDropdownPicker (their own a11y), FlotoFormItem (labels + required/validation).",
+    "verify": "Each field has a visible label (it does, via FlotoFormItem); focus-visible ring (SF-001) on the segmented buttons + selects."
+  },
+  "scopedOut": {
+    "MetricPollTime / metric-collection-time": "metric POLLING-FREQUENCY config (a separate monitoring sub-system) — not a job recurrence; candidate for a future Monitoring-config entry.",
+    "MonitoringHourPicker (_base-monitoring-hour-picker.vue)": "a monitoring-hours selector — separate.",
+    "monitor-schedules.vue (MonitorSchedule)": "a CRUD LIST view of schedules (on/off windows); edits via monitor-schedule-form which uses ScheduleInput — a consumer, not a new component.",
+    "'Hourly' type": "a granularity dropdown in policy anomaly/forecast conditions (aggregation period), NOT a ScheduleInput recurrence type. ScheduleInput types are Once/Daily/Weekly/Monthly only.",
+    "NotifyTimePicker / date-remark-pairs": "notification-timing / holiday-list composites — out of scope."
+  },
+  "storybook": "Molecules/Scheduler",
+  "related": [
+    "radio",
+    "date-time-pickers",
+    "dropdown-picker",
+    "form-item"
+  ],
+  "figma": {
+    "status": "todo"
+  },
+  "tokensUsed": [
+    "--primary",
+    "--neutral-lightest",
+    "--border-color",
+    "--page-text-color",
+    "--neutral-light"
+  ],
+  "events": {
+    "ScheduleInput.change": "(value) — emits the full schedule object `{ scheduleType, scheduleInfo }`; this is the v-model event."
+  },
+  "slots": "none — a segmented schedule-type control (Once / Daily / Weekly / Monthly) + the matching sub-form; no slots.",
+  "a11y": {
+    "summary": "Type = MRadioGroup (radio semantics); date = MDatePicker (input + calendar, Esc); dropdowns = FlotoDropdownPicker (searchable/keyboard); every field wrapped in FlotoFormItem (label + required).",
+    "issues": [
+      "SF-001 focus-visible on the segmented control.",
+      "Announce the required state.",
+      "Type change swaps fields — verify focus lands sensibly."
+    ],
+    "doc": "Molecules/Scheduler/Accessibility",
+    "$note": "Catalogue-wide gap SF-001 = no visible :focus-visible ring; tracked in findings/."
+  }
+}

package/components/registry/select.json

@@ -0,0 +1,247 @@
+{
+  "name": "select",
+  "component": "MSelect",
+  "display": "Select",
+  "tier": "atom",
+  "category": "form-control",
+  "source": "mkit",
+  "sourceFile": "ui/components/Select/Select.vue",
+  "status": "low-use",
+  "maturity": "low-use",
+  "summary": "Kit's raw Ant a-select wrapper. LOW-USE (2x, both mode=tags) — the product's select is FlotoDropdownPicker (510x). Modes default/multiple/tags; v-model value/change.",
+  "variants": [
+    {
+      "name": "single",
+      "what": "single select (default, rare)",
+      "usage": ""
+    },
+    {
+      "name": "multiple",
+      "what": "multi-select chips",
+      "usage": ""
+    },
+    {
+      "name": "tags",
+      "what": "free-type (mode=tags)",
+      "usage": "2×"
+    }
+  ],
+  "sizes": [
+    {
+      "name": "small",
+      "value": "compact",
+      "note": ""
+    },
+    {
+      "name": "default",
+      "value": "normal",
+      "note": ""
+    },
+    {
+      "name": "large",
+      "value": "expanded",
+      "note": ""
+    }
+  ],
+  "states": [
+    {
+      "name": "default",
+      "what": "resting"
+    },
+    {
+      "name": "focus",
+      "what": "no ring (SF-001)"
+    },
+    {
+      "name": "open",
+      "what": "dropdown visible"
+    },
+    {
+      "name": "disabled",
+      "what": "greyed"
+    },
+    {
+      "name": "loading",
+      "what": "chevron → spinner"
+    }
+  ],
+  "family": "Form Controls",
+  "model": {
+    "prop": "value",
+    "event": "change"
+  },
+  "optionShape": {
+    "value": "value || key || id",
+    "label": "text || label || title || name",
+    "disabled": "option.disabled"
+  },
+  "props": {
+    "mode": {
+      "type": "string",
+      "default": "default",
+      "enum": [
+        "default",
+        "multiple",
+        "tags",
+        "combobox"
+      ]
+    },
+    "options": {
+      "type": "array",
+      "note": "{ value, text } objects; or slot a-select-option"
+    },
+    "showSearch": {
+      "type": "boolean",
+      "default": false
+    },
+    "allowClear": {
+      "type": "boolean",
+      "default": true
+    },
+    "size": {
+      "type": "string",
+      "default": "default",
+      "enum": [
+        "small",
+        "default",
+        "large"
+      ]
+    },
+    "loading": {
+      "type": "boolean",
+      "note": "chevron -> spinner"
+    },
+    "disabled": {
+      "type": "boolean",
+      "default": false
+    },
+    "maxTagCount": {
+      "type": "number"
+    },
+    "labelInValue": {
+      "type": "boolean"
+    },
+    "filterOption": {
+      "type": [
+        "boolean",
+        "function"
+      ],
+      "note": "default case-insensitive on label"
+    },
+    "tokenSeparators": {
+      "type": "array"
+    },
+    "placeholder": {
+      "type": "string",
+      "default": "Select..."
+    }
+  },
+  "events": [
+    "change",
+    "search",
+    "select",
+    "deselect",
+    "blur",
+    "focus",
+    "inputKeydown",
+    "popupScroll",
+    "dropdownVisibleChange"
+  ],
+  "slots": [
+    "default/option",
+    "suffixIcon",
+    "clearIcon",
+    "removeIcon",
+    "menuItemSelectedIcon",
+    "notFoundContent (MNoData)",
+    "dropdownRender"
+  ],
+  "anatomy": [
+    "trigger (value/placeholder + chevron)",
+    "selected chips (multiple/tags)",
+    "dropdown options list",
+    "no-data (MNoData)"
+  ],
+  "tokensUsed": [
+    "--page-background-color",
+    "--border-color",
+    "--page-text-color",
+    "@input-height-base"
+  ],
+  "accessibility": {
+    "semantics": "real Ant combobox — role/aria-expanded/aria-activedescendant, listbox/options, keyboard open + type-ahead",
+    "note": "MORE accessible than FlotoDropdownPicker (SF-003); a reference for fixing SF-003",
+    "focus": "no visible ring (SF-001)"
+  },
+  "decisionFlow": [
+    "Need the product's standard select (single/multi/search/virtualized/custom trigger)? -> FlotoDropdownPicker (the norm, 510x).",
+    "Free-form tag input? -> LooseTags.",
+    "Tree / hierarchy select? -> MTreeSelect.",
+    "Specifically need the raw Ant a-select primitive? -> MSelect (rare, 2x)."
+  ],
+  "usageRules": {
+    "default(single)": {
+      "useWhen": "raw single Ant select (rare) — prefer FlotoDropdownPicker",
+      "example": "low-level use only"
+    },
+    "multiple": {
+      "useWhen": "raw multi Ant select (rare) — prefer FlotoDropdownPicker multiple",
+      "example": "chips in field"
+    },
+    "tags": {
+      "useWhen": "free-type tags — but prefer LooseTags",
+      "example": "the 2 real usages (LooseTags / object-tag-picker)"
+    }
+  },
+  "do": [
+    "For a real select use FlotoDropdownPicker; for a tag input use LooseTags.",
+    "Use MSelect only as the low-level Ant primitive when raw a-select is specifically needed.",
+    "Wrap in FlotoFormItem for label + validation."
+  ],
+  "dont": [
+    "Don't introduce new MSelect usages as 'the select' (that's FlotoDropdownPicker).",
+    "Don't use mode=tags here — use LooseTags."
+  ],
+  "whenToUse": "Rarely — FlotoDropdownPicker is the product select. MSelect is the low-level Ant primitive.",
+  "insteadOf": [
+    "raw a-select"
+  ],
+  "usage": {
+    "total": 2,
+    "files": 2,
+    "note": "both mode=tags (LooseTags, object-tag-picker); FlotoDropdownPicker is 510x",
+    "MTreeSelect": 0
+  },
+  "knownIssues": [
+    "F1 (medium): superseded by FlotoDropdownPicker (2x vs 510x) — effectively legacy/low-level. Use DropdownPicker for selects, LooseTags for tag inputs.",
+    "F2 (medium, a11y, ironic): MSelect IS an accessible combobox (Ant) while the widely-used FlotoDropdownPicker is NOT (SF-003). Mirror Ant's ARIA when fixing SF-003.",
+    "F3 (high, a11y): no visible focus ring (SF-001).",
+    "F4 (low): clear x is invisible — Select.vue hardcodes clearIcon as <MIcon name=times-circle type=fas> (FA solid) but only fal (light) icons are registered (639 fal, 0 fas). type=fas used 3x (Select, TreeSelect, navbar). Chip remove x works (fal times). Fix: drop type=fas (use fal) or register fas set.",
+    "F5 (low): clear x overlaps the dropdown chevron — the custom suffixIcon chevron (MIcon) is wider than Ant's clear mask box, so the chevron's left edge pokes out beside the x (chevron left 123, clear left 129). Fix: hide .ant-select-arrow while clearing, or widen the mask. NET (F4+F5): MSelect clear-all is broken; catalog stories omit allow-clear and show chip-remove; use FlotoDropdownPicker for a clearable select."
+  ],
+  "related": [
+    "FlotoDropdownPicker",
+    "LooseTags",
+    "MTreeSelect",
+    "MSelectOption",
+    "FlotoFormItem"
+  ],
+  "changelog": [
+    "2026-06-07: added (badged low-use, decision-grade). Ant a-select wrapper — modes default/multiple/tags, show-search, allow-clear (default true), sizes, loading, slots (notFoundContent->MNoData); v-model value/change. Verified single/multiple/tags. F1 (superseded 2x vs 510x), F2 (accessible vs SF-003), F3 (focus)."
+  ],
+  "storybook": "Atoms/Select",
+  "figma": {
+    "status": "n/a",
+    "component": "Select (low-use — build DropdownPicker instead)"
+  },
+  "$tokensNote": "Dropdown/selected highlight uses the kit Ant accent @primary-color (#099dd9, kit-accents.json); other Ant Select internals follow the kit, not variables.json.",
+  "a11y": {
+    "summary": "role=combobox + aria-expanded + aria-activedescendant; listbox of options. Enter/Space/↓ open, type-ahead, Esc close. Label via FlotoFormItem/aria-label.",
+    "issues": [
+      "No visible focus ring (SF-001).",
+      "Ensure empty (MNoData) result is announced."
+    ],
+    "doc": "Atoms/Select/Accessibility",
+    "$note": "Catalogue-wide gap SF-001 = no visible :focus-visible ring; tracked in findings/."
+  }
+}