@ts-ioc-container/bundler 5.0.0 → 6.0.0

package/AGENTS.md

@@ -19,7 +19,7 @@ IContainerModule`, applied with `container.useModule(new AppBundle())`.
 - Every import in a bundle is written through a tsconfig `paths` alias, so the
   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: `glob` with `glob.glob`
+- Config fields (schema: `tic.schema.json`), flat: `paths` with `paths.include`
   required; `className`, `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` →
@@ -27,19 +27,22 @@ IContainerModule`, applied with `container.useModule(new AppBundle())`.
   is `toClassName(name)` — `ProdBundle`.
 - A config does **not** extend its tsconfig and never takes files from it. The
   `tsconfig` field (default `./tsconfig.json`, may be absent; one named
-  explicitly must exist) only supplies `paths` aliases — which `glob.glob` may
+  explicitly must exist) only supplies `paths` aliases — which `paths.include` may
   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, both shaped `{ glob, exclude }`, and both taking
-  a string or a list as a shortcut for their `glob`. `glob: { glob, exclude }`
-  decides by path which files are read and parsed at all (`glob: ./src` /
-  `glob: [./a, ./b]` = `glob.glob`). `glob.glob` (required: one folder or a
+- 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
+  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
   (`@app/services`); there is no `{ path, recursive }` form. A file in them is parsed unless it matches one
-  of `exclude` (one glob or a list; default: test files, `__tests__/`,
+  of `exclude` (one glob or a list, each relative to the config file or starting
+  with a tsconfig alias — `@generated/**`, or `@generated` for the whole folder;
+  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). There is no `include`. Files `tic build` generated are never input.
+  a default). Files `tic build` generated are never input.
 - `className: { export, decorators, glob, exclude }` (or `className: '*Service'`
   / `['*Service', '*Repository']` = `className.glob`, default `export` and
   `decorators`) then picks classes of the parsed files; default is every exported,

package/README.md

@@ -55,7 +55,7 @@ tic build app.bundle.json | npx prettier --stdin-filepath app.bundle.ts > src/di
 cat dev.bundle.json | tic build | tee src/di/dev.bundle.ts
 
 # a config built on the fly
-printf 'name: app\nglob: "@app/services"\n' | tic build > src/di/app.bundle.ts
+printf 'name: app\npaths:\n  include: "@app/services"\n' | tic build > src/di/app.bundle.ts
 jq '.name = "admin"' app.bundle.json | tic build > src/di/admin.bundle.ts
 
 # CI: is the saved bundle current?
@@ -80,18 +80,21 @@ registers. Point your editor at the schema:
 ```json
 {
   "$schema": "./node_modules/@ts-ioc-container/bundler/tic.schema.json",
-  "glob": ["@app/services", "./src/infra"]
+  "paths": { "include": ["@app/services", "./src/infra"] }
 }
 ```
 
 ```yaml
 # yaml-language-server: $schema=./node_modules/@ts-ioc-container/bundler/tic.schema.json
-glob: ['@app/services', ./src/infra]
+paths:
+  include:
+    - '@app/services'
+    - ./src/infra
 ```
 
 | Field             | Default                                       | Meaning                                                                                                     |
 | ----------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| `glob`            | — (required)                                  | Which files are parsed — see [Selecting files](#selecting-files)                                            |
+| `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)                 |
 | `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 |
@@ -124,8 +127,10 @@ Each config selects its own files and classes:
 
 ```yaml
 # prod.bundle.yml: services + adapters, minus dev-only *.dev.ts files
-glob:
-  glob: ['@app/services', ./src/infra]
+paths:
+  include:
+    - '@app/services'
+    - ./src/infra
   exclude:
     - '**/*.dev.ts'
     - '**/*.spec.ts'
@@ -138,7 +143,10 @@ glob:
 
 ```yaml
 # dev.bundle.yml: the *.dev.ts logger replaces the production one, dropped by class name
-glob: ['@app/services', ./src/infra]
+paths:
+  include:
+    - '@app/services'
+    - ./src/infra
 className:
   exclude: JsonLogger
 ```
@@ -150,17 +158,17 @@ folder that build scans.
 
 A bundle picks its registrations in two stages:
 
-1. **`glob`** — decided by path alone, before anything is read. Only files that
+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.
 
-Parsing is where the time goes, so point `glob` at the folders that hold your
+Parsing is where the time goes, so point `paths` at the folders that hold your
 registrations, and `exclude` what they should not contribute:
 
 ```json
 {
-  "glob": {
-    "glob": "@app/services",
+  "paths": {
+    "include": "@app/services",
     "exclude": ["**/*.spec.ts", "**/*.test.ts", "**/__tests__/**", "**/node_modules/**", "**/legacy/**"]
   },
   "className": { "decorators": ["register"] }
@@ -169,42 +177,42 @@ registrations, and `exclude` what they should not contribute:
 
 ## Selecting files
 
-`glob` takes the same shape as [`className`](#selecting-classes):
-`{ glob, exclude }`. `glob.glob` names the folders a bundle's files come from,
+`paths` is `{ include, exclude }`. `paths.include` names the folders a bundle's files come from,
 and the only ones: what your tsconfig compiles plays no part. It is one folder
 or a list, each relative to the config file (`./src/services`) or a tsconfig
 `paths` alias (`@app/services`, for a `"@app/*": ["./src/*"]` alias), and
-always scanned with its sub-folders.
-
-When the default `exclude` is all you need, `glob` itself can be the folders —
-a string or a list is a shortcut for `glob.glob`:
+always scanned with its sub-folders. `paths` is always an object — a folder or a
+list in place of it is an error — and `exclude` may be left out to keep the default:
 
 ```yaml
-glob: ./src/services # = glob: { glob: ./src/services }
+paths:
+  include: ./src/services # one folder
 ```
 
 ```yaml
-glob: ['@app/services', ./src/infra] # = glob: { glob: ['@app/services', ./src/infra] }
-```
-
-```yaml
-glob: # the object form, for a custom exclude
-  glob: ['@app/services', ./src/infra]
-  exclude: '**/*.dev.ts'
+paths:
+  include: # or a list
+    - '@app/services'
+    - ./src/infra
+  exclude: '**/*.dev.ts' # a custom exclude
 ```
 
 Within them, a file is parsed unless it matches **one of** `exclude`. Globs are relative to the config file and `/`-separated; `**`
-spans folders.
+spans folders. Like a folder in `paths.include`, an exclude glob may start with a
+tsconfig `paths` alias: with `"@generated/*": ["./src/.generated/*"]`,
+`@generated/**` reads `src/.generated/**`, and `@generated` (or `@generated/`)
+drops the whole folder. A catch-all `"*"` alias is never applied, so plain globs
+such as `**/*.spec.ts` keep their meaning.
 
-| Rule      | Default                                   | Meaning                                                                         |
-| --------- | ----------------------------------------- | ------------------------------------------------------------------------------- |
-| `glob`    | — (required)                              | Folder, or folders, to scan                                                     |
-| `exclude` | test files, `__tests__/`, `node_modules/` | A glob, or a list of them, of files never read; replaces the default when given |
+| Rule      | Default                                   | Meaning                                                                                                          |
+| --------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `include` | — (required)                              | Folder, or folders, to scan                                                                                      |
+| `exclude` | test files, `__tests__/`, `node_modules/` | A glob, or a list of them, of files never read; may start with a tsconfig alias; replaces the default when given |
 
 A non-empty `exclude` replaces the defaults, so restate the ones you still want:
 
 ```json
-"glob": {
+"paths": {
   "exclude": [
     "**/*.spec.ts",
     "**/*.test.ts",
@@ -212,7 +220,8 @@ A non-empty `exclude` replaces the defaults, so restate the ones you still want:
     "**/*.test.tsx",
     "**/__tests__/**",
     "**/node_modules/**",
-    "frontend/api/generated/**"
+    "frontend/api/generated/**",
+    "@generated"
   ]
 }
 ```
@@ -265,7 +274,7 @@ matches only itself, so one list drops a class by name and a family by pattern:
 
 When the default `export` and `decorators` are all you need, `className`
 itself can be the class-name globs — a string or a list is a shortcut for
-`className.glob`, just as on `glob`:
+`className.glob`:
 
 ```yaml
 className: '*Service' # = className: { glob: '*Service' }
@@ -299,15 +308,14 @@ The output is plain TypeScript over the public `ts-ioc-container` API:
 // src/di/app.bundle.ts
 // Generated by `tic build`. Do not edit by hand.
 // Paths: @app/services, @app/infra
-import { type IContainer, type IContainerModule, type IRegistration, Registration } from 'ts-ioc-container';
+import { type IContainer, type IContainerModule, Registration } from 'ts-ioc-container';
 import { MemoryLogger } from '@app/infra/logging/MemoryLogger';
 import { Greeter } from '@app/services/Greeter';
 
-export const registrations: IRegistration[] = [Registration.fromClass(MemoryLogger), Registration.fromClass(Greeter)];
-
 export class AppBundle implements IContainerModule {
   applyTo(container: IContainer): void {
-    for (const registration of registrations) container.addRegistration(registration);
+    container.addRegistration(Registration.fromClass(MemoryLogger));
+    container.addRegistration(Registration.fromClass(Greeter));
   }
 }
 ```
@@ -336,5 +344,5 @@ const { content, warnings } = build({ config: 'app.bundle.json' });
 writeFileSync('src/di/app.bundle.ts', content);
 
 // or config text, as `tic build` reads from stdin
-build({ text: 'name: app\nglob:\n  glob: ["@app/services"]\n' });
+build({ text: 'name: app\npaths:\n  include: ["@app/services"]\n' });
 ```

package/cjm/features/build/BuildConfig.js

@@ -42,21 +42,16 @@ 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 GLOB_OBJECT_SCHEMA = zod_1.z.strictObject({
-    glob: zod_1.z
+const PATHS_SCHEMA = zod_1.z
+    .strictObject({
+    include: zod_1.z
         .union([nonEmptyString(), FOLDERS_SCHEMA], expected('a folder or a non-empty array of folders'))
         .describe('Folder, or folders, to scan, sub-folders included: paths relative to the config file (./src/services) or tsconfig paths aliases (@app/services).'),
     exclude: globList('a glob or an array of globs', 0)
         .default(exports.DEFAULT_EXCLUDE)
-        .describe('Glob, or globs, of files never read. Replaces the default when given. A non-empty value that omits a default glob makes `tic build` warn.'),
-}, expected('an object'));
-const GLOB_SCHEMA = zod_1.z
-    .union([
-    nonEmptyString().describe('One folder to scan, with the default exclude: shorthand for { "glob": [...] }.'),
-    FOLDERS_SCHEMA.describe('Folders to scan, with the default exclude: shorthand for { "glob": [...] }.'),
-    GLOB_OBJECT_SCHEMA,
-], expected('a folder, a non-empty array of folders or an object with "glob"'))
-    .describe('Which files this bundle reads and parses — decided by path alone, before parsing. `glob` 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. A folder, or a list of folders, is shorthand for { "glob": [...] }.');
+        .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.');
 const CLASS_OBJECT_SCHEMA = zod_1.z.strictObject({
     export: zod_1.z
         .enum(['any', 'named', 'default'], expected('"any", "named" or "default"'))
@@ -92,12 +87,12 @@ exports.BUNDLE_CONFIG_SCHEMA = zod_1.z.strictObject({
     tsconfig: nonEmptyString()
         .optional()
         .meta({ default: exports.DEFAULT_TSCONFIG })
-        .describe('The tsconfig whose `paths` aliases glob.glob may name and generated imports are written in, and whose module resolution sets the import extension. It adds no files: the bundle scans glob.glob alone. Relative to the config file. The default may be absent; a tsconfig named here must exist.'),
+        .describe('The tsconfig whose `paths` aliases paths.include may name and generated imports are written in, and whose module resolution sets the import extension. It adds no files: the bundle scans paths.include alone. Relative to the config file. The default may be absent; a tsconfig named here must exist.'),
     importExtension: zod_1.z
         .string(expected('a string'))
         .optional()
         .describe('Extension of generated imports, e.g. ".js". Inferred from the tsconfig: ".js" under node16/nodenext resolution, none otherwise.'),
-    glob: GLOB_SCHEMA,
+    paths: PATHS_SCHEMA,
     className: CLASSES_SCHEMA.optional(),
 }, expected('an object'));
 function formatPath(segments) {
@@ -121,15 +116,10 @@ function formatIssue(issue, prefix = []) {
     return [`${formatPath(at)}: ${issue.message}`];
 }
 const formatIssues = (error) => error.issues.flatMap((issue) => formatIssue(issue)).join('; ');
-function toGlobObject(glob) {
-    if (typeof glob === 'string' || Array.isArray(glob))
-        return { glob, exclude: exports.DEFAULT_EXCLUDE };
-    return glob;
-}
-function toGlobSelector(glob) {
+function toPathSelector(paths) {
     return {
-        glob: toList(glob.glob),
-        exclude: toList(glob.exclude).map(glob_1.globToRegExp),
+        include: toList(paths.include),
+        exclude: toList(paths.exclude),
     };
 }
 function toClassSelector(className) {
@@ -146,15 +136,15 @@ function toClassSelector(className) {
         exclude: toGlobs(exclude),
     };
 }
-function excludeWarnings(glob) {
-    const exclude = toList(glob.exclude);
+function excludeWarnings(paths) {
+    const exclude = toList(paths.exclude);
     if (exclude.length === 0)
         return [];
     const missing = exports.DEFAULT_EXCLUDE.filter((glob) => !exclude.includes(glob));
     if (missing.length === 0)
         return [];
     return [
-        `glob.exclude replaces the default excludes and omits ${missing.map((glob) => `"${glob}"`).join(', ')}; ` +
+        `paths.exclude replaces the default excludes and omits ${missing.map((glob) => `"${glob}"`).join(', ')}; ` +
             `add them back`,
     ];
 }
@@ -184,7 +174,7 @@ 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, glob, className } = result.data;
+    const { name, tsconfig, importExtension, paths, className } = result.data;
     const bundleName = name ?? configStem(file);
     if (bundleName === undefined) {
         throw new DomainException_1.TicConfigError(node_path_1.default.basename(file) === exports.STDIN
@@ -192,7 +182,6 @@ function resolveConfig(content, file) {
             : `name: required when the config file is not named <name>${exports.CONFIG_FILE_SUFFIXES.join(' / ')}`);
     }
     const dir = node_path_1.default.dirname(file);
-    const globObject = toGlobObject(glob);
     return {
         file,
         dir,
@@ -200,8 +189,8 @@ function resolveConfig(content, file) {
         bundleClassName: toClassName(bundleName),
         tsconfig: { file: node_path_1.default.resolve(dir, tsconfig ?? exports.DEFAULT_TSCONFIG), required: tsconfig !== undefined },
         importExtension,
-        glob: toGlobSelector(globObject),
+        paths: toPathSelector(paths),
         className: toClassSelector(className),
-        warnings: excludeWarnings(globObject),
+        warnings: excludeWarnings(paths),
     };
 }

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

@@ -77,6 +77,14 @@ class ImportPaths {
         }
         throw new DomainException_1.NamespaceNotFoundError(`namespace "${namespace}" is neither a folder relative to ${baseDir} nor a tsconfig paths alias of one`);
     }
+    resolveGlob(glob, baseDir) {
+        if (isRelative(glob))
+            return [glob];
+        const targets = [glob, `${glob}/`].map((spec) => this.aliasTargets(spec, true)).find((found) => found.length > 0);
+        if (!targets)
+            return [glob];
+        return targets.map((target) => (0, glob_1.toPosix)(node_path_1.default.relative(baseDir, target.endsWith('/') ? `${target}**` : target)));
+    }
     specifier(file) {
         const target = (0, glob_1.toPosix)(file);
         return this.bestAlias(target, target.replace(SOURCE_EXTENSION, ''))?.spec;
@@ -92,12 +100,14 @@ class ImportPaths {
         }
         return best;
     }
-    aliasTargets(spec) {
+    aliasTargets(spec, prefixed = false) {
         return this.aliases.flatMap(({ pattern, targets }) => {
             const wildcard = splitWildcard(pattern);
             if (!wildcard)
                 return pattern === spec ? targets : [];
             const [prefix, suffix] = wildcard;
+            if (prefixed && prefix === '')
+                return [];
             if (!spec.startsWith(prefix) || !spec.endsWith(suffix) || spec.length < prefix.length + suffix.length)
                 return [];
             const captured = spec.slice(prefix.length, spec.length - suffix.length);

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

@@ -6,9 +6,9 @@ exports.emitBundle = emitBundle;
 const HandlebarsRenderService_1 = require("../../../services/HandlebarsRenderService");
 exports.GENERATED_HEADER = '// Generated by `tic build`';
 exports.BUNDLE_PROTOCOL = 'Bundle.ts.hbs';
-const RUNTIME_IMPORTS = ['IContainer', 'IContainerModule', 'IRegistration', 'Registration'];
+const RUNTIME_IMPORTS = ['IContainer', 'IContainerModule', 'Registration'];
 function bundleView({ name, paths, classes }) {
-    const taken = new Set([...RUNTIME_IMPORTS, 'registrations', name]);
+    const taken = new Set([...RUNTIME_IMPORTS, 'container', name]);
     const uniqueName = (wanted) => {
         let candidate = wanted;
         for (let n = 2; taken.has(candidate); n++)

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

@@ -56,13 +56,13 @@ let BundleBuilder = class BundleBuilder {
     generate(config) {
         const paths = (0, tsconfig_1.loadImportPaths)(config.tsconfig, config.importExtension);
         const relative = (file) => (0, glob_1.toPosix)(node_path_1.default.relative(config.dir, file));
-        const { exclude } = config.glob;
+        const exclude = config.paths.exclude.flatMap((glob) => paths.resolveGlob(glob, config.dir)).map(glob_1.globToRegExp);
         const isExcluded = (file) => {
             const filename = relative(file);
             return exclude.some((glob) => glob.test(filename));
         };
         const files = new Set();
-        for (const folder of config.glob.glob) {
+        for (const folder of config.paths.include) {
             const dir = paths.resolveNamespace(folder, config.dir);
             for (const file of (0, scan_1.listSourceFiles)(dir, isExcluded))
                 files.add(file);
@@ -81,7 +81,7 @@ let BundleBuilder = class BundleBuilder {
         }
         const content = this.renderer.render(emit_1.BUNDLE_PROTOCOL, (0, emit_1.bundleView)({
             name: config.bundleClassName,
-            paths: config.glob.glob,
+            paths: config.paths.include,
             classes: classes.map((cls) => ({ ...cls, specifier: cls.specifier })),
         }));
         return { content, registrations: classes.length, warnings: (0, tokenCollisions_1.tokenCollisions)(classes) };

package/package.json

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

package/tic.schema.json

@@ -15,7 +15,7 @@
     },
     "tsconfig": {
       "default": "./tsconfig.json",
-      "description": "The tsconfig whose `paths` aliases glob.glob may name and generated imports are written in, and whose module resolution sets the import extension. It adds no files: the bundle scans glob.glob alone. Relative to the config file. The default may be absent; a tsconfig named here must exist.",
+      "description": "The tsconfig whose `paths` aliases paths.include may name and generated imports are written in, and whose module resolution sets the import extension. It adds no files: the bundle scans paths.include alone. Relative to the config file. The default may be absent; a tsconfig named here must exist.",
       "type": "string",
       "minLength": 1
     },
@@ -23,74 +23,56 @@
       "description": "Extension of generated imports, e.g. \".js\". Inferred from the tsconfig: \".js\" under node16/nodenext resolution, none otherwise.",
       "type": "string"
     },
-    "glob": {
-      "anyOf": [
-        {
-          "type": "string",
-          "minLength": 1,
-          "description": "One folder to scan, with the default exclude: shorthand for { \"glob\": [...] }."
-        },
-        {
-          "minItems": 1,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1
-          },
-          "description": "Folders to scan, with the default exclude: shorthand for { \"glob\": [...] }."
-        },
-        {
-          "type": "object",
-          "properties": {
-            "glob": {
-              "anyOf": [
-                {
-                  "type": "string",
-                  "minLength": 1
-                },
-                {
-                  "minItems": 1,
-                  "type": "array",
-                  "items": {
-                    "type": "string",
-                    "minLength": 1
-                  }
-                }
-              ],
-              "description": "Folder, or folders, to scan, sub-folders included: paths relative to the config file (./src/services) or tsconfig paths aliases (@app/services)."
+    "paths": {
+      "type": "object",
+      "properties": {
+        "include": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1
             },
-            "exclude": {
-              "default": [
-                "**/*.spec.ts",
-                "**/*.test.ts",
-                "**/*.spec.tsx",
-                "**/*.test.tsx",
-                "**/__tests__/**",
-                "**/node_modules/**"
-              ],
-              "description": "Glob, or globs, of files never read. Replaces the default when given. A non-empty value that omits a default glob makes `tic build` warn.",
-              "anyOf": [
-                {
-                  "type": "string",
-                  "minLength": 1
-                },
-                {
-                  "type": "array",
-                  "items": {
-                    "type": "string",
-                    "minLength": 1
-                  }
-                }
-              ]
+            {
+              "minItems": 1,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
             }
-          },
-          "required": [
-            "glob"
           ],
-          "additionalProperties": false
+          "description": "Folder, or folders, to scan, sub-folders included: paths relative to the config file (./src/services) or tsconfig paths aliases (@app/services)."
+        },
+        "exclude": {
+          "default": [
+            "**/*.spec.ts",
+            "**/*.test.ts",
+            "**/*.spec.tsx",
+            "**/*.test.tsx",
+            "**/__tests__/**",
+            "**/node_modules/**"
+          ],
+          "description": "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.",
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          ]
         }
+      },
+      "required": [
+        "include"
       ],
-      "description": "Which files this bundle reads and parses — decided by path alone, before parsing. `glob` 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. A folder, or a list of folders, is shorthand for { \"glob\": [...] }."
+      "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."
     },
     "className": {
       "anyOf": [
@@ -174,7 +156,7 @@
     }
   },
   "required": [
-    "glob"
+    "paths"
   ],
   "additionalProperties": false
 }

package/tpl/index.cjs

@@ -39,24 +39,13 @@ templates["Bundle.ts.hbs"] = template({"0":function(container,depth0,helpers,par
     + ((stack1 = (lookupProperty(helpers,"join")||(depth0 && lookupProperty(depth0,"join"))||container.hooks.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? lookupProperty(depth0,"named") : depth0),", ",{"name":"join","hash":{},"data":data,"loc":{"start":{"line":5,"column":101},"end":{"line":5,"column":122}}})) != null ? stack1 : "")
     + " }";
 },"5":function(container,depth0,helpers,partials,data) {
-    var stack1, lookupProperty = container.lookupProperty || function(parent, propertyName) {
-        if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
-          return parent[propertyName];
-        }
-        return undefined
-    };
-
-  return "export const registrations: IRegistration[] = [\n"
-    + ((stack1 = lookupProperty(helpers,"each").call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? lookupProperty(depth0,"registrations") : depth0),{"name":"each","hash":{},"fn":container.program(6, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":10,"column":0},"end":{"line":12,"column":9}}})) != null ? stack1 : "")
-    + "];\n";
+    return "_";
 },"6":function(container,depth0,helpers,partials,data) {
     var stack1;
 
-  return "  Registration.fromClass("
+  return "    container.addRegistration(Registration.fromClass("
     + ((stack1 = container.lambda(depth0, depth0)) != null ? stack1 : "")
-    + "),\n";
-},"7":function(container,depth0,helpers,partials,data) {
-    return "export const registrations: IRegistration[] = [];\n";
+    + "));\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, lookupProperty = container.lookupProperty || function(parent, propertyName) {
         if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
@@ -67,13 +56,15 @@ templates["Bundle.ts.hbs"] = template({"0":function(container,depth0,helpers,par
 
   return "// Generated by `tic build`. Do not edit by hand.\n// Paths: "
     + ((stack1 = (lookupProperty(helpers,"join")||(depth0 && lookupProperty(depth0,"join"))||alias2).call(alias1,(depth0 != null ? lookupProperty(depth0,"paths") : depth0),", ",{"name":"join","hash":{},"data":data,"loc":{"start":{"line":2,"column":10},"end":{"line":2,"column":31}}})) != null ? stack1 : "")
-    + "\nimport { type IContainer, type IContainerModule, type IRegistration"
-    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"registrations") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(0, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":3,"column":67},"end":{"line":3,"column":116}}})) != null ? stack1 : "")
+    + "\nimport { type IContainer, type IContainerModule"
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"registrations") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(0, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":3,"column":47},"end":{"line":3,"column":96}}})) != null ? stack1 : "")
     + " } from 'ts-ioc-container';\n"
     + ((stack1 = lookupProperty(helpers,"each").call(alias1,(depth0 != null ? lookupProperty(depth0,"imports") : depth0),{"name":"each","hash":{},"fn":container.program(1, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":4,"column":0},"end":{"line":6,"column":9}}})) != null ? stack1 : "")
-    + "\n"
-    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"registrations") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(5, data, 0),"inverse":container.program(7, data, 0),"data":data,"loc":{"start":{"line":8,"column":0},"end":{"line":16,"column":7}}})) != null ? stack1 : "")
     + "\nexport class "
-    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"name") || (depth0 != null ? lookupProperty(depth0,"name") : depth0)) != null ? helper : alias2),(typeof helper === "function" ? helper.call(alias1,{"name":"name","hash":{},"data":data,"loc":{"start":{"line":18,"column":13},"end":{"line":18,"column":23}}}) : helper))) != null ? stack1 : "")
-    + " implements IContainerModule {\n  applyTo(container: IContainer): void {\n    for (const registration of registrations) container.addRegistration(registration);\n  }\n}\n";
+    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"name") || (depth0 != null ? lookupProperty(depth0,"name") : depth0)) != null ? helper : alias2),(typeof helper === "function" ? helper.call(alias1,{"name":"name","hash":{},"data":data,"loc":{"start":{"line":8,"column":13},"end":{"line":8,"column":23}}}) : helper))) != null ? stack1 : "")
+    + " implements IContainerModule {\n  applyTo("
+    + ((stack1 = lookupProperty(helpers,"unless").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"registrations") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"unless","hash":{},"fn":container.program(5, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":9,"column":10},"end":{"line":9,"column":54}}})) != null ? stack1 : "")
+    + "container: IContainer): void {\n"
+    + ((stack1 = lookupProperty(helpers,"each").call(alias1,(depth0 != null ? lookupProperty(depth0,"registrations") : depth0),{"name":"each","hash":{},"fn":container.program(6, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":10,"column":0},"end":{"line":12,"column":9}}})) != null ? stack1 : "")
+    + "  }\n}\n";
 },"useData":true});

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

@@ -1,30 +1,34 @@
 import { z } from 'zod';
 /**
  * Which files a bundle reads and parses: the first, cheap stage of selection,
- * decided by path alone. `glob` names the folders the files come from; within them
+ * decided by path alone. `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 and `/`-separated.
  */
-export interface GlobSelector {
+export interface PathSelector {
     /**
      * Folder, or folders, to scan recursively: relative to the config file (`./src/services`),
      * or tsconfig `paths` aliases (`@app/services`).
      */
-    glob: string | string[];
-    /** Glob, or globs, of files never read. Replaces {@link DEFAULT_EXCLUDE} when given. */
+    include: string | string[];
+    /**
+     * Glob, or globs, of files never read; one may start with a tsconfig `paths` alias
+     * (`@generated/**`, or `@generated` for the whole folder). Replaces {@link DEFAULT_EXCLUDE} when given.
+     */
     exclude?: string | string[];
 }
-/** A {@link GlobSelector} with its defaults filled in and its globs compiled. */
-export interface ResolvedGlobSelector {
+/** A {@link PathSelector} with its defaults filled in. */
+export interface ResolvedPathSelector {
     /** The folders to scan, as written in the config. */
-    glob: string[];
-    exclude: RegExp[];
+    include: string[];
+    /** As written in the config: an alias in one is resolved, and the glob compiled, once the tsconfig is loaded. */
+    exclude: string[];
 }
 /** Which exports of a file count: both kinds, only named exports, or only the default export. */
 export type ExportKind = 'any' | 'named' | 'default';
 /**
  * Which classes of a parsed file are registered: the second stage of selection,
- * run on the files {@link GlobSelector} let through. A class is selected when
+ * run on the files {@link PathSelector} let through. A class is selected when
  * it is exported, not abstract, and meets every criterion set here; an empty
  * rule selects every exported class.
  */
@@ -70,22 +74,22 @@ export interface BundleConfig {
      */
     name?: string;
     /**
-     * The tsconfig whose `paths` aliases `glob.glob` may name and generated imports are
+     * The tsconfig whose `paths` aliases `paths.include` may name and generated imports are
      * written in, and whose `moduleResolution` sets the import extension. It contributes
-     * nothing else: the files scanned are `glob.glob` alone. Relative to the config file.
+     * nothing else: the files scanned are `paths.include` alone. Relative to the config file.
      * Default `./tsconfig.json`, which may be absent; a tsconfig named here must exist.
      */
     tsconfig?: string;
     /** Extension of generated imports. Inferred from the tsconfig's `moduleResolution` when omitted. */
     importExtension?: string;
     /**
-     * Which files are parsed: the folders in `glob.glob`, minus {@link DEFAULT_EXCLUDE} unless
-     * `exclude` says otherwise. A folder or a list of folders is shorthand for `{ glob }`, as on {@link ClassSelector}.
+     * 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.
      */
-    glob: string | string[] | GlobSelector;
+    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 }`, as on `glob`.
+     * with `@register`. A glob or a list of globs is shorthand for `{ glob }`.
      */
     className?: string | string[] | ClassSelector;
 }
@@ -109,9 +113,9 @@ export interface ResolvedConfig {
         required: boolean;
     };
     importExtension?: string;
-    glob: ResolvedGlobSelector;
+    paths: ResolvedPathSelector;
     className: ResolvedClassSelector;
-    /** Non-fatal problems found while resolving, e.g. a `glob.exclude` that drops a default test glob. */
+    /** Non-fatal problems found while resolving, e.g. a `paths.exclude` that drops a default test glob. */
     warnings: string[];
 }
 /**
@@ -124,10 +128,10 @@ export declare const BUNDLE_CONFIG_SCHEMA: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     tsconfig: z.ZodOptional<z.ZodString>;
     importExtension: z.ZodOptional<z.ZodString>;
-    glob: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
-        glob: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    paths: z.ZodObject<{
+        include: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
         exclude: z.ZodDefault<z.ZodCustom<string | string[], string | string[]>>;
-    }, z.core.$strict>]>;
+    }, z.core.$strict>;
     className: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
         export: z.ZodDefault<z.ZodEnum<{
             default: "default";

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/domain/ImportPaths.d.ts

@@ -23,6 +23,13 @@ export declare class ImportPaths {
      * @throws {NamespaceNotFoundError} when the namespace is neither an existing folder nor an alias of one.
      */
     resolveNamespace(namespace: string, baseDir: string): string;
+    /**
+     * An exclude glob as a glob relative to `baseDir`. One that starts with a `paths` alias
+     * reads from the folder the alias names — `@generated/**` -> `src/.generated/**` — and an
+     * alias naming a folder alone (`@generated`, `@generated/`) covers everything in it. An
+     * alias with several targets yields one glob per target; any other glob is returned as is.
+     */
+    resolveGlob(glob: string, baseDir: string): string[];
     /**
      * The specifier `file` is imported by: its most specific `paths` alias. `undefined` when no
      * alias covers it — a bundle is written to stdout, so it has no location a relative import
@@ -30,6 +37,7 @@ export declare class ImportPaths {
      */
     specifier(file: string): string | undefined;
     private bestAlias;
+    /** `prefixed` skips catch-all aliases (`"*"`), which would claim every plain glob such as `**\/*.spec.ts`. */
     private aliasTargets;
     /** A longer matched target prefix is a more specific alias; an exact file alias beats every wildcard. */
     private matchAlias;

package/typings/features/build/domain/ImportPaths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImportPaths.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/ImportPaths.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAIjC,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAaD;;;GAGG;AACH,qBAAa,WAAW;IAmBpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAnB5B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW;gBAczF,OAAO,EAAE,KAAK,EAAE,EACxB,SAAS,EAAE,MAAM;IAG5B;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAa5D;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK3C,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,YAAY;IAWpB,yGAAyG;IACzG,OAAO,CAAC,UAAU;CAanB"}
+{"version":3,"file":"ImportPaths.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/ImportPaths.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAIjC,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAaD;;;GAGG;AACH,qBAAa,WAAW;IAmBpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAnB5B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW;gBAczF,OAAO,EAAE,KAAK,EAAE,EACxB,SAAS,EAAE,MAAM;IAG5B;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAa5D;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAOpD;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK3C,OAAO,CAAC,SAAS;IAWjB,8GAA8G;IAC9G,OAAO,CAAC,YAAY;IAYpB,yGAAyG;IACzG,OAAO,CAAC,UAAU;CAanB"}

package/typings/features/build/domain/emit.d.ts

@@ -29,7 +29,7 @@ export declare const BUNDLE_PROTOCOL = "Bundle.ts.hbs";
  */
 export declare function bundleView({ name, paths, classes }: EmitInput): BundleView;
 /**
- * Renders the generated bundle — static imports, `registrations`, and the bundle applying them —
+ * Renders the generated bundle — static imports, and the bundle registering each selected class —
  * from its protocol, `protocols/Bundle.ts.hbs`.
  */
 export declare function emitBundle(input: EmitInput): string;

package/typings/features/build/domain/emit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/emit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,CAAC,eAAe,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;CACtD;AAED,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAE9D,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACxE,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,8CAA8C;AAC9C,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAI/C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,SAAS,GAAG,UAAU,CAqB1E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEnD"}
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/emit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,CAAC,eAAe,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;CACtD;AAED,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAE9D,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACxE,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,8CAA8C;AAC9C,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAI/C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,SAAS,GAAG,UAAU,CAsB1E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEnD"}

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

@@ -26,7 +26,7 @@ export interface BuildResult {
     /** The generated bundle. Nothing is written: saving it is the caller's job (`tic build app.bundle.json > src/di/app.bundle.ts`). */
     content: string;
     /**
-     * Non-fatal problems found while building, e.g. a `glob.exclude` that drops a default
+     * Non-fatal problems found while building, e.g. a `paths.exclude` that drops a default
      * test glob or two selected classes passing the same decorator token.
      */
     warnings: string[];

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 GlobSelector, type ResolvedGlobSelector, type ResolvedConfig, type ConfigFormat, } from './features/build/BuildConfig.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 { ticConfigJsonSchema } from './schema/ticConfigSchema.js';
 export { ImportPaths } from './features/build/domain/ImportPaths.js';
 export { loadImportPaths } from './features/build/domain/tsconfig.js';