ultimate-jekyll-manager 1.9.7 → 1.9.9

package/CLAUDE.md

@@ -193,6 +193,7 @@ All `npm install` calls in CLI commands (`npx mgr i`, `npx mgr setup`) route thr
 - **No backwards compatibility** unless explicitly requested.
 - **Don't add `?.` paranoia.** Framework internals (`manager.config`, `manager.webManager`) deref directly. `?.` belongs only on user-supplied config sub-fields, optional return values from regex matches, caught exceptions, and pre-init state.
 - **Use `process.cwd()` (not hardcoded paths) for consumer-project resolution** in gulp tasks + commands. UJM runs inside the consumer's working directory.
+- **All `<img src>` tags MUST have a cachebreaker** — append `?cb={{ site.uj.cache_breaker }}` to image `src` attributes in includes and layouts. This applies to logos, brandmarks, rating images, and any other image rendered via Liquid variables. External third-party URLs (YouTube embeds, analytics pixels, placeholder services) are exempt. `data-lazy="@src"` is handled at the JS layer, not here. See [docs/common-mistakes.md](docs/common-mistakes.md).
 
 ## Doc-update parity
 

package/dist/defaults/dist/_includes/themes/classy/backend/sections/sidebar.html

@@ -10,7 +10,7 @@
     <a href="{{ logo_href }}" class="d-flex align-items-center text-decoration-none text-body">
       {% iftruthy logo_src %}
         <div class="avatar avatar-md me-2 {{ logo_class }}">
-          <img src="{{ logo_src }}" alt="{{ logo_text }} Logo"/>
+          <img src="{{ logo_src }}?cb={{ site.uj.cache_breaker }}" alt="{{ logo_text }} Logo"/>
         </div>
       {% endiftruthy %}
       {% iftruthy logo_text %}
@@ -186,7 +186,7 @@
     <h5 class="offcanvas-title d-flex align-items-center" id="mobileSidebarLabel">
       {% iftruthy logo_src %}
         <div class="avatar avatar-md me-2">
-          <img src="{{ logo_src }}" alt="{{ logo_text }} Logo"/>
+          <img src="{{ logo_src }}?cb={{ site.uj.cache_breaker }}" alt="{{ logo_text }} Logo"/>
         </div>
       {% endiftruthy %}
       {% iftruthy logo_text %}

package/dist/defaults/dist/_includes/themes/classy/frontend/sections/nav.html

@@ -9,10 +9,10 @@
     <a class="navbar-brand d-inline-flex align-items-center py-0" href="{{ logo_href }}">
       {% iftruthy logo_src %}
         {% if data.logo.type == 'wordmark' %}
-          <img src="{{ logo_src }}" alt="{{ logo_text }} Logo" class="{{ logo_class }}" style="height: 2rem; width: auto;"/>
+          <img src="{{ logo_src }}?cb={{ site.uj.cache_breaker }}" alt="{{ logo_text }} Logo" class="{{ logo_class }}" style="height: 2rem; width: auto;"/>
         {% else %}
           <div class="avatar avatar-md me-2 {{ logo_class }}">
-            <img src="{{ logo_src }}" alt="{{ logo_text }} Logo"/>
+            <img src="{{ logo_src }}?cb={{ site.uj.cache_breaker }}" alt="{{ logo_text }} Logo"/>
           </div>
         {% endif %}
       {% endiftruthy %}

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/auth/reset.html

@@ -33,7 +33,7 @@ layout: themes/[ site.theme.id ]/frontend/core/cover
           <input type="email" class="form-control form-control-md" id="email" name="email" placeholder="Enter your email" autocomplete="email" autofocus required>
         </div>
 
-        <button type="submit" class="btn btn-success _btn-lg w-100 mb-4" data-provider="email" disabled>
+        <button type="submit" class="btn btn-success _btn-lg w-100 mb-4" data-provider="email">
           {{ initializing_spinner }}
           {% uj_icon "paper-plane", "me-2" %}
           <span class="button-text">Send reset link</span>

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/auth/signin.html

