@storybook/addon-docs 6.5.0-alpha.47 → 6.5.0-alpha.48

package/dist/esm/frameworks/react/react-argtypes.stories.js

@@ -1,123 +0,0 @@
-import "core-js/modules/es.object.assign.js";
-import "core-js/modules/es.array.map.js";
-import "core-js/modules/es.object.entries.js";
-import "core-js/modules/es.object.to-string.js";
-import "core-js/modules/es.symbol.js";
-import "core-js/modules/es.symbol.description.js";
-import "core-js/modules/es.symbol.iterator.js";
-import "core-js/modules/es.array.iterator.js";
-import "core-js/modules/es.string.iterator.js";
-import "core-js/modules/web.dom-collections.iterator.js";
-import "core-js/modules/es.array.slice.js";
-import "core-js/modules/es.function.name.js";
-import "core-js/modules/es.array.from.js";
-import "core-js/modules/es.regexp.exec.js";
-
-function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
-
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-
-function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
-
-function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
-
-import React, { useState } from 'react';
-import mapValues from 'lodash/mapValues';
-import { storiesOf } from '@storybook/react';
-import { ArgsTable } from '@storybook/components';
-import { inferControls } from '@storybook/store';
-import { extractArgTypes } from './extractArgTypes';
-
-var argsTableProps = function argsTableProps(component) {
-  var argTypes = extractArgTypes(component);
-  var parameters = {
-    __isArgsStory: true
-  };
-  var rows = inferControls({
-    argTypes: argTypes,
-    parameters: parameters
-  });
-  return {
-    rows: rows
-  };
-};
-
-var ArgsStory = function ArgsStory(_ref) {
-  var component = _ref.component;
-
-  var _argsTableProps = argsTableProps(component),
-      rows = _argsTableProps.rows;
-
-  var initialArgs = mapValues(rows, function (argType) {
-    return argType.defaultValue;
-  });
-
-  var _useState = useState(initialArgs),
-      _useState2 = _slicedToArray(_useState, 2),
-      args = _useState2[0],
-      setArgs = _useState2[1];
-
-  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("p", null, /*#__PURE__*/React.createElement("b", null, "NOTE:"), " these stories are to help visualise the snapshot tests in", ' ', /*#__PURE__*/React.createElement("code", null, "./react-properties.test.js"), "."), /*#__PURE__*/React.createElement(ArgsTable, {
-    rows: rows,
-    args: args,
-    updateArgs: function updateArgs(val) {
-      return setArgs(Object.assign({}, args, val));
-    }
-  }), /*#__PURE__*/React.createElement("table", null, /*#__PURE__*/React.createElement("thead", null, /*#__PURE__*/React.createElement("tr", null, /*#__PURE__*/React.createElement("th", null, "arg name"), /*#__PURE__*/React.createElement("th", null, "argType"))), /*#__PURE__*/React.createElement("tbody", null, Object.entries(args).map(function (_ref2) {
-    var _ref3 = _slicedToArray(_ref2, 2),
-        key = _ref3[0],
-        val = _ref3[1];
-
-    return /*#__PURE__*/React.createElement("tr", {
-      key: key
-    }, /*#__PURE__*/React.createElement("td", null, /*#__PURE__*/React.createElement("code", null, key)), /*#__PURE__*/React.createElement("td", null, /*#__PURE__*/React.createElement("pre", null, JSON.stringify(rows[key]))));
-  }))));
-};
-
-var typescriptFixtures = ['aliases', 'arrays', 'enums', 'functions', 'interfaces', 'intersections', 'records', 'scalars', 'tuples', 'unions', 'optionals'];
-var typescriptStories = storiesOf('ArgTypes/TypeScript', module);
-typescriptFixtures.forEach(function (fixture) {
-  // eslint-disable-next-line import/no-dynamic-require, global-require, no-shadow
-  var _require = require("../../lib/convert/__testfixtures__/typescript/".concat(fixture)),
-      Component = _require.Component;
-
-  typescriptStories.add(fixture, function () {
-    return /*#__PURE__*/React.createElement(ArgsStory, {
-      component: Component
-    });
-  });
-});
-var proptypesFixtures = ['arrays', 'enums', 'misc', 'objects', 'react', 'scalars'];
-var proptypesStories = storiesOf('ArgTypes/PropTypes', module);
-proptypesFixtures.forEach(function (fixture) {
-  // eslint-disable-next-line import/no-dynamic-require, global-require, no-shadow
-  var _require2 = require("../../lib/convert/__testfixtures__/proptypes/".concat(fixture)),
-      Component = _require2.Component;
-
-  proptypesStories.add(fixture, function () {
-    return /*#__PURE__*/React.createElement(ArgsStory, {
-      component: Component
-    });
-  });
-});
-var issuesFixtures = ['js-class-component', 'js-function-component', 'js-function-component-inline-defaults', 'js-function-component-inline-defaults-no-propTypes', 'ts-function-component', 'ts-function-component-inline-defaults', '9399-js-proptypes-shape', '8663-js-styled-components', '9626-js-default-values', '9668-js-proptypes-no-jsdoc', '8143-ts-react-fc-generics', '8143-ts-imported-types', '8279-js-styled-docgen', '8140-js-prop-types-oneof', '9023-js-hoc', '8740-ts-multi-props', '9556-ts-react-default-exports', '9592-ts-styled-props', '9591-ts-import-types', '9721-ts-deprecated-jsdoc', '9827-ts-default-values', '9586-js-react-memo', '9575-ts-camel-case', '9493-ts-display-name', '8894-9511-ts-forward-ref', '9465-ts-type-props', '8428-js-static-prop-types', '9764-ts-extend-props', '9922-ts-component-props'];
-var issuesStories = storiesOf('ArgTypes/Issues', module);
-issuesFixtures.forEach(function (fixture) {
-  // eslint-disable-next-line import/no-dynamic-require, global-require
-  var _require3 = require("./__testfixtures__/".concat(fixture, "/input")),
-      component = _require3.component;
-
-  issuesStories.add(fixture, function () {
-    return /*#__PURE__*/React.createElement(ArgsStory, {
-      component: component
-    });
-  }, {
-    chromatic: {
-      disable: true
-    }
-  });
-});

