@webiny/api-headless-cms 0.0.0-mt-2 → 0.0.0-unstable.06b2ede40f

package/types/model.d.ts

@@ -0,0 +1,199 @@
+import type { CmsIdentity } from "./identity";
+import type { CmsModelField, CmsModelFieldInput, LockedField } from "./modelField";
+import type { CmsModelGroup } from "./modelGroup";
+/**
+ * Base CMS Model. Should not be exported and used outside of this package.
+ *
+ * @category Database model
+ * @category CmsModel
+ */
+export interface CmsModel {
+    /**
+     * Name of the content model.
+     */
+    name: string;
+    /**
+     * Unique ID for the content model. Created from name if not defined by user.
+     */
+    modelId: string;
+    /**
+     * Name of the content model in singular form to be used in the API.
+     * example:
+     * - Article
+     * - Fruit
+     * - Vegetable
+     * - Car
+     */
+    singularApiName: string;
+    /**
+     * Name of the content model in plural form to be used in the API.
+     * example:
+     * - Articles
+     * - Fruits
+     * - Vegetables
+     * - Cars
+     */
+    pluralApiName: string;
+    /**
+     * Model tenant.
+     */
+    tenant: string;
+    /**
+     * Locale this model belongs to.
+     */
+    locale: string;
+    /**
+     * Cms Group reference object.
+     */
+    group: CmsModelGroup;
+    /**
+     * Icon for the content model.
+     */
+    icon?: string | null;
+    /**
+     * Description for the content model.
+     */
+    description: string | null;
+    /**
+     * Date created
+     */
+    createdOn?: string;
+    /**
+     * Date saved. Changes on both save and create.
+     */
+    savedOn?: string;
+    /**
+     * CreatedBy object wrapper. Contains id, name and type of the user.
+     */
+    createdBy?: CmsIdentity;
+    /**
+     * List of fields defining entry values.
+     */
+    fields: CmsModelField[];
+    /**
+     * Admin UI field layout
+     *
+     * ```ts
+     * layout: [
+     *      [field1id, field2id],
+     *      [field3id]
+     * ]
+     * ```
+     */
+    layout: string[][];
+    /**
+     * Models can be tagged to give them contextual meaning.
+     */
+    tags?: string[];
+    /**
+     * List of locked fields. Updated when entry is saved and a field has been used.
+     */
+    lockedFields?: LockedField[];
+    /**
+     * The field that is used as an entry title.
+     * If not specified by the user, the system tries to assign the first available `text` field.
+     */
+    titleFieldId: string;
+    /**
+     * The field that is used as an entry description.
+     * If not set by the user, the system will try to assign the first available `long-text` field.
+     */
+    descriptionFieldId?: string | null;
+    /**
+     * The field that is used as an entry image.
+     * If not set by the user, the system will try to assign a `file` field which has `imagesOnly` enabled.
+     */
+    imageFieldId?: string | null;
+    /**
+     * The version of Webiny which this record was stored with.
+     */
+    webinyVersion: string;
+    /**
+     * Is model private?
+     * This is meant to be used for some internal models - will not be visible in the schema.
+     * Only available for the plugin constructed models.
+     */
+    isPrivate?: boolean;
+    /**
+     * Does this model require authorization to be performed?
+     * Only available for models created via plugins.
+     */
+    authorization?: boolean | CmsModelAuthorization;
+    /**
+     * Is this model created via plugin?
+     */
+    isPlugin?: boolean;
+}
+export interface CmsModelAuthorization {
+    permissions: boolean;
+    [key: string]: any;
+}
+/**
+ * A GraphQL `params.data` parameter received when creating content model.
+ *
+ * @category GraphQL params
+ * @category CmsModel
+ */
+export interface CmsModelCreateInput {
+    /**
+     * Name of the content model.
+     */
+    name: string;
+    /**
+     * Singular name of the content model to be used in the API.
+     */
+    singularApiName: string;
+    /**
+     * Plural name of the content model to be used in the API.
+     */
+    pluralApiName: string;
+    /**
+     * Unique ID of the content model. Created from name if not sent by the user. Cannot be changed.
+     */
+    modelId?: string;
+    /**
+     * Description of the content model.
+     */
+    description?: string | null;
+    /**
+     * Group where to put the content model in.
+     */
+    group: string;
+    /**
+     * A list of content model fields to define the entry values.
+     */
+    fields?: CmsModelFieldInput[];
+    /**
+     * Admin UI field layout
+     *
+     * ```ts
+     * layout: [
+     *      [field1id, field2id],
+     *      [field3id]
+     * ]
+     * ```
+     */
+    layout?: string[][];
+    /**
+     * Models can be tagged to give them contextual meaning.
+     */
+    tags?: string[];
+    /**
+     * Fields fieldId which are picked to represent the CMS entry.
+     */
+    titleFieldId?: string | null;
+    descriptionFieldId?: string | null;
+    imageFieldId?: string | null;
+}
+/**
+ * A GraphQL `params.data` parameter received when creating content model from existing model.
+ *
+ * @category GraphQL params
+ * @category CmsModel
+ */
+export interface CmsModelCreateFromInput extends CmsModelCreateInput {
+    /**
+     * Locale into which we want to clone the model into.
+     */
+    locale?: string;
+}

