@sharpee/world-model 0.9.60-beta

package/dist/capabilities/capability-defaults.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Capability Defaults (ADR-090 Extension)
+ *
+ * Global configuration for how capabilities are resolved when multiple
+ * entities claim the same capability. Stories can override per-registration.
+ */
+/**
+ * Resolution strategy when multiple entities claim the same capability.
+ */
+export type CapabilityResolution = 'first-wins' | 'any-blocks' | 'all-must-pass' | 'highest-priority';
+/**
+ * How the capability validation result affects the action.
+ */
+export type CapabilityMode = 'blocking' | 'advisory' | 'chain';
+/**
+ * Configuration for a capability.
+ */
+export interface CapabilityConfig {
+    /** How to resolve multiple entities claiming this capability */
+    resolution: CapabilityResolution;
+    /** How validation result affects the action */
+    mode: CapabilityMode;
+}
+/**
+ * Define default configuration for a capability.
+ *
+ * Called during platform or story initialization to set how a capability
+ * should behave when multiple entities claim it.
+ *
+ * @param capabilityId - The capability ID (e.g., 'if.scope.visible', 'if.action.taking')
+ * @param config - Partial config, missing values use defaults
+ *
+ * @example
+ * ```typescript
+ * // Visibility should block if ANY entity says it's hidden
+ * defineCapabilityDefaults('if.scope.visible', {
+ *   resolution: 'any-blocks',
+ *   mode: 'blocking'
+ * });
+ * ```
+ */
+export declare function defineCapabilityDefaults(capabilityId: string, config: Partial<CapabilityConfig>): void;
+/**
+ * Get configuration for a capability.
+ *
+ * Returns the registered config or defaults if not registered.
+ *
+ * @param capabilityId - The capability ID
+ * @returns The capability configuration
+ */
+export declare function getCapabilityConfig(capabilityId: string): CapabilityConfig;
+/**
+ * Check if a capability has explicit defaults defined.
+ *
+ * @param capabilityId - The capability ID
+ * @returns true if defaults have been defined
+ */
+export declare function hasCapabilityDefaults(capabilityId: string): boolean;
+/**
+ * Clear all capability defaults (for testing).
+ */
+export declare function clearCapabilityDefaults(): void;
+/**
+ * Get all defined capability defaults (for debugging/introspection).
+ */
+export declare function getAllCapabilityDefaults(): Map<string, CapabilityConfig>;
+//# sourceMappingURL=capability-defaults.d.ts.map

package/dist/capabilities/capability-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-defaults.d.ts","sourceRoot":"","sources":["../../src/capabilities/capability-defaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,YAAY,GACZ,YAAY,GACZ,eAAe,GACf,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,UAAU,GACV,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,UAAU,EAAE,oBAAoB,CAAC;IACjC,+CAA+C;IAC/C,IAAI,EAAE,cAAc,CAAC;CACtB;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAChC,IAAI,CAKN;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAExE"}

