@bleedingdev/modern-js-app-tools 3.2.0-ultramodern.0

package/dist/types/config/initialize/inits.d.ts

@@ -0,0 +1,4 @@
+import type { AppNormalizedConfig } from '../../types';
+import type { AppToolsContext } from '../../types/plugin';
+export declare function initHtmlConfig(config: AppNormalizedConfig, appContext: AppToolsContext): AppNormalizedConfig['html'];
+export declare function initSourceConfig(config: AppNormalizedConfig, appContext: AppToolsContext): void;

package/dist/types/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_CONFIG_FILE = "modern.config";
+export declare const DEFAULT_RUNTIME_CONFIG_FILE = "modern.runtime";

package/dist/types/defineConfig.d.ts

@@ -0,0 +1,11 @@
+import type { AppUserConfig } from './types';
+export type ConfigParams = {
+    env: string;
+    command: string;
+};
+export type UserConfigExport<Config> = Config | ((env: ConfigParams) => Config | Promise<Config>);
+/**
+ * This function helps you to autocomplete configuration types.
+ * It accepts a direct config object, or a function that returns a config.
+ */
+export declare const defineConfig: (config: UserConfigExport<AppUserConfig>) => UserConfigExport<import("./types").AppToolsUserConfig>;

package/dist/types/esm/register-esm.d.mts

@@ -0,0 +1,11 @@
+export function registerModuleHooks({ appDir, distDir, baseUrl, paths, }: {
+    appDir: any;
+    distDir: any;
+    baseUrl: any;
+    paths: any;
+}): Promise<void>;
+export function registerPathsLoader({ appDir, baseUrl, paths }: {
+    appDir: any;
+    baseUrl: any;
+    paths: any;
+}): Promise<void>;

package/dist/types/esm/ts-node-loader.d.mts

@@ -0,0 +1,6 @@
+export function initialize({ baseUrl, paths }: {
+    baseUrl: any;
+    paths: any;
+}): Promise<void>;
+export function resolve(specifier: any, context: any, defaultResolve: any): any;
+export function load(url: any, context: any, defaultLoad: any): any;

package/dist/types/esm/ts-paths-loader.d.mts

@@ -0,0 +1,6 @@
+export function initialize({ appDir: currentAppDir, baseUrl, paths }: {
+    appDir: any;
+    baseUrl: any;
+    paths: any;
+}): Promise<void>;
+export function resolve(specifier: any, context: any, defaultResolve: any): any;

package/dist/types/exports/server.d.ts

@@ -0,0 +1 @@
+export type { ServerPlugin } from '@modern-js/server-core';

package/dist/types/index.d.ts

@@ -0,0 +1,17 @@
+import type { AppTools, CliPlugin } from './types';
+import { initAppContext } from './utils/initAppContext';
+export * from './baseline';
+export * from './defineConfig';
+export * from './presetUltramodern';
+export * from './ultramodern/designSystem';
+export declare const appTools: () => CliPlugin<AppTools>;
+export { dev } from './commands/dev';
+export { serve } from './commands/serve';
+export { defineConfig } from './defineConfig';
+export { type ResolveModernRsbuildConfigOptions, resolveModernRsbuildConfig, } from './rsbuild';
+export * from './types';
+export { generateWatchFiles } from './utils/generateWatchFiles';
+export type { DevOptions } from './utils/types';
+export { initAppContext };
+export default appTools;
+export { mergeConfig } from '@modern-js/plugin/cli';

package/dist/types/locale/en.d.ts

