@apify/docusaurus-plugin-typedoc-api 4.2.10 → 4.2.11-1

package/lib/plugin/python/transformation.js

@@ -0,0 +1,359 @@
+'use strict';
+
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+const consts = require('./consts.js');
+const inheritance = require('./inheritance.js');
+const index = require('./type-parsing/index.js');
+const utils = require('./utils.js');
+class DocspecTransformer {
+  pythonTypeResolver;
+  symbolIdMap = {};
+  namesToIds = {};
+  moduleShortcuts;
+
+  /**
+   * Maps the name of the class to the list of Typedoc objects representing the classes that extend it.
+   *
+   * This is used for resolving the references to the base classes - in case the base class is encountered after the class that extends it.
+   */
+  forwardAncestorRefs = new Map();
+
+  /**
+   * Maps the name of the class to the reference to the Typedoc object representing the class.
+   *
+   * This is used to resolve the references to the base classes of a class using the name.
+   */
+  backwardAncestorRefs = new Map();
+
+  /**
+   * Stack of the docstrings of the current context.
+   *
+   * Used to read the class Google-style docstrings from the class' properties and methods.
+   */
+  contextStack = [];
+  settings = {
+    useDocsGroup: false
+  };
+  constructor({
+    moduleShortcuts
+  }) {
+    this.pythonTypeResolver = new index.PythonTypeResolver();
+    this.moduleShortcuts = moduleShortcuts ?? {};
+  }
+  transform(docspecModules) {
+    // Root object of the Typedoc structure, accumulator for the recursive walk
+    const typedocApiReference = {
+      children: [],
+      flags: {},
+      groups: [],
+      id: 0,
+      kind: 1,
+      kindString: 'Project',
+      name: 'apify-client',
+      sources: [{
+        character: 0,
+        fileName: 'src/index.ts',
+        line: 1
+      }],
+      symbolIdMap: this.symbolIdMap
+    };
+    this.settings.useDocsGroup = utils.projectUsesDocsGroupDecorator(docspecModules);
+
+    // Convert all the modules, store them in the root object
+    for (const module of docspecModules) {
+      this.walkAndTransform({
+        currentDocspecNode: module,
+        moduleName: module.name,
+        parentTypeDoc: typedocApiReference
+      });
+    }
+    this.pythonTypeResolver.resolveTypes();
+    this.namesToIds = Object.entries(this.symbolIdMap).reduce((acc, [id, {
+      qualifiedName
+    }]) => {
+      acc[qualifiedName] = Number(id);
+      return acc;
+    }, {});
+    this.fixRefs(typedocApiReference);
+    this.sortChildren(typedocApiReference);
+    return typedocApiReference;
+  }
+  getContext() {
+    return this.contextStack[this.contextStack.length - 1];
+  }
+  popContext() {
+    this.contextStack.pop();
+  }
+  newContext(context) {
+    this.contextStack.push(context);
+  }
+
+  /**
+   * Recursively traverse the Typedoc structure and fix the references to the named entities.
+   *
+   * Searches for the {@link TypeDocType} structure with the `type` property set to `reference`, and replaces the `target` property
+   * with the corresponding ID of the named entity.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  fixRefs(obj) {
+    for (const key of Object.keys(obj)) {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+      if (key === 'name' && obj?.type === 'reference' && this.namesToIds[obj?.name]) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+        obj.target = this.namesToIds[obj?.name];
+      }
+      if (typeof obj[key] === 'object' && obj[key] !== null) {
+        this.fixRefs(obj[key]);
+      }
+    }
+  }
+
+  /**
+   * Given a docspec object outputted by `pydoc-markdown`, transforms this object into the Typedoc structure,
+   * and appends it as a child of the `parentTypeDoc` Typedoc object (which serves as an accumulator for the recursion).
+   * @param obj
+   * @param parent
+   * @param module
+   */
+  walkAndTransform({
+    currentDocspecNode,
+    parentTypeDoc,
+    moduleName
+  }) {
+    if (utils.isHidden(currentDocspecNode)) {
+      for (const docspecMember of currentDocspecNode.members ?? []) {
+        this.walkAndTransform({
+          currentDocspecNode: docspecMember,
+          moduleName,
+          // Skips the hidden member, i.e. its children will be appended to the parent of the hidden member
+          parentTypeDoc
+        });
+      }
+      return;
+    }
+    const _this$getTypedocType = this.getTypedocType(currentDocspecNode, parentTypeDoc),
+      typedocType = _this$getTypedocType.typedocType,
+      typedocKind = _this$getTypedocType.typedocKind;
+    const _this$getGitHubUrls = this.getGitHubUrls(currentDocspecNode),
+      filePathInRepo = _this$getGitHubUrls.filePathInRepo;
+    const docstring = this.parseDocstring(currentDocspecNode);
+    const currentId = utils.getOID();
+    this.symbolIdMap[currentId] = {
+      qualifiedName: currentDocspecNode.name,
+      sourceFileName: filePathInRepo
+    };
+
+    // Get the module name of the member, and check if it has a shortcut (reexport from an ancestor module)
+    const fullName = `${moduleName}.${currentDocspecNode.name}`;
+    if (fullName in this.moduleShortcuts) {
+      moduleName = this.moduleShortcuts[fullName].replace(`.${currentDocspecNode.name}`, '');
+    }
+    currentDocspecNode.name = currentDocspecNode.decorations?.find(d => d.name === 'docs_name')?.args.slice(2, -2) ?? currentDocspecNode.name;
+
+    // Create the Typedoc member object
+    const currentTypedocNode = _objectSpread(_objectSpread({}, typedocKind), {}, {
+      children: [],
+      comment: docstring ? {
+        summary: [{
+          kind: 'text',
+          text: docstring.text
+        }]
+      } : undefined,
+      decorations: currentDocspecNode.decorations?.map(({
+        name,
+        args
+      }) => ({
+        args,
+        name
+      })),
+      flags: {},
+      groups: [],
+      id: currentId,
+      module: moduleName,
+      // This is an extension to the original Typedoc structure, to support showing where the member is exported from
+      name: currentDocspecNode.name,
+      sources: [{
+        character: 1,
+        fileName: filePathInRepo,
+        line: currentDocspecNode.location.lineno
+      }],
+      type: typedocType
+    });
+    if (currentTypedocNode.kindString === 'Method') {
+      currentTypedocNode.signatures = [{
+        comment: docstring.text ? {
+          blockTags: docstring?.returns ? [{
+            content: [{
+              kind: 'text',
+              text: docstring.returns
+            }],
+            tag: '@returns'
+          }] : undefined,
+          summary: [{
+            kind: 'text',
+            text: docstring?.text
+          }]
+        } : undefined,
+        flags: {},
+        id: utils.getOID(),
+        kind: 4096,
+        kindString: 'Call signature',
+        modifiers: currentDocspecNode.modifiers ?? [],
+        name: currentDocspecNode.name,
+        parameters: currentDocspecNode.args?.filter(arg => arg.name !== 'self' && arg.name !== 'cls').map(arg => ({
+          comment: docstring.args?.[arg.name] ? {
+            summary: [{
+              kind: 'text',
+              text: docstring.args[arg.name]
+            }]
+          } : undefined,
+          defaultValue: arg.default_value,
+          flags: {
+            isOptional: arg.datatype?.includes('Optional'),
+            'keyword-only': arg.type === 'KEYWORD_ONLY'
+          },
+          id: utils.getOID(),
+          kind: 32_768,
+          kindString: 'Parameter',
+          name: arg.name,
+          type: this.pythonTypeResolver.registerType(arg.datatype)
+        })),
+        type: this.pythonTypeResolver.registerType(currentDocspecNode.return_type)
+      }];
+    }
+    if (currentTypedocNode.kindString === 'Class') {
+      this.newContext(docstring);
+    }
+    for (const docspecMember of currentDocspecNode.members ?? []) {
+      this.walkAndTransform({
+        currentDocspecNode: docspecMember,
+        moduleName,
+        parentTypeDoc: currentTypedocNode
+      });
+    }
+    if (currentTypedocNode.kindString === 'Class') {
+      this.popContext();
+      if (currentDocspecNode.bases && currentDocspecNode.bases.length > 0) {
+        for (const base of currentDocspecNode.bases) {
+          const canonicalAncestorType = this.pythonTypeResolver.getBaseType(base);
+          const baseTypedocMember = this.backwardAncestorRefs.get(canonicalAncestorType);
+          if (baseTypedocMember) {
+            inheritance.resolveInheritedSymbols(baseTypedocMember, currentTypedocNode);
+          } else {
+            this.forwardAncestorRefs.set(canonicalAncestorType, [...(this.forwardAncestorRefs.get(canonicalAncestorType) ?? []), currentTypedocNode]);
+          }
+        }
+      }
+      this.backwardAncestorRefs.set(currentDocspecNode.name, currentTypedocNode);
+    }
+    const _utils$getGroupName = utils.getGroupName(currentTypedocNode),
+      groupName = _utils$getGroupName.groupName,
+      groupSource = _utils$getGroupName.source;
+    if (groupName && (
+    // If the group comes from a decorator, use it always; otherwise check if the symbol isn't top-level
+    !this.settings.useDocsGroup || groupSource === 'decorator' || parentTypeDoc.kindString !== 'Project')) {
+      const group = parentTypeDoc.groups?.find(g => g.title === groupName);
+      if (group) {
+        group.children.push(currentTypedocNode.id);
+      } else {
+        parentTypeDoc.groups?.push({
+          children: [currentTypedocNode.id],
+          title: groupName
+        });
+      }
+    }
+    parentTypeDoc.children?.push(currentTypedocNode);
+    this.sortChildren(currentTypedocNode);
+    if (currentTypedocNode.kindString === 'Class') {
+      for (const descendant of this.forwardAncestorRefs.get(currentTypedocNode.name) ?? []) {
+        inheritance.resolveInheritedSymbols(currentTypedocNode, descendant);
+        this.sortChildren(descendant);
+      }
+    }
+  }
+
+  // Get the URL of the member in GitHub
+  getGitHubUrls(docspecMember) {
+    const filePathInRepo = docspecMember.location.filename.replace(consts.REPO_ROOT_PLACEHOLDER, '');
+    return {
+      filePathInRepo
+    };
+  }
+
+  /**
+   * Sorts the `groups` of `typedocMember` using {@link groupSort} and sorts the children of each group alphabetically.
+   */
+  sortChildren(typedocMember) {
+    if (!typedocMember.groups) return;
+    for (const group of typedocMember.groups) {
+      group.children.sort((a, b) => {
+        const firstName = typedocMember.children?.find(x => x.id === a || x.inheritedFrom?.target === a)?.name ?? 'a';
+        const secondName = typedocMember.children?.find(x => x.id === b || x.inheritedFrom?.target === b)?.name ?? 'b';
+        return firstName.localeCompare(secondName);
+      });
+    }
+    typedocMember.groups?.sort((a, b) => utils.groupSort(a.title, b.title));
+  }
+
+  /**
+   * If possible, parses the `.docstring` property of the passed object. If the docstring is a stringified JSON object,
+   * it extracts the `args` and `returns` sections and adds them to the returned object.
+   *
+   * TODO
+   * This structure is created in the `google` docstring format, which is a JSON object with the following structure:
+   */
+  parseDocstring(docspecMember) {
+    const docstring = {
+      text: docspecMember.docstring?.content ?? ''
+    };
+    try {
+      const parsedDocstring = JSON.parse(docstring.text);
+      docstring.text = parsedDocstring.text;
+      const parsedArguments = parsedDocstring.sections?.find(section => Object.keys(section)[0] === 'Arguments')?.Arguments ?? [];
+      docstring.args = parsedArguments?.reduce((acc, arg) => {
+        acc[arg.param] = arg.desc;
+        return acc;
+      }, {}) ?? {};
+      const returnTypes = docstring.sections?.find(section => Object.keys(section)[0] === 'Returns')?.Returns ?? [];
+      docstring.returns = returnTypes.join('\n');
+    } catch {
+      // Do nothing
+    }
+    if (!docstring.text) {
+      docstring.text = this.getContext()?.args?.[docspecMember.name] ?? '';
+    }
+    return docstring;
+  }
+
+  /**
+   * Given the current Docspec object and the parent Typedoc object, returns the Typedoc type and kind of the current object.
+   */
+  getTypedocType(docspecMember, parentTypeDoc) {
+    let typedocKind = consts.TYPEDOC_KINDS[docspecMember.type];
+    if (docspecMember.bases?.includes('Enum')) {
+      typedocKind = consts.TYPEDOC_KINDS.enum;
+    }
+    let typedocType = this.pythonTypeResolver.registerType(docspecMember.datatype);
+    if (docspecMember.decorations?.some(d => ['property', 'dualproperty'].includes(d.name))) {
+      typedocKind = consts.TYPEDOC_KINDS.data;
+      typedocType = this.pythonTypeResolver.registerType(docspecMember.return_type ?? docspecMember.datatype);
+    }
+    if (parentTypeDoc.kindString === 'Enumeration') {
+      typedocKind = consts.TYPEDOC_KINDS.enumValue;
+      typedocType = {
+        type: 'literal',
+        value: docspecMember.value
+      };
+    }
+    return {
+      typedocKind,
+      typedocType
+    };
+  }
+}
+exports.DocspecTransformer = DocspecTransformer;
+//# sourceMappingURL=transformation.js.map

