Skip to content

feat: Vue DevTools inspector + docs workspace - #246

Merged
s00d merged 8 commits into
mainfrom
feat/vue-devtools-and-docs-workspace
Aug 5, 2026
Merged

feat: Vue DevTools inspector + docs workspace#246
s00d merged 8 commits into
mainfrom
feat/vue-devtools-and-docs-workspace

Conversation

@s00d

@s00d s00d commented Aug 5, 2026

Copy link
Copy Markdown
Owner

Summary

  • Extract VitePress into @i18n-micro/docs workspace package (deps off root)
  • Add official Mintlify Ask AI widget with branded trigger on VitePress docs
  • Add optional Vue DevTools live inspector (vueDevtools, @i18n-micro/core/devtools) and fix Nuxt DevTools client path for source-linked playground
  • Patch-bump affected workspace packages; root stays 3.26.0

Test plan

  • pnpm install then pnpm typecheck
  • pnpm --filter @i18n-micro/core build and open Vue DevTools inspector in playground
  • Confirm Nuxt DevTools i18n tab loads without subprocess/VUE_ROUTER_R0004 when using modules: ['../src/module']
  • pnpm docs:dev — Ask AI widget opens; dark/light theme follows
  • pnpm run release:source and pnpm run check:versions -- --npm --base origin/main

Made with Cursor


Summary by cubic

Adds an optional Vue DevTools inspector and timeline for live i18n debugging in dev, and moves the VitePress docs into a new @i18n-micro/docs workspace with a Mintlify Ask widget and branding. The inspector uses encoded key paths, updates in real time, distinguishes load vs refresh, and fixes Active tags when the route is empty.

  • New Features

    • Vue DevTools (dev only): custom inspector + timeline for locale, route chunks, cache, and missing keys; $t tracing with debug: true.
    • New option i18n.vueDevtools (default true in dev) to toggle the browser extension; Nuxt DevTools tab stays the same.
    • Core helpers exported at @i18n-micro/core/devtools for inspector tree/state with encoded key paths.
    • Docs extracted to @i18n-micro/docs; Mintlify Ask widget with branded trigger and theme-aware styling; trigger covers the widget’s shadow host; optional peer @vue/devtools-api bumped to ^8.1.5.
  • Bug Fixes

    • Inspector refreshes on mutations, keeps dotted keys distinct via encoded paths, normalizes empty route to index, and keeps chunk-level Active tags in sync.
    • Timeline shows load vs refresh reasons; missing-key events use route-aware context.
    • Removed dead bridge/useState paths; dev-only bridge kept out of serializable state.

Written for commit 1ea6755. Summary will update on new commits.

Review in cubic

s00d and others added 5 commits August 5, 2026 16:19
Move docs deps out of root so the module package stays lean.

Co-authored-by: Cursor <cursoragent@cursor.com>
Official embed with branded trigger; hide closed Shadow DOM button.

Co-authored-by: Cursor <cursoragent@cursor.com>
Optional inspector/timeline for locale, chunks, and missing keys.

Co-authored-by: Cursor <cursoragent@cursor.com>
Patch bumps for packages depending on core/types changes.

Co-authored-by: Cursor <cursoragent@cursor.com>
Cover vueDevtools option and core/devtools export.

Co-authored-by: Cursor <cursoragent@cursor.com>
@bolt-new-by-stackblitz

Copy link
Copy Markdown

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

@cursor

cursor Bot commented Aug 5, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 51 files

Heads up: you’re close to your included review allowance. Set a flex budget so reviews don’t pause.

Re-trigger cubic

Comment thread docs/.vitepress/config.mts Outdated
Comment thread src/runtime/utils/nuxt-i18n.ts Outdated
Comment thread src/runtime/utils/nuxt-i18n.ts Outdated
Comment thread src/runtime/plugins/04.vue-devtools.ts Outdated
Comment thread packages/core/src/devtools.ts Outdated
Comment thread src/runtime/devtools/vue-devtools.ts Outdated
Comment thread docs/.vitepress/theme/custom.css
Comment thread src/runtime/devtools/bridge.ts
Comment thread package.json Outdated
Comment thread src/runtime/plugins/01.plugin.ts Outdated
Keep Ask AI trigger covering Mintlify shadow host, notify inspector
on mutate, encode key paths, and drop dead bridge/useState paths.

Co-authored-by: Cursor <cursoragent@cursor.com>

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 15 files (changes from recent commits).

Reply with feedback, questions, or to request a fix.

Fix all with cubic | Re-trigger cubic

Comment thread src/runtime/utils/nuxt-i18n.ts
Comment thread src/runtime/devtools/vue-devtools.ts Outdated
Comment thread docs/package.json Outdated
Normalize empty route to index, drop duplicate docs serve, test
onContextChange reasons and route-aware missing keys.

Co-authored-by: Cursor <cursoragent@cursor.com>

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 5 files (changes from recent commits).

Tip: Review your code locally with the cubic CLI to iterate faster.

Fix all with cubic | Re-trigger cubic

Comment thread packages/core/src/devtools.ts Outdated
Keep chunk Active tags in sync with key-level active detection.

Co-authored-by: Cursor <cursoragent@cursor.com>
@s00d
s00d merged commit cf4c4ca into main Aug 5, 2026
1 of 2 checks passed
@s00d
s00d deleted the feat/vue-devtools-and-docs-workspace branch August 5, 2026 12:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant