knowns 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -5,6 +5,32 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2024-12-26
+
+### Fixed
+- **Browser Command**: Fixed UI path detection when running from installed package
+  - Server now correctly finds pre-built UI files in `dist/ui`
+  - Works in both development mode (build on-the-fly) and production (serve pre-built)
+  - Fixed package root detection for bundled code
+- **GitHub Actions**: Fixed release creation permissions error
+  - Updated permissions from `contents: read` to `contents: write`
+  - Switched from deprecated `actions/create-release@v1` to `softprops/action-gh-release@v1`
+  - Enhanced release notes with installation instructions
+
+### Added
+- **Build Process**: UI files now built and included in npm package
+  - `dist/ui/index.html` - Main HTML file
+  - `dist/ui/main.js` - Minified React application (533KB)
+  - `dist/ui/main.css` - Compiled styles
+  - `dist/ui/index.css` - Additional styles
+- Separate build scripts for CLI and UI (`build:cli`, `build:ui`, `build:copy-html`)
+- Production vs development mode for browser server
+
+### Changed
+- Browser command now serves pre-built UI instead of building on user's machine
+- Improved error messages when UI files are not found
+- Server logs now indicate whether using pre-built UI or development mode
+
 ## [0.1.2] - 2024-12-26
 
 ### Added
@@ -69,6 +95,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - CLAUDE.md with complete guidelines for AI agents
 - Example workflows and patterns
 
+[0.1.3]: https://github.com/knowns-dev/knowns/compare/v0.1.2...v0.1.3
 [0.1.2]: https://github.com/knowns-dev/knowns/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/knowns-dev/knowns/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/knowns-dev/knowns/releases/tag/v0.1.0

package/dist/index.js

@@ -8903,14 +8903,35 @@ async function startServer(options2) {
       client.send(msg);
     }
   };