package/lib/plugin/python/transformation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformation.js","sources":["../../../src/plugin/python/transformation.ts"],"sourcesContent":null,"names":["PythonTypeResolver","projectUsesDocsGroupDecorator","isHidden","getOID","resolveInheritedSymbols","getGroupName","REPO_ROOT_PLACEHOLDER","groupSort","TYPEDOC_KINDS"],"mappings":"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"}

package/lib/plugin/python/type-parsing/index.js

@@ -0,0 +1,79 @@
+'use strict';
+
+const childProcess = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+const _interopDefault = e => e && e.__esModule ? e : {
+  default: e
+};
+const childProcess__default = /*#__PURE__*/_interopDefault(childProcess);
+const fs__default = /*#__PURE__*/_interopDefault(fs);
+const path__default = /*#__PURE__*/_interopDefault(path);
+const RAW_TYPES_JSON_FILEPATH = path__default.default.join(__dirname, 'typedoc-types.raw');
+const PARSED_TYPES_JSON_FILEPATH = path__default.default.join(__dirname, 'typedoc-types-parsed.json');
+const PYTHON_SCRIPT_FILEPATH = path__default.default.join(__dirname, 'parse_types.py');
+
+/**
+ * Keeps track of Typedoc type objects. When `resolveTypes` is called, it tries to parse
+ * the Python types using Python's `ast` module.
+ *
+ * The parsed types are then applied to the original registered Typedoc type objects.
+ */
+class PythonTypeResolver {
+  typedocTypes = [];
+
+  /**
+   * Register a new Python type to be resolved.
+   *
+   * Given a string representation of the type, returns a Typedoc type object.
+   */
+  registerType(docspecType) {
+    const newType = {
+      name: docspecType?.replaceAll(/#.*/g, '').replaceAll('\n', '').trim() ?? 'Undefined',
+      type: 'reference'
+    };
+    this.typedocTypes.push(newType);
+    return newType;
+  }
+
+  /**
+   * Parse the registered Python types using Python's ast module.
+   * For the actual Python implementation, see `parse_types.py`.
+   *
+   * Modifies the objects registered with `registerType` in-place.
+   *
+   * @param typedocTypes The "opaque" Python types to parse.
+   * @returns {void} Nothing. The registered types are mutated in-place.
+   */
+  resolveTypes() {
+    fs__default.default.writeFileSync(RAW_TYPES_JSON_FILEPATH, JSON.stringify(this.typedocTypes.map(x => {
+      if (x.type === 'reference') {
+        return x.name;
+      }
+      return null;
+    }).filter(Boolean)));
+    childProcess__default.default.spawnSync('python', [PYTHON_SCRIPT_FILEPATH, RAW_TYPES_JSON_FILEPATH]);
+    const parsedTypes = JSON.parse(fs__default.default.readFileSync(PARSED_TYPES_JSON_FILEPATH, 'utf8'));
+    for (const originalType of this.typedocTypes) {
+      if (originalType.type === 'reference') {
+        const parsedType = parsedTypes[originalType.name];
+        if (parsedType) {
+          for (const key of Object.keys(parsedType)) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            originalType[key] = parsedType[key];
+          }
+        }
+      }
+    }
+  }
+
+  /**
+   * Strips the Optional[] type from the type string,
+   * and replaces generic types with just the main type.
+   */
+  getBaseType(type) {
+    return type?.replace(/Optional\[(.*)]/g, '$1').split('[')[0];
+  }
+}
+exports.PythonTypeResolver = PythonTypeResolver;
+//# sourceMappingURL=index.js.map

