@iyexin/mio-cli 0.0.0-stage → 0.1.0

package/dist/templates.js

@@ -0,0 +1,288 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { extractZip, listZipEntries } from "@iyexin/mio-android-tools";
+import { fetchText, fetchToFile } from "./download.js";
+import { MIO_API_VERSION, MIO_CLI_VERSION } from "./constants.js";
+import { cliRoot, exists } from "./project.js";
+/**
+ * Templates are no longer committed to the repository: they are release assets
+ * (see .github/workflows/release.yml), downloaded on first use and cached per
+ * CLI version. An explicit path always wins, so teams can ship their own build.
+ */
+const RELEASE_BASE = "https://github.com/iYeXin/Mio/releases/download";
+export class TemplateError extends Error {
+}
+function cacheRoot() {
+    const base = process.platform === "win32"
+        ? process.env.LOCALAPPDATA || join(homedir(), "AppData", "Local")
+        : process.env.XDG_CACHE_HOME || join(homedir(), ".cache");
+    return join(base, "mio", "templates", MIO_CLI_VERSION);
+}
+function extensionOf(name) {
+    const dot = name.lastIndexOf(".");
+    return dot >= 0 ? name.slice(dot) : "";
+}
+async function sha256(path) {
+    const hash = createHash("sha256");
+    hash.update(await readFile(path));
+    return hash.digest("hex");
+}
+function assertCompatible(manifest, source) {
+    const wanted = MIO_API_VERSION.split(".")[0];
+    const found = String(manifest.apiVersion ?? "").split(".")[0];
+    if (!found) {
+        throw new TemplateError(`${source} has no apiVersion; cannot verify compatibility`);
+    }
+    if (found !== wanted) {
+        throw new TemplateError(`${source} targets Mio API ${manifest.apiVersion}, this CLI implements ${MIO_API_VERSION}. ` +
+            `Use a template from the v${MIO_CLI_VERSION} release, or upgrade the CLI.`);
+    }
+}
+async function readManifest(directory) {
+    const path = join(directory, "manifest.json");
+    if (!(await exists(path)))
+        return null;
+    try {
+        return JSON.parse(await readFile(path, "utf8"));
+    }
+    catch {
+        throw new TemplateError(`Template manifest is not valid JSON: ${path}`);
+    }
+}
+/** Downloads and unpacks the template bundle into the per-version cache. */
+async function fetchTemplates(log) {
+    const root = cacheRoot();
+    const manifestUrl = `${RELEASE_BASE}/v${MIO_CLI_VERSION}/manifest.json`;
+    log(`Downloading template manifest: ${manifestUrl}`);
+    const manifest = JSON.parse(await fetchText(manifestUrl));
+    assertCompatible(manifest, `release v${MIO_CLI_VERSION}`);
+    await mkdir(root, { recursive: true });
+    await writeFile(join(root, "manifest.json"), `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+    for (const [key, file] of Object.entries(manifest.files)) {
+        const target = join(root, file.name);
+        if (await exists(target)) {
+            if ((await sha256(target)) === file.sha256)
+                continue;
+            await rm(target, { force: true });
+        }
+        const url = `${RELEASE_BASE}/v${MIO_CLI_VERSION}/${file.name}`;
+        log(`Downloading ${key}: ${file.name} (${formatBytes(file.size)})`);
+        await fetchToFile(url, target);
+        const actual = await sha256(target);
+        if (actual !== file.sha256) {
+            await rm(target, { force: true });
+            throw new TemplateError(`Checksum mismatch for ${file.name}: expected ${file.sha256}, got ${actual}`);
+        }
+        if (file.kind === "zip") {
+            const directory = join(root, stripArchiveSuffix(file.name));
+            await extractZip(target, directory);
+            await writeFile(join(directory, ".mio-template"), `${file.sha256}\n`, "utf8");
+            await rm(target, { force: true });
+        }
+    }
+    return manifest;
+}
+function stripArchiveSuffix(name) {
+    return name.replace(/\.zip$/i, "");
+}
+async function ensureTemplates(log) {
+    const root = cacheRoot();
+    const manifest = await readManifest(root);
+    if (!manifest)
+        return await fetchTemplates(log);
+    assertCompatible(manifest, `template cache ${root}`);
+    return manifest;
+}
+function formatBytes(value) {
+    if (value < 1024)
+        return `${value} B`;
+    if (value < 1024 * 1024)
+        return `${(value / 1024).toFixed(1)} KB`;
+    return `${(value / (1024 * 1024)).toFixed(1)} MB`;
+}
+const ABI_KEY = {
+    universal: "android-universal",
+    arm64: "android-arm64",
+    x64: "android-x64",
+};
+const LOCAL_APK = {
+    universal: "mio-shell-universal.apk",
+    arm64: "mio-shell-arm64.apk",
+    x64: "mio-shell-x64.apk",
+};
+/** Templates built into the checkout by scripts/build-templates.ps1. */
+function localTemplateRoot() {
+    return join(cliRoot, "templates");
+}
+async function localAndroidTemplate(abi) {
+    const path = join(localTemplateRoot(), "android", LOCAL_APK[abi]);
+    if (!(await exists(path)))
+        return null;
+    await assertApkFormat(path);
+    return { path, source: "local", version: null };
+}
+async function localWindowsTemplate() {
+    const path = join(localTemplateRoot(), "windows");
+    if (!(await exists(join(path, "data"))))
+        return null;
+    return { path, source: "local", version: null };
+}
+export function androidAbiOf(config) {
+    return config.android?.abi ?? "universal";
+}
+/** Checks the zip layout of a template APK without unpacking it. */
+async function assertApkFormat(path) {
+    let entries;
+    try {
+        entries = await listZipEntries(path);
+    }
+    catch (error) {
+        throw new TemplateError(`Template is not a zip/APK: ${path} (${message(error)})`);
+    }
+    if (!entries.includes("AndroidManifest.xml")) {
+        throw new TemplateError(`Template is not an APK (no AndroidManifest.xml): ${path}`);
+    }
+    if (!entries.some((entry) => entry.endsWith("libapp.so"))) {
+        throw new TemplateError(`Template APK has no Flutter engine libraries: ${path}`);
+    }
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function abisInApk(path) {
+    const entries = await listZipEntries(path);
+    const abis = new Set();
+    for (const entry of entries) {
+        const match = /^lib\/([^/]+)\//.exec(entry);
+        if (match?.[1])
+            abis.add(match[1]);
+    }
+    return abis;
+}
+async function resolveExplicitAndroid(path, abi) {
+    await assertApkFormat(path);
+    if (abi !== "universal") {
+        const abis = await abisInApk(path);
+        if (!abis.has(`arm64-v8a`) && !abis.has(`x86_64`) && !abis.has(`armeabi-v7a`)) {
+            throw new TemplateError(`Template APK has no native libraries: ${path}`);
+        }
+        const wanted = abi === "arm64" ? "arm64-v8a" : abi === "x64" ? "x86_64" : "armeabi-v7a";
+        if (!abis.has(wanted)) {
+            throw new TemplateError(`Template ${path} does not contain ${wanted}; it has ${[...abis].join(", ") || "none"}. ` +
+                `Build with --target-platform android-${abi}.`);
+        }
+    }
+    return { path, source: "explicit", version: null };
+}
+export async function resolveAndroidTemplate(projectDir, config, options = {}) {
+    const abi = androidAbiOf(config);
+    const log = options.log ?? (() => { });
+    const explicit = [
+        options.explicit,
+        config.android?.template ? resolve(projectDir, config.android.template) : undefined,
+        process.env.MIO_ANDROID_TEMPLATE,
+    ].filter((value) => Boolean(value));
+    for (const candidate of explicit) {
+        if (await exists(candidate))
+            return await resolveExplicitAndroid(candidate, abi);
+    }
+    if (explicit.length > 0) {
+        throw new TemplateError(`Configured Android template does not exist: ${explicit[0]}`);
+    }
+    // Local builds (repo checkout, or a team that vendors its own templates) win
+    // over downloading: the directory is gitignored, so it only exists on purpose.
+    const local = await localAndroidTemplate(abi);
+    if (local)
+        return local;
+    const manifest = await ensureTemplates(log);
+    const file = manifest.files[ABI_KEY[abi]];
+    if (!file) {
+        throw new TemplateError(`Release v${MIO_CLI_VERSION} has no ${ABI_KEY[abi]} template. ` +
+            `Available: ${Object.keys(manifest.files).join(", ")}. ` +
+            `Build one locally with \`./scripts/build-templates.ps1 -Abi ${abi}\`.`);
+    }
+    const path = join(cacheRoot(), file.name);
+    if (!(await exists(path))) {
+        throw new TemplateError(`Template file is missing from the cache: ${path}`);
+    }
+    // The release can be rebuilt for the same tag; a cached file must still match
+    // the manifest it was downloaded with, otherwise the CLI would silently use a
+    // different shell than the apiVersion it verified.
+    if ((await sha256(path)) !== file.sha256) {
+        await rm(path, { force: true });
+        await fetchTemplates(log);
+    }
+    await assertApkFormat(path);
+    return { path, source: "cache", version: manifest.templateVersion };
+}
+export async function resolveWindowsTemplate(projectDir, config, options = {}) {
+    const log = options.log ?? (() => { });
+    const explicit = [
+        options.explicit,
+        config.windows?.templateDir ? resolve(projectDir, config.windows.templateDir) : undefined,
+        process.env.MIO_WINDOWS_TEMPLATE,
+    ].filter((value) => Boolean(value));
+    for (const candidate of explicit) {
+        if (!(await exists(candidate)))
+            continue;
+        if (!(await exists(join(candidate, "data")))) {
+            throw new TemplateError(`Windows template directory has no data/ folder: ${candidate}`);
+        }
+        return { path: candidate, source: "explicit", version: null };
+    }
+    if (explicit.length > 0) {
+        throw new TemplateError(`Configured Windows template does not exist: ${explicit[0]}`);
+    }
+    const local = await localWindowsTemplate();
+    if (local)
+        return local;
+    const manifest = await ensureTemplates(log);
+    const file = manifest.files["windows"];
+    if (!file) {
+        throw new TemplateError(`Release v${MIO_CLI_VERSION} has no Windows template. Build one locally with ` +
+            `\`./scripts/build-templates.ps1 -Platform windows\`.`);
+    }
+    const directory = join(cacheRoot(), stripArchiveSuffix(file.name));
+    if (!(await exists(join(directory, "data")))) {
+        throw new TemplateError(`Windows template is missing from the cache: ${directory}`);
+    }
+    const marker = join(directory, ".mio-template");
+    const cached = (await exists(marker)) ? (await readFile(marker, "utf8")).trim() : "";
+    if (cached !== file.sha256) {
+        await rm(directory, { recursive: true, force: true });
+        await fetchTemplates(log);
+    }
+    return { path: directory, source: "cache", version: manifest.templateVersion };
+}
+/** Template used by `mio dev`: prefer the universal build so emulators work too. */
+export async function resolveDevAndroidTemplate(projectDir, config, options = {}) {
+    try {
+        return await resolveAndroidTemplate(projectDir, config, options);
+    }
+    catch (error) {
+        // Dev on an emulator needs the universal (or x64) build; if the configured
+        // ABI is missing from the release, try universal before giving up.
+        if (androidAbiOf(config) === "universal")
+            throw error;
+        return await resolveAndroidTemplate(projectDir, { ...config, android: { ...(config.android ?? {}), abi: "universal" } }, options);
+    }
+}
+/** Human-readable summary for `mio doctor`. */
+export async function describeTemplates() {
+    const lines = [];
+    const root = cacheRoot();
+    const manifest = await readManifest(root);
+    if (!manifest) {
+        lines.push(`templates: not cached (run \`mio build\` to download v${MIO_CLI_VERSION})`);
+        return lines;
+    }
+    lines.push(`templates: v${manifest.templateVersion} (api ${manifest.apiVersion}) in ${root}`);
+    for (const [key, file] of Object.entries(manifest.files)) {
+        const path = join(root, file.kind === "zip" ? stripArchiveSuffix(file.name) : file.name);
+        lines.push(`  ${key}: ${(await exists(path)) ? "ok" : "missing"} (${formatBytes(file.size)})`);
+    }
+    return lines;
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"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"}

