@venizia/ignis-boot 0.2.1-1 → 0.2.1-10

package/dist/cjs/vite/plugin.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IgnisArtifactsVitePlugin = void 0;
+const node_path_1 = require("node:path");
+const generator_1 = require("../generator");
+const plugin_1 = require("../bun/plugin");
+const sources_1 = require("../bun/sources");
+/** `IgnisArtifactsPlugin` for Vite: serves `ignis:artifacts`, replaces `@venizia/ignis-boot/auto` with an eager import of it (a browser bundle is tree-shaken only when eager), and inlines every `ArtifactGroup.define` / `application` call. Names are kept in the build, because binding keys are built from `Class.name` and a minifier renames classes. */
+class IgnisArtifactsVitePlugin {
+    static { this.RESOLVED_VIRTUAL = `\0${plugin_1.IgnisArtifactsPlugin.VIRTUAL}`; }
+    static {
+        sources_1.ArtifactSources.useScanner({ scanner: generator_1.ArtifactScanner.getInstance() });
+    }
+    /** `root`: the `src` to scan (default: the one beside the `package.json` of Vite's root). */
+    static create(opts = {}) {
+        let root = opts.root ? (0, node_path_1.resolve)(opts.root) : '';
+        let groupFiles = new Set();
+        const autoModule = `import { ${plugin_1.IgnisArtifactsPlugin.EXPORT_NAME} } from '${plugin_1.IgnisArtifactsPlugin.VIRTUAL}';\nimport { AutoArtifactGroup } from './auto-group';\nexport default new AutoArtifactGroup({ content: ${plugin_1.IgnisArtifactsPlugin.EXPORT_NAME} });\n`;
+        return {
+            name: plugin_1.IgnisArtifactsPlugin.NAME,
+            enforce: 'pre',
+            // Pre-bundling would hide `auto` inside a dependency chunk, out of reach of `load`.
+            config: () => ({
+                optimizeDeps: { exclude: ['@venizia/ignis-boot'] },
+                build: { rolldownOptions: { output: { keepNames: true } } },
+            }),
+            configResolved: config => {
+                root ||= sources_1.ArtifactSources.packageSource({ from: config.root });
+                groupFiles = new Set(plugin_1.IgnisArtifactsPlugin.groupDefinitionFiles({ root }));
+            },
+            resolveId: id => id === plugin_1.IgnisArtifactsPlugin.VIRTUAL ? IgnisArtifactsVitePlugin.RESOLVED_VIRTUAL : undefined,
+            load: id => {
+                if (id === IgnisArtifactsVitePlugin.RESOLVED_VIRTUAL) {
+                    return plugin_1.IgnisArtifactsPlugin.render({ root });
+                }
+                return plugin_1.IgnisArtifactsPlugin.AUTO_MODULE.test(id) ? autoModule : undefined;
+            },
+            transform: (code, id) => groupFiles.has(id)
+                ? plugin_1.IgnisArtifactsPlugin.rewriteGroups({ filePath: id, source: code })
+                : undefined,
+            // A file added, removed or edited under the root can change the index: rescan on the next load.
+            watchChange: id => {
+                if (id.startsWith(root)) {
+                    sources_1.ArtifactSources.clear();
+                }
+            },
+        };
+    }
+}
+exports.IgnisArtifactsVitePlugin = IgnisArtifactsVitePlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/cjs/vite/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/vite/plugin.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AACpC,4CAA+C;AAC/C,0CAAqD;AACrD,4CAAiD;AAiBjD,gWAAgW;AAChW,MAAa,wBAAwB;aACnB,qBAAgB,GAAG,KAAK,6BAAoB,CAAC,OAAO,EAAE,CAAC;IAEvE;QACE,yBAAe,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,2BAAe,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,6FAA6F;IAC7F,MAAM,CAAC,MAAM,CAAC,OAA0B,EAAE;QACxC,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,mBAAO,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,IAAI,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,MAAM,UAAU,GAAG,YAAY,6BAAoB,CAAC,WAAW,YAAY,6BAAoB,CAAC,OAAO,0GAA0G,6BAAoB,CAAC,WAAW,QAAQ,CAAC;QAE1P,OAAO;YACL,IAAI,EAAE,6BAAoB,CAAC,IAAI;YAC/B,OAAO,EAAE,KAAK;YACd,oFAAoF;YACpF,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;gBACb,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,qBAAqB,CAAC,EAAE;gBAClD,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE;aAC5D,CAAC;YACF,cAAc,EAAE,MAAM,CAAC,EAAE;gBACvB,IAAI,KAAK,yBAAe,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC9D,UAAU,GAAG,IAAI,GAAG,CAAC,6BAAoB,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5E,CAAC;YACD,SAAS,EAAE,EAAE,CAAC,EAAE,CACd,EAAE,KAAK,6BAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;YAC7F,IAAI,EAAE,EAAE,CAAC,EAAE;gBACT,IAAI,EAAE,KAAK,wBAAwB,CAAC,gBAAgB,EAAE,CAAC;oBACrD,OAAO,6BAAoB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/C,CAAC;gBACD,OAAO,6BAAoB,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5E,CAAC;YACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CACtB,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChB,CAAC,CAAC,6BAAoB,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACpE,CAAC,CAAC,SAAS;YACf,gGAAgG;YAChG,WAAW,EAAE,EAAE,CAAC,EAAE;gBAChB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxB,yBAAe,CAAC,KAAK,EAAE,CAAC;gBAC1B,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;;AA5CH,4DA6CC"}

