@nice2dev/ui-erp 1.0.11 → 1.0.12

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 import { default as default_2 } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { NiceBaseProps } from '@nice2dev/ui-core';
+import { RefAttributes } from 'react';
 
 export declare interface Address {
     line1: string;
@@ -49,6 +52,8 @@ export declare interface AvailabilityException {
     reason?: string;
 }
 
+export declare function buildJpkXml(opts: JpkExportOptions): string;
+
 export declare interface Currency {
     code: string;
     symbol: string;
@@ -64,6 +69,20 @@ export declare interface DateRange {
     end: Date;
 }
 
+export declare interface Employee {
+    id: string;
+    firstName: string;
+    lastName: string;
+    email?: string;
+    department?: string;
+    position?: string;
+    hiredAt?: Date;
+    fte?: number;
+    vacationBalanceDays?: number;
+    sickLeaveDaysYtd?: number;
+    active?: boolean;
+}
+
 export declare interface InventoryFilters {
     categories?: string[];
     statuses?: InventoryStatus[];
@@ -130,11 +149,116 @@ export declare interface InventoryViewConfig {
     pageSize: number;
 }
 
+export declare interface Invoice {
+    id: string;
+    invoiceNumber: string;
+    issueDate: Date;
+    dueDate: Date;
+    seller: {
+        name: string;
+        vatId?: string;
+        address?: Address;
+    };
+    buyer: {
+        name: string;
+        vatId?: string;
+        address?: Address;
+    };
+    lines: InvoiceLine[];
+    status: InvoiceStatus;
+    paymentMethod?: 'transfer' | 'card' | 'cash' | 'blik' | 'other';
+    notes?: string;
+    currency?: string;
+    subtotal?: Money;
+    vatTotal?: Money;
+    total?: Money;
+    history?: Array<{
+        at: Date;
+        status: InvoiceStatus;
+        by?: string;
+        note?: string;
+    }>;
+}
+
+export declare interface InvoiceLine {
+    id: string;
+    description: string;
+    quantity: number;
+    unit?: string;
+    unitPrice: Money;
+    vatRate: number;
+    discount?: number;
+}
+
+export declare type InvoiceStatus = 'draft' | 'issued' | 'sent' | 'paid' | 'partially-paid' | 'overdue' | 'cancelled';
+
+export declare interface JpkExportOptions {
+    format: 'JPK_V7M' | 'JPK_V7K' | 'JPK_FA';
+    period: {
+        from: Date;
+        to: Date;
+    };
+    taxpayer: {
+        name: string;
+        nip: string;
+        regon?: string;
+        address?: Address;
+    };
+    invoices: Invoice[];
+}
+
+export declare interface MockErpApi {
+    loading: boolean;
+    error: Error | null;
+    invoices: Invoice[];
+    purchaseOrders: PurchaseOrder[];
+    inventory: InventoryItem[];
+    suppliers: Supplier[];
+    employees: Employee[];
+    resources: Resource[];
+    vatRates: VatRate[];
+    refresh: () => Promise<void>;
+    upsertInvoice: (invoice: Invoice) => Promise<void>;
+    upsertPurchaseOrder: (po: PurchaseOrder) => Promise<void>;
+    upsertInventory: (item: InventoryItem) => Promise<void>;
+}
+
 export declare interface Money {
     amount: number;
     currency: Currency;
 }
 
+export declare const NICE_VAT_PRESETS: Record<'PL' | 'EU' | 'UK', VatRate[]>;
+
+export declare const NiceHRDashboard: default_2.ForwardRefExoticComponent<NiceHRDashboardProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceHRDashboardProps extends NiceBaseProps {
+    employees: Employee[];
+    /** Custom widget labels. */
+    labels?: Partial<{
+        headcount: string;
+        fte: string;
+        vacationBalance: string;
+        sickLeave: string;
+        departments: string;
+        activeEmployees: string;
+    }>;
+    /** Hide individual widgets. */
+    hideWidgets?: Partial<{
+        headcount: boolean;
+        fte: boolean;
+        vacation: boolean;
+        sick: boolean;
+        departments: boolean;
+    }>;
+    /** Locale for number formatting. */
+    locale?: string;
+    /** Density. */
+    density?: 'comfortable' | 'compact';
+    /** Click handler for a widget — useful for drilldowns. */
+    onWidgetClick?: (widget: 'headcount' | 'fte' | 'vacation' | 'sick' | 'departments') => void;
+}
+
 export declare const NiceInventoryManager: default_2.FC<NiceInventoryManagerProps>;
 
 export declare interface NiceInventoryManagerProps {
@@ -151,6 +275,84 @@ export declare interface NiceInventoryManagerProps {
     className?: string;
 }
 
+export declare const NiceInvoiceView: default_2.ForwardRefExoticComponent<NiceInvoiceViewProps & default_2.RefAttributes<HTMLElement>>;
+
+export declare interface NiceInvoiceViewProps extends NiceBaseProps {
+    invoice: Invoice;
+    /** Locale for formatting amounts and dates. */
+    locale?: string;
+    /** Currency code; falls back to `invoice.currency` then to the line currency. */
+    currency?: string;
+    /** Hide individual sections. */
+    hideSections?: Partial<{
+        header: boolean;
+        lines: boolean;
+        vat: boolean;
+        totals: boolean;
+        timeline: boolean;
+        notes: boolean;
+    }>;
+    /** Custom labels (i18n hook). */
+    labels?: Partial<{
+        invoiceNumber: string;
+        issueDate: string;
+        dueDate: string;
+        seller: string;
+        buyer: string;
+        description: string;
+        qty: string;
+        unitPrice: string;
+        vat: string;
+        net: string;
+        gross: string;
+        subtotal: string;
+        vatTotal: string;
+        total: string;
+        status: string;
+        vatBreakdown: string;
+        timeline: string;
+        notes: string;
+        vatId: string;
+    }>;
+    /** Optional click handler for actions (e.g. download PDF). */
+    onAction?: (action: 'download' | 'print' | 'send') => void;
+    /** Show action toolbar. Default: false. */
+    showActions?: boolean;
+    /** Density. */
+    density?: 'comfortable' | 'compact';
+}
+
+export declare const NiceJpkExporter: ForwardRefExoticComponent<NiceJpkExporterProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceJpkExporterProps extends NiceBaseProps {
+    invoices: Invoice[];
+    taxpayer: JpkExportOptions['taxpayer'];
+    /** Default export format. */
+    defaultFormat?: JpkExportOptions['format'];
+    /** Default reporting period. */
+    defaultPeriod?: {
+        from: Date;
+        to: Date;
+    };
+    /** Custom XML builder (advanced override). */
+    buildXml?: (opts: JpkExportOptions) => string;
+    /** Called with the produced XML and Blob. */
+    onExport?: (xml: string, blob: Blob, opts: JpkExportOptions) => void;
+    /** Filename helper (default: `JPK_V7M_${YYYY}-${MM}.xml`). */
+    filenameFor?: (opts: JpkExportOptions) => string;
+    /** Custom labels. */
+    labels?: Partial<{
+        format: string;
+        period: string;
+        from: string;
+        to: string;
+        export: string;
+        download: string;
+    }>;
+}
+
+export declare const NicePurchaseOrder: ForwardRefExoticComponent<NicePurchaseOrderViewProps & RefAttributes<HTMLDivElement>>;
+
 export declare interface NicePurchaseOrderProps {
     orders: PurchaseOrder[];
     suppliers: Supplier[];
@@ -167,6 +369,36 @@ export declare interface NicePurchaseOrderProps {
     className?: string;
 }
 
+export declare interface NicePurchaseOrderViewProps extends NicePurchaseOrderProps, NiceBaseProps {
+    /** Show in list+detail master/detail mode (default `true`). */
+    selectable?: boolean;
+    /** Initial selection. */
+    initialSelectedId?: string;
+    /** Locale. */
+    locale?: string;
+    /** Custom labels. */
+    labels?: Partial<{
+        orderNumber: string;
+        supplier: string;
+        status: string;
+        orderDate: string;
+        expected: string;
+        actual: string;
+        total: string;
+        items: string;
+        sku: string;
+        name: string;
+        qty: string;
+        received: string;
+        unitPrice: string;
+        lineTotal: string;
+        notes: string;
+        approve: string;
+        cancel: string;
+        receive: string;
+    }>;
+}
+
 export declare const NiceResourceAllocation: default_2.FC<NiceResourceAllocationProps>;
 
 export declare interface NiceResourceAllocationProps {
@@ -182,6 +414,57 @@ export declare interface NiceResourceAllocationProps {
     className?: string;
 }
 
+export declare const NiceVatTable: ForwardRefExoticComponent<NiceVatTableProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceVatTableProps extends NiceBaseProps {
+    /** Country/preset (used when `rates` not supplied). */
+    country?: 'PL' | 'EU' | 'UK';
+    /** Explicit rates (override preset). */
+    rates?: VatRate[];
+    /** Allow inline editing. */
+    editable?: boolean;
+    /** Notify on rate change. */
+    onChange?: (rates: VatRate[]) => void;
+    /** Called when a row is removed. */
+    onRemove?: (code: string) => void;
+    /** Locale for percentage formatting. */
+    locale?: string;
+    /** Custom labels. */
+    labels?: Partial<{
+        code: string;
+        rate: string;
+        label: string;
+        description: string;
+        add: string;
+        remove: string;
+    }>;
+    /** Density. */
+    density?: 'comfortable' | 'compact';
+}
+
+export declare const NiceWarehouseView: default_2.ForwardRefExoticComponent<NiceWarehouseViewProps & default_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceWarehouseViewProps extends NiceBaseProps {
+    /** Warehouse identifier (used in the title). */
+    warehouseName: string;
+    /** Cells to render. */
+    cells: WarehouseCell[];
+    /** Heat-map color stops (low → high). */
+    colors?: {
+        low: string;
+        mid: string;
+        high: string;
+    };
+    /** Click handler for a cell. */
+    onCellClick?: (cell: WarehouseCell) => void;
+    /** Show legend (default `true`). */
+    showLegend?: boolean;
+    /** Cell size in px (default 48). */
+    cellSize?: number;
+    /** Optional aisle separators every N columns. */
+    aisleEvery?: number;
+}
+
 export declare interface PurchaseOrder {
     id: string;
     orderNumber: string;
@@ -276,6 +559,49 @@ export declare type TimeUnit = 'hour' | 'day' | 'week' | 'month' | 'quarter' | '
 
 export declare type TransactionType = 'receipt' | 'issue' | 'transfer' | 'adjustment' | 'return' | 'count' | 'write-off';
 
+/**
+ * Hook returning a mock ERP API with simulated loading/error states.
+ * Useful for storybook stories, integration tests, and offline demos.
+ */
+export declare function useMockErpApi(options?: UseMockErpApiOptions): MockErpApi;
+
+export declare interface UseMockErpApiOptions {
+    /** Artificial latency in ms (default 300). */
+    latencyMs?: number;
+    /** Probability (0..1) that a write will reject — handy for error-state UI testing. */
+    errorRate?: number;
+    /** Seed data overrides. */
+    seed?: Partial<{
+        invoices: Invoice[];
+        purchaseOrders: PurchaseOrder[];
+        inventory: InventoryItem[];
+        suppliers: Supplier[];
+        employees: Employee[];
+        resources: Resource[];
+        vatRates: VatRate[];
+    }>;
+}
+
+export declare interface VatRate {
+    code: string;
+    rate: number;
+    label?: string;
+    description?: string;
+    appliesTo?: string[];
+}
+
+export declare interface WarehouseCell {
+    /** Composite location, used as React key (e.g. `A-12-3-B`). */
+    location: WarehouseLocation;
+    /** Items currently stored at the location. */
+    items: InventoryItem[];
+    /** 0..1 occupancy ratio. */
+    occupancy: number;
+    /** Optional row/col coordinates for layout. Otherwise derived from rack/aisle/shelf/bin. */
+    row?: number;
+    col?: number;
+}
+
 export declare interface WarehouseLocation {
     warehouseId: string;
     warehouseName: string;