@olenbetong/appframe-vite 6.3.3 → 6.3.4

package/lib/cli-resources-add.js

@@ -1,12 +1,11 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname, relative, resolve } from "node:path";
+import { relative, resolve } from "node:path";
 import { Client, generateApiDataHandler } from "@olenbetong/appframe-data";
 import { config } from "dotenv";
 import fuzzy from "fuzzy";
 import inquirer from "inquirer";
 import autocomplete from "inquirer-autocomplete-standalone";
 import { getLoginInfo } from "./devServer.js";
-import { fetchAndGenerate, fetchResourceDefinition, formatWithBiome } from "./resourceGenerate.js";
+import { fetchAndGenerate, fetchResourceDefinition, writeGeneratedFile } from "./resourceGenerate.js";
 import { entryToCLIOptions, readResourcesConfig, writeResourcesConfig } from "./resourcesConfig.js";
 config({ quiet: true });
 async function getResources(client) {
@@ -185,8 +184,6 @@ export async function addResource() {
     options.output = resolve(process.cwd(), output);
     let content = await fetchAndGenerate(chosenResource, options, client);
     let outputPath = resolve(process.cwd(), output);
-    await mkdir(dirname(outputPath), { recursive: true });
-    await writeFile(outputPath, content, "utf-8");
-    await formatWithBiome(outputPath);
+    await writeGeneratedFile(outputPath, content);
     console.log(`Generated ${output}`);
 }

package/lib/cli-resources-edit.js

@@ -1,12 +1,11 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname, relative, resolve } from "node:path";
+import { relative, resolve } from "node:path";
 import { Client } from "@olenbetong/appframe-data";
 import { config } from "dotenv";
 import fuzzy from "fuzzy";
 import inquirer from "inquirer";
 import autocomplete from "inquirer-autocomplete-standalone";
 import { getLoginInfo } from "./devServer.js";
-import { fetchAndGenerate, fetchResourceDefinition, formatWithBiome } from "./resourceGenerate.js";
+import { fetchAndGenerate, fetchResourceDefinition, writeGeneratedFile } from "./resourceGenerate.js";
 import { entryToCLIOptions, readResourcesConfig, writeResourcesConfig } from "./resourcesConfig.js";
 config({ quiet: true });
 export async function editResource(id) {
@@ -178,8 +177,6 @@ export async function editResource(id) {
     options.output = resolve(process.cwd(), output);
     let content = await fetchAndGenerate(entry.resource, options, client);
     let outputPath = resolve(process.cwd(), output);
-    await mkdir(dirname(outputPath), { recursive: true });
-    await writeFile(outputPath, content, "utf-8");
-    await formatWithBiome(outputPath);
+    await writeGeneratedFile(outputPath, content);
     console.log(`Regenerated ${output}`);
 }

package/lib/cli-resources-generate.js

@@ -1,9 +1,8 @@
-import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, relative, resolve, sep } from "node:path";
 import { Client } from "@olenbetong/appframe-data";
 import { config } from "dotenv";
 import { getLoginInfo } from "./devServer.js";
-import { fetchAndGenerate, formatWithBiome } from "./resourceGenerate.js";
+import { fetchAndGenerate, writeGeneratedFile } from "./resourceGenerate.js";
 import { entryToCLIOptions, readResourcesConfig } from "./resourcesConfig.js";
 config({ quiet: true });
 /**
@@ -49,10 +48,10 @@ export async function generateFromConfig(configPath) {
         try {
             let content = await fetchAndGenerate(entry.resource, options, client);
             let outputPath = resolve(process.cwd(), entry.output ?? `src/data/${entry.id}.ts`);
-            await mkdir(dirname(outputPath), { recursive: true });
-            await writeFile(outputPath, content, "utf-8");
-            await formatWithBiome(outputPath);
-            console.log(`  ✓ ${entry.id} → ${entry.output}`);
+            let wroteFile = await writeGeneratedFile(outputPath, content);
+            if (wroteFile) {
+                console.log(`  ✓ ${entry.id} → ${entry.output}`);
+            }
         }
         catch (error) {
             let message = error?.message ?? String(error);

package/lib/proxy.js

@@ -144,7 +144,7 @@ export async function login(hostname, username, password, loginOptions) {
         if (!silent) {
             write(`\r${initialLogMessage}`);
         }
-        // biome-ignore lint/suspicious/noControlCharactersInRegex: is there another way?
+        // oxlint-disable-next-line no-control-regex -- is there another way?
         let strippedInitialLogMessage = initialLogMessage.replace(/\u001b\[[0-9]+m/g, ""); // remove ANSI color codes for accurate cursor positioning
         let initialCursorPos = strippedInitialLogMessage.length;
         let start = performance.now();

package/lib/resourceGenerate.d.ts

@@ -5,6 +5,13 @@ import type { Client } from "@olenbetong/appframe-data";
  * Silently skips if Biome is not found or formatting fails.
  */
 export declare function formatWithBiome(filePath: string): Promise<void>;
