@ts-ioc-container/bundler 2.0.0 → 2.1.0

package/cjm/services/ConsoleLogger.js

@@ -0,0 +1,36 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleLogger = exports.ILoggerKey = void 0;
+const ts_ioc_container_1 = require("ts-ioc-container");
+const CliIo_1 = require("../domain/CliIo");
+exports.ILoggerKey = new ts_ioc_container_1.SingleToken('ILogger');
+let ConsoleLogger = class ConsoleLogger {
+    io;
+    constructor(io) {
+        this.io = io;
+    }
+    warn(message) {
+        this.io.stderr(`tic: warning: ${message}`);
+    }
+    error(message) {
+        this.io.stderr(`tic: ${message}`);
+    }
+};
+exports.ConsoleLogger = ConsoleLogger;
+exports.ConsoleLogger = ConsoleLogger = __decorate([
+    (0, ts_ioc_container_1.register)(exports.ILoggerKey),
+    __param(0, (0, ts_ioc_container_1.inject)((0, ts_ioc_container_1.by)(CliIo_1.CliIoKey))),
+    __metadata("design:paramtypes", [Object])
+], ConsoleLogger);

package/cjm/services/HandlebarsRenderService.js

@@ -0,0 +1,33 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandlebarsRenderService = exports.IRenderServiceKey = void 0;
+exports.renderProtocol = renderProtocol;
+require("../../tpl/index.cjs");
+const handlebars_1 = __importDefault(require("handlebars"));
+const ts_ioc_container_1 = require("ts-ioc-container");
+handlebars_1.default.registerHelper('join', (items, separator) => items.join(separator));
+function renderProtocol(name, data) {
+    const protocol = handlebars_1.default.templates?.[name];
+    if (!protocol)
+        throw new Error(`Protocol not found: ${name}`);
+    return protocol(data);
+}
+exports.IRenderServiceKey = new ts_ioc_container_1.SingleToken('IRenderService');
+let HandlebarsRenderService = class HandlebarsRenderService {
+    render(protocol, data) {
+        return renderProtocol(protocol, data);
+    }
+};
+exports.HandlebarsRenderService = HandlebarsRenderService;
+exports.HandlebarsRenderService = HandlebarsRenderService = __decorate([
+    (0, ts_ioc_container_1.register)(exports.IRenderServiceKey)
+], HandlebarsRenderService);

package/cjm/services/NodeFileSystemService.js

@@ -0,0 +1,32 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeFileSystemService = exports.IFileSystemServiceKey = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const ts_ioc_container_1 = require("ts-ioc-container");
+exports.IFileSystemServiceKey = new ts_ioc_container_1.SingleToken('IFileSystemService');
+let NodeFileSystemService = class NodeFileSystemService {
+    fileExists(file) {
+        return (0, node_fs_1.existsSync)(file);
+    }
+    readFile(file) {
+        return (0, node_fs_1.readFileSync)(file, 'utf8');
+    }
+    writeFile(file, content) {
+        (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(file), { recursive: true });
+        (0, node_fs_1.writeFileSync)(file, content);
+    }
+};
+exports.NodeFileSystemService = NodeFileSystemService;
+exports.NodeFileSystemService = NodeFileSystemService = __decorate([
+    (0, ts_ioc_container_1.register)(exports.IFileSystemServiceKey)
+], NodeFileSystemService);

package/cjm/services/OutputService.js

