@adia-ai/a2ui-compose 0.4.2 → 0.4.3

package/CHANGELOG.md

@@ -12,6 +12,16 @@ generator graph.
 
 _No pending changes._
 
+## [0.4.3] - 2026-05-11
+
+### Fixed
+
+- **`process.env` browser-compat guard** — `core/generator.js` and `strategies/zettel/state-cache.js` were accessing `process.env` directly, which throws `ReferenceError: process is not defined` in browser execution paths (e.g. the gen-ui playground importing compose directly). Both sites now guard via `const IS_NODE = typeof process !== 'undefined' && process.versions?.node;` before reading `process.env`. The `A2UI_COMPOSE_TRACE` debug-trace and `STATE_CACHE_DIR` env-lookup paths are Node-only by design; the dynamic `node:fs/promises` + `node:path` imports also short-circuit when `IS_NODE` is false.
+
+### Lockstep
+
+9-package coordinated PATCH cut to v0.4.3 (per [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy)). Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). Source change scoped to `core/generator.js` + `strategies/zettel/state-cache.js`. Rides alongside `@adia-ai/web-components` v0.4.3 (input-ui locale + thousands grouping + hold-to-repeat). See root [CHANGELOG.md `## [0.4.3]`](../../../CHANGELOG.md) for the cut narrative.
+
 ## [0.4.2] - 2026-05-11
 
 ### Ride-along (no source changes)

package/README.md

@@ -14,7 +14,18 @@ ready for a renderer.
 >
 > Published to the public `@adia-ai` scope on 2026-04-24 alongside
 > `a2ui-corpus`, `a2ui-mcp`, `a2ui-retrieval`, and `a2ui-validator`.
-> Install with `npm i @adia-ai/a2ui-compose`.
+
+## Install
+
+```bash
+npm install @adia-ai/a2ui-compose
+```
+
+Typically paired with `@adia-ai/a2ui-corpus` (the pattern corpus the engine reads from) and `@adia-ai/llm` (the LLM client; runtime peer-dep):
+
+```bash
+npm install @adia-ai/a2ui-compose @adia-ai/a2ui-corpus @adia-ai/llm
+```
 
 ## What it does
 

package/core/generator.js

@@ -191,7 +191,14 @@ export async function generateUI({ intent, engine: engineName = 'monolithic', mo
   // a per-request JSON file BEFORE the strip. Useful for debugging
   // strategy-label decisions or reproducing eval failures. Off by default;
   // file writes happen synchronously and add ~1-5ms per request.
-  const traceDir = process.env.A2UI_COMPOSE_TRACE;
+  //
+  // Node-only: `process` is undefined in the browser. Guard the env lookup
+  // so the post-await codepath doesn't throw `ReferenceError: process is
+  // not defined` when generator.js runs in the gen-ui playground. The
+  // dynamic node:fs/path imports below would also fail in the browser, but
+  // the guard short-circuits before we get there.
+  const IS_NODE = typeof process !== 'undefined' && process.versions?.node;
+  const traceDir = IS_NODE ? process.env.A2UI_COMPOSE_TRACE : null;
   if (traceDir && result._debug) {
     try {
       const { writeFile, mkdir } = await import('node:fs/promises');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-compose",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "AdiaUI A2UI compose engine — framework-agnostic. Takes natural-language intents + a catalog and produces A2UI protocol messages. Pairs with `@adia-ai/a2ui-retrieval` (intent classification, catalog lookup) and `@adia-ai/a2ui-validator` (schema + semantic checks).",
   "type": "module",
   "exports": {

package/strategies/zettel/state-cache.js

@@ -27,7 +27,12 @@
 const DEFAULT_MAX_SIZE = 64;
 
 function envMaxSize() {
-  const v = process.env.A2UI_STATE_CACHE_SIZE;
+  // Node-only: `process` is undefined in the browser. Without this guard the
+  // StateCache constructor throws `ReferenceError: process is not defined`
+  // the moment the zettel engine is selected in the gen-ui playground.
+  // Matches the convention used in retrieval/* and compose/core/generator.js.
+  const IS_NODE = typeof process !== 'undefined' && process.versions?.node;
+  const v = IS_NODE ? process.env.A2UI_STATE_CACHE_SIZE : null;
   if (!v) return null;
   const n = parseInt(v, 10);
   return Number.isFinite(n) && n > 0 ? n : null;