@ts-ioc-container/bundler 3.0.0 → 4.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../lib/cli/Application.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,UAAU,EAAU,MAAM,kBAAkB,CAAC;AA6BpG;;;;;GAKG;AACH,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAN/B,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,GAAG,WAAW;IAIpD,OAAO;IAKP,mFAAmF;IACnF,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;CAmB/B"}
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../lib/cli/Application.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,UAAU,EAAU,MAAM,kBAAkB,CAAC;AA+BpG;;;;;GAKG;AACH,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAN/B,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,GAAG,WAAW;IAIpD,OAAO;IAKP,mFAAmF;IACnF,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;CAsB/B"}

package/typings/cli/options.d.ts

@@ -9,9 +9,15 @@ export declare const commandArgs: ({ args }: InjectOptions) => string[];
  * from the first flag onwards belongs to the action — what precedes it is the
  * command and the action name.
  *
+ * With `positionals`, the default action of a command takes arguments too: everything
+ * after the command is parsed, and the words that are not flags or their values come
+ * back as `positionals` (`tic build app.bundle.json`).
+ *
  * @throws {UsageError} when a flag is unknown or a flag that takes a value has none.
  */
-export declare const parseOptions: (options: OptionsConfig) => (argv: string[]) => Record<string, unknown>;
+export declare const parseOptions: (options: OptionsConfig, { positionals }?: {
+    positionals?: boolean;
+}) => (argv: string[]) => Record<string, unknown>;
 /**
  * Mapper that validates a loosely-typed value — parsed options in practice —
  * against a schema and narrows it to the schema's output type.

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

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../lib/cli/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAGtC,KAAK,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;AAE7D,4FAA4F;AAC5F,eAAO,MAAM,WAAW,GAAI,UAAe,aAAa,KAAG,MAAM,EAAsB,CAAC;AAExF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACtB,SAAS,aAAa,MACtB,MAAM,MAAM,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAOvC,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAClB,CAAC,SAAS,OAAO,EAAE,QAAQ,CAAC,MAC5B,OAAO,OAAO,KAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAI3B,CAAC"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../lib/cli/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAGtC,KAAK,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;AAE7D,4FAA4F;AAC5F,eAAO,MAAM,WAAW,GAAI,UAAe,aAAa,KAAG,MAAM,EAAsB,CAAC;AAExF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACtB,SAAS,aAAa,EAAE,kBAAyB;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,MAC/E,MAAM,MAAM,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CASvC,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAClB,CAAC,SAAS,OAAO,EAAE,QAAQ,CAAC,MAC5B,OAAO,OAAO,KAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAI3B,CAAC"}

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

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

package/typings/domain/CliIo.d.ts

@@ -4,6 +4,8 @@ export interface CliIo {
     cwd: string;
     stdout: (line: string) => void;
     stderr: (line: string) => void;
+    /** All of standard input, or `undefined` when nothing is piped in (a terminal, or no stdin at all). */
+    stdin?: () => string | undefined;
 }
 export declare const CliIoKey: SingleToken<CliIo>;
 export declare const processIo: () => CliIo;

