@earendil-works/chord 1.5.0 → 1.5.1

package/dist/next-node/plugins/watcher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../../src/next-node/plugins/watcher.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,qHAAqH;AACrH,yHAAyH;AACzH,wHAAwH;AACxH,sHAAsH;AACtH,sHAAsH;AACtH,sFAAsF;AAEtF,OAAO,EAA+B,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACnG,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAgB,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EAAc,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAmB,MAAM,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAkB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAyBjE,sEAAsE;AACtE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,MAAM;IAC/B,QAAQ,CAAiB;IACzB,MAAM,CAAoB;IAC1B,SAAS,CAAoB;IACtC,4GAA4G;IACnG,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,mDAAmD;IAC1C,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;IAClD,8CAA8C;IAC9C,SAAS,GAAG,KAAK,CAAC;IAClB,8FAA8F;IAC9F,WAAW,GAAG,CAAC,CAAC;IAChB,wDAAwD;IAC/C,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnC,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,8EAA8E;IAC9E,IAAI,GAAG,CAAC,CAAC;IACT,+FAA+F;IAC/F,SAAS,GAAG,CAAC,CAAC;IACd,YAAY,GAAG,KAAK,CAAC;IACrB,UAAU,GAAc,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACtD,mFAAmF;IAC1E,KAAK,GAAG,IAAI,GAAG,EAA4E,CAAC;IACrG,MAAM,CAAwB;IAC9B,UAAU,GAAG,KAAK,CAAC;IAEnB,YAAY,OAAuB,EAAE,KAAY;QAChD,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,uGAAuG;QACvG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;YAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,KAAK;QACR,IAAI,CAAC,MAAM,KAAK;YACf,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YACrC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;YAClC,GAAG,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC;YAClB,IAAI,EAAE,IAAI,CAAC,YAAY;SACvB,CAAC;QACF,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,OAAgB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,mGAAmG;IACnG,IAAI,cAAc;QACjB,OAAO,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,iDAAiD;IACjD,iBAAiB;QAChB,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACrD,CAAC;IAED,uHAAuH;IACvH,IAAI,CAAC,SAAoB,EAAE,IAAuB;QACjD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACzD,0FAA0F;QAC1F,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ;YAC/B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3F,mGAAmG;QACnG,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACrG,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,MAAM;YAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,GACT,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;YACzG,IAAI,CAAC,IAAI;gBAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjB,CAAC;IAED,4FAA4F;IAC5F,IAAI,CAAC,KAA4B;QAChC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YACtC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAClF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,SAAS,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACxF,CAAC;IACF,CAAC;IAED,0EAA0E;IAC1E,QAAQ,CAAC,KAAuB;QAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,OAAO,EAAE,OAAO,EAAE,CAAC;IACpB,CAAC;IAED,gGAAgG;IAChG,OAAO,CAAC,KAAuB,EAAE,QAAsB;QACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjB,CAAC;IAED,mHAAmH;IACnH,SAAS,CAAC,IAAY;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjB,CAAC;IAED,kFAAkF;IAClF,IAAI,CAAC,IAAY;QAChB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO;QAC9D,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjB,CAAC;IAED,sBAAsB;IACtB,KAAK;QACJ,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;YAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/D,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,IAAY,EAAE,UAAkB;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QACnG,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAAE,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QAC5E,CAAC;aAAM,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC;QAC7B,CAAC;aAAM,CAAC;YACP,IAAI,IAAI,KAAK,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChG,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;YACxB,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACnH,CAAC;IAED,6FAA6F;IAC7F,YAAY,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;IACjH,CAAC;IAED,oHAAoH;IACpH,UAAU,CAAC,GAAW;QACrB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QACjC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,wCAAwC;IACxC,YAAY,CAAC,GAAW;QACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,yGAAyG;IACzG,UAAU,CAAC,GAAW;QACrB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QACtD,IAAI,OAAkB,CAAC;QACvB,IAAI,CAAC;YACJ,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;gBACrC,IAAI,IAAI,KAAK,IAAI;oBAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;YACrD,CAAC,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO;QACR,CAAC;QACD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACJ,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACR,iDAAiD;YACjD,OAAO;QACR,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7F,CAAC;IACF,CAAC;IAED,sHAAsH;IACtH,UAAU,CAAC,IAAY;QACtB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,WAAW,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;iBACxC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,+GAA+G;IAC/G,YAAY,CAAC,GAAW;QACvB,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjD,IAAI,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC;gBAAE,SAAS;YACvD,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACF,CAAC;IAED,oFAAoF;IACpF,OAAO,CAAC,KAAc;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,wGAAwG;IACxG,QAAQ;QACP,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,CAAC;YAAE,OAAO;QAC7E,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,cAAc,CAAC,GAAG,EAAE;YACnB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,IAAY;IAChC,IAAI,CAAC;QACJ,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED,uFAAuF;AACvF,SAAS,IAAI,CAAC,GAAW;IACxB,IAAI,CAAC;QACJ,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACF,CAAC","sourcesContent":["// The watcher and its marks (slice 7c §5): `fs.watch` on every directory of the plugin roots and the app's base code,\n// `node_modules` and `.git` never watched (a directory appearing later gets its watch), marks what changed and never\n// applies it. A changed file dirties every plugin whose facets used it (a copied contract every user) or whose directory\n// contains it; a changed `package.json` asks for an install (and for its metadata to be read again); a plugin directory\n// or facet file added or removed asks for discovery again; a file of base code asks the app to restart its hosts. The\n// marks are a JSON watchable; each mark records the generation of its latest change (generations only increase), so a\n// change during a build keeps its mark, however late an older build's rollout clears.\n\nimport { type Dirent, type FSWatcher, lstatSync, readdirSync, realpathSync, watch } from \"node:fs\";\nimport { basename, dirname, join, resolve, sep } from \"node:path\";\nimport { BACKGROUND_CONTEXT, type Context } from \"../../context/index.ts\";\nimport type { JsonValue } from \"../../json.ts\";\nimport { type Batch, Source } from \"../../next/state/internal.ts\";\nimport { type BuiltFacet, inside } from \"./build.ts\";\nimport { type Discovery, FACET_EXTENSIONS } from \"./discover.ts\";\n\n/** The marks: plugins to rebuild, plugins to install, whether to discover again, whether base code changed. */\nexport type PluginsState = {\n\treadonly dirty: readonly string[];\n\treadonly install: readonly string[];\n\treadonly set: boolean;\n\treadonly base: boolean;\n};\n\n/** The generation of each dirty plugin's latest change when a build started: what its rollout may clear. */\nexport type MarkSnapshot = { readonly plugins: ReadonlyMap<string, number> };\n\n/** The generations of the latest change of the plugin set and of a `package.json` when a discovery started. */\nexport type DiscoverySnapshot = { readonly set: number; readonly manifest: number };\n\n/** What the watcher watches and how it reports: the roots, the base code, the facet kinds, a failure to watch. */\nexport type WatcherOptions = {\n\treadonly roots: readonly string[];\n\treadonly base: readonly string[];\n\treadonly kinds: readonly string[];\n\t/** The watcher cannot watch (the system's limit): reported once, after which the app builds on demand. */\n\treadonly failed: (error: unknown) => void;\n};\n\n/** Directories never watched, and changes under them never marked. */\nconst IGNORED = new Set([\"node_modules\", \".git\"]);\n\n/**\n * The watcher and the marks (`state`), a JSON watchable published at most once per microtask turn with changes. It\n * marks for the plugins of the last discovery (`know`) and the files their last builds read (`used`).\n */\nexport class PluginWatcher extends Source {\n\treadonly #options: WatcherOptions;\n\treadonly #roots: readonly string[];\n\treadonly #baseDirs: readonly string[];\n\t/** The trees it watches: the roots, the base code, and plugin directories linked from outside the roots. */\n\treadonly #trees = new Set<string>();\n\t/** Its watches, one per directory of its trees. */\n\treadonly #watchers = new Map<string, FSWatcher>();\n\t/** A failure to watch was reported (once). */\n\t#reported = false;\n\t/** The generation the next change gets: every mark records a newer one than any before it. */\n\t#generation = 1;\n\t/** Each dirty plugin's latest change, by generation. */\n\treadonly #dirty = new Map<string, number>();\n\treadonly #install = new Set<string>();\n\t/** The latest change of the plugin set since the last discovery (0: none). */\n\t#set = 0;\n\t/** The latest change of a known plugin's `package.json` since the last discovery (0: none). */\n\t#manifest = 0;\n\t#baseChanged = false;\n\t#discovery: Discovery = { plugins: [], problems: [] };\n\t/** The files each built facet read (its inputs and copies), by plugin and kind. */\n\treadonly #used = new Map<string, { readonly plugin: string; readonly files: ReadonlySet<string> }>();\n\t#value: JsonValue | undefined;\n\t#scheduled = false;\n\n\tconstructor(options: WatcherOptions, batch: Batch) {\n\t\tsuper(batch);\n\t\tthis.#options = options;\n\t\t// Events name paths under the directories as watched: by their real paths, as discovery names plugins.\n\t\tthis.#roots = options.roots.map(real);\n\t\tthis.#baseDirs = options.base.map(real);\n\t\tfor (const dir of [...this.#roots, ...this.#baseDirs]) this.#watchTree(dir);\n\t}\n\n\tget value(): JsonValue {\n\t\tthis.#value ??= {\n\t\t\tdirty: [...this.#dirty.keys()].sort(),\n\t\t\tinstall: [...this.#install].sort(),\n\t\t\tset: this.#set > 0,\n\t\t\tbase: this.#baseChanged,\n\t\t};\n\t\treturn this.#value;\n\t}\n\n\tdeliver(context: Context): void {\n\t\tconst value = this.value;\n\t\tthis.publish(value, [[\"r\", value]], false, context);\n\t}\n\n\t/** Whether the next build discovers again: the plugin set or a plugin's `package.json` changed. */\n\tget needsDiscovery(): boolean {\n\t\treturn this.#set > 0 || this.#manifest > 0;\n\t}\n\n\t/** What a discovery that starts now has seen. */\n\tdiscoverySnapshot(): DiscoverySnapshot {\n\t\treturn { set: this.#set, manifest: this.#manifest };\n\t}\n\n\t/** The plugins discovery found: marks are for them (a removed one's install clears); the changes it had seen clear. */\n\tknow(discovery: Discovery, seen: DiscoverySnapshot): void {\n\t\tthis.#discovery = discovery;\n\t\tif (this.#set === seen.set) this.#set = 0;\n\t\tif (this.#manifest === seen.manifest) this.#manifest = 0;\n\t\t// A removed plugin has nothing to install (its directory went, its package.json with it).\n\t\tfor (const name of this.#install)\n\t\t\tif (!discovery.plugins.some((plugin) => plugin.name === name)) this.#install.delete(name);\n\t\t// A plugin directory linked from outside the roots: a tree of its own (a symlink is not followed).\n\t\tconst linked = discovery.plugins.filter(({ dir }) => !this.#roots.some((root) => inside(root, dir)));\n\t\tfor (const { dir } of linked) this.#watchTree(dir);\n\t\tfor (const tree of this.#trees) {\n\t\t\tconst kept =\n\t\t\t\tthis.#roots.includes(tree) || this.#baseDirs.includes(tree) || linked.some((each) => each.dir === tree);\n\t\t\tif (!kept) this.#unwatchTree(tree);\n\t\t}\n\t\tthis.#changed();\n\t}\n\n\t/** What `built` facets read: a later change of one of these files dirties their plugins. */\n\tused(built: readonly BuiltFacet[]): void {\n\t\tfor (const facet of built) {\n\t\t\tif (facet.kind !== \"script\") continue;\n\t\t\tconst files = new Set([...facet.inputs.map(({ file }) => file), ...facet.copied]);\n\t\t\tthis.#used.set(`${facet.plugin}\\u0000${facet.facet}`, { plugin: facet.plugin, files });\n\t\t}\n\t}\n\n\t/** The marks a build of `names` starts from: each one's latest change. */\n\tsnapshot(names: Iterable<string>): MarkSnapshot {\n\t\tconst plugins = new Map<string, number>();\n\t\tfor (const name of names) plugins.set(name, this.#dirty.get(name) ?? 0);\n\t\treturn { plugins };\n\t}\n\n\t/** `names` were applied everywhere: their marks clear unless a change came after `snapshot`. */\n\tapplied(names: Iterable<string>, snapshot: MarkSnapshot): void {\n\t\tfor (const name of names) {\n\t\t\tconst latest = this.#dirty.get(name);\n\t\t\tif (latest !== undefined && latest <= (snapshot.plugins.get(name) ?? 0)) this.#dirty.delete(name);\n\t\t}\n\t\tthis.#changed();\n\t}\n\n\t/** Plugin `name`'s dependencies were installed: its install mark clears and it is dirty (its packages changed). */\n\tinstalled(name: string): void {\n\t\tthis.#install.delete(name);\n\t\tthis.#dirty.set(name, this.#generation++);\n\t\tthis.#changed();\n\t}\n\n\t/** Marks what a change of the file or directory at `path` (absolute) asks for. */\n\tmark(path: string): void {\n\t\tif (path.split(sep).some((part) => IGNORED.has(part))) return;\n\t\tif (this.#baseDirs.some((dir) => inside(dir, path))) {\n\t\t\tthis.#baseChanged = true;\n\t\t} else {\n\t\t\tthis.#markPlugin(path, this.#generation++);\n\t\t}\n\t\tthis.#changed();\n\t}\n\n\t/** Stops watching. */\n\tclose(): void {\n\t\tfor (const watcher of this.#watchers.values()) watcher.close();\n\t\tthis.#watchers.clear();\n\t\tthis.#trees.clear();\n\t}\n\n\t/**\n\t * A change under a root, at `generation`: in a plugin's directory, it dirties that plugin (and asks for an install\n\t * and a new reading of its metadata for its `package.json`, for discovery for a facet file at its top); elsewhere\n\t * under a root (a directory added or removed, a directory that is no plugin yet), discovery; every plugin whose\n\t * facets read the file is dirty too.\n\t */\n\t#markPlugin(path: string, generation: number): void {\n\t\tconst plugin = this.#discovery.plugins.find((each) => each.dir === path || inside(each.dir, path));\n\t\tif (plugin === undefined) {\n\t\t\tif (this.#roots.some((root) => inside(root, path))) this.#set = generation;\n\t\t} else if (path === join(plugin.dir, \"package.json\")) {\n\t\t\tthis.#install.add(plugin.name);\n\t\t\tthis.#manifest = generation;\n\t\t} else {\n\t\t\tif (path === plugin.dir || (dirname(path) === plugin.dir && this.#isFacetFile(basename(path)))) {\n\t\t\t\tthis.#set = generation;\n\t\t\t}\n\t\t\tthis.#dirty.set(plugin.name, generation);\n\t\t}\n\t\tfor (const { plugin: user, files } of this.#used.values()) if (files.has(path)) this.#dirty.set(user, generation);\n\t}\n\n\t/** Whether `file` (at a plugin's top) is named as a facet file of one of the app's kinds. */\n\t#isFacetFile(file: string): boolean {\n\t\treturn this.#options.kinds.some((kind) => FACET_EXTENSIONS.some((extension) => file === `${kind}${extension}`));\n\t}\n\n\t/** Watches the tree at `dir` (once): it and every directory under it but ignored ones; a missing one is skipped. */\n\t#watchTree(dir: string): void {\n\t\tif (this.#trees.has(dir)) return;\n\t\tthis.#trees.add(dir);\n\t\tthis.#watchDirs(dir);\n\t}\n\n\t/** Stops watching the tree at `dir`. */\n\t#unwatchTree(dir: string): void {\n\t\tthis.#trees.delete(dir);\n\t\tthis.#unwatchDirs(dir);\n\t}\n\n\t/** Watches `dir` and, walking down, every directory under it but ignored ones (each not watched yet). */\n\t#watchDirs(dir: string): void {\n\t\tif (this.#watchers.has(dir) || this.#reported) return;\n\t\tlet watcher: FSWatcher;\n\t\ttry {\n\t\t\twatcher = watch(dir, (_event, file) => {\n\t\t\t\tif (file !== null) this.#changedIn(join(dir, file));\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") this.#failed(error);\n\t\t\treturn;\n\t\t}\n\t\twatcher.on(\"error\", (error) => this.#failed(error));\n\t\tthis.#watchers.set(dir, watcher);\n\t\tlet entries: Dirent[];\n\t\ttry {\n\t\t\tentries = readdirSync(dir, { withFileTypes: true });\n\t\t} catch {\n\t\t\t// Removed meanwhile: its parent's event says so.\n\t\t\treturn;\n\t\t}\n\t\tfor (const entry of entries) {\n\t\t\tif (entry.isDirectory() && !IGNORED.has(entry.name)) this.#watchDirs(join(dir, entry.name));\n\t\t}\n\t}\n\n\t/** An event for `path` in a watched directory: a new directory gets its watches, a removed one loses them; marked. */\n\t#changedIn(path: string): void {\n\t\tconst name = basename(path);\n\t\tif (!IGNORED.has(name)) {\n\t\t\tif (isDirectory(path)) this.#watchDirs(path);\n\t\t\telse if (this.#watchers.has(path)) this.#unwatchDirs(path);\n\t\t}\n\t\tthis.mark(path);\n\t}\n\n\t/** Stops watching `dir` and the directories under it (it was removed, or its tree is not watched any more). */\n\t#unwatchDirs(dir: string): void {\n\t\tfor (const [watched, watcher] of this.#watchers) {\n\t\t\tif (watched !== dir && !inside(dir, watched)) continue;\n\t\t\twatcher.close();\n\t\t\tthis.#watchers.delete(watched);\n\t\t}\n\t}\n\n\t/** Watching failed: reported once; every watch stops (the app builds on demand). */\n\t#failed(error: unknown): void {\n\t\tthis.close();\n\t\tif (this.#reported) return;\n\t\tthis.#reported = true;\n\t\tthis.#options.failed(error);\n\t}\n\n\t/** The marks changed: one publication per microtask turn while someone watches or derives from them. */\n\t#changed(): void {\n\t\tthis.#value = undefined;\n\t\tif (this.#scheduled || (!this.watched && this.dependents.size === 0)) return;\n\t\tthis.#scheduled = true;\n\t\tqueueMicrotask(() => {\n\t\t\tthis.#scheduled = false;\n\t\t\tthis.batch.within(() => this.changed(), BACKGROUND_CONTEXT);\n\t\t});\n\t}\n}\n\n/**\n * Whether `path` is a directory, never following a link (as the scan of a tree does not); one that cannot be read (gone,\n * a link loop, no access) is none: a watch callback must not throw.\n */\nfunction isDirectory(path: string): boolean {\n\ttry {\n\t\treturn lstatSync(path, { throwIfNoEntry: false })?.isDirectory() === true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/** `dir` absolute and by its real path; as given (absolute) when it does not exist. */\nfunction real(dir: string): string {\n\ttry {\n\t\treturn realpathSync(dir);\n\t} catch {\n\t\treturn resolve(dir);\n\t}\n}\n"]}

