@storybook/html 7.0.0-rc.1 → 7.0.0-rc.10

package/dist/config.d.ts

@@ -1,4 +1,4 @@
 import 'lib/docs-tools/dist';
-export { a as argTypesEnhancers, d as decorators, p as parameters, b as render, r as renderToCanvas } from './types-2ec88714.js';
+export { a as argTypesEnhancers, d as decorators, p as parameters, b as render, r as renderToCanvas } from './types-ccac9448.js';
 import '@storybook/types';
 import 'lib/types/dist';

package/dist/config.js

@@ -1,7 +1,7 @@
-"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var config_exports={};__export(config_exports,{argTypesEnhancers:()=>argTypesEnhancers,decorators:()=>decorators,parameters:()=>parameters2,render:()=>render,renderToCanvas:()=>renderToCanvas});module.exports=__toCommonJS(config_exports);var import_docs_tools2=require("@storybook/docs-tools");var import_docs_tools=require("@storybook/docs-tools"),import_preview_api=require("@storybook/preview-api"),import_ts_dedent=require("ts-dedent");function skipSourceRender(context){var _a;let sourceParams=(_a=context==null?void 0:context.parameters.docs)==null?void 0:_a.source,isArgsStory=context==null?void 0:context.parameters.__isArgsStory;return(sourceParams==null?void 0:sourceParams.type)===import_docs_tools.SourceType.DYNAMIC?!1:!isArgsStory||(sourceParams==null?void 0:sourceParams.code)||(sourceParams==null?void 0:sourceParams.type)===import_docs_tools.SourceType.CODE}function defaultTransformSource(source){return(0,import_ts_dedent.dedent)(source)}function applyTransformSource(source,context){return((context.parameters.docs??{}).transformSource??defaultTransformSource)(source,context)}function sourceDecorator(storyFn,context){var _a,_b;let story=(_b=(_a=context==null?void 0:context.parameters.docs)==null?void 0:_a.source)!=null&&_b.excludeDecorators?context.originalStoryFn(context.args,context):storyFn(),source;return skipSourceRender(context)||(typeof story=="string"?source=story:story instanceof Element&&(source=story.outerHTML),source&&(source=applyTransformSource(source,context))),(0,import_preview_api.useEffect)(()=>{let{id,args}=context;source&&import_preview_api.addons.getChannel().emit(import_docs_tools.SNIPPET_RENDERED,{id,args,source})}),story}var decorators=[sourceDecorator],parameters={docs:{story:{inline:!0},transformSource:void 0,source:{type:import_docs_tools2.SourceType.DYNAMIC,language:"html",code:void 0,excludeDecorators:void 0}}},argTypesEnhancers=[import_docs_tools2.enhanceArgTypes];var import_global=require("@storybook/global"),import_ts_dedent2=require("ts-dedent"),import_preview_api2=require("@storybook/preview-api"),{Node}=import_global.global,render=(args,context)=>{let{id,component:Component}=context;if(typeof Component=="string"){let output=Component;return Object.keys(args).forEach(key=>{output=output.replace(`{{${key}}}`,args[key])}),output}if(Component instanceof HTMLElement){let output=Component.cloneNode(!0);return Object.keys(args).forEach(key=>{output.setAttribute(key,typeof args[key]=="string"?args[key]:JSON.stringify(args[key]))}),output}if(typeof Component=="function")return Component(args,context);throw console.warn(import_ts_dedent2.dedent`
+"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var config_exports={};__export(config_exports,{argTypesEnhancers:()=>argTypesEnhancers,decorators:()=>decorators,parameters:()=>parameters2,render:()=>render,renderToCanvas:()=>renderToCanvas});module.exports=__toCommonJS(config_exports);var import_docs_tools2=require("@storybook/docs-tools");var import_docs_tools=require("@storybook/docs-tools"),import_preview_api=require("@storybook/preview-api");function skipSourceRender(context){var _a;let sourceParams=(_a=context==null?void 0:context.parameters.docs)==null?void 0:_a.source,isArgsStory=context==null?void 0:context.parameters.__isArgsStory;return(sourceParams==null?void 0:sourceParams.type)===import_docs_tools.SourceType.DYNAMIC?!1:!isArgsStory||(sourceParams==null?void 0:sourceParams.code)||(sourceParams==null?void 0:sourceParams.type)===import_docs_tools.SourceType.CODE}function sourceDecorator(storyFn,context){var _a,_b;let story=storyFn(),renderedForSource=(_b=(_a=context==null?void 0:context.parameters.docs)==null?void 0:_a.source)!=null&&_b.excludeDecorators?context.originalStoryFn(context.args,context):story,source;return skipSourceRender(context)||(typeof renderedForSource=="string"?source=renderedForSource:renderedForSource instanceof Element&&(source=renderedForSource.outerHTML)),(0,import_preview_api.useEffect)(()=>{let{id,args}=context;source&&import_preview_api.addons.getChannel().emit(import_docs_tools.SNIPPET_RENDERED,{id,args,source})}),story}var decorators=[sourceDecorator],parameters={docs:{story:{inline:!0},source:{type:import_docs_tools2.SourceType.DYNAMIC,language:"html",code:void 0,excludeDecorators:void 0}}},argTypesEnhancers=[import_docs_tools2.enhanceArgTypes];var import_global=require("@storybook/global"),import_ts_dedent=require("ts-dedent"),import_preview_api2=require("@storybook/preview-api"),{Node}=import_global.global,render=(args,context)=>{let{id,component:Component}=context;if(typeof Component=="string"){let output=Component;return Object.keys(args).forEach(key=>{output=output.replace(`{{${key}}}`,args[key])}),output}if(Component instanceof HTMLElement){let output=Component.cloneNode(!0);return Object.keys(args).forEach(key=>{output.setAttribute(key,typeof args[key]=="string"?args[key]:JSON.stringify(args[key]))}),output}if(typeof Component=="function")return Component(args,context);throw console.warn(import_ts_dedent.dedent`
     Storybook's HTML renderer only supports rendering DOM elements and strings.
     Received: ${Component}
