Feature: Updating Product Service to handle multiple locales, fetching the correct locale, or, the default locale as fallback

src/Catalog/ProductOptionTypeInterface.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Modules\Core\Catalog;
+
+use Filament\Forms\Components\Component;
+
+/**
+ * A Product Option Type describes how a category of Lunar `ProductOption` (e.g.
+ * "Color", "Size", "Material") behaves — namely, what structured data its values
+ * carry in their free-form `meta` jsonb column, and how an admin edits that data.
+ *
+ * `ProductOption`/`ProductOptionValue` themselves stay exactly as Lunar defines
+ * them — this is not a new model, just a registry (ProductOptionTypeRegistry) that
+ * maps a `ProductOption::handle` to the type describing it, so adding a new kind of
+ * option (a new color-like or size-like concept) is a single new class, not scattered
+ * per-option special-casing across the admin UI or storefront.
+ */
+interface ProductOptionTypeInterface
+{
+    /**
+     * Matches the ProductOption::handle this type describes (e.g. 'color', 'size').
+     */
+    public static function getKey(): string;
+
+    /**
+     * Filament form components for editing a ProductOptionValue's `meta` under this
+     * option type — e.g. Color returns a color picker for `meta.hex`, Size returns a
+     * numeric input for `meta.sort_value`. Field names should be dot-notation under
+     * `meta` (e.g. `meta.hex`), matching where ValuesRelationManager's form saves them.
+     *
+     * @return array<Component>
+     */
+    public function getMetaForm(): array;
+}

src/Catalog/ProductService.php

@@ -6,7 +6,7 @@ use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\App;
 use Lunar\Models\Product;
-use Modules\Core\Localization\LocaleMiddleware;
+use Modules\Core\Localization\Services\LanguageCache;
 
 /**
  * Storefront product listing/filtering AND single-product lookup, all reading directly
@@ -19,6 +19,8 @@ use Modules\Core\Localization\LocaleMiddleware;
  */
 class ProductService
 {
+    public function __construct(private readonly LanguageCache $languages) {}
+
     /**
      * @return array{data: array<int, array>, meta: array}
      */
@@ -80,10 +82,14 @@ class ProductService
     /**
      * Resolves the current-locale `name`/`description` from the indexer's
      * per-locale `name_{locale}`/`description_{locale}` fields, falling back to
-     * the store's default language (Language::default, see
-     * LocaleMiddleware::defaultLocale()) when the current locale has no
-     * translation - e.g. a product with no English copy yet still shows its
-     * Greek name/description on /en/ rather than rendering blank.
+     * the store's default language (LanguageCache::defaultLocale()) when the
+     * current locale has no translation - e.g. a product with no English copy
+     * yet still shows its Greek name/description on /en/ rather than rendering
+     * blank. The raw per-locale keys are then stripped - every configured
+     * locale's translation is indexed in Meilisearch (Lunar's base indexer
+     * explodes every TranslatedText attribute into name_{locale}/
+     * description_{locale} per store language), but once resolved into `name`/
+     * `description`, callers only ever need the one that matched.
      *
      * Deliberately not config('app.locale') - App::setLocale() overwrites that
      * config value on every request, so by request time it's just whatever the
@@ -92,11 +98,15 @@ class ProductService
     private function withLocalizedFields(array $product): array
     {
         $locale = App::getLocale();
-        $fallbackLocale = LocaleMiddleware::defaultLocale();
+        $fallbackLocale = $this->languages->defaultLocale();
 
         $product['name'] = $product['name_'.$locale] ?? $product['name_'.$fallbackLocale] ?? null;
         $product['description'] = $product['description_'.$locale] ?? $product['description_'.$fallbackLocale] ?? null;
 
+        foreach ($this->languages->availableLocales() as $availableLocale) {
+            unset($product['name_'.$availableLocale], $product['description_'.$availableLocale]);
+        }
+
         return $product;
     }