npm - @expressots/core - Versions diffs - 4.0.0-preview.1 → 4.0.0-preview.3 - Mend

@expressots/core 4.0.0-preview.1 → 4.0.0-preview.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (134) hide show

package/lib/esm/render/adapters/react-adapter.js CHANGED Viewed

@@ -268,20 +268,20 @@ export class ReactAdapter extends BaseEngineAdapter {
             .replace(/</g, "\\u003c")
             .replace(/>/g, "\\u003e")
             .replace(/&/g, "\\u0026");
-        return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <script>
-    window.__INITIAL_DATA__ = ${safeData};
-    window.__COMPONENT__ = "${view}";
-  </script>
-</head>
-<body>
-  <div id="root">${html}</div>
-  <script src="/assets/client.js" defer></script>
-</body>
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <script>
+    window.__INITIAL_DATA__ = ${safeData};
+    window.__COMPONENT__ = "${view}";
+  </script>
+</head>
+<body>
+  <div id="root">${html}</div>
+  <script src="/assets/client.js" defer></script>
+</body>
 </html>`;
     }
     /**

package/lib/esm/render/features/type-generator.js CHANGED Viewed

@@ -89,36 +89,36 @@ export class TypeGenerator {
             const propsType = v.propsType || "Record<string, unknown>";
             return `  "${v.name}": ${propsType};`;
         });
-        return `/**
- * Auto-generated view types
- * Generated by ExpressoTS Render Engine
- * Do not edit this file manually
- */
-/**
- * View name to props type mapping
- */
-export interface Views {
-${viewTypes.join("\n")}
-}
-/**
- * All view names
- */
-export type ViewName = keyof Views;
-/**
- * Get props type for a specific view
- */
-export type ViewProps<T extends ViewName> = Views[T];
-/**
- * Type-safe render function signature
- */
-export type RenderFunction = <T extends ViewName>(
-  view: T,
-  data: Views[T],
-) => Promise<string>;
+        return `/**
+ * Auto-generated view types
+ * Generated by ExpressoTS Render Engine
+ * Do not edit this file manually
+ */
+/**
+ * View name to props type mapping
+ */
+export interface Views {
+${viewTypes.join("\n")}
+}
+/**
+ * All view names
+ */
+export type ViewName = keyof Views;
+/**
+ * Get props type for a specific view
+ */
+export type ViewProps<T extends ViewName> = Views[T];
+/**
+ * Type-safe render function signature
+ */
+export type RenderFunction = <T extends ViewName>(
+  view: T,
+  data: Views[T],
+) => Promise<string>;
 `;
     }
     /**

package/lib/esm/render/features/view-debugger.js CHANGED Viewed

@@ -28,12 +28,18 @@ export class ViewDebugger {
         app.get("/__views", (req, res) => {
             this.handleViewsEndpoint(req, res);
         });
-        // Preview a view
-        app.get("/__views/preview/:view(*)", (req, res) => {
+        // Preview a view. The view name can contain slashes (e.g.
+        // `users/profile`), so we use a named splat (`*view`) — the
+        // path-to-regexp v6 form `:view(*)` shipped by Express 4 is not
+        // valid in path-to-regexp v8 (Express 5) and now throws
+        // `Missing parameter name`. Path-to-regexp v8 captures the splat
+        // segments as `req.params.view: string[]`; the helpers below
+        // normalise that to a slash-joined string for backward compat.
+        app.get("/__views/preview/*view", (req, res) => {
             this.handlePreviewEndpoint(req, res);
         });
-        // Get view info
-        app.get("/__views/info/:view(*)", (req, res) => {
+        // Get view info — same shape as preview.
+        app.get("/__views/info/*view", (req, res) => {
             this.handleInfoEndpoint(req, res);
         });
         // Get metrics
@@ -72,7 +78,7 @@ export class ViewDebugger {
      */
     async handlePreviewEndpoint(req, res) {
         try {
-            const view = req.params.view;
+            const view = this.resolveViewParam(req.params.view);
             const data = req.query.data ? JSON.parse(req.query.data) : {};
             const html = await this.renderService.render(view, data);
             res.setHeader("Content-Type", "text/html");
@@ -81,16 +87,30 @@ export class ViewDebugger {
         catch (error) {
             res.status(500).json({
                 error: error.message,
-                view: req.params.view,
+                view: this.resolveViewParam(req.params.view),
             });
         }
     }
+    /**
+     * Normalise the `view` route param across Express 4 and 5.
+     *
+     * Express 4 / path-to-regexp v6 captured `/__views/preview/:view(*)`
+     * as a single string. Express 5 / path-to-regexp v8 changed the
+     * named-splat capture to `string[]` (one entry per slash-separated
+     * segment). The view engine needs the slash-joined form, so we always
+     * collapse the array shape back to that.
+     */
+    resolveViewParam(value) {
+        if (Array.isArray(value))
+            return value.join("/");
+        return typeof value === "string" ? value : "";
+    }
     /**
      * Handle the view info endpoint.
      */
     handleInfoEndpoint(req, res) {
         try {
-            const view = req.params.view;
+            const view = this.resolveViewParam(req.params.view);
             const viewFiles = this.renderService.getViewFiles();
             // Find matching view
             const matchingFiles = viewFiles.filter((file) => file.includes(view));
@@ -119,54 +139,54 @@ export class ViewDebugger {
      * Wrap preview HTML with debug info.
      */
     wrapPreview(view, html) {
-        return `<!DOCTYPE html>
-<html>
-<head>
-  <title>View Preview: ${view}</title>
-  <style>
-    .debug-bar {
-      position: fixed;
-      top: 0;
-      left: 0;
-      right: 0;
-      background: #1a1a2e;
-      color: #eee;
-      padding: 8px 16px;
-      font-family: system-ui, -apple-system, sans-serif;
-      font-size: 13px;
-      z-index: 99999;
-      display: flex;
-      align-items: center;
-      gap: 16px;
-      box-shadow: 0 2px 8px rgba(0,0,0,0.2);
-    }
-    .debug-bar strong {
-      color: #00d9ff;
-    }
-    .debug-bar a {
-      color: #ff6b6b;
-      text-decoration: none;
-    }
-    .debug-bar a:hover {
-      text-decoration: underline;
-    }
-    .content-wrapper {
-      padding-top: 50px;
-    }
-  </style>
-</head>
-<body>
-  <div class="debug-bar">
-    <span>📁 <strong>${view}</strong></span>
-    <span>|</span>
-    <span>Engine: <strong>${this.renderService.getActiveEngine().name}</strong></span>
-    <span>|</span>
-    <a href="/__views">← Back to Views</a>
-  </div>
-  <div class="content-wrapper">
-    ${html}
-  </div>
-</body>
+        return `<!DOCTYPE html>
+<html>
+<head>
+  <title>View Preview: ${view}</title>
+  <style>
+    .debug-bar {
+      position: fixed;
+      top: 0;
+      left: 0;
+      right: 0;
+      background: #1a1a2e;
+      color: #eee;
+      padding: 8px 16px;
+      font-family: system-ui, -apple-system, sans-serif;
+      font-size: 13px;
+      z-index: 99999;
+      display: flex;
+      align-items: center;
+      gap: 16px;
+      box-shadow: 0 2px 8px rgba(0,0,0,0.2);
+    }
+    .debug-bar strong {
+      color: #00d9ff;
+    }
+    .debug-bar a {
+      color: #ff6b6b;
+      text-decoration: none;
+    }
+    .debug-bar a:hover {
+      text-decoration: underline;
+    }
+    .content-wrapper {
+      padding-top: 50px;
+    }
+  </style>
+</head>
+<body>
+  <div class="debug-bar">
+    <span>📁 <strong>${view}</strong></span>
+    <span>|</span>
+    <span>Engine: <strong>${this.renderService.getActiveEngine().name}</strong></span>
+    <span>|</span>
+    <a href="/__views">← Back to Views</a>
+  </div>
+  <div class="content-wrapper">
+    ${html}
+  </div>
+</body>
 </html>`;
     }
 }

package/lib/esm/testing/fluent-request.js CHANGED Viewed

@@ -231,7 +231,13 @@ class FluentRequestImpl {
     }
     /**
      * Execute the request and return the response.
+     *
+     * The generic defaults to `any` (see {@link FluentResponse} for the
+     * rationale) so test code can read `response.body.foo` directly. Pass
+     * an explicit type — `.execute<UserDto>()` — to opt into strict
+     * typing.
      */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async execute() {
         const startTime = Date.now();
         // Build URL with query parameters
@@ -315,6 +321,7 @@ class FluentRequestImpl {
     /**
      * Alias for execute().
      */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     end() {
         return this.execute();
     }

package/lib/esm/testing/snapshot-request.js CHANGED Viewed

@@ -98,9 +98,11 @@ class SnapshotRequestImpl {
         this.fluentRequest.expect(assertion);
         return this;
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     execute() {
         return this.fluentRequest.execute();
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     end() {
         return this.fluentRequest.end();
     }

package/lib/esm/types/application/application-factory.d.ts CHANGED Viewed

@@ -112,6 +112,12 @@ export declare class AppFactory {
      *
      * @throws {Error} If webServerType is not a valid constructor
      *
+     * @deprecated Use `bootstrap()` from `@expressots/core` instead. `bootstrap()`
+     * additionally handles environment file loading, port configuration,
+     * graceful shutdown, the startup banner, and configuration validation.
+     * `AppFactory.create()` will keep working for advanced use cases but is
+     * scheduled for removal in a future major release.
+     *
      * @public API
      */
     static create<T extends IWebServer>(webServerType: IWebServerConstructor<T>): Promise<IWebServerBuilder>;

package/lib/esm/types/application/bootstrap.d.ts CHANGED Viewed

@@ -216,52 +216,147 @@ export interface EnvironmentFileConfig {
     skipFileLoading?: boolean;
 }
 /**
- * Options for loadEnvSync().
- * @public API
+ * Options for {@link loadEnvSync}.
+ *
+ * `loadEnvSync()` is the recommended way to populate `process.env` before
+ * `bootstrap()` runs. Call it at the top of `src/main.ts` (or your config
+ * module) so every subsequent `Env.*` builder, `defineConfig()` call, and
+ * DI binding can read the loaded values.
+ *
+ * ### File-loading order (last wins)
+ *
+ * | Step | File | Purpose |
+ * |------|------|---------|
+ * | 1 | `.env` | Shared defaults (committed) |
+ * | 2 | `.env.local` | Local-only overrides (gitignored) |
+ * | 3 | `.env.{env}.local` | Per-environment local override |
+ * | 4 | `.env.{env}` | Per-environment values (highest priority) |
+ *
+ * `{env}` is resolved from `process.env.NODE_ENV` (defaults to `"development"`).
+ * If a `files` mapping is provided, the mapped filename replaces `.env.{env}`.
+ *
+ * @example
+ * ```typescript
+ * // 1. Zero-config (loads .env + .env.development by convention)
+ * loadEnvSync();
+ *
+ * // 2. Custom file names per environment
+ * loadEnvSync({
+ *   files: {
+ *     development: ".env",
+ *     production: ".env.prod",
+ *     staging: ".env.staging",
+ *   },
+ * });
+ *
+ * // 3. Force reload after hot-module replacement
+ * loadEnvSync({ force: true });
+ * ```
+ *
+ * @see {@link loadEnvSync} for the function itself
+ * @see {@link BootstrapOptions.envFileConfig} for the bootstrap()-level alternative
+ * @public
  */
 export interface LoadEnvSyncOptions {
     /**
-     * Custom mapping of environment names to .env file names.
-     * @default Uses convention: `.env.{currentEnvironment}`
+     * Map environment names to custom `.env` file paths.
+     *
+     * Only the entry matching the **current** `NODE_ENV` is used at runtime.
+     * Unmapped environments fall back to the convention `.env.{NODE_ENV}`.
+     *
+     * @default undefined (convention: `.env.{NODE_ENV}`)
+     *
+     * @example
+     * ```typescript
+     * files: {
+     *   development: ".env",         // NODE_ENV=development  -> loads .env
+     *   production:  ".env.prod",    // NODE_ENV=production   -> loads .env.prod
+     *   test:        ".env.test",    // NODE_ENV=test         -> loads .env.test
+     * }
+     * ```
      */
     files?: EnvironmentFileMap;
     /**
-     * Force reload even if already loaded.
-     * Useful for hot reload scenarios.
+     * Reload environment files even if they were already loaded in this process.
+     *
+     * By default `loadEnvSync()` is a no-op after the first successful call
+     * (tracked via `process.env._EXPRESSOTS_ENV_LOADED`). Set `force: true`
+     * to re-read all files, useful after a hot-module replacement cycle.
+     *
      * @default false
      */
     force?: boolean;
 }
 /**
- * Synchronously load .env files BEFORE defineConfig() resolves.
+ * Synchronously load `.env` files into `process.env`.
  *
- * Call this at the top of your config file to ensure environment variables
- * are available when defineConfig() runs.
+ * Call this **before** `bootstrap()` or `defineConfig()` so that every
+ * environment variable is available when the rest of the application
+ * resolves configuration, binds services, or reads `Env.*` builders.
  *
- * @param options - Environment file configuration
+ * ### How it works
  *
- * @example
+ * 1. Reads `process.env.NODE_ENV` (defaults to `"development"`).
+ * 2. Loads files in priority order (last file wins on conflicts):
+ *    `.env` → `.env.local` → `.env.{env}.local` → `.env.{env}`
+ * 3. If `options.files` maps the current environment to a custom name
+ *    (e.g. `{ production: ".env.prod" }`), that name replaces `.env.{env}`.
+ * 4. Missing files are silently skipped.
+ * 5. Sets `process.env._EXPRESSOTS_ENV_LOADED = "true"` so subsequent
+ *    calls are no-ops (unless `force: true`).
+ *
+ * ### Important
+ *
+ * `NODE_ENV` must already be set in the **shell** (or inherited from
+ * the process) before `loadEnvSync()` runs. The function reads
+ * `process.env.NODE_ENV` to decide which file to load; it does **not**
+ * derive the environment from file contents.
+ *
+ * @param options - See {@link LoadEnvSyncOptions} for all fields.
+ *
+ * @example Zero-config (recommended for most apps)
  * ```typescript
- * // config.ts
- * import { defineConfig, Env, loadEnvSync } from "@expressots/core";
+ * // src/main.ts
+ * import { bootstrap, loadEnvSync } from "@expressots/core";
+ * import { App } from "./app";
+ *
+ * loadEnvSync();          // .env + .env.development (or .env.production, etc.)
+ * void bootstrap(App);
+ * ```
  *
- * // Load .env files first
+ * @example Custom file mapping
+ * ```typescript
  * loadEnvSync({
  *   files: {
- *     development: ".env.dev",
- *     production: ".env.prod",
+ *     development: ".env",
+ *     production:  ".env.prod",
+ *     staging:     ".env.staging",
  *   },
  * });
+ * // With NODE_ENV=production  -> .env + .env.prod
+ * // With NODE_ENV=development -> .env  (mapped to itself, so loaded once)
+ * ```
+ *
+ * @example With defineConfig()
+ * ```typescript
+ * // src/config.ts
+ * import { defineConfig, Env, loadEnvSync } from "@expressots/core";
+ *
+ * loadEnvSync({ files: { production: ".env.prod" } });
  *
- * // Now defineConfig() will read from loaded .env files
  * export const appConfig = defineConfig({
- *   server: {
- *     port: Env.port("PORT", { default: 3000 }),
- *   },
+ *   server: { port: Env.port("PORT", { default: 3000 }) },
  * });
  * ```
  *
- * @public API
+ * @example Force reload (hot-module replacement)
+ * ```typescript
+ * loadEnvSync({ force: true });
+ * ```
+ *
+ * @see {@link LoadEnvSyncOptions} for option details
+ * @see {@link BootstrapOptions.envFileConfig} for the bootstrap()-level alternative
+ * @public
  */
 export declare function loadEnvSync(options?: LoadEnvSyncOptions): void;
 /**
@@ -471,14 +566,91 @@ export interface BootstrapOptions {
     envFileConfig?: EnvironmentFileConfig;
 }
 /**
- * Bootstrap with BootstrapOptions (existing behavior).
+ * Start the application with explicit options.
+ *
+ * Use this overload when you need to control the port, app metadata,
+ * environment selection, or `.env` file loading/validation.
+ *
+ * @param AppClass - Your class that extends `AppExpress`.
+ * @param options  - See {@link BootstrapOptions} for every field.
+ * @returns The running server instance.
+ *
+ * @example Port + environment + validation
+ * ```typescript
+ * await bootstrap(App, {
+ *   port: 4000,
+ *   appName: "My API",
+ *   currentEnvironment: "production",
+ *   envFileConfig: {
+ *     files: { production: ".env.prod" },
+ *     required: ["DATABASE_URL", "JWT_SECRET"],
+ *     validateValues: true,
+ *   },
+ * });
+ * ```
+ *
+ * @example Dynamic port for testing
+ * ```typescript
+ * const server = await bootstrap(App, { port: 0 });
+ * const port = await server.getPort();
+ * ```
+ *
+ * @example Container / CI (no file I/O)
+ * ```typescript
+ * await bootstrap(App, {
+ *   envFileConfig: {
+ *     skipFileLoading: true,
+ *     required: ["DATABASE_URL"],
+ *   },
+ * });
+ * ```
+ *
+ * @public
  */
 export declare function bootstrap(AppClass: new () => IWebServer, options: BootstrapOptions): Promise<IWebServerPublic>;
 /**
- * Bootstrap with config object (new convenience overload).
+ * Start the application with a type-safe config object from `defineConfig()`.
+ *
+ * Pass the resolved config directly; `bootstrap()` extracts `app`, `server`,
+ * and `bootstrap.envFileConfig` automatically.
+ *
+ * @param AppClass - Your class that extends `AppExpress`.
+ * @param config   - Object returned by `defineConfig().values` (or matching
+ *                   the {@link BootstrapConfig} shape).
+ * @returns The running server instance.
+ *
+ * @example
+ * ```typescript
+ * import { appConfig } from "./config";
+ *
+ * await bootstrap(App, appConfig.values);
+ * // appConfig.values has { app, server, bootstrap } from defineConfig()
+ * ```
+ *
+ * @public
  */
 export declare function bootstrap(AppClass: new () => IWebServer, config: BootstrapConfig): Promise<IWebServerPublic>;
 /**
- * Bootstrap with no options (zero-config).
+ * Start the application with zero configuration.
+ *
+ * - Listens on `process.env.PORT` or **3000**.
+ * - Reads `appName` and `appVersion` from `package.json`.
+ * - Does **not** load any `.env` files (opt-in via {@link BootstrapOptions.envFileConfig}
+ *   or by calling {@link loadEnvSync} before this).
+ * - Sets up graceful shutdown on `SIGINT` / `SIGTERM`.
+ *
+ * @param AppClass - Your class that extends `AppExpress`.
+ * @returns The running server instance.
+ *
+ * @example
+ * ```typescript
+ * import { bootstrap, loadEnvSync } from "@expressots/core";
+ * import { App } from "./app";
+ *
+ * loadEnvSync();           // optional: load .env files first
+ * await bootstrap(App);    // starts on PORT from .env or 3000
+ * ```
+ *
+ * @public
  */
 export declare function bootstrap(AppClass: new () => IWebServer): Promise<IWebServerPublic>;

package/lib/esm/types/config/config.interfaces.d.ts CHANGED Viewed

@@ -409,7 +409,13 @@ export interface DefineConfigOptions {
     throwOnError?: boolean;
     /**
      * Log validation results.
-     * @default "info"
+     *
+     * - `"warn"` (default): only warnings and errors are printed.
+     * - `"info"` / `"debug"`: prints the "CONFIGURATION LOADED" success banner
+     *   plus warnings and errors.
+     * - `"error"`: only errors.
+     * - `"none"`: completely silent.
+     * @default "warn"
      */
     logLevel?: ConfigLogLevel;
     /**

package/lib/esm/types/config/env-field-builders.d.ts CHANGED Viewed

@@ -274,6 +274,42 @@ declare function array<T extends string | number>(envVar: string, options?: Arra
  *
  * @public API
  */
+/**
+ * Returns true when the current Node environment (`NODE_ENV`) matches the
+ * supplied name. Pass an array to match any of several names. The comparison
+ * is case-insensitive and falls back to `"development"` when `NODE_ENV` is
+ * unset, mirroring the convention used elsewhere in the framework.
+ *
+ * ```ts
+ * const config = defineConfig({
+ *   server: { port: when(Env.is("production"), 443, 3000) },
+ * });
+ * ```
+ *
+ * @public API
+ */
+declare function isEnvironment(name: string | Array<string>): boolean;
+/**
+ * Conditional helper for environment-specific config values.
+ *
+ * `when(condition, value, fallback)` returns `value` when `condition` is
+ * truthy, otherwise `fallback`. The condition can be either a boolean
+ * (typically the result of `Env.is(...)`) or a callable that's evaluated
+ * lazily. The latter form lets you defer side-effectful checks until the
+ * config is actually resolved.
+ *
+ * ```ts
+ * const config = defineConfig({
+ *   logging: {
+ *     level: when(Env.is("production"), "info", "debug"),
+ *     pretty: when(() => process.env.NO_COLOR !== "1", true, false),
+ *   },
+ * });
+ * ```
+ *
+ * @public API
+ */
+declare function envWhen<TValue, TFallback>(condition: boolean | (() => boolean), value: TValue, fallback: TFallback): TValue | TFallback;
 export declare const Env: {
     readonly string: typeof string;
     readonly number: typeof number;
@@ -284,5 +320,8 @@ export declare const Env: {
     readonly secret: typeof secret;
     readonly json: typeof json;
     readonly array: typeof array;
+    readonly is: typeof isEnvironment;
+    readonly when: typeof envWhen;
 };
+export { isEnvironment as envIs, envWhen };
 export { string as envString, number as envNumber, boolean as envBoolean, enumField as envEnum, url as envUrl, port as envPort, secret as envSecret, json as envJson, array as envArray, };

package/lib/esm/types/config/index.d.ts CHANGED Viewed

@@ -56,6 +56,6 @@
  * ```
  */
 export { defineConfig, Env } from "./define-config.js";
-export { envString, envNumber, envBoolean, envEnum, envUrl, envPort, envSecret, envJson, envArray, } from "./env-field-builders.js";
+export { envString, envNumber, envBoolean, envEnum, envUrl, envPort, envSecret, envJson, envArray, envIs, envWhen, } from "./env-field-builders.js";
 export type { ConfigValueType, ConfigEnvironment, ConfigLogLevel, BaseFieldOptions, StringFieldOptions, NumberFieldOptions, BooleanFieldOptions, EnumFieldOptions, UrlFieldOptions, PortFieldOptions, SecretFieldOptions, JsonFieldOptions, ArrayFieldOptions, ConfigField, ConfigValidationError, ConfigValidationResult, ConfigSchemaValue, ConfigSchema, DefineConfigOptions, ConfigChangeEvent, SecretValue, ResolvedConfig, IConfigInstance, } from "./config.interfaces.js";
 export { createSecretValue, isSecretValue } from "./secret-value.js";

package/lib/esm/types/framework-version.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+/**
+ * Framework version string surfaced in startup banners and diagnostics.
+ *
+ * This file is auto-synced from the root `package.json` by
+ * `scripts/sync-version.js` before each build. Do not edit by hand.
+ */
+export declare const FRAMEWORK_VERSION = "4.0.0-preview.3";

package/lib/esm/types/lazy-loading/index.d.ts CHANGED Viewed

@@ -36,6 +36,7 @@
  */
 export type { PreloadHint, ModuleLoadStatus, LazyModuleConfig, LazyModuleFactory, ILazyModule, ILazyModuleLoader, ModuleLoadStatistics, ILazyModuleManager, ModuleRecommendation, ApplyRecommendationsOptions, ILazyLoadMetrics, WarmupStrategy, WarmupConfig, ILazyModuleWarmup, LoadingPhase, ProgressiveLoadingConfig, LazyLoadingOptions, LazyLoadingSetupResult, } from "./lazy.interfaces.js";
 export { LazyModule, CreateLazyModule, createLazyModule, isLazyModule, getModuleName, LAZY_MODULE_METADATA_KEY, } from "./lazy-module.js";
+export { withPreloadHint, withLazyConfig } from "./lazy-module-helpers.js";
 export { LazyModuleLoader, createLazyModuleLoader, } from "./lazy-module-loader.js";
 export { LazyModuleManager, createLazyModuleManager, } from "./lazy-module-manager.js";
 export { LazyLoadMetrics, createLazyLoadMetrics } from "./lazy-load-metrics.js";