package/typings/domain/CliIo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CliIo.d.ts","sourceRoot":"","sources":["../../lib/domain/CliIo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,6FAA6F;AAC7F,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,QAAQ,oBAAkC,CAAC;AAExD,eAAO,MAAM,SAAS,QAAO,KAA6E,CAAC"}
+{"version":3,"file":"CliIo.d.ts","sourceRoot":"","sources":["../../lib/domain/CliIo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,6FAA6F;AAC7F,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,uGAAuG;IACvG,KAAK,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,QAAQ,oBAAkC,CAAC;AAExD,eAAO,MAAM,SAAS,QAAO,KAK3B,CAAC"}

package/typings/domain/GlobalConfig.d.ts

@@ -1,7 +1,7 @@
 import { type InjectFn, SingleToken } from 'ts-ioc-container';
 /** Settings every service shares for one run: the process-level context the CLI was started in. */
 export type GlobalConfig = {
-    /** Directory relative paths (`--config`, `build({ config })`) resolve against. */
+    /** Directory a relative `<config>` path (and `build({ config })`) resolves against. */
     cwd: string;
 };
 export declare const GlobalConfigKey: SingleToken<GlobalConfig>;

package/typings/domain/GlobalConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalConfig.d.ts","sourceRoot":"","sources":["../../lib/domain/GlobalConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE9D,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG;IACzB,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,eAAe,2BAAgD,CAAC;AAE7E,qFAAqF;AACrF,eAAO,MAAM,YAAY,GACtB,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,CAAC,KAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAE3B,CAAC"}
+{"version":3,"file":"GlobalConfig.d.ts","sourceRoot":"","sources":["../../lib/domain/GlobalConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE9D,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG;IACzB,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,eAAe,2BAAgD,CAAC;AAE7E,qFAAqF;AACrF,eAAO,MAAM,YAAY,GACtB,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,CAAC,KAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAE3B,CAAC"}

package/typings/exceptions/DomainException.d.ts

@@ -10,6 +10,10 @@ export declare abstract class TicError extends Error {
 export declare class TicConfigError extends TicError {
     constructor(message: string);
 }
+/** A namespace is neither an existing folder nor a `tsconfig.json` `paths` alias of one. */
+export declare class NamespaceNotFoundError extends TicError {
+    constructor(message: string);
+}
 /** The command line names no command. */
 export declare class MissingCommandError extends TicError {
     constructor(usage: string);
@@ -26,8 +30,4 @@ export declare class UnknownActionError extends TicError {
 export declare class UsageError extends TicError {
     constructor(message: string);
 }
-/** `tic build --check` found generated bundles that differ from what a build would write. */
-export declare class StaleBundlesError extends TicError {
-    constructor(count: number);
-}
 //# sourceMappingURL=DomainException.d.ts.map

package/typings/exceptions/DomainException.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DomainException.d.ts","sourceRoot":"","sources":["../../lib/exceptions/DomainException.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAExC,QAAQ,CAAC,IAAI,EAAE,MAAM;IADvB,SAAS,aACE,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED,8FAA8F;AAC9F,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM;CAG5B;AAED,yCAAyC;AACzC,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,KAAK,EAAE,MAAM;CAG1B;AAED,wEAAwE;AACxE,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM;CAG5B;AAED,kFAAkF;AAClF,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAG5C;AAED,uFAAuF;AACvF,qBAAa,UAAW,SAAQ,QAAQ;gBAC1B,OAAO,EAAE,MAAM;CAG5B;AAED,6FAA6F;AAC7F,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,KAAK,EAAE,MAAM;CAG1B"}
+{"version":3,"file":"DomainException.d.ts","sourceRoot":"","sources":["../../lib/exceptions/DomainException.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAExC,QAAQ,CAAC,IAAI,EAAE,MAAM;IADvB,SAAS,aACE,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED,8FAA8F;AAC9F,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM;CAG5B;AAED,4FAA4F;AAC5F,qBAAa,sBAAuB,SAAQ,QAAQ;gBACtC,OAAO,EAAE,MAAM;CAG5B;AAED,yCAAyC;AACzC,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,KAAK,EAAE,MAAM;CAG1B;AAED,wEAAwE;AACxE,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM;CAG5B;AAED,kFAAkF;AAClF,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAG5C;AAED,uFAAuF;AACvF,qBAAa,UAAW,SAAQ,QAAQ;gBAC1B,OAAO,EAAE,MAAM;CAG5B"}

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

@@ -1,10 +1,32 @@
 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.
+ */
+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[];
+}
+/** A {@link GlobSelector} with its defaults filled in and its globs compiled. */
+export interface ResolvedGlobSelector {
+    paths: Required<PathConfig>[];
+    include?: RegExp[];
+    exclude: RegExp[];
+}
 /** Which exports of a file count: both kinds, only named exports, or only the default export. */
 export type ExportKind = 'any' | 'named' | 'default';
 /**
- * Which classes of a parsed file are registered. A class is selected when it is
- * exported, not abstract, and meets every criterion set here; an empty rule
- * selects every exported class.
+ * Which classes of a parsed file are registered: the second stage of selection,
+ * run on the files {@link GlobSelector} let through. A class is selected when
+ * it is exported, not abstract, and meets every criterion set here; an empty
+ * rule selects every exported class.
  */
 export interface ClassSelector {
     /** Default `any`. */
@@ -14,146 +36,137 @@ export interface ClassSelector {
      * composed one). Default {@link DEFAULT_DECORATORS}; `[]` requires none.
      */
     decorators?: string[];
-    /** A glob the class name must match, e.g. `*Service`. An anonymous default export is named after its file. */
-    name?: string;
     /**
-     * Class names to drop after selection, e.g. one test double sitting next to the
-     * real registration in the same file.
+     * Globs the class name must match one of, e.g. `*Service` or `["*Service", "*Repository"]`.
+     * An anonymous default export is named after its file.
      */
-    excludeClasses?: string[];
-    /** A glob the class name must NOT match, e.g. `*Mock`. An anonymous default export is named after its file. */
-    excludeName?: string;
+    glob?: string | string[];
+    /**
+     * Globs the class name must match none of, applied after every other criterion. A plain
+     * name is a glob too, so `["MockUserRepository", "*Fake"]` drops one class by name and a
+     * family by pattern.
+     */
+    exclude?: string | string[];
 }
 /** A {@link ClassSelector} with its defaults filled in and its globs compiled. */
 export interface ResolvedClassSelector {
     export: ExportKind;
     decorators?: string[];
-    name?: RegExp;
-    excludeClasses?: string[];
-    excludeName?: RegExp;
+    glob?: RegExp[];
+    exclude?: RegExp[];
 }
-/**
- * `compilerOptions` of a bundle config: the tsconfig's own options plus the bundler's.
- * `importExtension` and `classes` are read by `tic build`; every other option (`paths`,
- * `baseUrl`, `rootDir`, `moduleResolution`, ...) is handed to TypeScript on top of the
- * extended tsconfig, exactly as a child tsconfig's would be.
- */
-export interface BundleCompilerOptions {
-    /** Extension of generated imports. Inferred from the tsconfig's `moduleResolution` when omitted. */
-    importExtension?: string;
-    /** Which classes of a scanned file are registered. Default: every exported class decorated with `@register`. */
-    classes?: ClassSelector;
-    [option: string]: unknown;
+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;
 }
 /**
- * The shape of `*.bundle.json`: one bundle, written as a tsconfig. `extends`, `include`,
- * `exclude` and `compilerOptions` mean what they mean in a tsconfig, so the files the bundle
- * scans are the files this config would compile; `output`, `name` and the bundler's
- * own compiler options describe the generated module. A project that needs several bundles
- * keeps one config file per bundle.
+ * A bundle config file: one bundle, described explicitly — the folders it scans and the
+ * classes it registers. `tic build <config>` prints the bundle to stdout; where it is
+ * saved is the caller's choice (`tic build app.bundle.json > src/di/app.bundle.ts`).
  */
 export interface BundleConfig {
     $schema?: string;
-    /**
-     * The generated file, relative to the config file. Default `<root>/<name>.bundle.ts`:
-     * `<root>` is the compiled `rootDir`, else the common folder of the files compiled.
-     */
-    output?: string;
     /**
      * The bundle's name: letters, digits, `-` and `_`, starting with a letter. Default: the
-     * config file's stem (`production.bundle.json` -> `production`), else {@link DEFAULT_BUNDLE_NAME}.
-     * It names the default output (`production.bundle.ts`) and the generated class,
-     * an `IContainerModule` (`ProductionBundle`, see {@link toClassName}).
+     * config file's stem (`production.bundle.json` -> `production`); required for a config
+     * file named otherwise. It names the generated class, an `IContainerModule`
+     * (`ProductionBundle`, see {@link toClassName}).
      */
     name?: string;
     /**
-     * The tsconfig this config extends, as a tsconfig's own `extends`. Relative to the config
-     * file. Default `./tsconfig.json`, which may be absent; a tsconfig named here must exist.
+     * The tsconfig whose `paths` aliases `glob.paths` 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.
+     * Default `./tsconfig.json`, which may be absent; a tsconfig named here must exist.
      */
-    extends?: string;
-    /** tsconfig `include`: replaces the extended tsconfig's. */
-    include?: string[];
-    /** tsconfig `exclude`: replaces the extended tsconfig's. {@link DEFAULT_EXCLUDE} applies regardless. */
-    exclude?: string[];
-    compilerOptions?: BundleCompilerOptions;
+    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;
 }
-export declare const DEFAULT_EXTENDS = "./tsconfig.json";
-/** The bundle name when the config file gives none, e.g. building from `tsconfig.json` alone. */
-export declare const DEFAULT_BUNDLE_NAME = "base";
-/** What `classes.decorators` requires when omitted: the library's own `@register`. */
+export declare const DEFAULT_TSCONFIG = "./tsconfig.json";
+/** What `className.decorators` requires when omitted: the library's own `@register`. */
 export declare const DEFAULT_DECORATORS: string[];
-/** Files never scanned, whatever the tsconfig compiles: tests, and anything under `node_modules`. */
 export declare const DEFAULT_EXCLUDE: string[];
-/** The tsconfig part of a bundle config, handed to TypeScript as a tsconfig of its own. */
-export interface TsconfigOverrides {
-    include?: string[];
-    exclude?: string[];
-    /** `compilerOptions` without the bundler's own options. */
-    compilerOptions: Record<string, unknown>;
-}
 /** A {@link BundleConfig} whose defaults are filled in and whose paths are absolute. */
 export interface ResolvedConfig {
     /** The config file itself. */
     file: string;
+    /** Its folder: what the config's relative paths resolve against. */
     dir: string;
-    /** `undefined`: derived from what is compiled at build time (see {@link BundleConfig.output}). */
-    output?: string;
     /** The bundle name: `production` for `production.bundle.json`. */
     name: string;
     /** The generated class: `ProductionBundle`. */
-    className: string;
-    /** The extended tsconfig; `required` when the config names it, so it must exist. */
+    bundleClassName: string;
+    /** The tsconfig of `paths` aliases; `required` when the config names it, so it must exist. */
     tsconfig: {
         file: string;
         required: boolean;
     };
-    /** What the config sets on top of {@link tsconfig}. */
-    overrides: TsconfigOverrides;
     importExtension?: string;
-    classes: ResolvedClassSelector;
+    glob: ResolvedGlobSelector;
+    className: ResolvedClassSelector;
+    /** Non-fatal problems found while resolving, e.g. a `glob.exclude` that drops a default test glob. */
+    warnings: string[];
 }
 /**
- * One `*.bundle.json` / `*.bundle.yaml`: a tsconfig with the bundler's fields. The published
- * `tic.schema.json` is generated from it (`ticConfigJsonSchema`), so the schema editors
- * validate against cannot drift from what `tic build` accepts.
+ * One `*.bundle.json` / `*.bundle.yaml`. The published `tic.schema.json` is generated
+ * from it (`ticConfigJsonSchema`), so the schema editors validate against cannot drift
+ * from what `tic build` accepts.
  */
 export declare const BUNDLE_CONFIG_SCHEMA: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
-    extends: z.ZodOptional<z.ZodString>;
-    output: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
-    include: z.ZodOptional<z.ZodCustom<string[], string[]>>;
-    exclude: z.ZodOptional<z.ZodCustom<string[], string[]>>;
-    compilerOptions: z.ZodOptional<z.ZodObject<{
-        importExtension: z.ZodOptional<z.ZodString>;
-        classes: z.ZodOptional<z.ZodObject<{
-            export: z.ZodDefault<z.ZodEnum<{
-                default: "default";
-                any: "any";
-                named: "named";
-            }>>;
-            decorators: z.ZodDefault<z.ZodCustom<string[], string[]>>;
-            name: z.ZodOptional<z.ZodString>;
-            excludeClasses: z.ZodOptional<z.ZodCustom<string[], string[]>>;
-            excludeName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>;
-        paths: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
-        rootDir: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>;
+    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<{
+        export: z.ZodDefault<z.ZodEnum<{
+            default: "default";
+            any: "any";
+            named: "named";
+        }>>;
+        decorators: z.ZodDefault<z.ZodCustom<string[], string[]>>;
+        glob: z.ZodOptional<z.ZodCustom<string | string[], string | string[]>>;
+        exclude: z.ZodOptional<z.ZodCustom<string | string[], string | string[]>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 /**
- * A config file is named `<name>.bundle.json`, `<name>.bundle.yaml` or `<name>.bundle.yml`,
- * e.g. `app.bundle.json`, `production.bundle.yaml`. Every format has the same shape.
+ * A config file is named `<name>.bundle.json`, `<name>.bundle.yaml` or `<name>.bundle.yml`
+ * by convention, e.g. `app.bundle.json`; any `.json` / `.yaml` / `.yml` file works.
  */
 export declare const CONFIG_FILE_SUFFIXES: string[];
-/** The config suffix `file` ends with, if any. */
-export declare const configSuffix: (file: string) => string | undefined;
+/** What stands for standard input where a config file is expected: `tic build -`. */
+export declare const STDIN = "-";
+/** The format of a config file, by extension; `undefined` for any other file. */
+export declare const configFormat: (file: string) => ConfigFormat | undefined;
+/** The format of config text: JSON or YAML. */
+export type ConfigFormat = 'json' | 'yaml';
+/**
+ * Parses config text in its format. An empty YAML document is `{}`.
+ *
+ * @throws {TicConfigError} when the text is not valid in its format.
+ */
+export declare function parseConfig(text: string, format: ConfigFormat): unknown;
 /** The generated class for a bundle name: `production` -> `ProductionBundle`, `my-app_v2` -> `MyAppV2Bundle`. */
 export declare function toClassName(name: string): string;
 /**
- * Validates parsed `*.bundle.json` content and resolves its paths against `file`'s directory.
+ * Validates parsed config content and resolves its paths against `file`'s directory.
+ * Without a `name` the bundle is named after the file: `production.bundle.json` -> `production`.
  *
- * @throws {TicConfigError} when the content does not match the config shape; the message names the field.
+ * @throws {TicConfigError} when the content does not match the config shape, or names no bundle; the message names the field.
  */
 export declare function resolveConfig(content: unknown, file: string): ResolvedConfig;
 //# sourceMappingURL=BuildConfig.d.ts.map

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

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

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

@@ -1,31 +1,37 @@
 import { z } from 'zod';
+import { type CliIo } from '../../domain/CliIo.js';
 import { type ILogger } from '../../services/ConsoleLogger.js';
 import { type IOutputService } from '../../services/OutputService.js';
 import { type IBundleBuilder } from './services/BundleBuilder.js';
-import { type ITicConfigService } from './services/TicConfigService.js';
-export declare const BUILD_OPTIONS: z.ZodObject<{
-    config: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    check: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
+export declare const BUILD_OPTIONS: z.ZodPipe<z.ZodObject<{
+    positionals: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<{
+    config: string;
+}, {
+    positionals: string[];
+}>>;
 export type BuildCliOptions = z.output<typeof BUILD_OPTIONS>;
-/** `tic build [--config <path>]... [--check]`. */
+/** `tic build [<config> | -]`: the bundle goes to stdout; without a config file, the config comes from stdin. */
 export declare class BuildController {
-    private readonly cwd;
-    private readonly configs;
+    private readonly io;
     private readonly builder;
     private readonly output;
     private readonly logger;
-    constructor(cwd: string, configs: ITicConfigService, builder: IBundleBuilder, output: IOutputService, logger: ILogger);
+    constructor(io: CliIo, builder: IBundleBuilder, output: IOutputService, logger: ILogger);
     /**
-     * Builds every config named with `--config`, else every `*.bundle.{json,yaml,yml}` of the
-     * package, else one bundle from its `tsconfig.json`. With `--check` nothing is written and
-     * an out-of-date bundle fails the run. One line per bundle goes to stdout, warnings to
-     * stderr; an error names the config it came from.
+     * Builds the bundle the config file `<config>` describes — or, without one (or with `-`),
+     * the config piped into stdin — and prints it to stdout. Saving it is the shell's job:
+     * `tic build app.bundle.json > src/di/app.bundle.ts`, `cat app.bundle.yml | tic build > out.ts`.
+     * Warnings go to stderr, so they never end up in the bundle; an error names the config.
      *
-     * @throws {UsageError} when an option is unknown or `--config` has no value.
-     * @throws {TicConfigError} when a config or its tsconfig is missing or invalid, or none can be found.
-     * @throws {StaleBundlesError} when `--check` finds a bundle that differs from what a build would write.
+     * @throws {UsageError} when an option is unknown, there is more than one `<config>`, or the config should come from stdin and nothing is piped in.
+     * @throws {TicConfigError} when the config file is missing or unreadable, the config or its tsconfig is invalid, the bundle has no name, or no tsconfig paths alias covers a selected class's file.
+     * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
      */
-    build(options: BuildCliOptions): void;
+    build({ config }: BuildCliOptions): void;
+    /**
+     * @throws {UsageError} when nothing is piped into stdin.
+     */
+    private stdin;
 }
 //# sourceMappingURL=BuildController.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"BuildController.d.ts","sourceRoot":"","sources":["../../../lib/features/build/BuildController.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,KAAK,cAAc,EAAwC,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,KAAK,iBAAiB,EAAuC,MAAM,6BAA6B,CAAC;AAE1G,eAAO,MAAM,aAAa;;;iBAGxB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAW7D,kDAAkD;AAClD,qBACa,eAAe;IAEK,OAAO,CAAC,QAAQ,CAAC,GAAG;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAJD,GAAG,EAAE,MAAM,EACN,OAAO,EAAE,iBAAiB,EAC7B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,cAAc,EAC7B,MAAM,EAAE,OAAO;IAG1D;;;;;;;;;OASG;IAEH,KAAK,CAAgE,OAAO,EAAE,eAAe,GAAG,IAAI;CAiBrG"}
+{"version":3,"file":"BuildController.d.ts","sourceRoot":"","sources":["../../../lib/features/build/BuildController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,8BAA8B,CAAC;AAEtF,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,0BAA0B,CAAC;AAElF,eAAO,MAAM,aAAa;;;;;;GAOxB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAI7D,iHAAiH;AACjH,qBACa,eAAe;IAEF,OAAO,CAAC,QAAQ,CAAC,EAAE;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHR,EAAE,EAAE,KAAK,EACA,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,cAAc,EAC7B,MAAM,EAAE,OAAO;IAG1D;;;;;;;;;OASG;IAEH,KAAK,CAAgE,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,IAAI;IAavG;;OAEG;IACH,OAAO,CAAC,KAAK;CAOd"}

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

@@ -5,8 +5,8 @@ interface Alias {
     targets: string[];
 }
 /**
- * Import paths as a project's `tsconfig.json` sees them: writes imports in the
- * form of its `paths` aliases 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;
@@ -17,9 +17,20 @@ export declare class ImportPaths {
      */
     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. */
-    specifier(fromFile: string, toFile: string): string;
+    /**
+     * 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.
+     */
+    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;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":"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`, sorted by path so the generated output is stable across machines. */
+export declare function listSourceFiles(dir: string, recursive: boolean, 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,+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"}

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"}