@qoretechnologies/reqraft 0.10.52 → 0.10.53-pr.121.gaf1e48a

package/.tasks/EXPORT_EXPRESSION_BUILDER.md

@@ -0,0 +1,38 @@
+# TASK — export the bare `ExpressionBuilder` from the form barrel
+
+**Status:** committed `0eea9e7`, pushed (branch `feature/119_export-expression-builder`), PR open — awaiting CI + review
+
+Issue: [toolkit-react#119](https://github.com/qoretechnologies/toolkit-react/issues/119).
+Design: [`design/IDE_INTEGRATION.md`](../design/IDE_INTEGRATION.md) (the shell-at-root / bare-builder-nested rule;
+revised note added in this task).
+
+## Why
+
+The library's own `TemplateField` renders the `ExpressionField` shell for a root field (FormEngine sets
+`allowTextExpressions`) and the bare `ExpressionBuilder` for nested operands — the June 11 "top-level
+re-wrap" decision in `FIELD_STACK_REPORT.md`. The barrel exported the shell but not the builder, so a host
+mirroring that rule (qorus-ide's `template.tsx`) had to deep-import `dist/components/form/expressions/builder`.
+
+## Surface area
+
+| File | Change |
+|---|---|
+| `src/components/form/index.tsx` | `export { ExpressionBuilder }` + `export type { IExpressionBuilderProps }` next to the shell |
+| `__tests__/formBarrelExports.test.ts` | asserts both come from the barrel — fails if the export is removed |
+| `design/IDE_INTEGRATION.md` | one-line revision under "the shell is the host's component" |
+| `package.json` | `0.10.52` → `0.10.53` (single bump) |
+
+## Phases
+
+- [x] export + type export
+- [x] unit test through `yarn test`
+- [x] `build:test:prod` green
+- [ ] `yarn precheck` (lint + unit + prod tsc)
+- [ ] **STOP — user verifies before commit** (no visual surface: nothing to click; the test is the proof)
+- [ ] `/audit`, commit, push, PR, CI, qlip (expect 0 changed snapshots)
+
+## Not this task
+
+toolkit-react#120 was filed alongside this and closed as invalid: both operand mounts have forwarded
+`expressions_url` since the port (5905e52); the symptom was qorus-ide's raw-catalogue override on its own
+legacy builder, fixed there.

package/.tasks/INDEX.md

@@ -60,6 +60,7 @@ needs phase 1.
 | [BRANCH_REMEDIATION](./BRANCH_REMEDIATION.md) | done pending user verify (uncommitted) — jest 268→356, plays 241→255, lint/tsc clean | **10th.** Burn-down of the 2026-06-10 full-branch audit: tests/stories/API/comment-voice remediation + behavior fixes (Select modal-click collapse, edge-triggered Url, ReqraftLspClient rename, CI auth wiring). Ledger: gitignored `SWEEP.local.md`. |
 | [TEMPLATE_TOKEN_GRAMMAR](./TEMPLATE_TOKEN_GRAMMAR.md) | committed `0ef167c`, in PR (branch `bugfix/template-token-grammar`) — user-verified 2026-08-27; 13/13 unit, 21/21 template plays, qlip PNGs read | **11th (bugfix).** Braced `$data:{…}` state-output refs rehydrate as raw text: canonical token grammar + strict whole-token check + TemplateField renders whole-token values as the picker chip. Twin fix applied in qorus-ide the same day; ships as a normal per-PR patch release (`0.10.37`). |
 | [EXPRESSION_FIELD_SEAMS](./EXPRESSION_FIELD_SEAMS.md) | committed `f5fb2ee`, pushed (branch `bugfix/116_expression-field-seams`) — user-verified 2026-09-07; PR not yet opened | **12th (bugfix).** The `extraActions` seam stopped one hop short of the `ExpressionField` shell hosts mount, and the builder's operand `TemplateField` mounts dropped it again — qorus-ide lost its AI-assist button on every expression card when it adopted the shell ([#116](https://github.com/qoretechnologies/toolkit-react/issues/116)). Forward it through both hops; pin with a nested-operand story; ships as a per-PR patch (`0.10.51`; re-based onto `4860e6e` after #114 published 0.10.50). |
+| [EXPORT_EXPRESSION_BUILDER](./EXPORT_EXPRESSION_BUILDER.md) | committed `0eea9e7`, pushed, PR open (branch `feature/119_export-expression-builder`) | **13th (surface fix).** The barrel exported the `ExpressionField` shell but not the bare `ExpressionBuilder`, so a host mirroring the library's root/nested rule had to deep-import `dist/…/builder` ([#119](https://github.com/qoretechnologies/toolkit-react/issues/119)). Export + a barrel test; ships as `0.10.53`. |
 
 Not yet scoped (acknowledged in the design doc): the remaining
 `ui_type` editors (`tool-catalog`, `processor-mappings`, `test-cases`,

package/design/IDE_INTEGRATION.md

@@ -40,6 +40,9 @@ checklist the IDE-integration PR ticks off so that can't happen.
   expression mounts its own builder. A seam that stops one hop short reads
   as wired and is not — which is the silent-regression class this checklist
   exists to prevent.
+  *Revised 2026-09-08:* a host that mirrors this rule needs the bare builder
+  from the barrel; it is exported next to the shell as of 0.10.53 (#119) — no
+  deep import of `dist/…/expressions/builder` required.
 - **Open product call (B4):** whether reqraft should ALSO ship a *native*
   saved-values (so non-IDE consumers get it without wiring the seam). The
   storage primitive exists (`useReqraftStorage` mirrors the IDE's

package/dist/components/form/index.d.ts

@@ -31,4 +31,6 @@ export * from './expressions/useExpressions';
 export { renderExpressionToText, useRenderExpression } from './expressions/useRenderExpression';
 export type { IRenderedExpression, IUseRenderExpressionResult, } from './expressions/useRenderExpression';
 export * from './expressions/ExpressionField';
+export { ExpressionBuilder } from './expressions/builder';
+export type { IExpressionBuilderProps } from './expressions/builder';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/form/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/form/index.tsx"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAG7C,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EACV,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/form/index.tsx"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAG7C,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EACV,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAI9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/components/form/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useRenderExpression = exports.renderExpressionToText = void 0;
+exports.ExpressionBuilder = exports.useRenderExpression = exports.renderExpressionToText = void 0;
 __exportStar(require("./fields/Field"), exports);
 __exportStar(require("./fields/allowed-values/AllowedValues"), exports);
 __exportStar(require("./fields/array/ArrayAuto"), exports);
@@ -51,4 +51,9 @@ var useRenderExpression_1 = require("./expressions/useRenderExpression");
 Object.defineProperty(exports, "renderExpressionToText", { enumerable: true, get: function () { return useRenderExpression_1.renderExpressionToText; } });
 Object.defineProperty(exports, "useRenderExpression", { enumerable: true, get: function () { return useRenderExpression_1.useRenderExpression; } });
 __exportStar(require("./expressions/ExpressionField"), exports);
+// The bare builder is public too: the library's own rule renders the shell at a
+// root field and the bare builder for nested operands, and a host that follows
+// it must be able to reach the builder without a deep import (#119).
+var builder_1 = require("./expressions/builder");
+Object.defineProperty(exports, "ExpressionBuilder", { enumerable: true, get: function () { return builder_1.ExpressionBuilder; } });
 //# sourceMappingURL=index.js.map

package/dist/components/form/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/form/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,wEAAsD;AACtD,2DAAyC;AACzC,gEAA8C;AAC9C,8DAA4C;AAC5C,8DAA4C;AAC5C,2DAAyC;AACzC,mDAAiC;AACjC,6DAA2C;AAC3C,2DAAyC;AACzC,uDAAqC;AACrC,qDAAmC;AACnC,qDAAmC;AACnC,kEAAgD;AAChD,6DAA2C;AAC3C,6EAA2D;AAC3D,yDAAuC;AACvC,yDAAuC;AACvC,kEAAgD;AAChD,8DAA4C;AAC5C,yDAAuC;AACvC,mEAAiD;AACjD,yDAAuC;AACvC,sEAAoD;AACpD,kEAAgD;AAChD,sDAAoC;AACpC,yDAAuC;AACvC,yDAAuC;AACvC,sDAAoC;AACpC,+DAA6C;AAC7C,wEAAwE;AACxE,qDAAqD;AACrD,yEAAgG;AAAvF,6HAAA,sBAAsB,OAAA;AAAE,0HAAA,mBAAmB,OAAA;AAKpD,gEAA8C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/form/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,wEAAsD;AACtD,2DAAyC;AACzC,gEAA8C;AAC9C,8DAA4C;AAC5C,8DAA4C;AAC5C,2DAAyC;AACzC,mDAAiC;AACjC,6DAA2C;AAC3C,2DAAyC;AACzC,uDAAqC;AACrC,qDAAmC;AACnC,qDAAmC;AACnC,kEAAgD;AAChD,6DAA2C;AAC3C,6EAA2D;AAC3D,yDAAuC;AACvC,yDAAuC;AACvC,kEAAgD;AAChD,8DAA4C;AAC5C,yDAAuC;AACvC,mEAAiD;AACjD,yDAAuC;AACvC,sEAAoD;AACpD,kEAAgD;AAChD,sDAAoC;AACpC,yDAAuC;AACvC,yDAAuC;AACvC,sDAAoC;AACpC,+DAA6C;AAC7C,wEAAwE;AACxE,qDAAqD;AACrD,yEAAgG;AAAvF,6HAAA,sBAAsB,OAAA;AAAE,0HAAA,mBAAmB,OAAA;AAKpD,gEAA8C;AAC9C,gFAAgF;AAChF,+EAA+E;AAC/E,qEAAqE;AACrE,iDAA0D;AAAjD,4GAAA,iBAAiB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qoretechnologies/reqraft",
-  "version": "0.10.52",
+  "version": "0.10.53-pr.121.gaf1e48a",
   "description": "ReQraft is a collection of React components and hooks that are used across Qore Technologies' products made using the ReQore component library from Qore.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/components/form/index.tsx

@@ -36,3 +36,8 @@ export type {
   IUseRenderExpressionResult,
 } from './expressions/useRenderExpression';
 export * from './expressions/ExpressionField';
+// The bare builder is public too: the library's own rule renders the shell at a
+// root field and the bare builder for nested operands, and a host that follows
+// it must be able to reach the builder without a deep import (#119).
+export { ExpressionBuilder } from './expressions/builder';
+export type { IExpressionBuilderProps } from './expressions/builder';