@almadar/ui 1.0.34 → 2.0.1

package/dist/renderer/useClientEffects.d.ts

@@ -0,0 +1,88 @@
+import type { ClientEffect, ClientEffectExecutorConfig } from './types';
+/**
+ * Options for the useClientEffects hook
+ */
+export interface UseClientEffectsOptions extends ClientEffectExecutorConfig {
+    /**
+     * Whether to execute effects. Defaults to true.
+     * Set to false to temporarily disable effect execution.
+     */
+    enabled?: boolean;
+    /**
+     * Debug mode - logs effect execution details.
+     */
+    debug?: boolean;
+}
+/**
+ * Result of useClientEffects hook
+ */
+export interface UseClientEffectsResult {
+    /**
+     * Number of effects executed in the last batch.
+     */
+    executedCount: number;
+    /**
+     * Whether effects are currently being executed.
+     */
+    executing: boolean;
+    /**
+     * Manually trigger effect execution.
+     * Useful for imperative control.
+     */
+    execute: (effects: ClientEffect[]) => void;
+}
+/**
+ * Execute client effects from server response.
+ *
+ * This hook automatically executes effects when they change,
+ * tracking which effects have been executed to prevent duplicates.
+ *
+ * @param effects - Array of client effects to execute (from server response)
+ * @param options - Configuration including effect implementations
+ * @returns Hook result with execution state and manual trigger
+ *
+ * @example
+ * ```typescript
+ * function useMyTrait() {
+ *   const [state, setState] = useState({ pendingEffects: [] });
+ *   const effectConfig = useClientEffectConfig();
+ *
+ *   useClientEffects(state.pendingEffects, {
+ *     ...effectConfig,
+ *     onComplete: () => setState(s => ({ ...s, pendingEffects: [] }))
+ *   });
+ *
+ *   // ...
+ * }
+ * ```
+ */
+export declare function useClientEffects(effects: ClientEffect[] | undefined, options: UseClientEffectsOptions): UseClientEffectsResult;
+declare const ClientEffectConfigContext: import("react").Context<ClientEffectExecutorConfig | null>;
+/**
+ * Provider for client effect configuration.
+ */
+export declare const ClientEffectConfigProvider: import("react").Provider<ClientEffectExecutorConfig | null>;
+/**
+ * Hook to get the client effect configuration from context.
+ *
+ * @throws Error if used outside of ClientEffectConfigProvider
+ *
+ * @example
+ * ```typescript
+ * function MyTraitHook() {
+ *   const effectConfig = useClientEffectConfig();
+ *
+ *   useClientEffects(pendingEffects, {
+ *     ...effectConfig,
+ *     onComplete: () => clearPendingEffects()
+ *   });
+ * }
+ * ```
+ */
+export declare function useClientEffectConfig(): ClientEffectExecutorConfig;
+/**
+ * Hook to get client effect configuration, returning null if not available.
+ * Use this for optional integration where effects may not be configured.
+ */
+export declare function useClientEffectConfigOptional(): ClientEffectExecutorConfig | null;
+export { ClientEffectConfigContext };