package/dist/next-node/workers/control.d.ts

@@ -1,83 +0,0 @@
-import type { JsonValue } from "../../json.ts";
-import type { Address } from "../../next/contracts/index.ts";
-import { type FailureCause } from "../../next/data/index.ts";
-import type { ReloadReport } from "../../next/host/index.ts";
-import type { PluginScript } from "../plugins/runtime.ts";
-/** An error as it crosses: its message, and a ChordError's code and reason. */
-export type CrossedError = {
-    readonly message: string;
-    readonly code?: string;
-    readonly reason?: string;
-};
-/** A reload report as it crosses: its errors crossed. */
-export type CrossedReport = {
-    readonly plugins: ReloadReport["plugins"];
-    readonly failed: readonly {
-        readonly plugin: string;
-        readonly error: CrossedError;
-    }[];
-    readonly objects: readonly {
-        readonly object: string;
-        readonly kind: string;
-        readonly cause?: CrossedCause;
-    }[];
-};
-/** A failure cause as it crosses. */
-type CrossedCause = {
-    readonly kind: FailureCause["kind"];
-    readonly error: CrossedError;
-};
-/** What the server sends a worker. */
-export type ToWorker = {
-    readonly kind: "start";
-    readonly address: Address;
-    readonly start: JsonValue;
-    readonly scripts: readonly PluginScript[];
-    readonly lock: string;
-} | {
-    readonly kind: "shutdown";
-} | {
-    readonly kind: "reload";
-    readonly scripts: readonly PluginScript[];
-};
-/** What a worker sends the server. */
-export type FromWorker = {
-    readonly kind: "started";
-} | {
-    readonly kind: "ready";
-    readonly idle: boolean;
-    readonly report: CrossedReport;
-} | {
-    readonly kind: "idle";
-    readonly idle: boolean;
-} | {
-    readonly kind: "fatal";
-    readonly error: CrossedError;
-} | {
-    readonly kind: "reloaded";
-    readonly report: CrossedReport;
-} | {
-    readonly kind: "reloaded";
-    readonly error: CrossedError;
-};
-/** `message` in its envelope, as it goes over the IPC channel. */
-export declare function envelope(message: ToWorker | FromWorker): {
-    readonly [ENVELOPE]: ToWorker | FromWorker;
-};
-/** The envelope's key: a control message is `{ "chord.workers": message }`. */
-declare const ENVELOPE = "chord.workers";
-/**
- * The control message in an IPC message, or `undefined` for anything else (a link frame, the app's own). A trust
- * boundary in name only: both ends are the app's processes, so only the envelope is checked.
- */
-export declare function controlOf<M extends ToWorker | FromWorker>(message: unknown): M | undefined;
-/** `error` as it crosses. */
-export declare function crossed(error: unknown): CrossedError;
-/** A crossed error as an error again: a ChordError when its code is one, an `Error` otherwise. */
-export declare function uncrossed(error: CrossedError): Error;
-/** `report` as it crosses. */
-export declare function crossedReport(report: ReloadReport): CrossedReport;
-/** A crossed report as a report again. */
-export declare function uncrossedReport(report: CrossedReport): ReloadReport;
-export {};
-//# sourceMappingURL=control.d.ts.map

