lvr.js 0.0.0

package/README.md

@@ -0,0 +1,87 @@
+# Lvr.js: Lvr for JS/TS
+
+[![License](https://img.shields.io/badge/license-Public%20Domain-blue.svg)](https://unlicense.org)
+[![Compatibility](https://img.shields.io/badge/typescript-5.4%2B-blue)](https://typescriptlang.org/docs/handbook/release-notes/typescript-5-4.html)
+[![Package](https://img.shields.io/npm/v/lvr.js)](https://npmjs.com/package/lvr.js)
+
+**[Lvr] for [JavaScript]/[TypeScript].**
+
+> [!TIP]
+> 🚧 _We are building in public. This is presently under heavy construction._
+
+<sub>
+
+[[Features](#-features)] |
+[[Prerequisites](#%EF%B8%8F-prerequisites)] |
+[[Installation](#%EF%B8%8F-installation)] |
+[[Examples](#-examples)] |
+[[Reference](#-reference)] |
+[[Development](#%E2%80%8D-development)]
+
+</sub>
+
+## ✨ Features
+
+- 100% pure and safe TypeScript with zero dependencies and no bloat.
+- Cuts red tape: 100% free and unencumbered public domain software.
+- Polyglot software also available for Dart, Python, Ruby, and Rust.
+
+## 🛠️ Prerequisites
+
+- [TypeScript] 5.4+
+- [Node.js] 24+ (LTS)
+
+## ⬇️ Installation
+
+### Installation with Bun
+
+```bash
+bun add --dev lvr.js
+```
+
+### Installation with NPM
+
+```bash
+npm install --save-dev lvr.js
+```
+
+### Installation with pnpm
+
+```bash
+pnpm add --save-dev lvr.js
+```
+
+### Installation with yarn
+
+```bash
+yarn add --dev lvr.js
+```
+
+## 👉 Examples
+
+### Importing the Library
+
+```typescript
+import * as Lvr from 'lvr.js'
+```
+
+## 📚 Reference
+
+## 👨‍💻 Development
+
+```bash
+git clone https://github.com/artob/lvr.git
+```
+
+---
+
+[![Share on X](https://img.shields.io/badge/share%20on-x-03A9F4?logo=x)](https://x.com/intent/post?url=https://github.com/artob/lvr&text=Lvr)
+[![Share on Reddit](https://img.shields.io/badge/share%20on-reddit-red?logo=reddit)](https://reddit.com/submit?url=https://github.com/artob/lvr&title=Lvr)
+[![Share on Hacker News](https://img.shields.io/badge/share%20on-hn-orange?logo=ycombinator)](https://news.ycombinator.com/submitlink?u=https://github.com/artob/lvr&t=Lvr)
+[![Share on Facebook](https://img.shields.io/badge/share%20on-fb-1976D2?logo=facebook)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/artob/lvr)
+[![Share on LinkedIn](https://img.shields.io/badge/share%20on-linkedin-3949AB?logo=linkedin)](https://www.linkedin.com/sharing/share-offsite/?url=https://github.com/artob/lvr)
+
+[Lvr]: https://lvr.dev
+[JavaScript]: https://developer.mozilla.org/en-US/docs/Web/JavaScript
+[Node.js]: https://nodejs.org
+[TypeScript]: https://typescriptlang.org

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+type RunResult = {
+    stdout: string;
+    stderr: string;
+    code: number | null;
+};
+/**
+ * Run an external CLI and capture its output.
+ * This is intentionally minimal — real callers should add timeouts, retries and streaming as needed.
+ */
+declare function runCLI(command: string, args?: string[]): Promise<RunResult>;
+declare const _default: {
+    runCLI: typeof runCLI;
+};
+
+export { type RunResult, _default as default, runCLI };

package/dist/index.js

@@ -0,0 +1,27 @@
+// src/index.ts
+import { spawn } from "child_process";
+async function runCLI(command, args = []) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk.toString();
+    });
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on("error", (err) => reject(err));
+    child.on(
+      "close",
+      (code) => resolve({ stdout, stderr, code })
+    );
+  });
+}
+var index_default = {
+  runCLI
+};
+export {
+  index_default as default,
+  runCLI
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "lvr.js",
+  "version": "0.0.0",
+  "description": "Lvr for JS/TS",
+  "homepage": "https://lvr.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/artob/lvr.git"
+  },
+  "bugs": {
+    "url": "https://github.com/artob/lvr/issues"
+  },
+  "author": {
+    "name": "Arto Bendiken",
+    "email": "arto@bendiken.net",
+    "url": "https://ar.to"
+  },
+  "license": "Unlicense",
+  "keywords": [
+    "lvr"
+  ],
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "UNLICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --out-dir dist",
+    "clean": "rm -rf dist",
+    "prepare": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "latest",
+    "tsup": "latest",
+    "typescript": "^5.4.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,40 @@
+// This is free and unencumbered software released into the public domain.
+
+import { spawn } from "child_process";
+
+export type RunResult = {
+  stdout: string;
+  stderr: string;
+  code: number | null;
+};
+
+/**
+ * Run an external CLI and capture its output.
+ * This is intentionally minimal — real callers should add timeouts, retries and streaming as needed.
+ */
+export async function runCLI(
+  command: string,
+  args: string[] = [],
+): Promise<RunResult> {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+
+    child.stdout?.on("data", (chunk: Buffer | string) => {
+      stdout += chunk.toString();
+    });
+    child.stderr?.on("data", (chunk: Buffer | string) => {
+      stderr += chunk.toString();
+    });
+
+    child.on("error", (err: Error) => reject(err));
+    child.on("close", (code: number | null) =>
+      resolve({ stdout, stderr, code }),
+    );
+  });
+}
+
+export default {
+  runCLI,
+};