@storybook/html 7.0.0-alpha.5 → 7.0.0-alpha.50

package/dist/chunk-SVMFJQBI.mjs

@@ -0,0 +1,7 @@
+import f from"global";import{dedent as d}from"ts-dedent";import{simulatePageLoad as l,simulateDOMContentLoaded as m}from"@storybook/preview-web";var{Node:u}=f,h=(e,s)=>{let{id:p,component:t}=s;if(typeof t=="string"){let r=t;return Object.keys(e).forEach(o=>{r=r.replace(`{{${o}}}`,e[o])}),r}if(t instanceof HTMLElement){let r=t.cloneNode(!0);return Object.keys(e).forEach(o=>{r.setAttribute(o,typeof e[o]=="string"?e[o]:JSON.stringify(e[o]))}),r}if(typeof t=="function")return t(e,s);throw console.warn(d`
+    Storybook's HTML renderer only supports rendering DOM elements and strings.
+    Received: ${t}
+  `),new Error(`Unable to render story ${p}`)};function M({storyFn:e,kind:s,name:p,showMain:t,showError:r,forceRemount:o},n){let i=e();if(t(),typeof i=="string")n.innerHTML=i,l(n);else if(i instanceof u){if(n.firstChild===i&&o===!1)return;n.innerHTML="",n.appendChild(i),m()}else r({title:`Expecting an HTML snippet or DOM node from the story: "${p}" of "${s}".`,description:d`
+        Did you forget to return the HTML snippet from the story?
+        Use "() => <your snippet or node>" or when defining the story.
+      `})}export{h as a,M as b};

package/dist/config.d.ts

@@ -0,0 +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-becdd26a.js';
+import '@storybook/types';
+import 'lib/types/dist';

package/dist/config.js

@@ -0,0 +1,7 @@
+"use strict";var M=Object.create;var d=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var L=Object.getPrototypeOf,b=Object.prototype.hasOwnProperty;var w=(e,r)=>{for(var t in r)d(e,t,{get:r[t],enumerable:!0})},c=(e,r,t,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of R(r))!b.call(e,n)&&n!==t&&d(e,n,{get:()=>r[n],enumerable:!(o=E(r,n))||o.enumerable});return e};var A=(e,r,t)=>(t=e!=null?M(L(e)):{},c(r||!e||!e.__esModule?d(t,"default",{value:e,enumerable:!0}):t,e)),F=e=>c(d({},"__esModule",{value:!0}),e);var I={};w(I,{argTypesEnhancers:()=>h,decorators:()=>g,parameters:()=>$,render:()=>H,renderToCanvas:()=>D});module.exports=F(I);var a=require("@storybook/docs-tools");var f=require("@storybook/docs-tools"),m=require("@storybook/addons"),l=require("ts-dedent");function N(e){var o;let r=(o=e==null?void 0:e.parameters.docs)==null?void 0:o.source,t=e==null?void 0:e.parameters.__isArgsStory;return(r==null?void 0:r.type)===f.SourceType.DYNAMIC?!1:!t||(r==null?void 0:r.code)||(r==null?void 0:r.type)===f.SourceType.CODE}function O(e){return(0,l.dedent)(e)}function k(e,r){return((r.parameters.docs??{}).transformSource??O)(e,r)}function S(e,r){var n,s;let t=(s=(n=r==null?void 0:r.parameters.docs)==null?void 0:n.source)!=null&&s.excludeDecorators?r.originalStoryFn(r.args,r):e(),o;return N(r)||(typeof t=="string"?o=t:t instanceof Element&&(o=t.outerHTML),o&&(o=k(o,r))),(0,m.useEffect)(()=>{o&&m.addons.getChannel().emit(f.SNIPPET_RENDERED,r.id,o)}),t}var g=[S],T={docs:{inlineStories:!0,transformSource:void 0,source:{type:a.SourceType.DYNAMIC,language:"html",code:void 0,excludeDecorators:void 0}}},h=[a.enhanceArgTypes];var C=A(require("global")),y=require("ts-dedent"),u=require("@storybook/preview-web"),{Node:_}=C.default,H=(e,r)=>{let{id:t,component:o}=r;if(typeof o=="string"){let n=o;return Object.keys(e).forEach(s=>{n=n.replace(`{{${s}}}`,e[s])}),n}if(o instanceof HTMLElement){let n=o.cloneNode(!0);return Object.keys(e).forEach(s=>{n.setAttribute(s,typeof e[s]=="string"?e[s]:JSON.stringify(e[s]))}),n}if(typeof o=="function")return o(e,r);throw console.warn(y.dedent`
+    Storybook's HTML renderer only supports rendering DOM elements and strings.
+    Received: ${o}
+  `),new Error(`Unable to render story ${t}`)};function D({storyFn:e,kind:r,name:t,showMain:o,showError:n,forceRemount:s},i){let p=e();if(o(),typeof p=="string")i.innerHTML=p,(0,u.simulatePageLoad)(i);else if(p instanceof _){if(i.firstChild===p&&s===!1)return;i.innerHTML="",i.appendChild(p),(0,u.simulateDOMContentLoaded)()}else n({title:`Expecting an HTML snippet or DOM node from the story: "${t}" of "${r}".`,description:y.dedent`
+        Did you forget to return the HTML snippet from the story?
+        Use "() => <your snippet or node>" or when defining the story.
+      `})}var $={framework:"html",...T};0&&(module.exports={argTypesEnhancers,decorators,parameters,render,renderToCanvas});

