@vurb/core 3.2.0

package/dist/presenter/Presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Presenter.js","sourceRoot":"","sources":["../../src/presenter/Presenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,OAAO,EAAE,CAAC,EAAE,OAAO,EAAoB,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAgB,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAoB,MAAM,yCAAyC,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAoC,MAAM,mBAAmB,CAAC;AAEtF,4DAA4D;AAE5D,MAAM,eAAe,GAAG,eAAwB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACtC,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QACjB,KAA8B,CAAC,OAAO,KAAK,eAAe,CAC9D,CAAC;AACN,CAAC;AAoCD,4DAA4D;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,SAAS;IAClB,yDAAyD;IAChD,OAAO,GAAG,eAAe,CAAC;IAEnC,2DAA2D;IAClD,IAAI,CAAS;IAEd,OAAO,CAA0B;IACjC,MAAM,GAAmB,EAAE,CAAC;IAC5B,aAAa,CAAqB;IAClC,mBAAmB,CAA2B;IAC9C,eAAe,CAAuB;IACtC,WAAW,CAAoB;IAC/B,OAAO,GAAiB,EAAE,CAAC;IAC3B,OAAO,GAAG,KAAK,CAAC;IAChB,kBAAkB,CAA0B;IAC5C,iBAAiB,CAAuB;IACxC,aAAa,CAA2B;IACxC,YAAY,GAAsB,EAAE,CAAC;IAE7C,4DAA4D;IAC5D,YAAY,IAAY;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,wDAAwD;IAExD;;;;OAIG;IACK,gBAAgB;QACpB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACX,cAAc,IAAI,CAAC,IAAI,wCAAwC;gBAC/D,sDAAsD,CACzD,CAAC;QACN,CAAC;IACL,CAAC;IAsDD,gEAAgE;IAChE,8DAA8D;IAC9D,MAAM,CAAC,aAAkB;QACrB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAqC,CAAC;QAEvD,oEAAoE;QACpE,IAAI,aAAa,YAAY,OAAO,EAAE,CAAC;YACnC,QAAQ,CAAC,OAAO,GAAG,aAAa,CAAC;QACrC,CAAC;aAAM,CAAC;YACJ,0CAA0C;YAC1C,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,aAA4B,CAAC,CAAC;QAC9D,CAAC;QAED,+DAA+D;QAC/D,sEAAsE;QACtE,QAAQ,CAAC,kBAAkB,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE1E,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,WAAW,CAAC,KAA0E;QAClF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,EAAqB;QAC1B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,kBAAkB,CAAC,EAA2B;QAC1C,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,mBAAmB,GAAG,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,CAAC,GAAW,EAAE,UAA6C;QACjE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,cAAc,CAAC,EAAuB;QAClC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,wDAAwD;IAExD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,EAAuB;QAC3B,OAAO,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,KAA0E;QAC5E,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,EAAE,CAAC,EAAqB;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,yCAAyC,GAAG,WAAW,OAAO,yCAAyC;SACnH,CAAC,CAAC,CAAC;IACR,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,GAAW,EAAE,cAAkC;QACjD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,yDAAyD;IAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACH,SAAS,CACL,KAAe,EACf,MAA8C;QAE9C,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExB,MAAM,MAAM,GAAiB;YACzB,KAAK;YACL,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC5B,IAAI,CAAC,iBAAiB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAE1B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CACF,KAAe,EACf,MAA8C;QAE9C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,wDAAwD;IAExD;;;;;;;OAOG;IACH,aAAa;QACT,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAC7B,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;OAOG;IACH,cAAc;QACV,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,gBAAgB;QACZ,OAAO,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACH,eAAe;QACX,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,aAAa;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,mBAAmB;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvD,kEAAkE;QAClE,oEAAoE;QACpE,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;;;OAOG;IACH,kBAAkB;QACd,OAAO,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACH,oBAAoB;QAChB,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,wDAAwD;IAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,IAAI,CAAC,IAAa,EAAE,GAAa,EAAE,YAAuB;QACtD,wDAAwD;QACxD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEpC,oDAAoD;QACpD,IAAI,eAAoC,CAAC;QACzC,IAAI,OAAO,IAAI,IAAI,CAAC,WAAW,IAAK,IAAY,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;YAC7E,MAAM,UAAU,GAAI,IAAY,CAAC,MAAM,CAAC;YACxC,MAAM,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;YAClD,IAAI,GAAI,IAAY,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAQ,CAAC;YAC3D,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC3D,CAAC;QAED,6EAA6E;QAC7E,uEAAuE;QACvE,6DAA6D;QAC7D,MAAM,YAAY,GAAG,IAAI,CAAC;QAE1B,sDAAsD;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEhD,wDAAwD;QACxD,2DAA2D;QAC3D,2DAA2D;QAC3D,8DAA8D;QAC9D,qCAAqC;QACrC,EAAE;QACF,6DAA6D;QAC7D,qEAAqE;QAErE,wDAAwD;QACxD,MAAM,QAAQ,GAAG,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;YACtD,CAAC,CAAC,iBAAiB,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC;YACrD,CAAC,CAAC,SAAS,CAAC;QAEhB,6DAA6D;QAC7D,+DAA+D;QAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE7D,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,YAA+B,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAE9F,mEAAmE;QACnE,IAAI,eAAe,EAAE,CAAC;YAClB,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACrC,CAAC;QAED,kEAAkE;QAClE,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAEzD,uDAAuD;QACvD,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAEvD,mDAAmD;QACnD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAEpD,gEAAgE;QAChE,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAE1D,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,wDAAwD;IAExD;;;;OAIG;IACK,eAAe,CAAC,IAAa,EAAE,OAAgB;QACnD,wEAAwE;QACxE,qEAAqE;QACrE,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAChD,IAAI,CAAC,iBAAiB,GAAG,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC7D,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CACR,qBAAqB,IAAI,CAAC,IAAI,gEAAgE;oBAC9F,kGAAkG;oBAClG,yCAAyC,CAC5C,CAAC;YACN,CAAC;QACL,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC;QAEzC,IAAI,OAAO,EAAE,CAAC;YACV,OAAQ,IAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAC5B,IAAI,CAAC,iBAAkB,CAAC,IAAI,CAAM,CACrC,CAAC;QACN,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAM,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACK,SAAS,CAAC,IAAa,EAAE,OAAgB;QAC7C,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE/B,IAAI,CAAC;YACD,IAAI,OAAO,EAAE,CAAC;gBACV,OAAQ,IAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;gBAC1B,MAAM,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,eAAe,CAAC,OAAwB,EAAE,IAAa,EAAE,OAAgB,EAAE,GAAa;QAC5F,IAAI,OAAO,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAW,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAc,CAAC;YACvF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,IAAS,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAc,CAAC;YAC/E,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACK,YAAY,CAAC,OAAwB,EAAE,IAAa,EAAE,OAAgB,EAAE,GAAa;QACzF,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACpC,gDAAgD;YAChD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAE,IAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAS,CAAC;YAC1D,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC;qBACxC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;gBAC5C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC3D,CAAC;QACL,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,+BAA+B;YAC/B,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,kBAAkB,CAAC,OAAwB,EAAE,IAAa,EAAE,OAAgB,EAAE,GAAa;QAC/F,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO;QAElC,oEAAoE;QACpE,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAE,IAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAS,CAAC;QAC1D,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO;QAErC,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC1D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,OAAwB,EAAE,IAAa,EAAE,OAAgB,EAAE,GAAa;QAC3F,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEtC,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAE,IAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAS,CAAC;QAC1D,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,UAAU,KAAK,QAAQ;YAAE,OAAO;QAEvE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAI,UAAsC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtE,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI;gBAAE,SAAS;YAE9D,iDAAiD;YACjD,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC3D,MAAM,aAAa,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC;YAE3C,sDAAsD;YACtD,4DAA4D;YAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC;YACrD,CAAC;QACL,CAAC;IACL,CAAC;CACJ;AAED,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IACxC,OAAO,IAAI,SAAS,CAAU,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/presenter/PresenterValidationError.d.ts

