@btst/stack 2.5.6 → 2.6.1

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

@@ -1,228 +1,9 @@
-import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from '../../../../shared/stack.BWp0hcm9.mjs';
-import { z } from 'zod';
+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.B8vT-Yt4.mjs';
+import '@tanstack/react-query';
+import '../../../../shared/stack.BQmuNl5p.mjs';
+import 'zod';
 
-/**
- * Options for the usePosts hook
- */
-interface UsePostsOptions {
-    /** Filter posts by tag name */
-    tag?: string;
-    /** Filter posts by tag slug */
-    tagSlug?: string;
-    /** Number of posts to fetch per page (default: 10) */
-    limit?: number;
-    /** Whether to enable the query (default: true) */
-    enabled?: boolean;
-    /** Search query to filter posts by title, content, or excerpt */
-    query?: string;
-    /** Filter by published status */
-    published?: boolean;
-    /** Filter by specific post slug */
-    slug?: string;
-}
-/**
- * Result from the usePosts hook
- */
-interface UsePostsResult {
-    /** Array of fetched posts */
-    posts: SerializedPost[];
-    /** Whether the initial load is in progress */
-    isLoading: boolean;
-    /** Error if the query failed */
-    error: Error | null;
-    /** Function to load the next page of posts */
-    loadMore: () => void;
-    /** Whether there are more posts to load */
-    hasMore: boolean;
-    /** Whether the next page is being loaded */
-    isLoadingMore: boolean;
-    /** Function to refetch the posts */
-    refetch: () => void;
-}
-/**
- * Options for the usePostSearch hook
- */
-interface UsePostSearchOptions {
-    /** Search query string to filter posts */
-    query: string;
-    /** Whether to enable the search query (default: true) */
-    enabled?: boolean;
-    /** Debounce delay in milliseconds (default: 300) */
-    debounceMs?: number;
-    /** Number of results to return (default: 10) */
-    limit?: number;
-    /** Filter by published status (default: true) */
-    published?: boolean;
-}
-/**
- * Result from the usePostSearch hook
- */
-interface UsePostSearchResult {
-    /** Array of posts matching the search query */
-    posts: SerializedPost[];
-    /** Alias for posts (React Query compatibility) */
-    data: SerializedPost[];
-    /** Whether the search is in progress */
-    isLoading: boolean;
-    /** Error if the search failed */
-    error: Error | null;
-    /** Function to refetch the search results */
-    refetch: () => void;
-    /** Whether a search is currently in progress (includes debounce time) */
-    isSearching: boolean;
-    /** The debounced search query being used */
-    searchQuery: string;
-}
-/**
- * Result from the usePost hook
- */
-interface UsePostResult {
-    /** The fetched post, or null if not found */
-    post: SerializedPost | null;
-    /** Whether the post is being loaded */
-    isLoading: boolean;
-    /** Error if the query failed */
-    error: Error | null;
-    /** Function to refetch the post */
-    refetch: () => void;
-}
-/** Input type for creating a new post */
-type PostCreateInput = z.infer<typeof createPostSchema>;
-/** Input type for updating an existing post */
-type PostUpdateInput = z.infer<typeof updatePostSchema>;
-/**
- * Hook for fetching paginated posts with load more functionality
- */
-declare function usePosts(options?: UsePostsOptions): UsePostsResult;
-/** Suspense variant of usePosts */
-declare function useSuspensePosts(options?: UsePostsOptions): {
-    posts: SerializedPost[];
-    loadMore: () => Promise<unknown>;
-    hasMore: boolean;
-    isLoadingMore: boolean;
-    refetch: () => Promise<unknown>;
-};
-/**
- * Hook for fetching a single post by slug
- */
-declare function usePost(slug?: string): UsePostResult;
-/** Suspense variant of usePost */
-declare function useSuspensePost(slug: string): {
-    post: SerializedPost | null;
-    refetch: () => Promise<unknown>;
-};
-/**
- * Hook for fetching all unique tags across posts
- */
-declare function useTags(): {
-    tags: SerializedTag[];
-    isLoading: boolean;
-    error: Error | null;
-    refetch: () => void;
-};
-/** Suspense variant of useTags */
-declare function useSuspenseTags(): {
-    tags: SerializedTag[];
-    refetch: () => Promise<unknown>;
-};
-/** Create a new post */
-declare function useCreatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
-    tags: ({
-        name: string;
-    } | {
-        id: string;
-        name: string;
-        slug: string;
-    })[];
-    published: boolean;
-    title: string;
-    content: string;
-    excerpt: string;
-    slug?: string | undefined;
-    publishedAt?: Date | undefined;
-    createdAt?: Date | undefined;
-    updatedAt?: Date | undefined;
-    image?: string | undefined;
-}, unknown>;
-/** Update an existing post by id */
-declare function useUpdatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
-    id: string;
-    data: PostUpdateInput;
-}, unknown>;
-/** Delete a post by id */
-declare function useDeletePost(): _tanstack_react_query.UseMutationResult<{
-    success: boolean;
-}, Error, {
-    id: string;
-}, unknown>;
-/**
- * Hook for searching posts by a free-text query. Uses `usePosts` under the hood.
- * Debounces the query and preserves last successful results to avoid flicker.
- */
-declare function usePostSearch({ query, enabled, debounceMs, limit, published, }: UsePostSearchOptions): UsePostSearchResult;
-/**
- * Options for the useNextPreviousPosts hook
- */
-interface UseNextPreviousPostsOptions {
-    /** Whether to enable the query (default: true) */
-    enabled?: boolean;
-}
-/**
- * Result from the useNextPreviousPosts hook
- */
-interface UseNextPreviousPostsResult {
-    /** The previous post (older), or null if none exists */
-    previousPost: SerializedPost | null;
-    /** The next post (newer), or null if none exists */
-    nextPost: SerializedPost | null;
-    /** Whether the query is loading */
-    isLoading: boolean;
-    /** Error if the query failed */
-    error: Error | null;
-    /** Function to refetch the posts */
-    refetch: () => void;
-}
-/**
- * Hook for fetching previous and next posts relative to a given date
- * Uses useInView to only fetch when the component is in view
- */
-declare function useNextPreviousPosts(createdAt: string | Date, options?: UseNextPreviousPostsOptions): UseNextPreviousPostsResult & {
-    ref: (node: Element | null) => void;
-    inView: boolean;
-};
-/**
- * Options for the useRecentPosts hook
- */
-interface UseRecentPostsOptions {
-    /** Maximum number of recent posts to fetch (default: 5) */
-    limit?: number;
-    /** Slug of a post to exclude from results */
-    excludeSlug?: string;
-    /** Whether to enable the query (default: true) */
-    enabled?: boolean;
-}
-/**
- * Result from the useRecentPosts hook
- */
-interface UseRecentPostsResult {
-    /** Array of recent posts */
-    recentPosts: SerializedPost[];
-    /** Whether the query is loading */
-    isLoading: boolean;
-    /** Error if the query failed */
-    error: Error | null;
-    /** Function to refetch the posts */
-    refetch: () => void;
-}
-/**
- * Hook for fetching recent posts
- * Uses useInView to only fetch when the component is in view
- */
-declare function useRecentPosts(options?: UseRecentPostsOptions): UseRecentPostsResult & {
-    ref: (node: Element | null) => void;
-    inView: boolean;
-};
+declare function useDebounce<T>(value: T, delay?: number): T;
+declare function useThrottle<T>(value: T, wait?: number): T;
 