-  const uiPath = join9(projectRoot, "src", "ui");
-  const entrypoint = join9(uiPath, "index.html");
-  const buildDir = join9(projectRoot, ".knowns", "ui-build");
-  const entryFile = Bun.file(entrypoint);
-  if (!await entryFile.exists()) {
-    throw new Error(`UI entry point not found: ${entrypoint}`);
+  const currentDir = import.meta.dir;
+  let packageRoot = currentDir;
+  if (currentDir.endsWith("/dist")) {
+    packageRoot = join9(currentDir, "..");
+  } else if (currentDir.includes("/src/server")) {
+    packageRoot = join9(currentDir, "..", "..");
+  }
+  const uiSourcePath = join9(packageRoot, "src", "ui");
+  const uiDistPath = join9(packageRoot, "dist", "ui");
+  let uiPath;
+  let shouldBuild = false;
+  if (existsSync6(join9(uiDistPath, "main.js"))) {
+    uiPath = uiDistPath;
+    shouldBuild = false;
+  } else if (existsSync6(join9(uiSourcePath, "index.html"))) {
+    uiPath = uiSourcePath;
+    shouldBuild = true;
+  } else {
+    throw new Error(`UI files not found. Tried:
+  - ${uiDistPath} (${existsSync6(uiDistPath) ? "exists but no main.js" : "not found"})
+  - ${uiSourcePath} (${existsSync6(uiSourcePath) ? "exists but no index.html" : "not found"})
+Package root: ${packageRoot}
+Current dir: ${currentDir}`);
   }
+  const buildDir = join9(projectRoot, ".knowns", "ui-build");
   const buildUI = async () => {
+    if (!shouldBuild) {
+      return true;
+    }
     console.log("Building UI...");
     const startTime = Date.now();
     const buildResult = await Bun.build({
@@ -8940,31 +8961,36 @@ async function startServer(options2) {
     console.log(`UI built in ${Date.now() - startTime}ms`);
     return true;
   };
-  if (!await buildUI()) {
-    throw new Error("Failed to build UI");
-  }
-  let rebuildTimeout = null;
-  const watcher = watch(uiPath, { recursive: true }, async (_event, filename) => {
-    if (!filename)
-      return;
-    if (!filename.endsWith(".tsx") && !filename.endsWith(".ts") && !filename.endsWith(".css")) {
-      return;
-    }
-    if (rebuildTimeout) {
-      clearTimeout(rebuildTimeout);
+  if (shouldBuild) {
+    if (!await buildUI()) {
+      throw new Error("Failed to build UI");
     }
-    rebuildTimeout = setTimeout(async () => {
-      console.log(`File changed: ${filename}`);
-      const success = await buildUI();
-      if (success) {
-        broadcast({ type: "reload" });
+  }
+  let watcher = null;
+  if (shouldBuild) {
+    let rebuildTimeout = null;
+    watcher = watch(uiPath, { recursive: true }, async (_event, filename) => {
+      if (!filename)
+        return;
+      if (!filename.endsWith(".tsx") && !filename.endsWith(".ts") && !filename.endsWith(".css")) {
+        return;
       }
-    }, 100);
-  });
-  process.on("SIGINT", () => {
-    watcher.close();
-    process.exit(0);
-  });
+      if (rebuildTimeout) {
+        clearTimeout(rebuildTimeout);
+      }
+      rebuildTimeout = setTimeout(async () => {
+        console.log(`File changed: ${filename}`);
+        const success = await buildUI();
+        if (success) {
+          broadcast({ type: "reload" });
+        }
+      }, 100);
+    });
+    process.on("SIGINT", () => {
+      watcher?.close();
+      process.exit(0);
+    });
+  }
   const server = Bun.serve({
     port,
     async fetch(req, server2) {
@@ -8982,7 +9008,10 @@ async function startServer(options2) {
         return handleAPI(req, url, store, broadcast);
       }
       if (url.pathname === "/main.js" || url.pathname.startsWith("/main.js?")) {
-        const file = Bun.file(join9(buildDir, "main.js"));
+        let file = Bun.file(join9(buildDir, "main.js"));
+        if (!await file.exists()) {
+          file = Bun.file(join9(uiPath, "main.js"));
+        }
         if (await file.exists()) {
           return new Response(file, {
             headers: {
@@ -8993,7 +9022,10 @@ async function startServer(options2) {
         }
       }
       if (url.pathname === "/index.css" || url.pathname.startsWith("/index.css?")) {
-        const file = Bun.file(join9(buildDir, "index.css"));
+        let file = Bun.file(join9(buildDir, "index.css"));
+        if (!await file.exists()) {
+          file = Bun.file(join9(uiPath, "main.css"));
+        }
         if (await file.exists()) {
           return new Response(file, {
             headers: {
@@ -9081,7 +9113,11 @@ async function startServer(options2) {
   });
   console.log(`Server running at http://localhost:${port}`);
   console.log(`Open in browser: http://localhost:${port}`);
-  console.log(`Live reload enabled - watching ${uiPath}`);
+  if (shouldBuild) {
+    console.log(`Live reload enabled - watching ${uiPath}`);
+  } else {
+    console.log(`Serving pre-built UI from ${uiPath}`);
+  }
   if (open) {
     const openCommand = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
     try {

package/dist/ui/index.css

@@ -0,0 +1 @@
+@tailwind base;@tailwind components;@tailwind utilities;:root{font-family:system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Noto Sans,Ubuntu,Cantarell,Helvetica Neue,Arial,sans-serif;font-weight:400;line-height:1.5}body{min-height:100vh;margin:0}*{box-sizing:border-box}

package/dist/ui/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		<meta charset="UTF-8" />
+		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+		<title>Knowns.dev</title>
+	</head>
+	<body>
+		<div id="root"></div>
+		<script type="module" src="./main.tsx"></script>
+	</body>
+</html>

package/dist/ui/main.css

@@ -0,0 +1 @@
+@tailwind base;@tailwind components;@tailwind utilities;:root{font-family:system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Noto Sans,Ubuntu,Cantarell,Helvetica Neue,Arial,sans-serif;font-weight:400;line-height:1.5}body{min-height:100vh;margin:0}*{box-sizing:border-box}