@wix/auto-patterns 1.34.0 → 1.36.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.
- package/dist/cjs/components/modals/actions/BulkDeleteModal.js +2 -3
- package/dist/cjs/components/modals/actions/BulkDeleteModal.js.map +1 -1
- package/dist/esm/components/modals/actions/BulkDeleteModal.js +0 -1
- package/dist/esm/components/modals/actions/BulkDeleteModal.js.map +1 -1
- package/dist/types/components/modals/actions/BulkDeleteModal.d.ts.map +1 -1
- package/mcp-docs/action_cell.md +50 -2
- package/mcp-docs/auto-patterns-guide.md +611 -38
- package/mcp-docs/bulk_actions.md +78 -22
- package/mcp-docs/collection_page_actions.md +56 -2
- package/mcp-docs/custom_overrides.md +1 -0
- package/mcp-docs/entity_page_actions.md +78 -1
- package/mcp-docs/entity_page_view_actions.md +2 -0
- package/mcp-docs/error_handling.md +346 -11
- package/package.json +6 -6
|
@@ -60,7 +60,6 @@ const BulkDeleteModal = ({
|
|
|
60
60
|
secondaryButtonText: ((_modalParams$actions2 = modalParams.actions) == null || (_modalParams$actions2 = _modalParams$actions2.cancel) == null ? void 0 : _modalParams$actions2.text) || 'Cancel',
|
|
61
61
|
content: /*#__PURE__*/_react.default.createElement(_designSystem.Box, {
|
|
62
62
|
direction: "vertical",
|
|
63
|
-
width: "552px",
|
|
64
63
|
gap: "SP2",
|
|
65
64
|
paddingTop: "SP1",
|
|
66
65
|
paddingBottom: "SP1",
|
|
@@ -74,14 +73,14 @@ const BulkDeleteModal = ({
|
|
|
74
73
|
__self: void 0,
|
|
75
74
|
__source: {
|
|
76
75
|
fileName: _jsxFileName,
|
|
77
|
-
lineNumber:
|
|
76
|
+
lineNumber: 61,
|
|
78
77
|
columnNumber: 13
|
|
79
78
|
}
|
|
80
79
|
}, /*#__PURE__*/_react.default.createElement(_designSystem.Text, {
|
|
81
80
|
__self: void 0,
|
|
82
81
|
__source: {
|
|
83
82
|
fileName: _jsxFileName,
|
|
84
|
-
lineNumber:
|
|
83
|
+
lineNumber: 62,
|
|
85
84
|
columnNumber: 15
|
|
86
85
|
}
|
|
87
86
|
}, ((_modalParams$descript = modalParams.description) == null ? void 0 : _modalParams$descript.text) || 'This items will be deleted'))),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["_designSystem","require","_react","_interopRequireDefault","_jsxFileName","BulkDeleteModal","sdk","modalParams","actionParams","_modalParams$title","_modalParams$actions","_modalParams$actions2","_modalParams$descript","getOptimisticActions","collectionId","closeModal","optimisticActions","default","createElement","Modal","isOpen","onRequestClose","__self","__source","fileName","lineNumber","columnNumber","CustomModalLayout","title","text","theme","onCloseButtonClick","primaryButtonOnClick","_modalParams$feedback","schema","getSchema","Error","selectedIds","selectedValues","map","value","idField","deleteMany","successToast","feedback","errorToast","_modalParams$feedback2","submit","result","actions","bulkDelete","secondaryButtonOnClick","primaryButtonText","secondaryButtonText","cancel","content","Box","direction","
|
|
1
|
+
{"version":3,"names":["_designSystem","require","_react","_interopRequireDefault","_jsxFileName","BulkDeleteModal","sdk","modalParams","actionParams","_modalParams$title","_modalParams$actions","_modalParams$actions2","_modalParams$descript","getOptimisticActions","collectionId","closeModal","optimisticActions","default","createElement","Modal","isOpen","onRequestClose","__self","__source","fileName","lineNumber","columnNumber","CustomModalLayout","title","text","theme","onCloseButtonClick","primaryButtonOnClick","_modalParams$feedback","schema","getSchema","Error","selectedIds","selectedValues","map","value","idField","deleteMany","successToast","feedback","errorToast","_modalParams$feedback2","submit","result","actions","bulkDelete","secondaryButtonOnClick","primaryButtonText","secondaryButtonText","cancel","content","Box","direction","gap","paddingTop","paddingBottom","Text","description","exports"],"sources":["../../../../../src/components/modals/actions/BulkDeleteModal.tsx"],"sourcesContent":["import { Box, CustomModalLayout, Modal, Text } from '@wix/design-system';\nimport React from 'react';\nimport { BulkActionsActionParams, BulkDeleteActionModal } from '../../../types';\nimport { ActionModalProps } from './types';\n\nexport interface BulkDeleteModalProps extends ActionModalProps {\n modalParams: BulkDeleteActionModal;\n actionParams: BulkActionsActionParams;\n}\n\nexport const BulkDeleteModal = ({\n sdk,\n modalParams,\n actionParams,\n}: BulkDeleteModalProps) => {\n const { getOptimisticActions, collectionId, closeModal } = sdk;\n const optimisticActions = getOptimisticActions(collectionId);\n\n return (\n <Modal isOpen onRequestClose={closeModal}>\n <CustomModalLayout\n title={modalParams.title?.text || 'Delete item?'}\n theme=\"destructive\"\n onCloseButtonClick={() => {\n closeModal();\n }}\n primaryButtonOnClick={() => {\n const schema = sdk.getSchema(sdk.collectionId);\n if (!schema) {\n throw new Error('Schema not found');\n }\n const selectedIds = actionParams.selectedValues.map(\n (value) => value[schema.idField],\n );\n optimisticActions?.deleteMany(actionParams.selectedValues, {\n successToast:\n modalParams.feedback?.successToast?.text ||\n 'Items deleted successfully',\n errorToast: () =>\n modalParams.feedback?.errorToast?.text ||\n 'Failed to delete items',\n submit: async () => {\n const result = await schema.actions.bulkDelete(selectedIds);\n return [result];\n },\n });\n closeModal();\n }}\n secondaryButtonOnClick={() => {\n closeModal();\n }}\n primaryButtonText={modalParams.actions?.submit?.text || 'Save'}\n secondaryButtonText={modalParams.actions?.cancel?.text || 'Cancel'}\n content={\n <Box\n direction=\"vertical\"\n gap=\"SP2\"\n paddingTop=\"SP1\"\n paddingBottom=\"SP1\"\n >\n <Box>\n <Text>\n {modalParams.description?.text || 'This items will be deleted'}\n </Text>\n </Box>\n </Box>\n }\n />\n </Modal>\n );\n};\n"],"mappings":"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","ignoreList":[]}
|
|
@@ -49,7 +49,6 @@ export const BulkDeleteModal = _ref => {
|
|
|
49
49
|
secondaryButtonText: ((_modalParams$actions2 = modalParams.actions) == null || (_modalParams$actions2 = _modalParams$actions2.cancel) == null ? void 0 : _modalParams$actions2.text) || 'Cancel',
|
|
50
50
|
content: /*#__PURE__*/React.createElement(Box, {
|
|
51
51
|
direction: "vertical",
|
|
52
|
-
width: "552px",
|
|
53
52
|
gap: "SP2",
|
|
54
53
|
paddingTop: "SP1",
|
|
55
54
|
paddingBottom: "SP1"
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["Box","CustomModalLayout","Modal","Text","React","BulkDeleteModal","_ref","_modalParams$title","_modalParams$actions","_modalParams$actions2","_modalParams$descript","sdk","modalParams","actionParams","getOptimisticActions","collectionId","closeModal","optimisticActions","createElement","isOpen","onRequestClose","title","text","theme","onCloseButtonClick","primaryButtonOnClick","_modalParams$feedback","schema","getSchema","Error","selectedIds","selectedValues","map","value","idField","deleteMany","successToast","feedback","errorToast","_modalParams$feedback2","submit","result","actions","bulkDelete","secondaryButtonOnClick","primaryButtonText","secondaryButtonText","cancel","content","direction","
|
|
1
|
+
{"version":3,"names":["Box","CustomModalLayout","Modal","Text","React","BulkDeleteModal","_ref","_modalParams$title","_modalParams$actions","_modalParams$actions2","_modalParams$descript","sdk","modalParams","actionParams","getOptimisticActions","collectionId","closeModal","optimisticActions","createElement","isOpen","onRequestClose","title","text","theme","onCloseButtonClick","primaryButtonOnClick","_modalParams$feedback","schema","getSchema","Error","selectedIds","selectedValues","map","value","idField","deleteMany","successToast","feedback","errorToast","_modalParams$feedback2","submit","result","actions","bulkDelete","secondaryButtonOnClick","primaryButtonText","secondaryButtonText","cancel","content","direction","gap","paddingTop","paddingBottom","description"],"sources":["../../../../../src/components/modals/actions/BulkDeleteModal.tsx"],"sourcesContent":["import { Box, CustomModalLayout, Modal, Text } from '@wix/design-system';\nimport React from 'react';\nimport { BulkActionsActionParams, BulkDeleteActionModal } from '../../../types';\nimport { ActionModalProps } from './types';\n\nexport interface BulkDeleteModalProps extends ActionModalProps {\n modalParams: BulkDeleteActionModal;\n actionParams: BulkActionsActionParams;\n}\n\nexport const BulkDeleteModal = ({\n sdk,\n modalParams,\n actionParams,\n}: BulkDeleteModalProps) => {\n const { getOptimisticActions, collectionId, closeModal } = sdk;\n const optimisticActions = getOptimisticActions(collectionId);\n\n return (\n <Modal isOpen onRequestClose={closeModal}>\n <CustomModalLayout\n title={modalParams.title?.text || 'Delete item?'}\n theme=\"destructive\"\n onCloseButtonClick={() => {\n closeModal();\n }}\n primaryButtonOnClick={() => {\n const schema = sdk.getSchema(sdk.collectionId);\n if (!schema) {\n throw new Error('Schema not found');\n }\n const selectedIds = actionParams.selectedValues.map(\n (value) => value[schema.idField],\n );\n optimisticActions?.deleteMany(actionParams.selectedValues, {\n successToast:\n modalParams.feedback?.successToast?.text ||\n 'Items deleted successfully',\n errorToast: () =>\n modalParams.feedback?.errorToast?.text ||\n 'Failed to delete items',\n submit: async () => {\n const result = await schema.actions.bulkDelete(selectedIds);\n return [result];\n },\n });\n closeModal();\n }}\n secondaryButtonOnClick={() => {\n closeModal();\n }}\n primaryButtonText={modalParams.actions?.submit?.text || 'Save'}\n secondaryButtonText={modalParams.actions?.cancel?.text || 'Cancel'}\n content={\n <Box\n direction=\"vertical\"\n gap=\"SP2\"\n paddingTop=\"SP1\"\n paddingBottom=\"SP1\"\n >\n <Box>\n <Text>\n {modalParams.description?.text || 'This items will be deleted'}\n </Text>\n </Box>\n </Box>\n }\n />\n </Modal>\n );\n};\n"],"mappings":"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","ignoreList":[]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"BulkDeleteModal.d.ts","sourceRoot":"","sources":["../../../../../src/components/modals/actions/BulkDeleteModal.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,WAAW,EAAE,qBAAqB,CAAC;IACnC,YAAY,EAAE,uBAAuB,CAAC;CACvC;AAED,eAAO,MAAM,eAAe,GAAI,qCAI7B,oBAAoB,
|
|
1
|
+
{"version":3,"file":"BulkDeleteModal.d.ts","sourceRoot":"","sources":["../../../../../src/components/modals/actions/BulkDeleteModal.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,WAAW,EAAE,qBAAqB,CAAC;IACnC,YAAY,EAAE,uBAAuB,CAAC;CACvC;AAED,eAAO,MAAM,eAAe,GAAI,qCAI7B,oBAAoB,sBAwDtB,CAAC"}
|
package/mcp-docs/action_cell.md
CHANGED
|
@@ -40,6 +40,7 @@ Both properties are optional, but at least one should be provided for the Action
|
|
|
40
40
|
- Browser interactions (alerts, downloads)
|
|
41
41
|
- Complex operations
|
|
42
42
|
- ⚠️ Requires implementation: Must register action in overrides
|
|
43
|
+
- ⚠️ **CRITICAL: Error Handling Required** - When implementing custom actions that make HTTP requests, you MUST read the "Error Handling for HTTP Requests" section and apply the correct error handling patterns. Wix HTTP requests require `errorHandler.withErrorHandler`, while external API calls should NOT use errorHandler.
|
|
43
44
|
|
|
44
45
|
### Action Appearance: The `skin` Property
|
|
45
46
|
|
|
@@ -139,7 +140,7 @@ Custom actions execute JavaScript code that you define. These actions receive pa
|
|
|
139
140
|
},
|
|
140
141
|
successToast: 'Pet details downloaded',
|
|
141
142
|
errorToast: (err, {retry}) => ({
|
|
142
|
-
|
|
143
|
+
text: 'Download failed',
|
|
143
144
|
action: { text: 'Retry', onClick: retry }
|
|
144
145
|
})
|
|
145
146
|
});
|
|
@@ -149,6 +150,53 @@ Custom actions execute JavaScript code that you define. These actions receive pa
|
|
|
149
150
|
};
|
|
150
151
|
```
|
|
151
152
|
|
|
153
|
+
**⚠️ CRITICAL: Error Handling for HTTP Requests**
|
|
154
|
+
|
|
155
|
+
The example above uses SDK methods which don't require error handling. However, if your custom action makes HTTP requests, you MUST follow the error handling patterns:
|
|
156
|
+
|
|
157
|
+
**For Wix HTTP requests (httpClient, wix/data, wix/stores):**
|
|
158
|
+
```typescript
|
|
159
|
+
import { errorHandler } from '@wix/essentials';
|
|
160
|
+
|
|
161
|
+
export const myAction: CustomActionCellSecondaryActionResolver = (params) => {
|
|
162
|
+
return {
|
|
163
|
+
label: 'My Action',
|
|
164
|
+
icon: <MyIcon />,
|
|
165
|
+
onClick: () => {
|
|
166
|
+
// ✅ CORRECT: Wix API call wrapped with errorHandler
|
|
167
|
+
errorHandler.withErrorHandler(
|
|
168
|
+
async () => {
|
|
169
|
+
const response = await httpClient.request(
|
|
170
|
+
myWixApiCall({ data: params.actionParams.item })
|
|
171
|
+
);
|
|
172
|
+
return response.data;
|
|
173
|
+
},
|
|
174
|
+
{}
|
|
175
|
+
);
|
|
176
|
+
},
|
|
177
|
+
};
|
|
178
|
+
};
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
**For External API requests (fetch, axios, third-party):**
|
|
182
|
+
```typescript
|
|
183
|
+
export const myAction: CustomActionCellSecondaryActionResolver = (params) => {
|
|
184
|
+
return {
|
|
185
|
+
label: 'My Action',
|
|
186
|
+
icon: <MyIcon />,
|
|
187
|
+
onClick: () => {
|
|
188
|
+
// ✅ CORRECT: External API call - NO errorHandler needed
|
|
189
|
+
fetch('https://api.external-service.com/endpoint', {
|
|
190
|
+
method: 'POST',
|
|
191
|
+
body: JSON.stringify(params.actionParams.item)
|
|
192
|
+
});
|
|
193
|
+
},
|
|
194
|
+
};
|
|
195
|
+
};
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
**Read the "Error Handling for HTTP Requests" section for complete guidance.**
|
|
199
|
+
|
|
152
200
|
3. Export your action in `actions/index.tsx`:
|
|
153
201
|
```typescript
|
|
154
202
|
import { downloadPetDetails } from './downloadPetDetails';
|
|
@@ -209,7 +257,7 @@ Custom actions execute JavaScript code that you define. These actions receive pa
|
|
|
209
257
|
- Enable analytics tracking for user interactions
|
|
210
258
|
|
|
211
259
|
2. The implementation must return a `ResolvedAction` object with:
|
|
212
|
-
- `label`: Text displayed for the action
|
|
260
|
+
- `label`: Text displayed for the action
|
|
213
261
|
- `icon`: An Icon component from "@wix/wix-ui-icons-common"
|
|
214
262
|
- `onClick`: Handler function for the action
|
|
215
263
|
- `biName`: Business intelligence name for analytics tracking. Must match the `biName` in your action configuration (required)
|