@ts-ioc-container/bundler 0.0.0

package/tpl/index.cjs

@@ -0,0 +1,81 @@
+var Handlebars = require("handlebars");  var template = Handlebars.template, templates = Handlebars.templates = Handlebars.templates || {};
+templates["Bundle.ts.hbs"] = template({"0":function(container,depth0,helpers,partials,data) {
+    return ", Registration";
+},"1":function(container,depth0,helpers,partials,data) {
+    var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), lookupProperty = container.lookupProperty || function(parent, propertyName) {
+        if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
+          return parent[propertyName];
+        }
+        return undefined
+    };
+
+  return "import "
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,(depth0 != null ? lookupProperty(depth0,"defaultName") : depth0),{"name":"if","hash":{},"fn":container.program(2, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":5,"column":7},"end":{"line":5,"column":79}}})) != null ? stack1 : "")
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"named") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(4, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":5,"column":79},"end":{"line":5,"column":131}}})) != null ? stack1 : "")
+    + " from '"
+    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"specifier") || (depth0 != null ? lookupProperty(depth0,"specifier") : depth0)) != null ? helper : container.hooks.helperMissing),(typeof helper === "function" ? helper.call(alias1,{"name":"specifier","hash":{},"data":data,"loc":{"start":{"line":5,"column":138},"end":{"line":5,"column":153}}}) : helper))) != null ? stack1 : "")
+    + "';\n";
+},"2":function(container,depth0,helpers,partials,data) {
+    var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), lookupProperty = container.lookupProperty || function(parent, propertyName) {
+        if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
+          return parent[propertyName];
+        }
+        return undefined
+    };
+
+  return ((stack1 = ((helper = (helper = lookupProperty(helpers,"defaultName") || (depth0 != null ? lookupProperty(depth0,"defaultName") : depth0)) != null ? helper : container.hooks.helperMissing),(typeof helper === "function" ? helper.call(alias1,{"name":"defaultName","hash":{},"data":data,"loc":{"start":{"line":5,"column":26},"end":{"line":5,"column":43}}}) : helper))) != null ? stack1 : "")
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"named") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(3, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":5,"column":43},"end":{"line":5,"column":72}}})) != null ? stack1 : "");
+},"3":function(container,depth0,helpers,partials,data) {
+    return ", ";
+},"4":function(container,depth0,helpers,partials,data) {
+    var stack1, lookupProperty = container.lookupProperty || function(parent, propertyName) {
+        if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
+          return parent[propertyName];
+        }
+        return undefined
+    };
+
+  return "{ "
+    + ((stack1 = (lookupProperty(helpers,"join")||(depth0 && lookupProperty(depth0,"join"))||container.hooks.helperMissing).call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? lookupProperty(depth0,"named") : depth0),", ",{"name":"join","hash":{},"data":data,"loc":{"start":{"line":5,"column":101},"end":{"line":5,"column":122}}})) != null ? stack1 : "")
+    + " }";
+},"5":function(container,depth0,helpers,partials,data) {
+    var stack1, lookupProperty = container.lookupProperty || function(parent, propertyName) {
+        if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
+          return parent[propertyName];
+        }
+        return undefined
+    };
+
+  return "export const registrations: IRegistration[] = [\n"
+    + ((stack1 = lookupProperty(helpers,"each").call(depth0 != null ? depth0 : (container.nullContext || {}),(depth0 != null ? lookupProperty(depth0,"registrations") : depth0),{"name":"each","hash":{},"fn":container.program(6, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":10,"column":0},"end":{"line":12,"column":9}}})) != null ? stack1 : "")
+    + "];\n";
+},"6":function(container,depth0,helpers,partials,data) {
+    var stack1;
+
+  return "  Registration.fromClass("
+    + ((stack1 = container.lambda(depth0, depth0)) != null ? stack1 : "")
+    + "),\n";
+},"7":function(container,depth0,helpers,partials,data) {
+    return "export const registrations: IRegistration[] = [];\n";
+},"compiler":[8,">= 4.3.0"],"main":function(container,depth0,helpers,partials,data) {
+    var stack1, helper, alias1=depth0 != null ? depth0 : (container.nullContext || {}), alias2=container.hooks.helperMissing, alias3="function", lookupProperty = container.lookupProperty || function(parent, propertyName) {
+        if (Object.prototype.hasOwnProperty.call(parent, propertyName)) {
+          return parent[propertyName];
+        }
+        return undefined
+    };
+
+  return "// Generated by `tic build` from "
+    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"configPath") || (depth0 != null ? lookupProperty(depth0,"configPath") : depth0)) != null ? helper : alias2),(typeof helper === alias3 ? helper.call(alias1,{"name":"configPath","hash":{},"data":data,"loc":{"start":{"line":1,"column":33},"end":{"line":1,"column":49}}}) : helper))) != null ? stack1 : "")
+    + ". Do not edit by hand.\n// Namespaces: "
+    + ((stack1 = (lookupProperty(helpers,"join")||(depth0 && lookupProperty(depth0,"join"))||alias2).call(alias1,(depth0 != null ? lookupProperty(depth0,"namespaces") : depth0),", ",{"name":"join","hash":{},"data":data,"loc":{"start":{"line":2,"column":15},"end":{"line":2,"column":41}}})) != null ? stack1 : "")
+    + "\nimport { type IContainer, type IContainerModule, type IRegistration"
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"registrations") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(0, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":3,"column":67},"end":{"line":3,"column":116}}})) != null ? stack1 : "")
+    + " } from 'ts-ioc-container';\n"
+    + ((stack1 = lookupProperty(helpers,"each").call(alias1,(depth0 != null ? lookupProperty(depth0,"imports") : depth0),{"name":"each","hash":{},"fn":container.program(1, data, 0),"inverse":container.noop,"data":data,"loc":{"start":{"line":4,"column":0},"end":{"line":6,"column":9}}})) != null ? stack1 : "")
+    + "\n"
+    + ((stack1 = lookupProperty(helpers,"if").call(alias1,((stack1 = (depth0 != null ? lookupProperty(depth0,"registrations") : depth0)) != null ? lookupProperty(stack1,"length") : stack1),{"name":"if","hash":{},"fn":container.program(5, data, 0),"inverse":container.program(7, data, 0),"data":data,"loc":{"start":{"line":8,"column":0},"end":{"line":16,"column":7}}})) != null ? stack1 : "")
+    + "\nexport class "
+    + ((stack1 = ((helper = (helper = lookupProperty(helpers,"name") || (depth0 != null ? lookupProperty(depth0,"name") : depth0)) != null ? helper : alias2),(typeof helper === alias3 ? helper.call(alias1,{"name":"name","hash":{},"data":data,"loc":{"start":{"line":18,"column":13},"end":{"line":18,"column":23}}}) : helper))) != null ? stack1 : "")
+    + " implements IContainerModule {\n  applyTo(container: IContainer): void {\n    for (const registration of registrations) container.addRegistration(registration);\n  }\n}\n";
+},"useData":true});

