fix(falcon-PS9): prevent 500 error on AJAX filtering by normalizing data

Resolved a Fatal Error occurring during AJAX product listing requests (e.g., price slider).

- Issue: In PHP 8.2+, accessing properties of a 'CategoryLazyArray' object
  using array syntax (dot notation) triggers a Fatal Error.
- Cause: The Faceted Search module returns a LazyArray object during
  XHR requests, whereas standard page loads provide a native array.
- Solution: Implemented a normalization block using JSON serialization
  to flatten the object into a standard associative array. This ensures
  template syntax compatibility regardless of the request type or
  property visibility (protected vs public).

falcon/_dev/css/custom.scss

@@ -0,0 +1,19 @@
+// NOTE: All bootstrap overrides have been configured under the abstracts/variables/bootstrap folder.
+
+//Abstracts: Things used throughout the site such as utility classes and generic overrides.
+//@import "custom/abstracts/base";
+//@import "custom/abstracts/utilities";
+
+// Components: parts of the theme itself that are not associated with a module.
+//@import "custom/components/";
+
+// Modules: Styling for specific modules.
+//@import "custom/modules/";
+
+//Layouts: Parts of a page, such as the header, footer, etc.
+//@import "custom/layout/header";
+//@import "custom/layout/footer";
+
+// Pages
+//@import "custom/pages/category";
+//@import "custom/pages/product";

falcon/_dev/css/theme.scss

@@ -1,2 +1,3 @@
 @import "abstracts/index";
 @import "theme/index";
+@import "custom";

falcon/_dev/css/theme/_index.scss

@@ -5,3 +5,4 @@
 @import "layout/index";
 @import "components/index";
 
+@import "custom/custom";

falcon/_dev/css/theme/custom/_custom.scss

@@ -0,0 +1,22 @@
+/* This is the main custom SCSS file for the Falcon theme. 
+
+I am loosely following the 7 in 1 structure for better organization of the styles. Learn more here:
+https://medium.com/@diyorbekjuraev77/be-a-master-at-creating-the-7-1-sass-pattern-776fdfb5a3b1
+
+⚠️NOTE: All bootstrap overrides have been configured under themes/falcon/_dev/css/abstracts/variables/bootstrap */
+
+//Abstracts: Things used throughout the site such as utility classes and generic overrides.
+//@import "abstracts/mixins";
+
+// Components: parts of the theme itself that are not associated with a module.
+//@import "components/buttons";
+
+// Modules: Styling for specific modules.
+//@import "modules/";
+
+//Layouts: Parts of a page, such as the header, footer, etc.
+//@import "layout/footer";
+//@import "layout/header";
+
+// Pages
+//@import "pages/home";

falcon/_dev/js/theme/index.js

@@ -1,73 +1,97 @@
-import $ from 'jquery';
-import '@js/theme/vendors/bootstrap/bootstrap-imports';
-import 'bootstrap-touchspin';
-import 'jquery-hoverintent';
-import '@js/theme/components/dynamic-bootstrap-components';
-import bsCustomFileInput from 'bs-custom-file-input';
+import $ from "jquery";
+import "@js/theme/vendors/bootstrap/bootstrap-imports";
+import "bootstrap-touchspin";
+import "jquery-hoverintent";
+import "@js/theme/components/dynamic-bootstrap-components";
+import bsCustomFileInput from "bs-custom-file-input";
 
-import '@js/theme/components/selectors';
-import '@js/theme/components/sliders';
-import '@js/theme/components/responsive';
-import '@js/theme/components/customer';
-import '@js/theme/components/quickview';
-import '@js/theme/components/product';
-import '@js/theme/components/cart/cart';
-import '@js/theme/components/cart/block-cart';
+import "@js/theme/components/selectors";
+import "@js/theme/components/sliders";
+import "@js/theme/components/responsive";
+import "@js/theme/components/customer";
+import "@js/theme/components/quickview";
+import "@js/theme/components/product";
+import "@js/theme/components/cart/cart";
+import "@js/theme/components/cart/block-cart";
 
