PluginProbe
OpenStation: Desktop Windows, Dock & Virtual Desktops for WP Admin / 1.1.12
OpenStation: Desktop Windows, Dock & Virtual Desktops for WP Admin v1.1.12
1.1.12 1.1.11 1.1.10 1.1.9 1.1.8 1.1.7 1.1.6 1.1.5 1.1.4 1.1.3 1.1.2 1.1.1 1.1.0 1.0.1 1.0.0 0.9.8 0.9.7 0.9.6 0.9.4 0.9.5 0.9.3 0.9.2 0.9.1 0.9.0 0.8.9 All 36 releases
← All changes | includes/render/assets.php +360 -102 1.0.1 → 1.1.12 View file →
@@ -73,23 +73,31 @@
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 - // CSS.
81 + // CSS. Only the sheets that paint surfaces present at boot — the
82 + // shell chrome, the dock, desktop tiles and pinned notes. Sheets
83 + // for on-demand surfaces (Preferences panel, AI assistant, bug
84 + // report) ship as `deferredStyles` in the config blob below and
85 + // inject on first open; a native window's sheet rides its
86 + // registration's `styles` companion list the same way.
82 87 wp_enqueue_style( 'openstation' );
83 88 wp_enqueue_style( 'os-windows' );
84 89 wp_enqueue_style( 'os-window-overview' );
85 - wp_enqueue_style( 'os-settings' );
86 90 wp_enqueue_style( 'os-dock' );
87 91 wp_enqueue_style( 'os-dock-peek' );
88 - wp_enqueue_style( 'desktop-mode-ai-assistant' );
89 - wp_enqueue_style( 'desktop-mode-bug-report' );
92 + wp_enqueue_style( 'os-workspaces' );
93 + wp_enqueue_style( 'os-shortcuts' );
94 + wp_enqueue_style( 'os-openstation-layout' );
90 95 wp_enqueue_style( 'os-files' );
91 96 wp_enqueue_style( 'os-notes' );
97 + // Unconditional like the layout sheet: a live crossing into the
98 + // phone band must not find the phone layer unstyled.
99 + wp_enqueue_style( 'os-mobile' );
92 100
93 101 // Solo mode — a single window freed into a native OS window by the
94 102 // desktop host. Same shell, everything but that one window hidden.
95 103 $solo_window = openstation_solo_window_id();
@@ -158,35 +166,35 @@
158 166 // WP normally only calls this on screens that opt in to the native
159 167 // palette; the shell needs it on every admin URL it might wrap.
160 168 // `function_exists` guard for pre-6.9 sites — the harvester gracefully
161 169 // no-ops when the store is missing.
170 + // See `openstation_defer_core_command_palette()` below for why
171 + // Core's own boot-time enqueue is unhooked on shell pages.
172 + //
173 + // The Core command-palette runtime is NOT enqueued here any more.
174 + // Its dependency chain is the whole Gutenberg runtime (~800 KB
175 + // gzipped across forty-odd bundles), paid on every boot for a ⌘K
176 + // palette most sessions never open. It now ships as an ordered
177 + // manifest in the config blob (`commandPalette`, built by
178 + // `openstation_build_command_palette_assets_payload()`), and
179 + // `src/commands/palette-assets.ts` replays it the first time the
180 + // palette is invoked. The shell harvester keeps its idle-time
181 + // `install()` — a graceful no-op until the store exists — and
182 + // re-installs on `os-command-palette-ready`.
183 + $command_palette = openstation_build_command_palette_assets_payload();
184 +
162 185 if ( function_exists( 'wp_enqueue_command_palette_assets' ) ) {
163 - // `wp_enqueue_command_palette_assets()` calls
164 - // `array_key_exists( $menu_slug, $submenu )` without guarding
165 - // the global, so an unset `$submenu` (test contexts, edge-case
166 - // admin requests where the menu wasn't built yet) blows up
167 - // with a TypeError. Initialize defensively before calling.
168 - global $menu, $submenu;
169 - // phpcs:disable WordPress.WP.GlobalVariablesOverride.Prohibited -- initializing an unset global to its documented empty shape, not replacing a built menu.
170 - if ( ! isset( $submenu ) || ! is_array( $submenu ) ) {
171 - $submenu = array();
172 - }
173 - if ( ! isset( $menu ) || ! is_array( $menu ) ) {
174 - $menu = array();
175 - }
176 - // phpcs:enable WordPress.WP.GlobalVariablesOverride.Prohibited
177 - wp_enqueue_command_palette_assets();
178 -
179 186 // Expose the same menu-commands array WP serializes into
180 187 // `wp.coreCommands.initializeCommandPalette(...)` on a window
181 188 // slot the shell harvester can read. Built in PHP from `$menu`
182 - // / `$submenu` here (we already guarded that they're arrays
183 - // above), then injected as a `before` inline on our own bundle
184 - // — that runs synchronously before `desktop.min.js` boots the
185 - // shell harvester, so the lookup is guaranteed populated by
186 - // the time `src/commands/shell-harvester.ts` classifies any
187 - // command. Decoupled from WP's command-palette mount timing
188 - // (which fires from a core-registered hook we can't reorder).
189 + // / `$submenu`, then injected as a `before` inline on our own
190 + // bundle — that runs synchronously before `desktop.min.js`
191 + // boots the shell harvester, so the lookup is guaranteed
192 + // populated by the time `src/commands/shell-harvester.ts`
193 + // classifies any command. Decoupled from WP's command-palette
194 + // mount timing (which fires from a core-registered hook we
195 + // can't reorder) — and, since the palette bundles went lazy,
196 + // from whether they have loaded at all.
189 197 $menu_map = openstation_build_command_menu_map();
190 198 wp_add_inline_script(
191 199 'openstation',
192 200 'window.__openStationMenuCommands = ' . wp_json_encode( $menu_map ) . ';',
@@ -194,9 +202,9 @@
194 202 );
195 203 }
196 204
197 205 // Pass configuration to JavaScript.
198 - global $title, $pagenow, $parent_file, $menu;
206 + global $title, $parent_file, $menu;
199 207
200 208 $menu_icon = 'dashicons-admin-generic';
201 209 if ( ! empty( $parent_file ) && ! empty( $menu ) ) {
202 210 foreach ( $menu as $item ) {
@@ -212,13 +220,32 @@
212 220 // plugin-contributed top-level routes. `openstation_dock_placement`
213 221 // is the per-item filter escape hatch for hiding. Shared with the
214 222 // REST menu endpoint so live refreshes (post plugin-activation)
215 223 // produce the same ordering as the boot payload.
216 - $menu_payload = openstation_build_menu_payload();
217 - $dock_items = $menu_payload['dockItems'];
218 - $native_windows = isset( $menu_payload['nativeWindows'] )
224 + $menu_payload = openstation_build_menu_payload();
225 + $dock_items = $menu_payload['dockItems'];
226 + $native_windows = isset( $menu_payload['nativeWindows'] )
219 227 ? $menu_payload['nativeWindows']
220 228 : array();
229 +
230 + // The BOOT page prints every registry window's template as a real
231 + // `<template>` tag (`openstation_render_native_window_templates()`,
232 + // admin_footer @ 20 — before footer scripts, so the tags are in
233 + // the DOM before the shell boots and `ensureTemplate()` adopts
234 + // them by id). The payload's `templateHtml` copy exists for the
235 + // MID-SESSION path — a bridge or probe payload delivering a
236 + // window whose plugin activated after the page rendered — so on
237 + // the boot config it is ~27 KB of the same markup twice. Strip it
238 + // here, and only here: the bridge and probe payloads keep theirs.
239 + foreach ( $native_windows as &$native_window_row ) {
240 + if ( is_array( $native_window_row ) ) {
241 + $native_window_row['templateHtml'] = '';
242 + }
243 + }
244 + unset( $native_window_row );
245 + $native_window_script_data = isset( $menu_payload['nativeWindowScriptData'] )
246 + ? $menu_payload['nativeWindowScriptData']
247 + : array();
221 248 $server_widgets = isset( $menu_payload['serverWidgets'] )
222 249 ? $menu_payload['serverWidgets']
223 250 : array();
224 251 $server_wallpapers = isset( $menu_payload['serverWallpapers'] )
@@ -285,9 +312,29 @@
285 312 // dedupes on an `activeId` that was never set.
286 313 $server_desktop_themes = isset( $menu_payload['serverDesktopThemes'] )
287 314 ? $menu_payload['serverDesktopThemes']
288 315 : array();
289 - $desktop_icons = isset( $menu_payload['desktopIcons'] )
316 +
317 + // Slim the theme library for BOOT: `cssText` and `tokens` are
318 + // each ~20 KB per theme, and neither is read at boot — the ACTIVE
319 + // theme's stylesheet is server-delivered (see
320 + // `openstation_enqueue_desktop_theme_style()`, whose stamp
321 + // `bootAlreadyApplied()` detects), and an inactive theme's CSS
322 + // only matters at the moment the user picks it in the Preferences
323 + // picker — which fetches the full entries from
324 + // `GET desktop-mode/v1/desktop-themes` (`ensureFullDesktopThemes()`
325 + // client-side). `cssDeferred` marks the gap so the shell can tell
326 + // a slimmed entry from a theme that genuinely ships no CSS.
327 + // Bridge and probe payloads keep full entries.
328 + foreach ( $server_desktop_themes as &$desktop_theme_row ) {
329 + if ( is_array( $desktop_theme_row ) ) {
330 + $desktop_theme_row['cssText'] = '';
331 + $desktop_theme_row['tokens'] = new stdClass();
332 + $desktop_theme_row['cssDeferred'] = true;
333 + }
334 + }
335 + unset( $desktop_theme_row );
336 + $desktop_icons = isset( $menu_payload['desktopIcons'] )
290 337 ? $menu_payload['desktopIcons']
291 338 : array();
292 339
293 340 // Files-on-the-Desktop payload (Phase 0+1). Plugin-registered
@@ -298,8 +345,16 @@
298 345 : array();
299 346 $server_file_openers = function_exists( 'openstation_build_file_openers_payload' )
300 347 ? openstation_build_file_openers_payload()
301 348 : array();
349 + // Entries in the menu payload carry dependency handles; their
350 + // payloads ride once in `scriptDepPayloads` (GH#892). The file
351 + // lists stay whole: no sync module reads them on the client, and
352 + // compacting them here was the only write to the map after the
353 + // menu payload froze its own, so a refresh could not match it.
354 + $script_dep_payloads = isset( $menu_payload['scriptDepPayloads'] )
355 + ? (array) $menu_payload['scriptDepPayloads']
356 + : array();
302 357 $user_file_associations = function_exists( 'openstation_get_user_file_associations' )
303 358 ? openstation_get_user_file_associations( get_current_user_id() )
304 359 : array();
305 360 $server_wallpaper_menu_items = function_exists( 'openstation_build_wallpaper_menu_items' )
@@ -364,9 +419,9 @@
364 419 'maxSize' => $drop_max_size,
365 420 );
366 421
367 422 // Lazy-bundle URL builder. Each lazy-loaded bundle (AI Assistant,
368 - // About-scene, OS Settings panel, shell-overlays, window-system)
423 + // OS Settings panel, shell-overlays, window-system)
369 424 // is `<script>`-injected by the main bundle on demand — they don't
370 425 // go through `wp_register_script`, so they don't pick up WordPress's
371 426 // usual `?ver=<filemtime>` cache-buster. Without one, the browser
372 427 // happily serves a stale cached copy across plugin updates that
@@ -388,18 +443,33 @@
388 443 OPENSTATION_URL . 'assets/js/' . $base . $suffix . '.js?ver=' . $ver
389 444 );
390 445 };
391 446
392 - // Build the current page URL from $pagenow + $_GET. Strip the portal
393 - // markers so the derived window ID matches what the dock would produce
394 - // for the same page — otherwise auto-opening the entry window and
395 - // clicking the same dock icon would create a duplicate.
396 - $current_query = $_GET; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
397 - unset( $current_query[ OPENSTATION_PORTAL_FLAG ], $current_query[ OPENSTATION_PORTAL_INTENT_FLAG ] );
398 - $current_page = admin_url( $pagenow ) . ( ! empty( $current_query ) ? '?' . http_build_query( $current_query ) : '' );
447 + // The page the shell opens first. On the shell screen it is the
448 + // validated `target` query arg (else the session's focused window,
449 + // the default window, the Dashboard); on a solo boot it is the
450 + // request's own URL. Either way the frozen portal flags are gone
451 + // from it, so the derived window id matches what the dock would
452 + // produce for the same page — otherwise auto-opening the entry
453 + // window and clicking the same dock icon would create a duplicate.
454 + $boot_target = openstation_shell_boot_target();
455 + $current_page = $boot_target['url'];
456 + $from_portal = $boot_target['fromPortal'];
457 + $from_portal_intent = $boot_target['fromPortalIntent'];
399 458
400 - $from_portal = ! empty( $_GET[ OPENSTATION_PORTAL_FLAG ] ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended
401 - $from_portal_intent = ! empty( $_GET[ OPENSTATION_PORTAL_INTENT_FLAG ] ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended
459 + // On the shell screen `$title` and `$parent_file` describe the
460 + // screen ("OpenStation", no menu), not the page about to open. The
461 + // dock entry for that page is the identity the entry window folds
462 + // into, so its title and icon are the right first paint; the iframe
463 + // reports its own title once it lands either way.
464 + $current_title = wp_strip_all_tags( (string) $title );
465 + if ( openstation_is_shell_screen_request() ) {
466 + $boot_meta = openstation_shell_boot_target_meta( $current_page, $dock_items );
467 + $current_title = wp_strip_all_tags( $boot_meta['title'] );
468 + if ( '' !== $boot_meta['icon'] ) {
469 + $menu_icon = $boot_meta['icon'];
470 + }
471 + }
402 472
403 473 /**
404 474 * Filters the desktop shell configuration passed to JavaScript.
405 475 *
@@ -431,17 +501,22 @@
431 501 * @type array $defaultWindow { enabled: bool, url: string } — current default-window preference.
432 502 * @type bool $canUpload Whether the user holds the `upload_files` capability.
433 503 * @type string $pluginUrl Plugin base URL (no trailing slash). Used by the shell to locate vendor assets and by plugins to build asset URLs.
434 504 * @type string $pluginVersion Plugin semver string. Surfaced in the OS Settings → About tab; plugins can read it to gate features by version.
505 + * @type string $aboutFeedUrl Authenticated admin-AJAX URL that returns the cached OpenStation journal feed for the About tab.
435 506 * @type string $restNonce Nonce for the session REST endpoint.
436 507 * @type string $soloWindow Window id when the shell was asked to paint exactly one window (`?openstation_solo=<id>`); '' otherwise. No dock, taskbar, wallpaper or desk, and no session restore.
437 508 * @type string $portalUrl Canonical `/openstation/` URL.
438 509 * @type bool $fromPortal Whether the shell was reached via the portal.
439 510 * @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.
440 - * @type array $seenIntros Slugs of one-time intro dialogs the user has dismissed (e.g. `['posts']`). Native windows gate their first-open intro on this list.
511 + * @type array $seenIntros Slugs of one-time announcements the user has dismissed (e.g. `['openstation-rebrand']`).
441 512 * @type string $seenIntrosUrl REST endpoint for the seen-intros surface — POST `/seen` to mark, DELETE the base to reset.
513 + * @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`.
514 + * @type string $shellTourBundleUrl URL of the lazy shell-tour bundle, injected on first use.
515 + * @type array $firstRun `{ installedAt, firstEnabledAt, enabledAt }`, epoch seconds, 0 when unknown — the first-run stamps, read-only.
442 516 * @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.
443 - * @type array $stickyNotes { available: bool } — whether the Gutenberg Guidelines experiment (the `wp_guideline` CPT + `wp_guideline_type` taxonomy) is registered. The shell skips booting the sticky-notes layer when false, avoiding the REST probes that 404 without the experiment. See `openstation_sticky_notes_is_available()`.
517 + * @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.
518 + * @type string $usageFeedbackBundleUrl URL of the lazy `usage-feedback` bundle, the form the prompt opens.
444 519 * }
445 520 */
446 521 $config = apply_filters(
447 522 'openstation_shell_config',
@@ -446,11 +521,22 @@
446 521 $config = apply_filters(
447 522 'openstation_shell_config',
448 523 array(
449 524 'currentPage' => esc_url( $current_page ),
450 - 'currentTitle' => wp_strip_all_tags( $title ),
525 + 'currentTitle' => $current_title,
451 526 'currentIcon' => sanitize_html_class( $menu_icon ),
452 - 'adminUrl' => esc_url( admin_url() ),
527 + // `self_admin_url()`: the base a window id is derived from,
528 + // and the URL the shell leaves for on exit. Both want the
529 + // admin the screen is in, which is the network one when the
530 + // network shell screen is what rendered.
531 + 'adminUrl' => esc_url( self_admin_url() ),
532 + 'homeUrl' => esc_url( home_url( '/' ) ),
533 + // Decoded: the shell assigns this to `window.location`,
534 + // where `&amp;` would make `_wpnonce` arrive as
535 + // `amp;_wpnonce` and fail the nonce check.
536 + 'logoutUrl' => esc_url_raw(
537 + html_entity_decode( wp_logout_url(), ENT_QUOTES, 'UTF-8' )
538 + ),
453 539 'colorScheme' => sanitize_html_class( get_user_option( 'admin_color' ), 'fresh' ),
454 540 'dockItems' => $dock_items,
455 541 // Baseline menu fingerprint. The shell seeds its last-known
456 542 // signature from this so the first off-allowlist menu change
@@ -456,8 +542,12 @@
456 542 // signature from this so the first off-allowlist menu change
457 543 // (vs. this boot state) is caught without a wasted probe. GH#325.
458 544 'menuSig' => isset( $menu_payload['menuSig'] ) ? (string) $menu_payload['menuSig'] : '',
459 545 'nativeWindows' => $native_windows,
546 + // Handle-keyed script data the entries above reference —
547 + // one copy per bundle, not one per window. See
548 + // `openstation_collect_native_windows_payload()`.
549 + 'nativeWindowScriptData' => $native_window_script_data,
460 550 'serverWidgets' => $server_widgets,
461 551 'serverWallpapers' => $server_wallpapers,
462 552 'serverCommandScripts' => $server_command_scripts,
463 553 'serverCommands' => $server_commands,
@@ -483,8 +573,11 @@
483 573 'serverDesktopThemes' => $server_desktop_themes,
484 574 'desktopIcons' => $desktop_icons,
485 575 'serverFileTypes' => $server_file_types,
486 576 'serverFileOpeners' => $server_file_openers,
577 + // Handle => dependency payload for every `scriptDeps` list in
578 + // this config; see `openstation_compact_script_deps()`.
579 + 'scriptDepPayloads' => (object) $script_dep_payloads,
487 580 'userFileAssociations' => $user_file_associations,
488 581 'filesUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/files' ) ),
489 582 // Pinned-notes REST base (`includes/notes/rest.php`). The
490 583 // notes layer boots only when this is present.
@@ -500,9 +593,17 @@
500 593 'coreNotices' => openstation_get_core_notices(),
501 594 'pluginNotices' => openstation_get_plugin_notices(),
502 595 'defaultWallpaper' => openstation_get_default_wallpaper(),
503 596 'session' => openstation_get_session( get_current_user_id() ),
504 - 'sessionUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/session' ) ),
597 + // The session route runs in the main site's blog context
598 + // whichever desktop posts to it, so the network screen's
599 + // URL says which session it is addressing — see
600 + // `openstation_rest_session_network()`.
601 + 'sessionUrl' => esc_url_raw(
602 + is_network_admin()
603 + ? add_query_arg( 'network', '1', rest_url( 'desktop-mode/v1/session' ) )
604 + : rest_url( 'desktop-mode/v1/session' )
605 + ),
505 606 'restUrl' => esc_url_raw( rest_url() ),
506 607 'mediaUrl' => esc_url_raw( rest_url( 'wp/v2/media' ) ),
507 608 'dropConfig' => $drop_config,
508 609 'defaultWindowUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/default-window' ) ),
@@ -509,8 +610,17 @@
509 610 'defaultWindow' => openstation_get_default_window( get_current_user_id() ),
510 611 'canUpload' => current_user_can( 'upload_files' ),
511 612 'pluginUrl' => esc_url_raw( untrailingslashit( OPENSTATION_URL ) ),
512 613 'pluginVersion' => OPENSTATION_VERSION,
614 + 'aboutFeedUrl' => esc_url_raw(
615 + add_query_arg(
616 + array(
617 + 'action' => 'openstation_about_feed',
618 + 'nonce' => wp_create_nonce( 'openstation_about_feed' ),
619 + ),
620 + admin_url( 'admin-ajax.php' )
621 + )
622 + ),
513 623 'iframeBridgeUrl' => $lazy_bundle_url( 'iframe-bridge' ),
514 624 // URL of the AI Assistant lazy bundle. The main bundle
515 625 // ships a stub matching the public `wp.os.ai` API; the
516 626 // stub `<script>`-injects this URL the first time the user
@@ -516,25 +626,39 @@
516 626 // stub `<script>`-injects this URL the first time the user
517 627 // opens the assistant. Picking `.js` vs `.min.js` here keeps
518 628 // the SCRIPT_DEBUG gate server-side, matching iframeBridgeUrl.
519 629 'aiAssistantBundleUrl' => $lazy_bundle_url( 'ai-assistant' ),
520 - // URL of the About-scene lazy bundle. The OS Settings →
521 - // About tab loads this on first mount; ~25 kB PixiJS
522 - // particle scene that would otherwise ship in the main
523 - // bundle for every shell load.
524 - 'aboutSceneBundleUrl' => $lazy_bundle_url( 'about-scene' ),
525 - // URL of the OS Settings panel lazy bundle. Injected by
526 - // the main bundle's `OsSettings.renderPanel()` stub on
527 - // the user's first Settings open. Holds every section
528 - // renderer + the `<os-*>` components only the panel
529 - // uses, so nothing about Settings ships in
530 - // `desktop.min.js` for users who never open it.
531 - 'osSettingsPanelBundleUrl' => $lazy_bundle_url( 'os-settings-panel' ),
532 630 // URL of the shell-overlays lazy bundle. Pre-loaded by
533 631 // the main bundle after first paint so action-triggered
534 632 // overlays (toast, confirm dialog, context menus) feel
535 633 // instant the first time they fire.
536 634 'shellOverlaysBundleUrl' => $lazy_bundle_url( 'shell-overlays' ),
635 + // The shell-bundle diet: features whose right moment is a
636 + // user gesture (or a presence signal) ride their own
637 + // bundles instead of the boot-critical `desktop[.min].js`.
638 + // Each sentinel in the shell loads its bundle at that
639 + // moment — see the entry file each bundle names.
640 + 'fileDropBundleUrl' => $lazy_bundle_url( 'file-drop' ),
641 + 'filesOverlaysBundleUrl' => $lazy_bundle_url( 'files-overlays' ),
642 + 'notesBundleUrl' => $lazy_bundle_url( 'notes' ),
643 + 'dockConstellationBundleUrl' => $lazy_bundle_url( 'dock-constellation' ),
644 + 'windowLinkVisualsBundleUrl' => $lazy_bundle_url( 'window-link-visuals' ),
645 + // Presence hint for the notes sentinel: a desktop with no
646 + // notes skips the notes bundle AND the boot-time list
647 + // request. Two id-only existence probes at most.
648 + 'hasNotes' => function_exists( 'openstation_notes_user_has_any' )
649 + ? openstation_notes_user_has_any()
650 + : false,
651 + // URL of the full `<os-*>` component kit. The shell
652 + // never loads this — its own bundles import the
653 + // components they render. It exists for
654 + // `wp.os.loadComponents()`, i.e. for plugin code that
655 + // CANNOT import: a plugin shipped as a zip has no path
656 + // to this repo at build time, so before this URL its
657 + // only routes to a `<os-switch>` were to bundle a second
658 + // copy or hand-roll one. Shipping the URL costs one
659 + // string and keeps the SCRIPT_DEBUG choice server-side.
660 + 'componentsBundleUrl' => $lazy_bundle_url( 'os-components' ),
537 661 // Mio — the desk companion. `mio` carries the
538 662 // appearance + physics (see `openstation_mio_config()`);
539 663 // `mioBundleUrl` is the lazy PixiJS bundle the shell
540 664 // controller injects the first time a user switches the
@@ -558,12 +682,29 @@
558 682 // / `openNew()` call (both async); pre-loaded
559 683 // by the shell after first paint when no session is being
560 684 // restored and no `openCurrentPage` will fire.
561 685 'windowSystemBundleUrl' => $lazy_bundle_url( 'window-system' ),
686 + // URL of the lazy phone-layer bundle. Injected by the main
687 + // bundle only when the mode resolves to `mobile`, so a
688 + // desktop never fetches it. `mode` carries the preference
689 + // and breakpoints the first-paint head stamp already used,
690 + // plus the server's default tab-bar pins — see
691 + // `includes/mobile.php`.
692 + 'mobileBundleUrl' => $lazy_bundle_url( 'mobile' ),
693 + 'mode' => openstation_mode_config( get_current_user_id() ),
562 694 // URL of the item-visibility-menu lazy bundle — the
563 695 // right-click "hide from dock / desktop" menu. Injected by
564 696 // the main bundle's loader shim on the first right-click.
565 697 'itemVisibilityMenuBundleUrl' => $lazy_bundle_url( 'item-visibility-menu' ),
698 + // URL of the workspace-wizard lazy bundle — the modal
699 + // behind "Edit this workspace…". Injected by the main
700 + // bundle's loader shim on first open.
701 + 'workspaceWizardBundleUrl' => $lazy_bundle_url( 'workspace-wizard' ),
702 + // Server-side view of the workspace templates, so a plugin
703 + // can add or drop one from PHP. The client merges these
704 + // with its own built-ins by id — see
705 + // `src/workspaces/server-sync.ts`.
706 + 'workspacePresets' => openstation_workspace_presets(),
566 707 // URL of the release-card lazy bundle — the vinyl core-
567 708 // update announcement. Injected by `maybeShowUpdate()` only
568 709 // when a core update is actually pending.
569 710 'releaseCardBundleUrl' => $lazy_bundle_url( 'release-card' ),
@@ -580,18 +721,27 @@
580 721 // announcement yet. Same value that gated `os-announce`
581 722 // above; the dialog cannot paint without that stylesheet, so
582 723 // the two must not diverge.
583 724 'rebrandNotice' => $show_rebrand_notice,
584 - // Sticky notes ride on Gutenberg's Guidelines experiment
585 - // (the `wp_guideline` CPT + `wp_guideline_type` taxonomy).
586 - // When that experiment isn't active the `wp/v2/guidelines`
587 - // + `wp/v2/wp_guideline_type` probes 404 — harmless but
588 - // noisy — so the shell skips booting the layer entirely.
589 - 'stickyNotes' => array(
590 - 'available' => openstation_sticky_notes_is_available(),
591 - ),
725 + // The first-boot shell tour: whether this site offers it
726 + // (the `openstation_show_shell_tour` filter), and the lazy
727 + // bundle that runs it. Whether THIS user already had it is
728 + // `seenIntros` containing `shell-tour`; the shell reads that
729 + // itself so a reset can replay the tour without a new boot.
730 + 'shellTour' => openstation_should_offer_shell_tour( get_current_user_id() ),
731 + 'shellTourBundleUrl' => $lazy_bundle_url( 'shell-tour' ),
732 + // The first-run stamps, read-only, epoch seconds (0 when
733 + // unknown): when the plugin was installed, when anyone first
734 + // enabled it, and when this user did. See
735 + // `includes/first-run/stamps.php`.
736 + 'firstRun' => openstation_first_run_config( get_current_user_id() ),
737 + // Null for everyone but a user who has had OpenStation on
738 + // long enough and has not answered yet; the gate lives in
739 + // `includes/feedback/usage.php`. The form is a lazy bundle
740 + // fetched only when the user says yes to the prompt.
741 + 'usageFeedback' => function_exists( 'openstation_usage_feedback_config' ) ? openstation_usage_feedback_config() : null,
742 + 'usageFeedbackBundleUrl' => $lazy_bundle_url( 'usage-feedback' ),
592 743 'aiSearchUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/ai/search' ) ),
593 - 'aiSearchStreamUrl' => esc_url_raw( add_query_arg( 'action', 'openstation_ai_search_stream', admin_url( 'admin-ajax.php' ) ) ),
594 744 // AI assistant availability + per-user toggle. Drives whether the
595 745 // Cmd+K palette and admin-bar icon appear, and the setup placeholder.
596 746 'aiAssistant' => function_exists( 'openstation_ai_assistant_config' )
597 747 ? openstation_ai_assistant_config()
@@ -604,41 +754,57 @@
604 754 // Site-wide games kill switch (Extended options). Exposed to
605 755 // every user — the shell skips the challenges Heartbeat
606 756 // channel when the framework is off.
607 757 'gamesEnabled' => openstation_games_enabled(),
608 - // Comments-window AI moderation toggle — surfaced at the
609 - // shell level so the OS Settings → Features tab can render
610 - // the toggle without depending on the Comments window
611 - // being registered for this user. URL is the same
612 - // endpoint the comments-window config exposes; state is
613 - // `null` for non-admins (the UI hides the row entirely).
614 - 'commentsAiUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/comments/ai-settings' ) ),
615 - // Non-null only for admins on a site where the Core AI stack is
616 - // present. Comment scoring routes through the AI Client (WP 7.0+),
617 - // so on older WordPress the whole row is hidden — same as the
618 - // assistant toggle — rather than shown disabled pointing at a
619 - // Settings → Connectors screen that doesn't exist there.
620 - 'commentsAi' => (
621 - current_user_can( 'manage_options' )
622 - && function_exists( 'openstation_ai_is_available' )
623 - && openstation_ai_is_available()
624 - )
625 - ? array(
626 - 'enabled' => function_exists( 'openstation_comments_ai_is_enabled' )
627 - ? openstation_comments_ai_is_enabled()
628 - : false,
629 - 'providerConfigured' => function_exists( 'openstation_comments_ai_provider_configured' )
630 - ? openstation_comments_ai_provider_configured()
631 - : false,
632 - )
633 - : null,
634 758 'currentUserIsAdmin' => current_user_can( 'manage_options' ),
759 + // Null on single-site installs; its `networkAdmin` null
760 + // without `manage_network`, which is what keeps the dock
761 + // tile from registering.
762 + 'multisite' => openstation_multisite_payload(),
635 763 'portalUrl' => esc_url( openstation_portal_url() ),
636 764 'fromPortal' => $from_portal,
637 765 'fromPortalIntent' => $from_portal_intent,
766 + // One-shot like the boot target: a switch from another
767 + // site's overview lands in this one's.
768 + 'landInOverview' => openstation_shell_lands_in_overview(),
769 + 'arrivalDirection' => openstation_shell_arrival_direction(),
770 + 'hopLinkOffer' => function_exists( 'openstation_network_link_offer' ) ? openstation_network_link_offer() : null,
638 771 'pwa' => array(
639 772 'manifestUrl' => esc_url_raw( openstation_pwa_manifest_url() ),
640 773 'swUrl' => esc_url_raw( openstation_pwa_sw_url() ),
774 + // Extensionless retry target for hosts whose nginx 404s
775 + // virtual .js paths before WordPress runs (WordPress.com).
776 + 'swFallbackUrl' => esc_url_raw( openstation_pwa_sw_fallback_url() ),
777 + // The site's home path — the scope the registration
778 + // asks for, so a subdirectory network's sites each get
779 + // their own worker instead of fighting over the root.
780 + 'swScope' => openstation_pwa_sw_scope(),
781 + // The worker's per-user flags, computed HERE rather than
782 + // baked into the served `sw.js`.
783 + //
784 + // A service worker is origin-wide but these are per-user
785 + // preferences, so putting them in the script bytes made
786 + // the body differ between an anonymous and a logged-in
787 + // request — and any in-scope logged-out navigation then
788 + // installed a "new" worker, which at the time reloaded
789 + // the shell. The bytes are identical for everyone now;
790 + // the shell posts these to the worker at boot.
791 + //
792 + // Computed server-side, not read from the settings
793 + // snapshot client-side, because
794 + // `openstation_pwa_admin_asset_cache_enabled()` applies
795 + // the `openstation_pwa_admin_asset_cache` filter — an
796 + // operator's site-wide veto has to keep working.
797 + 'swConfig' => array(
798 + 'adminAssetCache' => (bool) openstation_pwa_admin_asset_cache_enabled(),
799 + 'windowPrewarm' => ! empty( openstation_get_os_settings( get_current_user_id() )['windowPrewarmEnabled'] ),
800 + ),
801 + // The build this shell document belongs to. When a new
802 + // worker takes over mid-session the shell asks it for
803 + // the stamp it was served with and compares; only a
804 + // difference — the shell's own files changed on the
805 + // server — offers the user a reload. Never automatic.
806 + 'shellBuild' => openstation_shell_build_stamp(),
641 807 'stateUrl' => esc_url_raw( rest_url( 'desktop-mode/v1/pwa-state' ) ),
642 808 'state' => openstation_pwa_get_user_state( get_current_user_id() ),
643 809 // Mirrors the manifest's `name` field — used by the
644 810 // install pill so the button reads "Install <site>"
@@ -654,8 +820,54 @@
654 820 // `src/pwa/sw-register.ts`). Default `false` preserves
655 821 // the polite behaviour where we yield to existing PWAs.
656 822 'forceReplaceSw' => openstation_pwa_force_replace_sw(),
657 823 ),
824 + // Ordered Core command-palette asset manifest, replayed on
825 + // first palette invocation. `null` on pre-6.9 sites.
826 + 'commandPalette' => $command_palette,
827 + // Stylesheets for shell surfaces that render on demand —
828 + // the Preferences panel, the AI assistant, the bug-report
829 + // window. None of them is a server-registered native
830 + // window (they are built client-side by the shell
831 + // bundle), so the `styles` companion mechanism can't
832 + // carry their CSS; instead the shell injects each sheet
833 + // the first time its surface opens, via
834 + // `ensureDeferredStyle()` in `src/deferred-styles.ts`.
835 + // Same resolved shape a native window's `styleUrl` /
836 + // `styleInline` travels in.
837 + // Which of the `deferredStyles` entries a game needs.
838 + // `launchGame()` injects these before the window paints.
839 + 'gameStyleHandles' => function_exists( 'openstation_games_style_handles' )
840 + ? openstation_games_style_handles()
841 + : array(),
842 + 'deferredStyles' => openstation_build_deferred_styles(
843 + array_merge(
844 + array(
845 + 'desktop-mode-ai-assistant',
846 + 'desktop-mode-bug-report',
847 + // The explorer's shared sheet. It rides the WP
848 + // Explorer APP as a companion style, but the
849 + // desktop FOLDER window paints its preview pane
850 + // with the same `os-my-wordpress__*` classes and
851 + // — being a native window opened straight from
852 + // JS — carries no companion styles of its own.
853 + // Without this, the pane rendered unstyled until
854 + // the explorer had been opened once in the
855 + // session.
856 + 'desktop-mode-my-wordpress',
857 + ),
858 + // The Games sheets. They also ride the hub window as
859 + // companion styles, but a game is reachable without
860 + // the hub — the challenge toast, solo mode, and
861 + // `wp.os.games.launch()` all land in `launchGame()`
862 + // with no hub window in the tab. Listing them here
863 + // costs a URL each in the boot config and no CSS
864 + // until `launchGame()` asks.
865 + function_exists( 'openstation_games_style_handles' )
866 + ? openstation_games_style_handles()
867 + : array()
868 + )
869 + ),
658 870 )
659 871 );
660 872
661 873 wp_localize_script( 'openstation', 'openStationConfig', $config );
@@ -667,8 +879,46 @@
667 879 }
668 880 add_action( 'admin_enqueue_scripts', 'openstation_enqueue_assets' );
669 881
670 882 /**
883 + * Keep Core's boot-time command-palette enqueue off shell pages.
884 + *
885 + * WordPress 7.0 hooks `wp_enqueue_command_palette_assets()` on
886 + * `admin_enqueue_scripts` by default, which puts the palette's whole
887 + * dependency chain — the Gutenberg runtime, ~800 KB gzipped — on
888 + * every admin page. On a SHELL page that is pure dead weight: the
889 + * shell suppresses Core's palette unconditionally (the ⌘K keystroke
890 + * and the admin-bar icon both route to the shell's own palette), so
891 + * the runtime it powers can never be shown. Unhooking here lets the
892 + * deferred manifest (`openstation_build_command_palette_assets_payload()`)
893 + * capture the chain instead, and the shell loads it on the first
894 + * palette invocation.
895 + *
896 + * Deliberately scoped: classic-mode requests keep Core's default,
897 + * because a classic page is Core's own UI where Core's palette is the
898 + * right one.
899 + *
900 + * Windows are handled separately by
901 + * {@see openstation_chromeless_should_trim_command_palette()} in
902 + * `includes/render/chromeless-trim.php` — same idea, but it has to
903 + * drop the whole palette *family* rather than just unhook Core's
904 + * callback, and it exempts block-editor screens. Unhooking alone is
905 + * not enough there: a third-party palette extension that declares
906 + * `wp-commands` keeps the entire chain queued as its dependency.
907 + *
908 + * Priority 0, ahead of Core's default 10, so the removal lands
909 + * before the callback fires. On WP 6.9 (function exists, no default
910 + * hook) the `remove_action()` is a harmless no-op.
911 + */
912 +function openstation_defer_core_command_palette() {
913 + if ( ! openstation_is_shell_request() ) {
914 + return;
915 + }
916 + remove_action( 'admin_enqueue_scripts', 'wp_enqueue_command_palette_assets' );
917 +}
918 +add_action( 'admin_enqueue_scripts', 'openstation_defer_core_command_palette', 0 );
919 +
920 +/**
671 921 * Emits `<link rel="preload">` hints for the shell's critical-path
672 922 * assets so the browser starts fetching them as soon as it parses
673 923 * the document `<head>`.
674 924 *
@@ -711,14 +961,9 @@
711 961 * supply absolute URLs through the filter; in that case the consumer
712 962 * is responsible for the `crossorigin` semantics.
713 963 */
714 964 function openstation_print_preload_hints() {
715 - if (
716 - ! is_admin()
717 - || ! openstation_is_enabled()
718 - || openstation_is_chromeless_request()
719 - || openstation_is_classic_request()
720 - ) {
965 + if ( ! openstation_is_shell_request() ) {
721 966 return;
722 967 }
723 968
724 969 $suffix = openstation_asset_suffix();
@@ -761,8 +1006,21 @@
761 1006 'rel' => 'prefetch',
762 1007 ),
763 1008 );
764 1009
1010 + // The phone layer is needed at boot on a phone and never on a
1011 + // desktop; the server cannot see the viewport, so the user agent
1012 + // decides whether the hint is worth its bytes. A wrong guess costs
1013 + // one low-priority fetch, never a wrong layout — the stamp and the
1014 + // bundle loader read the real viewport.
1015 + if ( openstation_mode_hint_is_mobile( get_current_user_id() ) ) {
1016 + $hints[] = array(
1017 + 'href' => $build_url( 'assets/js/mobile' . $suffix . '.js' ),
1018 + 'as' => 'script',
1019 + 'rel' => 'prefetch',
1020 + );
1021 + }
1022 +
765 1023 /**
766 1024 * Filters the list of resource preload hints emitted in `<head>`.
767 1025 *
768 1026 * Each entry is a `{ 'href' => string, 'as' => string,
@@ -875,12 +1133,12 @@
875 1133 $deferred = apply_filters(
876 1134 'openstation_deferred_styles',
877 1135 array(
878 1136 'os-dock-peek',
1137 + 'os-openstation-layout',
879 1138 'desktop-mode-ai-assistant',
880 1139 'desktop-mode-bug-report',
881 1140 'os-window-overview',
882 - 'os-settings',
883 1141 )
884 1142 );
885 1143
886 1144 if ( ! in_array( $handle, (array) $deferred, true ) ) {