@ts-ioc-container/bundler 6.0.0 → 7.0.0

package/AGENTS.md

@@ -7,10 +7,11 @@ nothing here runs inside the container, and the core package is not changed by
 it.
 
 - The CLI is `ts-ioc-container`, with `tic` as a shortcut (both `bin` entries,
-  same program): `tic build [<config>]` is a Unix filter. It reads the config
-  file `<config>` (JSON for `.json`, YAML for `.yaml` / `.yml`) — or, without
-  one or with `-`, config text from stdin (parsed as YAML, which covers JSON) —
-  and prints the bundle to **stdout**; it writes nothing. Saving is the shell's
+  same program): `tic build [<config>...]` is a Unix filter. It reads the config
+  file `<config>` (JSON for `.json`, YAML for `.yaml` / `.yml`) — several are
+  merged left to right into one bundle — or, without one or with `-`, config
+  text from stdin (parsed as YAML, which covers JSON; never merged) — and
+  prints the bundle to **stdout**; it writes nothing. Saving is the shell's
   job: `tic build app.bundle.json > src/di/app.bundle.ts`,
   `cat dev.bundle.json | tic build > src/di/dev.bundle.ts`; CI checks with
   `tic build app.bundle.json | diff - src/di/app.bundle.ts`. Warnings and errors
@@ -20,7 +21,7 @@ IContainerModule`, applied with `container.useModule(new AppBundle())`.
   bundle works wherever it is saved; a selected class no alias covers fails the
   build naming its file. There are no relative imports.
 - Config fields (schema: `tic.schema.json`), flat: `paths` with `paths.include`
-  required; `className`, `name`, `tsconfig`, `importExtension` optional.
+  required; `match`, `name`, `tsconfig`, `importExtension` optional.
   Relative paths resolve against the config file; for piped text, against the
   working directory. `name` defaults to the file's stem (`prod.bundle.json` →
   `prod`) and is required for piped text or a file named otherwise; the class
@@ -31,9 +32,9 @@ IContainerModule`, applied with `container.useModule(new AppBundle())`.
   name and generated imports are written in (most specific alias, else a
   relative path) — and the module resolution that sets the import extension.
 - Selection has two stages, `paths: { include, exclude }` and
-  `className: { ..., glob, exclude }`. `paths` is always an object (a string
-  or a list in its place is an error); `className` also takes a string or a
-  list as a shortcut for `className.glob`. `paths` decides by path which files
+  `match: { ..., glob, exclude }`. `paths` is always an object (a string
+  or a list in its place is an error); `match` also takes a string or a
+  list as a shortcut for `match.glob`. `paths` decides by path which files
   are read and parsed at all. `paths.include` (required: one folder or a
   non-empty list) names the folders scanned, always with their sub-folders —
   relative to the config file (`./src/services`) or tsconfig aliases
@@ -43,8 +44,8 @@ IContainerModule`, applied with `container.useModule(new AppBundle())`.
   catch-all `"*"` aliases are skipped; default: test files, `__tests__/`,
   `node_modules/`; a non-empty value replaces it, and the build warns if it drops
   a default). Files `tic build` generated are never input.
-- `className: { export, decorators, glob, exclude }` (or `className: '*Service'`
-  / `['*Service', '*Repository']` = `className.glob`, default `export` and
+- `match: { export, decorators, glob, exclude }` (or `match: '*Service'`
+  / `['*Service', '*Repository']` = `match.glob`, default `export` and
   `decorators`) then picks classes of the parsed files; default is every exported,
   non-abstract class decorated with `@register` (`decorators` defaults to
   `["register"]`; `[]` requires none); positive criteria must all hold — `glob` is one glob
@@ -54,12 +55,23 @@ IContainerModule`, applied with `container.useModule(new AppBundle())`.
   two selected classes pass the same plain-identifier first decorator argument (a
   same-token heuristic), unless a decorator they share has differing arguments
   (scope-gated, e.g. `@perPage('a')` vs `@perPage('b')`).
+- Several configs merge like webpack-merge (`mergeConfigs`):
+  `tic build common.bundle.yml prod.bundle.yml > src/di/prod.bundle.ts`.
+  Objects merge field by field; the list fields `paths.include`,
+  `paths.exclude`, `match.glob`, `match.exclude` and `match.decorators`
+  concatenate without duplicates (a later config only adds); any other value
+  set later replaces an earlier one; the `match` shorthand merges as
+  `match.glob`. Each file is validated alone (`BUNDLE_CONFIG_FILE_SCHEMA`:
+  `paths` optional; errors name the file), the merged result as one config
+  (`BUNDLE_CONFIG_SCHEMA`). Defaults apply to the merged config only. The last
+  file names the bundle unless one sets `name`; all must sit in one folder.
 - Never edit a `*.bundle.ts` by hand — change the classes or the config and
   rerun `tic build`.
 - Unknown config fields are errors, at every level.
-- Programmatic API: `build({ config, cwd })` or `build({ text, cwd })` returns
+- Programmatic API: `build({ config, cwd })` (`config`: a file or a list merged
+  left to right) or `build({ text, cwd })` returns
   `{ content, bundle, registrations, warnings }` and writes nothing;
-  `loadConfig(file)`, `run(argv, io)` (`io.stdin` backs piped configs); every error the
+  `loadConfig(file | files)`, `run(argv, io)` (`io.stdin` backs piped configs); every error the
   bundler raises on purpose is a `TicError` with a stable `code`
   (`TicConfigError` = `INVALID_CONFIG`, `NamespaceNotFoundError`, `UsageError`,
   …).
@@ -72,4 +84,5 @@ IContainerModule`, applied with `container.useModule(new AppBundle())`.
   services behind tokens (`IBundleBuilderKey`, `ITicConfigServiceKey`, …); pure
   logic in `lib/features/build/domain/`. A new command is a controller plus a module.
 - The config schema is `BUNDLE_CONFIG_SCHEMA` (zod); `tic.schema.json` is generated
-  from it with `pnpm run generate:schema` — never edit it by hand.
+  from its per-file variant `BUNDLE_CONFIG_FILE_SCHEMA` with `pnpm run generate:schema`
+  — never edit it by hand.

package/README.md

@@ -33,11 +33,12 @@ below use the shortcut.
 ## Build
 
 ```bash