package/dist/stores/entityStore.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Entity Store
+ *
+ * Simple module-level store for runtime entities.
+ * No providers needed - hooks import and use directly.
+ *
+ * NOTE: Mutations create new Map instances to trigger React rerenders
+ * when using useSyncExternalStore.
+ */
+import { type EntityFilterValue, type FilterOperator, type EntityFilters, applyFilters, createFilter } from './filtering';
+export type { EntityFilterValue, FilterOperator, EntityFilters };
+export { applyFilters, createFilter };
+export interface Entity {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+}
+type Listener = () => void;
+/**
+ * Subscribe to store changes
+ */
+export declare function subscribe(listener: Listener): () => void;
+/**
+ * Get all entities
+ */
+export declare function getEntities(): Map<string, Entity>;
+/**
+ * Get entity by ID
+ */
+export declare function getEntity(id: string): Entity | undefined;
+/**
+ * Get entities by type
+ */
+export declare function getByType(type: string | string[]): Entity[];
+/**
+ * Get all entities as array
+ */
+export declare function getAllEntities(): Entity[];
+/**
+ * Get singleton entity by type (first of that type)
+ */
+export declare function getSingleton(type: string): Entity | undefined;
+/**
+ * Spawn a new entity
+ */
+export declare function spawnEntity(config: {
+    type: string;
+    id?: string;
+    [key: string]: unknown;
+}): string;
+/**
+ * Update an entity
+ */
+export declare function updateEntity(id: string, updates: Partial<Entity>): void;
+/**
+ * Update singleton entity by type
+ */
+export declare function updateSingleton(type: string, updates: Partial<Entity>): void;
+/**
+ * Remove an entity
+ */
+export declare function removeEntity(id: string): void;
+/**
+ * Clear all entities
+ */
+export declare function clearEntities(): void;
+/**
+ * Set a filter for an entity type
+ * @param entityType - The entity type to filter (e.g., "Player", "Enemy")
+ * @param field - The filter key (e.g., 'status' or 'date_from')
+ * @param value - The filter value
+ * @param operator - The comparison operator
+ * @param targetField - The actual record field to compare (defaults to field)
+ */
+export declare function setFilter(entityType: string, field: string, value: unknown, operator?: FilterOperator, targetField?: string): void;
+/**
+ * Clear a specific filter
+ */
+export declare function clearFilter(entityType: string, field: string): void;
+/**
+ * Clear all filters for an entity type
+ */
+export declare function clearAllFilters(entityType: string): void;
+/**
+ * Get active filters for an entity type
+ */
+export declare function getFilters(entityType: string): EntityFilters;
+/**
+ * Get entities by type with optional filtering
+ */
+export declare function getByTypeFiltered(type: string | string[]): Entity[];
+/**
+ * Get snapshot for React useSyncExternalStore
+ */
+export declare function getSnapshot(): Map<string, Entity>;
+/**
+ * Get filter snapshot for React useSyncExternalStore
+ */
+export declare function getFilterSnapshot(): Map<string, EntityFilters>;

package/dist/stores/filtering.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Entity Filtering Utilities
+ *
+ * Provides filter types and utility functions for filtering entity records.
+ * Used by EntityStore and can be imported by runtime preview.
+ */
+/** Filter value for a single field (entity filtering) */
+export interface EntityFilterValue {
+    /** The field key (may include suffix like _from, _to for date ranges) */
+    field: string;
+    /** The actual record field to compare against (defaults to field if not specified) */
+    targetField?: string;
+    value: unknown;
+    /** Comparison operator for filtering
+     * - eq: exact match (default)
+     * - contains: substring match for strings
+     * - in: value is in array
+     * - date_eq: same date (ignoring time)
+     * - date_gte: on or after date
+     * - date_lte: on or before date
+     */
+    operator?: FilterOperator;
+}
+/** Operator type for filter */
+export type FilterOperator = 'eq' | 'contains' | 'in' | 'date_eq' | 'date_gte' | 'date_lte' | 'search';
+/** Filter state for an entity - Map of field key to filter value */
+export type EntityFilters = Map<string, EntityFilterValue>;
+/** Record type that can be filtered */
+export interface FilterableRecord {
+    id: string;
+    [key: string]: unknown;
+}
+/**
+ * Extract date part from ISO string or Date object.
+ * Returns format: "YYYY-MM-DD"
+ */
+export declare function getDateString(value: unknown): string | null;
+/**
+ * Apply a single filter to check if a record matches.
+ * Returns true if the record passes the filter.
+ */
+export declare function matchesFilter(record: FilterableRecord, filter: EntityFilterValue): boolean;
+/**
+ * Apply all filters to a list of records.
+ * Returns only records that match ALL filters.
+ */
+export declare function applyFilters<T extends FilterableRecord>(records: T[], entityFilters: EntityFilters): T[];
+/**
+ * Create a filter value with proper defaults.
+ */
+export declare function createFilter(field: string, value: unknown, operator?: FilterOperator, targetField?: string): EntityFilterValue;

