npm - @simplysm/solid - Versions diffs - 13.0.69 → 13.0.70 - Mend

@simplysm/solid 13.0.69 → 13.0.70

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (477) hide show

package/src/providers/ThemeContext.tsx CHANGED Viewed

@@ -10,68 +10,68 @@ import { createMediaQuery } from "@solid-primitives/media";
 import { useSyncConfig } from "../hooks/useSyncConfig";
 /**
- * 테마 모드
- * - `light`: 라이트 모드
- * - `dark`: 다크 모드
- * - `system`: 시스템 설정 따름
+ * Theme mode.
+ * - `light`: Light mode
+ * - `dark`: Dark mode
+ * - `system`: Follows system setting
  */
 export type ThemeMode = "light" | "dark" | "system";
 /**
- * 실제 적용되는 테마 (system일 때 OS 설정에 따라 결정)
+ * Resolved theme (determined by OS setting when mode is system)
  */
 export type ResolvedTheme = "light" | "dark";
 interface ThemeContextValue {
-  /** 현재 테마 모드 (사용자 선택값) */
+  /** Current theme mode (user selection) */
   mode: () => ThemeMode;
-  /** 테마 모드 설정 */
+  /** Set theme mode */
   setMode: (mode: ThemeMode) => void;
-  /** 실제 적용되는 테마 (system일 때 OS 설정 따름) */
+  /** Resolved theme (follows OS setting when mode is system) */
   resolvedTheme: () => ResolvedTheme;
-  /** 다음 모드로 순환 (light → system → dark → light) */
+  /** Cycle to next mode (light -> system -> dark -> light) */
   cycleMode: () => void;
 }
 const ThemeContext = createContext<ThemeContextValue>();
 /**
- * 테마 Context에 접근하는 훅
+ * Hook to access the theme Context.
  *
- * @throws ThemeProvider가 없으면 에러 발생
+ * @throws Throws an error if ThemeProvider is not present
  *
  * @example
  * ```tsx
  * const { mode, setMode, resolvedTheme, cycleMode } = useTheme();
  *
- * // 현재 모드 확인
+ * // Check current mode
  * console.log(mode()); // "light" | "dark" | "system"
  *
- * // 실제 적용 테마 확인
+ * // Check resolved theme
  * console.log(resolvedTheme()); // "light" | "dark"
  *
- * // 모드 변경
+ * // Change mode
  * setMode("dark");
  *
- * // 순환 (토글 버튼용)
- * cycleMode(); // light → system → dark → light
+ * // Cycle (for toggle button)
+ * cycleMode(); // light -> system -> dark -> light
  * ```
  */
 export function useTheme(): ThemeContextValue {
   const context = useContext(ThemeContext);
   if (!context) {
-    throw new Error("useTheme는 ThemeProvider 내부에서만 사용할 수 있습니다");
+    throw new Error("useTheme can only be used inside ThemeProvider");
   }
   return context;
 }
 /**
- * 테마 Provider 컴포넌트
+ * Theme Provider component.
  *
  * @remarks
- * - ConfigContext.Provider 내부에서 사용해야 함 (useSyncConfig 의존)
- * - localStorage에 테마 설정 저장
- * - `<html>` 요소에 `dark` 클래스 자동 토글
+ * - Must be used inside ConfigContext.Provider (depends on useSyncConfig)
+ * - Persists theme setting to localStorage
+ * - Automatically toggles `dark` class on the `<html>` element
  *
  * @example
  * ```tsx
@@ -85,10 +85,10 @@ export function useTheme(): ThemeContextValue {
 export const ThemeProvider: ParentComponent = (props) => {
   const [mode, setMode, ready] = useSyncConfig<ThemeMode>("theme", "system");
-  // OS 다크모드 감지
+  // Detect OS dark mode
   const prefersDark = createMediaQuery("(prefers-color-scheme: dark)");
-  // 실제 적용 테마 계산
+  // Calculate resolved theme
   const resolvedTheme = createMemo<ResolvedTheme>(() => {
     const currentMode = mode();
     if (currentMode === "system") {
@@ -97,7 +97,7 @@ export const ThemeProvider: ParentComponent = (props) => {
     return currentMode;
   });
-  // 다음 모드로 순환
+  // Cycle to next mode
   const cycleMode = () => {
     const current = mode();
     const next: ThemeMode =
@@ -105,14 +105,14 @@ export const ThemeProvider: ParentComponent = (props) => {
     setMode(next);
   };
-  // <html>에 dark 클래스 토글
+  // Toggle dark class on <html>
   createEffect(() => {
     if (!ready()) return; // Don't apply theme until storage has been read
     const isDark = resolvedTheme() === "dark";
     document.documentElement.classList.toggle("dark", isDark);
   });
-  // cleanup 시 dark 클래스 제거
+  // Remove dark class on cleanup
   onCleanup(() => {
     document.documentElement.classList.remove("dark");
   });

package/src/providers/i18n/I18nContext.tsx ADDED Viewed

@@ -0,0 +1,129 @@
+import {
+  createContext,
+  useContext,
+  type ParentComponent,
+  createSignal,
+  createMemo,
+} from "solid-js";
+import type { I18nContextValue, I18nConfigureOptions, FlatDict } from "./I18nContext.types";
+import { flattenDict, mergeDict, interpolate } from "./i18nUtils";
+import enDict from "./locales/en";
+import koDict from "./locales/ko";
+import { useSyncConfig } from "../../hooks/useSyncConfig";
+/**
+ * I18n Context
+ */
+const I18nContext = createContext<I18nContextValue>();
+/**
+ * Detect locale from navigator.language
+ * "ko-KR" → "ko", "en-US" → "en", etc.
+ */
+function detectLocaleFromNavigator(): string {
+  const lang = navigator.language.split("-")[0];
+  return ["ko", "en"].includes(lang) ? lang : "en";
+}
+/**
+ * Get i18n context value
+ *
+ * @throws Throws error if I18nProvider is not present
+ */
+export function useI18n(): I18nContextValue {
+  const context = useContext(I18nContext);
+  if (!context) {
+    throw new Error("useI18n can only be used inside I18nProvider");
+  }
+  return context;
+}
+/**
+ * Get i18n context value (optional, returns undefined if not in provider)
+ */
+export function useI18nOptional(): I18nContextValue | undefined {
+  return useContext(I18nContext);
+}
+/**
+ * I18n Provider component
+ *
+ * @remarks
+ * - Provides i18n context with t(), locale, setLocale, configure
+ * - Built-in dictionaries: en, ko (nested, flattened at runtime)
+ * - localStorage persistence via @simplysm/solid useSyncConfig pattern
+ * - Apps can override/extend dicts via configure()
+ *
+ * @example
+ * ```tsx
+ * <I18nProvider>
+ *   <App />
+ * </I18nProvider>
+ *
+ * // Later in app:
+ * const { t, setLocale, configure } = useI18n();
+ *
+ * // Change locale
+ * setLocale("ko");
+ *
+ * // Or override/add languages
+ * configure({
+ *   locale: "ja",
+ *   dict: {
+ *     ja: { "calendar.weeks.sun": "日" },
+ *   },
+ * });
+ * ```
+ */
+export const I18nProvider: ParentComponent = (props) => {
+  // Flatten built-in dictionaries
+  const builtInDicts: Record<string, FlatDict> = {
+    en: flattenDict(enDict),
+    ko: flattenDict(koDict),
+  };
+  // State for active locale and loaded dictionaries
+  const [locale, setLocale] = useSyncConfig<string>("i18n-locale", detectLocaleFromNavigator());
+  const [dicts, setDicts] = createSignal<Record<string, FlatDict>>(builtInDicts);
+  // Current dictionary (locale-specific)
+  const currentDict = createMemo(() => {
+    const current = locale();
+    return dicts()[current] ?? dicts()["en"];
+  });
+  // Translate function
+  const t = (key: string, params?: Record<string, string>): string => {
+    const dict = currentDict();
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    const template = dict[key] ?? dicts()["en"][key] ?? key;
+    return interpolate(template, params);
+  };
+  // Configure function (cumulative merge)
+  const configure = (options: I18nConfigureOptions) => {
+    if (options.locale !== undefined) {
+      setLocale(options.locale);
+    }
+    if (options.dict !== undefined) {
+      setDicts((prevDicts) => {
+        const newDicts = { ...prevDicts };
+        for (const [loc, nestedDict] of Object.entries(options.dict!)) {
+          const flattened = flattenDict(nestedDict);
+          newDicts[loc] = mergeDict(newDicts[loc] ?? {}, flattened);
+        }
+        return newDicts;
+      });
+    }
+  };
+  const contextValue: I18nContextValue = {
+    t,
+    locale,
+    setLocale,
+    configure,
+  };
+  return <I18nContext.Provider value={contextValue}>{props.children}</I18nContext.Provider>;
+};

