@ts-ioc-container/bundler 2.1.0 → 3.1.0

package/cjm/features/build/domain/scan.js

@@ -37,7 +37,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isSourceFile = void 0;
-exports.listSourceFiles = listSourceFiles;
 exports.findClasses = findClasses;
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
@@ -46,23 +45,6 @@ const SOURCE_FILE = /\.(tsx?|mts|cts)$/;
 const DECLARATION_FILE = /\.d\.[mc]?tsx?$/;
 const isSourceFile = (file) => SOURCE_FILE.test(file) && !DECLARATION_FILE.test(file);
 exports.isSourceFile = isSourceFile;
-function listSourceFiles(dir, recursive, isExcluded) {
-    const files = [];
-    const walk = (current) => {
-        for (const entry of (0, node_fs_1.readdirSync)(current, { withFileTypes: true })) {
-            const full = node_path_1.default.join(current, entry.name);
-            if (entry.isDirectory()) {
-                if (recursive && entry.name !== 'node_modules')
-                    walk(full);
-            }
-            else if ((0, exports.isSourceFile)(entry.name) && !isExcluded(full)) {
-                files.push(full);
-            }
-        }
-    };
-    walk(dir);
-    return files.sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
-}
 const hasModifier = (node, kind) => ts.canHaveModifiers(node) && (ts.getModifiers(node) ?? []).some((m) => m.kind === kind);
 function decoratorName(decorator, imports) {
     const callee = ts.isCallExpression(decorator.expression) ? decorator.expression.expression : decorator.expression;

package/cjm/features/build/domain/tokenCollisions.js

@@ -17,7 +17,7 @@ function tokenCollisions(classes) {
         .map(([token, group]) => {
         const names = group.map((cls) => cls.className);
         return (`decorator token "${token}" is passed by ${names.join(', ')}; ` +
-            `registration is last-wins, exclude one with classes.excludeClasses`);
+            `registration is last-wins, exclude one with compilerOptions.classes.excludeClasses`);
     });
 }
 function scopeDisjoint(group) {

package/cjm/features/build/domain/tsconfig.js

@@ -57,22 +57,28 @@ function commonDir(files) {
     }
     return first.slice(0, length).join(node_path_1.default.sep) || node_path_1.default.sep;
 }
