@ts-ioc-container/bundler 3.0.0 → 4.0.0

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

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