package/dist/next-node/workers/control.d.ts.map

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

package/dist/next-node/workers/control.js

@@ -1,77 +0,0 @@
-// The control channel between the server and a worker (slice 10 §3): JSON messages beside the link's `Uint8Array`
-// frames on one IPC channel (the IPC link skips them), and errors as they cross it (`{ message, code?, reason? }`,
-// never a stack or a cause).
-import { ChordError, isChordError } from "../../next/data/index.js";
-import { chordErrorFromJson } from "../../next/data/internal.js";
-/** `message` in its envelope, as it goes over the IPC channel. */
-export function envelope(message) {
-    return { [ENVELOPE]: message };
-}
-/** The envelope's key: a control message is `{ "chord.workers": message }`. */
-const ENVELOPE = "chord.workers";
-/**
- * The control message in an IPC message, or `undefined` for anything else (a link frame, the app's own). A trust
- * boundary in name only: both ends are the app's processes, so only the envelope is checked.
- */
-export function controlOf(message) {
-    if (typeof message !== "object" || message === null || !(ENVELOPE in message))
-        return undefined;
-    // Sent by the other end of this channel through `envelope`.
-    return message[ENVELOPE];
-}
-/** `error` as it crosses. */
-export function crossed(error) {
-    if (isChordError(error)) {
-        return {
-            message: error.message,
-            code: error.code,
-            ...(error.reason === undefined ? {} : { reason: error.reason }),
-        };
-    }
-    return { message: error instanceof Error ? error.message : String(error) };
-}
-/** A crossed error as an error again: a ChordError when its code is one, an `Error` otherwise. */
-export function uncrossed(error) {
-    if (error.code === undefined)
-        return new Error(error.message);
-    try {
-        return chordErrorFromJson({
-            code: error.code,
-            message: error.message,
-            ...(error.reason === undefined ? {} : { reason: error.reason }),
-        });
-    }
-    catch {
-        return new Error(error.message);
-    }
-}
-/** `report` as it crosses. */
-export function crossedReport(report) {
-    return {
-        plugins: report.plugins,
-        failed: report.failed.map(({ plugin, error }) => ({ plugin, error: crossed(error) })),
-        objects: report.objects.map((each) => each.kind === "parked"
-            ? {
-                object: each.object,
-                kind: each.kind,
-                cause: { kind: each.cause.kind, error: crossed(each.cause.error) },
-            }
-            : each),
-    };
-}
-/** A crossed report as a report again. */
-export function uncrossedReport(report) {
-    return {
-        plugins: report.plugins,
-        failed: report.failed.map(({ plugin, error }) => ({ plugin, error: uncrossed(error) })),
-        objects: report.objects.map(({ object, kind, cause }) => {
-            if (cause === undefined)
-                return { object, kind: kind };
-            const error = uncrossed(cause.error);
-            // A parked object's cause is a ChordError on the worker; one that crossed without a code is wrapped as one.
-            const chord = isChordError(error) ? error : new ChordError({ code: "unavailable", message: error.message });
-            return { object, kind: "parked", cause: { kind: cause.kind, error: chord } };
-        }),
-    };
-}
-//# sourceMappingURL=control.js.map

