@ts-ioc-container/bundler 2.0.0 → 3.0.0

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

@@ -0,0 +1,159 @@
+import { z } from 'zod';
+/** 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.
+ */
+export interface ClassSelector {
+    /** Default `any`. */
+    export?: ExportKind;
+    /**
+     * The class must carry one of these decorators, recognised by name (`register`, or a
+     * 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.
+     */
+    excludeClasses?: string[];
+    /** A glob the class name must NOT match, e.g. `*Mock`. An anonymous default export is named after its file. */
+    excludeName?: 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;
+}
+/**
+ * `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;
+}
+/**
+ * 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.
+ */
+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}).
+     */
+    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.
+     */
+    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;
+}
+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_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;
+    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. */
+    tsconfig: {
+        file: string;
+        required: boolean;
+    };
+    /** What the config sets on top of {@link tsconfig}. */
+    overrides: TsconfigOverrides;
+    importExtension?: string;
+    classes: ResolvedClassSelector;
+}
+/**
+ * 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.
+ */
+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>>;
+}, 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.
+ */
+export declare const CONFIG_FILE_SUFFIXES: string[];
+/** The config suffix `file` ends with, if any. */
+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.
+ *
+ * @throws {TicConfigError} when the content does not match the config shape; 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+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 type BuildCliOptions = z.output<typeof BUILD_OPTIONS>;
+/** `tic build [--config <path>]... [--check]`. */
+export declare class BuildController {
+    private readonly cwd;
+    private readonly configs;
+    private readonly builder;
+    private readonly output;
+    private readonly logger;
+    constructor(cwd: string, configs: ITicConfigService, 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.
+     *
+     * @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.
+     */
+    build(options: BuildCliOptions): void;
+}
+//# sourceMappingURL=BuildController.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,5 @@
+import { type IContainer, type IContainerModule } from 'ts-ioc-container';
+export declare class BuildModule implements IContainerModule {
+    applyTo(container: IContainer): void;
+}
+//# sourceMappingURL=BuildModule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BuildModule.d.ts","sourceRoot":"","sources":["../../../lib/features/build/BuildModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAqB,MAAM,kBAAkB,CAAC;AAK7F,qBAAa,WAAY,YAAW,gBAAgB;IAClD,OAAO,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;CAMrC"}

package/typings/{ImportPaths.d.ts → features/build/domain/ImportPaths.d.ts}

@@ -5,8 +5,8 @@ interface Alias {
     targets: string[];
 }
 /**
- * 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.
+ * Import paths as a project's `tsconfig.json` sees them: writes imports in the
+ * form of its `paths` aliases where one matches.
  */
 export declare class ImportPaths {
     private readonly aliases;
@@ -17,16 +17,9 @@ export declare class ImportPaths {
      */
     static fromOptions(options: ts.CompilerOptions, tsconfigFile: string, importExtension?: string): ImportPaths;
     constructor(aliases: Alias[], extension: 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 `fromFile` imports `toFile` by: its most specific alias, else a relative path. */
     specifier(fromFile: string, toFile: string): string;
     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

@@ -0,0 +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"}

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

@@ -0,0 +1,13 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,36 @@
+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;
+    classes: (DiscoveredClass & {
+        specifier: string;
+    })[];
+}
+/** The first line of every generated bundle; marks it as output, never input. */
+export declare const GENERATED_HEADER = "// Generated by `tic build`";
+/** What `protocols/Bundle.ts.hbs` renders. */
+export interface BundleView {
+    configPath: string;
+    name: string;
+    imports: {
+        specifier: string;
+        defaultName?: string;
+        named: string[];
+    }[];
+    registrations: string[];
+}
+/** The protocol a bundle is rendered from. */
+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;
+/**
+ * Renders the generated bundle — static imports, `registrations`, and the bundle applying them —
+ * from its protocol, `protocols/Bundle.ts.hbs`.
+ */
+export declare function emitBundle(input: EmitInput): string;
+//# sourceMappingURL=emit.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/glob.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBjD;AAED,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,MAAoC,CAAC"}

package/typings/{scan.d.ts → features/build/domain/scan.d.ts}

@@ -1,4 +1,4 @@
-import type { ResolvedClassSelector } from './config.js';
+import type { ResolvedClassSelector } from '../BuildConfig.js';
 /** An exported class the generated bundle registers. */
 export interface DiscoveredClass {
     file: string;
@@ -29,8 +29,6 @@ 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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+import type { DiscoveredClass } from './scan.js';
+/**
+ * A heuristic for "two selected classes bind the same token": when the decorator's
+ * first argument is a plain identifier, equal identifiers are almost always the same
+ * token, and registration is last-wins, so one silently replaces the other. Purely
+ * syntactic — aliased imports and computed keys are not resolved.
+ *
+ * Scope-gated classes (`@perPage('stations')`, `@perPage('sessions')`) share the
+ * token but are not last-wins: the classes are distinguished by a decorator they
+ * share called with different arguments, so each scope registers its own. Those
+ * groups are not warned about.
+ */
+export declare function tokenCollisions(classes: DiscoveredClass[]): string[];
+//# sourceMappingURL=tokenCollisions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenCollisions.d.ts","sourceRoot":"","sources":["../../../../lib/features/build/domain/tokenCollisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAmBpE"}

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

@@ -0,0 +1,21 @@
+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.
+ *
+ * @throws {TicConfigError} when a required tsconfig is missing, or the config or a tsconfig it extends is invalid.
+ */
+export declare function loadTsconfig(config: ResolvedConfig): CompiledTsconfig;
+//# sourceMappingURL=tsconfig.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,65 @@
+import { SingleToken } from 'ts-ioc-container';
+import { type IRenderService } from '../../../services/HandlebarsRenderService.js';
+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 {
+    /**
+     * 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.
+     */
+    config?: string;
+    /** Compare instead of writing: outputs that would change are reported `stale`. */
+    check?: boolean;
+}
+export interface BuildOptions extends 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;
+    /** Name of the generated class. */
+    bundle: string;
+    status: OutputStatus;
+    registrations: number;
+    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.
+     */
+    warnings: string[];
+}
+export interface IBundleBuilder {
+    /**
+     * Generates the bundle a config describes. Nothing is written unless generation succeeds.
+     *
+     * @throws {TicConfigError} when the config or the tsconfig it extends is missing or invalid.
+     */
+    build(request?: BuildRequest): BuildResult;
+}
+export declare const IBundleBuilderKey: SingleToken<IBundleBuilder>;
+export declare class BundleBuilder implements IBundleBuilder {
+    private readonly cwd;
+    private readonly configs;
+    private readonly fs;
+    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.
+     */
+    build({ config, check }?: BuildRequest): BuildResult;
+    /**
+     * @throws {TicConfigError} when the config or the tsconfig it extends is missing or invalid.
+     */
+    private generate;
+}
+//# sourceMappingURL=BundleBuilder.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,37 @@
+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`.
+     *
+     * @throws {TicConfigError} when the file is missing, 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.
+     *
+     * @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.
+     */
+    discover(named: string[]): (string | undefined)[];
+}
+export declare const ITicConfigServiceKey: SingleToken<ITicConfigService>;
+export declare class TicConfigService implements ITicConfigService {
+    private readonly cwd;
+    private readonly fs;
+    constructor(cwd: string, fs: IFileSystemService);
+    /**
+     * @throws {TicConfigError} when the file is missing, 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.
+     */
+    discover(named: string[]): (string | undefined)[];
+}
+//# sourceMappingURL=TicConfigService.d.ts.map

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

@@ -0,0 +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"}

package/typings/features/help/HelpController.d.ts

@@ -0,0 +1,8 @@
+import { type IOutputService } from '../../services/OutputService.js';
+/** `tic help`, also `tic --help` / `tic -h`. */
+export declare class HelpController {
+    private readonly output;
+    constructor(output: IOutputService);
+    printUsage(): void;
+}
+//# sourceMappingURL=HelpController.d.ts.map

package/typings/features/help/HelpController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpController.d.ts","sourceRoot":"","sources":["../../../lib/features/help/HelpController.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,8BAA8B,CAAC;AAEtF,gDAAgD;AAChD,qBACa,cAAc;IACkB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAGlF,UAAU,IAAI,IAAI;CAGnB"}

package/typings/features/help/HelpModule.d.ts

@@ -0,0 +1,5 @@
+import { type IContainer, type IContainerModule } from 'ts-ioc-container';
+export declare class HelpModule implements IContainerModule {
+    applyTo(container: IContainer): void;
+}
+//# sourceMappingURL=HelpModule.d.ts.map

package/typings/features/help/HelpModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpModule.d.ts","sourceRoot":"","sources":["../../../lib/features/help/HelpModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAqB,MAAM,kBAAkB,CAAC;AAI7F,qBAAa,UAAW,YAAW,gBAAgB;IACjD,OAAO,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;CAGrC"}

package/typings/features/help/VersionController.d.ts

@@ -0,0 +1,8 @@
+import { type IOutputService } from '../../services/OutputService.js';
+/** `tic version`, also `tic --version` / `tic -v`. */
+export declare class VersionController {
+    private readonly output;
+    constructor(output: IOutputService);
+    printVersion(): void;
+}
+//# sourceMappingURL=VersionController.d.ts.map

package/typings/features/help/VersionController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionController.d.ts","sourceRoot":"","sources":["../../../lib/features/help/VersionController.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,8BAA8B,CAAC;AAItF,sDAAsD;AACtD,qBACa,iBAAiB;IACe,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAGlF,YAAY,IAAI,IAAI;CAGrB"}

package/typings/index.d.ts

@@ -1,10 +1,26 @@
-export { build, TSCONFIG_FILE, type BuildOptions, type BuildResult, type OutputResult, type OutputStatus, } from './build.js';
-export { run, type CliIo } from './cli.js';
-export { loadConfig, resolveConfig, CONFIG_FILE_SUFFIXES, findConfigFiles, findPackageRoot, DEFAULT_EXTENDS, DEFAULT_EXCLUDE, DEFAULT_BUNDLE_NAME, DEFAULT_DECORATORS, toClassName, type BundleConfig, type PathConfig, type ClassSelector, type ExportKind, type ResolvedClassSelector, type FileSelector, type ResolvedFileSelector, type ResolvedConfig, } from './config.js';
-export { ImportPaths } from './ImportPaths.js';
-export { loadTsconfig, type ExtendedTsconfig } from './tsconfig.js';
-export { findClasses, isSourceFile, listSourceFiles, type DiscoveredClass } from './scan.js';
-export { emitBundle, GENERATED_HEADER, type EmitInput } from './emit.js';
-export { globToRegExp } from './glob.js';
-export { TicError, TicConfigError, NamespaceNotFoundError } from './errors.js';
+export { build, run, loadConfig, createContainer } from './app.js';
+export { type CliIo, CliIoKey } from './domain/CliIo.js';
+export { type GlobalConfig, GlobalConfigKey, globalConfig } from './domain/GlobalConfig.js';
+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 { 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 { 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';
+export { HelpModule } from './features/help/HelpModule.js';
+export { CommonModule } from './modules/CommonModule.js';
+export { type IOutputService, IOutputServiceKey, StdOutputService } from './services/OutputService.js';
+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 { ExceptionHandler } from './exceptions/ExceptionHandler.js';
 //# sourceMappingURL=index.d.ts.map

package/typings/modules/CommonModule.d.ts

@@ -0,0 +1,9 @@
+import { type IContainer, type IContainerModule } from 'ts-ioc-container';
+import { type CliIo } from '../domain/CliIo.js';
+/** Services every feature shares: the run's context, its output streams, and error reporting. */
+export declare class CommonModule implements IContainerModule {
+    private readonly io;
+    constructor(io: CliIo);
+    applyTo(container: IContainer): void;
+}
+//# sourceMappingURL=CommonModule.d.ts.map

package/typings/modules/CommonModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommonModule.d.ts","sourceRoot":"","sources":["../../lib/modules/CommonModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAqB,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,iBAAiB,CAAC;AAQvD,iGAAiG;AACjG,qBAAa,YAAa,YAAW,gBAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,KAAK;IAEtC,OAAO,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;CAUrC"}

package/typings/schema/ticConfigSchema.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The JSON Schema published as `tic.schema.json`, generated from the zod schema
+ * `tic build` validates with. `pnpm run generate:schema` writes it; a test fails
+ * when the committed file is stale.
+ */
+export declare function ticConfigJsonSchema(): Record<string, unknown>;
+//# sourceMappingURL=ticConfigSchema.d.ts.map

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

@@ -0,0 +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"}

package/typings/services/ConsoleLogger.d.ts

@@ -0,0 +1,20 @@
+import { SingleToken } from 'ts-ioc-container';
+import { type CliIo } from '../domain/CliIo.js';
+/**
+ * Diagnostics, kept off stdout so a command's output stays machine-readable.
+ * Every line is prefixed with `tic:`.
+ */
+export interface ILogger {
+    /** A non-fatal problem: `tic: warning: <message>`. */
+    warn(message: string): void;
+    /** A fatal problem: `tic: <message>`. */
+    error(message: string): void;
+}
+export declare const ILoggerKey: SingleToken<ILogger>;
+export declare class ConsoleLogger implements ILogger {
+    private readonly io;
+    constructor(io: CliIo);
+    warn(message: string): void;
+    error(message: string): void;
+}
+//# sourceMappingURL=ConsoleLogger.d.ts.map

package/typings/services/ConsoleLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogger.d.ts","sourceRoot":"","sources":["../../lib/services/ConsoleLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,iBAAiB,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,sDAAsD;IACtD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yCAAyC;IACzC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,UAAU,sBAAsC,CAAC;AAE9D,qBACa,aAAc,YAAW,OAAO;IACT,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,KAAK;IAE5D,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG7B"}