formatarc 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FormatArc
+
+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,103 @@
+# formatarc
+
+Convert JSON, YAML, and CSV from the terminal. No config, no dependencies to manage — just pipe or pass your data.
+
+**Web version → [formatarc.com](https://formatarc.com)**
+
+## Install
+
+```bash
+npm install -g formatarc
+```
+
+Or run directly with `npx`:
+
+```bash
+npx formatarc json-format '{"a":1}'
+```
+
+## Usage
+
+```
+formatarc <tool> [input or file]
+cat file | formatarc <tool>
+```
+
+### Tools
+
+| Command | Description |
+|---------|-------------|
+| `json-format` | Pretty-print JSON |
+| `yaml-to-json` | Convert YAML to JSON |
+| `json-to-yaml` | Convert JSON to YAML |
+| `csv-to-json` | Convert CSV (with header row) to JSON |
+
+### Examples
+
+Format JSON:
+
+```bash
+formatarc json-format '{"name":"FormatArc","tools":["json","yaml","csv"]}'
+```
+
+```json
+{
+  "name": "FormatArc",
+  "tools": [
+    "json",
+    "yaml",
+    "csv"
+  ]
+}
+```
+
+Convert a YAML file to JSON:
+
+```bash
+formatarc yaml-to-json config.yaml
+```
+
+Pipe from curl:
+
+```bash
+curl -s https://api.example.com/data | formatarc json-format
+```
+
+Convert CSV from stdin:
+
+```bash
+cat users.csv | formatarc csv-to-json
+```
+
+## Programmatic API
+
+```typescript
+import { convert } from "formatarc";
+
+const result = convert("json-format", '{"a":1}');
+console.log(result.output);
+// {
+//   "a": 1
+// }
+```
+
+### `convert(tool, input)`
+
+Returns `{ output: string, error: string }`.
+
+- `output` — the converted result (empty string on error)
+- `error` — error message (empty string on success)
+
+## Web Version
+
+For a browser-based experience with no signup and no data upload:
+
+**[formatarc.com](https://formatarc.com)**
+
+- JSON Formatter, YAML ↔ JSON, CSV → JSON
+- Runs entirely in the browser
+- Multilingual (English / Japanese)
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import { readFileSync, existsSync } from "fs";
+import { convert, isValidTool } from "./converter.js";
+const USAGE = `
+formatarc — convert JSON, YAML, and CSV from the terminal
+
+Usage:
+  formatarc <tool> [input]
+  formatarc <tool> <file>
+  cat file | formatarc <tool>
+
+Tools:
+  json-format   Pretty-print JSON
+  yaml-to-json  Convert YAML to JSON
+  json-to-yaml  Convert JSON to YAML
+  csv-to-json   Convert CSV to JSON
+
+Examples:
+  formatarc json-format '{"a":1}'
+  formatarc yaml-to-json config.yaml
+  cat data.csv | formatarc csv-to-json
+
+Web version: https://formatarc.com
+`.trim();
+function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+        console.log(USAGE);
+        process.exit(0);
+    }
+    const toolArg = args[0];
+    if (!isValidTool(toolArg)) {
+        console.error(`Unknown tool: ${toolArg}\n`);
+        console.error(USAGE);
+        process.exit(1);
+    }
+    const tool = toolArg;
+    let input;
+    if (args[1]) {
+        if (existsSync(args[1])) {
+            input = readFileSync(args[1], "utf-8");
+        }
+        else {
+            input = args[1];
+        }
+    }
+    else if (!process.stdin.isTTY) {
+        input = readFileSync(0, "utf-8");
+    }
+    else {
+        console.error("No input provided. Pass a string, a file path, or pipe from stdin.\n");
+        console.error(USAGE);
+        process.exit(1);
+    }
+    const result = convert(tool, input);
+    if (result.error) {
+        console.error(result.error);
+        process.exit(1);
+    }
+    process.stdout.write(result.output + "\n");
+}
+main();

package/dist/converter.d.ts

@@ -0,0 +1,7 @@
+export type ConvertResult = {
+    output: string;
+    error: string;
+};
+export type Tool = "json-format" | "yaml-to-json" | "json-to-yaml" | "csv-to-json";
+export declare function isValidTool(value: string): value is Tool;
+export declare function convert(tool: Tool, input: string): ConvertResult;

package/dist/converter.js

@@ -0,0 +1,71 @@
+import Papa from "papaparse";
+import YAML from "yaml";
+const TOOLS = ["json-format", "yaml-to-json", "json-to-yaml", "csv-to-json"];
+export function isValidTool(value) {
+    return TOOLS.includes(value);
+}
+export function convert(tool, input) {
+    if (!input.trim()) {
+        return { output: "", error: "Input is empty." };
+    }
+    try {
+        switch (tool) {
+            case "json-format":
+                return {
+                    output: JSON.stringify(JSON.parse(input), null, 2),
+                    error: "",
+                };
+            case "yaml-to-json":
+                return {
+                    output: JSON.stringify(YAML.parse(input), null, 2),
+                    error: "",
+                };
+            case "json-to-yaml":
+                return {
+                    output: YAML.stringify(JSON.parse(input)),
+                    error: "",
+                };
+            case "csv-to-json":
+                return convertCsv(input);
+            default:
+                return { output: "", error: `Unknown tool: ${tool}` };
+        }
+    }
+    catch (err) {
+        return { output: "", error: formatError(err, input, tool) };
+    }
+}
+function convertCsv(input) {
+    const parsed = Papa.parse(input, {
+        header: true,
+        skipEmptyLines: "greedy",
+        transformHeader: (h) => h.trim(),
+    });
+    if (!parsed.meta.fields?.length || parsed.meta.fields.every((f) => !f)) {
+        return { output: "", error: "CSV header row is missing." };
+    }
+    if (parsed.errors.length > 0) {
+        const first = parsed.errors[0];
+        const row = typeof first.row === "number" ? ` (row ${first.row + 1})` : "";
+        return { output: "", error: `CSV parse error: ${first.message}${row}` };
+    }
+    return {
+        output: JSON.stringify(parsed.data, null, 2),
+        error: "",
+    };
+}
+function formatError(err, input, tool) {
+    if (err instanceof YAML.YAMLParseError) {
+        const line = err.linePos?.[0]?.line;
+        return line ? `YAML syntax error near line ${line}.` : "YAML syntax error.";
+    }
+    if (err instanceof Error && err.name === "SyntaxError") {
+        const match = err.message.match(/position\s+(\d+)/i);
+        if (match) {
+            const line = input.slice(0, Number(match[1])).split("\n").length;
+            return `Invalid JSON near line ${line}.`;
+        }
+        return "Invalid JSON.";
+    }
+    return "Failed to parse input. Check the format.";
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "formatarc",
+  "version": "0.1.0",
+  "description": "Convert JSON, YAML, and CSV from the terminal. Browser-based version at formatarc.com.",
+  "keywords": [
+    "json",
+    "yaml",
+    "csv",
+    "formatter",
+    "converter",
+    "json-formatter",
+    "yaml-to-json",
+    "csv-to-json",
+    "cli"
+  ],
+  "author": "FormatArc",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/m-naoki-m/formatarc.git"
+  },
+  "homepage": "https://formatarc.com",
+  "type": "module",
+  "main": "./dist/converter.js",
+  "types": "./dist/converter.d.ts",
+  "bin": {
+    "formatarc": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "papaparse": "^5.5.2",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/papaparse": "^5.3.15",
+    "typescript": "^5.8.3"
+  }
+}