@next2d/builder 0.1.8 → 0.1.11

package/dist/native.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @description iOS用アプリの書き出し関数
+ *              Export function for iOS apps
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export declare const runNative: () => Promise<void>;
+/**
+ * @description iOS/Androidアプリのオープン関数
+ *              Open function for iOS/Android apps
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export declare const openNative: () => Promise<void>;
+/**
+ * @description iOS/Androidアプリのビルド関数
+ *              Build function for iOS/Android apps
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export declare const buildNative: () => Promise<void>;

package/dist/native.js

@@ -0,0 +1,123 @@
+// iOS / Android (Capacitor) ビルド。
+import pc from "picocolors";
+import fs from "fs";
+import { ctx } from "./context.js";
+import { $spawn } from "./utils.js";
+import { CAPACITOR_CONFIG_NAME } from "./constants.js";
+/**
+ * @description iOS/Androidのプロジェクトを生成
+ *              Generate iOS/Android project
+ *
+ * @return {Promise}
+ * @method
+ * @private
+ */
+const generateNativeProject = () => {
+    return new Promise((resolve, reject) => {
+        if (fs.existsSync(`${process.cwd()}/${ctx.platform}`)) {
+            return resolve();
+        }
+        const stream = $spawn("npx", [
+            "cap",
+            "add",
+            ctx.platform
+        ], { "stdio": "inherit" });
+        stream.on("close", (code) => {
+            if (code !== 0) {
+                reject(`Failed generated ${ctx.platform} project.`);
+            }
+            console.log(pc.green(`Successfully generated ${ctx.platform} project.`));
+            console.log();
+            resolve();
+        });
+    });
+};
+/**
+ * @description Capacitor の webDir を現在のビルド出力へ書き換える
+ *              Point the Capacitor webDir at the current build output
+ *
+ * @return {void}
+ * @method
+ * @private
+ */
+const applyCapacitorWebDir = () => {
+    const config = JSON.parse(fs.readFileSync(`${process.cwd()}/${CAPACITOR_CONFIG_NAME}`, { "encoding": "utf8" }));
+    config.webDir = `${ctx.outDir}/${ctx.platformDir}/${ctx.environment}/`;
+    fs.writeFileSync(`${process.cwd()}/${CAPACITOR_CONFIG_NAME}`, JSON.stringify(config, null, 2));
+};
+/**
+ * @description iOS用アプリの書き出し関数
+ *              Export function for iOS apps
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export const runNative = async () => {
+    await generateNativeProject();
+    // Capacitorの書き出しに必要な設定を生成
+    applyCapacitorWebDir();
+    $spawn("npx", [
+        "cap",
+        "run",
+        ctx.platform
+    ], { "stdio": "inherit" });
+};
+/**
+ * @description iOS/Androidアプリのオープン関数
+ *              Open function for iOS/Android apps
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export const openNative = async () => {
+    await generateNativeProject();
+    // Capacitorの書き出しに必要な設定を生成
+    applyCapacitorWebDir();
+    const stream = $spawn("npx", [
+        "cap",
+        "sync",
+        ctx.platform
+    ], { "stdio": "inherit" });
+    stream.on("close", (code) => {
+        if (code !== 0) {
+            console.log(pc.red(`Failed to sync ${ctx.platform} project.`));
+            return;
+        }
+        $spawn("npx", [
+            "cap",
+            "open",
+            ctx.platform
+        ], { "stdio": "inherit" });
+    });
+};
+/**
+ * @description iOS/Androidアプリのビルド関数
+ *              Build function for iOS/Android apps
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export const buildNative = async () => {
+    await generateNativeProject();
+    // Capacitorの書き出しに必要な設定を生成
+    applyCapacitorWebDir();
+    const stream = $spawn("npx", [
+        "cap",
+        "sync",
+        ctx.platform
+    ], { "stdio": "inherit" });
+    stream.on("close", (code) => {
+        if (code !== 0) {
+            console.log(pc.red(`Failed to sync ${ctx.platform} project.`));
+            return;
+        }
+        $spawn("npx", [
+            "cap",
+            "build",
+            ctx.platform
+        ], { "stdio": "inherit" });
+    });
+};

package/dist/utils.d.ts

@@ -0,0 +1,27 @@
+import cp from "child_process";
+/**
+ * @description builder パッケージに同梱したテンプレートの絶対パスを取得
+ *              Get the absolute path of a template shipped with the builder package
+ *
+ * @param  {string} name
+ * @return {string}
+ * @method
+ * @public
+ */
+export declare const getTemplateDir: (name: string) => string;
+/**
+ * @description npx / npm を子プロセスとして起動する (クロスプラットフォーム)。
+ *              Windows では npx/npm が .cmd (バッチファイル) のため、shell 経由で
+ *              ないと起動できない (spawn ENOENT / Node の CVE-2024-27980 対応により
+ *              .cmd の直接 spawn も不可)。スペースを含む引数は二重引用符で保護する。
+ *              Spawn npx/npm cross-platform. On Windows they are .cmd batch files,
+ *              which require a shell to spawn.
+ *
+ * @param  {string} command
+ * @param  {array} args
+ * @param  {object} options
+ * @return {object}
+ * @method
+ * @public
+ */
+export declare const $spawn: (command: string, args: string[], options?: object) => cp.ChildProcess;

