@wix/multilingual 1.0.38 → 1.0.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/multilingual",
-  "version": "1.0.38",
+  "version": "1.0.39",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -23,7 +23,7 @@
     "@wix/multilingual_site-translator": "1.0.12",
     "@wix/multilingual_translation-contents": "1.0.15",
     "@wix/multilingual_translation-published-contents": "1.0.4",
-    "@wix/multilingual_translation-schemas": "1.0.13"
+    "@wix/multilingual_translation-schemas": "1.0.14"
   },
   "devDependencies": {
     "glob": "^10.4.1",
@@ -48,5 +48,5 @@
       "fqdn": ""
     }
   },
-  "falconPackageHash": "397f35632bfffabd2d3e701e76e553c7e04d867d07fd1d7550f58394"
+  "falconPackageHash": "37a235f0ee89098d7ac7c94dccd0ba00860896c0b2cefd9c3c2aae0a"
 }

package/type-bundles/context.bundle.d.ts

@@ -7986,29 +7986,35 @@ declare namespace context$1 {
 
 interface Schema {
     /**
-     * Schema ID.
+     * Translation schema ID.
      * @readonly
      */
     _id?: string | null;
-    /** (compound key) Schema key. */
+    /** Translation schema unique key identifier. */
     key?: SchemaKey;
-    /** A list of unique fields on the entity in the specific language */
+    /** List of fields for the translation schema. This property uses a string to map to a `SchemaField` (`Map<string, SchemaField>`). The string serves as a key, which you'll need to access each field in the schema and when adding translation content. */
     fields?: Record<string, SchemaField>;
-    /** Fields that will be displayed in content previews (e.g., product name for products). */
+    /** Fields displayed in content previews. For example, a product name for a product translation schema. */
     previewFields?: PreviewFields;
-    /** Whether the schema is hidden from the site. */
+    /** Whether the translation schema is hidden from the site. */
     hidden?: boolean | null;
-    /** The name of the schema */
+    /** Translation schema name. */
     displayName?: string | null;
-    /** Higher level schema, group_by_name will point to an entity of this schema. */
+    /** A reference to the parent schema defined by the app developer. For example, if the schema is for a menu item, this property would link to the schema of the menu it belongs to. */
     parentId?: string | null;
     /** @readonly */
     revision?: string | null;
-    /** @readonly */
+    /**
+     * Date and time the translation schema was created.
+     * @readonly
+     */
     _createdDate?: Date;
-    /** @readonly */
+    /**
+     * Date and time the translation schema was updated.
+     * @readonly
+     */
     _updatedDate?: Date;
-    /** indicate if the content should be duplicated when the site is cloned */
+    /** Whether to duplicate the translated content in the schema when a site containing the translation schema and content is duplicated. */
     duplicateContent?: boolean | null;
 }
 interface SchemaKey {
@@ -8017,9 +8023,14 @@ interface SchemaKey {
      * @readonly
      */
     appId?: string;
-    /** Unique name defined by the creator app, used to distinguish between different entities in the the app domain. */
+    /** A unique name defined by the app developer to differentiate translation schemas for various entities within their app. For example, if an app developer is creating a translation schema for blog posts, the `entityType` can be `'blog-posts'`. */
     entityType?: string;
-    /** Scope schema is defined in (Global/Site) */
+    /**
+     * Scope of the translation schema.
+     * Supported values:
+     * + `GLOBAL`: A global schema for all sites.
+     * + `SITE`: A custom schema for a specific site.
+     */
     scope?: SchemaScope;
 }
 declare enum SchemaScope {
@@ -8031,27 +8042,38 @@ declare enum SchemaScope {
 }
 interface SchemaField {
     /**
-     * Field ID.
+     * Field ID. Validated according to Regex `^[A-Za-z0-9-_)(]+$`. Field IDs may contain parenthesis to reference repeated items, such as images. These parenthesis can't be nested and each open one must have a closed one. For example, `title()()` is valid, while `title)(` and `title(())` aren't valid. The value inside the parenthesis is validated according to Regex `^[^)(\\]\\[\\.]+$`.
      * @readonly
      */
     _id?: string;
-    /** Field type. */
+    /**
+     * Field type.
+     * Supported values:
+     * + `SHORT_TEXT`: Short plain text.
+     * + `LONG_TEXT`: Long plain text.
+     * + `HTML`: Long text including styles, images, and links.
+     * + `RICH_CONTENT`: Rich-Content using the [Wix Ricos.js](https://dev.wix.com/docs/go-headless/tutorials-templates/other-tutorials/working-with-rich-content) format.
+     * + `IMAGE`: Wix Media Manager image.
+     * + `IMAGE_LINK`: Image URL without metadata.
+     * + `VIDEO`: Wix Media Manager video.
+     * + `DOCUMENT`: Wix Media Manager document.
+     */
     type?: FieldType;
-    /** Field descriptive name. */
+    /** Field name. */
     displayName?: string | null;
-    /** Field semantic grouping */
+    /** Field group name. */
     groupName?: string | null;
-    /** Field minimum length (in case of text field) */
+    /** Field minimum text length. */
     minLength?: number | null;
-    /** Field maximum length (in case text field) */
+    /** Field maximum text length. */
     maxLength?: number | null;
-    /** Field format. If set - must be one of the values of wix.api.format as string (case insensitive) */
+    /** Field format. The content will be validated based on the format set here in the field schema. For example, if the format is `EMAIL`, then the content for this field must be a valid email address. */
     format?: string | null;
-    /** Whether the field is hidden from the site. Hidden field constraints (type, min/max length) are still active! */
+    /** Whether the field is hidden from the site. Hidden fields are still validated. */
     hidden?: boolean;
-    /** Whether the field is for display only and should not allowed to be translated */
+    /** Whether the field is read-only, and is not meant to be translated. For example, an image. Use this field as a way to provide more context for the field in the Multilingual Dashboard. */
     displayOnly?: boolean;
-    /** In cases where the order of the fields holds meaning, use this index */
+    /** Field index. Use for cases where the order of the fields are relevant. */
     index?: number | null;
 }
 declare enum FieldType {
@@ -8083,31 +8105,31 @@ interface PreviewFields {
     imageFieldId?: string | null;
 }
 interface CreateSchemaRequest {
-    /** Schema to be created. */
+    /** Translation schema to create. */
     schema?: Schema;
 }
 interface CreateSchemaResponse {
-    /** The created Schema. */
+    /** Newly created translation schema. */
     schema?: Schema;
 }
 interface GetSchemaRequest {
-    /** ID of the Schema to retrieve. */
+    /** ID of the translation schema to retrieve. */
     schemaId: string;
 }
 interface GetSchemaResponse {
-    /** The requested Schema. */
+    /** The requested translation schema. */
     schema?: Schema;
 }
 interface GetSchemaByKeyRequest {
-    /** ID of the Schema to retrieve. */
+    /** ID of the translation schema to retrieve. */
     key: SchemaKey;
 }
 interface GetSchemaByKeyResponse {
-    /** The requested Schema. */
+    /** The requested translation schema. */
     schema?: Schema;
 }
 interface UpdateSchemaRequest {
-    /** Schema to be updated, may be partial. */
+    /** Translation schema to update. */
     schema?: Schema;
 }
 interface UpdateSchemaResponse {
@@ -8115,36 +8137,42 @@ interface UpdateSchemaResponse {
     schema?: Schema;
 }
 interface DeleteSchemaRequest {
-    /** Id of the Schema to delete. */
+    /** ID of the translation schema to delete. */
     schemaId?: string;
 }
 interface DeleteSchemaResponse {
 }
 interface QuerySchemasRequest {
-    /** WQL expression. */
+    /** Query options. */
     query?: CursorQuery;
 }
 interface CursorQuery extends CursorQueryPagingMethodOneOf {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging;
     /**
-     * Filter object in the following format:
-     * `"filter" : {
-     * "fieldName1": "value1",
-     * "fieldName2":{"$operator":"value2"}
-     * }`
-     * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
+     * Filter object.
+     *
+     * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
      */
     filter?: Record<string, any> | null;
     /**
-     * Sort object in the following format:
-     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     * Sort object.
+     *
+     * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
      */
     sort?: Sorting[];
 }
 /** @oneof */
 interface CursorQueryPagingMethodOneOf {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging;
 }
 interface Sorting {
@@ -8169,13 +8197,13 @@ interface CursorPaging {
     cursor?: string | null;
 }
 interface QuerySchemasResponse {
-    /** List of Schemas. */
+    /** List of translation schemas. */
     schemas?: Schema[];
-    /** Paging metadata */
+    /** Paging metadata for the next page of results. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface CursorPagingMetadata {
-    /** Number of items returned in the response. */
+    /** Number of items returned in current page. */
     count?: number | null;
     /** Cursor strings that point to the next page, previous page, or both. */
     cursors?: Cursors;
@@ -8198,9 +8226,9 @@ interface ListSiteSchemasRequest {
     paging?: CursorPaging;
 }
 interface ListSiteSchemasResponse {
-    /** List of Schemas. */
+    /** List of translation schemas. */
     schemas?: Schema[];
-    /** Paging metadata */
+    /** Paging metadata for the next page of results. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface MetaSiteSpecialEvent extends MetaSiteSpecialEventPayloadOneOf {
@@ -8671,9 +8699,14 @@ interface GetSchemaByKeyIdentifiers {
      * @readonly
      */
     keyAppId?: string;
-    /** Unique name defined by the creator app, used to distinguish between different entities in the the app domain. */
+    /** A unique name defined by the app developer to differentiate translation schemas for various entities within their app. For example, if an app developer is creating a translation schema for blog posts, the `entityType` can be `'blog-posts'`. */
     keyEntityType?: string;
-    /** Scope schema is defined in (Global/Site) */
+    /**
+     * Scope of the translation schema.
+     * Supported values:
+     * + `GLOBAL`: A global schema for all sites.
+     * + `SITE`: A custom schema for a specific site.
+     */
     keyScope?: SchemaScope;
 }
 interface QuerySchemasOptions {
@@ -8743,30 +8776,39 @@ interface ListSiteSchemasOptions {
 declare function getSchema$1(httpClient: HttpClient): GetSchemaSignature;
 interface GetSchemaSignature {
     /**
-     * Retrieves a Schema.
-     * @param - ID of the Schema to retrieve.
-     * @returns The requested Schema.
+     * Retrieves a translation schema.
+     * @param - ID of the translation schema to retrieve.
+     * @returns The requested translation schema.
      */
     (schemaId: string): Promise<Schema & SchemaNonNullableFields>;
 }
 declare function getSchemaByKey$1(httpClient: HttpClient): GetSchemaByKeySignature;
 interface GetSchemaByKeySignature {
     /**
-     * Retrieves a Schema by key.
+     * Retrieves a translation schema by key.
      */
     (identifiers: GetSchemaByKeyIdentifiers, key: GetSchemaByKey): Promise<GetSchemaByKeyResponse & GetSchemaByKeyResponseNonNullableFields>;
 }
 declare function querySchemas$1(httpClient: HttpClient): QuerySchemasSignature;
 interface QuerySchemasSignature {
     /**
-     * Retrieves a list of Schemas, given the provided [paging, filtering, and sorting][1].
+     * Retrieves a list of schemas, given the provided paging, filtering, and sorting. Up to 100 schemas can be returned per request.
+     *
+     * > **Note:**
+     * >
+     * > This method can retrieve all schemas with a `GLOBAL` scope and `SITE` scope schemas for the site you are authorized for in the current API request.
+     *
+     * The default `sort` is `id` in `ASC`.
+     *
+     * For a detailed list of supported operations, see [Translation Schema: Supported Filters and Sorting](https://dev.wix.com/docs/rest/business-management/multilingual/translation/translation-schema/translation-schema/sort-and-filter).
+     * To learn how to query translation schemas, see [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language).
      */
     (options?: QuerySchemasOptions | undefined): SchemasQueryBuilder;
 }
 declare function listSiteSchemas$1(httpClient: HttpClient): ListSiteSchemasSignature;
 interface ListSiteSchemasSignature {
     /**
-     * Retrieves a list of Schemas of app installed on site.
+     * Retrieves a list of all translation schemas associated with a site, including those created by you or other developers.
      */
     (options?: ListSiteSchemasOptions | undefined): Promise<ListSiteSchemasResponse & ListSiteSchemasResponseNonNullableFields>;
 }

package/type-bundles/index.bundle.d.ts

@@ -7986,29 +7986,35 @@ declare namespace index_d$1 {
 
 interface Schema {
     /**
-     * Schema ID.
+     * Translation schema ID.
      * @readonly
      */
     _id?: string | null;
-    /** (compound key) Schema key. */
+    /** Translation schema unique key identifier. */
     key?: SchemaKey;
-    /** A list of unique fields on the entity in the specific language */
+    /** List of fields for the translation schema. This property uses a string to map to a `SchemaField` (`Map<string, SchemaField>`). The string serves as a key, which you'll need to access each field in the schema and when adding translation content. */
     fields?: Record<string, SchemaField>;
-    /** Fields that will be displayed in content previews (e.g., product name for products). */
+    /** Fields displayed in content previews. For example, a product name for a product translation schema. */
     previewFields?: PreviewFields;
-    /** Whether the schema is hidden from the site. */
+    /** Whether the translation schema is hidden from the site. */
     hidden?: boolean | null;
-    /** The name of the schema */
+    /** Translation schema name. */
     displayName?: string | null;
-    /** Higher level schema, group_by_name will point to an entity of this schema. */
+    /** A reference to the parent schema defined by the app developer. For example, if the schema is for a menu item, this property would link to the schema of the menu it belongs to. */
     parentId?: string | null;
     /** @readonly */
     revision?: string | null;
-    /** @readonly */
+    /**
+     * Date and time the translation schema was created.
+     * @readonly
+     */
     _createdDate?: Date;
-    /** @readonly */
+    /**
+     * Date and time the translation schema was updated.
+     * @readonly
+     */
     _updatedDate?: Date;
-    /** indicate if the content should be duplicated when the site is cloned */
+    /** Whether to duplicate the translated content in the schema when a site containing the translation schema and content is duplicated. */
     duplicateContent?: boolean | null;
 }
 interface SchemaKey {
@@ -8017,9 +8023,14 @@ interface SchemaKey {
      * @readonly
      */
     appId?: string;
-    /** Unique name defined by the creator app, used to distinguish between different entities in the the app domain. */
+    /** A unique name defined by the app developer to differentiate translation schemas for various entities within their app. For example, if an app developer is creating a translation schema for blog posts, the `entityType` can be `'blog-posts'`. */
     entityType?: string;
-    /** Scope schema is defined in (Global/Site) */
+    /**
+     * Scope of the translation schema.
+     * Supported values:
+     * + `GLOBAL`: A global schema for all sites.
+     * + `SITE`: A custom schema for a specific site.
+     */
     scope?: SchemaScope;
 }
 declare enum SchemaScope {
@@ -8031,27 +8042,38 @@ declare enum SchemaScope {
 }
 interface SchemaField {
     /**
-     * Field ID.
+     * Field ID. Validated according to Regex `^[A-Za-z0-9-_)(]+$`. Field IDs may contain parenthesis to reference repeated items, such as images. These parenthesis can't be nested and each open one must have a closed one. For example, `title()()` is valid, while `title)(` and `title(())` aren't valid. The value inside the parenthesis is validated according to Regex `^[^)(\\]\\[\\.]+$`.
      * @readonly
      */
     _id?: string;
-    /** Field type. */
+    /**
+     * Field type.
+     * Supported values:
+     * + `SHORT_TEXT`: Short plain text.
+     * + `LONG_TEXT`: Long plain text.
+     * + `HTML`: Long text including styles, images, and links.
+     * + `RICH_CONTENT`: Rich-Content using the [Wix Ricos.js](https://dev.wix.com/docs/go-headless/tutorials-templates/other-tutorials/working-with-rich-content) format.
+     * + `IMAGE`: Wix Media Manager image.
+     * + `IMAGE_LINK`: Image URL without metadata.
+     * + `VIDEO`: Wix Media Manager video.
+     * + `DOCUMENT`: Wix Media Manager document.
+     */
     type?: FieldType;
-    /** Field descriptive name. */
+    /** Field name. */
     displayName?: string | null;
-    /** Field semantic grouping */
+    /** Field group name. */
     groupName?: string | null;
-    /** Field minimum length (in case of text field) */
+    /** Field minimum text length. */
     minLength?: number | null;
-    /** Field maximum length (in case text field) */
+    /** Field maximum text length. */
     maxLength?: number | null;
-    /** Field format. If set - must be one of the values of wix.api.format as string (case insensitive) */
+    /** Field format. The content will be validated based on the format set here in the field schema. For example, if the format is `EMAIL`, then the content for this field must be a valid email address. */
     format?: string | null;
-    /** Whether the field is hidden from the site. Hidden field constraints (type, min/max length) are still active! */
+    /** Whether the field is hidden from the site. Hidden fields are still validated. */
     hidden?: boolean;
-    /** Whether the field is for display only and should not allowed to be translated */
+    /** Whether the field is read-only, and is not meant to be translated. For example, an image. Use this field as a way to provide more context for the field in the Multilingual Dashboard. */
     displayOnly?: boolean;
-    /** In cases where the order of the fields holds meaning, use this index */
+    /** Field index. Use for cases where the order of the fields are relevant. */
     index?: number | null;
 }
 declare enum FieldType {
@@ -8083,31 +8105,31 @@ interface PreviewFields {
     imageFieldId?: string | null;
 }
 interface CreateSchemaRequest {
-    /** Schema to be created. */
+    /** Translation schema to create. */
     schema?: Schema;
 }
 interface CreateSchemaResponse {
-    /** The created Schema. */
+    /** Newly created translation schema. */
     schema?: Schema;
 }
 interface GetSchemaRequest {
-    /** ID of the Schema to retrieve. */
+    /** ID of the translation schema to retrieve. */
     schemaId: string;
 }
 interface GetSchemaResponse {
-    /** The requested Schema. */
+    /** The requested translation schema. */
     schema?: Schema;
 }
 interface GetSchemaByKeyRequest {
-    /** ID of the Schema to retrieve. */
+    /** ID of the translation schema to retrieve. */
     key: SchemaKey;
 }
 interface GetSchemaByKeyResponse {
-    /** The requested Schema. */
+    /** The requested translation schema. */
     schema?: Schema;
 }
 interface UpdateSchemaRequest {
-    /** Schema to be updated, may be partial. */
+    /** Translation schema to update. */
     schema?: Schema;
 }
 interface UpdateSchemaResponse {
@@ -8115,36 +8137,42 @@ interface UpdateSchemaResponse {
     schema?: Schema;
 }
 interface DeleteSchemaRequest {
-    /** Id of the Schema to delete. */
+    /** ID of the translation schema to delete. */
     schemaId?: string;
 }
 interface DeleteSchemaResponse {
 }
 interface QuerySchemasRequest {
-    /** WQL expression. */
+    /** Query options. */
     query?: CursorQuery;
 }
 interface CursorQuery extends CursorQueryPagingMethodOneOf {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging;
     /**
-     * Filter object in the following format:
-     * `"filter" : {
-     * "fieldName1": "value1",
-     * "fieldName2":{"$operator":"value2"}
-     * }`
-     * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
+     * Filter object.
+     *
+     * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
      */
     filter?: Record<string, any> | null;
     /**
-     * Sort object in the following format:
-     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     * Sort object.
+     *
+     * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
      */
     sort?: Sorting[];
 }
 /** @oneof */
 interface CursorQueryPagingMethodOneOf {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging;
 }
 interface Sorting {
@@ -8169,13 +8197,13 @@ interface CursorPaging {
     cursor?: string | null;
 }
 interface QuerySchemasResponse {
-    /** List of Schemas. */
+    /** List of translation schemas. */
     schemas?: Schema[];
-    /** Paging metadata */
+    /** Paging metadata for the next page of results. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface CursorPagingMetadata {
-    /** Number of items returned in the response. */
+    /** Number of items returned in current page. */
     count?: number | null;
     /** Cursor strings that point to the next page, previous page, or both. */
     cursors?: Cursors;
@@ -8198,9 +8226,9 @@ interface ListSiteSchemasRequest {
     paging?: CursorPaging;
 }
 interface ListSiteSchemasResponse {
-    /** List of Schemas. */
+    /** List of translation schemas. */
     schemas?: Schema[];
-    /** Paging metadata */
+    /** Paging metadata for the next page of results. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface MetaSiteSpecialEvent extends MetaSiteSpecialEventPayloadOneOf {
@@ -8671,9 +8699,14 @@ interface GetSchemaByKeyIdentifiers {
      * @readonly
      */
     keyAppId?: string;
-    /** Unique name defined by the creator app, used to distinguish between different entities in the the app domain. */
+    /** A unique name defined by the app developer to differentiate translation schemas for various entities within their app. For example, if an app developer is creating a translation schema for blog posts, the `entityType` can be `'blog-posts'`. */
     keyEntityType?: string;
-    /** Scope schema is defined in (Global/Site) */
+    /**
+     * Scope of the translation schema.
+     * Supported values:
+     * + `GLOBAL`: A global schema for all sites.
+     * + `SITE`: A custom schema for a specific site.
+     */
     keyScope?: SchemaScope;
 }
 interface QuerySchemasOptions {
@@ -8743,30 +8776,39 @@ interface ListSiteSchemasOptions {
 declare function getSchema$1(httpClient: HttpClient): GetSchemaSignature;
 interface GetSchemaSignature {
     /**
-     * Retrieves a Schema.
-     * @param - ID of the Schema to retrieve.
-     * @returns The requested Schema.
+     * Retrieves a translation schema.
+     * @param - ID of the translation schema to retrieve.
+     * @returns The requested translation schema.
      */
     (schemaId: string): Promise<Schema & SchemaNonNullableFields>;
 }
 declare function getSchemaByKey$1(httpClient: HttpClient): GetSchemaByKeySignature;
 interface GetSchemaByKeySignature {
     /**
-     * Retrieves a Schema by key.
+     * Retrieves a translation schema by key.
      */
     (identifiers: GetSchemaByKeyIdentifiers, key: GetSchemaByKey): Promise<GetSchemaByKeyResponse & GetSchemaByKeyResponseNonNullableFields>;
 }
 declare function querySchemas$1(httpClient: HttpClient): QuerySchemasSignature;
 interface QuerySchemasSignature {
     /**
-     * Retrieves a list of Schemas, given the provided [paging, filtering, and sorting][1].
+     * Retrieves a list of schemas, given the provided paging, filtering, and sorting. Up to 100 schemas can be returned per request.
+     *
+     * > **Note:**
+     * >
+     * > This method can retrieve all schemas with a `GLOBAL` scope and `SITE` scope schemas for the site you are authorized for in the current API request.
+     *
+     * The default `sort` is `id` in `ASC`.
+     *
+     * For a detailed list of supported operations, see [Translation Schema: Supported Filters and Sorting](https://dev.wix.com/docs/rest/business-management/multilingual/translation/translation-schema/translation-schema/sort-and-filter).
+     * To learn how to query translation schemas, see [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language).
      */
     (options?: QuerySchemasOptions | undefined): SchemasQueryBuilder;
 }
 declare function listSiteSchemas$1(httpClient: HttpClient): ListSiteSchemasSignature;
 interface ListSiteSchemasSignature {
     /**
-     * Retrieves a list of Schemas of app installed on site.
+     * Retrieves a list of all translation schemas associated with a site, including those created by you or other developers.
      */
     (options?: ListSiteSchemasOptions | undefined): Promise<ListSiteSchemasResponse & ListSiteSchemasResponseNonNullableFields>;
 }

package/type-bundles/meta.bundle.d.ts

@@ -12042,29 +12042,35 @@ declare namespace meta$1 {
 
 interface Schema$1 {
     /**
-     * Schema ID.
+     * Translation schema ID.
      * @readonly
      */
     id?: string | null;
-    /** (compound key) Schema key. */
+    /** Translation schema unique key identifier. */
     key?: SchemaKey$1;
-    /** A list of unique fields on the entity in the specific language */
+    /** List of fields for the translation schema. This property uses a string to map to a `SchemaField` (`Map<string, SchemaField>`). The string serves as a key, which you'll need to access each field in the schema and when adding translation content. */
     fields?: Record<string, SchemaField$1>;
-    /** Fields that will be displayed in content previews (e.g., product name for products). */
+    /** Fields displayed in content previews. For example, a product name for a product translation schema. */
     previewFields?: PreviewFields$1;
-    /** Whether the schema is hidden from the site. */
+    /** Whether the translation schema is hidden from the site. */
     hidden?: boolean | null;
-    /** The name of the schema */
+    /** Translation schema name. */
     displayName?: string | null;
-    /** Higher level schema, group_by_name will point to an entity of this schema. */
+    /** A reference to the parent schema defined by the app developer. For example, if the schema is for a menu item, this property would link to the schema of the menu it belongs to. */
     parentId?: string | null;
     /** @readonly */
     revision?: string | null;
-    /** @readonly */
+    /**
+     * Date and time the translation schema was created.
+     * @readonly
+     */
     createdDate?: Date;
-    /** @readonly */
+    /**
+     * Date and time the translation schema was updated.
+     * @readonly
+     */
     updatedDate?: Date;
-    /** indicate if the content should be duplicated when the site is cloned */
+    /** Whether to duplicate the translated content in the schema when a site containing the translation schema and content is duplicated. */
     duplicateContent?: boolean | null;
 }
 interface SchemaKey$1 {
@@ -12073,9 +12079,14 @@ interface SchemaKey$1 {
      * @readonly
      */
     appId?: string;
-    /** Unique name defined by the creator app, used to distinguish between different entities in the the app domain. */
+    /** A unique name defined by the app developer to differentiate translation schemas for various entities within their app. For example, if an app developer is creating a translation schema for blog posts, the `entityType` can be `'blog-posts'`. */
     entityType?: string;
-    /** Scope schema is defined in (Global/Site) */
+    /**
+     * Scope of the translation schema.
+     * Supported values:
+     * + `GLOBAL`: A global schema for all sites.
+     * + `SITE`: A custom schema for a specific site.
+     */
     scope?: SchemaScope$1;
 }
 declare enum SchemaScope$1 {
@@ -12087,27 +12098,38 @@ declare enum SchemaScope$1 {
 }
 interface SchemaField$1 {
     /**
-     * Field ID.
+     * Field ID. Validated according to Regex `^[A-Za-z0-9-_)(]+$`. Field IDs may contain parenthesis to reference repeated items, such as images. These parenthesis can't be nested and each open one must have a closed one. For example, `title()()` is valid, while `title)(` and `title(())` aren't valid. The value inside the parenthesis is validated according to Regex `^[^)(\\]\\[\\.]+$`.
      * @readonly
      */
     id?: string;
-    /** Field type. */
+    /**
+     * Field type.
+     * Supported values:
+     * + `SHORT_TEXT`: Short plain text.
+     * + `LONG_TEXT`: Long plain text.
+     * + `HTML`: Long text including styles, images, and links.
+     * + `RICH_CONTENT`: Rich-Content using the [Wix Ricos.js](https://dev.wix.com/docs/go-headless/tutorials-templates/other-tutorials/working-with-rich-content) format.
+     * + `IMAGE`: Wix Media Manager image.
+     * + `IMAGE_LINK`: Image URL without metadata.
+     * + `VIDEO`: Wix Media Manager video.
+     * + `DOCUMENT`: Wix Media Manager document.
+     */
     type?: FieldType$1;
-    /** Field descriptive name. */
+    /** Field name. */
     displayName?: string | null;
-    /** Field semantic grouping */
+    /** Field group name. */
     groupName?: string | null;
-    /** Field minimum length (in case of text field) */
+    /** Field minimum text length. */
     minLength?: number | null;
-    /** Field maximum length (in case text field) */
+    /** Field maximum text length. */
     maxLength?: number | null;
-    /** Field format. If set - must be one of the values of wix.api.format as string (case insensitive) */
+    /** Field format. The content will be validated based on the format set here in the field schema. For example, if the format is `EMAIL`, then the content for this field must be a valid email address. */
     format?: string | null;
-    /** Whether the field is hidden from the site. Hidden field constraints (type, min/max length) are still active! */
+    /** Whether the field is hidden from the site. Hidden fields are still validated. */
     hidden?: boolean;
-    /** Whether the field is for display only and should not allowed to be translated */
+    /** Whether the field is read-only, and is not meant to be translated. For example, an image. Use this field as a way to provide more context for the field in the Multilingual Dashboard. */
     displayOnly?: boolean;
-    /** In cases where the order of the fields holds meaning, use this index */
+    /** Field index. Use for cases where the order of the fields are relevant. */
     index?: number | null;
 }
 declare enum FieldType$1 {
@@ -12139,46 +12161,52 @@ interface PreviewFields$1 {
     imageFieldId?: string | null;
 }
 interface GetSchemaRequest$1 {
-    /** ID of the Schema to retrieve. */
+    /** ID of the translation schema to retrieve. */
     schemaId: string;
 }
 interface GetSchemaResponse$1 {
-    /** The requested Schema. */
+    /** The requested translation schema. */
     schema?: Schema$1;
 }
 interface GetSchemaByKeyRequest$1 {
-    /** ID of the Schema to retrieve. */
+    /** ID of the translation schema to retrieve. */
     key: SchemaKey$1;
 }
 interface GetSchemaByKeyResponse$1 {
-    /** The requested Schema. */
+    /** The requested translation schema. */
     schema?: Schema$1;
 }
 interface QuerySchemasRequest$1 {
-    /** WQL expression. */
+    /** Query options. */
     query?: CursorQuery$1;
 }
 interface CursorQuery$1 extends CursorQueryPagingMethodOneOf$1 {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging$1;
     /**
-     * Filter object in the following format:
-     * `"filter" : {
-     * "fieldName1": "value1",
-     * "fieldName2":{"$operator":"value2"}
-     * }`
-     * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
+     * Filter object.
+     *
+     * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
      */
     filter?: Record<string, any> | null;
     /**
-     * Sort object in the following format:
-     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     * Sort object.
+     *
+     * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
      */
     sort?: Sorting$1[];
 }
 /** @oneof */
 interface CursorQueryPagingMethodOneOf$1 {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging$1;
 }
 interface Sorting$1 {
@@ -12203,13 +12231,13 @@ interface CursorPaging$1 {
     cursor?: string | null;
 }
 interface QuerySchemasResponse$1 {
-    /** List of Schemas. */
+    /** List of translation schemas. */
     schemas?: Schema$1[];
-    /** Paging metadata */
+    /** Paging metadata for the next page of results. */
     pagingMetadata?: CursorPagingMetadata$1;
 }
 interface CursorPagingMetadata$1 {
-    /** Number of items returned in the response. */
+    /** Number of items returned in current page. */
     count?: number | null;
     /** Cursor strings that point to the next page, previous page, or both. */
     cursors?: Cursors$1;
@@ -12232,9 +12260,9 @@ interface ListSiteSchemasRequest$1 {
     paging?: CursorPaging$1;
 }
 interface ListSiteSchemasResponse$1 {
-    /** List of Schemas. */
+    /** List of translation schemas. */
     schemas?: Schema$1[];
-    /** Paging metadata */
+    /** Paging metadata for the next page of results. */
     pagingMetadata?: CursorPagingMetadata$1;
 }
 interface SchemaKeyNonNullableFields$1 {
@@ -12260,29 +12288,35 @@ interface ListSiteSchemasResponseNonNullableFields$1 {
 
 interface Schema {
     /**
-     * Schema ID.
+     * Translation schema ID.
      * @readonly
      */
     _id?: string | null;
-    /** (compound key) Schema key. */
+    /** Translation schema unique key identifier. */
     key?: SchemaKey;
-    /** A list of unique fields on the entity in the specific language */
+    /** List of fields for the translation schema. This property uses a string to map to a `SchemaField` (`Map<string, SchemaField>`). The string serves as a key, which you'll need to access each field in the schema and when adding translation content. */
     fields?: Record<string, SchemaField>;
-    /** Fields that will be displayed in content previews (e.g., product name for products). */
+    /** Fields displayed in content previews. For example, a product name for a product translation schema. */
     previewFields?: PreviewFields;
-    /** Whether the schema is hidden from the site. */
+    /** Whether the translation schema is hidden from the site. */
     hidden?: boolean | null;
-    /** The name of the schema */
+    /** Translation schema name. */
     displayName?: string | null;
-    /** Higher level schema, group_by_name will point to an entity of this schema. */
+    /** A reference to the parent schema defined by the app developer. For example, if the schema is for a menu item, this property would link to the schema of the menu it belongs to. */
     parentId?: string | null;
     /** @readonly */
     revision?: string | null;
-    /** @readonly */
+    /**
+     * Date and time the translation schema was created.
+     * @readonly
+     */
     _createdDate?: Date;
-    /** @readonly */
+    /**
+     * Date and time the translation schema was updated.
+     * @readonly
+     */
     _updatedDate?: Date;
-    /** indicate if the content should be duplicated when the site is cloned */
+    /** Whether to duplicate the translated content in the schema when a site containing the translation schema and content is duplicated. */
     duplicateContent?: boolean | null;
 }
 interface SchemaKey {
@@ -12291,9 +12325,14 @@ interface SchemaKey {
      * @readonly
      */
     appId?: string;
-    /** Unique name defined by the creator app, used to distinguish between different entities in the the app domain. */
+    /** A unique name defined by the app developer to differentiate translation schemas for various entities within their app. For example, if an app developer is creating a translation schema for blog posts, the `entityType` can be `'blog-posts'`. */
     entityType?: string;
-    /** Scope schema is defined in (Global/Site) */
+    /**
+     * Scope of the translation schema.
+     * Supported values:
+     * + `GLOBAL`: A global schema for all sites.
+     * + `SITE`: A custom schema for a specific site.
+     */
     scope?: SchemaScope;
 }
 declare enum SchemaScope {
@@ -12305,27 +12344,38 @@ declare enum SchemaScope {
 }
 interface SchemaField {
     /**
-     * Field ID.
+     * Field ID. Validated according to Regex `^[A-Za-z0-9-_)(]+$`. Field IDs may contain parenthesis to reference repeated items, such as images. These parenthesis can't be nested and each open one must have a closed one. For example, `title()()` is valid, while `title)(` and `title(())` aren't valid. The value inside the parenthesis is validated according to Regex `^[^)(\\]\\[\\.]+$`.
      * @readonly
      */
     _id?: string;
-    /** Field type. */
+    /**
+     * Field type.
+     * Supported values:
+     * + `SHORT_TEXT`: Short plain text.
+     * + `LONG_TEXT`: Long plain text.
+     * + `HTML`: Long text including styles, images, and links.
+     * + `RICH_CONTENT`: Rich-Content using the [Wix Ricos.js](https://dev.wix.com/docs/go-headless/tutorials-templates/other-tutorials/working-with-rich-content) format.
+     * + `IMAGE`: Wix Media Manager image.
+     * + `IMAGE_LINK`: Image URL without metadata.
+     * + `VIDEO`: Wix Media Manager video.
+     * + `DOCUMENT`: Wix Media Manager document.
+     */
     type?: FieldType;
-    /** Field descriptive name. */
+    /** Field name. */
     displayName?: string | null;
-    /** Field semantic grouping */
+    /** Field group name. */
     groupName?: string | null;
-    /** Field minimum length (in case of text field) */
+    /** Field minimum text length. */
     minLength?: number | null;
-    /** Field maximum length (in case text field) */
+    /** Field maximum text length. */
     maxLength?: number | null;
-    /** Field format. If set - must be one of the values of wix.api.format as string (case insensitive) */
+    /** Field format. The content will be validated based on the format set here in the field schema. For example, if the format is `EMAIL`, then the content for this field must be a valid email address. */
     format?: string | null;
-    /** Whether the field is hidden from the site. Hidden field constraints (type, min/max length) are still active! */
+    /** Whether the field is hidden from the site. Hidden fields are still validated. */
     hidden?: boolean;
-    /** Whether the field is for display only and should not allowed to be translated */
+    /** Whether the field is read-only, and is not meant to be translated. For example, an image. Use this field as a way to provide more context for the field in the Multilingual Dashboard. */
     displayOnly?: boolean;
-    /** In cases where the order of the fields holds meaning, use this index */
+    /** Field index. Use for cases where the order of the fields are relevant. */
     index?: number | null;
 }
 declare enum FieldType {
@@ -12357,46 +12407,52 @@ interface PreviewFields {
     imageFieldId?: string | null;
 }
 interface GetSchemaRequest {
-    /** ID of the Schema to retrieve. */
+    /** ID of the translation schema to retrieve. */
     schemaId: string;
 }
 interface GetSchemaResponse {
-    /** The requested Schema. */
+    /** The requested translation schema. */
     schema?: Schema;
 }
 interface GetSchemaByKeyRequest {
-    /** ID of the Schema to retrieve. */
+    /** ID of the translation schema to retrieve. */
     key: SchemaKey;
 }
 interface GetSchemaByKeyResponse {
-    /** The requested Schema. */
+    /** The requested translation schema. */
     schema?: Schema;
 }
 interface QuerySchemasRequest {
-    /** WQL expression. */
+    /** Query options. */
     query?: CursorQuery;
 }
 interface CursorQuery extends CursorQueryPagingMethodOneOf {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging;
     /**
-     * Filter object in the following format:
-     * `"filter" : {
-     * "fieldName1": "value1",
-     * "fieldName2":{"$operator":"value2"}
-     * }`
-     * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
+     * Filter object.
+     *
+     * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
      */
     filter?: Record<string, any> | null;
     /**
-     * Sort object in the following format:
-     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     * Sort object.
+     *
+     * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
      */
     sort?: Sorting[];
 }
 /** @oneof */
 interface CursorQueryPagingMethodOneOf {
-    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
     cursorPaging?: CursorPaging;
 }
 interface Sorting {
@@ -12421,13 +12477,13 @@ interface CursorPaging {
     cursor?: string | null;
 }
 interface QuerySchemasResponse {
-    /** List of Schemas. */
+    /** List of translation schemas. */
     schemas?: Schema[];
-    /** Paging metadata */
+    /** Paging metadata for the next page of results. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface CursorPagingMetadata {
-    /** Number of items returned in the response. */
+    /** Number of items returned in current page. */
     count?: number | null;
     /** Cursor strings that point to the next page, previous page, or both. */
     cursors?: Cursors;
@@ -12450,9 +12506,9 @@ interface ListSiteSchemasRequest {
     paging?: CursorPaging;
 }
 interface ListSiteSchemasResponse {
-    /** List of Schemas. */
+    /** List of translation schemas. */
     schemas?: Schema[];
-    /** Paging metadata */
+    /** Paging metadata for the next page of results. */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface SchemaKeyNonNullableFields {