@wix/wix-data-items-common 1.0.318 → 1.0.320

package/dist/types/api/WixDataBulkUpdateOptionsBuilder.d.ts

@@ -1,7 +1,7 @@
 import type { FilterExpression } from '@wix/sdk-types';
 import type { WixDataBulkUpdateOptions, WixDataItem, WixDataQuerySpec } from './types';
 /**
- * Builder for bulk update options used by Wix Data bulk update operations.
+ * Options builder for bulk update operations.
  *
  * Use this builder to configure bulk update behavior such as hooks suppression,
  * reference saving, and conditional updates.
@@ -11,22 +11,22 @@ import type { WixDataBulkUpdateOptions, WixDataItem, WixDataQuerySpec } from './
  */
 export interface WixDataBulkUpdateOptionsBuilder {
     /**
-     * Sets whether update hooks are suppressed.
+     * Sets whether to suppress update hooks.
      *
      * When `true`, the bulk update runs without triggering hooks.
      */
     withSuppressHooks(value: boolean): WixDataBulkUpdateOptionsBuilder;
     /**
-     * Sets whether draft items are included when updating items in bulk.
+     * Sets whether to include draft items when updating items in bulk.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataBulkUpdateOptionsBuilder;
     /**
-     * Sets whether referenced items are saved when updating items in bulk.
+     * Sets whether to save referenced items when updating items in bulk.
      */
     withSaveReferences(value: boolean): WixDataBulkUpdateOptionsBuilder;
     /**
-     * Sets the condition that determines which items are updated.
+     * Sets the condition that determines which items to update.
      */
     withCondition(value: FilterExpression<WixDataItem, WixDataQuerySpec>): WixDataBulkUpdateOptionsBuilder;
     /**
@@ -35,12 +35,12 @@ export interface WixDataBulkUpdateOptionsBuilder {
     build(): WixDataBulkUpdateOptions;
 }
 /**
- * Creates a new WixData bulk update options builder.
+ * Creates a new bulk update options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create a bulk update options builder"
  * import { items, BulkUpdateOptionsBuilder, Filter } from '@wix/data'
  *
  * const options = BulkUpdateOptionsBuilder()

package/dist/types/api/WixDataCountOptionsBuilder.d.ts

@@ -1,7 +1,7 @@
 import type { FilterExpression } from '@wix/sdk-types';
 import type { WixDataCountOptions, WixDataItem, WixDataQuerySpec } from './types';
 /**
- * Builder for count options used by Wix Data count operations.
+ * Options builder for count operations.
  *
  * Use this builder to configure count behavior such as hooks suppression,
  * app-specific options, language, consistency, and filters.
@@ -11,13 +11,13 @@ import type { WixDataCountOptions, WixDataItem, WixDataQuerySpec } from './types
  */
 export interface WixDataCountOptionsBuilder {
     /**
-     * Sets whether count hooks are suppressed.
+     * Sets whether to suppress count hooks.
      *
      * When `true`, the count runs without triggering hooks.
      */
     withSuppressHooks(value: boolean): WixDataCountOptionsBuilder;
     /**
-     * Sets whether draft items are included when counting items.
+     * Sets whether to include draft items when counting items.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataCountOptionsBuilder;
@@ -43,12 +43,12 @@ export interface WixDataCountOptionsBuilder {
     build(): WixDataCountOptions;
 }
 /**
- * Creates a new WixData count options builder.
+ * Creates a new count options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create a count options builder"
  * import { items, CountOptionsBuilder } from '@wix/data'
  *
  * const options = CountOptionsBuilder()

package/dist/types/api/WixDataDistinctOptionsBuilder.d.ts

@@ -2,7 +2,7 @@ import type { FilterExpression } from '@wix/sdk-types';
 import type { WixDataDistinctOptions, WixDataItem, WixDataQuerySpec } from './types';
 import type { SortOrder } from '../types/data-item-types';
 /**
- * Builder for distinct options used by Wix Data distinct operations.
+ * Options builder for distinct operations.
  *
  * Use this builder to configure distinct behavior such as language, consistency,
  * filters, ordering, and paging.
@@ -12,13 +12,13 @@ import type { SortOrder } from '../types/data-item-types';
  */
 export interface WixDataDistinctOptionsBuilder {
     /**
-     * Sets whether distinct hooks are suppressed.
+     * Sets whether to suppress distinct hooks.
      *
      * When `true`, the distinct operation runs without triggering hooks.
      */
     withSuppressHooks(value: boolean): WixDataDistinctOptionsBuilder;
     /**
-     * Sets whether draft items are included when retrieving distinct values.
+     * Sets whether to include draft items when retrieving distinct values.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataDistinctOptionsBuilder;
@@ -36,7 +36,7 @@ export interface WixDataDistinctOptionsBuilder {
      */
     withConsistentRead(value: boolean): WixDataDistinctOptionsBuilder;
     /**
-     * Sets whether the total count is returned with the distinct results.
+     * Sets whether to return the total count with the distinct results.
      */
     withReturnTotalCount(value: boolean): WixDataDistinctOptionsBuilder;
     /**
@@ -67,12 +67,12 @@ export interface WixDataDistinctOptionsBuilder {
     build(): WixDataDistinctOptions;
 }
 /**
- * Creates a new WixData distinct options builder.
+ * Creates a new distinct options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create a distinct options builder"
  * import { items, DistinctOptionsBuilder } from '@wix/data'
  *
  * const options = DistinctOptionsBuilder()

package/dist/types/api/WixDataFieldModificationsBuilder.d.ts

@@ -67,11 +67,11 @@ export interface WixDataFieldModificationsBuilder extends FieldModificationsBuil
     build(): FieldModification[];
 }
 /**
- * Creates a new WixData field modifications builder.
+ * Creates a new field modifications builder.
  * @internal
  *
  * @example
- * ```ts
+ * ```ts title="Create field modifications"
  * import { FieldModificationsBuilder } from '@wix/data'
  *
  * const fieldModifications = FieldModificationsBuilder()

package/dist/types/api/WixDataGetOptionsBuilder.d.ts

@@ -1,6 +1,6 @@
 import type { WixDataGetOptions } from './types';
 /**
- * Builder for get options used by Wix Data get operations.
+ * Options builder for get operations.
  *
  * Use this builder to configure get behavior such as hooks suppression,
  * app-specific options, language, consistency, selected
@@ -11,13 +11,13 @@ import type { WixDataGetOptions } from './types';
  */
 export interface WixDataGetOptionsBuilder {
     /**
-     * Sets whether get hooks are suppressed.
+     * Sets whether to suppress get hooks.
      *
      * When `true`, the get operation runs without triggering hooks.
      */
     withSuppressHooks(value: boolean): WixDataGetOptionsBuilder;
     /**
-     * Sets whether draft items are included when retrieving an item.
+     * Sets whether to include draft items when retrieving an item.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataGetOptionsBuilder;
@@ -54,12 +54,12 @@ export interface WixDataGetOptionsBuilder {
     build(): WixDataGetOptions;
 }
 /**
- * Creates a new WixData get options builder.
+ * Creates a new get options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create a get options builder"
  * import { items, GetOptionsBuilder } from '@wix/data'
  *
  * const options = GetOptionsBuilder()

package/dist/types/api/WixDataInsertOptionsBuilder.d.ts

@@ -1,6 +1,6 @@
 import type { WixDataInsertOptions } from './types';
 /**
- * Builder for insert options used by Wix Data insert operations.
+ * Options builder for insert operations.
  *
  * Use this builder to configure insert behavior such as hooks suppression,
  * and reference handling.
@@ -10,23 +10,23 @@ import type { WixDataInsertOptions } from './types';
  */
 export interface WixDataInsertOptionsBuilder {
     /**
-     * Sets whether insert hooks are suppressed.
+     * Sets whether to suppress insert hooks.
      *
      * When `true`, the insert runs without triggering hooks.
      */
     withSuppressHooks(value: boolean): WixDataInsertOptionsBuilder;
     /**
-     * Sets whether draft items are included when inserting an item.
+     * Sets whether to include draft items when inserting an item.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataInsertOptionsBuilder;
     /**
-     * Sets whether references are included when inserting an item.
+     * Sets whether to include references when inserting an item.
      * @internal
      */
     withIncludeReferences(value: boolean): WixDataInsertOptionsBuilder;
     /**
-     * Sets whether referenced items are saved when inserting an item.
+     * Sets whether to save referenced items when inserting an item.
      */
     withSaveReferences(value: boolean): WixDataInsertOptionsBuilder;
     /**
@@ -35,12 +35,12 @@ export interface WixDataInsertOptionsBuilder {
     build(): WixDataInsertOptions;
 }
 /**
- * Creates a new WixData insert options builder.
+ * Creates a new insert options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create an insert options builder"
  * import { items, InsertOptionsBuilder } from '@wix/data'
  *
  * const options = InsertOptionsBuilder()

package/dist/types/api/WixDataIsReferencedOptionsBuilder.d.ts

@@ -1,6 +1,6 @@
 import type { WixDataIsReferencedOptions } from './types';
 /**
- * Builder for isReferenced options used by Wix Data isReferenced operations.
+ * Options builder for isReferenced operations.
  *
  * Use this builder to configure whether the reference check uses a consistent read.
  * @public
@@ -18,12 +18,12 @@ export interface WixDataIsReferencedOptionsBuilder {
     build(): WixDataIsReferencedOptions;
 }
 /**
- * Creates a new WixData isReferenced options builder.
+ * Creates a new isReferenced options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create an isReferenced options builder"
  * import { items, IsReferencedOptionsBuilder } from '@wix/data'
  *
  * const options = IsReferencedOptionsBuilder()

package/dist/types/api/WixDataPatchOptionsBuilder.d.ts

@@ -2,7 +2,7 @@ import type { FilterExpression } from '@wix/sdk-types';
 import type { WixDataItem, WixDataQuerySpec } from './types';
 import type { WixDataPatchOptions } from './WixDataPatch';
 /**
- * Builder for patch options used by Wix Data patch operations.
+ * Options builder for patch operations.
  *
  * Use this builder to configure patch behavior such as hooks suppression,
  * and conditional patching.
@@ -12,18 +12,18 @@ import type { WixDataPatchOptions } from './WixDataPatch';
  */
 export interface WixDataPatchOptionsBuilder {
     /**
-     * Sets whether patch hooks are suppressed.
+     * Sets whether to suppress patch hooks.
      *
      * When `true`, the patch runs without triggering hooks.
      */
     withSuppressHooks(value: boolean): WixDataPatchOptionsBuilder;
     /**
-     * Sets whether draft items are included when patching an item.
+     * Sets whether to include draft items when patching an item.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataPatchOptionsBuilder;
     /**
-     * Sets the condition that determines whether the item is patched.
+     * Sets the condition that determines whether to patch the item.
      */
     withCondition(value: FilterExpression<WixDataItem, WixDataQuerySpec>): WixDataPatchOptionsBuilder;
     /**
@@ -32,12 +32,12 @@ export interface WixDataPatchOptionsBuilder {
     build(): WixDataPatchOptions;
 }
 /**
- * Creates a new WixData patch options builder.
+ * Creates a new patch options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create a patch options builder"
  * import { items, PatchOptionsBuilder, Filter } from '@wix/data'
  *
  * const options = PatchOptionsBuilder()

package/dist/types/api/WixDataQueryBuilder.d.ts

@@ -6,12 +6,12 @@ import { WixDataQueryRequest, WixDataQuerySpec, WixDataItem } from './types';
  */
 export type WixDataQueryBuilder = SDKQueryBuilder<WixDataItem, WixDataQuerySpec, WixDataQueryRequest>;
 /**
- * Creates a new WixData query builder.
+ * Creates a new query builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Build a query"
  * import { items, QueryBuilder, Filter, Sort } from '@wix/data'
  *
  * const request = QueryBuilder()
@@ -35,7 +35,7 @@ export declare const QueryBuilder: () => WixDataQueryBuilder;
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create filter expressions"
  * import { Filter } from '@wix/data'
  *
  * // Simple field filter
@@ -64,7 +64,7 @@ export declare const Filter: FilterFactory<WixDataItem, WixDataQuerySpec>;
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create sort expressions"
  * import { Sort, QueryBuilder } from '@wix/data'
  *
  * // Descending sort

package/dist/types/api/WixDataQueryOptionsBuilder.d.ts

@@ -1,6 +1,6 @@
 import type { WixDataQueryOptions } from './types';
 /**
- * Builder for query options used by Wix Data query operations.
+ * Options builder for query operations.
  *
  * Use this builder to configure query behavior such as hooks suppression,
  * language, reference inclusion, and field groups.
@@ -10,13 +10,13 @@ import type { WixDataQueryOptions } from './types';
  */
 export interface WixDataQueryOptionsBuilder {
     /**
-     * Sets whether query hooks are suppressed.
+     * Sets whether to suppress query hooks.
      *
      * When `true`, the query runs without triggering hooks.
      */
     withSuppressHooks(value: boolean): WixDataQueryOptionsBuilder;
     /**
-     * Sets whether draft items are included in query results.
+     * Sets whether to include draft items in query results.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataQueryOptionsBuilder;
@@ -35,14 +35,14 @@ export interface WixDataQueryOptionsBuilder {
     /**
      * Includes referenced items for the specified reference fields.
      *
-     * Use `limit` to cap how many referenced items are returned per field.
+     * Use `limit` to cap how many referenced items each field returns.
      */
     withIncludeReferences(value: {
         field: string;
         limit?: number;
     }[]): WixDataQueryOptionsBuilder;
     /**
-     * Sets whether the total result count is returned with the query response.
+     * Sets whether to return the total result count with the query response.
      */
     withReturnTotalCount(value: boolean): WixDataQueryOptionsBuilder;
     /**
@@ -55,12 +55,12 @@ export interface WixDataQueryOptionsBuilder {
     build(): WixDataQueryOptions;
 }
 /**
- * Creates a new WixData query options builder.
+ * Creates a new query options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create a query options builder"
  * import { items, QueryOptionsBuilder } from '@wix/data'
  *
  * const options = QueryOptionsBuilder()

package/dist/types/api/WixDataQueryReferencedItemsOptionsBuilder.d.ts

@@ -1,7 +1,7 @@
 import type { SortOrder } from '../types/data-item-types';
 import type { WixDataQueryReferencedItemsOptions } from './types';
 /**
- * Builder for query referenced items options used by Wix Data query referenced items operations.
+ * Options builder for query referenced items operations.
  *
  * Use this builder to configure referenced item query behavior such as language,
  * selected fields, sort order and paging.
@@ -11,7 +11,7 @@ import type { WixDataQueryReferencedItemsOptions } from './types';
  */
 export interface WixDataQueryReferencedItemsOptionsBuilder {
     /**
-     * Sets whether draft items are included in query results.
+     * Sets whether to include draft items in query results.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataQueryReferencedItemsOptionsBuilder;
@@ -28,7 +28,7 @@ export interface WixDataQueryReferencedItemsOptionsBuilder {
      */
     withConsistentRead(value: boolean): WixDataQueryReferencedItemsOptionsBuilder;
     /**
-     * Sets whether the total result count is returned with the query response.
+     * Sets whether to return the total result count with the query response.
      */
     withReturnTotalCount(value: boolean): WixDataQueryReferencedItemsOptionsBuilder;
     /**
@@ -59,12 +59,12 @@ export interface WixDataQueryReferencedItemsOptionsBuilder {
     build(): WixDataQueryReferencedItemsOptions;
 }
 /**
- * Creates a new WixData query referenced items options builder.
+ * Creates a new query referenced items options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create a query referenced items options builder"
  * import { items, QueryReferencedItemsOptionsBuilder } from '@wix/data'
  *
  * const options = QueryReferencedItemsOptionsBuilder()

package/dist/types/api/WixDataRemoveOptionsBuilder.d.ts

@@ -1,7 +1,7 @@
 import type { FilterExpression } from '@wix/sdk-types';
 import type { WixDataItem, WixDataQuerySpec, WixDataRemoveOptions } from './types';
 /**
- * Builder for remove options used by Wix Data remove operations.
+ * Options builder for remove operations.
  *
  * Use this builder to configure remove behavior such as hooks suppression,
  * and conditional removal.
@@ -11,18 +11,18 @@ import type { WixDataItem, WixDataQuerySpec, WixDataRemoveOptions } from './type
  */
 export interface WixDataRemoveOptionsBuilder {
     /**
-     * Sets whether remove hooks are suppressed.
+     * Sets whether to suppress remove hooks.
      *
      * When `true`, the remove operation runs without triggering hooks.
      */
     withSuppressHooks(value: boolean): WixDataRemoveOptionsBuilder;
     /**
-     * Sets whether draft items are included when removing items.
+     * Sets whether to include draft items when removing items.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataRemoveOptionsBuilder;
     /**
-     * Removes the item only when the specified condition is met.
+     * Removes the item only when it matches the specified condition.
      */
     withCondition(value: FilterExpression<WixDataItem, WixDataQuerySpec>): WixDataRemoveOptionsBuilder;
     /**
@@ -31,12 +31,12 @@ export interface WixDataRemoveOptionsBuilder {
     build(): WixDataRemoveOptions;
 }
 /**
- * Creates a new WixData remove options builder.
+ * Creates a new remove options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create a remove options builder"
  * import { items, Filter, RemoveOptionsBuilder } from '@wix/data'
  *
  * const options = RemoveOptionsBuilder()

package/dist/types/api/WixDataSaveOptionsBuilder.d.ts

@@ -1,6 +1,6 @@
 import type { WixDataSaveOptions } from './types';
 /**
- * Builder for save options used by Wix Data save operations.
+ * Options builder for save operations.
  *
  * Use this builder to configure save behavior such as hooks suppression,
  * and saving reference values.
@@ -10,23 +10,23 @@ import type { WixDataSaveOptions } from './types';
  */
 export interface WixDataSaveOptionsBuilder {
     /**
-     * Sets whether save hooks are suppressed.
+     * Sets whether to suppress save hooks.
      *
      * When `true`, the save operation runs without triggering hooks.
      */
     withSuppressHooks(value: boolean): WixDataSaveOptionsBuilder;
     /**
-     * Sets whether draft items are included when saving items.
+     * Sets whether to include draft items when saving items.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataSaveOptionsBuilder;
     /**
-     * Sets whether referenced items are included in the save response.
+     * Sets whether to include referenced items in the save response.
      * @internal
      */
     withIncludeReferences(value: boolean): WixDataSaveOptionsBuilder;
     /**
-     * Sets whether reference values should be saved from the data item.
+     * Sets whether to save reference values from the data item.
      */
     withSaveReferences(value: boolean): WixDataSaveOptionsBuilder;
     /**
@@ -35,12 +35,12 @@ export interface WixDataSaveOptionsBuilder {
     build(): WixDataSaveOptions;
 }
 /**
- * Creates a new WixData save options builder.
+ * Creates a new save options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create a save options builder"
  * import { items, SaveOptionsBuilder } from '@wix/data'
  *
  * const options = SaveOptionsBuilder()

package/dist/types/api/WixDataSearchBuilder.d.ts

@@ -15,16 +15,16 @@ interface WixDataSearchSpec extends SearchSpec {
 }
 type WixDataSearchRequest = SearchRequest<WixDataItem, WixDataSearchSpec>;
 /**
- * WixData SearchBuilder.
+ * Search builder.
  * @public
  */
 export type WixDataSearchBuilder = Omit<SDKSearchBuilder<WixDataItem, WixDataSearchSpec, WixDataSearchRequest>, 'withAggregation' | 'withTimeZone'>;
 /**
- * Creates a new WixData search builder.
+ * Creates a new search builder.
  * @public
  *
  * @example
- * ```ts
+ * ```ts title="Build a search"
  * import { items, SearchBuilder, SearchParams, Filter } from '@wix/data'
  *
  * const request = SearchBuilder()
@@ -42,7 +42,7 @@ export declare const SearchBuilder: () => WixDataSearchBuilder;
  * @public
  *
  * @example
- * ```ts
+ * ```ts title="Create search parameters"
  * import { SearchParams } from '@wix/data'
  * // Simple expression
  * SearchParams.expression('search text')

package/dist/types/api/WixDataSearchOptionsBuilder.d.ts

@@ -1,6 +1,6 @@
 import type { WixDataSearchOptions } from './types';
 /**
- * Builder for search options used by Wix Data search operations.
+ * Options builder for search operations.
  *
  * Use this builder to configure search behavior such as translation language
  * and reference inclusion.
@@ -16,7 +16,7 @@ export interface WixDataSearchOptionsBuilder {
     /**
      * Includes referenced items for the specified reference fields.
      *
-     * Use `limit` to cap how many referenced items are returned per field.
+     * Use `limit` to cap how many referenced items each field returns.
      */
     withIncludeReferences(value: {
         field: string;
@@ -28,12 +28,12 @@ export interface WixDataSearchOptionsBuilder {
     build(): WixDataSearchOptions;
 }
 /**
- * Creates a new WixData search options builder.
+ * Creates a new search options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create a search options builder"
  * import { items, SearchBuilder, SearchOptionsBuilder, SearchParams } from '@wix/data'
  *
  * const searchRequest = SearchBuilder()

package/dist/types/api/WixDataUpdateOptionsBuilder.d.ts

@@ -1,7 +1,7 @@
 import type { FilterExpression } from '@wix/sdk-types';
 import type { WixDataItem, WixDataQuerySpec, WixDataUpdateOptions } from './types';
 /**
- * Builder for update options used by Wix Data update operations.
+ * Options builder for update operations.
  *
  * Use this builder to configure update behavior such as hooks suppression,
  * reference handling, and conditional updates.
@@ -11,27 +11,27 @@ import type { WixDataItem, WixDataQuerySpec, WixDataUpdateOptions } from './type
  */
 export interface WixDataUpdateOptionsBuilder {
     /**
-     * Sets whether update hooks are suppressed.
+     * Sets whether to suppress update hooks.
      *
      * When `true`, the update operation runs without triggering hooks.
      */
     withSuppressHooks(value: boolean): WixDataUpdateOptionsBuilder;
     /**
-     * Sets whether draft items are included when updating items.
+     * Sets whether to include draft items when updating items.
      * @internal
      */
     withShowDrafts(value: boolean): WixDataUpdateOptionsBuilder;
     /**
-     * Sets whether referenced items are included in the update response.
+     * Sets whether to include referenced items in the update response.
      * @internal
      */
     withIncludeReferences(value: boolean): WixDataUpdateOptionsBuilder;
     /**
-     * Sets whether reference values should be saved from the data item.
+     * Sets whether to save reference values from the data item.
      */
     withSaveReferences(value: boolean): WixDataUpdateOptionsBuilder;
     /**
-     * Updates the item only when the specified condition is met.
+     * Updates the item only when it matches the specified condition.
      */
     withCondition(value: FilterExpression<WixDataItem, WixDataQuerySpec>): WixDataUpdateOptionsBuilder;
     /**
@@ -40,12 +40,12 @@ export interface WixDataUpdateOptionsBuilder {
     build(): WixDataUpdateOptions;
 }
 /**
- * Creates a new WixData update options builder.
+ * Creates a new update options builder.
  * @public
  * @documentationMaturity preview
  *
  * @example
- * ```ts
+ * ```ts title="Create an update options builder"
  * import { items, Filter, UpdateOptionsBuilder } from '@wix/data'
  *
  * const options = UpdateOptionsBuilder()