aigpu 0.3.1

package/dist/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAqG,MAAM,aAAa,CAAC;AAChL,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,kBAAkB,EAAmB,MAAM,mBAAmB,CAAC;AAEpI,OAAO,EACL,iCAAiC,EACjC,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAyB,MAAM,aAAa,CAAC;AAqClE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,GAAQ,EAAE,MAAqB,EAAE,OAAuB,EAAE;IAChF,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ;QAAE,MAAM,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC1E,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,QAAQ;YAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzE,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IACH,MAAM,iBAAiB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACxF,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,wGAAwG;AACxG,MAAM,iBAAiB,GAAG,YAAY,CAAoC,UAAU,CAAC,CAAC;AACtF,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAgC,CAAC,CAAC;AAC1F,CAAC;AAED,IAAI,mBAAmB,GAAG,CAAC,CAAC;AAC5B,IAAI,UAAU,GAAG,CAAC,CAAC;AACnB,MAAM,UAAU,6BAA6B,KAAc,OAAO,mBAAmB,GAAG,CAAC,CAAC,CAAC,CAAC;AAC5F,MAAM,UAAU,aAAa,KAAc,OAAO,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;AACnE,MAAM,UAAU,UAAU,KAAW,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;AACvD,MAAM,UAAU,UAAU,KAAW,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;AACvD,MAAM,UAAU,SAAS,CAAC,MAAe,IAA6B,OAAO,MAAM,YAAY,aAAa,CAAC,CAAC,CAAC;AAE/G,MAAM,OAAO,aAAa;IAgBL;IACR;IACQ;IACA;IAlBV,gBAAgB,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;IAC3D,KAAK,CAAqB;IAC1B,OAAO,CAAmB;IAC1B,UAAU,CAAU;IACpB,YAAY,CAAU;IACtB,MAAM,CAAmB;IACzB,cAAc,GAAG,IAAI,aAAa,EAAU,CAAC;IAC7C,UAAU,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC5D,2BAA2B,GAAG,IAAI,GAAG,EAAc,CAAC;IAC7D,WAAW,CAAS;IACpB,WAAW,CAAa;IACxB,WAAW,GAAG,KAAK,CAAC;IACpB,UAAU,GAAG,KAAK,CAAC;IAEnB,YACmB,MAAc,EACtB,MAAqB,EACb,OAAuB,EACvB,UAA4C;QAH5C,WAAM,GAAN,MAAM,CAAQ;QACtB,WAAM,GAAN,MAAM,CAAe;QACb,YAAO,GAAP,OAAO,CAAgB;QACvB,eAAU,GAAV,UAAU,CAAkC;QAE7D,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;QAC1I,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAA4B,CAAC;QACvE,IAAI,CAAC,OAAO;YAAE,MAAM,mBAAmB,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,MAAM,iCAAiC,EAAE,CAAC;QACjG,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACnF,IAAI,CAAC,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,qBAAqB,EAAE,CAAC;QACxD,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5F,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY;YAAE,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC1E,OAAO,CAAC,SAAS,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC,GAAG;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,eAAe;YAC/C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,MAAM;YACxC,KAAK,EAAE,kBAAkB,EAAE;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,KAAc,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,KAAgC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7F,IAAI,SAAS,KAAgC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzG,IAAI,KAAK;QACP,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE;YAChE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,UAAU,CAAC;YAC3D,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe;SAC5E,EAAE,UAAU,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,KAAuC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,KAAK,KAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;IAChE,IAAI,WAAW,KAAQ,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACtD,IAAI,GAAG,KAAa,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9C,4FAA4F;IAC5F,IAAI,UAAU,KAAiB,OAAO,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,UAAU,CAAC,KAAiB,IAAI,IAAI,CAAC,WAAW,GAAG,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACzG,IAAI,QAAQ,KAAc,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAEpD,MAAM,CAAC,IAA+B;QACpC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,UAAU;YAAE,MAAM,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,eAAe;QACb,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QACvE,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,QAAQ,CAAC,EAAuC;QAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,mBAAmB,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC;YAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAAC,CAAC;gBAClB,CAAC;YAAC,mBAAmB,IAAI,CAAC,CAAC;YAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAAC,CAAC;QAC9D,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,IAAI,KAA0B,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACnF,KAAK,CAAC,UAAU,KAA4B,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACjG,SAAS,CAAC,EAAmC,IAAgC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAClJ,mBAAmB,CAAC,EAAc,IAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhL,oBAAoB,CAAC,OAAoC,EAAE;QACzD,+FAA+F;QAC/F,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAChD,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,UAAU,GAAiC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAChK,IAAI,CAAC,QAAQ;YAAE,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,EAAE,gBAAgB,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC;YAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,oCAAoC,CAAC,CAAC;QACpF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,2BAA2B,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,YAAY,CAAC,IAA+B,EAAE,GAAW,EAAE,MAAe;QACxE,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QACvB,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,IAAI,MAAM;YAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,sBAAsB;QACpB,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,2BAA2B,CAAC;YAAE,EAAE,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,mBAAmB,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;gBAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;gBAAS,CAAC;YACT,mBAAmB,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnF,CAAC;IAED,WAAW;QACT,IAAI,IAAI,CAAC,WAAW;YAAE,MAAM,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvE,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,OAAO,OAAQ,MAAoC,CAAC,WAAW,KAAK,QAAQ,CAAC;AAC/E,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAqB,EAAE,OAAuB,EAAE,YAAqB,EAAE,GAAW;IAC3G,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,YAAY;QAAE,OAAO,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAmB,EAAE,GAAW;IACxD,MAAM,MAAM,GAAG,UAA2D,CAAC;IAC3E,OAAO,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,SAAS,UAAU,CAAC,UAAmB;IACrC,MAAM,MAAM,GAAG,UAA+C,CAAC;IAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,aAAa,CAAC,UAAmB,EAAE,IAA+B;IACzE,MAAM,MAAM,GAAG,UAA+C,CAAC;IAC/D,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,IAA+B;IACnD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,GAA0B;IAC9C,MAAM,GAAG,GAAG,UAAU,CAAC,gBAAgB,IAAI,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACvE,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB;IAC5B,OAAQ,UAAU,CAAC,SAAqD,EAAE,GAAG,EAAE,wBAAwB,EAAE,EAAE,IAAI,YAAY,CAAC;AAC9H,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,KAAK,GAAI,UAA2D,CAAC,eAAe,CAAC;IAC3F,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9F,CAAC"}

