@wix/patterns 1.480.0 → 1.482.0

package/dist/docs/index.json

@@ -4,7 +4,7 @@
     "category": "Features/Actions/Action Cell",
     "summary": "TableActionCellProps",
     "bundle": "types/ActionCellProps.d.ts",
-    "propsTotal": 15,
+    "propsTotal": 16,
     "propsTypeName": "ActionCellProps"
   },
   "ActionSubItem": {
@@ -27,7 +27,7 @@
     "summary": "AutoCompleteProps",
     "importPath": "@wix/patterns",
     "bundle": "components/AutoCompleteFilter.d.ts",
-    "propsTotal": 122,
+    "propsTotal": 126,
     "propsTypeName": "Omit"
   },
   "BulkActionModalRenderProp": {
@@ -674,7 +674,7 @@
     "category": "Common/Types",
     "summary": "Defines an action item in the `MoreActions` dropdown menu. Each item has a `text` label, an `onClick` handler, and optional properties like `prefixIcon`, `skin` (`dark` or `destructive`), `disabled`, `subtitle`, and `dataHook`.",
     "bundle": "types/MoreActionsItem.d.ts",
-    "propsTotal": 10,
+    "propsTotal": 11,
     "propsTypeName": "MoreActionsItem"
   },
   "MultiAutoInlineCheckboxFilter": {
@@ -732,7 +732,7 @@
     "summary": "Use `MultiSelectCheckboxFilter` for rendering a list of items in a dropdown, with checkboxes.",
     "importPath": "@wix/patterns",
     "bundle": "components/MultiSelectCheckboxFilter.d.ts",
-    "propsTotal": 127,
+    "propsTotal": 131,
     "propsTypeName": "MultiSelectCheckboxFilterProps"
   },
   "MultiSelectCollectionFilter": {
@@ -741,7 +741,7 @@
     "summary": "`MultiSelectCollectionFilter` is based on MultiSelect.",
     "importPath": "@wix/patterns",
     "bundle": "components/MultiSelectCollectionFilter.d.ts",
-    "propsTotal": 132,
+    "propsTotal": 135,
     "propsTypeName": "MultiSelectCollectionFilterProps"
   },
   "NestedTable": {
@@ -925,7 +925,7 @@
     "summary": "The `@wix/patterns/schema` entry builds a page from a **Wix Data (CMS) collection**. Its source, `useCmsSchemaSource` from `@wix/patterns-cms`, describes the collection once: its fields, how to read and write its items, and how to add, edit and delete fields. Columns, filters, grid cards, entity-page forms and field management all come from the source, so you don't list them by hand.",
     "importPath": "@wix/patterns/schema",
     "bundle": "hooks/useSchemaSource.d.ts",
-    "propsTotal": 16,
+    "propsTotal": 17,
     "propsTypeName": "SchemaSourceInput",
     "symbols": [
       "EntityPageFieldsCard"
@@ -1003,7 +1003,7 @@
     "summary": "Renders a Dropdown filter that shows a list of items fetched from a server.",
     "importPath": "@wix/patterns",
     "bundle": "components/SingleSelectFilter.d.ts",
-    "propsTotal": 121,
+    "propsTotal": 125,
     "propsTypeName": "SingleSelectFilterProps",
     "examples": [
       "SingleSelectFilter/server-data.tsx",
@@ -1063,7 +1063,7 @@
       }
     ],
     "bundle": "components/Table.d.ts",
-    "propsTotal": 63,
+    "propsTotal": 65,
     "propsTypeName": "TableProps",
     "examples": [
       "Table/basic-table.tsx",
@@ -1104,7 +1104,7 @@
     "summary": "The `TableFolders` component displays a table-like view of folders and items.",
     "importPath": "@wix/patterns",
     "bundle": "components/TableFolders.d.ts",
-    "propsTotal": 57,
+    "propsTotal": 60,
     "propsTypeName": "TableFoldersProps",
     "examples": [
       "TableFolders/demo.tsx",
@@ -1126,7 +1126,7 @@
     "summary": "The `TableGridSwitch` component provides a pair of icons in the toolbar for toggling between `Grid` and `Table` views. The icon order is fixed: `Table` view is on the left, and `Grid` view is on the right.",
     "importPath": "@wix/patterns",
     "bundle": "components/TableGridSwitch.d.ts",
-    "propsTotal": 64,
+    "propsTotal": 66,
     "propsTypeName": "TableGridSwitchBaseProps",
     "examples": [
       "TableGridSwitch/basic-table-grid-switch.tsx",
@@ -1193,7 +1193,7 @@
     "summary": "`TableTopNotification` allows showing a message that appears between the table header and the table rows.",
     "importPath": "@wix/patterns",
     "bundle": "components/TableTopNotification.d.ts",
-    "propsTotal": 19,
+    "propsTotal": 20,
     "propsTypeName": "TableTopNotificationProps",
     "examples": [
       "TableTopNotification/base.tsx",
@@ -1267,7 +1267,7 @@
   "Collection and Read-Only Detail Template": {
     "file": "Collection and Read-Only Detail Template.md",
     "category": "Templates",
-    "summary": "A complete dashboard page for a list of records the user reads but does not edit: a collection page with search, a filter and every placeholder state, a read-only detail page for one record, and the router between them. Use it when there is nothing to create and nothing to save.",
+    "summary": "A complete dashboard page for a read-only list of records: a collection page with search, a filter and every placeholder state, a read-only detail page for one record, and the router between them. Use it only in one of the read-only cases on the Page Templates page; an ordinary request to show a table or list defaults to an editable template.",
     "relatedComponents": [
       "withDashboard",
       "WixPatternsProvider",

package/dist/docs/useEntityPage.md

@@ -238,6 +238,92 @@ want when each route mounts its own page. Pass the getter form —
 page survives the route change instead.
 
 
+### Before the fetch resolves
+
+`fetch` always runs, but `state.entity` is not always empty until it resolves. When you
+open the page with
+[`navigateToEntityPage({ path, entity })`](./?path=%2Fstory%2Fbase-components-pages-router-hooks-usepatternsnavigate--usepatternsnavigate),
+`state.entity` starts as the `entity` you passed — usually the collection row. Your
+component renders once with that value, then again when `fetch` resolves and replaces it.
+
+So everything that reads `state.entity` in the component that calls `useEntityPage` runs
+against the collection row first. What the user sees during that render depends on where
+the read happens:
+
+- **`EntityPage.Header`** shows `title` and `subtitle` right away. This is the point of
+  passing `entity`: the header does not wait for `fetch`.
+- **Inside `EntityPage.Card`** the content is replaced by a skeleton until `fetch`
+  resolves. Reads written inline in your page component still run — they are only hidden.
+- **Anywhere else** — a plain WDS `Card`, or content outside a card — shows on the first
+  render, with the collection row's values.
+
+The collection row is typed as `T`, but nothing checks that it has every field the entity
+has. If the collection returns a summary and `fetch` returns the full record, a field that
+only the full record has is `undefined` on the first render:
+
+
+
+```tsx
+// ❌ Throws on the first render when the collection row has no `inventory`,
+// even though EntityPage.Card hides the result behind a skeleton
+<EntityPage.Card>
+  {state.entity && state.entity.inventory.length > 0 ? (
+    <InventoryTable rows={state.entity.inventory} />
+  ) : null}
+</EntityPage.Card>
+```
+
+## Read `state.entity` in a component inside `EntityPage.Card`
+
+Do not read `state.entity` inline under `EntityPage.Card`. Move the reads out of the
+component that calls `useEntityPage`, into a component of their own. While `fetch` runs, `EntityPage.Card` renders a skeleton and does not render its children.
+When those children are a component of their own, React does not run that component at all
+until `fetch` resolves, so its reads only ever see the fetched entity:
+
+
+
+```tsx
+// ✅ Runs only after fetch resolves — no guards needed for fields the
+// collection row lacks
+const InventoryContent = observer(() => {
+  const state = useEntityPageContext<ProductDetail, ProductFormFields>();
+  const { inventory } = state.entity!;
+
+  return inventory.length > 0 ? (
+    <InventoryTable rows={inventory} />
+  ) : (
+    <Text secondary>No inventory tracked for this product.</Text>
+  );
+});
+
+// In the page:
+<EntityPage.Card>
+  <Card.Header title="Inventory" />
+  <Card.Divider />
+  <Card.Content>
+    <InventoryContent />
+  </Card.Content>
+</EntityPage.Card>;
+```
+
+Two things keep this working:
+
+- **Get the state from `useEntityPageContext()`, not from a prop.** Writing
+  `<InventoryContent inventory={state.entity.inventory} />` reads the field in the page
+  component again, before `fetch` resolves.
+- **Wrap the component in `observer()`.** It then re-renders on its own when what it reads
+  changes, instead of with the whole page.
+
+This only works under `EntityPage.Card`. A plain WDS `Card`, or any other wrapper, renders
+its children straight away, so a component there still runs with the collection row.
+Content that needs the full entity belongs in an `EntityPage.Card`. Where it cannot be,
+guard every field the collection row may not have (`state.entity?.inventory?.length`), or
+pass an `entity` to `navigateToEntityPage` that already has the full shape.
+
+The page never copies `state.entity` into the form — the passed one or the fetched one.
+The form holds only the values you give it.
+
+
 ### After a save
 
 `onSave` resolving is not the end of the flow. The page then acts on its own, and the

package/dist/docs/usePatternsNavigate.md

@@ -66,6 +66,11 @@ It takes the path of the entity page, and the entity as arguments:
    }}
 ```
 
+The passed `entity` is more than header data: it is the entity page's `state.entity` until
+`fetch` resolves, so every read of `state.entity` in that page runs against it first. See
+[Before the fetch resolves](useEntityPage.md)
+on `useEntityPage` for what that means for fields the collection row does not have.
+
 ### Navigating to a create page
 
 `entity` is optional, because a create page has no record to pass yet. Omit it:

package/dist/docs/useSchemaSource.md

@@ -83,5 +83,5 @@ Options of `useSchemaSource`, which `useCmsSchemaSource` builds on. A CMS page p
 
 ### Props
 
-Read `dist/dts-bundle/hooks/useSchemaSource.d.ts` for `useSchemaSource`'s props. Shared shapes cut to a one-line stub there hold 16 of them: `dist/dts-bundle/types/SchemaSourceInput.d.ts` (16).
+Read `dist/dts-bundle/hooks/useSchemaSource.d.ts` for `useSchemaSource`'s props. Shared shapes cut to a one-line stub there hold 17 of them: `dist/dts-bundle/types/SchemaSourceInput.d.ts` (17).
 

package/dist/dts-bundle/index.json

@@ -120,7 +120,7 @@
     "file": "components/Table.d.ts",
     "bytes": 5214,
     "ownProps": 5,
-    "inheritedProps": 58,
+    "inheritedProps": 60,
     "status": null,
     "statusMessage": null,
     "readWith": [
@@ -128,7 +128,7 @@
       "types/Filter.d.ts",
       "types/TableState.d.ts"
     ],
-    "readWithBytes": 31467,
+    "readWithBytes": 31505,
     "variants": [
       {
         "importPath": "@wix/patterns/schema",
@@ -141,7 +141,7 @@
           "types/TableColumn.d.ts",
           "types/TableState.d.ts"
         ],
-        "readWithBytes": 36908
+        "readWithBytes": 36946
       }
     ]
   },
@@ -196,7 +196,7 @@
       "types/TableColumn.d.ts",
       "types/TableState.d.ts"
     ],
-    "readWithBytes": 72019
+    "readWithBytes": 72057
   },
   "LayoutSwitch": {
     "kind": "component",
@@ -218,7 +218,7 @@
       "types/TableState.d.ts",
       "types/ToolbarCollectionBaseProps.d.ts"
     ],
-    "readWithBytes": 120991
+    "readWithBytes": 121029
   },
   "TableGridSwitch": {
     "kind": "component",
@@ -227,7 +227,7 @@
     "file": "components/TableGridSwitch.d.ts",
     "bytes": 22595,
     "ownProps": 3,
-    "inheritedProps": 61,
+    "inheritedProps": 63,
     "status": null,
     "statusMessage": null,
     "readWith": [
@@ -241,7 +241,7 @@
       "types/TableState.d.ts",
       "types/ToolbarCollectionBaseProps.d.ts"
     ],
-    "readWithBytes": 101700
+    "readWithBytes": 101738
   },
   "TableFolders": {
     "kind": "component",
@@ -250,7 +250,7 @@
     "file": "components/TableFolders.d.ts",
     "bytes": 14358,
     "ownProps": 3,
-    "inheritedProps": 54,
+    "inheritedProps": 57,
     "status": null,
     "statusMessage": null,
     "readWith": [
@@ -351,7 +351,7 @@
     "file": "components/MultiSelectCheckboxFilter.d.ts",
     "bytes": 4130,
     "ownProps": 0,
-    "inheritedProps": 127,
+    "inheritedProps": 131,
     "status": null,
     "statusMessage": null,
     "readWith": [
@@ -397,7 +397,7 @@
     "file": "components/SingleSelectFilter.d.ts",
     "bytes": 4229,
     "ownProps": 3,
-    "inheritedProps": 118,
+    "inheritedProps": 122,
     "status": null,
     "statusMessage": null,
     "readWith": [
@@ -442,7 +442,7 @@
     "file": "components/MultiSelectCollectionFilter.d.ts",
     "bytes": 3595,
     "ownProps": 2,
-    "inheritedProps": 130,
+    "inheritedProps": 133,
     "status": null,
     "statusMessage": null,
     "readWith": [
@@ -616,7 +616,7 @@
     "file": "components/TableTopNotification.d.ts",
     "bytes": 691,
     "ownProps": 4,
-    "inheritedProps": 15,
+    "inheritedProps": 16,
     "status": null,
     "statusMessage": null
   },
@@ -712,7 +712,7 @@
       "types/OffsetQuery.d.ts",
       "types/TableState.d.ts"
     ],
-    "readWithBytes": 18888,
+    "readWithBytes": 18926,
     "variants": [
       {
         "importPath": "@wix/patterns/schema",
@@ -728,7 +728,7 @@
           "types/SchemaSource.d.ts",
           "types/TableState.d.ts"
         ],
-        "readWithBytes": 53258
+        "readWithBytes": 53390
       }
     ]
   },
@@ -762,7 +762,7 @@
           "types/OffsetQuery.d.ts",
           "types/SchemaSource.d.ts"
         ],
-        "readWithBytes": 46487
+        "readWithBytes": 46581
       }
     ]
   },
@@ -798,7 +798,7 @@
           "types/OffsetQuery.d.ts",
           "types/SchemaSource.d.ts"
         ],
-        "readWithBytes": 50592
+        "readWithBytes": 50686
       }
     ]
   },
@@ -819,7 +819,7 @@
       "types/OffsetQuery.d.ts",
       "types/SchemaSource.d.ts"
     ],
-    "readWithBytes": 78104
+    "readWithBytes": 78198
   },
   "useLayoutSwitchCollection": {
     "kind": "hook",
@@ -838,7 +838,7 @@
       "types/OffsetQuery.d.ts",
       "types/SchemaSource.d.ts"
     ],
-    "readWithBytes": 63224
+    "readWithBytes": 63318
   },
   "useTableGridSwitchCollection": {
     "kind": "hook",
@@ -972,7 +972,7 @@
       "types/SchemaSource.d.ts",
       "types/UseEntityPageParams.d.ts"
     ],
-    "readWithBytes": 81071,
+    "readWithBytes": 81165,
     "variants": [
       {
         "importPath": "@wix/patterns/schema",
@@ -986,7 +986,7 @@
           "types/SchemaSource.d.ts",
           "types/UseEntityPageParams.d.ts"
         ],
-        "readWithBytes": 81071
+        "readWithBytes": 81165
       }
     ]
   },
@@ -1173,7 +1173,7 @@
     "category": "Base Components/Collections/Table/TableState",
     "importPath": "@wix/patterns",
     "file": "types/TableState.d.ts",
-    "bytes": 6771,
+    "bytes": 6809,
     "status": null,
     "statusMessage": null,
     "readWith": [
@@ -1208,7 +1208,7 @@
       "types/GridState.d.ts",
       "types/TableState.d.ts"
     ],
-    "readWithBytes": 15001
+    "readWithBytes": 15039
   },
   "TableFoldersState": {
     "kind": "type",
@@ -1222,7 +1222,7 @@
       "types/Filter.d.ts",
       "types/TableState.d.ts"
     ],
-    "readWithBytes": 10896
+    "readWithBytes": 10934
   },
   "GridFoldersState": {
     "kind": "type",
@@ -1250,7 +1250,7 @@
       "types/EntityPageStateParams.d.ts",
       "types/SchemaSource.d.ts"
     ],
-    "readWithBytes": 65581
+    "readWithBytes": 65675
   },
   "UseEntityPageParams": {
     "kind": "type",
@@ -1266,7 +1266,7 @@
       "types/OnSaveParams.d.ts",
       "types/SchemaSource.d.ts"
     ],
-    "readWithBytes": 73188
+    "readWithBytes": 73282
   },
   "EntityPageStateParams": {
     "kind": "type",
@@ -1281,7 +1281,7 @@
       "types/OnSaveParams.d.ts",
       "types/SchemaSource.d.ts"
     ],
-    "readWithBytes": 65615
+    "readWithBytes": 65709
   },
   "EntityPageState": {
     "kind": "type",
@@ -1301,7 +1301,7 @@
       "types/OnSaveParams.d.ts",
       "types/SchemaSource.d.ts"
     ],
-    "readWithBytes": 61667
+    "readWithBytes": 61761
   },
   "Column": {
     "kind": "type",
@@ -1505,7 +1505,7 @@
       "types/TagsProps.d.ts",
       "types/ToolbarCollectionBaseProps.d.ts"
     ],
-    "readWithBytes": 77644
+    "readWithBytes": 77682
   },
   "CollectionViewsDropdownBaseProps": {
     "kind": "type",
@@ -1600,7 +1600,7 @@
     "category": null,
     "importPath": "@wix/patterns/schema",
     "file": "types/SchemaSource.d.ts",
-    "bytes": 34370,
+    "bytes": 34464,
     "status": null,
     "statusMessage": null,
     "readWith": [
@@ -1611,7 +1611,7 @@
       "types/OffsetQuery.d.ts",
       "types/SchemaSourceInput.d.ts"
     ],
-    "readWithBytes": 47722
+    "readWithBytes": 48033
   },
   "useSchemaSource": {
     "kind": "hook",
@@ -1625,14 +1625,14 @@
       "types/SchemaSource.d.ts",
       "types/SchemaSourceInput.d.ts"
     ],
-    "readWithBytes": 69975
+    "readWithBytes": 70380
   },
   "SchemaSourceInput": {
     "kind": "type",
     "category": null,
     "importPath": "@wix/patterns/schema",
     "file": "types/SchemaSourceInput.d.ts",
-    "bytes": 35605,
+    "bytes": 35916,
     "status": null,
     "statusMessage": null,
     "readWith": [
@@ -1643,7 +1643,7 @@
       "types/OffsetQuery.d.ts",
       "types/SchemaSource.d.ts"
     ],
-    "readWithBytes": 46487
+    "readWithBytes": 46581
   },
   "EntityPageFieldsCard": {
     "kind": "component",
@@ -1659,7 +1659,7 @@
     "category": null,
     "importPath": "@wix/patterns-cms",
     "package": "@wix/patterns-cms",
-    "packageVersion": "1.64.0",
+    "packageVersion": "1.66.0",
     "doc": "useSchemaSource.md",
     "file": "hooks/useCmsSchemaSource.d.ts",
     "bytes": 17020,
@@ -1670,17 +1670,17 @@
       "types/SchemaSourceInput.d.ts",
       "types/UseCmsSchemaSourceDeps.d.ts"
     ],
-    "readWithBytes": 108246
+    "readWithBytes": 108666
   },
   "UseCmsSchemaSourceDeps": {
     "kind": "type",
     "category": null,
     "importPath": "@wix/patterns-cms",
     "package": "@wix/patterns-cms",
-    "packageVersion": "1.64.0",
+    "packageVersion": "1.66.0",
     "doc": "useSchemaSource.md",
     "file": "types/UseCmsSchemaSourceDeps.d.ts",
-    "bytes": 38271,
+    "bytes": 38286,
     "status": null,
     "statusMessage": null,
     "readWith": [
@@ -1688,14 +1688,14 @@
       "types/SchemaSource.d.ts",
       "types/SchemaSourceInput.d.ts"
     ],
-    "readWithBytes": 74100
+    "readWithBytes": 74505
   },
   "listCmsCollections": {
     "kind": "function",
     "category": null,
     "importPath": "@wix/patterns-cms",
     "package": "@wix/patterns-cms",
-    "packageVersion": "1.64.0",
+    "packageVersion": "1.66.0",
     "file": "functions/listCmsCollections.d.ts",
     "bytes": 401,
     "status": null,
@@ -1710,7 +1710,7 @@
     "category": null,
     "importPath": "@wix/patterns-cms",
     "package": "@wix/patterns-cms",
-    "packageVersion": "1.64.0",
+    "packageVersion": "1.66.0",
     "file": "types/CmsCollectionSummary.d.ts",
     "bytes": 286,
     "status": null,

package/dist/dts-bundle/index.txt

@@ -58,8 +58,8 @@ MultiAutoInlineCheckboxFilter	component	@wix/patterns	components/MultiAutoInline
 MultiBulkActionToolbar	component	@wix/patterns	components/MultiBulkActionToolbar.d.ts	-	1813	-	1
 MultiInlineCheckboxFilter	component	@wix/patterns	components/MultiInlineCheckboxFilter.d.ts	-	951	2/49	1
 MultiLevelSorting	type	@wix/patterns	types/MultiLevelSorting.d.ts	-	149	-	-
-MultiSelectCheckboxFilter	component	@wix/patterns	components/MultiSelectCheckboxFilter.d.ts	-	4130	0/127	2
-MultiSelectCollectionFilter	component	@wix/patterns	components/MultiSelectCollectionFilter.d.ts	-	3595	2/132	2
+MultiSelectCheckboxFilter	component	@wix/patterns	components/MultiSelectCheckboxFilter.d.ts	-	4130	0/131	2
+MultiSelectCollectionFilter	component	@wix/patterns	components/MultiSelectCollectionFilter.d.ts	-	3595	2/135	2
 NumberRangeFilter	component	@wix/patterns	components/NumberRangeFilter.d.ts	-	770	3/11	2
 OffsetQuery	type	@wix/patterns	types/OffsetQuery.d.ts	-	1752	-	4
 OnSaveParams	type	@wix/patterns/core	types/OnSaveParams.d.ts	-	7607	-	3
@@ -73,30 +73,30 @@ PrimaryActions	component	@wix/patterns	components/PrimaryActions.d.ts	-	446	0/12
 PrimaryPageButton	component	@wix/patterns	components/PrimaryPageButton.d.ts	deprecated	796	-	-
 RadioGroupFilter	component	@wix/patterns	components/RadioGroupFilter.d.ts	-	766	2/13	1
 RangeItem	type	@wix/patterns	types/RangeItem.d.ts	-	2820	-	-
-SchemaSource	type	@wix/patterns/schema	types/SchemaSource.d.ts	-	34370	-	6
-SchemaSourceInput	type	@wix/patterns/schema	types/SchemaSourceInput.d.ts	-	35605	-	6
+SchemaSource	type	@wix/patterns/schema	types/SchemaSource.d.ts	-	34464	-	6
+SchemaSourceInput	type	@wix/patterns/schema	types/SchemaSourceInput.d.ts	-	35916	-	6
 SecondaryActions	component	@wix/patterns	components/SecondaryActions.d.ts	-	456	0/12	1
 SettingsPage	component	@wix/patterns	components/SettingsPage.d.ts	-	8608	1/14	1
-SingleSelectFilter	component	@wix/patterns	components/SingleSelectFilter.d.ts	-	4229	3/121	2
+SingleSelectFilter	component	@wix/patterns	components/SingleSelectFilter.d.ts	-	4229	3/125	2
 stringFilter	function	@wix/patterns	functions/stringFilter.d.ts	-	845	-	-
 stringsArrayFilter	function	@wix/patterns	functions/stringsArrayFilter.d.ts	-	3052	-	-
 SummaryBar	component	@wix/patterns	components/SummaryBar.d.ts	-	886	-	-
-Table	component	@wix/patterns	components/Table.d.ts	-	5214	5/63	3
+Table	component	@wix/patterns	components/Table.d.ts	-	5214	5/65	3
 Table	component	@wix/patterns/schema	components/schema/Table.d.ts	-	11051	-	4
 TableColumn	type	@wix/patterns	types/TableColumn.d.ts	-	5441	-	1
-TableFolders	component	@wix/patterns	components/TableFolders.d.ts	-	14358	3/57	6
+TableFolders	component	@wix/patterns	components/TableFolders.d.ts	-	14358	3/60	6
 TableFoldersState	type	@wix/patterns	types/TableFoldersState.d.ts	-	6558	-	2
-TableGridSwitch	component	@wix/patterns	components/TableGridSwitch.d.ts	-	22595	3/64	9
+TableGridSwitch	component	@wix/patterns	components/TableGridSwitch.d.ts	-	22595	3/66	9
 TableGridSwitchState	type	@wix/patterns	types/TableGridSwitchState.d.ts	-	17767	-	3
-TableState	type	@wix/patterns	types/TableState.d.ts	-	6771	-	2
-TableTopNotification	component	@wix/patterns	components/TableTopNotification.d.ts	-	691	4/19	-
+TableState	type	@wix/patterns	types/TableState.d.ts	-	6809	-	2
+TableTopNotification	component	@wix/patterns	components/TableTopNotification.d.ts	-	691	4/20	-
 TabsFilter	component	@wix/patterns	components/TabsFilter.d.ts	-	4455	-	2
 TagsProps	type	@wix/patterns	types/TagsProps.d.ts	-	9344	-	4
 ToolbarBaseProps	type	-	types/ToolbarBaseProps.d.ts	unreachable	3915	-	4
 ToolbarCollectionBaseProps	type	-	types/ToolbarCollectionBaseProps.d.ts	unreachable	36727	-	10
 ToolbarTitleProps	type	@wix/patterns	types/ToolbarTitleProps.d.ts	-	1642	-	1
 useCmsSchemaSource	hook	@wix/patterns-cms	hooks/useCmsSchemaSource.d.ts	-	17020	-	3
-UseCmsSchemaSourceDeps	type	@wix/patterns-cms	types/UseCmsSchemaSourceDeps.d.ts	-	38271	-	3
+UseCmsSchemaSourceDeps	type	@wix/patterns-cms	types/UseCmsSchemaSourceDeps.d.ts	-	38286	-	3
 useCollection	hook	@wix/patterns	hooks/useCollection.d.ts	-	11841	-	5
 useCollection	hook	@wix/patterns/schema	hooks/schema/useCollection.d.ts	-	12163	-	6
 useController	hook	@wix/patterns/form	hooks/useController.d.ts	-	1213	-	-

package/dist/dts-bundle/types/SchemaSource.d.ts

@@ -618,8 +618,8 @@ interface FieldModalConfig {
     creatable: boolean;
     /** Placeholder for the name input. Absent ⇒ the modal's generic placeholder. */
     namePlaceholder?: string;
-    /** Optional valid field ID base. Default: the normalized uppercase type ID.
-     *  Numeric suffixes are added only on collision. */
+    /** Fallback field ID base when the name cannot produce a valid ID.
+     *  Default: the normalized type ID. Numeric suffixes resolve collisions. */
     keyBase?: string;
     /** One-line description under the type in the picker. */
     subtitle?: string;
@@ -711,8 +711,8 @@ interface FieldTypeOption {
     label?: string;
     /** Custom name-input placeholder. Absent ⇒ the UI's standard placeholder. */
     namePlaceholder?: string;
-    /** Optional valid field ID base. Default: the normalized uppercase type ID.
-     *  Numeric suffixes are added only on collision. */
+    /** Fallback field ID base when the name cannot produce a valid ID.
+     *  Default: the normalized type ID. Numeric suffixes resolve collisions. */
     keyBase?: string;
     /** A one-line description shown under the type in the add-field menu. */
     subtitle?: string;
@@ -785,6 +785,7 @@ interface SchemaSource<T> {
     canAddFields: (schema: Schema) => boolean;
     canEditField: (field: Field, schema: Schema) => boolean;
     canDeleteField: (field: Field, schema: Schema) => boolean;
+    canMakePrimary?: (field: Field, schema: Schema) => boolean;
     getDeleteFieldConfirmation?: (field: Field, schema: Schema) => DeleteFieldConfirmation | undefined;
     readonly fieldPermissions?: FieldPermissions;
     readonly supportsPii: boolean;