@vef-framework/core 2.0.11 → 2.1.0

package/dist/types/src/store/unbound.d.ts

@@ -0,0 +1,26 @@
+import { ComponentType } from 'react';
+import { StateCreator } from 'zustand';
+import { StoreProviderProps, UnboundStore } from './types';
+/**
+ * Hook signature for accessing store state with optional selector
+ */
+export interface UseStore<in out TState> {
+    (): TState;
+    <TSelected>(selector: (state: TState) => TSelected): NoInfer<TSelected>;
+}
+/**
+ * Result type returned by createComponentStore
+ */
+export interface ComponentStoreResult<TState, TInitialState extends Partial<TState> = never> {
+    StoreProvider: ComponentType<StoreProviderProps<TInitialState>>;
+    useStoreApi: <TStrictState extends TState = TState>() => UnboundStore<TStrictState>;
+    useStore: UseStore<TState>;
+}
+/**
+ * Creates a component-scoped store with React Context
+ *
+ * @param name - The name of the store (used for context display name and error messages)
+ * @param initializer - The Zustand state initializer function
+ * @returns Object containing StoreProvider, useStoreApi, and useStore
+ */
+export declare function createComponentStore<TState, TInitialState extends Partial<TState> = never>(name: string, initializer: StateCreator<TState, [["zustand/subscribeWithSelector", never], ["zustand/immer", never]], []>): ComponentStoreResult<TState, TInitialState>;

package/dist/types/src/store/use-deep.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Creates a memoized selector that uses deep equality comparison.
+ * Returns the previous value if deeply equal to prevent unnecessary re-renders.
+ *
+ * @param selector - The selector function to memoize
+ * @returns A memoized selector function
+ */
+export declare function useDeep<TState, TSelected>(selector: (state: TState) => TSelected): (state: TState) => TSelected;

package/dist/types/sse/client.d.ts

@@ -0,0 +1,16 @@
+import { SseClientOptions, SseEventHandlers, SseRequestConfig } from './types';
+/**
+ * SSE client wrapper around @microsoft/fetch-event-source.
+ */
+export declare class SseClient {
+    #private;
+    constructor(options?: SseClientOptions);
+    /**
+     * Start an SSE stream request.
+     */
+    stream(config: SseRequestConfig, handlers: SseEventHandlers): Promise<void>;
+    /**
+     * Abort all active stream requests.
+     */
+    abort(): void;
+}

package/dist/types/sse/helpers.d.ts

@@ -0,0 +1,9 @@
+import { SseClientOptions } from './types';
+import { SseClient } from './client';
+/**
+ * Create an SSE client instance (factory).
+ *
+ * @param options - SSE client options.
+ * @returns SSE client instance.
+ */
+export declare function createSseClient(options: SseClientOptions): SseClient;

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

@@ -0,0 +1,3 @@
+export { SseClient } from './client';
+export { createSseClient } from './helpers';
+export type * from './types';

package/dist/types/sse/types.d.ts

