Merge branch 'main' into integrations/opendataloader

Author: hnc-hyunheejo

IDE_SETUP.md

@@ -6,7 +6,7 @@ This repository includes configuration files to ensure consistent formatting acr
 
 ### VSCode
 
-If you're using Visual Studio Code, the settings in `.vscode/settings.json` will be automatically applied when you open this project. No additional setup required.
+If you're using Visual Studio Code, the settings in `.vscode/settings.json` should be automatically applied when you open this project. No additional setup required.
 
 ### Other IDEs
 

Makefile

@@ -72,6 +72,7 @@ broken-links: build
 check-pnpm:
 	@command -v pnpm >/dev/null 2>&1 || { echo >&2 "pnpm is not installed. Please install pnpm to proceed (https://pnpm.io/installation)"; exit 1; }
 
+# Reference docs commands (in reference/ subdirectory)
 build-references: check-pnpm
 	@echo "Building references..."
 	cd reference && pnpm i && pnpm build
@@ -82,16 +83,16 @@ preview-references: check-pnpm
 
 help:
 	@echo "Available commands:"
-	@echo "  make dev             - Start development mode with file watching and mint dev"
-	@echo "  make build           - Build documentation to ./build directory"
-	@echo "  make broken-links    - Check for broken links in built documentation"
-	@echo "  make build-references  - Build reference docs"
+	@echo "  make dev                - Start development mode with file watching and mint dev"
+	@echo "  make build              - Build documentation to ./build directory"
+	@echo "  make broken-links       - Check for broken links in built documentation"
+	@echo "  make build-references   - Build reference docs"
 	@echo "  make preview-references - Preview reference docs"
-	@echo "  make format          - Format code"
-	@echo "  make lint            - Lint code"
-	@echo "  make lint_md         - Lint markdown files"
-	@echo "  make lint_md_fix     - Lint and fix markdown files"
-	@echo "  make test            - Run tests"
-	@echo "  make install         - Install dependencies"
-	@echo "  make clean           - Clean build artifacts"
-	@echo "  make help            - Show this help message"
+	@echo "  make format             - Format code"
+	@echo "  make lint               - Lint code"
+	@echo "  make lint_md            - Lint markdown files"
+	@echo "  make lint_md_fix        - Lint and fix markdown files"
+	@echo "  make test               - Run tests"
+	@echo "  make install            - Install dependencies"
+	@echo "  make clean              - Clean build artifacts"
+	@echo "  make help               - Show this help message"

README.md

@@ -1 +1,2 @@
 .vercel
+.cache

reference/.gitignore

@@ -0,0 +1,7 @@
+# LangChain Reference Docs
+
+Reference documentation is not consolidated into our primary Mintlify website ([`docs.langchain.com`](https://docs.langchain.com)) due to limitations in the Mintlify platform. Instead, we deploy static documentation sites for our Python and JavaScript/TypeScript references.
+
+Currently, a Vercel project serves the built HTML from the `dist/language` directories at [`reference.langchain.com/python`](https://reference.langchain.com/python) and [`reference.langchain.com/javascript`](https://reference.langchain.com/javascript).
+
+See the [`reference/python/README.md`](./python/README.md) and [`reference/javascript/README.md`](./javascript/README.md) files for more information on how each are built and deployed.

reference/README.md

@@ -9,3 +9,4 @@ node_modules
 !package.json
 !pnpm-lock.yaml
 !tsconfig.json
+!README.md

reference/javascript/.eslintignore

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

reference/javascript/.eslintrc.cjs

@@ -0,0 +1,3 @@
+# LangChain TypeScript Reference Documentation
+
+This directory contains the source code and build process for the TypeScript reference documentation site, hosted at [`reference.langchain.com/javascript`](https://reference.langchain.com/javascript). This site serves references for LangChain, LangGraph, LangGraph Platform, and LangChain integration packages (such as [`@langchain/anthropic`](https://npm.com/package/@langchain/anthropic), [`@langchain/openai`](https://npm.com/package/@langchain/openai), etc.).