@sharpee/world-model 2.0.0 → 2.1.0

package/capabilities/capability-registry.d.ts

@@ -1,115 +0,0 @@
-/**
- * Capability Registry (ADR-090)
- *
- * Registry for trait-behavior bindings. Stories register behaviors
- * for their traits, and the dispatch system looks them up at runtime.
- */
-import { ITrait } from '../traits/trait';
-import { CapabilityBehavior } from './capability-behavior';
-import { CapabilityResolution, CapabilityMode } from './capability-defaults';
-/**
- * Options for registering a capability behavior.
- */
-export interface BehaviorRegistrationOptions<T extends ITrait = ITrait> {
-    /** Priority for resolution (higher = checked first). Default: 0 */
-    priority?: number;
-    /** Override global resolution strategy for this binding */
-    resolution?: CapabilityResolution;
-    /** Override global mode for this binding */
-    mode?: CapabilityMode;
-    /** Optional runtime validation */
-    validateBinding?: (trait: T) => boolean;
-}
-/**
- * Binding between a trait type, capability, and behavior.
- */
-export interface TraitBehaviorBinding<T extends ITrait = ITrait> {
-    /** Trait type identifier */
-    traitType: string;
-    /** Action ID (capability) this binding handles */
-    capability: string;
-    /** The behavior that handles this trait+capability */
-    behavior: CapabilityBehavior;
-    /** Priority for resolution (higher = checked first) */
-    priority: number;
-    /** Override resolution strategy (undefined = use global default) */
-    resolution?: CapabilityResolution;
-    /** Override mode (undefined = use global default) */
-    mode?: CapabilityMode;
-    /** Optional runtime validation */
-    validateBinding?: (trait: T) => boolean;
-}
-/**
- * Register a behavior for a trait+capability combination.
- *
- * Stories call this to register their behaviors during initialization.
- * Each trait+capability pair can only have one behavior registered.
- *
- * @param traitType - The trait type identifier (e.g., 'dungeo.trait.basket_elevator')
- * @param capability - The action ID (e.g., 'if.action.lowering')
- * @param behavior - The behavior implementation
- * @param options - Optional configuration (priority, resolution override, mode override)
- *
- * @example
- * ```typescript
- * // Basic registration (uses global defaults)
- * registerCapabilityBehavior(
- *   BasketElevatorTrait.type,
- *   'if.action.lowering',
- *   BasketLoweringBehavior
- * );
- *
- * // With priority and overrides
- * registerCapabilityBehavior(
- *   TrollAxeTrait.type,
- *   'if.action.taking',
- *   TrollAxeTakingBehavior,
- *   { priority: 100, resolution: 'any-blocks' }
- * );
- * ```
- */
-export declare function registerCapabilityBehavior<T extends ITrait>(traitType: string, capability: string, behavior: CapabilityBehavior, options?: BehaviorRegistrationOptions<T>): void;
-/**
- * Get behavior for a trait instance and capability.
- *
- * Called by capability-dispatch actions to find the right behavior.
- *
- * @param trait - The trait instance
- * @param capability - The action ID
- * @returns The behavior, or undefined if not registered
- */
-export declare function getBehaviorForCapability(trait: ITrait, capability: string): CapabilityBehavior | undefined;
-/**
- * Get the full binding for a trait instance and capability.
- *
- * Includes priority and configuration overrides. Used by dispatch helper
- * for resolution logic.
- *
- * @param trait - The trait instance
- * @param capability - The action ID
- * @returns The binding, or undefined if not registered
- */
-export declare function getBehaviorBinding(trait: ITrait, capability: string): TraitBehaviorBinding | undefined;
-/**
- * Check if a behavior is registered for a trait+capability.
- *
- * @param traitType - The trait type identifier
- * @param capability - The action ID
- */
-export declare function hasCapabilityBehavior(traitType: string, capability: string): boolean;
-/**
- * Unregister a behavior (primarily for testing).
- *
- * @param traitType - The trait type identifier
- * @param capability - The action ID
- */
-export declare function unregisterCapabilityBehavior(traitType: string, capability: string): void;
-/**
- * Clear all registered behaviors (for testing).
- */
-export declare function clearCapabilityRegistry(): void;
-/**
- * Get all registered bindings (for debugging/introspection).
- */
-export declare function getAllCapabilityBindings(): Map<string, TraitBehaviorBinding>;
-//# sourceMappingURL=capability-registry.d.ts.map