package/dist/config.mjs

@@ -0,0 +1 @@
+import{a as c,b as i}from"./chunk-SVMFJQBI.mjs";import{SourceType as l,enhanceArgTypes as g}from"@storybook/docs-tools";import{SNIPPET_RENDERED as m,SourceType as s}from"@storybook/docs-tools";import{addons as p,useEffect as u}from"@storybook/addons";import{dedent as f}from"ts-dedent";function d(e){let r=e?.parameters.docs?.source,o=e?.parameters.__isArgsStory;return r?.type===s.DYNAMIC?!1:!o||r?.code||r?.type===s.CODE}function y(e){return f(e)}function S(e,r){return((r.parameters.docs??{}).transformSource??y)(e,r)}function n(e,r){let o=r?.parameters.docs?.source?.excludeDecorators?r.originalStoryFn(r.args,r):e(),t;return d(r)||(typeof o=="string"?t=o:o instanceof Element&&(t=o.outerHTML),t&&(t=S(t,r))),u(()=>{t&&p.getChannel().emit(m,r.id,t)}),o}var T=[n],a={docs:{inlineStories:!0,transformSource:void 0,source:{type:l.DYNAMIC,language:"html",code:void 0,excludeDecorators:void 0}}},C=[g];var R={framework:"html",...a};export{C as argTypesEnhancers,T as decorators,R as parameters,c as render,i as renderToCanvas};

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+import { Addon_ClientStoryApi, Addon_Loadable, Args, ComponentAnnotations, AnnotatedStoryFn, StoryAnnotations, StrictArgs, DecoratorFunction, LoaderFunction, StoryContext as StoryContext$1 } from '@storybook/types';
+export { ArgTypes, Args, Parameters, StrictArgs } from '@storybook/types';
+import { H as HtmlRenderer } from './types-becdd26a.js';
+export { H as HtmlRenderer } from './types-becdd26a.js';
+import 'lib/docs-tools/dist';
+import 'lib/types/dist';
+
+interface ClientApi extends Addon_ClientStoryApi<HtmlRenderer['storyResult']> {
+    configure(loader: Addon_Loadable, module: NodeModule): void;
+    forceReRender(): void;
+    raw: () => any;
+}
+declare const storiesOf: ClientApi['storiesOf'];
+declare const configure: ClientApi['configure'];
+declare const forceReRender: ClientApi['forceReRender'];
+declare const raw: ClientApi['raw'];
+
+/**
+ * Metadata to configure the stories for a component.
+ *
+ * @see [Default export](https://storybook.js.org/docs/formats/component-story-format/#default-export)
+ */
+declare type Meta<TArgs = Args> = ComponentAnnotations<HtmlRenderer, TArgs>;
+/**
+ * Story function that represents a CSFv2 component example.
+ *
+ * @see [Named Story exports](https://storybook.js.org/docs/formats/component-story-format/#named-story-exports)
+ */
+declare type StoryFn<TArgs = Args> = AnnotatedStoryFn<HtmlRenderer, TArgs>;
+/**
+ * Story function that represents a CSFv3 component example.
+ *
+ * @see [Named Story exports](https://storybook.js.org/docs/formats/component-story-format/#named-story-exports)
+ */
+declare type StoryObj<TArgs = Args> = StoryAnnotations<HtmlRenderer, TArgs>;
+/**
+ * @deprecated Use `StoryFn` instead.
+ * Use `StoryObj` if you want to migrate to CSF3, which uses objects instead of functions to represent stories.
+ * You can read more about the CSF3 format here: https://storybook.js.org/blog/component-story-format-3-0/
+ *
+ * Story function that represents a CSFv2 component example.
+ *
+ * @see [Named Story exports](https://storybook.js.org/docs/formats/component-story-format/#named-story-exports)
+ */
+declare type Story<TArgs = Args> = StoryFn<TArgs>;
+declare type Decorator<TArgs = StrictArgs> = DecoratorFunction<HtmlRenderer, TArgs>;
+declare type Loader<TArgs = StrictArgs> = LoaderFunction<HtmlRenderer, TArgs>;
+declare type StoryContext<TArgs = StrictArgs> = StoryContext$1<HtmlRenderer, TArgs>;
+
+export { Decorator, Loader, Meta, Story, StoryContext, StoryFn, StoryObj, configure, forceReRender, raw, storiesOf };

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";var g=Object.create;var s=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var h=Object.getPrototypeOf,w=Object.prototype.hasOwnProperty;var L=(e,t)=>{for(var r in t)s(e,r,{get:t[r],enumerable:!0})},c=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of b(t))!w.call(e,o)&&o!==r&&s(e,o,{get:()=>t[o],enumerable:!(n=M(t,o))||n.enumerable});return e};var a=(e,t,r)=>(r=e!=null?g(h(e)):{},c(t||!e||!e.__esModule?s(r,"default",{value:e,enumerable:!0}):r,e)),T=e=>c(s({},"__esModule",{value:!0}),e);var D={};L(D,{configure:()=>E,forceReRender:()=>N,raw:()=>$,storiesOf:()=>_});module.exports=T(D);var u=a(require("global")),{window:x}=u.default;x.STORYBOOK_ENV="HTML";var C=require("@storybook/core-client");var y=a(require("global")),m=require("ts-dedent"),f=require("@storybook/preview-web"),{Node:S}=y.default,R=(e,t)=>{let{id:r,component:n}=t;if(typeof n=="string"){let o=n;return Object.keys(e).forEach(i=>{o=o.replace(`{{${i}}}`,e[i])}),o}if(n instanceof HTMLElement){let o=n.cloneNode(!0);return Object.keys(e).forEach(i=>{o.setAttribute(i,typeof e[i]=="string"?e[i]:JSON.stringify(e[i]))}),o}if(typeof n=="function")return n(e,t);throw console.warn(m.dedent`
+    Storybook's HTML renderer only supports rendering DOM elements and strings.
+    Received: ${n}
+  `),new Error(`Unable to render story ${r}`)};function A({storyFn:e,kind:t,name:r,showMain:n,showError:o,forceRemount:i},d){let p=e();if(n(),typeof p=="string")d.innerHTML=p,(0,f.simulatePageLoad)(d);else if(p instanceof S){if(d.firstChild===p&&i===!1)return;d.innerHTML="",d.appendChild(p),(0,f.simulateDOMContentLoaded)()}else o({title:`Expecting an HTML snippet or DOM node from the story: "${r}" of "${t}".`,description:m.dedent`
+        Did you forget to return the HTML snippet from the story?
+        Use "() => <your snippet or node>" or when defining the story.
+      `})}var H="html",l=(0,C.start)(A,{render:R}),_=(e,t)=>l.clientApi.storiesOf(e,t).addParameters({framework:H}),E=(...e)=>l.configure(H,...e),N=l.forceReRender,$=l.clientApi.raw;var O;(O=module==null?void 0:module.hot)==null||O.decline();0&&(module.exports={configure,forceReRender,raw,storiesOf});

package/dist/index.mjs

@@ -0,0 +1 @@
+import{a as r,b as t}from"./chunk-SVMFJQBI.mjs";import d from"global";var{window:p}=d;p.STORYBOOK_ENV="HTML";import{start as l}from"@storybook/core-client";var n="html",e=l(t,{render:r}),m=(o,i)=>e.clientApi.storiesOf(o,i).addParameters({framework:n}),c=(...o)=>e.configure(n,...o),R=e.forceReRender,A=e.clientApi.raw;module?.hot?.decline();export{c as configure,R as forceReRender,A as raw,m as storiesOf};

package/dist/types-becdd26a.d.ts

@@ -0,0 +1,36 @@
+import { PartialStoryFn, ArgsStoryFn, Store_RenderContext, WebRenderer, StoryContext as StoryContext$1 } from '@storybook/types';
+import * as lib_docs_tools_dist from 'lib/docs-tools/dist';
+import * as lib_types_dist from 'lib/types/dist';
+
+declare function sourceDecorator(storyFn: PartialStoryFn<HtmlRenderer>, context: StoryContext): StoryFnHtmlReturnType;
+
+declare const decorators: (typeof sourceDecorator)[];
+declare const argTypesEnhancers: (<TRenderer extends lib_types_dist.Renderer>(context: lib_types_dist.StoryContextForEnhancers<TRenderer, lib_types_dist.Args>) => lib_types_dist.StrictArgTypes<lib_types_dist.Args>)[];
+
+declare const render: ArgsStoryFn<HtmlRenderer>;
+declare function renderToCanvas({ storyFn, kind, name, showMain, showError, forceRemount }: Store_RenderContext<HtmlRenderer>, canvasElement: HtmlRenderer['canvasElement']): void;
+
+declare const parameters: {
+    docs: {
+        inlineStories: boolean;
+        transformSource: unknown;
+        source: {
+            type: lib_docs_tools_dist.SourceType;
+            language: string;
+            code: unknown;
+            excludeDecorators: unknown;
+        };
+    };
+    framework: "html";
+};
+
+declare type StoryFnHtmlReturnType = string | Node;
+interface HtmlRenderer extends WebRenderer {
+    component: string | HTMLElement | ArgsStoryFn<HtmlRenderer>;
+    storyResult: StoryFnHtmlReturnType;
+}
+declare type StoryContext = StoryContext$1<HtmlRenderer> & {
+    parameters: StoryContext$1<HtmlRenderer>['parameters'] & typeof parameters;
+};
+
+export { HtmlRenderer as H, argTypesEnhancers as a, render as b, decorators as d, parameters as p, renderToCanvas as r };

package/jest.config.js

@@ -0,0 +1,7 @@
+const path = require('path');
+const baseConfig = require('../../jest.config.browser');
+
+module.exports = {
+  ...baseConfig,
+  displayName: __dirname.split(path.sep).slice(-2).join(path.posix.sep),
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storybook/html",
-  "version": "7.0.0-alpha.5",
+  "version": "7.0.0-alpha.50",
   "description": "Storybook HTML renderer",
   "keywords": [
     "storybook"
@@ -19,31 +19,52 @@
     "url": "https://opencollective.com/storybook"
   },
   "license": "MIT",
-  "main": "dist/cjs/index.js",
-  "module": "dist/esm/index.js",
-  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./preview": {
+      "require": "./dist/config.js",
+      "import": "./dist/config.mjs",
+      "types": "./dist/config.d.ts"
+    },
+    "./package.json": {
+      "require": "./package.json",
+      "import": "./package.json",
+      "types": "./package.json"
+    }
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
   "files": [
     "dist/**/*",
+    "template/**/*",
     "README.md",
     "*.js",
     "*.d.ts"
   ],
   "scripts": {
-    "prepare": "node ../../scripts/prepare.js"
+    "check": "../../../scripts/node_modules/.bin/tsc --noEmit",
+    "prep": "../../../scripts/prepare/bundle.ts"
   },
   "dependencies": {
-    "@storybook/addons": "7.0.0-alpha.5",
-    "@storybook/core-client": "7.0.0-alpha.5",
-    "@storybook/csf": "0.0.2--canary.4566f4d.1",
-    "@storybook/docs-tools": "7.0.0-alpha.5",
-    "@storybook/preview-web": "7.0.0-alpha.5",
-    "@storybook/store": "7.0.0-alpha.5",
-    "core-js": "^3.8.2",
+    "@storybook/addons": "7.0.0-alpha.50",
+    "@storybook/core-client": "7.0.0-alpha.50",
+    "@storybook/docs-tools": "7.0.0-alpha.50",
+    "@storybook/preview-web": "7.0.0-alpha.50",
+    "@storybook/store": "7.0.0-alpha.50",
+    "@storybook/types": "7.0.0-alpha.50",
     "global": "^4.4.0",
     "react": "16.14.0",
     "react-dom": "16.14.0",
     "ts-dedent": "^2.0.0"
   },
+  "devDependencies": {
+    "typescript": "~4.6.3"
+  },
   "peerDependencies": {
     "@babel/core": "*"
   },
@@ -53,5 +74,12 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "3dd46982823b34d9f37be917b6247631081feff7"
+  "bundler": {
+    "entries": [
+      "./src/index.ts",
+      "./src/config.ts"
+    ],
+    "platform": "browser"
+  },
+  "gitHead": "77184d039091f4782dc4540df6d271a24fb3e242"
 }

package/preview.js

@@ -1 +1 @@
-export * from './dist/esm/config';
+export * from './dist/config';

package/template/cli/.eslintrc.json

@@ -0,0 +1,6 @@
+{
+  "rules": {
+    "no-undef": "off",
+    "import/extensions": "off"
+  }
+}

package/template/cli/js/Button.js

@@ -0,0 +1,21 @@
+import './button.css';
+
+export const createButton = ({
+  primary = false,
+  size = 'medium',
+  backgroundColor,
+  label,
+  onClick,
+}) => {
+  const btn = document.createElement('button');
+  btn.type = 'button';
+  btn.innerText = label;
+  btn.addEventListener('click', onClick);
+
+  const mode = primary ? 'storybook-button--primary' : 'storybook-button--secondary';
+  btn.className = ['storybook-button', `storybook-button--${size}`, mode].join(' ');
+
+  btn.style.backgroundColor = backgroundColor;
+
+  return btn;
+};

package/template/cli/js/Button.stories.js

@@ -0,0 +1,52 @@
+import { createButton } from './Button';
+
+// More on default export: https://storybook.js.org/docs/html/writing-stories/introduction#default-export
+export default {
+  title: 'Example/Button',
+  // This component will have an automatically generated docsPage entry: https://storybook.js.org/docs/html/writing-docs/docs-page
+  tags: ['docsPage'],
+  // More on component templates: https://storybook.js.org/docs/html/writing-stories/introduction#using-args
+  render: ({ label, ...args }) => {
+    // You can either use a function to create DOM elements or use a plain html string!
+    // return `<div>${label}</div>`;
+    return createButton({ label, ...args });
+  },
+  // More on argTypes: https://storybook.js.org/docs/html/api/argtypes
+  argTypes: {
+    backgroundColor: { control: 'color' },
+    label: { control: 'text' },
+    onClick: { action: 'onClick' },
+    primary: { control: 'boolean' },
+    size: {
+      control: { type: 'select' },
+      options: ['small', 'medium', 'large'],
+    },
+  },
+};
+
+export const Primary = {
+  args: {
+    primary: true,
+    label: 'Button',
+  },
+};
+
+export const Secondary = {
+  args: {
+    label: 'Button',
+  },
+};
+
+export const Large = {
+  args: {
+    size: 'large',
+    label: 'Button',
+  },
+};
+
+export const Small = {
+  args: {
+    size: 'small',
+    label: 'Button',
+  },
+};

package/template/cli/js/Header.js

@@ -0,0 +1,47 @@
+import './header.css';
+import { createButton } from './Button';
+
+export const createHeader = ({ user, onLogout, onLogin, onCreateAccount }) => {
+  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/js/Header.stories.js

@@ -0,0 +1,28 @@
+import { createHeader } from './Header';
+
+export default {
+  title: 'Example/Header',
+  // This component will have an automatically generated docsPage entry: https://storybook.js.org/docs/html/writing-docs/docs-page
+  tags: ['docsPage'],
+  render: (args) => createHeader(args),
+  parameters: {
+    // More on Story layout: https://storybook.js.org/docs/html/configure/story-layout
+    layout: 'fullscreen',
+  },
+  // More on argTypes: https://storybook.js.org/docs/html/api/argtypes
+  argTypes: {
+    onLogin: { action: 'onLogin' },
+    onLogout: { action: 'onLogout' },
+    onCreateAccount: { action: 'onCreateAccount' },
+  },
+};
+
+export const LoggedIn = {
+  args: {
+    user: {
+      name: 'Jane Doe',
+    },
+  },
+};
+
+export const LoggedOut = {};

package/template/cli/js/Page.js

@@ -0,0 +1,94 @@
+import './page.css';
+import { createHeader } from './Header';
+
+export const createPage = () => {
+  const article = document.createElement('article');
+  let user = null;
+  let header = null;
+
+  const rerenderHeader = () => {
+    const wrapper = document.getElementsByTagName('article')[0];
+    wrapper.replaceChild(createHeaderElement(), wrapper.firstChild);
+  };
+
+  const onLogin = () => {
+    user = { name: 'Jane Doe' };
+    rerenderHeader();
+  };
+
+  const onLogout = () => {
+    user = null;
+    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;
+};

package/template/cli/js/Page.stories.js

@@ -0,0 +1,24 @@
+import { within, userEvent } from '@storybook/testing-library';
+import { createPage } from './Page';
+
+export default {
+  title: 'Example/Page',
+  render: () => createPage(),
+  parameters: {
+    // More on Story layout: https://storybook.js.org/docs/html/configure/story-layout
+    layout: 'fullscreen',
+  },
+};
+
+export const LoggedOut = {};
+
+// More on interaction testing: https://storybook.js.org/docs/html/writing-tests/interaction-testing
+export const LoggedIn = {
+  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/Button.stories.ts

@@ -0,0 +1,57 @@
+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: Meta<ButtonProps> = {
+  title: 'Example/Button',
+  // This component will have an automatically generated docsPage entry: https://storybook.js.org/docs/html/writing-docs/docs-page
+  tags: ['docsPage'],
+  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);
+  },
+  // More on argTypes: https://storybook.js.org/docs/html/api/argtypes
+  argTypes: {
+    backgroundColor: { control: 'color' },
+    label: { control: 'text' },
+    onClick: { action: 'onClick' },
+    primary: { control: 'boolean' },
+    size: {
+      control: { type: 'select' },
+      options: ['small', 'medium', 'large'],
+    },
+  },
+};
+
+export default meta;
+type Story = StoryObj<ButtonProps>;
+
+// More on component templates: https://storybook.js.org/docs/html/writing-stories/introduction#using-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/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/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: Meta<HeaderProps> = {
+  title: 'Example/Header',
+  // This component will have an automatically generated docsPage entry: https://storybook.js.org/docs/html/writing-docs/docs-page
+  tags: ['docsPage'],
+  render: (args) => createHeader(args),
+  parameters: {
+    // More on Story layout: https://storybook.js.org/docs/html/configure/story-layout
+    layout: 'fullscreen',
+  },
+  // More on argTypes: https://storybook.js.org/docs/html/api/argtypes
+  argTypes: {
+    onLogin: { action: 'onLogin' },
+    onLogout: { action: 'onLogout' },
+    onCreateAccount: { action: 'onCreateAccount' },
+  },
+};
+
+export default meta;
+type Story = StoryObj<HeaderProps>;
+
+export const LoggedIn: Story = {
+  args: {
+    user: {
+      name: 'John Doe',
+    },
+  },
+};
+
+export const LoggedOut: Story = {};