package/dist/esm/frameworks/react/typeScript/handleProp.js

@@ -1,27 +0,0 @@
-import "core-js/modules/es.array.map.js";
-import { createDefaultValue, createDefaultValueFromRawDefaultProp } from '../lib/defaultValues';
-export function enhanceTypeScriptProp(extractedProp, rawDefaultProp) {
-  var propDef = extractedProp.propDef;
-  var defaultValue = extractedProp.docgenInfo.defaultValue;
-
-  if (defaultValue != null && defaultValue.value != null) {
-    var newDefaultValue = createDefaultValue(defaultValue.value);
-
-    if (newDefaultValue != null) {
-      propDef.defaultValue = newDefaultValue;
-    }
-  } else if (rawDefaultProp != null) {
-    var _newDefaultValue = createDefaultValueFromRawDefaultProp(rawDefaultProp, propDef);
-
-    if (_newDefaultValue != null) {
-      propDef.defaultValue = _newDefaultValue;
-    }
-  }
-
-  return propDef;
-}
-export function enhanceTypeScriptProps(extractedProps) {
-  return extractedProps.map(function (prop) {
-    return enhanceTypeScriptProp(prop);
-  });
-}

package/dist/esm/frameworks/svelte/config.js

@@ -1,13 +0,0 @@
-import { extractArgTypes } from './extractArgTypes';
-import { extractComponentDescription } from './extractComponentDescription';
-import { prepareForInline } from './prepareForInline';
-import { sourceDecorator } from './sourceDecorator';
-export var parameters = {
-  docs: {
-    inlineStories: true,
-    prepareForInline: prepareForInline,
-    extractArgTypes: extractArgTypes,
-    extractComponentDescription: extractComponentDescription
-  }
-};
-export var decorators = [sourceDecorator];

package/dist/esm/frameworks/svelte/extractArgTypes.js

