@ts-ioc-container/bundler 2.0.0 → 3.0.0

package/tic.schema.json

@@ -4,145 +4,111 @@
   "title": "*.bundle.json / *.bundle.yaml",
   "description": "One bundle generated by `tic build` (@ts-ioc-container/bundler). `tic build` builds every `*.bundle.json` / `*.bundle.yaml` / `*.bundle.yml` at the root of the package it is invoked in, or — with none — one bundle from that package's tsconfig.json with every setting at its default. Relative paths resolve against this file's directory.",
   "type": "object",
-  "additionalProperties": false,
   "properties": {
     "$schema": {
       "type": "string"
     },
+    "extends": {
+      "default": "./tsconfig.json",
+      "description": "The tsconfig this bundle extends, as a tsconfig's own `extends`: its file set, `paths` aliases and module resolution apply unless this file overrides them. Relative to this file. The default may be absent; a tsconfig named here must exist.",
+      "type": "string",
+      "minLength": 1
+    },
     "output": {
+      "description": "The bundle file (convention: *.bundle.ts). Default `<root>/<name>.bundle.ts`: <root> is the compiled rootDir, else the common folder of the files compiled.",
       "type": "string",
-      "minLength": 1,
-      "description": "The bundle file (convention: *.bundle.ts). Default `<root>/<name>.bundle.ts`: <root> is the tsconfig's rootDir, else the common folder of the files it compiles. Required when there is no tsconfig to extend."
+      "minLength": 1
     },
     "name": {
+      "description": "The bundle's name: letters, digits, \"-\" and \"_\", starting with a letter. Default: this file's stem (production.bundle.json → production), else \"base\". It names the default output (production.bundle.ts) and the generated IContainerModule class (ProductionBundle).",
       "type": "string",
-      "pattern": "^[A-Za-z][\\w-]*$",
-      "description": "The bundle's name: letters, digits, \"-\" and \"_\", starting with a letter. Default: this file's stem (production.bundle.json → production), else \"base\". It names the default output (production.bundle.ts) and the generated IContainerModule class (ProductionBundle)."
+      "pattern": "^[A-Za-z][\\w-]*$"
     },
-    "tags": {
+    "include": {
+      "description": "tsconfig `include`: replaces the extended tsconfig's. Relative to this file.",
       "type": "array",
       "items": {
         "type": "string",
         "minLength": 1
-      },
-      "description": "Tags associated with the bundle."
-    },
-    "extends": {
-      "type": "string",
-      "minLength": 1,
-      "default": "./tsconfig.json",
-      "description": "The tsconfig this bundle builds on, like a tsconfig's own `extends`: what it compiles (`files` / `include` / `exclude`) is the bundle's file set unless `files.paths` overrides it, and its `paths` aliases and module resolution shape the generated imports. Relative to this file. The default may be absent; a tsconfig named here must exist."
+      }
     },
-    "importExtension": {
-      "type": "string",
-      "description": "Extension of generated imports, e.g. \".js\". Inferred from the tsconfig: \".js\" under node16/nodenext resolution, none otherwise."
+    "exclude": {
+      "description": "tsconfig `exclude`: replaces the extended tsconfig's. Relative to this file.",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
     },
-    "files": {
+    "compilerOptions": {
       "type": "object",
-      "additionalProperties": false,
-      "description": "Which files this bundle reads and parses — decided by path alone, before parsing. The candidates are what the extended tsconfig compiles, or the folders in `paths` when given. A candidate is parsed when it matches one of `include` and none of `exclude`. Globs are relative to this file. With a file naming convention, `include` keeps every other file unread.",
       "properties": {
-        "paths": {
-          "type": "array",
-          "minItems": 1,
-          "description": "Folders to scan instead of the extended tsconfig's file set: paths relative to this file (./src/services) or tsconfig paths aliases (@app/services). Required when there is no tsconfig to extend.",
-          "items": {
-            "oneOf": [
-              {
+        "importExtension": {
+          "description": "Extension of generated imports, e.g. \".js\". Inferred from the tsconfig: \".js\" under node16/nodenext resolution, none otherwise.",
+          "type": "string"
+        },
+        "classes": {
+          "type": "object",
+          "properties": {
+            "export": {
+              "default": "any",
+              "description": "Which exports count.",
+              "type": "string",
+              "enum": ["any", "named", "default"]
+            },
+            "decorators": {
+              "default": ["register"],
+              "description": "The class must carry one of these decorators, recognised by name (e.g. \"register\", or a composed decorator). Default [\"register\"]; [] requires none.",
+              "type": "array",
+              "items": {
                 "type": "string",
                 "minLength": 1
-              },
-              {
-                "type": "object",
-                "required": [
-                  "path"
-                ],
-                "additionalProperties": false,
-                "properties": {
-                  "path": {
-                    "type": "string",
-                    "minLength": 1
-                  },
-                  "recursive": {
-                    "type": "boolean",
-                    "default": true
-                  }
-                }
               }
-            ]
-          }
-        },
-        "include": {
-          "type": "array",
-          "minItems": 1,
-          "items": {
-            "type": "string",
-            "minLength": 1
+            },
+            "name": {
+              "description": "Glob the class name must match, e.g. \"*Service\". An anonymous default export is named after its file.",
+              "type": "string",
+              "minLength": 1
+            },
+            "excludeClasses": {
+              "description": "Class names to drop after selection, e.g. one test double sitting next to the real registration in the same file.",
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 1
+            },
+            "excludeName": {
+              "description": "Glob the class name must NOT match, e.g. \"*Mock\". An anonymous default export is named after its file.",
+              "type": "string",
+              "minLength": 1
+            }
           },
-          "description": "Globs a file must match one of, e.g. [\"**/*.service.ts\", \"**/*.repository.ts\"]. Default: every source file."
+          "additionalProperties": false,
+          "description": "Which classes of a scanned file are registered. A class is selected when it is exported, not abstract, and meets every criterion set here; by default that is every exported class decorated with @register."
         },
-        "exclude": {
-          "type": "array",
-          "items": {
+        "paths": {
+          "description": "tsconfig `paths`: aliases the generated imports are written in.",
+          "type": "object",
+          "propertyNames": {
             "type": "string"
           },
-          "default": [
-            "**/*.spec.ts",
-            "**/*.test.ts",
-            "**/*.spec.tsx",
-            "**/*.test.tsx",
-            "**/__tests__/**",
-            "**/node_modules/**"
-          ],
-          "description": "Globs of files never read. Replaces the default when given. A non-empty list that omits a default glob makes `tic build` warn."
-        }
-      }
-    },
-    "classes": {
-      "type": "object",
-      "additionalProperties": false,
-      "description": "Which classes of a parsed file are registered. A class is selected when it is exported, not abstract, and meets every criterion set here; by default that is every exported class decorated with @register.",
-      "properties": {
-        "export": {
-          "enum": [
-            "any",
-            "named",
-            "default"
-          ],
-          "default": "any",
-          "description": "Which exports count."
-        },
-        "decorators": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1
-          },
-          "description": "The class must carry one of these decorators, recognised by name (e.g. \"register\", or a composed decorator). Default [\"register\"]; [] requires none.",
-          "default": [
-            "register"
-          ]
-        },
-        "name": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Glob the class name must match, e.g. \"*Service\". An anonymous default export is named after its file."
-        },
-        "excludeClasses": {
-          "type": "array",
-          "minItems": 1,
-          "items": {
-            "type": "string",
-            "minLength": 1
-          },
-          "description": "Class names to drop after selection, e.g. one test double sitting next to the real registration in the same file."
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
         },
-        "excludeName": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Glob the class name must NOT match, e.g. \"*Mock\". An anonymous default export is named after its file."
+        "rootDir": {
+          "description": "tsconfig `rootDir`: where the default output (<rootDir>/<name>.bundle.ts) goes.",
+          "type": "string"
         }
-      }
+      },
+      "additionalProperties": {},
+      "description": "tsconfig `compilerOptions`, plus the bundler's own `importExtension` and `classes`. Every other option is handed to TypeScript on top of the extended tsconfig's, which validates it."
     }
-  }
+  },
+  "additionalProperties": false
 }

package/tpl/index.cjs

@@ -1,27 +1,7 @@
 var Handlebars = require("handlebars");  var template = Handlebars.template, templates = Handlebars.templates = Handlebars.templates || {};
 templates["Bundle.ts.hbs"] = template({"0":function(container,depth0,helpers,partials,data) {
-    var stack1, lookupProperty = container.lookupProperty || function(parent, propertyName) {
-        if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
-          return parent[propertyName];
-        }
-        return undefined
-    };
-
-  return "// Paths: "
-    + ((stack1 = (lookupProperty(helpers,"join")||(depth0 && lookupProperty(depth0,"join"))||container.hooks.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? lookupProperty(depth0,"paths") : depth0),", ",{"name":"join","hash":{},"data":data,"loc":{"start":{"line":2,"column":23},"end":{"line":2,"column":44}}})) != null ? stack1 : "");
-},"1":function(container,depth0,helpers,partials,data) {
-    var stack1, helper, lookupProperty = container.lookupProperty || function(parent, propertyName) {
-        if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
-          return parent[propertyName];
-        }
-        return undefined
-    };
-
-  return "// Files: as compiled by "
-    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"tsconfigPath") || (depth0 != null ? lookupProperty(depth0,"tsconfigPath") : depth0)) != null ? helper : container.hooks.helperMissing),(typeof helper === "function" ? helper.call(depth0 != null ? depth0 : (container.nullContext || {}),{"name":"tsconfigPath","hash":{},"data":data,"loc":{"start":{"line":2,"column":77},"end":{"line":2,"column":95}}}) : helper))) != null ? stack1 : "");
-},"2":function(container,depth0,helpers,partials,data) {
     return ", Registration";
-},"3":function(container,depth0,helpers,partials,data) {
+},"1":function(container,depth0,helpers,partials,data) {
     var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), lookupProperty = container.lookupProperty || function(parent, propertyName) {
         if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
           return parent[propertyName];
@@ -30,12 +10,12 @@ 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(4, 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(6, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":5,"column":79},"end":{"line":5,"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":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 : "")
     + " 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":5,"column":138},"end":{"line":5,"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":4,"column":138},"end":{"line":4,"column":153}}}) : helper))) != null ? stack1 : "")
     + "';\n";