@@ -0,0 +1,42 @@
+/**
+ * PresenterValidationError — Domain-Aware Validation Errors
+ *
+ * Wraps raw Zod validation errors with the Presenter's domain name,
+ * producing human-readable error messages that identify WHICH domain
+ * failed and WHAT fields were invalid.
+ *
+ * This is critical for DX: instead of seeing `"Expected string, received number"`,
+ * developers and LLMs see `"[Invoice Presenter] Field 'id': Expected string, received number"`.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *     InvoicePresenter.make({ id: 123 }); // ❌ invalid
+ * } catch (e) {
+ *     if (e instanceof PresenterValidationError) {
+ *         console.log(e.presenterName); // "Invoice"
+ *         console.log(e.message);       // "[Invoice Presenter] ..."
+ *         console.log(e.cause);         // Original ZodError
+ *     }
+ * }
+ * ```
+ *
+ * @module
+ */
+import { type ZodError } from 'zod';
+/**
+ * Error thrown when a Presenter's Zod schema validation fails.
+ *
+ * Provides:
+ * - `presenterName`: Which domain Presenter failed
+ * - `message`: Human-readable summary with field paths
+ * - `cause`: The original `ZodError` for programmatic access
+ *
+ * @see {@link Presenter} for where this error is thrown
+ */
+export declare class PresenterValidationError extends Error {
+    /** The domain name of the Presenter that failed validation */
+    readonly presenterName: string;
+    constructor(presenterName: string, zodError: ZodError);
+}
+//# sourceMappingURL=PresenterValidationError.d.ts.map

