Method extractInterfaceDefinition

scripts/docs/lib/source.ts:128–221

* Extracts the interface definition from the source file.

(
    interfaceName: string,
  )

   * Extracts the interface definition from the source file.
   */
  protected extractInterfaceDefinition(
    interfaceName: string,
  ): InterfaceDefinition {
    const definition: InterfaceDefinition = {
      name: interfaceName,
      properties: [],
    };
    const visit = (node: ts.Node) => {
      if (ts.isInterfaceDeclaration(node) && node.name.text === interfaceName) {
        let omittedProperties: Set<string> = new Set();

        // Check for extended interfaces
        if (node.heritageClauses && node.heritageClauses.length > 0) {
          const firstClause = node.heritageClauses[0];
          firstClause.types.forEach((type) => {
            const typeName = type.expression.getText(this.sourceFile);
            let extendedInterfaceName = typeName;

            // Check if the type is an Omit
            if (typeName.startsWith("Omit")) {
              const omitArgs = type.typeArguments;
              if (omitArgs && omitArgs.length > 0) {
                extendedInterfaceName = omitArgs[0].getText(this.sourceFile);
                if (omitArgs.length > 1) {
                  const omittedProps = omitArgs[1];
                  if (ts.isUnionTypeNode(omittedProps)) {
                    omittedProps.types.forEach((prop) => {
                      omittedProperties.add(
                        prop.getText(this.sourceFile).replace(/['"]/g, ""),
                      );
                    });
                  } else if (ts.isLiteralTypeNode(omittedProps)) {
                    omittedProperties.add(
                      omittedProps
                        .getText(this.sourceFile)
                        .replace(/['"]/g, ""),
                    );
                  }
                }
              }
            }

            const extendedInterfaceFilePath = this.findTypeDeclaration(
              extendedInterfaceName,
            );
            if (extendedInterfaceFilePath) {
              // Parse the extended interface file and extract its definition
              const extendedInterfaceSource = new SourceFile(
                extendedInterfaceFilePath,
              );
              extendedInterfaceSource.parse();
              const extendedDefinition =
                extendedInterfaceSource.extractInterfaceDefinition(
                  extendedInterfaceName,
                );
              // Merge properties from the extended interface, excluding omitted properties
              extendedDefinition.properties.forEach((prop) => {
                if (!omittedProperties.has(prop.name)) {