{"_rev":"4-2d73ec0e916cff376aa5a8b1de543579","time":{"created":"2025-09-01T23:11:07.483Z","modified":"2025-09-01T23:11:08.004Z","1.0.1":"2025-09-01T22:33:07.510Z","1.0.0":"2025-09-01T22:51:33.967Z","1.0.2":"2025-09-01T23:11:07.733Z"},"_id":"@0xtbug/basa","name":"@0xtbug/basa","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.2":{"name":"@0xtbug/basa","version":"1.0.2","description":"🌍 Basa - AI-powered Markdown translator using Google Gemini","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","start":"npm run build && node dist/cli.js","dev":"ts-node src/cli.ts","test":"jest","test:watch":"jest --watch","coverage":"jest --coverage","clean":"rimraf dist","prepublishOnly":"npm run clean && npm run build"},"bin":{"basa":"dist/cli.js"},"keywords":["basa","translate","translation","mdx","markdown","gemini","ai","typescript","i18n","localization","cli"],"author":{"name":"0xtbug"},"repository":{"type":"git","url":"git+https://github.com/0xtbug/basa.git"},"bugs":{"url":"https://github.com/0xtbug/basa/issues"},"homepage":"https://github.com/0xtbug/basa#readme","dependencies":{"@google/genai":"^1.15.0","keytar":"^7.9.0","yargs":"^17.7.2"},"devDependencies":{"@types/node":"^20.0.0","@types/yargs":"^17.0.0","@types/jest":"^29.5.12","jest":"^29.7.0","ts-jest":"^29.1.1","rimraf":"^5.0.0","ts-node":"^10.9.0","typescript":"^5.0.0"},"publishConfig":{"access":"public"},"engines":{"node":">=16.0.0"},"_id":"@0xtbug/basa@1.0.2","gitHead":"defff7fed8c4eb346ec91a0dc2c6570beaa7791e","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-jWWLoagEVNeMHgYThGv+/Gxsnm+vNbYoxrS6VD9l3eeG9K7aPvyI+tXthen47vkzGIiIqQZ9NhxrZ+B5sK2sDQ==","shasum":"28bee60f4ba0300a23f8e745a8074b8e45131024","tarball":"https://registry.npmjs.org/@0xtbug/basa/-/basa-1.0.2.tgz","fileCount":42,"unpackedSize":49672,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBYPXTNiQh4zqL9UIF3DJ5P27PtvXwi81DbE/8gop7KWAiBTbTp/QPTSRDKB2l4mR2scxqvEJ+N5eGs9sii1QNISfQ=="}]},"_npmUser":{"name":"0xtbug","email":"tubagus.nabil19@gmail.com"},"directories":{},"maintainers":[{"name":"0xtbug","email":"tubagus.nabil19@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/basa_1.0.2_1756768267579_0.8264233440968523"},"_hasShrinkwrap":false}},"maintainers":[{"name":"0xtbug","email":"tubagus.nabil19@gmail.com"}],"description":"🌍 Basa - AI-powered Markdown translator using Google Gemini","homepage":"https://github.com/0xtbug/basa#readme","keywords":["basa","translate","translation","mdx","markdown","gemini","ai","typescript","i18n","localization","cli"],"repository":{"type":"git","url":"git+https://github.com/0xtbug/basa.git"},"author":{"name":"0xtbug"},"bugs":{"url":"https://github.com/0xtbug/basa/issues"},"readme":"# Basa (ᮘᮞ)\n> _In Sundanese, Basa (ᮘᮞ) means “language.”_\n\nAI-powered Markdown translator using Google Gemini. Basa translates `.md`/`.mdx` (and common markdown variants) while preserving formatting, code blocks, and links. It can process single or multiple files and writes outputs with a clear naming pattern.\n\n## Install\n- Global: `npm i -g @0xtbug/basa`\n- Node: `>= 16`\n\n## Usage\n```\nbasa [files...] -l <language> -k <API_KEY>\n```\n- Input: `.md`, `.mdx`, `.markdown`, `.mdown`, `.mkdn`, `.mdtxt`, `.mdtext`, `.txt`\n\nNotes\n- `-o/--output` is optional.\n  - Single file: if omitted, the translated file is written next to the input file.\n  - Multiple files: if omitted, each translated file is written next to its source; if provided, treat `-o` as an output directory.\n\nExamples\n- Single file: `basa sample.mdx -l fr -k \"$GEMINI_API_KEY\"`\n- Multiple files (positional): `basa a.mdx b.md -l id -k \"$GEMINI_API_KEY\" -o out/`\n- With flags: `basa -f a.mdx -f b.md -l zh -k \"$GEMINI_API_KEY\"`\n- Multiple languages (space-separated): `basa sample.mdx -l zh id th in -k \"$GEMINI_API_KEY\"`\n- Multiple languages (comma-separated): `basa sample.mdx -l zh,id,th,in -k \"$GEMINI_API_KEY\"`\n\nRun `basa --help` for full options.\n\n## Development\n- Clone: `git clone https://github.com/0xtbug/basa`\n- Install deps: `npm install`\n- Dev CLI: `npm run dev -f sample.mdx -l fr -k \"<API_KEY>\"`\n- Build: `npm run build`\n- Local link: `npm run build && npm link` then run `basa ...`\n\n## Testing\n- Run tests: `npm test`\n- Coverage: `npm run coverage`\n\n## Project Structure\n- `src/cli/`: CLI (yargs) entry and parsing\n- `src/core/`: Translator orchestration\n- `src/services/`: AI adapter (Gemini)\n- `src/utils/`: File/language/loading helpers\n- `src/constants/` and `src/types/`\n\n## Contributing\nPlease read Repository Guidelines in `AGENTS.md` for coding style, test conventions, and PR requirements.\n","readmeFilename":"README.md"}