feat: disable font preloading option in qwikVite (#7297)

Author: thejackshelton

packages/qwik/src/optimizer/src/plugins/vite.ts

@@ -69,6 +69,7 @@ export function qwikVite(qwikViteOpts: QwikVitePluginOptions = {}): any {
   const fileFilter: QwikVitePluginOptions['fileFilter'] = qwikViteOpts.fileFilter
     ? (id, type) => TRANSFORM_REGEX.test(id) || qwikViteOpts.fileFilter!(id, type)
     : () => true;
+  const disableFontPreload = qwikViteOpts.disableFontPreload ?? false;
   const injections: GlobalInjections[] = [];
   const qwikPlugin = createQwikPlugin(qwikViteOpts.optimizerOptions);
 
@@ -523,7 +524,7 @@ export function qwikVite(qwikViteOpts: QwikVitePluginOptions = {}): any {
                 }
               } else {
                 const selectedFont = FONTS.find((ext) => fileName.endsWith(ext));
-                if (selectedFont) {
+                if (selectedFont && !disableFontPreload) {
                   injections.unshift({
                     tag: 'link',
                     location: 'head',
@@ -930,6 +931,15 @@ interface QwikVitePluginCommonOptions {
    * to be stable between releases
    */
   experimental?: (keyof typeof ExperimentalFeatures)[];
+
+  /**
+   * Disables automatic preloading of font assets (WOFF/WOFF2/TTF) found in the build output. When
+   * enabled, the plugin will not add `<link rel="preload">` tags for font files in the document
+   * head.
+   *
+   * Disabling may impact Cumulative Layout Shift (CLS) metrics.
+   */
+  disableFontPreload?: boolean;
 }
 
 interface QwikVitePluginCSROptions extends QwikVitePluginCommonOptions {