.prettierrc

@@ -1,3 +1,19 @@
 {
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": false,
+  "quoteProps": "as-needed",
+  "jsxSingleQuote": false,
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "requirePragma": false,
+  "insertPragma": false,
+  "proseWrap": "preserve",
+  "htmlWhitespaceSensitivity": "css",
+  "vueIndentScriptAndStyle": false,
   "endOfLine": "lf"
-}
+}

docs/api_refs/.gitignore

@@ -38,4 +38,5 @@ next-env.d.ts
 # Autogenerated docs
 /public/*
 /langchain
-/langchain-core
+/langchain-core
+typedoc.json

docs/api_refs/next.config.js

@@ -3,12 +3,12 @@ const nextConfig = {
   async redirects() {
     return [
       {
-        source: '/',
-        destination: '/index.html',
+        source: "/",
+        destination: "/index.html",
         permanent: false,
       },
-    ]
+    ];
   },
-}
+};
 
-module.exports = nextConfig
+module.exports = nextConfig;

docs/api_refs/package.json

@@ -11,6 +11,8 @@
     "build:deps": "yarn run turbo:command build --filter=!api_refs --filter=!core_docs --filter=!examples --filter=!create-langchain-integration --concurrency=1",
     "start": "yarn build && next start -p 3001",
     "lint": "next lint",
+    "format": "prettier --write \"**/*.{js,jsx,ts,tsx}\"",
+    "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx}\"",
     "clean": "rm -rf .next .turbo public/ && mkdir public"
   },
   "dependencies": {
@@ -26,6 +28,7 @@
     "eslint": "^8",
     "eslint-config-next": "14.0.1",
     "postcss": "^8",
+    "prettier": "^2.8.3",
     "tailwindcss": "^3.3.0",
     "ts-morph": "^20.0.0",
     "typedoc": "^0.25.6",

docs/api_refs/postcss.config.js

@@ -3,4 +3,4 @@ module.exports = {
     tailwindcss: {},
     autoprefixer: {},
   },
-}
+};

docs/api_refs/scripts/create-entrypoints.js

@@ -2,6 +2,32 @@ const { Project, SyntaxKind } = require("ts-morph");
 const fs = require("fs");
 const path = require("path");
 
+const BASE_TYPEDOC_CONFIG = {
+  $schema: "https://typedoc.org/schema.json",
+  out: "public",
+  sort: [
+    "kind",
+    "visibility",
+    "instance-first",
+    "required-first",
+    "alphabetical",
+  ],
+  plugin: ["./typedoc_plugins/hide_underscore_lc.js"],
+  tsconfig: "../../tsconfig.json",
+  readme: "none",
+  excludePrivate: true,
+  excludeInternal: true,
+  excludeExternals: true,
+  excludeNotDocumented: false,
+  includeVersion: true,
+  sourceLinkTemplate:
+    "https://github.com/langchain-ai/langchainjs/blob/{gitRevision}/{path}#L{line}",
+  logLevel: "Error",
+  name: "LangChain.js",
+  skipErrorChecking: true,
+  exclude: ["dist"],
+};
+
 /**
  *
  * @param {string} relativePath
@@ -18,14 +44,18 @@ function main() {
   const workspaces = fs
     .readdirSync("../../libs/")
     .filter((dir) => dir.startsWith("langchain-"))
-    .map((dir) => path.join("../../libs/", dir, "/scripts/create-entrypoints.js"));
+    .map((dir) =>
+      path.join("../../libs/", dir, "/scripts/create-entrypoints.js")
+    );
   const entrypointFiles = [
     "../../langchain/scripts/create-entrypoints.js",
     "../../langchain-core/scripts/create-entrypoints.js",
     ...workspaces,
   ];
   /** @type {Array<string>} */
-  const blacklistedEntrypoints = JSON.parse(fs.readFileSync("./blacklisted-entrypoints.json"));
+  const blacklistedEntrypoints = JSON.parse(
+    fs.readFileSync("./blacklisted-entrypoints.json")
+  );
 
   const entrypoints = new Set([]);
   entrypointFiles.forEach((entrypointFile) => {
@@ -66,12 +96,23 @@ function main() {
 
     Object.values(entrypointsObject)
       .filter((key) => !deprecatedNodeOnly.includes(key))
-      .filter((key) => !blacklistedEntrypoints.find((blacklistedItem) => blacklistedItem === `${entrypointDir}/src/${key}.ts`))
+      .filter(
+        (key) =>
+          !blacklistedEntrypoints.find(
+            (blacklistedItem) =>
+              blacklistedItem === `${entrypointDir}/src/${key}.ts`
+          )
+      )
       .map((key) => entrypoints.add(`${entrypointDir}/src/${key}.ts`));
   });
 
-  updateJsonFile("./typedoc.json", (json) => ({
-    ...json,
+  // Check if the `./typedoc.json` file exists, since it is gitignored by default
+  if (!fs.existsSync("./typedoc.json")) {
+    fs.writeFileSync("./typedoc.json", "{}\n");
+  }
+
+  updateJsonFile("./typedoc.json", () => ({
+    ...BASE_TYPEDOC_CONFIG,
     entryPoints: Array.from(entrypoints),
   }));
 }

docs/api_refs/scripts/update-typedoc-css.js

@@ -23,7 +23,6 @@ async function main() {
 }
 `;
 
-
   let file = await readFile("./public/assets/style.css", "utf-8");
   file += css;
   await writeFile("./public/assets/style.css", file);

docs/api_refs/tailwind.config.ts

@@ -1,20 +1,20 @@
-import type { Config } from 'tailwindcss'
+import type { Config } from "tailwindcss";
 
 const config: Config = {
   content: [
-    './src/pages/**/*.{js,ts,jsx,tsx,mdx}',
-    './src/components/**/*.{js,ts,jsx,tsx,mdx}',
-    './src/app/**/*.{js,ts,jsx,tsx,mdx}',
+    "./src/pages/**/*.{js,ts,jsx,tsx,mdx}",
+    "./src/components/**/*.{js,ts,jsx,tsx,mdx}",
+    "./src/app/**/*.{js,ts,jsx,tsx,mdx}",
   ],
   theme: {
     extend: {
       backgroundImage: {
-        'gradient-radial': 'radial-gradient(var(--tw-gradient-stops))',
-        'gradient-conic':
-          'conic-gradient(from 180deg at 50% 50%, var(--tw-gradient-stops))',
+        "gradient-radial": "radial-gradient(var(--tw-gradient-stops))",
+        "gradient-conic":
+          "conic-gradient(from 180deg at 50% 50%, var(--tw-gradient-stops))",
       },
     },
   },
   plugins: [],
-}
-export default config
+};
+export default config;