@storybook/addon-docs 6.5.0-alpha.5 → 6.5.0-alpha.52

package/dist/esm/frameworks/angular/compodoc.js

@@ -1,347 +0,0 @@
-function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
-
-import "core-js/modules/es.function.name.js";
-import "core-js/modules/es.array.find.js";
-import "core-js/modules/es.array.map.js";
-import "core-js/modules/es.array.concat.js";
-import "core-js/modules/es.array.join.js";
-import "core-js/modules/es.string.split.js";
-import "core-js/modules/es.regexp.exec.js";
-import "core-js/modules/es.array.includes.js";
-import "core-js/modules/es.number.constructor.js";
-import "core-js/modules/web.dom-collections.for-each.js";
-import "core-js/modules/es.string.replace.js";
-import "core-js/modules/es.object.assign.js";
-import "core-js/modules/es.symbol.js";
-import "core-js/modules/es.symbol.description.js";
-import "core-js/modules/es.object.to-string.js";
-import "core-js/modules/es.symbol.iterator.js";
-import "core-js/modules/es.string.iterator.js";
-import "core-js/modules/es.array.iterator.js";
-import "core-js/modules/web.dom-collections.iterator.js";
-
-/* eslint-disable no-underscore-dangle */
-
-/* global window */
-import { logger } from '@storybook/client-logger';
-export var isMethod = function isMethod(methodOrProp) {
-  return methodOrProp.args !== undefined;
-};
-export var setCompodocJson = function setCompodocJson(compodocJson) {
-  // @ts-ignore
-  window.__STORYBOOK_COMPODOC_JSON__ = compodocJson;
-}; // @ts-ignore
-
-export var getCompodocJson = function getCompodocJson() {
-  return window.__STORYBOOK_COMPODOC_JSON__;
-};
-export var checkValidComponentOrDirective = function checkValidComponentOrDirective(component) {
-  if (!component.name) {
-    throw new Error("Invalid component ".concat(JSON.stringify(component)));
-  }
-};
-export var checkValidCompodocJson = function checkValidCompodocJson(compodocJson) {
-  if (!compodocJson || !compodocJson.components) {
-    throw new Error('Invalid compodoc JSON');
-  }
-};
-
-var hasDecorator = function hasDecorator(item, decoratorName) {
-  return item.decorators && item.decorators.find(function (x) {
-    return x.name === decoratorName;
-  });
-};
-
-var mapPropertyToSection = function mapPropertyToSection(item) {
-  if (hasDecorator(item, 'ViewChild')) {
-    return 'view child';
-  }
-
-  if (hasDecorator(item, 'ViewChildren')) {
-    return 'view children';
-  }
-
-  if (hasDecorator(item, 'ContentChild')) {
-    return 'content child';
-  }
-
-  if (hasDecorator(item, 'ContentChildren')) {
-    return 'content children';
-  }
-
-  return 'properties';
-};
-
-var mapItemToSection = function mapItemToSection(key, item) {
-  switch (key) {
-    case 'methods':
-    case 'methodsClass':
-      return 'methods';
-
-    case 'inputsClass':
-      return 'inputs';
-
-    case 'outputsClass':
-      return 'outputs';
-
-    case 'properties':
-    case 'propertiesClass':
-      if (isMethod(item)) {
-        throw new Error("Cannot be of type Method if key === 'propertiesClass'");
-      }
-
-      return mapPropertyToSection(item);
-
-    default:
-      throw new Error("Unknown key: ".concat(key));
-  }
-};
-
-export var findComponentByName = function findComponentByName(name, compodocJson) {
-  return compodocJson.components.find(function (c) {
-    return c.name === name;
-  }) || compodocJson.directives.find(function (c) {
-    return c.name === name;
-  }) || compodocJson.pipes.find(function (c) {
-    return c.name === name;
-  }) || compodocJson.injectables.find(function (c) {
-    return c.name === name;
-  }) || compodocJson.classes.find(function (c) {
-    return c.name === name;
-  });
-};
-
-var getComponentData = function getComponentData(component) {
-  if (!component) {
-    return null;
-  }
-
-  checkValidComponentOrDirective(component);
-  var compodocJson = getCompodocJson();
-
-  if (!compodocJson) {
-    return null;
-  }
-
-  checkValidCompodocJson(compodocJson);
-  var name = component.name;
-  var metadata = findComponentByName(name, compodocJson);
-
-  if (!metadata) {
-    logger.warn("Component not found in compodoc JSON: '".concat(name, "'"));
-  }
-
-  return metadata;
-};
-
-var displaySignature = function displaySignature(item) {
-  var args = item.args.map(function (arg) {
-    return "".concat(arg.name).concat(arg.optional ? '?' : '', ": ").concat(arg.type);
-  });
-  return "(".concat(args.join(', '), ") => ").concat(item.returnType);
-};
-
-var extractTypeFromValue = function extractTypeFromValue(defaultValue) {
-  var valueType = _typeof(defaultValue);
-
-  return defaultValue || valueType === 'number' || valueType === 'boolean' || valueType === 'string' ? valueType : null;
-};
-
-var extractEnumValues = function extractEnumValues(compodocType) {
-  var _compodocJson$miscell, _compodocJson$miscell2;
-
-  var compodocJson = getCompodocJson();
-  var enumType = compodocJson === null || compodocJson === void 0 ? void 0 : (_compodocJson$miscell = compodocJson.miscellaneous) === null || _compodocJson$miscell === void 0 ? void 0 : (_compodocJson$miscell2 = _compodocJson$miscell.enumerations) === null || _compodocJson$miscell2 === void 0 ? void 0 : _compodocJson$miscell2.find(function (x) {
-    return x.name === compodocType;
-  });
-
-  if (enumType !== null && enumType !== void 0 && enumType.childs.every(function (x) {
-    return x.value;
-  })) {
-    return enumType.childs.map(function (x) {
-      return x.value;
-    });
-  }
-
-  if (typeof compodocType !== 'string' || compodocType.indexOf('|') === -1) {
-    return null;
-  }
-
-  try {
-    return compodocType.split('|').map(function (value) {
-      return JSON.parse(value);
-    });
-  } catch (e) {
-    return null;
-  }
-};
-
-export var extractType = function extractType(property, defaultValue) {
-  var compodocType = property.type || extractTypeFromValue(defaultValue);
-
-  switch (compodocType) {
-    case 'string':
-    case 'boolean':
-    case 'number':
-      return {
-        name: compodocType
-      };
-
-    case undefined:
-    case null:
-      return {
-        name: 'void'
-      };
-
-    default:
-      {
-        var resolvedType = resolveTypealias(compodocType);
-        var enumValues = extractEnumValues(resolvedType);
-        return enumValues ? {
-          name: 'enum',
-          value: enumValues
-        } : {
-          name: 'object'
-        };
-      }
-  }
-};
-
-var castDefaultValue = function castDefaultValue(property, defaultValue) {
-  var compodocType = property.type; // All these checks are necessary as compodoc does not always set the type ie. @HostBinding have empty types.
-  // null and undefined also have 'any' type
-
-  if (['boolean', 'number', 'string', 'EventEmitter'].includes(compodocType)) {
-    switch (compodocType) {
-      case 'boolean':
-        return defaultValue === 'true';
-
-      case 'number':
-        return Number(defaultValue);
-
-      case 'EventEmitter':
-        return undefined;
-
-      default:
-        return defaultValue;
-    }
-  } else {
-    switch (defaultValue) {
-      case 'true':
-        return true;
-
-      case 'false':
-        return false;
-
-      case 'null':
-        return null;
-
-      case 'undefined':
-        return undefined;
-
-      default:
-        return defaultValue;
-    }
-  }
-};
-
-var extractDefaultValueFromComments = function extractDefaultValueFromComments(property, value) {
-  var commentValue = value;
-  property.jsdoctags.forEach(function (tag) {
-    if (['default', 'defaultvalue'].includes(tag.tagName.escapedText)) {
-      // @ts-ignore
-      var dom = new window.DOMParser().parseFromString(tag.comment, 'text/html');
-      commentValue = dom.body.textContent;
-    }
-  });
-  return commentValue;
-};
-
-var extractDefaultValue = function extractDefaultValue(property) {
-  try {
-    var _property$defaultValu, _property$jsdoctags;
-
-    var value = (_property$defaultValu = property.defaultValue) === null || _property$defaultValu === void 0 ? void 0 : _property$defaultValu.replace(/^'(.*)'$/, '$1');
-    value = castDefaultValue(property, value);
-
-    if (value == null && ((_property$jsdoctags = property.jsdoctags) === null || _property$jsdoctags === void 0 ? void 0 : _property$jsdoctags.length) > 0) {
-      value = extractDefaultValueFromComments(property, value);
-    }
-
-    return value;
-  } catch (err) {
-    logger.debug("Error extracting ".concat(property.name, ": ").concat(property.defaultValue));
-    return undefined;
-  }
-};
-
-var resolveTypealias = function resolveTypealias(compodocType) {
-  var _compodocJson$miscell3, _compodocJson$miscell4;
-
-  var compodocJson = getCompodocJson();
-  var typeAlias = compodocJson === null || compodocJson === void 0 ? void 0 : (_compodocJson$miscell3 = compodocJson.miscellaneous) === null || _compodocJson$miscell3 === void 0 ? void 0 : (_compodocJson$miscell4 = _compodocJson$miscell3.typealiases) === null || _compodocJson$miscell4 === void 0 ? void 0 : _compodocJson$miscell4.find(function (x) {
-    return x.name === compodocType;
-  });
-  return typeAlias ? resolveTypealias(typeAlias.rawtype) : compodocType;
-};
-
-export var extractArgTypesFromData = function extractArgTypesFromData(componentData) {
-  var sectionToItems = {};
-  var compodocClasses = ['component', 'directive'].includes(componentData.type) ? ['propertiesClass', 'methodsClass', 'inputsClass', 'outputsClass'] : ['properties', 'methods'];
-  compodocClasses.forEach(function (key) {
-    var data = componentData[key] || [];
-    data.forEach(function (item) {
-      var section = mapItemToSection(key, item);
-      var defaultValue = isMethod(item) ? undefined : extractDefaultValue(item);
-      var type = isMethod(item) || section !== 'inputs' && section !== 'properties' ? {
-        name: 'void'
-      } : extractType(item, defaultValue);
-      var action = section === 'outputs' ? {
-        action: item.name
-      } : {};
-      var argType = Object.assign({
-        name: item.name,
-        description: item.rawdescription || item.description,
-        defaultValue: defaultValue,
-        type: type
-      }, action, {
-        table: {
-          category: section,
-          type: {
-            summary: isMethod(item) ? displaySignature(item) : item.type,
-            required: isMethod(item) ? false : !item.optional
-          },
-          defaultValue: {
-            summary: defaultValue
-          }
-        }
-      });
-
-      if (!sectionToItems[section]) {
-        sectionToItems[section] = [];
-      }
-
-      sectionToItems[section].push(argType);
-    });
-  });
-  var SECTIONS = ['properties', 'inputs', 'outputs', 'methods', 'view child', 'view children', 'content child', 'content children'];
-  var argTypes = {};
-  SECTIONS.forEach(function (section) {
-    var items = sectionToItems[section];
-
-    if (items) {
-      items.forEach(function (argType) {
-        argTypes[argType.name] = argType;
-      });
-    }
-  });
-  return argTypes;
-};
-export var extractArgTypes = function extractArgTypes(component) {
-  var componentData = getComponentData(component);
-  return componentData && extractArgTypesFromData(componentData);
-};
-export var extractComponentDescription = function extractComponentDescription(component) {
-  var componentData = getComponentData(component);
-  return componentData && (componentData.rawdescription || componentData.description);
-};

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

