@farmslot/adapter-web 0.7.2 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@farmslot/adapter-web` are tracked here.
 
 ## Unreleased
 
+- Active-development baseline; add user-facing changes here before release or package publication.
+
+## 0.8.0 - 2026-10-13
+
+- Honor HUD top/bottom placement through automatic progress and capture the painted final outcome.
+
 ## 0.7.2 - 2026-10-12
 
 - Record web-dapp recipes through the shared recorder, selecting only the owned browser on the requested CDP port.

package/dist/web-dapp/lib/hud.d.mts

@@ -1,4 +1,5 @@
 export function nextHudState(prior: any, node?: {}, nodeId?: string): {
+    position?: any;
     seq: any;
     title: any;
     current: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/adapter-web",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "description": "Web platform adapter for Farmslot recipes: resolve and launch an isolated Chromium, own its CDP port, load unpacked extensions, and keep macOS focus.",
   "type": "commonjs",
   "exports": {
@@ -83,9 +83,9 @@
     "prepublishOnly": "node ../../scripts/quality/check-farmslot-package-readiness.mjs --publish --packages @farmslot/adapter-web"
   },
   "dependencies": {
-    "@farmslot/adapter-sdk": "0.9.1",
-    "@farmslot/protocol": "0.40.0",
-    "@farmslot/recipe-runner": "0.31.0",
+    "@farmslot/adapter-sdk": "0.10.0",
+    "@farmslot/protocol": "0.41.0",
+    "@farmslot/recipe-runner": "0.32.0",
     "ws": "^8.18.0"
   },
   "devDependencies": {

package/src/web-dapp/lib/hud.mjs

@@ -13,7 +13,13 @@
 import { readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 
-import { HUD_PANEL_BOUNDS, hudIntentDisplay, hudSecondaryText } from '@farmslot/protocol/recipe';
+import {
+  HUD_PANEL_BOUNDS,
+  hudIntentDisplay,
+  hudPlacement,
+  hudSecondaryText,
+  waitForHudPaint,
+} from '@farmslot/protocol/recipe';
 
 export const HUD_ELEMENT = 'mm-harness-hud';
 export const HUD_FILE = 'hud.json';
@@ -37,12 +43,14 @@ export function nextHudState(prior, node = {}, nodeId = '') {
   const intent =
     hudIntentDisplay(node.intent ?? node.text ?? node.detail).text || hudIntentDisplay(nodeId).text;
   const id = hudSecondaryText(node.node_id ?? node.nodeId ?? nodeId, 80);
+  const position = hudPlacement(node.display) ?? previous?.position;
   const state = {
     seq: (previous?.seq ?? 0) + 1,
     title: hudSecondaryText(node.title, 80) || previous?.title || 'Recipe run',
     current: previous?.current ?? null,
     last: previous?.last ?? null,
     finished: null,
+    ...(position ? { position } : {}),
   };
   if (status === 'running') {
     state.current = {
@@ -117,7 +125,7 @@ export function hudRenderExpression(state, appOrigin) {
     if (location.origin !== ${JSON.stringify(String(appOrigin).replace(/\/$/u, ''))}) return { hud: false, reason: 'not-app-origin' };
     const existing = document.documentElement.querySelector(':scope > ${HUD_ELEMENT}');
     if (!state) { existing?.remove(); return { hud: false, cleared: true }; }
-    if (existing && existing.dataset.seq === String(state.seq)) return { hud: true, seq: state.seq, unchanged: true };
+    if (existing && existing.dataset.seq === String(state.seq)) return (${waitForHudPaint.toString()})(requestAnimationFrame).then(() => ({ hud: true, seq: state.seq, unchanged: true }));
     existing?.remove();
     const host = document.createElement('${HUD_ELEMENT}');
     host.dataset.seq = String(state.seq);
@@ -129,6 +137,10 @@ export function hudRenderExpression(state, appOrigin) {
     const el = (tag, cls, value) => { const node = document.createElement(tag); if (cls) node.className = cls; if (value != null) node.textContent = value; return node; };
     const style = el('style', null, ${JSON.stringify(STYLE)});
     const box = el('div', 'hud');
+    if (state.position) {
+      box.style.top = state.position === 'top' ? '12px' : 'auto';
+      box.style.bottom = state.position === 'bottom' ? '12px' : 'auto';
+    }
     const intentStyle = ${JSON.stringify(hudIntentDisplay('').webStyle)};
     const head = el('div', 'row');
     head.append(el('span', 'title', state.title));
@@ -153,6 +165,6 @@ export function hudRenderExpression(state, appOrigin) {
     if (state.last && state.last.error) box.append(el('div', 'last error', state.last.error));
     root.append(style, box);
     document.documentElement.append(host);
-    return { hud: true, seq: state.seq };
+    return (${waitForHudPaint.toString()})(requestAnimationFrame).then(() => ({ hud: true, seq: state.seq }));
   })()`;
 }