datocms-plugin-sdk 2.1.0-alpha.1 → 2.1.0

package/dist/esm/connect.js

@@ -58,6 +58,8 @@ import connectToParent from 'penpal/lib/connectToParent';
 import { renderAssetSourceBootstrapper, } from './hooks/renderAssetSource';
 import { renderConfigScreenBootstrapper, } from './hooks/renderConfigScreen';
 import { renderFieldExtensionBootstrapper, } from './hooks/renderFieldExtension';
+import { renderInspectorBootstrapper, } from './hooks/renderInspector';
+import { renderInspectorPanelBootstrapper, } from './hooks/renderInspectorPanel';
 import { renderItemCollectionOutletBootstrapper, } from './hooks/renderItemCollectionOutlet';
 import { renderItemFormOutletBootstrapper, } from './hooks/renderItemFormOutlet';
 import { renderItemFormSidebarBootstrapper, } from './hooks/renderItemFormSidebar';
@@ -139,6 +141,8 @@ export function connect() {
                         renderManualFieldExtensionConfigScreen: renderManualFieldExtensionConfigScreenBootstrapper,
                         renderModal: renderModalBootstrapper,
                         renderPage: renderPageBootstrapper,
+                        renderInspector: renderInspectorBootstrapper,
+                        renderInspectorPanel: renderInspectorPanelBootstrapper,
                         renderUploadSidebar: renderUploadSidebarBootstrapper,
                         renderUploadSidebarPanel: renderUploadSidebarPanelBootstrapper,
                     };

