@ts-ioc-container/bundler 4.0.0 → 5.1.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.paths`
+- Config fields (schema: `tic.schema.json`), flat: `glob` with `glob.glob`
   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,24 @@ 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.paths` may
+  explicitly must exist) only supplies `paths` aliases — which `glob.glob` 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. `glob: { paths, include, exclude }` decides by path
-  which files are read and parsed at all. `paths` (required, non-empty) are the
-  folders scanned — relative to the config file (`./src/services`) or
-  tsconfig aliases (`@app/services`). A file in them must match one of `include`
-  (default: all) and none of `exclude` (default: test files, `__tests__/`,
-  `node_modules/`; a non-empty list replaces it, and the build warns if it drops
-  a default). With file naming conventions, `include` is the speed lever —
-  nothing else is read. Files `tic build` generated are never input.
-- `className: { export, decorators, glob, exclude }`
-  then picks classes of the parsed files; default is every exported,
+- 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
+  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, 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.
+- `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,
   non-abstract class decorated with `@register` (`decorators` defaults to
   `["register"]`; `[]` requires none); positive criteria must all hold — `glob` is one glob
   or a list the class name must match one of — and then `exclude` (one glob or a

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:\n  paths: ["@app/services"]\n' | tic build > src/di/app.bundle.ts
+printf 'name: app\nglob: "@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,22 +80,18 @@ registers. Point your editor at the schema:
 ```json
 {
   "$schema": "./node_modules/@ts-ioc-container/bundler/tic.schema.json",
-  "glob": {
-    "paths": ["@app/services", { "path": "./src/infra", "recursive": false }]
-  }
+  "glob": ["@app/services", "./src/infra"]
 }
 ```
 
 ```yaml
 # yaml-language-server: $schema=./node_modules/@ts-ioc-container/bundler/tic.schema.json
-glob:
-  paths: ['@app/services', ./src/infra]
-  include: ['**/*.service.ts']
+glob: ['@app/services', ./src/infra]
 ```
 
 | Field             | Default                                       | Meaning                                                                                                     |
 | ----------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| `glob`            | — (required, with `paths`)                    | Which files are parsed — see [Selecting files](#selecting-files)                                            |
+| `glob`            | — (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 |
@@ -129,7 +125,7 @@ Each config selects its own files and classes:
 ```yaml
 # prod.bundle.yml: services + adapters, minus dev-only *.dev.ts files
 glob:
-  paths: ['@app/services', ./src/infra]
+  glob: ['@app/services', ./src/infra]
   exclude:
     - '**/*.dev.ts'
     - '**/*.spec.ts'
@@ -142,8 +138,7 @@ glob:
 
 ```yaml
 # dev.bundle.yml: the *.dev.ts logger replaces the production one, dropped by class name
-glob:
-  paths: ['@app/services', ./src/infra]
+glob: ['@app/services', ./src/infra]
 className:
   exclude: JsonLogger
 ```
@@ -159,15 +154,14 @@ A bundle picks its registrations in two stages:
    pass are parsed.
 2. **`className`** — decided per class, on the files stage 1 let through.
 
-Parsing is where the time goes, so when your project names files by convention
-(`user.service.ts`, `user.repository.ts`), say so in `glob.include` and the
-bundler never reads anything else:
+Parsing is where the time goes, so point `glob` at the folders that hold your
+registrations, and `exclude` what they should not contribute:
 
 ```json
 {
   "glob": {
-    "paths": ["@app/services"],
-    "include": ["**/*.service.ts", "**/*.repository.ts"]
+    "glob": "@app/services",
+    "exclude": ["**/*.spec.ts", "**/*.test.ts", "**/__tests__/**", "**/node_modules/**", "**/legacy/**"]
   },
   "className": { "decorators": ["register"] }
 }
@@ -175,21 +169,41 @@ bundler never reads anything else:
 
 ## Selecting files
 
-`paths` are the folders a bundle's files come from, and the only ones: what
-your tsconfig compiles plays no part. Each entry is a folder relative to the
-config file (`./src/services`) or a tsconfig `paths` alias (`@app/services`,
-for a `"@app/*": ["./src/*"]` alias), scanned recursively unless it says
-`{ "path": "...", "recursive": false }`.
+`glob` takes the same shape as [`className`](#selecting-classes):
+`{ glob, exclude }`. `glob.glob` 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`:
+
+```yaml
+glob: ./src/services # = glob: { glob: ./src/services }
+```
+
+```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'
+```
 
