@nice2dev/social 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to **@nice2dev/social** will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] — 2025-06-01
+
+### Added
+- `NiceComments` — threaded comments with replies, reactions, and moderation
+- `NiceRatings` — star/emoji/score ratings with aggregation
+- `NiceSocialPanel` — likes, shares, and bookmarks panel
+- `NiceTagCloud` — weighted tag cloud with click handling
+- `NiceUserList` — user list with avatars, status, and filtering
+- `NiceWiki` — wiki module with page tree, content viewer/editor
+- `NiceActivityFeed` — chronological activity stream

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NiceToDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @nice2dev/social
+
+Social & community components for React applications — comments, ratings, activity feeds, tag clouds, user lists, and a wiki module.
+
+[![npm](https://img.shields.io/npm/v/@nice2dev/social)](https://www.npmjs.com/package/@nice2dev/social)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+---
+
+## Installation
+
+```bash
+npm install @nice2dev/social
+```
+
+**Peer dependencies:** `react >= 17.0.0`, `react-dom >= 17.0.0`
+
+## Components
+
+| Component | Description |
+|---|---|
+| `NiceComments` | Threaded comments with replies, reactions, and moderation |
+| `NiceRatings` | Star/emoji/score ratings with aggregation display |
+| `NiceSocialPanel` | Likes, shares, and bookmarks action panel |
+| `NiceTagCloud` | Weighted tag cloud with click handling |
+| `NiceUserList` | User list with avatars, online status, and filtering |
+| `NiceWiki` | Wiki module with page tree sidebar and content viewer/editor |
+| `NiceActivityFeed` | Chronological activity feed with grouping |
+
+## Usage
+
+```tsx
+import { NiceComments, NiceRatings, NiceActivityFeed } from '@nice2dev/social';
+
+function CommunityPage({ entityId }) {
+  return (
+    <>
+      <NiceRatings entityId={entityId} mode="stars" />
+      <NiceComments threadId={entityId} allowReplies />
+      <NiceActivityFeed entityId={entityId} />
+    </>
+  );
+}
+```
+
+## Types
+
+Key TypeScript types exported: `CommentEntry`, `RatingMode`, `RatingAggregation`, `SocialStats`, `TagEntry`, `UserEntry`, `WikiPage`, `ActivityEvent`.
+
+## License
+
+MIT © NiceToDev

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),l=require("react"),O=l.forwardRef(function(T,E){const{comments:m,currentUserId:n,onSubmit:o,onEdit:h,onDelete:p,onReact:r,readOnly:y=!1,maxDepth:S=4,reactions:C=["👍","❤️","😂","😮","😢"],placeholder:j="Write a comment…",className:b,style:k}=T,[x,s]=l.useState(""),[u,f]=l.useState(null),[t,i]=l.useState(""),[c,a]=l.useState(null),[g,M]=l.useState(""),L=new Map;for(const d of m){const I=d.parentId??"__root__";L.has(I)||L.set(I,[]),L.get(I).push(d)}const R=l.useCallback(()=>{!x.trim()||!o||(o(x.trim()),s(""))},[x,o]),P=l.useCallback(()=>{!t.trim()||!o||!u||(o(t.trim(),u),i(""),f(null))},[t,u,o]),w=l.useCallback(()=>{!c||!g.trim()||!h||(h(c,g.trim()),a(null),M(""))},[c,g,h]),$=(d,I)=>{const F=n&&d.authorId===n,_=L.get(d.id)??[];return e.jsxs("div",{className:"nice-comments__item",style:{marginLeft:I*24},children:[e.jsxs("div",{className:"nice-comments__header",children:[d.authorAvatarUrl&&e.jsx("img",{src:d.authorAvatarUrl,alt:"",className:"nice-comments__avatar"}),e.jsx("strong",{className:"nice-comments__author",children:d.authorName}),e.jsx("time",{className:"nice-comments__time",children:d.createdAt}),d.isEdited&&e.jsx("span",{className:"nice-comments__edited",children:"(edited)"})]}),c===d.id?e.jsxs("div",{className:"nice-comments__edit-form",children:[e.jsx("textarea",{value:g,onChange:N=>M(N.target.value)}),e.jsx("button",{onClick:w,children:"Save"}),e.jsx("button",{onClick:()=>a(null),children:"Cancel"})]}):e.jsx("p",{className:"nice-comments__content",children:d.isDeleted?e.jsx("em",{children:"Comment deleted"}):d.content}),!d.isDeleted&&d.reactions&&e.jsx("div",{className:"nice-comments__reactions",children:Object.entries(d.reactions).map(([N,v])=>e.jsxs("button",{className:"nice-comments__reaction",onClick:()=>r==null?void 0:r(d.id,N),children:[N," ",v]},N))}),!d.isDeleted&&!y&&e.jsxs("div",{className:"nice-comments__actions",children:[r&&C.map(N=>e.jsx("button",{onClick:()=>r(d.id,N),title:N,children:N},N)),I<S&&e.jsx("button",{onClick:()=>{f(d.id),i("")},children:"Reply"}),F&&h&&e.jsx("button",{onClick:()=>{a(d.id),M(d.content)},children:"Edit"}),F&&p&&e.jsx("button",{onClick:()=>p(d.id),children:"Delete"})]}),u===d.id&&e.jsxs("div",{className:"nice-comments__reply-form",children:[e.jsx("textarea",{value:t,onChange:N=>i(N.target.value),placeholder:"Write a reply…"}),e.jsx("button",{onClick:P,disabled:!t.trim(),children:"Send"}),e.jsx("button",{onClick:()=>f(null),children:"Cancel"})]}),_.map(N=>$(N,I+1))]},d.id)},D=L.get("__root__")??[];return e.jsxs("div",{ref:E,className:`nice-comments ${b??""}`,style:k,children:[!y&&e.jsxs("div",{className:"nice-comments__new",children:[e.jsx("textarea",{value:x,onChange:d=>s(d.target.value),placeholder:j}),e.jsx("button",{onClick:R,disabled:!x.trim(),children:"Post"})]}),D.length===0?e.jsx("p",{className:"nice-comments__empty",children:"No comments yet."}):D.map(d=>$(d,0))]})}),z="☆",B="★",K="♡",H="♥",q=l.forwardRef(function(T,E){const{value:m,max:n=5,mode:o="stars",aggregation:h,onChange:p,readOnly:r=!1,size:y="md",showValue:S=!1,label:C,emojiSet:j=["😢","😕","😐","🙂","😍"],className:b,style:k}=T,[x,s]=l.useState(null),u=x!==null?x+1:m??0,f=l.useCallback(c=>{r||!p||p(c+1)},[r,p]),t=()=>{const c=[];for(let a=0;a<n;a++){const g=a<u;let M;o==="emoji"?M=j[a]??j[j.length-1]:o==="hearts"?M=g?H:K:o==="thumbs"?M=g?"👍":"👎":M=g?B:z,c.push(e.jsx("span",{className:`nice-ratings__symbol ${g?"nice-ratings__symbol--active":""}`,onClick:()=>f(a),onMouseEnter:()=>!r&&s(a),onMouseLeave:()=>!r&&s(null),role:r?void 0:"button",tabIndex:r?void 0:0,onKeyDown:L=>{(L.key==="Enter"||L.key===" ")&&f(a)},children:M},a))}return c},i=()=>e.jsxs("div",{className:"nice-ratings__numeric",children:[e.jsx("input",{type:"number",min:0,max:n,step:.5,value:m??0,onChange:c=>p==null?void 0:p(parseFloat(c.target.value)||0),readOnly:r,className:"nice-ratings__numeric-input"}),e.jsxs("span",{className:"nice-ratings__numeric-max",children:["/ ",n]})]});return e.jsxs("div",{ref:E,className:`nice-ratings nice-ratings--${y} nice-ratings--${o} ${r?"nice-ratings--readonly":""} ${b??""}`,style:k,children:[C&&e.jsx("span",{className:"nice-ratings__label",children:C}),e.jsxs("div",{className:"nice-ratings__body",children:[o==="numeric"?i():t(),S&&o!=="numeric"&&e.jsxs("span",{className:"nice-ratings__value",children:[u," / ",n]})]}),h&&e.jsxs("div",{className:"nice-ratings__aggregation",children:[e.jsx("span",{className:"nice-ratings__avg",children:h.average.toFixed(1)}),e.jsxs("span",{className:"nice-ratings__count",children:["(",h.count," ratings)"]}),h.distribution&&e.jsx("div",{className:"nice-ratings__distribution",children:Object.entries(h.distribution).sort(([c],[a])=>+a-+c).map(([c,a])=>e.jsxs("div",{className:"nice-ratings__distribution-row",children:[e.jsx("span",{children:c}),e.jsx("div",{className:"nice-ratings__bar",children:e.jsx("div",{className:"nice-ratings__bar-fill",style:{width:`${h.count?a/h.count*100:0}%`}})}),e.jsx("span",{children:a})]},c))})]})]})}),V=l.forwardRef(function(T,E){const{stats:m,userState:n,onLike:o,onShare:h,onBookmark:p,direction:r="horizontal",size:y="md",showCounts:S=!0,showLabels:C=!1,className:j,style:b}=T,k=l.useCallback(s=>s>=1e6?(s/1e6).toFixed(1)+"M":s>=1e3?(s/1e3).toFixed(1)+"K":s.toString(),[]),x=[{key:"like",icon:"♡",activeIcon:"♥",label:"Like",count:m.likes,isActive:(n==null?void 0:n.liked)??!1,onClick:o},{key:"share",icon:"↗",activeIcon:"↗",label:"Share",count:m.shares,isActive:(n==null?void 0:n.shared)??!1,onClick:h},{key:"bookmark",icon:"☆",activeIcon:"★",label:"Bookmark",count:m.bookmarks,isActive:(n==null?void 0:n.bookmarked)??!1,onClick:p}];return e.jsx("div",{ref:E,className:`nice-social-panel nice-social-panel--${r} nice-social-panel--${y} ${j??""}`,style:b,children:x.map(s=>e.jsxs("button",{className:`nice-social-panel__btn nice-social-panel__btn--${s.key} ${s.isActive?"nice-social-panel__btn--active":""}`,onClick:s.onClick,title:s.label,children:[e.jsx("span",{className:"nice-social-panel__icon",children:s.isActive?s.activeIcon:s.icon}),C&&e.jsx("span",{className:"nice-social-panel__label",children:s.label}),S&&e.jsx("span",{className:"nice-social-panel__count",children:k(s.count)})]},s.key))})}),Y=l.forwardRef(function(T,E){const{tags:m,onTagClick:n,minFontSize:o=12,maxFontSize:h=36,sortBy:p="weight",maxTags:r,selectedIds:y,className:S,style:C}=T,j=l.useMemo(()=>{let s=[...m];if(p==="weight")s.sort((u,f)=>f.weight-u.weight);else if(p==="alphabetical")s.sort((u,f)=>u.label.localeCompare(f.label));else for(let u=s.length-1;u>0;u--){const f=Math.floor(Math.random()*(u+1));[s[u],s[f]]=[s[f],s[u]]}return r&&s.length>r&&(s=s.slice(0,r)),s},[m,p,r]),{minW:b,maxW:k}=l.useMemo(()=>{if(j.length===0)return{minW:0,maxW:1};const s=j.map(u=>u.weight);return{minW:Math.min(...s),maxW:Math.max(...s)}},[j]),x=s=>{if(k===b)return(o+h)/2;const u=(s-b)/(k-b);return o+u*(h-o)};return e.jsx("div",{ref:E,className:`nice-tag-cloud ${S??""}`,style:C,children:j.length===0?e.jsx("p",{className:"nice-tag-cloud__empty",children:"No tags."}):j.map(s=>{const u=y==null?void 0:y.includes(s.id),f=x(s.weight);return e.jsx("span",{className:`nice-tag-cloud__tag ${u?"nice-tag-cloud__tag--selected":""}`,style:{fontSize:f,color:s.color,cursor:n?"pointer":void 0},onClick:()=>n==null?void 0:n(s),role:n?"button":void 0,tabIndex:n?0:void 0,onKeyDown:t=>{(t.key==="Enter"||t.key===" ")&&n&&n(s)},title:`${s.label} (${s.weight})`,children:s.label},s.id)})})}),G={online:"#22c55e",away:"#eab308",busy:"#ef4444",offline:"#9ca3af"},J=l.forwardRef(function(T,E){const{users:m,onUserClick:n,onAction:o,actions:h=[],searchable:p=!1,statusFilter:r,showStatus:y=!0,layout:S="list",groupByRole:C=!1,className:j,style:b}=T,[k,x]=l.useState(""),s=l.useMemo(()=>{let t=m;if(r&&r.length>0&&(t=t.filter(i=>i.status&&r.includes(i.status))),k.trim()){const i=k.toLowerCase();t=t.filter(c=>{var a,g;return c.name.toLowerCase().includes(i)||((a=c.email)==null?void 0:a.toLowerCase().includes(i))||((g=c.role)==null?void 0:g.toLowerCase().includes(i))})}return t},[m,r,k]),u=l.useMemo(()=>{if(!C)return{"":s};const t={};for(const i of s){const c=i.role??"Other";t[c]||(t[c]=[]),t[c].push(i)}return t},[s,C]),f=t=>e.jsxs("div",{className:`nice-user-list__item nice-user-list__item--${S}`,onClick:()=>n==null?void 0:n(t),role:n?"button":void 0,tabIndex:n?0:void 0,onKeyDown:i=>{i.key==="Enter"&&n&&n(t)},children:[e.jsxs("div",{className:"nice-user-list__avatar-wrap",children:[t.avatarUrl?e.jsx("img",{src:t.avatarUrl,alt:t.name,className:"nice-user-list__avatar"}):e.jsx("span",{className:"nice-user-list__avatar-placeholder",children:t.name.charAt(0).toUpperCase()}),y&&t.status&&e.jsx("span",{className:"nice-user-list__status-dot",style:{backgroundColor:G[t.status]},title:t.status})]}),e.jsxs("div",{className:"nice-user-list__info",children:[e.jsx("span",{className:"nice-user-list__name",children:t.name}),t.email&&e.jsx("span",{className:"nice-user-list__email",children:t.email}),t.role&&e.jsx("span",{className:"nice-user-list__role",children:t.role})]}),h.length>0&&e.jsx("div",{className:"nice-user-list__actions",children:h.map(i=>e.jsx("button",{className:"nice-user-list__action-btn",onClick:c=>{c.stopPropagation(),o==null||o(t,i)},children:i},i))})]},t.id);return e.jsxs("div",{ref:E,className:`nice-user-list nice-user-list--${S} ${j??""}`,style:b,children:[p&&e.jsx("input",{type:"text",value:k,onChange:t=>x(t.target.value),placeholder:"Search users…",className:"nice-user-list__search"}),s.length===0?e.jsx("p",{className:"nice-user-list__empty",children:"No users found."}):Object.entries(u).map(([t,i])=>e.jsxs("div",{className:"nice-user-list__group",children:[C&&t&&e.jsxs("h4",{className:"nice-user-list__group-title",children:[t," (",i.length,")"]}),i.map(f)]},t))]})}),Q=l.forwardRef(function(T,E){const{pages:m,selectedPageId:n,onSelectPage:o,onSavePage:h,onDeletePage:p,onCreatePage:r,editable:y=!1,searchable:S=!0,renderHtml:C=!1,sidebarWidth:j=260,className:b,style:k}=T,[x,s]=l.useState(""),[u,f]=l.useState(!1),[t,i]=l.useState(""),[c,a]=l.useState(""),[g,M]=l.useState(""),[L,R]=l.useState(!1),P=l.useMemo(()=>{if(m.some(v=>v.children&&v.children.length>0))return m.filter(v=>!v.parentId);const _=new Map;for(const v of m)_.set(v.id,{...v,children:[]});const N=[];for(const v of _.values())v.parentId&&_.has(v.parentId)?_.get(v.parentId).children.push(v):N.push(v);return N},[m]),w=l.useMemo(()=>m.find(_=>_.id===n),[m,n]),$=l.useMemo(()=>{if(!x.trim())return P;const _=x.toLowerCase(),N=new Set(m.filter(v=>v.title.toLowerCase().includes(_)).map(v=>v.id));return m.filter(v=>N.has(v.id))},[P,m,x]),D=l.useCallback(()=>{w&&(i(w.title),a(w.content??""),f(!0))},[w]),d=l.useCallback(()=>{!w||!h||(h(w.id,c,t),f(!1))},[w,c,t,h]),I=l.useCallback(()=>{!g.trim()||!r||(r(n??null,g.trim()),M(""),R(!1))},[g,n,r]),F=(_,N=0)=>{var v;return e.jsxs("div",{children:[e.jsx("div",{className:`nice-wiki__page-item ${_.id===n?"nice-wiki__page-item--active":""}`,style:{paddingLeft:12+N*16},onClick:()=>o==null?void 0:o(_),role:"button",tabIndex:0,onKeyDown:W=>{W.key==="Enter"&&(o==null||o(_))},children:_.title}),(v=_.children)==null?void 0:v.map(W=>F(W,N+1))]},_.id)};return e.jsxs("div",{ref:E,className:`nice-wiki ${b??""}`,style:{display:"flex",...k},children:[e.jsxs("div",{className:"nice-wiki__sidebar",style:{width:j,minWidth:j},children:[e.jsxs("div",{className:"nice-wiki__sidebar-header",children:[e.jsx("strong",{children:"Wiki"}),y&&r&&e.jsx("button",{onClick:()=>R(!L),title:"New page",children:"+"})]}),L&&e.jsxs("div",{className:"nice-wiki__new-page",children:[e.jsx("input",{type:"text",value:g,onChange:_=>M(_.target.value),placeholder:"New page title"}),e.jsx("button",{onClick:I,disabled:!g.trim(),children:"Create"})]}),S&&e.jsx("input",{type:"text",className:"nice-wiki__search",value:x,onChange:_=>s(_.target.value),placeholder:"Search pages…"}),e.jsx("div",{className:"nice-wiki__tree",children:$.length===0?e.jsx("p",{className:"nice-wiki__empty",children:"No pages."}):$.map(_=>F(_))})]}),e.jsx("div",{className:"nice-wiki__content",children:w?u?e.jsxs("div",{className:"nice-wiki__editor",children:[e.jsx("input",{type:"text",className:"nice-wiki__edit-title",value:t,onChange:_=>i(_.target.value)}),e.jsx("textarea",{className:"nice-wiki__edit-body",value:c,onChange:_=>a(_.target.value),rows:20}),e.jsxs("div",{className:"nice-wiki__edit-actions",children:[e.jsx("button",{onClick:d,children:"Save"}),e.jsx("button",{onClick:()=>f(!1),children:"Cancel"})]})]}):e.jsxs("div",{className:"nice-wiki__viewer",children:[e.jsxs("div",{className:"nice-wiki__viewer-header",children:[e.jsx("h2",{children:w.title}),e.jsxs("div",{className:"nice-wiki__viewer-meta",children:[w.lastEditedBy&&e.jsxs("span",{children:["Edited by ",w.lastEditedBy]}),w.lastEditedAt&&e.jsxs("span",{children:[" on ",w.lastEditedAt]})]}),y&&e.jsxs("div",{className:"nice-wiki__viewer-actions",children:[e.jsx("button",{onClick:D,children:"Edit"}),p&&e.jsx("button",{onClick:()=>p(w.id),children:"Delete"})]})]}),C?e.jsx("div",{className:"nice-wiki__viewer-body",dangerouslySetInnerHTML:{__html:w.content??""}}):e.jsx("div",{className:"nice-wiki__viewer-body",children:w.content??e.jsx("em",{children:"No content."})})]}):e.jsx("div",{className:"nice-wiki__placeholder",children:"Select a page from the sidebar."})})]})}),U={comment:"💬",like:"❤️",share:"↗️",create:"✨",update:"✏️",delete:"🗑️",join:"👋",leave:"🚪",upload:"📎",mention:"@",custom:"📌"},X=l.forwardRef(function(T,E){const{events:m,onEventClick:n,groupByDate:o=!0,typeFilter:h,showFilters:p=!1,maxEvents:r,onLoadMore:y,hasMore:S=!1,className:C,style:j}=T,[b,k]=l.useState(new Set),x=h??(b.size>0?Array.from(b):void 0),s=l.useMemo(()=>{let i=m;if(x&&x.length>0){const c=new Set(x);i=i.filter(a=>c.has(a.type))}return r&&(i=i.slice(0,r)),i},[m,x,r]),u=l.useMemo(()=>{if(!o)return[{label:"",events:s}];const i=new Map;for(const c of s){const a=c.timestamp.slice(0,10);i.has(a)||i.set(a,[]),i.get(a).push(c)}return Array.from(i.entries()).map(([c,a])=>({label:c,events:a}))},[s,o]),f=l.useMemo(()=>{const i=new Set(m.map(c=>c.type));return Array.from(i).sort()},[m]),t=i=>{k(c=>{const a=new Set(c);return a.has(i)?a.delete(i):a.add(i),a})};return e.jsxs("div",{ref:E,className:`nice-activity-feed ${C??""}`,style:j,children:[p&&!h&&e.jsxs("div",{className:"nice-activity-feed__filters",children:[f.map(i=>e.jsxs("button",{className:`nice-activity-feed__filter-chip ${b.has(i)?"nice-activity-feed__filter-chip--active":""}`,onClick:()=>t(i),children:[U[i]," ",i]},i)),b.size>0&&e.jsx("button",{className:"nice-activity-feed__filter-clear",onClick:()=>k(new Set),children:"Clear"})]}),s.length===0?e.jsx("p",{className:"nice-activity-feed__empty",children:"No activity."}):u.map(({label:i,events:c})=>e.jsxs("div",{className:"nice-activity-feed__group",children:[o&&i&&e.jsx("div",{className:"nice-activity-feed__date-label",children:i}),c.map(a=>e.jsxs("div",{className:"nice-activity-feed__event",onClick:()=>n==null?void 0:n(a),role:n?"button":void 0,tabIndex:n?0:void 0,onKeyDown:g=>{g.key==="Enter"&&n&&n(a)},children:[e.jsx("span",{className:"nice-activity-feed__icon",children:U[a.type]}),e.jsxs("div",{className:"nice-activity-feed__body",children:[a.actorAvatarUrl&&e.jsx("img",{src:a.actorAvatarUrl,alt:"",className:"nice-activity-feed__avatar"}),e.jsxs("span",{className:"nice-activity-feed__message",children:[e.jsx("strong",{children:a.actorName})," ",a.message,a.targetLabel&&e.jsxs(e.Fragment,{children:[" ",e.jsx("em",{children:a.targetLabel})]})]}),e.jsx("time",{className:"nice-activity-feed__time",children:a.timestamp})]})]},a.id))]},i||"__all")),S&&y&&e.jsx("button",{className:"nice-activity-feed__load-more",onClick:y,children:"Load more"})]})});exports.NiceActivityFeed=X;exports.NiceComments=O;exports.NiceRatings=q;exports.NiceSocialPanel=V;exports.NiceTagCloud=Y;exports.NiceUserList=J;exports.NiceWiki=Q;

package/dist/index.d.ts

@@ -0,0 +1,298 @@
+import { default as default_2 } from 'react';
+
+/** Single activity event. */
+export declare interface ActivityEvent {
+    id: string;
+    type: ActivityType;
+    actorName: string;
+    actorAvatarUrl?: string;
+    message: string;
+    timestamp: string;
+    targetUrl?: string;
+    targetLabel?: string;
+    metadata?: Record<string, unknown>;
+    group?: string;
+}
+
+/** Activity type. */
+export declare type ActivityType = 'comment' | 'like' | 'share' | 'create' | 'update' | 'delete' | 'join' | 'leave' | 'upload' | 'mention' | 'custom';
+
+/** A single comment. */
+export declare interface CommentEntry {
+    id: string;
+    authorId: string;
+    authorName: string;
+    authorAvatarUrl?: string;
+    content: string;
+    createdAt: string;
+    updatedAt?: string;
+    parentId?: string;
+    reactions?: Record<string, number>;
+    isEdited?: boolean;
+    isDeleted?: boolean;
+}
+
+/**
+ * {@link NiceActivityFeed} — Chronological activity stream with grouping and filtering.
+ */
+export declare const NiceActivityFeed: default_2.ForwardRefExoticComponent<NiceActivityFeedProps & default_2.RefAttributes<HTMLDivElement>>;
+
+/** Props for {@link NiceActivityFeed}. */
+export declare interface NiceActivityFeedProps {
+    /** Activity events (newest first). */
+    events: ActivityEvent[];
+    /** Called when an event is clicked. */
+    onEventClick?: (event: ActivityEvent) => void;
+    /** Group events by date (day). */
+    groupByDate?: boolean;
+    /** Filter by activity types. */
+    typeFilter?: ActivityType[];
+    /** Whether to show filter chips. */
+    showFilters?: boolean;
+    /** Maximum events to display. */
+    maxEvents?: number;
+    /** Called when "load more" is clicked. */
+    onLoadMore?: () => void;
+    /** Whether more events are available. */
+    hasMore?: boolean;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * {@link NiceComments} — Threaded comment section with replies, reactions, and moderation.
+ */
+export declare const NiceComments: default_2.ForwardRefExoticComponent<NiceCommentsProps & default_2.RefAttributes<HTMLDivElement>>;
+
+/** Props for {@link NiceComments}. */
+export declare interface NiceCommentsProps {
+    /** All comments (flat — parentId builds the tree). */
+    comments: CommentEntry[];
+    /** Current user ID (for highlighting own comments). */
+    currentUserId?: string;
+    /** Called when a new comment/reply is submitted. */
+    onSubmit?: (content: string, parentId?: string) => void;
+    /** Called when editing a comment. */
+    onEdit?: (commentId: string, content: string) => void;
+    /** Called when deleting a comment. */
+    onDelete?: (commentId: string) => void;
+    /** Called when adding a reaction. */
+    onReact?: (commentId: string, reaction: string) => void;
+    /** Whether new comments can be posted. */
+    readOnly?: boolean;
+    /** Maximum reply depth. */
+    maxDepth?: number;
+    /** Available reaction emojis. */
+    reactions?: string[];
+    /** Placeholder text for new comment input. */
+    placeholder?: string;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * {@link NiceRatings} — Star/emoji/score rating component with aggregation display.
+ */
+export declare const NiceRatings: default_2.ForwardRefExoticComponent<NiceRatingsProps & default_2.RefAttributes<HTMLDivElement>>;
+
+/** Props for {@link NiceRatings}. */
+export declare interface NiceRatingsProps {
+    /** Current value (0–max). */
+    value?: number;
+    /** Maximum value (default 5). */
+    max?: number;
+    /** Display mode. */
+    mode?: RatingMode;
+    /** Aggregated data to show average/count. */
+    aggregation?: RatingAggregation;
+    /** Called when rating changes. */
+    onChange?: (value: number) => void;
+    /** If true, user can't change the rating. */
+    readOnly?: boolean;
+    /** Size variant. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Show numeric value next to the visual. */
+    showValue?: boolean;
+    /** Label. */
+    label?: string;
+    /** Custom emoji set (for 'emoji' mode). */
+    emojiSet?: string[];
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * {@link NiceSocialPanel} — Likes, shares, and bookmarks action panel.
+ */
+export declare const NiceSocialPanel: default_2.ForwardRefExoticComponent<NiceSocialPanelProps & default_2.RefAttributes<HTMLDivElement>>;
+
+/** Props for {@link NiceSocialPanel}. */
+export declare interface NiceSocialPanelProps {
+    /** Aggregate stats. */
+    stats: SocialStats;
+    /** Current user's action state. */
+    userState?: SocialUserState;
+    /** Called when like is toggled. */
+    onLike?: () => void;
+    /** Called when share is clicked. */
+    onShare?: () => void;
+    /** Called when bookmark is toggled. */
+    onBookmark?: () => void;
+    /** Layout direction. */
+    direction?: 'horizontal' | 'vertical';
+    /** Size variant. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Show counts. */
+    showCounts?: boolean;
+    /** Show labels. */
+    showLabels?: boolean;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * {@link NiceTagCloud} — Weighted tag cloud with click handling and sizing.
+ */
+export declare const NiceTagCloud: default_2.ForwardRefExoticComponent<NiceTagCloudProps & default_2.RefAttributes<HTMLDivElement>>;
+
+/** Props for {@link NiceTagCloud}. */
+export declare interface NiceTagCloudProps {
+    /** Tags with weights. */
+    tags: TagEntry[];
+    /** Called when a tag is clicked. */
+    onTagClick?: (tag: TagEntry) => void;
+    /** Minimum font size in px. */
+    minFontSize?: number;
+    /** Maximum font size in px. */
+    maxFontSize?: number;
+    /** Sort mode. */
+    sortBy?: 'weight' | 'alphabetical' | 'random';
+    /** Maximum number of tags to display. */
+    maxTags?: number;
+    /** Currently selected tag IDs. */
+    selectedIds?: string[];
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * {@link NiceUserList} — User list with avatars, online status, and filtering.
+ */
+export declare const NiceUserList: default_2.ForwardRefExoticComponent<NiceUserListProps & default_2.RefAttributes<HTMLDivElement>>;
+
+/** Props for {@link NiceUserList}. */
+export declare interface NiceUserListProps {
+    /** Users. */
+    users: UserEntry[];
+    /** Called when a user is clicked. */
+    onUserClick?: (user: UserEntry) => void;
+    /** Called for actions (e.g., message, remove). */
+    onAction?: (user: UserEntry, action: string) => void;
+    /** Available actions per user. */
+    actions?: string[];
+    /** Whether to show search input. */
+    searchable?: boolean;
+    /** Filter by online status. */
+    statusFilter?: UserOnlineStatus[];
+    /** Whether to show the status indicator dot. */
+    showStatus?: boolean;
+    /** Render mode. */
+    layout?: 'list' | 'grid';
+    /** Group by role. */
+    groupByRole?: boolean;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * {@link NiceWiki} — Wiki module with page tree sidebar, content viewer/editor.
+ */
+export declare const NiceWiki: default_2.ForwardRefExoticComponent<NiceWikiProps & default_2.RefAttributes<HTMLDivElement>>;
+
+/** Props for {@link NiceWiki}. */
+export declare interface NiceWikiProps {
+    /** All pages (flat or nested via children). */
+    pages: WikiPage[];
+    /** Currently selected page ID. */
+    selectedPageId?: string;
+    /** Called when selecting a page. */
+    onSelectPage?: (page: WikiPage) => void;
+    /** Called to save page content. */
+    onSavePage?: (pageId: string, content: string, title: string) => void;
+    /** Called to create a new page. */
+    onCreatePage?: (parentId: string | null, title: string) => void;
+    /** Called to delete a page. */
+    onDeletePage?: (pageId: string) => void;
+    /** Whether editing is allowed. */
+    editable?: boolean;
+    /** Whether to show search. */
+    searchable?: boolean;
+    /** Render content as HTML (dangerouslySetInnerHTML). */
+    renderHtml?: boolean;
+    /** Sidebar width. */
+    sidebarWidth?: number;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+/** Aggregated rating data. */
+export declare interface RatingAggregation {
+    average: number;
+    count: number;
+    distribution?: Record<number, number>;
+}
+
+/** Rating display mode. */
+export declare type RatingMode = 'stars' | 'hearts' | 'thumbs' | 'numeric' | 'emoji';
+
+/** Social action stats. */
+export declare interface SocialStats {
+    likes: number;
+    shares: number;
+    bookmarks: number;
+}
+
+/** Current user's state for social actions. */
+export declare interface SocialUserState {
+    liked: boolean;
+    shared: boolean;
+    bookmarked: boolean;
+}
+
+/** A weighted tag. */
+export declare interface TagEntry {
+    id: string;
+    label: string;
+    weight: number;
+    color?: string;
+    href?: string;
+}
+
+/** A user entry. */
+export declare interface UserEntry {
+    id: string;
+    name: string;
+    email?: string;
+    avatarUrl?: string;
+    status?: UserOnlineStatus;
+    role?: string;
+    lastSeenAt?: string;
+    extra?: Record<string, string>;
+}
+
+/** User online status. */
+export declare type UserOnlineStatus = 'online' | 'away' | 'busy' | 'offline';
+
+/** Wiki page tree node. */
+export declare interface WikiPage {
+    id: string;
+    title: string;
+    slug: string;
+    parentId?: string;
+    content?: string;
+    lastEditedBy?: string;
+    lastEditedAt?: string;
+    children?: WikiPage[];
+}
+
+export { }

package/dist/index.mjs

@@ -0,0 +1,660 @@
+import { jsxs as c, jsx as e, Fragment as H } from "react/jsx-runtime";
+import { forwardRef as D, useState as T, useCallback as P, useMemo as F } from "react";
+const Z = D(function(I, L) {
+  const {
+    comments: m,
+    currentUserId: a,
+    onSubmit: o,
+    onEdit: _,
+    onDelete: N,
+    onReact: r,
+    readOnly: k = !1,
+    maxDepth: E = 4,
+    reactions: x = ["👍", "❤️", "😂", "😮", "😢"],
+    placeholder: y = "Write a comment…",
+    className: w,
+    style: C
+  } = I, [v, i] = T(""), [h, f] = T(null), [n, t] = T(""), [l, s] = T(null), [b, $] = T(""), A = /* @__PURE__ */ new Map();
+  for (const d of m) {
+    const M = d.parentId ?? "__root__";
+    A.has(M) || A.set(M, []), A.get(M).push(d);
+  }
+  const O = P(() => {
+    !v.trim() || !o || (o(v.trim()), i(""));
+  }, [v, o]), z = P(() => {
+    !n.trim() || !o || !h || (o(n.trim(), h), t(""), f(null));
+  }, [n, h, o]), S = P(() => {
+    !l || !b.trim() || !_ || (_(l, b.trim()), s(null), $(""));
+  }, [l, b, _]), W = (d, M) => {
+    const U = a && d.authorId === a, u = A.get(d.id) ?? [];
+    return /* @__PURE__ */ c("div", { className: "nice-comments__item", style: { marginLeft: M * 24 }, children: [
+      /* @__PURE__ */ c("div", { className: "nice-comments__header", children: [
+        d.authorAvatarUrl && /* @__PURE__ */ e("img", { src: d.authorAvatarUrl, alt: "", className: "nice-comments__avatar" }),
+        /* @__PURE__ */ e("strong", { className: "nice-comments__author", children: d.authorName }),
+        /* @__PURE__ */ e("time", { className: "nice-comments__time", children: d.createdAt }),
+        d.isEdited && /* @__PURE__ */ e("span", { className: "nice-comments__edited", children: "(edited)" })
+      ] }),
+      l === d.id ? /* @__PURE__ */ c("div", { className: "nice-comments__edit-form", children: [
+        /* @__PURE__ */ e("textarea", { value: b, onChange: (g) => $(g.target.value) }),
+        /* @__PURE__ */ e("button", { onClick: S, children: "Save" }),
+        /* @__PURE__ */ e("button", { onClick: () => s(null), children: "Cancel" })
+      ] }) : /* @__PURE__ */ e("p", { className: "nice-comments__content", children: d.isDeleted ? /* @__PURE__ */ e("em", { children: "Comment deleted" }) : d.content }),
+      !d.isDeleted && d.reactions && /* @__PURE__ */ e("div", { className: "nice-comments__reactions", children: Object.entries(d.reactions).map(([g, p]) => /* @__PURE__ */ c(
+        "button",
+        {
+          className: "nice-comments__reaction",
+          onClick: () => r == null ? void 0 : r(d.id, g),
+          children: [
+            g,
+            " ",
+            p
+          ]
+        },
+        g
+      )) }),
+      !d.isDeleted && !k && /* @__PURE__ */ c("div", { className: "nice-comments__actions", children: [
+        r && x.map((g) => /* @__PURE__ */ e("button", { onClick: () => r(d.id, g), title: g, children: g }, g)),
+        M < E && /* @__PURE__ */ e("button", { onClick: () => {
+          f(d.id), t("");
+        }, children: "Reply" }),
+        U && _ && /* @__PURE__ */ e("button", { onClick: () => {
+          s(d.id), $(d.content);
+        }, children: "Edit" }),
+        U && N && /* @__PURE__ */ e("button", { onClick: () => N(d.id), children: "Delete" })
+      ] }),
+      h === d.id && /* @__PURE__ */ c("div", { className: "nice-comments__reply-form", children: [
+        /* @__PURE__ */ e(
+          "textarea",
+          {
+            value: n,
+            onChange: (g) => t(g.target.value),
+            placeholder: "Write a reply…"
+          }
+        ),
+        /* @__PURE__ */ e("button", { onClick: z, disabled: !n.trim(), children: "Send" }),
+        /* @__PURE__ */ e("button", { onClick: () => f(null), children: "Cancel" })
+      ] }),
+      u.map((g) => W(g, M + 1))
+    ] }, d.id);
+  }, j = A.get("__root__") ?? [];
+  return /* @__PURE__ */ c("div", { ref: L, className: `nice-comments ${w ?? ""}`, style: C, children: [
+    !k && /* @__PURE__ */ c("div", { className: "nice-comments__new", children: [
+      /* @__PURE__ */ e(
+        "textarea",
+        {
+          value: v,
+          onChange: (d) => i(d.target.value),
+          placeholder: y
+        }
+      ),
+      /* @__PURE__ */ e("button", { onClick: O, disabled: !v.trim(), children: "Post" })
+    ] }),
+    j.length === 0 ? /* @__PURE__ */ e("p", { className: "nice-comments__empty", children: "No comments yet." }) : j.map((d) => W(d, 0))
+  ] });
+}), V = "☆", Y = "★", q = "♡", G = "♥", ee = D(function(I, L) {
+  const {
+    value: m,
+    max: a = 5,
+    mode: o = "stars",
+    aggregation: _,
+    onChange: N,
+    readOnly: r = !1,
+    size: k = "md",
+    showValue: E = !1,
+    label: x,
+    emojiSet: y = ["😢", "😕", "😐", "🙂", "😍"],
+    className: w,
+    style: C
+  } = I, [v, i] = T(null), h = v !== null ? v + 1 : m ?? 0, f = P((l) => {
+    r || !N || N(l + 1);
+  }, [r, N]), n = () => {
+    const l = [];
+    for (let s = 0; s < a; s++) {
+      const b = s < h;
+      let $;
+      o === "emoji" ? $ = y[s] ?? y[y.length - 1] : o === "hearts" ? $ = b ? G : q : o === "thumbs" ? $ = b ? "👍" : "👎" : $ = b ? Y : V, l.push(
+        /* @__PURE__ */ e(
+          "span",
+          {
+            className: `nice-ratings__symbol ${b ? "nice-ratings__symbol--active" : ""}`,
+            onClick: () => f(s),
+            onMouseEnter: () => !r && i(s),
+            onMouseLeave: () => !r && i(null),
+            role: r ? void 0 : "button",
+            tabIndex: r ? void 0 : 0,
+            onKeyDown: (A) => {
+              (A.key === "Enter" || A.key === " ") && f(s);
+            },
+            children: $
+          },
+          s
+        )
+      );
+    }
+    return l;
+  }, t = () => /* @__PURE__ */ c("div", { className: "nice-ratings__numeric", children: [
+    /* @__PURE__ */ e(
+      "input",
+      {
+        type: "number",
+        min: 0,
+        max: a,
+        step: 0.5,
+        value: m ?? 0,
+        onChange: (l) => N == null ? void 0 : N(parseFloat(l.target.value) || 0),
+        readOnly: r,
+        className: "nice-ratings__numeric-input"
+      }
+    ),
+    /* @__PURE__ */ c("span", { className: "nice-ratings__numeric-max", children: [
+      "/ ",
+      a
+    ] })
+  ] });
+  return /* @__PURE__ */ c(
+    "div",
+    {
+      ref: L,
+      className: `nice-ratings nice-ratings--${k} nice-ratings--${o} ${r ? "nice-ratings--readonly" : ""} ${w ?? ""}`,
+      style: C,
+      children: [
+        x && /* @__PURE__ */ e("span", { className: "nice-ratings__label", children: x }),
+        /* @__PURE__ */ c("div", { className: "nice-ratings__body", children: [
+          o === "numeric" ? t() : n(),
+          E && o !== "numeric" && /* @__PURE__ */ c("span", { className: "nice-ratings__value", children: [
+            h,
+            " / ",
+            a
+          ] })
+        ] }),
+        _ && /* @__PURE__ */ c("div", { className: "nice-ratings__aggregation", children: [
+          /* @__PURE__ */ e("span", { className: "nice-ratings__avg", children: _.average.toFixed(1) }),
+          /* @__PURE__ */ c("span", { className: "nice-ratings__count", children: [
+            "(",
+            _.count,
+            " ratings)"
+          ] }),
+          _.distribution && /* @__PURE__ */ e("div", { className: "nice-ratings__distribution", children: Object.entries(_.distribution).sort(([l], [s]) => +s - +l).map(([l, s]) => /* @__PURE__ */ c("div", { className: "nice-ratings__distribution-row", children: [
+            /* @__PURE__ */ e("span", { children: l }),
+            /* @__PURE__ */ e("div", { className: "nice-ratings__bar", children: /* @__PURE__ */ e(
+              "div",
+              {
+                className: "nice-ratings__bar-fill",
+                style: { width: `${_.count ? s / _.count * 100 : 0}%` }
+              }
+            ) }),
+            /* @__PURE__ */ e("span", { children: s })
+          ] }, l)) })
+        ] })
+      ]
+    }
+  );
+}), ie = D(function(I, L) {
+  const {
+    stats: m,
+    userState: a,
+    onLike: o,
+    onShare: _,
+    onBookmark: N,
+    direction: r = "horizontal",
+    size: k = "md",
+    showCounts: E = !0,
+    showLabels: x = !1,
+    className: y,
+    style: w
+  } = I, C = P((i) => i >= 1e6 ? (i / 1e6).toFixed(1) + "M" : i >= 1e3 ? (i / 1e3).toFixed(1) + "K" : i.toString(), []), v = [
+    {
+      key: "like",
+      icon: "♡",
+      activeIcon: "♥",
+      label: "Like",
+      count: m.likes,
+      isActive: (a == null ? void 0 : a.liked) ?? !1,
+      onClick: o
+    },
+    {
+      key: "share",
+      icon: "↗",
+      activeIcon: "↗",
+      label: "Share",
+      count: m.shares,
+      isActive: (a == null ? void 0 : a.shared) ?? !1,
+      onClick: _
+    },
+    {
+      key: "bookmark",
+      icon: "☆",
+      activeIcon: "★",
+      label: "Bookmark",
+      count: m.bookmarks,
+      isActive: (a == null ? void 0 : a.bookmarked) ?? !1,
+      onClick: N
+    }
+  ];
+  return /* @__PURE__ */ e(
+    "div",
+    {
+      ref: L,
+      className: `nice-social-panel nice-social-panel--${r} nice-social-panel--${k} ${y ?? ""}`,
+      style: w,
+      children: v.map((i) => /* @__PURE__ */ c(
+        "button",
+        {
+          className: `nice-social-panel__btn nice-social-panel__btn--${i.key} ${i.isActive ? "nice-social-panel__btn--active" : ""}`,
+          onClick: i.onClick,
+          title: i.label,
+          children: [
+            /* @__PURE__ */ e("span", { className: "nice-social-panel__icon", children: i.isActive ? i.activeIcon : i.icon }),
+            x && /* @__PURE__ */ e("span", { className: "nice-social-panel__label", children: i.label }),
+            E && /* @__PURE__ */ e("span", { className: "nice-social-panel__count", children: C(i.count) })
+          ]
+        },
+        i.key
+      ))
+    }
+  );
+}), te = D(function(I, L) {
+  const {
+    tags: m,
+    onTagClick: a,
+    minFontSize: o = 12,
+    maxFontSize: _ = 36,
+    sortBy: N = "weight",
+    maxTags: r,
+    selectedIds: k,
+    className: E,
+    style: x
+  } = I, y = F(() => {
+    let i = [...m];
+    if (N === "weight")
+      i.sort((h, f) => f.weight - h.weight);
+    else if (N === "alphabetical")
+      i.sort((h, f) => h.label.localeCompare(f.label));
+    else
+      for (let h = i.length - 1; h > 0; h--) {
+        const f = Math.floor(Math.random() * (h + 1));
+        [i[h], i[f]] = [i[f], i[h]];
+      }
+    return r && i.length > r && (i = i.slice(0, r)), i;
+  }, [m, N, r]), { minW: w, maxW: C } = F(() => {
+    if (y.length === 0) return { minW: 0, maxW: 1 };
+    const i = y.map((h) => h.weight);
+    return { minW: Math.min(...i), maxW: Math.max(...i) };
+  }, [y]), v = (i) => {
+    if (C === w) return (o + _) / 2;
+    const h = (i - w) / (C - w);
+    return o + h * (_ - o);
+  };
+  return /* @__PURE__ */ e("div", { ref: L, className: `nice-tag-cloud ${E ?? ""}`, style: x, children: y.length === 0 ? /* @__PURE__ */ e("p", { className: "nice-tag-cloud__empty", children: "No tags." }) : y.map((i) => {
+    const h = k == null ? void 0 : k.includes(i.id), f = v(i.weight);
+    return /* @__PURE__ */ e(
+      "span",
+      {
+        className: `nice-tag-cloud__tag ${h ? "nice-tag-cloud__tag--selected" : ""}`,
+        style: {
+          fontSize: f,
+          color: i.color,
+          cursor: a ? "pointer" : void 0
+        },
+        onClick: () => a == null ? void 0 : a(i),
+        role: a ? "button" : void 0,
+        tabIndex: a ? 0 : void 0,
+        onKeyDown: (n) => {
+          (n.key === "Enter" || n.key === " ") && a && a(i);
+        },
+        title: `${i.label} (${i.weight})`,
+        children: i.label
+      },
+      i.id
+    );
+  }) });
+}), J = {
+  online: "#22c55e",
+  away: "#eab308",
+  busy: "#ef4444",
+  offline: "#9ca3af"
+}, ne = D(function(I, L) {
+  const {
+    users: m,
+    onUserClick: a,
+    onAction: o,
+    actions: _ = [],
+    searchable: N = !1,
+    statusFilter: r,
+    showStatus: k = !0,
+    layout: E = "list",
+    groupByRole: x = !1,
+    className: y,
+    style: w
+  } = I, [C, v] = T(""), i = F(() => {
+    let n = m;
+    if (r && r.length > 0 && (n = n.filter((t) => t.status && r.includes(t.status))), C.trim()) {
+      const t = C.toLowerCase();
+      n = n.filter(
+        (l) => {
+          var s, b;
+          return l.name.toLowerCase().includes(t) || ((s = l.email) == null ? void 0 : s.toLowerCase().includes(t)) || ((b = l.role) == null ? void 0 : b.toLowerCase().includes(t));
+        }
+      );
+    }
+    return n;
+  }, [m, r, C]), h = F(() => {
+    if (!x) return { "": i };
+    const n = {};
+    for (const t of i) {
+      const l = t.role ?? "Other";
+      n[l] || (n[l] = []), n[l].push(t);
+    }
+    return n;
+  }, [i, x]), f = (n) => /* @__PURE__ */ c(
+    "div",
+    {
+      className: `nice-user-list__item nice-user-list__item--${E}`,
+      onClick: () => a == null ? void 0 : a(n),
+      role: a ? "button" : void 0,
+      tabIndex: a ? 0 : void 0,
+      onKeyDown: (t) => {
+        t.key === "Enter" && a && a(n);
+      },
+      children: [
+        /* @__PURE__ */ c("div", { className: "nice-user-list__avatar-wrap", children: [
+          n.avatarUrl ? /* @__PURE__ */ e("img", { src: n.avatarUrl, alt: n.name, className: "nice-user-list__avatar" }) : /* @__PURE__ */ e("span", { className: "nice-user-list__avatar-placeholder", children: n.name.charAt(0).toUpperCase() }),
+          k && n.status && /* @__PURE__ */ e(
+            "span",
+            {
+              className: "nice-user-list__status-dot",
+              style: { backgroundColor: J[n.status] },
+              title: n.status
+            }
+          )
+        ] }),
+        /* @__PURE__ */ c("div", { className: "nice-user-list__info", children: [
+          /* @__PURE__ */ e("span", { className: "nice-user-list__name", children: n.name }),
+          n.email && /* @__PURE__ */ e("span", { className: "nice-user-list__email", children: n.email }),
+          n.role && /* @__PURE__ */ e("span", { className: "nice-user-list__role", children: n.role })
+        ] }),
+        _.length > 0 && /* @__PURE__ */ e("div", { className: "nice-user-list__actions", children: _.map((t) => /* @__PURE__ */ e(
+          "button",
+          {
+            className: "nice-user-list__action-btn",
+            onClick: (l) => {
+              l.stopPropagation(), o == null || o(n, t);
+            },
+            children: t
+          },
+          t
+        )) })
+      ]
+    },
+    n.id
+  );
+  return /* @__PURE__ */ c("div", { ref: L, className: `nice-user-list nice-user-list--${E} ${y ?? ""}`, style: w, children: [
+    N && /* @__PURE__ */ e(
+      "input",
+      {
+        type: "text",
+        value: C,
+        onChange: (n) => v(n.target.value),
+        placeholder: "Search users…",
+        className: "nice-user-list__search"
+      }
+    ),
+    i.length === 0 ? /* @__PURE__ */ e("p", { className: "nice-user-list__empty", children: "No users found." }) : Object.entries(h).map(([n, t]) => /* @__PURE__ */ c("div", { className: "nice-user-list__group", children: [
+      x && n && /* @__PURE__ */ c("h4", { className: "nice-user-list__group-title", children: [
+        n,
+        " (",
+        t.length,
+        ")"
+      ] }),
+      t.map(f)
+    ] }, n))
+  ] });
+}), ae = D(function(I, L) {
+  const {
+    pages: m,
+    selectedPageId: a,
+    onSelectPage: o,
+    onSavePage: _,
+    onDeletePage: N,
+    onCreatePage: r,
+    editable: k = !1,
+    searchable: E = !0,
+    renderHtml: x = !1,
+    sidebarWidth: y = 260,
+    className: w,
+    style: C
+  } = I, [v, i] = T(""), [h, f] = T(!1), [n, t] = T(""), [l, s] = T(""), [b, $] = T(""), [A, O] = T(!1), z = F(() => {
+    if (m.some((p) => p.children && p.children.length > 0)) return m.filter((p) => !p.parentId);
+    const u = /* @__PURE__ */ new Map();
+    for (const p of m)
+      u.set(p.id, { ...p, children: [] });
+    const g = [];
+    for (const p of u.values())
+      p.parentId && u.has(p.parentId) ? u.get(p.parentId).children.push(p) : g.push(p);
+    return g;
+  }, [m]), S = F(() => m.find((u) => u.id === a), [m, a]), W = F(() => {
+    if (!v.trim()) return z;
+    const u = v.toLowerCase(), g = new Set(m.filter((p) => p.title.toLowerCase().includes(u)).map((p) => p.id));
+    return m.filter((p) => g.has(p.id));
+  }, [z, m, v]), j = P(() => {
+    S && (t(S.title), s(S.content ?? ""), f(!0));
+  }, [S]), d = P(() => {
+    !S || !_ || (_(S.id, l, n), f(!1));
+  }, [S, l, n, _]), M = P(() => {
+    !b.trim() || !r || (r(a ?? null, b.trim()), $(""), O(!1));
+  }, [b, a, r]), U = (u, g = 0) => {
+    var p;
+    return /* @__PURE__ */ c("div", { children: [
+      /* @__PURE__ */ e(
+        "div",
+        {
+          className: `nice-wiki__page-item ${u.id === a ? "nice-wiki__page-item--active" : ""}`,
+          style: { paddingLeft: 12 + g * 16 },
+          onClick: () => o == null ? void 0 : o(u),
+          role: "button",
+          tabIndex: 0,
+          onKeyDown: (B) => {
+            B.key === "Enter" && (o == null || o(u));
+          },
+          children: u.title
+        }
+      ),
+      (p = u.children) == null ? void 0 : p.map((B) => U(B, g + 1))
+    ] }, u.id);
+  };
+  return /* @__PURE__ */ c("div", { ref: L, className: `nice-wiki ${w ?? ""}`, style: { display: "flex", ...C }, children: [
+    /* @__PURE__ */ c("div", { className: "nice-wiki__sidebar", style: { width: y, minWidth: y }, children: [
+      /* @__PURE__ */ c("div", { className: "nice-wiki__sidebar-header", children: [
+        /* @__PURE__ */ e("strong", { children: "Wiki" }),
+        k && r && /* @__PURE__ */ e("button", { onClick: () => O(!A), title: "New page", children: "+" })
+      ] }),
+      A && /* @__PURE__ */ c("div", { className: "nice-wiki__new-page", children: [
+        /* @__PURE__ */ e(
+          "input",
+          {
+            type: "text",
+            value: b,
+            onChange: (u) => $(u.target.value),
+            placeholder: "New page title"
+          }
+        ),
+        /* @__PURE__ */ e("button", { onClick: M, disabled: !b.trim(), children: "Create" })
+      ] }),
+      E && /* @__PURE__ */ e(
+        "input",
+        {
+          type: "text",
+          className: "nice-wiki__search",
+          value: v,
+          onChange: (u) => i(u.target.value),
+          placeholder: "Search pages…"
+        }
+      ),
+      /* @__PURE__ */ e("div", { className: "nice-wiki__tree", children: W.length === 0 ? /* @__PURE__ */ e("p", { className: "nice-wiki__empty", children: "No pages." }) : W.map((u) => U(u)) })
+    ] }),
+    /* @__PURE__ */ e("div", { className: "nice-wiki__content", children: S ? h ? /* @__PURE__ */ c("div", { className: "nice-wiki__editor", children: [
+      /* @__PURE__ */ e(
+        "input",
+        {
+          type: "text",
+          className: "nice-wiki__edit-title",
+          value: n,
+          onChange: (u) => t(u.target.value)
+        }
+      ),
+      /* @__PURE__ */ e(
+        "textarea",
+        {
+          className: "nice-wiki__edit-body",
+          value: l,
+          onChange: (u) => s(u.target.value),
+          rows: 20
+        }
+      ),
+      /* @__PURE__ */ c("div", { className: "nice-wiki__edit-actions", children: [
+        /* @__PURE__ */ e("button", { onClick: d, children: "Save" }),
+        /* @__PURE__ */ e("button", { onClick: () => f(!1), children: "Cancel" })
+      ] })
+    ] }) : /* @__PURE__ */ c("div", { className: "nice-wiki__viewer", children: [
+      /* @__PURE__ */ c("div", { className: "nice-wiki__viewer-header", children: [
+        /* @__PURE__ */ e("h2", { children: S.title }),
+        /* @__PURE__ */ c("div", { className: "nice-wiki__viewer-meta", children: [
+          S.lastEditedBy && /* @__PURE__ */ c("span", { children: [
+            "Edited by ",
+            S.lastEditedBy
+          ] }),
+          S.lastEditedAt && /* @__PURE__ */ c("span", { children: [
+            " on ",
+            S.lastEditedAt
+          ] })
+        ] }),
+        k && /* @__PURE__ */ c("div", { className: "nice-wiki__viewer-actions", children: [
+          /* @__PURE__ */ e("button", { onClick: j, children: "Edit" }),
+          N && /* @__PURE__ */ e("button", { onClick: () => N(S.id), children: "Delete" })
+        ] })
+      ] }),
+      x ? /* @__PURE__ */ e(
+        "div",
+        {
+          className: "nice-wiki__viewer-body",
+          dangerouslySetInnerHTML: { __html: S.content ?? "" }
+        }
+      ) : /* @__PURE__ */ e("div", { className: "nice-wiki__viewer-body", children: S.content ?? /* @__PURE__ */ e("em", { children: "No content." }) })
+    ] }) : /* @__PURE__ */ e("div", { className: "nice-wiki__placeholder", children: "Select a page from the sidebar." }) })
+  ] });
+}), K = {
+  comment: "💬",
+  like: "❤️",
+  share: "↗️",
+  create: "✨",
+  update: "✏️",
+  delete: "🗑️",
+  join: "👋",
+  leave: "🚪",
+  upload: "📎",
+  mention: "@",
+  custom: "📌"
+}, se = D(function(I, L) {
+  const {
+    events: m,
+    onEventClick: a,
+    groupByDate: o = !0,
+    typeFilter: _,
+    showFilters: N = !1,
+    maxEvents: r,
+    onLoadMore: k,
+    hasMore: E = !1,
+    className: x,
+    style: y
+  } = I, [w, C] = T(/* @__PURE__ */ new Set()), v = _ ?? (w.size > 0 ? Array.from(w) : void 0), i = F(() => {
+    let t = m;
+    if (v && v.length > 0) {
+      const l = new Set(v);
+      t = t.filter((s) => l.has(s.type));
+    }
+    return r && (t = t.slice(0, r)), t;
+  }, [m, v, r]), h = F(() => {
+    if (!o) return [{ label: "", events: i }];
+    const t = /* @__PURE__ */ new Map();
+    for (const l of i) {
+      const s = l.timestamp.slice(0, 10);
+      t.has(s) || t.set(s, []), t.get(s).push(l);
+    }
+    return Array.from(t.entries()).map(([l, s]) => ({ label: l, events: s }));
+  }, [i, o]), f = F(() => {
+    const t = new Set(m.map((l) => l.type));
+    return Array.from(t).sort();
+  }, [m]), n = (t) => {
+    C((l) => {
+      const s = new Set(l);
+      return s.has(t) ? s.delete(t) : s.add(t), s;
+    });
+  };
+  return /* @__PURE__ */ c("div", { ref: L, className: `nice-activity-feed ${x ?? ""}`, style: y, children: [
+    N && !_ && /* @__PURE__ */ c("div", { className: "nice-activity-feed__filters", children: [
+      f.map((t) => /* @__PURE__ */ c(
+        "button",
+        {
+          className: `nice-activity-feed__filter-chip ${w.has(t) ? "nice-activity-feed__filter-chip--active" : ""}`,
+          onClick: () => n(t),
+          children: [
+            K[t],
+            " ",
+            t
+          ]
+        },
+        t
+      )),
+      w.size > 0 && /* @__PURE__ */ e(
+        "button",
+        {
+          className: "nice-activity-feed__filter-clear",
+          onClick: () => C(/* @__PURE__ */ new Set()),
+          children: "Clear"
+        }
+      )
+    ] }),
+    i.length === 0 ? /* @__PURE__ */ e("p", { className: "nice-activity-feed__empty", children: "No activity." }) : h.map(({ label: t, events: l }) => /* @__PURE__ */ c("div", { className: "nice-activity-feed__group", children: [
+      o && t && /* @__PURE__ */ e("div", { className: "nice-activity-feed__date-label", children: t }),
+      l.map((s) => /* @__PURE__ */ c(
+        "div",
+        {
+          className: "nice-activity-feed__event",
+          onClick: () => a == null ? void 0 : a(s),
+          role: a ? "button" : void 0,
+          tabIndex: a ? 0 : void 0,
+          onKeyDown: (b) => {
+            b.key === "Enter" && a && a(s);
+          },
+          children: [
+            /* @__PURE__ */ e("span", { className: "nice-activity-feed__icon", children: K[s.type] }),
+            /* @__PURE__ */ c("div", { className: "nice-activity-feed__body", children: [
+              s.actorAvatarUrl && /* @__PURE__ */ e("img", { src: s.actorAvatarUrl, alt: "", className: "nice-activity-feed__avatar" }),
+              /* @__PURE__ */ c("span", { className: "nice-activity-feed__message", children: [
+                /* @__PURE__ */ e("strong", { children: s.actorName }),
+                " ",
+                s.message,
+                s.targetLabel && /* @__PURE__ */ c(H, { children: [
+                  " ",
+                  /* @__PURE__ */ e("em", { children: s.targetLabel })
+                ] })
+              ] }),
+              /* @__PURE__ */ e("time", { className: "nice-activity-feed__time", children: s.timestamp })
+            ] })
+          ]
+        },
+        s.id
+      ))
+    ] }, t || "__all")),
+    E && k && /* @__PURE__ */ e("button", { className: "nice-activity-feed__load-more", onClick: k, children: "Load more" })
+  ] });
+});
+export {
+  se as NiceActivityFeed,
+  Z as NiceComments,
+  ee as NiceRatings,
+  ie as NiceSocialPanel,
+  te as NiceTagCloud,
+  ne as NiceUserList,
+  ae as NiceWiki
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nice2dev/social",
+  "version": "0.1.0",
+  "description": "Nice2Dev Social — Comments, ratings, activity feed, tag cloud, social panel, user list, wiki for React",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": ["dist", "LICENSE", "CHANGELOG.md", "README.md"],
+  "sideEffects": ["*.css"],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --config vitest.config.ts",
+    "test:coverage": "vitest run --config vitest.config.ts --coverage",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "react", "comments", "ratings", "social", "activity", "feed",
+    "tags", "wiki", "user-list", "nicetodev"
+  ],
+  "author": "NiceToDev <contact@nicetodev.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NiceToDev/NiceToDev.UI.git",
+    "directory": "nice2dev-social"
+  },
+  "homepage": "https://github.com/NiceToDev/NiceToDev.UI#readme",
+  "bugs": {
+    "url": "https://github.com/NiceToDev/NiceToDev.UI/issues"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitejs/plugin-react": "^4.2.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^5.3.0",
+    "vite": "^6.2.0",
+    "vite-plugin-dts": "^4.5.0"
+  }
+}