@venizia/ignis-kernel 0.4.2 → 0.4.4

package/dist/cjs/base/applications/artifact-group.d.ts

@@ -1,63 +0,0 @@
-import type { IArtifactGroup, IArtifactIndex } from './common';
-type TGroupResolver = (opts: {
-    group: IArtifactGroup;
-}) => Promise<IArtifactIndex>;
-/** A typed slice of a shared package's artifacts - every decorated class under a directory named `folder` in the package that defined it. A package declares one per domain, once; an application borrows it in `configs.artifacts`. The content is filled by `@venizia/ignis-boot`: inlined when the application is built, or resolved from source when artifacts are registered. */
-export declare class ArtifactGroup implements IArtifactGroup {
-    /** A string brand, so the group protocol is structural: `@venizia/ignis-boot/auto` builds one without depending on the kernel. */
-    static readonly BRAND_KEY = "isArtifactGroup";
-    /** The realm slot `@venizia/ignis-boot` fills with the resolver for groups defined without content. */
-    static readonly SINGLETON_REALM_KEY = "artifact-group-resolver";
-    readonly isArtifactGroup: true;
-    readonly resolve: (() => Promise<IArtifactIndex>) | undefined;
-    readonly kinds: ReadonlyArray<keyof IArtifactIndex> | undefined;
-    private constructor();
-    readonly folder: string | undefined;
-    readonly site: string | undefined;
-    readonly content: IArtifactIndex | undefined;
-    readonly ignore: ReadonlyArray<string> | undefined;
-    /** `content` is written by the build plugin; a hand-written group passes only `folder`. */
-    static define(opts: {
-        folder: string;
-        content?: IArtifactIndex;
-    }): ArtifactGroup;
-    /** Every decorated class of the calling package - an application's own artifacts, picked by its call site, so several applications in one process each get their own. `ignore` takes the globs `ignis-artifacts --ignore` takes, relative to the package `src`. `content` is written by the build plugin. */
-    static application(opts?: {
-        ignore?: ReadonlyArray<string>;
-        content?: IArtifactIndex;
-    }): ArtifactGroup;
-    /** A group carrying only `kinds` - for a slicer that splits `configs.artifacts` by run mode. The source group is resolved when artifacts are registered, never here. */
-    static pick(opts: {
-        group: IArtifactGroup;
-        kinds: ReadonlyArray<keyof IArtifactIndex>;
-    }): ArtifactGroup;
-    /** A group's classes: inlined by a build, else its own `resolve()`, else the resolver `@venizia/ignis-boot/auto` installs. */
-    static resolveContent(opts: {
-        group: IArtifactGroup;
-    }): Promise<IArtifactIndex>;
-    /** Positional on purpose: a type predicate narrows its own parameter, and an options object would narrow the wrapper instead of `value`. */
-    static isGroup(value: unknown): value is IArtifactGroup;
-    static setResolver(opts: {
-        resolve: TGroupResolver | undefined;
-    }): void;
-    static getResolver(): TGroupResolver | undefined;
-    /** The error a walker over `configs.artifacts` gets for reading a kind off a group - loud, never an empty list. */
-    static unreadKindError(opts: {
-        folder: string | undefined;
-    }): Error;
-    get configurations(): never;
-    get dataSources(): never;
-    get components(): never;
-    get repositories(): never;
-    get services(): never;
-    get controllers(): never;
-    private static holder;
-    /** The module that declared the group, read from the call stack. */
-    private static callSite;
-    /** The first frame outside the kernel's own `artifact-group` file: POSIX and Windows paths, `file://` URLs (decoded, drive kept), parentheses inside a path. */
-    static siteFromStack(opts: {
-        stack: string;
-    }): string | undefined;
-}
-export {};
-//# sourceMappingURL=artifact-group.d.ts.map

package/dist/cjs/base/applications/artifact-group.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"artifact-group.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/artifact-group.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/D,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAEnF,sXAAsX;AACtX,qBAAa,aAAc,YAAW,cAAc;IAClD,kIAAkI;IAClI,MAAM,CAAC,QAAQ,CAAC,SAAS,qBAAqB;IAC9C,uGAAuG;IACvG,MAAM,CAAC,QAAQ,CAAC,mBAAmB,6BAA6B;IAEhE,QAAQ,CAAC,eAAe,EAAG,IAAI,CAAU;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAC;IAEhE,OAAO;IAgBP,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAEnD,2FAA2F;IAC3F,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,aAAa;IAQhF,6SAA6S;IAC7S,MAAM,CAAC,WAAW,CAChB,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAA;KAAO,GACtE,aAAa;IAShB,wKAAwK;IACxK,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;QAChB,KAAK,EAAE,cAAc,CAAC;QACtB,KAAK,EAAE,aAAa,CAAC,MAAM,cAAc,CAAC,CAAC;KAC5C,GAAG,aAAa;IAiBjB,8HAA8H;WACjH,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAiBrF,4IAA4I;IAC5I,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc;IASvD,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,cAAc,GAAG,SAAS,CAAA;KAAE,GAAG,IAAI;IAIvE,MAAM,CAAC,WAAW,IAAI,cAAc,GAAG,SAAS;IAIhD,mHAAmH;IACnH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,KAAK;IAMnE,IAAI,cAAc,IAAI,KAAK,CAE1B;IAED,IAAI,WAAW,IAAI,KAAK,CAEvB;IAED,IAAI,UAAU,IAAI,KAAK,CAEtB;IAED,IAAI,YAAY,IAAI,KAAK,CAExB;IAED,IAAI,QAAQ,IAAI,KAAK,CAEpB;IAED,IAAI,WAAW,IAAI,KAAK,CAEvB;IAED,OAAO,CAAC,MAAM,CAAC,MAAM;IAOrB,oEAAoE;IACpE,OAAO,CAAC,MAAM,CAAC,QAAQ;IAMvB,gKAAgK;IAChK,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS;CAgBlE"}

package/dist/cjs/base/applications/artifact-group.js

