@droppii-org/chat-mobile 0.2.81 → 0.2.83

package/lib/typescript/src/types/mention.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @mention composer types.
+ *
+ * All offsets throughout this module are raw JS string indices (UTF-16 code
+ * units) — the same unit RN's TextInput selection/cursor API uses on both
+ * platforms. This is a deliberate choice, not a default: it means offsets
+ * never need conversion at the RN boundary, at the cost of requiring
+ * surrogate-pair-aware handling wherever text is diffed (see mentionDiff.ts).
+ * AT Protocol-style byte offsets are unnecessary here because this data
+ * never crosses a non-JS boundary — see mentionSerializer.ts.
+ */
+export interface Selection {
+    start: number;
+    end: number;
+}
+/**
+ * A committed mention: created only by explicit picker selection
+ * (insertMention), never inferred from text content. [start, end) excludes
+ * the trailing separator space inserted after the display name — see
+ * insertMention's doc comment for why.
+ */
+export interface Mention {
+    id: string;
+    userId: string;
+    displayName: string;
+    start: number;
+    end: number;
+}
+/**
+ * The in-progress, uncommitted "@query" at the cursor. Freely editable
+ * character-by-character — never atomic, never promoted to a Mention except
+ * through explicit selection from the suggestion list.
+ */
+export interface ActiveMention {
+    trigger: '@';
+    start: number;
+    end: number;
+    keyword: string;
+}
+export interface MentionSuggestion {
+    userId: string;
+    displayName: string;
+    avatar?: string;
+}
+/**
+ * The boundary between Part A (composer, no concrete OpenIM dependency) and
+ * Part B (OpenIM SDK integration). Part A depends only on this type,
+ * injected; Part B's `openIMMentionSearchSource` (src/services/mentionSearch.ts)
+ * implements it against the real SDK. Defined here, in Part A's own types
+ * file, rather than in the Part B service file, so the dependency direction
+ * stays correct: Part A defines the contract, Part B implements it.
+ */
+export interface MentionSearchResult {
+    items: MentionSuggestion[];
+    /** True when `items.length === limit` — a same-size next page may exist. */
+    hasMore: boolean;
+}
+export interface MentionSearchSource {
+    search(params: {
+        keyword: string;
+        limit: number;
+        offset: number;
+    }): Promise<MentionSearchResult>;
+}
+//# sourceMappingURL=mention.d.ts.map

package/lib/typescript/src/types/mention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.d.ts","sourceRoot":"","sources":["../../../../src/types/mention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,GAAG,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,MAAM,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAClC"}

package/lib/typescript/src/utils/legendListMessage.d.ts

