@almadar/ui 2.13.3 → 2.15.0

package/dist/scripts/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Design System Generator Types
+ *
+ * Input configuration for generating a customized design system
+ * that gets output to a project folder.
+ */
+export interface DesignSystemConfig {
+    /** Project/client name (e.g., "winning-11") */
+    projectName: string;
+    /** Output directory for the generated design system */
+    outputDir: string;
+    /** Theme configuration */
+    theme: ThemeConfig;
+    /** Custom components not in the standard library */
+    customComponents?: CustomComponentConfig[];
+    /** Which standard components to include (default: all) */
+    includeComponents?: ComponentFilter;
+    /** Storybook configuration */
+    storybook?: StorybookConfig;
+}
+export interface ThemeConfig {
+    /** Theme name (used in data-design-theme attribute) */
+    name: string;
+    /** Theme display name for documentation */
+    displayName?: string;
+    /** Design metaphor/style description */
+    metaphor?: string;
+    /** Color palette */
+    colors: {
+        primary: string;
+        primaryHover?: string;
+        primaryForeground?: string;
+        secondary: string;
+        secondaryHover?: string;
+        secondaryForeground?: string;
+        accent: string;
+        accentForeground?: string;
+        muted: string;
+        mutedForeground?: string;
+        background: string;
+        foreground: string;
+        card?: string;
+        cardForeground?: string;
+        border: string;
+        input?: string;
+        ring?: string;
+        /** Semantic colors */
+        success?: string;
+        warning?: string;
+        error?: string;
+        info?: string;
+        /** Custom domain-specific colors */
+        custom?: Record<string, string>;
+    };
+    /** Shadow style preset or custom shadows */
+    shadows?: 'soft-organic' | 'minimal' | 'corporate' | 'playful' | 'dramatic' | 'soft' | ShadowConfig;
+    /** Border radius preset or custom radii */
+    radius?: 'organic' | 'gentle' | 'sharp' | 'rounded' | 'friendly' | RadiusConfig;
+    /** Typography overrides */
+    typography?: {
+        fontFamily?: string;
+        fontWeightNormal?: number;
+        fontWeightMedium?: number;
+        fontWeightBold?: number;
+    };
+    /** Dark mode variant */
+    darkMode?: Partial<ThemeConfig['colors']>;
+}
+export interface ShadowConfig {
+    main: string;
+    sm: string;
+    lg: string;
+    hover: string;
+    inner?: string;
+    active?: string;
+}
+export interface RadiusConfig {
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+}
+export interface CustomComponentConfig {
+    /** Component name (PascalCase) */
+    name: string;
+    /** Component description */
+    description: string;
+    /** Category in the component library */
+    category: 'atoms' | 'molecules' | 'organisms' | 'templates';
+    /** Component props */
+    props: ComponentProp[];
+    /** Why this component is needed */
+    reasoning?: string;
+    /** Priority for implementation */
+    priority?: 'high' | 'medium' | 'low';
+    /** Optional implementation code */
+    implementation?: string;
+    /** Optional Storybook stories */
+    stories?: string;
+}
+export interface ComponentProp {
+    name: string;
+    type: string;
+    description: string;
+    required?: boolean;
+    defaultValue?: string;
+}
+export interface ComponentFilter {
+    /** Include all components (default: true) */
+    all?: boolean;
+    /** Specific categories to include */
+    categories?: ('atoms' | 'molecules' | 'organisms' | 'templates')[];
+    /** Specific components to include (by name) */
+    include?: string[];
+    /** Specific components to exclude (by name) */
+    exclude?: string[];
+}
+export interface StorybookConfig {
+    /** Build Storybook (default: true) */
+    build?: boolean;
+    /** Include Storybook source in output (default: true) */
+    includeSource?: boolean;
+    /** Custom Storybook title */
+    title?: string;
+}
+/**
+ * Example configuration for Winning-11 (Garden theme)
+ */
+export declare const WINNING_11_CONFIG: DesignSystemConfig;

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/dist/tsup.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("tsup").Options | import("tsup").Options[] | ((overrideOptions: import("tsup").Options) => import("tsup").Options | import("tsup").Options[] | Promise<import("tsup").Options | import("tsup").Options[]>);
+export default _default;

package/dist/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "2.13.3",
+  "version": "2.15.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -82,6 +82,7 @@
     "themes"
   ],
   "publishConfig": {
+    "registry": "https://registry.npmjs.org",
     "access": "public"
   },
   "dependencies": {
@@ -102,7 +103,7 @@
   },
   "peerDependencies": {
     "@react-three/drei": "^9.92.0 || ^10.0.0",
-    "@react-three/fiber": "^8.15.0",
+    "@react-three/fiber": "^9.0.0",
     "@tanstack/react-query": "^5.0.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
@@ -150,7 +151,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/almadar-io/almadar.git",
+    "url": "https://github.com/almadar-io/almadar-ui.git",
     "directory": "docs/packages/ui"
   },
   "license": "MIT",
@@ -163,7 +164,7 @@
   ],
   "homepage": "https://github.com/almadar-io/almadar#readme",
   "scripts": {
-    "build": "tsup && tsc --declaration --emitDeclarationOnly --outDir dist --skipLibCheck",
+    "build": "tsup && tsc -p tsconfig.build.json",
     "build:watch": "tsup --watch",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build -o storybook-static",

package/dist/chunk-42YQ6JVR.js

@@ -1,48 +0,0 @@
-// lib/traitRegistry.ts
-var traits = /* @__PURE__ */ new Map();
-var listeners = /* @__PURE__ */ new Set();
-function notifyListeners() {
-  listeners.forEach((listener) => listener());
-}
-function registerTrait(info) {
-  traits.set(info.id, info);
-  notifyListeners();
-}
-function updateTraitState(id, newState) {
-  const trait = traits.get(id);
-  if (trait) {
-    trait.currentState = newState;
-    trait.transitionCount++;
-    notifyListeners();
-  }
-}
-function updateGuardResult(traitId, guardName, result) {
-  const trait = traits.get(traitId);
-  if (trait) {
-    const guard = trait.guards.find((g) => g.name === guardName);
-    if (guard) {
-      guard.lastResult = result;
-      notifyListeners();
-    }
-  }
-}
-function unregisterTrait(id) {
-  traits.delete(id);
-  notifyListeners();
-}
-function getAllTraits() {
-  return Array.from(traits.values());
-}
-function getTrait(id) {
-  return traits.get(id);
-}
-function subscribeToTraitChanges(listener) {
-  listeners.add(listener);
-  return () => listeners.delete(listener);
-}
-function clearTraits() {
-  traits.clear();
-  notifyListeners();
-}
-
-export { clearTraits, getAllTraits, getTrait, registerTrait, subscribeToTraitChanges, unregisterTrait, updateGuardResult, updateTraitState };