-export { useCreatePost, useDeletePost, useNextPreviousPosts, usePost, usePostSearch, usePosts, useRecentPosts, useSuspensePost, useSuspensePosts, useSuspenseTags, useTags, useUpdatePost };
-export type { PostCreateInput, PostUpdateInput, UseNextPreviousPostsOptions, UseNextPreviousPostsResult, UsePostResult, UsePostSearchOptions, UsePostSearchResult, UsePostsOptions, UsePostsResult, UseRecentPostsOptions, UseRecentPostsResult };
+export { useDebounce, useThrottle };

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

@@ -1,228 +1,9 @@
-import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from '../../../../shared/stack.BWp0hcm9.js';
-import { z } from 'zod';
+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.BAT540yW.js';
+import '@tanstack/react-query';
+import '../../../../shared/stack.BQmuNl5p.js';
+import 'zod';
 
-/**
- * Options for the usePosts hook
- */
-interface UsePostsOptions {
-    /** Filter posts by tag name */
-    tag?: string;
-    /** Filter posts by tag slug */
-    tagSlug?: string;
-    /** Number of posts to fetch per page (default: 10) */
-    limit?: number;
-    /** Whether to enable the query (default: true) */
-    enabled?: boolean;
-    /** Search query to filter posts by title, content, or excerpt */
-    query?: string;
-    /** Filter by published status */
-    published?: boolean;
-    /** Filter by specific post slug */
-    slug?: string;
-}
-/**
- * Result from the usePosts hook
- */
-interface UsePostsResult {
-    /** Array of fetched posts */
-    posts: SerializedPost[];
-    /** Whether the initial load is in progress */
-    isLoading: boolean;
-    /** Error if the query failed */
-    error: Error | null;
-    /** Function to load the next page of posts */
-    loadMore: () => void;
-    /** Whether there are more posts to load */
-    hasMore: boolean;
-    /** Whether the next page is being loaded */
-    isLoadingMore: boolean;
-    /** Function to refetch the posts */
-    refetch: () => void;
-}
-/**
- * Options for the usePostSearch hook
- */
-interface UsePostSearchOptions {
-    /** Search query string to filter posts */
-    query: string;
-    /** Whether to enable the search query (default: true) */
-    enabled?: boolean;
-    /** Debounce delay in milliseconds (default: 300) */
-    debounceMs?: number;
-    /** Number of results to return (default: 10) */
-    limit?: number;
-    /** Filter by published status (default: true) */
-    published?: boolean;
-}
-/**
- * Result from the usePostSearch hook
- */
-interface UsePostSearchResult {
-    /** Array of posts matching the search query */
-    posts: SerializedPost[];
-    /** Alias for posts (React Query compatibility) */
-    data: SerializedPost[];
-    /** Whether the search is in progress */
-    isLoading: boolean;
-    /** Error if the search failed */
-    error: Error | null;
-    /** Function to refetch the search results */
-    refetch: () => void;
-    /** Whether a search is currently in progress (includes debounce time) */
-    isSearching: boolean;
-    /** The debounced search query being used */
-    searchQuery: string;
-}
-/**
- * Result from the usePost hook
- */
-interface UsePostResult {
-    /** The fetched post, or null if not found */
-    post: SerializedPost | null;
-    /** Whether the post is being loaded */
-    isLoading: boolean;
-    /** Error if the query failed */
-    error: Error | null;
-    /** Function to refetch the post */
-    refetch: () => void;
-}
-/** Input type for creating a new post */
-type PostCreateInput = z.infer<typeof createPostSchema>;
-/** Input type for updating an existing post */
-type PostUpdateInput = z.infer<typeof updatePostSchema>;
-/**
- * Hook for fetching paginated posts with load more functionality
- */
-declare function usePosts(options?: UsePostsOptions): UsePostsResult;
-/** Suspense variant of usePosts */
-declare function useSuspensePosts(options?: UsePostsOptions): {
-    posts: SerializedPost[];
-    loadMore: () => Promise<unknown>;
-    hasMore: boolean;
-    isLoadingMore: boolean;
-    refetch: () => Promise<unknown>;
-};
-/**
- * Hook for fetching a single post by slug
- */
-declare function usePost(slug?: string): UsePostResult;
-/** Suspense variant of usePost */
-declare function useSuspensePost(slug: string): {
-    post: SerializedPost | null;
-    refetch: () => Promise<unknown>;
-};
-/**
- * Hook for fetching all unique tags across posts
- */
-declare function useTags(): {
-    tags: SerializedTag[];
-    isLoading: boolean;
-    error: Error | null;
-    refetch: () => void;
-};
-/** Suspense variant of useTags */
-declare function useSuspenseTags(): {
-    tags: SerializedTag[];
-    refetch: () => Promise<unknown>;
-};
-/** Create a new post */
-declare function useCreatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
-    tags: ({
-        name: string;
-    } | {
-        id: string;
-        name: string;
-        slug: string;
-    })[];
-    published: boolean;
-    title: string;
-    content: string;
-    excerpt: string;
-    slug?: string | undefined;
-    publishedAt?: Date | undefined;
-    createdAt?: Date | undefined;
-    updatedAt?: Date | undefined;
-    image?: string | undefined;
-}, unknown>;
-/** Update an existing post by id */
-declare function useUpdatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
-    id: string;
-    data: PostUpdateInput;
-}, unknown>;
-/** Delete a post by id */
-declare function useDeletePost(): _tanstack_react_query.UseMutationResult<{
-    success: boolean;
-}, Error, {
-    id: string;
-}, unknown>;
-/**
- * Hook for searching posts by a free-text query. Uses `usePosts` under the hood.
- * Debounces the query and preserves last successful results to avoid flicker.
- */
-declare function usePostSearch({ query, enabled, debounceMs, limit, published, }: UsePostSearchOptions): UsePostSearchResult;
-/**
- * Options for the useNextPreviousPosts hook
- */
-interface UseNextPreviousPostsOptions {
-    /** Whether to enable the query (default: true) */
-    enabled?: boolean;
-}
-/**
- * Result from the useNextPreviousPosts hook
- */
-interface UseNextPreviousPostsResult {
-    /** The previous post (older), or null if none exists */
-    previousPost: SerializedPost | null;
-    /** The next post (newer), or null if none exists */
-    nextPost: SerializedPost | null;
-    /** Whether the query is loading */
-    isLoading: boolean;
-    /** Error if the query failed */
-    error: Error | null;
-    /** Function to refetch the posts */
-    refetch: () => void;
-}
-/**
- * Hook for fetching previous and next posts relative to a given date
- * Uses useInView to only fetch when the component is in view
- */
-declare function useNextPreviousPosts(createdAt: string | Date, options?: UseNextPreviousPostsOptions): UseNextPreviousPostsResult & {
-    ref: (node: Element | null) => void;
-    inView: boolean;
-};
-/**
- * Options for the useRecentPosts hook
- */
-interface UseRecentPostsOptions {
-    /** Maximum number of recent posts to fetch (default: 5) */
-    limit?: number;
-    /** Slug of a post to exclude from results */
-    excludeSlug?: string;
-    /** Whether to enable the query (default: true) */
-    enabled?: boolean;
-}
-/**
- * Result from the useRecentPosts hook
- */
-interface UseRecentPostsResult {
-    /** Array of recent posts */
-    recentPosts: SerializedPost[];
-    /** Whether the query is loading */
-    isLoading: boolean;
-    /** Error if the query failed */
-    error: Error | null;
-    /** Function to refetch the posts */
-    refetch: () => void;
-}
-/**
- * Hook for fetching recent posts
- * Uses useInView to only fetch when the component is in view
- */
-declare function useRecentPosts(options?: UseRecentPostsOptions): UseRecentPostsResult & {
-    ref: (node: Element | null) => void;
-    inView: boolean;
-};
+declare function useDebounce<T>(value: T, delay?: number): T;
+declare function useThrottle<T>(value: T, wait?: number): T;
 
