PluginProbe
OpenStation: Desktop Windows, Dock & Virtual Desktops for WP Admin / 1.1.13
OpenStation: Desktop Windows, Dock & Virtual Desktops for WP Admin v1.1.13
1.1.13 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 All 37 releases
← All changes | includes/assets.php +402 -161 0.9.1 → 1.1.13 View file →
@@ -1,27 +1,63 @@
1 1 <?php
2 2 /**
3 - * Desktop Mode asset registration.
3 + * OpenStation asset registration.
4 4 *
5 - * Registers all desktop-mode CSS and JS handles with WordPress so they can
5 + * Registers all openstation CSS and JS handles with WordPress so they can
6 6 * be enqueued from anywhere in the plugin (or by third parties).
7 7 *
8 - * @package WPDesktopMode
8 + * @package OpenStation
9 9 */
10 10
11 11 defined( 'ABSPATH' ) || exit;
12 12
13 13 /**
14 - * Registers the desktop mode CSS and JS handles.
14 + * Cache-buster for a stylesheet that `@import`s sub-sheets: the max
15 + * `filemtime` across the file AND everything it (transitively) imports.
16 + * Sub-sheet URLs carry no `?ver=` of their own, so the parent's stamp is
17 + * the only cache key the browser ever sees for the subtree — it must
18 + * move when any member changes.
15 19 *
16 - * @since 0.1.0
20 + * @param string $relative Stylesheet path relative to the plugin dir.
21 + * @param string $fallback Version to use when the file is missing.
22 + * @return string Version string.
17 23 */
18 -function desktop_mode_register_assets() {
19 - $version = DESKTOP_MODE_VERSION;
20 - $suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
24 +function openstation_css_subtree_version( $relative, $fallback ) {
25 + $root = OPENSTATION_DIR . $relative;
26 + if ( ! file_exists( $root ) ) {
27 + return (string) $fallback;
28 + }
29 + $max = (int) filemtime( $root );
30 + $queue = array( $root );
31 + $seen = array( $root => true );
32 + while ( ! empty( $queue ) ) {
33 + $file = array_pop( $queue );
34 + $css = (string) file_get_contents( $file );
35 + if ( ! preg_match_all( '/@import\s+url\(\s*["\']?([^"\')\s]+)["\']?\s*\)/i', $css, $matches ) ) {
36 + continue;
37 + }
38 + foreach ( $matches[1] as $import ) {
39 + $path = dirname( $file ) . '/' . $import;
40 + if ( ! file_exists( $path ) || isset( $seen[ $path ] ) ) {
41 + continue;
42 + }
43 + $seen[ $path ] = true;
44 + $max = max( $max, (int) filemtime( $path ) );
45 + $queue[] = $path;
46 + }
47 + }
48 + return (string) $max;
49 +}
21 50
51 +/**
52 + * Registers the OpenStation CSS and JS handles.
53 + */
54 +function openstation_register_assets() {
55 + $version = OPENSTATION_VERSION;
56 + $suffix = openstation_asset_suffix();
57 +
22 58 // `filemtime`-stamped version for built bundles. The plugin-wide
23 - // `DESKTOP_MODE_VERSION` is bumped per release, but the bundles
59 + // `OPENSTATION_VERSION` is bumped per release, but the bundles
24 60 // iterate faster — without a per-file mtime stamp, two clients
25 61 // loading the same `?ver=…` URL can be served different bytes
26 62 // (whichever build was on disk at upload time). Stamping with the
27 63 // file's modification time guarantees the URL changes whenever the
@@ -28,59 +64,185 @@
28 64 // file does, so "is my fix deployed?" is answerable from the
29 65 // network tab. Falls back to `$version` when the file is missing
30 66 // (test envs that import this file before the build runs).
31 67 $built_version = static function ( $relative ) use ( $version ) {
32 - $path = DESKTOP_MODE_DIR . $relative;
68 + $path = OPENSTATION_DIR . $relative;
33 69 return file_exists( $path ) ? (string) filemtime( $path ) : $version;
34 70 };
35 71
36 72 // Styles.
73 + // `filemtime`-stamped, NOT the plugin-wide `$version`. This file
74 + // is the token catalogue every other sheet resolves `var()`s
75 + // against, and it changes whenever the palette does — which is a
76 + // lot more often than the plugin version is bumped. With a static
77 + // stamp the browser holds the old palette until a hard reload,
78 + // and the symptom is maddening: a themed shell where some
79 + // surfaces update and others don't.
37 80 wp_register_style(
38 - 'desktop-mode-variables',
39 - DESKTOP_MODE_URL . 'assets/css/variables.css',
81 + 'os-variables',
82 + OPENSTATION_URL . 'assets/css/variables.css',
40 83 array(),
41 - $version
84 + $built_version( 'assets/css/variables.css' )
42 85 );
43 86 // `filemtime`-stamped so the `<link rel="stylesheet">` URL matches the
44 87 // `<link rel="preload" as="style">` hint emitted by
45 - // `desktop_mode_print_preload_hints()` (which stamps with filemtime).
88 + // `openstation_print_preload_hints()` (which stamps with filemtime).
46 89 // Registering this with the plain `$version` instead produced two
47 90 // different `?ver=` query strings for the same file, so the browser
48 91 // never matched the preload to the stylesheet and logged "preloaded
49 92 // but not used within a few seconds from the window's load event".
50 93 wp_register_style(
51 - 'desktop-mode',
52 - DESKTOP_MODE_URL . 'assets/css/desktop.css',
53 - array( 'desktop-mode-variables' ),
94 + 'openstation',
95 + OPENSTATION_URL . 'assets/css/desktop.css',
96 + array( 'os-variables' ),
54 97 $built_version( 'assets/css/desktop.css' )
55 98 );
56 - // `filemtime`-stamped — window-chrome iteration (drop overlays,
57 - // new drag affordances, third-party-plugin compat) lands faster
58 - // than plugin version bumps. Without an mtime stamp the browser
59 - // keeps `?ver=<plugin-version>` valid for the whole release cycle
60 - // and the user keeps seeing yesterday's CSS even after a hard
61 - // reload. Stamps the parent `windows.css` only; the @imports inside
62 - // (`window-chrome.css`, `window-states.css`, …) inherit the cache
63 - // directive from the parent fetch, so a busted `windows.css` busts
64 - // the whole subtree.
99 +
100 + /*
101 + * Window styles — one handle per sheet, chained by dependency.
102 + *
103 + * These used to be `@import url( … )`ed from `windows.css` under
104 + * the single `os-windows` handle. That was a standing
105 + * cache bug: an `@import` URL carries no `?ver=`, so a changed
106 + * sub-sheet had no URL for the browser to invalidate. Stamping the
107 + * PARENT with the subtree's max mtime (which is what
108 + * `openstation_css_subtree_version()` was for) made the browser
109 + * re-fetch `windows.css` and then request each sub-sheet at an
110 + * unchanged URL — free to be served from its heuristic cache. The
111 + * result was edits not landing until a hard refresh, and rules
112 + * being relocated into `windows.css` purely to dodge it.
113 + *
114 + * Now every sheet is separately registered with its own
115 + * `filemtime` stamp, so each has a real cache key.
116 + *
117 + * THE DEPENDENCY CHAIN IS LOAD-BEARING. WordPress prints
118 + * dependencies before dependents, so chaining each sheet to the
119 + * previous one reproduces the order the `@import` block had, and
120 + * `os-windows` (which depends on the last link) still
121 + * prints after them and still wins ties:
122 + *
123 + * window-chrome → window-states → effects → window-links
124 + * → windows
125 + *
126 + * `window-overview` is deliberately NOT in this chain — it is
127 + * registered below, after `os-windows`, so it can load deferred.
128 + * Adding a sheet here means splicing it into the chain, not
129 + * appending an unrelated dependency: order is the contract.
130 + * (The Preferences window's sheet is not here at all: it rides
131 + * the `apps/os-settings/` app as a first-open companion style.)
132 + */
133 + $window_sheets = array(
134 + 'os-window-chrome' => 'assets/css/window-chrome.css',
135 + 'os-window-states' => 'assets/css/window-states.css',
136 + 'os-effects' => 'assets/css/effects.css',
137 + 'os-window-links' => 'assets/css/window-links.css',
138 + );
139 + $previous = array( 'os-variables', 'dashicons' );
140 + foreach ( $window_sheets as $handle => $relative ) {
141 + wp_register_style(
142 + $handle,
143 + OPENSTATION_URL . $relative,
144 + $previous,
145 + $built_version( $relative )
146 + );
147 + $previous = array( $handle );
148 + }
149 +
150 + // Entry point. Depends on the tail of the chain above, so
151 + // enqueuing this one handle still pulls in every critical window
152 + // sheet — the behaviour callers had when they were `@import`s.
65 153 wp_register_style(
66 - 'desktop-mode-windows',
67 - DESKTOP_MODE_URL . 'assets/css/windows.css',
68 - array( 'desktop-mode-variables', 'dashicons' ),
154 + 'os-windows',
155 + OPENSTATION_URL . 'assets/css/windows.css',
156 + $previous,
69 157 $built_version( 'assets/css/windows.css' )
70 158 );
159 + // Loads DEFERRED (see `openstation_defer_non_critical_styles()`):
160 + // the UI it styles — the window overview — is lazy-loaded JS that
161 + // can never be on screen at first paint, so its CSS has no
162 + // business blocking render. It depends on `os-windows` so it
163 + // prints after it, preserving the cascade position it had as an
164 + // `@import`.
71 165 wp_register_style(
72 - 'desktop-mode-dock',
73 - DESKTOP_MODE_URL . 'assets/css/dock.css',
74 - array( 'desktop-mode-variables', 'dashicons' ),
75 - $version
166 + 'os-window-overview',
167 + OPENSTATION_URL . 'assets/css/window-overview.css',
168 + array( 'os-windows' ),
169 + $built_version( 'assets/css/window-overview.css' )
76 170 );
171 + // Solo mode — one window, no desk around it. Loads last so it can
172 + // hide surfaces the sheets above declared, and only enqueues on a
173 + // solo request, so a normal shell never pays for it.
77 174 wp_register_style(
78 - 'desktop-mode-dock-peek',
79 - DESKTOP_MODE_URL . 'assets/css/dock-peek.css',
80 - array( 'desktop-mode-dock' ),
81 - $version
175 + 'os-solo',
176 + OPENSTATION_URL . 'assets/css/solo.css',
177 + array( 'os-windows' ),
178 + $built_version( 'assets/css/solo.css' )
82 179 );
180 + wp_register_style(
181 + 'os-dock',
182 + OPENSTATION_URL . 'assets/css/dock.css',
183 + array( 'os-variables', 'dashicons' ),
184 + $built_version( 'assets/css/dock.css' )
185 + );
186 + // The Taskbar rail renderer. Scoped to the rail it stamps, so it is
187 + // inert under the icon strip; loaded with the dock because the
188 + // renderer can be picked live.
189 + wp_register_style(
190 + 'os-dock-taskbar',
191 + OPENSTATION_URL . 'assets/css/dock-taskbar.css',
192 + array( 'os-dock' ),
193 + $built_version( 'assets/css/dock-taskbar.css' )
194 + );
195 + wp_register_style(
196 + 'os-dock-peek',
197 + OPENSTATION_URL . 'assets/css/dock-peek.css',
198 + array( 'os-dock' ),
199 + $built_version( 'assets/css/dock-peek.css' )
200 + );
201 + // The phone layer. Every rule is scoped to
202 + // `html[data-os-mode="mobile"]`, so the sheet is inert on a
203 + // desktop and the first paint on a phone is already right (the
204 + // head stamp writes the attribute before any stylesheet applies).
205 + // Depends on the dock and window sheets because it overrides them.
206 + wp_register_style(
207 + 'os-mobile',
208 + OPENSTATION_URL . 'assets/css/mobile.css',
209 + array( 'os-variables', 'dashicons', 'os-dock', 'os-windows' ),
210 + $built_version( 'assets/css/mobile.css' )
211 + );
212 + // The workspace wizard. Scoped to `.os-workspace-wizard`, so it is
213 + // inert until the user opens it from the overview bar's `+` or a
214 + // tile's Edit. Those controls are styled with the rest of the bar
215 + // in `window-overview.css`.
216 + wp_register_style(
217 + 'os-workspaces',
218 + OPENSTATION_URL . 'assets/css/workspaces.css',
219 + array( 'os-variables', 'dashicons' ),
220 + $built_version( 'assets/css/workspaces.css' )
221 + );
222 + // Keyboard-shortcuts window. Scoped to `.os-shortcuts`, so it is
223 + // inert until the System menu opens the window, and unconditional
224 + // for the same reason the layout sheet is: the window can be
225 + // opened at any moment and a deferred sheet would paint it raw.
226 + wp_register_style(
227 + 'os-shortcuts',
228 + OPENSTATION_URL . 'assets/css/shortcuts.css',
229 + array( 'os-variables' ),
230 + $built_version( 'assets/css/shortcuts.css' )
231 + );
232 + // The OpenStation desktop layout — the core/plugin seam on the rail
233 + // plus the constellation hover-submenu flyout. Both surfaces are
234 + // scoped (`[data-os-layout="openstation"]` / `.os-constellation`),
235 + // so the sheet is inert in every other layout and is loaded
236 + // unconditionally rather than gated on the user's current pick:
237 + // the layout is switchable live from OpenStation Preferences, and a
238 + // conditional enqueue would leave the first switch unstyled.
239 + wp_register_style(
240 + 'os-openstation-layout',
241 + OPENSTATION_URL . 'assets/css/openstation-layout.css',
242 + array( 'os-dock' ),
243 + $built_version( 'assets/css/openstation-layout.css' )
244 + );
83 245 // `filemtime`-stamped — the chromeless overrides iterate faster
84 246 // than the plugin-wide version bumps (per-page compat shims and
85 247 // page-title-action exceptions land in patches), and a stale
86 248 // cached copy means the user sees yesterday's rules. Without the
@@ -86,11 +248,11 @@
86 248 // cached copy means the user sees yesterday's rules. Without the
87 249 // stamp, the browser keeps `?ver=0.8.1` valid for the whole
88 250 // release cycle.
89 251 wp_register_style(
90 - 'desktop-mode-chromeless',
91 - DESKTOP_MODE_URL . 'assets/css/chromeless.css',
92 - array( 'desktop-mode' ),
252 + 'os-chromeless',
253 + OPENSTATION_URL . 'assets/css/chromeless.css',
254 + array( 'openstation' ),
93 255 $built_version( 'assets/css/chromeless.css' )
94 256 );
95 257
96 258 // `filemtime`-stamped — the AI assistant surface (error states,
@@ -99,71 +261,94 @@
99 261 // valid for the whole release cycle and the user keeps seeing
100 262 // yesterday's CSS even after a hard reload.
101 263 wp_register_style(
102 264 'desktop-mode-ai-assistant',
103 - DESKTOP_MODE_URL . 'assets/css/ai-assistant.css',
104 - array( 'desktop-mode-variables' ),
265 + OPENSTATION_URL . 'assets/css/ai-assistant.css',
266 + array( 'os-variables' ),
105 267 $built_version( 'assets/css/ai-assistant.css' )
106 268 );
107 269
108 270 wp_register_style(
109 271 'desktop-mode-bug-report',
110 - DESKTOP_MODE_URL . 'assets/css/bug-report.css',
111 - array( 'desktop-mode-variables' ),
112 - $version
272 + OPENSTATION_URL . 'assets/css/bug-report.css',
273 + array( 'os-variables' ),
274 + $built_version( 'assets/css/bug-report.css' )
113 275 );
114 276
115 277 // `filemtime` instead of the plugin-wide `$version` for the
116 278 // recycle-bin CSS — this file iterates faster than the bundle
117 279 // and we never want a stale CSS cache to mask a real fix.
118 - $recycle_bin_css = DESKTOP_MODE_DIR . 'assets/css/recycle-bin.css';
280 + $recycle_bin_css = OPENSTATION_DIR . 'assets/css/recycle-bin.css';
119 281 wp_register_style(
120 282 'desktop-mode-recycle-bin',
121 - DESKTOP_MODE_URL . 'assets/css/recycle-bin.css',
122 - array( 'desktop-mode-variables', 'dashicons' ),
283 + OPENSTATION_URL . 'assets/css/recycle-bin.css',
284 + array( 'os-variables', 'dashicons' ),
123 285 file_exists( $recycle_bin_css ) ? (string) filemtime( $recycle_bin_css ) : $version
124 286 );
125 287
126 - // `filemtime` for the native Posts window CSS — same rationale as
127 - // the recycle-bin CSS: bundle iterates faster than the plugin
128 - // version and stale caches are worse than the cost of a 304.
129 - $posts_window_css = DESKTOP_MODE_DIR . 'assets/css/posts-window.css';
288 + // Files-on-the-Desktop tile + layer styles. `filemtime` for the
289 + // same reason as the recycle-bin CSS: this file
290 + // iterates faster than the plugin version, and a stale cache
291 + // would mask a real fix.
292 + $desktop_files_css = OPENSTATION_DIR . 'assets/css/desktop-files.css';
130 293 wp_register_style(
131 - 'desktop-mode-posts-window',
132 - DESKTOP_MODE_URL . 'assets/css/posts-window.css',
133 - array( 'desktop-mode-variables', 'dashicons' ),
134 - file_exists( $posts_window_css ) ? (string) filemtime( $posts_window_css ) : $version
294 + 'os-files',
295 + OPENSTATION_URL . 'assets/css/desktop-files.css',
296 + array( 'os-variables', 'dashicons' ),
297 + file_exists( $desktop_files_css ) ? (string) filemtime( $desktop_files_css ) : $version
135 298 );
136 299
137 - // Native Plugins window CSS — same `filemtime`-cache-bust posture
138 - // as the Posts/Recycle Bin styles.
139 - $plugins_window_css = DESKTOP_MODE_DIR . 'assets/css/plugins-window.css';
300 + // Games hub window (launcher grid, scoreboard, challenges) +
301 + // per-game styles. Same `filemtime` cache-bust posture as the
302 + // other fast-iterating feature stylesheets.
303 + $games_css = OPENSTATION_DIR . 'assets/css/games.css';
140 304 wp_register_style(
141 - 'desktop-mode-plugins-window',
142 - DESKTOP_MODE_URL . 'assets/css/plugins-window.css',
143 - array( 'desktop-mode-variables', 'dashicons' ),
144 - file_exists( $plugins_window_css ) ? (string) filemtime( $plugins_window_css ) : $version
305 + 'desktop-mode-games',
306 + OPENSTATION_URL . 'assets/css/games.css',
307 + array( 'os-variables', 'dashicons' ),
308 + file_exists( $games_css ) ? (string) filemtime( $games_css ) : $version
145 309 );
310 + $game_inkfall_css = OPENSTATION_DIR . 'assets/css/game-inkfall.css';
311 + wp_register_style(
312 + 'os-game-inkfall',
313 + OPENSTATION_URL . 'assets/css/game-inkfall.css',
314 + array( 'os-variables' ),
315 + file_exists( $game_inkfall_css ) ? (string) filemtime( $game_inkfall_css ) : $version
316 + );
317 + $game_alphabet_soup_css = OPENSTATION_DIR . 'assets/css/game-alphabet-soup.css';
318 + wp_register_style(
319 + 'os-game-alphabet-soup',
320 + OPENSTATION_URL . 'assets/css/game-alphabet-soup.css',
321 + array( 'os-variables' ),
322 + file_exists( $game_alphabet_soup_css ) ? (string) filemtime( $game_alphabet_soup_css ) : $version
323 + );
146 324
147 - // Native Comments window CSS — same `filemtime` posture.
148 - $comments_window_css = DESKTOP_MODE_DIR . 'assets/css/comments-window.css';
325 + // Pinned-notes layer styles (paper, pushpin, pastel tokens, pin
326 + // animations). Same `filemtime` cache-bust posture as the other
327 + // fast-iterating feature stylesheets above. Depends on `os-files`
328 + // because a pinned note dresses the canonical `.os-file-tile`
329 + // chrome — anything that restyles a tile has to print after the
330 + // file that declares one.
331 + $notes_css = OPENSTATION_DIR . 'assets/css/notes.css';
149 332 wp_register_style(
150 - 'desktop-mode-comments-window',
151 - DESKTOP_MODE_URL . 'assets/css/comments-window.css',
152 - array( 'desktop-mode-variables', 'dashicons' ),
153 - file_exists( $comments_window_css ) ? (string) filemtime( $comments_window_css ) : $version
333 + 'os-notes',
334 + OPENSTATION_URL . 'assets/css/notes.css',
335 + array( 'os-variables', 'dashicons', 'os-files' ),
336 + file_exists( $notes_css ) ? (string) filemtime( $notes_css ) : $version
154 337 );
155 338
156 - // Files-on-the-Desktop tile + layer styles. `filemtime` for the
157 - // same reason as the recycle-bin / posts-window CSS: this file
158 - // iterates faster than the plugin version, and a stale cache
159 - // would mask a real fix.
160 - $desktop_files_css = DESKTOP_MODE_DIR . 'assets/css/desktop-files.css';
339 + // Announcement-dialog styles (scrim, hero card, buttons). Registered
340 + // always, enqueued only for a user who is actually owed the
341 + // announcement — see the gate in `openstation_enqueue_assets()`. It
342 + // is not lazy-loaded on top of that: on the one boot where it does
343 + // go out, the dialog opens from the main bundle a second later, and
344 + // a fetch racing that would show an unstyled card.
345 + $announce_css = OPENSTATION_DIR . 'assets/css/announce.css';
161 346 wp_register_style(
162 - 'desktop-mode-files',
163 - DESKTOP_MODE_URL . 'assets/css/desktop-files.css',
164 - array( 'desktop-mode-variables', 'dashicons' ),
165 - file_exists( $desktop_files_css ) ? (string) filemtime( $desktop_files_css ) : $version
347 + 'os-announce',
348 + OPENSTATION_URL . 'assets/css/announce.css',
349 + array( 'os-variables' ),
350 + file_exists( $announce_css ) ? (string) filemtime( $announce_css ) : $version
166 351 );
167 352
168 353 // Scripts.
169 354 //
@@ -174,10 +359,10 @@
174 359 // lookups. Both handles are core-shipped but only pre-enqueued
175 360 // when Gutenberg-adjacent deps pull them in, so we list them
176 361 // explicitly to guarantee load order.
177 362 wp_register_script(
178 - 'desktop-mode',
179 - DESKTOP_MODE_URL . 'assets/js/desktop' . $suffix . '.js',
363 + 'openstation',
364 + OPENSTATION_URL . 'assets/js/desktop' . $suffix . '.js',
180 365 // `heartbeat` + `jquery` — the recycle-bin badge module
181 366 // (loaded as part of this bundle) opts into the WordPress
182 367 // Heartbeat API so the count tile / desktop-icon badge
183 368 // stays in sync even when the bin window is closed.
@@ -182,13 +367,24 @@
182 367 // Heartbeat API so the count tile / desktop-icon badge
183 368 // stays in sync even when the bin window is closed.
184 369 array( 'wp-hooks', 'wp-i18n', 'heartbeat', 'jquery' ),
185 370 $built_version( 'assets/js/desktop' . $suffix . '.js' ),
186 - true
371 + // Footer + defer: the shell boots on DOMContentLoaded anyway,
372 + // so deferring frees the parser instead of blocking at the
373 + // footer print point. Both inline payloads attached to this
374 + // handle (`__openStationMenuCommands`, the jazz-quote version
375 + // stamp) are `'before'`-position, which WP keeps as blocking
376 + // inline ahead of a deferred tag — order is preserved. On WP
377 + // < 6.3 the array collapses to a truthy `$in_footer`, same as
378 + // before.
379 + array(
380 + 'in_footer' => true,
381 + 'strategy' => 'defer',
382 + )
187 383 );
188 384
189 - // `desktop-mode-iframe-bridge` — opt-in iframe-side bridge that
190 - // provides `wp.desktop.iframe.publish/subscribe/onConnection/
385 + // `os-iframe-bridge` — opt-in iframe-side bridge that
386 + // provides `wp.os.iframe.publish/subscribe/onConnection/
191 387 // requestConnection` to any same-origin iframe that enqueues it.
192 388 // Same code is also injected inline by the chromeless bridge
193 389 // (so chromeless wp-admin pages don't need a separate enqueue)
194 390 // and auto-injected when a native window opts in via
@@ -194,19 +390,60 @@
194 390 // and auto-injected when a native window opts in via
195 391 // `iframeContent: { bridge: true }`. Plugins targeting their
196 392 // own iframe pages just enqueue this handle.
197 393 wp_register_script(
198 - 'desktop-mode-iframe-bridge',
199 - DESKTOP_MODE_URL . 'assets/js/iframe-bridge' . $suffix . '.js',
394 + 'os-iframe-bridge',
395 + OPENSTATION_URL . 'assets/js/iframe-bridge' . $suffix . '.js',
200 396 array(),
201 397 $built_version( 'assets/js/iframe-bridge' . $suffix . '.js' ),
202 398 true
203 399 );
204 400
205 - // `desktop-mode-gutenberg-drop-receiver` — iframe-side bundle
401 + // `os-deactivation-feedback` — the dialog that asks one optional
402 + // question when an admin deactivates OpenStation. Enqueued on
403 + // `plugins.php` (classic, chromeless and network admin) by
404 + // `includes/feedback/deactivation.php`, and lazy-loaded by the
405 + // native Plugins app from its config block. Plain DOM on purpose:
406 + // the classic screen has no `<os-*>` kit.
407 + wp_register_script(
408 + 'os-deactivation-feedback',
409 + OPENSTATION_URL . 'assets/js/deactivation-feedback' . $suffix . '.js',
410 + array( 'wp-i18n' ),
411 + $built_version( 'assets/js/deactivation-feedback' . $suffix . '.js' ),
412 + true
413 + );
414 + wp_set_script_translations(
415 + 'os-deactivation-feedback',
416 + 'desktop-mode',
417 + OPENSTATION_DIR . 'languages'
418 + );
419 + $feedback_css = OPENSTATION_DIR . 'assets/css/deactivation-feedback.css';
420 + wp_register_style(
421 + 'os-deactivation-feedback',
422 + OPENSTATION_URL . 'assets/css/deactivation-feedback.css',
423 + array(),
424 + file_exists( $feedback_css ) ? (string) filemtime( $feedback_css ) : $version
425 + );
426 +
427 + // `os-chromeless-bridge` — the iframe side of every window,
428 + // enqueued on `admin_footer` by
429 + // `openstation_chromeless_bridge_script()` with its per-request
430 + // data attached as a `before` inline block. Registered here (not
431 + // there) so the handle exists before the enqueue and so the asset
432 + // guard's OPENSTATION_URL snapshot protects it like every other
433 + // bundle of ours.
434 + wp_register_script(
435 + 'os-chromeless-bridge',
436 + OPENSTATION_URL . 'assets/js/chromeless-bridge' . $suffix . '.js',
437 + array(),
438 + $built_version( 'assets/js/chromeless-bridge' . $suffix . '.js' ),
439 + true
440 + );
441 +
442 + // `os-gutenberg-drop-receiver` — iframe-side bundle
206 443 // enqueued only on the Block Editor screens (`post.php` /
207 - // `post-new.php`) for desktop-mode users. Listens for
208 - // `desktop-mode-drop` postMessages from the parent shell (see
444 + // `post-new.php`) for openstation users. Listens for
445 + // `os-drop` postMessages from the parent shell (see
209 446 // `src/drag/iframe-drop-targets.ts`) and inserts the matching
210 447 // Gutenberg block via `wp.data.dispatch('core/block-editor')`.
211 448 // Depends on `wp-blocks` + `wp-data` so the editor stores are
212 449 // guaranteed enqueued before the receiver runs its first message
@@ -211,120 +448,124 @@
211 448 // Depends on `wp-blocks` + `wp-data` so the editor stores are
212 449 // guaranteed enqueued before the receiver runs its first message
213 450 // handler.
214 451 wp_register_script(
215 - 'desktop-mode-gutenberg-drop-receiver',
216 - DESKTOP_MODE_URL . 'assets/js/gutenberg-drop-receiver' . $suffix . '.js',
452 + 'os-gutenberg-drop-receiver',
453 + OPENSTATION_URL . 'assets/js/gutenberg-drop-receiver' . $suffix . '.js',
217 454 array( 'wp-blocks', 'wp-data' ),
218 455 $built_version( 'assets/js/gutenberg-drop-receiver' . $suffix . '.js' ),
219 456 true
220 457 );
221 458
222 - // `desktop-mode-recycle-bin` — small bundle for the Recycle Bin
223 - // native window. Lazy-loaded by the native-window sync the first
224 - // time the bin opens; registers a render callback on
225 - // `window.desktopModeNativeWindows['desktop-mode-recycle-bin']`.
226 - $recycle_bin_js = DESKTOP_MODE_DIR . 'assets/js/recycle-bin' . $suffix . '.js';
459 + // The Recycle Bin window is an App Framework app (`apps/trash/`);
460 + // its client view rides the app-bundle pipeline, so no dedicated
461 + // script handle. The `desktop-mode-recycle-bin` STYLE handle above
462 + // stays — the drag-to-trash drop-target highlight must be present
463 + // at boot (dropping on the closed bin's dock tile), not window-open.
464 +
465 + // `desktop-mode-games` — bundle for the Games hub native window
466 + // (launcher grid, scoreboard, challenges client). Lazy-loaded by
467 + // the native-window sync the first time the hub opens; registers a
468 + // render callback on
469 + // `window.openStationNativeWindows['desktop-mode-games']`.
470 + // `heartbeat` + `jquery` — the challenges client rides the
471 + // WordPress Heartbeat bus for live delivery.
472 + $games_js = OPENSTATION_DIR . 'assets/js/games' . $suffix . '.js';
227 473 wp_register_script(
228 - 'desktop-mode-recycle-bin',
229 - DESKTOP_MODE_URL . 'assets/js/recycle-bin' . $suffix . '.js',
230 - // `heartbeat` + `jquery` — the bin opts in to the WordPress
231 - // Heartbeat API while its window is open as the catch-all
232 - // real-time channel for deletes that don't render an admin
233 - // footer (REST/AJAX/other tabs/WP-CLI). See
234 - // `src/recycle-bin/realtime.ts` for the subscriber.
474 + 'desktop-mode-games',
475 + OPENSTATION_URL . 'assets/js/games' . $suffix . '.js',
235 476 array( 'wp-i18n', 'heartbeat', 'jquery' ),
236 - file_exists( $recycle_bin_js ) ? (string) filemtime( $recycle_bin_js ) : $version,
477 + file_exists( $games_js ) ? (string) filemtime( $games_js ) : $version,
237 478 true
238 479 );
239 480 wp_set_script_translations(
240 - 'desktop-mode-recycle-bin',
481 + 'desktop-mode-games',
241 482 'desktop-mode',
242 - DESKTOP_MODE_DIR . 'languages'
483 + OPENSTATION_DIR . 'languages'
243 484 );
244 485
245 - // `desktop-mode-posts-window` — small bundle for the native Posts
246 - // window. Lazy-loaded by the native-window sync the first time the
247 - // window opens (via the dock-click swap when the user opts in);
248 - // registers a render callback on
249 - // `window.desktopModeNativeWindows['desktop-mode-posts']`.
250 - $posts_window_js = DESKTOP_MODE_DIR . 'assets/js/posts-window' . $suffix . '.js';
486 + // `os-game-inkfall` — the Inkfall game bundle. Loaded
487 + // lazily by the games framework on first launch; publishes the
488 + // game def on `window.openStationGames.inkfall`.
489 + $game_inkfall_js = OPENSTATION_DIR . 'assets/js/game-inkfall' . $suffix . '.js';
251 490 wp_register_script(
252 - 'desktop-mode-posts-window',
253 - DESKTOP_MODE_URL . 'assets/js/posts-window' . $suffix . '.js',
491 + 'os-game-inkfall',
492 + OPENSTATION_URL . 'assets/js/game-inkfall' . $suffix . '.js',
254 493 array( 'wp-i18n' ),
255 - file_exists( $posts_window_js ) ? (string) filemtime( $posts_window_js ) : $version,
494 + file_exists( $game_inkfall_js ) ? (string) filemtime( $game_inkfall_js ) : $version,
256 495 true
257 496 );
258 497 wp_set_script_translations(
259 - 'desktop-mode-posts-window',
498 + 'os-game-inkfall',
260 499 'desktop-mode',
261 - DESKTOP_MODE_DIR . 'languages'
500 + OPENSTATION_DIR . 'languages'
262 501 );
263 502
264 - // `desktop-mode-plugins-window` — small bundle for the native
265 - // Plugins window. Lazy-loaded by the native-window sync the first
266 - // time the window opens (via the dock-click swap when the user
267 - // opts in); registers a render callback on
268 - // `window.desktopModeNativeWindows['desktop-mode-plugins']`.
269 - $plugins_window_js = DESKTOP_MODE_DIR . 'assets/js/plugins-window' . $suffix . '.js';
503 + // `os-game-alphabet-soup` — the Alphabet Soup game
504 + // bundle. Loaded lazily by the games framework on first launch;
505 + // publishes the game def on
506 + // `window.openStationGames['alphabet-soup']`.
507 + $game_alphabet_soup_js = OPENSTATION_DIR . 'assets/js/game-alphabet-soup' . $suffix . '.js';
270 508 wp_register_script(
271 - 'desktop-mode-plugins-window',
272 - DESKTOP_MODE_URL . 'assets/js/plugins-window' . $suffix . '.js',
509 + 'os-game-alphabet-soup',
510 + OPENSTATION_URL . 'assets/js/game-alphabet-soup' . $suffix . '.js',
273 511 array( 'wp-i18n' ),
274 - file_exists( $plugins_window_js ) ? (string) filemtime( $plugins_window_js ) : $version,
512 + file_exists( $game_alphabet_soup_js ) ? (string) filemtime( $game_alphabet_soup_js ) : $version,
275 513 true
276 514 );
277 515 wp_set_script_translations(
278 - 'desktop-mode-plugins-window',
516 + 'os-game-alphabet-soup',
279 517 'desktop-mode',
280 - DESKTOP_MODE_DIR . 'languages'
518 + OPENSTATION_DIR . 'languages'
281 519 );
282 520
283 - // `desktop-mode-comments-window` — small bundle for the native
284 - // Comments window. Lazy-loaded by the native-window sync the first
285 - // time the window opens (via the dock-click swap when the user
286 - // opts in); registers a render callback on
287 - // `window.desktopModeNativeWindows['desktop-mode-comments']`.
288 - $comments_window_js = DESKTOP_MODE_DIR . 'assets/js/comments-window' . $suffix . '.js';
289 - wp_register_script(
290 - 'desktop-mode-comments-window',
291 - DESKTOP_MODE_URL . 'assets/js/comments-window' . $suffix . '.js',
292 - array( 'wp-i18n' ),
293 - file_exists( $comments_window_js ) ? (string) filemtime( $comments_window_js ) : $version,
294 - true
295 - );
296 - wp_set_script_translations(
297 - 'desktop-mode-comments-window',
298 - 'desktop-mode',
299 - DESKTOP_MODE_DIR . 'languages'
300 - );
301 -
302 - // `desktop-mode-animated-logo-wallpaper` — built-in PixiJS canvas
303 - // wallpaper, moved out of `desktop.min.js` in 0.8.4. The wallpaper
521 + // `os-animated-logo-wallpaper` — built-in PixiJS canvas
522 + // wallpaper, moved out of `desktop.min.js`. The wallpaper
304 523 // `server-sync` loads this handle when the user selects the
305 524 // `wp-animated-logo` wallpaper (or opens OS Settings → Wallpaper
306 525 // and the picker pulls every registered canvas def in). The
307 526 // bundle's only side effect is publishing the `WallpaperDef` on
308 - // `window.desktopModeWallpapers['wp-animated-logo']`.
309 - $animated_logo_js = DESKTOP_MODE_DIR . 'assets/js/animated-logo-wallpaper' . $suffix . '.js';
527 + // `window.openStationWallpapers['wp-animated-logo']`.
528 + $animated_logo_js = OPENSTATION_DIR . 'assets/js/animated-logo-wallpaper' . $suffix . '.js';
310 529 wp_register_script(
311 - 'desktop-mode-animated-logo-wallpaper',
312 - DESKTOP_MODE_URL . 'assets/js/animated-logo-wallpaper' . $suffix . '.js',
530 + 'os-animated-logo-wallpaper',
531 + OPENSTATION_URL . 'assets/js/animated-logo-wallpaper' . $suffix . '.js',
313 532 array( 'wp-hooks' ),
314 533 file_exists( $animated_logo_js ) ? (string) filemtime( $animated_logo_js ) : $version,
315 534 true
316 535 );
317 536
537 + // `os-snow-wallpaper` — built-in PixiJS canvas
538 + // wallpaper: snowfall that accumulates on window tops and melts
539 + // away. Same lazy-load path as the animated logo: the wallpaper
540 + // `server-sync` injects this handle when the user selects the
541 + // `wp-snow` wallpaper (or opens OS Settings → Wallpaper and the
542 + // picker pulls the def in). The bundle's only side effect is
543 + // publishing the `WallpaperDef` on
544 + // `window.openStationWallpapers['wp-snow']`.
545 + $snow_js = OPENSTATION_DIR . 'assets/js/snow-wallpaper' . $suffix . '.js';
546 + wp_register_script(
547 + 'os-snow-wallpaper',
548 + OPENSTATION_URL . 'assets/js/snow-wallpaper' . $suffix . '.js',
549 + array( 'wp-hooks', 'wp-i18n' ),
550 + file_exists( $snow_js ) ? (string) filemtime( $snow_js ) : $version,
551 + true
552 + );
553 + wp_set_script_translations(
554 + 'os-snow-wallpaper',
555 + 'desktop-mode',
556 + OPENSTATION_DIR . 'languages'
557 + );
558 +
318 559 // `desktop-mode-ai-assistant` — AI Copilot spotlight overlay,
319 - // moved out of `desktop.min.js` in 0.8.4. The main bundle ships a
320 - // stub matching the public `wp.desktop.ai` contract; the stub
560 + // moved out of `desktop.min.js`. The main bundle ships a
561 + // stub matching the public `wp.os.ai` contract; the stub
321 562 // `<script>`-injects this handle the first time the user opens
322 563 // the assistant (Cmd+K or admin-bar button).
323 - $ai_assistant_js = DESKTOP_MODE_DIR . 'assets/js/ai-assistant' . $suffix . '.js';
564 + $ai_assistant_js = OPENSTATION_DIR . 'assets/js/ai-assistant' . $suffix . '.js';
324 565 wp_register_script(
325 566 'desktop-mode-ai-assistant',
326 - DESKTOP_MODE_URL . 'assets/js/ai-assistant' . $suffix . '.js',
567 + OPENSTATION_URL . 'assets/js/ai-assistant' . $suffix . '.js',
327 568 array( 'wp-hooks', 'wp-i18n' ),
328 569 file_exists( $ai_assistant_js ) ? (string) filemtime( $ai_assistant_js ) : $version,
329 570 true
330 571 );
@@ -330,19 +571,19 @@
330 571 );
331 572 wp_set_script_translations(
332 573 'desktop-mode-ai-assistant',
333 574 'desktop-mode',
334 - DESKTOP_MODE_DIR . 'languages'
575 + OPENSTATION_DIR . 'languages'
335 576 );
336 577
337 578 // Wire the translation bundle to this script handle. WP looks
338 - // for `languages/desktop-mode-{locale}-desktop-mode.json` and
579 + // for `languages/os-{locale}-os.json` and
339 580 // injects its `locale_data` into `wp.i18n` just before the
340 581 // script runs — so every `__()` call resolves to the right
341 582 // language without any runtime fetch.
342 583 wp_set_script_translations(
584 + 'openstation',
343 585 'desktop-mode',
344 - 'desktop-mode',
345 - DESKTOP_MODE_DIR . 'languages'
586 + OPENSTATION_DIR . 'languages'
346 587 );
347 588 }
348 -add_action( 'init', 'desktop_mode_register_assets' );
589 +add_action( 'init', 'openstation_register_assets' );