@faasjs/ant-design 8.0.0-beta.26 → 8.0.0-beta.28

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/index.d.ts CHANGED
@@ -18,26 +18,48 @@ import { MessageInstance } from "antd/es/message/interface.js";
18
18
  import { NotificationInstance } from "antd/es/notification/interface.js";
19
19
 
20
20
  //#region ../types/src/index.d.ts
21
+ /**
22
+ * # @faasjs/types
23
+ *
24
+ * Action Type definitions for FaasJS and cross backend and frontend.
25
+ *
26
+ * [![License: MIT](https://img.shields.io/npm/l/@faasjs/types.svg)](https://github.com/faasjs/faasjs/blob/main/packages/types/LICENSE)
27
+ * [![NPM Version](https://img.shields.io/npm/v/@faasjs/types.svg)](https://www.npmjs.com/package/@faasjs/types)
28
+ *
29
+ * ## Install
30
+ *
31
+ * Normally you don't need to install this package manually. It's a dependency of `@faasjs/core` and `@faasjs/react`.
32
+ *
33
+ * ## Usage
34
+ *
35
+ * ### TypeScript config presets
36
+ *
37
+ * `@faasjs/types` also provides shared TypeScript presets under `tsconfig/`:
38
+ *
39
+ * - `@faasjs/types/tsconfig/base.json`: strict base options for common TypeScript projects.
40
+ * - `@faasjs/types/tsconfig/react.json`: base options with `jsx: "react-jsx"` for React projects.
41
+ * - `@faasjs/types/tsconfig/build.json`: build-oriented options for Vite apps, packages, and workspace modules.
42
+ *
43
+ * In your tsconfig.json:
44
+ *
45
+ * ```json
46
+ * {
47
+ * "extends": "@faasjs/types/tsconfig/build.json"
48
+ * }
49
+ * ```
50
+ */
21
51
  /**
22
52
  * Interface for defining FaasJS actions.
23
53
  */
24
- interface FaasActions {
25
- /**
26
- * Internal placeholder to keep this interface visible in generated docs.
27
- */
28
- faasjsActionsPlaceholder?: {
29
- Params: Record<string, any>;
30
- Data: Record<string, any>;
31
- };
32
- }
54
+ interface FaasActions {}
33
55
  /**
34
- * Infer all action paths declared in {@link FaasActions}.
56
+ * Infer all declared action paths.
35
57
  */
36
- type FaasActionPaths = Exclude<Extract<keyof FaasActions, string>, 'faasjsActionsPlaceholder'>;
58
+ type FaasActionPaths = Extract<keyof FaasActions, string>;
37
59
  /**
38
60
  * Union type accepted by action helpers when callers pass either an action path or inferred data shape.
39
61
  */
40
- type FaasActionUnionType = Record<string, any> | string;
62
+ type FaasActionUnionType = Record<string, unknown> | string;
41
63
  /**
42
64
  * Infer the action path type.
43
65
  *
@@ -46,9 +68,9 @@ type FaasActionUnionType = Record<string, any> | string;
46
68
  *
47
69
  * @template T - Candidate action path type.
48
70
  */
49
- type FaasAction<T = any> = T extends FaasActionPaths ? T : string;
71
+ type FaasAction<T = unknown> = T extends FaasActionPaths ? T : string;
50
72
  //#endregion
51
- //#region src/Loading.d.ts
73
+ //#region src/Loading/index.d.ts
52
74
  /**
53
75
  * Props for the {@link Loading} component.
54
76
  */
