@storybook/addon-docs 7.0.0-alpha.7 → 7.0.0-beta.0

package/dist/cjs/blocks/DocsContext.js

@@ -1,25 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.DocsContext = void 0;
-
-var _react = require("react");
-
-var _global = require("global");
-
-// We add DocsContext to window. The reason is that in case DocsContext.ts is
-// imported multiple times (maybe once directly, and another time from a minified bundle)
-// we will have multiple DocsContext definitions - leading to lost context in
-// the React component tree.
-// This was specifically a problem with the Vite builder.
-
-/* eslint-disable no-underscore-dangle */
-if (_global.window && _global.window.__DOCS_CONTEXT__ === undefined) {
-  _global.window.__DOCS_CONTEXT__ = /*#__PURE__*/(0, _react.createContext)(null);
-  _global.window.__DOCS_CONTEXT__.displayName = 'DocsContext';
-}
-
-const DocsContext = _global.window ? _global.window.__DOCS_CONTEXT__ : /*#__PURE__*/(0, _react.createContext)(null);
-exports.DocsContext = DocsContext;

package/dist/cjs/blocks/DocsPage.js

@@ -1,30 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.DocsPage = void 0;
-
-var _react = _interopRequireDefault(require("react"));
-
-var _Title = require("./Title");
-
-var _Subtitle = require("./Subtitle");
-
-var _Description = require("./Description");
-
-var _Primary = require("./Primary");
-
-var _types = require("./types");
-
-var _ArgsTable = require("./ArgsTable");
-
-var _Stories = require("./Stories");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-const DocsPage = () => /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement(_Title.Title, null), /*#__PURE__*/_react.default.createElement(_Subtitle.Subtitle, null), /*#__PURE__*/_react.default.createElement(_Description.Description, null), /*#__PURE__*/_react.default.createElement(_Primary.Primary, null), /*#__PURE__*/_react.default.createElement(_ArgsTable.ArgsTable, {
-  story: _types.PRIMARY_STORY
-}), /*#__PURE__*/_react.default.createElement(_Stories.Stories, null));
-
-exports.DocsPage = DocsPage;

package/dist/cjs/blocks/DocsRenderer.js

@@ -1,48 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.DocsRenderer = void 0;
-
-var _react = _interopRequireDefault(require("react"));
-
-var _reactDom = _interopRequireDefault(require("react-dom"));
-
-var _DocsContainer = require("./DocsContainer");
-
-var _DocsPage = require("./DocsPage");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-class DocsRenderer {
-  constructor() {
-    this.render = void 0;
-    this.unmount = void 0;
-
-    this.render = (docsContext, docsParameters, element, callback) => {
-      renderDocsAsync(docsContext, docsParameters, element).then(callback);
-    };
-
-    this.unmount = element => {
-      _reactDom.default.unmountComponentAtNode(element);
-    };
-  }
-
-}
-
-exports.DocsRenderer = DocsRenderer;
-
-async function renderDocsAsync(docsContext, docsParameters, element) {
-  const Container = docsParameters.container || (await docsParameters.getContainer?.()) || _DocsContainer.DocsContainer;
-  const Page = docsParameters.page || (await docsParameters.getPage?.()) || _DocsPage.DocsPage; // Use `title` as a key so that we force a re-render every time we switch components
-
-  const docsElement = /*#__PURE__*/_react.default.createElement(Container, {
-    key: docsContext.title,
-    context: docsContext
-  }, /*#__PURE__*/_react.default.createElement(Page, null));
-
-  await new Promise(resolve => {
-    _reactDom.default.render(docsElement, element, resolve);
-  });
-}

package/dist/cjs/blocks/DocsStory.js

@@ -1,66 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.DocsStory = void 0;
-
-var _react = _interopRequireDefault(require("react"));
-
-var _utilDeprecate = _interopRequireDefault(require("util-deprecate"));
-
-var _tsDedent = _interopRequireDefault(require("ts-dedent"));
-
-var _Subheading = require("./Subheading");
-
-var _Anchor = require("./Anchor");
-
-var _Description = require("./Description");
-
-var _Story = require("./Story");
-
-var _Canvas = require("./Canvas");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-const warnStoryDescription = (0, _utilDeprecate.default)(() => {}, (0, _tsDedent.default)`
-    Deprecated parameter: docs.storyDescription => docs.description.story
-      
-    https://github.com/storybookjs/storybook/blob/next/MIGRATION.md#docs-description-parameter
-  `);
-
-const DocsStory = ({
-  id,
-  name,
-  expanded = true,
-  withToolbar = false,
-  parameters = {}
-}) => {
-  let description;
-  const {
-    docs
-  } = parameters;
-
-  if (expanded && docs) {
-    description = docs.description?.story;
-
-    if (!description) {
-      description = docs.storyDescription;
-      if (description) warnStoryDescription();
-    }
-  }
-
-  const subheading = expanded && name;
-  return /*#__PURE__*/_react.default.createElement(_Anchor.Anchor, {
-    storyId: id
-  }, subheading && /*#__PURE__*/_react.default.createElement(_Subheading.Subheading, null, subheading), description && /*#__PURE__*/_react.default.createElement(_Description.Description, {
-    markdown: description
-  }), /*#__PURE__*/_react.default.createElement(_Canvas.Canvas, {
-    withToolbar: withToolbar
-  }, /*#__PURE__*/_react.default.createElement(_Story.Story, {
-    id: id,
-    parameters: parameters
-  })));
-};
-
-exports.DocsStory = DocsStory;