@@ -0,0 +1,33 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StdOutputService = exports.IOutputServiceKey = void 0;
+const ts_ioc_container_1 = require("ts-ioc-container");
+const CliIo_1 = require("../domain/CliIo");
+exports.IOutputServiceKey = new ts_ioc_container_1.SingleToken('IOutputService');
+let StdOutputService = class StdOutputService {
+    io;
+    constructor(io) {
+        this.io = io;
+    }
+    write(line) {
+        this.io.stdout(line);
+    }
+};
+exports.StdOutputService = StdOutputService;
+exports.StdOutputService = StdOutputService = __decorate([
+    (0, ts_ioc_container_1.register)(exports.IOutputServiceKey),
+    __param(0, (0, ts_ioc_container_1.inject)((0, ts_ioc_container_1.by)(CliIo_1.CliIoKey))),
+    __metadata("design:paramtypes", [Object])
+], StdOutputService);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ts-ioc-container/bundler",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Bundles your dependencies into a single container module for ts-ioc-container: the `tic` CLI scans folders (by path or tsconfig alias) and generates one typed bundle that registers every class — `container.useModule(new AppBundle())`.",
   "publishConfig": {
     "access": "public",
@@ -9,7 +9,6 @@
   "author": "ibabkin <igba14@gmail.com>",
   "homepage": "https://github.com/IgorBabkin/ts-ioc-container/tree/main/packages/bundler#readme",
   "license": "ISC",
-  "sideEffects": false,
   "main": "cjm/index.js",
   "types": "typings/index.d.ts",
   "bin": {
@@ -50,7 +49,10 @@
   },
   "dependencies": {
     "handlebars": "^4.7.9",
-    "yaml": "^2.8.3"
+    "reflect-metadata": "^0.2.2",
+    "yaml": "^2.8.3",
+    "zod": "^4.6.5",
+    "ts-ioc-container": "74.0.0"
   },
   "peerDependencies": {
     "typescript": ">=5"
@@ -58,11 +60,10 @@
   "devDependencies": {
     "@types/node": "^25.5.2",
     "@vitest/coverage-v8": "^4.1.2",
-    "reflect-metadata": "^0.2.2",
+    "moq.ts": "^10.0.8",
     "typescript": "5.8.3",
     "unplugin-swc": "^1.6.0",
-    "vitest": "^4.1.11",
-    "ts-ioc-container": "74.0.0"
+    "vitest": "^4.1.11"
   },
   "engines": {
     "node": ">= 18"
@@ -78,6 +79,7 @@
     "lint": "eslint lib/**/*.ts __tests__/**/*.ts",
     "lint:fix": "pnpm run lint --fix",
     "format": "prettier --write \"lib/**/*.ts\" \"__tests__/**/*.ts\"",
-    "format:check": "prettier --check \"lib/**/*.ts\" \"__tests__/**/*.ts\""
+    "format:check": "prettier --check \"lib/**/*.ts\" \"__tests__/**/*.ts\"",
+    "generate:schema": "pnpm run build:cjm && node scripts/generate-schema.cjs"
   }
 }

package/tic.schema.json

@@ -4,88 +4,80 @@
   "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"
     },
     "output": {
+      "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.",
       "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": {
+      "default": [],
+      "description": "Tags associated with the bundle.",
       "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."
+      "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.",
+      "type": "string",
+      "minLength": 1
     },
     "importExtension": {
-      "type": "string",
-      "description": "Extension of generated imports, e.g. \".js\". Inferred from the tsconfig: \".js\" under node16/nodenext resolution, none otherwise."
+      "description": "Extension of generated imports, e.g. \".js\". Inferred from the tsconfig: \".js\" under node16/nodenext resolution, none otherwise.",
+      "type": "string"
     },
     "files": {
       "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.",
+          "minItems": 1,
+          "type": "array",
           "items": {
-            "oneOf": [
+            "anyOf": [
               {
                 "type": "string",
                 "minLength": 1
               },
               {
                 "type": "object",
-                "required": [
-                  "path"
-                ],
-                "additionalProperties": false,
                 "properties": {
                   "path": {
                     "type": "string",
                     "minLength": 1
                   },
                   "recursive": {
-                    "type": "boolean",
-                    "default": true
+                    "default": true,
+                    "type": "boolean"
                   }
-                }
+                },
+                "required": ["path"],
+                "additionalProperties": false
               }
             ]
           }
         },
         "include": {
+          "description": "Globs a file must match one of, e.g. [\"**/*.service.ts\", \"**/*.repository.ts\"]. Default: every source file.",
           "type": "array",
-          "minItems": 1,
           "items": {
             "type": "string",
             "minLength": 1
           },
-          "description": "Globs a file must match one of, e.g. [\"**/*.service.ts\", \"**/*.repository.ts\"]. Default: every source file."
+          "minItems": 1
         },
         "exclude": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
           "default": [
             "**/*.spec.ts",
             "**/*.test.ts",
@@ -94,55 +86,58 @@
             "**/__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."
+          "description": "Globs of files never read. Replaces the default when given. A non-empty list that omits a default glob makes `tic build` warn.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
         }
-      }
+      },
+      "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."
     },
     "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."
+          "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
-          },
-          "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": {
+          "description": "Glob the class name must match, e.g. \"*Service\". An anonymous default export is named after its file.",
           "type": "string",
-          "minLength": 1,
-          "description": "Glob the class name must match, e.g. \"*Service\". An anonymous default export is named after its file."
+          "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",
-          "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."
+          "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": "Glob the class name must NOT match, e.g. \"*Mock\". An anonymous default export is named after its file."
+          "minLength": 1
         }
-      }
+      },
+      "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."
     }
-  }
+  },
+  "additionalProperties": false
 }

package/typings/app.d.ts

@@ -0,0 +1,24 @@
+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 its tsconfig is missing or invalid, or the config has neither `files.paths` nor a tsconfig.
+ * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
+ */
+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,37 @@
+/**
+ * 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);
+}
+/** 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);
+}
+/** 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,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;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"}