@ggui-ai/ui-gen 0.25.0 → 0.26.0

package/README.md

@@ -1,10 +1,10 @@
 # @ggui-ai/ui-gen
 
-UI generation harness for [ggui](https://github.com/ggui-ai/ggui) — the engine that turns a `DataContract` into a working React component.
+UI generation harness for [GGUI](https://github.com/ggui-ai/ggui) — the engine that turns a `DataContract` into a working React component.
 
 It bundles the three coupled pieces of the generation pipeline:
 
-- **System prompt** — the instructions that tell the LLM _how_ to code against the ggui design system.
+- **System prompt** — the instructions that tell the LLM _how_ to code against the GGUI design system.
 - **Coding harness** — the multi-turn loop (implement → self-check → patch → evaluate) plus provider adapters for Claude, OpenAI, and Google models.
 - **Evaluation engine** — deterministic checks and LLM-judged scoring of generated components.
 

package/dist/{adapter-Cg_rkpGq.d.ts → adapter-BJwn74rx.d.ts}

@@ -1,7 +1,7 @@
 import { RuntimeRenderCheck } from './harness/types-public.js';
 import { GenerationRuntimeProbeCheck } from '@ggui-ai/mcp-server-core';
 import { JsonObject, DataContract } from '@ggui-ai/protocol';
-import { P as ProbeHostLoad } from './types-public-BJTLpzWn.js';
+import { f as ProbeHostLoad, g as ProbePendingAffordance } from './types-public-B7wn4ce5.js';
 
 /**
  * The subprocess bounds of one isolated check (ggui#1380). They are
@@ -38,6 +38,30 @@ interface RenderCheckHostOptions {
     readonly bounds?: Partial<RenderCheckHostBounds>;
 }
 
+/**
+ * The action walk (ggui#1652): find a control that dispatches one action by
+ * walking the card's screens, as a person would, in a mount of its own.
+ *
+ * A screen is the card's set of controls, told apart by each control's tag,
+ * type, label (its aria-label, placeholder or text) and disabled state, never
+ * by typed values, selection or generated names.
+ * Picking an answer is the same screen unless it enables or disables a
+ * control; a wizard's next step, or an Edit button that now reads Save, is a
+ * new one. Each control is pressed once per screen. When every control on
+ * the current screen has been pressed, the walk returns over controls it has
+ * already pressed to the nearest screen that still has one to press. A press
+ * that leads back to a screen already seen is not progress, so Back and Next
+ * cannot loop, in any language. The walk stops at the first press that
+ * dispatches the action, when every reachable control has been pressed, at
+ * a cap on presses, or at its deadline. Neither the cap nor the deadline
+ * stops it while it is on the first screen with a control there still
+ * unpressed; once a press leaves the first screen both apply, and a
+ * first-screen control left unpressed is pressed only if a known route
+ * leads back to it (a one-way wizard has none).
+ */
+
+type WalkStop = "dispatched" | "explored" | "press-cap" | "deadline" | "no-mount";
+
 /**
  * 3-state outcome. Internal to runtime-render.
  * The adapter maps this to existing EvalIssue shapes:
@@ -88,8 +112,23 @@ interface RenderCheckIssue {
          * beside `{ primed: 0 }` or `{ error }` than beside `{ primed: 1 }`.
          */
         readonly inputPriming?: InputPrimingDiagnostic;
+        /** For action-wiring (ggui#1652): how far the walk over the card's screens got without dispatching the action. */
+        readonly walk?: ActionWalkDiagnostic;
     };
 }
+/**
+ * The action walk's account of an action it could not dispatch (ggui#1652):
+ * how many controls it pressed across how many screens, why it stopped,
+ * whether any screen rendered a control naming the action, and the last
+ * controls it pressed. Never the first button in the page.
+ */
+interface ActionWalkDiagnostic {
+    readonly presses: number;
+    readonly screens: number;
+    readonly stoppedBy: Exclude<WalkStop, "dispatched">;
+    readonly namedControlSeen: boolean;
+    readonly lastPressed: readonly string[];
+}
 /**
  * Outcome of `primeInputs` before the action-wiring probe (ggui#1187). A
  * priming failure never aborts the check — it is recorded here, on every
@@ -124,12 +163,21 @@ interface RenderCheckResult {
         readonly renderMs: number;
         /** Host load around an isolated check (absent in-process). */
         readonly hostLoad?: ProbeHostLoad;
+        /** ggui#1398: the pending-affordance walk, report-only; absent when no action walk ran. */
+        readonly pendingAffordance?: ProbePendingAffordance;
     };
 }
 interface RunRenderCheckInput {
     readonly sourceCode: string;
     readonly mockupProps: JsonObject;
     readonly contract?: DataContract;
+    /**
+     * Epoch ms by which the check must finish: set by the isolating host from
+     * its own bound, absent in-process. The report-only pending phase is
+     * skipped when less than {@link PENDING_PHASE_RESERVE_MS} remains, so it
+     * can never push a check past its bound (ggui#1398).
+     */
+    readonly deadlineAt?: number;
 }
 /**
  * Options of {@link runRenderCheck} (ggui#1380): the host's options —

package/dist/adapters/generation-dispatch.d.ts

@@ -2,17 +2,18 @@ import { EvaluationConfig } from '../evaluation/types.js';
 import { RuntimeRenderCheck } from '../harness/types-public.js';
 import { ModelRoles, GenerationResult } from '../harness/result-types.js';
 import { ProviderName, ToolDefinition } from './types.js';
-import { Q as QualityConfig } from '../types-public-BJTLpzWn.js';
-import { A as AgentConfig, V as VisionProvider } from '../llm-router-nfO7wPec.js';
+import { Q as QualityConfig, b as AgentConfig, V as VisionProvider } from '../types-public-B7wn4ce5.js';
 import { DataContract, JsonObject, GadgetDescriptor } from '@ggui-ai/protocol';
-import { C as CanvasClass, D as DesignMode } from '../design-mode-DLufhrNp.js';
-import { C as CriteriaBank } from '../bank-CT4eEkta.js';
+import { C as CanvasClass, D as DesignMode } from '../design-mode-DGWN_Gkm.js';
+import { C as CriteriaBank } from '../bank-Ctdp3FUA.js';
 import { G as GenerationProfileInput } from '../styling-profile-CxfvV48g.js';
-import { R as RenderingContext } from '../prompts-YU9piOgs.js';
+import { R as RenderingContext } from '../prompts-BhNUuRoZ.js';
 import '../axes-CKVCzR_x.js';
 import '../llm.js';
 import '../types-Dh1s4K9j.js';
 import '../policy.js';
+import '../visual-evaluator-C9L-o6ap.js';
+import 'puppeteer-core';
 import 'zod';
 import '@ggui-ai/mcp-server-core';
 
@@ -83,6 +84,8 @@ interface GenerationDispatchParams {
         /** ggui#1436 — see `SingleComponentParams.visualEvaluation.criteriaBank`. */
         criteriaBank?: CriteriaBank;
         criteriaKind?: string;
+        /** ggui#1542 — see `SingleComponentParams.visualEvaluation.actOn`. */
+        actOn?: "critical" | "major";
     };
     /** Quality config controlling eval tiers and improvement behavior */
     qualityConfig?: QualityConfig;