package/dist/web.d.ts

@@ -0,0 +1,3 @@
+import type { MioConfig } from "./config.js";
+export declare function ensureWebBuild(projectDir: string, config: MioConfig, skipWeb: boolean): Promise<string>;
+export declare function runShell(command: string, cwd: string): Promise<void>;

package/dist/web.js

@@ -0,0 +1,33 @@
+import { spawn } from "node:child_process";
+import { access } from "node:fs/promises";
+import { constants } from "node:fs";
+import { join, resolve } from "node:path";
+export async function ensureWebBuild(projectDir, config, skipWeb) {
+    const outDir = resolve(projectDir, config.web?.outDir ?? "dist");
+    if (!skipWeb) {
+        const command = config.web?.buildCommand ?? "npm run build";
+        await runShell(command, projectDir);
+    }
+    await access(join(outDir, "index.html"), constants.F_OK).catch(() => {
+        throw new Error(`Web build output is missing index.html: ${outDir}`);
+    });
+    return outDir;
+}
+export function runShell(command, cwd) {
+    return new Promise((resolvePromise, reject) => {
+        const child = spawn(command, {
+            cwd,
+            shell: true,
+            stdio: "inherit",
+            env: process.env,
+        });
+        child.on("error", reject);
+        child.on("exit", (code) => {
+            if (code === 0)
+                resolvePromise();
+            else
+                reject(new Error(`Command failed (${code}): ${command}`));
+        });
+    });
+}
+//# sourceMappingURL=web.js.map

