rewrite components doc generator

.gitignore

@@ -1,4 +1,4 @@
 build
 lib
-node_modules
+/node_modules
 coverage

fixtures/components/complex-types/column-layout/index.tsx

@@ -0,0 +1,17 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import * as React from 'react';
+
+export interface ColumnLayoutProps {
+  columns: ColumnLayoutProps.Columns;
+  widths: ColumnLayoutProps.Widths;
+}
+
+export namespace ColumnLayoutProps {
+  export type Columns = 1 | 2 | 3 | 4;
+  export type Widths = 25 | '50%' | 100 | '33%';
+}
+
+export default function ColumnLayout(props: ColumnLayoutProps) {
+  return <div></div>;
+}

fixtures/components/complex-types/table/index.tsx

@@ -3,6 +3,8 @@
 import * as React from 'react';
 import { TableProps } from './interfaces';
 
+export { TableProps };
+
 export default function Table<T = any>(props: TableProps<T>) {
   return <table />;
 }

fixtures/components/error-incorrect-component-name/button/index.tsx → fixtures/components/error-missing-props/button/index.tsx

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import * as React from 'react';
 
-export default function Input() {
-  return <span>Surprise, I am not Button!</span>;
+// should fail because ButtonProps export is missing
+export default function Button() {
+  return <span>Test</span>;
 }

fixtures/components/error-not-a-component/button/index.tsx

@@ -0,0 +1,7 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+export default function Button() {
+  // if a function does not return JSX, we throw
+  return { type: 'button' };
+}

fixtures/components/error-ref-property-type/button/index.tsx

@@ -3,12 +3,12 @@
 import * as React from 'react';
 
 export namespace ButtonProps {
-  interface Ref {
+  export interface Ref {
     value: string;
   }
 }
 
-const Button = React.forwardRef((props, ref) => {
+const Button = React.forwardRef<ButtonProps.Ref>((props, ref) => {
   return <button />;
 });
 

fixtures/components/forward-ref/focusable/index.tsx

@@ -9,7 +9,7 @@ export interface FocusableProps {
   children: React.ReactNode;
 }
 
-export namespace SomethingElse {
+namespace SomethingElse {
   export interface Ref {
     /**
      * Should be ignored
@@ -29,6 +29,11 @@ export namespace FocusableProps {
      * Focuses element using the CSS-selector
      */
     focusBySelector(selector: string): void;
+
+    /**
+     * Showcase for optional functions
+     */
+    cancelEdit?(): void;
   }
 }
 

fixtures/components/import-types/dependency/index.tsx

@@ -1,20 +1,9 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 import * as React from 'react';
+import { DependencyProps } from './interfaces';
 
-export interface DependencyProps {
-  name?: string;
-  variant?: DependencyProps.Variant;
-}
-
-// should not be included in the Main component API definition
-export interface MainProps {
-  randomValue: string;
-}
-
-export namespace DependencyProps {
-  export type Variant = 'button' | 'link';
-}
+export { DependencyProps };
 
 export default function Dependency({ name, variant = 'button' }: DependencyProps) {
   return <div className={variant}>{name}</div>;

fixtures/components/import-types/dependency/interfaces.ts

@@ -0,0 +1,15 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export interface DependencyProps {
+  name?: string;
+  variant?: DependencyProps.Variant;
+}
+
+// should not be included in the Main component API definition
+export interface MainProps {
+  randomValue: string;
+}
+
+export namespace DependencyProps {
+  export type Variant = 'button' | 'link';
+}

fixtures/components/third-party-import-types/button/interfaces.ts

@@ -1,6 +1,6 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-import { IconProps } from '../node_modules_mock/icon';
+import { IconProps } from 'icon';
 
 export interface ButtonProps {
   /**

fixtures/components/with-internals/with-internals/index.tsx

@@ -10,6 +10,11 @@ function InternalSameFile() {
   return <Internal name="test" />;
 }
 
-export default function WithInternals() {
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface WithInternalsProps {
+  // nothing here
+}
+
+export default function WithInternals(props: WithInternalsProps) {
   return <InternalSameFile />;
 }

src/bootstrap/typescript.ts

@@ -0,0 +1,44 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import ts from 'typescript';
+import pathe from 'pathe';
+
+function printDiagnostics(diagnostics: readonly ts.Diagnostic[]): void {
+  for (const diagnostic of diagnostics) {
+    const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n');
+    if (diagnostic.file) {
+      const { line, character } = ts.getLineAndCharacterOfPosition(diagnostic.file, diagnostic.start!);
+      console.error(`${diagnostic.file.fileName} (${line + 1},${character + 1}): ${message}`);
+    } else {
+      console.error(message);
+    }
+  }
+}
+
+function loadTSConfig(tsconfigPath: string): ts.ParsedCommandLine {
+  const configFile = ts.readConfigFile(tsconfigPath, ts.sys.readFile);
+  if (configFile.error) {
+    throw new Error('Failed to read tsconfig.json');
+  }
+  const config = ts.parseJsonConfigFileContent(configFile.config, ts.sys, pathe.dirname(tsconfigPath));
+  if (config.errors.length > 0) {
+    throw new Error('Failed to parse tsconfig.json');
+  }
+  // this prints a warning that incremental mode is not supported in programmatic API
+  config.options.incremental = false;
+  delete config.options.tsBuildInfoFile;
+  return config;
+}
+
+export function bootstrapTypescriptProject(tsconfigPath: string) {
+  const tsconfig = loadTSConfig(tsconfigPath);
+  const program = ts.createProgram(tsconfig.fileNames, tsconfig.options);
+
+  const diagnostics = ts.getPreEmitDiagnostics(program);
+  if (diagnostics.length > 0) {
+    printDiagnostics(diagnostics);
+    throw new Error('Compilation failed');
+  }
+
+  return program;
+}