@qwanyx/stack 0.2.6 → 0.2.9

package/dist/operations/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Operations Layer
+ * Client-side data manipulation utilities
+ */
+export declare class DataOperations {
+    /**
+     * Filter array by predicate function
+     */
+    static filter<T>(items: T[], predicate: (item: T) => boolean): T[];
+    /**
+     * Filter by field value
+     */
+    static filterBy<T>(items: T[], field: keyof T, value: any): T[];
+    /**
+     * Filter by multiple fields
+     */
+    static filterByFields<T>(items: T[], filters: Partial<T>): T[];
+    /**
+     * Sort array by field
+     */
+    static sort<T>(items: T[], field: keyof T, order?: 'asc' | 'desc'): T[];
+    /**
+     * Search items by query string in specified fields
+     */
+    static search<T>(items: T[], query: string, fields: (keyof T)[]): T[];
+    /**
+     * Paginate array
+     */
+    static paginate<T>(items: T[], page: number, limit: number): {
+        data: T[];
+        total: number;
+        page: number;
+        totalPages: number;
+    };
+    /**
+     * Group items by field value
+     */
+    static groupBy<T>(items: T[], field: keyof T): Record<string, T[]>;
+    /**
+     * Get unique values for a field
+     */
+    static unique<T>(items: T[], field: keyof T): any[];
+    /**
+     * Count items by field value
+     */
+    static countBy<T>(items: T[], field: keyof T): Record<string, number>;
+    /**
+     * Apply multiple operations in sequence
+     */
+    static pipe<T>(items: T[], operations: Array<(items: T[]) => T[]>): T[];
+}

package/dist/types/index.d.ts

@@ -0,0 +1,225 @@
+/**
+ * TypeScript type definitions for Qwanyx Stack
+ */
+import { ReactNode } from 'react';
+export interface GraphNode {
+    _id: string;
+    p?: string | null;
+    type: string;
+    title?: string;
+    description?: string;
+    icon?: string;
+    editor?: string;
+    hidden?: boolean;
+    archive?: boolean;
+    data?: Record<string, any>;
+    created?: string;
+    modified?: string;
+    creator?: string;
+    owner?: string;
+    owner_group?: string | null;
+    permissions?: number;
+    acl?: string;
+}
+export interface GraphEdge {
+    source_id: string | null;
+    target_id: string;
+    edge_type: string;
+    data?: Record<string, any>;
+    created: number;
+    modified?: number;
+}
+export type StackItem = GraphNode;
+export interface StackContext {
+    apiUrl?: string;
+    systemId?: string;
+    onNavigate?: (item: StackItem) => void;
+}
+export interface ViewContext {
+    onBack?: () => void;
+    onEdit?: () => void;
+    onDelete?: () => void;
+    onOpenChat?: (nodeId: string) => void;
+    apiUrl?: string;
+    userId?: string;
+    graphClient?: any;
+}
+export type CardRenderer = (item: StackItem, context?: StackContext) => ReactNode;
+export type ViewRenderer = (item: StackItem, context?: ViewContext) => ReactNode;
+export interface EditorProps {
+    item?: StackItem;
+    graphClient: any;
+    onSave: (item: StackItem) => void;
+    onCancel: () => void;
+    onDelete?: () => void;
+    apiUrl?: string;
+    systemId?: string;
+}
+export type Editor = React.ComponentType<EditorProps>;
+export interface StackConfig {
+    id: string;
+    name?: string;
+    system_id: string;
+    parentId?: string;
+    displayMode?: 'children' | 'edges' | 'both';
+    maxWidth?: string;
+    minWidth?: string;
+    cardRenderer?: CardRenderer;
+    viewRenderer?: ViewRenderer;
+    items?: StackItem[];
+    loadItems?: () => Promise<StackItem[]>;
+    metadata?: {
+        hidden?: boolean;
+        archive?: boolean;
+        originalNode?: any;
+        isSelected?: boolean;
+    };
+    onNavigate?: (item: StackItem) => void;
+    onAdd?: () => void;
+    onAddRequest?: (data: any) => Promise<void>;
+    systemMessage?: {
+        type: 'error' | 'warning' | 'info' | 'success';
+        message: string;
+        details?: string;
+    };
+}
+export interface StackProps {
+    config: StackConfig;
+    onItemClick?: (item: StackItem) => void;
+    onClose?: () => void;
+    onClick?: (event: React.MouseEvent) => void;
+    style?: React.CSSProperties;
+    currentView?: StackItem | null;
+    viewNode?: any;
+    onCloseView?: () => void;
+    onAdd?: () => void;
+    theme?: StackTheme;
+    apiUrl?: string;
+    userId?: string;
+    onCreateColumn?: (item: StackItem, direction: 'left' | 'right') => void;
+}
+export interface StackTheme {
+    primary?: string;
+    surface?: string;
+    surfaceHover?: string;
+    muted?: string;
+    text?: string;
+    textMuted?: string;
+    success?: string;
+    error?: string;
+}
+export interface StackContainerProps {
+    stacks: StackConfig[];
+    defaultViewMode?: 'side' | 'fullscreen' | 'modal';
+    maxStacks?: number;
+    stackSpacing?: string;
+    containerPadding?: string;
+    onStackClose?: (stackId: string) => void;
+    onStackOpen?: (config: StackConfig) => void;
+    style?: React.CSSProperties;
+}
+export type LayoutMode = 'list' | 'grid' | 'masonry';
+export interface GraphClientConfig {
+    baseUrl: string;
+    system_id: string;
+}
+export interface APIResponse<T = any> {
+    success: boolean;
+    data?: T;
+    result?: T;
+    error?: string;
+}
+export interface ApiConfig {
+    baseUrl: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+export interface ApiResponse<T = any> {
+    data: T;
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+export interface PaginationParams {
+    page?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface SortParams {
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+export interface FilterParams {
+    [key: string]: any;
+}
+export interface QueryParams extends PaginationParams, SortParams, FilterParams {
+}
+export interface PaginatedResponse<T = any> {
+    data: T[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface RequestOptions {
+    method?: HttpMethod;
+    headers?: Record<string, string>;
+    body?: any;
+    params?: QueryParams;
+}
+export interface MailClientConfig {
+    baseUrl: string;
+    system_id: string;
+}
+export interface MailServer {
+    host: string;
+    port: string;
+    user: string;
+    password: string;
+}
+export interface MailAccount {
+    id: string;
+    label: string;
+    firstName: string;
+    lastName: string;
+    email: string;
+    signature?: string;
+    imap: MailServer;
+    smtp: MailServer;
+}
+export interface EmailMessage {
+    uid: number;
+    subject: string;
+    from: string;
+    date: string;
+    seen: boolean;
+}
+export interface MailListResult {
+    account: {
+        id: string;
+        label: string;
+        email: string;
+    };
+    mailbox: {
+        name: string;
+        total: number;
+    };
+    messages: EmailMessage[];
+}
+export interface ImapResponse {
+    ok: boolean;
+    command: string;
+    error?: string;
+    mailbox?: string;
+    exists?: number;
+    recent?: number;
+    unseen?: number;
+    folders?: FolderInfo[];
+    uid?: string;
+}
+export interface FolderInfo {
+    name: string;
+    delimiter: string | null;
+    attributes: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwanyx/stack",
-  "version": "0.2.6",
+  "version": "0.2.9",
   "description": "Modern HyperCard for React - All-in-one data management (REST + Graph API + Auth + Hooks + UI)",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",