@@ -1,136 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArtifactGroup = void 0;
-const singleton_realm_1 = require("../../helpers/singleton-realm");
-const core_1 = require("@venizia/ignis-helpers/core");
-/** A typed slice of a shared package's artifacts - every decorated class under a directory named `folder` in the package that defined it. A package declares one per domain, once; an application borrows it in `configs.artifacts`. The content is filled by `@venizia/ignis-boot`: inlined when the application is built, or resolved from source when artifacts are registered. */
-class ArtifactGroup {
-    /** A string brand, so the group protocol is structural: `@venizia/ignis-boot/auto` builds one without depending on the kernel. */
-    static { this.BRAND_KEY = 'isArtifactGroup'; }
-    /** The realm slot `@venizia/ignis-boot` fills with the resolver for groups defined without content. */
-    static { this.SINGLETON_REALM_KEY = 'artifact-group-resolver'; }
-    constructor(opts) {
-        this.isArtifactGroup = true;
-        this.folder = opts.folder;
-        this.site = opts.site;
-        this.content = opts.content;
-        this.resolve = opts.resolve;
-        this.kinds = opts.kinds;
-        this.ignore = opts.ignore;
-    }
-    /** `content` is written by the build plugin; a hand-written group passes only `folder`. */
-    static define(opts) {
-        return new ArtifactGroup({
-            folder: opts.folder,
-            site: ArtifactGroup.callSite(),
-            content: opts.content,
-        });
-    }
-    /** Every decorated class of the calling package - an application's own artifacts, picked by its call site, so several applications in one process each get their own. `ignore` takes the globs `ignis-artifacts --ignore` takes, relative to the package `src`. `content` is written by the build plugin. */
-    static application(opts = {}) {
-        return new ArtifactGroup({
-            folder: undefined,
-            site: ArtifactGroup.callSite(),
-            content: opts.content,
-            ignore: opts.ignore,
-        });
-    }
-    /** A group carrying only `kinds` - for a slicer that splits `configs.artifacts` by run mode. The source group is resolved when artifacts are registered, never here. */
-    static pick(opts) {
-        const { group, kinds } = opts;
-        const slice = (index) => Object.fromEntries(kinds.filter((kind) => index[kind] !== undefined).map((kind) => [kind, index[kind]]));
-        return new ArtifactGroup({
-            folder: group.folder,
-            site: group.site,
-            content: group.content ? slice(group.content) : undefined,
-            resolve: async () => slice(await ArtifactGroup.resolveContent({ group })),
-            kinds,
-            ignore: group.ignore,
-        });
-    }
-    /** A group's classes: inlined by a build, else its own `resolve()`, else the resolver `@venizia/ignis-boot/auto` installs. */
-    static async resolveContent(opts) {
-        const { group } = opts;
-        if (group.content) {
-            return group.content;
-        }
-        if (group.resolve) {
-            return group.resolve();
-        }
-        const resolve = ArtifactGroup.getResolver();
-        if (!resolve) {
-            throw (0, core_1.getError)({
-                message: `[ArtifactGroup] '${group.folder ?? '<application>'}' has no content | Import @venizia/ignis-boot/auto in the application (it resolves groups from source), or add IgnisArtifactsPlugin to the build's plugins`,
-            });
-        }
-        return resolve({ group });
-    }
-    /** Positional on purpose: a type predicate narrows its own parameter, and an options object would narrow the wrapper instead of `value`. */
-    static isGroup(value) {
-        return (typeof value === 'object' &&
-            value !== null &&
-            ArtifactGroup.BRAND_KEY in value &&
-            value[ArtifactGroup.BRAND_KEY] === true);
-    }
-    static setResolver(opts) {
-        ArtifactGroup.holder().resolve = opts.resolve;
-    }
-    static getResolver() {
-        return ArtifactGroup.holder().resolve;
-    }
-    /** The error a walker over `configs.artifacts` gets for reading a kind off a group - loud, never an empty list. */
-    static unreadKindError(opts) {
-        return (0, core_1.getError)({
-            message: `[ArtifactGroup] '${opts.folder ?? '<application>'}' is resolved when artifacts are registered | A function that walks configs.artifacts must pass a group through untouched (ArtifactGroup.isGroup) instead of reading its kinds`,
-        });
-    }
-    get configurations() {
-        throw ArtifactGroup.unreadKindError({ folder: this.folder });
-    }
-    get dataSources() {
-        throw ArtifactGroup.unreadKindError({ folder: this.folder });
-    }
-    get components() {
-        throw ArtifactGroup.unreadKindError({ folder: this.folder });
-    }
-    get repositories() {
-        throw ArtifactGroup.unreadKindError({ folder: this.folder });
-    }
-    get services() {
-        throw ArtifactGroup.unreadKindError({ folder: this.folder });
-    }
-    get controllers() {
-        throw ArtifactGroup.unreadKindError({ folder: this.folder });
-    }
-    static holder() {
-        return singleton_realm_1.SingletonRealm.resolve({
-            key: ArtifactGroup.SINGLETON_REALM_KEY,
-            create: () => ({ resolve: undefined }),
-        });
-    }
-    /** The module that declared the group, read from the call stack. */
-    static callSite() {
-        // A stack trace, not a failure: reading the call site needs an Error object, and nothing is thrown.
-        // eslint-disable-next-line venizia/no-new-error
-        return ArtifactGroup.siteFromStack({ stack: new Error().stack ?? '' });
-    }
-    /** The first frame outside the kernel's own `artifact-group` file: POSIX and Windows paths, `file://` URLs (decoded, drive kept), parentheses inside a path. */
-    static siteFromStack(opts) {
-        for (const raw of opts.stack.split('\n').slice(1)) {
-            const frame = raw.trim().replace(/^at\s+/, '');
-            const opening = frame.indexOf(' (');
-            const location = frame.endsWith(')') && opening >= 0 ? frame.slice(opening + 2, -1) : frame;
-            let file = location.replace(/:\d+:\d+$/, '');
-            if (file.startsWith('file://')) {
-                file = decodeURIComponent(file.slice('file://'.length)).replace(/^\/([A-Za-z]:\/)/, '$1');
-            }
-            const isPath = file.startsWith('/') || /^[A-Za-z]:[\\/]/.test(file);
-            if (isPath && !/(?:^|[\\/])artifact-group\.(?:ts|js)$/.test(file)) {
-                return file;
-            }
-        }
-        return undefined;
-    }
-}
-exports.ArtifactGroup = ArtifactGroup;
-//# sourceMappingURL=artifact-group.js.map