package/dist/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB,EAClB,MAAiB,EACjB,OAAgB;IAEhB,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,MAAM,CAAC,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,YAAY,IAAI,eAAe,CAAC;QAC5D,MAAM,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QAClE,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,GAAW;IACnD,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE;YAC3B,GAAG;YACH,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,IAAI,KAAK,CAAC;gBAAE,cAAc,EAAE,CAAC;;gBAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,IAAI,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,55 @@
-{
-  "name": "@iyexin/mio-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+{
+  "name": "@iyexin/mio-cli",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "Mio application CLI",
+  "bin": {
+    "mio": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates/web"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --import tsx --test test/create.test.ts test/abi.test.ts test/download.test.ts"
+  },
+  "dependencies": {
+    "@electron/asar": "^4.3.1",
+    "@iyexin/mio-android-tools": "workspace:*",
+    "@iyexin/mio-api": "workspace:*",
+    "undici": "^7.16.0"
+  },
+  "engines": {
+    "node": ">=22.12"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iYeXin/Mio.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/iYeXin/Mio#readme",
+  "bugs": {
+    "url": "https://github.com/iYeXin/Mio/issues"
+  },
+  "keywords": [
+    "mio",
+    "flutter",
+    "webview",
+    "web-app",
+    "android",
+    "windows"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/templates/web/index.html

@@ -0,0 +1,113 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Hello Mio</title>
+    <link rel="stylesheet" href="./src/style.css" />
+  </head>
+  <body>
+    <div class="frame">
+      <header class="masthead">
+        <span class="wordmark">MIO</span>
+        <span class="masthead-meta" id="masthead-meta">shell 0.1.0</span>
+      </header>
+
+      <section class="intro">
+        <div class="intro-text">
+          <h1 id="app-name">Hello Mio</h1>
+          <p class="lede">
+            A Flutter shell serving a web app over localhost. Every call below crosses
+            the bridge into native code.
+          </p>
+        </div>
+        <svg class="mark" viewBox="1300 410 1659 1655" aria-hidden="true">
+          <rect x="1300" y="410" width="822" height="681" fill="#f2a6a6" />
+          <rect x="1300" y="1238" width="532" height="827" fill="#b9b9b6" />
+          <rect x="1972" y="1382" width="946" height="681" fill="#a9c0d2" />
+          <path
+            d="M2256.85 1237.84 2432.35 409.836 2958.85 409.836 2783.35 1237.84Z"
+            fill="#4a4a4a"
+          />
+        </svg>
+      </section>
+
+      <dl class="spec">
+        <div class="spec-cell">
+          <dt>Application</dt>
+          <dd id="spec-id" class="mono">—</dd>
+        </div>
+        <div class="spec-cell">
+          <dt>Version</dt>
+          <dd id="spec-version" class="mono">—</dd>
+        </div>
+        <div class="spec-cell">
+          <dt>Platform</dt>
+          <dd id="spec-platform" class="mono">—</dd>
+        </div>
+        <div class="spec-cell">
+          <dt>Bridge</dt>
+          <dd class="mono">
+            <span class="status" id="bridge-status" data-state="pending">
+              <span class="status-dot"></span><span id="bridge-text">connecting</span>
+            </span>
+          </dd>
+        </div>
+      </dl>
+
+      <section class="calls">
+        <h2 class="section-label">Bridge calls</h2>
+        <ol class="call-list">
+          <li>
+            <button type="button" data-action="ping">
+              <span class="num">01</span>
+              <span class="call-name">Ping</span>
+              <span class="call-note">round trip to the shell</span>
+              <span class="arrow" aria-hidden="true">→</span>
+            </button>
+          </li>
+          <li>
+            <button type="button" data-action="clipboard">
+              <span class="num">02</span>
+              <span class="call-name">Clipboard</span>
+              <span class="call-note">write then read back</span>
+              <span class="arrow" aria-hidden="true">→</span>
+            </button>
+          </li>
+          <li>
+            <button type="button" data-action="write">
+              <span class="num">03</span>
+              <span class="call-name">Write &amp; read a file</span>
+              <span class="call-note">app data directory</span>
+              <span class="arrow" aria-hidden="true">→</span>
+            </button>
+          </li>
+          <li>
+            <button type="button" data-action="binary">
+              <span class="num">04</span>
+              <span class="call-name">64 MB round trip</span>
+              <span class="call-note">streamed over the blob endpoint</span>
+              <span class="arrow" aria-hidden="true">→</span>
+            </button>
+          </li>
+        </ol>
+      </section>
+
+      <section class="log">
+        <div class="log-head">
+          <h2 class="section-label">Output</h2>
+          <span class="log-id" id="log-id">idle</span>
+        </div>
+        <pre id="output" aria-live="polite">Waiting for the bridge…</pre>
+      </section>
+
+      <footer class="colophon">
+        <span>Mio shell</span>
+        <span id="spec-api">api —</span>
+        <span id="spec-template">template —</span>
+      </footer>
+    </div>
+
+    <script type="module" src="./src/main.ts"></script>
+  </body>
+</html>

package/templates/web/mio.config.json

@@ -0,0 +1,20 @@
+{
+  "app": {
+    "id": "com.example.hello",
+    "name": "Hello Mio",
+    "version": "1.0.0",
+    "icon": "icon.png"
+  },
+  "window": {
+    "width": 1000,
+    "height": 720
+  },
+  "web": {
+    "outDir": "dist"
+  },
+  "android": {
+    "minSdk": 24,
+    "pageSize": 16,
+    "abi": "arm64"
+  }
+}

package/templates/web/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "mio-web-template",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@iyexin/mio-api": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vite": "^7.2.2"
+  }
+}