package/dist/utils.js

@@ -0,0 +1,40 @@
+// 汎用ユーティリティ (テンプレート解決 / 子プロセス起動)。
+import path from "path";
+import cp from "child_process";
+import { fileURLToPath } from "url";
+/**
+ * @description builder パッケージに同梱したテンプレートの絶対パスを取得
+ *              Get the absolute path of a template shipped with the builder package
+ *
+ * @param  {string} name
+ * @return {string}
+ * @method
+ * @public
+ */
+export const getTemplateDir = (name) => {
+    // dist/*.js から見た templates/ (パッケージルート直下)
+    const currentDir = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(currentDir, "..", "templates", name);
+};
+/**
+ * @description npx / npm を子プロセスとして起動する (クロスプラットフォーム)。
+ *              Windows では npx/npm が .cmd (バッチファイル) のため、shell 経由で
+ *              ないと起動できない (spawn ENOENT / Node の CVE-2024-27980 対応により
+ *              .cmd の直接 spawn も不可)。スペースを含む引数は二重引用符で保護する。
+ *              Spawn npx/npm cross-platform. On Windows they are .cmd batch files,
+ *              which require a shell to spawn.
+ *
+ * @param  {string} command
+ * @param  {array} args
+ * @param  {object} options
+ * @return {object}
+ * @method
+ * @public
+ */
+export const $spawn = (command, args, options = {}) => {
+    if (process.platform === "win32" && (command === "npx" || command === "npm")) {
+        const quoted = args.map((a) => /\s/.test(a) ? `"${a}"` : a);
+        return cp.spawn(command, quoted, { ...options, "shell": true });
+    }
+    return cp.spawn(command, args, options);
+};