@@ -47,7 +47,7 @@ social_signin:
         <!-- Social Login (Optional) -->
         <div class="mb-4">
           {% for provider in page.resolved.social_signin %}
-            <button type="submit" class="btn btn-adaptive _btn-lg w-100 mb-3 d-flex align-items-center justify-content-center" data-provider="{{ provider.id }}" disabled>
+            <button type="submit" class="btn btn-adaptive _btn-lg w-100 mb-3 d-flex align-items-center justify-content-center" data-provider="{{ provider.id }}">
               {{ initializing_spinner }}
               <span class="avatar avatar-xs me-2">
                 <img src="{{ provider.logo }}?cb={{ site.uj.cache_breaker }}" class="object-fit-contain" alt="{{ provider.name }} Logo"/>
@@ -84,7 +84,7 @@ social_signin:
 
         </div>
 
-        <button type="submit" class="btn btn-success _btn-lg w-100 mb-2" data-provider="email" disabled>
+        <button type="submit" class="btn btn-success _btn-lg w-100 mb-2" data-provider="email">
           {{ initializing_spinner }}
           {% uj_icon "arrow-right-to-bracket", "me-2" %}
           <span class="button-text">Sign in</span>

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/auth/signup.html

@@ -47,7 +47,7 @@ social_signup:
         <!-- Social Signup (Optional) -->
         <div class="mb-4">
           {% for provider in page.resolved.social_signup %}
-            <button type="submit" class="btn btn-adaptive _btn-lg w-100 mb-3 d-flex align-items-center justify-content-center" data-provider="{{ provider.id }}" disabled>
+            <button type="submit" class="btn btn-adaptive _btn-lg w-100 mb-3 d-flex align-items-center justify-content-center" data-provider="{{ provider.id }}">
               {{ initializing_spinner }}
               <span class="avatar avatar-xs me-2">
                 <img src="{{ provider.logo }}?cb={{ site.uj.cache_breaker }}" class="object-fit-contain" alt="{{ provider.name }} Logo"/>
@@ -114,7 +114,7 @@ social_signup:
           <div id="consent-error" class="small mt-2 d-none" style="color: var(--bs-form-invalid-color, var(--bs-danger, #dc3545));"></div>
         </div>
 
-        <button type="submit" class="btn btn-success _btn-lg w-100 mb-3" data-provider="email" disabled>
+        <button type="submit" class="btn btn-success _btn-lg w-100 mb-3" data-provider="email">
           {{ initializing_spinner }}
           {% uj_icon "user-plus", "me-2" %}
           <span class="button-text">Create account</span>

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/feedback.html

@@ -92,7 +92,7 @@ prerender_icons:
                   {% for rating in page.resolved.feedback_form.ratings %}
                     <div class="col-6 col-sm-3">
                       <button type="button" class="feedback-rating-btn w-100 border rounded-3 bg-body text-center" data-rating="{{ rating.id }}">
-                        <img src="{{ rating.image }}" alt="{{ rating.label }}" class="feedback-rating-img mb-2" width="64" height="64" loading="eager">
+                        <img src="{{ rating.image }}?cb={{ site.uj.cache_breaker }}" alt="{{ rating.label }}" class="feedback-rating-img mb-2" width="64" height="64" loading="eager">
                         <span class="d-block small fw-semibold text-muted">{{ rating.label }}</span>
                       </button>
                     </div>

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/index.html

@@ -236,7 +236,7 @@ cta:
             autofocus
           >
           {% assign demo_btn_class = demo.options.button.class | default: "btn-adaptive-inverse" %}
-          <button type="submit" class="btn {{ demo_btn_class }} btn-lg text-nowrap flex-shrink-0" disabled>
+          <button type="submit" class="btn {{ demo_btn_class }} btn-lg text-nowrap flex-shrink-0">
             {% iftruthy demo.options.button.icon %}
               {% uj_icon demo.options.button.icon, "me-2" %}
             {% endiftruthy %}
