@polymorphism-tech/morph-spec 2.4.0 → 3.0.0

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 (218) hide show
  1. package/CLAUDE.md +158 -26
  2. package/LICENSE +72 -72
  3. package/bin/detect-agents.js +225 -225
  4. package/bin/morph-spec.js +8 -0
  5. package/bin/render-template.js +302 -302
  6. package/bin/semantic-detect-agents.js +246 -246
  7. package/bin/validate-agents-skills.js +251 -251
  8. package/bin/validate-agents.js +69 -69
  9. package/bin/validate-phase.js +263 -263
  10. package/content/.azure/README.md +293 -293
  11. package/content/.azure/docs/azure-devops-setup.md +454 -454
  12. package/content/.azure/docs/branch-strategy.md +398 -398
  13. package/content/.azure/docs/local-development.md +515 -515
  14. package/content/.azure/pipelines/pipeline-variables.yml +34 -34
  15. package/content/.azure/pipelines/prod-pipeline.yml +319 -319
  16. package/content/.azure/pipelines/staging-pipeline.yml +234 -234
  17. package/content/.azure/pipelines/templates/build-dotnet.yml +75 -75
  18. package/content/.azure/pipelines/templates/deploy-app-service.yml +94 -94
  19. package/content/.azure/pipelines/templates/deploy-container-app.yml +120 -120
  20. package/content/.azure/pipelines/templates/infra-deploy.yml +90 -90
  21. package/content/.claude/commands/morph-archive.md +79 -79
  22. package/content/.claude/commands/morph-deploy.md +529 -0
  23. package/content/.claude/commands/morph-infra.md +209 -209
  24. package/content/.claude/commands/morph-preflight.md +227 -227
  25. package/content/.claude/commands/morph-troubleshoot.md +122 -122
  26. package/content/.claude/settings.local.json +15 -15
  27. package/content/.claude/skills/infra/azure-deploy-specialist.md +699 -0
  28. package/content/.claude/skills/level-0-meta/README.md +7 -0
  29. package/content/.claude/skills/{checklists → level-0-meta}/morph-checklist.md +117 -117
  30. package/content/.claude/skills/level-1-workflows/README.md +7 -0
  31. package/content/.claude/skills/{workflows → level-1-workflows}/morph-replicate.md +213 -213
  32. package/content/.claude/skills/{workflows → level-1-workflows}/phase-clarify.md +131 -131
  33. package/content/.claude/skills/{workflows → level-1-workflows}/phase-design.md +213 -205
  34. package/content/.claude/skills/{workflows → level-1-workflows}/phase-setup.md +106 -92
  35. package/content/.claude/skills/{workflows → level-1-workflows}/phase-tasks.md +164 -164
  36. package/content/.claude/skills/{workflows → level-1-workflows}/phase-uiux.md +169 -138
  37. package/content/.claude/skills/level-2-domains/README.md +14 -0
  38. package/content/.claude/skills/{specialists → level-2-domains/quality}/testing-specialist.md +126 -126
  39. package/content/.claude/skills/level-3-technologies/README.md +7 -0
  40. package/content/.claude/skills/level-4-patterns/README.md +7 -0
  41. package/content/.claude/skills/specialists/prompt-engineer.md +189 -0
  42. package/content/.claude/skills/specialists/seo-growth-hacker.md +320 -0
  43. package/content/.morph/.morphversion +5 -5
  44. package/content/.morph/archive/.gitkeep +25 -25
  45. package/content/.morph/config/agents.json +742 -358
  46. package/content/.morph/config/config.template.json +33 -0
  47. package/content/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +392 -392
  48. package/content/.morph/docs/workflows/enforcement-pipeline.md +668 -0
  49. package/content/.morph/examples/api-nextjs/README.md +241 -241
  50. package/content/.morph/examples/api-nextjs/contracts.ts +307 -307
  51. package/content/.morph/examples/api-nextjs/spec.md +399 -399
  52. package/content/.morph/examples/api-nextjs/tasks.md +168 -168
  53. package/content/.morph/examples/micro-saas/README.md +125 -125
  54. package/content/.morph/examples/micro-saas/contracts.cs +358 -358
  55. package/content/.morph/examples/micro-saas/decisions.md +246 -246
  56. package/content/.morph/examples/micro-saas/spec.md +236 -236
  57. package/content/.morph/examples/micro-saas/tasks.md +150 -150
  58. package/content/.morph/examples/multi-agent/README.md +309 -309
  59. package/content/.morph/examples/multi-agent/contracts.cs +433 -433
  60. package/content/.morph/examples/multi-agent/spec.md +479 -479
  61. package/content/.morph/examples/multi-agent/tasks.md +185 -185
  62. package/content/.morph/examples/scheduled-reports/decisions.md +158 -158
  63. package/content/.morph/examples/scheduled-reports/proposal.md +95 -95
  64. package/content/.morph/examples/scheduled-reports/spec.md +267 -267
  65. package/content/.morph/examples/state-v3.json +188 -188
  66. package/content/.morph/features/.gitkeep +25 -25
  67. package/content/.morph/hooks/README.md +158 -0
  68. package/content/.morph/hooks/pre-commit-all.sh +48 -48
  69. package/content/.morph/hooks/pre-commit-specs.sh +49 -49
  70. package/content/.morph/hooks/pre-commit-tests.sh +60 -60
  71. package/content/.morph/hooks/task-completed.js +73 -0
  72. package/content/.morph/hooks/teammate-idle.js +68 -0
  73. package/content/.morph/project.md +160 -160
  74. package/content/.morph/schemas/agent.schema.json +296 -296
  75. package/content/.morph/schemas/tasks.schema.json +220 -220
  76. package/content/.morph/specs/.gitkeep +20 -20
  77. package/content/.morph/standards/agent-teams-workflow.md +474 -0
  78. package/content/.morph/standards/coding.md +377 -377
  79. package/content/.morph/standards/fluent-ui-setup.md +590 -590
  80. package/content/.morph/standards/migration-guide.md +514 -514
  81. package/content/.morph/standards/passkeys-auth.md +423 -423
  82. package/content/.morph/standards/vector-search-rag.md +536 -536
  83. package/content/.morph/state.json +17 -17
  84. package/content/.morph/templates/CONTEXT-FEATURE.md +276 -0
  85. package/content/.morph/templates/CONTEXT.md +170 -0
  86. package/content/.morph/templates/FluentDesignTheme.cs +149 -149
  87. package/content/.morph/templates/MudTheme.cs +281 -281
  88. package/content/.morph/templates/clarify-questions.md +159 -159
  89. package/content/.morph/templates/component.razor +239 -239
  90. package/content/.morph/templates/contracts/Commands.cs +74 -74
  91. package/content/.morph/templates/contracts/Entities.cs +25 -25
  92. package/content/.morph/templates/contracts/Queries.cs +74 -74
  93. package/content/.morph/templates/contracts/README.md +74 -74
  94. package/content/.morph/templates/contracts.cs +217 -217
  95. package/content/.morph/templates/design-system.css +226 -226
  96. package/content/.morph/templates/infra/.dockerignore.example +89 -89
  97. package/content/.morph/templates/infra/Dockerfile.example +82 -82
  98. package/content/.morph/templates/infra/README.md +286 -286
  99. package/content/.morph/templates/infra/app-insights.bicep +63 -63
  100. package/content/.morph/templates/infra/app-service.bicep +164 -164
  101. package/content/.morph/templates/infra/azure-pipelines-deploy.yml +480 -0
  102. package/content/.morph/templates/infra/container-app-env.bicep +49 -49
  103. package/content/.morph/templates/infra/container-app.bicep +156 -156
  104. package/content/.morph/templates/infra/deploy-checklist.md +426 -426
  105. package/content/.morph/templates/infra/deploy.ps1 +229 -229
  106. package/content/.morph/templates/infra/deploy.sh +208 -208
  107. package/content/.morph/templates/infra/key-vault.bicep +91 -91
  108. package/content/.morph/templates/infra/main.bicep +189 -189
  109. package/content/.morph/templates/infra/parameters.dev.json +29 -29
  110. package/content/.morph/templates/infra/parameters.prod.json +29 -29
  111. package/content/.morph/templates/infra/parameters.staging.json +29 -29
  112. package/content/.morph/templates/infra/sql-database.bicep +103 -103
  113. package/content/.morph/templates/infra/storage.bicep +106 -106
  114. package/content/.morph/templates/integrations/asaas-client.cs +387 -387
  115. package/content/.morph/templates/integrations/asaas-webhook.cs +351 -351
  116. package/content/.morph/templates/integrations/azure-identity-config.cs +288 -288
  117. package/content/.morph/templates/integrations/clerk-config.cs +258 -258
  118. package/content/.morph/templates/job.cs +171 -171
  119. package/content/.morph/templates/migration.cs +83 -83
  120. package/content/.morph/templates/repository.cs +141 -141
  121. package/content/.morph/templates/saas/subscription.cs +347 -347
  122. package/content/.morph/templates/saas/tenant.cs +338 -338
  123. package/content/.morph/templates/service.cs +139 -139
  124. package/content/.morph/templates/sprint-status.yaml +68 -68
  125. package/content/.morph/templates/story.md +143 -143
  126. package/content/.morph/templates/test.cs +239 -239
  127. package/content/.morph/templates/ui-design-system.md +286 -286
  128. package/content/.morph/templates/ui-flows.md +336 -336
  129. package/content/.morph/templates/ui-mockups.md +133 -133
  130. package/content/.morph/test-infra/example.bicep +59 -59
  131. package/content/README.md +79 -79
  132. package/detectors/config-detector.js +223 -223
  133. package/detectors/conversation-analyzer.js +163 -163
  134. package/detectors/index.js +84 -84
  135. package/detectors/standards-generator.js +275 -275
  136. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.svg +977 -977
  137. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.svg +1048 -1048
  138. package/docs/api/scripts/collapse.js +38 -38
  139. package/docs/api/scripts/commonNav.js +28 -28
  140. package/docs/api/scripts/linenumber.js +25 -25
  141. package/docs/api/scripts/nav.js +12 -12
  142. package/docs/api/scripts/polyfill.js +3 -3
  143. package/docs/api/scripts/prettify/Apache-License-2.0.txt +202 -202
  144. package/docs/api/scripts/prettify/lang-css.js +2 -2
  145. package/docs/api/scripts/prettify/prettify.js +28 -28
  146. package/docs/api/scripts/search.js +98 -98
  147. package/docs/api/styles/jsdoc.css +776 -776
  148. package/docs/api/styles/prettify.css +80 -80
  149. package/docs/examples.md +328 -328
  150. package/docs/templates.md +418 -418
  151. package/package.json +1 -1
  152. package/scripts/postinstall.js +132 -132
  153. package/src/commands/advance-phase.js +83 -0
  154. package/src/commands/analyze-blazor-concurrency.js +193 -193
  155. package/src/commands/create-story.js +351 -351
  156. package/src/commands/deploy.js +780 -0
  157. package/src/commands/detect-agents.js +34 -6
  158. package/src/commands/detect.js +104 -104
  159. package/src/commands/generate-context.js +40 -0
  160. package/src/commands/generate.js +149 -149
  161. package/src/commands/lint-fluent.js +352 -352
  162. package/src/commands/rollback-phase.js +185 -185
  163. package/src/commands/session-summary.js +291 -291
  164. package/src/commands/shard-spec.js +224 -224
  165. package/src/commands/sprint-status.js +250 -250
  166. package/src/commands/state.js +333 -333
  167. package/src/commands/sync.js +167 -167
  168. package/src/commands/troubleshoot.js +222 -222
  169. package/src/commands/validate-blazor-state.js +210 -210
  170. package/src/commands/validate-blazor.js +156 -156
  171. package/src/commands/validate-css.js +84 -84
  172. package/src/commands/validate-phase.js +221 -221
  173. package/src/lib/blazor-concurrency-analyzer.js +288 -288
  174. package/src/lib/blazor-state-validator.js +291 -291
  175. package/src/lib/blazor-validator.js +374 -374
  176. package/src/lib/context-generator.js +513 -0
  177. package/src/lib/css-validator.js +352 -352
  178. package/src/lib/design-system-detector.js +187 -0
  179. package/src/lib/design-system-generator.js +298 -298
  180. package/src/lib/design-system-scaffolder.js +299 -0
  181. package/src/lib/hook-executor.js +256 -0
  182. package/src/lib/learning-system.js +520 -520
  183. package/src/lib/mockup-generator.js +366 -366
  184. package/src/lib/spec-validator.js +258 -0
  185. package/src/lib/standards-context-injector.js +287 -0
  186. package/src/lib/team-orchestrator.js +322 -0
  187. package/src/lib/troubleshoot-grep.js +194 -194
  188. package/src/lib/troubleshoot-index.js +144 -144
  189. package/src/lib/ui-detector.js +350 -350
  190. package/src/lib/validation-runner.js +65 -13
  191. package/src/lib/validators/architecture-validator.js +387 -387
  192. package/src/lib/validators/design-system-validator.js +231 -0
  193. package/src/lib/validators/package-validator.js +360 -360
  194. package/src/lib/validators/ui-contrast-validator.js +422 -422
  195. package/src/utils/file-copier.js +9 -1
  196. package/src/utils/logger.js +32 -32
  197. package/src/utils/version-checker.js +175 -175
  198. /package/content/.claude/skills/{checklists → level-0-meta}/code-review.md +0 -0
  199. /package/content/.claude/skills/{checklists → level-0-meta}/simulation-checklist.md +0 -0
  200. /package/content/.claude/skills/{specialists → level-2-domains/ai-agents}/ai-system-architect.md +0 -0
  201. /package/content/.claude/skills/{specialists → level-2-domains/architecture}/po-pm-advisor.md +0 -0
  202. /package/content/.claude/skills/{specialists → level-2-domains/architecture}/standards-architect.md +0 -0
  203. /package/content/.claude/skills/{specialists → level-2-domains/backend}/dotnet-senior.md +0 -0
  204. /package/content/.claude/skills/{specialists → level-2-domains/backend}/ef-modeler.md +0 -0
  205. /package/content/.claude/skills/{specialists → level-2-domains/backend}/hangfire-orchestrator.md +0 -0
  206. /package/content/.claude/skills/{specialists → level-2-domains/backend}/ms-agent-expert.md +0 -0
  207. /package/content/.claude/skills/{stacks/dotnet-blazor.md → level-2-domains/frontend/blazor-builder.md} +0 -0
  208. /package/content/.claude/skills/{stacks/dotnet-nextjs.md → level-2-domains/frontend/nextjs-expert.md} +0 -0
  209. /package/content/.claude/skills/{specialists → level-2-domains/frontend}/ui-ux-designer.md +0 -0
  210. /package/content/.claude/skills/{specialists → level-2-domains/infrastructure}/azure-architect.md +0 -0
  211. /package/content/.claude/skills/{infra → level-2-domains/infrastructure}/bicep-architect.md +0 -0
  212. /package/content/.claude/skills/{infra → level-2-domains/infrastructure}/container-specialist.md +0 -0
  213. /package/content/.claude/skills/{infra → level-2-domains/infrastructure}/devops-engineer.md +0 -0
  214. /package/content/.claude/skills/{integrations → level-2-domains/integrations}/asaas-financial.md +0 -0
  215. /package/content/.claude/skills/{integrations → level-2-domains/integrations}/azure-identity.md +0 -0
  216. /package/content/.claude/skills/{integrations → level-2-domains/integrations}/clerk-auth.md +0 -0
  217. /package/content/.claude/skills/{integrations → level-2-domains/integrations}/resend-email.md +0 -0
  218. /package/content/.claude/skills/{specialists → level-2-domains/quality}/code-analyzer.md +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
+ }