-Within them, a file is parsed when it matches **one of** `include` and **none of**
-`exclude`. Globs are relative to the config file and `/`-separated; `**`
-spans folders.
+Within them, a file is parsed unless it matches **one of** `exclude`. Globs are relative to the config file and `/`-separated; `**`
+spans folders. Like a folder in `glob.glob`, 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                                                    |
-| --------- | ----------------------------------------- | ---------------------------------------------------------- |
-| `paths`   | — (required)                              | Folders to scan                                            |
-| `include` | every source file                         | Globs a file must match one of, e.g. `"**/*.service.ts"`   |
-| `exclude` | test files, `__tests__/`, `node_modules/` | Globs of files never read; replaces the default when given |
+| 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; 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:
 
@@ -202,15 +216,15 @@ 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"
   ]
 }
 ```
 
 If it omits a default glob the build warns, since test classes usually carry
 the same `@register` decorators as production ones. `"exclude": []` deliberately
-parses everything, including tests. Giving only `include` keeps the default
-`exclude`, so `**/*.service.ts` still skips `user.service.spec.ts`.
+parses everything, including tests.
 
 ## Selecting classes
 
@@ -252,6 +266,20 @@ 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
+
+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`:
+
+```yaml
+className: '*Service' # = className: { glob: '*Service' }
+```
+
+```yaml
+className: ['*Service', '*Repository'] # = className: { glob: ['*Service', '*Repository'] }
+```
+
 As a safety net, the build warns when two selected classes pass the same
 plain-identifier first argument to a decorator — usually the binding token, as in
 `@repository(IDashboardRepositoryToken)`. The check is syntactic (aliased imports
@@ -313,5 +341,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  paths: ["@app/services"]\n' });
+build({ text: 'name: app\nglob:\n  glob: ["@app/services"]\n' });
 ```

package/cjm/features/build/BuildConfig.js

@@ -30,39 +30,34 @@ const strings = (what, minItems) => zod_1.z
     .custom((value) => Array.isArray(value) && value.length >= minItems && value.every(isNonEmptyString), expected(what))
     .meta({ type: 'array', items: { type: 'string', minLength: 1 }, ...(minItems > 0 && { minItems }) });
 const stringList = () => strings('an array of strings', 0);
-const nonEmptyStringList = () => strings('a non-empty array of strings', 1);
-const globs = () => zod_1.z
-    .custom((value) => isNonEmptyString(value) || (Array.isArray(value) && value.length > 0 && value.every(isNonEmptyString)), expected('a glob or a non-empty array of globs'))
+const globList = (what, minItems) => zod_1.z
+    .custom((value) => isNonEmptyString(value) || (Array.isArray(value) && value.length >= minItems && value.every(isNonEmptyString)), expected(what))
     .meta({
     anyOf: [
         { type: 'string', minLength: 1 },
-        { type: 'array', items: { type: 'string', minLength: 1 }, minItems: 1 },
+        { type: 'array', items: { type: 'string', minLength: 1 }, ...(minItems > 0 && { minItems }) },
     ],
 });
-const toGlobs = (value) => value === undefined ? undefined : (Array.isArray(value) ? value : [value]).map(glob_1.globToRegExp);
-const PATH_SCHEMA = zod_1.z.union([
-    nonEmptyString(),
-    zod_1.z.object({
-        path: nonEmptyString(),
-        recursive: zod_1.z.boolean(expected('a boolean')).default(true),
-    }, expected('a string or an object with "path"')),
-], expected('a string or an object with "path"'));
-const GLOB_SCHEMA = zod_1.z
-    .strictObject({
-    paths: zod_1.z
-        .array(PATH_SCHEMA, expected('a non-empty array'))
-        .min(1, expected('a non-empty array'))
-        .describe('Folders to scan: paths relative to the config file (./src/services) or tsconfig paths aliases (@app/services). Sub-folders are scanned too unless an entry says { "path": "...", "recursive": false }.'),
-    include: nonEmptyStringList()
-        .optional()
-        .describe('Globs a file must match one of, e.g. ["**/*.service.ts", "**/*.repository.ts"]. Default: every source file.'),
-    exclude: stringList()
+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
+        .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('Globs of files never read. Replaces the default when given. A non-empty list that omits a default glob makes `tic build` warn.'),
-}, expected('an object'))
-    .describe('Which files this bundle reads and parses — decided by path alone, before parsing. `paths` are the folders the files come from; within them a file is parsed when it matches one of `include` and none of `exclude`. Globs are relative to the config file. With a file naming convention, `include` keeps every other file unread.');
-const CLASSES_SCHEMA = zod_1.z
-    .strictObject({
+        .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'));
+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": [...] }.');
+const CLASS_OBJECT_SCHEMA = zod_1.z.strictObject({
     export: zod_1.z
         .enum(['any', 'named', 'default'], expected('"any", "named" or "default"'))
         .default('any')
@@ -76,8 +71,17 @@ const CLASSES_SCHEMA = zod_1.z
     exclude: globs()
         .optional()
         .describe('Glob, or globs, the class name must match none of, applied after every other criterion. A plain name is a glob too: ["MockUserRepository", "*Fake"].'),
-}, expected('an object'))
-    .describe('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.');
+}, expected('an object'));
+const CLASSES_SCHEMA = zod_1.z
+    .union([
+    nonEmptyString().describe('One class-name glob, with the default export and decorators: shorthand for { "glob": "..." }.'),
+    zod_1.z
+        .array(nonEmptyString(), expected('a non-empty array'))
+        .min(1, expected('a non-empty array'))
+        .describe('Class-name globs, with the default export and decorators: shorthand for { "glob": [...] }.'),
+    CLASS_OBJECT_SCHEMA,
+], expected('a glob, a non-empty array of globs or an object'))
+    .describe('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": ... }.');
 exports.BUNDLE_CONFIG_SCHEMA = zod_1.z.strictObject({
     $schema: zod_1.z.string().optional(),
     name: zod_1.z
@@ -88,7 +92,7 @@ exports.BUNDLE_CONFIG_SCHEMA = zod_1.z.strictObject({
     tsconfig: nonEmptyString()
         .optional()
         .meta({ default: exports.DEFAULT_TSCONFIG })
-        .describe('The tsconfig whose `paths` aliases glob.paths may name and generated imports are written in, and whose module resolution sets the import extension. It adds no files: the bundle scans glob.paths alone. Relative to the config file. The default may be absent; a tsconfig named here must exist.'),
+        .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.'),
     importExtension: zod_1.z
         .string(expected('a string'))
         .optional()
@@ -117,17 +121,24 @@ 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) {
     return {
-        paths: glob.paths.map((entry) => (typeof entry === 'string' ? { path: entry, recursive: true } : entry)),
-        include: glob.include?.map(glob_1.globToRegExp),
-        exclude: glob.exclude.map(glob_1.globToRegExp),
+        glob: toList(glob.glob),
+        exclude: toList(glob.exclude),
     };
 }
-function toClassSelector(classes) {
-    if (classes === undefined)
+function toClassSelector(className) {
+    if (className === undefined)
         return { export: 'any', decorators: exports.DEFAULT_DECORATORS };
-    const { decorators, glob, exclude, ...rest } = classes;
+    if (typeof className === 'string' || Array.isArray(className)) {
+        return { export: 'any', decorators: exports.DEFAULT_DECORATORS, glob: toGlobs(className) };
+    }
+    const { decorators, glob, exclude, ...rest } = className;
     return {
         ...rest,
         decorators: decorators.length > 0 ? decorators : undefined,
@@ -136,7 +147,7 @@ function toClassSelector(classes) {
     };
 }
 function excludeWarnings(glob) {
-    const { exclude } = glob;
+    const exclude = toList(glob.exclude);
     if (exclude.length === 0)
         return [];
     const missing = exports.DEFAULT_EXCLUDE.filter((glob) => !exclude.includes(glob));
@@ -181,6 +192,7 @@ 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,
@@ -188,8 +200,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(glob),
+        glob: toGlobSelector(globObject),
         className: toClassSelector(className),
-        warnings: excludeWarnings(glob),
+        warnings: excludeWarnings(globObject),
     };
 }

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/scan.js

@@ -46,13 +46,13 @@ const SOURCE_FILE = /\.(tsx?|mts|cts)$/;
 const DECLARATION_FILE = /\.d\.[mc]?tsx?$/;
 const isSourceFile = (file) => SOURCE_FILE.test(file) && !DECLARATION_FILE.test(file);
 exports.isSourceFile = isSourceFile;
-function listSourceFiles(dir, recursive, isExcluded) {
+function listSourceFiles(dir, isExcluded) {
     const files = [];
     const walk = (current) => {
         for (const entry of (0, node_fs_1.readdirSync)(current, { withFileTypes: true })) {
             const full = node_path_1.default.join(current, entry.name);
             if (entry.isDirectory()) {
-                if (recursive && entry.name !== 'node_modules')
+                if (entry.name !== 'node_modules')
                     walk(full);
             }
             else if ((0, exports.isSourceFile)(entry.name) && !isExcluded(full)) {

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

@@ -56,17 +56,15 @@ 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 { include, exclude } = config.glob;
+        const exclude = config.glob.exclude.flatMap((glob) => paths.resolveGlob(glob, config.dir)).map(glob_1.globToRegExp);
         const isExcluded = (file) => {
             const filename = relative(file);
-            if (include && !include.some((glob) => glob.test(filename)))
-                return true;
             return exclude.some((glob) => glob.test(filename));
         };
         const files = new Set();
-        for (const entry of config.glob.paths) {
-            const dir = paths.resolveNamespace(entry.path, config.dir);
-            for (const file of (0, scan_1.listSourceFiles)(dir, entry.recursive, isExcluded))
+        for (const folder of config.glob.glob) {
+            const dir = paths.resolveNamespace(folder, config.dir);
+            for (const file of (0, scan_1.listSourceFiles)(dir, isExcluded))
                 files.add(file);
         }
         const classes = [...files]
@@ -83,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.paths.map((entry) => entry.path),
+            paths: config.glob.glob,
             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": "4.0.0",
+  "version": "5.1.0",
   "description": "Bundles your dependencies into a single container module for ts-ioc-container: the `tic` CLI scans folders (by path or tsconfig alias) and generates one typed bundle that registers every class — `container.useModule(new AppBundle())`.",
   "publishConfig": {
     "access": "public",

package/tic.schema.json

@@ -15,7 +15,7 @@
     },
     "tsconfig": {
       "default": "./tsconfig.json",
-      "description": "The tsconfig whose `paths` aliases glob.paths may name and generated imports are written in, and whose module resolution sets the import extension. It adds no files: the bundle scans glob.paths alone. Relative to the config file. The default may be absent; a tsconfig named here must exist.",
+      "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.",
       "type": "string",
       "minLength": 1
     },
@@ -24,131 +24,153 @@
       "type": "string"
     },
     "glob": {
-      "type": "object",
-      "properties": {
-        "paths": {
+      "anyOf": [
+        {
+          "type": "string",
+          "minLength": 1,
+          "description": "One folder to scan, with the default exclude: shorthand for { \"glob\": [...] }."
+        },
+        {
           "minItems": 1,
           "type": "array",
           "items": {
-            "anyOf": [
-              {
-                "type": "string",
-                "minLength": 1
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "path": {
+            "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
-                  },
-                  "recursive": {
-                    "default": true,
-                    "type": "boolean"
                   }
+                }
+              ],
+              "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
                 },
-                "required": [
-                  "path"
-                ],
-                "additionalProperties": false
-              }
-            ]
-          },
-          "description": "Folders to scan: paths relative to the config file (./src/services) or tsconfig paths aliases (@app/services). Sub-folders are scanned too unless an entry says { \"path\": \"...\", \"recursive\": false }."
-        },
-        "include": {
-          "description": "Globs a file must match one of, e.g. [\"**/*.service.ts\", \"**/*.repository.ts\"]. Default: every source file.",
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              ]
+            }
           },