@@ -305,7 +305,7 @@ cta:
           {% endfor %}
           {% assign form_btn_class = demo.options.button.class | default: "btn-adaptive-inverse" %}
           <div class="col-12 {% if demo.options.button.full_width != true %}col-sm-auto{% endif %}">
-            <button type="submit" class="btn {{ form_btn_class }} btn-lg w-100 h-100" disabled>
+            <button type="submit" class="btn {{ form_btn_class }} btn-lg w-100 h-100">
               {% iftruthy demo.options.button.icon %}
                 {% uj_icon demo.options.button.icon, "me-2" %}
               {% endiftruthy %}

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/portal/email-preferences.html

@@ -87,7 +87,7 @@ prerender_icons:
             <input type="text" class="form-control" name="honey" tabindex="-1" autocomplete="off">
           </div>
 
-          <button type="submit" class="btn btn-danger w-100 mb-4" id="email-preferences-submit" disabled>
+          <button type="submit" class="btn btn-danger w-100 mb-4" id="email-preferences-submit">
             <span class="button-text">Unsubscribe</span>
           </button>
         </form>

package/dist/defaults/dist/pages/test/libraries/form-manager.html

@@ -95,8 +95,8 @@ meta:
               </div>
             </div>
             <div class="d-flex gap-2">
-              <button type="submit" data-action="save" class="btn btn-primary" disabled>Save</button>
-              <button type="submit" data-action="draft" class="btn btn-outline-secondary" disabled>Save as Draft</button>
+              <button type="submit" data-action="save" class="btn btn-primary">Save</button>
+              <button type="submit" data-action="draft" class="btn btn-outline-secondary">Save as Draft</button>
               <button type="button" id="main-set-data" class="btn btn-outline-info">Set data</button>
             </div>
           </form>
@@ -139,7 +139,7 @@ meta:
               <input type="checkbox" class="form-check-input" id="validation-terms" name="terms" required>
               <label class="form-check-label" for="validation-terms">I agree to the terms (required)</label>
             </div>
-            <button type="submit" class="btn btn-primary" disabled>Submit</button>
+            <button type="submit" class="btn btn-primary">Submit</button>
           </form>
           <div class="mt-2">
             <small class="text-muted" id="validation-status">Status: ready</small>
@@ -161,7 +161,7 @@ meta:
               <label for="contact-message" class="form-label">Message</label>
               <textarea class="form-control" id="contact-message" name="message" rows="2">Hello!</textarea>
             </div>
-            <button type="submit" class="btn btn-primary" disabled>Send message</button>
+            <button type="submit" class="btn btn-primary">Send message</button>
           </form>
           <div class="mt-2">
             <small class="text-muted" id="contact-status">Status: ready</small>
@@ -183,7 +183,7 @@ meta:
               <label for="manual-data" class="form-label">Data</label>
               <input type="text" class="form-control" id="manual-data" name="data">
             </div>
-            <button type="submit" class="btn btn-primary" disabled>Submit</button>
+            <button type="submit" class="btn btn-primary">Submit</button>
           </form>
           <div class="mt-2">
             <small class="text-muted" id="manual-status">Status: initializing</small>
@@ -251,7 +251,7 @@ meta:
               <button type="button" class="btn btn-outline-primary btn-sm groups-filter-btn" data-group="a">Group A</button>
               <button type="button" class="btn btn-outline-success btn-sm groups-filter-btn" data-group="b">Group B</button>
               <button type="button" class="btn btn-outline-info btn-sm groups-filter-btn" data-group='["a", "b"]'>Both (a, b)</button>
-              <button type="submit" class="btn btn-primary btn-sm ms-auto" disabled>Get data</button>
+              <button type="submit" class="btn btn-primary btn-sm ms-auto">Get data</button>
             </div>
           </form>
           <div class="mt-3 d-flex gap-3">
@@ -292,7 +292,7 @@ meta:
               <input type="file" class="form-control mx-auto" style="max-width: 300px;" name="pageFile">
               <p data-file-drop-name class="small mt-2 mb-0 text-muted">No file selected</p>
             </div>