package/src/providers/i18n/I18nContext.types.ts ADDED Viewed

@@ -0,0 +1,30 @@
+import type { Accessor } from "solid-js";
+/**
+ * I18n context value
+ */
+export interface I18nContextValue {
+  /** Translate function */
+  t: (key: string, params?: Record<string, string>) => string;
+  /** Current active locale (reactive) */
+  locale: Accessor<string>;
+  /** Set active locale */
+  setLocale: (locale: string) => void;
+  /** Configure dictionary and locale */
+  configure: (options: I18nConfigureOptions) => void;
+}
+/**
+ * I18n configure options
+ */
+export interface I18nConfigureOptions {
+  /** Active locale (if omitted, current locale is kept) */
+  locale?: string;
+  /** Nested dictionaries to merge into built-in dicts */
+  dict?: Record<string, Record<string, unknown>>;
+}
+/**
+ * Flattened i18n dictionary
+ */
+export type FlatDict = Record<string, string>;

package/src/providers/i18n/i18nUtils.ts ADDED Viewed

@@ -0,0 +1,38 @@
+/**
+ * Flatten nested object to dot-notation keys
+ * @example
+ * flatten({ a: { b: { c: "value" } } })
+ * // { "a.b.c": "value" }
+ */
+export function flattenDict(obj: Record<string, unknown>, prefix = ""): Record<string, string> {
+  const result: Record<string, string> = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const fullKey = prefix ? `${prefix}.${key}` : key;
+    if (typeof value === "string") {
+      result[fullKey] = value;
+    } else if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+      Object.assign(result, flattenDict(value as Record<string, unknown>, fullKey));
+    }
+  }
+  return result;
+}
+/**
+ * Merge two flat dictionaries (b overwrites a)
+ */
+export function mergeDict(a: Record<string, string>, b: Record<string, string>): Record<string, string> {
+  return { ...a, ...b };
+}
+/**
+ * Interpolate template with {{key}} syntax
+ * @example
+ * interpolate("Hello {{name}}", { name: "World" }) // "Hello World"
+ */
+export function interpolate(template: string, params?: Record<string, string>): string {
+  if (!params) return template;
+  return template.replace(/\{\{(\w+)\}\}/g, (_, key) => params[key] || `{{${key}}}`);
+}

