effect 4.0.0-beta.66 → 4.0.0-beta.68

package/dist/unstable/cli/internal/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli/internal/config.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AAMpC,QAAA,MAAM,oBAAoB,EAAG,qCAA8C,CAAA;AAM3E;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,OAAO,oBAAoB,CAAA;IAC5D,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IACpD,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC5C,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChD,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC;;;OAGG;IACH,UAAiB,IAAI;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KACpB;IAED;;;;;;OAMG;IACH,KAAY,IAAI,GACZ;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAClD;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,CAAA;KAAE,GAClE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAA;CACrD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli/internal/config.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AAMpC,QAAA,MAAM,oBAAoB,EAAG,qCAA8C,CAAA;AAM3E;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,OAAO,oBAAoB,CAAA;IAC5D,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IACpD,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC5C,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChD,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAA;CACnC;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC;;;OAGG;IACH,UAAiB,IAAI;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KACpB;IAED;;;;;;OAMG;IACH,KAAY,IAAI,GACZ;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAClD;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,CAAA;KAAE,GAClE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAA;CACrD"}

package/dist/unstable/cli/internal/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":["Predicate","Param","ConfigInternalTypeId","isConfigInternal","u","hasProperty","parseConfig","config","orderedParams","flags","args","parse","tree","key","parseValue","value","Array","isArray","_tag","children","map","v","isParam","index","length","push","kind","arguments","emptyConfig","shiftNodeIndexes","node","offset","child","shiftTreeIndexes","output","mergeConfig","left","right","reconstructTree","results","nodeValue"],"sources":["../../../../src/unstable/cli/internal/config.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,OAAO,KAAKA,SAAS,MAAM,uBAAuB;AAClD,OAAO,KAAKC,KAAK,MAAM,aAAa;AAEpC;AACA;AACA;AAEA,MAAMC,oBAAoB,GAAG,qCAA8C;AAiD3E;AACA;AACA;AAEA;AACA,OAAO,MAAMC,gBAAgB,GAAIC,CAAU,IAA0BJ,SAAS,CAACK,WAAW,CAACD,CAAC,EAAEF,oBAAoB,CAAC;AAiBnH;;;;;;;;;;AAUA,OAAO,MAAMI,WAAW,GAAIC,MAAc,IAAoB;EAC5D,MAAMC,aAAa,GAAqB,EAAE;EAC1C,MAAMC,KAAK,GAAyB,EAAE;EACtC,MAAMC,IAAI,GAA6B,EAAE;EAEzC,SAASC,KAAKA,CAACJ,MAAc;IAC3B,MAAMK,IAAI,GAAwB,EAAE;IACpC,KAAK,MAAMC,GAAG,IAAIN,MAAM,EAAE;MACxBK,IAAI,CAACC,GAAG,CAAC,GAAGC,UAAU,CAACP,MAAM,CAACM,GAAG,CAAC,CAAC;IACrC;IACA,OAAOD,IAAI;EACb;EAEA,SAASE,UAAUA,CACjBC,KAA6D;IAE7D,IAAIC,KAAK,CAACC,OAAO,CAACF,KAAK,CAAC,EAAE;MACxB,OAAO;QACLG,IAAI,EAAE,OAAO;QACbC,QAAQ,EAAGJ,KAAoB,CAACK,GAAG,CAAEC,CAAC,IAAKP,UAAU,CAACO,CAAC,CAAC;OACzD;IACH,CAAC,MAAM,IAAIpB,KAAK,CAACqB,OAAO,CAACP,KAAK,CAAC,EAAE;MAC/B,MAAMQ,KAAK,GAAGf,aAAa,CAACgB,MAAM;MAClChB,aAAa,CAACiB,IAAI,CAACV,KAAK,CAAC;MAEzB,IAAIA,KAAK,CAACW,IAAI,KAAK,UAAU,EAAE;QAC7BhB,IAAI,CAACe,IAAI,CAACV,KAA0B,CAAC;MACvC,CAAC,MAAM;QACLN,KAAK,CAACgB,IAAI,CAACV,KAAsB,CAAC;MACpC;MAEA,OAAO;QAAEG,IAAI,EAAE,OAAO;QAAEK;MAAK,CAAE;IACjC,CAAC,MAAM;MACL,OAAO;QACLL,IAAI,EAAE,QAAQ;QACdN,IAAI,EAAED,KAAK,CAACI,KAAe;OAC5B;IACH;EACF;EAEA,OAAO;IACL,CAACb,oBAAoB,GAAGA,oBAAoB;IAC5CO,KAAK;IACLkB,SAAS,EAAEjB,IAAI;IACfF,aAAa;IACbI,IAAI,EAAED,KAAK,CAACJ,MAAM;GACnB;AACH,CAAC;AAED;AACA,OAAO,MAAMqB,WAAW,gBAAmBtB,WAAW,CAAC,EAAE,CAAC;AAE1D,MAAMuB,gBAAgB,GAAGA,CAACC,IAAyB,EAAEC,MAAc,KAAyB;EAC1F,QAAQD,IAAI,CAACZ,IAAI;IACf,KAAK,OAAO;MACV,OAAO;QACLA,IAAI,EAAE,OAAO;QACbK,KAAK,EAAEO,IAAI,CAACP,KAAK,GAAGQ;OACrB;IACH,KAAK,OAAO;MACV,OAAO;QACLb,IAAI,EAAE,OAAO;QACbC,QAAQ,EAAEW,IAAI,CAACX,QAAQ,CAACC,GAAG,CAAEY,KAAK,IAAKH,gBAAgB,CAACG,KAAK,EAAED,MAAM,CAAC;OACvE;IACH,KAAK,QAAQ;MACX,OAAO;QACLb,IAAI,EAAE,QAAQ;QACdN,IAAI,EAAEqB,gBAAgB,CAACH,IAAI,CAAClB,IAAI,EAAEmB,MAAM;OACzC;EACL;AACF,CAAC;AAED,MAAME,gBAAgB,GAAGA,CAACrB,IAAyB,EAAEmB,MAAc,KAAyB;EAC1F,MAAMG,MAAM,GAAwB,EAAE;EACtC,KAAK,MAAMrB,GAAG,IAAID,IAAI,EAAE;IACtBsB,MAAM,CAACrB,GAAG,CAAC,GAAGgB,gBAAgB,CAACjB,IAAI,CAACC,GAAG,CAAC,EAAEkB,MAAM,CAAC;EACnD;EACA,OAAOG,MAAM;AACf,CAAC;AAED;AACA,OAAO,MAAMC,WAAW,GAAGA,CACzBC,IAAoB,EACpBC,KAAqB,KACH;EAClB,MAAMN,MAAM,GAAGK,IAAI,CAAC5B,aAAa,CAACgB,MAAM;EACxC,OAAO;IACL,CAACtB,oBAAoB,GAAGA,oBAAoB;IAC5CO,KAAK,EAAE,CAAC,GAAG2B,IAAI,CAAC3B,KAAK,EAAE,GAAG4B,KAAK,CAAC5B,KAAK,CAAC;IACtCkB,SAAS,EAAE,CAAC,GAAGS,IAAI,CAACT,SAAS,EAAE,GAAGU,KAAK,CAACV,SAAS,CAAC;IAClDnB,aAAa,EAAE,CAAC,GAAG4B,IAAI,CAAC5B,aAAa,EAAE,GAAG6B,KAAK,CAAC7B,aAAa,CAAC;IAC9DI,IAAI,EAAE;MACJ,GAAGwB,IAAI,CAACxB,IAAI;MACZ,GAAGqB,gBAAgB,CAACI,KAAK,CAACzB,IAAI,EAAEmB,MAAM;;GAEzC;AACH,CAAC;AAED;AACA;AACA;AAEA;;;;;;;;AAQA,OAAO,MAAMO,eAAe,GAAGA,CAC7B1B,IAAyB,EACzB2B,OAA2B,KACJ;EACvB,MAAML,MAAM,GAAwB,EAAE;EAEtC,KAAK,MAAMrB,GAAG,IAAID,IAAI,EAAE;IACtBsB,MAAM,CAACrB,GAAG,CAAC,GAAG2B,SAAS,CAAC5B,IAAI,CAACC,GAAG,CAAC,CAAC;EACpC;EAEA,OAAOqB,MAAM;EAEb,SAASM,SAASA,CAACV,IAAyB;IAC1C,QAAQA,IAAI,CAACZ,IAAI;MACf,KAAK,OAAO;QACV,OAAOqB,OAAO,CAACT,IAAI,CAACP,KAAK,CAAC;MAC5B,KAAK,OAAO;QACV,OAAOO,IAAI,CAACX,QAAQ,CAACC,GAAG,CAAEY,KAAK,IAAKQ,SAAS,CAACR,KAAK,CAAC,CAAC;MACvD,KAAK,QAAQ;QACX,OAAOM,eAAe,CAACR,IAAI,CAAClB,IAAI,EAAE2B,OAAO,CAAC;IAC9C;EACF;AACF,CAAC","ignoreList":[]}
+{"version":3,"file":"config.js","names":["Predicate","Param","ConfigInternalTypeId","isConfigInternal","u","hasProperty","parseConfig","config","orderedParams","flags","args","parse","tree","key","parseValue","value","Array","isArray","_tag","children","map","v","isParam","index","length","push","kind","arguments","emptyConfig","shiftNodeIndexes","node","offset","child","shiftTreeIndexes","output","mergeConfig","left","right","reconstructTree","results","nodeValue"],"sources":["../../../../src/unstable/cli/internal/config.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/cli/internal/lexer.js.map

@@ -1 +1 @@
-{"version":3,"file":"lexer.js","names":["lex","argv","endIndex","indexOf","tokens","lexTokens","trailingOperands","slice","args","arg","startsWith","push","_tag","value","name","split","raw","length","flags","equalIndex","flag","ch"],"sources":["../../../../src/unstable/cli/internal/lexer.ts"],"sourcesContent":[null],"mappings":"AAYA;AACA,OAAM,SAAUA,GAAGA,CAACC,IAA2B;EAC7C,MAAMC,QAAQ,GAAGD,IAAI,CAACE,OAAO,CAAC,IAAI,CAAC;EAEnC,IAAID,QAAQ,KAAK,CAAC,CAAC,EAAE;IACnB;IACA,OAAO;MACLE,MAAM,EAAEC,SAAS,CAACJ,IAAI,CAAC;MACvBK,gBAAgB,EAAE;KACnB;EACH;EAEA;EACA,OAAO;IACLF,MAAM,EAAEC,SAAS,CAACJ,IAAI,CAACM,KAAK,CAAC,CAAC,EAAEL,QAAQ,CAAC,CAAC;IAC1CI,gBAAgB,EAAEL,IAAI,CAACM,KAAK,CAACL,QAAQ,GAAG,CAAC;GAC1C;AACH;AAEA,MAAMG,SAAS,GAAIG,IAA2B,IAA0B;EACtE,MAAMJ,MAAM,GAAiB,EAAE;EAE/B,KAAK,MAAMK,GAAG,IAAID,IAAI,EAAE;IACtB,IAAI,CAACC,GAAG,CAACC,UAAU,CAAC,GAAG,CAAC,EAAE;MACxBN,MAAM,CAACO,IAAI,CAAC;QAAEC,IAAI,EAAE,OAAO;QAAEC,KAAK,EAAEJ;MAAG,CAAE,CAAC;IAC5C,CAAC,MAAM,IAAIA,GAAG,CAACC,UAAU,CAAC,IAAI,CAAC,EAAE;MAC/B,MAAM,CAACI,IAAI,EAAED,KAAK,CAAC,GAAGJ,GAAG,CAACF,KAAK,CAAC,CAAC,CAAC,CAACQ,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;MAChDX,MAAM,CAACO,IAAI,CAAC;QAAEC,IAAI,EAAE,YAAY;QAAEE,IAAI;QAAEE,GAAG,EAAEP,GAAG;QAAEI;MAAK,CAAE,CAAC;IAC5D,CAAC,MAAM,IAAIJ,GAAG,CAACQ,MAAM,GAAG,CAAC,EAAE;MACzB,MAAMC,KAAK,GAAGT,GAAG,CAACF,KAAK,CAAC,CAAC,CAAC;MAC1B,MAAMY,UAAU,GAAGD,KAAK,CAACf,OAAO,CAAC,GAAG,CAAC;MACrC,IAAIgB,UAAU,KAAK,CAAC,CAAC,EAAE;QACrB,MAAMC,IAAI,GAAGF,KAAK,CAACX,KAAK,CAAC,CAAC,EAAEY,UAAU,CAAC;QACvC,MAAMN,KAAK,GAAGK,KAAK,CAACX,KAAK,CAACY,UAAU,GAAG,CAAC,CAAC;QACzCf,MAAM,CAACO,IAAI,CAAC;UAAEC,IAAI,EAAE,aAAa;UAAEQ,IAAI;UAAEJ,GAAG,EAAE,IAAII,IAAI,EAAE;UAAEP;QAAK,CAAE,CAAC;MACpE,CAAC,MAAM;QACL,KAAK,MAAMQ,EAAE,IAAIH,KAAK,EAAE;UACtBd,MAAM,CAACO,IAAI,CAAC;YAAEC,IAAI,EAAE,aAAa;YAAEQ,IAAI,EAAEC,EAAE;YAAEL,GAAG,EAAE,IAAIK,EAAE;UAAE,CAAE,CAAC;QAC/D;MACF;IACF,CAAC,MAAM;MACLjB,MAAM,CAACO,IAAI,CAAC;QAAEC,IAAI,EAAE,OAAO;QAAEC,KAAK,EAAEJ;MAAG,CAAE,CAAC;IAC5C;EACF;EAEA,OAAOL,MAAM;AACf,CAAC","ignoreList":[]}
+{"version":3,"file":"lexer.js","names":["lex","argv","endIndex","indexOf","tokens","lexTokens","trailingOperands","slice","args","arg","startsWith","push","_tag","value","name","split","raw","length","flags","equalIndex","flag","ch"],"sources":["../../../../src/unstable/cli/internal/lexer.ts"],"sourcesContent":[null],"mappings":"AAuBA;AACA,OAAM,SAAUA,GAAGA,CAACC,IAA2B;EAC7C,MAAMC,QAAQ,GAAGD,IAAI,CAACE,OAAO,CAAC,IAAI,CAAC;EAEnC,IAAID,QAAQ,KAAK,CAAC,CAAC,EAAE;IACnB;IACA,OAAO;MACLE,MAAM,EAAEC,SAAS,CAACJ,IAAI,CAAC;MACvBK,gBAAgB,EAAE;KACnB;EACH;EAEA;EACA,OAAO;IACLF,MAAM,EAAEC,SAAS,CAACJ,IAAI,CAACM,KAAK,CAAC,CAAC,EAAEL,QAAQ,CAAC,CAAC;IAC1CI,gBAAgB,EAAEL,IAAI,CAACM,KAAK,CAACL,QAAQ,GAAG,CAAC;GAC1C;AACH;AAEA,MAAMG,SAAS,GAAIG,IAA2B,IAA0B;EACtE,MAAMJ,MAAM,GAAiB,EAAE;EAE/B,KAAK,MAAMK,GAAG,IAAID,IAAI,EAAE;IACtB,IAAI,CAACC,GAAG,CAACC,UAAU,CAAC,GAAG,CAAC,EAAE;MACxBN,MAAM,CAACO,IAAI,CAAC;QAAEC,IAAI,EAAE,OAAO;QAAEC,KAAK,EAAEJ;MAAG,CAAE,CAAC;IAC5C,CAAC,MAAM,IAAIA,GAAG,CAACC,UAAU,CAAC,IAAI,CAAC,EAAE;MAC/B,MAAM,CAACI,IAAI,EAAED,KAAK,CAAC,GAAGJ,GAAG,CAACF,KAAK,CAAC,CAAC,CAAC,CAACQ,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;MAChDX,MAAM,CAACO,IAAI,CAAC;QAAEC,IAAI,EAAE,YAAY;QAAEE,IAAI;QAAEE,GAAG,EAAEP,GAAG;QAAEI;MAAK,CAAE,CAAC;IAC5D,CAAC,MAAM,IAAIJ,GAAG,CAACQ,MAAM,GAAG,CAAC,EAAE;MACzB,MAAMC,KAAK,GAAGT,GAAG,CAACF,KAAK,CAAC,CAAC,CAAC;MAC1B,MAAMY,UAAU,GAAGD,KAAK,CAACf,OAAO,CAAC,GAAG,CAAC;MACrC,IAAIgB,UAAU,KAAK,CAAC,CAAC,EAAE;QACrB,MAAMC,IAAI,GAAGF,KAAK,CAACX,KAAK,CAAC,CAAC,EAAEY,UAAU,CAAC;QACvC,MAAMN,KAAK,GAAGK,KAAK,CAACX,KAAK,CAACY,UAAU,GAAG,CAAC,CAAC;QACzCf,MAAM,CAACO,IAAI,CAAC;UAAEC,IAAI,EAAE,aAAa;UAAEQ,IAAI;UAAEJ,GAAG,EAAE,IAAII,IAAI,EAAE;UAAEP;QAAK,CAAE,CAAC;MACpE,CAAC,MAAM;QACL,KAAK,MAAMQ,EAAE,IAAIH,KAAK,EAAE;UACtBd,MAAM,CAACO,IAAI,CAAC;YAAEC,IAAI,EAAE,aAAa;YAAEQ,IAAI,EAAEC,EAAE;YAAEL,GAAG,EAAE,IAAIK,EAAE;UAAE,CAAE,CAAC;QAC/D;MACF;IACF,CAAC,MAAM;MACLjB,MAAM,CAACO,IAAI,CAAC;QAAEC,IAAI,EAAE,OAAO;QAAEC,KAAK,EAAEJ;MAAG,CAAE,CAAC;IAC5C;EACF;EAEA,OAAOL,MAAM;AACf,CAAC","ignoreList":[]}

package/dist/unstable/cli/internal/parser.js

@@ -103,7 +103,6 @@ const makeCursor = tokens => {
 /* ========================================================================== */
 /**
  * Creates a registry for O(1) flag lookup by name or alias.
- * @throws Error if duplicate names or aliases are detected (developer error)
  * @internal
  */
 export const createFlagRegistry = params => {

package/dist/unstable/cli/internal/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","names":["Effect","Option","CliError","Param","Primitive","suggest","toImpl","getCommandPath","parsedInput","match","subcommand","onNone","onSome","name","parseArgs","lexResult","command","commandPath","gen","tokens","trailingOperands","afterEndOfOptions","newCommandPath","commandImpl","singles","config","flags","flatMap","extractSingleParams","flagParams","filter","isFlagParam","flagRegistry","createFlagRegistry","inheritedSingles","contextConfig","inheritedFlagParams","inheritedFlagRegistry","inheritedNames","Set","map","param","context","localFlagNames","has","result","scanCommandLevel","_tag","arguments","none","errors","length","subLex","childTokens","subParsed","sub","allErrors","some","makeCursor","i","peek","take","rest","slice","params","index","Map","Error","set","alias","aliases","get","buildSubcommandIndex","subcommands","setKey","key","existing","group","commands","createEmptyFlagMap","Object","fromEntries","p","createFlagAccumulator","add","raw","undefined","push","merge","from","values","snapshot","isFlagToken","t","getFlagName","flag","resolveFlag","token","registry","tokenName","direct","negated","startsWith","canonicalName","isBoolean","primitiveType","invalidNegatedFlagValue","spec","value","InvalidValue","option","expected","kind","asBooleanLiteral","isTrueValue","isFalseValue","consumeFlagValue","cursor","error","literal","next","consumeKnownFlags","flagMap","remainder","resolved","consumed","createUnrecognizedFlagError","printable","validNames","suggestions","n","UnrecognizedOption","createParseState","mode","toLeafResult","state","resolveFirstValue","subIndex","selectedPath","parentFlags","localFlagName","tail","expectsArgs","size","Array","keys","UnknownSubcommand","parent","processFlag","processValue","subResult"],"sources":["../../../../src/unstable/cli/internal/parser.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"parser.js","names":["Effect","Option","CliError","Param","Primitive","suggest","toImpl","getCommandPath","parsedInput","match","subcommand","onNone","onSome","name","parseArgs","lexResult","command","commandPath","gen","tokens","trailingOperands","afterEndOfOptions","newCommandPath","commandImpl","singles","config","flags","flatMap","extractSingleParams","flagParams","filter","isFlagParam","flagRegistry","createFlagRegistry","inheritedSingles","contextConfig","inheritedFlagParams","inheritedFlagRegistry","inheritedNames","Set","map","param","context","localFlagNames","has","result","scanCommandLevel","_tag","arguments","none","errors","length","subLex","childTokens","subParsed","sub","allErrors","some","makeCursor","i","peek","take","rest","slice","params","index","Map","Error","set","alias","aliases","get","buildSubcommandIndex","subcommands","setKey","key","existing","group","commands","createEmptyFlagMap","Object","fromEntries","p","createFlagAccumulator","add","raw","undefined","push","merge","from","values","snapshot","isFlagToken","t","getFlagName","flag","resolveFlag","token","registry","tokenName","direct","negated","startsWith","canonicalName","isBoolean","primitiveType","invalidNegatedFlagValue","spec","value","InvalidValue","option","expected","kind","asBooleanLiteral","isTrueValue","isFalseValue","consumeFlagValue","cursor","error","literal","next","consumeKnownFlags","flagMap","remainder","resolved","consumed","createUnrecognizedFlagError","printable","validNames","suggestions","n","UnrecognizedOption","createParseState","mode","toLeafResult","state","resolveFirstValue","subIndex","selectedPath","parentFlags","localFlagName","tail","expectsArgs","size","Array","keys","UnknownSubcommand","parent","processFlag","processValue","subResult"],"sources":["../../../../src/unstable/cli/internal/parser.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/cluster/ClusterCron.d.ts

@@ -1,4 +1,32 @@
 /**
+ * The `ClusterCron` module provides a small integration between cron schedules
+ * and cluster sharding. It turns a `Cron.Cron` schedule into a `Layer` that
+ * coordinates one recurring job across a cluster by registering a singleton for
+ * the initial scheduling step and a persisted entity message for each run.
+ *
+ * This is useful for distributed maintenance work such as periodic cleanup,
+ * reconciliation, report generation, cache refreshes, or polling external
+ * systems where the job should be owned by the cluster rather than by every
+ * runner independently.
+ *
+ * **Mental model**
+ *
+ * - {@link make} registers a named cluster cron job as a layer
+ * - a singleton schedules the first run for the selected shard group
+ * - each run is delivered as a persisted entity message at its scheduled time
+ * - after a run exits, the handler schedules the next occurrence
+ * - stale runs can be skipped with `skipIfOlderThan`
+ *
+ * **Gotchas**
+ *
+ * - Job effects should be idempotent because persisted messages, retries, and
+ *   runner failover are part of normal distributed execution.
+ * - By default, the next run is calculated from the current time after the
+ *   handler exits; use `calculateNextRunFromPrevious` when preserving the
+ *   schedule cadence is more important than catching up from delays.
+ * - Long outages can produce old scheduled messages; keep `skipIfOlderThan`
+ *   aligned with the job's business semantics.
+ *
  * @since 4.0.0
  */
 import * as Cron from "../../Cron.ts";
@@ -8,8 +36,14 @@ import * as Layer from "../../Layer.ts";
 import type { Scope } from "../../Scope.ts";
 import type { Sharding } from "./Sharding.ts";
 /**
+ * Creates a layer that runs a cron job through the cluster sharding system.
+ *
+ * The job is scheduled as persisted entity messages, with an initial singleton
+ * scheduling step and optional controls for shard group, next-run calculation,
+ * and skipping stale scheduled runs.
+ *
+ * @category constructors
  * @since 4.0.0
- * @category Constructors
  */
 export declare const make: <E, R>(options: {
     readonly name: string;

package/dist/unstable/cluster/ClusterCron.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClusterCron.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/ClusterCron.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AAErC,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAKvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAM3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAG7C;;;GAGG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EAAE,SAAS;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAE3C;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,4BAA4B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAE3D;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAA;CACtD,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAuEzD,CAAA"}
+{"version":3,"file":"ClusterCron.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/ClusterCron.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AAErC,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAKvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAM3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAG7C;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EAAE,SAAS;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAE3C;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,4BAA4B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAE3D;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAA;CACtD,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAuEzD,CAAA"}

package/dist/unstable/cluster/ClusterCron.js

@@ -1,4 +1,32 @@
 /**
+ * The `ClusterCron` module provides a small integration between cron schedules
+ * and cluster sharding. It turns a `Cron.Cron` schedule into a `Layer` that
+ * coordinates one recurring job across a cluster by registering a singleton for
+ * the initial scheduling step and a persisted entity message for each run.
+ *
+ * This is useful for distributed maintenance work such as periodic cleanup,
+ * reconciliation, report generation, cache refreshes, or polling external
+ * systems where the job should be owned by the cluster rather than by every
+ * runner independently.
+ *
+ * **Mental model**
+ *
+ * - {@link make} registers a named cluster cron job as a layer
+ * - a singleton schedules the first run for the selected shard group
+ * - each run is delivered as a persisted entity message at its scheduled time
+ * - after a run exits, the handler schedules the next occurrence
+ * - stale runs can be skipped with `skipIfOlderThan`
+ *
+ * **Gotchas**
+ *
+ * - Job effects should be idempotent because persisted messages, retries, and
+ *   runner failover are part of normal distributed execution.
+ * - By default, the next run is calculated from the current time after the
+ *   handler exits; use `calculateNextRunFromPrevious` when preserving the
+ *   schedule cadence is more important than catching up from delays.
+ * - Long outages can produce old scheduled messages; keep `skipIfOlderThan`
+ *   aligned with the job's business semantics.
+ *
  * @since 4.0.0
  */
 import * as Cron from "../../Cron.js";
@@ -18,8 +46,14 @@ import * as DeliverAt from "./DeliverAt.js";
 import * as Entity from "./Entity.js";
 import * as Singleton from "./Singleton.js";
 /**
+ * Creates a layer that runs a cron job through the cluster sharding system.
+ *
+ * The job is scheduled as persisted entity messages, with an initial singleton
+ * scheduling step and optional controls for shard group, next-run calculation,
+ * and skipping stale scheduled runs.
+ *
+ * @category constructors
  * @since 4.0.0
- * @category Constructors
  */
 export const make = options => {
   const CronEntity = Entity.make(`ClusterCron/${options.name}`, [Rpc.make("run", {

package/dist/unstable/cluster/ClusterCron.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClusterCron.js","names":["Cron","DateTime","Duration","Effect","Exit","Layer","Option","PrimaryKey","Schedule","Schema","Rpc","ClusterSchema","Persisted","Uninterruptible","DeliverAt","Entity","Singleton","make","options","CronEntity","name","payload","CronPayload","annotate","ShardGroup","shardGroup","ClientTracingEnabled","InitialRun","gen","now","next","fromDateUnsafe","cron","entityId","calculateNextRunFromPrevious","formatIso","client","run","dateTime","discard","skipIfOlderThan","fromUndefinedOr","pipe","map","fromInputUnsafe","getOrElse","days","effect","fnUntraced","isLessThan","subtractDuration","execute","orDie","EntityLayer","toLayer","makeClient","request","onExitPrimitive","exit","isFailure","logWarning","cause","tapCause","sandbox","retry","retryPolicy","annotateLogs","module","merge","exponential","either","spaced","Class","DateTimeUtc","symbol"],"sources":["../../../src/unstable/cluster/ClusterCron.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ClusterCron.js","names":["Cron","DateTime","Duration","Effect","Exit","Layer","Option","PrimaryKey","Schedule","Schema","Rpc","ClusterSchema","Persisted","Uninterruptible","DeliverAt","Entity","Singleton","make","options","CronEntity","name","payload","CronPayload","annotate","ShardGroup","shardGroup","ClientTracingEnabled","InitialRun","gen","now","next","fromDateUnsafe","cron","entityId","calculateNextRunFromPrevious","formatIso","client","run","dateTime","discard","skipIfOlderThan","fromUndefinedOr","pipe","map","fromInputUnsafe","getOrElse","days","effect","fnUntraced","isLessThan","subtractDuration","execute","orDie","EntityLayer","toLayer","makeClient","request","onExitPrimitive","exit","isFailure","logWarning","cause","tapCause","sandbox","retry","retryPolicy","annotateLogs","module","merge","exponential","either","spaced","Class","DateTimeUtc","symbol"],"sources":["../../../src/unstable/cluster/ClusterCron.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/cluster/ClusterError.d.ts

@@ -1,4 +1,25 @@
 /**
+ * The `ClusterError` module defines the typed error values used by the
+ * unstable cluster runtime when routing messages to entities, coordinating
+ * runners, and persisting mailbox work.
+ *
+ * These errors are useful when implementing cluster transports, runner
+ * supervision, mailbox storage, and entity request handling. They make common
+ * distributed-system failures explicit: a message may reach a runner that no
+ * longer owns the entity, a runner may be unavailable or unregistered, a
+ * payload may fail to decode, persistence may fail, a mailbox may be at
+ * capacity, or an envelope may already be in progress.
+ *
+ * **Gotchas**
+ *
+ * - Entity ownership and runner availability can change while messages are in
+ *   flight, so routing errors should generally be treated as retryable or
+ *   recoverable by higher-level cluster logic.
+ * - `MalformedMessage` points to a schema/serialization boundary failure,
+ *   while `PersistenceError` preserves failures from durable mailbox storage.
+ * - `AlreadyProcessingMessage` protects an entity mailbox from processing the
+ *   same envelope concurrently.
+ *
  * @since 4.0.0
  */
 import * as Cause from "../../Cause.ts";
@@ -16,15 +37,19 @@ declare const EntityNotAssignedToRunner_base: Schema.Class<EntityNotAssignedToRu
  * Represents an error that occurs when a Runner receives a message for an entity
  * that it is not assigned to it.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export declare class EntityNotAssignedToRunner extends EntityNotAssignedToRunner_base {
     /**
+     * Marks this value as a cluster error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cluster/ClusterError";
     /**
+     * Returns `true` when the value is an `EntityNotAssignedToRunner` error.
+     *
      * @since 4.0.0
      */
     static is(u: unknown): u is EntityNotAssignedToRunner;
@@ -37,19 +62,25 @@ declare const MalformedMessage_base: Schema.Class<MalformedMessage, Schema.Struc
  * Represents an error that occurs when a message fails to be properly
  * deserialized by an entity.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export declare class MalformedMessage extends MalformedMessage_base {
     /**
+     * Marks this value as a cluster error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cluster/ClusterError";
     /**
+     * Returns `true` when the value is a `MalformedMessage` error.
+     *
      * @since 4.0.0
      */
     static is(u: unknown): u is MalformedMessage;
     /**
+     * Maps failures from the supplied effect into `MalformedMessage` errors.
+     *
      * @since 4.0.0
      */
     static refail: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, MalformedMessage, R>;
@@ -62,15 +93,19 @@ declare const PersistenceError_base: Schema.Class<PersistenceError, Schema.Struc
  * Represents an error that occurs when a message fails to be persisted into
  * cluster's mailbox storage.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export declare class PersistenceError extends PersistenceError_base {
     /**
+     * Marks this value as a cluster error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cluster/ClusterError";
     /**
+     * Maps failures from the supplied effect into `PersistenceError` values.
+     *
      * @since 4.0.0
      */
     static refail<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, PersistenceError, R>;
@@ -83,11 +118,13 @@ declare const RunnerNotRegistered_base: Schema.Class<RunnerNotRegistered, Schema
  * Represents an error that occurs when a Runner is not registered with the shard
  * manager.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export declare class RunnerNotRegistered extends RunnerNotRegistered_base {
     /**
+     * Marks this value as a cluster error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cluster/ClusterError";
@@ -99,15 +136,19 @@ declare const RunnerUnavailable_base: Schema.Class<RunnerUnavailable, Schema.Str
 /**
  * Represents an error that occurs when a Runner is unresponsive.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export declare class RunnerUnavailable extends RunnerUnavailable_base {
     /**
+     * Marks this value as a cluster error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cluster/ClusterError";
     /**
+     * Returns `true` when the value is a `RunnerUnavailable` error.
+     *
      * @since 4.0.0
      */
     static is(u: unknown): u is RunnerUnavailable;
@@ -119,15 +160,19 @@ declare const MailboxFull_base: Schema.Class<MailboxFull, Schema.Struct<{
 /**
  * Represents an error that occurs when the entities mailbox is full.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export declare class MailboxFull extends MailboxFull_base {
     /**
+     * Marks this value as a cluster error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cluster/ClusterError";
     /**
+     * Returns `true` when the value is a `MailboxFull` error.
+     *
      * @since 4.0.0
      */
     static is(u: unknown): u is MailboxFull;
@@ -141,15 +186,19 @@ declare const AlreadyProcessingMessage_base: Schema.Class<AlreadyProcessingMessa
  * Represents an error that occurs when the entity is already processing a
  * request.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export declare class AlreadyProcessingMessage extends AlreadyProcessingMessage_base {
     /**
+     * Marks this value as a cluster error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [TypeId] = "~effect/cluster/ClusterError";
     /**
+     * Returns `true` when the value is an `AlreadyProcessingMessage` error.
+     *
      * @since 4.0.0
      */
     static is(u: unknown): u is AlreadyProcessingMessage;

package/dist/unstable/cluster/ClusterError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClusterError.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/ClusterError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,QAAA,MAAM,MAAM,iCAAiC,CAAA;;;;;AAE7C;;;;;;GAMG;AACH,qBAAa,yBACX,SAAQ,8BAGN;IAEF;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,yBAAyB;CAGtD;;;;;AAED;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,qBAGpC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,gBAAgB;IAI5C;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CACvE,CAAC,EACD,gBAAgB,EAChB,CAAC,CACF,CAA8D;CAChE;;;;;AAED;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,qBAGpC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;CAG9F;;;;;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,wBAGvC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;CAC3B;;;;;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,sBAGrC;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,iBAAiB;CAG9C;;;;;AAED;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,gBAG/B;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW;CAGxC;;;;;;AAED;;;;;;GAMG;AACH,qBAAa,wBACX,SAAQ,6BAIN;IAEF;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,wBAAwB;CAGrD"}
+{"version":3,"file":"ClusterError.d.ts","sourceRoot":"","sources":["../../../src/unstable/cluster/ClusterError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,QAAA,MAAM,MAAM,iCAAiC,CAAA;;;;;AAE7C;;;;;;GAMG;AACH,qBAAa,yBACX,SAAQ,8BAGN;IAEF;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,yBAAyB;CAGtD;;;;;AAED;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,qBAGpC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,gBAAgB;IAI5C;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CACvE,CAAC,EACD,gBAAgB,EAChB,CAAC,CACF,CAA8D;CAChE;;;;;AAED;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,qBAGpC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;CAG9F;;;;;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,wBAGvC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;CAC3B;;;;;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,sBAGrC;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,iBAAiB;CAG9C;;;;;AAED;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,gBAG/B;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW;CAGxC;;;;;;AAED;;;;;;GAMG;AACH,qBAAa,wBACX,SAAQ,6BAIN;IAEF;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,kCAAS;IAE1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,wBAAwB;CAGrD"}

package/dist/unstable/cluster/ClusterError.js

@@ -1,4 +1,25 @@
 /**
+ * The `ClusterError` module defines the typed error values used by the
+ * unstable cluster runtime when routing messages to entities, coordinating
+ * runners, and persisting mailbox work.
+ *
+ * These errors are useful when implementing cluster transports, runner
+ * supervision, mailbox storage, and entity request handling. They make common
+ * distributed-system failures explicit: a message may reach a runner that no
+ * longer owns the entity, a runner may be unavailable or unregistered, a
+ * payload may fail to decode, persistence may fail, a mailbox may be at
+ * capacity, or an envelope may already be in progress.
+ *
+ * **Gotchas**
+ *
+ * - Entity ownership and runner availability can change while messages are in
+ *   flight, so routing errors should generally be treated as retryable or
+ *   recoverable by higher-level cluster logic.
+ * - `MalformedMessage` points to a schema/serialization boundary failure,
+ *   while `PersistenceError` preserves failures from durable mailbox storage.
+ * - `AlreadyProcessingMessage` protects an entity mailbox from processing the
+ *   same envelope concurrently.
+ *
  * @since 4.0.0
  */
 import * as Cause from "../../Cause.js";
@@ -13,18 +34,22 @@ const TypeId = "~effect/cluster/ClusterError";
  * Represents an error that occurs when a Runner receives a message for an entity
  * that it is not assigned to it.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export class EntityNotAssignedToRunner extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/EntityNotAssignedToRunner`)({
   _tag: /*#__PURE__*/Schema.tag("EntityNotAssignedToRunner"),
   address: EntityAddress
 }) {
   /**
+   * Marks this value as a cluster error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Returns `true` when the value is an `EntityNotAssignedToRunner` error.
+   *
    * @since 4.0.0
    */
   static is(u) {
@@ -35,24 +60,30 @@ export class EntityNotAssignedToRunner extends /*#__PURE__*/Schema.ErrorClass(`$
  * Represents an error that occurs when a message fails to be properly
  * deserialized by an entity.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export class MalformedMessage extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/MalformedMessage`)({
   _tag: /*#__PURE__*/Schema.tag("MalformedMessage"),
   cause: Schema.Defect
 }) {
   /**
+   * Marks this value as a cluster error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Returns `true` when the value is a `MalformedMessage` error.
+   *
    * @since 4.0.0
    */
   static is(u) {
     return hasProperty(u, TypeId) && isTagged(u, "MalformedMessage");
   }
   /**
+   * Maps failures from the supplied effect into `MalformedMessage` errors.
+   *
    * @since 4.0.0
    */
   static refail = /*#__PURE__*/Effect.mapError(cause => new MalformedMessage({
@@ -63,18 +94,22 @@ export class MalformedMessage extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/
  * Represents an error that occurs when a message fails to be persisted into
  * cluster's mailbox storage.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export class PersistenceError extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/PersistenceError`)({
   _tag: /*#__PURE__*/Schema.tag("PersistenceError"),
   cause: Schema.Defect
 }) {
   /**
+   * Marks this value as a cluster error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Maps failures from the supplied effect into `PersistenceError` values.
+   *
    * @since 4.0.0
    */
   static refail(effect) {
@@ -87,14 +122,16 @@ export class PersistenceError extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/
  * Represents an error that occurs when a Runner is not registered with the shard
  * manager.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export class RunnerNotRegistered extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/RunnerNotRegistered`)({
   _tag: /*#__PURE__*/Schema.tag("RunnerNotRegistered"),
   address: RunnerAddress
 }) {
   /**
+   * Marks this value as a cluster error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
@@ -102,18 +139,22 @@ export class RunnerNotRegistered extends /*#__PURE__*/Schema.ErrorClass(`${TypeI
 /**
  * Represents an error that occurs when a Runner is unresponsive.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export class RunnerUnavailable extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/RunnerUnavailable`)({
   _tag: /*#__PURE__*/Schema.tag("RunnerUnavailable"),
   address: RunnerAddress
 }) {
   /**
+   * Marks this value as a cluster error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Returns `true` when the value is a `RunnerUnavailable` error.
+   *
    * @since 4.0.0
    */
   static is(u) {
@@ -123,18 +164,22 @@ export class RunnerUnavailable extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}
 /**
  * Represents an error that occurs when the entities mailbox is full.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export class MailboxFull extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/MailboxFull`)({
   _tag: /*#__PURE__*/Schema.tag("MailboxFull"),
   address: EntityAddress
 }) {
   /**
+   * Marks this value as a cluster error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Returns `true` when the value is a `MailboxFull` error.
+   *
    * @since 4.0.0
    */
   static is(u) {
@@ -145,8 +190,8 @@ export class MailboxFull extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/Mailb
  * Represents an error that occurs when the entity is already processing a
  * request.
  *
- * @since 4.0.0
  * @category errors
+ * @since 4.0.0
  */
 export class AlreadyProcessingMessage extends /*#__PURE__*/Schema.ErrorClass(`${TypeId}/AlreadyProcessingMessage`)({
   _tag: /*#__PURE__*/Schema.tag("AlreadyProcessingMessage"),
@@ -154,10 +199,14 @@ export class AlreadyProcessingMessage extends /*#__PURE__*/Schema.ErrorClass(`${
   address: EntityAddress
 }) {
   /**
+   * Marks this value as a cluster error for runtime guards.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
   /**
+   * Returns `true` when the value is an `AlreadyProcessingMessage` error.
+   *
    * @since 4.0.0
    */
   static is(u) {