@almadar/std 1.0.0

package/dist/behaviors/registry.d.ts

@@ -0,0 +1,103 @@
+import { BehaviorCategory, StandardBehavior, BehaviorMetadata } from './types.js';
+import '@almadar/core/types';
+
+/**
+ * Standard Behaviors Registry
+ *
+ * Combined registry of all Standard Behaviors with lookup functions.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * All Standard Behaviors combined into a single array.
+ */
+declare const STANDARD_BEHAVIORS: StandardBehavior[];
+/**
+ * Behavior registry indexed by name for fast lookup.
+ */
+declare const BEHAVIOR_REGISTRY: Record<string, StandardBehavior>;
+/**
+ * Behaviors grouped by category.
+ */
+declare const BEHAVIORS_BY_CATEGORY: Record<BehaviorCategory, StandardBehavior[]>;
+/**
+ * Get a behavior by name.
+ *
+ * @param name - Behavior name (e.g., 'std/List')
+ * @returns The behavior or undefined if not found
+ */
+declare function getBehavior(name: string): StandardBehavior | undefined;
+/**
+ * Check if a behavior exists.
+ *
+ * @param name - Behavior name
+ * @returns true if the behavior exists
+ */
+declare function isKnownBehavior(name: string): boolean;
+/**
+ * Get all behaviors in a category.
+ *
+ * @param category - Behavior category
+ * @returns Array of behaviors in that category
+ */
+declare function getBehaviorsByCategory(category: BehaviorCategory): StandardBehavior[];
+/**
+ * Get all behavior names.
+ *
+ * @returns Array of all behavior names
+ */
+declare function getAllBehaviorNames(): string[];
+/**
+ * Get all behaviors.
+ *
+ * @returns Array of all behaviors
+ */
+declare function getAllBehaviors(): StandardBehavior[];
+/**
+ * Get metadata for all behaviors (lightweight).
+ *
+ * @returns Array of behavior metadata
+ */
+declare function getAllBehaviorMetadata(): BehaviorMetadata[];
+/**
+ * Find behaviors that match a use case.
+ *
+ * @param useCase - Use case description to match
+ * @returns Array of matching behaviors
+ */
+declare function findBehaviorsForUseCase(useCase: string): StandardBehavior[];
+/**
+ * Get behaviors that handle a specific event.
+ *
+ * @param event - Event name
+ * @returns Array of behaviors that handle this event
+ */
+declare function getBehaviorsForEvent(event: string): StandardBehavior[];
+/**
+ * Get behaviors that have a specific state.
+ *
+ * @param state - State name
+ * @returns Array of behaviors that have this state
+ */
+declare function getBehaviorsWithState(state: string): StandardBehavior[];
+/**
+ * Validate that a behavior reference is valid.
+ *
+ * @param name - Behavior name
+ * @returns Error message if invalid, null if valid
+ */
+declare function validateBehaviorReference(name: string): string | null;
+/**
+ * Get statistics about the behavior library.
+ */
+declare function getBehaviorLibraryStats(): {
+    totalBehaviors: number;
+    byCategory: Record<string, number>;
+    totalStates: number;
+    totalEvents: number;
+    totalTransitions: number;
+    totalTicks: number;
+};
+
+export { BEHAVIORS_BY_CATEGORY, BEHAVIOR_REGISTRY, STANDARD_BEHAVIORS, findBehaviorsForUseCase, getAllBehaviorMetadata, getAllBehaviorNames, getAllBehaviors, getBehavior, getBehaviorLibraryStats, getBehaviorsByCategory, getBehaviorsForEvent, getBehaviorsWithState, isKnownBehavior, validateBehaviorReference };