@storybook/addon-docs 6.5.0-alpha.46 → 6.5.0-alpha.49

package/dist/esm/lib/convert/typescript/convert.js

@@ -1,71 +0,0 @@
-import "core-js/modules/es.object.to-string.js";
-import "core-js/modules/web.dom-collections.for-each.js";
-import "core-js/modules/es.function.name.js";
-import "core-js/modules/es.object.assign.js";
-import "core-js/modules/es.array.map.js";
-
-/* eslint-disable no-case-declarations */
-var convertSig = function convertSig(type) {
-  switch (type.type) {
-    case 'function':
-      return {
-        name: 'function'
-      };
-
-    case 'object':
-      var values = {};
-      type.signature.properties.forEach(function (prop) {
-        values[prop.key] = convert(prop.value);
-      });
-      return {
-        name: 'object',
-        value: values
-      };
-
-    default:
-      throw new Error("Unknown: ".concat(type));
-  }
-};
-
-export var convert = function convert(type) {
-  var name = type.name,
-      raw = type.raw;
-  var base = {};
-  if (typeof raw !== 'undefined') base.raw = raw;
-
-  switch (type.name) {
-    case 'string':
-    case 'number':
-    case 'symbol':
-    case 'boolean':
-      {
-        return Object.assign({}, base, {
-          name: name
-        });
-      }
-
-    case 'Array':
-      {
-        return Object.assign({}, base, {
-          name: 'array',
-          value: type.elements.map(convert)
-        });
-      }
-
-    case 'signature':
-      return Object.assign({}, base, convertSig(type));
-
-    case 'union':
-    case 'intersection':
-      return Object.assign({}, base, {
-        name: name,
-        value: type.elements.map(convert)
-      });
-
-    default:
-      return Object.assign({}, base, {
-        name: 'other',
-        value: name
-      });
-  }
-};

package/dist/esm/lib/convert/typescript/index.js

@@ -1,2 +0,0 @@
-export * from './convert';
-export * from './types';

package/dist/esm/lib/convert/utils.js

