diff --git a/.changeset/lazy-sheets-align.md b/.changeset/lazy-sheets-align.md
new file mode 100644
index 000000000..fae2220bf
--- /dev/null
+++ b/.changeset/lazy-sheets-align.md
@@ -0,0 +1,5 @@
+---
+'@vapor-ui/core': patch
+---
+
+declare `Sheet.Root` and `Sheet.ResizeHandle` props as type aliases so the docs extractor picks them up
diff --git a/.claude/skills/write-component-jsdocs/SKILL.md b/.claude/skills/write-component-jsdocs/SKILL.md
index 1f7ee9c63..d96cea521 100644
--- a/.claude/skills/write-component-jsdocs/SKILL.md
+++ b/.claude/skills/write-component-jsdocs/SKILL.md
@@ -39,9 +39,12 @@ Placement depends on the component pattern. See [references/guide.md](references
 ## Component summary rules
 
 1. One single line — no line breaks inside the summary
-2. User perspective: what it is → when to use it
+2. Pattern by role:
+    - **Top-level**: `"A [noun] for/that [purpose]. Renders a \`<x>\` element."`
+    - **Sub-component**: `"A/An [noun] that [role]. Renders a \`<x>\` element."`
+    - **Root/wrapper (no HTML)**: `"Groups/Assembles [parts]. Doesn't render its own HTML element."`
 3. No internal terms (`memoized`, `wrapper`, `token-based`, etc.)
-4. End with the rendered HTML element using backticks around the tag: "Renders a `<button>` element." or "Doesn't render its own HTML element.".
+4. Always end with the rendered HTML element in backticks, or `Doesn't render its own HTML element.` for Root/Provider components.
 
 ## Prop description rules
 
@@ -49,7 +52,6 @@ Placement depends on the component pattern. See [references/guide.md](references
 2. Describe side effects and interactions with other props
 3. For numeric props: include unit and valid range
 4. For event handlers: specify the exact trigger condition, not just "handler"
-5. Use the `@default` JSDoc tag to indicate default values — never write `Default: \`value\`` inline in the description text
 
 ## Review checklist
 
diff --git a/.claude/skills/write-component-jsdocs/references/guide.md b/.claude/skills/write-component-jsdocs/references/guide.md
index 6aac1970a..d7c457373 100644
--- a/.claude/skills/write-component-jsdocs/references/guide.md
+++ b/.claude/skills/write-component-jsdocs/references/guide.md
@@ -44,7 +44,6 @@ export const root = componentRecipe({
     variants: {
         /**
          * Visual style of the button.
-         * @default 'fill'
          */
         variant: { fill: {}, outline: {}, ghost: {} },
     },
@@ -60,10 +59,7 @@ When custom props are defined via an `interface`, write JSDoc on the **interface
 export interface DialogRootProps
     extends DialogVariants, Omit<BaseDialog.Root.Props, 'disablePointerDismissal'> {
     /**
-     *
      * Closes the dialog when the overlay is clicked.
-     * @default true
-     */
     closeOnClickOverlay?: boolean;
 }
 
@@ -163,23 +159,58 @@ Do not write content on the line immediately after `/**`. Even single-line comme
 
 The JSDoc block directly above the component declaration. It's the first thing a developer reads on the documentation site.
 
-### Rules
+### Wording patterns by component role
 
-**1. Write the summary on a single line**
+**Top-level / standalone component** — One sentence: `"A [noun phrase] for/that [purpose]."` Focus on what it is and when to use it. End with the rendered HTML element.
 
-No line breaks inside the summary. Separate sentences with `.` only.
+```tsx
+/**
+ * A component for toggling between related panels on the same page. Renders a `<div>` element.
+ */
+
+/**
+ * A popup that opens on top of the entire page. Doesn't render its own HTML element.
+ */
+```
+
+**Compound sub-component** — One sentence: `"A/An [noun] that [role/behavior]. Renders a \`<x>\` element."`
 
 ```tsx
 /**
- * Button component for user interactions. Use for primary actions such as form submission, dialog triggers, and navigation.
+ * An individual interactive tab button that toggles the corresponding panel. Renders a `<button>` element.
+ */
+
+/**
+ * A panel displayed when the corresponding tab is active. Renders a `<div>` element.
+ */
+
+/**
+ * An accessible label that is automatically associated with the select trigger. Renders a `<label>` element.
  */
-export function Button(props: ButtonProps) { ... }
 ```
 
+**Root / wrapper (no HTML element)** — Use `"Groups [parts]."` or `"Assembles [parts]."` and end with `"Doesn't render its own HTML element."`
+
+```tsx
+/**
+ * Groups all parts of the dialog. Doesn't render its own HTML element.
+ */
+
+/**
+ * Assembles the tooltip component parts. Doesn't render its own HTML element.
+ */
+```
+
+### Rules
+
+**1. Write the summary on a single line**
+
+No line breaks inside the summary. Separate sentences with `.` only.
+
 **2. Write for a developer who has never seen this component**
 
 - No internal system names, team slang, or implementation details.
-- Order: "what it is" → "when to use it".
+- Order: "what it is / what it does" → rendered HTML element.
 
 ```tsx
 // ❌ implementation detail leaks
@@ -189,7 +220,7 @@ export function Button(props: ButtonProps) { ... }
 
 // ✅ user perspective
 /**
- * Button component for user interactions.
+ * A button that submits forms and triggers actions. Renders a `<button>` element.
  */
 ```
 
@@ -205,23 +236,23 @@ Fragments read poorly when rendered as-is on the documentation site.
 
 // ✅ complete sentence
 /**
- * Button component for user interactions.
+ * A button that submits forms and triggers actions. Renders a `<button>` element.
  */
 ```
 
 **4. State the rendered HTML element**
 
-End the summary with the element the component renders by default. Wrap the HTML tag in backticks. For components that don't render their own HTML element (Providers, Context wrappers), say so explicitly.
+End the summary with the element the component renders by default. Wrap the HTML tag in backticks. For components that don't render their own HTML element (Root, Provider, Context wrappers), end with `"Doesn't render its own HTML element."`
 
 ```tsx
 // renders a specific element
 /**
- * Button component for user interactions. Renders a `<button>` element.
+ * A button that submits forms and triggers actions. Renders a `<button>` element.
  */
 
 // renders no HTML element of its own
 /**
- * Provides theme context to its children. Doesn't render its own HTML element.
+ * Groups all parts of the dialog. Doesn't render its own HTML element.
  */
 ```
 
@@ -244,6 +275,90 @@ interface ButtonProps {
 }
 ```
 
+### Wording patterns by prop category
+
+Follow these patterns consistently — they match Base UI's documentation style and ensure a uniform developer experience.
+
+**Boolean props** — Use `"Whether [subject] [condition/state]."`:
+
+```tsx
+/**
+ * Whether the component should ignore user interaction.
+ */
+disabled?: boolean;
+
+/**
+ * Whether the user should be unable to tick or untick the checkbox.
+ */
+readOnly?: boolean;
+
+/**
+ * Whether the checkbox is initially ticked.
+ */
+defaultChecked?: boolean;
+```
+
+**Event handlers** — Use `"Event handler called when [exact condition]."`:
+
+```tsx
+// ❌ vague
+/**
+ * Called when the value changes.
+ */
+onChange?: (value: string) => void;
+
+// ✅ precise trigger
+/**
+ * Event handler called when the value of the select changes.
+ */
+onValueChange?: (value: string) => void;
+
+/**
+ * Event handler called when the checkbox is ticked or unticked.
+ */
+onCheckedChange?: (checked: boolean) => void;
+
+/**
+ * Event handler called when the dialog is opened or closed.
+ */
+onOpenChange?: (open: boolean) => void;
+```
+
+**Numeric props** — State the unit inline; add range or special values where relevant:
+
+```tsx
+/**
+ * Distance between the anchor and the popup, in pixels.
+ */
+sideOffset?: number;
+
+/**
+ * Delay before auto-dismissing, in milliseconds. Set to `0` to disable auto-dismiss.
+ */
+autoCloseMs?: number;
+```
+
+**render / className / style** — Use these fixed phrases verbatim:
+
+```tsx
+/**
+ * Allows you to replace the component's HTML element with a different tag, or compose it with another component.
+ */
+render?: React.ReactElement | ((props: object) => React.ReactElement);
+
+/**
+ * CSS class applied to the element, or a function that returns a class based on the component's state.
+ */
+className?: string | ((state: Root.State) => string);
+
+/**
+ * Style applied to the element, or a function that returns a style object based on the component's state.
+ */
+style?: React.CSSProperties | ((state: Root.State) => React.CSSProperties);
+```
+
+> Note: `render`, `className`, and `style` are inherited from Base UI primitives in most vapor-ui components. Only write JSDoc on them if your component overrides or extends their behavior.
+
 ### Rules
 
 **1. Don't repeat the prop name**
@@ -270,16 +385,12 @@ Explain what happens when the prop is set — especially when it interacts with
 
 ```tsx
 /**
- *
  * Disables the button, blocking all interactions and dimming its appearance. Automatically set to `true` when `loading` is `true`.
- * @default false
  */
 disabled?: boolean;
 
 /**
- *
  * Shows a spinner and disables the button while `true`.
- * @default false
  */
 loading?: boolean;
 ```
@@ -295,7 +406,7 @@ autoCloseMs?: number;
 
 **4. Specify the exact trigger condition for event handlers**
 
-Don't stop at "click handler" — say precisely when it fires.
+Use the `"Event handler called when …"` pattern. Don't stop at "click handler" — say precisely when it fires.
 
 ```tsx
 // ❌ vague
@@ -306,7 +417,7 @@ onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
 
 // ✅ exact trigger
 /**
- * Called when the button is clicked or activated via Enter or Space key.
+ * Event handler called when the button is clicked or activated via Enter or Space key.
  */
 onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
 ```
diff --git a/apps/website/.env.example b/apps/website/.env.example
new file mode 100644
index 000000000..4e8f7c34a
--- /dev/null
+++ b/apps/website/.env.example
@@ -0,0 +1,2 @@
+# OpenAI 호환 LLM 엔드포인트 — `pnpm translate`에 필요하다.
+LITELLM_BASE_URL=
diff --git a/apps/website/.gitignore b/apps/website/.gitignore
index ba1fd99ed..3bc315fd5 100644
--- a/apps/website/.gitignore
+++ b/apps/website/.gitignore
@@ -3,6 +3,7 @@
 
 # generated content
 .contentlayer
+**/.i18n-report.md
 .content-collections
 /.source/
 
diff --git a/apps/website/content/docs/components/(components)/floating-bar.mdx b/apps/website/content/docs/components/(components)/floating-bar.mdx
index 3824548db..71051727e 100644
--- a/apps/website/content/docs/components/(components)/floating-bar.mdx
+++ b/apps/website/content/docs/components/(components)/floating-bar.mdx
@@ -65,12 +65,12 @@ FloatingBar는 제어 형태로 사용되어, 여러 상태를 동시에 관리
 
 ### FloatingBar.PortalPrimitive
 
-<ComponentPropsTable componentName="floating-bar-portal" />
+<ComponentPropsTable componentName="floating-bar-portal-primitive" />
 
 ### FloatingBar.PositionerPrimitive
 
-<ComponentPropsTable componentName="floating-bar-positioner" />
+<ComponentPropsTable componentName="floating-bar-positioner-primitive" />
 
 ### FloatingBar.PopupPrimitive
 
-<ComponentPropsTable componentName="floating-bar-popup" />
+<ComponentPropsTable componentName="floating-bar-popup-primitive" />
diff --git a/apps/website/content/docs/components/(components)/menu.mdx b/apps/website/content/docs/components/(components)/menu.mdx
index d39cc5cfe..a21e1bfb8 100644
--- a/apps/website/content/docs/components/(components)/menu.mdx
+++ b/apps/website/content/docs/components/(components)/menu.mdx
@@ -111,7 +111,7 @@ Submenu를 구성할 수 있습니다.
 
 <ComponentPropsTable componentName="menu-trigger" />
 
-### Menu.PositionerPrimitive
+### Menu.Popup
 
 <ComponentPropsTable componentName="menu-popup" />
 
@@ -127,11 +127,11 @@ Submenu를 구성할 수 있습니다.
 
 <ComponentPropsTable componentName="menu-popup-primitive" />
 
-### Menu.CheckboxItemIndicatorPrimitive
+### Menu.Item
 
 <ComponentPropsTable componentName="menu-item" />
 
-### Menu.RadioItemIndicatorPrimitive
+### Menu.Separator
 
 <ComponentPropsTable componentName="menu-separator" />
 
diff --git a/apps/website/content/docs/components/(components)/toast.mdx b/apps/website/content/docs/components/(components)/toast.mdx
index 3b9a6bf4f..c51490a3d 100644
--- a/apps/website/content/docs/components/(components)/toast.mdx
+++ b/apps/website/content/docs/components/(components)/toast.mdx
@@ -144,7 +144,3 @@ Toast 아이템을 완전히 커스텀할 수 있습니다.
 ### Toast.IconPrimitive
 
 <ComponentPropsTable componentName="toast-icon-primitive" />
-
-### useToastManager
-
-<ComponentPropsTable componentName="toast-object" />
diff --git a/apps/website/docs-extractor.config.mjs b/apps/website/docs-extractor.config.mjs
deleted file mode 100644
index 1beeaddfe..000000000
--- a/apps/website/docs-extractor.config.mjs
+++ /dev/null
@@ -1,12 +0,0 @@
-import { defineConfig } from '@vapor-ui/ts-api-extractor';
-
-export default defineConfig({
-    inputPath: '../../packages/core',
-    tsconfig: '../../packages/core/tsconfig.json',
-    outputDir: './public/components/generated',
-    filterExternal: true,
-    filterHtml: true,
-    filterSprinkles: true,
-    includeHtml: ['className'],
-    components: {},
-});
diff --git a/apps/website/package.json b/apps/website/package.json
index 495219e36..2cbbc3717 100644
--- a/apps/website/package.json
+++ b/apps/website/package.json
@@ -7,10 +7,12 @@
         "build": "next build",
         "clean": "rm -rf node_modules .next .turbo .source",
         "dev": "next dev --turbo",
-        "extract": "ts-api-extractor --config ./docs-extractor.config.mjs",
+        "extract": "ts-api-extractor",
+        "i18n": "pnpm -F @vapor-ui/ts-api-extractor -F @vapor-ui/translation-pipeline build && pnpm extract && pnpm translate",
         "postinstall": "fumadocs-mdx",
         "lint": "eslint ./src",
         "start": "next start",
+        "translate": "translation-pipeline --input ./public/components/generated/en --output ./public/components/generated",
         "typecheck": "tsc --noEmit"
     },
     "dependencies": {
@@ -60,6 +62,7 @@
         "@types/node": "^22.19.20",
         "@types/react": "catalog:",
         "@types/react-dom": "catalog:",
+        "@vapor-ui/translation-pipeline": "workspace:*",
         "@vapor-ui/ts-api-extractor": "workspace:*",
         "eslint": "catalog:",
         "postcss": "^8.5.23",
diff --git a/apps/website/src/components/component-props-table/component-props-table.tsx b/apps/website/src/components/component-props-table/component-props-table.tsx
index 18847ef2b..769ae99d6 100644
--- a/apps/website/src/components/component-props-table/component-props-table.tsx
+++ b/apps/website/src/components/component-props-table/component-props-table.tsx
@@ -28,6 +28,16 @@ interface ComponentPropsTableProps {
     componentName: string;
 }
 
+const LOCALE_PREFERENCE = ['ko', 'en'] as const;
+
+const fetchComponentData = async (componentName: string): Promise<ComponentData> => {
+    for (const locale of LOCALE_PREFERENCE) {
+        const response = await fetch(`/components/generated/${locale}/${componentName}.json`);
+        if (response.ok) return response.json();
+    }
+    throw new Error(`Failed to load component data for ${componentName}`);
+};
+
 export const ComponentPropsTable = ({ componentName }: ComponentPropsTableProps) => {
     const [componentData, setComponentData] = React.useState<ComponentData | null>(null);
     const [loading, setLoading] = React.useState(true);
@@ -36,12 +46,7 @@ export const ComponentPropsTable = ({ componentName }: ComponentPropsTableProps)
     React.useEffect(() => {
         const loadComponentData = async () => {
             try {
-                const response = await fetch(`/components/generated/${componentName}.json`);
-                if (!response.ok) {
-                    throw new Error(`Failed to load component data for ${componentName}`);
-                }
-                const data = await response.json();
-                setComponentData(data);
+                setComponentData(await fetchComponentData(componentName));
             } catch (err) {
                 setError(err instanceof Error ? err.message : 'Unknown error');
             } finally {
diff --git a/apps/website/src/utils/get-component-doc.ts b/apps/website/src/utils/get-component-doc.ts
index 921ff3e85..053d9a2ed 100644
--- a/apps/website/src/utils/get-component-doc.ts
+++ b/apps/website/src/utils/get-component-doc.ts
@@ -14,19 +14,21 @@ interface ComponentDoc {
     props: PropDef[];
 }
 
+const LOCALE_PREFERENCE = ['ko', 'en'] as const;
+
+const findComponentDocPath = (componentName: string) =>
+    LOCALE_PREFERENCE.map((locale) =>
+        path.join(process.cwd(), 'public', 'components/generated', locale, `${componentName}.json`),
+    ).find((candidate) => fs.existsSync(candidate));
+
 export const replaceComponentDoc = (text: string) => {
     return text.replace(
         /<ComponentPropsTable\s+componentName="([^"]+)"\s*\/>/g,
         (_, componentName: string) => {
             try {
-                const jsonPath = path.join(
-                    process.cwd(),
-                    'public',
-                    'components/generated',
-                    `${componentName}.json`,
-                );
-
-                if (!fs.existsSync(jsonPath)) {
+                const jsonPath = findComponentDocPath(componentName);
+
+                if (!jsonPath) {
                     return `> ⚠️ Spec file not found: \`${componentName}.json\``;
                 }
 
diff --git a/packages/core/src/components/sheet/sheet.tsx b/packages/core/src/components/sheet/sheet.tsx
index f953c9d6b..074a84144 100644
--- a/packages/core/src/components/sheet/sheet.tsx
+++ b/packages/core/src/components/sheet/sheet.tsx
@@ -402,7 +402,7 @@ SheetDescription.displayName = 'Sheet.Description';
 
 export namespace SheetRoot {
     export type State = {};
-    export interface Props extends Omit<Dialog.Root.Props, 'size'> {}
+    export type Props = Omit<Dialog.Root.Props, 'size'>;
 
     export type ChangeEventDetails = BaseDialog.Root.ChangeEventDetails;
     export type Actions = BaseDialog.Root.Actions;
@@ -479,7 +479,7 @@ export interface SheetResizeHandleState {
 
 export namespace SheetResizeHandle {
     export type State = SheetResizeHandleState;
-    export interface Props extends VaporUIComponentProps<'div', State> {
+    export type Props = VaporUIComponentProps<'div', State> & {
         /**
          * Pixels adjusted per arrow-key press.
          * @default 16
@@ -489,7 +489,7 @@ export namespace SheetResizeHandle {
          * Blocks drag and keyboard resizing.
          */
         disabled?: boolean;
-    }
+    };
 }
 
 export namespace SheetHeader {
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 3bdd14650..6ed87c58e 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -137,7 +137,7 @@ importers:
         version: link:../../packages/typescript-config
       '@tailwindcss/vite':
         specifier: ^4.2.4
-        version: 4.2.4(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+        version: 4.2.4(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       '@types/culori':
         specifier: ^4.0.1
         version: 4.0.1
@@ -149,7 +149,7 @@ importers:
         version: 19.2.3(@types/react@19.2.17)
       '@vitejs/plugin-react':
         specifier: ^5.2.0
-        version: 5.2.0(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+        version: 5.2.0(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       concurrently:
         specifier: ^8.2.2
         version: 8.2.2
@@ -164,10 +164,10 @@ importers:
         version: 5.9.3
       vite:
         specifier: 'catalog:'
-        version: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+        version: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
       vite-plugin-singlefile:
         specifier: ^2.3.3
-        version: 2.3.3(rollup@4.61.1)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+        version: 2.3.3(rollup@4.61.1)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
 
   apps/storybook:
     dependencies:
@@ -189,13 +189,13 @@ importers:
         version: link:../../packages/typescript-config
       '@storybook/addon-docs':
         specifier: ^9.1.20
-        version: 9.1.20(@types/react@19.2.17)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))
+        version: 9.1.20(@types/react@19.2.17)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))
       '@storybook/builder-vite':
         specifier: ^9.1.20
-        version: 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+        version: 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       '@storybook/react-vite':
         specifier: ^9.1.20
-        version: 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(rollup@4.61.1)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))(typescript@5.9.3)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+        version: 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(rollup@4.61.1)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))(typescript@5.9.3)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       '@types/react':
         specifier: 'catalog:'
         version: 19.2.17
@@ -204,10 +204,10 @@ importers:
         version: 19.2.3(@types/react@19.2.17)
       '@vanilla-extract/vite-plugin':
         specifier: ^5.2.6
-        version: 5.2.6(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+        version: 5.2.6(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       '@vitejs/plugin-react':
         specifier: ^5.2.0
-        version: 5.2.0(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+        version: 5.2.0(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       eslint:
         specifier: 'catalog:'
         version: 9.39.5(jiti@2.6.1)
@@ -216,7 +216,7 @@ importers:
         version: 16.5.0
       storybook:
         specifier: ^9.1.20
-        version: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+        version: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       typescript:
         specifier: 'catalog:'
         version: 5.9.3
@@ -225,7 +225,7 @@ importers:
         version: 8.59.4(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3)
       vite:
         specifier: 'catalog:'
-        version: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+        version: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
 
   apps/website:
     dependencies:
@@ -282,7 +282,7 @@ importers:
         version: 3.0.10(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1)(@types/estree@1.0.9)(@types/hast@3.0.4)(@types/mdast@4.0.4)(fumadocs-core@16.8.11(@mdx-js/mdx@3.1.1)(@oramacloud/client@2.1.4)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.17)(lucide-react@1.14.0(react@19.2.8))(next@16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0))(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(zod@4.4.3))(mdast-util-mdx@3.0.0)
       fumadocs-mdx:
         specifier: 14.3.2
-        version: 14.3.2(@types/mdast@4.0.4)(@types/mdx@2.0.14)(@types/react@19.2.17)(fumadocs-core@16.8.11(@mdx-js/mdx@3.1.1)(@oramacloud/client@2.1.4)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.17)(lucide-react@1.14.0(react@19.2.8))(next@16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0))(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(zod@4.4.3))(next@16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0))(react@19.2.8)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+        version: 14.3.2(@types/mdast@4.0.4)(@types/mdx@2.0.14)(@types/react@19.2.17)(fumadocs-core@16.8.11(@mdx-js/mdx@3.1.1)(@oramacloud/client@2.1.4)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.17)(lucide-react@1.14.0(react@19.2.8))(next@16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0))(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(zod@4.4.3))(next@16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0))(react@19.2.8)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
       fumadocs-typescript:
         specifier: 5.2.6
         version: 5.2.6(c9e12f4a084b9f38cc659718a0de23dc)
@@ -362,6 +362,9 @@ importers:
       '@types/react-dom':
         specifier: 'catalog:'
         version: 19.2.3(@types/react@19.2.17)
+      '@vapor-ui/translation-pipeline':
+        specifier: workspace:*
+        version: link:../../scripts/translation-pipeline
       '@vapor-ui/ts-api-extractor':
         specifier: workspace:*
         version: link:../../scripts/ts-api-extractor
@@ -443,7 +446,7 @@ importers:
         version: 29.4.12(@babel/core@7.29.0)(@jest/transform@30.3.0)(@jest/types@30.3.0)(babel-jest@30.3.0(@babel/core@7.29.0))(esbuild@0.27.7)(jest-util@30.3.0)(jest@30.3.0(@types/node@20.19.43)(esbuild-register@3.6.0(esbuild@0.27.7))(ts-node@10.9.2(@types/node@20.19.43)(typescript@5.9.3)))(typescript@5.9.3)
       tsup:
         specifier: ^8.5.1
-        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.21.0)(typescript@5.9.3)
+        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.23.12)(typescript@5.9.3)
 
   packages/color-generator:
     dependencies:
@@ -541,7 +544,7 @@ importers:
         version: 16.0.3(rollup@4.60.4)
       '@storybook/react-vite':
         specifier: 9.1.20
-        version: 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(rollup@4.60.4)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)))(typescript@5.9.3)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+        version: 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(rollup@4.60.4)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)))(typescript@5.9.3)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
       '@testing-library/dom':
         specifier: ^10.4.1
         version: 10.4.1
@@ -568,10 +571,10 @@ importers:
         version: 1.5.4(rollup@4.60.4)
       '@vanilla-extract/vite-plugin':
         specifier: ^5.2.6
-        version: 5.2.6(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+        version: 5.2.6(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
       '@vitest/browser':
         specifier: 'catalog:'
-        version: 3.2.7(playwright@1.60.0)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))(vitest@3.2.7)
+        version: 3.2.7(playwright@1.60.0)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))(vitest@3.2.7)
       '@vitest/coverage-v8':
         specifier: 'catalog:'
         version: 3.2.7(@vitest/browser@3.2.7)(vitest@3.2.7)
@@ -616,7 +619,7 @@ importers:
         version: 5.9.3
       vitest:
         specifier: 'catalog:'
-        version: 3.2.7(@types/debug@4.1.12)(@types/node@22.19.21)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+        version: 3.2.7(@types/debug@4.1.12)(@types/node@22.19.21)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
       vitest-axe:
         specifier: ^1.0.0-pre.5
         version: 1.0.0-pre.5(vitest@3.2.7)
@@ -701,7 +704,7 @@ importers:
         version: 5.2.0(eslint@9.39.5(jiti@2.6.1))
       eslint-plugin-storybook:
         specifier: ^9.1.20
-        version: 9.1.20(eslint@9.39.5(jiti@2.6.1))(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))(typescript@5.9.3)
+        version: 9.1.20(eslint@9.39.5(jiti@2.6.1))(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))(typescript@5.9.3)
       globals:
         specifier: ^16.5.0
         version: 16.5.0
@@ -747,13 +750,13 @@ importers:
         version: 9.39.5(jiti@2.6.1)
       tsup:
         specifier: ^8.5.1
-        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.21.0)(typescript@5.9.3)
+        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.23.12)(typescript@5.9.3)
       typescript:
         specifier: ^5.9.3
         version: 5.9.3
       vitest:
         specifier: 'catalog:'
-        version: 3.2.7(@types/debug@4.1.12)(@types/node@20.19.43)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+        version: 3.2.7(@types/debug@4.1.12)(@types/node@20.19.43)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
 
   packages/hooks:
     devDependencies:
@@ -774,7 +777,7 @@ importers:
         version: 19.2.8
       tsup:
         specifier: ^8.5.1
-        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.21.0)(typescript@5.9.3)
+        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.23.12)(typescript@5.9.3)
       typescript:
         specifier: 'catalog:'
         version: 5.9.3
@@ -811,7 +814,7 @@ importers:
         version: 6.1.3
       tsup:
         specifier: ^8.5.1
-        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.21.0)(typescript@5.9.3)
+        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.23.12)(typescript@5.9.3)
       typescript:
         specifier: 'catalog:'
         version: 5.9.3
@@ -830,6 +833,37 @@ importers:
         specifier: ^1.1.1
         version: 1.1.1
 
+  scripts/translation-pipeline:
+    dependencies:
+      meow:
+        specifier: ^14.1.0
+        version: 14.1.0
+    devDependencies:
+      '@repo/eslint-config':
+        specifier: workspace:*
+        version: link:../../packages/eslint-config
+      '@types/node':
+        specifier: ^20.19.39
+        version: 20.19.43
+      '@vitest/coverage-v8':
+        specifier: ^2.1.9
+        version: 2.1.9(vitest@2.1.9(@types/node@20.19.43)(happy-dom@20.9.0)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0))
+      eslint:
+        specifier: ^9.39.4
+        version: 9.39.5(jiti@2.6.1)
+      tsup:
+        specifier: ^8.5.1
+        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.21.0)(typescript@5.9.3)
+      tsx:
+        specifier: ^4.21.0
+        version: 4.21.0
+      typescript:
+        specifier: 'catalog:'
+        version: 5.9.3
+      vitest:
+        specifier: ^2.1.9
+        version: 2.1.9(@types/node@20.19.43)(happy-dom@20.9.0)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)
+
   scripts/ts-api-extractor:
     dependencies:
       glob:
@@ -856,16 +890,16 @@ importers:
         version: 9.39.5(jiti@2.6.1)
       tsup:
         specifier: ^8.5.1
-        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.21.0)(typescript@5.9.3)
+        version: 8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.23.12)(typescript@5.9.3)
       tsx:
-        specifier: ^4.21.0
-        version: 4.21.0
+        specifier: ^4.23.1
+        version: 4.23.12
       typescript:
         specifier: 'catalog:'
         version: 5.9.3
       vitest:
         specifier: 'catalog:'
-        version: 3.2.7(@types/debug@4.1.12)(@types/node@20.19.43)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+        version: 3.2.7(@types/debug@4.1.12)(@types/node@20.19.43)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
 
 packages:
 
@@ -1788,6 +1822,12 @@ packages:
   '@emotion/hash@0.9.2':
     resolution: {integrity: sha512-MyqliTZGuOm3+5ZRSaaBGP3USLw6+EGykkwZns2EPC5g8jJ4z9OrdZY9apkl3+UP9+sdz76YYkwCKP5gh8iY3g==}
 
+  '@esbuild/aix-ppc64@0.21.5':
+    resolution: {integrity: sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==}
+    engines: {node: '>=12'}
+    cpu: [ppc64]
+    os: [aix]
+
   '@esbuild/aix-ppc64@0.25.12':
     resolution: {integrity: sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==}
     engines: {node: '>=18'}
@@ -1806,6 +1846,12 @@ packages:
     cpu: [ppc64]
     os: [aix]
 
