@open-mercato/core 0.6.7 → 0.6.8-develop.6874.1.982d6097d8

package/src/modules/design_system/i18n/es.json

@@ -0,0 +1,58 @@
+{
+  "design_system.entries.button.description": "Disparador de acción principal con toda la escala de variantes y tamaños del DS.",
+  "design_system.entries.buttonGroup.description": "Grupo unido de botones de acción relacionados que comparten un borde.",
+  "design_system.entries.fancyButton.description": "Botón con degradado, de estilo promocional, para acciones destacadas.",
+  "design_system.entries.iconButton.description": "Botón cuadrado solo con icono; siempre requiere un aria-label.",
+  "design_system.entries.linkButton.description": "Enlace de texto con estilo de control del DS.",
+  "design_system.entries.socialButton.description": "Botón de autenticación con colores de marca para inicio de sesión social.",
+  "design_system.families.banners": "Avisos y llamadas",
+  "design_system.families.buttons": "Botones",
+  "design_system.families.charts": "Gráficos",
+  "design_system.families.dates": "Fechas y hora",
+  "design_system.families.detail": "Secciones de detalle",
+  "design_system.families.display": "Visualización de datos",
+  "design_system.families.feedback": "Retroalimentación",
+  "design_system.families.filters": "Filtros",
+  "design_system.families.foundations": "Fundamentos",
+  "design_system.families.icons": "Iconos",
+  "design_system.families.inputs": "Campos de formulario",
+  "design_system.families.messages": "Mensajes",
+  "design_system.families.navigation": "Navegación",
+  "design_system.families.notifications": "Notificaciones",
+  "design_system.families.overlays": "Superposiciones",
+  "design_system.families.scaffolding": "Estructura de página",
+  "design_system.families.schedule": "Agenda",
+  "design_system.gallery.copied": "Fragmento copiado al portapapeles",
+  "design_system.gallery.copy": "Copiar código",
+  "design_system.gallery.copyFailed": "No se pudo copiar el fragmento",
+  "design_system.gallery.familiesGroup": "Familias",
+  "design_system.gallery.familyContents": "Componentes de esta familia",
+  "design_system.gallery.iconCopied": "Copiado: {snippet}",
+  "design_system.gallery.iconCopyJsx": "Copiar JSX (lucide-react)",
+  "design_system.gallery.iconCopyMeta": "Copiar nombre para page.meta icon",
+  "design_system.gallery.iconCountAll": "{total} iconos",
+  "design_system.gallery.iconCountFiltered": "{visible} de {total} iconos",
+  "design_system.gallery.iconSearchPlaceholder": "Filtrar iconos…",
+  "design_system.gallery.loadFailed": "No se pudo cargar esta familia",
+  "design_system.gallery.noResults": "Ningún componente coincide con la búsqueda",
+  "design_system.gallery.openInFigma": "Abrir en Figma",
+  "design_system.gallery.retry": "Reintentar",
+  "design_system.gallery.samples.addresses.empty": "Aún no hay direcciones",
+  "design_system.gallery.samples.addresses.emptyTitle": "Añade la primera dirección",
+  "design_system.gallery.samples.addresses.title": "Direcciones",
+  "design_system.gallery.samples.attachments.description": "Archivos vinculados a este registro",
+  "design_system.gallery.samples.attachments.title": "Adjuntos",
+  "design_system.gallery.samples.billingDetails": "Datos de facturación",
+  "design_system.gallery.samples.createdAt": "Creado {date}",
+  "design_system.gallery.samples.entityType": "Empresa",
+  "design_system.gallery.samples.listDescription": "Monedas disponibles en tu organización",
+  "design_system.gallery.samples.notes.add": "Añadir nota",
+  "design_system.gallery.samples.notes.empty": "Aún no hay notas",
+  "design_system.gallery.samples.notes.emptyTitle": "Registra la primera nota",
+  "design_system.gallery.searchPlaceholder": "Buscar componentes…",
+  "design_system.gallery.usageDo": "Haz",
+  "design_system.gallery.usageDont": "Evita",
+  "design_system.gallery.viewDocs": "Ver documentación",
+  "design_system.nav.group": "Desarrollador",
+  "design_system.nav.title": "Sistema de diseño"
+}

package/src/modules/design_system/i18n/ko.json

