ultimate-jekyll-manager 1.6.7 → 1.6.8

package/CHANGELOG.md

@@ -14,6 +14,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - `Fixed` for any bug fixes.
 - `Security` in case of vulnerabilities.
 
+---
+## [1.6.8] - 2026-06-07
+
+### Fixed
+
+- **Lazy loading animation flash.** Elements with `data-lazy="@class animation-*"` were briefly visible before the IntersectionObserver fired, causing a jarring flash (visible → disappear → fade-in). Added CSS rule to hide these elements from initial paint so they smoothly animate in.
+
 ---
 ## [1.6.5] - 2026-06-04
 

package/CLAUDE.md

@@ -43,6 +43,10 @@ The only things that ARE safe to run inside UJM itself:
 4. `npm run build` — production build (`UJ_BUILD_MODE=true`)
 5. `npm run deploy` — build + `npu sync --message='Deploy'`
 6. `npm test` (or `npx mgr test`) — runs framework + project test suites
+   - `npx mgr test pages/home` — run a specific test by path (relative to `test/`)
+   - `npx mgr test ujm:pages/home` — run only framework tests matching a path
+   - `npx mgr test project:custom-test` — run only consumer project tests matching a path
+   - Prefix with `TEST_EXTENDED_MODE=true` for tests that hit real external APIs
 
 ### For Framework Development (This Repository)
 

package/dist/assets/css/core/_lazy-loading.scss

@@ -12,6 +12,12 @@ img[data-lazy] {
   height: auto; // Maintain aspect ratio
 }
 
+// Hide elements with pending animation classes to prevent flash
+// (visible → disappear → fade-in) when IntersectionObserver fires
+[data-lazy*="animation-"] {
+  opacity: 0;
+}
+
 // Hide video/audio elements until loaded to prevent ugly native controls showing during shimmer
 [data-lazy-load-container].lazy-loading video,
 [data-lazy-load-container].lazy-loading audio {

package/dist/defaults/CLAUDE.md

@@ -28,6 +28,9 @@ npm start           # dev: clean → setup → bundle exec gulp serve (Jekyll +
 npm run build       # production build (UJ_BUILD_MODE=true): clean → setup → full gulp pipeline → _site/
 npm run deploy      # build → `npu sync --message='Deploy'` (publishes _site/)
 npx mgr test        # run framework + project test suites (build / page / boot layers)
+npx mgr test pages/home           # run a specific test by path (relative to test/)
+npx mgr test ujm:pages/home       # run only framework tests matching a path
+npx mgr test project:custom-test  # run only consumer project tests matching a path
 npx mgr audit       # HTML validation + spellcheck + optional Lighthouse
 npx mgr install dev  # use LOCAL ultimate-jekyll-manager source (to test framework edits)
 npx mgr install live # restore the published ultimate-jekyll-manager from npm

package/docs/test-framework.md

@@ -37,6 +37,26 @@ npx mgr test --reporter json   # machine-readable __UJM_TEST__ events
 
 `npm test` works too — added to consumer `package.json#scripts.test` on `npx mgr setup`.
 
+### Filtering tests
+
+Pass a path (relative to `test/`) as a positional argument to run specific tests:
+
+```bash
+# Run a single test file
+npx mgr test pages/home
+
+# Run only UJM framework tests
+npx mgr test ujm:pages/home
+
+# Run only consumer project tests
+npx mgr test project:custom-test
+
+# Combine with extended mode
+TEST_EXTENDED_MODE=true npx mgr test pages/boot-test
+```
+
+The filter matches against the test file path. `ujm:` and `project:` prefixes scope the filter to framework-only or project-only tests respectively. Without a prefix, both are searched.
+
 ## Layers
 
 | Layer | Runs in | Use for |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-jekyll-manager",
-  "version": "1.6.7",
+  "version": "1.6.8",
   "description": "Ultimate Jekyll dependency manager",
   "main": "dist/index.js",
   "exports": {