one-design-next 0.0.90 → 0.0.92

package/dist/_util/layoutBatch.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 读阶段：只允许读取布局（getBoundingClientRect / getComputedStyle 等）。
+ * 返回写阶段回调，或返回 undefined 表示无需写入。
+ */
+type LayoutRead = () => (() => void) | void;
+/**
+ * 把「读布局 - 改 DOM」拆成两阶段，同一帧内的所有调用先全部读、再全部写。
+ *
+ * 长列表里每个实例各自「读 - 写 - 读 - 写」时，每次写都会让布局失效，
+ * 下一个读又触发一次完整排版（layout thrashing）。500 项时这是一帧
+ * 500 次排版与一次排版的差别。
+ */
+export declare function scheduleLayoutBatch(read: LayoutRead): void;
+export {};

package/dist/_util/layoutBatch.js

@@ -0,0 +1,47 @@
+/**
+ * 读阶段：只允许读取布局（getBoundingClientRect / getComputedStyle 等）。
+ * 返回写阶段回调，或返回 undefined 表示无需写入。
+ */
+
+var pending = [];
+var rafId = 0;
+function flush() {
+  rafId = 0;
+  var batch = pending;
+  pending = [];
+
+  // 阶段一：集中读。期间无任何写入，浏览器只需排版一次。
+  var writes = [];
+  for (var i = 0; i < batch.length; i++) {
+    try {
+      var write = batch[i]();
+      if (write) writes.push(write);
+    } catch (error) {
+      // eslint-disable-next-line no-console
+      console.error('[odn] layout batch read error:', error);
+    }
+  }
+
+  // 阶段二：集中写。布局失效只发生在全部读取之后。
+  for (var _i = 0; _i < writes.length; _i++) {
+    try {
+      writes[_i]();
+    } catch (error) {
+      // eslint-disable-next-line no-console
+      console.error('[odn] layout batch write error:', error);
+    }
+  }
+}
+
+/**
+ * 把「读布局 - 改 DOM」拆成两阶段，同一帧内的所有调用先全部读、再全部写。
+ *
+ * 长列表里每个实例各自「读 - 写 - 读 - 写」时，每次写都会让布局失效，
+ * 下一个读又触发一次完整排版（layout thrashing）。500 项时这是一帧
+ * 500 次排版与一次排版的差别。
+ */
+export function scheduleLayoutBatch(read) {
+  pending.push(read);
+  if (rafId) return;
+  rafId = requestAnimationFrame(flush);
+}

package/dist/_util/sharedResizeObserver.d.ts

@@ -0,0 +1,11 @@
+type SharedResizeCallback = (entry: ResizeObserverEntry) => void;
+/**
+ * 共享 ResizeObserver：模块级单例观察者 + WeakMap 注册表。
+ * 大量组件实例共用同一个观察者，避免每个实例各 new 一个，
+ * 也避免浏览器每帧遍历成倍增长的观察目标。
+ *
+ * 返回取消观察的清理函数，应在 effect cleanup 中调用。
+ * 非浏览器环境 / 无 ResizeObserver 时安全降级为空操作。
+ */
+export declare function observeResize(target: Element, callback: SharedResizeCallback): () => void;
+export {};

package/dist/_util/sharedResizeObserver.js

@@ -0,0 +1,65 @@
+import canUseDom from "./canUseDom";
+var sharedRO = null;
+/**
+ * 同一元素可能被多方观察（如行容器既被标题拟合监听、又被背景同步监听）。
+ * 值用 Set 而非单个回调，避免后注册者覆盖先注册者、
+ * 以及任一方取消观察时把另一方也一并停掉。
+ */
+var registry = new WeakMap();
+function ensureSharedRO() {
+  if (sharedRO) return;
+  sharedRO = new ResizeObserver(function (entries) {
+    var _loop = function _loop() {
+      var entry = entries[i];
+      var callbacks = registry.get(entry.target);
+      if (!callbacks) return 1; // continue
+      callbacks.forEach(function (cb) {
+        // 单个回调异常不应中断同批其他实例的派发（共享观察者的隔离保证）
+        try {
+          cb(entry);
+        } catch (error) {
+          // eslint-disable-next-line no-console
+          console.error('[odn] shared ResizeObserver callback error:', error);
+        }
+      });
+    };
+    for (var i = 0; i < entries.length; i++) {
+      if (_loop()) continue;
+    }
+  });
+}
+
+/**
+ * 共享 ResizeObserver：模块级单例观察者 + WeakMap 注册表。
+ * 大量组件实例共用同一个观察者，避免每个实例各 new 一个，
+ * 也避免浏览器每帧遍历成倍增长的观察目标。
+ *
+ * 返回取消观察的清理函数，应在 effect cleanup 中调用。
+ * 非浏览器环境 / 无 ResizeObserver 时安全降级为空操作。
+ */
+export function observeResize(target, callback) {
+  if (!canUseDom() || typeof ResizeObserver === 'undefined') {
+    return function () {};
+  }
+  ensureSharedRO();
+  var callbacks = registry.get(target);
+  if (!callbacks) {
+    callbacks = new Set();
+    registry.set(target, callbacks);
+    sharedRO.observe(target);
+  }
+  callbacks.add(callback);
+  var stopped = false;
+  return function () {
+    if (stopped) return;
+    stopped = true;
+    var current = registry.get(target);
+    if (!current) return;
+    current.delete(callback);
+    // 最后一个观察方撤销时才真正停止观察
+    if (current.size === 0) {
+      registry.delete(target);
+      sharedRO.unobserve(target);
+    }
+  };
+}

