@ggui-ai/dev-stack 0.17.0 → 0.19.0

package/dist/hub-preview/client.js

@@ -20526,6 +20526,7 @@ function useAction(actionName) {
       if (onDispatchSuppressed) {
         try {
           onDispatchSuppressed({
+            reason: "duplicate-dispatch",
             actionName,
             payloadSignature: decision.signature,
             payload: data,
@@ -20798,11 +20799,26 @@ function buildWireConfig(opts) {
     return internalSeq;
   });
   const validateEnvelope = opts.validateEnvelope ?? validateOutboundActionEnvelope;
+  const spentOneShots = /* @__PURE__ */ new Set();
   return {
     app: opts.app,
     render: opts.render,
     auth: opts.auth,
+    ...opts.onDispatchSuppressed !== void 0 ? { onDispatchSuppressed: opts.onDispatchSuppressed } : {},
     dispatch: (actionName, data) => {
+      const actionSpec = opts.getActiveActionSpec();
+      const isOneShot = actionSpec?.[actionName]?.oneShot === true;
+      if (isOneShot && spentOneShots.has(actionName)) {
+        console.warn(`[ggui] dispatch('${actionName}') suppressed: this action is declared oneShot and already fired for this render. A second gesture is NOT sent to the agent \u2014 the submitted control is spent for the render's lifetime. If the action is meant to repeat, remove \`oneShot\` from its contract entry.`);
+        opts.onDispatchSuppressed?.({
+          reason: "one-shot-spent",
+          actionName,
+          payloadSignature: payloadSignature(actionName, data),
+          payload: data,
+          suppressedAt: Date.now()
+        });
+        return;
+      }
       const envelope = buildActionEnvelope({
         sessionId: opts.render.sessionId,
         type: "data:submit",
@@ -20812,11 +20828,13 @@ function buildWireConfig(opts) {
         },
         clientSeq: nextClientSeq()
       });
-      const result = validateEnvelope(opts.getActiveActionSpec(), envelope);
+      const result = validateEnvelope(actionSpec, envelope);
       if (!result.valid) {
         opts.onViolation(new ClientContractViolationError("outbound-action", result.violations));
         return;
       }
+      if (isOneShot)
+        spentOneShots.add(actionName);
       opts.emitEnvelope(envelope);
     },
     subscribe: (channelName, handler) => {
@@ -21645,7 +21663,7 @@ function Button({ children, variant = "primary", size = "md", fullWidth, loading
     alignItems: "center",
     justifyContent: "center",
     gap: "var(--ggui-spacing-2, 8px)",
-    borderRadius: "var(--ggui-shape-radius-md, 8px)",
+    borderRadius: "var(--ggui-shape-radius-control, var(--ggui-shape-radius-md, 8px))",
     fontWeight: "var(--ggui-font-weight-medium, 500)",
     cursor: isDisabled ? "not-allowed" : "pointer",
     opacity: isDisabled ? 0.5 : 1,
@@ -21687,7 +21705,7 @@ function Input({ label, placeholder, value, onChange, type = "text", error, help
   }, children: [label, required && (0, import_jsx_runtime11.jsx)("span", { "aria-hidden": "true", style: { color: "var(--ggui-color-error-500, #ef4444)", marginLeft: "2px" }, children: "*" })] }), (0, import_jsx_runtime11.jsx)("input", { id: inputId, type, placeholder, value, onChange: (e) => onChange?.(e.target.value), disabled, required, "aria-invalid": hasError || void 0, "aria-describedby": hasMessage ? messageId : void 0, style: {
     ...sizeStyles2[size],
     width: "100%",
-    borderRadius: "var(--ggui-shape-radius-md, 8px)",
+    borderRadius: "var(--ggui-shape-radius-control, var(--ggui-shape-radius-md, 8px))",
     border: `1px solid ${hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-outline, #d4d4d8)"}`,
     backgroundColor: disabled ? "var(--ggui-color-sunken, #fafafa)" : "var(--ggui-color-sunken, #ffffff)",
     color: "var(--ggui-color-onContainer, #18181b)",
@@ -21717,7 +21735,7 @@ function TextArea({ label, placeholder, value, onChange, rows = 4, error, helper
   }, children: [label, required && (0, import_jsx_runtime12.jsx)("span", { "aria-hidden": "true", style: { color: "var(--ggui-color-error-500, #ef4444)", marginLeft: "2px" }, children: "*" })] }), (0, import_jsx_runtime12.jsx)("textarea", { id: textareaId, placeholder, value, onChange: (e) => onChange?.(e.target.value), rows, disabled, required, maxLength, "aria-invalid": hasError || void 0, "aria-describedby": hasMessage ? messageId : void 0, style: {
     padding: "10px 12px",
     width: "100%",
-    borderRadius: "var(--ggui-shape-radius-md, 8px)",
+    borderRadius: "var(--ggui-shape-radius-control, var(--ggui-shape-radius-md, 8px))",
     border: `1px solid ${hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-outline, #d4d4d8)"}`,
     backgroundColor: disabled ? "var(--ggui-color-sunken, #fafafa)" : "var(--ggui-color-sunken, #ffffff)",
     color: "var(--ggui-color-onContainer, #18181b)",
@@ -21753,7 +21771,7 @@ function Select({ label, value, onChange, options, placeholder, error, helperTex
   }, children: [label, required && (0, import_jsx_runtime13.jsx)("span", { "aria-hidden": "true", style: { color: "var(--ggui-color-error-500, #ef4444)", marginLeft: "2px" }, children: "*" })] }), (0, import_jsx_runtime13.jsxs)("select", { id: selectId, value, onChange: (e) => onChange?.(e.target.value), disabled, required, "aria-invalid": hasError || void 0, "aria-describedby": hasMessage ? messageId : void 0, style: {
     ...sizeStyles3[size],
     width: "100%",
-    borderRadius: "var(--ggui-shape-radius-md, 8px)",
+    borderRadius: "var(--ggui-shape-radius-control, var(--ggui-shape-radius-md, 8px))",
     border: `1px solid ${hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-outline, #d4d4d8)"}`,
     backgroundColor: disabled ? "var(--ggui-color-sunken, #fafafa)" : "var(--ggui-color-sunken, #ffffff)",
     color: value ? "var(--ggui-color-onContainer, #18181b)" : "var(--ggui-color-onSunken, #52525b)",
@@ -29431,6 +29449,7 @@ var consumed_tokens_manifest_default = {
     "--ggui-font-weight-normal",
     "--ggui-font-weight-semibold",
     "--ggui-letter-spacing-heading",
+    "--ggui-shape-radius-control",
     "--ggui-shape-radius-full",
     "--ggui-shape-radius-lg",
     "--ggui-shape-radius-md",
@@ -29579,6 +29598,8 @@ var NEUTRAL_T = [0.04, 0.08, 0.16, 0.28, 0.44, 0.58, 0.7, 0.8, 0.9, 0.96];
 var FAMILIES = ["primary", "tertiary", "success", "warning", "error", "info"];
 var NAMED_SPACING = { xs: "4px", sm: "8px", md: "16px", lg: "24px", xl: "32px", "2xl": "48px" };
 var SIZE_EXP = { xs: -2, sm: -1, base: 0, lg: 1, xl: 2, "2xl": 3, "3xl": 4, "4xl": 5 };
+var ROLE_STOP = { display: "4xl", h1: "3xl", h2: "2xl", body: "base", label: "xs" };
+var LAYER1_SPACING_UNIT_PX = 4;
 function tokenValue(t) {
   if (t === void 0 || t === null || typeof t !== "object" || !("$value" in t))
     return void 0;
@@ -29589,6 +29610,24 @@ function tokenValue(t) {
     return void 0;
   return /^#[0-9a-fA-F]{3,6}$/.test(v) ? `#${parseHex(v).map((n) => n.toString(16).padStart(2, "0")).join("")}` : v;
 }
+function describeFound(t) {
+  if (t === null)
+    return "null";
+  if (typeof t !== "object")
+    return `${typeof t} ${JSON.stringify(t)}`;
+  return "$value" in t ? "object with a non-string, non-number $value" : "object without $value";
+}
+var defaultDiagnostic = (d) => {
+  console.warn(`[ggui-design] theme member unreadable at ${d.path} \u2014 found ${d.found}; expected a DTCG token ({ $value }). The member was ignored and the fallback used.`);
+};
+function readToken(t, path, report) {
+  if (t === void 0)
+    return void 0;
+  const v = tokenValue(t);
+  if (v === void 0)
+    report({ kind: "member-unreadable", path, found: describeFound(t) });
+  return v;
+}
 function stated(group, key) {
   return tokenValue(group?.[key]);
 }
@@ -29649,7 +29688,15 @@ function parseSize(value) {
   const m = /^([0-9.]+)\s*(rem|px|em)$/.exec(value.trim());
   return m ? { n: Number(m[1]), unit: m[2] } : void 0;
 }
-function deriveThemeVariables(doc, mode) {
+function deriveThemeVariables(doc, mode, options = {}) {
+  const reported = /* @__PURE__ */ new Set();
+  const sink = options.onDiagnostic ?? defaultDiagnostic;
+  const report = (d) => {
+    if (reported.has(d.path))
+      return;
+    reported.add(d.path);
+    sink(d);
+  };
   const c = Object.fromEntries(Object.entries(doc.color));
   const single = (key) => tokenValue(c[key]);
   const group = (key) => c[key];
@@ -29729,19 +29776,60 @@ function deriveThemeVariables(doc, mode) {
   for (const lh of Object.keys(lineHeight))
     V[`--ggui-font-lineHeight-${lh}`] = String(lineHeight[lh]);
   const ramp = doc.font.ramp;
-  const base = ramp ? parseSize(tokenValue(ramp.base) ?? "") : void 0;
-  const ratio = ramp ? Number(tokenValue(ramp.ratio)) : NaN;
+  const base = ramp ? parseSize(readToken(ramp.base, "font.ramp.base", report) ?? "") : void 0;
+  const ratio = ramp ? Number(readToken(ramp.ratio, "font.ramp.ratio", report)) : NaN;
   for (const [stop, exp] of Object.entries(SIZE_EXP)) {
     V[`--ggui-font-size-${stop}`] = base && Number.isFinite(ratio) && ratio > 0 ? `${Math.round(base.n * ratio ** exp * 1e3) / 1e3}${base.unit}` : fontSize[stop];
   }
+  const typeScale = doc.typeScale;
+  if (typeScale !== void 0) {
+    const bodySize = parseSize(readToken(typeScale.body?.size, "typeScale.body.size", report) ?? "");
+    if (bodySize !== void 0) {
+      const r = Number.isFinite(ratio) && ratio > 0 ? ratio : 1.25;
+      for (const [stop, exp] of Object.entries(SIZE_EXP)) {
+        V[`--ggui-font-size-${stop}`] = `${Math.round(bodySize.n * r ** exp * 1e3) / 1e3}${bodySize.unit}`;
+      }
+    }
+    for (const [role, stop] of Object.entries(ROLE_STOP)) {
+      const size = readToken(typeScale[role]?.size, `typeScale.${role}.size`, report);
+      if (size !== void 0)
+        V[`--ggui-font-size-${stop}`] = size;
+    }
+    const headingWeight = readToken(typeScale.h1?.weight, "typeScale.h1.weight", report);
+    if (headingWeight !== void 0)
+      V["--ggui-font-weight-heading"] = headingWeight;
+    const bodyWeight = readToken(typeScale.body?.weight, "typeScale.body.weight", report);
+    if (bodyWeight !== void 0)
+      V["--ggui-font-weight-normal"] = bodyWeight;
+    const headingTracking = readToken(typeScale.h1?.tracking, "typeScale.h1.tracking", report);
+    if (headingTracking !== void 0)
+      V["--ggui-letter-spacing-heading"] = headingTracking;
+    const bodyTracking = readToken(typeScale.body?.tracking, "typeScale.body.tracking", report);
+    if (bodyTracking !== void 0)
+      V["--ggui-letter-spacing-body"] = bodyTracking;
+    const bodyLeading = readToken(typeScale.body?.leading, "typeScale.body.leading", report);
+    if (bodyLeading !== void 0)
+      V["--ggui-font-lineHeight-normal"] = bodyLeading;
+  }
   const sp = doc.spacing;
+  const rhythmBase = doc.rhythm ? parseSize(readToken(doc.rhythm.base, "rhythm.base", report) ?? "") : void 0;
+  const onRhythm = (layer1) => {
+    if (rhythmBase === void 0)
+      return void 0;
+    const step = parseSize(layer1);
+    if (step === void 0)
+      return void 0;
+    const scaled = step.n / LAYER1_SPACING_UNIT_PX * rhythmBase.n;
+    return `${Math.round(scaled * 1e3) / 1e3}${rhythmBase.unit}`;
+  };
   for (const [key, value] of Object.entries(spacing))
-    V[`--ggui-spacing-${key}`] = stated(sp, key) ?? String(value);
+    V[`--ggui-spacing-${key}`] = onRhythm(String(value)) ?? stated(sp, key) ?? String(value);
   for (const [key, value] of Object.entries(NAMED_SPACING))
-    V[`--ggui-spacing-${key}`] = stated(sp, key) ?? value;
+    V[`--ggui-spacing-${key}`] = onRhythm(value) ?? stated(sp, key) ?? value;
   const rad = doc.shape?.radius;
   for (const [key, value] of Object.entries(radius))
     V[`--ggui-shape-radius-${key}`] = stated(rad, key) ?? String(value);
+  V["--ggui-shape-radius-control"] = stated(rad, "control") ?? V["--ggui-shape-radius-md"];
   const sh = doc.shape?.shadow;
   for (const [key, value] of Object.entries(shadow))
     V[`--ggui-shape-shadow-${key}`] = stated(sh, key) ?? String(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/dev-stack",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Shared local dev engine for the ggui protocol: local UI registry discovery, compile-on-demand, filesystem watcher with SSE, and a read-only HTTP surface for dev tooling. Framework-neutral — agent runtime supervision plugs in via an adapter seam, so no agent SDK is hardcoded.",
   "keywords": [
     "ggui",
@@ -28,9 +28,9 @@
   "dependencies": {
     "chokidar": "^4.0.3",
     "esbuild": "^0.28.2",
-    "@ggui-ai/agent-runtime": "0.17.0",
-    "@ggui-ai/project-config": "0.17.0",
-    "@ggui-ai/ui-registry": "0.17.0"
+    "@ggui-ai/agent-runtime": "0.19.0",
+    "@ggui-ai/project-config": "0.19.0",
+    "@ggui-ai/ui-registry": "0.19.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -40,9 +40,9 @@
     "react-dom": "^19.0.0",
     "typescript": "^5.0.0",
     "vitest": "^3.2.6",
-    "@ggui-ai/design": "0.17.0",
-    "@ggui-ai/mcp-apps-react": "0.17.0",
-    "@ggui-ai/wire": "0.17.0"
+    "@ggui-ai/design": "0.19.0",
+    "@ggui-ai/mcp-apps-react": "0.19.0",
+    "@ggui-ai/wire": "0.19.0"
   },
   "repository": {
     "type": "git",