package/dist/cjs/base/applications/artifact-group.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"artifact-group.js","sourceRoot":"","sources":["../../../../src/base/applications/artifact-group.ts"],"names":[],"mappings":"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","sourcesContent":["import { SingletonRealm } from '@/helpers/singleton-realm';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { IArtifactGroup, IArtifactIndex } from './common';\n\ntype TGroupResolver = (opts: { group: IArtifactGroup }) => Promise<IArtifactIndex>;\n\n/** A typed slice of a shared package's artifacts - every decorated class under a directory named `folder` in the package that defined it. A package declares one per domain, once; an application borrows it in `configs.artifacts`. The content is filled by `@venizia/ignis-boot`: inlined when the application is built, or resolved from source when artifacts are registered. */\nexport class ArtifactGroup implements IArtifactGroup {\n  /** A string brand, so the group protocol is structural: `@venizia/ignis-boot/auto` builds one without depending on the kernel. */\n  static readonly BRAND_KEY = 'isArtifactGroup';\n  /** The realm slot `@venizia/ignis-boot` fills with the resolver for groups defined without content. */\n  static readonly SINGLETON_REALM_KEY = 'artifact-group-resolver';\n\n  readonly isArtifactGroup = true as const;\n  readonly resolve: (() => Promise<IArtifactIndex>) | undefined;\n  readonly kinds: ReadonlyArray<keyof IArtifactIndex> | undefined;\n\n  private constructor(opts: {\n    folder: string | undefined;\n    site: string | undefined;\n    content: IArtifactIndex | undefined;\n    resolve?: () => Promise<IArtifactIndex>;\n    kinds?: ReadonlyArray<keyof IArtifactIndex>;\n    ignore?: ReadonlyArray<string>;\n  }) {\n    this.folder = opts.folder;\n    this.site = opts.site;\n    this.content = opts.content;\n    this.resolve = opts.resolve;\n    this.kinds = opts.kinds;\n    this.ignore = opts.ignore;\n  }\n\n  readonly folder: string | undefined;\n  readonly site: string | undefined;\n  readonly content: IArtifactIndex | undefined;\n  readonly ignore: ReadonlyArray<string> | undefined;\n\n  /** `content` is written by the build plugin; a hand-written group passes only `folder`. */\n  static define(opts: { folder: string; content?: IArtifactIndex }): ArtifactGroup {\n    return new ArtifactGroup({\n      folder: opts.folder,\n      site: ArtifactGroup.callSite(),\n      content: opts.content,\n    });\n  }\n\n  /** Every decorated class of the calling package - an application's own artifacts, picked by its call site, so several applications in one process each get their own. `ignore` takes the globs `ignis-artifacts --ignore` takes, relative to the package `src`. `content` is written by the build plugin. */\n  static application(\n    opts: { ignore?: ReadonlyArray<string>; content?: IArtifactIndex } = {},\n  ): ArtifactGroup {\n    return new ArtifactGroup({\n      folder: undefined,\n      site: ArtifactGroup.callSite(),\n      content: opts.content,\n      ignore: opts.ignore,\n    });\n  }\n\n  /** A group carrying only `kinds` - for a slicer that splits `configs.artifacts` by run mode. The source group is resolved when artifacts are registered, never here. */\n  static pick(opts: {\n    group: IArtifactGroup;\n    kinds: ReadonlyArray<keyof IArtifactIndex>;\n  }): ArtifactGroup {\n    const { group, kinds } = opts;\n    const slice = (index: IArtifactIndex): IArtifactIndex =>\n      Object.fromEntries(\n        kinds.filter((kind) => index[kind] !== undefined).map((kind) => [kind, index[kind]]),\n      );\n\n    return new ArtifactGroup({\n      folder: group.folder,\n      site: group.site,\n      content: group.content ? slice(group.content) : undefined,\n      resolve: async () => slice(await ArtifactGroup.resolveContent({ group })),\n      kinds,\n      ignore: group.ignore,\n    });\n  }\n\n  /** A group's classes: inlined by a build, else its own `resolve()`, else the resolver `@venizia/ignis-boot/auto` installs. */\n  static async resolveContent(opts: { group: IArtifactGroup }): Promise<IArtifactIndex> {\n    const { group } = opts;\n    if (group.content) {\n      return group.content;\n    }\n    if (group.resolve) {\n      return group.resolve();\n    }\n    const resolve = ArtifactGroup.getResolver();\n    if (!resolve) {\n      throw getError({\n        message: `[ArtifactGroup] '${group.folder ?? '<application>'}' has no content | Import @venizia/ignis-boot/auto in the application (it resolves groups from source), or add IgnisArtifactsPlugin to the build's plugins`,\n      });\n    }\n    return resolve({ group });\n  }\n\n  /** Positional on purpose: a type predicate narrows its own parameter, and an options object would narrow the wrapper instead of `value`. */\n  static isGroup(value: unknown): value is IArtifactGroup {\n    return (\n      typeof value === 'object' &&\n      value !== null &&\n      ArtifactGroup.BRAND_KEY in value &&\n      value[ArtifactGroup.BRAND_KEY] === true\n    );\n  }\n\n  static setResolver(opts: { resolve: TGroupResolver | undefined }): void {\n    ArtifactGroup.holder().resolve = opts.resolve;\n  }\n\n  static getResolver(): TGroupResolver | undefined {\n    return ArtifactGroup.holder().resolve;\n  }\n\n  /** The error a walker over `configs.artifacts` gets for reading a kind off a group - loud, never an empty list. */\n  static unreadKindError(opts: { folder: string | undefined }): Error {\n    return getError({\n      message: `[ArtifactGroup] '${opts.folder ?? '<application>'}' is resolved when artifacts are registered | A function that walks configs.artifacts must pass a group through untouched (ArtifactGroup.isGroup) instead of reading its kinds`,\n    });\n  }\n\n  get configurations(): never {\n    throw ArtifactGroup.unreadKindError({ folder: this.folder });\n  }\n\n  get dataSources(): never {\n    throw ArtifactGroup.unreadKindError({ folder: this.folder });\n  }\n\n  get components(): never {\n    throw ArtifactGroup.unreadKindError({ folder: this.folder });\n  }\n\n  get repositories(): never {\n    throw ArtifactGroup.unreadKindError({ folder: this.folder });\n  }\n\n  get services(): never {\n    throw ArtifactGroup.unreadKindError({ folder: this.folder });\n  }\n\n  get controllers(): never {\n    throw ArtifactGroup.unreadKindError({ folder: this.folder });\n  }\n\n  private static holder(): { resolve: TGroupResolver | undefined } {\n    return SingletonRealm.resolve({\n      key: ArtifactGroup.SINGLETON_REALM_KEY,\n      create: () => ({ resolve: undefined }),\n    });\n  }\n\n  /** The module that declared the group, read from the call stack. */\n  private static callSite(): string | undefined {\n    // A stack trace, not a failure: reading the call site needs an Error object, and nothing is thrown.\n    // eslint-disable-next-line venizia/no-new-error\n    return ArtifactGroup.siteFromStack({ stack: new Error().stack ?? '' });\n  }\n\n  /** The first frame outside the kernel's own `artifact-group` file: POSIX and Windows paths, `file://` URLs (decoded, drive kept), parentheses inside a path. */\n  static siteFromStack(opts: { stack: string }): string | undefined {\n    for (const raw of opts.stack.split('\\n').slice(1)) {\n      const frame = raw.trim().replace(/^at\\s+/, '');\n      const opening = frame.indexOf(' (');\n      const location = frame.endsWith(')') && opening >= 0 ? frame.slice(opening + 2, -1) : frame;\n      let file = location.replace(/:\\d+:\\d+$/, '');\n      if (file.startsWith('file://')) {\n        file = decodeURIComponent(file.slice('file://'.length)).replace(/^\\/([A-Za-z]:\\/)/, '$1');\n      }\n      const isPath = file.startsWith('/') || /^[A-Za-z]:[\\\\/]/.test(file);\n      if (isPath && !/(?:^|[\\\\/])artifact-group\\.(?:ts|js)$/.test(file)) {\n        return file;\n      }\n    }\n    return undefined;\n  }\n}\n"]}