package/dist/next-node/workers/control.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"control.js","sourceRoot":"","sources":["../../../src/next-node/workers/control.ts"],"names":[],"mappings":"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","sourcesContent":["// The control channel between the server and a worker (slice 10 §3): JSON messages beside the link's `Uint8Array`\n// frames on one IPC channel (the IPC link skips them), and errors as they cross it (`{ message, code?, reason? }`,\n// never a stack or a cause).\n\nimport type { JsonValue } from \"../../json.ts\";\nimport type { Address } from \"../../next/contracts/index.ts\";\nimport { ChordError, type FailureCause, isChordError } from \"../../next/data/index.ts\";\nimport { chordErrorFromJson } from \"../../next/data/internal.ts\";\nimport type { ReloadReport } from \"../../next/host/index.ts\";\nimport type { PluginScript } from \"../plugins/runtime.ts\";\n\n/** An error as it crosses: its message, and a ChordError's code and reason. */\nexport type CrossedError = { readonly message: string; readonly code?: string; readonly reason?: string };\n\n/** A reload report as it crosses: its errors crossed. */\nexport type CrossedReport = {\n\treadonly plugins: ReloadReport[\"plugins\"];\n\treadonly failed: readonly { readonly plugin: string; readonly error: CrossedError }[];\n\treadonly objects: readonly { readonly object: string; readonly kind: string; readonly cause?: CrossedCause }[];\n};\n\n/** A failure cause as it crosses. */\ntype CrossedCause = { readonly kind: FailureCause[\"kind\"]; readonly error: CrossedError };\n\n/** What the server sends a worker. */\nexport type ToWorker =\n\t| {\n\t\t\treadonly kind: \"start\";\n\t\t\treadonly address: Address;\n\t\t\treadonly start: JsonValue;\n\t\t\treadonly scripts: readonly PluginScript[];\n\t\t\treadonly lock: string;\n\t  }\n\t| { readonly kind: \"shutdown\" }\n\t| { readonly kind: \"reload\"; readonly scripts: readonly PluginScript[] };\n\n/** What a worker sends the server. */\nexport type FromWorker =\n\t| { readonly kind: \"started\" }\n\t| { readonly kind: \"ready\"; readonly idle: boolean; readonly report: CrossedReport }\n\t| { readonly kind: \"idle\"; readonly idle: boolean }\n\t| { readonly kind: \"fatal\"; readonly error: CrossedError }\n\t| { readonly kind: \"reloaded\"; readonly report: CrossedReport }\n\t| { readonly kind: \"reloaded\"; readonly error: CrossedError };\n\n/** `message` in its envelope, as it goes over the IPC channel. */\nexport function envelope(message: ToWorker | FromWorker): { readonly [ENVELOPE]: ToWorker | FromWorker } {\n\treturn { [ENVELOPE]: message };\n}\n\n/** The envelope's key: a control message is `{ \"chord.workers\": message }`. */\nconst ENVELOPE = \"chord.workers\";\n\n/**\n * The control message in an IPC message, or `undefined` for anything else (a link frame, the app's own). A trust\n * boundary in name only: both ends are the app's processes, so only the envelope is checked.\n */\nexport function controlOf<M extends ToWorker | FromWorker>(message: unknown): M | undefined {\n\tif (typeof message !== \"object\" || message === null || !(ENVELOPE in message)) return undefined;\n\t// Sent by the other end of this channel through `envelope`.\n\treturn (message as { readonly [ENVELOPE]: M })[ENVELOPE];\n}\n\n/** `error` as it crosses. */\nexport function crossed(error: unknown): CrossedError {\n\tif (isChordError(error)) {\n\t\treturn {\n\t\t\tmessage: error.message,\n\t\t\tcode: error.code,\n\t\t\t...(error.reason === undefined ? {} : { reason: error.reason }),\n\t\t};\n\t}\n\treturn { message: error instanceof Error ? error.message : String(error) };\n}\n\n/** A crossed error as an error again: a ChordError when its code is one, an `Error` otherwise. */\nexport function uncrossed(error: CrossedError): Error {\n\tif (error.code === undefined) return new Error(error.message);\n\ttry {\n\t\treturn chordErrorFromJson({\n\t\t\tcode: error.code,\n\t\t\tmessage: error.message,\n\t\t\t...(error.reason === undefined ? {} : { reason: error.reason }),\n\t\t});\n\t} catch {\n\t\treturn new Error(error.message);\n\t}\n}\n\n/** `report` as it crosses. */\nexport function crossedReport(report: ReloadReport): CrossedReport {\n\treturn {\n\t\tplugins: report.plugins,\n\t\tfailed: report.failed.map(({ plugin, error }) => ({ plugin, error: crossed(error) })),\n\t\tobjects: report.objects.map((each) =>\n\t\t\teach.kind === \"parked\"\n\t\t\t\t? {\n\t\t\t\t\t\tobject: each.object,\n\t\t\t\t\t\tkind: each.kind,\n\t\t\t\t\t\tcause: { kind: each.cause.kind, error: crossed(each.cause.error) },\n\t\t\t\t\t}\n\t\t\t\t: each,\n\t\t),\n\t};\n}\n\n/** A crossed report as a report again. */\nexport function uncrossedReport(report: CrossedReport): ReloadReport {\n\treturn {\n\t\tplugins: report.plugins,\n\t\tfailed: report.failed.map(({ plugin, error }) => ({ plugin, error: uncrossed(error) })),\n\t\tobjects: report.objects.map(({ object, kind, cause }) => {\n\t\t\tif (cause === undefined)\n\t\t\t\treturn { object, kind: kind as Exclude<ReloadReport[\"objects\"][number][\"kind\"], \"parked\"> };\n\t\t\tconst error = uncrossed(cause.error);\n\t\t\t// A parked object's cause is a ChordError on the worker; one that crossed without a code is wrapped as one.\n\t\t\tconst chord = isChordError(error) ? error : new ChordError({ code: \"unavailable\", message: error.message });\n\t\t\treturn { object, kind: \"parked\", cause: { kind: cause.kind, error: chord } as FailureCause };\n\t\t}),\n\t};\n}\n"]}

