@ts-ioc-container/bundler 3.0.0 → 3.1.0

package/AGENTS.md

@@ -10,8 +10,8 @@ it.
   same program). One config file describes one bundle: `<name>.bundle.json`, or the same in
   YAML as `<name>.bundle.yaml` / `.yml` (an empty YAML file = all defaults)
   (schema: `tic.schema.json`), shaped like a tsconfig — `extends`, `include`,
-  `exclude`, `compilerOptions` — plus the bundler's `output` and `name` at
-  the top level and `compilerOptions.importExtension` / `compilerOptions.classes`;
+  `exclude`, `compilerOptions` — plus the bundler's `baseUrl`, `output` and `name`
+  at the top level and `compilerOptions.importExtension` / `compilerOptions.classes`;
   all optional. `tic build` works on
   the package it is invoked in (nearest `package.json` up from the working
   directory; never a workspace root): it builds every `*.bundle.{json,yaml,yml}` there
@@ -24,9 +24,17 @@ it.
   be absent; one named explicitly must exist): TypeScript parses it with the
   bundler's own fields removed, so the files it compiles (its `include` /
   `exclude` replacing the parent's) are the bundle's file set, and the merged
-  `paths` aliases and module resolution shape the generated imports (most
-  specific alias, else a relative path). Every compiler option but `classes`
+  `paths` aliases, `baseUrl` and module resolution shape the generated imports
+  (most specific alias, else a path relative to `baseUrl` when the file is under
+  it, else a relative path). Every compiler option but `classes`
   and `importExtension` goes to TypeScript, which reports unknown ones.
+  The top-level `baseUrl` (default the config's directory) is the base the
+  config's own `include`, `exclude` and `output` resolve against — so they need
+  not repeat a shared prefix — and is passed to TypeScript as
+  `compilerOptions.baseUrl` unless that is set too; `extends` stays relative to
+  the config file. With `baseUrl` set, an omitted `include` defaults to the whole
+  `baseUrl` folder (`.`); without it, an omitted `include` still inherits the
+  extended tsconfig's.
   `output` defaults to `<root>/<name>.bundle.ts`: root = compiled `rootDir`,
   else the common folder of the files compiled. `name` defaults to the config's
   stem (`production.bundle.json` → `production`), else `base`; the class is

package/README.md

@@ -96,10 +96,11 @@ Every field is optional; `{}` is the zero-config bundle. The tsconfig fields:
 
 The bundler's own fields, at the top level:
 
-| Field    | Default                        | Meaning                                                                                                                 |
-| -------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
-| `output` | `<root>/<name>.bundle.ts`      | The bundle file; `<root>` as in [Zero config](#zero-config)                                                             |
-| `name`   | the config's stem, else `base` | The bundle's name (`production.bundle.json` → `production`): names the default output and the class, `ProductionBundle` |
+| Field     | Default                        | Meaning                                                                                                                 |
+| --------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| `baseUrl` | the config file's directory    | The base `include`, `exclude` and `output` resolve against, so they need not repeat a shared prefix such as `src`; also passed to TypeScript as `compilerOptions.baseUrl` |
+| `output`  | `<root>/<name>.bundle.ts`      | The bundle file; `<root>` as in [Zero config](#zero-config)                                                             |
+| `name`    | the config's stem, else `base` | The bundle's name (`production.bundle.json` → `production`): names the default output and the class, `ProductionBundle` |
 
 and under `compilerOptions`:
 
@@ -112,6 +113,24 @@ An unknown top-level field is an error, so a misspelled or removed option never
 goes unnoticed. Every other compiler option is handed to TypeScript, which
 reports an unknown one (`Unknown compiler option 'pathz'. Did you mean 'paths'?`).
 
+`baseUrl` lets a config read in source terms instead of from the package root:
+
+```json
+{
+  "baseUrl": "src",
+  "output": ".generated/container.bundle.ts",
+  "exclude": [".generated/**", "db/testing/**"]
+}
+```
+
+writes `src/.generated/container.bundle.ts` from everything under `src/` except
+those two folders — with `baseUrl` set, an omitted `include` scans the whole
+`baseUrl` folder. `extends` still resolves against the config file.
+
+Generated imports read like the tsconfig you compile with: a file covered by a
+`paths` alias is imported in that alias form, a file under `baseUrl` in
+`baseUrl` form (`services/Logger`), and anything else relative to the bundle.
+
 ## Several bundles
 
 Need more than one bundle — per environment, per app? Add a config per bundle.
@@ -144,7 +163,8 @@ sits in a folder the other scans.
 The files a bundle scans are the files its config compiles, as `tsc` would see
 them: the extended tsconfig's `files` / `include` / `exclude` (following its own
 `extends`), with this config's `include` and `exclude` replacing the parent's —
-exactly as in a child tsconfig. Globs are relative to the config file.
+exactly as in a child tsconfig. Globs are relative to `baseUrl`, defaulting to
+the config file's directory.
 
 Test files (`*.spec.ts`, `*.test.ts`, their `.tsx` twins and `__tests__/`) and
 `node_modules/` are never scanned, whatever the tsconfig compiles, since test

package/cjm/features/build/BuildConfig.js

@@ -67,13 +67,18 @@ const COMPILER_OPTIONS_SCHEMA = zod_1.z
         .describe('tsconfig `rootDir`: where the default output (<rootDir>/<name>.bundle.ts) goes.'),
 }, expected('an object'))
     .describe("tsconfig `compilerOptions`, plus the bundler's own `importExtension` and `classes`. Every other option is handed to TypeScript on top of the extended tsconfig's, which validates it.");