+  '@esbuild/android-arm64@0.21.5':
+    resolution: {integrity: sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [android]
+
   '@esbuild/android-arm64@0.25.12':
     resolution: {integrity: sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==}
     engines: {node: '>=18'}
@@ -1824,6 +1870,12 @@ packages:
     cpu: [arm64]
     os: [android]
 
+  '@esbuild/android-arm@0.21.5':
+    resolution: {integrity: sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==}
+    engines: {node: '>=12'}
+    cpu: [arm]
+    os: [android]
+
   '@esbuild/android-arm@0.25.12':
     resolution: {integrity: sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==}
     engines: {node: '>=18'}
@@ -1842,6 +1894,12 @@ packages:
     cpu: [arm]
     os: [android]
 
+  '@esbuild/android-x64@0.21.5':
+    resolution: {integrity: sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [android]
+
   '@esbuild/android-x64@0.25.12':
     resolution: {integrity: sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==}
     engines: {node: '>=18'}
@@ -1860,6 +1918,12 @@ packages:
     cpu: [x64]
     os: [android]
 
+  '@esbuild/darwin-arm64@0.21.5':
+    resolution: {integrity: sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [darwin]
+
   '@esbuild/darwin-arm64@0.25.12':
     resolution: {integrity: sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==}
     engines: {node: '>=18'}
@@ -1878,6 +1942,12 @@ packages:
     cpu: [arm64]
     os: [darwin]
 
+  '@esbuild/darwin-x64@0.21.5':
+    resolution: {integrity: sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [darwin]
+
   '@esbuild/darwin-x64@0.25.12':
     resolution: {integrity: sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==}
     engines: {node: '>=18'}
@@ -1896,6 +1966,12 @@ packages:
     cpu: [x64]
     os: [darwin]
 
+  '@esbuild/freebsd-arm64@0.21.5':
+    resolution: {integrity: sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [freebsd]
+
   '@esbuild/freebsd-arm64@0.25.12':
     resolution: {integrity: sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==}
     engines: {node: '>=18'}
@@ -1914,6 +1990,12 @@ packages:
     cpu: [arm64]
     os: [freebsd]
 
+  '@esbuild/freebsd-x64@0.21.5':
+    resolution: {integrity: sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [freebsd]
+
   '@esbuild/freebsd-x64@0.25.12':
     resolution: {integrity: sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==}
     engines: {node: '>=18'}
@@ -1932,6 +2014,12 @@ packages:
     cpu: [x64]
     os: [freebsd]
 
+  '@esbuild/linux-arm64@0.21.5':
+    resolution: {integrity: sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [linux]
+
   '@esbuild/linux-arm64@0.25.12':
     resolution: {integrity: sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==}
     engines: {node: '>=18'}
@@ -1950,6 +2038,12 @@ packages:
     cpu: [arm64]
     os: [linux]
 
+  '@esbuild/linux-arm@0.21.5':
+    resolution: {integrity: sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==}
+    engines: {node: '>=12'}
+    cpu: [arm]
+    os: [linux]
+
   '@esbuild/linux-arm@0.25.12':
     resolution: {integrity: sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==}
     engines: {node: '>=18'}
@@ -1968,6 +2062,12 @@ packages:
     cpu: [arm]
     os: [linux]
 
+  '@esbuild/linux-ia32@0.21.5':
+    resolution: {integrity: sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==}
+    engines: {node: '>=12'}
+    cpu: [ia32]
+    os: [linux]
+
   '@esbuild/linux-ia32@0.25.12':
     resolution: {integrity: sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==}
     engines: {node: '>=18'}
@@ -1986,6 +2086,12 @@ packages:
     cpu: [ia32]
     os: [linux]
 
+  '@esbuild/linux-loong64@0.21.5':
+    resolution: {integrity: sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==}
+    engines: {node: '>=12'}
+    cpu: [loong64]
+    os: [linux]
+
   '@esbuild/linux-loong64@0.25.12':
     resolution: {integrity: sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==}
     engines: {node: '>=18'}
@@ -2004,6 +2110,12 @@ packages:
     cpu: [loong64]
     os: [linux]
 
+  '@esbuild/linux-mips64el@0.21.5':
+    resolution: {integrity: sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==}
+    engines: {node: '>=12'}
+    cpu: [mips64el]
+    os: [linux]
+
   '@esbuild/linux-mips64el@0.25.12':
     resolution: {integrity: sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==}
     engines: {node: '>=18'}
@@ -2022,6 +2134,12 @@ packages:
     cpu: [mips64el]
     os: [linux]
 
+  '@esbuild/linux-ppc64@0.21.5':
+    resolution: {integrity: sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==}
+    engines: {node: '>=12'}
+    cpu: [ppc64]
+    os: [linux]
+
   '@esbuild/linux-ppc64@0.25.12':
     resolution: {integrity: sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==}
     engines: {node: '>=18'}
@@ -2040,6 +2158,12 @@ packages:
     cpu: [ppc64]
     os: [linux]
 
+  '@esbuild/linux-riscv64@0.21.5':
+    resolution: {integrity: sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==}
+    engines: {node: '>=12'}
+    cpu: [riscv64]
+    os: [linux]
+
   '@esbuild/linux-riscv64@0.25.12':
     resolution: {integrity: sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==}
     engines: {node: '>=18'}
@@ -2058,6 +2182,12 @@ packages:
     cpu: [riscv64]
     os: [linux]
 
+  '@esbuild/linux-s390x@0.21.5':
+    resolution: {integrity: sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==}
+    engines: {node: '>=12'}
+    cpu: [s390x]
+    os: [linux]
+
   '@esbuild/linux-s390x@0.25.12':
     resolution: {integrity: sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==}
     engines: {node: '>=18'}
@@ -2076,6 +2206,12 @@ packages:
     cpu: [s390x]
     os: [linux]
 
+  '@esbuild/linux-x64@0.21.5':
+    resolution: {integrity: sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [linux]
+
   '@esbuild/linux-x64@0.25.12':
     resolution: {integrity: sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==}
     engines: {node: '>=18'}
@@ -2112,6 +2248,12 @@ packages:
     cpu: [arm64]
     os: [netbsd]
 
+  '@esbuild/netbsd-x64@0.21.5':
+    resolution: {integrity: sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [netbsd]
+
   '@esbuild/netbsd-x64@0.25.12':
     resolution: {integrity: sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==}
     engines: {node: '>=18'}
@@ -2148,6 +2290,12 @@ packages:
     cpu: [arm64]
     os: [openbsd]
 
+  '@esbuild/openbsd-x64@0.21.5':
+    resolution: {integrity: sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [openbsd]
+
   '@esbuild/openbsd-x64@0.25.12':
     resolution: {integrity: sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==}
     engines: {node: '>=18'}
@@ -2184,6 +2332,12 @@ packages:
     cpu: [arm64]
     os: [openharmony]
 
+  '@esbuild/sunos-x64@0.21.5':
+    resolution: {integrity: sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [sunos]
+
   '@esbuild/sunos-x64@0.25.12':
     resolution: {integrity: sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==}
     engines: {node: '>=18'}
@@ -2202,6 +2356,12 @@ packages:
     cpu: [x64]
     os: [sunos]
 
+  '@esbuild/win32-arm64@0.21.5':
+    resolution: {integrity: sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [win32]
+
   '@esbuild/win32-arm64@0.25.12':
     resolution: {integrity: sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==}
     engines: {node: '>=18'}
@@ -2220,6 +2380,12 @@ packages:
     cpu: [arm64]
     os: [win32]
 
+  '@esbuild/win32-ia32@0.21.5':
+    resolution: {integrity: sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==}
+    engines: {node: '>=12'}
+    cpu: [ia32]
+    os: [win32]
+
   '@esbuild/win32-ia32@0.25.12':
     resolution: {integrity: sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==}
     engines: {node: '>=18'}
@@ -2238,6 +2404,12 @@ packages:
     cpu: [ia32]
     os: [win32]
 
+  '@esbuild/win32-x64@0.21.5':
+    resolution: {integrity: sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [win32]
+
   '@esbuild/win32-x64@0.25.12':
     resolution: {integrity: sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==}
     engines: {node: '>=18'}
@@ -5058,6 +5230,15 @@ packages:
       webdriverio:
         optional: true
 
+  '@vitest/coverage-v8@2.1.9':
+    resolution: {integrity: sha512-Z2cOr0ksM00MpEfyVE8KXIYPEcBFxdbLSs56L8PO0QQMxt/6bDj45uQfxoc96v05KW3clk7vvgP0qfDit9DmfQ==}
+    peerDependencies:
+      '@vitest/browser': 2.1.9
+      vitest: 2.1.9
+    peerDependenciesMeta:
+      '@vitest/browser':
+        optional: true
+
   '@vitest/coverage-v8@3.2.7':
     resolution: {integrity: sha512-NEGWJS2XNu2PfRLQwOO3CTKj1tTETxNBdk454vDxVBhxJYhPaA/eS0nAI0c+1El1P7a60z8+i+ZrQoGESweGKg==}
     peerDependencies:
@@ -5067,12 +5248,26 @@ packages:
       '@vitest/browser':
         optional: true
 
+  '@vitest/expect@2.1.9':
+    resolution: {integrity: sha512-UJCIkTBenHeKT1TTlKMJWy1laZewsRIzYighyYiJKZreqtdxSos/S1t+ktRMQWu2CKqaarrkeszJx1cgC5tGZw==}
+
   '@vitest/expect@3.2.4':
     resolution: {integrity: sha512-Io0yyORnB6sikFlt8QW5K7slY4OjqNX9jmJQ02QDda8lyM6B5oNgVWoSoKPac8/kgnCUzuHQKrSLtu/uOqqrig==}
 
   '@vitest/expect@3.2.7':
     resolution: {integrity: sha512-E8eBXaKibuvH2pSZErOjdVb5vF4PbKYcrnluBTYxEk1l/VhhwZg1kZQsdtjq+CsF5CFydf2Rdkz7jDHKSisi3w==}
 
+  '@vitest/mocker@2.1.9':
+    resolution: {integrity: sha512-tVL6uJgoUdi6icpxmdrn5YNo3g3Dxv+IHJBr0GXHaEdTcw3F+cPKnsXFhli6nO+f/6SDKPHEK1UN+k+TQv0Ehg==}
+    peerDependencies:
+      msw: ^2.4.9
+      vite: ^5.0.0
+    peerDependenciesMeta:
+      msw:
+        optional: true
+      vite:
+        optional: true
+
   '@vitest/mocker@3.2.4':
     resolution: {integrity: sha512-46ryTE9RZO/rfDd7pEqFl7etuyzekzEhUbTW3BvmeO/BcCMEgq59BKhek3dXDWgAj4oMK6OZi+vRr1wPW6qjEQ==}
     peerDependencies:
@@ -5095,24 +5290,39 @@ packages:
       vite:
         optional: true
 
+  '@vitest/pretty-format@2.1.9':
+    resolution: {integrity: sha512-KhRIdGV2U9HOUzxfiHmY8IFHTdqtOhIzCpd8WRdJiE7D/HUcZVD0EgQCVjm+Q9gkUXWgBvMmTtZgIG48wq7sOQ==}
+
   '@vitest/pretty-format@3.2.4':
     resolution: {integrity: sha512-IVNZik8IVRJRTr9fxlitMKeJeXFFFN0JaB9PHPGQ8NKQbGpfjlTx9zO4RefN8gp7eqjNy8nyK3NZmBzOPeIxtA==}
 
   '@vitest/pretty-format@3.2.7':
     resolution: {integrity: sha512-KUHlwqVu0sRlhCdyPdQ/wBoTfRahjUky1MubOmYw9fWfIZy1gNoHpuaaQBPAaMaVYdQYHJLurzj8ECCj5OwTqA==}
 
+  '@vitest/runner@2.1.9':
+    resolution: {integrity: sha512-ZXSSqTFIrzduD63btIfEyOmNcBmQvgOVsPNPe0jYtESiXkhd8u2erDLnMxmGrDCwHCCHE7hxwRDCT3pt0esT4g==}
+
   '@vitest/runner@3.2.7':
     resolution: {integrity: sha512-sB9y4ovltoQP+WaUPwmSxO9WIg9Ig694Di5PalVPsYHklAdE027mehpWF2SQSVq+k6sFgaivbTjTJwZLSHbedA==}
 
+  '@vitest/snapshot@2.1.9':
+    resolution: {integrity: sha512-oBO82rEjsxLNJincVhLhaxxZdEtV0EFHMK5Kmx5sJ6H9L183dHECjiefOAdnqpIgT5eZwT04PoggUnW88vOBNQ==}
+
   '@vitest/snapshot@3.2.7':
     resolution: {integrity: sha512-7C+MwShwtBSI5Buwoyg3s/iY1eHL9PKAf+O1wVh/TdnjXUtkoL/9YQtre90i4MtNXM6edP1wJ2zOBpfCyhIS7g==}
 
+  '@vitest/spy@2.1.9':
+    resolution: {integrity: sha512-E1B35FwzXXTs9FHNK6bDszs7mtydNi5MIfUWpceJ8Xbfb1gBMscAnwLbEu+B44ed6W3XjL9/ehLPHR1fkf1KLQ==}
+
   '@vitest/spy@3.2.4':
     resolution: {integrity: sha512-vAfasCOe6AIK70iP5UD11Ac4siNUNJ9i/9PZ3NKx07sG6sUxeag1LWdNrMWeKKYBLlzuK+Gn65Yd5nyL6ds+nw==}
 
   '@vitest/spy@3.2.7':
     resolution: {integrity: sha512-Q2eQGI6d2L/hBtZ0qNuKcAGid68XK6cv1xsoaIma6PaJhHPoqcEJhYpXZ/5myCMqkNgtP6UKuBhbc0nHKnrkuQ==}
 
+  '@vitest/utils@2.1.9':
+    resolution: {integrity: sha512-v0psaMSkNJ3A2NMrUEHFRzJtDPFn+/VWZ5WxImB21T9fjucJRmS7xCS3ppEnARb9y11OAzaD+P2Ps+b+BGX5iQ==}
+
   '@vitest/utils@3.2.4':
     resolution: {integrity: sha512-fB2V0JFrQSMsCo9HiSq3Ezpdv4iYaXRG1Sx8edX3MwxfyNn83mKiGzOcH+Fkxt4MHxr3y42fQi1oeAInqgX2QA==}
 
@@ -5369,10 +5579,6 @@ packages:
   brace-expansion@1.1.12:
     resolution: {integrity: sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==}
 
-  brace-expansion@5.0.4:
-    resolution: {integrity: sha512-h+DEnpVvxmfVefa4jFbCf5HdH5YMDXRsmKflpf1pILZWRFlTbJpxeU55nJl4Smt5HQaGzg1o6RHFPJaOqnmBDg==}
-    engines: {node: 18 || 20 || >=22}
-
   brace-expansion@5.0.9:
     resolution: {integrity: sha512-ScQ4IuvIEF1TMlP7Zt+vjJ//9zlPb2SDcxWxM3bk8s6t6GGdJ7KO1dCcTidOPJKePW30LE/2cT7wCyPho9/Wxg==}
     engines: {node: 20 || >=22}
@@ -5907,6 +6113,11 @@ packages:
     peerDependencies:
       esbuild: '>=0.12 <1'
 
+  esbuild@0.21.5:
+    resolution: {integrity: sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==}
+    engines: {node: '>=12'}
+    hasBin: true
+
   esbuild@0.25.12:
     resolution: {integrity: sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==}
     engines: {node: '>=18'}
@@ -7850,6 +8061,9 @@ packages:
     resolution: {integrity: sha512-Vj7sf++t5pBD637NSfkxpHSMfWaeig5+DKWLhcqIYx6mWQz5hdJTGDVMQiJcw1ZYkhs7AazKDGpRVji1LJCZUQ==}
     engines: {node: '>=18'}
 
+  pathe@1.1.2:
+    resolution: {integrity: sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==}
+
   pathe@2.0.3:
     resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}
 
@@ -8643,10 +8857,18 @@ packages:
     resolution: {integrity: sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg==}
     engines: {node: ^18.0.0 || >=20.0.0}
 
+  tinyrainbow@1.2.0:
+    resolution: {integrity: sha512-weEDEq7Z5eTHPDh4xjX789+fHfF+P8boiFB+0vbWzpbnbsEr/GRaohi/uMKxg8RZMXnl1ItAi/IUHWMsjDV7kQ==}
+    engines: {node: '>=14.0.0'}
+
   tinyrainbow@2.0.0:
     resolution: {integrity: sha512-op4nsTR47R6p0vMUUoYl/a+ljLFVtlfaXkLQmqfLR1qHma1h/ysYk4hEXZ880bf2CYgTskvTa/e196Vd5dDQXw==}
     engines: {node: '>=14.0.0'}
 
+  tinyspy@3.0.2:
+    resolution: {integrity: sha512-n1cw8k1k0x4pgA2+9XrOkFydTerNcJ1zWCO5Nn9scWHTD+5tp8dghT2x1uduQePZTZgd3Tupf+x9BxJjeJi77Q==}
+    engines: {node: '>=14.0.0'}
+
   tinyspy@4.0.4:
     resolution: {integrity: sha512-azl+t0z7pw/z958Gy9svOTuzqIk6xq+NSheJzn5MMWtWTFywIacg2wUlzKFGtt3cthx0r2SxMK0yzJOR0IES7Q==}
     engines: {node: '>=14.0.0'}
@@ -8788,6 +9010,11 @@ packages:
     engines: {node: '>=18.0.0'}
     hasBin: true
 
+  tsx@4.23.12:
+    resolution: {integrity: sha512-FDf4L4sYzKtzWYhU/Xm0AQFdTjdIxNo9ElTf2mxXM6k8YMHXzYUe4yODVaXP4V9uMFbVg8c0qyBccK2OOxb45Q==}
+    engines: {node: '>=18.0.0'}
+    hasBin: true
+
   turbo@2.10.7:
     resolution: {integrity: sha512-GHx6WExIFSKNJ5qMlzDpXBXlu9ApxaMjqxAVrCNcW94xf/+uqgIz41SAuRUMbXva2ExNAaY/h8V0q90SWSzmRw==}
     hasBin: true
@@ -8989,6 +9216,11 @@ packages:
   vfile@6.0.3:
     resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==}
 
+  vite-node@2.1.9:
+    resolution: {integrity: sha512-AM9aQ/IPrW/6ENLQg3AGY4K1N2TGZdR5e4gu/MmmR2xR3Ll1+dib+nook92g4TV3PXVyeyxdWwtaCAiUL0hMxA==}
+    engines: {node: ^18.0.0 || >=20.0.0}
+    hasBin: true
+
   vite-node@3.2.4:
     resolution: {integrity: sha512-EbKSKh+bh1E1IFxeO0pg1n4dvoOTt0UDiXMd/qn++r98+jPO1xtJilvXldeuQ8giIB5IkpjCgMleHMNEsGH6pg==}
     engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0}
@@ -9009,6 +9241,37 @@ packages:
       rollup:
         optional: true
 
+  vite@5.4.21:
+    resolution: {integrity: sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==}
+    engines: {node: ^18.0.0 || >=20.0.0}
+    hasBin: true
+    peerDependencies:
+      '@types/node': ^18.0.0 || >=20.0.0
+      less: '*'
+      lightningcss: ^1.21.0
+      sass: '*'
+      sass-embedded: '*'
+      stylus: '*'
+      sugarss: '*'
+      terser: ^5.4.0
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+      less:
+        optional: true
+      lightningcss:
+        optional: true
+      sass:
+        optional: true
+      sass-embedded:
+        optional: true
+      stylus:
+        optional: true
+      sugarss:
+        optional: true
+      terser:
+        optional: true
+
   vite@7.3.5:
     resolution: {integrity: sha512-KuOaNhcnGFN2zIPGA7wRmzF+lJA1sea7rHq17aiJ++9lzY1WWG6Jpwqwe1KNbRVPIqHmr8GLYx7jbrQcN/7/ww==}
     engines: {node: ^20.19.0 || >=22.12.0}
@@ -9137,6 +9400,31 @@ packages:
     peerDependencies:
       vitest: '>=1'
 
+  vitest@2.1.9:
+    resolution: {integrity: sha512-MSmPM9REYqDGBI8439mA4mWhV5sKmDlBKWIYbA3lRb2PTHACE0mgKwA8yQ2xq9vxDTuk4iPrECBAEW2aoFXY0Q==}
+    engines: {node: ^18.0.0 || >=20.0.0}
+    hasBin: true
+    peerDependencies:
+      '@edge-runtime/vm': '*'
+      '@types/node': ^18.0.0 || >=20.0.0
+      '@vitest/browser': 2.1.9
+      '@vitest/ui': 2.1.9
+      happy-dom: '*'
+      jsdom: '*'
+    peerDependenciesMeta:
+      '@edge-runtime/vm':
+        optional: true
+      '@types/node':
+        optional: true
+      '@vitest/browser':
+        optional: true
+      '@vitest/ui':
+        optional: true
+      happy-dom:
+        optional: true
+      jsdom:
+        optional: true
+
   vitest@3.2.7:
     resolution: {integrity: sha512-KrxIJ62Fd89gfysR4WotlgZABiz2dqFPgqGzX7s+CwsqLFomRH7777ZcrOD6+WVAh7khPQP41A+BKbpcJFrdEg==}
     engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0}
@@ -11190,6 +11478,9 @@ snapshots:
 
   '@emotion/hash@0.9.2': {}
 
+  '@esbuild/aix-ppc64@0.21.5':
+    optional: true
+
   '@esbuild/aix-ppc64@0.25.12':
     optional: true
 
@@ -11199,6 +11490,9 @@ snapshots:
   '@esbuild/aix-ppc64@0.28.1':
     optional: true
 
+  '@esbuild/android-arm64@0.21.5':
+    optional: true
+
   '@esbuild/android-arm64@0.25.12':
     optional: true
 
@@ -11208,6 +11502,9 @@ snapshots:
   '@esbuild/android-arm64@0.28.1':
     optional: true
 
+  '@esbuild/android-arm@0.21.5':
+    optional: true
+
   '@esbuild/android-arm@0.25.12':
     optional: true
 
@@ -11217,6 +11514,9 @@ snapshots:
   '@esbuild/android-arm@0.28.1':
     optional: true
 
+  '@esbuild/android-x64@0.21.5':
+    optional: true
+
   '@esbuild/android-x64@0.25.12':
     optional: true
 
@@ -11226,6 +11526,9 @@ snapshots:
   '@esbuild/android-x64@0.28.1':
     optional: true
 
+  '@esbuild/darwin-arm64@0.21.5':
+    optional: true
+
   '@esbuild/darwin-arm64@0.25.12':
     optional: true
 
@@ -11235,6 +11538,9 @@ snapshots:
   '@esbuild/darwin-arm64@0.28.1':
     optional: true
 
+  '@esbuild/darwin-x64@0.21.5':
+    optional: true
+
   '@esbuild/darwin-x64@0.25.12':
     optional: true
 
@@ -11244,6 +11550,9 @@ snapshots:
   '@esbuild/darwin-x64@0.28.1':
     optional: true
 
+  '@esbuild/freebsd-arm64@0.21.5':
+    optional: true
+
   '@esbuild/freebsd-arm64@0.25.12':
     optional: true
 
@@ -11253,6 +11562,9 @@ snapshots:
   '@esbuild/freebsd-arm64@0.28.1':
     optional: true
 
+  '@esbuild/freebsd-x64@0.21.5':
+    optional: true
+
   '@esbuild/freebsd-x64@0.25.12':
     optional: true
 
@@ -11262,6 +11574,9 @@ snapshots:
   '@esbuild/freebsd-x64@0.28.1':
     optional: true
 
+  '@esbuild/linux-arm64@0.21.5':
+    optional: true
+
   '@esbuild/linux-arm64@0.25.12':
     optional: true
 
@@ -11271,6 +11586,9 @@ snapshots:
   '@esbuild/linux-arm64@0.28.1':
     optional: true
 
+  '@esbuild/linux-arm@0.21.5':
+    optional: true
+
   '@esbuild/linux-arm@0.25.12':
     optional: true
 
@@ -11280,6 +11598,9 @@ snapshots:
   '@esbuild/linux-arm@0.28.1':
     optional: true
 
+  '@esbuild/linux-ia32@0.21.5':
+    optional: true
+
   '@esbuild/linux-ia32@0.25.12':
     optional: true
 
@@ -11289,6 +11610,9 @@ snapshots:
   '@esbuild/linux-ia32@0.28.1':
     optional: true
 
+  '@esbuild/linux-loong64@0.21.5':
+    optional: true
+
   '@esbuild/linux-loong64@0.25.12':
     optional: true
 
@@ -11298,6 +11622,9 @@ snapshots:
   '@esbuild/linux-loong64@0.28.1':
     optional: true
 
+  '@esbuild/linux-mips64el@0.21.5':
+    optional: true
+
   '@esbuild/linux-mips64el@0.25.12':
     optional: true
 
@@ -11307,6 +11634,9 @@ snapshots:
   '@esbuild/linux-mips64el@0.28.1':
     optional: true
 
+  '@esbuild/linux-ppc64@0.21.5':
+    optional: true
+
   '@esbuild/linux-ppc64@0.25.12':
     optional: true
 
@@ -11316,6 +11646,9 @@ snapshots:
   '@esbuild/linux-ppc64@0.28.1':
     optional: true
 
+  '@esbuild/linux-riscv64@0.21.5':
+    optional: true
+
   '@esbuild/linux-riscv64@0.25.12':
     optional: true
 
@@ -11325,6 +11658,9 @@ snapshots:
   '@esbuild/linux-riscv64@0.28.1':
     optional: true
 
+  '@esbuild/linux-s390x@0.21.5':
+    optional: true
+
   '@esbuild/linux-s390x@0.25.12':
     optional: true
 
@@ -11334,6 +11670,9 @@ snapshots:
   '@esbuild/linux-s390x@0.28.1':
     optional: true
 
+  '@esbuild/linux-x64@0.21.5':
+    optional: true
+
   '@esbuild/linux-x64@0.25.12':
     optional: true
 
@@ -11352,6 +11691,9 @@ snapshots:
   '@esbuild/netbsd-arm64@0.28.1':
     optional: true
 
+  '@esbuild/netbsd-x64@0.21.5':
+    optional: true
+
   '@esbuild/netbsd-x64@0.25.12':
     optional: true
 
@@ -11370,6 +11712,9 @@ snapshots:
   '@esbuild/openbsd-arm64@0.28.1':
     optional: true
 
+  '@esbuild/openbsd-x64@0.21.5':
+    optional: true
+
   '@esbuild/openbsd-x64@0.25.12':
     optional: true
 
@@ -11388,6 +11733,9 @@ snapshots:
   '@esbuild/openharmony-arm64@0.28.1':
     optional: true
 
+  '@esbuild/sunos-x64@0.21.5':
+    optional: true
+
   '@esbuild/sunos-x64@0.25.12':
     optional: true
 
@@ -11397,6 +11745,9 @@ snapshots:
   '@esbuild/sunos-x64@0.28.1':
     optional: true
 
+  '@esbuild/win32-arm64@0.21.5':
+    optional: true
+
   '@esbuild/win32-arm64@0.25.12':
     optional: true
 
@@ -11406,6 +11757,9 @@ snapshots:
   '@esbuild/win32-arm64@0.28.1':
     optional: true
 
+  '@esbuild/win32-ia32@0.21.5':
+    optional: true
+
   '@esbuild/win32-ia32@0.25.12':
     optional: true
 
@@ -11415,6 +11769,9 @@ snapshots:
   '@esbuild/win32-ia32@0.28.1':
     optional: true
 
+  '@esbuild/win32-x64@0.21.5':
+    optional: true
+
   '@esbuild/win32-x64@0.25.12':
     optional: true
 
@@ -11829,7 +12186,7 @@ snapshots:
   '@jest/console@30.3.0':
     dependencies:
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       chalk: 4.1.2
       jest-message-util: 30.3.0
       jest-util: 30.3.0
@@ -11843,14 +12200,14 @@ snapshots:
       '@jest/test-result': 30.3.0
       '@jest/transform': 30.3.0
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       ansi-escapes: 4.3.2
       chalk: 4.1.2
       ci-info: 4.3.1
       exit-x: 0.2.2
       graceful-fs: 4.2.11
       jest-changed-files: 30.3.0
-      jest-config: 30.3.0(@types/node@22.19.21)(esbuild-register@3.6.0(esbuild@0.27.7))(ts-node@10.9.2(@types/node@20.19.43)(typescript@5.9.3))
+      jest-config: 30.3.0(@types/node@20.19.43)(esbuild-register@3.6.0(esbuild@0.27.7))(ts-node@10.9.2(@types/node@20.19.43)(typescript@5.9.3))
       jest-haste-map: 30.3.0
       jest-message-util: 30.3.0
       jest-regex-util: 30.0.1
@@ -11876,7 +12233,7 @@ snapshots:
     dependencies:
       '@jest/fake-timers': 30.3.0
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       jest-mock: 30.3.0
 
   '@jest/expect-utils@29.7.0':
@@ -11898,7 +12255,7 @@ snapshots:
     dependencies:
       '@jest/types': 30.3.0
       '@sinonjs/fake-timers': 15.3.2
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       jest-message-util: 30.3.0
       jest-mock: 30.3.0
       jest-util: 30.3.0
@@ -11916,7 +12273,7 @@ snapshots:
 
   '@jest/pattern@30.0.1':
     dependencies:
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       jest-regex-util: 30.0.1
 
   '@jest/reporters@30.3.0':
@@ -11927,7 +12284,7 @@ snapshots:
       '@jest/transform': 30.3.0
       '@jest/types': 30.3.0
       '@jridgewell/trace-mapping': 0.3.31
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       chalk: 4.1.2
       collect-v8-coverage: 1.0.2
       exit-x: 0.2.2
@@ -12006,7 +12363,7 @@ snapshots:
       '@jest/schemas': 29.6.3
       '@types/istanbul-lib-coverage': 2.0.6
       '@types/istanbul-reports': 3.0.4
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       '@types/yargs': 17.0.35
       chalk: 4.1.2
 
@@ -12016,25 +12373,25 @@ snapshots:
       '@jest/schemas': 30.0.5
       '@types/istanbul-lib-coverage': 2.0.6
       '@types/istanbul-reports': 3.0.4
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       '@types/yargs': 17.0.35
       chalk: 4.1.2
 
-  '@joshwooding/vite-plugin-react-docgen-typescript@0.6.1(typescript@5.9.3)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))':
+  '@joshwooding/vite-plugin-react-docgen-typescript@0.6.1(typescript@5.9.3)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
       glob: 10.5.0
       magic-string: 0.30.21
       react-docgen-typescript: 2.4.0(typescript@5.9.3)
-      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
     optionalDependencies:
       typescript: 5.9.3
 
-  '@joshwooding/vite-plugin-react-docgen-typescript@0.6.1(typescript@5.9.3)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))':
+  '@joshwooding/vite-plugin-react-docgen-typescript@0.6.1(typescript@5.9.3)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
       glob: 10.5.0
       magic-string: 0.30.21
       react-docgen-typescript: 2.4.0(typescript@5.9.3)
-      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
     optionalDependencies:
       typescript: 5.9.3
 
@@ -13097,41 +13454,41 @@ snapshots:
 
   '@standard-schema/spec@1.1.0': {}
 
-  '@storybook/addon-docs@9.1.20(@types/react@19.2.17)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))':
+  '@storybook/addon-docs@9.1.20(@types/react@19.2.17)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))':
     dependencies:
       '@mdx-js/react': 3.1.1(@types/react@19.2.17)(react@19.2.8)
-      '@storybook/csf-plugin': 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))
+      '@storybook/csf-plugin': 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))
       '@storybook/icons': 1.6.0(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
-      '@storybook/react-dom-shim': 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))
+      '@storybook/react-dom-shim': 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))
       react: 19.2.8
       react-dom: 19.2.8(react@19.2.8)
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       ts-dedent: 2.2.0
     transitivePeerDependencies:
       - '@types/react'
 
-  '@storybook/builder-vite@9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))':
+  '@storybook/builder-vite@9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
-      '@storybook/csf-plugin': 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      '@storybook/csf-plugin': 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       ts-dedent: 2.2.0
-      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
 
-  '@storybook/builder-vite@9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)))(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))':
+  '@storybook/builder-vite@9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)))(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
-      '@storybook/csf-plugin': 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)))
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+      '@storybook/csf-plugin': 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
       ts-dedent: 2.2.0
-      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
 
-  '@storybook/csf-plugin@9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))':
+  '@storybook/csf-plugin@9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))':
     dependencies:
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       unplugin: 1.16.1
 
-  '@storybook/csf-plugin@9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)))':
+  '@storybook/csf-plugin@9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)))':
     dependencies:
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
       unplugin: 1.16.1
 
   '@storybook/global@5.0.0': {}
@@ -13141,75 +13498,75 @@ snapshots:
       react: 19.2.8
       react-dom: 19.2.8(react@19.2.8)
 
-  '@storybook/react-dom-shim@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))':
+  '@storybook/react-dom-shim@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))':
     dependencies:
       react: 19.2.8
       react-dom: 19.2.8(react@19.2.8)
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
 
-  '@storybook/react-dom-shim@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)))':
+  '@storybook/react-dom-shim@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)))':
     dependencies:
       react: 19.2.8
       react-dom: 19.2.8(react@19.2.8)
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
 
-  '@storybook/react-vite@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(rollup@4.60.4)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)))(typescript@5.9.3)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))':
+  '@storybook/react-vite@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(rollup@4.60.4)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)))(typescript@5.9.3)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
-      '@joshwooding/vite-plugin-react-docgen-typescript': 0.6.1(typescript@5.9.3)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+      '@joshwooding/vite-plugin-react-docgen-typescript': 0.6.1(typescript@5.9.3)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
       '@rollup/pluginutils': 5.3.0(rollup@4.60.4)
-      '@storybook/builder-vite': 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)))(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
-      '@storybook/react': 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)))(typescript@5.9.3)
+      '@storybook/builder-vite': 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)))(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
+      '@storybook/react': 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)))(typescript@5.9.3)
       find-up: 7.0.0
       magic-string: 0.30.21
       react: 19.2.8
       react-docgen: 8.0.2
       react-dom: 19.2.8(react@19.2.8)
       resolve: 1.22.10
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
       tsconfig-paths: 4.2.0
-      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - rollup
       - supports-color
       - typescript
 
-  '@storybook/react-vite@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(rollup@4.61.1)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))(typescript@5.9.3)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))':
+  '@storybook/react-vite@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(rollup@4.61.1)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))(typescript@5.9.3)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
-      '@joshwooding/vite-plugin-react-docgen-typescript': 0.6.1(typescript@5.9.3)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      '@joshwooding/vite-plugin-react-docgen-typescript': 0.6.1(typescript@5.9.3)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       '@rollup/pluginutils': 5.3.0(rollup@4.61.1)
-      '@storybook/builder-vite': 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
-      '@storybook/react': 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))(typescript@5.9.3)
+      '@storybook/builder-vite': 9.1.20(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
+      '@storybook/react': 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))(typescript@5.9.3)
       find-up: 7.0.0
       magic-string: 0.30.21
       react: 19.2.8
       react-docgen: 8.0.2
       react-dom: 19.2.8(react@19.2.8)
       resolve: 1.22.10
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       tsconfig-paths: 4.2.0
-      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - rollup
       - supports-color
       - typescript
 
-  '@storybook/react@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))(typescript@5.9.3)':
+  '@storybook/react@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))(typescript@5.9.3)':
     dependencies:
       '@storybook/global': 5.0.0
-      '@storybook/react-dom-shim': 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))
+      '@storybook/react-dom-shim': 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))
       react: 19.2.8
       react-dom: 19.2.8(react@19.2.8)
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
     optionalDependencies:
       typescript: 5.9.3
 
-  '@storybook/react@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)))(typescript@5.9.3)':
+  '@storybook/react@9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)))(typescript@5.9.3)':
     dependencies:
       '@storybook/global': 5.0.0
-      '@storybook/react-dom-shim': 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)))
+      '@storybook/react-dom-shim': 9.1.20(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)))
       react: 19.2.8
       react-dom: 19.2.8(react@19.2.8)
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
     optionalDependencies:
       typescript: 5.9.3
 
@@ -13379,12 +13736,12 @@ snapshots:
       postcss: 8.5.25
       tailwindcss: 4.2.4
 
-  '@tailwindcss/vite@4.2.4(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))':
+  '@tailwindcss/vite@4.2.4(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
       '@tailwindcss/node': 4.2.4
       '@tailwindcss/oxide': 4.2.4
       tailwindcss: 4.2.4
-      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
 
   '@tanstack/react-table@8.21.3(react-dom@19.2.8(react@19.2.8))(react@19.2.8)':
     dependencies:
@@ -13654,7 +14011,7 @@ snapshots:
 
   '@types/ws@8.18.1':
     dependencies:
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
 
   '@types/yargs-parser@21.0.3': {}
 
@@ -13932,12 +14289,12 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  '@vanilla-extract/compiler@0.7.2(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)':
+  '@vanilla-extract/compiler@0.7.2(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)':
     dependencies:
       '@vanilla-extract/css': 1.21.2
       '@vanilla-extract/integration': 8.0.10