package/types/model.js

@@ -0,0 +1,7 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+//# sourceMappingURL=model.js.map

package/types/model.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["model.ts"],"sourcesContent":["import type { CmsIdentity } from \"./identity\";\nimport type { CmsModelField, CmsModelFieldInput, LockedField } from \"./modelField\";\nimport type { CmsModelGroup } from \"./modelGroup\";\n\n/**\n * Base CMS Model. Should not be exported and used outside of this package.\n *\n * @category Database model\n * @category CmsModel\n */\nexport interface CmsModel {\n    /**\n     * Name of the content model.\n     */\n    name: string;\n    /**\n     * Unique ID for the content model. Created from name if not defined by user.\n     */\n    modelId: string;\n    /**\n     * Name of the content model in singular form to be used in the API.\n     * example:\n     * - Article\n     * - Fruit\n     * - Vegetable\n     * - Car\n     */\n    singularApiName: string;\n    /**\n     * Name of the content model in plural form to be used in the API.\n     * example:\n     * - Articles\n     * - Fruits\n     * - Vegetables\n     * - Cars\n     */\n    pluralApiName: string;\n    /**\n     * Model tenant.\n     */\n    tenant: string;\n    /**\n     * Locale this model belongs to.\n     */\n    locale: string;\n    /**\n     * Cms Group reference object.\n     */\n    group: CmsModelGroup;\n    /**\n     * Icon for the content model.\n     */\n    icon?: string | null;\n    /**\n     * Description for the content model.\n     */\n    description: string | null;\n    /**\n     * Date created\n     */\n    createdOn?: string;\n    /**\n     * Date saved. Changes on both save and create.\n     */\n    savedOn?: string;\n    /**\n     * CreatedBy object wrapper. Contains id, name and type of the user.\n     */\n    createdBy?: CmsIdentity;\n    /**\n     * List of fields defining entry values.\n     */\n    fields: CmsModelField[];\n    /**\n     * Admin UI field layout\n     *\n     * ```ts\n     * layout: [\n     *      [field1id, field2id],\n     *      [field3id]\n     * ]\n     * ```\n     */\n    layout: string[][];\n    /**\n     * Models can be tagged to give them contextual meaning.\n     */\n    tags?: string[];\n    /**\n     * List of locked fields. Updated when entry is saved and a field has been used.\n     */\n    lockedFields?: LockedField[];\n    /**\n     * The field that is used as an entry title.\n     * If not specified by the user, the system tries to assign the first available `text` field.\n     */\n    titleFieldId: string;\n    /**\n     * The field that is used as an entry description.\n     * If not set by the user, the system will try to assign the first available `long-text` field.\n     */\n    descriptionFieldId?: string | null;\n    /**\n     * The field that is used as an entry image.\n     * If not set by the user, the system will try to assign a `file` field which has `imagesOnly` enabled.\n     */\n    imageFieldId?: string | null;\n    /**\n     * The version of Webiny which this record was stored with.\n     */\n    webinyVersion: string;\n\n    /**\n     * Is model private?\n     * This is meant to be used for some internal models - will not be visible in the schema.\n     * Only available for the plugin constructed models.\n     */\n    isPrivate?: boolean;\n\n    /**\n     * Does this model require authorization to be performed?\n     * Only available for models created via plugins.\n     */\n    authorization?: boolean | CmsModelAuthorization;\n\n    /**\n     * Is this model created via plugin?\n     */\n    isPlugin?: boolean;\n}\n\nexport interface CmsModelAuthorization {\n    permissions: boolean;\n\n    [key: string]: any;\n}\n\n/**\n * A GraphQL `params.data` parameter received when creating content model.\n *\n * @category GraphQL params\n * @category CmsModel\n */\nexport interface CmsModelCreateInput {\n    /**\n     * Name of the content model.\n     */\n    name: string;\n    /**\n     * Singular name of the content model to be used in the API.\n     */\n    singularApiName: string;\n    /**\n     * Plural name of the content model to be used in the API.\n     */\n    pluralApiName: string;\n    /**\n     * Unique ID of the content model. Created from name if not sent by the user. Cannot be changed.\n     */\n    modelId?: string;\n    /**\n     * Description of the content model.\n     */\n    description?: string | null;\n    /**\n     * Group where to put the content model in.\n     */\n    group: string;\n    /**\n     * A list of content model fields to define the entry values.\n     */\n    fields?: CmsModelFieldInput[];\n    /**\n     * Admin UI field layout\n     *\n     * ```ts\n     * layout: [\n     *      [field1id, field2id],\n     *      [field3id]\n     * ]\n     * ```\n     */\n    layout?: string[][];\n    /**\n     * Models can be tagged to give them contextual meaning.\n     */\n    tags?: string[];\n    /**\n     * Fields fieldId which are picked to represent the CMS entry.\n     */\n    titleFieldId?: string | null;\n    descriptionFieldId?: string | null;\n    imageFieldId?: string | null;\n}\n\n/**\n * A GraphQL `params.data` parameter received when creating content model from existing model.\n *\n * @category GraphQL params\n * @category CmsModel\n */\nexport interface CmsModelCreateFromInput extends CmsModelCreateInput {\n    /**\n     * Locale into which we want to clone the model into.\n     */\n    locale?: string;\n}\n"],"mappings":"","ignoreList":[]}

