@btst/stack 2.11.3 → 2.11.5

package/dist/packages/stack/src/plugins/cms/client/components/inverse-relations-panel.cjs

@@ -42,6 +42,13 @@ function InverseRelationsPanel({
   if (inverseRelations.length === 0) {
     return null;
   }
+  const sourceTypeCounts = /* @__PURE__ */ new Map();
+  for (const rel of inverseRelations) {
+    sourceTypeCounts.set(
+      rel.sourceType,
+      (sourceTypeCounts.get(rel.sourceType) ?? 0) + 1
+    );
+  }
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-4", children: [
     /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "text-lg font-semibold", children: "Related Items" }),
     inverseRelations.map((relation) => /* @__PURE__ */ jsxRuntime.jsx(
@@ -54,12 +61,18 @@ function InverseRelationsPanel({
         navigate,
         Link,
         client: client$1,
-        headers
+        headers,
+        ambiguous: (sourceTypeCounts.get(relation.sourceType) ?? 0) > 1
       },
       `${relation.sourceType}-${relation.fieldName}`
     ))
   ] });
 }
+function humanizeFieldName(fieldName) {
+  const stripped = fieldName.replace(/Ids?$/, "") || fieldName;
+  const words = stripped.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ").trim().split(/\s+/);
+  return words.map((w) => w ? w[0].toUpperCase() + w.slice(1) : w).join(" ");
+}
 function InverseRelationSection({
   relation,
   contentTypeSlug,
@@ -68,7 +81,8 @@ function InverseRelationSection({
   navigate,
   Link,
   client,
-  headers
+  headers,
+  ambiguous
 }) {
   const [isExpanded, setIsExpanded] = React.useState(true);
   const [deleteItemId, setDeleteItemId] = React.useState(null);
@@ -117,6 +131,7 @@ function InverseRelationSection({
     navigate(createUrl);
   };
   const LinkComponent = Link ?? "a";
+  const fieldLabel = ambiguous ? humanizeFieldName(relation.fieldName) : null;
   return /* @__PURE__ */ jsxRuntime.jsxs(card.Card, { children: [
     /* @__PURE__ */ jsxRuntime.jsx(card.CardHeader, { className: "py-3", children: /* @__PURE__ */ jsxRuntime.jsx(
       "button",
@@ -126,10 +141,16 @@ function InverseRelationSection({
         className: "flex items-center justify-between w-full text-left",
         children: /* @__PURE__ */ jsxRuntime.jsxs(card.CardTitle, { className: "text-base flex items-center gap-2", children: [
           isExpanded ? /* @__PURE__ */ jsxRuntime.jsx(LucideIcons.ChevronDown, { className: "h-4 w-4" }) : /* @__PURE__ */ jsxRuntime.jsx(LucideIcons.ChevronRight, { className: "h-4 w-4" }),
-          relation.sourceTypeName,
-          " (",
-          total,
-          ")"
+          /* @__PURE__ */ jsxRuntime.jsx("span", { children: relation.sourceTypeName }),
+          fieldLabel && /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "font-normal text-muted-foreground", children: [
+            "\xB7 ",
+            fieldLabel
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "font-normal text-muted-foreground", children: [
+            "(",
+            total,
+            ")"
+          ] })
         ] })
       }
     ) }),
@@ -182,7 +203,8 @@ function InverseRelationSection({
           children: [
             /* @__PURE__ */ jsxRuntime.jsx(LucideIcons.Plus, { className: "h-4 w-4 mr-2" }),
             "Add ",
-            relation.sourceTypeName
+            relation.sourceTypeName,
+            fieldLabel ? ` (${fieldLabel})` : ""
           ]
         }
       ) })

package/dist/packages/stack/src/plugins/cms/client/components/inverse-relations-panel.mjs

@@ -40,6 +40,13 @@ function InverseRelationsPanel({
   if (inverseRelations.length === 0) {
     return null;
   }
+  const sourceTypeCounts = /* @__PURE__ */ new Map();
+  for (const rel of inverseRelations) {
+    sourceTypeCounts.set(
+      rel.sourceType,
+      (sourceTypeCounts.get(rel.sourceType) ?? 0) + 1
+    );
+  }
   return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
     /* @__PURE__ */ jsx("h3", { className: "text-lg font-semibold", children: "Related Items" }),
     inverseRelations.map((relation) => /* @__PURE__ */ jsx(
@@ -52,12 +59,18 @@ function InverseRelationsPanel({
         navigate,
         Link,
         client,
-        headers
+        headers,
+        ambiguous: (sourceTypeCounts.get(relation.sourceType) ?? 0) > 1
       },
       `${relation.sourceType}-${relation.fieldName}`
     ))
   ] });
 }
+function humanizeFieldName(fieldName) {
+  const stripped = fieldName.replace(/Ids?$/, "") || fieldName;
+  const words = stripped.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ").trim().split(/\s+/);
+  return words.map((w) => w ? w[0].toUpperCase() + w.slice(1) : w).join(" ");
+}
 function InverseRelationSection({
   relation,
   contentTypeSlug,
@@ -66,7 +79,8 @@ function InverseRelationSection({
   navigate,
   Link,
   client,
-  headers
+  headers,
+  ambiguous
 }) {
   const [isExpanded, setIsExpanded] = useState(true);
   const [deleteItemId, setDeleteItemId] = useState(null);
@@ -115,6 +129,7 @@ function InverseRelationSection({
     navigate(createUrl);
   };
   const LinkComponent = Link ?? "a";
+  const fieldLabel = ambiguous ? humanizeFieldName(relation.fieldName) : null;
   return /* @__PURE__ */ jsxs(Card, { children: [
     /* @__PURE__ */ jsx(CardHeader, { className: "py-3", children: /* @__PURE__ */ jsx(
       "button",
@@ -124,10 +139,16 @@ function InverseRelationSection({
         className: "flex items-center justify-between w-full text-left",
         children: /* @__PURE__ */ jsxs(CardTitle, { className: "text-base flex items-center gap-2", children: [
           isExpanded ? /* @__PURE__ */ jsx(ChevronDown, { className: "h-4 w-4" }) : /* @__PURE__ */ jsx(ChevronRight, { className: "h-4 w-4" }),
-          relation.sourceTypeName,
-          " (",
-          total,
-          ")"
+          /* @__PURE__ */ jsx("span", { children: relation.sourceTypeName }),
+          fieldLabel && /* @__PURE__ */ jsxs("span", { className: "font-normal text-muted-foreground", children: [
+            "\xB7 ",
+            fieldLabel
+          ] }),
+          /* @__PURE__ */ jsxs("span", { className: "font-normal text-muted-foreground", children: [
+            "(",
+            total,
+            ")"
+          ] })
         ] })
       }
     ) }),
@@ -180,7 +201,8 @@ function InverseRelationSection({
           children: [
             /* @__PURE__ */ jsx(Plus, { className: "h-4 w-4 mr-2" }),
             "Add ",
-            relation.sourceTypeName
+            relation.sourceTypeName,
+            fieldLabel ? ` (${fieldLabel})` : ""
           ]
         }
       ) })

package/dist/packages/ui/src/components/auto-form/helpers.cjs

@@ -216,12 +216,19 @@ function buildFieldConfigFromJsonSchema(jsonSchema, fieldComponents) {
         );
       }
     }
+    const reservedProps = /* @__PURE__ */ new Set([
+      "description",
+      "label",
+      "inputProps",
+      "fieldType",
+      "renderParent",
+      "order"
+    ]);
     if (value.properties) {
       const nestedConfig = buildFieldConfigFromJsonSchema(
         { properties: value.properties },
         fieldComponents
       );
-      const reservedProps = /* @__PURE__ */ new Set(["description", "label", "inputProps", "fieldType", "renderParent", "order"]);
       for (const [nestedKey, nestedValue] of Object.entries(nestedConfig)) {
         if (!reservedProps.has(nestedKey)) {
           config[nestedKey] = nestedValue;
@@ -232,6 +239,22 @@ function buildFieldConfigFromJsonSchema(jsonSchema, fieldComponents) {
         }
       }
     }
+    const items = value.items;
+    if (items?.properties) {
+      const itemConfig = buildFieldConfigFromJsonSchema(
+        { properties: items.properties },
+        fieldComponents
+      );
+      for (const [itemKey, itemValue] of Object.entries(itemConfig)) {
+        if (!reservedProps.has(itemKey)) {
+          config[itemKey] = itemValue;
+        } else {
+          console.warn(
+            `Array field "${key}" has an item property named "${itemKey}" which conflicts with a reserved FieldConfigItem property. The item field's config will not be accessible inside array items.`
+          );
+        }
+      }
+    }
     if (Object.keys(config).length > 0) {
       fieldConfig[key] = config;
     }

package/dist/packages/ui/src/components/auto-form/helpers.mjs

@@ -214,12 +214,19 @@ function buildFieldConfigFromJsonSchema(jsonSchema, fieldComponents) {
         );
       }
     }
+    const reservedProps = /* @__PURE__ */ new Set([
+      "description",
+      "label",
+      "inputProps",
+      "fieldType",
+      "renderParent",
+      "order"
+    ]);
     if (value.properties) {
       const nestedConfig = buildFieldConfigFromJsonSchema(
         { properties: value.properties },
         fieldComponents
       );
-      const reservedProps = /* @__PURE__ */ new Set(["description", "label", "inputProps", "fieldType", "renderParent", "order"]);
       for (const [nestedKey, nestedValue] of Object.entries(nestedConfig)) {
         if (!reservedProps.has(nestedKey)) {
           config[nestedKey] = nestedValue;
@@ -230,6 +237,22 @@ function buildFieldConfigFromJsonSchema(jsonSchema, fieldComponents) {
         }
       }
     }
+    const items = value.items;
+    if (items?.properties) {
+      const itemConfig = buildFieldConfigFromJsonSchema(
+        { properties: items.properties },
+        fieldComponents
+      );
+      for (const [itemKey, itemValue] of Object.entries(itemConfig)) {
+        if (!reservedProps.has(itemKey)) {
+          config[itemKey] = itemValue;
+        } else {
+          console.warn(
+            `Array field "${key}" has an item property named "${itemKey}" which conflicts with a reserved FieldConfigItem property. The item field's config will not be accessible inside array items.`
+          );
+        }
+      }
+    }
     if (Object.keys(config).length > 0) {
       fieldConfig[key] = config;
     }

package/dist/plugins/blog/api/index.d.cts

@@ -1,11 +1,12 @@
-export { B as BLOG_QUERY_KEYS, j as BlogApiContext, m as BlogApiRouter, k as BlogBackendHooks, h as BlogRouteKey, C as CreatePostInput, N as NextPreviousPostsQuerySchema, P as PostListParams, i as PostListQuerySchema, c as PostListResult, U as UpdatePostInput, l as blogBackendPlugin, f as createBlogQueryKeys, d as createPost, e as deletePost, g as getAllPosts, b as getAllTags, a as getPostBySlug, u as updatePost } from '../../../shared/stack.CntKf20s.cjs';
-import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Sod_PZhB.cjs';
+export { B as BLOG_QUERY_KEYS, j as BlogApiContext, m as BlogApiRouter, k as BlogBackendHooks, h as BlogRouteKey, C as CreatePostInput, N as NextPreviousPostsQuerySchema, P as PostListParams, i as PostListQuerySchema, c as PostListResult, U as UpdatePostInput, l as blogBackendPlugin, f as createBlogQueryKeys, d as createPost, e as deletePost, g as getAllPosts, b as getAllTags, a as getPostBySlug, u as updatePost } from '../../../shared/stack.CLWhMntf.cjs';
+import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Dsatjh0B.cjs';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';
 import '@btst/db';
 import 'better-call';
 import 'zod';
+import '../../../shared/stack.CuhcFsAx.cjs';
 
 /**
  * Serialize a Tag for SSR/SSG use (convert dates to strings).

package/dist/plugins/blog/api/index.d.mts

@@ -1,11 +1,12 @@
-export { B as BLOG_QUERY_KEYS, j as BlogApiContext, m as BlogApiRouter, k as BlogBackendHooks, h as BlogRouteKey, C as CreatePostInput, N as NextPreviousPostsQuerySchema, P as PostListParams, i as PostListQuerySchema, c as PostListResult, U as UpdatePostInput, l as blogBackendPlugin, f as createBlogQueryKeys, d as createPost, e as deletePost, g as getAllPosts, b as getAllTags, a as getPostBySlug, u as updatePost } from '../../../shared/stack.CLrGRIj0.mjs';
-import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Sod_PZhB.mjs';
+export { B as BLOG_QUERY_KEYS, j as BlogApiContext, m as BlogApiRouter, k as BlogBackendHooks, h as BlogRouteKey, C as CreatePostInput, N as NextPreviousPostsQuerySchema, P as PostListParams, i as PostListQuerySchema, c as PostListResult, U as UpdatePostInput, l as blogBackendPlugin, f as createBlogQueryKeys, d as createPost, e as deletePost, g as getAllPosts, b as getAllTags, a as getPostBySlug, u as updatePost } from '../../../shared/stack.DiodAFAa.mjs';
+import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Dsatjh0B.mjs';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';
 import '@btst/db';
 import 'better-call';
 import 'zod';
+import '../../../shared/stack.CuhcFsAx.mjs';
 
 /**
  * Serialize a Tag for SSR/SSG use (convert dates to strings).

package/dist/plugins/blog/api/index.d.ts

@@ -1,11 +1,12 @@
-export { B as BLOG_QUERY_KEYS, j as BlogApiContext, m as BlogApiRouter, k as BlogBackendHooks, h as BlogRouteKey, C as CreatePostInput, N as NextPreviousPostsQuerySchema, P as PostListParams, i as PostListQuerySchema, c as PostListResult, U as UpdatePostInput, l as blogBackendPlugin, f as createBlogQueryKeys, d as createPost, e as deletePost, g as getAllPosts, b as getAllTags, a as getPostBySlug, u as updatePost } from '../../../shared/stack.BQSy-NDc.js';
-import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Sod_PZhB.js';
+export { B as BLOG_QUERY_KEYS, j as BlogApiContext, m as BlogApiRouter, k as BlogBackendHooks, h as BlogRouteKey, C as CreatePostInput, N as NextPreviousPostsQuerySchema, P as PostListParams, i as PostListQuerySchema, c as PostListResult, U as UpdatePostInput, l as blogBackendPlugin, f as createBlogQueryKeys, d as createPost, e as deletePost, g as getAllPosts, b as getAllTags, a as getPostBySlug, u as updatePost } from '../../../shared/stack.ufcExQIR.js';
+import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Dsatjh0B.js';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';
 import '@btst/db';
 import 'better-call';
 import 'zod';
+import '../../../shared/stack.CuhcFsAx.js';
 
 /**
  * Serialize a Tag for SSR/SSG use (convert dates to strings).

package/dist/plugins/blog/client/components/index.cjs

@@ -5,13 +5,34 @@ const homePage = require('../../../../packages/stack/src/plugins/blog/client/com
 const newPostPage = require('../../../../packages/stack/src/plugins/blog/client/components/pages/new-post-page.cjs');
 const postPage = require('../../../../packages/stack/src/plugins/blog/client/components/pages/post-page.cjs');
 const editPostPage = require('../../../../packages/stack/src/plugins/blog/client/components/pages/edit-post-page.cjs');
+const postCard = require('../../../../packages/stack/src/plugins/blog/client/components/shared/post-card.cjs');
+const postsList = require('../../../../packages/stack/src/plugins/blog/client/components/shared/posts-list.cjs');
+const emptyList = require('../../../../packages/stack/src/plugins/blog/client/components/shared/empty-list.cjs');
+const recentPostsCarousel = require('../../../../packages/stack/src/plugins/blog/client/components/shared/recent-posts-carousel.cjs');
+const postNavigation = require('../../../../packages/stack/src/plugins/blog/client/components/shared/post-navigation.cjs');
+const tagsList = require('../../../../packages/stack/src/plugins/blog/client/components/shared/tags-list.cjs');
+const postCardSkeleton = require('../../../../packages/stack/src/plugins/blog/client/components/loading/post-card-skeleton.cjs');
 
 const PostListPage = homePage.HomePageComponent;
 const NewPostPage = newPostPage.NewPostPageComponent;
 const PostPage = postPage.PostPageComponent;
 const EditPostPage = editPostPage.EditPostPageComponent;
+const PostCard = postCard.PostCard;
+const PostCardSkeleton = postCardSkeleton.PostCardSkeleton;
+const PostsList = postsList.PostsList;
+const EmptyList = emptyList.EmptyList;
+const RecentPostsCarousel = recentPostsCarousel.RecentPostsCarousel;
+const PostNavigation = postNavigation.PostNavigation;
+const TagsList = tagsList.TagsList;
 
 exports.EditPostPage = EditPostPage;
+exports.EmptyList = EmptyList;
 exports.NewPostPage = NewPostPage;
+exports.PostCard = PostCard;
+exports.PostCardSkeleton = PostCardSkeleton;
 exports.PostListPage = PostListPage;
+exports.PostNavigation = PostNavigation;
 exports.PostPage = PostPage;
+exports.PostsList = PostsList;
+exports.RecentPostsCarousel = RecentPostsCarousel;
+exports.TagsList = TagsList;

package/dist/plugins/blog/client/components/index.d.cts

@@ -1,4 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { S as SerializedPost } from '../../../../shared/stack.Dsatjh0B.cjs';
 
 declare function HomePageComponent({ published, }: {
     published?: boolean;
@@ -14,9 +15,78 @@ declare function EditPostPageComponent({ slug }: {
     slug: string;
 }): react_jsx_runtime.JSX.Element;
 
+declare function PostCard$1({ post }: {
+    post: SerializedPost;
+}): react_jsx_runtime.JSX.Element;
+
+interface PostsListProps {
+    posts: SerializedPost[];
+    onLoadMore?: () => void;
+    hasMore?: boolean;
+    isLoadingMore?: boolean;
+}
+declare function PostsList$1({ posts, onLoadMore, hasMore, isLoadingMore, }: PostsListProps): react_jsx_runtime.JSX.Element;
+
+declare function EmptyList$1({ message }: {
+    message: string;
+}): react_jsx_runtime.JSX.Element;
+
+interface RecentPostsCarouselProps {
+    posts: SerializedPost[];
+}
+declare function RecentPostsCarousel$1({ posts }: RecentPostsCarouselProps): react_jsx_runtime.JSX.Element;
+
+interface PostNavigationProps {
+    previousPost: SerializedPost | null;
+    nextPost: SerializedPost | null;
+}
+declare function PostNavigation$1({ previousPost, nextPost, }: PostNavigationProps): react_jsx_runtime.JSX.Element;
+
+declare function TagsList$1(): react_jsx_runtime.JSX.Element | null;
+
+declare function PostCardSkeleton$1(): react_jsx_runtime.JSX.Element;
+
 declare const PostListPage: typeof HomePageComponent;
 declare const NewPostPage: typeof NewPostPageComponent;
 declare const PostPage: typeof PostPageComponent;
 declare const EditPostPage: typeof EditPostPageComponent;
+/**
+ * Card component that renders a single blog post summary
+ * (cover image, title, date, tags). Used by the built-in posts list and
+ * available for composing custom blog landing pages.
+ *
+ * Requires a `StackProvider` with the blog plugin registered so that
+ * `Link` and `Image` overrides are resolved correctly.
+ */
+declare const PostCard: typeof PostCard$1;
+/**
+ * Skeleton placeholder that mirrors the layout of {@link PostCard}.
+ * Use inside a `<Suspense>` fallback or while data is loading.
+ */
+declare const PostCardSkeleton: typeof PostCardSkeleton$1;
+/**
+ * Grid of {@link PostCard}s with optional load-more pagination and a
+ * built-in search input. Pass an array of `SerializedPost`s.
+ */
+declare const PostsList: typeof PostsList$1;
+/**
+ * Empty-state placeholder used by the built-in blog list pages.
+ * Renders a centered icon and a customisable message.
+ */
+declare const EmptyList: typeof EmptyList$1;
+/**
+ * Horizontal carousel of recent posts. Drop-in component for "you might
+ * also like" sections on a blog post page.
+ */
+declare const RecentPostsCarousel: typeof RecentPostsCarousel$1;
+/**
+ * Previous/next post navigation strip, typically rendered at the bottom
+ * of a post page.
+ */
+declare const PostNavigation: typeof PostNavigation$1;
+/**
+ * Renders a list of tags for a post or for the whole blog.
+ */
+declare const TagsList: typeof TagsList$1;
 
-export { EditPostPage, NewPostPage, PostListPage, PostPage };
+export { EditPostPage, EmptyList, NewPostPage, PostCard, PostCardSkeleton, PostListPage, PostNavigation, PostPage, PostsList, RecentPostsCarousel, TagsList };

package/dist/plugins/blog/client/components/index.d.mts

@@ -1,4 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { S as SerializedPost } from '../../../../shared/stack.Dsatjh0B.mjs';
 
 declare function HomePageComponent({ published, }: {
     published?: boolean;
@@ -14,9 +15,78 @@ declare function EditPostPageComponent({ slug }: {
     slug: string;
 }): react_jsx_runtime.JSX.Element;
 
+declare function PostCard$1({ post }: {
+    post: SerializedPost;
+}): react_jsx_runtime.JSX.Element;
+
+interface PostsListProps {
+    posts: SerializedPost[];
+    onLoadMore?: () => void;
+    hasMore?: boolean;
+    isLoadingMore?: boolean;
+}
+declare function PostsList$1({ posts, onLoadMore, hasMore, isLoadingMore, }: PostsListProps): react_jsx_runtime.JSX.Element;
+
+declare function EmptyList$1({ message }: {
+    message: string;
+}): react_jsx_runtime.JSX.Element;
+
+interface RecentPostsCarouselProps {
+    posts: SerializedPost[];
+}
+declare function RecentPostsCarousel$1({ posts }: RecentPostsCarouselProps): react_jsx_runtime.JSX.Element;
+
+interface PostNavigationProps {
+    previousPost: SerializedPost | null;
+    nextPost: SerializedPost | null;
+}
+declare function PostNavigation$1({ previousPost, nextPost, }: PostNavigationProps): react_jsx_runtime.JSX.Element;
+
+declare function TagsList$1(): react_jsx_runtime.JSX.Element | null;
+
+declare function PostCardSkeleton$1(): react_jsx_runtime.JSX.Element;
+
 declare const PostListPage: typeof HomePageComponent;
 declare const NewPostPage: typeof NewPostPageComponent;
 declare const PostPage: typeof PostPageComponent;
 declare const EditPostPage: typeof EditPostPageComponent;
+/**
+ * Card component that renders a single blog post summary
+ * (cover image, title, date, tags). Used by the built-in posts list and
+ * available for composing custom blog landing pages.
+ *
+ * Requires a `StackProvider` with the blog plugin registered so that
+ * `Link` and `Image` overrides are resolved correctly.
+ */
+declare const PostCard: typeof PostCard$1;
+/**
+ * Skeleton placeholder that mirrors the layout of {@link PostCard}.
+ * Use inside a `<Suspense>` fallback or while data is loading.
+ */
+declare const PostCardSkeleton: typeof PostCardSkeleton$1;
+/**
+ * Grid of {@link PostCard}s with optional load-more pagination and a
+ * built-in search input. Pass an array of `SerializedPost`s.
+ */
+declare const PostsList: typeof PostsList$1;
+/**
+ * Empty-state placeholder used by the built-in blog list pages.
+ * Renders a centered icon and a customisable message.
+ */
+declare const EmptyList: typeof EmptyList$1;
+/**
+ * Horizontal carousel of recent posts. Drop-in component for "you might
+ * also like" sections on a blog post page.
+ */
+declare const RecentPostsCarousel: typeof RecentPostsCarousel$1;
+/**
+ * Previous/next post navigation strip, typically rendered at the bottom
+ * of a post page.
+ */
+declare const PostNavigation: typeof PostNavigation$1;
+/**
+ * Renders a list of tags for a post or for the whole blog.
+ */
+declare const TagsList: typeof TagsList$1;
 
-export { EditPostPage, NewPostPage, PostListPage, PostPage };
+export { EditPostPage, EmptyList, NewPostPage, PostCard, PostCardSkeleton, PostListPage, PostNavigation, PostPage, PostsList, RecentPostsCarousel, TagsList };

package/dist/plugins/blog/client/components/index.d.ts

@@ -1,4 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { S as SerializedPost } from '../../../../shared/stack.Dsatjh0B.js';
 
 declare function HomePageComponent({ published, }: {
     published?: boolean;
@@ -14,9 +15,78 @@ declare function EditPostPageComponent({ slug }: {
     slug: string;
 }): react_jsx_runtime.JSX.Element;
 
+declare function PostCard$1({ post }: {
+    post: SerializedPost;
+}): react_jsx_runtime.JSX.Element;
+
+interface PostsListProps {
+    posts: SerializedPost[];
+    onLoadMore?: () => void;
+    hasMore?: boolean;
+    isLoadingMore?: boolean;
+}
+declare function PostsList$1({ posts, onLoadMore, hasMore, isLoadingMore, }: PostsListProps): react_jsx_runtime.JSX.Element;
+
+declare function EmptyList$1({ message }: {
+    message: string;
+}): react_jsx_runtime.JSX.Element;
+
+interface RecentPostsCarouselProps {
+    posts: SerializedPost[];
+}
+declare function RecentPostsCarousel$1({ posts }: RecentPostsCarouselProps): react_jsx_runtime.JSX.Element;
+
+interface PostNavigationProps {
+    previousPost: SerializedPost | null;
+    nextPost: SerializedPost | null;
+}
+declare function PostNavigation$1({ previousPost, nextPost, }: PostNavigationProps): react_jsx_runtime.JSX.Element;
+
+declare function TagsList$1(): react_jsx_runtime.JSX.Element | null;
+
+declare function PostCardSkeleton$1(): react_jsx_runtime.JSX.Element;
+
 declare const PostListPage: typeof HomePageComponent;
 declare const NewPostPage: typeof NewPostPageComponent;
 declare const PostPage: typeof PostPageComponent;
 declare const EditPostPage: typeof EditPostPageComponent;
+/**
+ * Card component that renders a single blog post summary
+ * (cover image, title, date, tags). Used by the built-in posts list and
+ * available for composing custom blog landing pages.
+ *
+ * Requires a `StackProvider` with the blog plugin registered so that
+ * `Link` and `Image` overrides are resolved correctly.
+ */
+declare const PostCard: typeof PostCard$1;
+/**
+ * Skeleton placeholder that mirrors the layout of {@link PostCard}.
+ * Use inside a `<Suspense>` fallback or while data is loading.
+ */
+declare const PostCardSkeleton: typeof PostCardSkeleton$1;
+/**
+ * Grid of {@link PostCard}s with optional load-more pagination and a
+ * built-in search input. Pass an array of `SerializedPost`s.
+ */
+declare const PostsList: typeof PostsList$1;
+/**
+ * Empty-state placeholder used by the built-in blog list pages.
+ * Renders a centered icon and a customisable message.
+ */
+declare const EmptyList: typeof EmptyList$1;
+/**
+ * Horizontal carousel of recent posts. Drop-in component for "you might
+ * also like" sections on a blog post page.
+ */
+declare const RecentPostsCarousel: typeof RecentPostsCarousel$1;
+/**
+ * Previous/next post navigation strip, typically rendered at the bottom
+ * of a post page.
+ */
+declare const PostNavigation: typeof PostNavigation$1;
+/**
+ * Renders a list of tags for a post or for the whole blog.
+ */
+declare const TagsList: typeof TagsList$1;
 
-export { EditPostPage, NewPostPage, PostListPage, PostPage };
+export { EditPostPage, EmptyList, NewPostPage, PostCard, PostCardSkeleton, PostListPage, PostNavigation, PostPage, PostsList, RecentPostsCarousel, TagsList };

package/dist/plugins/blog/client/components/index.mjs

@@ -3,10 +3,24 @@ import { HomePageComponent } from '../../../../packages/stack/src/plugins/blog/c
 import { NewPostPageComponent } from '../../../../packages/stack/src/plugins/blog/client/components/pages/new-post-page.mjs';
 import { PostPageComponent } from '../../../../packages/stack/src/plugins/blog/client/components/pages/post-page.mjs';
 import { EditPostPageComponent } from '../../../../packages/stack/src/plugins/blog/client/components/pages/edit-post-page.mjs';
+import { PostCard as PostCard$1 } from '../../../../packages/stack/src/plugins/blog/client/components/shared/post-card.mjs';
+import { PostsList as PostsList$1 } from '../../../../packages/stack/src/plugins/blog/client/components/shared/posts-list.mjs';
+import { EmptyList as EmptyList$1 } from '../../../../packages/stack/src/plugins/blog/client/components/shared/empty-list.mjs';
+import { RecentPostsCarousel as RecentPostsCarousel$1 } from '../../../../packages/stack/src/plugins/blog/client/components/shared/recent-posts-carousel.mjs';
+import { PostNavigation as PostNavigation$1 } from '../../../../packages/stack/src/plugins/blog/client/components/shared/post-navigation.mjs';
+import { TagsList as TagsList$1 } from '../../../../packages/stack/src/plugins/blog/client/components/shared/tags-list.mjs';
+import { PostCardSkeleton as PostCardSkeleton$1 } from '../../../../packages/stack/src/plugins/blog/client/components/loading/post-card-skeleton.mjs';
 
 const PostListPage = HomePageComponent;
 const NewPostPage = NewPostPageComponent;
 const PostPage = PostPageComponent;
 const EditPostPage = EditPostPageComponent;
+const PostCard = PostCard$1;
+const PostCardSkeleton = PostCardSkeleton$1;
+const PostsList = PostsList$1;
+const EmptyList = EmptyList$1;
+const RecentPostsCarousel = RecentPostsCarousel$1;
+const PostNavigation = PostNavigation$1;
+const TagsList = TagsList$1;
 
-export { EditPostPage, NewPostPage, PostListPage, PostPage };
+export { EditPostPage, EmptyList, NewPostPage, PostCard, PostCardSkeleton, PostListPage, PostNavigation, PostPage, PostsList, RecentPostsCarousel, TagsList };

package/dist/plugins/blog/client/hooks/index.d.cts

@@ -1,7 +1,8 @@
-export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.DGsFF5qb.cjs';
+export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.DNLuzDb3.cjs';
 import '@tanstack/react-query';
-import '../../../../shared/stack.Sod_PZhB.cjs';
+import '../../../../shared/stack.Dsatjh0B.cjs';
 import 'zod';
+import '../../../../shared/stack.CuhcFsAx.cjs';
 
 declare function useDebounce<T>(value: T, delay?: number): T;
 declare function useThrottle<T>(value: T, wait?: number): T;

package/dist/plugins/blog/client/hooks/index.d.mts

@@ -1,7 +1,8 @@
-export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.NtflNnnH.mjs';
+export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.Dfc44JiE.mjs';
 import '@tanstack/react-query';
-import '../../../../shared/stack.Sod_PZhB.mjs';
+import '../../../../shared/stack.Dsatjh0B.mjs';
 import 'zod';
+import '../../../../shared/stack.CuhcFsAx.mjs';
 
 declare function useDebounce<T>(value: T, delay?: number): T;
 declare function useThrottle<T>(value: T, wait?: number): T;