-tic build [<config>]
+tic build [<config>...]
 ```
 
 `tic build` prints the bundle to **stdout** and writes nothing. `<config>` is a
-config file — JSON for `.json`, YAML for `.yaml` / `.yml`. Without it (or with
+config file — JSON for `.json`, YAML for `.yaml` / `.yml`. Several are
+[merged](#merging-configs) left to right into one bundle. Without one (or with
 `-`) the config is read from **stdin**. Warnings and errors go to stderr, so
 they never end up in the bundle.
 
@@ -46,6 +47,9 @@ they never end up in the bundle.
 tic build app.bundle.json > src/di/app.bundle.ts
 tic build prod.bundle.yml > src/di/prod.bundle.ts
 
+# several configs merged into one bundle, like webpack-merge
+tic build common.bundle.yml prod.bundle.yml > src/di/prod.bundle.ts
+
 # the config piped in — it has no file name, so it sets `name` ("name": "dev")
 cat dev.bundle.json | tic build > src/di/dev.bundle.ts
 tic build < dev.bundle.yml > src/di/dev.bundle.ts
@@ -69,8 +73,9 @@ covers is an error naming its file; add a `paths` entry for its folder.
 
 Relative paths in a config file resolve against the file; in a piped config,
 against the working directory. The bundle is named after the config file —
-`prod.bundle.json` exports `ProdBundle` — unless the config sets `name`, which a
-piped config, or a file not named `<name>.bundle.json`, must.
+`prod.bundle.json` exports `ProdBundle`; of several merged, after the last —
+unless the config sets `name`, which a piped config, or a file not named
+`<name>.bundle.json`, must.
 
 ## Configure
 
@@ -94,8 +99,8 @@ paths:
 
 | Field             | Default                                       | Meaning                                                                                                     |
 | ----------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| `paths`           | — (required)                                  | Which files are parsed — see [Selecting files](#selecting-files)                                            |
-| `className`       | exported classes with `@register`             | Which classes of a parsed file are registered — see [Selecting classes](#selecting-classes)                 |
+| `paths`           | — (required)                                  | Which files are parsed — see [Selecting files](#selecting-files). Merged configs need it in one of them     |
+| `match`           | exported classes with `@register`             | Which classes of a parsed file are registered — see [Selecting classes](#selecting-classes)                 |
 | `name`            | the config file's (`app.bundle.json` → `app`) | The bundle's name: names the class, `AppBundle`. Required for a piped config or a file named otherwise      |
 | `tsconfig`        | `./tsconfig.json`                             | Source of the `paths` aliases every import is written through, and of the import extension — never of files |
 | `importExtension` | `.js` under node16/nodenext, else none        | Extension of generated imports                                                                              |
@@ -105,31 +110,37 @@ unnoticed.
 
 ## Several bundles
 
-Need more than one bundle — per environment, per app? Keep a config per bundle
-and build each one:
+Need more than one bundle — per environment, per app? Keep what they share in
+one config, what each adds in another, and build each environment from both:
 
 ```bash
 for env in prod dev test; do
-  tic build "$env.bundle.yml" > "src/di/$env.bundle.ts"
+  tic build common.bundle.yml "$env.bundle.yml" > "src/di/$env.bundle.ts"
 done
 ```
 
 ```json
 {
   "scripts": {
-    "bundle": "tic build app.bundle.json > src/di/app.bundle.ts",
-    "bundle:check": "tic build app.bundle.json | diff - src/di/app.bundle.ts"
+    "bundle": "tic build common.bundle.yml prod.bundle.yml > src/di/prod.bundle.ts",
+    "bundle:check": "tic build common.bundle.yml prod.bundle.yml | diff - src/di/prod.bundle.ts"
   }
 }
 ```
 
-Each config selects its own files and classes:
-
 ```yaml
-# prod.bundle.yml: services + adapters, minus dev-only *.dev.ts files
+# common.bundle.yml: what every environment registers
 paths:
   include:
     - '@app/services'
+```
+
+Each environment's config adds its own files and classes:
+
+```yaml
+# prod.bundle.yml: + the adapters, minus dev-only *.dev.ts files
+paths:
+  include:
     - ./src/infra
   exclude:
     - '**/*.dev.ts'
@@ -142,15 +153,39 @@ paths:
 ```
 
 ```yaml
-# dev.bundle.yml: the *.dev.ts logger replaces the production one, dropped by class name
+# dev.bundle.yml: + the adapters; the *.dev.ts logger replaces the production one, dropped by class name
 paths:
   include:
-    - '@app/services'
     - ./src/infra
-className:
+match:
   exclude: JsonLogger
 ```
 
+`tic build common.bundle.yml prod.bundle.yml` then scans `@app/services` and
+`./src/infra`, and exports `ProdBundle`.
+
+### Merging configs
+
+`tic build a.bundle.yml b.bundle.yml c.bundle.yml` merges the configs left to
+right, the way webpack-merge merges webpack configs:
+
+- objects merge field by field;
+- list fields — `paths.include`, `paths.exclude`, `match.glob`, `match.exclude`,
+  `match.decorators` — concatenate in order, without duplicates (one folder or
+  glob counts as a list of one), so a later config can only add to them;
+- any other value (`name`, `tsconfig`, `importExtension`, `match.export`) set
+  by a later config replaces an earlier one;
+- the `match` shorthand merges as `match.glob`.
+
+Each config is validated on its own — an error names the file it is in — so a
+shared config may leave `paths` out; the merged config must have
+`paths.include`. Defaults apply to the merged config only: a `paths.exclude` in
+any of them replaces the default excludes, as it does in a single config, so
+list the defaults in the shared config to keep them. The bundle is named after
+the last config, unless one sets `name` — so leave `name` out of a shared
+config. Merged configs must sit in one folder, which their relative paths
+resolve against. A piped config (`-`) is never merged.
+
 A saved bundle is never registered by another build, even when it sits in a
 folder that build scans.
 
@@ -160,7 +195,7 @@ A bundle picks its registrations in two stages:
 
 1. **`paths`** — decided by path alone, before anything is read. Only files that
    pass are parsed.
-2. **`className`** — decided per class, on the files stage 1 let through.
+2. **`match`** — decided per class, on the files stage 1 let through.
 
 Parsing is where the time goes, so point `paths` at the folders that hold your
 registrations, and `exclude` what they should not contribute:
@@ -171,7 +206,7 @@ registrations, and `exclude` what they should not contribute:
     "include": "@app/services",
     "exclude": ["**/*.spec.ts", "**/*.test.ts", "**/__tests__/**", "**/node_modules/**", "**/legacy/**"]
   },
-  "className": { "decorators": ["register"] }
+  "match": { "decorators": ["register"] }
 }
 ```
 
@@ -233,11 +268,11 @@ parses everything, including tests.
 ## Selecting classes
 
 By default every exported, non-abstract class of a parsed file that carries
-`@register` is registered. `className` changes that; a class must meet every
+`@register` is registered. `match` changes that; a class must meet every
 criterion that is set:
 
 ```json
-"className": {
+"match": {
   "export": "named",
   "decorators": ["register", "repository"],
   "glob": "*Service"
@@ -261,7 +296,7 @@ bind the same token, registration is last-wins and the stand-in silently wins.
 matches only itself, so one list drops a class by name and a family by pattern:
 
 ```json