@@ -1,18 +0,0 @@
-import { SourceType } from '../../shared';
-import { extractArgTypes, extractComponentDescription } from './compodoc';
-import { sourceDecorator } from './sourceDecorator';
-import { prepareForInline } from './prepareForInline';
-export var parameters = {
-  docs: {
-    // probably set this to true by default once it's battle-tested
-    inlineStories: false,
-    prepareForInline: prepareForInline,
-    extractArgTypes: extractArgTypes,
-    extractComponentDescription: extractComponentDescription,
-    source: {
-      type: SourceType.DYNAMIC,
-      language: 'html'
-    }
-  }
-};
-export var decorators = [sourceDecorator];

package/dist/esm/frameworks/angular/index.js

@@ -1 +0,0 @@
-export * from './compodoc';

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

@@ -1,75 +0,0 @@
-import "regenerator-runtime/runtime.js";
-import "core-js/modules/es.array.concat.js";
-import "core-js/modules/es.promise.js";
-import "core-js/modules/es.object.to-string.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 React from 'react';
-import pLimit from 'p-limit';
-import { nanoid } from 'nanoid';
-import { rendererFactory } from '@storybook/angular/renderer';
-var limit = pLimit(1);
-/**
- * Uses the angular renderer to generate a story. Uses p-limit to run synchronously
- */
-
-export var prepareForInline = function prepareForInline(storyFn, _ref) {
-  var id = _ref.id,
-      parameters = _ref.parameters,
-      component = _ref.component;
-  var el = React.useRef();
-  React.useEffect(function () {
-    _asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee2() {
-      return regeneratorRuntime.wrap(function _callee2$(_context2) {
-        while (1) {
-          switch (_context2.prev = _context2.next) {
-            case 0:
-              limit( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee() {
-                var renderer;
-                return regeneratorRuntime.wrap(function _callee$(_context) {
-                  while (1) {
-                    switch (_context.prev = _context.next) {
-                      case 0:
-                        _context.next = 2;
-                        return rendererFactory.getRendererInstance("".concat(id, "-").concat(nanoid(10)).toLowerCase(), el.current);
-
-                      case 2:
-                        renderer = _context.sent;
-
-                        if (!renderer) {
-                          _context.next = 6;
-                          break;
-                        }
-
-                        _context.next = 6;
-                        return renderer.render({
-                          forced: false,
-                          component: component,
-                          parameters: parameters,
-                          storyFnAngular: storyFn(),
-                          targetDOMNode: el.current
-                        });
-
-                      case 6:
-                      case "end":
-                        return _context.stop();
-                    }
-                  }
-                }, _callee);
-              })));
-
-            case 1:
-            case "end":
-              return _context2.stop();
-          }
-        }
-      }, _callee2);
-    }))();
-  });
-  return /*#__PURE__*/React.createElement('div', {
-    ref: el
-  });
-};

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