package/capabilities/capability-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"capability-registry.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/capabilities/capability-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAqB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACpE,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,kCAAkC;IAClC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC7D,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,qDAAqD;IACrD,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,kCAAkC;IAClC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CACzC;AAqCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,EACzD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACvC,IAAI,CAkBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,kBAAkB,GAAG,SAAS,CAGhC;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,oBAAoB,GAAG,SAAS,CAiBlC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAExF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAE5E"}

package/capabilities/capability-registry.js

@@ -1,157 +0,0 @@
-"use strict";
-/**
- * Capability Registry (ADR-090)
- *
- * Registry for trait-behavior bindings. Stories register behaviors
- * for their traits, and the dispatch system looks them up at runtime.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerCapabilityBehavior = registerCapabilityBehavior;
-exports.getBehaviorForCapability = getBehaviorForCapability;
-exports.getBehaviorBinding = getBehaviorBinding;
-exports.hasCapabilityBehavior = hasCapabilityBehavior;
-exports.unregisterCapabilityBehavior = unregisterCapabilityBehavior;
-exports.clearCapabilityRegistry = clearCapabilityRegistry;
-exports.getAllCapabilityBindings = getAllCapabilityBindings;
-/**
- * Registry storage: key = `${traitType}:${capability}`
- * Uses globalThis to ensure the registry is shared across module boundaries
- * (e.g., when story modules import from packages but actions run from bundle)
- */
-const CAPABILITY_REGISTRY_KEY = '__sharpee_capability_behaviors__';
-function getCapabilityRegistry() {
-    const global = globalThis;
-    if (!global[CAPABILITY_REGISTRY_KEY]) {
-        global[CAPABILITY_REGISTRY_KEY] = new Map();
-    }
-    return global[CAPABILITY_REGISTRY_KEY];
-}
-const behaviorRegistry = {
-    get size() { return getCapabilityRegistry().size; },
-    has(key) { return getCapabilityRegistry().has(key); },
-    get(key) { return getCapabilityRegistry().get(key); },
-    set(key, value) { return getCapabilityRegistry().set(key, value); },
-    delete(key) { return getCapabilityRegistry().delete(key); },
-    clear() { return getCapabilityRegistry().clear(); },
-    keys() { return getCapabilityRegistry().keys(); },
-    values() { return getCapabilityRegistry().values(); },
-    entries() { return getCapabilityRegistry().entries(); },
-    [Symbol.iterator]() { return getCapabilityRegistry()[Symbol.iterator](); }
-};
-/**
- * Generate registry key for trait+capability combination.
- */
-function registryKey(traitType, capability) {
-    return `${traitType}:${capability}`;
-}
-/**
- * Register a behavior for a trait+capability combination.
- *
- * Stories call this to register their behaviors during initialization.
- * Each trait+capability pair can only have one behavior registered.
- *
- * @param traitType - The trait type identifier (e.g., 'dungeo.trait.basket_elevator')
- * @param capability - The action ID (e.g., 'if.action.lowering')
- * @param behavior - The behavior implementation
- * @param options - Optional configuration (priority, resolution override, mode override)
- *
- * @example
- * ```typescript
- * // Basic registration (uses global defaults)
- * registerCapabilityBehavior(
- *   BasketElevatorTrait.type,
- *   'if.action.lowering',
- *   BasketLoweringBehavior
- * );
- *
- * // With priority and overrides
- * registerCapabilityBehavior(
- *   TrollAxeTrait.type,
- *   'if.action.taking',
- *   TrollAxeTakingBehavior,
- *   { priority: 100, resolution: 'any-blocks' }
- * );
- * ```
- */
-function registerCapabilityBehavior(traitType, capability, behavior, options) {
-    const key = registryKey(traitType, capability);
-    if (behaviorRegistry.has(key)) {
-        throw new Error(`Behavior already registered for trait "${traitType}" and capability "${capability}"`);
-    }
-    behaviorRegistry.set(key, {
-        traitType,
-        capability,
-        behavior,
-        priority: options?.priority ?? 0,
-        resolution: options?.resolution,
-        mode: options?.mode,
-        validateBinding: options?.validateBinding
-    });
-}
-/**
- * Get behavior for a trait instance and capability.
- *
- * Called by capability-dispatch actions to find the right behavior.
- *
- * @param trait - The trait instance
- * @param capability - The action ID
- * @returns The behavior, or undefined if not registered
- */
-function getBehaviorForCapability(trait, capability) {
-    const binding = getBehaviorBinding(trait, capability);
-    return binding?.behavior;
-}
-/**
- * Get the full binding for a trait instance and capability.
- *
- * Includes priority and configuration overrides. Used by dispatch helper
- * for resolution logic.
- *
- * @param trait - The trait instance
- * @param capability - The action ID
- * @returns The binding, or undefined if not registered
- */
-function getBehaviorBinding(trait, capability) {
-    const traitType = trait.constructor.type;
-    const key = registryKey(traitType, capability);
-    const binding = behaviorRegistry.get(key);
-    if (!binding) {
-        return undefined;
-    }
-    // Runtime validation if provided
-    if (binding.validateBinding && !binding.validateBinding(trait)) {
-        throw new Error(`Behavior validation failed for trait "${traitType}", capability "${capability}"`);
-    }
-    return binding;
-}
-/**
- * Check if a behavior is registered for a trait+capability.
- *
- * @param traitType - The trait type identifier
- * @param capability - The action ID
- */
-function hasCapabilityBehavior(traitType, capability) {
-    return behaviorRegistry.has(registryKey(traitType, capability));
-}
-/**
- * Unregister a behavior (primarily for testing).
- *
- * @param traitType - The trait type identifier
- * @param capability - The action ID
- */
-function unregisterCapabilityBehavior(traitType, capability) {
-    behaviorRegistry.delete(registryKey(traitType, capability));
-}
-/**
- * Clear all registered behaviors (for testing).
- */
-function clearCapabilityRegistry() {
-    behaviorRegistry.clear();
-}
-/**
- * Get all registered bindings (for debugging/introspection).
- */
-function getAllCapabilityBindings() {
-    return new Map(getCapabilityRegistry());
-}
-//# sourceMappingURL=capability-registry.js.map