-},"4":function(container,depth0,helpers,partials,data) {
+},"2":function(container,depth0,helpers,partials,data) {
     var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), lookupProperty = container.lookupProperty || function(parent, propertyName) {
         if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
           return parent[propertyName];
@@ -43,11 +23,11 @@ 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":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(5, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":5,"column":43},"end":{"line":5,"column":72}}})) != null ? stack1 : "");
-},"5":function(container,depth0,helpers,partials,data) {
+  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 : "");
+},"3":function(container,depth0,helpers,partials,data) {
     return ", ";
-},"6":function(container,depth0,helpers,partials,data) {
+},"4":function(container,depth0,helpers,partials,data) {
     var stack1, lookupProperty = container.lookupProperty || function(parent, propertyName) {
         if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
           return parent[propertyName];
@@ -56,9 +36,9 @@ 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":5,"column":101},"end":{"line":5,"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":4,"column":101},"end":{"line":4,"column":122}}})) != null ? stack1 : "")
     + " }";
-},"7":function(container,depth0,helpers,partials,data) {
+},"5":function(container,depth0,helpers,partials,data) {
     var stack1, lookupProperty = container.lookupProperty || function(parent, propertyName) {
         if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
           return parent[propertyName];
@@ -67,15 +47,15 @@ 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(8, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":10,"column":0},"end":{"line":12,"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":9,"column":0},"end":{"line":11,"column":9}}})) != null ? stack1 : "")
     + "];\n";
-},"8":function(container,depth0,helpers,partials,data) {
+},"6":function(container,depth0,helpers,partials,data) {
     var stack1;
 
   return "  Registration.fromClass("
     + ((stack1 = container.lambda(depth0, depth0)) != null ? stack1 : "")
     + "),\n";
-},"9":function(container,depth0,helpers,partials,data) {
+},"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) {
@@ -87,15 +67,13 @@ templates["Bundle.ts.hbs"] = template({"0":function(container,depth0,helpers,par
 
   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.\n"
-    + ((stack1 = lookupProperty(helpers,"if").call(alias1,(depth0 != null ? lookupProperty(depth0,"paths") : depth0),{"name":"if","hash":{},"fn":container.program(0, data, 0),"inverse":container.program(1, data, 0),"data":data,"loc":{"start":{"line":2,"column":0},"end":{"line":2,"column":102}}})) != 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(2, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":3,"column":67},"end":{"line":3,"column":116}}})) != 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 : "")
     + " } from 'ts-ioc-container';\n"
-    + ((stack1 = lookupProperty(helpers,"each").call(alias1,(depth0 != null ? lookupProperty(depth0,"imports") : depth0),{"name":"each","hash":{},"fn":container.program(3, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":4,"column":0},"end":{"line":6,"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":3,"column":0},"end":{"line":5,"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(7, data, 0),"inverse":container.program(9, data, 0),"data":data,"loc":{"start":{"line":8,"column":0},"end":{"line":16,"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":7,"column":0},"end":{"line":15,"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":18,"column":13},"end":{"line":18,"column":23}}}) : helper))) != null ? stack1 : "")
+    + ((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 : "")
     + " 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

@@ -0,0 +1,23 @@
+import 'reflect-metadata';
+import { type IContainer } from 'ts-ioc-container';
+import { type CliIo } from './domain/CliIo.js';
+import { type ResolvedConfig } from './features/build/BuildConfig.js';
+import { type BuildOptions, type BuildResult } from './features/build/services/BundleBuilder.js';
+/** The composition root: one container per run, holding every module of the CLI. */
+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.
+ *
+ * @throws {TicConfigError} when the config or the tsconfig it extends is missing or invalid.
+ */
+export declare function build({ cwd, ...request }?: BuildOptions): BuildResult;
+/**
+ * Reads and validates a `*.bundle.json`, `*.bundle.yaml` or `*.bundle.yml`.
+ *
+ * @throws {TicConfigError} when the file is missing, 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

@@ -0,0 +1,16 @@
+import { type IContainer } from 'ts-ioc-container';
+/**
+ * Runs one command line against a container: resolves the controller registered
+ * under the command's name, runs the hooks it declares under the action, and routes
+ * failures to the bound {@link IErrorHandler}. Each action method reads its own
+ * options from the raw command line, which reaches it as the hook's runtime args.
+ */
+export declare class Application {
+    private readonly scope;
+    private readonly errorHandler;
+    static bootstrap(container: IContainer): Application;
+    private constructor();
+    /** Runs `argv` and returns the exit code; the container is disposed afterwards. */
+    run(...argv: string[]): number;
+}
+//# sourceMappingURL=Application.d.ts.map

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

@@ -0,0 +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"}

package/typings/cli/IErrorHandler.d.ts

@@ -0,0 +1,7 @@
+import { SingleToken } from 'ts-ioc-container';
+export interface IErrorHandler {
+    /** Reports `error` and returns the exit code the CLI ends with. */
+    handleError(error: unknown): number;
+}
+export declare const IErrorHandlerKey: SingleToken<IErrorHandler>;
+//# sourceMappingURL=IErrorHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IErrorHandler.d.ts","sourceRoot":"","sources":["../../lib/cli/IErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;CACrC;AAED,eAAO,MAAM,gBAAgB,4BAAkD,CAAC"}

package/typings/cli/decorators.d.ts

@@ -0,0 +1,10 @@
+import { type HookType } from 'ts-ioc-container';
+export declare const DEFAULT_ACTION = "default";
+/**
+ * Registers a method as a named CLI action: `@action('check', invoke)` makes
+ * `tic <command> check` run it. Several hooks run in declaration order.
+ */
+export declare const action: (name: string, ...hooks: HookType[]) => (target: object, propertyKey: string | symbol) => void;
+/** Runs when the command is invoked without an action name. */
+export declare const onDefault: (...hooks: HookType[]) => (target: object, propertyKey: string | symbol) => void;
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../lib/cli/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,QAAQ,EAAc,MAAM,kBAAkB,CAAC;AAEnE,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,GAAG,OAAO,QAAQ,EAAE,2DAAqC,CAAC;AAE/F,+DAA+D;AAC/D,eAAO,MAAM,SAAS,GAAI,GAAG,OAAO,QAAQ,EAAE,2DAAqC,CAAC"}

package/typings/cli/index.d.ts

@@ -0,0 +1,6 @@
+export { action, DEFAULT_ACTION, onDefault } from './decorators.js';
+export { commandArgs, parseOptions, validate } from './options.js';
+export { Application } from './Application.js';
+export { type IErrorHandler, IErrorHandlerKey } from './IErrorHandler.js';
+export { USAGE } from './usage.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/typings/cli/options.d.ts

@@ -0,0 +1,23 @@
+import { type ParseArgsConfig } from 'node:util';
+import { type InjectOptions } from 'ts-ioc-container';
+import { z, type ZodType } from 'zod';
+type OptionsConfig = NonNullable<ParseArgsConfig['options']>;
+/** The raw command line a CLI action was invoked with, handed to it as its runtime args. */
+export declare const commandArgs: ({ args }: InjectOptions) => string[];
+/**
+ * Mapper that parses the raw command line against an action's options. Everything
+ * from the first flag onwards belongs to the action — what precedes it is the
+ * command and the action name.
+ *
+ * @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>;
+/**
+ * Mapper that validates a loosely-typed value — parsed options in practice —
+ * against a schema and narrows it to the schema's output type.
+ *
+ * @throws {UsageError} when the value does not match the schema.
+ */
+export declare const validate: <T extends ZodType>(schema: T) => (value: unknown) => z.output<T>;
+export {};
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +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"}

package/typings/cli/usage.d.ts

@@ -0,0 +1,2 @@
+export declare const USAGE: string;
+//# sourceMappingURL=usage.d.ts.map

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

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

package/typings/domain/CliIo.d.ts

@@ -0,0 +1,10 @@
+import { SingleToken } from 'ts-ioc-container';
+/** Where the CLI runs and writes: `run(argv, io)` takes one, so tests can capture output. */
+export interface CliIo {
+    cwd: string;
+    stdout: (line: string) => void;
+    stderr: (line: string) => void;
+}
+export declare const CliIoKey: SingleToken<CliIo>;
+export declare const processIo: () => CliIo;
+//# sourceMappingURL=CliIo.d.ts.map

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

@@ -0,0 +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"}

package/typings/domain/GlobalConfig.d.ts

@@ -0,0 +1,10 @@
+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. */
+    cwd: string;
+};
+export declare const GlobalConfigKey: SingleToken<GlobalConfig>;
+/** Injects one field of the {@link GlobalConfig}: `@inject(globalConfig('cwd'))`. */
+export declare const globalConfig: <K extends keyof GlobalConfig>(key: K) => InjectFn<GlobalConfig[K]>;
+//# sourceMappingURL=GlobalConfig.d.ts.map

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

@@ -0,0 +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"}

package/typings/exceptions/DomainException.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Base class of every error the bundler raises on purpose. `code` is a stable,
+ * machine-readable identifier; the CLI prints the message without a stack.
+ */
+export declare abstract class TicError extends Error {
+    readonly code: string;
+    protected constructor(code: string, message: string);
+}
+/** The config file is missing, is not JSON, or does not match the `tic.config.json` shape. */
+export declare class TicConfigError extends TicError {
+    constructor(message: string);
+}
+/** The command line names no command. */
+export declare class MissingCommandError extends TicError {
+    constructor(usage: string);
+}
+/** The command line names a command no controller is registered for. */
+export declare class UnknownCommandError extends TicError {
+    constructor(command: string);
+}
+/** The command line names an action the command's controller does not declare. */
+export declare class UnknownActionError extends TicError {
+    constructor(command: string, action: string);
+}
+/** A command's options are malformed: an unknown flag, or a flag missing its value. */
+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

@@ -0,0 +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"}

package/typings/exceptions/ExceptionHandler.d.ts

@@ -0,0 +1,12 @@
+import { type IErrorHandler } from '../cli/IErrorHandler.js';
+import { type ILogger } from '../services/ConsoleLogger.js';
+/**
+ * Turns a failed command into exit code 1. A {@link TicError} is an expected failure
+ * and is reported by its message alone; anything else is a bug, reported with its stack.
+ */
+export declare class ExceptionHandler implements IErrorHandler {
+    private readonly logger;
+    constructor(logger: ILogger);
+    handleError(error: unknown): number;
+}
+//# sourceMappingURL=ExceptionHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExceptionHandler.d.ts","sourceRoot":"","sources":["../../lib/exceptions/ExceptionHandler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,2BAA2B,CAAC;AAGrE;;;GAGG;AACH,qBACa,gBAAiB,YAAW,aAAa;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,OAAO;IAEpE,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;CAKpC"}