package/dist/target-offscreen.d.ts

@@ -0,0 +1,41 @@
+import { Texture, type Device, type ResourceDestroyCallback, type ResourceIdentity, type UnsubscribeResourceDestroy } from "@aigpu/core";
+import type { RenderPassDescriptorOptions, Target, TargetOptions } from "./target.ts";
+import { type ClearColor } from "./target-utils.ts";
+import type { Gpu } from "./kernel.ts";
+/**
+ * Offscreen render target: color attachments (plus optional depth and MSAA) sized in pixels.
+ *
+ * Its textures belong to the gpu's device, so `gpu.dispose()` releases them with the device; the
+ * target is not registered as a separate kernel resource because there is nothing to tear down
+ * ahead of the device — unlike a surface, which must unconfigure its canvas context first.
+ */
+export declare function target(gpu: Gpu, opts: TargetOptions): Target;
+/** Offscreen render target. MSAA targets render into sampleCount=4 attachments and resolve into `.color`. */
+export declare class OffscreenTarget implements Target {
+    #private;
+    private readonly device;
+    private readonly options;
+    readonly resourceIdentity: ResourceIdentity;
+    constructor(device: Device, options: TargetOptions);
+    get gpu(): unknown;
+    get size(): readonly [number, number];
+    get texelSize(): readonly [number, number];
+    /** Resolved, sampleable color texture. For MSAA targets, render passes resolve into this texture. */
+    get color(): Texture;
+    /** Resolved, sampleable color textures. For MSAA targets, render passes resolve into these textures. */
+    get colors(): readonly [Texture, ...Texture[]];
+    get depth(): Texture | undefined;
+    get format(): GPUTextureFormat;
+    /** Default clear color of this target; passes that clear without naming a color use it. */
+    get clearColor(): ClearColor;
+    set clearColor(value: ClearColor);
+    get sampleCount(): 1 | 4;
+    resize(size: readonly [number, number]): void;
+    read(): Promise<Uint8Array>;
+    readFloats(): Promise<Float32Array>;
+    onDestroy(cb: ResourceDestroyCallback<Target>): UnsubscribeResourceDestroy;
+    onTexturesRecreated(cb: () => void): () => void;
+    destroy(): void;
+    renderPassDescriptor(opts?: RenderPassDescriptorOptions): GPURenderPassDescriptor;
+}
+//# sourceMappingURL=target-offscreen.d.ts.map

