# Desktop validation record

## Activity layout fix — version 0.1.1

The hidden slide container now stays hidden when a separate H5P screen is active. Small or tall H5P activities remain visible and interactive with internal scrolling; expansion is optional. Future exports include the corrected visibility CSS and bridge. Desktop playback also supplies the shared fixed bridge and course-shell visibility rule to existing imports without rewriting course content or learner data.

Verified on Windows against the packaged 0.1.1 application using an isolated, read-only-source copy of the reported Arabic mathematics course: the screen activity occupied the entire 958 × 607 CSS-pixel stage; the old slide had computed `display: none`; both screen and inline H5P content loaded visibly; inline controls could be answered/submitted; expansion and return worked. Future-export CSS was separately checked without the desktop compatibility rule. Images and measurements are in `test-results/activity-screen-fixed.png`, `activity-inline-preserved.png`, and `activity-layout.json`.

Regression checks: 29 shared H5P state/preview tests, nine desktop core tests, production build/lint, and the 19-check packaged desktop acceptance flow passed, including all eight H5P types, completion, and resume. Rebuilt unsigned installer: `release/DocuDeck Player Setup 0.1.1.exe`. Linux/macOS execution remains unverified here. Already exported packages running outside the updated desktop player require re-export to receive these fixes.

The record below describes the initial 0.1.0 baseline.

Date: 2026-11-13. This record distinguishes local Windows evidence from unexecuted platform configurations. It is not a production deployment or a claim of universal SCORM compatibility.

## Implemented

- Electron 45 application around the existing React/TypeScript frontend.
- Multi-package library, folders, moves, search/sort, favorites, recent courses, details, and grid/list views.
- Worker-based validated imports, cancellation cleanup, identical ZIP detection, explicit version isolation, and offline-dependency warnings.
- Sandboxed course windows, a course-scoped SCORM 1.2 bridge, durable SQLite progress, and additive local database migration.
- Private read-only loopback content delivery for H5P compatibility and streaming media with byte-range support.
- Light/dark/system appearance, Arabic/English interface, RTL, keyboard controls, reduced motion, and branded application icons.
- Windows installer configuration and macOS/Linux package definitions; a three-OS GitHub Actions acceptance workflow.

## Local verification

Windows 10 build 19045, x64. Electron 45.3.1; Node 26.5.1 used for local tooling (CI selects Node 24).

| Check | Evidence |
| --- | --- |
| TypeScript and Vite production build | Passed |
| Frontend lint | Passed without warnings |
| Nine focused Node tests | Passed: SQLite persistence/migration, SCORM lifecycle/counts/time, byte ranges, manifest scope, loopback boundaries, slide progress, unsafe archives, real H5P package import |
| Electron desktop acceptance | Passed in development and against the final packaged Windows application: 19 acceptance checks, including all eight H5P types, completion, and restart/resume |
| Library operations | Batch import, cancellation, duplicate detection, independent versions, course removal, folder deletion retaining courses |
| Real H5P runtime | Multiple choice, true/false, fill blanks, drag/drop, drag words, dialog cards, accordion, and image hotspots; course completion and saved state |
| Media | Original local H.264/AAC video/audio fixture, seeking, and caption track |
| Isolation | No Node/native app bridge in course content; external fetch blocked |
| Persistence | SCORM commit, course reload, app restart/resume, separate course answers, preferences |
| Visual review | Library, authored H5P player, Arabic RTL, and dark settings screenshots |
| Dependency audit | Root application and packaging dependencies: zero reported vulnerabilities after a narrow minimatch override; frontend install also reported zero |
| Windows artifacts | Unpacked executable and unsigned NSIS installer built locally |

Generated evidence is under `test-results/` (Git-ignored): `acceptance.json`, library/H5P/settings screenshots, and `import-performance.json`. Regenerate with the commands in [DESKTOP.md](DESKTOP.md). The small media fixture is original generated content checked into `tests/fixtures`.

The final packaged run reached the library interface in 445 ms in the automated local environment. This is one local launch measurement, not a guaranteed cold-start time. The Windows installer is `release/DocuDeck Player Setup 0.1.0.exe`; the tested application executable is `release/win-unpacked/DocuDeck Player.exe`. The installer was built; the packaged application's runtime was tested without installing it into this machine's user profile.

## Import performance sample

On the local Intel Core i9-13900H / approximately 16 GB RAM machine, a synthetic package containing a **256 MB uncompressed resource** imported through the worker in **499 ms**. The parent timer continued ticking, with a maximum measured delay of **12 ms** and an approximately **42 MB** process RSS increase during the import.

This intentionally compressible archive was only 261,688 bytes. It checks streamed extraction and parent responsiveness; it does not represent the download/import cost of a 256 MB compressed video package, performance on lower-end hardware, or long-running memory stability. No universal speed or memory guarantee is implied.

## Remaining release acceptance

- Execute the configured macOS and Linux jobs and review actual playback/install behavior on those operating systems. No macOS/Linux binary has been validated from this Windows session.
- Sign Windows distribution artifacts and sign/notarize macOS releases when distribution credentials are available. The current Windows build is unsigned.
- Exercise representative customer courses/codecs and prolonged repeated playback on lower-end hardware; the synthetic profile is not a full performance certification.
- Verify forced termination/power-loss behavior beyond successful synchronous commits and normal restart. Checkpoints bound ordinary unsaved work; they cannot preserve answers the authored activity never reports.
- Treat platform minimum versions/architectures as a release matrix to confirm against Electron requirements and actual CI results. Do not infer all variants from the tested Windows x64 build.

The main product functionality is implemented in the agreed single stage. The stage's full cross-platform release acceptance remains open until the platform-specific checks above have evidence. Existing Laravel/MySQL data and production services were not migrated or deployed.

## Number-style compatibility: 0.1.2 (2026-11-15)

The bundled H5P compatibility bridge now honors a course's explicit English or Arabic digit setting independently of player language. Existing packages without the setting retain their previous behavior. See [course number style](../docs/course-number-style.md) for the authoring setting and rendering limits.

Built `release/DocuDeck Player Setup 0.1.2.exe` and reran `npm run test:packaged` successfully against the packaged Windows application. The 19 library, SCORM, H5P, media, isolation and restart/resume checks passed, followed by the real-course screen/inline H5P layout checks. Startup was 563 ms in this run. Shared runtime tests separately covered both Arabic-language/English-digit and English-language/Arabic-digit configurations. No macOS or Linux runtime verification was performed.
