@qijenchen/design-system 0.1.0-beta.13 → 0.1.0-beta.131

package/dist/components/ProgressBar/progress-bar.js

@@ -3,9 +3,8 @@ import * as React from "react";
 import * as ProgressPrimitive from "@radix-ui/react-progress";
 import { XCircle, CircleCheck } from "lucide-react";
 import { cn } from "../../lib/utils.js";
-const DEFAULT_TRACK_H = 4;
 const STATUS_FILL = {
-  inProgress: "bg-primary",
+  inProgress: "bg-info",
   success: "bg-success",
   error: "bg-error"
 };
@@ -18,13 +17,11 @@ const ProgressBar = React.forwardRef(
     value,
     status = "inProgress",
     affix,
-    height,
     className,
     ...props
   }, ref) => {
     const clampedValue = Math.max(0, Math.min(100, value));
     const fillColor = STATUS_FILL[status];
-    const trackH = height ?? DEFAULT_TRACK_H;
     let affixNode = null;
     if (affix === "value") {
       affixNode = /* @__PURE__ */ jsxs("span", { className: "text-caption text-foreground tabular-nums shrink-0", children: [
@@ -44,15 +41,14 @@ const ProgressBar = React.forwardRef(
         value: clampedValue,
         max: 100,
         className: cn(
-          "relative overflow-hidden rounded-full bg-secondary w-full",
+          "relative h-1 overflow-hidden rounded-full bg-secondary w-full",
           className
         ),
-        style: { height: trackH },
         ...props,
         children: /* @__PURE__ */ jsx(
           ProgressPrimitive.Indicator,
           {
-            className: cn("h-full rounded-full transition-all duration-300", fillColor),
+            className: cn("h-full rounded-full transition-all duration-300 motion-reduce:duration-0", fillColor),
             style: { width: `${clampedValue}%` }
           }
         )
@@ -72,9 +68,9 @@ const progressBarMeta = {
   // non-family composite / overlay / layout
   variants: {},
   sizes: {},
-  states: ["default", "hover", "active", "focus-visible", "disabled"],
+  states: ["default"],
   tokens: {
-    bg: ["bg-error", "bg-primary", "bg-secondary", "bg-success"],
+    bg: ["bg-error", "bg-info", "bg-secondary", "bg-success"],
     fg: ["text-foreground"],
     ring: []
   }

package/dist/components/ProgressBar/progress-bar.js.map

@@ -1 +1 @@
-{"version":3,"file":"progress-bar.js","sources":["../../../src/components/ProgressBar/progress-bar.tsx"],"sourcesContent":["// @benchmark-unverified-blanket: file-level retraction per M22 (d) — claims herein not individually URL-cited; treat as unverified visual/usage rumor unless retrofit per-claim. Hook escape preserved.\nimport * as React from 'react'\nimport * as ProgressPrimitive from '@radix-ui/react-progress'\nimport { CircleCheck, XCircle } from 'lucide-react'\nimport { cn } from '@/lib/utils'\n\n/**\n * ProgressBar — 水平進度條(determinate)\n *\n * 世界級對照:Material `LinearProgress` / Ant `Progress` / Polaris `ProgressBar` /\n * shadcn `Progress`(皆為 Radix Progress primitive 的包裝)。本 DS 命名為\n * `ProgressBar`(linear)以和 `CircularProgress`(circular)做清楚區分。\n *\n * ── 與 CircularProgress 的分界 ──\n * CircularProgress = circular 兩態(indeterminate 旋轉 / determinate arc),inline 小空間\n * ProgressBar      = linear determinate(0-100% 已知量化),頁面級大區塊 / 表單 wizard / quota\n * 兩者視覺與語意都不同,consumer 依「形狀(linear / circular)+ 是否量化」擇一。\n *\n * ── 與 FileItem 的分界(2026-04-20 user 決策) ──\n * **檔案上傳 UI 走 `FileItem`,不直接消費 ProgressBar**。FileItem 是檔案上傳情境的\n * canonical consumer-facing primitive(檔名 / icon / 進度 / status / actions 一條龍);\n * FileItem 內部可能消費 ProgressBar(engineering 實作細節),consumer 不用也不該自己\n * 組合 raw ProgressBar + 檔名 + action 來做上傳列表。世界級對照:Ant Design 的 `Upload`\n * vs `Progress`(Upload.List 內部用 Progress,consumer 不直接用 Progress 做上傳 UI)。\n *\n * ── 3 狀態,單一 size ──\n * status: inProgress(進行中藍) / success(完成綠) / error(失敗紅)\n *   ^ 命名理由:`status` 是 lifecycle(在途 / 終態),不是視覺 emphasis 階。前身\n *   `primary` 會撞 Button `variant=\"primary\"`(emphasis 最高階),改用世界級\n *   lifecycle 慣例(Polaris `inProgress` / Ant Progress `active`)。\n *\n * **單一高度 4px**(2026-04-20 user 決策):對齊 Material 3 / Carbon / Ant 慣例\n * (固定 4dp/px 不給 size 選項)。4px 是 linear progress 的業界 canonical;若需\n * 視覺強調改用 CircularProgress + label 或改做 full-width hero 版型,不靠 size\n * 階梯撐。移除前的 sm(2)/ md(4)/ lg(6)刻度差太小,無實質視覺區分。\n *\n * ── affix(右側附加) ──\n * `affix=\"value\"` → 顯示 `{value}%` 文字\n * `affix=\"status-icon\"` → 顯示狀態 icon(success ✓ / error ✗;inProgress 時無 icon)\n * `affix={<custom />}` → consumer 客製\n * 不傳 → 純 bar\n */\n\nconst DEFAULT_TRACK_H = 4 // 預設 4px(見 docblock「單一高度」)\nconst STATUS_FILL = {\n  inProgress: 'bg-primary',\n  success: 'bg-success',\n  error: 'bg-error',\n} as const\nconst STATUS_ICON = {\n  success: { Icon: CircleCheck, className: 'text-success' },\n  error:   { Icon: XCircle,     className: 'text-error' },\n} as const\n\nexport interface ProgressBarProps extends Omit<React.ComponentProps<typeof ProgressPrimitive.Root>, 'value'> {\n  /** 當前進度 0-100 */\n  value: number\n  /** 狀態色(lifecycle,非 emphasis 階) */\n  status?: 'inProgress' | 'success' | 'error'\n  /** 右側附加 */\n  affix?: 'value' | 'status-icon' | React.ReactNode\n  /**\n   * Track 高度(px)override。**預設 4**(對齊 Material / Carbon / Ant canonical)。\n   *\n   * **非公開 size 階**——這不是給 consumer 自由選擇粗細的 API,而是給**內部另一個\n   * DS 元件(FileItem)在極密集 row layout 下壓低到 2px** 的逃生艙。Consumer 端\n   * 一律走預設 4px。未來若新 primitive(例如 health-bar 型 hero progress)需要\n   * 較高的 track,再評估是否擴公開 API。\n   *\n   * 世界級對照:Ant `<Progress>` 有 `strokeWidth` 原生 prop;本 DS 只暴露給內部\n   * 元件使用,不在 public API 宣傳,避免 consumer 重新陷入「選哪個 size」的判斷負擔。\n   */\n  height?: number\n}\n\nconst ProgressBar = React.forwardRef<HTMLDivElement, ProgressBarProps>(\n  (\n    {\n      value,\n      status = 'inProgress',\n      affix,\n      height,\n      className,\n      ...props\n    },\n    ref,\n  ) => {\n    const clampedValue = Math.max(0, Math.min(100, value))\n    const fillColor = STATUS_FILL[status]\n    const trackH = height ?? DEFAULT_TRACK_H\n\n    // Affix 渲染\n    let affixNode: React.ReactNode = null\n    if (affix === 'value') {\n      affixNode = (\n        <span className=\"text-caption text-foreground tabular-nums shrink-0\">\n          {Math.round(clampedValue)}%\n        </span>\n      )\n    } else if (affix === 'status-icon') {\n      const s = status !== 'inProgress' ? STATUS_ICON[status] : null\n      if (s) affixNode = <s.Icon size={16} className={cn('shrink-0', s.className)} aria-hidden />\n    } else if (React.isValidElement(affix) || typeof affix === 'string' || typeof affix === 'number') {\n      affixNode = affix\n    }\n\n    const bar = (\n      <ProgressPrimitive.Root\n        ref={ref}\n        value={clampedValue}\n        max={100}\n        className={cn(\n          'relative overflow-hidden rounded-full bg-secondary w-full',\n          className,\n        )}\n        style={{ height: trackH }}\n        {...props}\n      >\n        <ProgressPrimitive.Indicator\n          className={cn('h-full rounded-full transition-all duration-300', fillColor)}\n          style={{ width: `${clampedValue}%` }}\n        />\n      </ProgressPrimitive.Root>\n    )\n\n    if (!affixNode) return bar\n\n    return (\n      <div className=\"flex items-center gap-2 w-full\">\n        <div className=\"flex-1 min-w-0\">{bar}</div>\n        {affixNode}\n      </div>\n    )\n  },\n)\nProgressBar.displayName = 'ProgressBar'\n\n// Story auto-compile metadata — Phase 1 mechanical migration(2026-04-24)\n// Phase 2 fill needed: purpose descriptions + when rationale + world-class refs\nexport const progressBarMeta = {\n  component: 'ProgressBar',\n  family: null, // non-family composite / overlay / layout\n  variants: {\n\n  },\n  sizes: {\n\n  },\n  states: ['default', 'hover', 'active', 'focus-visible', 'disabled'],\n  tokens: {\n    bg: ['bg-error', 'bg-primary', 'bg-secondary', 'bg-success'],\n    fg: ['text-foreground'],\n    ring: [],\n  },\n} as const\n\nexport { ProgressBar }\n"],"names":[],"mappings":";;;;;AA2CA,MAAM,kBAAkB;AACxB,MAAM,cAAc;AAAA,EAClB,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,OAAO;AACT;AACA,MAAM,cAAc;AAAA,EAClB,SAAS,EAAE,MAAM,aAAa,WAAW,eAAA;AAAA,EACzC,OAAS,EAAE,MAAM,SAAa,WAAW,aAAA;AAC3C;AAuBA,MAAM,cAAc,MAAM;AAAA,EACxB,CACE;AAAA,IACE;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,eAAe,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC;AACrD,UAAM,YAAY,YAAY,MAAM;AACpC,UAAM,SAAS,UAAU;AAGzB,QAAI,YAA6B;AACjC,QAAI,UAAU,SAAS;AACrB,kBACE,qBAAC,QAAA,EAAK,WAAU,sDACb,UAAA;AAAA,QAAA,KAAK,MAAM,YAAY;AAAA,QAAE;AAAA,MAAA,GAC5B;AAAA,IAEJ,WAAW,UAAU,eAAe;AAClC,YAAM,IAAI,WAAW,eAAe,YAAY,MAAM,IAAI;AAC1D,UAAI,EAAG,aAAY,oBAAC,EAAE,MAAF,EAAO,MAAM,IAAI,WAAW,GAAG,YAAY,EAAE,SAAS,GAAG,eAAW,MAAC;AAAA,IAC3F,WAAW,MAAM,eAAe,KAAK,KAAK,OAAO,UAAU,YAAY,OAAO,UAAU,UAAU;AAChG,kBAAY;AAAA,IACd;AAEA,UAAM,MACJ;AAAA,MAAC,kBAAkB;AAAA,MAAlB;AAAA,QACC;AAAA,QACA,OAAO;AAAA,QACP,KAAK;AAAA,QACL,WAAW;AAAA,UACT;AAAA,UACA;AAAA,QAAA;AAAA,QAEF,OAAO,EAAE,QAAQ,OAAA;AAAA,QAChB,GAAG;AAAA,QAEJ,UAAA;AAAA,UAAC,kBAAkB;AAAA,UAAlB;AAAA,YACC,WAAW,GAAG,mDAAmD,SAAS;AAAA,YAC1E,OAAO,EAAE,OAAO,GAAG,YAAY,IAAA;AAAA,UAAI;AAAA,QAAA;AAAA,MACrC;AAAA,IAAA;AAIJ,QAAI,CAAC,UAAW,QAAO;AAEvB,WACE,qBAAC,OAAA,EAAI,WAAU,kCACb,UAAA;AAAA,MAAA,oBAAC,OAAA,EAAI,WAAU,kBAAkB,UAAA,KAAI;AAAA,MACpC;AAAA,IAAA,GACH;AAAA,EAEJ;AACF;AACA,YAAY,cAAc;AAInB,MAAM,kBAAkB;AAAA,EAC7B,WAAW;AAAA,EACX,QAAQ;AAAA;AAAA,EACR,UAAU,CAAA;AAAA,EAGV,OAAO,CAAA;AAAA,EAGP,QAAQ,CAAC,WAAW,SAAS,UAAU,iBAAiB,UAAU;AAAA,EAClE,QAAQ;AAAA,IACN,IAAI,CAAC,YAAY,cAAc,gBAAgB,YAAY;AAAA,IAC3D,IAAI,CAAC,iBAAiB;AAAA,IACtB,MAAM,CAAA;AAAA,EAAC;AAEX;"}
+{"version":3,"file":"progress-bar.js","sources":["../../../src/components/ProgressBar/progress-bar.tsx"],"sourcesContent":["// @benchmark-unverified-blanket: file-level retraction per M22 (d) — claims herein not individually URL-cited; treat as unverified visual/usage rumor unless retrofit per-claim. Hook escape preserved.\nimport * as React from 'react'\nimport * as ProgressPrimitive from '@radix-ui/react-progress'\nimport { CircleCheck, XCircle } from 'lucide-react'\nimport { cn } from '@/lib/utils'\n\n/**\n * ProgressBar — 水平進度條(determinate)\n *\n * 世界級對照:Material `LinearProgress` / Ant `Progress` / Polaris `ProgressBar` /\n * shadcn `Progress`(皆為 Radix Progress primitive 的包裝)。本 DS 命名為\n * `ProgressBar`(linear)以和 `CircularProgress`(circular)做清楚區分。\n *\n * ── 與 CircularProgress 的分界 ──\n * CircularProgress = circular 兩態(indeterminate 旋轉 / determinate arc),inline 小空間\n * ProgressBar      = linear determinate(0-100% 已知量化),頁面級大區塊 / 表單 wizard / quota\n * 兩者視覺與語意都不同,consumer 依「形狀(linear / circular)+ 是否量化」擇一。\n *\n * ── 與 FileItem 的分界(2026-04-20 user 決策) ──\n * **檔案上傳 UI 走 `FileItem`,不直接消費 ProgressBar**。FileItem 是檔案上傳情境的\n * canonical consumer-facing primitive(檔名 / icon / 進度 / status / actions 一條龍);\n * FileItem 內部可能消費 ProgressBar(engineering 實作細節),consumer 不用也不該自己\n * 組合 raw ProgressBar + 檔名 + action 來做上傳列表。世界級對照:Ant Design 的 `Upload`\n * vs `Progress`(Upload.List 內部用 Progress,consumer 不直接用 Progress 做上傳 UI)。\n *\n * ── 3 狀態,單一 size ──\n * status: inProgress(進行中藍) / success(完成綠) / error(失敗 deep-orange,bg-error=--color-deep-orange-6)\n *   ^ 命名理由:`status` 是 lifecycle(在途 / 終態),不是視覺 emphasis 階。前身\n *   `primary` 會撞 Button `variant=\"primary\"`(emphasis 最高階),改用世界級\n *   lifecycle 慣例(Polaris `inProgress` / Ant Progress `active`)。\n *\n * **單一高度 4px**(2026-04-20 user 決策):對齊 Material 3 / Carbon / Ant 慣例\n * (固定 4dp/px 不給 size 選項)。4px 是 linear progress 的業界 canonical;若需\n * 視覺強調改用 CircularProgress + label 或改做 full-width hero 版型,不靠 size\n * 階梯撐。移除前的 sm(2)/ md(4)/ lg(6)刻度差太小,無實質視覺區分。\n *\n * ── affix(右側附加) ──\n * `affix=\"value\"` → 顯示 `{value}%` 文字\n * `affix=\"status-icon\"` → 顯示狀態 icon(success ✓ / error ✗;inProgress 時無 icon)\n * `affix={<custom />}` → consumer 客製\n * 不傳 → 純 bar\n */\n\nconst STATUS_FILL = {\n  inProgress: 'bg-info',\n  success: 'bg-success',\n  error: 'bg-error',\n} as const\nconst STATUS_ICON = {\n  success: { Icon: CircleCheck, className: 'text-success' },\n  error:   { Icon: XCircle,     className: 'text-error' },\n} as const\n\nexport interface ProgressBarProps extends Omit<React.ComponentProps<typeof ProgressPrimitive.Root>, 'value'> {\n  /** 當前進度 0-100 */\n  value: number\n  /** 狀態色(lifecycle,非 emphasis 階) */\n  status?: 'inProgress' | 'success' | 'error'\n  /** 右側附加 */\n  affix?: 'value' | 'status-icon' | React.ReactNode\n}\n\nconst ProgressBar = React.forwardRef<HTMLDivElement, ProgressBarProps>(\n  (\n    {\n      value,\n      status = 'inProgress',\n      affix,\n      className,\n      ...props\n    },\n    ref,\n  ) => {\n    const clampedValue = Math.max(0, Math.min(100, value))\n    const fillColor = STATUS_FILL[status]\n    // Affix 渲染\n    let affixNode: React.ReactNode = null\n    if (affix === 'value') {\n      affixNode = (\n        <span className=\"text-caption text-foreground tabular-nums shrink-0\">\n          {Math.round(clampedValue)}%\n        </span>\n      )\n    } else if (affix === 'status-icon') {\n      const s = status !== 'inProgress' ? STATUS_ICON[status] : null\n      if (s) affixNode = <s.Icon size={16} className={cn('shrink-0', s.className)} aria-hidden />\n    } else if (React.isValidElement(affix) || typeof affix === 'string' || typeof affix === 'number') {\n      affixNode = affix\n    }\n\n    const bar = (\n      <ProgressPrimitive.Root\n        ref={ref}\n        value={clampedValue}\n        max={100}\n        className={cn(\n          'relative h-1 overflow-hidden rounded-full bg-secondary w-full',\n          className,\n        )}\n        {...props}\n      >\n        <ProgressPrimitive.Indicator\n          className={cn('h-full rounded-full transition-all duration-300 motion-reduce:duration-0', fillColor)}\n          style={{ width: `${clampedValue}%` }}\n        />\n      </ProgressPrimitive.Root>\n    )\n\n    if (!affixNode) return bar\n\n    return (\n      <div className=\"flex items-center gap-2 w-full\">\n        <div className=\"flex-1 min-w-0\">{bar}</div>\n        {affixNode}\n      </div>\n    )\n  },\n)\nProgressBar.displayName = 'ProgressBar'\n\n// Story auto-compile metadata — Phase 1 mechanical migration(2026-04-24)\n// Phase 2 fill needed: purpose descriptions + when rationale + world-class refs\nexport const progressBarMeta = {\n  component: 'ProgressBar',\n  family: null, // non-family composite / overlay / layout\n  variants: {\n\n  },\n  sizes: {\n\n  },\n  states: ['default'],\n  tokens: {\n    bg: ['bg-error', 'bg-info', 'bg-secondary', 'bg-success'],\n    fg: ['text-foreground'],\n    ring: [],\n  },\n} as const\n\nexport { ProgressBar }\n"],"names":[],"mappings":";;;;;AA2CA,MAAM,cAAc;AAAA,EAClB,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,OAAO;AACT;AACA,MAAM,cAAc;AAAA,EAClB,SAAS,EAAE,MAAM,aAAa,WAAW,eAAA;AAAA,EACzC,OAAS,EAAE,MAAM,SAAa,WAAW,aAAA;AAC3C;AAWA,MAAM,cAAc,MAAM;AAAA,EACxB,CACE;AAAA,IACE;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,eAAe,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC;AACrD,UAAM,YAAY,YAAY,MAAM;AAEpC,QAAI,YAA6B;AACjC,QAAI,UAAU,SAAS;AACrB,kBACE,qBAAC,QAAA,EAAK,WAAU,sDACb,UAAA;AAAA,QAAA,KAAK,MAAM,YAAY;AAAA,QAAE;AAAA,MAAA,GAC5B;AAAA,IAEJ,WAAW,UAAU,eAAe;AAClC,YAAM,IAAI,WAAW,eAAe,YAAY,MAAM,IAAI;AAC1D,UAAI,EAAG,aAAY,oBAAC,EAAE,MAAF,EAAO,MAAM,IAAI,WAAW,GAAG,YAAY,EAAE,SAAS,GAAG,eAAW,MAAC;AAAA,IAC3F,WAAW,MAAM,eAAe,KAAK,KAAK,OAAO,UAAU,YAAY,OAAO,UAAU,UAAU;AAChG,kBAAY;AAAA,IACd;AAEA,UAAM,MACJ;AAAA,MAAC,kBAAkB;AAAA,MAAlB;AAAA,QACC;AAAA,QACA,OAAO;AAAA,QACP,KAAK;AAAA,QACL,WAAW;AAAA,UACT;AAAA,UACA;AAAA,QAAA;AAAA,QAED,GAAG;AAAA,QAEJ,UAAA;AAAA,UAAC,kBAAkB;AAAA,UAAlB;AAAA,YACC,WAAW,GAAG,4EAA4E,SAAS;AAAA,YACnG,OAAO,EAAE,OAAO,GAAG,YAAY,IAAA;AAAA,UAAI;AAAA,QAAA;AAAA,MACrC;AAAA,IAAA;AAIJ,QAAI,CAAC,UAAW,QAAO;AAEvB,WACE,qBAAC,OAAA,EAAI,WAAU,kCACb,UAAA;AAAA,MAAA,oBAAC,OAAA,EAAI,WAAU,kBAAkB,UAAA,KAAI;AAAA,MACpC;AAAA,IAAA,GACH;AAAA,EAEJ;AACF;AACA,YAAY,cAAc;AAInB,MAAM,kBAAkB;AAAA,EAC7B,WAAW;AAAA,EACX,QAAQ;AAAA;AAAA,EACR,UAAU,CAAA;AAAA,EAGV,OAAO,CAAA;AAAA,EAGP,QAAQ,CAAC,SAAS;AAAA,EAClB,QAAQ;AAAA,IACN,IAAI,CAAC,YAAY,WAAW,gBAAgB,YAAY;AAAA,IACxD,IAAI,CAAC,iBAAiB;AAAA,IACtB,MAAM,CAAA;AAAA,EAAC;AAEX;"}

package/dist/components/RadioGroup/index.d.ts

@@ -0,0 +1,2 @@
+export * from './radio-group';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/RadioGroup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/RadioGroup/index.ts"],"names":[],"mappings":"AAIA,cAAc,eAAe,CAAA"}

package/dist/components/RadioGroup/index.js

@@ -0,0 +1,8 @@
+import { RadioGroup, RadioGroupItem, radioGroupMeta, radioItemVariants } from "./radio-group.js";
+export {
+  RadioGroup,
+  RadioGroupItem,
+  radioGroupMeta,
+  radioItemVariants
+};
+//# sourceMappingURL=index.js.map

package/dist/components/RadioGroup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/RadioGroup/radio-group.d.ts

@@ -2,14 +2,16 @@ import * as React from "react";
 import * as RadioGroupPrimitive from "@radix-ui/react-radio-group";
 import { type VariantProps } from "class-variance-authority";
 import type { FieldMode, FieldVariant } from "../../components/Field/field-types";
-export interface RadioGroupProps extends React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root> {
+import type { LucideIcon } from "lucide-react";
+import type { AvatarData } from "../../components/Avatar/avatar";
+export interface RadioGroupProps extends Omit<React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root>, 'asChild'> {
     /**
      * Field mode(2026-05-05 Phase B3 align):
      *   edit     — 一般可互動 RadioGroup(預設)
-     *   display  — **純展示**:不渲染 Radix Root / 任何 radio 視覺,僅 child item 中
-     *              value === group.value 那筆把 label 渲染為純文字 span;其他 item render null。
+     *   view     — **純展示**:不渲染 Radix Root / 任何 radio 視覺;RadioGroup 本體 walk
+     *              children,僅 control.value === group.value 那筆把 label 渲染為純文字 span。
      *              對齊 Carbon read-only / DataTable single-select cell read mode。
-     *   readonly — 同 child item 各自 readOnly:radio 視覺保留 + 鎖互動
+     *   readonly — standalone:ReadonlyContext 傳 items 鎖互動保留視覺;Field 內:灰框 + 選中項 label(不渲染 radio 群組)
      *   disabled — 同 RadioGroupPrimitive.Root disabled 屬性
      */
     mode?: FieldMode;
@@ -24,7 +26,7 @@ declare const radioItemVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type RadioItemPrimitiveProps = React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item>;
-export interface RadioGroupItemProps extends RadioItemPrimitiveProps, VariantProps<typeof radioItemVariants> {
+export interface RadioGroupItemProps extends Omit<RadioItemPrimitiveProps, 'asChild' | 'children'>, VariantProps<typeof radioItemVariants> {
     /**
      * Inline label。提供時 RadioGroupItem 自動透過 SelectionItem 包裝，
      * 套用 codified 樣式（text-body / text-foreground / disabled 色）。
@@ -37,6 +39,10 @@ export interface RadioGroupItemProps extends RadioItemPrimitiveProps, VariantPro
      * 套用 text-body / text-fg-secondary 樣式。
      */
     description?: React.ReactNode;
+    /** 可選左側 icon(label 前)— 2026-06-12 M30 修:轉發 SelectionItem 既有 canonical 槽(selection-item.tsx jsDoc SSOT;與 avatar 互斥)*/
+    icon?: LucideIcon;
+    /** 可選左側 avatar(label 前)— 同上 */
+    avatar?: AvatarData;
     /**
      * readonly 模式：鎖定互動但維持 checked/unchecked 視覺正確。
      * 通常整個 RadioGroup 一起設 readonly（由 parent RadioGroup 的 disabled
@@ -47,26 +53,26 @@ export interface RadioGroupItemProps extends RadioItemPrimitiveProps, VariantPro
 declare const RadioGroupItem: React.ForwardRefExoticComponent<RadioGroupItemProps & React.RefAttributes<HTMLButtonElement>>;
 export declare const radioGroupMeta: {
     readonly component: "RadioGroup";
-    readonly family: 4;
+    readonly family: null;
     readonly variants: {};
     readonly sizes: {
         readonly sm: {
             readonly fieldHeight: 28;
-            readonly iconSize: 16;
+            readonly iconSize: 8;
             readonly typography: "body";
         };
         readonly md: {
             readonly fieldHeight: 32;
-            readonly iconSize: 16;
+            readonly iconSize: 8;
             readonly typography: "body";
         };
         readonly lg: {
-            readonly fieldHeight: 40;
-            readonly iconSize: 20;
-            readonly typography: "body";
+            readonly fieldHeight: 36;
+            readonly iconSize: 10;
+            readonly typography: "body-lg";
         };
     };
-    readonly states: readonly ["default", "hover", "active", "focus-visible", "disabled"];
+    readonly states: readonly ["default", "hover", "checked", "focus-visible", "disabled"];
     readonly tokens: {
         readonly bg: readonly ["bg-disabled", "bg-surface"];
         readonly fg: readonly ["text-fg-disabled", "text-fg-secondary", "text-foreground", "text-primary"];

package/dist/components/RadioGroup/radio-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../../src/components/RadioGroup/radio-group.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,mBAAmB,MAAM,6BAA6B,CAAA;AAElE,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAGjE,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAA;AAoB3F,MAAM,WAAW,eACf,SAAQ,KAAK,CAAC,wBAAwB,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC;IACvE;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAED,QAAA,MAAM,UAAU,wFAyCd,CAAA;AAUF,QAAA,MAAM,iBAAiB;;8EA2BtB,CAAA;AAOD,KAAK,uBAAuB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAA;AAE9F,MAAM,WAAW,mBACf,SAAQ,uBAAuB,EAC7B,YAAY,CAAC,OAAO,iBAAiB,CAAC;IACxC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAID,QAAA,MAAM,cAAc,+FA6EnB,CAAA;AAKD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBjB,CAAA;AAEV,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../../src/components/RadioGroup/radio-group.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,mBAAmB,MAAM,6BAA6B,CAAA;AAElE,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAGjE,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAA;AAG3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAA;AAc1E,MAAM,WAAW,eAIf,SAAQ,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IACxF;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAkCD,QAAA,MAAM,UAAU,wFAmId,CAAA;AAWF,QAAA,MAAM,iBAAiB;;8EA2BtB,CAAA;AAOD,KAAK,uBAAuB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAA;AAE9F,MAAM,WAAW,mBAGf,SAAQ,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,UAAU,CAAC,EAC3D,YAAY,CAAC,OAAO,iBAAiB,CAAC;IACxC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,qHAAqH;IACrH,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAID,QAAA,MAAM,cAAc,+FA6FnB,CAAA;AAKD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBjB,CAAA;AAEV,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/components/RadioGroup/radio-group.js

@@ -4,40 +4,116 @@ import * as RadioGroupPrimitive from "@radix-ui/react-radio-group";
 import { Circle } from "lucide-react";
 import { cva } from "class-variance-authority";
 import { cn } from "../../lib/utils.js";
-import { useFieldContext } from "../Field/field-context.js";
+import { useResolvedFieldMode, useFieldEmptyDisplay, useFieldContext, useResolvedFieldSize, fieldEmptyColorClass, useResolvedFieldDisabled } from "../Field/field-context.js";
 import { SelectionItem } from "../SelectionControl/selection-item.js";
-import { EMPTY_DISPLAY } from "../Field/field-wrapper.js";
-const RadioGroupDisplayContext = React.createContext(null);
-const RadioGroup = React.forwardRef(({ className, mode, variant: _chrome, value, defaultValue, ...props }, ref) => {
-  if (mode === "display") {
-    const selectedValue = value ?? defaultValue;
+import { fieldWrapperStyles } from "../Field/field-wrapper.js";
+import { useControllable } from "../../hooks/use-controllable.js";
+const RadioGroupReadonlyContext = React.createContext(false);
+const RadioGroupDisabledContext = React.createContext(false);
+function findSelectedRadioLabel(children, selectedValue) {
+  let selectedLabel = null;
+  React.Children.forEach(children, (child) => {
+    if (!React.isValidElement(child)) return;
+    const cProps = child.props;
+    if (cProps.value === selectedValue && cProps.value !== void 0) {
+      selectedLabel = cProps.label ?? selectedValue;
+      return;
+    }
+    const control = cProps.control;
+    if (React.isValidElement(control)) {
+      const controlValue = control.props.value;
+      if (controlValue === selectedValue) {
+        selectedLabel = cProps.label ?? selectedValue;
+      }
+    }
+  });
+  return selectedLabel;
+}
+const RadioGroup = React.forwardRef(({ className, mode, variant: _chrome, value, defaultValue, onValueChange, children, ...props }, ref) => {
+  const resolvedMode = useResolvedFieldMode({ mode, disabled: props.disabled });
+  const emptyDisplay = useFieldEmptyDisplay();
+  const fieldCtx = useFieldContext();
+  const resolvedBoxSize = useResolvedFieldSize(void 0, "md");
+  const isControlled = value !== void 0;
+  const [resolvedValue, setResolvedValue] = useControllable({
+    value: value === null ? "" : value,
+    defaultValue: defaultValue ?? "",
+    onChange: onValueChange
+  });
+  const innerRef = React.useRef(null);
+  React.useEffect(() => {
+    var _a;
+    if (isControlled) return;
+    const form = (_a = innerRef.current) == null ? void 0 : _a.closest("form");
+    if (!form) return;
+    const handleReset = () => setResolvedValue(defaultValue ?? "");
+    form.addEventListener("reset", handleReset);
+    return () => form.removeEventListener("reset", handleReset);
+  }, [defaultValue, isControlled, resolvedMode, setResolvedValue]);
+  const setRef = React.useCallback((element) => {
+    innerRef.current = element;
+    if (typeof ref === "function") ref(element);
+    else if (ref) ref.current = element;
+  }, [ref]);
+  const {
+    onValueChange: _onValueChange,
+    disabled: _disabled,
+    required: _required,
+    name: _name,
+    orientation: _orientation,
+    dir: _dir,
+    loop: _loop,
+    asChild: _asChild,
+    ...restDomProps
+  } = props;
+  if (resolvedMode === "view") {
+    const selectedValue = resolvedValue || void 0;
     if (!selectedValue) {
-      return /* @__PURE__ */ jsx("div", { role: "group", className: cn("grid", className), children: /* @__PURE__ */ jsx("span", { className: "text-fg-muted", children: EMPTY_DISPLAY }) });
+      return /* @__PURE__ */ jsx("div", { ...restDomProps, ref: setRef, role: "group", className: cn("grid", className), children: /* @__PURE__ */ jsx("span", { className: fieldEmptyColorClass(resolvedMode), children: emptyDisplay }) });
     }
-    let selectedLabel = null;
-    React.Children.forEach(props.children, (child) => {
-      if (!React.isValidElement(child)) return;
-      const cProps = child.props;
-      const control = cProps.control;
-      if (React.isValidElement(control)) {
-        const controlValue = control.props.value;
-        if (controlValue === selectedValue) {
-          selectedLabel = cProps.label ?? selectedValue;
-        }
+    const selectedLabel = findSelectedRadioLabel(children, selectedValue);
+    return /* @__PURE__ */ jsx("div", { ...restDomProps, ref: setRef, role: "group", className: cn("grid", className), children: /* @__PURE__ */ jsx("span", { className: "text-foreground", children: selectedLabel ?? selectedValue }) });
+  }
+  if (resolvedMode === "readonly" && (fieldCtx == null ? void 0 : fieldCtx.hasFieldWrapper) === true) {
+    const selectedValue = resolvedValue || void 0;
+    const selectedLabel = selectedValue ? findSelectedRadioLabel(children, selectedValue) : null;
+    const boxSize = resolvedBoxSize;
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ...restDomProps,
+        ref: setRef,
+        role: "radiogroup",
+        "aria-readonly": "true",
+        "aria-labelledby": fieldCtx == null ? void 0 : fieldCtx.labelId,
+        "aria-invalid": (fieldCtx == null ? void 0 : fieldCtx.invalid) || void 0,
+        "data-readonly": "true",
+        tabIndex: 0,
+        className: cn(
+          fieldWrapperStyles({ size: boxSize, mode: "readonly", variant: "default" }),
+          "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+          className
+        ),
+        children: selectedValue ? /* @__PURE__ */ jsx("span", { className: "text-foreground", children: selectedLabel ?? selectedValue }) : /* @__PURE__ */ jsx("span", { className: fieldEmptyColorClass(resolvedMode), children: emptyDisplay })
       }
-    });
-    return /* @__PURE__ */ jsx("div", { role: "group", className: cn("grid", className), children: /* @__PURE__ */ jsx("span", { className: "text-foreground", children: selectedLabel ?? selectedValue }) });
+    );
   }
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx(RadioGroupReadonlyContext.Provider, { value: resolvedMode === "readonly", children: /* @__PURE__ */ jsx(RadioGroupDisabledContext.Provider, { value: resolvedMode === "disabled", children: /* @__PURE__ */ jsx(
     RadioGroupPrimitive.Root,
     {
       className: cn("grid", className),
-      value,
-      defaultValue,
+      value: resolvedValue,
+      onValueChange: setResolvedValue,
+      "aria-labelledby": fieldCtx == null ? void 0 : fieldCtx.labelId,
+      "aria-invalid": (fieldCtx == null ? void 0 : fieldCtx.invalid) || void 0,
+      "aria-describedby": fieldCtx == null ? void 0 : fieldCtx.descriptionId,
+      "aria-readonly": resolvedMode === "readonly" || void 0,
       ...props,
-      ref
+      disabled: resolvedMode === "disabled",
+      ref: setRef,
+      children
     }
-  );
+  ) }) });
 });
 RadioGroup.displayName = "RadioGroup";
 RadioGroup.fieldLayout = "block";
@@ -75,6 +151,8 @@ const RadioGroupItem = React.forwardRef(
     className,
     size,
     label,
+    icon,
+    avatar,
     description,
     readOnly = false,
     disabled,
@@ -83,12 +161,10 @@ const RadioGroupItem = React.forwardRef(
   }, ref) => {
     const sizeKey = size ?? "md";
     const dotPx = dotSize[sizeKey];
-    const displayCtx = React.useContext(RadioGroupDisplayContext);
-    if (displayCtx == null ? void 0 : displayCtx.displayMode) {
-      if (displayCtx.selectedValue !== props.value) return null;
-      return /* @__PURE__ */ jsx("span", { className: "text-foreground", children: label ?? props.value });
-    }
-    const fieldCtx = useFieldContext();
+    const groupDisabled = React.useContext(RadioGroupDisabledContext);
+    const resolvedDisabled = useResolvedFieldDisabled(disabled) || groupDisabled;
+    const groupReadonly = React.useContext(RadioGroupReadonlyContext);
+    const effectiveReadonly = readOnly || groupReadonly;
     const generatedId = React.useId();
     const inputId = idProp ?? generatedId;
     const rootEl = /* @__PURE__ */ jsx(
@@ -96,12 +172,19 @@ const RadioGroupItem = React.forwardRef(
       {
         id: inputId,
         ref,
-        disabled,
-        "aria-readonly": readOnly || void 0,
-        "data-readonly": readOnly || void 0,
-        tabIndex: readOnly ? -1 : void 0,
+        disabled: resolvedDisabled,
+        "data-readonly": effectiveReadonly || void 0,
+        tabIndex: effectiveReadonly ? -1 : void 0,
         className: cn(radioItemVariants({ size }), className),
         ...props,
+        onClick: (event) => {
+          var _a;
+          if (effectiveReadonly) {
+            event.preventDefault();
+            return;
+          }
+          (_a = props.onClick) == null ? void 0 : _a.call(props, event);
+        },
         children: /* @__PURE__ */ jsx(RadioGroupPrimitive.Indicator, { className: "grid place-content-center", children: /* @__PURE__ */ jsx(
           Circle,
           {
@@ -112,13 +195,14 @@ const RadioGroupItem = React.forwardRef(
       }
     );
     if (label == null) return rootEl;
-    const resolvedDisabled = disabled ?? (fieldCtx == null ? void 0 : fieldCtx.disabled) ?? false;
     return /* @__PURE__ */ jsx(
       SelectionItem,
       {
         control: rootEl,
         label,
         description,
+        icon,
+        avatar,
         htmlFor: inputId,
         disabled: resolvedDisabled,
         size: sizeKey
@@ -129,14 +213,21 @@ const RadioGroupItem = React.forwardRef(
 RadioGroupItem.displayName = "RadioGroupItem";
 const radioGroupMeta = {
   component: "RadioGroup",
-  family: 4,
+  family: null,
+  // self-contained primitive(對齊 spec frontmatter self-contained + body L31;非 Family 4 — field-controls.spec.md 成員名單不含 RadioGroup)
   variants: {},
   sizes: {
-    sm: { fieldHeight: 28, iconSize: 16, typography: "body" },
-    md: { fieldHeight: 32, iconSize: 16, typography: "body" },
-    lg: { fieldHeight: 40, iconSize: 20, typography: "body" }
+    // iconSize = 渲染指示器尺寸(對齊 checkbox/switch meta 慣例:checkbox iconSize=真 Check glyph 12/12/16)。
+    // Radio 指示器是 filled dot 非 glyph,真值 = 上方 `const dotSize` map 8/8/10;
+    // 控件框 16/16/20 與 Checkbox 對齊但那是 box 非「指示器」,不入此鍵(避免 metadata 語意 drift)。
+    sm: { fieldHeight: 28, iconSize: 8, typography: "body" },
+    md: { fieldHeight: 32, iconSize: 8, typography: "body" },
+    lg: { fieldHeight: 36, iconSize: 10, typography: "body-lg" }
   },
-  states: ["default", "hover", "active", "focus-visible", "disabled"],
+  // 2026-07-04 修 stale meta:移除 'active' — radioItemVariants cva 無 active-state 樣式,
+  // Radix radio 也無 data-state=active(對照 checkboxMeta 正確不含 active)
+  // 'checked' = 選定持續態(card 式 = border+text primary;2026-07-07 meta 詞彙統一補列)
+  states: ["default", "hover", "checked", "focus-visible", "disabled"],
   tokens: {
     bg: ["bg-disabled", "bg-surface"],
     fg: ["text-fg-disabled", "text-fg-secondary", "text-foreground", "text-primary"],

package/dist/components/RadioGroup/radio-group.js.map

@@ -1 +1 @@
-{"version":3,"file":"radio-group.js","sources":["../../../src/components/RadioGroup/radio-group.tsx"],"sourcesContent":["// @benchmark-unverified-blanket: file-level retraction per M22 (d) — claims herein not individually URL-cited; treat as unverified visual/usage rumor unless retrofit per-claim. Hook escape preserved.\nimport * as React from \"react\"\nimport * as RadioGroupPrimitive from \"@radix-ui/react-radio-group\"\nimport { Circle } from \"lucide-react\"\nimport { cva, type VariantProps } from \"class-variance-authority\"\n\nimport { cn } from \"@/lib/utils\"\nimport type { FieldMode, FieldVariant } from \"@/design-system/components/Field/field-types\"\nimport { useFieldContext } from \"@/design-system/components/Field/field-context\"\nimport { SelectionItem } from \"@/design-system/components/SelectionControl/selection-item\"\nimport { EMPTY_DISPLAY } from \"@/design-system/components/Field/field-wrapper\"\n\n// ── RadioGroup display context ──────────────────────────────────────────────\n// RadioGroup mode='display' 時:Group 不渲染 Radix primitive(無 radio 視覺),\n// 改透過 Context 通知 child RadioGroupItem「我在 display mode、selected value 是 X」;\n// item 自決 — 命中 selected 渲染 label 純文字,未命中 render null。\n// 為什麼用 context(不是 RadioGroup 自己解析 children):children 可能是任意巢狀\n// (Field 包 RadioGroup,內含 RadioGroupItem 散在 fragment / 條件式內),強行 walk children\n// 會破壞 React composability;用 context 讓 item 自己判定是 idiom 對齊 Radix 原生模型。\ninterface RadioGroupDisplayContextValue {\n  displayMode: true\n  selectedValue?: string\n}\nconst RadioGroupDisplayContext = React.createContext<RadioGroupDisplayContextValue | null>(null)\n\n// ── RadioGroup ──────────────────────────────────────────────────────────────\n\nexport interface RadioGroupProps\n  extends React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root> {\n  /**\n   * Field mode(2026-05-05 Phase B3 align):\n   *   edit     — 一般可互動 RadioGroup(預設)\n   *   display  — **純展示**:不渲染 Radix Root / 任何 radio 視覺,僅 child item 中\n   *              value === group.value 那筆把 label 渲染為純文字 span;其他 item render null。\n   *              對齊 Carbon read-only / DataTable single-select cell read mode。\n   *   readonly — 同 child item 各自 readOnly:radio 視覺保留 + 鎖互動\n   *   disabled — 同 RadioGroupPrimitive.Root disabled 屬性\n   */\n  mode?: FieldMode\n  /**\n   * Visual chrome — RadioGroup 本體無 input wrapper variant,本 prop 對主體無視覺影響;\n   * 為對齊 Field 4-mode + chrome 透傳契約而保留(M19 一致性)。\n   */\n  variant?: FieldVariant\n}\n\nconst RadioGroup = React.forwardRef<\n  React.ElementRef<typeof RadioGroupPrimitive.Root>,\n  RadioGroupProps\n>(({ className, mode, variant: _chrome, value, defaultValue, ...props }, ref) => {\n  // mode='display' — 純展示 selected option 的 label,不渲染任何 radio control 視覺。\n  // 對齊 Carbon read-only single-select(只顯示 selected 內容)+ Airtable / Notion read-only。\n  // 實作:walk children 找 control.value === selectedValue 的 SelectionItem,render label plain text。\n  // (不用 context dispatch 給 RadioGroupItem — SelectionItem layout wrapper 仍會渲染所有 item label)\n  if (mode === 'display') {\n    const selectedValue = (value ?? defaultValue) as string | undefined\n    if (!selectedValue) {\n      return <div role=\"group\" className={cn('grid', className)}><span className=\"text-fg-muted\">{EMPTY_DISPLAY}</span></div>\n    }\n    let selectedLabel: React.ReactNode = null\n    React.Children.forEach(props.children, (child) => {\n      if (!React.isValidElement(child)) return\n      const cProps = child.props as { control?: unknown; label?: React.ReactNode }\n      const control = cProps.control\n      if (React.isValidElement(control)) {\n        const controlValue = (control.props as { value?: unknown }).value\n        if (controlValue === selectedValue) {\n          selectedLabel = cProps.label ?? selectedValue\n        }\n      }\n    })\n    return (\n      <div role=\"group\" className={cn('grid', className)}>\n        <span className=\"text-foreground\">{selectedLabel ?? selectedValue}</span>\n      </div>\n    )\n  }\n\n  return (\n    <RadioGroupPrimitive.Root\n      className={cn(\"grid\", className)}\n      value={value}\n      defaultValue={defaultValue}\n      {...props}\n      ref={ref}\n    />\n  )\n})\nRadioGroup.displayName = 'RadioGroup'\n// Field layout 宣告：RadioGroup 是 block primitive（多項堆疊），\n// 進入 <Field> 時 control area 自動切 items-start + padding-top 公式對齊。\n// Convention 詳見 components/Field/field.spec.md「Control area:Inline vs Block」段落。\n;(RadioGroup as unknown as { fieldLayout: 'block' }).fieldLayout = 'block'\n\n// ── RadioGroupItem Variants ─────────────────────────────────────────────────\n// 與 Checkbox 完全對齊：sm/md=16px, lg=20px。差異只有形狀（rounded-full）和指示器（filled dot）。\n\nconst radioItemVariants = cva(\n  [\n    'grid place-content-center shrink-0 rounded-full',\n    'border border-border bg-surface',\n    'transition-colors duration-150',\n    'hover:border-border-hover',\n    'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1',\n    'data-[state=checked]:border-primary data-[state=checked]:text-primary',\n    'data-[state=checked]:hover:border-primary-hover data-[state=checked]:hover:text-primary-hover',\n    'disabled:cursor-not-allowed disabled:bg-disabled disabled:border-transparent disabled:hover:border-transparent',\n    'disabled:data-[state=checked]:bg-disabled disabled:data-[state=checked]:border-transparent disabled:data-[state=checked]:text-fg-disabled',\n    // readOnly：鎖定互動但維持 checked/unchecked 視覺\n    'data-[readonly=true]:pointer-events-none data-[readonly=true]:cursor-default',\n    'data-[readonly=true]:hover:border-border',\n  ],\n  {\n    variants: {\n      size: {\n        sm: 'h-4 w-4',\n        md: 'h-4 w-4',\n        lg: 'h-5 w-5',\n      },\n    },\n    defaultVariants: {\n      size: 'md',\n    },\n  }\n)\n\n// ── Dot Size ────────────────────────────────────────────────────────────────\nconst dotSize: Record<string, number> = { sm: 8, md: 8, lg: 10 }\n\n// ── Types ───────────────────────────────────────────────────────────────────\n\ntype RadioItemPrimitiveProps = React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item>\n\nexport interface RadioGroupItemProps\n  extends RadioItemPrimitiveProps,\n    VariantProps<typeof radioItemVariants> {\n  /**\n   * Inline label。提供時 RadioGroupItem 自動透過 SelectionItem 包裝，\n   * 套用 codified 樣式（text-body / text-foreground / disabled 色）。\n   * 在 <Field> context 內時此 prop 仍然生效（Radio 的 label 是每個 item\n   * 各自的，不是整組 Field 的；FieldLabel 是 RadioGroup 整體的 label）。\n   */\n  label?: React.ReactNode\n  /**\n   * Inline description（secondary 文字）。須與 label 搭配使用。\n   * 套用 text-body / text-fg-secondary 樣式。\n   */\n  description?: React.ReactNode\n  /**\n   * readonly 模式：鎖定互動但維持 checked/unchecked 視覺正確。\n   * 通常整個 RadioGroup 一起設 readonly（由 parent RadioGroup 的 disabled\n   * 或 readonly 行為決定），個別 item 也可設。\n   */\n  readOnly?: boolean\n}\n\n// ── RadioGroupItem ──────────────────────────────────────────────────────────\n\nconst RadioGroupItem = React.forwardRef<\n  React.ElementRef<typeof RadioGroupPrimitive.Item>,\n  RadioGroupItemProps\n>(\n  (\n    {\n      className,\n      size,\n      label,\n      description,\n      readOnly = false,\n      disabled,\n      id: idProp,\n      ...props\n    },\n    ref\n  ) => {\n    const sizeKey = size ?? 'md'\n    const dotPx = dotSize[sizeKey]\n\n    // ── RadioGroup mode='display' branch ──────────────────────────────────\n    // 命中 selected → 渲染 label 純文字 span;未命中 → render null(group 內只剩 selected 的 label)。\n    // 設計理由:對齊 Carbon read-only single-select 「只顯示 selected 內容、不列其他選項」原則。\n    const displayCtx = React.useContext(RadioGroupDisplayContext)\n    if (displayCtx?.displayMode) {\n      if (displayCtx.selectedValue !== props.value) return null\n      return <span className=\"text-foreground\">{label ?? props.value}</span>\n    }\n\n    // 注意：Radio 的 label 語意與 Checkbox/Switch 不同——\n    // Checkbox/Switch 的 label 就是該 control 的唯一 label（被 Field context 接管），\n    // RadioGroupItem 的 label 是「該選項」的 label（每 item 各自擁有），\n    // FieldLabel 則是整個 RadioGroup 的 label。\n    // 因此 RadioGroupItem 的 label 不因 Field context 被忽略。\n    const fieldCtx = useFieldContext()\n\n    const generatedId = React.useId()\n    const inputId = idProp ?? generatedId\n\n    const rootEl = (\n      <RadioGroupPrimitive.Item\n        id={inputId}\n        ref={ref}\n        disabled={disabled}\n        aria-readonly={readOnly || undefined}\n        data-readonly={readOnly || undefined}\n        tabIndex={readOnly ? -1 : undefined}\n        className={cn(radioItemVariants({ size }), className)}\n        {...props}\n      >\n        <RadioGroupPrimitive.Indicator className=\"grid place-content-center\">\n          <Circle\n            style={{ width: dotPx, height: dotPx }}\n            className=\"fill-current text-current\"\n          />\n        </RadioGroupPrimitive.Indicator>\n      </RadioGroupPrimitive.Item>\n    )\n\n    // 無 label → 只渲染 radio 本體\n    if (label == null) return rootEl\n\n    // 有 label → 透過 SelectionItem 包裝，與 Checkbox 一致\n    // 同時繼承 Field context 的 disabled（若 RadioGroup 在 Field disabled 內）\n    const resolvedDisabled = disabled ?? fieldCtx?.disabled ?? false\n\n    return (\n      <SelectionItem\n        control={rootEl}\n        label={label}\n        description={description}\n        htmlFor={inputId}\n        disabled={resolvedDisabled}\n        size={sizeKey}\n      />\n    )\n  }\n)\nRadioGroupItem.displayName = 'RadioGroupItem'\n\n// Story auto-compile metadata — Phase 1 mechanical migration(2026-04-24)\n// Phase 2 fill needed: purpose descriptions + when rationale + world-class refs\nexport const radioGroupMeta = {\n  component: 'RadioGroup',\n  family: 4,\n  variants: {\n\n  },\n  sizes: {\n    sm: { fieldHeight: 28, iconSize: 16, typography: 'body' },\n    md: { fieldHeight: 32, iconSize: 16, typography: 'body' },\n    lg: { fieldHeight: 40, iconSize: 20, typography: 'body' },\n  },\n  states: ['default', 'hover', 'active', 'focus-visible', 'disabled'],\n  tokens: {\n    bg: ['bg-disabled', 'bg-surface'],\n    fg: ['text-fg-disabled', 'text-fg-secondary', 'text-foreground', 'text-primary'],\n    ring: ['ring-ring'],\n  },\n  defaultSize: 'md',\n} as const\n\nexport { RadioGroup, RadioGroupItem, radioItemVariants }\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"radio-group.js","sources":["../../../src/components/RadioGroup/radio-group.tsx"],"sourcesContent":["// @benchmark-unverified-blanket: file-level retraction per M22 (d) — claims herein not individually URL-cited; treat as unverified visual/usage rumor unless retrofit per-claim. Hook escape preserved.\nimport * as React from \"react\"\nimport * as RadioGroupPrimitive from \"@radix-ui/react-radio-group\"\nimport { Circle } from \"lucide-react\"\nimport { cva, type VariantProps } from \"class-variance-authority\"\n\nimport { cn } from \"@/lib/utils\"\nimport type { FieldMode, FieldVariant } from \"@/design-system/components/Field/field-types\"\nimport { useFieldContext, useResolvedFieldMode, useResolvedFieldDisabled, useResolvedFieldSize } from \"@/design-system/components/Field/field-context\"\nimport { SelectionItem } from \"@/design-system/components/SelectionControl/selection-item\"\nimport type { LucideIcon } from \"lucide-react\"\nimport type { AvatarData } from \"@/design-system/components/Avatar/avatar\"\nimport { fieldWrapperStyles } from \"@/design-system/components/Field/field-wrapper\"\nimport { useFieldEmptyDisplay, fieldEmptyColorClass } from '@/design-system/components/Field/field-context'\nimport { useControllable } from '@/design-system/hooks/use-controllable'\n\n// ── RadioGroup view mode ────────────────────────────────────────────────────\n// RadioGroup mode='view' 時:Group 不渲染 Radix primitive(無 radio 視覺),\n// 改由 RadioGroup 本體 walk props.children,找 control.value === selectedValue 的\n// SelectionItem,把它的 label 渲染為單一純文字 span(其他選項不顯示)。\n// 對齊 Carbon read-only single-select(只顯示 selected 內容)+ Airtable / Notion read-only。\n// 實作在 RadioGroup forwardRef 內(見下方 mode === 'view' 分支)。\n\n// ── RadioGroup ──────────────────────────────────────────────────────────────\n\nexport interface RadioGroupProps\n  // asChild Omit(2026-07-18 決策2):RadioGroup 恆持有多個 radio item → <Root asChild> 的\n  // Radix Slot React.Children.only crash;view/readonly 模式更直接渲染固定 <div> 忽略之。\n  // children 保留(edit 容器內容 + view/readonly 走訪選中 label,見 body cast @line ~105)。\n  extends Omit<React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root>, 'asChild'> {\n  /**\n   * Field mode(2026-05-05 Phase B3 align):\n   *   edit     — 一般可互動 RadioGroup(預設)\n   *   view     — **純展示**:不渲染 Radix Root / 任何 radio 視覺;RadioGroup 本體 walk\n   *              children,僅 control.value === group.value 那筆把 label 渲染為純文字 span。\n   *              對齊 Carbon read-only / DataTable single-select cell read mode。\n   *   readonly — standalone:ReadonlyContext 傳 items 鎖互動保留視覺;Field 內:灰框 + 選中項 label(不渲染 radio 群組)\n   *   disabled — 同 RadioGroupPrimitive.Root disabled 屬性\n   */\n  mode?: FieldMode\n  /**\n   * Visual chrome — RadioGroup 本體無 input wrapper variant,本 prop 對主體無視覺影響;\n   * 為對齊 Field 4-mode + chrome 透傳契約而保留(M19 一致性)。\n   */\n  variant?: FieldVariant\n}\n\n// RadioGroup mode='readonly' → 透過 context 把 readOnly 傳給所有 child RadioGroupItem\n// (item 已支援 readOnly prop + data-[readonly] 樣式;Radix Root 無 readOnly,故用 context)。\nconst RadioGroupReadonlyContext = React.createContext(false)\n\n// group-level disabled(standalone <RadioGroup disabled>)→ context 傳給 items,讓 SelectionItem\n// label/description 也降 text-fg-disabled(Radix Root disabled 只 propagate 給 radio 圈、不碰 label 色)。\n// 對齊本檔 RadioGroupReadonlyContext 既有模式 + spec「Disabled」邊界案例(Group-level disabled 視覺繼承 SelectionItem SSOT text-fg-disabled)。\nconst RadioGroupDisabledContext = React.createContext(false)\n\n// walk children 找 control.value === selectedValue 的 SelectionItem label(view / readonly-in-Field 共用)\nfunction findSelectedRadioLabel(children: React.ReactNode, selectedValue: string | undefined): React.ReactNode {\n  let selectedLabel: React.ReactNode = null\n  React.Children.forEach(children, (child) => {\n    if (!React.isValidElement(child)) return\n    const cProps = child.props as { control?: unknown; label?: React.ReactNode; value?: unknown }\n    // 形狀 1:<RadioGroupItem value label>(主用法)— value/label 直掛 props\n    if (cProps.value === selectedValue && cProps.value !== undefined) {\n      selectedLabel = cProps.label ?? selectedValue\n      return\n    }\n    // 形狀 2:<SelectionItem control={<RadioGroupItem value/>} label>(組合用法)\n    const control = cProps.control\n    if (React.isValidElement(control)) {\n      const controlValue = (control.props as { value?: unknown }).value\n      if (controlValue === selectedValue) {\n        selectedLabel = cProps.label ?? selectedValue\n      }\n    }\n  })\n  return selectedLabel\n}\n\nconst RadioGroup = React.forwardRef<\n  React.ElementRef<typeof RadioGroupPrimitive.Root>,\n  RadioGroupProps\n>(({ className, mode, variant: _chrome, value, defaultValue, onValueChange, children, ...props }, ref) => {\n  // 2026-06-08 SSOT cascade:resolvedMode 經 resolver hook 讀 fieldCtx(原 root 完全不讀 → <Field disabled>/<Field mode> 失效)\n  const resolvedMode = useResolvedFieldMode({ mode, disabled: (props as { disabled?: boolean }).disabled })\n  const emptyDisplay = useFieldEmptyDisplay()\n  const fieldCtx = useFieldContext()\n  // readonly 灰框 size:走 SSOT resolver(RadioGroup 無 size prop → ctx > 'md')\n  const resolvedBoxSize = useResolvedFieldSize(undefined, 'md') as 'sm' | 'md' | 'lg'\n\n  // Wrapper 持有 value 的單一 resolved state，讓 uncontrolled edit 內的選擇在切換\n  // view / readonly 時仍可讀取；否則值只住在 Radix Root，非 edit 分支會退回 defaultValue。\n  // Radix 一律收到 controlled value，避免 mode remount 後重建另一份 internal state。\n  const isControlled = value !== undefined\n  const [resolvedValue, setResolvedValue] = useControllable<string>({\n    value: value === null ? '' : value,\n    defaultValue: defaultValue ?? '',\n    onChange: onValueChange,\n  })\n\n  // form.reset() 不會觸發 Radix onValueChange；uncontrolled wrapper 取得狀態所有權後，\n  // 需把 resolved value 明確歸回 defaultValue。resolvedMode 進 deps，切回 edit 時會\n  // 重新綁定目前 Root 所在的 form；view/readonly 分支仍在同一 form 時也能保持 reset 語意。\n  const innerRef = React.useRef<HTMLDivElement | null>(null)\n  React.useEffect(() => {\n    if (isControlled) return\n    const form = innerRef.current?.closest('form')\n    if (!form) return\n    const handleReset = () => setResolvedValue(defaultValue ?? '')\n    form.addEventListener('reset', handleReset)\n    return () => form.removeEventListener('reset', handleReset)\n  }, [defaultValue, isControlled, resolvedMode, setResolvedValue])\n  const setRef = React.useCallback((element: HTMLDivElement | null) => {\n    innerRef.current = element\n    if (typeof ref === 'function') ref(element)\n    else if (ref) (ref as React.MutableRefObject<HTMLDivElement | null>).current = element\n  }, [ref])\n  // mode='view' — 純展示 selected option 的 label,不渲染任何 radio control 視覺。\n  // 對齊 Carbon read-only single-select(只顯示 selected 內容)+ Airtable / Notion read-only。\n  // 實作:walk children 找 control.value === selectedValue 的 SelectionItem,render label plain text。\n  // (不用 context dispatch 給 RadioGroupItem — SelectionItem layout wrapper 仍會渲染所有 item label)\n  // 2026-07-04 修:view / readonly-in-Field 分支的 <div> 原丟棄剩餘 props(id/data-*/aria-*)\n  // 且不轉發 forwardRef ref → 自家 radio-group.stories.tsx view demo 傳的 aria-label 都靜默失效。\n  // 抽出 Radix 專屬 non-DOM props,其餘 DOM props 於兩分支 spread 轉發(與 Checkbox/Switch 同修);\n  // edit 主路徑不受影響(Root 仍 spread 完整 props)。\n  const {\n    onValueChange: _onValueChange,\n    disabled: _disabled,\n    required: _required,\n    name: _name,\n    orientation: _orientation,\n    dir: _dir,\n    loop: _loop,\n    asChild: _asChild,\n    ...restDomProps\n  } = props as RadioGroupProps & { asChild?: boolean }\n\n  if (resolvedMode === 'view') {\n    const selectedValue = resolvedValue || undefined\n    if (!selectedValue) {\n      return <div {...restDomProps} ref={setRef} role=\"group\" className={cn('grid', className)}><span className={fieldEmptyColorClass(resolvedMode)}>{emptyDisplay}</span></div>\n    }\n    const selectedLabel = findSelectedRadioLabel(children, selectedValue)\n    return (\n      <div {...restDomProps} ref={setRef} role=\"group\" className={cn('grid', className)}>\n        <span className=\"text-foreground\">{selectedLabel ?? selectedValue}</span>\n      </div>\n    )\n  }\n\n  // ── mode='readonly' in Field(2026-06-12 user 拍板,與 Checkbox/Switch 灰框模型一致)──\n  // Field 內 readonly 單選 = fieldWrapperStyles readonly 灰框 + 選中項 label 文字\n  // (= Select readonly 同款呈現:同為「單選資料」,鎖定時呈現一致)。\n  // standalone readonly(無 Field)維持原樣鎖互動(ReadonlyContext 路徑)。\n  if (resolvedMode === 'readonly' && fieldCtx?.hasFieldWrapper === true) {\n    const selectedValue = resolvedValue || undefined\n    const selectedLabel = selectedValue ? findSelectedRadioLabel(children, selectedValue) : null\n    const boxSize = resolvedBoxSize\n    return (\n      <div\n        {...restDomProps}\n        ref={setRef}\n        role=\"radiogroup\"\n        aria-readonly=\"true\"\n        aria-labelledby={fieldCtx?.labelId}\n        aria-invalid={fieldCtx?.invalid || undefined}\n        data-readonly=\"true\"\n        tabIndex={0}\n        className={cn(\n          fieldWrapperStyles({ size: boxSize, mode: 'readonly', variant: 'default' }),\n          'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring',\n          className,\n        )}\n      >\n        {selectedValue\n          ? <span className=\"text-foreground\">{selectedLabel ?? selectedValue}</span>\n          : <span className={fieldEmptyColorClass(resolvedMode)}>{emptyDisplay}</span>}\n      </div>\n    )\n  }\n\n  // mode='disabled' → Radix Root disabled(原生 propagate 給所有 item);\n  // mode='readonly' → context 傳 readOnly 給 items(item 渲染為 data-[readonly] 鎖互動 + aria-readonly)。\n  return (\n    <RadioGroupReadonlyContext.Provider value={resolvedMode === 'readonly'}>\n      <RadioGroupDisabledContext.Provider value={resolvedMode === 'disabled'}>\n        <RadioGroupPrimitive.Root\n          className={cn(\"grid\", className)}\n          value={resolvedValue}\n          onValueChange={setResolvedValue}\n          // Field 內:role=\"radiogroup\" 的 <div> 無法被 <label for> 命名 → 自讀 fieldCtx 接\n          // aria-labelledby / aria-invalid / aria-describedby(field-context.ts「下游 control 需自讀\n          // labelId」;對齊 slider.tsx / Rating / TimePicker 的 fieldLabelId 接線 + 上方 readonly-in-Field 分支)。\n          // standalone(無 Field)時皆 undefined,consumer 的 {...props} aria-* 照舊生效(置於 spread 前故可被覆蓋)。\n          aria-labelledby={fieldCtx?.labelId}\n          aria-invalid={fieldCtx?.invalid || undefined}\n          aria-describedby={fieldCtx?.descriptionId}\n          // a11y(2026-07-14 dim-10):readonly 語意放 radiogroup(aria-readonly 合法 role;\n          // 對齊上方 readonly-in-Field 分支 L133)。item(role=radio)不帶 aria-readonly —\n          // axe 實證 radio 不允許該屬性,item 靠 data-readonly + tabIndex + click guard 鎖互動。\n          aria-readonly={resolvedMode === 'readonly' || undefined}\n          {...props}\n          disabled={resolvedMode === 'disabled'}\n          ref={setRef}\n        >\n          {children}\n        </RadioGroupPrimitive.Root>\n      </RadioGroupDisabledContext.Provider>\n    </RadioGroupReadonlyContext.Provider>\n  )\n})\nRadioGroup.displayName = 'RadioGroup'\n// Field layout 宣告：RadioGroup 是 block primitive（多項堆疊），\n// 進入 <Field> 時 control area 自動切 items-start（block 分支不設 min-h、不加 padding-top,\n// 高度由內容決定;額外加 paddingTop 會 double padding — field.tsx block control area SSOT）。\n// Convention 詳見 components/Field/field.spec.md「Control area:Inline vs Block」段落。\n;(RadioGroup as unknown as { fieldLayout: 'block' }).fieldLayout = 'block'\n\n// ── RadioGroupItem Variants ─────────────────────────────────────────────────\n// 與 Checkbox 完全對齊：sm/md=16px, lg=20px。差異只有形狀（rounded-full）和指示器（filled dot）。\n\nconst radioItemVariants = cva(\n  [\n    'grid place-content-center shrink-0 rounded-full',\n    'border border-border bg-surface',\n    'transition-colors duration-150',\n    'hover:border-border-hover',\n    'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1',\n    'data-[state=checked]:border-primary data-[state=checked]:text-primary',\n    'data-[state=checked]:hover:border-primary-hover data-[state=checked]:hover:text-primary-hover',\n    'disabled:cursor-not-allowed disabled:bg-disabled disabled:border-transparent disabled:hover:border-transparent',\n    'disabled:data-[state=checked]:bg-disabled disabled:data-[state=checked]:border-transparent disabled:data-[state=checked]:text-fg-disabled',\n    // readOnly：鎖定互動但維持 checked/unchecked 視覺\n    'data-[readonly=true]:pointer-events-none data-[readonly=true]:cursor-default',\n    'data-[readonly=true]:hover:border-border',\n  ],\n  {\n    variants: {\n      size: {\n        sm: 'h-4 w-4',\n        md: 'h-4 w-4',\n        lg: 'h-5 w-5',\n      },\n    },\n    defaultVariants: {\n      size: 'md',\n    },\n  }\n)\n\n// ── Dot Size ────────────────────────────────────────────────────────────────\nconst dotSize: Record<string, number> = { sm: 8, md: 8, lg: 10 }\n\n// ── Types ───────────────────────────────────────────────────────────────────\n\ntype RadioItemPrimitiveProps = React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item>\n\nexport interface RadioGroupItemProps\n  // asChild / children Omit(2026-07-18 決策2):item 固定渲染 Indicator dot(<Circle/>)—\n  // children 被固定 Indicator 靜默覆蓋,asChild 破壞 radio 結構。對齊 Checkbox 收窄。label 走 `label` prop。\n  extends Omit<RadioItemPrimitiveProps, 'asChild' | 'children'>,\n    VariantProps<typeof radioItemVariants> {\n  /**\n   * Inline label。提供時 RadioGroupItem 自動透過 SelectionItem 包裝，\n   * 套用 codified 樣式（text-body / text-foreground / disabled 色）。\n   * 在 <Field> context 內時此 prop 仍然生效（Radio 的 label 是每個 item\n   * 各自的，不是整組 Field 的；FieldLabel 是 RadioGroup 整體的 label）。\n   */\n  label?: React.ReactNode\n  /**\n   * Inline description（secondary 文字）。須與 label 搭配使用。\n   * 套用 text-body / text-fg-secondary 樣式。\n   */\n  description?: React.ReactNode\n  /** 可選左側 icon(label 前)— 2026-06-12 M30 修:轉發 SelectionItem 既有 canonical 槽(selection-item.tsx jsDoc SSOT;與 avatar 互斥)*/\n  icon?: LucideIcon\n  /** 可選左側 avatar(label 前)— 同上 */\n  avatar?: AvatarData\n  /**\n   * readonly 模式：鎖定互動但維持 checked/unchecked 視覺正確。\n   * 通常整個 RadioGroup 一起設 readonly（由 parent RadioGroup 的 disabled\n   * 或 readonly 行為決定），個別 item 也可設。\n   */\n  readOnly?: boolean\n}\n\n// ── RadioGroupItem ──────────────────────────────────────────────────────────\n\nconst RadioGroupItem = React.forwardRef<\n  React.ElementRef<typeof RadioGroupPrimitive.Item>,\n  RadioGroupItemProps\n>(\n  (\n    {\n      className,\n      size,\n      label,\n      icon,\n      avatar,\n      description,\n      readOnly = false,\n      disabled,\n      id: idProp,\n      ...props\n    },\n    ref\n  ) => {\n    const sizeKey = size ?? 'md'\n    const dotPx = dotSize[sizeKey]\n\n    // 注意:RadioGroup mode='view' 的純文字渲染由 RadioGroup 本體 walk-children 處理\n    // (見上方 RadioGroup forwardRef 的 mode === 'view' 分支),RadioGroupItem 在 view\n    // mode 下不會被獨立 render,故此處無 view 分支。\n\n    // 注意：Radio 的 label 語意與 Checkbox/Switch 不同——\n    // Checkbox/Switch 的 label 就是該 control 的唯一 label（被 Field context 接管），\n    // RadioGroupItem 的 label 是「該選項」的 label（每 item 各自擁有），\n    // FieldLabel 則是整個 RadioGroup 的 label。\n    // 因此 RadioGroupItem 的 label 不因 Field context 被忽略。\n    // group-level disabled(standalone <RadioGroup disabled>)也要降 label/description 色 —— Radix Root\n    // disabled 只 propagate 給 radio 圈,label 色由 SelectionItem disabled 決定,故讀 RadioGroupDisabledContext 補上。\n    const groupDisabled = React.useContext(RadioGroupDisabledContext)\n    const resolvedDisabled = useResolvedFieldDisabled(disabled) || groupDisabled\n    // group-level readonly(RadioGroup mode='readonly')或 item-level readOnly,任一 true 即鎖互動。\n    const groupReadonly = React.useContext(RadioGroupReadonlyContext)\n    const effectiveReadonly = readOnly || groupReadonly\n\n    const generatedId = React.useId()\n    const inputId = idProp ?? generatedId\n\n    const rootEl = (\n      <RadioGroupPrimitive.Item\n        id={inputId}\n        ref={ref}\n        disabled={resolvedDisabled}\n        // a11y(2026-07-14 dim-10):item(role=radio)不帶 aria-readonly — axe 實證 radio 不允許\n        // 該屬性(readonly 語意由 Root role=radiogroup 宣告,見上方 L167-170)。item 靠\n        // data-readonly + tabIndex + click guard 鎖互動。\n        data-readonly={effectiveReadonly || undefined}\n        tabIndex={effectiveReadonly ? -1 : undefined}\n        className={cn(radioItemVariants({ size }), className)}\n        {...props}\n        // 2026-07-05 D4 修:readOnly 鎖互動補 label 繞道 — <label htmlFor> 的 synthetic click\n        // 不是 pointer event,cva pointer-events-none 攔不到,點 label 文字仍選中。\n        // preventDefault 讓 Radix composeEventHandlers(checkForDefaultPrevented)跳過內部 onCheck;\n        // 必列在 {...props} 之後才不被 consumer onClick 覆蓋(與 Checkbox/Switch 同修)。\n        // 同時攔 Radix roving-focus 的 arrow-key onFocus → click() 路徑(同為 click event)。\n        onClick={(event) => {\n          if (effectiveReadonly) {\n            event.preventDefault()\n            return\n          }\n          props.onClick?.(event)\n        }}\n      >\n        <RadioGroupPrimitive.Indicator className=\"grid place-content-center\">\n          <Circle\n            style={{ width: dotPx, height: dotPx }}\n            className=\"fill-current text-current\"\n          />\n        </RadioGroupPrimitive.Indicator>\n      </RadioGroupPrimitive.Item>\n    )\n\n    // 無 label → 只渲染 radio 本體\n    if (label == null) return rootEl\n\n    // 有 label → 透過 SelectionItem 包裝，與 Checkbox 一致（disabled 已於上方 useResolvedFieldDisabled 解析）\n    return (\n      <SelectionItem\n        control={rootEl}\n        label={label}\n        description={description}\n        icon={icon}\n        avatar={avatar}\n        htmlFor={inputId}\n        disabled={resolvedDisabled}\n        size={sizeKey}\n      />\n    )\n  }\n)\nRadioGroupItem.displayName = 'RadioGroupItem'\n\n// Story auto-compile metadata — Phase 1 mechanical migration(2026-04-24)\n// Phase 2 fill needed: purpose descriptions + when rationale + world-class refs\nexport const radioGroupMeta = {\n  component: 'RadioGroup',\n  family: null, // self-contained primitive(對齊 spec frontmatter self-contained + body L31;非 Family 4 — field-controls.spec.md 成員名單不含 RadioGroup)\n  variants: {\n\n  },\n  sizes: {\n    // iconSize = 渲染指示器尺寸(對齊 checkbox/switch meta 慣例:checkbox iconSize=真 Check glyph 12/12/16)。\n    // Radio 指示器是 filled dot 非 glyph,真值 = 上方 `const dotSize` map 8/8/10;\n    // 控件框 16/16/20 與 Checkbox 對齊但那是 box 非「指示器」,不入此鍵(避免 metadata 語意 drift)。\n    sm: { fieldHeight: 28, iconSize: 8, typography: 'body' },\n    md: { fieldHeight: 32, iconSize: 8, typography: 'body' },\n    lg: { fieldHeight: 36, iconSize: 10, typography: 'body-lg' },\n  },\n  // 2026-07-04 修 stale meta:移除 'active' — radioItemVariants cva 無 active-state 樣式,\n  // Radix radio 也無 data-state=active(對照 checkboxMeta 正確不含 active)\n  // 'checked' = 選定持續態(card 式 = border+text primary;2026-07-07 meta 詞彙統一補列)\n  states: ['default', 'hover', 'checked', 'focus-visible', 'disabled'],\n  tokens: {\n    bg: ['bg-disabled', 'bg-surface'],\n    fg: ['text-fg-disabled', 'text-fg-secondary', 'text-foreground', 'text-primary'],\n    ring: ['ring-ring'],\n  },\n  defaultSize: 'md',\n} as const\n\nexport { RadioGroup, RadioGroupItem, radioItemVariants }\n"],"names":[],"mappings":"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"}

package/dist/components/Rating/index.d.ts

@@ -0,0 +1,2 @@
+export * from './rating';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Rating/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Rating/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAA"}

package/dist/components/Rating/index.js

@@ -0,0 +1,6 @@
+import { Rating, ratingMeta } from "./rating.js";
+export {
+  Rating,
+  ratingMeta
+};
+//# sourceMappingURL=index.js.map

package/dist/components/Rating/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/Rating/rating.d.ts

@@ -26,13 +26,17 @@ export interface RatingProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
     loading?: boolean;
     /** 自訂 icon(預設 Star);傳 LucideIcon */
     icon?: LucideIcon;
-    /** a11y label(readOnly 時必填,interactive 時建議填) */
+    /**
+     * a11y label。readOnly(role=img)時必填。
+     * interactive(role=slider)時:在 Field 內免填(自動 aria-labelledby 指向 FieldLabel);
+     * standalone(無 Field)時必填——role=slider 依 WAI-ARIA APG 必有 accessible name。
+     */
     'aria-label'?: string;
 }
 declare const Rating: React.ForwardRefExoticComponent<RatingProps & React.RefAttributes<HTMLDivElement>>;
 export declare const ratingMeta: {
     readonly component: "Rating";
-    readonly family: 4;
+    readonly family: null;
     readonly variants: {};
     readonly sizes: {};
     readonly states: readonly ["default", "hover", "active", "focus-visible", "disabled"];

package/dist/components/Rating/rating.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../../../src/components/Rating/rating.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAsDpD,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACzF,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAChC,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAGD,QAAA,MAAM,MAAM,oFAkHX,CAAA;AA4ED,eAAO,MAAM,UAAU;;;;;;;;;;;CAeb,CAAA;AAEV,OAAO,EAAE,MAAM,EAAE,CAAA"}
+{"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../../../src/components/Rating/rating.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAsDpD,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACzF,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAChC,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAGD,QAAA,MAAM,MAAM,oFAgIX,CAAA;AA6ED,eAAO,MAAM,UAAU;;;;;;;;;;;CAeb,CAAA;AAEV,OAAO,EAAE,MAAM,EAAE,CAAA"}