-import usePasswordPolicy from '@js/theme/components/usePasswordPolicy';
-import prestashop from 'prestashop';
-import EventEmitter from 'events';
-import Form from '@js/theme/components/form';
-import TopMenu from '@js/theme/components/TopMenu';
+import usePasswordPolicy from "@js/theme/components/usePasswordPolicy";
+import prestashop from "prestashop";
+import EventEmitter from "events";
+import Form from "@js/theme/components/form";
+import TopMenu from "@js/theme/components/TopMenu";
 
-import PageLazyLoad from '@js/theme/components/Lazyload';
-import PageLoader from '@js/theme/components/PageLoader';
-import useStickyElement from '@js/theme/components/useStickyElement';
+import PageLazyLoad from "@js/theme/components/Lazyload";
+import PageLoader from "@js/theme/components/PageLoader";
+import useStickyElement from "@js/theme/components/useStickyElement";
 
 /* eslint-disable */
 // "inherit" EventEmitter
 for (const i in EventEmitter.prototype) {
-  prestashop[i] = EventEmitter.prototype[i];
+    prestashop[i] = EventEmitter.prototype[i];
 }
 /* eslint-enable */
 
 prestashop.pageLazyLoad = new PageLazyLoad({
-  selector: '.lazyload',
+    selector: ".lazyload",
 });
 
 prestashop.pageLoader = new PageLoader();
 
 function accLinksTriggerActive() {
-  const url = window.location.pathname;
-  $('.js-customer-links a').each((i, el) => {
-    const $el = $(el);
+    const currentUrl = window.location.pathname + window.location.search;
 
-    if ($el.attr('href').indexOf(url) !== -1) {
-      $el.addClass('active');
-    }
-  });
+    $(".js-customer-links a").each((i, el) => {
+        const $el = $(el);
+        const linkHref = $el.attr("href");
+        let linkPath = linkHref;
+        try {
+            const linkUrl = new URL(linkHref, window.location.origin);
+            linkPath = linkUrl.pathname + linkUrl.search;
+        } catch (e) {}
+        if (
+            currentUrl === linkPath ||
+            (linkPath !== "/" && currentUrl.startsWith(linkPath))
+        ) {
+            $el.addClass("active");
+        }
+    });
 }
 
 function initStickyHeader() {
-  const header = document.querySelector('.js-header-top');
-  const headerWrapper = document.querySelector('.js-header-top-wrapper');
+    const header = document.querySelector(".js-header-top");
+    const headerWrapper = document.querySelector(".js-header-top-wrapper");
 
-  if (header && headerWrapper) {
-    useStickyElement(header, headerWrapper);
-  }
+    if (header && headerWrapper) {
+        useStickyElement(header, headerWrapper);
+    }
 }
 
 $(() => {
-  initStickyHeader();
-  accLinksTriggerActive();
-  Form.init();
-  bsCustomFileInput.init();
-  const topMenu = new TopMenu('#_desktop_top_menu .js-main-menu');
-  usePasswordPolicy('.field-password-policy');
+    initStickyHeader();
+    accLinksTriggerActive();
+    Form.init();
+    bsCustomFileInput.init();
+    const topMenu = new TopMenu("#_desktop_top_menu .js-main-menu");
+    usePasswordPolicy(".field-password-policy");
 
-  topMenu.init();
+    topMenu.init();
 
-  $('.js-select-link').on('change', ({ target }) => {
-    window.location.href = $(target).val();
-  });
+    $(".js-select-link").on("change", ({ target }) => {
+        window.location.href = $(target).val();
+    });
+
+    // Postcode input formatting
+    const $postCodeInput = $("input[name='postcode']");
+    $postCodeInput.on("input", function () {
+        let value = $(this).val();
+
+        // Match 4 digits followed by 2 letters (e.g., 1234AB)
+        const match = value.match(/^(\d{4})([a-zA-Z]{2})$/);
+
+        if (match) {
+            // Add space between numbers and letters
+            const formatted = `${match[1]} ${match[2]}`;
+            $(this).val(formatted);
+        }
+    });
 });

