@qijenchen/design-system 0.1.0-beta.3 → 0.1.0-beta.32

package/dist/components/SelectMenu/select-menu.d.ts

@@ -0,0 +1,103 @@
+import * as React from 'react';
+import type { LucideIcon } from 'lucide-react';
+import type { AvatarData } from '../../components/Avatar/avatar';
+/**
+ * SelectMenu — Popover + Command 組成的完整下拉選單
+ *
+ * ── 功能 ──
+ *   單選 / 多選、搜尋過濾、分組、可建立新選項（creatable）
+ *   多選有 footer「全部」checkbox
+ *
+ * ── 架構 ──
+ *   Popover（浮動容器）
+ *     └── Command（cmdk，搜尋 + 鍵盤導覽）
+ *           ├── CommandInput（搜尋框）
+ *           ├── CommandList（選項列表）
+ *           │     └── CommandGroup → MenuItem
+ *           └── Footer（多選全選）
+ */
+export interface SelectMenuOption {
+    value: string;
+    label: string;
+    description?: string;
+    icon?: LucideIcon;
+    avatar?: AvatarData;
+    disabled?: boolean;
+    group?: string;
+}
+export interface SelectMenuGroupConfig {
+    key: string;
+    label: string;
+}
+type SizeKey = 'sm' | 'md' | 'lg';
+export interface SelectMenuProps {
+    /** 選項列表 */
+    options: SelectMenuOption[];
+    /** 群組定義（key 對應 option.group） */
+    groups?: SelectMenuGroupConfig[];
+    /** 當前值（單選 string，多選 string[]） */
+    value?: string | string[] | null;
+    /** 值變更 callback */
+    onValueChange?: (value: string | string[]) => void;
+    /** 多選模式 */
+    multiple?: boolean;
+    /** 顯示搜尋框 */
+    searchable?: boolean;
+    /** 可建立新選項 */
+    creatable?: boolean;
+    /** 建立新選項 callback */
+    onCreate?: (value: string) => void;
+    /** creatable 的 label 格式，預設 '直接使用「{query}」' */
+    createLabel?: (query: string) => string;
+    /** 觸發元件（asChild） */
+    children: React.ReactNode;
+    /** 搜尋框 placeholder */
+    searchPlaceholder?: string;
+    /** 空選項提示 */
+    emptyText?: string;
+    /** Loading 狀態(2026-05-15 audit B fix per user verbatim「dropdown 隨時可開,讀取在 panel 中間 CircularProgress」)
+     *  true → render `<Empty icon={<CircularProgress size={48}/>} description={loadingText} />` 取代 options;
+     *  trigger 不變,user 隨時可開 dropdown。對齊 MUI Autocomplete `loadingText` dropdown-body + Ant Select
+     *  loading idiom + DS 既有 `empty.spec.md:182` 「全頁 loading = Empty + CircularProgress compose」SSOT。
+     */
+    loading?: boolean;
+    /** 尺寸 */
+    size?: SizeKey;
+    /** 對齊方式 */
+    align?: 'start' | 'end';
+    /** 列表最少顯示幾行選項高度（預設 3），影響空狀態最小高度 */
+    minRows?: number;
+    /** 最小寬度（px），預設跟隨觸發元件 */
+    minWidth?: number;
+    /** 受控 open 狀態 */
+    open?: boolean;
+    /** 預設打開(uncontrolled initial state)— 2026-05-15 audit Dim 26 V1 fix per user verbatim「A:1」approval */
+    defaultOpen?: boolean;
+    /** open 狀態變更 callback */
+    onOpenChange?: (open: boolean) => void;
+    /** 自訂選項 label 渲染（預設渲染 option.label 純文字） */
+    renderLabel?: (option: SelectMenuOption) => React.ReactNode;
+    /** 攔截 PopoverContent 的 onOpenAutoFocus（如 Select searchable 需阻止 focus 搶走） */
+    onOpenAutoFocus?: (e: Event) => void;
+    /**
+     * Popover 內容容器的 DOM id。Combobox / 自定 trigger 用 `aria-controls` 指向此 id 時,
+     * 需傳入相同 id 讓 AT 能找到對應的 listbox。
+     */
+    contentId?: string;
+    className?: string;
+}
+declare const SelectMenu: React.ForwardRefExoticComponent<SelectMenuProps & React.RefAttributes<HTMLElement>>;
+export declare const selectMenuMeta: {
+    readonly component: "SelectMenu";
+    readonly family: 4;
+    readonly variants: {};
+    readonly sizes: {};
+    readonly states: readonly ["default", "hover", "active", "focus-visible", "disabled"];
+    readonly tokens: {
+        readonly bg: readonly ["bg-surface-raised", "bg-transparent"];
+        readonly fg: readonly ["text-fg-muted"];
+        readonly ring: readonly [];
+    };
+};
+export { SelectMenu };
+//# sourceMappingURL=select-menu.d.ts.map

package/dist/components/SelectMenu/select-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-menu.d.ts","sourceRoot":"","sources":["../../../src/components/SelectMenu/select-menu.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAA;AAa1E;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED,KAAK,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAIjC,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,gCAAgC;IAChC,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAA;IAEhC,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAA;IAChC,mBAAmB;IACnB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAA;IAElD,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,YAAY;IACZ,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa;IACb,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAEvC,oBAAoB;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,sBAAsB;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,SAAS;IACT,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,WAAW;IACX,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,sGAAsG;IACtG,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,yBAAyB;IACzB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,KAAK,CAAC,SAAS,CAAA;IAC3D,4EAA4E;IAC5E,eAAe,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;IAEpC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD,QAAA,MAAM,UAAU,qFA0Rd,CAAA;AAMF,eAAO,MAAM,cAAc;;;;;;;;;;;CAejB,CAAA;AAEV,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/dist/components/SelectMenu/select-menu.js

