@wix/patterns 1.426.0 → 1.430.0

package/src/components/Table/AddFieldColumnHeader.tsx

@@ -0,0 +1,65 @@
+import React, { ReactNode, useContext, useState } from 'react';
+import { IconButton, Popover } from '@wix/design-system';
+import { Add } from '@wix/wix-ui-icons-common';
+import { ToolbarCollectionContext } from '../ToolbarCollectionContext';
+import { classes } from './AddFieldColumnHeader.st.css.js';
+
+export interface AddFieldColumnHeaderProps {
+  children: ReactNode;
+}
+
+export const AddFieldColumnHeader = ({
+  children,
+}: AddFieldColumnHeaderProps) => {
+  const collectionFieldsSource = useContext(
+    ToolbarCollectionContext,
+  )?.collectionFieldsSource;
+  // TODO: fix when the schema source exposes the CMS modal
+  const customColumnAddField = collectionFieldsSource?.fieldsSource
+    .fieldManagement?.canAddFields
+    ? () =>
+        collectionFieldsSource.openFieldModal({
+          origin: 'Custom columns panel',
+        })
+    : undefined;
+  const [hovered, setHovered] = useState(false);
+
+  if (!collectionFieldsSource) {
+    return <>{children}</>;
+  }
+
+  return (
+    <Popover
+      shown={hovered}
+      appendTo="window"
+      placement="top-start"
+      moveBy={{ x: -27, y: -47 }}
+      interactive
+      fluid
+      onMouseEnter={() => setHovered(true)}
+      onMouseLeave={() => setHovered(false)}
+      className={classes.root}
+      dataHook="add-field-popover"
+    >
+      <Popover.Element>
+        <span className={classes.title}>{children}</span>
+      </Popover.Element>
+      <Popover.Content>
+        <span className={classes.hoverBridge}>
+          <IconButton
+            size="tiny"
+            skin="standard"
+            priority="secondary"
+            dataHook="add-field-column-header-button"
+            onClick={(e) => {
+              e.stopPropagation();
+              customColumnAddField?.();
+            }}
+          >
+            <Add />
+          </IconButton>
+        </span>
+      </Popover.Content>
+    </Popover>
+  );
+};

package/src/components/TabsFilter/TabsFilter.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../../stylable-esm-runtime.js";
 
 
 
