@dephub/write 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2025 Estarlin R
+
+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,119 @@
+# @dephub/write 📝
+
+> A utility for writing files with automatic directory creation in Node.js and browsers.
+
+[![NPM version](https://img.shields.io/npm/v/@dephub/write.svg?style=flat)](https://npmjs.org/package/@dephub/write)
+[![ESM-only](https://img.shields.io/badge/ESM-only-brightgreen?style=flat)](https://nodejs.org/)
+[![Node.js version](https://img.shields.io/badge/node-%3E%3D22.5.0-brightgreen.svg)](https://nodejs.org/)
+
+---
+
+## Features ✨
+
+- 📄 **Simple File Writing** - Write content to files with one function call
+- 🗂️ **Automatic Directories** - Creates parent directories if they don't exist
+- 🎯 **TypeScript Ready** - Full type safety with zero configuration
+- 🌐 **Universal** - Works in Node.js and browser environments
+- ⚡ **Lightweight** - Minimal dependencies, focused functionality
+
+---
+
+## Installation 📦
+
+```bash
+npm install @dephub/write
+# or
+pnpm add @dephub/write
+# or
+yarn add @dephub/write
+```
+
+---
+
+## Usage 🎯
+
+### Programmatic API
+
+```typescript
+import { writeFile } from '@dephub/write';
+
+// Write simple content
+await writeFile('output.txt', 'Hello World!');
+
+// Write multi-line content
+await writeFile(
+  'README.md',
+  `
+# My Project
+
+This is a sample README file.
+
+## Features
+- Feature 1
+- Feature 2
+`.trim(),
+);
+
+// Write JSON data
+await writeFile(
+  'config.json',
+  JSON.stringify(
+    {
+      name: 'my-app',
+      version: '1.0.0',
+    },
+    null,
+    2,
+  ),
+);
+```
+
+### CLI Usage
+
+```bash
+# Quick one-time usage (no installation):
+npx @dephub/write output.txt "Hello World"
+
+# Write from stdin
+echo "File content" | npx @dephub/write output.txt
+
+# For frequent usage, install globally:
+npm install -g @dephub/write
+write output.txt "Hello World"
+
+# Or use with package managers:
+pnpm dlx @dephub/write output.txt "Hello World"
+yarn dlx @dephub/write output.txt "Hello World"
+```
+
+---
+
+## API Reference 📚
+
+### `writeFile(filePath, content)`
+
+Writes content to a file, creating directories if needed.
+
+**Parameters:**
+
+- `filePath` (string) - Full path to the file including filename
+- `content` (string) - Content to write to the file
+
+**Returns:** `Promise<void>`
+
+**Example:**
+
+```typescript
+import { writeFile } from '@dephub/write';
+
+await writeFile('dist/bundle.js', 'console.log("Hello")');
+await writeFile('src/config.json', JSON.stringify(config, null, 2));
+```
+
+---
+
+## License 📄
+
+MIT License – see [LICENSE](LICENSE) for details.
+
+**Author:** Estarlin R ([estarlincito.com](https://estarlincito.com))

package/dist/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { cli as o } from "@dephub/cli";
+import { error as r, success as s } from "@dephub/log";
+import { writeFile as a } from "./core/write.js";
+import { name as d, version as c, description as m } from "./utils/pkg.js";
+o.name(d.split("/")[1] ?? "write").version(c).description(m).argument("<filepath>", "Path where the file will be written").argument("[content]", "Content to write (if not provided, reads from stdin)").action(async ({ args: n }) => {
+  const [e, i] = n;
+  try {
+    let t = i;
+    i || (t = await p(), t || (r("No content provided and stdin is empty"), process.exit(1))), await a(e, t), s(`Written to ${e}`);
+  } catch (t) {
+    r(`Failed to write to ${e}: ${t.message}`), process.exit(1);
+  }
+});
+const p = () => new Promise((n, e) => {
+  let i = "";
+  process.stdin.setEncoding("utf8"), process.stdin.on("data", (t) => i += t), process.stdin.on("end", () => n(i.trim())), process.stdin.on("error", e), process.stdin.isTTY && setTimeout(() => n(""), 100);
+});
+await o.run();

package/dist/core/write.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Writes content to a file, creating directories if needed
+ * @param filePath - Full path to the file including filename
+ * @param content - Content to write to the file
+ * @example
+ * ```typescript
+ * await writeFile('dist/app.js', 'console.log("hello")');
+ * await writeFile('src/components/Button.tsx', componentCode);
+ * ```
+ */
+export declare const writeFile: (filePath: string, content: string) => Promise<void>;

package/dist/core/write.js

@@ -0,0 +1,10 @@
+import { existsSync as e } from "node:fs";
+import { mkdir as o, writeFile as m } from "node:fs/promises";
+import a from "node:path";
+const p = async (i, t) => {
+  const r = a.dirname(i);
+  e(r) || await o(r, { recursive: !0 }), await m(i, t);
+};
+export {
+  p as writeFile
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { writeFile } from './core/write.js';
+export { writeFile as default } from './core/write.js';

package/dist/index.js

@@ -0,0 +1,5 @@
+import { writeFile as r, writeFile as t } from "./core/write.js";
+export {
+  r as default,
+  t as writeFile
+};

package/dist/package.json.js

@@ -0,0 +1,11 @@
+const t = "@dephub/write", i = "1.0.0", o = "File writing utility with automatic directory creation for Node.js", e = {
+  name: t,
+  version: i,
+  description: o
+};
+export {
+  e as default,
+  o as description,
+  t as name,
+  i as version
+};

package/dist/utils/pkg.d.ts

@@ -0,0 +1 @@
+export declare const version: string, description: string, name: string;

package/dist/utils/pkg.js

@@ -0,0 +1,7 @@
+import o from "../package.json.js";
+const { version: e, description: i, name: n } = o ?? {};
+export {
+  i as description,
+  n as name,
+  e as version
+};

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@dephub/write",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "File writing utility with automatic directory creation for Node.js",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "bin": {
+    "write": "./dist/cli.js"
+  },
+  "keywords": [
+    "file",
+    "write",
+    "filesystem",
+    "typescript",
+    "node",
+    "esm",
+    "utility",
+    "directory",
+    "creation",
+    "dephub"
+  ],
+  "author": {
+    "name": "Estarlin R",
+    "email": "dev@estarlincito.com",
+    "url": "https://estarlincito.com"
+  },
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "files": [
+    "LICENSE",
+    "README.md",
+    "dist"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/dephubjs/write#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dephubjs/write.git",
+    "directory": "packages/write"
+  },
+  "bugs": {
+    "url": "https://github.com/dephubjs/write/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@dephub/log": "^1.0.0",
+    "@dephub/cli": "^1.0.0"
+  },
+  "scripts": {
+    "release": "pnpm publish",
+    "check-types": "tsc --noEmit --skipLibCheck",
+    "lint": "lint . --max-warnings 0",
+    "lint:fix": "lint . --fix",
+    "clean": "rm -rf dist",
+    "build": "vite build",
+    "dev": "vite build -w --mode development"
+  }
+}