package/dist/capabilities/capability-defaults.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Capability Defaults (ADR-090 Extension)
+ *
+ * Global configuration for how capabilities are resolved when multiple
+ * entities claim the same capability. Stories can override per-registration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineCapabilityDefaults = defineCapabilityDefaults;
+exports.getCapabilityConfig = getCapabilityConfig;
+exports.hasCapabilityDefaults = hasCapabilityDefaults;
+exports.clearCapabilityDefaults = clearCapabilityDefaults;
+exports.getAllCapabilityDefaults = getAllCapabilityDefaults;
+/**
+ * Default configuration used when no specific config is defined.
+ */
+const DEFAULT_CONFIG = {
+    resolution: 'first-wins',
+    mode: 'blocking'
+};
+/**
+ * Registry of capability configurations.
+ */
+const capabilityDefaults = new Map();
+/**
+ * Define default configuration for a capability.
+ *
+ * Called during platform or story initialization to set how a capability
+ * should behave when multiple entities claim it.
+ *
+ * @param capabilityId - The capability ID (e.g., 'if.scope.visible', 'if.action.taking')
+ * @param config - Partial config, missing values use defaults
+ *
+ * @example
+ * ```typescript
+ * // Visibility should block if ANY entity says it's hidden
+ * defineCapabilityDefaults('if.scope.visible', {
+ *   resolution: 'any-blocks',
+ *   mode: 'blocking'
+ * });
+ * ```
+ */
+function defineCapabilityDefaults(capabilityId, config) {
+    capabilityDefaults.set(capabilityId, {
+        resolution: config.resolution ?? DEFAULT_CONFIG.resolution,
+        mode: config.mode ?? DEFAULT_CONFIG.mode
+    });
+}
+/**
+ * Get configuration for a capability.
+ *
+ * Returns the registered config or defaults if not registered.
+ *
+ * @param capabilityId - The capability ID
+ * @returns The capability configuration
+ */
+function getCapabilityConfig(capabilityId) {
+    return capabilityDefaults.get(capabilityId) ?? { ...DEFAULT_CONFIG };
+}
+/**
+ * Check if a capability has explicit defaults defined.
+ *
+ * @param capabilityId - The capability ID
+ * @returns true if defaults have been defined
+ */
+function hasCapabilityDefaults(capabilityId) {
+    return capabilityDefaults.has(capabilityId);
+}
+/**
+ * Clear all capability defaults (for testing).
+ */
+function clearCapabilityDefaults() {
+    capabilityDefaults.clear();
+}
+/**
+ * Get all defined capability defaults (for debugging/introspection).
+ */
+function getAllCapabilityDefaults() {
+    return new Map(capabilityDefaults);
+}
+//# sourceMappingURL=capability-defaults.js.map

package/dist/capabilities/capability-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-defaults.js","sourceRoot":"","sources":["../../src/capabilities/capability-defaults.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA4DH,4DAQC;AAUD,kDAEC;AAQD,sDAEC;AAKD,0DAEC;AAKD,4DAEC;AA3ED;;GAEG;AACH,MAAM,cAAc,GAAqB;IACvC,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,UAAU;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAA4B,CAAC;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,wBAAwB,CACtC,YAAoB,EACpB,MAAiC;IAEjC,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE;QACnC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU;QAC1D,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,cAAc,CAAC,IAAI;KACzC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CAAC,YAAoB;IACtD,OAAO,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,cAAc,EAAE,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,YAAoB;IACxD,OAAO,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB;IACrC,kBAAkB,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB;IACtC,OAAO,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;AACrC,CAAC"}

package/dist/capabilities/capability-helpers.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Capability Helpers (ADR-090)
+ *
+ * Helper functions for working with trait capabilities.
+ * Used by capability-dispatch actions to find and check capabilities.
+ */
+import { ITrait } from '../traits/trait';
+import { IFEntity } from '../entities';
+/**
+ * Find a trait on the entity that declares the given capability.
+ *
+ * Entity resolution (which entity "lower X" refers to) is handled
+ * by the parser using scope math. Once resolved to a specific entity,
+ * this function finds the trait that handles the action.
+ *
+ * @param entity - The entity to search
+ * @param actionId - The action ID (capability) to find
+ * @returns The trait that claims the capability, or undefined
+ *
+ * @example
+ * ```typescript
+ * const trait = findTraitWithCapability(basket, 'if.action.lowering');
+ * if (trait) {
+ *   const behavior = getBehaviorForCapability(trait, 'if.action.lowering');
+ *   // ... dispatch to behavior
+ * }
+ * ```
+ */
+export declare function findTraitWithCapability(entity: IFEntity, actionId: string): ITrait | undefined;
+/**
+ * Check if an entity has any trait claiming a capability.
+ *
+ * @param entity - The entity to check
+ * @param actionId - The action ID (capability) to check for
+ * @returns True if entity has a trait with this capability
+ *
+ * @example
+ * ```typescript
+ * if (hasCapability(entity, 'if.action.lowering')) {
+ *   // Entity can be lowered
+ * }
+ * ```
+ */
+export declare function hasCapability(entity: IFEntity, actionId: string): boolean;
+/**
+ * Get all capabilities declared by an entity's traits.
+ *
+ * @param entity - The entity to inspect
+ * @returns Array of action IDs the entity can handle
+ */
+export declare function getEntityCapabilities(entity: IFEntity): string[];
+/**
+ * Type guard to check if a trait has a specific capability.
+ *
+ * @param trait - The trait to check
+ * @param actionId - The action ID to check for
+ * @param traitType - Optional: specific trait class to narrow to
+ * @returns True if trait has the capability (and is of specified type)
+ *
+ * @example
+ * ```typescript
+ * if (traitHasCapability(trait, 'if.action.lowering', BasketElevatorTrait)) {
+ *   // trait is narrowed to BasketElevatorTrait
+ *   console.log(trait.position);
+ * }
+ * ```
+ */
+export declare function traitHasCapability<T extends ITrait>(trait: ITrait, actionId: string, traitType?: new (...args: any[]) => T): trait is T;
+/**
+ * Find all traits on an entity that have capabilities.
+ *
+ * @param entity - The entity to inspect
+ * @returns Array of traits that declare at least one capability
+ */
+export declare function getCapableTraits(entity: IFEntity): ITrait[];
+//# sourceMappingURL=capability-helpers.d.ts.map