package/dist/next-node/workers/index.d.ts

@@ -1,5 +0,0 @@
-export type { CrossedError } from "./control.ts";
-export { type ProcessLock, processLock } from "./lock.ts";
-export { type WorkerMainOptions, type WorkerPlugins, type WorkerResult, type WorkerStart, workerMain, } from "./main.ts";
-export { createWorkers, type WorkerState, type Workers, type WorkersError, type WorkersOptions, } from "./workers.ts";
-//# sourceMappingURL=index.d.ts.map

package/dist/next-node/workers/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/next-node/workers/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,KAAK,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,UAAU,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,cAAc,GACnB,MAAM,cAAc,CAAC"}

package/dist/next-node/workers/index.js

@@ -1,7 +0,0 @@
-// Chord v2's workers component (`@earendil-works/chord/next/workers`, slice 10 §3, §4): a forked worker process per
-// address of a host kind, started on demand, stopped when idle, never restarted by itself, its plugins shipped from the
-// server; `workerMain` is the worker's side. Node-only.
-export { processLock } from "./lock.js";
-export { workerMain, } from "./main.js";
-export { createWorkers, } from "./workers.js";
-//# sourceMappingURL=index.js.map

package/dist/next-node/workers/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/next-node/workers/index.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,wHAAwH;AACxH,wDAAwD;AAGxD,OAAO,EAAoB,WAAW,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAKN,UAAU,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,aAAa,GAKb,MAAM,cAAc,CAAC","sourcesContent":["// Chord v2's workers component (`@earendil-works/chord/next/workers`, slice 10 §3, §4): a forked worker process per\n// address of a host kind, started on demand, stopped when idle, never restarted by itself, its plugins shipped from the\n// server; `workerMain` is the worker's side. Node-only.\n\nexport type { CrossedError } from \"./control.ts\";\nexport { type ProcessLock, processLock } from \"./lock.ts\";\nexport {\n\ttype WorkerMainOptions,\n\ttype WorkerPlugins,\n\ttype WorkerResult,\n\ttype WorkerStart,\n\tworkerMain,\n} from \"./main.ts\";\nexport {\n\tcreateWorkers,\n\ttype WorkerState,\n\ttype Workers,\n\ttype WorkersError,\n\ttype WorkersOptions,\n} from \"./workers.ts\";\n"]}

