admin-ui-starter-kit 0.1.0

package/dist/components/features/comments/comments.types.d.ts

@@ -0,0 +1,271 @@
+import { ComponentType, ReactNode } from 'react';
+import { CommentsStrings } from './comments.strings';
+import { Mention, MentionResource, MentionSuggestion, MentionTone, MentionsResourceSearch } from '../mentions/mentions.types';
+export interface CommentUser {
+    id?: string | number;
+    name?: string;
+    avatar?: string;
+}
+export type CommentAttachmentStatus = 'uploading' | 'uploaded' | 'failed';
+export interface CommentAttachment {
+    id: string;
+    /** Display name. */
+    name: string;
+    /** Permalink. Optional while uploading. */
+    url?: string;
+    /** Size in bytes. */
+    size?: number;
+    /** Mime type — drives icon/preview pickers. */
+    mimeType?: string;
+    /** Optional thumbnail URL for image attachments. */
+    thumbnailUrl?: string;
+    /** Upload state — useful while a file is in flight. */
+    status?: CommentAttachmentStatus;
+    /** 0–100 progress for in-flight uploads. */
+    progress?: number;
+    /** Error message if `status === 'failed'`. */
+    error?: string;
+}
+/** Legacy alias kept for back-compat — older consumers used `CommentMedia`. */
+export type CommentMedia = CommentAttachment;
+export type CommentReference<TKind extends string = string, TData = unknown> = Mention<TKind, TData>;
+export type CommentResourceSuggestion<TKind extends string = string, TData = unknown> = MentionSuggestion<TKind, TData>;
+export type CommentResourceType<TKind extends string = string, TData = unknown> = MentionResource<TKind, TData>;
+export type CommentTone = MentionTone;
+export interface CommentReaction {
+    /** Emoji or short token ("👍", "rocket"). */
+    emoji: string;
+    count: number;
+    /** True when the current user reacted with this emoji. */
+    mine?: boolean;
+    /** Optional list of user names for the tooltip. */
+    users?: string[];
+}
+export type CommentContentType = 'text' | 'html' | 'rich' | (string & {});
+export interface CommentData<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> {
+    id?: string;
+    /** HTML, rich-JSON, or plain text — controlled by `contentType`. */
+    content?: string;
+    contentType?: CommentContentType;
+    createdAt?: string;
+    updatedAt?: string;
+    user?: TUser;
+    /** Optional moderation/state hint shown next to the timestamp. */
+    status?: string;
+    isPinned?: boolean;
+    isEdited?: boolean;
+    /** Per-comment override — when false, the moderator menu is suppressed. */
+    canDelete?: boolean;
+    /** Per-comment override — when false, the edit affordance is suppressed. */
+    canEdit?: boolean;
+    /** Inline tags rendered as small pills. */
+    tagsArray?: string[] | Record<string, string>;
+    /** Attachments. `media` is the legacy field name — kept for back-compat. */
+    attachments?: Array<CommentAttachment | null>;
+    media?: Array<CommentAttachment | null>;
+    /** Resource references rendered as badges and persisted alongside content. */
+    references?: ReadonlyArray<CommentReference<TResource>>;
+    /** Reactions on the comment. */
+    reactions?: ReadonlyArray<CommentReaction>;
+    /** Threading — id of the parent comment if this is a reply. */
+    replyToId?: string;
+    /** Free-form per-comment payload for consumer use. */
+    meta?: TMeta;
+}
+export interface CommentableContext {
+    id: string;
+    type: string;
+    moduleKey?: string;
+}
+export interface CommentFormValues<TResource extends string = string> {
+    /** HTML body produced by the rich text editor. */
+    content: string;
+    commentableId: string;
+    commentableType: string;
+    contentType?: CommentContentType;
+    /** Resource references collected via the picker. */
+    references?: ReadonlyArray<CommentReference<TResource>>;
+    /** Attachments — already uploaded by the consumer's `onUpload`. */
+    attachments?: ReadonlyArray<CommentAttachment>;
+    /** Optional id of the comment being replied-to. */
+    replyToId?: string;
+    /** Optional id of the comment being edited (when in edit mode). */
+    editingId?: string;
+}
+export interface CommentSubmitHelpers {
+    setErrors: (errors: Record<string, string>) => void;
+    reset: () => void;
+    setSubmitting: (submitting: boolean) => void;
+}
+/** Where the composer sits relative to the timeline. */
+export type CommentsComposerPosition = 'top' | 'bottom';
+export interface CommentsAccessors {
+    /** Resolve an attachment to a clickable URL. Defaults to `attachment.url`. */
+    getMediaUrl?: (media: CommentAttachment | null | undefined) => string | undefined;
+    /** Resolve an attachment to a display name. */
+    getMediaName?: (media: CommentAttachment | null | undefined) => string | undefined;
+    /** Resolve `comment.status` to a localised label. */
+    getStatusLabel?: (status: string) => string | undefined;
+    /** Format an ISO timestamp into a relative string. */
+    formatRelativeTime?: (iso: string) => string;
+}
+export interface CommentAttachmentUploadContext {
+    /** The original file the user picked / dropped. */
+    file: File;
+    /** Throttled progress callback the uploader can call. */
+    onProgress: (progress: number) => void;
+    /** AbortSignal — aborted when the user removes the chip mid-upload. */
+    signal: AbortSignal;
+}
+export interface CommentsAttachmentsConfig {
+    /**
+     * Async uploader. Resolves to a fully-formed `CommentAttachment` with
+     * a permanent `url`. Required to enable the attachment button.
+     */
+    onUpload?: (ctx: CommentAttachmentUploadContext) => Promise<CommentAttachment>;
+    /** Maximum file size in bytes. */
+    maxSize?: number;
+    /** Maximum simultaneous attachments per draft. */
+    maxFiles?: number;
+    /** Mime-type / extension filter passed to the file input. */
+    accept?: string;
+    /** Disable the attachment button entirely (default: false unless `onUpload` is missing). */
+    disabled?: boolean;
+}
+export interface CommentsConfig<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> extends CommentsAccessors {
+    /** Where the composer sits. Default: 'top'. */
+    composerPosition?: CommentsComposerPosition;
+    /** Strings deep-merged into descendant components. */
+    strings?: Partial<CommentsStrings>;
+    /** Resource catalogue used by the inline picker. */
+    resources?: Partial<Record<TResource, CommentResourceType<TResource>>>;
+    /**
+     * Global "rich suggestions" callback. Used when:
+     *   1. The user types one of the registered triggers (e.g. `@`, `#`)
+     *      followed by a needle — the picker opens automatically and calls
+     *      `onResourceSearch(needle, kind)` to populate results.
+     *   2. A `resources[kind]` entry is missing both `search` and
+     *      `suggestions` — the picker falls back to this callback.
+     *
+     * Per-kind `search` / `suggestions` always take precedence when present.
+     */
+    onResourceSearch?: MentionsResourceSearch<TResource>;
+    /** Attachment uploader config. */
+    attachments?: CommentsAttachmentsConfig;
+    /** Default permission flags. */
+    canComment?: boolean;
+    canModerate?: boolean;
+    /** Lifecycle callbacks — bubble through to descendants. */
+    onSubmit?: (values: CommentFormValues<TResource>, helpers: CommentSubmitHelpers) => void;
+    onDelete?: (commentId: string) => void;
+    onUpdate?: (commentId: string, values: CommentFormValues<TResource>, helpers: CommentSubmitHelpers) => void;
+    onPinToggle?: (comment: CommentData<TUser, TMeta, TResource>) => void;
+    onReact?: (commentId: string, emoji: string) => void;
+    onReply?: (commentId: string) => void;
+    /** Optional sanitizer — runs on HTML before render. */
+    sanitizer?: (html: string) => string;
+}
+export interface CommentRenderItemContext<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> {
+    comment: CommentData<TUser, TMeta, TResource>;
+    canModerate: boolean;
+    onDelete?: (commentId: string) => void;
+    /** Render the default item — useful when wrapping. */
+    defaultItem: ReactNode;
+}
+export interface CommentsSlots<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> {
+    /** Replaces the entire composer. */
+    composerSlot?: ReactNode;
+    /** Replaces the empty-state. */
+    emptySlot?: ReactNode;
+    /** Rendered above the composer + timeline. */
+    headerSlot?: ReactNode;
+    /** Rendered below the timeline. */
+    footerSlot?: ReactNode;
+    /** Per-comment custom rendering. */
+    renderItem?: (ctx: CommentRenderItemContext<TUser, TMeta, TResource>) => ReactNode;
+    /** Per-attachment custom rendering. */
+    renderAttachment?: (attachment: CommentAttachment) => ReactNode;
+    /** Per-reference custom rendering — overrides the resource type's `renderChip`. */
+    renderReference?: (reference: CommentReference<TResource>) => ReactNode;
+}
+export interface CommentsProps<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> extends CommentsAccessors, CommentsSlots<TUser, TMeta, TResource> {
+    /** Identifies the thread; passed to `onSubmit`. */
+    context: CommentableContext;
+    comments: ReadonlyArray<CommentData<TUser, TMeta, TResource>>;
+    canComment?: boolean;
+    canModerate?: boolean;
+    /** Composer position — overrides provider's `composerPosition`. */
+    composerPosition?: CommentsComposerPosition;
+    /** Hide the card chrome (title, padding) — render bare list+composer. */
+    bare?: boolean;
+    /** Override card title via strings; passing false hides it entirely. */
+    title?: ReactNode;
+    /** Lifecycle — overrides provider. */
+    onSubmit?: CommentsConfig<TUser, TMeta, TResource>['onSubmit'];
+    onDelete?: CommentsConfig<TUser, TMeta, TResource>['onDelete'];
+    onUpdate?: CommentsConfig<TUser, TMeta, TResource>['onUpdate'];
+    onPinToggle?: CommentsConfig<TUser, TMeta, TResource>['onPinToggle'];
+    onReact?: CommentsConfig<TUser, TMeta, TResource>['onReact'];
+    onReply?: CommentsConfig<TUser, TMeta, TResource>['onReply'];
+    /** Resource registry override. */
+    resources?: CommentsConfig<TUser, TMeta, TResource>['resources'];
+    /** Global suggestion callback — overrides provider's `onResourceSearch`. */
+    onResourceSearch?: CommentsConfig<TUser, TMeta, TResource>['onResourceSearch'];
+    /** Attachment uploader override. */
+    attachments?: CommentsAttachmentsConfig;
+    strings?: Partial<CommentsStrings>;
+    /** Optional className applied to the outer card. */
+    className?: string;
+    /** Optional avatar fallback component (renders initials by default). */
+    avatarComponent?: ComponentType<{
+        user: TUser | undefined;
+        size: 'sm' | 'md' | 'lg';
+    }>;
+}
+/** Back-compat alias — `CommentsCard` was the previous name of `Comments`. */
+export type CommentsCardProps<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> = CommentsProps<TUser, TMeta, TResource>;
+export interface CommentTimelineProps<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> extends CommentsAccessors, Pick<CommentsSlots<TUser, TMeta, TResource>, 'renderItem' | 'renderAttachment' | 'renderReference' | 'emptySlot'> {
+    comments: ReadonlyArray<CommentData<TUser, TMeta, TResource>>;
+    canModerate?: boolean;
+    onDelete?: (commentId: string) => void;
+    onPinToggle?: (comment: CommentData<TUser, TMeta, TResource>) => void;
+    onReact?: (commentId: string, emoji: string) => void;
+    onReply?: (commentId: string) => void;
+    strings?: Partial<CommentsStrings>;
+    resources?: CommentsConfig<TUser, TMeta, TResource>['resources'];
+}
+export interface CommentItemProps<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> extends CommentsAccessors, Pick<CommentsSlots<TUser, TMeta, TResource>, 'renderAttachment' | 'renderReference'> {
+    comment: CommentData<TUser, TMeta, TResource>;
+    canModerate?: boolean;
+    onDelete?: (commentId: string) => void;
+    onPinToggle?: (comment: CommentData<TUser, TMeta, TResource>) => void;
+    onReact?: (commentId: string, emoji: string) => void;
+    onReply?: (commentId: string) => void;
+    strings?: Partial<CommentsStrings>;
+    resources?: CommentsConfig<TUser, TMeta, TResource>['resources'];
+}
+export interface CommentComposerProps<TResource extends string = string> {
+    context: CommentableContext;
+    canComment?: boolean;
+    isSubmitting?: boolean;
+    errors?: Record<string, string>;
+    /** Bumping this number resets the form. */
+    resetKey?: number;
+    onSubmit: (values: CommentFormValues<TResource>) => void;
+    onCancel?: () => void;
+    /** When set, the composer is in edit mode for that comment. */
+    editingComment?: CommentData<CommentUser, unknown, TResource>;
+    strings?: Partial<CommentsStrings>;
+    resources?: CommentsConfig<CommentUser, unknown, TResource>['resources'];
+    onResourceSearch?: CommentsConfig<CommentUser, unknown, TResource>['onResourceSearch'];
+    attachments?: CommentsAttachmentsConfig;
+    /** Initial draft values. */
+    initialValues?: Partial<CommentFormValues<TResource>>;
+    /** Auto-focus the editor on mount. Default: false. */
+    autoFocus?: boolean;
+    /** Render the submit button on the toolbar (true, default) or as an explicit footer row (false). */
+    inlineSubmit?: boolean;
+    /** Placeholder override (also overridable via strings). */
+    placeholder?: string;
+}
+//# sourceMappingURL=comments.types.d.ts.map