package/dist/web.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @description package.json / vite.config を読み取り、ビルドディレクトリ等を ctx へ設定
+ *              Load vite config and populate build directories into ctx
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export declare const loadConfig: () => Promise<void>;
+/**
+ * @description Web用アプリの書き出し関数
+ *              Export function for web applications
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export declare const buildWeb: () => Promise<void>;

package/dist/web.js

@@ -0,0 +1,70 @@
+// Web ビルド: vite 設定の読み込みと HTML/JavaScript の書き出し。
+import pc from "picocolors";
+import fs from "fs";
+import { loadConfigFromFile } from "vite";
+import { ctx } from "./context.js";
+import { $spawn } from "./utils.js";
+/**
+ * @description package.json / vite.config を読み取り、ビルドディレクトリ等を ctx へ設定
+ *              Load vite config and populate build directories into ctx
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export const loadConfig = async () => {
+    const packageJson = JSON.parse(fs.readFileSync(`${process.cwd()}/package.json`, { "encoding": "utf8" }));
+    if (packageJson.type !== "module") {
+        packageJson.type = "module";
+        // overwride
+        fs.writeFileSync(`${process.cwd()}/package.json`, JSON.stringify(packageJson, null, 2));
+    }
+    const ext = fs.existsSync(`${process.cwd()}/vite.config.ts`) ? "ts" : "js";
+    const config = await loadConfigFromFile({
+        "command": "build",
+        "mode": "build"
+    }, `${process.cwd()}/vite.config.${ext}`);
+    // update config
+    ctx.configObject = config;
+    ctx.outDir = ctx.configObject.config?.build?.outDir || "dist";
+    ctx.buildDir = `${process.cwd()}/${ctx.outDir}/${ctx.platformDir}/${ctx.environment}`;
+    if (!fs.existsSync(`${ctx.buildDir}`)) {
+        fs.mkdirSync(`${ctx.buildDir}`, { "recursive": true });
+        console.log(pc.green(`Create build directory: ${ctx.buildDir}`));
+        console.log();
+    }
+};
+/**
+ * @description Web用アプリの書き出し関数
+ *              Export function for web applications
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export const buildWeb = () => {
+    return new Promise((resolve, reject) => {
+        const stream = $spawn("npx", [
+            "@next2d/vite-plugin-next2d-auto-loader"
+        ], { "stdio": "inherit" });
+        stream.on("close", (code) => {
+            if (code !== 0) {
+                reject("vite plugin command failed.");
+            }
+            const stream = $spawn("npx", [
+                "vite",
+                "--outDir",
+                ctx.buildDir,
+                "build"
+            ], { "stdio": "inherit" });
+            stream.on("close", (code) => {
+                if (code !== 0) {
+                    reject("Export of `HTML` and `JavaScript` failed.");
+                }
+                console.log();
+                console.log(pc.green("`HTML` and `JavaScript` files are written out."));
+                resolve();
+            });
+        });
+    });
+};

package/dist/xbox.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @description ディレクトリを再帰的に走査し、各ファイルの
+ *              [posix 相対キー, 絶対パス] を集める。
+ *              Walk a directory recursively, collecting [posixRelKey, absPath] pairs.
+ *
+ * @param  {string} rootDir 走査ルート
+ * @param  {string} [prefix] キーへ付与する接頭辞 (例 "" / "assets/")
+ * @return {Array<[string, string]>}
+ * @method
+ * @public
+ */
+export declare const walkFiles: (rootDir: string, prefix?: string) => [string, string][];
+/**
+ * @description (key, データ) の並びを exe 埋め込み用 pak バイナリへ直列化する純関数。
+ *              host 側 EmbeddedAssets.cpp の ParseEmbeddedPak と対になる。
+ *              フォーマット (リトルエンディアン uint32):
+ *                magic "N2DA" / version(=1) / count / [keyLen,key,dataLen,data]...
+ *              Serialize (key, data) entries into the embedded pak binary.
+ *
+ * @param  {Array<[string, Buffer]>} entries
+ * @return {Buffer}
+ * @method
+ * @public
+ */
+export declare const buildPak: (entries: [string, Buffer][]) => Buffer;
+/**
+ * @description assets.pak を RCDATA "N2DASSETS" として取り込む .rc の内容を生成する純関数。
+ *              相対パスだと rc.exe の CWD (build ディレクトリ) 基準で探して見つからない
+ *              (RC2135) ため絶対パスを埋める。RC はフォワードスラッシュを受理する。
+ *              文字列は必ずダブルクォート (RC 仕様。シングルクォートは不可)。
+ *              Render the .rc content that embeds assets.pak as RCDATA.
+ *
+ * @param  {string} pakAbsPath  assets.pak の絶対パス
+ * @return {string}
+ * @method
+ * @public
+ */
+export declare const renderAssetsRc: (pakAbsPath: string) => string;
+/**
+ * @description ホストスクリプト(js/bootstrap.js 等)を minify + 難読化する純関数。
+ *              Oxc(vite 同梱)でコメント除去・空白圧縮・ローカル識別子マングルを行う。
+ *              `globalThis.*` 等のグローバル名はゲームが参照するため保持される。
+ *              失敗時は元コードをそのまま返す(埋め込み自体は継続)。
+ *              Minify/obfuscate a host script; returns the original on failure.
+ *
+ * @param  {string} name  ファイル名 (拡張子で構文判定)
+ * @param  {string} code  元の JavaScript
+ * @return {string}
+ * @method
+ * @public
+ */
+export declare const minifyJs: (name: string, code: string) => string;
+/**
+ * @description Xbox(GDKネイティブ)用アプリの書き出し関数。
+ *              V8にNext2DのJSを載せ、Dawn(WebGPU/D3D12)で描画するC++ホストをビルドする。
+ *              Export function for Xbox (GDK native) apps.
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export declare const buildXbox: () => Promise<void>;