@@ -1,140 +0,0 @@
-import "core-js/modules/es.array.find.js";
-import "core-js/modules/es.object.to-string.js";
-import "core-js/modules/es.function.name.js";
-import "core-js/modules/web.dom-collections.for-each.js";
-import "core-js/modules/es.symbol.js";
-import "core-js/modules/es.symbol.description.js";
-import "core-js/modules/es.array.join.js";
-import "core-js/modules/es.array.filter.js";
-import "core-js/modules/es.array.map.js";
-import { logger } from '@storybook/client-logger';
-
-function hasKeyword(keyword, keywords) {
-  return keywords ? keywords.find(function (k) {
-    return k.name === keyword;
-  }) != null : false;
-}
-
-export var extractArgTypes = function extractArgTypes(component) {
-  try {
-    // eslint-disable-next-line no-underscore-dangle
-    var docgen = component.__docgen;
-
-    if (docgen) {
-      return createArgTypes(docgen);
-    }
-  } catch (err) {
-    logger.log("Error extracting argTypes: ".concat(err));
-  }
-
-  return {};
-};
-export var createArgTypes = function createArgTypes(docgen) {
-  var results = {};
-  docgen.data.forEach(function (item) {
-    var _item$type, _item$type2;
-
-    results[item.name] = {
-      control: parseTypeToControl(item.type),
-      name: item.name,
-      description: item.description,
-      type: {
-        required: hasKeyword('required', item.keywords),
-        name: (_item$type = item.type) === null || _item$type === void 0 ? void 0 : _item$type.text
-      },
-      table: {
-        type: {
-          summary: (_item$type2 = item.type) === null || _item$type2 === void 0 ? void 0 : _item$type2.text
-        },
-        defaultValue: {
-          summary: item.defaultValue
-        },
-        category: 'properties'
-      }
-    };
-  });
-  docgen.events.forEach(function (item) {
-    results["event_".concat(item.name)] = {
-      name: item.name,
-      description: item.description,
-      type: {
-        name: 'other',
-        value: 'void'
-      },
-      table: {
-        category: 'events'
-      }
-    };
-  });
-  docgen.slots.forEach(function (item) {
-    var _item$params;
-
-    results["slot_".concat(item.name)] = {
-      name: item.name,
-      description: [item.description, (_item$params = item.params) === null || _item$params === void 0 ? void 0 : _item$params.map(function (p) {
-        return "`".concat(p.name, "`");
-      }).join(' ')].filter(function (p) {
-        return p;
-      }).join('\n\n'),
-      type: {
-        name: 'other',
-        value: 'void'
-      },
-      table: {
-        category: 'slots'
-      }
-    };
-  });
-  return results;
-};
-/**
- * Function to convert the type from sveltedoc-parser to a storybook type
- * @param typeName
- * @returns string
- */
-
-var parseTypeToControl = function parseTypeToControl(type) {
-  if (!type) {
-    return null;
-  }
-
-  if (type.kind === 'type') {
-    switch (type.type) {
-      case 'string':
-        return {
-          type: 'text'
-        };
-
-      case 'enum':
-        return {
-          type: 'radio'
-        };
-
-      case 'any':
-        return {
-          type: 'object'
-        };
-
-      default:
-        return {
-          type: type.type
-        };
-    }
-  } else if (type.kind === 'union') {
-    // @ts-ignore TODO: fix, this seems like a broke in package update
-    if (Array.isArray(type.type) && !type.type.find(function (t) {
-      return t.type !== 'string';
-    })) {
-      return {
-        type: 'radio',
-        options: type.type.filter(function (t) {
-          return t.kind === 'const';
-        }).map(function (t) {
-          return t.value;
-        })
-      };
-    }
-  }
-
-  return null;
-};

package/dist/esm/frameworks/svelte/extractComponentDescription.js

@@ -1,12 +0,0 @@
-import "core-js/modules/es.symbol.js";
-import "core-js/modules/es.symbol.description.js";
-export function extractComponentDescription(component) {
-  if (!component) {
-    return null;
-  }
-
-  var _component$__docgen = component.__docgen,
-      __docgen = _component$__docgen === void 0 ? {} : _component$__docgen;
-
-  return __docgen.description;
-}

package/dist/esm/frameworks/svelte/prepareForInline.js

@@ -1,19 +0,0 @@
-import React from 'react';
-import HOC from '@storybook/addon-docs/svelte/HOC.svelte';
-export var prepareForInline = function prepareForInline(storyFn) {
-  var el = React.useRef(null);
-  React.useEffect(function () {
-    var root = new HOC({
-      target: el.current,
-      props: {
-        storyFn: storyFn
-      }
-    });
-    return function () {
-      return root.$destroy();
-    };
-  });
-  return /*#__PURE__*/React.createElement('div', {
-    ref: el
-  });
-};