package/dist/components/features/comments/comments.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.types.d.ts","sourceRoot":"","sources":["../../../../src/components/features/comments/comments.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAM1D,MAAM,WAAW,WAAW;IACxB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAa7C,OAAO,KAAK,EACR,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACrG,MAAM,MAAM,yBAAyB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO,IAAI,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACxH,MAAM,MAAM,mBAAmB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,GAAG,OAAO,IAAI,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAChH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAMtC,MAAM,WAAW,eAAe;IAC5B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE1E,MAAM,WAAW,WAAW,CACxB,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM;IAEjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,WAAW,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACxC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,gCAAgC;IAChC,SAAS,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC3C,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,IAAI,CAAC,EAAE,KAAK,CAAC;CAChB;AAMD,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAChE,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,oDAAoD;IACpD,UAAU,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,mEAAmE;IACnE,WAAW,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC/C,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACpD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,aAAa,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;CAChD;AAMD,wDAAwD;AACxD,MAAM,MAAM,wBAAwB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAMxD,MAAM,WAAW,iBAAiB;IAC9B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;IAClF,+CAA+C;IAC/C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;IACnF,qDAAqD;IACrD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACxD,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAMD,MAAM,WAAW,8BAA8B;IAC3C,mDAAmD;IACnD,IAAI,EAAE,IAAI,CAAC;IACX,yDAAyD;IACzD,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,uEAAuE;IACvE,MAAM,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,8BAA8B,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/E,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAMD,MAAM,WAAW,cAAc,CAC3B,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM,CACnC,SAAQ,iBAAiB;IACvB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnC,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACvE;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACrD,kCAAkC;IAClC,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACxC,gCAAgC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CACP,MAAM,EAAE,iBAAiB,CAAC,SAAS,CAAC,EACpC,OAAO,EAAE,oBAAoB,KAC5B,IAAI,CAAC;IACV,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,CACP,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,iBAAiB,CAAC,SAAS,CAAC,EACpC,OAAO,EAAE,oBAAoB,KAC5B,IAAI,CAAC;IACV,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;IACtE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,uDAAuD;IACvD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAMD,MAAM,WAAW,wBAAwB,CACrC,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM;IAEjC,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,sDAAsD;IACtD,WAAW,EAAE,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa,CAC1B,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM;IAEjC,oCAAoC;IACpC,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,gCAAgC;IAChC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,mCAAmC;IACnC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,oCAAoC;IACpC,UAAU,CAAC,EAAE,CACT,GAAG,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KACrD,SAAS,CAAC;IACf,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,SAAS,CAAC;IAChE,mFAAmF;IACnF,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC;CAC3E;AAMD,MAAM,WAAW,aAAa,CAC1B,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM,CACnC,SAAQ,iBAAiB,EACnB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC;IAC1C,mDAAmD;IACnD,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,yEAAyE;IACzE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/D,QAAQ,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/D,QAAQ,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/D,WAAW,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;IACrE,OAAO,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC;IAE7D,kCAAkC;IAClC,SAAS,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;IACjE,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC/E,oCAAoC;IACpC,WAAW,CAAC,EAAE,yBAAyB,CAAC;IAExC,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,eAAe,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;QAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC1F;AAED,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,CACzB,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM,IACjC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAE3C,MAAM,WAAW,oBAAoB,CACjC,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM,CACnC,SAAQ,iBAAiB,EACnB,IAAI,CACA,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EACtC,YAAY,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,WAAW,CACtE;IACL,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;IACtE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,gBAAgB,CAC7B,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM,CACnC,SAAQ,iBAAiB,EACnB,IAAI,CACA,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EACtC,kBAAkB,GAAG,iBAAiB,CACzC;IACL,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;IACtE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,oBAAoB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IACnE,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,WAAW,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,gBAAgB,CAAC,EAAE,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;IACvF,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACxC,4BAA4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;IACtD,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oGAAoG;IACpG,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/components/features/comments/hooks/index.d.ts