-const tsconfigGlobs = (field) => stringList().optional().describe(`tsconfig \`${field}\`: replaces the extended tsconfig's. Relative to this file.`);
+const tsconfigGlobs = (field, note = '') => stringList()
+    .optional()
+    .describe(`tsconfig \`${field}\`: replaces the extended tsconfig's. Relative to \`baseUrl\`.${note}`);
 exports.BUNDLE_CONFIG_SCHEMA = zod_1.z.strictObject({
     $schema: zod_1.z.string().optional(),
     extends: nonEmptyString()
         .optional()
         .meta({ default: exports.DEFAULT_EXTENDS })
         .describe("The tsconfig this bundle extends, as a tsconfig's own `extends`: its file set, `paths` aliases and module resolution apply unless this file overrides them. Relative to this file. The default may be absent; a tsconfig named here must exist."),
+    baseUrl: nonEmptyString()
+        .optional()
+        .describe("The base folder this config's relative `include`, `exclude` and `output` resolve against, so they need not repeat a shared prefix such as `src`. Relative to this file; default this file's directory. Also handed to TypeScript as `compilerOptions.baseUrl` (unless that is set too), so generated imports use it."),
     output: nonEmptyString()
         .optional()
         .describe('The bundle file (convention: *.bundle.ts). Default `<root>/<name>.bundle.ts`: <root> is the compiled rootDir, else the common folder of the files compiled.'),
@@ -82,7 +87,7 @@ exports.BUNDLE_CONFIG_SCHEMA = zod_1.z.strictObject({
         .regex(BUNDLE_NAME, expected('letters, digits, "-" or "_", starting with a letter'))
         .optional()
         .describe('The bundle\'s name: letters, digits, "-" and "_", starting with a letter. Default: this file\'s stem (production.bundle.json → production), else "base". It names the default output (production.bundle.ts) and the generated IContainerModule class (ProductionBundle).'),
-    include: tsconfigGlobs('include'),
+    include: tsconfigGlobs('include', ' When `baseUrl` is set and this is omitted, the whole `baseUrl` folder (`.`) is scanned.'),
     exclude: tsconfigGlobs('exclude'),
     compilerOptions: COMPILER_OPTIONS_SCHEMA.optional(),
 }, expected('an object'));
@@ -128,18 +133,25 @@ function resolveConfig(content, file) {
     const result = exports.BUNDLE_CONFIG_SCHEMA.safeParse(content);
     if (!result.success)
         throw new DomainException_1.TicConfigError(formatIssues(result.error));
-    const { output, name, extends: tsconfig, include, exclude, compilerOptions = {} } = result.data;
+    const { output, name, baseUrl, extends: tsconfig, include, exclude, compilerOptions = {} } = result.data;
     const { importExtension, classes, ...tsCompilerOptions } = compilerOptions;
     const dir = node_path_1.default.dirname(file);
+    const base = baseUrl === undefined ? dir : node_path_1.default.resolve(dir, baseUrl);
+    const includeGlobs = include ?? (baseUrl === undefined ? undefined : ['.']);
+    const rebase = (globs) => globs?.map((glob) => (node_path_1.default.isAbsolute(glob) ? glob : (0, glob_1.toPosix)(node_path_1.default.relative(dir, node_path_1.default.resolve(base, glob))) || '.'));
     const bundleName = name ?? configStem(file) ?? exports.DEFAULT_BUNDLE_NAME;
     return {
         file,
         dir,
-        output: output === undefined ? undefined : node_path_1.default.resolve(dir, output),
+        output: output === undefined ? undefined : node_path_1.default.resolve(base, output),
         name: bundleName,
         className: toClassName(bundleName),
         tsconfig: { file: node_path_1.default.resolve(dir, tsconfig ?? exports.DEFAULT_EXTENDS), required: tsconfig !== undefined },
-        overrides: { include, exclude, compilerOptions: tsCompilerOptions },
+        overrides: {
+            include: rebase(includeGlobs),
+            exclude: rebase(exclude),
+            compilerOptions: baseUrl === undefined ? tsCompilerOptions : { baseUrl, ...tsCompilerOptions },
+        },
         importExtension,
         classes: toClassSelector(classes),
     };

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

@@ -48,6 +48,7 @@ function splitWildcard(pattern) {
 class ImportPaths {
     aliases;
     extension;
+    baseUrl;
     static fromOptions(options, tsconfigFile, importExtension) {
         const { paths = {}, baseUrl, pathsBasePath, moduleResolution } = options;
         const base = baseUrl ?? (typeof pathsBasePath === 'string' ? pathsBasePath : node_path_1.default.dirname(tsconfigFile));
@@ -56,11 +57,12 @@ class ImportPaths {
             targets: targets.map((target) => (0, glob_1.toPosix)(node_path_1.default.resolve(base, target))),
         }));
         const nodeEsm = moduleResolution === ts.ModuleResolutionKind.Node16 || moduleResolution === ts.ModuleResolutionKind.NodeNext;
-        return new ImportPaths(aliases, importExtension ?? (nodeEsm ? '.js' : ''));
+        return new ImportPaths(aliases, importExtension ?? (nodeEsm ? '.js' : ''), baseUrl === undefined ? undefined : (0, glob_1.toPosix)(baseUrl));
     }
-    constructor(aliases, extension) {
+    constructor(aliases, extension, baseUrl) {
         this.aliases = aliases;
         this.extension = extension;
+        this.baseUrl = baseUrl;
     }
     specifier(fromFile, toFile) {
         const target = (0, glob_1.toPosix)(toFile);
@@ -68,9 +70,18 @@ class ImportPaths {
         const best = this.bestAlias(target, bare);
         if (best)
             return best.spec;
+        const fromBaseUrl = this.baseUrlSpecifier(bare);
+        if (fromBaseUrl)
+            return `${fromBaseUrl}${this.extension}`;
         const relative = (0, glob_1.toPosix)(node_path_1.default.relative(node_path_1.default.dirname(fromFile), bare));
         return `${relative.startsWith('.') ? relative : `./${relative}`}${this.extension}`;
     }
+    baseUrlSpecifier(bare) {
+        if (!this.baseUrl)
+            return undefined;
+        const prefix = this.baseUrl.endsWith('/') ? this.baseUrl : `${this.baseUrl}/`;
+        return bare.startsWith(prefix) ? bare.slice(prefix.length) : undefined;
+    }
     bestAlias(target, bare) {
         let best;
         for (const { pattern, targets } of this.aliases) {

package/cjm/schema/ticConfigSchema.js

@@ -14,7 +14,7 @@ function ticConfigJsonSchema() {
         $schema,
         $id: 'https://github.com/IgorBabkin/ts-ioc-container/tree/main/packages/bundler/tic.schema.json',
         title: '*.bundle.json / *.bundle.yaml',
-        description: "One bundle generated by `tic build` (@ts-ioc-container/bundler). `tic build` builds every `*.bundle.json` / `*.bundle.yaml` / `*.bundle.yml` at the root of the package it is invoked in, or — with none — one bundle from that package's tsconfig.json with every setting at its default. Relative paths resolve against this file's directory.",
+        description: "One bundle generated by `tic build` (@ts-ioc-container/bundler). `tic build` builds every `*.bundle.json` / `*.bundle.yaml` / `*.bundle.yml` at the root of the package it is invoked in, or — with none — one bundle from that package's tsconfig.json with every setting at its default. `extends` and `baseUrl` resolve against this file's directory; `include`, `exclude` and `output` resolve against `baseUrl`, defaulting to this file's directory.",
         ...rest,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ts-ioc-container/bundler",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Bundles your dependencies into a single container module for ts-ioc-container: the `tic` CLI scans folders (by path or tsconfig alias) and generates one typed bundle that registers every class — `container.useModule(new AppBundle())`.",
   "publishConfig": {
     "access": "public",

package/tic.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://github.com/IgorBabkin/ts-ioc-container/tree/main/packages/bundler/tic.schema.json",
   "title": "*.bundle.json / *.bundle.yaml",
-  "description": "One bundle generated by `tic build` (@ts-ioc-container/bundler). `tic build` builds every `*.bundle.json` / `*.bundle.yaml` / `*.bundle.yml` at the root of the package it is invoked in, or — with none — one bundle from that package's tsconfig.json with every setting at its default. Relative paths resolve against this file's directory.",
+  "description": "One bundle generated by `tic build` (@ts-ioc-container/bundler). `tic build` builds every `*.bundle.json` / `*.bundle.yaml` / `*.bundle.yml` at the root of the package it is invoked in, or — with none — one bundle from that package's tsconfig.json with every setting at its default. `extends` and `baseUrl` resolve against this file's directory; `include`, `exclude` and `output` resolve against `baseUrl`, defaulting to this file's directory.",
   "type": "object",
   "properties": {
     "$schema": {
@@ -14,6 +14,11 @@
       "type": "string",
       "minLength": 1
     },
+    "baseUrl": {
+      "description": "The base folder this config's relative `include`, `exclude` and `output` resolve against, so they need not repeat a shared prefix such as `src`. Relative to this file; default this file's directory. Also handed to TypeScript as `compilerOptions.baseUrl` (unless that is set too), so generated imports use it.",
+      "type": "string",
+      "minLength": 1
+    },
     "output": {
       "description": "The bundle file (convention: *.bundle.ts). Default `<root>/<name>.bundle.ts`: <root> is the compiled rootDir, else the common folder of the files compiled.",
       "type": "string",
@@ -25,7 +30,7 @@
       "pattern": "^[A-Za-z][\\w-]*$"
     },
     "include": {
-      "description": "tsconfig `include`: replaces the extended tsconfig's. Relative to this file.",
+      "description": "tsconfig `include`: replaces the extended tsconfig's. Relative to `baseUrl`. When `baseUrl` is set and this is omitted, the whole `baseUrl` folder (`.`) is scanned.",
       "type": "array",
       "items": {
         "type": "string",
@@ -33,7 +38,7 @@
       }
     },
     "exclude": {
-      "description": "tsconfig `exclude`: replaces the extended tsconfig's. Relative to this file.",
+      "description": "tsconfig `exclude`: replaces the extended tsconfig's. Relative to `baseUrl`.",
       "type": "array",
       "items": {
         "type": "string",
@@ -54,10 +59,16 @@
               "default": "any",
               "description": "Which exports count.",
               "type": "string",
-              "enum": ["any", "named", "default"]
+              "enum": [
+                "any",
+                "named",
+                "default"
+              ]
             },
             "decorators": {
-              "default": ["register"],
+              "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": {

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

@@ -71,9 +71,16 @@ export interface BundleConfig {
      * file. Default `./tsconfig.json`, which may be absent; a tsconfig named here must exist.
      */
     extends?: string;
-    /** tsconfig `include`: replaces the extended tsconfig's. */
+    /**
+     * The base folder this config's relative `include`, `exclude` and `output` resolve against,
+     * so they need not repeat a shared prefix such as `src`. Relative to the config file; default
+     * the config file's directory. It is also handed to TypeScript as `compilerOptions.baseUrl`
+     * (unless that is set too), so the generated imports use it as well.
+     */
+    baseUrl?: string;
+    /** tsconfig `include`: replaces the extended tsconfig's. Relative to `baseUrl`. */
     include?: string[];
-    /** tsconfig `exclude`: replaces the extended tsconfig's. {@link DEFAULT_EXCLUDE} applies regardless. */
+    /** tsconfig `exclude`: replaces the extended tsconfig's. Relative to `baseUrl`. {@link DEFAULT_EXCLUDE} applies regardless. */
     exclude?: string[];
     compilerOptions?: BundleCompilerOptions;
 }
@@ -120,6 +127,7 @@ export interface ResolvedConfig {
 export declare const BUNDLE_CONFIG_SCHEMA: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
     extends: z.ZodOptional<z.ZodString>;
+    baseUrl: z.ZodOptional<z.ZodString>;
     output: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
     include: z.ZodOptional<z.ZodCustom<string[], string[]>>;
@@ -151,7 +159,8 @@ export declare const configSuffix: (file: string) => string | undefined;
 /** The generated class for a bundle name: `production` -> `ProductionBundle`, `my-app_v2` -> `MyAppV2Bundle`. */
 export declare function toClassName(name: string): string;
 /**
- * Validates parsed `*.bundle.json` content and resolves its paths against `file`'s directory.
+ * Validates parsed `*.bundle.json` content and resolves its paths against `file`'s
+ * directory, or its `baseUrl` for `include` / `exclude` / `output`.
  *
  * @throws {TicConfigError} when the content does not match the config shape; the message names the field.
  */

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

@@ -6,19 +6,28 @@ interface Alias {
 }
 /**
  * Import paths as a project's `tsconfig.json` sees them: writes imports in the
- * form of its `paths` aliases where one matches.
+ * form of its `paths` aliases, else its `baseUrl`, where one matches.
  */
 export declare class ImportPaths {
     private readonly aliases;
     readonly extension: string;
+    /** Absolute, `/`-separated: non-relative imports resolve against it. */
+    private readonly baseUrl?;
     /**
-     * From a parsed tsconfig's options: its `paths` aliases, and the extension imports need
-     * under its `moduleResolution`; `importExtension` overrides the latter.
+     * From a parsed tsconfig's options: its `paths` aliases and `baseUrl`, and the extension
+     * imports need under its `moduleResolution`; `importExtension` overrides the latter.
      */
     static fromOptions(options: ts.CompilerOptions, tsconfigFile: string, importExtension?: string): ImportPaths;
-    constructor(aliases: Alias[], extension: string);
-    /** The specifier `fromFile` imports `toFile` by: its most specific alias, else a relative path. */
+    constructor(aliases: Alias[], extension: string, 
+    /** Absolute, `/`-separated: non-relative imports resolve against it. */
+    baseUrl?: string | undefined);
+    /**
+     * The specifier `fromFile` imports `toFile` by: its most specific `paths` alias, else a
+     * path relative to `baseUrl` when the file is under it, else a path relative to `fromFile`.
+     */
     specifier(fromFile: string, toFile: string): string;
+    /** `bare` written relative to `baseUrl`, when it is under it; `undefined` otherwise. */
+    private baseUrlSpecifier;
     private bestAlias;
     /** 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":"AACA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD;;;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,mGAAmG;IACnG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAUnD,OAAO,CAAC,SAAS;IAWjB,yGAAyG;IACzG,OAAO,CAAC,UAAU;CAanB"}
+{"version":3,"file":"ImportPaths.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/ImportPaths.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD;;;GAGG;AACH,qBAAa,WAAW;IAuBpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAzB3B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW;gBAkBzF,OAAO,EAAE,KAAK,EAAE,EACxB,SAAS,EAAE,MAAM;IAC1B,wEAAwE;IACvD,OAAO,CAAC,EAAE,MAAM,YAAA;IAGnC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAanD,wFAAwF;IACxF,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,SAAS;IAWjB,yGAAyG;IACzG,OAAO,CAAC,UAAU;CAanB"}