@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,298 +1,298 @@
1
- /**
2
- * MORPH-SPEC Design System Generator Library
3
- *
4
- * Reads ui-design-system.md and generates:
5
- * - wwwroot/css/design-system.css (CSS variables)
6
- * - Themes/FluentDesignTheme.cs (Fluent UI theme)
7
- * - Themes/MudTheme.cs (MudBlazor theme)
8
- *
9
- * Used both by CLI commands and internal automation.
10
- */
11
-
12
- import { readFileSync, existsSync } from 'fs';
13
-
14
- // ============================================================================
15
- // Parsing Functions
16
- // ============================================================================
17
-
18
- /**
19
- * Parse colors from markdown
20
- * @param {string} markdown - Markdown content
21
- * @returns {Object} Colors object with primary, secondary, neutral, semantic
22
- */
23
- export function parseColors(markdown) {
24
- const colors = { primary: {}, secondary: {}, neutral: {}, semantic: {} };
25
-
26
- // Match color definitions like: - **Primary 500** (`#...`) - ...
27
- const colorRegex = /(?:^|\n)[-*]\s+\*\*([^*]+)\*\*[^\(]*\(`(#[0-9A-Fa-f]{6})`\)/gm;
28
-
29
- let match;
30
- while ((match = colorRegex.exec(markdown)) !== null) {
31
- const [, name, hex] = match;
32
- const cleanName = name.trim().toLowerCase().replace(/\s+/g, '-');
33
-
34
- if (name.includes('Primary')) {
35
- const variant = name.match(/\d+/)?.[0] || 'default';
36
- colors.primary[variant] = hex;
37
- } else if (name.includes('Secondary')) {
38
- const variant = name.match(/\d+/)?.[0] || 'default';
39
- colors.secondary[variant] = hex;
40
- } else if (name.includes('Neutral') || name.includes('Gray')) {
41
- const variant = name.match(/\d+/)?.[0] || 'default';
42
- colors.neutral[variant] = hex;
43
- } else if (name.includes('Success') || name.includes('Error') || name.includes('Warning') || name.includes('Info')) {
44
- const type = name.toLowerCase().replace(/\s+/g, '-');
45
- colors.semantic[type] = hex;
46
- }
47
- }
48
-
49
- return colors;
50
- }
51
-
52
- /**
53
- * Parse typography from markdown
54
- * @param {string} markdown - Markdown content
55
- * @returns {Object} Typography object with fontFamily, fontSize, fontWeight, lineHeight
56
- */
57
- export function parseTypography(markdown) {
58
- const typography = { fontFamily: {}, fontSize: {}, fontWeight: {}, lineHeight: {} };
59
-
60
- // Match font family
61
- const fontFamilyRegex = /(?:font[- ]?family|typeface)[:\s]+([^\n]+)/gi;
62
- const fontMatch = fontFamilyRegex.exec(markdown);
63
- if (fontMatch) {
64
- typography.fontFamily.primary = fontMatch[1].trim();
65
- }
66
-
67
- // Match font sizes (but exclude spacing-related)
68
- const fontSizeRegex = /(?:^|\n)[-*]\s+\*\*([^*]+)\*\*[^:]*:\s*(\d+(?:\.\d+)?(?:rem|px|em))/gm;
69
- let match;
70
- while ((match = fontSizeRegex.exec(markdown)) !== null) {
71
- const [, name, size] = match;
72
- const lowerName = name.toLowerCase();
73
- // Skip if it's spacing-related
74
- if (lowerName.includes('spacing') || lowerName.includes('gap') || lowerName.includes('margin') || lowerName.includes('padding')) {
75
- continue;
76
- }
77
- const cleanName = name.trim().toLowerCase().replace(/\s+/g, '-');
78
- typography.fontSize[cleanName] = size;
79
- }
80
-
81
- return typography;
82
- }
83
-
84
- /**
85
- * Parse spacing from markdown
86
- * @param {string} markdown - Markdown content
87
- * @returns {Object} Spacing object with spacing values
88
- */
89
- export function parseSpacing(markdown) {
90
- const spacing = {};
91
-
92
- // Match spacing definitions
93
- const spacingRegex = /(?:^|\n)[-*]\s+\*\*([^*]+)\*\*[^:]*:\s*(\d+(?:\.\d+)?(?:rem|px|em))/gm;
94
- let match;
95
- while ((match = spacingRegex.exec(markdown)) !== null) {
96
- const [, name, value] = match;
97
- if (name.toLowerCase().includes('spacing') || name.toLowerCase().includes('gap') || name.toLowerCase().includes('margin') || name.toLowerCase().includes('padding')) {
98
- const cleanName = name.trim().toLowerCase().replace(/\s+/g, '-');
99
- spacing[cleanName] = value;
100
- }
101
- }
102
-
103
- return spacing;
104
- }
105
-
106
- /**
107
- * Parse all design system properties from markdown
108
- * @param {string} markdownPath - Path to ui-design-system.md file
109
- * @returns {Object} Parsed design system with colors, typography, spacing
110
- */
111
- export function parseDesignSystem(markdownPath) {
112
- if (!existsSync(markdownPath)) {
113
- throw new Error(`File not found: ${markdownPath}`);
114
- }
115
-
116
- const markdown = readFileSync(markdownPath, 'utf-8');
117
-
118
- return {
119
- colors: parseColors(markdown),
120
- typography: parseTypography(markdown),
121
- spacing: parseSpacing(markdown)
122
- };
123
- }
124
-
125
- // ============================================================================
126
- // Generation Functions
127
- // ============================================================================
128
-
129
- /**
130
- * Generate CSS variables file
131
- * @param {Object} colors - Colors object
132
- * @param {Object} typography - Typography object
133
- * @param {Object} spacing - Spacing object
134
- * @returns {string} CSS content
135
- */
136
- export function generateCSS(colors, typography, spacing) {
137
- let css = `/* Auto-generated by MORPH-SPEC Design System Generator */\n`;
138
- css += `/* Do not edit manually - regenerate from ui-design-system.md */\n\n`;
139
- css += `:root {\n`;
140
-
141
- // Colors
142
- if (Object.keys(colors.primary).length > 0) {
143
- css += ` /* Primary Colors */\n`;
144
- Object.entries(colors.primary).forEach(([variant, hex]) => {
145
- css += ` --color-primary-${variant}: ${hex};\n`;
146
- });
147
- css += `\n`;
148
- }
149
-
150
- if (Object.keys(colors.secondary).length > 0) {
151
- css += ` /* Secondary Colors */\n`;
152
- Object.entries(colors.secondary).forEach(([variant, hex]) => {
153
- css += ` --color-secondary-${variant}: ${hex};\n`;
154
- });
155
- css += `\n`;
156
- }
157
-
158
- if (Object.keys(colors.neutral).length > 0) {
159
- css += ` /* Neutral Colors */\n`;
160
- Object.entries(colors.neutral).forEach(([variant, hex]) => {
161
- css += ` --color-neutral-${variant}: ${hex};\n`;
162
- });
163
- css += `\n`;
164
- }
165
-
166
- if (Object.keys(colors.semantic).length > 0) {
167
- css += ` /* Semantic Colors */\n`;
168
- Object.entries(colors.semantic).forEach(([type, hex]) => {
169
- css += ` --color-${type}: ${hex};\n`;
170
- });
171
- css += `\n`;
172
- }
173
-
174
- // Typography
175
- if (typography.fontFamily.primary) {
176
- css += ` /* Typography */\n`;
177
- css += ` --font-family-primary: ${typography.fontFamily.primary};\n`;
178
- css += `\n`;
179
- }
180
-
181
- if (Object.keys(typography.fontSize).length > 0) {
182
- css += ` /* Font Sizes */\n`;
183
- Object.entries(typography.fontSize).forEach(([name, size]) => {
184
- css += ` --font-size-${name}: ${size};\n`;
185
- });
186
- css += `\n`;
187
- }
188
-
189
- // Spacing
190
- if (Object.keys(spacing).length > 0) {
191
- css += ` /* Spacing */\n`;
192
- Object.entries(spacing).forEach(([name, value]) => {
193
- css += ` --${name}: ${value};\n`;
194
- });
195
- }
196
-
197
- css += `}\n`;
198
-
199
- return css;
200
- }
201
-
202
- /**
203
- * Generate Fluent UI theme (C#)
204
- * @param {Object} colors - Colors object
205
- * @param {Object} typography - Typography object
206
- * @param {string} namespace - C# namespace (default: YourProject.Themes)
207
- * @returns {string} C# code
208
- */
209
- export function generateFluentTheme(colors, typography, namespace = 'YourProject.Themes') {
210
- const primary500 = colors.primary['500'] || '#0078d4';
211
-
212
- let csharp = `// Auto-generated by MORPH-SPEC Design System Generator\n`;
213
- csharp += `// Do not edit manually - regenerate from ui-design-system.md\n\n`;
214
- csharp += `using Microsoft.FluentUI.AspNetCore.Components;\n\n`;
215
- csharp += `namespace ${namespace};\n\n`;
216
- csharp += `public static class FluentDesignTheme\n{\n`;
217
- csharp += ` public static DesignThemePalette GetPalette()\n`;
218
- csharp += ` {\n`;
219
- csharp += ` return new DesignThemePalette\n`;
220
- csharp += ` {\n`;
221
- csharp += ` Accent = "${primary500}",\n`;
222
- csharp += ` // Add more theme properties as needed\n`;
223
- csharp += ` };\n`;
224
- csharp += ` }\n`;
225
- csharp += `}\n`;
226
-
227
- return csharp;
228
- }
229
-
230
- /**
231
- * Generate MudBlazor theme (C#)
232
- * @param {Object} colors - Colors object
233
- * @param {Object} typography - Typography object
234
- * @param {string} namespace - C# namespace (default: YourProject.Themes)
235
- * @returns {string} C# code
236
- */
237
- export function generateMudTheme(colors, typography, namespace = 'YourProject.Themes') {
238
- const primary500 = colors.primary['500'] || '#594ae2';
239
- const secondary500 = colors.secondary['500'] || '#ff4081';
240
-
241
- let csharp = `// Auto-generated by MORPH-SPEC Design System Generator\n`;
242
- csharp += `// Do not edit manually - regenerate from ui-design-system.md\n\n`;
243
- csharp += `using MudBlazor;\n\n`;
244
- csharp += `namespace ${namespace};\n\n`;
245
- csharp += `public static class MudDesignTheme\n{\n`;
246
- csharp += ` public static MudTheme GetTheme()\n`;
247
- csharp += ` {\n`;
248
- csharp += ` return new MudTheme\n`;
249
- csharp += ` {\n`;
250
- csharp += ` Palette = new PaletteLight\n`;
251
- csharp += ` {\n`;
252
- csharp += ` Primary = "${primary500}",\n`;
253
- csharp += ` Secondary = "${secondary500}",\n`;
254
- csharp += ` // Add more palette colors as needed\n`;
255
- csharp += ` }\n`;
256
- csharp += ` };\n`;
257
- csharp += ` }\n`;
258
- csharp += `}\n`;
259
-
260
- return csharp;
261
- }
262
-
263
- /**
264
- * Generate all design system files
265
- * @param {string} designSystemPath - Path to ui-design-system.md
266
- * @param {Object} options - Generation options
267
- * @param {string} options.mode - Generation mode: 'fluent', 'mud', or 'both'
268
- * @param {string} options.namespace - C# namespace
269
- * @returns {Object} Generated files content
270
- */
271
- export function generateDesignSystem(designSystemPath, options = {}) {
272
- const { mode = 'both', namespace = 'YourProject.Themes' } = options;
273
-
274
- // Parse design system
275
- const { colors, typography, spacing } = parseDesignSystem(designSystemPath);
276
-
277
- const generated = {
278
- css: generateCSS(colors, typography, spacing),
279
- stats: {
280
- primaryColors: Object.keys(colors.primary).length,
281
- neutralColors: Object.keys(colors.neutral).length,
282
- semanticColors: Object.keys(colors.semantic).length,
283
- fontSizes: Object.keys(typography.fontSize).length,
284
- spacingValues: Object.keys(spacing).length
285
- }
286
- };
287
-
288
- // Generate themes based on mode
289
- if (mode === 'fluent' || mode === 'both') {
290
- generated.fluentTheme = generateFluentTheme(colors, typography, namespace);
291
- }
292
-
293
- if (mode === 'mud' || mode === 'both') {
294
- generated.mudTheme = generateMudTheme(colors, typography, namespace);
295
- }
296
-
297
- return generated;
298
- }
1
+ /**
2
+ * MORPH-SPEC Design System Generator Library
3
+ *
4
+ * Reads ui-design-system.md and generates:
5
+ * - wwwroot/css/design-system.css (CSS variables)
6
+ * - Themes/FluentDesignTheme.cs (Fluent UI theme)
7
+ * - Themes/MudTheme.cs (MudBlazor theme)
8
+ *
9
+ * Used both by CLI commands and internal automation.
10
+ */
11
+
12
+ import { readFileSync, existsSync } from 'fs';
13
+
14
+ // ============================================================================
15
+ // Parsing Functions
16
+ // ============================================================================
17
+
18
+ /**
19
+ * Parse colors from markdown
20
+ * @param {string} markdown - Markdown content
21
+ * @returns {Object} Colors object with primary, secondary, neutral, semantic
22
+ */
23
+ export function parseColors(markdown) {
24
+ const colors = { primary: {}, secondary: {}, neutral: {}, semantic: {} };
25
+
26
+ // Match color definitions like: - **Primary 500** (`#...`) - ...
27
+ const colorRegex = /(?:^|\n)[-*]\s+\*\*([^*]+)\*\*[^\(]*\(`(#[0-9A-Fa-f]{6})`\)/gm;
28
+
29
+ let match;
30
+ while ((match = colorRegex.exec(markdown)) !== null) {
31
+ const [, name, hex] = match;
32
+ const cleanName = name.trim().toLowerCase().replace(/\s+/g, '-');
33
+
34
+ if (name.includes('Primary')) {
35
+ const variant = name.match(/\d+/)?.[0] || 'default';
36
+ colors.primary[variant] = hex;
37
+ } else if (name.includes('Secondary')) {
38
+ const variant = name.match(/\d+/)?.[0] || 'default';
39
+ colors.secondary[variant] = hex;
40
+ } else if (name.includes('Neutral') || name.includes('Gray')) {
41
+ const variant = name.match(/\d+/)?.[0] || 'default';
42
+ colors.neutral[variant] = hex;
43
+ } else if (name.includes('Success') || name.includes('Error') || name.includes('Warning') || name.includes('Info')) {
44
+ const type = name.toLowerCase().replace(/\s+/g, '-');
45
+ colors.semantic[type] = hex;
46
+ }
47
+ }
48
+
49
+ return colors;
50
+ }
51
+
52
+ /**
53
+ * Parse typography from markdown
54
+ * @param {string} markdown - Markdown content
55
+ * @returns {Object} Typography object with fontFamily, fontSize, fontWeight, lineHeight
56
+ */
57
+ export function parseTypography(markdown) {
58
+ const typography = { fontFamily: {}, fontSize: {}, fontWeight: {}, lineHeight: {} };
59
+
60
+ // Match font family
61
+ const fontFamilyRegex = /(?:font[- ]?family|typeface)[:\s]+([^\n]+)/gi;
62
+ const fontMatch = fontFamilyRegex.exec(markdown);
63
+ if (fontMatch) {
64
+ typography.fontFamily.primary = fontMatch[1].trim();
65
+ }
66
+
67
+ // Match font sizes (but exclude spacing-related)
68
+ const fontSizeRegex = /(?:^|\n)[-*]\s+\*\*([^*]+)\*\*[^:]*:\s*(\d+(?:\.\d+)?(?:rem|px|em))/gm;
69
+ let match;
70
+ while ((match = fontSizeRegex.exec(markdown)) !== null) {
71
+ const [, name, size] = match;
72
+ const lowerName = name.toLowerCase();
73
+ // Skip if it's spacing-related
74
+ if (lowerName.includes('spacing') || lowerName.includes('gap') || lowerName.includes('margin') || lowerName.includes('padding')) {
75
+ continue;
76
+ }
77
+ const cleanName = name.trim().toLowerCase().replace(/\s+/g, '-');
78
+ typography.fontSize[cleanName] = size;
79
+ }
80
+
81
+ return typography;
82
+ }
83
+
84
+ /**
85
+ * Parse spacing from markdown
86
+ * @param {string} markdown - Markdown content
87
+ * @returns {Object} Spacing object with spacing values
88
+ */
89
+ export function parseSpacing(markdown) {
90
+ const spacing = {};
91
+
92
+ // Match spacing definitions
93
+ const spacingRegex = /(?:^|\n)[-*]\s+\*\*([^*]+)\*\*[^:]*:\s*(\d+(?:\.\d+)?(?:rem|px|em))/gm;
94
+ let match;
95
+ while ((match = spacingRegex.exec(markdown)) !== null) {
96
+ const [, name, value] = match;
97
+ if (name.toLowerCase().includes('spacing') || name.toLowerCase().includes('gap') || name.toLowerCase().includes('margin') || name.toLowerCase().includes('padding')) {
98
+ const cleanName = name.trim().toLowerCase().replace(/\s+/g, '-');
99
+ spacing[cleanName] = value;
100
+ }
101
+ }
102
+
103
+ return spacing;
104
+ }
105
+
106
+ /**
107
+ * Parse all design system properties from markdown
108
+ * @param {string} markdownPath - Path to ui-design-system.md file
109
+ * @returns {Object} Parsed design system with colors, typography, spacing
110
+ */
111
+ export function parseDesignSystem(markdownPath) {
112
+ if (!existsSync(markdownPath)) {
113
+ throw new Error(`File not found: ${markdownPath}`);
114
+ }
115
+
116
+ const markdown = readFileSync(markdownPath, 'utf-8');
117
+
118
+ return {
119
+ colors: parseColors(markdown),
120
+ typography: parseTypography(markdown),
121
+ spacing: parseSpacing(markdown)
122
+ };
123
+ }
124
+
125
+ // ============================================================================
126
+ // Generation Functions
127
+ // ============================================================================
128
+
129
+ /**
130
+ * Generate CSS variables file
131
+ * @param {Object} colors - Colors object
132
+ * @param {Object} typography - Typography object
133
+ * @param {Object} spacing - Spacing object
134
+ * @returns {string} CSS content
135
+ */
136
+ export function generateCSS(colors, typography, spacing) {
137
+ let css = `/* Auto-generated by MORPH-SPEC Design System Generator */\n`;
138
+ css += `/* Do not edit manually - regenerate from ui-design-system.md */\n\n`;
139
+ css += `:root {\n`;
140
+
141
+ // Colors
142
+ if (Object.keys(colors.primary).length > 0) {
143
+ css += ` /* Primary Colors */\n`;
144
+ Object.entries(colors.primary).forEach(([variant, hex]) => {
145
+ css += ` --color-primary-${variant}: ${hex};\n`;
146
+ });
147
+ css += `\n`;
148
+ }
149
+
150
+ if (Object.keys(colors.secondary).length > 0) {
151
+ css += ` /* Secondary Colors */\n`;
152
+ Object.entries(colors.secondary).forEach(([variant, hex]) => {
153
+ css += ` --color-secondary-${variant}: ${hex};\n`;
154
+ });
155
+ css += `\n`;
156
+ }
157
+
158
+ if (Object.keys(colors.neutral).length > 0) {
159
+ css += ` /* Neutral Colors */\n`;
160
+ Object.entries(colors.neutral).forEach(([variant, hex]) => {
161
+ css += ` --color-neutral-${variant}: ${hex};\n`;
162
+ });
163
+ css += `\n`;
164
+ }
165
+
166
+ if (Object.keys(colors.semantic).length > 0) {
167
+ css += ` /* Semantic Colors */\n`;
168
+ Object.entries(colors.semantic).forEach(([type, hex]) => {
169
+ css += ` --color-${type}: ${hex};\n`;
170
+ });
171
+ css += `\n`;
172
+ }
173
+
174
+ // Typography
175
+ if (typography.fontFamily.primary) {
176
+ css += ` /* Typography */\n`;
177
+ css += ` --font-family-primary: ${typography.fontFamily.primary};\n`;
178
+ css += `\n`;
179
+ }
180
+
181
+ if (Object.keys(typography.fontSize).length > 0) {
182
+ css += ` /* Font Sizes */\n`;
183
+ Object.entries(typography.fontSize).forEach(([name, size]) => {
184
+ css += ` --font-size-${name}: ${size};\n`;
185
+ });
186
+ css += `\n`;
187
+ }
188
+
189
+ // Spacing
190
+ if (Object.keys(spacing).length > 0) {
191
+ css += ` /* Spacing */\n`;
192
+ Object.entries(spacing).forEach(([name, value]) => {
193
+ css += ` --${name}: ${value};\n`;
194
+ });
195
+ }
196
+
197
+ css += `}\n`;
198
+
199
+ return css;
200
+ }
201
+
202
+ /**
203
+ * Generate Fluent UI theme (C#)
204
+ * @param {Object} colors - Colors object
205
+ * @param {Object} typography - Typography object
206
+ * @param {string} namespace - C# namespace (default: YourProject.Themes)
207
+ * @returns {string} C# code
208
+ */
209
+ export function generateFluentTheme(colors, typography, namespace = 'YourProject.Themes') {
210
+ const primary500 = colors.primary['500'] || '#0078d4';
211
+
212
+ let csharp = `// Auto-generated by MORPH-SPEC Design System Generator\n`;
213
+ csharp += `// Do not edit manually - regenerate from ui-design-system.md\n\n`;
214
+ csharp += `using Microsoft.FluentUI.AspNetCore.Components;\n\n`;
215
+ csharp += `namespace ${namespace};\n\n`;
216
+ csharp += `public static class FluentDesignTheme\n{\n`;
217
+ csharp += ` public static DesignThemePalette GetPalette()\n`;
218
+ csharp += ` {\n`;
219
+ csharp += ` return new DesignThemePalette\n`;
220
+ csharp += ` {\n`;
221
+ csharp += ` Accent = "${primary500}",\n`;
222
+ csharp += ` // Add more theme properties as needed\n`;
223
+ csharp += ` };\n`;
224
+ csharp += ` }\n`;
225
+ csharp += `}\n`;
226
+
227
+ return csharp;
228
+ }
229
+
230
+ /**
231
+ * Generate MudBlazor theme (C#)
232
+ * @param {Object} colors - Colors object
233
+ * @param {Object} typography - Typography object
234
+ * @param {string} namespace - C# namespace (default: YourProject.Themes)
235
+ * @returns {string} C# code
236
+ */
237
+ export function generateMudTheme(colors, typography, namespace = 'YourProject.Themes') {
238
+ const primary500 = colors.primary['500'] || '#594ae2';
239
+ const secondary500 = colors.secondary['500'] || '#ff4081';
240
+
241
+ let csharp = `// Auto-generated by MORPH-SPEC Design System Generator\n`;
242
+ csharp += `// Do not edit manually - regenerate from ui-design-system.md\n\n`;
243
+ csharp += `using MudBlazor;\n\n`;
244
+ csharp += `namespace ${namespace};\n\n`;
245
+ csharp += `public static class MudDesignTheme\n{\n`;
246
+ csharp += ` public static MudTheme GetTheme()\n`;
247
+ csharp += ` {\n`;
248
+ csharp += ` return new MudTheme\n`;
249
+ csharp += ` {\n`;
250
+ csharp += ` Palette = new PaletteLight\n`;
251
+ csharp += ` {\n`;
252
+ csharp += ` Primary = "${primary500}",\n`;
253
+ csharp += ` Secondary = "${secondary500}",\n`;
254
+ csharp += ` // Add more palette colors as needed\n`;
255
+ csharp += ` }\n`;
256
+ csharp += ` };\n`;
257
+ csharp += ` }\n`;
258
+ csharp += `}\n`;
259
+
260
+ return csharp;
261
+ }
262
+
263
+ /**
264
+ * Generate all design system files
265
+ * @param {string} designSystemPath - Path to ui-design-system.md
266
+ * @param {Object} options - Generation options
267
+ * @param {string} options.mode - Generation mode: 'fluent', 'mud', or 'both'
268
+ * @param {string} options.namespace - C# namespace
269
+ * @returns {Object} Generated files content
270
+ */
271
+ export function generateDesignSystem(designSystemPath, options = {}) {
272
+ const { mode = 'both', namespace = 'YourProject.Themes' } = options;
273
+
274
+ // Parse design system
275
+ const { colors, typography, spacing } = parseDesignSystem(designSystemPath);
276
+
277
+ const generated = {
278
+ css: generateCSS(colors, typography, spacing),
279
+ stats: {
280
+ primaryColors: Object.keys(colors.primary).length,
281
+ neutralColors: Object.keys(colors.neutral).length,
282
+ semanticColors: Object.keys(colors.semantic).length,
283
+ fontSizes: Object.keys(typography.fontSize).length,
284
+ spacingValues: Object.keys(spacing).length
285
+ }
286
+ };
287
+
288
+ // Generate themes based on mode
289
+ if (mode === 'fluent' || mode === 'both') {
290
+ generated.fluentTheme = generateFluentTheme(colors, typography, namespace);
291
+ }
292
+
293
+ if (mode === 'mud' || mode === 'both') {
294
+ generated.mudTheme = generateMudTheme(colors, typography, namespace);
295
+ }
296
+
297
+ return generated;
298
+ }