package/types/modelAst.d.ts

@@ -0,0 +1,39 @@
+/**
+ * CMS Model AST
+ */
+import type { CmsModelField } from "./modelField";
+export interface ICmsModelFieldToAst {
+    toAst(field: CmsModelField): CmsModelFieldAstNode;
+}
+export type CmsModelAst = {
+    type: "root";
+    children: CmsModelFieldAstNode[];
+};
+export type CmsModelFieldAstNodeCollection = {
+    type: "collection";
+    collection: {
+        discriminator: string;
+    } & Record<string, any>;
+    children: CmsModelFieldAstNode[];
+};
+export type CmsModelFieldAstNodeField = {
+    type: "field";
+    field: CmsModelField;
+    children: CmsModelFieldAstNode[];
+};
+export type CmsModelFieldAstNode = CmsModelFieldAstNodeCollection | CmsModelFieldAstNodeField;
+export interface GetCmsModelFieldAst<TField> {
+    (field: TField, converter: ICmsModelFieldToAst): CmsModelFieldAstNode;
+}
+export interface ContentEntryNode {
+    field: CmsModelField;
+    value: any;
+    path: string;
+}
+export interface ContentEntryNodeContext {
+    node: CmsModelAst | CmsModelFieldAstNode;
+    parent: CmsModelAst | CmsModelFieldAstNode | null;
+}
+export interface ContentEntryValueVisitor {
+    (params: ContentEntryNode, context: ContentEntryNodeContext): Promise<void | unknown> | void | unknown;
+}