package/dist/capabilities/capability-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-helpers.d.ts","sourceRoot":"","sources":["../../src/capabilities/capability-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAqB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAQpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAWhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACpC,KAAK,IAAI,CAAC,CAQZ;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAK3D"}

package/dist/capabilities/capability-helpers.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Capability Helpers (ADR-090)
+ *
+ * Helper functions for working with trait capabilities.
+ * Used by capability-dispatch actions to find and check capabilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findTraitWithCapability = findTraitWithCapability;
+exports.hasCapability = hasCapability;
+exports.getEntityCapabilities = getEntityCapabilities;
+exports.traitHasCapability = traitHasCapability;
+exports.getCapableTraits = getCapableTraits;
+/**
+ * Find a trait on the entity that declares the given capability.
+ *
+ * Entity resolution (which entity "lower X" refers to) is handled
+ * by the parser using scope math. Once resolved to a specific entity,
+ * this function finds the trait that handles the action.
+ *
+ * @param entity - The entity to search
+ * @param actionId - The action ID (capability) to find
+ * @returns The trait that claims the capability, or undefined
+ *
+ * @example
+ * ```typescript
+ * const trait = findTraitWithCapability(basket, 'if.action.lowering');
+ * if (trait) {
+ *   const behavior = getBehaviorForCapability(trait, 'if.action.lowering');
+ *   // ... dispatch to behavior
+ * }
+ * ```
+ */
+function findTraitWithCapability(entity, actionId) {
+    for (const trait of entity.traits.values()) {
+        const traitClass = trait.constructor;
+        if (traitClass.capabilities?.includes(actionId)) {
+            return trait;
+        }
+    }
+    return undefined;
+}
+/**
+ * Check if an entity has any trait claiming a capability.
+ *
+ * @param entity - The entity to check
+ * @param actionId - The action ID (capability) to check for
+ * @returns True if entity has a trait with this capability
+ *
+ * @example
+ * ```typescript
+ * if (hasCapability(entity, 'if.action.lowering')) {
+ *   // Entity can be lowered
+ * }
+ * ```
+ */
+function hasCapability(entity, actionId) {
+    return findTraitWithCapability(entity, actionId) !== undefined;
+}
+/**
+ * Get all capabilities declared by an entity's traits.
+ *
+ * @param entity - The entity to inspect
+ * @returns Array of action IDs the entity can handle
+ */
+function getEntityCapabilities(entity) {
+    const capabilities = [];
+    for (const trait of entity.traits.values()) {
+        const traitClass = trait.constructor;
+        if (traitClass.capabilities) {
+            capabilities.push(...traitClass.capabilities);
+        }
+    }
+    return capabilities;
+}
+/**
+ * Type guard to check if a trait has a specific capability.
+ *
+ * @param trait - The trait to check
+ * @param actionId - The action ID to check for
+ * @param traitType - Optional: specific trait class to narrow to
+ * @returns True if trait has the capability (and is of specified type)
+ *
+ * @example
+ * ```typescript
+ * if (traitHasCapability(trait, 'if.action.lowering', BasketElevatorTrait)) {
+ *   // trait is narrowed to BasketElevatorTrait
+ *   console.log(trait.position);
+ * }
+ * ```
+ */
+function traitHasCapability(trait, actionId, traitType) {
+    const traitClass = trait.constructor;
+    const hasAction = traitClass.capabilities?.includes(actionId) ?? false;
+    if (traitType) {
+        return hasAction && trait instanceof traitType;
+    }
+    return hasAction;
+}
+/**
+ * Find all traits on an entity that have capabilities.
+ *
+ * @param entity - The entity to inspect
+ * @returns Array of traits that declare at least one capability
+ */
+function getCapableTraits(entity) {
+    return Array.from(entity.traits.values()).filter(trait => {
+        const traitClass = trait.constructor;
+        return traitClass.capabilities && traitClass.capabilities.length > 0;
+    });
+}
+//# sourceMappingURL=capability-helpers.js.map