@@ -0,0 +1,98 @@
+import { Awaitable, MaybeUndefined } from '@vef-framework/shared';
+import { AuthTokens } from '../http';
+/**
+ * SSE client options.
+ */
+export interface SseClientOptions {
+    /**
+     * Retrieve auth tokens (optional, used to auto-inject Authorization header).
+     */
+    getAuthTokens?: () => Awaitable<MaybeUndefined<Readonly<Pick<AuthTokens, "accessToken">>>>;
+    /**
+     * Whether to enable automatic retries.
+     *
+     * @default true
+     */
+    enableRetry?: boolean;
+    /**
+     * Maximum retry attempts.
+     *
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Optional error message handler.
+     */
+    showErrorMessage?: (message: string) => void;
+    /**
+     * Callback when token expires (401 response).
+     * Return true if token was refreshed and request should be retried.
+     * Return false to abort the request.
+     */
+    onTokenExpired?: () => Awaitable<boolean>;
+}
+/**
+ * SSE request configuration.
+ */
+export interface SseRequestConfig {
+    /**
+     * Request URL.
+     */
+    url: string;
+    /**
+     * HTTP method.
+     *
+     * @default "POST"
+     */
+    method?: "GET" | "POST" | "PUT" | "DELETE";
+    /**
+     * Request headers.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Request body (POST/PUT only).
+     */
+    body?: string | object;
+    /**
+     * AbortSignal for canceling the request.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * SSE message event.
+ */
+export interface SseMessageEvent {
+    /**
+     * Event ID.
+     */
+    id?: string;
+    /**
+     * Event type.
+     */
+    event?: string;
+    /**
+     * Message data.
+     */
+    data: string;
+}
+/**
+ * SSE event handlers.
+ */
+export interface SseEventHandlers {
+    /**
+     * Connection opened callback.
+     */
+    onOpen?: (response: Response) => Awaitable<void>;
+    /**
+     * Message received callback.
+     */
+    onMessage: (event: SseMessageEvent) => void;
+    /**
+     * Error callback.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Connection closed callback.
+     */
+    onClose?: () => void;
+}

package/dist/types/state-machine/index.d.ts

@@ -1,6 +1,7 @@
 import { ActorOptions, AnyActorLogic, ConditionalRequired, IsNotNever, RequiredActorOptionsKeys, SnapshotFrom, Actor } from 'xstate';
 /**
- * Custom hook for creating and using an XState actor with state selection
+ * Custom hook for creating and using an XState actor with state selection.
+ * Combines actor creation with selector-based state subscription.
  *
  * @param logic - The actor logic (state machine or other actor logic)
  * @param selector - Function to select specific data from the actor's snapshot

package/dist/types/store/unbound.d.ts

@@ -2,14 +2,14 @@ import { ComponentType } from 'react';
 import { StateCreator } from 'zustand';
 import { StoreProviderProps, UnboundStore } from './types';
 /**
- * The type for the useStore hook
+ * Hook signature for accessing store state with optional selector
  */
 export interface UseStore<in out TState> {
     (): TState;
     <TSelected>(selector: (state: TState) => TSelected): NoInfer<TSelected>;
 }
 /**
- * The type for the returned component store result
+ * Result type returned by createComponentStore
  */
 export interface ComponentStoreResult<TState, TInitialState extends Partial<TState> = never> {
     StoreProvider: ComponentType<StoreProviderProps<TInitialState>>;
@@ -17,10 +17,10 @@ export interface ComponentStoreResult<TState, TInitialState extends Partial<TSta
     useStore: UseStore<TState>;
 }
 /**
- * Creates a component store
+ * Creates a component-scoped store with React Context
  *
- * @param name - The name of the store
- * @param initializer - The initializer for the store
- * @returns The component store result
+ * @param name - The name of the store (used for context display name and error messages)
+ * @param initializer - The Zustand state initializer function
+ * @returns Object containing StoreProvider, useStoreApi, and useStore
  */
 export declare function createComponentStore<TState, TInitialState extends Partial<TState> = never>(name: string, initializer: StateCreator<TState, [["zustand/subscribeWithSelector", never], ["zustand/immer", never]], []>): ComponentStoreResult<TState, TInitialState>;

package/dist/types/store/use-deep.d.ts

@@ -1,7 +1,8 @@
 /**
- * A hook that returns a memoized selector function that is deeply equal to the previous selector function.
+ * Creates a memoized selector that uses deep equality comparison.
+ * Returns the previous value if deeply equal to prevent unnecessary re-renders.
  *
- * @param selector - The selector function to memoize.
- * @returns The memoized selector function.
+ * @param selector - The selector function to memoize
+ * @returns A memoized selector function
  */
 export declare function useDeep<TState, TSelected>(selector: (state: TState) => TSelected): (state: TState) => TSelected;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vef-framework/core",
   "type": "module",
-  "version": "2.0.11",
+  "version": "2.1.0",
   "private": false,
   "description": "Core features for VEF framework",
   "author": {
@@ -20,7 +20,7 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "source": "./src/index.ts",
+      "vef": "./src/index.ts",
       "import": {
         "types": "./dist/types/index.d.ts",
         "default": "./dist/es/index.js"
@@ -48,26 +48,28 @@
     "react": ">=19"
   },
   "dependencies": {
-    "@dnd-kit/abstract": "^0.1.21",
-    "@dnd-kit/dom": "^0.1.21",
-    "@dnd-kit/helpers": "^0.1.21",
-    "@dnd-kit/react": "^0.1.21",
+    "@dnd-kit/abstract": "^0.3.2",
+    "@dnd-kit/dom": "^0.3.2",
+    "@dnd-kit/helpers": "^0.3.2",
+    "@dnd-kit/react": "^0.3.2",
     "@emotion/react": "^11.14.0",
     "@hello-pangea/dnd": "^18.0.1",
-    "@tanstack/react-query": "^5.90.12",
-    "@xstate/react": "^6.0.0",
-    "axios": "^1.13.2",
+    "@microsoft/fetch-event-source": "^2.0.1",
+    "@tanstack/react-query": "^5.95.2",
+    "@xstate/react": "^6.1.0",
+    "ai": "6.0.138",
+    "axios": "^1.13.6",
     "clsx": "^2.1.1",
-    "immer": "^11.0.1",
-    "jotai": "^2.15.2",
-    "motion": "^12.23.25",
+    "immer": "^11.1.4",
+    "jotai": "^2.19.0",
+    "motion": "^12.38.0",
     "use-immer": "^0.11.0",
-    "xstate": "^5.24.0",
-    "zustand": "^5.0.9",
-    "@vef-framework/shared": "2.0.11"
+    "xstate": "^5.29.0",
+    "zustand": "^5.0.12",
+    "@vef-framework/shared": "2.1.0"
   },
   "devDependencies": {
-    "react": "^19.2.1"
+    "react": "^19.2.4"
   },
   "scripts": {
     "clean": "rimraf dist",

package/dist/cjs/common/index.cjs

@@ -1 +0,0 @@
-"use strict";

package/dist/es/common/index.js

@@ -1 +0,0 @@
-