@salesforce/b2c-dx-mcp 2.0.0 → 2.1.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 (124) hide show
  1. package/README.md +15 -62
  2. package/dist/commands/mcp.d.ts +1 -0
  3. package/dist/commands/mcp.js +41 -9
  4. package/dist/registry.d.ts +3 -4
  5. package/dist/registry.js +7 -14
  6. package/dist/server.d.ts +1 -1
  7. package/dist/server.js +3 -1
  8. package/dist/services.d.ts +21 -1
  9. package/dist/services.js +39 -6
  10. package/dist/tools/adapter.d.ts +18 -2
  11. package/dist/tools/adapter.js +49 -10
  12. package/dist/tools/cartridges/index.js +16 -22
  13. package/dist/tools/diagnostics/config-inspect.js +4 -8
  14. package/dist/tools/diagnostics/debug-capture-at-breakpoint.js +3 -9
  15. package/dist/tools/diagnostics/debug-list-sessions.js +1 -0
  16. package/dist/tools/diagnostics/debug-start-session.js +16 -9
  17. package/dist/tools/diagnostics/debug-wait-for-stop.js +1 -3
  18. package/dist/tools/diagnostics/log-watch-registry.d.ts +3 -0
  19. package/dist/tools/diagnostics/log-watch-registry.js +1 -0
  20. package/dist/tools/diagnostics/logs-get-recent.js +2 -5
  21. package/dist/tools/diagnostics/logs-list-files.js +1 -1
  22. package/dist/tools/diagnostics/logs-watch-list.js +1 -0
  23. package/dist/tools/diagnostics/logs-watch-start.js +10 -10
  24. package/dist/tools/diagnostics/mrt-log-watch-registry.d.ts +3 -0
  25. package/dist/tools/diagnostics/mrt-log-watch-registry.js +0 -0
  26. package/dist/tools/diagnostics/mrt-logs-watch-list.js +1 -0
  27. package/dist/tools/diagnostics/mrt-logs-watch-poll.js +2 -5
  28. package/dist/tools/diagnostics/mrt-logs-watch-start.js +9 -8
  29. package/dist/tools/diagnostics/session-registry.d.ts +3 -0
  30. package/dist/tools/diagnostics/session-registry.js +2 -1
  31. package/dist/tools/docs/docs-list.js +4 -6
  32. package/dist/tools/docs/docs-read.js +2 -9
  33. package/dist/tools/docs/docs-schema-list.js +1 -1
  34. package/dist/tools/docs/docs-schema-read.js +2 -3
  35. package/dist/tools/docs/docs-schema-search.js +2 -2
  36. package/dist/tools/docs/docs-search.js +3 -9
  37. package/dist/tools/docs/storefront.js +3 -3
  38. package/dist/tools/docs/topics.js +3 -1
  39. package/dist/tools/index.d.ts +0 -1
  40. package/dist/tools/index.js +0 -1
  41. package/dist/tools/mrt/index.js +6 -2
  42. package/dist/tools/project-context.d.ts +38 -11
  43. package/dist/tools/project-context.js +32 -15
  44. package/dist/tools/pwav3/pwa-kit-development-guidelines.js +3 -43
  45. package/dist/tools/scapi/metrics-get.js +5 -23
  46. package/dist/tools/scapi/scapi-custom-api-generate-scaffold.d.ts +4 -0
  47. package/dist/tools/scapi/scapi-custom-api-generate-scaffold.js +29 -14
  48. package/dist/tools/scapi/scapi-custom-apis-get-status.js +3 -14
  49. package/dist/tools/scapi/scapi-schemas-list.js +11 -11
  50. package/dist/utils/constants.d.ts +2 -13
  51. package/dist/utils/constants.js +1 -20
  52. package/oclif.manifest.json +2 -2
  53. package/package.json +5 -5
  54. package/content/sfnext/auth.md +0 -62
  55. package/content/sfnext/components.md +0 -123
  56. package/content/sfnext/config.md +0 -180
  57. package/content/sfnext/data-fetching.md +0 -323
  58. package/content/sfnext/extensions.md +0 -80
  59. package/content/sfnext/i18n.md +0 -121
  60. package/content/sfnext/page-designer.md +0 -78
  61. package/content/sfnext/performance.md +0 -80
  62. package/content/sfnext/pitfalls.md +0 -141
  63. package/content/sfnext/quick-reference.md +0 -226
  64. package/content/sfnext/state-management.md +0 -75
  65. package/content/sfnext/styling.md +0 -51
  66. package/content/sfnext/testing.md +0 -232
  67. package/dist/tools/storefrontnext/figma/figma-to-component/figma-url-parser.d.ts +0 -24
  68. package/dist/tools/storefrontnext/figma/figma-to-component/figma-url-parser.js +0 -53
  69. package/dist/tools/storefrontnext/figma/figma-to-component/index.d.ts +0 -45
  70. package/dist/tools/storefrontnext/figma/figma-to-component/index.js +0 -332
  71. package/dist/tools/storefrontnext/figma/generate-component/decision.d.ts +0 -40
  72. package/dist/tools/storefrontnext/figma/generate-component/decision.js +0 -312
  73. package/dist/tools/storefrontnext/figma/generate-component/formatter.d.ts +0 -9
  74. package/dist/tools/storefrontnext/figma/generate-component/formatter.js +0 -92
  75. package/dist/tools/storefrontnext/figma/generate-component/index.d.ts +0 -117
  76. package/dist/tools/storefrontnext/figma/generate-component/index.js +0 -102
  77. package/dist/tools/storefrontnext/figma/map-tokens/css-parser.d.ts +0 -71
  78. package/dist/tools/storefrontnext/figma/map-tokens/css-parser.js +0 -260
  79. package/dist/tools/storefrontnext/figma/map-tokens/index.d.ts +0 -64
  80. package/dist/tools/storefrontnext/figma/map-tokens/index.js +0 -242
  81. package/dist/tools/storefrontnext/figma/map-tokens/token-matcher.d.ts +0 -65
  82. package/dist/tools/storefrontnext/figma/map-tokens/token-matcher.js +0 -268
  83. package/dist/tools/storefrontnext/index.d.ts +0 -30
  84. package/dist/tools/storefrontnext/index.js +0 -28
  85. package/dist/tools/storefrontnext/page-designer-decorator/analyzer.d.ts +0 -169
  86. package/dist/tools/storefrontnext/page-designer-decorator/analyzer.js +0 -567
  87. package/dist/tools/storefrontnext/page-designer-decorator/index.d.ts +0 -259
  88. package/dist/tools/storefrontnext/page-designer-decorator/index.js +0 -622
  89. package/dist/tools/storefrontnext/page-designer-decorator/rules/1-mode-selection.d.ts +0 -8
  90. package/dist/tools/storefrontnext/page-designer-decorator/rules/1-mode-selection.js +0 -65
  91. package/dist/tools/storefrontnext/page-designer-decorator/rules/2a-auto-mode.d.ts +0 -13
  92. package/dist/tools/storefrontnext/page-designer-decorator/rules/2a-auto-mode.js +0 -87
  93. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-0-interactive-overview.d.ts +0 -4
  94. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-0-interactive-overview.js +0 -55
  95. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-1-interactive-analyze.d.ts +0 -22
  96. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-1-interactive-analyze.js +0 -109
  97. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-2-interactive-select-props.d.ts +0 -21
  98. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-2-interactive-select-props.js +0 -60
  99. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-3-interactive-configure-attrs.d.ts +0 -27
  100. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-3-interactive-configure-attrs.js +0 -68
  101. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-4-interactive-configure-regions.d.ts +0 -4
  102. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-4-interactive-configure-regions.js +0 -65
  103. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-5-interactive-confirm-generation.d.ts +0 -11
  104. package/dist/tools/storefrontnext/page-designer-decorator/rules/2b-5-interactive-confirm-generation.js +0 -92
  105. package/dist/tools/storefrontnext/page-designer-decorator/rules.d.ts +0 -51
  106. package/dist/tools/storefrontnext/page-designer-decorator/rules.js +0 -70
  107. package/dist/tools/storefrontnext/page-designer-decorator/templates/decorator-generator.d.ts +0 -116
  108. package/dist/tools/storefrontnext/page-designer-decorator/templates/decorator-generator.js +0 -350
  109. package/dist/tools/storefrontnext/sfnext-development-guidelines.d.ts +0 -9
  110. package/dist/tools/storefrontnext/sfnext-development-guidelines.js +0 -141
  111. package/dist/tools/storefrontnext/site-theming/color-contrast.d.ts +0 -92
  112. package/dist/tools/storefrontnext/site-theming/color-contrast.js +0 -186
  113. package/dist/tools/storefrontnext/site-theming/color-mapping.d.ts +0 -16
  114. package/dist/tools/storefrontnext/site-theming/color-mapping.js +0 -131
  115. package/dist/tools/storefrontnext/site-theming/guidance-merger.d.ts +0 -11
  116. package/dist/tools/storefrontnext/site-theming/guidance-merger.js +0 -78
  117. package/dist/tools/storefrontnext/site-theming/index.d.ts +0 -14
  118. package/dist/tools/storefrontnext/site-theming/index.js +0 -128
  119. package/dist/tools/storefrontnext/site-theming/response-builder.d.ts +0 -16
  120. package/dist/tools/storefrontnext/site-theming/response-builder.js +0 -316
  121. package/dist/tools/storefrontnext/site-theming/theming-store.d.ts +0 -64
  122. package/dist/tools/storefrontnext/site-theming/theming-store.js +0 -417
  123. package/dist/tools/storefrontnext/site-theming/types.d.ts +0 -36
  124. package/dist/tools/storefrontnext/site-theming/types.js +0 -7
