politty 0.6.0 → 0.8.0

package/dist/docs/index.d.cts

@@ -1,4 +1,4 @@
-import { C as Example, K as ExtractedFields, V as SubCommandValue, _ as AnyCommand, q as ResolvedFieldMeta, v as ArgsSchema } from "../arg-registry-BoqVZRFO.cjs";
+import { C as Example, J as ResolvedFieldMeta, V as SubCommandValue, _ as AnyCommand, q as ExtractedFields, v as ArgsSchema } from "../arg-registry-DDJpsUea.cjs";
 import { z } from "zod";
 import * as fs from "node:fs";
 
@@ -275,6 +275,13 @@ interface DefaultRendererOptions {
   generateAnchors?: boolean;
   /** Include subcommand details */
   includeSubcommandDetails?: boolean;
+  /**
+   * Omit the `<!-- politty:...:start/end -->` section markers from the rendered
+   * output. Used by marker-free `files` generation. When markers are omitted the
+   * output can only be regenerated wholesale (sections can no longer be located
+   * and updated in place), which is exactly how marker-free `files` mode works.
+   */
+  markerless?: boolean;
   /** Custom renderer for description section */
   renderDescription?: SimpleRenderFunction;
   /** Custom renderer for usage section */
@@ -409,6 +416,34 @@ interface GenerateDocConfig {
    * When provided, automatically derives `rootDoc.globalOptions` from this schema.
    */
   globalArgs?: ArgsSchema;
+  /**
+   * Template-based generation: output file path -> template file path.
+   * The template mixes handwritten markdown with {{politty:...}} placeholders.
+   * The output file is fully generated from the template and contains no
+   * politty markers. Can be combined with `files` or `path`.
+   */
+  templates?: Record<string, string>;
+  /**
+   * Declare that you will hand-customize the `files` output.
+   *
+   * Default `false`: the output is fully generated and regenerated wholesale on
+   * every run (with `targetCommands`, only files containing a target command are
+   * regenerated, but each such file is rebuilt in full). The output carries no
+   * `<!-- politty:...:start/end -->` markers — do not hand-edit it.
+   *
+   * Set to `true` when you want to hand-edit the output and have politty preserve
+   * your edits: generated sections are wrapped in markers and updated in place
+   * (with `targetCommands`), and handwritten content between them is kept. When a
+   * command in the generated output gains a section the file does not yet have,
+   * it is reported as a non-fatal warning (run with `POLITTY_DOCS_DOCTOR=true
+   * POLITTY_DOCS_UPDATE=true` to insert it, or leave it removed to opt that
+   * section out).
+   *
+   * This flag does not affect `path`/`rootDoc` output, which always uses markers
+   * to inject generated sections into a handwritten file, nor `templates`, which
+   * are always fully generated.
+   */
+  customizable?: boolean;
 }
 /**
  * generateDoc result
@@ -662,7 +697,7 @@ declare function assertDocMatch(config: GenerateDocConfig): Promise<void>;
  * @param config - Config containing files to initialize, or a single file path
  * @param fileSystem - Optional fs implementation (useful when fs is mocked)
  */
-declare function initDocFile(config: Pick<GenerateDocConfig, "files"> | string, fileSystem?: DeleteFileFs): void;
+declare function initDocFile(config: Pick<GenerateDocConfig, "files" | "templates" | "rootDoc"> | string, fileSystem?: DeleteFileFs): void;
 //#endregion
 //#region src/docs/render-index.d.ts
 /**
@@ -671,8 +706,15 @@ declare function initDocFile(config: Pick<GenerateDocConfig, "files"> | string,
 type CommandCategory = {
   /** Category title (e.g., "Application Commands") */title: string; /** Category description */
   description: string; /** Command paths to include (parent commands will auto-expand to leaf commands) */
-  commands: string[]; /** Path to documentation file for links (e.g., "./cli/application.md") */
+  commands: string[]; /** Optional post-expansion allowlist, used when a caller has already applied ignores */
+  allowedCommands?: string[]; /** Path to documentation file for links (e.g., "./cli/application.md") */
   docPath: string;
+  /**
+   * When true, `commands` are used verbatim as index rows without expanding
+   * parent commands to their leaf subcommands. Used for template-derived
+   * categories where only explicitly rendered scopes have headings.
+   */
+  noExpand?: boolean;
 };
 /**
  * Render command index from categories

package/dist/docs/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/render-args.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts","../../src/docs/render-index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/render-args.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts","../../src/docs/render-index.ts"],"mappings":"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"}

package/dist/docs/index.d.ts

@@ -1,4 +1,4 @@
-import { C as Example, K as ExtractedFields, V as SubCommandValue, _ as AnyCommand, q as ResolvedFieldMeta, v as ArgsSchema } from "../arg-registry-BoqVZRFO.js";
+import { C as Example, J as ResolvedFieldMeta, V as SubCommandValue, _ as AnyCommand, q as ExtractedFields, v as ArgsSchema } from "../arg-registry-DDJpsUea.js";
 import { z } from "zod";
 import * as fs from "node:fs";
 
@@ -275,6 +275,13 @@ interface DefaultRendererOptions {
   generateAnchors?: boolean;
   /** Include subcommand details */
   includeSubcommandDetails?: boolean;