package/typings/ImportPaths.d.ts

@@ -0,0 +1,37 @@
+interface Alias {
+    pattern: string;
+    /** Absolute, `/`-separated. */
+    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.
+ */
+export declare class ImportPaths {
+    private readonly aliases;
+    readonly extension: string;
+    /**
+     * Reads `paths` (following `extends`) and the extension imports need under the
+     * tsconfig's `moduleResolution`; `importExtension` overrides the latter.
+     *
+     * @throws {TicConfigError} when a required tsconfig is missing or cannot be parsed.
+     */
+    static load(tsconfig: {
+        file: string;
+        required: boolean;
+    }, 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 aliasTargets;
+    /** A longer matched target prefix is a more specific alias; an exact file alias beats every wildcard. */
+    private matchAlias;
+}
+export {};
+//# sourceMappingURL=ImportPaths.d.ts.map

package/typings/ImportPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImportPaths.d.ts","sourceRoot":"","sources":["../lib/ImportPaths.ts"],"names":[],"mappings":"AAMA,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAeD;;;GAGG;AACH,qBAAa,WAAW;IAiCpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAjC5B;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW;gBA0B9E,OAAO,EAAE,KAAK,EAAE,EACxB,SAAS,EAAE,MAAM;IAG5B;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAa5D,mGAAmG;IACnG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAgBnD,OAAO,CAAC,YAAY;IAWpB,yGAAyG;IACzG,OAAO,CAAC,UAAU;CAanB"}

package/typings/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/typings/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../lib/bin.ts"],"names":[],"mappings":""}

package/typings/build.d.ts

@@ -0,0 +1,39 @@
+import { type ExportPredicate } from './exportPredicate.js';
+import { type InclusionPredicate } from './inclusion.js';
+export interface BuildOptions {
+    /** Path of `tic.config.json`, relative to `cwd`. Default `tic.config.json`. */
+    config?: string;
+    /** Default `process.cwd()`. */
+    cwd?: string;
+    /** Compare instead of writing: outputs that would change are reported `stale`. */
+    check?: boolean;
+    /** Decides which scanned files take part; overrides every inclusion predicate file. */
+    include?: InclusionPredicate;
+    /** Decides which parsed classes become registrations; overrides every export predicate file. */
+    filterExports?: ExportPredicate;
+}
+/** `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;
+    outputs: OutputResult[];
+}
+/**
+ * Generates one bundle per config entry. Every bundle is generated before any
+ * file is written, so a failing namespace leaves the previous outputs intact.
+ *
+ * @throws {TicConfigError} when the config, the tsconfig or a predicate file it names is missing or invalid.
+ * @throws {NamespaceNotFoundError} when a namespace is neither a folder nor a tsconfig paths alias of one.
+ */
+export declare function build({ config, cwd, check, include, filterExports, }?: BuildOptions): BuildResult;
+//# sourceMappingURL=build.d.ts.map

package/typings/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../lib/build.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,eAAe,EAAwD,MAAM,mBAAmB,CAAC;AAC/G,OAAO,EAAuC,KAAK,kBAAkB,EAA0B,MAAM,aAAa,CAAC;AAGnH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uFAAuF;IACvF,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,gGAAgG;IAChG,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC;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,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,EACpB,MAA4B,EAC5B,GAAmB,EACnB,KAAa,EACb,OAAO,EACP,aAAa,GACd,GAAE,YAAiB,GAAG,WAAW,CA6BjC"}

package/typings/cli.d.ts

@@ -0,0 +1,8 @@
+export interface CliIo {
+    cwd: string;
+    stdout: (line: string) => void;
+    stderr: (line: string) => void;
+}
+/** Runs the `tic` CLI and returns its exit code; output goes through `io`. */
+export declare function run(argv: string[], io?: CliIo): number;
+//# sourceMappingURL=cli.d.ts.map

package/typings/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../lib/cli.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AA2CD,8EAA8E;AAC9E,wBAAgB,GAAG,CACjB,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,KAA0E,GAC7E,MAAM,CA+BR"}

package/typings/config.d.ts

@@ -0,0 +1,95 @@
+/** Which exports of a file count: both kinds, only named exports, or only the default export. */
+export type ExportKind = 'any' | 'named' | 'default';
+/**
+ * How the bundler picks target classes out of a file. 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). */
+    decorators?: string[];
+    /** A glob the class name must match, e.g. `*Service`. An anonymous default export is named after its file. */
+    nameGlob?: string;
+}
+/** A {@link ClassSelector} with its defaults filled in and its `nameGlob` compiled. */
+export interface ResolvedSelector {
+    export: ExportKind;
+    decorators?: string[];
+    nameGlob?: RegExp;
+}
+export interface NamespaceConfig {
+    /** A folder relative to the config file (`./src/services`) or a tsconfig `paths` alias (`@app/services`). */
+    path: string;
+    /** Scan sub-folders too. Default `true`. */
+    recursive?: boolean;
+}
+export interface BundleConfig {
+    /** The generated file, relative to the config file. */
+    output: string;
+    /** Name of the generated class, an `IContainerModule`. Default `Bundle`. */
+    name?: string;
+    namespaces: (string | NamespaceConfig)[];
+    /** Which classes of a scanned file are registered. Default: every exported class. */
+    select?: ClassSelector;
+    /** Globs, relative to the config file, of files never scanned. Replaces {@link DEFAULT_EXCLUDE} when given. */
+    exclude?: string[];
+    /**
+     * A file exporting an `InclusionPredicate`, relative to the config file. Overrides the
+     * conventional `tic.include.*` next to the config.
+     */
+    include?: string;
+    /**
+     * A file exporting an `ExportPredicate`, relative to the config file. Overrides the
+     * conventional `tic.exports.*` next to the config.
+     */
+    filterExports?: string;
+}
+/** The shape of `tic.config.json`. */
+export interface TicConfig {
+    $schema?: string;
+    /** Relative to the config file. Default `tsconfig.json`, which may be absent. */
+    tsconfig?: string;
+    /** Extension of generated imports. Inferred from the tsconfig's `moduleResolution` when omitted. */
+    importExtension?: string;
+    bundles: BundleConfig[];
+}
+export declare const DEFAULT_CONFIG_FILE = "tic.config.json";
+export declare const DEFAULT_BUNDLE_NAME = "Bundle";
+export declare const DEFAULT_EXCLUDE: string[];
+/** A config whose defaults are filled in and whose paths are absolute. */
+export interface ResolvedConfig {
+    file: string;
+    dir: string;
+    tsconfig: {
+        file: string;
+        required: boolean;
+    };
+    importExtension?: string;
+    bundles: ResolvedBundle[];
+}
+export interface ResolvedBundle {
+    output: string;
+    name: string;
+    namespaces: Required<NamespaceConfig>[];
+    select: ResolvedSelector;
+    exclude: string[];
+    /** Absolute path of the bundle's own predicate file, when it names one. */
+    include?: string;
+    /** Absolute path of the bundle's own export predicate file, when it names one. */
+    filterExports?: string;
+}
+/**
+ * Validates parsed `tic.config.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;
+/**
+ * Reads and validates a `tic.config.json`.
+ *
+ * @throws {TicConfigError} when the file is missing, is not valid JSON, or does not match the config shape.
+ */
+export declare function loadConfig(file: string): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/typings/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../lib/config.ts"],"names":[],"mappings":"AAKA,iGAAiG;AACjG,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,8GAA8G;IAC9G,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,6GAA6G;IAC7G,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,CAAC,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC;IACzC,qFAAqF;IACrF,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAC5C,eAAO,MAAM,eAAe,UAO3B,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;IACxC,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAc5E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CASvD"}

package/typings/emit.d.ts

@@ -0,0 +1,18 @@
+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;
+    namespaces: string[];
+    classes: (DiscoveredClass & {
+        specifier: string;
+    })[];
+}
+/**
+ * Renders the generated bundle — static imports, `registrations`, and the bundle applying them —
+ * from its protocol, `protocols/Bundle.ts.hbs`. This function only prepares the data: unique local
+ * names, and one import per file in file order.
+ */
+export declare function emitBundle({ name, configPath, namespaces, classes }: EmitInput): string;
+//# sourceMappingURL=emit.d.ts.map

