@ts-ioc-container/bundler 3.1.0 → 4.0.0

package/tpl/index.cjs

@@ -10,10 +10,10 @@ templates["Bundle.ts.hbs"] = template({"0":function(container,depth0,helpers,par
     };
 
   return "import "
-    + ((stack1 = lookupProperty(helpers,"if").call(alias1,(depth0 != null ? lookupProperty(depth0,"defaultName") : depth0),{"name":"if","hash":{},"fn":container.program(2, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":4,"column":7},"end":{"line":4,"column":79}}})) != null ? stack1 : "")
-    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"named") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(4, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":4,"column":79},"end":{"line":4,"column":131}}})) != null ? stack1 : "")
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,(depth0 != null ? lookupProperty(depth0,"defaultName") : depth0),{"name":"if","hash":{},"fn":container.program(2, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":5,"column":7},"end":{"line":5,"column":79}}})) != null ? stack1 : "")
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"named") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(4, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":5,"column":79},"end":{"line":5,"column":131}}})) != null ? stack1 : "")
     + " from '"
-    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"specifier") || (depth0 != null ? lookupProperty(depth0,"specifier") : depth0)) != null ? helper : container.hooks.helperMissing),(typeof helper === "function" ? helper.call(alias1,{"name":"specifier","hash":{},"data":data,"loc":{"start":{"line":4,"column":138},"end":{"line":4,"column":153}}}) : helper))) != null ? stack1 : "")
+    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"specifier") || (depth0 != null ? lookupProperty(depth0,"specifier") : depth0)) != null ? helper : container.hooks.helperMissing),(typeof helper === "function" ? helper.call(alias1,{"name":"specifier","hash":{},"data":data,"loc":{"start":{"line":5,"column":138},"end":{"line":5,"column":153}}}) : helper))) != null ? stack1 : "")
     + "';\n";
 },"2":function(container,depth0,helpers,partials,data) {
     var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), lookupProperty = container.lookupProperty || function(parent, propertyName) {
@@ -23,8 +23,8 @@ templates["Bundle.ts.hbs"] = template({"0":function(container,depth0,helpers,par
         return undefined
     };
 
-  return ((stack1 = ((helper = (helper = lookupProperty(helpers,"defaultName") || (depth0 != null ? lookupProperty(depth0,"defaultName") : depth0)) != null ? helper : container.hooks.helperMissing),(typeof helper === "function" ? helper.call(alias1,{"name":"defaultName","hash":{},"data":data,"loc":{"start":{"line":4,"column":26},"end":{"line":4,"column":43}}}) : helper))) != null ? stack1 : "")
-    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"named") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(3, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":4,"column":43},"end":{"line":4,"column":72}}})) != null ? stack1 : "");
+  return ((stack1 = ((helper = (helper = lookupProperty(helpers,"defaultName") || (depth0 != null ? lookupProperty(depth0,"defaultName") : depth0)) != null ? helper : container.hooks.helperMissing),(typeof helper === "function" ? helper.call(alias1,{"name":"defaultName","hash":{},"data":data,"loc":{"start":{"line":5,"column":26},"end":{"line":5,"column":43}}}) : helper))) != null ? stack1 : "")
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"named") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(3, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":5,"column":43},"end":{"line":5,"column":72}}})) != null ? stack1 : "");
 },"3":function(container,depth0,helpers,partials,data) {
     return ", ";
 },"4":function(container,depth0,helpers,partials,data) {
@@ -36,7 +36,7 @@ templates["Bundle.ts.hbs"] = template({"0":function(container,depth0,helpers,par
     };
 
   return "{ "
-    + ((stack1 = (lookupProperty(helpers,"join")||(depth0 && lookupProperty(depth0,"join"))||container.hooks.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? lookupProperty(depth0,"named") : depth0),", ",{"name":"join","hash":{},"data":data,"loc":{"start":{"line":4,"column":101},"end":{"line":4,"column":122}}})) != null ? stack1 : "")
+    + ((stack1 = (lookupProperty(helpers,"join")||(depth0 && lookupProperty(depth0,"join"))||container.hooks.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? lookupProperty(depth0,"named") : depth0),", ",{"name":"join","hash":{},"data":data,"loc":{"start":{"line":5,"column":101},"end":{"line":5,"column":122}}})) != null ? stack1 : "")
     + " }";
 },"5":function(container,depth0,helpers,partials,data) {
     var stack1, lookupProperty = container.lookupProperty || function(parent, propertyName) {
@@ -47,7 +47,7 @@ templates["Bundle.ts.hbs"] = template({"0":function(container,depth0,helpers,par
     };
 
   return "export const registrations: IRegistration[] = [\n"
-    + ((stack1 = lookupProperty(helpers,"each").call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? lookupProperty(depth0,"registrations") : depth0),{"name":"each","hash":{},"fn":container.program(6, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":9,"column":0},"end":{"line":11,"column":9}}})) != null ? stack1 : "")
+    + ((stack1 = lookupProperty(helpers,"each").call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? lookupProperty(depth0,"registrations") : depth0),{"name":"each","hash":{},"fn":container.program(6, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":10,"column":0},"end":{"line":12,"column":9}}})) != null ? stack1 : "")
     + "];\n";
 },"6":function(container,depth0,helpers,partials,data) {
     var stack1;
@@ -58,22 +58,22 @@ templates["Bundle.ts.hbs"] = template({"0":function(container,depth0,helpers,par
 },"7":function(container,depth0,helpers,partials,data) {
     return "export const registrations: IRegistration[] = [];\n";
 },"compiler":[8,">= 4.3.0"],"main":function(container,depth0,helpers,partials,data) {
-    var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=container.hooks.helperMissing, alias3="function", lookupProperty = container.lookupProperty || function(parent, propertyName) {
+    var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=container.hooks.helperMissing, lookupProperty = container.lookupProperty || function(parent, propertyName) {
         if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
           return parent[propertyName];
         }
         return undefined
     };
 
-  return "// Generated by `tic build` from "
-    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"configPath") || (depth0 != null ? lookupProperty(depth0,"configPath") : depth0)) != null ? helper : alias2),(typeof helper === alias3 ? helper.call(alias1,{"name":"configPath","hash":{},"data":data,"loc":{"start":{"line":1,"column":33},"end":{"line":1,"column":49}}}) : helper))) != null ? stack1 : "")
-    + ". Do not edit by hand.\nimport { type IContainer, type IContainerModule, type IRegistration"
-    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"registrations") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(0, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":2,"column":67},"end":{"line":2,"column":116}}})) != null ? stack1 : "")
+  return "// Generated by `tic build`. Do not edit by hand.\n// Paths: "
+    + ((stack1 = (lookupProperty(helpers,"join")||(depth0 && lookupProperty(depth0,"join"))||alias2).call(alias1,(depth0 != null ? lookupProperty(depth0,"paths") : depth0),", ",{"name":"join","hash":{},"data":data,"loc":{"start":{"line":2,"column":10},"end":{"line":2,"column":31}}})) != null ? stack1 : "")
+    + "\nimport { type IContainer, type IContainerModule, type IRegistration"
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"registrations") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(0, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":3,"column":67},"end":{"line":3,"column":116}}})) != null ? stack1 : "")
     + " } from 'ts-ioc-container';\n"
-    + ((stack1 = lookupProperty(helpers,"each").call(alias1,(depth0 != null ? lookupProperty(depth0,"imports") : depth0),{"name":"each","hash":{},"fn":container.program(1, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":3,"column":0},"end":{"line":5,"column":9}}})) != null ? stack1 : "")
+    + ((stack1 = lookupProperty(helpers,"each").call(alias1,(depth0 != null ? lookupProperty(depth0,"imports") : depth0),{"name":"each","hash":{},"fn":container.program(1, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":4,"column":0},"end":{"line":6,"column":9}}})) != null ? stack1 : "")
     + "\n"
-    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"registrations") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(5, data, 0),"inverse":container.program(7, data, 0),"data":data,"loc":{"start":{"line":7,"column":0},"end":{"line":15,"column":7}}})) != null ? stack1 : "")
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"registrations") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(5, data, 0),"inverse":container.program(7, data, 0),"data":data,"loc":{"start":{"line":8,"column":0},"end":{"line":16,"column":7}}})) != null ? stack1 : "")
     + "\nexport class "
-    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"name") || (depth0 != null ? lookupProperty(depth0,"name") : depth0)) != null ? helper : alias2),(typeof helper === alias3 ? helper.call(alias1,{"name":"name","hash":{},"data":data,"loc":{"start":{"line":17,"column":13},"end":{"line":17,"column":23}}}) : helper))) != null ? stack1 : "")
+    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"name") || (depth0 != null ? lookupProperty(depth0,"name") : depth0)) != null ? helper : alias2),(typeof helper === "function" ? helper.call(alias1,{"name":"name","hash":{},"data":data,"loc":{"start":{"line":18,"column":13},"end":{"line":18,"column":23}}}) : helper))) != null ? stack1 : "")
     + " implements IContainerModule {\n  applyTo(container: IContainer): void {\n    for (const registration of registrations) container.addRegistration(registration);\n  }\n}\n";
 },"useData":true});