package/dist/presenter/PresenterValidationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenterValidationError.d.ts","sourceRoot":"","sources":["../../src/presenter/PresenterValidationError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEpC;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAC/C,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;CAiBxD"}

package/dist/presenter/PresenterValidationError.js

@@ -0,0 +1,55 @@
+/**
+ * PresenterValidationError — Domain-Aware Validation Errors
+ *
+ * Wraps raw Zod validation errors with the Presenter's domain name,
+ * producing human-readable error messages that identify WHICH domain
+ * failed and WHAT fields were invalid.
+ *
+ * This is critical for DX: instead of seeing `"Expected string, received number"`,
+ * developers and LLMs see `"[Invoice Presenter] Field 'id': Expected string, received number"`.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *     InvoicePresenter.make({ id: 123 }); // ❌ invalid
+ * } catch (e) {
+ *     if (e instanceof PresenterValidationError) {
+ *         console.log(e.presenterName); // "Invoice"
+ *         console.log(e.message);       // "[Invoice Presenter] ..."
+ *         console.log(e.cause);         // Original ZodError
+ *     }
+ * }
+ * ```
+ *
+ * @module
+ */
+import {} from 'zod';
+/**
+ * Error thrown when a Presenter's Zod schema validation fails.
+ *
+ * Provides:
+ * - `presenterName`: Which domain Presenter failed
+ * - `message`: Human-readable summary with field paths
+ * - `cause`: The original `ZodError` for programmatic access
+ *
+ * @see {@link Presenter} for where this error is thrown
+ */
+export class PresenterValidationError extends Error {
+    /** The domain name of the Presenter that failed validation */
+    presenterName;
+    constructor(presenterName, zodError) {
+        const fieldErrors = zodError.issues
+            .map(issue => {
+            const path = issue.path.length > 0
+                ? `'${issue.path.join('.')}'`
+                : '(root)';
+            return `  • ${path}: ${issue.message}`;
+        })
+            .join('\n');
+        const message = `[${presenterName} Presenter] Validation failed:\n${fieldErrors}`;
+        super(message, { cause: zodError });
+        this.name = 'PresenterValidationError';
+        this.presenterName = presenterName;
+    }
+}
+//# sourceMappingURL=PresenterValidationError.js.map

package/dist/presenter/PresenterValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenterValidationError.js","sourceRoot":"","sources":["../../src/presenter/PresenterValidationError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAiB,MAAM,KAAK,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC/C,8DAA8D;IACrD,aAAa,CAAS;IAE/B,YAAY,aAAqB,EAAE,QAAkB;QACjD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM;aAC9B,GAAG,CAAC,KAAK,CAAC,EAAE;YACT,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBAC9B,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;gBAC7B,CAAC,CAAC,QAAQ,CAAC;YACf,OAAO,OAAO,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3C,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhB,MAAM,OAAO,GACT,IAAI,aAAa,mCAAmC,WAAW,EAAE,CAAC;QAEtE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;CACJ"}