-      vite: 7.3.6(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
-      vite-node: 6.0.0(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.6(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
+      vite-node: 6.0.0(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - '@types/node'
       - '@vitejs/devtools'
@@ -13955,12 +14312,12 @@ snapshots:
       - tsx
       - yaml
 
-  '@vanilla-extract/compiler@0.7.2(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)':
+  '@vanilla-extract/compiler@0.7.2(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)':
     dependencies:
       '@vanilla-extract/css': 1.21.2
       '@vanilla-extract/integration': 8.0.10
-      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
-      vite-node: 6.0.0(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
+      vite-node: 6.0.0(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - '@types/node'
       - '@vitejs/devtools'
@@ -14035,11 +14392,11 @@ snapshots:
     dependencies:
       '@vanilla-extract/css': 1.21.2
 
-  '@vanilla-extract/vite-plugin@5.2.6(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))':
+  '@vanilla-extract/vite-plugin@5.2.6(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
-      '@vanilla-extract/compiler': 0.7.2(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      '@vanilla-extract/compiler': 0.7.2(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
       '@vanilla-extract/integration': 8.0.10
-      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - '@types/node'
       - '@vitejs/devtools'
@@ -14057,11 +14414,11 @@ snapshots:
       - tsx
       - yaml
 
-  '@vanilla-extract/vite-plugin@5.2.6(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))':
+  '@vanilla-extract/vite-plugin@5.2.6(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
-      '@vanilla-extract/compiler': 0.7.2(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      '@vanilla-extract/compiler': 0.7.2(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
       '@vanilla-extract/integration': 8.0.10
-      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - '@types/node'
       - '@vitejs/devtools'
@@ -14084,7 +14441,7 @@ snapshots:
       next: 16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0)
       react: 19.2.8
 
-  '@vitejs/plugin-react@5.2.0(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))':
+  '@vitejs/plugin-react@5.2.0(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
       '@babel/core': 7.29.0
       '@babel/plugin-transform-react-jsx-self': 7.27.1(@babel/core@7.29.0)
@@ -14092,7 +14449,7 @@ snapshots:
       '@rolldown/pluginutils': 1.0.0-rc.3
       '@types/babel__core': 7.20.5
       react-refresh: 0.18.0
-      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - supports-color
 
@@ -14116,16 +14473,16 @@ snapshots:
       - vite
     optional: true
 
-  '@vitest/browser@3.2.7(playwright@1.60.0)(vite@7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))(vitest@3.2.7)':
+  '@vitest/browser@3.2.7(playwright@1.60.0)(vite@7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))(vitest@3.2.7)':
     dependencies:
       '@testing-library/dom': 10.4.1
       '@testing-library/user-event': 14.6.1(@testing-library/dom@10.4.1)
-      '@vitest/mocker': 3.2.7(vite@7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      '@vitest/mocker': 3.2.7(vite@7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       '@vitest/utils': 3.2.7
       magic-string: 0.30.21
       sirv: 3.0.2
       tinyrainbow: 2.0.0
-      vitest: 3.2.7(@types/debug@4.1.12)(@types/node@20.19.43)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vitest: 3.2.7(@types/debug@4.1.12)(@types/node@20.19.43)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
       ws: 8.20.0
     optionalDependencies:
       playwright: 1.60.0
@@ -14136,16 +14493,16 @@ snapshots:
       - vite
     optional: true
 
-  '@vitest/browser@3.2.7(playwright@1.60.0)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))(vitest@3.2.7)':
+  '@vitest/browser@3.2.7(playwright@1.60.0)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))(vitest@3.2.7)':
     dependencies:
       '@testing-library/dom': 10.4.1
       '@testing-library/user-event': 14.6.1(@testing-library/dom@10.4.1)
-      '@vitest/mocker': 3.2.7(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+      '@vitest/mocker': 3.2.7(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
       '@vitest/utils': 3.2.7
       magic-string: 0.30.21
       sirv: 3.0.2
       tinyrainbow: 2.0.0
-      vitest: 3.2.7(@types/debug@4.1.12)(@types/node@22.19.21)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vitest: 3.2.7(@types/debug@4.1.12)(@types/node@22.19.21)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
       ws: 8.20.0
     optionalDependencies:
       playwright: 1.60.0
@@ -14155,6 +14512,24 @@ snapshots:
       - utf-8-validate
       - vite
 
+  '@vitest/coverage-v8@2.1.9(vitest@2.1.9(@types/node@20.19.43)(happy-dom@20.9.0)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0))':
+    dependencies:
+      '@ampproject/remapping': 2.3.0
+      '@bcoe/v8-coverage': 0.2.3
+      debug: 4.4.3
+      istanbul-lib-coverage: 3.2.2
+      istanbul-lib-report: 3.0.1
+      istanbul-lib-source-maps: 5.0.6
+      istanbul-reports: 3.2.0
+      magic-string: 0.30.21
+      magicast: 0.3.5
+      std-env: 3.10.0
+      test-exclude: 7.0.1
+      tinyrainbow: 1.2.0
+      vitest: 2.1.9(@types/node@20.19.43)(happy-dom@20.9.0)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)
+    transitivePeerDependencies:
+      - supports-color
+
   '@vitest/coverage-v8@3.2.7(@vitest/browser@3.2.7)(vitest@3.2.7)':
     dependencies:
       '@ampproject/remapping': 2.3.0
@@ -14170,12 +14545,19 @@ snapshots:
       std-env: 3.10.0
       test-exclude: 7.0.1
       tinyrainbow: 2.0.0
-      vitest: 3.2.7(@types/debug@4.1.12)(@types/node@22.19.21)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vitest: 3.2.7(@types/debug@4.1.12)(@types/node@22.19.21)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
     optionalDependencies:
-      '@vitest/browser': 3.2.7(playwright@1.60.0)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))(vitest@3.2.7)
+      '@vitest/browser': 3.2.7(playwright@1.60.0)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))(vitest@3.2.7)
     transitivePeerDependencies:
       - supports-color
 
+  '@vitest/expect@2.1.9':
+    dependencies:
+      '@vitest/spy': 2.1.9
+      '@vitest/utils': 2.1.9
+      chai: 5.3.3
+      tinyrainbow: 1.2.0
+
   '@vitest/expect@3.2.4':
     dependencies:
       '@types/chai': 5.2.3
@@ -14192,29 +14574,37 @@ snapshots:
       chai: 5.3.3
       tinyrainbow: 2.0.0
 
-  '@vitest/mocker@3.2.4(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))':
+  '@vitest/mocker@2.1.9(vite@5.4.21(@types/node@20.19.43)(lightningcss@1.32.0)(sass@1.99.0))':
+    dependencies:
+      '@vitest/spy': 2.1.9
+      estree-walker: 3.0.3
+      magic-string: 0.30.21
+    optionalDependencies:
+      vite: 5.4.21(@types/node@20.19.43)(lightningcss@1.32.0)(sass@1.99.0)
+
+  '@vitest/mocker@3.2.4(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
       '@vitest/spy': 3.2.4
       estree-walker: 3.0.3
       magic-string: 0.30.21
     optionalDependencies:
-      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
 
-  '@vitest/mocker@3.2.4(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))':
+  '@vitest/mocker@3.2.4(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
       '@vitest/spy': 3.2.4
       estree-walker: 3.0.3
       magic-string: 0.30.21
     optionalDependencies:
-      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
 
-  '@vitest/mocker@3.2.7(vite@7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))':
+  '@vitest/mocker@3.2.7(vite@7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
       '@vitest/spy': 3.2.7
       estree-walker: 3.0.3
       magic-string: 0.30.21
     optionalDependencies:
-      vite: 7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
 
   '@vitest/mocker@3.2.7(vite@7.3.5(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))':
     dependencies:
@@ -14224,22 +14614,34 @@ snapshots:
     optionalDependencies:
       vite: 7.3.5(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
 
-  '@vitest/mocker@3.2.7(vite@7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))':
+  '@vitest/mocker@3.2.7(vite@7.3.5(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
       '@vitest/spy': 3.2.7
       estree-walker: 3.0.3
       magic-string: 0.30.21
     optionalDependencies:
-      vite: 7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.5(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
+
+  '@vitest/mocker@3.2.7(vite@7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))':
+    dependencies:
+      '@vitest/spy': 3.2.7
+      estree-walker: 3.0.3
+      magic-string: 0.30.21
+    optionalDependencies:
+      vite: 7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
     optional: true
 
-  '@vitest/mocker@3.2.7(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))':
+  '@vitest/mocker@3.2.7(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))':
     dependencies:
       '@vitest/spy': 3.2.7
       estree-walker: 3.0.3
       magic-string: 0.30.21
     optionalDependencies:
-      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
+
+  '@vitest/pretty-format@2.1.9':
+    dependencies:
+      tinyrainbow: 1.2.0
 
   '@vitest/pretty-format@3.2.4':
     dependencies:
@@ -14249,18 +14651,33 @@ snapshots:
     dependencies:
       tinyrainbow: 2.0.0
 
+  '@vitest/runner@2.1.9':
+    dependencies:
+      '@vitest/utils': 2.1.9
+      pathe: 1.1.2
+
   '@vitest/runner@3.2.7':
     dependencies:
       '@vitest/utils': 3.2.7
       pathe: 2.0.3
       strip-literal: 3.1.0
 
+  '@vitest/snapshot@2.1.9':
+    dependencies:
+      '@vitest/pretty-format': 2.1.9
+      magic-string: 0.30.21
+      pathe: 1.1.2
+
   '@vitest/snapshot@3.2.7':
     dependencies:
       '@vitest/pretty-format': 3.2.7
       magic-string: 0.30.21
       pathe: 2.0.3
 
+  '@vitest/spy@2.1.9':
+    dependencies:
+      tinyspy: 3.0.2
+
   '@vitest/spy@3.2.4':
     dependencies:
       tinyspy: 4.0.4
@@ -14269,6 +14686,12 @@ snapshots:
     dependencies:
       tinyspy: 4.0.4
 
+  '@vitest/utils@2.1.9':
+    dependencies:
+      '@vitest/pretty-format': 2.1.9
+      loupe: 3.2.1
+      tinyrainbow: 1.2.0
+
   '@vitest/utils@3.2.4':
     dependencies:
       '@vitest/pretty-format': 3.2.4
@@ -14604,10 +15027,6 @@ snapshots:
       balanced-match: 1.0.2
       concat-map: 0.0.1
 
-  brace-expansion@5.0.4:
-    dependencies:
-      balanced-match: 4.0.4
-
   brace-expansion@5.0.9:
     dependencies:
       balanced-match: 4.0.4
@@ -15174,6 +15593,32 @@ snapshots:
       - supports-color
     optional: true
 
+  esbuild@0.21.5:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.21.5
+      '@esbuild/android-arm': 0.21.5
+      '@esbuild/android-arm64': 0.21.5
+      '@esbuild/android-x64': 0.21.5
+      '@esbuild/darwin-arm64': 0.21.5
+      '@esbuild/darwin-x64': 0.21.5
+      '@esbuild/freebsd-arm64': 0.21.5
+      '@esbuild/freebsd-x64': 0.21.5
+      '@esbuild/linux-arm': 0.21.5
+      '@esbuild/linux-arm64': 0.21.5
+      '@esbuild/linux-ia32': 0.21.5
+      '@esbuild/linux-loong64': 0.21.5
+      '@esbuild/linux-mips64el': 0.21.5
+      '@esbuild/linux-ppc64': 0.21.5
+      '@esbuild/linux-riscv64': 0.21.5
+      '@esbuild/linux-s390x': 0.21.5
+      '@esbuild/linux-x64': 0.21.5
+      '@esbuild/netbsd-x64': 0.21.5
+      '@esbuild/openbsd-x64': 0.21.5
+      '@esbuild/sunos-x64': 0.21.5
+      '@esbuild/win32-arm64': 0.21.5
+      '@esbuild/win32-ia32': 0.21.5
+      '@esbuild/win32-x64': 0.21.5
+
   esbuild@0.25.12:
     optionalDependencies:
       '@esbuild/aix-ppc64': 0.25.12
@@ -15277,7 +15722,7 @@ snapshots:
       '@typescript-eslint/parser': 8.59.4(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3)
       eslint: 9.39.5(jiti@2.6.1)
       eslint-import-resolver-node: 0.3.9
-      eslint-import-resolver-typescript: 3.10.1(eslint-plugin-import-x@4.16.2(@typescript-eslint/utils@8.63.0(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3))(eslint-import-resolver-node@0.3.9)(eslint@9.39.5(jiti@2.6.1)))(eslint-plugin-import@2.32.0)(eslint@9.39.5(jiti@2.6.1))
+      eslint-import-resolver-typescript: 3.10.1(eslint-plugin-import-x@4.16.2(@typescript-eslint/utils@8.63.0(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3))(eslint-import-resolver-node@0.3.9)(eslint@9.39.5(jiti@2.6.1)))(eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.59.4(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3))(eslint@9.39.5(jiti@2.6.1)))(eslint@9.39.5(jiti@2.6.1))
       eslint-plugin-import: 2.32.0(@typescript-eslint/parser@8.59.4(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3))(eslint-import-resolver-typescript@3.10.1)(eslint@9.39.5(jiti@2.6.1))
       eslint-plugin-jsx-a11y: 6.10.2(eslint@9.39.5(jiti@2.6.1))
       eslint-plugin-react: 7.37.5(eslint@9.39.5(jiti@2.6.1))
@@ -15310,7 +15755,7 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  eslint-import-resolver-typescript@3.10.1(eslint-plugin-import-x@4.16.2(@typescript-eslint/utils@8.63.0(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3))(eslint-import-resolver-node@0.3.9)(eslint@9.39.5(jiti@2.6.1)))(eslint-plugin-import@2.32.0)(eslint@9.39.5(jiti@2.6.1)):
+  eslint-import-resolver-typescript@3.10.1(eslint-plugin-import-x@4.16.2(@typescript-eslint/utils@8.63.0(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3))(eslint-import-resolver-node@0.3.9)(eslint@9.39.5(jiti@2.6.1)))(eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.59.4(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3))(eslint@9.39.5(jiti@2.6.1)))(eslint@9.39.5(jiti@2.6.1)):
     dependencies:
       '@nolyfill/is-core-module': 1.0.39
       debug: 4.4.3
@@ -15333,7 +15778,7 @@ snapshots:
       '@typescript-eslint/parser': 8.59.4(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3)
       eslint: 9.39.5(jiti@2.6.1)
       eslint-import-resolver-node: 0.3.9
-      eslint-import-resolver-typescript: 3.10.1(eslint-plugin-import-x@4.16.2(@typescript-eslint/utils@8.63.0(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3))(eslint-import-resolver-node@0.3.9)(eslint@9.39.5(jiti@2.6.1)))(eslint-plugin-import@2.32.0)(eslint@9.39.5(jiti@2.6.1))
+      eslint-import-resolver-typescript: 3.10.1(eslint-plugin-import-x@4.16.2(@typescript-eslint/utils@8.63.0(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3))(eslint-import-resolver-node@0.3.9)(eslint@9.39.5(jiti@2.6.1)))(eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.59.4(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3))(eslint@9.39.5(jiti@2.6.1)))(eslint@9.39.5(jiti@2.6.1))
     transitivePeerDependencies:
       - supports-color
 
@@ -15430,11 +15875,11 @@ snapshots:
       string.prototype.matchall: 4.0.12
       string.prototype.repeat: 1.0.0
 
-  eslint-plugin-storybook@9.1.20(eslint@9.39.5(jiti@2.6.1))(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)))(typescript@5.9.3):
+  eslint-plugin-storybook@9.1.20(eslint@9.39.5(jiti@2.6.1))(storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)))(typescript@5.9.3):
     dependencies:
       '@typescript-eslint/utils': 8.59.2(eslint@9.39.5(jiti@2.6.1))(typescript@5.9.3)
       eslint: 9.39.5(jiti@2.6.1)
-      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      storybook: 9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
     transitivePeerDependencies:
       - supports-color
       - typescript
@@ -15558,7 +16003,7 @@ snapshots:
 
   eval@0.1.8:
     dependencies:
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       require-like: 0.1.2
 
   execa@0.4.0:
@@ -15788,7 +16233,7 @@ snapshots:
       - '@emnapi/core'
       - '@emnapi/runtime'
 
-  fumadocs-mdx@14.3.2(@types/mdast@4.0.4)(@types/mdx@2.0.14)(@types/react@19.2.17)(fumadocs-core@16.8.11(@mdx-js/mdx@3.1.1)(@oramacloud/client@2.1.4)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.17)(lucide-react@1.14.0(react@19.2.8))(next@16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0))(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(zod@4.4.3))(next@16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0))(react@19.2.8)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)):
+  fumadocs-mdx@14.3.2(@types/mdast@4.0.4)(@types/mdx@2.0.14)(@types/react@19.2.17)(fumadocs-core@16.8.11(@mdx-js/mdx@3.1.1)(@oramacloud/client@2.1.4)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.17)(lucide-react@1.14.0(react@19.2.8))(next@16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0))(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(zod@4.4.3))(next@16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0))(react@19.2.8)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)):
     dependencies:
       '@mdx-js/mdx': 3.1.1
       '@standard-schema/spec': 1.1.0
@@ -15814,7 +16259,7 @@ snapshots:
       '@types/react': 19.2.17
       next: 16.2.12(@babel/core@7.28.4)(@playwright/test@1.60.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)(sass@1.99.0)
       react: 19.2.8
-      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - supports-color
 
@@ -16401,7 +16846,7 @@ snapshots:
       '@jest/expect': 30.3.0
       '@jest/test-result': 30.3.0
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       chalk: 4.1.2
       co: 4.6.0
       dedent: 1.7.0
@@ -16473,39 +16918,6 @@ snapshots:
       - babel-plugin-macros
       - supports-color
 
-  jest-config@30.3.0(@types/node@22.19.21)(esbuild-register@3.6.0(esbuild@0.27.7))(ts-node@10.9.2(@types/node@20.19.43)(typescript@5.9.3)):
-    dependencies:
-      '@babel/core': 7.29.0
-      '@jest/get-type': 30.1.0
-      '@jest/pattern': 30.0.1
-      '@jest/test-sequencer': 30.3.0
-      '@jest/types': 30.3.0
-      babel-jest: 30.3.0(@babel/core@7.29.0)
-      chalk: 4.1.2
-      ci-info: 4.3.1
-      deepmerge: 4.3.1
-      glob: 10.5.0
-      graceful-fs: 4.2.11
-      jest-circus: 30.3.0
-      jest-docblock: 30.2.0
-      jest-environment-node: 30.3.0
-      jest-regex-util: 30.0.1
-      jest-resolve: 30.3.0
-      jest-runner: 30.3.0
-      jest-util: 30.3.0
-      jest-validate: 30.3.0
-      parse-json: 5.2.0
-      pretty-format: 30.3.0
-      slash: 3.0.0
-      strip-json-comments: 3.1.1
-    optionalDependencies:
-      '@types/node': 22.19.21
-      esbuild-register: 3.6.0(esbuild@0.27.7)
-      ts-node: 10.9.2(@types/node@20.19.43)(typescript@5.9.3)
-    transitivePeerDependencies:
-      - babel-plugin-macros
-      - supports-color
-
   jest-diff@29.7.0:
     dependencies:
       chalk: 4.1.2
@@ -16537,7 +16949,7 @@ snapshots:
       '@jest/environment': 30.3.0
       '@jest/fake-timers': 30.3.0
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       jest-mock: 30.3.0
       jest-util: 30.3.0
       jest-validate: 30.3.0
@@ -16547,7 +16959,7 @@ snapshots:
   jest-haste-map@30.3.0:
     dependencies:
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       anymatch: 3.1.3
       fb-watchman: 2.0.2
       graceful-fs: 4.2.11
@@ -16605,7 +17017,7 @@ snapshots:
   jest-mock@30.3.0:
     dependencies:
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       jest-util: 30.3.0
 
   jest-pnp-resolver@1.2.3(jest-resolve@30.3.0):
@@ -16639,7 +17051,7 @@ snapshots:
       '@jest/test-result': 30.3.0
       '@jest/transform': 30.3.0
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       chalk: 4.1.2
       emittery: 0.13.1
       exit-x: 0.2.2
@@ -16668,7 +17080,7 @@ snapshots:
       '@jest/test-result': 30.3.0
       '@jest/transform': 30.3.0
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       chalk: 4.1.2
       cjs-module-lexer: 2.1.1
       collect-v8-coverage: 1.0.2
@@ -16715,7 +17127,7 @@ snapshots:
   jest-util@29.7.0:
     dependencies:
       '@jest/types': 29.6.3
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       chalk: 4.1.2
       ci-info: 3.9.0
       graceful-fs: 4.2.11
@@ -16724,7 +17136,7 @@ snapshots:
   jest-util@30.3.0:
     dependencies:
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       chalk: 4.1.2
       ci-info: 4.3.1
       graceful-fs: 4.2.11
@@ -16743,7 +17155,7 @@ snapshots:
     dependencies:
       '@jest/test-result': 30.3.0
       '@jest/types': 30.3.0
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       ansi-escapes: 4.3.2
       chalk: 4.1.2
       emittery: 0.13.1
@@ -16752,7 +17164,7 @@ snapshots:
 
   jest-worker@30.3.0:
     dependencies:
-      '@types/node': 22.19.21
+      '@types/node': 20.19.43
       '@ungap/structured-clone': 1.3.0
       jest-util: 30.3.0
       merge-stream: 2.0.0
@@ -17530,7 +17942,7 @@ snapshots:
 
   minimatch@9.0.6:
     dependencies:
-      brace-expansion: 5.0.4
+      brace-expansion: 5.0.9
 
   minimist@1.2.8: {}
 
@@ -17870,6 +18282,8 @@ snapshots:
 
   path-type@6.0.0: {}
 
+  pathe@1.1.2: {}
+
   pathe@2.0.3: {}
 
   pathval@2.0.1: {}
@@ -17918,6 +18332,14 @@ snapshots:
       postcss: 8.5.25
       tsx: 4.21.0
 
+  postcss-load-config@6.0.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.23.12):
+    dependencies:
+      lilconfig: 3.1.3
+    optionalDependencies:
+      jiti: 2.6.1
+      postcss: 8.5.25
+      tsx: 4.23.12
+
   postcss-value-parser@4.2.0: {}
 
   postcss@8.4.31:
@@ -18669,13 +19091,13 @@ snapshots:
       es-errors: 1.3.0
       internal-slot: 1.1.0
 
-  storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)):
+  storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)):
     dependencies:
       '@storybook/global': 5.0.0
       '@testing-library/jest-dom': 6.9.1
       '@testing-library/user-event': 14.6.1(@testing-library/dom@10.4.1)
       '@vitest/expect': 3.2.4
-      '@vitest/mocker': 3.2.4(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      '@vitest/mocker': 3.2.4(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       '@vitest/spy': 3.2.4
       better-opn: 3.0.2
       esbuild: 0.25.12
@@ -18693,13 +19115,13 @@ snapshots:
       - utf-8-validate
       - vite
 
-  storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)):
+  storybook@9.1.20(@testing-library/dom@10.4.1)(prettier@3.9.6)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)):
     dependencies:
       '@storybook/global': 5.0.0
       '@testing-library/jest-dom': 6.9.1
       '@testing-library/user-event': 14.6.1(@testing-library/dom@10.4.1)
       '@vitest/expect': 3.2.4
-      '@vitest/mocker': 3.2.4(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0))
+      '@vitest/mocker': 3.2.4(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))
       '@vitest/spy': 3.2.4
       better-opn: 3.0.2
       esbuild: 0.25.12
@@ -18919,8 +19341,12 @@ snapshots:
 
   tinypool@1.1.1: {}
 
+  tinyrainbow@1.2.0: {}
+
   tinyrainbow@2.0.0: {}
 
+  tinyspy@3.0.2: {}
+
   tinyspy@4.0.4: {}
 
   tldts-core@7.4.9:
@@ -19060,6 +19486,34 @@ snapshots:
       - tsx
       - yaml
 
+  tsup@8.5.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.23.12)(typescript@5.9.3):
+    dependencies:
+      bundle-require: 5.1.0(esbuild@0.27.7)
+      cac: 6.7.14
+      chokidar: 4.0.3
+      consola: 3.4.2
+      debug: 4.4.3
+      esbuild: 0.27.7
+      fix-dts-default-cjs-exports: 1.0.1
+      joycon: 3.1.1
+      picocolors: 1.1.1
+      postcss-load-config: 6.0.1(jiti@2.6.1)(postcss@8.5.25)(tsx@4.23.12)
+      resolve-from: 5.0.0
+      rollup: 4.60.3
+      source-map: 0.7.6
+      sucrase: 3.35.0
+      tinyexec: 0.3.2
+      tinyglobby: 0.2.16
+      tree-kill: 1.2.2
+    optionalDependencies:
+      postcss: 8.5.25
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - jiti
+      - supports-color
+      - tsx
+      - yaml
+
   tsx@4.21.0:
     dependencies:
       esbuild: 0.27.7
@@ -19067,6 +19521,12 @@ snapshots:
     optionalDependencies:
       fsevents: 2.3.3
 
+  tsx@4.23.12:
+    dependencies:
+      esbuild: 0.28.1
+    optionalDependencies:
+      fsevents: 2.3.3
+
   turbo@2.10.7:
     optionalDependencies:
       '@turbo/darwin-64': 2.10.7
@@ -19326,13 +19786,31 @@ snapshots:
       '@types/unist': 3.0.3
       vfile-message: 4.0.3
 
-  vite-node@3.2.4(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0):
+  vite-node@2.1.9(@types/node@20.19.43)(lightningcss@1.32.0)(sass@1.99.0):
+    dependencies:
+      cac: 6.7.14
+      debug: 4.4.3
+      es-module-lexer: 1.7.0
+      pathe: 1.1.2
+      vite: 5.4.21(@types/node@20.19.43)(lightningcss@1.32.0)(sass@1.99.0)
+    transitivePeerDependencies:
+      - '@types/node'
+      - less
+      - lightningcss
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - supports-color
+      - terser
+
+  vite-node@3.2.4(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12):
     dependencies:
       cac: 6.7.14
       debug: 4.4.3
       es-module-lexer: 1.7.0
       pathe: 2.0.3
-      vite: 7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - '@types/node'
       - jiti
@@ -19368,13 +19846,34 @@ snapshots:
       - tsx
       - yaml
 
-  vite-node@6.0.0(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0):
+  vite-node@3.2.4(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12):
+    dependencies:
+      cac: 6.7.14
+      debug: 4.4.3
+      es-module-lexer: 1.7.0
+      pathe: 2.0.3
+      vite: 7.3.5(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
+    transitivePeerDependencies:
+      - '@types/node'
+      - jiti
+      - less
+      - lightningcss
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - supports-color
+      - terser
+      - tsx
+      - yaml
+
+  vite-node@6.0.0(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12):
     dependencies:
       cac: 7.0.0
       es-module-lexer: 2.1.0
       obug: 2.1.2
       pathe: 2.0.3
-      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - '@types/node'
       - '@vitejs/devtools'
@@ -19389,13 +19888,13 @@ snapshots:
       - tsx
       - yaml
 
-  vite-node@6.0.0(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0):
+  vite-node@6.0.0(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12):
     dependencies:
       cac: 7.0.0
       es-module-lexer: 2.1.0
       obug: 2.1.2
       pathe: 2.0.3
-      vite: 8.1.4(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0)
+      vite: 8.1.4(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12)
     transitivePeerDependencies:
       - '@types/node'
       - '@vitejs/devtools'
@@ -19410,14 +19909,25 @@ snapshots:
       - tsx
       - yaml
 
-  vite-plugin-singlefile@2.3.3(rollup@4.61.1)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)):
+  vite-plugin-singlefile@2.3.3(rollup@4.61.1)(vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)):
     dependencies:
       micromatch: 4.0.8
-      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
     optionalDependencies:
       rollup: 4.61.1
 
-  vite@7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0):
+  vite@5.4.21(@types/node@20.19.43)(lightningcss@1.32.0)(sass@1.99.0):
+    dependencies:
+      esbuild: 0.21.5
+      postcss: 8.5.25
+      rollup: 4.61.1
+    optionalDependencies:
+      '@types/node': 20.19.43
+      fsevents: 2.3.3
+      lightningcss: 1.32.0
+      sass: 1.99.0
+
+  vite@7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12):
     dependencies:
       esbuild: 0.27.7
       fdir: 6.5.0(picomatch@4.0.5)
@@ -19431,7 +19941,7 @@ snapshots:
       jiti: 2.6.1
       lightningcss: 1.32.0
       sass: 1.99.0
-      tsx: 4.21.0
+      tsx: 4.23.12
 
   vite@7.3.5(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0):
     dependencies:
@@ -19449,7 +19959,23 @@ snapshots:
       sass: 1.99.0
       tsx: 4.21.0
 
-  vite@7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0):
+  vite@7.3.5(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12):
+    dependencies:
+      esbuild: 0.27.7
+      fdir: 6.5.0(picomatch@4.0.5)
+      picomatch: 4.0.5
+      postcss: 8.5.25
+      rollup: 4.61.1
+      tinyglobby: 0.2.17
+    optionalDependencies:
+      '@types/node': 22.19.21
+      fsevents: 2.3.3
+      jiti: 2.6.1
+      lightningcss: 1.32.0
+      sass: 1.99.0
+      tsx: 4.23.12
+
+  vite@7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12):
     dependencies:
       esbuild: 0.28.1
       fdir: 6.5.0(picomatch@4.0.5)
@@ -19463,10 +19989,10 @@ snapshots:
       jiti: 2.6.1
       lightningcss: 1.32.0
       sass: 1.99.0
-      tsx: 4.21.0
+      tsx: 4.23.12
     optional: true
 
-  vite@7.3.6(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0):
+  vite@7.3.6(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12):
     dependencies:
       esbuild: 0.28.1
       fdir: 6.5.0(picomatch@4.0.5)
@@ -19480,9 +20006,9 @@ snapshots:
       jiti: 2.6.1
       lightningcss: 1.32.0
       sass: 1.99.0
-      tsx: 4.21.0
+      tsx: 4.23.12
 
-  vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0):
+  vite@7.3.6(@types/node@25.5.0)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12):
     dependencies:
       esbuild: 0.28.1
       fdir: 6.5.0(picomatch@4.0.5)
@@ -19496,9 +20022,9 @@ snapshots:
       jiti: 2.6.1
       lightningcss: 1.32.0
       sass: 1.99.0
-      tsx: 4.21.0
+      tsx: 4.23.12
 
-  vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0):
+  vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12):
     dependencies:
       lightningcss: 1.32.0
       picomatch: 4.0.5
@@ -19511,9 +20037,9 @@ snapshots:
       fsevents: 2.3.3
       jiti: 2.6.1
       sass: 1.99.0
-      tsx: 4.21.0
+      tsx: 4.23.12
 
-  vite@8.1.4(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(sass@1.99.0)(tsx@4.21.0):
+  vite@8.1.4(@types/node@25.5.0)(esbuild@0.25.12)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12):
     dependencies:
       lightningcss: 1.32.0
       picomatch: 4.0.5
@@ -19526,7 +20052,7 @@ snapshots:
       fsevents: 2.3.3
       jiti: 2.6.1
       sass: 1.99.0
-      tsx: 4.21.0
+      tsx: 4.23.12
 
   vitest-axe@1.0.0-pre.5(vitest@3.2.7):
     dependencies:
@@ -19534,13 +20060,50 @@ snapshots:
       axe-core: 4.10.3
       chalk: 5.6.2
       lodash-es: 4.18.1
-      vitest: 3.2.7(@types/debug@4.1.12)(@types/node@22.19.21)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vitest: 3.2.7(@types/debug@4.1.12)(@types/node@22.19.21)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
 
-  vitest@3.2.7(@types/debug@4.1.12)(@types/node@20.19.43)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0):
+  vitest@2.1.9(@types/node@20.19.43)(happy-dom@20.9.0)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0):
+    dependencies:
+      '@vitest/expect': 2.1.9
+      '@vitest/mocker': 2.1.9(vite@5.4.21(@types/node@20.19.43)(lightningcss@1.32.0)(sass@1.99.0))
+      '@vitest/pretty-format': 2.1.9
+      '@vitest/runner': 2.1.9
+      '@vitest/snapshot': 2.1.9
+      '@vitest/spy': 2.1.9
+      '@vitest/utils': 2.1.9
+      chai: 5.3.3
+      debug: 4.4.3
+      expect-type: 1.3.0
+      magic-string: 0.30.21
+      pathe: 1.1.2
+      std-env: 3.10.0
+      tinybench: 2.9.0
+      tinyexec: 0.3.2
+      tinypool: 1.1.1
+      tinyrainbow: 1.2.0
+      vite: 5.4.21(@types/node@20.19.43)(lightningcss@1.32.0)(sass@1.99.0)
+      vite-node: 2.1.9(@types/node@20.19.43)(lightningcss@1.32.0)(sass@1.99.0)
+      why-is-node-running: 2.3.0
+    optionalDependencies:
+      '@types/node': 20.19.43
+      happy-dom: 20.9.0
+      jsdom: 29.0.2(@noble/hashes@1.8.0)
+    transitivePeerDependencies:
+      - less
+      - lightningcss
+      - msw
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - supports-color
+      - terser
+
+  vitest@3.2.7(@types/debug@4.1.12)(@types/node@20.19.43)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12):
     dependencies:
       '@types/chai': 5.2.3
       '@vitest/expect': 3.2.7
