@parto-system-design/ui 1.1.9 → 1.1.11

package/dist/index.d.cts

@@ -2968,13 +2968,17 @@ declare function sourceCategory(source: PostSource): PostSourceCategory;
  */
 type PostPlatform = SocialPlatform;
 /**
- * `view` is the canonical PostList render mode. `compact` and `comfortable` are the
- * pre-existing densities; `grid` is the new magazine/visual layout.
+ * Canonical render mode for `<PostList>` and `<PostCard>`:
+ *   - `compact`     — dense list row with side thumbnail and 1-line preview
+ *   - `comfortable` — full vertical card with header, body, media, metrics, signals
+ *   - `grid`        — magazine/visual layout (aspect-square media-dominant tile)
  */
 type PostView = 'compact' | 'comfortable' | 'grid';
 /**
- * @deprecated Use {@link PostView} instead. `density` is the legacy two-value alias
- * (compact | comfortable) kept for backward compatibility with PostCard / PostList.
+ * Two-mode subset used by sub-components that don't ship a `grid` layout
+ * (`<PostHeader>`, `<PostHeaderBroadcast>`, `<PostHeaderEditorial>`,
+ * `<PostMetadata>`, `<PostSignals>`). `<PostCard>` internally narrows its
+ * `view` down to this when rendering those sub-components.
  */
 type PostDensity = 'compact' | 'comfortable';
 type PostSentiment = 'positive' | 'negative' | 'neutral' | 'mixed';