package/dist/presenter/RedactEngine.d.ts

@@ -0,0 +1,110 @@
+/**
+ * RedactEngine — DLP Compliance Engine (Zero-Leak PII Protection)
+ *
+ * Compiles object paths into V8-optimized redaction functions using
+ * `fast-redact` (the Pino logger serialization engine). Masks sensitive
+ * fields structurally before data leaves the framework.
+ *
+ * Architecture:
+ *   ┌──────────────────────────────────────────────────┐
+ *   │  Boot / .redactPII() call                       │
+ *   │                                                  │
+ *   │  ['*.ssn', 'credit_card.number']                │
+ *   │       │                                          │
+ *   │       ▼                                          │
+ *   │  fast-redact({ paths, censor, serialize: false })│
+ *   │       │                                          │
+ *   │       ▼                                          │
+ *   │  Compiled RedactFn (V8-optimized)               │
+ *   │  Applied in Presenter.make() on wireData        │
+ *   └──────────────────────────────────────────────────┘
+ *
+ * Properties:
+ * - Compiles paths into V8-optimized functions at config time
+ * - Zero overhead on hot path (pre-compiled redaction)
+ * - Wildcards supported: `'*.ssn'`, `'patients[*].diagnosis'`
+ * - Custom censor: string or function `(value) => maskedValue`
+ * - Zero-risk fallback: if `fast-redact` is not installed, logs warning
+ *   and passes data through unmodified
+ *
+ * @module
+ * @internal
+ */
+/**
+ * Configuration for PII redaction.
+ *
+ * @example
+ * ```typescript
+ * const config: RedactConfig = {
+ *     paths: ['*.ssn', 'credit_card.number', 'patients[*].diagnosis'],
+ *     censor: '[REDACTED]',
+ * };
+ * ```
+ */
+export interface RedactConfig {
+    /**
+     * Array of object paths to redact, using `fast-redact` syntax.
+     *
+     * Supports:
+     * - Dot notation: `'user.ssn'`
+     * - Bracket notation: `'user["ssn"]'`
+     * - Wildcards: `'*.ssn'`, `'patients[*].diagnosis'`
+     * - Array indices: `'items[0].secret'`
+     *
+     * @see https://github.com/davidmarkclements/fast-redact#paths--array
+     */
+    readonly paths: readonly string[];
+    /**
+     * Replacement value for redacted fields.
+     *
+     * - **String**: Static replacement (default: `'[REDACTED]'`)
+     * - **Function**: Dynamic censor `(originalValue) => maskedValue`
+     *   (e.g. `(v) => '***' + String(v).slice(-4)`)
+     *
+     * @default '[REDACTED]'
+     */
+    readonly censor?: string | ((value: unknown) => string);
+}
+/**
+ * A compiled redaction function.
+ *
+ * Applies PII masking to an object. Uses `structuredClone` internally
+ * to preserve the original data for UI blocks and rules
+ * (Late Guillotine pattern).
+ */
+export type RedactFn = (data: unknown) => unknown;
+/**
+ * Compile a redaction config into a V8-optimized redaction function.
+ *
+ * The compiled function uses `structuredClone` to avoid mutating the
+ * original data (required for Late Guillotine: UI blocks and rules
+ * need the full unmasked data).
+ *
+ * @param config - Redaction configuration (paths + optional censor)
+ * @returns A compiled `RedactFn`, or `undefined` if `fast-redact` is unavailable
+ *
+ * @example
+ * ```typescript
+ * const redact = compileRedactor({
+ *     paths: ['*.ssn', 'credit_card.number'],
+ *     censor: '[REDACTED]',
+ * });
+ *
+ * if (redact) {
+ *     const safe = redact(sensitiveData);
+ *     // safe.ssn === '[REDACTED]'
+ * }
+ * ```
+ */
+export declare function compileRedactor(config: RedactConfig): RedactFn | undefined;
+/**
+ * Pre-load the `fast-redact` module.
+ *
+ * Called during `initVurb()` boot sequence alongside other
+ * optional dependencies. Not required — the engine degrades
+ * gracefully if `fast-redact` is not installed.
+ *
+ * @returns `true` if `fast-redact` is available
+ */
+export declare function initRedactEngine(): Promise<boolean>;
+//# sourceMappingURL=RedactEngine.d.ts.map