-      '@vitest/mocker': 3.2.7(vite@7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))
+      '@vitest/mocker': 3.2.7(vite@7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
       '@vitest/pretty-format': 3.2.7
       '@vitest/runner': 3.2.7
       '@vitest/snapshot': 3.2.7
@@ -19558,13 +20121,13 @@ snapshots:
       tinyglobby: 0.2.17
       tinypool: 1.1.1
       tinyrainbow: 2.0.0
-      vite: 7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
-      vite-node: 3.2.4(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0)
+      vite: 7.3.5(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
+      vite-node: 3.2.4(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
       why-is-node-running: 2.3.0
     optionalDependencies:
       '@types/debug': 4.1.12
       '@types/node': 20.19.43
-      '@vitest/browser': 3.2.7(playwright@1.60.0)(vite@7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.21.0))(vitest@3.2.7)
+      '@vitest/browser': 3.2.7(playwright@1.60.0)(vite@7.3.6(@types/node@20.19.43)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))(vitest@3.2.7)
       happy-dom: 20.9.0
       jsdom: 29.0.2(@noble/hashes@1.8.0)
     transitivePeerDependencies:
@@ -19626,6 +20189,51 @@ snapshots:
       - tsx
       - yaml
 
+  vitest@3.2.7(@types/debug@4.1.12)(@types/node@22.19.21)(@vitest/browser@3.2.7)(happy-dom@20.9.0)(jiti@2.6.1)(jsdom@29.0.2(@noble/hashes@1.8.0))(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12):
+    dependencies:
+      '@types/chai': 5.2.3
+      '@vitest/expect': 3.2.7
+      '@vitest/mocker': 3.2.7(vite@7.3.5(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12))
+      '@vitest/pretty-format': 3.2.7
+      '@vitest/runner': 3.2.7
+      '@vitest/snapshot': 3.2.7
+      '@vitest/spy': 3.2.7
+      '@vitest/utils': 3.2.7
+      chai: 5.3.3
+      debug: 4.4.3
+      expect-type: 1.3.0
+      magic-string: 0.30.21
+      pathe: 2.0.3
+      picomatch: 4.0.5
+      std-env: 3.10.0
+      tinybench: 2.9.0
+      tinyexec: 0.3.2
+      tinyglobby: 0.2.17
+      tinypool: 1.1.1
+      tinyrainbow: 2.0.0
+      vite: 7.3.5(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
+      vite-node: 3.2.4(@types/node@22.19.21)(jiti@2.6.1)(lightningcss@1.32.0)(sass@1.99.0)(tsx@4.23.12)
+      why-is-node-running: 2.3.0
+    optionalDependencies:
+      '@types/debug': 4.1.12
+      '@types/node': 22.19.21
+      '@vitest/browser': 3.2.7(playwright@1.60.0)(vite@8.1.4(@types/node@22.19.21)(esbuild@0.28.1)(jiti@2.6.1)(sass@1.99.0)(tsx@4.23.12))(vitest@3.2.7)
+      happy-dom: 20.9.0
+      jsdom: 29.0.2(@noble/hashes@1.8.0)
+    transitivePeerDependencies:
+      - jiti
+      - less
+      - lightningcss
+      - msw
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - supports-color
+      - terser
+      - tsx
+      - yaml
+
   w3c-xmlserializer@5.0.0:
     dependencies:
       xml-name-validator: 5.0.0
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 357225d6b..1603b2559 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -2,6 +2,7 @@ packages:
     - apps/*
     - packages/*
     - scripts/ts-api-extractor
+    - scripts/translation-pipeline
     - scripts/sync-figma
 
 # Unified React 19 for entire monorepo
diff --git a/scripts/translation-pipeline/CLAUDE.md b/scripts/translation-pipeline/CLAUDE.md
new file mode 100644
index 000000000..5b87c200d
--- /dev/null
+++ b/scripts/translation-pipeline/CLAUDE.md
@@ -0,0 +1,135 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+# Type check
+pnpm --filter @vapor-ui/translation-pipeline typecheck
+
+# Lint
+pnpm --filter @vapor-ui/translation-pipeline lint
+
+# Run all tests
+pnpm --filter @vapor-ui/translation-pipeline test:run
+
+# Run a single test file
+pnpm --filter @vapor-ui/translation-pipeline test:run -- src/translator.test.ts
+
+# Run tests with coverage
+pnpm --filter @vapor-ui/translation-pipeline test:coverage
+
+# Build
+pnpm --filter @vapor-ui/translation-pipeline build
+```
+
+Path alias `~` maps to `src/`. (`~/domain` → `src/domain.ts`)
+
+## Architecture
+
+### Core Flow
+
+```
+cli.ts                          # entry point: .env loading + error handler
+  → run.ts                      # orchestrator: CLI parsing · env check · stage order
+      → input.ts                # ① read en/*.json → TranslatableDoc[]
+      → translator.ts           # dedupe → cache → phase 1 translate → phase 2 evaluate
+          → translate.ts        # ② LLM initial translation (cross-component batch of 20)
+          → batch/lifecycle.ts  # ③ preservation check + MQM → postprocess → recheck
+              → batch/mqm.ts        # batch MQM prompt · schema · call
+              → batch/postprocess.ts # batch post-edit prompt · schema · call
+              → preserve.ts         # deterministic string-preservation checks
+      → output.ts               # ④ merge into raw JSON · write ko/*.json · prettier
+      → report.ts               # ⑤ renders .i18n-report.md
+
+batch-call.ts                   # shared LLM batch protocol: schema call + JSON parse + id reconcile
+client.ts                       # LLM transport: retries + 60s timeout
+```
+
+The tree above says which file owns what. The graph below says what actually happens to one
+unit — in particular where it can leave the pipeline with its English source intact.
+
+```mermaid
+flowchart TD
+    IN["en/*.json → TranslatableDoc[]<br/><i>input.ts</i>"]
+    UNITS["collect units<br/>component.description + prop.description<br/>duplicate key → throw"]
+    DEDUPE["dedupe by source<br/>keep one representative per source"]
+    CACHE{"cache hit?<br/><i>cache.ts</i>"}
+    TRANSLATE["translate misses<br/>batch 20 · 16 waves<br/><i>translate.ts</i>"]
+    GATE{"preserve violations == 0<br/>AND MQM verdict == PASS?<br/><i>preserve.ts + batch/mqm.ts</i>"}
+    POST["postprocess failures<br/>batch 10<br/><i>batch/postprocess.ts</i>"]
+    RECHECK{"preserve violations == 0<br/>after post-edit?"}
+    FINAL["final MQM<br/><i>batch/mqm.ts</i>"]
+    PASS(["verified → written to cache"])
+    UNVERIFIED(["unverified — not cached,<br/>reported as degraded"])
+    FALLBACK(["preservation_fallback —<br/>English source shipped"])
+    MERGE["merge by unit key → ko/*.json → prettier<br/><i>output.ts</i>"]
+    REPORT["render .i18n-report.md<br/><i>report.ts</i>"]
+
+    IN --> UNITS --> DEDUPE --> CACHE
+    CACHE -- hit --> MERGE
+    CACHE -- miss --> TRANSLATE
+    TRANSLATE -- "call threw" --> UNVERIFIED
+    TRANSLATE --> GATE
+    GATE -- yes --> PASS
+    GATE -- "no / batch invalid" --> POST
+    POST -- "batch invalid" --> UNVERIFIED
+    POST --> RECHECK
+    RECHECK -- no --> FALLBACK
+    RECHECK -- yes --> FINAL
+    FINAL -- PASS --> PASS
+    FINAL -- "FAIL / batch invalid" --> UNVERIFIED
+    PASS --> MERGE
+    UNVERIFIED --> MERGE
+    FALLBACK --> MERGE
+    MERGE --> REPORT
+```
+
+Three things the graph is there to make un-missable: the quality gate is **one** AND of a
+deterministic check and an LLM verdict, not two sequential gates; a preservation violation that
+survives post-editing exits before the final MQM with the English source; and only the `verified`
+path writes to the cache.
+
+### Module Boundaries
+
+- **`run.ts`**: Call order only — CLI flags, env check, then each stage in turn. No logic of its own.
+- **`input.ts` · `output.ts`**: Own all file I/O. `input.ts` normalizes en JSON to `TranslatableDoc[]`, resolving each doc's identity as `displayName ?? name`; `output.ts` looks each translation up **by unit key** and merges it into the raw JSON, then writes `ko/*.json`. Neither depends on document or prop order. No LLM logic.
+- **`translator.ts`**: Deduplicates by source string, decides cache hit/miss, forms cross-component batches, runs the two phases in concurrency-capped waves, and returns a key → Korean dictionary. Does not touch JSON or call the LLM directly. Its `outcomes` map is keyed by **source**, not by unit key — a judgment depends only on the source string, so there is deliberately no fan-out step that copies one result across a duplicate group. Per-unit lookup is `outcomes.get(unit.source)`.
+- **`batch/lifecycle.ts`**: Runs one MQM batch: deterministic preservation check + batch MQM → batch postprocess → preservation recheck → final MQM. Only called from `translator.ts`. The recheck is not its own module — it is a second call into `batch/mqm.ts` and `preserve.ts`.
+- **`batch/mqm.ts` · `batch/postprocess.ts`**: One LLM step each — prompt, JSON schema, and the `callBatch` invocation. `batch/_types.ts` holds the types that only circulate inside `batch/`.
+- **`batch-call.ts`**: The shared shell for every batch LLM call — schema call → content check → JSON parse → id reconcile. Lives at the root because both stage ② (`translate.ts`) and stage ③ (`batch/`) use it.
+- **`preserve.ts`**: Deterministic checks only — no LLM. Owns code spans, bare identifiers, URLs, markdown structure.
+- **`client.ts`**: Single wrapper for LiteLLM `/chat/completions`. Every LLM call goes through this file.
+- **`domain.ts`**: Types that flow between stages. `MqmCategory` union is the single source of truth. Adding or removing a category here causes a compile error in `batch/mqm.ts` via the `satisfies` check on `MQM_CATEGORY_VALUES`. Also owns `TranslationUnit` (a two-variant union — `component.description` carries no `propName`, so the write-back branch is exhaustive-checked), `makeUnitKey`/`getTranslationUnitKey`, `getUnitOwnerName`, and `makeOutcome` — `assurance`/`reportable` are derived from `reason` in `REASON_META`, nowhere else. `TranslationOutcome` carries no unit key: the map that holds it says which source it belongs to, and the report label (`ReportedOutcome.key`) is attached in `report.ts`, the only place that needs it.
+- **`util.ts`**: `chunkArray` and `errorMessage` only — anything with a single consumer belongs next to that consumer.
+
+### Design Constraints — Read Before Modifying
+
+**MQM mirroring rule**: The Style rules in `translate.ts` and the `Fluency/Unnatural phrasing` criteria in `batch/mqm.ts` intentionally contain the same content. Changing one requires changing the other. If they diverge, the initial MQM will fail more often, increasing postprocess cost.
+
+**Units are identified by name, never by position**: every request/response id and every dictionary key is `getTranslationUnitKey(unit)` — `${componentDisplayName}:${propName}`, or `${componentDisplayName}:(description)` for a component's own description. The `(description)` sentinel cannot collide with a prop name because parentheses are not valid in identifiers.
+
+Use `displayName`, not `name`: 194 of the 200 extracted docs differ between the two, and `name` is `Root` in 25 of them. Keying on `name` makes `reconcileById` silently map results onto the wrong component. `collectTranslationUnits` throws on a duplicate key rather than overwriting.
+
+**No positional coupling**: `translateDescriptions` returns `translations: Map<key, string>`, not a rebuilt `TranslatableDoc[]`. There is deliberately no function that reassembles the input tree — adding one reintroduces the index fields this contract removed.
+
+**Dedupe before concurrency**: 74.3% of units share a source string (inherited base-ui props). `translator.ts` translates unique sources only. The cache alone cannot do this job once batches run concurrently — 16 in-flight batches don't see each other's writes.
+
+**Batch sizes are derived, not tuned by feel**: `(timeout − margin) × throughput ÷ output tokens per unit ÷ safety factor 2`. At the measured 81 tok/s that yields translate 20, MQM 74. Changing the 60s timeout in `client.ts` moves both.
+
+**Deterministic checks own preservation**: code spans, identifiers, URLs, and markdown structure are checked in `preserve.ts`, not by the LLM (KAN-12: LLM judgment at string level is unreliable). A unit that still violates after post-editing keeps its **English source** (`preservation_fallback`) rather than shipping broken Korean.
+
+**Cache key composition**: `makeCacheKey` in `cache.ts` hashes `version + source + targetLocale + translationModel + validationModel + postprocessModel`. Changing any model name in `defaults.ts` invalidates the entire cache and triggers a full re-translation on the next run.
+
+**Degraded outcome**: If any batch step (MQM, postprocess, or final MQM) returns a malformed response, the affected units are marked `unverified` (`batch_mqm_failed`, `batch_postprocess_failed`, `batch_final_mqm_failed`). A translation call that throws degrades only its own batch to English (`translation_failed`) instead of killing the run.
+
+**Batch fallbacks carry no component name**: batches mix components, so the first unit's component is not the cause of a batch failure. `batchFallbacks` is a `string[]` of reasons and the report renders reasons only — do not reintroduce a Component column that would name an innocent component.
+
+**Cache write timing**: Only `verified` outcomes are written to cache, and the cache is saved once after the MQM phase — the phases are split, so there is no per-component checkpoint to save at.
+
+### Test Structure
+
+All LLM calls are replaced with `vi.mock('~/client')`. No test hits a real API. `tests/cli.test.ts` creates a tmp directory and validates the full file I/O pipeline end-to-end. Env vars are injected with `vi.stubEnv` — there is no DI hole in the production interface for tests to reach through.
+
+Coverage excludes the I/O shell (`src/cli.ts`, `src/run.ts`, `src/input.ts`, `src/output.ts`). Thresholds: 70% lines/functions/statements, 65% branches.
diff --git a/scripts/translation-pipeline/README.md b/scripts/translation-pipeline/README.md
new file mode 100644
index 000000000..57e4c996f
--- /dev/null
+++ b/scripts/translation-pipeline/README.md
@@ -0,0 +1,95 @@
+# @vapor-ui/translation-pipeline
+
+An internal CLI package that translates English API JSON generated by `ts-api-extractor` into Korean documentation JSON. It calls an LLM via LiteLLM and validates translation quality through an MQM (Multidimensional Quality Metrics) gate.
+
+## Flow
+
+```
+packages/core components
+    ↓ ts-api-extractor
+generated/en/*.json
+    ↓ translation-pipeline
+generated/ko/*.json
+.translation-cache.json
+.i18n-report.md
+```
+
+`apps/website` runs both tools in sequence.
+
+```bash
+pnpm --filter website i18n       # extract + translate
+pnpm --filter website extract    # extract only
+pnpm --filter website translate  # translate only
+```
+
+## Requirements
+
+- Node.js >= 20.20.2
+- An OpenAI-compatible LLM endpoint (see team credentials doc)
+
+## Environment Variables
+
+Must be set before running the CLI. The CLI automatically reads `.env` in the current working directory.
+
+```bash
+LITELLM_BASE_URL=<endpoint>
+```
+
+## CLI Options
+
+```bash
+translation-pipeline --input <dir> --output <dir>
+```
+
+| Option     | Short | Required | Description                                 |
+| ---------- | ----- | -------- | ------------------------------------------- |
+| `--input`  | `-i`  | Yes      | Directory containing English JSON files     |
+| `--output` | `-o`  | Yes      | Directory to write `ko/`, cache, and report |
+
+## Input and Output
+
+Only `description` fields are translated.
+
+- Component description: `description`
+- Prop description: `props[].description`
+
+All other fields (`name`, `type`, `required`, `defaultValue`, etc.) are preserved as-is.
+
+| Output                    | Description                           |
+| ------------------------- | ------------------------------------- |
+| `ko/*.json`               | JSON with Korean descriptions applied |
+| `.translation-cache.json` | Verified translation cache            |
+| `.i18n-report.md`         | MQM quality report                    |
+
+## Development
+
+```bash
+# Type check
+pnpm --filter @vapor-ui/translation-pipeline typecheck
+
+# Lint
+pnpm --filter @vapor-ui/translation-pipeline lint
+
+# Run tests
+pnpm --filter @vapor-ui/translation-pipeline test:run
+
+# Build
+pnpm --filter @vapor-ui/translation-pipeline build
+
+# Watch mode
+pnpm --filter @vapor-ui/translation-pipeline dev
+```
+
+## Code Structure
+
+```
+src/
+├── cli/           # Entry point, argument parsing, file I/O
+├── translator/    # Unit collection, cache lookup, batch lifecycle
+├── translation/   # LiteLLM calls, initial translation prompt
+├── validation/    # MQM evaluation prompt and response validation
+├── cache/         # SHA256 key generation, cache load/save
+├── report/        # Per-component stats, report rendering
+├── defaults.ts    # Default model names
+└── types.ts       # Shared type definitions
+```
diff --git a/scripts/translation-pipeline/eslint.config.mjs b/scripts/translation-pipeline/eslint.config.mjs
new file mode 100644
index 000000000..68b4b5c13
--- /dev/null
+++ b/scripts/translation-pipeline/eslint.config.mjs
@@ -0,0 +1,3 @@
+import { configs } from '@repo/eslint-config/base';
+
+export default [...configs];
diff --git a/scripts/translation-pipeline/package.json b/scripts/translation-pipeline/package.json
new file mode 100644
index 000000000..7abb66628
--- /dev/null
+++ b/scripts/translation-pipeline/package.json
@@ -0,0 +1,39 @@
+{
+    "name": "@vapor-ui/translation-pipeline",
+    "version": "0.0.1",
+    "private": true,
+    "description": "LLM-based JSON translation pipeline with MQM quality gating",
+    "type": "module",
+    "bin": {
+        "translation-pipeline": "./dist/cli/cli.js"
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "format": "prettier --write \"./**/*.{ts,md,mjs}\"",
+        "lint": "eslint ./src",
+        "test": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "test:run": "vitest run",
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "meow": "^14.1.0"
+    },
+    "devDependencies": {
+        "@repo/eslint-config": "workspace:*",
+        "@types/node": "^20.19.39",
+        "@vitest/coverage-v8": "^2.1.9",
+        "eslint": "^9.39.4",
+        "tsup": "^8.5.1",
+        "tsx": "^4.21.0",
+        "typescript": "catalog:",
+        "vitest": "^2.1.9"
+    },
+    "engines": {
+        "node": ">=20.20.2"
+    }
+}
diff --git a/scripts/translation-pipeline/src/batch-call.ts b/scripts/translation-pipeline/src/batch-call.ts
new file mode 100644
index 000000000..d8fef0ad7
--- /dev/null
+++ b/scripts/translation-pipeline/src/batch-call.ts
@@ -0,0 +1,72 @@
+import { callLlm } from '~/client';
+import { errorMessage } from '~/util';
+
+export type BatchResult<T> = { ok: true; value: T } | { ok: false; reason: string };
+
+function parseLlmJson(content: string): unknown {
+    const trimmed = content.trim();
+    const fenced = trimmed.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i);
+    let jsonContent = fenced ? fenced[1].trim() : trimmed;
+
+    if (!jsonContent.startsWith('{') && !jsonContent.startsWith('[')) {
+        const match = jsonContent.match(/[{[][\s\S]*[}\]]/);
+        if (match) jsonContent = match[0];
+    }
+
+    return JSON.parse(jsonContent);
+}
+
+function reconcileById<T extends { id: string }>(
+    expectedIds: string[],
+    items: T[],
+): Map<string, T> {
+    const expected = new Set(expectedIds);
+    const result = new Map<string, T>();
+
+    for (const item of items) {
+        if (!expected.has(item.id)) throw new Error(`Unknown response id: ${item.id}`);
+        if (result.has(item.id)) throw new Error(`Duplicate response id: ${item.id}`);
+        result.set(item.id, item);
+    }
+    for (const id of expected) {
+        if (!result.has(id)) throw new Error(`Missing response id: ${id}`);
+    }
+    return result;
+}
+
+export async function callBatch<Item extends { id: string }>(
+    label: string,
+    systemPrompt: string,
+    model: string,
+    schema: { name: string; schema: object },
+    request: object,
+    expectedIds: string[],
+    field: string,
+): Promise<BatchResult<Map<string, Item>>> {
+    const result = await callLlm(
+        [
+            { role: 'system', content: systemPrompt },
+            { role: 'user', content: JSON.stringify(request) },
+        ],
+        { model, jsonSchema: schema },
+    );
+
+    if (!result.content) {
+        const statusInfo = result.statusCode !== undefined ? ` (HTTP ${result.statusCode})` : '';
+        return { ok: false, reason: `[${label}] ${result.error ?? 'empty response'}${statusInfo}` };
+    }
+
+    try {
+        const parsed = parseLlmJson(result.content);
+        if (typeof parsed !== 'object' || parsed === null) {
+            return { ok: false, reason: `${label} response must be a JSON object` };
+        }
+        const items = (parsed as Record<string, unknown>)[field];
+        if (!Array.isArray(items)) {
+            return { ok: false, reason: `${label} response must contain ${field}[]` };
+        }
+        return { ok: true, value: reconcileById(expectedIds, items as Item[]) };
+    } catch (error) {
+        return { ok: false, reason: errorMessage(error) };
+    }
+}
diff --git a/scripts/translation-pipeline/src/batch/_types.ts b/scripts/translation-pipeline/src/batch/_types.ts
new file mode 100644
index 000000000..9dfe9c8ae
--- /dev/null
+++ b/scripts/translation-pipeline/src/batch/_types.ts
@@ -0,0 +1,23 @@
+import type {
+    MqmError,
+    PreservationViolation,
+    TranslationOutcome,
+    TranslationUnit,
+} from '~/domain';
+
+export interface MqmResult {
+    verdict: 'PASS' | 'FAIL';
+    errors: MqmError[];
+}
+
+export interface FailedUnit {
+    unit: TranslationUnit;
+    initialTranslation: string;
+    errors: MqmError[];
+    violations: PreservationViolation[];
+}
+
+export interface BatchLifecycleResult {
+    outcomes: [TranslationUnit, TranslationOutcome][];
+    batchFailureReasons: string[];
+}
diff --git a/scripts/translation-pipeline/src/batch/lifecycle.ts b/scripts/translation-pipeline/src/batch/lifecycle.ts
new file mode 100644
index 000000000..46cfd65e0
--- /dev/null
+++ b/scripts/translation-pipeline/src/batch/lifecycle.ts
@@ -0,0 +1,151 @@
+import type { BatchLifecycleResult, FailedUnit, MqmResult } from '~/batch/_types';
+import { validateBatchWithMqm } from '~/batch/mqm';
+import { postprocessBatchWithLlm } from '~/batch/postprocess';
+import {
+    type PreservationViolation,
+    type TranslationOutcome,
+    type TranslationUnit,
+    getTranslationUnitKey,
+    makeOutcome,
+} from '~/domain';
+import { checkPreservation } from '~/preserve';
+import { chunkArray } from '~/util';
+
+const POSTPROCESS_BATCH_SIZE = 10;
+
+function finalOutcome(translated: string, finalEvaluation: MqmResult): TranslationOutcome {
+    return finalEvaluation.verdict === 'PASS'
+        ? makeOutcome(translated, 'quality_gate_passed')
+        : makeOutcome(translated, 'quality_gate_failed', {
+              errors: finalEvaluation.errors,
+          });
+}
+
+function preservationFallbackOutcome(
+    unit: TranslationUnit,
+    violations: PreservationViolation[],
+): TranslationOutcome {
+    return makeOutcome(unit.source, 'preservation_fallback', { violations });
+}
+
+function requireTranslation(translations: Map<string, string>, unit: TranslationUnit): string {
+    const translated = translations.get(getTranslationUnitKey(unit));
+    if (translated === undefined) {
+        throw new Error(`Missing translation for unit id: ${getTranslationUnitKey(unit)}`);
+    }
+    return translated;
+}
+
+export async function processBatchLifecycle(
+    units: TranslationUnit[],
+    translations: Map<string, string>,
+): Promise<BatchLifecycleResult> {
+    const outcomes: [TranslationUnit, TranslationOutcome][] = [];
+    const batchFailureReasons: string[] = [];
+
+    const violationsByKey = new Map<string, PreservationViolation[]>(
+        units.map((unit) => [
+            getTranslationUnitKey(unit),
+            checkPreservation(unit.source, requireTranslation(translations, unit)),
+        ]),
+    );
+    const violationsOf = (unit: TranslationUnit): PreservationViolation[] =>
+        violationsByKey.get(getTranslationUnitKey(unit)) ?? [];
+
+    const initialResult = await validateBatchWithMqm(units, translations);
+
+    if (!initialResult.ok) {
+        batchFailureReasons.push(`initial batch MQM invalid: ${initialResult.reason}`);
+        for (const unit of units) {
+            const violations = violationsOf(unit);
+            outcomes.push([
+                unit,
+                violations.length > 0
+                    ? preservationFallbackOutcome(unit, violations)
+                    : makeOutcome(requireTranslation(translations, unit), 'batch_mqm_failed'),
+            ]);
+        }
+        return { outcomes, batchFailureReasons };
+    }
+
+    const failedUnits: FailedUnit[] = [];
+    for (const unit of units) {
+        const key = getTranslationUnitKey(unit);
+        const translated = requireTranslation(translations, unit);
+        const evaluation = initialResult.value.get(key);
+        if (evaluation === undefined) {
+            throw new Error(`Missing batch MQM result for id: ${key}`);
+        }
+        const violations = violationsOf(unit);
+        if (evaluation.verdict === 'PASS' && violations.length === 0) {
+            outcomes.push([unit, makeOutcome(translated, 'quality_gate_passed')]);
+            continue;
+        }
+        failedUnits.push({
+            unit,
+            initialTranslation: translated,
+            errors: evaluation.errors,
+            violations,
+        });
+    }
+
+    for (const failedChunk of chunkArray(failedUnits, POSTPROCESS_BATCH_SIZE)) {
+        const postprocess = await postprocessBatchWithLlm(failedChunk);
+
+        if (!postprocess.ok) {
+            batchFailureReasons.push(`batch postprocess invalid: ${postprocess.reason}`);
+            for (const failed of failedChunk) {
+                outcomes.push([
+                    failed.unit,
+                    failed.violations.length > 0
+                        ? preservationFallbackOutcome(failed.unit, failed.violations)
+                        : makeOutcome(failed.initialTranslation, 'batch_postprocess_failed', {
+                              errors: failed.errors,
+                          }),
+                ]);
+            }
+            continue;
+        }
+
+        const recheckable: FailedUnit[] = [];
+        for (const failed of failedChunk) {
+            const key = getTranslationUnitKey(failed.unit);
+            const postprocessed = postprocess.value.get(key) ?? failed.initialTranslation;
+            const violations = checkPreservation(failed.unit.source, postprocessed);
+            if (violations.length > 0) {
+                outcomes.push([failed.unit, preservationFallbackOutcome(failed.unit, violations)]);
+                continue;
+            }
+            recheckable.push(failed);
+        }
+
+        if (recheckable.length === 0) continue;
+
+        const finalResult = await validateBatchWithMqm(
+            recheckable.map(({ unit }) => unit),
+            postprocess.value,
+        );
+
+        if (!finalResult.ok) {
+            batchFailureReasons.push(`final batch MQM invalid: ${finalResult.reason}`);
+            for (const failed of recheckable) {
+                const key = getTranslationUnitKey(failed.unit);
+                const postprocessed = postprocess.value.get(key) ?? failed.initialTranslation;
+                outcomes.push([failed.unit, makeOutcome(postprocessed, 'batch_final_mqm_failed')]);
+            }
+            continue;
+        }
+
+        for (const failed of recheckable) {
+            const key = getTranslationUnitKey(failed.unit);
+            const translated = postprocess.value.get(key);
+            const finalEvaluation = finalResult.value.get(key);
+            if (translated === undefined || finalEvaluation === undefined) {
+                throw new Error(`Missing final batch MQM result for id: ${key}`);
+            }
+            outcomes.push([failed.unit, finalOutcome(translated, finalEvaluation)]);
+        }
+    }
+
+    return { outcomes, batchFailureReasons };
+}
diff --git a/scripts/translation-pipeline/src/batch/mqm.ts b/scripts/translation-pipeline/src/batch/mqm.ts
new file mode 100644
index 000000000..2e6877b18
--- /dev/null
+++ b/scripts/translation-pipeline/src/batch/mqm.ts
@@ -0,0 +1,131 @@
+import { type BatchResult, callBatch } from '~/batch-call';
+import type { MqmResult } from '~/batch/_types';
+import { DEFAULT_VALIDATION_MODEL } from '~/defaults';
+import {
+    type MqmCategory,
+    type MqmError,
+    type TranslationUnit,
+    getTranslationUnitKey,
+    getUnitOwnerName,
+} from '~/domain';
+
+const MQM_EVALUATOR_PROMPT = `You are a design-system documentation translation quality evaluator. Respond ONLY with a single JSON object — no explanation, no markdown, no code fences.
+
+Evaluate the Korean translation of a JSDoc comment using the MQM taxonomy below. For each error, return the exact substring from the source (source_span) and the exact substring from the translation (mt_span) that contains the error.
+
+Use one of these categories exactly:
+
+- Accuracy/Mistranslation — source meaning is distorted or communicated differently
+- Accuracy/Omission — important source information is missing
+- Accuracy/Addition — information not present in the source is added
+- Fluency/Unnatural phrasing — grammatically valid but awkward literal phrasing. Flag these patterns even if grammatically correct: "~를 제어합니다" (prefer "~지정합니다" or "~설정합니다"), "~를 수행합니다" (use a direct verb), "~에 적용되는" (prefer "~에 줄"), "~를 반환하는 함수입니다" (prefer dropping final 이다), abstract-noun subjects where the component or developer should be the subject
+- Fluency/Style inconsistency — tone and voice are inconsistent within the docs
+- Fluency/Grammatical error — grammar error in Korean
+
+Do NOT report code-span, identifier, URL, or markdown-structure preservation problems — a separate
+deterministic checker owns those. Judge only meaning and Korean fluency.
+
+Severity:
+- critical: a developer could implement incorrectly. Example: the described behavior is inverted.
+- major: seriously harms understanding or trust. Examples: behavior description distorted, important explanation omitted, non-source content added.
+- minor: lowers expression quality but does not block understanding. Examples: awkward literal phrasing, typo, style inconsistency.
+
+Write explanation in Korean. Keep category and severity values in English exactly as specified.
+If no errors exist, return errors as an empty array.`;
+
+const MQM_CATEGORY_VALUES = [
+    'Accuracy/Mistranslation',
+    'Accuracy/Omission',
+    'Accuracy/Addition',
+    'Fluency/Unnatural phrasing',
+    'Fluency/Style inconsistency',
+    'Fluency/Grammatical error',
+] satisfies MqmCategory[];
+
+const MQM_SEVERITY_VALUES = ['minor', 'major', 'critical'] satisfies MqmError['severity'][];
+
+const BATCH_MQM_SYSTEM_PROMPT = `${MQM_EVALUATOR_PROMPT}
+
+Batch mode:
+You will receive multiple translation units, possibly from different components.
+Evaluate each unit independently and echo its id back exactly as given.
+Respond with EXACTLY this JSON shape and nothing else:
+{"evaluations":[{"id":"12:component.description","verdict":"PASS","errors":[]}]}`;
+
+const MQM_ERROR_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['category', 'severity', 'source_span', 'mt_span', 'explanation'],
+    properties: {
+        category: { type: 'string', enum: MQM_CATEGORY_VALUES },
+        severity: { type: 'string', enum: MQM_SEVERITY_VALUES },
+        source_span: { type: 'string' },
+        mt_span: { type: 'string' },
+        explanation: { type: 'string' },
+    },
+};
+
+const BATCH_MQM_RESPONSE_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['evaluations'],
+    properties: {
+        evaluations: {
+            type: 'array',
+            items: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['id', 'verdict', 'errors'],
+                properties: {
+                    id: { type: 'string' },
+                    verdict: { type: 'string', enum: ['PASS', 'FAIL'] },
+                    errors: { type: 'array', items: MQM_ERROR_SCHEMA },
+                },
+            },
+        },
+    },
+};
+
+interface BatchEvaluationItem {
+    id: string;
+    verdict: MqmResult['verdict'];
+    errors: MqmError[];
+}
+
+export async function validateBatchWithMqm(
+    units: TranslationUnit[],
+    translations: Map<string, string>,
+): Promise<BatchResult<Map<string, MqmResult>>> {
+    if (units.length === 0) return { ok: true, value: new Map() };
+
+    const request = {
+        units: units.map((unit) => ({
+            id: getTranslationUnitKey(unit),
+            kind: unit.kind,
+            ownerName: getUnitOwnerName(unit),
+            source: unit.source,
+            translated: translations.get(getTranslationUnitKey(unit)) ?? '',
+        })),
+    };
+
+    const result = await callBatch<BatchEvaluationItem>(
+        'batch-mqm',
+        BATCH_MQM_SYSTEM_PROMPT,
+        DEFAULT_VALIDATION_MODEL,
+        { name: 'batch_mqm_response', schema: BATCH_MQM_RESPONSE_SCHEMA },
+        request,
+        units.map(getTranslationUnitKey),
+        'evaluations',
+    );
+    if (!result.ok) return result;
+
+    return {
+        ok: true,
+        value: new Map(
+            [...result.value].map(([id, item]) => [
+                id,
+                { verdict: item.verdict, errors: item.errors },
+            ]),
+        ),
+    };
+}
diff --git a/scripts/translation-pipeline/src/batch/postprocess.ts b/scripts/translation-pipeline/src/batch/postprocess.ts
new file mode 100644
index 000000000..1da8e7368
--- /dev/null
+++ b/scripts/translation-pipeline/src/batch/postprocess.ts
@@ -0,0 +1,77 @@
+import { type BatchResult, callBatch } from '~/batch-call';
+import type { FailedUnit } from '~/batch/_types';
+import { DEFAULT_POSTPROCESS_MODEL } from '~/defaults';
+import { getTranslationUnitKey, getUnitOwnerName } from '~/domain';
+import { describeViolation } from '~/preserve';
+
+const BATCH_POSTPROCESS_SYSTEM_PROMPT = `You are a professional Korean translator and post-editor for a design system documentation site.
+
+You will receive failed translation units with their English source text, initial Korean translation, MQM error feedback, and string-preservation violations detected by a deterministic checker.
+
+Rules:
+1. Fix every MQM error and every preservation violation listed for each unit.
+2. A preservation violation means a string that must appear verbatim in the Korean text is missing or altered. Restore it exactly as it appears in the source.
+3. Do not change parts that are not covered by any error unless required for grammar.
+4. Never translate or alter PascalCase component names, camelCase prop names, quoted enum values, inline code, token names, URLs, or markdown formatting.
+5. Respond ONLY with JSON in this exact shape, echoing each id exactly as given:
+{"translations":[{"id":"12:component.description","translated":"final Korean text"}]}`;
+
+const BATCH_POSTPROCESS_RESPONSE_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['translations'],
+    properties: {
+        translations: {
+            type: 'array',
+            items: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['id', 'translated'],
+                properties: {
+                    id: { type: 'string' },
+                    translated: { type: 'string' },
+                },
+            },
+        },
+    },
+};
+
+export async function postprocessBatchWithLlm(
+    inputs: FailedUnit[],
+): Promise<BatchResult<Map<string, string>>> {
+    if (inputs.length === 0) return { ok: true, value: new Map() };
+
+    const request = {
+        units: inputs.map(({ unit, initialTranslation, errors, violations }) => ({
+            id: getTranslationUnitKey(unit),
+            kind: unit.kind,
+            ownerName: getUnitOwnerName(unit),
+            componentName: unit.componentDisplayName,
+            source: unit.source,
+            initialTranslation,
+            errors,
+            preservationViolations: violations.map(describeViolation),
+        })),
+    };
+
+    const result = await callBatch<{ id: string; translated: string }>(
+        'batch-postprocess',
+        BATCH_POSTPROCESS_SYSTEM_PROMPT,
+        DEFAULT_POSTPROCESS_MODEL,
+        { name: 'batch_postprocess_response', schema: BATCH_POSTPROCESS_RESPONSE_SCHEMA },
+        request,
+        inputs.map((input) => getTranslationUnitKey(input.unit)),
+        'translations',
+    );
+    if (!result.ok) return result;
+
+    for (const item of result.value.values()) {
+        if (item.translated.trim().length === 0) {
+            return { ok: false, reason: `Empty translation for id: ${item.id}` };
+        }
+    }
+    return {
+        ok: true,
+        value: new Map([...result.value].map(([id, item]) => [id, item.translated])),
+    };
+}
diff --git a/scripts/translation-pipeline/src/cache.test.ts b/scripts/translation-pipeline/src/cache.test.ts
new file mode 100644
index 000000000..e9e25d57d
--- /dev/null
+++ b/scripts/translation-pipeline/src/cache.test.ts
@@ -0,0 +1,92 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { loadCache, makeCacheKey, saveCache } from '~/cache';
+
+function makeTmpDir(): string {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'cache-test-'));
+}
+
+function key(source: string): string {
+    return makeCacheKey(source);
+}
+
+describe('makeCacheKey', () => {
+    it('same inputs produce same key (deterministic)', () => {
+        expect(key('hello')).toBe(key('hello'));
+    });
+
+    it('different source produces different key', () => {
+        expect(key('hello')).not.toBe(key('world'));
+    });
+
+    it('returns sha256 hex string', () => {
+        const k = key('hello');
+        expect(typeof k).toBe('string');
+        expect(k.length).toBe(64);
+    });
+});
+
+describe('loadCache', () => {
+    it('returns empty Map when cache file does not exist', () => {
+        const dir = makeTmpDir();
+        expect(loadCache(dir)).toEqual(new Map());
+        fs.rmSync(dir, { recursive: true });
+    });
+
+    it('returns populated Map when valid cache file exists', () => {
+        const dir = makeTmpDir();
+        const k = key('hello');
+        fs.writeFileSync(
+            path.join(dir, '.translation-cache.json'),
+            JSON.stringify({ [k]: '안녕' }),
+        );
+
+        const store = loadCache(dir);
+        expect(store.get(k)).toBe('안녕');
+        fs.rmSync(dir, { recursive: true });
+    });
+
+    it('returns empty Map when cache file contains invalid JSON', () => {
+        const dir = makeTmpDir();
+        fs.writeFileSync(path.join(dir, '.translation-cache.json'), 'not-json{{');
+        expect(loadCache(dir)).toEqual(new Map());
+        fs.rmSync(dir, { recursive: true });
+    });
+});
+
+describe('saveCache / loadCache roundtrip', () => {
+    let tmpDir: string;
+
+    beforeEach(() => {
+        tmpDir = makeTmpDir();
+    });
+
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true });
+    });
+
+    it('written cache can be read back', () => {
+        const k = key('hello');
+        const store = new Map([[k, '안녕']]);
+
+        saveCache(tmpDir, store);
+
+        expect(loadCache(tmpDir).get(k)).toBe('안녕');
+    });
+
+    it('does not throw when outputDir is unwritable (logs warning instead)', () => {
+        const fakePath = path.join(os.tmpdir(), `cache-test-block-${Date.now()}`);
+        fs.writeFileSync(fakePath, '');
+        try {
+            const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+            expect(() => saveCache(fakePath, new Map())).not.toThrow();
+            expect(warnSpy).toHaveBeenCalledOnce();
+            warnSpy.mockRestore();
+        } finally {
+            fs.rmSync(fakePath);
+        }
+    });
+});
diff --git a/scripts/translation-pipeline/src/cache.ts b/scripts/translation-pipeline/src/cache.ts
new file mode 100644
index 000000000..9566ad3c4
--- /dev/null
+++ b/scripts/translation-pipeline/src/cache.ts
@@ -0,0 +1,57 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+import {
+    DEFAULT_POSTPROCESS_MODEL,
+    DEFAULT_TRANSLATION_MODEL,
+    DEFAULT_VALIDATION_MODEL,
+} from '~/defaults';
+import { errorMessage } from '~/util';
+
+export const CACHE_VERSION = 'v2';
+
+export type CacheStore = Map<string, string>;
+
+export function makeCacheKey(source: string): string {
+    return createHash('sha256')
+        .update(
+            JSON.stringify({
+                version: CACHE_VERSION,
+                source,
+                targetLocale: 'ko',
+                translationModel: DEFAULT_TRANSLATION_MODEL,
+                validationModel: DEFAULT_VALIDATION_MODEL,
+                postprocessModel: DEFAULT_POSTPROCESS_MODEL,
+            }),
+        )
+        .digest('hex');
+}
+
+export function loadCache(outputDir: string): CacheStore {
+    const filePath = join(outputDir, '.translation-cache.json');
+    if (!existsSync(filePath)) return new Map();
+    try {
+        const raw = JSON.parse(readFileSync(filePath, 'utf-8')) as Record<string, unknown>;
+        return new Map(
+            Object.entries(raw).filter(
+                (entry): entry is [string, string] => typeof entry[1] === 'string',
+            ),
+        );
+    } catch {
+        return new Map();
+    }
+}
+
+export function saveCache(outputDir: string, store: CacheStore): void {
+    try {
+        const filePath = join(outputDir, '.translation-cache.json');
+        mkdirSync(dirname(filePath), { recursive: true });
+        const obj = Object.fromEntries(store);
+        writeFileSync(filePath, JSON.stringify(obj, null, 2), 'utf-8');
+    } catch (error) {
+        console.warn(
+            `[cache] Failed to save translation cache: ${errorMessage(error)}. Continuing without cache.`,
+        );
+    }
+}
diff --git a/scripts/translation-pipeline/src/cli.ts b/scripts/translation-pipeline/src/cli.ts
new file mode 100644
index 000000000..2c4003d36
--- /dev/null
+++ b/scripts/translation-pipeline/src/cli.ts
@@ -0,0 +1,17 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+
+import { run } from '~/run';
+import { errorMessage } from '~/util';
+
+const envPath = path.resolve(process.cwd(), '.env');
+if (existsSync(envPath)) {
+    process.loadEnvFile(envPath);
+}
+
+function handleCliError(error: unknown): never {
+    console.error(`Error: ${errorMessage(error)}`);
+    process.exit(1);
+}
+
+run(process.argv.slice(2)).catch(handleCliError);
diff --git a/scripts/translation-pipeline/src/client.test.ts b/scripts/translation-pipeline/src/client.test.ts
new file mode 100644
index 000000000..04c4ec85e
--- /dev/null
+++ b/scripts/translation-pipeline/src/client.test.ts
@@ -0,0 +1,109 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { callLlm } from '~/client';
+
+describe('callLlm', () => {
+    beforeEach(() => {
+        vi.stubGlobal('fetch', vi.fn());
+        vi.stubEnv('LITELLM_BASE_URL', 'https://litellm.internal');
+    });
+
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.unstubAllEnvs();
+        vi.restoreAllMocks();
+    });
+
+    it('accepts the model through an options object', async () => {
+        vi.mocked(fetch).mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({ choices: [{ message: { content: '{"ok":true}' } }] }),
+        } as Response);
+
+        const result = await callLlm([{ role: 'user', content: 'hello' }], {
+            model: 'claude-sonnet-4-6',
+        });
+
+        expect(result.content).toBe('{"ok":true}');
+        const body = JSON.parse(String(vi.mocked(fetch).mock.calls[0][1]?.body)) as {
+            model: string;
+        };
+        expect(body.model).toBe('claude-sonnet-4-6');
+    });
+
+    it('retries 5xx twice with backoff, then gives up', async () => {
+        vi.useFakeTimers();
+        vi.mocked(fetch).mockResolvedValue({ ok: false, status: 503 } as Response);
+
+        const pending = callLlm([{ role: 'user', content: 'hello' }], { model: 'claude-sonnet-4-6' });
+        await vi.runAllTimersAsync();
+        const result = await pending;
+
+        expect(vi.mocked(fetch)).toHaveBeenCalledTimes(3);
+        expect(result.statusCode).toBe(503);
+        vi.useRealTimers();
+    });
+
+    it('does not retry 4xx', async () => {
+        vi.mocked(fetch).mockResolvedValue({ ok: false, status: 400 } as Response);
+
+        const result = await callLlm([{ role: 'user', content: 'hello' }], { model: 'claude-sonnet-4-6' });
+
+        expect(vi.mocked(fetch)).toHaveBeenCalledOnce();
+        expect(result.statusCode).toBe(400);
+    });
+
+    it('omits response_format when no schema is given', async () => {
+        vi.mocked(fetch).mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({ choices: [{ message: { content: 'plain text' } }] }),
+        } as Response);
+
+        await callLlm([{ role: 'user', content: 'hello' }], { model: 'claude-sonnet-4-6' });
+
+        const body = JSON.parse(String(vi.mocked(fetch).mock.calls[0][1]?.body)) as {
+            response_format?: { type: string };
+        };
+        expect(body.response_format).toBeUndefined();
+    });
+
+    it('sends strict json_schema when provided', async () => {
+        vi.mocked(fetch).mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({ choices: [{ message: { content: '{"ok":true}' } }] }),
+        } as Response);
+
+        await callLlm([{ role: 'user', content: 'hello' }], {
+            model: 'claude-sonnet-4-6',
+            jsonSchema: {
+                name: 'test_response',
+                schema: {
+                    type: 'object',
+                    additionalProperties: false,
+                    required: ['ok'],
+                    properties: { ok: { type: 'boolean' } },
+                },
+            },
+        });
+
+        const body = JSON.parse(String(vi.mocked(fetch).mock.calls[0][1]?.body)) as {
+            response_format?: {
+                type: string;
+                json_schema?: { name: string; strict: boolean; schema: object };
+            };
+        };
+        expect(body.response_format).toEqual({
+            type: 'json_schema',
+            json_schema: {
+                name: 'test_response',
+                strict: true,
+                schema: {
+                    type: 'object',
+                    additionalProperties: false,
+                    required: ['ok'],
+                    properties: { ok: { type: 'boolean' } },
+                },
+            },
+        });
+    });
+});
diff --git a/scripts/translation-pipeline/src/client.ts b/scripts/translation-pipeline/src/client.ts
new file mode 100644
index 000000000..1f6c8299a
--- /dev/null
+++ b/scripts/translation-pipeline/src/client.ts
@@ -0,0 +1,106 @@
+export interface LlmMessage {
+    role: 'system' | 'user';
+    content: string;
+}
+
+export interface LlmCallResult {
+    content: string | null;
+    error?: string;
+    statusCode?: number;
+}
+
+export interface LlmCallOptions {
+    model: string;
+    jsonSchema?: { name: string; schema: object };
+}
+
+const RETRY_DELAYS_MS = [1_000, 4_000];
+
+function isRetryable(result: LlmCallResult): boolean {
+    if (result.statusCode !== undefined) {
+        return result.statusCode === 429 || result.statusCode >= 500;
+    }
+    return result.error !== undefined && result.error.startsWith('fetch failed');
+}
+
+function delay(ms: number): Promise<void> {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export async function callLlm(
+    messages: LlmMessage[],
+    options: LlmCallOptions,
+): Promise<LlmCallResult> {
+    let result = await callLlmOnce(messages, options);
+    for (const wait of RETRY_DELAYS_MS) {
+        if (result.content !== null || !isRetryable(result)) return result;
+        await delay(wait);
+        result = await callLlmOnce(messages, options);
+    }
+    return result;
+}
+
+async function callLlmOnce(
+    messages: LlmMessage[],
+    options: LlmCallOptions,
+): Promise<LlmCallResult> {
+    const baseUrl = process.env['LITELLM_BASE_URL'];
+    if (!baseUrl) {
+        return { content: null, error: 'LITELLM_BASE_URL is not set' };
+    }
+
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 60_000);
+        let response: Response;
+        try {
+            response = await fetch(`${baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Client-Id': 'vapor-ui-translation-pipeline',
+                },
+                body: JSON.stringify({
+                    model: options.model,
+                    messages,
+                    ...(options.jsonSchema
+                        ? {
+                              response_format: {
+                                  type: 'json_schema',
+                                  json_schema: {
+                                      name: options.jsonSchema.name,
+                                      strict: true,
+                                      schema: options.jsonSchema.schema,
+                                  },
+                              },
+                          }
+                        : {}),
+                }),
+                signal: controller.signal,
+            });
+        } finally {
+            clearTimeout(timeout);
+        }
+
+        if (!response.ok) {
+            return {
+                content: null,
+                error: `Request failed with status ${response.status}`,
+                statusCode: response.status,
+            };
+        }
+
+        const data = (await response.json()) as {
+            choices?: { message?: { content?: unknown } }[];
+        };
+        const raw = data.choices?.[0]?.message?.content;
+        if (typeof raw !== 'string') {
+            return { content: null, error: 'Unexpected response shape' };
+        }
+
+        return { content: raw };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { content: null, error: `fetch failed: ${message}` };
+    }
+}
diff --git a/scripts/translation-pipeline/src/defaults.ts b/scripts/translation-pipeline/src/defaults.ts
new file mode 100644
index 000000000..56810608c
--- /dev/null
+++ b/scripts/translation-pipeline/src/defaults.ts
@@ -0,0 +1,3 @@
+export const DEFAULT_TRANSLATION_MODEL = 'claude-sonnet-4-6';
+export const DEFAULT_VALIDATION_MODEL = 'gemini-3-pro';
+export const DEFAULT_POSTPROCESS_MODEL = 'claude-sonnet-4-6';
diff --git a/scripts/translation-pipeline/src/domain.test.ts b/scripts/translation-pipeline/src/domain.test.ts
new file mode 100644
index 000000000..17dc76432
--- /dev/null
+++ b/scripts/translation-pipeline/src/domain.test.ts
@@ -0,0 +1,38 @@
+import { describe, expect, it } from 'vitest';
+
+import { type TranslationUnit, getTranslationUnitKey } from '~/domain';
+
+describe('getTranslationUnitKey', () => {
+    it('prop 설명 유닛은 컴포넌트 정체와 prop 이름으로 키를 만든다', () => {
+        const unit: TranslationUnit = {
+            kind: 'prop.description',
+            componentDisplayName: 'Select.Root',
+            propName: 'size',
+            source: 'The size.',
+        };
+
+        expect(getTranslationUnitKey(unit)).toBe('Select.Root:size');
+    });
+
+    it('컴포넌트 설명 유닛은 (description) 센티널을 쓴다', () => {
+        const unit: TranslationUnit = {
+            kind: 'component.description',
+            componentDisplayName: 'Select.Root',
+            source: 'A select root.',
+        };
+
+        expect(getTranslationUnitKey(unit)).toBe('Select.Root:(description)');
+    });
+
+    it('name이 겹치는 두 컴포넌트의 키가 갈린다', () => {
+        const select: TranslationUnit = {
+            kind: 'prop.description',
+            componentDisplayName: 'Select.Root',
+            propName: 'size',
+            source: 'The size.',
+        };
+        const avatar: TranslationUnit = { ...select, componentDisplayName: 'Avatar.Root' };
+
+        expect(getTranslationUnitKey(select)).not.toBe(getTranslationUnitKey(avatar));
+    });
+});
diff --git a/scripts/translation-pipeline/src/domain.ts b/scripts/translation-pipeline/src/domain.ts
new file mode 100644
index 000000000..e6a7bd7f3
--- /dev/null
+++ b/scripts/translation-pipeline/src/domain.ts
@@ -0,0 +1,108 @@
+export interface TranslatableDocProp {
+    name: string;
+    description?: string;
+}
+
+export interface TranslatableDoc {
+    name: string;
+    displayName: string;
+    description?: string;
+    props: TranslatableDocProp[];
+}
+
+export type MqmCategory =
+    | 'Accuracy/Mistranslation'
+    | 'Accuracy/Omission'
+    | 'Accuracy/Addition'
+    | 'Fluency/Unnatural phrasing'
+    | 'Fluency/Style inconsistency'
+    | 'Fluency/Grammatical error';
+
+export interface MqmError {
+    category: MqmCategory;
+    severity: 'minor' | 'major' | 'critical';
+    source_span: string;
+    mt_span: string;
+    explanation: string;
+}
+
+export type TranslationUnitKind = 'component.description' | 'prop.description';
+
+export type TranslationUnit =
+    | { kind: 'component.description'; componentDisplayName: string; source: string }
+    | {
+          kind: 'prop.description';
+          componentDisplayName: string;
+          propName: string;
+          source: string;
+      };
+
+export function getUnitOwnerName(unit: TranslationUnit): string {
+    return unit.kind === 'prop.description' ? unit.propName : unit.componentDisplayName;
+}
+
+export function makeUnitKey(componentDisplayName: string, propName: string | null): string {
+    return `${componentDisplayName}:${propName ?? '(description)'}`;
+}
+
+export function getTranslationUnitKey(unit: TranslationUnit): string {
+    return makeUnitKey(
+        unit.componentDisplayName,
+        unit.kind === 'prop.description' ? unit.propName : null,
+    );
+}
+
+export type AssuranceStatus = 'verified' | 'unverified';
+
+export type TranslationOutcomeReason =
+    | 'cache_hit'
+    | 'quality_gate_passed'
+    | 'quality_gate_failed'
+    | 'translation_failed'
+    | 'preservation_fallback'
+    | 'batch_mqm_failed'
+    | 'batch_postprocess_failed'
+    | 'batch_final_mqm_failed';
+
+export interface TranslationOutcome {
+    translated: string;
+    assurance: AssuranceStatus;
+    reportable: boolean;
+    reason: TranslationOutcomeReason;
+    errors: MqmError[];
+    violations: PreservationViolation[];
+}
+
+const REASON_META: Record<TranslationOutcomeReason, AssuranceStatus> = {
+    cache_hit: 'verified',
+    quality_gate_passed: 'verified',
+    quality_gate_failed: 'unverified',
+    translation_failed: 'unverified',
+    preservation_fallback: 'unverified',
+    batch_mqm_failed: 'unverified',
+    batch_postprocess_failed: 'unverified',
+    batch_final_mqm_failed: 'unverified',
+};
+
+export function makeOutcome(
+    translated: string,
+    reason: TranslationOutcomeReason,
+    detail: { errors?: MqmError[]; violations?: PreservationViolation[] } = {},
+): TranslationOutcome {
+    const assurance = REASON_META[reason];
+    return {
+        translated,
+        assurance,
+        reportable: assurance === 'unverified',
+        reason,
+        errors: detail.errors ?? [],
+        violations: detail.violations ?? [],
+    };
+}
+
+export type PreservationRule = 'backtick_span' | 'identifier' | 'url' | 'markdown_structure';
+
+export interface PreservationViolation {
+    rule: PreservationRule;
+    expected: string;
+}
diff --git a/scripts/translation-pipeline/src/input.test.ts b/scripts/translation-pipeline/src/input.test.ts
new file mode 100644
index 000000000..d6f4f412f
--- /dev/null
+++ b/scripts/translation-pipeline/src/input.test.ts
@@ -0,0 +1,39 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+
+import { readInputDocs } from '~/input';
+
+describe('readInputDocs', () => {
+    let inputDir: string;
+
+    beforeEach(() => {
+        inputDir = mkdtempSync(join(tmpdir(), 'input-test-'));
+        mkdirSync(inputDir, { recursive: true });
+    });
+
+    afterEach(() => {
+        rmSync(inputDir, { recursive: true, force: true });
+    });
+
+    function writeDoc(fileName: string, content: object): void {
+        writeFileSync(join(inputDir, fileName), JSON.stringify(content), 'utf-8');
+    }
+
+    it('displayName이 있으면 그것을 컴포넌트 정체로 쓴다', () => {
+        writeDoc('select-root.json', { name: 'Root', displayName: 'Select.Root', props: [] });
+
+        const [entry] = readInputDocs(inputDir);
+
+        expect(entry.doc.displayName).toBe('Select.Root');
+    });
+
+    it('displayName이 없으면 name으로 대체한다', () => {
+        writeDoc('spinner.json', { name: 'Spinner', props: [] });
+
+        const [entry] = readInputDocs(inputDir);
+
+        expect(entry.doc.displayName).toBe('Spinner');
+    });
+});
diff --git a/scripts/translation-pipeline/src/input.ts b/scripts/translation-pipeline/src/input.ts
new file mode 100644
index 000000000..31adb6f9d
--- /dev/null
+++ b/scripts/translation-pipeline/src/input.ts
@@ -0,0 +1,57 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+import type { TranslatableDoc } from '~/domain';
+import { errorMessage } from '~/util';
+
+export interface InputDoc {
+    doc: TranslatableDoc;
+    raw: Record<string, unknown>;
+    fileName: string;
+}
+
+export function readInputDocs(inputDir: string): InputDoc[] {
+    if (!existsSync(inputDir)) {
+        throw new Error(`Input directory does not exist: ${inputDir}`);
+    }
+    return readdirSync(inputDir)
+        .filter((name) => name.endsWith('.json'))
+        .sort()
+        .map((fileName) => {
+            let raw: unknown;
+            try {
+                raw = JSON.parse(readFileSync(join(inputDir, fileName), 'utf-8'));
+            } catch (error) {
+                throw new Error(`Failed to parse ${fileName}: ${errorMessage(error)}`);
+            }
+            return {
+                doc: toTranslatableDoc(raw, fileName),
+                raw: raw as Record<string, unknown>,
+                fileName,
+            };
+        });
+}
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+    typeof value === 'object' && value !== null;
+
+const optionalString = (value: unknown) => (typeof value === 'string' ? value : undefined);
+
+function toTranslatableDoc(raw: unknown, fileName: string): TranslatableDoc {
+    if (!isRecord(raw) || typeof raw['name'] !== 'string' || !raw['name']) {
+        throw new Error(`${fileName}: not a component doc (missing string field "name")`);
+    }
+    const propsRaw = Array.isArray(raw['props']) ? raw['props'] : [];
+    return {
+        name: raw['name'],
+        displayName: optionalString(raw['displayName']) ?? raw['name'],
+        description: optionalString(raw['description']),
+        props: propsRaw.map((entry) => {
+            const prop = isRecord(entry) ? entry : {};
+            return {
+                name: optionalString(prop['name']) ?? '',
+                description: optionalString(prop['description']),
+            };
+        }),
+    };
+}
diff --git a/scripts/translation-pipeline/src/output.ts b/scripts/translation-pipeline/src/output.ts
new file mode 100644
index 000000000..199b20fb0
--- /dev/null
+++ b/scripts/translation-pipeline/src/output.ts
@@ -0,0 +1,62 @@
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+
+import { makeUnitKey } from '~/domain';
+import type { InputDoc } from '~/input';
+import { errorMessage } from '~/util';
+
+interface OutputFile {
+    fileName: string;
+    content: Record<string, unknown>;
+}
+
+export function applyTranslationsToRaw(
+    inputDocs: Pick<InputDoc, 'raw' | 'fileName' | 'doc'>[],
+    translations: Map<string, string>,
+): OutputFile[] {
+    return inputDocs.map((entry) => {
+        const componentDisplayName = entry.doc.displayName;
+        const merged: Record<string, unknown> = { ...entry.raw };
+
+        const componentDescription = translations.get(makeUnitKey(componentDisplayName, null));
+        if (componentDescription !== undefined) {
+            merged['description'] = componentDescription;
+        }
+
+        const originalProps = Array.isArray(entry.raw['props']) ? entry.raw['props'] : [];
+        merged['props'] = originalProps.map((prop) => {
+            if (typeof prop !== 'object' || prop === null) return prop;
+            const propName = (prop as Record<string, unknown>)['name'];
+            if (typeof propName !== 'string') return prop;
+            const translated = translations.get(makeUnitKey(componentDisplayName, propName));
+            return translated === undefined
+                ? prop
+                : { ...(prop as Record<string, unknown>), description: translated };
+        });
+
+        return { fileName: entry.fileName, content: merged };
+    });
+}
+
+export function writeKoFiles(outputDir: string, files: OutputFile[]): string[] {
+    const koDir = join(outputDir, 'ko');
+    mkdirSync(koDir, { recursive: true });
+    const writtenFiles: string[] = [];
+    for (const { fileName, content } of files) {
+        const filePath = join(koDir, basename(fileName));
+        writeFileSync(filePath, JSON.stringify(content, null, 4) + '\n', 'utf-8');
+        writtenFiles.push(filePath);
+    }
+    return writtenFiles;
+}
+
+export function formatWithPrettier(filePaths: string[]): void {
+    if (filePaths.length === 0) return;
+
+    try {
+        execFileSync('npx', ['prettier', '--write', ...filePaths], { stdio: 'inherit' });
+    } catch (error) {
+        console.warn(`Prettier formatting skipped: ${errorMessage(error)}`);
+    }
+}
diff --git a/scripts/translation-pipeline/src/preserve.test.ts b/scripts/translation-pipeline/src/preserve.test.ts
new file mode 100644
index 000000000..dcfb0925f
--- /dev/null
+++ b/scripts/translation-pipeline/src/preserve.test.ts
@@ -0,0 +1,43 @@
+import { describe, expect, it } from 'vitest';
+
+import { checkPreservation } from '~/preserve';
+
+describe('checkPreservation', () => {
+    it('passes when every code span, identifier, URL, and structure survives', () => {
+        const source = 'Sets `aria-label` on the trigger. See https://vapor.goorm.io/docs.';
+        const translated = '트리거에 `aria-label`을 지정합니다. https://vapor.goorm.io/docs 참고.';
+
+        expect(checkPreservation(source, translated)).toEqual([]);
+    });
+
+    it('flags a dropped inline code span', () => {
+        const violations = checkPreservation('Renders a `<button>`.', '버튼을 렌더링합니다.');
+
+        expect(violations).toEqual([{ rule: 'backtick_span', expected: '`<button>`' }]);
+    });
+
+    it('flags a translated bare identifier outside backticks', () => {
+        const violations = checkPreservation(
+            'Calls onClick when pressed.',
+            '누르면 클릭을 호출합니다.',
+        );
+
+        expect(violations).toEqual([{ rule: 'identifier', expected: 'onClick' }]);
+    });
+
+    it('ignores identifiers that only appear inside backticks', () => {
+        expect(checkPreservation('Use `asChild`.', '`asChild`를 쓰세요.')).toEqual([]);
+    });
+
+    it('flags an altered URL', () => {
+        const violations = checkPreservation('See https://a.test/x.', 'https://a.test/y 참고.');
+
+        expect(violations).toEqual([{ rule: 'url', expected: 'https://a.test/x' }]);
+    });
+
+    it('flags a lost markdown list structure', () => {
+        const violations = checkPreservation('Options:\n- one\n- two', '옵션: 하나, 둘');
+
+        expect(violations).toEqual([{ rule: 'markdown_structure', expected: '-|-::0' }]);
+    });
+});
diff --git a/scripts/translation-pipeline/src/preserve.ts b/scripts/translation-pipeline/src/preserve.ts
new file mode 100644
index 000000000..55b7caa6d
--- /dev/null
+++ b/scripts/translation-pipeline/src/preserve.ts
@@ -0,0 +1,67 @@
+import type { PreservationViolation } from '~/domain';
+
+const BACKTICK_SPAN = /`[^`\n]+`/g;
+const URL = /https?:\/\/[^\s)>\]"']+/g;
+const MULTI_HUMP_IDENTIFIER = /\b[A-Za-z][a-z0-9]*(?:[A-Z][a-z0-9]*)+\b/g;
+const MARKDOWN_LINE_MARKER = /^\s*(#{1,6}|[-*+]|\d+\.|>|\|)(?=\s|\|)/;
+
+function unique(values: string[]): string[] {
+    return [...new Set(values)];
+}
+
+function stripBacktickSpans(text: string): string {
+    return text.replace(BACKTICK_SPAN, ' ');
+}
+
+function markdownSignature(text: string): string {
+    const markers = text
+        .split('\n')
+        .map((line) => line.match(MARKDOWN_LINE_MARKER)?.[1] ?? '')
+        .filter(Boolean);
+    const fences = (text.match(/```/g) ?? []).length;
+    return `${markers.join('|')}::${fences}`;
+}
+
+export function checkPreservation(source: string, translated: string): PreservationViolation[] {
+    const violations: PreservationViolation[] = [];
+
+    for (const span of unique(source.match(BACKTICK_SPAN) ?? [])) {
+        if (!translated.includes(span)) {
+            violations.push({ rule: 'backtick_span', expected: span });
+        }
+    }
+
+    const urls = unique(source.match(URL) ?? []).map((url) => url.replace(/[.,;:!?]+$/, ''));
+    for (const url of urls) {
+        if (!translated.includes(url)) {
+            violations.push({ rule: 'url', expected: url });
+        }
+    }
+
+    const bareSource = stripBacktickSpans(source);
+    for (const identifier of unique(bareSource.match(MULTI_HUMP_IDENTIFIER) ?? [])) {
+        if (!translated.includes(identifier)) {
+            violations.push({ rule: 'identifier', expected: identifier });
+        }
+    }
+
+    const expectedSignature = markdownSignature(source);
+    if (markdownSignature(translated) !== expectedSignature) {
+        violations.push({ rule: 'markdown_structure', expected: expectedSignature });
+    }
+
+    return violations;
+}
+
+export function describeViolation(violation: PreservationViolation): string {
+    switch (violation.rule) {
+        case 'backtick_span':
+            return `인라인 코드 \`${violation.expected}\`가 번역문에 그대로 남아 있지 않습니다.`;
+        case 'url':
+            return `URL ${violation.expected}이 변형됐습니다.`;
+        case 'identifier':
+            return `식별자 ${violation.expected}가 번역·변형됐습니다. 원문 철자를 그대로 쓰세요.`;
+        case 'markdown_structure':
+            return `마크다운 구조가 달라졌습니다. 원문 구조: ${violation.expected}`;
+    }
+}
diff --git a/scripts/translation-pipeline/src/report.test.ts b/scripts/translation-pipeline/src/report.test.ts
new file mode 100644
index 000000000..4830858e3
--- /dev/null
+++ b/scripts/translation-pipeline/src/report.test.ts
@@ -0,0 +1,281 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { buildComponentReports, buildReport, renderReport, writeReport } from '~/report';
+import type { ComponentReport, TranslationReport } from '~/report';
+import type { TranslatableDoc, TranslationOutcome, TranslationUnit } from '~/domain';
+
+function makeTmpDir(): string {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'report-test-'));
+}
+
+const unverifiedOutcome = {
+    key: 'Button:(description)',
+    translated: 'Button 컴포넌트.',
+    assurance: 'unverified' as const,
+    reportable: true,
+    reason: 'quality_gate_failed' as const,
+    errors: [
+        {
+            severity: 'minor' as const,
+            category: 'Fluency/Unnatural phrasing' as const,
+            source_span: 'component',
+            mt_span: '컴포넌트.',
+            explanation: '어색합니다.',
+        },
+    ],
+    violations: [],
+};
+
+describe('buildReport', () => {
+    it('aggregates verified, unverified, and cached counts', () => {
+        const components: ComponentReport[] = [
+            {
+                name: 'Button',
+                totalTexts: 5,
+                verified: 3,
+                unverified: 2,
+                cached: 1,
+                unverifiedOutcomes: [unverifiedOutcome],
+            },
+            {
+                name: 'Divider',
+                totalTexts: 0,
+                verified: 0,
+                unverified: 0,
+                cached: 0,
+                unverifiedOutcomes: [],
+            },
+        ];
+
+        const report = buildReport(components);
+
+        expect(report).toMatchObject({
+            totalComponents: 2,
+            totalTexts: 5,
+            verifiedCount: 3,
+            unverifiedCount: 2,
+            cachedCount: 1,
+            components,
+        });
+    });
+});
+
+describe('renderReport', () => {
+    it('renders the summary columns including components with zero units', () => {
+        const report: TranslationReport = {
+            generatedAt: '2026-05-08T00:00:00.000Z',
+            totalComponents: 2,
+            totalTexts: 2,
+            verifiedCount: 1,
+            unverifiedCount: 1,
+            cachedCount: 0,
+            passRate: 0.5,
+            reasonCounts: {},
+            categoryCounts: {},
+            violationCounts: {},
+            batchFallbacks: [],
+            components: [
+                {
+                    name: 'Button',
+                    totalTexts: 2,
+                    verified: 1,
+                    unverified: 1,
+                    cached: 0,
+                    unverifiedOutcomes: [unverifiedOutcome],
+                },
+                {
+                    name: 'Divider',
+                    totalTexts: 0,
+                    verified: 0,
+                    unverified: 0,
+                    cached: 0,
+                    unverifiedOutcomes: [],
+                },
+            ],
+        };
+
+        const output = renderReport(report);
+
+        expect(output).toContain('| Component | Total Texts | Verified | Unverified | Cached |');
+        expect(output).toContain('| Button | 2 | 1 | 1 | 0 |');
+        expect(output).toContain('| Divider | 0 | 0 | 0 | 0 |');
+    });
+
+    it('renders "None." in Batch Fallbacks section when there are no fallbacks', () => {
+        const report = buildReport(
+            [
+                {
+                    name: 'Button',
+                    totalTexts: 1,
+                    verified: 1,
+                    unverified: 0,
+                    cached: 0,
+                    unverifiedOutcomes: [],
+                },
+            ],
+            [],
+        );
+        const output = renderReport(report);
+        expect(output).toContain('## Batch Fallbacks');
+        expect(output).toContain('| Batch fallbacks | 0 |');
+        expect(output).toMatch(/## Batch Fallbacks\n\nNone\./);
+    });
+
+    it('renders batch fallback rows when fallbacks occurred', () => {
+        const report = buildReport(
+            [
+                {
+                    name: 'Button',
+                    totalTexts: 1,
+                    verified: 1,
+                    unverified: 0,
+                    cached: 0,
+                    unverifiedOutcomes: [],
+                },
+            ],
+            [
+                'batch MQM invalid: missing id "x"',
+                'batch postprocess invalid',
+            ],
+        );
+        const output = renderReport(report);
+        expect(output).toContain('| Batch fallbacks | 2 |');
+        expect(output).toContain('2 chunk(s) were marked unverified.');
+        expect(output).toContain('| Reason |');
+        expect(output).toContain('| batch MQM invalid: missing id "x" |');
+        expect(output).toContain('| batch postprocess invalid |');
+    });
+
+    it('renders details only for reportable unverified outcomes', () => {
+        const report = buildReport([
+            {
+                name: 'Button',
+                totalTexts: 3,
+                verified: 1,
+                unverified: 2,
+                cached: 0,
+                unverifiedOutcomes: [unverifiedOutcome],
+            },
+        ]);
+
+        const output = renderReport(report);
+
+        expect(output).toContain('## Unverified Details');
+        expect(output).toContain('### Button:(description)');
+        expect(output).toContain('Reason: `quality_gate_failed`');
+        expect(output).toContain('Output: `Button 컴포넌트.`');
+        expect(output).toContain('MQM errors');
+        expect(output).toContain('어색합니다.');
+    });
+});
+
+describe('writeReport', () => {
+    let tmpDir: string;
+
+    beforeEach(() => {
+        tmpDir = makeTmpDir();
+    });
+
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+
+    it('writes .i18n-report.md to outputDir', () => {
+        const report = buildReport([
+            {
+                name: 'Button',
+                totalTexts: 2,
+                verified: 2,
+                unverified: 0,
+                cached: 0,
+                unverifiedOutcomes: [],
+            },
+        ]);
+        writeReport(report, tmpDir);
+        const filePath = path.join(tmpDir, '.i18n-report.md');
+        expect(fs.existsSync(filePath)).toBe(true);
+        const content = fs.readFileSync(filePath, 'utf-8');
+        expect(content).toContain('Translation Quality Report');
+        expect(content).toContain('Button');
+    });
+
+    it('warns and does not throw when write fails', () => {
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
+        const readonlyDir = path.join(tmpDir, 'readonly');
+        fs.writeFileSync(readonlyDir, '');
+        try {
+            const report = buildReport([]);
+            expect(() => writeReport(report, readonlyDir)).not.toThrow();
+            expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('[report]'));
+        } finally {
+            warnSpy.mockRestore();
+            fs.rmSync(readonlyDir);
+        }
+    });
+});
+
+describe('buildComponentReports', () => {
+    const props: TranslatableDoc[] = [
+        {
+            name: 'Button',
+            displayName: 'Button',
+            description: 'A button component.',
+            props: [{ name: 'size', description: 'Controls the size.' }, { name: 'disabled' }],
+        },
+    ];
+
+    const units: TranslationUnit[] = [
+        {
+            kind: 'component.description',
+            componentDisplayName: 'Button',
+            source: 'A button component.',
+        },
+        {
+            kind: 'prop.description',
+            componentDisplayName: 'Button',
+            propName: 'size',
+            source: 'Controls the size.',
+        },
+    ];
+
+    it('summarizes verified, unverified, and cached outcomes per component', () => {
+        const outcomes = new Map<string, TranslationOutcome>([
+            [
+                'A button component.',
+                {
+                    translated: '캐시된 번역',
+                    assurance: 'verified',
+                    reportable: false,
+                    reason: 'cache_hit',
+                    errors: [],
+                    violations: [],
+                },
+            ],
+            [
+                'Controls the size.',
+                {
+                    translated: '크기를 지정합니다.',
+                    assurance: 'unverified',
+                    reportable: false,
+                    reason: 'batch_mqm_failed',
+                    errors: [],
+                    violations: [],
+                },
+            ],
+        ]);
+
+        expect(buildComponentReports(props, units, outcomes)).toEqual([
+            {
+                name: 'Button',
+                totalTexts: 2,
+                verified: 1,
+                unverified: 1,
+                cached: 1,
+                unverifiedOutcomes: [],
+            },
+        ]);
+    });
+});
diff --git a/scripts/translation-pipeline/src/report.ts b/scripts/translation-pipeline/src/report.ts
new file mode 100644
index 000000000..52939e5be
--- /dev/null
+++ b/scripts/translation-pipeline/src/report.ts
@@ -0,0 +1,250 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+import {
+    type MqmError,
+    type TranslatableDoc,
+    type TranslationOutcome,
+    type TranslationUnit,
+    getTranslationUnitKey,
+} from '~/domain';
+import { errorMessage } from '~/util';
+
+export interface ReportedOutcome extends TranslationOutcome {
+    key: string;
+}
+
+export interface ComponentReport {
+    name: string;
+    totalTexts: number;
+    verified: number;
+    unverified: number;
+    cached: number;
+    unverifiedOutcomes: ReportedOutcome[];
+}
+
+export interface TranslationReport {
+    generatedAt: string;
+    totalComponents: number;
+    totalTexts: number;
+    verifiedCount: number;
+    unverifiedCount: number;
+    cachedCount: number;
+    passRate: number;
+    reasonCounts: Record<string, number>;
+    categoryCounts: Record<string, number>;
+    violationCounts: Record<string, number>;
+    components: ComponentReport[];
+    batchFallbacks: string[];
+}
+
+export function buildComponentReports(
+    props: TranslatableDoc[],
+    units: TranslationUnit[],
+    outcomes: Map<string, TranslationOutcome>,
+): ComponentReport[] {
+    return props.map((component) => {
+        const componentUnits = units.filter(
+            (unit) => unit.componentDisplayName === component.displayName,
+        );
+        const componentOutcomes = componentUnits
+            .map((unit) => {
+                const outcome = outcomes.get(unit.source);
+                return outcome && { ...outcome, key: getTranslationUnitKey(unit) };
+            })
+            .filter((outcome): outcome is ReportedOutcome => outcome !== undefined);
+
+        return {
+            name: component.displayName,
+            totalTexts: componentUnits.length,
+            verified: componentOutcomes.filter((outcome) => outcome.assurance === 'verified')
+                .length,
+            unverified: componentOutcomes.filter((outcome) => outcome.assurance === 'unverified')
+                .length,
+            cached: componentOutcomes.filter((outcome) => outcome.reason === 'cache_hit').length,
+            unverifiedOutcomes: componentOutcomes.filter(
+                (outcome) => outcome.assurance === 'unverified' && outcome.reportable,
+            ),
+        };
+    });
+}
+
+function tally(values: string[]): Record<string, number> {
+    const counts: Record<string, number> = {};
+    for (const value of values) {
+        counts[value] = (counts[value] ?? 0) + 1;
+    }
+    return counts;
+}
+
+export function buildReport(
+    components: ComponentReport[],
+    batchFallbacks: string[] = [],
+): TranslationReport {
+    const totalTexts = components.reduce((sum, component) => sum + component.totalTexts, 0);
+    const verifiedCount = components.reduce((sum, component) => sum + component.verified, 0);
+    const reportedOutcomes = components.flatMap((component) => component.unverifiedOutcomes);
+
+    return {
+        generatedAt: new Date().toISOString(),
+        totalComponents: components.length,
+        totalTexts,
+        verifiedCount,
+        unverifiedCount: components.reduce((sum, component) => sum + component.unverified, 0),
+        cachedCount: components.reduce((sum, component) => sum + component.cached, 0),
+        passRate: totalTexts === 0 ? 1 : verifiedCount / totalTexts,
+        reasonCounts: tally(reportedOutcomes.map((outcome) => outcome.reason)),
+        categoryCounts: tally(
+            reportedOutcomes.flatMap((outcome) => outcome.errors.map((error) => error.category)),
+        ),
+        violationCounts: tally(
+            reportedOutcomes.flatMap((outcome) =>
+                outcome.violations.map((violation) => violation.rule),
+            ),
+        ),
+        components,
+        batchFallbacks,
+    };
+}
+
+function inlineCode(value: string): string {
+    const normalized = value.replace(/[\r\n]+/g, ' ').trim();
+    const longest = Math.max(0, ...(normalized.match(/`+/g)?.map((match) => match.length) ?? [0]));
+    const fence = '`'.repeat(longest + 1);
+    const pad = normalized.startsWith('`') || normalized.endsWith('`') ? ' ' : '';
+    return `${fence}${pad}${normalized}${pad}${fence}`;
+}
+
+function escapeTableCell(value: string): string {
+    return value
+        .replace(/[\r\n]+/g, ' ')
+        .replace(/\|/g, '\\|')
+        .trim();
+}
+
+function renderMqmErrors(title: string, errors: MqmError[]): string[] {
+    if (errors.length === 0) return [];
+    return [
+        `${title}:`,
+        '',
+        '| Severity | Category | Source | Output | Explanation |',
+        '|---|---|---|---|---|',
+        ...errors.map(
+            (error) =>
+                `| ${error.severity.toUpperCase()} | ${error.category} | ${inlineCode(
+                    error.source_span,
+                )} | ${inlineCode(error.mt_span)} | ${escapeTableCell(error.explanation)} |`,
+        ),
+    ];
+}
+
+function renderDistribution(title: string, counts: Record<string, number>): string[] {
+    const rows = Object.entries(counts).sort(([, a], [, b]) => b - a);
+    if (rows.length === 0) return [];
+    return [
+        `${title}:`,
+        '',
+        '| Key | Count |',
+        '|---|---:|',
+        ...rows.map(([key, count]) => `| ${key} | ${count} |`),
+        '',
+    ];
+}
+
+function renderUnverifiedDetail(outcome: ReportedOutcome): string {
+    const lines = [
+        `### ${outcome.key}`,
+        '',
+        `Reason: ${inlineCode(outcome.reason)}`,
+        `Output: ${inlineCode(outcome.translated)}`,
+    ];
+
+    if (outcome.errors.length > 0) {
+        lines.push('', ...renderMqmErrors('MQM errors', outcome.errors));
+    }
+
+    if (outcome.violations.length > 0) {
+        lines.push(
+            '',
+            'Preservation violations:',
+            '',
+            ...outcome.violations.map(
+                (violation) => `- ${violation.rule}: ${inlineCode(violation.expected)}`,
+            ),
+        );
+    }
+
+    return lines.join('\n');
+}
+
+export function renderReport(report: TranslationReport): string {
+    const details = report.components.flatMap((component) =>
+        component.unverifiedOutcomes.map(renderUnverifiedDetail),
+    );
+
+    const lines = [
+        '# Translation Quality Report (MQM)',
+        '',
+        `Generated: ${report.generatedAt}`,
+        '',
+        '## Summary',
+        '',
+        '| Metric | Value |',
+        '|---|---:|',
+        `| Components | ${report.totalComponents} |`,
+        `| Total texts | ${report.totalTexts} |`,
+        `| Verified | ${report.verifiedCount} |`,
+        `| Unverified | ${report.unverifiedCount} |`,
+        `| Cached | ${report.cachedCount} |`,
+        `| Pass rate | ${(report.passRate * 100).toFixed(1)}% |`,
+        `| Batch fallbacks | ${report.batchFallbacks.length} |`,
+        '',
+        '## Failure Distribution',
+        '',
+        ...(Object.keys(report.reasonCounts).length === 0
+            ? ['No reportable failures.']
+            : [
+                  ...renderDistribution('By reason', report.reasonCounts),
+                  ...renderDistribution('By MQM category', report.categoryCounts),
+                  ...renderDistribution('By preservation rule', report.violationCounts),
+              ]),
+        '',
+        '## Batch Fallbacks',
+        '',
+        ...(report.batchFallbacks.length === 0
+            ? ['None.']
+            : [
+                  `${report.batchFallbacks.length} chunk(s) were marked unverified.`,
+                  '',
+                  '| Reason |',
+                  '|---|',
+                  ...report.batchFallbacks.map((reason) => `| ${escapeTableCell(reason)} |`),
+              ]),
+        '',
+        '## Component Summary',
+        '',
+        '| Component | Total Texts | Verified | Unverified | Cached |',
+        '|---|---:|---:|---:|---:|',
+        ...report.components.map(
+            (component) =>
+                `| ${component.name} | ${component.totalTexts} | ${component.verified} | ${component.unverified} | ${component.cached} |`,
+        ),
+        '',
+        '## Unverified Details',
+        '',
+        ...(details.length > 0 ? details : ['No reportable unverified translations.']),
+        '',
+    ];
+
+    return lines.join('\n');
+}
+
+export function writeReport(report: TranslationReport, outputDir: string): void {
+    try {
+        const filePath = join(outputDir, '.i18n-report.md');
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, renderReport(report), 'utf-8');
+    } catch (error) {
+        console.warn(`[report] Failed to write i18n report: ${errorMessage(error)}`);
+    }
+}
diff --git a/scripts/translation-pipeline/src/run.test.ts b/scripts/translation-pipeline/src/run.test.ts
new file mode 100644
index 000000000..59fe9ab48
--- /dev/null
+++ b/scripts/translation-pipeline/src/run.test.ts
@@ -0,0 +1,130 @@
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { type TranslatableDoc, makeUnitKey } from '~/domain';
+import { parseCliArgs, run } from '~/run';
+import * as translatorModule from '~/translator';
+import type { ReportedOutcome } from '~/report';
+import type { TranslateResult } from '~/translator';
+
+function passthroughRunner(docs: TranslatableDoc[]): Promise<TranslateResult> {
+    const translations = new Map<string, string>();
+    for (const doc of docs) {
+        if (doc.description) {
+            translations.set(makeUnitKey(doc.displayName, null), `[ko]${doc.description}`);
+        }
+        for (const prop of doc.props) {
+            if (prop.description) {
+                translations.set(makeUnitKey(doc.displayName, prop.name), `[ko]${prop.description}`);
+            }
+        }
+    }
+    const componentReports = docs.map((doc) => ({
+        name: doc.displayName,
+        totalTexts: (doc.description ? 1 : 0) + doc.props.filter((p) => p.description).length,
+        verified: (doc.description ? 1 : 0) + doc.props.filter((p) => p.description).length,
+        unverified: 0,
+        cached: 0,
+        unverifiedOutcomes: [] as ReportedOutcome[],
+    }));
+    return Promise.resolve({ translations, componentReports, batchFallbacks: [] });
+}
+
+describe('parseCliArgs', () => {
+    it('returns input and output when both are provided', () => {
+        const result = parseCliArgs(['--input', './en', '--output', './out']);
+        expect(result).toEqual({ input: './en', output: './out' });
+    });
+
+    it('throws when --input is missing', () => {
+        expect(() => parseCliArgs(['--output', './out'])).toThrow(/--input/);
+    });
+
+    it('throws when --output is missing', () => {
+        expect(() => parseCliArgs(['--input', './en'])).toThrow(/--output/);
+    });
+});
+
+describe('cli run', () => {
+    let workDir: string;
+
+    beforeEach(() => {
+        workDir = mkdtempSync(join(tmpdir(), 'translation-pipeline-cli-'));
+        vi.stubEnv('LITELLM_BASE_URL', 'https://example.test');
+        vi.spyOn(translatorModule, 'translateDescriptions').mockImplementation(passthroughRunner);
+    });
+
+    afterEach(() => {
+        rmSync(workDir, { recursive: true, force: true });
+        vi.unstubAllEnvs();
+        vi.restoreAllMocks();
+    });
+
+    it('throws when --input is missing', async () => {
+        await expect(run(['--output', join(workDir, 'out')])).rejects.toThrow(/--input/);
+    });
+
+    it('throws when --output is missing', async () => {
+        await expect(run(['--input', join(workDir, 'en')])).rejects.toThrow(/--output/);
+    });
+
+    it('throws when LITELLM_BASE_URL is missing', async () => {
+        vi.stubEnv('LITELLM_BASE_URL', '');
+        const inputDir = join(workDir, 'en');
+        mkdirSync(inputDir, { recursive: true });
+        await expect(run(['--input', inputDir, '--output', join(workDir, 'out')])).rejects.toThrow(
+            /LITELLM_BASE_URL/,
+        );
+    });
+
+    it('reads EN JSON files and writes ko/ + .i18n-report.md', async () => {
+        const inputDir = join(workDir, 'en');
+        const outputDir = join(workDir, 'out');
+        mkdirSync(inputDir, { recursive: true });
+
+        const button: Record<string, unknown> = {
+            name: 'Button',
+            description: 'A clickable button.',
+            props: [
+                {
+                    name: 'size',
+                    type: ['"sm"', '"md"'],
+                    required: false,
+                    description: 'Size of the button.',
+                },
+                { name: 'className', type: ['string'], required: false },
+            ],
+        };
+        writeFileSync(join(inputDir, 'button.json'), JSON.stringify(button), 'utf-8');
+
+        const result = await run(['--input', inputDir, '--output', outputDir]);
+
+        expect(result.writtenFiles).toHaveLength(1);
+        const koPath = join(outputDir, 'ko', 'button.json');
+        expect(existsSync(koPath)).toBe(true);
+        const koContent = JSON.parse(readFileSync(koPath, 'utf-8')) as {
+            name: string;
+            description: string;
+            props: { name: string; description?: string; type?: string[] }[];
+        };
+        expect(koContent.name).toBe('Button');
+        expect(koContent.description).toBe('[ko]A clickable button.');
+        expect(koContent.props[0].description).toBe('[ko]Size of the button.');
+        expect(koContent.props[0].type).toEqual(['"sm"', '"md"']);
+        expect(koContent.props[1].name).toBe('className');
+        expect(koContent.props[1].description).toBeUndefined();
+
+        expect(existsSync(result.reportPath)).toBe(true);
+        const reportContent = readFileSync(result.reportPath, 'utf-8');
+        expect(reportContent).toContain('Translation Quality Report');
+        expect(reportContent).toContain('| Button |');
+    });
+
+    it('throws when input directory does not exist', async () => {
+        await expect(
+            run(['--input', join(workDir, 'missing'), '--output', join(workDir, 'out')]),
+        ).rejects.toThrow(/Input directory does not exist/);
+    });
+});
diff --git a/scripts/translation-pipeline/src/run.ts b/scripts/translation-pipeline/src/run.ts
new file mode 100644
index 000000000..e1942c9ce
--- /dev/null
+++ b/scripts/translation-pipeline/src/run.ts
@@ -0,0 +1,84 @@
+import meow from 'meow';
+import { join, resolve } from 'node:path';
+
+import { readInputDocs } from '~/input';
+import { applyTranslationsToRaw, formatWithPrettier, writeKoFiles } from '~/output';
+import { buildReport, writeReport } from '~/report';
+import { translateDescriptions } from '~/translator';
+
+export interface CliOptions {
+    input: string;
+    output: string;
+}
+
+export interface RunResult {
+    options: CliOptions;
+    writtenFiles: string[];
+    reportPath: string;
+}
+
+const HELP_TEXT = `
+  Usage
+    $ translation-pipeline --input <dir> --output <dir>
+
+  Options
+    --input, -i      Directory containing EN JSON files (required)
+    --output, -o     Directory where ko/, .translation-cache.json, .i18n-report.md are written (required)
+
+  Examples
+    $ translation-pipeline --input ./generated/en --output ./generated
+`;
+
+export function parseCliArgs(argv: string[]): CliOptions {
+    const cli = meow(HELP_TEXT, {
+        argv,
+        importMeta: import.meta,
+        flags: {
+            input: { type: 'string', shortFlag: 'i' },
+            output: { type: 'string', shortFlag: 'o' },
+        },
+    });
+
+    const input = cli.flags.input?.trim();
+    const output = cli.flags.output?.trim();
+
+    if (!input) {
+        throw new Error('Missing required option: --input');
+    }
+    if (!output) {
+        throw new Error('Missing required option: --output');
+    }
+
+    return { input, output };
+}
+
+function requireEnv(name: string): void {
+    if (!process.env[name]?.trim()) {
+        throw new Error(`Missing required environment variable: ${name}`);
+    }
+}
+
+export async function run(argv: string[]): Promise<RunResult> {
+    const cliOptions = parseCliArgs(argv);
+
+    requireEnv('LITELLM_BASE_URL');
+
+    const inputDir = resolve(cliOptions.input);
+    const outputDir = resolve(cliOptions.output);
+
+    const inputDocs = readInputDocs(inputDir);
+    const result = await translateDescriptions(
+        inputDocs.map((entry) => entry.doc),
+        outputDir,
+    );
+
+    const writtenFiles = writeKoFiles(
+        outputDir,
+        applyTranslationsToRaw(inputDocs, result.translations),
+    );
+    formatWithPrettier(writtenFiles);
+
+    writeReport(buildReport(result.componentReports, result.batchFallbacks), outputDir);
+
+    return { options: cliOptions, writtenFiles, reportPath: join(outputDir, '.i18n-report.md') };
+}
diff --git a/scripts/translation-pipeline/src/translate.test.ts b/scripts/translation-pipeline/src/translate.test.ts
new file mode 100644
index 000000000..e6beedc63
--- /dev/null
+++ b/scripts/translation-pipeline/src/translate.test.ts
@@ -0,0 +1,226 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import type { TranslationUnit } from '~/domain';
+import { translateUnits } from '~/translate';
+
+const units: TranslationUnit[] = [
+    {
+        kind: 'component.description',
+        componentDisplayName: 'Button',
+        source: 'A button component.',
+    },
+    {
+        kind: 'prop.description',
+        componentDisplayName: 'Button',
+        propName: 'size',
+        source: 'Controls the size.',
+    },
+];
+
+function mockFetchContent(content: string): void {
+    vi.mocked(fetch).mockResolvedValueOnce({
+        ok: true,
+        json: async () => ({ choices: [{ message: { content } }] }),
+    } as Response);
+}
+
+describe('translateUnits', () => {
+    beforeEach(() => {
+        vi.stubGlobal('fetch', vi.fn());
+        vi.stubEnv('LITELLM_BASE_URL', 'https://litellm.internal');
+    });
+
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.unstubAllEnvs();
+        vi.restoreAllMocks();
+    });
+
+    it('calls LiteLLM JSON mode with a component-scoped translation-unit payload', async () => {
+        mockFetchContent(
+            JSON.stringify({
+                translations: [
+                    { id: 'Button:(description)', translated: 'Button 컴포넌트입니다.' },
+                    { id: 'Button:size', translated: '크기를 지정합니다.' },
+                ],
+            }),
+        );
+
+        const result = await translateUnits(units);
+
+        expect(result).toEqual(
+            new Map([
+                ['Button:(description)', 'Button 컴포넌트입니다.'],
+                ['Button:size', '크기를 지정합니다.'],
+            ]),
+        );
+
+        const body = JSON.parse(String(vi.mocked(fetch).mock.calls[0][1]?.body)) as {
+            model: string;
+            response_format?: { type: string; json_schema?: { strict: boolean } };
+            messages: { role: string; content: string }[];
+        };
+        expect(body.model).toBe('claude-sonnet-4-6');
+        expect(body.response_format?.type).toBe('json_schema');
+        expect(body.response_format?.json_schema?.strict).toBe(true);
+        expect(body.messages.at(-1)?.content).toContain('"componentName":"Button"');
+        expect(body.messages.at(-1)?.content).toContain('"id":"Button:size"');
+    });
+
+    // 회귀 가드 — compound 파트의 문맥이 'Root'로 뭉개지지 않는지 지킨다.
+    it('sends the qualified component name so compound parts are distinguishable', async () => {
+        const compoundUnits: TranslationUnit[] = [
+            {
+                kind: 'component.description',
+                componentDisplayName: 'Select.Root',
+                source: 'A select root.',
+            },
+            {
+                kind: 'prop.description',
+                componentDisplayName: 'Select.Root',
+                propName: 'size',
+                source: 'The size.',
+            },
+        ];
+        mockFetchContent(
+            JSON.stringify({
+                translations: [
+                    { id: 'Select.Root:(description)', translated: '셀렉트 루트입니다.' },
+                    { id: 'Select.Root:size', translated: '크기를 지정합니다.' },
+                ],
+            }),
+        );
+
+        await translateUnits(compoundUnits);
+
+        const payload = String(
+            JSON.parse(String(vi.mocked(fetch).mock.calls[0][1]?.body)).messages.at(-1).content,
+        );
+        expect(payload).toContain('"componentName":"Select.Root"');
+        // 컴포넌트 설명 유닛의 ownerName은 컴포넌트 자신, prop 유닛은 prop 이름
+        expect(payload).toContain('"ownerName":"Select.Root"');
+        expect(payload).toContain('"ownerName":"size"');
+    });
+
+    it('sends a system prompt that includes MQM-mirrored style rules', async () => {
+        mockFetchContent(
+            JSON.stringify({
+                translations: [
+                    { id: 'Button:(description)', translated: 'Button 컴포넌트입니다.' },
+                    { id: 'Button:size', translated: '크기를 지정합니다.' },
+                ],
+            }),
+        );
+
+        await translateUnits(units);
+
+        const body = JSON.parse(String(vi.mocked(fetch).mock.calls[0][1]?.body)) as {
+            messages: { role: string; content: string }[];
+        };
+        const systemMessage = body.messages.find((message) => message.role === 'system');
+        expect(systemMessage).toBeDefined();
+        const systemContent = systemMessage?.content ?? '';
+
+        // MQM 미러링 패턴
+        expect(systemContent).toContain('~를 제어합니다');
+        expect(systemContent).toContain('~를 수행합니다');
+        expect(systemContent).toContain('~에 적용되는');
+        // 문체 규칙
+        expect(systemContent).toContain('합쇼체');
+        expect(systemContent).toContain('active voice');
+        // 식별자 보존
+        expect(systemContent).toContain('PascalCase');
+        expect(systemContent).toContain('camelCase');
+    });
+
+    it('parses JSON responses wrapped in markdown code fences', async () => {
+        mockFetchContent(`\`\`\`json
+${JSON.stringify({
+    translations: [
+        { id: 'Button:(description)', translated: 'Button 컴포넌트입니다.' },
+        { id: 'Button:size', translated: '크기를 지정합니다.' },
+    ],
+})}
+\`\`\``);
+
+        const result = await translateUnits(units);
+
+        expect(result).toEqual(
+            new Map([
+                ['Button:(description)', 'Button 컴포넌트입니다.'],
+                ['Button:size', '크기를 지정합니다.'],
+            ]),
+        );
+    });
+
+    it('throws when an expected id is missing', async () => {
+        mockFetchContent(
+            JSON.stringify({
+                translations: [{ id: 'Button:(description)', translated: 'Button입니다.' }],
+            }),
+        );
+
+        await expect(translateUnits(units)).rejects.toThrow(/Missing response id: Button:size/);
+    });
+
+    it('throws when response contains a duplicate id', async () => {
+        mockFetchContent(
+            JSON.stringify({
+                translations: [
+                    { id: 'Button:(description)', translated: 'Button입니다.' },
+                    { id: 'Button:(description)', translated: '중복입니다.' },
+                    { id: 'Button:size', translated: '크기입니다.' },
+                ],
+            }),
+        );
+
+        await expect(translateUnits(units)).rejects.toThrow(
+            /Duplicate response id: Button:\(description\)/,
+        );
+    });
+
+    it('throws when response contains an unknown id', async () => {
+        mockFetchContent(
+            JSON.stringify({
+                translations: [
+                    { id: 'Button:(description)', translated: 'Button입니다.' },
+                    { id: 'Button:size', translated: '크기입니다.' },
+                    { id: 'Button:ghost', translated: '알 수 없음' },
+                ],
+            }),
+        );
+
+        await expect(translateUnits(units)).rejects.toThrow(/Unknown response id: Button:ghost/);
+    });
+
+    it('throws when translated is empty', async () => {
+        mockFetchContent(
+            JSON.stringify({
+                translations: [
+                    { id: 'Button:(description)', translated: '' },
+                    { id: 'Button:size', translated: '크기입니다.' },
+                ],
+            }),
+        );
+
+        await expect(translateUnits(units)).rejects.toThrow(
+            /Empty translation for id: Button:\(description\)/,
+        );
+    });
+
+    it('allows translated text to equal source', async () => {
+        mockFetchContent(
+            JSON.stringify({
+                translations: [
+                    { id: 'Button:(description)', translated: 'A button component.' },
+                    { id: 'Button:size', translated: 'Controls the size.' },
+                ],
+            }),
+        );
+
+        const result = await translateUnits(units);
+
+        expect(result.get('Button:(description)')).toBe('A button component.');
+        expect(result.get('Button:size')).toBe('Controls the size.');
+    });
+});
diff --git a/scripts/translation-pipeline/src/translate.ts b/scripts/translation-pipeline/src/translate.ts
new file mode 100644
index 000000000..f4ce7e07e
--- /dev/null
+++ b/scripts/translation-pipeline/src/translate.ts
@@ -0,0 +1,89 @@
+import { callBatch } from '~/batch-call';
+import { DEFAULT_TRANSLATION_MODEL } from '~/defaults';
+import { type TranslationUnit, getTranslationUnitKey, getUnitOwnerName } from '~/domain';
+
+const SYSTEM_PROMPT = `You are a professional Korean translator for design-system API documentation. Respond ONLY with valid JSON.
+
+Translate each source string to natural Korean while preserving component names, prop names, enum values, markdown, inline code, URLs, token names, and TypeScript identifiers exactly.
+
+Identifier preservation (must keep the original English spelling exactly — never translate, romanize, or normalize):
+- PascalCase component names (Breadcrumb, Button, TextInput)
+- camelCase prop names (asChild, onClick, isDisabled)
+- quoted enum values ("sm", "ghost", "md")
+- HTML/ARIA attributes (aria-label, data-state)
+- Design tokens and TypeScript identifiers
+
+Style rules (translations are evaluated against these — write the Korean text so it passes on the first pass):
+- Use 합쇼체 (~합니다, ~입니다). Do not use 해요체 or 반말.
+- Prefer active voice. The subject should be the component or the developer, not an abstract noun.
+- Avoid 번역투. The following patterns are flagged as Fluency/Unnatural phrasing — do NOT produce them:
+    "~를 제어합니다"         → write "~를 지정합니다" or "~를 설정합니다" instead
+    "~를 수행합니다"         → use a direct verb (e.g. "~합니다", "~을 처리합니다")
+    "~에 적용되는"           → write "~에 줄" or rephrase with an active verb
+    "~를 반환하는 함수입니다" → drop the trailing 이다 (e.g. "~를 반환합니다")
+    abstract-noun subjects   → rewrite with the component or developer as the subject
+- Translate prop/component descriptions as instructions to the developer ("…을 지정합니다", "…을 설정합니다"), not as third-person reports about the API.
+
+Each unit carries the name of the component it belongs to. Echo every unit's id back exactly as given.
+
+Return exactly this JSON shape:
+{"translations":[{"id":"12:component.description","translated":"Korean translation"}]}`;
+
+interface TranslationResponseItem {
+    id: string;
+    translated: string;
+}
+
+const TRANSLATION_RESPONSE_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['translations'],
+    properties: {
+        translations: {
+            type: 'array',
+            items: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['id', 'translated'],
+                properties: {
+                    id: { type: 'string' },
+                    translated: { type: 'string' },
+                },
+            },
+        },
+    },
+};
+
+export async function translateUnits(units: TranslationUnit[]): Promise<Map<string, string>> {
+    if (units.length === 0) {
+        return new Map();
+    }
+
+    const request = {
+        units: units.map((unit) => ({
+            id: getTranslationUnitKey(unit),
+            kind: unit.kind,
+            ownerName: getUnitOwnerName(unit),
+            componentName: unit.componentDisplayName,
+            source: unit.source,
+        })),
+    };
+
+    const result = await callBatch<TranslationResponseItem>(
+        'llm-translation',
+        SYSTEM_PROMPT,
+        DEFAULT_TRANSLATION_MODEL,
+        { name: 'translation_response', schema: TRANSLATION_RESPONSE_SCHEMA },
+        request,
+        units.map(getTranslationUnitKey),
+        'translations',
+    );
+    if (!result.ok) throw new Error(result.reason);
+
+    for (const item of result.value.values()) {
+        if (item.translated.trim().length === 0) {
+            throw new Error(`Empty translation for id: ${item.id}`);
+        }
+    }
+    return new Map([...result.value].map(([id, item]) => [id, item.translated]));
+}
diff --git a/scripts/translation-pipeline/src/translator.test.ts b/scripts/translation-pipeline/src/translator.test.ts
new file mode 100644
index 000000000..2c0aee3ee
--- /dev/null
+++ b/scripts/translation-pipeline/src/translator.test.ts
@@ -0,0 +1,401 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import * as cacheModule from '~/cache';
+import * as clientModule from '~/client';
+import { type TranslatableDoc, getTranslationUnitKey } from '~/domain';
+import * as translationModule from '~/translate';
+import { translateDescriptions } from '~/translator';
+
+const sampleProps: TranslatableDoc[] = [
+    {
+        name: 'Button',
+        displayName: 'Button',
+        description: 'A button component.',
+        props: [{ name: 'onClick', description: 'Click handler callback.' }],
+    },
+    {
+        name: 'Divider',
+        displayName: 'Divider',
+        props: [],
+    },
+];
+
+function mockTranslations(translations: Record<string, string>): void {
+    vi.spyOn(translationModule, 'translateUnits').mockImplementation(async (units) => {
+        return new Map(
+            units.map((unit) => [
+                getTranslationUnitKey(unit),
+                translations[getTranslationUnitKey(unit)] ?? unit.source,
+            ]),
+        );
+    });
+}
+
+function mockBatchMqmPass(): void {
+    vi.spyOn(clientModule, 'callLlm').mockImplementation(async (messages) => {
+        const userContent = messages.find((m) => m.role === 'user')?.content ?? '';
+        try {
+            const parsed = JSON.parse(userContent) as { units?: { id: string }[] };
+            if (Array.isArray(parsed.units)) {
+                const evaluations = parsed.units.map(({ id }: { id: string }) => ({
+                    id,
+                    verdict: 'PASS',
+                    errors: [],
+                }));
+                return { content: JSON.stringify({ evaluations }) };
+            }
+        } catch {
+            // not JSON — fall through
+        }
+        return { content: '{}' };
+    });
+}
+
+describe('translateDescriptions', () => {
+    beforeEach(() => {
+        vi.spyOn(cacheModule, 'loadCache').mockReturnValue(new Map());
+        vi.spyOn(cacheModule, 'saveCache').mockImplementation(() => undefined);
+        mockTranslations({
+            'Button:(description)': 'Button 컴포넌트입니다.',
+            'Button:onClick': '클릭 handler callback입니다.',
+        });
+        mockBatchMqmPass();
+    });
+
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+
+    it('returns a translations dictionary keyed by component identity and prop name', async () => {
+        const result = await translateDescriptions(sampleProps);
+
+        expect([...result.translations.keys()].sort()).toEqual([
+            'Button:(description)',
+            'Button:onClick',
+        ]);
+        expect(result.translations.get('Button:(description)')).toBe('Button 컴포넌트입니다.');
+        expect(result.translations.get('Button:onClick')).toBe('클릭 handler callback입니다.');
+    });
+
+    it('throws instead of silently overwriting when two units share a key', async () => {
+        const collidingDocs: TranslatableDoc[] = [
+            {
+                name: 'Root',
+                displayName: 'Select.Root',
+                props: [{ name: 'size', description: 'a' }],
+            },
+            {
+                name: 'Root',
+                displayName: 'Select.Root',
+                props: [{ name: 'size', description: 'b' }],
+            },
+        ];
+
+        await expect(translateDescriptions(collidingDocs)).rejects.toThrow(
+            /Duplicate translation unit key: Select\.Root:size/,
+        );
+    });
+
+    it('translates only cache misses, in a single cross-component batch', async () => {
+        const cachedKey = cacheModule.makeCacheKey('Click handler callback.');
+        vi.spyOn(cacheModule, 'loadCache').mockReturnValue(
+            new Map([[cachedKey, '캐시된 콜백 설명입니다.']]),
+        );
+        const translateSpy = vi.spyOn(translationModule, 'translateUnits');
+
+        const result = await translateDescriptions(sampleProps, '/tmp/cache');
+
+        expect(translateSpy).toHaveBeenCalledOnce();
+        expect(translateSpy).toHaveBeenCalledWith([
+            expect.objectContaining({
+                kind: 'component.description',
+                source: 'A button component.',
+                componentDisplayName: 'Button',
+            }),
+        ]);
+        expect(result.translations.get('Button:(description)')).toBe('Button 컴포넌트입니다.');
+        expect(result.translations.get('Button:onClick')).toBe('캐시된 콜백 설명입니다.');
+    });
+
+    it('keeps components with zero translation units in the report summary', async () => {
+        const result = await translateDescriptions(sampleProps);
+
+        expect(result.componentReports).toEqual(
+            expect.arrayContaining([
+                expect.objectContaining({
+                    name: 'Divider',
+                    totalTexts: 0,
+                    verified: 0,
+                    unverified: 0,
+                    cached: 0,
+                }),
+            ]),
+        );
+    });
+
+    it('saves only verified final outcomes to cache', async () => {
+        const saveCacheSpy = vi.spyOn(cacheModule, 'saveCache');
+        const initialError = {
+            category: 'Accuracy/Mistranslation' as const,
+            severity: 'major' as const,
+            source_span: 'Click handler',
+            mt_span: '클릭',
+            explanation: '오역입니다.',
+        };
+        const finalError = {
+            category: 'Accuracy/Mistranslation' as const,
+            severity: 'major' as const,
+            source_span: 'Click handler',
+            mt_span: '수정되어도 검증 실패한 번역',
+            explanation: '여전히 오역입니다.',
+        };
+
+        // callLlm 호출 순서: 1) 초기 batch MQM, 2) batch postprocess, 3) 최종 batch MQM
+        let llmCallCount = 0;
+        vi.spyOn(clientModule, 'callLlm').mockImplementation(async () => {
+            llmCallCount++;
+            if (llmCallCount === 1) {
+                return {
+                    content: JSON.stringify({
+                        evaluations: [
+                            { id: 'Button:(description)', verdict: 'PASS', errors: [] },
+                            {
+                                id: 'Button:onClick',
+                                verdict: 'FAIL',
+                                errors: [initialError],
+                            },
+                        ],
+                    }),
+                };
+            }
+            if (llmCallCount === 2) {
+                return {
+                    content: JSON.stringify({
+                        translations: [
+                            {
+                                id: 'Button:onClick',
+                                translated: '수정되어도 검증 실패한 번역',
+                            },
+                        ],
+                    }),
+                };
+            }
+            return {
+                content: JSON.stringify({
+                    evaluations: [
+                        {
+                            id: 'Button:onClick',
+                            verdict: 'FAIL',
+                            errors: [finalError],
+                        },
+                    ],
+                }),
+            };
+        });
+
+        await translateDescriptions(sampleProps.slice(0, 1), '/tmp/cache');
+
+        const savedStore = saveCacheSpy.mock.calls[0]?.[1];
+        expect(savedStore?.size).toBe(1);
+        expect(Array.from(savedStore?.values() ?? [])).toEqual(['Button 컴포넌트입니다.']);
+    });
+
+    it('marks all units as degraded with batch_mqm_failed when batch MQM response is invalid', async () => {
+        vi.spyOn(clientModule, 'callLlm').mockResolvedValue({
+            content: 'not-valid-json',
+        });
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+
+        const result = await translateDescriptions([
+            {
+                name: 'Button',
+                displayName: 'Button',
+                description: 'A button component.',
+                props: [],
+            },
+        ]);
+
+        expect(result.componentReports[0]).toMatchObject({
+            verified: 0,
+            unverified: 1,
+        });
+        expect(result.componentReports[0].unverifiedOutcomes[0]).toMatchObject({
+            reason: 'batch_mqm_failed',
+            assurance: 'unverified',
+            reportable: true,
+        });
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('batch failure summary'));
+    });
+
+    it('marks a chunk degraded when batch MQM omits an expected id', async () => {
+        vi.spyOn(clientModule, 'callLlm').mockResolvedValue({
+            content: JSON.stringify({
+                evaluations: [{ id: 'Button:(description)', verdict: 'PASS', errors: [] }],
+            }),
+        });
+        vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+
+        const result = await translateDescriptions(sampleProps.slice(0, 1));
+
+        expect(result.componentReports[0]).toMatchObject({
+            verified: 0,
+            unverified: 2,
+        });
+        expect(result.batchFallbacks[0]).toContain('Missing response id: Button:onClick');
+    });
+
+    it('marks failed units as degraded with batch_postprocess_failed when batch postprocess response is invalid', async () => {
+        let llmCallCount = 0;
+        vi.spyOn(clientModule, 'callLlm').mockImplementation(async () => {
+            llmCallCount++;
+            if (llmCallCount === 1) {
+                // 초기 batch MQM: FAIL
+                return {
+                    content: JSON.stringify({
+                        evaluations: [
+                            {
+                                id: 'Button:(description)',
+                                verdict: 'FAIL',
+                                errors: [
+                                    {
+                                        category: 'Accuracy/Mistranslation',
+                                        severity: 'major',
+                                        source_span: 'A button component.',
+                                        mt_span: 'Button 컴포넌트',
+                                        explanation: '부자연스럽습니다.',
+                                    },
+                                ],
+                            },
+                        ],
+                    }),
+                };
+            }
+            // batch postprocess: invalid JSON
+            return { content: 'not-valid-json' };
+        });
+        vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+
+        const result = await translateDescriptions([
+            {
+                name: 'Button',
+                displayName: 'Button',
+                description: 'A button component.',
+                props: [],
+            },
+        ]);
+
+        expect(result.componentReports[0].unverifiedOutcomes[0]).toMatchObject({
+            reason: 'batch_postprocess_failed',
+            assurance: 'unverified',
+            reportable: true,
+        });
+    });
+
+    it('translates a source shared by two components exactly once', async () => {
+        const sharedSource = 'Click handler callback.';
+        const propsWithSharedSource: TranslatableDoc[] = [
+            {
+                name: 'Button',
+                displayName: 'Button',
+                props: [{ name: 'onClick', description: sharedSource }],
+            },
+            {
+                name: 'IconButton',
+                displayName: 'IconButton',
+                props: [{ name: 'onClick', description: sharedSource }],
+            },
+        ];
+
+        const translateSpy = vi
+            .spyOn(translationModule, 'translateUnits')
+            .mockImplementation(async (units) => {
+                return new Map(
+                    units.map((unit) => [getTranslationUnitKey(unit), '클릭 핸들러 콜백.']),
+                );
+            });
+
+        const result = await translateDescriptions(propsWithSharedSource, '/tmp/cache');
+
+        expect(translateSpy).toHaveBeenCalledOnce();
+        expect(translateSpy.mock.calls[0]?.[0]).toHaveLength(1);
+        expect(result.translations.get('Button:onClick')).toBe('클릭 핸들러 콜백.');
+        expect(result.translations.get('IconButton:onClick')).toBe('클릭 핸들러 콜백.');
+    });
+
+    it('saves the cache once per run, after the MQM phase', async () => {
+        const twoTranslatables: TranslatableDoc[] = [
+            { name: 'A', displayName: 'A', description: 'first', props: [] },
+            { name: 'B', displayName: 'B', description: 'second', props: [] },
+        ];
+        const saveCacheSpy = vi.spyOn(cacheModule, 'saveCache').mockImplementation(() => undefined);
+        vi.spyOn(translationModule, 'translateUnits').mockImplementation(
+            async (units) => new Map(units.map((unit) => [getTranslationUnitKey(unit), '번역'])),
+        );
+
+        await translateDescriptions(twoTranslatables, '/tmp/cache');
+
+        expect(saveCacheSpy).toHaveBeenCalledOnce();
+        expect(saveCacheSpy.mock.calls[0]?.[1].size).toBe(2);
+    });
+
+    it('falls back to English when post-editing cannot restore a dropped code span', async () => {
+        const props: TranslatableDoc[] = [
+            {
+                name: 'Button',
+                displayName: 'Button',
+                description: 'Renders a `<button>` element.',
+                props: [],
+            },
+        ];
+        mockTranslations({ 'Button:(description)': '버튼 요소를 렌더링합니다.' });
+        // MQM은 PASS를 주지만 결정론 체크가 코드 스팬 누락을 잡고, 후편집도 복구하지 못한다.
+        vi.spyOn(clientModule, 'callLlm').mockImplementation(async (messages) => {
+            const content = messages.find((m) => m.role === 'user')?.content ?? '';
+            const parsed = JSON.parse(content) as { units: { id: string }[] };
+            if (content.includes('initialTranslation')) {
+                return {
+                    content: JSON.stringify({
+                        translations: parsed.units.map(({ id }) => ({
+                            id,
+                            translated: '여전히 코드 스팬이 없습니다.',
+                        })),
+                    }),
+                };
+            }
+            return {
+                content: JSON.stringify({
+                    evaluations: parsed.units.map(({ id }) => ({
+                        id,
+                        verdict: 'PASS',
+                        errors: [],
+                    })),
+                }),
+            };
+        });
+        vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+
+        const result = await translateDescriptions(props, '/tmp/cache');
+
+        expect(result.translations.get('Button:(description)')).toBe(
+            'Renders a `<button>` element.',
+        );
+        expect(result.componentReports[0].unverifiedOutcomes[0]).toMatchObject({
+            reason: 'preservation_fallback',
+            assurance: 'unverified',
+            violations: [{ rule: 'backtick_span', expected: '`<button>`' }],
+        });
+    });
+
+    it('falls back to English when a translation batch throws', async () => {
+        vi.spyOn(translationModule, 'translateUnits').mockRejectedValue(new Error('gateway down'));
+        vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+
+        const result = await translateDescriptions(sampleProps.slice(0, 1), '/tmp/cache');
+
+        expect(result.translations.get('Button:(description)')).toBe('A button component.');
+        expect(result.componentReports[0].unverifiedOutcomes).toEqual(
+            expect.arrayContaining([expect.objectContaining({ reason: 'translation_failed' })]),
+        );
+        expect(result.batchFallbacks[0]).toContain('gateway down');
+    });
+});
diff --git a/scripts/translation-pipeline/src/translator.ts b/scripts/translation-pipeline/src/translator.ts
new file mode 100644
index 000000000..f3f565020
--- /dev/null
+++ b/scripts/translation-pipeline/src/translator.ts
@@ -0,0 +1,167 @@
+import { processBatchLifecycle } from '~/batch/lifecycle';
+import { type CacheStore, loadCache, makeCacheKey, saveCache } from '~/cache';
+import {
+    type TranslatableDoc,
+    type TranslationOutcome,
+    type TranslationUnit,
+    getTranslationUnitKey,
+    makeOutcome,
+} from '~/domain';
+import { type ComponentReport, buildComponentReports } from '~/report';
+import { translateUnits } from '~/translate';
+import { chunkArray, errorMessage } from '~/util';
+
+const TRANSLATION_BATCH_SIZE = 20;
+const MQM_BATCH_SIZE = 74;
+const BATCH_CONCURRENCY = 16;
+
+// ─── Translation Units ────────────────────────────────────────────────────────
+
+function collectTranslationUnits(docs: TranslatableDoc[]): TranslationUnit[] {
+    const units: TranslationUnit[] = [];
+
+    for (const component of docs) {
+        const componentDisplayName = component.displayName;
+        if (component.description) {
+            units.push({
+                kind: 'component.description',
+                componentDisplayName,
+                source: component.description,
+            });
+        }
+
+        for (const prop of component.props) {
+            if (prop.description) {
+                units.push({
+                    kind: 'prop.description',
+                    componentDisplayName,
+                    propName: prop.name,
+                    source: prop.description,
+                });
+            }
+        }
+    }
+
+    const seen = new Set<string>();
+    for (const unit of units) {
+        const key = getTranslationUnitKey(unit);
+        if (seen.has(key)) {
+            throw new Error(`Duplicate translation unit key: ${key}`);
+        }
+        seen.add(key);
+    }
+
+    return units;
+}
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function groupBySource(units: TranslationUnit[]): Map<string, TranslationUnit[]> {
+    const groups = new Map<string, TranslationUnit[]>();
+    for (const unit of units) {
+        const current = groups.get(unit.source) ?? [];
+        current.push(unit);
+        groups.set(unit.source, current);
+    }
+    return groups;
+}
+
+async function runInWaves<T>(batches: T[], task: (batch: T) => Promise<void>): Promise<void> {
+    for (const wave of chunkArray(batches, BATCH_CONCURRENCY)) {
+        await Promise.all(wave.map(task));
+    }
+}
+
+// ─── Public API ───────────────────────────────────────────────────────────────
+
+export interface TranslateResult {
+    translations: Map<string, string>;
+    componentReports: ComponentReport[];
+    batchFallbacks: string[];
+}
+
+export async function translateDescriptions(
+    docs: TranslatableDoc[],
+    outputDir?: string,
+): Promise<TranslateResult> {
+    const totalStartedAt = Date.now();
+    const progress = (message: string): void => {
+        console.error(`[i18n] ${message}`);
+    };
+
+    const units = collectTranslationUnits(docs);
+    progress(`starting ${docs.length} component(s) — ${units.length} translatable text(s)`);
+
+    const cacheStore: CacheStore = outputDir ? loadCache(outputDir) : new Map();
+
+    const outcomes = new Map<string, TranslationOutcome>();
+    const batchFallbacks: string[] = [];
+
+    const representatives = [...groupBySource(units).values()].map((group) => group[0]);
+    progress(`deduplicated: ${units.length} text(s) → ${representatives.length} unique source(s)`);
+
+    const missing: TranslationUnit[] = [];
+    for (const representative of representatives) {
+        const cached = cacheStore.get(makeCacheKey(representative.source));
+        if (cached !== undefined) {
+            outcomes.set(representative.source, makeOutcome(cached, 'cache_hit'));
+        } else {
+            missing.push(representative);
+        }
+    }
+    progress(`cache: ${representatives.length - missing.length} hit, ${missing.length} miss`);
+
+    const translations = new Map<string, string>();
+    const translationBatches = chunkArray(missing, TRANSLATION_BATCH_SIZE);
+    progress(`translating ${missing.length} source(s) in ${translationBatches.length} batch(es)`);
+
+    await runInWaves(translationBatches, async (batch) => {
+        try {
+            for (const [key, translated] of await translateUnits(batch)) {
+                translations.set(key, translated);
+            }
+        } catch (error) {
+            batchFallbacks.push(`translation batch failed: ${errorMessage(error)}`);
+            for (const unit of batch) {
+                outcomes.set(unit.source, makeOutcome(unit.source, 'translation_failed'));
+            }
+        }
+    });
+
+    const translatedUnits = missing.filter((unit) => translations.has(getTranslationUnitKey(unit)));
+    const mqmBatches = chunkArray(translatedUnits, MQM_BATCH_SIZE);
+    progress(`evaluating ${translatedUnits.length} source(s) in ${mqmBatches.length} batch(es)`);
+
+    await runInWaves(mqmBatches, async (batch) => {
+        const processed = await processBatchLifecycle(batch, translations);
+        batchFallbacks.push(...processed.batchFailureReasons);
+        for (const [unit, outcome] of processed.outcomes) {
+            outcomes.set(unit.source, outcome);
+            if (outcome.assurance === 'verified') {
+                cacheStore.set(makeCacheKey(unit.source), outcome.translated);
+            }
+        }
+    });
+
+    if (outputDir) {
+        saveCache(outputDir, cacheStore);
+    }
+
+    if (batchFallbacks.length > 0) {
+        console.warn(
+            `[i18n] batch failure summary: ${batchFallbacks.length} chunk(s) degraded. ${batchFallbacks.join('; ')}`,
+        );
+    }
+
+    const componentReports = buildComponentReports(docs, units, outcomes);
+    const finalTranslations = new Map(
+        units.map((unit) => [
+            getTranslationUnitKey(unit),
+            outcomes.get(unit.source)?.translated ?? unit.source,
+        ]),
+    );
+
+    progress(`done: ${docs.length} component(s) in ${Math.max(0, Date.now() - totalStartedAt)}ms`);
+
+    return { translations: finalTranslations, componentReports, batchFallbacks };
+}
diff --git a/scripts/translation-pipeline/src/util.ts b/scripts/translation-pipeline/src/util.ts
new file mode 100644
index 000000000..e2bc81bb2
--- /dev/null
+++ b/scripts/translation-pipeline/src/util.ts
@@ -0,0 +1,11 @@
+export function chunkArray<T>(items: T[], size: number): T[][] {
+    const chunks: T[][] = [];
+    for (let index = 0; index < items.length; index += size) {
+        chunks.push(items.slice(index, index + size));
+    }
+    return chunks;
+}
+
+export function errorMessage(error: unknown): string {
+    return error instanceof Error ? error.message : String(error);
+}
diff --git a/scripts/translation-pipeline/tests/cli.test.ts b/scripts/translation-pipeline/tests/cli.test.ts
new file mode 100644
index 000000000..3fc7624d4
--- /dev/null
+++ b/scripts/translation-pipeline/tests/cli.test.ts
@@ -0,0 +1,311 @@
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import * as clientModule from '~/client';
+import { getTranslationUnitKey } from '~/domain';
+import { run } from '~/run';
+import * as translationModule from '~/translate';
+
+describe('E2E: CLI → translator → 파일 출력', () => {
+    let workDir: string;
+
+    beforeEach(() => {
+        workDir = mkdtempSync(join(tmpdir(), 'e2e-test-'));
+        vi.stubEnv('LITELLM_BASE_URL', 'https://example.test');
+    });
+
+    afterEach(() => {
+        rmSync(workDir, { recursive: true, force: true });
+        vi.unstubAllEnvs();
+        vi.restoreAllMocks();
+    });
+
+    function writeInputFile(inputDir: string): void {
+        mkdirSync(inputDir, { recursive: true });
+        writeFileSync(
+            join(inputDir, 'button.json'),
+            JSON.stringify({
+                name: 'Button',
+                description: 'A clickable button.',
+                props: [
+                    {
+                        name: 'size',
+                        type: ['"sm"', '"md"'],
+                        required: false,
+                        description: 'Size of the button.',
+                    },
+                    { name: 'disabled', type: ['boolean'], required: false },
+                ],
+            }),
+            'utf-8',
+        );
+    }
+
+    it('Happy path: EN JSON → 번역 PASS → ko/ 파일 생성 + 리포트 생성', async () => {
+        const inputDir = join(workDir, 'en');
+        const outputDir = join(workDir, 'out');
+        writeInputFile(inputDir);
+
+        // LLM 호출 직전 모듈만 fixture로 대체
+        vi.spyOn(translationModule, 'translateUnits').mockImplementation(
+            async (units) =>
+                new Map(units.map((unit) => [getTranslationUnitKey(unit), `[ko]${unit.source}`])),
+        );
+        vi.spyOn(clientModule, 'callLlm').mockResolvedValue({
+            content: JSON.stringify({
+                evaluations: [
+                    { id: 'Button:(description)', verdict: 'PASS', errors: [] },
+                    { id: 'Button:size', verdict: 'PASS', errors: [] },
+                ],
+            }),
+        });
+
+        const result = await run(['--input', inputDir, '--output', outputDir]);
+
+        // ko/ 파일 생성 확인
+        expect(result.writtenFiles).toHaveLength(1);
+        const koPath = join(outputDir, 'ko', 'button.json');
+        expect(existsSync(koPath)).toBe(true);
+
+        const koContent = JSON.parse(readFileSync(koPath, 'utf-8')) as {
+            name: string;
+            description: string;
+            props: { name: string; description?: string; type?: string[] }[];
+        };
+
+        // 번역된 내용 확인
+        expect(koContent.name).toBe('Button');
+        expect(koContent.description).toBe('[ko]A clickable button.');
+        expect(koContent.props[0].description).toBe('[ko]Size of the button.');
+        // 번역 대상 아닌 필드는 원본 유지
+        expect(koContent.props[0].type).toEqual(['"sm"', '"md"']);
+        expect(koContent.props[1].description).toBeUndefined();
+
+        // 리포트 파일 생성 확인
+        expect(existsSync(result.reportPath)).toBe(true);
+        const reportContent = readFileSync(result.reportPath, 'utf-8');
+        expect(reportContent).toContain('Translation Quality Report');
+        expect(reportContent).toContain('| Button |');
+
+        // 캐시 파일 생성 확인
+        expect(existsSync(join(outputDir, '.translation-cache.json'))).toBe(true);
+    });
+
+    it('MQM FAIL → 후처리 → PASS: 수정된 번역이 ko/ 파일에 반영됨', async () => {
+        const inputDir = join(workDir, 'en');
+        const outputDir = join(workDir, 'out');
+        writeInputFile(inputDir);
+
+        const mqmError = {
+            category: 'Fluency/Unnatural phrasing' as const,
+            severity: 'minor' as const,
+            source_span: 'Size of the button.',
+            mt_span: '버튼의 크기를 제어합니다.',
+            explanation: '번역투 표현입니다.',
+        };
+
+        // translate: 초기 번역 반환
+        vi.spyOn(translationModule, 'translateUnits').mockImplementation(
+            async (units) =>
+                new Map(
+                    units.map((unit) => [
+                        getTranslationUnitKey(unit),
+                        unit.kind === 'prop.description' && unit.propName === 'size'
+                            ? '버튼의 크기를 제어합니다.'
+                            : `[ko]${unit.source}`,
+                    ]),
+                ),
+        );
+
+        // callLlm 호출 순서: 1) 초기 batch MQM, 2) batch postprocess, 3) 최종 batch MQM
+        let llmCallCount = 0;
+        vi.spyOn(clientModule, 'callLlm').mockImplementation(async () => {
+            llmCallCount++;
+            if (llmCallCount === 1) {
+                return {
+                    content: JSON.stringify({
+                        evaluations: [
+                            { id: 'Button:(description)', verdict: 'PASS', errors: [] },
+                            {
+                                id: 'Button:size',
+                                verdict: 'FAIL',
+                                errors: [mqmError],
+                            },
+                        ],
+                    }),
+                    inputTokens: 0,
+                    outputTokens: 0,
+                    cost: 0,
+                };
+            }
+            if (llmCallCount === 2) {
+                return {
+                    content: JSON.stringify({
+                        translations: [
+                            {
+                                id: 'Button:size',
+                                translated: '버튼의 크기를 지정합니다.',
+                            },
+                        ],
+                    }),
+                    inputTokens: 0,
+                    outputTokens: 0,
+                    cost: 0,
+                };
+            }
+            // 최종 MQM: PASS
+            return {
+                content: JSON.stringify({
+                    evaluations: [
+                        { id: 'Button:size', verdict: 'PASS', errors: [] },
+                    ],
+                }),
+                inputTokens: 0,
+                outputTokens: 0,
+                cost: 0,
+            };
+        });
+
+        const result = await run(['--input', inputDir, '--output', outputDir]);
+
+        const koPath = join(outputDir, 'ko', 'button.json');
+        const koContent = JSON.parse(readFileSync(koPath, 'utf-8')) as {
+            props: { description?: string }[];
+        };
+
+        // 후처리된 번역이 최종 파일에 반영됨
+        expect(koContent.props[0].description).toBe('버튼의 크기를 지정합니다.');
+
+        // 리포트에 검증됨으로 기록 (unverified 없음)
+        const reportContent = readFileSync(result.reportPath, 'utf-8');
+        expect(reportContent).toContain('No reportable unverified translations.');
+    });
+});
+
+/**
+ * 특성화 테스트 — 유닛 식별 방식을 바꿔도 산출물이 같아야 한다.
+ *
+ * mock은 요청에 실린 id를 그대로 echo하므로 키 형식을 모른다. 그래서 식별 방식이
+ * `componentIndex:id`에서 `componentDisplayName:propName`으로 바뀌어도 이 테스트는 통과해야 한다.
+ */
+describe('E2E: 동명 컴포넌트 · 중복 원문', () => {
+    let workDir: string;
+
+    beforeEach(() => {
+        workDir = mkdtempSync(join(tmpdir(), 'e2e-identity-'));
+        vi.stubEnv('LITELLM_BASE_URL', 'https://example.test');
+    });
+
+    afterEach(() => {
+        rmSync(workDir, { recursive: true, force: true });
+        vi.unstubAllEnvs();
+        vi.restoreAllMocks();
+    });
+
+    /** 요청의 id를 그대로 되돌려주는 mock — 키 형식에 의존하지 않는다. */
+    function mockLlmEchoingIds(): void {
+        vi.spyOn(clientModule, 'callLlm').mockImplementation(async (messages, options) => {
+            const request = JSON.parse(messages[1].content) as {
+                units: { id: string; source?: string }[];
+            };
+            if (options.jsonSchema?.name === 'batch_mqm_response') {
+                return {
+                    content: JSON.stringify({
+                        evaluations: request.units.map((unit) => ({
+                            id: unit.id,
+                            verdict: 'PASS',
+                            errors: [],
+                        })),
+                    }),
+                };
+            }
+            // translation_response · batch_postprocess_response 둘 다 translations[]
+            return {
+                content: JSON.stringify({
+                    translations: request.units.map((unit) => ({
+                        id: unit.id,
+                        translated: `[ko]${unit.source ?? ''}`,
+                    })),
+                }),
+            };
+        });
+    }
+
+    function writeIdentityFixture(inputDir: string): void {
+        mkdirSync(inputDir, { recursive: true });
+        const docs: Record<string, unknown> = {
+            // name이 둘 다 'Root' — 이름만으로는 구별되지 않는다
+            'avatar-root.json': {
+                name: 'Root',
+                displayName: 'Avatar.Root',
+                description: 'An avatar root.',
+                props: [
+                    // select-root의 size와 원문이 같다 — 중복 제거 fan-out 경로
+                    {
+                        name: 'size',
+                        type: ['"sm"', '"md"'],
+                        required: false,
+                        description: 'The size.',
+                    },
+                ],
+            },
+            'select-root.json': {
+                name: 'Root',
+                displayName: 'Select.Root',
+                description: 'A select root.',
+                props: [
+                    {
+                        name: 'size',
+                        type: ['"sm"', '"md"'],
+                        required: false,
+                        description: 'The size.',
+                    },
+                    { name: 'disabled', type: ['boolean'], required: false },
+                ],
+            },
+            // displayName이 없는 문서 (실제 입력에 6개 있다) — name이 이미 정규화돼 있다
+            'spinner.json': { name: 'Spinner', description: 'A spinner.', props: [] },
+        };
+        for (const [fileName, content] of Object.entries(docs)) {
+            writeFileSync(join(inputDir, fileName), JSON.stringify(content), 'utf-8');
+        }
+    }
+
+    function readKo(outputDir: string, fileName: string) {
+        return JSON.parse(readFileSync(join(outputDir, 'ko', fileName), 'utf-8')) as {
+            name: string;
+            description?: string;
+            props: { name: string; description?: string; type?: string[] }[];
+        };
+    }
+
+    it('name이 겹치는 두 문서가 서로의 번역을 덮어쓰지 않는다', async () => {
+        const inputDir = join(workDir, 'en');
+        const outputDir = join(workDir, 'out');
+        writeIdentityFixture(inputDir);
+        mockLlmEchoingIds();
+
+        const result = await run(['--input', inputDir, '--output', outputDir]);
+        expect(result.writtenFiles).toHaveLength(3);
+
+        const avatar = readKo(outputDir, 'avatar-root.json');
+        const select = readKo(outputDir, 'select-root.json');
+
+        // 핵심: 두 'Root'의 컴포넌트 설명이 각자의 원문에서 나왔다
+        expect(avatar.description).toBe('[ko]An avatar root.');
+        expect(select.description).toBe('[ko]A select root.');
+
+        // 원문이 같은 prop은 양쪽 모두 채워진다 (중복 제거 후 fan-out)
+        expect(avatar.props[0].description).toBe('[ko]The size.');
+        expect(select.props[0].description).toBe('[ko]The size.');
+
+        // 번역 대상이 아닌 필드는 원본 유지
+        expect(select.props[0].type).toEqual(['"sm"', '"md"']);
+        expect(select.props[1].description).toBeUndefined();
+
+        // displayName이 없는 문서도 처리된다
+        expect(readKo(outputDir, 'spinner.json').description).toBe('[ko]A spinner.');
+    });
+});
diff --git a/scripts/translation-pipeline/tsconfig.json b/scripts/translation-pipeline/tsconfig.json
new file mode 100644
index 000000000..fb9960797
--- /dev/null
+++ b/scripts/translation-pipeline/tsconfig.json
@@ -0,0 +1,29 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "lib": ["ES2022"],
+        "types": ["node", "vitest/globals"],
+        "outDir": "./dist",
+        "baseUrl": ".",
+        "paths": {
+            "~/*": ["./src/*"]
+        },
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "isolatedModules": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noImplicitReturns": true,
+        "noFallthroughCasesInSwitch": true
+    },
+    "include": ["src/**/*", "tests/**/*"],
+    "exclude": ["node_modules", "dist"]
+}
diff --git a/scripts/translation-pipeline/tsup.config.ts b/scripts/translation-pipeline/tsup.config.ts
new file mode 100644
index 000000000..ab77c1ab4
--- /dev/null
+++ b/scripts/translation-pipeline/tsup.config.ts
@@ -0,0 +1,21 @@
+import path from 'node:path';
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+    name: 'CLI',
+    format: ['esm'],
+    sourcemap: true,
+    splitting: false,
+    target: 'node20',
+    esbuildOptions(options) {
+        options.alias = {
+            '~': path.resolve(__dirname, './src'),
+        };
+    },
+    entry: ['src/cli.ts'],
+    dts: false,
+    outDir: 'dist/cli',
+    banner: {
+        js: '#!/usr/bin/env node',
+    },
+});
diff --git a/scripts/translation-pipeline/vitest.config.ts b/scripts/translation-pipeline/vitest.config.ts
new file mode 100644
index 000000000..c27c740df
--- /dev/null
+++ b/scripts/translation-pipeline/vitest.config.ts
@@ -0,0 +1,27 @@
+import path from 'node:path';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+    resolve: {
+        alias: {
+            '~': path.resolve(__dirname, './src'),
+        },
+    },
+    test: {
+        globals: true,
+        environment: 'node',
+        include: ['src/**/*.test.ts', 'tests/**/*.test.ts'],
+        coverage: {
+            provider: 'v8',
+            reporter: ['text', 'json', 'html', 'lcov'],
+            include: ['src/**/*.ts'],
+            exclude: ['src/cli.ts', 'src/run.ts', 'src/input.ts', 'src/output.ts'],
+            thresholds: {
+                lines: 70,
+                branches: 65,
+                functions: 70,
+                statements: 70,
+            },
+        },
+    },
+});
diff --git a/scripts/ts-api-extractor/README.md b/scripts/ts-api-extractor/README.md
index c6808a5e8..af64d9915 100644
--- a/scripts/ts-api-extractor/README.md
+++ b/scripts/ts-api-extractor/README.md
@@ -22,7 +22,7 @@ Run from the monorepo root:
 # Build the extractor package
 pnpm --filter @vapor-ui/ts-api-extractor build
 
