react-lib-tools 0.0.1 → 0.0.3

package/dist/react-lib-tools.d.ts

@@ -1,14 +1,18 @@
 import { AnchorHTMLAttributes } from 'react';
 import { ClassValue } from 'clsx';
+import { ComponentMetadata } from '../types';
 import { ComponentType } from 'react';
 import { CSSProperties } from 'react';
 import { HTMLAttributes } from 'react';
+import { ImperativeHandleMetadata } from '../types';
 import { InputHTMLAttributes } from 'react';
+import { Intent } from '../types';
 import { JSX } from 'react/jsx-runtime';
 import { LazyExoticComponent } from 'react';
 import { MouseEvent as MouseEvent_2 } from 'react';
 import { PropsWithChildren } from 'react';
 import { ReactNode } from 'react';
+import { Section } from '../types';
 
 export declare function AppRoot({ hideVersions, navLinks, packageDescription, packageName, routes }: {
     hideVersions?: boolean | undefined;
@@ -65,21 +69,7 @@ export declare function Code({ className, html }: {
     html: string;
 }): JSX.Element;
 
-declare type ComponentMetadata = {
-    description: Section[];
-    filePath: string;
-    name: string;
-    props: {
-        [name: string]: ComponentPropMetadata;
-    };
-};
-
-declare type ComponentPropMetadata = {
-    description: Section[];
-    html: string;
-    name: string;
-    required: boolean;
-};
+export { ComponentMetadata }
 
 export declare function ComponentProps({ json, section }: {
     json: ComponentMetadata;
@@ -105,18 +95,7 @@ export declare function ImperativeHandle({ json, section }: {
     section: string;
 }): JSX.Element;
 
-declare type ImperativeHandleMetadata = {
-    description: Section[];
-    filePath: string;
-    name: string;
-    methods: ImperativeHandleMethodMetadata[];
-};
-
-declare type ImperativeHandleMethodMetadata = {
-    description: Section[];
-    html: string;
-    name: string;
-};
+export { ImperativeHandleMetadata }
 
 export declare function Input<Type extends string>({ children, className, onChange, value, ...rest }: PropsWithChildren<Omit<InputHTMLAttributes<HTMLInputElement>, "onChange"> & {
     className?: string | undefined;
@@ -124,7 +103,7 @@ export declare function Input<Type extends string>({ children, className, onChan
     value: Type;
 }>): JSX.Element;
 
-declare type Intent = "danger" | "none" | "primary" | "success" | "warning";
+export { Intent }
 
 export declare function Link({ children, onClick, to, ...rest }: Omit<HTMLAttributes<HTMLSpanElement>, "children"> & {
     children?: ReactNode | RenderFunction;
@@ -160,10 +139,7 @@ declare type RenderFunction = (params: {
     isPending: boolean;
 }) => ReactNode;
 
-declare type Section = {
-    content: string;
-    intent?: Intent | undefined;
-};
+export { Section }
 
 export declare function Select<Value extends string>({ className, defaultValue, onChange, options, placeholder, value }: {
     className?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-lib-tools",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "author": "Brian Vaughn <brian.david.vaughn@gmail.com> (https://github.com/bvaughn/)",
   "contributors": [

package/scripts/compile-docs.ts

@@ -1,21 +1,26 @@
 import { compileComponents } from "./utils/docs/compileComponents.ts";
 import { compileImperativeHandles } from "./utils/docs/compileImperativeHandles.ts";
+import type { CompilerOptions } from "typescript";
 
 export async function compileDocs({
+  compilerOptions = {},
   componentNames,
   imperativeHandleNames,
   outputDirName = "docs"
 }: {
+  compilerOptions: Partial<CompilerOptions>;
   componentNames: string[];
   imperativeHandleNames: string[];
   outputDirName?: string | undefined;
 }) {
   await compileComponents({
+    compilerOptions,
     componentNames,
     outputDirName
   });
 
   await compileImperativeHandles({
+    compilerOptions,
     names: imperativeHandleNames,
     outputDirName
   });

package/scripts/utils/assert.ts

@@ -0,0 +1,10 @@
+export function assert(
+  expectedCondition: unknown,
+  message: string = "Assertion error"
+): asserts expectedCondition {
+  if (!expectedCondition) {
+    console.error(message);
+
+    throw Error(message);
+  }
+}

package/scripts/utils/docs/compileComponent.ts

@@ -2,8 +2,8 @@ import { writeFile } from "node:fs/promises";
 import { join, relative } from "node:path";
 import { cwd } from "node:process";
 import { type FileParser, type PropItem } from "react-docgen-typescript";
-import type { ComponentMetadata } from "../../../lib/types.ts";
-import { assert } from "../../../lib/utils/assert.ts";
+import type { ComponentMetadata } from "../../../types.ts";
+import { assert } from "../assert.ts";
 import { syntaxHighlight } from "../syntax-highlight.ts";
 import { getPropTypeText } from "./getPropTypeText.ts";
 import { parseDescription } from "./parseDescription.ts";

package/scripts/utils/docs/compileComponents.ts

@@ -1,19 +1,22 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { cwd } from "node:process";
-import { withCustomConfig } from "react-docgen-typescript";
+import { withCompilerOptions } from "react-docgen-typescript";
+import type { CompilerOptions } from "typescript";
 import { initialize } from "../initialize.ts";
 import { compileComponent } from "./compileComponent.ts";
 import { insertPropsMarkdown } from "./insertPropsMarkdown.ts";
 
 export async function compileComponents({
+  compilerOptions,
   componentNames,
   outputDirName
 }: {
+  compilerOptions: Partial<CompilerOptions>;
   componentNames: string[];
   outputDirName: string;
 }) {
-  const parser = withCustomConfig("./tsconfig.json", {
+  const parser = withCompilerOptions(compilerOptions, {
     savePropValueAsString: true,
     shouldExtractLiteralValuesFromEnum: true,
     shouldExtractValuesFromUnion: true,

package/scripts/utils/docs/compileImperativeHandle.ts

@@ -2,7 +2,7 @@ import type { InterfaceNode } from "@ts-ast-parser/core";
 import assert from "node:assert";
 import { writeFile } from "node:fs/promises";
 import { join } from "path";
-import type { ImperativeHandleMetadata } from "../../../lib/types.ts";
+import type { ImperativeHandleMetadata } from "../../../types.ts";
 import { syntaxHighlight } from "../syntax-highlight.ts";
 import { parseDescription } from "./parseDescription.ts";
 

package/scripts/utils/docs/compileImperativeHandles.ts

@@ -1,19 +1,21 @@
 import { parseFromProject, type InterfaceNode } from "@ts-ast-parser/core";
-import tsConfig from "../../../tsconfig.json" with { type: "json" };
-import { compileImperativeHandle } from "./compileImperativeHandle.ts";
 import { join } from "node:path";
 import { cwd } from "node:process";
+import type { CompilerOptions } from "typescript";
+import { compileImperativeHandle } from "./compileImperativeHandle.ts";
 
 export async function compileImperativeHandles({
+  compilerOptions,
   names,
   outputDirName
 }: {
+  compilerOptions: Partial<CompilerOptions>;
   names: string[];
   outputDirName: string;
 }) {
   const outputDir = join(cwd(), "public", "generated", outputDirName);
 
-  const result = await parseFromProject(tsConfig);
+  const result = await parseFromProject({ compilerOptions });
   const reflectedModules = result.project?.getModules() ?? [];
 
   const nodes: {
@@ -25,10 +27,13 @@ export async function compileImperativeHandles({
     reflectedModules.forEach((reflectedModule) => {
       const node = reflectedModule.getDeclarationByName(name);
       if (node) {
-        nodes.push({
-          filePath: reflectedModule.getSourcePath(),
-          node: node as unknown as InterfaceNode
-        });
+        const filePath = reflectedModule.getSourcePath();
+        if (filePath.startsWith("lib/")) {
+          nodes.push({
+            filePath,
+            node: node as unknown as InterfaceNode
+          });
+        }
       }
     });
   });

package/scripts/utils/docs/parseDescription.ts

@@ -1,6 +1,6 @@
-import type { Intent, Section } from "../../../lib/types.ts";
-import { formatDescriptionText } from "./formatDescriptionText.ts";
+import type { Intent, Section } from "../../../types.ts";
 import { syntaxHighlight, type Language } from "../syntax-highlight.ts";
+import { formatDescriptionText } from "./formatDescriptionText.ts";
 
 export async function parseDescription(rawText: string) {
   const sections: Section[] = [];