package/dist/cjs/base/applications/artifact-index.d.ts

@@ -1,45 +0,0 @@
-import type { TClass } from '@venizia/ignis-helpers/common';
-import { BaseHelper } from '@venizia/ignis-helpers/core';
-import type { IArtifactIndex, TArtifactIndexInput } from './common';
-/** Turns a `configs.artifacts` input into the classes to register: flattens nested indexes, drops the classes whose `when` says no, orders the rest. It never touches the container - `registerArtifacts` does the binding. */
-export declare class ArtifactIndexHelper extends BaseHelper {
-    static readonly SINGLETON_REALM_KEY = "artifact-index-helper";
-    private constructor();
-    static getInstance(): ArtifactIndexHelper;
-    /** Maps an artifact type to the index field that carries it. `ArtifactTypes.MODEL` is deliberately absent: a model has a binding namespace but no index field, because its repository registers it. */
-    private static readonly INDEX_FIELD_BY_TYPE;
-    /** The index a decorator-only application has: every class a stereotype saw at import time, bucketed by its type. `when` and `order` still apply - `resolve` does that, exactly as it does for a declared index. */
-    buildDiscoveredIndex(): IArtifactIndex;
-    /** Every kind of the input, each already filtered by `when` and sorted by `order`, keyed the way `IArtifactIndex` is. */
-    resolve(opts: {
-        input: TArtifactIndexInput;
-        application: unknown;
-    }): Promise<Required<IArtifactIndex>>;
-    /**
-     * Topologically sort configurations based on `after` dependencies.
-     * Siblings with no dependency relation are sorted deterministically by class name.
-     * Throws if an unknown `after` dependency is referenced or if a dependency cycle is detected.
-     */
-    sortConfigurationsTopologically(opts: {
-        classes: ReadonlyArray<TClass<any>>;
-    }): TClass<any>[];
-    /** Every entry of a kind must be a class. `undefined` is what an import cycle leaves - the index was read before a class's module finished loading - so it gets a message that names the cause instead of a crash on `.name`. */
-    private assertClasses;
-    /** One index, or arrays nested to any depth, as a flat list in input order; a conditional entry contributes its subtree only when its `when` answers true. */
-    flatten(opts: {
-        input: TArtifactIndexInput;
-        application: unknown;
-    }): Promise<IArtifactIndex[]>;
-    /** A group's classes: inlined at build time, else the resolver `@venizia/ignis-boot/auto` installs. Never empty - a group that names nothing is a typo or a moved folder. */
-    private contentOf;
-    /** Positional on purpose: a type predicate narrows its own parameter, and an options object would narrow the wrapper instead of `input`. */
-    private isConditional;
-    /** The classes of one kind across every index, minus those whose `when` says no, sorted by `order` (stable). The `when` conditions run concurrently: each reads config and environment, never another artifact. */
-    select<Field extends keyof IArtifactIndex>(opts: {
-        indexes: IArtifactIndex[];
-        field: Field;
-        application: unknown;
-    }): Promise<NonNullable<IArtifactIndex[Field]>[number][]>;
-    private isSelected;
-}
-//# sourceMappingURL=artifact-index.d.ts.map

package/dist/cjs/base/applications/artifact-index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"artifact-index.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/artifact-index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAEV,cAAc,EAEd,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAGlB,+NAA+N;AAC/N,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,MAAM,CAAC,QAAQ,CAAC,mBAAmB,2BAA2B;IAE9D,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC,uMAAuM;IACvM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAOzC;IAEF,oNAAoN;IACpN,oBAAoB,IAAI,cAAc;IAsBtC,yHAAyH;IACnH,OAAO,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,mBAAmB,CAAC;QAC3B,WAAW,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IA0CrC;;;;OAIG;IACH,+BAA+B,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;KAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE;IAyE7F,iOAAiO;IACjO,OAAO,CAAC,aAAa;IAYrB,8JAA8J;IACxJ,OAAO,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,mBAAmB,CAAC;QAC3B,WAAW,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAyB7B,6KAA6K;YAC/J,SAAS;IAmBvB,4IAA4I;IAC5I,OAAO,CAAC,aAAa;IAMrB,mNAAmN;IAC7M,MAAM,CAAC,KAAK,SAAS,MAAM,cAAc,EAAE,IAAI,EAAE;QACrD,OAAO,EAAE,cAAc,EAAE,CAAC;QAC1B,KAAK,EAAE,KAAK,CAAC;QACb,WAAW,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YA+B3C,UAAU;CAWzB"}

package/dist/cjs/base/applications/artifact-index.js

