@wix/patterns 1.461.0 → 1.463.0

package/dist/docs/MultiInlineCheckboxFilter.md

@@ -2,6 +2,8 @@
 
 **Category:** Features/Filter/Components
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Overview
@@ -49,10 +51,5 @@ function BasicMultiInlineCheckboxFilter() {
 
 ### Props
 
-Read `dist/dts-bundle/components/MultiInlineCheckboxFilter.d.ts` for `MultiInlineCheckboxFilter`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/MultiInlineCheckboxFilter.d.ts` for `MultiInlineCheckboxFilter`'s props. Shared shapes cut to a one-line stub there hold 11 of them: `dist/dts-bundle/types/FilterProps.d.ts` (11).
 

package/dist/docs/MultiLevelSorting.md

@@ -2,6 +2,8 @@
 
 **Category:** Features/Sort/Sortable Columns/MultiLevelSorting
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Description
@@ -40,12 +42,7 @@ Example code: read `dist/docs/MultiLevelSorting/multi-level-sorting-with-custom-
 
 ### Props
 
-Read `dist/dts-bundle/types/MultiLevelSorting.d.ts` for `MultiLevelSorting`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/types/MultiLevelSorting.d.ts` for `MultiLevelSorting`'s props.
 
 ## Testkit
 

package/dist/docs/MultiSelectCheckboxFilter.md

@@ -2,6 +2,8 @@
 
 **Category:** Features/Filter/Components
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Overview
@@ -74,7 +76,7 @@ function MultiSelectCheckboxFilterEmptyState() {
   const collection = useFilterCollection<User>(filter, {
     queryName: 'MultiSelectCheckboxFilter-EmptyState',
     fetchData: async () => {
-      return { items: [], total: 0 };
+      return { items: [] as User[], total: 0 };
     },
     limit: 50,
     filters: {},
@@ -100,6 +102,7 @@ import {
   idNameArrayFilter,
   MultiSelectCheckboxFilter,
   useFilterCollection,
+  CursorQuery,
 } from '@wix/patterns';
 import { useHttpClient } from '@wix/yoshi-flow-bm';
 import { Cell, Layout } from '@wix/design-system';
@@ -117,7 +120,7 @@ function MultiSelectCheckboxFilterServerData() {
   const collection = useFilterCollection(filter, {
     queryName: 'MultiSelectCheckboxFilter-ServerData',
     paginationMode: 'cursor',
-    fetchData: (query) => {
+    fetchData: (query: CursorQuery) => {
       const { limit, cursor, search } = query;
       return httpClient
         .request<{ total: number; items: User[]; cursor?: string }>({
@@ -162,6 +165,7 @@ import {
   idNameArrayFilter,
   MultiSelectCheckboxFilter,
   useFilterCollection,
+  CursorQuery,
 } from '@wix/patterns';
 import { useHttpClient } from '@wix/yoshi-flow-bm';
 import { Cell, Layout } from '@wix/design-system';
@@ -179,7 +183,7 @@ function CustomRenderItem() {
   const collection = useFilterCollection(filter, {
     queryName: 'MultiSelectCheckboxFilter-CustomRenderItem',
     paginationMode: 'cursor',
-    fetchData: (query) => {
+    fetchData: (query: CursorQuery) => {
       const { limit, cursor, search } = query;
       return httpClient
         .request<{ total: number; items: User[]; cursor?: string }>({
@@ -258,10 +262,5 @@ function ItemsSelectionFilterExample() {
 
 ### Props
 
-Read `dist/dts-bundle/components/MultiSelectCheckboxFilter.d.ts` for `MultiSelectCheckboxFilter`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/MultiSelectCheckboxFilter.d.ts` for `MultiSelectCheckboxFilter`'s props. Shared shapes cut to a one-line stub there hold 10 of them: `dist/dts-bundle/types/FilterProps.d.ts` (10).
 

package/dist/docs/MultiSelectCollectionFilter.md

@@ -2,6 +2,8 @@
 
 **Category:** Features/Filter/Components
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Overview
@@ -25,7 +27,10 @@ import { MultiSelectCollectionFilter } from '@wix/patterns';
 
 ```tsx
 import React from 'react';
+import { useHttpClient } from '@wix/yoshi-flow-bm';
+import { Layout, Cell } from '@wix/design-system';
 import {
+  OffsetQuery,
   idNameArrayFilter,
   MultiSelectCollectionFilter,
   useFilterCollection,
@@ -34,14 +39,14 @@ import {
 function Basic() {
   const [filter] = React.useState(() => idNameArrayFilter());
 
-  const fakeEntityHttpClient = useFakeEntityHttpClient();
+  const fakeEntityHttpClient = useHttpClient();
 
   const collection = useFilterCollection(filter, {
     queryName: 'fakeEntity-filter',
-    fetchData: (query) => {
+    fetchData: (query: OffsetQuery) => {
       const { limit, offset, search } = query;
       return fakeEntityHttpClient
-        .request({
+        .request<{ items: { id: string; name: string }[]; total: number }>({
           url: '/api/fake-entity',
           params: { limit, offset, search },
         })
@@ -107,10 +112,5 @@ function EmptyState() {
 
 ### Props
 
-Read `dist/dts-bundle/components/MultiSelectCollectionFilter.d.ts` for `MultiSelectCollectionFilter`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/MultiSelectCollectionFilter.d.ts` for `MultiSelectCollectionFilter`'s props. Shared shapes cut to a one-line stub there hold 9 of them: `dist/dts-bundle/types/FilterProps.d.ts` (9).
 

package/dist/docs/NestedTable/drag-and-drop.tsx

@@ -14,6 +14,7 @@ import {
   Filter,
   stringsArrayFilter,
   NestedTableDragAndDrop,
+  OffsetQuery,
 } from '@wix/patterns';
 import { useHttpClient } from '@wix/yoshi-flow-bm';
 
@@ -44,7 +45,7 @@ function SingleEntityNestedTableDragAndDrop() {
           filters: {
             parentId: stringsArrayFilter(),
           },
-          fetchData: (query) => {
+          fetchData: (query: OffsetQuery<ContactFilters>) => {
             const { limit, offset, search, filters } = query;
             return httpClient
               .request(

package/dist/docs/NestedTable/filters.tsx

@@ -88,7 +88,7 @@ function VariousEntitiesNestedTable() {
           const collection = createCollection<Category, NestedTableFilters>({
             filters,
             queryName: 'VariousEntitiesNestedTable-levels',
-            fetchData: async (query) => {
+            fetchData: async (query: OffsetQuery<NestedTableFilters>) => {
               if (!query.filters.lastActivity) {
                 return {
                   items: ALL_CATEGORIES,
@@ -131,7 +131,7 @@ function VariousEntitiesNestedTable() {
             },
             itemKey: (item) => item._id as string,
             itemName: (item) => item.info?.name as string,
-            fetchData: async (query) => {
+            fetchData: async (query: OffsetQuery<NestedTableFilters>) => {
               const queryBuilder = buildQuery(query);
               const contactsResponse = await queryBuilder.find();
               const fetchedContacts = contactsResponse.items;

package/dist/docs/NestedTable/flat-mode-search.tsx

@@ -10,6 +10,7 @@ import {
   useCreateCollection,
   Filter,
   stringsArrayFilter,
+  OffsetQuery,
 } from '@wix/patterns';
 import { useHttpClient } from '@wix/yoshi-flow-bm';
 
@@ -36,7 +37,7 @@ function SingleEntityNestedTable() {
           filters: {
             parentId: stringsArrayFilter(),
           },
-          fetchData: (query) => {
+          fetchData: (query: OffsetQuery<ContactFilters>) => {
             const { limit, offset, search, filters } = query;
             return httpClient
               .request(

package/dist/docs/NestedTable/node-api-usage.tsx

@@ -18,6 +18,7 @@ import {
   useCreateCollection,
   Filter,
   stringsArrayFilter,
+  OffsetQuery,
 } from '@wix/patterns';
 import { CollectionPage } from '@wix/patterns/page';
 import { useHttpClient } from '@wix/yoshi-flow-bm';
@@ -57,7 +58,7 @@ function AccessNodeDescendants() {
           filters: {
             parentId: stringsArrayFilter(),
           },
-          fetchData: (query) => {
+          fetchData: (query: OffsetQuery<ContactFilters>) => {
             const { limit, offset, search, filters } = query;
             return httpClient
               .request(
@@ -130,39 +131,36 @@ function AccessNodeDescendants() {
                     : ('UNSUBSCRIBED' as SubscriptionStatus),
                 };
 
-                node?.getParent()?.optimisticActions?.updateOne(
-                  item,
-                  {
-                    propagate: true,
-                    patch: {
-                      primaryEmail,
-                    },
-                    keepPosition: true,
-                    submit: async () => {
-                      await httpClient.request(
-                        updateContact({
-                          ...item,
-                          contactId: item.id as string,
-                          revision: item.revision ? item.revision + 1 : 1,
-                          info: {
-                            ...item.info,
-                            primaryEmail,
-                          } as {},
-                        }),
-                      );
-                      await httpClient.request(
-                        bulkUpdateContacts({
-                          filter: {
-                            ancestorId: [item.id],
-                          },
-                          info: {
-                            primaryEmail,
-                          } as {},
-                        }),
-                      );
-                    },
+                node?.getParent()?.optimisticActions?.updateOne(item, {
+                  propagate: true,
+                  patch: {
+                    primaryEmail,
                   },
-                );
+                  keepPosition: true,
+                  submit: async () => {
+                    await httpClient.request(
+                      updateContact({
+                        ...item,
+                        contactId: item.id as string,
+                        revision: item.revision ? item.revision + 1 : 1,
+                        info: {
+                          ...item.info,
+                          primaryEmail,
+                        } as {},
+                      }),
+                    );
+                    await httpClient.request(
+                      bulkUpdateContacts({
+                        filter: {
+                          ancestorId: [item.id],
+                        },
+                        info: {
+                          primaryEmail,
+                        } as {},
+                      }),
+                    );
+                  },
+                });
               }}
               checked={item.primaryEmail?.subscriptionStatus === 'SUBSCRIBED'}
             />

package/dist/docs/NestedTable/single-entity.tsx

@@ -10,6 +10,7 @@ import {
   useCreateCollection,
   Filter,
   stringsArrayFilter,
+  OffsetQuery,
 } from '@wix/patterns';
 import { CollectionPage } from '@wix/patterns/page';
 import { useHttpClient } from '@wix/yoshi-flow-bm';
@@ -37,7 +38,7 @@ function SingleEntityNestedTable() {
           filters: {
             parentId: stringsArrayFilter(),
           },
-          fetchData: (query) => {
+          fetchData: (query: OffsetQuery<ContactFilters>) => {
             const { limit, offset, search, filters } = query;
             return httpClient
               .request(

package/dist/docs/NestedTable/various-entities.tsx

@@ -13,6 +13,7 @@ import {
   useCreateCollection,
   Filter,
   stringsArrayFilter,
+  OffsetQuery,
 } from '@wix/patterns';
 import { useHttpClient } from '@wix/yoshi-flow-bm';
 import { Delete } from '@wix/wix-ui-icons-common';
@@ -40,7 +41,7 @@ function VariousEntitiesNestedTable() {
           const collection = createCollection<{ id: string; name: string }, {}>(
             {
               queryName: 'VariousEntitiesNestedTable-levels',
-              fetchData: (query) =>
+              fetchData: (query: OffsetQuery) =>
                 Promise.resolve({
                   items: [
                     { id: 'Beginner', name: 'Beginner' },
@@ -69,7 +70,7 @@ function VariousEntitiesNestedTable() {
             filters: {
               level: stringsArrayFilter(),
             },
-            fetchData: (query) => {
+            fetchData: (query: OffsetQuery<ContactFilters>) => {
               const { limit, offset, search, filters } = query;
               return httpClient
                 .request(

package/dist/docs/NestedTable.md

@@ -2,6 +2,8 @@
 
 **Category:** Base Components/Collections/NestedTable
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ```tsx
@@ -110,6 +112,8 @@ For example:
 
 ```ts
 import {
+  Filter,
+  OffsetQuery,
   createNestedTableSingleEntityLevels,
   createNestedTableLevel,
   useNestedTable,
@@ -127,7 +131,7 @@ useNestedTable({
         filters: {
           parentId: stringsArrayFilter(),
         },
-        fetchData: (query) => {
+        fetchData: (query: OffsetQuery<{ parentId: Filter<string[]> }>) => {
           const parentId = query.filters.parentId?.[0];
           return queryCategories({
             filter: {
@@ -154,7 +158,7 @@ useNestedTable({
       parentKey: () => undefined,
       createCollection: () => {
         const collection = createCollection({
-          fetchData: (query) => {
+          fetchData: (query: OffsetQuery) => {
             return queryCountries();
           },
         });
@@ -171,7 +175,7 @@ useNestedTable({
           filters: {
             countryId: stringsArrayFilter(),
           },
-          fetchData: (query) => {
+          fetchData: (query: OffsetQuery<{ countryId: Filter<string[]> }>) => {
             const { countryId } = query.filters;
             return queryStates({
               filter: {
@@ -194,7 +198,7 @@ useNestedTable({
           filters: {
             stateId: stringsArrayFilter(),
           },
-          fetchData: (query) => {
+          fetchData: (query: OffsetQuery<{ stateId: Filter<string[]> }>) => {
             const { stateId } = query.filters;
             return queryCities({
               filter: {

package/dist/docs/NumberRangeFilter.md

@@ -2,6 +2,8 @@
 
 **Category:** Features/Filter/Components
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Overview
@@ -70,7 +72,13 @@ The component displays error messages in the following scenarios:
 ## Complete Example
 
 ```typescript
-import { NumberRangeFilter, numberRangeFilter } from '@wix/patterns';
+import {
+  Filter,
+  OffsetQuery,
+  RangeItem,
+  NumberRangeFilter,
+  numberRangeFilter,
+} from '@wix/patterns';
 import { useCollection } from '@wix/patterns';
 
 function ProductFilters() {
@@ -92,7 +100,9 @@ function ProductFilters() {
     filters: {
       price: priceFilter,
     },
-    fetchData: async (query) => {
+    fetchData: async (
+      query: OffsetQuery<{ price: Filter<RangeItem<number>> }>,
+    ) => {
       const { filters } = query;
       // Access price range via filters.price
       return fetchProducts(filters);
@@ -214,10 +224,5 @@ function DecimalNumberRangeFilter() {
 
 ### Props
 
-Read `dist/dts-bundle/components/NumberRangeFilter.d.ts` for `NumberRangeFilter`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/NumberRangeFilter.d.ts` for `NumberRangeFilter`'s props. Shared shapes cut to a one-line stub there hold 11 of them: `dist/dts-bundle/types/FilterProps.d.ts` (11).
 

package/dist/docs/OperatorFilterPicker.md

@@ -2,6 +2,8 @@
 
 **Category:** Features/Filter/Components
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Overview
@@ -53,6 +55,8 @@ import React from 'react';
 import { CollectionPage } from '@wix/patterns/page';
 import {
   operatorFilter,
+  OffsetQuery,
+  OperatorFilterState,
   FilterOperator,
   OperatorFilterPicker,
   transformOperatorFilterToWQL,
@@ -95,7 +99,12 @@ function operatorFilterWithTableExample() {
     filters: {
       name: nameFilter,
     },
-    fetchData: async ({ limit, offset, search, filters }) => {
+    fetchData: async ({
+      limit,
+      offset,
+      search,
+      filters,
+    }: OffsetQuery<{ name: OperatorFilterState<string> }>) => {
       const nameFilters = filters.name
         ? transformOperatorFilterToWQL('name', filters.name)
         : [];
@@ -112,7 +121,9 @@ function operatorFilterWithTableExample() {
             cursorPaging: { limit, offset },
           },
         }),
-      )) as { data: { contacts: Contact[]; pagingMetadata: { total: number } } };
+      )) as {
+        data: { contacts: Contact[]; pagingMetadata: { total: number } };
+      };
 
       return {
         items: response?.data?.contacts || [],
@@ -156,7 +167,9 @@ function operatorFilterWithTableExample() {
                   title: 'Created',
                   render: (contact) =>
                     contact.createdDate
-                      ? new window.Date(contact.createdDate).toLocaleDateString()
+                      ? new window.Date(
+                          contact.createdDate,
+                        ).toLocaleDateString()
                       : '',
                 },
               ]}
@@ -179,10 +192,5 @@ export default operatorFilterWithTableExample;
 
 ### Props
 
-Read `dist/dts-bundle/components/OperatorFilterPicker.d.ts` for `OperatorFilterPicker`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/OperatorFilterPicker.d.ts` for `OperatorFilterPicker`'s props. Shared shapes cut to a one-line stub there hold 11 of them: `dist/dts-bundle/types/FilterProps.d.ts` (11).
 

package/dist/docs/PatternsReactRoute.md

@@ -2,6 +2,8 @@
 
 **Category:** Base Components/Pages/Router
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Description
@@ -21,10 +23,5 @@ import { PatternsReactRoute } from '@wix/patterns/router';
 
 ### Props
 
-Read `dist/dts-bundle/components/PatternsReactRoute.d.ts` for `PatternsReactRoute`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/PatternsReactRoute.d.ts` for `PatternsReactRoute`'s props.
 

package/dist/docs/PatternsReactRouter.md

@@ -2,6 +2,8 @@
 
 **Category:** Base Components/Pages/Router
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Description
@@ -63,13 +65,13 @@ Under Yoshi BM flow the host passes `location` to your page component, so
 In a **Wix CLI app** nothing passes props to the dashboard page component, so
 you must supply `location` yourself from the dashboard SDK:
 
-```jsx
+```tsx
 import { useEffect, useState } from 'react';
-import { dashboard } from '@wix/dashboard';
+import { dashboard, type PageLocation } from '@wix/dashboard';
 import { WixDesignSystemProvider } from '@wix/design-system';
 
 export default function Page() {
-  const [location, setLocation] = useState();
+  const [location, setLocation] = useState<PageLocation>();
 
   useEffect(() => {
     const subscription = dashboard.observeState((_pageParams, environment) => {
@@ -100,10 +102,5 @@ import { PatternsReactRouter } from '@wix/patterns/router';
 
 ### Props
 
-Read `dist/dts-bundle/components/PatternsReactRouter.d.ts` for `PatternsReactRouter`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/PatternsReactRouter.d.ts` for `PatternsReactRouter`'s props.
 

package/dist/docs/PickerModal.md

@@ -2,6 +2,8 @@
 
 **Category:** Base Components/Collections/Picker
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Description
@@ -76,12 +78,7 @@ Integrating with `PickerModal` is usually done by the following steps
 
 ### Props
 
-Read `dist/dts-bundle/components/PickerModal.d.ts` for `PickerModal`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/PickerModal.d.ts` for `PickerModal`'s props.
 
 ## BI
 

package/dist/docs/PickerStandalone.md

@@ -2,6 +2,8 @@
 
 **Category:** Base Components/Collections/Picker
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Import
 
 ```tsx

package/dist/docs/PrimaryActionButton.md

@@ -2,6 +2,8 @@
 
 **Category:** Features/Actions/PrimaryActions
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Description
@@ -225,12 +227,7 @@ function OverrideButtonDefaults() {
 
 ### Props
 
-Read `dist/dts-bundle/components/PrimaryActionButton.d.ts` for `PrimaryActionButton`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/PrimaryActionButton.d.ts` for `PrimaryActionButton`'s props.
 
 ## BI
 

package/dist/docs/PrimaryActions.md

@@ -2,6 +2,8 @@
 
 **Category:** Features/Actions/PrimaryActions
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Description
@@ -156,10 +158,5 @@ function WithSubitems() {
 
 ### Props
 
-Read `dist/dts-bundle/components/PrimaryActions.d.ts` for `PrimaryActions`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/PrimaryActions.d.ts` for `PrimaryActions`'s props. Shared shapes cut to a one-line stub there hold 12 of them: `dist/dts-bundle/types/ActionSubitem.d.ts` (12).
 

package/dist/docs/PrimaryPageButton.md

@@ -2,6 +2,8 @@
 
 **Category:** Features/Actions/PrimaryPageButton
 
+Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
+
 ## Design
 
 ### Description
@@ -69,10 +71,5 @@ function Overriding() {
 
 ### Props
 
-Read `dist/dts-bundle/components/PrimaryPageButton.d.ts` for `PrimaryPageButton`'s full prop list, with types and
-descriptions. They are not repeated here, so the bundle is the single source of truth.
-
-A one-line stub in that file is an answer, not a truncation: an empty body with a
-"Produced by" note means you get the value from that hook or factory rather than
-constructing it. `dist/dts-bundle/index.json` maps every name to its bundle path.
+Read `dist/dts-bundle/components/PrimaryPageButton.d.ts` for `PrimaryPageButton`'s props.