@robot-admin/naive-ui-components 0.22.1 → 0.23.1

package/dist/index7.vue.d.ts

@@ -1,27 +1,121 @@
 import * as vue from "vue";
 
-//#region src/components/C_City/index.vue.d.ts
-interface Props {
-  modelValue?: string;
+//#region src/components/C_Chat/types.d.ts
+/**
+ * @Description: C_Chat 通用聊天组件 - 类型定义
+ */
+/** 消息类型 */
+type MessageType = 'text' | 'image' | 'file' | 'system';
+/** 消息发送方 */
+type MessageSender = 'self' | 'other' | 'system';
+/** 消息状态 */
+type MessageStatus = 'sending' | 'sent' | 'failed';
+/** 单条消息 */
+interface ChatMessage {
+  /** 唯一标识 */
+  id: string;
+  /** 消息内容（文本 / 图片 URL / 文件信息 JSON） */
+  content: string;
+  /** 消息类型 */
+  type: MessageType;
+  /** 发送方 */
+  sender: MessageSender;
+  /** 发送时间（ISO 字符串 或 时间戳） */
+  timestamp: string | number;
+  /** 发送者头像 URL */
+  avatar?: string;
+  /** 发送者用户名 */
+  username?: string;
+  /** 消息状态 */
+  status?: MessageStatus;
+  /** 文件名（type = 'file' 时使用） */
+  fileName?: string;
+  /** 文件大小（字节） */
+  fileSize?: number;
+}
+/** 联系人 / 会话 */
+interface ChatContact {
+  /** 唯一标识 */
+  id: string;
+  /** 显示名称 */
+  name: string;
+  /** 头像 URL */
+  avatar?: string;
+  /** 最后一条消息摘要 */
+  lastMessage?: string;
+  /** 最后消息时间 */
+  lastTime?: string | number;
+  /** 未读数 */
+  unread?: number;
+  /** 是否在线 */
+  online?: boolean;
+}
+interface ChatProps {
+  /** 联系人列表 */
+  contacts?: ChatContact[];
+  /** 消息列表 */
+  messages?: ChatMessage[];
+  /** 当前选中的联系人 ID */
+  currentContactId?: string;
+  /** 输入框占位符 */
   placeholder?: string;
-  showLetters?: boolean;
+  /** 是否显示联系人侧栏 */
+  showContacts?: boolean;
+  /** 是否显示消息时间戳 */
+  showTimestamp?: boolean;
+  /** 当前用户头像 */
+  selfAvatar?: string;
+  /** 当前用户名 */
+  selfName?: string;
+  /** 是否显示发送按钮 */
+  showSendBtn?: boolean;
+  /** 是否正在加载历史消息 */
+  loadingHistory?: boolean;
+  /** 大列表自动窗口化；false 可保留完整 DOM（消息 200 条、联系人 100 条起）。 */
+  virtualScroll?: boolean;
+  /** 标题（无联系人模式时显示） */
+  title?: string;
 }
-declare var __VLS_9: {
-  value: string | undefined;
-  visible: boolean;
-};
+declare const DEFAULT_CHAT_PROPS: Required<Pick<ChatProps, 'placeholder' | 'showContacts' | 'showTimestamp' | 'showSendBtn' | 'loadingHistory' | 'title'>>;
+//#endregion
+//#region src/components/C_Chat/index.vue.d.ts
+declare var __VLS_39: {}, __VLS_83: {};
 type __VLS_Slots = {} & {
-  trigger?: (props: typeof __VLS_9) => any;
+  header?: (props: typeof __VLS_39) => any;
+} & {
+  'input-actions'?: (props: typeof __VLS_83) => any;
 };
-declare const __VLS_base: vue.DefineComponent<Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  "update:modelValue": (value: string) => any;
-  change: (value: string) => any;
-}, string, vue.PublicProps, Readonly<Props> & Readonly<{
-  "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-  onChange?: ((value: string) => any) | undefined;
+declare const __VLS_base: vue.DefineComponent<ChatProps, {
+  scrollToBottom: () => void;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+  "load-more": () => any;
+  send: (content: string) => any;
+  "select-contact": (id: string) => any;
+  "image-preview": (url: string) => any;
+  "file-click": (msg: ChatMessage) => any;
+  "file-upload": () => any;
+  "emoji-click": () => any;
+  resend: (msg: ChatMessage) => any;
+}, string, vue.PublicProps, Readonly<ChatProps> & Readonly<{
+  "onLoad-more"?: (() => any) | undefined;
+  onSend?: ((content: string) => any) | undefined;
+  "onSelect-contact"?: ((id: string) => any) | undefined;
+  "onImage-preview"?: ((url: string) => any) | undefined;
+  "onFile-click"?: ((msg: ChatMessage) => any) | undefined;
+  "onFile-upload"?: (() => any) | undefined;
+  "onEmoji-click"?: (() => any) | undefined;
+  onResend?: ((msg: ChatMessage) => any) | undefined;
 }>, {
-  placeholder: string;
-  showLetters: boolean;
+  virtualScroll: boolean;
+  showContacts: boolean;
+  showTimestamp: boolean;
+  showSendBtn: boolean;
+  loadingHistory: boolean;
+  contacts: ChatContact[];
+  messages: ChatMessage[];
+  currentContactId: string;
+  selfAvatar: string;
+  selfName: string;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
@@ -31,4 +125,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { _default as t };
+export { DEFAULT_CHAT_PROPS as a, MessageType as c, ChatProps as i, ChatContact as n, MessageSender as o, ChatMessage as r, MessageStatus as s, _default as t };

package/dist/index8.vue.d.cts

@@ -1,27 +1,121 @@
 import * as vue from "vue";
 
-//#region src/components/C_City/index.vue.d.ts
-interface Props {
-  modelValue?: string;
+//#region src/components/C_Chat/types.d.ts
+/**
+ * @Description: C_Chat 通用聊天组件 - 类型定义
+ */
+/** 消息类型 */
+type MessageType = 'text' | 'image' | 'file' | 'system';
+/** 消息发送方 */
+type MessageSender = 'self' | 'other' | 'system';
+/** 消息状态 */
+type MessageStatus = 'sending' | 'sent' | 'failed';
+/** 单条消息 */
+interface ChatMessage {
+  /** 唯一标识 */
+  id: string;
+  /** 消息内容（文本 / 图片 URL / 文件信息 JSON） */
+  content: string;
+  /** 消息类型 */
+  type: MessageType;
+  /** 发送方 */
+  sender: MessageSender;
+  /** 发送时间（ISO 字符串 或 时间戳） */
+  timestamp: string | number;
+  /** 发送者头像 URL */
+  avatar?: string;
+  /** 发送者用户名 */
+  username?: string;
+  /** 消息状态 */
+  status?: MessageStatus;
+  /** 文件名（type = 'file' 时使用） */
+  fileName?: string;
+  /** 文件大小（字节） */
+  fileSize?: number;
+}
+/** 联系人 / 会话 */
+interface ChatContact {
+  /** 唯一标识 */
+  id: string;
+  /** 显示名称 */
+  name: string;
+  /** 头像 URL */
+  avatar?: string;
+  /** 最后一条消息摘要 */
+  lastMessage?: string;
+  /** 最后消息时间 */
+  lastTime?: string | number;
+  /** 未读数 */
+  unread?: number;
+  /** 是否在线 */
+  online?: boolean;
+}
+interface ChatProps {
+  /** 联系人列表 */
+  contacts?: ChatContact[];
+  /** 消息列表 */
+  messages?: ChatMessage[];
+  /** 当前选中的联系人 ID */
+  currentContactId?: string;
+  /** 输入框占位符 */
   placeholder?: string;
-  showLetters?: boolean;
+  /** 是否显示联系人侧栏 */
+  showContacts?: boolean;
+  /** 是否显示消息时间戳 */
+  showTimestamp?: boolean;
+  /** 当前用户头像 */
+  selfAvatar?: string;
+  /** 当前用户名 */
+  selfName?: string;
+  /** 是否显示发送按钮 */
+  showSendBtn?: boolean;
+  /** 是否正在加载历史消息 */
+  loadingHistory?: boolean;
+  /** 大列表自动窗口化；false 可保留完整 DOM（消息 200 条、联系人 100 条起）。 */
+  virtualScroll?: boolean;
+  /** 标题（无联系人模式时显示） */
+  title?: string;
 }
-declare var __VLS_9: {
-  value: string | undefined;
-  visible: boolean;
-};
+declare const DEFAULT_CHAT_PROPS: Required<Pick<ChatProps, 'placeholder' | 'showContacts' | 'showTimestamp' | 'showSendBtn' | 'loadingHistory' | 'title'>>;
+//#endregion
+//#region src/components/C_Chat/index.vue.d.ts
+declare var __VLS_39: {}, __VLS_83: {};
 type __VLS_Slots = {} & {
-  trigger?: (props: typeof __VLS_9) => any;
+  header?: (props: typeof __VLS_39) => any;
+} & {
+  'input-actions'?: (props: typeof __VLS_83) => any;
 };
-declare const __VLS_base: vue.DefineComponent<Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  "update:modelValue": (value: string) => any;
-  change: (value: string) => any;
-}, string, vue.PublicProps, Readonly<Props> & Readonly<{
-  "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-  onChange?: ((value: string) => any) | undefined;
+declare const __VLS_base: vue.DefineComponent<ChatProps, {
+  scrollToBottom: () => void;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+  "load-more": () => any;
+  send: (content: string) => any;
+  "select-contact": (id: string) => any;
+  "image-preview": (url: string) => any;
+  "file-click": (msg: ChatMessage) => any;
+  "file-upload": () => any;
+  "emoji-click": () => any;
+  resend: (msg: ChatMessage) => any;
+}, string, vue.PublicProps, Readonly<ChatProps> & Readonly<{
+  "onLoad-more"?: (() => any) | undefined;
+  onSend?: ((content: string) => any) | undefined;
+  "onSelect-contact"?: ((id: string) => any) | undefined;
+  "onImage-preview"?: ((url: string) => any) | undefined;
+  "onFile-click"?: ((msg: ChatMessage) => any) | undefined;
+  "onFile-upload"?: (() => any) | undefined;
+  "onEmoji-click"?: (() => any) | undefined;
+  onResend?: ((msg: ChatMessage) => any) | undefined;
 }>, {
-  placeholder: string;
-  showLetters: boolean;
+  virtualScroll: boolean;
+  showContacts: boolean;
+  showTimestamp: boolean;
+  showSendBtn: boolean;
+  loadingHistory: boolean;
+  contacts: ChatContact[];
+  messages: ChatMessage[];
+  currentContactId: string;
+  selfAvatar: string;
+  selfName: string;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
@@ -31,4 +125,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { _default as t };
+export { DEFAULT_CHAT_PROPS as a, MessageType as c, ChatProps as i, ChatContact as n, MessageSender as o, ChatMessage as r, MessageStatus as s, _default as t };

package/dist/index8.vue.d.ts

@@ -1,45 +1,34 @@
 import * as vue from "vue";
 
-//#region src/components/C_Code/index.vue.d.ts
+//#region src/components/C_City/index.vue.d.ts
 interface Props {
-  code: string;
-  language?: string;
-  title?: string;
-  showHeader?: boolean;
-  showLineNumbers?: boolean;
-  wordWrap?: boolean;
-  trim?: boolean;
-  showFullscreen?: boolean;
-  maxHeight?: string | number;
-  autoLoadLanguage?: boolean;
+  modelValue?: string;
+  placeholder?: string;
+  showLetters?: boolean;
 }
-/** 复制发起时的内容；文本随后变化不会改变已写入剪贴板的事件快照。 */
-declare function copyCode(): Promise<void>;
-/**
- * 切换全屏显示状态
- */
-declare function toggleFullscreen(): void;
-declare const __VLS_export: vue.DefineComponent<Props, {
-  copyCode: typeof copyCode;
-  toggleFullscreen: typeof toggleFullscreen;
-}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  click: (event: MouseEvent) => any;
-  copy: (code: string) => any;
-  fullscreen: (isFullscreen: boolean) => any;
+declare var __VLS_9: {
+  value: string | undefined;
+  visible: boolean;
+};
+type __VLS_Slots = {} & {
+  trigger?: (props: typeof __VLS_9) => any;
+};
+declare const __VLS_base: vue.DefineComponent<Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+  "update:modelValue": (value: string) => any;
+  change: (value: string) => any;
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
-  onClick?: ((event: MouseEvent) => any) | undefined;
-  onCopy?: ((code: string) => any) | undefined;
-  onFullscreen?: ((isFullscreen: boolean) => any) | undefined;
+  "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+  onChange?: ((value: string) => any) | undefined;
 }>, {
-  trim: boolean;
-  code: string;
-  language: string;
-  showHeader: boolean;
-  showLineNumbers: boolean;
-  wordWrap: boolean;
-  showFullscreen: boolean;
-  autoLoadLanguage: boolean;
+  placeholder: string;
+  showLetters: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
 //#endregion
 export { _default as t };

package/dist/index9.vue.d.cts

@@ -1,45 +1,34 @@
 import * as vue from "vue";
 
-//#region src/components/C_Code/index.vue.d.ts
+//#region src/components/C_City/index.vue.d.ts
 interface Props {
-  code: string;
-  language?: string;
-  title?: string;
-  showHeader?: boolean;
-  showLineNumbers?: boolean;
-  wordWrap?: boolean;
-  trim?: boolean;
-  showFullscreen?: boolean;
-  maxHeight?: string | number;
-  autoLoadLanguage?: boolean;
+  modelValue?: string;
+  placeholder?: string;
+  showLetters?: boolean;
 }
-/** 复制发起时的内容；文本随后变化不会改变已写入剪贴板的事件快照。 */
-declare function copyCode(): Promise<void>;
-/**
- * 切换全屏显示状态
- */
-declare function toggleFullscreen(): void;
-declare const __VLS_export: vue.DefineComponent<Props, {
-  copyCode: typeof copyCode;
-  toggleFullscreen: typeof toggleFullscreen;
-}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  click: (event: MouseEvent) => any;
-  copy: (code: string) => any;
-  fullscreen: (isFullscreen: boolean) => any;
+declare var __VLS_9: {
+  value: string | undefined;
+  visible: boolean;
+};
+type __VLS_Slots = {} & {
+  trigger?: (props: typeof __VLS_9) => any;
+};
+declare const __VLS_base: vue.DefineComponent<Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+  "update:modelValue": (value: string) => any;
+  change: (value: string) => any;
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
-  onClick?: ((event: MouseEvent) => any) | undefined;
-  onCopy?: ((code: string) => any) | undefined;
-  onFullscreen?: ((isFullscreen: boolean) => any) | undefined;
+  "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+  onChange?: ((value: string) => any) | undefined;
 }>, {
-  trim: boolean;
-  code: string;
-  language: string;
-  showHeader: boolean;
-  showLineNumbers: boolean;
-  wordWrap: boolean;
-  showFullscreen: boolean;
-  autoLoadLanguage: boolean;
+  placeholder: string;
+  showLetters: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
 //#endregion
 export { _default as t };

package/dist/index9.vue.d.ts

@@ -1,88 +1,45 @@
 import * as vue from "vue";
 
-//#region src/components/C_ContextMenu/types.d.ts
+//#region src/components/C_Code/index.vue.d.ts
+interface Props {
+  code: string;
+  language?: string;
+  title?: string;
+  showHeader?: boolean;
+  showLineNumbers?: boolean;
+  wordWrap?: boolean;
+  trim?: boolean;
+  showFullscreen?: boolean;
+  maxHeight?: string | number;
+  autoLoadLanguage?: boolean;
+}
+/** 复制发起时的内容；文本随后变化不会改变已写入剪贴板的事件快照。 */
+declare function copyCode(): Promise<void>;
 /**
- * @Description: 右键菜单组件类型定义
- * Copyright (c) 2026 by CHENY, All Rights Reserved 😎.
+ * 切换全屏显示状态
  */
-/** 菜单项 */
-interface ContextMenuItem {
-  /** 唯一标识 */
-  key: string;
-  /** 菜单文字 */
-  label: string;
-  /** 图标（Iconify 图标名） */
-  icon?: string;
-  /** 快捷键标注文字（仅展示，不绑定） */
-  shortcut?: string;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 是否隐藏 */
-  hidden?: boolean;
-  /** 分割线（此项渲染为分割线，label 被忽略） */
-  divider?: boolean;
-  /** 子菜单（支持无限嵌套） */
-  children?: ContextMenuItem[];
-  /** 自定义样式类 */
-  className?: string;
-  /** 危险操作（红色高亮） */
-  danger?: boolean;
-}
-/** 组件 Props */
-interface ContextMenuProps {
-  /** 菜单项列表 */
-  items: ContextMenuItem[];
-  /** 菜单最小宽度 */
-  minWidth?: number;
-  /** 菜单最大宽度 */
-  maxWidth?: number;
-  /** 子菜单展开方向 */
-  subMenuPlacement?: 'right' | 'left';
-  /** 点击菜单项后是否自动关闭 */
-  autoClose?: boolean;
-  /** 是否禁用整个菜单 */
-  disabled?: boolean;
-  /** 自定义 z-index */
-  zIndex?: number;
-}
-/** 默认 Props */
-declare const DEFAULT_CONTEXT_MENU_PROPS: {
-  minWidth: number;
-  maxWidth: number;
-  subMenuPlacement: "right";
-  autoClose: boolean;
-  disabled: boolean;
-  zIndex: number;
-};
-//#endregion
-//#region src/components/C_ContextMenu/index.vue.d.ts
-declare const __VLS_export: vue.DefineComponent<ContextMenuProps, {
-  /** 在指定坐标打开菜单 */open: (x: number, y: number) => void; /** 关闭菜单 */
-  close: () => void; /** 当前是否可见 */
-  visible: vue.ComputedRef<boolean>;
-}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  close: () => any;
-  select: (item: ContextMenuItem) => any;
-  open: (position: {
-    x: number;
-    y: number;
-  }) => any;
-}, string, vue.PublicProps, Readonly<ContextMenuProps> & Readonly<{
-  onClose?: (() => any) | undefined;
-  onSelect?: ((item: ContextMenuItem) => any) | undefined;
-  onOpen?: ((position: {
-    x: number;
-    y: number;
-  }) => any) | undefined;
+declare function toggleFullscreen(): void;
+declare const __VLS_export: vue.DefineComponent<Props, {
+  copyCode: typeof copyCode;
+  toggleFullscreen: typeof toggleFullscreen;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  fullscreen: (isFullscreen: boolean) => any;
+  click: (event: MouseEvent) => any;
+  copy: (code: string) => any;
+}, string, vue.PublicProps, Readonly<Props> & Readonly<{
+  onFullscreen?: ((isFullscreen: boolean) => any) | undefined;
+  onClick?: ((event: MouseEvent) => any) | undefined;
+  onCopy?: ((code: string) => any) | undefined;
 }>, {
-  disabled: boolean;
-  items: ContextMenuItem[];
-  zIndex: number;
-  minWidth: number;
-  maxWidth: number;
-  subMenuPlacement: "right" | "left";
-  autoClose: boolean;
+  trim: boolean;
+  showHeader: boolean;
+  language: string;
+  code: string;
+  showLineNumbers: boolean;
+  wordWrap: boolean;
+  showFullscreen: boolean;
+  autoLoadLanguage: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
-export { DEFAULT_CONTEXT_MENU_PROPS as i, ContextMenuItem as n, ContextMenuProps as r, _default as t };
+export { _default as t };

package/dist/numberCodec.cjs

@@ -0,0 +1 @@
+const e=/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/;function t(e){if(!Number.isFinite(e))throw TypeError(`数值必须有限`);let t=String(e);if(!t.includes(`e`))return t;let[n,r]=t.split(`e`),i=n.startsWith(`-`),[a,o=``]=n.replace(/^-/,``).split(`.`),s=a+o,c=a.length+Number(r),l=c<=0?`0.${`0`.repeat(-c)}${s}`:c>=s.length?s+`0`.repeat(c-s.length):`${s.slice(0,c)}.${s.slice(c)}`;return i?`-${l}`:l}function n(e){let t=e.startsWith(`-`),[n=``,r=``]=e.replace(/^[+-]/,``).split(`.`),i=n.replace(/^0+(?=\d)/,``)||`0`,a=r.replace(/0+$/,``),o=i+(a?`.${a}`:``);return t&&o!==`0`?`-${o}`:o}function r(r){if(r==null)return null;if(typeof r!=`number`&&typeof r!=`string`)throw TypeError(`数值必须是十进制文本或有限数字`);let i=typeof r==`number`?t(r):r.trim();if(i===``)return null;if(i.length>1e3||!e.test(i))throw TypeError(`请输入长度不超过 1000 位的普通十进制数`);return n(i)}function i(e,t){let n=e.startsWith(`-`),[r,i=``]=e.replace(/^-/,``).split(`.`),a=i.slice(0,t).padEnd(t,`0`),o=BigInt(r+a);i.length>t&&i[t]>=`5`&&(o+=1n);let s=o.toString().padStart(t+1,`0`),c=t?`${s.slice(0,-t)}.${s.slice(-t)}`:s;return n&&o!==0n?`-${c}`:c}function a(e={}){let t={...e},n=t.fractionDigits;if(n!==void 0&&(!Number.isInteger(n)||n<0||n>100))throw RangeError(`fractionDigits 必须是 0 到 100 的整数`);if(t.storage!==void 0&&![`number`,`decimal-string`].includes(t.storage))throw TypeError(`未知的数值存储类型`);return{parse(e){if(typeof e==`number`&&Number.isInteger(e)&&!Number.isSafeInteger(e))throw RangeError(`精确数值必须传原始文本，不能从不安全的 number 恢复精度`);let n=r(e);if(n===null||t.storage===`decimal-string`)return n;let i=Number(n);if(!Number.isFinite(i)||Number.isInteger(i)&&!Number.isSafeInteger(i)||r(i)!==n)throw RangeError(`数值不能安全转换为 number，请使用 decimal-string`);return i},format(e){let a=r(e);if(a===null)return t.emptyText??`—`;let o=n===void 0?a:i(a,n);if(t.useGrouping){let[e,t]=o.split(`.`);o=e.replace(/\B(?=(\d{3})+(?!\d))/g,`,`)+(t===void 0?``:`.${t}`)}return`${t.prefix??``}${o}${t.suffix??``}`}}}Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return a}});

package/dist/numberCodec.d.cts

@@ -0,0 +1,25 @@
+//#region src/core/numberCodec.d.ts
+/** 数值的编辑/显示边界；不承担业务校验、单位换算或税费计算。 */
+interface ValueCodec<T> {
+  parse(input: unknown): T;
+  format(value: T): string;
+}
+interface NumberCodecOptions {
+  /** 精确小数保留十进制字符串；number 模式拒绝不能往返的数值。 */
+  storage?: 'number' | 'decimal-string';
+  /** 仅控制显示的 HALF_UP 舍入，不修改存储值；0 是有效精度。 */
+  fractionDigits?: number;
+  useGrouping?: boolean;
+  emptyText?: string;
+  prefix?: string;
+  suffix?: string;
+}
+declare function createNumberCodec(options: NumberCodecOptions & {
+  storage: 'decimal-string';
+}): ValueCodec<string | null>;
+declare function createNumberCodec(options?: NumberCodecOptions & {
+  storage?: 'number';
+}): ValueCodec<number | null>;
+declare function createNumberCodec(options: NumberCodecOptions): ValueCodec<number | string | null>;
+//#endregion
+export { ValueCodec as n, createNumberCodec as r, NumberCodecOptions as t };

package/dist/numberCodec.d.ts

@@ -0,0 +1,25 @@
+//#region src/core/numberCodec.d.ts
+/** 数值的编辑/显示边界；不承担业务校验、单位换算或税费计算。 */
+interface ValueCodec<T> {
+  parse(input: unknown): T;
+  format(value: T): string;
+}
+interface NumberCodecOptions {
+  /** 精确小数保留十进制字符串；number 模式拒绝不能往返的数值。 */
+  storage?: 'number' | 'decimal-string';
+  /** 仅控制显示的 HALF_UP 舍入，不修改存储值；0 是有效精度。 */
+  fractionDigits?: number;
+  useGrouping?: boolean;
+  emptyText?: string;
+  prefix?: string;
+  suffix?: string;
+}
+declare function createNumberCodec(options: NumberCodecOptions & {
+  storage: 'decimal-string';
+}): ValueCodec<string | null>;
+declare function createNumberCodec(options?: NumberCodecOptions & {
+  storage?: 'number';
+}): ValueCodec<number | null>;
+declare function createNumberCodec(options: NumberCodecOptions): ValueCodec<number | string | null>;
+//#endregion
+export { ValueCodec as n, createNumberCodec as r, NumberCodecOptions as t };

package/dist/numberCodec.js

@@ -0,0 +1 @@
+const e=/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/;function t(e){if(!Number.isFinite(e))throw TypeError(`数值必须有限`);let t=String(e);if(!t.includes(`e`))return t;let[n,r]=t.split(`e`),i=n.startsWith(`-`),[a,o=``]=n.replace(/^-/,``).split(`.`),s=a+o,c=a.length+Number(r),l=c<=0?`0.${`0`.repeat(-c)}${s}`:c>=s.length?s+`0`.repeat(c-s.length):`${s.slice(0,c)}.${s.slice(c)}`;return i?`-${l}`:l}function n(e){let t=e.startsWith(`-`),[n=``,r=``]=e.replace(/^[+-]/,``).split(`.`),i=n.replace(/^0+(?=\d)/,``)||`0`,a=r.replace(/0+$/,``),o=i+(a?`.${a}`:``);return t&&o!==`0`?`-${o}`:o}function r(r){if(r==null)return null;if(typeof r!=`number`&&typeof r!=`string`)throw TypeError(`数值必须是十进制文本或有限数字`);let i=typeof r==`number`?t(r):r.trim();if(i===``)return null;if(i.length>1e3||!e.test(i))throw TypeError(`请输入长度不超过 1000 位的普通十进制数`);return n(i)}function i(e,t){let n=e.startsWith(`-`),[r,i=``]=e.replace(/^-/,``).split(`.`),a=i.slice(0,t).padEnd(t,`0`),o=BigInt(r+a);i.length>t&&i[t]>=`5`&&(o+=1n);let s=o.toString().padStart(t+1,`0`),c=t?`${s.slice(0,-t)}.${s.slice(-t)}`:s;return n&&o!==0n?`-${c}`:c}function a(e={}){let t={...e},n=t.fractionDigits;if(n!==void 0&&(!Number.isInteger(n)||n<0||n>100))throw RangeError(`fractionDigits 必须是 0 到 100 的整数`);if(t.storage!==void 0&&![`number`,`decimal-string`].includes(t.storage))throw TypeError(`未知的数值存储类型`);return{parse(e){if(typeof e==`number`&&Number.isInteger(e)&&!Number.isSafeInteger(e))throw RangeError(`精确数值必须传原始文本，不能从不安全的 number 恢复精度`);let n=r(e);if(n===null||t.storage===`decimal-string`)return n;let i=Number(n);if(!Number.isFinite(i)||Number.isInteger(i)&&!Number.isSafeInteger(i)||r(i)!==n)throw RangeError(`数值不能安全转换为 number，请使用 decimal-string`);return i},format(e){let a=r(e);if(a===null)return t.emptyText??`—`;let o=n===void 0?a:i(a,n);if(t.useGrouping){let[e,t]=o.split(`.`);o=e.replace(/\B(?=(\d{3})+(?!\d))/g,`,`)+(t===void 0?``:`.${t}`)}return`${t.prefix??``}${o}${t.suffix??``}`}}}export{a as t};

package/dist/observer.cjs

@@ -0,0 +1 @@
+function e(e){try{Promise.resolve(e()).catch(()=>void 0)}catch{}}Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return e}});

package/dist/observer.js

@@ -0,0 +1 @@
+function e(e){try{Promise.resolve(e()).catch(()=>void 0)}catch{}}export{e as t};