Files
jsonPrism/CHANGELOG.md
T
poli0981andClaude Opus 4.8 3657e21f11 chore(release): v1.6.1 — CodeMirror chunk split + web source-map removal (#76)
Patch release bundling the build-only changes since 1.6.0:
- Split the CodeMirror core chunk (cm-view + cm-core) so no chunk trips
  Vite's 500 kB warning; migrated to Rolldown advancedChunks (#74).
- Stopped shipping source maps on the public web build (#72).
- 27 grouped npm minor/patch dependency updates (#67).

Bumps package.json, package-lock.json, src-tauri/Cargo.toml,
src-tauri/Cargo.lock, src-tauri/tauri.conf.json to 1.6.1 and moves the
CHANGELOG [Unreleased] section to [1.6.1].

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 21:59:53 +07:00

37 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".

[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