sonamu 0.8.26 → 0.9.0

package/src/skills/sonamu/i18n.md

@@ -69,25 +69,25 @@ export default defineLocale({
 import { SD } from "@/i18n/sd.generated";
 
 // Simple string
-SD("common.save");  // → "저장" (ko) / "Save" (en)
+SD("common.save"); // → "저장" (ko) / "Save" (en)
 
 // Function form (with parameters)
-SD("validation.required")("이메일");  // → "이메일은 필수입니다"
-SD("common.results")(5);  // → "5개 결과" (ko) / "5 results" (en)
+SD("validation.required")("이메일"); // → "이메일은 필수입니다"
+SD("common.results")(5); // → "5개 결과" (ko) / "5 results" (en)
 ```
 
 ### Force a Specific Locale
 
 ```typescript
 const EN = SD.locale("en");
-EN("common.save");  // → "Save" (always English)
+EN("common.save"); // → "Save" (always English)
 ```
 
 ### Enum Labels
 
 ```typescript
 // Enum labels defined in entity.json
-SD.enumLabels("ProjectStatus")["in_progress"];  // → "진행중"
+SD.enumLabels("ProjectStatus")["in_progress"]; // → "진행중"
 ```
 
 ## Helper Functions
@@ -99,9 +99,9 @@ import { plural } from "sonamu/dict";
 
 // Handle singular/plural in English
 plural(count, {
-  zero: "No items",     // count === 0
-  one: "1 item",        // count === 1
-  other: `${count} items`,  // everything else
+  zero: "No items", // count === 0
+  one: "1 item", // count === 1
+  other: `${count} items`, // everything else
 });
 ```
 
@@ -110,11 +110,11 @@ plural(count, {
 ```typescript
 import { josa } from "sonamu/dict";
 
-josa("이메일", "은는");  // → "이메일은"
-josa("이름", "이가");    // → "이름이"
-josa("파일", "을를");    // → "파일을"
-josa("회사", "과와");    // → "회사와"
-josa("서울", "으로");    // → "서울로"
+josa("이메일", "은는"); // → "이메일은"
+josa("이름", "이가"); // → "이름이"
+josa("파일", "을를"); // → "파일을"
+josa("회사", "과와"); // → "회사와"
+josa("서울", "으로"); // → "서울로"
 ```
 
 ### createFormat (number/date formatting)
@@ -123,7 +123,7 @@ josa("서울", "으로");    // → "서울로"
 import { createFormat } from "sonamu/dict";
 
 const format = createFormat("ko");
-format.number(1234567);  // → "1,234,567"
+format.number(1234567); // → "1,234,567"
 format.date(new Date()); // → "2024. 1. 15."
 ```
 
@@ -138,10 +138,11 @@ enum.{EnumId}.{value}          → Enum value label
 ```
 
 Example:
+
 ```typescript
-SD("entity.User");           // → "사용자"
-SD("entity.User.email");     // → "이메일"
-SD("enum.UserRole.admin");   // → "관리자"
+SD("entity.User"); // → "사용자"
+SD("entity.User.email"); // → "이메일"
+SD("enum.UserRole.admin"); // → "관리자"
 ```
 
 ## localizedColumn
@@ -152,12 +153,13 @@ Returns the value for the current locale when locale-specific columns exist in t
 import { localizedColumn } from "@/i18n/sd.generated";
 
 // DB: { name: "태그", name_ko: "태그", name_en: "Tag" }
-localizedColumn(tag, "name");  // → "태그" (ko) / "Tag" (en)
+localizedColumn(tag, "name"); // → "태그" (ko) / "Tag" (en)
 ```
 
 ## Sonamu UI Management
 
 `http://localhost:34900/sonamu-ui` → i18n tab:
+
 - Browse/edit dictionary
 - Add/delete keys
 - Excel import/export
@@ -165,15 +167,15 @@ localizedColumn(tag, "name");  // → "태그" (ko) / "Tag" (en)
 
 ## Key Naming Conventions
 
-| Pattern | Purpose | Example |
-|---------|---------|---------|
-| `common.*` | Common UI text | `common.save`, `common.cancel` |
-| `error.*` | Error messages | `error.notFound`, `error.forbidden` |
-| `validation.*` | Validation messages | `validation.required`, `validation.email` |
-| `entity.*` | Entity-related | `entity.User`, `entity.User.email` |
-| `enum.*` | Enum labels | `enum.UserRole.admin` |
-| `menu.*` | Menu/navigation | `menu.home`, `menu.settings` |
-| `rc.*` | react-components built-in | `rc.pagination.next` |
+| Pattern        | Purpose                   | Example                                   |
+| -------------- | ------------------------- | ----------------------------------------- |
+| `common.*`     | Common UI text            | `common.save`, `common.cancel`            |
+| `error.*`      | Error messages            | `error.notFound`, `error.forbidden`       |
+| `validation.*` | Validation messages       | `validation.required`, `validation.email` |
+| `entity.*`     | Entity-related            | `entity.User`, `entity.User.email`        |
+| `enum.*`       | Enum labels               | `enum.UserRole.admin`                     |
+| `menu.*`       | Menu/navigation           | `menu.home`, `menu.settings`              |
+| `rc.*`         | react-components built-in | `rc.pagination.next`                      |
 
 ## Troubleshooting
 
@@ -182,14 +184,16 @@ localizedColumn(tag, "name");  // → "태그" (ko) / "Tag" (en)
 When you see `Type 'string' is not assignable to type '{ __brand: "LocalizedString"; }'`:
 
 **Cause 1: Missing i18n key in ko.ts**
+
 ```typescript
 // Wrong: type error when key is missing from ko.ts
-SD("validation.password");  // key not in ko.ts
+SD("validation.password"); // key not in ko.ts
 ```
 
 Fix: Add the key to ko.ts and run `pnpm sync`
 
 **Cause 2: Not using SD() in the model**
+
 ```typescript
 // Wrong: using a raw string directly
 throw new BadRequestException("이메일이 잘못되었습니다");
@@ -209,6 +213,7 @@ All user-facing strings must be wrapped with the SD() function.
 When an Entity uses a String PK, the i18n function types must reflect this.
 
 **BAD: Number only**
+
 ```typescript
 // ko.ts
 notFound: (name: string, id: number) => `존재하지 않는 ${name} ID ${id}`,
@@ -220,6 +225,7 @@ throw new NotFoundException(SD("notFound")(this.modelName, id));
 ```
 
 **GOOD: Support both with a union type**
+
 ```typescript
 // ko.ts
 notFound: (name: string, id: number | string) => `존재하지 않는 ${name} ID ${id}`,
@@ -229,20 +235,21 @@ throw new NotFoundException(SD("notFound")(this.modelName, id));
 ```
 
 **Applicable i18n keys:**
+
 - `notFound`: Entity lookup failure
 - `error.entityNotFound`: Specific entity lookup failure (deprecated, prefer `notFound`)
 
 ### Type Patterns by Namespace
 
-| i18n key | Parameter type | Purpose |
-|---------|----------------|---------|
-| `notFound` | `(name: string, id: number \| string)` | Entity lookup failure |
-| `search.invalidField` | `(field: string)` | Invalid search field |
-| `validation.required` | `(field: string)` | Required field validation |
-| `validation.maxLength` | `(field: string, max: number)` | Max length validation |
-| `validation.minLength` | `(field: string, min: number)` | Min length validation |
-| `entity.create` | `(name: string)` | Entity creation screen |
-| `entity.edit` | `(name: string, id: number \| string)` | Entity edit screen |
+| i18n key               | Parameter type                         | Purpose                   |
+| ---------------------- | -------------------------------------- | ------------------------- |
+| `notFound`             | `(name: string, id: number \| string)` | Entity lookup failure     |
+| `search.invalidField`  | `(field: string)`                      | Invalid search field      |
+| `validation.required`  | `(field: string)`                      | Required field validation |
+| `validation.maxLength` | `(field: string, max: number)`         | Max length validation     |
+| `validation.minLength` | `(field: string, min: number)`         | Min length validation     |
+| `entity.create`        | `(name: string)`                       | Entity creation screen    |
+| `entity.edit`          | `(name: string, id: number \| string)` | Entity edit screen        |
 
 ### How to Check PK Type
 
@@ -265,6 +272,7 @@ Check the id field type in the Entity file:
 ```
 
 **String PK entities in the KOPRI project:**
+
 - Account
 - Session
 - User

package/src/skills/sonamu/migration.md

@@ -10,15 +10,18 @@ description: Sonamu database migration. CREATE/ALTER TABLE, FK ordering, up/down
 **Do not write migration files manually or execute SQL directly.** Sonamu detects entity.json changes and generates accurate migration files.
 
 **Prerequisites:**
+
 - `pnpm dev` must be running in `/packages/api`
 
 **Method 1: Sonamu UI (confirm with user before choosing)**
+
 1. Open Sonamu UI in browser: `http://localhost:34900/sonamu-ui`
 2. Check the prepared list in the Migration menu
 3. Generate a migration file with the "Generate" button
 4. Apply to the actual DB with the "Apply" button
 
 **Method 2: CLI**
+
 ```bash
 cd packages/api
 pnpm sonamu migrate generate   # Generate migration file
@@ -28,6 +31,7 @@ pnpm sonamu migrate run         # Apply to actual DB
 **CRITICAL: Ask the user whether to proceed with UI or CLI before starting.**
 
 **DO NOT:**
+
 - Write migration files manually
 - Execute SQL directly (`CREATE TABLE`, `ALTER TABLE`, etc.)
 
@@ -92,7 +96,11 @@ export async function down(knex: Knex): Promise<void> {
 export async function up(knex: Knex): Promise<void> {
   return knex.schema.alterTable("employees", (table) => {
     table.foreign("user_id").references("users.id").onUpdate("CASCADE").onDelete("CASCADE");
-    table.foreign("department_id").references("departments.id").onUpdate("CASCADE").onDelete("SET NULL");
+    table
+      .foreign("department_id")
+      .references("departments.id")
+      .onUpdate("CASCADE")
+      .onDelete("SET NULL");
   });
 }
 
@@ -107,6 +115,7 @@ export async function down(knex: Knex): Promise<void> {
 ## PK Type Change
 
 ### Situation
+
 When the PK type of an existing table must be changed (e.g. integer -> text, bigint -> uuid), with FKs referencing that PK in multiple tables.
 
 ### Required Order
@@ -124,15 +133,25 @@ export async function up(knex: Knex): Promise<void> {
 
   // Step 3: Change types of the PK column and all FK columns simultaneously
   await knex.raw('ALTER TABLE "parent_table" ALTER COLUMN "id" TYPE new_type USING "id"::new_type');
-  await knex.raw('ALTER TABLE "child_table_1" ALTER COLUMN "parent_id" TYPE new_type USING "parent_id"::new_type');
-  await knex.raw('ALTER TABLE "child_table_2" ALTER COLUMN "parent_id" TYPE new_type USING "parent_id"::new_type');
+  await knex.raw(
+    'ALTER TABLE "child_table_1" ALTER COLUMN "parent_id" TYPE new_type USING "parent_id"::new_type',
+  );
+  await knex.raw(
+    'ALTER TABLE "child_table_2" ALTER COLUMN "parent_id" TYPE new_type USING "parent_id"::new_type',
+  );
 
   // Step 4: ADD the PK constraint
-  await knex.raw('ALTER TABLE "parent_table" ADD CONSTRAINT "parent_table_pkey" PRIMARY KEY ("id")');
+  await knex.raw(
+    'ALTER TABLE "parent_table" ADD CONSTRAINT "parent_table_pkey" PRIMARY KEY ("id")',
+  );
 
   // Step 5: ADD all FK constraints
-  await knex.raw('ALTER TABLE "child_table_1" ADD CONSTRAINT "child_table_1_parent_id_foreign" FOREIGN KEY ("parent_id") REFERENCES "parent_table"("id") ON UPDATE RESTRICT ON DELETE CASCADE');
-  await knex.raw('ALTER TABLE "child_table_2" ADD CONSTRAINT "child_table_2_parent_id_foreign" FOREIGN KEY ("parent_id") REFERENCES "parent_table"("id") ON UPDATE RESTRICT ON DELETE RESTRICT');
+  await knex.raw(
+    'ALTER TABLE "child_table_1" ADD CONSTRAINT "child_table_1_parent_id_foreign" FOREIGN KEY ("parent_id") REFERENCES "parent_table"("id") ON UPDATE RESTRICT ON DELETE CASCADE',
+  );
+  await knex.raw(
+    'ALTER TABLE "child_table_2" ADD CONSTRAINT "child_table_2_parent_id_foreign" FOREIGN KEY ("parent_id") REFERENCES "parent_table"("id") ON UPDATE RESTRICT ON DELETE RESTRICT',
+  );
 }
 ```
 
@@ -164,8 +183,12 @@ export async function up(knex: Knex): Promise<void> {
   await knex.raw('ALTER TABLE "users" ADD CONSTRAINT "users_pkey" PRIMARY KEY ("id")');
 
   // 5. Restore FK constraints
-  await knex.raw('ALTER TABLE "accounts" ADD CONSTRAINT "accounts_user_id_foreign" FOREIGN KEY ("user_id") REFERENCES "users"("id") ON UPDATE RESTRICT ON DELETE CASCADE');
-  await knex.raw('ALTER TABLE "sessions" ADD CONSTRAINT "sessions_user_id_foreign" FOREIGN KEY ("user_id") REFERENCES "users"("id") ON UPDATE RESTRICT ON DELETE CASCADE');
+  await knex.raw(
+    'ALTER TABLE "accounts" ADD CONSTRAINT "accounts_user_id_foreign" FOREIGN KEY ("user_id") REFERENCES "users"("id") ON UPDATE RESTRICT ON DELETE CASCADE',
+  );
+  await knex.raw(
+    'ALTER TABLE "sessions" ADD CONSTRAINT "sessions_user_id_foreign" FOREIGN KEY ("user_id") REFERENCES "users"("id") ON UPDATE RESTRICT ON DELETE CASCADE',
+  );
 }
 ```
 
@@ -201,27 +224,27 @@ pnpm sonamu migrate apply    # Apply to a specific DB configuration target
 
 ## Entity Type → DB Type
 
-| Entity | DB | Knex |
-|--------|-----|------|
-| `string` | `varchar(n)` / `text` | `table.string(name, length)` |
-| `string[]` | `varchar(n)[]` / `text[]` | `table.specificType(name, 'text[]')` |
-| `integer` | `integer` | `table.integer(name)` |
-| `integer[]` | `integer[]` | `table.specificType(name, 'integer[]')` |
-| `bigInteger` | `bigint` | `table.bigInteger(name)` |
-| `bigInteger[]` | `bigint[]` | `table.specificType(name, 'bigint[]')` |
-| `boolean` | `boolean` | `table.boolean(name)` |
-| `boolean[]` | `boolean[]` | `table.specificType(name, 'boolean[]')` |
-| `number` | `numeric(p,s)` | `table.decimal(name, p, s)` |
-| `numeric` | `numeric(p,s)` | `table.decimal(name, p, s)` |
-| `date` | `timestamptz` | `table.timestamp(name, { useTz: true })` |
-| `date[]` | `timestamptz[]` | `table.specificType(name, 'timestamptz[]')` |
-| `uuid` | `uuid` | `table.uuid(name)` |
-| `uuid[]` | `uuid[]` | `table.specificType(name, 'uuid[]')` |
-| `json` | `jsonb` | `table.jsonb(name)` |
-| `enum` | `text` | `table.text(name)` |
-| `vector` | `vector(n)` | `table.specificType(name, 'vector(n)')` |
-| `vector[]` | `vector(n)[]` | `table.specificType(name, 'vector(n)[]')` |
-| `tsvector` | `tsvector` | `table.specificType(name, 'tsvector')` |
+| Entity         | DB                        | Knex                                        |
+| -------------- | ------------------------- | ------------------------------------------- |
+| `string`       | `varchar(n)` / `text`     | `table.string(name, length)`                |
+| `string[]`     | `varchar(n)[]` / `text[]` | `table.specificType(name, 'text[]')`        |
+| `integer`      | `integer`                 | `table.integer(name)`                       |
+| `integer[]`    | `integer[]`               | `table.specificType(name, 'integer[]')`     |
+| `bigInteger`   | `bigint`                  | `table.bigInteger(name)`                    |
+| `bigInteger[]` | `bigint[]`                | `table.specificType(name, 'bigint[]')`      |
+| `boolean`      | `boolean`                 | `table.boolean(name)`                       |
+| `boolean[]`    | `boolean[]`               | `table.specificType(name, 'boolean[]')`     |
+| `number`       | `numeric(p,s)`            | `table.decimal(name, p, s)`                 |
+| `numeric`      | `numeric(p,s)`            | `table.decimal(name, p, s)`                 |
+| `date`         | `timestamptz`             | `table.timestamp(name, { useTz: true })`    |
+| `date[]`       | `timestamptz[]`           | `table.specificType(name, 'timestamptz[]')` |
+| `uuid`         | `uuid`                    | `table.uuid(name)`                          |
+| `uuid[]`       | `uuid[]`                  | `table.specificType(name, 'uuid[]')`        |
+| `json`         | `jsonb`                   | `table.jsonb(name)`                         |
+| `enum`         | `text`                    | `table.text(name)`                          |
+| `vector`       | `vector(n)`               | `table.specificType(name, 'vector(n)')`     |
+| `vector[]`     | `vector(n)[]`             | `table.specificType(name, 'vector(n)[]')`   |
+| `tsvector`     | `tsvector`                | `table.specificType(name, 'tsvector')`      |
 
 ## Execution Order (Important!)
 
@@ -248,7 +271,7 @@ The sync command references `dist/sonamu.config.js`. An error will occur if it d
 
 ```bash
 cd packages/api
-npx swc src/sonamu.config.ts -o dist/sonamu.config.js --config-file .swcrc
+pnpm exec tsdown --config tsdown.config.ts
 ```
 
 ### 2. Verify DB Connection
@@ -272,7 +295,7 @@ Split the migration, or set the FK to nullable and add it later.
 cd packages/api
 
 # 1. Build config
-npx swc src/sonamu.config.ts -o dist/sonamu.config.js --config-file .swcrc
+pnpm exec tsdown --config tsdown.config.ts
 
 # 2. Run sync
 pnpm sonamu sync