package/typings/app.d.ts

@@ -8,16 +8,17 @@ export declare function createContainer(io?: CliIo): IContainer;
 /** Runs the `tic` CLI and returns its exit code; output goes through `io`. */
 export declare function run(argv: string[], io?: CliIo): number;
 /**
- * Generates the bundle a config describes — one `tic build` step as a function. Nothing is
- * written unless generation succeeds.
+ * Generates the bundle a config file describes — `tic build` as a function — and returns
+ * it; nothing is written.
  *
- * @throws {TicConfigError} when the config or the tsconfig it extends is missing or invalid.
+ * @throws {TicConfigError} when the config file is missing or unreadable, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
+ * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
  */
-export declare function build({ cwd, ...request }?: BuildOptions): BuildResult;
+export declare function build({ cwd, ...request }: BuildOptions): BuildResult;
 /**
- * Reads and validates a `*.bundle.json`, `*.bundle.yaml` or `*.bundle.yml`.
+ * Reads and validates a config file: JSON for `.json`, YAML for `.yaml` / `.yml`.
  *
- * @throws {TicConfigError} when the file is missing, cannot be parsed, or does not match the config shape.
+ * @throws {TicConfigError} when the file is missing, has another extension, cannot be parsed, or does not match the config shape.
  */
 export declare function loadConfig(file: string): ResolvedConfig;
 //# sourceMappingURL=app.d.ts.map

