@simplysm/solid 13.0.69 → 13.0.71

package/src/providers/shared-data/SharedDataContext.ts

@@ -1,68 +1,68 @@
 import { type Accessor, createContext, useContext } from "solid-js";
 
 /**
- * 공유 데이터 정의
+ * Shared data definition.
  *
  * @remarks
- * SharedDataProvider에 전달하여 서버 데이터 구독을 설정한다.
+ * Passed to SharedDataProvider to set up server data subscriptions.
  */
 export interface SharedDataDefinition<TData> {
-  /** 서비스 연결 key (생략 시 "default") */
+  /** Service connection key (defaults to "default" if omitted) */
   serviceKey?: string;
-  /** 데이터 조회 함수 (changeKeys가 있으면 해당 항목만 부분 갱신) */
+  /** Data fetch function (partial refresh for specified changeKeys only) */
   fetch: (changeKeys?: Array<string | number>) => Promise<TData[]>;
-  /** 항목의 고유 key 추출 함수 */
+  /** Function to extract the unique key from an item */
   getKey: (item: TData) => string | number;
-  /** 정렬 기준 배열 (여러 기준 적용 가능) */
+  /** Sort criteria array (multiple criteria supported) */
   orderBy: [(item: TData) => unknown, "asc" | "desc"][];
-  /** 서버 이벤트 필터 (같은 name의 이벤트 중 filter가 일치하는 것만 수신) */
+  /** Server event filter (receives only events with matching filter among same-name events) */
   filter?: unknown;
-  /** 항목에서 검색 텍스트를 추출하는 함수 */
+  /** Function to extract search text from an item */
   getSearchText?: (item: TData) => string;
-  /** 항목이 숨김 상태인지 판별하는 함수 */
+  /** Function to determine if an item is hidden */
   getIsHidden?: (item: TData) => boolean;
-  /** 항목의 부모 key를 추출하는 함수 (트리 구조 지원) */
+  /** Function to extract parent key from an item (tree structure support) */
   getParentKey?: (item: TData) => string | number | undefined;
 }
 
 /**
- * 공유 데이터 접근자
+ * Shared data accessor.
  *
  * @remarks
- * 각 데이터 key에 대한 반응형 접근 및 변경 알림을 제공한다.
+ * Provides reactive access and change notifications for each data key.
  */
 export interface SharedDataAccessor<TData> {
-  /** 반응형 항목 배열 */
+  /** Reactive items array */
   items: Accessor<TData[]>;
-  /** key로 단일 항목 조회 */
+  /** Get a single item by key */
   get: (key: string | number | undefined) => TData | undefined;
-  /** 서버에 변경 이벤트 전파 (모든 구독자에게 refetch 트리거) */
+  /** Propagate change event to server (triggers refetch for all subscribers) */
   emit: (changeKeys?: Array<string | number>) => Promise<void>;
-  /** 항목의 고유 key 추출 함수 */
+  /** Function to extract the unique key from an item */
   getKey: (item: TData) => string | number;
-  /** 항목에서 검색 텍스트를 추출하는 함수 */
+  /** Function to extract search text from an item */
   getSearchText?: (item: TData) => string;
-  /** 항목이 숨김 상태인지 판별하는 함수 */
+  /** Function to determine if an item is hidden */
   getIsHidden?: (item: TData) => boolean;
-  /** 항목의 부모 key를 추출하는 함수 (트리 구조 지원) */
+  /** Function to extract parent key from an item (tree structure support) */
   getParentKey?: (item: TData) => string | number | undefined;
 }
 
 /**
- * 공유 데이터 Context 값
+ * Shared data context value.
  *
  * @remarks
- * - configure 호출 전: wait, busy, configure만 접근 가능. 데이터 접근 시 throw
- * - configure 호출 후: 각 데이터 key별 SharedDataAccessor와 전체 상태 관리 메서드 포함
+ * - Before configure: only wait, busy, configure are accessible. Data access throws
+ * - After configure: includes SharedDataAccessor per data key and overall state management methods
  */
 export type SharedDataValue<TSharedData extends Record<string, unknown>> = {
   [K in keyof TSharedData]: SharedDataAccessor<TSharedData[K]>;
 } & {
-  /** 모든 초기 fetch 완료까지 대기 */
+  /** Wait until all initial fetches complete */
   wait: () => Promise<void>;
-  /** fetch 진행 중 여부 */
+  /** Whether a fetch is in progress */
   busy: Accessor<boolean>;
-  /** definitions를 설정하여 데이터 구독 시작 (decorator 패턴) */
+  /** Set definitions to start data subscriptions (decorator pattern) */
   configure: (
     fn: (origin: {
       [K in keyof TSharedData]: SharedDataDefinition<TSharedData[K]>;
@@ -72,20 +72,20 @@ export type SharedDataValue<TSharedData extends Record<string, unknown>> = {
   ) => void;
 };
 
-/** 공유 데이터 Context */
+/** Shared data Context */
 export const SharedDataContext = createContext<SharedDataValue<Record<string, unknown>>>();
 
 /**
- * 공유 데이터에 접근하는 훅
+ * Hook to access shared data.
  *
- * @throws SharedDataProvider가 없으면 에러 발생
+ * @throws Throws an error if SharedDataProvider is not present
  */
 export function useSharedData<
   TSharedData extends Record<string, unknown> = Record<string, unknown>,
 >(): SharedDataValue<TSharedData> {
   const context = useContext(SharedDataContext);
   if (!context) {
-    throw new Error("useSharedData는 SharedDataProvider 내부에서만 사용할 수 있습니다");
+    throw new Error("useSharedData can only be used inside SharedDataProvider");
   }
   return context as unknown as SharedDataValue<TSharedData>;
 }

package/src/providers/shared-data/SharedDataProvider.tsx

@@ -12,16 +12,16 @@ import { useNotification } from "../../components/feedback/notification/Notifica
 import { useLogger } from "../../hooks/useLogger";
 
 /**
- * 공유 데이터 Provider
+ * Shared data Provider.
  *
  * @remarks
- * - ServiceClientProvider와 NotificationProvider 내부에서 사용해야 함
- * - LoggerProvider가 있으면 fetch 실패를 로거에도 기록
- * - configure() 호출 전: wait, busy, configure만 접근 가능. 데이터 접근 시 throw
- * - configure() 호출 후: definitions 등록. 각 key의 items()/get() 첫 접근 시 서버 이벤트 리스너 등록 + fetch (lazy)
- * - 동시 fetch 호출 시 version counter로 데이터 역전 방지
- * - fetch 실패 시 사용자에게 danger 알림 표시
- * - cleanup 시 모든 이벤트 리스너 자동 해제
+ * - Must be used inside ServiceClientProvider and NotificationProvider
+ * - Logs fetch failures to logger if LoggerProvider is present
+ * - Before configure(): only wait, busy, configure are accessible. Data access throws
+ * - After configure(): registers definitions. Registers server event listeners + fetch on first items()/get() access per key (lazy)
+ * - Prevents data inversion on concurrent fetch calls via version counter
+ * - Displays danger notification to the user on fetch failure
+ * - Automatically releases all event listeners on cleanup
  *
  * @example
  * ```tsx
@@ -29,7 +29,7 @@ import { useLogger } from "../../hooks/useLogger";
  *   <App />
  * </SharedDataProvider>
  *
- * // 자식 컴포넌트에서 나중에 설정:
+ * // Configure later in a child component:
  * useSharedData().configure(() => ({
  *   users: {
  *     fetch: async (changeKeys) => fetchUsers(changeKeys),
@@ -73,19 +73,19 @@ export function SharedDataProvider(props: { children: JSX.Element }): JSX.Elemen
     def: SharedDataDefinition<unknown>,
     changeKeys?: Array<string | number>,
   ): Promise<void> {
-    // CR-1: version counter로 동시 호출 시 데이터 역전 방지
+    // CR-1: Prevent data inversion on concurrent calls via version counter
     const currentVersion = (versionMap.get(name) ?? 0) + 1;
     versionMap.set(name, currentVersion);
 
     setBusyCount((c) => c + 1);
     try {
       const signal = signalMap.get(name);
-      if (!signal) throw new Error(`'${name}'에 대한 공유데이터 저장소가 없습니다.`);
+      if (!signal) throw new Error(`No shared data store found for '${name}'.`);
 
       const [, setItems] = signal;
       const resData = await def.fetch(changeKeys);
 
-      // CR-1: 오래된 응답은 무시
+      // CR-1: Ignore stale responses
       if (versionMap.get(name) !== currentVersion) return;
 
       if (!changeKeys) {
@@ -98,11 +98,11 @@ export function SharedDataProvider(props: { children: JSX.Element }): JSX.Elemen
         });
       }
     } catch (err) {
-      // CR-2: fetch 실패 시 사용자에게 알림
+      // CR-2: Notify user on fetch failure
       logger.error(`SharedData '${name}' fetch failed:`, err);
       notification.danger(
-        "공유 데이터 로드 실패",
-        err instanceof Error ? err.message : `'${name}' 데이터를 불러오는 중 오류가 발생했습니다.`,
+        "Shared data load failed",
+        err instanceof Error ? err.message : `Error occurred while loading '${name}' data.`,
       );
     } finally {
       setBusyCount((c) => c - 1);
@@ -110,7 +110,7 @@ export function SharedDataProvider(props: { children: JSX.Element }): JSX.Elemen
   }
 
   async function wait(): Promise<void> {
-    // eslint-disable-next-line solid/reactivity -- waitUntil은 폴링 기반이므로 tracked scope 불필요
+    // eslint-disable-next-line solid/reactivity -- waitUntil is polling-based, so tracked scope is unnecessary
     await waitUntil(() => busyCount() <= 0);
   }
 
@@ -120,7 +120,7 @@ export function SharedDataProvider(props: { children: JSX.Element }): JSX.Elemen
     ) => Record<string, SharedDataDefinition<unknown>>,
   ): void {
     if (configured) {
-      throw new Error("SharedDataProvider: configure()는 1회만 호출할 수 있습니다");
+      throw new Error("SharedDataProvider: configure() can only be called once");
     }
     configured = true;
 
@@ -129,7 +129,7 @@ export function SharedDataProvider(props: { children: JSX.Element }): JSX.Elemen
 
     for (const [name, def] of Object.entries(definitions)) {
       const [items, setItems] = createSignal<unknown[]>([]);
-      // eslint-disable-next-line solid/reactivity -- signal 참조를 Map에 저장하는 것은 반응성 접근이 아님
+      // eslint-disable-next-line solid/reactivity -- Storing signal references in a Map is not a reactive access
       signalMap.set(name, [items, setItems]);
 
       const itemMap = createMemo(() => {
@@ -139,7 +139,7 @@ export function SharedDataProvider(props: { children: JSX.Element }): JSX.Elemen
         }
         return map;
       });
-      // eslint-disable-next-line solid/reactivity -- memo 참조를 Map에 저장하는 것은 반응성 접근이 아님
+      // eslint-disable-next-line solid/reactivity -- Storing memo references in a Map is not a reactive access
       memoMap.set(name, itemMap);
 
       const client = serviceClient.get(def.serviceKey ?? "default");
@@ -211,7 +211,7 @@ export function SharedDataProvider(props: { children: JSX.Element }): JSX.Elemen
 
   const KNOWN_KEYS = new Set(["wait", "busy", "configure"]);
 
-  // Proxy: configure 전 데이터 접근 시 throw
+  // Proxy: throw on data access before configure
   const contextValue = new Proxy(
     { wait, busy, configure } as SharedDataValue<Record<string, unknown>>,
     {
@@ -220,7 +220,7 @@ export function SharedDataProvider(props: { children: JSX.Element }): JSX.Elemen
           return target[prop];
         }
         if (!configured) {
-          throw new Error("SharedDataProvider: configure()를 먼저 호출해야 합니다");
+          throw new Error("SharedDataProvider: configure() must be called first");
         }
         return accessors[prop];
       },

package/src/styles/patterns.styles.ts

@@ -1,7 +1,7 @@
 import clsx from "clsx";
 import { borderDefault, textDefault, textPlaceholder } from "./tokens.styles";
 
-// ── 아이콘 버튼 공통 ──
+// ── Icon Button Common ──
 export const iconButtonBase = clsx(
   "inline-flex items-center justify-center",
   "cursor-pointer",
@@ -13,24 +13,24 @@ export const iconButtonBase = clsx(
   "focus-visible:ring-2",
 );
 
-// ── inset 포커스 아웃라인 (focus-within 버전: Field, TextArea) ──
+// ── Inset Focus Outline (focus-within variant: Field, TextArea) ──
 export const insetFocusOutline = clsx(
   "focus-within:[outline-style:solid]",
   "focus-within:outline-1 focus-within:-outline-offset-1",
   "focus-within:outline-primary-400 dark:focus-within:outline-primary-400",
 );
 
-// ── inset 포커스 아웃라인 (focus 버전: Checkbox, Select trigger) ──
+// ── Inset Focus Outline (focus variant: Checkbox, Select trigger) ──
 export const insetFocusOutlineSelf = clsx(
   "focus:[outline-style:solid]",
   "focus:outline-1 focus:-outline-offset-1",
   "focus:outline-primary-400 dark:focus:outline-primary-400",
 );
 
-// ── inset 기본 레이아웃 ──
+// ── Inset Base Layout ──
 export const insetBase = "w-full rounded-none border-none";
 
-// ── 폼 필드 공통 표면 (배경 + 텍스트 + 테두리 + 포커스) ──
+// ── Form Field Common Surface (background + text + border + focus) ──
 export const fieldSurface = clsx(
   "bg-primary-50 dark:bg-primary-950/30",
   textDefault,
@@ -40,7 +40,7 @@ export const fieldSurface = clsx(
   "focus-within:border-primary-500 dark:focus-within:border-primary-400",
 );
 
-// ── 입력 요소 공통 ──
+// ── Input Element Common ──
 export const inputBase = clsx(
   "min-w-0 flex-1",
   "bg-transparent",

package/src/styles/tokens.styles.ts

@@ -1,11 +1,11 @@
-// ── 테두리 ──
+// ── Border ──
 export const borderDefault = "border-base-200 dark:border-base-700";
 export const borderSubtle = "border-base-200 dark:border-base-700";
 
-// ── 표면 배경 ──
+// ── Surface Background ──
 export const bgSurface = "bg-white dark:bg-base-900";
 
-// ── 텍스트 ──
+// ── Text ──
 export const textDefault = "text-base-900 dark:text-base-100";
 export const textMuted = "text-base-400 dark:text-base-500";
 export const textPlaceholder = "placeholder:text-base-400 dark:placeholder:text-base-500";
@@ -13,7 +13,7 @@ export const textPlaceholder = "placeholder:text-base-400 dark:placeholder:text-
 // ── disabled ──
 export const disabledOpacity = "cursor-default opacity-30 pointer-events-none";
 
-// ── 사이즈 ──
+// ── Size ──
 export type ComponentSize = "xs" | "sm" | "lg" | "xl";
 export type ComponentSizeCompact = "sm" | "lg";
 export const paddingXs = "px-1 py-0";
@@ -21,7 +21,7 @@ export const paddingSm = "px-1.5 py-0.5";
 export const paddingLg = "px-3 py-2";
 export const paddingXl = "px-4 py-3";
 
-// ── 테마 ──
+// ── Theme ──
 export type SemanticTheme = "primary" | "info" | "success" | "warning" | "danger" | "base";
 
 export const themeTokens: Record<

package/tailwind.config.ts

@@ -58,6 +58,6 @@ export default {
   },
   content: [`${__dirname}src/**/*.{ts,tsx}`, `${__dirname}dist/**/*.js`],
   corePlugins: {
-    aspectRatio: false, // Chrome 84 미지원
+    aspectRatio: false, // Not supported in Chrome 84
   },
 };

package/tailwind.css

@@ -26,7 +26,7 @@
     outline: none;
   }
 
-  /* 스크롤바 스타일 */
+  /* Scrollbar styles */
   ::-webkit-scrollbar {
     width: 0.5rem;
     height: 0.5rem;
@@ -49,7 +49,7 @@
     background-color: rgb(0 0 0 / 8%);
   }
 
-  /* 다크모드 스크롤바 - zinc 계열 중립 톤 */
+  /* Dark mode scrollbar - neutral zinc tones */
   .dark ::-webkit-scrollbar-track {
     background-color: rgb(161 161 170 / 10%);
   }
@@ -67,7 +67,7 @@
     background-color: rgb(161 161 170 / 10%);
   }
 
-  /* 텍스트 선택 영역 */
+  /* Text selection area */
   ::selection {
     @apply bg-primary-200 text-primary-900;
   }
@@ -76,7 +76,7 @@
     @apply bg-primary-800 text-primary-100;
   }
 
-  /* 다크모드 날짜/시간 입력 아이콘 */
+  /* Dark mode date/time input icon */
   .dark ::-webkit-calendar-picker-indicator {
     filter: invert(1);
   }