hyperbook 0.77.6 → 0.77.7

package/README.md

@@ -0,0 +1,109 @@
+# hyperbook
+
+The main CLI tool for creating, building, and serving Hyperbook projects. Hyperbook is a quick and easy way to build interactive workbooks that support modern standards and run superfast.
+
+## Features
+
+- **Quick Project Setup** - Scaffold new projects with `hyperbook new`
+- **Development Server** - Live-reload development server with hot module replacement
+- **Production Builds** - Optimized static site generation
+- **Interactive Elements** - Support for 30+ custom directives (alerts, videos, code environments, etc.)
+- **Multi-language Support** - Built-in i18n for 7 languages
+- **Search** - Full-text search with Lunr.js
+- **Navigation** - Automatic navigation generation from file structure
+- **Themes** - Customizable colors and styling
+- **Archives** - Downloadable file archives for students
+- **Glossary** - Automatic term indexing and tooltips
+
+## Installation
+
+Install globally:
+
+```sh
+npm install -g hyperbook
+# or
+pnpm add -g hyperbook
+```
+
+Or use directly with npx:
+
+```sh
+npx hyperbook@latest new my-book
+```
+
+## Usage
+
+### Create a new Hyperbook project
+
+```sh
+hyperbook new my-documentation
+cd my-documentation
+```
+
+### Start development server
+
+```sh
+hyperbook dev
+# or with custom port
+hyperbook dev --port 3000
+```
+
+The development server will start at `http://localhost:8080` with live reload.
+
+### Build for production
+
+```sh
+hyperbook build
+```
+
+This generates a static site in the `public` directory ready for deployment.
+
+## Project Structure
+
+A Hyperbook project consists of:
+
+```
+my-book/
+├── hyperbook.json          # Main configuration
+├── glossary.md             # Glossary definitions
+├── book/                   # Content directory
+│   ├── index.md            # Home page
+│   ├── chapter1/
+│   │   ├── index.md
+│   │   └── page.md
+│   └── chapter2/
+│       └── index.md
+└── public/                 # Built output (after build)
+```
+
+## Configuration
+
+The `hyperbook.json` file configures your project:
+
+```json
+{
+  "name": "My Documentation",
+  "description": "Interactive documentation",
+  "language": "en",
+  "basePath": "",
+  "colors": {
+    "brand": "#3b82f6"
+  },
+  "links": [
+    {
+      "label": "GitHub",
+      "href": "https://github.com/org/repo"
+    }
+  ]
+}
+```
+
+## Learn More
+
+- **Documentation**: https://hyperbook.openpatch.org
+- **Repository**: https://github.com/openpatch/hyperbook
+- **Community**: https://matrix.to/#/#openpatch:matrix.org
+
+## License
+
+MIT © Mike Barkmin

package/dist/index.js

@@ -56006,7 +56006,60 @@ const mime_1 = __importDefault(__nccwpck_require__(94931));
 const ws_1 = __nccwpck_require__(55999);
 const chalk_1 = __importDefault(__nccwpck_require__(2434));
 const rimraf_1 = __nccwpck_require__(52114);