-export { useCreatePost, useDeletePost, useNextPreviousPosts, usePost, usePostSearch, usePosts, useRecentPosts, useSuspensePost, useSuspensePosts, useSuspenseTags, useTags, useUpdatePost };
-export type { PostCreateInput, PostUpdateInput, UseNextPreviousPostsOptions, UseNextPreviousPostsResult, UsePostResult, UsePostSearchOptions, UsePostSearchResult, UsePostsOptions, UsePostsResult, UseRecentPostsOptions, UseRecentPostsResult };
+export { useDebounce, useThrottle };

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

@@ -1 +1,2 @@
 export { useCreatePost, useDeletePost, useNextPreviousPosts, usePost, usePostSearch, usePosts, useRecentPosts, useSuspensePost, useSuspensePosts, useSuspenseTags, useTags, useUpdatePost } from '../../../../packages/stack/src/plugins/blog/client/hooks/blog-hooks.mjs';
+export { useDebounce, useThrottle } from '../../../../packages/stack/src/plugins/blog/client/hooks/use-debounce.mjs';

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

@@ -1,10 +1,9 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
-import * as react from 'react';
-import { ComponentType } from 'react';
 import * as _btst_yar from '@btst/yar';
+import { ComponentType } from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { P as Post, S as SerializedPost } from '../../../shared/stack.BWp0hcm9.cjs';
-export { UsePostsOptions, UsePostsResult } from './hooks/index.cjs';
+import { P as Post, S as SerializedPost } from '../../../shared/stack.BQmuNl5p.cjs';
+export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.BwA7trxA.cjs';
 import 'zod';
 
 /**
@@ -71,6 +70,31 @@ interface BlogClientConfig {
     hooks?: BlogClientHooks;
     /** Optional headers for SSR (e.g., forwarding cookies) */
     headers?: Headers;
