| @@ -73,9 +73,9 @@ | ||
| 73 | 73 | do_action( 'openstation_chromeless_styles' ); |
| 74 | 74 | return; |
| 75 | 75 | } |
| 76 | 76 | |
| 77 | - if ( ! openstation_is_enabled() || openstation_is_classic_request() ) { | |
| 77 | + if ( ! openstation_is_shell_request() ) { | |
| 78 | 78 | return; |
| 79 | 79 | } |
| 80 | 80 | |
| 81 | 81 | // CSS. Only the sheets that paint surfaces present at boot — the |
| @@ -87,14 +87,18 @@ | ||
| 87 | 87 | wp_enqueue_style( 'openstation' ); |
| 88 | 88 | wp_enqueue_style( 'os-windows' ); |
| 89 | 89 | wp_enqueue_style( 'os-window-overview' ); |
| 90 | 90 | wp_enqueue_style( 'os-dock' ); |
| 91 | + wp_enqueue_style( 'os-dock-taskbar' ); | |
| 91 | 92 | wp_enqueue_style( 'os-dock-peek' ); |
| 92 | - wp_enqueue_style( 'os-notch' ); | |
| 93 | + wp_enqueue_style( 'os-workspaces' ); | |
| 93 | 94 | wp_enqueue_style( 'os-shortcuts' ); |
| 94 | 95 | wp_enqueue_style( 'os-openstation-layout' ); |
| 95 | 96 | wp_enqueue_style( 'os-files' ); |
| 96 | 97 | wp_enqueue_style( 'os-notes' ); |
| 98 | + // Unconditional like the layout sheet: a live crossing into the | |
| 99 | + // phone band must not find the phone layer unstyled. | |
| 100 | + wp_enqueue_style( 'os-mobile' ); | |
| 97 | 101 | |
| 98 | 102 | // Solo mode — a single window freed into a native OS window by the |
| 99 | 103 | // desktop host. Same shell, everything but that one window hidden. |
| 100 | 104 | $solo_window = openstation_solo_window_id(); |
| @@ -199,9 +203,9 @@ | ||
| 199 | 203 | ); |
| 200 | 204 | } |
| 201 | 205 | |
| 202 | 206 | // Pass configuration to JavaScript. |
| 203 | - global $title, $pagenow, $parent_file, $menu; | |
| 207 | + global $title, $parent_file, $menu; | |
| 204 | 208 | |
| 205 | 209 | $menu_icon = 'dashicons-admin-generic'; |
| 206 | 210 | if ( ! empty( $parent_file ) && ! empty( $menu ) ) { |
| 207 | 211 | foreach ( $menu as $item ) { |
| @@ -217,13 +221,32 @@ | ||
| 217 | 221 | // plugin-contributed top-level routes. `openstation_dock_placement` |
| 218 | 222 | // is the per-item filter escape hatch for hiding. Shared with the |
| 219 | 223 | // REST menu endpoint so live refreshes (post plugin-activation) |
| 220 | 224 | // produce the same ordering as the boot payload. |
| 221 | - $menu_payload = openstation_build_menu_payload(); | |
| 222 | - $dock_items = $menu_payload['dockItems']; | |
| 223 | - $native_windows = isset( $menu_payload['nativeWindows'] ) | |
| 225 | + $menu_payload = openstation_build_menu_payload(); | |
| 226 | + $dock_items = $menu_payload['dockItems']; | |
| 227 | + $native_windows = isset( $menu_payload['nativeWindows'] ) | |
| 224 | 228 | ? $menu_payload['nativeWindows'] |
| 225 | 229 | : array(); |
| 230 | + | |
| 231 | + // The BOOT page prints every registry window's template as a real | |
| 232 | + // `<template>` tag (`openstation_render_native_window_templates()`, | |
| 233 | + // admin_footer @ 20 — before footer scripts, so the tags are in | |
| 234 | + // the DOM before the shell boots and `ensureTemplate()` adopts | |
| 235 | + // them by id). The payload's `templateHtml` copy exists for the | |
| 236 | + // MID-SESSION path — a bridge or probe payload delivering a | |
| 237 | + // window whose plugin activated after the page rendered — so on | |
| 238 | + // the boot config it is ~27 KB of the same markup twice. Strip it | |
| 239 | + // here, and only here: the bridge and probe payloads keep theirs. | |
| 240 | + foreach ( $native_windows as &$native_window_row ) { | |
| 241 | + if ( is_array( $native_window_row ) ) { | |
| 242 | + $native_window_row['templateHtml'] = ''; | |
| 243 | + } | |
| 244 | + } | |
| 245 | + unset( $native_window_row ); | |
| 246 | + $native_window_script_data = isset( $menu_payload['nativeWindowScriptData'] ) | |
| 247 | + ? $menu_payload['nativeWindowScriptData'] | |
| 248 | + : array(); | |
| 226 | 249 | $server_widgets = isset( $menu_payload['serverWidgets'] ) |
| 227 | 250 | ? $menu_payload['serverWidgets'] |
| 228 | 251 | : array(); |
| 229 | 252 | $server_wallpapers = isset( $menu_payload['serverWallpapers'] ) |
| @@ -290,9 +313,29 @@ | ||
| 290 | 313 | // dedupes on an `activeId` that was never set. |
| 291 | 314 | $server_desktop_themes = isset( $menu_payload['serverDesktopThemes'] ) |
| 292 | 315 | ? $menu_payload['serverDesktopThemes'] |
| 293 | 316 | : array(); |
| 294 | - $desktop_icons = isset( $menu_payload['desktopIcons'] ) | |
| 317 | + | |
| 318 | + // Slim the theme library for BOOT: `cssText` and `tokens` are | |
| 319 | + // each ~20 KB per theme, and neither is read at boot — the ACTIVE | |
| 320 | + // theme's stylesheet is server-delivered (see | |
| 321 | + // `openstation_enqueue_desktop_theme_style()`, whose stamp | |
| 322 | + // `bootAlreadyApplied()` detects), and an inactive theme's CSS | |
| 323 | + // only matters at the moment the user picks it in the Preferences | |
| 324 | + // picker — which fetches the full entries from | |
| 325 | + // `GET desktop-mode/v1/desktop-themes` (`ensureFullDesktopThemes()` | |
| 326 | + // client-side). `cssDeferred` marks the gap so the shell can tell | |
| 327 | + // a slimmed entry from a theme that genuinely ships no CSS. | |
| 328 | + // Bridge and probe payloads keep full entries. | |
| 329 | + foreach ( $server_desktop_themes as &$desktop_theme_row ) { | |
| 330 | + if ( is_array( $desktop_theme_row ) ) { | |
| 331 | + $desktop_theme_row['cssText'] = ''; | |
| 332 | + $desktop_theme_row['tokens'] = new stdClass(); | |
| 333 | + $desktop_theme_row['cssDeferred'] = true; | |
| 334 | + } | |
| 335 | + } | |
| 336 | + unset( $desktop_theme_row ); | |
| 337 | + $desktop_icons = isset( $menu_payload['desktopIcons'] ) | |
| 295 | 338 | ? $menu_payload['desktopIcons'] |
| 296 | 339 | : array(); |
| 297 | 340 | |
| 298 | 341 | // Files-on-the-Desktop payload (Phase 0+1). Plugin-registered |
| @@ -303,8 +346,16 @@ | ||
| 303 | 346 | : array(); |
| 304 | 347 | $server_file_openers = function_exists( 'openstation_build_file_openers_payload' ) |
| 305 | 348 | ? openstation_build_file_openers_payload() |
| 306 | 349 | : array(); |
| 350 | + // Entries in the menu payload carry dependency handles; their | |
| 351 | + // payloads ride once in `scriptDepPayloads` (GH#892). The file | |
| 352 | + // lists stay whole: no sync module reads them on the client, and | |
| 353 | + // compacting them here was the only write to the map after the | |
| 354 | + // menu payload froze its own, so a refresh could not match it. | |
| 355 | + $script_dep_payloads = isset( $menu_payload['scriptDepPayloads'] ) | |
| 356 | + ? (array) $menu_payload['scriptDepPayloads'] | |
| 357 | + : array(); | |
| 307 | 358 | $user_file_associations = function_exists( 'openstation_get_user_file_associations' ) |
| 308 | 359 | ? openstation_get_user_file_associations( get_current_user_id() ) |
| 309 | 360 | : array(); |
| 310 | 361 | $server_wallpaper_menu_items = function_exists( 'openstation_build_wallpaper_menu_items' ) |
| @@ -393,18 +444,33 @@ | ||
| 393 | 444 | OPENSTATION_URL . 'assets/js/' . $base . $suffix . '.js?ver=' . $ver |
| 394 | 445 | ); |
| 395 | 446 | }; |
| 396 | 447 | |
| 397 | - // Build the current page URL from $pagenow + $_GET. Strip the portal | |
| 398 | - // markers so the derived window ID matches what the dock would produce | |
| 399 | - // for the same page — otherwise auto-opening the entry window and | |
| 400 | - // clicking the same dock icon would create a duplicate. | |
| 401 | - $current_query = $_GET; // phpcs:ignore WordPress.Security.NonceVerification.Recommended | |
| 402 | - unset( $current_query[ OPENSTATION_PORTAL_FLAG ], $current_query[ OPENSTATION_PORTAL_INTENT_FLAG ] ); | |
| 403 | - $current_page = admin_url( $pagenow ) . ( ! empty( $current_query ) ? '?' . http_build_query( $current_query ) : '' ); | |
| 448 | + // The page the shell opens first. On the shell screen it is the | |
| 449 | + // validated `target` query arg (else the session's focused window, | |
| 450 | + // the default window, the Dashboard); on a solo boot it is the | |
| 451 | + // request's own URL. Either way the frozen portal flags are gone | |
| 452 | + // from it, so the derived window id matches what the dock would | |
| 453 | + // produce for the same page — otherwise auto-opening the entry | |
| 454 | + // window and clicking the same dock icon would create a duplicate. | |
| 455 | + $boot_target = openstation_shell_boot_target(); | |
| 456 | + $current_page = $boot_target['url']; | |
| 457 | + $from_portal = $boot_target['fromPortal']; | |
| 458 | + $from_portal_intent = $boot_target['fromPortalIntent']; | |
| 404 | 459 | |
| 405 | - $from_portal = ! empty( $_GET[ OPENSTATION_PORTAL_FLAG ] ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended | |
| 406 | - $from_portal_intent = ! empty( $_GET[ OPENSTATION_PORTAL_INTENT_FLAG ] ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended | |
| 460 | + // On the shell screen `$title` and `$parent_file` describe the | |
| 461 | + // screen ("OpenStation", no menu), not the page about to open. The | |
| 462 | + // dock entry for that page is the identity the entry window folds | |
| 463 | + // into, so its title and icon are the right first paint; the iframe | |
| 464 | + // reports its own title once it lands either way. | |
| 465 | + $current_title = wp_strip_all_tags( (string) $title ); | |
| 466 | + if ( openstation_is_shell_screen_request() ) { | |
| 467 | + $boot_meta = openstation_shell_boot_target_meta( $current_page, $dock_items ); | |
| 468 | + $current_title = wp_strip_all_tags( $boot_meta['title'] ); | |
| 469 | + if ( '' !== $boot_meta['icon'] ) { | |
| 470 | + $menu_icon = $boot_meta['icon']; | |
| 471 | + } | |
| 472 | + } | |
| 407 | 473 | |
| 408 | 474 | /** |
| 409 | 475 | * Filters the desktop shell configuration passed to JavaScript. |
| 410 | 476 | * |
| @@ -444,9 +510,14 @@ | ||
| 444 | 510 | * @type bool $fromPortal Whether the shell was reached via the portal. |
| 445 | 511 | * @type bool $fromPortalIntent Whether the portal redirect resolved from an explicit `?target=…` (user navigation intent) rather than the session's focused window or the default-window fallback. Distinguishes a bare `/openstation/` visit from a portal-redirected admin-bar click so the shell can honour the URL the user actually asked for. |
| 446 | 512 | * @type array $seenIntros Slugs of one-time announcements the user has dismissed (e.g. `['openstation-rebrand']`). |
| 447 | 513 | * @type string $seenIntrosUrl REST endpoint for the seen-intros surface — POST `/seen` to mark, DELETE the base to reset. |
| 514 | + * @type bool $shellTour Whether this site offers the first-boot shell tour (`openstation_show_shell_tour`). Whether this user already had it is `seenIntros` containing `shell-tour`. | |
| 515 | + * @type string $shellTourBundleUrl URL of the lazy shell-tour bundle, injected on first use. | |
| 516 | + * @type array $firstRun `{ installedAt, firstEnabledAt, enabledAt }`, epoch seconds, 0 when unknown — the first-run stamps, read-only. | |
| 448 | 517 | * @type bool $rebrandNotice Whether to offer this user the one-off announcement explaining the rename from Desktop Mode to OpenStation. True only when migration 5 flagged this user as a Desktop Mode user from before the rename AND they haven't dismissed the `openstation-rebrand` intro. Only ever present in the shell config, so the announcement never reaches the classic admin. |
| 518 | + * @type array|null $usageFeedback What the one-time usage feedback prompt needs (`restUrl`), or `null` when this user is not owed it: the feature is off, they have had OpenStation on for fewer than seven days by the `openstation_enabled_at` stamp, or they already answered or dismissed the `usage-feedback` intro. Carries no user data. | |
| 519 | + * @type string $usageFeedbackBundleUrl URL of the lazy `usage-feedback` bundle, the form the prompt opens. | |
| 449 | 520 | * } |
| 450 | 521 | */ |
| 451 | 522 | $config = apply_filters( |
| 452 | 523 | 'openstation_shell_config', |
| @@ -451,11 +522,15 @@ | ||
| 451 | 522 | $config = apply_filters( |
| 452 | 523 | 'openstation_shell_config', |
| 453 | 524 | array( |
| 454 | 525 | 'currentPage' => esc_url( $current_page ), |
| 455 | - 'currentTitle' => wp_strip_all_tags( $title ), | |
| 526 | + 'currentTitle' => $current_title, | |
| 456 | 527 | 'currentIcon' => sanitize_html_class( $menu_icon ), |
| 457 | - 'adminUrl' => esc_url( admin_url() ), | |
| 528 | + // `self_admin_url()`: the base a window id is derived from, | |
| 529 | + // and the URL the shell leaves for on exit. Both want the | |
| 530 | + // admin the screen is in, which is the network one when the | |
| 531 | + // network shell screen is what rendered. | |
| 532 | + 'adminUrl' => esc_url( self_admin_url() ), | |
| 458 | 533 | 'homeUrl' => esc_url( home_url( '/' ) ), |
| 459 | 534 | // Decoded: the shell assigns this to `window.location`, |
| 460 | 535 | // where `&` would make `_wpnonce` arrive as |
| 461 | 536 | // `amp;_wpnonce` and fail the nonce check. |
| @@ -468,8 +543,12 @@ | ||
| 468 | 543 | // signature from this so the first off-allowlist menu change |
| 469 | 544 | // (vs. this boot state) is caught without a wasted probe. GH#325. |
| 470 | 545 | 'menuSig' => isset( $menu_payload['menuSig'] ) ? (string) $menu_payload['menuSig'] : '', |
| 471 | 546 | 'nativeWindows' => $native_windows, |
| 547 | + // Handle-keyed script data the entries above reference — | |
| 548 | + // one copy per bundle, not one per window. See | |
| 549 | + // `openstation_collect_native_windows_payload()`. | |
| 550 | + 'nativeWindowScriptData' => $native_window_script_data, | |
| 472 | 551 | 'serverWidgets' => $server_widgets, |
| 473 | 552 | 'serverWallpapers' => $server_wallpapers, |
| 474 | 553 | 'serverCommandScripts' => $server_command_scripts, |
| 475 | 554 | 'serverCommands' => $server_commands, |
| @@ -495,8 +574,11 @@ | ||
| 495 | 574 | 'serverDesktopThemes' => $server_desktop_themes, |
| 496 | 575 | 'desktopIcons' => $desktop_icons, |
| 497 | 576 | 'serverFileTypes' => $server_file_types, |
| 498 | 577 | 'serverFileOpeners' => $server_file_openers, |
| 578 | + // Handle => dependency payload for every `scriptDeps` list in | |
| 579 | + // this config; see `openstation_compact_script_deps()`. | |
| 580 | + 'scriptDepPayloads' => (object) $script_dep_payloads, | |
| 499 | 581 | 'userFileAssociations' => $user_file_associations, |
| 500 | 582 | 'filesUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/files' ) ), |
| 501 | 583 | // Pinned-notes REST base (`includes/notes/rest.php`). The |
| 502 | 584 | // notes layer boots only when this is present. |
| @@ -512,9 +594,17 @@ | ||
| 512 | 594 | 'coreNotices' => openstation_get_core_notices(), |
| 513 | 595 | 'pluginNotices' => openstation_get_plugin_notices(), |
| 514 | 596 | 'defaultWallpaper' => openstation_get_default_wallpaper(), |
| 515 | 597 | 'session' => openstation_get_session( get_current_user_id() ), |
| 516 | - 'sessionUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/session' ) ), | |
| 598 | + // The session route runs in the main site's blog context | |
| 599 | + // whichever desktop posts to it, so the network screen's | |
| 600 | + // URL says which session it is addressing — see | |
| 601 | + // `openstation_rest_session_network()`. | |
| 602 | + 'sessionUrl' => esc_url_raw( | |
| 603 | + is_network_admin() | |
| 604 | + ? add_query_arg( 'network', '1', rest_url( 'desktop-mode/v1/session' ) ) | |
| 605 | + : rest_url( 'desktop-mode/v1/session' ) | |
| 606 | + ), | |
| 517 | 607 | 'restUrl' => esc_url_raw( rest_url() ), |
| 518 | 608 | 'mediaUrl' => esc_url_raw( rest_url( 'wp/v2/media' ) ), |
| 519 | 609 | 'dropConfig' => $drop_config, |
| 520 | 610 | 'defaultWindowUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/default-window' ) ), |
| @@ -537,20 +627,29 @@ | ||
| 537 | 627 | // stub `<script>`-injects this URL the first time the user |
| 538 | 628 | // opens the assistant. Picking `.js` vs `.min.js` here keeps |
| 539 | 629 | // the SCRIPT_DEBUG gate server-side, matching iframeBridgeUrl. |
| 540 | 630 | 'aiAssistantBundleUrl' => $lazy_bundle_url( 'ai-assistant' ), |
| 541 | - // URL of the OS Settings panel lazy bundle. Injected by | |
| 542 | - // the main bundle's `OsSettings.renderPanel()` stub on | |
| 543 | - // the user's first Settings open. Holds every section | |
| 544 | - // renderer + the `<os-*>` components only the panel | |
| 545 | - // uses, so nothing about Settings ships in | |
| 546 | - // `desktop.min.js` for users who never open it. | |
| 547 | - 'osSettingsPanelBundleUrl' => $lazy_bundle_url( 'os-settings-panel' ), | |
| 548 | 631 | // URL of the shell-overlays lazy bundle. Pre-loaded by |
| 549 | 632 | // the main bundle after first paint so action-triggered |
| 550 | 633 | // overlays (toast, confirm dialog, context menus) feel |
| 551 | 634 | // instant the first time they fire. |
| 552 | 635 | 'shellOverlaysBundleUrl' => $lazy_bundle_url( 'shell-overlays' ), |
| 636 | + // The shell-bundle diet: features whose right moment is a | |
| 637 | + // user gesture (or a presence signal) ride their own | |
| 638 | + // bundles instead of the boot-critical `desktop[.min].js`. | |
| 639 | + // Each sentinel in the shell loads its bundle at that | |
| 640 | + // moment — see the entry file each bundle names. | |
| 641 | + 'fileDropBundleUrl' => $lazy_bundle_url( 'file-drop' ), | |
| 642 | + 'filesOverlaysBundleUrl' => $lazy_bundle_url( 'files-overlays' ), | |
| 643 | + 'notesBundleUrl' => $lazy_bundle_url( 'notes' ), | |
| 644 | + 'dockConstellationBundleUrl' => $lazy_bundle_url( 'dock-constellation' ), | |
| 645 | + 'windowLinkVisualsBundleUrl' => $lazy_bundle_url( 'window-link-visuals' ), | |
| 646 | + // Presence hint for the notes sentinel: a desktop with no | |
| 647 | + // notes skips the notes bundle AND the boot-time list | |
| 648 | + // request. Two id-only existence probes at most. | |
| 649 | + 'hasNotes' => function_exists( 'openstation_notes_user_has_any' ) | |
| 650 | + ? openstation_notes_user_has_any() | |
| 651 | + : false, | |
| 553 | 652 | // URL of the full `<os-*>` component kit. The shell |
| 554 | 653 | // never loads this — its own bundles import the |
| 555 | 654 | // components they render. It exists for |
| 556 | 655 | // `wp.os.loadComponents()`, i.e. for plugin code that |
| @@ -584,12 +683,29 @@ | ||
| 584 | 683 | // / `openNew()` call (both async); pre-loaded |
| 585 | 684 | // by the shell after first paint when no session is being |
| 586 | 685 | // restored and no `openCurrentPage` will fire. |
| 587 | 686 | 'windowSystemBundleUrl' => $lazy_bundle_url( 'window-system' ), |
| 687 | + // URL of the lazy phone-layer bundle. Injected by the main | |
| 688 | + // bundle only when the mode resolves to `mobile`, so a | |
| 689 | + // desktop never fetches it. `mode` carries the preference | |
| 690 | + // and breakpoints the first-paint head stamp already used, | |
| 691 | + // plus the server's default tab-bar pins — see | |
| 692 | + // `includes/mobile.php`. | |
| 693 | + 'mobileBundleUrl' => $lazy_bundle_url( 'mobile' ), | |
| 694 | + 'mode' => openstation_mode_config( get_current_user_id() ), | |
| 588 | 695 | // URL of the item-visibility-menu lazy bundle — the |
| 589 | 696 | // right-click "hide from dock / desktop" menu. Injected by |
| 590 | 697 | // the main bundle's loader shim on the first right-click. |
| 591 | 698 | 'itemVisibilityMenuBundleUrl' => $lazy_bundle_url( 'item-visibility-menu' ), |
| 699 | + // URL of the workspace-wizard lazy bundle — the modal | |
| 700 | + // behind "Edit this workspace…". Injected by the main | |
| 701 | + // bundle's loader shim on first open. | |
| 702 | + 'workspaceWizardBundleUrl' => $lazy_bundle_url( 'workspace-wizard' ), | |
| 703 | + // Server-side view of the workspace templates, so a plugin | |
| 704 | + // can add or drop one from PHP. The client merges these | |
| 705 | + // with its own built-ins by id — see | |
| 706 | + // `src/workspaces/server-sync.ts`. | |
| 707 | + 'workspacePresets' => openstation_workspace_presets(), | |
| 592 | 708 | // URL of the release-card lazy bundle — the vinyl core- |
| 593 | 709 | // update announcement. Injected by `maybeShowUpdate()` only |
| 594 | 710 | // when a core update is actually pending. |
| 595 | 711 | 'releaseCardBundleUrl' => $lazy_bundle_url( 'release-card' ), |
| @@ -606,8 +722,26 @@ | ||
| 606 | 722 | // announcement yet. Same value that gated `os-announce` |
| 607 | 723 | // above; the dialog cannot paint without that stylesheet, so |
| 608 | 724 | // the two must not diverge. |
| 609 | 725 | 'rebrandNotice' => $show_rebrand_notice, |
| 726 | + // The first-boot shell tour: whether this site offers it | |
| 727 | + // (the `openstation_show_shell_tour` filter), and the lazy | |
| 728 | + // bundle that runs it. Whether THIS user already had it is | |
| 729 | + // `seenIntros` containing `shell-tour`; the shell reads that | |
| 730 | + // itself so a reset can replay the tour without a new boot. | |
| 731 | + 'shellTour' => openstation_should_offer_shell_tour( get_current_user_id() ), | |
| 732 | + 'shellTourBundleUrl' => $lazy_bundle_url( 'shell-tour' ), | |
| 733 | + // The first-run stamps, read-only, epoch seconds (0 when | |
| 734 | + // unknown): when the plugin was installed, when anyone first | |
| 735 | + // enabled it, and when this user did. See | |
| 736 | + // `includes/first-run/stamps.php`. | |
| 737 | + 'firstRun' => openstation_first_run_config( get_current_user_id() ), | |
| 738 | + // Null for everyone but a user who has had OpenStation on | |
| 739 | + // long enough and has not answered yet; the gate lives in | |
| 740 | + // `includes/feedback/usage.php`. The form is a lazy bundle | |
| 741 | + // fetched only when the user says yes to the prompt. | |
| 742 | + 'usageFeedback' => function_exists( 'openstation_usage_feedback_config' ) ? openstation_usage_feedback_config() : null, | |
| 743 | + 'usageFeedbackBundleUrl' => $lazy_bundle_url( 'usage-feedback' ), | |
| 610 | 744 | 'aiSearchUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/ai/search' ) ), |
| 611 | 745 | // AI assistant availability + per-user toggle. Drives whether the |
| 612 | 746 | // Cmd+K palette and admin-bar icon appear, and the setup placeholder. |
| 613 | 747 | 'aiAssistant' => function_exists( 'openstation_ai_assistant_config' ) |
| @@ -616,46 +750,65 @@ | ||
| 616 | 750 | // Lets the Features tab re-check provider availability without a |
| 617 | 751 | // reload after a connector is configured in Settings → Connectors. |
| 618 | 752 | 'aiStatusUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/ai/status' ) ), |
| 619 | 753 | 'extendedOptions' => current_user_can( 'manage_options' ) ? openstation_get_extended_options() : null, |
| 754 | + // Agents offered as "Send to <agent>" on desktop and folder | |
| 755 | + // tiles. See `src/desktop-files/agent-menu-items.ts`. | |
| 756 | + 'agentsSendTo' => function_exists( 'openstation_agents_send_to_targets' ) ? openstation_agents_send_to_targets() : array(), | |
| 620 | 757 | 'extendedOptionsUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/extended-options' ) ), |
| 621 | 758 | // Site-wide games kill switch (Extended options). Exposed to |
| 622 | 759 | // every user — the shell skips the challenges Heartbeat |
| 623 | 760 | // channel when the framework is off. |
| 624 | 761 | 'gamesEnabled' => openstation_games_enabled(), |
| 625 | - // Comments-window AI moderation toggle — surfaced at the | |
| 626 | - // shell level so the OS Settings → Features tab can render | |
| 627 | - // the toggle without depending on the Comments window | |
| 628 | - // being registered for this user. URL is the same | |
| 629 | - // endpoint the comments-window config exposes; state is | |
| 630 | - // `null` for non-admins (the UI hides the row entirely). | |
| 631 | - 'commentsAiUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/comments/ai-settings' ) ), | |
| 632 | - // Non-null only for admins on a site where the Core AI stack is | |
| 633 | - // present. Comment scoring routes through the AI Client (WP 7.0+), | |
| 634 | - // so on older WordPress the whole row is hidden — same as the | |
| 635 | - // assistant toggle — rather than shown disabled pointing at a | |
| 636 | - // Settings → Connectors screen that doesn't exist there. | |
| 637 | - 'commentsAi' => ( | |
| 638 | - current_user_can( 'manage_options' ) | |
| 639 | - && function_exists( 'openstation_ai_is_available' ) | |
| 640 | - && openstation_ai_is_available() | |
| 641 | - ) | |
| 642 | - ? array( | |
| 643 | - 'enabled' => function_exists( 'openstation_comments_ai_is_enabled' ) | |
| 644 | - ? openstation_comments_ai_is_enabled() | |
| 645 | - : false, | |
| 646 | - 'providerConfigured' => function_exists( 'openstation_comments_ai_provider_configured' ) | |
| 647 | - ? openstation_comments_ai_provider_configured() | |
| 648 | - : false, | |
| 649 | - ) | |
| 650 | - : null, | |
| 651 | 762 | 'currentUserIsAdmin' => current_user_can( 'manage_options' ), |
| 763 | + // Null on single-site installs; its `networkAdmin` null | |
| 764 | + // without `manage_network`, which is what keeps the dock | |
| 765 | + // tile from registering. | |
| 766 | + 'multisite' => openstation_multisite_payload(), | |
| 652 | 767 | 'portalUrl' => esc_url( openstation_portal_url() ), |
| 653 | 768 | 'fromPortal' => $from_portal, |
| 654 | 769 | 'fromPortalIntent' => $from_portal_intent, |
| 770 | + // One-shot like the boot target: a switch from another | |
| 771 | + // site's overview lands in this one's. | |
| 772 | + 'landInOverview' => openstation_shell_lands_in_overview(), | |
| 773 | + 'arrivalDirection' => openstation_shell_arrival_direction(), | |
| 774 | + 'hopLinkOffer' => function_exists( 'openstation_network_link_offer' ) ? openstation_network_link_offer() : null, | |
| 655 | 775 | 'pwa' => array( |
| 656 | 776 | 'manifestUrl' => esc_url_raw( openstation_pwa_manifest_url() ), |
| 657 | 777 | 'swUrl' => esc_url_raw( openstation_pwa_sw_url() ), |
| 778 | + // Extensionless retry target for hosts whose nginx 404s | |
| 779 | + // virtual .js paths before WordPress runs (WordPress.com). | |
| 780 | + 'swFallbackUrl' => esc_url_raw( openstation_pwa_sw_fallback_url() ), | |
| 781 | + // The site's home path — the scope the registration | |
| 782 | + // asks for, so a subdirectory network's sites each get | |
| 783 | + // their own worker instead of fighting over the root. | |
| 784 | + 'swScope' => openstation_pwa_sw_scope(), | |
| 785 | + // The worker's per-user flags, computed HERE rather than | |
| 786 | + // baked into the served `sw.js`. | |
| 787 | + // | |
| 788 | + // A service worker is origin-wide but these are per-user | |
| 789 | + // preferences, so putting them in the script bytes made | |
| 790 | + // the body differ between an anonymous and a logged-in | |
| 791 | + // request — and any in-scope logged-out navigation then | |
| 792 | + // installed a "new" worker, which at the time reloaded | |
| 793 | + // the shell. The bytes are identical for everyone now; | |
| 794 | + // the shell posts these to the worker at boot. | |
| 795 | + // | |
| 796 | + // Computed server-side, not read from the settings | |
| 797 | + // snapshot client-side, because | |
| 798 | + // `openstation_pwa_admin_asset_cache_enabled()` applies | |
| 799 | + // the `openstation_pwa_admin_asset_cache` filter — an | |
| 800 | + // operator's site-wide veto has to keep working. | |
| 801 | + 'swConfig' => array( | |
| 802 | + 'adminAssetCache' => (bool) openstation_pwa_admin_asset_cache_enabled(), | |
| 803 | + 'windowPrewarm' => ! empty( openstation_get_os_settings( get_current_user_id() )['windowPrewarmEnabled'] ), | |
| 804 | + ), | |
| 805 | + // The build this shell document belongs to. When a new | |
| 806 | + // worker takes over mid-session the shell asks it for | |
| 807 | + // the stamp it was served with and compares; only a | |
| 808 | + // difference — the shell's own files changed on the | |
| 809 | + // server — offers the user a reload. Never automatic. | |
| 810 | + 'shellBuild' => openstation_shell_build_stamp(), | |
| 658 | 811 | 'stateUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/pwa-state' ) ), |
| 659 | 812 | 'state' => openstation_pwa_get_user_state( get_current_user_id() ), |
| 660 | 813 | // Mirrors the manifest's `name` field — used by the |
| 661 | 814 | // install pill so the button reads "Install <site>" |
| @@ -684,13 +837,39 @@ | ||
| 684 | 837 | // the first time its surface opens, via |
| 685 | 838 | // `ensureDeferredStyle()` in `src/deferred-styles.ts`. |
| 686 | 839 | // Same resolved shape a native window's `styleUrl` / |
| 687 | 840 | // `styleInline` travels in. |
| 841 | + // Which of the `deferredStyles` entries a game needs. | |
| 842 | + // `launchGame()` injects these before the window paints. | |
| 843 | + 'gameStyleHandles' => function_exists( 'openstation_games_style_handles' ) | |
| 844 | + ? openstation_games_style_handles() | |
| 845 | + : array(), | |
| 688 | 846 | 'deferredStyles' => openstation_build_deferred_styles( |
| 689 | - array( | |
| 690 | - 'os-settings', | |
| 691 | - 'desktop-mode-ai-assistant', | |
| 692 | - 'desktop-mode-bug-report', | |
| 847 | + array_merge( | |
| 848 | + array( | |
| 849 | + 'desktop-mode-ai-assistant', | |
| 850 | + 'desktop-mode-bug-report', | |
| 851 | + // The explorer's shared sheet. It rides the WP | |
| 852 | + // Explorer APP as a companion style, but the | |
| 853 | + // desktop FOLDER window paints its preview pane | |
| 854 | + // with the same `os-my-wordpress__*` classes and | |
| 855 | + // — being a native window opened straight from | |
| 856 | + // JS — carries no companion styles of its own. | |
| 857 | + // Without this, the pane rendered unstyled until | |
| 858 | + // the explorer had been opened once in the | |
| 859 | + // session. | |
| 860 | + 'desktop-mode-my-wordpress', | |
| 861 | + ), | |
| 862 | + // The Games sheets. They also ride the hub window as | |
| 863 | + // companion styles, but a game is reachable without | |
| 864 | + // the hub — the challenge toast, solo mode, and | |
| 865 | + // `wp.os.games.launch()` all land in `launchGame()` | |
| 866 | + // with no hub window in the tab. Listing them here | |
| 867 | + // costs a URL each in the boot config and no CSS | |
| 868 | + // until `launchGame()` asks. | |
| 869 | + function_exists( 'openstation_games_style_handles' ) | |
| 870 | + ? openstation_games_style_handles() | |
| 871 | + : array() | |
| 693 | 872 | ) |
| 694 | 873 | ), |
| 695 | 874 | ) |
| 696 | 875 | ); |
| @@ -717,19 +896,26 @@ | ||
| 717 | 896 | * deferred manifest (`openstation_build_command_palette_assets_payload()`) |
| 718 | 897 | * capture the chain instead, and the shell loads it on the first |
| 719 | 898 | * palette invocation. |
| 720 | 899 | * |
| 721 | - * Deliberately scoped: chromeless iframes and classic-mode requests | |
| 722 | - * keep Core's default — inside an iframe the runtime powers the | |
| 723 | - * command harvest the bridge streams to the parent, and a classic | |
| 724 | - * page is Core's own UI where Core's palette is the right one. | |
| 900 | + * Deliberately scoped: classic-mode requests keep Core's default, | |
| 901 | + * because a classic page is Core's own UI where Core's palette is the | |
| 902 | + * right one. | |
| 725 | 903 | * |
| 904 | + * Windows are handled separately by | |
| 905 | + * {@see openstation_chromeless_should_trim_command_palette()} in | |
| 906 | + * `includes/render/chromeless-trim.php` — same idea, but it has to | |
| 907 | + * drop the whole palette *family* rather than just unhook Core's | |
| 908 | + * callback, and it exempts block-editor screens. Unhooking alone is | |
| 909 | + * not enough there: a third-party palette extension that declares | |
| 910 | + * `wp-commands` keeps the entire chain queued as its dependency. | |
| 911 | + * | |
| 726 | 912 | * Priority 0, ahead of Core's default 10, so the removal lands |
| 727 | 913 | * before the callback fires. On WP 6.9 (function exists, no default |
| 728 | 914 | * hook) the `remove_action()` is a harmless no-op. |
| 729 | 915 | */ |
| 730 | 916 | function openstation_defer_core_command_palette() { |
| 731 | - if ( ! openstation_is_enabled() || openstation_is_chromeless_request() || openstation_is_classic_request() ) { | |
| 917 | + if ( ! openstation_is_shell_request() ) { | |
| 732 | 918 | return; |
| 733 | 919 | } |
| 734 | 920 | remove_action( 'admin_enqueue_scripts', 'wp_enqueue_command_palette_assets' ); |
| 735 | 921 | } |
| @@ -779,14 +965,9 @@ | ||
| 779 | 965 | * supply absolute URLs through the filter; in that case the consumer |
| 780 | 966 | * is responsible for the `crossorigin` semantics. |
| 781 | 967 | */ |
| 782 | 968 | function openstation_print_preload_hints() { |
| 783 | - if ( | |
| 784 | - ! is_admin() | |
| 785 | - || ! openstation_is_enabled() | |
| 786 | - || openstation_is_chromeless_request() | |
| 787 | - || openstation_is_classic_request() | |
| 788 | - ) { | |
| 969 | + if ( ! openstation_is_shell_request() ) { | |
| 789 | 970 | return; |
| 790 | 971 | } |
| 791 | 972 | |
| 792 | 973 | $suffix = openstation_asset_suffix(); |
| @@ -829,8 +1010,21 @@ | ||
| 829 | 1010 | 'rel' => 'prefetch', |
| 830 | 1011 | ), |
| 831 | 1012 | ); |
| 832 | 1013 | |
| 1014 | + // The phone layer is needed at boot on a phone and never on a | |
| 1015 | + // desktop; the server cannot see the viewport, so the user agent | |
| 1016 | + // decides whether the hint is worth its bytes. A wrong guess costs | |
| 1017 | + // one low-priority fetch, never a wrong layout — the stamp and the | |
| 1018 | + // bundle loader read the real viewport. | |
| 1019 | + if ( openstation_mode_hint_is_mobile( get_current_user_id() ) ) { | |
| 1020 | + $hints[] = array( | |
| 1021 | + 'href' => $build_url( 'assets/js/mobile' . $suffix . '.js' ), | |
| 1022 | + 'as' => 'script', | |
| 1023 | + 'rel' => 'prefetch', | |
| 1024 | + ); | |
| 1025 | + } | |
| 1026 | + | |
| 833 | 1027 | /** |
| 834 | 1028 | * Filters the list of resource preload hints emitted in `<head>`. |
| 835 | 1029 | * |
| 836 | 1030 | * Each entry is a `{ 'href' => string, 'as' => string, |
| @@ -947,9 +1141,8 @@ | ||
| 947 | 1141 | 'os-openstation-layout', |
| 948 | 1142 | 'desktop-mode-ai-assistant', |
| 949 | 1143 | 'desktop-mode-bug-report', |
| 950 | 1144 | 'os-window-overview', |
| 951 | - 'os-settings', | |
| 952 | 1145 | ) |
| 953 | 1146 | ); |
| 954 | 1147 | |
| 955 | 1148 | if ( ! in_array( $handle, (array) $deferred, true ) ) { |