package/typings/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../lib/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,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,CAAC,eAAe,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;CACtD;AAID;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,SAAS,GAAG,MAAM,CA2BvF"}

package/typings/errors.d.ts

@@ -0,0 +1,13 @@
+/** Base class of every error the bundler raises on purpose; the CLI prints its message without a stack. */
+export declare class TicError extends Error {
+    name: string;
+}
+/** The config file is missing, is not JSON, or does not match the `tic.config.json` shape. */
+export declare class TicConfigError extends TicError {
+    name: string;
+}
+/** A namespace is neither an existing folder nor a `tsconfig.json` `paths` alias of one. */
+export declare class NamespaceNotFoundError extends TicError {
+    name: string;
+}
+//# sourceMappingURL=errors.d.ts.map

package/typings/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../lib/errors.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,SAAc;CACnB;AAED,8FAA8F;AAC9F,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAoB;CACzB;AAED,4FAA4F;AAC5F,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,IAAI,SAA4B;CACjC"}

package/typings/exportPredicate.d.ts

@@ -0,0 +1,36 @@
+import type { FilterPredicate } from './utils.js';
+/** What an {@link ExportPredicate} decides on: one exported class of a parsed file. */
+export interface ExportContext {
+    /** The file's path relative to the config file, `/`-separated: `src/services/Logger.ts`. */
+    filename: string;
+    /** The name the class is exported under; `'default'` for a default export. */
+    exportName: string;
+    /** The declared class name; an anonymous default export is named after its file. */
+    className: string;
+    isDefault: boolean;
+    /** Names of the class's decorators, renamed imports resolved (`register as reg` -> `'register'`). */
+    decorators: string[];
+    /** The file-name tags `byTags` reads: `Report.production.eu.ts` -> `['production', 'eu']`. */
+    tags: string[];
+}
+/**
+ * Decides, right after a file is parsed, whether one of its exported classes becomes a
+ * registration. It runs on every exported, non-abstract class that passes `select`.
+ *
+ * @example
+ * // tic.exports.ts, next to tic.config.json - picked up by convention
+ * const filterExports: ExportPredicate = ({ exportName }) => !/(Stub|Mock|Fake)$/.test(exportName);
+ * export default filterExports;
+ */
+export type ExportPredicate = FilterPredicate<ExportContext>;
+/** Export predicate files looked up next to the config, in this order, when no bundle names one. */
+export declare const EXPORTS_CONVENTION: string[];
+/** The conventional export predicate file in `dir`, if there is one. */
+export declare function findConventionalExportPredicate(dir: string): string | undefined;
+/**
+ * Loads an {@link ExportPredicate} file (see `loadPredicateFile` for formats and caching).
+ *
+ * @throws {TicConfigError} when the file is missing or does not export a function.
+ */
+export declare function loadExportPredicate(file: string): ExportPredicate;
+//# sourceMappingURL=exportPredicate.d.ts.map