@@ -91,7 +113,7 @@ type LoadingProps = {
91
113
  */
92
114
  declare function Loading(props: LoadingProps): _$react_jsx_runtime0.JSX.Element;
93
115
  //#endregion
94
- //#region src/FaasDataWrapper.d.ts
116
+ //#region src/FaasDataWrapper/index.d.ts
95
117
  /**
96
118
  * Partial data injection exposed to wrapped Ant Design components.
97
119
  *
@@ -218,7 +240,7 @@ declare function FaasDataWrapper<T extends FaasActionUnionType = any>(props: Faa
218
240
  */
219
241
  declare function withFaasData<PathOrData extends FaasActionUnionType, TComponentProps extends Required<FaasDataInjection<PathOrData>> = Required<FaasDataInjection<PathOrData>>>(Component: React.FC<TComponentProps & Record<string, any>>, faasProps: FaasDataWrapperProps<PathOrData>): React.FC<Omit<TComponentProps, keyof FaasDataInjection<PathOrData>>>;
220
242
  //#endregion
221
- //#region src/Config.d.ts
243
+ //#region src/Config/index.d.ts
222
244
  /**
223
245
  * Fully resolved theme object consumed by `@faasjs/ant-design` components.
224
246
  */
@@ -403,7 +425,7 @@ declare function ConfigProvider(props: ConfigProviderProps): _$react_jsx_runtime
403
425
  */
404
426
  declare function useConfigContext(): ConfigContextValue;
405
427
  //#endregion
406
- //#region src/ErrorBoundary.d.ts
428
+ //#region src/ErrorBoundary/index.d.ts
407
429
  /**
408
430
  * Styled error boundary.
409
431
  *
@@ -427,7 +449,7 @@ declare function useConfigContext(): ConfigContextValue;
427
449
  */
428
450
  declare function ErrorBoundary(props: ErrorBoundaryProps): _$react_jsx_runtime0.JSX.Element;
429
451
  //#endregion
430
- //#region src/App.d.ts
452
+ //#region src/App/index.d.ts
431
453
  /**
432
454
  * Props for the root {@link App} shell.
433
455
  *
@@ -493,7 +515,7 @@ interface AppProps {
493
515
  */
494
516
  declare function App(props: AppProps): _$react_jsx_runtime0.JSX.Element;
495
517
  //#endregion
496
- //#region src/Blank.d.ts
518
+ //#region src/Blank/index.d.ts
497
519
  /**
498
520
  * Props for the {@link Blank} placeholder component.
499
521
  */
@@ -522,7 +544,7 @@ interface BlankProps {
522
544
  */
523
545
  declare function Blank(options?: BlankProps): JSX.Element;
524
546
  //#endregion
525
- //#region src/FormItem.d.ts
547
+ //#region src/FormItem/index.d.ts
526
548
  /**
527
549
  * Custom renderer registration for a form item type.
528
550
  *
@@ -633,7 +655,7 @@ declare namespace FormItem {
633
655
  };
634
656
  }
635
657
  //#endregion
636
- //#region src/Table.d.ts
658
+ //#region src/Table/index.d.ts
637
659
  /**
638
660
  * Column definition used by the FaasJS Ant Design {@link Table} component.
639
661
  *
@@ -754,7 +776,7 @@ type TableFaasDataResponse<T = any> = {
754
776
  */
755
777
  declare function Table<T extends Record<string, any>, ExtendTypes = any>(props: TableProps<T, ExtendTypes>): _$react_jsx_runtime0.JSX.Element;
756
778
  //#endregion
757
- //#region src/data.d.ts
779
+ //#region src/data/index.d.ts
758
780
  /**
759
781
  * Supported built-in field types shared by form, table, and description components.
760
782
  */
@@ -940,7 +962,7 @@ interface UnionFaasItemProps<Value = any, Values = any> extends FormItemProps, D
940
962
  */
941
963
  declare function cloneUnionFaasItemElement(element: UnionFaasItemElement, props: any): ReactElement<UnionFaasItemInjection<any, any>, string | _$react.JSXElementConstructor<any>>;
942
964
  //#endregion
943
- //#region src/Description.d.ts
965
+ //#region src/Description/index.d.ts
944
966
  /**
945
967
  * Custom renderer registration for a description item type.
946
968
  *
@@ -1048,7 +1070,7 @@ declare namespace Description {
1048
1070
  var displayName: string;
1049
1071
  }
1050
1072
  //#endregion
1051
- //#region src/Drawer.d.ts
1073
+ //#region src/Drawer/index.d.ts
1052
1074
  /**
1053
1075
  * Props accepted by the hook-managed drawer wrapper.
1054
1076
  */
@@ -1094,7 +1116,7 @@ declare function useDrawer(init?: DrawerProps): {
1094
1116
  setDrawerProps: setDrawerProps;
1095
1117
  };
1096
1118
  //#endregion
1097
- //#region src/Form.d.ts
1119
+ //#region src/Form/index.d.ts
1098
1120
  /**
1099
1121
  * Props for the built-in submit button rendered by {@link Form}.
1100
1122
  */
@@ -1199,7 +1221,7 @@ declare namespace Form {
1199
1221
  var Provider: _$react.FC<_$antd_es_form_context0.FormProviderProps>;
1200
1222
  }
1201
1223
  //#endregion
1202
- //#region src/Link.d.ts
1224
+ //#region src/Link/index.d.ts
1203
1225
  /**
1204
1226
  * Props for the navigation-aware {@link Link} component.
1205
1227
  */
@@ -1249,7 +1271,7 @@ interface LinkProps {
1249
1271
  */
1250
1272
  declare function Link(props: LinkProps): _$react_jsx_runtime0.JSX.Element;
1251
1273
  //#endregion
1252
- //#region src/Modal.d.ts
1274
+ //#region src/Modal/index.d.ts
1253
1275
  /**
1254
1276
  * Props accepted by the hook-managed modal wrapper.
1255
1277
  */
@@ -1295,7 +1317,7 @@ declare function useModal(init?: ModalProps): {
1295
1317
  setModalProps: setModalProps;
1296
1318
  };
1297
1319
  //#endregion
1298
- //#region src/Routers.d.ts
1320
+ //#region src/Routers/index.d.ts
1299
1321
  /**
1300
1322
  * Default 404 route element that uses the configured localized title.
1301
1323
  *
@@ -1358,7 +1380,7 @@ interface RoutesProps {
1358
1380
  */
1359
1381
  declare function Routes(props: RoutesProps): _$react_jsx_runtime0.JSX.Element;
1360
1382
  //#endregion
1361
- //#region src/Tabs.d.ts
1383
+ //#region src/Tabs/index.d.ts
1362
1384
  /**
1363
1385
  * Tab item accepted by the FaasJS Ant Design {@link Tabs} wrapper.
1364
1386
  */
@@ -1408,7 +1430,7 @@ interface TabsProps extends Omit<TabsProps$1, 'items'> {
1408
1430
  */
1409
1431
  declare function Tabs(props: TabsProps): _$react_jsx_runtime0.JSX.Element;
1410
1432
  //#endregion
1411
- //#region src/Title.d.ts
1433
+ //#region src/Title/index.d.ts
1412
1434
  /**
1413
1435
  * Props for the document-title helper component.
1414
1436
  */
@@ -1456,7 +1478,7 @@ interface TitleProps {
1456
1478
  */
1457
1479
  declare function Title(props: TitleProps): JSX.Element | null;
1458
1480
  //#endregion
1459
- //#region src/useApp.d.ts
1481
+ //#region src/useApp/index.d.ts
1460
1482
  /**
1461
1483
  * Shared app services exposed by {@link AppContext} and {@link useApp}.
1462
1484
  */
@@ -1521,7 +1543,7 @@ declare const AppContext: any;
1521
1543
  */
1522
1544
  declare function useApp<NewT extends useAppProps = useAppProps>(this: void): Readonly<NewT>;
1523
1545
  //#endregion
1524
- //#region src/useThemeToken.d.ts
1546
+ //#region src/useThemeToken/index.d.ts
1525
1547
  /**
1526
1548
  * Read the current Ant Design theme token.
1527
1549
  *
package/dist/index.mjs CHANGED
@@ -6,7 +6,7 @@ import { Suspense, cloneElement, createContext, createElement, isValidElement, l
6
6
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
7
7
  import { CheckOutlined, CloseOutlined, MinusCircleOutlined, PlusOutlined } from "@ant-design/icons";
8
8
  import dayjs from "dayjs";
9
- //#region src/Loading.tsx
9
+ //#region src/Loading/index.tsx
10
10
  /**
11
11
  * Render an Ant Design loading spinner with an optional content fallback.
12
12
  *
@@ -42,7 +42,7 @@ function Loading(props) {
42
42
  });
43
43
  }
44
44
  //#endregion
45
- //#region src/FaasDataWrapper.tsx
45
+ //#region src/FaasDataWrapper/index.tsx
46
46
  /**
47
47
  * Render the `@faasjs/react` data wrapper with an Ant Design loading fallback.
48
48
  *
@@ -162,7 +162,7 @@ function withFaasData(Component, faasProps) {
162
162
  });
163
163
  }
164
164
  //#endregion
165
- //#region src/Config.tsx
165
+ //#region src/Config/index.tsx
166
166
  const zh = {
167
167
  lang: "zh",
168
168
  blank: "空",
@@ -315,7 +315,7 @@ function useConfigContext() {
315
315
  return useContext(ConfigContext);
316
316
  }
317
317
  //#endregion
318
- //#region src/Drawer.tsx
318
+ //#region src/Drawer/index.tsx
319
319
  /**
320
320
  * Create a hook-managed Ant Design drawer instance.
321
321
  *
@@ -369,7 +369,7 @@ function useDrawer(init) {
369
369
  };
370
370
  }
371
371
  //#endregion
372
- //#region src/ErrorBoundary.tsx
372
+ //#region src/ErrorBoundary/index.tsx
373
373
  function ErrorChildren(props) {
374
374
  return /* @__PURE__ */ jsx(Alert, {
375
375
  type: "error",
@@ -411,7 +411,7 @@ function ErrorBoundary(props) {
411
411
  });
412
412
  }
413
413
  //#endregion
414
- //#region src/Modal.tsx
414
+ //#region src/Modal/index.tsx
415
415
  /**
416
416
  * Create a hook-managed Ant Design modal instance.
417
417
  *
@@ -465,7 +465,7 @@ function useModal(init) {
465
465
  };
466
466
  }
467
467
  //#endregion
468
- //#region src/useApp.ts
468
+ //#region src/useApp/index.ts
469
469
  /**
470
470
  * Shared context storing message, notification, modal, and drawer helpers.
471
471
  *
@@ -522,12 +522,11 @@ function useApp() {
522
522
  return AppContext.use();
523
523
  }
524
524
  //#endregion
525
- //#region src/App.tsx
525
+ //#region src/App/index.tsx
526
526
  function RoutesApp(props) {
527
527
  const location = useLocation();
528
528
  const { drawerProps, setDrawerProps, modalProps, setModalProps } = useApp();
529
529
  useEqualEffect(() => {
530
- console.debug("location", location);
531
530
  if (drawerProps.open) setDrawerProps({ open: false });
532
531
  if (modalProps.open) setModalProps({ open: false });
533
532
  }, [location]);
@@ -608,7 +607,7 @@ function App(props) {
608
607
  });
609
608
  }
610
609
  //#endregion
611
- //#region src/Blank.tsx
610
+ //#region src/Blank/index.tsx
612
611
  /**
613
612
  * Render a disabled placeholder when a value is empty.
614
613
  *
@@ -634,7 +633,7 @@ function Blank(options) {
634
633
  }) : options.value;
635
634
  }
636
635
  //#endregion
637
- //#region src/data.ts
636
+ //#region src/data/index.ts
638
637
  /**
639
638
  * Convert a snake_case, kebab-case, or spaced identifier into a title-style label.
640
639
  *
@@ -748,7 +747,7 @@ function cloneUnionFaasItemElement(element, props) {
748
747
  return cloneElement(isValidElement(element) ? element : createElement(element), props);
749
748
  }
750
749
  //#endregion
751
- //#region src/Description.tsx
750
+ //#region src/Description/index.tsx
752
751
  function DescriptionItemContent(props) {
753
752
  const [computedProps, setComputedProps] = useState();
754
753
  useEqualEffect(() => {
@@ -894,7 +893,7 @@ function Description(props) {
894
893
  }
895
894
  Description.displayName = "Description";
896
895
  //#endregion
897
- //#region src/FormItem.tsx
896
+ //#region src/FormItem/index.tsx
898
897
  function isOptionsProps(item) {
899
898
  return item && Array.isArray(item.options);
900
899
  }
@@ -1197,7 +1196,7 @@ function FormItem(props) {
1197
1196
  }
1198
1197
  FormItem.useStatus = Form$1.Item.useStatus;
1199
1198
  //#endregion
1200
- //#region src/Form.tsx
1199
+ //#region src/Form/index.tsx
1201
1200
  function isFormItemProps(item) {
1202
1201
  return item.id !== void 0;
1203
1202
  }
@@ -1337,7 +1336,6 @@ function Form(props) {
1337
1336
  setAntdProps(propsCopy);
1338
1337
  }, [props]);
1339
1338
  const onValuesChange = useEqualCallback((changedValues, allValues) => {
1340
- console.debug("Form:onValuesChange", changedValues, allValues);
1341
1339
  if (props.onValuesChange) props.onValuesChange(changedValues, allValues);
1342
1340
  if (!items.length) return;
1343
1341
  for (const key in changedValues) {
@@ -1351,7 +1349,6 @@ function Form(props) {
1351
1349
  ]);
1352
1350
  useEqualEffect(() => {
1353
1351
  if (!initialValues) return;
1354
- console.debug("Form:initialValues", initialValues);
1355
1352
  form.setFieldsValue(initialValues);
1356
1353
  setInitialValues(null);
1357
1354
  }, [
@@ -1396,7 +1393,7 @@ Form.List = Form$1.List;
1396
1393
  Form.ErrorList = Form$1.ErrorList;
1397
1394
  Form.Provider = Form$1.Provider;
1398
1395
  //#endregion
1399
- //#region src/Link.tsx
1396
+ //#region src/Link/index.tsx
1400
1397
  /**
1401
1398
  * Render a navigation-aware link or button.
1402
1399
  *
@@ -1474,7 +1471,7 @@ function Link(props) {
1474
1471
  });
1475
1472
  }
1476
1473
  //#endregion
1477
- //#region src/Routers.tsx
1474
+ //#region src/Routers/index.tsx
1478
1475
  /**
1479
1476
  * Default 404 route element that uses the configured localized title.
1480
1477
  *
@@ -1547,7 +1544,7 @@ function Routes(props) {
1547
1544
  }, "*")] });
1548
1545
  }
1549
1546
  //#endregion
1550
- //#region src/Table.tsx
1547
+ //#region src/Table/index.tsx
1551
1548
  function processValue(item, value) {
1552
1549
  const itemType = item.type ?? "string";
1553
1550
  const transferred = transferValue(itemType, value);
@@ -1952,7 +1949,7 @@ function FaasDataTable({ props, columns, data, params, reload, loading }) {
1952
1949
  });
1953
1950
  }
1954
1951
  //#endregion
1955
- //#region src/Tabs.tsx
1952
+ //#region src/Tabs/index.tsx
1956
1953
  /**
1957
1954
  * Render an Ant Design tabs wrapper that accepts FaasJS-style tab definitions.
1958
1955
  *
@@ -1993,7 +1990,7 @@ function Tabs(props) {
1993
1990
  });
1994
1991
  }
1995
1992
  //#endregion
1996
- //#region src/Title.tsx
1993
+ //#region src/Title/index.tsx
1997
1994
  /**
1998
1995
  * Update `document.title` and optionally render the title inline.
1999
1996
  *
@@ -2034,7 +2031,7 @@ function Title(props) {
2034
2031
  return null;
2035
2032
  }
2036
2033
  //#endregion
2037
- //#region src/useThemeToken.ts
2034
+ //#region src/useThemeToken/index.ts
2038
2035
  /**
2039
2036
  * Read the current Ant Design theme token.
2040
2037
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@faasjs/ant-design",
3
- "version": "8.0.0-beta.26",
3
+ "version": "8.0.0-beta.28",
4
4
  "homepage": "https://faasjs.com/doc/ant-design",
5
5
  "bugs": {
6
6
  "url": "https://github.com/faasjs/faasjs/issues"
@@ -27,7 +27,7 @@
27
27
  },
28
28
  "devDependencies": {
29
29
  "@ant-design/icons": "*",
30
- "@faasjs/react": ">=8.0.0-beta.26",
30
+ "@faasjs/react": ">=8.0.0-beta.28",
31
31
  "@types/lodash-es": "*",
32
32
  "@types/react": "^19.0.0",
33
33
  "@types/react-dom": "^19.0.0",
@@ -39,7 +39,7 @@
39
39
  },
40
40
  "peerDependencies": {
41
41
  "@ant-design/icons": "*",
42
- "@faasjs/react": ">=8.0.0-beta.26",
42
+ "@faasjs/react": ">=8.0.0-beta.28",
43
43
  "antd": "^6.0.0",
44
44
  "lodash-es": "*",
45
45
  "react": "^19.0.0",