@lark-apaas/coding-template-nestjs-react-fullstack 0.1.56 → 0.1.57-alpha.20261103143319

package/template/client/src/components/business-ui/record-comments/internal/mutations.ts

@@ -0,0 +1,170 @@
+import type { MentionRef } from '../types';
+import type { DiscussionDraft, DiscussionImage, DiscussionReply, DiscussionThread } from './view-types';
+import type { CommentIDs, DeleteCommentResult, CommentMutationFailure } from '../comment-panel.contract';
+import { commentFailureMessage, normalizeValue, readApiContent } from './model';
+
+export interface LocalCommentMutation {
+  id: string;
+  kind: 'add' | 'edit' | 'delete';
+  phase: 'sending' | 'failed' | 'uncertain' | 'confirmed';
+  message?: string;
+}
+interface Operation extends LocalCommentMutation {
+  thread: DiscussionThread;
+  commentID: string;
+  replyID: string;
+  draft?: DiscussionDraft;
+  author?: MentionRef;
+  createTime: number;
+  wholeThread?: boolean;
+  execute: () => Promise<CommentIDs | DeleteCommentResult>;
+}
+const contentKey = (reply: Pick<DiscussionReply, 'value'>) => JSON.stringify(readApiContent(reply.value));
+const imageKey = (images: readonly DiscussionImage[]) => JSON.stringify(images.map(({ id, url }) => [id, url]));
+const uncertain = (message: string) => Object.assign(new Error(message), { outcome: 'unknown' as const });
+
+/** Component-local overlay. Never writes the host's data or performs a request itself. */
+export class CommentMutations {
+  private operations: Operation[] = [];
+  private listeners = new Set<() => void>();
+  private version = 0;
+  private active = true;
+  subscribe = (listener: () => void) => { this.listeners.add(listener); return () => { this.listeners.delete(listener); }; };
+  getVersion = () => this.version;
+  private changed() { if (this.active) { this.version++; this.listeners.forEach((listener) => listener()); } }
+  activate() { this.active = true; }
+  private release(operation: Operation) {
+    for (const image of operation.draft?.images ?? [])
+      if (image.file && image.url.startsWith('blob:')) URL.revokeObjectURL(image.url);
+  }
+  dispose() {
+    this.active = false;
+    this.operations.forEach((operation) => this.release(operation));
+    this.operations = [];
+  }
+  replyID(id: string) { return this.operations.find((operation) => operation.id === id)?.replyID ?? id; }
+  private assertAvailable(commentID: string, replyID?: string) {
+    if (!this.active) throw new Error('评论会话已关闭');
+    if (this.operations.some((operation) => operation.commentID === commentID &&
+      (operation.wholeThread || (operation.kind === 'add' && !operation.draft?.commentID) || operation.replyID === replyID)))
+      throw new Error('该评论仍在处理中，请先完成同步或处理失败提示');
+  }
+  private start(operation: Operation) {
+    this.operations.push(operation); this.changed();
+    void this.run(operation);
+    return operation.id;
+  }
+  add(thread: DiscussionThread | undefined, draft: DiscussionDraft, author: MentionRef | undefined, execute: () => Promise<CommentIDs>) {
+    if (thread) this.assertAvailable(thread.commentID);
+    else if (!this.active) throw new Error('评论会话已关闭');
+    const id = `local:${crypto.randomUUID()}`;
+    const createTime = Math.floor(Date.now() / 1000);
+    const commentID = thread?.commentID ?? `local:thread:${crypto.randomUUID()}`;
+    return this.start({ id, kind: 'add', phase: 'sending', commentID, replyID: id,
+      thread: thread ?? { commentID, creator: author ?? null, createTime, isSolved: false, replies: [] },
+      draft: { ...draft, commentID: thread?.commentID, value: normalizeValue(draft.value), images: [...draft.images] }, author, createTime, execute });
+  }
+  edit(thread: DiscussionThread, replyID: string, draft: DiscussionDraft, execute: () => Promise<CommentIDs>) {
+    this.assertAvailable(thread.commentID, replyID);
+    return this.start({ id: `local:${crypto.randomUUID()}`, kind: 'edit', phase: 'sending',
+      thread, commentID: thread.commentID, replyID, createTime: Math.floor(Date.now() / 1000),
+      draft: { ...draft, value: normalizeValue(draft.value), images: [...draft.images] }, execute });
+  }
+  delete(thread: DiscussionThread, replyID: string, execute: () => Promise<DeleteCommentResult>) {
+    // The UI always deletes one selected message, including the current body.
+    const wholeThread = false;
+    this.assertAvailable(thread.commentID, replyID);
+    return this.start({ id: `local:${crypto.randomUUID()}`, kind: 'delete', phase: 'sending',
+      thread, commentID: thread.commentID, replyID, wholeThread, createTime: Math.floor(Date.now() / 1000), execute });
+  }
+  private async run(operation: Operation) {
+    operation.phase = 'sending'; operation.message = undefined; this.changed();
+    try {
+      const result = await operation.execute();
+      if (!this.active) return;
+      if (!/^\d+$/.test(result.commentID)) throw uncertain('提交结果缺少有效评论 ID');
+      if (operation.kind !== 'add' || operation.draft?.commentID !== undefined) {
+        if (result.commentID !== operation.commentID) throw uncertain('提交结果与目标讨论不一致');
+      }
+      if (operation.kind === 'delete') {
+        if (!('commentDeleted' in result) || typeof result.commentDeleted !== 'boolean') throw uncertain('删除结果未确认');
+        operation.wholeThread = result.commentDeleted;
+      } else {
+        if (!('replyID' in result) || !/^\d+$/.test(result.replyID)) throw uncertain('提交结果缺少有效回复 ID');
+        if (operation.kind === 'edit' && result.replyID !== operation.replyID) throw uncertain('编辑结果与目标回复不一致');
+        operation.replyID = result.replyID;
+      }
+      operation.commentID = result.commentID;
+      operation.phase = 'confirmed';
+    } catch (cause) {
+      if (!this.active) return;
+      operation.phase = (cause as CommentMutationFailure | null)?.outcome === 'unknown' ? 'uncertain' : 'failed';
+      operation.message = commentFailureMessage(cause, '操作失败，请重试');
+    }
+    this.changed();
+  }
+  retry(id: string) {
+    const operation = this.operations.find((item) => item.id === id);
+    if (!operation || operation.phase !== 'failed' || !this.active) return;
+    void this.run(operation);
+  }
+  dismiss(id: string) {
+    const operation = this.operations.find((item) => item.id === id);
+    if (!operation || !['failed', 'uncertain'].includes(operation.phase)) return;
+    this.operations = this.operations.filter((item) => item !== operation);
+    this.release(operation); this.changed();
+  }
+  private acknowledged(operation: Operation, base: readonly DiscussionThread[]) {
+    const thread = base.find((item) => item.commentID === operation.commentID);
+    const reply = thread?.replies.find((item) => item.replyID === operation.replyID);
+    if (operation.kind === 'delete') return operation.wholeThread ? !thread : !reply;
+    if (!reply) return false;
+    if (operation.kind === 'add') return true;
+    const before = operation.thread.replies.find((item) => item.replyID === operation.replyID)!;
+    // A later authoritative edit wins even when another editor changed the text.
+    // Compare server revisions, never the optimistic client wall clock.
+    if (operation.phase === 'confirmed' && reply.updateTime !== undefined &&
+      reply.updateTime > (before.updateTime ?? before.createTime)) return true;
+    if (contentKey(reply) !== contentKey({ value: operation.draft!.value })) return false;
+    const images = operation.draft!.images;
+    if (imageKey(images) === imageKey(before.images)) return true;
+    return images.some((image) => image.file)
+      ? reply.images.length === images.length && imageKey(reply.images) !== imageKey(before.images)
+      : imageKey(reply.images) === imageKey(images);
+  }
+  reconcile(base: readonly DiscussionThread[]) {
+    const finished = this.operations.filter((operation) => (operation.phase === 'confirmed' ||
+      (operation.phase === 'uncertain' && operation.kind !== 'add')) && this.acknowledged(operation, base));
+    if (!finished.length) return;
+    this.operations = this.operations.filter((operation) => !finished.includes(operation));
+    finished.forEach((operation) => this.release(operation)); this.changed();
+  }
+  view(base: readonly DiscussionThread[]): DiscussionThread[] {
+    let threads = base.map((thread) => ({ ...thread, replies: [...thread.replies] }));
+    for (const operation of this.operations) {
+      let thread = threads.find((item) => item.commentID === operation.commentID);
+      if (operation.kind === 'delete' && operation.phase === 'confirmed') {
+        if (operation.wholeThread) threads = threads.filter((item) => item !== thread);
+        else if (thread) thread.replies = thread.replies.filter((reply) => reply.replyID !== operation.replyID);
+        continue;
+      }
+      if (!thread) {
+        thread = { ...operation.thread, commentID: operation.commentID, replies: [...operation.thread.replies] };
+        threads.push(thread);
+      }
+      const index = thread.replies.findIndex((item) => item.replyID === operation.replyID);
+      const before = thread.replies[index] ?? operation.thread.replies.find((item) => item.replyID === operation.replyID);
+      const mutation: LocalCommentMutation = { id: operation.id, kind: operation.kind, phase: operation.phase, message: operation.message };
+      const reply: DiscussionReply = operation.kind === 'add'
+        ? { replyID: operation.replyID, author: operation.author ?? null, createTime: operation.createTime,
+          value: operation.draft!.value, images: operation.draft!.images, reactions: [], mutation }
+        : { ...before!, ...(operation.draft ? { value: operation.draft.value, images: operation.draft.images,
+          edited: before?.edited || operation.phase === 'confirmed',
+          updateTime: operation.phase === 'confirmed' ? operation.createTime : before?.updateTime } : {}), mutation };
+      if (index < 0) thread.replies.push(reply); else thread.replies[index] = reply;
+      if ((operation.kind === 'delete' && operation.wholeThread) || (operation.kind === 'add' && !operation.draft?.commentID))
+        thread.replies = thread.replies.map((item) => ({ ...item, mutationBlocked: true }));
+    }
+    return threads.filter((thread) => thread.replies.length > 0);
+  }
+}

