@pasmurno/serve 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 pasmurno by llcawc (github.com/llcawc)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# @pasmurno/serve
+
+simple static server for local development based [Vite](https://vite.dev/)
+
+## Getting started
+
+Install the @pasmurno/serve as global package:
+
+```sh
+npm install -g @pasmurno/serve
+```
+
+or install local in project:
+
+```sh
+npm install --save-dev @pasmurno/serve
+```
+
+## Commands
+
+Usage for global install:
+
+```sh
+$ serve [options]
+```
+
+Usage for install in project:
+
+```sh
+$ npx serve [options]
+```
+
+Use in package.json scripts:
+
+```json
+"scripts": {
+  "serve": "serve [options]"
+}
+```
+
+and start this:
+
+```sh
+$ npm run serve
+```
+
+## Options:
+
+```
+-v, --version output the current version
+-p, --port <n> server port number (default: 3000)
+-d, --dist [value] folder for serve files (default: dist)
+-h, --help display help for command
+```
+
+## Example call:
+
+```sh
+$ serve -p 4200 -d build
+...
+$ npx serve --port 8000 --dist './static'
+```
+
+API / Gulp
+You can programmatically start the local server if you import the server() function from the @pasmurno/serve package:
+
+```js
+import server from "@pasmurno/serve";
+
+async function browse() {
+  await server({
+    port: 8080, // server port number (default: 3000)
+    dist: "dist", // folder for serve files (default: dist)
+  });
+}
+```
+
+The best way to apply this can be found in the gulp project assignment.
+
+---
+
+## License
+
+MIT ©2025 pasmurno by [llcawc](https://github.com/llcawc). Made with ❤ to beautiful architecture

package/bin/serve.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../server/comm.js'

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@pasmurno/serve",
+  "version": "0.0.1",
+  "type": "module",
+  "bin": {
+    "serve": "bin/serve.js"
+  },
+  "main": "./server/index.js",
+  "exports": "./server/index.js",
+  "files": [
+    "bin",
+    "server",
+    "package.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "author": "llcawc",
+  "license": "MIT",
+  "homepage": "https://github.com/llcawc/serve",
+  "description": "Vite based static server for local development",
+  "scripts": {
+    "tsc": "tsc",
+    "make": "nodemon -e ts -x tsc -w ./source",
+    "dev": "vite",
+    "serve": "npx serve -p 8080",
+    "build": "vite build"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "gulp": "^5.0.1",
+    "nodemon": "^3.1.10",
+    "prettier": "^3.6.2",
+    "prettier-plugin-embed": "^0.5.0",
+    "prettier-plugin-organize-imports": "^4.2.0",
+    "sass": "^1.90.0",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "commander": "^14.0.0",
+    "vite": "^7.1.3"
+  }
+}

package/server/comm.d.ts

@@ -0,0 +1 @@
+export {};

package/server/comm.js

@@ -0,0 +1,19 @@
+import { Command } from 'commander';
+import serve from './viteview.js';
+const program = new Command();
+const header = '\n• Vite based live server for static files\n  @pasmurno/serve v.0.0.1\n';
+const footer = '\nMIT License ©2025 pasmurno by llcawc. Made with ❤ to beautiful architecture.';
+const example = '\nExample call:\n' +
+    '  • $ serve  // global use, default port: 3000, default folder: "dist"\n' +
+    '  • $ serve -p 4200 -d build\n' +
+    '  • $ npx serve --port 8000 --dist "./static"  // for local use';
+program.name('$ serve').usage('[options]');
+program.version('v.0.0.1', '-v, --version', 'output the current version');
+program.addHelpText('before', header).addHelpText('after', example).addHelpText('afterAll', footer);
+program
+    .option('-p, --port <n>', 'server port number (default: 8080)')
+    .option('-d, --dist [value]', 'folder for serve files (default: dist)')
+    .action((opt) => {
+    serve(opt.port, opt.dist);
+});
+program.parse(process.argv);

package/server/index.d.ts

@@ -0,0 +1,2 @@
+import server from './viteview.js';
+export default server;

package/server/index.js

@@ -0,0 +1,2 @@
+import server from './viteview.js';
+export default server;

package/server/viteview.d.ts

@@ -0,0 +1 @@
+export default function server(port?: number | undefined, dist?: string | undefined): Promise<void>;

package/server/viteview.js

@@ -0,0 +1,26 @@
+import { join, resolve } from 'node:path';
+import { preview } from 'vite';
+const __dirname = resolve();
+export default async function server(port = 3000, dist = undefined) {
+    if (dist) {
+        dist = resolve(__dirname, dist);
+    }
+    else {
+        dist = join(__dirname, 'dist');
+    }
+    const previewServer = await preview({
+        // any valid user config options, plus `mode` and `configFile`
+        mode: 'development',
+        build: {
+            outDir: dist,
+        },
+        preview: {
+            port,
+            open: false,
+        },
+    });
+    // Root log
+    console.log('  ➜  Root:   ', dist);
+    previewServer.printUrls();
+    previewServer.bindCLIShortcuts({ print: true });
+}