@btst/stack 2.5.5 → 2.6.0

package/dist/plugins/ui-builder/client/index.d.ts

@@ -1,10 +1,9 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
-import * as react from 'react';
-import react__default, { ComponentType } from 'react';
 import * as _btst_yar from '@btst/yar';
+import React__default, { ComponentType } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { c as UIBuilderClientHooks } from '../../../shared/stack.B2DwzF3r.js';
-import { a as ComponentRegistry, b as FieldConfigFunction, C as ComponentLayer } from '../../../shared/stack.D0QupDcQ.js';
+import { a as ComponentRegistry, b as FieldConfigFunction, C as ComponentLayer, F as FunctionRegistry } from '../../../shared/stack.D0QupDcQ.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { A as AutoFormInputComponentProps, F as FieldConfigItem } from '../../../shared/stack.8nldKomx.js';
 export { PageBuilderPage, PageListPage, PageRenderer, PageRendererProps, SuspensePageRenderer } from './components/index.js';
@@ -32,6 +31,21 @@ interface UIBuilderClientConfig {
     hooks?: UIBuilderClientHooks;
     /** Component registry to use for the UI Builder */
     componentRegistry?: ComponentRegistry;
+    /**
+     * 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 page list page */
+        pageList?: ComponentType;
+        /** Replaces the new page builder page */
+        newPage?: ComponentType;
+        /** Replaces the edit page builder page */
+        editPage?: ComponentType<{
+            id: string;
+        }>;
+    };
 }
 /**
  * UI Builder client plugin
@@ -64,9 +78,9 @@ interface UIBuilderClientConfig {
 declare const uiBuilderClientPlugin: (config: UIBuilderClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
     pageList: {
         (inputCtx_0?: _btst_yar.InputContext<"/ui-builder", _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;
@@ -85,9 +99,9 @@ declare const uiBuilderClientPlugin: (config: UIBuilderClientConfig) => _btst_st
     };
     newPage: {
         (inputCtx_0?: _btst_yar.InputContext<"/ui-builder/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;
@@ -106,9 +120,9 @@ declare const uiBuilderClientPlugin: (config: UIBuilderClientConfig) => _btst_st
     };
     editPage: {
         (inputCtx_0: _btst_yar.InputContext<"/ui-builder/:id/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;
@@ -202,20 +216,20 @@ declare function createComponentRegistry(components: ComponentRegistry): Compone
 declare const classNameFieldOverrides: FieldConfigFunction;
 declare const childrenFieldOverrides: (layer: ComponentLayer, allowVariableBinding?: boolean) => {
     renderParent: (({ children }: {
-        children: react__default.ReactNode;
+        children: React__default.ReactNode;
     }) => react_jsx_runtime.JSX.Element) | undefined;
     fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
 };
 declare const iconNameFieldOverrides: FieldConfigFunction;
 declare const childrenAsTextareaFieldOverrides: (layer: ComponentLayer, allowVariableBinding?: boolean) => {
     renderParent: (({ children }: {
-        children: react__default.ReactNode;
+        children: React__default.ReactNode;
     }) => react_jsx_runtime.JSX.Element) | undefined;
     fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
 };
 declare const childrenAsTipTapFieldOverrides: (layer: ComponentLayer, allowVariableBinding?: boolean) => {
     renderParent: (({ children }: {
-        children: react__default.ReactNode;
+        children: React__default.ReactNode;
     }) => react_jsx_runtime.JSX.Element) | undefined;
     fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
 };
@@ -223,7 +237,7 @@ declare const commonFieldOverrides: (allowBinding?: boolean) => Record<string, (
     className: (layer: ComponentLayer) => FieldConfigItem;
     children: (layer: ComponentLayer) => {
         renderParent: (({ children }: {
-            children: react__default.ReactNode;
+            children: React__default.ReactNode;
         }) => react_jsx_runtime.JSX.Element) | undefined;
         fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
     };
@@ -342,6 +356,11 @@ interface UIBuilderPluginOverrides {
      * Component registry for the UI Builder
      */
     componentRegistry?: ComponentRegistry;
+    /**
+     * Function registry for resolving bindable event handlers (onClick, onSubmit, etc.)
+     * in the preview modal and layer renderer.
+     */
+    functionRegistry?: FunctionRegistry;
     /**
      * Base path for UI Builder admin pages (default: /pages/ui-builder)
      */

package/dist/shared/stack.CNLHlv7r.d.mts

@@ -0,0 +1,228 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from './stack.BWp0hcm9.mjs';
+import { z } from '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;
+};
+
+export { useSuspensePosts as f, usePost as g, useSuspensePost as h, useTags as i, useSuspenseTags as j, useCreatePost as k, useUpdatePost as l, useDeletePost as m, usePostSearch as n, useNextPreviousPosts as q, useRecentPosts as t, usePosts as u };
+export type { PostCreateInput as P, UsePostsOptions as U, UsePostsResult as a, UsePostSearchOptions as b, UsePostSearchResult as c, UsePostResult as d, PostUpdateInput as e, UseNextPreviousPostsOptions as o, UseNextPreviousPostsResult as p, UseRecentPostsOptions as r, UseRecentPostsResult as s };

package/dist/shared/stack.CQAZwXhV.d.cts

@@ -0,0 +1,228 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from './stack.BWp0hcm9.cjs';
+import { z } from '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;
+};
+
+export { useSuspensePosts as f, usePost as g, useSuspensePost as h, useTags as i, useSuspenseTags as j, useCreatePost as k, useUpdatePost as l, useDeletePost as m, usePostSearch as n, useNextPreviousPosts as q, useRecentPosts as t, usePosts as u };
+export type { PostCreateInput as P, UsePostsOptions as U, UsePostsResult as a, UsePostSearchOptions as b, UsePostSearchResult as c, UsePostResult as d, PostUpdateInput as e, UseNextPreviousPostsOptions as o, UseNextPreviousPostsResult as p, UseRecentPostsOptions as r, UseRecentPostsResult as s };