@@ -0,0 +1,44 @@
+export declare const EN_LOCALE: {
+    command: {
+        shared: {
+            analyze: string;
+            config: string;
+            skipBuild: string;
+            noNeedInstall: string;
+        };
+        dev: {
+            describe: string;
+            entry: string;
+            apiOnly: string;
+            webOnly: string;
+            selectEntry: string;
+            requireEntry: string;
+        };
+        build: {
+            describe: string;
+            watch: string;
+        };
+        serve: {
+            describe: string;
+        };
+        deploy: {
+            describe: string;
+        };
+        new: {
+            describe: string;
+            debug: string;
+            config: string;
+            distTag: string;
+            registry: string;
+            lang: string;
+        };
+        inspect: {
+            env: string;
+            output: string;
+            verbose: string;
+        };
+        info: {
+            describe: string;
+        };
+    };
+};

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

@@ -0,0 +1,90 @@
+import { I18n } from '@modern-js/i18n-utils';
+declare const i18n: I18n;
+declare const localeKeys: {
+    command: {
+        shared: {
+            analyze: string;
+            config: string;
+            skipBuild: string;
+            noNeedInstall: string;
+        };
+        dev: {
+            describe: string;
+            entry: string;
+            apiOnly: string;
+            webOnly: string;
+            selectEntry: string;
+            requireEntry: string;
+        };
+        build: {
+            describe: string;
+            watch: string;
+        };
+        serve: {
+            describe: string;
+        };
+        deploy: {
+            describe: string;
+        };
+        new: {
+            describe: string;
+            debug: string;
+            config: string;
+            distTag: string;
+            registry: string;
+            lang: string;
+        };
+        inspect: {
+            env: string;
+            output: string;
+            verbose: string;
+        };
+        info: {
+            describe: string;
+        };
+    };
+} | {
+    command: {
+        shared: {
+            analyze: string;
+            config: string;
+            skipBuild: string;
+            noNeedInstall: string;
+        };
+        dev: {
+            describe: string;
+            entry: string;
+            apiOnly: string;
+            webOnly: string;
+            selectEntry: string;
+            requireEntry: string;
+        };
+        build: {
+            describe: string;
+            watch: string;
+        };
+        serve: {
+            describe: string;
+        };
+        deploy: {
+            describe: string;
+        };
+        new: {
+            describe: string;
+            debug: string;
+            config: string;
+            distTag: string;
+            registry: string;
+            lang: string;
+        };
+        inspect: {
+            env: string;
+            output: string;
+            verbose: string;
+        };
+        info: {
+            describe: string;
+        };
+    };
+};
+export { i18n, localeKeys };

package/dist/types/locale/zh.d.ts

@@ -0,0 +1,44 @@
+export declare const ZH_LOCALE: {
+    command: {
+        shared: {
+            analyze: string;
+            config: string;
+            skipBuild: string;
+            noNeedInstall: string;
+        };
+        dev: {
+            describe: string;
+            entry: string;
+            apiOnly: string;
+            webOnly: string;
+            selectEntry: string;
+            requireEntry: string;
+        };
+        build: {
+            describe: string;
+            watch: string;
+        };
+        serve: {
+            describe: string;
+        };
+        deploy: {
+            describe: string;
+        };
+        new: {
+            describe: string;
+            debug: string;
+            config: string;
+            distTag: string;
+            registry: string;
+            lang: string;
+        };
+        inspect: {
+            env: string;
+            output: string;
+            verbose: string;
+        };
+        info: {
+            describe: string;
+        };
+    };
+};

package/dist/types/plugins/analyze/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const ENTRY_FILE_NAME = "entry";
+export declare const HTML_PARTIALS_FOLDER = "html";
+export declare const HTML_PARTIALS_EXTENSIONS: string[];

package/dist/types/plugins/analyze/getBundleEntry.d.ts

@@ -0,0 +1,4 @@
+import type { Entrypoint } from '@modern-js/types';
+import type { AppNormalizedConfig } from '../../types';
+import type { AppToolsContext, AppToolsHooks } from '../../types/plugin';
+export declare const getBundleEntry: (hooks: AppToolsHooks, appContext: AppToolsContext, config: AppNormalizedConfig) => Promise<Entrypoint[]>;

package/dist/types/plugins/analyze/getFileSystemEntry.d.ts