@@ -0,0 +1,239 @@
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
+import * as React from "react";
+import { Search, Plus } from "lucide-react";
+import { cn } from "../../lib/utils.js";
+import { Popover, PopoverTrigger, PopoverContent } from "../Popover/popover.js";
+import { Command, CommandList, CommandEmpty, CommandSeparator, CommandGroup, CommandItem } from "../Command/command.js";
+import { Command as Command$1 } from "cmdk";
+import { MenuItem, MenuFooter } from "../Menu/menu-item.js";
+import { Empty } from "../Empty/empty.js";
+import { CircularProgress } from "../CircularProgress/circular-progress.js";
+import { OVERLAY_SIDE_OFFSET } from "../../tokens/elevation/overlay-geometry.js";
+import { getMenuListMinHeight } from "../Field/field-types.js";
+import { RowSizeProvider, ICON_SIZE } from "../../patterns/element-anatomy/item-anatomy.js";
+import { clearSelection, applySelectAll } from "../../lib/multi-select-ordering.js";
+const SelectMenu = React.forwardRef(function SelectMenu2({
+  options,
+  groups,
+  value,
+  onValueChange,
+  multiple = false,
+  searchable = false,
+  creatable = false,
+  onCreate,
+  createLabel = (q) => `直接使用「${q}」`,
+  children,
+  searchPlaceholder = "搜尋…",
+  // i18n-allow: DS default; consumer override via searchPlaceholder prop
+  emptyText = "沒有符合的選項",
+  // i18n-allow: DS default; consumer override via emptyText prop
+  loading = false,
+  size = "md",
+  align = "start",
+  minRows = 3,
+  minWidth,
+  open: controlledOpen,
+  defaultOpen,
+  onOpenChange: controlledOnOpenChange,
+  renderLabel,
+  onOpenAutoFocus,
+  contentId,
+  className
+}, _ref) {
+  const [internalOpen, setInternalOpen] = React.useState(defaultOpen ?? false);
+  const open = controlledOpen ?? internalOpen;
+  const setOpen = controlledOnOpenChange ?? setInternalOpen;
+  const [search, setSearch] = React.useState("");
+  const selectedValues = React.useMemo(() => {
+    if (value == null) return [];
+    return Array.isArray(value) ? value : [value];
+  }, [value]);
+  const isSelected = React.useCallback(
+    (v) => selectedValues.includes(v),
+    [selectedValues]
+  );
+  const handleSelect = React.useCallback(
+    (optionValue) => {
+      if (multiple) {
+        const next = isSelected(optionValue) ? selectedValues.filter((v) => v !== optionValue) : [...selectedValues, optionValue];
+        onValueChange == null ? void 0 : onValueChange(next);
+      } else {
+        onValueChange == null ? void 0 : onValueChange(optionValue);
+        setOpen(false);
+      }
+    },
+    [multiple, selectedValues, isSelected, onValueChange, setOpen]
+  );
+  const selectableOptions = React.useMemo(
+    () => options.filter((o) => !o.disabled),
+    [options]
+  );
+  const allState = React.useMemo(() => {
+    if (!multiple) return false;
+    const count = selectableOptions.filter((o) => isSelected(o.value)).length;
+    if (count === 0) return false;
+    if (count === selectableOptions.length) return true;
+    return "indeterminate";
+  }, [multiple, selectableOptions, isSelected]);
+  const handleSelectAll = React.useCallback(() => {
+    if (!multiple) return;
+    if (allState === true) {
+      onValueChange == null ? void 0 : onValueChange(clearSelection());
+    } else {
+      onValueChange == null ? void 0 : onValueChange(applySelectAll(selectedValues, selectableOptions.map((o) => o.value)));
+    }
+  }, [multiple, allState, selectableOptions, selectedValues, onValueChange]);
+  const showCreate = React.useMemo(() => {
+    if (!creatable || !search.trim()) return false;
+    return !options.some(
+      (o) => o.label.toLowerCase() === search.trim().toLowerCase()
+    );
+  }, [creatable, search, options]);
+  const groupedOptions = React.useMemo(() => {
+    if (!(groups == null ? void 0 : groups.length)) return [{ key: "__default", label: "", options }];
+    const grouped = groups.map((g) => ({
+      ...g,
+      options: options.filter((o) => o.group === g.key)
+    }));
+    const ungrouped = options.filter((o) => !o.group);
+    if (ungrouped.length) {
+      grouped.unshift({ key: "__default", label: "", options: ungrouped });
+    }
+    return grouped;
+  }, [groups, options]);
+  React.useEffect(() => {
+    if (!open) setSearch("");
+  }, [open]);
+  return /* @__PURE__ */ jsxs(Popover, { open, onOpenChange: setOpen, children: [
+    /* @__PURE__ */ jsx(PopoverTrigger, { asChild: true, children }),
+    /* @__PURE__ */ jsx(RowSizeProvider, { value: size, children: /* @__PURE__ */ jsx(
+      PopoverContent,
+      {
+        id: contentId,
+        className: cn(
+          "p-0 w-auto rounded-lg border border-border bg-surface-raised overflow-hidden",
+          className
+        ),
+        style: {
+          boxShadow: "var(--elevation-200)",
+          minWidth: minWidth ?? "max(var(--radix-popover-trigger-width), 15rem)"
+        },
+        align,
+        sideOffset: OVERLAY_SIDE_OFFSET,
+        onOpenAutoFocus,
+        onInteractOutside: (e) => {
+          const target = e.detail.originalEvent.target;
+          if (target == null ? void 0 : target.closest("[data-radix-popper-content-wrapper]")) {
+            e.preventDefault();
+          }
+        },
+        children: /* @__PURE__ */ jsxs(Command, { shouldFilter: searchable, className: "bg-transparent", children: [
+          searchable && /* @__PURE__ */ jsxs("div", { className: cn(
+            "flex items-center gap-2 px-3 py-1 border-b border-divider",
+            size === "lg" ? "min-h-[calc(var(--field-height-lg)+8px)]" : size === "sm" ? "min-h-[calc(var(--field-height-sm)+8px)]" : "min-h-[calc(var(--field-height-md)+8px)]"
+          ), children: [
+            /* @__PURE__ */ jsx(Search, { size: ICON_SIZE[size], className: "shrink-0 text-fg-muted", "aria-hidden": true }),
+            /* @__PURE__ */ jsx(
+              Command$1.Input,
+              {
+                placeholder: searchPlaceholder,
+                value: search,
+                onValueChange: setSearch,
+                className: cn(
+                  "flex w-full bg-transparent outline-none placeholder:text-fg-muted",
+                  // M24 disabled state precedence:disabled 時 placeholder 切 fg-disabled(audit dim 34)
+                  "disabled:placeholder:text-fg-disabled disabled:text-fg-disabled disabled:cursor-not-allowed",
+                  size === "lg" ? "text-body-lg leading-compact" : "text-body leading-compact"
+                )
+              }
+            )
+          ] }),
+          /* @__PURE__ */ jsxs(CommandList, { className: "relative", children: [
+            /* @__PURE__ */ jsx(
+              CommandEmpty,
+              {
+                className: "flex items-center justify-center",
+                style: { minHeight: getMenuListMinHeight(size, minRows) },
+                children: loading ? /* @__PURE__ */ jsx(Empty, { icon: /* @__PURE__ */ jsx(CircularProgress, { size: 48 }), className: "py-6" }) : /* @__PURE__ */ jsx(Empty, { description: emptyText, className: "py-6" })
+              }
+            ),
+            groupedOptions.map((group, gi) => /* @__PURE__ */ jsxs(React.Fragment, { children: [
+              gi > 0 && /* @__PURE__ */ jsx(CommandSeparator, {}),
+              /* @__PURE__ */ jsxs(CommandGroup, { className: "p-0 py-2", children: [
+                group.label && /* @__PURE__ */ jsx(MenuItem, { size, header: true, children: group.label }),
+                group.options.map((opt) => /* @__PURE__ */ jsx(
+                  CommandItem,
+                  {
+                    value: opt.label,
+                    keywords: opt.description ? [opt.description] : void 0,
+                    disabled: opt.disabled,
+                    onSelect: () => handleSelect(opt.value),
+                    className: "p-0 rounded-none data-[selected=true]:bg-transparent",
+                    children: /* @__PURE__ */ jsx(
+                      MenuItem,
+                      {
+                        size,
+                        startIcon: opt.icon,
+                        avatar: opt.avatar,
+                        description: opt.description,
+                        checkbox: multiple,
+                        checked: isSelected(opt.value),
+                        selected: !multiple && isSelected(opt.value),
+                        disabled: opt.disabled,
+                        children: renderLabel ? renderLabel(opt) : opt.label
+                      }
+                    )
+                  },
+                  opt.value
+                ))
+              ] })
+            ] }, group.key)),
+            showCreate && /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(CommandSeparator, {}),
+              /* @__PURE__ */ jsx(CommandGroup, { className: "p-0 py-2", children: /* @__PURE__ */ jsx(
+                CommandItem,
+                {
+                  value: search,
+                  onSelect: () => {
+                    onCreate == null ? void 0 : onCreate(search.trim());
+                    setSearch("");
+                  },
+                  className: "p-0 rounded-none data-[selected=true]:bg-transparent",
+                  children: /* @__PURE__ */ jsx(MenuItem, { size, startIcon: Plus, children: createLabel(search.trim()) })
+                }
+              ) })
+            ] })
+          ] }),
+          multiple && selectableOptions.length > 0 && !search && /* @__PURE__ */ jsx(MenuFooter, { children: /* @__PURE__ */ jsx(
+            MenuItem,
+            {
+              size,
+              checkbox: true,
+              checked: allState,
+              onClick: handleSelectAll,
+              children: "全部"
+            }
+          ) })
+        ] })
+      }
+    ) })
+  ] });
+});
+SelectMenu.displayName = "SelectMenu";
+const selectMenuMeta = {
+  component: "SelectMenu",
+  family: 4,
+  variants: {},
+  sizes: {},
+  states: ["default", "hover", "active", "focus-visible", "disabled"],
+  tokens: {
+    bg: ["bg-surface-raised", "bg-transparent"],
+    fg: ["text-fg-muted"],
+    ring: []
+  }
+};
+export {
+  SelectMenu,
+  selectMenuMeta
+};
+//# sourceMappingURL=select-menu.js.map