@@ -1,238 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArtifactIndexHelper = void 0;
-const inversion_1 = require("../../helpers/inversion");
-const singleton_realm_1 = require("../../helpers/singleton-realm");
-const inversion_2 = require("../../helpers/inversion");
-const core_1 = require("@venizia/ignis-helpers/core");
-const artifact_group_1 = require("./artifact-group");
-const common_1 = require("./common");
-/** Turns a `configs.artifacts` input into the classes to register: flattens nested indexes, drops the classes whose `when` says no, orders the rest. It never touches the container - `registerArtifacts` does the binding. */
-class ArtifactIndexHelper extends core_1.BaseHelper {
-    static { this.SINGLETON_REALM_KEY = 'artifact-index-helper'; }
-    constructor() {
-        super({ scope: ArtifactIndexHelper.name });
-    }
-    static getInstance() {
-        return singleton_realm_1.SingletonRealm.resolve({
-            key: ArtifactIndexHelper.SINGLETON_REALM_KEY,
-            create: () => new ArtifactIndexHelper(),
-        });
-    }
-    /** Maps an artifact type to the index field that carries it. `ArtifactTypes.MODEL` is deliberately absent: a model has a binding namespace but no index field, because its repository registers it. */
-    static { this.INDEX_FIELD_BY_TYPE = {
-        [inversion_2.ArtifactTypes.CONFIGURATION]: common_1.ArtifactIndexFields.CONFIGURATIONS,
-        [inversion_2.ArtifactTypes.DATASOURCE]: common_1.ArtifactIndexFields.DATA_SOURCES,
-        [inversion_2.ArtifactTypes.COMPONENT]: common_1.ArtifactIndexFields.COMPONENTS,
-        [inversion_2.ArtifactTypes.REPOSITORY]: common_1.ArtifactIndexFields.REPOSITORIES,
-        [inversion_2.ArtifactTypes.SERVICE]: common_1.ArtifactIndexFields.SERVICES,
-        [inversion_2.ArtifactTypes.CONTROLLER]: common_1.ArtifactIndexFields.CONTROLLERS,
-    }; }
-    /** The index a decorator-only application has: every class a stereotype saw at import time, bucketed by its type. `when` and `order` still apply - `resolve` does that, exactly as it does for a declared index. */
-    buildDiscoveredIndex() {
-        const registry = inversion_1.MetadataRegistry.getInstance();
-        const index = {};
-        const discoveredArtifacts = registry.getDiscoveredArtifacts();
-        for (const target of discoveredArtifacts) {
-            if (!(0, inversion_2.isClass)(target)) {
-                continue;
-            }
-            const type = registry.getArtifactMetadata({ target })?.type;
-            const field = type ? ArtifactIndexHelper.INDEX_FIELD_BY_TYPE[type] : undefined;
-            if (!field) {
-                continue;
-            }
-            index[field] = [...(index[field] ?? []), target];
-        }
-        return index;
-    }
-    /** Every kind of the input, each already filtered by `when` and sorted by `order`, keyed the way `IArtifactIndex` is. */
-    async resolve(opts) {
-        const { input, application } = opts;
-        const indexes = await this.flatten({ input, application });
-        const rawConfigurations = await this.select({
-            indexes,
-            field: common_1.ArtifactIndexFields.CONFIGURATIONS,
-            application,
-        });
-        const configurations = this.sortConfigurationsTopologically({
-            classes: rawConfigurations,
-        });
-        const dataSources = await this.select({
-            indexes,
-            field: common_1.ArtifactIndexFields.DATA_SOURCES,
-            application,
-        });
-        const components = await this.select({
-            indexes,
-            field: common_1.ArtifactIndexFields.COMPONENTS,
-            application,
-        });
-        const repositories = await this.select({
-            indexes,
-            field: common_1.ArtifactIndexFields.REPOSITORIES,
-            application,
-        });
-        const services = await this.select({
-            indexes,
-            field: common_1.ArtifactIndexFields.SERVICES,
-            application,
-        });
-        const controllers = await this.select({
-            indexes,
-            field: common_1.ArtifactIndexFields.CONTROLLERS,
-            application,
-        });
-        return { configurations, dataSources, components, repositories, services, controllers };
-    }
-    /**
-     * Topologically sort configurations based on `after` dependencies.
-     * Siblings with no dependency relation are sorted deterministically by class name.
-     * Throws if an unknown `after` dependency is referenced or if a dependency cycle is detected.
-     */
-    sortConfigurationsTopologically(opts) {
-        const { classes } = opts;
-        if (classes.length === 0) {
-            return [];
-        }
-        const registry = inversion_1.MetadataRegistry.getInstance();
-        // Keyed by the class itself: two configurations may share a name (a minified build renames them),
-        // and a name-keyed graph silently drops one of them.
-        const inDegree = new Map();
-        const adjacency = new Map();
-        for (const target of classes) {
-            inDegree.set(target, 0);
-            adjacency.set(target, []);
-        }
-        for (const target of classes) {
-            const metadata = registry.getArtifactMetadata({ target });
-            const afterList = metadata?.after ?? [];
-            for (const prereq of afterList) {
-                // A string names a class, the only form that can; a class is matched by identity.
-                const prereqClass = typeof prereq === 'function'
-                    ? classes.find((candidate) => candidate === prereq)
-                    : classes.find((candidate) => candidate.name === String(prereq));
-                if (!prereqClass) {
-                    const prereqName = typeof prereq === 'function' ? prereq.name : String(prereq);
-                    throw (0, core_1.getError)({
-                        message: `[sortConfigurationsTopologically][${target.name}] Declared 'after' dependency '${prereqName}' is not registered as a configuration`,
-                    });
-                }
-                adjacency.get(prereqClass).push(target);
-                inDegree.set(target, (inDegree.get(target) ?? 0) + 1);
-            }
-        }
-        // Kahn's algorithm. Siblings run in class-name order; a minified build renames classes, so an
-        // order that matters belongs in `after`.
-        const byName = (a, b) => a.name.localeCompare(b.name);
-        const available = classes.filter((target) => inDegree.get(target) === 0).sort(byName);
-        const sorted = [];
-        while (available.length > 0) {
-            const current = available.shift();
-            sorted.push(current);
-            for (const dependent of adjacency.get(current) ?? []) {
-                const newDeg = inDegree.get(dependent) - 1;
-                inDegree.set(dependent, newDeg);
-                if (newDeg === 0) {
-                    available.push(dependent);
-                    available.sort(byName);
-                }
-            }
-        }
-        if (sorted.length !== classes.length) {
-            const unvisited = classes
-                .filter((target) => !sorted.includes(target))
-                .map((target) => target.name);
-            throw (0, core_1.getError)({
-                message: `[sortConfigurationsTopologically] Dependency cycle detected in configurations: ${unvisited.join(', ')}`,
-            });
-        }
-        return sorted;
-    }
-    /** Every entry of a kind must be a class. `undefined` is what an import cycle leaves - the index was read before a class's module finished loading - so it gets a message that names the cause instead of a crash on `.name`. */
-    assertClasses(opts) {
-        const position = (opts.classes ?? []).findIndex((target) => typeof target !== 'function');
-        if (position >= 0) {
-            throw (0, core_1.getError)({
-                message: `[ArtifactIndex] '${opts.field}' lists an entry that is not a class (position ${position}) | Usually an import cycle: the index was read before that class's module finished loading. The module that imports the index (or @venizia/ignis-boot/auto) must not define decorated classes or be imported by them`,
-            });
-        }
-    }
-    /** One index, or arrays nested to any depth, as a flat list in input order; a conditional entry contributes its subtree only when its `when` answers true. */
-    async flatten(opts) {
-        const { input, application } = opts;
-        if (artifact_group_1.ArtifactGroup.isGroup(input)) {
-            return this.flatten({ input: await this.contentOf({ group: input }), application });
-        }
-        if (Array.isArray(input)) {
-            const nested = await Promise.all(input.map((entry) => this.flatten({ input: entry, application })));
-            return nested.flat();
-        }
-        if (this.isConditional(input)) {
-            const isSelected = await input.when({ application });
-            if (!isSelected) {
-                this.logger.debug('Skipped by condition | conditional index entry');
-                return [];
-            }
-            return this.flatten({ input: input.index, application });
-        }
-        return [input];
-    }
-    /** A group's classes: inlined at build time, else the resolver `@venizia/ignis-boot/auto` installs. Never empty - a group that names nothing is a typo or a moved folder. */
-    async contentOf(opts) {
-        const { group } = opts;
-        const content = await artifact_group_1.ArtifactGroup.resolveContent({ group });
-        // One element type for the six kinds, so `.map` is callable on every member of the union.
-        for (const [field, classes] of Object.entries(content)) {
-            this.assertClasses({ field, classes });
-        }
-        const kinds = Object.values(content);
-        const names = kinds.flatMap((classes) => (classes ?? []).map((target) => target.name));
-        if (names.length === 0 && !group.kinds) {
-            throw (0, core_1.getError)({
-                message: `[ArtifactGroup] '${group.folder ?? '<application>'}' resolved to no class | Defined in ${group.site ?? 'an unknown module'} - check the folder name and that its classes carry a stereotype decorator`,
-            });
-        }
-        this.logger.info('[ArtifactGroup] %s -> %s', group.folder ?? '<application>', names.join(', '));
-        return content;
-    }
-    /** Positional on purpose: a type predicate narrows its own parameter, and an options object would narrow the wrapper instead of `input`. */
-    isConditional(entry) {
-        return 'when' in entry && 'index' in entry;
-    }
-    /** The classes of one kind across every index, minus those whose `when` says no, sorted by `order` (stable). The `when` conditions run concurrently: each reads config and environment, never another artifact. */
-    async select(opts) {
-        const { indexes, field, application } = opts;
-        const registry = inversion_1.MetadataRegistry.getInstance();
-        // De-duplicated: discovery and a declared index can name the same class, and registering it
-        // twice trips `bootChecks.binding.allowOverride: false`. First mention wins its position.
-        const listed = [...new Set(indexes.flatMap((index) => [...(index[field] ?? [])]))];
-        this.assertClasses({ field, classes: listed });
-        const decisions = await Promise.all(listed.map((target) => this.isSelected({ target, application })));
-        const kept = listed.filter((target, position) => {
-            if (decisions[position]) {
-                return true;
-            }
-            this.logger.debug('Skipped by condition | kind: %s | class: %s', field, target.name);
-            return false;
-        });
-        return kept
-            .map((target, position) => ({
-            target,
-            position,
-            order: registry.getArtifactMetadata({ target })?.order ?? 0,
-        }))
-            .sort((a, b) => a.order - b.order || a.position - b.position)
-            .map((entry) => entry.target);
-    }
-    async isSelected(opts) {
-        const { target, application } = opts;
-        const when = inversion_1.MetadataRegistry.getInstance().getArtifactMetadata({ target })?.when;
-        if (!when) {
-            return true;
-        }
-        return when({ application });
-    }
-}
-exports.ArtifactIndexHelper = ArtifactIndexHelper;
-//# sourceMappingURL=artifact-index.js.map

