sbuilder-mcp 0.81.0 → 0.81.1

package/CHANGELOG.md

@@ -6,6 +6,13 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.81.1] - 2026-10-10
+
+### Fixed
+- `sb_set` and `sb_add` suggest the right icon for a misspelled name, ranking names that contain the typed word first, then close typos by edit distance, and honoring a `Fill` or `Line` suffix the caller wrote.
+- `sb_duplicate` with `to_page_id` reports that `parent_id` is not on the target page and says to omit it or read ids with `sb_outline`.
+- `sb_media_upload` of a font file tells the caller how to create a font family instead of suggesting `sb_set` with `src`.
+
 ## [0.81.0] - 2026-10-10
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,13 @@ Mọi thay đổi đáng chú ý của dự án được ghi lại trong file n
 Định dạng dựa trên [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 và dự án tuân theo [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.81.1] - 2026-10-10
+
+### Fixed
+- `sb_set` và `sb_add` gợi ý đúng icon cho tên gõ sai, ưu tiên tên chứa nguyên từ đã gõ, rồi đến lỗi gõ gần theo khoảng cách sửa, và tôn trọng đuôi `Fill` hoặc `Line` do người gọi viết.
+- `sb_duplicate` với `to_page_id` báo `parent_id` không có trên trang đích và hướng dẫn bỏ qua nó hoặc đọc id bằng `sb_outline`.
+- `sb_media_upload` với file font hướng dẫn cách tạo họ font thay vì gợi ý `sb_set` với `src`.
+
 ## [0.81.0] - 2026-10-10
 
 ### Added

package/dist/domains/site/builder.js

@@ -564,7 +564,9 @@ export function copyNodeInto(src, id, target, parentId, index, guard) {
             'again through its app.');
     }
     if (!parentId || !target.has(parentId)) {
-        throw new Error(`sbuilder: ${id} has no parent to be duplicated beside`);
+        throw new Error(src === target
+            ? `sbuilder: ${id} has no parent to be duplicated beside`
+            : `sbuilder: parent "${parentId}" is not on the target page — omit parent_id to paste at the page's end, or read its ids with sb_outline.`);
     }
     if (src !== target) {
         // Onto ANOTHER document the parent is the caller's choice, so it gets the

package/dist/domains/site/icons.js

@@ -27,10 +27,10 @@ let index = null;
  * Nothing found → retried on the query's longest word, so "ShoppingBasketIcon"
  * still lands near the basket.
  *
- * ponytail: substring ranking, no edit distance — a misspelling ("hart") finds
- * nothing. Add a Levenshtein fallback if callers misspell rather than guess.
+ * Substring ranking only — a SEARCH is a word someone chose. A misspelled NAME is
+ * `nearestIcons`' job, which tries edit distance first.
  */
-export function searchIcons(query, cap = 30) {
+export function searchIcons(query, cap = 30, retryOnWord = true) {
     index ??= [...ICON_NAMES].map((n) => [n, stemOf(n)]);
     const rank = (q) => !q
         ? []
@@ -40,7 +40,7 @@ export function searchIcons(query, cap = 30) {
             .sort((a, b) => b.r - a.r || a.s.length - b.s.length || a.n.localeCompare(b.n))
             .map((x) => x.n);
     let hits = rank(stemOf(query));
-    if (!hits.length) {
+    if (!hits.length && retryOnWord) {
         const words = query.replace(/([a-z])([A-Z])/g, '$1 $2').toLowerCase().split(/[^a-z0-9]+/);
         const longest = words.filter((w) => w.length > 2).sort((a, b) => b.length - a.length)[0];
         if (longest)
@@ -48,8 +48,62 @@ export function searchIcons(query, cap = 30) {
     }
     return hits.slice(0, cap);
 }
+/** Edit distance, capped: stops early past `max` (a name's stem is short). */
+function distance(a, b, max) {
+    if (Math.abs(a.length - b.length) > max)
+        return max + 1;
+    let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
+    for (let i = 1; i <= a.length; i++) {
+        const cur = [i];
+        let best = i;
+        for (let j = 1; j <= b.length; j++) {
+            cur[j] = Math.min(prev[j] + 1, cur[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+            best = Math.min(best, cur[j]);
+        }
+        if (best > max)
+            return max + 1;
+        prev = cur;
+    }
+    return prev[b.length];
+}
+/**
+ * The names a WRONG value most likely meant. A typo first ("ShoppingCartt" is
+ * one edit from ShoppingCart, while a word search on "shopping" ranks the shorter
+ * ShoppingBag ahead of it — measured on a live platform), then the search.
+ * Fill before Line on a tie: the platform's own default (StarFill) is a Fill.
+ */
 export function nearestIcons(query) {
-    return searchIcons(query, 5);
+    index ??= [...ICON_NAMES].map((n) => [n, stemOf(n)]);
+    const q = stemOf(query);
+    const max = Math.max(1, Math.floor(q.length / 4));
+    // The suffix the caller wrote wins a tie; otherwise Fill, the default's own.
+    const want = /line$/i.test(norm(query)) ? 'Line' : 'Fill';
+    const typos = q
+        ? index
+            .map(([n, s]) => ({ n, s, d: distance(q, s, max) }))
+            .filter((x) => x.d <= max)
+            .sort((a, b) => a.d - b.d ||
+            // ShoppingCart over ShoppingCart2 for "ShoppingCartt": a stem the query
+            // extends is a closer guess than a sibling the same distance away.
+            Number(q.startsWith(b.s) || b.s.startsWith(q)) - Number(q.startsWith(a.s) || a.s.startsWith(q)) ||
+            Number(b.n.endsWith(want)) - Number(a.n.endsWith(want)) ||
+            a.s.length - b.s.length ||
+            a.n.localeCompare(b.n))
+            .map((x) => x.n)
+        : [];
+    // A value that is a WHOLE WORD of real names ("cart" in Shopping·Cart, "user")
+    // means those names, not Car/Cast one edit away; a fragment inside another word
+    // ("hart" in c·hart) is more likely a typo (Heart). So: word hits, then typos,
+    // then whatever else the search finds.
+    const wordsOf = (n) => n.replace(/([a-z0-9])([A-Z])/g, '$1 $2').toLowerCase().split(' ');
+    const words = q
+        ? index
+            .filter(([n, st]) => st.startsWith(q) || wordsOf(n).includes(q))
+            .sort(([an, as], [bn, bs]) => as.length - bs.length || Number(bn.endsWith(want)) - Number(an.endsWith(want)) || an.localeCompare(bn))
+            .map(([n]) => n)
+        : [];
+    const order = [...words, ...typos, ...searchIcons(query, 5)];
+    return [...new Set(order)].slice(0, 5);
 }
 /**
  * The problem sentence for `value` written to `<ns>.<key>` on `type`, or null

package/dist/tools/live.js

@@ -652,11 +652,16 @@ export function registerLiveTools(server, ctx, session) {
             });
         }
         const asset = await uploadMedia(ctx, site_id, { path, url, name, folderId: folder_id });
+        const font = asset.mediaType === 'font';
         return text({
             asset,
-            next: asset.url
-                ? `Use it: sb_set id "<node>", namespace specials, keys { "src": ${JSON.stringify(asset.url)} }`
-                : 'Uploaded, but the server returned no url — read it back with sb_media_list.',
+            next: !asset.url
+                ? 'Uploaded, but the server returned no url — read it back with sb_media_list.'
+                : font
+                    ? `A font: give it a family — POST /api/sites/{siteId}/fonts {name, source:"upload"}, then PUT ` +
+                        `…/fonts/{groupId}/files {weight, url: ${JSON.stringify(asset.url)}, format, sizeBytes}, ` +
+                        'and use the family by NAME (settings fontFamily or a theme text style).'
+                    : `Use it: sb_set id "<node>", namespace specials, keys { "src": ${JSON.stringify(asset.url)} }`,
         });
     });
     server.registerTool('sb_event', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.81.0",
+  "version": "0.81.1",
   "description": "MCP server that designs and operates a Store Builder site — pages, data, theme and publish — through the platform's own API and live-edit protocol.",
   "mcpName": "io.github.vuluu2k/sbuilder-mcp",
   "type": "module",