package/typings/exportPredicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportPredicate.d.ts","sourceRoot":"","sources":["../lib/exportPredicate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,4FAA4F;IAC5F,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,qGAAqG;IACrG,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,8FAA8F;IAC9F,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;AAE7D,oGAAoG;AACpG,eAAO,MAAM,kBAAkB,UAAmC,CAAC;AAEnE,wEAAwE;AACxE,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAEjE"}

package/typings/glob.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Converts a glob to an anchored RegExp over `/`-separated paths: `**` spans
+ * folders (`**\/` also matches none), `*` and `?` stay within one segment.
+ */
+export declare function globToRegExp(glob: string): RegExp;
+export declare const toPosix: (file: string) => string;
+//# sourceMappingURL=glob.d.ts.map

package/typings/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../lib/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/inclusion.d.ts

@@ -0,0 +1,42 @@
+import type { FilterPredicate } from './utils.js';
+/** What an {@link InclusionPredicate} decides on. */
+export interface InclusionContext {
+    /** The file's path relative to the config file, `/`-separated: `src/services/Logger.ts`. */
+    filename: string;
+}
+/**
+ * Decides whether a scanned file takes part in code generation. A file takes
+ * part only when it matches no `exclude` glob and the predicate returns `true`.
+ *
+ * @example
+ * // tic.include.ts, next to tic.config.json - picked up by convention
+ * const include: InclusionPredicate = ({ filename }) => !filename.includes('/legacy/');
+ * export default include;
+ */
+export type InclusionPredicate = FilterPredicate<InclusionContext>;
+/**
+ * An {@link InclusionPredicate} over a file's tags, the dot-separated parts of its name between
+ * the base name and the extension. Wrap it with {@link byTags} to use it anywhere an
+ * `InclusionPredicate` goes.
+ *
+ * @example
+ * // StripeGateway.production.ts joins production only; Shared.ts joins every environment
+ * const ENVS = ['development', 'production', 'test'];
+ * export default byTags((tags) => tags.filter((t) => ENVS.includes(t)).every((t) => t === process.env.TIC_ENV));
+ */
+export type TagInclusionPredicate = (tags: string[], context: InclusionContext) => boolean;
+/** `src/Report.production.eu.ts` -> `['production', 'eu']`; `src/Shared.ts` -> `[]`. */
+export declare function fileTags(filename: string): string[];
+/** Wraps a {@link TagInclusionPredicate} into the {@link InclusionPredicate} the bundler calls. */
+export declare function byTags(predicate: TagInclusionPredicate): InclusionPredicate;
+/** Predicate files looked up next to the config, in this order, when no bundle names one. */
+export declare const INCLUSION_CONVENTION: string[];
+/** The conventional inclusion predicate file in `dir`, if there is one. */
+export declare function findConventionalPredicate(dir: string): string | undefined;
+/**
+ * Loads an {@link InclusionPredicate} file (see `loadPredicateFile` for formats and caching).
+ *
+ * @throws {TicConfigError} when the file is missing or does not export a function.
+ */
+export declare function loadInclusionPredicate(file: string): InclusionPredicate;
+//# sourceMappingURL=inclusion.d.ts.map