package/typings/cli/Application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../lib/cli/Application.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,UAAU,EAAU,MAAM,kBAAkB,CAAC;AA6BpG;;;;;GAKG;AACH,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAN/B,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,GAAG,WAAW;IAIpD,OAAO;IAKP,mFAAmF;IACnF,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;CAmB/B"}
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../lib/cli/Application.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,UAAU,EAAU,MAAM,kBAAkB,CAAC;AA+BpG;;;;;GAKG;AACH,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAN/B,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,GAAG,WAAW;IAIpD,OAAO;IAKP,mFAAmF;IACnF,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;CAsB/B"}

package/typings/cli/options.d.ts

@@ -9,9 +9,15 @@ export declare const commandArgs: ({ args }: InjectOptions) => string[];
  * from the first flag onwards belongs to the action — what precedes it is the
  * command and the action name.
  *
+ * With `positionals`, the default action of a command takes arguments too: everything
+ * after the command is parsed, and the words that are not flags or their values come
+ * back as `positionals` (`tic build app.bundle.json`).
+ *
  * @throws {UsageError} when a flag is unknown or a flag that takes a value has none.
  */
-export declare const parseOptions: (options: OptionsConfig) => (argv: string[]) => Record<string, unknown>;
+export declare const parseOptions: (options: OptionsConfig, { positionals }?: {
+    positionals?: boolean;
+}) => (argv: string[]) => Record<string, unknown>;
 /**
  * Mapper that validates a loosely-typed value — parsed options in practice —
  * against a schema and narrows it to the schema's output type.

package/typings/cli/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../lib/cli/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAGtC,KAAK,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;AAE7D,4FAA4F;AAC5F,eAAO,MAAM,WAAW,GAAI,UAAe,aAAa,KAAG,MAAM,EAAsB,CAAC;AAExF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACtB,SAAS,aAAa,MACtB,MAAM,MAAM,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAOvC,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAClB,CAAC,SAAS,OAAO,EAAE,QAAQ,CAAC,MAC5B,OAAO,OAAO,KAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAI3B,CAAC"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../lib/cli/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAGtC,KAAK,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;AAE7D,4FAA4F;AAC5F,eAAO,MAAM,WAAW,GAAI,UAAe,aAAa,KAAG,MAAM,EAAsB,CAAC;AAExF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACtB,SAAS,aAAa,EAAE,kBAAyB;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,MAC/E,MAAM,MAAM,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CASvC,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAClB,CAAC,SAAS,OAAO,EAAE,QAAQ,CAAC,MAC5B,OAAO,OAAO,KAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAI3B,CAAC"}

package/typings/cli/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../lib/cli/usage.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,QAeN,CAAC"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../lib/cli/usage.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,QAkBN,CAAC"}

package/typings/domain/CliIo.d.ts

@@ -4,6 +4,8 @@ export interface CliIo {
     cwd: string;
     stdout: (line: string) => void;
     stderr: (line: string) => void;
+    /** All of standard input, or `undefined` when nothing is piped in (a terminal, or no stdin at all). */
+    stdin?: () => string | undefined;
 }
 export declare const CliIoKey: SingleToken<CliIo>;
 export declare const processIo: () => CliIo;

