@geastack/core 0.1.34 → 0.1.36

package/gea_app_entry.cpp

@@ -297,24 +297,31 @@ void Application::frame(int timestampMs)
 	gea::host::runAnimationFrameCallbacks(static_cast<double>(timestampMs));
 	applicationFramePhaseSet(ApplicationFramePhase::CallbackMicrotasks);
 	generated::drainMicrotasks();
+	recordFramePhase(ApplicationFramePhase::AnimationFrameCallbacks, phaseClockUs() - startUs);
 	// The build already proves whether network services are reachable. Keep their
 	// callback pumps out of offline frame loops, while still servicing local workers.
 #if !defined(GEA_EMBEDDED_NETWORK_SERVICES_DISABLED) || !GEA_EMBEDDED_NETWORK_SERVICES_DISABLED
 	applicationFramePhaseSet(ApplicationFramePhase::WebSocketCallbacks);
+	startUs = phaseClockUs();
 	gea::host::websocket::runCallbacks();
+	recordFramePhase(ApplicationFramePhase::WebSocketCallbacks, phaseClockUs() - startUs);
 	applicationFramePhaseSet(ApplicationFramePhase::RtcCallbacks);
+	startUs = phaseClockUs();
 	gea::host::rtc::runCallbacks();
+	recordFramePhase(ApplicationFramePhase::RtcCallbacks, phaseClockUs() - startUs);
 #else
 	gea::host::workers::Context::runMainPending();
 #endif
 	applicationFramePhaseSet(ApplicationFramePhase::VideoPresentation);
+	startUs = phaseClockUs();
 	gea::host::video::presentFrames();
+	recordFramePhase(ApplicationFramePhase::VideoPresentation, phaseClockUs() - startUs);
 #if !defined(GEA_EMBEDDED_NETWORK_SERVICES_DISABLED) || !GEA_EMBEDDED_NETWORK_SERVICES_DISABLED
 	applicationFramePhaseSet(ApplicationFramePhase::HttpRequests);
+	startUs = phaseClockUs();
 	gea::host::http::runRequests();
+	recordFramePhase(ApplicationFramePhase::HttpRequests, phaseClockUs() - startUs);
 #endif
-	recordFramePhase(ApplicationFramePhase::AnimationFrameCallbacks, phaseClockUs() - startUs);
-
 	// Apply the coalesced style recompute for everything changed above, so layout
 	// and render below see final styles. Measured as its own phase: a city/theme
 	// class change near the root cascades a full-subtree recompute here, and it was

package/include/canvas.h

@@ -88,6 +88,7 @@ public:
 	// LANDSCAPE is defined (papers3), so every other target is byte-for-byte
 	// unaffected. Supports both packed grayscale and native RGB framebuffers.
 	void bindPixelsRotatedLandscape(pixel::native_t *physPixels, int logicalWidth, int logicalHeight);
+	bool isLandscapeRotated() const { return landscapeRot_; }
 #endif
 
 	pixel::native_t *pixels();

package/include/display_underlay.h

@@ -0,0 +1,33 @@
+#pragma once
+
+// A layer painted UNDER the retained UI tree, in the same flush.
+//
+// A native renderer that owns the whole screen (gea3d) cannot stream its frame
+// to the panel on its own while a UI tree is mounted: the UI's next dirty-rect
+// flush copies the framebuffer, which never held that frame, over it. Instead
+// it registers a painter here and marks the canvas dirty; the tree's refresh
+// then calls the painter for each dirty rect (clipped to it, drawing into the
+// bound canvas) before it replays the nodes, so the HUD lands on top and the
+// panel sees one composited image.
+namespace gea::framework::display
+{
+	class Underlay
+	{
+	public:
+		// Fills [x0, x1] x [y0, y1] (inclusive, screen coordinates) of
+		// Display::canvas(), honouring its current clip.
+		using Paint = void (*)(int x0, int y0, int x1, int y1, void *user);
+
+		// True when a retained UI tree is mounted and refreshes on its own, so a
+		// registered underlay will be painted. False for direct-canvas apps,
+		// which present their frames themselves.
+		static bool composited();
+		// Registers the painter for the screen area it covers; replaces any
+		// previous one. The caller marks the area dirty to have it repainted.
+		static void set(Paint paint, void *user, int x0, int y0, int x1, int y1);
+		static void clear();
+		static bool active();
+		// Paints the part of [x0, x1] x [y0, y1] the underlay covers.
+		static void paint(int x0, int y0, int x1, int y1);
+	};
+}  // namespace gea::framework::display

package/index.d.ts

