From 36bd32f172964a75ae4e95e753c7da0f73e7d103 Mon Sep 17 00:00:00 2001 From: Scott Idem Date: Wed, 13 May 2026 12:22:11 -0400 Subject: [PATCH] docs(launcher): document post delay override --- .../MODULE__AE_Events_PressMgmt_Launcher.md | 25 ++++++++++--------- ...__AE_Events_Launcher_Native_integration.md | 5 ++-- .../ae_launcher__default_launch_profiles.ts | 5 +++- 3 files changed, 20 insertions(+), 15 deletions(-) diff --git a/documentation/MODULE__AE_Events_PressMgmt_Launcher.md b/documentation/MODULE__AE_Events_PressMgmt_Launcher.md index d4b1d19f..c66bf3d2 100644 --- a/documentation/MODULE__AE_Events_PressMgmt_Launcher.md +++ b/documentation/MODULE__AE_Events_PressMgmt_Launcher.md @@ -325,19 +325,20 @@ immediately. See `PROJECT__AE_Events_Launcher_Native_integration.md` Section 8. These are the initial built-in defaults shipped with the Launcher. They are the Svelte-side fallbacks used when neither device config nor event config defines a profile for the file -extension. Each canonical profile can have multiple extension aliases. +extension. Each canonical profile can have multiple extension aliases. `post_delay_ms` is part +of the profile object, so a device-specific `launch_profiles` entry can override it later. -| Profile name | Extension aliases | Default app | Display mode | Notes | -|---|---|---|---|---| -| `powerpoint_mac_extend` | `pptx`, `ppt` | Microsoft PowerPoint for macOS | `extend` | Open in the presentation app and extend to an external display if one is present. | -| `keynote_mac_extend` | `key` | Keynote | `extend` | Keynote slideshow on the external display if available. | -| `libreoffice_mac_extend` | `odp` | LibreOffice for macOS | `extend` | LibreOffice Impress for OpenDocument presentations. | -| `acrobat_mac_mirror` | `pdf` | Adobe Acrobat for macOS | `mirror` | PDF handout / deck view uses mirrored display. | -| `vlc_mirror` | `mp4`, `mkv`, `mp3`, `m4v`, `m4a`, `webm`, `wav`, `aac`, `flac`, `mov`, `mpeg`, `avi`, `flv`, `ogg`, `ogv`, `wmv` | VLC for macOS | `mirror` | Media playback is mirrored so the room sees the same output as the operator. | -| `powerpoint_win_extend` | `pptxwin`, `pptwin` | PowerPoint for Windows (Parallels) | `extend` | Windows PowerPoint profile for Parallels-based rooms. | -| `libreoffice_win_extend` | `odpwin` | LibreOffice for Windows | `extend` | Windows LibreOffice profile for Parallels-based rooms. | -| `acrobat_win_mirror` | `pdfwin` | Adobe Acrobat for Windows (Parallels) | `mirror` | Windows PDF profile for mirrored display rooms. | -| `url_web` | `url` | Browser / Event File web presentation | `extend` | Web-based presentations are handled as Event File URLs rather than cached local files. | +| Profile name | Extension aliases | Default app | Display mode | Post delay | Notes | +|---|---|---|---|---|---| +| `powerpoint_mac_extend` | `pptx`, `ppt` | Microsoft PowerPoint for macOS | `extend` | `2000ms` | Open in the presentation app and extend to an external display if one is present. | +| `keynote_mac_extend` | `key` | Keynote | `extend` | `2000ms` | Keynote slideshow on the external display if available. | +| `libreoffice_mac_extend` | `odp` | LibreOffice for macOS | `extend` | `2000ms` | LibreOffice Impress for OpenDocument presentations. | +| `acrobat_mac_mirror` | `pdf` | Adobe Acrobat for macOS | `mirror` | `2000ms` | PDF handout / deck view uses mirrored display. | +| `vlc_mirror` | `mp4`, `mkv`, `mp3`, `m4v`, `m4a`, `webm`, `wav`, `aac`, `flac`, `mov`, `mpeg`, `avi`, `flv`, `ogg`, `ogv`, `wmv` | VLC for macOS | `mirror` | `2000ms` | Media playback is mirrored so the room sees the same output as the operator. | +| `powerpoint_win_extend` | `pptxwin`, `pptwin` | PowerPoint for Windows (Parallels) | `extend` | `3000ms` | Windows PowerPoint profile for Parallels-based rooms. | +| `libreoffice_win_extend` | `odpwin` | LibreOffice for Windows | `extend` | `3000ms` | Windows LibreOffice profile for Parallels-based rooms. | +| `acrobat_win_mirror` | `pdfwin` | Adobe Acrobat for Windows (Parallels) | `mirror` | `3000ms` | Windows PDF profile for mirrored display rooms. | +| `url_web` | `url` | Browser / Event File web presentation | `extend` | `n/a` | Web-based presentations are handled as Event File URLs rather than cached local files. | Versioning is handled automatically: when a presenter uploads an updated file, the new hash is cached separately and the old one remains intact. diff --git a/documentation/PROJECT__AE_Events_Launcher_Native_integration.md b/documentation/PROJECT__AE_Events_Launcher_Native_integration.md index 175849bc..331569a1 100644 --- a/documentation/PROJECT__AE_Events_Launcher_Native_integration.md +++ b/documentation/PROJECT__AE_Events_Launcher_Native_integration.md @@ -202,8 +202,9 @@ The native layer should not invent or guess a default launch path. The built-in defaults are organized as canonical profile names plus extension aliases. That lets multiple file types share one profile without repeating the same app/script details. -URL-based presentations remain a special pseudo-extension handled separately from the cache -open flow. +The profile object also carries `post_delay_ms`, so a device-specific `launch_profiles` +override can tune the delay without changing the bridge contract. URL-based presentations +remain a special pseudo-extension handled separately from the cache open flow. ### Native Template Formats diff --git a/src/lib/ae_events/ae_launcher__default_launch_profiles.ts b/src/lib/ae_events/ae_launcher__default_launch_profiles.ts index c0d3d4d5..565eab18 100644 --- a/src/lib/ae_events/ae_launcher__default_launch_profiles.ts +++ b/src/lib/ae_events/ae_launcher__default_launch_profiles.ts @@ -41,7 +41,10 @@ export interface LaunchProfile { * Plain string → AppleScript (macOS). "shell:" prefix → shell command. */ post_script?: string; - /** Milliseconds to wait after open_cmd before running post_script. Default: 2000 */ + /** + * Milliseconds to wait after open_cmd before running post_script. + * Default: 2000. Can be overridden per device via launch_profiles. + */ post_delay_ms?: number; // --- Reserved for future use — not yet implemented ---