@@ -0,0 +1,7 @@
+import type { Entrypoint } from '@modern-js/types';
+import type { AppNormalizedConfig } from '../../types';
+import type { AppToolsContext, AppToolsHooks } from '../../types/plugin';
+export type { Entrypoint };
+export declare const hasEntry: (dir: string) => string | false;
+export declare const hasServerEntry: (dir: string) => string | false;
+export declare const getFileSystemEntry: (hooks: AppToolsHooks, appContext: AppToolsContext, config: AppNormalizedConfig) => Promise<Entrypoint[]>;

package/dist/types/plugins/analyze/getHtmlTemplate.d.ts

@@ -0,0 +1,27 @@
+import type { Entrypoint, HtmlPartials, HtmlTemplates } from '@modern-js/types';
+import type { AppNormalizedConfig } from '../../types';
+import type { AppToolsContext, AppToolsHooks } from '../../types/plugin';
+export declare const getModifyHtmlPartials: (partials: Record<keyof HtmlPartials, string[]>) => {
+    top: {
+        append: (...script: string[]) => void;
+        prepend: (...script: string[]) => void;
+        current: string[];
+    };
+    head: {
+        append: (...script: string[]) => void;
+        prepend: (...script: string[]) => void;
+        current: string[];
+    };
+    body: {
+        append: (...script: string[]) => void;
+        prepend: (...script: string[]) => void;
+        current: string[];
+    };
+};
+export declare const getHtmlTemplate: (entrypoints: Entrypoint[], hooks: AppToolsHooks, { appContext, config, }: {
+    appContext: AppToolsContext;
+    config: AppNormalizedConfig;
+}) => Promise<{
+    partialsByEntrypoint: Record<string, HtmlPartials>;
+    htmlTemplates: HtmlTemplates;
+}>;

package/dist/types/plugins/analyze/getServerRoutes.d.ts

@@ -0,0 +1,8 @@
+import type { Entrypoint, ServerRoute } from '@modern-js/types';
+import type { AppNormalizedConfig } from '../../types';
+import type { AppToolsContext } from '../../types/plugin';
+export declare const getServerRoutes: (entrypoints: Entrypoint[], { appContext, config, }: {
+    appContext: AppToolsContext;
+    config: AppNormalizedConfig;
+}) => ServerRoute[];
+export declare const getProdServerRoutes: (distDirectory: string) => any;

package/dist/types/plugins/analyze/index.d.ts

@@ -0,0 +1,3 @@
+import type { AppTools, CliPlugin } from '../../types';
+declare const _default: () => CliPlugin<AppTools>;
+export default _default;

package/dist/types/plugins/analyze/isDefaultExportFunction.d.ts

@@ -0,0 +1 @@
+export declare const isDefaultExportFunction: (file: string | false) => boolean;

package/dist/types/plugins/analyze/templates.d.ts

@@ -0,0 +1,5 @@
+export declare const html: (partials: {
+    top: string[];
+    head: string[];
+    body: string[];
+}) => string;

package/dist/types/plugins/analyze/utils.d.ts

@@ -0,0 +1,10 @@
+export declare const walkDirectory: (dir: string) => string[];
+export declare const replaceWithAlias: (base: string, filePath: string, alias: string) => string;
+export declare const parseModule: ({ source, filename, }: {
+    source: string;
+    filename: string;
+}) => Promise<readonly [imports: readonly import("es-module-lexer").ImportSpecifier[], exports: readonly import("es-module-lexer").ExportSpecifier[], facade: boolean, hasModuleSyntax: boolean]>;
+export declare const getServerCombinedModuleFile: (internalDirectory: string, entryName: string) => string;
+export declare const checkIsBuildCommands: () => boolean;
+export declare const checkIsServeCommand: () => boolean;
+export declare const isSubDirOrEqual: (parent: string, child: string) => boolean;

package/dist/types/plugins/deploy/index.d.ts

