docs: update

Author: kwaa

docs/.vitepress/config.ts

@@ -5,6 +5,7 @@ import { defineConfig } from 'vitepress'
 export default defineConfig({
   description: 'Standard for Moeru AI.',
   themeConfig: {
+    logo: 'https://github.com/moeru-ai.png',
     // https://vitepress.dev/reference/default-theme-config
     nav: [
       { link: '/', text: 'Home' },
@@ -13,6 +14,7 @@ export default defineConfig({
 
     sidebar: calculateSidebar([
       'lib',
+      'node',
       // 'Notes',
       // { folderName: 'Articles', separate: true },
     ]),

docs/index.md

@@ -18,4 +18,5 @@ features:
   - title: TypeScript Library
     link: /lib
   - title: Node.js Project Architecture
+    link: /node
 ---

docs/node/bundler.md

@@ -0,0 +1,21 @@
+# Bundler
+
+There are many bundlers out there, so just pick the one that meets your needs.
+
+If I had to recommend one, my recommendation would be [`pkgroll`](https://github.com/privatenumber/pkgroll).
+
+It has the following advantages:
+
+## Zero Configuration
+
+You don't need to configure it, it will be configured automatically based on your package.json.
+
+## Dependency Externalization
+
+Just put the packages you want inline into `devDependencies` instead of `dependencies`.
+
+It will be inline, even including the type (something many other bundlers can't do)
+
+## NOT Opinionated
+
+pkgroll doesn't have the same configuration headaches as unbuild, such as forcing `.cjs`, `.mjs` extensions. (Why am I using the `.mjs` extension when my package is ESM only?)

docs/node/index.md

@@ -0,0 +1,14 @@
+# Node.js Project Architecture
+
+Okay, it's 2025 and we're getting ready to write a new Node.js library and publish it to npm.
+
+Let's identify some (for Moeru AI) basics:
+
+- **ESM only**
+  - Did you know that ESM has been supported since Node.js 12?
+  - Restricting to ESM only not only reduces package size, but also gives you the freedom to use new features such as top-level-await.
+- **TypeScript**
+  - As a library, not including type definitions is unacceptable to me.
+  - While other solutions like JSDoc can be used, but DX is extremely poor.
+- **pnpm**
+  - pnpm provides many of the features that will be used below.

docs/node/pnpm.md

@@ -0,0 +1,32 @@
+# pnpm
+
+## [Workspace](https://pnpm.io/workspaces)
+
+## [Catalogs](https://pnpm.io/catalogs)
+
+## [publishConfig](https://pnpm.io/package_json#publishconfig)
+
+pnpm supports overriding something at publish time via publishConfig.
+
+So we can do that:
+
+```json
+{
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  }
+}
+```
+
+This package will distribute TypeScript directly during local development, no build is required! you no longer need `watch` or `stub`.