@@ -0,0 +1,58 @@
+{
+  "design_system.entries.button.description": "전체 DS 변형 및 크기 규모를 갖춘 기본 작업 트리거입니다.",
+  "design_system.entries.buttonGroup.description": "하나의 테두리를 공유하는 관련 작업 버튼 그룹에 합류했습니다.",
+  "design_system.entries.fancyButton.description": "눈에 띄는 작업을 위한 그라데이션 마케팅 등급 버튼입니다.",
+  "design_system.entries.iconButton.description": "사각형 아이콘 전용 버튼; 항상 aria-label이 필요합니다.",
+  "design_system.entries.linkButton.description": "DS 컨트롤 스타일의 인라인 텍스트 링크입니다.",
+  "design_system.entries.socialButton.description": "소셜 로그인을 위한 브랜드 색상의 인증 버튼입니다.",
+  "design_system.families.banners": "배너 및 설명선",
+  "design_system.families.buttons": "버튼",
+  "design_system.families.charts": "차트",
+  "design_system.families.dates": "날짜 및 시간",
+  "design_system.families.detail": "세부 섹션",
+  "design_system.families.display": "데이터 표시",
+  "design_system.families.feedback": "피드백",
+  "design_system.families.filters": "필터",
+  "design_system.families.foundations": "기초",
+  "design_system.families.icons": "아이콘",
+  "design_system.families.inputs": "입력",
+  "design_system.families.messages": "메시지",
+  "design_system.families.navigation": "항해",
+  "design_system.families.notifications": "알림",
+  "design_system.families.overlays": "오버레이",
+  "design_system.families.scaffolding": "페이지 비계",
+  "design_system.families.schedule": "일정",
+  "design_system.gallery.copied": "스니펫이 클립보드에 복사되었습니다.",
+  "design_system.gallery.copy": "코드 복사",
+  "design_system.gallery.copyFailed": "스니펫을 복사할 수 없습니다.",
+  "design_system.gallery.familiesGroup": "가족",
+  "design_system.gallery.familyContents": "이 제품군의 구성요소",
+  "design_system.gallery.iconCopied": "복사됨: {snippet}",
+  "design_system.gallery.iconCopyJsx": "JSX 복사(lucide-react)",
+  "design_system.gallery.iconCopyMeta": "page.meta 아이콘의 이름 복사",
+  "design_system.gallery.iconCountAll": "{total} 아이콘",
+  "design_system.gallery.iconCountFiltered": "{total} 아이콘의 {visible}",
+  "design_system.gallery.iconSearchPlaceholder": "필터 아이콘…",
+  "design_system.gallery.loadFailed": "이 가족을 로드할 수 없습니다.",
+  "design_system.gallery.noResults": "검색어와 일치하는 구성요소가 없습니다.",
+  "design_system.gallery.openInFigma": "Figma에서 열기",
+  "design_system.gallery.retry": "다시 해 보다",
+  "design_system.gallery.samples.addresses.empty": "아직 주소가 없습니다",
+  "design_system.gallery.samples.addresses.emptyTitle": "첫 번째 주소를 추가하세요",
+  "design_system.gallery.samples.addresses.title": "주소",
+  "design_system.gallery.samples.attachments.description": "이 레코드에 연결된 파일",
+  "design_system.gallery.samples.attachments.title": "첨부 파일",
+  "design_system.gallery.samples.billingDetails": "청구 정보",
+  "design_system.gallery.samples.createdAt": "{date}에 생성됨",
+  "design_system.gallery.samples.entityType": "회사",
+  "design_system.gallery.samples.listDescription": "조직에서 사용할 수 있는 통화",
+  "design_system.gallery.samples.notes.add": "메모 추가",
+  "design_system.gallery.samples.notes.empty": "아직 메모가 없습니다",
+  "design_system.gallery.samples.notes.emptyTitle": "첫 번째 메모를 남기세요",
+  "design_system.gallery.searchPlaceholder": "구성요소 검색…",
+  "design_system.gallery.usageDo": "하다",
+  "design_system.gallery.usageDont": "하지 않다",
+  "design_system.gallery.viewDocs": "문서 보기",
+  "design_system.nav.group": "개발자",
+  "design_system.nav.title": "디자인 시스템"
+}

package/src/modules/design_system/i18n/pl.json

