datocms-plugin-sdk 2.1.0-alpha.0 → 2.1.0-alpha.2

package/src/manifest.ts

@@ -101,6 +101,30 @@ export const manifest: Manifest = {
         lineNumber: 19,
       },
     },
+    schemaItemTypeDropdownActions: {
+      name: 'schemaItemTypeDropdownActions',
+      comment: {
+        markdownText:
+          'Use this function to define custom actions (or groups of actions) for a model/block model in the Schema section.\n\nThe `executeSchemaItemTypeDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
+        tag: 'dropdownActions',
+      },
+      nonCtxArguments: [
+        {
+          name: 'itemType',
+          typeName: 'ItemType',
+        },
+      ],
+      ctxArgument: {
+        type: 'Ctx',
+        additionalProperties: [],
+        additionalMethods: [],
+      },
+      returnType: 'Array<DropdownAction | DropdownActionGroup>',
+      location: {
+        filePath: 'src/hooks/schemaItemTypeDropdownActions.ts',
+        lineNumber: 16,
+      },
+    },
     renderUploadSidebarPanel: {
       name: 'renderUploadSidebarPanel',
       comment: {
@@ -251,6 +275,16 @@ export const manifest: Manifest = {
                 },
                 type: 'string',
               },
+              location: {
+                comment: {
+                  markdownText: 'Current page location.',
+                },
+                location: {
+                  filePath: 'src/hooks/renderPage.ts',
+                  lineNumber: 22,
+                },
+                type: '{\n      pathname: string;\n      search: string;\n      hash: string;\n    }',
+              },
             },
           },
         ],
@@ -1197,6 +1231,151 @@ export const manifest: Manifest = {
         lineNumber: 14,
       },
     },