-# Run extraction from website (uses apps/website/docs-extractor.config.mjs)
+# Run extraction from website (cwd must be apps/website)
 pnpm --filter website extract
 
 # Extract a specific component only
@@ -39,56 +39,28 @@ pnpm --filter @vapor-ui/ts-api-extractor test:run
 
 ## CLI Reference
 
-| Option        | Short | Description                                  |
-| ------------- | ----- | -------------------------------------------- |
-| `--component` | `-n`  | Extract a specific component file only       |
-| `--all`       | `-a`  | Bypass all filters (external/html/sprinkles) |
-| `--verbose`   | `-v`  | Enable verbose logging                       |
-| `--config`    | -     | Specify a config file path                   |
-| `--no-config` | -     | Disable config file loading                  |
+| Option        | Short | Description                            |
+| ------------- | ----- | -------------------------------------- |
+| `--component` | `-n`  | Extract a specific component file only |
 
 ## Configuration
 
-### Config File Names
-
-The CLI searches for these filenames (in order):
-
-- `docs-extractor.config.mjs`
-- `docs-extractor.config.js`
-- `docs-extractor.config.cjs`
-- `docs-extractor.config.ts`
-
-> Note: The package directory was renamed to `ts-api-extractor`, but config filenames remain `docs-extractor.config.*` for backward compatibility.
-
-### Config Priority
-
-1. CLI flags (highest)
-2. File specified via `--config`
-3. Default config file in current working directory
-4. `src/config/defaults.ts` (lowest)
-
-### Config Schema
+Configuration lives in `src/config/defaults.ts` and is edited in place — there is no
+config file loading. Relative paths resolve against `process.cwd()`, which is
+`apps/website` when invoked as `pnpm --filter website extract`.
 
 ```ts
-import { defineConfig } from '@vapor-ui/ts-api-extractor';
-
-export default defineConfig({
+export const extractorConfig: ExtractorConfig = {
     inputPath: '../../packages/core',
     tsconfig: '../../packages/core/tsconfig.json',
     exclude: [],
     excludeDefaults: true,
-    outputDir: './public/components/generated',
-    languages: ['en'],
+    outputDir: '../../apps/website/public/components/generated',
     filterExternal: true,
     filterHtml: true,
     filterSprinkles: true,
     includeHtml: ['className'],
-    components: {
-        'button/button.tsx': {
-            include: ['data-testid'],
-        },
-    },
-});
+};
 ```
 
 ## Output Schema