package/dist/components/SelectMenu/select-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-menu.js","sources":["../../../src/components/SelectMenu/select-menu.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 { Plus, Search } from 'lucide-react'\nimport type { LucideIcon } from 'lucide-react'\nimport { cn } from '@/lib/utils'\nimport type { AvatarData } from '@/design-system/components/Avatar/avatar'\nimport { Popover, PopoverContent, PopoverTrigger } from '@/design-system/components/Popover/popover'\nimport { Command, CommandList, CommandEmpty, CommandGroup, CommandItem, CommandSeparator } from '@/design-system/components/Command/command'\nimport { Command as CommandPrimitive } from 'cmdk'\nimport { MenuItem, MenuFooter } from '@/design-system/components/Menu/menu-item'\nimport { Empty } from '@/design-system/components/Empty/empty'\nimport { CircularProgress } from '@/design-system/components/CircularProgress/circular-progress'\nimport { OVERLAY_SIDE_OFFSET } from '@/design-system/tokens/elevation/overlay-geometry'\nimport { getMenuListMinHeight } from '@/design-system/components/Field/field-types'\nimport { RowSizeProvider } from '@/design-system/patterns/element-anatomy/item-anatomy'\nimport { applySelectAll, clearSelection } from '@/design-system/lib/multi-select-ordering'\nimport { ICON_SIZE } from '@/design-system/tokens/uiSize/icon-size'\n\n/**\n * SelectMenu — Popover + Command 組成的完整下拉選單\n *\n * ── 功能 ──\n *   單選 / 多選、搜尋過濾、分組、可建立新選項（creatable）\n *   多選有 footer「全部」checkbox\n *\n * ── 架構 ──\n *   Popover（浮動容器）\n *     └── Command（cmdk，搜尋 + 鍵盤導覽）\n *           ├── CommandInput（搜尋框）\n *           ├── CommandList（選項列表）\n *           │     └── CommandGroup → MenuItem\n *           └── Footer（多選全選）\n */\n\n// ── Types ──\n\nexport interface SelectMenuOption {\n  value: string\n  label: string\n  description?: string\n  icon?: LucideIcon\n  avatar?: AvatarData\n  disabled?: boolean\n  group?: string\n}\n\nexport interface SelectMenuGroupConfig {\n  key: string\n  label: string\n}\n\ntype SizeKey = 'sm' | 'md' | 'lg'\n\n// ── Component ──\n\nexport interface SelectMenuProps {\n  /** 選項列表 */\n  options: SelectMenuOption[]\n  /** 群組定義（key 對應 option.group） */\n  groups?: SelectMenuGroupConfig[]\n\n  /** 當前值（單選 string，多選 string[]） */\n  value?: string | string[] | null\n  /** 值變更 callback */\n  onValueChange?: (value: string | string[]) => void\n\n  /** 多選模式 */\n  multiple?: boolean\n  /** 顯示搜尋框 */\n  searchable?: boolean\n  /** 可建立新選項 */\n  creatable?: boolean\n  /** 建立新選項 callback */\n  onCreate?: (value: string) => void\n  /** creatable 的 label 格式，預設 '直接使用「{query}」' */\n  createLabel?: (query: string) => string\n\n  /** 觸發元件（asChild） */\n  children: React.ReactNode\n  /** 搜尋框 placeholder */\n  searchPlaceholder?: string\n  /** 空選項提示 */\n  emptyText?: string\n  /** Loading 狀態(2026-05-15 audit B fix per user verbatim「dropdown 隨時可開,讀取在 panel 中間 CircularProgress」)\n   *  true → render `<Empty icon={<CircularProgress size={48}/>} description={loadingText} />` 取代 options;\n   *  trigger 不變,user 隨時可開 dropdown。對齊 MUI Autocomplete `loadingText` dropdown-body + Ant Select\n   *  loading idiom + DS 既有 `empty.spec.md:182` 「全頁 loading = Empty + CircularProgress compose」SSOT。\n   */\n  loading?: boolean\n\n  /** 尺寸 */\n  size?: SizeKey\n  /** 對齊方式 */\n  align?: 'start' | 'end'\n  /** 列表最少顯示幾行選項高度（預設 3），影響空狀態最小高度 */\n  minRows?: number\n  /** 最小寬度（px），預設跟隨觸發元件 */\n  minWidth?: number\n\n  /** 受控 open 狀態 */\n  open?: boolean\n  /** 預設打開(uncontrolled initial state)— 2026-05-15 audit Dim 26 V1 fix per user verbatim「A:1」approval */\n  defaultOpen?: boolean\n  /** open 狀態變更 callback */\n  onOpenChange?: (open: boolean) => void\n\n  /** 自訂選項 label 渲染（預設渲染 option.label 純文字） */\n  renderLabel?: (option: SelectMenuOption) => React.ReactNode\n  /** 攔截 PopoverContent 的 onOpenAutoFocus（如 Select searchable 需阻止 focus 搶走） */\n  onOpenAutoFocus?: (e: Event) => void\n\n  /**\n   * Popover 內容容器的 DOM id。Combobox / 自定 trigger 用 `aria-controls` 指向此 id 時,\n   * 需傳入相同 id 讓 AT 能找到對應的 listbox。\n   */\n  contentId?: string\n\n  className?: string\n}\n\n// shadcn canonical:forwardRef + displayName 統一。SelectMenu 是 Popover + Command\n// composite,自身無 DOM host(trigger 由 consumer 以 asChild children 提供),ref 簽名\n// 保留但不附著(consumer 想取 trigger DOM 直接在 children 上自己 ref)。className 合併到\n// PopoverContent(contextually 最接近 user-facing surface)。\nconst SelectMenu = React.forwardRef<HTMLElement, SelectMenuProps>(function SelectMenu({\n  options,\n  groups,\n  value,\n  onValueChange,\n  multiple = false,\n  searchable = false,\n  creatable = false,\n  onCreate,\n  createLabel = (q) => `直接使用「${q}」`,\n  children,\n  searchPlaceholder = '搜尋…', // i18n-allow: DS default; consumer override via searchPlaceholder prop\n  emptyText = '沒有符合的選項', // i18n-allow: DS default; consumer override via emptyText prop\n  loading = false,\n  size = 'md',\n  align = 'start',\n  minRows = 3,\n  minWidth,\n  open: controlledOpen,\n  defaultOpen,\n  onOpenChange: controlledOnOpenChange,\n  renderLabel,\n  onOpenAutoFocus,\n  contentId,\n  className,\n}, _ref) {\n  // ── State ──\n  const [internalOpen, setInternalOpen] = React.useState(defaultOpen ?? false)\n  const open = controlledOpen ?? internalOpen\n  const setOpen = controlledOnOpenChange ?? setInternalOpen\n  const [search, setSearch] = React.useState('')\n\n  // ── Value helpers ──\n  const selectedValues = React.useMemo<string[]>(() => {\n    if (value == null) return []\n    return Array.isArray(value) ? value : [value]\n  }, [value])\n\n  const isSelected = React.useCallback(\n    (v: string) => selectedValues.includes(v),\n    [selectedValues]\n  )\n\n  const handleSelect = React.useCallback(\n    (optionValue: string) => {\n      if (multiple) {\n        const next = isSelected(optionValue)\n          ? selectedValues.filter((v) => v !== optionValue)\n          : [...selectedValues, optionValue]\n        onValueChange?.(next)\n      } else {\n        onValueChange?.(optionValue)\n        setOpen(false)\n      }\n    },\n    [multiple, selectedValues, isSelected, onValueChange, setOpen]\n  )\n\n  // ── Multi-select: select all ──\n  const selectableOptions = React.useMemo(\n    () => options.filter((o) => !o.disabled),\n    [options]\n  )\n\n  const allState: boolean | 'indeterminate' = React.useMemo(() => {\n    if (!multiple) return false\n    const count = selectableOptions.filter((o) => isSelected(o.value)).length\n    if (count === 0) return false\n    if (count === selectableOptions.length) return true\n    return 'indeterminate'\n  }, [multiple, selectableOptions, isSelected])\n\n  // 2026-05-16 SSOT canonical fix(Claude+Codex M31 Round 4 共識 + user verbatim「就照你們\n  // 的共識做到完美確保有 SSOT」):\n  //\n  // 原 fully-replace `selectableOptions.map(v)` = source order reset,但**Ant Design 跨元件 grep\n  // 證據顯示 source-reset 沒 Ant precedent**(Transfer + Table rowSelection 都是 preserve+append)。\n  // 改 `applySelectAll(selectedValues, all)` SSOT primitive 對齊 Ant Transfer canonical:\n  //   `Array.from(new Set([...prevKeys, ...keys]))` — preserve existing + append unselected。\n  //\n  // SSOT in `@/design-system/lib/multi-select-ordering` — 未來新 multi-select with Select All\n  // footer 必 consume 此 primitive(hook `check_select_all_canonical.sh` 機械強制),\n  // 不再各自 reimplement → 防 ordering policy drift。\n  const handleSelectAll = React.useCallback(() => {\n    if (!multiple) return\n    if (allState === true) {\n      onValueChange?.(clearSelection())\n    } else {\n      onValueChange?.(applySelectAll(selectedValues, selectableOptions.map((o) => o.value)))\n    }\n  }, [multiple, allState, selectableOptions, selectedValues, onValueChange])\n\n  // ── Creatable ──\n  const showCreate = React.useMemo(() => {\n    if (!creatable || !search.trim()) return false\n    return !options.some(\n      (o) => o.label.toLowerCase() === search.trim().toLowerCase()\n    )\n  }, [creatable, search, options])\n\n  // ── Grouping ──\n  const groupedOptions = React.useMemo(() => {\n    if (!groups?.length) return [{ key: '__default', label: '', options }]\n    const grouped = groups.map((g) => ({\n      ...g,\n      options: options.filter((o) => o.group === g.key),\n    }))\n    const ungrouped = options.filter((o) => !o.group)\n    if (ungrouped.length) {\n      grouped.unshift({ key: '__default', label: '', options: ungrouped })\n    }\n    return grouped\n  }, [groups, options])\n\n  // ── Reset search on close ──\n  React.useEffect(() => {\n    if (!open) setSearch('')\n  }, [open])\n\n  // RowSizeProvider 讓 PopoverContent 子樹內任何 <ItemIcon> / <ItemAvatar> /\n  // <ItemInlineAction> 都自動讀到對的 size,跟 SidebarProvider / TreeView 同一條規則。\n  // (注:Popover 透過 Portal 渲染,context 仍然會跨 portal 傳遞——React context 是 tree-based\n  // 不是 DOM-based,Portal 不影響 context propagation)\n  return (\n    <Popover open={open} onOpenChange={setOpen}>\n      <PopoverTrigger asChild>{children}</PopoverTrigger>\n      <RowSizeProvider value={size}>\n      <PopoverContent\n        id={contentId}\n        // w-auto override PopoverContent default w-72(rich-popover canonical)— SelectMenu 走「跟 trigger 同寬」\n        // canonical(spec L72)。minWidth = max(trigger-width, 240px sensible-min)— 對齊 shadcn / Material / Ant\n        // select dropdown 共識(2026-05-04 D1 verify SelectMenu spec implementation)。\n        className={cn(\n          'p-0 w-auto rounded-lg border border-border bg-surface-raised overflow-hidden',\n          className\n        )}\n        style={{\n          boxShadow: 'var(--elevation-200)',\n          minWidth: minWidth ?? 'max(var(--radix-popover-trigger-width), 15rem)',\n        }}\n        align={align}\n        sideOffset={OVERLAY_SIDE_OFFSET}\n        onOpenAutoFocus={onOpenAutoFocus}\n        // **2026-05-07 v15.16 nested portal fix**:Tag dismiss inside trigger\n        // 區的 OverflowIndicator HoverCard popup(獨立 Radix portal,DOM 不在\n        // PopoverContent 內)— Radix DismissableLayer document-level outside\n        // detection 跨 portal 視為「outside」→ SelectMenu 被誤關閉。\n        // 攔 `onPointerDownOutside`,檢查 click target 是否在另一個 Radix portal\n        // 內,是 → preventDefault 取消 close。對齊 Ant Design Select multiSelect\n        // tagRender 行為(連續移除不關 dropdown)。\n        // SSOT propagation:fix 在 SelectMenu level → Combobox / 其他 SelectMenu\n        // consumer 自動受益。\n        // **2026-05-07 v15.16 nested portal fix**:Tag dismiss inside trigger 區的\n        // OverflowIndicator HoverCard popup(獨立 Radix portal,DOM 不在 SelectMenu\n        // PopoverContent 內)— Radix DismissableLayer document-level pointerdown +\n        // focusin 偵測「outside」→ SelectMenu 被誤關閉。\n        // 攔 `onInteractOutside`(統一 pointerdown + focusin),檢查 click target 是否\n        // 在另一個 Radix portal wrapper(`[data-radix-popper-content-wrapper]`),\n        // 是 → preventDefault 取消 close。對齊 Ant Design Select multiSelect tagRender\n        // 行為(連續移除不關 dropdown)。\n        // SSOT propagation:fix 在 SelectMenu level → Combobox / 所有 SelectMenu\n        // consumer 自動受益。\n        onInteractOutside={(e) => {\n          const target = e.detail.originalEvent.target as HTMLElement | null\n          if (target?.closest('[data-radix-popper-content-wrapper]')) {\n            e.preventDefault()\n          }\n        }}\n      >\n        <Command shouldFilter={searchable} className=\"bg-transparent\">\n          {searchable && (\n            <div className={cn(\n              'flex items-center gap-2 px-3 py-1 border-b border-divider',\n              size === 'lg' ? 'min-h-[calc(var(--field-height-lg)+8px)]'\n                : size === 'sm' ? 'min-h-[calc(var(--field-height-sm)+8px)]'\n                : 'min-h-[calc(var(--field-height-md)+8px)]',\n            )}>\n              <Search size={ICON_SIZE[size as 'sm' | 'md' | 'lg']} className=\"shrink-0 text-fg-muted\" aria-hidden />\n              <CommandPrimitive.Input\n                placeholder={searchPlaceholder}\n                value={search}\n                onValueChange={setSearch}\n                className={cn(\n                  'flex w-full bg-transparent outline-none placeholder:text-fg-muted',\n                  // M24 disabled state precedence:disabled 時 placeholder 切 fg-disabled(audit dim 34)\n                  'disabled:placeholder:text-fg-disabled disabled:text-fg-disabled disabled:cursor-not-allowed',\n                  size === 'lg' ? 'text-body-lg leading-compact' : 'text-body leading-compact',\n                )}\n              />\n            </div>\n          )}\n          {/* **2026-05-07 v15.13 R2 fix**:minHeight 從 CommandList 搬到 CommandEmpty。\n              原本 CommandList 永遠套 `minHeight = field-height × minRows + 16px`,結果\n              user 過濾出 < minRows 個 match 時 list 底下空一片(eg. 打 'c' 出 2 個 match\n              卻撐高到 3 row 容量,1 row 留白)。 Fix:只有 empty state 才需要 minHeight 撐\n              起 placeholder 視覺;有 results 時 CommandList 自然 fit content。 */}\n          <CommandList className=\"relative\">\n            <CommandEmpty\n              className=\"flex items-center justify-center\"\n              style={{ minHeight: getMenuListMinHeight(size, minRows) }}\n            >\n              {loading\n                ? <Empty icon={<CircularProgress size={48}/>} className=\"py-6\" />\n                : <Empty description={emptyText} className=\"py-6\" />}\n            </CommandEmpty>\n\n            {groupedOptions.map((group, gi) => (\n              <React.Fragment key={group.key}>\n                {gi > 0 && <CommandSeparator />}\n                <CommandGroup className=\"p-0 py-2\">\n                  {group.label && (\n                    <MenuItem size={size} header>{group.label}</MenuItem>\n                  )}\n                  {group.options.map((opt) => (\n                    <CommandItem\n                      key={opt.value}\n                      value={opt.label}\n                      keywords={opt.description ? [opt.description] : undefined}\n                      disabled={opt.disabled}\n                      onSelect={() => handleSelect(opt.value)}\n                      className=\"p-0 rounded-none data-[selected=true]:bg-transparent\"\n                    >\n                      <MenuItem\n                        size={size}\n                        startIcon={opt.icon}\n                        avatar={opt.avatar}\n                        description={opt.description}\n                        checkbox={multiple}\n                        checked={isSelected(opt.value)}\n                        selected={!multiple && isSelected(opt.value)}\n                        disabled={opt.disabled}\n                      >\n                        {renderLabel ? renderLabel(opt) : opt.label}\n                      </MenuItem>\n                    </CommandItem>\n                  ))}\n                </CommandGroup>\n              </React.Fragment>\n            ))}\n\n            {/* Creatable item */}\n            {showCreate && (\n              <>\n                <CommandSeparator />\n                <CommandGroup className=\"p-0 py-2\">\n                  <CommandItem\n                    value={search}\n                    onSelect={() => {\n                      onCreate?.(search.trim())\n                      setSearch('')\n                    }}\n                    className=\"p-0 rounded-none data-[selected=true]:bg-transparent\"\n                  >\n                    <MenuItem size={size} startIcon={Plus}>\n                      {createLabel(search.trim())}\n                    </MenuItem>\n                  </CommandItem>\n                </CommandGroup>\n              </>\n            )}\n          </CommandList>\n\n          {/* Multi-select footer: Select All\n              - 沒有選項時不顯示(selectableOptions.length === 0)\n              - 搜尋有文字時不顯示(search 非空 = 使用者在找特定項目,「全選」沒意義) */}\n          {multiple && selectableOptions.length > 0 && !search && (\n            <MenuFooter>\n              <MenuItem\n                size={size}\n                checkbox\n                checked={allState}\n                onClick={handleSelectAll}\n              >\n                全部\n              </MenuItem>\n            </MenuFooter>\n          )}\n        </Command>\n      </PopoverContent>\n      </RowSizeProvider>\n    </Popover>\n  )\n})\n\nSelectMenu.displayName = 'SelectMenu'\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 selectMenuMeta = {\n  component: 'SelectMenu',\n  family: 4,\n  variants: {\n\n  },\n  sizes: {\n\n  },\n  states: ['default', 'hover', 'active', 'focus-visible', 'disabled'],\n  tokens: {\n    bg: ['bg-surface-raised', 'bg-transparent'],\n    fg: ['text-fg-muted'],\n    ring: [],\n  },\n} as const\n\nexport { SelectMenu }\n"],"names":["SelectMenu","CommandPrimitive"],"mappings":"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"}

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

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

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

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