@@ -0,0 +1,6 @@
+export { useAttachmentUpload } from './use-attachment-upload';
+export type { UseAttachmentUploadOptions, UseAttachmentUploadReturn, } from './use-attachment-upload';
+export { useComments } from './use-comments';
+export type { ComposerMode, UseCommentsOptions, UseCommentsReturn, } from './use-comments';
+export { useMentionsSearch as useReferencePicker, type UseMentionsSearchOptions as UseReferencePickerOptions, type UseMentionsSearchReturn as UseReferencePickerReturn, } from '../../mentions';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/features/comments/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/comments/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EACR,0BAA0B,EAC1B,yBAAyB,GAC5B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EACR,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GACpB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACH,iBAAiB,IAAI,kBAAkB,EACvC,KAAK,wBAAwB,IAAI,yBAAyB,EAC1D,KAAK,uBAAuB,IAAI,wBAAwB,GAC3D,MAAM,gCAAgC,CAAC"}

package/dist/components/features/comments/hooks/use-attachment-upload.d.ts

@@ -0,0 +1,29 @@
+import { CommentAttachment, CommentsAttachmentsConfig } from '../comments.types';
+export interface UseAttachmentUploadOptions extends CommentsAttachmentsConfig {
+    /** Initial attachments — useful when editing an existing comment. */
+    initialAttachments?: ReadonlyArray<CommentAttachment>;
+    /** Fires when the list of uploaded attachments changes. */
+    onChange?: (attachments: ReadonlyArray<CommentAttachment>) => void;
+    /** Fires when a validation or upload error happens. */
+    onError?: (error: string) => void;
+}
+export interface UseAttachmentUploadReturn {
+    /** All attachments — uploading + uploaded + failed. */
+    attachments: ReadonlyArray<CommentAttachment>;
+    /** Subset of attachments that finished uploading. Use this in the form payload. */
+    uploadedAttachments: ReadonlyArray<CommentAttachment>;
+    /** True while at least one upload is in flight. */
+    isUploading: boolean;
+    /** Add files. Validates against `maxSize` / `maxFiles` first. */
+    addFiles: (files: ReadonlyArray<File> | FileList) => void;
+    /** Remove an attachment by id (aborts in-flight uploads). */
+    removeAttachment: (id: string) => void;
+    /** Retry a failed upload. */
+    retryAttachment: (id: string) => void;
+    /** Replace the list (used when editing or after submit). */
+    setAttachments: (attachments: ReadonlyArray<CommentAttachment>) => void;
+    /** Clear the list and abort everything in flight. */
+    reset: () => void;
+}
+export declare function useAttachmentUpload(options?: UseAttachmentUploadOptions): UseAttachmentUploadReturn;
+//# sourceMappingURL=use-attachment-upload.d.ts.map