package/dist/presenter/RedactEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedactEngine.d.ts","sourceRoot":"","sources":["../../src/presenter/RedactEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IACzB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC;CAC3D;AAED;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;AAmClD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,SAAS,CAiC1E;AAID;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAGzD"}

package/dist/presenter/RedactEngine.js

@@ -0,0 +1,128 @@
+/**
+ * RedactEngine — DLP Compliance Engine (Zero-Leak PII Protection)
+ *
+ * Compiles object paths into V8-optimized redaction functions using
+ * `fast-redact` (the Pino logger serialization engine). Masks sensitive
+ * fields structurally before data leaves the framework.
+ *
+ * Architecture:
+ *   ┌──────────────────────────────────────────────────┐
+ *   │  Boot / .redactPII() call                       │
+ *   │                                                  │
+ *   │  ['*.ssn', 'credit_card.number']                │
+ *   │       │                                          │
+ *   │       ▼                                          │
+ *   │  fast-redact({ paths, censor, serialize: false })│
+ *   │       │                                          │
+ *   │       ▼                                          │
+ *   │  Compiled RedactFn (V8-optimized)               │
+ *   │  Applied in Presenter.make() on wireData        │
+ *   └──────────────────────────────────────────────────┘
+ *
+ * Properties:
+ * - Compiles paths into V8-optimized functions at config time
+ * - Zero overhead on hot path (pre-compiled redaction)
+ * - Wildcards supported: `'*.ssn'`, `'patients[*].diagnosis'`
+ * - Custom censor: string or function `(value) => maskedValue`
+ * - Zero-risk fallback: if `fast-redact` is not installed, logs warning
+ *   and passes data through unmodified
+ *
+ * @module
+ * @internal
+ */
+let _fastRedact = null;
+async function loadFastRedact() {
+    if (_fastRedact === false)
+        return null; // already tried, not available
+    if (_fastRedact !== null)
+        return _fastRedact;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = await import('fast-redact');
+        _fastRedact = (typeof mod === 'function' ? mod : mod.default);
+        return _fastRedact;
+    }
+    catch {
+        _fastRedact = false; // mark as unavailable
+        return null;
+    }
+}
+// Synchronous version — uses the cached function if already loaded.
+function getFastRedact() {
+    if (_fastRedact === false || _fastRedact === null)
+        return null;
+    return _fastRedact;
+}
+// ── Compile Logic ────────────────────────────────────────
+/**
+ * Compile a redaction config into a V8-optimized redaction function.
+ *
+ * The compiled function uses `structuredClone` to avoid mutating the
+ * original data (required for Late Guillotine: UI blocks and rules
+ * need the full unmasked data).
+ *
+ * @param config - Redaction configuration (paths + optional censor)
+ * @returns A compiled `RedactFn`, or `undefined` if `fast-redact` is unavailable
+ *
+ * @example
+ * ```typescript
+ * const redact = compileRedactor({
+ *     paths: ['*.ssn', 'credit_card.number'],
+ *     censor: '[REDACTED]',
+ * });
+ *
+ * if (redact) {
+ *     const safe = redact(sensitiveData);
+ *     // safe.ssn === '[REDACTED]'
+ * }
+ * ```
+ */
+export function compileRedactor(config) {
+    if (!config.paths || config.paths.length === 0)
+        return undefined;
+    const factory = getFastRedact();
+    if (!factory)
+        return undefined;
+    try {
+        const redactor = factory({
+            paths: [...config.paths],
+            censor: config.censor ?? '[REDACTED]',
+            serialize: false, // mutate-in-place mode (we clone first)
+        });
+        // Return a safe function that clones → redacts → returns clone
+        return (data) => {
+            if (data === null || data === undefined || typeof data !== 'object') {
+                return data; // primitives pass through
+            }
+            try {
+                const clone = structuredClone(data);
+                redactor(clone);
+                return clone;
+            }
+            catch {
+                // Defensive: if structuredClone or redaction fails,
+                // return original data rather than crash
+                return data;
+            }
+        };
+    }
+    catch {
+        // Compilation failed (invalid paths, etc.)
+        return undefined;
+    }
+}
+// ── Async Initialization ─────────────────────────────────
+/**
+ * Pre-load the `fast-redact` module.
+ *
+ * Called during `initVurb()` boot sequence alongside other
+ * optional dependencies. Not required — the engine degrades
+ * gracefully if `fast-redact` is not installed.
+ *
+ * @returns `true` if `fast-redact` is available
+ */
+export async function initRedactEngine() {
+    const factory = await loadFastRedact();
+    return factory !== null;
+}
+//# sourceMappingURL=RedactEngine.js.map