@@ -3517,10 +3521,8 @@ declare const postCardVariants: (props?: ({
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface PostCardProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSelect'>, VariantProps<typeof postCardVariants> {
     post: PostData;
-    /** Layout mode. Replaces the legacy `density` prop. */
+    /** Layout mode — `compact` (dense row) · `comfortable` (full card) · `grid` (media tile). */
     view?: PostView;
-    /** @deprecated Use `view` instead. */
-    density?: PostDensity;
     selected?: boolean;
     /** True when the card represents the post currently open in the details drawer. */
     active?: boolean;
@@ -3829,10 +3831,6 @@ interface PostListProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'on
     /** Controlled view. If omitted, the list manages its own state (persisted to localStorage). */
     view?: PostView;
     onViewChange?: (view: PostView) => void;
-    /** @deprecated Use `view` instead. */
-    density?: PostDensity;
-    /** @deprecated Use `onViewChange` instead. */
-    onDensityChange?: (density: PostDensity) => void;
     /** ID of the currently open/selected post (for URL deep-linking). */
     activeId?: string;
     /** IDs of posts that have been visited (visual "read" state). */
@@ -5575,8 +5573,8 @@ interface TopPostsSectionProps extends ReportSectionShellProps {
     posts: PostData[];
     /** Render only the first N posts. @default 5 */
     topN?: number;
-    /** Density passed through to PostList. @default 'compact' */
-    density?: 'compact' | 'comfortable';
+    /** View mode passed through to PostList. @default 'compact' */
+    view?: 'compact' | 'comfortable' | 'grid';
     locale?: SupportedLocale;
 }
 declare const TopPostsSection: React$1.ForwardRefExoticComponent<TopPostsSectionProps & React$1.RefAttributes<HTMLDivElement>>;

package/dist/index.d.ts

@@ -2968,13 +2968,17 @@ declare function sourceCategory(source: PostSource): PostSourceCategory;
  */
 type PostPlatform = SocialPlatform;
 /**
- * `view` is the canonical PostList render mode. `compact` and `comfortable` are the
- * pre-existing densities; `grid` is the new magazine/visual layout.
+ * Canonical render mode for `<PostList>` and `<PostCard>`:
+ *   - `compact`     — dense list row with side thumbnail and 1-line preview
+ *   - `comfortable` — full vertical card with header, body, media, metrics, signals
+ *   - `grid`        — magazine/visual layout (aspect-square media-dominant tile)
  */
 type PostView = 'compact' | 'comfortable' | 'grid';
 /**
- * @deprecated Use {@link PostView} instead. `density` is the legacy two-value alias
- * (compact | comfortable) kept for backward compatibility with PostCard / PostList.
+ * Two-mode subset used by sub-components that don't ship a `grid` layout
+ * (`<PostHeader>`, `<PostHeaderBroadcast>`, `<PostHeaderEditorial>`,
+ * `<PostMetadata>`, `<PostSignals>`). `<PostCard>` internally narrows its
+ * `view` down to this when rendering those sub-components.
  */
 type PostDensity = 'compact' | 'comfortable';
 type PostSentiment = 'positive' | 'negative' | 'neutral' | 'mixed';
@@ -3517,10 +3521,8 @@ declare const postCardVariants: (props?: ({
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface PostCardProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSelect'>, VariantProps<typeof postCardVariants> {
     post: PostData;
-    /** Layout mode. Replaces the legacy `density` prop. */
+    /** Layout mode — `compact` (dense row) · `comfortable` (full card) · `grid` (media tile). */
     view?: PostView;
-    /** @deprecated Use `view` instead. */
-    density?: PostDensity;
     selected?: boolean;
     /** True when the card represents the post currently open in the details drawer. */
     active?: boolean;
@@ -3829,10 +3831,6 @@ interface PostListProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'on
     /** Controlled view. If omitted, the list manages its own state (persisted to localStorage). */
     view?: PostView;
     onViewChange?: (view: PostView) => void;
-    /** @deprecated Use `view` instead. */
-    density?: PostDensity;
-    /** @deprecated Use `onViewChange` instead. */
-    onDensityChange?: (density: PostDensity) => void;
     /** ID of the currently open/selected post (for URL deep-linking). */
     activeId?: string;
     /** IDs of posts that have been visited (visual "read" state). */
@@ -5575,8 +5573,8 @@ interface TopPostsSectionProps extends ReportSectionShellProps {
     posts: PostData[];
     /** Render only the first N posts. @default 5 */
     topN?: number;
-    /** Density passed through to PostList. @default 'compact' */
-    density?: 'compact' | 'comfortable';
+    /** View mode passed through to PostList. @default 'compact' */
+    view?: 'compact' | 'comfortable' | 'grid';
     locale?: SupportedLocale;
 }
 declare const TopPostsSection: React$1.ForwardRefExoticComponent<TopPostsSectionProps & React$1.RefAttributes<HTMLDivElement>>;

package/dist/index.js

@@ -11589,8 +11589,7 @@ var HeaderDispatcher = ({ post, density, onAuthorAnalytics, onAuthorProfile }) =
 var PostCard = React98.forwardRef(
   ({
     post,
-    view,
-    density,
+    view = "comfortable",
     selected = false,
     active = false,
     read = false,
@@ -11611,7 +11610,7 @@ var PostCard = React98.forwardRef(
     onClick,
     ...props
   }, ref) => {
-    const resolvedView = view ?? density ?? "comfortable";
+    const resolvedView = view;
     const headerDensity = resolvedView === "grid" ? "compact" : resolvedView;
     const effectiveActions = React98.useMemo(() => actions ?? defaultActions({ onOpenDetails }), [actions, onOpenDetails]);
     const config = getPostSourceConfig(post.source);
@@ -11646,7 +11645,6 @@ var PostCard = React98.forwardRef(
           tabIndex: 0,
           "data-slot": "post-card",
           "data-view": "compact",
-          "data-density": "compact",
           "data-source": post.source,
           "data-source-category": sourceCategory(post.source),
           "data-selected": selected || void 0,
@@ -11741,7 +11739,6 @@ var PostCard = React98.forwardRef(
           tabIndex: 0,
           "data-slot": "post-card",
           "data-view": "grid",
-          "data-density": "grid",
           "data-source": post.source,
           "data-source-category": sourceCategory(post.source),
           "data-selected": selected || void 0,
@@ -11826,7 +11823,6 @@ var PostCard = React98.forwardRef(
         tabIndex: onOpen ? 0 : void 0,
         "data-slot": "post-card",
         "data-view": "comfortable",
-        "data-density": "comfortable",
         "data-source": post.source,
         "data-source-category": sourceCategory(post.source),
         "data-selected": selected || void 0,
@@ -12605,8 +12601,6 @@ function readStoredView() {
   if (typeof window === "undefined") return null;
   const stored = window.localStorage.getItem(VIEW_STORAGE_KEY);
   if (stored === "compact" || stored === "comfortable" || stored === "grid") return stored;
-  const legacy = window.localStorage.getItem("parto-post-list-density");
-  if (legacy === "compact" || legacy === "comfortable") return legacy;
   return null;
 }
 function ts(d) {
@@ -12710,8 +12704,6 @@ var PostList = React98.forwardRef(
     posts,
     view: controlledView,
     onViewChange,
-    density: legacyDensity,
-    onDensityChange: legacyOnDensityChange,
     activeId,
     readIds,
     selectedIds,
@@ -12742,18 +12734,17 @@ var PostList = React98.forwardRef(
   }, ref) => {
     const [internalView, setInternalView] = React98.useState("comfortable");
     React98.useEffect(() => {
-      if (controlledView !== void 0 || legacyDensity !== void 0) return;
+      if (controlledView !== void 0) return;
       const stored = readStoredView();
       if (stored) setInternalView(stored);
-    }, [controlledView, legacyDensity]);
-    const view = controlledView ?? legacyDensity ?? internalView;
+    }, [controlledView]);
+    const view = controlledView ?? internalView;
     const handleView = (next) => {
-      if (controlledView === void 0 && legacyDensity === void 0) {
+      if (controlledView === void 0) {
         setInternalView(next);
         if (typeof window !== "undefined") window.localStorage.setItem(VIEW_STORAGE_KEY, next);
       }
       onViewChange?.(next);
-      if (next !== "grid") legacyOnDensityChange?.(next);
     };
     const readSet = React98.useMemo(() => toSet(readIds), [readIds]);
     const selectedSet = React98.useMemo(() => toSet(selectedIds), [selectedIds]);
@@ -12808,9 +12799,13 @@ var PostList = React98.forwardRef(
         onSelect: handleSelect,
         actions
       },
-      post.id
+      `${post.id}:${view}`
     );
-    const containerCls = view === "grid" ? "grid grid-cols-2 lg:grid-cols-3 gap-3 p-4" : view === "comfortable" ? "flex flex-col gap-3 p-4" : "flex flex-col";
+    const containerCls = React98.useMemo(() => {
+      if (view === "grid") return "grid grid-cols-2 lg:grid-cols-3 gap-3 p-4";
+      if (view === "comfortable") return "flex flex-col gap-3 p-4";
+      return "flex flex-col";
+    }, [view]);
     let body;
     if (isLoading) {
       body = loadingState ?? /* @__PURE__ */ jsx(DefaultLoading, { view });
@@ -18401,7 +18396,7 @@ var FlowDistributionSection = React98.forwardRef(
     );
   }
 );
-var TopPostsSection = React98.forwardRef(function TopPostsSection2({ title, description, posts, topN = 5, density = "compact", locale = "fa", ...sectionProps }, ref) {
+var TopPostsSection = React98.forwardRef(function TopPostsSection2({ title, description, posts, topN = 5, view = "compact", locale = "fa", ...sectionProps }, ref) {
   const visible = posts.slice(0, topN);
   return /* @__PURE__ */ jsx(
     ReportSection,
@@ -18410,7 +18405,7 @@ var TopPostsSection = React98.forwardRef(function TopPostsSection2({ title, desc
       title: title ?? defaultTitle("topPosts", locale),
       description,
       ...sectionProps,
-      children: /* @__PURE__ */ jsx("div", { "data-slot": "report-section-top-posts", children: /* @__PURE__ */ jsx(PostList, { posts: visible, density }) })
+      children: /* @__PURE__ */ jsx("div", { "data-slot": "report-section-top-posts", children: /* @__PURE__ */ jsx(PostList, { posts: visible, view }) })
     }
   );
 });