package/dist/capabilities/capability-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-helpers.js","sourceRoot":"","sources":["../../src/capabilities/capability-helpers.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAyBH,0DAWC;AAgBD,sCAEC;AAQD,sDAWC;AAkBD,gDAYC;AAQD,4CAKC;AA/GD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,uBAAuB,CACrC,MAAgB,EAChB,QAAgB;IAEhB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAgC,CAAC;QAC1D,IAAI,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,aAAa,CAAC,MAAgB,EAAE,QAAgB;IAC9D,OAAO,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,SAAS,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,MAAgB;IACpD,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAgC,CAAC;QAC1D,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;YAC5B,YAAY,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,kBAAkB,CAChC,KAAa,EACb,QAAgB,EAChB,SAAqC;IAErC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAgC,CAAC;IAC1D,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;IAEvE,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,IAAI,KAAK,YAAY,SAAS,CAAC;IACjD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,MAAgB;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QACvD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAgC,CAAC;QAC1D,OAAO,UAAU,CAAC,YAAY,IAAI,UAAU,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,115 @@
+/**
+ * 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/dist/capabilities/capability-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-registry.d.ts","sourceRoot":"","sources":["../../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;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;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/dist/capabilities/capability-registry.js

@@ -0,0 +1,136 @@
+"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}`
+ */
+const behaviorRegistry = new Map();
+/**
+ * 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(behaviorRegistry);
+}
+//# sourceMappingURL=capability-registry.js.map

package/dist/capabilities/capability-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-registry.js","sourceRoot":"","sources":["../../src/capabilities/capability-registry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAiFH,gEAuBC;AAWD,4DAMC;AAYD,gDAoBC;AAQD,sDAEC;AAQD,oEAEC;AAKD,0DAEC;AAKD,4DAEC;AAnJD;;GAEG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAgC,CAAC;AAEjE;;GAEG;AACH,SAAS,WAAW,CAAC,SAAiB,EAAE,UAAkB;IACxD,OAAO,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAgB,0BAA0B,CACxC,SAAiB,EACjB,UAAkB,EAClB,QAA4B,EAC5B,OAAwC;IAExC,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAE/C,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,0CAA0C,SAAS,qBAAqB,UAAU,GAAG,CACtF,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE;QACxB,SAAS;QACT,UAAU;QACV,QAAQ;QACR,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC;QAChC,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,IAAI,EAAE,OAAO,EAAE,IAAI;QACnB,eAAe,EAAE,OAAO,EAAE,eAA2D;KACtF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,wBAAwB,CACtC,KAAa,EACb,UAAkB;IAElB,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACtD,OAAO,OAAO,EAAE,QAAQ,CAAC;AAC3B,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAChC,KAAa,EACb,UAAkB;IAElB,MAAM,SAAS,GAAI,KAAK,CAAC,WAAiC,CAAC,IAAI,CAAC;IAChE,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,iCAAiC;IACjC,IAAI,OAAO,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CACb,yCAAyC,SAAS,kBAAkB,UAAU,GAAG,CAClF,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,SAAiB,EAAE,UAAkB;IACzE,OAAO,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,4BAA4B,CAAC,SAAiB,EAAE,UAAkB;IAChF,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB;IACrC,gBAAgB,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB;IACtC,OAAO,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACnC,CAAC"}