falcon/modules/ps_facetedsearch/views/templates/front/catalog/facets.tpl

@@ -75,7 +75,7 @@
                           type="{if $facet.multipleSelectionAllowed}checkbox{else}radio{/if}" class="custom-control-input"
                           {if $filter.active } checked{/if}>
                         <label for="facet_input_{$_expand_id}_{$filter_key}" {if isset($filter.properties.color)}
-                            class="custom-control-label custom-control-label-{if Tools::getBrightness($filter.properties.color) > 128}dark{else}bright{/if}"
+                            class="custom-control-label custom-control-label-{if $filter.properties.color|is_bright}dark{else}bright{/if}"
                           {else} class="custom-control-label"
                           {/if}>
                           {if isset($filter.properties.color)}

falcon/templates/catalog/_partials/category-footer.tpl

@@ -1,5 +1,13 @@
+{* Defensive: Handles LazyArray objects for category *}
+{if is_object($category)}
+  {$category = $category|json_encode|json_decode:true}
+  {if isset($category.category)}
+    {$category = $category.category}
+  {/if}
+{/if}
+
 <div id="js-product-list-footer">
-    {if $category.additional_description && $listing.pagination.items_shown_from == 1}
+    {if isset($category.additional_description) && $category.additional_description && $listing.pagination.items_shown_from == 1}
       <div id="category-description-2" class="cms-content my-3">
         {$category.additional_description nofilter}
       </div>

falcon/templates/catalog/_partials/product-variants.tpl

@@ -45,7 +45,7 @@
               <div class="custom-control custom-radio-color">
                   <input class="custom-control-input" type="radio" data-product-attribute="{$id_attribute_group}" id="{$id_attribute_group}_{$id_attribute}"  name="group[{$id_attribute_group}]" value="{$id_attribute}" title="{$group_attribute.name}"{if $group_attribute.selected} checked="checked"{/if}>
 
-                  <label class="custom-control-label {if $group_attribute.html_color_code}custom-control-label-{if Tools::getBrightness($group_attribute.html_color_code) > 128}dark{else}bright{/if}{/if}" for="{$id_attribute_group}_{$id_attribute}" aria-label="{$group_attribute.name}">
+                <label class="custom-control-label {if $group_attribute.html_color_code}custom-control-label-{if $group_attribute.html_color_code|is_bright}dark{else}bright{/if}{/if}" for="{$id_attribute_group}_{$id_attribute}" aria-label="{$group_attribute.name}">
                     <span
                       {if $group_attribute.texture}
                         class="custom-control-input-color" style="background-image: url({$group_attribute.texture})"

falcon/templates/customer/history.tpl

@@ -60,7 +60,7 @@
             <td class="hidden-md-down align-middle">{$order.details.payment}</td>
             <td class="align-middle">
               <span
-                class="label label-pill badge {if Tools::getBrightness($order.history.current.color) < 128}text-white{/if}"
+                class="label label-pill badge {if !$order.history.current.color|is_bright}text-white{/if}"
                 style="background-color:{$order.history.current.color}"
               >
                 {$order.history.current.ostate_name}

falcon/templates/customer/order-detail.tpl

@@ -89,7 +89,7 @@
                 <td>{$state.history_date}</td>
                 <td>
                   <span
-                    class="label label-pill badge {if Tools::getBrightness($state.color) < 128}text-white{/if}"
+                    class="label label-pill badge {if !$state.color|is_bright}text-white{/if}"
                     style="background-color:{$state.color}">
                     {$state.ostate_name}
                   </span>