package/lib/plugin/python/type-parsing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/plugin/python/type-parsing/index.ts"],"sourcesContent":null,"names":["path","fs","childProcess"],"mappings":";;;;;;;;;;;;AAGA,MAAM,uBAAuB,GAAGA,qBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;AAC1E,MAAM,0BAA0B,GAAGA,qBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,2BAA2B,CAAC,CAAC;AACrF,MAAM,sBAAsB,GAAGA,qBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;AACtE;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,kBAAkB,CAAC;AAChC,EAAE,YAAY,GAAG,EAAE,CAAC;AACpB;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,YAAY,CAAC,WAAW,EAAE;AAC5B,IAAI,MAAM,OAAO,GAAG;AACpB,MAAM,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,WAAW;AAC1F,MAAM,IAAI,EAAE,WAAW;AACvB,KAAK,CAAC;AACN,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpC,IAAI,OAAO,OAAO,CAAC;AACnB,GAAG;AACH;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,YAAY,GAAG;AACjB,IAAIC,mBAAE,CAAC,aAAa,CAAC,uBAAuB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI;AACxF,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE;AAClC,QAAQ,OAAO,CAAC,CAAC,IAAI,CAAC;AACtB,OAAO;AACP,MAAM,OAAO,IAAI,CAAC;AAClB,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACzB,IAAIC,6BAAY,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,sBAAsB,EAAE,uBAAuB,CAAC,CAAC,CAAC;AACxF,IAAI,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAACD,mBAAE,CAAC,YAAY,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC,CAAC;AACxF,IAAI,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,YAAY,EAAE;AAClD,MAAM,IAAI,YAAY,CAAC,IAAI,KAAK,WAAW,EAAE;AAC7C,QAAQ,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AAC1D,QAAQ,IAAI,UAAU,EAAE;AACxB,UAAU,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;AACrD;AACA,YAAY,YAAY,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;AAChD,WAAW;AACX,SAAS;AACT,OAAO;AACP,KAAK;AACL,GAAG;AACH;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,CAAC,IAAI,EAAE;AACpB,IAAI,OAAO,IAAI,EAAE,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,GAAG;AACH;;;;"}