package/dist/esm/frameworks/svelte/preset.js

@@ -1,42 +0,0 @@
-import "regenerator-runtime/runtime.js";
-import "core-js/modules/es.object.to-string.js";
-import "core-js/modules/es.promise.js";
-
-function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
-
-function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
-
-import path from 'path';
-export function webpackFinal(_x, _x2) {
-  return _webpackFinal.apply(this, arguments);
-}
-
-function _webpackFinal() {
-  _webpackFinal = _asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee(webpackConfig, options) {
-    var svelteOptions;
-    return regeneratorRuntime.wrap(function _callee$(_context) {
-      while (1) {
-        switch (_context.prev = _context.next) {
-          case 0:
-            _context.next = 2;
-            return options.presets.apply('svelteOptions', {}, options);
-
-          case 2:
-            svelteOptions = _context.sent;
-            webpackConfig.module.rules.push({
-              test: /\.svelte$/,
-              loader: path.resolve("".concat(__dirname, "/svelte-docgen-loader")),
-              enforce: 'post',
-              options: svelteOptions
-            });
-            return _context.abrupt("return", webpackConfig);
-
-          case 5:
-          case "end":
-            return _context.stop();
-        }
-      }
-    }, _callee);
-  }));
-  return _webpackFinal.apply(this, arguments);
-}

package/dist/esm/frameworks/svelte/sourceDecorator.js