@@ -98,7 +70,6 @@ Each component generates a JSON file (`<kebab-case>.json`):
 ```json
 {
     "name": "Button",
-    "displayName": "Button",
     "description": "...",
     "props": [
         {
@@ -117,7 +88,8 @@ Each component generates a JSON file (`<kebab-case>.json`):
 Components are recognized based on this pattern:
 
 - File contains `export namespace <ComponentName>`
-- Namespace contains `export interface Props`
+- Namespace contains `export type Props` — a `type` alias, not an `interface`.
+  An exported `interface Props` is skipped with a `[docs-extractor] Skipped` warning.
 
 Files not matching this pattern are excluded from extraction.
 
@@ -146,19 +118,17 @@ Props are filtered based on configuration:
 | `filterExternal`  | Excludes external types (React/DOM/node_modules) |
 | `filterHtml`      | Excludes HTML attributes (`data-*`, `aria-*`)    |
 | `filterSprinkles` | Excludes sprinkles/deprecated CSS props          |
-| `include`         | Overrides filters for specific props             |
 | `includeHtml`     | Overrides HTML filter for specific attributes    |
 
 ## Extraction Pipeline
 
-1. Parse CLI flags (`--component`, `--all`, `--config`, `--no-config`, `--verbose`)
-2. Load and merge config (defaults + file config + flags)
-3. Scan target component files
-4. Initialize a ts-morph project from the configured `tsconfig`
-5. Parse exported namespaces and `Props` declarations (`interface` or `type`)
-6. Resolve types, extract defaults, and filter props
-7. Transform parsed props into sorted component models
-8. Serialize models to JSON files and format them with Prettier
+1. Parse the `--component` flag
+2. Scan target component files
+3. Initialize a ts-morph project from the configured `tsconfig`
+4. Parse exported namespaces and their `Props` type aliases
+5. Resolve types, extract defaults, and filter props
+6. Transform parsed props into sorted component models
+7. Serialize models to JSON files and format them with Prettier
 
 ## Architecture
 
@@ -167,19 +137,15 @@ The package is organized around pipeline stages and pure transformation modules:
 ```text
 scripts/ts-api-extractor/
 ├── src/
