@harmonyos-arkts/opencode-plugin 0.0.12 → 0.0.13

package/dist/index.js

@@ -5052,32 +5052,32 @@ var require_URL = __commonJS({
           else
             return basepath.substring(0, lastslash + 1) + refpath;
         }
-        function remove_dot_segments(path7) {
-          if (!path7) return path7;
+        function remove_dot_segments(path9) {
+          if (!path9) return path9;
           var output = "";
-          while (path7.length > 0) {
-            if (path7 === "." || path7 === "..") {
-              path7 = "";
+          while (path9.length > 0) {
+            if (path9 === "." || path9 === "..") {
+              path9 = "";
               break;
             }
-            var twochars = path7.substring(0, 2);
-            var threechars = path7.substring(0, 3);
-            var fourchars = path7.substring(0, 4);
+            var twochars = path9.substring(0, 2);
+            var threechars = path9.substring(0, 3);
+            var fourchars = path9.substring(0, 4);
             if (threechars === "../") {
-              path7 = path7.substring(3);
+              path9 = path9.substring(3);
             } else if (twochars === "./") {
-              path7 = path7.substring(2);
+              path9 = path9.substring(2);
             } else if (threechars === "/./") {
-              path7 = "/" + path7.substring(3);
-            } else if (twochars === "/." && path7.length === 2) {
-              path7 = "/";
-            } else if (fourchars === "/../" || threechars === "/.." && path7.length === 3) {
-              path7 = "/" + path7.substring(4);
+              path9 = "/" + path9.substring(3);
+            } else if (twochars === "/." && path9.length === 2) {
+              path9 = "/";
+            } else if (fourchars === "/../" || threechars === "/.." && path9.length === 3) {
+              path9 = "/" + path9.substring(4);
               output = output.replace(/\/?[^\/]*$/, "");
             } else {
-              var segment = path7.match(/(\/?([^\/]*))/)[0];
+              var segment = path9.match(/(\/?([^\/]*))/)[0];
               output += segment;
-              path7 = path7.substring(segment.length);
+              path9 = path9.substring(segment.length);
             }
           }
           return output;
@@ -18304,10 +18304,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path7) {
-  if (!path7)
+function getElementAtPath(obj, path9) {
+  if (!path9)
     return obj;
-  return path7.reduce((acc, key) => acc?.[key], obj);
+  return path9.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -18690,11 +18690,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path7, issues) {
+function prefixIssues(path9, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path7);
+    iss.path.unshift(path9);
     return iss;
   });
 }
@@ -18877,7 +18877,7 @@ function formatError(error92, mapper = (issue3) => issue3.message) {
 }
 function treeifyError(error92, mapper = (issue3) => issue3.message) {
   const result = { errors: [] };
-  const processError = (error93, path7 = []) => {
+  const processError = (error93, path9 = []) => {
     var _a2, _b;
     for (const issue3 of error93.issues) {
       if (issue3.code === "invalid_union" && issue3.errors.length) {
@@ -18887,7 +18887,7 @@ function treeifyError(error92, mapper = (issue3) => issue3.message) {
       } else if (issue3.code === "invalid_element") {
         processError({ issues: issue3.issues }, issue3.path);
       } else {
-        const fullpath = [...path7, ...issue3.path];
+        const fullpath = [...path9, ...issue3.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue3));
           continue;
@@ -18919,8 +18919,8 @@ function treeifyError(error92, mapper = (issue3) => issue3.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path7 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path7) {
+  const path9 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path9) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -30897,13 +30897,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path7 = ref.slice(1).split("/").filter(Boolean);
-  if (path7.length === 0) {
+  const path9 = ref.slice(1).split("/").filter(Boolean);
+  if (path9.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path7[0] === defsKey) {
-    const key = path7[1];
+  if (path9[0] === defsKey) {
+    const key = path9[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -31572,6 +31572,7 @@ var HM_DESIGN = `
 - Use the \`harmonyos-prd-design\` skill to create prd desgin documents
 - Reference design patterns and best practices from the skill documentation
 - Design documents should be stored in the project's \`.harmonyos/\` directory
+- After UX renders the prototype, write it as \`prototype.html\`, then call \`html_preview\` with \`filePath\` set to that file's local path so the frontend can open it reliably
 `;
 var HM_DEVELOP = `
 ### Development Phase
@@ -32938,10 +32939,10 @@ function mergeDefs2(...defs) {
 function cloneDef2(schema) {
   return mergeDefs2(schema._zod.def);
 }
-function getElementAtPath2(obj, path7) {
-  if (!path7)
+function getElementAtPath2(obj, path9) {
+  if (!path9)
     return obj;
-  return path7.reduce((acc, key) => acc?.[key], obj);
+  return path9.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject2(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -33302,11 +33303,11 @@ function aborted2(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues2(path7, issues) {
+function prefixIssues2(path9, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path7);
+    iss.path.unshift(path9);
     return iss;
   });
 }
@@ -33474,7 +33475,7 @@ function treeifyError2(error92, _mapper) {
     return issue3.message;
   };
   const result = { errors: [] };
-  const processError = (error93, path7 = []) => {
+  const processError = (error93, path9 = []) => {
     var _a2, _b;
     for (const issue3 of error93.issues) {
       if (issue3.code === "invalid_union" && issue3.errors.length) {
@@ -33484,7 +33485,7 @@ function treeifyError2(error92, _mapper) {
       } else if (issue3.code === "invalid_element") {
         processError({ issues: issue3.issues }, issue3.path);
       } else {
-        const fullpath = [...path7, ...issue3.path];
+        const fullpath = [...path9, ...issue3.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue3));
           continue;
@@ -33516,8 +33517,8 @@ function treeifyError2(error92, _mapper) {
 }
 function toDotPath2(_path) {
   const segs = [];
-  const path7 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path7) {
+  const path9 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path9) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -45341,22 +45342,22 @@ var HEADERS = {
   "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
 };
 var REQUEST_TIMEOUT_MS = 1e4;
-async function post(path7, body) {
+async function post(path9, body) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
   try {
-    const res = await fetch(BASE_URL + path7, {
+    const res = await fetch(BASE_URL + path9, {
       method: "POST",
       headers: HEADERS,
       body: JSON.stringify(body),
       signal: controller.signal
     });
     if (!res.ok) {
-      throw new Error(`API request failed: ${res.status} ${res.statusText} for ${path7}`);
+      throw new Error(`API request failed: ${res.status} ${res.statusText} for ${path9}`);
     }
     const data = await res.json();
     if (data.code && data.code !== 0 && data.code !== "0") {
-      throw new Error(`API error [${data.code}]: ${data.message} for ${path7}`);
+      throw new Error(`API error [${data.code}]: ${data.message} for ${path9}`);
     }
     return data;
   } finally {
@@ -45613,6 +45614,82 @@ Use harmony-doc-view with a URL above to read any official document in full.`
   });
 }
 
+// src/tools/html-preview/html-preview-tool.ts
+import { access } from "fs/promises";
+import path7 from "path";
+import { fileURLToPath as fileURLToPath2, pathToFileURL } from "url";
+var PROTOTYPE_HTML_FILENAME = "prototype.html";
+function toFileUrl(filePath) {
+  return pathToFileURL(path7.resolve(filePath)).href;
+}
+async function fileExists(filePath) {
+  try {
+    await access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function resolvePrototypePath(directory, input) {
+  const trimmed = input.trim();
+  if (!trimmed) {
+    throw new Error("filePath is required");
+  }
+  if (trimmed.startsWith("file://")) {
+    return fileURLToPath2(trimmed);
+  }
+  return path7.isAbsolute(trimmed) ? trimmed : path7.resolve(directory, trimmed);
+}
+async function resolvePrototypePreview(directory, filePathInput) {
+  const filePath = resolvePrototypePath(directory, filePathInput);
+  if (!await fileExists(filePath)) {
+    throw new Error(
+      `Prototype HTML not found: ${filePath}. Pass the exact local path where ${PROTOTYPE_HTML_FILENAME} was written.`
+    );
+  }
+  return { url: toFileUrl(filePath), filePath };
+}
+function htmlPreviewTool(_managers) {
+  return tool({
+    description: "Send the UX prototype preview to the frontend. Call this immediately after writing prototype.html. You MUST pass filePath with the exact local path of the written file so the frontend can locate and preview it.",
+    args: {
+      filePath: tool.schema.string(
+        "Local path to prototype.html. Use the same path from the write step, e.g. prototype.html, /Users/yanqing/coding/your-project/prototype.html, or file:///.../prototype.html."
+      ),
+      title: tool.schema.optional(
+        tool.schema.string("Optional title shown in the preview panel")
+      )
+    },
+    execute: async (args, context) => {
+      try {
+        log("[html_preview]", { filePath: args.filePath, title: args.title });
+        const { url: url3, filePath } = await resolvePrototypePreview(context.directory, args.filePath);
+        const title = args.title?.trim() || "Prototype Preview";
+        const metadata = {
+          url: url3,
+          filePath,
+          fileName: path7.basename(filePath),
+          title
+        };
+        context.metadata({
+          title,
+          metadata: {
+            htmlPreview: metadata
+          }
+        });
+        return [
+          "Prototype preview sent to frontend.",
+          `Title: ${title}`,
+          `Local path: ${filePath}`,
+          `Preview URL: ${url3}`
+        ].join("\n");
+      } catch (e) {
+        return `Error: ${e instanceof Error ? e.message : String(e)}`;
+      }
+    }
+  });
+}
+
 // node_modules/turndown/lib/turndown.es.js
 function extend3(destination) {
   for (var i = 1; i < arguments.length; i++) {
@@ -46786,6 +46863,7 @@ function createBuiltinTools(managers) {
   return {
     createHmTemplate: createHmTemplateTool(managers),
     skillSearch: skillSearchTool(managers),
+    html_preview: htmlPreviewTool(managers),
     "harmony-doc-view": harmonyDocViewTool(managers)
   };
 }
@@ -46910,11 +46988,11 @@ Diff.prototype = {
       }
     }
   },
-  addToPath: function addToPath(path7, added, removed, oldPosInc, options) {
-    var last = path7.lastComponent;
+  addToPath: function addToPath(path9, added, removed, oldPosInc, options) {
+    var last = path9.lastComponent;
     if (last && !options.oneChangePerToken && last.added === added && last.removed === removed) {
       return {
-        oldPos: path7.oldPos + oldPosInc,
+        oldPos: path9.oldPos + oldPosInc,
         lastComponent: {
           count: last.count + 1,
           added,
@@ -46924,7 +47002,7 @@ Diff.prototype = {
       };
     } else {
       return {
-        oldPos: path7.oldPos + oldPosInc,
+        oldPos: path9.oldPos + oldPosInc,
         lastComponent: {
           count: 1,
           added,
@@ -47361,6 +47439,9 @@ arrayDiff.join = arrayDiff.removeEmpty = function(value) {
   return value;
 };
 
+// src/hooks/tool-hooks.ts
+import path8 from "path";
+
 // src/compress/compile-hvigorw.ts
 function processHvigorwCompileInfo(input, output) {
   if (input.tool !== "bash") return;
@@ -47402,6 +47483,7 @@ function createToolHooks(sessionManager, projectDir) {
     "tool.execute.after": async (input, output) => {
       processHvigorwCompileInfo(input, output);
       injectAiCodeChange(input, output);
+      await injectHtmlPreview(input, output, projectDir);
       await updateEtsCount(sessionManager, projectDir, input);
     }
   };
@@ -47427,6 +47509,30 @@ async function updateEtsCount(sessionManager, projectDir, input) {
     }
   }
 }
+async function injectHtmlPreview(input, output, projectDir) {
+  if (input.tool !== "html_preview") return;
+  try {
+    const existing = output.metadata.htmlPreview;
+    if (existing?.url) {
+      output.title = existing.title?.trim() || "Prototype Preview";
+      return;
+    }
+    const filePathArg = input.args?.filePath;
+    if (!filePathArg) return;
+    const title = input.args?.title?.trim() || "Prototype Preview";
+    const { url: url3, filePath } = await resolvePrototypePreview(projectDir, filePathArg);
+    output.title = title;
+    output.metadata.htmlPreview = {
+      url: url3,
+      filePath,
+      fileName: path8.basename(filePath),
+      title
+    };
+    log("htmlPreview injected", { url: url3, title });
+  } catch (e) {
+    log("htmlPreview after hook error", { tool: input.tool, error: String(e) });
+  }
+}
 function injectAiCodeChange(input, output) {
   try {
     if (input.tool === "write") {

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@harmonyos-arkts/opencode-plugin",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "HarmonyOS Full-Lifecycle Development Assistant. Specialized in the complete development lifecycle of HarmonyOS applications, including project creation, UI development, state management, network requests, data storage, permission requests, performance optimization, testing, and release.",
   "type": "module",
   "license": "MIT",