package/template/client/src/components/business-ui/record-comments/internal/reaction-catalog.ts

@@ -0,0 +1,196 @@
+
+
+/** UD biz-react 6.11.4 Emoji: original zh-CN labels, order and sprite coordinates. */
+export const REACTION_SPRITE_SIZE = [1741, 1632] as const;
+export const DEFAULT_USED_REACTIONS = [
+  'MUSCLE',
+  'APPLAUSE',
+  'OK',
+  'THUMBSUP',
+  'HEART',
+  'JIAYI',
+  'DONE',
+  'BLUSH',
+  'FACEPALM',
+];
+export const REACTION_CATALOG: ReadonlyArray<
+  readonly [
+    key: string,
+    label: string,
+    x: number,
+    y: number,
+    width: number,
+    height: number,
+  ]
+> = [
+  ['OK', 'OK', 208, 576, 104, 96],
+  ['THUMBSUP', '赞', 96, 1536, 96, 96],
+  ['THANKS', '双手合十', 1549, 1248, 96, 96],
+  ['MUSCLE', '加油', 288, 1056, 96, 96],
+  ['FINGERHEART', '比心', 384, 1056, 96, 96],
+  ['APPLAUSE', '鼓掌', 579, 768, 96, 96],
+  ['FISTBUMP', '碰拳', 768, 1056, 96, 96],
+  ['JIAYI', '+1', 1453, 672, 96, 96],
+  ['DONE', '完成', 1069, 96, 96, 96],
+  ['SMILE', '微笑', 1248, 1440, 96, 96],
+  ['Delighted', '愉快', 864, 960, 96, 96],
+  ['BeamingFace', '笑容满面', 877, 192, 96, 96],
+  ['BLUSH', '呲牙', 0, 1152, 96, 96],
+  ['LAUGH', '大笑', 1056, 1152, 96, 96],
+  ['SMIRK', '坏笑', 194, 768, 97, 96],
+  ['LOL', '笑哭', 0, 480, 108, 96],
+  ['FACEPALM', '捂脸', 192, 1056, 96, 96],
+  ['LOVE', '送心', 192, 1248, 96, 96],
+  ['WINK', '调皮', 1440, 1536, 96, 96],
+  ['PROUD', '得意', 1453, 864, 96, 96],
+  ['WITTY', '灵光一闪', 512, 672, 102, 96],
+  ['SMART', '机智', 1152, 1440, 96, 96],
+  ['SCOWL', '惊呆', 0, 1440, 96, 96],
+  ['THINKING', '思考', 1549, 1440, 96, 96],
+  ['SOB', '流泪', 1549, 0, 96, 96],
+  ['CRY', '泣不成声', 973, 480, 96, 96],
+  ['ERROR', '黑线', 0, 1056, 96, 96],
+  ['NOSEPICK', '抠鼻', 1453, 96, 96, 96],
+  ['HAUGHTY', '烦躁', 768, 1152, 96, 96],
+  ['SLAP', '打脸', 864, 1440, 96, 96],
+  ['SPITBLOOD', '吐血', 410, 672, 102, 96],
+  ['TOASTED', '衰', 192, 1536, 96, 96],
+  ['ColdSweat', '冷汗', 973, 96, 96, 96],
+  ['BLACKFACE', '新月脸', 877, 576, 96, 96],
+  ['FullMoonFace', '满月脸', 1056, 1056, 96, 96],
+  ['GLANCE', '看', 1165, 864, 96, 96],
+  ['DULL', '呆无辜', 1069, 480, 96, 96],
+  ['ROSE', '玫瑰', 1453, 1248, 96, 96],
+  ['HEART', '爱心', 192, 1152, 96, 96],
+  ['PARTY', '撒花', 1453, 288, 96, 96],
+  ['INNOCENTSMILE', '无辜笑', 672, 1152, 96, 96],
+  ['SHY', '害羞', 384, 1440, 96, 96],
+  ['CHUCKLE', '偷笑', 672, 864, 96, 96],
+  ['JOYFUL', '笑', 864, 1152, 96, 96],
+  ['WOW', '惊喜', 1536, 1536, 96, 96],
+  ['TRICK', '嬉笑', 384, 1536, 96, 96],
+  ['YEAH', '耶', 614, 672, 102, 96],
+  ['ENOUGH', '我想静静', 557, 384, 108, 96],
+  ['TEARS', '泪奔', 1549, 960, 96, 96],
+  ['EMBARRASSED', '尬笑', 1069, 960, 96, 96],
+  ['KISS', '亲亲', 960, 1152, 96, 96],
+  ['SMOOCH', '飞吻', 777, 192, 100, 96],
+  ['DROOL', '爱慕', 1069, 192, 96, 96],
+  ['OBSESSED', '心心脸', 384, 1152, 96, 96],
+  ['MONEY', '财迷', 1248, 1344, 96, 96],
+  ['TEASE', '做鬼脸', 1549, 1056, 96, 96],
+  ['SHOWOFF', '酷', 288, 1440, 96, 96],
+  ['COMFORT', '摸头', 973, 192, 96, 96],
+  ['CLAP', '欢呼', 206, 672, 102, 96],
+  ['PRAISE', '强', 0, 672, 103, 96],
+  ['STRIVE', '奋斗', 1549, 864, 96, 96],
+  ['XBLUSH', '脸红', 877, 768, 96, 96],
+  ['SILENT', '闭嘴', 672, 1440, 96, 96],
+  ['WAVE', '再见', 777, 384, 99, 96],
+  ['WHAT', '什么？', 520, 576, 104, 96],
+  ['FROWN', '皱眉', 960, 1056, 96, 96],
+  ['DIZZY', '晕', 1069, 0, 96, 96],
+  ['LOOKDOWN', '鄙视', 0, 1248, 96, 96],
+  ['WAIL', '大哭', 447, 384, 110, 96],
+  ['CRAZY', '抓狂', 973, 288, 96, 96],
+  ['WHIMPER', '可怜', 1344, 1536, 96, 96],
+  ['HUG', '求抱抱', 338, 288, 132, 96],
+  ['BLUBBER', '快哭了', 877, 672, 96, 96],
+  ['WRONGED', '委屈', 1645, 0, 96, 96],
+  ['HUSKY', '翻白眼', 576, 1152, 96, 96],
+  ['SHHH', '嘘', 192, 1440, 96, 96],
+  ['SMUG', '撇嘴', 1344, 1440, 96, 96],
+  ['ANGRY', '发怒', 483, 768, 96, 96],
+  ['HAMMER', '敲打', 96, 1152, 96, 96],
+  ['SHOCKED', '震惊', 324, 480, 107, 96],
+  ['TERROR', '惊恐', 1549, 1152, 96, 96],
+  ['PETRIFIED', '石化', 1453, 480, 96, 96],
+  ['SKULL', '骷髅', 768, 1440, 96, 96],
+  ['SWEAT', '汗', 777, 288, 100, 96],
+  ['SPEECHLESS', '无语', 103, 672, 103, 96],
+  ['SLEEP', '鼾睡', 960, 1440, 96, 96],
+  ['DROWSY', '困', 1069, 288, 96, 96],
+  ['YAWN', '哈欠', 1645, 288, 96, 96],
+  ['SICK', '戴口罩', 480, 1440, 96, 96],
+  ['PUKE', '吐', 1453, 960, 96, 96],
+  ['BETRAYED', '背叛', 877, 384, 96, 96],
+  ['HEADSET', '听歌', 431, 480, 106, 96],
+  ['EatingFood', '吃饭', 1069, 768, 96, 96],
+  ['Typing', '敲键盘', 864, 1536, 96, 96],
+  ['Lemon', '柠檬', 1152, 1152, 96, 96],
+  ['Get', '了解', 1165, 672, 96, 96],
+  ['LGTM', '我看行', 0, 768, 97, 96],
+  ['OnIt', '在做了', 337, 384, 110, 96],
+  ['OneSecond', '稍等', 216, 480, 108, 96],
+  ['Sigh', '叹气', 576, 1440, 96, 96],
+  ['MeMeMe', '举手', 108, 480, 108, 96],
+  ['VRHeadset', 'VR', 1056, 1536, 96, 96],
+  ['GoGoGo', '冲！', 671, 96, 105, 96],
+  ['Partying', '派对', 416, 576, 104, 96],
+  ['ThanksFace', '感谢', 1549, 1344, 96, 96],
+  ['SaluteFace', '致敬', 671, 192, 105, 96],
+  ['Shrug', '耸肩摊手', 777, 96, 100, 96],
+  ['YouAreTheBest', '送你小红花', 1645, 384, 96, 96],
+  ['SALUTE', '抱拳', 1453, 1344, 96, 96],
+  ['SHAKE', '握手', 96, 1440, 96, 96],
+  ['HIGHFIVE', '击掌', 480, 1152, 96, 96],
+  ['WavingHand', '挥手', 1152, 1536, 96, 96],
+  ['UPPERLEFT', '点击', 864, 864, 96, 96],
+  ['ThumbsDown', '踩', 0, 1536, 96, 96],
+  ['ClownFace', '小丑脸', 973, 0, 96, 96],
+  ['SLIGHT', '白眼', 1056, 1440, 96, 96],
+  ['TONGUE', '吐舌', 288, 1536, 96, 96],
+  ['EYESCLOSED', '不看', 96, 1056, 96, 96],
+  ['BEAR', '啊？', 117, 384, 110, 96],
+  ['BULL', '公牛', 192, 864, 96, 96],
+  ['CALF', '小牛', 384, 864, 96, 96],
+  ['LIPS', '嘴唇', 1261, 1152, 96, 96],
+  ['BEER', '啤酒', 877, 288, 96, 96],
+  ['CAKE', '蛋糕', 288, 864, 96, 96],
+  ['GIFT', '礼物', 1165, 768, 96, 96],
+  ['CUCUMBER', '胡瓜', 973, 576, 96, 96],
+  ['Drumstick', '鸡腿', 1069, 384, 96, 96],
+  ['Pepper', '辣椒', 1453, 384, 96, 96],
+  ['CANDIEDHAWS', '冰糖葫芦', 480, 864, 96, 96],
+  ['BubbleTea', '奶茶', 96, 864, 96, 96],
+  ['Coffee', '咖啡', 671, 384, 104, 96],
+  ['Yes', 'Yes', 624, 576, 104, 96],
+  ['No', 'No', 104, 576, 104, 96],
+  ['OKR', 'OKR', 312, 576, 104, 96],
+  ['CheckMark', '勾号', 576, 864, 96, 96],
+  ['CrossMark', '叉号', 973, 384, 96, 96],
+  ['MinusOne', '-1', 1152, 1344, 96, 96],
+  ['Hundred', '100分', 0, 576, 104, 96],
+  ['AWESOMEN', '牛', 771, 768, 96, 96],
+  ['Pin', '图钉', 1453, 576, 96, 96],
+  ['Alarm', '闹钟', 387, 768, 96, 96],
+  ['Loudspeaker', '喇叭', 96, 1248, 96, 96],
+  ['Trophy', '奖杯', 480, 1536, 96, 96],
+  ['Fire', '火', 480, 1056, 96, 96],
+  ['RAINBOWPUKE', '彩虹', 1453, 1056, 96, 96],
+  ['Music', '音乐', 1453, 0, 96, 96],
+  ['TV', '电视', 576, 1536, 96, 96],
+  ['Movie', '电影', 1344, 1344, 96, 96],
+  ['Pumpkin', '南瓜灯', 777, 0, 100, 96],
+  ['XmasTree', '圣诞树', 1645, 192, 96, 96],
+  ['Snowman', '雪人', 1440, 1440, 96, 96],
+  ['XmasHat', '圣诞帽', 1645, 96, 96, 96],
+  ['FIREWORKS', '烟花', 672, 1056, 96, 96],
+  ['2023', '2023', 291, 768, 96, 96],
+  ['JubilantRabbit', '欢兔喝彩', 227, 384, 110, 96],
+  ['REDPACKET', '红包', 1453, 1152, 96, 96],
+  ['FORTUNE', '发', 864, 1056, 96, 96],
+  ['LUCK', '福', 288, 1248, 96, 96],
+  ['FIRECRACKER', '爆竹', 576, 1056, 96, 96],
+  ['StickyRiceBalls', '元宵', 671, 0, 106, 96],
+  ['Mooncake', '月饼', 97, 768, 97, 96],
+  ['MoonRabbit', '玉兔', 537, 480, 106, 96],
+  ['HEARTBROKEN', '心碎', 288, 1152, 96, 96],
+  ['BOMB', '炸弹', 0, 864, 96, 96],
+  ['POOP', '便便', 1453, 768, 96, 96],
+  ['18X', '18禁', 1069, 864, 96, 96],
+  ['CLEAVER', '刀', 768, 864, 96, 96],
+  ['Basketball', '篮球', 877, 96, 96, 96],
+  ['Soccer', '足球', 1549, 96, 96, 96],
+  ['GeneralDoNotDisturb', '请勿打扰', 1165, 192, 96, 96],
+];