package/lib/plugin/python/types.js

@@ -0,0 +1,2 @@
+'use strict';
+//# sourceMappingURL=types.js.map

package/lib/plugin/python/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":[],"sourcesContent":null,"names":[],"mappings":";;"}

package/lib/plugin/python/utils.js

@@ -0,0 +1,106 @@
+'use strict';
+
+const consts = require('./consts.js');
+
+/* eslint-disable sort-keys */
+function* generateOID() {
+  let id = 1;
+  while (true) {
+    yield id++;
+  }
+}
+const oidGenerator = generateOID();
+
+/**
+ * Returns automatically incrementing OID. Every call to this function will return a new unique OID.
+ * @returns {number} The OID.
+ */
+function getOID() {
+  return oidGenerator.next().value;
+}
+
+/**
+ * Given a TypeDoc object, returns the name of the group this object belongs to.
+ * @param object The TypeDoc object.
+ * @returns The group name and the source of the group name (either 'decorator' or 'predicate').
+ */
+function getGroupName(object) {
+  if (object.decorations?.some(d => d.name === 'docs_group')) {
+    const parsedGroupName = object.decorations.find(d => d.name === 'docs_group')?.args.slice(2, -2);
+    if (parsedGroupName) {
+      return {
+        groupName: parsedGroupName,
+        source: 'decorator'
+      };
+    }
+  }
+  const groupPredicates = {
+    'Scrapy integration': x => ['ApifyScheduler', 'ActorDatasetPushPipeline', 'ApifyHttpProxyMiddleware', 'apply_apify_settings'].includes(x.name),
+    'Data structures': x => Boolean(['BaseModel', 'TypedDict'].some(base => x?.bases?.includes(base)) || x?.decorations?.some(d => d.name === 'dataclass')),
+    Errors: x => x.name.toLowerCase().includes('error'),
+    Classes: x => x.kindString === 'Class',
+    'Main Clients': x => ['ApifyClient', 'ApifyClientAsync'].includes(x.name),
+    'Async Resource Clients': x => x.name.toLowerCase().includes('async'),
+    'Resource Clients': x => x.kindString === 'Class' && x.name.toLowerCase().includes('client'),
+    Methods: x => x.kindString === 'Method',
+    Constructors: x => x.kindString === 'Constructor',
+    Properties: x => x.kindString === 'Property',
+    Constants: x => x.kindString === 'Enumeration',
+    'Enumeration members': x => x.kindString === 'Enumeration Member'
+  };
+  const groupName = Object.entries(groupPredicates).find(([_, predicate]) => predicate(object))?.[0];
+  return {
+    groupName,
+    source: 'predicate'
+  };
+}
+
+/**
+ * Recursively search arbitrary JS object for property `name: 'docs_group'`.
+ * @param object
+ */
+function projectUsesDocsGroupDecorator(object) {
+  if (object instanceof Object) {
+    if (object.name === 'docs_group') {
+      return true;
+    }
+    for (const key in object) {
+      if (projectUsesDocsGroupDecorator(object[key])) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+
+/**
+ * Returns true if the given member should be hidden from the documentation.
+ *
+ * A member should be hidden if:
+ * - It has a `ignore_docs` decoration.
+ *
+ * @param member The member to check.
+ */
+function isHidden(member) {
+  return !(member.type in consts.TYPEDOC_KINDS) || member.decorations?.some(d => d.name === 'ignore_docs') || member.name === 'ignore_docs';
+}
+
+/**
+ * Comparator for enforcing the documentation groups order (examples of groups in {@link GROUP_ORDER}).
+ *
+ * The groups are sorted by the order in which they appear in {@link GROUP_ORDER}.
+ *
+ * This is compatible with the `Array.prototype.sort` method.
+ */
+function groupSort(g1, g2) {
+  if (consts.GROUP_ORDER.includes(g1) && consts.GROUP_ORDER.includes(g2)) {
+    return consts.GROUP_ORDER.indexOf(g1) - consts.GROUP_ORDER.indexOf(g2);
+  }
+  return g1.localeCompare(g2);
+}
+exports.getGroupName = getGroupName;
+exports.getOID = getOID;
+exports.groupSort = groupSort;
+exports.isHidden = isHidden;
+exports.projectUsesDocsGroupDecorator = projectUsesDocsGroupDecorator;
+//# sourceMappingURL=utils.js.map

package/lib/plugin/python/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../src/plugin/python/utils.ts"],"sourcesContent":null,"names":["TYPEDOC_KINDS","GROUP_ORDER"],"mappings":"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"}

package/lib/plugin/structure/0.23.js

@@ -1,7 +1,5 @@
 'use strict';
 
-/* eslint-disable no-param-reassign */
-
 // https://github.com/TypeStrong/typedoc/releases/tag/v0.23.0
 // https://github.com/milesj/docusaurus-plugin-typedoc-api/pull/50
 function migrateToVersion0230(reflection) {

package/lib/plugin/structure/0.23.js.map

@@ -1 +1 @@
-{"version":3,"file":"0.23.js","sources":["../../../src/plugin/structure/0.23.ts"],"sourcesContent":null,"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACO,SAAS,oBAAoB,CAAC,UAAU,EAAE;AACjD,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;AAC9C;AACA,IAAI,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AACzD,GAAG;AACH,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;AAC9C;AACA,IAAI,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AACzD,GAAG;AACH,EAAE,IAAI,eAAe,IAAI,UAAU,EAAE;AACrC,IAAI,UAAU,CAAC,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC;AACzD,GAAG;AACH,EAAE,IAAI,UAAU,CAAC,OAAO,KAAK,WAAW,IAAI,UAAU,CAAC,OAAO,IAAI,MAAM,IAAI,UAAU,CAAC,OAAO,IAAI,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE;AACjI,IAAI,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;AACvC,IAAI,MAAM,OAAO,GAAG,EAAE,CAAC;AACvB,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE;AAC3B,MAAM,OAAO,CAAC,IAAI,CAAC;AACnB,QAAQ,IAAI,EAAE,MAAM;AACpB,QAAQ,IAAI,EAAE,OAAO,CAAC,SAAS;AAC/B,OAAO,CAAC,CAAC;AACT,KAAK;AACL,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;AACtB,MAAM,OAAO,CAAC,IAAI,CAAC;AACnB,QAAQ,IAAI,EAAE,MAAM;AACpB,QAAQ,IAAI,EAAE,OAAO,CAAC,IAAI;AAC1B,OAAO,CAAC,CAAC;AACT,KAAK;AACL,IAAI,UAAU,CAAC,OAAO,GAAG;AACzB,MAAM,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK;AAC3C,QAAQ,OAAO,EAAE,CAAC;AAClB,UAAU,IAAI,EAAE,MAAM;AACtB,UAAU,IAAI,EAAE,GAAG,CAAC,IAAI;AACxB,SAAS,CAAC;AACV,QAAQ,IAAI,EAAE,GAAG,CAAC,GAAG;AACrB,QAAQ,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1B,OAAO,CAAC,CAAC;AACT,MAAM,OAAO;AACb,KAAK,CAAC;AACN,GAAG;AACH;;;;"}
+{"version":3,"file":"0.23.js","sources":["../../../src/plugin/structure/0.23.ts"],"sourcesContent":null,"names":[],"mappings":";;AAAA;AACA;AACO,SAAS,oBAAoB,CAAC,UAAU,EAAE;AACjD,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;AAC9C;AACA,IAAI,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AACzD,GAAG;AACH,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;AAC9C;AACA,IAAI,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AACzD,GAAG;AACH,EAAE,IAAI,eAAe,IAAI,UAAU,EAAE;AACrC,IAAI,UAAU,CAAC,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC;AACzD,GAAG;AACH,EAAE,IAAI,UAAU,CAAC,OAAO,KAAK,WAAW,IAAI,UAAU,CAAC,OAAO,IAAI,MAAM,IAAI,UAAU,CAAC,OAAO,IAAI,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE;AACjI,IAAI,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;AACvC,IAAI,MAAM,OAAO,GAAG,EAAE,CAAC;AACvB,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE;AAC3B,MAAM,OAAO,CAAC,IAAI,CAAC;AACnB,QAAQ,IAAI,EAAE,MAAM;AACpB,QAAQ,IAAI,EAAE,OAAO,CAAC,SAAS;AAC/B,OAAO,CAAC,CAAC;AACT,KAAK;AACL,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;AACtB,MAAM,OAAO,CAAC,IAAI,CAAC;AACnB,QAAQ,IAAI,EAAE,MAAM;AACpB,QAAQ,IAAI,EAAE,OAAO,CAAC,IAAI;AAC1B,OAAO,CAAC,CAAC;AACT,KAAK;AACL,IAAI,UAAU,CAAC,OAAO,GAAG;AACzB,MAAM,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK;AAC3C,QAAQ,OAAO,EAAE,CAAC;AAClB,UAAU,IAAI,EAAE,MAAM;AACtB,UAAU,IAAI,EAAE,GAAG,CAAC,IAAI;AACxB,SAAS,CAAC;AACV,QAAQ,IAAI,EAAE,GAAG,CAAC,GAAG;AACrB,QAAQ,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1B,OAAO,CAAC,CAAC;AACT,MAAM,OAAO;AACb,KAAK,CAAC;AACN,GAAG;AACH;;;;"}

package/lib/utils/icons.js

@@ -54,6 +54,7 @@ const KIND_ICONS = {
   8_388_608: 'references' // a Non-TS document (new in TypeDoc `0.26.0`, unused by `docusaurus-plugin-typedoc-api`)
 };
 function getKindIcon(kind, name) {
+  if (!name) return null;
   let icon = KIND_ICONS[kind];
 
   // Use event icon when property starts with "on"
@@ -62,8 +63,6 @@ function getKindIcon(kind, name) {
   }
   return icon;
 }
-
-// eslint-disable-next-line complexity
 function getKindIconColor(kind) {
   switch (kind) {
     // Function

package/lib/utils/icons.js.map

@@ -1 +1 @@
-{"version":3,"file":"icons.js","sources":["../../src/utils/icons.ts"],"sourcesContent":null,"names":[],"mappings":"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"}
+{"version":3,"file":"icons.js","sources":["../../src/utils/icons.ts"],"sourcesContent":null,"names":[],"mappings":"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"}