@webiny/app-headless-cms-common 0.0.0-unstable.a4637c5ce6 → 0.0.0-unstable.a4f3e4ea8b

package/README.md

@@ -1,18 +1,11 @@
 # @webiny/app-headless-cms-common
 
-[![](https://img.shields.io/npm/dw/@webiny/app-headless-cms-common.svg)](https://www.npmjs.com/package/@webiny/app-headless-cms-common)
-[![](https://img.shields.io/npm/v/@webiny/app-headless-cms-common.svg)](https://www.npmjs.com/package/@webiny/app-headless-cms-common)
-[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
+> [!NOTE]
+> This package is part of the [Webiny](https://www.webiny.com) monorepo.
+> It’s **included in every Webiny project by default** and is not meant to be used as a standalone package.
 
-## Install
+📘 **Documentation:** [https://www.webiny.com/docs](https://www.webiny.com/docs)
 
-```
-npm install --save @webiny/app-headless-cms-common
-```
+---
 
-Or if you prefer yarn:
-
-```
-yarn add @webiny/app-headless-cms-common
-```
+_This README file is automatically generated during the publish process._

package/constants.d.ts

@@ -1 +1 @@
-export declare const CMS_MODEL_SINGLETON_TAG = "singleton";
+export declare const CMS_MODEL_SINGLETON_TAG = "singleEntry";

package/constants.js

@@ -1,3 +1,4 @@
-export const CMS_MODEL_SINGLETON_TAG = "singleton";
+const CMS_MODEL_SINGLETON_TAG = "singleEntry";
+export { CMS_MODEL_SINGLETON_TAG };
 
 //# sourceMappingURL=constants.js.map

package/constants.js.map

@@ -1 +1 @@
-{"version":3,"names":["CMS_MODEL_SINGLETON_TAG"],"sources":["constants.ts"],"sourcesContent":["export const CMS_MODEL_SINGLETON_TAG = \"singleton\";\n"],"mappings":"AAAA,OAAO,MAAMA,uBAAuB,GAAG,WAAW","ignoreList":[]}
+{"version":3,"file":"constants.js","sources":["../src/constants.ts"],"sourcesContent":["export const CMS_MODEL_SINGLETON_TAG = \"singleEntry\";\n"],"names":["CMS_MODEL_SINGLETON_TAG"],"mappings":"AAAO,MAAMA,0BAA0B"}

package/exports/admin/cms.d.ts

@@ -0,0 +1 @@
+export type { CmsContentEntry, CmsModel, CmsModelField, CmsModelLayoutField, CmsIdentity } from "../../types/index.js";

package/index.d.ts

@@ -1,10 +1 @@
-export * from "./Fields";
-export * from "./ModelFieldProvider";
-export * from "./ModelProvider";
-export * from "./entries.graphql";
-export * from "./getModelTitleFieldId";
-export * from "./createFieldsList";
-export * from "./createValidationContainer";
-export * from "./createValidators";
-export * from "./prepareFormData";
-export * from "./constants";
+export { CMS_MODEL_SINGLETON_TAG } from "./constants.js";

package/index.js

@@ -1,12 +1 @@
-export * from "./Fields";
-export * from "./ModelFieldProvider";
-export * from "./ModelProvider";
-export * from "./entries.graphql";
-export * from "./getModelTitleFieldId";
-export * from "./createFieldsList";
-export * from "./createValidationContainer";
-export * from "./createValidators";
-export * from "./prepareFormData";
-export * from "./constants";
-
-//# sourceMappingURL=index.js.map
+export { CMS_MODEL_SINGLETON_TAG } from "./constants.js";

package/package.json

@@ -1,7 +1,11 @@
 {
 	"name": "@webiny/app-headless-cms-common",
-	"version": "0.0.0-unstable.a4637c5ce6",
-	"main": "index.js",
+	"version": "0.0.0-unstable.a4f3e4ea8b",
+	"type": "module",
+	"exports": {
+		".": "./index.js",
+		"./*": "./*"
+	},
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/webiny/webiny-js.git"
@@ -13,40 +17,27 @@
 	],
 	"license": "MIT",
 	"dependencies": {
-		"@emotion/react": "11.10.8",
-		"@emotion/styled": "11.10.6",
-		"@fortawesome/fontawesome-svg-core": "1.3.0",
-		"@webiny/admin-ui": "0.0.0-unstable.a4637c5ce6",
-		"@webiny/app": "0.0.0-unstable.a4637c5ce6",
-		"@webiny/app-admin": "0.0.0-unstable.a4637c5ce6",
-		"@webiny/app-security": "0.0.0-unstable.a4637c5ce6",
-		"@webiny/form": "0.0.0-unstable.a4637c5ce6",
-		"@webiny/plugins": "0.0.0-unstable.a4637c5ce6",
-		"@webiny/react-composition": "0.0.0-unstable.a4637c5ce6",
-		"@webiny/validation": "0.0.0-unstable.a4637c5ce6",
+		"@fortawesome/fontawesome-svg-core": "7.3.1",
+		"@webiny/admin-ui": "0.0.0-unstable.a4f3e4ea8b",
+		"@webiny/app": "0.0.0-unstable.a4f3e4ea8b",
+		"@webiny/app-admin": "0.0.0-unstable.a4f3e4ea8b",
+		"@webiny/form": "0.0.0-unstable.a4f3e4ea8b",
+		"@webiny/plugins": "0.0.0-unstable.a4f3e4ea8b",
+		"@webiny/validation": "0.0.0-unstable.a4f3e4ea8b",
 		"dnd-core": "16.0.1",
-		"graphql": "15.9.0",
-		"graphql-tag": "2.12.6",
-		"lodash": "4.17.21",
-		"prop-types": "15.8.1",
-		"react": "18.2.0"
+		"react": "18.3.1"
 	},
 	"devDependencies": {
-		"@emotion/babel-plugin": "11.11.0",
-		"@types/react": "18.2.79",
-		"@webiny/cli": "0.0.0-unstable.a4637c5ce6",
-		"@webiny/project-utils": "0.0.0-unstable.a4637c5ce6",
-		"babel-plugin-module-resolver": "5.0.2",
-		"rimraf": "6.0.1",
-		"typescript": "5.3.3"
+		"@types/react": "18.3.31",
+		"@webiny/build-tools": "0.0.0-unstable.a4f3e4ea8b",
+		"rimraf": "6.1.3",
+		"typescript": "7.0.2"
 	},
 	"publishConfig": {
-		"access": "public",
-		"directory": "dist"
-	},
-	"scripts": {
-		"build": "node ../cli/bin.js run build",
-		"watch": "node ../cli/bin.js run watch"
+		"access": "public"
 	},
-	"gitHead": "a4637c5ce60a72a1cb15dfa96576cb931e4cc911"
+	"gitHead": "8476da73b653c89cc1474d968baf55c1b0ae0e5f",
+	"webiny": {
+		"publishFrom": "dist"
+	}
 }

package/types/index.d.ts

@@ -1,25 +1,21 @@
 import type * as React from "react";
 import type { ReactElement, ReactNode } from "react";
-import type { Plugin } from "@webiny/plugins/types";
+import type { Plugin } from "@webiny/plugins/types.js";
 import type { BindComponent as BaseBindComponent, BindComponentProps as BaseBindComponentProps, BindComponentRenderProp as BaseBindComponentRenderProp, FormAPI } from "@webiny/form";
 import type { IconName, IconPrefix } from "@fortawesome/fontawesome-svg-core";
-import type { SecurityPermission } from "@webiny/app-security/types";
-import type { CmsModelFieldValidator, CmsModelFieldValidatorsFactory, CmsModelFieldValidatorsGroup } from "./validation";
-import type { CmsModel, CmsModelField } from "./model";
-import type { CmsIdentity } from "./shared";
+import type { CmsEditorFieldsLayout, CmsLayoutField, CmsModel, CmsModelField } from "./model.js";
+import type { CmsIdentity } from "../types/shared.js";
 import type { SourceType } from "dnd-core";
 import type { IconPickerIconDto } from "@webiny/admin-ui";
+import type { GenericRecord } from "@webiny/app/types.js";
+import type { Identity } from "@webiny/app-admin/domain/Identity.js";
+import type { CmsModelFieldValidator } from "./model.js";
 export type DragObjectWithType = {
     type: SourceType;
 };
-export * from "./validation";
-export * from "./model";
-export * from "./shared";
-interface QueryFieldParams {
-    model: CmsModel;
-    field: CmsModelField;
-    graphQLTypePrefix: string;
-}
+export type * from "./model.js";
+export { isLayoutField } from "./model.js";
+export type * from "./shared.js";
 interface Position {
     row: number;
     index: number;
@@ -30,282 +26,12 @@ interface Location {
 export interface DragSource extends DragObjectWithType {
     parent?: string;
     pos?: Partial<Position>;
-    type: "row" | "field" | "newField";
+    type: "row" | "field" | "newField" | "newLayoutField" | "layoutField";
     fieldType?: string;
+    layoutFieldType?: string;
     field?: CmsModelField | null;
     fields?: CmsModelField[];
-}
-/**
- * @deprecated Use `CmsModelFieldTypePlugin`.
- */
-export type CmsEditorFieldTypePlugin = CmsModelFieldTypePlugin;
-export interface CmsModelFieldTypePlugin extends Plugin {
-    /**
-     * a plugin type
-     */
-    type: "cms-editor-field-type";
-    field: {
-        /**
-         * A unique identifier of the field type (text, number, json, myField, ...).
-         *
-         * ```ts
-         * type: "myField"
-         * ```
-         */
-        type: string;
-        /**
-         * A display name for the field.
-         *
-         * ```ts
-         * label: "Field name"
-         * ```
-         */
-        label: string;
-        /**
-         * A list of available validators for the model field.
-         *
-         * ```ts
-         * validators: [
-         *     "required",
-         *     "gte",
-         *     "lte"
-         * ]
-         * ```
-         */
-        validators?: string[] | CmsModelFieldValidatorsGroup | CmsModelFieldValidatorsFactory;
-        /**
-         * A list of available validators when a model field accepts a list (array) of values.
-         *
-         * ```ts
-         * listValidators: [
-         *     "minLength",
-         *     "maxLength"
-         * ]
-         * ```
-         */
-        listValidators?: string[] | CmsModelFieldValidatorsGroup | CmsModelFieldValidatorsFactory;
-        /**
-         * An explanation of the field displayed beneath the label.
-         *
-         * ```ts
-         * description: "A short description of the field"
-         * ```
-         */
-        description: string;
-        /**
-         * A ReactNode to display the icon for the field.
-         *
-         * ```tsx
-         * icon: <MyIconComponent />
-         * ```
-         */
-        icon: React.ReactNode;
-        /**
-         * Is it allowed to have multiple values in this field?
-         *
-         * ```ts
-         * allowMultipleValues: true
-         * ```
-         */
-        allowMultipleValues?: boolean;
-        /**
-         * Does this field type have a fixed list of values that can be selected?
-         *
-         * ```ts
-         * allowPredefinedValues: false
-         * ```
-         */
-        allowPredefinedValues?: boolean;
-        /**
-         * A ReactNode label when multiple values are enabled.
-         */
-        multipleValuesLabel?: React.ReactNode;
-        /**
-         * Determines if this field type should be hidden from the admin UI.
-         * If set to `true`, the field type will not be visible or selectable in the admin interface.
-         */
-        hideInAdmin?: boolean;
-        /**
-         * These are default values when the field is first created. This is a representation of the field that is stored in the database.
-         *
-         * ```ts
-         * createField: () => ({
-         *     type: "fieldType",
-         *     validation: [],
-         *     renderer: {
-         *         name: "fieldTypeRenderer"
-         *     }
-         * })
-         * ```
-         */
-        createField: () => Pick<CmsModelField, "type" | "validation" | "renderer" | "settings">;
-        /**
-         * If `true` (default), this field will be configurable via a settings dialog.
-         * If `false`, a user will not be able to open the settings dialog, not will the dialog be opened on field drop.
-         */
-        canEditSettings?: boolean;
-        /**
-         * Determine if a `draggable` can be dropped into this field.
-         * NOTE: This is only applicable to nested field types.
-         */
-        canAccept?(field: CmsModelField, draggable: DragSource): boolean;
-        /**
-         * If `true` (default), will allow fields to be laid out into columns (next to each other).
-         * If `false`, horizontal layout will not be allowed.
-         * NOTE: This is only applicable to nested field types.
-         */
-        allowLayout?: boolean;
-        /**
-         * A ReactNode that you can add in the section below the help text when creating/editing field.
-         *
-         * ```tsx
-         * renderSettings: (params) => {
-         *     return <FieldSettingsComponent />;
-         * }
-         * ```
-         */
-        renderSettings?: (params: {
-            afterChangeLabel: (value: string) => void;
-            uniqueFieldIdValidator: (fieldId: string) => void;
-            contentModel: CmsModel;
-        }) => React.ReactNode;
-        /**
-         * A ReactNode that renders in the Predefined values tab.
-         *
-         * ```tsx
-         * renderPredefinedValues: (params) => {
-         *     const {form: {Bind}} = params;
-         *     return (
-         *         <Bind name="fieldProperty">
-         *             <InputComponent />
-         *         </Bind>
-         *     );
-         * }
-         * ```
-         */
-        renderPredefinedValues?: (params: {
-            getBind: (index?: number) => any;
-        }) => React.ReactElement;
-        /**
-         * Object wrapper for GraphQL stuff
-         */
-        graphql?: {
-            /**
-             * Define field selection.
-             *
-             * ```ts
-             * graphql: {
-             *     queryField: `
-             *         {
-             *             id
-             *             title
-             *             createdOn
-             *         }
-             *     `,
-             * }
-             * ```
-             */
-            queryField?: string | ((params: QueryFieldParams) => string | null);
-        };
-        render?(params: any): React.ReactElement;
-        tags?: string[];
-        /**
-         * Render additional information in the Admin UI Model edit view
-         */
-        renderInfo?: (params: {
-            field: CmsModelField;
-            model: CmsModel;
-        }) => React.ReactElement;
-    };
-}
-export interface CmsModelFieldRendererSettingsProps {
-    field: CmsModelField;
-}
-export interface CmsModelFieldRendererProps {
-    field: CmsModelField;
-    Label: React.ComponentType<React.PropsWithChildren>;
-    getBind: <T = any>(index?: number, key?: string) => BindComponent<T>;
-    contentModel: CmsModel;
-}
-/**
- * @deprecated Use `CmsModelFieldRendererProps`.
- */
-export type CmsEditorFieldRendererProps = CmsModelFieldRendererProps;
-/**
- * @deprecated Use `CmsModelFieldRendererPlugin`.
- */
-export type CmsEditorFieldRendererPlugin = CmsModelFieldRendererPlugin;
-export interface CmsModelFieldRendererPlugin extends Plugin {
-    /**
-     * a plugin type
-     */
-    type: "cms-editor-field-renderer";
-    renderer: {
-        /**
-         * Name of the renderer to match the one from `createField()` method in `CmsModelFieldTypePlugin`.
-         *
-         * ```ts
-         * renderName: "myFieldTypeRenderer"
-         * ```
-         */
-        rendererName: string;
-        /**
-         * A display name for the field in the UI. It is a `ReactNode` type, so you can use a JSX element.
-         *
-         * ```tsx
-         * name: <MyFieldNameComponent />
-         * ```
-         */
-        name: React.ReactNode;
-        /**
-         * A description for the field in the UI. Works exactly like the `name` property.
-         *
-         * ```tsx
-         * name: <MyFieldDescriptionComponent />
-         * ```
-         */
-        description: React.ReactNode;
-        /**
-         * A method that determines if the field can be rendered by this plugin.
-         *
-         * ```ts
-         * canUse({ field }) {
-         *     return (
-         *         field.type === "myType" && !field.multipleValues
-         *     );
-         * }
-         * ```
-         */
-        canUse(props: {
-            field: CmsModelField;
-            fieldPlugin: CmsModelFieldTypePlugin;
-            model: CmsModel;
-        }): boolean;
-        /**
-         * Renders a field in the UI.
-         *
-         * ```tsx
-         * render({ field, getBind }) {
-         *     const Bind = getBind();
-         *
-         *     return (
-         *         <Bind>
-         *             {bind => {
-         *                 return (
-         *                     <Input
-         *                         value={bind.value}
-         *                         onChange={bind.onChange}
-         *                     />
-         *                 )
-         *             }}
-         *         </Bind>
-         *     );
-         * }
-         * ```
-         */
-        render(props: CmsModelFieldRendererProps): React.ReactNode;
-        renderSettings?: (props: CmsModelFieldRendererSettingsProps) => React.ReactNode;
-    };
+    layoutField?: CmsLayoutField;
 }
 export interface CmsEditorFieldPredefinedValuesEntry {
     label: string;
@@ -323,19 +49,18 @@ export interface CmsDynamicZoneTemplate {
     description: string;
     icon: string;
     fields: CmsModelField[];
-    layout: string[][];
+    layout: CmsEditorFieldsLayout;
     validation: CmsModelFieldValidator[];
     tags?: string[];
-}
-export interface CmsDynamicZoneTemplateWithTypename extends CmsDynamicZoneTemplate {
-    __typename: string;
+    componentName?: string;
 }
 export type CmsContentEntryStatusType = "draft" | "published" | "unpublished";
-/**
- * @deprecated Use `CmsContentEntry`.
- */
-export type CmsEditorContentEntry = CmsContentEntry;
-export interface CmsContentEntry {
+export interface CmsContentEntryLive {
+    version: number;
+}
+export interface CmsContentEntrySystem {
+}
+export interface CmsContentEntry<TValues extends GenericRecord = GenericRecord> {
     id: string;
     entryId: string;
     modelId: string;
@@ -364,6 +89,8 @@ export interface CmsContentEntry {
     revisionLastPublishedOn: string | null;
     revisionLastPublishedBy: CmsIdentity | null;
     wbyAco_location: Location;
+    live: CmsContentEntryLive | null;
+    system: CmsContentEntrySystem | null;
     meta: {
         title: string;
         description?: string;
@@ -372,7 +99,8 @@ export interface CmsContentEntry {
         status: CmsContentEntryStatusType;
         version: number;
     };
-    [key: string]: any;
+    revisionDescription?: string;
+    values: TValues;
 }
 export interface CmsContentEntryRevision {
     id: string;
@@ -396,6 +124,7 @@ export interface CmsContentEntryRevision {
     revisionFirstPublishedBy: CmsIdentity | null;
     revisionLastPublishedBy: CmsIdentity | null;
     wbyAco_location: Location;
+    revisionDescription?: string;
     meta: {
         title: string;
         locked: boolean;
@@ -403,9 +132,6 @@ export interface CmsContentEntryRevision {
         version: number;
     };
 }
-export type CmsEditorContentTab = React.ComponentType<{
-    activeTab: boolean;
-}>;
 export interface CmsEditorFieldOptionPlugin extends Plugin {
     type: "cms-editor-field-option";
     render(): ReactElement;
@@ -413,24 +139,21 @@ export interface CmsEditorFieldOptionPlugin extends Plugin {
 export interface CmsContentDetailsPlugin extends Plugin {
     render: (params: any) => ReactNode;
 }
-export interface FieldLayoutPosition {
-    row: number;
-    index: number | null;
-}
-export interface CmsEditorFormSettingsPlugin extends Plugin {
+export interface CmsEditorFormSettingsPlugin<T = GenericRecord> extends Plugin {
     type: "cms-editor-form-settings";
     title: string;
     description: string;
     icon: React.ReactElement;
+    showSave?: boolean;
     render(props: {
         Bind: BaseBindComponent;
-        form: FormAPI;
-        formData: any;
+        form: FormAPI<T>;
+        formData: T;
     }): React.ReactNode;
     renderHeaderActions?(props: {
         Bind: BaseBindComponent;
-        form: FormAPI;
-        formData: any;
+        form: FormAPI<T>;
+        formData: T;
     }): React.ReactNode;
 }
 export interface CmsIcon {
@@ -507,15 +230,15 @@ export interface CmsContentFormRendererPlugin extends Plugin {
  * Data types
  * #########################
  */
-export interface CmsSecurityPermission extends SecurityPermission {
+export interface CmsSecurityPermission extends Identity.Permission {
     accessLevel?: "full" | "no" | "custom";
-    models?: Record<string, string>;
-    groups?: Record<string, string>;
+    models?: string[];
+    groups?: string[];
     endpoints?: string[];
-    locales?: string[];
     rwd?: string;
     own?: boolean;
     pw?: string;
+    _src?: string;
 }
 /**
  * @category GraphQL

package/types/index.js

@@ -1,56 +1 @@
-export * from "./validation";
-export * from "./model";
-export * from "./shared";
-
-/**
- * @deprecated Use `CmsModelFieldTypePlugin`.
- */
-
-/**
- * @deprecated Use `CmsModelFieldRendererProps`.
- */
-
-/**
- * @deprecated Use `CmsModelFieldRendererPlugin`.
- */
-
-/**
- * @deprecated Use `CmsContentEntry`.
- */
-
-// ------------------------------------------------------------------------------------------------------------
-
-/**
- * Transform field value when sending data to the API.
- */
-
-/**
- * Define a custom form layout renderer for a specific content model.
- */
-
-/**
- * #########################
- * Data types
- * #########################
- */
-
-/**
- * @category GraphQL
- * @category Error
- */
-
-/**
- * @category GraphQL
- * @category Meta
- */
-
-/***
- * ###### FORM ########
- */
-
-/**
- * After RequestReview and RequestChanges was removed, we need an option to add new status filters
- */
-export {};
-
-//# sourceMappingURL=index.js.map
+export { isLayoutField } from "./model.js";