@kungal/ui-core 2.53.0 → 2.54.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { ClassValue } from 'clsx';
 export { ClassValue } from 'clsx';
-import { K as KunMessages, a as KunMessagePath, b as KunMessageCatalog } from './types-Dc-w7UpA.cjs';
-export { c as KunTranslate } from './types-Dc-w7UpA.cjs';
+import { K as KunMessages, a as KunMessagePath, b as KunMessageCatalog } from './types-KUpDlvb1.cjs';
+export { c as KunKbdKeyName, d as KunShortcutKey, e as KunShortcutPlatform, f as KunTranslate, g as formatKunShortcut, p as parseKunShortcut, r as resolveKunShortcut, s as speakKunShortcut } from './types-KUpDlvb1.cjs';
 
 type KunUIVariant = 'solid' | 'bordered' | 'light' | 'flat' | 'shadow';
 type KunUIColor = 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info';
@@ -115,6 +115,14 @@ declare const translateKunMessage: (messages: KunMessages, path: KunMessagePath,
 
 declare const KUN_CATALOG_ZH_CN: KunMessageCatalog;
 
+/** Drop separators that would render as stray lines: leading, trailing, and
+ *  all but the first of a run. An app filters one command table per context
+ *  (no "Delete" for a post you do not own) and its separators have to follow;
+ *  React Spectrum S2 hides the same three cases. */
+declare const normalizeKunMenuSeparators: <T extends {
+    type?: string;
+}>(entries: readonly T[]) => T[];
+
 declare const randomNum: (lowerValue: number, upperValue: number) => number;
 
 declare const decodeIfEncoded: (text: string) => string;
@@ -508,4 +516,4 @@ declare const registerKunIcons: (icons: Record<string, KunIconData>) => void;
 declare const getKunIcon: (name: string) => KunIconData | undefined;
 declare const hasKunIcon: (name: string) => boolean;
 
-export { KUN_AVATAR_FALLBACK, KUN_CATALOG_ZH_CN, KUN_CHAT_ALBUM_LIMIT, KUN_CHAT_ALBUM_SIDE, KUN_CHAT_BLOCK_ENTITY_TYPES, KUN_CHAT_TEXT_LIMIT, KUN_CHAT_TYPING_INTERVAL, KUN_CHAT_TYPING_TIMEOUT, KUN_DEFAULT_ROUNDED, KUN_SHATTER_PHYSICS, KUN_SWIPE_DISMISS_PHYSICS, type KunAvatarDecoration, type KunChatAlbumLayout, type KunChatAlbumOptions, type KunChatAlbumSize, type KunChatAlbumTile, type KunChatContext, type KunChatDaySection, type KunChatEntity, type KunChatEntityNode, type KunChatEntityType, type KunChatFormattedText, type KunChatGroupOptions, type KunChatListRow, type KunChatMedia, type KunChatMessage, type KunChatPhoto, type KunChatReaction, type KunChatReactionOption, type KunChatReplyQuote, type KunChatReplyTo, type KunChatSendStatus, type KunChatServiceAction, type KunChatServiceActionType, type KunChatTextLeaf, type KunChatTextNode, type KunChatTypingEvent, type KunChatUser, type KunIconData, KunMessageCatalog, KunMessagePath, KunMessages, type KunSelectionSize, type KunUIColor, type KunUIRounded, type KunUISize, type KunUIVariant, type KunUser, buildKunChatEntityTree, cn, decodeIfEncoded, formatKunChatMarkdown, getKunIcon, getRandomSticker, groupKunChatMessages, hasKunIcon, kunBgClasses, kunBorderClasses, kunChatDayKey, kunChatMessageKey, kunChatTreeText, kunChipSizeClasses, kunControlSizeClasses, kunControlSquareClasses, kunFocusRingClasses, kunFocusRingWithinClasses, kunPanelRoundedClass, kunRingClasses, kunRoundedClasses, kunSelectionSizeClasses, kunSoftBgClasses, kunSolidBgClasses, kunSolidClasses, kunSolidFgClasses, kunTextClasses, kunVariantClasses, layoutKunChatAlbum, normalizeKunChatEntities, parseKunChatMarkdown, pickAvatarFallback, randomNum, registerKunIcon, registerKunIcons, resolveRounded, sliceKunChatEntities, translateKunMessage };
+export { KUN_AVATAR_FALLBACK, KUN_CATALOG_ZH_CN, KUN_CHAT_ALBUM_LIMIT, KUN_CHAT_ALBUM_SIDE, KUN_CHAT_BLOCK_ENTITY_TYPES, KUN_CHAT_TEXT_LIMIT, KUN_CHAT_TYPING_INTERVAL, KUN_CHAT_TYPING_TIMEOUT, KUN_DEFAULT_ROUNDED, KUN_SHATTER_PHYSICS, KUN_SWIPE_DISMISS_PHYSICS, type KunAvatarDecoration, type KunChatAlbumLayout, type KunChatAlbumOptions, type KunChatAlbumSize, type KunChatAlbumTile, type KunChatContext, type KunChatDaySection, type KunChatEntity, type KunChatEntityNode, type KunChatEntityType, type KunChatFormattedText, type KunChatGroupOptions, type KunChatListRow, type KunChatMedia, type KunChatMessage, type KunChatPhoto, type KunChatReaction, type KunChatReactionOption, type KunChatReplyQuote, type KunChatReplyTo, type KunChatSendStatus, type KunChatServiceAction, type KunChatServiceActionType, type KunChatTextLeaf, type KunChatTextNode, type KunChatTypingEvent, type KunChatUser, type KunIconData, KunMessageCatalog, KunMessagePath, KunMessages, type KunSelectionSize, type KunUIColor, type KunUIRounded, type KunUISize, type KunUIVariant, type KunUser, buildKunChatEntityTree, cn, decodeIfEncoded, formatKunChatMarkdown, getKunIcon, getRandomSticker, groupKunChatMessages, hasKunIcon, kunBgClasses, kunBorderClasses, kunChatDayKey, kunChatMessageKey, kunChatTreeText, kunChipSizeClasses, kunControlSizeClasses, kunControlSquareClasses, kunFocusRingClasses, kunFocusRingWithinClasses, kunPanelRoundedClass, kunRingClasses, kunRoundedClasses, kunSelectionSizeClasses, kunSoftBgClasses, kunSolidBgClasses, kunSolidClasses, kunSolidFgClasses, kunTextClasses, kunVariantClasses, layoutKunChatAlbum, normalizeKunChatEntities, normalizeKunMenuSeparators, parseKunChatMarkdown, pickAvatarFallback, randomNum, registerKunIcon, registerKunIcons, resolveRounded, sliceKunChatEntities, translateKunMessage };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ClassValue } from 'clsx';
 export { ClassValue } from 'clsx';
