@bleedingdev/modern-js-utils 3.2.0-ultramodern.0 → 3.2.0-ultramodern.2

package/package.json

@@ -17,7 +17,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.2.0-ultramodern.0",
+  "version": "3.2.0-ultramodern.2",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.mjs",
@@ -150,8 +150,8 @@
     "@types/node": "^25.8.0",
     "@typescript/native-preview": "7.0.0-dev.20260516.1",
     "happy-dom": "^20.8.9",
-    "@scripts/rstest-config": "2.66.0",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.2.0-ultramodern.0"
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.2.0-ultramodern.2",
+    "@scripts/rstest-config": "2.66.0"
   },
   "peerDependencies": {
     "react": "^19.2.6",

package/dist/types/cli/alias.d.ts

@@ -1,20 +0,0 @@
-export type Alias = Record<string, string | string[]>;
-export type AliasOption = Alias | ((aliases: Alias) => Alias | void);
-interface NormalizedConfig {
-    source: {
-        alias?: AliasOption | Array<AliasOption>;
-    };
-}
-interface IAliasConfig {
-    absoluteBaseUrl: string;
-    paths?: Record<string, string | string[]>;
-    isTsPath?: boolean;
-    isTsProject?: boolean;
-}
-export declare const mergeAlias: (alias: NormalizedConfig["source"]["alias"]) => Alias;
-export declare const getAliasConfig: (aliasOption: NormalizedConfig["source"]["alias"], option: {
-    appDirectory: string;
-    tsconfigPath: string;
-}) => IAliasConfig;
-export declare const getUserAlias: (alias?: Record<string, string | string[]>) => Record<string, string | string[]>;
-export {};

package/dist/types/cli/applyOptionsChain.d.ts

@@ -1,3 +0,0 @@
-export type Falsy = false | null | undefined | 0 | '';
-export declare function applyOptionsChain<T, U>(defaults: T, options?: T | ((config: T, utils?: U) => T | void) | Array<T | ((config: T, utils?: U) => T | void)> | Falsy, utils?: U, mergeFn?: typeof Object.assign): T;
-export declare function applyOptionsChain<T, U>(defaults: T, options: T | ((config: T, utils: U) => T | void) | Array<T | ((config: T, utils: U) => T | void)> | Falsy, utils: U, mergeFn?: typeof Object.assign): T;

package/dist/types/cli/commands.d.ts

@@ -1,8 +0,0 @@
-import type { Command } from '../../compiled/commander';
-export declare const getFullArgv: () => string[];
-export declare const getArgv: () => string[];
-export declare const getCommand: () => string;
-export declare const isDevCommand: () => boolean;
-export declare const deprecatedCommands: (program: Command & {
-    commandsMap?: Map<string, Command>;
-}) => void;

package/dist/types/cli/common.d.ts

@@ -1,9 +0,0 @@
-import debug from '../../compiled/debug';
-/**
- * Create debug function with unified namespace prefix.
- * @param scope - Custom module name of your debug function.
- * @returns Debug function which namespace start with modern-js:.
- */
-export declare const createDebugger: (scope: string) => debug.Debugger;
-export declare const clearConsole: () => void;
-export declare const wait: (time?: number) => Promise<unknown>;

package/dist/types/cli/config.d.ts

@@ -1,4 +0,0 @@
-/**
- * When merging config, some properties prefer `override` rather than `merge to array`
- */
-export declare const isOverriddenConfigKey: (key: string) => boolean;

package/dist/types/cli/constants.d.ts

@@ -1,55 +0,0 @@
-import type { InternalPlugins } from '@modern-js/types';
-export { DEFAULT_ENTRY_NAME, MAIN_ENTRY_NAME, NESTED_ROUTE_SPEC_FILE, ROUTE_SPEC_FILE, SERVER_BUNDLE_DIRECTORY, SERVER_PLUGIN_BFF, SERVER_PLUGIN_POLYFILL, SERVER_RENDER_FUNCTION_NAME, } from '../universal/constants';
-export declare const JS_EXTENSIONS: string[];
-/**
- * server side bundles directory, which relative to dist.
- */
-export declare const SERVER_WORKER_BUNDLE_DIRECTORY = "worker";
-/**
- * entry name pattern used for ajv pattern properties.
- */
-export declare const ENTRY_NAME_PATTERN = "^[a-zA-Z0-9_-]+$";
-/**
- * loadbale manifest json file
- */
-export declare const LOADABLE_STATS_FILE = "loadable-stats.json";
-/**
- * internal specified folder
- */
-export declare const API_DIR = "api";
-/**
- * Default BFF API prefix
- */
-export declare const DEFAULT_API_PREFIX = "/api";
-export declare const SERVER_DIR = "server";
-export declare const SHARED_DIR = "shared";
-/**
- * Project root tsconfig filename.
- */
-export declare const TS_CONFIG_FILENAME = "tsconfig.json";
-/**
- * Modern.config.ts cached dir
- */
-export declare const CONFIG_CACHE_DIR = "./node_modules/.cache/bundle-require";
-export declare const CONFIG_FILE_EXTENSIONS: string[];
-/**
- * Serialized config path
- */
-export declare const OUTPUT_CONFIG_FILE = "modern.config.json";
-/**
- * Default runtime config filename
- */
-export declare const DEFAULT_RUNTIME_CONFIG = "modern.runtime";
-/**
- * Routes manifest filename
- */
-export declare const ROUTE_MANIFEST_FILE = "routes-manifest.json";
-/**
- * directory name for loader routes
- */
-export declare const LOADER_ROUTES_DIR = "loader-routes";
-/**
- * default host for dev
- */
-export declare const DEFAULT_DEV_HOST = "0.0.0.0";
-export declare const INTERNAL_RUNTIME_PLUGINS: InternalPlugins;

package/dist/types/cli/ensure.d.ts

@@ -1,8 +0,0 @@
-/**
- * ensure absolute file path.
- * @param base - Base path to resolve relative from.
- * @param filePath - Absolute or relative file path.
- * @returns Resolved absolute file path.
- */
-export declare const ensureAbsolutePath: (base: string, filePath: string) => string;
-export declare const ensureArray: <T>(params: T | T[]) => T[];

package/dist/types/cli/fs.d.ts

@@ -1,7 +0,0 @@
-/**
- * Find first already exists file.
- * @param files - Absolute file paths with extension.
- * @returns The file path if exists, or false if no file exists.
- */
-export declare const findExists: (files: string[]) => string | false;
-export declare const emptyDir: (dir: string) => Promise<void>;

package/dist/types/cli/get/config.d.ts

@@ -1 +0,0 @@
-export declare const getEntryOptions: <T>(name: string, isMainEntry: boolean, baseOptions?: T, optionsByEntries?: Record<string, T>, packageName?: string) => T | undefined;

package/dist/types/cli/get/data.d.ts

@@ -1,6 +0,0 @@
-import type { InternalPlugins } from '@modern-js/types';
-export declare function getPackageManager(cwd?: string): Promise<"pnpm" | "npm" | "yarn">;
-export declare const getCoreJsVersion: (corejsPkgPath: string) => string;
-export declare function getInternalPlugins(appDirectory: string, internalPlugins?: InternalPlugins): string[];
-export declare const readTsConfig: (root: string) => any;
-export declare const readTsConfigByFile: (filename: string) => any;

package/dist/types/cli/get/index.d.ts

@@ -1,11 +0,0 @@
-export declare const getServerConfig: (appDirectory: string, configFile: string) => Promise<string | false>;
-/**
- * Transform the metaName
- * @param metaName The name of framework, the default value is 'modern-js'
- * @returns
- * modern-js -> modern
- */
-export declare const getMeta: (metaName?: string) => string;
-export declare const getTargetDir: (from: string, baseDir: string, targetBaseDir: string) => string;
-export * from './config';
-export * from './data';

package/dist/types/cli/index.d.ts

@@ -1,23 +0,0 @@
-export * from './alias';
-export * from './applyOptionsChain';
-export * from './commands';
-export * from './common';
-export * from './config';
-export * from './constants';
-export * from './ensure';
-export * from './fs';
-export * from './get';
-export * from './is';
-export * from './logger';
-export * from './modulePath';
-export * from './monorepo';
-export * from './package';
-export * from './path';
-export * from './port';
-export * from './prettyInstructions';
-export * from './require';
-export * from './route';
-export * from './runtimeExports';
-export * from './tsconfig';
-export * from './version';
-export * from './watch';

package/dist/types/cli/is/config.d.ts

@@ -1,22 +0,0 @@
-interface EntryPoint {
-    entryName: string;
-}
-/**
- * Is SSR project
- *
- * @param config - User config.
- * @returns Whether to use server side render.
- */
-export declare const isSSR: (config: any) => boolean;
-export declare const isUseSSRBundle: (config: any) => boolean;
-export declare const isUseRsc: (config: any) => boolean;
-/**
- * Is Worker project
- *
- * @param config - User config.
- * @returns Whether to use worker deploy.
- */
-export declare const isServiceWorker: (config: any) => boolean;
-export declare const isSSGEntry: (config: any, entryName: string, entrypoints: EntryPoint[]) => any;
-export declare const isSingleEntry: (entrypoints: EntryPoint[], mainEntryName?: string) => boolean;
-export {};

package/dist/types/cli/is/env.d.ts

@@ -1,8 +0,0 @@
-/**
- * Get the current NODE_ENV, or default to 'development' if not set.
- */
-export declare const getNodeEnv: () => string;
-export declare const isDev: () => boolean;
-export declare const isProd: () => boolean;
-export declare const isTest: () => boolean;
-export declare const isBrowser: () => boolean;

package/dist/types/cli/is/index.d.ts

@@ -1,4 +0,0 @@
-export * from './config';
-export * from './env';
-export * from './project';
-export * from './type';

package/dist/types/cli/is/project.d.ts

@@ -1,39 +0,0 @@
-/**
- * Check if the package name is in dependencies or devDependencies.
- *
- * @param appDirectory - Project root directory.
- * @param name - Package name.
- * @returns True if the name is in dependencies or devDependencies, false otherwise.
- */
-export declare const isDepExists: (appDirectory: string, name: string) => boolean;
-/**
- * Try to resolve npm package, return true if package is installed.
- */
-export declare const isPackageInstalled: (name: string, resolvePaths: string | string[]) => boolean;
-/**
- * Check is api only project
- * 1. env --api-only
- * 2. exist ${apiDir}/ && not exist ${entryDir}/
- *
- * @param appDirectory
- * @param entryDir default 'src'
- * @param apiDir default 'api'
- * @returns boolean
- */
-export declare const isApiOnly: (appDirectory: string, entryDir?: string, apiDir?: string) => Promise<boolean>;
-export declare const isWebOnly: () => Promise<boolean>;
-export declare const isVersionBeyond17: (version: string) => boolean;
-export declare const getReactVersion: (cwd: string) => string | false;
-/**
- * @deprecated Use {@link isSupportAutomaticJsx} to check if the project supports automatic JSX instead.
- */
-export declare const isBeyondReact17: (cwd: string) => boolean;
-export declare const isSupportAutomaticJsx: (cwd: string) => boolean;
-export declare const isReact18: (cwd?: string) => boolean;
-/**
- * Is typescript project.
- *
- * @param root - App directory.
- * @returns Whether to use typescript.
- */
-export declare const isTypescript: (root: string) => boolean;

package/dist/types/cli/is/type.d.ts

@@ -1,15 +0,0 @@
-export declare function isString(str: any): str is string;
-export declare function isUndefined(obj: any): obj is undefined;
-export declare function isArray(obj: unknown): obj is any[];
-export declare function isFunction(func: any): func is Function;
-export declare function isObject(obj: unknown): obj is Record<string, any>;
-export declare function isPlainObject(obj: unknown): obj is Record<string, any>;
-export declare function isPromise(obj: any): obj is Promise<any>;
-export declare function isRegExp(obj: any): obj is RegExp;
-/**
- * Is Empty object
- *
- * @param o - Any object.
- * @returns Whether it is empty object.
- */
-export declare const isEmpty: (o: Record<string, unknown>) => boolean;

package/dist/types/cli/logger.d.ts

@@ -1 +0,0 @@
-export { createLogger, type Logger, logger } from 'rslog';

package/dist/types/cli/modulePath.d.ts

@@ -1,5 +0,0 @@
-import type { MatchPath } from '../../compiled/tsconfig-paths';
-export declare const SOURCE_EXTENSIONS: string[];
-export declare const JS_LIKE_EXTENSION_RE: RegExp;
-export declare const findSourceEntry: (resolvedPath: string) => string | undefined;
-export declare const findMatchedSourcePath: (matchPath: MatchPath, specifier: string) => string | undefined;

package/dist/types/cli/monorepo.d.ts

@@ -1,9 +0,0 @@
-export declare const isLerna: (root: string) => boolean;
-export declare const isYarnWorkspaces: (root: string) => boolean;
-export declare const isPnpmWorkspaces: (root: string) => boolean;
-export declare const isMonorepo: (root: string) => boolean;
-export declare const findMonorepoRoot: (appDirectory: string, maxDepth?: number) => string | undefined;
-export declare const getMonorepoPackages: (root: string) => {
-    name: string;
-    path: string;
-}[];

package/dist/types/cli/package.d.ts

@@ -1,5 +0,0 @@
-export declare function getPnpmVersion(): Promise<string>;
-export declare function canUseNpm(): Promise<boolean>;
-export declare function canUseYarn(): Promise<boolean>;
-export declare function canUsePnpm(): Promise<boolean>;
-export declare function removeModuleSyncFromExports(exports: Record<string, any>): Record<string, any>;

package/dist/types/cli/path.d.ts

@@ -1,11 +0,0 @@
-export declare const isPathString: (test: string) => boolean;
-export declare const isRelativePath: (test: string) => boolean;
-export declare const normalizeOutputPath: (s: string) => string;
-export declare const normalizeToPosixPath: (p: string | undefined) => string;
-export declare const getTemplatePath: (prefix?: string) => string;
-export declare function getRealTemporaryDirectory(): string | null;
-export declare function splitPathString(str: string): string[];
-export declare const removeLeadingSlash: (s: string) => string;
-export declare const removeTailSlash: (s: string) => string;
-export declare const removeSlash: (s: string) => string;
-export declare function formatImportPath(str: string): string;

package/dist/types/cli/port.d.ts

@@ -1,12 +0,0 @@
-/**
- * Get available free port.
- * @param port - Current port want to use.
- * @param tryLimits - Maximum number of retries.
- * @param strictPort - Whether to throw an error when the port is occupied.
- * @returns Available port number.
- */
-export declare const getPort: (expectPort: string | number, { tryLimits, strictPort, slient, }?: {
-    tryLimits?: number;
-    strictPort?: boolean;
-    slient?: boolean;
-}) => Promise<number>;

package/dist/types/cli/prettyInstructions.d.ts

@@ -1,9 +0,0 @@
-export type AddressUrl = {
-    label: string;
-    url: string;
-};
-export declare const getAddressUrls: (protocol: string | undefined, port: number, host?: string) => {
-    label: string;
-    url: string;
-}[];
-export declare const prettyInstructions: (appContext: any, config: any) => string;

package/dist/types/cli/require.d.ts

@@ -1,9 +0,0 @@
-export declare function compatibleRequire(path: string, interop?: boolean): Promise<any>;
-export declare function loadFromProject(moduleName: string, appDir: string): Promise<any>;
-export declare const dynamicImport: Function;
-export declare const requireExistModule: (filename: string, opt?: {
-    extensions?: string[];
-    interop?: boolean;
-}) => Promise<any>;
-export declare const cleanRequireCache: (filelist: string[]) => void;
-export declare const tryResolve: (name: string, ...resolvePath: string[]) => string;

package/dist/types/cli/route.d.ts

@@ -1,4 +0,0 @@
-import type { NestedRouteForCli, PageRoute } from '@modern-js/types';
-export declare function filterRoutesForServer(routes: (NestedRouteForCli | PageRoute)[]): (NestedRouteForCli | PageRoute)[];
-export declare function filterRoutesLoader(routes: (NestedRouteForCli | PageRoute)[]): (NestedRouteForCli | PageRoute)[];
-export declare function markRoutes(routes: (NestedRouteForCli | PageRoute)[], routeIds: string[]): (NestedRouteForCli | PageRoute)[];

package/dist/types/cli/runtimeExports.d.ts

@@ -1,5 +0,0 @@
-export declare const createRuntimeExportsUtils: (internalDirectory: string, filename: string) => {
-    addExport(exportStatement: string): void;
-    getPath(): string;
-};
-export type RuntimeExportsUtils = ReturnType<typeof createRuntimeExportsUtils>;

package/dist/types/cli/tsconfig.d.ts

@@ -1 +0,0 @@
-export declare const resolveServerTsconfig: (appDirectory: string, configuredPath?: string) => string;

package/dist/types/cli/version.d.ts

@@ -1,4 +0,0 @@
-export declare function isVersionAtLeast1819(): boolean;
-export declare function isVersionAtLeast18(): boolean;
-export declare function isVersionAtLeast22(): boolean;
-export declare function isVersionAtLeast20(): boolean;

package/dist/types/cli/watch.d.ts

@@ -1,8 +0,0 @@
-export type WatchChangeTypeValueT = 'add' | 'unlink' | 'change';
-export declare const WatchChangeType: Record<'ADD' | 'UNLINK' | 'CHANGE', WatchChangeTypeValueT>;
-type RunTaskType = (option: {
-    changedFilePath: string;
-    changeType: WatchChangeTypeValueT;
-}) => void | Promise<void>;
-export declare const watch: (watchDir: string | string[], runTask: RunTaskType, ignored?: (string | RegExp)[]) => import("../../../compiled/chokidar/types").FSWatcher;
-export {};

package/dist/types/compiled.d.ts

@@ -1,37 +0,0 @@
-export { default as address } from '../compiled/address';
-export { default as browserslist } from '../compiled/browserslist';
-export { default as chalk } from '../compiled/chalk';
-export { Command, program } from '../compiled/commander';
-export { default as debug } from '../compiled/debug';
-export { default as dotenv } from '../compiled/dotenv';
-export { default as dotenvExpand } from '../compiled/dotenv-expand';
-export { default as execa } from '../compiled/execa';
-export { default as fastGlob } from '../compiled/fast-glob';
-export { default as filesize } from '../compiled/filesize';
-export { default as fs } from '../compiled/fs-extra';
-export { default as glob } from '../compiled/glob';
-export { default as globby } from '../compiled/globby';
-export { default as gzipSize } from '../compiled/gzip-size';
-export { default as yaml } from '../compiled/js-yaml';
-export { default as json5 } from '../compiled/json5';
-export { default as lodash } from '../compiled/lodash';
-export { default as minimist } from '../compiled/minimist';
-export { nanoid } from '../compiled/nanoid';
-export { default as ora } from '../compiled/ora';
-export { default as pkgUp } from '../compiled/pkg-up/index.js';
-export { default as semver } from '../compiled/semver';
-export { default as signale } from '../compiled/signale';
-export { default as slash } from '../compiled/slash';
-export { default as stripAnsi } from '../compiled/strip-ansi';
-export { default as upath } from '../compiled/upath';
-export { default as urlJoin } from '../compiled/url-join';
-import _signale from '../compiled/signale';
-export declare const Signale: _signale.SignaleConstructor;
-export type { FSWatcher, WatchOptions } from '../compiled/chokidar';
-export type { ExecaError } from '../compiled/execa';
-export type { IOptions as GlobOptions } from '../compiled/glob';
-export type { GlobbyOptions } from '../compiled/globby';
-export type { SignaleOptions } from '../compiled/signale';
-export declare const mime: typeof import('../compiled/mime-types');
-export declare const chokidar: typeof import('../compiled/chokidar');
-export declare const inquirer: typeof import('../compiled/inquirer');

package/dist/types/import.d.ts

@@ -1,5 +0,0 @@
-declare const lazy: (moduleName: string, getRequireFn: () => (id: string) => unknown) => any;
-export { lazy as lazyImport };
-export declare const Import: {
-    lazy: (moduleName: string, getRequireFn: () => (id: string) => unknown) => any;
-};

package/dist/types/index.d.ts

@@ -1,3 +0,0 @@
-export * from './cli';
-export * from './compiled';
-export * from './import';

package/dist/types/universal/constants.d.ts

@@ -1,47 +0,0 @@
-/**
- * Property mounted on window that describes route manifest
- */
-export declare const ROUTE_MANIFEST = "_MODERNJS_ROUTE_MANIFEST";
-/**
- * Property mounted on window that record all route modules
- */
-export declare const ROUTE_MODULES = "_routeModules";
-/**
- * html placeholder
- */
-export declare const HTML_CHUNKSMAP_SEPARATOR = "<!--<?- chunksMap.js ?>-->";
-/**
- * reporter name for server loader
- */
-export declare const LOADER_REPORTER_NAME = "server-loader";
-/**
- * route specification file
- */
-export declare const ROUTE_SPEC_FILE = "route.json";
-/**
- * Front-end routing metadata
- */
-export declare const NESTED_ROUTE_SPEC_FILE = "nestedRoutes.json";
-/**
- * main entry name
- */
-export declare const MAIN_ENTRY_NAME = "main";
-/**
- * default entry name
- */
-export declare const DEFAULT_ENTRY_NAME = "index";
-/**
- * server side bundles directory, which relative to dist.
- */
-export declare const SERVER_BUNDLE_DIRECTORY = "bundles";
-/**
- * SSR server render function name
- */
-export declare const SERVER_RENDER_FUNCTION_NAME = "serverRender";
-export declare const SERVER_PLUGIN_BFF = "@modern-js/plugin-bff";
-export declare const SERVER_PLUGIN_POLYFILL = "@modern-js/plugin-polyfill";
-/**
- * React useId identifier prefix for SSR hydration consistency
- * Ensures server and client generate the same ID prefixes
- */
-export declare const SSR_HYDRATION_ID_PREFIX = "modern-js-";

package/dist/types/universal/index.d.ts

@@ -1 +0,0 @@
-export { cutNameByHyphen } from './path';

package/dist/types/universal/path.d.ts

@@ -1 +0,0 @@
-export declare const cutNameByHyphen: (s: string) => string;

package/dist/types/universal/pluginDagSort.d.ts

@@ -1 +0,0 @@
-export declare const pluginDagSort: <P extends Record<string, any>>(plugins: P[], key?: string, preKey?: string, postKey?: string) => P[];