package/src/providers/i18n/locales/en.ts ADDED Viewed

@@ -0,0 +1,161 @@
+export default {
+  calendar: {
+    weeks: {
+      sun: "Sun",
+      mon: "Mon",
+      tue: "Tue",
+      wed: "Wed",
+      thu: "Thu",
+      fri: "Fri",
+      sat: "Sat",
+    },
+  },
+  dataSheet: {
+    collapseAll: "Collapse all",
+    expandAll: "Expand all",
+    sheetSettings: "Sheet Settings",
+  },
+  dataSheetConfigDialog: {
+    column: "Column",
+    fixed: "Fixed",
+    hidden: "Hidden",
+    width: "Width",
+    autoPlaceholder: "auto",
+    resetConfirm: "Are you sure you want to reset all sheet settings?",
+    reset: "Reset",
+    cancel: "Cancel",
+    confirm: "Confirm",
+  },
+  dateRangePicker: {
+    day: "Day",
+    month: "Month",
+    range: "Range",
+  },
+  select: {
+    searchPlaceholder: "Search...",
+    selectAll: "Select all",
+    deselectAll: "Deselect all",
+    unset: "Unset",
+  },
+  topbar: {
+    toggleSidebar: "Toggle sidebar",
+  },
+  sidebar: {
+    closeSidebar: "Close sidebar",
+  },
+  editorToolbar: {
+    heading1: "Heading 1",
+    heading2: "Heading 2",
+    bold: "Bold",
+    italic: "Italic",
+    underline: "Underline",
+    strikethrough: "Strikethrough",
+    textColor: "Text color",
+    bgColor: "Background color",
+    bulletList: "Bullet list",
+    numberedList: "Numbered list",
+    increaseIndent: "Increase indent",
+    decreaseIndent: "Decrease indent",
+    blockquote: "Blockquote",
+    codeBlock: "Code block",
+    alignLeft: "Align left",
+    alignCenter: "Align center",
+    alignRight: "Align right",
+    justify: "Justify",
+    insertTable: "Insert table",
+    insertImage: "Insert image",
+    clearFormatting: "Clear formatting",
+  },
+  statePreset: {
+    addPreset: "Add preset",
+    overwrite: "Overwrite with current state",
+    deletePreset: "Delete preset",
+    namePlaceholder: "Name...",
+    duplicateName: "Duplicate name",
+    duplicateMessage: "A preset with this name already exists.",
+    saved: "Preset saved",
+    savedMessage: "Preset \"{{name}}\" has been saved.",
+    overwritten: "Preset overwritten",
+    overwrittenMessage: "Preset \"{{name}}\" has been updated with the current state.",
+    undo: "Undo",
+    deleted: "Preset deleted",
+    deletedMessage: "Preset \"{{name}}\" has been deleted.",
+  },
+  permissionTable: {
+    permissionItem: "Permission Item",
+  },
+  crudSheet: {
+    save: "Save",
+    refresh: "Refresh",
+    search: "Search",
+    addRow: "Add Row",
+    register: "Register",
+    deleteSelected: "Delete Selected",
+    restoreSelected: "Restore Selected",
+    excelUpload: "Excel Upload",
+    excelDownload: "Excel Download",
+    deselect: "Deselect",
+    deselectAll: "Deselect All",
+    confirm: "Confirm",
+    lastModified: "Last Modified",
+    modifiedBy: "Modified By",
+    notice: "Notice",
+    noChanges: "No changes to save.",
+    saveCompleted: "Save completed",
+    saveSuccess: "Saved successfully.",
+    deleteCompleted: "Delete completed",
+    deleteSuccess: "Deleted successfully.",
+    restoreCompleted: "Restore completed",
+    restoreSuccess: "Restored successfully.",
+    excelCompleted: "Completed",
+    excelUploadSuccess: "Excel upload completed successfully.",
+    lookupFailed: "Lookup failed",
+    saveFailed: "Save failed",
+    deleteFailed: "Delete failed",
+    restoreFailed: "Restore failed",
+    excelDownloadFailed: "Excel download failed",
+    excelUploadFailed: "Excel upload failed",
+    discardChanges: "You have unsaved changes. Discard them?",
+  },
+  crudDetail: {
+    save: "Save",
+    delete: "Delete",
+    restore: "Restore",
+    refresh: "Refresh",
+    confirm: "Confirm",
+    lastModified: "Last modified",
+    discardChanges: "Discard changes?",
+    lookupFailed: "Lookup failed",
+    notice: "Notice",
+    noChanges: "No changes to save.",
+    saveCompleted: "Save completed",
+    saveSuccess: "Saved successfully.",
+    saveFailed: "Save failed",
+    deleteCompleted: "Delete completed",
+    deleteSuccess: "Deleted successfully.",
+    deleteFailed: "Delete failed",
+    restoreCompleted: "Restore completed",
+    restoreSuccess: "Restored successfully.",
+    restoreFailed: "Restore failed",
+  },
+  sharedDataSelect: {
+    search: "Search",
+    edit: "Edit",
+  },
+  sharedDataSelectList: {
+    searchPlaceholder: "Search...",
+  },
+  dataSelectButton: {
+    deselect: "Deselect",
+    search: "Search",
+  },
+  dialog: {
+    close: "Close dialog",
+  },
+  notification: {
+    close: "Close notification",
+  },
+  topbarMenu: {
+    menu: "Menu",
+  },
+};