-"className": {
+"match": {
   "decorators": ["repository", "service"],
   "exclude": ["MockDashboardRepository", "*Fake"]
 }
@@ -270,18 +305,18 @@ matches only itself, so one list drops a class by name and a family by pattern:
 `exclude` applies after every other criterion, so it combines with
 `decorators` and `glob` freely.
 
-### The `className` shortcut
+### The `match` shortcut
 
-When the default `export` and `decorators` are all you need, `className`
+When the default `export` and `decorators` are all you need, `match`
 itself can be the class-name globs — a string or a list is a shortcut for
-`className.glob`:
+`match.glob`:
 
 ```yaml
-className: '*Service' # = className: { glob: '*Service' }
+match: '*Service' # = match: { glob: '*Service' }
 ```
 
 ```yaml
-className: ['*Service', '*Repository'] # = className: { glob: ['*Service', '*Repository'] }
+match: ['*Service', '*Repository'] # = match: { glob: ['*Service', '*Repository'] }
 ```
 
 As a safety net, the build warns when two selected classes pass the same
@@ -292,7 +327,7 @@ are not resolved), so it can only be a heuristic:
 ```text
 tic: warning: app.bundle.json: decorator token "IDashboardRepositoryToken" is passed by
 HttpDashboardRepository, MockDashboardRepository; registration is last-wins,
-exclude one with className.exclude
+exclude one with match.exclude
 ```
 
 Classes that are scope-gated are not last-wins, so they do not warn: when the

package/cjm/app.js