@@ -0,0 +1,3 @@
+import type { AppTools, CliPlugin } from '../../types';
+declare const _default: () => CliPlugin<AppTools>;
+export default _default;

package/dist/types/plugins/deploy/platforms/gh-pages.d.ts

@@ -0,0 +1,2 @@
+import type { CreatePreset } from './platform';
+export declare const createGhPagesPreset: CreatePreset;

package/dist/types/plugins/deploy/platforms/netlify.d.ts

@@ -0,0 +1,2 @@
+import type { CreatePreset } from './platform';
+export declare const createNetlifyPreset: CreatePreset;

package/dist/types/plugins/deploy/platforms/node.d.ts

@@ -0,0 +1,2 @@
+import type { CreatePreset } from './platform';
+export declare const createNodePreset: CreatePreset;

package/dist/types/plugins/deploy/platforms/platform.d.ts

@@ -0,0 +1,17 @@
+import type { AppToolsNormalizedConfig } from '../../../types';
+import type { AppToolsContext } from '../../../types/plugin';
+import type { PluginAPI } from '../types';
+interface CreatePresetParams {
+    appContext: AppToolsContext;
+    modernConfig: AppToolsNormalizedConfig;
+    api: PluginAPI;
+    needModernServer?: boolean;
+}
+export type CreatePreset = (params: CreatePresetParams) => DeployPreset;
+type DeployPreset = {
+    prepare?: () => Promise<void>;
+    writeOutput?: () => Promise<void>;
+    genEntry?: () => Promise<void>;
+    end?: () => Promise<void>;
+};
+export {};

package/dist/types/plugins/deploy/platforms/templates/netlify-entry.d.cts

@@ -0,0 +1,2 @@
+export default handler;
+declare function handler(request: any, context: any): Promise<any>;

package/dist/types/plugins/deploy/platforms/templates/netlify-entry.d.mts

@@ -0,0 +1,2 @@
+export default handler;
+declare function handler(request: any, context: any): Promise<any>;

package/dist/types/plugins/deploy/platforms/templates/node-entry.d.cts

@@ -0,0 +1 @@
+export {};

package/dist/types/plugins/deploy/platforms/templates/node-entry.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/types/plugins/deploy/platforms/templates/vercel-entry.d.cts

@@ -0,0 +1,2 @@
+export = handler;
+declare function handler(req: any, res: any): Promise<any>;

package/dist/types/plugins/deploy/platforms/templates/vercel-entry.d.mts

@@ -0,0 +1,2 @@
+export default handler;
+declare function handler(req: any, res: any): Promise<any>;

package/dist/types/plugins/deploy/platforms/vercel.d.ts

@@ -0,0 +1,2 @@
+import type { CreatePreset } from './platform';
+export declare const createVercelPreset: CreatePreset;

package/dist/types/plugins/deploy/types.d.ts

@@ -0,0 +1,3 @@
+import type { AppTools, CliPlugin } from '../../types';
+export type Setup = NonNullable<CliPlugin<AppTools>['setup']>;
+export type PluginAPI = Parameters<Setup>[0];

package/dist/types/plugins/deploy/utils/generator.d.ts

@@ -0,0 +1,24 @@
+import type { ProdServerOptions } from '@modern-js/prod-server';
+import type { AppToolsNormalizedConfig } from '../../../types';
+import type { AppToolsContext } from '../../../types/plugin';
+export declare const serverAppContextTemplate: (appContext: AppToolsContext) => {
+    sharedDirectory: string;
+    apiDirectory: string;
+    lambdaDirectory: string;
+    metaName: string;
+    bffRuntimeFramework: "hono" | "effect";
+};
+export type PluginItem = [string, Record<string, any> | undefined];
+export declare const genPluginImportsCode: (plugins: PluginItem[], isESM?: boolean) => string;
+export declare const getPluginsCode: (plugins: PluginItem[]) => string;
+export declare const getServerConfigPath: (meta: string) => string;
+export interface GenerateHandlerOptions {
+    template: string;
+    appContext: AppToolsContext;
+    config: AppToolsNormalizedConfig;
+    serverConfig?: Partial<ProdServerOptions>;
+    genAppContextTemplate?: typeof serverAppContextTemplate;
+    genPluginImports?: typeof genPluginImportsCode;
+    isESM?: boolean;
+}
+export declare const generateHandler: ({ template, appContext, config, serverConfig: modifyServerConfig, genAppContextTemplate, genPluginImports, isESM, }: GenerateHandlerOptions) => Promise<string>;