package/src/providers/i18n/locales/ko.ts ADDED Viewed

@@ -0,0 +1,161 @@
+export default {
+  calendar: {
+    weeks: {
+      sun: "일",
+      mon: "월",
+      tue: "화",
+      wed: "수",
+      thu: "목",
+      fri: "금",
+      sat: "토",
+    },
+  },
+  dataSheet: {
+    collapseAll: "전체 접기",
+    expandAll: "전체 펼치기",
+    sheetSettings: "시트 설정",
+  },
+  dataSheetConfigDialog: {
+    column: "컬럼",
+    fixed: "고정",
+    hidden: "숨김",
+    width: "너비",
+    autoPlaceholder: "자동",
+    resetConfirm: "모든 시트 설정을 초기화하시겠습니까?",
+    reset: "초기화",
+    cancel: "취소",
+    confirm: "확인",
+  },
+  dateRangePicker: {
+    day: "일",
+    month: "월",
+    range: "범위",
+  },
+  select: {
+    searchPlaceholder: "검색...",
+    selectAll: "전체 선택",
+    deselectAll: "전체 선택 해제",
+    unset: "미설정",
+  },
+  topbar: {
+    toggleSidebar: "사이드바 토글",
+  },
+  sidebar: {
+    closeSidebar: "사이드바 닫기",
+  },
+  editorToolbar: {
+    heading1: "제목 1",
+    heading2: "제목 2",
+    bold: "굵게",
+    italic: "기울임",
+    underline: "밑줄",
+    strikethrough: "취소선",
+    textColor: "텍스트 색상",
+    bgColor: "배경색",
+    bulletList: "글머리 목록",
+    numberedList: "번호 목록",
+    increaseIndent: "들여쓰기 증가",
+    decreaseIndent: "들여쓰기 감소",
+    blockquote: "인용구",
+    codeBlock: "코드 블록",
+    alignLeft: "왼쪽 정렬",
+    alignCenter: "중앙 정렬",
+    alignRight: "오른쪽 정렬",
+    justify: "양쪽 정렬",
+    insertTable: "표 삽입",
+    insertImage: "이미지 삽입",
+    clearFormatting: "서식 지우기",
+  },
+  statePreset: {
+    addPreset: "프리셋 추가",
+    overwrite: "현재 상태로 덮어쓰기",
+    deletePreset: "프리셋 삭제",
+    namePlaceholder: "이름...",
+    duplicateName: "중복된 이름",
+    duplicateMessage: "이 이름의 프리셋이 이미 존재합니다.",
+    saved: "프리셋 저장됨",
+    savedMessage: "프리셋 \"{{name}}\"이(가) 저장되었습니다.",
+    overwritten: "프리셋 덮어쓰기됨",
+    overwrittenMessage: "프리셋 \"{{name}}\"이(가) 현재 상태로 업데이트되었습니다.",
+    undo: "실행 취소",
+    deleted: "프리셋 삭제됨",
+    deletedMessage: "프리셋 \"{{name}}\"이(가) 삭제되었습니다.",
+  },
+  permissionTable: {
+    permissionItem: "권한 항목",
+  },
+  crudSheet: {
+    save: "저장",
+    refresh: "새로고침",
+    search: "조회",
+    addRow: "행 추가",
+    register: "등록",
+    deleteSelected: "선택 삭제",
+    restoreSelected: "선택 복원",
+    excelUpload: "엑셀 업로드",
+    excelDownload: "엑셀 다운로드",
+    deselect: "선택 해제",
+    deselectAll: "전체 선택 해제",
+    confirm: "확인",
+    lastModified: "마지막 수정",
+    modifiedBy: "수정자",
+    notice: "알림",
+    noChanges: "저장할 변경 사항이 없습니다.",
+    saveCompleted: "저장 완료",
+    saveSuccess: "저장되었습니다.",
+    deleteCompleted: "삭제 완료",
+    deleteSuccess: "삭제되었습니다.",
+    restoreCompleted: "복원 완료",
+    restoreSuccess: "복원되었습니다.",
+    excelCompleted: "완료",
+    excelUploadSuccess: "엑셀 업로드가 완료되었습니다.",
+    lookupFailed: "조회 실패",
+    saveFailed: "저장 실패",
+    deleteFailed: "삭제 실패",
+    restoreFailed: "복원 실패",
+    excelDownloadFailed: "엑셀 다운로드 실패",
+    excelUploadFailed: "엑셀 업로드 실패",
+    discardChanges: "저장하지 않은 변경 사항이 있습니다. 삭제하시겠습니까?",
+  },
+  crudDetail: {
+    save: "저장",
+    delete: "삭제",
+    restore: "복원",
+    refresh: "새로고침",
+    confirm: "확인",
+    lastModified: "마지막 수정",
+    discardChanges: "변경 사항을 삭제하시겠습니까?",
+    lookupFailed: "조회 실패",
+    notice: "알림",
+    noChanges: "저장할 변경 사항이 없습니다.",
+    saveCompleted: "저장 완료",
+    saveSuccess: "저장되었습니다.",
+    saveFailed: "저장 실패",
+    deleteCompleted: "삭제 완료",
+    deleteSuccess: "삭제되었습니다.",
+    deleteFailed: "삭제 실패",
+    restoreCompleted: "복원 완료",
+    restoreSuccess: "복원되었습니다.",
+    restoreFailed: "복원 실패",
+  },
+  sharedDataSelect: {
+    search: "검색",
+    edit: "편집",
+  },
+  sharedDataSelectList: {
+    searchPlaceholder: "검색...",
+  },
+  dataSelectButton: {
+    deselect: "선택 해제",
+    search: "검색",
+  },
+  dialog: {
+    close: "대화상자 닫기",
+  },
+  notification: {
+    close: "알림 닫기",
+  },
+  topbarMenu: {
+    menu: "메뉴",
+  },
+};

package/src/providers/shared-data/SharedDataChangeEvent.ts CHANGED Viewed

@@ -1,12 +1,12 @@
 import { defineEvent } from "@simplysm/service-common";
 /**
- * SharedData 변경 이벤트 정의
+ * SharedData change event definition.
  *
  * @remarks
- * 서버-클라이언트 간 공유 데이터 변경을 알리는 이벤트.
- * - 이벤트 정보: `{ name: string; filter: unknown }` — 데이터 이름과 필터
- * - 이벤트 데이터: `(string | number)[] | undefined` — 변경된 항목의 key 배열 (undefined면 전체 갱신)
+ * Event that notifies shared data changes between server and client.
+ * - Event info: `{ name: string; filter: unknown }` -- data name and filter
+ * - Event data: `(string | number)[] | undefined` -- array of changed item keys (undefined means full refresh)
  */
 export const SharedDataChangeEvent = defineEvent<
   { name: string; filter: unknown },