@storybook/addon-docs 6.5.0-alpha.7 → 6.5.0-beta.1

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

@@ -1,159 +0,0 @@
-"use strict";
-
-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); }
-
-require("core-js/modules/es.weak-map.js");
-
-require("core-js/modules/es.string.iterator.js");
-
-require("core-js/modules/es.array.iterator.js");
-
-require("core-js/modules/web.dom-collections.iterator.js");
-
-require("core-js/modules/es.object.get-own-property-descriptor.js");
-
-require("core-js/modules/es.symbol.js");
-
-require("core-js/modules/es.symbol.description.js");
-
-require("core-js/modules/es.symbol.iterator.js");
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.sourceDecorator = exports.skipSourceRender = void 0;
-
-require("regenerator-runtime/runtime.js");
-
-require("core-js/modules/es.promise.js");
-
-require("core-js/modules/es.object.to-string.js");
-
-var _addons = require("@storybook/addons");
-
-var _renderer = require("@storybook/angular/renderer");
-
-var _shared = require("../../shared");
-
-function _getRequireWildcardCache() { if (typeof WeakMap !== "function") return null; var cache = new WeakMap(); _getRequireWildcardCache = function _getRequireWildcardCache() { return cache; }; return cache; }
-
-function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (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 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); }); }; }
-
-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) === _shared.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) === _shared.SourceType.CODE;
-};
-
-exports.skipSourceRender = skipSourceRender;
-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 Promise.resolve().then(function () {
-              return _interopRequireWildcard(require('prettier/parser-html'));
-            });
-
-          case 4:
-            prettierHtml = _context.sent;
-            _context.next = 7;
-            return Promise.resolve().then(function () {
-              return _interopRequireWildcard(require('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
- */
-
-
-var sourceDecorator = function sourceDecorator(storyFn, context) {
-  var story = storyFn();
-
-  if (skipSourceRender(context)) {
-    return story;
-  }
-
-  var channel = _addons.addons.getChannel();
-
-  var props = story.props,
-      template = story.template,
-      userDefinedTemplate = story.userDefinedTemplate;
-  var component = context.component,
-      argTypes = context.argTypes;
-  var toEmit;
-  var prettyUpPromise = makePrettyUp();
-  (0, _addons.useEffect)(function () {
-    prettyUpPromise.then(function (prettyUp) {
-      if (toEmit) channel.emit(_shared.SNIPPET_RENDERED, context.id, prettyUp(toEmit));
-    });
-  });
-  prettyUpPromise.then(function (prettyUp) {
-    if (component && !userDefinedTemplate) {
-      var _source = (0, _renderer.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;
-};
-
-exports.sourceDecorator = sourceDecorator;

package/dist/cjs/frameworks/angular/types.js

@@ -1 +0,0 @@
-"use strict";

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

@@ -1,21 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.enhanceArgTypes = void 0;
-
-var _store = require("@storybook/store");
-
-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 ? (0, _store.combineParameters)(extractedArgTypes, userArgTypes) : userArgTypes;
-  return withExtractedTypes;
-};
-
-exports.enhanceArgTypes = enhanceArgTypes;

package/dist/cjs/frameworks/common/preset.js

@@ -1,187 +0,0 @@
-"use strict";
-
-require("core-js/modules/es.symbol.js");
-
-require("core-js/modules/es.symbol.description.js");
-
-require("core-js/modules/es.symbol.iterator.js");
-
-require("core-js/modules/es.string.iterator.js");
-
-require("core-js/modules/es.array.iterator.js");
-
-require("core-js/modules/web.dom-collections.iterator.js");
-
-require("core-js/modules/es.array.from.js");
-
-require("core-js/modules/es.array.slice.js");
-
-require("core-js/modules/es.function.name.js");
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.webpack = webpack;
-
-require("core-js/modules/es.array.concat.js");
-
-require("core-js/modules/es.object.assign.js");
-
-require("core-js/modules/es.array.filter.js");
-
-require("core-js/modules/es.object.to-string.js");
-
-require("core-js/modules/es.regexp.to-string.js");
-
-require("core-js/modules/es.regexp.constructor.js");
-
-require("core-js/modules/es.regexp.exec.js");
-
-var _path = _interopRequireDefault(require("path"));
-
-var _remarkSlug = _interopRequireDefault(require("remark-slug"));
-
-var _remarkExternalLinks = _interopRequireDefault(require("remark-external-links"));
-
-var _mdx = require("@storybook/csf-tools/mdx");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-
-function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && Symbol.iterator in Object(iter)) return Array.from(iter); }
-
-function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
-
-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; }
-
-var resolvedBabelLoader = require.resolve('babel-loader', {
-  paths: [require.resolve('@storybook/builder-webpack4')] // FIXME!!!
-
-}); // for frameworks that are not working with react, we need to configure
-// the jsx to transpile mdx, for now there will be a flag for that
-// for more complex solutions we can find alone that we need to add '@babel/plugin-transform-react-jsx'
-
-
-function createBabelOptions(_ref) {
-  var babelOptions = _ref.babelOptions,
-      mdxBabelOptions = _ref.mdxBabelOptions,
-      configureJSX = _ref.configureJSX;
-  var babelPlugins = (mdxBabelOptions === null || mdxBabelOptions === void 0 ? void 0 : mdxBabelOptions.plugins) || (babelOptions === null || babelOptions === void 0 ? void 0 : babelOptions.plugins) || [];
-  var jsxPlugin = [require.resolve('@babel/plugin-transform-react-jsx'), {
-    pragma: 'React.createElement',
-    pragmaFrag: 'React.Fragment'
-  }];
-  var plugins = configureJSX ? [].concat(_toConsumableArray(babelPlugins), [jsxPlugin]) : babelPlugins;
-  return Object.assign({
-    // don't use the root babelrc by default (users can override this in mdxBabelOptions)
-    babelrc: false,
-    configFile: false
-  }, babelOptions, mdxBabelOptions, {
-    plugins: plugins
-  });
-}
-
-function webpack() {
-  var webpackConfig = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-  var _webpackConfig$module = webpackConfig.module,
-      module = _webpackConfig$module === void 0 ? {} : _webpackConfig$module; // it will reuse babel options that are already in use in storybook
-  // also, these babel options are chained with other presets.
-
-  var babelOptions = options.babelOptions,
-      mdxBabelOptions = options.mdxBabelOptions,
-      _options$configureJSX = options.configureJSX,
-      configureJSX = _options$configureJSX === void 0 ? true : _options$configureJSX,
-      _options$sourceLoader = options.sourceLoaderOptions,
-      sourceLoaderOptions = _options$sourceLoader === void 0 ? {
-    injectStoryParameters: true
-  } : _options$sourceLoader,
-      _options$transcludeMa = options.transcludeMarkdown,
-      transcludeMarkdown = _options$transcludeMa === void 0 ? false : _options$transcludeMa;
-  var mdxLoaderOptions = {
-    remarkPlugins: [_remarkSlug.default, _remarkExternalLinks.default]
-  }; // set `sourceLoaderOptions` to `null` to disable for manual configuration
-
-  var sourceLoader = sourceLoaderOptions ? [{
-    test: /\.(stories|story)\.[tj]sx?$/,
-    loader: require.resolve('@storybook/source-loader'),
-    options: Object.assign({}, sourceLoaderOptions, {
-      inspectLocalDependencies: true
-    }),
-    enforce: 'pre'
-  }] : [];
-  var rules = module.rules || [];
-
-  if (transcludeMarkdown) {
-    rules = [].concat(_toConsumableArray(rules.filter(function (rule) {
-      var _rule$test;
-
-      return ((_rule$test = rule.test) === null || _rule$test === void 0 ? void 0 : _rule$test.toString()) !== '/\\.md$/';
-    })), [{
-      test: /\.md$/,
-      use: [{
-        loader: resolvedBabelLoader,
-        options: createBabelOptions({
-          babelOptions: babelOptions,
-          mdxBabelOptions: mdxBabelOptions,
-          configureJSX: configureJSX
-        })
-      }, {
-        loader: require.resolve('@mdx-js/loader'),
-        options: mdxLoaderOptions
-      }]
-    }]);
-  }
-
-  var result = Object.assign({}, webpackConfig, {
-    module: Object.assign({}, module, {
-      rules: [].concat(_toConsumableArray(rules), [{
-        test: /\.js$/,
-        include: new RegExp("node_modules\\".concat(_path.default.sep, "acorn-jsx")),
-        use: [{
-          loader: resolvedBabelLoader,
-          options: {
-            presets: [[require.resolve('@babel/preset-env'), {
-              modules: 'commonjs'
-            }]]
-          }
-        }]
-      }, {
-        test: /(stories|story)\.mdx$/,
-        use: [{
-          loader: resolvedBabelLoader,
-          options: createBabelOptions({
-            babelOptions: babelOptions,
-            mdxBabelOptions: mdxBabelOptions,
-            configureJSX: configureJSX
-          })
-        }, {
-          loader: require.resolve('@mdx-js/loader'),
-          options: Object.assign({
-            compilers: [(0, _mdx.createCompiler)(options)]
-          }, mdxLoaderOptions)
-        }]
-      }, {
-        test: /\.mdx$/,
-        exclude: /(stories|story)\.mdx$/,
-        use: [{
-          loader: resolvedBabelLoader,
-          options: createBabelOptions({
-            babelOptions: babelOptions,
-            mdxBabelOptions: mdxBabelOptions,
-            configureJSX: configureJSX
-          })
-        }, {
-          loader: require.resolve('@mdx-js/loader'),
-          options: mdxLoaderOptions
-        }]
-      }], sourceLoader)
-    })
-  });
-  return result;
-}

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

@@ -1,17 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.parameters = void 0;
-
-var _jsondoc = require("./jsondoc");
-
-var parameters = {
-  docs: {
-    iframeHeight: 80,
-    extractArgTypes: _jsondoc.extractArgTypes,
-    extractComponentDescription: _jsondoc.extractComponentDescription
-  }
-};
-exports.parameters = parameters;

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

@@ -1,13 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "setJSONDoc", {
-  enumerable: true,
-  get: function get() {
-    return _jsondoc.setJSONDoc;
-  }
-});
-
-var _jsondoc = require("./jsondoc");

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

@@ -1,87 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.extractComponentDescription = exports.extractArgTypes = exports.getJSONDoc = exports.setJSONDoc = void 0;
-
-require("core-js/modules/es.array.find.js");
-
-require("core-js/modules/es.function.name.js");
-
-require("core-js/modules/es.symbol.js");
-
-require("core-js/modules/es.symbol.description.js");
-
-/* eslint-disable no-underscore-dangle */
-
-/* global window */
-var setJSONDoc = function setJSONDoc(jsondoc) {
-  window.__EMBER_GENERATED_DOC_JSON__ = jsondoc;
-};
-
-exports.setJSONDoc = setJSONDoc;
-
-var getJSONDoc = function getJSONDoc() {
-  return window.__EMBER_GENERATED_DOC_JSON__;
-};
-
-exports.getJSONDoc = getJSONDoc;
-
-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;
-  }, {});
-};
-
-exports.extractArgTypes = extractArgTypes;
-
-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;
-};
-
-exports.extractComponentDescription = extractComponentDescription;

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

