@wgalleti/primevue-components 0.3.4

package/dist/types/components/ui/WSectionHeader.vue.d.ts

@@ -0,0 +1,22 @@
+type __VLS_Props = {
+    title: string;
+    subtitle?: string;
+    icon?: string;
+    compact?: boolean;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {};
+type __VLS_Slots = {} & {
+    icon?: (props: typeof __VLS_1) => any;
+} & {
+    meta?: (props: typeof __VLS_3) => any;
+} & {
+    actions?: (props: typeof __VLS_5) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/ui/WStatusTag.vue.d.ts

@@ -0,0 +1,10 @@
+export interface StatusMapping {
+    label: string;
+    severity: string;
+}
+type __VLS_Props = {
+    value: string;
+    map?: Record<string, StatusMapping>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/composables/index.d.ts

@@ -0,0 +1,6 @@
+export { useCrudManager } from './useCrudManager';
+export { useApi } from './useApi';
+export { useAppToast } from './useAppToast';
+export { useAppConfirm } from './useAppConfirm';
+export { useApiError, extractApiError } from './useApiError';
+export { useFormatters } from './useFormatters';

package/dist/types/composables/useApi.d.ts

@@ -0,0 +1,2 @@
+import type { UseApiOptions, UseApiReturn } from '@/types/api';
+export declare function useApi<T = Record<string, unknown>>(options: UseApiOptions): UseApiReturn<T>;

package/dist/types/composables/useApiError.d.ts

@@ -0,0 +1,4 @@
+export declare function extractApiError(error: unknown, fallback?: string): string;
+export declare function useApiError(): {
+    extractApiError: typeof extractApiError;
+};

package/dist/types/composables/useAppConfirm.d.ts

@@ -0,0 +1,4 @@
+export declare function useAppConfirm(): {
+    confirmDelete: (onAccept: () => void, message?: string) => void;
+    confirmAction: (message: string, onAccept: () => void, header?: string) => void;
+};

package/dist/types/composables/useAppToast.d.ts

@@ -0,0 +1,6 @@
+export declare function useAppToast(): {
+    success: (message: string, title?: string) => void;
+    error: (message: string, title?: string) => void;
+    warn: (message: string, title?: string) => void;
+    info: (message: string, title?: string) => void;
+};

package/dist/types/composables/useCrudManager.d.ts

@@ -0,0 +1,2 @@
+import type { CrudManagerConfig, CrudManagerReturn } from '@/types/crud';
+export declare function useCrudManager<T extends Record<string, unknown> = Record<string, unknown>>(config: CrudManagerConfig<T>): CrudManagerReturn<T>;

package/dist/types/composables/useFormatters.d.ts

@@ -0,0 +1,19 @@
+import { parseDate, toDateString, toDateTimeString } from '@/utils/dates';
+import { formatCpf, formatCnpj, formatCpfCnpj, formatTelefone, validateCpf, validateCnpj, validateCpfCnpj } from '@/utils/masks';
+export declare function useFormatters(): {
+    formatCurrency: (value: number | null | undefined) => string;
+    formatNumber: (value: number | null | undefined, decimals?: number) => string;
+    formatDate: (value: string | Date | null | undefined, format?: string) => string;
+    formatDateTime: (value: string | Date | null | undefined) => string;
+    formatPercent: (value: number | null | undefined) => string;
+    formatCpf: typeof formatCpf;
+    formatCnpj: typeof formatCnpj;
+    formatCpfCnpj: typeof formatCpfCnpj;
+    formatTelefone: typeof formatTelefone;
+    validateCpf: typeof validateCpf;
+    validateCnpj: typeof validateCnpj;
+    validateCpfCnpj: typeof validateCpfCnpj;
+    parseDate: typeof parseDate;
+    toDateString: typeof toDateString;
+    toDateTimeString: typeof toDateTimeString;
+};

package/dist/types/crud.d.ts

@@ -0,0 +1,184 @@
+import { ComputedRef, Ref } from 'vue';
+import { PaginationState, SortState } from './api';
+export type ColumnType = 'text' | 'boolean' | 'date' | 'datetime' | 'number' | 'currency' | 'image' | 'custom';
+export interface ColumnDef {
+    field: string;
+    header: string;
+    type?: ColumnType;
+    style?: string;
+    align?: 'left' | 'center' | 'right';
+    sortable?: boolean;
+    format?: (value: unknown, rowData?: Record<string, unknown>) => string;
+    visible?: boolean;
+    decimals?: number;
+    tagValue?: (value: unknown, rowData?: Record<string, unknown>) => string;
+    tagSeverity?: (value: unknown, rowData?: Record<string, unknown>) => string;
+}
+export type FieldType = 'text' | 'email' | 'password' | 'number' | 'currency' | 'date' | 'datetime' | 'select' | 'autocomplete' | 'fk' | 'switch' | 'textarea' | 'color' | 'cpf_cnpj' | 'mask' | 'image' | 'cep' | 'transfer';
+export interface SelectOption {
+    [key: string]: unknown;
+}
+export interface FieldDef {
+    field: string;
+    label: string;
+    type?: FieldType;
+    required?: boolean;
+    colSpan?: number;
+    defaultValue?: unknown | (() => unknown);
+    disabled?: boolean | ((formData: Record<string, unknown>, isEditing: boolean) => boolean);
+    disabledOnEdit?: boolean;
+    visible?: boolean | ((formData: Record<string, unknown>, isEditing: boolean) => boolean);
+    placeholder?: string;
+    validate?: (value: unknown) => string | null;
+    autofocus?: boolean | 'create' | 'edit';
+    options?: SelectOption[] | Ref<SelectOption[]>;
+    optionLabel?: string;
+    optionValue?: string;
+    showClear?: boolean;
+    /** For 'transfer' fields — option keys to match against when searching
+     *  (defaults to [optionLabel]). */
+    searchFields?: string[];
+    endpoint?: string;
+    endpointParams?: Record<string, string | number | boolean>;
+    crudFields?: FieldDef[];
+    crudColumns?: ColumnDef[];
+    min?: number;
+    max?: number;
+    minFractionDigits?: number;
+    maxFractionDigits?: number;
+    prefix?: string;
+    suffix?: string;
+    /** For 'currency' fields — render WMoneyInput (digit entry filled from the
+     *  right, like a calculator/POS) instead of the default InputNumber. */
+    fillFromRight?: boolean;
+    /** Fixed decimal places for 'currency' fillFromRight mode (default: 2). */
+    decimals?: number;
+    dateFormat?: string;
+    hourFormat?: '12' | '24';
+    mask?: string;
+    rows?: number;
+    switchLabel?: string;
+    feedback?: boolean;
+    accept?: string;
+    /** For type 'cep' — maps ViaCEP response fields to form field names.
+     *  Keys are ViaCEP response names (logradouro, bairro, localidade, uf, complemento).
+     *  Values are the form field names to populate. Omit keys to skip fields. */
+    cepFields?: {
+        logradouro?: string;
+        bairro?: string;
+        localidade?: string;
+        uf?: string;
+        complemento?: string;
+    };
+    /** Optional visual grouping. Fields with the same group.id render together
+     *  under a titled section. Ungrouped fields render in a default section at the top.
+     *  `order` controls the display order of groups; defaults to the order of first occurrence. */
+    fieldGroup?: {
+        id: string;
+        title: string;
+        description?: string;
+        order?: number;
+    };
+}
+export interface RowAction<T = Record<string, unknown>> {
+    action: string;
+    icon: string;
+    tooltip?: string;
+    severity?: 'secondary' | 'success' | 'info' | 'warn' | 'danger' | 'contrast';
+    visible?: (data: T) => boolean;
+    disabled?: (data: T) => boolean;
+    handler?: (data: T) => void;
+}
+export interface CrudLabels {
+    createTitle: string;
+    editTitle: string;
+    viewTitle?: string;
+    createButton: string;
+    saveButton: string;
+    updateButton: string;
+    cancelButton: string;
+    deleteConfirmTitle: string;
+    deleteConfirmMessage: string;
+    searchPlaceholder: string;
+    emptyMessage: string;
+    successCreate: string;
+    successUpdate: string;
+    successDelete: string;
+}
+export declare const DEFAULT_CRUD_LABELS: CrudLabels;
+export interface KpiItem {
+    icon: string;
+    label: string;
+    value: string | number;
+    color?: string;
+    severity?: 'primary' | 'success' | 'warning' | 'danger' | 'info';
+    hint?: string;
+    loading?: boolean;
+    trend?: {
+        value: string;
+        direction?: 'up' | 'down' | 'neutral';
+    };
+}
+export interface CrudManagerConfig<T> {
+    endpoint: string;
+    columns: ColumnDef[];
+    form: FieldDef[];
+    pk?: string;
+    pageSize?: number;
+    searchDebounce?: number;
+    /** When editing, send only the changed fields (diff) instead of the whole
+     *  record. Defaults to `true`. Set `false` to always send the full payload. */
+    partialUpdate?: boolean;
+    canCreate?: boolean;
+    canEdit?: boolean;
+    canDelete?: boolean;
+    rowActions?: RowAction<T>[];
+    filterParams?: () => Record<string, unknown>;
+    transformPayload?: (payload: Record<string, unknown>, isEditing: boolean) => Record<string, unknown>;
+    createDefaults?: () => Record<string, unknown>;
+    onAfterSave?: (data: T, isEditing: boolean) => void;
+    onAfterDelete?: (item: T) => void;
+    labels?: Partial<CrudLabels>;
+}
+export interface CrudManagerReturn<T> {
+    items: Ref<T[]>;
+    extras: Ref<Record<string, unknown>>;
+    loading: Ref<boolean>;
+    saving: Ref<boolean>;
+    search: Ref<string>;
+    dialogVisible: Ref<boolean>;
+    editingItem: Ref<T | null>;
+    formData: Record<string, unknown>;
+    pagination: PaginationState;
+    sort: SortState;
+    isEditing: ComputedRef<boolean>;
+    isViewing: ComputedRef<boolean>;
+    viewMode: Ref<boolean>;
+    dialogTitle: ComputedRef<string>;
+    isFirstPage: ComputedRef<boolean>;
+    isLastPage: ComputedRef<boolean>;
+    init(): Promise<void>;
+    fetchItems(params?: Record<string, unknown>): Promise<void>;
+    refresh(): Promise<void>;
+    setSearch(value: string): void;
+    onSearch(event: Event): void;
+    onPage(event: {
+        page: number;
+        rows: number;
+    }): void;
+    onSort(event: {
+        sortField?: string | null;
+        sortOrder?: 1 | -1 | 0 | null;
+    }): void;
+    openCreateDialog(): void;
+    openEditDialog(item: T): void;
+    openViewDialog(item: T): void;
+    save(): Promise<T | null>;
+    confirmDelete(item: T): void;
+    setFormField(field: string, value: unknown): void;
+    resetForm(): void;
+    goToPage(page: number): void;
+    firstPage(): void;
+    lastPage(): void;
+    config: CrudManagerConfig<T>;
+}

package/dist/types/data-providers/axiosDataProvider.d.ts

@@ -0,0 +1,3 @@
+import type { AxiosInstance } from 'axios';
+import type { DataProvider } from '@/types/dataProvider';
+export declare function createAxiosDataProvider(axios: AxiosInstance): DataProvider;

package/dist/types/data-providers/index.d.ts

@@ -0,0 +1,2 @@
+export { createAxiosDataProvider } from './axiosDataProvider';
+export { createSupabaseDataProvider, type CreateSupabaseDataProviderOptions, type SupabaseDataProviderClient, type SupabaseResourceConfig, } from './supabaseDataProvider';

package/dist/types/data-providers/supabaseDataProvider.d.ts

@@ -0,0 +1,54 @@
+import type { DataProvider } from '@/types/dataProvider';
+type SupabaseResult<T> = {
+    data: T | null;
+    error: {
+        message: string;
+        code?: string;
+        details?: string;
+        hint?: string;
+    } | null;
+    count?: number | null;
+};
+type SupabaseFilterBuilder<T> = PromiseLike<SupabaseResult<T>> & {
+    select(columns?: string, options?: {
+        count?: 'exact' | 'planned' | 'estimated';
+    }): SupabaseFilterBuilder<T>;
+    eq(column: string, value: unknown): SupabaseFilterBuilder<T>;
+    ilike(column: string, pattern: string): SupabaseFilterBuilder<T>;
+    or(filters: string): SupabaseFilterBuilder<T>;
+    order(column: string, options?: {
+        ascending?: boolean;
+    }): SupabaseFilterBuilder<T>;
+    range(from: number, to: number): SupabaseFilterBuilder<T>;
+    single(): Promise<SupabaseResult<T>>;
+};
+type SupabaseTable = {
+    select<T = unknown>(columns?: string, options?: {
+        count?: 'exact' | 'planned' | 'estimated';
+    }): SupabaseFilterBuilder<T>;
+    insert<T = unknown>(payload: unknown): SupabaseFilterBuilder<T>;
+    update<T = unknown>(payload: unknown): SupabaseFilterBuilder<T>;
+    delete<T = unknown>(): SupabaseFilterBuilder<T>;
+};
+export interface SupabaseDataProviderClient {
+    from(table: string): SupabaseTable;
+}
+export interface SupabaseResourceConfig {
+    table: string;
+    pk?: string;
+    select?: string;
+    searchFields?: string[];
+    defaultOrdering?: string;
+    defaultFilters?: Record<string, unknown>;
+    softDelete?: boolean | Record<string, unknown>;
+    mapListItem?: (item: Record<string, unknown>) => Record<string, unknown>;
+    mapPayload?: (payload: Record<string, unknown>, operation: 'create' | 'update') => Record<string, unknown>;
+}
+export interface CreateSupabaseDataProviderOptions {
+    client: SupabaseDataProviderClient;
+    resources?: Record<string, SupabaseResourceConfig | string>;
+    defaultSelect?: string;
+    allowedTables?: string[];
+}
+export declare function createSupabaseDataProvider(options: CreateSupabaseDataProviderOptions): DataProvider;
+export {};

package/dist/types/dataProvider.d.ts

@@ -0,0 +1,28 @@
+export interface DataProviderListParams {
+    page?: number;
+    page_size?: number;
+    search?: string;
+    ordering?: string;
+    [key: string]: unknown;
+}
+export interface DataProviderListResponse<T = Record<string, unknown>> {
+    data: T[];
+    page: number;
+    page_size: number;
+    rows: number;
+    extras?: Record<string, unknown>;
+}
+export interface DataProviderResponse<T = unknown> {
+    data: T;
+}
+export interface DataProviderRequestConfig {
+    params?: Record<string, unknown>;
+    headers?: Record<string, string>;
+}
+export interface DataProvider {
+    list<T = Record<string, unknown>>(endpoint: string, params?: DataProviderListParams): Promise<DataProviderListResponse<T>>;
+    get<T = Record<string, unknown>>(endpoint: string, id: string | number, config?: DataProviderRequestConfig): Promise<DataProviderResponse<T>>;
+    create<T = Record<string, unknown>>(endpoint: string, payload: Record<string, unknown> | FormData, config?: DataProviderRequestConfig): Promise<DataProviderResponse<T>>;
+    update<T = Record<string, unknown>>(endpoint: string, id: string | number, payload: Record<string, unknown> | FormData, config?: DataProviderRequestConfig): Promise<DataProviderResponse<T>>;
+    delete(endpoint: string, id: string | number): Promise<void>;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+import './assets/crud.css';
+export { WPrimeVuePlugin } from './plugin';
+export { WCrudView, WCrudFormDialog, WCrudColumnRenderer, WAutoCompleteFK, WFormRenderer, WMoneyInput, WTransferList, WStatusTag, WPageHeader, WDetailHeader, WEmptyState, WInfoCard, WKpiCard, WKpiGrid, WSectionHeader, WFormSection, WActionBar, WProgressFlow, } from './components';
+export { useCrudManager, useApi, useAppToast, useAppConfirm, useApiError, extractApiError, useFormatters, } from './composables';
+export { createAxiosDataProvider, createSupabaseDataProvider, } from './data-providers';
+export type { PaginatedResponse, PaginationState, SortState, UseApiOptions, UseApiReturn, ColumnDef, ColumnType, FieldDef, FieldType, SelectOption, RowAction, CrudLabels, KpiItem, CrudManagerConfig, CrudManagerReturn, WPluginOptions, WPluginConfig, DataProvider, DataProviderListParams, DataProviderListResponse, DataProviderRequestConfig, DataProviderResponse, } from './types';
+export type { StatusMapping } from './components/ui/WStatusTag.vue';
+export type { InfoField } from './components/ui/WInfoCard.vue';
+export type { CreateSupabaseDataProviderOptions, SupabaseDataProviderClient, SupabaseResourceConfig, } from './data-providers';
+export { DEFAULT_CRUD_LABELS, W_AXIOS_KEY, W_CONFIG_KEY, W_DATA_PROVIDER_KEY, } from './types';
+export type { ApiFieldMeta } from './utils/fieldMapper';
+export { mapApiFieldToFieldDef, mapApiFieldsToFieldDefs, mapApiFieldToColumnDef, mapApiFieldsToColumnDefs, } from './utils/fieldMapper';

package/dist/types/plugin.d.ts

@@ -0,0 +1,2 @@
+import type { Plugin } from 'vue';
+export declare const WPrimeVuePlugin: Plugin;

package/dist/types/types/api.d.ts

@@ -0,0 +1,60 @@
+import type { Ref } from 'vue';
+/**
+ * Formato padrao de resposta paginada da API (DRF).
+ */
+export interface PaginatedResponse<T> {
+    data: T[];
+    page: number;
+    page_size: number;
+    rows: number;
+    extras?: Record<string, unknown>;
+}
+/**
+ * Estado reativo de paginacao.
+ */
+export interface PaginationState {
+    page: number;
+    pageSize: number;
+    rows: number;
+    totalPages: number;
+}
+/**
+ * Estado de ordenacao server-side.
+ */
+export interface SortState {
+    field: string | null;
+    order: 1 | -1 | 0;
+}
+/**
+ * Opcoes do useApi composable.
+ */
+export interface UseApiOptions {
+    endpoint: string;
+    pageSize?: number;
+    searchDebounce?: number;
+    immediate?: boolean;
+}
+/**
+ * Retorno do useApi composable.
+ */
+export interface UseApiReturn<T> {
+    items: Ref<T[]>;
+    loading: Ref<boolean>;
+    search: Ref<string>;
+    pagination: PaginationState;
+    extras: Ref<Record<string, unknown>>;
+    sort: SortState;
+    fetchItems(params?: Record<string, unknown>): Promise<void>;
+    refresh(): Promise<void>;
+    setSearch(value: string): void;
+    setFilter(key: string, value: unknown): void;
+    clearFilters(): void;
+    onPage(event: {
+        page: number;
+        rows: number;
+    }): void;
+    onSort(event: {
+        sortField: string;
+        sortOrder: 1 | -1 | 0;
+    }): void;
+}

package/dist/types/types/crud.d.ts

@@ -0,0 +1,184 @@
+import type { ComputedRef, Ref } from 'vue';
+import type { PaginationState, SortState } from './api';
+export type ColumnType = 'text' | 'boolean' | 'date' | 'datetime' | 'number' | 'currency' | 'image' | 'custom';
+export interface ColumnDef {
+    field: string;
+    header: string;
+    type?: ColumnType;
+    style?: string;
+    align?: 'left' | 'center' | 'right';
+    sortable?: boolean;
+    format?: (value: unknown, rowData?: Record<string, unknown>) => string;
+    visible?: boolean;
+    decimals?: number;
+    tagValue?: (value: unknown, rowData?: Record<string, unknown>) => string;
+    tagSeverity?: (value: unknown, rowData?: Record<string, unknown>) => string;
+}
+export type FieldType = 'text' | 'email' | 'password' | 'number' | 'currency' | 'date' | 'datetime' | 'select' | 'autocomplete' | 'fk' | 'switch' | 'textarea' | 'color' | 'cpf_cnpj' | 'mask' | 'image' | 'cep' | 'transfer';
+export interface SelectOption {
+    [key: string]: unknown;
+}
+export interface FieldDef {
+    field: string;
+    label: string;
+    type?: FieldType;
+    required?: boolean;
+    colSpan?: number;
+    defaultValue?: unknown | (() => unknown);
+    disabled?: boolean | ((formData: Record<string, unknown>, isEditing: boolean) => boolean);
+    disabledOnEdit?: boolean;
+    visible?: boolean | ((formData: Record<string, unknown>, isEditing: boolean) => boolean);
+    placeholder?: string;
+    validate?: (value: unknown) => string | null;
+    autofocus?: boolean | 'create' | 'edit';
+    options?: SelectOption[] | Ref<SelectOption[]>;
+    optionLabel?: string;
+    optionValue?: string;
+    showClear?: boolean;
+    /** For 'transfer' fields — option keys to match against when searching
+     *  (defaults to [optionLabel]). */
+    searchFields?: string[];
+    endpoint?: string;
+    endpointParams?: Record<string, string | number | boolean>;
+    crudFields?: FieldDef[];
+    crudColumns?: ColumnDef[];
+    min?: number;
+    max?: number;
+    minFractionDigits?: number;
+    maxFractionDigits?: number;
+    prefix?: string;
+    suffix?: string;
+    /** For 'currency' fields — render WMoneyInput (digit entry filled from the
+     *  right, like a calculator/POS) instead of the default InputNumber. */
+    fillFromRight?: boolean;
+    /** Fixed decimal places for 'currency' fillFromRight mode (default: 2). */
+    decimals?: number;
+    dateFormat?: string;
+    hourFormat?: '12' | '24';
+    mask?: string;
+    rows?: number;
+    switchLabel?: string;
+    feedback?: boolean;
+    accept?: string;
+    /** For type 'cep' — maps ViaCEP response fields to form field names.
+     *  Keys are ViaCEP response names (logradouro, bairro, localidade, uf, complemento).
+     *  Values are the form field names to populate. Omit keys to skip fields. */
+    cepFields?: {
+        logradouro?: string;
+        bairro?: string;
+        localidade?: string;
+        uf?: string;
+        complemento?: string;
+    };
+    /** Optional visual grouping. Fields with the same group.id render together
+     *  under a titled section. Ungrouped fields render in a default section at the top.
+     *  `order` controls the display order of groups; defaults to the order of first occurrence. */
+    fieldGroup?: {
+        id: string;
+        title: string;
+        description?: string;
+        order?: number;
+    };
+}
+export interface RowAction<T = Record<string, unknown>> {
+    action: string;
+    icon: string;
+    tooltip?: string;
+    severity?: 'secondary' | 'success' | 'info' | 'warn' | 'danger' | 'contrast';
+    visible?: (data: T) => boolean;
+    disabled?: (data: T) => boolean;
+    handler?: (data: T) => void;
+}
+export interface CrudLabels {
+    createTitle: string;
+    editTitle: string;
+    viewTitle?: string;
+    createButton: string;
+    saveButton: string;
+    updateButton: string;
+    cancelButton: string;
+    deleteConfirmTitle: string;
+    deleteConfirmMessage: string;
+    searchPlaceholder: string;
+    emptyMessage: string;
+    successCreate: string;
+    successUpdate: string;
+    successDelete: string;
+}
+export declare const DEFAULT_CRUD_LABELS: CrudLabels;
+export interface KpiItem {
+    icon: string;
+    label: string;
+    value: string | number;
+    color?: string;
+    severity?: 'primary' | 'success' | 'warning' | 'danger' | 'info';
+    hint?: string;
+    loading?: boolean;
+    trend?: {
+        value: string;
+        direction?: 'up' | 'down' | 'neutral';
+    };
+}
+export interface CrudManagerConfig<T> {
+    endpoint: string;
+    columns: ColumnDef[];
+    form: FieldDef[];
+    pk?: string;
+    pageSize?: number;
+    searchDebounce?: number;
+    /** When editing, send only the changed fields (diff) instead of the whole
+     *  record. Defaults to `true`. Set `false` to always send the full payload. */
+    partialUpdate?: boolean;
+    canCreate?: boolean;
+    canEdit?: boolean;
+    canDelete?: boolean;
+    rowActions?: RowAction<T>[];
+    filterParams?: () => Record<string, unknown>;
+    transformPayload?: (payload: Record<string, unknown>, isEditing: boolean) => Record<string, unknown>;
+    createDefaults?: () => Record<string, unknown>;
+    onAfterSave?: (data: T, isEditing: boolean) => void;
+    onAfterDelete?: (item: T) => void;
+    labels?: Partial<CrudLabels>;
+}
+export interface CrudManagerReturn<T> {
+    items: Ref<T[]>;
+    extras: Ref<Record<string, unknown>>;
+    loading: Ref<boolean>;
+    saving: Ref<boolean>;
+    search: Ref<string>;
+    dialogVisible: Ref<boolean>;
+    editingItem: Ref<T | null>;
+    formData: Record<string, unknown>;
+    pagination: PaginationState;
+    sort: SortState;
+    isEditing: ComputedRef<boolean>;
+    isViewing: ComputedRef<boolean>;
+    viewMode: Ref<boolean>;
+    dialogTitle: ComputedRef<string>;
+    isFirstPage: ComputedRef<boolean>;
+    isLastPage: ComputedRef<boolean>;
+    init(): Promise<void>;
+    fetchItems(params?: Record<string, unknown>): Promise<void>;
+    refresh(): Promise<void>;
+    setSearch(value: string): void;
+    onSearch(event: Event): void;
+    onPage(event: {
+        page: number;
+        rows: number;
+    }): void;
+    onSort(event: {
+        sortField?: string | null;
+        sortOrder?: 1 | -1 | 0 | null;
+    }): void;
+    openCreateDialog(): void;
+    openEditDialog(item: T): void;
+    openViewDialog(item: T): void;
+    save(): Promise<T | null>;
+    confirmDelete(item: T): void;
+    setFormField(field: string, value: unknown): void;
+    resetForm(): void;
+    goToPage(page: number): void;
+    firstPage(): void;
+    lastPage(): void;
+    config: CrudManagerConfig<T>;
+}

package/dist/types/types/dataProvider.d.ts

@@ -0,0 +1,28 @@
+export interface DataProviderListParams {
+    page?: number;
+    page_size?: number;
+    search?: string;
+    ordering?: string;
+    [key: string]: unknown;
+}
+export interface DataProviderListResponse<T = Record<string, unknown>> {
+    data: T[];
+    page: number;
+    page_size: number;
+    rows: number;
+    extras?: Record<string, unknown>;
+}
+export interface DataProviderResponse<T = unknown> {
+    data: T;
+}
+export interface DataProviderRequestConfig {
+    params?: Record<string, unknown>;
+    headers?: Record<string, string>;
+}
+export interface DataProvider {
+    list<T = Record<string, unknown>>(endpoint: string, params?: DataProviderListParams): Promise<DataProviderListResponse<T>>;
+    get<T = Record<string, unknown>>(endpoint: string, id: string | number, config?: DataProviderRequestConfig): Promise<DataProviderResponse<T>>;
+    create<T = Record<string, unknown>>(endpoint: string, payload: Record<string, unknown> | FormData, config?: DataProviderRequestConfig): Promise<DataProviderResponse<T>>;
+    update<T = Record<string, unknown>>(endpoint: string, id: string | number, payload: Record<string, unknown> | FormData, config?: DataProviderRequestConfig): Promise<DataProviderResponse<T>>;
+    delete(endpoint: string, id: string | number): Promise<void>;
+}

package/dist/types/types/index.d.ts

@@ -0,0 +1,6 @@
+export type { PaginatedResponse, PaginationState, SortState, UseApiOptions, UseApiReturn, } from './api';
+export type { ColumnDef, ColumnType, FieldDef, FieldType, SelectOption, RowAction, CrudLabels, KpiItem, CrudManagerConfig, CrudManagerReturn, } from './crud';
+export { DEFAULT_CRUD_LABELS } from './crud';
+export type { WPluginOptions, WPluginConfig } from './plugin';
+export { W_AXIOS_KEY, W_CONFIG_KEY, W_DATA_PROVIDER_KEY } from './plugin';
+export type { DataProvider, DataProviderListParams, DataProviderListResponse, DataProviderRequestConfig, DataProviderResponse, } from './dataProvider';