@@ -1,233 +0,0 @@
-function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
-
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-
-function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
-
-function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
-
-import "core-js/modules/es.array.concat.js";
-import "core-js/modules/es.function.name.js";
-import "core-js/modules/es.string.ends-with.js";
-import "core-js/modules/es.array.join.js";
-import "core-js/modules/es.array.filter.js";
-import "core-js/modules/es.object.to-string.js";
-import "core-js/modules/es.array.map.js";
-import "core-js/modules/es.object.entries.js";
-import "core-js/modules/es.array.find.js";
-import "core-js/modules/es.symbol.js";
-import "core-js/modules/es.symbol.description.js";
-import "core-js/modules/es.symbol.iterator.js";
-import "core-js/modules/es.array.iterator.js";
-import "core-js/modules/es.string.iterator.js";
-import "core-js/modules/web.dom-collections.iterator.js";
-import "core-js/modules/es.array.slice.js";
-import "core-js/modules/es.array.from.js";
-import "core-js/modules/es.regexp.exec.js";
-import { addons, useEffect } from '@storybook/addons';
-import { SourceType, SNIPPET_RENDERED } from '../../shared';
-/**
- * Check if the sourcecode should be generated.
- *
- * @param context StoryContext
- */
-
-var skipSourceRender = function skipSourceRender(context) {
-  var _context$parameters$d;
-
-  var sourceParams = context === null || context === void 0 ? void 0 : (_context$parameters$d = context.parameters.docs) === null || _context$parameters$d === void 0 ? void 0 : _context$parameters$d.source;
-  var isArgsStory = context === null || context === void 0 ? void 0 : context.parameters.__isArgsStory; // always render if the user forces it
-
-  if ((sourceParams === null || sourceParams === void 0 ? void 0 : sourceParams.type) === SourceType.DYNAMIC) {
-    return false;
-  } // never render if the user is forcing the block to render code, or
-  // if the user provides code, or if it's not an args story.
-
-
-  return !isArgsStory || (sourceParams === null || sourceParams === void 0 ? void 0 : sourceParams.code) || (sourceParams === null || sourceParams === void 0 ? void 0 : sourceParams.type) === SourceType.CODE;
-};
-/**
- * Transform a key/value to a svelte declaration as string.
- *
- * Default values are ommited
- *
- * @param key Key
- * @param value Value
- * @param argTypes Component ArgTypes
- */
-
-
-function toSvelteProperty(key, value, argTypes) {
-  if (value === undefined || value === null) {
-    return null;
-  } // default value ?
-
-
-  if (argTypes[key] && argTypes[key].defaultValue === value) {
-    return null;
-  }
-
-  if (value === true) {
-    return key;
-  }
-
-  if (typeof value === 'string') {
-    return "".concat(key, "=").concat(JSON.stringify(value));
-  }
-
-  return "".concat(key, "={").concat(JSON.stringify(value), "}");
-}
-/**
- * Extract a component name.
- *
- * @param component Component
- */
-
-
-function getComponentName(component) {
-  if (component == null) {
-    return null;
-  }
-
-  var _component$__docgen = component.__docgen,
-      __docgen = _component$__docgen === void 0 ? {} : _component$__docgen;
-
-  var name = __docgen.name;
-
-  if (!name) {
-    return component.name;
-  }
-
-  if (name.endsWith('.svelte')) {
-    name = name.substring(0, name.length - 7);
-  }
-
-  return name;
-}
-/**
- * Generate a svelte template.
- *
- * @param component Component
- * @param args Args
- * @param argTypes ArgTypes
- * @param slotProperty Property used to simulate a slot
- */
-
-
-export function generateSvelteSource(component, args, argTypes, slotProperty) {
-  var name = getComponentName(component);
-
-  if (!name) {
-    return null;
-  }
-
-  var props = Object.entries(args).filter(function (_ref) {
-    var _ref2 = _slicedToArray(_ref, 1),
-        k = _ref2[0];
-
-    return k !== slotProperty;
-  }).map(function (_ref3) {
-    var _ref4 = _slicedToArray(_ref3, 2),
-        k = _ref4[0],
-        v = _ref4[1];
-
-    return toSvelteProperty(k, v, argTypes);
-  }).filter(function (p) {
-    return p;
-  }).join(' ');
-  var slotValue = slotProperty ? args[slotProperty] : null;
-
-  if (slotValue) {
-    return "<".concat(name, " ").concat(props, ">\n    ").concat(slotValue, "\n</").concat(name, ">");
-  }
-
-  return "<".concat(name, " ").concat(props, "/>");
-}
-/**
- * Check if the story component is a wrapper to the real component.
- *
- * A component can be annoted with @wrapper to indicate that
- * it's just a wrapper for the real tested component. If it's the case
- * then the code generated references the real component, not the wrapper.
- *
- * moreover, a wrapper can annotate a property with @slot : this property
- * is then assumed to be an alias to the default slot.
- *
- * @param component Component
- */
-
-function getWrapperProperties(component) {
-  var __docgen = component.__docgen;
-
-  if (!__docgen) {
-    return {
-      wrapper: false
-    };
-  } // the component should be declared as a wrapper
-
-
-  if (!__docgen.keywords.find(function (kw) {
-    return kw.name === 'wrapper';
-  })) {
-    return {
-      wrapper: false
-    };
-  }
-
-  var slotProp = __docgen.data.find(function (prop) {
-    return prop.keywords.find(function (kw) {
-      return kw.name === 'slot';
-    });
-  });
-
-  return {
-    wrapper: true,
-    slotProperty: slotProp === null || slotProp === void 0 ? void 0 : slotProp.name
-  };
-}
-/**
- * Svelte source decorator.
- * @param storyFn Fn
- * @param context  StoryContext
- */
-
-
-export var sourceDecorator = function sourceDecorator(storyFn, context) {
-  var channel = addons.getChannel();
-  var skip = skipSourceRender(context);
-  var story = storyFn();
-  var source;
-  useEffect(function () {
-    if (!skip && source) {
-      channel.emit(SNIPPET_RENDERED, (context || {}).id, source);
-    }
-  });
-
-  if (skip) {
-    return story;
-  }
-
-  var _ref5 = context || {},
-      _ref5$parameters = _ref5.parameters,
-      parameters = _ref5$parameters === void 0 ? {} : _ref5$parameters,
-      _ref5$args = _ref5.args,
-      args = _ref5$args === void 0 ? {} : _ref5$args;
-
-  var _story$Component = story.Component,
-      component = _story$Component === void 0 ? {} : _story$Component;
-
-  var _getWrapperProperties = getWrapperProperties(component),
-      wrapper = _getWrapperProperties.wrapper,
-      slotProperty = _getWrapperProperties.slotProperty;
-
-  if (wrapper) {
-    component = parameters.component;
-  }
-
-  source = generateSvelteSource(component, args, context === null || context === void 0 ? void 0 : context.argTypes, slotProperty);
-  return story;
-};