@@ -1,116 +0,0 @@
-import "regenerator-runtime/runtime.js";
-import "core-js/modules/es.promise.js";
-import "core-js/modules/es.object.to-string.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 { addons, useEffect } from '@storybook/addons';
-import { computesTemplateSourceFromComponent } from '@storybook/angular/renderer';
-import { SNIPPET_RENDERED, SourceType } from '../../shared';
-export 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; // 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
-
-
-  return (sourceParams === null || sourceParams === void 0 ? void 0 : sourceParams.code) || (sourceParams === null || sourceParams === void 0 ? void 0 : sourceParams.type) === SourceType.CODE;
-};
-var prettyUpInternal;
-
-var makePrettyUp = /*#__PURE__*/function () {
-  var _ref = _asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee() {
-    var prettierHtml, prettier;
-    return regeneratorRuntime.wrap(function _callee$(_context) {
-      while (1) {
-        switch (_context.prev = _context.next) {
-          case 0:
-            if (!prettyUpInternal) {
-              _context.next = 2;
-              break;
-            }
-
-            return _context.abrupt("return", prettyUpInternal);
-
-          case 2:
-            _context.next = 4;
-            return import('prettier/parser-html');
-
-          case 4:
-            prettierHtml = _context.sent;
-            _context.next = 7;
-            return import('prettier/standalone');
-
-          case 7:
-            prettier = _context.sent;
-
-            prettyUpInternal = function prettyUpInternal(source) {
-              return prettier.format(source, {
-                parser: 'angular',
-                plugins: [prettierHtml],
-                htmlWhitespaceSensitivity: 'ignore'
-              });
-            };
-
-            return _context.abrupt("return", prettyUpInternal);
-
-          case 10:
-          case "end":
-            return _context.stop();
-        }
-      }
-    }, _callee);
-  }));
-
-  return function makePrettyUp() {
-    return _ref.apply(this, arguments);
-  };
-}();
-/**
- * Angular source decorator.
- * @param storyFn Fn
- * @param context  StoryContext
- */
-
-
-export var sourceDecorator = function sourceDecorator(storyFn, context) {
-  var story = storyFn();
-
-  if (skipSourceRender(context)) {
-    return story;
-  }
-
-  var channel = addons.getChannel();
-  var props = story.props,
-      template = story.template,
-      userDefinedTemplate = story.userDefinedTemplate;
-  var component = context.component,
-      argTypes = context.argTypes;
-  var toEmit;
-  var prettyUpPromise = makePrettyUp();
-  useEffect(function () {
-    prettyUpPromise.then(function (prettyUp) {
-      if (toEmit) channel.emit(SNIPPET_RENDERED, context.id, prettyUp(toEmit));
-    });
-  });
-  prettyUpPromise.then(function (prettyUp) {
-    if (component && !userDefinedTemplate) {
-      var _source = computesTemplateSourceFromComponent(component, props, argTypes); // We might have a story with a Directive or Service defined as the component
-      // In these cases there might exist a template, even if we aren't able to create source from component
-
-
-      if (_source || template) {
-        toEmit = prettyUp(_source || template);
-      }
-    } else if (template) {
-      toEmit = prettyUp(template);
-    }
-  });
-  return story;
-};