package/dist/components/features/comments/hooks/use-attachment-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-attachment-upload.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/comments/hooks/use-attachment-upload.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACR,iBAAiB,EACjB,yBAAyB,EAC5B,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,0BAA2B,SAAQ,yBAAyB;IACzE,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACtD,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACnE,uDAAuD;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACtC,uDAAuD;IACvD,WAAW,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC9C,mFAAmF;IACnF,mBAAmB,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACtD,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,QAAQ,KAAK,IAAI,CAAC;IAC1D,6DAA6D;IAC7D,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,6BAA6B;IAC7B,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,4DAA4D;IAC5D,cAAc,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACxE,qDAAqD;IACrD,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAC/B,OAAO,GAAE,0BAA+B,GACzC,yBAAyB,CA+L3B"}

package/dist/components/features/comments/hooks/use-comments.d.ts

@@ -0,0 +1,33 @@
+import { CommentData, CommentFormValues, CommentSubmitHelpers, CommentUser, CommentsConfig } from '../comments.types';
+export type ComposerMode<TResource extends string = string> = {
+    kind: 'idle';
+} | {
+    kind: 'editing';
+    comment: CommentData<CommentUser, unknown, TResource>;
+} | {
+    kind: 'replying';
+    commentId: string;
+    authorName?: string;
+};
+export interface UseCommentsOptions<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> {
+    onSubmit?: CommentsConfig<TUser, TMeta, TResource>['onSubmit'];
+    onUpdate?: CommentsConfig<TUser, TMeta, TResource>['onUpdate'];
+    onDelete?: CommentsConfig<TUser, TMeta, TResource>['onDelete'];
+}
+export interface UseCommentsReturn<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> {
+    composerMode: ComposerMode<TResource>;
+    isSubmitting: boolean;
+    formErrors: Record<string, string>;
+    resetKey: number;
+    startReply: (comment: CommentData<TUser, TMeta, TResource>) => void;
+    startEdit: (comment: CommentData<TUser, TMeta, TResource>) => void;
+    cancelComposerMode: () => void;
+    submit: (values: CommentFormValues<TResource>) => void;
+    deleteComment: (id: string) => void;
+    /** Imperative reset — bumps `resetKey` so the composer clears itself. */
+    resetComposer: () => void;
+    /** Helpers exposed to onSubmit/onUpdate. */
+    helpers: CommentSubmitHelpers;
+}
+export declare function useComments<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string>(options?: UseCommentsOptions<TUser, TMeta, TResource>): UseCommentsReturn<TUser, TMeta, TResource>;
+//# sourceMappingURL=use-comments.d.ts.map