package/dist/cjs/base/applications/artifact-index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"artifact-index.js","sourceRoot":"","sources":["../../../../src/base/applications/artifact-index.ts"],"names":[],"mappings":"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","sourcesContent":["import { MetadataRegistry } from '@/helpers/inversion';\nimport { SingletonRealm } from '@/helpers/singleton-realm';\nimport type { AnyType, TClass } from '@venizia/ignis-helpers/common';\nimport { ArtifactTypes, isClass } from '@/helpers/inversion';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport { ArtifactGroup } from './artifact-group';\nimport type {\n  IArtifactGroup,\n  IArtifactIndex,\n  IConditionalArtifactIndex,\n  TArtifactIndexInput,\n} from './common';\nimport { ArtifactIndexFields } from './common';\n\n/** Turns a `configs.artifacts` input into the classes to register: flattens nested indexes, drops the classes whose `when` says no, orders the rest. It never touches the container - `registerArtifacts` does the binding. */\nexport class ArtifactIndexHelper extends BaseHelper {\n  static readonly SINGLETON_REALM_KEY = 'artifact-index-helper';\n\n  private constructor() {\n    super({ scope: ArtifactIndexHelper.name });\n  }\n\n  static getInstance(): ArtifactIndexHelper {\n    return SingletonRealm.resolve({\n      key: ArtifactIndexHelper.SINGLETON_REALM_KEY,\n      create: () => new ArtifactIndexHelper(),\n    });\n  }\n\n  /** Maps an artifact type to the index field that carries it. `ArtifactTypes.MODEL` is deliberately absent: a model has a binding namespace but no index field, because its repository registers it. */\n  private static readonly INDEX_FIELD_BY_TYPE: Record<string, string> = {\n    [ArtifactTypes.CONFIGURATION]: ArtifactIndexFields.CONFIGURATIONS,\n    [ArtifactTypes.DATASOURCE]: ArtifactIndexFields.DATA_SOURCES,\n    [ArtifactTypes.COMPONENT]: ArtifactIndexFields.COMPONENTS,\n    [ArtifactTypes.REPOSITORY]: ArtifactIndexFields.REPOSITORIES,\n    [ArtifactTypes.SERVICE]: ArtifactIndexFields.SERVICES,\n    [ArtifactTypes.CONTROLLER]: ArtifactIndexFields.CONTROLLERS,\n  };\n\n  /** The index a decorator-only application has: every class a stereotype saw at import time, bucketed by its type. `when` and `order` still apply - `resolve` does that, exactly as it does for a declared index. */\n  buildDiscoveredIndex(): IArtifactIndex {\n    const registry = MetadataRegistry.getInstance();\n    const index: Record<string, TClass<AnyType>[]> = {};\n\n    const discoveredArtifacts = registry.getDiscoveredArtifacts();\n    for (const target of discoveredArtifacts) {\n      if (!isClass<AnyType>(target)) {\n        continue;\n      }\n\n      const type = registry.getArtifactMetadata({ target })?.type;\n      const field = type ? ArtifactIndexHelper.INDEX_FIELD_BY_TYPE[type] : undefined;\n      if (!field) {\n        continue;\n      }\n\n      index[field] = [...(index[field] ?? []), target];\n    }\n\n    return index;\n  }\n\n  /** Every kind of the input, each already filtered by `when` and sorted by `order`, keyed the way `IArtifactIndex` is. */\n  async resolve(opts: {\n    input: TArtifactIndexInput;\n    application: unknown;\n  }): Promise<Required<IArtifactIndex>> {\n    const { input, application } = opts;\n    const indexes = await this.flatten({ input, application });\n\n    const rawConfigurations = await this.select({\n      indexes,\n      field: ArtifactIndexFields.CONFIGURATIONS,\n      application,\n    });\n    const configurations = this.sortConfigurationsTopologically({\n      classes: rawConfigurations,\n    });\n\n    const dataSources = await this.select({\n      indexes,\n      field: ArtifactIndexFields.DATA_SOURCES,\n      application,\n    });\n    const components = await this.select({\n      indexes,\n      field: ArtifactIndexFields.COMPONENTS,\n      application,\n    });\n    const repositories = await this.select({\n      indexes,\n      field: ArtifactIndexFields.REPOSITORIES,\n      application,\n    });\n    const services = await this.select({\n      indexes,\n      field: ArtifactIndexFields.SERVICES,\n      application,\n    });\n    const controllers = await this.select({\n      indexes,\n      field: ArtifactIndexFields.CONTROLLERS,\n      application,\n    });\n\n    return { configurations, dataSources, components, repositories, services, controllers };\n  }\n\n  /**\n   * Topologically sort configurations based on `after` dependencies.\n   * Siblings with no dependency relation are sorted deterministically by class name.\n   * Throws if an unknown `after` dependency is referenced or if a dependency cycle is detected.\n   */\n  sortConfigurationsTopologically(opts: { classes: ReadonlyArray<TClass<any>> }): TClass<any>[] {\n    const { classes } = opts;\n    if (classes.length === 0) {\n      return [];\n    }\n\n    const registry = MetadataRegistry.getInstance();\n\n    // Keyed by the class itself: two configurations may share a name (a minified build renames them),\n    // and a name-keyed graph silently drops one of them.\n    const inDegree = new Map<TClass<any>, number>();\n    const adjacency = new Map<TClass<any>, TClass<any>[]>();\n\n    for (const target of classes) {\n      inDegree.set(target, 0);\n      adjacency.set(target, []);\n    }\n\n    for (const target of classes) {\n      const metadata = registry.getArtifactMetadata({ target });\n      const afterList = metadata?.after ?? [];\n\n      for (const prereq of afterList) {\n        // A string names a class, the only form that can; a class is matched by identity.\n        const prereqClass =\n          typeof prereq === 'function'\n            ? classes.find((candidate) => candidate === prereq)\n            : classes.find((candidate) => candidate.name === String(prereq));\n\n        if (!prereqClass) {\n          const prereqName = typeof prereq === 'function' ? prereq.name : String(prereq);\n          throw getError({\n            message: `[sortConfigurationsTopologically][${target.name}] Declared 'after' dependency '${prereqName}' is not registered as a configuration`,\n          });\n        }\n\n        adjacency.get(prereqClass)!.push(target);\n        inDegree.set(target, (inDegree.get(target) ?? 0) + 1);\n      }\n    }\n\n    // Kahn's algorithm. Siblings run in class-name order; a minified build renames classes, so an\n    // order that matters belongs in `after`.\n    const byName = (a: TClass<any>, b: TClass<any>) => a.name.localeCompare(b.name);\n    const available = classes.filter((target) => inDegree.get(target) === 0).sort(byName);\n    const sorted: TClass<any>[] = [];\n\n    while (available.length > 0) {\n      const current = available.shift()!;\n      sorted.push(current);\n\n      for (const dependent of adjacency.get(current) ?? []) {\n        const newDeg = inDegree.get(dependent)! - 1;\n        inDegree.set(dependent, newDeg);\n        if (newDeg === 0) {\n          available.push(dependent);\n          available.sort(byName);\n        }\n      }\n    }\n\n    if (sorted.length !== classes.length) {\n      const unvisited = classes\n        .filter((target) => !sorted.includes(target))\n        .map((target) => target.name);\n      throw getError({\n        message: `[sortConfigurationsTopologically] Dependency cycle detected in configurations: ${unvisited.join(', ')}`,\n      });\n    }\n\n    return sorted;\n  }\n\n  /** Every entry of a kind must be a class. `undefined` is what an import cycle leaves - the index was read before a class's module finished loading - so it gets a message that names the cause instead of a crash on `.name`. */\n  private assertClasses(opts: {\n    field: string;\n    classes: ReadonlyArray<unknown> | undefined;\n  }): void {\n    const position = (opts.classes ?? []).findIndex((target) => typeof target !== 'function');\n    if (position >= 0) {\n      throw getError({\n        message: `[ArtifactIndex] '${opts.field}' lists an entry that is not a class (position ${position}) | Usually an import cycle: the index was read before that class's module finished loading. The module that imports the index (or @venizia/ignis-boot/auto) must not define decorated classes or be imported by them`,\n      });\n    }\n  }\n\n  /** One index, or arrays nested to any depth, as a flat list in input order; a conditional entry contributes its subtree only when its `when` answers true. */\n  async flatten(opts: {\n    input: TArtifactIndexInput;\n    application: unknown;\n  }): Promise<IArtifactIndex[]> {\n    const { input, application } = opts;\n    if (ArtifactGroup.isGroup(input)) {\n      return this.flatten({ input: await this.contentOf({ group: input }), application });\n    }\n    if (Array.isArray(input)) {\n      const nested = await Promise.all(\n        input.map((entry) => this.flatten({ input: entry, application })),\n      );\n      return nested.flat();\n    }\n\n    if (this.isConditional(input)) {\n      const isSelected = await input.when({ application });\n      if (!isSelected) {\n        this.logger.debug('Skipped by condition | conditional index entry');\n        return [];\n      }\n\n      return this.flatten({ input: input.index, application });\n    }\n\n    return [input];\n  }\n\n  /** A group's classes: inlined at build time, else the resolver `@venizia/ignis-boot/auto` installs. Never empty - a group that names nothing is a typo or a moved folder. */\n  private async contentOf(opts: { group: IArtifactGroup }): Promise<IArtifactIndex> {\n    const { group } = opts;\n    const content = await ArtifactGroup.resolveContent({ group });\n\n    // One element type for the six kinds, so `.map` is callable on every member of the union.\n    for (const [field, classes] of Object.entries(content)) {\n      this.assertClasses({ field, classes });\n    }\n    const kinds: Array<ReadonlyArray<TClass<unknown>> | undefined> = Object.values(content);\n    const names = kinds.flatMap((classes) => (classes ?? []).map((target) => target.name));\n    if (names.length === 0 && !group.kinds) {\n      throw getError({\n        message: `[ArtifactGroup] '${group.folder ?? '<application>'}' resolved to no class | Defined in ${group.site ?? 'an unknown module'} - check the folder name and that its classes carry a stereotype decorator`,\n      });\n    }\n    this.logger.info('[ArtifactGroup] %s -> %s', group.folder ?? '<application>', names.join(', '));\n    return content;\n  }\n\n  /** Positional on purpose: a type predicate narrows its own parameter, and an options object would narrow the wrapper instead of `input`. */\n  private isConditional(\n    entry: IArtifactIndex | IConditionalArtifactIndex,\n  ): entry is IConditionalArtifactIndex {\n    return 'when' in entry && 'index' in entry;\n  }\n\n  /** The classes of one kind across every index, minus those whose `when` says no, sorted by `order` (stable). The `when` conditions run concurrently: each reads config and environment, never another artifact. */\n  async select<Field extends keyof IArtifactIndex>(opts: {\n    indexes: IArtifactIndex[];\n    field: Field;\n    application: unknown;\n  }): Promise<NonNullable<IArtifactIndex[Field]>[number][]> {\n    const { indexes, field, application } = opts;\n    const registry = MetadataRegistry.getInstance();\n\n    // De-duplicated: discovery and a declared index can name the same class, and registering it\n    // twice trips `bootChecks.binding.allowOverride: false`. First mention wins its position.\n    const listed = [...new Set(indexes.flatMap((index) => [...(index[field] ?? [])]))];\n    this.assertClasses({ field, classes: listed });\n    const decisions = await Promise.all(\n      listed.map((target) => this.isSelected({ target, application })),\n    );\n\n    const kept = listed.filter((target, position) => {\n      if (decisions[position]) {\n        return true;\n      }\n\n      this.logger.debug('Skipped by condition | kind: %s | class: %s', field, target.name);\n      return false;\n    });\n\n    return kept\n      .map((target, position) => ({\n        target,\n        position,\n        order: registry.getArtifactMetadata({ target })?.order ?? 0,\n      }))\n      .sort((a, b) => a.order - b.order || a.position - b.position)\n      .map((entry) => entry.target);\n  }\n\n  private async isSelected(opts: {\n    target: TClass<unknown>;\n    application: unknown;\n  }): Promise<boolean> {\n    const { target, application } = opts;\n    const when = MetadataRegistry.getInstance().getArtifactMetadata({ target })?.when;\n    if (!when) {\n      return true;\n    }\n    return when({ application });\n  }\n}\n"]}