+    renderInspectorPanel: {
+      name: 'renderInspectorPanel',
+      comment: {
+        markdownText:
+          'This function will be called when an inspector needs to render a specific\npanel (see the `renderInspector` and `setInspectorMode` functions).',
+        tag: 'inspector',
+      },
+      nonCtxArguments: [
+        {
+          name: 'panelId',
+          typeName: 'string',
+        },
+      ],
+      ctxArgument: {
+        type: 'ImposedSizePluginFrameCtx',
+        additionalProperties: [
+          {
+            items: {
+              panelId: {
+                comment: {
+                  markdownText:
+                    'The ID of the inspector panel that needs to be rendered.',
+                },
+                location: {
+                  filePath: 'src/hooks/renderInspectorPanel.ts',
+                  lineNumber: 18,
+                },
+                type: 'string',
+              },
+              parameters: {
+                comment: {
+                  markdownText:
+                    'The arbitrary `parameters` of the modal declared in the `setInspectorMode`\nfunction.',
+                },
+                location: {
+                  filePath: 'src/hooks/renderInspectorPanel.ts',
+                  lineNumber: 24,
+                },
+                type: 'Record<string, unknown>',
+              },
+            },
+          },
+        ],
+        additionalMethods: [],
+      },
+      returnType: 'void',
+      location: {
+        filePath: 'src/hooks/renderInspectorPanel.ts',
+        lineNumber: 11,
+      },
+    },
+    renderInspector: {
+      name: 'renderInspector',
+      comment: {
+        markdownText:
+          'This function will be called when the plugin needs to render a specific\ninspector. Inspectors provide a side panel interface for displaying and\ninteracting with content alongside a custom interface.',
+        tag: 'inspector',
+        example:
+          "connect({\n  renderInspector(inspectorId, ctx) {\n    render(\n      <div>\n        <h1>Inspector: {inspectorId}</h1>\n        <button onClick={() => ctx.setInspectorMode({\n          type: 'itemEditor',\n          itemId: 'some-item-id'\n        })}>\n          Show Item Editor\n        </button>\n      </div>\n    );\n  }\n});",
+      },
+      nonCtxArguments: [
+        {
+          name: 'inspectorId',
+          typeName: 'string',
+        },
+      ],
+      ctxArgument: {
+        type: 'ImposedSizePluginFrameCtx',
+        additionalProperties: [
+          {
+            items: {
+              inspectorId: {
+                comment: {
+                  markdownText:
+                    'The ID of the inspector that needs to be rendered.',
+                },
+                location: {
+                  filePath: 'src/hooks/renderInspector.ts',
+                  lineNumber: 80,
+                },
+                type: 'string',
+              },
+              highlightedItemId: {
+                comment: {
+                  markdownText:
+                    'The ID of the record the currently is highlighted by the user.',
+                },
+                location: {
+                  filePath: 'src/hooks/renderInspector.ts',
+                  lineNumber: 83,
+                },
+                type: 'string | undefined',
+              },
+              location: {
+                comment: {
+                  markdownText: 'Current page location.',
+                },
+                location: {
+                  filePath: 'src/hooks/renderInspector.ts',
+                  lineNumber: 86,
+                },
+                type: '{\n      pathname: string;\n      search: string;\n      hash: string;\n    }',
+              },
+            },
+          },
+        ],
+        additionalMethods: [
+          {
+            items: {
+              setInspectorMode: {
+                comment: {
+                  markdownText:
+                    'Changes the current display mode of the inspector. This allows the plugin\nto dynamically switch between showing a record list, record editor, or custom\npanel within the inspector interface.',
+                  example:
+                    "// Switch to record editor mode\nawait ctx.setInspectorMode({\n  type: 'itemEditor',\n  itemId: 'item-123',\n  fieldPath: 'title'\n});\n\n// Switch to record list mode\nawait ctx.setInspectorMode({ type: 'itemList' });\nawait ctx.setInspectorItemListData({\n  title: 'Related Records',\n  itemIds: ['item-1', 'item-2', 'item-3']\n});\n\n// Switch to custom panel mode\nawait ctx.setInspectorMode({\n  type: 'customPanel',\n  panelId: 'my-custom-panel',\n  parameters: { filter: 'active' }\n});\n\n// Low intent mode change - won't interrupt editing with unsaved changes\nawait ctx.setInspectorMode(\n  { type: 'itemList' },\n  { ignoreIfUnsavedChanges: true }\n);",
+                },
+                location: {
+                  filePath: 'src/hooks/renderInspector.ts',
+                  lineNumber: 136,
+                },
+                type: '(\n      mode: InspectorMode,\n      options?: SetInspectorModeOptions,\n    ) => Promise<void>',
+              },
+              setInspectorItemListData: {
+                comment: {
+                  markdownText:
+                    'Sets the data for the item list inspector mode.',
+                  example:
+                    "// Set the item list data\nawait ctx.setInspectorItemListData({\n  title: 'Related Records',\n  itemIds: ['item-1', 'item-2', 'item-3']\n});\n\n// Switch to item list mode\nawait ctx.setInspectorMode({ type: 'itemList' });",
+                },
+                location: {
+                  filePath: 'src/hooks/renderInspector.ts',
+                  lineNumber: 157,
+                },
+                type: '(data: {\n      /** The title to show in the inspector header */\n      title: string;\n      /** Array of record IDs to display in the list */\n      itemIds: string[];\n    }) => Promise<void>',
+              },
+            },
+          },
+        ],
+      },
+      returnType: 'void',
+      location: {
+        filePath: 'src/hooks/renderInspector.ts',
+        lineNumber: 73,
+      },
+    },
     renderFieldExtension: {
       name: 'renderFieldExtension',
       comment: {
@@ -1711,7 +1890,7 @@ export const manifest: Manifest = {
       name: 'onBeforeItemUpsert',
       comment: {
         markdownText:
-          'This function will be called before saving a new version of a record. You\ncan stop the action by returning `false`.',
+          'This hook is called when the user attempts to save a record. You can use it to block record saving.\n\nIf you return `false`, the record will NOT be saved. A small on-page error will say "A plugin blocked the action".\nHowever, for better UX, consider also using `ctx.alert()` to better explain to the user why their save was blocked.\n\nIf you return `true`, the save will proceed as normal.\n\nThis hook runs BEFORE serverside validation. You can use it to do your own additional validation before returning.\nClientside validations are not affected by this hook, since those occur on individual fields\' `onBlur()` events.',
         tag: 'beforeHooks',
       },
       nonCtxArguments: [
@@ -1722,13 +1901,35 @@ export const manifest: Manifest = {
       ],
       ctxArgument: {
         type: 'Ctx',
-        additionalProperties: [],
-        additionalMethods: [],
+        additionalProperties: [
+          {
+            items: {},
+          },
+        ],
+        additionalMethods: [
+          {
+            items: {
+              scrollToField: {
+                comment: {
+                  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/hooks/onBeforeItemUpsert.ts',
+                  lineNumber: 47,
+                },
+                type: '(path: string, locale?: string) => Promise<void>',
+              },
+            },
+          },
+        ],
       },
       returnType: 'MaybePromise<boolean>',
       location: {
         filePath: 'src/hooks/onBeforeItemUpsert.ts',
-        lineNumber: 15,
+        lineNumber: 22,
       },
     },
     manualFieldExtensions: {
@@ -2272,6 +2473,46 @@ export const manifest: Manifest = {
         lineNumber: 13,
       },
     },
+    executeSchemaItemTypeDropdownAction: {
+      name: 'executeSchemaItemTypeDropdownAction',
+      comment: {
+        markdownText:
+          'Use this function to execute a particular dropdown action defined via\nthe `schemaItemTypeDropdownActions()` hook.',
+        tag: 'dropdownActions',
+      },
+      nonCtxArguments: [
+        {
+          name: 'actionId',
+          typeName: 'string',
+        },
+        {
+          name: 'itemType',
+          typeName: 'ItemType',
+        },
+      ],
+      ctxArgument: {
+        type: 'Ctx',
+        additionalProperties: [
+          {
+            items: {
+              parameters: {
+                location: {
+                  filePath: 'src/hooks/executeSchemaItemTypeDropdownAction.ts',
+                  lineNumber: 23,
+                },
+                type: 'Record<string, unknown> | undefined',
+              },
+            },
+          },
+        ],
+        additionalMethods: [],
+      },
+      returnType: 'Promise<void>',
+      location: {
+        filePath: 'src/hooks/executeSchemaItemTypeDropdownAction.ts',
+        lineNumber: 13,
+      },
+    },
     executeItemsDropdownAction: {
       name: 'executeItemsDropdownAction',
       comment: {
@@ -3050,6 +3291,17 @@ export const manifest: Manifest = {
             },
             type: 'string',
           },
+          isEnvironmentPrimary: {
+            comment: {
+              markdownText:
+                'Whether the current environment is the primary one.',
+            },
+            location: {
+              filePath: 'src/ctx/base.ts',
+              lineNumber: 64,
+            },
+            type: 'boolean',
+          },
           owner: {
             comment: {
               markdownText:
@@ -3057,7 +3309,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 64,
+              lineNumber: 67,
             },
             type: 'Account | Organization',
           },
@@ -3069,7 +3321,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 72,
+              lineNumber: 75,
             },
             type: 'Account | undefined',
           },
@@ -3080,7 +3332,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 78,
+              lineNumber: 81,
             },
             type: '{\n    /** Preferred locale */\n    locale: string;\n  }',
           },