+    /**
+     * Optional page component overrides.
+     * Replace any plugin page with a custom React component.
+     * The built-in component is used as the fallback when not provided.
+     */
+    pageComponents?: {
+        /** Replaces the published posts list page */
+        posts?: ComponentType;
+        /** Replaces the drafts list page */
+        drafts?: ComponentType;
+        /** Replaces the new post page */
+        newPost?: ComponentType;
+        /** Replaces the single post page */
+        post?: ComponentType<{
+            slug: string;
+        }>;
+        /** Replaces the edit post page */
+        editPost?: ComponentType<{
+            slug: string;
+        }>;
+        /** Replaces the tag posts page */
+        tag?: ComponentType<{
+            tagSlug: string;
+        }>;
+    };
 }
 /**
  * Hooks for blog client plugin
@@ -133,9 +157,9 @@ interface BlogClientHooks {
 declare const blogClientPlugin: (config: BlogClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
     posts: {
         (inputCtx_0?: _btst_yar.InputContext<"/blog", _btst_yar.RouteOptions> | undefined): {
-            PageComponent?: react.ComponentType<unknown> | undefined;
-            LoadingComponent?: react.ComponentType<unknown> | undefined;
-            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            PageComponent?: ComponentType<{}> | undefined;
+            LoadingComponent?: ComponentType<{}> | undefined;
+            ErrorComponent?: ComponentType<{}> | undefined;
             loader?: (() => Promise<void>) | undefined;
             meta?: (() => ({
                 title: string;
@@ -161,9 +185,9 @@ declare const blogClientPlugin: (config: BlogClientConfig) => _btst_stack_plugin
     };
     drafts: {
         (inputCtx_0?: _btst_yar.InputContext<"/blog/drafts", _btst_yar.RouteOptions> | undefined): {
-            PageComponent?: react.ComponentType<unknown> | undefined;
-            LoadingComponent?: react.ComponentType<unknown> | undefined;
-            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            PageComponent?: ComponentType<{}> | undefined;
+            LoadingComponent?: ComponentType<{}> | undefined;
+            ErrorComponent?: ComponentType<{}> | undefined;
             loader?: (() => Promise<void>) | undefined;
             meta?: (() => ({
                 title: string;
@@ -189,9 +213,9 @@ declare const blogClientPlugin: (config: BlogClientConfig) => _btst_stack_plugin
     };
     newPost: {
         (inputCtx_0?: _btst_yar.InputContext<"/blog/new", _btst_yar.RouteOptions> | undefined): {
-            PageComponent?: react.ComponentType<unknown> | undefined;
-            LoadingComponent?: react.ComponentType<unknown> | undefined;
-            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            PageComponent?: ComponentType<{}> | undefined;
+            LoadingComponent?: ComponentType<{}> | undefined;
+            ErrorComponent?: ComponentType<{}> | undefined;
             loader?: (() => Promise<void>) | undefined;
             meta?: (() => ({
                 title: string;
@@ -217,9 +241,9 @@ declare const blogClientPlugin: (config: BlogClientConfig) => _btst_stack_plugin
     };
     editPost: {
         (inputCtx_0: _btst_yar.InputContext<"/blog/:slug/edit", _btst_yar.RouteOptions>): {
-            PageComponent?: react.ComponentType<unknown> | undefined;
-            LoadingComponent?: react.ComponentType<unknown> | undefined;
-            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            PageComponent?: ComponentType<unknown> | undefined;
+            LoadingComponent?: ComponentType<unknown> | undefined;
+            ErrorComponent?: ComponentType<unknown> | undefined;
             loader?: (() => Promise<void>) | undefined;
             meta?: (() => ({
                 title: string;
@@ -245,9 +269,9 @@ declare const blogClientPlugin: (config: BlogClientConfig) => _btst_stack_plugin
     };
     tag: {
         (inputCtx_0: _btst_yar.InputContext<"/blog/tag/:tagSlug", _btst_yar.RouteOptions>): {
-            PageComponent?: react.ComponentType<unknown> | undefined;
-            LoadingComponent?: react.ComponentType<unknown> | undefined;
-            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            PageComponent?: ComponentType<unknown> | undefined;
+            LoadingComponent?: ComponentType<unknown> | undefined;
+            ErrorComponent?: ComponentType<unknown> | undefined;
             loader?: (() => Promise<void>) | undefined;
             meta?: (() => ({
                 title: string;
@@ -273,9 +297,9 @@ declare const blogClientPlugin: (config: BlogClientConfig) => _btst_stack_plugin
     };
     post: {
         (inputCtx_0: _btst_yar.InputContext<"/blog/:slug", _btst_yar.RouteOptions>): {
-            PageComponent?: react.ComponentType<unknown> | undefined;
-            LoadingComponent?: react.ComponentType<unknown> | undefined;
-            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            PageComponent?: ComponentType<unknown> | undefined;
+            LoadingComponent?: ComponentType<unknown> | undefined;
+            ErrorComponent?: ComponentType<unknown> | undefined;
             loader?: (() => Promise<void>) | undefined;
             meta?: (() => ({
                 title: string;