package/types/modelAst.js

@@ -0,0 +1,7 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+//# sourceMappingURL=modelAst.js.map

package/types/modelAst.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["modelAst.ts"],"sourcesContent":["/**\n * CMS Model AST\n */\nimport type { CmsModelField } from \"./modelField\";\n\nexport interface ICmsModelFieldToAst {\n    toAst(field: CmsModelField): CmsModelFieldAstNode;\n}\n\nexport type CmsModelAst = {\n    type: \"root\";\n    children: CmsModelFieldAstNode[];\n};\n\nexport type CmsModelFieldAstNodeCollection = {\n    type: \"collection\";\n    collection: { discriminator: string } & Record<string, any>;\n    children: CmsModelFieldAstNode[];\n};\n\nexport type CmsModelFieldAstNodeField = {\n    type: \"field\";\n    field: CmsModelField;\n    children: CmsModelFieldAstNode[];\n};\n\nexport type CmsModelFieldAstNode = CmsModelFieldAstNodeCollection | CmsModelFieldAstNodeField;\n\nexport interface GetCmsModelFieldAst<TField> {\n    (field: TField, converter: ICmsModelFieldToAst): CmsModelFieldAstNode;\n}\n\nexport interface ContentEntryNode {\n    field: CmsModelField;\n    value: any;\n    path: string;\n    // parentField: CmsModelField | undefined;\n    // parent => parent object (e.g., entry)\n}\n\nexport interface ContentEntryNodeContext {\n    node: CmsModelAst | CmsModelFieldAstNode;\n    parent: CmsModelAst | CmsModelFieldAstNode | null;\n}\n\nexport interface ContentEntryValueVisitor {\n    (params: ContentEntryNode, context: ContentEntryNodeContext):\n        | Promise<void | unknown>\n        | void\n        | unknown;\n}\n"],"mappings":"","ignoreList":[]}

package/types/modelField.d.ts

