@almadar/ui 2.0.0 → 2.0.1

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

@@ -0,0 +1,7 @@
+/**
+ * Stores
+ *
+ * Module-level state management for entities and filtering.
+ */
+export * from './filtering';
+export * from './entityStore';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -121,7 +121,8 @@
     "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",
@@ -138,7 +139,7 @@
   ],
   "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",

package/dist/{chunk-YNP2OBK4.js → chunk-RIZ76XRF.js}

@@ -1,7 +1,7 @@
+import { cn, debugGroup, debug, debugGroupEnd, getNestedValue, isDebugEnabled } from './chunk-KKCVDUK7.js';
 import { useTheme, useUISlots } from './chunk-BTXQJGFB.js';
 import { useTranslate, useQuerySingleton, useEntityList } from './chunk-PE2H3NAW.js';
 import { useEventBus } from './chunk-YXZM3WCF.js';
-import { cn, debugGroup, debug, debugGroupEnd, getNestedValue, isDebugEnabled } from './chunk-KKCVDUK7.js';
 import { __publicField } from './chunk-PKBMQBKP.js';
 import * as React41 from 'react';
 import React41__default, { useCallback, useRef, useState, useLayoutEffect, useEffect, createContext, useMemo, useContext, Suspense } from 'react';