package/dist/components/features/comments/hooks/use-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-comments.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/comments/hooks/use-comments.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACR,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,cAAc,EACjB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,YAAY,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,IACpD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,WAAW,kBAAkB,CAC/B,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM;IAEjC,QAAQ,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/D,QAAQ,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/D,QAAQ,CAAC,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,iBAAiB,CAC9B,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM;IAEjC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;IACpE,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;IACnE,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAE/B,MAAM,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IACvD,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC,yEAAyE;IACzE,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,4CAA4C;IAC5C,OAAO,EAAE,oBAAoB,CAAC;CACjC;AAED,wBAAgB,WAAW,CACvB,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM,EAEjC,OAAO,GAAE,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAM,GAC1D,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAoG5C"}

package/dist/components/features/comments/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../_shared/comments-BbTYFzx6.cjs`),t=require(`../../../_shared/mentions-DVCjaO_z.cjs`);exports.CommentAttachmentChip=e.f,exports.CommentComposer=e.l,exports.CommentContent=e.o,exports.CommentEmpty=e.c,exports.CommentItem=e.a,exports.CommentReferenceChip=t.l,exports.CommentTimeline=e.i,exports.Comments=e.n,exports.CommentsCard=e.r,exports.defaultCommentsStrings=e.h,exports.interpolateString=e.g,exports.makeReplyEyebrow=e.u,exports.renderCommentContent=e.s,exports.useAttachmentUpload=e.d,exports.useComments=e.t,exports.useReferencePicker=t.f,exports.useResolvedAccessors=e.p,exports.useResolvedStrings=e.m;

package/dist/components/features/comments/index.d.ts

@@ -0,0 +1,9 @@
+export { Comments, CommentsCard } from './comments';
+export { useResolvedAccessors, useResolvedStrings, } from './comments-provider';
+export { CommentItem, CommentTimeline, CommentComposer, CommentContent, renderCommentContent, CommentAttachmentChip, CommentReferenceChip, CommentEmpty, makeReplyEyebrow, } from './partials';
+export type { CommentAttachmentChipProps, CommentReferenceChipProps, CommentEmptyProps, CommentComposerHandle, } from './partials';
+export { useAttachmentUpload, useReferencePicker, useComments, } from './hooks';
+export type { UseAttachmentUploadOptions, UseAttachmentUploadReturn, UseReferencePickerOptions, UseReferencePickerReturn, UseCommentsOptions, UseCommentsReturn, ComposerMode, } from './hooks';
+export { defaultCommentsStrings, interpolateString, type CommentsStrings, } from './comments.strings';
+export type { CommentableContext, CommentAttachment, CommentAttachmentStatus, CommentAttachmentUploadContext, CommentComposerProps, CommentContentType, CommentData, CommentFormValues, CommentItemProps, CommentMedia, CommentReaction, CommentReference, CommentRenderItemContext, CommentResourceSuggestion, CommentResourceType, CommentSubmitHelpers, CommentTimelineProps, CommentTone, CommentUser, CommentsAccessors, CommentsAttachmentsConfig, CommentsCardProps, CommentsComposerPosition, CommentsConfig, CommentsProps, CommentsSlots, } from './comments.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/features/comments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/features/comments/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIpD,OAAO,EACH,oBAAoB,EACpB,kBAAkB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACH,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACR,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,GACd,MAAM,SAAS,CAAC;AACjB,YAAY,EACR,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EACH,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,eAAe,GACvB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACR,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,8BAA8B,EAC9B,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,yBAAyB,EACzB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,aAAa,EACb,aAAa,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/components/features/comments/index.js

@@ -0,0 +1,3 @@
+import { a as e, c as t, d as n, f as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "../../../_shared/comments-BOFU1GYY.js";
+import { f as g, l as _ } from "../../../_shared/mentions-DzG8mX5H.js";
+export { r as CommentAttachmentChip, s as CommentComposer, u as CommentContent, t as CommentEmpty, e as CommentItem, _ as CommentReferenceChip, o as CommentTimeline, l as Comments, f as CommentsCard, a as defaultCommentsStrings, i as interpolateString, h as makeReplyEyebrow, p as renderCommentContent, n as useAttachmentUpload, m as useComments, g as useReferencePicker, d as useResolvedAccessors, c as useResolvedStrings };

package/dist/components/features/comments/partials/comment-attachment-chip.d.ts

@@ -0,0 +1,17 @@
+import { FC } from 'react';
+import { CommentAttachment, CommentsAccessors } from '../comments.types';
+import { CommentsStrings } from '../comments.strings';
+export interface CommentAttachmentChipProps {
+    attachment: CommentAttachment;
+    /** Editable mode shows a remove button. */
+    editable?: boolean;
+    onRemove?: (id: string) => void;
+    onRetry?: (id: string) => void;
+    accessors?: CommentsAccessors;
+    strings?: Partial<CommentsStrings>;
+    /** Compact chips have smaller text and tighter padding. */
+    compact?: boolean;
+    className?: string;
+}
+export declare const CommentAttachmentChip: FC<CommentAttachmentChipProps>;
+//# sourceMappingURL=comment-attachment-chip.d.ts.map

package/dist/components/features/comments/partials/comment-attachment-chip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-attachment-chip.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/comments/partials/comment-attachment-chip.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAKhC,OAAO,KAAK,EACR,iBAAiB,EACjB,iBAAiB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEH,KAAK,eAAe,EACvB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,0BAA0B;IACvC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAiBD,eAAO,MAAM,qBAAqB,EAAE,EAAE,CAAC,0BAA0B,CAyIhE,CAAC"}

package/dist/components/features/comments/partials/comment-composer.d.ts

@@ -0,0 +1,11 @@
+import { CommentComposerProps } from '../comments.types';
+export interface CommentComposerHandle {
+    focus(): void;
+    clear(): void;
+    /** Imperatively set the draft body. */
+    setBody(html: string): void;
+}
+export declare const CommentComposer: import('react').ForwardRefExoticComponent<CommentComposerProps<string> & import('react').RefAttributes<CommentComposerHandle>>;
+/** Helper export for templated reply eyebrow. */
+export declare function makeReplyEyebrow(template: string, name?: string): string;
+//# sourceMappingURL=comment-composer.d.ts.map

package/dist/components/features/comments/partials/comment-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-composer.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/comments/partials/comment-composer.tsx"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EACR,oBAAoB,EAEvB,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,qBAAqB;IAClC,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;IACd,uCAAuC;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAQD,eAAO,MAAM,eAAe,gIAwV1B,CAAC;AAkCH,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/dist/components/features/comments/partials/comment-content.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { CommentData, CommentUser, CommentsConfig, CommentsSlots } from '../comments.types';
+interface CommentContentProps<TResource extends string = string> {
+    comment: CommentData<CommentUser, unknown, TResource>;
+    /** Resource registry — passed through to `<MentionContent>`. */
+    resources?: CommentsConfig<CommentUser, unknown, TResource>['resources'];
+    renderReference?: CommentsSlots<CommentUser, unknown, TResource>['renderReference'];
+    /** Optional sanitizer applied to HTML before rendering. */
+    sanitizer?: (html: string) => string;
+}
+/**
+ * `renderCommentContent` — backwards-compatible export that renders only
+ * the comment body text (no references resolution). Use the
+ * `<CommentContent>` component below for the full feature surface.
+ */
+export declare function renderCommentContent<TResource extends string = string>(comment: CommentData<CommentUser, unknown, TResource>): ReactNode;
+export declare function CommentContent<TResource extends string = string>(props: CommentContentProps<TResource>): ReactNode;
+export {};
+//# sourceMappingURL=comment-content.d.ts.map

package/dist/components/features/comments/partials/comment-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-content.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/comments/partials/comment-content.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,OAAO,KAAK,EACR,WAAW,EACX,WAAW,EACX,cAAc,EACd,aAAa,EAChB,MAAM,mBAAmB,CAAC;AAE3B,UAAU,mBAAmB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAC3D,OAAO,EAAE,WAAW,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACtD,gEAAgE;IAChE,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,eAAe,CAAC,EAAE,aAAa,CAC3B,WAAW,EACX,OAAO,EACP,SAAS,CACZ,CAAC,iBAAiB,CAAC,CAAC;IACrB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EAClE,OAAO,EAAE,WAAW,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,GACtD,SAAS,CAEX;AAED,wBAAgB,cAAc,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EAC5D,KAAK,EAAE,mBAAmB,CAAC,SAAS,CAAC,GACtC,SAAS,CA8BX"}

package/dist/components/features/comments/partials/comment-empty.d.ts

@@ -0,0 +1,9 @@
+import { FC, ReactNode } from 'react';
+import { CommentsStrings } from '../comments.strings';
+export interface CommentEmptyProps {
+    strings?: Partial<CommentsStrings>;
+    icon?: ReactNode;
+    className?: string;
+}
+export declare const CommentEmpty: FC<CommentEmptyProps>;
+//# sourceMappingURL=comment-empty.d.ts.map

package/dist/components/features/comments/partials/comment-empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-empty.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/comments/partials/comment-empty.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAM3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CA6B9C,CAAC"}

package/dist/components/features/comments/partials/comment-item.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { CommentItemProps } from '../comments.types';
+export declare const CommentItem: <TResource extends string = string>(props: CommentItemProps<import('../comments.types').CommentUser, unknown, TResource>) => ReturnType<FC>;
+//# sourceMappingURL=comment-item.d.ts.map

package/dist/components/features/comments/partials/comment-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-item.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/comments/partials/comment-item.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAuBhC,OAAO,KAAK,EAER,gBAAgB,EACnB,MAAM,mBAAmB,CAAC;AAkB3B,eAAO,MAAM,WAAW,EA0TlB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EACpC,KAAK,EAAE,gBAAgB,CAAC,OAAO,mBAAmB,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,KACnF,UAAU,CAAC,EAAE,CAAC,CAAC"}

package/dist/components/features/comments/partials/comment-timeline.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+import { CommentTimelineProps, CommentUser } from '../comments.types';
+export declare const CommentTimeline: <TResource extends string = string>(props: CommentTimelineProps<CommentUser, unknown, TResource>) => ReturnType<FC>;
+//# sourceMappingURL=comment-timeline.d.ts.map

package/dist/components/features/comments/partials/comment-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-timeline.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/comments/partials/comment-timeline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAI3E,eAAO,MAAM,eAAe,EAuEvB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EACnC,KAAK,EAAE,oBAAoB,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,KAC3D,UAAU,CAAC,EAAE,CAAC,CAAC"}

package/dist/components/features/comments/partials/index.d.ts

@@ -0,0 +1,10 @@
+export { CommentItem } from './comment-item';
+export { CommentTimeline } from './comment-timeline';
+export { CommentComposer, type CommentComposerHandle, makeReplyEyebrow, } from './comment-composer';
+export { CommentContent, renderCommentContent } from './comment-content';
+export { CommentAttachmentChip } from './comment-attachment-chip';
+export type { CommentAttachmentChipProps } from './comment-attachment-chip';
+export { CommentEmpty } from './comment-empty';
+export type { CommentEmptyProps } from './comment-empty';
+export { MentionChip as CommentReferenceChip, type MentionChipProps as CommentReferenceChipProps, } from '../../mentions';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/features/comments/partials/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/comments/partials/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACH,eAAe,EACf,KAAK,qBAAqB,EAC1B,gBAAgB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKzD,OAAO,EACH,WAAW,IAAI,oBAAoB,EACnC,KAAK,gBAAgB,IAAI,yBAAyB,GACrD,MAAM,gCAAgC,CAAC"}

package/dist/components/features/event-log/event-log.d.ts

@@ -0,0 +1,9 @@
+import { FC } from 'react';
+import { CommentUser } from '../comments';
+import { EventLogProps } from './event-log.types';
+export declare function EventLog<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string>(props: EventLogProps<TUser, TMeta, TResource>): import("react/jsx-runtime").JSX.Element;
+export declare namespace EventLog {
+    var displayName: string;
+}
+export declare const EventLogComponent: FC<EventLogProps>;
+//# sourceMappingURL=event-log.d.ts.map

package/dist/components/features/event-log/event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../../../src/components/features/event-log/event-log.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,EAAE,EAAa,MAAM,OAAO,CAAC;AAM3C,OAAO,EAMH,KAAK,WAAW,EACnB,MAAM,gCAAgC,CAAC;AAIxC,OAAO,KAAK,EAER,aAAa,EAEhB,MAAM,mBAAmB,CAAC;AA+C3B,wBAAgB,QAAQ,CACpB,KAAK,SAAS,WAAW,GAAG,WAAW,EACvC,KAAK,GAAG,OAAO,EACf,SAAS,SAAS,MAAM,GAAG,MAAM,EACnC,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,2CAiK9C;yBArKe,QAAQ;;;AAyKxB,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,aAAa,CAE/C,CAAC"}

package/dist/components/features/event-log/event-log.strings.d.ts

@@ -0,0 +1,18 @@
+/**
+ * EventLog strings — i18n surface for the timeline shell. The bulk of
+ * user-facing copy in EventLog comes from downstream features
+ * (`CommentsStrings`, `MentionsConfig`); the strings here cover the
+ * timeline-level chrome only (list aria label, future load-more / empty
+ * states). Adding the file now so a future copy addition lands as a
+ * non-breaking change rather than expanding the props surface.
+ */
+export interface EventLogStrings {
+    /** aria-label for the `<ul>` that wraps event rows. Matters for
+     *  screen readers landing in the middle of a long timeline. */
+    listAriaLabel: string;
+    /** Empty-state message when `entries` is empty and no composer is
+     *  configured. */
+    emptyMessage: string;
+}
+export declare const defaultEventLogStrings: EventLogStrings;
+//# sourceMappingURL=event-log.strings.d.ts.map

package/dist/components/features/event-log/event-log.strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.strings.d.ts","sourceRoot":"","sources":["../../../../src/components/features/event-log/event-log.strings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC5B;mEAC+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB;sBACkB;IAClB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,sBAAsB,EAAE,eAGpC,CAAC"}