+  /**
+   * Omit the `<!-- politty:...:start/end -->` section markers from the rendered
+   * output. Used by marker-free `files` generation. When markers are omitted the
+   * output can only be regenerated wholesale (sections can no longer be located
+   * and updated in place), which is exactly how marker-free `files` mode works.
+   */
+  markerless?: boolean;
   /** Custom renderer for description section */
   renderDescription?: SimpleRenderFunction;
   /** Custom renderer for usage section */
@@ -409,6 +416,34 @@ interface GenerateDocConfig {
    * When provided, automatically derives `rootDoc.globalOptions` from this schema.
    */
   globalArgs?: ArgsSchema;
+  /**
+   * Template-based generation: output file path -> template file path.
+   * The template mixes handwritten markdown with {{politty:...}} placeholders.
+   * The output file is fully generated from the template and contains no
+   * politty markers. Can be combined with `files` or `path`.
+   */
+  templates?: Record<string, string>;
+  /**
+   * Declare that you will hand-customize the `files` output.
+   *
+   * Default `false`: the output is fully generated and regenerated wholesale on
+   * every run (with `targetCommands`, only files containing a target command are
+   * regenerated, but each such file is rebuilt in full). The output carries no
+   * `<!-- politty:...:start/end -->` markers — do not hand-edit it.
+   *
+   * Set to `true` when you want to hand-edit the output and have politty preserve
+   * your edits: generated sections are wrapped in markers and updated in place
+   * (with `targetCommands`), and handwritten content between them is kept. When a
+   * command in the generated output gains a section the file does not yet have,
+   * it is reported as a non-fatal warning (run with `POLITTY_DOCS_DOCTOR=true
+   * POLITTY_DOCS_UPDATE=true` to insert it, or leave it removed to opt that
+   * section out).
+   *
+   * This flag does not affect `path`/`rootDoc` output, which always uses markers
+   * to inject generated sections into a handwritten file, nor `templates`, which
+   * are always fully generated.
+   */
+  customizable?: boolean;
 }
 /**
  * generateDoc result
@@ -662,7 +697,7 @@ declare function assertDocMatch(config: GenerateDocConfig): Promise<void>;
  * @param config - Config containing files to initialize, or a single file path
  * @param fileSystem - Optional fs implementation (useful when fs is mocked)
  */
-declare function initDocFile(config: Pick<GenerateDocConfig, "files"> | string, fileSystem?: DeleteFileFs): void;
+declare function initDocFile(config: Pick<GenerateDocConfig, "files" | "templates" | "rootDoc"> | string, fileSystem?: DeleteFileFs): void;
 //#endregion
 //#region src/docs/render-index.d.ts
 /**
@@ -671,8 +706,15 @@ declare function initDocFile(config: Pick<GenerateDocConfig, "files"> | string,
 type CommandCategory = {
   /** Category title (e.g., "Application Commands") */title: string; /** Category description */
   description: string; /** Command paths to include (parent commands will auto-expand to leaf commands) */
