import { parseArgs } from "@visulima/command-line-args";

const definitions = [
    {
        name: "file",           // Long option: --file
        alias: "f",             // Short option: -f
        type: String,           // Type conversion
        defaultValue: "in.txt", // Default value
        multiple: false,        // Single value (default)
    },
];

const options = parseArgs(definitions);

{ name: "file", type: String }
// --file input.txt → { file: "input.txt" }

{ name: "count", type: Number }
// --count 42 → { count: 42 }

{ name: "verbose", type: Boolean }
// --verbose → { verbose: true }
// (no flag) → { verbose: false }

const options = parseArgs([
    { name: "include", type: String, multiple: true },
]);

// node script.js --include src --include lib --include test
// { include: ["src", "lib", "test"] }

const options = parseArgs([
    { name: "files", type: String, multiple: true, defaultOption: true },
]);

// node script.js file1.txt file2.txt file3.txt
// { files: ["file1.txt", "file2.txt", "file3.txt"] }

const options = parseArgs(definitions, { partial: true });
// Unknown options are preserved in _unknown array

const options = parseArgs(definitions, { stopAtFirstUnknown: true });
// Stops parsing at first unknown option

const options = parseArgs(definitions, { camelCase: true });
// --my-option becomes myOption

import { parseArgs } from "@visulima/command-line-args";

const options = parseArgs([
    { name: "input", alias: "i", type: String, defaultValue: "stdin" },
    { name: "output", alias: "o", type: String, defaultValue: "stdout" },
    { name: "verbose", alias: "v", type: Boolean },
    { name: "port", alias: "p", type: Number, defaultValue: 3000 },
    { name: "include", type: String, multiple: true },
    { name: "files", type: String, multiple: true, defaultOption: true },
]);

// node script.js -i data.json -o result.json -v -p 8080 --include lib --include src file1.js file2.js
// Result:
// {
//   input: "data.json",
//   output: "result.json",
//   verbose: true,
//   port: 8080,
//   include: ["lib", "src"],
//   files: ["file1.js", "file2.js"]
// }