package/dist/esm/connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/connect.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/connect.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,eAAe,MAAM,4BAA4B,CAAC;AA2BzD,OAAO,EAEL,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,gCAAgC,GACjC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,gCAAgC,GACjC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,sCAAsC,GACvC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEL,gCAAgC,GACjC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,iCAAiC,GAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,sCAAsC,GACvC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEL,kDAAkD,GACnD,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAmB,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAkB,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAEL,+BAA+B,GAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,oCAAoC,GACrC,MAAM,kCAAkC,CAAC;AAO1C,OAAO,EAGL,sCAAsC,EACtC,IAAI,GACL,MAAM,SAAS,CAAC;AAkDjB,MAAM,UAAgB,OAAO;wDAC3B,gBAAqD;;QAArD,iCAAA,EAAA,qBAAqD;;;;oBAEjD,gBAAgB,GAAwC,IAAI,CAAC;oBAE7D,gCAAgC,GAQzB,IAAI,CAAC;oBAEV,aAAa,yBACd,gBAAgB,KACnB,uBAAuB,EAAE,sCAAsC,CAC7D,gBAAgB,CAAC,uBAAuB,CACzC,EACD,iCAAiC,EAAE,sCAAsC,CACvE,gBAAgB,CAAC,iCAAiC,CACnD,EACD,uCAAuC,EACrC,sCAAsC,CACpC,gBAAgB,CAAC,uCAAuC,CACzD,GACJ,CAAC;oBAEI,gBAAgB,GAAG,eAAe,CAAC;wBACvC,OAAO,sBACL,UAAU,EAAE,cAAM,OAAA,OAAO,EAAP,CAAO,EACzB,gBAAgB,EAAE;gCAChB,OAAA,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,UAAC,IAAI;oCACrC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gCACtB,CAAC,CAAC,CACH;4BAJD,CAIC,IAMA,MAAM,CAAC,WAAW,CACnB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,MAAM,CAClC,UAAC,EAAK;gCAAJ,GAAG,QAAA;4BAAM,OAAA,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;wBAAzB,CAAyB,CACrC,CACF,KACD,QAAQ,YAAC,WAAoB;gCAC3B,IAAI,gBAAgB,EAAE,CAAC;oCACrB,gBAAgB,CAAC,WAAW,CAAC,CAAC;gCAChC,CAAC;4BACH,CAAC,EACD,wBAAwB,YACtB,UAAkB,EAClB,UAAqB,EACrB,kBAA2C,EAC3C,kBAA4B,EAC5B,YAAoB;gCAEpB,IAAI,CAAC,gCAAgC,EAAE,CAAC;oCACtC,OAAO,IAAI,CAAC;gCACd,CAAC;gCACD,OAAO,gCAAgC,CACrC,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,CACb,CAAC;4BACJ,CAAC,GACF;qBACF,CAAC,CAAC;oBAEa,qBAAM,gBAAgB,CAAC,OAAO,EAAA;;oBAAxC,OAAO,GAAG,SAA8B;oBACpB,qBAAM,OAAO,CAAC,WAAW,EAAE,EAAA;;oBAA/C,iBAAiB,GAAG,SAA2B;oBAErD,IAAI,iBAAiB,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACpC,sBAAoB,iBAAiB,CAAC;wBAE1C,gBAAgB,GAAG,UAAC,aAAa;4BAC/B,mBAAiB,GAAG,aAAa,CAAC;wBACpC,CAAC,CAAC;wBAEF,gCAAgC,GAAG,UACjC,UAAkB,EAClB,UAAqB,EACrB,kBAA2C,EAC3C,kBAA4B,EAC5B,YAAoB;;4BAEpB,IAAI,CAAC,CAAC,UAAU,IAAI,aAAa,CAAC,EAAE,CAAC;gCACnC,OAAO,SAAS,CAAC;4BACnB,CAAC;4BAED,OAAO,CAAA,KAAC,aAAqB,CAAA,CAAC,UAAU,CAAC,2CAAI,UAAU,mDAClD,IAAI,CAAC,OAAO,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,GAC3C,IAAI,CAAC,mBAAiB,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,GAChD,MAAM,CAAC,WAAW,CACnB,kBAAkB,CAAC,GAAG,CAAC,UAAC,UAAU,IAAK,OAAA;oCACrC,UAAU;oCACV,SAAS,2BAA2B;wCAAC,cAAc;6CAAd,UAAc,EAAd,qBAAc,EAAd,IAAc;4CAAd,yBAAc;;wCACjD,OAAQ,OAAe,CAAC,uBAAuB,CAC7C,YAAY,EACZ,UAAU,EACV,IAAI,CACL,CAAC;oCACJ,CAAC;iCACF,EATsC,CAStC,CAAC,CACH,GACE,kBAAkB,YACpB;wBACL,CAAC,CAAC;wBAEF,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;4BACzB,aAAa,CAAC,MAAM,uBACf,OAAO,GACP,mBAAiB,EACpB,CAAC;wBACL,CAAC;oBACH,CAAC;oBAMK,sBAAsB,GAA2B;wBACrD,iBAAiB,EAAE,6BAA6B;wBAChD,kBAAkB,EAAE,8BAA8B;wBAClD,oBAAoB,EAAE,gCAAgC;wBACtD,0BAA0B,EAAE,sCAAsC;wBAClE,oBAAoB,EAAE,gCAAgC;wBACtD,qBAAqB,EAAE,iCAAiC;wBACxD,0BAA0B,EAAE,sCAAsC;wBAClE,sCAAsC,EACpC,kDAAkD;wBACpD,WAAW,EAAE,uBAAuB;wBACpC,UAAU,EAAE,sBAAsB;wBAClC,eAAe,EAAE,2BAA2B;wBAC5C,oBAAoB,EAAE,gCAAgC;wBACtD,mBAAmB,EAAE,+BAA+B;wBACpD,wBAAwB,EAAE,oCAAoC;qBAC/D,CAAC;oBAEF,WAAgE,EAArC,KAAA,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,EAArC,cAAqC,EAArC,IAAqC,EAAE,CAAC;wBAAxD,YAAY;wBACf,MAAM,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;wBAEvE,IAAI,MAAM,EAAE,CAAC;4BACX,gBAAgB,GAAG,MAAM,CAAC;4BAC1B,MAAM;wBACR,CAAC;oBACH,CAAC;;;;;CACF"}

package/dist/esm/guardUtils.d.ts

@@ -1,6 +1,10 @@
+export type Emoji = string & {
+    readonly __brand: 'Emoji';
+};
 export declare function isNullish(value: unknown): value is null | undefined;
 export declare function isBoolean(value: unknown): value is boolean;
 export declare function isString(value: unknown): value is string;
