@ts-ioc-container/bundler 1.5.0 → 2.1.0

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,42 @@
+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;
+    /** The folders scanned; `undefined` when the files came from the extended tsconfig. */
+    paths?: string[];
+    /** Shown in the header when `paths` is `undefined`: the tsconfig the files came from. */
+    tsconfigPath: 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;
+    paths?: string[];
+    tsconfigPath: 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, paths, tsconfigPath, 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,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,yFAAyF;IACzF,YAAY,EAAE,MAAM,CAAC;IACrB,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,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,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,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,SAAS,GAAG,UAAU,CAqBpG;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 { ResolvedSelector } from './config.js';
+import type { ResolvedClassSelector } from '../BuildConfig.js';
 /** An exported class the generated bundle registers. */
 export interface DiscoveredClass {
     file: string;
@@ -27,11 +27,13 @@ export interface DiscoveredClass {
         args: string[];
     }[];
 }
+/** 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.
  */
-export declare function findClasses(file: string, selector: ResolvedSelector, text?: string): DiscoveredClass[];
+export declare function findClasses(file: string, selector: ResolvedClassSelector, text?: string): DiscoveredClass[];
 //# sourceMappingURL=scan.d.ts.map

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;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,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,25 @@
+import { ImportPaths } from './ImportPaths.js';
+/** What a bundle takes from the tsconfig it extends. */
+export interface ExtendedTsconfig {
+    importPaths: ImportPaths;
+    /** Absolute paths of the files the tsconfig compiles; `undefined` when there is no tsconfig. */
+    fileNames?: string[];
+    /**
+     * Where the sources live, as tsc sees it: `rootDir`, else the longest common folder of
+     * the non-declaration files it compiles, else the tsconfig's folder. `undefined` when
+     * there is no tsconfig.
+     */
+    rootDir?: string;
+}
+/**
+ * Reads the tsconfig a bundle extends, following its own `extends`: its `paths` aliases,
+ * import extension and file set (`files` / `include` / `exclude`). An absent tsconfig that
+ * was not named explicitly yields no aliases and no file set.
+ *
+ * @throws {TicConfigError} when a required tsconfig is missing or cannot be parsed.
+ */
+export declare function loadTsconfig(tsconfig: {
+    file: string;
+    required: boolean;
+}, importExtension?: string): ExtendedTsconfig;
+//# 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,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAeD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,EAC7C,eAAe,CAAC,EAAE,MAAM,GACvB,gBAAgB,CAkBlB"}

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