package/dist/components/SelectionControl/index.js

@@ -0,0 +1,7 @@
+import { SelectionItem, selectionItemMeta, selectionItemStyles } from "./selection-item.js";
+export {
+  SelectionItem,
+  selectionItemMeta,
+  selectionItemStyles
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/SelectionControl/selection-item.d.ts

@@ -0,0 +1,69 @@
+import * as React from 'react';
+import { type VariantProps } from 'class-variance-authority';
+import type { LucideIcon } from 'lucide-react';
+import { type AvatarData } from '../../components/Avatar/avatar';
+export declare const selectionItemStyles: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface SelectionItemProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof selectionItemStyles> {
+    /** Checkbox 或 RadioGroupItem 元素(永遠存在,永遠 inline 對齊) */
+    control: React.ReactNode;
+    /** Label 文字 */
+    label: React.ReactNode;
+    /** 描述文字(fg-secondary;reading mode 永遠 14px) */
+    description?: React.ReactNode;
+    /**
+     * 可選的左側 icon(在 control 之後、label 之前)。LucideIcon 型別,元件內部控制尺寸
+     * (16/16/20px @ sm/md/lg)。**永遠 inline 對齊第一行 label**(icon ≤24px)。
+     * 與 `avatar` 互斥。
+     */
+    icon?: LucideIcon;
+    /**
+     * 可選的左側 avatar(在 control 之後、label 之前)。`AvatarData` 資料型別,元件內部渲染 Avatar。
+     * 尺寸由 `description` 自動決定(跟 MenuItem 同 convention):
+     * - 無 desc → inline(20/24/24px),跟 control 同步在 label 第一行
+     * - 有 desc → block(32/32/40px),跟 control 同步在 text block center
+     *
+     * Block 模式時 **control(checkbox/radio)也一起走 block 高度**——兩者都在
+     * text block center,不會歪斜。與 `icon` 互斥。
+     */
+    avatar?: AvatarData;
+    /** htmlFor（label 指向 control 的 id） */
+    htmlFor?: string;
+    /** disabled 狀態影響 label 顏色 */
+    disabled?: boolean;
+    /**
+     * Label 最大行數(line-clamp 截斷)。
+     *
+     * - `undefined`(預設 prop 值未傳)→ 套用元件預設 `'none'`(form 欄位允許任意長度)
+     * - 數字 → 截斷到該行數
+     * - `'none'` → 明確不截斷(語意等同預設)
+     *
+     * 為什麼用 `'none'` 而不是 `undefined`?React props 的 destructure default 在
+     * `undefined` 時會接管,要明確覆寫必須用非 undefined 的 sentinel。
+     */
+    labelMaxLines?: number | 'none';
+    /**
+     * Description 最大行數。預設 `'none'`(不截)。
+     */
+    descMaxLines?: number | 'none';
+    className?: string;
+}
+declare const SelectionItem: React.ForwardRefExoticComponent<SelectionItemProps & React.RefAttributes<HTMLDivElement>>;
+export declare const selectionItemMeta: {
+    readonly component: "SelectionItem";
+    readonly family: 2;
+    readonly variants: {};
+    readonly sizes: {
+        readonly sm: {};
+        readonly md: {};
+        readonly lg: {};
+    };
+    readonly defaultSize: "md";
+    readonly states: readonly ["default", "hover", "selected", "focus-visible", "disabled"];
+    readonly tokens: {
+        readonly fg: readonly ["text-foreground", "text-fg-secondary", "text-fg-disabled"];
+    };
+};
+export { SelectionItem };
+//# sourceMappingURL=selection-item.d.ts.map

package/dist/components/SelectionControl/selection-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-item.d.ts","sourceRoot":"","sources":["../../../src/components/SelectionControl/selection-item.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,0CAA0C,CAAA;AAyBlF,eAAO,MAAM,mBAAmB;;8EAc/B,CAAA;AA2BD,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC,OAAO,mBAAmB,CAAC;IACxH,sDAAsD;IACtD,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB,eAAe;IACf,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC/B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAmFD,QAAA,MAAM,aAAa,2FA4ClB,CAAA;AAID,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;CAcpB,CAAA;AAEV,OAAO,EAAE,aAAa,EAAE,CAAA"}

package/dist/components/SelectionControl/selection-item.js

@@ -0,0 +1,142 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { cva } from "class-variance-authority";
+import { cn } from "../../lib/utils.js";
+import { Avatar } from "../Avatar/avatar.js";
+import { AVATAR_SIZE, ICON_SIZE } from "../../patterns/element-anatomy/item-anatomy.js";
+const selectionItemStyles = cva(
+  "flex items-start gap-2",
+  {
+    variants: {
+      size: {
+        sm: "text-body py-[calc((var(--field-height-sm)_-_1lh)_/_2)]",
+        md: "text-body py-[calc((var(--field-height-md)_-_1lh)_/_2)]",
+        lg: "text-body-lg py-[calc((var(--field-height-lg)_-_1lh)_/_2)]"
+      }
+    },
+    defaultVariants: {
+      size: "md"
+    }
+  }
+);
+const AVATAR_PX = AVATAR_SIZE;
+const blockAlignClass = {
+  sm: "h-[calc(1lh+var(--item-gap-label-desc-reading)+var(--font-body-size)*1.5)]",
+  md: "h-[calc(1lh+var(--item-gap-label-desc-reading)+var(--font-body-size)*1.5)]",
+  lg: "h-[calc(1lh+var(--item-gap-label-desc-reading-lg)+var(--font-body-size)*1.5)]"
+};
+function lineClampClass(maxLines) {
+  if (maxLines === "none" || !maxLines) return "";
+  if (maxLines === 1) return "line-clamp-1";
+  if (maxLines === 2) return "line-clamp-2";
+  if (maxLines === 3) return "line-clamp-3";
+  if (maxLines === 4) return "line-clamp-4";
+  if (maxLines === 5) return "line-clamp-5";
+  if (maxLines === 6) return "line-clamp-6";
+  return "";
+}
+function PrefixSlot({ icon: Icon, avatar, sizeKey, alignClass, avatarPx, disabled }) {
+  if (!Icon && !avatar) return null;
+  return /* @__PURE__ */ jsxs("div", { className: cn(alignClass, "flex items-center shrink-0"), children: [
+    Icon && /* @__PURE__ */ jsx(
+      Icon,
+      {
+        size: ICON_SIZE[sizeKey],
+        className: cn("shrink-0", disabled && "text-fg-disabled"),
+        "aria-hidden": true
+      }
+    ),
+    !Icon && avatar && /* @__PURE__ */ jsx(Avatar, { src: avatar.src, alt: avatar.alt, color: avatar.color, hoverCard: avatar.hoverCard, size: avatarPx })
+  ] });
+}
+function ContentSlot({ htmlFor, disabled, label, description, sizeKey, labelClampClass, descClampClass }) {
+  return /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+    /* @__PURE__ */ jsx(
+      "label",
+      {
+        htmlFor,
+        className: cn(
+          "cursor-pointer block break-words",
+          labelClampClass,
+          disabled ? "text-fg-disabled cursor-not-allowed" : "text-foreground"
+        ),
+        children: label
+      }
+    ),
+    description && /* @__PURE__ */ jsx(
+      "p",
+      {
+        className: cn(
+          sizeKey === "lg" ? "mt-[var(--item-gap-label-desc-reading-lg)]" : "mt-[var(--item-gap-label-desc-reading)]",
+          "break-words",
+          descClampClass,
+          disabled ? "text-fg-disabled" : "text-fg-secondary"
+        ),
+        style: { fontSize: "var(--font-body-size)" },
+        children: description
+      }
+    )
+  ] });
+}
+const SelectionItem = React.forwardRef(
+  ({
+    control,
+    label,
+    description,
+    icon: Icon,
+    avatar,
+    htmlFor,
+    disabled,
+    size,
+    labelMaxLines = "none",
+    descMaxLines = "none",
+    className,
+    ...props
+  }, ref) => {
+    const sizeKey = size ?? "md";
+    if (process.env.NODE_ENV !== "production" && Icon && avatar) {
+      console.warn("[SelectionItem] `icon` 和 `avatar` 互斥,只會渲染 icon。");
+    }
+    const useBlock = !!avatar && !Icon && !!description && AVATAR_PX.block[sizeKey] > 24;
+    const avatarPx = useBlock ? AVATAR_PX.block[sizeKey] : AVATAR_PX.inline[sizeKey];
+    const alignClass = useBlock ? blockAlignClass[sizeKey] : "h-[1lh]";
+    return /* @__PURE__ */ jsxs("div", { ref, className: cn(selectionItemStyles({ size }), className), ...props, children: [
+      /* @__PURE__ */ jsx("div", { className: cn(alignClass, "flex items-center shrink-0"), children: control }),
+      /* @__PURE__ */ jsx(PrefixSlot, { icon: Icon, avatar, sizeKey, alignClass, avatarPx, disabled }),
+      /* @__PURE__ */ jsx(
+        ContentSlot,
+        {
+          htmlFor,
+          disabled,
+          label,
+          description,
+          sizeKey,
+          labelClampClass: lineClampClass(labelMaxLines),
+          descClampClass: lineClampClass(descMaxLines)
+        }
+      )
+    ] });
+  }
+);
+SelectionItem.displayName = "SelectionItem";
+const selectionItemMeta = {
+  component: "SelectionItem",
+  family: 2,
+  variants: {},
+  sizes: {
+    sm: {},
+    md: {},
+    lg: {}
+  },
+  defaultSize: "md",
+  states: ["default", "hover", "selected", "focus-visible", "disabled"],
+  tokens: {
+    fg: ["text-foreground", "text-fg-secondary", "text-fg-disabled"]
+  }
+};
+export {
+  SelectionItem,
+  selectionItemMeta,
+  selectionItemStyles
+};
+//# sourceMappingURL=selection-item.js.map