package/dist/esm/frameworks/common/enhanceArgTypes.js

@@ -1,11 +0,0 @@
-import { combineParameters } from '@storybook/store';
-export var enhanceArgTypes = function enhanceArgTypes(context) {
-  var component = context.component,
-      userArgTypes = context.argTypes,
-      _context$parameters$d = context.parameters.docs,
-      docs = _context$parameters$d === void 0 ? {} : _context$parameters$d;
-  var extractArgTypes = docs.extractArgTypes;
-  var extractedArgTypes = extractArgTypes && component ? extractArgTypes(component) : {};
-  var withExtractedTypes = extractedArgTypes ? combineParameters(extractedArgTypes, userArgTypes) : userArgTypes;
-  return withExtractedTypes;
-};

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

@@ -1,8 +0,0 @@
-import { extractArgTypes, extractComponentDescription } from './jsondoc';
-export var parameters = {
-  docs: {
-    iframeHeight: 80,
-    extractArgTypes: extractArgTypes,
-    extractComponentDescription: extractComponentDescription
-  }
-};

package/dist/esm/frameworks/ember/index.js

@@ -1 +0,0 @@
-export { setJSONDoc } from './jsondoc';

package/dist/esm/frameworks/ember/jsondoc.js

@@ -1,66 +0,0 @@
-import "core-js/modules/es.array.find.js";
-import "core-js/modules/es.function.name.js";
-import "core-js/modules/es.symbol.js";
-import "core-js/modules/es.symbol.description.js";
-
-/* eslint-disable no-underscore-dangle */
-
-/* global window */
-export var setJSONDoc = function setJSONDoc(jsondoc) {
-  window.__EMBER_GENERATED_DOC_JSON__ = jsondoc;
-};
-export var getJSONDoc = function getJSONDoc() {
-  return window.__EMBER_GENERATED_DOC_JSON__;
-};
-export var extractArgTypes = function extractArgTypes(componentName) {
-  var json = getJSONDoc();
-
-  if (!(json && json.included)) {
-    return null;
-  }
-
-  var componentDoc = json.included.find(function (doc) {
-    return doc.attributes.name === componentName;
-  });
-
-  if (!componentDoc) {
-    return null;
-  }
-
-  return componentDoc.attributes.arguments.reduce(function (acc, prop) {
-    acc[prop.name] = {
-      name: prop.name,
-      defaultValue: prop.defaultValue,
-      description: prop.description,
-      table: {
-        defaultValue: {
-          summary: prop.defaultValue
-        },
-        type: {
-          summary: prop.type,
-          required: prop.tags.length ? prop.tags.some(function (tag) {
-            return tag.name === 'required';
-          }) : false
-        }
-      }
-    };
-    return acc;
-  }, {});
-};
-export var extractComponentDescription = function extractComponentDescription(componentName) {
-  var json = getJSONDoc();
-
-  if (!(json && json.included)) {
-    return null;
-  }
-
-  var componentDoc = json.included.find(function (doc) {
-    return doc.attributes.name === componentName;
-  });
-
-  if (!componentDoc) {
-    return null;
-  }
-
-  return componentDoc.attributes.description;
-};

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

@@ -1,14 +0,0 @@
-import { sourceDecorator } from './sourceDecorator';
-import { prepareForInline } from './prepareForInline';
-import { SourceType } from '../../shared';
-export var decorators = [sourceDecorator];
-export var parameters = {
-  docs: {
-    inlineStories: true,
-    prepareForInline: prepareForInline,
-    source: {
-      type: SourceType.DYNAMIC,
-      language: 'html'
-    }
-  }
-};

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

@@ -1,19 +0,0 @@
-import React from 'react';
-export function prepareForInline(storyFn) {
-  var html = storyFn();
-
-  if (typeof html === 'string') {
-    // eslint-disable-next-line react/no-danger
-    return /*#__PURE__*/React.createElement("div", {
-      dangerouslySetInnerHTML: {
-        __html: html
-      }
-    });
-  }
-
-  return /*#__PURE__*/React.createElement("div", {
-    ref: function ref(node) {
-      return node ? node.appendChild(html) : null;
-    }
-  });
-}