# HPL Toolbox

Bundled VS Code extension and standalone tools for playable ad workflows.

# Tools

- **PLEC Upload** - Upload selected HTML files to the internal PLEC server.
- **AppLovin Playable Preview** - Upload HTML files to p.applov.in and generate QR preview links.
- **Base64 Scanner** - Scan HTML files for external or non-base64 asset references.
- **Send To Mobile** - Share selected HTML files to a phone over LAN with a QR code.
- **MRAID Checker** - Check HTML files against MRAID requirements and best practices.
- **Mintegral Checker** - Validate Mintegral playable ZIPs against PlayTurbo requirements.
- **Playworks Converter** - Convert Playworks HTML into per-network variants.
- **Device Simulator** - Preview HTML playables inside accurate mobile device frames with notch and Dynamic Island overlays.
- **Initialize Project** - Download team template files (AGENTS.md, LOCALIZATION.md, .gitignore) from a shared Google Drive manifest.

# Changelog

**v0.1.2**
```
Added
    - Added local hosting for HTML files.
    - Added the standalone app.
```

**v0.1.3**
```
Added
    - Added QR regeneration for AppLovin previews that fail to render.
    - Added Save QR and Save All QRs actions.

Changed
    - Updated AppLovin Demo Upload.
    - Improved the file selection workflow.
```

**v0.1.5**
```
Added
    - Added multi-file selection for PLEC Upload.
    - Added automatic iteration name detection.

Changed
    - Improved PLEC Upload file selection.
    - Moved standalone temporary files into the user temp folder.
```

**v0.1.6**
```
Added
    - Added beta tools for further testing:
        - Playworks Converter for converting Playworks UnityAds HTML into other network variants.
        - MRAID Checker for scanning HTML files against MRAID requirements and best practices.

Changed
    - Simplified the UI.
```

**v0.1.7**
```
Added
    - Added standalone drag-and-drop file/folder selection for HTML inputs across supported tools.
    - Added status throbber/progress updates for batch scans, uploads, sharing, and conversions.
    - Added streamed standalone progress updates so long-running actions update the status bar before completion.

Changed
    - MRAID Checker is no longer marked as beta in extension or standalone.
    - Playworks Converter source selection now matches the other file-selection UIs more closely.
    - Playworks Converter default output folder now resolves to the input file location's Output folder.
    - Progress text now follows the format: [throbber] Verb count file.

Fixed
    - Fixed standalone drag-and-drop handling for multiple files and multiple folders.
    - Fixed cleanup behavior for temporary dropped files when clearing or removing rows.
    - Fixed standalone PLEC Upload Open button using an incorrect/mangled URL by switching to the Windows URL protocol handler.
```

**v0.2.0**
```
Added
    - Added Mintegral Checker to the VS Code extension.
    - Added Mintegral Checker to the standalone app.
    - Added PlayTurbo-compatible runtime validation for Mintegral playables using the injected preview utility script.

Changed
    - Mintegral Checker is available as a regular tool, not a beta tool.
    - Standalone navigation now uses a collapsible sidebar with compact tool initials.
    - Mintegral Checker UI now embeds the playable preview, checklist, runtime events, mute, and reload controls in one view.
```

**v0.2.1**
```
Added
    - Added Device Simulator to the VS Code extension and standalone app.
    - Added editable Device Simulator device lists with add, delete, restore defaults, import, and export.
    - Added drag-and-drop reordering for Device Simulator devices.
    - Added iPhone 17, iPhone Air, iPhone 17 Pro, and iPhone 17 Pro Max defaults.
    - Added drag-and-drop tool reordering with persisted order in the VS Code launcher and standalone Home/sidebar.

Changed
    - Device Simulator settings now use a modal list manager with multi-select, add/delete, and move up/down controls.
    - Standalone Device Simulator sidebar abbreviation is now DS.
    - Send To Mobile browser preview now opens playables in a delayed full-screen preview wrapper while Download still serves the original HTML.

Fixed
    - Fixed Device Simulator mute for HTML media and WebAudio playables.
    - Fixed Device Simulator Add Device and Remove Device interactions inside embedded webviews.
    - Fixed Send To Mobile browser preview spending the View button's initial tap as a premature playable click-through while preserving real user-initiated redirects.
```

**v0.2.2**
```
Added
    - Added automatic update checking to the VS Code extension and standalone app.
```

**v0.2.3**
```
Added
    - Added Localization dropdown in Device Simulator.
```

**v0.2.4**
```
Added
    - Added Initialize Project tool to the VS Code extension and standalone app.
    - Downloads team template files (AGENTS.md, LOCALIZATION.md, .gitignore) from a shared manifest.
    - Manifest is a JSON file hosted on Google Drive or any direct URL, listing files with name, URL, and description.
    - Manifest URL is configurable per-user; defaults to the shared team Google Drive manifest.
    - Google Drive share links are automatically converted to direct download URLs.
    - Files panel shows a checklist loaded from the manifest with per-file Open button and Refresh/Configure controls.
    - Destination folder is selectable via folder picker, defaulting to workspace root in the extension.
    - Standalone stores the manifest URL in config.json and exposes an inline URL editor via the settings (⚙) button.
```

**v1.0.0**
```
Added
    - Added remote devices.json and languages.json support for Device Simulator.
    - Device and language lists are fetched from a configurable Google Drive URL on open and cached for offline use, with built-in defaults as fallback.
    - Device Simulator remote JSON URLs are configurable in VS Code extension settings (hplToolbox.deviceSimulator.devicesUrl / languagesUrl).
    - Settings modal in standalone — accessible from any page via the ⚙ button, with Device Simulator and Initialize Project sections highlighted when opened from those tools.
    - Device list is now sorted alphabetically in both extension and standalone.

Changed
    - Device Simulator settings gear now opens the VS Code extension settings (extension) or the global settings modal (standalone).
    - Device management (add/edit/delete/reorder) removed from Device Simulator in both extension and standalone; device list is now managed via remote JSON.
    - Settings page in standalone replaced by a modal overlay available on every page.
    - Initialize Project manifest URL is now configured via the settings modal instead of the inline settings panel.

Fixed
    - Fixed Device Simulator not appearing in the VS Code extension launcher due to a trailing comma in tools.json causing JSON.parse to fail and fall back to a hardcoded list that excluded it.
```