Skip to main content
Sonamu automatically extracts labels from Entity definitions and includes them in sd.generated.ts. This eliminates the need to manually write Entity-related text in the dictionary.

​
Auto-extracted Items

​
1. Entity Title

The Entity’s title property is extracted as the entity.{EntityId} key: 
// entity.json
{
  "id": "User",
  "title": "사용자",
  "table": "users",
  "props": [...]
}

// sd.generated.ts (auto-generated)
const entityLabels = {
  "entity.User": "사용자",
  // ...
};

// Usage
SD("entity.User")  // "사용자"

​
2. Prop Labels

Each prop’s desc property is extracted as the entity.{EntityId}.{propName} key: 
// entity.json
{
  "id": "User",
  "props": [
    { "name": "id", "type": "integer", "desc": "ID" },
    { "name": "email", "type": "string", "desc": "이메일" },
    { "name": "username", "type": "string", "desc": "이름" },
    { "name": "created_at", "type": "datetime", "desc": "등록일시" }
  ]
}

// sd.generated.ts (auto-generated)
const entityLabels = {
  "entity.User": "USER",
  "entity.User.id": "ID",
  "entity.User.email": "이메일",
  "entity.User.username": "이름",
  "entity.User.created_at": "등록일시",
  // ...
};

// Usage
SD("entity.User.email")  // "이메일"

​
3. Enum Labels

enumLabels defined in the Entity are extracted as enum.{EnumId}.{value} keys: 
// entity.json
{
  "id": "User",
  "enums": {
    "UserRole": ["admin", "normal"]
  },
  "enumLabels": {
    "UserRole": {
      "admin": "관리자",
      "normal": "일반"
    }
  }
}

// sd.generated.ts (auto-generated)
const entityLabels = {
  "enum.UserRole.admin": "관리자",
  "enum.UserRole.normal": "일반",
  // ...
};

// Usage
SD("enum.UserRole.admin")  // "관리자"
SD.enumLabels("UserRole")["admin"]  // "관리자"

​
4. OrderBy / SearchField Labels

Enums used in ListParams are also automatically extracted: 
// sd.generated.ts (auto-generated)
const entityLabels = {
  "enum.UserOrderBy.id-desc": "ID최신순",
  "enum.UserSearchField.id": "ID",
  "enum.UserSearchField.email": "이메일",
  // ...
};

​
Editing Labels in Sonamu UI

You can directly edit labels in Sonamu UI’s Entity edit screen:
  1. Entity Title: Edit on the Entity detail page
  2. Prop Labels: Edit each prop’s desc field
  3. Enum Labels: Edit in the Enum edit modal
After saving, entity.json is updated, and it will be reflected in sd.generated.ts upon pnpm sync.

​
Multilingual Entity Labels

Entity labels are stored only in defaultLocale. Translations for other locales should be written directly in the respective locale’s dictionary file: 
// en.ts
import { defineLocale } from "./sd.generated";

export default defineLocale({
  // Entity label translations
  "entity.User": "User",
  "entity.User.email": "Email",
  "entity.User.username": "Username",

  // Enum label translations
  "enum.UserRole.admin": "Administrator",
  "enum.UserRole.normal": "Normal User",

  // Rest of project dictionary
  "common.save": "Save",
  // ...
});

​
Bulk Translation via Excel

You can export all keys including Entity labels as Excel from Sonamu UI’s i18n management page, translate them, and import back.

Excel Import/Export

Bulk translation file management

Using the SD Function

Writing and using dictionaries