🛠️ Custom Install Path Support

This release adds the ability to specify a custom installation directory for the onUI extension via the --path parameter in the install script.

✨ New Features

Custom Install Path Parameter

• Add --path parameter to install.sh script
• Allows users to override the default ~/.onui installation directory
• Automatically updates all derived paths (extensions, MCP, current symlink)

📝 Usage

# Install to custom directory
./install.sh --path /custom/install/location

# Install to custom directory with MCP setup
./install.sh --path /opt/onui --mcp

# Install Firefox extension to custom directory
./install.sh --path ~/my-extensions --firefox

The --path parameter overrides the ONUI_HOME environment variable and ensures all components (extension files, MCP bridge, version symlinks) are installed to the specified location.

🔧 Technical Details

• Updated scripts/install/install.sh.template to support --path parameter
• Parameter validation ensures path argument is provided
• Recalculates EXT_ROOT, EXT_DIR, CURRENT_LINK, and MCP_DIR based on custom path
• Sets ONUI_HOME_IS_DEFAULT=0 to prevent legacy migration when using custom path

🐛 Bug Fixes

None in this release.

📦 Files Changed

• scripts/install/install.sh.template: Add --path parameter support

🔗 Related Issues

Resolves #11

🚀 Upgrade Notes

No breaking changes. Existing installations using the default ~/.onui path are unaffected. The --path parameter is optional and only used when explicitly specified.

🎯 Frozen Annotate Session (Lean v1)

This release implements viewport freezing during annotate mode to prevent modal dismissal when selecting elements inside dialogs and modals.

✨ New Features

Frozen Annotate Session

• Captures viewport screenshot when entering annotate mode
• Displays frozen overlay to prevent host page interactions
• Resolves element selection via coordinate-based detection
• Caches element rects for stable highlighting and dialog positioning
• Automatically tears down freeze session when exiting annotate mode

🔧 Technical Implementation

• CAPTURE_VIEWPORT messaging: Background handler for screenshot capture with viewport metadata
• useFreezeSession hook: Manages freeze lifecycle, viewport capture, and rect caching
• FrozenOverlay component: Screenshot-based interaction layer with coordinate forwarding
• page-inert utilities: Blocks scroll, wheel, pointer, and navigation key events on host page
• App.tsx integration: Unified frozen/live hover paths with degraded fallback behavior

🧪 Test Coverage

• 3 critical lean v1 modal-overlay tests
• 5 background CAPTURE_VIEWPORT handler tests
• 9 useFreezeSession hook tests
• 12 page-inert utility tests
• All 65 extension tests passing

🐛 Bug Fixes

• Fixes modal dismissal when clicking elements inside dialogs during annotation
• Prevents host page scroll/interaction during frozen annotate sessions

📦 Files Changed

New files:

• packages/extension/src/background/messages.test.ts
• packages/extension/src/content/components/FrozenOverlay.tsx
• packages/extension/src/content/hooks/useFreezeSession.ts
• packages/extension/src/content/hooks/useFreezeSession.test.ts
• packages/extension/src/content/utils/page-inert.ts
• packages/extension/src/content/utils/page-inert.test.ts

Modified files:

• packages/extension/src/background/messages.ts
• packages/extension/src/content/messaging.ts
• packages/extension/src/content/components/App.tsx
• packages/extension/src/content/components/ElementHighlight.tsx
• packages/extension/src/content/components/OnUIDialog.tsx
• packages/extension/src/content/components/App.modal-overlay.test.tsx
• packages/extension/src/types/messages.ts
• packages/extension/src/types/index.ts

🚀 Upgrade Notes

No breaking changes. The frozen annotate session activates automatically when entering annotate mode.

Full Changelog: v2.1.1...v2.1.2

Full Changelog: v2.1.0...v2.1.1

Full Changelog: v2.0.0...v2.1.0

Highlights

• Introduces a dual capture model: Annotate mode for precise element feedback (including Shift multi-select) and Draw mode for rectangle/ellipse region feedback across layout and spacing issues.
• Adds region editing with persistent outlines and transform handles so drawn regions can be refined after capture.
• Redesigns the floating toolbar into a compact rail with a readable pop-out settings card for Output level and Clear on copy.
• Expands report output in compact, standard, detailed, and forensic modes to preserve explicit region target metadata and geometry.
• Improves local MCP querying so region annotations are searchable by target type, shape, and geometry text.

Docs and product updates

• Updates the landing page, README, usage guide, MCP setup guide, and release runbook to highlight the annotate + draw workflow and the new toolbar design.
• Bumps runtime and package versions to 2.0.0 across the extension, core package, and MCP server.

Validation

• pnpm --dir "/Users/tushars/PycharmProjects/onUI/packages/extension" test -- OnUIToolbar.test.tsx
• pnpm --dir "/Users/tushars/PycharmProjects/onUI" build
• ./app.sh --build

Full Changelog: v1.1.0...v2.0.0

What's Changed

• fix(mcp): chrome native host allowlist for store + unpacked by @iota31 in #6

Full Changelog: v1.0.16...v1.0.17

What's Changed

• fix(ci): make clean-run quality checks pass by @iota31 in #4
• chore(release): v1.0.16 by @iota31 in #5

Full Changelog: v1.0.15...v1.0.16

Full Changelog: v1.0.14...v1.0.15

Full Changelog: v1.0.13...v1.0.14