package/dist/types/plugins/deploy/utils/index.d.ts

@@ -0,0 +1,16 @@
+export type ServerAppContext = {
+    sharedDirectory: string;
+    apiDirectory: string;
+    lambdaDirectory: string;
+    metaName: string;
+    bffRuntimeFramework: string;
+};
+export declare const normalizePath: (filePath: string) => string;
+export declare const getProjectUsage: (appDirectory: string, distDirectory: string, metaName: string) => {
+    useSSR: boolean;
+    useAPI: boolean;
+    useWebServer: boolean;
+};
+export declare const getTemplatePath: (file: string) => string;
+export declare const readTemplate: (file: string) => Promise<string>;
+export declare const resolveESMDependency: (entry: string) => Promise<string | undefined>;

package/dist/types/plugins/initialize/index.d.ts

@@ -0,0 +1,3 @@
+import type { AppTools, CliPlugin } from '../../types';
+declare const _default: () => CliPlugin<AppTools>;
+export default _default;

package/dist/types/plugins/serverBuild.d.ts

@@ -0,0 +1,3 @@
+import type { AppTools, CliPlugin } from '../types';
+declare const _default: () => CliPlugin<AppTools>;
+export default _default;

package/dist/types/plugins/serverRuntime.d.ts

@@ -0,0 +1,3 @@
+import type { AppTools, CliPlugin } from '../types';
+declare const _default: () => CliPlugin<AppTools>;
+export default _default;

package/dist/types/presetUltramodern.d.ts

@@ -0,0 +1,6 @@
+import { type AppBaselineOptions } from './baseline';
+import type { AppUserConfig } from './types';
+export interface PresetUltramodernOptions extends AppBaselineOptions {
+}
+export declare const createPresetUltramodernConfig: (options?: PresetUltramodernOptions) => AppUserConfig;
+export declare const presetUltramodern: (config: AppUserConfig, options?: PresetUltramodernOptions) => AppUserConfig;

package/dist/types/rsbuild.d.ts

@@ -0,0 +1,12 @@
+import type { AppUserConfig } from './types';
+type ResolveModernRsbuildConfigOptions = {
+    command: string;
+    configPath?: string;
+    cwd?: string;
+    metaName?: string;
+    modifyModernConfig?: (config: AppUserConfig) => AppUserConfig | Promise<AppUserConfig>;
+};
+export declare function resolveModernRsbuildConfig(options: ResolveModernRsbuildConfigOptions): Promise<{
+    rsbuildConfig: import("@modern-js/builder").RsbuildConfig;
+}>;
+export type { ResolveModernRsbuildConfigOptions };

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

@@ -0,0 +1,20 @@
+import type { InternalPlugins } from '@modern-js/types';
+import { handleSetupResult } from '../compat/hooks';
+export interface RunOptions {
+    cwd?: string;
+    configFile?: string;
+    metaName?: string;
+    statePluginName?: string;
+    internalPlugins?: InternalPlugins;
+    initialLog?: string;
+    version: string;
+}
+export declare function createRunOptions({ cwd, initialLog, metaName, version, internalPlugins, configFile, }: RunOptions): Promise<{
+    cwd: string | undefined;
+    initialLog: string;
+    configFile: string;
+    metaName: string;
+    internalPlugins: import("@modern-js/plugin").Plugin[];
+    handleSetupResult: typeof handleSetupResult;
+}>;
+export declare function run(options: RunOptions): Promise<void>;

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