@@ -1,9 +0,0 @@
-import "core-js/modules/es.regexp.exec.js";
-import "core-js/modules/es.string.replace.js";
-var QUOTE_REGEX = /^['"]|['"]$/g;
-export var trimQuotes = function trimQuotes(str) {
-  return str.replace(QUOTE_REGEX, '');
-};
-export var includesQuotes = function includesQuotes(str) {
-  return QUOTE_REGEX.test(str);
-};

package/dist/esm/lib/docgen/createPropDef.js

@@ -1,142 +0,0 @@
-import "core-js/modules/es.function.name.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.array.map.js";
-import { TypeSystem } from './types';
-import { createSummaryValue } from '../utils';
-import { createFlowPropDef } from './flow/createPropDef';
-import { isDefaultValueBlacklisted } from './utils/defaultValue';
-import { createTsPropDef } from './typeScript/createPropDef';
-import { convert } from '../convert';
-
-function createType(type) {
-  // A type could be null if a defaultProp has been provided without a type definition.
-  return type != null ? createSummaryValue(type.name) : null;
-} // A heuristic to tell if a defaultValue comes from RDT
-
-
-function isReactDocgenTypescript(defaultValue) {
-  var computed = defaultValue.computed,
-      func = defaultValue.func;
-  return typeof computed === 'undefined' && typeof func === 'undefined';
-}
-
-function isStringValued(type) {
-  if (!type) {
-    return false;
-  }
-
-  if (type.name === 'string') {
-    return true;
-  }
-
-  if (type.name === 'enum') {
-    return Array.isArray(type.value) && type.value.every(function (_ref) {
-      var tv = _ref.value;
-      return typeof tv === 'string' && tv[0] === '"' && tv[tv.length - 1] === '"';
-    });
-  }
-
-  return false;
-}
-
-function createDefaultValue(defaultValue, type) {
-  if (defaultValue != null) {
-    var value = defaultValue.value;
-
-    if (!isDefaultValueBlacklisted(value)) {
-      // Work around a bug in `react-docgen-typescript-loader`, which returns 'string' for a string
-      // default, instead of "'string'" -- which is incorrect
-      if (isReactDocgenTypescript(defaultValue) && isStringValued(type)) {
-        return createSummaryValue(JSON.stringify(value));
-      }
-
-      return createSummaryValue(value);
-    }
-  }
-
-  return null;
-}
-
-function createBasicPropDef(name, type, docgenInfo) {
-  var description = docgenInfo.description,
-      required = docgenInfo.required,
-      defaultValue = docgenInfo.defaultValue;
-  return {
-    name: name,
-    type: createType(type),
-    required: required,
-    description: description,
-    defaultValue: createDefaultValue(defaultValue, type)
-  };
-}
-
-function applyJsDocResult(propDef, jsDocParsingResult) {
-  if (jsDocParsingResult.includesJsDoc) {
-    var description = jsDocParsingResult.description,
-        extractedTags = jsDocParsingResult.extractedTags;
-
-    if (description != null) {
-      // eslint-disable-next-line no-param-reassign
-      propDef.description = jsDocParsingResult.description;
-    }
-
-    var hasParams = extractedTags.params != null;
-    var hasReturns = extractedTags.returns != null && extractedTags.returns.type != null;
-
-    if (hasParams || hasReturns) {
-      // eslint-disable-next-line no-param-reassign
-      propDef.jsDocTags = {
-        params: hasParams && extractedTags.params.map(function (x) {
-          return {
-            name: x.getPrettyName(),
-            description: x.description
-          };
-        }),
-        returns: hasReturns && {
-          description: extractedTags.returns.description
-        }
-      };
-    }
-  }
-
-  return propDef;
-}
-
-export var javaScriptFactory = function javaScriptFactory(propName, docgenInfo, jsDocParsingResult) {
-  var propDef = createBasicPropDef(propName, docgenInfo.type, docgenInfo);
-  propDef.sbType = convert(docgenInfo);
-  return applyJsDocResult(propDef, jsDocParsingResult);
-};
-export var tsFactory = function tsFactory(propName, docgenInfo, jsDocParsingResult) {
-  var propDef = createTsPropDef(propName, docgenInfo);
-  propDef.sbType = convert(docgenInfo);
-  return applyJsDocResult(propDef, jsDocParsingResult);
-};
-export var flowFactory = function flowFactory(propName, docgenInfo, jsDocParsingResult) {
-  var propDef = createFlowPropDef(propName, docgenInfo);
-  propDef.sbType = convert(docgenInfo);
-  return applyJsDocResult(propDef, jsDocParsingResult);
-};
-export var unknownFactory = function unknownFactory(propName, docgenInfo, jsDocParsingResult) {
-  var propDef = createBasicPropDef(propName, {
-    name: 'unknown'
-  }, docgenInfo);
-  return applyJsDocResult(propDef, jsDocParsingResult);
-};
-export var getPropDefFactory = function getPropDefFactory(typeSystem) {
-  switch (typeSystem) {
-    case TypeSystem.JAVASCRIPT:
-      return javaScriptFactory;
-
-    case TypeSystem.TYPESCRIPT:
-      return tsFactory;
-
-    case TypeSystem.FLOW:
-      return flowFactory;
-
-    default:
-      return unknownFactory;
-  }
-};

package/dist/esm/lib/docgen/extractDocgenProps.js

@@ -1,88 +0,0 @@
-import "core-js/modules/es.array.map.js";
-import "core-js/modules/es.object.assign.js";
-import "core-js/modules/es.function.name.js";
-import "core-js/modules/es.object.keys.js";
-import "core-js/modules/es.array.filter.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 { parseJsDoc } from '../jsdocParser';
-import { TypeSystem } from './types';
-import { getDocgenSection, isValidDocgenSection, getDocgenDescription } from './utils';
-import { getPropDefFactory } from './createPropDef';
-
-var getTypeSystem = function getTypeSystem(docgenInfo) {
-  if (docgenInfo.type != null) {
-    return TypeSystem.JAVASCRIPT;
-  }
-
-  if (docgenInfo.flowType != null) {
-    return TypeSystem.FLOW;
-  }
-
-  if (docgenInfo.tsType != null) {
-    return TypeSystem.TYPESCRIPT;
-  }
-
-  return TypeSystem.UNKNOWN;
-};
-
-export var extractComponentSectionArray = function extractComponentSectionArray(docgenSection) {
-  var typeSystem = getTypeSystem(docgenSection[0]);
-  var createPropDef = getPropDefFactory(typeSystem);
-  return docgenSection.map(function (item) {
-    var _item$type;
-
-    var sanitizedItem = item;
-
-    if ((_item$type = item.type) !== null && _item$type !== void 0 && _item$type.elements) {
-      sanitizedItem = Object.assign({}, item, {
-        type: Object.assign({}, item.type, {
-          value: item.type.elements
-        })
-      });
-    }
-
-    return extractProp(sanitizedItem.name, sanitizedItem, typeSystem, createPropDef);
-  });
-};
-export var extractComponentSectionObject = function extractComponentSectionObject(docgenSection) {
-  var docgenPropsKeys = Object.keys(docgenSection);
-  var typeSystem = getTypeSystem(docgenSection[docgenPropsKeys[0]]);
-  var createPropDef = getPropDefFactory(typeSystem);
-  return docgenPropsKeys.map(function (propName) {
-    var docgenInfo = docgenSection[propName];
-    return docgenInfo != null ? extractProp(propName, docgenInfo, typeSystem, createPropDef) : null;
-  }).filter(Boolean);
-};
-export var extractComponentProps = function extractComponentProps(component, section) {
-  var docgenSection = getDocgenSection(component, section);
-
-  if (!isValidDocgenSection(docgenSection)) {
-    return [];
-  } // vue-docgen-api has diverged from react-docgen and returns an array
-
-
-  return Array.isArray(docgenSection) ? extractComponentSectionArray(docgenSection) : extractComponentSectionObject(docgenSection);
-};
-
-function extractProp(propName, docgenInfo, typeSystem, createPropDef) {
-  var jsDocParsingResult = parseJsDoc(docgenInfo.description);
-  var isIgnored = jsDocParsingResult.includesJsDoc && jsDocParsingResult.ignore;
-
-  if (!isIgnored) {
-    var propDef = createPropDef(propName, docgenInfo, jsDocParsingResult);
-    return {
-      propDef: propDef,
-      jsDocTags: jsDocParsingResult.extractedTags,
-      docgenInfo: docgenInfo,
-      typeSystem: typeSystem
-    };
-  }
-
-  return null;
-}
-
-export function extractComponentDescription(component) {
-  return component != null && getDocgenDescription(component);
-}

package/dist/esm/lib/docgen/flow/createDefaultValue.js

@@ -1,14 +0,0 @@
-import "core-js/modules/es.function.name.js";
-import { createSummaryValue, isTooLongForDefaultValueSummary } from '../../utils';
-import { isDefaultValueBlacklisted } from '../utils/defaultValue';
-export function createDefaultValue(defaultValue, type) {
-  if (defaultValue != null) {
-    var value = defaultValue.value;
-
-    if (!isDefaultValueBlacklisted(value)) {
-      return !isTooLongForDefaultValueSummary(value) ? createSummaryValue(value) : createSummaryValue(type.name, value);
-    }
-  }
-
-  return null;
-}

package/dist/esm/lib/docgen/flow/createPropDef.js

@@ -1,17 +0,0 @@
-import "core-js/modules/es.symbol.js";
-import "core-js/modules/es.symbol.description.js";
-import { createType } from './createType';
-import { createDefaultValue } from './createDefaultValue';
-export var createFlowPropDef = function createFlowPropDef(propName, docgenInfo) {
-  var flowType = docgenInfo.flowType,
-      description = docgenInfo.description,
-      required = docgenInfo.required,
-      defaultValue = docgenInfo.defaultValue;
-  return {
-    name: propName,
-    type: createType(flowType),
-    required: required,
-    description: description,
-    defaultValue: createDefaultValue(defaultValue, flowType)
-  };
-};

package/dist/esm/lib/docgen/flow/createType.js

@@ -1,106 +0,0 @@
-import "core-js/modules/es.function.name.js";
-import "core-js/modules/es.array.join.js";
-import "core-js/modules/es.array.map.js";
-import "core-js/modules/es.regexp.exec.js";
-import "core-js/modules/es.string.replace.js";
-import { createSummaryValue, isTooLongForTypeSummary } from '../../utils';
-var FlowTypesType;
-
-(function (FlowTypesType) {
-  FlowTypesType["UNION"] = "union";
-  FlowTypesType["SIGNATURE"] = "signature";
-})(FlowTypesType || (FlowTypesType = {}));
-
-function generateUnionElement(_ref) {
-  var name = _ref.name,
-      value = _ref.value,
-      elements = _ref.elements,
-      raw = _ref.raw;
-
-  if (value != null) {
-    return value;
-  }
-
-  if (elements != null) {
-    return elements.map(generateUnionElement).join(' | ');
-  }
-
-  if (raw != null) {
-    return raw;
-  }
-
-  return name;
-}
-
-function generateUnion(_ref2) {
-  var name = _ref2.name,
-      raw = _ref2.raw,
-      elements = _ref2.elements;
-
-  if (elements != null) {
-    return createSummaryValue(elements.map(generateUnionElement).join(' | '));
-  }
-
-  if (raw != null) {
-    // Flow Unions can be defined with or without a leading `|` character, so try to remove it.
-    return createSummaryValue(raw.replace(/^\|\s*/, ''));
-  }
-
-  return createSummaryValue(name);
-}
-
-function generateFuncSignature(_ref3) {
-  var type = _ref3.type,
-      raw = _ref3.raw;
-
-  if (raw != null) {
-    return createSummaryValue(raw);
-  }
-
-  return createSummaryValue(type);
-}
-
-function generateObjectSignature(_ref4) {
-  var type = _ref4.type,
-      raw = _ref4.raw;
-
-  if (raw != null) {
-    return !isTooLongForTypeSummary(raw) ? createSummaryValue(raw) : createSummaryValue(type, raw);
-  }
-
-  return createSummaryValue(type);
-}
-
-function generateSignature(flowType) {
-  var type = flowType.type;
-  return type === 'object' ? generateObjectSignature(flowType) : generateFuncSignature(flowType);
-}
-
-function generateDefault(_ref5) {
-  var name = _ref5.name,
-      raw = _ref5.raw;
-
-  if (raw != null) {
-    return !isTooLongForTypeSummary(raw) ? createSummaryValue(raw) : createSummaryValue(name, raw);
-  }
-
-  return createSummaryValue(name);
-}
-
-export function createType(type) {
-  // A type could be null if a defaultProp has been provided without a type definition.
-  if (type == null) {
-    return null;
-  }
-
-  switch (type.name) {
-    case FlowTypesType.UNION:
-      return generateUnion(type);
-
-    case FlowTypesType.SIGNATURE:
-      return generateSignature(type);
-
-    default:
-      return generateDefault(type);
-  }
-}

package/dist/esm/lib/docgen/index.js

@@ -1,3 +0,0 @@
-export * from './types';
-export * from './utils';
-export * from './extractDocgenProps';

package/dist/esm/lib/docgen/typeScript/createDefaultValue.js

@@ -1,15 +0,0 @@
-import { createSummaryValue } from '../../utils';
-import { isDefaultValueBlacklisted } from '../utils/defaultValue';
-export function createDefaultValue(_ref) {
-  var defaultValue = _ref.defaultValue;
-
-  if (defaultValue != null) {
-    var value = defaultValue.value;
-
-    if (!isDefaultValueBlacklisted(value)) {
-      return createSummaryValue(value);
-    }
-  }
-
-  return null;
-}

package/dist/esm/lib/docgen/typeScript/createPropDef.js

@@ -1,15 +0,0 @@
-import "core-js/modules/es.symbol.js";
-import "core-js/modules/es.symbol.description.js";
-import { createType } from './createType';
-import { createDefaultValue } from './createDefaultValue';
-export var createTsPropDef = function createTsPropDef(propName, docgenInfo) {
-  var description = docgenInfo.description,
-      required = docgenInfo.required;
-  return {
-    name: propName,
-    type: createType(docgenInfo),
-    required: required,
-    description: description,
-    defaultValue: createDefaultValue(docgenInfo)
-  };
-};

package/dist/esm/lib/docgen/typeScript/createType.js

@@ -1,19 +0,0 @@
-import "core-js/modules/es.regexp.exec.js";
-import "core-js/modules/es.string.replace.js";
-import "core-js/modules/es.function.name.js";
-import { createSummaryValue } from '../../utils';
-export function createType(_ref) {
-  var tsType = _ref.tsType,
-      required = _ref.required;
-
-  // A type could be null if a defaultProp has been provided without a type definition.
-  if (tsType == null) {
-    return null;
-  }
-
-  if (!required) {
-    return createSummaryValue(tsType.name.replace(' | undefined', ''));
-  }
-
-  return createSummaryValue(tsType.name);
-}

package/dist/esm/lib/docgen/types.js

@@ -1,10 +0,0 @@
-// eslint-disable-next-line @typescript-eslint/no-empty-interface
-// export type DocgenType = DocgenPropType | DocgenFlowType | DocgenTypeScriptType;
-export var TypeSystem;
-
-(function (TypeSystem) {
-  TypeSystem["JAVASCRIPT"] = "JavaScript";
-  TypeSystem["FLOW"] = "Flow";
-  TypeSystem["TYPESCRIPT"] = "TypeScript";
-  TypeSystem["UNKNOWN"] = "Unknown";
-})(TypeSystem || (TypeSystem = {}));

package/dist/esm/lib/docgen/utils/defaultValue.js

@@ -1,7 +0,0 @@
-import "core-js/modules/es.object.to-string.js";
-var BLACKLIST = ['null', 'undefined'];
-export function isDefaultValueBlacklisted(value) {
-  return BLACKLIST.some(function (x) {
-    return x === value;
-  });
-}

package/dist/esm/lib/docgen/utils/docgenInfo.js

@@ -1,18 +0,0 @@
-import "core-js/modules/es.object.keys.js";
-import "core-js/modules/es.symbol.js";
-import "core-js/modules/es.symbol.description.js";
-
-/* eslint-disable no-underscore-dangle */
-import { str } from './string';
-export function hasDocgen(component) {
-  return !!component.__docgenInfo;
-}
-export function isValidDocgenSection(docgenSection) {
-  return docgenSection != null && Object.keys(docgenSection).length > 0;
-}
-export function getDocgenSection(component, section) {
-  return hasDocgen(component) ? component.__docgenInfo[section] : null;
-}
-export function getDocgenDescription(component) {
-  return hasDocgen(component) && str(component.__docgenInfo.description);
-}

package/dist/esm/lib/docgen/utils/index.js

@@ -1,3 +0,0 @@
-export * from './defaultValue';
-export * from './string';
-export * from './docgenInfo';

package/dist/esm/lib/docgen/utils/string.js

@@ -1,11 +0,0 @@
-export var str = function str(obj) {
-  if (!obj) {
-    return '';
-  }
-
-  if (typeof obj === 'string') {
-    return obj;
-  }
-
-  throw new Error("Description: expected string, got: ".concat(JSON.stringify(obj)));
-};

package/dist/esm/lib/index.js

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