@polymorphism-tech/morph-spec 3.0.0 → 3.0.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 (160) hide show
  1. package/CLAUDE.md +75 -371
  2. package/LICENSE +72 -72
  3. package/bin/detect-agents.js +225 -225
  4. package/bin/render-template.js +302 -302
  5. package/bin/semantic-detect-agents.js +246 -246
  6. package/bin/validate-agents-skills.js +251 -251
  7. package/bin/validate-agents.js +69 -69
  8. package/bin/validate-phase.js +263 -263
  9. package/content/.azure/README.md +293 -293
  10. package/content/.azure/docs/azure-devops-setup.md +454 -454
  11. package/content/.azure/docs/branch-strategy.md +398 -398
  12. package/content/.azure/docs/local-development.md +515 -515
  13. package/content/.azure/pipelines/pipeline-variables.yml +34 -34
  14. package/content/.azure/pipelines/prod-pipeline.yml +319 -319
  15. package/content/.azure/pipelines/staging-pipeline.yml +234 -234
  16. package/content/.azure/pipelines/templates/build-dotnet.yml +75 -75
  17. package/content/.azure/pipelines/templates/deploy-app-service.yml +94 -94
  18. package/content/.azure/pipelines/templates/deploy-container-app.yml +120 -120
  19. package/content/.azure/pipelines/templates/infra-deploy.yml +90 -90
  20. package/content/.claude/commands/morph-archive.md +79 -79
  21. package/content/.claude/commands/morph-deploy.md +529 -529
  22. package/content/.claude/commands/morph-infra.md +209 -209
  23. package/content/.claude/commands/morph-preflight.md +227 -227
  24. package/content/.claude/commands/morph-troubleshoot.md +122 -122
  25. package/content/.claude/settings.local.json +15 -15
  26. package/content/.claude/skills/{specialists → level-2-domains/architecture}/prompt-engineer.md +189 -189
  27. package/content/.claude/skills/{specialists → level-2-domains/architecture}/seo-growth-hacker.md +320 -320
  28. package/content/.claude/skills/{infra → level-2-domains/infrastructure}/azure-deploy-specialist.md +699 -699
  29. package/content/.morph/.morphversion +5 -5
  30. package/content/.morph/archive/.gitkeep +25 -25
  31. package/content/.morph/config/agents.json +7 -5
  32. package/content/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +392 -392
  33. package/content/.morph/examples/api-nextjs/README.md +241 -241
  34. package/content/.morph/examples/api-nextjs/contracts.ts +307 -307
  35. package/content/.morph/examples/api-nextjs/spec.md +399 -399
  36. package/content/.morph/examples/api-nextjs/tasks.md +168 -168
  37. package/content/.morph/examples/micro-saas/README.md +125 -125
  38. package/content/.morph/examples/micro-saas/contracts.cs +358 -358
  39. package/content/.morph/examples/micro-saas/decisions.md +246 -246
  40. package/content/.morph/examples/micro-saas/spec.md +236 -236
  41. package/content/.morph/examples/micro-saas/tasks.md +150 -150
  42. package/content/.morph/examples/multi-agent/README.md +309 -309
  43. package/content/.morph/examples/multi-agent/contracts.cs +433 -433
  44. package/content/.morph/examples/multi-agent/spec.md +479 -479
  45. package/content/.morph/examples/multi-agent/tasks.md +185 -185
  46. package/content/.morph/examples/state-v3.json +188 -188
  47. package/content/.morph/features/.gitkeep +25 -25
  48. package/content/.morph/hooks/pre-commit-all.sh +48 -48
  49. package/content/.morph/hooks/pre-commit-specs.sh +49 -49
  50. package/content/.morph/hooks/pre-commit-tests.sh +60 -60
  51. package/content/.morph/project.md +160 -160
  52. package/content/.morph/schemas/agent.schema.json +296 -296
  53. package/content/.morph/specs/.gitkeep +20 -20
  54. package/content/.morph/standards/coding.md +377 -377
  55. package/content/.morph/standards/fluent-ui-setup.md +590 -590
  56. package/content/.morph/standards/migration-guide.md +514 -514
  57. package/content/.morph/standards/passkeys-auth.md +423 -423
  58. package/content/.morph/standards/vector-search-rag.md +536 -536
  59. package/content/.morph/state.json +17 -17
  60. package/content/.morph/templates/FluentDesignTheme.cs +149 -149
  61. package/content/.morph/templates/MudTheme.cs +281 -281
  62. package/content/.morph/templates/component.razor +239 -239
  63. package/content/.morph/templates/contracts.cs +217 -217
  64. package/content/.morph/templates/design-system.css +226 -226
  65. package/content/.morph/templates/infra/.dockerignore.example +89 -89
  66. package/content/.morph/templates/infra/Dockerfile.example +82 -82
  67. package/content/.morph/templates/infra/README.md +286 -286
  68. package/content/.morph/templates/infra/app-insights.bicep +63 -63
  69. package/content/.morph/templates/infra/app-service.bicep +164 -164
  70. package/content/.morph/templates/infra/azure-pipelines-deploy.yml +480 -480
  71. package/content/.morph/templates/infra/container-app-env.bicep +49 -49
  72. package/content/.morph/templates/infra/container-app.bicep +156 -156
  73. package/content/.morph/templates/infra/deploy-checklist.md +426 -426
  74. package/content/.morph/templates/infra/deploy.ps1 +229 -229
  75. package/content/.morph/templates/infra/deploy.sh +208 -208
  76. package/content/.morph/templates/infra/key-vault.bicep +91 -91
  77. package/content/.morph/templates/infra/main.bicep +189 -189
  78. package/content/.morph/templates/infra/parameters.dev.json +29 -29
  79. package/content/.morph/templates/infra/parameters.prod.json +29 -29
  80. package/content/.morph/templates/infra/parameters.staging.json +29 -29
  81. package/content/.morph/templates/infra/sql-database.bicep +103 -103
  82. package/content/.morph/templates/infra/storage.bicep +106 -106
  83. package/content/.morph/templates/integrations/asaas-client.cs +387 -387
  84. package/content/.morph/templates/integrations/asaas-webhook.cs +351 -351
  85. package/content/.morph/templates/integrations/azure-identity-config.cs +288 -288
  86. package/content/.morph/templates/integrations/clerk-config.cs +258 -258
  87. package/content/.morph/templates/job.cs +171 -171
  88. package/content/.morph/templates/migration.cs +83 -83
  89. package/content/.morph/templates/repository.cs +141 -141
  90. package/content/.morph/templates/saas/subscription.cs +347 -347
  91. package/content/.morph/templates/saas/tenant.cs +338 -338
  92. package/content/.morph/templates/service.cs +139 -139
  93. package/content/.morph/templates/sprint-status.yaml +68 -68
  94. package/content/.morph/templates/story.md +143 -143
  95. package/content/.morph/templates/test.cs +239 -239
  96. package/content/.morph/templates/ui-design-system.md +286 -286
  97. package/content/.morph/templates/ui-flows.md +336 -336
  98. package/content/.morph/templates/ui-mockups.md +133 -133
  99. package/content/.morph/test-infra/example.bicep +59 -59
  100. package/content/README.md +79 -79
  101. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.svg +977 -977
  102. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.svg +1048 -1048
  103. package/docs/api/scripts/collapse.js +38 -38
  104. package/docs/api/scripts/commonNav.js +28 -28
  105. package/docs/api/scripts/linenumber.js +25 -25
  106. package/docs/api/scripts/nav.js +12 -12
  107. package/docs/api/scripts/polyfill.js +3 -3
  108. package/docs/api/scripts/prettify/Apache-License-2.0.txt +202 -202
  109. package/docs/api/scripts/prettify/lang-css.js +2 -2
  110. package/docs/api/scripts/prettify/prettify.js +28 -28
  111. package/docs/api/scripts/search.js +98 -98
  112. package/docs/api/styles/jsdoc.css +776 -776
  113. package/docs/api/styles/prettify.css +80 -80
  114. package/docs/examples.md +328 -328
  115. package/docs/templates.md +418 -418
  116. package/package.json +1 -2
  117. package/scripts/postinstall.js +132 -132
  118. package/scripts/reorganize-skills.cjs +175 -0
  119. package/scripts/validate-agents-structure.cjs +52 -0
  120. package/scripts/validate-skills.cjs +180 -0
  121. package/src/commands/analyze-blazor-concurrency.js +193 -193
  122. package/src/commands/create-story.js +351 -351
  123. package/src/commands/deploy.js +780 -780
  124. package/src/commands/detect-agents.js +9 -0
  125. package/src/commands/detect.js +104 -104
  126. package/src/commands/generate.js +149 -149
  127. package/src/commands/lint-fluent.js +352 -352
  128. package/src/commands/rollback-phase.js +185 -185
  129. package/src/commands/session-summary.js +291 -291
  130. package/src/commands/shard-spec.js +224 -224
  131. package/src/commands/sprint-status.js +250 -250
  132. package/src/commands/state.js +334 -333
  133. package/src/commands/sync.js +167 -167
  134. package/src/commands/troubleshoot.js +222 -222
  135. package/src/commands/update.js +13 -1
  136. package/src/commands/validate-blazor-state.js +210 -210
  137. package/src/commands/validate-blazor.js +156 -156
  138. package/src/commands/validate-css.js +84 -84
  139. package/src/commands/validate-phase.js +221 -221
  140. package/src/lib/blazor-concurrency-analyzer.js +288 -288
  141. package/src/lib/blazor-state-validator.js +291 -291
  142. package/src/lib/blazor-validator.js +374 -374
  143. package/src/lib/css-validator.js +352 -352
  144. package/src/lib/design-system-generator.js +298 -298
  145. package/{detectors → src/lib/detectors}/config-detector.js +223 -223
  146. package/{detectors → src/lib/detectors}/conversation-analyzer.js +163 -163
  147. package/{detectors → src/lib/detectors}/index.js +84 -84
  148. package/{detectors → src/lib/detectors}/standards-generator.js +275 -275
  149. package/src/lib/learning-system.js +520 -520
  150. package/src/lib/mockup-generator.js +366 -366
  151. package/src/lib/state-manager.js +21 -4
  152. package/src/lib/troubleshoot-grep.js +194 -194
  153. package/src/lib/troubleshoot-index.js +144 -144
  154. package/src/lib/ui-detector.js +350 -350
  155. package/src/lib/validators/architecture-validator.js +387 -387
  156. package/src/lib/validators/package-validator.js +360 -360
  157. package/src/lib/validators/ui-contrast-validator.js +422 -422
  158. package/src/utils/logger.js +32 -32
  159. package/src/utils/version-checker.js +175 -175
  160. /package/{detectors → src/lib/detectors}/structure-detector.js +0 -0