-            <button type="submit" class="btn btn-primary" disabled>Submit</button>
+            <button type="submit" class="btn btn-primary">Submit</button>
           </form>
           <div class="mt-2">
             <small class="text-muted" id="file-drop-status">Status: ready</small>
@@ -356,7 +356,7 @@ meta:
               </div>
             </div>
             <div class="d-flex gap-2">
-              <button type="submit" class="btn btn-primary" disabled>
+              <button type="submit" class="btn btn-primary">
                 <span class="button-text">Submit (watch disabled states)</span>
               </button>
               <button type="button" id="snapshot-cycle" class="btn btn-outline-warning">Rapid cycle (5x)</button>

package/docs/common-mistakes.md

@@ -13,3 +13,4 @@
 11. **Using native fetch** — always use `wonderful-fetch` or `authorized-fetch`.
 12. **XSS — unescaped dynamic data in innerHTML** — Use `webManager.utilities().escapeHTML()`. Dynamic URLs in `href`/`src`/`action`/`window.location`/`window.open` ALSO need `webManager.utilities().sanitizeURL()` — `escapeHTML` alone lets `javascript:` execute. See [xss-prevention.md](xss-prevention.md).
 13. **Leaving Liquid `{{ }}` or `{% %}` inside moved JS modules** — Jekyll does NOT process `src/assets/js/**/*.js`. Use `data-*` attribute bridges or `<template>` cloning.
+14. **🚫 `<img src>` without cachebreakers** — every `<img src>` in includes/layouts MUST append `?cb={{ site.uj.cache_breaker }}` to the URL. This applies to logos, brandmarks, rating images — any image rendered via a Liquid variable. Without it, browsers serve stale cached versions indefinitely when the image file changes on the CDN. External third-party URLs are exempt. `data-lazy="@src"` is handled at the JS layer, not in the HTML.

package/docs/jekyll-plugin.md

@@ -6,7 +6,7 @@ Ultimate Jekyll uses the `jekyll-uj-powertools` gem for custom Liquid functional
 
 ## Available Features
 
-- **Filters:** `uj_strip_ads`, `uj_json_escape`, `uj_title_case`, `uj_content_format`, `uj_hash`
+- **Filters:** `uj_strip_ads`, `uj_json_escape`, `uj_title_case`, `uj_content_format`, `uj_hash`, `uj_append_param`, `uj_cachebreak`
 - **Tags:** `iftruthy`, `iffalsy`, `uj_icon`, `uj_logo`, `uj_image`, `uj_member`, `uj_post`, `uj_readtime`, `uj_social`, `uj_translation_url`, `uj_fake_comments`, `uj_language`
 - **Global Variables:** `site.uj.cache_breaker`
 - **Page Variables:** `page.random_id`, `page.extension`, `page.layout_data`, `page.resolved`
@@ -67,3 +67,5 @@ asset_path: blog/post
 ```
 
 Uses `/assets/css/pages/{{ asset_path }}.bundle.css` instead of deriving from `page.canonical.path`. Useful when multiple pages share assets (e.g., all blog posts). See also [docs/layouts-and-pages.md](layouts-and-pages.md).
+
+**⚠️ Only set `asset_path` when sharing a module between pages.** Without it, the loader resolves `<pagePath>/index.js` automatically — that's the correct default for pages whose JS lives at `src/assets/js/pages/<pagePath>/index.js`. Setting `asset_path` overrides this to look for an **exact file** (`<asset_path>.js`), NOT a directory's `index.js`. A wrong `asset_path` fails **silently** — the page renders but the module never loads.

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "ultimate-jekyll-manager",
-  "version": "1.9.7",
+  "version": "1.9.9",
   "description": "Ultimate Jekyll dependency manager",
   "main": "dist/index.js",
   "files": [
-    "dist/",
+    "assets/",
     "bin/",
+    "dist/",
     "docs/",
-    "assets/",
     "CLAUDE.md"
   ],
   "exports": {