@elementor/editor-canvas 4.3.0-1051 → 4.3.0-1052

package/dist/index.d.mts

@@ -239,7 +239,7 @@ type CreateTemplatedElementTypeOptions = {
     renderer: DomRenderer;
     element: TemplatedElementConfig;
 };
-type TemplatedElementConfig = Required<Pick<V1ElementConfig, 'twig_templates' | 'twig_main_template' | 'atomic_props_schema' | 'base_styles_dictionary'>>;
+type TemplatedElementConfig = Required<Pick<V1ElementConfig, 'twig_templates' | 'twig_main_template' | 'atomic_props_schema' | 'base_styles_dictionary'>> & Pick<V1ElementConfig, 'default_html_tag' | 'html_tag_follows_link'>;
 declare function createTemplatedElementView({ type, renderer, element, }: CreateTemplatedElementTypeOptions): typeof TemplatedElementView;
 
 type NestedTemplatedElementConfig = TemplatedElementConfig & {

package/dist/index.d.ts

@@ -239,7 +239,7 @@ type CreateTemplatedElementTypeOptions = {
     renderer: DomRenderer;
     element: TemplatedElementConfig;
 };
-type TemplatedElementConfig = Required<Pick<V1ElementConfig, 'twig_templates' | 'twig_main_template' | 'atomic_props_schema' | 'base_styles_dictionary'>>;
+type TemplatedElementConfig = Required<Pick<V1ElementConfig, 'twig_templates' | 'twig_main_template' | 'atomic_props_schema' | 'base_styles_dictionary'>> & Pick<V1ElementConfig, 'default_html_tag' | 'html_tag_follows_link'>;
 declare function createTemplatedElementView({ type, renderer, element, }: CreateTemplatedElementTypeOptions): typeof TemplatedElementView;
 
 type NestedTemplatedElementConfig = TemplatedElementConfig & {

package/dist/index.js

@@ -2713,6 +2713,52 @@ function createElementViewClassDeclaration() {
 // src/legacy/create-nested-templated-element-type.ts
 var import_editor_elements6 = require("@elementor/editor-elements");
 
+// src/renderers/compute-html-tag.ts
+var DEFAULT_LINK_TAG = "a";
+function computeHtmlTag(settings, defaultTag, options = {}) {
+  const followLink = options.followLink ?? true;
+  if (followLink && settingsHaveActiveLink(settings)) {
+    const link = settings.link;
+    return extractLinkHtmlTag(isRecord(link) ? link : {});
+  }
+  const settingsTag = extractHtmlTagValue(settings.tag);
+  if (null !== settingsTag && "" !== settingsTag) {
+    return settingsTag;
+  }
+  return defaultTag;
+}
+function settingsHaveActiveLink(settings) {
+  const link = settings.link;
+  if (!isRecord(link)) {
+    return false;
+  }
+  const href = extractHtmlTagValue(link.href);
+  if (null !== href && "" !== href) {
+    return true;
+  }
+  const attributes = link.attributes;
+  return typeof attributes === "string" && "" !== attributes;
+}
+function extractLinkHtmlTag(link) {
+  const tag = extractHtmlTagValue(link.tag);
+  if (null !== tag && "" !== tag) {
+    return tag;
+  }
+  return DEFAULT_LINK_TAG;
+}
+function extractHtmlTagValue(value) {
+  if (isRecord(value) && typeof value.value === "string") {
+    return value.value;
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  return null;
+}
+function isRecord(value) {
+  return typeof value === "object" && null !== value && !Array.isArray(value);
+}
+
 // src/legacy/create-pending-element.ts
 var import_editor_elements5 = require("@elementor/editor-elements");
 function createPendingElement(wrapperView, data, options = {}) {
@@ -2773,7 +2819,13 @@ function setupTwigRenderer({ renderer, element }) {
     transformers: settingsTransformersRegistry,
     schema: element.atomic_props_schema
   });
-  return { templateKey, baseStylesDictionary, resolveProps };
+  return {
+    templateKey,
+    baseStylesDictionary,
+    resolveProps,
+    defaultHtmlTag: element.default_html_tag ?? "div",
+    htmlTagFollowsLink: element.html_tag_follows_link ?? true
+  };
 }
 function createBeforeRender(view) {
   view._ensureViewIsIntact();
@@ -2813,7 +2865,7 @@ function createTemplatedElementView({
   element
 }) {
   const BaseView = createElementViewClassDeclaration();
-  const { templateKey, baseStylesDictionary, resolveProps } = setupTwigRenderer({
+  const { templateKey, baseStylesDictionary, resolveProps, defaultHtmlTag, htmlTagFollowsLink } = setupTwigRenderer({
     type,
     renderer,
     element
@@ -2883,6 +2935,7 @@ function createTemplatedElementView({
           interaction_id: this.getInteractionId(),
           type,
           settings,
+          tag: computeHtmlTag(settings, defaultHtmlTag, { followLink: htmlTagFollowsLink }),
           base_styles: baseStylesDictionary,
           ...this.getResolverRenderContext?.() ?? {}
         };
@@ -2972,7 +3025,7 @@ function createNestedTemplatedElementView({
   element
 }) {
   const legacyWindow = window;
-  const { templateKey, baseStylesDictionary, resolveProps } = setupTwigRenderer({
+  const { templateKey, baseStylesDictionary, resolveProps, defaultHtmlTag, htmlTagFollowsLink } = setupTwigRenderer({
     type,
     renderer,
     element
@@ -3047,6 +3100,7 @@ function createNestedTemplatedElementView({
           interaction_id: this.getInteractionId(),
           type,
           settings: resolvedSettings,
+          tag: computeHtmlTag(resolvedSettings, defaultHtmlTag, { followLink: htmlTagFollowsLink }),
           base_styles: baseStylesDictionary,
           editor_attributes: buildEditorAttributes(model),
           editor_classes: buildEditorClasses(model),

package/dist/index.mjs

@@ -2665,6 +2665,52 @@ function createElementViewClassDeclaration() {
 // src/legacy/create-nested-templated-element-type.ts
 import { ELEMENT_STYLE_CHANGE_EVENT as ELEMENT_STYLE_CHANGE_EVENT2 } from "@elementor/editor-elements";
 
+// src/renderers/compute-html-tag.ts
+var DEFAULT_LINK_TAG = "a";
+function computeHtmlTag(settings, defaultTag, options = {}) {
+  const followLink = options.followLink ?? true;
+  if (followLink && settingsHaveActiveLink(settings)) {
+    const link = settings.link;
+    return extractLinkHtmlTag(isRecord(link) ? link : {});
+  }
+  const settingsTag = extractHtmlTagValue(settings.tag);
+  if (null !== settingsTag && "" !== settingsTag) {
+    return settingsTag;
+  }
+  return defaultTag;
+}
+function settingsHaveActiveLink(settings) {
+  const link = settings.link;
+  if (!isRecord(link)) {
+    return false;
+  }
+  const href = extractHtmlTagValue(link.href);
+  if (null !== href && "" !== href) {
+    return true;
+  }
+  const attributes = link.attributes;
+  return typeof attributes === "string" && "" !== attributes;
+}
+function extractLinkHtmlTag(link) {
+  const tag = extractHtmlTagValue(link.tag);
+  if (null !== tag && "" !== tag) {
+    return tag;
+  }
+  return DEFAULT_LINK_TAG;
+}
+function extractHtmlTagValue(value) {
+  if (isRecord(value) && typeof value.value === "string") {
+    return value.value;
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  return null;
+}
+function isRecord(value) {
+  return typeof value === "object" && null !== value && !Array.isArray(value);
+}
+
 // src/legacy/create-pending-element.ts
 import {
   addModelToParent,
@@ -2730,7 +2776,13 @@ function setupTwigRenderer({ renderer, element }) {
     transformers: settingsTransformersRegistry,
     schema: element.atomic_props_schema
   });
-  return { templateKey, baseStylesDictionary, resolveProps };
+  return {
+    templateKey,
+    baseStylesDictionary,
+    resolveProps,
+    defaultHtmlTag: element.default_html_tag ?? "div",
+    htmlTagFollowsLink: element.html_tag_follows_link ?? true
+  };
 }
 function createBeforeRender(view) {
   view._ensureViewIsIntact();
@@ -2770,7 +2822,7 @@ function createTemplatedElementView({
   element
 }) {
   const BaseView = createElementViewClassDeclaration();
-  const { templateKey, baseStylesDictionary, resolveProps } = setupTwigRenderer({
+  const { templateKey, baseStylesDictionary, resolveProps, defaultHtmlTag, htmlTagFollowsLink } = setupTwigRenderer({
     type,
     renderer,
     element
@@ -2840,6 +2892,7 @@ function createTemplatedElementView({
           interaction_id: this.getInteractionId(),
           type,
           settings,
+          tag: computeHtmlTag(settings, defaultHtmlTag, { followLink: htmlTagFollowsLink }),
           base_styles: baseStylesDictionary,
           ...this.getResolverRenderContext?.() ?? {}
         };
@@ -2929,7 +2982,7 @@ function createNestedTemplatedElementView({
   element
 }) {
   const legacyWindow = window;
-  const { templateKey, baseStylesDictionary, resolveProps } = setupTwigRenderer({
+  const { templateKey, baseStylesDictionary, resolveProps, defaultHtmlTag, htmlTagFollowsLink } = setupTwigRenderer({
     type,
     renderer,
     element
@@ -3004,6 +3057,7 @@ function createNestedTemplatedElementView({
           interaction_id: this.getInteractionId(),
           type,
           settings: resolvedSettings,
+          tag: computeHtmlTag(resolvedSettings, defaultHtmlTag, { followLink: htmlTagFollowsLink }),
           base_styles: baseStylesDictionary,
           editor_attributes: buildEditorAttributes(model),
           editor_classes: buildEditorClasses(model),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elementor/editor-canvas",
   "description": "Elementor Editor Canvas",
-  "version": "4.3.0-1051",
+  "version": "4.3.0-1052",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",
@@ -37,26 +37,26 @@
     "react-dom": "^18.3.1"
   },
   "dependencies": {
-    "@elementor/editor": "4.3.0-1051",
-    "@elementor/editor-controls": "4.3.0-1051",
-    "@elementor/editor-documents": "4.3.0-1051",
-    "@elementor/editor-elements": "4.3.0-1051",
-    "@elementor/editor-interactions": "4.3.0-1051",
-    "@elementor/editor-mcp": "4.3.0-1051",
-    "@elementor/editor-notifications": "4.3.0-1051",
-    "@elementor/editor-props": "4.3.0-1051",
-    "@elementor/editor-responsive": "4.3.0-1051",
-    "@elementor/editor-styles": "4.3.0-1051",
-    "@elementor/editor-styles-repository": "4.3.0-1051",
-    "@elementor/editor-ui": "4.3.0-1051",
-    "@elementor/editor-v1-adapters": "4.3.0-1051",
-    "@elementor/events": "4.3.0-1051",
-    "@elementor/http-client": "4.3.0-1051",
-    "@elementor/schema": "4.3.0-1051",
-    "@elementor/twing": "4.3.0-1051",
+    "@elementor/editor": "4.3.0-1052",
+    "@elementor/editor-controls": "4.3.0-1052",
+    "@elementor/editor-documents": "4.3.0-1052",
+    "@elementor/editor-elements": "4.3.0-1052",
+    "@elementor/editor-interactions": "4.3.0-1052",
+    "@elementor/editor-mcp": "4.3.0-1052",
+    "@elementor/editor-notifications": "4.3.0-1052",
+    "@elementor/editor-props": "4.3.0-1052",
+    "@elementor/editor-responsive": "4.3.0-1052",
+    "@elementor/editor-styles": "4.3.0-1052",
+    "@elementor/editor-styles-repository": "4.3.0-1052",
+    "@elementor/editor-ui": "4.3.0-1052",
+    "@elementor/editor-v1-adapters": "4.3.0-1052",
+    "@elementor/events": "4.3.0-1052",
+    "@elementor/http-client": "4.3.0-1052",
+    "@elementor/schema": "4.3.0-1052",
+    "@elementor/twing": "4.3.0-1052",
     "@elementor/ui": "1.37.5",
-    "@elementor/utils": "4.3.0-1051",
-    "@elementor/wp-media": "4.3.0-1051",
+    "@elementor/utils": "4.3.0-1052",
+    "@elementor/wp-media": "4.3.0-1052",
     "@floating-ui/react": "^0.27.5",
     "@wordpress/i18n": "^5.13.0",
     "dompurify": "^3.2.6"

package/src/legacy/__tests__/create-templated-element-type.test.ts

@@ -5,6 +5,7 @@ import {
 	createTemplatedElementType,
 	createTemplatedElementView,
 } from '../create-templated-element-type';
+import { type ElementView } from '../types';
 
 const MOCK_ELEMENT_TYPE = 'test-element';
 const MOCK_HTML = '<div>Element</div>';
@@ -19,6 +20,8 @@ const createMockElementConfig = () => ( {
 	twig_main_template: 'main',
 	atomic_props_schema: {},
 	base_styles_dictionary: {},
+	default_html_tag: 'div',
+	html_tag_follows_link: true,
 } );
 
 describe( 'createTemplatedElementType', () => {
@@ -116,6 +119,53 @@ describe( 'createTemplatedElementView', () => {
 			expect( utils.register ).toHaveBeenCalledWith( 'template2', '<div>Template 2</div>' );
 		} );
 	} );
+
+	describe( 'render context', () => {
+		it( 'should inject computed tag into the twig render context', async () => {
+			// Arrange
+			const utils = createMockRenderer();
+			const ViewClass = createTemplatedElementView( {
+				type: MOCK_ELEMENT_TYPE,
+				renderer: utils,
+				element: {
+					...createMockElementConfig(),
+					twig_templates: {
+						main: '<{{ tag | e("html_tag") }}></{{ tag | e("html_tag") }}>',
+					},
+				},
+			} );
+
+			const view = new ViewClass() as unknown as ElementView & {
+				_abortController: AbortController;
+			};
+			view.model = {
+				get: ( key: string ) => {
+					if ( key === 'id' ) {
+						return 'test-id';
+					}
+
+					if ( key === 'settings' ) {
+						return { toJSON: () => ( {} ) };
+					}
+
+					return undefined;
+				},
+			} as unknown as ElementView[ 'model' ];
+			view.isRendered = false;
+			view._abortController = new AbortController();
+			view.triggerMethod = jest.fn();
+			view.bindUIElements = jest.fn();
+			view.$el = { html: jest.fn() } as unknown as ElementView[ '$el' ];
+			view._ensureViewIsIntact = jest.fn();
+			view.resetChildViewContainer = jest.fn();
+
+			// Act
+			await view._renderTemplate();
+
+			// Assert
+			expect( utils.render ).toHaveBeenCalledWith( 'main', expect.objectContaining( { tag: 'div' } ) );
+		} );
+	} );
 } );
 
 describe( 'canBeTemplated', () => {

package/src/legacy/create-nested-templated-element-type.ts

@@ -1,5 +1,6 @@
 import { ELEMENT_STYLE_CHANGE_EVENT, type V1ElementModelProps } from '@elementor/editor-elements';
 
+import { computeHtmlTag } from '../renderers/compute-html-tag';
 import { type DomRenderer } from '../renderers/create-dom-renderer';
 import { signalizedProcess } from '../utils/signalized-process';
 import { createPendingElement } from './create-pending-element';
@@ -93,7 +94,7 @@ export function createNestedTemplatedElementView( {
 }: CreateNestedTemplatedElementViewOptions ): NestedTemplatedElementViewClass {
 	const legacyWindow = window as unknown as LegacyWindow;
 
-	const { templateKey, baseStylesDictionary, resolveProps } = setupTwigRenderer( {
+	const { templateKey, baseStylesDictionary, resolveProps, defaultHtmlTag, htmlTagFollowsLink } = setupTwigRenderer( {
 		type,
 		renderer,
 		element,
@@ -198,6 +199,7 @@ export function createNestedTemplatedElementView( {
 						interaction_id: this.getInteractionId(),
 						type,
 						settings: resolvedSettings,
+						tag: computeHtmlTag( resolvedSettings, defaultHtmlTag, { followLink: htmlTagFollowsLink } ),
 						base_styles: baseStylesDictionary,
 						editor_attributes: buildEditorAttributes( model ),
 						editor_classes: buildEditorClasses( model ),

package/src/legacy/create-templated-element-type.ts

@@ -1,5 +1,6 @@
 import { type V1ElementConfig } from '@elementor/editor-elements';
 
+import { computeHtmlTag } from '../renderers/compute-html-tag';
 import { type DomRenderer } from '../renderers/create-dom-renderer';
 import { signalizedProcess } from '../utils/signalized-process';
 import { createElementViewClassDeclaration } from './create-element-type';
@@ -27,7 +28,8 @@ export type CreateTemplatedElementTypeOptions = {
 
 export type TemplatedElementConfig = Required<
 	Pick< V1ElementConfig, 'twig_templates' | 'twig_main_template' | 'atomic_props_schema' | 'base_styles_dictionary' >
->;
+> &
+	Pick< V1ElementConfig, 'default_html_tag' | 'html_tag_follows_link' >;
 
 export function createTemplatedElementType( {
 	type,
@@ -69,7 +71,7 @@ export function createTemplatedElementView( {
 }: CreateTemplatedElementTypeOptions ): typeof TemplatedElementView {
 	const BaseView = createElementViewClassDeclaration();
 
-	const { templateKey, baseStylesDictionary, resolveProps } = setupTwigRenderer( {
+	const { templateKey, baseStylesDictionary, resolveProps, defaultHtmlTag, htmlTagFollowsLink } = setupTwigRenderer( {
 		type,
 		renderer,
 		element,
@@ -165,6 +167,7 @@ export function createTemplatedElementView( {
 						interaction_id: this.getInteractionId(),
 						type,
 						settings,
+						tag: computeHtmlTag( settings, defaultHtmlTag, { followLink: htmlTagFollowsLink } ),
 						base_styles: baseStylesDictionary,
 						...( this.getResolverRenderContext?.() ?? {} ),
 					};

package/src/legacy/twig-rendering-utils.ts

@@ -7,7 +7,8 @@ import { type ElementView, type RenderContext } from './types';
 
 export type TwigElementConfig = Required<
 	Pick< V1ElementConfig, 'twig_templates' | 'twig_main_template' | 'atomic_props_schema' | 'base_styles_dictionary' >
->;
+> &
+	Pick< V1ElementConfig, 'default_html_tag' | 'html_tag_follows_link' >;
 
 export type SetupTwigRendererOptions = {
 	type: string;
@@ -19,6 +20,8 @@ export type SetupTwigRendererResult = {
 	templateKey: string;
 	baseStylesDictionary: Record< string, unknown >;
 	resolveProps: PropsResolver;
+	defaultHtmlTag: string;
+	htmlTagFollowsLink: boolean;
 };
 
 export function setupTwigRenderer( { renderer, element }: SetupTwigRendererOptions ): SetupTwigRendererResult {
@@ -34,7 +37,13 @@ export function setupTwigRenderer( { renderer, element }: SetupTwigRendererOptio
 		schema: element.atomic_props_schema,
 	} );
 
-	return { templateKey, baseStylesDictionary, resolveProps };
+	return {
+		templateKey,
+		baseStylesDictionary,
+		resolveProps,
+		defaultHtmlTag: element.default_html_tag ?? 'div',
+		htmlTagFollowsLink: element.html_tag_follows_link ?? true,
+	};
 }
 
 export interface TwigViewInterface extends Omit< ElementView, 'getResolverRenderContext' > {

package/src/renderers/__tests__/compute-html-tag.test.ts

@@ -0,0 +1,55 @@
+import { readFileSync } from 'fs';
+import { join } from 'path';
+
+import { computeHtmlTag } from '../compute-html-tag';
+
+type HtmlTagComputerCase = {
+	settings: Record< string, unknown >;
+	default: string;
+	followLink: boolean;
+	expected: string;
+};
+
+const contractCases: HtmlTagComputerCase[] = JSON.parse(
+	readFileSync( join( __dirname, 'fixtures/html-tag-computer-cases.json' ), 'utf8' )
+);
+
+describe( 'computeHtmlTag', () => {
+	it.each( contractCases )(
+		'contract case: default=$default followLink=$followLink expected=$expected',
+		( { settings, default: defaultTag, followLink, expected } ) => {
+			expect( computeHtmlTag( settings, defaultTag, { followLink } ) ).toBe( expected );
+		}
+	);
+
+	it( 'uses link tag when href is present', () => {
+		expect(
+			computeHtmlTag(
+				{
+					tag: 'div',
+					link: {
+						href: 'https://example.com',
+						tag: 'a',
+					},
+				},
+				'div'
+			)
+		).toBe( 'a' );
+	} );
+
+	it( 'ignores link when followLink is false', () => {
+		expect(
+			computeHtmlTag(
+				{
+					tag: 'h4',
+					link: {
+						href: 'https://example.com',
+						tag: 'a',
+					},
+				},
+				'h2',
+				{ followLink: false }
+			)
+		).toBe( 'h4' );
+	} );
+} );

package/src/renderers/__tests__/fixtures/html-tag-computer-cases.json

@@ -0,0 +1,87 @@
+[
+	{
+		"settings": {},
+		"default": "div",
+		"followLink": true,
+		"expected": "div"
+	},
+	{
+		"settings": { "tag": "header" },
+		"default": "div",
+		"followLink": true,
+		"expected": "header"
+	},
+	{
+		"settings": { "tag": "" },
+		"default": "div",
+		"followLink": true,
+		"expected": "div"
+	},
+	{
+		"settings": {
+			"link": {
+				"href": "https://example.com",
+				"tag": "a"
+			}
+		},
+		"default": "div",
+		"followLink": true,
+		"expected": "a"
+	},
+	{
+		"settings": {
+			"link": {
+				"tag": "a"
+			}
+		},
+		"default": "button",
+		"followLink": true,
+		"expected": "button"
+	},
+	{
+		"settings": {
+			"link": {
+				"tag": "a",
+				"attributes": "href=\"https://example.com\""
+			}
+		},
+		"default": "div",
+		"followLink": true,
+		"expected": "a"
+	},
+	{
+		"settings": {
+			"tag": "div",
+			"link": {
+				"href": "https://example.com",
+				"tag": "a"
+			}
+		},
+		"default": "div",
+		"followLink": true,
+		"expected": "a"
+	},
+	{
+		"settings": {
+			"tag": "div",
+			"link": {
+				"href": "https://example.com",
+				"tag": "a"
+			}
+		},
+		"default": "div",
+		"followLink": false,
+		"expected": "div"
+	},
+	{
+		"settings": {
+			"tag": {
+				"$$type": "string",
+				"value": "h3"
+			}
+		},
+		"default": "h2",
+		"followLink": true,
+		"expected": "h3"
+	}
+]

package/src/renderers/compute-html-tag.ts

@@ -0,0 +1,73 @@
+export type ComputeHtmlTagOptions = {
+	followLink?: boolean;
+};
+
+export const DEFAULT_LINK_TAG = 'a';
+
+type LinkSettings = Record< string, unknown >;
+
+export function computeHtmlTag(
+	settings: Record< string, unknown >,
+	defaultTag: string,
+	options: ComputeHtmlTagOptions = {}
+): string {
+	const followLink = options.followLink ?? true;
+
+	if ( followLink && settingsHaveActiveLink( settings ) ) {
+		const link = settings.link;
+
+		return extractLinkHtmlTag( isRecord( link ) ? link : {} );
+	}
+
+	const settingsTag = extractHtmlTagValue( settings.tag );
+
+	if ( null !== settingsTag && '' !== settingsTag ) {
+		return settingsTag;
+	}
+
+	return defaultTag;
+}
+
+function settingsHaveActiveLink( settings: Record< string, unknown > ): boolean {
+	const link = settings.link;
+
+	if ( ! isRecord( link ) ) {
+		return false;
+	}
+
+	const href = extractHtmlTagValue( link.href );
+
+	if ( null !== href && '' !== href ) {
+		return true;
+	}
+
+	const attributes = link.attributes;
+
+	return typeof attributes === 'string' && '' !== attributes;
+}
+
+function extractLinkHtmlTag( link: LinkSettings ): string {
+	const tag = extractHtmlTagValue( link.tag );
+
+	if ( null !== tag && '' !== tag ) {
+		return tag;
+	}
+
+	return DEFAULT_LINK_TAG;
+}
+
+function extractHtmlTagValue( value: unknown ): string | null {
+	if ( isRecord( value ) && typeof value.value === 'string' ) {
+		return value.value;
+	}
+
+	if ( typeof value === 'string' ) {
+		return value;
+	}
+
+	return null;
+}
+
+function isRecord( value: unknown ): value is Record< string, unknown > {
+	return typeof value === 'object' && null !== value && ! Array.isArray( value );
+}