datocms-plugin-sdk 2.0.1 → 2.0.3

package/dist/esm/manifest.js

@@ -3,7 +3,7 @@ export var manifest = {
         validateManualFieldExtensionParameters: {
             name: 'validateManualFieldExtensionParameters',
             comment: {
-                comment: 'This function will be called each time the configuration object changes. It\nmust return an object containing possible validation errors',
+                markdownText: 'This function will be called each time the configuration object changes. It\nmust return an object containing possible validation errors.',
                 tag: 'manualFieldExtensions',
             },
             nonCtxArguments: [
@@ -25,7 +25,7 @@ export var manifest = {
         uploadsDropdownActions: {
             name: 'uploadsDropdownActions',
             comment: {
-                comment: 'This function lets you set up custom actions (or groups of actions) that\nshow up when the user:\n\n* selects multiple assets in the Media Area for batch operations, or\n* opens up a specific asset from the Media Area.\n\nThe `executeUploadsDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
+                markdownText: 'This function lets you set up custom actions (or groups of actions) that\nshow up when the user:\n\n* selects multiple assets in the Media Area for batch operations, or\n* opens up a specific asset from the Media Area.\n\nThe `executeUploadsDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [],
@@ -43,7 +43,7 @@ export var manifest = {
         uploadSidebars: {
             name: 'uploadSidebars',
             comment: {
-                comment: 'Use this function to declare new sidebar to be shown when the user opens\nup an asset in the Media Area',
+                markdownText: 'Use this function to declare new sidebar to be shown when the user opens\nup an asset in the Media Area.',
                 tag: 'sidebarPanels',
             },
             nonCtxArguments: [],
@@ -61,7 +61,7 @@ export var manifest = {
         uploadSidebarPanels: {
             name: 'uploadSidebarPanels',
             comment: {
-                comment: 'Use this function to declare new sidebar panels to be shown when the user\nopens up an asset in the Media Area',
+                markdownText: 'Use this function to declare new sidebar panels to be shown when the user\nopens up an asset in the Media Area.',
                 tag: 'sidebarPanels',
             },
             nonCtxArguments: [],
@@ -79,7 +79,7 @@ export var manifest = {
         settingsAreaSidebarItemGroups: {
             name: 'settingsAreaSidebarItemGroups',
             comment: {
-                comment: 'Use this function to declare new navigation sections in the Settings Area\nsidebar',
+                markdownText: 'Use this function to declare new navigation sections in the Settings Area\nsidebar.',
                 tag: 'pages',
             },
             nonCtxArguments: [],
@@ -97,7 +97,7 @@ export var manifest = {
         renderUploadSidebarPanel: {
             name: 'renderUploadSidebarPanel',
             comment: {
-                comment: 'This function will be called when the plugin needs to render a sidebar panel\n(see the `uploadSidebarPanels` function)',
+                markdownText: 'This function will be called when the plugin needs to render a sidebar panel\n(see the `uploadSidebarPanels` hook).',
                 tag: 'sidebarPanels',
             },
             nonCtxArguments: [
@@ -113,7 +113,7 @@ export var manifest = {
                         items: {
                             sidebarPaneId: {
                                 comment: {
-                                    comment: 'The ID of the sidebar panel that needs to be rendered',
+                                    markdownText: 'The ID of the sidebar panel that needs to be rendered.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderUploadSidebarPanel.ts',
@@ -123,7 +123,7 @@ export var manifest = {
                             },
                             parameters: {
                                 comment: {
-                                    comment: 'The arbitrary `parameters` of the panel declared in the\n`uploadSidebarPanels` function',
+                                    markdownText: 'The arbitrary `parameters` of the panel declared in the\n`uploadSidebarPanels` function.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderUploadSidebarPanel.ts',
@@ -133,7 +133,7 @@ export var manifest = {
                             },
                             upload: {
                                 comment: {
-                                    comment: 'The active asset',
+                                    markdownText: 'The active asset.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderUploadSidebarPanel.ts',
@@ -155,7 +155,7 @@ export var manifest = {
         renderUploadSidebar: {
             name: 'renderUploadSidebar',
             comment: {
-                comment: 'This function will be called when the plugin needs to render a sidebar (see\nthe `uploadSidebars` function)',
+                markdownText: 'This function will be called when the plugin needs to render a sidebar (see\nthe `uploadSidebars` hook).',
                 tag: 'sidebarPanels',
             },
             nonCtxArguments: [
@@ -171,7 +171,7 @@ export var manifest = {
                         items: {
                             sidebarId: {
                                 comment: {
-                                    comment: 'The ID of the sidebar that needs to be rendered',
+                                    markdownText: 'The ID of the sidebar that needs to be rendered.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderUploadSidebar.ts',
@@ -181,7 +181,7 @@ export var manifest = {
                             },
                             parameters: {
                                 comment: {
-                                    comment: 'The arbitrary `parameters` of the declared in the `uploadSidebars`\nfunction',
+                                    markdownText: 'The arbitrary `parameters` of the declared in the `uploadSidebars`\nfunction.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderUploadSidebar.ts',
@@ -191,7 +191,7 @@ export var manifest = {
                             },
                             upload: {
                                 comment: {
-                                    comment: 'The active asset',
+                                    markdownText: 'The active asset.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderUploadSidebar.ts',
@@ -213,7 +213,7 @@ export var manifest = {
         renderPage: {
             name: 'renderPage',
             comment: {
-                comment: 'This function will be called when the plugin needs to render a specific\npage (see the `mainNavigationTabs`, `settingsAreaSidebarItemGroups` and\n`contentAreaSidebarItems` functions)',
+                markdownText: 'This function will be called when the plugin needs to render a specific\npage (see the `mainNavigationTabs`, `settingsAreaSidebarItemGroups` and\n`contentAreaSidebarItems` functions).',
                 tag: 'pages',
             },
             nonCtxArguments: [
@@ -229,7 +229,7 @@ export var manifest = {
                         items: {
                             pageId: {
                                 comment: {
-                                    comment: 'The ID of the page that needs to be rendered',
+                                    markdownText: 'The ID of the page that needs to be rendered.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderPage.ts',
@@ -251,7 +251,7 @@ export var manifest = {
         renderModal: {
             name: 'renderModal',
             comment: {
-                comment: 'This function will be called when the plugin requested to open a modal (see\nthe `openModal` function)',
+                markdownText: 'This function will be called when the plugin requested to open a modal (see\nthe `openModal` hook).',
                 tag: 'modals',
             },
             nonCtxArguments: [
@@ -267,7 +267,7 @@ export var manifest = {
                         items: {
                             modalId: {
                                 comment: {
-                                    comment: 'The ID of the modal that needs to be rendered',
+                                    markdownText: 'The ID of the modal that needs to be rendered.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderModal.ts',
@@ -277,7 +277,7 @@ export var manifest = {
                             },
                             parameters: {
                                 comment: {
-                                    comment: 'The arbitrary `parameters` of the modal declared in the `openModal`\nfunction',
+                                    markdownText: 'The arbitrary `parameters` of the modal declared in the `openModal`\nfunction.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderModal.ts',
@@ -293,7 +293,7 @@ export var manifest = {
                         items: {
                             resolve: {
                                 comment: {
-                                    comment: 'A function to be called by the plugin to close the modal. The `openModal`\ncall will be resolved with the passed return value',
+                                    markdownText: 'A function to be called by the plugin to close the modal. The `openModal`\ncall will be resolved with the passed return value.',
                                     example: "const returnValue = prompt(\n  'Please specify the value to return to the caller:',\n  'success',\n);\n\nawait ctx.resolve(returnValue);",
                                 },
                                 location: {
@@ -327,7 +327,7 @@ export var manifest = {
                         items: {
                             fieldExtensionId: {
                                 comment: {
-                                    comment: 'The ID of the field extension for which we need to render the parameters\nform',
+                                    markdownText: 'The ID of the field extension for which we need to render the parameters\nform.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderManualFieldExtensionConfigScreen.ts',
@@ -337,7 +337,7 @@ export var manifest = {
                             },
                             parameters: {
                                 comment: {
-                                    comment: 'The current value of the parameters (you can change the value with the\n`setParameters` function)',
+                                    markdownText: 'The current value of the parameters (you can change the value with the\n`setParameters` hook).',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderManualFieldExtensionConfigScreen.ts',
@@ -347,7 +347,7 @@ export var manifest = {
                             },
                             errors: {
                                 comment: {
-                                    comment: 'The current validation errors for the parameters (you can set them\nimplementing the `validateManualFieldExtensionParameters` function)',
+                                    markdownText: 'The current validation errors for the parameters (you can set them\nimplementing the `validateManualFieldExtensionParameters` hook).',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderManualFieldExtensionConfigScreen.ts',
@@ -357,7 +357,7 @@ export var manifest = {
                             },
                             pendingField: {
                                 comment: {
-                                    comment: 'The field entity that is being edited in the form',
+                                    markdownText: 'The field entity that is being edited in the form.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderManualFieldExtensionConfigScreen.ts',
@@ -367,7 +367,7 @@ export var manifest = {
                             },
                             itemType: {
                                 comment: {
-                                    comment: 'The model for the field being edited',
+                                    markdownText: 'The model for the field being edited.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderManualFieldExtensionConfigScreen.ts',
@@ -383,7 +383,7 @@ export var manifest = {
                         items: {
                             setParameters: {
                                 comment: {
-                                    comment: 'Sets a new value for the parameters',
+                                    markdownText: 'Sets a new value for the parameters.',
                                     example: "await ctx.setParameters({ color: '#ff0000' });",
                                 },
                                 location: {
@@ -405,7 +405,7 @@ export var manifest = {
         renderItemFormSidebarPanel: {
             name: 'renderItemFormSidebarPanel',
             comment: {
-                comment: 'This function will be called when the plugin needs to render a sidebar panel\n(see the `itemFormSidebarPanels` function)',
+                markdownText: 'This function will be called when the plugin needs to render a sidebar panel\n(see the `itemFormSidebarPanels` hook).',
                 tag: 'sidebarPanels',
             },
             nonCtxArguments: [
@@ -418,10 +418,14 @@ export var manifest = {
                 type: 'SelfResizingPluginFrameCtx',
                 additionalProperties: [
                     {
+                        name: 'ItemFormAdditionalProperties',
+                        comment: {
+                            markdownText: "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+                        },
                         items: {
                             locale: {
                                 comment: {
-                                    comment: 'The currently active locale for the record',
+                                    markdownText: 'The currently active locale for the record.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -431,7 +435,7 @@ export var manifest = {
                             },
                             item: {
                                 comment: {
-                                    comment: 'If an already persisted record is being edited, returns the full record\nentity',
+                                    markdownText: 'If an already persisted record is being edited, returns the full record\nentity.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -441,7 +445,7 @@ export var manifest = {
                             },
                             itemType: {
                                 comment: {
-                                    comment: 'The model for the record being edited',
+                                    markdownText: 'The model for the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -451,7 +455,7 @@ export var manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -461,7 +465,7 @@ export var manifest = {
                             },
                             itemStatus: {
                                 comment: {
-                                    comment: 'The current status of the record being edited',
+                                    markdownText: 'The current status of the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -471,7 +475,7 @@ export var manifest = {
                             },
                             isSubmitting: {
                                 comment: {
-                                    comment: 'Whether the form is currently submitting itself or not',
+                                    markdownText: 'Whether the form is currently submitting itself or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -481,7 +485,7 @@ export var manifest = {
                             },
                             isFormDirty: {
                                 comment: {
-                                    comment: 'Whether the form has some non-persisted changes or not',
+                                    markdownText: 'Whether the form has some non-persisted changes or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -491,13 +495,13 @@ export var manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Current number of blocks present in form state',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
                                     lineNumber: 29,
                                 },
-                                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                                type: 'BlocksAnalysis',
                             },
                         },
                     },
@@ -505,7 +509,7 @@ export var manifest = {
                         items: {
                             sidebarPaneId: {
                                 comment: {
-                                    comment: 'The ID of the sidebar panel that needs to be rendered',
+                                    markdownText: 'The ID of the sidebar panel that needs to be rendered.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderItemFormSidebarPanel.ts',
@@ -515,7 +519,7 @@ export var manifest = {
                             },
                             parameters: {
                                 comment: {
-                                    comment: 'The arbitrary `parameters` of the panel declared in the\n`itemFormSidebarPanels` function',
+                                    markdownText: 'The arbitrary `parameters` of the panel declared in the\n`itemFormSidebarPanels` function.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderItemFormSidebarPanel.ts',
@@ -528,81 +532,85 @@ export var manifest = {
                 ],
                 additionalMethods: [
                     {
+                        name: 'ItemFormAdditionalMethods',
+                        comment: {
+                            markdownText: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+                        },
                         items: {
                             toggleField: {
                                 comment: {
-                                    comment: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
+                                    markdownText: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 65,
+                                    lineNumber: 68,
                                 },
                                 type: '(path: string, show: boolean) => Promise<void>',
                             },
                             disableField: {
                                 comment: {
-                                    comment: 'Disables/re-enables a specific field in the form',
+                                    markdownText: 'Disables/re-enables a specific field in the form.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 80,
+                                    lineNumber: 83,
                                 },
                                 type: '(path: string, disable: boolean) => Promise<void>',
                             },
                             scrollToField: {
                                 comment: {
-                                    comment: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
+                                    markdownText: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 97,
+                                    lineNumber: 100,
                                 },
                                 type: '(path: string, locale?: string) => Promise<void>',
                             },
                             setFieldValue: {
                                 comment: {
-                                    comment: 'Changes a specific path of the `formValues` object',
+                                    markdownText: 'Changes a specific path of the `formValues` object.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 112,
+                                    lineNumber: 115,
                                 },
                                 type: '(path: string, value: unknown) => Promise<void>',
                             },
                             formValuesToItem: {
                                 comment: {
-                                    comment: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
+                                    markdownText: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                                     example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 129,
+                                    lineNumber: 132,
                                 },
                                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
                             },
                             itemToFormValues: {
                                 comment: {
-                                    comment: 'Takes an Item entity, and converts it into the internal form state',
+                                    markdownText: 'Takes an Item entity, and converts it into the internal form state.',
                                     example: 'await ctx.itemToFormValues(ctx.item);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 142,
+                                    lineNumber: 145,
                                 },
                                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 154,
+                                    lineNumber: 157,
                                 },
                                 type: '(showToast?: boolean) => Promise<void>',
                             },
@@ -619,7 +627,7 @@ export var manifest = {
         renderItemFormSidebar: {
             name: 'renderItemFormSidebar',
             comment: {
-                comment: 'This function will be called when the plugin needs to render a sidebar (see\nthe `itemFormSidebars` function)',
+                markdownText: 'This function will be called when the plugin needs to render a sidebar (see\nthe `itemFormSidebars` hook).',
                 tag: 'sidebarPanels',
             },
             nonCtxArguments: [
@@ -632,10 +640,14 @@ export var manifest = {
                 type: 'ImposedSizePluginFrameCtx',
                 additionalProperties: [
                     {
+                        name: 'ItemFormAdditionalProperties',
+                        comment: {
+                            markdownText: "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+                        },
                         items: {
                             locale: {
                                 comment: {
-                                    comment: 'The currently active locale for the record',
+                                    markdownText: 'The currently active locale for the record.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -645,7 +657,7 @@ export var manifest = {
                             },
                             item: {
                                 comment: {
-                                    comment: 'If an already persisted record is being edited, returns the full record\nentity',
+                                    markdownText: 'If an already persisted record is being edited, returns the full record\nentity.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -655,7 +667,7 @@ export var manifest = {
                             },
                             itemType: {
                                 comment: {
-                                    comment: 'The model for the record being edited',
+                                    markdownText: 'The model for the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -665,7 +677,7 @@ export var manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -675,7 +687,7 @@ export var manifest = {
                             },
                             itemStatus: {
                                 comment: {
-                                    comment: 'The current status of the record being edited',
+                                    markdownText: 'The current status of the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -685,7 +697,7 @@ export var manifest = {
                             },
                             isSubmitting: {
                                 comment: {
-                                    comment: 'Whether the form is currently submitting itself or not',
+                                    markdownText: 'Whether the form is currently submitting itself or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -695,7 +707,7 @@ export var manifest = {
                             },
                             isFormDirty: {
                                 comment: {
-                                    comment: 'Whether the form has some non-persisted changes or not',
+                                    markdownText: 'Whether the form has some non-persisted changes or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -705,13 +717,13 @@ export var manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Current number of blocks present in form state',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
                                     lineNumber: 29,
                                 },
-                                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                                type: 'BlocksAnalysis',
                             },
                         },
                     },
@@ -719,7 +731,7 @@ export var manifest = {
                         items: {
                             sidebarId: {
                                 comment: {
-                                    comment: 'The ID of the sidebar that needs to be rendered',
+                                    markdownText: 'The ID of the sidebar that needs to be rendered.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderItemFormSidebar.ts',
@@ -729,7 +741,7 @@ export var manifest = {
                             },
                             parameters: {
                                 comment: {
-                                    comment: 'The arbitrary `parameters` of the declared in the `itemFormSidebars`\nfunction',
+                                    markdownText: 'The arbitrary `parameters` of the declared in the `itemFormSidebars`\nfunction.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderItemFormSidebar.ts',
@@ -742,81 +754,85 @@ export var manifest = {
                 ],
                 additionalMethods: [
                     {
+                        name: 'ItemFormAdditionalMethods',
+                        comment: {
+                            markdownText: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+                        },
                         items: {
                             toggleField: {
                                 comment: {
-                                    comment: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
+                                    markdownText: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 65,
+                                    lineNumber: 68,
                                 },
                                 type: '(path: string, show: boolean) => Promise<void>',
                             },
                             disableField: {
                                 comment: {
-                                    comment: 'Disables/re-enables a specific field in the form',
+                                    markdownText: 'Disables/re-enables a specific field in the form.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 80,
+                                    lineNumber: 83,
                                 },
                                 type: '(path: string, disable: boolean) => Promise<void>',
                             },
                             scrollToField: {
                                 comment: {
-                                    comment: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
+                                    markdownText: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 97,
+                                    lineNumber: 100,
                                 },
                                 type: '(path: string, locale?: string) => Promise<void>',
                             },
                             setFieldValue: {
                                 comment: {
-                                    comment: 'Changes a specific path of the `formValues` object',
+                                    markdownText: 'Changes a specific path of the `formValues` object.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 112,
+                                    lineNumber: 115,
                                 },
                                 type: '(path: string, value: unknown) => Promise<void>',
                             },
                             formValuesToItem: {
                                 comment: {
-                                    comment: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
+                                    markdownText: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                                     example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 129,
+                                    lineNumber: 132,
                                 },
                                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
                             },
                             itemToFormValues: {
                                 comment: {
-                                    comment: 'Takes an Item entity, and converts it into the internal form state',
+                                    markdownText: 'Takes an Item entity, and converts it into the internal form state.',
                                     example: 'await ctx.itemToFormValues(ctx.item);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 142,
+                                    lineNumber: 145,
                                 },
                                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 154,
+                                    lineNumber: 157,
                                 },
                                 type: '(showToast?: boolean) => Promise<void>',
                             },
@@ -833,7 +849,7 @@ export var manifest = {
         renderItemFormOutlet: {
             name: 'renderItemFormOutlet',
             comment: {
-                comment: 'This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.',
+                markdownText: 'This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.',
                 tag: 'outlets',
             },
             nonCtxArguments: [
@@ -846,10 +862,14 @@ export var manifest = {
                 type: 'SelfResizingPluginFrameCtx',
                 additionalProperties: [
                     {
+                        name: 'ItemFormAdditionalProperties',
+                        comment: {
+                            markdownText: "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+                        },
                         items: {
                             locale: {
                                 comment: {
-                                    comment: 'The currently active locale for the record',
+                                    markdownText: 'The currently active locale for the record.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -859,7 +879,7 @@ export var manifest = {
                             },
                             item: {
                                 comment: {
-                                    comment: 'If an already persisted record is being edited, returns the full record\nentity',
+                                    markdownText: 'If an already persisted record is being edited, returns the full record\nentity.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -869,7 +889,7 @@ export var manifest = {
                             },
                             itemType: {
                                 comment: {
-                                    comment: 'The model for the record being edited',
+                                    markdownText: 'The model for the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -879,7 +899,7 @@ export var manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -889,7 +909,7 @@ export var manifest = {
                             },
                             itemStatus: {
                                 comment: {
-                                    comment: 'The current status of the record being edited',
+                                    markdownText: 'The current status of the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -899,7 +919,7 @@ export var manifest = {
                             },
                             isSubmitting: {
                                 comment: {
-                                    comment: 'Whether the form is currently submitting itself or not',
+                                    markdownText: 'Whether the form is currently submitting itself or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -909,7 +929,7 @@ export var manifest = {
                             },
                             isFormDirty: {
                                 comment: {
-                                    comment: 'Whether the form has some non-persisted changes or not',
+                                    markdownText: 'Whether the form has some non-persisted changes or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -919,13 +939,13 @@ export var manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Current number of blocks present in form state',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
                                     lineNumber: 29,
                                 },
-                                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                                type: 'BlocksAnalysis',
                             },
                         },
                     },
@@ -933,7 +953,7 @@ export var manifest = {
                         items: {
                             itemFormOutletId: {
                                 comment: {
-                                    comment: 'The ID of the outlet that needs to be rendered',
+                                    markdownText: 'The ID of the outlet that needs to be rendered.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderItemFormOutlet.ts',
@@ -946,81 +966,85 @@ export var manifest = {
                 ],
                 additionalMethods: [
                     {
+                        name: 'ItemFormAdditionalMethods',
+                        comment: {
+                            markdownText: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+                        },
                         items: {
                             toggleField: {
                                 comment: {
-                                    comment: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
+                                    markdownText: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 65,
+                                    lineNumber: 68,
                                 },
                                 type: '(path: string, show: boolean) => Promise<void>',
                             },
                             disableField: {
                                 comment: {
-                                    comment: 'Disables/re-enables a specific field in the form',
+                                    markdownText: 'Disables/re-enables a specific field in the form.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 80,
+                                    lineNumber: 83,
                                 },
                                 type: '(path: string, disable: boolean) => Promise<void>',
                             },
                             scrollToField: {
                                 comment: {
-                                    comment: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
+                                    markdownText: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 97,
+                                    lineNumber: 100,
                                 },
                                 type: '(path: string, locale?: string) => Promise<void>',
                             },
                             setFieldValue: {
                                 comment: {
-                                    comment: 'Changes a specific path of the `formValues` object',
+                                    markdownText: 'Changes a specific path of the `formValues` object.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 112,
+                                    lineNumber: 115,
                                 },
                                 type: '(path: string, value: unknown) => Promise<void>',
                             },
                             formValuesToItem: {
                                 comment: {
-                                    comment: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
+                                    markdownText: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                                     example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 129,
+                                    lineNumber: 132,
                                 },
                                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
                             },
                             itemToFormValues: {
                                 comment: {
-                                    comment: 'Takes an Item entity, and converts it into the internal form state',
+                                    markdownText: 'Takes an Item entity, and converts it into the internal form state.',
                                     example: 'await ctx.itemToFormValues(ctx.item);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 142,
+                                    lineNumber: 145,
                                 },
                                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 154,
+                                    lineNumber: 157,
                                 },
                                 type: '(showToast?: boolean) => Promise<void>',
                             },
@@ -1037,7 +1061,7 @@ export var manifest = {
         renderItemCollectionOutlet: {
             name: 'renderItemCollectionOutlet',
             comment: {
-                comment: 'This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.',
+                markdownText: 'This function will be called when the plugin needs to render an outlet\ndefined by the `itemFormOutlets()` hook.',
                 tag: 'outlets',
             },
             nonCtxArguments: [
@@ -1053,7 +1077,7 @@ export var manifest = {
                         items: {
                             itemCollectionOutletId: {
                                 comment: {
-                                    comment: 'The ID of the outlet that needs to be rendered',
+                                    markdownText: 'The ID of the outlet that needs to be rendered.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderItemCollectionOutlet.ts',
@@ -1075,7 +1099,7 @@ export var manifest = {
         renderFieldExtension: {
             name: 'renderFieldExtension',
             comment: {
-                comment: 'This function will be called when the plugin needs to render a field\nextension (see the `manualFieldExtensions` and `overrideFieldExtensions`\nfunctions)',
+                markdownText: 'This function will be called when the plugin needs to render a field\nextension (see the `manualFieldExtensions` and `overrideFieldExtensions`\nfunctions).',
                 tag: 'forcedFieldExtensions',
             },
             nonCtxArguments: [
@@ -1088,10 +1112,14 @@ export var manifest = {
                 type: 'SelfResizingPluginFrameCtx',
                 additionalProperties: [
                     {
+                        name: 'ItemFormAdditionalProperties',
+                        comment: {
+                            markdownText: "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+                        },
                         items: {
                             locale: {
                                 comment: {
-                                    comment: 'The currently active locale for the record',
+                                    markdownText: 'The currently active locale for the record.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1101,7 +1129,7 @@ export var manifest = {
                             },
                             item: {
                                 comment: {
-                                    comment: 'If an already persisted record is being edited, returns the full record\nentity',
+                                    markdownText: 'If an already persisted record is being edited, returns the full record\nentity.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1111,7 +1139,7 @@ export var manifest = {
                             },
                             itemType: {
                                 comment: {
-                                    comment: 'The model for the record being edited',
+                                    markdownText: 'The model for the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1121,7 +1149,7 @@ export var manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1131,7 +1159,7 @@ export var manifest = {
                             },
                             itemStatus: {
                                 comment: {
-                                    comment: 'The current status of the record being edited',
+                                    markdownText: 'The current status of the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1141,7 +1169,7 @@ export var manifest = {
                             },
                             isSubmitting: {
                                 comment: {
-                                    comment: 'Whether the form is currently submitting itself or not',
+                                    markdownText: 'Whether the form is currently submitting itself or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1151,7 +1179,7 @@ export var manifest = {
                             },
                             isFormDirty: {
                                 comment: {
-                                    comment: 'Whether the form has some non-persisted changes or not',
+                                    markdownText: 'Whether the form has some non-persisted changes or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1161,65 +1189,69 @@ export var manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Current number of blocks present in form state',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
                                     lineNumber: 29,
                                 },
-                                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                                type: 'BlocksAnalysis',
                             },
                         },
                     },
                     {
+                        name: 'FieldAdditionalProperties',
+                        comment: {
+                            markdownText: 'These information describe the current state of the field where this plugin\nis applied to.',
+                        },
                         items: {
                             disabled: {
                                 comment: {
-                                    comment: 'Whether the field is currently disabled or not',
+                                    markdownText: 'Whether the field is currently disabled or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 8,
+                                    lineNumber: 12,
                                 },
                                 type: 'boolean',
                             },
                             fieldPath: {
                                 comment: {
-                                    comment: 'The path in the `formValues` object where to find the current value for the\nfield',
+                                    markdownText: 'The path in the `formValues` object where to find the current value for the\nfield.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 13,
+                                    lineNumber: 17,
                                 },
                                 type: 'string',
                             },
                             field: {
                                 comment: {
-                                    comment: 'The field where the field extension is installed to',
+                                    markdownText: 'The field where the field extension is installed to.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 15,
+                                    lineNumber: 19,
                                 },
                                 type: 'Field',
                             },
                             parentField: {
                                 comment: {
-                                    comment: 'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself',
+                                    markdownText: 'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 20,
+                                    lineNumber: 24,
                                 },
                                 type: 'Field | undefined',
                             },
                             block: {
                                 comment: {
-                                    comment: 'If the field extension is installed in a field of a block, returns the ID\nof the block — or `undefined` if the block is still not persisted — and the\nblock model.',
+                                    markdownText: 'If the field extension is installed in a field of a block, returns the ID\nof the block — or `undefined` if the block is still not persisted — and the\nblock model.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 26,
+                                    lineNumber: 30,
                                 },
                                 type: 'undefined | { id: string | undefined; blockModel: ItemType }',
                             },
@@ -1229,7 +1261,7 @@ export var manifest = {
                         items: {
                             fieldExtensionId: {
                                 comment: {
-                                    comment: 'The ID of the field extension that needs to be rendered',
+                                    markdownText: 'The ID of the field extension that needs to be rendered.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderFieldExtension.ts',
@@ -1239,7 +1271,7 @@ export var manifest = {
                             },
                             parameters: {
                                 comment: {
-                                    comment: 'The arbitrary `parameters` of the field extension',
+                                    markdownText: 'The arbitrary `parameters` of the field extension.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderFieldExtension.ts',
@@ -1252,81 +1284,85 @@ export var manifest = {
                 ],
                 additionalMethods: [
                     {
+                        name: 'ItemFormAdditionalMethods',
+                        comment: {
+                            markdownText: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+                        },
                         items: {
                             toggleField: {
                                 comment: {
-                                    comment: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
+                                    markdownText: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 65,
+                                    lineNumber: 68,
                                 },
                                 type: '(path: string, show: boolean) => Promise<void>',
                             },
                             disableField: {
                                 comment: {
-                                    comment: 'Disables/re-enables a specific field in the form',
+                                    markdownText: 'Disables/re-enables a specific field in the form.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 80,
+                                    lineNumber: 83,
                                 },
                                 type: '(path: string, disable: boolean) => Promise<void>',
                             },
                             scrollToField: {
                                 comment: {
-                                    comment: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
+                                    markdownText: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 97,
+                                    lineNumber: 100,
                                 },
                                 type: '(path: string, locale?: string) => Promise<void>',
                             },
                             setFieldValue: {
                                 comment: {
-                                    comment: 'Changes a specific path of the `formValues` object',
+                                    markdownText: 'Changes a specific path of the `formValues` object.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 112,
+                                    lineNumber: 115,
                                 },
                                 type: '(path: string, value: unknown) => Promise<void>',
                             },
                             formValuesToItem: {
                                 comment: {
-                                    comment: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
+                                    markdownText: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                                     example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 129,
+                                    lineNumber: 132,
                                 },
                                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
                             },
                             itemToFormValues: {
                                 comment: {
-                                    comment: 'Takes an Item entity, and converts it into the internal form state',
+                                    markdownText: 'Takes an Item entity, and converts it into the internal form state.',
                                     example: 'await ctx.itemToFormValues(ctx.item);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 142,
+                                    lineNumber: 145,
                                 },
                                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 154,
+                                    lineNumber: 157,
                                 },
                                 type: '(showToast?: boolean) => Promise<void>',
                             },
@@ -1343,7 +1379,7 @@ export var manifest = {
         renderConfigScreen: {
             name: 'renderConfigScreen',
             comment: {
-                comment: "This function will be called when the plugin needs to render the plugin's\nconfiguration form",
+                markdownText: "This function will be called when the plugin needs to render the plugin's\nconfiguration form.",
                 tag: 'configScreen',
             },
             nonCtxArguments: [],
@@ -1361,7 +1397,7 @@ export var manifest = {
         renderAssetSource: {
             name: 'renderAssetSource',
             comment: {
-                comment: "This function will be called when the user selects one of the plugin's\nasset sources to upload a new media file.",
+                markdownText: "This function will be called when the user selects one of the plugin's\nasset sources to upload a new media file.",
                 tag: 'assetSources',
             },
             nonCtxArguments: [
@@ -1377,7 +1413,7 @@ export var manifest = {
                         items: {
                             assetSourceId: {
                                 comment: {
-                                    comment: 'The ID of the assetSource that needs to be rendered',
+                                    markdownText: 'The ID of the assetSource that needs to be rendered.',
                                 },
                                 location: {
                                     filePath: 'src/hooks/renderAssetSource.ts',
@@ -1393,7 +1429,7 @@ export var manifest = {
                         items: {
                             select: {
                                 comment: {
-                                    comment: 'Function to be called when the user selects the asset: it will trigger the\ncreation of a new `Upload` that will be added in the Media Area.',
+                                    markdownText: 'Function to be called when the user selects the asset: it will trigger the\ncreation of a new `Upload` that will be added in the Media Area.',
                                     example: "await ctx.select({\n  resource: {\n    url: 'https://images.unsplash.com/photo-1416339306562-f3d12fefd36f',\n    filename: 'man-drinking-coffee.jpg',\n  },\n  copyright: 'Royalty free (Unsplash)',\n  author: 'Jeff Sheldon',\n  notes: 'A man drinking a coffee',\n  tags: ['man', 'coffee'],\n});",
                                 },
                                 location: {
@@ -1415,7 +1451,7 @@ export var manifest = {
         overrideFieldExtensions: {
             name: 'overrideFieldExtensions',
             comment: {
-                comment: 'Use this function to automatically force one or more field extensions to a\nparticular field',
+                markdownText: 'Use this function to automatically force one or more field extensions to a\nparticular field.',
                 tag: 'forcedFieldExtensions',
             },
             nonCtxArguments: [
@@ -1450,7 +1486,7 @@ export var manifest = {
         onBoot: {
             name: 'onBoot',
             comment: {
-                comment: 'This function will be called once at boot time and can be used to perform\nie. some initial integrity checks on the configuration.',
+                markdownText: 'This function will be called once at boot time and can be used to perform\nie. some initial integrity checks on the configuration.',
                 tag: 'boot',
             },
             nonCtxArguments: [],
@@ -1468,7 +1504,7 @@ export var manifest = {
         onBeforeItemsUnpublish: {
             name: 'onBeforeItemsUnpublish',
             comment: {
-                comment: 'This function will be called before unpublishing records. You can stop the\naction by returning `false`',
+                markdownText: 'This function will be called before unpublishing records. You can stop the\naction by returning `false`.',
                 tag: 'beforeHooks',
             },
             nonCtxArguments: [
@@ -1491,7 +1527,7 @@ export var manifest = {
         onBeforeItemsPublish: {
             name: 'onBeforeItemsPublish',
             comment: {
-                comment: 'This function will be called before publishing records. You can stop the\naction by returning `false`',
+                markdownText: 'This function will be called before publishing records. You can stop the\naction by returning `false`.',
                 tag: 'beforeHooks',
             },
             nonCtxArguments: [
@@ -1514,7 +1550,7 @@ export var manifest = {
         onBeforeItemsDestroy: {
             name: 'onBeforeItemsDestroy',
             comment: {
-                comment: 'This function will be called before destroying records. You can stop the\naction by returning `false`',
+                markdownText: 'This function will be called before destroying records. You can stop the\naction by returning `false`.',
                 tag: 'beforeHooks',
             },
             nonCtxArguments: [
@@ -1537,7 +1573,7 @@ export var manifest = {
         onBeforeItemUpsert: {
             name: 'onBeforeItemUpsert',
             comment: {
-                comment: 'This function will be called before saving a new version of a record. You\ncan stop the action by returning `false`',
+                markdownText: 'This function will be called before saving a new version of a record. You\ncan stop the action by returning `false`.',
                 tag: 'beforeHooks',
             },
             nonCtxArguments: [
@@ -1560,7 +1596,7 @@ export var manifest = {
         manualFieldExtensions: {
             name: 'manualFieldExtensions',
             comment: {
-                comment: 'Use this function to declare new field extensions that users will be able\nto install manually in some field',
+                markdownText: 'Use this function to declare new field extensions that users will be able\nto install manually in some field.',
                 tag: 'manualFieldExtensions',
             },
             nonCtxArguments: [],
@@ -1578,7 +1614,7 @@ export var manifest = {
         mainNavigationTabs: {
             name: 'mainNavigationTabs',
             comment: {
-                comment: 'Use this function to declare new tabs you want to add in the top-bar of the\nUI',
+                markdownText: 'Use this function to declare new tabs you want to add in the top-bar of the\nUI.',
                 tag: 'pages',
             },
             nonCtxArguments: [],
@@ -1596,7 +1632,7 @@ export var manifest = {
         itemsDropdownActions: {
             name: 'itemsDropdownActions',
             comment: {
-                comment: 'This function lets you set up custom actions (or groups of actions) that\nshow up when the user:\n\n* selects multiple records in the collection view for batch operations, or\n* starts editing a specific record.\n\nThe `executeItemsDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
+                markdownText: 'This function lets you set up custom actions (or groups of actions) that\nshow up when the user:\n\n* selects multiple records in the collection view for batch operations, or\n* starts editing a specific record.\n\nThe `executeItemsDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -1631,7 +1667,7 @@ export var manifest = {
         itemFormSidebars: {
             name: 'itemFormSidebars',
             comment: {
-                comment: 'Use this function to declare new sidebar to be shown when the user edits\nrecords of a particular model',
+                markdownText: 'Use this function to declare new sidebar to be shown when the user edits\nrecords of a particular model.',
                 tag: 'sidebarPanels',
             },
             nonCtxArguments: [
@@ -1654,7 +1690,7 @@ export var manifest = {
         itemFormSidebarPanels: {
             name: 'itemFormSidebarPanels',
             comment: {
-                comment: 'Use this function to declare new sidebar panels to be shown when the user\nedits records of a particular model',
+                markdownText: 'Use this function to declare new sidebar panels to be shown when the user\nedits records of a particular model.',
                 tag: 'sidebarPanels',
             },
             nonCtxArguments: [
@@ -1677,7 +1713,7 @@ export var manifest = {
         itemFormOutlets: {
             name: 'itemFormOutlets',
             comment: {
-                comment: "Use this function to declare custom outlets to be shown at the top of the\nrecord's editing page",
+                markdownText: "Use this function to declare custom outlets to be shown at the top of the\nrecord's editing page.",
                 tag: 'outlets',
             },
             nonCtxArguments: [
@@ -1700,7 +1736,7 @@ export var manifest = {
         itemFormDropdownActions: {
             name: 'itemFormDropdownActions',
             comment: {
-                comment: 'Use this function to define custom actions (or groups of actions) to be\ndisplayed at when editing a particular record.\n\nThe `executeItemFormDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
+                markdownText: 'Use this function to define custom actions (or groups of actions) to be\ndisplayed at when editing a particular record.\n\nThe `executeItemFormDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -1713,10 +1749,14 @@ export var manifest = {
                 type: 'Ctx',
                 additionalProperties: [
                     {
+                        name: 'ItemFormAdditionalProperties',
+                        comment: {
+                            markdownText: "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+                        },
                         items: {
                             locale: {
                                 comment: {
-                                    comment: 'The currently active locale for the record',
+                                    markdownText: 'The currently active locale for the record.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1726,7 +1766,7 @@ export var manifest = {
                             },
                             item: {
                                 comment: {
-                                    comment: 'If an already persisted record is being edited, returns the full record\nentity',
+                                    markdownText: 'If an already persisted record is being edited, returns the full record\nentity.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1736,7 +1776,7 @@ export var manifest = {
                             },
                             itemType: {
                                 comment: {
-                                    comment: 'The model for the record being edited',
+                                    markdownText: 'The model for the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1746,7 +1786,7 @@ export var manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1756,7 +1796,7 @@ export var manifest = {
                             },
                             itemStatus: {
                                 comment: {
-                                    comment: 'The current status of the record being edited',
+                                    markdownText: 'The current status of the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1766,7 +1806,7 @@ export var manifest = {
                             },
                             isSubmitting: {
                                 comment: {
-                                    comment: 'Whether the form is currently submitting itself or not',
+                                    markdownText: 'Whether the form is currently submitting itself or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1776,7 +1816,7 @@ export var manifest = {
                             },
                             isFormDirty: {
                                 comment: {
-                                    comment: 'Whether the form has some non-persisted changes or not',
+                                    markdownText: 'Whether the form has some non-persisted changes or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1786,13 +1826,13 @@ export var manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Current number of blocks present in form state',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
                                     lineNumber: 29,
                                 },
-                                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                                type: 'BlocksAnalysis',
                             },
                         },
                     },
@@ -1808,7 +1848,7 @@ export var manifest = {
         itemCollectionOutlets: {
             name: 'itemCollectionOutlets',
             comment: {
-                comment: 'Use this function to declare custom outlets to be shown at the top of a\ncollection of records of a particular model',
+                markdownText: 'Use this function to declare custom outlets to be shown at the top of a\ncollection of records of a particular model.',
                 tag: 'outlets',
             },
             nonCtxArguments: [
@@ -1831,7 +1871,7 @@ export var manifest = {
         initialLocationQueryForItemSelector: {
             name: 'initialLocationQueryForItemSelector',
             comment: {
-                comment: 'Use this function to customize the initial filters when opening a record\nselector via a "Single link" or "Multiple links" field',
+                markdownText: 'Use this function to customize the initial filters when opening a record\nselector via a "Single link" or "Multiple links" field.',
                 tag: 'locationQuery',
             },
             nonCtxArguments: [
@@ -1858,7 +1898,7 @@ export var manifest = {
         fieldDropdownActions: {
             name: 'fieldDropdownActions',
             comment: {
-                comment: 'Use this function to define custom actions (or groups of actions) to be\ndisplayed at the individual field level in the record editing form.\n\nThe `executeFieldDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
+                markdownText: 'Use this function to define custom actions (or groups of actions) to be\ndisplayed at the individual field level in the record editing form.\n\nThe `executeFieldDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -1871,10 +1911,14 @@ export var manifest = {
                 type: 'Ctx',
                 additionalProperties: [
                     {
+                        name: 'ItemFormAdditionalProperties',
+                        comment: {
+                            markdownText: "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+                        },
                         items: {
                             locale: {
                                 comment: {
-                                    comment: 'The currently active locale for the record',
+                                    markdownText: 'The currently active locale for the record.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1884,7 +1928,7 @@ export var manifest = {
                             },
                             item: {
                                 comment: {
-                                    comment: 'If an already persisted record is being edited, returns the full record\nentity',
+                                    markdownText: 'If an already persisted record is being edited, returns the full record\nentity.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1894,7 +1938,7 @@ export var manifest = {
                             },
                             itemType: {
                                 comment: {
-                                    comment: 'The model for the record being edited',
+                                    markdownText: 'The model for the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1904,7 +1948,7 @@ export var manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1914,7 +1958,7 @@ export var manifest = {
                             },
                             itemStatus: {
                                 comment: {
-                                    comment: 'The current status of the record being edited',
+                                    markdownText: 'The current status of the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1924,7 +1968,7 @@ export var manifest = {
                             },
                             isSubmitting: {
                                 comment: {
-                                    comment: 'Whether the form is currently submitting itself or not',
+                                    markdownText: 'Whether the form is currently submitting itself or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1934,7 +1978,7 @@ export var manifest = {
                             },
                             isFormDirty: {
                                 comment: {
-                                    comment: 'Whether the form has some non-persisted changes or not',
+                                    markdownText: 'Whether the form has some non-persisted changes or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -1944,65 +1988,69 @@ export var manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Current number of blocks present in form state',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
                                     lineNumber: 29,
                                 },
-                                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                                type: 'BlocksAnalysis',
                             },
                         },
                     },
                     {
+                        name: 'FieldAdditionalProperties',
+                        comment: {
+                            markdownText: 'These information describe the current state of the field where this plugin\nis applied to.',
+                        },
                         items: {
                             disabled: {
                                 comment: {
-                                    comment: 'Whether the field is currently disabled or not',
+                                    markdownText: 'Whether the field is currently disabled or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 8,
+                                    lineNumber: 12,
                                 },
                                 type: 'boolean',
                             },
                             fieldPath: {
                                 comment: {
-                                    comment: 'The path in the `formValues` object where to find the current value for the\nfield',
+                                    markdownText: 'The path in the `formValues` object where to find the current value for the\nfield.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 13,
+                                    lineNumber: 17,
                                 },
                                 type: 'string',
                             },
                             field: {
                                 comment: {
-                                    comment: 'The field where the field extension is installed to',
+                                    markdownText: 'The field where the field extension is installed to.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 15,
+                                    lineNumber: 19,
                                 },
                                 type: 'Field',
                             },
                             parentField: {
                                 comment: {
-                                    comment: 'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself',
+                                    markdownText: 'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 20,
+                                    lineNumber: 24,
                                 },
                                 type: 'Field | undefined',
                             },
                             block: {
                                 comment: {
-                                    comment: 'If the field extension is installed in a field of a block, returns the ID\nof the block — or `undefined` if the block is still not persisted — and the\nblock model.',
+                                    markdownText: 'If the field extension is installed in a field of a block, returns the ID\nof the block — or `undefined` if the block is still not persisted — and the\nblock model.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 26,
+                                    lineNumber: 30,
                                 },
                                 type: 'undefined | { id: string | undefined; blockModel: ItemType }',
                             },
@@ -2020,7 +2068,7 @@ export var manifest = {
         executeUploadsDropdownAction: {
             name: 'executeUploadsDropdownAction',
             comment: {
-                comment: 'Use this function to execute a particular dropdown action defined via\nthe `uploadsDropdownActions()` hook.',
+                markdownText: 'Use this function to execute a particular dropdown action defined via\nthe `uploadsDropdownActions()` hook.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -2059,7 +2107,7 @@ export var manifest = {
         executeItemsDropdownAction: {
             name: 'executeItemsDropdownAction',
             comment: {
-                comment: 'Use this function to execute a particular dropdown action defined via\nthe `itemsDropdownActions()` hook.',
+                markdownText: 'Use this function to execute a particular dropdown action defined via\nthe `itemsDropdownActions()` hook.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -2098,7 +2146,7 @@ export var manifest = {
         executeItemFormDropdownAction: {
             name: 'executeItemFormDropdownAction',
             comment: {
-                comment: 'Use this function to execute a particular dropdown action defined via\nthe `itemFormDropdownActions()` hook.',
+                markdownText: 'Use this function to execute a particular dropdown action defined via\nthe `itemFormDropdownActions()` hook.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -2111,10 +2159,14 @@ export var manifest = {
                 type: 'Ctx',
                 additionalProperties: [
                     {
+                        name: 'ItemFormAdditionalProperties',
+                        comment: {
+                            markdownText: "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+                        },
                         items: {
                             locale: {
                                 comment: {
-                                    comment: 'The currently active locale for the record',
+                                    markdownText: 'The currently active locale for the record.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2124,7 +2176,7 @@ export var manifest = {
                             },
                             item: {
                                 comment: {
-                                    comment: 'If an already persisted record is being edited, returns the full record\nentity',
+                                    markdownText: 'If an already persisted record is being edited, returns the full record\nentity.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2134,7 +2186,7 @@ export var manifest = {
                             },
                             itemType: {
                                 comment: {
-                                    comment: 'The model for the record being edited',
+                                    markdownText: 'The model for the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2144,7 +2196,7 @@ export var manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2154,7 +2206,7 @@ export var manifest = {
                             },
                             itemStatus: {
                                 comment: {
-                                    comment: 'The current status of the record being edited',
+                                    markdownText: 'The current status of the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2164,7 +2216,7 @@ export var manifest = {
                             },
                             isSubmitting: {
                                 comment: {
-                                    comment: 'Whether the form is currently submitting itself or not',
+                                    markdownText: 'Whether the form is currently submitting itself or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2174,7 +2226,7 @@ export var manifest = {
                             },
                             isFormDirty: {
                                 comment: {
-                                    comment: 'Whether the form has some non-persisted changes or not',
+                                    markdownText: 'Whether the form has some non-persisted changes or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2184,13 +2236,13 @@ export var manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Current number of blocks present in form state',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
                                     lineNumber: 29,
                                 },
-                                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                                type: 'BlocksAnalysis',
                             },
                         },
                     },
@@ -2208,81 +2260,85 @@ export var manifest = {
                 ],
                 additionalMethods: [
                     {
+                        name: 'ItemFormAdditionalMethods',
+                        comment: {
+                            markdownText: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+                        },
                         items: {
                             toggleField: {
                                 comment: {
-                                    comment: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
+                                    markdownText: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 65,
+                                    lineNumber: 68,
                                 },
                                 type: '(path: string, show: boolean) => Promise<void>',
                             },
                             disableField: {
                                 comment: {
-                                    comment: 'Disables/re-enables a specific field in the form',
+                                    markdownText: 'Disables/re-enables a specific field in the form.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 80,
+                                    lineNumber: 83,
                                 },
                                 type: '(path: string, disable: boolean) => Promise<void>',
                             },
                             scrollToField: {
                                 comment: {
-                                    comment: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
+                                    markdownText: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 97,
+                                    lineNumber: 100,
                                 },
                                 type: '(path: string, locale?: string) => Promise<void>',
                             },
                             setFieldValue: {
                                 comment: {
-                                    comment: 'Changes a specific path of the `formValues` object',
+                                    markdownText: 'Changes a specific path of the `formValues` object.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 112,
+                                    lineNumber: 115,
                                 },
                                 type: '(path: string, value: unknown) => Promise<void>',
                             },
                             formValuesToItem: {
                                 comment: {
-                                    comment: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
+                                    markdownText: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                                     example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 129,
+                                    lineNumber: 132,
                                 },
                                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
                             },
                             itemToFormValues: {
                                 comment: {
-                                    comment: 'Takes an Item entity, and converts it into the internal form state',
+                                    markdownText: 'Takes an Item entity, and converts it into the internal form state.',
                                     example: 'await ctx.itemToFormValues(ctx.item);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 142,
+                                    lineNumber: 145,
                                 },
                                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 154,
+                                    lineNumber: 157,
                                 },
                                 type: '(showToast?: boolean) => Promise<void>',
                             },
@@ -2299,7 +2355,7 @@ export var manifest = {
         executeFieldDropdownAction: {
             name: 'executeFieldDropdownAction',
             comment: {
-                comment: 'Use this function to execute a particular dropdown action defined via\nthe `fieldDropdownActions()` hook.',
+                markdownText: 'Use this function to execute a particular dropdown action defined via\nthe `fieldDropdownActions()` hook.',
                 tag: 'dropdownActions',
             },
             nonCtxArguments: [
@@ -2312,10 +2368,14 @@ export var manifest = {
                 type: 'Ctx',
                 additionalProperties: [
                     {
+                        name: 'ItemFormAdditionalProperties',
+                        comment: {
+                            markdownText: "These information describe the current state of the form that's being shown\nto the end-user to edit a record.",
+                        },
                         items: {
                             locale: {
                                 comment: {
-                                    comment: 'The currently active locale for the record',
+                                    markdownText: 'The currently active locale for the record.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2325,7 +2385,7 @@ export var manifest = {
                             },
                             item: {
                                 comment: {
-                                    comment: 'If an already persisted record is being edited, returns the full record\nentity',
+                                    markdownText: 'If an already persisted record is being edited, returns the full record\nentity.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2335,7 +2395,7 @@ export var manifest = {
                             },
                             itemType: {
                                 comment: {
-                                    comment: 'The model for the record being edited',
+                                    markdownText: 'The model for the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2345,7 +2405,7 @@ export var manifest = {
                             },
                             formValues: {
                                 comment: {
-                                    comment: 'The complete internal form state',
+                                    markdownText: 'The complete internal form state.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2355,7 +2415,7 @@ export var manifest = {
                             },
                             itemStatus: {
                                 comment: {
-                                    comment: 'The current status of the record being edited',
+                                    markdownText: 'The current status of the record being edited.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2365,7 +2425,7 @@ export var manifest = {
                             },
                             isSubmitting: {
                                 comment: {
-                                    comment: 'Whether the form is currently submitting itself or not',
+                                    markdownText: 'Whether the form is currently submitting itself or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2375,7 +2435,7 @@ export var manifest = {
                             },
                             isFormDirty: {
                                 comment: {
-                                    comment: 'Whether the form has some non-persisted changes or not',
+                                    markdownText: 'Whether the form has some non-persisted changes or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
@@ -2385,65 +2445,69 @@ export var manifest = {
                             },
                             blocksAnalysis: {
                                 comment: {
-                                    comment: 'Current number of blocks present in form state',
+                                    markdownText: 'Provides information on how many blocks are currently present in the form.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
                                     lineNumber: 29,
                                 },
-                                type: '{\n    usage: {\n      /** Total number of blocks present in form state */\n      total: number;\n      /** Total number of blocks present in non-localized fields */\n      nonLocalized: number;\n      /** Total number of blocks present in localized fields, per locale */\n      perLocale: Record<string, number>;\n    };\n    /** Maximum number of blocks per item */\n    maximumPerItem: number;\n  }',
+                                type: 'BlocksAnalysis',
                             },
                         },
                     },
                     {
+                        name: 'FieldAdditionalProperties',
+                        comment: {
+                            markdownText: 'These information describe the current state of the field where this plugin\nis applied to.',
+                        },
                         items: {
                             disabled: {
                                 comment: {
-                                    comment: 'Whether the field is currently disabled or not',
+                                    markdownText: 'Whether the field is currently disabled or not.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 8,
+                                    lineNumber: 12,
                                 },
                                 type: 'boolean',
                             },
                             fieldPath: {
                                 comment: {
-                                    comment: 'The path in the `formValues` object where to find the current value for the\nfield',
+                                    markdownText: 'The path in the `formValues` object where to find the current value for the\nfield.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 13,
+                                    lineNumber: 17,
                                 },
                                 type: 'string',
                             },
                             field: {
                                 comment: {
-                                    comment: 'The field where the field extension is installed to',
+                                    markdownText: 'The field where the field extension is installed to.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 15,
+                                    lineNumber: 19,
                                 },
                                 type: 'Field',
                             },
                             parentField: {
                                 comment: {
-                                    comment: 'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself',
+                                    markdownText: 'If the field extension is installed in a field of a block, returns the top\nlevel Modular Content/Structured Text field containing the block itself.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 20,
+                                    lineNumber: 24,
                                 },
                                 type: 'Field | undefined',
                             },
                             block: {
                                 comment: {
-                                    comment: 'If the field extension is installed in a field of a block, returns the ID\nof the block — or `undefined` if the block is still not persisted — and the\nblock model.',
+                                    markdownText: 'If the field extension is installed in a field of a block, returns the ID\nof the block — or `undefined` if the block is still not persisted — and the\nblock model.',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/field.ts',
-                                    lineNumber: 26,
+                                    lineNumber: 30,
                                 },
                                 type: 'undefined | { id: string | undefined; blockModel: ItemType }',
                             },
@@ -2463,81 +2527,85 @@ export var manifest = {
                 ],
                 additionalMethods: [
                     {
+                        name: 'ItemFormAdditionalMethods',
+                        comment: {
+                            markdownText: "These methods can be used to interact with the form that's being shown to the\nend-user to edit a record.",
+                        },
                         items: {
                             toggleField: {
                                 comment: {
-                                    comment: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
+                                    markdownText: 'Hides/shows a specific field in the form. Please be aware that when a field\nis hidden, the field editor for that field will be removed from the DOM\nitself, including any associated plugins. When it is shown again, its\nplugins will be reinitialized.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.toggleField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 65,
+                                    lineNumber: 68,
                                 },
                                 type: '(path: string, show: boolean) => Promise<void>',
                             },
                             disableField: {
                                 comment: {
-                                    comment: 'Disables/re-enables a specific field in the form',
+                                    markdownText: 'Disables/re-enables a specific field in the form.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.disableField(fieldPath, true);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 80,
+                                    lineNumber: 83,
                                 },
                                 type: '(path: string, disable: boolean) => Promise<void>',
                             },
                             scrollToField: {
                                 comment: {
-                                    comment: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
+                                    markdownText: 'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 97,
+                                    lineNumber: 100,
                                 },
                                 type: '(path: string, locale?: string) => Promise<void>',
                             },
                             setFieldValue: {
                                 comment: {
-                                    comment: 'Changes a specific path of the `formValues` object',
+                                    markdownText: 'Changes a specific path of the `formValues` object.',
                                     example: "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.setFieldValue(fieldPath, 'new value');",
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 112,
+                                    lineNumber: 115,
                                 },
                                 type: '(path: string, value: unknown) => Promise<void>',
                             },
                             formValuesToItem: {
                                 comment: {
-                                    comment: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
+                                    markdownText: 'Takes the internal form state, and transforms it into an Item entity\ncompatible with DatoCMS API.\n\nWhen `skipUnchangedFields`, only the fields that changed value will be\nserialized.\n\nIf the required nested blocks are still not loaded, this method will return\n`undefined`.',
                                     example: 'await ctx.formValuesToItem(ctx.formValues, false);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 129,
+                                    lineNumber: 132,
                                 },
                                 type: "(\n    formValues: Record<string, unknown>,\n    skipUnchangedFields?: boolean,\n  ) => Promise<Omit<Item, 'id' | 'meta'> | undefined>",
                             },
                             itemToFormValues: {
                                 comment: {
-                                    comment: 'Takes an Item entity, and converts it into the internal form state',
+                                    markdownText: 'Takes an Item entity, and converts it into the internal form state.',
                                     example: 'await ctx.itemToFormValues(ctx.item);',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 142,
+                                    lineNumber: 145,
                                 },
                                 type: "(\n    item: Omit<Item, 'id' | 'meta'>,\n  ) => Promise<Record<string, unknown>>",
                             },
                             saveCurrentItem: {
                                 comment: {
-                                    comment: 'Triggers a submit form for current record',
+                                    markdownText: 'Triggers a submit form for current record.',
                                     example: 'await ctx.saveCurrentItem();',
                                 },
                                 location: {
                                     filePath: 'src/ctx/commonExtras/itemForm.ts',
-                                    lineNumber: 154,
+                                    lineNumber: 157,
                                 },
                                 type: '(showToast?: boolean) => Promise<void>',
                             },
@@ -2554,7 +2622,7 @@ export var manifest = {
         customMarksForStructuredTextField: {
             name: 'customMarksForStructuredTextField',
             comment: {
-                comment: 'Use this function to define a number of custom marks for a specific\nStructured Text field',
+                markdownText: 'Use this function to define a number of custom marks for a specific\nStructured Text field.',
                 tag: 'structuredText',
             },
             nonCtxArguments: [
@@ -2589,7 +2657,7 @@ export var manifest = {
         customBlockStylesForStructuredTextField: {
             name: 'customBlockStylesForStructuredTextField',
             comment: {
-                comment: 'Use this function to define a number of custom block styles for a specific\nStructured Text field',
+                markdownText: 'Use this function to define a number of custom block styles for a specific\nStructured Text field.',
                 tag: 'structuredText',
             },
             nonCtxArguments: [
@@ -2624,7 +2692,7 @@ export var manifest = {
         contentAreaSidebarItems: {
             name: 'contentAreaSidebarItems',
             comment: {
-                comment: 'Use this function to declare new items in the content area sidebar',
+                markdownText: 'Use this function to declare new items in the content area sidebar.',
                 tag: 'sidebarItems',
             },
             nonCtxArguments: [],
@@ -2642,7 +2710,7 @@ export var manifest = {
         buildItemPresentationInfo: {
             name: 'buildItemPresentationInfo',
             comment: {
-                comment: 'Use this function to customize the presentation of a record in records\ncollections and "Single link" or "Multiple links" field',
+                markdownText: 'Use this function to customize the presentation of a record in records\ncollections and "Single link" or "Multiple links" field.',
                 tag: 'presentation',
             },
             nonCtxArguments: [
@@ -2665,7 +2733,7 @@ export var manifest = {
         assetSources: {
             name: 'assetSources',
             comment: {
-                comment: 'Use this function to declare additional sources to be shown when users want\nto upload new assets',
+                markdownText: 'Use this function to declare additional sources to be shown when users want\nto upload new assets.',
                 tag: 'assetSources',
             },
             nonCtxArguments: [],
@@ -2686,12 +2754,12 @@ export var manifest = {
             {
                 name: 'PluginProperties',
                 comment: {
-                    comment: "Information about the current plugin. Useful to access the plugin's global\nconfiguration object.",
+                    markdownText: "Information about the current plugin. Useful to access the plugin's global\nconfiguration object.",
                 },
                 items: {
                     plugin: {
                         comment: {
-                            comment: 'The current plugin',
+                            markdownText: 'The current plugin.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2704,12 +2772,12 @@ export var manifest = {
             {
                 name: 'AuthenticationProperties',
                 comment: {
-                    comment: 'Information about the current user using the CMS',
+                    markdownText: 'Information about the current user using the CMS.',
                 },
                 items: {
                     currentUser: {
                         comment: {
-                            comment: 'The current DatoCMS user. It can either be the owner or one of the\ncollaborators (regular or SSO).',
+                            markdownText: 'The current DatoCMS user. It can either be the owner or one of the\ncollaborators (regular or SSO).',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2719,7 +2787,7 @@ export var manifest = {
                     },
                     currentRole: {
                         comment: {
-                            comment: 'The role for the current DatoCMS user',
+                            markdownText: 'The role for the current DatoCMS user.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2729,7 +2797,7 @@ export var manifest = {
                     },
                     currentUserAccessToken: {
                         comment: {
-                            comment: 'The access token to perform API calls on behalf of the current user. Only\navailable if `currentUserAccessToken` additional permission is granted',
+                            markdownText: 'The access token to perform API calls on behalf of the current user. Only\navailable if `currentUserAccessToken` additional permission is granted.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2744,7 +2812,7 @@ export var manifest = {
                 items: {
                     site: {
                         comment: {
-                            comment: 'The current DatoCMS project',
+                            markdownText: 'The current DatoCMS project.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2754,7 +2822,7 @@ export var manifest = {
                     },
                     environment: {
                         comment: {
-                            comment: 'The ID of the current environment',
+                            markdownText: 'The ID of the current environment.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2764,7 +2832,7 @@ export var manifest = {
                     },
                     owner: {
                         comment: {
-                            comment: 'The account that is the project owner',
+                            markdownText: 'The account/organization that is the project owner.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2774,7 +2842,8 @@ export var manifest = {
                     },
                     account: {
                         comment: {
-                            comment: 'The account that is the project owner',
+                            markdownText: 'The account that is the project owner.',
+                            deprecatedMarkdownText: 'Please use `.owner` instead, as the project owner can also be\nan organization',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2784,7 +2853,7 @@ export var manifest = {
                     },
                     ui: {
                         comment: {
-                            comment: 'UI preferences of the current user (right now, only the preferred locale is\navailable)',
+                            markdownText: 'UI preferences of the current user (right now, only the preferred locale is\navailable).',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2794,7 +2863,7 @@ export var manifest = {
                     },
                     theme: {
                         comment: {
-                            comment: 'An object containing the theme colors for the current DatoCMS project',
+                            markdownText: 'An object containing the theme colors for the current DatoCMS project.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2807,12 +2876,12 @@ export var manifest = {
             {
                 name: 'EntityReposProperties',
                 comment: {
-                    comment: 'These properties provide access to "entity repos", that is, the collection of\nresources of a particular type that have been loaded by the CMS up to this\nmoment. The entity repos are objects, indexed by the ID of the entity itself.',
+                    markdownText: 'These properties provide access to "entity repos", that is, the collection of\nresources of a particular type that have been loaded by the CMS up to this\nmoment. The entity repos are objects, indexed by the ID of the entity itself.',
                 },
                 items: {
                     itemTypes: {
                         comment: {
-                            comment: 'All the models of the current DatoCMS project, indexed by ID',
+                            markdownText: 'All the models of the current DatoCMS project, indexed by ID.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2822,7 +2891,7 @@ export var manifest = {
                     },
                     fields: {
                         comment: {
-                            comment: 'All the fields currently loaded for the current DatoCMS project, indexed by\nID. If some fields you need are not present, use the `loadItemTypeFields`\nfunction to load them.',
+                            markdownText: 'All the fields currently loaded for the current DatoCMS project, indexed by\nID. If some fields you need are not present, use the `loadItemTypeFields`\nfunction to load them.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2832,7 +2901,7 @@ export var manifest = {
                     },
                     fieldsets: {
                         comment: {
-                            comment: 'All the fieldsets currently loaded for the current DatoCMS project, indexed\nby ID. If some fields you need are not present, use the\n`loadItemTypeFieldsets` function to load them.',
+                            markdownText: 'All the fieldsets currently loaded for the current DatoCMS project, indexed\nby ID. If some fields you need are not present, use the\n`loadItemTypeFieldsets` function to load them.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2842,7 +2911,7 @@ export var manifest = {
                     },
                     users: {
                         comment: {
-                            comment: 'All the regular users currently loaded for the current DatoCMS project,\nindexed by ID. It will always contain the current user. If some users you\nneed are not present, use the `loadUsers` function to load them.',
+                            markdownText: 'All the regular users currently loaded for the current DatoCMS project,\nindexed by ID. It will always contain the current user. If some users you\nneed are not present, use the `loadUsers` function to load them.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2852,7 +2921,7 @@ export var manifest = {
                     },
                     ssoUsers: {
                         comment: {
-                            comment: 'All the SSO users currently loaded for the current DatoCMS project, indexed\nby ID. It will always contain the current user. If some users you need are\nnot present, use the `loadSsoUsers` function to load them.',
+                            markdownText: 'All the SSO users currently loaded for the current DatoCMS project, indexed\nby ID. It will always contain the current user. If some users you need are\nnot present, use the `loadSsoUsers` function to load them.',
                         },
                         location: {
                             filePath: 'src/ctx/base.ts',
@@ -2867,12 +2936,12 @@ export var manifest = {
             {
                 name: 'LoadDataMethods',
                 comment: {
-                    comment: 'These methods can be used to asyncronously load additional information your\nplugin needs to work',
+                    markdownText: 'These methods can be used to asyncronously load additional information your\nplugin needs to work.',
                 },
                 items: {
                     loadItemTypeFields: {
                         comment: {
-                            comment: 'Loads all the fields for a specific model (or block). Fields will be\nreturned and will also be available in the the `fields` property.',
+                            markdownText: 'Loads all the fields for a specific model (or block). Fields will be\nreturned and will also be available in the the `fields` property.',
                             example: "const itemTypeId = prompt('Please insert a model ID:');\n\nconst fields = await ctx.loadItemTypeFields(itemTypeId);\n\nctx.notice(\n  `Success! ${fields\n    .map((field) => field.attributes.api_key)\n    .join(', ')}`,\n);",
                         },
                         location: {
@@ -2883,7 +2952,7 @@ export var manifest = {
                     },
                     loadItemTypeFieldsets: {
                         comment: {
-                            comment: 'Loads all the fieldsets for a specific model (or block). Fieldsets will be\nreturned and will also be available in the the `fieldsets` property.',
+                            markdownText: 'Loads all the fieldsets for a specific model (or block). Fieldsets will be\nreturned and will also be available in the the `fieldsets` property.',
                             example: "const itemTypeId = prompt('Please insert a model ID:');\n\nconst fieldsets = await ctx.loadItemTypeFieldsets(itemTypeId);\n\nctx.notice(\n  `Success! ${fieldsets\n    .map((fieldset) => fieldset.attributes.title)\n    .join(', ')}`,\n);",
                         },
                         location: {
@@ -2894,7 +2963,7 @@ export var manifest = {
                     },
                     loadFieldsUsingPlugin: {
                         comment: {
-                            comment: 'Loads all the fields in the project that are currently using the plugin for\none of its manual field extensions.',
+                            markdownText: 'Loads all the fields in the project that are currently using the plugin for\none of its manual field extensions.',
                             example: "const fields = await ctx.loadFieldsUsingPlugin();\n\nctx.notice(\n  `Success! ${fields\n    .map((field) => field.attributes.api_key)\n    .join(', ')}`,\n);",
                         },
                         location: {
@@ -2905,7 +2974,7 @@ export var manifest = {
                     },
                     loadUsers: {
                         comment: {
-                            comment: 'Loads all regular users. Users will be returned and will also be available\nin the the `users` property.',
+                            markdownText: 'Loads all regular users. Users will be returned and will also be available\nin the the `users` property.',
                             example: "const users = await ctx.loadUsers();\n\nctx.notice(`Success! ${users.map((user) => user.id).join(', ')}`);",
                         },
                         location: {
@@ -2916,7 +2985,7 @@ export var manifest = {
                     },
                     loadSsoUsers: {
                         comment: {
-                            comment: 'Loads all SSO users. Users will be returned and will also be available in\nthe the `ssoUsers` property.',
+                            markdownText: 'Loads all SSO users. Users will be returned and will also be available in\nthe the `ssoUsers` property.',
                             example: "const users = await ctx.loadSsoUsers();\n\nctx.notice(`Success! ${users.map((user) => user.id).join(', ')}`);",
                         },
                         location: {
@@ -2930,12 +2999,12 @@ export var manifest = {
             {
                 name: 'UpdatePluginParametersMethods',
                 comment: {
-                    comment: 'These methods can be used to update both plugin parameters and manual field\nextensions configuration.',
+                    markdownText: 'These methods can be used to update both plugin parameters and manual field\nextensions configuration.',
                 },
                 items: {
                     updatePluginParameters: {
                         comment: {
-                            comment: 'Updates the plugin parameters.\n\nAlways check `ctx.currentRole.meta.final_permissions.can_edit_schema`\nbefore calling this, as the user might not have the permission to perform\nthe operation.',
+                            markdownText: 'Updates the plugin parameters.\n\nAlways check `ctx.currentRole.meta.final_permissions.can_edit_schema`\nbefore calling this, as the user might not have the permission to perform\nthe operation.',
                             example: "await ctx.updatePluginParameters({ debugMode: true });\nawait ctx.notice('Plugin parameters successfully updated!');",
                         },
                         location: {
@@ -2946,7 +3015,7 @@ export var manifest = {
                     },
                     updateFieldAppearance: {
                         comment: {
-                            comment: 'Performs changes in the appearance of a field. You can install/remove a\nmanual field extension, or tweak their parameters. If multiple changes are\npassed, they will be applied sequencially.\n\nAlways check `ctx.currentRole.meta.final_permissions.can_edit_schema`\nbefore calling this, as the user might not have the permission to perform\nthe operation.',
+                            markdownText: 'Performs changes in the appearance of a field. You can install/remove a\nmanual field extension, or tweak their parameters. If multiple changes are\npassed, they will be applied sequencially.\n\nAlways check `ctx.currentRole.meta.final_permissions.can_edit_schema`\nbefore calling this, as the user might not have the permission to perform\nthe operation.',
                             example: "const fields = await ctx.loadFieldsUsingPlugin();\n\nif (fields.length === 0) {\n  ctx.alert('No field is using this plugin as a manual extension!');\n  return;\n}\n\nfor (const field of fields) {\n  const { appearance } = field.attributes;\n  const operations = [];\n\n  if (appearance.editor === ctx.plugin.id) {\n    operations.push({\n      operation: 'updateEditor',\n      newParameters: {\n        ...appearance.parameters,\n        foo: 'bar',\n      },\n    });\n  }\n\n  appearance.addons.forEach((addon, i) => {\n    if (addon.id !== ctx.plugin.id) {\n      return;\n    }\n\n    operations.push({\n      operation: 'updateAddon',\n      index: i,\n      newParameters: { ...addon.parameters, foo: 'bar' },\n    });\n  });\n\n  await ctx.updateFieldAppearance(field.id, operations);\n  ctx.notice(`Successfully edited field ${field.attributes.api_key}`);\n}",
                         },
                         location: {
@@ -2960,12 +3029,12 @@ export var manifest = {
             {
                 name: 'ToastMethods',
                 comment: {
-                    comment: 'These methods can be used to show UI-consistent toast notifications to the\nend-user',
+                    markdownText: 'These methods can be used to show UI-consistent toast notifications to the\nend-user.',
                 },
                 items: {
                     alert: {
                         comment: {
-                            comment: 'Triggers an "error" toast displaying the selected message',
+                            markdownText: 'Triggers an "error" toast displaying the selected message.',
                             example: "const message = prompt(\n  'Please insert a message:',\n  'This is an alert message!',\n);\n\nawait ctx.alert(message);",
                         },
                         location: {
@@ -2976,7 +3045,7 @@ export var manifest = {
                     },
                     notice: {
                         comment: {
-                            comment: 'Triggers a "success" toast displaying the selected message',
+                            markdownText: 'Triggers a "success" toast displaying the selected message.',
                             example: "const message = prompt(\n  'Please insert a message:',\n  'This is a notice message!',\n);\n\nawait ctx.notice(message);",
                         },
                         location: {
@@ -2987,7 +3056,7 @@ export var manifest = {
                     },
                     customToast: {
                         comment: {
-                            comment: 'Triggers a custom toast displaying the selected message (and optionally a\nCTA)',
+                            markdownText: 'Triggers a custom toast displaying the selected message (and optionally a\nCTA).',
                             example: "const result = await ctx.customToast({\n  type: 'warning',\n  message: 'Just a sample warning notification!',\n  dismissOnPageChange: true,\n  dismissAfterTimeout: 5000,\n  cta: {\n    label: 'Execute call-to-action',\n    value: 'cta',\n  },\n});\n\nif (result === 'cta') {\n  ctx.notice(`Clicked CTA!`);\n}",
                         },
                         location: {
@@ -3001,12 +3070,12 @@ export var manifest = {
             {
                 name: 'ItemDialogMethods',
                 comment: {
-                    comment: 'These methods let you open the standard DatoCMS dialogs needed to interact\nwith records',
+                    markdownText: 'These methods let you open the standard DatoCMS dialogs needed to interact\nwith records.',
                 },
                 items: {
                     createNewItem: {
                         comment: {
-                            comment: 'Opens a dialog for creating a new record. It returns a promise resolved\nwith the newly created record or `null` if the user closes the dialog\nwithout creating anything.',
+                            markdownText: 'Opens a dialog for creating a new record. It returns a promise resolved\nwith the newly created record or `null` if the user closes the dialog\nwithout creating anything.',
                             example: "const itemTypeId = prompt('Please insert a model ID:');\n\nconst item = await ctx.createNewItem(itemTypeId);\n\nif (item) {\n  ctx.notice(`Success! ${item.id}`);\n} else {\n  ctx.alert('Closed!');\n}",
                         },
                         location: {
@@ -3017,7 +3086,7 @@ export var manifest = {
                     },
                     selectItem: {
                         comment: {
-                            comment: 'Opens a dialog for selecting one (or multiple) record(s) from a list of\nexisting records of type `itemTypeId`. It returns a promise resolved with\nthe selected record(s), or `null` if the user closes the dialog without\nchoosing any record.',
+                            markdownText: 'Opens a dialog for selecting one (or multiple) record(s) from a list of\nexisting records of type `itemTypeId`. It returns a promise resolved with\nthe selected record(s), or `null` if the user closes the dialog without\nchoosing any record.',
                             example: "const itemTypeId = prompt('Please insert a model ID:');\n\nconst items = await ctx.selectItem(itemTypeId, { multiple: true });\n\nif (items) {\n  ctx.notice(`Success! ${items.map((i) => i.id).join(', ')}`);\n} else {\n  ctx.alert('Closed!');\n}",
                         },
                         location: {
@@ -3028,7 +3097,7 @@ export var manifest = {
                     },
                     editItem: {
                         comment: {
-                            comment: 'Opens a dialog for editing an existing record. It returns a promise\nresolved with the edited record, or `null` if the user closes the dialog\nwithout persisting any change.',
+                            markdownText: 'Opens a dialog for editing an existing record. It returns a promise\nresolved with the edited record, or `null` if the user closes the dialog\nwithout persisting any change.',
                             example: "const itemId = prompt('Please insert a record ID:');\n\nconst item = await ctx.editItem(itemId);\n\nif (item) {\n  ctx.notice(`Success! ${item.id}`);\n} else {\n  ctx.alert('Closed!');\n}",
                         },
                         location: {
@@ -3042,12 +3111,12 @@ export var manifest = {
             {
                 name: 'UploadDialogMethods',
                 comment: {
-                    comment: 'These methods let you open the standard DatoCMS dialogs needed to interact\nwith Media Area assets',
+                    markdownText: 'These methods let you open the standard DatoCMS dialogs needed to interact\nwith Media Area assets.',
                 },
                 items: {
                     selectUpload: {
                         comment: {
-                            comment: 'Opens a dialog for selecting one (or multiple) existing asset(s). It\nreturns a promise resolved with the selected asset(s), or `null` if the\nuser closes the dialog without selecting any upload.',
+                            markdownText: 'Opens a dialog for selecting one (or multiple) existing asset(s). It\nreturns a promise resolved with the selected asset(s), or `null` if the\nuser closes the dialog without selecting any upload.',
                             example: "const item = await ctx.selectUpload({ multiple: false });\n\nif (item) {\n  ctx.notice(`Success! ${item.id}`);\n} else {\n  ctx.alert('Closed!');\n}",
                         },
                         location: {
@@ -3058,7 +3127,7 @@ export var manifest = {
                     },
                     editUpload: {
                         comment: {
-                            comment: 'Opens a dialog for editing a Media Area asset. It returns a promise\nresolved with:\n\n- The updated asset, if the user persists some changes to the asset itself\n- `null`, if the user closes the dialog without persisting any change\n- An asset structure with an additional `deleted` property set to true, if\n  the user deletes the asset',
+                            markdownText: 'Opens a dialog for editing a Media Area asset. It returns a promise\nresolved with:\n\n- The updated asset, if the user persists some changes to the asset itself\n- `null`, if the user closes the dialog without persisting any change\n- An asset structure with an additional `deleted` property set to true, if\n  the user deletes the asset.',
                             example: "const uploadId = prompt('Please insert an asset ID:');\n\nconst item = await ctx.editUpload(uploadId);\n\nif (item) {\n  ctx.notice(`Success! ${item.id}`);\n} else {\n  ctx.alert('Closed!');\n}",
                         },
                         location: {
@@ -3069,7 +3138,7 @@ export var manifest = {
                     },
                     editUploadMetadata: {
                         comment: {
-                            comment: 'Opens a dialog for editing a "single asset" field structure. It returns a\npromise resolved with the updated structure, or `null` if the user closes\nthe dialog without persisting any change.',
+                            markdownText: 'Opens a dialog for editing a "single asset" field structure. It returns a\npromise resolved with the updated structure, or `null` if the user closes\nthe dialog without persisting any change.',
                             example: "const uploadId = prompt('Please insert an asset ID:');\n\nconst result = await ctx.editUploadMetadata({\n  upload_id: uploadId,\n  alt: null,\n  title: null,\n  custom_data: {},\n  focal_point: null,\n});\n\nif (result) {\n  ctx.notice(`Success! ${JSON.stringify(result)}`);\n} else {\n  ctx.alert('Closed!');\n}",
                         },
                         location: {
@@ -3083,12 +3152,12 @@ export var manifest = {
             {
                 name: 'CustomDialogMethods',
                 comment: {
-                    comment: 'These methods can be used to open custom dialogs/confirmation panels',
+                    markdownText: 'These methods can be used to open custom dialogs/confirmation panels.',
                 },
                 items: {
                     openModal: {
                         comment: {
-                            comment: 'Opens a custom modal. Returns a promise resolved with what the modal itself\nreturns calling the `resolve()` function',
+                            markdownText: 'Opens a custom modal. Returns a promise resolved with what the modal itself\nreturns calling the `resolve()` function.',
                             example: "const result = await ctx.openModal({\n  id: 'regular',\n  title: 'Custom title!',\n  width: 'l',\n  parameters: { foo: 'bar' },\n});\n\nif (result) {\n  ctx.notice(`Success! ${JSON.stringify(result)}`);\n} else {\n  ctx.alert('Closed!');\n}",
                         },
                         location: {
@@ -3099,7 +3168,7 @@ export var manifest = {
                     },
                     openConfirm: {
                         comment: {
-                            comment: 'Opens a UI-consistent confirmation dialog. Returns a promise resolved with\nthe value of the choice made by the user',
+                            markdownText: 'Opens a UI-consistent confirmation dialog. Returns a promise resolved with\nthe value of the choice made by the user.',
                             example: "const result = await ctx.openConfirm({\n  title: 'Custom title',\n  content:\n    'Lorem Ipsum is simply dummy text of the printing and typesetting industry',\n  choices: [\n    {\n      label: 'Positive',\n      value: 'positive',\n      intent: 'positive',\n    },\n    {\n      label: 'Negative',\n      value: 'negative',\n      intent: 'negative',\n    },\n  ],\n  cancel: {\n    label: 'Cancel',\n    value: false,\n  },\n});\n\nif (result) {\n  ctx.notice(`Success! ${result}`);\n} else {\n  ctx.alert('Cancelled!');\n}",
                         },
                         location: {
@@ -3113,12 +3182,12 @@ export var manifest = {
             {
                 name: 'NavigateMethods',
                 comment: {
-                    comment: 'These methods can be used to take the user to different pages',
+                    markdownText: 'These methods can be used to take the user to different pages.',
                 },
                 items: {
                     navigateTo: {
                         comment: {
-                            comment: 'Moves the user to another URL internal to the backend',
+                            markdownText: 'Moves the user to another URL internal to the backend.',
                             example: "await ctx.navigateTo('/');",
                         },
                         location: {
@@ -3132,34 +3201,38 @@ export var manifest = {
         ],
     },
     selfResizingPluginFrameCtxSizingUtilities: {
+        name: 'SizingUtilities',
+        comment: {
+            markdownText: 'A number of methods that you can use to control the size of the plugin frame.',
+        },
         items: {
             startAutoResizer: {
                 comment: {
-                    comment: "Listens for DOM changes and automatically calls `setHeight` when it detects\na change. If you're using `datocms-react-ui` package, the `<Canvas />`\ncomponent already takes care of calling this method for you.",
+                    markdownText: "Listens for DOM changes and automatically calls `setHeight` when it detects\na change. If you're using `datocms-react-ui` package, the `<Canvas />`\ncomponent already takes care of calling this method for you.",
                 },
                 location: {
                     filePath: 'src/ctx/commonExtras/sizing.ts',
-                    lineNumber: 7,
+                    lineNumber: 8,
                 },
                 type: '() => void',
             },
             stopAutoResizer: {
                 comment: {
-                    comment: 'Stops resizing the iframe automatically',
+                    markdownText: 'Stops resizing the iframe automatically.',
                 },
                 location: {
                     filePath: 'src/ctx/commonExtras/sizing.ts',
-                    lineNumber: 10,
+                    lineNumber: 11,
                 },
                 type: '() => void',
             },
             updateHeight: {
                 comment: {
-                    comment: "Triggers a change in the size of the iframe. If you don't explicitely pass\na `newHeight` it will be automatically calculated using the iframe content\nat the moment",
+                    markdownText: "Triggers a change in the size of the iframe. If you don't explicitely pass\na `newHeight` it will be automatically calculated using the iframe content\nat the moment.",
                 },
                 location: {
                     filePath: 'src/ctx/commonExtras/sizing.ts',
-                    lineNumber: 17,
+                    lineNumber: 18,
                 },
                 type: '(newHeight?: number) => void',
             },