@wix/bex-core 2.332.0 → 2.336.0

package/dist/types/state/SourceState.d.ts

@@ -0,0 +1,39 @@
+import type { Field } from '../types/Field';
+import type { LoadedSchema, Schema } from '../types/Schema';
+import type { SchemaSource } from '../types/SchemaSource';
+import type { ToastConfig } from '../model/toast';
+import { TaskState } from './TaskState';
+import type { WixPatternsContainer } from './WixPatternsContainer';
+export interface SourceStateParams<T> {
+    container: WixPatternsContainer;
+    source: SchemaSource<T>;
+}
+/**
+ * Holds a source's loaded schema, page-neutral: loads it once, exposes its
+ * fields, and runs the source's field mutations with toasts and retry. Page
+ * adapters (collection page, entity page) read from it.
+ */
+export declare class SourceState<T = Record<string, unknown>> {
+    readonly container: WixPatternsContainer;
+    readonly source: SchemaSource<T>;
+    readonly makePrimaryTask: TaskState<unknown>;
+    readonly duplicateTask: TaskState<unknown>;
+    readonly duplicateWithContentTask: TaskState<unknown>;
+    loadedSchema?: LoadedSchema<T>;
+    constructor(params: SourceStateParams<T>);
+    get schema(): Schema | undefined;
+    get fieldActions(): import("../types/Schema").FieldActions | undefined;
+    get fields(): Field[];
+    /** Loads the schema. The consuming page adapter runs this, tracks its status,
+     *  and shows a retry toast on failure. */
+    load: () => Promise<void>;
+    /** Replaces the loaded schema's fields with the map returned by a mutation. */
+    mergeFields(fields: Schema['fields']): void;
+    makePrimary: (fieldId: string) => void;
+    duplicateField: (fieldId: string) => void;
+    duplicateFieldWithContent: (fieldId: string) => void;
+    private runFieldMutation;
+    private currentToastRemove;
+    notify: (config: ToastConfig) => void;
+}
+//# sourceMappingURL=SourceState.d.ts.map

package/dist/types/state/SourceState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourceState.d.ts","sourceRoot":"","sources":["../../../src/state/SourceState.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,SAAS,EAAE,oBAAoB,CAAC;IAChC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,eAAe,qBAAmB;IAC3C,QAAQ,CAAC,aAAa,qBAAmB;IACzC,QAAQ,CAAC,wBAAwB,qBAAmB;IAEpD,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAa;gBAE/B,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAYxC,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAED,IAAI,YAAY,uDAEf;IAED,IAAI,MAAM,IAAI,KAAK,EAAE,CAGpB;IAED;8CAC0C;IAC1C,IAAI,QAAa,QAAQ,IAAI,CAAC,CAK5B;IAEF,+EAA+E;IAC/E,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC;IAWpC,WAAW,YAAa,MAAM,KAAG,IAAI,CAgBnC;IAEF,cAAc,YAAa,MAAM,KAAG,IAAI,CAgBtC;IAEF,yBAAyB,YAAa,MAAM,KAAG,IAAI,CAgBjD;IAMF,OAAO,CAAC,gBAAgB,CAoCtB;IAEF,OAAO,CAAC,kBAAkB,CAA0B;IAIpD,MAAM,WAAY,WAAW,UAO3B;CACH"}

package/dist/types/state/index.d.ts

@@ -16,6 +16,7 @@ export * from './PromisesState';
 export * from './PickerState';
 export * from './PaginationMode';
 export * from './TaskState';
+export * from './SourceState';
 export * from './WixPatternsContainer';
 export * from './ValueBox';
 export * from './BulkSelectState';

package/dist/types/state/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,cAAc,wCAAwC,CAAC;AACvD,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oCAAoC,CAAC;AACnD,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oDAAoD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,cAAc,wCAAwC,CAAC;AACvD,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oCAAoC,CAAC;AACnD,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oDAAoD,CAAC"}

package/dist/types/testkit/WixPatternsContainer.driver.d.ts