package/dist/stores/index.d.ts

@@ -1,151 +1,7 @@
 /**
- * Entity Filtering Utilities
+ * Stores
  *
- * Provides filter types and utility functions for filtering entity records.
- * Used by EntityStore and can be imported by runtime preview.
+ * Module-level state management for entities and filtering.
  */
-/** Filter value for a single field (entity filtering) */
-interface EntityFilterValue {
-    /** The field key (may include suffix like _from, _to for date ranges) */
-    field: string;
-    /** The actual record field to compare against (defaults to field if not specified) */
-    targetField?: string;
-    value: unknown;
-    /** Comparison operator for filtering
-     * - eq: exact match (default)
-     * - contains: substring match for strings
-     * - in: value is in array
-     * - date_eq: same date (ignoring time)
-     * - date_gte: on or after date
-     * - date_lte: on or before date
-     */
-    operator?: FilterOperator;
-}
-/** Operator type for filter */
-type FilterOperator = 'eq' | 'contains' | 'in' | 'date_eq' | 'date_gte' | 'date_lte' | 'search';
-/** Filter state for an entity - Map of field key to filter value */
-type EntityFilters = Map<string, EntityFilterValue>;
-/** Record type that can be filtered */
-interface FilterableRecord {
-    id: string;
-    [key: string]: unknown;
-}
-/**
- * Extract date part from ISO string or Date object.
- * Returns format: "YYYY-MM-DD"
- */
-declare function getDateString(value: unknown): string | null;
-/**
- * Apply a single filter to check if a record matches.
- * Returns true if the record passes the filter.
- */
-declare function matchesFilter(record: FilterableRecord, filter: EntityFilterValue): boolean;
-/**
- * Apply all filters to a list of records.
- * Returns only records that match ALL filters.
- */
-declare function applyFilters<T extends FilterableRecord>(records: T[], entityFilters: EntityFilters): T[];
-/**
- * Create a filter value with proper defaults.
- */
-declare function createFilter(field: string, value: unknown, operator?: FilterOperator, targetField?: string): EntityFilterValue;
-
-/**
- * Entity Store
- *
- * Simple module-level store for runtime entities.
- * No providers needed - hooks import and use directly.
- *
- * NOTE: Mutations create new Map instances to trigger React rerenders
- * when using useSyncExternalStore.
- */
-
-interface Entity {
-    id: string;
-    type: string;
-    [key: string]: unknown;
-}
-type Listener = () => void;
-/**
- * Subscribe to store changes
- */
-declare function subscribe(listener: Listener): () => void;
-/**
- * Get all entities
- */
-declare function getEntities(): Map<string, Entity>;
-/**
- * Get entity by ID
- */
-declare function getEntity(id: string): Entity | undefined;
-/**
- * Get entities by type
- */
-declare function getByType(type: string | string[]): Entity[];
-/**
- * Get all entities as array
- */
-declare function getAllEntities(): Entity[];
-/**
- * Get singleton entity by type (first of that type)
- */
-declare function getSingleton(type: string): Entity | undefined;
-/**
- * Spawn a new entity
- */
-declare function spawnEntity(config: {
-    type: string;
-    id?: string;
-    [key: string]: unknown;
-}): string;
-/**
- * Update an entity
- */
-declare function updateEntity(id: string, updates: Partial<Entity>): void;
-/**
- * Update singleton entity by type
- */
-declare function updateSingleton(type: string, updates: Partial<Entity>): void;
-/**
- * Remove an entity
- */
-declare function removeEntity(id: string): void;
-/**
- * Clear all entities
- */
-declare function clearEntities(): void;
-/**
- * Set a filter for an entity type
- * @param entityType - The entity type to filter (e.g., "Player", "Enemy")
- * @param field - The filter key (e.g., 'status' or 'date_from')
- * @param value - The filter value
- * @param operator - The comparison operator
- * @param targetField - The actual record field to compare (defaults to field)
- */
-declare function setFilter(entityType: string, field: string, value: unknown, operator?: FilterOperator, targetField?: string): void;
-/**
- * Clear a specific filter
- */
-declare function clearFilter(entityType: string, field: string): void;
-/**
- * Clear all filters for an entity type
- */
-declare function clearAllFilters(entityType: string): void;
-/**
- * Get active filters for an entity type
- */
-declare function getFilters(entityType: string): EntityFilters;
-/**
- * Get entities by type with optional filtering
- */
-declare function getByTypeFiltered(type: string | string[]): Entity[];
-/**
- * Get snapshot for React useSyncExternalStore
- */
-declare function getSnapshot(): Map<string, Entity>;
-/**
- * Get filter snapshot for React useSyncExternalStore
- */
-declare function getFilterSnapshot(): Map<string, EntityFilters>;
-
-export { type Entity, type EntityFilterValue, type EntityFilters, type FilterOperator, type FilterableRecord, applyFilters, clearAllFilters, clearEntities, clearFilter, createFilter, getAllEntities, getByType, getByTypeFiltered, getDateString, getEntities, getEntity, getFilterSnapshot, getFilters, getSingleton, getSnapshot, matchesFilter, removeEntity, setFilter, spawnEntity, subscribe, updateEntity, updateSingleton };
+export * from './filtering';
+export * from './entityStore';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "1.0.34",
+  "version": "2.0.1",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -70,6 +70,9 @@
     "access": "public"
   },
   "dependencies": {
+    "@almadar/core": ">=2.0.0",
+    "@almadar/evaluator": ">=2.0.0",
+    "@almadar/patterns": ">=2.0.0",
     "clsx": "^2.1.0",
     "tailwind-merge": "^2.2.0",
     "lucide-react": "^0.344.0",
@@ -77,10 +80,7 @@
     "remark-gfm": "^4.0.0",
     "remark-math": "^6.0.0",
     "rehype-katex": "^7.0.0",
-    "react-syntax-highlighter": "^15.6.1",
-    "@almadar/core": "1.0.18",
-    "@almadar/evaluator": "1.0.16",
-    "@almadar/patterns": "1.1.1"
+    "react-syntax-highlighter": "^15.6.1"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -105,8 +105,8 @@
     "@storybook/react-vite": "^10.2.6",
     "storybook": "^10.2.6",
     "@vitejs/plugin-react": "^4.2.0",
-    "babel-plugin-react-compiler": "^1.0.0",
-    "react-compiler-runtime": "^1.0.0",
+    "babel-plugin-react-compiler": "19.0.0-beta-af1b7da-20250417",
+    "react-compiler-runtime": "19.0.0-beta-af1b7da-20250417",
     "autoprefixer": "^10.4.0",
     "postcss": "^8.4.35",
     "tailwindcss": "^3.4.0",
@@ -121,12 +121,13 @@
     "jsdom": "^24.0.0",
     "@storybook/addon-docs": "^10.2.6",
     "@types/react-syntax-highlighter": "^15.5.0",
-    "katex": "^0.16.0"
+    "katex": "^0.16.0",
+    "@types/node": "^22.0.0"
   },
   "repository": {
     "type": "git",
     "url": "https://github.com/almadar-io/almadar.git",
-    "directory": "packages/almadar-ui"
+    "directory": "docs/packages/ui"
   },
   "license": "MIT",
   "keywords": [
@@ -136,8 +137,9 @@
     "components",
     "hooks"
   ],
+  "homepage": "https://github.com/almadar-io/almadar#readme",
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsc --declaration --emitDeclarationOnly --outDir dist --skipLibCheck || true",
     "build:watch": "tsup --watch",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build -o storybook-static",