package/capabilities/capability-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"capability-registry.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/capabilities/capability-registry.ts"],"names":[],"mappings":"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"}

package/capabilities/interceptor-registry.d.ts

@@ -1,125 +0,0 @@
-/**
- * Interceptor Registry (ADR-118)
- *
- * Registry for trait-interceptor bindings. Stories register interceptors
- * for their traits, and stdlib actions look them up at runtime.
- *
- * Mirrors capability-registry.ts pattern but for interceptors instead
- * of full-delegation behaviors.
- */
-import { ITrait } from '../traits/trait';
-import { ActionInterceptor } from './action-interceptor';
-/**
- * Options for registering an action interceptor.
- */
-export interface InterceptorRegistrationOptions {
-    /** Priority for resolution (higher = checked first). Default: 0 */
-    priority?: number;
-}
-/**
- * Binding between a trait type, action, and interceptor.
- */
-export interface TraitInterceptorBinding {
-    /** Trait type identifier */
-    traitType: string;
-    /** Action ID this interceptor handles */
-    actionId: string;
-    /** The interceptor that handles this trait+action */
-    interceptor: ActionInterceptor;
-    /** Priority for resolution (higher = checked first) */
-    priority: number;
-}
-/**
- * Register an interceptor for a trait+action combination.
- *
- * Stories call this to register their interceptors during initialization.
- * Each trait+action pair can only have one interceptor registered.
- *
- * @param traitType - The trait type identifier (e.g., 'dungeo.trait.inflatable')
- * @param actionId - The action ID (e.g., 'if.action.entering')
- * @param interceptor - The interceptor implementation
- * @param options - Optional configuration (priority)
- *
- * @example
- * ```typescript
- * // Register boat puncture interceptor
- * registerActionInterceptor(
- *   InflatableTrait.type,
- *   'if.action.entering',
- *   InflatableEnteringInterceptor
- * );
- *
- * // With priority
- * registerActionInterceptor(
- *   TrollGuardianTrait.type,
- *   'if.action.going',
- *   TrollGoingInterceptor,
- *   { priority: 100 }
- * );
- * ```
- */
-export declare function registerActionInterceptor(traitType: string, actionId: string, interceptor: ActionInterceptor, options?: InterceptorRegistrationOptions): void;
-/**
- * Result from looking up an interceptor for an entity+action.
- */
-export interface InterceptorLookupResult {
-    /** The interceptor */
-    interceptor: ActionInterceptor;
-    /** The trait that declared this interceptor */
-    trait: ITrait;
-    /** The binding metadata */
-    binding: TraitInterceptorBinding;
-}
-/**
- * Get interceptor for an entity and action.
- *
- * Finds a trait on the entity that has an interceptor registered for
- * the given action. Looks up by trait type string in the registry.
- *
- * @param entity - The entity to check
- * @param actionId - The action ID
- * @returns The interceptor and trait, or undefined if not found
- *
- * @example
- * ```typescript
- * const result = getInterceptorForAction(boat, 'if.action.entering');
- * if (result) {
- *   const { interceptor, trait, binding } = result;
- *   // Call interceptor hooks during action execution
- * }
- * ```
- */
-export declare function getInterceptorForAction(entity: {
-    traits: Map<string, ITrait>;
-}, actionId: string): InterceptorLookupResult | undefined;
-/**
- * Get the interceptor binding for a trait type and action.
- *
- * @param traitType - The trait type identifier
- * @param actionId - The action ID
- * @returns The binding, or undefined if not registered
- */
-export declare function getInterceptorBinding(traitType: string, actionId: string): TraitInterceptorBinding | undefined;
-/**
- * Check if an interceptor is registered for a trait+action.
- *
- * @param traitType - The trait type identifier
- * @param actionId - The action ID
- */
-export declare function hasActionInterceptor(traitType: string, actionId: string): boolean;
-/**
- * Unregister an interceptor (primarily for testing).
- *
- * @param traitType - The trait type identifier
- * @param actionId - The action ID
- */
-export declare function unregisterActionInterceptor(traitType: string, actionId: string): void;
-/**
- * Clear all registered interceptors (for testing).
- */
-export declare function clearInterceptorRegistry(): void;
-/**
- * Get all registered interceptor bindings (for debugging/introspection).
- */
-export declare function getAllInterceptorBindings(): Map<string, TraitInterceptorBinding>;
-//# sourceMappingURL=interceptor-registry.d.ts.map

