@tekton-ui/mcp-server 0.3.5 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/dist/cli/agent-md-templates.d.ts.map +1 -1
  2. package/dist/cli/agent-md-templates.js +34 -53
  3. package/dist/cli/agent-md-templates.js.map +1 -1
  4. package/dist/cli/guide-template.d.ts.map +1 -1
  5. package/dist/cli/guide-template.js +8 -10
  6. package/dist/cli/guide-template.js.map +1 -1
  7. package/dist/data/component-props.d.ts +30 -0
  8. package/dist/data/component-props.d.ts.map +1 -0
  9. package/dist/data/component-props.js +537 -0
  10. package/dist/data/component-props.js.map +1 -0
  11. package/dist/index.js +28 -86
  12. package/dist/index.js.map +1 -1
  13. package/dist/prompts/getting-started.d.ts.map +1 -1
  14. package/dist/prompts/getting-started.js +8 -9
  15. package/dist/prompts/getting-started.js.map +1 -1
  16. package/dist/prompts/screen-workflow.d.ts +2 -2
  17. package/dist/prompts/screen-workflow.d.ts.map +1 -1
  18. package/dist/prompts/screen-workflow.js +64 -61
  19. package/dist/prompts/screen-workflow.js.map +1 -1
  20. package/dist/schemas/mcp-schemas.d.ts +628 -652
  21. package/dist/schemas/mcp-schemas.d.ts.map +1 -1
  22. package/dist/schemas/mcp-schemas.js +14 -40
  23. package/dist/schemas/mcp-schemas.js.map +1 -1
  24. package/dist/tools/get-screen-generation-context.d.ts.map +1 -1
  25. package/dist/tools/get-screen-generation-context.js +22 -13
  26. package/dist/tools/get-screen-generation-context.js.map +1 -1
  27. package/dist/tools/preview-component.d.ts.map +1 -1
  28. package/dist/tools/preview-component.js +2 -117
  29. package/dist/tools/preview-component.js.map +1 -1
  30. package/dist/tools/validate-screen-definition.d.ts.map +1 -1
  31. package/dist/tools/validate-screen-definition.js +96 -0
  32. package/dist/tools/validate-screen-definition.js.map +1 -1
  33. package/package.json +21 -19
  34. package/LICENSE +0 -21