-          "minItems": 1
-        },
-        "exclude": {
-          "default": [
-            "**/*.spec.ts",
-            "**/*.test.ts",
-            "**/*.spec.tsx",
-            "**/*.test.tsx",
-            "**/__tests__/**",
-            "**/node_modules/**"
+          "required": [
+            "glob"
           ],
-          "description": "Globs of files never read. Replaces the default when given. A non-empty list that omits a default glob makes `tic build` warn.",
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1
-          }
+          "additionalProperties": false
         }
-      },
-      "required": [
-        "paths"
       ],
-      "additionalProperties": false,
-      "description": "Which files this bundle reads and parses — decided by path alone, before parsing. `paths` are the folders the files come from; within them a file is parsed when it matches one of `include` and none of `exclude`. Globs are relative to the config file. With a file naming convention, `include` keeps every other file unread."
+      "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\": [...] }."
     },
     "className": {
-      "type": "object",
-      "properties": {
-        "export": {
-          "default": "any",
-          "description": "Which exports count.",
+      "anyOf": [
+        {
           "type": "string",
-          "enum": [
-            "any",
-            "named",
-            "default"
-          ]
+          "minLength": 1,
+          "description": "One class-name glob, with the default export and decorators: shorthand for { \"glob\": \"...\" }."
         },
-        "decorators": {
-          "default": [
-            "register"
-          ],
-          "description": "The class must carry one of these decorators, recognised by name (e.g. \"register\", or a composed decorator). Default [\"register\"]; [] requires none.",
+        {
+          "minItems": 1,
           "type": "array",
           "items": {
             "type": "string",
             "minLength": 1
-          }
+          },
+          "description": "Class-name globs, with the default export and decorators: shorthand for { \"glob\": [...] }."
         },
-        "glob": {
-          "description": "Glob, or globs, the class name must match one of, e.g. \"*Service\" or [\"*Service\", \"*Repository\"]. An anonymous default export is named after its file.",
-          "anyOf": [
-            {
+        {
+          "type": "object",
+          "properties": {
+            "export": {
+              "default": "any",
+              "description": "Which exports count.",
               "type": "string",
-              "minLength": 1
+              "enum": [
+                "any",
+                "named",
+                "default"
+              ]
             },
-            {
+            "decorators": {
+              "default": [
+                "register"
+              ],
+              "description": "The class must carry one of these decorators, recognised by name (e.g. \"register\", or a composed decorator). Default [\"register\"]; [] requires none.",
               "type": "array",
               "items": {
                 "type": "string",
                 "minLength": 1
-              },
-              "minItems": 1
-            }
-          ]
-        },
-        "exclude": {
-          "description": "Glob, or globs, the class name must match none of, applied after every other criterion. A plain name is a glob too: [\"MockUserRepository\", \"*Fake\"].",
-          "anyOf": [
-            {
-              "type": "string",
-              "minLength": 1
+              }
             },
-            {
-              "type": "array",
-              "items": {
-                "type": "string",
-                "minLength": 1
-              },
-              "minItems": 1
+            "glob": {
+              "description": "Glob, or globs, the class name must match one of, e.g. \"*Service\" or [\"*Service\", \"*Repository\"]. An anonymous default export is named after its file.",
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "minItems": 1
+                }
+              ]
+            },
+            "exclude": {
+              "description": "Glob, or globs, the class name must match none of, applied after every other criterion. A plain name is a glob too: [\"MockUserRepository\", \"*Fake\"].",
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "minItems": 1
+                }
+              ]
             }
-          ]
+          },
+          "additionalProperties": false
         }
-      },
-      "additionalProperties": false,
-      "description": "Which classes of a parsed file are registered. A class is selected when it is exported, not abstract, and meets every criterion set here; by default that is every exported class decorated with @register."
+      ],
+      "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": [

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

@@ -1,24 +1,28 @@
 import { z } from 'zod';
 /**
  * Which files a bundle reads and parses: the first, cheap stage of selection,
- * decided by path alone. `paths` are the folders the files come from; within them
- * a file is parsed when it matches one of `include` and none of `exclude`. Globs
- * are relative to the config file and `/`-separated. With a file naming convention
- * (`*.service.ts`), `include` keeps the bundler from reading anything else.
+ * decided by path alone. `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 and `/`-separated.
  */
 export interface GlobSelector {
-    /** Folders to scan: relative to the config file (`./src/services`), or tsconfig `paths` aliases (`@app/services`). */
-    paths: (string | PathConfig)[];
-    /** Globs a file must match one of, e.g. `**\/*.service.ts`. Default: every source file. */
-    include?: string[];
-    /** Globs of files never read. Replaces {@link DEFAULT_EXCLUDE} when given. */
-    exclude?: string[];
+    /**
+     * 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; 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 {
-    paths: Required<PathConfig>[];
-    include?: RegExp[];
-    exclude: RegExp[];
+    /** The folders to scan, as written in the config. */
+    glob: 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';
@@ -55,12 +59,6 @@ export interface ResolvedClassSelector {
     glob?: RegExp[];
     exclude?: RegExp[];
 }
-export interface PathConfig {
-    /** A folder relative to the config file (`./src/services`) or a tsconfig `paths` alias (`@app/services`). */
-    path: string;
-    /** Scan sub-folders too. Default `true`. */
-    recursive?: boolean;
-}
 /**
  * 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
@@ -76,18 +74,24 @@ export interface BundleConfig {
      */
     name?: string;
     /**
-     * The tsconfig whose `paths` aliases `glob.paths` may name and generated imports are
+     * The tsconfig whose `paths` aliases `glob.glob` may name and generated imports are
      * written in, and whose `moduleResolution` sets the import extension. It contributes
-     * nothing else: the files scanned are `glob.paths` alone. Relative to the config file.
+     * nothing else: the files scanned are `glob.glob` 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.paths`, minus {@link DEFAULT_EXCLUDE} unless `exclude` says otherwise. */
-    glob: GlobSelector;
-    /** Which classes of a parsed file are registered. Default: every exported class. */
-    className?: ClassSelector;
+    /**
+     * 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}.
+     */
+    glob: string | string[] | GlobSelector;
+    /**
+     * 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`.
+     */
+    className?: string | string[] | ClassSelector;
 }
 export declare const DEFAULT_TSCONFIG = "./tsconfig.json";
 /** What `className.decorators` requires when omitted: the library's own `@register`. */
@@ -124,15 +128,11 @@ 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.ZodObject<{
-        paths: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            path: z.ZodString;
-            recursive: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>]>>;
-        include: z.ZodOptional<z.ZodCustom<string[], string[]>>;
-        exclude: z.ZodDefault<z.ZodCustom<string[], string[]>>;
-    }, z.core.$strict>;
-    className: z.ZodOptional<z.ZodObject<{
+    glob: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
+        glob: 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<{
         export: z.ZodDefault<z.ZodEnum<{
             default: "default";
             any: "any";
@@ -141,7 +141,7 @@ export declare const BUNDLE_CONFIG_SCHEMA: z.ZodObject<{
         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>>;
+    }, z.core.$strict>]>>;
 }, z.core.$strict>;
 /**
  * A config file is named `<name>.bundle.json`, `<name>.bundle.yaml` or `<name>.bundle.yml`

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

@@ -29,8 +29,8 @@ export interface DiscoveredClass {
 }
 /** A TypeScript source file the bundler may parse: not a declaration file. */
 export declare const isSourceFile: (file: string) => boolean;
-/** Source files of `dir`, sorted by path so the generated output is stable across machines. */
-export declare function listSourceFiles(dir: string, recursive: boolean, isExcluded: (file: string) => boolean): string[];
+/** Source files of `dir` and its sub-folders, sorted by path so the generated output is stable across machines. */
+export declare function listSourceFiles(dir: string, isExcluded: (file: string) => boolean): string[];
 /**
  * The exported, non-abstract classes of one file that `selector` selects, in
  * declaration order. Syntax only: decorators are recognised by name, not by type.

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

@@ -1 +1 @@
-{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/scan.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CACpD;AAKD,8EAA8E;AAC9E,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OAAiE,CAAC;AAE9G,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,EAAE,CAchH;AA2BD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,SAA6B,GAChC,eAAe,EAAE,CAkFnB"}
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/scan.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CACpD;AAKD,8EAA8E;AAC9E,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OAAiE,CAAC;AAE9G,mHAAmH;AACnH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,EAAE,CAc5F;AA2BD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,SAA6B,GAChC,eAAe,EAAE,CAkFnB"}

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

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 PathConfig, 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 GlobSelector, type ResolvedGlobSelector, 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';