@wakastellar/ui 3.2.0 → 3.3.2

package/dist/src/components/waka-credit-top-up/index.d.ts

@@ -0,0 +1,26 @@
+import { CreditPack } from '../waka-credit-balance/types';
+export interface WakaCreditTopUpProps {
+    /** Available credit packs to choose from */
+    packs: CreditPack[];
+    /** Current balance (shown in summary if provided) */
+    currentBalance?: number;
+    /** Allow custom amount entry */
+    customAmount?: boolean;
+    /** Minimum custom credits */
+    minAmount?: number;
+    /** Maximum custom credits */
+    maxAmount?: number;
+    /** Currency label */
+    currency?: string;
+    /** Called when user confirms purchase */
+    onPurchase: (selection: CreditPack | {
+        credits: number;
+        price: number;
+    }) => void;
+    /** Called when user cancels */
+    onCancel?: () => void;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WakaCreditTopUp({ packs, currentBalance, customAmount, minAmount, maxAmount, currency, onPurchase, onCancel, className, }: WakaCreditTopUpProps): import("react/jsx-runtime").JSX.Element;
+export default WakaCreditTopUp;

package/dist/src/components/waka-credit-transaction/index.d.ts

@@ -0,0 +1,22 @@
+import { CreditTransaction } from '../waka-credit-balance/types';
+export type { CreditTransaction, CreditTransactionType, CreditTransactionStatus } from '../waka-credit-balance/types';
+export interface WakaCreditTransactionProps {
+    /** The transaction to display */
+    transaction: CreditTransaction;
+    /** Show the service name column */
+    showService?: boolean;
+    /** Show the status badge column */
+    showStatus?: boolean;
+    /** Use compact single-line layout */
+    compact?: boolean;
+    /** Custom amount formatter */
+    formatAmount?: (amount: number) => string;
+    /** Custom date formatter */
+    formatDate?: (date: string | Date) => string;
+    /** Click handler for the transaction row */
+    onClick?: (transaction: CreditTransaction) => void;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WakaCreditTransaction({ transaction, showService, showStatus, compact, formatAmount, formatDate, onClick, className, }: WakaCreditTransactionProps): import("react/jsx-runtime").JSX.Element;
+export default WakaCreditTransaction;

package/dist/src/components/waka-credit-transfer-form/index.d.ts

@@ -0,0 +1,27 @@
+export interface TransferOrganization {
+    id: string;
+    name: string;
+    balance?: number;
+}
+export interface WakaCreditTransferFormProps {
+    /** Maximum amount that can be transferred */
+    maxAmount: number;
+    /** List of organizations available as transfer destinations */
+    organizations: TransferOrganization[];
+    /** Source organization (displayed read-only if provided) */
+    sourceOrganization?: TransferOrganization;
+    /** Callback when the transfer form is submitted */
+    onTransfer: (data: {
+        toOrgId: string;
+        amount: number;
+        reason: string;
+    }) => void;
+    /** Callback when the cancel button is clicked */
+    onCancel?: () => void;
+    /** Loading state for the transfer button */
+    loading?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WakaCreditTransferForm({ maxAmount, organizations, sourceOrganization, onTransfer, onCancel, loading, className, }: WakaCreditTransferFormProps): import("react/jsx-runtime").JSX.Element;
+export default WakaCreditTransferForm;

package/dist/src/components/waka-credit-usage-chart/index.d.ts

@@ -0,0 +1,34 @@
+export interface UsageDataPoint {
+    date: string;
+    value: number;
+}
+export interface WakaCreditUsageChartProps {
+    /** Array of data points with date and value */
+    data: UsageDataPoint[];
+    /** Optional comparison dataset (previous period) rendered as dashed/lighter area */
+    compareWith?: UsageDataPoint[];
+    /** Time period granularity */
+    period?: "day" | "week" | "month" | "year";
+    /** Whether to stack the areas */
+    stacked?: boolean;
+    /** Chart height in pixels */
+    height?: number;
+    /** Show the legend below the chart */
+    showLegend?: boolean;
+    /** Show the cartesian grid */
+    showGrid?: boolean;
+    /** Enable chart animations */
+    animated?: boolean;
+    /** Primary area color */
+    color?: string;
+    /** Comparison area color */
+    compareColor?: string;
+    /** Custom value formatter for tooltip and Y axis */
+    formatValue?: (value: number) => string;
+    /** Callback when the period selector is changed; renders period tabs when provided */
+    onPeriodChange?: (period: string) => void;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WakaCreditUsageChart({ data, compareWith, period, stacked, height, showLegend, showGrid, animated, color, compareColor, formatValue, onPeriodChange, className, }: WakaCreditUsageChartProps): import("react/jsx-runtime").JSX.Element;
+export default WakaCreditUsageChart;

package/dist/src/components/waka-doc-breadcrumb/index.d.ts

@@ -0,0 +1,11 @@
+export interface BreadcrumbItem {
+    id: string;
+    label: string;
+    href?: string;
+}
+export interface WakaDocBreadcrumbProps {
+    items: BreadcrumbItem[];
+    onItemClick?: (item: BreadcrumbItem) => void;
+    className?: string;
+}
+export declare function WakaDocBreadcrumb({ items, onItemClick, className }: WakaDocBreadcrumbProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/components/waka-doc-callout/index.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+export type CalloutType = "info" | "warning" | "danger" | "tip";
+export interface WakaDocCalloutProps {
+    type?: CalloutType;
+    title?: string;
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function WakaDocCallout({ type, title, children, className, }: WakaDocCalloutProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/waka-doc-code-block/index.d.ts

@@ -0,0 +1,9 @@
+export interface WakaDocCodeBlockProps {
+    code: string;
+    language?: string;
+    filename?: string;
+    showLineNumbers?: boolean;
+    highlightLines?: number[];
+    className?: string;
+}
+export declare function WakaDocCodeBlock({ code, language, filename, showLineNumbers, highlightLines, className, }: WakaDocCodeBlockProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/waka-doc-nav/index.d.ts

@@ -0,0 +1,16 @@
+import * as React from "react";
+export interface DocNavItem {
+    id: string;
+    label: string;
+    href?: string;
+    icon?: React.ReactNode;
+    children?: DocNavItem[];
+    badge?: string;
+}
+export interface WakaDocNavProps {
+    items: DocNavItem[];
+    activeId?: string;
+    onItemClick?: (item: DocNavItem) => void;
+    className?: string;
+}
+export declare function WakaDocNav({ items, activeId, onItemClick, className }: WakaDocNavProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/waka-doc-renderer/index.d.ts

@@ -0,0 +1,7 @@
+import { TocItem } from '../waka-doc-toc';
+export interface WakaDocRendererProps {
+    content: string;
+    onHeadingsExtracted?: (headings: TocItem[]) => void;
+    className?: string;
+}
+export declare function WakaDocRenderer({ content, onHeadingsExtracted, className }: WakaDocRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/waka-doc-search/index.d.ts

@@ -0,0 +1,18 @@
+export interface DocSearchPage {
+    id: string;
+    title: string;
+    content: string;
+    category?: string;
+    href?: string;
+}
+export interface DocSearchResult {
+    page: DocSearchPage;
+    snippet: string;
+}
+export interface WakaDocSearchProps {
+    pages: DocSearchPage[];
+    onSelect?: (page: DocSearchPage) => void;
+    placeholder?: string;
+    className?: string;
+}
+export declare function WakaDocSearch({ pages, onSelect, placeholder, className, }: WakaDocSearchProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/waka-doc-table/index.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+export interface WakaDocTableProps {
+    children: React.ReactNode;
+    stickyHeader?: boolean;
+    striped?: boolean;
+    className?: string;
+}
+export declare function WakaDocTable({ children, stickyHeader, striped, className, }: WakaDocTableProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/waka-doc-toc/index.d.ts

@@ -0,0 +1,11 @@
+export interface TocItem {
+    id: string;
+    text: string;
+    level: number;
+}
+export interface WakaDocTocProps {
+    items: TocItem[];
+    activeId?: string;
+    className?: string;
+}
+export declare function WakaDocToc({ items, activeId, className }: WakaDocTocProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/components/waka-doc-toolbar/index.d.ts

@@ -0,0 +1,10 @@
+export type SaveStatus = "idle" | "saving" | "saved" | "error";
+export interface WakaDocToolbarProps {
+    content: string;
+    mode?: "view" | "edit";
+    canEdit?: boolean;
+    onModeChange?: (mode: "view" | "edit") => void;
+    saveStatus?: SaveStatus;
+    className?: string;
+}
+export declare function WakaDocToolbar({ content, mode, canEdit, onModeChange, saveStatus, className, }: WakaDocToolbarProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/waka-doc-version/index.d.ts

@@ -0,0 +1,13 @@
+export type VersionStatus = "latest" | "stable" | "beta" | "deprecated" | "rc";
+export interface DocVersion {
+    id: string;
+    label: string;
+    status?: VersionStatus;
+}
+export interface WakaDocVersionProps {
+    versions: DocVersion[];
+    current: string;
+    onVersionChange: (versionId: string) => void;
+    className?: string;
+}
+export declare function WakaDocVersion({ versions, current, onVersionChange, className }: WakaDocVersionProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/waka-document-flyover/index.d.ts

@@ -0,0 +1,10 @@
+export interface DocumentFlyoverProps {
+    name: string;
+    extension: string;
+    sizeKb: number;
+    lastModified: string;
+    author: string;
+    onClick: () => void;
+}
+declare function DocumentFlyover({ name, extension, sizeKb, lastModified, author, onClick }: DocumentFlyoverProps): import("react/jsx-runtime").JSX.Element;
+export { DocumentFlyover };

package/dist/src/components/waka-document-preview-popup/index.d.ts

@@ -0,0 +1,26 @@
+export interface DocumentVersion {
+    id: string;
+    label: string;
+    date: string;
+}
+export interface PreviewDocument {
+    name: string;
+    mimeType: string;
+    content?: string;
+    previewUrl?: string;
+    sizeBytes: number;
+    uploadedBy: string;
+    uploadedAt: string;
+}
+export interface DocumentPreviewPopupProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    document: PreviewDocument;
+    versions?: DocumentVersion[];
+    selectedVersion?: string;
+    onVersionChange?: (versionId: string) => void;
+    onDownload: (versionId?: string) => void;
+}
+declare function formatSize(bytes: number): string;
+declare function DocumentPreviewPopup({ open, onOpenChange, document: doc, versions, selectedVersion, onVersionChange, onDownload, }: DocumentPreviewPopupProps): import("react/jsx-runtime").JSX.Element;
+export { DocumentPreviewPopup, formatSize };

package/dist/src/components/waka-hour-balance-badge/index.d.ts

@@ -0,0 +1,8 @@
+export interface HourBalanceBadgeProps {
+    remainingMinutes: number;
+    totalMinutes: number;
+    className?: string;
+}
+declare function formatMinutes(minutes: number): string;
+declare function HourBalanceBadge({ remainingMinutes, totalMinutes, className }: HourBalanceBadgeProps): import("react/jsx-runtime").JSX.Element;
+export { HourBalanceBadge, formatMinutes };

package/dist/src/components/waka-hour-consumption-table/index.d.ts

@@ -0,0 +1,15 @@
+export interface HourConsumption {
+    date: string;
+    consultant: string;
+    reason: string;
+    stepName?: string;
+    minutes: number;
+}
+export interface HourConsumptionTableProps {
+    consumptions: HourConsumption[];
+    page: number;
+    totalPages: number;
+    onPageChange: (page: number) => void;
+}
+declare function HourConsumptionTable({ consumptions, page, totalPages, onPageChange }: HourConsumptionTableProps): import("react/jsx-runtime").JSX.Element;
+export { HourConsumptionTable };

package/dist/src/components/waka-hour-pack-dialog/index.d.ts

@@ -0,0 +1,8 @@
+export interface HourPackDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onSubmit: (hours: number, comment: string) => void;
+    isLoading?: boolean;
+}
+declare function HourPackDialog({ open, onOpenChange, onSubmit, isLoading }: HourPackDialogProps): import("react/jsx-runtime").JSX.Element;
+export { HourPackDialog };

package/dist/src/components/waka-project-stats-header/index.d.ts

@@ -0,0 +1,15 @@
+export interface ProjectStatsHeaderProps {
+    stats: {
+        ppMinutes: number;
+        wakaMinutes: number;
+        billableMinutes: number;
+        billableTotalMinutes: number;
+        breakdown?: {
+            role: string;
+            minutes: number;
+        }[];
+    };
+    onExpand?: (category: "pp" | "waka" | "billable") => void;
+}
+declare function ProjectStatsHeader({ stats, onExpand }: ProjectStatsHeaderProps): import("react/jsx-runtime").JSX.Element;
+export { ProjectStatsHeader };

package/dist/src/components/waka-step-comment-bubble/index.d.ts

@@ -0,0 +1,13 @@
+export interface RecentComment {
+    author: string;
+    content: string;
+    date: string;
+}
+export interface StepCommentBubbleProps {
+    count: number;
+    recentComments?: RecentComment[];
+    onClick: () => void;
+    className?: string;
+}
+declare function StepCommentBubble({ count, recentComments, onClick, className }: StepCommentBubbleProps): import("react/jsx-runtime").JSX.Element;
+export { StepCommentBubble };

package/dist/src/components/waka-step-comment-panel/index.d.ts

@@ -0,0 +1,20 @@
+export interface StepComment {
+    id: string;
+    authorName: string;
+    authorRole: string;
+    content: string;
+    createdAt: string;
+    isEdited: boolean;
+}
+export interface StepCommentPanelProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    comments: StepComment[];
+    onAdd: (content: string) => void;
+    onEdit?: (id: string, content: string) => void;
+    onDelete?: (id: string) => void;
+    canEditDelete?: boolean;
+    isLoading?: boolean;
+}
+declare function StepCommentPanel({ open, onOpenChange, comments, onAdd, onEdit, onDelete, canEditDelete, isLoading, }: StepCommentPanelProps): import("react/jsx-runtime").JSX.Element;
+export { StepCommentPanel };

package/dist/src/components/waka-step-permission-matrix/index.d.ts

@@ -0,0 +1,12 @@
+export interface PermissionAction {
+    key: string;
+    label: string;
+}
+export interface StepPermissionMatrixProps {
+    roles: string[];
+    actions: PermissionAction[];
+    value: Record<string, string[]>;
+    onChange: (role: string, action: string, enabled: boolean) => void;
+}
+declare function StepPermissionMatrix({ roles, actions, value, onChange }: StepPermissionMatrixProps): import("react/jsx-runtime").JSX.Element;
+export { StepPermissionMatrix };

package/dist/src/components/waka-time-entry-dialog/index.d.ts

@@ -0,0 +1,16 @@
+export interface TimeActor {
+    id: string;
+    name: string;
+    role: string;
+    totalMinutes: number;
+}
+export interface TimeEntryDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    actors: TimeActor[];
+    onSubmit: (actorId: string, minutes: number, comment: string, isBillable: boolean) => void;
+    showBillable?: boolean;
+    isLoading?: boolean;
+}
+declare function TimeEntryDialog({ open, onOpenChange, actors, onSubmit, showBillable, isLoading }: TimeEntryDialogProps): import("react/jsx-runtime").JSX.Element;
+export { TimeEntryDialog };

package/dist/src/components/waka-time-tracking-flyover/index.d.ts

@@ -0,0 +1,11 @@
+import * as React from "react";
+export interface TimeTrackingEntry {
+    role: string;
+    totalMinutes: number;
+}
+export interface TimeTrackingFlyoverProps {
+    entries: TimeTrackingEntry[];
+    children: React.ReactNode;
+}
+declare function TimeTrackingFlyover({ entries, children }: TimeTrackingFlyoverProps): import("react/jsx-runtime").JSX.Element;
+export { TimeTrackingFlyover };

package/dist/src/doc.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Entry point pour WakaDoc Suite
+ *
+ * Usage:
+ * ```ts
+ * import { WakaDocRenderer, WakaDocShell } from "@wakastellar/ui/doc"
+ * ```
+ *
+ * Dépendances requises:
+ * - react-markdown
+ * - remark-gfm
+ * - rehype-slug
+ * - rehype-raw
+ *
+ * Pour le mode édition (WakaDocShell avec mode="edit"):
+ * - @tiptap/react (>=2.0.0)
+ * - @tiptap/starter-kit (>=2.0.0)
+ * - @tiptap/extension-underline (>=2.0.0)
+ * - @tiptap/extension-link (>=2.0.0)
+ * - @tiptap/extension-text-align (>=2.0.0)
+ * - tiptap-markdown (>=0.8.0)
+ */
+export { WakaDocRenderer, type WakaDocRendererProps } from './components/waka-doc-renderer';
+export { WakaDocCodeBlock, type WakaDocCodeBlockProps } from './components/waka-doc-code-block';
+export { WakaDocToc, type WakaDocTocProps, type TocItem } from './components/waka-doc-toc';
+export { WakaDocNav, type WakaDocNavProps, type DocNavItem } from './components/waka-doc-nav';
+export { WakaDocSearch, type WakaDocSearchProps, type DocSearchPage } from './components/waka-doc-search';
+export { WakaDocVersion, type WakaDocVersionProps, type DocVersion } from './components/waka-doc-version';
+export { WakaDocCallout, type WakaDocCalloutProps, type CalloutType } from './components/waka-doc-callout';
+export { WakaDocToolbar, type WakaDocToolbarProps } from './components/waka-doc-toolbar';
+export { WakaDocBreadcrumb, type WakaDocBreadcrumbProps } from './components/waka-doc-breadcrumb';
+export { WakaDocTable, type WakaDocTableProps } from './components/waka-doc-table';
+export { WakaDocShell, type WakaDocShellProps } from './blocks/waka-doc-shell';

package/dist/src/export.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Entry point pour les fonctionnalités d'export du DataTable
+ *
+ * Usage:
+ * ```ts
+ * import { useDataTableExport } from "@wakastellar/ui/export"
+ * ```
+ *
+ * Dépendances optionnelles selon le format:
+ *
+ * Pour l'export Excel (.xlsx):
+ * - exceljs (>=4.3.0)
+ * ```bash
+ * pnpm add exceljs
+ * ```
+ *
+ * Pour l'export PDF:
+ * - jspdf (>=2.5.0)
+ * - jspdf-autotable (>=3.5.0)
+ * ```bash
+ * pnpm add jspdf jspdf-autotable
+ * ```
+ *
+ * Note: Les formats CSV, JSON et XML fonctionnent sans dépendances supplémentaires.
+ */
+export { useDataTableExport } from './components/DataTable/hooks/useDataTableExport';
+export { useDataTableImport } from './components/DataTable/hooks/useDataTableImport';
+export type { ExportConfig, ImportConfig, } from './components/DataTable/types';
+export type ExportableCellValue = string | number | boolean | Date | null | undefined;
+export type ImportedRowData = Record<string, ExportableCellValue>;

package/dist/src/index.d.ts

@@ -0,0 +1,35 @@
+export * from './components';
+export { WakaEmptyState } from './components/waka-empty-state';
+export type { ColumnDef, Row, RowData, Table as TanStackTable, Column, Cell, Header, ColumnFiltersState, SortingState, VisibilityState, PaginationState } from '@tanstack/react-table';
+export { useTranslation } from './hooks/use-translation';
+export * from './hooks/useToast';
+export { LanguageProvider, useLanguage } from './context/language-context';
+export type { LanguageContextValue, LanguageProviderProps, LanguageConfig, S3Config } from './context/language-context';
+export { ThemeProvider, useTheme } from './context/theme-provider';
+export type { ThemeContextValue, ThemeProviderProps, ThemeConfig, ThemeS3Config } from './context/theme-provider';
+export { ThemeProvider as LegacyThemeProvider, useTheme as useLegacyTheme } from './context/theme-context';
+export type { ThemeContextValue as LegacyThemeContextValue, ThemeProviderProps as LegacyThemeProviderProps } from './context/theme-context';
+export { WakaProvider, useWaka } from './context/waka-provider';
+export type { WakaProviderConfig, WakaProviderProps } from './context/waka-provider';
+export { AdmincrumbProvider, useAdmincrumbContext, useAdmincrumbContextOptional } from './context/admincrumb-context';
+export type { AdmincrumbSelection, AdmincrumbContextValue, AdmincrumbProviderProps } from './context/admincrumb-context';
+export type { WakaThemeConfig, WakaS3Config, WakaLanguageConfig, ThemeConfigItem, LanguageConfigItem, } from './types/provider';
+export type { LinkComponentProps } from './types/link';
+export type { Step, StepStatus, WakaStepperProps, StepperContextValue, StepperNavigationProps } from './components/waka-stepper';
+export type { BreadcrumbItem, WakaBreadcrumbProps } from './components/waka-breadcrumb';
+export type { TreeNode, WakaTreeProps } from './components/waka-tree';
+export type { ComboboxOption, WakaComboboxProps } from './components/waka-combobox';
+export type { WakaDateRange, WakaDateRangePickerProps, DateRangePreset } from './components/waka-date-range-picker';
+export type { TimelineItem, TimelineItemStatus, WakaTimelineProps } from './components/waka-timeline';
+export type { KanbanCard, KanbanColumn, WakaKanbanProps } from './components/waka-kanban';
+export type { ThemeMetadata, ThemeVersion, S3UploadConfig, WakaThemeCreatorProps } from './components/waka-theme-creator';
+export type { UploadedFile, FileUploadVariant, WakaFileUploadProps } from './components/waka-file-upload';
+export type { AutocompleteOption, WakaAutocompleteProps } from './components/waka-autocomplete';
+export type { AdmincrumbLevel, AdmincrumbItem, WakaAdmincrumbProps } from './components/waka-admincrumb';
+export type { CarouselImage, CarouselTransition, CarouselLayout, CarouselTheme, WakaCarouselProps } from './components/waka-carousel';
+export * from './utils/cn';
+export * from './utils/tweak';
+export * from './utils/datetime-helpers';
+export { ThemeLoader, initThemeLoader, getThemeLoader, loadTheme, applyTheme, useThemeLoader, type ThemeLoaderConfig, } from './utils/theme-loader';
+export { sanitizeUrl, safeNavigate, escapeRegex, createSafeRegex, createHighlightRegex, escapeHtml, } from './utils/security';
+export * from './blocks';

package/dist/src/rich-text.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Entry point pour WakaRichTextEditor
+ *
+ * Usage:
+ * ```ts
+ * import { WakaRichTextEditor } from "@wakastellar/ui/rich-text"
+ * ```
+ *
+ * Dépendances requises:
+ * - @tiptap/react (>=2.0.0)
+ * - @tiptap/starter-kit (>=2.0.0)
+ * - @tiptap/extension-underline (>=2.0.0)
+ * - @tiptap/extension-link (>=2.0.0)
+ * - @tiptap/extension-text-align (>=2.0.0)
+ *
+ * Installation:
+ * ```bash
+ * pnpm add @tiptap/react @tiptap/starter-kit @tiptap/extension-underline @tiptap/extension-link @tiptap/extension-text-align
+ * ```
+ */
+export { WakaRichTextEditor, type WakaRichTextEditorProps, type ToolbarButton } from './components/waka-rich-text-editor';