@@ -0,0 +1,68 @@
+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. a `files.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.
+     *
+     * @throws {TicConfigError} when the config or its tsconfig is missing or invalid, or the config has neither `files.paths` nor a tsconfig.
+     * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
+     */
+    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 its tsconfig is missing or invalid, or the config has neither `files.paths` nor a tsconfig.
+     * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
+     */
+    build({ config, check }?: BuildRequest): BuildResult;
+    /**
+     * @throws {TicConfigError} when the tsconfig is invalid, or the config names no `files.paths` and there is no tsconfig to take files from.
+     * @throws {NamespaceNotFoundError} when a path is neither a folder nor a tsconfig paths alias of one.
+     */
+    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;AAGrE,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;AAEjG,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;;;;;OAKG;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;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,KAAa,EAAE,GAAE,YAAiB,GAAG,WAAW;IAiBhE;;;OAGG;IACH,OAAO,CAAC,QAAQ;CAkDjB"}

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,12 +1,26 @@
-export { build, type BuildOptions, type BuildResult, type OutputResult, type OutputStatus } from './build.js';
-export { run, type CliIo } from './cli.js';
-export { loadConfig, resolveConfig, DEFAULT_CONFIG_FILE, DEFAULT_EXCLUDE, DEFAULT_BUNDLE_NAME, type TicConfig, type BundleConfig, type NamespaceConfig, type ClassSelector, type ExportKind, type ResolvedSelector, type ResolvedConfig, type ResolvedBundle, } from './config.js';
-export { ImportPaths } from './ImportPaths.js';
-export { type FilterPredicate } from './utils.js';
-export { type ExportPredicate, type ExportContext, EXPORTS_CONVENTION, findConventionalExportPredicate, loadExportPredicate, } from './exportPredicate.js';
-export { type InclusionPredicate, type InclusionContext, type TagInclusionPredicate, byTags, fileTags, INCLUSION_CONVENTION, findConventionalPredicate, loadInclusionPredicate, } from './inclusion.js';
-export { findClasses, listSourceFiles, type DiscoveredClass } from './scan.js';
-export { emitBundle, 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 PathConfig, type ClassSelector, type ExportKind, type ResolvedClassSelector, type FileSelector, type ResolvedFileSelector, type ResolvedConfig, } 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 ExtendedTsconfig } 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';
+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, NamespaceNotFoundError, 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,CAoB7D"}

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

package/typings/services/HandlebarsRenderService.d.ts

@@ -0,0 +1,23 @@
+import '../../tpl/index.cjs';
+import { SingleToken } from 'ts-ioc-container';
+/**
+ * Renders a precompiled protocol, looked up by its file basename (`Bundle.ts.hbs`).
+ *
+ * @throws {Error} when no protocol is registered under `name`.
+ */
+export declare function renderProtocol(name: string, data: unknown): string;
+/** Turns prepared data into a generated file through its protocol. */
+export interface IRenderService {
+    /**
+     * @throws {Error} when no protocol is registered under `protocol`.
+     */
+    render(protocol: string, data: unknown): string;
+}
+export declare const IRenderServiceKey: SingleToken<IRenderService>;
+export declare class HandlebarsRenderService implements IRenderService {
+    /**
+     * @throws {Error} when no protocol is registered under `protocol`.
+     */
+    render(protocol: string, data: unknown): string;
+}
+//# sourceMappingURL=HandlebarsRenderService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HandlebarsRenderService.d.ts","sourceRoot":"","sources":["../../lib/services/HandlebarsRenderService.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAE7B,OAAO,EAAY,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQzD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAIlE;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;CACjD;AAED,eAAO,MAAM,iBAAiB,6BAAoD,CAAC;AAEnF,qBACa,uBAAwB,YAAW,cAAc;IAC5D;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM;CAGhD"}

package/typings/services/NodeFileSystemService.d.ts

@@ -0,0 +1,21 @@
+import { SingleToken } from 'ts-ioc-container';
+/** The files a build reads and writes. Paths are absolute. */
+export interface IFileSystemService {
+    fileExists(file: string): boolean;
+    /**
+     * @throws {Error} when the file cannot be read, e.g. it does not exist (`ENOENT`).
+     */
+    readFile(file: string): string;
+    /** Creates missing parent folders. */
+    writeFile(file: string, content: string): void;
+}
+export declare const IFileSystemServiceKey: SingleToken<IFileSystemService>;
+export declare class NodeFileSystemService implements IFileSystemService {
+    fileExists(file: string): boolean;
+    /**
+     * @throws {Error} when the file cannot be read, e.g. it does not exist (`ENOENT`).
+     */
+    readFile(file: string): string;
+    writeFile(file: string, content: string): void;
+}
+//# sourceMappingURL=NodeFileSystemService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeFileSystemService.d.ts","sourceRoot":"","sources":["../../lib/services/NodeFileSystemService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEzD,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,sCAAsC;IACtC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChD;AAED,eAAO,MAAM,qBAAqB,iCAA4D,CAAC;AAE/F,qBACa,qBAAsB,YAAW,kBAAkB;IAC9D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAI/C"}

package/typings/services/OutputService.d.ts

@@ -0,0 +1,13 @@
+import { SingleToken } from 'ts-ioc-container';
+import { type CliIo } from '../domain/CliIo.js';
+/** A command's result, one line at a time: what a caller of `tic` reads from stdout. */
+export interface IOutputService {
+    write(line: string): void;
+}
+export declare const IOutputServiceKey: SingleToken<IOutputService>;
+export declare class StdOutputService implements IOutputService {
+    private readonly io;
+    constructor(io: CliIo);
+    write(line: string): void;
+}
+//# sourceMappingURL=OutputService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OutputService.d.ts","sourceRoot":"","sources":["../../lib/services/OutputService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,iBAAiB,CAAC;AAEvD,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,iBAAiB,6BAAoD,CAAC;AAEnF,qBACa,gBAAiB,YAAW,cAAc;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,KAAK;IAE5D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG1B"}

package/cjm/build.js

@@ -1,132 +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.build = build;
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
-const config_1 = require("./config");
-const emit_1 = require("./emit");
-const glob_1 = require("./glob");
-const ImportPaths_1 = require("./ImportPaths");
-const exportPredicate_1 = require("./exportPredicate");
-const inclusion_1 = require("./inclusion");
-const scan_1 = require("./scan");
-function build({ config = config_1.DEFAULT_CONFIG_FILE, cwd = process.cwd(), check = false, include, filterExports, } = {}) {
-    const resolved = (0, config_1.loadConfig)(node_path_1.default.resolve(cwd, config));
-    const paths = ImportPaths_1.ImportPaths.load(resolved.tsconfig, resolved.importExtension);
-    const includeFor = predicateResolver({
-        override: include,
-        conventional: (0, inclusion_1.findConventionalPredicate)(resolved.dir),
-        fileOf: (bundle) => bundle.include,
-        load: inclusion_1.loadInclusionPredicate,
-    });
-    const filterExportsFor = predicateResolver({
-        override: filterExports,
-        conventional: (0, exportPredicate_1.findConventionalExportPredicate)(resolved.dir),
-        fileOf: (bundle) => bundle.filterExports,
-        load: exportPredicate_1.loadExportPredicate,
-    });
-    const generated = resolved.bundles.map((bundle, i) => generate(resolved, bundle, `bundles[${i}]`, paths, {
-        include: includeFor(bundle),
-        filterExports: filterExportsFor(bundle),
-    }));
-    const outputs = generated.map(({ bundle, content, registrations }) => {
-        const current = (0, node_fs_1.existsSync)(bundle.output) ? (0, node_fs_1.readFileSync)(bundle.output, 'utf8') : undefined;
-        const status = current === content ? 'unchanged' : check ? 'stale' : 'written';
-        if (status === 'written') {
-            (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(bundle.output), { recursive: true });
-            (0, node_fs_1.writeFileSync)(bundle.output, content);
-        }
-        return { file: bundle.output, bundle: bundle.name, status, registrations, content };
-    });
-    return {
-        config: resolved.file,
-        outputs,
-        warnings: [...resolved.warnings, ...generated.flatMap((g) => g.warnings)],
-    };
-}
-function predicateResolver({ override, conventional, fileOf, load, }) {
-    const loaded = new Map();
-    return (bundle) => {
-        if (override)
-            return override;
-        const file = fileOf(bundle) ?? conventional;
-        if (file === undefined)
-            return undefined;
-        if (!loaded.has(file))
-            loaded.set(file, load(file));
-        return loaded.get(file);
-    };
-}
-function generate(config, bundle, field, paths, { include, filterExports }) {
-    const relative = (file) => (0, glob_1.toPosix)(node_path_1.default.relative(config.dir, file));
-    const outputs = new Set(config.bundles.map((m) => m.output));
-    const excludes = bundle.exclude.map(glob_1.globToRegExp);
-    const isExcluded = (file) => {
-        if (outputs.has(file))
-            return true;
-        const filename = relative(file);
-        return excludes.some((glob) => glob.test(filename)) || (include !== undefined && !include({ filename }));
-    };
-    const files = new Set();
-    for (const namespace of bundle.namespaces) {
-        const dir = paths.resolveNamespace(namespace.path, config.dir);
-        for (const file of (0, scan_1.listSourceFiles)(dir, namespace.recursive, isExcluded))
-            files.add(file);
-    }
-    const excludedAliases = new Set((bundle.select.excludeAliases ?? []).map(ImportPaths_1.normalizeAliasName));
-    const isAliasExcluded = (file) => {
-        if (excludedAliases.size === 0)
-            return false;
-        const alias = paths.aliasName(file);
-        return alias !== undefined && excludedAliases.has(alias);
-    };
-    const classes = [...files]
-        .sort((a, b) => (a < b ? -1 : a > b ? 1 : 0))
-        .flatMap((file) => (0, scan_1.findClasses)(file, bundle.select))
-        .filter((cls) => {
-        if (isAliasExcluded(cls.file))
-            return false;
-        if (!filterExports)
-            return true;
-        const filename = relative(cls.file);
-        const { exportName, className, isDefault, decorators } = cls;
-        return filterExports({ filename, exportName, className, isDefault, decorators, tags: (0, inclusion_1.fileTags)(filename) });
-    })
-        .map((cls) => ({ ...cls, specifier: paths.specifier(bundle.output, cls.file) }));
-    const content = (0, emit_1.emitBundle)({
-        name: bundle.name,
-        configPath: (0, glob_1.toPosix)(node_path_1.default.relative(node_path_1.default.dirname(bundle.output), config.file)),
-        namespaces: bundle.namespaces.map((ns) => ns.path),
-        classes,
-    });
-    return { bundle, content, registrations: classes.length, warnings: tokenCollisions(classes, field) };
-}
-function tokenCollisions(classes, field) {
-    const owners = new Map();
-    for (const cls of classes) {
-        for (const token of cls.tokens) {
-            const group = owners.get(token) ?? [];
-            if (!group.some((owner) => owner.className === cls.className))
-                group.push(cls);
-            owners.set(token, group);
-        }
-    }
-    return [...owners]
-        .filter(([, group]) => group.length > 1 && !scopeDisjoint(group))
-        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
-        .map(([token, group]) => {
-        const names = group.map((cls) => cls.className);
-        return (`${field}: decorator token "${token}" is passed by ${names.join(', ')}; ` +
-            `registration is last-wins, exclude one with select.excludeClasses`);
-    });
-}
-function scopeDisjoint(group) {
-    const [first, ...rest] = group;
-    return first.decoratorCalls.some(({ name, args }) => rest.every((cls) => {
-        const same = cls.decoratorCalls.find((call) => call.name === name);
-        return same !== undefined && same.args.join('\u0000') !== args.join('\u0000');
-    }));
-}