@xenonbyte/da-vinci-workflow 0.1.21 → 0.1.23

package/lib/icon-search.js

@@ -0,0 +1,353 @@
+const { normalizeIconText, tokenizeIconText } = require("./icon-text");
+
+const MATERIAL_ROUNDED = "Material Symbols Rounded";
+const MATERIAL_OUTLINED = "Material Symbols Outlined";
+const MATERIAL_SHARP = "Material Symbols Sharp";
+
+const FAMILY_BY_ID = {
+  msr: MATERIAL_ROUNDED,
+  mso: MATERIAL_OUTLINED,
+  mss: MATERIAL_SHARP,
+  lucide: "lucide",
+  feather: "feather",
+  phosphor: "phosphor"
+};
+
+const FAMILY_ORDER = [
+  MATERIAL_ROUNDED,
+  "lucide",
+  "feather",
+  "phosphor",
+  MATERIAL_OUTLINED,
+  MATERIAL_SHARP
+];
+
+const FAMILY_ALIAS_TO_SET = new Map([
+  ["all", new Set(FAMILY_ORDER)],
+  ["*", new Set(FAMILY_ORDER)],
+  ["material", new Set([MATERIAL_ROUNDED, MATERIAL_OUTLINED, MATERIAL_SHARP])],
+  ["material-symbols", new Set([MATERIAL_ROUNDED, MATERIAL_OUTLINED, MATERIAL_SHARP])],
+  ["material symbols", new Set([MATERIAL_ROUNDED, MATERIAL_OUTLINED, MATERIAL_SHARP])],
+  ["material symbols rounded", new Set([MATERIAL_ROUNDED])],
+  ["material symbols outlined", new Set([MATERIAL_OUTLINED])],
+  ["material symbols sharp", new Set([MATERIAL_SHARP])],
+  ["rounded", new Set([MATERIAL_ROUNDED])],
+  ["outlined", new Set([MATERIAL_OUTLINED])],
+  ["sharp", new Set([MATERIAL_SHARP])],
+  ["msr", new Set([MATERIAL_ROUNDED])],
+  ["mso", new Set([MATERIAL_OUTLINED])],
+  ["mss", new Set([MATERIAL_SHARP])],
+  ["lucide", new Set(["lucide"])],
+  ["feather", new Set(["feather"])],
+  ["phosphor", new Set(["phosphor"])]
+]);
+
+function icon(semantic, namesByFamily, tags = []) {
+  return {
+    semantic,
+    namesByFamily,
+    tags
+  };
+}
+
+const ICON_ENTRIES = [
+  icon("settings", { msr: "settings", mso: "settings", mss: "settings", lucide: "settings", feather: "settings", phosphor: "gear" }, ["config", "preferences", "gear", "cog", "设置", "配置", "偏好", "齿轮"]),
+  icon("sliders", { msr: "tune", mso: "tune", mss: "tune", lucide: "sliders-horizontal", feather: "sliders", phosphor: "sliders-horizontal" }, ["adjust", "filter", "controls", "调节", "筛选", "控制"]),
+  icon("search", { msr: "search", mso: "search", mss: "search", lucide: "search", feather: "search", phosphor: "magnifying-glass" }, ["find", "lookup", "搜索", "查找"]),
+  icon("home", { msr: "home", mso: "home", mss: "home", lucide: "house", feather: "home", phosphor: "house" }, ["dashboard", "main", "首页", "主页"]),
+  icon("lock", { msr: "lock", mso: "lock", mss: "lock", lucide: "lock", feather: "lock", phosphor: "lock" }, ["secure", "security", "加密", "锁定", "安全"]),
+  icon("unlock", { msr: "lock_open", mso: "lock_open", mss: "lock_open", lucide: "lock-open", feather: "unlock", phosphor: "lock-open" }, ["open lock", "解锁", "开锁"]),
+  icon("key", { msr: "key", mso: "key", mss: "key", lucide: "key-round", feather: "key", phosphor: "key" }, ["passcode", "credential", "密码", "密钥"]),
+  icon("shield", { msr: "shield", mso: "shield", mss: "shield", lucide: "shield", feather: "shield", phosphor: "shield" }, ["protect", "defense", "保护", "防护"]),
+  icon("shield-check", { msr: "verified_user", mso: "verified_user", mss: "verified_user", lucide: "shield-check", feather: "shield", phosphor: "shield-check" }, ["verified", "trusted", "已验证", "可信"]),
+  icon("warning", { msr: "warning", mso: "warning", mss: "warning", lucide: "triangle-alert", feather: "alert-triangle", phosphor: "warning" }, ["alert", "caution", "警告", "提醒"]),
+  icon("error", { msr: "error", mso: "error", mss: "error", lucide: "circle-x", feather: "x-circle", phosphor: "x-circle" }, ["danger", "failed", "错误", "失败"]),
+  icon("info", { msr: "info", mso: "info", mss: "info", lucide: "info", feather: "info", phosphor: "info" }, ["hint", "about", "信息", "说明"]),
+  icon("help", { msr: "help", mso: "help", mss: "help", lucide: "circle-help", feather: "help-circle", phosphor: "question" }, ["question", "faq", "帮助", "问号"]),
+  icon("check", { msr: "check", mso: "check", mss: "check", lucide: "check", feather: "check", phosphor: "check" }, ["ok", "done", "confirm", "确认", "完成"]),
+  icon("check-circle", { msr: "check_circle", mso: "check_circle", mss: "check_circle", lucide: "circle-check", feather: "check-circle", phosphor: "check-circle" }, ["success", "pass", "成功", "通过"]),
+  icon("close", { msr: "close", mso: "close", mss: "close", lucide: "x", feather: "x", phosphor: "x" }, ["dismiss", "cancel", "关闭", "取消"]),
+  icon("add", { msr: "add", mso: "add", mss: "add", lucide: "plus", feather: "plus", phosphor: "plus" }, ["create", "new", "新增", "添加"]),
+  icon("remove", { msr: "remove", mso: "remove", mss: "remove", lucide: "minus", feather: "minus", phosphor: "minus" }, ["subtract", "删除项", "移除"]),
+  icon("edit", { msr: "edit", mso: "edit", mss: "edit", lucide: "pencil", feather: "edit-3", phosphor: "pencil" }, ["modify", "rename", "编辑", "修改"]),
+  icon("delete", { msr: "delete", mso: "delete", mss: "delete", lucide: "trash-2", feather: "trash-2", phosphor: "trash" }, ["trash", "remove", "删除", "垃圾桶"]),
+  icon("refresh", { msr: "refresh", mso: "refresh", mss: "refresh", lucide: "refresh-cw", feather: "refresh-cw", phosphor: "arrow-clockwise" }, ["reload", "retry", "刷新", "重试"]),
+  icon("sync", { msr: "sync", mso: "sync", mss: "sync", lucide: "rotate-cw", feather: "rotate-cw", phosphor: "arrows-clockwise" }, ["synchronize", "同步"]),
+  icon("download", { msr: "download", mso: "download", mss: "download", lucide: "download", feather: "download", phosphor: "download" }, ["save", "export", "下载", "导出"]),
+  icon("upload", { msr: "upload", mso: "upload", mss: "upload", lucide: "upload", feather: "upload", phosphor: "upload" }, ["import", "发送", "上传", "导入"]),
+  icon("cloud-upload", { msr: "cloud_upload", mso: "cloud_upload", mss: "cloud_upload", lucide: "cloud-upload", feather: "upload-cloud", phosphor: "cloud-arrow-up" }, ["backup", "云上传", "备份"]),
+  icon("cloud-download", { msr: "cloud_download", mso: "cloud_download", mss: "cloud_download", lucide: "cloud-download", feather: "download-cloud", phosphor: "cloud-arrow-down" }, ["sync down", "云下载"]),
+  icon("folder", { msr: "folder", mso: "folder", mss: "folder", lucide: "folder", feather: "folder", phosphor: "folder" }, ["directory", "文件夹"]),
+  icon("file", { msr: "description", mso: "description", mss: "description", lucide: "file", feather: "file", phosphor: "file" }, ["document", "文档", "文件"]),
+  icon("file-text", { msr: "article", mso: "article", mss: "article", lucide: "file-text", feather: "file-text", phosphor: "file-text" }, ["note", "文本", "说明文档"]),
+  icon("image", { msr: "image", mso: "image", mss: "image", lucide: "image", feather: "image", phosphor: "image" }, ["photo", "picture", "图片", "照片"]),
+  icon("camera", { msr: "photo_camera", mso: "photo_camera", mss: "photo_camera", lucide: "camera", feather: "camera", phosphor: "camera" }, ["capture", "拍照", "相机"]),
+  icon("bell", { msr: "notifications", mso: "notifications", mss: "notifications", lucide: "bell", feather: "bell", phosphor: "bell" }, ["notification", "提醒", "通知"]),
+  icon("mail", { msr: "mail", mso: "mail", mss: "mail", lucide: "mail", feather: "mail", phosphor: "envelope" }, ["email", "邮箱", "邮件"]),
+  icon("message", { msr: "chat", mso: "chat", mss: "chat", lucide: "message-circle", feather: "message-circle", phosphor: "chat-circle" }, ["chat", "sms", "消息", "聊天"]),
+  icon("phone", { msr: "phone", mso: "phone", mss: "phone", lucide: "phone", feather: "phone", phosphor: "phone" }, ["call", "拨号", "电话"]),
+  icon("location", { msr: "location_on", mso: "location_on", mss: "location_on", lucide: "map-pin", feather: "map-pin", phosphor: "map-pin" }, ["address", "gps", "定位", "位置"]),
+  icon("navigation", { msr: "navigation", mso: "navigation", mss: "navigation", lucide: "navigation", feather: "navigation", phosphor: "navigation-arrow" }, ["direction", "route", "导航", "方向"]),
+  icon("calendar", { msr: "calendar_today", mso: "calendar_today", mss: "calendar_today", lucide: "calendar", feather: "calendar", phosphor: "calendar" }, ["date", "schedule", "日期", "日历"]),
+  icon("clock", { msr: "schedule", mso: "schedule", mss: "schedule", lucide: "clock-3", feather: "clock", phosphor: "clock" }, ["time", "hour", "时间", "时钟"]),
+  icon("timer", { msr: "timer", mso: "timer", mss: "timer", lucide: "timer", feather: "clock", phosphor: "timer" }, ["countdown", "倒计时", "计时器"]),
+  icon("eye", { msr: "visibility", mso: "visibility", mss: "visibility", lucide: "eye", feather: "eye", phosphor: "eye" }, ["show", "preview", "可见", "显示"]),
+  icon("eye-off", { msr: "visibility_off", mso: "visibility_off", mss: "visibility_off", lucide: "eye-off", feather: "eye-off", phosphor: "eye-slash" }, ["hide", "private", "隐藏", "不可见"]),
+  icon("fingerprint", { msr: "fingerprint", mso: "fingerprint", mss: "fingerprint", lucide: "fingerprint", feather: "circle", phosphor: "fingerprint" }, ["biometric", "touch id", "指纹", "生物识别"]),
+  icon("qr", { msr: "qr_code_scanner", mso: "qr_code_scanner", mss: "qr_code_scanner", lucide: "qr-code", feather: "maximize-2", phosphor: "qr-code" }, ["scan", "扫码", "二维码"]),
+  icon("copy", { msr: "content_copy", mso: "content_copy", mss: "content_copy", lucide: "copy", feather: "copy", phosphor: "copy" }, ["duplicate", "复制"]),
+  icon("share", { msr: "share", mso: "share", mss: "share", lucide: "share-2", feather: "share-2", phosphor: "share-network" }, ["send", "分享"]),
+  icon("star", { msr: "star", mso: "star", mss: "star", lucide: "star", feather: "star", phosphor: "star" }, ["favorite", "rate", "收藏", "星标"]),
+  icon("heart", { msr: "favorite", mso: "favorite", mss: "favorite", lucide: "heart", feather: "heart", phosphor: "heart" }, ["like", "love", "喜欢", "点赞"]),
+  icon("bookmark", { msr: "bookmark", mso: "bookmark", mss: "bookmark", lucide: "bookmark", feather: "bookmark", phosphor: "bookmark-simple" }, ["save later", "书签"]),
+  icon("user", { msr: "person", mso: "person", mss: "person", lucide: "user", feather: "user", phosphor: "user" }, ["profile", "account", "个人", "用户", "账户"]),
+  icon("users", { msr: "groups", mso: "groups", mss: "groups", lucide: "users", feather: "users", phosphor: "users" }, ["team", "group", "团队", "群组"]),
+  icon("login", { msr: "login", mso: "login", mss: "login", lucide: "log-in", feather: "log-in", phosphor: "sign-in" }, ["sign in", "enter", "登录"]),
+  icon("logout", { msr: "logout", mso: "logout", mss: "logout", lucide: "log-out", feather: "log-out", phosphor: "sign-out" }, ["sign out", "exit", "退出", "注销"]),
+  icon("menu", { msr: "menu", mso: "menu", mss: "menu", lucide: "menu", feather: "menu", phosphor: "list" }, ["hamburger", "导航菜单", "菜单"]),
+  icon("more", { msr: "more_horiz", mso: "more_horiz", mss: "more_horiz", lucide: "ellipsis", feather: "more-horizontal", phosphor: "dots-three-outline" }, ["ellipsis", "overflow", "更多"]),
+  icon("chevron-left", { msr: "chevron_left", mso: "chevron_left", mss: "chevron_left", lucide: "chevron-left", feather: "chevron-left", phosphor: "caret-left" }, ["back", "prev", "返回", "左箭头"]),
+  icon("chevron-right", { msr: "chevron_right", mso: "chevron_right", mss: "chevron_right", lucide: "chevron-right", feather: "chevron-right", phosphor: "caret-right" }, ["next", "forward", "前进", "右箭头"]),
+  icon("chevron-up", { msr: "expand_less", mso: "expand_less", mss: "expand_less", lucide: "chevron-up", feather: "chevron-up", phosphor: "caret-up" }, ["up", "collapse", "上箭头"]),
+  icon("chevron-down", { msr: "expand_more", mso: "expand_more", mss: "expand_more", lucide: "chevron-down", feather: "chevron-down", phosphor: "caret-down" }, ["down", "expand", "下箭头"]),
+  icon("play", { msr: "play_arrow", mso: "play_arrow", mss: "play_arrow", lucide: "play", feather: "play", phosphor: "play" }, ["start", "播放"]),
+  icon("pause", { msr: "pause", mso: "pause", mss: "pause", lucide: "pause", feather: "pause", phosphor: "pause" }, ["stop briefly", "暂停"]),
+  icon("mic", { msr: "mic", mso: "mic", mss: "mic", lucide: "mic", feather: "mic", phosphor: "microphone" }, ["voice", "record", "语音", "麦克风"]),
+  icon("volume", { msr: "volume_up", mso: "volume_up", mss: "volume_up", lucide: "volume-2", feather: "volume-2", phosphor: "speaker-high" }, ["sound", "audio", "声音", "音量"]),
+  icon("wifi", { msr: "wifi", mso: "wifi", mss: "wifi", lucide: "wifi", feather: "wifi", phosphor: "wifi-high" }, ["network", "internet", "网络", "无线"]),
+  icon("bluetooth", { msr: "bluetooth", mso: "bluetooth", mss: "bluetooth", lucide: "bluetooth", feather: "bluetooth", phosphor: "bluetooth" }, ["bt", "蓝牙"]),
+  icon("battery", { msr: "battery_full", mso: "battery_full", mss: "battery_full", lucide: "battery-full", feather: "battery", phosphor: "battery-full" }, ["power", "电池", "电量"]),
+  icon("sun", { msr: "light_mode", mso: "light_mode", mss: "light_mode", lucide: "sun", feather: "sun", phosphor: "sun" }, ["day", "light", "白天", "亮色"]),
+  icon("moon", { msr: "dark_mode", mso: "dark_mode", mss: "dark_mode", lucide: "moon", feather: "moon", phosphor: "moon" }, ["night", "dark", "夜间", "暗色"]),
+  icon("cart", { msr: "shopping_cart", mso: "shopping_cart", mss: "shopping_cart", lucide: "shopping-cart", feather: "shopping-cart", phosphor: "shopping-cart" }, ["shop", "buy", "购物车"]),
+  icon("credit-card", { msr: "credit_card", mso: "credit_card", mss: "credit_card", lucide: "credit-card", feather: "credit-card", phosphor: "credit-card" }, ["payment", "billing", "支付", "账单"]),
+  icon("vault", { msr: "inventory_2", mso: "inventory_2", mss: "inventory_2", lucide: "vault", feather: "archive", phosphor: "vault" }, ["safe box", "secure storage", "保险箱", "金库"])
+];
+
+const normalize = normalizeIconText;
+const tokenize = tokenizeIconText;
+
+function unique(values) {
+  return Array.from(new Set(values.filter(Boolean)));
+}
+
+function createCandidate(entry, family, name) {
+  const semanticTokens = tokenize(entry.semantic);
+  const nameTokens = tokenize(name);
+  const tagTokens = entry.tags.flatMap((tag) => tokenize(tag));
+  const searchableTokens = unique([...semanticTokens, ...nameTokens, ...tagTokens]);
+  return {
+    family,
+    name,
+    semantic: entry.semantic,
+    tags: unique(entry.tags),
+    searchableTokens,
+    searchableText: searchableTokens.join(" ")
+  };
+}
+
+const ICON_CANDIDATES = ICON_ENTRIES.flatMap((entry) =>
+  Object.entries(entry.namesByFamily).flatMap(([familyId, name]) => {
+    const family = FAMILY_BY_ID[familyId];
+    if (!family || !name) {
+      return [];
+    }
+    return [createCandidate(entry, family, name)];
+  })
+);
+
+function buildCandidatesFromCatalogRecords(records = []) {
+  if (!Array.isArray(records)) {
+    return [];
+  }
+
+  return records
+    .map((record) => {
+      if (!record || typeof record !== "object") {
+        return null;
+      }
+      const family = String(record.family || "").trim();
+      const name = String(record.name || "").trim();
+      if (!family || !name) {
+        return null;
+      }
+      const semantic = String(record.semantic || name).trim();
+      const tags = Array.isArray(record.tags) ? record.tags.map((tag) => String(tag)) : [];
+      return createCandidate(
+        {
+          semantic,
+          tags
+        },
+        family,
+        name
+      );
+    })
+    .filter(Boolean);
+}
+
+function mergeCandidates(dynamicCandidates = []) {
+  const merged = new Map();
+
+  for (const candidate of ICON_CANDIDATES) {
+    merged.set(`${candidate.family}::${candidate.name}`, candidate);
+  }
+
+  for (const candidate of dynamicCandidates) {
+    const key = `${candidate.family}::${candidate.name}`;
+    if (!merged.has(key)) {
+      merged.set(key, candidate);
+    }
+  }
+
+  return Array.from(merged.values());
+}
+
+function resolveFamilySet(filter) {
+  if (!filter) {
+    return new Set(FAMILY_ORDER);
+  }
+  const normalized = normalize(filter);
+  const resolved = FAMILY_ALIAS_TO_SET.get(normalized);
+  if (!resolved) {
+    const allowed = Array.from(FAMILY_ALIAS_TO_SET.keys()).sort().join(", ");
+    throw new Error(`Unknown icon family filter: ${filter}. Allowed values include: ${allowed}`);
+  }
+  return new Set(resolved);
+}
+
+function buildIconNodeSuggestion(match) {
+  const suggestion = {
+    type: "icon_font",
+    iconFontFamily: match.family,
+    iconFontName: match.name,
+    width: 24,
+    height: 24
+  };
+  if (match.family.startsWith("Material Symbols")) {
+    suggestion.weight = 700;
+  }
+  return suggestion;
+}
+
+function scoreMatch(candidate, queryText, queryTokens) {
+  let score = 0;
+  const nameText = normalize(candidate.name);
+  const semanticText = normalize(candidate.semantic);
+
+  if (queryText && (queryText === nameText || queryText === semanticText)) {
+    score += 120;
+  }
+  if (queryText && (nameText.startsWith(queryText) || semanticText.startsWith(queryText))) {
+    score += 40;
+  }
+
+  for (const token of queryTokens) {
+    if (candidate.searchableTokens.includes(token)) {
+      score += 30;
+      continue;
+    }
+    if (nameText.includes(token) || semanticText.includes(token)) {
+      score += 16;
+      continue;
+    }
+    if (candidate.searchableText.includes(token)) {
+      score += 8;
+      continue;
+    }
+    score -= 8;
+  }
+
+  if (candidate.family === MATERIAL_ROUNDED) {
+    score += 4;
+  }
+
+  return score;
+}
+
+function compareMatches(a, b) {
+  if (a.score !== b.score) {
+    return b.score - a.score;
+  }
+  const familyIndexA = FAMILY_ORDER.indexOf(a.family);
+  const familyIndexB = FAMILY_ORDER.indexOf(b.family);
+  if (familyIndexA !== familyIndexB) {
+    return familyIndexA - familyIndexB;
+  }
+  return a.name.localeCompare(b.name);
+}
+
+function searchIconLibrary(query, options = {}) {
+  const queryText = normalize(query);
+  const queryTokens = unique([
+    ...tokenize(queryText),
+    ...tokenize((options.extraQueryTokens || []).join(" "))
+  ]);
+  if (!queryText) {
+    throw new Error("`icon-search` requires a non-empty query.");
+  }
+
+  const familySet = resolveFamilySet(options.family || "all");
+  const top = Number.isFinite(Number(options.top)) ? Math.max(1, Math.min(50, Number(options.top))) : 8;
+  const catalogCandidates = buildCandidatesFromCatalogRecords(options.catalog || []);
+  const candidatePool = mergeCandidates(catalogCandidates);
+
+  const ranked = candidatePool.filter((candidate) => familySet.has(candidate.family))
+    .map((candidate) => ({
+      ...candidate,
+      score: scoreMatch(candidate, queryText, queryTokens)
+    }))
+    .filter((match) => match.score > 0)
+    .sort(compareMatches);
+
+  const topMatches = ranked.slice(0, top).map((match) => ({
+    family: match.family,
+    name: match.name,
+    semantic: match.semantic,
+    tags: match.tags,
+    score: match.score,
+    node: buildIconNodeSuggestion(match)
+  }));
+
+  return {
+    query: String(query),
+    normalizedQuery: queryText,
+    familyFilter: options.family || "all",
+    top,
+    totalMatches: ranked.length,
+    matches: topMatches
+  };
+}
+
+function formatIconSearchReport(result) {
+  const lines = [
+    "Icon Search",
+    `Query: ${result.query}`,
+    `Family filter: ${result.familyFilter}`,
+    `Matches: ${result.matches.length}/${result.totalMatches}`
+  ];
+
+  if (result.matches.length === 0) {
+    lines.push("No candidates scored above threshold. Try broader terms or a different family filter.");
+    return lines.join("\n");
+  }
+
+  for (let index = 0; index < result.matches.length; index += 1) {
+    const match = result.matches[index];
+    lines.push(`${index + 1}. ${match.family} / ${match.name} (score ${match.score})`);
+    lines.push(`   semantic: ${match.semantic}`);
+    lines.push(`   tags: ${match.tags.slice(0, 8).join(", ")}`);
+    lines.push(`   node: ${JSON.stringify(match.node)}`);
+  }
+
+  return lines.join("\n");
+}
+
+module.exports = {
+  MATERIAL_ROUNDED,
+  MATERIAL_OUTLINED,
+  MATERIAL_SHARP,
+  FAMILY_ORDER,
+  buildCandidatesFromCatalogRecords,
+  searchIconLibrary,
+  formatIconSearchReport
+};