mbler 0.2.0 → 0.2.2

package/dist/build.d.ts

@@ -0,0 +1,145 @@
+import * as typescript from 'typescript';
+import { watch as watch$1 } from 'chokidar';
+import * as rollup from 'rollup';
+import { LanguagePlugin } from '@volar/language-core';
+
+interface MblerConfigScript {
+    ui?: boolean;
+    lang?: 'ts' | 'mcx' | 'js';
+    main: string;
+    UseBeta?: boolean;
+}
+interface MblerConfigOutdir {
+    behavior?: string;
+    resources?: string;
+    dist: string;
+}
+interface MblerConfigData {
+    name: string;
+    outdir?: MblerConfigOutdir;
+    description: string;
+    version: string;
+    mcVersion: string | string[];
+    script?: MblerConfigScript;
+    minify?: boolean;
+}
+interface CliParam {
+    params: string[];
+    opts: Record<string, string>;
+}
+
+/**
+ * 运行 MCX TypeScript 编译器
+ * 为 .mcx 文件提供 TypeScript 类型检查支持
+ */
+declare function runTSC(tscpath?: string): void;
+
+declare class Build {
+    private baseBuildDir;
+    private resolve;
+    private isWatch;
+    currentConfig: MblerConfigData | null;
+    srcDirs: {
+        [key in 'behavior' | 'resources']: string;
+    } | null;
+    outdirs: {
+        [key in 'behavior' | 'resources' | 'dist']: string;
+    } | null;
+    mcxTs: typeof typescript;
+    mcxLanguagePluginCreator: ((ts: typeof typescript) => LanguagePlugin<unknown>) | null;
+    constructor(opts: Record<string, string>, baseBuildDir: string, resolve: (a: number) => void, isWatch?: boolean);
+    /**
+     * Start the watch mode.
+     * This will perform an initial build (if not already done) and then
+     * start filesystem and rollup watchers.
+     * Returns the watcher handles once they are created so that callers
+     * (for example tests) can clean them up later.
+     */
+    watch(): Promise<null | undefined>;
+    start(): Promise<void>;
+    /**
+     * Handles returned from the currently-active watchers.
+     * Set by {@link createWatcher} and exposed via {@link getWatchers}
+     * so that external callers can close them when necessary (e.g. tests).
+     */
+    private watchers;
+    /**
+     * Returns the watcher handles if watch mode has been started.
+     * Can be safely called even before `watch()` has been invoked.
+     */
+    getWatchers(): {
+        rollup: rollup.RollupWatcher;
+        chokidar: ReturnType<typeof watch$1>;
+    } | null;
+    /**
+     * Close any active watchers.  The build process does not automatically
+     * terminate the watchers unless the process exits; tests or CLI wrappers
+     * can call this method to clean up resources.
+     */
+    closeWatchers(): void;
+    private rollupPlugin;
+    init: boolean;
+    /**
+     * Which modules are present in the current project.
+     * - "behavior" when only behavior code exists
+     * - "resources" when only resource files exist
+     * - "all" when both are present
+     * This field is populated during `handlerOtherAddon`.
+     */
+    module: 'behavior' | 'resources' | 'all' | null;
+    /**
+     * Determine whether a path refers to a regular file or a directory.
+     * Follows symbolic links recursively.  Throws if the path exists but
+     * is not one of the expected types.
+     *
+     * @param filePath file system path to inspect
+     * @returns "file" or "directory"
+     */
+    private fileType;
+    /**
+     * Perform a single build of the project located at {@link baseBuildDir}.
+     * The process is roughly:
+     * 1. load and validate the configuration file
+     * 2. prepare source and output directory information
+     * 3. copy addon files (behavior/resources)
+     * 4. generate manifest.json files
+     * 5. run rollup to bundle any script entry point
+     *
+     * If anything goes wrong the promise returned by the public wrapper
+     * (`build()` function exported at the bottom of this file) will be
+     * resolved with a non-zero code and appropriate log entries will be
+     * emitted.
+     */
+    private build;
+    /**
+     * Create and return a Rollup build instance configured for the
+     * project's script.  The Rollup configuration mirrors the options
+     * used by the CLI when running manual builds.
+     *
+     * Returns undefined if the project does not define a script section
+     * (in which case nothing needs to be bundled).
+     */
+    private createRollup;
+    /**
+     * Internal helper invoked by {@link watch}.
+     * Ensures a build has been run before starting the watchers.
+     */
+    private _watch;
+    private isParent;
+    private isChange;
+    private createRollupWatcher;
+    private onChange;
+    private createWatcher;
+    private handlerManifest;
+    private loadData;
+    /**
+     * Copy the various files (behavior/resources) into the corresponding
+     * output directories and determine which modules exist in the project
+     * by inspecting the source directories.
+     */
+    private handlerOtherAddon;
+}
+declare function build(cliParam: CliParam, work: string): Promise<number>;
+declare function watch(cliParam: CliParam, work: string): Promise<number>;
+
+export { Build, runTSC as McxTsc, build, watch };