@@ -0,0 +1,58 @@
+{
+  "design_system.entries.button.description": "Podstawowy przycisk akcji z pełną skalą wariantów i rozmiarów DS.",
+  "design_system.entries.buttonGroup.description": "Połączona grupa powiązanych przycisków akcji ze wspólnym obramowaniem.",
+  "design_system.entries.fancyButton.description": "Gradientowy przycisk o marketingowym charakterze dla wyróżnionych akcji.",
+  "design_system.entries.iconButton.description": "Kwadratowy przycisk z samą ikoną; zawsze wymaga aria-label.",
+  "design_system.entries.linkButton.description": "Tekstowy odnośnik w stylu kontrolki DS.",
+  "design_system.entries.socialButton.description": "Przycisk logowania w kolorach marki dla logowania społecznościowego.",
+  "design_system.families.banners": "Banery i wskazówki",
+  "design_system.families.buttons": "Przyciski",
+  "design_system.families.charts": "Wykresy",
+  "design_system.families.dates": "Daty i czas",
+  "design_system.families.detail": "Sekcje szczegółów",
+  "design_system.families.display": "Prezentacja danych",
+  "design_system.families.feedback": "Informacje zwrotne",
+  "design_system.families.filters": "Filtry",
+  "design_system.families.foundations": "Fundamenty",
+  "design_system.families.icons": "Ikony",
+  "design_system.families.inputs": "Pola formularzy",
+  "design_system.families.messages": "Wiadomości",
+  "design_system.families.navigation": "Nawigacja",
+  "design_system.families.notifications": "Powiadomienia",
+  "design_system.families.overlays": "Nakładki",
+  "design_system.families.scaffolding": "Szkielet strony",
+  "design_system.families.schedule": "Harmonogram",
+  "design_system.gallery.copied": "Fragment skopiowany do schowka",
+  "design_system.gallery.copy": "Kopiuj kod",
+  "design_system.gallery.copyFailed": "Nie udało się skopiować fragmentu",
+  "design_system.gallery.familiesGroup": "Rodziny",
+  "design_system.gallery.familyContents": "Komponenty w tej rodzinie",
+  "design_system.gallery.iconCopied": "Skopiowano: {snippet}",
+  "design_system.gallery.iconCopyJsx": "Kopiuj JSX (lucide-react)",
+  "design_system.gallery.iconCopyMeta": "Kopiuj nazwę do page.meta icon",
+  "design_system.gallery.iconCountAll": "Ikony: {total}",
+  "design_system.gallery.iconCountFiltered": "{visible} z {total} ikon",
+  "design_system.gallery.iconSearchPlaceholder": "Filtruj ikony…",
+  "design_system.gallery.loadFailed": "Nie udało się załadować tej rodziny",
+  "design_system.gallery.noResults": "Żaden komponent nie pasuje do wyszukiwania",
+  "design_system.gallery.openInFigma": "Otwórz w Figmie",
+  "design_system.gallery.retry": "Spróbuj ponownie",
+  "design_system.gallery.samples.addresses.empty": "Nie ma jeszcze adresów",
+  "design_system.gallery.samples.addresses.emptyTitle": "Dodaj pierwszy adres",
+  "design_system.gallery.samples.addresses.title": "Adresy",
+  "design_system.gallery.samples.attachments.description": "Pliki powiązane z tym rekordem",
+  "design_system.gallery.samples.attachments.title": "Załączniki",
+  "design_system.gallery.samples.billingDetails": "Dane rozliczeniowe",
+  "design_system.gallery.samples.createdAt": "Utworzono {date}",
+  "design_system.gallery.samples.entityType": "Firma",
+  "design_system.gallery.samples.listDescription": "Waluty dostępne w Twojej organizacji",
+  "design_system.gallery.samples.notes.add": "Dodaj notatkę",
+  "design_system.gallery.samples.notes.empty": "Nie ma jeszcze notatek",
+  "design_system.gallery.samples.notes.emptyTitle": "Zapisz pierwszą notatkę",
+  "design_system.gallery.searchPlaceholder": "Szukaj komponentów…",
+  "design_system.gallery.usageDo": "Rób",
+  "design_system.gallery.usageDont": "Unikaj",
+  "design_system.gallery.viewDocs": "Zobacz dokumentację",
+  "design_system.nav.group": "Deweloper",
+  "design_system.nav.title": "Design system"
+}

package/src/modules/design_system/index.ts

@@ -0,0 +1,7 @@
+import type { ModuleInfo } from '@open-mercato/shared/modules/registry'
+
+export const metadata: ModuleInfo = {
+  name: 'design_system',
+  title: 'Design system gallery',
+  description: 'Live, in-app component gallery for the Open Mercato design system.',
+}

package/src/modules/design_system/setup.ts

@@ -0,0 +1,12 @@
+import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
+
+export const setup: ModuleSetupConfig = {
+  defaultRoleFeatures: {
+    // View-only module: the gallery reads no tenant data, so the grant is safe
+    // to hand out broadly. Superadmin is covered by wildcard grants.
+    admin: ['design_system.view'],
+    employee: ['design_system.view'],
+  },
+}
+
+export default setup

package/src/modules/dictionaries/api/[dictionaryId]/entries/route.ts

@@ -3,7 +3,11 @@ import { z } from 'zod'
 import { runWithCacheTenant } from '@open-mercato/cache'
 import { Dictionary, DictionaryEntry } from '@open-mercato/core/modules/dictionaries/data/entities'
 import { resolveDictionariesRouteContext, resolveDictionaryActorId } from '@open-mercato/core/modules/dictionaries/api/context'