@@ -0,0 +1,330 @@
+import type { CmsModel } from "./model";
+import type { GenericRecord } from "@webiny/api/types";
+export type CmsModelFieldType = "boolean" | "datetime" | "file" | "long-text" | "number" | "json" | "object" | "ref" | "rich-text" | "text" | "dynamicZone" | string;
+export type ICmsModelFieldStorageId = `${string}@${string}` | string;
+/**
+ * A definition for content model field. This type exists on the app side as well.
+ *
+ * @category ModelField
+ * @category Database model
+ */
+export interface CmsModelField {
+    /**
+     * A generated unique ID for the model field.
+     * MUST be absolute unique throughout the models.
+     * Must be in form of a-zA-Z0-9.
+     *
+     * We generate a unique id value when you're building a model via UI,
+     * but when user is creating a model via a plugin it is up to them to be careful about this.
+     */
+    id: string;
+    /**
+     * A type of the field.
+     * We are defining our built-in fields, so people know which are available by the default.
+     */
+    type: CmsModelFieldType;
+    /**
+     * A unique storage ID for storing actual values.
+     * Must in form of a-zA-Z0-9@a-zA-Z0-9
+     *
+     * This is an auto-generated value: uses `id` and `type`
+     *
+     * This is used as path for the entry value.
+     */
+    storageId: ICmsModelFieldStorageId;
+    /**
+     * Field identifier for the model field that will be available to the outside world.
+     * `storageId` is used as path (or column) to store the data.
+     *
+     * Must in form of a-zA-Z0-9.
+     *
+     * This value MUST be unique in the CmsModel.
+     */
+    fieldId: string;
+    /**
+     * A label for the field
+     */
+    label: string;
+    /**
+     * Text below the field to clarify what is it meant to be in the field value
+     */
+    helpText?: string | null;
+    /**
+     * Text to be displayed in the field
+     */
+    placeholderText?: string | null;
+    /**
+     * Are predefined values enabled? And list of them
+     */
+    predefinedValues?: CmsModelFieldPredefinedValues;
+    /**
+     * Field renderer. Blank if determined automatically.
+     */
+    renderer?: CmsModelFieldRenderer | null;
+    /**
+     * List of validations for the field
+     *
+     * @default []
+     */
+    validation?: CmsModelFieldValidation[];
+    /**
+     * List of validations for the list of values, when a field is set to accept a list of values.
+     * These validations will be applied to the entire list, and `validation` (see above) will be applied
+     * to each individual value in the list.
+     *
+     * @default []
+     */
+    listValidation?: CmsModelFieldValidation[];
+    /**
+     * Is this a multiple values field?
+     *
+     */
+    multipleValues?: boolean;
+    /**
+     * Fields can be tagged to give them contextual meaning.
+     */
+    tags?: string[];
+    /**
+     * Any user defined settings.
+     *
+     * @default {}
+     */
+    settings?: CmsModelFieldSettings;
+}
+/**
+ * A definition for content model field received from the user.
+ *
+ * Input type for `CmsModelField`.
+ * @see CmsModelField
+ *
+ * @category GraphQL params
+ * @category ModelField
+ */
+export interface CmsModelFieldInput {
+    /**
+     * Generated ID.
+     */
+    id: string;
+    /**
+     * Type of the field. A plugin for the field must be defined.
+     * @see CmsModelFieldToGraphQLPlugin
+     */
+    type: string;
+    /**
+     * Field outside world identifier for the field. Must be unique in the model.
+     */
+    fieldId: string;
+    /**
+     * Label for the field.
+     */
+    label: string;
+    /**
+     * Text to display below the field to help user what to write in the field.
+     */
+    helpText?: string | null;
+    /**
+     * Text to display in the field.
+     */
+    placeholderText?: string | null;
+    /**
+     * Fields can be tagged to give them contextual meaning.
+     */
+    tags?: string[];
+    /**
+     * Are multiple values allowed?
+     */
+    multipleValues?: boolean;
+    /**
+     * Predefined values options for the field. Check the reference for more information.
+     */
+    predefinedValues?: CmsModelFieldPredefinedValues;
+    /**
+     * Renderer options for the field. Check the reference for more information.
+     */
+    renderer?: CmsModelFieldRenderer | null;
+    /**
+     * List of validations for the field.
+     */
+    validation?: CmsModelFieldValidation[];
+    /**
+     * @see CmsModelField.listValidation
+     */
+    listValidation?: CmsModelFieldValidation[];
+    /**
+     * User defined settings.
+     */
+    settings?: Record<string, any>;
+}
+/**
+ * A GraphQL `params.data` parameter received when updating content model.
+ *
+ * @category GraphQL params
+ * @category CmsModel
+ */
+export interface CmsModelUpdateInput {
+    /**
+     * A new content model name.
+     */
+    name?: string;
+    /**
+     * A new singular name of the content model to be used in the API.
+     */
+    singularApiName?: string;
+    /**
+     * A new plural name of the content model to be used in the API.
+     */
+    pluralApiName?: string;
+    /**
+     * A group we want to move the model to.
+     */
+    group?: string;
+    /**
+     * A new description of the content model.
+     */
+    description?: string | null;
+    /**
+     * A list of content model fields to define the entry values.
+     */
+    fields: CmsModelFieldInput[];
+    /**
+     * Admin UI field layout
+     *
+     * ```ts
+     * layout: [
+     *      [field1id, field2id],
+     *      [field3id]
+     * ]
+     * ```
+     */
+    layout: string[][];
+    /**
+     * Tags for the content model.
+     */
+    tags?: string[];
+    /**
+     * Fields fieldId which are picked to represent the CMS entry.
+     */
+    titleFieldId?: string | null;
+    descriptionFieldId?: string | null;
+    imageFieldId?: string | null;
+}
+/**
+ * Locked field in the content model
+ *
+ * @see CmsModel.lockedFields
+ *
+ * @category ModelField
+ */
+export interface LockedField {
+    /**
+     * Locked field storage ID - one used to store values.
+     * We cannot change this due to old systems.
+     */
+    fieldId: string;
+    /**
+     * Is the field multiple values field?
+     */
+    multipleValues: boolean;
+    /**
+     * Field type.
+     */
+    type: string;
+    [key: string]: any;
+}
+/**
+ * Object containing content model field renderer options.
+ *
+ * @category CmsModelField
+ */
+interface CmsModelFieldRenderer {
+    /**
+     * Name of the field renderer. Must have one in field renderer plugins.
+     * Can be blank to let automatically determine the renderer.
+     */
+    name: string;
+    /**
+     * Renderer settings allow you to configure field renderer on a field level.
+     */
+    settings?: GenericRecord<string> | null;
+}
+/**
+ * A definition for content model field settings.
+ *
+ * @category ModelField
+ * @category Database model
+ */
+export interface CmsModelFieldSettings {
+    /**
+     * Predefined values (text, number)
+     * The default value for the field in case it is not predefined values field.
+     */
+    defaultValue?: string | boolean | number | null | undefined;
+    /**
+     * Object field has child fields.
+     */
+    fields?: CmsModelField[];
+    /**
+     * Is the file field images only one?
+     */
+    imagesOnly?: boolean;
+    /**
+     * Object field has child fields - so it needs to have a layout.
+     */
+    layout?: string[][];
+    /**
+     * Ref field.
+     */
+    models?: Pick<CmsModel, "modelId">[];
+    /**
+     * Date field.
+     */
+    type?: string;
+    /**
+     * Disable full text search explicitly on this field.
+     */
+    disableFullTextSearch?: boolean;
+    /**
+     * There are a lot of other settings that are possible to add, so we keep the type opened.
+     */
+    [key: string]: any;
+}
+/**
+ * Definition for content model field validator.
+ *
+ * @category ModelField
+ * @category FieldValidation
+ */
+export interface CmsModelFieldValidation {
+    name: string;
+    message: string;
+    settings?: {
+        value?: string | number;
+        values?: string[];
+        preset?: string;
+        [key: string]: any;
+    };
+}
+/**
+ * Object containing content model field predefined options and values.
+ *
+ * @category CmsModelField
+ */
+export interface CmsModelFieldPredefinedValues {
+    /**
+     * Are predefined field values enabled?
+     */
+    enabled: boolean;
+    /**
+     * Predefined values array.
+     */
+    values: CmsModelFieldPredefinedValuesValue[];
+}
+interface CmsModelFieldPredefinedValuesValue {
+    value: string;
+    label: string;
+    /**
+     * Default selected predefined value.
+     */
+    selected?: boolean;
+}
+export {};