@@ -1 +1 @@
1
- {"version":3,"file":"agent-md-templates.d.ts","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAyHpE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAoMpE"}
1
+ {"version":3,"file":"agent-md-templates.d.ts","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAsHpE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAoLpE"}
@@ -13,7 +13,7 @@ export function generateClaudeMdSection(framework) {
13
13
 
14
14
  ### MCP Server Connection
15
15
 
16
- Tekton MCP server is configured in \`.mcp.json\`. Claude Code automatically loads 16 tools for screen generation.
16
+ Tekton MCP server is configured in \`.mcp.json\`. Claude Code automatically loads 15 tools for screen generation.
17
17
 
18
18
  ### Authentication (Step 1)
19
19
 
@@ -25,23 +25,22 @@ tekton-mcp login
25
25
 
26
26
  **Important:** All 6 themes require authentication. No free themes are available.
27
27
 
28
- ### Screen Generation Workflow (4 Steps)
28
+ ### Screen Generation Workflow (3 Steps)
29
29
 
30
- **Step 1/4:** Gather Context
30
+ **Step 1/3:** Gather Context
31
31
  - Call \`get-screen-generation-context\` with user's screen description
32
- - Receive template matches, component suggestions, and schema
32
+ - Receive template matches, component suggestions with inline props/variants, and schema
33
33
 
34
- **Step 2/4:** Validate Definition
34
+ **Step 2/3:** Validate Definition
35
35
  - Generate Screen Definition JSON based on context
36
36
  - Call \`validate-screen-definition\` to verify structure
37
- - Fix any errors before proceeding
37
+ - Apply autoFixPatches or fix any errors before proceeding
38
38
 
39
- **Step 3/4:** Generate Code
40
- - Call \`generate_screen\` with validated definition
41
- - Receive production React code and dependencies list
42
- - Check \`dependencies.external\` field
39
+ **After Validation:** Write React Code Directly
40
+ - Use components and import statements from Step 1 context
41
+ - Apply theme recipes via variant props
43
42
 
44
- **Step 4/4:** Validate Environment
43
+ **Step 3/3:** Validate Environment (Optional)
45
44
  - Call \`validate-environment\` with project path and required packages
46
45
  - Verify Tailwind CSS configuration
47
46
  - Show user install commands for missing packages
@@ -76,11 +75,10 @@ export default function Page() {
76
75
  - \`list-screen-templates\` - List 13 screen templates
77
76
  - \`preview-screen-template\` - Get template structure
78
77
 
79
- **Screen Generation (4 tools):**
80
- - \`get-screen-generation-context\` - Step 1/4
81
- - \`validate-screen-definition\` - Step 2/4
82
- - \`generate_screen\` - Step 3/4
83
- - \`validate-environment\` - Step 4/4
78
+ **Screen Generation (3 tools):**
79
+ - \`get-screen-generation-context\` - Step 1/3
80
+ - \`validate-screen-definition\` - Step 2/3
81
+ - \`validate-environment\` - Step 3/3 (Optional)
84
82
 
85
83
  **Quick Prototyping (3 tools):**
86
84
  - \`generate-blueprint\` - Quick UI structure
@@ -99,7 +97,7 @@ export default function Page() {
99
97
  Claude Code can access built-in prompts for guidance:
100
98
 
101
99
  - \`getting-started\` - Authentication → Theme → Components → Screen generation
102
- - \`screen-workflow\` - Detailed 4-step workflow with troubleshooting
100
+ - \`screen-workflow\` - Detailed 3-step workflow with troubleshooting
103
101
 
104
102
  These prompts work across all MCP clients, not just Claude Code.
105
103
 
@@ -108,8 +106,7 @@ These prompts work across all MCP clients, not just Claude Code.
108
106
  1. ❌ Skipping authentication before generating screens
109
107
  2. ❌ Using non-existent theme IDs (only 6 exist)
110
108
  3. ❌ Skipping validate-screen-definition step
111
- 4. ❌ Not checking dependencies.external field
112
- 5. ❌ Delivering code without verifying Tailwind config
109
+ 4. ❌ Delivering code without verifying Tailwind config
113
110
 
114
111
  ### Troubleshooting
115
112
 
@@ -138,7 +135,7 @@ export function generateAgentsMdSection(framework) {
138
135
 
139
136
  ### Overview
140
137
 
141
- Tekton MCP server provides 16 tools for screen generation via Model Context Protocol (MCP). This guide is for AI agents on platforms like OpenAI Codex, Cursor, Windsurf, and other MCP-compatible clients.
138
+ Tekton MCP server provides 15 tools for screen generation via Model Context Protocol (MCP). This guide is for AI agents on platforms like OpenAI Codex, Cursor, Windsurf, and other MCP-compatible clients.
142
139
 
143
140
  ### Prerequisites
144
141
 
@@ -160,11 +157,11 @@ tekton-mcp login
160
157
 
161
158
  **Important:** All 6 themes require valid licenses. There are no free themes available.
162
159
 
163
- ### Screen Generation Workflow (4 Steps)
160
+ ### Screen Generation Workflow (3 Steps)
164
161
 
165
162
  Follow this exact sequence for production-ready screens:
166
163
 
167
- #### Step 1/4: Gather Context
164
+ #### Step 1/3: Gather Context
168
165
 
169
166
  **Tool:** \`get-screen-generation-context\`
170
167
 
@@ -179,9 +176,9 @@ Follow this exact sequence for production-ready screens:
179
176
  }
180
177
  \`\`\`
181
178
 
182
- **Output:** Template matches, component suggestions, schema, examples
179
+ **Output:** Template matches, component suggestions with inline props/variants, schema, examples
183
180
 
184
- #### Step 2/4: Validate Definition
181
+ #### Step 2/3: Validate Definition
185
182
 
186
183
  **Tool:** \`validate-screen-definition\`
187
184
 
@@ -200,33 +197,17 @@ Follow this exact sequence for production-ready screens:
200
197
  }
201
198
  \`\`\`
202
199
 
203
- **Output:** Validation results with errors, warnings, suggestions
200
+ **Output:** Validation results with errors, warnings, suggestions, and autoFix patches
204
201
 
205
- **Critical:** Always validate before Step 3. Fix all errors before proceeding.
202
+ **Critical:** Always validate before writing code. Apply autoFixPatches or fix all errors.
206
203
 
207
- #### Step 3/4: Generate Code
204
+ #### After Validation: Write React Code Directly
208
205
 
209
- **Tool:** \`generate_screen\`
206
+ **No tool needed** - Write production-ready React code using components from Step 1 context.
210
207
 
211
- **Purpose:** Generate production React code
208
+ Use the import statements and props provided in the context response.
212
209
 
213
- **Input:**
214
- \`\`\`json
215
- {
216
- "screenDefinition": { /* from Step 2 */ },
217
- "outputFormat": "tailwind",
218
- "options": {
219
- "typescript": true,
220
- "prettier": true
221
- }
222
- }
223
- \`\`\`
224
-
225
- **Output:** React code + dependencies
226
-
227
- **Critical:** Check \`dependencies.external\` field. If non-empty, proceed to Step 4.
228
-
229
- #### Step 4/4: Validate Environment
210
+ #### Step 3/3: Validate Environment (Optional)
230
211
 
231
212
  **Tool:** \`validate-environment\`
232
213
 
@@ -236,7 +217,7 @@ Follow this exact sequence for production-ready screens:
236
217
  \`\`\`json
237
218
  {
238
219
  "projectPath": "/path/to/package.json",
239
- "requiredPackages": ["framer-motion", "@radix-ui/react-slot"],
220
+ "requiredPackages": ["@radix-ui/react-slot", "@radix-ui/react-avatar"],
240
221
  "checkTailwind": true
241
222
  }
242
223
  \`\`\`
@@ -286,7 +267,7 @@ export default function Page() {
286
267
  Your MCP client may support prompts. If available:
287
268
 
288
269
  - \`getting-started\` - Complete onboarding guide
289
- - \`screen-workflow\` - Detailed 4-step workflow
270
+ - \`screen-workflow\` - Detailed 3-step workflow
290
271
 
291
272
  These provide context to help you guide users effectively.
292
273
 
@@ -313,16 +294,16 @@ These provide context to help you guide users effectively.
313
294
  ### Best Practices
314
295
 
315
296
  1. ✅ Always authenticate before generating screens
316
- 2. ✅ Follow all 4 workflow steps in order
317
- 3. ✅ Validate before generating (Step 2 before Step 3)
318
- 4. ✅ Check environment before delivering code (Step 4)
297
+ 2. ✅ Follow all 3 workflow steps in order
298
+ 3. ✅ Validate before writing code (Step 2)
299
+ 4. ✅ Check environment before delivering code (Step 3)
319
300
  5. ✅ Inform user about missing dependencies and Tailwind issues
320
301
  6. ✅ Use \`strict: true\` for production validation
321
302
 
322
- ### Quick Reference: All 16 Tools
303
+ ### Quick Reference: All 15 Tools
323
304
 
324
305
  **Discovery:** list-themes, preview-theme, list-components, preview-component, list-screen-templates, preview-screen-template
325
- **Workflow:** get-screen-generation-context, validate-screen-definition, generate_screen, validate-environment
306
+ **Workflow:** get-screen-generation-context, validate-screen-definition, validate-environment
326
307
  **Quick:** generate-blueprint, export-screen, validate_screen, list_tokens
327
308
  **Icons:** list-icon-libraries, preview-icon-library
328
309
  `;
@@ -1 +1 @@
1
- {"version":3,"file":"agent-md-templates.js","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAyCJ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Ed,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmIJ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Dd,CAAC;AACF,CAAC"}
1
+ {"version":3,"file":"agent-md-templates.js","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwCJ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Ed,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmHJ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Dd,CAAC;AACF,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"guide-template.d.ts","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CA8L1D"}
1
+ {"version":3,"file":"guide-template.d.ts","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CA4L1D"}
@@ -70,9 +70,9 @@ tekton-mcp status
70
70
 
71
71
  ## Screen Generation Workflow
72
72
 
73
- Tekton provides a **4-step workflow** for production-ready screen generation:
73
+ Tekton provides a **3-step workflow** for production-ready screen generation:
74
74
 
75
- ### Step 1/4: Get Context
75
+ ### Step 1/3: Get Context
76
76
 
77
77
  Claude Code calls \`get-screen-generation-context\` with your screen description:
78
78
 
@@ -80,21 +80,19 @@ Claude Code calls \`get-screen-generation-context\` with your screen description
80
80
  "Create a user dashboard with profile card and recent activity"
81
81
  \`\`\`
82
82
 
83
- Returns: Template matches, component suggestions, Screen Definition schema
83
+ Returns: Template matches, component suggestions with inline props/variants, Screen Definition schema
84
84
 
85
- ### Step 2/4: Validate Definition
85
+ ### Step 2/3: Validate Definition
86
86
 
87
87
  Claude Code generates a Screen Definition JSON and calls \`validate-screen-definition\`:
88
88
 
89
- Returns: Validation results, errors (if any), improvement suggestions
89
+ Returns: Validation results, errors with auto-fix patches (if any), improvement suggestions
90
90
 
91
- ### Step 3/4: Generate Code
91
+ ### After Validation: Write Code
92
92
 
93
- Claude Code calls \`generate_screen\` with the validated definition:
93
+ Claude Code writes React code directly using the components and props from Step 1 context.
94
94
 
95
- Returns: Production React code, CSS variables, dependencies list
96
-
97
- ### Step 4/4: Validate Environment
95
+ ### Step 3/3: Validate Environment (Optional)
98
96
 
99
97
  Claude Code calls \`validate-environment\` to check your project:
100
98
 
@@ -1 +1 @@
1
- {"version":3,"file":"guide-template.js","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,MAAM,aAAa,GACjB,SAAS,KAAK,QAAQ;QACpB,CAAC,CAAC;;;;;;;;;;;;;;EAcN;QACI,CAAC,CAAC;;;;;;;;;;;;;;;;oBAgBY,CAAC;IAEnB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsEP,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFd,CAAC;AACF,CAAC"}
1
+ {"version":3,"file":"guide-template.js","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,MAAM,aAAa,GACjB,SAAS,KAAK,QAAQ;QACpB,CAAC,CAAC;;;;;;;;;;;;;;EAcN;QACI,CAAC,CAAC;;;;;;;;;;;;;;;;oBAgBY,CAAC;IAEnB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoEP,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFd,CAAC;AACF,CAAC"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Shared Component Props Data Module
3
+ * 실제 @tekton-ui/ui 컴포넌트에서 추출한 Tier 1 (15개 core) props/variants 데이터
4
+ *
5
+ * 사용처:
6
+ * - preview-component.ts: 컴포넌트 상세 정보 제공
7
+ * - get-screen-generation-context.ts: 인라인 props 컨텍스트 제공
8
+ * - validate-screen-definition.ts: props 유효성 검증
9
+ */
10
+ import type { PropDefinition, Variant, UsageExample } from '../schemas/mcp-schemas.js';
11
+ export interface ComponentPropsData {
12
+ props: PropDefinition[];
13
+ variants?: Variant[];
14
+ subComponents?: string[];
15
+ dependencies: {
16
+ internal: string[];
17
+ external: string[];
18
+ };
19
+ examples?: UsageExample[];
20
+ accessibility?: string;
21
+ }
22
+ /**
23
+ * 컴포넌트 ID로 props 데이터 조회
24
+ */
25
+ export declare function getComponentPropsData(componentId: string): ComponentPropsData | undefined;
26
+ /**
27
+ * 모든 컴포넌트 props 데이터가 있는 컴포넌트 ID 목록 반환
28
+ */
29
+ export declare function getComponentIdsWithProps(): string[];
30
+ //# sourceMappingURL=component-props.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"component-props.d.ts","sourceRoot":"","sources":["../../src/data/component-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACzD,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAuhBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEzF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD"}