-│   ├── cli/                 # meow CLI entrypoint + option resolution
-│   ├── config/              # config schema, defaults, loader
-│   ├── models/              # parsed/model/json/extract types
-│   ├── resolve/             # guard-clause type resolver + base-ui mapper
-│   ├── rules/               # categorize, sort, normalize
-│   ├── extract.ts           # orchestrator (project init, IO, prettier)
-│   ├── extract-defaults.ts  # destructuring + recipe default extraction
-│   ├── filter.ts            # prop inclusion rules
-│   ├── parse.ts             # namespace/props parsing
-│   ├── scan.ts              # component file discovery
-│   ├── transform.ts         # parsed -> model -> json
-│   └── write.ts             # serialization + output planning
-└── dist/
+│   ├── cli/         # meow CLI entrypoint + option resolution
+│   ├── config/      # config schema + values
+│   ├── models/      # pipeline and output types
+│   ├── resolve/     # guard-clause type resolver + base-ui mapper
+│   ├── rules/       # categorize, sort, normalize
+│   ├── stages/      # scan → parse → filter → transform → serialize → write
+│   ├── utils/       # cleaner, declaration source, defaults, filename
+│   └── extract.ts   # orchestrator (project init, stage wiring)
+└── dist/cli/
 ```
 
 ## Quality Standards
@@ -195,8 +161,7 @@ scripts/ts-api-extractor/
 
 ### `Path does not exist`
 
-- Verify `inputPath` is correct relative to current working directory
-- Check for typos in `--config` path
+- Verify `inputPath` in `src/config/defaults.ts` is correct relative to the current working directory
 
 ### `No .tsx files found`
 
@@ -211,12 +176,6 @@ scripts/ts-api-extractor/
 
 - Run `pnpm install` after directory renames or workspace changes
 
-## Future Extensions
-
-- External plugin injection for Resolver/Filter/Defaults
-- Additional output formats (MD, YAML)
-- Multi-config/profile support in CLI
-
 ## License
 
 Internal use only.
diff --git a/scripts/ts-api-extractor/package.json b/scripts/ts-api-extractor/package.json
index d18ab9d08..dfd9aac24 100644
--- a/scripts/ts-api-extractor/package.json
+++ b/scripts/ts-api-extractor/package.json
@@ -4,13 +4,6 @@
     "private": true,
     "description": "TypeScript AST-based API extractor for documentation generation",
     "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
     "bin": {
         "ts-api-extractor": "./dist/cli/index.js"
@@ -38,7 +31,7 @@
         "@vitest/coverage-v8": "catalog:",
         "eslint": "^9.39.5",
         "tsup": "^8.5.1",
-        "tsx": "^4.21.0",
+        "tsx": "^4.23.1",
         "typescript": "catalog:",
         "vitest": "catalog:"
     },
diff --git a/scripts/ts-api-extractor/src/cli/index.ts b/scripts/ts-api-extractor/src/cli/index.ts
index 6a9dfe5b7..2f6d560bb 100644
--- a/scripts/ts-api-extractor/src/cli/index.ts
+++ b/scripts/ts-api-extractor/src/cli/index.ts
@@ -11,26 +11,20 @@ async function runCli(): Promise<void> {
 
   Options
     --component, -n   Component name to process (default: all components)
-    --config          Config file path
 
   Examples
     $ ts-api-extractor
     $ ts-api-extractor --component Tabs
-    $ ts-api-extractor --config ./docs-extractor.config.mjs
 `,
         {
             importMeta: import.meta,
             flags: {
                 component: { type: 'string', shortFlag: 'n' },
-                config: { type: 'string' },
             },
         },
     );
 
