Files
jsonPrism/CHANGELOG.md
T
poli0981andClaude Opus 5.5 29d417ec93 feat: 2.2.0 — accessibility statement and fixes (#177)
ACCESSIBILITY.md (+ Vietnamese mirror) states the WCAG 2.2 AA goal, what works, a keyboard reference, what was tested, known limitations and how to report a barrier; new accessibility issue template. Fixes from an audit: skip link, focus after navigation and consent, visible focus everywhere incl. forced-colors, Esc-then-Tab hint and aria-invalid on the input editor, a quieter status bar, names that match visible labels, translated screen-reader strings, page zoom in the desktop apps. axe-core scan in CI. Docs synced (vi PRIVACY/dev_env, README credits, ROADMAP). Version 2.2.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 16:04:59 +07:00

63 KiB
Raw Permalink Blame History

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 at this time. Future work tracked in docs/ROADMAP.md under "Beyond".

[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-zoom permission, 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).
  • Accessibility statement. ACCESSIBILITY.md and 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.md links the accessibility checks to run before a release.
  • The Vietnamese mirrors, docs/i18n/vi/PRIVACY.md and docs/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-core 4.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-dialog 2.8.4; dev: ESLint 10.14, typescript-eslint 8.72.1, globals 17.14, Vitest and @vitest/coverage-v8 5.1, @vitejs/plugin-react 6.2.1, Tailwind CSS and @tailwindcss/vite 4.3.4, knip 6.44.1, wrangler 4.157, @types/node 26.6.6. Transitive packages refreshed within their ranges; the lockfile is smaller because Vite and Tailwind now share one lightningcss. All 426 packages have verified registry signatures.
  • Rust: cargo update within 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-event on its own, so it left ignoreDependencies.
  • THIRD-PARTY.md lists the versions locked for 2.1.1 again; some rows had not been updated since 2.0.0.

Security

  • npm audit still 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 at optimizationLevel 2 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 changes partial matching, 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 Code settings.json, .code-workspace and deno.jsonc files. Pick JSONC in the → JSON direction, paste or drop .jsonc and .json files (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/verify keeps its own 30 a minute on top. Over the limit, pages get a plain-text 429 Too Many Requests in English, Vietnamese, Japanese and Chinese, and the API gets {"ok":false,"error":"rate_limited"}; both carry Retry-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-codemirror renders 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 JavaScript eval) 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-topics was removed from the Permissions-Policy header, 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.jsonc serves dist/ as static assets with an SPA fallback on the custom domain; only /api/* runs Worker code (worker/). Cloudflare Workers Builds deploys every push to main and publishes a Worker Preview for other branches (previews block). New scripts: cf:types, cf:check (deploy dry run, also in CI) and preview:cf (wrangler dev on port 8787; wrangler.jsonc builds first). See docs/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/_redirects 301s 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/health reports 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.ts keeps 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 escapeFormulae option (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.txt and 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=cover with safe-area padding.

Changed

  • Toolchain. Node.js 26 (.nvmrc, engines >=26). TypeScript 7 native compiler (@typescript/native provides tsc; typescript is 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 8 codeSplitting.groups replaces the deprecated advancedChunks.
  • Dependencies to current majors: React 19.3, React Router 8 (react-router only), 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 audit reports 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 adds object-src 'none', base-uri, form-action and frame-ancestors. The version now comes from package.json; Android versionCode 20000 and allowBackup="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 Rust fmt/clippy job 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 APK JSONPrism_<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 → 7 or 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 uses N'…' and NVARCHAR, CREATE TABLE types 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 rejects DOCTYPE; 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 key attribute), 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 quoteStyle had no effect; it works again with js-yaml 5. Alias and merge-key bombs are capped, and empty input reports an error instead of undefined.
  • TOML reports null values 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, .ndjson and .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 localStorage can 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-pressed on toggle groups; touch targets of at least 24 px; <html lang> follows the interface language.

Removed

  • The GitHub Pages deployment (deploy.yml, public/404.html and 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-yaml and the unused os plugin (@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 (app in jsdom, worker in 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's open() has no URL handler on Android and failed with "os error 2". openExternal() now uses @tauri-apps/plugin-opener's openUrl(), which hands the URL to the system browser through Intent.ACTION_VIEW. The shell plugin, its capability and its npm package were removed. Verified on an Android 13 emulator. bundle.android.versionCode 10702.

[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 as false in vitest.config.ts so 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's localStorage like the web build, so it asks once. The gate's links also gained an openExternal() helper (src/lib/tauri.ts) that routes through @tauri-apps/plugin-shell inside Tauri — the Android WebView swallows plain target="_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 (new toast.files_loaded keys, 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.versionCode bumps 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 .apk from 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_SDK on 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 via plugin-dialog + plugin-fs (no behavior change to the converters). The generated Gradle project lives in src-tauri/gen/android/ (committed — source only; build outputs + signing material gitignored); release signing reads a gitignored keystore.properties with a graceful unsigned fallback. New npm run tauri:android:{init,dev,build} scripts, and an android job in .github/workflows/release.yml builds + signs the APK and attaches it to the same draft release as the desktop bundles. bundle.android.versionCode is derived from the version as MAJOR*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; see docs/TAURI-NOTES.md.

Changed

  • Self-hosted fonts (offline-ready). Geist, Instrument Serif, and JetBrains Mono are now bundled via @fontsource (imported in src/main.tsx) instead of fetched from Google Fonts. The <link> tags are gone and the CSP no longer allows fonts.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 Android content:// URIs via a new basenameFromPath() 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 lenient filterByExtension mode. 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-core chunk was ~614 kB raw (210 kB gzip) and tripped Vite's chunkSizeWarningLimit on every build, even though it is already lazy-loaded behind the editor. Vite 8 / Rolldown deprecates the manualChunks function form (its optimizer silently merged sub-chunks back together), so vite.config.ts now uses advancedChunks.groups with explicit priority-ordered, honored boundaries. The CodeMirror core splits into cm-view (~245 kB, the @codemirror/view DOM engine) + cm-core (~362 kB, state/language/lezer/@uiw wrapper); cm-langs is 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 existing React.lazy boundary, 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; all cm-* chunks 200 OK, no console errors).

Fixed

  • Stop shipping source maps on the public web build. vite.config.ts now emits source maps only for local non-production web builds (sourcemap: !isTauriContext && mode !== 'production') — never for the GitHub Pages deploy or Tauri bundles. The entire dist/ is uploaded to Pages, so earlier production builds exposed the full original source via .map files 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-patch Dependabot bump).

[1.6.0] — 2026-06-14

Added

  • Custom error pages. A reusable presentational ErrorState component (src/components/common/ErrorState.tsx) backs a 404 catch-all route (src/pages/errors/NotFound.tsx) and a generic /error/:code route (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. New error_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 new src/components/ui/dialog.tsx Radix 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 to localStorage (jsonprism.consent — flag + version + timestamp) via src/lib/consent-storage.ts and a Zustand store (src/stores/consentStore.ts); bump CONSENT_VERSION to 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. New consent.* i18n group in EN + VI; PRIVACY.md documents the new key.
  • Windows installer license-acceptance page. bundle.licenseFile in tauri.conf.json now points at src-tauri/license.rtf (a short EULA referencing Apache-2.0 + TERMS / PRIVACY / DISCLAIMER). Both the NSIS .exe and the WiX .msi show an accept-to-continue license page — RTF satisfies both, so targets: "all" is preserved.
  • Offline indicator. useOnlineStatus hook + a non-blocking OfflineBanner strip between the header and content. Informational only — JSONPrism keeps working offline.
  • GitHub Pages deep-link support. public/404.html (spa-github-pages redirect, pathSegmentsToKeep = 1 for the /jsonPrism/ base) plus a tiny decoder in index.html make 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 now React.lazy + Suspense (the editor degrades to a real <textarea> while its chunk loads, so input stays usable). A ChunkErrorBoundary catches a failed dynamic import (e.g. stale deploy) and offers reload without crashing the page; non-chunk errors rethrow to the existing crash ErrorBoundary, which now shares the ErrorState visual. manualChunks in vite.config.ts was refined to split react / 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 bson leak. decodeBytes / encodeBytes moved from src/converters/bson.ts to a parser-free src/lib/bytes.ts; OutputPanel and the CBOR / MessagePack converters import from there, so the bson library 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, bytes codec, isChunkLoadError, the ErrorState component, and the useOnlineStatus hook. Typecheck, lint, knip, prettier --check, and npm audit (0 vulnerabilities) all green; consent gate / 404 / /error/:code verified 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. Respects prefers-reduced-motion (jumps instead of animating) and stays out of the keyboard tab order / accessibility tree while hidden. New i18n key common.scroll_to_top across all four locales (en/vi/ja/zh-CN). The button is About-only by design — the converter workspace uses a fixed h-dvh layout that never page-scrolls.

Changed

  • Internal refactor — three oversized components decomposed (behavior-preserving). BatchPanel.tsx (515 lines), ConverterWorkspace.tsx (314), and InputPanel.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 — plus converter/BatchItemRow.tsx and converter/BatchSummaryChips.tsx), and hooks (useFileAccept, useBatchActions, useConversionResult, useOutputBadge, useBatchFileRouter). No converter or UI behavior changed; all 193 unit tests still pass.

Tooling

  • knip integrated for dead-code analysis. New knip.json config, an npm run knip script, and a Knip step in CI (.github/workflows/ci.yml) — unused files and dependencies are now caught on every push. The initial sweep deleted the orphaned src/hooks/useLocalStorage.ts (superseded by lib/options-storage.ts), dropped the unused i18n default export and the unused BatchPanel prop onAddExternalFiles, and un-exported the internally-used nativeReadText. knip's export-level types check is disabled — the converter-contract types in converters/types.ts are intentional public vocabulary, not dead code.

Fixed

  • globals was a phantom (undeclared) devDependency. eslint.config.js imports globals, but it was never listed in package.json — linting only worked because ESLint pulls globals in transitively. Now declared explicitly so a stricter or deduped install can't break npm run lint. Surfaced by the new knip check.

Dependencies

  • Added knip ^6.14.1 (ISC, dead-code analyzer, devDep) and globals ^14.0.0 (MIT, explicit devDep — previously resolved transitively). THIRD-PARTY.md updated.

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, and prettier --check are 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 attached r.target.setPointerCapture(r.pointerId) unconditionally on pointerdown, 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 bundled dismiss() handler never ran. The bug fired on both mouse and touch because the PointerEvent API is unified. Upgraded sonner ^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 the toast.success/warning/error/info call 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 recommended 360×640 minimum. README EN + VI link to it.
  • Touch hit-area expansion on the toast close button. A ::after pseudo gives an effective ~36–40px tap target (visible size stays at sonner's 20px default), plus touch-action: manipulation to 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 shadcn Tabs primitive (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 output changes 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 single Target 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-1 mobile 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 in THIRD-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 JSONPrism wordmark below sm (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's overflow-hidden then clipped the lower (output) panel off-screen. Replaced with grid-rows-2 md:grid-rows-1 so 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 for h-dvh (Tailwind v4 dynamic viewport height).

Docs

  • THIRD-PARTY.md now 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… and Output 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 keys home.input_placeholder_format and home.output_empty_format carry {{ext}}; the panels resolve converter.meta.extension.toUpperCase(). Forward mode keeps the JSON-specific copy.
  • "Multi-target formats" slogan replaces "Eight target formats" in app.description across 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 via StreamLanguage.define). CSV/TSV stay plain — no fitting CodeMirror grammar. All new packs flow into the existing codemirror manualChunk; no initial-bundle regression.
  • Social links UI. New src/components/common/SocialIcons.tsx houses six inline-SVG brand icons (Discord, X, Bluesky, Mastodon, Telegram, YouTube) since lucide-react has 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 a Community section between Donate and Third-party listing all six. New i18n keys about.community.* and social.* 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 in InputPanel / OutputPanel collapse to icon-only on mobile (label moves to aria-label / title). Workspace input/output panels keep a min-h-[40vh] floor on mobile so the stacked layout stays usable. Home hero stacks on mobile; About page shrinks outer padding; FormatPicker chips 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-scroller was set to scrollbarWidth: '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 to scrollbarWidth: 'thin', an explicit overflow: 'auto', and a themed ::-webkit-scrollbar thumb. 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 from Vite 6 to Vite 8 in both files (package.json has been on ^8.0.0; the About page already reflected this). Both READMEs gain a Community section 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 the codemirror manualChunk via vite.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 duplicate toast. Root cause: fileFromNativePath constructed new File([text], name, { type }) without lastModified, so the File API defaulted to Date.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-fs and use the real mtime, falling back to an FNV-1a hash of the path if stat() throws. Bonus: infer type from the file extension instead of hard-coding application/json. Added the fs:allow-stat permission to the default capability.

Tests

  • 3 new unit tests for pathHashAsMillis in src/lib/__tests__/tauri.test.ts. Total tests: 193.

Verified

  • Windows Sandbox (Windows 11): manual smoke test passed — re-dropping the same .json file surfaces the duplicate toast 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.handleMultiFileDrop called batchStore.addFiles directly — skipping the direction × format extension whitelist that the web react-dropzone path enforced. Files like .cs/.py leaked into the queue with no warning. Extracted src/lib/file-filter.ts (getAllowedExtensions + extOf + filterByExtension) and routed the Tauri callback, BatchPanel, and InputPanel through 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, and filterByExtension in src/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 Vite base was /jsonprism/ (lowercase), so index.html referenced /jsonprism/assets/*.js. Rebased Vite base, React Router basename, and all GitHub URLs in code/docs to match the existing repo case jsonPrism. Storage keys / package name / Tauri identifier remain lowercase.
  • Release workflow macOS Intel build cancelled. GitHub Actions macos-13 runners no longer pick up jobs (jobs queue indefinitely then auto-cancel after timeout). Replaced the two-entry macOS matrix (Apple Silicon + Intel) with a single macos-14 build using --target universal-apple-darwin. The resulting .dmg / .app runs 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-yaml and @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) owns input + format + direction + optionsByFormat; input is 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/.txt forward; <format>/.txt reverse) with a warning toast. Files like .cs or .py no longer leak into the queue via "Browse".
  • .scrollbar-hide utility class in globals.css — applied to .cm-scroller (CodeEditor theme), OutputPanel, and the About page wrapper. Window scrollbar untouched for a11y.
  • Direction-aware batch text: batch.description interpolates {{from}}/{{to}} ("Process multiple YAML files into JSON…"); new drop_idle_format + empty_format use {{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 from README.md and README.vi.md.

Fixed

  • Input editor overflow: long pastes now scroll inside .cm-scroller instead of pushing past the StatusBar. Root cause was a missing min-h-0 on 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-yaml and @codemirror/lang-xml (both MIT). Both fold into the existing codemirror manualChunk.

Tests

  • 8 new unit tests: 6 for workspaceStore (setters, persistence, format-switch options retention), 2 for batchStore dedup 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 existing disclaimer.translation i18n key.
  • Reverse batch processing — drag-drop multiple non-JSON files in reverse mode, get a .zip of .json outputs back. batch-processor gained a direction parameter that routes through converter.reverse() instead of parseJsonInput.
  • 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 GraphQL createDiscussion mutation; requires Discussions + an Announcements category 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 under docs/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 Vite define from git 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 /jsonprism in Tauri bundles (which serve from /), so no routes matched and the page rendered blank. Introduced build-time __IS_TAURI_BUILD__ Vite define keyed off TAURI_ENV_PLATFORM.
  • Workflow skip noise: notify-ci-failure.yml and notify-release-pipeline.yml dropped workflows: ["*"] catch-all in favor of explicit workflow names; massively fewer "skipped" runs in the Actions tab.

Changed

  • GitHub Actions bumped: actions/checkout v4 → v6, actions/setup-node v4 → 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 encoding option; downloads decode back to raw bytes for proper binary files (.bson, .cbor, .msgpack). New ConverterMeta.binary flag.
  • Reverse conversion — Converter<T>.reverse(input, options) optional interface method. Five reverse implementations: JSONL, CSV/TSV, YAML, TOML, RESX → JSON. UI: new DirectionToggle component persisted to localStorage; FormatPicker disables formats without reverse(); OutputPanel swaps extension to .json in reverse mode.
  • Tauri process hygiene: explicit RunEvent::ExitRequested + WindowEvent::CloseRequested cleanup in src-tauri/src/lib.rs. Calls cleanup_before_exit() so any spawned shell children are signaled before shutdown. New docs/TAURI-NOTES.md documents the upstream WebView2 GDI leak.

Fixed

  • 8 TypeScript strict errors (override modifier, exactOptional, Blob Uint8Array<ArrayBuffer>).
  • npm run typecheck script switched from tsc --noEmit (no-op with the root tsconfig) to tsc -b --noEmit. CI now actually catches type errors.
  • Theme toggle rewritten: replaced racy onBlur timeout with pointerdown click-outside detection + Escape key + ARIA role="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.ts manualChunks converted 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 / writer resheaders
    • Proper XML escaping: &, <, > in text; quotes in name= attributes
    • Rejects nested objects (the only valid use of nesting is the { value, _comment } shape)
  • Smart format suggestions — picker now highlights formats matching the detected JSON shape with a subtle ring:
    • flat-object → RESX surfaces first
    • array-of-objects → CSV/TSV/Markdown/SQL/JSONL
    • object → YAML/TOML/XML
    • array → JSONL/YAML/XML
    • scalar → 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_info exposes 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 to tauri://drag-drop events 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, respects TAURI_DEV_HOST for mobile dev
  • Icon source (src-tauri/icons/icon.svg, 1024×1024) — generates all platform icons via npm run tauri:icon
  • GitHub Actions release workflow (.github/workflows/release.yml): matrix-builds Windows, macOS (Apple Silicon + Intel), Linux on v* 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 HMR
  • tauri:build — produces the platform's native bundle
  • tauri:icon — generates all platform icons from src-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 requestIdleCallback with setTimeout(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
  • .zip export 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> + itemOrder for 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 batchStore mutations, processBatch cooperative scheduling and abort, zipOutputs round-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, and CREATE TABLE type 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 (via parse)
  • 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.ts are 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: pretty toggle
    • CSV/TSV: header toggle, newline (LF/CRLF), nestedStrategy (json/flatten)
    • YAML: indent (2–8), quoteStyle (auto/single/double)
  • Settings persist to localStorage per format; survive reload and tabs
  • File handling: drag-drop + "Open" button for single .json / .txt files
  • Sonner toasts for copy success, download, file load, options reset, errors
  • Keyboard shortcuts: Cmd/Ctrl+K clear input, Cmd/Ctrl+S download 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 requires optionSchema: ReadonlyArray<OptionSchemaField<TOptions>>
  • YAML indent option changed from 2 | 4 literal to number (range 2–8 via integer schema)
  • Stub converters (XML/TOML/Markdown/SQL/RESX) declare empty optionSchema: [] to satisfy the interface
  • InputPanel and OutputPanel updated to use CodeEditor and toast notifications

Developer experience

  • Vitest + @testing-library/react + jsdom configured
  • npm test, npm run test:watch, npm run test:coverage scripts
  • 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 inline syntax
  • "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 /about routes
  • 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