package/dist/next-node/workers/lock.d.ts

@@ -1,21 +0,0 @@
-import type { Context } from "../../context/index.ts";
-/** A held lock: `release` frees it (the process's exit does too). */
-export type ProcessLock = {
-    release(): Promise<void>;
-};
-/** Where a lock lives: an abstract socket (Linux, Android), a named pipe (Windows) or a socket file (elsewhere). */
-export type LockAddress = {
-    readonly kind: "abstract" | "pipe" | "file";
-    readonly address: string;
-};
-/**
- * Takes the lock `name`, waiting while another process holds it (until `context` aborts: rejects with its reason).
- * Throws what listening throws besides "in use", and for a stale socket file (macOS, the BSDs) an error naming it.
- */
-export declare function processLock(name: string, context: Context): Promise<ProcessLock>;
-/**
- * Takes the lock at `lock`, waiting while it is held. A socket file nobody accepts on (a crashed holder's) fails closed:
- * taking it over races another taker (two could both unlink and listen), so the error names the file to remove.
- */
-export declare function lockAt(lock: LockAddress, context: Context): Promise<ProcessLock>;
-//# sourceMappingURL=lock.d.ts.map

package/dist/next-node/workers/lock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/next-node/workers/lock.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAEvD,oHAAoH;AACpH,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAQtF;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAmCtF"}

package/dist/next-node/workers/lock.js

@@ -1,137 +0,0 @@
-// Process locks (slice 10 §3, Chord v1's `processLock`): one live worker per address. A lock is a listening socket the
-// kernel owns for the holder's lifetime (an abstract socket on Linux and Android, a named pipe on Windows, a socket file
-// elsewhere), so there is no race between two would-be holders; a socket file a crashed holder left fails closed (the
-// error names it: a takeover would race another taker). A child finding the lock held waits
-// without polling: it connects to the holder's socket, which the holder never answers, and tries again when that
-// connection closes (the holder exited).
-import { createHash } from "node:crypto";
-import { unlinkSync } from "node:fs";
-import { lstat, mkdir } from "node:fs/promises";
-import { connect, createServer } from "node:net";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-/**
- * Takes the lock `name`, waiting while another process holds it (until `context` aborts: rejects with its reason).
- * Throws what listening throws besides "in use", and for a stale socket file (macOS, the BSDs) an error naming it.
- */
-export async function processLock(name, context) {
-    const key = createHash("sha256").update(name).digest("hex").slice(0, 32);
-    if (process.platform === "win32")
-        return lockAt({ kind: "pipe", address: `\\\\.\\pipe\\chord-lock-${key}` }, context);
-    if (process.platform === "linux" || process.platform === "android") {
-        return lockAt({ kind: "abstract", address: `\0chord-lock-${key}` }, context);
-    }
-    return lockAt({ kind: "file", address: await socketPath(`chord-lock-${key}.sock`) }, context);
-}
-/**
- * Takes the lock at `lock`, waiting while it is held. A socket file nobody accepts on (a crashed holder's) fails closed:
- * taking it over races another taker (two could both unlink and listen), so the error names the file to remove.
- */
-export async function lockAt(lock, context) {
-    const { address } = lock;
-    const file = lock.kind === "file";
-    // Connections are kept open, never answered: a waiter learns of the release when its connection closes.
-    const waiters = new Set();
-    const server = createServer((socket) => {
-        waiters.add(socket);
-        socket.on("error", () => { });
-        socket.once("close", () => waiters.delete(socket));
-    });
-    for (;;) {
-        context.abortSignal?.throwIfAborted();
-        if (await listened(server, address))
-            break;
-        const held = await waitWhileHeld(address, context);
-        if (!held && file) {
-            throw new Error(`lock: ${address} is a stale lock file (no process holds it); remove it if no worker runs`);
-        }
-    }
-    const removeFile = () => {
-        try {
-            unlinkSync(address);
-        }
-        catch {
-            // Gone already.
-        }
-    };
-    if (file)
-        process.once("exit", removeFile);
-    return {
-        release: () => new Promise((resolve, reject) => {
-            if (file)
-                process.removeListener("exit", removeFile);
-            server.close((error) => (error ? reject(error) : resolve()));
-            // Waiters see their connections close (and `close` waits for them).
-            for (const socket of waiters)
-                socket.destroy();
-        }),
-    };
-}
-/** Whether `server` now listens on `address`; `false` when it is in use. */
-function listened(server, address) {
-    return new Promise((resolve, reject) => {
-        const failed = (error) => {
-            if (error.code === "EADDRINUSE")
-                resolve(false);
-            else
-                reject(error);
-        };
-        server.once("error", failed);
-        server.listen(address, () => {
-            server.removeListener("error", failed);
-            resolve(true);
-        });
-    });
-}
-/**
- * Connects to the holder of `address` and resolves when that connection closes or the address is gone (`true`: try
- * again), or with `false` when nobody accepts on it (a leftover socket file); `context`'s abort rejects.
- */
-function waitWhileHeld(address, context) {
-    return new Promise((resolve, reject) => {
-        const signal = context.abortSignal;
-        if (signal?.aborted) {
-            reject(signal.reason);
-            return;
-        }
-        const socket = connect(address);
-        const abort = () => {
-            socket.destroy();
-            reject(signal?.reason);
-        };
-        signal?.addEventListener("abort", abort, { once: true });
-        const settle = (held) => {
-            signal?.removeEventListener("abort", abort);
-            resolve(held);
-        };
-        let connected = false;
-        socket.once("connect", () => {
-            connected = true;
-        });
-        socket.on("error", (error) => {
-            if (!connected && error.code === "ECONNREFUSED")
-                settle(false);
-        });
-        socket.once("close", () => settle(true));
-    });
-}
-/** sun_path holds 104 bytes on macOS and the BSDs, the terminating NUL included. */
-const MAX_SOCKET_PATH_BYTES = 103;
-/**
- * A lock socket's path: in the temporary directory, or, when that does not fit in sun_path (a deep TMPDIR), in a
- * private per-user directory under /tmp that only its owner can reach.
- */
-async function socketPath(file) {
-    const preferred = join(tmpdir(), file);
-    if (Buffer.byteLength(preferred) <= MAX_SOCKET_PATH_BYTES)
-        return preferred;
-    const uid = process.getuid?.() ?? 0;
-    const directory = `/tmp/chord-lock-${uid}`;
-    await mkdir(directory, { mode: 0o700, recursive: true });
-    const stats = await lstat(directory);
-    if (!stats.isDirectory() || stats.uid !== uid || (stats.mode & 0o077) !== 0) {
-        throw new Error(`lock directory ${directory} must be a directory only its owner can access`);
-    }
-    return join(directory, file);
-}
-//# sourceMappingURL=lock.js.map