@@ -1,366 +1,366 @@
1
- /**
2
- * Mockup Generator
3
- *
4
- * Generates high-quality ASCII wireframes for UI components.
5
- * Used in FASE 1.5: UI/UX Design (conception phase).
6
- *
7
- * MORPH-SPEC 3.0
8
- */
9
-
10
- /**
11
- * Generate wireframe based on component spec
12
- * @param {Object} componentSpec - Component specification
13
- * @returns {string} ASCII wireframe
14
- */
15
- export function generateWireframe(componentSpec) {
16
- switch (componentSpec.type) {
17
- case 'form':
18
- return generateFormWireframe(componentSpec);
19
- case 'list':
20
- case 'data-grid':
21
- return generateListWireframe(componentSpec);
22
- case 'dashboard':
23
- return generateDashboardWireframe(componentSpec);
24
- case 'wizard':
25
- return generateWizardWireframe(componentSpec);
26
- case 'file-upload':
27
- return generateFileUploadWireframe(componentSpec);
28
- case 'confirm-dialog':
29
- return generateConfirmDialogWireframe(componentSpec);
30
- case 'detail-view':
31
- return generateDetailViewWireframe(componentSpec);
32
- default:
33
- return generateGenericWireframe(componentSpec);
34
- }
35
- }
36
-
37
- /**
38
- * Generate form wireframe
39
- */
40
- function generateFormWireframe(spec) {
41
- const { entity, operation = 'create', fields = [] } = spec;
42
- const title = operation === 'create' ? `Create ${entity}` : `Edit ${entity}`;
43
-
44
- const maxLabelLength = Math.max(...fields.map(f => (f.label || f.name).length), 15);
45
- const fieldWidth = 40;
46
- const totalWidth = maxLabelLength + fieldWidth + 10;
47
-
48
- const fieldLines = fields.map(field => {
49
- const label = (field.label || field.name).padEnd(maxLabelLength);
50
- const inputType = getInputType(field.type);
51
- const required = field.isRequired ? '*' : ' ';
52
-
53
- return `│ ${required} ${label} ${inputType.padEnd(fieldWidth)} │`;
54
- }).join('\n');
55
-
56
- return `
57
- ┌${'─'.repeat(totalWidth)}┐
58
- │ ${title.padEnd(totalWidth - 4)} │
59
- ├${'─'.repeat(totalWidth)}┤
60
- │${' '.repeat(totalWidth)}│
61
- ${fieldLines}
62
- │${' '.repeat(totalWidth)}│
63
- │ ┌──────────┐ ┌────────┐${' '.repeat(totalWidth - 34)}│
64
- │ │ ${operation === 'create' ? 'Create' : 'Save'} │ │ Cancel │${' '.repeat(totalWidth - 34)}│
65
- │ └──────────┘ └────────┘${' '.repeat(totalWidth - 34)}│
66
- └${'─'.repeat(totalWidth)}┘
67
-
68
- Legend: * = Required field
69
- `.trim();
70
- }
71
-
72
- /**
73
- * Get input type representation
74
- */
75
- function getInputType(type) {
76
- if (!type) return '[_________________]';
77
-
78
- const lower = type.toLowerCase();
79
-
80
- if (lower.includes('string') || lower.includes('text')) {
81
- return '[_________________]';
82
- } else if (lower.includes('int') || lower.includes('decimal') || lower.includes('number')) {
83
- return '[______] (number)';
84
- } else if (lower.includes('date') || lower.includes('datetime')) {
85
- return '[____/____/____] 📅';
86
- } else if (lower.includes('bool')) {
87
- return '☐ Yes ☐ No';
88
- } else if (lower.includes('enum') || lower.includes('status') || lower.includes('type')) {
89
- return '[Select option ▼]';
90
- } else if (lower.includes('email')) {
91
- return '[___@___.___]';
92
- } else if (lower.includes('url')) {
93
- return '[https://____]';
94
- } else {
95
- return '[_________________]';
96
- }
97
- }
98
-
99
- /**
100
- * Generate list/grid wireframe
101
- */
102
- function generateListWireframe(spec) {
103
- const { entity, fields = [], features = {} } = spec;
104
- const title = `${entity} List`;
105
-
106
- const headers = fields.slice(0, 5).map(f => (f.label || f.name).substring(0, 15).padEnd(15));
107
- const headerLine = headers.join(' │ ');
108
-
109
- const sampleRow = fields.slice(0, 5).map(f => {
110
- const sample = getSampleValue(f.type);
111
- return sample.substring(0, 15).padEnd(15);
112
- }).join(' │ ');
113
-
114
- const totalWidth = headers.length * 16 + headers.length - 1 + 12; // +12 for actions
115
-
116
- return `
117
- ┌${'─'.repeat(totalWidth + 4)}┐
118
- │ ${title.padEnd(totalWidth - 20)} [+ New] [⚙ Filters] │
119
- ├${'─'.repeat(totalWidth + 4)}┤
120
- │ ${headerLine} │ Actions │
121
- ├${'─'.repeat(totalWidth + 4)}┤
122
- │ ${sampleRow} │ ✏️ 🗑️ │
123
- │ ${sampleRow} │ ✏️ 🗑️ │
124
- │ ${sampleRow} │ ✏️ 🗑️ │
125
- ${features.pagination !== false ? `├${'─'.repeat(totalWidth + 4)}┤
126
- │ ◀ 1 2 3 ... 10 ▶${' '.repeat(totalWidth - 40)}Showing 1-10 of 47 │` : ''}
127
- └${'─'.repeat(totalWidth + 4)}┘
128
-
129
- ${features.filtering !== false ? '\nFeatures: Search, Filter, Sort' : ''}
130
- ${features.selection !== false ? 'Selection: Multi-select with checkboxes' : ''}
131
- `.trim();
132
- }
133
-
134
- /**
135
- * Get sample value for field type
136
- */
137
- function getSampleValue(type) {
138
- if (!type) return 'Sample Value';
139
-
140
- const lower = type.toLowerCase();
141
-
142
- if (lower.includes('name')) return 'John Doe';
143
- if (lower.includes('email')) return 'user@example.com';
144
- if (lower.includes('phone')) return '(555) 123-4567';
145
- if (lower.includes('date')) return '2025-01-17';
146
- if (lower.includes('status')) return 'Active';
147
- if (lower.includes('amount') || lower.includes('price')) return '$99.99';
148
- if (lower.includes('quantity') || lower.includes('count')) return '42';
149
- if (lower.includes('bool')) return 'Yes';
150
-
151
- return 'Sample';
152
- }
153
-
154
- /**
155
- * Generate dashboard wireframe
156
- */
157
- function generateDashboardWireframe(spec) {
158
- const { widgets = [] } = spec;
159
-
160
- const hasStats = widgets.some(w => w.type === 'stat-card');
161
- const hasChart = widgets.some(w => w.type === 'chart');
162
- const hasTable = widgets.some(w => w.type === 'data-table');
163
-
164
- return `
165
- ┌────────────────────────────────────────────────────────────────────────────┐
166
- │ Dashboard Overview [User Icon] ▼ │
167
- ├────────────────────────────────────────────────────────────────────────────┤
168
- │ │
169
- ${hasStats ? `│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
170
- │ │ Total Sales │ │ New Orders │ │ Revenue │ │
171
- │ │ $125,430 │ │ 47 │ │ +12.5% │ │
172
- │ │ +8.2% ↑ │ │ +5 today │ │ This month │ │
173
- │ └──────────────┘ └──────────────┘ └──────────────┘ │
174
- │ │` : ''}
175
- ${hasChart ? `│ ┌────────────────────────────────────────────────────────────────┐ │
176
- │ │ Sales Trend (Last 30 Days) │ │
177
- │ │ │ │
178
- │ │ $ ╭─╮ │ │
179
- │ │ │ │ ╭─╮ │ │
180
- │ │ │ │ ╭─╯ ╰─╮ ╭─╮ │ │
181
- │ │ ────┴─┴───┴─────┴───┴─┴───────────────────────────────────── │ │
182
- │ │ Week 1 Week 2 Week 3 Week 4 │ │
183
- │ └────────────────────────────────────────────────────────────────┘ │
184
- │ │` : ''}
185
- ${hasTable ? `│ ┌────────────────────────────────────────────────────────────────┐ │
186
- │ │ Recent Orders [View All →] │ │
187
- │ ├────────────────────────────────────────────────────────────────┤ │
188
- │ │ Order # Customer Amount Status Actions │ │
189
- │ ├────────────────────────────────────────────────────────────────┤ │
190
- │ │ #1234 John Doe $99.99 Pending 👁️ ✏️ │ │
191
- │ │ #1233 Jane Smith $149.99 Completed 👁️ ✏️ │ │
192
- │ │ #1232 Bob Johnson $79.99 Shipped 👁️ ✏️ │ │
193
- │ └────────────────────────────────────────────────────────────────┘ │` : ''}
194
- │ │
195
- └────────────────────────────────────────────────────────────────────────────┘
196
- `.trim();
197
- }
198
-
199
- /**
200
- * Generate wizard wireframe
201
- */
202
- function generateWizardWireframe(spec) {
203
- const { steps = [] } = spec;
204
- const currentStep = steps[0] || { number: 1, title: 'Step 1' };
205
-
206
- const stepIndicators = steps.map((step, i) => {
207
- const isCurrent = i === 0;
208
- return isCurrent ? `● ${step.number}` : `○ ${step.number}`;
209
- }).join(' ── ');
210
-
211
- return `
212
- ┌────────────────────────────────────────────────────────────────────────────┐
213
- │ ${currentStep.title.padEnd(70)} │
214
- ├────────────────────────────────────────────────────────────────────────────┤
215
- │ │
216
- │ Progress: ${stepIndicators.padEnd(60)} │
217
- │ │
218
- │ ┌──────────────────────────────────────────────────────────────────────┐ │
219
- │ │ │ │
220
- │ │ {Step ${currentStep.number} Content} │ │
221
- │ │ - Input fields │ │
222
- │ │ - Instructions │ │
223
- │ │ - Validation messages │ │
224
- │ │ │ │
225
- │ └──────────────────────────────────────────────────────────────────────┘ │
226
- │ │
227
- │ ┌────────┐ ┌────────────┐ │
228
- │ │ Back │ │ Next → │ │
229
- │ └────────┘ └────────────┘ │
230
- └────────────────────────────────────────────────────────────────────────────┘
231
- `.trim();
232
- }
233
-
234
- /**
235
- * Generate file upload wireframe
236
- */
237
- function generateFileUploadWireframe(spec) {
238
- const { maxSize = '10MB', allowedTypes = ['.jpg', '.png'] } = spec;
239
-
240
- return `
241
- ┌────────────────────────────────────────────────────────────────────────────┐
242
- │ Upload File │
243
- ├────────────────────────────────────────────────────────────────────────────┤
244
- │ │
245
- │ ┌──────────────────────────────────────────────────────────────────────┐ │
246
- │ │ │ │
247
- │ │ 📷 Drag & Drop │ │
248
- │ │ │ │
249
- │ │ Drag your file here or click to browse │ │
250
- │ │ │ │
251
- │ │ Accepted: ${allowedTypes.join(', ').padEnd(30)} │ │
252
- │ │ Max size: ${maxSize.padEnd(30)} │ │
253
- │ │ │ │
254
- │ └──────────────────────────────────────────────────────────────────────┘ │
255
- │ │
256
- │ [Preview will appear here after file selection] │
257
- │ │
258
- │ ┌────────────┐ ┌────────┐ │
259
- │ │ Upload │ │ Cancel │ │
260
- │ └────────────┘ └────────┘ │
261
- └────────────────────────────────────────────────────────────────────────────┘
262
- `.trim();
263
- }
264
-
265
- /**
266
- * Generate confirm dialog wireframe
267
- */
268
- function generateConfirmDialogWireframe(spec) {
269
- const { entity, operation = 'delete' } = spec;
270
-
271
- return `
272
- ┌────────────────────────────────────────┐
273
- │ Confirm ${operation} │
274
- ├────────────────────────────────────────┤
275
- │ │
276
- │ Are you sure you want to ${operation} │
277
- │ this ${entity}? │
278
- │ │
279
- │ This action cannot be undone. │
280
- │ │
281
- │ ┌────────────┐ ┌────────┐ │
282
- │ │ ${operation} │ │ Cancel │ │
283
- │ └────────────┘ └────────┘ │
284
- └────────────────────────────────────────┘
285
- `.trim();
286
- }
287
-
288
- /**
289
- * Generate detail view wireframe
290
- */
291
- function generateDetailViewWireframe(spec) {
292
- const { entity, fields = [] } = spec;
293
-
294
- const fieldLines = fields.slice(0, 8).map(field => {
295
- const label = (field.label || field.name).padEnd(20);
296
- const value = getSampleValue(field.type).padEnd(30);
297
- return `│ ${label}: ${value} │`;
298
- }).join('\n');
299
-
300
- return `
301
- ┌────────────────────────────────────────────────────────────────────────────┐
302
- │ ${entity} Details [✏️ Edit] [🗑️ Delete]│
303
- ├────────────────────────────────────────────────────────────────────────────┤
304
- │ │
305
- ${fieldLines}
306
- │ │
307
- │ ┌────────┐ │
308
- │ │ Back │ │
309
- │ └────────┘ │
310
- └────────────────────────────────────────────────────────────────────────────┘
311
- `.trim();
312
- }
313
-
314
- /**
315
- * Generate generic wireframe
316
- */
317
- function generateGenericWireframe(spec) {
318
- const { entity = 'Component', type = 'generic' } = spec;
319
-
320
- return `
321
- ┌────────────────────────────────────────────────────────────────────────────┐
322
- │ ${entity} (${type}) │
323
- ├────────────────────────────────────────────────────────────────────────────┤
324
- │ │
325
- │ [Component content will be defined based on requirements] │
326
- │ │
327
- │ - Feature 1 │
328
- │ - Feature 2 │
329
- │ - Feature 3 │
330
- │ │
331
- └────────────────────────────────────────────────────────────────────────────┘
332
- `.trim();
333
- }
334
-
335
- /**
336
- * Generate complete UI mockup set
337
- */
338
- export function generateCompleteMockupSet(uiNeeds) {
339
- const mockups = {};
340
-
341
- for (const need of uiNeeds) {
342
- const key = `${need.type}-${need.entity || need.operation || 'generic'}`;
343
- mockups[key] = generateWireframe(need);
344
- }
345
-
346
- return mockups;
347
- }
348
-
349
- /**
350
- * Format mockups for markdown output
351
- */
352
- export function formatMockupsForMarkdown(mockups) {
353
- const sections = [];
354
-
355
- for (const [key, wireframe] of Object.entries(mockups)) {
356
- const [type, entity] = key.split('-');
357
- sections.push(`### ${entity} - ${type.toUpperCase()}`);
358
- sections.push('');
359
- sections.push('```');
360
- sections.push(wireframe);
361
- sections.push('```');
362
- sections.push('');
363
- }
364
-
365
- return sections.join('\n');
366
- }
1
+ /**
2
+ * Mockup Generator
3
+ *
4
+ * Generates high-quality ASCII wireframes for UI components.
5
+ * Used in FASE 1.5: UI/UX Design (conception phase).
6
+ *
7
+ * MORPH-SPEC 3.0
8
+ */
9
+
10
+ /**
11
+ * Generate wireframe based on component spec
12
+ * @param {Object} componentSpec - Component specification
13
+ * @returns {string} ASCII wireframe
14
+ */
15
+ export function generateWireframe(componentSpec) {
16
+ switch (componentSpec.type) {
17
+ case 'form':
18
+ return generateFormWireframe(componentSpec);
19
+ case 'list':
20
+ case 'data-grid':
21
+ return generateListWireframe(componentSpec);
22
+ case 'dashboard':
23
+ return generateDashboardWireframe(componentSpec);
24
+ case 'wizard':
25
+ return generateWizardWireframe(componentSpec);
26
+ case 'file-upload':
27
+ return generateFileUploadWireframe(componentSpec);
28
+ case 'confirm-dialog':
29
+ return generateConfirmDialogWireframe(componentSpec);
30
+ case 'detail-view':
31
+ return generateDetailViewWireframe(componentSpec);
32
+ default:
33
+ return generateGenericWireframe(componentSpec);
34
+ }
35
+ }
36
+
37
+ /**
38
+ * Generate form wireframe
39
+ */
40
+ function generateFormWireframe(spec) {
41
+ const { entity, operation = 'create', fields = [] } = spec;
42
+ const title = operation === 'create' ? `Create ${entity}` : `Edit ${entity}`;
43
+
44
+ const maxLabelLength = Math.max(...fields.map(f => (f.label || f.name).length), 15);
45
+ const fieldWidth = 40;
46
+ const totalWidth = maxLabelLength + fieldWidth + 10;
47
+
48
+ const fieldLines = fields.map(field => {
49
+ const label = (field.label || field.name).padEnd(maxLabelLength);
50
+ const inputType = getInputType(field.type);
51
+ const required = field.isRequired ? '*' : ' ';
52
+
53
+ return `│ ${required} ${label} ${inputType.padEnd(fieldWidth)} │`;
54
+ }).join('\n');
55
+
56
+ return `
57
+ ┌${'─'.repeat(totalWidth)}┐
58
+ │ ${title.padEnd(totalWidth - 4)} │
59
+ ├${'─'.repeat(totalWidth)}┤
60
+ │${' '.repeat(totalWidth)}│
61
+ ${fieldLines}
62
+ │${' '.repeat(totalWidth)}│
63
+ │ ┌──────────┐ ┌────────┐${' '.repeat(totalWidth - 34)}│
64
+ │ │ ${operation === 'create' ? 'Create' : 'Save'} │ │ Cancel │${' '.repeat(totalWidth - 34)}│
65
+ │ └──────────┘ └────────┘${' '.repeat(totalWidth - 34)}│
66
+ └${'─'.repeat(totalWidth)}┘
67
+
68
+ Legend: * = Required field
69
+ `.trim();
70
+ }
71
+
72
+ /**
73
+ * Get input type representation
74
+ */
75
+ function getInputType(type) {
76
+ if (!type) return '[_________________]';
77
+
78
+ const lower = type.toLowerCase();
79
+
80
+ if (lower.includes('string') || lower.includes('text')) {
81
+ return '[_________________]';
82
+ } else if (lower.includes('int') || lower.includes('decimal') || lower.includes('number')) {
83
+ return '[______] (number)';
84
+ } else if (lower.includes('date') || lower.includes('datetime')) {
85
+ return '[____/____/____] 📅';
86
+ } else if (lower.includes('bool')) {
87
+ return '☐ Yes ☐ No';
88
+ } else if (lower.includes('enum') || lower.includes('status') || lower.includes('type')) {
89
+ return '[Select option ▼]';
90
+ } else if (lower.includes('email')) {
91
+ return '[___@___.___]';
92
+ } else if (lower.includes('url')) {
93
+ return '[https://____]';
94
+ } else {
95
+ return '[_________________]';
96
+ }
97
+ }
98
+
99
+ /**
100
+ * Generate list/grid wireframe
101
+ */
102
+ function generateListWireframe(spec) {
103
+ const { entity, fields = [], features = {} } = spec;
104
+ const title = `${entity} List`;
105
+
106
+ const headers = fields.slice(0, 5).map(f => (f.label || f.name).substring(0, 15).padEnd(15));
107
+ const headerLine = headers.join(' │ ');
108
+
109
+ const sampleRow = fields.slice(0, 5).map(f => {
110
+ const sample = getSampleValue(f.type);
111
+ return sample.substring(0, 15).padEnd(15);
112
+ }).join(' │ ');
113
+
114
+ const totalWidth = headers.length * 16 + headers.length - 1 + 12; // +12 for actions
115
+
116
+ return `
117
+ ┌${'─'.repeat(totalWidth + 4)}┐
118
+ │ ${title.padEnd(totalWidth - 20)} [+ New] [⚙ Filters] │
119
+ ├${'─'.repeat(totalWidth + 4)}┤
120
+ │ ${headerLine} │ Actions │
121
+ ├${'─'.repeat(totalWidth + 4)}┤
122
+ │ ${sampleRow} │ ✏️ 🗑️ │
123
+ │ ${sampleRow} │ ✏️ 🗑️ │
124
+ │ ${sampleRow} │ ✏️ 🗑️ │
125
+ ${features.pagination !== false ? `├${'─'.repeat(totalWidth + 4)}┤
126
+ │ ◀ 1 2 3 ... 10 ▶${' '.repeat(totalWidth - 40)}Showing 1-10 of 47 │` : ''}
127
+ └${'─'.repeat(totalWidth + 4)}┘
128
+
129
+ ${features.filtering !== false ? '\nFeatures: Search, Filter, Sort' : ''}
130
+ ${features.selection !== false ? 'Selection: Multi-select with checkboxes' : ''}
131
+ `.trim();
132
+ }
133
+
134
+ /**
135
+ * Get sample value for field type
136
+ */
137
+ function getSampleValue(type) {
138
+ if (!type) return 'Sample Value';
139
+
140
+ const lower = type.toLowerCase();
141
+
142
+ if (lower.includes('name')) return 'John Doe';
143
+ if (lower.includes('email')) return 'user@example.com';
144
+ if (lower.includes('phone')) return '(555) 123-4567';
145
+ if (lower.includes('date')) return '2025-01-17';
146
+ if (lower.includes('status')) return 'Active';
147
+ if (lower.includes('amount') || lower.includes('price')) return '$99.99';
148
+ if (lower.includes('quantity') || lower.includes('count')) return '42';
149
+ if (lower.includes('bool')) return 'Yes';
150
+
151
+ return 'Sample';
152
+ }
153
+
154
+ /**
155
+ * Generate dashboard wireframe
156
+ */
157
+ function generateDashboardWireframe(spec) {
158
+ const { widgets = [] } = spec;
159
+
160
+ const hasStats = widgets.some(w => w.type === 'stat-card');
161
+ const hasChart = widgets.some(w => w.type === 'chart');
162
+ const hasTable = widgets.some(w => w.type === 'data-table');
163
+
164
+ return `
165
+ ┌────────────────────────────────────────────────────────────────────────────┐
166
+ │ Dashboard Overview [User Icon] ▼ │
167
+ ├────────────────────────────────────────────────────────────────────────────┤
168
+ │ │
169
+ ${hasStats ? `│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
170
+ │ │ Total Sales │ │ New Orders │ │ Revenue │ │
171
+ │ │ $125,430 │ │ 47 │ │ +12.5% │ │
172
+ │ │ +8.2% ↑ │ │ +5 today │ │ This month │ │
173
+ │ └──────────────┘ └──────────────┘ └──────────────┘ │
174
+ │ │` : ''}
175
+ ${hasChart ? `│ ┌────────────────────────────────────────────────────────────────┐ │
176
+ │ │ Sales Trend (Last 30 Days) │ │
177
+ │ │ │ │
178
+ │ │ $ ╭─╮ │ │
179
+ │ │ │ │ ╭─╮ │ │
180
+ │ │ │ │ ╭─╯ ╰─╮ ╭─╮ │ │
181
+ │ │ ────┴─┴───┴─────┴───┴─┴───────────────────────────────────── │ │
182
+ │ │ Week 1 Week 2 Week 3 Week 4 │ │
183
+ │ └────────────────────────────────────────────────────────────────┘ │
184
+ │ │` : ''}
185
+ ${hasTable ? `│ ┌────────────────────────────────────────────────────────────────┐ │
186
+ │ │ Recent Orders [View All →] │ │
187
+ │ ├────────────────────────────────────────────────────────────────┤ │
188
+ │ │ Order # Customer Amount Status Actions │ │
189
+ │ ├────────────────────────────────────────────────────────────────┤ │
190
+ │ │ #1234 John Doe $99.99 Pending 👁️ ✏️ │ │
191
+ │ │ #1233 Jane Smith $149.99 Completed 👁️ ✏️ │ │
192
+ │ │ #1232 Bob Johnson $79.99 Shipped 👁️ ✏️ │ │
193
+ │ └────────────────────────────────────────────────────────────────┘ │` : ''}
194
+ │ │
195
+ └────────────────────────────────────────────────────────────────────────────┘
196
+ `.trim();
197
+ }
198
+
199
+ /**
200
+ * Generate wizard wireframe
201
+ */
202
+ function generateWizardWireframe(spec) {
203
+ const { steps = [] } = spec;
204
+ const currentStep = steps[0] || { number: 1, title: 'Step 1' };
205
+
206
+ const stepIndicators = steps.map((step, i) => {
207
+ const isCurrent = i === 0;
208
+ return isCurrent ? `● ${step.number}` : `○ ${step.number}`;
209
+ }).join(' ── ');
210
+
211
+ return `
212
+ ┌────────────────────────────────────────────────────────────────────────────┐
213
+ │ ${currentStep.title.padEnd(70)} │
214
+ ├────────────────────────────────────────────────────────────────────────────┤
215
+ │ │
216
+ │ Progress: ${stepIndicators.padEnd(60)} │
217
+ │ │
218
+ │ ┌──────────────────────────────────────────────────────────────────────┐ │
219
+ │ │ │ │
220
+ │ │ {Step ${currentStep.number} Content} │ │
221
+ │ │ - Input fields │ │
222
+ │ │ - Instructions │ │
223
+ │ │ - Validation messages │ │
224
+ │ │ │ │
225
+ │ └──────────────────────────────────────────────────────────────────────┘ │
226
+ │ │
227
+ │ ┌────────┐ ┌────────────┐ │
228
+ │ │ Back │ │ Next → │ │
229
+ │ └────────┘ └────────────┘ │
230
+ └────────────────────────────────────────────────────────────────────────────┘
231
+ `.trim();
232
+ }
233
+
234
+ /**
235
+ * Generate file upload wireframe
236
+ */
237
+ function generateFileUploadWireframe(spec) {
238
+ const { maxSize = '10MB', allowedTypes = ['.jpg', '.png'] } = spec;
239
+
240
+ return `
241
+ ┌────────────────────────────────────────────────────────────────────────────┐
242
+ │ Upload File │
243
+ ├────────────────────────────────────────────────────────────────────────────┤
244
+ │ │
245
+ │ ┌──────────────────────────────────────────────────────────────────────┐ │
246
+ │ │ │ │
247
+ │ │ 📷 Drag & Drop │ │
248
+ │ │ │ │
249
+ │ │ Drag your file here or click to browse │ │
250
+ │ │ │ │
251
+ │ │ Accepted: ${allowedTypes.join(', ').padEnd(30)} │ │
252
+ │ │ Max size: ${maxSize.padEnd(30)} │ │
253
+ │ │ │ │
254
+ │ └──────────────────────────────────────────────────────────────────────┘ │
255
+ │ │
256
+ │ [Preview will appear here after file selection] │
257
+ │ │
258
+ │ ┌────────────┐ ┌────────┐ │
259
+ │ │ Upload │ │ Cancel │ │
260
+ │ └────────────┘ └────────┘ │
261
+ └────────────────────────────────────────────────────────────────────────────┘
262
+ `.trim();
263
+ }
264
+
265
+ /**
266
+ * Generate confirm dialog wireframe
267
+ */
268
+ function generateConfirmDialogWireframe(spec) {
269
+ const { entity, operation = 'delete' } = spec;
270
+
271
+ return `
272
+ ┌────────────────────────────────────────┐
273
+ │ Confirm ${operation} │
274
+ ├────────────────────────────────────────┤
275
+ │ │
276
+ │ Are you sure you want to ${operation} │
277
+ │ this ${entity}? │
278
+ │ │
279
+ │ This action cannot be undone. │
280
+ │ │
281
+ │ ┌────────────┐ ┌────────┐ │
282
+ │ │ ${operation} │ │ Cancel │ │
283
+ │ └────────────┘ └────────┘ │
284
+ └────────────────────────────────────────┘
285
+ `.trim();
286
+ }
287
+
288
+ /**
289
+ * Generate detail view wireframe
290
+ */
291
+ function generateDetailViewWireframe(spec) {
292
+ const { entity, fields = [] } = spec;
293
+
294
+ const fieldLines = fields.slice(0, 8).map(field => {
295
+ const label = (field.label || field.name).padEnd(20);
296
+ const value = getSampleValue(field.type).padEnd(30);
297
+ return `│ ${label}: ${value} │`;
298
+ }).join('\n');
299
+
300
+ return `
301
+ ┌────────────────────────────────────────────────────────────────────────────┐
302
+ │ ${entity} Details [✏️ Edit] [🗑️ Delete]│
303
+ ├────────────────────────────────────────────────────────────────────────────┤
304
+ │ │
305
+ ${fieldLines}
306
+ │ │
307
+ │ ┌────────┐ │
308
+ │ │ Back │ │
309
+ │ └────────┘ │
310
+ └────────────────────────────────────────────────────────────────────────────┘
311
+ `.trim();
312
+ }
313
+
314
+ /**
315
+ * Generate generic wireframe
316
+ */
317
+ function generateGenericWireframe(spec) {
318
+ const { entity = 'Component', type = 'generic' } = spec;
319
+
320
+ return `
321
+ ┌────────────────────────────────────────────────────────────────────────────┐
322
+ │ ${entity} (${type}) │
323
+ ├────────────────────────────────────────────────────────────────────────────┤
324
+ │ │
325
+ │ [Component content will be defined based on requirements] │
326
+ │ │
327
+ │ - Feature 1 │
328
+ │ - Feature 2 │
329
+ │ - Feature 3 │
330
+ │ │
331
+ └────────────────────────────────────────────────────────────────────────────┘
332
+ `.trim();
333
+ }
334
+
335
+ /**
336
+ * Generate complete UI mockup set
337
+ */
338
+ export function generateCompleteMockupSet(uiNeeds) {
339
+ const mockups = {};
340
+
341
+ for (const need of uiNeeds) {
342
+ const key = `${need.type}-${need.entity || need.operation || 'generic'}`;
343
+ mockups[key] = generateWireframe(need);
344
+ }
345
+
346
+ return mockups;
347
+ }
348
+
349
+ /**
350
+ * Format mockups for markdown output
351
+ */
352
+ export function formatMockupsForMarkdown(mockups) {
353
+ const sections = [];
354
+
355
+ for (const [key, wireframe] of Object.entries(mockups)) {
356
+ const [type, entity] = key.split('-');
357
+ sections.push(`### ${entity} - ${type.toUpperCase()}`);
358
+ sections.push('');
359
+ sections.push('```');
360
+ sections.push(wireframe);
361
+ sections.push('```');
362
+ sections.push('');
363
+ }
364
+
365
+ return sections.join('\n');
366
+ }