package/dist/cjs/blocks/ExternalDocsContainer.js

@@ -1,64 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.ExternalDocsContainer = void 0;
-
-var _react = _interopRequireDefault(require("react"));
-
-var _theming = require("@storybook/theming");
-
-var _DocsContext = require("./DocsContext");
-
-var _ExternalPreview = require("./ExternalPreview");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-let preview;
-
-const ExternalDocsContainer = ({
-  projectAnnotations,
-  children
-}) => {
-  if (!preview) preview = new _ExternalPreview.ExternalPreview(projectAnnotations);
-  let pageMeta;
-
-  const setMeta = m => {
-    pageMeta = m;
-  };
-
-  const docsContext = {
-    type: 'external',
-    id: 'external-docs',
-    title: 'External',
-    name: 'Docs',
-    storyIdByModuleExport: (storyExport, metaExport) => {
-      return preview.storyIdByModuleExport(storyExport, metaExport || pageMeta);
-    },
-    storyById: id => {
-      return preview.storyById(id);
-    },
-    getStoryContext: () => {
-      throw new Error('not implemented');
-    },
-    componentStories: () => {
-      // TODO: could implement in a very similar way to in DocsRender. (TODO: How to share code?)
-      throw new Error('not implemented');
-    },
-    loadStory: async id => {
-      return preview.storyById(id);
-    },
-    renderStoryToElement: (story, element) => {
-      return preview.renderStoryToElement(story, element);
-    },
-    setMeta
-  };
-  return /*#__PURE__*/_react.default.createElement(_DocsContext.DocsContext.Provider, {
-    value: docsContext
-  }, /*#__PURE__*/_react.default.createElement(_theming.ThemeProvider, {
-    theme: (0, _theming.ensure)(_theming.themes.normal)
-  }, children));
-};
-
-exports.ExternalDocsContainer = ExternalDocsContainer;

package/dist/cjs/blocks/ExternalPreview.js

@@ -1,99 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.ExternalPreview = void 0;
-
-var _previewWeb = require("@storybook/preview-web");
-
-var _csf = require("@storybook/csf");
-
-class ConstantMap {
-  // eslint-disable-next-line no-useless-constructor
-  constructor(prefix) {
-    this.prefix = prefix;
-    this.entries = new Map();
-  }
-
-  get(key) {
-    if (!this.entries.has(key)) {
-      this.entries.set(key, `${this.prefix}${this.entries.size}`);
-    }
-
-    return this.entries.get(key);
-  }
-
-}
-
-class ExternalPreview extends _previewWeb.Preview {
-  constructor(projectAnnotations) {
-    super();
-    this.projectAnnotations = projectAnnotations;
-    this.initialized = false;
-    this.importPaths = new ConstantMap('./importPath/');
-    this.titles = new ConstantMap('title-');
-    this.storyIds = new Map();
-    this.storyIndex = {
-      v: 4,
-      entries: {}
-    };
-    this.moduleExportsByImportPath = {};
-  }
-
-  storyIdByModuleExport(storyExport, meta) {
-    if (!this.storyIds.has(storyExport)) this.addStoryFromExports(storyExport, meta);
-    return this.storyIds.get(storyExport);
-  }
-
-  addStoryFromExports(storyExport, meta) {
-    const importPath = this.importPaths.get(meta);
-    this.moduleExportsByImportPath[importPath] = meta;
-    const title = meta.default.title || this.titles.get(meta);
-    const exportEntry = Object.entries(meta).find(([_, moduleExport]) => moduleExport === storyExport);
-    if (!exportEntry) throw new Error(`Didn't find \`of\` used in Story block in the provided CSF exports`);
-    const storyId = (0, _csf.toId)(title, exportEntry[0]);
-    this.storyIds.set(storyExport, storyId);
-    this.storyIndex.entries[storyId] = {
-      id: storyId,
-      importPath,
-      title,
-      name: 'Name',
-      type: 'story'
-    };
-
-    if (!this.initialized) {
-      this.initialized = true;
-      return this.initialize({
-        getStoryIndex: () => this.storyIndex,
-        importFn: path => {
-          return Promise.resolve(this.moduleExportsByImportPath[path]);
-        },
-        getProjectAnnotations: () => this.projectAnnotations
-      });
-    } // else
-
-
-    return this.onStoriesChanged({
-      storyIndex: this.storyIndex
-    });
-  }
-
-  storyById(storyId) {
-    const entry = this.storyIndex.entries[storyId];
-    if (!entry) throw new Error(`Unknown storyId ${storyId}`);
-    const {
-      importPath,
-      title
-    } = entry;
-    const moduleExports = this.moduleExportsByImportPath[importPath];
-    const csfFile = this.storyStore.processCSFFileWithCache(moduleExports, importPath, title);
-    return this.storyStore.storyFromCSFFile({
-      storyId,
-      csfFile
-    });
-  }
-
-}
-
-exports.ExternalPreview = ExternalPreview;