package/typings/inclusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inclusion.d.ts","sourceRoot":"","sources":["../lib/inclusion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,4FAA4F;IAC5F,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;AAEnE;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC;AAE3F,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAKnD;AAED,mGAAmG;AACnG,wBAAgB,MAAM,CAAC,SAAS,EAAE,qBAAqB,GAAG,kBAAkB,CAE3E;AAED,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,UAAmC,CAAC;AAErE,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAEvE"}

package/typings/index.d.ts

@@ -0,0 +1,12 @@
+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';
+//# sourceMappingURL=index.d.ts.map

package/typings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3G,OAAO,EAAE,GAAG,EAAE,KAAK,KAAK,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EACL,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,kBAAkB,EAClB,+BAA+B,EAC/B,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,MAAM,EACN,QAAQ,EACR,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC"}

package/typings/predicateFile.d.ts

@@ -0,0 +1,16 @@
+import type { FilterPredicate } from './utils.js';
+/** `tic.include` -> `tic.include.cjs`, `tic.include.js`, ... in lookup order. */
+export declare const conventionalNames: (base: string) => string[];
+/** The first conventional file for `base` that exists in `dir`, if any. */
+export declare function findConventionalFile(dir: string, base: string): string | undefined;
+/**
+ * Loads a predicate file synchronously with `require` - `.cjs` / `.js`, ES modules
+ * (Node 22.12+) and `.ts` (Node with type stripping). Its default export, or
+ * `module.exports` itself, is the predicate. Like any `require`d module it is loaded
+ * once per process, so a predicate that depends on the environment should read it
+ * when called, not when loaded.
+ *
+ * @throws {TicConfigError} when the file is missing or does not export a function.
+ */
+export declare function loadPredicateFile<T extends FilterPredicate<never>>(file: string, typeName: string): T;
+//# sourceMappingURL=predicateFile.d.ts.map