package/dist/next-node/workers/lock.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/next-node/workers/lock.ts"],"names":[],"mappings":"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","sourcesContent":["// Process locks (slice 10 §3, Chord v1's `processLock`): one live worker per address. A lock is a listening socket the\n// kernel owns for the holder's lifetime (an abstract socket on Linux and Android, a named pipe on Windows, a socket file\n// elsewhere), so there is no race between two would-be holders; a socket file a crashed holder left fails closed (the\n// error names it: a takeover would race another taker). A child finding the lock held waits\n// without polling: it connects to the holder's socket, which the holder never answers, and tries again when that\n// connection closes (the holder exited).\n\nimport { createHash } from \"node:crypto\";\nimport { unlinkSync } from \"node:fs\";\nimport { lstat, mkdir } from \"node:fs/promises\";\nimport { connect, createServer, type Server, type Socket } from \"node:net\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { Context } from \"../../context/index.ts\";\n\n/** A held lock: `release` frees it (the process's exit does too). */\nexport type ProcessLock = { release(): Promise<void> };\n\n/** Where a lock lives: an abstract socket (Linux, Android), a named pipe (Windows) or a socket file (elsewhere). */\nexport type LockAddress = { readonly kind: \"abstract\" | \"pipe\" | \"file\"; readonly address: string };\n\n/**\n * Takes the lock `name`, waiting while another process holds it (until `context` aborts: rejects with its reason).\n * Throws what listening throws besides \"in use\", and for a stale socket file (macOS, the BSDs) an error naming it.\n */\nexport async function processLock(name: string, context: Context): Promise<ProcessLock> {\n\tconst key = createHash(\"sha256\").update(name).digest(\"hex\").slice(0, 32);\n\tif (process.platform === \"win32\")\n\t\treturn lockAt({ kind: \"pipe\", address: `\\\\\\\\.\\\\pipe\\\\chord-lock-${key}` }, context);\n\tif (process.platform === \"linux\" || process.platform === \"android\") {\n\t\treturn lockAt({ kind: \"abstract\", address: `\\0chord-lock-${key}` }, context);\n\t}\n\treturn lockAt({ kind: \"file\", address: await socketPath(`chord-lock-${key}.sock`) }, context);\n}\n\n/**\n * Takes the lock at `lock`, waiting while it is held. A socket file nobody accepts on (a crashed holder's) fails closed:\n * taking it over races another taker (two could both unlink and listen), so the error names the file to remove.\n */\nexport async function lockAt(lock: LockAddress, context: Context): Promise<ProcessLock> {\n\tconst { address } = lock;\n\tconst file = lock.kind === \"file\";\n\t// Connections are kept open, never answered: a waiter learns of the release when its connection closes.\n\tconst waiters = new Set<Socket>();\n\tconst server = createServer((socket) => {\n\t\twaiters.add(socket);\n\t\tsocket.on(\"error\", () => {});\n\t\tsocket.once(\"close\", () => waiters.delete(socket));\n\t});\n\tfor (;;) {\n\t\tcontext.abortSignal?.throwIfAborted();\n\t\tif (await listened(server, address)) break;\n\t\tconst held = await waitWhileHeld(address, context);\n\t\tif (!held && file) {\n\t\t\tthrow new Error(`lock: ${address} is a stale lock file (no process holds it); remove it if no worker runs`);\n\t\t}\n\t}\n\tconst removeFile = (): void => {\n\t\ttry {\n\t\t\tunlinkSync(address);\n\t\t} catch {\n\t\t\t// Gone already.\n\t\t}\n\t};\n\tif (file) process.once(\"exit\", removeFile);\n\treturn {\n\t\trelease: () =>\n\t\t\tnew Promise<void>((resolve, reject) => {\n\t\t\t\tif (file) process.removeListener(\"exit\", removeFile);\n\t\t\t\tserver.close((error) => (error ? reject(error) : resolve()));\n\t\t\t\t// Waiters see their connections close (and `close` waits for them).\n\t\t\t\tfor (const socket of waiters) socket.destroy();\n\t\t\t}),\n\t};\n}\n\n/** Whether `server` now listens on `address`; `false` when it is in use. */\nfunction listened(server: Server, address: string): Promise<boolean> {\n\treturn new Promise<boolean>((resolve, reject) => {\n\t\tconst failed = (error: NodeJS.ErrnoException): void => {\n\t\t\tif (error.code === \"EADDRINUSE\") resolve(false);\n\t\t\telse reject(error);\n\t\t};\n\t\tserver.once(\"error\", failed);\n\t\tserver.listen(address, () => {\n\t\t\tserver.removeListener(\"error\", failed);\n\t\t\tresolve(true);\n\t\t});\n\t});\n}\n\n/**\n * Connects to the holder of `address` and resolves when that connection closes or the address is gone (`true`: try\n * again), or with `false` when nobody accepts on it (a leftover socket file); `context`'s abort rejects.\n */\nfunction waitWhileHeld(address: string, context: Context): Promise<boolean> {\n\treturn new Promise<boolean>((resolve, reject) => {\n\t\tconst signal = context.abortSignal;\n\t\tif (signal?.aborted) {\n\t\t\treject(signal.reason);\n\t\t\treturn;\n\t\t}\n\t\tconst socket = connect(address);\n\t\tconst abort = (): void => {\n\t\t\tsocket.destroy();\n\t\t\treject(signal?.reason);\n\t\t};\n\t\tsignal?.addEventListener(\"abort\", abort, { once: true });\n\t\tconst settle = (held: boolean): void => {\n\t\t\tsignal?.removeEventListener(\"abort\", abort);\n\t\t\tresolve(held);\n\t\t};\n\t\tlet connected = false;\n\t\tsocket.once(\"connect\", () => {\n\t\t\tconnected = true;\n\t\t});\n\t\tsocket.on(\"error\", (error: NodeJS.ErrnoException) => {\n\t\t\tif (!connected && error.code === \"ECONNREFUSED\") settle(false);\n\t\t});\n\t\tsocket.once(\"close\", () => settle(true));\n\t});\n}\n\n/** sun_path holds 104 bytes on macOS and the BSDs, the terminating NUL included. */\nconst MAX_SOCKET_PATH_BYTES = 103;\n\n/**\n * A lock socket's path: in the temporary directory, or, when that does not fit in sun_path (a deep TMPDIR), in a\n * private per-user directory under /tmp that only its owner can reach.\n */\nasync function socketPath(file: string): Promise<string> {\n\tconst preferred = join(tmpdir(), file);\n\tif (Buffer.byteLength(preferred) <= MAX_SOCKET_PATH_BYTES) return preferred;\n\tconst uid = process.getuid?.() ?? 0;\n\tconst directory = `/tmp/chord-lock-${uid}`;\n\tawait mkdir(directory, { mode: 0o700, recursive: true });\n\tconst stats = await lstat(directory);\n\tif (!stats.isDirectory() || stats.uid !== uid || (stats.mode & 0o077) !== 0) {\n\t\tthrow new Error(`lock directory ${directory} must be a directory only its owner can access`);\n\t}\n\treturn join(directory, file);\n}\n"]}