package/dist/_util/textFit.d.ts

@@ -0,0 +1,48 @@
+export interface FitMetrics {
+    /** 按字形簇切分的文本段 */
+    segments: string[];
+    /**
+     * prefixWidths[i] = segments[0..i] 拼接后再加省略号的宽度，严格单调递增。
+     * 完整文本宽度不放进来（省略号可能比末位字形宽，混入会破坏单调性）。
+     */
+    prefixWidths: number[];
+    /** 完整文本宽度，不含省略号 */
+    fullWidth: number;
+}
+export interface FontSpec {
+    /** canvas font 简写，取自 resolveFont */
+    font: string;
+    /** CSS letter-spacing 的像素值；canvas measureText 不计字间距，需手工补偿 */
+    letterSpacing: number;
+}
+/**
+ * 按字形簇切分。emoji、肤色修饰符、ZWJ 序列、带组合符的字母都算一个整体，
+ * 截断落在其中任一位置都会产生乱码，所以不能按 UTF-16 码元切。
+ * 无 Intl.Segmenter 时退化到码点切分，至少保证代理对不裂。
+ */
+export declare function splitGraphemes(text: string): string[];
+/**
+ * getComputedStyle().font 在部分浏览器下返回空串（如 font-family 走 CSS 变量），
+ * 此时把空串赋给 canvas 会静默 fallback 到 10px sans-serif，测量整体失真。
+ */
+export declare function resolveFont(cs: CSSStyleDeclaration): string;
+/**
+ * 预计算所有截断位置的宽度。用 canvas measureText，不触发 DOM 排版，
+ * 因此单次挂载即可算完，后续宽度变化只需在结果上二分。
+ */
+export declare function measureFit(text: string, ellipsis: string, spec: FontSpec): FitMetrics;
+export interface FitResult {
+    text: string;
+    /**
+     * 结果是否确实在 available 内。为 false 表示窄到连「一个字形 + 省略号」
+     * 都放不下，只能原样返回；调用方此时必须让 CSS text-overflow 接管截断，
+     * 否则文本会溢出容器。
+     */
+    accurate: boolean;
+}
+/**
+ * 按可用宽度选出应显示的文本。
+ * 极窄时返回原文而非单独的省略号：宽度本身可能是布局未就绪的假值，
+ * 裁成「…」后若行宽不再变化就永远恢复不了，交给 CSS text-overflow 兜底更稳。
+ */
+export declare function fitToWidth(metrics: FitMetrics, available: number, text: string, ellipsis: string): FitResult;

package/dist/_util/textFit.js