-  commands: string[]; /** Path to documentation file for links (e.g., "./cli/application.md") */
+  commands: string[]; /** Optional post-expansion allowlist, used when a caller has already applied ignores */
+  allowedCommands?: string[]; /** Path to documentation file for links (e.g., "./cli/application.md") */
   docPath: string;
+  /**
+   * When true, `commands` are used verbatim as index rows without expanding
+   * parent commands to their leaf subcommands. Used for template-derived
+   * categories where only explicitly rendered scopes have headings.
+   */
+  noExpand?: boolean;
 };
 /**
  * Render command index from categories

package/dist/docs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/render-args.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts","../../src/docs/render-index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/executor/subcommand-router.ts","../../src/docs/render-args.ts","../../src/docs/types.ts","../../src/docs/default-renderers.ts","../../src/docs/doc-comparator.ts","../../src/docs/doc-generator.ts","../../src/docs/example-executor.ts","../../src/docs/golden-test.ts","../../src/docs/render-index.ts"],"mappings":";;;;;;;;;AASA;;iBAAsB,kBAAA,CAAmB,GAAA,EAAK,eAAA,GAAkB,OAAA,CAAQ,UAAA;;;;;;;KCD5D,SAAA,GAAY,MAAM,SAAS,CAAA,CAAE,OAAA;;;;KAK7B,gBAAA;EDJoD,6DCM9D,OAAO;AAAA;;;;;;ADNyE;;;;ACDlF;;;;;;;;AAAgD;AAKhD;;;;AAES;iBAuCO,eAAA,CAAgB,IAAA,EAAM,SAAA,EAAW,OAAA,GAAU,gBAAgB;;;;KCjD/D,YAAA;AFIZ;;;AAAA,KECY,mBAAA;EFD4D,4DEGtE,YAAA,GAAe,YAAY,EFH0C;EEKrE,QAAA;AAAA;;;;UAMe,WAAA;EFXiE;EEahF,IAAA;;EAEA,WAAA;EDhBU;ECkBV,OAAA;;EAEA,eAAA;EDpBsB;ECsBtB,WAAA;EDtBuC;ECwBvC,KAAA;EDxB8C;EC0B9C,cAAA,EAAgB,iBAAA;EDrBU;ECuB1B,OAAA,EAAS,iBAAA;EDrBF;ECuBP,WAAA,EAAa,cAAA;EDgBC;ECdd,SAAA,EAAW,eAAA;;EAEX,OAAA,EAAS,UAAA;EDY2B;ECVpC,KAAA;EDUyD;ECRzD,QAAA;EDQyE;ECNzE,OAAA,GAAU,MAAA;;EAEV,QAAA,GAAW,OAAA;;EAEX,cAAA,GAAiB,sBAAA;EA/CK;EAiDtB,WAAA;EAjDsB;EAmDtB,gBAAA;AAAA;;;;UAMe,cAAA;EAlDA;EAoDf,IAAA;EAlDQ;EAoDR,WAAA;EA9Ce;EAgDf,OAAA;;EAEA,QAAA;AAAA;;;;UAMe,sBAAA;EA1BJ;EA4BX,GAAA;EA1BuC;EA4BvC,IAAA;EA1DA;EA4DA,cAAA;EAxDA;EA0DA,MAAA;EAtDA;EAwDA,MAAA;EApDA;EAsDA,OAAA;AAAA;;;;;UAOe,oBAAA;EArDf;EAuDA,IAAA,gBAAoB,OAAA;EArDpB;EAuDA,OAAA,gBAAuB,OAAO;AAAA;;;;;;;;;AA3Cd;AAMlB;;;KAoDY,aAAA,GAAgB,MAAM,SAAS,oBAAA;;;;KAK/B,cAAA,IAAkB,IAAiB,EAAX,WAAW;;AAjDrC;AAMV;;;;;KAoDY,qBAAA,IAAyB,cAAA,UAAwB,IAAA,EAAM,WAAW;;;;UAK7D,oBAAA;EA7CR;EA+CP,KAAA;EAxCe;EA0Cf,WAAW;AAAA;;;;UAMI,oBAAA;EA5CQ;EA8CvB,OAAA,EAAS,iBAAA;EA9CqB;EAgD9B,MAAA,GAAS,OAAA,EAAS,iBAAA,IAAqB,IAAA,GAAO,oBAAA;EAjCvB;EAmCvB,OAAA;EAnC0B;EAqC1B,IAAA,EAAM,WAAA;AAAA;AAAA,KAEI,qBAAA,IAAyB,OAA6B,EAApB,oBAAoB;;;AAlCnB;UAuC9B,sBAAA;EA9BgB;EAgC/B,IAAA,EAAM,iBAAA;EAhCsE;EAkC5E,MAAA,GAAS,IAAA,EAAM,iBAAA,IAAqB,IAAA,GAAO,oBAAA;EAlCsB;EAoCjE,OAAA;EApC4E;EAsC5E,IAAA,EAAM,WAAA;AAAA;AAAA,KAEI,uBAAA,IAA2B,OAA+B,EAAtB,sBAAsB;;;AA/BzD;UAoCI,wBAAA;EA9BoB;EAgCnC,eAAA;EA9BS;EAgCT,WAAW;AAAA;;;;UAMI,wBAAA;EAtCN;EAwCT,WAAA,EAAa,cAAA;EAtCK;EAwClB,MAAA,GAAS,WAAA,EAAa,cAAA,IAAkB,IAAA,GAAO,wBAAA;EAxCD;EA0C9C,OAAA;EAxCA;EA0CA,IAAA,EAAM,WAAA;AAAA;AAAA,KAEI,yBAAA,IAA6B,OAAiC,EAAxB,wBAAwB;AA1CvD;AAEnB;;AAFmB,UA+CF,qBAAA;EA7C6B;EA+C5C,WAAA;EA1Ce;EA4Cf,UAAA;;EAEA,aAAA;AAAA;;;;UAMe,qBAAA;EAlDf;EAoDA,QAAA,EAAU,OAAA;EAlDV;EAoDA,OAAA,GAAU,sBAAA;EApDD;EAsDT,MAAA,GACE,QAAA,EAAU,OAAA,IACV,OAAA,GAAU,sBAAA,IACV,IAAA,GAAO,qBAAA;EAzD2B;EA4DpC,OAAA;EAxDA;EA0DA,IAAA,EAAM,WAAA;AAAA;AAAA,KAEI,sBAAA,IAA0B,OAA8B,EAArB,qBAAqB;AA1DpE;;;AAAA,UA+DiB,mBAAA;EA/DqD;EAiEpE,OAAA;EA5DuC;EA8DvC,OAAA;EA5DA;EA8DA,IAAA,EAAM,WAAW;AAAA;AAAA,KAEP,oBAAA,IAAwB,OAA4B,EAAnB,mBAAmB;;;;UAK/C,sBAAA;EArDT;EAuDN,YAAA,GAAe,YAAA;EAvDE;EAyDjB,WAAA;EA/Da;EAiEb,eAAA;EA/DsB;EAiEtB,wBAAA;EAjE+C;;;;;;EAwE/C,UAAA;EAlEU;EAoEV,iBAAA,GAAoB,oBAAA;;EAEpB,WAAA,GAAc,oBAAA;EAtE0D;EAwExE,eAAA,GAAkB,uBAAA;EAnEkB;EAqEpC,aAAA,GAAgB,qBAAA;EArEoB;EAuEpC,iBAAA,GAAoB,yBAAA;EAnEpB;EAqEA,WAAA,GAAc,oBAAA;EAnED;EAqEb,YAAA,GAAe,oBAAA;EA/DA;EAiEf,cAAA,GAAiB,sBAAA;AAAA;;;;;UAOF,aAAA;EA1DT;EA4DN,IAAA;EA5DiB;;;;EAiEjB,aAAA,GAAgB,SAAA;IAAc,IAAA,EAAM,SAAA;IAAW,OAAA,GAAU,gBAAA;EAAA;EAvE7C;EAyEZ,YAAA,GAAe,YAAA;EAxEN;EA0ET,KAAA,GAAQ,mBAAA;AAAA;;;;AArES;UA4EF,eAAA;EA1EiB;EA4EhC,KAAA;EA5E6C;EA8E7C,WAAA;EAzEe;EA2Ef,MAAA;;EAEA,MAAA;AAAA;;;;;AAvEiB;AAEnB;;;;AAAgE;AAKhE;KA8EY,UAAA;EAAwB,IAAA;EAAc,QAAA,GAAW,MAAM;AAAA;;;;UAKlD,UAAA;EAxDD;EA0Dd,QAAA;EAtDiB;EAwDjB,MAAA,GAAS,cAAc;EAxDgB;EA0DvC,KAAA;EAvFe;EAyFf,WAAA;EArFA;EAuFA,QAAA;AAAA;;;;;;;;;;;;;KAeU,WAAA,GAAc,MAAM,oBAAoB,UAAA;;;;UAKnC,iBAAA;EAlFwB;EAoFvC,OAAA,EAAS,UAAA;EA7EmB;;;;;EAmF5B,OAAA,GAAU,aAAA;EAxEF;;;;EA6ER,IAAA,GAAO,UAAA;EAjFS;EAmFhB,KAAA,GAAQ,WAAA;EAnF4B;EAqFpC,QAAA,GAAW,eAAA;EArF8C;EAuFzD,OAAA;EArFe;EAuFf,MAAA,GAAS,sBAAA;EArFD;EAuFR,SAAA,GAAY,iBAAA;EAvFe;EAyF3B,QAAA,GAAW,aAAA;EAlFmB;;;;;EAwF9B,cAAA;EAhFA;;AAAM;AAcR;EAuEE,UAAA,GAAa,UAAA;;;;;;;EAOb,SAAA,GAAY,MAAA;EAzEG;;;;;;;;;;;AAUP;AAeV;;;;AAA8D;AAK9D;;;EAgEE,YAAA;AAAA;;;;UAMe,iBAAA;EA/CH;EAiDZ,OAAA;EApCa;EAsCb,KAAA,EAAO,KAAK;IA/BM,gBAiChB,IAAA,UA1EF;IA4EE,MAAA,4CAtEF;IAwEE,IAAA;EAAA;EAnEK;EAsEP,KAAA;AAAA;;;;;KAOU,iBAAA,IAAqB,OAAA,sBAA6B,OAAO;;;;cAKxD,iBAAA;;;;;;cAOA,UAAA;;AAtCC;AAMd;cAqCa,aAAA;;;;KAeD,WAAA,WAAsB,aAAa;;;;;cAMlC,qBAAA;;AA7CN;AAOP;iBA2CgB,kBAAA,CAAmB,IAAA,EAAM,WAAW,EAAE,KAAA;;;AA3Ce;iBAkDrD,gBAAA,CAAiB,IAAA,EAAM,WAAW,EAAE,KAAA;;;;AA7CtB;cAqDjB,4BAAA;;;;iBAKG,wBAAA;AA9ChB;;;AAAA,iBAqDgB,sBAAA;AA3CN;AAKV;;AALU,cAkDG,yBAAA;AAAA,iBAEG,qBAAA;AAAA,iBAIA,mBAAA;AA7ChB;;;AAAA,cAoDa,yBAAA;AAAA,iBAEG,qBAAA;AAAA,iBAIA,mBAAA;;;;;cAQH,mBAAA;;;AA7DsD;iBAkEnD,gBAAA,CAAiB,KAAa;;;;iBAO9B,cAAA,CAAe,KAAa;;;;;;iBClgB5B,WAAA,CAAY,IAAiB,EAAX,WAAW;;;;iBAyB7B,oBAAA,CAAqB,IAAiB,EAAX,WAAW;;;AHjE4B;iBGsFlE,mBAAA,CAAoB,IAAiB,EAAX,WAAW;;;AFvFrD;;;;;;;;AAAgD;AAKhD;;;iBEkMgB,kBAAA,CAAmB,IAAiB,EAAX,WAAW;AFhM3C;AAuCT;;;;;;;;;AAA2E;AAvClE,iBE2PO,iBAAA,CAAkB,IAAiB,EAAX,WAAW;;;ADrQnD;iBCiTgB,sBAAA,CAAuB,IAAA,EAAM,WAAW,EAAE,eAAA;;;ADjTlC;iBCwTR,2BAAA,CAA4B,OAA4B,EAAnB,iBAAiB;ADzStE;;;AAAA,iBCuegB,0BAAA,CAA2B,OAA4B,EAAnB,iBAAiB;;;;iBA2BrD,6BAAA,CAA8B,IAAyB,EAAnB,iBAAiB;;;;iBAqBrD,4BAAA,CAA6B,IAAyB,EAAnB,iBAAiB;;;;iBAkBpD,+BAAA,CACd,WAAA,EAAa,cAAA,IACb,IAAA,EAAM,WAAW,EACjB,eAAA;;;;;;;;;;;;;;;;iBAgFc,qBAAA,CACd,QAAA,EAAU,OAAA,IACV,OAAA,GAAU,sBAAA,IACV,IAAA,GAAO,qBAAA;AAAA,iBA2EO,qBAAA,CAAsB,OAAA,GAAS,sBAAA,GAA8B,cAAc;;;;cAmP9E,gBAAA;ED35BX,yDC65BoB,sBAAA,KAAsB,cAAA,ED35B1B;8BAMD;;;;;;;;UExDA,aAAA;EJGK;EIDpB,KAAA;;EAEA,IAAA;EJDsE;EIGtE,UAAA;AAAA;;;;iBAMc,mBAAA,CAAoB,gBAAA,UAA0B,QAAA,WAAmB,aAAa;;;AJTZ;iBIsClE,UAAA,CAAW,QAAA,UAAkB,MAAc;;;AHvC3D;iBG6GgB,SAAA,CAAU,QAAA,UAAkB,OAAe;;AH7GX;AAKhD;UGoIiB,YAAA;EACf,UAAA,SAAmB,EAAA,CAAG,UAAA;EACtB,UAAA,SAAmB,EAAA,CAAG,UAAU;AAAA;;;;;;iBC3IZ,gBAAA,CACpB,OAAA,EAAS,UAAA,EACT,QAAA,UACA,WAAA,cACC,OAAA,CAAQ,WAAA;;;;;iBAyCW,kBAAA,CACpB,OAAA,EAAS,UAAA,EACT,QAAA,YACC,OAAA,CAAQ,GAAA,SAAY,WAAA;;;;;;AL/CvB;;;;;;iBMIsB,eAAA,CACpB,QAAA,EAAU,OAAA,IACV,MAAA,EAAQ,oBAAA,EACR,WAAA,EAAa,UAAA,EACb,WAAA,cACC,OAAA,CAAQ,sBAAA;;;;;;iBCivEW,WAAA,CAAY,MAAA,EAAQ,iBAAA,GAAoB,OAAA,CAAQ,iBAAA;;;;;iBAqsChD,cAAA,CAAe,MAAA,EAAQ,iBAAA,GAAoB,OAAO;;;;;;;;iBA6BxD,WAAA,CACd,MAAA,EAAQ,IAAA,CAAK,iBAAA,+CACb,UAAA,GAAa,YAAA;;;;;;KCl9GH,eAAA;ERZ4B,oDQctC,KAAA,URd4C;EQgB5C,WAAA,URhB8D;EQkB9D,QAAA,YRlBqE;EQoBrE,eAAA,aRpBuC;EQsBvC,OAAA;ERtBsE;;AAAU;;;EQ4BhF,QAAA;AAAA;;;;;;;AP7B8C;AAKhD;;;;AAES;AAuCT;;;;;;;;;AAA2E;;;;ACjD3E;;;;AAAwB;iBMiMF,kBAAA,CACpB,OAAA,EAAS,UAAA,EACT,UAAA,EAAY,eAAA,IACZ,OAAA,GAAU,mBAAA,GACT,OAAA"}