package/dist/cjs/blocks/Heading.js

@@ -1,31 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Heading = void 0;
-
-var _react = _interopRequireDefault(require("react"));
-
-var _components = require("@storybook/components");
-
-var _mdx = require("./mdx");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-const Heading = ({
-  children,
-  disableAnchor
-}) => {
-  if (disableAnchor || typeof children !== 'string') {
-    return /*#__PURE__*/_react.default.createElement(_components.H2, null, children);
-  }
-
-  const tagID = children.toLowerCase().replace(/[^a-z0-9]/gi, '-');
-  return /*#__PURE__*/_react.default.createElement(_mdx.HeaderMdx, {
-    as: "h2",
-    id: tagID
-  }, children);
-};
-
-exports.Heading = Heading;

package/dist/cjs/blocks/Meta.js

@@ -1,64 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Meta = void 0;
-
-var _react = _interopRequireWildcard(require("react"));
-
-var _global = _interopRequireDefault(require("global"));
-
-var _Anchor = require("./Anchor");
-
-var _DocsContext = require("./DocsContext");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
-
-const {
-  document
-} = _global.default;
-
-function getFirstStoryId(docsContext) {
-  const stories = docsContext.componentStories();
-  return stories.length > 0 ? stories[0].id : null;
-}
-
-function renderAnchor() {
-  const context = (0, _react.useContext)(_DocsContext.DocsContext);
-
-  if (context.type !== 'legacy') {
-    return null;
-  }
-
-  const anchorId = getFirstStoryId(context) || context.id;
-  return /*#__PURE__*/_react.default.createElement(_Anchor.Anchor, {
-    storyId: anchorId
-  });
-}
-/**
- * This component is used to declare component metadata in docs
- * and gets transformed into a default export underneath the hood.
- */
-
-
-const Meta = ({
-  of
-}) => {
-  let isDocs = true;
-
-  if (document) {
-    const params = new URL(document.location).searchParams;
-    isDocs = params.get('viewMode') === 'docs';
-  }
-
-  const context = (0, _react.useContext)(_DocsContext.DocsContext);
-  if (of) context.setMeta(of);
-  return isDocs ? renderAnchor() : null;
-};
-
-exports.Meta = Meta;

package/dist/cjs/blocks/Preview.js

@@ -1,23 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Preview = void 0;
-
-var _react = _interopRequireDefault(require("react"));
-
-var _utilDeprecate = _interopRequireDefault(require("util-deprecate"));
-
-var _tsDedent = _interopRequireDefault(require("ts-dedent"));
-
-var _Canvas = require("./Canvas");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-const Preview = (0, _utilDeprecate.default)(props => /*#__PURE__*/_react.default.createElement(_Canvas.Canvas, props), (0, _tsDedent.default)`
-    Preview doc block has been renamed to Canvas.
-
-    https://github.com/storybookjs/storybook/blob/next/MIGRATION.md#previewprops-renamed
-  `);
-exports.Preview = Preview;

package/dist/cjs/blocks/Primary.js

@@ -1,39 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Primary = void 0;
-
-var _react = _interopRequireWildcard(require("react"));
-
-var _DocsContext = require("./DocsContext");
-
-var _DocsStory = require("./DocsStory");
-
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
-
-function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
-
-const Primary = ({
-  name
-}) => {
-  const {
-    componentStories: getComponentStories
-  } = (0, _react.useContext)(_DocsContext.DocsContext);
-  const componentStories = getComponentStories();
-  let story;
-
-  if (componentStories) {
-    story = name ? componentStories.find(s => s.name === name) : componentStories[0];
-  }
-
-  return story ? /*#__PURE__*/_react.default.createElement(_DocsStory.DocsStory, _extends({}, story, {
-    expanded: false,
-    withToolbar: true
-  })) : null;
-};
-
-exports.Primary = Primary;

package/dist/cjs/blocks/Props.js

@@ -1,29 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Props = void 0;
-
-var _react = _interopRequireDefault(require("react"));
-
-var _utilDeprecate = _interopRequireDefault(require("util-deprecate"));
-
-var _tsDedent = _interopRequireDefault(require("ts-dedent"));
-
-var _ArgsTable = require("./ArgsTable");
-
-var _types = require("./types");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-const Props = (0, _utilDeprecate.default)(props => /*#__PURE__*/_react.default.createElement(_ArgsTable.ArgsTable, props), (0, _tsDedent.default)`
-    Props doc block has been renamed to ArgsTable.
-
-    https://github.com/storybookjs/storybook/blob/next/MIGRATION.md#previewprops-renamed
-  `); // @ts-ignore
-
-exports.Props = Props;
-Props.defaultProps = {
-  of: _types.CURRENT_SELECTION
-};