package/capabilities/interceptor-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interceptor-registry.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/capabilities/interceptor-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAqB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,WAAW,EAAE,iBAAiB,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,iBAAiB,EAC9B,OAAO,CAAC,EAAE,8BAA8B,GACvC,IAAI,CAeN;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sBAAsB;IACtB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,EAAE,uBAAuB,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE;IAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EACvC,QAAQ,EAAE,MAAM,GACf,uBAAuB,GAAG,SAAS,CA4BrC;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,uBAAuB,GAAG,SAAS,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAErF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAEhF"}

package/capabilities/interceptor-registry.js

@@ -1,176 +0,0 @@
-"use strict";
-/**
- * Interceptor Registry (ADR-118)
- *
- * Registry for trait-interceptor bindings. Stories register interceptors
- * for their traits, and stdlib actions look them up at runtime.
- *
- * Mirrors capability-registry.ts pattern but for interceptors instead
- * of full-delegation behaviors.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerActionInterceptor = registerActionInterceptor;
-exports.getInterceptorForAction = getInterceptorForAction;
-exports.getInterceptorBinding = getInterceptorBinding;
-exports.hasActionInterceptor = hasActionInterceptor;
-exports.unregisterActionInterceptor = unregisterActionInterceptor;
-exports.clearInterceptorRegistry = clearInterceptorRegistry;
-exports.getAllInterceptorBindings = getAllInterceptorBindings;
-/**
- * Registry storage: key = `${traitType}:${actionId}`
- * Uses globalThis to ensure the registry is shared across module boundaries
- * (e.g., when story modules import from packages but actions run from bundle)
- */
-const INTERCEPTOR_REGISTRY_KEY = '__sharpee_interceptor_registry__';
-// Use globalThis to share registry across module instances
-function getInterceptorRegistry() {
-    const global = globalThis;
-    if (!global[INTERCEPTOR_REGISTRY_KEY]) {
-        global[INTERCEPTOR_REGISTRY_KEY] = new Map();
-    }
-    return global[INTERCEPTOR_REGISTRY_KEY];
-}
-// For backwards compatibility, expose as const (but delegates to globalThis)
-const interceptorRegistry = {
-    get size() { return getInterceptorRegistry().size; },
-    has(key) { return getInterceptorRegistry().has(key); },
-    get(key) { return getInterceptorRegistry().get(key); },
-    set(key, value) { return getInterceptorRegistry().set(key, value); },
-    delete(key) { return getInterceptorRegistry().delete(key); },
-    clear() { return getInterceptorRegistry().clear(); },
-    keys() { return getInterceptorRegistry().keys(); },
-    values() { return getInterceptorRegistry().values(); },
-    entries() { return getInterceptorRegistry().entries(); },
-    [Symbol.iterator]() { return getInterceptorRegistry()[Symbol.iterator](); }
-};
-/**
- * Generate registry key for trait+action combination.
- */
-function registryKey(traitType, actionId) {
-    return `${traitType}:${actionId}`;
-}
-/**
- * Register an interceptor for a trait+action combination.
- *
- * Stories call this to register their interceptors during initialization.
- * Each trait+action pair can only have one interceptor registered.
- *
- * @param traitType - The trait type identifier (e.g., 'dungeo.trait.inflatable')
- * @param actionId - The action ID (e.g., 'if.action.entering')
- * @param interceptor - The interceptor implementation
- * @param options - Optional configuration (priority)
- *
- * @example
- * ```typescript
- * // Register boat puncture interceptor
- * registerActionInterceptor(
- *   InflatableTrait.type,
- *   'if.action.entering',
- *   InflatableEnteringInterceptor
- * );
- *
- * // With priority
- * registerActionInterceptor(
- *   TrollGuardianTrait.type,
- *   'if.action.going',
- *   TrollGoingInterceptor,
- *   { priority: 100 }
- * );
- * ```
- */
-function registerActionInterceptor(traitType, actionId, interceptor, options) {
-    const key = registryKey(traitType, actionId);
-    if (interceptorRegistry.has(key)) {
-        throw new Error(`Interceptor already registered for trait "${traitType}" and action "${actionId}"`);
-    }
-    interceptorRegistry.set(key, {
-        traitType,
-        actionId,
-        interceptor,
-        priority: options?.priority ?? 0
-    });
-}
-/**
- * Get interceptor for an entity and action.
- *
- * Finds a trait on the entity that has an interceptor registered for
- * the given action. Looks up by trait type string in the registry.
- *
- * @param entity - The entity to check
- * @param actionId - The action ID
- * @returns The interceptor and trait, or undefined if not found
- *
- * @example
- * ```typescript
- * const result = getInterceptorForAction(boat, 'if.action.entering');
- * if (result) {
- *   const { interceptor, trait, binding } = result;
- *   // Call interceptor hooks during action execution
- * }
- * ```
- */
-function getInterceptorForAction(entity, actionId) {
-    // Find all traits that have an interceptor registered for this action
-    const candidates = [];
-    for (const trait of entity.traits.values()) {
-        // Look up interceptor by trait type string (more reliable than static property)
-        const traitType = trait.type;
-        const key = registryKey(traitType, actionId);
-        const binding = interceptorRegistry.get(key);
-        if (binding) {
-            candidates.push({ trait, binding });
-        }
-    }
-    if (candidates.length === 0) {
-        return undefined;
-    }
-    // Sort by priority (highest first) and return the first one
-    candidates.sort((a, b) => b.binding.priority - a.binding.priority);
-    const { trait, binding } = candidates[0];
-    return {
-        interceptor: binding.interceptor,
-        trait,
-        binding
-    };
-}
-/**
- * Get the interceptor binding for a trait type and action.
- *
- * @param traitType - The trait type identifier
- * @param actionId - The action ID
- * @returns The binding, or undefined if not registered
- */
-function getInterceptorBinding(traitType, actionId) {
-    return interceptorRegistry.get(registryKey(traitType, actionId));
-}
-/**
- * Check if an interceptor is registered for a trait+action.
- *
- * @param traitType - The trait type identifier
- * @param actionId - The action ID
- */
-function hasActionInterceptor(traitType, actionId) {
-    return interceptorRegistry.has(registryKey(traitType, actionId));
-}
-/**
- * Unregister an interceptor (primarily for testing).
- *
- * @param traitType - The trait type identifier
- * @param actionId - The action ID
- */
-function unregisterActionInterceptor(traitType, actionId) {
-    interceptorRegistry.delete(registryKey(traitType, actionId));
-}
-/**
- * Clear all registered interceptors (for testing).
- */
-function clearInterceptorRegistry() {
-    interceptorRegistry.clear();
-}
-/**
- * Get all registered interceptor bindings (for debugging/introspection).
- */
-function getAllInterceptorBindings() {
-    return new Map(interceptorRegistry);
-}
-//# sourceMappingURL=interceptor-registry.js.map

package/capabilities/interceptor-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"interceptor-registry.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/capabilities/interceptor-registry.ts"],"names":[],"mappings":"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"}