@@ -9,9 +9,10 @@ export interface PrecomputedMessageData {
     messageId: string;
     dayStart: boolean;
     /**
-     * More than GROUP_TIME_GAP has passed since the previous message. The list
-     * marks these with a time label: the cluster break is real but, unlike a day
-     * change, nothing else on screen would show why the run stopped.
+     * More than DIVIDER_TIME_GAP has passed since the previous message on the
+     * same day. The list marks these with a time-only divider so a long pause
+     * is visible even when nothing else on screen (day change, sender change)
+     * would show it.
      */
     timeBreak: boolean;
     createdAt: number;

package/lib/typescript/src/utils/legendListMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legendListMessage.d.ts","sourceRoot":"","sources":["../../../../src/utils/legendListMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAI9E;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,WAAW,KAAG,MAkCrD,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAsCD,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,WAAW,EAAE,EACvB,uCAA8C,iBAAsB,KACnE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CA6EpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,WAAW,EAAE,KACtB,GAAG,CAAC,MAAM,EAAE,OAAO,CAYrB,CAAC"}
+{"version":3,"file":"legendListMessage.d.ts","sourceRoot":"","sources":["../../../../src/utils/legendListMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAI9E;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,WAAW,KAAG,MAkCrD,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;CAC9B;AA8CD,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,WAAW,EAAE,EACvB,uCAA8C,iBAAsB,KACnE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CA6EpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,WAAW,EAAE,KACtB,GAAG,CAAC,MAAM,EAAE,OAAO,CAYrB,CAAC"}

package/lib/typescript/src/utils/mentionSerializer.d.ts

@@ -0,0 +1,78 @@
+import type { AtUsersInfoItem } from '@droppii/openim-rn-client-sdk';
+import type { ISerializedMentionEx } from '../types/chat';
+import type { Mention } from '../types/mention';
+/** Composer-internal marker for the "Tất cả" suggestion row / a committed
+ * "tag everyone" Mention — never sent on the wire, see AT_ALL_TAG below. */
+export declare const ALL_MEMBERS_USER_ID = "ALL";
+/**
+ * OpenIM's own protocol sentinel for "everyone in the group", used inside
+ * atUserIDList in place of enumerating every member. Confirmed against
+ * openimsdk-core (pkg/constant/constant.go:242 — `AtAllString = "AtAllTag"`,
+ * exposed client-side as `GetAtAllTag()`) and openim-server's group-message
+ * send path (internal/rpc/msg/send.go's `setConversationAtInfo`), which
+ * special-cases exactly this string and does the "who is everyone right
+ * now" resolution itself, server-side.
+ *
+ * This is why "Tất cả" must serialize to this one token instead of
+ * expanding to every resolved member's userID client-side (the previous
+ * approach): the Go core's CreateTextAtMessage hard-rejects any
+ * atUserIDList longer than 10 entries regardless of group size
+ * (openimsdk-core/internal/conversation_msg/create_message.go:80-82) — a
+ * >10-member group's "Tất cả" silently failed to send at all. Sending just
+ * `[AT_ALL_TAG]` keeps atUserIDList small no matter the group size, and is
+ * also the behavior the protocol actually expects.
+ */
+export declare const AT_ALL_TAG = "AtAllTag";
+/**
+ * OpenIM's Go core hard-rejects any AtMsgParams.atUserIDList longer than
+ * this (openimsdk-core/internal/conversation_msg/create_message.go:80-82,
+ * `if len(userIDList) > 10 { return nil, sdkerrs.ErrArgs }`) — not
+ * adjustable client-side. "Tất cả" no longer risks this (see AT_ALL_TAG),
+ * but tagging more than 10 *individual* members in one message still
+ * would, so serializeMentionsForSend caps atUserIDList/atUsersInfo at this
+ * count (keeping the first MAX_AT_USER_COUNT, in mention order) rather
+ * than letting the send fail outright the way "Tất cả" used to.
+ */
+export declare const MAX_AT_USER_COUNT = 10;
+export interface SerializedMentions {
+    atUserIDList: string[];
+    atUsersInfo: AtUsersInfoItem[];
+    exMentions: ISerializedMentionEx[];
+    /**
+     * True when more than MAX_AT_USER_COUNT distinct users were mentioned —
+     * atUserIDList/atUsersInfo were capped to the first MAX_AT_USER_COUNT (in
+     * mention order) so the send doesn't hit the Go core's hard rejection.
+     * `exMentions` is deliberately NOT capped: every mention still renders
+     * highlighted in the sent text (the sender sees what they typed), only
+     * native tag/notify is limited to the first MAX_AT_USER_COUNT. Callers
+     * use this flag to warn the user, not to block the send.
+     */
+    truncated: boolean;
+}
+/**
+ * Translates the composer's Mention[] (client-side ranges) into OpenIM's
+ * wire shapes for createTextAtMessage, plus our own ex.mentions channel. No
+ * group-member resolution needed here (or by the caller) any more — see
+ * AT_ALL_TAG's doc comment for why a "Tất cả" mention maps to that single
+ * sentinel rather than a per-member list.
+ */
+export declare function serializeMentionsForSend(mentions: Mention[]): SerializedMentions;
+interface ReceivedAtTextElem {
+    text: string;
+    atUserList: string[];
+    atUsersInfo?: AtUsersInfoItem[];
+}
+/**
+ * Reverse of serializeMentionsForSend, for rendering a received/sent
+ * AtTextMessage (Phase B3). Prefers `exMentions` (exact, our own channel);
+ * falls back to searching `atTextElem.text` for "@{groupNickname}" per
+ * atUsersInfo entry when ex is absent — an interop safety net, not the
+ * primary path. The fallback is inherently ambiguous if a member's
+ * nickname coincidentally appears elsewhere in the message as plain text;
+ * accepted as a known, documented limitation (see the mention plan's
+ * finding #3) rather than something client code can fully resolve without
+ * position data from the protocol.
+ */
+export declare function deserializeMentionRanges(atTextElem: ReceivedAtTextElem, exMentions?: ISerializedMentionEx[]): Mention[];
+export {};
+//# sourceMappingURL=mentionSerializer.d.ts.map

package/lib/typescript/src/utils/mentionSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentionSerializer.d.ts","sourceRoot":"","sources":["../../../../src/utils/mentionSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD;4EAC4E;AAC5E,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU,aAAa,CAAC;AAErC;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC;;;;;;;;OAQG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,EAAE,GAClB,kBAAkB,CAkCpB;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,kBAAkB,EAC9B,UAAU,CAAC,EAAE,oBAAoB,EAAE,GAClC,OAAO,EAAE,CAiCX"}

package/lib/typescript/src/utils/mentions/index.d.ts

@@ -0,0 +1,5 @@
+export { findActiveMention } from './mentionDetector';
+export { diffTextChange, snapBoundary, type TextChangeDiff, } from './mentionDiff';
+export { insertMention, reconcileMentions, normalizeDeleteRange, applyTextChange, type InsertMentionResult, type ReconcileMentionsResult, type ApplyTextChangeResult, } from './mentionRange';
+export { tokenize, type Segment } from './mentionTokenize';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/utils/mentions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/utils/mentions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/typescript/src/utils/mentions/mentionDetector.d.ts

@@ -0,0 +1,18 @@
+import type { ActiveMention } from '../../types/mention';
+/**
+ * Scans backward from `cursor` for an unclosed "@query" — the in-progress
+ * trigger that drives the suggestion list, not a committed mention.
+ *
+ * Only called for a collapsed cursor (selection.start === selection.end);
+ * the caller must resolve a range selection to `null` before calling this —
+ * a live "@query" only makes sense at a single insertion point.
+ *
+ * "@" itself counts as a boundary: the scan stops there whether or not it's
+ * a valid trigger, which is what prevents re-scanning back through an
+ * already-committed mention's "@Name " when the user starts typing a second
+ * "@" right after it (insertMention always appends a trailing space, a
+ * boundary char, so the previous mention's "@" is never reachable from the
+ * new query).
+ */
+export declare function findActiveMention(text: string, cursor: number): ActiveMention | null;
+//# sourceMappingURL=mentionDetector.d.ts.map

package/lib/typescript/src/utils/mentions/mentionDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentionDetector.d.ts","sourceRoot":"","sources":["../../../../../src/utils/mentions/mentionDetector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASzD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,IAAI,CA8BtB"}

package/lib/typescript/src/utils/mentions/mentionDiff.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Snaps `index` so it never sits between a surrogate pair in `str` —
+ * without this, diffing e.g. "😀" vs "😁" (which differ only in their low
+ * surrogate) would compute a boundary that bisects the emoji. Snapping
+ * always shrinks the "common" region (treats one more code point as
+ * "changed"), which is always safe: being more conservative about what
+ * counts as touched only ever produces more mention-invalidation upstream,
+ * never corruption.
+ */
+export declare function snapBoundary(str: string, index: number, direction: 1 | -1): number;
+export interface TextChangeDiff {
+    /** [removedStart, removedEnd) in previousText coords — what was deleted. */
+    removedStart: number;
+    removedEnd: number;
+    /** [insertedStart, insertedEnd) in nextText coords — what was inserted. insertedStart === removedStart. */
+    insertedStart: number;
+    insertedEnd: number;
+}
+export declare function diffTextChange(previousText: string, nextText: string): TextChangeDiff;
+//# sourceMappingURL=mentionDiff.d.ts.map

package/lib/typescript/src/utils/mentions/mentionDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentionDiff.d.ts","sourceRoot":"","sources":["../../../../../src/utils/mentions/mentionDiff.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GAChB,MAAM,CAUR;AAED,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,2GAA2G;IAC3G,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,cAAc,CAuChB"}

package/lib/typescript/src/utils/mentions/mentionRange.d.ts

@@ -0,0 +1,86 @@
+import type { ActiveMention, Mention } from '../../types/mention';
+export interface InsertMentionResult {
+    text: string;
+    mentions: Mention[];
+    cursor: number;
+}
+/**
+ * Replaces the active "@query" range with "@DisplayName " and commits a new
+ * Mention. The trailing space is deliberately excluded from the mention's
+ * [start,end) range — it's a plain separator, not part of the token. This
+ * keeps the data model simple (no "our space" vs "user-typed space"
+ * special-casing) at the cost of removing a mention immediately after
+ * insertion taking two backspaces (first eats the space, second — now
+ * touching the mention's actual range — triggers atomic removal). Matches
+ * the spec's own fixture: "Hello @Thinh" with NO trailing space, cursor at
+ * the end, backspace removes the whole mention in one step, since there's
+ * no space to consume first.
+ */
+export declare function insertMention(text: string, mentions: Mention[], activeMention: ActiveMention, selected: {
+    userId: string;
+    displayName: string;
+}): InsertMentionResult;
+export interface ReconcileMentionsResult {
+    mentions: Mention[];
+    invalidated: Mention[];
+}
+/**
+ * Re-derives mention ranges after an edit, given only the before/after full
+ * strings (RN's onChangeText carries no delta). Diffs the two strings to
+ * localize the changed region, then per mention: fully before the change ->
+ * kept as-is; fully after -> shifted by the length delta; any overlap at
+ * all -> invalidated (dropped, never left partially stale).
+ *
+ * Boundary semantics matter here: `m.end <= removedStart` (touching-but-
+ * before) is "kept", and `m.start >= removedEnd` (touching-but-after) is
+ * "shift" — so typing immediately after a mention, or deleting text
+ * strictly before one, never invalidates it. Anything else, even a
+ * 1-character overlap, does.
+ */
+export declare function reconcileMentions({ previousText, nextText, mentions, }: {
+    previousText: string;
+    nextText: string;
+    mentions: Mention[];
+}): ReconcileMentionsResult;
+/**
+ * Expands a delete/replace range so it fully swallows any mention it
+ * merely intersects — this is what makes "atomic delete" actually happen.
+ * RN's Old-Architecture TextInput can't intercept a keypress before the
+ * native buffer mutates, so this doesn't run as a true pre-mutation guard;
+ * it runs on the range diffTextChange computed from an already-applied
+ * edit, and the caller (useMentionComposer) uses the expanded range to
+ * rebuild the text from previousText before React re-renders — see that
+ * hook's doc comment for the full repair sequence.
+ *
+ * The fixed-point loop is needed for the adjacent-mentions case: expanding
+ * to cover one mention can newly overlap a neighbor with zero gap between
+ * them (e.g. loaded from server data with no separator).
+ */
+export declare function normalizeDeleteRange(range: {
+    start: number;
+    end: number;
+}, mentions: Mention[]): {
+    start: number;
+    end: number;
+};
+export interface ApplyTextChangeResult {
+    text: string;
+    mentions: Mention[];
+    cursor: number;
+    /** True when this change touched a mention and it was atomically removed. */
+    mentionRemoved: boolean;
+}
+/**
+ * The full "atomic delete" pipeline, extracted as a pure function so it's
+ * unit-testable without a live TextInput: diff previousText -> nextTextRaw,
+ * expand the removed range to cover any touched mention, and if it
+ * expanded, discard nextTextRaw for that span and rebuild atomically from
+ * previousText — otherwise just diff-and-shift normally.
+ *
+ * This is what `useMentionComposer` (Phase A2) calls from its
+ * ref-buffered onChangeText reconciliation step; it also imperatively
+ * calls the native `setSelection(cursor, cursor)` after, which is RN-only
+ * and stays out of this pure function.
+ */
+export declare function applyTextChange(previousText: string, mentions: Mention[], nextTextRaw: string): ApplyTextChangeResult;
+//# sourceMappingURL=mentionRange.d.ts.map

package/lib/typescript/src/utils/mentions/mentionRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentionRange.d.ts","sourceRoot":"","sources":["../../../../../src/utils/mentions/mentionRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGlE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAChD,mBAAmB,CA2BrB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,OAAO,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,YAAY,EACZ,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB,GAAG,uBAAuB,CAsB1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACrC,QAAQ,EAAE,OAAO,EAAE,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAkBhC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO,EAAE,EACnB,WAAW,EAAE,MAAM,GAClB,qBAAqB,CAqCvB"}

package/lib/typescript/src/utils/mentions/mentionTokenize.d.ts

@@ -0,0 +1,29 @@
+import type { Mention } from '../../types/mention';
+export type Segment = {
+    type: 'text';
+    text: string;
+    start: number;
+    end: number;
+} | {
+    type: 'mention';
+    mention: Mention;
+};
+/**
+ * Converts edit-time state (flat string + Mention[] ranges) into an
+ * ordered list of plain-text runs and mention tokens — the shape both the
+ * composer's highlight renderer (Phase A3) and the sent-message bubble
+ * renderer (Phase B3) need to produce their styled `<Text>` children.
+ * Shared by both so the segment-splitting logic exists exactly once.
+ *
+ * O(m log m) sort + O(n) slicing (m = mention count, n = text length) —
+ * trivial at the sizes this feature targets (≤50 mentions, ≤2000 chars).
+ *
+ * Precondition: `mentions` is non-overlapping, guaranteed by Phase A1's own
+ * pipeline (insertMention/reconcileMentions never produce overlaps). The
+ * `m.start < cursor` skip below is a defensive backstop for
+ * externally-sourced data (a message loaded for editing, or an `ex` blob
+ * serialized by an older app version) — not a correctness dependency for
+ * the live composer.
+ */
+export declare function tokenize(text: string, mentions: Mention[]): Segment[];
+//# sourceMappingURL=mentionTokenize.d.ts.map

package/lib/typescript/src/utils/mentions/mentionTokenize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentionTokenize.d.ts","sourceRoot":"","sources":["../../../../../src/utils/mentions/mentionTokenize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CA6BrE"}

package/lib/typescript/src/utils/messageUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messageUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/messageUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EAEX,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,eAAO,MAAM,gBAAgB,GAAI,SAAS,WAAW,KAAG,OACL,CAAC;AAKpD,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAC3C,MAAM,CAAC,WAAW,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAqEjE,CAAC;AAMF,eAAO,MAAM,wBAAwB,EAEpB,WAAW,EAAE,CAAC;AA2B/B,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAQD,eAAO,MAAM,uBAAuB,GAClC,SAAS,WAAW,KACnB,wBAAwB,GAAG,SA8D7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,SAAS,WAAW,KAAG,MAYzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,UAAU,WAAW,KAAG,MAyFzD,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,UAAU,WAAW,KACpB,SAUF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,UAAU,WAAW,KACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAGrC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,sBAAsB,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmBD,eAAO,MAAM,uBAAuB,GAClC,SAAS,WAAW,KACnB,oBA0DF,CAAC;AAKF,eAAO,MAAM,6BAA6B,GACxC,SAAS,WAAW,KACnB,MAAM,GAAG,SAaX,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,SAAS,WAAW,EACpB,gBAAgB,MAAM,EACtB,eAAe,gBAAgB,KAC9B,MAgBF,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,eAAO,MAAM,kBAAkB,GAAI,0EAKhC,wBAAwB,KAAG,MAyB7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,UAAU,WAAW,EACrB,gBAAgB,MAAM,EACtB,eAAe,gBAAgB,EAC/B,SAAS,OAAO,KACf,MAOF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,YAAY,GAAG,SAS7D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,WAAW,MAAM,KAAG,MAUhE,CAAC"}
+{"version":3,"file":"messageUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/messageUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EAEX,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,eAAO,MAAM,gBAAgB,GAAI,SAAS,WAAW,KAAG,OACL,CAAC;AAKpD,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAC3C,MAAM,CAAC,WAAW,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAqEjE,CAAC;AAMF,eAAO,MAAM,wBAAwB,EAEpB,WAAW,EAAE,CAAC;AA2B/B,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAQD,eAAO,MAAM,uBAAuB,GAClC,SAAS,WAAW,KACnB,wBAAwB,GAAG,SA8D7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,SAAS,WAAW,KAAG,MAYzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,UAAU,WAAW,KAAG,MA8FzD,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,UAAU,WAAW,KACpB,SAUF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,UAAU,WAAW,KACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAGrC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,sBAAsB,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmBD,eAAO,MAAM,uBAAuB,GAClC,SAAS,WAAW,KACnB,oBA0DF,CAAC;AAKF,eAAO,MAAM,6BAA6B,GACxC,SAAS,WAAW,KACnB,MAAM,GAAG,SAaX,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,SAAS,WAAW,EACpB,gBAAgB,MAAM,EACtB,eAAe,gBAAgB,KAC9B,MAgBF,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,eAAO,MAAM,kBAAkB,GAAI,0EAKhC,wBAAwB,KAAG,MAyB7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,UAAU,WAAW,EACrB,gBAAgB,MAAM,EACtB,eAAe,gBAAgB,EAC/B,SAAS,OAAO,KACf,MAOF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,YAAY,GAAG,SAS7D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,WAAW,MAAM,KAAG,MAUhE,CAAC"}

package/lib/typescript/src/utils/url.d.ts

@@ -1,4 +1,16 @@
 export declare function extractUrls(text: string): string[];
+export interface TextUrlPart {
+    text: string;
+    isUrl: boolean;
+}
+/**
+ * Splits `text` into an ordered run of plain/URL parts — pure data, no
+ * JSX, so both LinkMessage (a whole message that's just text+URLs) and
+ * TextMessage (a mention message whose plain-text *segments* may also
+ * contain a URL) can render URL styling from the same source instead of
+ * two divergent implementations.
+ */
+export declare function splitTextByUrls(text: string, urls: string[]): TextUrlPart[];
 export declare function normalizeUrl(url: string): string;
 /**
  * The resource-center API's `urlMetadata` doesn't include a separate domain field

package/lib/typescript/src/utils/url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../../src/utils/url.ts"],"names":[],"mappings":"AA+BA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAElD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,UAKvC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGjD"}
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../../src/utils/url.ts"],"names":[],"mappings":"AA+BA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAElD;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAgB3E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,UAKvC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGjD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@droppii-org/chat-mobile",
-  "version": "0.2.81",
+  "version": "0.2.83",
   "description": "Droppii chat mobile",
   "keywords": [
     "react-native",

package/src/components/ThreadCard/MentionBadge.tsx

@@ -0,0 +1,28 @@
+import { memo } from 'react';
+import { KLabel, KColors } from '@droppii/libs';
+import { GroupAtType } from '@droppii/openim-rn-client-sdk';
+
+interface MentionBadgeProps {
+  groupAtType?: GroupAtType;
+}
+
+// Figma (node 15177-302069): "@" renders as a standalone bold glyph, no
+// background — same color token as the composer/bubble mention highlight
+// (KColors.palette.primary.w400), not a new one-off value.
+export const MentionBadge = memo(({ groupAtType }: MentionBadgeProps) => {
+  if (groupAtType === undefined || groupAtType === GroupAtType.AtNormal) {
+    return null;
+  }
+
+  return (
+    <KLabel.Text
+      typo="TextNmBold"
+      color={KColors.palette.primary.w400}
+      marginL="0.5rem"
+    >
+      @
+    </KLabel.Text>
+  );
+});
+
+MentionBadge.displayName = 'MentionBadge';

package/src/components/ThreadCard/ThreadCard.tsx

@@ -6,6 +6,7 @@ import { KContainer, KImage, KLabel, KColors } from '@droppii/libs';
 import { AvatarSection } from './AvatarSection';
 import { NamePrefixIcon } from './NamePrefixIcon';
 import { UnreadBadge } from './UnreadBadge';
+import { MentionBadge } from './MentionBadge';
 import { formatTimestamp } from '../../utils/dateTimeUtils';
 import {
   getLastMessageText,
@@ -44,6 +45,7 @@ const ThreadCard = memo(({ item, onPress }: ThreadCardProps) => {
     latestMsgSendTime,
     latestMsg,
     groupID,
+    groupAtType,
   } = conversation || {};
 
   const { data: isJoinedGroup } = useIsJoinedGroup(groupID);
@@ -183,6 +185,7 @@ const ThreadCard = memo(({ item, onPress }: ThreadCardProps) => {
                 />
               </KContainer.View>
             </KContainer.VisibleView>
+            <MentionBadge groupAtType={groupAtType} />
             <UnreadBadge count={unreadCount} />
           </KContainer.View>
         </KContainer.View>

package/src/components/messages/linkMessage/LinkPreviewCard.tsx

@@ -0,0 +1,92 @@
+import { memo } from 'react';
+import { StyleSheet } from 'react-native';
+import {
+  KContainer,
+  KImage,
+  KLabel,
+  KColors,
+  KSpacingValue,
+} from '@droppii/libs';
+import type { IUrlMetadata } from '../../../types/common';
+
+interface LinkPreviewCardProps {
+  metadata: IUrlMetadata;
+  onPressUrl?: (url: string) => void;
+}
+
+/**
+ * The rich link-preview card (thumbnail/title/url/description) — shared by
+ * LinkMessage (message.urlTextElem, a plain URL message) and TextMessage
+ * (mention+URL combo: message.ex.urlMetadata attached to an AtTextMessage,
+ * since OpenIM's AtTextMessage/UrlTextMessage content types are mutually
+ * exclusive — see useSendMessage.ts's doc comment for why the mention wins
+ * the content type and the URL card rides along in `ex` instead).
+ */
+export const LinkPreviewCard = memo(
+  ({ metadata, onPressUrl }: LinkPreviewCardProps) => (
+    <KContainer.Touchable
+      style={styles.card}
+      onPress={() => metadata.url && onPressUrl?.(metadata.url)}
+    >
+      {!!metadata.image && (
+        <KContainer.View style={styles.cardThumb}>
+          <KImage.Base
+            uri={metadata.image}
+            style={StyleSheet.absoluteFill}
+            resizeMode="cover"
+          />
+        </KContainer.View>
+      )}
+      <KContainer.View style={styles.cardBody}>
+        {!!metadata.title && (
+          <KLabel.Text
+            typo="TextNmMedium"
+            color={KColors.palette.gray.w900}
+            numberOfLines={1}
+          >
+            {metadata.title}
+          </KLabel.Text>
+        )}
+        {!!metadata.url && (
+          <KLabel.Text
+            typo="TextXsMedium"
+            color={KColors.palette.primary.w400}
+            numberOfLines={1}
+          >
+            {metadata.url}
+          </KLabel.Text>
+        )}
+        {!!metadata.description && (
+          <KLabel.Text
+            typo="TextXsNormal"
+            color={KColors.gray.normal}
+            numberOfLines={2}
+          >
+            {metadata.description}
+          </KLabel.Text>
+        )}
+      </KContainer.View>
+    </KContainer.Touchable>
+  )
+);
+
+LinkPreviewCard.displayName = 'LinkPreviewCard';
+
+const styles = StyleSheet.create({
+  card: {
+    borderRadius: KSpacingValue['0.75rem'],
+    borderWidth: 1,
+    borderColor: 'rgba(57,62,64,0.1)',
+    backgroundColor: KColors.white,
+    overflow: 'hidden',
+  },
+  cardThumb: {
+    width: '100%',
+    aspectRatio: 16 / 9,
+  },
+  cardBody: {
+    paddingHorizontal: KSpacingValue['0.75rem'],
+    paddingVertical: KSpacingValue['0.5rem'],
+    gap: 2,
+  },
+});