package/dist/cjs/base/applications/boot-sequence.d.ts

@@ -1,33 +0,0 @@
-import type { TConstValue, ValueOrPromise } from '@venizia/ignis-helpers/common';
-/** The step names the kernel defines - the vocabulary a subclass targets with `BootSequence.insertAfter`. A server application adds its own on top (`ServerBootSteps` in `@venizia/ignis`). */
-export declare class BootSteps {
-    static readonly STATIC_CONFIGURE = "staticConfigure";
-    static readonly REGISTER_ARTIFACTS = "registerArtifacts";
-    static readonly PRE_CONFIGURE = "preConfigure";
-    static readonly REGISTER_DEFAULT_MIDDLEWARES = "registerDefaultMiddlewares";
-    static readonly REGISTER_CONFIGURATIONS = "registerConfigurations";
-    static readonly REGISTER_DATA_SOURCES = "registerDataSources";
-    static readonly REGISTER_COMPONENTS = "registerComponents";
-    static readonly REGISTER_CONTRIBUTED_DATA_SOURCES = "registerContributedDataSources";
-    static readonly REGISTER_CONTROLLERS = "registerControllers";
-    static readonly POST_CONFIGURE = "postConfigure";
-    static readonly VERIFY_BINDINGS = "verifyBindings";
-    static readonly SCHEME_SET: Set<string>;
-    static isValid(value: string): boolean;
-}
-export type TBootStep = TConstValue<typeof BootSteps>;
-export interface IBootSequenceStep {
-    name: string;
-    run: () => ValueOrPromise<void>;
-}
-/** Composes a boot sequence by name instead of copying the array - a subclass reads exactly what it adds by reading its own override, without diffing two files by eye. */
-export declare class BootSequence {
-    /** A duplicated name is refused as loudly as a missing one - picking the first match would splice a step into the wrong place silently. */
-    private static indexOf;
-    static insertAfter(opts: {
-        steps: IBootSequenceStep[];
-        target: string;
-        step: IBootSequenceStep;
-    }): IBootSequenceStep[];
-}
-//# sourceMappingURL=boot-sequence.d.ts.map

