Bump version 1.6.1 -> 1.7.0 (Android versionCode 10700) and document the release. Highlights: signed universal Android APK (minSdk 31), self-hosted fonts for full offline rendering, robust SAF content-URI file open. See CHANGELOG.md for details. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
39 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 at this time. Future work tracked in docs/ROADMAP.md under "Beyond".
[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