nnews-react 0.0.3

package/dist/index.d.ts

@@ -0,0 +1,534 @@
+import * as AvatarPrimitive from '@radix-ui/react-avatar';
+import { AxiosInstance } from 'axios';
+import { ClassProp } from 'class-variance-authority/types';
+import { ClassValue } from 'clsx';
+import { default as default_2 } from 'react';
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+import * as LabelPrimitive from '@radix-ui/react-label';
+import * as React_2 from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+export declare interface Article {
+    id: number;
+    articleId?: number;
+    categoryId?: number;
+    authorId?: number;
+    title: string;
+    subtitle?: string;
+    excerpt?: string;
+    content: string;
+    status: ArticleStatus;
+    author?: string;
+    category?: Category;
+    tags?: Tag[];
+    visibleToRoles?: string[];
+    createdAt?: string | Date;
+    updatedAt?: string | Date;
+}
+
+export declare class ArticleAPI {
+    private client;
+    constructor(client: AxiosInstance);
+    /**
+     * List articles with optional filtering by category
+     */
+    listArticles(categoryId?: number, page?: number, pageSize?: number): Promise<PagedResult<Article>>;
+    /**
+     * Filter articles by roles and parent category
+     */
+    filterArticles(roles?: string[], parentId?: number, page?: number, pageSize?: number): Promise<PagedResult<Article>>;
+    /**
+     * Get a single article by ID
+     */
+    getArticleById(id: number): Promise<Article>;
+    /**
+     * Create a new article
+     */
+    createArticle(article: ArticleInput): Promise<Article>;
+    /**
+     * Update an existing article
+     */
+    updateArticle(article: ArticleUpdate): Promise<Article>;
+    /**
+     * Delete an article
+     */
+    deleteArticle(id: number): Promise<void>;
+    /**
+     * Transform date strings to Date objects for a single article
+     */
+    private transformArticleDate;
+    /**
+     * Transform date strings to Date objects for paged results
+     */
+    private transformArticleDates;
+}
+
+export declare function ArticleEditor({ article, categories, tags, onSave, onCancel, loading, }: ArticleEditorProps_2): JSX_2.Element;
+
+export declare interface ArticleEditorProps {
+    articleId?: number;
+    initialData?: Partial<ArticleInput>;
+    onSave?: (article: Article) => void;
+    onCancel?: () => void;
+    showPreview?: boolean;
+    enableAutoSave?: boolean;
+    className?: string;
+}
+
+declare interface ArticleEditorProps_2 {
+    article?: Article | null;
+    categories?: Category[];
+    tags?: Tag[];
+    onSave: (article: ArticleInput | ArticleUpdate) => Promise<void>;
+    onCancel: () => void;
+    loading?: boolean;
+}
+
+export declare interface ArticleInput {
+    title: string;
+    subtitle?: string;
+    excerpt?: string;
+    content: string;
+    status: ArticleStatus;
+    author?: string;
+    categoryId?: number;
+    tagIds?: number[];
+    visibleToRoles?: string[];
+}
+
+export declare function ArticleList({ articles, loading, error, onArticleClick, onEditClick, onDeleteClick, showActions, emptyMessage, }: ArticleListProps_2): JSX_2.Element;
+
+export declare interface ArticleListProps {
+    categoryId?: number;
+    status?: ArticleStatus;
+    page?: number;
+    pageSize?: number;
+    onEdit?: (article: Article) => void;
+    onDelete?: (articleId: number) => void;
+    onView?: (article: Article) => void;
+    showCreateButton?: boolean;
+    className?: string;
+}
+
+declare interface ArticleListProps_2 {
+    articles: PagedResult<Article> | null;
+    loading?: boolean;
+    error?: Error | null;
+    onArticleClick?: (article: Article) => void;
+    onEditClick?: (article: Article) => void;
+    onDeleteClick?: (article: Article) => void;
+    showActions?: boolean;
+    emptyMessage?: string;
+}
+
+export declare interface ArticleSearchParams {
+    categoryId?: number;
+    status?: ArticleStatus;
+    tags?: number[];
+    roles?: string[];
+    searchTerm?: string;
+    page?: number;
+    pageSize?: number;
+}
+
+export declare enum ArticleStatus {
+    Draft = 0,
+    Published = 1,
+    Archived = 2
+}
+
+export declare interface ArticleUpdate extends ArticleInput {
+    id: number;
+    articleId?: number;
+}
+
+export declare function ArticleViewer({ article, onBack, onEdit, showActions, }: ArticleViewerProps_2): JSX_2.Element;
+
+export declare interface ArticleViewerProps {
+    articleId?: number;
+    article?: Article;
+    onEdit?: (article: Article) => void;
+    onBack?: () => void;
+    showMetadata?: boolean;
+    className?: string;
+}
+
+declare interface ArticleViewerProps_2 {
+    article: Article;
+    onBack?: () => void;
+    onEdit?: (article: Article) => void;
+    showActions?: boolean;
+}
+
+export declare const Avatar: React_2.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarProps & React_2.RefAttributes<HTMLSpanElement>, "ref"> & React_2.RefAttributes<HTMLSpanElement>>;
+
+export declare const AvatarFallback: React_2.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarFallbackProps & React_2.RefAttributes<HTMLSpanElement>, "ref"> & React_2.RefAttributes<HTMLSpanElement>>;
+
+export declare const AvatarImage: React_2.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarImageProps & React_2.RefAttributes<HTMLImageElement>, "ref"> & React_2.RefAttributes<HTMLImageElement>>;
+
+export declare const Button: React_2.ForwardRefExoticComponent<ButtonProps & React_2.RefAttributes<HTMLButtonElement>>;
+
+declare interface ButtonProps extends React_2.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+}
+
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "default" | "sm" | "lg" | "icon" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare interface Category {
+    id: number;
+    categoryId?: number;
+    parentId?: number;
+    title: string;
+    slug?: string;
+    description?: string;
+    visibleToRoles?: string[];
+    createdAt?: Date;
+    updatedAt?: Date;
+    articleCount?: number;
+}
+
+export declare class CategoryAPI {
+    private client;
+    constructor(client: AxiosInstance);
+    /**
+     * List all categories
+     */
+    listCategories(): Promise<Category[]>;
+    /**
+     * Filter categories by roles and parent category
+     */
+    filterCategories(roles?: string[], parentId?: number): Promise<Category[]>;
+    /**
+     * Get a single category by ID
+     */
+    getCategoryById(id: number): Promise<Category>;
+    /**
+     * Create a new category
+     */
+    createCategory(category: CategoryInput): Promise<Category>;
+    /**
+     * Update an existing category
+     */
+    updateCategory(category: CategoryUpdate): Promise<Category>;
+    /**
+     * Delete a category
+     */
+    deleteCategory(id: number): Promise<void>;
+    /**
+     * Transform date strings to Date objects for a single category
+     */
+    private transformCategoryDate;
+    /**
+     * Transform date strings to Date objects for category arrays
+     */
+    private transformCategoryDates;
+}
+
+export declare interface CategoryFilterParams {
+    roles?: string[];
+    parentId?: number;
+    searchTerm?: string;
+}
+
+export declare interface CategoryInput {
+    title: string;
+    slug?: string;
+    description?: string;
+    parentId?: number;
+    visibleToRoles?: string[];
+}
+
+export declare function CategoryList({ categories, loading, error, onCategoryClick, onEditClick, onDeleteClick, showActions, emptyMessage, }: CategoryListProps_2): JSX_2.Element;
+
+export declare interface CategoryListProps {
+    onEdit?: (category: Category) => void;
+    onDelete?: (categoryId: number) => void;
+    showCreateButton?: boolean;
+    className?: string;
+}
+
+declare interface CategoryListProps_2 {
+    categories: Category[];
+    loading?: boolean;
+    error?: Error | null;
+    onCategoryClick?: (category: Category) => void;
+    onEditClick?: (category: Category) => void;
+    onDeleteClick?: (category: Category) => void;
+    showActions?: boolean;
+    emptyMessage?: string;
+}
+
+export declare function CategoryModal({ category, categories, isOpen, onClose, onSave, loading, }: CategoryModalProps_2): JSX_2.Element | null;
+
+export declare interface CategoryModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    category?: Category;
+    onSave?: (category: Category) => void;
+}
+
+declare interface CategoryModalProps_2 {
+    category?: Category | null;
+    categories?: Category[];
+    isOpen: boolean;
+    onClose: () => void;
+    onSave: (category: CategoryInput | CategoryUpdate) => Promise<void>;
+    loading?: boolean;
+}
+
+export declare interface CategoryUpdate extends CategoryInput {
+    id: number;
+    categoryId?: number;
+}
+
+export declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * Debounce function
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
+
+/**
+ * Format document (CPF or CNPJ)
+ */
+export declare function formatDocument(document: string): string;
+
+/**
+ * Format phone number to Brazilian format
+ */
+export declare function formatPhone(phone: string): string;
+
+/**
+ * Format ZIP code (CEP)
+ */
+export declare function formatZipCode(zipCode: string): string;
+
+export declare const Input: React_2.ForwardRefExoticComponent<InputProps & React_2.RefAttributes<HTMLInputElement>>;
+
+declare type InputProps = React_2.InputHTMLAttributes<HTMLInputElement>;
+
+export declare const Label: React_2.ForwardRefExoticComponent<Omit<LabelPrimitive.LabelProps & React_2.RefAttributes<HTMLLabelElement>, "ref"> & VariantProps<(props?: ClassProp | undefined) => string> & React_2.RefAttributes<HTMLLabelElement>>;
+
+export declare function MarkdownEditor({ value, onChange, placeholder, label, error, minHeight, }: MarkdownEditorProps): JSX_2.Element;
+
+declare interface MarkdownEditorProps {
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    label?: string;
+    error?: string;
+    minHeight?: string;
+}
+
+export declare interface NNewsConfig {
+    apiUrl: string;
+    apiClient?: AxiosInstance;
+}
+
+export declare interface NNewsContextValue {
+    config: NNewsConfig;
+    apiClient: AxiosInstance;
+    articleApi: ArticleAPI;
+    categoryApi: CategoryAPI;
+    tagApi: TagAPI;
+}
+
+export declare function NNewsProvider({ config, children }: NNewsProviderProps): JSX_2.Element;
+
+export declare interface NNewsProviderProps {
+    config: NNewsConfig;
+    children: default_2.ReactNode;
+}
+
+declare interface PagedResult<T> {
+    items: T[];
+    page: number;
+    pageSize: number;
+    totalCount: number;
+    totalPages: number;
+    hasPrevious: boolean;
+    hasNext: boolean;
+}
+
+/**
+ * Validate password strength
+ */
+export declare interface PasswordStrength {
+    score: number;
+    feedback: string[];
+    isValid: boolean;
+}
+
+export declare interface Tag {
+    id: number;
+    tagId?: number;
+    title: string;
+    slug?: string;
+    articleCount?: number;
+}
+
+export declare class TagAPI {
+    private client;
+    constructor(client: AxiosInstance);
+    /**
+     * List all tags
+     */
+    listTags(): Promise<Tag[]>;
+    /**
+     * Get a single tag by ID
+     */
+    getTagById(id: number): Promise<Tag>;
+    /**
+     * Create a new tag
+     */
+    createTag(tag: TagInput): Promise<Tag>;
+    /**
+     * Update an existing tag
+     */
+    updateTag(tag: TagUpdate): Promise<Tag>;
+    /**
+     * Delete a tag
+     */
+    deleteTag(id: number): Promise<void>;
+    /**
+     * Merge two tags (move all articles from source to target, then delete source)
+     */
+    mergeTags(sourceTagId: number, targetTagId: number): Promise<void>;
+}
+
+export declare interface TagInput {
+    title: string;
+    slug?: string;
+}
+
+export declare function TagList({ tags, loading, error, onTagClick, onEditClick, onDeleteClick, showActions, emptyMessage, }: TagListProps_2): JSX_2.Element;
+
+export declare interface TagListProps {
+    onEdit?: (tag: Tag) => void;
+    onDelete?: (tagId: number) => void;
+    onMerge?: (sourceId: number, targetId: number) => void;
+    showCreateButton?: boolean;
+    className?: string;
+}
+
+declare interface TagListProps_2 {
+    tags: Tag[];
+    loading?: boolean;
+    error?: Error | null;
+    onTagClick?: (tag: Tag) => void;
+    onEditClick?: (tag: Tag) => void;
+    onDeleteClick?: (tag: Tag) => void;
+    showActions?: boolean;
+    emptyMessage?: string;
+}
+
+export declare function TagModal({ tag, isOpen, onClose, onSave, loading, }: TagModalProps_2): JSX_2.Element | null;
+
+export declare interface TagModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    tag?: Tag;
+    onSave?: (tag: Tag) => void;
+}
+
+declare interface TagModalProps_2 {
+    tag?: Tag | null;
+    isOpen: boolean;
+    onClose: () => void;
+    onSave: (tag: TagInput | TagUpdate) => Promise<void>;
+    loading?: boolean;
+}
+
+export declare interface TagSearchParams {
+    searchTerm?: string;
+    page?: number;
+    pageSize?: number;
+}
+
+export declare interface TagUpdate extends TagInput {
+    id: number;
+    tagId?: number;
+}
+
+/**
+ * Throttle function
+ */
+export declare function throttle<T extends (...args: any[]) => any>(func: T, limit: number): (...args: Parameters<T>) => void;
+
+export declare function useArticles(): UseArticlesResult;
+
+export declare interface UseArticlesResult {
+    articles: PagedResult<Article> | null;
+    loading: boolean;
+    error: Error | null;
+    fetchArticles: (params?: ArticleSearchParams) => Promise<void>;
+    getArticleById: (id: number) => Promise<Article>;
+    createArticle: (article: ArticleInput) => Promise<Article>;
+    updateArticle: (article: ArticleUpdate) => Promise<Article>;
+    deleteArticle: (id: number) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+
+export declare function useCategories(): UseCategoriesResult;
+
+export declare interface UseCategoriesResult {
+    categories: Category[];
+    loading: boolean;
+    error: Error | null;
+    fetchCategories: (params?: CategoryFilterParams) => Promise<void>;
+    getCategoryById: (id: number) => Promise<Category>;
+    createCategory: (category: CategoryInput) => Promise<Category>;
+    updateCategory: (category: CategoryUpdate) => Promise<Category>;
+    deleteCategory: (id: number) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+
+export declare function useNNews(): NNewsContextValue;
+
+export declare function useTags(): UseTagsResult;
+
+export declare interface UseTagsResult {
+    tags: Tag[];
+    loading: boolean;
+    error: Error | null;
+    fetchTags: (params?: TagSearchParams) => Promise<void>;
+    getTagById: (id: number) => Promise<Tag>;
+    createTag: (tag: TagInput) => Promise<Tag>;
+    updateTag: (tag: TagUpdate) => Promise<Tag>;
+    deleteTag: (id: number) => Promise<void>;
+    mergeTags: (sourceId: number, targetId: number) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+
+/**
+ * Validate CNPJ (Brazilian company taxpayer registry)
+ */
+export declare function validateCNPJ(cnpj: string): boolean;
+
+/**
+ * Validate CPF (Brazilian individual taxpayer registry)
+ */
+export declare function validateCPF(cpf: string): boolean;
+
+/**
+ * Validate email address
+ */
+export declare function validateEmail(email: string): boolean;
+
+export declare function validatePasswordStrength(password: string, options?: {
+    minLength?: number;
+    requireUppercase?: boolean;
+    requireLowercase?: boolean;
+    requireNumbers?: boolean;
+    requireSpecialChars?: boolean;
+}): PasswordStrength;
+
+/**
+ * Validate Brazilian phone number
+ */
+export declare function validatePhone(phone: string): boolean;
+
+export { }