package/dist/cjs/base/applications/boot-sequence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"boot-sequence.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/boot-sequence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGjF,+LAA+L;AAC/L,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,gBAAgB,qBAAqB;IACrD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,uBAAuB;IACzD,MAAM,CAAC,QAAQ,CAAC,aAAa,kBAAkB;IAC/C,MAAM,CAAC,QAAQ,CAAC,4BAA4B,gCAAgC;IAC5E,MAAM,CAAC,QAAQ,CAAC,uBAAuB,4BAA4B;IACnE,MAAM,CAAC,QAAQ,CAAC,qBAAqB,yBAAyB;IAC9D,MAAM,CAAC,QAAQ,CAAC,mBAAmB,wBAAwB;IAC3D,MAAM,CAAC,QAAQ,CAAC,iCAAiC,oCAAoC;IACrF,MAAM,CAAC,QAAQ,CAAC,oBAAoB,yBAAyB;IAC7D,MAAM,CAAC,QAAQ,CAAC,cAAc,mBAAmB;IACjD,MAAM,CAAC,QAAQ,CAAC,eAAe,oBAAoB;IACnD,MAAM,CAAC,QAAQ,CAAC,UAAU,cAYvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,SAAS,CAAC,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,2KAA2K;AAC3K,qBAAa,YAAY;IACvB,2IAA2I;IAC3I,OAAO,CAAC,MAAM,CAAC,OAAO;IAsBtB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QACvB,KAAK,EAAE,iBAAiB,EAAE,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,iBAAiB,CAAC;KACzB,GAAG,iBAAiB,EAAE;CAMxB"}