-var _namespace_ = "TabsFilter1693177651";
+var _namespace_ = "TabsFilter1711245310";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"TabsFilter1693177651__root","title":"TabsFilter1693177651__title"};
+export var classes = {"root":"TabsFilter1711245310__root","title":"TabsFilter1711245310__title"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/components/Tags/ManageTags/ManageTagsModal/ManageTagsModal.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../../../../stylable-esm-runtime.
 
 
 
-var _namespace_ = "ManageTagsModal1377424349";
+var _namespace_ = "ManageTagsModal1320417957";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"ManageTagsModal1377424349__root"};
+export var classes = {"root":"ManageTagsModal1320417957__root"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/components/ToolbarItem/ToolbarItem.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../../stylable-esm-runtime.js";
 
 
 
-var _namespace_ = "ToolbarItem1774963001";
+var _namespace_ = "ToolbarItem714044881";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"ToolbarItem1774963001__root"};
+export var classes = {"root":"ToolbarItem714044881__root"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/components/ToolbarItemBox/ToolbarItemBox.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../../stylable-esm-runtime.js";
 
 
 
-var _namespace_ = "ToolbarItemBox3581991017";
+var _namespace_ = "ToolbarItemBox2861690222";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"ToolbarItemBox3581991017__root"};
+export var classes = {"root":"ToolbarItemBox2861690222__root"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/components/common.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../stylable-esm-runtime.js";
 
 
 
-var _namespace_ = "common1406259648";
+var _namespace_ = "common843717652";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"common1406259648__root","column":"common1406259648__column","fullHeight":"common1406259648__fullHeight"};
+export var classes = {"root":"common843717652__root","column":"common843717652__column","fullHeight":"common843717652__fullHeight"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/exports/schema.ts

@@ -0,0 +1,18 @@
+export {
+  useCollection,
+  useTableCollection,
+  useGridCollection,
+  useEditableTableCollection,
+  useLayoutSwitchCollection,
+  usePlatformizedSource,
+  sourceMutations,
+} from '../schema';
+export type {
+  PlatformizedSourceInput,
+  SchemaCollectionOptions,
+  SchemaEditableTableCollectionOptions,
+  SchemaLayoutSwitchCollectionOptions,
+} from '../schema';
+export type { FieldsSourceProvider } from '../components/fieldsSourceProvider';
+export { useSchemaSource } from '@wix/bex-core/react';
+export type { SchemaSource, SchemaSourceInput } from '@wix/bex-core';

package/src/exports/testkit/index.ts

@@ -12,4 +12,9 @@ export {
   aTagsArray,
   aTag,
 } from '../../test-utils';
-export { exportServiceMocks, appSettingsMocks } from '@wix/bex-core/testkit';
+export {
+  exportServiceMocks,
+  appSettingsMocks,
+  createInMemorySchemaSource,
+} from '@wix/bex-core/testkit';
+export type { InMemorySchemaSourceConfig } from '@wix/bex-core/testkit';

package/src/hooks/index.ts

@@ -3,7 +3,6 @@ export * from './useBuildOption';
 export * from './usePickerModal';
 export * from './usePickerStandalone';
 export * from './useViews';
-export * from './useSchemaImport';
 export * from './useEmptyStateTexts';
 export * from './customModalContent';
 export * from './useDropdownSelectFilterState';

package/src/hooks/useBmHarmonyTheme.ts

@@ -0,0 +1,9 @@
+import { useWixPatternsContainer } from '@wix/bex-core/react';
+
+export const BM_HARMONY_THEME_EXPERIMENT = 'bmHarmonyTheme';
+
+/** Whether the BM harmony visual refresh is enabled for this user. */
+export function useBmHarmonyTheme(): boolean {
+  const { experiments } = useWixPatternsContainer();
+  return experiments.enabled(BM_HARMONY_THEME_EXPERIMENT);
+}

package/src/hooks/useCreateWSRColumnBase.tsx

@@ -2,16 +2,20 @@ import { TableColumn } from '../model';
 import React, { useCallback, type ReactNode } from 'react';
 import { Box, Text } from '@wix/design-system';
 import { getFieldTypeIcon } from '../utils/fieldTypePrefixIcons';
+import { AddFieldColumnHeader } from '../components/Table/AddFieldColumnHeader';
 
 export interface UseCreateWSRColumnBaseParams {
   horizontalScroll?: boolean;
   /** When true, renders field-type prefix icons in column headers. */
   showFieldTypeIcons?: boolean;
+  /** When true, wraps each column header with the AddField hover popover. */
+  showAddFieldButton?: boolean;
 }
 
 export function useCreateWSRColumnBase({
   horizontalScroll,
   showFieldTypeIcons,
+  showAddFieldButton,
 }: UseCreateWSRColumnBaseParams) {
   return useCallback(
     (
@@ -60,10 +64,19 @@ export function useCreateWSRColumnBase({
           title
         );
 
+      const hasTitleText =
+        typeof title === 'string' ? title.trim().length > 0 : Boolean(title);
+      const wrapWithAddField =
+        showAddFieldButton && id !== 'avatar' && hasTitleText;
+
       return {
         id,
         key: id ?? index,
-        title: renderedTitle,
+        title: wrapWithAddField ? (
+          <AddFieldColumnHeader>{renderedTitle}</AddFieldColumnHeader>
+        ) : (
+          renderedTitle
+        ),
         style,
         width: lastColumn && !horizontalScroll ? undefined : width,
         sortable: id && sortable ? true : undefined,
@@ -72,6 +85,6 @@ export function useCreateWSRColumnBase({
           : undefined,
       };
     },
-    [horizontalScroll, showFieldTypeIcons],
+    [horizontalScroll, showFieldTypeIcons, showAddFieldButton],
   );
 }

package/src/hooks/useEntityPage.ts

@@ -13,6 +13,7 @@ export type UseEntityPageParams<T, V extends FieldValues = FieldValues> = Pick<
   | 'form'
   | 'parentPageId'
   | 'parentPath'
+  | 'schemaSource'
 >;
 
 export function useEntityPage<T, V extends FieldValues = FieldValues>(

package/src/hooks/useTableCollection.ts

@@ -8,7 +8,7 @@ import { TableState } from '../state';
 import { useOptionalCachedState } from './useOptionalCachedState';
 import { AiAssistant } from '../aiAssistant';
 
-type TableCollectionConfig<
+export type TableCollectionConfig<
   T,
   F extends FiltersMap,
 > = CollectionConfigWithConditionals<T, F> & {

package/src/index.ts

@@ -6,6 +6,7 @@ export * from './components/PaginationTable';
 export * from './components/CollectionListItem';
 export * from './components/PageWrapper/PageWrapper';
 export * from './components/EntityPage';
+export * from './components/EntityPageFields';
 export * from './components/SettingsPage/SettingsPage';
 export * from './components/MoreActions';
 export * from './components/CollectionPage';
@@ -131,7 +132,6 @@ export {
 export * from './hooks/usePickerStandalone';
 export * from './hooks/useSetupWidget';
 export * from './hooks/useViews';
-export * from './hooks/useSchemaImport';
 export * from './hooks/useTableGridSwitchFolders';
 export * from './hooks/useTableCollection';
 export * from './hooks/useGridCollection';
@@ -246,10 +246,7 @@ export {
   withDashboard,
 } from '@wix/bex-core/react';
 
-export { useCreateImport } from '@wix/bex-core';
 export type { BackupFn } from '@wix/bex-core';
-export { useImportConfig } from '@wix/bex-core';
-export type { UseImportConfigParams } from '@wix/bex-core';
 
 export {
   QueryCache,

package/src/schema/index.ts

@@ -0,0 +1,11 @@
+export * from './useCollection';
+export * from './useTableCollection';
+export * from './useGridCollection';
+export * from './useEditableTableCollection';
+export * from './useLayoutSwitchCollection';
+export {
+  usePlatformizedSource,
+  type PlatformizedSourceInput,
+} from './usePlatformizedSource';
+export type { SchemaCollectionOptions } from './schemaCollectionOptions';
+export { sourceMutations } from './sourceMutations';

package/src/schema/schemaCollectionOptions.ts

@@ -0,0 +1,53 @@
+import { sourceFetchData } from '@wix/bex-core';
+import type {
+  FiltersMap,
+  OffsetQuery,
+  OffsetQueryResult,
+  SchemaSource,
+} from '@wix/bex-core';
+import type { CollectionConfigWithConditionals } from '@wix/bex-core/react';
+
+type FetchData<T> = (query: OffsetQuery) => Promise<OffsetQueryResult<T>>;
+
+/**
+ * The collection options a schema-entry hook accepts — everything the source
+ * doesn't supply. Source-owned keys (`queryName`, `paginationMode`,
+ * `fetchData`, `fetchTotal`, `itemKey`, `itemName`) don't exist here.
+ */
+export type SchemaCollectionOptions<T, F extends FiltersMap> = Omit<
+  CollectionConfigWithConditionals<T, F>,
+  | 'queryName'
+  | 'paginationMode'
+  | 'fetchData'
+  | 'fetchTotal'
+  | 'itemKey'
+  | 'itemName'
+> & {
+  /** Wraps the source's fetch (filter/enrich results) without replacing it. */
+  wrapFetchData?: (next: FetchData<T>) => FetchData<T>;
+};
+
+/** Builds the collection config from the source: the query fetches through the
+ *  source's backend, identity and labels come from the source, and the
+ *  consumer's options fill the rest.
+ *  `options` is typed loosely — the hooks' option types already enforce the
+ *  consumer surface, and TS can't infer `F` back through the conditional
+ *  config type; callers pass the generics explicitly. */
+export function schemaCollectionConfig<T, F extends FiltersMap>(
+  source: SchemaSource<T>,
+  options?: object,
+): CollectionConfigWithConditionals<T, F> {
+  const { wrapFetchData, ...rest } = (options ?? {}) as SchemaCollectionOptions<
+    T,
+    F
+  >;
+  const fetchData = sourceFetchData(source);
+  return {
+    ...rest,
+    queryName: source.collectionId,
+    paginationMode: source.paginationMode,
+    fetchData: wrapFetchData ? wrapFetchData(fetchData) : fetchData,
+    itemKey: source.itemKey,
+    itemName: source.itemName,
+  } as unknown as CollectionConfigWithConditionals<T, F>;
+}

package/src/schema/sourceMutations.ts

@@ -0,0 +1,47 @@
+import type { SourceState } from '@wix/bex-core';
+import type { EditableTableMutationHandlers } from '../state/EditableTable';
+
+const newLocalId = () =>
+  `new-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+
+/**
+ * Row write handlers read from the source's state — the schema-entry default,
+ * so an editable table needs no `mutations` config. The schema loads before
+ * any row can be added or edited.
+ */
+export function sourceMutations<T>(
+  sourceState: SourceState<T>,
+): EditableTableMutationHandlers<T> {
+  const backend = () => {
+    const loaded = sourceState.loadedSchema;
+    if (!loaded) {
+      throw new Error('The schema is not loaded yet');
+    }
+    return loaded.backend;
+  };
+  const required = <F>(fn: F | undefined, action: string): F => {
+    if (!fn) {
+      throw new Error(`The source doesn't support ${action} items`);
+    }
+    return fn;
+  };
+
+  return {
+    createItem: () =>
+      ({ [sourceState.schema?.idField ?? '_id']: newLocalId() } as T),
+    submitCreate: (items) =>
+      Promise.all(
+        items.map((item) => required(backend().create, 'creating')(item)),
+      ),
+    submitUpdate: (items) =>
+      Promise.all(
+        items.map((item) => required(backend().update, 'updating')(item)),
+      ),
+    submitDelete: async (items) => {
+      await required(
+        backend().bulkDelete,
+        'deleting',
+      )(items.map((item) => sourceState.source.itemKey(item)));
+    },
+  };
+}

package/src/schema/useCollection.ts

@@ -0,0 +1,22 @@
+import type {
+  CollectionState,
+  FiltersMap,
+  OptionalFiltersMap,
+  SchemaSource,
+} from '@wix/bex-core';
+import { useCollection as useOpenCollection } from '@wix/bex-core/react';
+import {
+  schemaCollectionConfig,
+  type SchemaCollectionOptions,
+} from './schemaCollectionOptions';
+
+/**
+ * A bare collection driven by a schema source — data half only. For the fields
+ * UI (columns, filters, field management) use a component hook from this entry
+ * (`useTableCollection`, `useLayoutSwitchCollection`, …).
+ */
+export const useCollection = <T, F extends FiltersMap = OptionalFiltersMap>(
+  source: SchemaSource<T>,
+  options?: SchemaCollectionOptions<T, F>,
+): CollectionState<T, F> =>
+  useOpenCollection<T, F>(schemaCollectionConfig<T, F>(source, options));

package/src/schema/useEditableTableCollection.ts

@@ -0,0 +1,87 @@
+import { useState } from 'react';
+import { SourceState } from '@wix/bex-core';
+import type {
+  CollectionOptimisticActionsBaseParams,
+  FiltersMap,
+  OptionalFiltersMap,
+  SchemaSource,
+} from '@wix/bex-core';
+import { useWixPatternsContainer } from '@wix/bex-core/react';
+import type {
+  EditableTableState,
+  EditableTablePermissions,
+  EditableTableMutationHandlers,
+} from '../state/EditableTable';
+import type { CellType } from '../state/EditableTable/types';
+import type { FieldsSourceProvider } from '../components/fieldsSourceProvider';
+import {
+  useEditableTableCollection as useOpenEditableTableCollection,
+  type EditableTableCollectionConfig,
+} from '../hooks/useEditableTableCollection';
+import { SchemaState } from '../components/SchemaSource/SchemaState';
+import {
+  schemaCollectionConfig,
+  type SchemaCollectionOptions,
+} from './schemaCollectionOptions';
+import { sourceMutations } from './sourceMutations';
+import { attachesItself } from './usePlatformizedSource';
+
+export type SchemaEditableTableCollectionOptions<
+  T,
+  F extends FiltersMap = OptionalFiltersMap,
+> = SchemaCollectionOptions<T, F> & {
+  permissions?: EditableTablePermissions;
+  /** Row write handlers. Default: derived from the source's backend
+   *  (`create`/`update`/`bulkDelete`). */
+  mutations?: EditableTableMutationHandlers<T>;
+  optimisticActionParams?: Partial<CollectionOptimisticActionsBaseParams<T, F>>;
+  /** Additional cell types to register alongside the built-in ones. */
+  extraCellTypes?: CellType[];
+};
+
+/** An editable-table collection driven by a source: query config, columns,
+ *  field management, and row writes all come from the source. */
+export function useEditableTableCollection<
+  T,
+  F extends FiltersMap = OptionalFiltersMap,
+>(
+  source: SchemaSource<T>,
+  options?: SchemaEditableTableCollectionOptions<T, F>,
+): EditableTableState<T, F> {
+  const container = useWixPatternsContainer();
+  const [{ fieldsProvider, sourceState }] = useState<{
+    fieldsProvider: FieldsSourceProvider;
+    sourceState: SourceState<T>;
+  }>(() => {
+    const holder = new SourceState<T>({ container, source });
+    if (attachesItself(source)) {
+      // The schema attach path loads it otherwise; the derived row mutations
+      // read the loaded backend.
+      void holder.load();
+      return { fieldsProvider: source, sourceState: holder };
+    }
+    return {
+      fieldsProvider: new SchemaState<T>({ sourceState: holder }),
+      sourceState: holder,
+    };
+  });
+
+  const {
+    permissions,
+    mutations,
+    optimisticActionParams,
+    extraCellTypes,
+    ...rest
+  } = options ?? ({} as SchemaEditableTableCollectionOptions<T, F>);
+
+  const state = useOpenEditableTableCollection<T, F>({
+    ...schemaCollectionConfig<T, F>(source, rest),
+    permissions,
+    mutations: mutations ?? sourceMutations(sourceState),
+    optimisticActionParams,
+    extraCellTypes,
+  } as unknown as EditableTableCollectionConfig<T, F>);
+
+  useState(() => fieldsProvider.setOnTable(state.toolbar));
+  return state;
+}

package/src/schema/useGridCollection.ts

@@ -0,0 +1,40 @@
+import { useState } from 'react';
+import { SourceState } from '@wix/bex-core';
+import type {
+  FiltersMap,
+  OptionalFiltersMap,
+  SchemaSource,
+} from '@wix/bex-core';
+import { useWixPatternsContainer } from '@wix/bex-core/react';
+import type { GridState } from '../state';
+import type { FieldsSourceProvider } from '../components/fieldsSourceProvider';
+import { useGridCollection as useOpenGridCollection } from '../hooks/useGridCollection';
+import { SchemaState } from '../components/SchemaSource/SchemaState';
+import {
+  schemaCollectionConfig,
+  type SchemaCollectionOptions,
+} from './schemaCollectionOptions';
+import { attachesItself } from './usePlatformizedSource';
+
+/** A grid collection driven by a source — the source's filters and field
+ *  management attach to the toolbar even though a grid has no columns. */
+export function useGridCollection<T, F extends FiltersMap = OptionalFiltersMap>(
+  source: SchemaSource<T>,
+  options?: SchemaCollectionOptions<T, F>,
+): GridState<T, F> {
+  const container = useWixPatternsContainer();
+  const [fieldsProvider] = useState<FieldsSourceProvider>(() =>
+    attachesItself(source)
+      ? source
+      : new SchemaState<T>({
+          sourceState: new SourceState<T>({ container, source }),
+        }),
+  );
+
+  const state = useOpenGridCollection<T, F>(
+    schemaCollectionConfig<T, F>(source, options),
+  );
+
+  useState(() => fieldsProvider.setOnTable(state.toolbar));
+  return state;
+}

package/src/schema/useLayoutSwitchCollection.ts

@@ -0,0 +1,89 @@
+import { useState } from 'react';
+import { SourceState } from '@wix/bex-core';
+import type {
+  FiltersMap,
+  OptionalFiltersMap,
+  SchemaSource,
+} from '@wix/bex-core';
+import { useWixPatternsContainer } from '@wix/bex-core/react';
+import type {
+  LayoutSwitchState,
+  TableLayoutConfig,
+  GridLayoutConfig,
+  SpreadsheetLayoutConfig,
+} from '../state/LayoutSwitchState';
+import type { EditableTableMutationHandlers } from '../state/EditableTable';
+import type { FieldsSourceProvider } from '../components/fieldsSourceProvider';
+import {
+  useLayoutSwitchCollection as useOpenLayoutSwitchCollection,
+  type LayoutSwitchCollectionConfig,
+} from '../hooks/useLayoutSwitchCollection';
+import { SchemaState } from '../components/SchemaSource/SchemaState';
+import {
+  schemaCollectionConfig,
+  type SchemaCollectionOptions,
+} from './schemaCollectionOptions';
+import { sourceMutations } from './sourceMutations';
+import { attachesItself } from './usePlatformizedSource';
+
+export type SchemaLayoutSwitchCollectionOptions<
+  T,
+  F extends FiltersMap = OptionalFiltersMap,
+> = SchemaCollectionOptions<T, F> & {
+  table?: TableLayoutConfig;
+  grid?: GridLayoutConfig;
+  spreadsheet?: Omit<
+    SpreadsheetLayoutConfig<T, F>,
+    'createOptimisticActions' | 'mutations'
+  > & {
+    /** Row write handlers. Default: derived from the source's backend. */
+    mutations?: EditableTableMutationHandlers<T>;
+  };
+};
+
+/** One collection and one toolbar driven by a source, shared by every enabled
+ *  layout — the source attaches before any layout mounts, so a page opening
+ *  in grid view has its fields and filters too. */
+export function useLayoutSwitchCollection<
+  T,
+  F extends FiltersMap = OptionalFiltersMap,
+>(
+  source: SchemaSource<T>,
+  options?: SchemaLayoutSwitchCollectionOptions<T, F>,
+): LayoutSwitchState<T, F> {
+  const container = useWixPatternsContainer();
+  const [{ fieldsProvider, sourceState }] = useState<{
+    fieldsProvider: FieldsSourceProvider;
+    sourceState: SourceState<T>;
+  }>(() => {
+    const holder = new SourceState<T>({ container, source });
+    if (attachesItself(source)) {
+      // The schema attach path loads it otherwise; the derived row mutations
+      // read the loaded backend.
+      void holder.load();
+      return { fieldsProvider: source, sourceState: holder };
+    }
+    return {
+      fieldsProvider: new SchemaState<T>({ sourceState: holder }),
+      sourceState: holder,
+    };
+  });
+
+  const { table, grid, spreadsheet, ...rest } =
+    options ?? ({} as SchemaLayoutSwitchCollectionOptions<T, F>);
+
+  const state = useOpenLayoutSwitchCollection<T, F>({
+    ...schemaCollectionConfig<T, F>(source, rest),
+    table,
+    grid,
+    spreadsheet: spreadsheet
+      ? {
+          ...spreadsheet,
+          mutations: spreadsheet.mutations ?? sourceMutations(sourceState),
+        }
+      : undefined,
+  } as unknown as LayoutSwitchCollectionConfig<T, F>);
+
+  useState(() => fieldsProvider.setOnTable(state.toolbar));
+  return state;
+}