-  `),new Error(`Unable to render story ${id}`)};function renderToCanvas({storyFn,kind,name,showMain,showError,forceRemount},canvasElement){let element=storyFn();if(showMain(),typeof element=="string")canvasElement.innerHTML=element,(0,import_preview_api2.simulatePageLoad)(canvasElement);else if(element instanceof Node){if(canvasElement.firstChild===element&&forceRemount===!1)return;canvasElement.innerHTML="",canvasElement.appendChild(element),(0,import_preview_api2.simulateDOMContentLoaded)()}else showError({title:`Expecting an HTML snippet or DOM node from the story: "${name}" of "${kind}".`,description:import_ts_dedent2.dedent`
+  `),new Error(`Unable to render story ${id}`)};function renderToCanvas({storyFn,kind,name,showMain,showError,forceRemount},canvasElement){let element=storyFn();if(showMain(),typeof element=="string")canvasElement.innerHTML=element,(0,import_preview_api2.simulatePageLoad)(canvasElement);else if(element instanceof Node){if(canvasElement.firstChild===element&&forceRemount===!1)return;canvasElement.innerHTML="",canvasElement.appendChild(element),(0,import_preview_api2.simulateDOMContentLoaded)()}else showError({title:`Expecting an HTML snippet or DOM node from the story: "${name}" of "${kind}".`,description:import_ts_dedent.dedent`
         Did you forget to return the HTML snippet from the story?
         Use "() => <your snippet or node>" or when defining the story.
       `})}var parameters2={renderer:"html",...parameters};0&&(module.exports={argTypesEnhancers,decorators,parameters,render,renderToCanvas});

package/dist/config.mjs

@@ -1 +1 @@
-import{render,renderToCanvas}from"./chunk-JHBKUHDQ.mjs";import{SourceType as SourceType2,enhanceArgTypes}from"@storybook/docs-tools";import{SNIPPET_RENDERED,SourceType}from"@storybook/docs-tools";import{addons,useEffect}from"@storybook/preview-api";import{dedent}from"ts-dedent";function skipSourceRender(context){let sourceParams=context?.parameters.docs?.source,isArgsStory=context?.parameters.__isArgsStory;return sourceParams?.type===SourceType.DYNAMIC?!1:!isArgsStory||sourceParams?.code||sourceParams?.type===SourceType.CODE}function defaultTransformSource(source){return dedent(source)}function applyTransformSource(source,context){return((context.parameters.docs??{}).transformSource??defaultTransformSource)(source,context)}function sourceDecorator(storyFn,context){let story=context?.parameters.docs?.source?.excludeDecorators?context.originalStoryFn(context.args,context):storyFn(),source;return skipSourceRender(context)||(typeof story=="string"?source=story:story instanceof Element&&(source=story.outerHTML),source&&(source=applyTransformSource(source,context))),useEffect(()=>{let{id,args}=context;source&&addons.getChannel().emit(SNIPPET_RENDERED,{id,args,source})}),story}var decorators=[sourceDecorator],parameters={docs:{story:{inline:!0},transformSource:void 0,source:{type:SourceType2.DYNAMIC,language:"html",code:void 0,excludeDecorators:void 0}}},argTypesEnhancers=[enhanceArgTypes];var parameters2={renderer:"html",...parameters};export{argTypesEnhancers,decorators,parameters2 as parameters,render,renderToCanvas};
+import{render,renderToCanvas}from"./chunk-JHBKUHDQ.mjs";import{SourceType as SourceType2,enhanceArgTypes}from"@storybook/docs-tools";import{SNIPPET_RENDERED,SourceType}from"@storybook/docs-tools";import{addons,useEffect}from"@storybook/preview-api";function skipSourceRender(context){let sourceParams=context?.parameters.docs?.source,isArgsStory=context?.parameters.__isArgsStory;return sourceParams?.type===SourceType.DYNAMIC?!1:!isArgsStory||sourceParams?.code||sourceParams?.type===SourceType.CODE}function sourceDecorator(storyFn,context){let story=storyFn(),renderedForSource=context?.parameters.docs?.source?.excludeDecorators?context.originalStoryFn(context.args,context):story,source;return skipSourceRender(context)||(typeof renderedForSource=="string"?source=renderedForSource:renderedForSource instanceof Element&&(source=renderedForSource.outerHTML)),useEffect(()=>{let{id,args}=context;source&&addons.getChannel().emit(SNIPPET_RENDERED,{id,args,source})}),story}var decorators=[sourceDecorator],parameters={docs:{story:{inline:!0},source:{type:SourceType2.DYNAMIC,language:"html",code:void 0,excludeDecorators:void 0}}},argTypesEnhancers=[enhanceArgTypes];var parameters2={renderer:"html",...parameters};export{argTypesEnhancers,decorators,parameters2 as parameters,render,renderToCanvas};

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Addon_ClientStoryApi, Addon_Loadable, Args, ComponentAnnotations, AnnotatedStoryFn, StoryAnnotations, StrictArgs, DecoratorFunction, LoaderFunction, StoryContext as StoryContext$1, ProjectAnnotations } from '@storybook/types';
 export { ArgTypes, Args, Parameters, StrictArgs } from '@storybook/types';
-import { H as HtmlRenderer } from './types-2ec88714.js';
+import { H as HtmlRenderer } from './types-ccac9448.js';
 import 'lib/docs-tools/dist';
 import 'lib/types/dist';
 

package/dist/{types-2ec88714.d.ts → types-ccac9448.d.ts}

@@ -15,7 +15,6 @@ declare const parameters: {
         story: {
             inline: boolean;
         };
-        transformSource: unknown;
         source: {
             type: lib_docs_tools_dist.SourceType;
             language: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storybook/html",
-  "version": "7.0.0-rc.1",
+  "version": "7.0.0-rc.10",
   "description": "Storybook HTML renderer",
   "keywords": [
     "storybook"
@@ -48,11 +48,11 @@
     "prep": "../../../scripts/prepare/bundle.ts"
   },
   "dependencies": {
-    "@storybook/core-client": "7.0.0-rc.1",
-    "@storybook/docs-tools": "7.0.0-rc.1",
+    "@storybook/core-client": "7.0.0-rc.10",
+    "@storybook/docs-tools": "7.0.0-rc.10",
     "@storybook/global": "^5.0.0",
-    "@storybook/preview-api": "7.0.0-rc.1",
-    "@storybook/types": "7.0.0-rc.1",
+    "@storybook/preview-api": "7.0.0-rc.10",
+    "@storybook/types": "7.0.0-rc.10",
     "ts-dedent": "^2.0.0"
   },
   "devDependencies": {
@@ -74,5 +74,5 @@
     ],
     "platform": "browser"
   },
-  "gitHead": "115d69123dc7c4dfab9538d2b273cb0fcc372852"
+  "gitHead": "dd10adf7821c47f0d3a2e6a45d80eea2b906c3a2"
 }

package/template/cli/{ts → ts-3-8}/Header.stories.ts

@@ -25,7 +25,7 @@ type Story = StoryObj<HeaderProps>;
 export const LoggedIn: Story = {
   args: {
     user: {
-      name: 'John Doe',
+      name: 'Jane Doe',
     },
   },
 };

package/template/cli/ts-4-9/Button.stories.ts

@@ -0,0 +1,55 @@
+import type { StoryObj, Meta } from '@storybook/html';
+import type { ButtonProps } from './Button';
+import { createButton } from './Button';
+
+// More on how to set up stories at: https://storybook.js.org/docs/html/writing-stories/introduction#default-export
+const meta = {
+  title: 'Example/Button',
+  tags: ['autodocs'],
+  render: (args) => {
+    // You can either use a function to create DOM elements or use a plain html string!
+    // return `<div>${label}</div>`;
+    return createButton(args);
+  },
+  argTypes: {
+    backgroundColor: { control: 'color' },
+    label: { control: 'text' },
+    onClick: { action: 'onClick' },
+    primary: { control: 'boolean' },
+    size: {
+      control: { type: 'select' },
+      options: ['small', 'medium', 'large'],
+    },
+  },
+} satisfies Meta<ButtonProps>;
+
+export default meta;
+type Story = StoryObj<ButtonProps>;
+
+// More on writing stories with args: https://storybook.js.org/docs/7.0/html/writing-stories/args
+export const Primary: Story = {
+  args: {
+    primary: true,
+    label: 'Button',
+  },
+};
+
+export const Secondary: Story = {
+  args: {
+    label: 'Button',
+  },
+};
+
+export const Large: Story = {
+  args: {
+    size: 'large',
+    label: 'Button',
+  },
+};
+
+export const Small: Story = {
+  args: {
+    size: 'small',
+    label: 'Button',
+  },
+};

package/template/cli/ts-4-9/Button.ts

@@ -0,0 +1,51 @@
+import './button.css';
+
+export interface ButtonProps {
+  /**
+   * Is this the principal call to action on the page?
+   */
+  primary?: boolean;
+  /**
+   * What background color to use
+   */
+  backgroundColor?: string;
+  /**
+   * How large should the button be?
+   */
+  size?: 'small' | 'medium' | 'large';
+  /**
+   * Button contents
+   */
+  label: string;
+  /**
+   * Optional click handler
+   */
+  onClick?: () => void;
+}
+
+/**
+ * Primary UI component for user interaction
+ */
+export const createButton = ({
+  primary = false,
+  size = 'medium',
+  backgroundColor,
+  label,
+  onClick,
+}: ButtonProps) => {
+  const btn = document.createElement('button');
+  btn.type = 'button';
+  btn.innerText = label;
+  if (onClick) {
+    btn.addEventListener('click', onClick);
+  }
+
+  const mode = primary ? 'storybook-button--primary' : 'storybook-button--secondary';
+  btn.className = ['storybook-button', `storybook-button--${size}`, mode].join(' ');
+
+  if (backgroundColor) {
+    btn.style.backgroundColor = backgroundColor;
+  }
+
+  return btn;
+};

package/template/cli/ts-4-9/Header.stories.ts

@@ -0,0 +1,33 @@
+import type { Meta, StoryObj } from '@storybook/html';
+import type { HeaderProps } from './Header';
+import { createHeader } from './Header';
+
+const meta = {
+  title: 'Example/Header',
+  // This component will have an automatically generated Autodocs entry: https://storybook.js.org/docs/7.0/html/writing-docs/docs-page
+  tags: ['autodocs'],
+  render: (args) => createHeader(args),
+  parameters: {
+    // More on how to position stories at: https://storybook.js.org/docs/7.0/html/configure/story-layout
+    layout: 'fullscreen',
+  },
+  // More on argTypes: https://storybook.js.org/docs/7.0/html/api/argtypes
+  argTypes: {
+    onLogin: { action: 'onLogin' },
+    onLogout: { action: 'onLogout' },
+    onCreateAccount: { action: 'onCreateAccount' },
+  },
+} satisfies Meta<HeaderProps>;
+
+export default meta;
+type Story = StoryObj<HeaderProps>;
+
+export const LoggedIn: Story = {
+  args: {
+    user: {
+      name: 'Jane Doe',
+    },
+  },
+};
+
+export const LoggedOut: Story = {};

package/template/cli/ts-4-9/Header.ts

@@ -0,0 +1,54 @@
+import './header.css';
+import { createButton } from './Button';
+
+export interface HeaderProps {
+  user?: { name: string };
+  onLogin: () => void;
+  onLogout: () => void;
+  onCreateAccount: () => void;
+}
+
+export const createHeader = ({ user, onLogout, onLogin, onCreateAccount }: HeaderProps) => {
+  const header = document.createElement('header');
+
+  const wrapper = document.createElement('div');
+  wrapper.className = 'wrapper';
+
+  const logo = `<div>
+    <svg width="32" height="32" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
+      <g fill="none" fillRule="evenodd">
+        <path
+          d="M10 0h12a10 10 0 0110 10v12a10 10 0 01-10 10H10A10 10 0 010 22V10A10 10 0 0110 0z"
+          fill="#FFF" />
+        <path
+          d="M5.3 10.6l10.4 6v11.1l-10.4-6v-11zm11.4-6.2l9.7 5.5-9.7 5.6V4.4z"
+          fill="#555AB9" />
+        <path d="M27.2 10.6v11.2l-10.5 6V16.5l10.5-6zM15.7 4.4v11L6 10l9.7-5.5z" fill="#91BAF8" />
+      </g>
+    </svg>
+    <h1>Acme</h1>
+  </div>`;
+
+  wrapper.insertAdjacentHTML('afterbegin', logo);
+
+  const account = document.createElement('div');
+  if (user) {
+    const welcomeMessage = `<span class="welcome">Welcome, <b>${user.name}</b>!</span>`;
+    account.innerHTML = welcomeMessage;
+    account.appendChild(createButton({ size: 'small', label: 'Log out', onClick: onLogout }));
+  } else {
+    account.appendChild(createButton({ size: 'small', label: 'Log in', onClick: onLogin }));
+    account.appendChild(
+      createButton({
+        size: 'small',
+        label: 'Sign up',
+        onClick: onCreateAccount,
+        primary: true,
+      })
+    );
+  }
+  wrapper.appendChild(account);
+  header.appendChild(wrapper);
+
+  return header;
+};

package/template/cli/ts-4-9/Page.stories.ts

@@ -0,0 +1,27 @@
+import type { Meta, StoryObj } from '@storybook/html';
+import { within, userEvent } from '@storybook/testing-library';
+import { createPage } from './Page';
+
+const meta = {
+  title: 'Example/Page',
+  render: () => createPage(),
+  parameters: {
+    // More on how to position stories at: https://storybook.js.org/docs/7.0/html/configure/story-layout
+    layout: 'fullscreen',
+  },
+} satisfies Meta;
+
+export default meta;
+
+export const LoggedOut: StoryObj = {};
+
+// More on interaction testing: https://storybook.js.org/docs/7.0/html/writing-tests/interaction-testing
+export const LoggedIn: StoryObj = {
+  play: async ({ canvasElement }) => {
+    const canvas = within(canvasElement);
+    const loginButton = await canvas.getByRole('button', {
+      name: /Log in/i,
+    });
+    await userEvent.click(loginButton);
+  },
+};

package/template/cli/ts-4-9/Page.ts

@@ -0,0 +1,98 @@
+import './page.css';
+import { createHeader } from './Header';
+
+type User = {
+  name: string;
+};
+
+export const createPage = () => {
+  const article = document.createElement('article');
+  let user: User | undefined;
+  let header: HTMLElement | null = null;
+
+  const rerenderHeader = () => {
+    const wrapper = document.getElementsByTagName('article')[0];
+    wrapper.replaceChild(createHeaderElement(), wrapper.firstChild as HTMLElement);
+  };
+
+  const onLogin = () => {
+    user = { name: 'Jane Doe' };
+    rerenderHeader();
+  };
+
+  const onLogout = () => {
+    user = undefined;
+    rerenderHeader();
+  };
+
+  const onCreateAccount = () => {
+    user = { name: 'Jane Doe' };
+    rerenderHeader();
+  };
+
+  const createHeaderElement = () => {
+    return createHeader({ onLogin, onLogout, onCreateAccount, user });
+  };
+
+  header = createHeaderElement();
+  article.appendChild(header);
+
+  const section = `
+  <section>
+    <h2>Pages in Storybook</h2>
+    <p>
+      We recommend building UIs with a
+      <a
+        href="https://blog.hichroma.com/component-driven-development-ce1109d56c8e"
+        target="_blank"
+        rel="noopener noreferrer">
+        <strong>component-driven</strong>
+      </a>
+      process starting with atomic components and ending with pages.
+    </p>
+    <p>
+      Render pages with mock data. This makes it easy to build and review page states without
+      needing to navigate to them in your app. Here are some handy patterns for managing page data
+      in Storybook:
+    </p>
+    <ul>
+      <li>
+        Use a higher-level connected component. Storybook helps you compose such data from the
+        "args" of child component stories
+      </li>
+      <li>
+        Assemble data in the page component from your services. You can mock these services out
+        using Storybook.
+      </li>
+    </ul>
+    <p>
+      Get a guided tutorial on component-driven development at
+      <a href="https://storybook.js.org/tutorials/" target="_blank" rel="noopener noreferrer">
+        Storybook tutorials
+      </a>
+      . Read more in the
+      <a href="https://storybook.js.org/docs" target="_blank" rel="noopener noreferrer">docs</a>
+      .
+    </p>
+    <div class="tip-wrapper">
+      <span class="tip">Tip</span>
+      Adjust the width of the canvas with the
+      <svg width="10" height="10" viewBox="0 0 12 12" xmlns="http://www.w3.org/2000/svg">
+        <g fill="none" fillRule="evenodd">
+          <path
+            d="M1.5 5.2h4.8c.3 0 .5.2.5.4v5.1c-.1.2-.3.3-.4.3H1.4a.5.5 0
+            01-.5-.4V5.7c0-.3.2-.5.5-.5zm0-2.1h6.9c.3 0 .5.2.5.4v7a.5.5 0 01-1 0V4H1.5a.5.5 0
+            010-1zm0-2.1h9c.3 0 .5.2.5.4v9.1a.5.5 0 01-1 0V2H1.5a.5.5 0 010-1zm4.3 5.2H2V10h3.8V6.2z"
+            id="a"
+            fill="#999" />
+        </g>
+      </svg>
+      Viewports addon in the toolbar
+    </div>
+  </section>
+`;
+
+  article.insertAdjacentHTML('beforeend', section);
+
+  return article;
+};