-import { K as KunMessages, a as KunMessagePath, b as KunMessageCatalog } from './types-Dc-w7UpA.js';
-export { c as KunTranslate } from './types-Dc-w7UpA.js';
+import { K as KunMessages, a as KunMessagePath, b as KunMessageCatalog } from './types-KUpDlvb1.js';
+export { c as KunKbdKeyName, d as KunShortcutKey, e as KunShortcutPlatform, f as KunTranslate, g as formatKunShortcut, p as parseKunShortcut, r as resolveKunShortcut, s as speakKunShortcut } from './types-KUpDlvb1.js';
 
 type KunUIVariant = 'solid' | 'bordered' | 'light' | 'flat' | 'shadow';
 type KunUIColor = 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info';
@@ -115,6 +115,14 @@ declare const translateKunMessage: (messages: KunMessages, path: KunMessagePath,
 
 declare const KUN_CATALOG_ZH_CN: KunMessageCatalog;
 
+/** Drop separators that would render as stray lines: leading, trailing, and
+ *  all but the first of a run. An app filters one command table per context
+ *  (no "Delete" for a post you do not own) and its separators have to follow;
+ *  React Spectrum S2 hides the same three cases. */
+declare const normalizeKunMenuSeparators: <T extends {
+    type?: string;
+}>(entries: readonly T[]) => T[];
+
 declare const randomNum: (lowerValue: number, upperValue: number) => number;
 
 declare const decodeIfEncoded: (text: string) => string;
@@ -508,4 +516,4 @@ declare const registerKunIcons: (icons: Record<string, KunIconData>) => void;
 declare const getKunIcon: (name: string) => KunIconData | undefined;
 declare const hasKunIcon: (name: string) => boolean;
 
-export { KUN_AVATAR_FALLBACK, KUN_CATALOG_ZH_CN, KUN_CHAT_ALBUM_LIMIT, KUN_CHAT_ALBUM_SIDE, KUN_CHAT_BLOCK_ENTITY_TYPES, KUN_CHAT_TEXT_LIMIT, KUN_CHAT_TYPING_INTERVAL, KUN_CHAT_TYPING_TIMEOUT, KUN_DEFAULT_ROUNDED, KUN_SHATTER_PHYSICS, KUN_SWIPE_DISMISS_PHYSICS, type KunAvatarDecoration, type KunChatAlbumLayout, type KunChatAlbumOptions, type KunChatAlbumSize, type KunChatAlbumTile, type KunChatContext, type KunChatDaySection, type KunChatEntity, type KunChatEntityNode, type KunChatEntityType, type KunChatFormattedText, type KunChatGroupOptions, type KunChatListRow, type KunChatMedia, type KunChatMessage, type KunChatPhoto, type KunChatReaction, type KunChatReactionOption, type KunChatReplyQuote, type KunChatReplyTo, type KunChatSendStatus, type KunChatServiceAction, type KunChatServiceActionType, type KunChatTextLeaf, type KunChatTextNode, type KunChatTypingEvent, type KunChatUser, type KunIconData, KunMessageCatalog, KunMessagePath, KunMessages, type KunSelectionSize, type KunUIColor, type KunUIRounded, type KunUISize, type KunUIVariant, type KunUser, buildKunChatEntityTree, cn, decodeIfEncoded, formatKunChatMarkdown, getKunIcon, getRandomSticker, groupKunChatMessages, hasKunIcon, kunBgClasses, kunBorderClasses, kunChatDayKey, kunChatMessageKey, kunChatTreeText, kunChipSizeClasses, kunControlSizeClasses, kunControlSquareClasses, kunFocusRingClasses, kunFocusRingWithinClasses, kunPanelRoundedClass, kunRingClasses, kunRoundedClasses, kunSelectionSizeClasses, kunSoftBgClasses, kunSolidBgClasses, kunSolidClasses, kunSolidFgClasses, kunTextClasses, kunVariantClasses, layoutKunChatAlbum, normalizeKunChatEntities, parseKunChatMarkdown, pickAvatarFallback, randomNum, registerKunIcon, registerKunIcons, resolveRounded, sliceKunChatEntities, translateKunMessage };
+export { KUN_AVATAR_FALLBACK, KUN_CATALOG_ZH_CN, KUN_CHAT_ALBUM_LIMIT, KUN_CHAT_ALBUM_SIDE, KUN_CHAT_BLOCK_ENTITY_TYPES, KUN_CHAT_TEXT_LIMIT, KUN_CHAT_TYPING_INTERVAL, KUN_CHAT_TYPING_TIMEOUT, KUN_DEFAULT_ROUNDED, KUN_SHATTER_PHYSICS, KUN_SWIPE_DISMISS_PHYSICS, type KunAvatarDecoration, type KunChatAlbumLayout, type KunChatAlbumOptions, type KunChatAlbumSize, type KunChatAlbumTile, type KunChatContext, type KunChatDaySection, type KunChatEntity, type KunChatEntityNode, type KunChatEntityType, type KunChatFormattedText, type KunChatGroupOptions, type KunChatListRow, type KunChatMedia, type KunChatMessage, type KunChatPhoto, type KunChatReaction, type KunChatReactionOption, type KunChatReplyQuote, type KunChatReplyTo, type KunChatSendStatus, type KunChatServiceAction, type KunChatServiceActionType, type KunChatTextLeaf, type KunChatTextNode, type KunChatTypingEvent, type KunChatUser, type KunIconData, KunMessageCatalog, KunMessagePath, KunMessages, type KunSelectionSize, type KunUIColor, type KunUIRounded, type KunUISize, type KunUIVariant, type KunUser, buildKunChatEntityTree, cn, decodeIfEncoded, formatKunChatMarkdown, getKunIcon, getRandomSticker, groupKunChatMessages, hasKunIcon, kunBgClasses, kunBorderClasses, kunChatDayKey, kunChatMessageKey, kunChatTreeText, kunChipSizeClasses, kunControlSizeClasses, kunControlSquareClasses, kunFocusRingClasses, kunFocusRingWithinClasses, kunPanelRoundedClass, kunRingClasses, kunRoundedClasses, kunSelectionSizeClasses, kunSoftBgClasses, kunSolidBgClasses, kunSolidClasses, kunSolidFgClasses, kunTextClasses, kunVariantClasses, layoutKunChatAlbum, normalizeKunChatEntities, normalizeKunMenuSeparators, parseKunChatMarkdown, pickAvatarFallback, randomNum, registerKunIcon, registerKunIcons, resolveRounded, sliceKunChatEntities, translateKunMessage };

package/dist/index.js

@@ -456,6 +456,30 @@ var zh_CN_default = {
       reveal: "显示密码",
       hide: "隐藏密码"
     },
+    kbd: {
+      control: "Ctrl",
+      alt: "Alt",
+      option: "Option",
+      shift: "Shift",
+      command: "Command",
+      meta: "Windows 键",
+      enter: "回车",
+      escape: "Esc",
+      backspace: "退格",
+      delete: "删除",
+      tab: "Tab",
+      space: "空格",
+      up: "上箭头",
+      down: "下箭头",
+      left: "左箭头",
+      right: "右箭头",
+      pageUp: "向上翻页",
+      pageDown: "向下翻页",
+      home: "Home",
+      end: "End",
+      plus: "加号",
+      then: "然后"
+    },
     lightbox: {
       label: "图片查看器",
       close: "关闭",
@@ -550,6 +574,114 @@ var zh_CN_default = {
 // src/locale/zh-CN.ts
 var KUN_CATALOG_ZH_CN = zh_CN_default;
 
+// src/shortcut.ts
+var ALIASES = {
+  mod: "Mod",
+  ctrl: "Control",
+  control: "Control",
+  alt: "Alt",
+  option: "Alt",
+  opt: "Alt",
+  shift: "Shift",
+  meta: "Meta",
+  cmd: "Meta",
+  command: "Meta",
+  super: "Meta",
+  win: "Meta",
+  enter: "Enter",
+  return: "Enter",
+  esc: "Escape",
+  escape: "Escape",
+  backspace: "Backspace",
+  del: "Delete",
+  delete: "Delete",
+  tab: "Tab",
+  space: "Space",
+  spacebar: "Space",
+  up: "ArrowUp",
+  arrowup: "ArrowUp",
+  down: "ArrowDown",
+  arrowdown: "ArrowDown",
+  left: "ArrowLeft",
+  arrowleft: "ArrowLeft",
+  right: "ArrowRight",
+  arrowright: "ArrowRight",
+  pageup: "PageUp",
+  pgup: "PageUp",
+  pagedown: "PageDown",
+  pgdn: "PageDown",
+  home: "Home",
+  end: "End",
+  plus: "+"
+};
+var MODIFIER_ORDER = {
+  apple: ["Control", "Alt", "Shift", "Meta"],
+  other: ["Control", "Meta", "Alt", "Shift"]
+};
+var NAMED = {
+  Control: { apple: "⌃", other: "Ctrl", spoken: () => "control" },
+  Alt: { apple: "⌥", other: "Alt", spoken: (p) => p === "apple" ? "option" : "alt" },
+  Shift: { apple: "⇧", other: "Shift", spoken: () => "shift" },
+  Meta: { apple: "⌘", other: "Win", spoken: (p) => p === "apple" ? "command" : "meta" },
+  Enter: { apple: "↩", other: "Enter", spoken: () => "enter" },
+  Escape: { apple: "Esc", other: "Esc", spoken: () => "escape" },
+  Backspace: { apple: "⌫", other: "Backspace", spoken: () => "backspace" },
+  Delete: { apple: "⌦", other: "Del", spoken: () => "delete" },
+  Tab: { apple: "⇥", other: "Tab", spoken: () => "tab" },
+  Space: { apple: "Space", other: "Space", spoken: () => "space" },
+  ArrowUp: { apple: "↑", other: "↑", spoken: () => "up" },
+  ArrowDown: { apple: "↓", other: "↓", spoken: () => "down" },
+  ArrowLeft: { apple: "←", other: "←", spoken: () => "left" },
+  ArrowRight: { apple: "→", other: "→", spoken: () => "right" },
+  PageUp: { apple: "PgUp", other: "PgUp", spoken: () => "pageUp" },
+  PageDown: { apple: "PgDn", other: "PgDn", spoken: () => "pageDown" },
+  Home: { apple: "Home", other: "Home", spoken: () => "home" },
+  End: { apple: "End", other: "End", spoken: () => "end" },
+  "+": { apple: "+", other: "+", spoken: () => "plus" }
+};
+var canonicalKey = (token) => {
+  const alias = ALIASES[token.toLowerCase()];
+  if (alias) return alias;
+  if (/^f\d{1,2}$/i.test(token)) return token.toUpperCase();
+  return token.length === 1 ? token.toUpperCase() : token;
+};
+var splitChord = (chord) => {
+  if (chord === "+") return ["+"];
+  const plusKey = chord.endsWith("++");
+  const body = plusKey ? chord.slice(0, -2) : chord;
+  const keys = body.split("+").filter(Boolean);
+  return plusKey ? [...keys, "+"] : keys;
+};
+var parseKunShortcut = (keys) => keys.trim().split(/\s+/).filter(Boolean).map((chord) => splitChord(chord).map(canonicalKey)).filter((chord) => chord.length > 0);
+var resolveKunShortcut = (keys, platform) => {
+  const order = MODIFIER_ORDER[platform];
+  return parseKunShortcut(keys).map((chord) => {
+    const resolved = chord.map(
+      (key) => key === "Mod" ? platform === "apple" ? "Meta" : "Control" : key
+    );
+    const modifiers = order.filter((m) => resolved.includes(m));
+    const rest = resolved.filter((k, i) => !order.includes(k) && resolved.indexOf(k) === i);
+    return [...modifiers, ...rest].map((key) => {
+      const named = NAMED[key];
+      return named ? { key, label: named[platform], spoken: named.spoken(platform) } : { key, label: key, spoken: null };
+    });
+  });
+};
+var formatKunShortcut = (keys, platform) => resolveKunShortcut(keys, platform).map((chord) => chord.map((k) => k.label).join(platform === "apple" ? "" : "+")).join(" ");
+var speakKunShortcut = (sequence, name, then) => sequence.map((chord) => chord.map((k) => k.spoken ? name(k.spoken) : k.label).join(" ")).join(` ${then} `);
+
+// src/menu.ts
+var normalizeKunMenuSeparators = (entries) => {
+  const out = [];
+  for (const entry of entries) {
+    const last = out[out.length - 1];
+    if (entry.type === "separator" && (!last || last.type === "separator")) continue;
+    out.push(entry);
+  }
+  while (out.length && out[out.length - 1].type === "separator") out.pop();
+  return out;
+};
+
 // src/random.ts
 var randomNum = (lowerValue, upperValue) => Math.floor(Math.random() * (upperValue - lowerValue + 1) + lowerValue);
 
@@ -1565,6 +1697,6 @@ var registerKunIcons = (icons) => {
 var getKunIcon = (name) => registry.get(name);
 var hasKunIcon = (name) => registry.has(name);
 
-export { KUN_AVATAR_FALLBACK, KUN_CATALOG_ZH_CN, KUN_CHAT_ALBUM_LIMIT, KUN_CHAT_ALBUM_SIDE, KUN_CHAT_BLOCK_ENTITY_TYPES, KUN_CHAT_TEXT_LIMIT, KUN_CHAT_TYPING_INTERVAL, KUN_CHAT_TYPING_TIMEOUT, KUN_DEFAULT_ROUNDED, KUN_SHATTER_PHYSICS, KUN_SWIPE_DISMISS_PHYSICS, buildKunChatEntityTree, cn, decodeIfEncoded, formatKunChatMarkdown, getKunIcon, getRandomSticker, groupKunChatMessages, hasKunIcon, kunBgClasses, kunBorderClasses, kunChatDayKey, kunChatMessageKey, kunChatTreeText, kunChipSizeClasses, kunControlSizeClasses, kunControlSquareClasses, kunFocusRingClasses, kunFocusRingWithinClasses, kunPanelRoundedClass, kunRingClasses, kunRoundedClasses, kunSelectionSizeClasses, kunSoftBgClasses, kunSolidBgClasses, kunSolidClasses, kunSolidFgClasses, kunTextClasses, kunVariantClasses, layoutKunChatAlbum, normalizeKunChatEntities, parseKunChatMarkdown, pickAvatarFallback, randomNum, registerKunIcon, registerKunIcons, resolveRounded, sliceKunChatEntities, translateKunMessage };
+export { KUN_AVATAR_FALLBACK, KUN_CATALOG_ZH_CN, KUN_CHAT_ALBUM_LIMIT, KUN_CHAT_ALBUM_SIDE, KUN_CHAT_BLOCK_ENTITY_TYPES, KUN_CHAT_TEXT_LIMIT, KUN_CHAT_TYPING_INTERVAL, KUN_CHAT_TYPING_TIMEOUT, KUN_DEFAULT_ROUNDED, KUN_SHATTER_PHYSICS, KUN_SWIPE_DISMISS_PHYSICS, buildKunChatEntityTree, cn, decodeIfEncoded, formatKunChatMarkdown, formatKunShortcut, getKunIcon, getRandomSticker, groupKunChatMessages, hasKunIcon, kunBgClasses, kunBorderClasses, kunChatDayKey, kunChatMessageKey, kunChatTreeText, kunChipSizeClasses, kunControlSizeClasses, kunControlSquareClasses, kunFocusRingClasses, kunFocusRingWithinClasses, kunPanelRoundedClass, kunRingClasses, kunRoundedClasses, kunSelectionSizeClasses, kunSoftBgClasses, kunSolidBgClasses, kunSolidClasses, kunSolidFgClasses, kunTextClasses, kunVariantClasses, layoutKunChatAlbum, normalizeKunChatEntities, normalizeKunMenuSeparators, parseKunChatMarkdown, parseKunShortcut, pickAvatarFallback, randomNum, registerKunIcon, registerKunIcons, resolveKunShortcut, resolveRounded, sliceKunChatEntities, speakKunShortcut, translateKunMessage };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map