@ts-ioc-container/bundler 3.1.0 → 5.0.0

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

@@ -5,30 +5,32 @@ interface Alias {
     targets: string[];
 }
 /**
- * Import paths as a project's `tsconfig.json` sees them: writes imports in the
- * form of its `paths` aliases, else its `baseUrl`, where one matches.
+ * Import paths as a project's `tsconfig.json` sees them: resolves namespaces
+ * written as `paths` aliases to folders, and writes imports back in alias form.
  */
 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 `baseUrl`, and the extension
-     * imports need under its `moduleResolution`; `importExtension` overrides the latter.
+     * From a parsed tsconfig's options: its `paths` aliases, 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, 
-    /** Absolute, `/`-separated: non-relative imports resolve against it. */
-    baseUrl?: string | undefined);
+    constructor(aliases: Alias[], extension: string);
     /**
-     * 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`.
+     * The folder a namespace names: a path relative to `baseDir`, or a `paths` alias.
+     *
+     * @throws {NamespaceNotFoundError} when the namespace is neither an existing folder nor an alias of one.
      */
-    specifier(fromFile: string, toFile: string): string;
-    /** `bare` written relative to `baseUrl`, when it is under it; `undefined` otherwise. */
-    private baseUrlSpecifier;
+    resolveNamespace(namespace: 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
+     * could start from.
+     */
+    specifier(file: string): string | undefined;
     private bestAlias;
+    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":"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"}
+{"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"}

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

@@ -2,8 +2,8 @@ import type { DiscoveredClass } from './scan.js';
 export interface EmitInput {
     /** Name of the generated class. */
     name: string;
-    /** Shown in the header: where the output came from. */
-    configPath: string;
+    /** Shown in the header: the folders scanned. */
+    paths: string[];
     classes: (DiscoveredClass & {
         specifier: string;
     })[];
@@ -12,7 +12,7 @@ export interface EmitInput {
 export declare const GENERATED_HEADER = "// Generated by `tic build`";
 /** What `protocols/Bundle.ts.hbs` renders. */
 export interface BundleView {
-    configPath: string;
+    paths: string[];
     name: string;
     imports: {
         specifier: string;
@@ -27,7 +27,7 @@ export declare const BUNDLE_PROTOCOL = "Bundle.ts.hbs";
  * Prepares the data the bundle protocol renders: unique local names, and one import
  * per file in file order.
  */
-export declare function bundleView({ name, configPath, classes }: EmitInput): BundleView;
+export declare function bundleView({ name, paths, classes }: EmitInput): BundleView;
 /**
  * Renders the generated bundle — static imports, `registrations`, and the bundle applying them —
  * from its protocol, `protocols/Bundle.ts.hbs`.

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,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,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,UAAU,EAAE,MAAM,CAAC;IACnB,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,UAAU,EAAE,OAAO,EAAE,EAAE,SAAS,GAAG,UAAU,CAqB/E;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,CAqB1E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEnD"}

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

@@ -29,6 +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` 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;AA2B9G;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,SAA6B,GAChC,eAAe,EAAE,CAmFnB"}
+{"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/domain/tsconfig.d.ts

@@ -1,21 +1,14 @@
-import type { ResolvedConfig } from '../BuildConfig.js';
 import { ImportPaths } from './ImportPaths.js';
-/** What a bundle compiles: the bundle config read as a tsconfig, on top of the tsconfig it extends. */
-export interface CompiledTsconfig {
-    importPaths: ImportPaths;
-    /** Absolute paths of the files compiled. */
-    fileNames: string[];
-    /**
-     * Where the sources live, as tsc sees it: `rootDir`, else the longest common folder of
-     * the non-declaration files compiled, else the config's folder.
-     */
-    rootDir: string;
-}
 /**
- * Compiles a bundle config as a tsconfig, following `extends`: the files it compiles
- * (`include` / `exclude`, as overridden), its `paths` aliases and import extension.
+ * Reads a bundle's tsconfig, following its own `extends`: its `paths` aliases and the
+ * import extension its `moduleResolution` needs; `importExtension` overrides the latter.
+ * Nothing else is taken from it — which files it compiles plays no part in a bundle.
+ * An absent tsconfig that was not named explicitly yields no aliases.
  *
- * @throws {TicConfigError} when a required tsconfig is missing, or the config or a tsconfig it extends is invalid.
+ * @throws {TicConfigError} when a required tsconfig is missing or cannot be parsed.
  */
-export declare function loadTsconfig(config: ResolvedConfig): CompiledTsconfig;
+export declare function loadImportPaths(tsconfig: {
+    file: string;
+    required: boolean;
+}, importExtension?: string): ImportPaths;
 //# sourceMappingURL=tsconfig.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tsconfig.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/tsconfig.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,uGAAuG;AACvG,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AA+BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAerE"}
+{"version":3,"file":"tsconfig.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/tsconfig.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5C;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW,CAapH"}

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

@@ -3,48 +3,42 @@ import { type IRenderService } from '../../../services/HandlebarsRenderService.j
 import { type IFileSystemService } from '../../../services/NodeFileSystemService.js';
 import { type ITicConfigService } from './TicConfigService.js';
 /** What one build does. Paths resolve against the run's working directory. */
-export interface BuildRequest {
+export type BuildRequest = {
+    /** Path of the config file — `*.json`, `*.yaml` or `*.yml` — relative to the working directory. */
+    config: string;
+} | {
     /**
-     * Path of the `*.bundle.json` to build, relative to the working directory. Omitted: build
-     * from the `tsconfig.json` of the package the working directory is in (see `findPackageRoot`),
-     * every setting at its default.
+     * The config as text, e.g. read from stdin: YAML or JSON. Its relative paths resolve
+     * against the working directory, and it must set `name`.
      */
-    config?: string;
-    /** Compare instead of writing: outputs that would change are reported `stale`. */
-    check?: boolean;
-}
-export interface BuildOptions extends BuildRequest {
+    text: string;
+};
+export type BuildOptions = BuildRequest & {
     /** Default `process.cwd()`. */
     cwd?: string;
-}
-/** `written` / `unchanged` after a build; `stale` / `unchanged` after a check. */
-export type OutputStatus = 'written' | 'unchanged' | 'stale';
-export interface OutputResult {
-    /** Absolute path of the generated file. */
-    file: string;
+};
+export interface BuildResult {
+    /** Absolute path of the config file that was built; `undefined` for config text. */
+    config?: string;
     /** Name of the generated class. */
     bundle: string;
-    status: OutputStatus;
     registrations: number;
+    /** 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;
-}
-export interface BuildResult {
-    /** Absolute path of the config that was built. */
-    config: string;
-    output: OutputResult;
     /**
-     * Non-fatal problems found while building, e.g. two selected classes passing the same
-     * decorator token.
+     * Non-fatal problems found while building, e.g. a `glob.exclude` that drops a default
+     * test glob or two selected classes passing the same decorator token.
      */
     warnings: string[];
 }
 export interface IBundleBuilder {
     /**
-     * Generates the bundle a config describes. Nothing is written unless generation succeeds.
+     * Generates the bundle a config describes and returns it; nothing is written.
      *
-     * @throws {TicConfigError} when the config or the tsconfig it extends is missing or invalid.
+     * @throws {TicConfigError} when the config file is missing or unreadable, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
+     * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
      */
-    build(request?: BuildRequest): BuildResult;
+    build(request: BuildRequest): BuildResult;
 }
 export declare const IBundleBuilderKey: SingleToken<IBundleBuilder>;
 export declare class BundleBuilder implements IBundleBuilder {
@@ -54,11 +48,13 @@ export declare class BundleBuilder implements IBundleBuilder {
     private readonly renderer;
     constructor(cwd: string, configs: ITicConfigService, fs: IFileSystemService, renderer: IRenderService);
     /**
-     * @throws {TicConfigError} when the config or the tsconfig it extends is missing or invalid.
+     * @throws {TicConfigError} when the config file is missing or unreadable, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
+     * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
      */
-    build({ config, check }?: BuildRequest): BuildResult;
+    build(request: BuildRequest): BuildResult;
     /**
-     * @throws {TicConfigError} when the config or the tsconfig it extends is missing or invalid.
+     * @throws {TicConfigError} when the tsconfig is missing or invalid, or no tsconfig paths alias covers a selected class's file.
+     * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
      */
     private generate;
 }

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;AAQzG,OAAO,EAAE,KAAK,iBAAiB,EAAuC,MAAM,oBAAoB,CAAC;AAIjG,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAAC;CAC5C;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;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,KAAa,EAAE,GAAE,YAAiB,GAAG,WAAW;IAiBhE;;OAEG;IACH,OAAO,CAAC,QAAQ;CA8BjB"}
+{"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/features/build/services/TicConfigService.d.ts

@@ -1,37 +1,33 @@
 import { SingleToken } from 'ts-ioc-container';
 import { type IFileSystemService } from '../../../services/NodeFileSystemService.js';
 import { type ResolvedConfig } from '../BuildConfig.js';
-/** The tsconfig a build without a config file extends. */
-export declare const TSCONFIG_FILE = "tsconfig.json";
 export interface ITicConfigService {
     /**
-     * Reads and validates a `*.bundle.json`, `*.bundle.yaml` or `*.bundle.yml`.
+     * Reads and validates a config file: JSON for `.json`, YAML for `.yaml` / `.yml`.
      *
-     * @throws {TicConfigError} when the file is missing, cannot be parsed, or does not match the config shape.
+     * @throws {TicConfigError} when the file is missing, has another extension, cannot be parsed, or does not match the config shape.
      */
     load(file: string): ResolvedConfig;
     /**
-     * The configs to build, as absolute paths: the ones named (relative to the working
-     * directory), else every `*.bundle.{json,yaml,yml}` at the root of the package the working
-     * directory is in, else `[undefined]` — one build from that package's `tsconfig.json`
-     * with default settings. Never looks past the package into a workspace root.
+     * Validates config text from somewhere other than a file — stdin, say. It is parsed as YAML,
+     * which JSON is a subset of; its relative paths resolve against `dir`, and it has no file
+     * name to take the bundle name from, so it must set `name`.
      *
-     * @throws {TicConfigError} when none is named and the package has neither a config nor a `tsconfig.json`, or one bundle is described in two formats.
+     * @throws {TicConfigError} when the text cannot be parsed, does not match the config shape, or has no `name`.
      */
-    discover(named: string[]): (string | undefined)[];
+    parse(text: string, dir: string): ResolvedConfig;
 }
 export declare const ITicConfigServiceKey: SingleToken<ITicConfigService>;
 export declare class TicConfigService implements ITicConfigService {
-    private readonly cwd;
     private readonly fs;
-    constructor(cwd: string, fs: IFileSystemService);
+    constructor(fs: IFileSystemService);
     /**
-     * @throws {TicConfigError} when the file is missing, cannot be parsed, or does not match the config shape.
+     * @throws {TicConfigError} when the file is missing, has another extension, cannot be parsed, or does not match the config shape.
      */
     load(file: string): ResolvedConfig;
     /**
-     * @throws {TicConfigError} when none is named and the package has neither a config nor a `tsconfig.json`, or one bundle is described in two formats.
+     * @throws {TicConfigError} when the text cannot be parsed, does not match the config shape, or has no `name`.
      */
-    discover(named: string[]): (string | undefined)[];
+    parse(text: string, dir: string): ResolvedConfig;
 }
 //# sourceMappingURL=TicConfigService.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TicConfigService.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/services/TicConfigService.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIrE,OAAO,EAAE,KAAK,kBAAkB,EAAyB,MAAM,yCAAyC,CAAC;AACzG,OAAO,EAAE,KAAK,cAAc,EAAiB,MAAM,gBAAgB,CAAC;AAGpE,0DAA0D;AAC1D,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;IAEnC;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;CACnD;AAED,eAAO,MAAM,oBAAoB,gCAA0D,CAAC;AAE5F,qBACa,gBAAiB,YAAW,iBAAiB;IAEzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACd,OAAO,CAAC,QAAQ,CAAC,EAAE;gBADR,GAAG,EAAE,MAAM,EACL,EAAE,EAAE,kBAAkB;IAG5E;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAKlC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE;CAQlD"}
+{"version":3,"file":"TicConfigService.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/services/TicConfigService.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,KAAK,kBAAkB,EAAyB,MAAM,yCAAyC,CAAC;AACzG,OAAO,EAA6B,KAAK,cAAc,EAAwB,MAAM,gBAAgB,CAAC;AAEtG,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;IAEnC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC;CAClD;AAED,eAAO,MAAM,oBAAoB,gCAA0D,CAAC;AAE5F,qBACa,gBAAiB,YAAW,iBAAiB;IACT,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,kBAAkB;IAEtF;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAOlC;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc;CAGjD"}

package/typings/index.d.ts

@@ -4,14 +4,13 @@ export { type GlobalConfig, GlobalConfigKey, globalConfig } from './domain/Globa
 export { Application, action, onDefault, DEFAULT_ACTION, commandArgs, parseOptions, validate, type IErrorHandler, IErrorHandlerKey, USAGE, } from './cli.js';
 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, type OutputResult, type OutputStatus, } from './features/build/services/BundleBuilder.js';
-export { TicConfigService, ITicConfigServiceKey, TSCONFIG_FILE, type ITicConfigService, } from './features/build/services/TicConfigService.js';
-export { resolveConfig, BUNDLE_CONFIG_SCHEMA, CONFIG_FILE_SUFFIXES, DEFAULT_EXTENDS, DEFAULT_EXCLUDE, DEFAULT_BUNDLE_NAME, DEFAULT_DECORATORS, toClassName, type BundleConfig, type BundleCompilerOptions, type ClassSelector, type ExportKind, type ResolvedClassSelector, type ResolvedConfig, type TsconfigOverrides, } from './features/build/BuildConfig.js';
-export { findConfigFiles, findPackageRoot } from './features/build/domain/configFiles.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 { ticConfigJsonSchema } from './schema/ticConfigSchema.js';
 export { ImportPaths } from './features/build/domain/ImportPaths.js';
-export { loadTsconfig, type CompiledTsconfig } from './features/build/domain/tsconfig.js';
-export { findClasses, isSourceFile, type DiscoveredClass } from './features/build/domain/scan.js';
+export { loadImportPaths } from './features/build/domain/tsconfig.js';
+export { findClasses, isSourceFile, listSourceFiles, type DiscoveredClass } from './features/build/domain/scan.js';
 export { emitBundle, bundleView, BUNDLE_PROTOCOL, GENERATED_HEADER, type EmitInput, type BundleView, } from './features/build/domain/emit.js';
 export { tokenCollisions } from './features/build/domain/tokenCollisions.js';
 export { globToRegExp } from './features/build/domain/glob.js';
@@ -21,6 +20,6 @@ export { type IOutputService, IOutputServiceKey, StdOutputService } from './serv
 export { type ILogger, ILoggerKey, ConsoleLogger } from './services/ConsoleLogger.js';
 export { type IFileSystemService, IFileSystemServiceKey, NodeFileSystemService, } from './services/NodeFileSystemService.js';
 export { type IRenderService, IRenderServiceKey, HandlebarsRenderService, renderProtocol, } from './services/HandlebarsRenderService.js';
-export { TicError, TicConfigError, MissingCommandError, UnknownCommandError, UnknownActionError, UsageError, StaleBundlesError, } from './exceptions/DomainException.js';
+export { TicError, TicConfigError, NamespaceNotFoundError, MissingCommandError, UnknownCommandError, UnknownActionError, UsageError, } from './exceptions/DomainException.js';
 export { ExceptionHandler } from './exceptions/ExceptionHandler.js';
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1,35 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.findPackageRoot = findPackageRoot;
-exports.findConfigFiles = findConfigFiles;
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
-const DomainException_1 = require("../../../exceptions/DomainException");
-const BuildConfig_1 = require("../BuildConfig");
-function findPackageRoot(dir) {
-    const start = node_path_1.default.resolve(dir);
-    for (let current = start;; current = node_path_1.default.dirname(current)) {
-        if ((0, node_fs_1.existsSync)(node_path_1.default.join(current, 'package.json')))
-            return current;
-        if (node_path_1.default.dirname(current) === current)
-            return start;
-    }
-}
-function findConfigFiles(dir) {
-    const files = (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })
-        .filter((entry) => entry.isFile() && (0, BuildConfig_1.configSuffix)(entry.name) !== undefined)
-        .map((entry) => entry.name)
-        .sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
-    const byStem = new Map();
-    for (const file of files) {
-        const stem = file.slice(0, -(0, BuildConfig_1.configSuffix)(file).length);
-        const other = byStem.get(stem);
-        if (other)
-            throw new DomainException_1.TicConfigError(`${other} and ${file} describe the same bundle; keep one`);
-        byStem.set(stem, file);
-    }
-    return files.map((file) => node_path_1.default.join(dir, file));
-}

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

@@ -1,13 +0,0 @@
-/**
- * The root of the package `dir` belongs to: the nearest folder, `dir` or above, with a
- * `package.json` — the project root in a single-package project, the package in a
- * monorepo. `dir` itself when no folder above has one.
- */
-export declare function findPackageRoot(dir: string): string;
-/**
- * The `*.bundle.{json,yaml,yml}` configs in `dir` (not its sub-folders), sorted by name.
- *
- * @throws {TicConfigError} when one bundle is described in two formats, e.g. `app.bundle.json` and `app.bundle.yaml`.
- */
-export declare function findConfigFiles(dir: string): string[];
-//# sourceMappingURL=configFiles.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"configFiles.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/configFiles.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAarD"}