@simplysm/solid 13.0.16 → 13.0.24

package/dist/providers/shared-data/SharedDataProvider.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/providers/shared-data/SharedDataProvider.tsx"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["createMemo", "createSignal", "onCleanup", "objEqual", "waitUntil", "SharedDataContext", "SharedDataChangeEvent", "useServiceClient", "useNotification", "useLogger", "SharedDataProvider", "props", "serviceClient", "notification", "logger", "loadingCount", "setLoadingCount", "loading", "signalMap", "Map", "memoMap", "listenerKeyMap", "versionMap", "ordering", "data", "orderByList", "result", "orderBy", "reverse", "selector", "item", "orderByDesc", "loadData", "name", "def", "changeKeys", "currentVersion", "get", "set", "c", "signal", "Error", "setItems", "resData", "fetch", "prev", "filtered", "filter", "includes", "getKey", "push", "err", "error", "danger", "message", "wait", "accessors", "Object", "entries", "definitions", "items", "itemMap", "map", "client", "serviceKey", "addEventListener", "then", "key", "undefined", "emit", "emitToServer", "info", "listenerKey", "removeEventListener", "contextValue", "_$createComponent", "Provider", "value", "children"]
 }

package/docs/hooks.md

@@ -311,3 +311,22 @@ interface AppStructureLeafItem<TModule> {
 
 type AppStructureItem<TModule> = AppStructureGroupItem<TModule> | AppStructureLeafItem<TModule>;
 ```
+
+#### getTitleChainByHref
+
+Retrieves the breadcrumb title chain for a given href path. Works on raw items (including `isNotMenu` items).
+
+```tsx
+import { createAppStructure } from "@simplysm/solid";
+
+const appStructure = createAppStructure({ items });
+
+// Returns ["Sales", "Invoice"] for /home/sales/invoice
+const titles = appStructure.getTitleChainByHref("/home/sales/invoice");
+
+// Use with router for dynamic breadcrumb
+import { useLocation } from "@solidjs/router";
+
+const location = useLocation();
+const breadcrumb = () => appStructure.getTitleChainByHref(location.pathname);
+```

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@simplysm/solid",
-  "version": "13.0.16",
+  "version": "13.0.24",
   "description": "심플리즘 패키지 - SolidJS 라이브러리",
+  "author": "김석래",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/kslhunter/simplysm.git",
     "directory": "packages/solid"
   },
-  "author": "김석래",
-  "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -49,8 +49,8 @@
     "solid-tiptap": "^0.8.0",
     "tailwind-merge": "^3.4.1",
     "tailwindcss": "^3.4.19",
-    "@simplysm/core-browser": "13.0.16",
-    "@simplysm/core-common": "13.0.16"
+    "@simplysm/core-browser": "13.0.24",
+    "@simplysm/core-common": "13.0.24"
   },
   "devDependencies": {
     "@solidjs/testing-library": "^0.8.10"

package/src/components/data/calendar/Calendar.tsx

@@ -4,10 +4,10 @@ import clsx from "clsx";
 import { twMerge } from "tailwind-merge";
 import { createControllableSignal } from "../../../hooks/createControllableSignal";
 
-export interface CalendarProps<T> extends Omit<JSX.HTMLAttributes<HTMLTableElement>, "children"> {
-  items: T[];
-  getItemDate: (item: T, index: number) => DateOnly;
-  renderItem: (item: T, index: number) => JSX.Element;
+export interface CalendarProps<TValue> extends Omit<JSX.HTMLAttributes<HTMLTableElement>, "children"> {
+  items: TValue[];
+  getItemDate: (item: TValue, index: number) => DateOnly;
+  renderItem: (item: TValue, index: number) => JSX.Element;
   yearMonth?: DateOnly;
   onYearMonthChange?: (value: DateOnly) => void;
   weekStartDay?: number;
@@ -40,7 +40,7 @@ const notCurrentDayClass = clsx("text-base-300", "dark:text-base-600");
 
 const contentClass = clsx("flex flex-col gap-1");
 
-function CalendarBase<T>(props: CalendarProps<T>) {
+function CalendarBase<TValue>(props: CalendarProps<TValue>) {
   const [local, rest] = splitProps(props, [
     "class",
     "items",
@@ -71,7 +71,7 @@ function CalendarBase<T>(props: CalendarProps<T>) {
     const getDate = local.getItemDate;
 
     // 아이템을 날짜별로 그룹핑 (O(N))
-    const itemMap = new Map<number, { item: T; index: number }[]>();
+    const itemMap = new Map<number, { item: TValue; index: number }[]>();
     for (let i = 0; i < items.length; i++) {
       const date = getDate(items[i], i);
       const key = date.tick;
@@ -84,10 +84,10 @@ function CalendarBase<T>(props: CalendarProps<T>) {
     }
 
     const firstDate = ym.getWeekSeqStartDate(weekStartDay(), minDaysInFirstWeek());
-    const result: { date: DateOnly; items: { item: T; index: number }[] }[][] = [];
+    const result: { date: DateOnly; items: { item: TValue; index: number }[] }[][] = [];
 
     for (let r = 0; r < 6; r++) {
-      const row: { date: DateOnly; items: { item: T; index: number }[] }[] = [];
+      const row: { date: DateOnly; items: { item: TValue; index: number }[] }[] = [];
       for (let c = 0; c < 7; c++) {
         const date = firstDate.addDays(r * 7 + c);
         row.push({

package/src/components/data/sheet/DataSheetColumn.tsx

@@ -7,7 +7,7 @@ export function isDataSheetColumnDef(value: unknown): value is DataSheetColumnDe
 }
 
 /* eslint-disable solid/reactivity -- plain object 반환 패턴으로 reactive context 불필요 */
-export function DataSheetColumn<T>(props: DataSheetColumnProps<T>): JSX.Element {
+export function DataSheetColumn<TItem>(props: DataSheetColumnProps<TItem>): JSX.Element {
   return {
     __type: "sheet-column",
     key: props.key,

package/src/components/data/sheet/sheetUtils.ts

@@ -7,7 +7,7 @@ export function normalizeHeader(header?: string | string[]): string[] {
   return header;
 }
 
-export function buildHeaderTable<T>(columns: DataSheetColumnDef<T>[]): (HeaderDef | null)[][] {
+export function buildHeaderTable<TItem>(columns: DataSheetColumnDef<TItem>[]): (HeaderDef | null)[][] {
   if (columns.length === 0) return [];
 
   const maxDepth = Math.max(...columns.map((c) => c.header.length));
@@ -91,11 +91,11 @@ function isSameGroup(padded: string[][], colA: number, colB: number, startRow: n
   return true;
 }
 
-export function flattenTree<T>(
-  items: T[],
-  expandedItems: T[],
-  getChildren?: (item: T, index: number) => T[] | undefined,
-): FlatItem<T>[] {
+export function flattenTree<TNode>(
+  items: TNode[],
+  expandedItems: TNode[],
+  getChildren?: (item: TNode, index: number) => TNode[] | undefined,
+): FlatItem<TNode>[] {
   if (!getChildren) {
     return items.map((item, i) => ({
       item,
@@ -105,10 +105,10 @@ export function flattenTree<T>(
     }));
   }
 
-  const result: FlatItem<T>[] = [];
+  const result: FlatItem<TNode>[] = [];
   let index = 0;
 
-  function walk(list: T[], depth: number, parent?: T): void {
+  function walk(list: TNode[], depth: number, parent?: TNode): void {
     for (const item of list) {
       const children = getChildren!(item, index);
       const hasChildren = children != null && children.length > 0;
@@ -125,11 +125,14 @@ export function flattenTree<T>(
   return result;
 }
 
-export function collectAllExpandable<T>(items: T[], getChildren: (item: T, index: number) => T[] | undefined): T[] {
-  const result: T[] = [];
+export function collectAllExpandable<TItem>(
+  items: TItem[],
+  getChildren: (item: TItem, index: number) => TItem[] | undefined,
+): TItem[] {
+  const result: TItem[] = [];
   let index = 0;
 
-  function walk(list: T[]): void {
+  function walk(list: TItem[]): void {
     for (const item of list) {
       const children = getChildren(item, index);
       index++;
@@ -144,12 +147,12 @@ export function collectAllExpandable<T>(items: T[], getChildren: (item: T, index
   return result;
 }
 
-export function applySorting<T>(items: T[], sorts: SortingDef[]): T[] {
+export function applySorting<TItem>(items: TItem[], sorts: SortingDef[]): TItem[] {
   if (sorts.length === 0) return items;
 
   let result = [...items];
   for (const sort of [...sorts].reverse()) {
-    const selector = (item: T) => objGetChainValue(item, sort.key) as string | number | undefined;
+    const selector = (item: TItem) => objGetChainValue(item, sort.key) as string | number | undefined;
     result = sort.desc ? result.orderByDesc(selector) : result.orderBy(selector);
   }
   return result;

package/src/components/data/sheet/types.ts

@@ -1,8 +1,8 @@
 import type { JSX } from "solid-js";
 
-export interface DataSheetProps<T> {
+export interface DataSheetProps<TItem> {
   // 데이터
-  items?: T[];
+  items?: TItem[];
   // 설정
   persistKey?: string;
   hideConfigBar?: boolean;
@@ -23,29 +23,29 @@ export interface DataSheetProps<T> {
 
   // 선택
   selectMode?: "single" | "multiple";
-  selectedItems?: T[];
-  onSelectedItemsChange?: (items: T[]) => void;
+  selectedItems?: TItem[];
+  onSelectedItemsChange?: (items: TItem[]) => void;
   autoSelect?: "click";
-  isItemSelectable?: (item: T) => boolean | string;
+  isItemSelectable?: (item: TItem) => boolean | string;
 
   // 트리 확장
-  expandedItems?: T[];
-  onExpandedItemsChange?: (items: T[]) => void;
-  getChildren?: (item: T, index: number) => T[] | undefined;
+  expandedItems?: TItem[];
+  onExpandedItemsChange?: (items: TItem[]) => void;
+  getChildren?: (item: TItem, index: number) => TItem[] | undefined;
 
   // 셀 스타일
-  cellClass?: (item: T, colKey: string) => string | undefined;
-  cellStyle?: (item: T, colKey: string) => string | undefined;
+  cellClass?: (item: TItem, colKey: string) => string | undefined;
+  cellStyle?: (item: TItem, colKey: string) => string | undefined;
 
   // 재정렬
-  onItemsReorder?: (event: DataSheetReorderEvent<T>) => void;
+  onItemsReorder?: (event: DataSheetReorderEvent<TItem>) => void;
 
   // 기타
   class?: string;
   children: JSX.Element;
 }
 
-export interface DataSheetColumnProps<T> {
+export interface DataSheetColumnProps<TItem> {
   key: string;
   header?: string | string[];
   headerContent?: () => JSX.Element;
@@ -59,11 +59,11 @@ export interface DataSheetColumnProps<T> {
   class?: string;
   sortable?: boolean;
   resizable?: boolean;
-  children: (ctx: DataSheetCellContext<T>) => JSX.Element;
+  children: (ctx: DataSheetCellContext<TItem>) => JSX.Element;
 }
 
-export interface DataSheetCellContext<T> {
-  item: T;
+export interface DataSheetCellContext<TItem> {
+  item: TItem;
   index: number;
   depth: number;
 }
@@ -84,7 +84,7 @@ export interface DataSheetConfigColumn {
   hidden?: boolean;
 }
 
-export interface DataSheetColumnDef<T> {
+export interface DataSheetColumnDef<TItem> {
   __type: "sheet-column";
   key: string;
   header: string[];
@@ -99,7 +99,7 @@ export interface DataSheetColumnDef<T> {
   class?: string;
   sortable: boolean;
   resizable: boolean;
-  cell: (ctx: DataSheetCellContext<T>) => JSX.Element;
+  cell: (ctx: DataSheetCellContext<TItem>) => JSX.Element;
 }
 
 export interface HeaderDef {
@@ -114,21 +114,21 @@ export interface HeaderDef {
   headerContent?: () => JSX.Element;
 }
 
-export interface FlatItem<T> {
-  item: T;
+export interface FlatItem<TItem> {
+  item: TItem;
   index: number;
   depth: number;
   hasChildren: boolean;
-  parent?: T;
+  parent?: TItem;
 }
 
 // 드래그 앤 드롭 위치
 export type DataSheetDragPosition = "before" | "after" | "inside";
 
 // 재정렬 이벤트
-export interface DataSheetReorderEvent<T> {
-  item: T;
-  targetItem: T;
+export interface DataSheetReorderEvent<TItem> {
+  item: TItem;
+  targetItem: TItem;
   position: DataSheetDragPosition;
 }
 

package/src/components/disclosure/DialogInstanceContext.ts

@@ -1,11 +1,11 @@
 import { createContext, useContext } from "solid-js";
 
-export interface DialogInstance<T> {
-  close: (result?: T) => void;
+export interface DialogInstance<TResult> {
+  close: (result?: TResult) => void;
 }
 
 export const DialogInstanceContext = createContext<DialogInstance<unknown>>();
 
-export function useDialogInstance<T = undefined>(): DialogInstance<T> | undefined {
-  return useContext(DialogInstanceContext) as DialogInstance<T> | undefined;
+export function useDialogInstance<TResult = undefined>(): DialogInstance<TResult> | undefined {
+  return useContext(DialogInstanceContext) as DialogInstance<TResult> | undefined;
 }

package/src/components/form-control/checkbox/CheckboxGroup.tsx

@@ -4,9 +4,9 @@ import { createControllableSignal } from "../../../hooks/createControllableSigna
 import { Checkbox } from "./Checkbox";
 import type { CheckboxSize, CheckboxTheme } from "./Checkbox.styles";
 
-interface CheckboxGroupContextValue<T> {
-  value: () => T[];
-  toggle: (item: T) => void;
+interface CheckboxGroupContextValue<TValue> {
+  value: () => TValue[];
+  toggle: (item: TValue) => void;
   disabled: () => boolean;
   size: () => CheckboxSize | undefined;
   theme: () => CheckboxTheme | undefined;
@@ -18,13 +18,13 @@ const CheckboxGroupContext = createContext<CheckboxGroupContextValue<any>>();
 
 // --- CheckboxGroup.Item ---
 
-interface CheckboxGroupItemProps<T> {
-  value: T;
+interface CheckboxGroupItemProps<TValue> {
+  value: TValue;
   disabled?: boolean;
   children?: JSX.Element;
 }
 
-function CheckboxGroupItemInner<T>(props: CheckboxGroupItemProps<T>) {
+function CheckboxGroupItemInner<TValue>(props: CheckboxGroupItemProps<TValue>) {
   const ctx = useContext(CheckboxGroupContext);
   if (!ctx) throw new Error("CheckboxGroup.Item은 CheckboxGroup 내부에서만 사용할 수 있습니다");
 
@@ -47,9 +47,9 @@ function CheckboxGroupItemInner<T>(props: CheckboxGroupItemProps<T>) {
 
 // --- CheckboxGroup ---
 
-interface CheckboxGroupProps<T> {
-  value?: T[];
-  onValueChange?: (value: T[]) => void;
+interface CheckboxGroupProps<TValue> {
+  value?: TValue[];
+  onValueChange?: (value: TValue[]) => void;
   disabled?: boolean;
   size?: CheckboxSize;
   theme?: CheckboxTheme;
@@ -61,7 +61,7 @@ interface CheckboxGroupProps<T> {
 }
 
 interface CheckboxGroupComponent {
-  <T = unknown>(props: CheckboxGroupProps<T>): JSX.Element;
+  <TValue = unknown>(props: CheckboxGroupProps<TValue>): JSX.Element;
   Item: typeof CheckboxGroupItemInner;
 }
 

package/src/components/form-control/checkbox/RadioGroup.tsx

@@ -4,9 +4,9 @@ import { createControllableSignal } from "../../../hooks/createControllableSigna
 import { Radio } from "./Radio";
 import type { CheckboxSize, CheckboxTheme } from "./Checkbox.styles";
 
-interface RadioGroupContextValue<T> {
-  value: () => T | undefined;
-  select: (item: T) => void;
+interface RadioGroupContextValue<TValue> {
+  value: () => TValue | undefined;
+  select: (item: TValue) => void;
   disabled: () => boolean;
   size: () => CheckboxSize | undefined;
   theme: () => CheckboxTheme | undefined;
@@ -18,13 +18,13 @@ const RadioGroupContext = createContext<RadioGroupContextValue<any>>();
 
 // --- RadioGroup.Item ---
 
-interface RadioGroupItemProps<T> {
-  value: T;
+interface RadioGroupItemProps<TValue> {
+  value: TValue;
   disabled?: boolean;
   children?: JSX.Element;
 }
 
-function RadioGroupItemInner<T>(props: RadioGroupItemProps<T>) {
+function RadioGroupItemInner<TValue>(props: RadioGroupItemProps<TValue>) {
   const ctx = useContext(RadioGroupContext);
   if (!ctx) throw new Error("RadioGroup.Item은 RadioGroup 내부에서만 사용할 수 있습니다");
 
@@ -47,9 +47,9 @@ function RadioGroupItemInner<T>(props: RadioGroupItemProps<T>) {
 
 // --- RadioGroup ---
 
-interface RadioGroupProps<T> {
-  value?: T;
-  onValueChange?: (value: T) => void;
+interface RadioGroupProps<TValue> {
+  value?: TValue;
+  onValueChange?: (value: TValue) => void;
   disabled?: boolean;
   size?: CheckboxSize;
   theme?: CheckboxTheme;
@@ -61,7 +61,7 @@ interface RadioGroupProps<T> {
 }
 
 interface RadioGroupComponent {
-  <T = unknown>(props: RadioGroupProps<T>): JSX.Element;
+  <TValue = unknown>(props: RadioGroupProps<TValue>): JSX.Element;
   Item: typeof RadioGroupItemInner;
 }
 

package/src/components/form-control/combobox/Combobox.tsx

@@ -28,8 +28,8 @@ const noResultsClass = clsx("px-3 py-2", textMuted);
 /**
  * Combobox 아이템 렌더링 템플릿
  */
-interface ComboboxItemTemplateProps<T> {
-  children: (item: T, index: number) => JSX.Element;
+interface ComboboxItemTemplateProps<TItem> {
+  children: (item: TItem, index: number) => JSX.Element;
 }
 
 // 템플릿 함수를 저장하는 전역 WeakMap
@@ -46,15 +46,15 @@ const ComboboxItemTemplate = <T,>(props: ComboboxItemTemplateProps<T>) => (
 );
 
 // Props 정의
-export interface ComboboxProps<T = unknown> {
+export interface ComboboxProps<TValue = unknown> {
   /** 현재 선택된 값 */
-  value?: T;
+  value?: TValue;
 
   /** 값 변경 콜백 */
-  onValueChange?: (value: T) => void;
+  onValueChange?: (value: TValue) => void;
 
   /** 아이템 로드 함수 (필수) */
-  loadItems: (query: string) => Promise<T[]>;
+  loadItems: (query: string) => Promise<TValue[]>;
 
   /** 디바운스 딜레이 (기본값: 300ms) */
   debounceMs?: number;
@@ -63,10 +63,10 @@ export interface ComboboxProps<T = unknown> {
   allowCustomValue?: boolean;
 
   /** 커스텀 값 파싱 함수 */
-  parseCustomValue?: (text: string) => T;
+  parseCustomValue?: (text: string) => TValue;
 
   /** 선택된 값을 렌더링하는 함수 (필수) */
-  renderValue: (value: T) => JSX.Element;
+  renderValue: (value: TValue) => JSX.Element;
 
   /** 비활성화 */
   disabled?: boolean;
@@ -94,7 +94,7 @@ export interface ComboboxProps<T = unknown> {
 }
 
 interface ComboboxComponent {
-  <T = unknown>(props: ComboboxProps<T>): JSX.Element;
+  <TValue = unknown>(props: ComboboxProps<TValue>): JSX.Element;
   Item: typeof ComboboxItem;
   ItemTemplate: typeof ComboboxItemTemplate;
 }

package/src/components/form-control/combobox/ComboboxContext.ts

@@ -1,11 +1,11 @@
 import { createContext, useContext } from "solid-js";
 
-export interface ComboboxContextValue<T = unknown> {
+export interface ComboboxContextValue<TValue = unknown> {
   /** 값이 선택되어 있는지 확인 */
-  isSelected: (value: T) => boolean;
+  isSelected: (value: TValue) => boolean;
 
   /** 값 선택 */
-  selectValue: (value: T) => void;
+  selectValue: (value: TValue) => void;
 
   /** 드롭다운 닫기 */
   closeDropdown: () => void;
@@ -13,10 +13,10 @@ export interface ComboboxContextValue<T = unknown> {
 
 export const ComboboxContext = createContext<ComboboxContextValue>();
 
-export function useComboboxContext<T = unknown>(): ComboboxContextValue<T> {
+export function useComboboxContext<TValue = unknown>(): ComboboxContextValue<TValue> {
   const context = useContext(ComboboxContext);
   if (!context) {
     throw new Error("useComboboxContext는 Combobox 컴포넌트 내부에서만 사용할 수 있습니다");
   }
-  return context as ComboboxContextValue<T>;
+  return context as ComboboxContextValue<TValue>;
 }

package/src/components/form-control/combobox/ComboboxItem.tsx

@@ -11,12 +11,12 @@ import {
 
 void ripple;
 
-export interface ComboboxItemProps<T = unknown> extends Omit<
+export interface ComboboxItemProps<TValue = unknown> extends Omit<
   JSX.ButtonHTMLAttributes<HTMLButtonElement>,
   "value" | "onClick"
 > {
   /** 아이템의 값 */
-  value: T;
+  value: TValue;
 
   /** 비활성화 */
   disabled?: boolean;

package/src/components/form-control/select/Select.tsx

@@ -65,8 +65,8 @@ const SelectHeader: ParentComponent = (props) => <div data-select-header>{props.
  *
  * 함수 참조를 저장하기 위해 전역 Map 사용
  */
-interface SelectItemTemplateProps<T> {
-  children: (item: T, index: number, depth: number) => JSX.Element;
+interface SelectItemTemplateProps<TValue> {
+  children: (item: TValue, index: number, depth: number) => JSX.Element;
 }
 
 // 템플릿 함수를 저장하는 전역 Map (WeakMap 사용하여 메모리 누수 방지)
@@ -109,15 +109,15 @@ interface SelectCommonProps {
 }
 
 // 단일 선택 Props
-interface SelectSingleBaseProps<T> extends SelectCommonProps {
+interface SelectSingleBaseProps<TValue> extends SelectCommonProps {
   /** 다중 선택 모드 */
   multiple?: false;
 
   /** 현재 선택된 값 */
-  value?: T;
+  value?: TValue;
 
   /** 값 변경 콜백 */
-  onValueChange?: (value: T) => void;
+  onValueChange?: (value: TValue) => void;
 
   /** 다중 선택 시 표시 방향 (단일 선택에서는 사용 안 함) */
   multiDisplayDirection?: never;
@@ -127,15 +127,15 @@ interface SelectSingleBaseProps<T> extends SelectCommonProps {
 }
 
 // 다중 선택 Props
-interface SelectMultipleBaseProps<T> extends SelectCommonProps {
+interface SelectMultipleBaseProps<TValue> extends SelectCommonProps {
   /** 다중 선택 모드 */
   multiple: true;
 
   /** 현재 선택된 값 */
-  value?: T[];
+  value?: TValue[];
 
   /** 값 변경 콜백 */
-  onValueChange?: (value: T[]) => void;
+  onValueChange?: (value: TValue[]) => void;
 
   /** 다중 선택 시 표시 방향 */
   multiDisplayDirection?: "horizontal" | "vertical";
@@ -145,29 +145,29 @@ interface SelectMultipleBaseProps<T> extends SelectCommonProps {
 }
 
 // items 방식
-interface SelectWithItemsPropsBase<T> {
-  items: T[];
-  getChildren?: (item: T, index: number, depth: number) => T[] | undefined;
-  renderValue?: (value: T) => JSX.Element;
+interface SelectWithItemsPropsBase<TValue> {
+  items: TValue[];
+  getChildren?: (item: TValue, index: number, depth: number) => TValue[] | undefined;
+  renderValue?: (value: TValue) => JSX.Element;
   children?: JSX.Element;
 }
 
 // children 방식
-interface SelectWithChildrenPropsBase<T> {
+interface SelectWithChildrenPropsBase<TValue> {
   items?: never;
   getChildren?: never;
-  renderValue: (value: T) => JSX.Element;
+  renderValue: (value: TValue) => JSX.Element;
   children: JSX.Element;
 }
 
-export type SelectProps<T = unknown> =
-  | (SelectSingleBaseProps<T> & SelectWithItemsPropsBase<T>)
-  | (SelectSingleBaseProps<T> & SelectWithChildrenPropsBase<T>)
-  | (SelectMultipleBaseProps<T> & SelectWithItemsPropsBase<T>)
-  | (SelectMultipleBaseProps<T> & SelectWithChildrenPropsBase<T>);
+export type SelectProps<TValue = unknown> =
+  | (SelectSingleBaseProps<TValue> & SelectWithItemsPropsBase<TValue>)
+  | (SelectSingleBaseProps<TValue> & SelectWithChildrenPropsBase<TValue>)
+  | (SelectMultipleBaseProps<TValue> & SelectWithItemsPropsBase<TValue>)
+  | (SelectMultipleBaseProps<TValue> & SelectWithChildrenPropsBase<TValue>);
 
 interface SelectComponent {
-  <T = unknown>(props: SelectProps<T>): JSX.Element;
+  <TValue = unknown>(props: SelectProps<TValue>): JSX.Element;
   Item: typeof SelectItem;
   Action: typeof SelectAction;
   Header: typeof SelectHeader;

package/src/components/form-control/select/SelectContext.ts

@@ -1,14 +1,14 @@
 import { createContext, useContext, type Accessor } from "solid-js";
 
-export interface SelectContextValue<T = unknown> {
+export interface SelectContextValue<TValue = unknown> {
   /** 다중 선택 모드 여부 */
   multiple: Accessor<boolean>;
 
   /** 값이 선택되어 있는지 확인 */
-  isSelected: (value: T) => boolean;
+  isSelected: (value: TValue) => boolean;
 
   /** 값 선택/해제 토글 */
-  toggleValue: (value: T) => void;
+  toggleValue: (value: TValue) => void;
 
   /** 드롭다운 닫기 */
   closeDropdown: () => void;
@@ -16,10 +16,10 @@ export interface SelectContextValue<T = unknown> {
 
 export const SelectContext = createContext<SelectContextValue>();
 
-export function useSelectContext<T = unknown>(): SelectContextValue<T> {
+export function useSelectContext<TValue = unknown>(): SelectContextValue<TValue> {
   const context = useContext(SelectContext);
   if (!context) {
     throw new Error("useSelectContext는 Select 컴포넌트 내부에서만 사용할 수 있습니다");
   }
-  return context as SelectContextValue<T>;
+  return context as SelectContextValue<TValue>;
 }