@wix/patterns 1.476.0 → 1.478.0

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

@@ -0,0 +1,9 @@
+interface CmsCollectionSummary {
+    id: string;
+    displayName: string;
+}
+/** Lists the site's CMS collections — for collection pickers. */
+declare function listCmsCollections(): Promise<CmsCollectionSummary[]>;
+
+export { listCmsCollections };
+export type { CmsCollectionSummary };

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

@@ -1,7 +1,7 @@
 import { EventEmitter } from 'events';
 import { ReportProps } from '@wix/fe-essentials/bi';
-import { cairoPageCtaClickedParams } from '@wix/bex-utils/@wix/bi-logger-os-data/v2/types';
 import { ReactNode } from 'react';
+import { cairoPageCtaClickedParams } from '@wix/bex-utils/@wix/bi-logger-os-data/v2/types';
 import { PatternsFieldsAppContainer } from '@wix/patterns-fields/providers';
 import { FieldValues, UseFormReturn } from 'react-hook-form';
 
@@ -108,12 +108,13 @@ interface SchemaPermissions {
     updateField: boolean;
     deleteField: boolean;
 }
-/** The per-item delete verdict. */
-interface RemoveItemDisabledResult {
+interface ItemDisabledResult<R = string> {
     disabled: boolean;
-    /** Why the item cannot be deleted — surfaced to the user by consumers. */
-    reason?: string;
+    reason?: R;
 }
+/** The per-item delete verdict. */
+type RemoveItemDisabledResult = ItemDisabledResult;
+type CreateItemDisabledResult = ItemDisabledResult<ReactNode>;
 /** Item-level CRUD permissions. */
 interface ItemPermissions<T = Record<string, unknown>> {
     createItem: boolean;
@@ -125,6 +126,7 @@ interface ItemPermissions<T = Record<string, unknown>> {
      *  though `deleteItem` is true, optionally with a reason. Must be pure and
      *  synchronous. Absent = all items deletable. */
     isRemoveItemDisabled?: (item: T) => RemoveItemDisabledResult;
+    isCreateItemDisabled?: () => CreateItemDisabledResult;
 }
 /**
  * A source-neutral description of a collection — data only, no behavior.
@@ -551,7 +553,7 @@ declare class EntityPageState<T, V extends FieldValues = FieldValues> implements
     private readonly _parentPageId?;
     private readonly _parentPath?;
     private readonly _parentReferrer?;
-    actionsBarConfig?: EntityPageStateParams<T>['actionsBarConfig'];
+    actionsBarConfig: EntityPageStateParams<T>['actionsBarConfig'];
     /**
      * The page's side-panel host, the way a table's lives on its toolbar.
      * Attached by the first feature that needs one, through

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

@@ -1,4 +1,4 @@
-import { ComponentType, ReactNode, ReactElement, MutableRefObject } from 'react';
+import { ReactNode, ComponentType, ReactElement, MutableRefObject } from 'react';
 
 type PatternsFieldType = 'SHORT_TEXT' | 'LONG_TEXT' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'DATETIME' | 'TIME' | 'URL' | 'ARRAY' | 'REFERENCE' | 'MULTI_REFERENCE' | 'OBJECT' | 'IMAGE' | 'VIDEO' | 'MEDIA_GALLERY' | 'ADDRESS' | 'RICH_TEXT' | 'DOCUMENT' | 'RICH_CONTENT' | 'MULTI_DOCUMENT' | 'EMAIL' | 'AUDIO' | 'COLOR' | 'CUSTOM' | 'UNKNOWN';
 type QueryOperator = 'CONTAINS' | 'ENDS_WITH' | 'EQ' | 'EXISTS' | 'GT' | 'GTE' | 'HAS_ALL' | 'HAS_SOME' | 'LT' | 'LTE' | 'NE' | 'STARTS_WITH' | 'URLIZED';
@@ -96,12 +96,13 @@ interface SchemaPermissions {
     updateField: boolean;
     deleteField: boolean;
 }
-/** The per-item delete verdict. */
-interface RemoveItemDisabledResult {
+interface ItemDisabledResult<R = string> {
     disabled: boolean;
-    /** Why the item cannot be deleted — surfaced to the user by consumers. */
-    reason?: string;
+    reason?: R;
 }
+/** The per-item delete verdict. */
+type RemoveItemDisabledResult = ItemDisabledResult;
+type CreateItemDisabledResult = ItemDisabledResult<ReactNode>;
 /** Item-level CRUD permissions. */
 interface ItemPermissions<T = Record<string, unknown>> {
     createItem: boolean;
@@ -113,6 +114,7 @@ interface ItemPermissions<T = Record<string, unknown>> {
      *  though `deleteItem` is true, optionally with a reason. Must be pure and
      *  synchronous. Absent = all items deletable. */
     isRemoveItemDisabled?: (item: T) => RemoveItemDisabledResult;
+    isCreateItemDisabled?: () => CreateItemDisabledResult;
 }
 /**
  * A source-neutral description of a collection — data only, no behavior.
@@ -279,6 +281,8 @@ interface FieldModalText {
     addSubtitle?: FieldModalSubtitle;
     /** Label of the collapsible section below the main fields. */
     settingsLabel?: string;
+    /** Label of the field ID input. Absent ⇒ the standard key label. */
+    keyLabel?: string;
 }
 /** A warning shown under the PII toggle, with an optional action button. */
 interface FieldPiiWarning {
@@ -610,6 +614,9 @@ interface FieldModalConfig {
     creatable: boolean;
     /** Placeholder for the name input. Absent ⇒ the modal's generic placeholder. */
     namePlaceholder?: string;
+    /** Optional valid field ID base. Default: the normalized uppercase type ID.
+     *  Numeric suffixes are added only on collision. */
+    keyBase?: string;
     /** One-line description under the type in the picker. */
     subtitle?: string;
     /** Group heading this type is listed under in the picker. */
@@ -700,6 +707,9 @@ interface FieldTypeOption {
     label?: string;
     /** Custom name-input placeholder. Absent ⇒ the UI's standard placeholder. */
     namePlaceholder?: string;
+    /** Optional valid field ID base. Default: the normalized uppercase type ID.
+     *  Numeric suffixes are added only on collision. */
+    keyBase?: string;
     /** A one-line description shown under the type in the add-field menu. */
     subtitle?: string;
     /** The group heading this type is listed under in the add-field menu, in
@@ -741,54 +751,12 @@ interface SchemaBiParams {
     tableType?: string;
 }
 /** What a caller passes. Only `collectionId` and `loadSchema` are required. */
-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>>;
-    /** Lazy source lookup for a referenced collection that is not in `references`.
-     *  Is used when a reference field is created in the add field modal.
-     *  The returned source owns its own async schema/item loading. */
-    getReferencedCollectionSource?: (collectionId: string) => SchemaSource<any> | undefined;
-    paginationMode?: 'offset';
-    /** Stable row identity. Default: `row[idField]`. */
-    itemKey?: (item: T) => string;
-    /** Row display label. Default: `row[displayField]`. */
-    itemName?: (item: T) => string;
-    /** Fields free-text search runs against. Default: `[displayField]`. */
-    searchableFieldIds?: (schema: Schema) => string[];
-    /** What the add/edit field modal shows. Default: no types, generic titles. */
-    fieldModal?: FieldModalInput;
-    /** Consumer-defined field types: how a field of that type renders, filters and
-     *  validates wherever it appears. A field with `type: 'CUSTOM'` resolves its
-     *  definition here by `customType`. The add/edit field modal never reads this
-     *  — see `fieldModal`. Default: none. */
-    fieldTypes?: FieldTypeDefinition[];
-    /** Overrides one existing field's type label, icons and collection-picker
-     *  label. Does not change its type, values or add-field options. */
-    getFieldPresentation?: (field: Field) => FieldPresentation | undefined;
-    /** Default: `schemaPermissions.createField`. */
-    canAddFields?: (schema: Schema) => boolean;
-    /** Default: `schemaPermissions.updateField`, except for system fields and
-     *  the id field. */
-    canEditField?: (field: Field, schema: Schema) => boolean;
-    /** Default: `schemaPermissions.deleteField`, except for system fields and
-     *  the id field. */
-    canDeleteField?: (field: Field, schema: Schema) => boolean;
-    /** Resolved when deletion is requested. Undefined keeps the default dialog. */
-    getDeleteFieldConfirmation?: (field: Field, schema: Schema) => DeleteFieldConfirmation | undefined;
-    /** Permission defaults shown in the modal. Absent ⇒ no permissions section. */
-    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;
+/**
+ * `SchemaSourceInput` — cut here because it has its own bundle.
+ * Full shape: `types/SchemaSourceInput.d.ts`.
+ */
+interface SchemaSourceInput<T = any> {
+    [key: string]: unknown;
 }
 /** The resolved source: defaults filled, `loadSchema` memoized. */
 interface SchemaSource<T> {