@@ -1,259 +0,0 @@
1
- import { z } from 'zod';
2
- import type { McpTool } from '../../../utils/index.js';
3
- import type { Services } from '../../../services.js';
4
- import { type ProjectContextInput } from '../../project-context.js';
5
- export declare const pageDesignerDecoratorSchema: z.ZodObject<{
6
- projectDirectory: z.ZodOptional<z.ZodString>;
7
- configPath: z.ZodOptional<z.ZodString>;
8
- component: z.ZodString;
9
- searchPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
10
- autoMode: z.ZodOptional<z.ZodBoolean>;
11
- componentId: z.ZodOptional<z.ZodString>;
12
- conversationContext: z.ZodOptional<z.ZodObject<{
13
- step: z.ZodOptional<z.ZodEnum<["analyze", "select_props", "configure_attrs", "configure_regions", "confirm_generation"]>>;
14
- componentInfo: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
15
- selectedProps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
16
- newAttributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
17
- name: z.ZodString;
18
- description: z.ZodOptional<z.ZodString>;
19
- required: z.ZodOptional<z.ZodBoolean>;
20
- }, "strip", z.ZodTypeAny, {
21
- name: string;
22
- description?: string | undefined;
23
- required?: boolean | undefined;
24
- }, {
25
- name: string;
26
- description?: string | undefined;
27
- required?: boolean | undefined;
28
- }>, "many">>;
29
- attributeConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
30
- type: z.ZodOptional<z.ZodString>;
31
- name: z.ZodOptional<z.ZodString>;
32
- defaultValue: z.ZodOptional<z.ZodAny>;
33
- values: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
34
- }, "strip", z.ZodTypeAny, {
35
- values?: string[] | undefined;
36
- type?: string | undefined;
37
- name?: string | undefined;
38
- defaultValue?: any;
39
- }, {
40
- values?: string[] | undefined;
41
- type?: string | undefined;
42
- name?: string | undefined;
43
- defaultValue?: any;
44
- }>>>;
45
- componentMetadata: z.ZodOptional<z.ZodObject<{
46
- id: z.ZodString;
47
- name: z.ZodString;
48
- description: z.ZodString;
49
- group: z.ZodOptional<z.ZodString>;
50
- }, "strip", z.ZodTypeAny, {
51
- description: string;
52
- name: string;
53
- id: string;
54
- group?: string | undefined;
55
- }, {
56
- description: string;
57
- name: string;
58
- id: string;
59
- group?: string | undefined;
60
- }>>;
61
- regionConfig: z.ZodOptional<z.ZodObject<{
62
- enabled: z.ZodBoolean;
63
- regions: z.ZodOptional<z.ZodArray<z.ZodObject<{
64
- id: z.ZodString;
65
- name: z.ZodString;
66
- description: z.ZodOptional<z.ZodString>;
67
- maxComponents: z.ZodOptional<z.ZodNumber>;
68
- componentTypeInclusions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
69
- componentTypeExclusions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
70
- }, "strip", z.ZodTypeAny, {
71
- name: string;
72
- id: string;
73
- description?: string | undefined;
74
- maxComponents?: number | undefined;
75
- componentTypeInclusions?: string[] | undefined;
76
- componentTypeExclusions?: string[] | undefined;
77
- }, {
78
- name: string;
79
- id: string;
80
- description?: string | undefined;
81
- maxComponents?: number | undefined;
82
- componentTypeInclusions?: string[] | undefined;
83
- componentTypeExclusions?: string[] | undefined;
84
- }>, "many">>;
85
- }, "strip", z.ZodTypeAny, {
86
- enabled: boolean;
87
- regions?: {
88
- name: string;
89
- id: string;
90
- description?: string | undefined;
91
- maxComponents?: number | undefined;
92
- componentTypeInclusions?: string[] | undefined;
93
- componentTypeExclusions?: string[] | undefined;
94
- }[] | undefined;
95
- }, {
96
- enabled: boolean;
97
- regions?: {
98
- name: string;
99
- id: string;
100
- description?: string | undefined;
101
- maxComponents?: number | undefined;
102
- componentTypeInclusions?: string[] | undefined;
103
- componentTypeExclusions?: string[] | undefined;
104
- }[] | undefined;
105
- }>>;
106
- }, "strip", z.ZodTypeAny, {
107
- step?: "analyze" | "select_props" | "configure_attrs" | "configure_regions" | "confirm_generation" | undefined;
108
- componentInfo?: Record<string, any> | undefined;
109
- selectedProps?: string[] | undefined;
110
- newAttributes?: {
111
- name: string;
112
- description?: string | undefined;
113
- required?: boolean | undefined;
114
- }[] | undefined;
115
- attributeConfig?: Record<string, {
116
- values?: string[] | undefined;
117
- type?: string | undefined;
118
- name?: string | undefined;
119
- defaultValue?: any;
120
- }> | undefined;
121
- componentMetadata?: {
122
- description: string;
123
- name: string;
124
- id: string;
125
- group?: string | undefined;
126
- } | undefined;
127
- regionConfig?: {
128
- enabled: boolean;
129
- regions?: {
130
- name: string;
131
- id: string;
132
- description?: string | undefined;
133
- maxComponents?: number | undefined;
134
- componentTypeInclusions?: string[] | undefined;
135
- componentTypeExclusions?: string[] | undefined;
136
- }[] | undefined;
137
- } | undefined;
138
- }, {
139
- step?: "analyze" | "select_props" | "configure_attrs" | "configure_regions" | "confirm_generation" | undefined;
140
- componentInfo?: Record<string, any> | undefined;
141
- selectedProps?: string[] | undefined;
142
- newAttributes?: {
143
- name: string;
144
- description?: string | undefined;
145
- required?: boolean | undefined;
146
- }[] | undefined;
147
- attributeConfig?: Record<string, {
148
- values?: string[] | undefined;
149
- type?: string | undefined;
150
- name?: string | undefined;
151
- defaultValue?: any;
152
- }> | undefined;
153
- componentMetadata?: {
154
- description: string;
155
- name: string;
156
- id: string;
157
- group?: string | undefined;
158
- } | undefined;
159
- regionConfig?: {
160
- enabled: boolean;
161
- regions?: {
162
- name: string;
163
- id: string;
164
- description?: string | undefined;
165
- maxComponents?: number | undefined;
166
- componentTypeInclusions?: string[] | undefined;
167
- componentTypeExclusions?: string[] | undefined;
168
- }[] | undefined;
169
- } | undefined;
170
- }>>;
171
- }, "strict", z.ZodTypeAny, {
172
- component: string;
173
- projectDirectory?: string | undefined;
174
- configPath?: string | undefined;
175
- searchPaths?: string[] | undefined;
176
- autoMode?: boolean | undefined;
177
- componentId?: string | undefined;
178
- conversationContext?: {
179
- step?: "analyze" | "select_props" | "configure_attrs" | "configure_regions" | "confirm_generation" | undefined;
180
- componentInfo?: Record<string, any> | undefined;
181
- selectedProps?: string[] | undefined;
182
- newAttributes?: {
183
- name: string;
184
- description?: string | undefined;
185
- required?: boolean | undefined;
186
- }[] | undefined;
187
- attributeConfig?: Record<string, {
188
- values?: string[] | undefined;
189
- type?: string | undefined;
190
- name?: string | undefined;
191
- defaultValue?: any;
192
- }> | undefined;
193
- componentMetadata?: {
194
- description: string;
195
- name: string;
196
- id: string;
197
- group?: string | undefined;
198
- } | undefined;
199
- regionConfig?: {
200
- enabled: boolean;
201
- regions?: {
202
- name: string;
203
- id: string;
204
- description?: string | undefined;
205
- maxComponents?: number | undefined;
206
- componentTypeInclusions?: string[] | undefined;
207
- componentTypeExclusions?: string[] | undefined;
208
- }[] | undefined;
209
- } | undefined;
210
- } | undefined;
211
- }, {
212
- component: string;
213
- projectDirectory?: string | undefined;
214
- configPath?: string | undefined;
215
- searchPaths?: string[] | undefined;
216
- autoMode?: boolean | undefined;
217
- componentId?: string | undefined;
218
- conversationContext?: {
219
- step?: "analyze" | "select_props" | "configure_attrs" | "configure_regions" | "confirm_generation" | undefined;
220
- componentInfo?: Record<string, any> | undefined;
221
- selectedProps?: string[] | undefined;
222
- newAttributes?: {
223
- name: string;
224
- description?: string | undefined;
225
- required?: boolean | undefined;
226
- }[] | undefined;
227
- attributeConfig?: Record<string, {
228
- values?: string[] | undefined;
229
- type?: string | undefined;
230
- name?: string | undefined;
231
- defaultValue?: any;
232
- }> | undefined;
233
- componentMetadata?: {
234
- description: string;
235
- name: string;
236
- id: string;
237
- group?: string | undefined;
238
- } | undefined;
239
- regionConfig?: {
240
- enabled: boolean;
241
- regions?: {
242
- name: string;
243
- id: string;
244
- description?: string | undefined;
245
- maxComponents?: number | undefined;
246
- componentTypeInclusions?: string[] | undefined;
247
- componentTypeExclusions?: string[] | undefined;
248
- }[] | undefined;
249
- } | undefined;
250
- } | undefined;
251
- }>;
252
- export type PageDesignerDecoratorInput = z.infer<typeof pageDesignerDecoratorSchema>;
253
- /**
254
- * Creates the Page Designer decorator tool for Storefront Next.
255
- *
256
- * @param loadServices - Function that loads configuration and returns Services instance
257
- * @returns The configured MCP tool
258
- */
259
- export declare function createPageDesignerDecoratorTool(loadServices: (projectContext?: ProjectContextInput) => Promise<Services> | Services): McpTool;