# PhoenixKitCatalogue v0.1.14 - API Reference

## Modules

- [PhoenixKitCatalogue](PhoenixKitCatalogue.md): Catalogue module for PhoenixKit.
- [PhoenixKitCatalogue.Attachments](PhoenixKitCatalogue.Attachments.md): Folder-scoped file attachments + featured image for catalogue
resources (items and catalogues share the exact same pattern).
- [PhoenixKitCatalogue.Catalogue](PhoenixKitCatalogue.Catalogue.md): Context module for managing catalogues, manufacturers, suppliers, categories, and items.
- [PhoenixKitCatalogue.Catalogue.Counts](PhoenixKitCatalogue.Catalogue.Counts.md): Catalogue-level item and category counts. Includes both per-uuid
helpers and single-query batch versions to avoid N+1 lookups when
rendering catalogue lists with associated item / category counts.
- [PhoenixKitCatalogue.Catalogue.Links](PhoenixKitCatalogue.Catalogue.Links.md): Manufacturer ↔ Supplier many-to-many links.
- [PhoenixKitCatalogue.Catalogue.Manufacturers](PhoenixKitCatalogue.Catalogue.Manufacturers.md): Manufacturers — company directory used as the source of items.
- [PhoenixKitCatalogue.Catalogue.PubSub](PhoenixKitCatalogue.Catalogue.PubSub.md): Real-time fan-out for catalogue mutations.
- [PhoenixKitCatalogue.Catalogue.Rules](PhoenixKitCatalogue.Catalogue.Rules.md): Smart-catalogue rules — one row per `(item, referenced_catalogue)` pair.
- [PhoenixKitCatalogue.Catalogue.Search](PhoenixKitCatalogue.Catalogue.Search.md): Item search — global, per-catalogue, and per-category, with optional
scope composition (`catalogue_uuids` AND `category_uuids`).
- [PhoenixKitCatalogue.Catalogue.Suppliers](PhoenixKitCatalogue.Catalogue.Suppliers.md): Suppliers — delivery companies linked to manufacturers via the
many-to-many `phoenix_kit_cat_manufacturer_suppliers` table.
- [PhoenixKitCatalogue.Catalogue.Translations](PhoenixKitCatalogue.Catalogue.Translations.md): Multilang `data` JSONB helpers — read merged language data from a
record and write language-specific overrides through the entity's own
update function.
- [PhoenixKitCatalogue.Errors](PhoenixKitCatalogue.Errors.md): Central mapping from error atoms (returned by `PhoenixKitCatalogue.Catalogue`
and the import pipeline) to translated, user-facing strings.
- [PhoenixKitCatalogue.Import.CommaParser](PhoenixKitCatalogue.Import.CommaParser.md)
- [PhoenixKitCatalogue.Import.Executor](PhoenixKitCatalogue.Import.Executor.md): Executes an import plan by creating categories and items.
- [PhoenixKitCatalogue.Import.Mapper](PhoenixKitCatalogue.Import.Mapper.md): Maps file columns to catalogue fields and transforms row data into
validated item attribute maps ready for insertion.

- [PhoenixKitCatalogue.Import.Parser](PhoenixKitCatalogue.Import.Parser.md): Parses XLSX and CSV files into structured row data.
- [PhoenixKitCatalogue.Import.SemicolonParser](PhoenixKitCatalogue.Import.SemicolonParser.md)
- [PhoenixKitCatalogue.Import.TabParser](PhoenixKitCatalogue.Import.TabParser.md)
- [PhoenixKitCatalogue.Metadata](PhoenixKitCatalogue.Metadata.md): Global, code-defined list of metadata fields that catalogue resources
(items and catalogues) can opt into.
- [PhoenixKitCatalogue.Paths](PhoenixKitCatalogue.Paths.md): Centralized path helpers for the Catalogue module.
- [PhoenixKitCatalogue.Schemas.Catalogue](PhoenixKitCatalogue.Schemas.Catalogue.md): Schema for catalogues — top-level groupings (e.g., Kitchen Furniture, Plumbing).
- [PhoenixKitCatalogue.Schemas.CatalogueRule](PhoenixKitCatalogue.Schemas.CatalogueRule.md): Smart-catalogue rule: one row per `(item, referenced_catalogue)` pair.
- [PhoenixKitCatalogue.Schemas.Category](PhoenixKitCatalogue.Schemas.Category.md): Schema for categories within a catalogue.
- [PhoenixKitCatalogue.Schemas.Item](PhoenixKitCatalogue.Schemas.Item.md): Schema for catalogue items — individual products/materials with SKU and pricing.
- [PhoenixKitCatalogue.Schemas.Manufacturer](PhoenixKitCatalogue.Schemas.Manufacturer.md): Schema for manufacturers.
- [PhoenixKitCatalogue.Schemas.ManufacturerSupplier](PhoenixKitCatalogue.Schemas.ManufacturerSupplier.md): Join table linking manufacturers to suppliers (many-to-many).
- [PhoenixKitCatalogue.Schemas.Supplier](PhoenixKitCatalogue.Schemas.Supplier.md): Schema for suppliers.
- [PhoenixKitCatalogue.Web.CatalogueDetailLive](PhoenixKitCatalogue.Web.CatalogueDetailLive.md): Detail view for a single catalogue, with infinite-scroll paging over
its categories and items.
- [PhoenixKitCatalogue.Web.CatalogueFormLive](PhoenixKitCatalogue.Web.CatalogueFormLive.md): Create/edit form for catalogues with multilang support.
- [PhoenixKitCatalogue.Web.CataloguesLive](PhoenixKitCatalogue.Web.CataloguesLive.md): Landing page for the Catalogue module.
- [PhoenixKitCatalogue.Web.CategoryFormLive](PhoenixKitCatalogue.Web.CategoryFormLive.md): Create/edit form for categories within a catalogue.
- [PhoenixKitCatalogue.Web.Components](PhoenixKitCatalogue.Web.Components.md): Reusable UI components for the Catalogue module.
- [PhoenixKitCatalogue.Web.Components.ItemPicker](PhoenixKitCatalogue.Web.Components.ItemPicker.md): Combobox LiveComponent for picking a single item from the catalogue
via server-side search.
- [PhoenixKitCatalogue.Web.EventsLive](PhoenixKitCatalogue.Web.EventsLive.md): LiveView for the catalogue activity events subtab.
- [PhoenixKitCatalogue.Web.Helpers](PhoenixKitCatalogue.Web.Helpers.md): Tiny utilities shared by every catalogue LiveView. Imported into LVs
via the standard `import PhoenixKitCatalogue.Web.Helpers` line.
- [PhoenixKitCatalogue.Web.ImportLive](PhoenixKitCatalogue.Web.ImportLive.md): Multi-step import wizard for catalogue items.
- [PhoenixKitCatalogue.Web.ItemFormLive](PhoenixKitCatalogue.Web.ItemFormLive.md): Create/edit form for catalogue items with multilang support.
- [PhoenixKitCatalogue.Web.ManufacturerFormLive](PhoenixKitCatalogue.Web.ManufacturerFormLive.md): Create/edit form for manufacturers with supplier linking.
- [PhoenixKitCatalogue.Web.SupplierFormLive](PhoenixKitCatalogue.Web.SupplierFormLive.md): Create/edit form for suppliers with manufacturer linking.