# 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. Beta.

# 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.
```