@wix/patterns 1.468.0 → 1.469.0

package/dist/docs/SecondaryActions.md

@@ -4,6 +4,8 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## Design
 
 ### Description

package/dist/docs/SettingsPage.AdditionalContent.md

@@ -2,6 +2,8 @@
 
 **Category:** Base Components/Pages/Settings Page
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## API
 
 ### Overview

package/dist/docs/SettingsPage.Card.md

@@ -2,6 +2,8 @@
 
 **Category:** Base Components/Pages/Settings Page
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## Examples
 
 ### Basic

package/dist/docs/SettingsPage.Content.md

@@ -2,6 +2,8 @@
 
 **Category:** Base Components/Pages/Settings Page
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## API
 
 ### Overview

package/dist/docs/SettingsPage.Header.md

@@ -2,6 +2,10 @@
 
 **Category:** Base Components/Pages/Settings Page
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
+Some of that scaffolding is environment-scoped and is **not** needed to use this component: `@wix/ambassador-cairo-dummyservice-v1-dummy-entity/types`. Those resolve only against a Wix build environment (a Yoshi flow's runtime, a generated service client, an internal sibling package) — substitute your own data source and http client rather than installing them.
+
 ## Examples
 
 ### Basic

package/dist/docs/SettingsPage.MainContent.md

@@ -2,6 +2,8 @@
 
 **Category:** Base Components/Pages/Settings Page
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## API
 
 ### Overview

package/dist/docs/SettingsPage.md

@@ -4,6 +4,8 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## Overview
 
 ### Introduction
@@ -31,7 +33,7 @@ In summary, the ``SettingsPage`` component and the associated [`useSettingsPage`
 
 This example demonstrates a basic usage of the `SettingsPage`.
 
-Example code: read `dist/docs/SettingsPage/basic.tsx`
+Example code: read `dist/examples/SettingsPage/basic.tsx`
 
 ---
 
@@ -39,7 +41,7 @@ Example code: read `dist/docs/SettingsPage/basic.tsx`
 
 This example illustrates the use of both main and additional content.
 
-Example code: read `dist/docs/SettingsPage/2-columns.tsx`
+Example code: read `dist/examples/SettingsPage/2-columns.tsx`
 
 ---
 
@@ -47,7 +49,7 @@ Example code: read `dist/docs/SettingsPage/2-columns.tsx`
 
 This sample illustrates the skeleton state of an settings page based on the provided structure.
 
-Example code: read `dist/docs/SettingsPage/loading.tsx`
+Example code: read `dist/examples/SettingsPage/loading.tsx`
 
 ---
 
@@ -55,7 +57,7 @@ Example code: read `dist/docs/SettingsPage/loading.tsx`
 
 This example demonstrates the error state when fetching an settings fails.
 
-Example code: read `dist/docs/SettingsPage/error-on-fetch.tsx`
+Example code: read `dist/examples/SettingsPage/error-on-fetch.tsx`
 
 ---
 
@@ -63,7 +65,7 @@ Example code: read `dist/docs/SettingsPage/error-on-fetch.tsx`
 
 This example demonstrates the error toast when saving an settings fails.
 
-Example code: read `dist/docs/SettingsPage/error-on-save.tsx`
+Example code: read `dist/examples/SettingsPage/error-on-save.tsx`
 
 ---
 
@@ -73,7 +75,7 @@ Example code: read `dist/docs/SettingsPage/error-on-save.tsx`
 
 This demonstrates how to use [useController](https://react-hook-form.com/docs/usecontroller) with the default value set at the `Card.Content` level. Note that the `state.settings` value is initialized following the Card skeleton loader. To obtain the initial value, it must be accessed within the Card.Content child, as illustrated in the following example. Accessing it before or at a higher level will result in an `undefined` value.
 
-Example code: read `dist/docs/SettingsPage/input-initialization-with-usecontroller.tsx`
+Example code: read `dist/examples/SettingsPage/input-initialization-with-usecontroller.tsx`
 
 ---
 
@@ -81,7 +83,7 @@ Example code: read `dist/docs/SettingsPage/input-initialization-with-usecontroll
 
 This demonstrates how to use [Controller](https://react-hook-form.com/docs/usecontroller/controller) where you can easily access the settings by using `useSettings`. This method allows for accessing the settings much earlier in the process. As a result, the default value will be dynamically updated as soon as the settings itself is updated, as shown in the example below.
 
-Example code: read `dist/docs/SettingsPage/input-initialization-with-controller.tsx`
+Example code: read `dist/examples/SettingsPage/input-initialization-with-controller.tsx`
 
 ## API
 

package/dist/docs/SettingsPageState.md

@@ -2,6 +2,8 @@
 
 **Category:** Base Components/Pages/Settings Page/State
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## API
 
 ### Overview

package/dist/docs/SingleSelectFilter.md

@@ -4,6 +4,10 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
+Some of that scaffolding is environment-scoped and is **not** needed to use this component: `@wix/yoshi-flow-bm`. Those resolve only against a Wix build environment (a Yoshi flow's runtime, a generated service client, an internal sibling package) — substitute your own data source and http client rather than installing them.
+
 ## Design
 
 ### Overview
@@ -26,25 +30,25 @@ import { SingleSelectFilter } from '@wix/patterns';
 
 ### Server Data
 
-Example code: read `dist/docs/SingleSelectFilter/server-data.tsx`
+Example code: read `dist/examples/SingleSelectFilter/server-data.tsx`
 
 ### Static Data
 
-Example code: read `dist/docs/SingleSelectFilter/static-data.tsx`
+Example code: read `dist/examples/SingleSelectFilter/static-data.tsx`
 
 ### Empty State
 
-Example code: read `dist/docs/SingleSelectFilter/empty-state.tsx`
+Example code: read `dist/examples/SingleSelectFilter/empty-state.tsx`
 
 ### Sections
 
-Example code: read `dist/docs/SingleSelectFilter/sections.tsx`
+Example code: read `dist/examples/SingleSelectFilter/sections.tsx`
 
 ### Custom render items
 
 The default behavior uses the itemName for rendering the option value. Use renderItem to override it.
 
-Example code: read `dist/docs/SingleSelectFilter/custom-render-items.tsx`
+Example code: read `dist/examples/SingleSelectFilter/custom-render-items.tsx`
 
 ## API
 

package/dist/docs/Sled Tests.md

@@ -2,6 +2,10 @@
 
 **Category:** Guides/Sled Tests
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
+Some of that scaffolding is environment-scoped and is **not** needed to use this component: `@wix/yoshi-flow-bm/sled`. Those resolve only against a Wix build environment (a Yoshi flow's runtime, a generated service client, an internal sibling package) — substitute your own data source and http client rather than installing them.
+
 ## Design
 
 ### Overview

package/dist/docs/Sortable Columns.md

@@ -4,6 +4,8 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## Design
 
 ### Description
@@ -32,13 +34,13 @@ The [`query`](./?path=/story/common-types--computedquery) argument passed to [`f
 
 The **Name** column is defined as sortable in the relevant object in the `columns` array.
 
-Example code: read `dist/docs/Sortable Columns/basic-sortable-column.tsx`
+Example code: read `dist/examples/Sortable Columns/basic-sortable-column.tsx`
 
 ### Custom sort order
 
 Use the `sortMode` property in each columns object in the `columns` array to define the order of the sort options for that column.
 
-Example code: read `dist/docs/Sortable Columns/custom-sort-order.tsx`
+Example code: read `dist/examples/Sortable Columns/custom-sort-order.tsx`
 
 ## BI
 

package/dist/docs/Suggestions.md

@@ -4,6 +4,8 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## Design
 
 ### Description
@@ -45,7 +47,7 @@ export default Basic;
 
 Use `renderMarketingCard(transformFn)` when your offer data has a different structure and needs to be transformed into the `MarketingCardSchema` format.
 
-Example code: read `dist/docs/Suggestions/with-transform-function.tsx`
+Example code: read `dist/examples/Suggestions/with-transform-function.tsx`
 
 ---
 
@@ -53,7 +55,7 @@ Example code: read `dist/docs/Suggestions/with-transform-function.tsx`
 
 Provide a custom `renderCard` function for complete control over the card's appearance and behavior.
 
-Example code: read `dist/docs/Suggestions/custom-card-rendering.tsx`
+Example code: read `dist/examples/Suggestions/custom-card-rendering.tsx`
 
 ---
 
@@ -61,7 +63,7 @@ Example code: read `dist/docs/Suggestions/custom-card-rendering.tsx`
 
 When the number of offers exceeds `maxInlineItems`, the component switches from a fixed container layout (Box) to carousel layout. This example shows the same 3 offers rendered with different `maxInlineItems` values.
 
-Example code: read `dist/docs/Suggestions/carousel-vs-container-layout.tsx`
+Example code: read `dist/examples/Suggestions/carousel-vs-container-layout.tsx`
 
 ---
 
@@ -69,7 +71,7 @@ Example code: read `dist/docs/Suggestions/carousel-vs-container-layout.tsx`
 
 Use `carouselProps` to customize the carousel behavior. See the full [Carousel documentation](https://www.wix-pages.com/wix-design-system-employees/?path=/story/components-media--carousel) for all available options.
 
-Example code: read `dist/docs/Suggestions/carousel-customization.tsx`
+Example code: read `dist/examples/Suggestions/carousel-customization.tsx`
 
 ## API
 

package/dist/docs/SummaryBar.md

@@ -4,6 +4,8 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## Design
 
 ### Description
@@ -16,7 +18,7 @@ This data is not updated dynamically as part of a collection's fetch, meaning yo
 
 This example shows the summary bar in the `"success"` state using the `<SummaryBar>` `status` prop.
 
-Example code: read `dist/docs/SummaryBar/success.tsx`
+Example code: read `dist/examples/SummaryBar/success.tsx`
 
 ---
 
@@ -24,7 +26,7 @@ Example code: read `dist/docs/SummaryBar/success.tsx`
 
 This example shows the summary bar in the `"loading"` state using the `<SummaryBar>` `status` prop.
 
-Example code: read `dist/docs/SummaryBar/loading.tsx`
+Example code: read `dist/examples/SummaryBar/loading.tsx`
 
 ---
 
@@ -32,7 +34,7 @@ Example code: read `dist/docs/SummaryBar/loading.tsx`
 
 This example shows the summary bar in the `"error"` state using the `<SummaryBar>` `status` prop.
 
-Example code: read `dist/docs/SummaryBar/error.tsx`
+Example code: read `dist/examples/SummaryBar/error.tsx`
 
 ---
 
@@ -40,7 +42,7 @@ Example code: read `dist/docs/SummaryBar/error.tsx`
 
 This example shows the summary bar in the `"loading"` state, that changes to the `"success"` state when the data is fetched, using the `<SummaryBar>` `status` prop.
 
-Example code: read `dist/docs/SummaryBar/loading-with-success.tsx`
+Example code: read `dist/examples/SummaryBar/loading-with-success.tsx`
 
 ---
 
@@ -49,7 +51,7 @@ Example code: read `dist/docs/SummaryBar/loading-with-success.tsx`
 This example shows the summary bar in the `"loading"` state, that changes to the `"error"` state when the data fetch fails, using the `<SummaryBar>` `status` prop.
 The `onRetry` prop is used to retry the fetch the data when **Reload** is clicked.
 
-Example code: read `dist/docs/SummaryBar/loading-with-error.tsx`
+Example code: read `dist/examples/SummaryBar/loading-with-error.tsx`
 
 ## API
 

package/dist/docs/Table Sections.md

@@ -4,6 +4,8 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## Design
 
 ### Description
@@ -24,23 +26,23 @@ import { TableSections } from '@wix/patterns';
 
 This example sorts and groups the data by `jobTitle`.
 
-Example code: read `dist/docs/Table Sections/demo.tsx`
+Example code: read `dist/examples/Table Sections/demo.tsx`
 
 ### With Badge
 
 This example shows how to use a badge in the section header.
 
-Example code: read `dist/docs/Table Sections/with-badge.tsx`
+Example code: read `dist/examples/Table Sections/with-badge.tsx`
 
 ### With Summary
 
 This example shows how to use a summary in the section header.
 
-Example code: read `dist/docs/Table Sections/with-summary.tsx`
+Example code: read `dist/examples/Table Sections/with-summary.tsx`
 
 ### With Collapse
 
 This example shows how to use a collapse action in the section header.
 
-Example code: read `dist/docs/Table Sections/with-collapse.tsx`
+Example code: read `dist/examples/Table Sections/with-collapse.tsx`
 

package/dist/docs/Table.md

@@ -4,6 +4,10 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
+Some of that scaffolding is environment-scoped and is **not** needed to use this component: `@wix/ambassador-ecom-v1-order/crud/http`, `@wix/yoshi-flow-bm`. Those resolve only against a Wix build environment (a Yoshi flow's runtime, a generated service client, an internal sibling package) — substitute your own data source and http client rather than installing them.
+
 ## Import
 
 ```tsx
@@ -33,39 +37,39 @@ import { Table } from '@wix/patterns';
 
 ### Basic table
 
-A basic table. Contains a search bar in the table's toolbar by default. To remove the search bar from the table's toolbar, set the `collectionSearch` prop to `false`.
+A basic table. Contains a search bar in the table's toolbar by default. To remove the search bar from the table's toolbar, set the `search` prop to `false`.
 
-Example code: read `dist/docs/Table/basic-table.tsx`
+Example code: read `dist/examples/Table/basic-table.tsx`
 
 ### Horizontal scroll
 
 Enabling horizontal scrolling within rows.
 
-Example code: read `dist/docs/Table/horizontal-scroll.tsx`
+Example code: read `dist/examples/Table/horizontal-scroll.tsx`
 
 ### Filters
 
 A table with filters. Use the `filters` prop to add filter capabilities to the table's toolbar.
 
-Example code: read `dist/docs/Table/filters.tsx`
+Example code: read `dist/examples/Table/filters.tsx`
 
 ### Cursor Pagination
 
 The default pagination is offset but you can change by providing cursor to `paginationMode` property.
 
-Example code: read `dist/docs/Table/cursor-pagination.tsx`
+Example code: read `dist/examples/Table/cursor-pagination.tsx`
 
 ### Header
 
-A table with a header row. Set the `titleBarDisplay` prop to `false` to hide the table header row.
+A table with a header row. Set the `showTitleBar` prop to `false` to hide the table header row.
 
-Example code: read `dist/docs/Table/header.tsx`
+Example code: read `dist/examples/Table/header.tsx`
 
 ### Table disabled rows
 
 set `selectionDisabled` to disabled rows.
 
-Example code: read `dist/docs/Table/table-disabled-rows.tsx`
+Example code: read `dist/examples/Table/table-disabled-rows.tsx`
 
 ---
 
@@ -75,7 +79,7 @@ The `TableVirtual` component is an extension of the `Table` component, designed
 
 It is recommended to use the `rowHeight` prop when the row heights are consistent across the table, and the `estimatedRowHeight` prop when the row heights are variable. Providing the correct props helps to optimize the virtualized rendering process.
 
-Example code: read `dist/docs/Table/virtual.tsx`
+Example code: read `dist/examples/Table/virtual.tsx`
 
 ---
 
@@ -83,7 +87,7 @@ Example code: read `dist/docs/Table/virtual.tsx`
 
 Use the `fetchTotal` prop to retrieve the total number of items in the collection. This example demonstrates how to use the `fetchTotal` prop asynchronously.
 
-Example code: read `dist/docs/Table/fetch-total-async.tsx`
+Example code: read `dist/examples/Table/fetch-total-async.tsx`
 
 ---
 
@@ -93,7 +97,7 @@ Example code: read `dist/docs/Table/fetch-total-async.tsx`
 
 If you have a crud package from ambassador you can use our [useAmbassadorCollection](./?path=/story/common-hooks--useambassadorcollection) hook instead using the default [useCollection](./?path=/story/common-hooks--usecollection).
 
-Example code: read `dist/docs/Table/using-ambassador.tsx`
+Example code: read `dist/examples/Table/using-ambassador.tsx`
 
 ### Using with External Data Source
 
@@ -101,7 +105,7 @@ This example demonstrates how to use the `fetchData` API when data already exist
 
  Note: Ensure that you use the query filter parameters, such as search and limit, to filter the data correctly.
 
-Example code: read `dist/docs/Table/using-with-external-data-source.tsx`
+Example code: read `dist/examples/Table/using-with-external-data-source.tsx`
 
 ## API
 

package/dist/docs/TableDragAndDrop.md

@@ -4,6 +4,10 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
+Some of that scaffolding is environment-scoped and is **not** needed to use this component: `@wix/yoshi-flow-bm`. Those resolve only against a Wix build environment (a Yoshi flow's runtime, a generated service client, an internal sibling package) — substitute your own data source and http client rather than installing them.
+
 ## Design
 
 ### Description
@@ -31,13 +35,13 @@ import { TableDragAndDrop } from '@wix/patterns';
 
 Drag and drop items in a table.
 
-Example code: read `dist/docs/TableDragAndDrop/table.tsx`
+Example code: read `dist/examples/TableDragAndDrop/table.tsx`
 
 ### Specific tabs
 
 Drag and drop items in all tabs except the first tab (All Levels). To do this, leave out the first array (represented by an empty array) in the `dragAndDropCategories` prop.
 
-Example code: read `dist/docs/TableDragAndDrop/specific-tabs.tsx`
+Example code: read `dist/examples/TableDragAndDrop/specific-tabs.tsx`
 
 ### Specific filters
 
@@ -45,13 +49,13 @@ When filters are applied, Drag&Drop isn't supported.
  Saying that, in some use cases (e.g Bookings Services Categories), we want to support Drag&Drop inside a categorty.
  You can define table filters that represent a category and support Drag&Drop.
 
-Example code: read `dist/docs/TableDragAndDrop/specific-filters.tsx`
+Example code: read `dist/examples/TableDragAndDrop/specific-filters.tsx`
 
 ### Save order mode
 
 Pass the `dragAndDropReorderModeToolbar` prop to the `dragAndDropReorderModeToolbar` component to enable **Save Order** mode. This mode gives you the option to save the order your items after dragging and dropping. The order of the items is only updated when the **Save Order** button is clicked.
 
-Example code: read `dist/docs/TableDragAndDrop/save-order-mode.tsx`
+Example code: read `dist/examples/TableDragAndDrop/save-order-mode.tsx`
 
 ## BI
 

package/dist/docs/TableFolders.md

@@ -4,6 +4,10 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
+Some of that scaffolding is environment-scoped and is **not** needed to use this component: `@wix/ambassador-cairo-dummyservice-v1-dummy-entity/types`, `@wix/ambassador-contacts-v4-contact/http`, `@wix/ambassador-contacts-v4-contact/types`, `@wix/yoshi-flow-bm`. Those resolve only against a Wix build environment (a Yoshi flow's runtime, a generated service client, an internal sibling package) — substitute your own data source and http client rather than installing them.
+
 ## Design
 
 ### Description
@@ -19,7 +23,7 @@ import { TableFolders, useTableFolders } from '@wix/patterns';
 
 ### Demo
 
-Example code: read `dist/docs/TableFolders/demo.tsx`
+Example code: read `dist/examples/TableFolders/demo.tsx`
 
 ---
 
@@ -29,7 +33,7 @@ Example code: read `dist/docs/TableFolders/demo.tsx`
 
 Table representation that shows folders and their content
 
-Example code: read `dist/docs/TableFolders/table-folders.tsx`
+Example code: read `dist/examples/TableFolders/table-folders.tsx`
 
 ---
 
@@ -37,7 +41,7 @@ Example code: read `dist/docs/TableFolders/table-folders.tsx`
 
 This example shows a `TableFolders` component with tags. Note that you can only assign tags to table items and not to folders. [See Tags docs](./?path=/story/features-enrich-tags--tags-overview).
 
-Example code: read `dist/docs/TableFolders/with-tags.tsx`
+Example code: read `dist/examples/TableFolders/with-tags.tsx`
 
 ## API
 

package/dist/docs/TableGridSwitch.md

@@ -4,6 +4,8 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## Design
 
 ### Description
@@ -25,13 +27,13 @@ import { TableGridSwitch, useTableGridSwitch } from '@wix/patterns';
 
 A basic table and grid switch. Use the icons in the toolbar to toggle between a Grid view and a Table view.
 
-Example code: read `dist/docs/TableGridSwitch/basic-table-grid-switch.tsx`
+Example code: read `dist/examples/TableGridSwitch/basic-table-grid-switch.tsx`
 
 ### Custom columns
 
 A basic table and grid switch with [custom columns](./?path=/story/features-display--customcolumns). Note that custom columns are only available in the Table view.
 
-Example code: read `dist/docs/TableGridSwitch/custom-columns.tsx`
+Example code: read `dist/examples/TableGridSwitch/custom-columns.tsx`
 
 ## API
 

package/dist/docs/TableGridSwitchDragAndDrop.md

@@ -2,6 +2,8 @@
 
 **Category:** Features/Sort/Drag and Drop
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
 ## Design
 
 ### Description

package/dist/docs/TableGridSwitchFolders.md

@@ -4,6 +4,10 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
+Some of that scaffolding is environment-scoped and is **not** needed to use this component: `@wix/ambassador-cairo-dummyservice-v1-dummy-entity/types`, `@wix/ambassador-contacts-v4-contact/http`, `@wix/ambassador-contacts-v4-contact/types`, `@wix/yoshi-flow-bm`. Those resolve only against a Wix build environment (a Yoshi flow's runtime, a generated service client, an internal sibling package) — substitute your own data source and http client rather than installing them.
+
 ## Design
 
 ### Description
@@ -16,7 +20,7 @@ import { TableGridSwitchFolders, useTableGridSwitchFolders } from '@wix/patterns
 
 ### Demo
 
-Example code: read `dist/docs/TableGridSwitchFolders/demo.tsx`
+Example code: read `dist/examples/TableGridSwitchFolders/demo.tsx`
 
 ---
 
@@ -26,7 +30,7 @@ Example code: read `dist/docs/TableGridSwitchFolders/demo.tsx`
 
 Here's an example of how you can render two collections, including folders and items, within the table grid.
 
-Example code: read `dist/docs/TableGridSwitchFolders/tablegridswitchfolders.tsx`
+Example code: read `dist/examples/TableGridSwitchFolders/tablegridswitchfolders.tsx`
 
 ---
 
@@ -34,7 +38,7 @@ Example code: read `dist/docs/TableGridSwitchFolders/tablegridswitchfolders.tsx`
 
 This example shows a `TableGridSwitchFolders` component with tags. Note that you can only assign tags to table items and not to folders. [See Tags docs](./?path=/story/features-enrich-tags--tags-overview).
 
-Example code: read `dist/docs/TableGridSwitchFolders/with-tags.tsx`
+Example code: read `dist/examples/TableGridSwitchFolders/with-tags.tsx`
 
 ## API
 

package/dist/docs/TableTopNotification.md

@@ -4,6 +4,10 @@
 
 Paths written as `dist/…` below are relative to the `@wix/patterns` package root — the directory holding its `package.json`.
 
+Examples below are illustrative: each one demonstrates this page's API, and everything around it — data source, layout, http client — is only scaffolding to make that runnable.
+
+Some of that scaffolding is environment-scoped and is **not** needed to use this component: `@wix/ambassador-contacts-v4-contact/http`, `@wix/ambassador-contacts-v4-contact/types`, `@wix/yoshi-flow-bm`. Those resolve only against a Wix build environment (a Yoshi flow's runtime, a generated service client, an internal sibling package) — substitute your own data source and http client rather than installing them.
+
 ## Design
 
 ### Description
@@ -21,11 +25,11 @@ import { TableTopNotification } from '@wix/patterns';
 
 ### Base
 
-Example code: read `dist/docs/TableTopNotification/base.tsx`
+Example code: read `dist/examples/TableTopNotification/base.tsx`
 
 ### Nested Table
 
-Example code: read `dist/docs/TableTopNotification/nested-table.tsx`
+Example code: read `dist/examples/TableTopNotification/nested-table.tsx`
 
 ## API