package/types/modelField.js

@@ -0,0 +1,7 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+//# sourceMappingURL=modelField.js.map

package/types/modelField.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["modelField.ts"],"sourcesContent":["import type { CmsModel } from \"./model\";\nimport type { GenericRecord } from \"@webiny/api/types\";\n\nexport type CmsModelFieldType =\n    | \"boolean\"\n    | \"datetime\"\n    | \"file\"\n    | \"long-text\"\n    | \"number\"\n    | \"json\"\n    | \"object\"\n    | \"ref\"\n    | \"rich-text\"\n    | \"text\"\n    | \"dynamicZone\"\n    | string;\n\nexport type ICmsModelFieldStorageId = `${string}@${string}` | string;\n/**\n * A definition for content model field. This type exists on the app side as well.\n *\n * @category ModelField\n * @category Database model\n */\nexport interface CmsModelField {\n    /**\n     * A generated unique ID for the model field.\n     * MUST be absolute unique throughout the models.\n     * Must be in form of a-zA-Z0-9.\n     *\n     * We generate a unique id value when you're building a model via UI,\n     * but when user is creating a model via a plugin it is up to them to be careful about this.\n     */\n    id: string;\n    /**\n     * A type of the field.\n     * We are defining our built-in fields, so people know which are available by the default.\n     */\n    type: CmsModelFieldType;\n    /**\n     * A unique storage ID for storing actual values.\n     * Must in form of a-zA-Z0-9@a-zA-Z0-9\n     *\n     * This is an auto-generated value: uses `id` and `type`\n     *\n     * This is used as path for the entry value.\n     */\n    storageId: ICmsModelFieldStorageId;\n    /**\n     * Field identifier for the model field that will be available to the outside world.\n     * `storageId` is used as path (or column) to store the data.\n     *\n     * Must in form of a-zA-Z0-9.\n     *\n     * This value MUST be unique in the CmsModel.\n     */\n    fieldId: string;\n    /**\n     * A label for the field\n     */\n    label: string;\n    /**\n     * Text below the field to clarify what is it meant to be in the field value\n     */\n    helpText?: string | null;\n    /**\n     * Text to be displayed in the field\n     */\n    placeholderText?: string | null;\n    /**\n     * Are predefined values enabled? And list of them\n     */\n    predefinedValues?: CmsModelFieldPredefinedValues;\n    /**\n     * Field renderer. Blank if determined automatically.\n     */\n    renderer?: CmsModelFieldRenderer | null;\n    /**\n     * List of validations for the field\n     *\n     * @default []\n     */\n    validation?: CmsModelFieldValidation[];\n    /**\n     * List of validations for the list of values, when a field is set to accept a list of values.\n     * These validations will be applied to the entire list, and `validation` (see above) will be applied\n     * to each individual value in the list.\n     *\n     * @default []\n     */\n    listValidation?: CmsModelFieldValidation[];\n    /**\n     * Is this a multiple values field?\n     *\n     */\n    multipleValues?: boolean;\n    /**\n     * Fields can be tagged to give them contextual meaning.\n     */\n    tags?: string[];\n    /**\n     * Any user defined settings.\n     *\n     * @default {}\n     */\n    settings?: CmsModelFieldSettings;\n}\n\n/**\n * A definition for content model field received from the user.\n *\n * Input type for `CmsModelField`.\n * @see CmsModelField\n *\n * @category GraphQL params\n * @category ModelField\n */\nexport interface CmsModelFieldInput {\n    /**\n     * Generated ID.\n     */\n    id: string;\n    /**\n     * Type of the field. A plugin for the field must be defined.\n     * @see CmsModelFieldToGraphQLPlugin\n     */\n    type: string;\n    /**\n     * Field outside world identifier for the field. Must be unique in the model.\n     */\n    fieldId: string;\n    /**\n     * Label for the field.\n     */\n    label: string;\n    /**\n     * Text to display below the field to help user what to write in the field.\n     */\n    helpText?: string | null;\n    /**\n     * Text to display in the field.\n     */\n    placeholderText?: string | null;\n    /**\n     * Fields can be tagged to give them contextual meaning.\n     */\n    tags?: string[];\n    /**\n     * Are multiple values allowed?\n     */\n    multipleValues?: boolean;\n    /**\n     * Predefined values options for the field. Check the reference for more information.\n     */\n    predefinedValues?: CmsModelFieldPredefinedValues;\n    /**\n     * Renderer options for the field. Check the reference for more information.\n     */\n    renderer?: CmsModelFieldRenderer | null;\n    /**\n     * List of validations for the field.\n     */\n    validation?: CmsModelFieldValidation[];\n    /**\n     * @see CmsModelField.listValidation\n     */\n    listValidation?: CmsModelFieldValidation[];\n    /**\n     * User defined settings.\n     */\n    settings?: Record<string, any>;\n}\n\n/**\n * A GraphQL `params.data` parameter received when updating content model.\n *\n * @category GraphQL params\n * @category CmsModel\n */\nexport interface CmsModelUpdateInput {\n    /**\n     * A new content model name.\n     */\n    name?: string;\n    /**\n     * A new singular name of the content model to be used in the API.\n     */\n    singularApiName?: string;\n    /**\n     * A new plural name of the content model to be used in the API.\n     */\n    pluralApiName?: string;\n    /**\n     * A group we want to move the model to.\n     */\n    group?: string;\n    /**\n     * A new description of the content model.\n     */\n    description?: string | null;\n    /**\n     * A list of content model fields to define the entry values.\n     */\n    fields: CmsModelFieldInput[];\n    /**\n     * Admin UI field layout\n     *\n     * ```ts\n     * layout: [\n     *      [field1id, field2id],\n     *      [field3id]\n     * ]\n     * ```\n     */\n    layout: string[][];\n    /**\n     * Tags for the content model.\n     */\n    tags?: string[];\n    /**\n     * Fields fieldId which are picked to represent the CMS entry.\n     */\n    titleFieldId?: string | null;\n    descriptionFieldId?: string | null;\n    imageFieldId?: string | null;\n}\n\n/**\n * Locked field in the content model\n *\n * @see CmsModel.lockedFields\n *\n * @category ModelField\n */\nexport interface LockedField {\n    /**\n     * Locked field storage ID - one used to store values.\n     * We cannot change this due to old systems.\n     */\n    fieldId: string;\n    /**\n     * Is the field multiple values field?\n     */\n    multipleValues: boolean;\n    /**\n     * Field type.\n     */\n    type: string;\n\n    [key: string]: any;\n}\n\n/**\n * Object containing content model field renderer options.\n *\n * @category CmsModelField\n */\ninterface CmsModelFieldRenderer {\n    /**\n     * Name of the field renderer. Must have one in field renderer plugins.\n     * Can be blank to let automatically determine the renderer.\n     */\n    name: string;\n    /**\n     * Renderer settings allow you to configure field renderer on a field level.\n     */\n    settings?: GenericRecord<string> | null;\n}\n\n/**\n * A definition for content model field settings.\n *\n * @category ModelField\n * @category Database model\n */\nexport interface CmsModelFieldSettings {\n    /**\n     * Predefined values (text, number)\n     * The default value for the field in case it is not predefined values field.\n     */\n    defaultValue?: string | boolean | number | null | undefined;\n    /**\n     * Object field has child fields.\n     */\n    fields?: CmsModelField[];\n    /**\n     * Is the file field images only one?\n     */\n    imagesOnly?: boolean;\n    /**\n     * Object field has child fields - so it needs to have a layout.\n     */\n    layout?: string[][];\n    /**\n     * Ref field.\n     */\n    models?: Pick<CmsModel, \"modelId\">[];\n    /**\n     * Date field.\n     */\n    type?: string;\n    /**\n     * Disable full text search explicitly on this field.\n     */\n    disableFullTextSearch?: boolean;\n\n    /**\n     * There are a lot of other settings that are possible to add, so we keep the type opened.\n     */\n    [key: string]: any;\n}\n\n/**\n * Definition for content model field validator.\n *\n * @category ModelField\n * @category FieldValidation\n */\nexport interface CmsModelFieldValidation {\n    name: string;\n    message: string;\n    settings?: {\n        value?: string | number;\n        values?: string[];\n        preset?: string;\n        [key: string]: any;\n    };\n}\n\n/**\n * Object containing content model field predefined options and values.\n *\n * @category CmsModelField\n */\nexport interface CmsModelFieldPredefinedValues {\n    /**\n     * Are predefined field values enabled?\n     */\n    enabled: boolean;\n    /**\n     * Predefined values array.\n     */\n    values: CmsModelFieldPredefinedValuesValue[];\n}\n\ninterface CmsModelFieldPredefinedValuesValue {\n    value: string;\n    label: string;\n    /**\n     * Default selected predefined value.\n     */\n    selected?: boolean;\n}\n"],"mappings":"","ignoreList":[]}