poli0981andClaude Opus 4.7 315a6f0b92 feat: editor UX, batch hygiene, workspace persistence, TERMS (#16)
Đợt sửa lỗi 4 — single PR.

Code Editor (Input):
- Reverse mode now picks the closest CodeMirror language pack:
  yaml → @codemirror/lang-yaml, xml/resx → @codemirror/lang-xml,
  csv/tsv/toml/jsonl/markdown/sql/bson/cbor/msgpack → plain.
- Input wrapper gets `min-h-0` so a long paste scrolls inside the editor
  instead of pushing past the status bar.
- New `.scrollbar-hide` utility class in globals.css. Applied to
  .cm-scroller via CodeEditor's theme block, OutputPanel scroll
  container, and the About page wrapper. Window scrollbar untouched
  (a11y preserved).

Batch:
- Description / drop_idle / empty strings now take {{from}}+{{to}} and
  {{format}} placeholders. In reverse mode the drop zone reads e.g.
  "Drop YAML files here", description reads "Process multiple YAML
  files into JSON".
- batchStore dedup by (filename + size + lastModified). Re-dropping
  the same files reports a warning toast with i18n `batch.toast.duplicate`.
- Extension filter in InputPanel (single-file + Tauri native dialog +
  hidden input) and BatchPanel (handleAddFiles + onDropRejected).
  Wrong-extension files are skipped with a warning toast.

Workspace persistence:
- New src/stores/workspaceStore.ts. Owns input/format/direction/options.
  Convert → About → Convert no longer wipes the editor.
- ConverterWorkspace rewritten to consume the store; in-component state
  reduced to modal open/close + actionsRef.
- 6 new unit tests for the store; existing batchStore test count: 10.

UI/UX:
- About page wrapped in `flex-1 min-h-0 overflow-y-auto` so its content
  scrolls inside `<main>` instead of overflowing onto the footer.

Docs:
- New root-level TERMS.md (ToS / EULA): acceptance, GitHub ToS,
  Apache 2.0 inheritance, no warranty, user data ownership, acceptable
  use (incl. anti-malware-PR clause), trademarks, modifications,
  termination, contact. Linked from README.md and README.vi.md.

Deps:
- @codemirror/lang-yaml + @codemirror/lang-xml (both MIT, fall into the
  existing `codemirror` manualChunk).

Verification:
- typecheck / lint / 183 tests pass / build OK (Vite 8 / Rolldown 695ms).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 15:37:30 +07:00
2026-05-13 09:43:37 +07:00
2026-05-13 09:43:37 +07:00
2026-05-13 09:43:37 +07:00
2026-05-13 09:43:37 +07:00
2026-05-13 09:43:37 +07:00
2026-05-13 09:43:37 +07:00
2026-05-13 09:43:37 +07:00
2026-05-13 09:43:37 +07:00
2026-05-13 09:43:37 +07:00
2026-05-13 09:43:37 +07:00
2026-05-13 09:43:37 +07:00

JSONPrism

Disperse JSON into many formats.

One JSON input. Eight target formats. Fully in your browser.

CI Deploy License: Apache 2.0

Live demo · Tiếng Việt · Roadmap


JSONPrism is a refracting tool for developers. It takes a single JSON input and disperses it into many target formats — like white light through a prism. Everything runs client-side, so your data never leaves your device.

Target formats

Format Extension Status Reverse (→ JSON)
JSONL .jsonl ✅ Phase 1 ✅
CSV .csv ✅ Phase 1 ✅
TSV .tsv ✅ Phase 1 ✅
YAML .yaml ✅ Phase 1 ✅
XML .xml ✅ Phase 2 —
TOML .toml ✅ Phase 2 ✅
Markdown table .md ✅ Phase 2 —
SQL INSERT .sql ✅ Phase 2 —
RESX (.NET) .resx ✅ Phase 3 ✅
BSON .bson ✅ Phase 4 —
CBOR .cbor ✅ Phase 4 —
MessagePack .msgpack ✅ Phase 4 —

Features

  • Client-side only — no server, no telemetry, no upload. Your JSON stays in your browser.
  • Batch processing — up to 500 files at once (Phase 2).
  • Smart shape detection — recognizes flat objects, arrays of objects, scalars; suggests the best target format.
  • Per-format options — pretty-print, indentation, dialect (for SQL), alignment (for Markdown), and more.
  • Dark + light themes — Prism Spectrum palette with violet / cyan / amber / rose accents.
  • EN + VI — bilingual interface out of the box. More languages welcome.
  • Tauri desktop build — drag-and-drop file workflow, offline-first (Phase 2 milestone).

Tech stack

  • Vite 6 + React 19 + TypeScript 5.7
  • Tailwind CSS v4 + shadcn/ui (New York style, neutral base)
  • CodeMirror 6 for the input editor (Phase 1 polish)
  • PapaParse, js-yaml, smol-toml, fast-xml-parser for parsing/serialization
  • i18next for translations, Zustand for state, Sonner for toasts
  • Tauri 2 wrapper (Phase 2)

Quick start

Requirements: Node.js 22 LTS or newer.

git clone https://github.com/poli0981/jsonprism.git
cd jsonprism
npm install
npm run dev          # http://localhost:5173

Desktop app (Tauri 2)

JSONPrism also ships as a native desktop app via Tauri 2. The app uses the same React UI, with native OS dialogs and drag-drop hooked into the existing batch flow.

Additional requirements:

  • Rust toolchain (rustup) with the stable channel
  • Platform build deps:
    • Windows: Visual Studio Build Tools (C++ workload) + WebView2 (preinstalled on Windows 11)
    • macOS: Xcode Command Line Tools (xcode-select --install)
    • Linux: libwebkit2gtk-4.1-dev, libappindicator3-dev, librsvg2-dev, patchelf, libssl-dev

Generate icons once (uses Tauri's CLI to render the SVG to PNG/ICO/ICNS):

npm run tauri:icon

Run in dev mode (Vite + Tauri window with hot reload):

npm run tauri:dev

Build native bundles:

npm run tauri:build

Output:

  • Windows → src-tauri/target/release/bundle/msi/*.msi + nsis/*-setup.exe
  • macOS → src-tauri/target/release/bundle/dmg/*.dmg + macos/*.app
  • Linux → src-tauri/target/release/bundle/appimage/*.AppImage + deb/*.deb

Automated releases: pushing a v* tag triggers .github/workflows/release.yml, which builds for all platforms in parallel and creates a draft GitHub release.

Scripts

Script What it does
npm run dev Start Vite dev server with HMR
npm run build Production build to dist/
npm run preview Preview the built site locally
npm run lint Run ESLint
npm run lint:fix Run ESLint with autofix
npm run typecheck TypeScript type-check, no emit
npm run format Format with Prettier
npm run format:check Check formatting (CI uses this)

shadcn/ui components

The components.json is preconfigured. Add components on demand:

npx shadcn@latest add button input textarea tabs select card dialog sheet \
  dropdown-menu switch badge progress tooltip sonner resizable

Architecture

src/
├── app/                 # Router + global providers
├── components/
│   ├── ui/              # shadcn components (added on demand)
│   ├── layout/          # Header, Footer, ThemeToggle
│   ├── converter/       # Workspace, panels, format picker
│   └── common/          # ErrorBoundary, LanguageSwitcher
├── converters/          # One module per target format
│   ├── types.ts         # Converter interface
│   ├── registry.ts      # Lookup table
│   └── *.ts             # Per-format implementations
├── hooks/               # Custom hooks
├── i18n/                # Translations (en, vi)
├── lib/                 # detect, theme, utils, sample
├── pages/               # Home, About
├── styles/              # globals.css (Tailwind + theme tokens)
└── main.tsx

Adding a new format

Each format is a self-contained module implementing the Converter interface:

import type { Converter } from './types';

interface MyFormatOptions {
  indent: 2 | 4;
}

export const myFormatConverter: Converter<MyFormatOptions> = {
  meta: {
    id: 'myformat',
    labelKey: 'formats.myformat',
    extension: 'myf',
    mimeType: 'application/x-myformat',
    phase: 1,
    ready: true,
  },
  defaultOptions: { indent: 2 },
  convert({ data }, options) {
    try {
      const output = serialize(data, options);
      return { ok: true, output };
    } catch (err) {
      return { ok: false, error: (err as Error).message };
    }
  },
};

Then register it in src/converters/registry.ts and add label keys to src/i18n/locales/*.json.

See docs/ROADMAP.md for the full phase plan.

Contributing

Pull requests welcome — please read CONTRIBUTING.md first. PRs that match the auto-ignored patterns described there (suspicious code, off-topic preamble, no description, etc.) get closed without review.

For bug reports and feature requests, use GitHub Issues. For security vulnerabilities, use the private Security Advisory flow.

Project docs

Doc What's in it
PRIVACY.md Offline-first, localStorage-only, no telemetry.
TERMS.md ToS / EULA — acceptable use, license inheritance, user data ownership.
SECURITY.md How to report vulnerabilities; response SLAs.
DISCLAIMER.md One-person + AI-assisted project; no warranty.
THIRD-PARTY.md Every dependency: version, license, link.
MAINTAINERS.md Who's responsible for what.
CODE_OF_CONDUCT.md Contributor Covenant v2.1.
docs/ROADMAP.md Phase plan, current status.
docs/pc_spec.md · docs/dev_env.md Maintainer's hardware + toolchain.
docs/TAURI-NOTES.md Tauri build / process notes.
docs/RESX-MIGRATION.md i18next JSON → .NET RESX tutorial.

Acknowledgements

Substantial parts of JSONPrism's code, tests, translations, and docs were drafted with Claude Chat and Claude Code (Opus 4.7, 1M context). See DISCLAIMER.md for the full AI-assist disclosure. Translation quality for non-English locales is best-effort and contributions from native speakers are welcomed.

Sponsorship

If JSONPrism is useful to you, consider sponsoring the maintainer via any of the channels in .github/FUNDING.yml: GitHub Sponsors, Ko-fi, Buy Me a Coffee, Patreon, or PayPal.

License

Apache License 2.0 — © 2026 Kokone (@poli0981).

S
Description
No description provided
Readme Apache-2.0
1.2 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 96.4%
CSS 1.5%
Kotlin 0.7%
HTML 0.6%
Rust 0.4%
Other 0.4%