package/dist/presenter/RedactEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedactEngine.js","sourceRoot":"","sources":["../../src/presenter/RedactEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AA0DH,IAAI,WAAW,GAAqC,IAAI,CAAC;AAEzD,KAAK,UAAU,cAAc;IACzB,IAAI,WAAW,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC,CAAC,+BAA+B;IACvE,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAE7C,IAAI,CAAC;QACD,8DAA8D;QAC9D,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC7C,WAAW,GAAG,CAAC,OAAO,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAsB,CAAC;QACnF,OAAO,WAAW,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACL,WAAW,GAAG,KAAK,CAAC,CAAC,sBAAsB;QAC3C,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,oEAAoE;AACpE,SAAS,aAAa;IAClB,IAAI,WAAW,KAAK,KAAK,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO,WAAW,CAAC;AACvB,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB;IAChD,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEjE,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC;YACrB,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAa;YACpC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,YAAY;YACrC,SAAS,EAAE,KAAK,EAAE,wCAAwC;SAC7D,CAAC,CAAC;QAEH,+DAA+D;QAC/D,OAAO,CAAC,IAAa,EAAW,EAAE;YAC9B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAClE,OAAO,IAAI,CAAC,CAAC,0BAA0B;YAC3C,CAAC;YAED,IAAI,CAAC;gBACD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;gBACpC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAChB,OAAO,KAAK,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACL,oDAAoD;gBACpD,yCAAyC;gBACzC,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACL,2CAA2C;QAC3C,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IAClC,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;IACvC,OAAO,OAAO,KAAK,IAAI,CAAC;AAC5B,CAAC"}

package/dist/presenter/ResponseBuilder.d.ts