package/dist/target-offscreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-offscreen.d.ts","sourceRoot":"","sources":["../src/target-offscreen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAyC,KAAK,MAAM,EAAE,KAAK,uBAAuB,EAAE,KAAK,gBAAgB,EAAE,KAAK,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAChL,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,EAAE,aAAa,EAAwB,MAAM,aAAa,CAAC;AAC5G,OAAO,EAA8K,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEhO,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAE5D;AAED,6GAA6G;AAC7G,qBAAa,eAAgB,YAAW,MAAM;;IAUhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAU,OAAO,CAAC,QAAQ,CAAC,OAAO;IATrE,QAAQ,CAAC,gBAAgB,mBAA2C;gBASvC,MAAM,EAAE,MAAM,EAAmB,OAAO,EAAE,aAAa;IASpF,IAAI,GAAG,IAAI,OAAO,CAA2B;IAC7C,IAAI,IAAI,IAAI,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAA8B;IACnE,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAiE;IAC3G,qGAAqG;IACrG,IAAI,KAAK,IAAI,OAAO,CAAmC;IACvD,wGAAwG;IACxG,IAAI,MAAM,IAAI,SAAS,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAgC;IAC9E,IAAI,KAAK,IAAI,OAAO,GAAG,SAAS,CAA+B;IAC/D,IAAI,MAAM,IAAI,gBAAgB,CAAmE;IACjG,2FAA2F;IAC3F,IAAI,UAAU,IAAI,UAAU,CAA6C;IACzE,IAAI,UAAU,CAAC,KAAK,EAAE,UAAU,EAAwE;IACxG,IAAI,WAAW,IAAI,CAAC,GAAG,CAAC,CAAyC;IAEjE,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAKvC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAC3B,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IACzC,SAAS,CAAC,EAAE,EAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,0BAA0B;IAC1E,mBAAmB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAC/C,OAAO,IAAI,IAAI;IAEf,oBAAoB,CAAC,IAAI,GAAE,2BAAgC,GAAG,uBAAuB;CA0DtF"}

package/dist/target-offscreen.js