@@ -3091,7 +3343,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 84,
+              lineNumber: 87,
             },
             type: 'Theme',
           },
@@ -3111,7 +3363,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 94,
+              lineNumber: 97,
             },
             type: 'Partial<Record<string, ItemType>>',
           },
@@ -3122,7 +3374,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 101,
+              lineNumber: 104,
             },
             type: 'Partial<Record<string, Field>>',
           },
@@ -3133,7 +3385,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 108,
+              lineNumber: 111,
             },
             type: 'Partial<Record<string, Fieldset>>',
           },
@@ -3144,7 +3396,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 115,
+              lineNumber: 118,
             },
             type: 'Partial<Record<string, User>>',
           },
@@ -3155,7 +3407,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 122,
+              lineNumber: 125,
             },
             type: 'Partial<Record<string, SsoUser>>',
           },
@@ -3179,7 +3431,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 165,
+              lineNumber: 168,
             },
             type: '(itemTypeId: string) => Promise<Field[]>',
           },
@@ -3192,7 +3444,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 184,
+              lineNumber: 187,
             },
             type: '(itemTypeId: string) => Promise<Fieldset[]>',
           },
@@ -3205,7 +3457,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 201,
+              lineNumber: 204,
             },
             type: '() => Promise<Field[]>',
           },