@@ -1,26 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.parameters = exports.decorators = void 0;
-
-var _sourceDecorator = require("./sourceDecorator");
-
-var _prepareForInline = require("./prepareForInline");
-
-var _shared = require("../../shared");
-
-var decorators = [_sourceDecorator.sourceDecorator];
-exports.decorators = decorators;
-var parameters = {
-  docs: {
-    inlineStories: true,
-    prepareForInline: _prepareForInline.prepareForInline,
-    source: {
-      type: _shared.SourceType.DYNAMIC,
-      language: 'html'
-    }
-  }
-};
-exports.parameters = parameters;

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

@@ -1,29 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.prepareForInline = prepareForInline;
-
-var _react = _interopRequireDefault(require("react"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-function prepareForInline(storyFn) {
-  var html = storyFn();
-
-  if (typeof html === 'string') {
-    // eslint-disable-next-line react/no-danger
-    return /*#__PURE__*/_react.default.createElement("div", {
-      dangerouslySetInnerHTML: {
-        __html: html
-      }
-    });
-  }
-
-  return /*#__PURE__*/_react.default.createElement("div", {
-    ref: function ref(node) {
-      return node ? node.appendChild(html) : null;
-    }
-  });
-}

package/dist/cjs/frameworks/html/sourceDecorator.js

@@ -1,67 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.sourceDecorator = sourceDecorator;
-
-var _addons = require("@storybook/addons");
-
-var _tsDedent = _interopRequireDefault(require("ts-dedent"));
-
-var _shared = require("../../shared");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-/* global window */
-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) === _shared.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) === _shared.SourceType.CODE;
-} // By default, just remove indentation
-
-
-function defaultTransformSource(source) {
-  // Have to wrap dedent so it doesn't serialize the context
-  return (0, _tsDedent.default)(source);
-}
-
-function applyTransformSource(source, context) {
-  var _context$parameters$d2, _docs$transformSource;
-
-  var docs = (_context$parameters$d2 = context.parameters.docs) !== null && _context$parameters$d2 !== void 0 ? _context$parameters$d2 : {};
-  var transformSource = (_docs$transformSource = docs.transformSource) !== null && _docs$transformSource !== void 0 ? _docs$transformSource : defaultTransformSource;
-  return transformSource(source, context);
-}
-
-function sourceDecorator(storyFn, context) {
-  var _context$parameters$d3, _context$parameters$d4;
-
-  var story = context !== null && context !== void 0 && (_context$parameters$d3 = context.parameters.docs) !== null && _context$parameters$d3 !== void 0 && (_context$parameters$d4 = _context$parameters$d3.source) !== null && _context$parameters$d4 !== void 0 && _context$parameters$d4.excludeDecorators ? context.originalStoryFn(context.args, context) : storyFn();
-  var source;
-
-  if (!skipSourceRender(context)) {
-    if (typeof story === 'string') {
-      source = story;
-    } // eslint-disable-next-line no-undef
-    else if (story instanceof Element) {
-        source = story.outerHTML;
-      }
-
-    if (source) source = applyTransformSource(source, context);
-  }
-
-  (0, _addons.useEffect)(function () {
-    if (source) _addons.addons.getChannel().emit(_shared.SNIPPET_RENDERED, context.id, source);
-  });
-  return story;
-}

package/dist/cjs/frameworks/react/config.js

@@ -1,27 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.decorators = exports.parameters = void 0;
-
-var _extractArgTypes = require("./extractArgTypes");
-
-var _docgen = require("../../lib/docgen");
-
-var _jsxDecorator = require("./jsxDecorator");
-
-var parameters = {
-  docs: {
-    inlineStories: true,
-    // NOTE: that the result is a react element. Hooks support is provided by the outer code.
-    prepareForInline: function prepareForInline(storyFn) {
-      return storyFn();
-    },
-    extractArgTypes: _extractArgTypes.extractArgTypes,
-    extractComponentDescription: _docgen.extractComponentDescription
-  }
-};
-exports.parameters = parameters;
-var decorators = [_jsxDecorator.jsxDecorator];
-exports.decorators = decorators;