@@ -0,0 +1,123 @@
+import canUseDom from "./canUseDom";
+var sharedCanvas = null;
+function getCtx() {
+  if (!canUseDom()) return null;
+  if (!sharedCanvas) sharedCanvas = document.createElement('canvas');
+  return sharedCanvas.getContext('2d');
+}
+
+/**
+ * 本地 TS lib 目标尚未包含 Intl.Segmenter 的声明，这里按用到的最小面手写。
+ * 运行时通过 'Segmenter' in Intl 判定可用性，不可用时降级到码点切分。
+ */
+
+var segmenter = function () {
+  if (typeof Intl === 'undefined' || !('Segmenter' in Intl)) return null;
+  var Ctor = Intl.Segmenter;
+  return new Ctor(undefined, {
+    granularity: 'grapheme'
+  });
+}();
+
+/**
+ * 按字形簇切分。emoji、肤色修饰符、ZWJ 序列、带组合符的字母都算一个整体，
+ * 截断落在其中任一位置都会产生乱码，所以不能按 UTF-16 码元切。
+ * 无 Intl.Segmenter 时退化到码点切分，至少保证代理对不裂。
+ */
+export function splitGraphemes(text) {
+  if (!text) return [];
+  if (segmenter) {
+    return Array.from(segmenter.segment(text), function (s) {
+      return s.segment;
+    });
+  }
+  return Array.from(text);
+}
+
+/**
+ * getComputedStyle().font 在部分浏览器下返回空串（如 font-family 走 CSS 变量），
+ * 此时把空串赋给 canvas 会静默 fallback 到 10px sans-serif，测量整体失真。
+ */
+export function resolveFont(cs) {
+  if (cs.font) return cs.font;
+  return "".concat(cs.fontStyle, " ").concat(cs.fontWeight, " ").concat(cs.fontSize, " / ").concat(cs.lineHeight, " ").concat(cs.fontFamily);
+}
+
+/**
+ * 预计算所有截断位置的宽度。用 canvas measureText，不触发 DOM 排版，
+ * 因此单次挂载即可算完，后续宽度变化只需在结果上二分。
+ */
+export function measureFit(text, ellipsis, spec) {
+  var segments = splitGraphemes(text);
+  if (!segments.length) {
+    return {
+      segments: segments,
+      prefixWidths: [],
+      fullWidth: 0
+    };
+  }
+  var ctx = getCtx();
+  if (!ctx) {
+    // 拿不到 canvas 时给出「永远放不下」的度量，调用方据此保留原文
+    return {
+      segments: segments,
+      prefixWidths: [],
+      fullWidth: Number.POSITIVE_INFINITY
+    };
+  }
+  ctx.font = spec.font;
+  var letterSpacing = spec.letterSpacing;
+  var ellipsisWidth = ctx.measureText(ellipsis).width + letterSpacing * splitGraphemes(ellipsis).length;
+  var prefixWidths = [];
+  var prefix = '';
+  for (var i = 0; i < segments.length - 1; i++) {
+    prefix += segments[i];
+    prefixWidths.push(ctx.measureText(prefix).width + letterSpacing * (i + 1) + ellipsisWidth);
+  }
+  return {
+    segments: segments,
+    prefixWidths: prefixWidths,
+    fullWidth: ctx.measureText(text).width + letterSpacing * segments.length
+  };
+}
+
+/** 最后一个 <= available 的下标，-1 表示一个字形加省略号都放不下 */
+function bisect(widths, available) {
+  var lo = 0;
+  var hi = widths.length - 1;
+  var best = -1;
+  while (lo <= hi) {
+    var mid = lo + hi >> 1;
+    if (widths[mid] <= available) {
+      best = mid;
+      lo = mid + 1;
+    } else {
+      hi = mid - 1;
+    }
+  }
+  return best;
+}
+/**
+ * 按可用宽度选出应显示的文本。
+ * 极窄时返回原文而非单独的省略号：宽度本身可能是布局未就绪的假值，
+ * 裁成「…」后若行宽不再变化就永远恢复不了，交给 CSS text-overflow 兜底更稳。
+ */
+export function fitToWidth(metrics, available, text, ellipsis) {
+  if (!metrics.segments.length) return {
+    text: text,
+    accurate: true
+  };
+  if (metrics.fullWidth <= available) return {
+    text: text,
+    accurate: true
+  };
+  var best = bisect(metrics.prefixWidths, available);
+  if (best < 0) return {
+    text: text,
+    accurate: false
+  };
+  return {
+    text: metrics.segments.slice(0, best + 1).join('') + ellipsis,
+    accurate: true
+  };
+}

package/dist/chat-item/index.d.ts

@@ -38,9 +38,13 @@ export interface ChatItemProps {
     defaultDeleteOpen?: boolean;
     onDeleteOpenChange?: (open: boolean) => void;
 }
-export declare function ChatItem({ id, title, active, type, status, pinned, time, onClick, onRename, onPin, onDelete, actionMenuZIndex, renaming: renamingProp, defaultRenaming, onRenamingChange, menuOpen: menuOpenProp, defaultMenuOpen, onMenuOpenChange, deleteOpen: deleteOpenProp, defaultDeleteOpen, onDeleteOpenChange, }: ChatItemProps): import("react").JSX.Element;
-export declare namespace ChatItem {
-    var displayName: string;
-}
+declare function ChatItemInner({ id, title, active, type, status, pinned, time, onClick, onRename, onPin, onDelete, actionMenuZIndex, renaming: renamingProp, defaultRenaming, onRenamingChange, menuOpen: menuOpenProp, defaultMenuOpen, onMenuOpenChange, deleteOpen: deleteOpenProp, defaultDeleteOpen, onDeleteOpenChange, }: ChatItemProps): import("react").JSX.Element;
+/**
+ * 会话列表项。
+ *
+ * memo：列表里单项 hover / 选中会触发父级重渲染，未 memo 时其余项会一并
+ * 重跑 render 与相对时间计算。父级需传入稳定的回调引用才能生效。
+ */
+export declare const ChatItem: import("react").MemoExoticComponent<typeof ChatItemInner>;
 export default ChatItem;
 export { formatRelativeTime } from './relative-time';