@@ -270,6 +270,9 @@ export interface Style {
   bottom?: StyleLength
   zIndex?: number
   backgroundColor?: string
+  objectFit?: 'fill' | 'contain' | 'cover' | 'none' | 'scale-down'
+  /** CSS image alignment on web; embedded image fitting currently centers the image. */
+  objectPosition?: string
   color?: string
   opacity?: number
   blinkInterval?: number
@@ -655,6 +658,8 @@ export interface GeaEmbeddedImage {
   readonly height: number
   readonly frameCount: number
   readonly isAnimated: boolean
+  /** Decode deferred pixels into the shared image cache; false on failure. */
+  decode(): boolean
   play(): void
   pause(): void
   seek(frame: number): void
@@ -2156,8 +2161,9 @@ export interface PcmAudioStream {
   /** Capture and upload on the native socket worker, independently of UI callbacks. */
   pipeTo(socket: WebSocketInstance, prefix: string, suffix: string): void
   /** Decode matching PCM packets on the native receive worker; control messages still reach JS. */
-  receiveFrom(socket: WebSocketInstance, prefix: string, suffix: string): void
-  /** Read the next 40ms capture block, or an empty string if not ready. */
+  /** Startup delay defaults to 200 ms; use zero for an upstream A/V playback clock. */
+  receiveFrom(socket: WebSocketInstance, prefix: string, suffix: string, startupMs?: number): void
+  /** Read the next 20ms capture block, or an empty string if not ready. */
   readBase64(): string
   writeBase64(data: string): void
   resetPlayback(interrupted?: boolean): void

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geastack/core",
-  "version": "0.1.34",
+  "version": "0.1.36",
   "description": "GeaStack app API, reactivity headers, runtime sources, and type declarations.",
   "license": "Apache-2.0",
   "repository": {
@@ -65,8 +65,8 @@
     "@babel/types": "^7.23.0",
     "@geajs/core": "1.5.1",
     "@geajs/vite-plugin": "1.5.0",
-    "@geastack/compiler": "^1.0.20",
-    "@geastack/geatsc-plugin-gea": "^0.1.15",
+    "@geastack/compiler": "^1.0.22",
+    "@geastack/geatsc-plugin-gea": "^0.1.18",
     "opentype.js": "^2.0.0",
     "vite": "^8.0.0"
   }

package/runtime.cpp

@@ -125,9 +125,10 @@ void run_app_frame(int timestampMs, void *context)
 	if (!animationsScanned) {
 		animationsScanned = true;
 		gea::css::DeclarativeAnimations::scanAndStart(nowMs);
-		gea::embedded::ui::StyleSheet::instance().startCssAnimations(nowMs);
 	}
 
+	// Start CSS tracks added by later conditional mounts, retaining existing timelines.
+	gea::embedded::ui::StyleSheet::instance().startCssAnimations(nowMs);
 	gea::css::AnimationEngine::instance().tick(nowMs);
 	// Render-only while settings overlays the frozen application.
 	const bool refreshOnly = SettingsSurface::instance().active();

package/scripts/native-object-cache.sh

@@ -120,6 +120,14 @@ gea_native_object_rel() {
   printf '%s.%s.o\n' "$rel" "$kind"
 }
 
+gea_native_input_is_newer() {
+  # macOS Bash 3.2's builtin -nt compares whole seconds. Generated sources
+  # (especially consecutive mutations of one path) can change after an object
+  # was built within that same second. The system test preserves subsecond
+  # timestamps for sources, headers and objects that require relinking.
+  /bin/test "$1" -nt "$2"
+}
+
 gea_native_depfile_has_newer_input() {
   local depfile="$1"
   local obj="$2"
@@ -128,7 +136,7 @@ gea_native_depfile_has_newer_input() {
   while IFS= read -r dep; do
     [[ -n "$dep" ]] || continue
     dep="${dep//\\ / }"
-    if [[ -e "$dep" && "$dep" -nt "$obj" ]]; then
+    if [[ -e "$dep" ]] && gea_native_input_is_newer "$dep" "$obj"; then
       return 0
     fi
   done < <(sed -e ':again' -e '/\\$/N' -e 's/\\\n/ /' -e 'tagain' -e 's/^[^:]*: //' "$depfile" | tr ' ' '\n' | sed -e 's/\\$//' -e '/^$/d')
@@ -140,7 +148,7 @@ gea_native_needs_compile() {
   local obj="$2"
   [[ -f "$obj" ]] || return 0
   [[ -f "$obj.d" ]] || return 0
-  [[ "$src" -nt "$obj" ]] && return 0
+  gea_native_input_is_newer "$src" "$obj" && return 0
   gea_native_depfile_has_newer_input "$obj.d" "$obj" && return 0
   return 1
 }
@@ -207,7 +215,7 @@ gea_native_link_needs_rebuild() {
   [[ "$(cat "$sigFile")" == "$signature" ]] || return 0
   local obj
   for obj in "${GEA_NATIVE_OBJECTS[@]}"; do
-    [[ "$obj" -nt "$output" ]] && return 0
+    gea_native_input_is_newer "$obj" "$output" && return 0
   done
   return 1
 }