-import { createDictionaryEntrySchema } from '@open-mercato/core/modules/dictionaries/data/validators'
+import {
+  createDictionaryEntrySchema,
+  listDictionaryEntriesQuerySchema,
+  DICTIONARY_ENTRIES_MAX_LIMIT,
+} from '@open-mercato/core/modules/dictionaries/data/validators'
 import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
 import {
   runCrudMutationGuardAfterSuccess,
@@ -14,6 +18,7 @@ import { serializeOperationMetadata } from '@open-mercato/shared/lib/commands/op
 import type { OpenApiMethodDoc, OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import {
   createDictionaryEntrySchema as createEntryDocSchema,
+  dictionaryEntriesQuerySchema,
   dictionaryEntryListResponseSchema,
   dictionaryEntryResponseSchema,
   dictionaryIdParamsSchema,
@@ -45,8 +50,10 @@ function buildEntriesCacheKey(params: {
   dictionaryId: string
   organizationId: string | null
   sortMode: string
+  limit: number
+  offset: number
 }): string {
-  return `dictionaries:entries:${params.dictionaryId}:org=${params.organizationId ?? 'null'}:sort=${params.sortMode}`
+  return `dictionaries:entries:${params.dictionaryId}:org=${params.organizationId ?? 'null'}:sort=${params.sortMode}:limit=${params.limit}:offset=${params.offset}`
 }
 
 async function loadDictionary(
@@ -93,6 +100,11 @@ export async function GET(req: Request, ctx: { params?: { dictionaryId?: string
       return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
     }
     const { dictionaryId } = paramsSchema.parse({ dictionaryId: ctx.params?.dictionaryId })
+    const requestUrl = new URL(req.url)
+    const { limit, offset } = listDictionaryEntriesQuerySchema.parse({
+      limit: requestUrl.searchParams.get('limit') ?? undefined,
+      offset: requestUrl.searchParams.get('offset') ?? undefined,
+    })
     const dictionary = await loadDictionary(context, dictionaryId, { allowInherited: true })
     const dictionaryTenantId = dictionary.tenantId
     const dictionaryOrgId = dictionary.organizationId ?? null
@@ -102,9 +114,12 @@ export async function GET(req: Request, ctx: { params?: { dictionaryId?: string
     // decrypted+sorted options payload. The entry writes flow through the
     // command bus (resourceKind dictionaries.entry), which already flushes the
     // matching collection tag post-commit — no new invalidation wiring needed.
-    const cache = isCrudCacheEnabled() ? resolveCrudCache(context.container) : null
+    // Only the default page is cached: keying the cache on caller-supplied
+    // pagination would let any reader mint unbounded distinct cache entries.
+    const isDefaultPage = limit === DICTIONARY_ENTRIES_MAX_LIMIT && offset === 0
+    const cache = isCrudCacheEnabled() && isDefaultPage ? resolveCrudCache(context.container) : null
     const cacheKey = cache
-      ? buildEntriesCacheKey({ dictionaryId, organizationId: dictionaryOrgId, sortMode })
+      ? buildEntriesCacheKey({ dictionaryId, organizationId: dictionaryOrgId, sortMode, limit, offset })
       : null
 
     if (cache && cacheKey) {
@@ -114,15 +129,19 @@ export async function GET(req: Request, ctx: { params?: { dictionaryId?: string
       }
     }
 
+    const entriesFilter = {
+      dictionary,
+      organizationId: dictionary.organizationId,
+      tenantId: dictionary.tenantId,
+    }
+    const total = await context.em.count(DictionaryEntry, entriesFilter)
+    // Bound the decrypt+sort work per request: page membership is decided by a
+    // stable database ordering, and the dictionary's sort mode orders the page.
     const entries = await findWithDecryption(
       context.em,
       DictionaryEntry,
-      {
-        dictionary,
-        organizationId: dictionary.organizationId,
-        tenantId: dictionary.tenantId,
-      },
-      {},
+      entriesFilter,
+      { orderBy: { position: 'asc', id: 'asc' }, limit, offset },
       { tenantId: dictionary.tenantId, organizationId: dictionary.organizationId },
     )
     const sortedEntries = sortDictionaryEntries(entries, sortMode)
@@ -139,6 +158,14 @@ export async function GET(req: Request, ctx: { params?: { dictionaryId?: string
         createdAt: entry.createdAt,
         updatedAt: entry.updatedAt,
       })),
+      total,
+      limit,
+      offset,
+      hasMore: offset + sortedEntries.length < total,
+      // Page membership comes from the database ordering, while the page itself
+      // is ordered in memory. A client assembling several pages has to re-apply
+      // the same comparator, so it needs the mode that produced this ordering.
+      sortMode,
     }
 
     if (cache && cacheKey) {
@@ -265,8 +292,9 @@ export async function POST(req: Request, ctx: { params?: { dictionaryId?: string
 
 const dictionaryEntriesGetDoc: OpenApiMethodDoc = {
   summary: 'List dictionary entries',
-  description: 'Returns entries for the specified dictionary ordered by its configured entry sort mode.',
+  description: `Returns entries for the specified dictionary ordered by its configured entry sort mode. The number of entries returned per request is capped at ${DICTIONARY_ENTRIES_MAX_LIMIT}; use \`limit\` and \`offset\` with the \`total\`/\`hasMore\` response fields to page through larger dictionaries.`,
   tags: [dictionariesTag],
+  query: dictionaryEntriesQuerySchema,
   responses: [
     { status: 200, description: 'Dictionary entries.', schema: dictionaryEntryListResponseSchema },
   ],

package/src/modules/dictionaries/api/openapi.ts

@@ -5,6 +5,7 @@ import {
   updateDictionaryEntrySchema,
   reorderDictionaryEntriesSchema,
   setDefaultDictionaryEntrySchema,
+  DICTIONARY_ENTRIES_MAX_LIMIT,
 } from '@open-mercato/core/modules/dictionaries/data/validators'
 import { dictionaryEntrySortModeSchema } from '@open-mercato/core/modules/dictionaries/lib/entrySort'
 
@@ -57,6 +58,24 @@ export const dictionaryEntrySchema = z.object({
 
 export const dictionaryEntryListResponseSchema = z.object({
   items: z.array(dictionaryEntrySchema),
+  total: z.number().int(),
+  limit: z.number().int(),
+  offset: z.number().int(),
+  hasMore: z.boolean(),
+  sortMode: dictionaryEntrySortModeSchema.describe(
+    'Sort mode that ordered this page. Clients assembling multiple pages must re-apply it across the combined set.',
+  ),
+})
+
+export const dictionaryEntriesQuerySchema = z.object({
+  limit: z.coerce
+    .number()
+    .int()
+    .positive()
+    .max(DICTIONARY_ENTRIES_MAX_LIMIT)
+    .optional()
+    .describe(`Maximum entries to return. Defaults to and is capped at ${DICTIONARY_ENTRIES_MAX_LIMIT}.`),
+  offset: z.coerce.number().int().min(0).optional().describe('Number of entries to skip. Defaults to 0.'),
 })
 
 export const dictionaryEntryResponseSchema = dictionaryEntrySchema

package/src/modules/dictionaries/components/DictionaryEntrySelect.tsx

@@ -398,7 +398,7 @@ export function DictionaryEntrySelect({
                       labels={appearanceLabels ?? DEFAULT_APPEARANCE_LABELS}
                     />
                   ) : null}
-                  {formError ? <p className="text-sm text-red-600">{formError}</p> : null}
+                  {formError ? <p className="text-sm text-status-error-text">{formError}</p> : null}
                 </div>
                 <DialogFooter>
                   <Button type="button" variant="outline" onClick={() => setDialogOpen(false)} disabled={saving}>

package/src/modules/dictionaries/components/hooks/useDictionaryEntries.ts

@@ -1,6 +1,5 @@
 "use client"
 
-import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
 import { useQuery, type QueryClient, type UseQueryResult } from '@tanstack/react-query'
 import {
   createDictionaryMap,
@@ -8,6 +7,7 @@ import {
   type DictionaryDisplayEntry,
   type DictionaryMap,
 } from '../dictionaryAppearance'
+import { fetchAllDictionaryEntries } from '../../lib/fetchAllEntries'
 
 export type DictionaryEntryRecord = DictionaryDisplayEntry & {
   id: string
@@ -28,47 +28,46 @@ const BASE_DICTIONARY_ENTRIES_KEY = ['dictionaries', 'entries'] as const
 export const dictionaryEntriesQueryKey = (dictionaryId: string, scopeVersion = 0) =>
   [...BASE_DICTIONARY_ENTRIES_KEY, dictionaryId, `scope:${scopeVersion}`] as const
 
+function parseDictionaryEntryItems(items: unknown[]): DictionaryEntryRecord[] {
+  const parsed: DictionaryEntryRecord[] = []
+  for (const item of items) {
+    if (!item || typeof item !== 'object') continue
+    const data = item as Record<string, unknown>
+    const id = typeof data.id === 'string' ? data.id : ''
+    const value = typeof data.value === 'string' ? data.value.trim() : ''
+    if (!id || !value) continue
+    const label =
+      typeof data.label === 'string' && data.label.trim().length ? data.label.trim() : value
+    const color =
+      typeof data.color === 'string' && /^#([0-9a-fA-F]{6})$/.test(data.color)
+        ? `#${data.color.slice(1).toLowerCase()}`
+        : null
+    const icon = typeof data.icon === 'string' && data.icon.trim().length ? data.icon.trim() : null
+    const createdAt = typeof data.createdAt === 'string' ? data.createdAt : null
+    const updatedAt = typeof data.updatedAt === 'string' ? data.updatedAt : null
+    parsed.push({
+      id,
+      value,
+      label,
+      color,
+      icon,
+      createdAt,
+      updatedAt,
+    })
+  }
+  return parsed
+}
+
 export const dictionaryEntriesQueryOptions = (dictionaryId: string, scopeVersion = 0) => ({
   queryKey: dictionaryEntriesQueryKey(dictionaryId, scopeVersion),
   staleTime: DICTIONARY_ENTRIES_STALE_TIME,
   gcTime: DICTIONARY_ENTRIES_STALE_TIME,
   queryFn: async (): Promise<DictionaryEntriesQueryData> => {
-    const call = await apiCall<Record<string, unknown>>(`/api/dictionaries/${dictionaryId}/entries`)
-    const payload = call.result ?? {}
-    if (!call.ok) {
-      const message =
-        typeof payload.error === 'string'
-          ? payload.error
-          : 'Failed to load dictionary entries.'
-      throw new Error(message)
-    }
-    const items = Array.isArray(payload.items) ? payload.items : []
-    const parsed: DictionaryEntryRecord[] = []
-    for (const item of items) {
-      if (!item || typeof item !== 'object') continue
-      const data = item as Record<string, unknown>
-      const id = typeof data.id === 'string' ? data.id : ''
-      const value = typeof data.value === 'string' ? data.value.trim() : ''
-      if (!id || !value) continue
-      const label =
-        typeof data.label === 'string' && data.label.trim().length ? data.label.trim() : value
-      const color =
-        typeof data.color === 'string' && /^#([0-9a-fA-F]{6})$/.test(data.color)
-          ? `#${data.color.slice(1).toLowerCase()}`
-          : null
-      const icon = typeof data.icon === 'string' && data.icon.trim().length ? data.icon.trim() : null
-      const createdAt = typeof data.createdAt === 'string' ? data.createdAt : null
-      const updatedAt = typeof data.updatedAt === 'string' ? data.updatedAt : null
-      parsed.push({
-        id,
-        value,
-        label,
-        color,
-        icon,
-        createdAt,
-        updatedAt,
-      })
+    const pages = await fetchAllDictionaryEntries(dictionaryId)
+    if (!pages.ok) {
+      throw new Error(pages.errorMessage ?? 'Failed to load dictionary entries.')
     }
+    const parsed = parseDictionaryEntryItems(pages.items)
     const normalized = normalizeDictionaryEntries(
       parsed.map(({ value, label, color, icon }) => ({ value, label, color, icon })),
       { sort: false },

package/src/modules/dictionaries/data/validators.ts

@@ -26,6 +26,20 @@ export const upsertDictionarySchema = z.object({
 
 export type UpsertDictionaryInput = z.infer<typeof upsertDictionarySchema>
 
+export const DICTIONARY_ENTRIES_MAX_LIMIT = 500
+
+export const listDictionaryEntriesQuerySchema = z.object({
+  limit: z.coerce
+    .number()
+    .int()
+    .positive()
+    .max(DICTIONARY_ENTRIES_MAX_LIMIT)
+    .catch(DICTIONARY_ENTRIES_MAX_LIMIT),
+  offset: z.coerce.number().int().min(0).catch(0),
+})
+
+export type ListDictionaryEntriesQuery = z.infer<typeof listDictionaryEntriesQuerySchema>
+
 export const createDictionaryEntrySchema = z.object({
   value: z.string().trim().min(1).max(150),
   label: z.string().trim().min(1).max(150).optional(),

package/src/modules/dictionaries/i18n/ko.json

@@ -0,0 +1,130 @@
+{
+  "dictionaries.config.delete.confirm": "사전 \"{{name}}\"을(를) 삭제하시겠습니까?",
+  "dictionaries.config.dialog.cancel": "취소",
+  "dictionaries.config.dialog.createTitle": "사전 생성",
+  "dictionaries.config.dialog.descriptionLabel": "설명",
+  "dictionaries.config.dialog.descriptionPlaceholder": "이 사전이 어떻게 사용되는지 설명하세요 (선택 사항).",
+  "dictionaries.config.dialog.editTitle": "사전 편집",
+  "dictionaries.config.dialog.entrySortModeHelp": "사전 항목 API와 드롭다운에서 반환되는 순서를 제어합니다.",
+  "dictionaries.config.dialog.entrySortModeLabel": "항목 정렬 순서",
+  "dictionaries.config.dialog.keyErrorLength": "키는 최대 100자까지 가능합니다.",
+  "dictionaries.config.dialog.keyErrorPattern": "소문자, 숫자, 하이픈 또는 밑줄을 사용하세요.",
+  "dictionaries.config.dialog.keyErrorRequired": "키는 필수입니다.",
+  "dictionaries.config.dialog.keyHint": "소문자, 숫자, 하이픈 또는 밑줄을 사용하세요.",
+  "dictionaries.config.dialog.keyLabel": "키",
+  "dictionaries.config.dialog.keyPlaceholder": "slug_name",
+  "dictionaries.config.dialog.nameErrorRequired": "이름은 필수입니다.",
+  "dictionaries.config.dialog.nameLabel": "이름",
+  "dictionaries.config.dialog.namePlaceholder": "표시 이름",
+  "dictionaries.config.dialog.save": "저장",
+  "dictionaries.config.entries.actions.add": "항목 추가",
+  "dictionaries.config.entries.actions.refresh": "새로고침",
+  "dictionaries.config.entries.actions.translate": "번역",
+  "dictionaries.config.entries.appearance.none": "없음",
+  "dictionaries.config.entries.columns.actions": "작업",
+  "dictionaries.config.entries.columns.appearance": "외형",
+  "dictionaries.config.entries.columns.label": "라벨",
+  "dictionaries.config.entries.columns.value": "값",
+  "dictionaries.config.entries.delete.confirm": "\"{{value}}\"을(를) 삭제하시겠습니까?",
+  "dictionaries.config.entries.dialog.addTitle": "사전 항목 추가",
+  "dictionaries.config.entries.dialog.cancel": "취소",
+  "dictionaries.config.entries.dialog.colorClear": "색상 제거",
+  "dictionaries.config.entries.dialog.colorHelp": "이 항목의 강조 색상을 선택하세요.",
+  "dictionaries.config.entries.dialog.colorLabel": "색상",
+  "dictionaries.config.entries.dialog.editTitle": "사전 항목 편집",
+  "dictionaries.config.entries.dialog.iconBrowse": "아이콘 및 이모지 찾아보기",
+  "dictionaries.config.entries.dialog.iconClear": "아이콘 제거",
+  "dictionaries.config.entries.dialog.iconLabel": "아이콘 또는 이모지",
+  "dictionaries.config.entries.dialog.iconPlaceholder": "이모지나 아이콘 토큰을 입력하세요.",
+  "dictionaries.config.entries.dialog.iconSearchEmpty": "검색과 일치하는 아이콘이 없습니다.",
+  "dictionaries.config.entries.dialog.iconSearchPlaceholder": "아이콘 또는 이모지 검색…",
+  "dictionaries.config.entries.dialog.iconSuggestions": "제안",
+  "dictionaries.config.entries.dialog.labelLabel": "라벨",
+  "dictionaries.config.entries.dialog.labelPlaceholder": "UI에 표시되는 이름",
+  "dictionaries.config.entries.dialog.previewEmpty": "선택된 외형이 없습니다",
+  "dictionaries.config.entries.dialog.save": "저장",
+  "dictionaries.config.entries.dialog.saveShortcut": "⌘/Ctrl + Enter",
+  "dictionaries.config.entries.dialog.valueLabel": "값",
+  "dictionaries.config.entries.empty": "아직 항목이 없습니다.",
+  "dictionaries.config.entries.error.delete": "사전 항목 삭제에 실패했습니다.",
+  "dictionaries.config.entries.error.load": "사전 항목을 불러오지 못했습니다.",
+  "dictionaries.config.entries.error.required": "값은 필수입니다.",
+  "dictionaries.config.entries.error.save": "사전 항목 저장에 실패했습니다.",
+  "dictionaries.config.entries.loading": "항목을 불러오는 중…",
+  "dictionaries.config.entries.placeholder": "항목을 관리할 사전을 선택하세요.",
+  "dictionaries.config.entries.readOnly": "상속된 사전은 상위 조직에서 관리됩니다.",
+  "dictionaries.config.entries.readOnlyActions": "상위 조직에서 관리됨",
+  "dictionaries.config.entries.subtitle": "이 사전의 재사용 가능한 값과 외형을 관리합니다.",
+  "dictionaries.config.entries.success.create": "사전 항목이 생성되었습니다.",
+  "dictionaries.config.entries.success.delete": "사전 항목이 삭제되었습니다.",
+  "dictionaries.config.entries.success.update": "사전 항목이 수정되었습니다.",
+  "dictionaries.config.error.delete": "사전 삭제에 실패했습니다.",
+  "dictionaries.config.error.inheritedManage": "상속된 사전은 상위 조직에서 관리해야 합니다.",
+  "dictionaries.config.error.load": "사전을 불러오지 못했습니다.",
+  "dictionaries.config.error.required": "키와 이름은 필수입니다.",
+  "dictionaries.config.error.save": "사전 저장에 실패했습니다.",
+  "dictionaries.config.error.system": "시스템 사전은 삭제할 수 없습니다.",
+  "dictionaries.config.list.add": "새 사전",
+  "dictionaries.config.list.empty": "아직 사전이 없습니다. 시작하려면 하나를 생성하세요.",
+  "dictionaries.config.list.inherited": "상속됨",
+  "dictionaries.config.list.loading": "사전을 불러오는 중…",
+  "dictionaries.config.list.title": "사전",
+  "dictionaries.config.nav.title": "사전",
+  "dictionaries.config.sortModes.createdAtAsc": "오래된 순",
+  "dictionaries.config.sortModes.createdAtDesc": "최신 순",
+  "dictionaries.config.sortModes.labelAsc": "가나다 순",
+  "dictionaries.config.sortModes.labelDesc": "가나다 역순",
+  "dictionaries.config.sortModes.valueAsc": "값 오름차순",
+  "dictionaries.config.sortModes.valueDesc": "값 내림차순",
+  "dictionaries.config.success.create": "사전이 생성되었습니다.",
+  "dictionaries.config.success.delete": "사전이 삭제되었습니다.",
+  "dictionaries.config.success.update": "사전이 수정되었습니다.",
+  "dictionaries.customFields.allowInlineCreate": "양식 내 인라인 생성 허용",
+  "dictionaries.customFields.allowMultiple": "여러 항목 선택 허용",
+  "dictionaries.customFields.defaultValue": "기본값",
+  "dictionaries.customFields.defaultValueMultiUnavailable": "다중 선택 사전 필드에는 기본값을 사용할 수 없습니다.",
+  "dictionaries.customFields.defaultValueNone": "기본값 없음",
+  "dictionaries.customFields.defaultValueStale": "기본 항목을 찾을 수 없습니다 — 삭제되었거나 이름이 변경되었을 수 있습니다.",
+  "dictionaries.customFields.dictionaryLabel": "사전 소스",
+  "dictionaries.customFields.dictionaryPlaceholder": "사전 선택",
+  "dictionaries.customFields.empty": "아직 사용 가능한 사전이 없습니다. 먼저 하나를 생성하세요.",
+  "dictionaries.customFields.errorLoad": "사전을 불러오지 못했습니다.",
+  "dictionaries.customFields.inactive": "비활성",
+  "dictionaries.customFields.inlineCreateSingleOnly": "인라인 생성은 단일 항목 사전 필드에만 사용할 수 있습니다.",
+  "dictionaries.customFields.loading": "사전을 불러오는 중…",
+  "dictionaries.customFields.manageLink": "사전 관리",
+  "dictionaries.customFields.selectedHint": "이 사전의 항목이 필드를 채웁니다.",
+  "dictionaries.customFields.selector.add": "항목 추가",
+  "dictionaries.customFields.selector.dialogDescription": "새 항목을 생성하여 여러 레코드에서 재사용하세요.",
+  "dictionaries.customFields.selector.placeholder": "항목 선택",
+  "dictionaries.entries.audit.create": "사전 항목 추가",
+  "dictionaries.entries.audit.delete": "사전 항목 삭제",
+  "dictionaries.entries.audit.reorder": "사전 항목 순서 변경",
+  "dictionaries.entries.audit.set_default": "기본 사전 항목 설정",
+  "dictionaries.entries.audit.update": "사전 항목 수정",
+  "dictionaries.entries.create": "사전 항목 추가",
+  "dictionaries.entries.delete": "사전 항목 삭제",
+  "dictionaries.entries.update": "사전 항목 수정",
+  "dictionaries.errors.currency_protected": "통화 사전은 필수이며 수정하거나 삭제할 수 없습니다.",
+  "dictionaries.errors.duplicate": "이 키를 가진 사전이 이미 존재합니다",
+  "dictionaries.errors.entry_create_failed": "사전 항목 생성에 실패했습니다.",
+  "dictionaries.errors.entry_duplicate": "이 값을 가진 항목이 이미 존재합니다",
+  "dictionaries.errors.entry_not_found": "사전 항목을 찾을 수 없습니다",
+  "dictionaries.errors.entry_required": "값은 필수입니다",
+  "dictionaries.errors.entry_update_failed": "사전 항목 수정에 실패했습니다.",
+  "dictionaries.errors.invalid_key": "소문자, 숫자, 하이픈 또는 밑줄을 사용하세요.",
+  "dictionaries.errors.not_found": "사전을 찾을 수 없습니다",
+  "dictionaries.errors.organization_required": "조직 컨텍스트가 필요합니다",
+  "dictionaries.errors.unauthorized": "권한이 없습니다",
+  "dictionaries.form.colorClear": "색상 지우기",
+  "dictionaries.form.colorHelp": "이 항목의 강조 색상을 선택하세요.",
+  "dictionaries.form.colorLabel": "색상",
+  "dictionaries.form.iconClearLabel": "아이콘 지우기",
+  "dictionaries.form.iconLabel": "아이콘",
+  "dictionaries.form.iconPickerTriggerLabel": "아이콘 찾아보기",
+  "dictionaries.form.iconPlaceholder": "이모지나 아이콘 이름을 입력하세요",
+  "dictionaries.form.iconSearchEmptyLabel": "검색과 일치하는 아이콘이 없습니다",
+  "dictionaries.form.iconSearchPlaceholder": "아이콘 또는 이모지 검색…",
+  "dictionaries.form.iconSuggestionsLabel": "제안",
+  "dictionaries.form.previewEmptyLabel": "선택된 외형이 없습니다"
+}

package/src/modules/dictionaries/lib/clientEntries.ts

@@ -1,6 +1,7 @@
 "use client"
 
 import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
+import { fetchAllDictionaryEntries } from './fetchAllEntries'
 
 type DictionarySummary = {
   id: string
@@ -59,8 +60,8 @@ export async function loadDictionaryEntriesByKey(key: string): Promise<Dictionar
   const dictionary = normalizeDictionaryList(dictionariesCall.result?.items).find((item) => item.key === key)
   if (!dictionary) return []
 
-  const entriesCall = await apiCall<{ items?: unknown[] }>(`/api/dictionaries/${dictionary.id}/entries`)
-  if (!entriesCall.ok) return []
+  const entries = await fetchAllDictionaryEntries(dictionary.id)
+  if (!entries.ok) return []
 
-  return normalizeDictionaryEntries(entriesCall.result?.items)
+  return normalizeDictionaryEntries(entries.items)
 }