The last release before JSONPrism moves to maintenance mode.
- Dependencies at their latest releases, superseding Dependabot
#183-#191. i18next 27.1.3, react-i18next 18.0.2 and jsdom 31.0.1 are
majors; cargo update within semver (wry 0.57.2, tauri-plugin-opener
2.7.3); sonarqube-scan-action 8.5.0 and setup-java 6.3.0.
THIRD-PARTY.md is re-synced with both lockfiles.
- Qodana: a new workflow runs Qodana for JS (native mode) and Qodana for
Rust (EAP, Docker, as root with a bootstrap for the C toolchain and
GTK/WebKit headers). Both report to Qodana Cloud.
- Qodana findings, all fixed or documented:
- React types are imported instead of read from the UMD global.
- XMLBuilder comes from fast-xml-builder; XMLValidator stays, with a
documented suppression.
- act() calls in tests are synchronous.
- The Range geometry test stub is shared.
- Small regex and boolean cleanups.
- Two false positives are excluded with their reasons: a secret
reference, and serde_json, which tauri::generate_context!() needs.
- Maintenance mode:
- status badge and section in both READMEs;
- the policy in CONTRIBUTING;
- converter and translation issue templates;
- a Scope checklist in the PR template;
- ROADMAP Phase 11;
- maintenance-triage.yml closes out-of-scope feature requests with a
bilingual comment;
- a Dependabot group for the two fast-xml packages.
- Release 2.2.1: versionCode 20201, CHANGELOG.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
66 KiB
Changelog
All notable changes to JSONPrism are documented here.
The format follows Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased]
No unreleased changes. JSONPrism is in maintenance mode: CONTRIBUTING.md → Maintenance mode lists what still changes.
[2.2.1] — 2026-11-16
A maintenance release, and the start of maintenance mode. JSONPrism is feature-complete. From now on it gets dependency and security updates, major runtime upgrades, bug, UI/UX, accessibility and translation fixes, converter additions or removals that people really need, and Cloudflare or website fixes, but no new features. Conversions work exactly as before, nothing new is collected, and you are not asked to accept the terms again. bundle.android.versionCode 20201.
Dependencies
- npm (app): i18next 27.1.3 and react-i18next 18.0.2 are new majors; their changed defaults don't apply here (
fallbackLngis set, no translation is empty, noTrans, SSR or mocks). Also lucide-react 1.73, zustand 5.1, react-dropzone 20.2, papaparse 5.7.1, fast-xml-parser 5.12.1,@codemirror/lint6.9.8 and@tauri-apps/plugin-opener2.7.3. - npm (dev):
- ESLint 10.15, typescript-eslint 8.72.2, eslint-plugin-react-refresh 0.5.8;
- Vite 8.3.8,
@vitejs/plugin-react6.3, Tailwind CSS and@tailwindcss/vite4.3.5; - Prettier 3.10.1, knip 6.45.1, wrangler 4.162;
- jsdom 31.0.1 (a new major, tests only),
@testing-library/user-event14.6.12.
- Rust:
cargo updatewithin semver: wry 0.57.2, tauri-plugin-opener 2.7.3 and 43 other crates. - GitHub Actions: SonarSource/sonarqube-scan-action 8.5.0, actions/setup-java 6.3.0.
fast-xml-builder1.3.2 is now a direct dependency (see Fixed).- All 414 packages have verified registry signatures, and
THIRD-PARTY.mdmatches both lockfiles again. - Supersedes Dependabot PRs #183–#191.
Fixed
Findings from the first Qodana run. None of them is visible in the app.
- XML builder: the XML converter now uses
fast-xml-builderdirectly. fast-xml-parser 5 deprecated its ownXMLBuilderexport, which only re-exported that package, so the output is identical. - React types: imported from
reactinstead of read from the globalReactnamespace. - Tests:
- synchronous
act()calls no longer return a promise nobody awaits; - the jsdom Range geometry stub is shared, and restored correctly after each file.
- synchronous
- Small cleanups: two redundant regular-expression constructs and a redundant boolean comparison.
Project
- Maintenance mode:
- a status badge and section in both READMEs;
- the policy in CONTRIBUTING.md;
- converter and translation issue templates instead of the feature request template;
- a scope checklist in the pull request template.
- Auto-close:
maintenance-triage.ymlcloses out-of-scope feature requests with a bilingual comment. - Qodana: Qodana for JS (native mode) and Qodana for Rust (Early Access) run on every push and pull request and report to Qodana Cloud.
- Cleanup: merged and stale branches and old worktrees were removed.
Security
- No known vulnerability affects the app or the website.
- i18next 27.1.3 includes the fix for GHSA-q76c-gcvw-89x9. That issue needs a backend connector, which JSONPrism doesn't use.
npm auditstill lists minimatch < 11.0.1 (GHSA-g3hv-75wg-m249, moderate) through typescript-eslint, a development tool:- ESLint 10.15 itself has moved to minimatch 11;
@typescript-eslint/typescript-estreestill requires minimatch 10, but only for typed-linting globs, which this project's ESLint config doesn't use.
[2.2.0] — 2026-11-09
An accessibility release. JSONPrism now has an accessibility statement, ACCESSIBILITY.md, which targets WCAG 2.2 AA. The maintainer's keyboard-only and Narrator pass on 2.1.1 found no blocking issues; this release fixes the gaps an audit found beyond that pass. bundle.android.versionCode 20200.
Added
-
Skip to content. The first Tab stop on every page jumps past the header to the page content.
-
Focus follows you.
- After you move to another page, focus moves to its content.
- After you accept the consent screen, focus moves to the page instead of being lost.
- Back to top returns focus to the page it scrolled.
-
Zoom in the desktop apps. Ctrl/⌘ + = and Ctrl/⌘ + − zoom the window; on Windows, Ctrl + mouse wheel works too. This adds the
core:webview:allow-set-webview-zoompermission, which macOS and Linux need for zooming. -
How to leave the input editor. Tab still indents. Screen readers now hear "press Escape, then Tab, to leave the editor", and the status bar shows the same hint on wide screens.
-
Screen-reader states for the input editor:
- The input editor reports invalid input (
aria-invalid). - It is described by the current error message.
- Download and Options announce their keyboard shortcuts (
aria-keyshortcuts).
- The input editor reports invalid input (
-
Accessibility statement.
ACCESSIBILITY.mdand its Vietnamese translation cover:- goals;
- what works;
- a keyboard reference;
- what has been tested;
- known limitations with workarounds;
- how to report a barrier, with severity levels and response times.
The About page links the statement, and there is a new Accessibility issue template.
Changed
- Focus is always visible.
- Controls without their own ring now get a themed outline.
- Scroll areas, the editors, the narrow-screen tab panels and the theme choices now show a ring.
- Windows contrast themes keep focus, pressed and selected states, and switches visible.
- The status bar is quieter for screen readers. Only the conversion state is announced, not the byte counts and timing that change on every keystroke.
- Accessible names match what you see (WCAG 2.5.3):
- The language buttons are named "EN English", "JA 日本語" and so on.
- Copy is named Copied while it says so.
- The unread-output dot on the narrow layout's Output tab is also announced, as "(new)".
- Navigation labels in Vietnamese, Japanese and Chinese no longer repeat the word "navigation".
- Translations. These now follow the interface language:
- the Home page title;
- the notification close button;
- CodeMirror's screen-reader announcements for search, replace, folding and deleted selections.
Fixed
- The Appearance button no longer claims to open a menu (
aria-haspopup). It is a disclosure for a panel. - The About page and the batch queue. Their scroll areas are labelled regions, so the label is valid ARIA.
- The format picker sheet on phones has a description, which also removes Radix's console warning.
- Page loading is announced (
role="status"), and the output panel's loading spinner is exposed as an image with a label.
Tests
- axe-core scan. It covers every page, the input in an error state, the consent screen, and the Options, Batch and format-picker sheets. A guard test checks that the scan really reports violations.
- Focus tests. They cover the skip link, focus after navigation and after consent, and Back to top.
- Unit tests for the new attributes and labels.
Docs
- Accessibility guidance for contributors:
- CONTRIBUTING, CLAUDE.md and the PR template have accessibility checks.
- The bug report template asks about assistive technology.
docs/tested-viewports.mdlinks the accessibility checks to run before a release.
- The Vietnamese mirrors,
docs/i18n/vi/PRIVACY.mdanddocs/i18n/vi/dev_env.md, now describe the site-wide rate limits added in 2.0.2. - Other fixes:
- The README credits match DISCLAIMER and THIRD-PARTY.
- Outdated ROADMAP notes are corrected.
- Version examples now use 2.2.0.
Dependencies
axe-core4.14.0 (MPL-2.0), test-only; nothing new ships to users.
[2.1.1] — 2026-11-04
A maintenance release: every dependency at its latest version, no feature or behavior change. It supersedes Dependabot PRs #163–#169. bundle.android.versionCode 20101.
Dependencies
- npm (all minor/patch): react-router 8.5.1, i18next 26.7.1, react-i18next 17.1.12, i18next-browser-languagedetector 8.3.0, lucide-react 1.67.0, fast-xml-parser 5.12.0, cbor-x 1.6.9,
@tauri-apps/plugin-dialog2.8.4; dev: ESLint 10.14, typescript-eslint 8.72.1, globals 17.14, Vitest and@vitest/coverage-v85.1,@vitejs/plugin-react6.2.1, Tailwind CSS and@tailwindcss/vite4.3.4, knip 6.44.1, wrangler 4.157,@types/node26.6.6. Transitive packages refreshed within their ranges; the lockfile is smaller because Vite and Tailwind now share onelightningcss. All 426 packages have verified registry signatures. - Rust:
cargo updatewithin semver — tauri-plugin-dialog 2.8.4 (rfd 0.17), tauri-plugin-single-instance 2.5.5, wry 0.57.1, tao 0.37.2 and 26 others. - GitHub Actions: SonarSource/sonarqube-scan-action 8.4.1 (scanner CLI 8.3.1). Every other action was already at its latest release.
- knip 6.44 detects
@testing-library/user-eventon its own, so it leftignoreDependencies. THIRD-PARTY.mdlists the versions locked for 2.1.1 again; some rows had not been updated since 2.0.0.
Security
npm auditstill lists minimatch < 11.0.1 (GHSA-g3hv-75wg-m249, moderate) through ESLint and typescript-eslint, which require minimatch 10 and have no release on 11 yet. It is a development-only dependency, and the amplification only runs atoptimizationLevel2 or higher; ESLint and typescript-eslint use the default level 1 with the glob patterns from this repository's own config. Forcing the new major with an override was rejected: minimatch 11 changespartialmatching, which ESLint uses to decide which directories to walk.
[2.1.0] — 2026-10-29
Added
- JSONC → JSON. A new input-only format for JSON with comments, such as
tsconfig.json, VS Codesettings.json,.code-workspaceanddeno.jsoncfiles. Pick JSONC in the → JSON direction, paste or drop.jsoncand.jsonfiles (batches included), and get standard JSON back://and/* */comments and trailing commas are removed. Values are copied token by token rather than through JavaScript numbers, so integers beyond 2^53,1.0,1e3, duplicate keys and__proto__come out exactly as written. Output layout: 2 spaces (default), 4 spaces, tab or minified. The parser is hand-written and runs on your device; there is no new dependency. - "This looks like JSONC" hint. In the JSON → direction, when the input fails only because of comments or trailing commas, the input panel offers Convert JSONC → JSON, which switches the direction and format in one click.
- The JSONC input editor highlights comments and marks errors in the gutter at the same line and column the converter reports.
Changed
- Converting back to JSON can now report the line and column of an error. JSONC uses it, so its errors show
Ln …, Col …like JSON input errors do. - The JSONC chip is disabled in the JSON → direction with an "Input only" note. Switching to JSON → while JSONC is selected moves to JSONL.
[2.0.2] — 2026-10-27
Added
- Rate limiting for the whole website, not just the human check. The Worker now runs first for every request except the content-hashed bundles under
/assets/(run_worker_first: ["/*", "!/assets/*"]) and counts it against a per-client limit before serving it: pages and public files 120 requests a minute (SITE_LIMITER, about 40 page loads), every/api/*request 60 a minute (API_LIMITER), and/api/turnstile/verifykeeps its own 30 a minute on top. Over the limit, pages get a plain-text429 Too Many Requestsin English, Vietnamese, Japanese and Chinese, and the API gets{"ok":false,"error":"rate_limited"}; both carryRetry-After: 60. Clients are keyed on their IPv4 address or the /64 network of their IPv6 address, which is never logged. Pages are still served through the assets binding, so the security headers, the old-path redirects and the SPA fallback are unchanged. If the limiter itself fails, requests go through rather than taking the site down. Preview deployments get their own counters.
Changed
- The Privacy Policy describes the rate limit for page requests too. Nothing new is collected, so you are not asked to accept it again.
[2.0.1] — 2026-10-22
Fixed
- The editor and the output panel scroll again. The wrapper
@uiw/react-codemirrorrenders around the editor had no height, so both editors grew to fit their content inside a clipped panel: long input or output could not be scrolled with the mouse, touch or keyboard. The wrapper now fills its panel. The read-only output's scroll container also takes keyboard focus, so the arrow and page keys scroll it, without making the output editable (which would open the on-screen keyboard on phones). - Fewer console errors. The content security policy now allows WebAssembly (
'wasm-unsafe-eval', which still forbids JavaScripteval) on the website and in the apps, so the bson library's small 64-bit math helper no longer logs a violation (it fell back to JavaScript before).browsing-topicswas removed from thePermissions-Policyheader, which Brave and Firefox reported as an unknown feature. The remaining messages come from inside Cloudflare's Turnstile frame, which has its own policy. - Production smoke check. After a deploy it now waits until the new version answers several times in a row and retries before failing, because a deploy takes a moment to reach every Cloudflare edge location.
[2.0.0] — 2026-10-22
A new home, a hardened toolchain and a full audit. The web app moves to https://jsonprism.poli0981.dev on Cloudflare Workers; the old GitHub Pages address redirects there, keeping the path. Because the website now uses Cloudflare services, the Privacy Policy and Terms are at version 2.0 and everyone is asked to accept them again (CONSENT_VERSION 2).
Added
- Cloudflare Workers hosting.
wrangler.jsoncservesdist/as static assets with an SPA fallback on the custom domain; only/api/*runs Worker code (worker/). Cloudflare Workers Builds deploys every push tomainand publishes a Worker Preview for other branches (previewsblock). New scripts:cf:types,cf:check(deploy dry run, also in CI) andpreview:cf(wrangler devon port 8787;wrangler.jsoncbuilds first). Seedocs/DEPLOYMENT.md. - Edge security headers in
public/_headers: a strict CSP, HSTS,nosniff,X-Frame-Options: DENY,Referrer-Policy,Permissions-Policy, COOP, and immutable caching for hashed assets.public/_redirects301s the old/jsonPrism/*paths. Also new:robots.txt,sitemap.xml,/.well-known/security.txt, an Open Graph image and canonical URLs. - Cloudflare Turnstile human check (web only). Runs inside the Consent Gate and is verified server-side by
POST /api/turnstile/verify(same-origin check, JSON only, 4 KB body cap, per-client rate limit, siteverify with retry and hostname/action/age checks, no visitor IP sent). A pass is remembered for 7 days. A rejected token keeps the gate closed; if Cloudflare cannot be reached the user may continue after a warning, since conversion never needs the network.GET /api/healthreports Worker health. - Cloudflare Web Analytics (web only, cookieless). Loaded only on the production hostname, after consent, while the new Appearance toggle is on; it starts off when the browser sends Global Privacy Control.
- Appearance menu replacing the theme toggle: light / dark / system theme, hide scrollbars (scrolling still works) and, on the web, the analytics switch. Custom thin scrollbars everywhere, including the editors.
- Web Worker conversion. Inputs over 256 KB and every batch job convert off the main thread (
src/lib/convert-worker.ts,convert-client.ts), with cancellation and a main-thread fallback only if the worker cannot load. - Logging and diagnostics.
src/lib/logger.tskeeps the last 200 log lines in memory (never sent anywhere) and catches global errors; About → Copy diagnostics copies version, commit, platform and recent logs for bug reports. - CSV
escapeFormulaeoption (off by default) that prefixes cells starting with=,+,-,@, a tab or a carriage return with', so spreadsheet apps don't run them as formulas. - Precision warning when the input contains integers beyond 2^53, which JavaScript cannot represent exactly.
- Release integrity. Releases include
SHA256SUMS.txtand GitHub build-provenance attestations (gh attestation verify). - Production smoke workflow that waits for each merge to go live and checks headers, routing, redirects and the API.
- Per-route page titles, build commit in the header and About page, and the Android-friendly
viewport-fit=coverwith safe-area padding.
Changed
- Toolchain. Node.js 26 (
.nvmrc,engines >=26). TypeScript 7 native compiler (@typescript/nativeprovidestsc;typescriptis an alias for the TS 6 API that typescript-eslint still needs), target ES2025 while app code keeps the ES2023 library so the Android WebView 111 / macOS 12 floors hold. Separate tsconfigs for app, tests, config files and the Worker. Vite 8codeSplitting.groupsreplaces the deprecatedadvancedChunks. - Dependencies to current majors: React 19.3, React Router 8 (
react-routeronly), i18next 26 / react-i18next 17, js-yaml 5, lucide-react 1, tailwind-merge 3, react-dropzone 20, Vitest 5, jsdom 30, ESLint 10, eslint-plugin-react-hooks 7 (React Compiler rules), wrangler 4, Tauri 2.12.npm auditreports no vulnerabilities. - "Technical" UI refresh, same layout. Blueprint grid, mono labels, corner ticks, separate light and dark prism colours (light-theme text now meets 4.5:1 contrast), success/warning tokens, a terminal-style status bar (state, bytes in → out, time, encoding), animated icons behind
prefers-reduced-motion, and headings in Geist (Instrument Serif lacked Vietnamese glyphs). Format chips that don't suit the detected shape get a dashed border instead of faded text. The theme is applied before first paint (public/theme-init.js), so there is no flash. - Consent Gate. Also shown on macOS and Linux desktop (only the Windows installer has its own license page); legal links point at the exact commit of the build; the app renders behind the gate instead of a blank page.
- Faster typing. One layout rendered at a time, stable editor extensions (no reconfiguration per keystroke), deferred live conversion, a virtualised read-only CodeMirror for output, batched batch-progress updates and streaming ZIP creation.
- Tauri bundles carry no web-only code. The analytics beacon and the Turnstile widget are compiled out of desktop and Android builds instead of only being switched off at runtime.
- Tauri permissions narrowed. The static file scope is now Documents, Downloads and Desktop (previously all of
$HOME); files you pick or drop are added at runtime. Dotfiles never match scope globs, unused permissions (os,set-title,write-text-file, message dialogs) are gone, and the app CSP addsobject-src 'none',base-uri,form-actionandframe-ancestors. The version now comes frompackage.json; AndroidversionCode20000 andallowBackup="false". - Keyboard shortcuts. Ctrl/⌘+S downloads, Ctrl/⌘+, opens settings; Ctrl/⌘+K (clear) is removed because it hijacked the browser's search. Shortcuts ignore key repeat, IME composition and open dialogs.
- Internationalisation. Japanese and Simplified Chinese gained 27 missing strings, unused keys were removed, remaining hard-coded strings (including CodeMirror's search and lint panels) are translated, and a test keeps the four locales in sync.
- CI and releases. Actions pinned to commit SHAs, least-privilege permissions,
npm ci --ignore-scripts, a TypeScript 7 guard, coverage, a Rustfmt/clippyjob and SonarQube Cloud analysis. Releases check that the tag matches the app version, run the tests first, build into a single draft and name the APKJSONPrism_<version>_android-universal.apk. Notification workflows pass only the secrets they need to pinned reusable workflows, and GitHub Discussions no longer receive a post for every deploy. Dependabot groups related packages (majors included) and waits a few days before proposing new releases. - Documentation and legal. Privacy Policy and Terms 2.0, refreshed Disclaimer, Security policy (2.x supported, Worker and edge in scope), Code of Conduct, contributing guide, third-party notices, new
docs/DEPLOYMENT.md, and project contacts at@poli0981.dev.
Fixed
- CSV used only the first row's keys as columns, silently dropping fields that appeared later; columns are now the union across rows. Reverse parsing turns only canonical numbers into numbers (no more
007→7or dates guessed), and keys like__proto__are stored safely. - Batch ZIP stored base64 text for BSON, CBOR and MessagePack; it now contains the real bytes. Pressing Process a second time no longer wipes earlier results, cancelling returns unfinished files to the queue, and duplicate output names are made unique case-insensitively.
- SQL INSERT: MySQL string literals escape backslashes (a
\'payload could break out of the string), MSSQL usesN'…'andNVARCHAR,CREATE TABLEtypes are inferred from all rows (BIGINT,DECIMAL(38, 0)for huge integers), dotted table names are quoted per part, and MSSQL batches are capped at its 1000-row limit. - RESX reverse keeps values such as
"007"as strings, validates the XML and rejectsDOCTYPE; output always includes the resheaders, encodes carriage returns and replaces characters XML cannot carry. - XML produced invalid documents for keys that are not valid element names; names are now sanitised (the original kept in a
keyattribute), nested arrays are wrapped, control characters replaced, root/item names validated and every result checked with a validator. - BSON documents over 16 MiB were silently truncated; they now return a clear error.
- YAML
quoteStylehad no effect; it works again with js-yaml 5. Alias and merge-key bombs are capped, and empty input reports an error instead ofundefined. - TOML reports
nullvalues with their path (or omits them, by option), keeps integers beyond 2^53 exact and sorts keys deterministically. - JSONL tolerates a BOM and reports real line numbers, blank lines included.
- JSON errors show the correct line and column in Chromium, Firefox and WebKit.
- The editor inserted the text of dropped files itself, racing the file loader; file drops now go only to the drop zone. An empty editor is no longer flagged as invalid JSON, JSONL typed in the → JSON direction is checked line by line instead of being marked invalid, and a leading byte-order mark is accepted like the converter accepts it.
- File sizes just under 1 MiB showed as "1024.0 KB".
- Download and Ctrl/⌘+S reported success on Android without saving; desktop and Android now use the native save dialog.
- Native open dialogs filter by conversion direction and accept
.yml,.ndjsonand.markdown; a drag-and-drop listener could leak when the component unmounted early. - Route errors now reset when you navigate away, and a stale tab that fails to load a chunk after a deploy reloads once instead of breaking.
- Stored options and formats are validated, so corrupt
localStoragecan no longer crash the app; blocked storage is tolerated everywhere. - Accessibility: live regions for errors, status and batch progress; accessible names for the editors;
aria-pressedon toggle groups; touch targets of at least 24 px;<html lang>follows the interface language.
Removed
- The GitHub Pages deployment (
deploy.yml,public/404.htmland the SPA redirect script). Pages now serves only a redirect page (pages-redirect.yml, run by hand). react-router-dom,@fontsource/instrument-serif,@types/js-yamland the unusedosplugin (@tauri-apps/plugin-os,tauri-plugin-os).
Security
- Fixed the MySQL backslash escaping flaw in the SQL converter (see Fixed) and the XML/RESX output issues that could yield malformed documents.
- Narrowed the desktop file-system scope and permissions, disabled Android backups and tightened both CSPs (see Changed).
- Resolved the open npm Dependabot alerts by upgrading react-router, js-yaml, undici, postcss, smol-toml, brace-expansion, source-map-js and vitest.
Tests
- 864 tests in 92 files (up from 215), 97% line and 91% branch coverage: regression tests for every fix above, a contract test that feeds hostile input to every converter, component tests for the whole UI (Testing Library + user-event, with a fake Turnstile widget and Tauri IPC mocks), hook, store and storage tests, the Web Worker client, locale parity, and Worker tests for the verify endpoint and router. Vitest runs two projects (
appin jsdom,workerin Node) and reports coverage to SonarQube Cloud, whose quality gate now passes.
[1.7.2] — 2026-06-16
Fixed
- External links open on Android. Links tapped in the Android app — the Consent Gate's legal links, the footer and About links — did nothing:
@tauri-apps/plugin-shell'sopen()has no URL handler on Android and failed with "os error 2".openExternal()now uses@tauri-apps/plugin-opener'sopenUrl(), which hands the URL to the system browser throughIntent.ACTION_VIEW. The shell plugin, its capability and its npm package were removed. Verified on an Android 13 emulator.bundle.android.versionCode10702.
[1.7.1] — 2026-06-16
Fixed
- First-launch legal gate now appears on the Android app. The consent gate (added in 1.6.0) was skipped on every Tauri build — correct for desktop, where the installer's license page already gates acceptance, but the Android sideload APK has no installer step, so Android users never saw or accepted the License / Terms / Privacy / Disclaimer. A new build-time
__IS_ANDROID_BUILD__define (TAURI_ENV_PLATFORM === 'android', mirrored asfalseinvitest.config.tsso tests still run) makes the gate skip only on desktop (__IS_TAURI_BUILD__ && !__IS_ANDROID_BUILD__); Android and web both show it. Acceptance persists in the WebView'slocalStoragelike the web build, so it asks once. The gate's links also gained anopenExternal()helper (src/lib/tauri.ts) that routes through@tauri-apps/plugin-shellinside Tauri — the Android WebView swallows plaintarget="_blank", so the legal links were previously unreachable there. The intro copy now reads "runs entirely on your device" (was "in your browser", inaccurate on the native app). - File-load toast no longer shows opaque Android document ids. Android's Storage Access Framework often returns a
content://URI whose document id carries no real filename (e.g.msf:1000000123), so the native-open success toast read "Loaded 1000000123". It now falls back to a count-based "N file(s) loaded" message (newtoast.files_loadedkeys, EN + VI) when the picked name has no usable extension, and keeps the clean "Loaded " when a real filename is available. Desktop and web are unchanged.bundle.android.versionCodebumps to 10701 (1.7.1→MAJOR*10000 + MINOR*100 + PATCH).
[1.7.0] — 2026-06-16
Added
- Android app (sideload APK). JSONPrism now ships as an Android app built with Tauri 2 — download a signed universal
.apkfrom Releases and sideload it. Requires Android 12 (API 31) or newer; the OS refuses to install on older versions (bundle.android.minSdkVersion = 31, verified:INSTALL_FAILED_OLDER_SDKon API 24). The same React UI runs in the Android System WebView, with the native Storage Access Framework file picker wired into the existing open/batch flows viaplugin-dialog+plugin-fs(no behavior change to the converters). The generated Gradle project lives insrc-tauri/gen/android/(committed — source only; build outputs + signing material gitignored); release signing reads a gitignoredkeystore.propertieswith a graceful unsigned fallback. Newnpm run tauri:android:{init,dev,build}scripts, and anandroidjob in.github/workflows/release.ymlbuilds + signs the APK and attaches it to the same draft release as the desktop bundles.bundle.android.versionCodeis derived from the version asMAJOR*10000 + MINOR*100 + PATCH(1.7.0 → 10700). Note: the layout needs a WebView of Chromium ≥ 111 (an existing Tailwind v4 requirement) — current Android 12+ devices satisfy this via the Play-updated System WebView; seedocs/TAURI-NOTES.md.
Changed
- Self-hosted fonts (offline-ready). Geist, Instrument Serif, and JetBrains Mono are now bundled via
@fontsource(imported insrc/main.tsx) instead of fetched from Google Fonts. The<link>tags are gone and the CSP no longer allowsfonts.googleapis.com/fonts.gstatic.com, so the app renders with the correct fonts fully offline — required for the sideloaded Android build and a privacy win for the web build. CJK still falls back to system fonts as before. - Robust native file open on Android.
fileFromNativePath()recovers a usable filename from Androidcontent://URIs via a newbasenameFromPath()helper, and the native-open path filters extensions leniently so opaque MediaStore document URIs — which carry no filename — that the user explicitly picked through the native dialog are no longer wrongly rejected. Desktop and web drag-drop behavior is unchanged.
Tests
- +6 unit tests (215 total). New coverage for
basenameFromPath(desktop paths,content://raw:+msf:URIs, malformed escapes) and the lenientfilterByExtensionmode. Format / typecheck / lint /knip/ tests all green. The signed APK was validated on emulators: installs on Android 12+, blocked on API < 31, launches, renders (CodeMirror + self-hosted fonts), runs converters, reads files via the SAF picker, fully offline.
[1.6.1] — 2026-06-14
Changed
- Split the CodeMirror core chunk to clear the 500 kB build warning. The
cm-corechunk was ~614 kB raw (210 kB gzip) and tripped Vite'schunkSizeWarningLimiton every build, even though it is already lazy-loaded behind the editor. Vite 8 / Rolldown deprecates themanualChunksfunction form (its optimizer silently merged sub-chunks back together), sovite.config.tsnow usesadvancedChunks.groupswith explicitpriority-ordered, honored boundaries. The CodeMirror core splits intocm-view(~245 kB, the@codemirror/viewDOM engine) +cm-core(~362 kB, state/language/lezer/@uiwwrapper);cm-langsis unchanged (~60 kB). No chunk now exceeds 500 kB. Total bytes and gzip size are unchanged — the editor still loads all three pieces together behind its existingReact.lazyboundary, so this is purely finer file granularity (better cache reuse across deploys). No converter or UI behavior changed; verified in a production preview build (editor renders, highlights, and converts; allcm-*chunks 200 OK, no console errors).
Fixed
- Stop shipping source maps on the public web build.
vite.config.tsnow emits source maps only for local non-production web builds (sourcemap: !isTauriContext && mode !== 'production') — never for the GitHub Pages deploy or Tauri bundles. The entiredist/is uploaded to Pages, so earlier production builds exposed the full original source via.mapfiles even though nothing consumes them (PRIVACY.md: no remote error reporting). Smaller deploy, no source exposure.
Dependencies
- 27 npm minor/patch updates (the grouped
npm-minor-patchDependabot bump).
[1.6.0] — 2026-06-14
Added
- Custom error pages. A reusable presentational
ErrorStatecomponent (src/components/common/ErrorState.tsx) backs a 404 catch-all route (src/pages/errors/NotFound.tsx) and a generic/error/:coderoute (src/pages/errors/ErrorRoute.tsx) with dedicated copy for 403 / 404 / 419 / 500 and a fallback for anything else. JSONPrism is a static client-side SPA and never emits these from a server itself — the route exists so any code (a future backend, a Tauri IPC failure) can render a polished, consistent page. Newerror_page.*i18n group in EN + VI. - First-launch legal consent gate (web only). A non-dismissible modal (
src/components/common/ConsentGate.tsx, built on a newsrc/components/ui/dialog.tsxRadix wrapper) blocks the app on first launch / incognito until the user ticks agreement to the License, Terms (EULA), Privacy Policy, and Disclaimer (linked to GitHub). Acceptance persists tolocalStorage(jsonprism.consent— flag + version + timestamp) viasrc/lib/consent-storage.tsand a Zustand store (src/stores/consentStore.ts); bumpCONSENT_VERSIONto re-prompt when terms change. Skipped in desktop builds (gated by the installer instead) with zero runtime branching, via the build-time__IS_TAURI_BUILD__flag. Newconsent.*i18n group in EN + VI;PRIVACY.mddocuments the new key. - Windows installer license-acceptance page.
bundle.licenseFileintauri.conf.jsonnow points atsrc-tauri/license.rtf(a short EULA referencing Apache-2.0 + TERMS / PRIVACY / DISCLAIMER). Both the NSIS.exeand the WiX.msishow an accept-to-continue license page — RTF satisfies both, sotargets: "all"is preserved. - Offline indicator.
useOnlineStatushook + a non-blockingOfflineBannerstrip between the header and content. Informational only — JSONPrism keeps working offline. - GitHub Pages deep-link support.
public/404.html(spa-github-pages redirect,pathSegmentsToKeep = 1for the/jsonPrism/base) plus a tiny decoder inindex.htmlmake refreshing a deep link (e.g./jsonPrism/about) resolve to the right route instead of GitHub's 404. No-op under Tauri.
Changed
- Lazy-loading + finer code-splitting (web). Routes (
Home,About, error pages) and the CodeMirror editor are nowReact.lazy+Suspense(the editor degrades to a real<textarea>while its chunk loads, so input stays usable). AChunkErrorBoundarycatches a failed dynamic import (e.g. stale deploy) and offers reload without crashing the page; non-chunk errors rethrow to the existing crashErrorBoundary, which now shares theErrorStatevisual.manualChunksinvite.config.tswas refined to splitreact/router/i18n/cm-core/cm-langs/ one chunk per parser /ui— the heavy CodeMirror core is no longer in the initial paint graph. - Removed a hidden
bsonleak.decodeBytes/encodeBytesmoved fromsrc/converters/bson.tsto a parser-freesrc/lib/bytes.ts;OutputPaneland the CBOR / MessagePack converters import from there, so thebsonlibrary no longer enters the initial bundle graph just because the output panel renders.
Tests
- +16 unit tests (209 total). New coverage for
consent-storage,consentStore,bytescodec,isChunkLoadError, theErrorStatecomponent, and theuseOnlineStatushook. Typecheck, lint,knip,prettier --check, andnpm audit(0 vulnerabilities) all green; consent gate / 404 //error/:codeverified in a running dev build.
[1.5.0] — 2026-05-21
Added
- Scroll-to-top button on the About page. A floating up-arrow button (
src/components/common/ScrollToTop.tsx) fades in at the bottom-right once the About page is scrolled past ~320px, and smoothly returns to the top on click. The About page hides its scrollbar (.scrollbar-hide), so there was previously no quick way back up. Respectsprefers-reduced-motion(jumps instead of animating) and stays out of the keyboard tab order / accessibility tree while hidden. New i18n keycommon.scroll_to_topacross all four locales (en/vi/ja/zh-CN). The button is About-only by design — the converter workspace uses a fixedh-dvhlayout that never page-scrolls.
Changed
- Internal refactor — three oversized components decomposed (behavior-preserving).
BatchPanel.tsx(515 lines),ConverterWorkspace.tsx(314), andInputPanel.tsx(278) were split into focused, reusable units: pure utilities (lib/format-bytes.ts,lib/editor-language.ts,lib/read-file.ts), leaf components (common/ToolbarButton.tsx— de-duplicated from InputPanel + OutputPanel — plusconverter/BatchItemRow.tsxandconverter/BatchSummaryChips.tsx), and hooks (useFileAccept,useBatchActions,useConversionResult,useOutputBadge,useBatchFileRouter). No converter or UI behavior changed; all 193 unit tests still pass.
Tooling
knipintegrated for dead-code analysis. Newknip.jsonconfig, annpm run knipscript, and aKnipstep in CI (.github/workflows/ci.yml) — unused files and dependencies are now caught on every push. The initial sweep deleted the orphanedsrc/hooks/useLocalStorage.ts(superseded bylib/options-storage.ts), dropped the unusedi18ndefault export and the unusedBatchPanelproponAddExternalFiles, and un-exported the internally-usednativeReadText. knip's export-leveltypescheck is disabled — the converter-contract types inconverters/types.tsare intentional public vocabulary, not dead code.
Fixed
globalswas a phantom (undeclared) devDependency.eslint.config.jsimportsglobals, but it was never listed inpackage.json— linting only worked because ESLint pullsglobalsin transitively. Now declared explicitly so a stricter or deduped install can't breaknpm run lint. Surfaced by the newknipcheck.
Dependencies
- Added
knip^6.14.1(ISC, dead-code analyzer, devDep) andglobals^14.0.0(MIT, explicit devDep — previously resolved transitively).THIRD-PARTY.mdupdated.
Tests
- No new tests this round — the refactor is behavior-preserving and the scroll button is editor/CSS/i18n surface best verified manually. The 193 existing unit tests still pass; typecheck, lint,
knip, andprettier --checkare all green.
[1.4.3] — 2026-05-14
Fixed
- Toast close button (
×) did nothing on click/tap on both desktop and mobile.sonner@1.7.4's toast root attachedr.target.setPointerCapture(r.pointerId)unconditionally onpointerdown, and combined with React 19's new container-root event delegation, the pointer-capture quirk swallowed the synthetic click event on the close button — so the bundleddismiss()handler never ran. The bug fired on both mouse and touch because the PointerEvent API is unified. Upgradedsonner^1.7.0→^2.0.7, which rewrote pointer/swipe handling and ships first-class React 19 support.<Toaster>props (position,theme,richColors,closeButton,toastOptions.classNames) and thetoast.success/warning/error/infocall sites are API-compatible — no code changes needed beyond the version bump.
Added
docs/tested-viewports.md— the maintainer's manual device test matrix (BlackBerry Z30 / Galaxy S9+ / Pixel 3/4/7 / iPhone SE/12/14 Pro/XR/Pro Max / iPad / BlackBerry PlayBook). Documents Nokia Lumia 520 (320×533) as a known limitation below the recommended360×640minimum. README EN + VI link to it.- Touch hit-area expansion on the toast close button. A
::afterpseudo gives an effective ~36–40px tap target (visible size stays at sonner's 20px default), plustouch-action: manipulationto drop the 300ms tap delay on touch devices. Defensive — sonner v2 already fixes the underlying click — but a free mobile UX win.
Dependencies
- Bumped
sonner^1.7.0→^2.0.7(MIT). THIRD-PARTY.md updated.
[1.4.2] — 2026-05-14
Added
- Tabs UI for Input/Output on mobile (
<md). New shadcnTabsprimitive (src/components/ui/tabs.tsx, wrapping@radix-ui/react-tabs). The workspace now renders Tabs on mobile so each active panel takes the full available height; desktop continues to use the side-by-side grid. Both layouts render in parallel so CodeMirror state (selection, scroll, cursor) survives a viewport resize without remounting. - "Unread output" dot on the Output tab. When
outputchanges while the user is on the Input tab, a small primary-colored dot appears on the Output tab label; it clears the next time the user switches over. No auto-switch — the user controls the flow. - Compact mobile FormatPicker. On
<md, the 12 format chips collapse into a singleTarget format: <current>trigger that opens a bottom Sheet with all chips in a 2-3 column grid (reusing the existing Sheet primitive shipped with BatchPanel / SettingsPanel). Saves ~50–80px of toolbar height that the chip flex-wrap was eating on narrow viewports — that vertical space was the underlying cause of the previous "panels overlap" regression below 600px height.
Fixed
- Workspace panels still overlapping on viewports <400×700. v1.4.1's
grid-rows-2 md:grid-rows-1mobile split allotted each panel half the workspace height, but when the workspace top toolbar wrapped 2–3 rows (the 12 FormatPicker chips on narrow viewports) plus header / Home hero / Footer / StatusBar chrome, each row fell below CodeMirror's minimum rendered content height and the two panels visually overlapped. The Tabs swap above resolves this by giving the active panel the full workspace height instead of half.
Changed
- README EN + VI now disclose: "designed for viewports ≥ 360 × 640; smaller screens still work but may feel cramped". Galaxy S / Pixel-class portrait is the minimum well-supported viewport.
Dependencies
- Added
@radix-ui/react-tabs(MIT). Also listed inTHIRD-PARTY.md.
[1.4.1] — 2026-05-14
Fixed
- Header overflowed the viewport on iPhone 14 Pro and other ≤sm phones. The brand wordmark + nav links + language switcher + theme toggle + GitHub icon summed to ~460px and didn't fit the 393px iPhone viewport, forcing horizontal page scroll to reach the right-edge buttons. Hide the
JSONPrismwordmark belowsm(640px) — the brand SVG mark alone identifies the app on phones, and the row fits cleanly. - Workspace input/output panels disappearing on short / landscape phones. Two compounding causes:
min-h-[40vh]on each stacked panel (introduced in 1.4.0 to make mobile heights usable) summed to 80vh, exceeding the available height after header / Home padding / workspace toolbar / status bar / footer chrome on short phones. The workspace container'soverflow-hiddenthen clipped the lower (output) panel off-screen. Replaced withgrid-rows-2 md:grid-rows-1so each panel takes exactly half the workspace height share on mobile — always visible, no overflow.h-screen(=100vh) on the Layout root didn't account for iOS Safari's dynamic toolbar — the computed height could exceed the actual visible area, especially after rotating to landscape. Swapped forh-dvh(Tailwind v4 dynamic viewport height).
Docs
THIRD-PARTY.mdnow lists the five CodeMirror language packs that landed across 1.3.0 + 1.4.0 (@codemirror/lang-yaml,@codemirror/lang-xml,@codemirror/lang-markdown,@codemirror/lang-sql,@codemirror/legacy-modes— all MIT). The file was lagging behind the actual install set.
[1.4.0] — 2026-05-14
Added — Đợt UI/UX polish: dynamic placeholders, social, reverse highlight expansion, mobile
- Dynamic input/output placeholders in reverse mode.
Paste your JSON here…andOutput will appear here once you provide valid JSON.now interpolate the source/target extension: e.g.Paste your CSV here…,Output will appear here once you provide valid YAML.New i18n keyshome.input_placeholder_formatandhome.output_empty_formatcarry{{ext}}; the panels resolveconverter.meta.extension.toUpperCase(). Forward mode keeps the JSON-specific copy. - "Multi-target formats" slogan replaces "Eight target formats" in
app.descriptionacross en/vi/ja/zh-CN — copy no longer hard-codes a stale count as new formats land. - Reverse-mode syntax highlight widened: Markdown, SQL, TOML, and JSONL now render with proper tokens in the input editor (previously plain text). Adds
@codemirror/lang-markdown,@codemirror/lang-sql, and@codemirror/legacy-modes(the latter for TOML viaStreamLanguage.define). CSV/TSV stay plain — no fitting CodeMirror grammar. All new packs flow into the existingcodemirrormanualChunk; no initial-bundle regression. - Social links UI. New
src/components/common/SocialIcons.tsxhouses six inline-SVG brand icons (Discord, X, Bluesky, Mastodon, Telegram, YouTube) sincelucide-reacthas no brand glyphs. Footer surfaces the three dev-relevant ones (Discord dev community, X, Bluesky) between app meta and the maintainer credit. About page gains aCommunitysection between Donate and Third-party listing all six. New i18n keysabout.community.*andsocial.*across en/vi/ja/zh-CN. - Mobile responsiveness polish. Header's Convert/About nav links no longer hidden below
md:— always visible, with tighter padding and a smaller brand wordmark on small viewports. Toolbar buttons inInputPanel/OutputPanelcollapse to icon-only on mobile (label moves toaria-label/title). Workspace input/output panels keep amin-h-[40vh]floor on mobile so the stacked layout stays usable.Homehero stacks on mobile;Aboutpage shrinks outer padding;FormatPickerchips compact down. No hamburger menu — only two nav links, the drawer pattern wasn't worth its bundle cost.
Fixed
- Input editor mousewheel scroll requiring a click-to-focus.
.cm-scrollerwas set toscrollbarWidth: 'none'plus::-webkit-scrollbar { display: none }. On at least some Chromium builds, this disengaged the scroll target until the editor was focused — keyboard PageDown also did nothing without focus. Switched toscrollbarWidth: 'thin', an explicitoverflow: 'auto', and a themed::-webkit-scrollbarthumb. Wheel and PageDown both work without a prior click.
Changed
- README EN + VI refreshed. Sync slogan with the in-app copy ("Multi-target formats" / "Đa định dạng đích"). VI README format table catches up with EN: includes BSON / CBOR / MessagePack (Phase 4) and the
Reverse (→ JSON)column. Tech-stack line bumped fromVite 6toVite 8in both files (package.json has been on^8.0.0; the About page already reflected this). Both READMEs gain aCommunitysection mirroring the in-app links.
Dependencies
- Added
@codemirror/lang-markdown,@codemirror/lang-sql, and@codemirror/legacy-modes(all MIT, all@codemirror/*so they auto-route into thecodemirrormanualChunk viavite.config.ts).
Tests
- No new tests for this UI-polish round. The 193 existing unit tests still pass; the new behaviour is editor/CSS/i18n surface that's better verified manually (DevTools mobile viewport, wheel-scroll without click, per-format placeholder, reverse-mode highlight). Total tests: 193.
[1.3.3] — 2026-05-13
Fixed
- Tauri native drag-drop / file picker bypassed batch dedup. v1.3.0–v1.3.2 desktop bundles let users drop the same file into the queue repeatedly without surfacing the
duplicatetoast. Root cause:fileFromNativePathconstructednew File([text], name, { type })withoutlastModified, so the File API defaulted toDate.now()on every call;batchStore's dedup key (name|size|lastModified) differed across re-drops of the same on-disk file. Fix: stat the file via@tauri-apps/plugin-fsand use the realmtime, falling back to an FNV-1a hash of the path ifstat()throws. Bonus: infertypefrom the file extension instead of hard-codingapplication/json. Added thefs:allow-statpermission to the default capability.
Tests
- 3 new unit tests for
pathHashAsMillisinsrc/lib/__tests__/tauri.test.ts. Total tests: 193.
Verified
- Windows Sandbox (Windows 11): manual smoke test passed — re-dropping the same
.jsonfile surfaces theduplicatetoast and keeps the queue at one entry. - Ubuntu 22.04 LTS on a Hyper-V VM: full smoke test passed at 100% (drag-drop dedup, extension filter, batch processing).
[1.3.2] — 2026-05-13
Fixed
- Tauri native drag-drop bypassed the batch extension filter (misdiagnosis — see note below). v1.3.0/v1.3.1 desktop bundles accepted any file dropped from File Explorer / Finder / Nautilus into the workspace, because
ConverterWorkspace.handleMultiFileDropcalledbatchStore.addFilesdirectly — skipping thedirection × formatextension whitelist that the webreact-dropzonepath enforced. Files like.cs/.pyleaked into the queue with no warning. Extractedsrc/lib/file-filter.ts(getAllowedExtensions+extOf+filterByExtension) and routed the Tauri callback,BatchPanel, andInputPanelthrough it so the wrong-format toast surfaces in all three entry points.
Note on root cause
This release shipped on a misdiagnosis. The user-visible bug they were investigating turned out to be batch dedup not working under Tauri (fixed in v1.3.3), not the missing extension filter on the native drag-drop path. The fix in this release is still correct on its own — the Tauri code path was missing the wrong-format filter — but it did not change the behaviour the user was actually seeing. Treat v1.3.2 as a defensive hardening that closes a real-but-cosmetic gap; functional impact for end users is negligible.
Tests
- 7 new unit tests for
getAllowedExtensions,extOf, andfilterByExtensioninsrc/lib/__tests__/file-filter.test.ts. Total tests: 190.
[1.3.1] — 2026-05-13
Fixed
- GitHub Pages deploy 404. The deployed page rendered blank because every asset URL 404'd. Root cause: GitHub Pages serves at
https://poli0981.github.io/jsonPrism/(case-sensitive, mirrors the repo name), but Vitebasewas/jsonprism/(lowercase), soindex.htmlreferenced/jsonprism/assets/*.js. Rebased Vitebase, React Router basename, and all GitHub URLs in code/docs to match the existing repo casejsonPrism. Storage keys / package name / Tauri identifier remain lowercase. - Release workflow macOS Intel build cancelled. GitHub Actions
macos-13runners no longer pick up jobs (jobs queue indefinitely then auto-cancel after timeout). Replaced the two-entry macOS matrix (Apple Silicon + Intel) with a singlemacos-14build using--target universal-apple-darwin. The resulting.dmg/.appruns on both Apple Silicon and Intel via the universal2 binary.
Note on v1.3.0
The v1.3.0 tag was published with a draft GitHub Release containing partial bundles (Windows + macOS Apple Silicon + Linux; macOS Intel missing). It was never un-drafted because of the two bugs above. v1.3.1 carries the same feature set plus the fixes — please use v1.3.1.
[1.3.0] — 2026-05-13
Added — Đợt sửa lỗi 4: editor UX, batch hygiene, workspace persistence, TERMS
- Reverse-mode syntax highlighting in the input editor — YAML and XML/RESX now get proper token colors via
@codemirror/lang-yamland@codemirror/lang-xml; CSV/TOML/JSONL/Markdown/SQL/BSON/CBOR/MessagePack fall back to plain text (no upstream grammar). - Workspace state persistence: Convert → About → Convert no longer wipes the editor. New
src/stores/workspaceStore.ts(Zustand) ownsinput+format+direction+optionsByFormat;inputis in-memory only, the rest persist to localStorage via existing helpers. - Batch dedup by
(filename + size + lastModified)— re-dropping the same files reports a duplicate-skipped toast instead of double-queuing. - Batch format filter: drag-drop, "Browse", and Tauri native dialog all reject files whose extension is outside the allowed list (
.json/.txtforward;<format>/.txtreverse) with a warning toast. Files like.csor.pyno longer leak into the queue via "Browse". .scrollbar-hideutility class inglobals.css— applied to.cm-scroller(CodeEditor theme), OutputPanel, and the About page wrapper. Window scrollbar untouched for a11y.- Direction-aware batch text:
batch.descriptioninterpolates{{from}}/{{to}}("Process multiple YAML files into JSON…"); newdrop_idle_format+empty_formatuse{{format}}. All four locales (en/vi/ja/zh-CN) updated. TERMS.md(root, ToS / EULA): acceptance, GitHub ToS compliance, Apache 2.0 inheritance, no warranty, user data ownership, acceptable use (anti-malware PR, no-PII-on-public-deploy, no Tauri capability bypass), trademarks, modifications, termination, contact. Linked fromREADME.mdandREADME.vi.md.
Fixed
- Input editor overflow: long pastes now scroll inside
.cm-scrollerinstead of pushing past theStatusBar. Root cause was a missingmin-h-0on the InputPanel wrapper inside its flex column. - About page overlap: long content no longer overflows onto the Footer. About is now wrapped in
flex-1 min-h-0 overflow-y-auto, scrolling within<main>.
Dependencies
- Added
@codemirror/lang-yamland@codemirror/lang-xml(both MIT). Both fold into the existingcodemirrormanualChunk.
Tests
- 8 new unit tests: 6 for
workspaceStore(setters, persistence, format-switch options retention), 2 forbatchStorededup behavior. Total tests: 183.
[1.2.0] — 2026-05-13
Added — Đợt sửa lỗi 3: Tauri fixes, workflow hygiene, JP/ZH-CN, reverse UX, docs
- Tauri 2 single-instance via
tauri-plugin-single-instance. Launching the app while it's already open now focuses the existing window instead of spawning a new process. - Japanese (
ja) and Simplified Chinese (zh-CN) locales — AI-translated, surfaced under the existingdisclaimer.translationi18n key. - Reverse batch processing — drag-drop multiple non-JSON files in reverse mode, get a
.zipof.jsonoutputs back.batch-processorgained adirectionparameter that routes throughconverter.reverse()instead ofparseJsonInput. - Reverse UX: InputPanel + BatchPanel accept list, file picker, and editor label all switch dynamically when direction = reverse. The label reads e.g. "Input YAML" / "Input CSV".
- Auto-discussion workflow (
.github/workflows/announce-discussion.yml): publishes a Discussion post when a release is created or a GH Pages deploy succeeds. Uses GraphQLcreateDiscussionmutation; requires Discussions + anAnnouncementscategory enabled in repo settings (one-time setup). - Docs suite (root, GitHub auto-detects):
PRIVACY.md,SECURITY.md,DISCLAIMER.md,MAINTAINERS.md,THIRD-PARTY.md(canonical categorized dep list),CODE_OF_CONDUCT.md(Contributor Covenant v2.1). - Docs operational:
docs/pc_spec.md+docs/dev_env.md+ Vietnamese mirrors underdocs/i18n/vi/. - About page expansion: Donate grid (5 channels from
.github/FUNDING.yml), categorized third-party summary, build info (version + commit SHA + date — injected via Vitedefinefromgit rev-parse), Links section, Disclaimer footer. - CONTRIBUTING update: "Auto-ignored cases" rules for suspicious code, off-topic preamble, missing PR descriptions.
- Community files:
.github/dependabot.yml(weekly npm + actions + cargo, grouped),PULL_REQUEST_TEMPLATE.md,ISSUE_TEMPLATE/config.yml.
Fixed
- Tauri build black screen. React Router basename was driven by
import.meta.env.PROD, which is true in both web and Tauri prod builds — basename became/jsonprismin Tauri bundles (which serve from/), so no routes matched and the page rendered blank. Introduced build-time__IS_TAURI_BUILD__Vite define keyed offTAURI_ENV_PLATFORM. - Workflow skip noise:
notify-ci-failure.ymlandnotify-release-pipeline.ymldroppedworkflows: ["*"]catch-all in favor of explicit workflow names; massively fewer "skipped" runs in the Actions tab.
Changed
- GitHub Actions bumped:
actions/checkoutv4 → v6,actions/setup-nodev4 → v6 (Node 24 LTS-ready).
[1.1.0] — 2026-05-13
Added — Đợt sửa lỗi 2: hygiene, dep upgrades, Tauri process, binary formats, reverse
- BSON / CBOR / MessagePack converters — 3 new binary target formats. Output is rendered as base64 (default) or hex via per-format
encodingoption; downloads decode back to raw bytes for proper binary files (.bson,.cbor,.msgpack). NewConverterMeta.binaryflag. - Reverse conversion —
Converter<T>.reverse(input, options)optional interface method. Five reverse implementations:JSONL,CSV/TSV,YAML,TOML,RESX→ JSON. UI: newDirectionTogglecomponent persisted to localStorage;FormatPickerdisables formats withoutreverse();OutputPanelswaps extension to.jsonin reverse mode. - Tauri process hygiene: explicit
RunEvent::ExitRequested+WindowEvent::CloseRequestedcleanup insrc-tauri/src/lib.rs. Callscleanup_before_exit()so any spawned shell children are signaled before shutdown. Newdocs/TAURI-NOTES.mddocuments the upstream WebView2 GDI leak.
Fixed
- 8 TypeScript strict errors (override modifier, exactOptional, Blob
Uint8Array<ArrayBuffer>). npm run typecheckscript switched fromtsc --noEmit(no-op with the root tsconfig) totsc -b --noEmit. CI now actually catches type errors.- Theme toggle rewritten: replaced racy
onBlurtimeout withpointerdownclick-outside detection + Escape key + ARIArole="menu". - 10 pre-existing test failures (jsdom localStorage shim, outdated registry/CSV assertions, batch-processor mock for not-ready branch).
Changed
- Dependency upgrades:
jsdom^25 → ^29,vite^6 → ^8 (Rolldown bundler — ~5× faster builds),@vitejs/plugin-react^4 → ^6,engines.node>=22.0 → >=22.11.vite.config.tsmanualChunksconverted to function form (Rolldown requires it). - Vite minifier:
esbuild→oxc(Rolldown-native, no separate install).
Tests
- 175 tests pass (was 137). New coverage for the 3 binary converters (17 tests) and 5 reverse converters (11 tests).
[1.0.0] — 2026-05-12
Added — Phase 3: RESX + i18n migration
- RESX converter (
.resx) — hand-rolled XML output byte-aligned with Visual Studio's editor. 9/9 formats now production-ready.- Accepts flat string-to-string objects:
{ "Key": "value", ... } - Supports the
{ value, _comment }shape per entry; emits both<value>and<comment>elements - Options:
commentKey(default_comment),includeSchema,sortKeys - Full RESX 2.0 schema header +
resmimetype/version/reader/writerresheaders - Proper XML escaping:
&,<,>in text; quotes inname=attributes - Rejects nested objects (the only valid use of nesting is the
{ value, _comment }shape)
- Accepts flat string-to-string objects:
- Smart format suggestions — picker now highlights formats matching the detected JSON shape with a subtle ring:
flat-object→ RESX surfaces firstarray-of-objects→ CSV/TSV/Markdown/SQL/JSONLobject→ YAML/TOML/XMLarray→ JSONL/YAML/XMLscalar→ YAML
- Migration tutorial (
docs/RESX-MIGRATION.md) — step-by-step guide for taking i18next JSON locales into .NET RESX, with batch flow, Visual Studio verification, comment support, and a worked example using PhantomMAC's 30+ locale files
Status
JSONPrism reaches 1.0. All 9 formats production-ready; web + desktop; bilingual; 110+ tests.
Tests
- 15+ new tests: RESX converter (escaping, comment shape, sort order, error paths, Visual Studio byte-match), suggestions module
- Total tests: 115+
[0.5.0] — 2026-05-12
Added — Phase 2C: Tauri 2 desktop wrapper
src-tauri/Rust workspace with Tauri 2.x:Cargo.toml,tauri.conf.json,src/lib.rs,src/main.rs,build.rs- App identifier:
com.kokone.jsonprism - Bundle targets: Windows (MSI via WiX + NSIS installer), macOS (DMG, min 12.0), Linux (AppImage + deb)
- Window config: 1280×820 default, 800×560 minimum, drag-drop enabled, theme follows system
- CSP locked down to: self + Google Fonts (existing fonts) + IPC channel only
- Tauri 2 plugin integration:
plugin-dialog,plugin-fs,plugin-os,plugin-shell - Capability file (
capabilities/default.json) scoped to$HOME,$DOCUMENT,$DOWNLOAD,$DESKTOP - Custom Rust command
host_infoexposes OS / arch / app version for diagnostics - Frontend Tauri bridge (
src/lib/tauri.ts):isTauri(),nativeOpenFiles(),nativeSaveBlob(),nativeReadText(),fileFromNativePath(),tauriHostInfo() - Native drag-drop hook (
useTauriDragDrop) listens totauri://drag-dropevents and feeds File objects into the existing batch store - InputPanel + BatchPanel branch on
isTauri(): native dialogs in Tauri, web inputs in browser - Single source of truth: same React UI, same converters, same tests — only I/O boundaries branch
- Vite config Tauri-aware: detects
TAURI_ENV_PLATFORM, switches base to/, skips clearing screen, respectsTAURI_DEV_HOSTfor mobile dev - Icon source (
src-tauri/icons/icon.svg, 1024×1024) — generates all platform icons vianpm run tauri:icon - GitHub Actions release workflow (
.github/workflows/release.yml): matrix-builds Windows, macOS (Apple Silicon + Intel), Linux onv*tag push; creates draft GitHub release
Dependencies
- Added
@tauri-apps/api,@tauri-apps/plugin-dialog,@tauri-apps/plugin-fs,@tauri-apps/plugin-os,@tauri-apps/plugin-shell(^2.0.0 each) - Added
@tauri-apps/cli(devDep)
New npm scripts
tauri:dev— runs Tauri window in dev mode with HMRtauri:build— produces the platform's native bundletauri:icon— generates all platform icons fromsrc-tauri/icons/icon.svg
[0.4.0] — 2026-05-12
Added — Phase 2B: Batch processing
- Multi-file queue — drop up to 500 JSON files at once for parallel conversion to any ready format
- Batch panel (Sheet drawer) — per-file status (queued / processing / done / error), inline drop zone, per-row remove
- Cooperative scheduling — yields to the UI between files via
requestIdleCallbackwithsetTimeout(0)fallback, so the browser stays responsive on large queues - Per-file error isolation — broken JSON or converter errors don't stop the rest of the batch; each failure is surfaced inline
- AbortController-based cancellation — Cancel button stops the run mid-batch
.zipexport via fflate (~8KB gzipped, much smaller than JSZip), with automatic filename collision handling (data.csv,data_2.csv, …)- Smart drop routing in input panel — single file goes into the editor, 2+ files auto-open the batch panel and queue them
- Zustand
batchStore—Record<string, BatchItem>+itemOrderfor O(1) per-item updates without re-rendering the whole list - Trigger pill in toolbar shows current queue size
Tests
- 20+ new Vitest tests covering
batchStoremutations,processBatchcooperative scheduling and abort,zipOutputsround-trip (decode and verify contents), filename uniquification - Total tests: 100+
Dependencies
- Added
fflate ^0.8.2(zip)
[0.3.0] — 2026-05-12
Added — Phase 2A: four new converters
- XML converter via fast-xml-parser. Options:
indent,rootName,itemName,declaration. Supports attributes via the@_key prefix convention. - TOML converter via smol-toml. Option:
sortKeys(recursive). Rejects non-object roots with a clear error. - Markdown table converter (hand-rolled). Options:
alignment(left/center/right/none),escapePipes. Newlines in cells become<br>per GFM. - SQL INSERT converter (hand-rolled). Options:
tableName,dialect(standard/postgres/mysql/sqlite/mssql),multiRow,chunkSize,includeCreate. Per-dialect identifier quoting, value escaping, andCREATE TABLEtype inference.
Tests
- 45+ new Vitest tests across XML, TOML, Markdown, and SQL converters (helpers tested in isolation:
quoteIdentifier,formatSqlValue,inferSqlType) - Round-trip tests for XML (via
XMLParser) and TOML (viaparse) - Per-dialect SQL coverage (5 dialects × value types)
- Total Vitest tests: 80+
Changed
- All 8 user-visible converters now report
ready: true. RESX remains Phase 3. xml.ts,toml.ts,markdown.ts,sql.tsare no longer stubs.
[0.2.0] — 2026-05-12
Added — Phase 1 polish
- CodeMirror 6 input editor with JSON syntax highlighting and parse-error linting
- Settings panel (Sheet drawer) auto-generated from each converter's
optionSchema - Per-format options exposed in the UI:
- JSONL:
prettytoggle - CSV/TSV:
headertoggle,newline(LF/CRLF),nestedStrategy(json/flatten) - YAML:
indent(2–8),quoteStyle(auto/single/double)
- JSONL:
- Settings persist to
localStorageper format; survive reload and tabs - File handling: drag-drop + "Open" button for single
.json/.txtfiles - Sonner toasts for copy success, download, file load, options reset, errors
- Keyboard shortcuts:
Cmd/Ctrl+Kclear input,Cmd/Ctrl+Sdownload output - Status bar showing input/output byte counts, parse time, and shortcut hints
- Shape detection hint above the format picker (scalar / object / array / flat-object / array-of-objects)
- Format selection persists to localStorage
- Tests: 35+ Vitest tests covering all Phase 1 converters, registry, shape detection, options storage
Changed
Converter<TOptions>interface now requiresoptionSchema: ReadonlyArray<OptionSchemaField<TOptions>>- YAML
indentoption changed from2 | 4literal tonumber(range 2–8 via integer schema) - Stub converters (XML/TOML/Markdown/SQL/RESX) declare empty
optionSchema: []to satisfy the interface InputPanelandOutputPanelupdated to useCodeEditorand toast notifications
Developer experience
- Vitest +
@testing-library/react+jsdomconfigured npm test,npm run test:watch,npm run test:coveragescripts- CI runs tests between typecheck and build
[0.1.0] — 2026-05-12
Added — Phase 0 scaffold
- Project scaffold with Vite 6 + React 19 + TypeScript 5.7 strict
- Tailwind CSS v4 setup using
@theme inlinesyntax - "Prism Spectrum" theme with violet / cyan / amber / rose accents
- Dark + light theme with system preference detection
- Bilingual interface (English + Vietnamese) via i18next
- React Router v7 with
/and/aboutroutes - Converter framework:
Converter<TOptions>interface, registry, shape detection - Phase 1 working converters: JSONL, CSV, TSV, YAML
- Phase 2 stubs with implementation plans: XML, TOML, Markdown table, SQL INSERT
- Phase 3 stub: RESX (.NET resources)
- UI: header with brand mark, hero, format picker, side-by-side input/output panels
- Copy + download actions with proper MIME types
- shadcn/ui configuration (
components.json) - GitHub Actions CI workflow (format, lint, typecheck, build)
- GitHub Actions deploy workflow → GitHub Pages
- Apache License 2.0
- Full documentation:
README.md(EN + VI),CLAUDE.md,CONTRIBUTING.md,docs/ROADMAP.md