@@ -0,0 +1,262 @@
+/**
+ * ResponseBuilder — Fluent Multi-Block Response Composer
+ *
+ * Standalone builder for composing rich, multi-content-block MCP
+ * responses. Each semantic layer (data, UI blocks, system rules,
+ * LLM hints) becomes a separate content block in the response array,
+ * following MCP's multimodal content design.
+ *
+ * Inspired by Next.js's `NextResponse` — the builder is a standalone
+ * function, keeping `ctx` pure and the response testable.
+ *
+ * @example
+ * ```typescript
+ * import { response, ui } from 'vurb';
+ *
+ * // Simple data response (equivalent to success())
+ * return response({ id: '123', amount: 4500 }).build();
+ *
+ * // Rich multi-block response
+ * return response(data)
+ *     .uiBlock(ui.echarts(chartConfig))
+ *     .llmHint('Divide amounts by 100 before displaying.')
+ *     .systemRules(['Use $ for currency', 'Emojis: ✅ Paid'])
+ *     .build();
+ * ```
+ *
+ * @see {@link response} for the factory function
+ * @see {@link Presenter} for automatic response composition
+ *
+ * @module
+ */
+import { type ToolResponse } from '../core/response.js';
+import { type UiBlock } from './ui.js';
+import { type StringifyFn } from '../core/serialization/JsonSerializer.js';
+/** A suggested next action for HATEOAS-style agent guidance */
+export interface ActionSuggestion {
+    readonly tool: string;
+    readonly reason: string;
+}
+/**
+ * Check if a value is a {@link ResponseBuilder} instance.
+ *
+ * Used by the execution pipeline to auto-call `.build()` when
+ * a handler returns a builder without explicitly calling `.build()`.
+ *
+ * @param value - Any value returned by a handler
+ * @returns `true` if the value is a ResponseBuilder
+ */
+export declare function isResponseBuilder(value: unknown): value is ResponseBuilder;
+/**
+ * Fluent builder for multi-content-block MCP responses.
+ *
+ * Each method appends a semantic layer. The final `.build()` compiles
+ * all layers into an array of `{ type: "text", text: "..." }` blocks,
+ * one per layer, following MCP's multimodal content specification.
+ *
+ * Content block order:
+ * 1. Data (JSON-serialized raw data)
+ * 2. UI Blocks (fenced code blocks from Presenter/manual)
+ * 3. Raw Blocks (merged from embedded child Presenters)
+ * 4. LLM Hints (inline directives)
+ * 5. System Rules (domain-level `[DOMAIN RULES]` block)
+ * 6. Action Suggestions (HATEOAS-style `[SYSTEM HINT]` block)
+ *
+ * @see {@link response} for the factory function
+ */
+export declare class ResponseBuilder {
+    /** @internal Brand for instanceof-free detection in the pipeline */
+    readonly __brand: "VurbResponseBuilder";
+    private readonly _data;
+    private readonly _uiBlocks;
+    private readonly _hints;
+    private readonly _rules;
+    private readonly _suggestions;
+    private readonly _rawBlocks;
+    /** @internal Use {@link response} factory instead */
+    constructor(data: string | object, compiledStringify?: StringifyFn);
+    /**
+     * Append a UI block to the response.
+     *
+     * Each UI block becomes a separate content entry in the MCP response,
+     * with a system instruction for the LLM to pass it through unchanged.
+     *
+     * Accepts either a {@link UiBlock} object (recommended) or a manual
+     * `(type, content)` pair.
+     *
+     * @returns `this` for chaining
+     *
+     * @example
+     * ```typescript
+     * // ✅ Recommended: pass a UiBlock directly
+     * response(data).uiBlock(ui.echarts(chartConfig)).build();
+     *
+     * // Also valid: manual type + content
+     * response(data).uiBlock('echarts', '```echarts\n{...}\n```').build();
+     * ```
+     */
+    uiBlock(block: UiBlock): this;
+    uiBlock(type: string, content: string): this;
+    /**
+     * Append pre-built UI blocks (from a Presenter's SSR layer).
+     *
+     * @param blocks - Array of {@link UiBlock} objects
+     * @returns `this` for chaining
+     *
+     * @internal Used by the Presenter engine
+     */
+    uiBlocks(blocks: readonly UiBlock[]): this;
+    /**
+     * Append an inline LLM hint to the response.
+     *
+     * Hints are action-specific directives that guide the LLM's
+     * behavior for this particular response. Unlike system rules,
+     * hints are typically added manually in handlers for dynamic context.
+     *
+     * @param hint - Directive text for the LLM
+     * @returns `this` for chaining
+     *
+     * @example
+     * ```typescript
+     * response(invoice)
+     *     .llmHint('This client has an overdue balance. Mention it.')
+     *     .build();
+     * ```
+     */
+    llmHint(hint: string): this;
+    /**
+     * Append domain-level system rules to the response.
+     *
+     * Rules are JIT context directives that travel with the data,
+     * eliminating the need for bloated system prompts. They are
+     * rendered as a `[DOMAIN RULES]` block in the response.
+     *
+     * @param rules - Array of rule strings
+     * @returns `this` for chaining
+     *
+     * @example
+     * ```typescript
+     * response(data)
+     *     .systemRules([
+     *         'CRITICAL: amounts are in CENTS — divide by 100.',
+     *         'Use emojis: ✅ Paid, ⚠️ Pending.',
+     *     ])
+     *     .build();
+     * ```
+     */
+    systemRules(rules: readonly string[]): this;
+    /**
+     * Append HATEOAS-style action suggestions to the response.
+     *
+     * Generates a `[SYSTEM HINT]` block with recommended next tools,
+     * guiding the AI through the business state machine.
+     *
+     * @param suggestions - Array of action suggestions
+     * @returns `this` for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.systemHint([
+     *     { tool: 'billing.pay', reason: 'Offer immediate payment' },
+     * ]);
+     * ```
+     */
+    systemHint(suggestions: readonly ActionSuggestion[]): this;
+    /**
+     * Append a raw text block to the response.
+     *
+     * Used internally by Presenter composition (`.embed()`) to merge
+     * child Presenter blocks into the parent response.
+     *
+     * @param text - Raw text content
+     * @returns `this` for chaining
+     * @internal
+     */
+    rawBlock(text: string): this;
+    /**
+     * Get the serialized data payload.
+     *
+     * Returns the JSON-stringified (or raw string) data
+     * that was passed to the constructor.
+     *
+     * @returns The data string
+     *
+     * @remarks Used by {@link PromptMessage.fromView} to decompose
+     * a Presenter view into prompt messages without calling `.build()`.
+     */
+    getData(): string;
+    /**
+     * Get the accumulated domain rules.
+     *
+     * @returns Read-only array of rule strings
+     */
+    getRules(): readonly string[];
+    /**
+     * Get the accumulated UI blocks.
+     *
+     * @returns Read-only array of UI blocks
+     */
+    getUiBlocks(): readonly UiBlock[];
+    /**
+     * Get the accumulated LLM hints.
+     *
+     * @returns Read-only array of hint strings
+     */
+    getHints(): readonly string[];
+    /**
+     * Get the accumulated action suggestions.
+     *
+     * @returns Read-only array of action suggestions
+     */
+    getSuggestions(): readonly ActionSuggestion[];
+    /**
+     * Compile all layers into a multi-block MCP `ToolResponse`.
+     *
+     * Block order:
+     * 1. **Data** — JSON-serialized raw data
+     * 2. **UI Blocks** — one content entry per UI block,
+     *    each with a `[SYSTEM]` pass-through instruction
+     * 3. **Hints** — inline LLM directives
+     * 4. **Rules** — domain-level `[DOMAIN RULES]` block
+     *
+     * @returns A valid MCP {@link ToolResponse}
+     */
+    build(): ToolResponse;
+}
+/**
+ * Create a new response builder for composing multi-block MCP responses.
+ *
+ * This is the **recommended standalone function** for building rich
+ * responses with UI blocks, LLM hints, and system rules. It keeps
+ * the handler's `ctx` pure — no framework methods injected.
+ *
+ * For simple responses, continue using {@link success} and {@link error}.
+ * Use `response()` when you need JIT context, UI blocks, or domain rules.
+ *
+ * @param data - A string message or any JSON-serializable object
+ * @returns A new {@link ResponseBuilder} for chaining
+ *
+ * @example
+ * ```typescript
+ * import { response, ui } from 'vurb';
+ *
+ * // Simple (equivalent to success())
+ * return response('Task created').build();
+ *
+ * // Rich multi-block response
+ * return response(sprintData)
+ *     .uiBlock(ui.echarts(burndownConfig))
+ *     .llmHint('Summarize the sprint progress analytically.')
+ *     .systemRules(['Use tables for task lists.'])
+ *     .build();
+ * ```
+ *
+ * @see {@link ResponseBuilder} for all available methods
+ * @see {@link Presenter} for automatic response composition
+ */
+export declare function response(data: string | object): ResponseBuilder;
+export declare namespace response {
+    var ok: (data: string | object) => ReturnType<ResponseBuilder["build"]>;
+    var withRules: (data: string | object, rules: readonly string[]) => ReturnType<ResponseBuilder["build"]>;
+}
+//# sourceMappingURL=ResponseBuilder.d.ts.map

package/dist/presenter/ResponseBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseBuilder.d.ts","sourceRoot":"","sources":["../../src/presenter/ResponseBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IACxB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,wBAA0B;IAE1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAE3C,qDAAqD;gBACzC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,iBAAiB,CAAC,EAAE,WAAW;IAMlE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAU5C;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAK1C;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAK3C;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI;IAK1D;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO5B;;;;;;;;;;OAUG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;OAIG;IACH,QAAQ,IAAI,SAAS,MAAM,EAAE;IAI7B;;;;OAIG;IACH,WAAW,IAAI,SAAS,OAAO,EAAE;IAIjC;;;;OAIG;IACH,QAAQ,IAAI,SAAS,MAAM,EAAE;IAI7B;;;;OAIG;IACH,cAAc,IAAI,SAAS,gBAAgB,EAAE;IAM7C;;;;;;;;;;;OAWG;IACH,KAAK,IAAI,YAAY;CA0DxB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,CAE/D;yBAFe,QAAQ;mBAmBQ,MAAM,GAAG,MAAM,KAAG,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;0BAsB5E,MAAM,GAAG,MAAM,SACd,SAAS,MAAM,EAAE,KACzB,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC"}