+export declare function isEmoji(value: unknown): value is Emoji;
 export declare function isNumber(value: unknown): value is number;
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
 export declare function isArray<T>(value: unknown, checkItem: (item: unknown) => item is T): value is T[];

package/dist/esm/guardUtils.js

@@ -1,3 +1,4 @@
+import emojiRegex from 'emoji-regex-xs';
 export function isNullish(value) {
     return value === null || value === undefined;
 }
@@ -7,6 +8,13 @@ export function isBoolean(value) {
 export function isString(value) {
     return typeof value === 'string';
 }
+export function isEmoji(value) {
+    if (!isString(value))
+        return false;
+    var regex = emojiRegex();
+    var match = value.match(regex);
+    return match !== null && match.length === 1 && match[0] === value;
+}
 export function isNumber(value) {
     return typeof value === 'number';
 }

package/dist/esm/guardUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"guardUtils.js","sourceRoot":"","sources":["../../src/guardUtils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,KAAc,EACd,SAAuC;IAEvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;QACxB,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACvC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"guardUtils.js","sourceRoot":"","sources":["../../src/guardUtils.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,gBAAgB,CAAC;AAIxC,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnC,IAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEjC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,KAAc,EACd,SAAuC;IAEvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;QACxB,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACvC,CAAC;AACJ,CAAC"}

package/dist/esm/hooks/mainNavigationTabs.d.ts

@@ -25,9 +25,23 @@ export type MainNavigationTab = {
      * whenever possible.
      */
     icon: Icon;
-    /** ID of the page linked to the tab */
+    /** ID of the page/inspector linked to the tab */
     pointsTo: {
         pageId: string;
+    } | {
+        inspectorId: string;
+        /** The preferred width for the sidebar */
+        preferredWidth?: number;
+        /** The inspector panel to render when first loaded */
+        initialInspectorPanel?: {
+            /** ID of the inspector panel to render */
+            panelId: string;
+            /**
+             * An arbitrary configuration object that will be passed as the `parameters`
+             * property of the second argument of the `renderInspectorPanel` function
+             */
+            parameters?: Record<string, unknown>;
+        };
     };
     /**
      * Expresses where you want to place the tab in the top-bar. If not specified,

package/dist/esm/hooks/mainNavigationTabs.js

@@ -5,7 +5,10 @@ export function isMainNavigationTab(value) {
         isString(value.label) &&
         isIcon(value.icon) &&
         isRecord(value.pointsTo) &&
-        isString(value.pointsTo.pageId) &&
+        (isString(value.pointsTo.pageId) ||
+            (isString(value.pointsTo.inspectorId) &&
+                (isNullish(value.pointsTo.preferredWidth) ||
+                    isNumber(value.pointsTo.preferredWidth)))) &&
         (isNullish(value.placement) || isPlacement(value.placement)) &&
         (isNullish(value.rank) || isNumber(value.rank)));
 }

package/dist/esm/hooks/mainNavigationTabs.js.map

@@ -1 +1 @@
-{"version":3,"file":"mainNavigationTabs.js","sourceRoot":"","sources":["../../../src/hooks/mainNavigationTabs.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAQ,MAAM,EAAE,MAAM,SAAS,CAAC;AAmDvC,MAAM,UAAU,mBAAmB,CACjC,KAAc;IAEd,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAClB,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;QACxB,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC/B,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5D,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,KAAc;IAEd,OAAO,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"mainNavigationTabs.js","sourceRoot":"","sources":["../../../src/hooks/mainNavigationTabs.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAQ,MAAM,EAAE,MAAM,SAAS,CAAC;AAmEvC,MAAM,UAAU,mBAAmB,CACjC,KAAc;IAEd,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAClB,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC9B,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACnC,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;oBACvC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5D,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,KAAc;IAEd,OAAO,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;AAC7C,CAAC"}

package/dist/esm/hooks/renderInspector.d.ts

@@ -0,0 +1,147 @@
+import { ImposedSizePluginFrameCtx } from '../ctx/pluginFrame';
+/**
+ * Defines the different modes in which an inspector can be displayed
+ */
+export type InspectorMode = {
+    /** Display a list of records in the inspector */
+    type: 'itemList';
+} | {
+    /** Display a single record editor in the inspector */
+    type: 'itemEditor';
+    /** The ID of the record to edit */
+    itemId: string;
+    /** Optional field path to highlight/focus within the record editor */
+    fieldPath?: string;
+} | {
+    /** Display a custom panel in the inspector */
+    type: 'customPanel';
+    /** ID of the inspector panel to render */
+    panelId: string;
+    /**
+     * An arbitrary configuration object that will be passed as the `parameters`
+     * property of the second argument of the `renderInspectorPanel` function
+     */
+    parameters?: Record<string, unknown>;
+};
+/**
+ * Options for configuring inspector mode changes
+ */
+export type SetInspectorModeOptions = {
+    /**
+     * When true, the mode change will be ignored if there are unsaved changes
+     * in the current inspector. Useful for "low intent" mode changes that
+     * shouldn't interrupt active editing sessions.
+     * @default false
+     */
+    ignoreIfUnsavedChanges?: boolean;
+};
+export type RenderInspectorHook = {
+    /**
+     * This function will be called when the plugin needs to render a specific
+     * inspector. Inspectors provide a side panel interface for displaying and
+     * interacting with content alongside a custom interface.
+     *
+     * @tag inspector
+     *
+     * @example
+     *
+     * ```js
+     * connect({
+     *   renderInspector(inspectorId, ctx) {
+     *     render(
+     *       <div>
+     *         <h1>Inspector: {inspectorId}</h1>
+     *         <button onClick={() => ctx.setInspectorMode({
+     *           type: 'itemEditor',
+     *           itemId: 'some-item-id'
+     *         })}>
+     *           Show Item Editor
+     *         </button>
+     *       </div>
+     *     );
+     *   }
+     * });
+     * ```
+     */
+    renderInspector: (inspectorId: string, ctx: RenderInspectorCtx) => void;
+};
+export type RenderInspectorCtx = ImposedSizePluginFrameCtx<'renderInspector', {
+    /** The ID of the inspector that needs to be rendered */
+    inspectorId: string;
+    /** The ID of the record the currently is highlighted by the user */
+    highlightedItemId: string | undefined;
+    /** Current page location */
+    location: {
+        pathname: string;
+        search: string;
+        hash: string;
+    };
+}, {
+    /**
+     * Changes the current display mode of the inspector. This allows the plugin
+     * to dynamically switch between showing a record list, record editor, or custom
+     * panel within the inspector interface.
+     *
+     * @param mode - The inspector mode to switch to
+     * @param options - Optional configuration for the mode change
+     * @param options.ignoreIfUnsavedChanges - When true, the mode change request will be
+     * ignored if the current inspector is in itemEditor mode and has unsaved changes.
+     * This allows for "low intent" mode changes that shouldn't interrupt active editing.
+     * Default is false, meaning mode changes will proceed regardless of unsaved changes.
+     *
+     * @example
+     *
+     * ```js
+     * // Switch to record editor mode
+     * await ctx.setInspectorMode({
+     *   type: 'itemEditor',
+     *   itemId: 'item-123',
+     *   fieldPath: 'title'
+     * });
+     *
+     * // Switch to record list mode
+     * await ctx.setInspectorMode({ type: 'itemList' });
+     * await ctx.setInspectorItemListData({
+     *   title: 'Related Records',
+     *   itemIds: ['item-1', 'item-2', 'item-3']
+     * });
+     *
+     * // Switch to custom panel mode
+     * await ctx.setInspectorMode({
+     *   type: 'customPanel',
+     *   panelId: 'my-custom-panel',
+     *   parameters: { filter: 'active' }
+     * });
+     *
+     * // Low intent mode change - won't interrupt editing with unsaved changes
+     * await ctx.setInspectorMode(
+     *   { type: 'itemList' },
+     *   { ignoreIfUnsavedChanges: true }
+     * );
+     * ```
+     */
+    setInspectorMode: (mode: InspectorMode, options?: SetInspectorModeOptions) => Promise<void>;
+    /**
+     * Sets the data for the item list inspector mode.
+     *
+     * @example
+     *
+     * ```js
+     * // Set the item list data
+     * await ctx.setInspectorItemListData({
+     *   title: 'Related Records',
+     *   itemIds: ['item-1', 'item-2', 'item-3']
+     * });
+     *
+     * // Switch to item list mode
+     * await ctx.setInspectorMode({ type: 'itemList' });
+     * ```
+     */
+    setInspectorItemListData: (data: {
+        /** The title to show in the inspector header */
+        title: string;
+        /** Array of record IDs to display in the list */
+        itemIds: string[];
+    }) => Promise<void>;
+}>;
+export declare const renderInspectorBootstrapper: import("../utils").Bootstrapper<"renderInspector">;

package/dist/esm/hooks/renderInspector.js

@@ -0,0 +1,8 @@
+import { fullScreenRenderModeBootstrapper } from '../utils';
+export var renderInspectorBootstrapper = fullScreenRenderModeBootstrapper('renderInspector', function (configuration, ctx) {
+    if (!configuration.renderInspector) {
+        return;
+    }
+    configuration.renderInspector(ctx.inspectorId, ctx);
+});
+//# sourceMappingURL=renderInspector.js.map

package/dist/esm/hooks/renderInspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderInspector.js","sourceRoot":"","sources":["../../../src/hooks/renderInspector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gCAAgC,EAAE,MAAM,UAAU,CAAC;AAoK5D,MAAM,CAAC,IAAM,2BAA2B,GACtC,gCAAgC,CAC9B,iBAAiB,EACjB,UAAC,aAAa,EAAE,GAAG;IACjB,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC;QACnC,OAAO;IACT,CAAC;IAED,aAAa,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC,CACF,CAAC"}

package/dist/esm/hooks/renderInspectorPanel.d.ts

@@ -0,0 +1,20 @@
+import { ImposedSizePluginFrameCtx } from '../ctx/pluginFrame';
+export type RenderInspectorPanelHook = {
+    /**
+     * This function will be called when an inspector needs to render a specific
+     * panel (see the `renderInspector` and `setInspectorMode` functions)
+     *
+     * @tag inspector
+     */
+    renderInspectorPanel: (panelId: string, ctx: RenderInspectorPanelCtx) => void;
+};
+export type RenderInspectorPanelCtx = ImposedSizePluginFrameCtx<'renderInspectorPanel', {
+    /** The ID of the inspector panel that needs to be rendered */
+    panelId: string;
+    /**
+     * The arbitrary `parameters` of the modal declared in the `setInspectorMode`
+     * function
+     */
+    parameters: Record<string, unknown>;
+}>;
+export declare const renderInspectorPanelBootstrapper: import("../utils").Bootstrapper<"renderInspectorPanel">;

package/dist/esm/hooks/renderInspectorPanel.js

@@ -0,0 +1,8 @@
+import { fullScreenRenderModeBootstrapper } from '../utils';
+export var renderInspectorPanelBootstrapper = fullScreenRenderModeBootstrapper('renderInspectorPanel', function (configuration, ctx) {
+    if (!configuration.renderInspectorPanel) {
+        return;
+    }
+    configuration.renderInspectorPanel(ctx.panelId, ctx);
+});
+//# sourceMappingURL=renderInspectorPanel.js.map

package/dist/esm/hooks/renderInspectorPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderInspectorPanel.js","sourceRoot":"","sources":["../../../src/hooks/renderInspectorPanel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gCAAgC,EAAE,MAAM,UAAU,CAAC;AA0B5D,MAAM,CAAC,IAAM,gCAAgC,GAC3C,gCAAgC,CAC9B,sBAAsB,EACtB,UAAC,aAAa,EAAE,GAAG;IACjB,IAAI,CAAC,aAAa,CAAC,oBAAoB,EAAE,CAAC;QACxC,OAAO;IACT,CAAC;IAED,aAAa,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACvD,CAAC,CACF,CAAC"}

package/dist/esm/icon.d.ts

@@ -1,4 +1,5 @@
-export type Icon = AwesomeFontIconIdentifier | SvgDefinition;
+export type Icon = AwesomeFontIconIdentifier | SvgDefinition | EmojiDefinition;
+export declare function isIcon(value: unknown): value is Icon;
 /**
  * Defines a custom SVG icon for use in DatoCMS plugins.
  *
@@ -34,7 +35,27 @@ export type SvgDefinition = {
      */
     content: string;
 };
-export declare function isIcon(value: unknown): value is Icon;
+export declare function isSvgDefinition(value: unknown): value is SvgDefinition;
+/**
+ * Defines an emoji icon for use in DatoCMS plugins.
+ *
+ * @example
+ * ```typescript
+ * const starIcon: EmojiDefinition = {
+ *   type: 'emoji',
+ *   emoji: '⭐'
+ * };
+ * ```
+ */
+export type EmojiDefinition = {
+    /** Always set to 'emoji' to indicate this is an emoji icon */
+    type: 'emoji';
+    /**
+     * A string contaning a single emoji.
+     */
+    emoji: string;
+};
+export declare function isEmojiDefinition(value: unknown): value is EmojiDefinition;
 /**
  * Font Awesome icon identifier for use in DatoCMS plugins.
  *

package/dist/esm/icon.js

@@ -1,9 +1,14 @@
-import { isRecord, isString } from './guardUtils.js';
+import { isEmoji, isRecord, isString } from './guardUtils.js';
 export function isIcon(value) {
-    return (isString(value) ||
-        (isRecord(value) &&
-            value.type === 'svg' &&
-            isString(value.viewBox) &&
-            isString(value.content)));
+    return isString(value) || isSvgDefinition(value) || isEmojiDefinition(value);
+}
+export function isSvgDefinition(value) {
+    return (isRecord(value) &&
+        value.type === 'svg' &&
+        isString(value.viewBox) &&
+        isString(value.content));
+}
+export function isEmojiDefinition(value) {
+    return isRecord(value) && value.type === 'emoji' && isEmoji(value.emoji);
 }
 //# sourceMappingURL=icon.js.map

package/dist/esm/icon.js.map

@@ -1 +1 @@
-{"version":3,"file":"icon.js","sourceRoot":"","sources":["../../src/icon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AA0CrD,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,CAAC,QAAQ,CAAC,KAAK,CAAC;YACd,KAAK,CAAC,IAAI,KAAK,KAAK;YACpB,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;YACvB,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAC3B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"icon.js","sourceRoot":"","sources":["../../src/icon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI9D,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AAwCD,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,KAAK,CAAC,IAAI,KAAK,KAAK;QACpB,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CACxB,CAAC;AACJ,CAAC;AAuBD,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC"}

package/dist/esm/index.d.ts

@@ -51,6 +51,8 @@ export * from './hooks/renderItemFormSidebarPanel';
 export * from './hooks/renderManualFieldExtensionConfigScreen';
 export * from './hooks/renderModal';
 export * from './hooks/renderPage';
+export * from './hooks/renderInspector';
+export * from './hooks/renderInspectorPanel';
 export * from './hooks/renderUploadSidebar';
 export * from './hooks/renderUploadSidebarPanel';
 export * from './hooks/schemaItemTypeDropdownActions';

package/dist/esm/index.js

@@ -40,6 +40,8 @@ export * from './hooks/renderItemFormSidebarPanel';
 export * from './hooks/renderManualFieldExtensionConfigScreen';
 export * from './hooks/renderModal';
 export * from './hooks/renderPage';
+export * from './hooks/renderInspector';
+export * from './hooks/renderInspectorPanel';
 export * from './hooks/renderUploadSidebar';
 export * from './hooks/renderUploadSidebarPanel';
 export * from './hooks/schemaItemTypeDropdownActions';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC;AAChE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,sCAAsC,CAAC;AACrD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gDAAgD,CAAC;AAC/D,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC;AAChE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,sCAAsC,CAAC;AACrD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gDAAgD,CAAC;AAC/D,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/esm/manifest.js

@@ -1139,6 +1139,140 @@ export var 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: {