-function loadTsconfig(tsconfig, importExtension) {
-    if (!(0, node_fs_1.existsSync)(tsconfig.file)) {
-        if (tsconfig.required)
-            throw new DomainException_1.TicConfigError(`tsconfig not found: ${tsconfig.file}`);
-        return { importPaths: new ImportPaths_1.ImportPaths([], importExtension ?? '') };
+function asTsconfig(config) {
+    if (!(0, node_fs_1.existsSync)(config.tsconfig.file)) {
+        if (config.tsconfig.required)
+            throw new DomainException_1.TicConfigError(`tsconfig not found: ${config.tsconfig.file}`);
+        return { config: config.overrides };
     }
-    const { config, error } = ts.readConfigFile(tsconfig.file, ts.sys.readFile);
-    const parsed = ts.parseJsonConfigFileContent(config, ts.sys, node_path_1.default.dirname(tsconfig.file), undefined, tsconfig.file);
+    if (config.file === config.tsconfig.file)
+        return ts.readConfigFile(config.file, ts.sys.readFile);
+    return { config: { extends: config.tsconfig.file, ...config.overrides } };
+}
+function loadTsconfig(config) {
+    const { config: json, error } = asTsconfig(config);
+    const configFileName = config.file === config.tsconfig.file ? config.file : undefined;
+    const parsed = ts.parseJsonConfigFileContent(json ?? {}, ts.sys, config.dir, undefined, configFileName);
     const [fatal] = [error, ...parsed.errors].filter((d) => !!d && d.code !== NO_INPUTS);
     if (fatal) {
-        throw new DomainException_1.TicConfigError(`${tsconfig.file}: ${ts.flattenDiagnosticMessageText(fatal.messageText, '\n')}`);
+        throw new DomainException_1.TicConfigError(`${config.file}: ${ts.flattenDiagnosticMessageText(fatal.messageText, '\n')}`);
     }
     const fileNames = parsed.fileNames.map((file) => node_path_1.default.resolve(file));
     return {
-        importPaths: ImportPaths_1.ImportPaths.fromOptions(parsed.options, tsconfig.file, importExtension),
+        importPaths: ImportPaths_1.ImportPaths.fromOptions(parsed.options, config.file, config.importExtension),
         fileNames,
-        rootDir: parsed.options.rootDir ?? commonDir(fileNames.filter(scan_1.isSourceFile)) ?? node_path_1.default.dirname(tsconfig.file),
+        rootDir: parsed.options.rootDir ?? commonDir(fileNames.filter(scan_1.isSourceFile)) ?? config.dir,
     };
 }

package/cjm/features/build/services/BundleBuilder.js

@@ -19,7 +19,6 @@ exports.BundleBuilder = exports.IBundleBuilderKey = void 0;
 const node_path_1 = __importDefault(require("node:path"));
 const ts_ioc_container_1 = require("ts-ioc-container");
 const GlobalConfig_1 = require("../../../domain/GlobalConfig");
-const DomainException_1 = require("../../../exceptions/DomainException");
 const HandlebarsRenderService_1 = require("../../../services/HandlebarsRenderService");
 const NodeFileSystemService_1 = require("../../../services/NodeFileSystemService");
 const BuildConfig_1 = require("../BuildConfig");
@@ -30,6 +29,7 @@ const scan_1 = require("../domain/scan");
 const tokenCollisions_1 = require("../domain/tokenCollisions");
 const tsconfig_1 = require("../domain/tsconfig");
 const TicConfigService_1 = require("./TicConfigService");
+const DEFAULT_EXCLUDE_GLOBS = BuildConfig_1.DEFAULT_EXCLUDE.map(glob_1.globToRegExp);
 exports.IBundleBuilderKey = new ts_ioc_container_1.SingleToken('IBundleBuilder');
 let BundleBuilder = class BundleBuilder {
     cwd;
@@ -54,41 +54,20 @@ let BundleBuilder = class BundleBuilder {
         return {
             config: resolved.file,
             output: { file: output, bundle: resolved.className, status, registrations, content },
-            warnings: [...resolved.warnings, ...warnings],
+            warnings,
         };
     }
     generate(config) {
-        const { importPaths: paths, fileNames, rootDir } = (0, tsconfig_1.loadTsconfig)(config.tsconfig, config.importExtension);
-        const output = config.output ?? (rootDir && node_path_1.default.join(rootDir, `${config.name}.bundle.ts`));
-        if (output === undefined)
-            throw new DomainException_1.TicConfigError('output: required when there is no tsconfig to extend');
-        const relative = (file) => (0, glob_1.toPosix)(node_path_1.default.relative(config.dir, file));
-        const { include, exclude } = config.files;
+        const { importPaths: paths, fileNames, rootDir } = (0, tsconfig_1.loadTsconfig)(config);
+        const output = config.output ?? node_path_1.default.join(rootDir, `${config.name}.bundle.ts`);
         const isExcluded = (file) => {
             if (file === output)
                 return true;
-            const filename = relative(file);
-            if (include && !include.some((glob) => glob.test(filename)))
-                return true;
-            return exclude.some((glob) => glob.test(filename));
+            const filename = (0, glob_1.toPosix)(node_path_1.default.relative(config.dir, file));
+            return DEFAULT_EXCLUDE_GLOBS.some((glob) => glob.test(filename));
         };
-        const files = new Set();
-        if (config.files.paths) {
-            for (const entry of config.files.paths) {
-                const dir = paths.resolveNamespace(entry.path, config.dir);
-                for (const file of (0, scan_1.listSourceFiles)(dir, entry.recursive, isExcluded))
-                    files.add(file);
-            }
-        }
-        else if (fileNames) {
-            for (const file of fileNames)
-                if ((0, scan_1.isSourceFile)(file) && !isExcluded(file))
-                    files.add(file);
-        }
-        else {
-            throw new DomainException_1.TicConfigError(`files.paths: required when there is no tsconfig to extend (${config.tsconfig.file} not found)`);
-        }
-        const classes = [...files]
+        const files = fileNames.filter((file) => (0, scan_1.isSourceFile)(file) && !isExcluded(file));
+        const classes = files
             .sort((a, b) => (a < b ? -1 : a > b ? 1 : 0))
             .flatMap((file) => {
             const text = this.fs.readFile(file);
@@ -98,8 +77,6 @@ let BundleBuilder = class BundleBuilder {
         const content = this.renderer.render(emit_1.BUNDLE_PROTOCOL, (0, emit_1.bundleView)({
             name: config.className,
             configPath: (0, glob_1.toPosix)(node_path_1.default.relative(node_path_1.default.dirname(output), config.file)),
-            paths: config.files.paths?.map((entry) => entry.path),
-            tsconfigPath: (0, glob_1.toPosix)(node_path_1.default.relative(node_path_1.default.dirname(output), config.tsconfig.file)),
             classes,
         }));
         return { output, content, registrations: classes.length, warnings: (0, tokenCollisions_1.tokenCollisions)(classes) };

package/cjm/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StdOutputService = exports.IOutputServiceKey = exports.CommonModule = exports.HelpModule = exports.globToRegExp = exports.tokenCollisions = exports.GENERATED_HEADER = exports.BUNDLE_PROTOCOL = exports.bundleView = exports.emitBundle = exports.listSourceFiles = exports.isSourceFile = exports.findClasses = exports.loadTsconfig = exports.ImportPaths = exports.ticConfigJsonSchema = exports.findPackageRoot = exports.findConfigFiles = exports.toClassName = exports.DEFAULT_DECORATORS = exports.DEFAULT_BUNDLE_NAME = exports.DEFAULT_EXCLUDE = exports.DEFAULT_EXTENDS = exports.CONFIG_FILE_SUFFIXES = exports.BUNDLE_CONFIG_SCHEMA = exports.resolveConfig = exports.TSCONFIG_FILE = exports.ITicConfigServiceKey = exports.TicConfigService = exports.IBundleBuilderKey = exports.BundleBuilder = exports.BUILD_OPTIONS = exports.BuildController = exports.BuildModule = exports.USAGE = exports.IErrorHandlerKey = exports.validate = exports.parseOptions = exports.commandArgs = exports.DEFAULT_ACTION = exports.onDefault = exports.action = exports.Application = exports.globalConfig = exports.GlobalConfigKey = exports.CliIoKey = exports.createContainer = exports.loadConfig = exports.run = exports.build = void 0;
-exports.ExceptionHandler = exports.StaleBundlesError = exports.UsageError = exports.UnknownActionError = exports.UnknownCommandError = exports.MissingCommandError = exports.NamespaceNotFoundError = exports.TicConfigError = exports.TicError = exports.renderProtocol = exports.HandlebarsRenderService = exports.IRenderServiceKey = exports.NodeFileSystemService = exports.IFileSystemServiceKey = exports.ConsoleLogger = exports.ILoggerKey = void 0;
+exports.ILoggerKey = exports.StdOutputService = exports.IOutputServiceKey = exports.CommonModule = exports.HelpModule = exports.globToRegExp = exports.tokenCollisions = exports.GENERATED_HEADER = exports.BUNDLE_PROTOCOL = exports.bundleView = exports.emitBundle = exports.isSourceFile = exports.findClasses = exports.loadTsconfig = exports.ImportPaths = exports.ticConfigJsonSchema = exports.findPackageRoot = exports.findConfigFiles = exports.toClassName = exports.DEFAULT_DECORATORS = exports.DEFAULT_BUNDLE_NAME = exports.DEFAULT_EXCLUDE = exports.DEFAULT_EXTENDS = exports.CONFIG_FILE_SUFFIXES = exports.BUNDLE_CONFIG_SCHEMA = exports.resolveConfig = exports.TSCONFIG_FILE = exports.ITicConfigServiceKey = exports.TicConfigService = exports.IBundleBuilderKey = exports.BundleBuilder = exports.BUILD_OPTIONS = exports.BuildController = exports.BuildModule = exports.USAGE = exports.IErrorHandlerKey = exports.validate = exports.parseOptions = exports.commandArgs = exports.DEFAULT_ACTION = exports.onDefault = exports.action = exports.Application = exports.globalConfig = exports.GlobalConfigKey = exports.CliIoKey = exports.createContainer = exports.loadConfig = exports.run = exports.build = void 0;
+exports.ExceptionHandler = exports.StaleBundlesError = exports.UsageError = exports.UnknownActionError = exports.UnknownCommandError = exports.MissingCommandError = exports.TicConfigError = exports.TicError = exports.renderProtocol = exports.HandlebarsRenderService = exports.IRenderServiceKey = exports.NodeFileSystemService = exports.IFileSystemServiceKey = exports.ConsoleLogger = void 0;
 var app_1 = require("./app");
 Object.defineProperty(exports, "build", { enumerable: true, get: function () { return app_1.build; } });
 Object.defineProperty(exports, "run", { enumerable: true, get: function () { return app_1.run; } });
@@ -55,7 +55,6 @@ Object.defineProperty(exports, "loadTsconfig", { enumerable: true, get: function
 var scan_1 = require("./features/build/domain/scan");
 Object.defineProperty(exports, "findClasses", { enumerable: true, get: function () { return scan_1.findClasses; } });
 Object.defineProperty(exports, "isSourceFile", { enumerable: true, get: function () { return scan_1.isSourceFile; } });
-Object.defineProperty(exports, "listSourceFiles", { enumerable: true, get: function () { return scan_1.listSourceFiles; } });
 var emit_1 = require("./features/build/domain/emit");
 Object.defineProperty(exports, "emitBundle", { enumerable: true, get: function () { return emit_1.emitBundle; } });
 Object.defineProperty(exports, "bundleView", { enumerable: true, get: function () { return emit_1.bundleView; } });
@@ -85,7 +84,6 @@ Object.defineProperty(exports, "renderProtocol", { enumerable: true, get: functi
 var DomainException_1 = require("./exceptions/DomainException");
 Object.defineProperty(exports, "TicError", { enumerable: true, get: function () { return DomainException_1.TicError; } });
 Object.defineProperty(exports, "TicConfigError", { enumerable: true, get: function () { return DomainException_1.TicConfigError; } });
-Object.defineProperty(exports, "NamespaceNotFoundError", { enumerable: true, get: function () { return DomainException_1.NamespaceNotFoundError; } });
 Object.defineProperty(exports, "MissingCommandError", { enumerable: true, get: function () { return DomainException_1.MissingCommandError; } });
 Object.defineProperty(exports, "UnknownCommandError", { enumerable: true, get: function () { return DomainException_1.UnknownCommandError; } });
 Object.defineProperty(exports, "UnknownActionError", { enumerable: true, get: function () { return DomainException_1.UnknownActionError; } });

package/cjm/schema/ticConfigSchema.js

@@ -8,17 +8,13 @@ function ticConfigJsonSchema() {
         io: 'input',
         target: 'draft-7',
         unrepresentable: 'any',
-        override: ({ jsonSchema }) => {
-            if (jsonSchema.type === 'object')
-                jsonSchema.additionalProperties = false;
-        },
     });
     const { $schema, ...rest } = schema;
     return {
         $schema,
         $id: 'https://github.com/IgorBabkin/ts-ioc-container/tree/main/packages/bundler/tic.schema.json',
         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.",
+        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. `extends` and `baseUrl` resolve against this file's directory; `include`, `exclude` and `output` resolve against `baseUrl`, defaulting to this file's directory.",
         ...rest,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ts-ioc-container/bundler",
-  "version": "2.1.0",
+  "version": "3.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",
@@ -52,7 +52,7 @@
     "reflect-metadata": "^0.2.2",
     "yaml": "^2.8.3",
     "zod": "^4.6.5",
-    "ts-ioc-container": "74.0.0"
+    "ts-ioc-container": "75.0.0"
   },
   "peerDependencies": {
     "typescript": ">=5"

package/tic.schema.json

@@ -2,14 +2,25 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://github.com/IgorBabkin/ts-ioc-container/tree/main/packages/bundler/tic.schema.json",
   "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.",
+  "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. `extends` and `baseUrl` resolve against this file's directory; `include`, `exclude` and `output` resolve against `baseUrl`, defaulting to this file's directory.",
   "type": "object",
   "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
+    },
+    "baseUrl": {
+      "description": "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 this file; default this file's directory. Also handed to TypeScript as `compilerOptions.baseUrl` (unless that is set too), so generated imports use it.",
+      "type": "string",
+      "minLength": 1
+    },
     "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.",
+      "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
     },
@@ -18,125 +29,96 @@
       "type": "string",
       "pattern": "^[A-Za-z][\\w-]*$"
     },
-    "tags": {
-      "default": [],
-      "description": "Tags associated with the bundle.",
+    "include": {
+      "description": "tsconfig `include`: replaces the extended tsconfig's. Relative to `baseUrl`. When `baseUrl` is set and this is omitted, the whole `baseUrl` folder (`.`) is scanned.",
       "type": "array",
       "items": {
         "type": "string",
         "minLength": 1
       }
     },
-    "extends": {
-      "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.",
-      "type": "string",
-      "minLength": 1
-    },
-    "importExtension": {
-      "description": "Extension of generated imports, e.g. \".js\". Inferred from the tsconfig: \".js\" under node16/nodenext resolution, none otherwise.",
-      "type": "string"
+    "exclude": {
+      "description": "tsconfig `exclude`: replaces the extended tsconfig's. Relative to `baseUrl`.",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
     },
-    "files": {
+    "compilerOptions": {
       "type": "object",
       "properties": {
-        "paths": {
-          "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": {
-            "anyOf": [
-              {
+        "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",
-                "properties": {
-                  "path": {
-                    "type": "string",
-                    "minLength": 1
-                  },
-                  "recursive": {
-                    "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",
-          "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
+            }
           },
-          "minItems": 1
+          "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": {
-          "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.",
-          "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",
-      "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
-          }
-        },
-        "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
+        "paths": {
+          "description": "tsconfig `paths`: aliases the generated imports are written in.",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
           },
-          "minItems": 1
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
         },
-        "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
+        "rootDir": {
+          "description": "tsconfig `rootDir`: where the default output (<rootDir>/<name>.bundle.ts) goes.",
+          "type": "string"
         }
       },
-      "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": {},
+      "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

@@ -11,8 +11,7 @@ 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.
+ * @throws {TicConfigError} when the config or the tsconfig it extends is missing or invalid.
  */
 export declare function build({ cwd, ...request }?: BuildOptions): BuildResult;
 /**

package/typings/exceptions/DomainException.d.ts

@@ -10,10 +10,6 @@ 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);

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