package/dist/esm/bun/auto-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-group.d.ts","sourceRoot":"","sources":["../../../src/bun/auto-group.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE5D,+RAA+R;AAC/R,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,eAAe,EAAG,IAAI,CAAU;IACzC,QAAQ,CAAC,MAAM,YAAa;IAC5B,QAAQ,CAAC,IAAI,YAAa;IAC1B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuD;gBAEpE,IAAI,EAAE;QAChB,OAAO,CAAC,EAAE,uBAAuB,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;KAClD;IAKK,OAAO,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAYjD,OAAO,CAAC,MAAM,CAAC,UAAU;IAOzB,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;CACF"}
+{"version":3,"file":"auto-group.d.ts","sourceRoot":"","sources":["../../../src/bun/auto-group.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE5D,+RAA+R;AAC/R,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,eAAe,EAAG,IAAI,CAAU;IACzC,QAAQ,CAAC,MAAM,YAAa;IAC5B,QAAQ,CAAC,IAAI,YAAa;IAC1B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuD;gBAEpE,IAAI,EAAE;QAChB,OAAO,CAAC,EAAE,uBAAuB,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;KAClD;IAKK,OAAO,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAYjD,OAAO,CAAC,MAAM,CAAC,UAAU;IAOzB,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;CACF"}

package/dist/esm/bun/auto-group.js

@@ -1,4 +1,5 @@
-import { getError } from '@venizia/ignis-helpers';
+// The inversion package, not the helpers barrel: a browser bundle reaches this module, and the barrel loads node builtins.
+import { getError } from '@venizia/ignis-inversion';
 /** The application's own artifacts as the kernel's group protocol (`isArtifactGroup`), built without depending on the kernel: inlined `content` in a binary, `resolve()` from source. Reading a kind throws, so a function that walks `configs.artifacts` cannot drop it as an empty index. */
 export class AutoArtifactGroup {
     constructor(opts) {

package/dist/esm/bun/auto-group.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-group.js","sourceRoot":"","sources":["../../../src/bun/auto-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,+RAA+R;AAC/R,MAAM,OAAO,iBAAiB;IAO5B,YAAY,IAGX;QATQ,oBAAe,GAAG,IAAa,CAAC;QAChC,WAAM,GAAG,SAAS,CAAC;QACnB,SAAI,GAAG,SAAS,CAAC;QAQxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,8EAA8E;aACxF,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,UAAU;QACvB,MAAM,QAAQ,CAAC;YACb,OAAO,EACL,sOAAsO;SACzO,CAAC,CAAC;IACL,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;CACF"}
+{"version":3,"file":"auto-group.js","sourceRoot":"","sources":["../../../src/bun/auto-group.ts"],"names":[],"mappings":"AAAA,2HAA2H;AAC3H,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,+RAA+R;AAC/R,MAAM,OAAO,iBAAiB;IAO5B,YAAY,IAGX;QATQ,oBAAe,GAAG,IAAa,CAAC;QAChC,WAAM,GAAG,SAAS,CAAC;QACnB,SAAI,GAAG,SAAS,CAAC;QAQxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,8EAA8E;aACxF,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,UAAU;QACvB,MAAM,QAAQ,CAAC;YACb,OAAO,EACL,sOAAsO;SACzO,CAAC,CAAC;IACL,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/esm/bun/auto-loader.d.ts

@@ -1,9 +1,13 @@
-import type { TGeneratedArtifactIndex } from '../generator/index.js';
+import { type IScannedArtifact, type TGeneratedArtifactIndex } from '../generator/common/index.js';
 /** Loads the application's index for `@venizia/ignis-boot/auto` from source: registers the run-time plugin, then imports the virtual module. A binary never runs this - the build replaces the module. */
 export declare class AutoArtifactsLoader {
     static assertRuntime(opts: {
         hasBun: boolean;
     }): void;
     static load(): Promise<TGeneratedArtifactIndex>;
+    /** The index the emitter would render for `artifacts`: modules imported in path order, each field sorted by class name. */
+    static importIndex(opts: {
+        artifacts: IScannedArtifact[];
+    }): Promise<TGeneratedArtifactIndex>;
 }
 //# sourceMappingURL=auto-loader.d.ts.map

package/dist/esm/bun/auto-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-loader.d.ts","sourceRoot":"","sources":["../../../src/bun/auto-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE5D,0MAA0M;AAC1M,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;WASxC,IAAI,IAAI,OAAO,CAAC,uBAAuB,CAAC;CAYtD"}
+{"version":3,"file":"auto-loader.d.ts","sourceRoot":"","sources":["../../../src/bun/auto-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAG7B,0MAA0M;AAC1M,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;WASxC,IAAI,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAyBrD,2HAA2H;WAC9G,WAAW,CAAC,IAAI,EAAE;QAC7B,SAAS,EAAE,gBAAgB,EAAE,CAAC;KAC/B,GAAG,OAAO,CAAC,uBAAuB,CAAC;CA2BrC"}

package/dist/esm/bun/auto-loader.js

@@ -1,4 +1,7 @@
 import { getError } from '@venizia/ignis-helpers';
+import { dirname } from 'node:path';
+import { ArtifactStereotypes, ArtifactTypes, } from '../generator/common/index.js';
+import { ArtifactSources } from './sources.js';
 /** Loads the application's index for `@venizia/ignis-boot/auto` from source: registers the run-time plugin, then imports the virtual module. A binary never runs this - the build replaces the module. */
 export class AutoArtifactsLoader {
     static assertRuntime(opts) {
@@ -10,6 +13,17 @@ export class AutoArtifactsLoader {
     }
     static async load() {
         AutoArtifactsLoader.assertRuntime({ hasBun: typeof Bun !== 'undefined' });
+        // A warm scan cache needs neither the plugin nor TypeScript: import the listed classes directly.
+        const entry = ArtifactSources.entry();
+        const packageSource = ArtifactSources.packageSource({
+            from: entry ? dirname(entry) : process.cwd(),
+        });
+        if (ArtifactSources.isCached({ packageSource })) {
+            const artifacts = ArtifactSources.scan({ packageSource });
+            return AutoArtifactsLoader.importIndex({
+                artifacts: entry ? ArtifactSources.runningArtifacts({ artifacts, from: entry }) : artifacts,
+            });
+        }
         // A non-static specifier: a bundler must not pull the scanner (and TypeScript) into a binary.
         const pluginModule = './plugin';
         const { IgnisArtifactsPlugin } = await import(pluginModule);
@@ -18,5 +32,28 @@ export class AutoArtifactsLoader {
         const { GeneratedArtifacts } = await import('ignis:artifacts');
         return GeneratedArtifacts;
     }
+    /** The index the emitter would render for `artifacts`: modules imported in path order, each field sorted by class name. */
+    static async importIndex(opts) {
+        const emitted = opts.artifacts
+            .filter(artifact => artifact.type !== ArtifactTypes.MODEL)
+            .sort((left, right) => left.filePath.localeCompare(right.filePath) ||
+            left.className.localeCompare(right.className));
+        const loaded = new Map();
+        for (const artifact of emitted) {
+            const module = await import(artifact.filePath);
+            loaded.set(artifact, module[artifact.className]);
+        }
+        const index = {};
+        for (const { type, field } of ArtifactStereotypes.EMIT_ORDER) {
+            const classes = emitted
+                .filter(artifact => artifact.type === type)
+                .sort((left, right) => left.className.localeCompare(right.className))
+                .flatMap(artifact => loaded.get(artifact) ?? []);
+            if (classes.length > 0) {
+                index[field] = classes;
+            }
+        }
+        return index;
+    }
 }
 //# sourceMappingURL=auto-loader.js.map

package/dist/esm/bun/auto-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-loader.js","sourceRoot":"","sources":["../../../src/bun/auto-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,0MAA0M;AAC1M,MAAM,OAAO,mBAAmB;IAC9B,MAAM,CAAC,aAAa,CAAC,IAAyB;QAC5C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,QAAQ,CAAC;gBACb,OAAO,EACL,sNAAsN;aACzN,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI;QACf,mBAAmB,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,WAAW,EAAE,CAAC,CAAC;QAE1E,8FAA8F;QAC9F,MAAM,YAAY,GAAG,UAAU,CAAC;QAChC,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAC5D,MAAM,oBAAoB,CAAC,eAAe,EAAE,CAAC;QAE7C,8IAA8I;QAC9I,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC/D,OAAO,kBAAkB,CAAC;IAC5B,CAAC;CACF"}
+{"version":3,"file":"auto-loader.js","sourceRoot":"","sources":["../../../src/bun/auto-loader.ts"],"names":[],"mappings":"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"}

package/dist/esm/bun/group-resolver.d.ts

@@ -1,4 +1,4 @@
-import { type TGeneratedArtifactIndex } from '../generator/index.js';
+import { type TGeneratedArtifactIndex } from '../generator/common/index.js';
 /** Fills an `ArtifactGroup` defined without content, from source: the defining package is the nearest `package.json` above the group's call site, and the group is every decorated class under a directory named `folder` in its `src`. */
 export declare class GroupArtifactsResolver {
     /** The kernel's `SingletonRealm` slot for the group resolver (`ArtifactGroup.SINGLETON_REALM_KEY`). */
@@ -7,6 +7,7 @@ export declare class GroupArtifactsResolver {
         group: {
             folder: string | undefined;
             site: string | undefined;
+            ignore?: ReadonlyArray<string>;
         };
     }): Promise<TGeneratedArtifactIndex>;
     /** Fills the kernel's realm slot; the holder may already exist (the kernel created it empty), so it is mutated, never replaced. */

package/dist/esm/bun/group-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"group-resolver.d.ts","sourceRoot":"","sources":["../../../src/bun/group-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGjF,2OAA2O;AAC3O,qBAAa,sBAAsB;IACjC,uGAAuG;IACvG,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAA+D;WAE5E,OAAO,CAAC,IAAI,EAAE;QACzB,KAAK,EAAE;YAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;YAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;SAAE,CAAC;KACjE,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAsBpC,mIAAmI;IACnI,MAAM,CAAC,OAAO,IAAI,IAAI;CASvB"}
+{"version":3,"file":"group-resolver.d.ts","sourceRoot":"","sources":["../../../src/bun/group-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAIxF,2OAA2O;AAC3O,qBAAa,sBAAsB;IACjC,uGAAuG;IACvG,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAA+D;WAE5E,OAAO,CAAC,IAAI,EAAE;QACzB,KAAK,EAAE;YACL,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;YAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;YACzB,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;SAChC,CAAC;KACH,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA8BpC,mIAAmI;IACnI,MAAM,CAAC,OAAO,IAAI,IAAI;CAavB"}

package/dist/esm/bun/group-resolver.js

@@ -1,19 +1,25 @@
 import { getError } from '@venizia/ignis-helpers';
-import { ArtifactStereotypes } from '../generator/index.js';
+import { ArtifactStereotypes } from '../generator/common/index.js';
+import { dirname } from 'node:path';
 import { ArtifactSources } from './sources.js';
 /** Fills an `ArtifactGroup` defined without content, from source: the defining package is the nearest `package.json` above the group's call site, and the group is every decorated class under a directory named `folder` in its `src`. */
 export class GroupArtifactsResolver {
     /** The kernel's `SingletonRealm` slot for the group resolver (`ArtifactGroup.SINGLETON_REALM_KEY`). */
     static { this.REALM_SLOT = Symbol.for('@venizia/ignis-kernel:artifact-group-resolver'); }
     static async resolve(opts) {
-        const { folder, site } = opts.group;
-        if (!folder || !site) {
+        const { folder, site, ignore } = opts.group;
+        if (!site) {
             throw getError({
                 message: `[ArtifactGroup] '${folder ?? '<application>'}' has no call site to resolve from | Define it with ArtifactGroup.define in the shared package's own source`,
             });
         }
+        if (!ArtifactSources.isCached({
+            packageSource: ArtifactSources.packageSource({ from: dirname(site) }),
+        })) {
+            await ArtifactSources.loadScanner();
+        }
         const index = {};
-        for (const artifact of ArtifactSources.folderArtifacts({ folder, site })) {
+        for (const artifact of ArtifactSources.folderArtifacts({ folder, site, ignore })) {
             const field = ArtifactStereotypes.EMIT_ORDER.find(entry => entry.type === artifact.type)?.field;
             if (!field) {
                 continue;

package/dist/esm/bun/group-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"group-resolver.js","sourceRoot":"","sources":["../../../src/bun/group-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAgC,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,2OAA2O;AAC3O,MAAM,OAAO,sBAAsB;IACjC,uGAAuG;aACvF,eAAU,GAAG,MAAM,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAEzF,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAEpB;QACC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACpC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACrB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,oBAAoB,MAAM,IAAI,eAAe,6GAA6G;aACpK,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAA2C,EAAE,CAAC;QACzD,KAAK,MAAM,QAAQ,IAAI,eAAe,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACzE,MAAM,KAAK,GAAG,mBAAmB,CAAC,UAAU,CAAC,IAAI,CAC/C,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CACtC,EAAE,KAAK,CAAC;YACT,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC/C,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,mIAAmI;IACnI,MAAM,CAAC,OAAO;QACZ,MAAM,QAAQ,GAAY,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;QACrF,MAAM,MAAM,GACV,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,CAAC,OAAO,GAAG,CAAC,WAEjB,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC"}
+{"version":3,"file":"group-resolver.js","sourceRoot":"","sources":["../../../src/bun/group-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAgC,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,2OAA2O;AAC3O,MAAM,OAAO,sBAAsB;IACjC,uGAAuG;aACvF,eAAU,GAAG,MAAM,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAEzF,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAMpB;QACC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,oBAAoB,MAAM,IAAI,eAAe,6GAA6G;aACpK,CAAC,CAAC;QACL,CAAC;QAED,IACE,CAAC,eAAe,CAAC,QAAQ,CAAC;YACxB,aAAa,EAAE,eAAe,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;SACtE,CAAC,EACF,CAAC;YACD,MAAM,eAAe,CAAC,WAAW,EAAE,CAAC;QACtC,CAAC;QAED,MAAM,KAAK,GAA2C,EAAE,CAAC;QACzD,KAAK,MAAM,QAAQ,IAAI,eAAe,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACjF,MAAM,KAAK,GAAG,mBAAmB,CAAC,UAAU,CAAC,IAAI,CAC/C,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CACtC,EAAE,KAAK,CAAC;YACT,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC/C,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,mIAAmI;IACnI,MAAM,CAAC,OAAO;QACZ,MAAM,QAAQ,GAAY,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;QACrF,MAAM,MAAM,GACV,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,CAAC,OAAO,GAAG,CAAC,WAMjB,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC"}

package/dist/esm/bun/index.d.ts

@@ -2,5 +2,6 @@ export * from './auto-group.js';
 export * from './auto-loader.js';
 export * from './group-resolver.js';
 export * from './plugin.js';
+export * from './scan-cache.js';
 export * from './sources.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/bun/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bun/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bun/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/esm/bun/index.js

@@ -2,5 +2,6 @@ export * from './auto-group.js';
 export * from './auto-loader.js';
 export * from './group-resolver.js';
 export * from './plugin.js';
+export * from './scan-cache.js';
 export * from './sources.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/bun/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/bun/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/bun/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/esm/bun/plugin.d.ts

@@ -9,15 +9,18 @@ export declare class IgnisArtifactsPlugin {
     /** A text test for a file worth parsing: `ArtifactGroup.define(`, with any spacing or line break around the dot. */
     static readonly DEFINE_CALL: RegExp;
     private static readonly RUNTIME_KEY;
-    /** The `src` beside the nearest `package.json` at or above `from` (default: the working directory). */
+    /** The `src` beside the nearest `package.json` at or above `from` (default: the entry module's directory). */
     static defaultRoot(opts?: {
         from?: string;
     }): string;
-    /** The index as module source: every import absolute, since a virtual module has no directory to resolve from. */
+    /** The entry module's directory (`Bun.main`), so the root never depends on where the process was started; the working directory only when there is no entry file (`bun -e`, a REPL). */
+    static entryDirectory(): string;
+    /** The index as module source: every import absolute, since a virtual module has no directory to resolve from. With `entry` in a compiled tree, each class is imported from that tree (`ArtifactSources.runningArtifacts`). */
     static render(opts: {
         root: string;
+        entry?: string;
     }): string;
-    /** Rewrites every `ArtifactGroup.define({ folder: '<literal>' })` in a source file to carry its classes as `content`, imported by absolute path - a binary then holds each group's list and never scans. A folder with no decorated class, or a define the plugin cannot read (an aliased `ArtifactGroup`, a folder that is not a string literal), fails the build. */
+    /** Rewrites every `ArtifactGroup.define({ folder: '<literal>' })` and `ArtifactGroup.application()` in a source file to carry its classes as `content`, imported by absolute path - a binary then holds each group's list and never scans. A group with no decorated class, or a call the plugin cannot read (an aliased `ArtifactGroup`, a folder that is not a string literal), fails the build. */
     static rewriteGroups(opts: {
         filePath: string;
         source: string;
@@ -26,10 +29,12 @@ export declare class IgnisArtifactsPlugin {
     static groupDefinitionFiles(opts: {
         root: string;
     }): string[];
-    /** For `Bun.build({ plugins: [IgnisArtifactsPlugin.create()] })`; `isRuntime` is set by `registerRuntime`, which serves a virtual module instead. */
+    /** For `Bun.build({ plugins: [IgnisArtifactsPlugin.create()] })`; `isRuntime` is set by `registerRuntime`, which serves a virtual module instead. `entry` (default: the build's first entrypoint, or `Bun.main` at run time) decides which tree the classes are imported from. */
     static create(opts?: {
         root?: string;
+        entry?: string;
         isRuntime?: boolean;
+        lazyIndex?: boolean;
     }): BunPlugin;
     /** Registers the run-time plugin once per process; a second call is a no-op. */
     static registerRuntime(opts?: {

package/dist/esm/bun/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/bun/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAQrC,6QAA6Q;AAC7Q,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,qBAAqB;IACzC,MAAM,CAAC,QAAQ,CAAC,OAAO,qBAAqB;IAC5C,MAAM,CAAC,QAAQ,CAAC,WAAW,wBAAwB;IAEnD,+IAA+I;IAC/I,MAAM,CAAC,QAAQ,CAAC,WAAW,SAC0F;IAErH,oHAAoH;IACpH,MAAM,CAAC,QAAQ,CAAC,WAAW,SAAsC;IAEjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAA8D;IAEjG,uGAAuG;IACvG,MAAM,CAAC,WAAW,CAAC,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM;IAIxD,kHAAkH;IAClH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAgB7C,uWAAuW;IACvW,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAsGxE,wPAAwP;IACxP,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE;IAiD7D,qJAAqJ;IACrJ,MAAM,CAAC,MAAM,CAAC,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,SAAS;IAyC3E,gFAAgF;WACnE,eAAe,CAAC,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAO1E"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/bun/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAQrC,6QAA6Q;AAC7Q,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,qBAAqB;IACzC,MAAM,CAAC,QAAQ,CAAC,OAAO,qBAAqB;IAC5C,MAAM,CAAC,QAAQ,CAAC,WAAW,wBAAwB;IAEnD,+IAA+I;IAC/I,MAAM,CAAC,QAAQ,CAAC,WAAW,SAC0F;IAErH,oHAAoH;IACpH,MAAM,CAAC,QAAQ,CAAC,WAAW,SAAsD;IAEjF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAA8D;IAMjG,8GAA8G;IAC9G,MAAM,CAAC,WAAW,CAAC,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM;IAMxD,wLAAwL;IACxL,MAAM,CAAC,cAAc,IAAI,MAAM;IAK/B,+NAA+N;IAC/N,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAoB7D,sYAAsY;IACtY,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAqJxE,wPAAwP;IACxP,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE;IAgE7D,kRAAkR;IAClR,MAAM,CAAC,MAAM,CACX,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GACrF,SAAS;IAmDZ,gFAAgF;WACnE,eAAe,CAAC,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAO1E"}

package/dist/esm/bun/plugin.js

@@ -1,5 +1,5 @@
 import { getError } from '@venizia/ignis-helpers';
-import { existsSync, readFileSync, realpathSync } from 'node:fs';
+import { existsSync, globSync, readdirSync, readFileSync, realpathSync } from 'node:fs';
 import { dirname, join, resolve, sep } from 'node:path';
 import ts from 'typescript';
 import { ArtifactIndexEmitter, ArtifactScanner, ArtifactStereotypes } from '../generator/index.js';
@@ -12,29 +12,43 @@ export class IgnisArtifactsPlugin {
     /** `@venizia/ignis-boot/auto`, from source or from either dist format - replaced at build time by a static re-export of the virtual module. */
     static { this.AUTO_MODULE = /[\\/](?:@venizia[\\/]ignis-boot|packages[\\/]boot)[\\/](?:dist[\\/](?:esm|cjs)|src)[\\/]bun[\\/]auto\.(?:ts|js)$/; }
     /** A text test for a file worth parsing: `ArtifactGroup.define(`, with any spacing or line break around the dot. */
-    static { this.DEFINE_CALL = /ArtifactGroup\s*\.\s*define\s*\(/; }
+    static { this.DEFINE_CALL = /ArtifactGroup\s*\.\s*(?:define|application)\s*\(/; }
     static { this.RUNTIME_KEY = Symbol.for('@venizia/ignis-boot:artifacts-runtime-plugin'); }
-    /** The `src` beside the nearest `package.json` at or above `from` (default: the working directory). */
+    static {
+        ArtifactSources.useScanner({ scanner: ArtifactScanner.getInstance() });
+    }
+    /** The `src` beside the nearest `package.json` at or above `from` (default: the entry module's directory). */
     static defaultRoot(opts = {}) {
-        return ArtifactSources.packageSource(opts);
+        return ArtifactSources.packageSource({
+            from: opts.from ?? IgnisArtifactsPlugin.entryDirectory(),
+        });
+    }
+    /** The entry module's directory (`Bun.main`), so the root never depends on where the process was started; the working directory only when there is no entry file (`bun -e`, a REPL). */
+    static entryDirectory() {
+        const entry = ArtifactSources.entry();
+        return entry ? dirname(entry) : process.cwd();
     }
-    /** The index as module source: every import absolute, since a virtual module has no directory to resolve from. */
+    /** The index as module source: every import absolute, since a virtual module has no directory to resolve from. With `entry` in a compiled tree, each class is imported from that tree (`ArtifactSources.runningArtifacts`). */
     static render(opts) {
         const root = resolve(opts.root);
+        if (!existsSync(root)) {
+            throw getError({
+                message: `[IgnisArtifactsPlugin] ${dirname(root)} has no src directory (${root}) | Auto artifacts scan the src beside the package.json of the entry module; pass IgnisArtifactsPlugin.create({ root }), or use ArtifactGroup.application() in the application's own source`,
+            });
+        }
         const outFile = join(root, '__ignis_artifacts__.ts');
-        const { artifacts } = ArtifactScanner.getInstance().scanWithReport({
-            root,
-            followReexports: true,
-        });
+        const artifacts = ArtifactSources.scan({ packageSource: root });
         return ArtifactIndexEmitter.render({
-            artifacts,
+            artifacts: opts.entry
+                ? ArtifactSources.runningArtifacts({ artifacts, from: opts.entry })
+                : artifacts,
             outFile,
             exportName: IgnisArtifactsPlugin.EXPORT_NAME,
             command: { root, out: outFile },
             absoluteImports: true,
         });
     }
-    /** Rewrites every `ArtifactGroup.define({ folder: '<literal>' })` in a source file to carry its classes as `content`, imported by absolute path - a binary then holds each group's list and never scans. A folder with no decorated class, or a define the plugin cannot read (an aliased `ArtifactGroup`, a folder that is not a string literal), fails the build. */
+    /** Rewrites every `ArtifactGroup.define({ folder: '<literal>' })` and `ArtifactGroup.application()` in a source file to carry its classes as `content`, imported by absolute path - a binary then holds each group's list and never scans. A group with no decorated class, or a call the plugin cannot read (an aliased `ArtifactGroup`, a folder that is not a string literal), fails the build. */
     static rewriteGroups(opts) {
         const { filePath, source } = opts;
         const sourceFile = ts.createSourceFile(filePath, source, ts.ScriptTarget.Latest, true);
@@ -56,63 +70,104 @@ export class IgnisArtifactsPlugin {
         const refuse = (node, reason) => {
             const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
             throw getError({
-                message: `[IgnisArtifactsPlugin] An ArtifactGroup.define at ${filePath}:${line + 1} cannot be rewritten | ${reason} - write ArtifactGroup.define({ folder: '<name>' }) with the class imported under its own name`,
+                message: `[IgnisArtifactsPlugin] An ArtifactGroup call at ${filePath}:${line + 1} cannot be rewritten | ${reason} - write ArtifactGroup.define({ folder: '<name>' }) or ArtifactGroup.application() with the class imported under its own name`,
             });
         };
-        const visit = (node) => {
-            if (ts.isCallExpression(node) &&
-                ts.isPropertyAccessExpression(node.expression) &&
-                node.expression.name.text === 'define' &&
-                ts.isIdentifier(node.expression.expression)) {
-                const callee = node.expression.expression.text;
-                if (aliases.has(callee)) {
-                    refuse(node, `ArtifactGroup is imported as ${callee}`);
-                }
-                if (callee === 'ArtifactGroup') {
-                    const [argument] = node.arguments;
-                    if (!argument || !ts.isObjectLiteralExpression(argument)) {
-                        refuse(node, 'the argument is not an object literal');
-                    }
-                    const literal = argument;
-                    const named = (name) => literal.properties.find(entry => entry.name && ts.isIdentifier(entry.name) && entry.name.text === name);
-                    const folderProperty = named('folder');
-                    if (!named('content')) {
-                        if (!folderProperty ||
-                            !ts.isPropertyAssignment(folderProperty) ||
-                            !ts.isStringLiteral(folderProperty.initializer)) {
-                            refuse(node, 'folder is not a string literal');
-                        }
-                        const folder = folderProperty.initializer.text;
-                        const artifacts = ArtifactSources.folderArtifacts({ folder, site: filePath });
-                        if (artifacts.length === 0) {
-                            throw getError({
-                                message: `[IgnisArtifactsPlugin] ArtifactGroup '${folder}' resolved to no class | ${filePath} - check the folder name and that its classes carry a stereotype decorator`,
-                            });
-                        }
-                        const fields = [];
-                        for (const { type, field } of ArtifactStereotypes.EMIT_ORDER) {
-                            const locals = artifacts
-                                .filter(artifact => artifact.type === type)
-                                .map(artifact => {
-                                counter += 1;
-                                const local = `__ignis_group_${counter}`;
-                                const path = artifact.filePath.split(sep).join('/').replace(/\.ts$/, '');
-                                imports.push(`import { ${artifact.className} as ${local} } from '${path}';`);
-                                return local;
-                            });
-                            if (locals.length > 0) {
-                                fields.push(`${field}: [${locals.join(', ')}]`);
-                            }
-                        }
-                        const last = literal.properties[literal.properties.length - 1];
-                        edits.push({
-                            at: last ? last.getEnd() : literal.getStart() + 1,
-                            text: `${last ? ', ' : ''}content: { ${fields.join(', ')} }`,
-                        });
+        const isCompiled = !ArtifactStereotypes.SOURCE_EXTENSION.test(filePath);
+        const contentLiteral = (folder, ignore) => {
+            const artifacts = ArtifactSources.folderArtifacts({ folder, site: filePath, ignore });
+            if (artifacts.length === 0) {
+                throw getError({
+                    message: `[IgnisArtifactsPlugin] ArtifactGroup '${folder ?? '<application>'}' resolved to no class | ${filePath} - check the folder name and that its classes carry a stereotype decorator`,
+                });
+            }
+            const fields = [];
+            for (const { type, field } of ArtifactStereotypes.EMIT_ORDER) {
+                const locals = artifacts
+                    .filter(artifact => artifact.type === type)
+                    .map(artifact => {
+                    if (isCompiled) {
+                        return `require(${JSON.stringify(artifact.filePath)}).${artifact.className}`;
                     }
+                    counter += 1;
+                    const local = `__ignis_group_${counter}`;
+                    const path = artifact.filePath
+                        .split(sep)
+                        .join('/')
+                        .replace(ArtifactStereotypes.SOURCE_EXTENSION, '');
+                    imports.push(`import { ${artifact.className} as ${local} } from '${path}';`);
+                    return local;
+                });
+                if (locals.length > 0) {
+                    fields.push(`${field}: [${locals.join(', ')}]`);
                 }
             }
-            ts.forEachChild(node, visit);
+            return `{ ${fields.join(', ')} }`;
+        };
+        const visit = (node) => {
+            const isGroupCall = ts.isCallExpression(node) &&
+                ts.isPropertyAccessExpression(node.expression) &&
+                (ts.isIdentifier(node.expression.expression) ||
+                    ts.isPropertyAccessExpression(node.expression.expression)) &&
+                (node.expression.name.text === 'define' || node.expression.name.text === 'application');
+            if (!isGroupCall) {
+                ts.forEachChild(node, visit);
+                return;
+            }
+            const call = node;
+            const access = call.expression;
+            const target = access.expression;
+            const callee = ts.isIdentifier(target)
+                ? target.text
+                : target.name.text;
+            const isApplication = access.name.text === 'application';
+            if (ts.isIdentifier(target) && aliases.has(callee)) {
+                refuse(call, `ArtifactGroup is imported as ${callee}`);
+            }
+            if (callee !== 'ArtifactGroup') {
+                ts.forEachChild(node, visit);
+                return;
+            }
+            const [argument] = call.arguments;
+            if (isApplication && !argument) {
+                edits.push({ at: call.arguments.pos, text: `{ content: ${contentLiteral(undefined)} }` });
+                return;
+            }
+            if (!argument || !ts.isObjectLiteralExpression(argument)) {
+                refuse(call, 'the argument is not an object literal');
+            }
+            const literal = argument;
+            const named = (name) => literal.properties.find(entry => entry.name !== undefined && ts.isIdentifier(entry.name) && entry.name.text === name);
+            if (named('content')) {
+                return;
+            }
+            const folderProperty = named('folder');
+            if (isApplication && folderProperty) {
+                refuse(call, 'ArtifactGroup.application() takes no folder');
+            }
+            const folderLiteral = folderProperty &&
+                ts.isPropertyAssignment(folderProperty) &&
+                ts.isStringLiteral(folderProperty.initializer)
+                ? folderProperty.initializer.text
+                : undefined;
+            if (!isApplication && folderLiteral === undefined) {
+                refuse(call, 'folder is not a string literal');
+            }
+            const ignoreProperty = named('ignore');
+            const ignoreList = ignoreProperty &&
+                ts.isPropertyAssignment(ignoreProperty) &&
+                ts.isArrayLiteralExpression(ignoreProperty.initializer) &&
+                ignoreProperty.initializer.elements.every(element => ts.isStringLiteral(element))
+                ? ignoreProperty.initializer.elements.map(element => element.text)
+                : undefined;
+            if (ignoreProperty && ignoreList === undefined) {
+                refuse(call, 'ignore is not an array of string literals');
+            }
+            const last = literal.properties[literal.properties.length - 1];
+            edits.push({
+                at: last ? last.getEnd() : literal.getStart() + 1,
+                text: `${last ? ', ' : ''}content: ${contentLiteral(folderLiteral, ignoreList)}`,
+            });
         };
         visit(sourceFile);
         let rewritten = source;
@@ -151,13 +206,25 @@ export class IgnisArtifactsPlugin {
                 directory = parent;
             }
         }
-        const files = [];
+        // A package that runs from its compiled tree (`main` in dist) defines its groups there too.
+        const trees = [];
         for (const source of sources) {
             if (!existsSync(source)) {
                 continue;
             }
-            for (const relativePath of new Bun.Glob('**/*.ts').scanSync({ cwd: source })) {
-                const file = join(source, relativePath);
+            trees.push({ directory: source, pattern: ArtifactStereotypes.SOURCE_GLOB });
+            for (const entry of readdirSync(dirname(source), { withFileTypes: true })) {
+                if (entry.isDirectory() &&
+                    !['src', 'node_modules'].includes(entry.name) &&
+                    !entry.name.startsWith('.')) {
+                    trees.push({ directory: join(dirname(source), entry.name), pattern: '**/*.js' });
+                }
+            }
+        }
+        const files = [];
+        for (const { directory, pattern } of trees) {
+            for (const relativePath of globSync(pattern, { cwd: directory })) {
+                const file = join(directory, relativePath);
                 if (!relativePath.includes('__tests__') &&
                     IgnisArtifactsPlugin.DEFINE_CALL.test(readFileSync(file, 'utf8'))) {
                     files.push(file);
@@ -166,14 +233,17 @@ export class IgnisArtifactsPlugin {
         }
         return files;
     }
-    /** For `Bun.build({ plugins: [IgnisArtifactsPlugin.create()] })`; `isRuntime` is set by `registerRuntime`, which serves a virtual module instead. */
+    /** For `Bun.build({ plugins: [IgnisArtifactsPlugin.create()] })`; `isRuntime` is set by `registerRuntime`, which serves a virtual module instead. `entry` (default: the build's first entrypoint, or `Bun.main` at run time) decides which tree the classes are imported from. */
     static create(opts = {}) {
-        const root = opts.root ?? IgnisArtifactsPlugin.defaultRoot();
         const isRuntime = opts.isRuntime ?? false;
-        const contents = () => IgnisArtifactsPlugin.render({ root });
         return {
             name: IgnisArtifactsPlugin.NAME,
             setup(build) {
+                const [entrypoint] = isRuntime ? [] : build.config.entrypoints;
+                const entry = opts.entry ?? (entrypoint ? resolve(entrypoint) : ArtifactSources.entry());
+                const root = opts.root ??
+                    ArtifactSources.packageSource({ from: entry ? dirname(entry) : process.cwd() });
+                const contents = () => IgnisArtifactsPlugin.render({ root, entry });
                 if (isRuntime) {
                     build.module(IgnisArtifactsPlugin.VIRTUAL, () => ({
                         contents: contents(),
@@ -195,11 +265,16 @@ export class IgnisArtifactsPlugin {
                             filePath: args.path,
                             source: readFileSync(args.path, 'utf8'),
                         }),
-                        loader: 'ts',
+                        loader: args.path.endsWith('.tsx') ? 'tsx' : args.path.endsWith('.ts') ? 'ts' : 'js',
                     }));
                 }
+                // Lazy (a dynamic import on the first resolve) for a server: a library importing this module must not evaluate the app's classes inside its own half-loaded graph. Eager for a browser bundle: a lazily evaluated graph is not tree-shaken, which doubled a measured frontend bundle.
+                const isLazy = opts.lazyIndex ?? build.config.target !== 'browser';
+                const autoModule = isLazy
+                    ? `import { AutoArtifactGroup } from './auto-group.js';\nexport default new AutoArtifactGroup({ resolve: async () => (await import('${IgnisArtifactsPlugin.VIRTUAL}')).${IgnisArtifactsPlugin.EXPORT_NAME} });\n`
+                    : `import { ${IgnisArtifactsPlugin.EXPORT_NAME} } from '${IgnisArtifactsPlugin.VIRTUAL}';\nimport { AutoArtifactGroup } from './auto-group.js';\nexport default new AutoArtifactGroup({ content: ${IgnisArtifactsPlugin.EXPORT_NAME} });\n`;
                 build.onLoad({ filter: IgnisArtifactsPlugin.AUTO_MODULE }, () => ({
-                    contents: `import { ${IgnisArtifactsPlugin.EXPORT_NAME} } from '${IgnisArtifactsPlugin.VIRTUAL}';\nimport { AutoArtifactGroup } from './auto-group.js';\nexport default new AutoArtifactGroup({ content: ${IgnisArtifactsPlugin.EXPORT_NAME} });\n`,
+                    contents: autoModule,
                     loader: 'ts',
                 }));
             },