+/**
+ * Write a generated file only when the content changed.
+ * Formats the content before comparing so that an already-formatted file
+ * on disk is not considered changed.
+ * Returns `true` when the file was written, `false` when it already matched.
+ */
+export declare function writeGeneratedFile(filePath: string, content: string): Promise<boolean>;
 export type CLIOptions = {
     server: string;
     types?: boolean;

package/lib/resourceGenerate.js

@@ -1,5 +1,6 @@
-import { exec } from "node:child_process";
+import { exec, spawn } from "node:child_process";
 import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join, relative, resolve, sep } from "node:path";
 import { promisify } from "node:util";
 import { importJson } from "./importJson.js";
@@ -7,31 +8,29 @@ const execAsync = promisify(exec);
 // ---------------------------------------------------------------------------
 // Biome formatting
 // ---------------------------------------------------------------------------
-/**
- * Format a file with Biome if available. Searches for `biome` in the nearest
- * node_modules/.bin up from cwd, then falls back to the global PATH.
- * Silently skips if Biome is not found or formatting fails.
- */
-export async function formatWithBiome(filePath) {
-    let biomeBin = null;
+function findBiomeBin() {
     let current = resolve(process.cwd());
     while (true) {
         let candidate = join(current, "node_modules", ".bin", "biome");
         let candidateCmd = `${candidate}.cmd`;
-        if (existsSync(candidateCmd)) {
-            biomeBin = candidateCmd;
-            break;
-        }
-        if (existsSync(candidate)) {
-            biomeBin = candidate;
-            break;
-        }
+        if (existsSync(candidateCmd))
+            return candidateCmd;
+        if (existsSync(candidate))
+            return candidate;
         let parent = dirname(current);
         if (parent === current)
             break;
         current = parent;
     }
-    let bin = biomeBin ?? "biome";
+    return null;
+}
+/**
+ * Format a file with Biome if available. Searches for `biome` in the nearest
+ * node_modules/.bin up from cwd, then falls back to the global PATH.
+ * Silently skips if Biome is not found or formatting fails.
+ */
+export async function formatWithBiome(filePath) {
+    let bin = findBiomeBin() ?? "biome";
     try {
         await execAsync(`"${bin}" format --write "${resolve(filePath)}"`);
     }
@@ -39,6 +38,49 @@ export async function formatWithBiome(filePath) {
         // Biome not available or not applicable — silently skip
     }
 }
+/**
+ * Format content in memory using Biome's stdin mode.
+ * Returns the formatted content, or the original if Biome is unavailable.
+ */
+async function formatContentWithBiome(content, filePath) {
+    let bin = findBiomeBin() ?? "biome";
+    return new Promise((resolve) => {
+        let child = spawn(bin, ["format", `--stdin-file-path=${filePath}`], { stdio: "pipe" });
+        let stdout = "";
+        let failed = false;
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.on("error", () => {
+            failed = true;
+            resolve(content);
+        });
+        child.on("close", (code) => {
+            if (!failed)
+                resolve(code === 0 ? stdout : content);
+        });
+        child.stdin.write(content);
+        child.stdin.end();
+    });
+}
+/**
+ * Write a generated file only when the content changed.
+ * Formats the content before comparing so that an already-formatted file
+ * on disk is not considered changed.
+ * Returns `true` when the file was written, `false` when it already matched.
+ */
+export async function writeGeneratedFile(filePath, content) {
+    await mkdir(dirname(filePath), { recursive: true });
+    let formatted = await formatContentWithBiome(content, filePath);
+    if (existsSync(filePath)) {
+        let existing = await readFile(filePath, "utf-8");
+        if (existing === formatted) {
+            return false;
+        }
+    }
+    await writeFile(filePath, formatted, "utf-8");
+    return true;
+}
 // ---------------------------------------------------------------------------
 // YAML config block
 // ---------------------------------------------------------------------------

package/lib/writeGeneratedFile.test.d.ts

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

package/lib/writeGeneratedFile.test.js

@@ -0,0 +1,19 @@
+import { mkdtemp, readFile, rm, stat } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+import { writeGeneratedFile } from "./resourceGenerate.js";
+describe("writeGeneratedFile", () => {
+    it("skips rewriting unchanged content", async () => {
+        let dir = await mkdtemp(join(tmpdir(), "appframe-vite-"));
+        let file = join(dir, "generated.ts");
+        expect(await writeGeneratedFile(file, "first")).toBe(true);
+        let firstContent = await readFile(file, "utf-8");
+        let firstMtime = (await stat(file)).mtimeMs;
+        await new Promise((resolve) => setTimeout(resolve, 20));
+        expect(await writeGeneratedFile(file, "first")).toBe(false);
+        expect(await readFile(file, "utf-8")).toBe(firstContent);
+        expect((await stat(file)).mtimeMs).toBe(firstMtime);
+        await rm(dir, { recursive: true, force: true });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olenbetong/appframe-vite",
-  "version": "6.3.3",
+  "version": "6.3.4",
   "description": "Tools to use and deploy Vite applications to Appframe",
   "main": "./lib/index.js",
   "type": "module",
@@ -45,9 +45,9 @@
   },
   "devDependencies": {
     "@types/jsdom": "^27.0.0",
-    "@types/node": "25.9.3",
-    "typescript": "6.0.3",
-    "vite": "8.0.16"
+    "@types/node": "26.1.1",
+    "typescript": "7.0.2",
+    "vite": "8.1.5"
   },
   "peerDependencies": {
     "vite": ">=5.0.0"