@@ -103,6 +103,8 @@ export declare class WixPatternsContainerDriver {
             outcome: import("./hubJobImportMocks").ImportJobOutcome;
             succeeded: number;
             failed: number;
+            created: number;
+            updated: number;
             inProgressPolls: number;
             failedRowIndices: number[];
             uploadedBody: unknown;
@@ -113,6 +115,8 @@ export declare class WixPatternsContainerDriver {
         setOutcome(outcome: import("./hubJobImportMocks").ImportJobOutcome, counts?: {
             succeeded?: number | undefined;
             failed?: number | undefined;
+            created?: number | undefined;
+            updated?: number | undefined;
         }): void;
         setInProgressPolls(n: number): void;
         setFailedRowIndices(indices: number[]): void;

package/dist/types/testkit/WixPatternsContainer.driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WixPatternsContainer.driver.d.ts","sourceRoot":"","sources":["../../../src/testkit/WixPatternsContainer.driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"WixPatternsContainer.driver.d.ts","sourceRoot":"","sources":["../../../src/testkit/WixPatternsContainer.driver.ts"],"names":[],"mappings":"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"}

package/dist/types/testkit/createInMemorySchemaSource.d.ts

@@ -0,0 +1,43 @@
+import { type CreatableFieldType, type SchemaSource } from '../types/SchemaSource';
+import type { ItemPermissions, SchemaPermissions } from '../types/Schema';
+import type { Field } from '../types/Field';
+import { InMemoryBackend } from '../InMemoryBackend';
+export interface InMemorySchemaSource<T> {
+    /** The source to pass anywhere a schema source is accepted. */
+    source: SchemaSource<T>;
+    /** The in-memory backend holding the rows — read or mutate them directly. */
+    backend: InMemoryBackend<T>;
+}
+export interface InMemorySchemaSourceConfig<T> {
+    collectionId: string;
+    /** The collection's fields (keyed internally by `field.id`). */
+    fields: Field[];
+    /** Seed rows the backend serves via `find`/`get`. */
+    items?: T[];
+    /** Defaults to the first field's id, else `idField`. */
+    displayField?: string;
+    /** Defaults to `_id`. */
+    idField?: string;
+    /** Defaults to all-true (add/edit/delete allowed). */
+    schemaPermissions?: SchemaPermissions;
+    itemPermissions?: ItemPermissions;
+    /** Types the add-field modal offers. Defaults to text/number/boolean/date. */
+    creatableFieldTypes?: CreatableFieldType[];
+    supportsPii?: boolean;
+    /** Sources for referenced collections, keyed by referenced collection id. */
+    references?: Record<string, SchemaSource<any>>;
+}
+/**
+ * Builds a real `SchemaSource<T>` backed by in-memory state — no data source (no
+ * `@wix/data`, no network). Its backend `find` serves the seeded `items`, and
+ * its `fieldActions` mutate the in-memory schema and return the updated fields
+ * map, so the create-new-field import flow works end to end (the created column
+ * surfaces via the schema-source merge).
+ *
+ * Returns `{ source, backend }`. Pass `source` anywhere a `SchemaSource` is
+ * accepted — a `@wix/patterns/schema` collection hook, or `<Table
+ * fieldsSource={...} />` (which the import reads from). Use `backend` to read or
+ * assert on the in-memory rows directly.
+ */
+export declare function createInMemorySchemaSource<T extends Record<string, unknown> = Record<string, unknown>>(config: InMemorySchemaSourceConfig<T>): InMemorySchemaSource<T>;
+//# sourceMappingURL=createInMemorySchemaSource.d.ts.map

package/dist/types/testkit/createInMemorySchemaSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createInMemorySchemaSource.d.ts","sourceRoot":"","sources":["../../../src/testkit/createInMemorySchemaSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAGV,eAAe,EAGf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAgBrD,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,+DAA+D;IAC/D,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,6EAA6E;IAC7E,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAoIhE"}

package/dist/types/testkit/hubJobImportMocks.d.ts

@@ -12,6 +12,10 @@ export declare function hubJobImportMocks(whenRequest: typeof import('@wix/http-
         outcome: ImportJobOutcome;
         succeeded: number;
         failed: number;
+        /** new items created (subset of `succeeded`), for the summary step */
+        created: number;
+        /** existing items updated (subset of `succeeded`), for the summary step */
+        updated: number;
         /** number of IN_PROGRESS polls before the job goes terminal */
         inProgressPolls: number;
         /** csvRows indices reported as failed via movement logs */
@@ -23,10 +27,16 @@ export declare function hubJobImportMocks(whenRequest: typeof import('@wix/http-
         submittedJobId: string | undefined;
         terminatedJobIds: string[];
     };
-    /** Set the job's terminal outcome and its success/failure counts. */
+    /**
+     * Set the job's terminal outcome and its counts. `created`/`updated` are the
+     * split of `succeeded` reported to the summary step; when omitted they
+     * default so `created` covers all successes (older jobs report neither).
+     */
     setOutcome(outcome: ImportJobOutcome, counts?: {
         succeeded?: number;
         failed?: number;
+        created?: number;
+        updated?: number;
     }): void;
     /** Make the job report IN_PROGRESS for `n` polls before going terminal. */
     setInProgressPolls(n: number): void;

package/dist/types/testkit/hubJobImportMocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hubJobImportMocks.d.ts","sourceRoot":"","sources":["../../../src/testkit/hubJobImportMocks.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,iDAAiD,CAAC;AAOzD,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,cAAc,iCAAiC,EAAE,WAAW,EACzE,IAAI,EAAE,cAAc,iCAAiC,EAAE,IAAI;;;;;QAMzD,+DAA+D;;QAE/D,2DAA2D;;QAE3D,uEAAuE;;QAEvE,mCAAmC;;;;;IAkCnC,qEAAqE;wBAE1D,gBAAgB,WACjB;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAOjD,2EAA2E;0BACrD,MAAM;IAI5B,uEAAuE;iCAC1C,MAAM,EAAE;IAIrC,2DAA2D;sBACnC,QAAQ,MAAM,CAAC;;;EAkH1C"}
+{"version":3,"file":"hubJobImportMocks.d.ts","sourceRoot":"","sources":["../../../src/testkit/hubJobImportMocks.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,iDAAiD,CAAC;AAOzD,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,cAAc,iCAAiC,EAAE,WAAW,EACzE,IAAI,EAAE,cAAc,iCAAiC,EAAE,IAAI;;;;;QAMzD,sEAAsE;;QAEtE,2EAA2E;;QAE3E,+DAA+D;;QAE/D,2DAA2D;;QAE3D,uEAAuE;;QAEvE,mCAAmC;;;;;IAsCnC;;;;OAIG;wBAEQ,gBAAgB,WACjB;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IASH,2EAA2E;0BACrD,MAAM;IAI5B,uEAAuE;iCAC1C,MAAM,EAAE;IAIrC,2DAA2D;sBACnC,QAAQ,MAAM,CAAC;;;EAoH1C"}

package/dist/types/testkit/index.d.ts

@@ -3,6 +3,7 @@ export * from './productFilters';
 export * from './createProductsBackend';
 export * from './exportServiceMocks';
 export * from './hubJobImportMocks';
+export * from './createInMemorySchemaSource';
 export * from '../test-utils/flush';
 export * from './folder';
 export * from './createFoldersBackend';

package/dist/types/testkit/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testkit/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testkit/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}

package/dist/types/types/Field.d.ts

@@ -15,6 +15,9 @@ interface BaseField {
     helpText?: string;
     /** Whether this is a system-managed field (not user-created). */
     isSystem?: boolean;
+    /** The group this field belongs to, when the source groups its fields.
+     *  Absent ⇒ ungrouped. */
+    group?: string;
     /** Whether this is the collection's primary display field. */
     isPrimary?: boolean;
     validation?: {

package/dist/types/types/Field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../../src/types/Field.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,MAAM,GACN,KAAK,GACL,OAAO,GACP,WAAW,GACX,iBAAiB,GACjB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,eAAe,GACf,SAAS,GACT,WAAW,GACX,UAAU,GACV,cAAc,GACd,gBAAgB,GAChB,OAAO,GACP,OAAO,GACP,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,WAAW,GACX,IAAI,GACJ,QAAQ,GACR,IAAI,GACJ,KAAK,GACL,SAAS,GACT,UAAU,GACV,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,uBAAuB,EAAE,aAAa,EAAE,CAAC;QACzC,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,iBAAiB,EAAE;QACjB,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;CACH;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,OAAO,CAAC,iBAAiB,EAAE,WAAW,GAAG,iBAAiB,CAAC,CAAC;CACnE;AAED,MAAM,MAAM,KAAK,GAAG,cAAc,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAC7E,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC"}
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../../src/types/Field.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,MAAM,GACN,KAAK,GACL,OAAO,GACP,WAAW,GACX,iBAAiB,GACjB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,eAAe,GACf,SAAS,GACT,WAAW,GACX,UAAU,GACV,cAAc,GACd,gBAAgB,GAChB,OAAO,GACP,OAAO,GACP,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,WAAW,GACX,IAAI,GACJ,QAAQ,GACR,IAAI,GACJ,KAAK,GACL,SAAS,GACT,UAAU,GACV,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;8BAC0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,uBAAuB,EAAE,aAAa,EAAE,CAAC;QACzC,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,iBAAiB,EAAE;QACjB,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;CACH;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,OAAO,CAAC,iBAAiB,EAAE,WAAW,GAAG,iBAAiB,CAAC,CAAC;CACnE;AAED,MAAM,MAAM,KAAK,GAAG,cAAc,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAC7E,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC"}

package/dist/types/types/Schema.d.ts

@@ -24,6 +24,8 @@ export interface Schema {
     displayField: string;
     /** The identifier field. */
     idField: string;
+    /** Group display order, present when fields carry a `group`. */
+    groups?: string[];
     /** Absent when the schema's fields cannot be edited. */
     schemaPermissions?: SchemaPermissions;
     itemPermissions?: ItemPermissions;
@@ -53,13 +55,15 @@ export interface BulkInsertResult {
     failed?: number;
     errors?: BulkInsertError[];
 }
-/** Item data access shared by both pagination modes. */
+/** Item data access shared by both pagination modes. `find` (on
+ *  `CollectionBackend`) is the only required call — the rest are capabilities
+ *  a source provides when it (or its consumer) supports them. */
 export interface CollectionBackendBase<T = Record<string, unknown>> {
-    get: (entityId: string) => Promise<T>;
-    create: (entity: Partial<T>) => Promise<T>;
-    update: (entity: T) => Promise<T>;
-    delete: (entityId: string) => Promise<void>;
-    bulkDelete: (entityIds: string[]) => Promise<void>;
+    get?: (entityId: string) => Promise<T>;
+    create?: (entity: Partial<T>) => Promise<T>;
+    update?: (entity: T) => Promise<T>;
+    delete?: (entityId: string) => Promise<void>;
+    bulkDelete?: (entityIds: string[]) => Promise<void>;
     move?: (id: string, params: {
         moveAfterId: string | null | undefined;
     }) => Promise<void>;

package/dist/types/types/Schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../../src/types/Schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../../src/types/Schema.ts"],"names":[],"mappings":"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"}

package/dist/types/types/SchemaSource.d.ts

@@ -2,25 +2,24 @@ import type { Field, PatternsFieldType } from './Field';
 import type { Schema, LoadedSchema } from './Schema';
 import type { FieldPermissions } from './FieldsSource';
 import type { OffsetQuery, OffsetQueryResult } from '../hooks/paginationModeConfig';
-import type { TranslationsKeys } from '../services/translations';
-/** A field type a source allows creating. The label keys are resolved to text by the UI. */
+/** A field type a source allows creating. Declare one entry per
+ *  `patternsType` — the type is the entry's identity. */
 export interface CreatableFieldType {
     patternsType: PatternsFieldType;
-    labelKey: TranslationsKeys;
-    namePlaceholderKey?: TranslationsKeys;
-}
-/** Collection-query config derived from a source, ready to spread into a collection hook. */
-export interface SchemaCollectionConfig<T> {
-    queryName: string;
-    paginationMode: 'offset';
-    fetchData: (query: OffsetQuery) => Promise<OffsetQueryResult<T>>;
-    itemKey: (item: T) => string;
-    itemName: (item: T) => string;
+    /** Custom display name. Absent ⇒ the UI's standard name for this type. */
+    label?: string;
+    /** Custom name-input placeholder. Absent ⇒ the UI's standard placeholder. */
+    namePlaceholder?: string;
 }
 /** What a caller passes. Only `collectionId` and `loadSchema` are required. */
 export interface SchemaSourceInput<T> {
     collectionId: string;
     loadSchema: () => Promise<LoadedSchema<T>>;
+    /** Sources for collections this one references, keyed by the referenced
+     *  collection id. A renderer resolves a reference field through the matching
+     *  entry — its `loadSchema` gives the referenced schema and `sourceFetchData`
+     *  queries the referenced items. Default: none. */
+    references?: Record<string, SchemaSource<any>>;
     paginationMode?: 'offset';
     /** Stable row identity. Default: `row[idField]`. */
     itemKey?: (item: T) => string;
@@ -40,12 +39,23 @@ export interface SchemaSourceInput<T> {
     fieldPermissions?: FieldPermissions;
     /** Default: `false`. */
     supportsPii?: boolean;
+    /** The value of a field on an item. Default: `item[field.id]`. */
+    getFieldValue?: (item: T, field: Field) => unknown;
+    /** Writes a field's value on an item, returning the updated item.
+     *  Default: `{ ...item, [field.id]: value }`. */
+    setFieldValue?: (item: T, field: Field, value: unknown) => T;
 }
 /** The resolved source: defaults filled, `loadSchema` memoized. */
 export interface SchemaSource<T> {
     readonly collectionId: string;
     loadSchema: () => Promise<LoadedSchema<T>>;
-    readonly collectionConfig: SchemaCollectionConfig<T>;
+    readonly paginationMode: 'offset';
+    /** Stable row identity. */
+    itemKey: (item: T) => string;
+    /** Row display label. */
+    itemName: (item: T) => string;
+    /** Sources for referenced collections, keyed by referenced collection id. */
+    readonly references: Record<string, SchemaSource<any>>;
     readonly creatableFieldTypes: CreatableFieldType[];
     searchableFieldIds: (schema: Schema) => string[];
     canAddFields: (schema: Schema) => boolean;
@@ -53,7 +63,14 @@ export interface SchemaSource<T> {
     canDeleteField: (field: Field, schema: Schema) => boolean;
     readonly fieldPermissions?: FieldPermissions;
     readonly supportsPii: boolean;
+    /** The value of a field on an item. */
+    getFieldValue: (item: T, field: Field) => unknown;
+    /** Writes a field's value on an item, returning the updated item. */
+    setFieldValue: (item: T, field: Field, value: unknown) => T;
 }
+/** The collection fetch derived from a source: loads once, then queries the
+ *  backend's `find` scoped to the source's searchable fields. */
+export declare function sourceFetchData<T>(source: SchemaSource<T>): (query: OffsetQuery) => Promise<OffsetQueryResult<T>>;
 /** Fills source-neutral defaults over `input` and memoizes the load so the collection
  *  query and the table columns share a single fetch. */
 export declare function defineSchemaSource<T>(input: SchemaSourceInput<T>): SchemaSource<T>;

package/dist/types/types/SchemaSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaSource.d.ts","sourceRoot":"","sources":["../../../src/types/SchemaSource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SchemaSource.d.ts","sourceRoot":"","sources":["../../../src/types/SchemaSource.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/bex-core",
-  "version": "2.332.0",
+  "version": "2.336.0",
   "license": "UNLICENSED",
   "author": {
     "name": "Kobi",
@@ -41,7 +41,7 @@
     "exports"
   ],
   "dependencies": {
-    "@wix/bex-utils": "2.119.0",
+    "@wix/bex-utils": "2.123.0",
     "chance": "^1.0.0",
     "events": "^3.0.0",
     "formstate": "^2.1.0",
@@ -63,7 +63,7 @@
     "@types/react": "^16.0.0",
     "@wix/auto-crud": "^1.0.108",
     "@wix/babel-cli": "^1.11.0",
-    "@wix/cairo-integration-utils": "1.94.0",
+    "@wix/cairo-integration-utils": "1.98.0",
     "@wix/eslint-config-yoshi": "^6.74.0",
     "@wix/fe-essentials": "^1.233.0",
     "@wix/fe-essentials-standalone": "^1.374.0",
@@ -169,5 +169,5 @@
   "wallaby": {
     "autoDetect": true
   },
-  "falconPackageHash": "0c4856a2f815b5dd5bf0b6527147c9d1e9bbfb113ffde86e004b930e"
+  "falconPackageHash": "1d72baf424077e1255396c300f21e970688f7bb4de64a5da40017f9e"
 }

package/dist/cjs/hooks/useImportConfig.js

@@ -1,12 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.useImportConfig = useImportConfig;
-var _react = require("react");
-/** The manual import config (existing fields + destination/backup/create-new-field). */
-
-function useImportConfig(params) {
-  const [config] = (0, _react.useState)(() => params);
-  return config;
-}
-//# sourceMappingURL=useImportConfig.js.map

package/dist/cjs/hooks/useImportConfig.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_react","require","useImportConfig","params","config","useState"],"sources":["../../../src/hooks/useImportConfig.ts"],"sourcesContent":["import { useState } from 'react';\nimport { ImportButtonConfig } from '../state';\n\n/** The manual import config (existing fields + destination/backup/create-new-field). */\nexport type UseImportConfigParams = ImportButtonConfig;\n\nexport function useImportConfig(\n  params: ImportButtonConfig,\n): ImportButtonConfig {\n  const [config] = useState(() => params);\n\n  return config;\n}\n"],"mappings":";;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAGA;;AAGO,SAASC,eAAeA,CAC7BC,MAA0B,EACN;EACpB,MAAM,CAACC,MAAM,CAAC,GAAG,IAAAC,eAAQ,EAAC,MAAMF,MAAM,CAAC;EAEvC,OAAOC,MAAM;AACf","ignoreList":[]}

package/dist/esm/hooks/useImportConfig.js

@@ -1,6 +0,0 @@
-import { useState } from 'react';
-export function useImportConfig(params) {
-    const [config] = useState(() => params);
-    return config;
-}
-//# sourceMappingURL=useImportConfig.js.map

package/dist/esm/hooks/useImportConfig.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useImportConfig.js","sourceRoot":"","sources":["../../../src/hooks/useImportConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAMjC,MAAM,UAAU,eAAe,CAC7B,MAA0B;IAE1B,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IAExC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/types/hooks/useImportConfig.d.ts

@@ -1,5 +0,0 @@
-import { ImportButtonConfig } from '../state';
-/** The manual import config (existing fields + destination/backup/create-new-field). */
-export type UseImportConfigParams = ImportButtonConfig;
-export declare function useImportConfig(params: ImportButtonConfig): ImportButtonConfig;
-//# sourceMappingURL=useImportConfig.d.ts.map

package/dist/types/hooks/useImportConfig.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useImportConfig.d.ts","sourceRoot":"","sources":["../../../src/hooks/useImportConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,wFAAwF;AACxF,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAEvD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CAIpB"}