@@ -3218,7 +3470,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 214,
+              lineNumber: 217,
             },
             type: '() => Promise<User[]>',
           },
@@ -3231,7 +3483,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 227,
+              lineNumber: 230,
             },
             type: '() => Promise<SsoUser[]>',
           },
@@ -3253,7 +3505,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 249,
+              lineNumber: 252,
             },
             type: '(params: Record<string, unknown>) => Promise<void>',
           },
@@ -3266,7 +3518,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 300,
+              lineNumber: 303,
             },
             type: '(\n    fieldId: string,\n    changes: FieldAppearanceChange[],\n  ) => Promise<void>',
           },
@@ -3288,7 +3540,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 405,
+              lineNumber: 408,
             },
             type: '(message: string) => Promise<void>',
           },
@@ -3301,7 +3553,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 420,
+              lineNumber: 423,
             },
             type: '(message: string) => Promise<void>',
           },
@@ -3314,7 +3566,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 444,
+              lineNumber: 447,
             },
             type: '<CtaValue = unknown>(\n    toast: Toast<CtaValue>,\n  ) => Promise<CtaValue | null>',
           },
@@ -3336,7 +3588,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 330,
+              lineNumber: 333,
             },
             type: '(itemTypeId: string) => Promise<Item | null>',
           },
@@ -3349,7 +3601,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 351,
+              lineNumber: 354,
             },
             type: '{\n    (\n      itemTypeId: string,\n      options: { multiple: true; initialLocationQuery?: ItemListLocationQuery },\n    ): Promise<Item[] | null>;\n    (\n      itemTypeId: string,\n      options?: {\n        multiple: false;\n        initialLocationQuery?: ItemListLocationQuery;\n      },\n    ): Promise<Item | null>;\n  }',
           },
@@ -3362,7 +3614,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 383,
+              lineNumber: 386,
             },
             type: '(itemId: string) => Promise<Item | null>',
           },
@@ -3384,7 +3636,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 471,
+              lineNumber: 474,
             },
             type: '{\n    (options: { multiple: true }): Promise<Upload[] | null>;\n    (options?: { multiple: false }): Promise<Upload | null>;\n  }',
           },
@@ -3397,7 +3649,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 499,
+              lineNumber: 502,
             },
             type: '(\n    uploadId: string,\n  ) => Promise<(Upload & { deleted?: true }) | null>',
           },
@@ -3410,7 +3662,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 527,
+              lineNumber: 530,
             },
             type: '(\n    /** The "single asset" field structure */\n    fileFieldValue: FileFieldValue,\n    /** Shows metadata information for a specific locale */\n    locale?: string,\n  ) => Promise<FileFieldValue | null>',
           },
@@ -3432,7 +3684,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 558,
+              lineNumber: 561,
             },
             type: '(modal: Modal) => Promise<unknown>',
           },
@@ -3445,7 +3697,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 595,
+              lineNumber: 598,
             },
             type: '(options: ConfirmOptions) => Promise<unknown>',
           },
@@ -3466,7 +3718,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 609,
+              lineNumber: 612,
             },
             type: '(path: string) => Promise<void>',
           },