autokap 2.0.1 → 2.0.2

package/dist/semantic-resolver.d.ts

@@ -41,3 +41,13 @@ export declare function resolveTarget(page: Page, options: ResolveOptions): Prom
  * language subtag → base field → first non-empty map value.
  */
 export declare function localizeSemanticTarget(target: SemanticTarget, locale?: string): SemanticTarget;
+/**
+ * Emits a one-line warning when the active locale has NO entry in any of the
+ * target's `*ByLocale` maps, so the resolver is about to fall back to another
+ * language's string. This is the failure mode behind captures that pass in
+ * every language whose text was captured and fail in the ones that were only
+ * guessed (or never translated): the fallback string doesn't match the
+ * localized UI, and the CLICK/TYPE fails deep in the run instead of surfacing
+ * the real cause. Silent otherwise — no maps or a matching entry logs nothing.
+ */
+export declare function warnOnMissingLocaleEntry(target: SemanticTarget, locale?: string): void;

package/dist/web-playwright-local.d.ts

@@ -203,3 +203,4 @@ export declare class WebPlaywrightLocal implements RuntimeAdapter {
      */
     private reportClickSfxTimestamps;
 }
+export declare function describeResolveOptions(opts: ResolveOptions): string;

package/dist/web-playwright-local.js

@@ -8,7 +8,7 @@ import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { humanType, moveMouse, } from './mouse-animation.js';
-import { resolveTarget } from './semantic-resolver.js';
+import { resolveTarget, localizeSemanticTarget } from './semantic-resolver.js';
 import { logger } from './logger.js';
 import { ClipCaptureLoop } from './clip-capture-loop.js';
 import { FfmpegX11Recorder } from './ffmpeg-x11-recorder.js';
@@ -1369,18 +1369,44 @@ export class WebPlaywrightLocal {
         }
     }
 }
-function describeResolveOptions(opts) {
+export function describeResolveOptions(opts) {
     const parts = [];
     if (opts.selector)
         parts.push(`selector="${opts.selector}"`);
-    if (opts.target?.text)
-        parts.push(`text="${opts.target.text}"`);
-    if (opts.target?.role)
-        parts.push(`role="${opts.target.role}"`);
-    if (opts.target?.label)
-        parts.push(`label="${opts.target.label}"`);
-    if (opts.target?.placeholder)
-        parts.push(`placeholder="${opts.target.placeholder}"`);
+    if (opts.target) {
+        // Project the target onto the active locale so the message reports what was
+        // actually searched: the `*ByLocale` maps collapse onto their base field.
+        // Without this, a target expressed purely through `textByLocale` (no role,
+        // no plain text) rendered as the misleading "no target specified" even
+        // though a localized string was attempted — which sends debugging down the
+        // wrong path (it looks like the opcode carries no target at all).
+        const projected = localizeSemanticTarget(opts.target, opts.locale);
+        if (projected.role)
+            parts.push(`role="${projected.role}"`);
+        if (projected.text)
+            parts.push(`text="${projected.text}"`);
+        if (projected.label)
+            parts.push(`label="${projected.label}"`);
+        if (projected.placeholder)
+            parts.push(`placeholder="${projected.placeholder}"`);
+        if (projected.near)
+            parts.push(`near="${projected.near}"`);
+        if (opts.locale)
+            parts.push(`locale="${opts.locale}"`);
+        // Echo the raw locale maps so a missing or mistranslated entry for the
+        // active locale is obvious at a glance (e.g. `fr` guessed as "Nouvelle
+        // capture" when the deployed UI reads "Nouveau programme de capture").
+        const describeMap = (name, map) => {
+            const entries = Object.entries(map ?? {});
+            if (entries.length > 0) {
+                parts.push(`${name}={${entries.map(([k, v]) => `${k}:"${v}"`).join(', ')}}`);
+            }
+        };
+        describeMap('textByLocale', opts.target.textByLocale);
+        describeMap('labelByLocale', opts.target.labelByLocale);
+        describeMap('placeholderByLocale', opts.target.placeholderByLocale);
+        describeMap('nearByLocale', opts.target.nearByLocale);
+    }
     return parts.join(', ') || 'no target specified';
 }
 async function captureSurfaceMatches(page, expected) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autokap",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "AI-powered CLI tool for capturing clean screenshots of websites",
   "type": "module",
   "main": "./dist/index.js",