@@ -34,6 +34,6 @@ function run(argv, io = (0, CliIo_1.processIo)()) {
 function build({ cwd = process.cwd(), ...request }) {
     return withContainer({ ...(0, CliIo_1.processIo)(), cwd }, (container) => BundleBuilder_1.IBundleBuilderKey.resolve(container).build(request));
 }
-function loadConfig(file) {
-    return withContainer((0, CliIo_1.processIo)(), (container) => TicConfigService_1.ITicConfigServiceKey.resolve(container).load(file));
+function loadConfig(files) {
+    return withContainer((0, CliIo_1.processIo)(), (container) => TicConfigService_1.ITicConfigServiceKey.resolve(container).load(files));
 }

package/cjm/cli/usage.js

@@ -6,10 +6,11 @@ exports.USAGE = [
     '       tic is a shortcut for ts-ioc-container',
     '',
     'Commands:',
-    '  ts-ioc-container build [<config>]   print the bundle a config file (.json, .yaml, .yml) describes;',
-    '                                     without one (or with -), read the config from stdin',
-    '  ts-ioc-container help               show this help',
-    '  ts-ioc-container version            show the version',
+    '  ts-ioc-container build [<config>...]   print the bundle a config file (.json, .yaml, .yml) describes;',
+    '                                        several are merged left to right into one bundle;',
+    '                                        without one (or with -), read the config from stdin',
+    '  ts-ioc-container help                  show this help',
+    '  ts-ioc-container version               show the version',
     '',
     'Options:',
     '  -h, --help      show this help',
@@ -17,6 +18,7 @@ exports.USAGE = [
     '',
     'The bundle goes to stdout and warnings to stderr; saving it is up to you:',
     '  tic build app.bundle.json > src/di/app.bundle.ts',
+    '  tic build common.bundle.yml prod.bundle.yml > src/di/prod.bundle.ts   # merged left to right',
     '  cat app.bundle.yml | tic build > src/di/app.bundle.ts     # config from stdin (must set name)',
     '  tic build app.bundle.json | diff - src/di/app.bundle.ts   # CI: is it current?',
 ].join('\n');

package/cjm/features/build/BuildConfig.js

@@ -3,9 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.configFormat = exports.STDIN = exports.CONFIG_FILE_SUFFIXES = exports.BUNDLE_CONFIG_SCHEMA = exports.DEFAULT_EXCLUDE = exports.DEFAULT_DECORATORS = exports.DEFAULT_TSCONFIG = void 0;
+exports.configFormat = exports.STDIN = exports.CONFIG_FILE_SUFFIXES = exports.BUNDLE_CONFIG_FILE_SCHEMA = exports.BUNDLE_CONFIG_SCHEMA = exports.DEFAULT_EXCLUDE = exports.DEFAULT_DECORATORS = exports.DEFAULT_TSCONFIG = void 0;
 exports.parseConfig = parseConfig;
 exports.toClassName = toClassName;
+exports.mergeConfigs = mergeConfigs;
 exports.resolveConfig = resolveConfig;
 const node_path_1 = __importDefault(require("node:path"));
 const yaml_1 = require("yaml");
@@ -42,6 +43,7 @@ const globs = () => globList('a glob or a non-empty array of globs', 1);
 const toList = (value) => (Array.isArray(value) ? value : [value]);
 const toGlobs = (value) => value === undefined ? undefined : toList(value).map(glob_1.globToRegExp);
 const FOLDERS_SCHEMA = zod_1.z.array(nonEmptyString(), expected('a non-empty array')).min(1, expected('a non-empty array'));
+const PATHS_DESCRIPTION = 'Which files this bundle reads and parses — decided by path alone, before parsing. `include` names the folders the files come from; within them a file is parsed unless it matches one of `exclude`. Globs are relative to the config file.';
 const PATHS_SCHEMA = zod_1.z
     .strictObject({
     include: zod_1.z
@@ -51,7 +53,7 @@ const PATHS_SCHEMA = zod_1.z
         .default(exports.DEFAULT_EXCLUDE)
         .describe('Glob, or globs, of files never read, relative to the config file or starting with a tsconfig paths alias (@generated/**, or @generated for the whole folder). Replaces the default when given. A non-empty value that omits a default glob makes `tic build` warn.'),
 }, expected('an object with "include"'))
-    .describe('Which files this bundle reads and parses — decided by path alone, before parsing. `include` names the folders the files come from; within them a file is parsed unless it matches one of `exclude`. Globs are relative to the config file.');
+    .describe(PATHS_DESCRIPTION);
 const CLASS_OBJECT_SCHEMA = zod_1.z.strictObject({
     export: zod_1.z
         .enum(['any', 'named', 'default'], expected('"any", "named" or "default"'))
@@ -93,8 +95,11 @@ exports.BUNDLE_CONFIG_SCHEMA = zod_1.z.strictObject({
         .optional()
         .describe('Extension of generated imports, e.g. ".js". Inferred from the tsconfig: ".js" under node16/nodenext resolution, none otherwise.'),
     paths: PATHS_SCHEMA,
-    className: CLASSES_SCHEMA.optional(),
+    match: CLASSES_SCHEMA.optional(),
 }, expected('an object'));
+exports.BUNDLE_CONFIG_FILE_SCHEMA = exports.BUNDLE_CONFIG_SCHEMA.extend({
+    paths: PATHS_SCHEMA.partial().optional().describe(`${PATHS_DESCRIPTION} Required in the merged config.`),
+});
 function formatPath(segments) {
     const formatted = segments
         .map((segment) => (typeof segment === 'number' ? `[${segment}]` : `.${String(segment)}`))
@@ -122,13 +127,13 @@ function toPathSelector(paths) {
         exclude: toList(paths.exclude),
     };
 }
-function toClassSelector(className) {
-    if (className === undefined)
+function toClassSelector(match) {
+    if (match === undefined)
         return { export: 'any', decorators: exports.DEFAULT_DECORATORS };
-    if (typeof className === 'string' || Array.isArray(className)) {
-        return { export: 'any', decorators: exports.DEFAULT_DECORATORS, glob: toGlobs(className) };
+    if (typeof match === 'string' || Array.isArray(match)) {
+        return { export: 'any', decorators: exports.DEFAULT_DECORATORS, glob: toGlobs(match) };
     }
-    const { decorators, glob, exclude, ...rest } = className;
+    const { decorators, glob, exclude, ...rest } = match;
     return {
         ...rest,
         decorators: decorators.length > 0 ? decorators : undefined,
@@ -170,11 +175,38 @@ function toClassName(name) {
     const words = name.split(/[-_]+/).filter(Boolean);
     return `${words.map((word) => word[0].toUpperCase() + word.slice(1)).join('')}Bundle`;
 }
+const LIST_FIELDS = new Set(['paths.include', 'paths.exclude', 'match.decorators', 'match.glob', 'match.exclude']);
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+function mergeInto(base, next, at = '') {
+    const merged = { ...base };
+    for (const [key, value] of Object.entries(next)) {
+        const field = `${at}${key}`;
+        const previous = merged[key];
+        if (LIST_FIELDS.has(field)) {
+            merged[key] = [
+                ...new Set([...toList((previous ?? [])), ...toList(value)]),
+            ];
+        }
+        else {
+            merged[key] = isObject(previous) && isObject(value) ? mergeInto(previous, value, `${field}.`) : value;
+        }
+    }
+    return merged;
+}
+const expandMatch = ({ match, ...rest }) => match === undefined ? rest : { ...rest, match: isObject(match) ? match : { glob: match } };
+function mergeConfigs(configs) {
+    return configs.reduce((merged, { file, content }) => {
+        const result = exports.BUNDLE_CONFIG_FILE_SCHEMA.safeParse(content);
+        if (!result.success)
+            throw new DomainException_1.TicConfigError(`${node_path_1.default.basename(file)}: ${formatIssues(result.error)}`);
+        return mergeInto(merged, expandMatch(content));
+    }, {});
+}
 function resolveConfig(content, file) {
     const result = exports.BUNDLE_CONFIG_SCHEMA.safeParse(content);
     if (!result.success)
         throw new DomainException_1.TicConfigError(formatIssues(result.error));
-    const { name, tsconfig, importExtension, paths, className } = result.data;
+    const { name, tsconfig, importExtension, paths, match } = result.data;
     const bundleName = name ?? configStem(file);
     if (bundleName === undefined) {
         throw new DomainException_1.TicConfigError(node_path_1.default.basename(file) === exports.STDIN
@@ -190,7 +222,7 @@ function resolveConfig(content, file) {
         tsconfig: { file: node_path_1.default.resolve(dir, tsconfig ?? exports.DEFAULT_TSCONFIG), required: tsconfig !== undefined },
         importExtension,
         paths: toPathSelector(paths),
-        className: toClassSelector(className),
+        match: toClassSelector(match),
         warnings: excludeWarnings(paths),
     };
 }

package/cjm/features/build/BuildController.js

@@ -23,11 +23,15 @@ const OutputService_1 = require("../../services/OutputService");
 const BuildConfig_1 = require("./BuildConfig");
 const BundleBuilder_1 = require("./services/BundleBuilder");
 exports.BUILD_OPTIONS = zod_1.z.object({ positionals: zod_1.z.array(zod_1.z.string().min(1)) }).transform(({ positionals }, ctx) => {
-    if (positionals.length > 1) {
-        ctx.addIssue({ code: 'custom', path: ['config'], message: `expected one <config>, got ${positionals.join(' ')}` });
+    if (positionals.length > 1 && positionals.includes(BuildConfig_1.STDIN)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['config'],
+            message: `${BuildConfig_1.STDIN} reads one config from stdin and cannot be merged with config files`,
+        });
         return zod_1.z.NEVER;
     }
-    return { config: positionals[0] ?? BuildConfig_1.STDIN };
+    return { configs: positionals.length > 0 ? positionals : [BuildConfig_1.STDIN] };
 });
 const buildArgs = (0, cli_1.parseOptions)({}, { positionals: true });
 let BuildController = class BuildController {
@@ -41,10 +45,11 @@ let BuildController = class BuildController {
         this.output = output;
         this.logger = logger;
     }
-    build({ config }) {
-        const label = config === BuildConfig_1.STDIN ? '<stdin>' : config;
+    build({ configs }) {
+        const stdin = configs[0] === BuildConfig_1.STDIN;
+        const label = stdin ? '<stdin>' : configs.join(' + ');
         try {
-            const { content, warnings } = this.builder.build(config === BuildConfig_1.STDIN ? { text: this.stdin() } : { config });
+            const { content, warnings } = this.builder.build(stdin ? { text: this.stdin() } : { config: configs });
             for (const warning of warnings)
                 this.logger.warn(`${label}: ${warning}`);
             this.output.write(content.replace(/\n$/, ''));

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 className.exclude`);
+            `registration is last-wins, exclude one with match.exclude`);
     });
 }
 function scopeDisjoint(group) {

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

@@ -43,7 +43,7 @@ let BundleBuilder = class BundleBuilder {
     build(request) {
         const resolved = 'text' in request
             ? this.configs.parse(request.text, this.cwd)
-            : this.configs.load(node_path_1.default.resolve(this.cwd, request.config));
+            : this.configs.load([request.config].flat().map((file) => node_path_1.default.resolve(this.cwd, file)));
         const { content, registrations, warnings } = this.generate(resolved);
         return {
             config: 'text' in request ? undefined : resolved.file,
@@ -71,7 +71,7 @@ let BundleBuilder = class BundleBuilder {
             .sort((a, b) => (a < b ? -1 : a > b ? 1 : 0))
             .flatMap((file) => {
             const text = this.fs.readFile(file);
-            return text.startsWith(emit_1.GENERATED_HEADER) ? [] : (0, scan_1.findClasses)(file, config.className, text);
+            return text.startsWith(emit_1.GENERATED_HEADER) ? [] : (0, scan_1.findClasses)(file, config.match, text);
         })
             .map((cls) => ({ ...cls, specifier: paths.specifier(cls.file) }));
         const uncovered = [...new Set(classes.filter((cls) => cls.specifier === undefined).map((cls) => cls.file))];

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

@@ -27,16 +27,27 @@ let TicConfigService = class TicConfigService {
     constructor(fs) {
         this.fs = fs;
     }
-    load(file) {
+    load(files) {
+        if (typeof files === 'string' || files.length === 1) {
+            const [file] = [files].flat();
+            return (0, BuildConfig_1.resolveConfig)(this.read(file), file);
+        }
+        const folders = [...new Set(files.map((file) => node_path_1.default.dirname(file)))];
+        if (folders.length > 1) {
+            throw new DomainException_1.TicConfigError(`configs merged into one bundle must sit in one folder, since their relative paths resolve against it: ${folders.join(', ')}`);
+        }
+        return (0, BuildConfig_1.resolveConfig)((0, BuildConfig_1.mergeConfigs)(files.map((file) => ({ file, content: this.read(file) }))), files[files.length - 1]);
+    }
+    parse(text, dir) {
+        return (0, BuildConfig_1.resolveConfig)((0, BuildConfig_1.parseConfig)(text, 'yaml'), node_path_1.default.join(dir, BuildConfig_1.STDIN));
+    }
+    read(file) {
         const format = (0, BuildConfig_1.configFormat)(file);
         if (format === undefined)
             throw new DomainException_1.TicConfigError(`expected a .json, .yaml or .yml config file: ${file}`);
         if (!this.fs.fileExists(file))
             throw new DomainException_1.TicConfigError(`config file not found: ${file}`);
-        return (0, BuildConfig_1.resolveConfig)((0, BuildConfig_1.parseConfig)(this.fs.readFile(file), format), file);
-    }
-    parse(text, dir) {
-        return (0, BuildConfig_1.resolveConfig)((0, BuildConfig_1.parseConfig)(text, 'yaml'), node_path_1.default.join(dir, BuildConfig_1.STDIN));
+        return (0, BuildConfig_1.parseConfig)(this.fs.readFile(file), format);
     }
 };
 exports.TicConfigService = TicConfigService;

package/cjm/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.listSourceFiles = exports.isSourceFile = exports.findClasses = exports.loadImportPaths = exports.ImportPaths = exports.ticConfigJsonSchema = exports.toClassName = exports.DEFAULT_DECORATORS = exports.DEFAULT_EXCLUDE = exports.DEFAULT_TSCONFIG = exports.configFormat = exports.STDIN = exports.CONFIG_FILE_SUFFIXES = exports.parseConfig = exports.BUNDLE_CONFIG_SCHEMA = exports.resolveConfig = 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.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 = void 0;
+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.loadImportPaths = exports.ImportPaths = exports.ticConfigJsonSchema = exports.toClassName = exports.DEFAULT_DECORATORS = exports.DEFAULT_EXCLUDE = exports.DEFAULT_TSCONFIG = exports.configFormat = exports.STDIN = exports.CONFIG_FILE_SUFFIXES = exports.parseConfig = exports.mergeConfigs = exports.BUNDLE_CONFIG_FILE_SCHEMA = exports.BUNDLE_CONFIG_SCHEMA = exports.resolveConfig = 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.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 = exports.StdOutputService = 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; } });
@@ -36,6 +36,8 @@ Object.defineProperty(exports, "ITicConfigServiceKey", { enumerable: true, get:
 var BuildConfig_1 = require("./features/build/BuildConfig");
 Object.defineProperty(exports, "resolveConfig", { enumerable: true, get: function () { return BuildConfig_1.resolveConfig; } });
 Object.defineProperty(exports, "BUNDLE_CONFIG_SCHEMA", { enumerable: true, get: function () { return BuildConfig_1.BUNDLE_CONFIG_SCHEMA; } });
+Object.defineProperty(exports, "BUNDLE_CONFIG_FILE_SCHEMA", { enumerable: true, get: function () { return BuildConfig_1.BUNDLE_CONFIG_FILE_SCHEMA; } });
+Object.defineProperty(exports, "mergeConfigs", { enumerable: true, get: function () { return BuildConfig_1.mergeConfigs; } });
 Object.defineProperty(exports, "parseConfig", { enumerable: true, get: function () { return BuildConfig_1.parseConfig; } });
 Object.defineProperty(exports, "CONFIG_FILE_SUFFIXES", { enumerable: true, get: function () { return BuildConfig_1.CONFIG_FILE_SUFFIXES; } });
 Object.defineProperty(exports, "STDIN", { enumerable: true, get: function () { return BuildConfig_1.STDIN; } });

package/cjm/schema/ticConfigSchema.js

@@ -4,7 +4,7 @@ exports.ticConfigJsonSchema = ticConfigJsonSchema;
 const zod_1 = require("zod");
 const BuildConfig_1 = require("../features/build/BuildConfig");
 function ticConfigJsonSchema() {
-    const schema = zod_1.z.toJSONSchema(BuildConfig_1.BUNDLE_CONFIG_SCHEMA, {
+    const schema = zod_1.z.toJSONSchema(BuildConfig_1.BUNDLE_CONFIG_FILE_SCHEMA, {
         io: 'input',
         target: 'draft-7',
         unrepresentable: 'any',
@@ -18,7 +18,7 @@ function ticConfigJsonSchema() {
         $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 app.bundle.json` prints the bundle to stdout, and `cat app.bundle.json | tic build` reads the config from stdin. Relative paths resolve against this file's directory (for piped text, the working directory).",
+        description: "One bundle generated by `tic build` (@ts-ioc-container/bundler). `tic build app.bundle.json` prints the bundle to stdout, `tic build common.bundle.json prod.bundle.json` merges several configs left to right, and `cat app.bundle.json | tic build` reads the config from stdin. Relative paths resolve against this file's directory (for piped text, the working directory).",
         ...rest,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ts-ioc-container/bundler",
-  "version": "6.0.0",
+  "version": "7.0.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": "76.0.1"
+    "ts-ioc-container": "76.0.2"
   },
   "peerDependencies": {
     "typescript": ">=5"

package/tic.schema.json

@@ -2,7 +2,7 @@
   "$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 app.bundle.json` prints the bundle to stdout, and `cat app.bundle.json | tic build` reads the config from stdin. Relative paths resolve against this file's directory (for piped text, the working directory).",
+  "description": "One bundle generated by `tic build` (@ts-ioc-container/bundler). `tic build app.bundle.json` prints the bundle to stdout, `tic build common.bundle.json prod.bundle.json` merges several configs left to right, and `cat app.bundle.json | tic build` reads the config from stdin. Relative paths resolve against this file's directory (for piped text, the working directory).",
   "type": "object",
   "properties": {
     "$schema": {
@@ -24,6 +24,7 @@
       "type": "string"
     },
     "paths": {
+      "description": "Which files this bundle reads and parses — decided by path alone, before parsing. `include` names the folders the files come from; within them a file is parsed unless it matches one of `exclude`. Globs are relative to the config file. Required in the merged config.",
       "type": "object",
       "properties": {
         "include": {
@@ -68,13 +69,9 @@
           ]
         }
       },
-      "required": [
-        "include"
-      ],
-      "additionalProperties": false,
-      "description": "Which files this bundle reads and parses — decided by path alone, before parsing. `include` names the folders the files come from; within them a file is parsed unless it matches one of `exclude`. Globs are relative to the config file."
+      "additionalProperties": false
     },
-    "className": {
+    "match": {
       "anyOf": [
         {
           "type": "string",
@@ -155,8 +152,5 @@
       "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. A glob, or a list of globs, is shorthand for { \"glob\": ... }."
     }
   },
-  "required": [
-    "paths"
-  ],
   "additionalProperties": false
 }

package/typings/app.d.ts

@@ -11,14 +11,15 @@ export declare function run(argv: string[], io?: CliIo): number;
  * Generates the bundle a config file describes — `tic build` as a function — and returns
  * it; nothing is written.
  *
- * @throws {TicConfigError} when the config file is missing or unreadable, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
+ * @throws {TicConfigError} when a config file is missing or unreadable, several are in different folders, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
  * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
  */
 export declare function build({ cwd, ...request }: BuildOptions): BuildResult;
 /**
- * Reads and validates a config file: JSON for `.json`, YAML for `.yaml` / `.yml`.
+ * Reads and validates a config file: JSON for `.json`, YAML for `.yaml` / `.yml`. Given several
+ * in one folder, it merges them left to right, as `tic build a.bundle.yml b.bundle.yml` does.
  *
- * @throws {TicConfigError} when the file is missing, has another extension, cannot be parsed, or does not match the config shape.
+ * @throws {TicConfigError} when a file is missing, has another extension, cannot be parsed, or does not match the config shape; when several files are in different folders.
  */
-export declare function loadConfig(file: string): ResolvedConfig;
+export declare function loadConfig(files: string | string[]): ResolvedConfig;
 //# sourceMappingURL=app.d.ts.map

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

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

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

@@ -63,6 +63,8 @@ export interface ResolvedClassSelector {
  * A bundle config file: one bundle, described explicitly — the folders it scans and the
  * classes it registers. `tic build <config>` prints the bundle to stdout; where it is
  * saved is the caller's choice (`tic build app.bundle.json > src/di/app.bundle.ts`).
+ * `tic build common.bundle.yml prod.bundle.yml` merges several into one, left to right
+ * (see {@link mergeConfigs}).
  */
 export interface BundleConfig {
     $schema?: string;
@@ -85,16 +87,17 @@ export interface BundleConfig {
     /**
      * Which files are parsed: the folders in `paths.include`, minus {@link DEFAULT_EXCLUDE} unless
      * `exclude` says otherwise. Always an object: there is no folder or folder-list shorthand.
+     * Required — though in a config merged with others, only the merged config must have it.
      */
     paths: PathSelector;
     /**
      * Which classes of a parsed file are registered. Default: every exported class decorated
      * with `@register`. A glob or a list of globs is shorthand for `{ glob }`.
      */
-    className?: string | string[] | ClassSelector;
+    match?: string | string[] | ClassSelector;
 }
 export declare const DEFAULT_TSCONFIG = "./tsconfig.json";
-/** What `className.decorators` requires when omitted: the library's own `@register`. */
+/** What `match.decorators` requires when omitted: the library's own `@register`. */
 export declare const DEFAULT_DECORATORS: string[];
 export declare const DEFAULT_EXCLUDE: string[];
 /** A {@link BundleConfig} whose defaults are filled in and whose paths are absolute. */
@@ -114,7 +117,7 @@ export interface ResolvedConfig {
     };
     importExtension?: string;
     paths: ResolvedPathSelector;
-    className: ResolvedClassSelector;
+    match: ResolvedClassSelector;
     /** Non-fatal problems found while resolving, e.g. a `paths.exclude` that drops a default test glob. */
     warnings: string[];
 }
@@ -132,7 +135,7 @@ export declare const BUNDLE_CONFIG_SCHEMA: z.ZodObject<{
         include: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
         exclude: z.ZodDefault<z.ZodCustom<string | string[], string | string[]>>;
     }, z.core.$strict>;
-    className: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
+    match: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
         export: z.ZodDefault<z.ZodEnum<{
             default: "default";
             any: "any";
@@ -143,6 +146,31 @@ export declare const BUNDLE_CONFIG_SCHEMA: z.ZodObject<{
         exclude: z.ZodOptional<z.ZodCustom<string | string[], string | string[]>>;
     }, z.core.$strict>]>>;
 }, z.core.$strict>;
+/**
+ * One config file among several merged into one bundle: it may leave `paths.include`, or
+ * `paths` altogether, to another — only the merged config must have it. The published
+ * `tic.schema.json` is generated from it, so editors accept a shared config.
+ */
+export declare const BUNDLE_CONFIG_FILE_SCHEMA: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    tsconfig: z.ZodOptional<z.ZodString>;
+    importExtension: z.ZodOptional<z.ZodString>;
+    match: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
+        export: z.ZodDefault<z.ZodEnum<{
+            default: "default";
+            any: "any";
+            named: "named";
+        }>>;
+        decorators: z.ZodDefault<z.ZodCustom<string[], string[]>>;
+        glob: z.ZodOptional<z.ZodCustom<string | string[], string | string[]>>;
+        exclude: z.ZodOptional<z.ZodCustom<string | string[], string | string[]>>;
+    }, z.core.$strict>]>>;
+    paths: z.ZodOptional<z.ZodObject<{
+        include: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+        exclude: z.ZodOptional<z.ZodDefault<z.ZodCustom<string | string[], string | string[]>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 /**
  * A config file is named `<name>.bundle.json`, `<name>.bundle.yaml` or `<name>.bundle.yml`
  * by convention, e.g. `app.bundle.json`; any `.json` / `.yaml` / `.yml` file works.
@@ -162,6 +190,21 @@ export type ConfigFormat = 'json' | 'yaml';
 export declare function parseConfig(text: string, format: ConfigFormat): unknown;
 /** The generated class for a bundle name: `production` -> `ProductionBundle`, `my-app_v2` -> `MyAppV2Bundle`. */
 export declare function toClassName(name: string): string;
+/**
+ * Merges the contents of several config files into one, left to right, as webpack-merge
+ * does: objects merge field by field, a list field — `paths.include`, `paths.exclude`,
+ * `match.glob`, `match.exclude`, `match.decorators` — concatenates without duplicates
+ * (one glob or folder counting as a list of one), and any other value set by a later file
+ * replaces an earlier one. The `match` shorthand merges as `match.glob`. Each file is
+ * validated alone first, so a shared file may leave out `paths`; defaults apply to the
+ * merged config only, so a `paths.exclude` in any file replaces {@link DEFAULT_EXCLUDE}.
+ *
+ * @throws {TicConfigError} when a file's content does not match the config file shape; the message names the file and the field.
+ */
+export declare function mergeConfigs(configs: {
+    file: string;
+    content: unknown;
+}[]): unknown;
 /**
  * Validates parsed config content and resolves its paths against `file`'s directory.
  * Without a `name` the bundle is named after the file: `production.bundle.json` -> `production`.

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

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

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

@@ -6,12 +6,15 @@ import { type IBundleBuilder } from './services/BundleBuilder.js';
 export declare const BUILD_OPTIONS: z.ZodPipe<z.ZodObject<{
     positionals: z.ZodArray<z.ZodString>;
 }, z.core.$strip>, z.ZodTransform<{
-    config: string;
+    configs: string[];
 }, {
     positionals: string[];
 }>>;
 export type BuildCliOptions = z.output<typeof BUILD_OPTIONS>;
-/** `tic build [<config> | -]`: the bundle goes to stdout; without a config file, the config comes from stdin. */
+/**
+ * `tic build [<config>... | -]`: the bundle goes to stdout; several configs are merged left to right
+ * into one, and without a config file the config comes from stdin.
+ */
 export declare class BuildController {
     private readonly io;
     private readonly builder;
@@ -19,16 +22,18 @@ export declare class BuildController {
     private readonly logger;
     constructor(io: CliIo, builder: IBundleBuilder, output: IOutputService, logger: ILogger);
     /**
-     * Builds the bundle the config file `<config>` describes — or, without one (or with `-`),
-     * the config piped into stdin — and prints it to stdout. Saving it is the shell's job:
-     * `tic build app.bundle.json > src/di/app.bundle.ts`, `cat app.bundle.yml | tic build > out.ts`.
-     * Warnings go to stderr, so they never end up in the bundle; an error names the config.
+     * Builds the bundle the config file `<config>` describes — several merged left to right
+     * into one, or without one (or with `-`), the config piped into stdin — and prints it to
+     * stdout. Saving it is the shell's job: `tic build app.bundle.json > src/di/app.bundle.ts`,
+     * `tic build common.bundle.yml prod.bundle.yml > src/di/prod.bundle.ts`,
+     * `cat app.bundle.yml | tic build > out.ts`.
+     * Warnings go to stderr, so they never end up in the bundle; an error names the configs.
      *
-     * @throws {UsageError} when an option is unknown, there is more than one `<config>`, or the config should come from stdin and nothing is piped in.
-     * @throws {TicConfigError} when the config file is missing or unreadable, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
+     * @throws {UsageError} when an option is unknown, `-` is given with config files, or the config should come from stdin and nothing is piped in.
+     * @throws {TicConfigError} when a config file is missing or unreadable, several are in different folders, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
      * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
      */
-    build({ config }: BuildCliOptions): void;
+    build({ configs }: BuildCliOptions): void;
     /**
      * @throws {UsageError} when nothing is piped into stdin.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"BuildController.d.ts","sourceRoot":"","sources":["../../../lib/features/build/BuildController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,8BAA8B,CAAC;AAEtF,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,0BAA0B,CAAC;AAElF,eAAO,MAAM,aAAa;;;;;;GAOxB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAI7D,iHAAiH;AACjH,qBACa,eAAe;IAEF,OAAO,CAAC,QAAQ,CAAC,EAAE;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHR,EAAE,EAAE,KAAK,EACA,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,cAAc,EAC7B,MAAM,EAAE,OAAO;IAG1D;;;;;;;;;OASG;IAEH,KAAK,CAAgE,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,IAAI;IAavG;;OAEG;IACH,OAAO,CAAC,KAAK;CAOd"}
+{"version":3,"file":"BuildController.d.ts","sourceRoot":"","sources":["../../../lib/features/build/BuildController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,8BAA8B,CAAC;AAEtF,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,0BAA0B,CAAC;AAElF,eAAO,MAAM,aAAa;;;;;;GAWxB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAI7D;;;GAGG;AACH,qBACa,eAAe;IAEF,OAAO,CAAC,QAAQ,CAAC,EAAE;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHR,EAAE,EAAE,KAAK,EACA,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,cAAc,EAC7B,MAAM,EAAE,OAAO;IAG1D;;;;;;;;;;;OAWG;IAEH,KAAK,CAAgE,EAAE,OAAO,EAAE,EAAE,eAAe,GAAG,IAAI;IAcxG;;OAEG;IACH,OAAO,CAAC,KAAK;CAOd"}

package/typings/features/build/services/BundleBuilder.d.ts

@@ -4,8 +4,11 @@ import { type IFileSystemService } from '../../../services/NodeFileSystemService
 import { type ITicConfigService } from './TicConfigService.js';
 /** What one build does. Paths resolve against the run's working directory. */
 export type BuildRequest = {
-    /** Path of the config file — `*.json`, `*.yaml` or `*.yml` — relative to the working directory. */
-    config: string;
+    /**
+     * Path of the config file — `*.json`, `*.yaml` or `*.yml` — relative to the working directory;
+     * or of several in one folder, merged left to right into one bundle.
+     */
+    config: string | string[];
 } | {
     /**
      * The config as text, e.g. read from stdin: YAML or JSON. Its relative paths resolve
@@ -18,7 +21,7 @@ export type BuildOptions = BuildRequest & {
     cwd?: string;
 };
 export interface BuildResult {
-    /** Absolute path of the config file that was built; `undefined` for config text. */
+    /** Absolute path of the config file that was built — of several merged, the last; `undefined` for config text. */
     config?: string;
     /** Name of the generated class. */
     bundle: string;
@@ -35,7 +38,7 @@ export interface IBundleBuilder {
     /**
      * Generates the bundle a config describes and returns it; nothing is written.
      *
-     * @throws {TicConfigError} when the config file is missing or unreadable, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
+     * @throws {TicConfigError} when a config file is missing or unreadable, several are in different folders, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
      * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
      */
     build(request: BuildRequest): BuildResult;
@@ -48,7 +51,7 @@ export declare class BundleBuilder implements IBundleBuilder {
     private readonly renderer;
     constructor(cwd: string, configs: ITicConfigService, fs: IFileSystemService, renderer: IRenderService);
     /**
-     * @throws {TicConfigError} when the config file is missing or unreadable, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
+     * @throws {TicConfigError} when a config file is missing or unreadable, several are in different folders, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
      * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
      */
     build(request: BuildRequest): BuildResult;

package/typings/features/build/services/BundleBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BundleBuilder.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/services/BundleBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,2CAA2C,CAAC;AACnG,OAAO,EAAE,KAAK,kBAAkB,EAAyB,MAAM,yCAAyC,CAAC;AAGzG,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,oBAAoB,CAAC;AAOlF,8EAA8E;AAC9E,MAAM,MAAM,YAAY,GACpB;IACE,mGAAmG;IACnG,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG;IACxC,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,oIAAoI;IACpI,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAAC;CAC3C;AAED,eAAO,MAAM,iBAAiB,6BAAoD,CAAC;AAEnF,qBACa,aAAc,YAAW,cAAc;IAEnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;IACvB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAHV,GAAG,EAAE,MAAM,EACN,OAAO,EAAE,iBAAiB,EACzB,EAAE,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc;IAG1E;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAezC;;;OAGG;IACH,OAAO,CAAC,QAAQ;CA0CjB"}
+{"version":3,"file":"BundleBuilder.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/services/BundleBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,2CAA2C,CAAC;AACnG,OAAO,EAAE,KAAK,kBAAkB,EAAyB,MAAM,yCAAyC,CAAC;AAGzG,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,oBAAoB,CAAC;AAOlF,8EAA8E;AAC9E,MAAM,MAAM,YAAY,GACpB;IACE;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC3B,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG;IACxC,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,kHAAkH;IAClH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,oIAAoI;IACpI,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAAC;CAC3C;AAED,eAAO,MAAM,iBAAiB,6BAAoD,CAAC;AAEnF,qBACa,aAAc,YAAW,cAAc;IAEnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;IACvB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAHV,GAAG,EAAE,MAAM,EACN,OAAO,EAAE,iBAAiB,EACzB,EAAE,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc;IAG1E;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAezC;;;OAGG;IACH,OAAO,CAAC,QAAQ;CA0CjB"}

package/typings/features/build/services/TicConfigService.d.ts

@@ -3,11 +3,13 @@ import { type IFileSystemService } from '../../../services/NodeFileSystemService
 import { type ResolvedConfig } from '../BuildConfig.js';
 export interface ITicConfigService {
     /**
-     * Reads and validates a config file: JSON for `.json`, YAML for `.yaml` / `.yml`.
+     * Reads and validates a config file: JSON for `.json`, YAML for `.yaml` / `.yml`. Given several,
+     * it merges them left to right (see `mergeConfigs`); they must sit in one folder, which their
+     * relative paths resolve against, and the last one names the bundle unless one sets `name`.
      *
-     * @throws {TicConfigError} when the file is missing, has another extension, cannot be parsed, or does not match the config shape.
+     * @throws {TicConfigError} when a file is missing, has another extension, cannot be parsed, or does not match the config shape; when several files are in different folders.
      */
-    load(file: string): ResolvedConfig;
+    load(files: string | string[]): ResolvedConfig;
     /**
      * Validates config text from somewhere other than a file — stdin, say. It is parsed as YAML,
      * which JSON is a subset of; its relative paths resolve against `dir`, and it has no file
@@ -22,12 +24,16 @@ export declare class TicConfigService implements ITicConfigService {
     private readonly fs;
     constructor(fs: IFileSystemService);
     /**
-     * @throws {TicConfigError} when the file is missing, has another extension, cannot be parsed, or does not match the config shape.
+     * @throws {TicConfigError} when a file is missing, has another extension, cannot be parsed, or does not match the config shape; when several files are in different folders.
      */
-    load(file: string): ResolvedConfig;
+    load(files: string | string[]): ResolvedConfig;
     /**
      * @throws {TicConfigError} when the text cannot be parsed, does not match the config shape, or has no `name`.
      */
     parse(text: string, dir: string): ResolvedConfig;
+    /**
+     * @throws {TicConfigError} when the file is missing, has another extension, or cannot be parsed.
+     */
+    private read;
 }
 //# sourceMappingURL=TicConfigService.d.ts.map

package/typings/features/build/services/TicConfigService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TicConfigService.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/services/TicConfigService.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,KAAK,kBAAkB,EAAyB,MAAM,yCAAyC,CAAC;AACzG,OAAO,EAA6B,KAAK,cAAc,EAAwB,MAAM,gBAAgB,CAAC;AAEtG,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;IAEnC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC;CAClD;AAED,eAAO,MAAM,oBAAoB,gCAA0D,CAAC;AAE5F,qBACa,gBAAiB,YAAW,iBAAiB;IACT,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,kBAAkB;IAEtF;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAOlC;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc;CAGjD"}
+{"version":3,"file":"TicConfigService.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/services/TicConfigService.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,KAAK,kBAAkB,EAAyB,MAAM,yCAAyC,CAAC;AACzG,OAAO,EAA2C,KAAK,cAAc,EAAwB,MAAM,gBAAgB,CAAC;AAEpH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC;IAE/C;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC;CAClD;AAED,eAAO,MAAM,oBAAoB,gCAA0D,CAAC;AAE5F,qBACa,gBAAiB,YAAW,iBAAiB;IACT,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,kBAAkB;IAEtF;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc;IAiB9C;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc;IAIhD;;OAEG;IACH,OAAO,CAAC,IAAI;CAMb"}

package/typings/index.d.ts

@@ -6,7 +6,7 @@ export { BuildModule } from './features/build/BuildModule.js';
 export { BuildController, BUILD_OPTIONS, type BuildCliOptions } from './features/build/BuildController.js';
 export { BundleBuilder, IBundleBuilderKey, type IBundleBuilder, type BuildRequest, type BuildOptions, type BuildResult, } from './features/build/services/BundleBuilder.js';
 export { TicConfigService, ITicConfigServiceKey, type ITicConfigService, } from './features/build/services/TicConfigService.js';
-export { resolveConfig, BUNDLE_CONFIG_SCHEMA, parseConfig, CONFIG_FILE_SUFFIXES, STDIN, configFormat, DEFAULT_TSCONFIG, DEFAULT_EXCLUDE, DEFAULT_DECORATORS, toClassName, type BundleConfig, type ClassSelector, type ExportKind, type ResolvedClassSelector, type PathSelector, type ResolvedPathSelector, type ResolvedConfig, type ConfigFormat, } from './features/build/BuildConfig.js';
+export { resolveConfig, BUNDLE_CONFIG_SCHEMA, BUNDLE_CONFIG_FILE_SCHEMA, mergeConfigs, parseConfig, CONFIG_FILE_SUFFIXES, STDIN, configFormat, DEFAULT_TSCONFIG, DEFAULT_EXCLUDE, DEFAULT_DECORATORS, toClassName, type BundleConfig, type ClassSelector, type ExportKind, type ResolvedClassSelector, type PathSelector, type ResolvedPathSelector, type ResolvedConfig, type ConfigFormat, } from './features/build/BuildConfig.js';
 export { ticConfigJsonSchema } from './schema/ticConfigSchema.js';
 export { ImportPaths } from './features/build/domain/ImportPaths.js';
 export { loadImportPaths } from './features/build/domain/tsconfig.js';

package/typings/schema/ticConfigSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ticConfigSchema.d.ts","sourceRoot":"","sources":["../../lib/schema/ticConfigSchema.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB7D"}
+{"version":3,"file":"ticConfigSchema.d.ts","sourceRoot":"","sources":["../../lib/schema/ticConfigSchema.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqB7D"}