package/dist/next-node/workers/main.d.ts

@@ -1,46 +0,0 @@
-import { type Context } from "../../context/index.ts";
-import type { JsonValue } from "../../json.ts";
-import type { Address } from "../../next/contracts/index.ts";
-import type { Principal } from "../../next/data/index.ts";
-import type { Host, LoadReport, PluginFacet } from "../../next/host/index.ts";
-import { type Link } from "../../next/link/index.ts";
-import type { Watchable } from "../../watch.ts";
-import type { HostPackages } from "../plugins/evaluate.ts";
-import { type CrossedError } from "./control.ts";
-/** What the app's function gets. */
-export type WorkerStart = {
-    readonly address: Address;
-    /** The start data the server's `start(address)` gave. */
-    readonly start: JsonValue;
-    /** The link to the server: `connect` it before anything slow (`started` goes out then). */
-    readonly parent: Link;
-    readonly plugins: WorkerPlugins;
-    /** Registers a closer: closers run in reverse order at shutdown. */
-    onClose(closer: (context: Context) => Promise<void> | void): void;
-};
-/** The worker's plugins: the shipped scripts of its kind, loaded on its host; the server's reloads applied to it. */
-export interface WorkerPlugins {
-    /** Loads `host` with the start message's scripts of `kind` and `core` (the app's own facets). */
-    load<P extends Principal>(host: Host<P>, options: {
-        readonly kind: string;
-        readonly core: readonly PluginFacet<P>[];
-    }, context: Context): Promise<LoadReport>;
-}
-/** What the app's function returns: extra keep-alive counts (busy while any is nonzero). */
-export type WorkerResult = {
-    readonly busy?: Watchable<Readonly<Record<string, number>>>;
-};
-/** What `workerMain` takes besides the app's function. */
-export type WorkerMainOptions = {
-    /** The host packages by specifier: this process's own instances (functions cannot cross IPC). */
-    readonly hostPackages: HostPackages;
-    /** What crosses as `fatal` for an error (never the original message unless this returns it). */
-    readonly redact: (error: unknown) => CrossedError;
-    readonly onError: (error: unknown) => void;
-};
-/**
- * Runs this process as a worker: `fn` once the start message arrived and the lock is taken. An uncaught error or a
- * throwing `fn` sends `fatal` (redacted) and exits.
- */
-export declare function workerMain(fn: (start: WorkerStart, context: Context) => Promise<WorkerResult | undefined>, options: WorkerMainOptions): void;
-//# sourceMappingURL=main.d.ts.map

package/dist/next-node/workers/main.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/next-node/workers/main.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,OAAO,EAAmB,MAAM,wBAAwB,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAgB,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAyB,KAAK,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EACN,KAAK,YAAY,EAOjB,MAAM,cAAc,CAAC;AAGtB,oCAAoC;AACpC,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,oEAAoE;IACpE,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CAClE,CAAC;AAEF,qHAAqH;AACrH,MAAM,WAAW,aAAa;IAC7B,iGAAiG;IACjG,IAAI,CAAC,CAAC,SAAS,SAAS,EACvB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;KAAE,EAC5E,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,UAAU,CAAC,CAAC;CACvB;AAED,4FAA4F;AAC5F,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAE3F,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG;IAC/B,iGAAiG;IACjG,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,gGAAgG;IAChG,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,YAAY,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CACzB,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,EAC/E,OAAO,EAAE,iBAAiB,GACxB,IAAI,CAGN"}