From 0f93d25ee4e6186cadaabbb98bc00f8633081022 Mon Sep 17 00:00:00 2001
From: seonghobae <8172694+seonghobae@users.noreply.github.com>
Date: Wed, 15 Jul 2026 14:10:51 +0000
Subject: [PATCH 1/3] UX: Link export artifact descriptions to disabled buttons

---
 .../components/modals/ExportModal.test.tsx    |  5 ++-
 .../src/components/modals/ExportModal.tsx     | 36 ++++++++++---------
 2 files changed, 24 insertions(+), 17 deletions(-)

diff --git a/frontend/src/components/modals/ExportModal.test.tsx b/frontend/src/components/modals/ExportModal.test.tsx
index a5710075..01e20be9 100644
--- a/frontend/src/components/modals/ExportModal.test.tsx
+++ b/frontend/src/components/modals/ExportModal.test.tsx
@@ -155,7 +155,10 @@ describe('ExportModal', () => {
     );
 
     expect(screen.getAllByText('먼저 테이블을 추가하세요')).toHaveLength(7);
-    expect(screen.getByRole('button', { name: 'SQL DDL 복사' })).toBeDisabled();
+    const sqlButton = screen.getByRole('button', { name: 'SQL DDL 복사' });
+    expect(sqlButton).toBeDisabled();
+    expect(sqlButton).toHaveAttribute('aria-describedby', 'export-artifact-desc-sql-ddl');
+
     expect(screen.getByRole('button', { name: 'SVG 이미지 내보내기' })).toBeDisabled();
     expect(screen.getByRole('button', { name: 'PlantUML 내보내기' })).toBeDisabled();
     expect(screen.getByRole('button', { name: 'Mermaid 내보내기' })).toBeDisabled();
diff --git a/frontend/src/components/modals/ExportModal.tsx b/frontend/src/components/modals/ExportModal.tsx
index 60abe891..85c97a1f 100644
--- a/frontend/src/components/modals/ExportModal.tsx
+++ b/frontend/src/components/modals/ExportModal.tsx
@@ -212,23 +212,27 @@ export function ExportModal({
             </p>
 
             <div className="exportModal__artifactList">
-              {artifacts.map((artifact) => (
-                <div className="exportModal__artifactRow" key={artifact.label}>
-                  <div>
-                    <strong>{artifact.label}</strong>
-                    <span>{artifact.description}</span>
+              {artifacts.map((artifact) => {
+                const descId = `export-artifact-desc-${artifact.label.replace(/\s+/g, '-').toLowerCase()}`;
+                return (
+                  <div className="exportModal__artifactRow" key={artifact.label}>
+                    <div>
+                      <strong>{artifact.label}</strong>
+                      <span id={descId}>{artifact.description}</span>
+                    </div>
+                    <button
+                      type="button"
+                      onClick={artifact.onExport}
+                      disabled={artifact.disabled}
+                      aria-label={artifact.ariaLabel}
+                      aria-live={artifact.label === 'SQL DDL' ? 'polite' : undefined}
+                      aria-describedby={descId}
+                    >
+                      {artifact.buttonLabel}
+                    </button>
                   </div>
-                  <button
-                    type="button"
-                    onClick={artifact.onExport}
-                    disabled={artifact.disabled}
-                    aria-label={artifact.ariaLabel}
-                    aria-live={artifact.label === 'SQL DDL' ? 'polite' : undefined}
-                  >
-                    {artifact.buttonLabel}
-                  </button>
-                </div>
-              ))}
+                );
+              })}
             </div>
           </section>
         </div>

From 81c01ff94c07a4717a696f8fbeaf36c99a10546a Mon Sep 17 00:00:00 2001
From: seonghobae <8172694+seonghobae@users.noreply.github.com>
Date: Wed, 15 Jul 2026 14:19:45 +0000
Subject: [PATCH 2/3] UX: Link export artifact descriptions to disabled buttons

---
 frontend/package.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/frontend/package.json b/frontend/package.json
index 02439a97..38f84c2c 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -2,6 +2,7 @@
   "name": "pg-erd-cloud-frontend",
   "private": true,
   "version": "0.1.0",
+  "packageManager": "pnpm@10.30.3",
   "type": "module",
   "engines": {
     "node": ">=26 <27"

From fc8633b6bf4927fade9238abcbe90d3269eacdd0 Mon Sep 17 00:00:00 2001
From: seonghobae <8172694+seonghobae@users.noreply.github.com>
Date: Wed, 15 Jul 2026 15:03:15 +0000
Subject: [PATCH 3/3] UX: Link export artifact descriptions to disabled buttons

---
 frontend/package.json | 1 -
 1 file changed, 1 deletion(-)

diff --git a/frontend/package.json b/frontend/package.json
index 38f84c2c..02439a97 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -2,7 +2,6 @@
   "name": "pg-erd-cloud-frontend",
   "private": true,
   "version": "0.1.0",
-  "packageManager": "pnpm@10.30.3",
   "type": "module",
   "engines": {
     "node": ">=26 <27"