-    const resolved = await resolveOptions({
-        component: cli.flags.component,
-        configPath: cli.flags.config,
-    });
+    const resolved = await resolveOptions({ component: cli.flags.component });
 
     extract({
         tsconfigPath: resolved.tsconfigPath,
diff --git a/scripts/ts-api-extractor/src/cli/options.ts b/scripts/ts-api-extractor/src/cli/options.ts
index 50c962a4c..72c8d8930 100644
--- a/scripts/ts-api-extractor/src/cli/options.ts
+++ b/scripts/ts-api-extractor/src/cli/options.ts
@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
-import { loadExtractorConfig } from '~/config/loader';
+import { extractorConfig } from '~/config/defaults';
 import type { ExtractorConfig } from '~/config/schema';
 import { findComponentFiles, findFileByComponentName } from '~/stages/scan';
 
@@ -58,25 +58,13 @@ async function resolveTargetFiles(
 }
 
 export async function resolveOptions({
-    configPath,
     component,
 }: {
     component?: string;
-    configPath?: string;
 }): Promise<ResolvedCliOptions> {
-    const loadedConfig = await loadExtractorConfig({
-        configPath: configPath,
-    });
-
-    const absolutePath = resolvePath(loadedConfig);
-
-    const cwd = process.cwd();
-    const tsconfigPath = path.resolve(cwd, loadedConfig.tsconfig);
-    const targetFiles = await resolveTargetFiles(absolutePath, component, loadedConfig);
+    const absolutePath = resolvePath(extractorConfig);
+    const tsconfigPath = path.resolve(process.cwd(), extractorConfig.tsconfig);
+    const targetFiles = await resolveTargetFiles(absolutePath, component, extractorConfig);
 
-    return {
-        tsconfigPath,
-        targetFiles,
-        config: loadedConfig,
-    };
+    return { tsconfigPath, targetFiles, config: extractorConfig };
 }
diff --git a/scripts/ts-api-extractor/src/config/defaults.ts b/scripts/ts-api-extractor/src/config/defaults.ts
index 9c58342fc..d90e824df 100644
--- a/scripts/ts-api-extractor/src/config/defaults.ts
+++ b/scripts/ts-api-extractor/src/config/defaults.ts
@@ -1,14 +1,13 @@
 import type { ExtractorConfig } from '~/config/schema';
 
 /**
- * Default extractor configuration.
+ * Extractor configuration.
  *
- * NOTE: Relative paths (inputPath, tsconfig, outputDir) are resolved against
- * `process.cwd()` at runtime. This configuration assumes the tool is invoked
- * from the repository root. For other invocation contexts, provide an explicit
- * config file (e.g. docs-extractor.config.mjs) with paths relative to that file.
+ * Relative paths (inputPath, tsconfig, outputDir) are resolved against
+ * `process.cwd()`, which is `apps/website` — that is how
+ * `pnpm --filter website extract` invokes the CLI.
  */
-export const defaultExtractorConfig: ExtractorConfig = {
+export const extractorConfig: ExtractorConfig = {
     inputPath: '../../packages/core',
     tsconfig: '../../packages/core/tsconfig.json',
     exclude: [],
@@ -18,7 +17,4 @@ export const defaultExtractorConfig: ExtractorConfig = {
     filterHtml: true,
     filterSprinkles: true,
     includeHtml: ['className'],
-    components: {},
-    all: false,
-    verbose: false,
 };
diff --git a/scripts/ts-api-extractor/src/config/define-config.ts b/scripts/ts-api-extractor/src/config/define-config.ts
deleted file mode 100644
index 7fecf39f2..000000000
--- a/scripts/ts-api-extractor/src/config/define-config.ts
+++ /dev/null
@@ -1,5 +0,0 @@
-import type { PartialExtractorConfig } from '~/config/schema';
-
-export function defineConfig(config: PartialExtractorConfig): PartialExtractorConfig {
-    return config;
-}
diff --git a/scripts/ts-api-extractor/src/config/loader.ts b/scripts/ts-api-extractor/src/config/loader.ts
deleted file mode 100644
index 5ba1d591e..000000000
--- a/scripts/ts-api-extractor/src/config/loader.ts
+++ /dev/null
@@ -1,76 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { pathToFileURL } from 'node:url';
-
-import { defaultExtractorConfig } from '~/config/defaults';
-import type { ExtractorConfig, PartialExtractorConfig } from '~/config/schema';
-import { mergeConfig, validatePartialConfig } from '~/config/schema';
-
-/**
- * Config file search order. `.ts` is included for convenience but requires
- * Node.js v22.6.0+ (native TypeScript type-stripping). On Node 20.x–22.5.x,
- * use `.mjs`, `.js`, or `.cjs` config files instead.
- */
-const DEFAULT_CONFIG_FILES = [
-    'docs-extractor.config.mjs',
-    'docs-extractor.config.js',
-    'docs-extractor.config.cjs',
-    'docs-extractor.config.ts',
-] as const;
-
-export interface LoadConfigOptions {
-    cwd?: string;
-    configPath?: string;
-    noConfig?: boolean;
-}
-
-function resolveConfigFilePath(options: LoadConfigOptions): string | null {
-    const cwd = options.cwd ?? process.cwd();
-
-    if (options.noConfig) return null;
-
-    if (options.configPath) {
-        const absolute = path.resolve(cwd, options.configPath);
-        if (!fs.existsSync(absolute)) {
-            throw new Error(`Config file not found: ${absolute}`);
-        }
-        return absolute;
-    }
-
-    for (const fileName of DEFAULT_CONFIG_FILES) {
-        const absolute = path.resolve(cwd, fileName);
-        if (fs.existsSync(absolute)) {
-            return absolute;
-        }
-    }
-
-    return null;
-}
-
-async function loadConfigModule(filePath: string): Promise<PartialExtractorConfig> {
-    const fileUrl = pathToFileURL(filePath).href;
-    const loaded = await import(fileUrl);
-    // Supports: export default config, export { config }, or direct module exports
-    const value = loaded.default ?? loaded.config ?? loaded;
-
-    if (typeof value !== 'object' || value === null) {
-        throw new Error(`Invalid config export in ${filePath}: expected object`);
-    }
-
-    return value as PartialExtractorConfig;
-}
-
-export async function loadExtractorConfig(
-    options: LoadConfigOptions = {},
-): Promise<ExtractorConfig> {
-    const configFilePath = resolveConfigFilePath(options);
-
-    if (!configFilePath) {
-        return structuredClone(defaultExtractorConfig);
-    }
-
-    const partial = await loadConfigModule(configFilePath);
-    validatePartialConfig(partial);
-
-    return mergeConfig(defaultExtractorConfig, partial);
-}
diff --git a/scripts/ts-api-extractor/src/config/resolve.ts b/scripts/ts-api-extractor/src/config/resolve.ts
deleted file mode 100644
index 42c46670a..000000000
--- a/scripts/ts-api-extractor/src/config/resolve.ts
+++ /dev/null
@@ -1,20 +0,0 @@
-import { defaultExtractorConfig } from '~/config/defaults';
-import type { ExtractorConfig } from '~/config/schema';
-
-function pathMatchesPattern(filePath: string, pattern: string): boolean {
-    const normalizedFile = filePath.replace(/\\/g, '/');
-    const normalizedPattern = pattern.replace(/\\/g, '/');
-    return normalizedFile === normalizedPattern || normalizedFile.endsWith('/' + normalizedPattern);
-}
-
-export function resolveComponentInclude(
-    filePath: string,
-    config: ExtractorConfig = defaultExtractorConfig,
-): string[] | undefined {
-    for (const [pattern, componentConfig] of Object.entries(config.components)) {
-        if (pathMatchesPattern(filePath, pattern) && componentConfig.include?.length) {
-            return componentConfig.include;
-        }
-    }
-    return undefined;
-}
diff --git a/scripts/ts-api-extractor/src/config/schema.ts b/scripts/ts-api-extractor/src/config/schema.ts
index d638804be..8104f675a 100644
--- a/scripts/ts-api-extractor/src/config/schema.ts
+++ b/scripts/ts-api-extractor/src/config/schema.ts
@@ -1,7 +1,3 @@
-export interface ComponentExtractConfig {
-    include?: string[];
-}
-
 export interface ExtractorConfig {
     inputPath: string;
     tsconfig: string;
@@ -12,81 +8,4 @@ export interface ExtractorConfig {
     filterHtml: boolean;
     filterSprinkles: boolean;
     includeHtml?: string[];
-    components: Record<string, ComponentExtractConfig>;
-    all: boolean;
-    verbose: boolean;
-}
-
-export type PartialExtractorConfig = Partial<
-    Omit<ExtractorConfig, 'components'> & {
-        components: Record<string, ComponentExtractConfig>;
-    }
->;
-
-function assertStringArray(name: string, value: unknown): asserts value is string[] {
-    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string')) {
-        throw new Error(`Invalid ${name}: expected string[]`);
-    }
-}
-
-export function validatePartialConfig(config: PartialExtractorConfig): void {
-    if (config.inputPath !== undefined && typeof config.inputPath !== 'string') {
-        throw new Error('Invalid inputPath: expected string');
-    }
-    if (config.tsconfig !== undefined && typeof config.tsconfig !== 'string') {
-        throw new Error('Invalid tsconfig: expected string');
-    }
-    if (config.outputDir !== undefined && typeof config.outputDir !== 'string') {
-        throw new Error('Invalid outputDir: expected string');
-    }
-    if (config.exclude !== undefined) assertStringArray('exclude', config.exclude);
-    if (config.includeHtml !== undefined) assertStringArray('includeHtml', config.includeHtml);
-
-    if (config.excludeDefaults !== undefined && typeof config.excludeDefaults !== 'boolean') {
-        throw new Error('Invalid excludeDefaults: expected boolean');
-    }
-    if (config.filterExternal !== undefined && typeof config.filterExternal !== 'boolean') {
-        throw new Error('Invalid filterExternal: expected boolean');
-    }
-    if (config.filterHtml !== undefined && typeof config.filterHtml !== 'boolean') {
-        throw new Error('Invalid filterHtml: expected boolean');
-    }
-    if (config.filterSprinkles !== undefined && typeof config.filterSprinkles !== 'boolean') {
-        throw new Error('Invalid filterSprinkles: expected boolean');
-    }
-    if (config.all !== undefined && typeof config.all !== 'boolean') {
-        throw new Error('Invalid all: expected boolean');
-    }
-    if (config.verbose !== undefined && typeof config.verbose !== 'boolean') {
-        throw new Error('Invalid verbose: expected boolean');
-    }
-
-    if (config.components !== undefined) {
-        if (typeof config.components !== 'object' || config.components === null) {
-            throw new Error('Invalid components: expected object');
-        }
-
-        for (const [key, value] of Object.entries(config.components)) {
-            if (typeof key !== 'string' || typeof value !== 'object' || value === null) {
-                throw new Error('Invalid components entry');
-            }
-
-            if (value.include !== undefined) {
-                assertStringArray(`components[${key}].include`, value.include);
-            }
-        }
-    }
-}
-
-export function mergeConfig(base: ExtractorConfig, patch: PartialExtractorConfig): ExtractorConfig {
-    return {
-        ...base,
-        ...patch,
-        exclude: patch.exclude ?? base.exclude,
-        includeHtml: patch.includeHtml ?? base.includeHtml,
-        components: {
-            ...base.components,
-            ...(patch.components ?? {}),
-        },
-    };
 }
diff --git a/scripts/ts-api-extractor/src/extract.ts b/scripts/ts-api-extractor/src/extract.ts
index 7ce5053c3..96671def5 100644
--- a/scripts/ts-api-extractor/src/extract.ts
+++ b/scripts/ts-api-extractor/src/extract.ts
@@ -1,9 +1,8 @@
 import path from 'node:path';
 import { Project } from 'ts-morph';
 
-import { resolveComponentInclude } from '~/config/resolve';
-import type { FilterConfig, ParseConfig } from '~/models/config';
-import type { ExtractInput, ExtractOutput } from '~/models/output';
+import type { FilterConfig } from '~/models/config';
+import type { ExtractInput } from '~/models/output';
 import { filterParsedComponents } from '~/stages/filter';
 import { parseSourceFile } from '~/stages/parse';
 import { componentsToJson } from '~/stages/serialize';
@@ -11,13 +10,20 @@ import { parsedComponentsToModels } from '~/stages/transform';
 import { writePropsFiles } from '~/stages/write';
 import { formatFileName } from '~/utils/filename';
 
-export function extract(input: ExtractInput): ExtractOutput {
+export function extract(input: ExtractInput): string[] {
     const { config } = input;
     const outputDir = path.resolve(process.cwd(), config.outputDir);
     const project = new Project({ tsConfigFilePath: input.tsconfigPath });
 
     console.error('Parsing components...');
 
+    const filterConfig: FilterConfig = {
+        filterExternal: config.filterExternal,
+        filterHtml: config.filterHtml,
+        filterSprinkles: config.filterSprinkles,
+        includeHtml: config.includeHtml,
+    };
+
     const parsed = input.targetFiles.flatMap((filePath) => {
         const componentName = path.basename(filePath, path.extname(filePath));
         const sourceFile = project.addSourceFileAtPathIfExists(filePath);
@@ -31,19 +37,7 @@ export function extract(input: ExtractInput): ExtractOutput {
 
         try {
             console.error(`Processing ${componentName}`);
-            const parseConfig: ParseConfig = {
-                verbose: config.verbose,
-            };
-            const filterConfig: FilterConfig = {
-                filterExternal: config.all ? false : config.filterExternal,
-                filterHtml: config.all ? false : config.filterHtml,
-                filterSprinkles: config.all ? false : config.filterSprinkles,
-                includeHtml: config.includeHtml,
-                include: resolveComponentInclude(filePath, config),
-            };
-
-            const parsedComponents = parseSourceFile(sourceFile, parseConfig);
-            return filterParsedComponents(parsedComponents, filterConfig);
+            return filterParsedComponents(parseSourceFile(sourceFile), filterConfig);
         } catch (error) {
             const message = error instanceof Error ? error.message : String(error);
             console.warn(
@@ -53,17 +47,9 @@ export function extract(input: ExtractInput): ExtractOutput {
         }
     });
 
-    const models = parsedComponentsToModels(parsed);
-    const props = componentsToJson(models);
+    const props = componentsToJson(parsedComponentsToModels(parsed));
 
     console.error(`Done! Extracted ${props.length} components.`);
 
-    const writtenFiles = writePropsFiles(props, outputDir, (prop) => formatFileName(prop.name));
-
-    return {
-        parsed,
-        models,
-        props,
-        writtenFiles,
-    };
+    return writePropsFiles(props, path.join(outputDir, 'en'), (prop) => formatFileName(prop.name));
 }
diff --git a/scripts/ts-api-extractor/src/index.ts b/scripts/ts-api-extractor/src/index.ts
deleted file mode 100644
index 52912b12c..000000000
--- a/scripts/ts-api-extractor/src/index.ts
+++ /dev/null
@@ -1,10 +0,0 @@
-/**
- * @vapor-ui/ts-api-extractor
- *
- * TypeScript AST-based API extractor for documentation generation.
- */
-
-export { defaultExtractorConfig as config } from '~/config/defaults';
-export { defineConfig } from '~/config/define-config';
-export { loadExtractorConfig, type LoadConfigOptions } from '~/config/loader';
-export type { ExtractorConfig } from '~/config/schema';
diff --git a/scripts/ts-api-extractor/src/models/config.ts b/scripts/ts-api-extractor/src/models/config.ts
index e506bb1ba..18a73a164 100644
--- a/scripts/ts-api-extractor/src/models/config.ts
+++ b/scripts/ts-api-extractor/src/models/config.ts
@@ -1,17 +1,7 @@
-// ──────────────────────────────────────────────────────────────
-// Pipeline stage configs
-// ──────────────────────────────────────────────────────────────
-
-// parse 단계 전용
-export interface ParseConfig {
-    verbose?: boolean;
-}
-
 // filter 단계 전용
 export interface FilterConfig {
     filterExternal: boolean;
     filterHtml: boolean;
     filterSprinkles: boolean;
     includeHtml?: string[];
-    include?: string[];
 }
diff --git a/scripts/ts-api-extractor/src/models/output.ts b/scripts/ts-api-extractor/src/models/output.ts
index bd6fdb753..764cdc76c 100644
--- a/scripts/ts-api-extractor/src/models/output.ts
+++ b/scripts/ts-api-extractor/src/models/output.ts
@@ -1,5 +1,4 @@
 import type { ExtractorConfig } from '~/config/schema';
-import type { ComponentModel, ParsedComponent } from '~/models/pipeline';
 
 // ──────────────────────────────────────────────────────────────
 // JSON output format
@@ -28,10 +27,3 @@ export interface ExtractInput {
     targetFiles: string[];
     config: ExtractorConfig;
 }
-
-export interface ExtractOutput {
-    parsed: ParsedComponent[];
-    models: ComponentModel[];
-    props: PropsInfoJson[];
-    writtenFiles: string[];
-}
diff --git a/scripts/ts-api-extractor/src/resolve/function-type.ts b/scripts/ts-api-extractor/src/resolve/function-type.ts
index e1989bdb3..7733f2122 100644
--- a/scripts/ts-api-extractor/src/resolve/function-type.ts
+++ b/scripts/ts-api-extractor/src/resolve/function-type.ts
@@ -39,25 +39,14 @@ export function resolveFunctionType(type: Type, ctx: ResolverContext): string {
             }
 
             const paramType = param.getTypeAtLocation(decl);
-            return `${paramName}: ${ctx.resolveType(paramType, ctx.baseUiMap, ctx.contextNode, ctx.verbose)}`;
+            return `${paramName}: ${ctx.resolveType(paramType, ctx.baseUiMap, ctx.contextNode)}`;
         }
 
         const paramType = param.getTypeAtLocation(node);
-        const resolvedParamType = ctx.resolveType(
-            paramType,
-            ctx.baseUiMap,
-            ctx.contextNode,
-            ctx.verbose,
-        );
-        return `${paramName}: ${resolvedParamType}`;
+        return `${paramName}: ${ctx.resolveType(paramType, ctx.baseUiMap, ctx.contextNode)}`;
     });
 
-    const resolvedReturnType = ctx.resolveType(
-        returnType,
-        ctx.baseUiMap,
-        ctx.contextNode,
-        ctx.verbose,
-    );
+    const resolvedReturnType = ctx.resolveType(returnType, ctx.baseUiMap, ctx.contextNode);
     const wrappedReturn = resolvedReturnType.includes(' | ')
         ? `(${resolvedReturnType})`
         : resolvedReturnType;
diff --git a/scripts/ts-api-extractor/src/resolve/index.ts b/scripts/ts-api-extractor/src/resolve/index.ts
index ab8555819..13f6b0d15 100644
--- a/scripts/ts-api-extractor/src/resolve/index.ts
+++ b/scripts/ts-api-extractor/src/resolve/index.ts
@@ -1,6 +1 @@
 export { resolveType } from './resolve-type';
-export {
-    simplifyForwardRefType,
-    simplifyNodeModulesImports,
-    simplifyReactElementGeneric,
-} from './shared';
diff --git a/scripts/ts-api-extractor/src/resolve/resolve-type.ts b/scripts/ts-api-extractor/src/resolve/resolve-type.ts
index b28ee93dc..cd24c8683 100644
--- a/scripts/ts-api-extractor/src/resolve/resolve-type.ts
+++ b/scripts/ts-api-extractor/src/resolve/resolve-type.ts
@@ -16,61 +16,18 @@ import {
 } from '~/resolve/shared';
 import { isUnionWithFunction, resolveUnionWithFunction } from '~/resolve/union';
 
-function logResolution(rawText: string, label: string, verbose?: boolean) {
-    if (verbose) {
-        console.error(`[verbose] resolveType: "${rawText}" -> ${label}`);
-    }
-}
-
-export function resolveType(
-    type: Type,
-    baseUiMap?: BaseUiTypeMap,
-    contextNode?: Node,
-    verbose?: boolean,
-): string {
+export function resolveType(type: Type, baseUiMap?: BaseUiTypeMap, contextNode?: Node): string {
     const rawText = contextNode ? type.getText(contextNode, TYPE_FORMAT_FLAGS) : type.getText();
-    const ctx: ResolverContext = { type, rawText, baseUiMap, contextNode, verbose, resolveType };
-
-    if (isRefType(rawText)) {
-        logResolution(rawText, 'ref-type', verbose);
-        return resolveRefType(rawText);
-    }
-
-    if (isReactAlias(type)) {
-        logResolution(rawText, 'react-alias', verbose);
-        return resolveReactAlias(type);
-    }
-
-    if (isPrimitive(type)) {
-        logResolution(rawText, 'primitive', verbose);
-        return resolvePrimitive(type);
-    }
-
-    if (isReactElement(type)) {
-        logResolution(rawText, 'react-element', verbose);
-        return resolveReactElement(type);
-    }
-
-    if (isFunctionType(type)) {
-        logResolution(rawText, 'function-type', verbose);
-        return resolveFunctionType(type, ctx);
-    }
-
-    if (isUnionWithFunction(type)) {
-        logResolution(rawText, 'union-with-function', verbose);
-        return resolveUnionWithFunction(type, ctx);
-    }
-
-    if (isBaseUiType(type, baseUiMap)) {
-        logResolution(rawText, 'base-ui-type', verbose);
-        return resolveMappedBaseUiType(type, baseUiMap!) ?? rawText;
-    }
+    const ctx: ResolverContext = { type, rawText, baseUiMap, contextNode, resolveType };
 
-    if (isImportedType(rawText)) {
-        logResolution(rawText, 'imported-type', verbose);
-        return resolveImportedType(rawText);
-    }
+    if (isRefType(rawText)) return resolveRefType(rawText);
+    if (isReactAlias(type)) return resolveReactAlias(type);
+    if (isPrimitive(type)) return resolvePrimitive(type);
+    if (isReactElement(type)) return resolveReactElement(type);
+    if (isFunctionType(type)) return resolveFunctionType(type, ctx);
+    if (isUnionWithFunction(type)) return resolveUnionWithFunction(type, ctx);
+    if (isBaseUiType(type, baseUiMap)) return resolveMappedBaseUiType(type, baseUiMap!) ?? rawText;
+    if (isImportedType(rawText)) return resolveImportedType(rawText);
 
-    logResolution(rawText, 'fallback', verbose);
     return simplifyReactElementGeneric(simplifyForwardRefType(rawText));
 }
diff --git a/scripts/ts-api-extractor/src/resolve/shared.ts b/scripts/ts-api-extractor/src/resolve/shared.ts
index 0e7af53e7..eaafd5c7f 100644
--- a/scripts/ts-api-extractor/src/resolve/shared.ts
+++ b/scripts/ts-api-extractor/src/resolve/shared.ts
@@ -7,19 +7,13 @@ export const TYPE_FORMAT_FLAGS =
     TypeFormatFlags.NoTruncation |
     TypeFormatFlags.WriteTypeArgumentsOfSignature;
 
-export type ResolveTypeFn = (
-    type: Type,
-    baseUiMap?: BaseUiTypeMap,
-    contextNode?: Node,
-    verbose?: boolean,
-) => string;
+export type ResolveTypeFn = (type: Type, baseUiMap?: BaseUiTypeMap, contextNode?: Node) => string;
 
 export interface ResolverContext {
     type: Type;
     rawText: string;
     baseUiMap?: BaseUiTypeMap;
     contextNode?: Node;
-    verbose?: boolean;
     resolveType: ResolveTypeFn;
 }
 
diff --git a/scripts/ts-api-extractor/src/resolve/union.ts b/scripts/ts-api-extractor/src/resolve/union.ts
index 090aa0a9b..6c08ab145 100644
--- a/scripts/ts-api-extractor/src/resolve/union.ts
+++ b/scripts/ts-api-extractor/src/resolve/union.ts
@@ -13,7 +13,7 @@ export function resolveUnionWithFunction(type: Type, ctx: ResolverContext): stri
     return type
         .getUnionTypes()
         .map((member) => {
-            const resolved = ctx.resolveType(member, ctx.baseUiMap, ctx.contextNode, ctx.verbose);
+            const resolved = ctx.resolveType(member, ctx.baseUiMap, ctx.contextNode);
             return member.getCallSignatures().length > 0 ? `(${resolved})` : resolved;
         })
         .join(' | ');
diff --git a/scripts/ts-api-extractor/src/rules/categorize-prop.ts b/scripts/ts-api-extractor/src/rules/categorize-prop.ts
index 2f1701cf7..acb8212a4 100644
--- a/scripts/ts-api-extractor/src/rules/categorize-prop.ts
+++ b/scripts/ts-api-extractor/src/rules/categorize-prop.ts
@@ -20,19 +20,11 @@ export const STATE_PROP_PATTERNS = [
 
 export const COMPOSITION_PROPS = new Set(['asChild', 'render']);
 
-function isStateProp(name: string): boolean {
-    return STATE_PROP_PATTERNS.some((pattern) => pattern.test(name));
-}
-
-function isCompositionProp(name: string): boolean {
-    return COMPOSITION_PROPS.has(name);
-}
-
 export function categorizeProp(name: string, required: boolean, source: PropSource): PropCategory {
     if (required) return 'required';
-    if (isCompositionProp(name)) return 'composition';
+    if (COMPOSITION_PROPS.has(name)) return 'composition';
     if (source === 'variants') return 'variants';
-    if (isStateProp(name)) return 'state';
+    if (STATE_PROP_PATTERNS.some((pattern) => pattern.test(name))) return 'state';
     if (source === 'base-ui') return 'base-ui';
     return 'custom';
 }
diff --git a/scripts/ts-api-extractor/src/stages/filter.ts b/scripts/ts-api-extractor/src/stages/filter.ts
index c4258ccb1..7f96e2442 100644
--- a/scripts/ts-api-extractor/src/stages/filter.ts
+++ b/scripts/ts-api-extractor/src/stages/filter.ts
@@ -58,10 +58,8 @@ export function shouldIncludeProp(
     name: string,
     source: PropSource,
     options: FilterConfig,
-    includeSet: Set<string>,
     htmlWhitelist: Set<string>,
 ): boolean {
-    if (includeSet.has(name)) return true;
     if (htmlWhitelist.has(name)) return true;
     if (options.filterExternal && (source === 'react' || source === 'dom' || source === 'external'))
         return false;
@@ -75,12 +73,11 @@ export function filterParsedComponents(
     components: ParsedComponent[],
     options: FilterConfig,
 ): ParsedComponent[] {
-    const includeSet = new Set(options.include ?? []);
     const htmlWhitelist = new Set(options.includeHtml ?? []);
     return components.map((component) => ({
         ...component,
         props: component.props.filter((prop) =>
-            shouldIncludeProp(prop.name, prop.source, options, includeSet, htmlWhitelist),
+            shouldIncludeProp(prop.name, prop.source, options, htmlWhitelist),
         ),
     }));
 }
diff --git a/scripts/ts-api-extractor/src/stages/parse.ts b/scripts/ts-api-extractor/src/stages/parse.ts
index 03301a492..7c4835ef1 100644
--- a/scripts/ts-api-extractor/src/stages/parse.ts
+++ b/scripts/ts-api-extractor/src/stages/parse.ts
@@ -7,7 +7,6 @@ import type {
 } from 'ts-morph';
 import { ModuleDeclarationKind, ts } from 'ts-morph';
 
-import type { ParseConfig } from '~/models/config';
 import type { BaseUiTypeMap, ParsedComponent, ParsedProp } from '~/models/pipeline';
 import { resolveType } from '~/resolve';
 import { buildBaseUiTypeMap } from '~/resolve/base-ui-mapper';
@@ -67,11 +66,10 @@ function extractParsedProp(
     declNode: Node,
     baseUiMap: BaseUiTypeMap,
     defaultValues: Record<string, string>,
-    verbose?: boolean,
 ): ParsedProp {
     const name = symbol.getName();
     const typeResult = cleanType(
-        resolveType(symbol.getTypeAtLocation(declNode), baseUiMap, declNode, verbose),
+        resolveType(symbol.getTypeAtLocation(declNode), baseUiMap, declNode),
     );
 
     const typeString =
@@ -93,11 +91,20 @@ function extractParsedComponent(
     sourceFile: SourceFile,
     namespace: ModuleDeclaration,
     baseUiMap: BaseUiTypeMap,
-    options: ParseConfig,
 ): ParsedComponent | null {
     const namespaceName = namespace.getName();
     const exportedProps = findExportedInterfaceProps(namespace);
-    if (!exportedProps) return null;
+    if (!exportedProps) {
+        const asInterface = namespace
+            .getInterfaces()
+            .find((decl) => decl.getName() === 'Props' && decl.isExported());
+        if (asInterface) {
+            console.warn(
+                `[docs-extractor] Skipped ${namespaceName}: Props must be an exported type alias, not an interface`,
+            );
+        }
+        return null;
+    }
 
     const allSymbols = exportedProps.getType().getProperties();
     const declaredPropNames = new Set(allSymbols.map((symbol) => symbol.getName()));
@@ -107,13 +114,9 @@ function extractParsedComponent(
         declaredPropNames,
     );
 
-    if (options.verbose) {
-        console.error(`[verbose] ${namespaceName}: ${allSymbols.length} symbols`);
-    }
-
     const props = allSymbols.map((symbol) => {
         const declNode = symbol.getDeclarations()[0] ?? exportedProps;
-        return extractParsedProp(symbol, declNode, baseUiMap, defaultValues, options.verbose);
+        return extractParsedProp(symbol, declNode, baseUiMap, defaultValues);
     });
 
     return {
@@ -123,27 +126,14 @@ function extractParsedComponent(
     };
 }
 
-const DEFAULT_PARSE_CONFIG: ParseConfig = {
-    verbose: undefined,
-};
-
-export function parseSourceFile(
-    sourceFile: SourceFile,
-    options: ParseConfig = DEFAULT_PARSE_CONFIG,
-): ParsedComponent[] {
+export function parseSourceFile(sourceFile: SourceFile): ParsedComponent[] {
     const baseUiMap = buildBaseUiTypeMap(sourceFile);
     const namespaces = getExportedNamespaces(sourceFile);
     const parsedComponents: ParsedComponent[] = [];
 
-    if (options.verbose) {
-        console.error(
-            `[verbose] Found ${namespaces.length} namespaces in ${sourceFile.getFilePath()}`,
-        );
-    }
-
     for (const namespace of namespaces) {
         try {
-            const parsed = extractParsedComponent(sourceFile, namespace, baseUiMap, options);
+            const parsed = extractParsedComponent(sourceFile, namespace, baseUiMap);
             if (parsed) {
                 parsedComponents.push(parsed);
             }
diff --git a/scripts/ts-api-extractor/src/utils/declaration-source.ts b/scripts/ts-api-extractor/src/utils/declaration-source.ts
index 22fab6818..5006ae4a0 100644
--- a/scripts/ts-api-extractor/src/utils/declaration-source.ts
+++ b/scripts/ts-api-extractor/src/utils/declaration-source.ts
@@ -1,115 +1,24 @@
 /**
  * Declaration source module
  *
- * Determines where symbols are declared (project, base-ui, react, dom, external).
+ * Determines where a prop symbol is declared (project, variants, sprinkles,
+ * base-ui, react, dom, external).
  */
 import type { Symbol as TsSymbol } from 'ts-morph';
 
 import type { PropSource } from '~/models/pipeline';
 
-export enum DeclarationSourceType {
-    PROJECT = 'project',
-    REACT_TYPES = 'react-types',
-    DOM_TYPES = 'dom-types',
-    BASE_UI = 'base-ui',
-    EXTERNAL = 'external',
-}
-
 const REACT_TYPES_PATTERNS = ['node_modules/@types/react', 'node_modules/@types/react-dom'];
-
 const DOM_TYPES_PATTERNS = ['node_modules/typescript/lib'];
-
 const BASE_UI_PATTERN = '@base-ui';
-
 const SPRINKLES_PATTERN = 'sprinkles.css';
 
-function normalizeFilePath(filePath: string): string {
-    return filePath.replace(/\\/g, '/');
-}
-
-export function getDeclarationSourceType(filePath: string | undefined): DeclarationSourceType {
-    // undefined is treated as a project-level declaration as a safe fallback.
-    // This handles cases where a symbol has no source file (e.g., built-in types
-    // or ts-morph synthetic nodes) without propagating errors to callers.
-    if (!filePath) return DeclarationSourceType.PROJECT;
-    const normalizedPath = normalizeFilePath(filePath);
-
-    // React types 확인
-    if (REACT_TYPES_PATTERNS.some((pattern) => normalizedPath.includes(pattern))) {
-        return DeclarationSourceType.REACT_TYPES;
-    }
-
-    // DOM types 확인
-    if (DOM_TYPES_PATTERNS.some((pattern) => normalizedPath.includes(pattern))) {
-        return DeclarationSourceType.DOM_TYPES;
-    }
-
-    // Base UI 확인
-    if (normalizedPath.includes(BASE_UI_PATTERN)) {
-        return DeclarationSourceType.BASE_UI;
-    }
-
-    // 기타 node_modules
-    if (normalizedPath.includes('node_modules')) {
-        return DeclarationSourceType.EXTERNAL;
-    }
-
-    // 프로젝트 파일
-    return DeclarationSourceType.PROJECT;
-}
-
-export function isExternalDeclaration(filePath: string | undefined): boolean {
-    const sourceType = getDeclarationSourceType(filePath);
-    return (
-        sourceType === DeclarationSourceType.REACT_TYPES ||
-        sourceType === DeclarationSourceType.DOM_TYPES ||
-        sourceType === DeclarationSourceType.EXTERNAL
-    );
-}
-
-/**
- * Returns the source file path of the symbol's first declaration.
- * For symbols with multiple declarations (e.g., interface merging), only the
- * first declaration's path is returned. Use the `isSymbolFrom*` helpers when
- * you need to check all declarations.
- */
-export function getSymbolSourcePath(symbol: TsSymbol): string | undefined {
-    const declarations = symbol.getDeclarations();
-    if (!declarations.length) return undefined;
-    return declarations[0].getSourceFile().getFilePath();
-}
-
-export function isSymbolFromExternalSource(symbol: TsSymbol): boolean {
-    return symbol
-        .getDeclarations()
-        .some((decl) => isExternalDeclaration(decl.getSourceFile().getFilePath()));
-}
-
-export function isSymbolFromSprinkles(symbol: TsSymbol): boolean {
-    return symbol
-        .getDeclarations()
-        .some((decl) =>
-            normalizeFilePath(decl.getSourceFile().getFilePath()).includes(SPRINKLES_PATTERN),
-        );
-}
-
-export function isSymbolFromBaseUi(symbol: TsSymbol): boolean {
-    return symbol
-        .getDeclarations()
-        .some((decl) =>
-            normalizeFilePath(decl.getSourceFile().getFilePath()).includes(BASE_UI_PATTERN),
-        );
-}
-
-export function isSprinklesPath(filePath: string | undefined): boolean {
-    if (!filePath) return false;
-    return normalizeFilePath(filePath).includes(SPRINKLES_PATTERN);
-}
-
 export function classifyPropSource(symbol: TsSymbol): PropSource {
-    const filePath = getSymbolSourcePath(symbol);
+    // 선언이 없는 심볼(내장 타입, ts-morph 합성 노드)은 프로젝트 선언으로 본다.
+    const filePath = symbol.getDeclarations()[0]?.getSourceFile().getFilePath();
     if (!filePath) return 'project';
-    const normalized = normalizeFilePath(filePath);
+
+    const normalized = filePath.replace(/\\/g, '/');
     if (REACT_TYPES_PATTERNS.some((p) => normalized.includes(p))) return 'react';
     if (DOM_TYPES_PATTERNS.some((p) => normalized.includes(p))) return 'dom';
     if (normalized.includes(BASE_UI_PATTERN)) return 'base-ui';
diff --git a/scripts/ts-api-extractor/test/config.test.ts b/scripts/ts-api-extractor/test/config.test.ts
deleted file mode 100644
index 32cbcbfe5..000000000
--- a/scripts/ts-api-extractor/test/config.test.ts
+++ /dev/null
@@ -1,50 +0,0 @@
-/**
- * Config unit tests
- */
-import { defaultExtractorConfig as config } from '~/config/defaults';
-import { resolveComponentInclude } from '~/config/resolve';
-
-describe('config', () => {
-    it('기본 설정값 확인', () => {
-        expect(config.filterExternal).toBe(true);
-        expect(config.filterHtml).toBe(true);
-        expect(config.filterSprinkles).toBe(true);
-    });
-});
-
-describe('resolveComponentInclude', () => {
-    it('매칭되는 컴포넌트 설정 없으면 undefined 반환', () => {
-        const result = resolveComponentInclude('/some/path/button.tsx');
-
-        expect(result).toBeUndefined();
-    });
-
-    it('패턴 매칭 시 include 반환', () => {
-        const testConfig = {
-            ...config,
-            components: { 'button.tsx': { include: ['size', 'variant'] } },
-        };
-
-        const result = resolveComponentInclude('/some/path/button.tsx', testConfig);
-
-        expect(result).toEqual(['size', 'variant']);
-    });
-
-    it('backslash를 slash로 정규화', () => {
-        const result = resolveComponentInclude('\\some\\path\\button.tsx');
-
-        expect(result).toBeUndefined();
-    });
-
-    it('부분 문자열 매칭은 경로 경계에서만 허용', () => {
-        const testConfig = {
-            ...config,
-            components: { 'button.tsx': { include: ['size'] } },
-        };
-
-        // 'notbutton.tsx' 는 매칭되면 안 됨
-        const result = resolveComponentInclude('/some/path/notbutton.tsx', testConfig);
-
-        expect(result).toBeUndefined();
-    });
-});
diff --git a/scripts/ts-api-extractor/test/declaration-source.test.ts b/scripts/ts-api-extractor/test/declaration-source.test.ts
deleted file mode 100644
index 7a0bbfa28..000000000
--- a/scripts/ts-api-extractor/test/declaration-source.test.ts
+++ /dev/null
@@ -1,106 +0,0 @@
-/**
- * Declaration source unit tests
- */
-import {
-    DeclarationSourceType,
-    getDeclarationSourceType,
-    isExternalDeclaration,
-} from '~/utils/declaration-source';
-
-describe('getDeclarationSourceType', () => {
-    describe('PROJECT', () => {
-        it('일반 프로젝트 파일', () => {
-            expect(getDeclarationSourceType('/src/components/button.tsx')).toBe(
-                DeclarationSourceType.PROJECT,
-            );
-        });
-
-        it('undefined는 PROJECT', () => {
-            expect(getDeclarationSourceType(undefined)).toBe(DeclarationSourceType.PROJECT);
-        });
-
-        it('프로젝트 내 types 파일', () => {
-            expect(getDeclarationSourceType('/src/types/common.ts')).toBe(
-                DeclarationSourceType.PROJECT,
-            );
-        });
-    });
-
-    describe('REACT_TYPES', () => {
-        it('@types/react 경로', () => {
-            expect(getDeclarationSourceType('/node_modules/@types/react/index.d.ts')).toBe(
-                DeclarationSourceType.REACT_TYPES,
-            );
-        });
-
-        it('@types/react-dom 경로', () => {
-            expect(getDeclarationSourceType('/node_modules/@types/react-dom/index.d.ts')).toBe(
-                DeclarationSourceType.REACT_TYPES,
-            );
-        });
-    });
-
-    describe('DOM_TYPES', () => {
-        it('typescript/lib 경로', () => {
-            expect(getDeclarationSourceType('/node_modules/typescript/lib/lib.dom.d.ts')).toBe(
-                DeclarationSourceType.DOM_TYPES,
-            );
-        });
-    });
-
-    describe('BASE_UI', () => {
-        it('@base-ui 경로', () => {
-            expect(
-                getDeclarationSourceType('/node_modules/@base-ui/components/button/root.d.ts'),
-            ).toBe(DeclarationSourceType.BASE_UI);
-        });
-
-        it('@base-ui 중첩 경로', () => {
-            expect(
-                getDeclarationSourceType(
-                    '/node_modules/@base-ui/react/collapsible/root/index.d.ts',
-                ),
-            ).toBe(DeclarationSourceType.BASE_UI);
-        });
-    });
-
-    describe('EXTERNAL', () => {
-        it('기타 node_modules 패키지', () => {
-            expect(getDeclarationSourceType('/node_modules/lodash/index.d.ts')).toBe(
-                DeclarationSourceType.EXTERNAL,
-            );
-        });
-
-        it('@scope 패키지', () => {
-            expect(getDeclarationSourceType('/node_modules/@emotion/react/index.d.ts')).toBe(
-                DeclarationSourceType.EXTERNAL,
-            );
-        });
-    });
-});
-
-describe('isExternalDeclaration', () => {
-    it('REACT_TYPES는 external', () => {
-        expect(isExternalDeclaration('/node_modules/@types/react/index.d.ts')).toBe(true);
-    });
-
-    it('DOM_TYPES는 external', () => {
-        expect(isExternalDeclaration('/node_modules/typescript/lib/lib.dom.d.ts')).toBe(true);
-    });
-
-    it('EXTERNAL은 external', () => {
-        expect(isExternalDeclaration('/node_modules/lodash/index.d.ts')).toBe(true);
-    });
-
-    it('PROJECT는 external 아님', () => {
-        expect(isExternalDeclaration('/src/components/button.tsx')).toBe(false);
-    });
-
-    it('BASE_UI는 external 아님', () => {
-        expect(isExternalDeclaration('/node_modules/@base-ui/components/root.d.ts')).toBe(false);
-    });
-
-    it('undefined는 external 아님', () => {
-        expect(isExternalDeclaration(undefined)).toBe(false);
-    });
-});
diff --git a/scripts/ts-api-extractor/test/file-parser.test.ts b/scripts/ts-api-extractor/test/file-parser.test.ts
index 1d9594486..8865c2f2f 100644
--- a/scripts/ts-api-extractor/test/file-parser.test.ts
+++ b/scripts/ts-api-extractor/test/file-parser.test.ts
@@ -113,7 +113,7 @@ describe('parseSourceFile → transform pipeline', () => {
         expect(dataTestIdProp).toBeUndefined();
     });
 
-    it('respects include option for html-like props', () => {
+    it('respects includeHtml option for html-like props', () => {
         const root = createFixtureRoot();
         const { componentFile } = writeFixtureFiles(root);
         const project = createProject();
@@ -122,9 +122,9 @@ describe('parseSourceFile → transform pipeline', () => {
         const parsed = parseSourceFile(sourceFile);
         const filterConfig: FilterConfig = {
             filterExternal: false,
-            filterHtml: false,
+            filterHtml: true,
             filterSprinkles: false,
-            include: ['data-testid'],
+            includeHtml: ['data-testid'],
         };
         const filtered = filterParsedComponents(parsed, filterConfig);
         const props = componentsToJson(parsedComponentsToModels(filtered));
diff --git a/scripts/ts-api-extractor/test/filter.test.ts b/scripts/ts-api-extractor/test/filter.test.ts
index 38189773d..b75006381 100644
--- a/scripts/ts-api-extractor/test/filter.test.ts
+++ b/scripts/ts-api-extractor/test/filter.test.ts
@@ -12,26 +12,12 @@ const BASE_OPTIONS: FilterConfig = {
 };
 
 describe('shouldIncludeProp', () => {
-    describe('includeSet priority', () => {
-        it('always includes props present in includeSet', () => {
-            const result = shouldIncludeProp(
-                'className',
-                'react' as PropSource,
-                { ...BASE_OPTIONS, filterExternal: true },
-                new Set(['className']),
-                new Set(),
-            );
-            expect(result).toBe(true);
-        });
-    });
-
     describe('includeHtml whitelist', () => {
         it('includes whitelisted html-like props even when filterHtml is on', () => {
             const result = shouldIncludeProp(
                 'ariaLabel',
                 'project' as PropSource,
                 { ...BASE_OPTIONS, filterHtml: true, includeHtml: ['ariaLabel'] },
-                new Set(),
                 new Set(['ariaLabel']),
             );
             expect(result).toBe(true);
@@ -45,7 +31,6 @@ describe('shouldIncludeProp', () => {
                 'react' as PropSource,
                 { ...BASE_OPTIONS, filterExternal: true },
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(false);
         });
@@ -56,7 +41,6 @@ describe('shouldIncludeProp', () => {
                 'react' as PropSource,
                 { ...BASE_OPTIONS, filterExternal: false },
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(true);
         });
@@ -67,7 +51,6 @@ describe('shouldIncludeProp', () => {
                 'project' as PropSource,
                 { ...BASE_OPTIONS, filterExternal: true },
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(true);
         });
@@ -80,7 +63,6 @@ describe('shouldIncludeProp', () => {
                 'project' as PropSource,
                 { ...BASE_OPTIONS, filterHtml: true },
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(false);
         });
@@ -91,7 +73,6 @@ describe('shouldIncludeProp', () => {
                 'project' as PropSource,
                 { ...BASE_OPTIONS, filterHtml: true },
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(false);
         });
@@ -102,7 +83,6 @@ describe('shouldIncludeProp', () => {
                 'project' as PropSource,
                 { ...BASE_OPTIONS, filterHtml: false },
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(true);
         });
@@ -115,7 +95,6 @@ describe('shouldIncludeProp', () => {
                 'sprinkles' as PropSource,
                 { ...BASE_OPTIONS, filterSprinkles: true },
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(false);
         });
@@ -126,7 +105,6 @@ describe('shouldIncludeProp', () => {
                 'project' as PropSource,
                 { ...BASE_OPTIONS, filterSprinkles: true },
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(false);
         });
@@ -137,7 +115,6 @@ describe('shouldIncludeProp', () => {
                 'sprinkles' as PropSource,
                 { ...BASE_OPTIONS, filterSprinkles: false },
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(true);
         });
@@ -150,7 +127,6 @@ describe('shouldIncludeProp', () => {
                 'project' as PropSource,
                 BASE_OPTIONS,
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(true);
         });
@@ -161,7 +137,6 @@ describe('shouldIncludeProp', () => {
                 'project' as PropSource,
                 BASE_OPTIONS,
                 new Set(),
-                new Set(),
             );
             expect(result).toBe(true);
         });
diff --git a/scripts/ts-api-extractor/test/resolver.test.ts b/scripts/ts-api-extractor/test/resolver.test.ts
index beca78fba..c42d7a87e 100644
--- a/scripts/ts-api-extractor/test/resolver.test.ts
+++ b/scripts/ts-api-extractor/test/resolver.test.ts
@@ -9,12 +9,12 @@
 import { Project } from 'ts-morph';
 
 import type { BaseUiTypeMap } from '~/models/pipeline';
+import { resolveType } from '~/resolve';
 import {
-    resolveType,
     simplifyForwardRefType,
     simplifyNodeModulesImports,
     simplifyReactElementGeneric,
-} from '~/resolve';
+} from '~/resolve/shared';
 
 // ============================================================
 // String Simplification Utilities
diff --git a/scripts/ts-api-extractor/tsup.config.ts b/scripts/ts-api-extractor/tsup.config.ts
index 6ea924aa5..5d089c161 100644
--- a/scripts/ts-api-extractor/tsup.config.ts
+++ b/scripts/ts-api-extractor/tsup.config.ts
@@ -1,40 +1,21 @@
 import path from 'node:path';
 import { defineConfig } from 'tsup';
 
-export default defineConfig([
-    // Library build: required for importing defineConfig from apps/website/docs-extractor.config.js
-    {
-        name: 'LIB',
-        format: ['esm'],
-        sourcemap: true,
-        splitting: false,
-        target: 'node20', // matches package.json engines (>=20.19)
-        esbuildOptions(options) {
-            options.alias = {
-                '~': path.resolve(__dirname, './src'),
-            };
-        },
-        entry: ['src/index.ts'],
-        dts: true,
-        outDir: 'dist',
+// CLI build: ts-api-extractor executable
+export default defineConfig({
+    format: ['esm'],
+    sourcemap: true,
+    splitting: false,
+    target: 'node20', // matches package.json engines (>=20.19)
+    esbuildOptions(options) {
+        options.alias = {
+            '~': path.resolve(__dirname, './src'),
+        };
     },
-    // CLI build: ts-api-extractor executable
-    {
-        name: 'CLI',
-        format: ['esm'],
-        sourcemap: true,
-        splitting: false,
-        target: 'node20', // matches package.json engines (>=20.19)
-        esbuildOptions(options) {
-            options.alias = {
-                '~': path.resolve(__dirname, './src'),
-            };
-        },
-        entry: ['src/cli/index.ts'],
-        dts: false,
-        outDir: 'dist/cli',
-        banner: {
-            js: '#!/usr/bin/env node',
-        },
+    entry: ['src/cli/index.ts'],
+    dts: false,
+    outDir: 'dist/cli',
+    banner: {
+        js: '#!/usr/bin/env node',
     },
-]);
+});