orga-build 0.3.0 → 0.3.2

package/README.org

@@ -8,6 +8,37 @@ A simple tool that builds org-mode files into a website.
 npm install orga-build
 #+end_src
 
+* TypeScript Setup
+
+If you're using TypeScript and want type support for the =orga-build:content= virtual module, you need to add a reference to the type definitions.
+
+** Minimal Setup
+
+1. Create a =types.d.ts= file in your project root (or any location):
+
+#+begin_src typescript
+/// <reference types="orga-build/client" />
+#+end_src
+
+2. Ensure your =tsconfig.json= includes this file:
+
+#+begin_src json
+{
+  "compilerOptions": {
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx"
+  },
+  "include": ["types.d.ts", "**/*"]
+}
+#+end_src
+
+That's it! TypeScript will now recognize imports from =orga-build:content=.
+
+** Why This is Needed
+
+The =orga-build:content= module is a "virtual module" - it doesn't exist as a physical file but is generated at build time by Vite. The =/// <reference types="orga-build/client" />= directive tells TypeScript to load the type definitions for this virtual module.
+
 * Content Query API
 
 orga-build provides an Astro-inspired content query API via the =orga-build:content= virtual module. This allows you to safely query content entries from any page or layout without circular imports.

package/lib/vite.js

@@ -31,20 +31,20 @@ export function pluginFactory({ dir }) {
 			}
 		}),
 
-		configureServer({ watcher, moduleGraph }) {
-			const reloadVirtualModule = (/** @type {string} */ moduleId) => {
-				const module = moduleGraph.getModuleById(moduleId)
+		configureServer(server) {
+			const { watcher, moduleGraph, ws } = server
+
+			// Invalidate content module on file changes
+			watcher.on('change', (filePath) => {
+				const module = moduleGraph.getModuleById(contentModuleIdResolved)
 				if (module) {
 					moduleGraph.invalidateModule(module)
-					watcher.emit('change', moduleId)
+					// Send HMR update to client
+					ws.send({
+						type: 'full-reload',
+						path: '*'
+					})
 				}
-			}
-
-			reloadVirtualModule('/')
-
-			// Invalidate content module on file changes
-			watcher.on('change', () => {
-				reloadVirtualModule(contentModuleIdResolved)
 			})
 		},
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orga-build",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "A simple tool that builds org-mode files into a website",
   "type": "module",
   "bin": {
@@ -21,7 +21,7 @@
     },
     "./csr": "./lib/csr.jsx",
     "./components": "./lib/components.js",
-    "./content": {
+    "./client": {
       "types": "./lib/content.d.ts"
     }
   },