package/typings/predicateFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicateFile.d.ts","sourceRoot":"","sources":["../lib/predicateFile.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MAAM,EAA+C,CAAC;AAEvG,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIlF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAQrG"}

package/typings/render.d.ts

@@ -0,0 +1,8 @@
+import '../tpl/index.cjs';
+/**
+ * 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;
+//# sourceMappingURL=render.d.ts.map

package/typings/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../lib/render.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAS1B;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAIlE"}

package/typings/scan.d.ts

@@ -0,0 +1,22 @@
+import type { ResolvedSelector } from './config.js';
+/** An exported class the generated bundle registers. */
+export interface DiscoveredClass {
+    file: string;
+    /** The name it is exported under; `default` for a default export. */
+    exportName: string;
+    /** The local name the generated bundle would like to import it under. */
+    localName: string;
+    /** The declared class name; an anonymous default export is named after its file. */
+    className: string;
+    isDefault: boolean;
+    /** Names of the class's decorators, renamed imports resolved. */
+    decorators: string[];
+}
+/** 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[];
+//# sourceMappingURL=scan.d.ts.map

package/typings/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../lib/scan.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,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;CACtB;AAKD,+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,gBAAgB,EAC1B,IAAI,SAA6B,GAChC,eAAe,EAAE,CA4DnB"}

package/typings/utils.d.ts

@@ -0,0 +1,3 @@
+/** Decides whether a value is kept. The base of every predicate the bundler takes. */
+export type FilterPredicate<Target> = (value: Target) => boolean;
+//# sourceMappingURL=utils.d.ts.map

package/typings/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../lib/utils.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,MAAM,eAAe,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC"}