@@ -0,0 +1,38 @@
+export interface MicroFrontend {
+    /**
+     * Specifies whether to enable the HTML entry.
+     * When set to `true`, the current child application will be externalized for `react` and `react-dom`.
+     * @default true
+     */
+    enableHtmlEntry?: boolean;
+    /**
+     * Specifies whether to use the external base library.
+     * @default false
+     */
+    externalBasicLibrary?: boolean;
+    moduleApp?: string;
+    /**
+     * Runtime compatibility digest exposed in remote contracts (manifest / remote entry).
+     */
+    runtimeDigest?: string;
+    /**
+     * SRI-style integrity token for the remote entry contract.
+     * Example: `sha256-<base64Digest>`.
+     */
+    integrity?: string;
+    /**
+     * Opaque attestation token exposed in remote runtime metadata.
+     * Can be validated by the host via runtime `remoteTrust.attestations`.
+     */
+    attestation?: string;
+}
+export interface DeployUserConfig {
+    /**
+     * Used to configure micro-frontend sub-application information.
+     * @default false
+     */
+    microFrontend?: boolean | MicroFrontend;
+    worker?: {
+        ssr?: boolean;
+    };
+}

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

@@ -0,0 +1,55 @@
+import type { BuilderConfig } from '@modern-js/builder';
+import type { CorsOptions, SetupMiddlewares } from '@modern-js/server';
+import type { ServerConfig } from '@rsbuild/core';
+type BuilderDevConfig = NonNullable<BuilderConfig['dev']>;
+export type DevProxyOptions = string | Record<string, string>;
+export interface DevServerUserConfig {
+    /**
+     * Configure CORS for the dev server.
+     * - object: enable CORS with the specified options.
+     * - true: enable CORS with default options (allow all origins, not recommended).
+     * - false: disable CORS.
+     * @default
+     * ```js
+     * { origin: defaultAllowedOrigins }
+     * ```
+     * where `defaultAllowedOrigins` includes:
+     * - `localhost`
+     * - `127.0.0.1`
+     *
+     * @link https://github.com/expressjs/cors
+     */
+    cors?: boolean | CorsOptions;
+    /**
+     * Whether to enable gzip compression for served static assets.
+     */
+    compress?: ServerConfig['compress'];
+    /**
+     * Adds headers to all responses.
+     */
+    headers?: ServerConfig['headers'];
+    /**
+     * The index.html page will likely have to be served in place of any 404 responses.
+     */
+    historyApiFallback?: ServerConfig['historyApiFallback'];
+    /**
+     * Proxying some URLs.
+     */
+    proxy?: ServerConfig['proxy'];
+    /**
+     * Whether to watch files change in directories such as `mock/`, `server/`, `api/`.
+     */
+    watch?: boolean;
+}
+/**
+ * setupMiddlewares is a special field, it will not be passed to Rsbuild.
+ * Although its name is the same as in Rsbuild, it is consumed by Modern.js.
+ */
+export type DevUserConfig = Omit<BuilderDevConfig, 'setupMiddlewares'> & {
+    setupMiddlewares?: SetupMiddlewares;
+    /**
+     * Dev server specific options.
+     */
+    server?: DevServerUserConfig;
+};
+export {};

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

@@ -0,0 +1,3 @@
+import type { BuilderConfig } from '@modern-js/builder';
+export type BuilderExperimentsConfig = Required<BuilderConfig>['experiments'];
+export type ExperimentsUserConfig = BuilderExperimentsConfig;

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

@@ -0,0 +1,3 @@
+import type { BuilderConfig } from '@modern-js/builder';
+import type { UnwrapBuilderConfig } from '../utils';
+export type HtmlUserConfig = UnwrapBuilderConfig<BuilderConfig, 'html'>;