blender-asset-source

Search discoverable asset sources and return validated AssetDescriptor[] for the downstream import pipeline.

Supports:

• Filesystem search — walk a local directory for supported 3D file formats.
• Blender asset library search — scan registered Blender asset libraries.
• Type filtering — restrict results to specific formats (blend, fbx, obj, usd, etc.).
• Name matching — case-insensitive substring filter on asset names.

Library registrations come from bpy.context.preferences.filepaths.asset_libraries. Search is read-only: it does not refresh Asset Browser UI or save preferences. context.asset_library_status distinguishes scanned, no_libraries, unavailable, partial, and error; missing APIs or unreadable libraries are not empty successful library searches. Broken registrations do not hide later valid libraries: partial results include explicit status and warnings. With source=all, filesystem results can be returned with a library warning. Reaching the result budget may truncate search.