package/typings/domain/CliIo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CliIo.d.ts","sourceRoot":"","sources":["../../lib/domain/CliIo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,6FAA6F;AAC7F,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,QAAQ,oBAAkC,CAAC;AAExD,eAAO,MAAM,SAAS,QAAO,KAA6E,CAAC"}
+{"version":3,"file":"CliIo.d.ts","sourceRoot":"","sources":["../../lib/domain/CliIo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,6FAA6F;AAC7F,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,uGAAuG;IACvG,KAAK,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,QAAQ,oBAAkC,CAAC;AAExD,eAAO,MAAM,SAAS,QAAO,KAK3B,CAAC"}

package/typings/domain/GlobalConfig.d.ts

@@ -1,7 +1,7 @@
 import { type InjectFn, SingleToken } from 'ts-ioc-container';
 /** Settings every service shares for one run: the process-level context the CLI was started in. */
 export type GlobalConfig = {
-    /** Directory relative paths (`--config`, `build({ config })`) resolve against. */
+    /** Directory a relative `<config>` path (and `build({ config })`) resolves against. */
     cwd: string;
 };
 export declare const GlobalConfigKey: SingleToken<GlobalConfig>;

package/typings/domain/GlobalConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalConfig.d.ts","sourceRoot":"","sources":["../../lib/domain/GlobalConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE9D,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG;IACzB,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,eAAe,2BAAgD,CAAC;AAE7E,qFAAqF;AACrF,eAAO,MAAM,YAAY,GACtB,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,CAAC,KAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAE3B,CAAC"}
+{"version":3,"file":"GlobalConfig.d.ts","sourceRoot":"","sources":["../../lib/domain/GlobalConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE9D,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG;IACzB,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,eAAe,2BAAgD,CAAC;AAE7E,qFAAqF;AACrF,eAAO,MAAM,YAAY,GACtB,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,CAAC,KAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAE3B,CAAC"}

package/typings/exceptions/DomainException.d.ts

@@ -10,6 +10,10 @@ export declare abstract class TicError extends Error {
 export declare class TicConfigError extends TicError {
     constructor(message: string);
 }
+/** A namespace is neither an existing folder nor a `tsconfig.json` `paths` alias of one. */
+export declare class NamespaceNotFoundError extends TicError {
+    constructor(message: string);
+}
 /** The command line names no command. */
 export declare class MissingCommandError extends TicError {
     constructor(usage: string);
@@ -26,8 +30,4 @@ export declare class UnknownActionError extends TicError {
 export declare class UsageError extends TicError {
     constructor(message: string);
 }
-/** `tic build --check` found generated bundles that differ from what a build would write. */
-export declare class StaleBundlesError extends TicError {
-    constructor(count: number);
-}
 //# sourceMappingURL=DomainException.d.ts.map

package/typings/exceptions/DomainException.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DomainException.d.ts","sourceRoot":"","sources":["../../lib/exceptions/DomainException.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAExC,QAAQ,CAAC,IAAI,EAAE,MAAM;IADvB,SAAS,aACE,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED,8FAA8F;AAC9F,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM;CAG5B;AAED,yCAAyC;AACzC,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,KAAK,EAAE,MAAM;CAG1B;AAED,wEAAwE;AACxE,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM;CAG5B;AAED,kFAAkF;AAClF,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAG5C;AAED,uFAAuF;AACvF,qBAAa,UAAW,SAAQ,QAAQ;gBAC1B,OAAO,EAAE,MAAM;CAG5B;AAED,6FAA6F;AAC7F,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,KAAK,EAAE,MAAM;CAG1B"}
+{"version":3,"file":"DomainException.d.ts","sourceRoot":"","sources":["../../lib/exceptions/DomainException.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAExC,QAAQ,CAAC,IAAI,EAAE,MAAM;IADvB,SAAS,aACE,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED,8FAA8F;AAC9F,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM;CAG5B;AAED,4FAA4F;AAC5F,qBAAa,sBAAuB,SAAQ,QAAQ;gBACtC,OAAO,EAAE,MAAM;CAG5B;AAED,yCAAyC;AACzC,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,KAAK,EAAE,MAAM;CAG1B;AAED,wEAAwE;AACxE,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM;CAG5B;AAED,kFAAkF;AAClF,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAG5C;AAED,uFAAuF;AACvF,qBAAa,UAAW,SAAQ,QAAQ;gBAC1B,OAAO,EAAE,MAAM;CAG5B"}

package/typings/features/build/BuildConfig.d.ts

@@ -1,10 +1,32 @@
 import { z } from 'zod';
+/**
+ * Which files a bundle reads and parses: the first, cheap stage of selection,
+ * decided by path alone. `paths` are the folders the files come from; within them
+ * a file is parsed when it matches one of `include` and none of `exclude`. Globs
+ * are relative to the config file and `/`-separated. With a file naming convention
+ * (`*.service.ts`), `include` keeps the bundler from reading anything else.
+ */
+export interface GlobSelector {
+    /** Folders to scan: relative to the config file (`./src/services`), or tsconfig `paths` aliases (`@app/services`). */
+    paths: (string | PathConfig)[];
+    /** Globs a file must match one of, e.g. `**\/*.service.ts`. Default: every source file. */
+    include?: string[];
+    /** Globs of files never read. Replaces {@link DEFAULT_EXCLUDE} when given. */
+    exclude?: string[];
+}
+/** A {@link GlobSelector} with its defaults filled in and its globs compiled. */
+export interface ResolvedGlobSelector {
+    paths: Required<PathConfig>[];
+    include?: RegExp[];
+    exclude: RegExp[];
+}
 /** Which exports of a file count: both kinds, only named exports, or only the default export. */
 export type ExportKind = 'any' | 'named' | 'default';
 /**
- * Which classes of a parsed file are registered. A class is selected when it is
- * exported, not abstract, and meets every criterion set here; an empty rule
- * selects every exported class.
+ * Which classes of a parsed file are registered: the second stage of selection,
+ * run on the files {@link GlobSelector} let through. A class is selected when
+ * it is exported, not abstract, and meets every criterion set here; an empty
+ * rule selects every exported class.
  */
 export interface ClassSelector {
     /** Default `any`. */
@@ -14,155 +36,137 @@ export interface ClassSelector {
      * composed one). Default {@link DEFAULT_DECORATORS}; `[]` requires none.
      */
     decorators?: string[];
-    /** A glob the class name must match, e.g. `*Service`. An anonymous default export is named after its file. */
-    name?: string;
     /**
-     * Class names to drop after selection, e.g. one test double sitting next to the
-     * real registration in the same file.
+     * Globs the class name must match one of, e.g. `*Service` or `["*Service", "*Repository"]`.
+     * An anonymous default export is named after its file.
      */
-    excludeClasses?: string[];
-    /** A glob the class name must NOT match, e.g. `*Mock`. An anonymous default export is named after its file. */
-    excludeName?: string;
+    glob?: string | string[];
+    /**
+     * Globs the class name must match none of, applied after every other criterion. A plain
+     * name is a glob too, so `["MockUserRepository", "*Fake"]` drops one class by name and a
+     * family by pattern.
+     */
+    exclude?: string | string[];
 }
 /** A {@link ClassSelector} with its defaults filled in and its globs compiled. */
 export interface ResolvedClassSelector {
     export: ExportKind;
     decorators?: string[];
-    name?: RegExp;
-    excludeClasses?: string[];
-    excludeName?: RegExp;
+    glob?: RegExp[];
+    exclude?: RegExp[];
 }
-/**
- * `compilerOptions` of a bundle config: the tsconfig's own options plus the bundler's.
- * `importExtension` and `classes` are read by `tic build`; every other option (`paths`,
- * `baseUrl`, `rootDir`, `moduleResolution`, ...) is handed to TypeScript on top of the
- * extended tsconfig, exactly as a child tsconfig's would be.
- */
-export interface BundleCompilerOptions {
-    /** Extension of generated imports. Inferred from the tsconfig's `moduleResolution` when omitted. */
-    importExtension?: string;
-    /** Which classes of a scanned file are registered. Default: every exported class decorated with `@register`. */
-    classes?: ClassSelector;
-    [option: string]: unknown;
+export interface PathConfig {
+    /** A folder relative to the config file (`./src/services`) or a tsconfig `paths` alias (`@app/services`). */
+    path: string;
+    /** Scan sub-folders too. Default `true`. */
+    recursive?: boolean;
 }
 /**
- * The shape of `*.bundle.json`: one bundle, written as a tsconfig. `extends`, `include`,
- * `exclude` and `compilerOptions` mean what they mean in a tsconfig, so the files the bundle
- * scans are the files this config would compile; `output`, `name` and the bundler's
- * own compiler options describe the generated module. A project that needs several bundles
- * keeps one config file per bundle.
+ * A bundle config file: one bundle, described explicitly — the folders it scans and the
+ * classes it registers. `tic build <config>` prints the bundle to stdout; where it is
+ * saved is the caller's choice (`tic build app.bundle.json > src/di/app.bundle.ts`).
  */
 export interface BundleConfig {
     $schema?: string;
-    /**
-     * The generated file, relative to the config file. Default `<root>/<name>.bundle.ts`:
-     * `<root>` is the compiled `rootDir`, else the common folder of the files compiled.
-     */
-    output?: string;
     /**
      * The bundle's name: letters, digits, `-` and `_`, starting with a letter. Default: the
-     * config file's stem (`production.bundle.json` -> `production`), else {@link DEFAULT_BUNDLE_NAME}.
-     * It names the default output (`production.bundle.ts`) and the generated class,
-     * an `IContainerModule` (`ProductionBundle`, see {@link toClassName}).
+     * config file's stem (`production.bundle.json` -> `production`); required for a config
+     * file named otherwise. It names the generated class, an `IContainerModule`
+     * (`ProductionBundle`, see {@link toClassName}).
      */
     name?: string;
     /**
-     * The tsconfig this config extends, as a tsconfig's own `extends`. Relative to the config
-     * file. Default `./tsconfig.json`, which may be absent; a tsconfig named here must exist.
-     */
-    extends?: string;
-    /**
-     * The base folder this config's relative `include`, `exclude` and `output` resolve against,
-     * so they need not repeat a shared prefix such as `src`. Relative to the config file; default
-     * the config file's directory. It is also handed to TypeScript as `compilerOptions.baseUrl`
-     * (unless that is set too), so the generated imports use it as well.
+     * The tsconfig whose `paths` aliases `glob.paths` may name and generated imports are
+     * written in, and whose `moduleResolution` sets the import extension. It contributes
+     * nothing else: the files scanned are `glob.paths` alone. Relative to the config file.
+     * Default `./tsconfig.json`, which may be absent; a tsconfig named here must exist.
      */
-    baseUrl?: string;
-    /** tsconfig `include`: replaces the extended tsconfig's. Relative to `baseUrl`. */
-    include?: string[];
-    /** tsconfig `exclude`: replaces the extended tsconfig's. Relative to `baseUrl`. {@link DEFAULT_EXCLUDE} applies regardless. */
-    exclude?: string[];
-    compilerOptions?: BundleCompilerOptions;
+    tsconfig?: string;
+    /** Extension of generated imports. Inferred from the tsconfig's `moduleResolution` when omitted. */
+    importExtension?: string;
+    /** Which files are parsed: the folders in `glob.paths`, minus {@link DEFAULT_EXCLUDE} unless `exclude` says otherwise. */
+    glob: GlobSelector;
+    /** Which classes of a parsed file are registered. Default: every exported class. */
+    className?: ClassSelector;
 }
-export declare const DEFAULT_EXTENDS = "./tsconfig.json";
-/** The bundle name when the config file gives none, e.g. building from `tsconfig.json` alone. */
-export declare const DEFAULT_BUNDLE_NAME = "base";
-/** What `classes.decorators` requires when omitted: the library's own `@register`. */
+export declare const DEFAULT_TSCONFIG = "./tsconfig.json";
+/** What `className.decorators` requires when omitted: the library's own `@register`. */
 export declare const DEFAULT_DECORATORS: string[];
-/** Files never scanned, whatever the tsconfig compiles: tests, and anything under `node_modules`. */
 export declare const DEFAULT_EXCLUDE: string[];
-/** The tsconfig part of a bundle config, handed to TypeScript as a tsconfig of its own. */
-export interface TsconfigOverrides {
-    include?: string[];
-    exclude?: string[];
-    /** `compilerOptions` without the bundler's own options. */
-    compilerOptions: Record<string, unknown>;
-}
 /** A {@link BundleConfig} whose defaults are filled in and whose paths are absolute. */
 export interface ResolvedConfig {
     /** The config file itself. */
     file: string;
+    /** Its folder: what the config's relative paths resolve against. */
     dir: string;
-    /** `undefined`: derived from what is compiled at build time (see {@link BundleConfig.output}). */
-    output?: string;
     /** The bundle name: `production` for `production.bundle.json`. */
     name: string;
     /** The generated class: `ProductionBundle`. */
-    className: string;
-    /** The extended tsconfig; `required` when the config names it, so it must exist. */
+    bundleClassName: string;
+    /** The tsconfig of `paths` aliases; `required` when the config names it, so it must exist. */
     tsconfig: {
         file: string;
         required: boolean;
     };
-    /** What the config sets on top of {@link tsconfig}. */
-    overrides: TsconfigOverrides;
     importExtension?: string;
-    classes: ResolvedClassSelector;
+    glob: ResolvedGlobSelector;
+    className: ResolvedClassSelector;
+    /** Non-fatal problems found while resolving, e.g. a `glob.exclude` that drops a default test glob. */
+    warnings: string[];
 }
 /**
- * One `*.bundle.json` / `*.bundle.yaml`: a tsconfig with the bundler's fields. The published
- * `tic.schema.json` is generated from it (`ticConfigJsonSchema`), so the schema editors
- * validate against cannot drift from what `tic build` accepts.
+ * One `*.bundle.json` / `*.bundle.yaml`. The published `tic.schema.json` is generated
+ * from it (`ticConfigJsonSchema`), so the schema editors validate against cannot drift
+ * from what `tic build` accepts.
  */
 export declare const BUNDLE_CONFIG_SCHEMA: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
-    extends: z.ZodOptional<z.ZodString>;
-    baseUrl: z.ZodOptional<z.ZodString>;
-    output: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
-    include: z.ZodOptional<z.ZodCustom<string[], string[]>>;
-    exclude: z.ZodOptional<z.ZodCustom<string[], string[]>>;
-    compilerOptions: z.ZodOptional<z.ZodObject<{
-        importExtension: z.ZodOptional<z.ZodString>;
-        classes: z.ZodOptional<z.ZodObject<{
-            export: z.ZodDefault<z.ZodEnum<{
-                default: "default";
-                any: "any";
-                named: "named";
-            }>>;
-            decorators: z.ZodDefault<z.ZodCustom<string[], string[]>>;
-            name: z.ZodOptional<z.ZodString>;
-            excludeClasses: z.ZodOptional<z.ZodCustom<string[], string[]>>;
-            excludeName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>;
-        paths: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
-        rootDir: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>;
+    tsconfig: z.ZodOptional<z.ZodString>;
+    importExtension: z.ZodOptional<z.ZodString>;
+    glob: z.ZodObject<{
+        paths: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            recursive: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>]>>;
+        include: z.ZodOptional<z.ZodCustom<string[], string[]>>;
+        exclude: z.ZodDefault<z.ZodCustom<string[], string[]>>;
+    }, z.core.$strict>;
+    className: z.ZodOptional<z.ZodObject<{
+        export: z.ZodDefault<z.ZodEnum<{
+            default: "default";
+            any: "any";
+            named: "named";
+        }>>;
+        decorators: z.ZodDefault<z.ZodCustom<string[], string[]>>;
+        glob: z.ZodOptional<z.ZodCustom<string | string[], string | string[]>>;
+        exclude: z.ZodOptional<z.ZodCustom<string | string[], string | string[]>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 /**
- * A config file is named `<name>.bundle.json`, `<name>.bundle.yaml` or `<name>.bundle.yml`,
- * e.g. `app.bundle.json`, `production.bundle.yaml`. Every format has the same shape.
+ * A config file is named `<name>.bundle.json`, `<name>.bundle.yaml` or `<name>.bundle.yml`
+ * by convention, e.g. `app.bundle.json`; any `.json` / `.yaml` / `.yml` file works.
  */
 export declare const CONFIG_FILE_SUFFIXES: string[];
-/** The config suffix `file` ends with, if any. */
-export declare const configSuffix: (file: string) => string | undefined;
+/** What stands for standard input where a config file is expected: `tic build -`. */
+export declare const STDIN = "-";
+/** The format of a config file, by extension; `undefined` for any other file. */
+export declare const configFormat: (file: string) => ConfigFormat | undefined;
+/** The format of config text: JSON or YAML. */
+export type ConfigFormat = 'json' | 'yaml';
+/**
+ * Parses config text in its format. An empty YAML document is `{}`.
+ *
+ * @throws {TicConfigError} when the text is not valid in its format.
+ */
+export declare function parseConfig(text: string, format: ConfigFormat): unknown;
 /** The generated class for a bundle name: `production` -> `ProductionBundle`, `my-app_v2` -> `MyAppV2Bundle`. */
 export declare function toClassName(name: string): string;
 /**
- * Validates parsed `*.bundle.json` content and resolves its paths against `file`'s
- * directory, or its `baseUrl` for `include` / `exclude` / `output`.
+ * Validates parsed config content and resolves its paths against `file`'s directory.
+ * Without a `name` the bundle is named after the file: `production.bundle.json` -> `production`.
  *
- * @throws {TicConfigError} when the content does not match the config shape; the message names the field.
+ * @throws {TicConfigError} when the content does not match the config shape, or names no bundle; the message names the field.
  */
 export declare function resolveConfig(content: unknown, file: string): ResolvedConfig;
 //# sourceMappingURL=BuildConfig.d.ts.map

package/typings/features/build/BuildConfig.d.ts.map

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

package/typings/features/build/BuildController.d.ts

@@ -1,31 +1,37 @@
 import { z } from 'zod';
+import { type CliIo } from '../../domain/CliIo.js';
 import { type ILogger } from '../../services/ConsoleLogger.js';
 import { type IOutputService } from '../../services/OutputService.js';
 import { type IBundleBuilder } from './services/BundleBuilder.js';
-import { type ITicConfigService } from './services/TicConfigService.js';
-export declare const BUILD_OPTIONS: z.ZodObject<{
-    config: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    check: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
+export declare const BUILD_OPTIONS: z.ZodPipe<z.ZodObject<{
+    positionals: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<{
+    config: string;
+}, {
+    positionals: string[];
+}>>;
 export type BuildCliOptions = z.output<typeof BUILD_OPTIONS>;
-/** `tic build [--config <path>]... [--check]`. */
+/** `tic build [<config> | -]`: the bundle goes to stdout; without a config file, the config comes from stdin. */
 export declare class BuildController {
-    private readonly cwd;
-    private readonly configs;
+    private readonly io;
     private readonly builder;
     private readonly output;
     private readonly logger;
-    constructor(cwd: string, configs: ITicConfigService, builder: IBundleBuilder, output: IOutputService, logger: ILogger);
+    constructor(io: CliIo, builder: IBundleBuilder, output: IOutputService, logger: ILogger);
     /**
-     * Builds every config named with `--config`, else every `*.bundle.{json,yaml,yml}` of the
-     * package, else one bundle from its `tsconfig.json`. With `--check` nothing is written and
-     * an out-of-date bundle fails the run. One line per bundle goes to stdout, warnings to
-     * stderr; an error names the config it came from.
+     * Builds the bundle the config file `<config>` describes — or, without one (or with `-`),
+     * the config piped into stdin — and prints it to stdout. Saving it is the shell's job:
+     * `tic build app.bundle.json > src/di/app.bundle.ts`, `cat app.bundle.yml | tic build > out.ts`.
+     * Warnings go to stderr, so they never end up in the bundle; an error names the config.
      *
-     * @throws {UsageError} when an option is unknown or `--config` has no value.
-     * @throws {TicConfigError} when a config or its tsconfig is missing or invalid, or none can be found.
-     * @throws {StaleBundlesError} when `--check` finds a bundle that differs from what a build would write.
+     * @throws {UsageError} when an option is unknown, there is more than one `<config>`, or the config should come from stdin and nothing is piped in.
+     * @throws {TicConfigError} when the config file is missing or unreadable, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
+     * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
      */
-    build(options: BuildCliOptions): void;
+    build({ config }: BuildCliOptions): void;
+    /**
+     * @throws {UsageError} when nothing is piped into stdin.
+     */
+    private stdin;
 }
 //# sourceMappingURL=BuildController.d.ts.map

package/typings/features/build/BuildController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BuildController.d.ts","sourceRoot":"","sources":["../../../lib/features/build/BuildController.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,KAAK,cAAc,EAAwC,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,KAAK,iBAAiB,EAAuC,MAAM,6BAA6B,CAAC;AAE1G,eAAO,MAAM,aAAa;;;iBAGxB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAW7D,kDAAkD;AAClD,qBACa,eAAe;IAEK,OAAO,CAAC,QAAQ,CAAC,GAAG;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAJD,GAAG,EAAE,MAAM,EACN,OAAO,EAAE,iBAAiB,EAC7B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,cAAc,EAC7B,MAAM,EAAE,OAAO;IAG1D;;;;;;;;;OASG;IAEH,KAAK,CAAgE,OAAO,EAAE,eAAe,GAAG,IAAI;CAiBrG"}
+{"version":3,"file":"BuildController.d.ts","sourceRoot":"","sources":["../../../lib/features/build/BuildController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,8BAA8B,CAAC;AAEtF,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,0BAA0B,CAAC;AAElF,eAAO,MAAM,aAAa;;;;;;GAOxB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAI7D,iHAAiH;AACjH,qBACa,eAAe;IAEF,OAAO,CAAC,QAAQ,CAAC,EAAE;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHR,EAAE,EAAE,KAAK,EACA,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,cAAc,EAC7B,MAAM,EAAE,OAAO;IAG1D;;;;;;;;;OASG;IAEH,KAAK,CAAgE,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,IAAI;IAavG;;OAEG;IACH,OAAO,CAAC,KAAK;CAOd"}