@@ -0,0 +1,115 @@
+import { createResourceIdentity, DestroySignal } from "@aigpu/core";
+import { BUILT_IN_CLEAR_COLOR, colorAttachment, copyClearColor, colorSpecsFor, depthAttachment, depthFormatFor, sampleCountFor, sameSize, validateClearColor, validateTargetOptions } from "./target-utils.js";
+import { liveKernel } from "./live-kernel.js";
+/**
+ * Offscreen render target: color attachments (plus optional depth and MSAA) sized in pixels.
+ *
+ * Its textures belong to the gpu's device, so `gpu.dispose()` releases them with the device; the
+ * target is not registered as a separate kernel resource because there is nothing to tear down
+ * ahead of the device — unlike a surface, which must unconfigure its canvas context first.
+ */
+export function target(gpu, opts) {
+    return new OffscreenTarget(liveKernel(gpu, "target").device, opts);
+}
+/** Offscreen render target. MSAA targets render into sampleCount=4 attachments and resolve into `.color`. */
+export class OffscreenTarget {
+    device;
+    options;
+    resourceIdentity = createResourceIdentity("render-target");
+    #destroySignal = new DestroySignal();
+    #texturesRecreatedCallbacks = new Set();
+    #currentSize;
+    #currentColors;
+    #currentMsaaColors;
+    #currentDepth;
+    #clearColor;
+    constructor(device, options) {
+        this.device = device;
+        this.options = options;
+        validateTargetOptions(options, device);
+        this.#clearColor = options.clearColor === undefined ? BUILT_IN_CLEAR_COLOR : validateClearColor(options.clearColor, "target.clearColor");
+        this.#currentSize = options.size;
+        this.#currentColors = this.#createResolvedColors();
+        this.#currentMsaaColors = this.sampleCount === 4 ? this.#createMsaaColors() : undefined;
+        this.#currentDepth = this.#createDepth();
+    }
+    get gpu() { return this.color.gpu; }
+    get size() { return this.#currentSize; }
+    get texelSize() { return [1 / this.#currentSize[0], 1 / this.#currentSize[1]]; }
+    /** Resolved, sampleable color texture. For MSAA targets, render passes resolve into this texture. */
+    get color() { return this.#currentColors[0]; }
+    /** Resolved, sampleable color textures. For MSAA targets, render passes resolve into these textures. */
+    get colors() { return this.#currentColors; }
+    get depth() { return this.#currentDepth; }
+    get format() { return colorSpecsFor(this.options)[0]?.format ?? "rgba8unorm"; }
+    /** Default clear color of this target; passes that clear without naming a color use it. */
+    get clearColor() { return copyClearColor(this.#clearColor); }
+    set clearColor(value) { this.#clearColor = validateClearColor(value, "target.clearColor"); }
+    get sampleCount() { return sampleCountFor(this.options); }
+    resize(size) {
+        if (sameSize(this.#currentSize, size))
+            return;
+        this.#recreateTextures(size);
+    }
+    async read() { return this.color.read(); }
+    async readFloats() { return this.color.readFloats(); }
+    onDestroy(cb) { return this.#destroySignal.onDestroy(this, cb); }
+    onTexturesRecreated(cb) { this.#texturesRecreatedCallbacks.add(cb); return () => { this.#texturesRecreatedCallbacks.delete(cb); }; }
+    destroy() { this.#destroySignal.emit(this); this.#texturesRecreatedCallbacks.clear(); this.#destroyTextures(); }
+    renderPassDescriptor(opts = {}) {
+        const { clear = [0, 0, 0, 1], preserve, clearDepth, clearStencil, depthReadOnly } = opts;
+        return {
+            colorAttachments: this.#currentColors.map((resolved, index) => colorAttachment(resolved, this.#currentMsaaColors?.[index], clear, preserve)),
+            depthStencilAttachment: this.#currentDepth ? depthAttachment(this.#currentDepth, preserve, clearDepth, clearStencil, depthReadOnly) : undefined,
+        };
+    }
+    #recreateTextures(size) {
+        this.#destroyTextures();
+        this.#currentSize = [size[0], size[1]];
+        this.#currentColors = this.#createResolvedColors();
+        this.#currentMsaaColors = this.sampleCount === 4 ? this.#createMsaaColors() : undefined;
+        this.#currentDepth = this.#createDepth();
+        this.#emitTexturesRecreated();
+    }
+    #emitTexturesRecreated() {
+        for (const cb of [...this.#texturesRecreatedCallbacks])
+            cb();
+    }
+    #destroyTextures() {
+        for (const texture of this.#currentColors)
+            texture.destroy();
+        for (const texture of this.#currentMsaaColors ?? [])
+            texture.destroy();
+        this.#currentDepth?.destroy();
+    }
+    #createResolvedColors() {
+        return colorSpecsFor(this.options).map((spec, index) => this.device.createTexture({
+            size: this.#currentSize,
+            format: spec.format,
+            usage: ["render_attachment", "texture_binding", "copy_src"],
+            sampleCount: 1,
+            label: this.options.label ? `${this.options.label}.color${index}.resolve` : undefined,
+        }));
+    }
+    #createMsaaColors() {
+        return colorSpecsFor(this.options).map((spec, index) => this.device.createTexture({
+            size: this.#currentSize,
+            format: spec.format,
+            usage: ["render_attachment"],
+            sampleCount: 4,
+            label: this.options.label ? `${this.options.label}.color${index}` : undefined,
+        }));
+    }
+    #createDepth() {
+        const format = depthFormatFor(this.options);
+        // texture_binding lets read-only depth passes bind `target.depth` as a sampled texture in the same pass.
+        return format ? this.device.createTexture({
+            size: this.#currentSize,
+            format,
+            usage: ["render_attachment", "texture_binding"],
+            sampleCount: this.sampleCount,
+            label: this.options.label ? `${this.options.label}.depth` : undefined,
+        }) : undefined;
+    }
+}
+//# sourceMappingURL=target-offscreen.js.map

package/dist/target-offscreen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-offscreen.js","sourceRoot":"","sources":["../src/target-offscreen.ts"],"names":[],"mappings":"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"}

package/dist/target-utils.d.ts

@@ -0,0 +1,37 @@
+import type { Target, TargetOptions, TargetTextureOptions } from "./target.ts";
+export declare const DEFAULT_FORMAT: GPUTextureFormat;
+export type ClearColor = GPUColor | readonly [number, number, number, number];
+/** Clear color used by a pass when neither the pass nor the target chose one. */
+export declare const BUILT_IN_CLEAR_COLOR: ClearColor;
+/**
+ * Validates a clear color on assignment (`target.clearColor`, `surface(gpu, canvas, { clearColor })`),
+ * so a typo lands on the line that wrote it instead of inside a render pass descriptor.
+ */
+export declare function validateClearColor(value: ClearColor, where: string): ClearColor;
+/** Defensive copy: clear colors are mutable WebGPU dictionaries/arrays at runtime. */
+export declare function copyClearColor(value: ClearColor): ClearColor;
+export interface TargetDeviceCaps {
+    readonly isCompatibilityMode?: boolean;
+}
+export declare function colorSpecsFor(options: TargetTextureOptions): readonly {
+    readonly format: GPUTextureFormat;
+}[];
+export declare function depthFormatFor(options: TargetTextureOptions): GPUTextureFormat | undefined;
+export declare function sampleCountFor(options: TargetTextureOptions): 1 | 4;
+export declare function validateTargetOptions(options: Partial<TargetOptions> | undefined, caps: TargetDeviceCaps): void;
+export declare function colorAttachment(resolved: {
+    createView(): GPUTextureView;
+}, msaa: {
+    createView(): GPUTextureView;
+} | undefined, clear: ClearColor, preserve?: boolean): GPURenderPassColorAttachment;
+export declare function depthAttachment(depth: {
+    createView(): GPUTextureView;
+    readonly sampleCount?: number;
+    readonly format?: GPUTextureFormat;
+}, preserve?: boolean, clearDepth?: number, clearStencil?: number, readOnly?: boolean): GPURenderPassDepthStencilAttachment;
+export declare function hasStencilAspect(format: GPUTextureFormat | undefined): boolean;
+export declare function colorValue(clear: ClearColor): GPUColor;
+export declare function sameSize(a: readonly [number, number], b: readonly [number, number]): boolean;
+/** @internal Internal normalization guard: `renderPassDescriptor` is required on Target and never on options bags. */
+export declare function isTarget(value: unknown): value is Target;
+//# sourceMappingURL=target-utils.d.ts.map

package/dist/target-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-utils.d.ts","sourceRoot":"","sources":["../src/target-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE/E,eAAO,MAAM,cAAc,EAAE,gBAA+B,CAAC;AAC7D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9E,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,EAAE,UAAwC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAK/E;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAG5D;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,EAAE,CAE7G;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,gBAAgB,GAAG,SAAS,CAE1F;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,CAAC,GAAG,CAAC,CAQnE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAO/G;AAWD,wBAAgB,eAAe,CAAC,QAAQ,EAAE;IAAE,UAAU,IAAI,cAAc,CAAA;CAAE,EAAE,IAAI,EAAE;IAAE,UAAU,IAAI,cAAc,CAAA;CAAE,GAAG,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,4BAA4B,CASnM;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,UAAU,IAAI,cAAc,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAAE,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,mCAAmC,CAmBnQ;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAE9E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAEtD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAE5F;AAGD,sHAAsH;AACtH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAGxD"}

package/dist/target-utils.js

@@ -0,0 +1,103 @@
+import { clearColorInvalidError, targetSizeRequiredError, targetStencilOnlyDepthError, unsupportedError } from "./errors.js";
+export const DEFAULT_FORMAT = "rgba8unorm";
+/** Clear color used by a pass when neither the pass nor the target chose one. */
+export const BUILT_IN_CLEAR_COLOR = Object.freeze([0, 0, 0, 1]);
+/**
+ * Validates a clear color on assignment (`target.clearColor`, `surface(gpu, canvas, { clearColor })`),
+ * so a typo lands on the line that wrote it instead of inside a render pass descriptor.
+ */
+export function validateClearColor(value, where) {
+    const object = value;
+    const components = Array.isArray(value) ? value : [object?.r, object?.g, object?.b, object?.a];
+    if (components.length !== 4 || !components.every((component) => typeof component === "number" && Number.isFinite(component)))
+        throw clearColorInvalidError(where);
+    return copyClearColor(value);
+}
+/** Defensive copy: clear colors are mutable WebGPU dictionaries/arrays at runtime. */
+export function copyClearColor(value) {
+    const object = value;
+    return Array.isArray(value) ? [value[0], value[1], value[2], value[3]] : { r: object.r, g: object.g, b: object.b, a: object.a };
+}
+export function colorSpecsFor(options) {
+    return options.colors ?? [{ format: options.format ?? DEFAULT_FORMAT }];
+}
+export function depthFormatFor(options) {
+    return options.depth === true ? "depth24plus" : options.depth || undefined;
+}
+export function sampleCountFor(options) {
+    const msaa = options.msaa;
+    if (msaa === true || msaa === 4)
+        return 4;
+    if (msaa === undefined || msaa === false)
+        return 1;
+    const e = targetSizeRequiredError();
+    e.code = "AIGPU-TARGET-MSAA-INVALID";
+    e.message = `msaa received ${msaa}; WebGPU 1|4; use true`;
+    throw e;
+}
+export function validateTargetOptions(options, caps) {
+    if (!options?.size)
+        throw targetSizeRequiredError();
+    const depthFormat = depthFormatFor(options);
+    // Stencil-only formats have no depth aspect, so the default depth state (depthWriteEnabled: true) cannot compile against them.
+    if (depthFormat === "stencil8")
+        throw targetStencilOnlyDepthError(depthFormat);
+    if (sampleCountFor(options) !== 4)
+        return;
+    for (const spec of colorSpecsFor(options))
+        validateMsaaFormat(spec.format, caps);
+}
+function validateMsaaFormat(format, caps) {
+    if (!(caps.isCompatibilityMode && format === "rgba16float"))
+        return;
+    throw unsupportedError("target", "Dawn compatibility mode does not support rgba16float+msaa.", "Use rgba8unorm for MSAA here, or disable msaa.");
+}
+export function colorAttachment(resolved, msaa, clear, preserve) {
+    const attachment = {
+        view: (msaa ?? resolved).createView(),
+        resolveTarget: msaa ? resolved.createView() : undefined,
+        loadOp: preserve ? "load" : "clear",
+        storeOp: msaa ? "discard" : "store",
+    };
+    if (!preserve)
+        attachment.clearValue = colorValue(clear);
+    return attachment;
+}
+export function depthAttachment(depth, preserve, clearDepth, clearStencil, readOnly) {
+    if (readOnly) {
+        // WebGPU requires the ops to be OMITTED for read-only aspects: "If format has a depth aspect and
+        // this.depthReadOnly is false: this.depthLoadOp must be provided. this.depthStoreOp must be provided.
+        // Otherwise: this.depthLoadOp must not be provided. this.depthStoreOp must not be provided." — and the
+        // same for stencilLoadOp/stencilStoreOp with stencilReadOnly, so combined formats mark both aspects.
+        const attachment = { view: depth.createView(), depthReadOnly: true };
+        if (hasStencilAspect(depth.format))
+            attachment.stencilReadOnly = true;
+        return attachment;
+    }
+    const attachment = { view: depth.createView(), depthLoadOp: preserve ? "load" : "clear", depthStoreOp: depth.sampleCount > 1 ? "discard" : "store" };
+    if (!preserve)
+        attachment.depthClearValue = clearDepth ?? 1;
+    // WebGPU requires stencilLoadOp/stencilStoreOp whenever the format has a stencil aspect and stencilReadOnly is not set.
+    if (depth.format && hasStencilAspect(depth.format)) {
+        attachment.stencilLoadOp = preserve ? "load" : "clear";
+        attachment.stencilStoreOp = depth.sampleCount > 1 ? "discard" : "store";
+        if (!preserve)
+            attachment.stencilClearValue = clearStencil ?? 0;
+    }
+    return attachment;
+}
+export function hasStencilAspect(format) {
+    return !!format && format.includes("stencil");
+}
+export function colorValue(clear) {
+    return Array.isArray(clear) ? { r: clear[0], g: clear[1], b: clear[2], a: clear[3] } : clear;
+}
+export function sameSize(a, b) {
+    return a[0] === b[0] && a[1] === b[1];
+}
+/** @internal Internal normalization guard: `renderPassDescriptor` is required on Target and never on options bags. */
+export function isTarget(value) {
+    return typeof value === "object" && value !== null
+        && typeof value.renderPassDescriptor === "function";
+}
+//# sourceMappingURL=target-utils.js.map

package/dist/target-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-utils.js","sourceRoot":"","sources":["../src/target-utils.ts"],"names":[],"mappings":"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"}

package/dist/target.d.ts

@@ -0,0 +1,65 @@
+import type { ClearColor } from "./target-utils.ts";
+import type { Texture, ResourceDestroyCallback, ResourceIdentity, UnsubscribeResourceDestroy } from "@aigpu/core";
+export interface TargetTextureOptions {
+    readonly format?: GPUTextureFormat;
+    /**
+     * Default clear color of this target, used by passes that clear without naming a color.
+     * Defaults to `[0, 0, 0, 1]`; mutable at runtime through `target.clearColor`.
+     */
+    readonly clearColor?: ClearColor;
+    readonly colors?: readonly {
+        readonly format: GPUTextureFormat;
+    }[];
+    readonly depth?: boolean | GPUTextureFormat;
+    readonly msaa?: boolean | 4;
+    readonly label?: string;
+}
+export interface TargetOptions extends TargetTextureOptions {
+    readonly size: readonly [number, number];
+}
+export interface TargetSignature {
+    readonly colors: readonly GPUTextureFormat[];
+    readonly depth?: GPUTextureFormat;
+    readonly sampleCount?: 1 | 4;
+}
+export type CompileTarget = Target | TargetSignature;
+/** Options bag for `Target.renderPassDescriptor()`. `Frame.pass` supplies these from `FramePassOptions`. */
+export interface RenderPassDescriptorOptions {
+    /** Clear color for all color attachments unless `preserve` is true. Defaults to `[0, 0, 0, 1]`. */
+    readonly clear?: ClearColor;
+    /** When true, color and depth attachments load existing contents and omit clear values. */
+    readonly preserve?: boolean;
+    /** Depth clear value used when the pass clears. Defaults to `1`. */
+    readonly clearDepth?: number;
+    /** Stencil clear value used when the pass clears. Defaults to `0`. */
+    readonly clearStencil?: number;
+    /** Builds the depth-stencil attachment read-only, omitting its load/store ops (stencil aspect included). */
+    readonly depthReadOnly?: boolean;
+}
+export interface Target {
+    readonly gpu: unknown;
+    readonly size: readonly [number, number];
+    readonly texelSize: readonly [number, number];
+    readonly color: Texture;
+    readonly colors: readonly [Texture, ...Texture[]];
+    readonly depth?: Texture;
+    readonly format: GPUTextureFormat;
+    readonly sampleCount: 1 | 4;
+    /**
+     * Default clear color of this target: the color a pass uses when it clears without naming one
+     * (`pass(target, body)` or `clear: true`). Writable at runtime, validated on assignment.
+     * Precedence: pass `clear` color > `target.clearColor` > the built-in `[0, 0, 0, 1]`.
+     */
+    clearColor: ClearColor;
+    readonly resourceIdentity: ResourceIdentity;
+    resize(size: readonly [number, number]): void;
+    /** Raw unpadded bytes of `color` in the target's own format (`bgra*` swizzled to RGBA). */
+    read(): Promise<Uint8Array>;
+    /** Components of `color` decoded to f32 — the HDR-friendly readback for `rgba16float`/`rgba32float` targets. */
+    readFloats(): Promise<Float32Array>;
+    onDestroy(cb: ResourceDestroyCallback<Target>): UnsubscribeResourceDestroy;
+    renderPassDescriptor(opts?: RenderPassDescriptorOptions): GPURenderPassDescriptor;
+}
+export { OffscreenTarget } from "./target-offscreen.ts";
+export type { Surface, SurfaceOptions, SurfaceResizeEvent } from "./surface.ts";
+//# sourceMappingURL=target.d.ts.map

package/dist/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../src/target.ts"],"names":[],"mappings":"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"}

package/dist/target.js

@@ -0,0 +1,2 @@
+export { OffscreenTarget } from "./target-offscreen.js";
+//# sourceMappingURL=target.js.map

package/dist/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../src/target.ts"],"names":[],"mappings":"AAmEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/timer.d.ts

@@ -0,0 +1,78 @@
+import type { Device } from "@aigpu/core";
+import { FRAME_PASS_ATTACHMENT, type FramePassAttachContext, type FramePassAttachment, type FramePassAttachResult } from "./frame-protocols.ts";
+import type { Gpu } from "./kernel.ts";
+import { type QueryHostOptions } from "./query-ring.ts";
+/**
+ * Marks one frame pass for GPU timing. Create with `timer.span(name)` and pass it
+ * as `FramePassOptions.timer`; the pass's GPU duration is reported under `name`
+ * through `timer.onResults`.
+ */
+export interface TimerSpan {
+    readonly name: string;
+}
+/** GPU pass timer created by `timer(gpu)`. Needs the "timestamp-query" device feature. */
+export interface Timer {
+    /** Marks a pass for timing. Pass the result as FramePassOptions.timer. One name per frame. */
+    span(name: string): TimerSpan;
+    /** Registers a callback invoked whenever a new set of results lands (typically 1-2 frames after submit). Times in milliseconds. Returns an unsubscribe function. */
+    onResults(cb: (spans: Readonly<Record<string, number>>) => void): () => void;
+    /** Releases the timer's query set and buffers. Further use of the timer or its spans throws. */
+    dispose(): void;
+}
+declare class InternalTimerSpan implements TimerSpan, FramePassAttachment {
+    readonly name: string;
+    readonly owner: InternalTimer;
+    constructor(name: string, owner: InternalTimer);
+    /**
+     * Frame pass attachment: registering the span is what returns the descriptor's `timestampWrites`
+     * (undefined when the span is dropped this frame because the query set is full). The owner is the
+     * timer, not the span, so a frame that attaches two spans of the same timer bookkeeps one owner.
+     */
+    [FRAME_PASS_ATTACHMENT](ctx: FramePassAttachContext): FramePassAttachResult;
+}
+/** @internal The concrete span, for tests that need the internal shape behind the TimerSpan handle. */
+export type { InternalTimerSpan };
+/** @internal */
+export declare function createTimer(device: Device, host?: QueryHostOptions): Timer;
+/**
+ * GPU pass timing for this gpu. Needs the "timestamp-query" device feature — request it at init:
+ * `init({ requiredFeatures: ["timestamp-query"] })`.
+ *
+ * The timer owns a query ring: its readbacks join `gpu.settled()`, a dropped readback is reported
+ * on `gpu.onError`, and `gpu.dispose()` releases the query set (deferring destruction while a frame
+ * in flight still references it). `timer.dispose()` releases it earlier and drops the registration.
+ */
+export declare function timer(gpu: Gpu): Timer;
+/**
+ * Ring-1 GPU pass timer. Owns name→span bookkeeping per frame, contiguous
+ * begin/end index pair allocation, ns→ms conversion, and onResults dispatch;
+ * the query set + resolve/readback plumbing lives in the shared query ring.
+ *
+ * @internal
+ */
+export declare class InternalTimer {
+    #private;
+    constructor(device: Device, host?: QueryHostOptions);
+    span(name: string): TimerSpan;
+    onResults(cb: (spans: Readonly<Record<string, number>>) => void): () => void;
+    dispose(): void;
+    /**
+     * @internal Frame.pass hook: registers the span for the current frame and returns the pass
+     * descriptor's timestampWrites, or undefined when the span is dropped for this frame because
+     * the query set is full (capacity grows at the next frame boundary — never mid-frame, since
+     * earlier passes already reference the current set).
+     */
+    attachSpan(span: InternalTimerSpan, frame: unknown, frameDevice: Device): GPURenderPassTimestampWrites | undefined;
+    /** @internal Frame.submit hook, before encoder.finish(): appends this frame's single resolve to the frame encoder. */
+    finalizeFrame(frame: unknown, encoder: GPUCommandEncoder): void;
+    /** @internal Frame.submit hook, after queue.submit succeeds: starts the non-blocking readback. */
+    frameSubmitted(frame: unknown): void;
+    /**
+     * @internal Frame abandon hook (a failed pass, a failed finish/submit, or Frame.cancel()): the
+     * frame ends without ever reaching the queue. Drops the pending encoded state so no readback can
+     * decode stale staging bytes as a phantom duration, and releases the retain this frame took when
+     * it attached a span — the counterpart of frameSubmitted() for frames that never submit.
+     */
+    frameAbandoned(frame: unknown): void;
+}
+//# sourceMappingURL=timer.d.ts.map

package/dist/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../src/timer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,qBAAqB,EAAE,KAAK,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAChJ,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAmB,KAAK,gBAAgB,EAAkB,MAAM,iBAAiB,CAAC;AAEzF;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,0FAA0F;AAC1F,MAAM,WAAW,KAAK;IACpB,8FAA8F;IAC9F,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,oKAAoK;IACpK,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC7E,gGAAgG;IAChG,OAAO,IAAI,IAAI,CAAC;CACjB;AAQD,cAAM,iBAAkB,YAAW,SAAS,EAAE,mBAAmB;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa;gBAA3C,IAAI,EAAE,MAAM,EAAW,KAAK,EAAE,aAAa;IAEhE;;;;OAIG;IACH,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAAE,sBAAsB,GAAG,qBAAqB;CAG5E;AAED,uGAAuG;AACvG,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,KAAK,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,KAAK,CAGrC;AAOD;;;;;;GAMG;AACH,qBAAa,aAAa;;gBA2BZ,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB;IAcvD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAa7B,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAM5E,OAAO,IAAI,IAAI;IAcf;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,4BAA4B,GAAG,SAAS;IA4BlH,sHAAsH;IACtH,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAM/D,kGAAkG;IAClG,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAsBpC;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;CAwDrC"}