+const prompts_1 = __importDefault(__nccwpck_require__(63792));
+const net_1 = __importDefault(__nccwpck_require__(69278));
+async function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = net_1.default.createServer();
+        server.once('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                resolve(false);
+            }
+            else {
+                resolve(false);
+            }
+        });
+        server.once('listening', () => {
+            server.close();
+            resolve(true);
+        });
+        server.listen(port);
+    });
+}
+async function findFreePort(startPort) {
+    let port = startPort;
+    while (port < 65535) {
+        if (await isPortAvailable(port)) {
+            return port;
+        }
+        port++;
+    }
+    throw new Error('No free ports available');
+}
 async function runDev({ port = 8080 }) {
+    // Check if the port is available
+    const portAvailable = await isPortAvailable(port);
+    if (!portAvailable) {
+        console.log(chalk_1.default.yellow(`Port ${port} is already in use.`));
+        const response = await (0, prompts_1.default)({
+            type: 'confirm',
+            name: 'findFreePort',
+            message: 'Would you like to find and use a free port?',
+            initial: true
+        });
+        if (!response.findFreePort) {
+            console.log(chalk_1.default.red('Exiting dev server.'));
+            process.exit(0);
+        }
+        try {
+            port = await findFreePort(port + 1);
+            console.log(chalk_1.default.green(`Found free port: ${port}`));
+        }
+        catch (error) {
+            console.error(chalk_1.default.red('Could not find a free port.'));
+            process.exit(1);
+        }
+    }
     const root = process.cwd();
     const rootProject = await fs_1.hyperproject.get(root);
     const outDir = path_1.default.join(rootProject.src, ".hyperbook", "out");
@@ -201775,7 +201828,7 @@ module.exports = /*#__PURE__*/JSON.parse('{"application/1d-interleaved-parityfec
 /***/ ((module) => {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"hyperbook","version":"0.77.6","author":"Mike Barkmin","homepage":"https://github.com/openpatch/hyperbook#readme","license":"MIT","bin":{"hyperbook":"./dist/index.js"},"files":["dist"],"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/openpatch/hyperbook.git","directory":"packages/hyperbook"},"bugs":{"url":"https://github.com/openpatch/hyperbook/issues"},"engines":{"node":">=18"},"scripts":{"version":"pnpm build","lint":"tsc --noEmit","dev":"ncc build ./index.ts -w -o dist/","build":"rimraf dist && ncc build ./index.ts -o ./dist/ --no-cache --no-source-map-register --external favicons --external sharp && node postbuild.mjs"},"dependencies":{"favicons":"^7.2.0"},"devDependencies":{"create-hyperbook":"workspace:*","@hyperbook/fs":"workspace:*","@hyperbook/markdown":"workspace:*","@hyperbook/types":"workspace:*","@pnpm/exportable-manifest":"1000.0.6","@types/archiver":"6.0.3","@types/async-retry":"1.4.9","@types/cross-spawn":"6.0.6","@types/lunr":"^2.3.7","@types/prompts":"2.4.9","@types/tar":"6.1.13","@types/ws":"^8.5.14","@vercel/ncc":"0.38.3","archiver":"7.0.1","async-retry":"1.3.3","chalk":"5.4.1","chokidar":"4.0.3","commander":"12.1.0","cpy":"11.1.0","cross-spawn":"7.0.6","domutils":"^3.2.2","extract-zip":"^2.0.1","got":"12.6.0","htmlparser2":"^10.0.0","lunr":"^2.3.9","lunr-languages":"^1.14.0","mime":"^4.0.6","prompts":"2.4.2","rimraf":"6.0.1","tar":"7.4.3","update-check":"1.5.4","ws":"^8.18.0"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"hyperbook","version":"0.77.7","author":"Mike Barkmin","homepage":"https://github.com/openpatch/hyperbook#readme","license":"MIT","bin":{"hyperbook":"./dist/index.js"},"files":["dist"],"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/openpatch/hyperbook.git","directory":"packages/hyperbook"},"bugs":{"url":"https://github.com/openpatch/hyperbook/issues"},"engines":{"node":">=18"},"scripts":{"version":"pnpm build","lint":"tsc --noEmit","dev":"ncc build ./index.ts -w -o dist/","build":"rimraf dist && ncc build ./index.ts -o ./dist/ --no-cache --no-source-map-register --external favicons --external sharp && node postbuild.mjs"},"dependencies":{"favicons":"^7.2.0"},"devDependencies":{"create-hyperbook":"workspace:*","@hyperbook/fs":"workspace:*","@hyperbook/markdown":"workspace:*","@hyperbook/types":"workspace:*","@pnpm/exportable-manifest":"1000.0.6","@types/archiver":"6.0.3","@types/async-retry":"1.4.9","@types/cross-spawn":"6.0.6","@types/lunr":"^2.3.7","@types/prompts":"2.4.9","@types/tar":"6.1.13","@types/ws":"^8.5.14","@vercel/ncc":"0.38.3","archiver":"7.0.1","async-retry":"1.3.3","chalk":"5.4.1","chokidar":"4.0.3","commander":"12.1.0","cpy":"11.1.0","cross-spawn":"7.0.6","domutils":"^3.2.2","extract-zip":"^2.0.1","got":"12.6.0","htmlparser2":"^10.0.0","lunr":"^2.3.9","lunr-languages":"^1.14.0","mime":"^4.0.6","prompts":"2.4.2","rimraf":"6.0.1","tar":"7.4.3","update-check":"1.5.4","ws":"^8.18.0"}}');
 
 /***/ })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperbook",
-  "version": "0.77.6",
+  "version": "0.77.7",
   "author": "Mike Barkmin",
   "homepage": "https://github.com/openpatch/hyperbook#readme",
   "license": "MIT",
@@ -56,10 +56,10 @@
     "tar": "7.4.3",
     "update-check": "1.5.4",
     "ws": "^8.18.0",
+    "@hyperbook/fs": "0.24.1",
     "create-hyperbook": "0.3.2",
-    "@hyperbook/markdown": "0.48.6",
     "@hyperbook/types": "0.20.0",
-    "@hyperbook/fs": "0.24.1"
+    "@hyperbook/markdown": "0.48.6"
   },
   "scripts": {
     "version": "pnpm build",