Skip to content

📦 Search

Search strategy contracts for inventory slot queries.

This folder defines the abstraction used to search a set of inventory slots. It does not define a concrete search implementation or own container state.

🎯 Purpose

Provide a replaceable strategy seam for querying inventory slots.

🧩 What Lives Here

IInventorySearch

A strategy contract that accepts:

  • a read-only slot list
  • a query string

and returns:

  • an array of matching slot indices

This is the full public contract.

⚠️ Important Notes

  • This folder defines the search contract only
  • It does not implement search behaviour
  • It does not access container or service state

🧠 Usage Guidance

Index-based results

Search returns slot indices, not stacks or copied rows.

This keeps the contract lightweight and allows callers to re-read data as needed.

Container-agnostic

The strategy operates on a supplied slot list.

It does not resolve owners, containers, or services.

Replaceable seam

Projects that control the service instance may supply a custom implementation to change search behaviour.

🚫 Not for Production Use

This folder does not:

  • Define a default matching algorithm
  • Specify case sensitivity rules
  • Provide fuzzy or ranked search
  • Handle localisation
  • Guarantee caching or performance characteristics

These concerns belong to runtime implementations.