@schukai/monster 4.154.8 → 4.154.10

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 
 
+## [4.154.10] - 2026-10-10
+
+### Bug Fixes
+
+- **custom-element:** preserve early option fallbacks ([#576](https://gitlab.schukai.com/oss/libraries/javascript/monster/issues/576))
+
+
+
+## [4.154.9] - 2026-10-10
+
+### Bug Fixes
+
+- **release:** synchronize embedded package version ([#593](https://gitlab.schukai.com/oss/libraries/javascript/monster/issues/593))
+
+
+
 ## [4.154.8] - 2026-10-05
 
 ### Bug Fixes

package/package.json

@@ -1 +1 @@
-{"author":"Volker Schukai","dependencies":{"@floating-ui/dom":"^1.7.6"},"description":"Monster is a simple library for creating fast, robust and lightweight websites.","exports":{".":"./source/monster.mjs","./CHANGELOG.md":"./CHANGELOG.md","./LICENSE":"./LICENSE","./README.md":"./README.md","./package.json":"./package.json","./source/*":"./source/*","./test/*":"./test/*"},"files":["source","test/cases","test/util","CHANGELOG.md"],"homepage":"https://monsterjs.org/","keywords":["framework","web","dom","css","sass","mobile-first","app","front-end","templates","schukai","core","shopcloud","alvine","monster","buildmap","stack","observer","observable","uuid","node","nodelist","css-in-js","logger","log","theme"],"license":"AGPL 3.0","main":"source/monster.mjs","module":"source/monster.mjs","name":"@schukai/monster","repository":{"type":"git","url":"https://gitlab.schukai.com/oss/libraries/javascript/monster.git"},"sideEffects":["./source/monster.mjs","./source/components/**","./source/i18n/**","./test/**"],"type":"module","version":"4.154.8"}
+{"author":"Volker Schukai","dependencies":{"@floating-ui/dom":"^1.7.6"},"description":"Monster is a simple library for creating fast, robust and lightweight websites.","exports":{".":"./source/monster.mjs","./CHANGELOG.md":"./CHANGELOG.md","./LICENSE":"./LICENSE","./README.md":"./README.md","./package.json":"./package.json","./source/*":"./source/*","./test/*":"./test/*"},"files":["source","test/cases","test/util","CHANGELOG.md"],"homepage":"https://monsterjs.org/","keywords":["framework","web","dom","css","sass","mobile-first","app","front-end","templates","schukai","core","shopcloud","alvine","monster","buildmap","stack","observer","observable","uuid","node","nodelist","css-in-js","logger","log","theme"],"license":"AGPL 3.0","main":"source/monster.mjs","module":"source/monster.mjs","name":"@schukai/monster","repository":{"type":"git","url":"https://gitlab.schukai.com/oss/libraries/javascript/monster.git"},"sideEffects":["./source/monster.mjs","./source/components/**","./source/i18n/**","./test/**"],"type":"module","version":"4.154.10"}

package/source/dom/customelement.mjs

@@ -540,15 +540,25 @@ class CustomElement extends HTMLElement {
 	/**
 	 * nested options can be specified by path `a.b.c`
 	 *
+	 * Before the constructor has initialized the option observer, this method
+	 * returns the supplied default value. This preserves option reads from
+	 * derived `defaults` and `customization` getters during initialization.
+	 *
 	 * @param {string} path
 	 * @param {*} defaultValue
 	 * @return {*}
 	 * @since 1.10.0
 	 */
 	getOption(path, defaultValue = undefined) {
-		return new Pathfinder(
-			this[internalSymbol].getRealSubject()["options"],
-		).getVia(path, defaultValue);
+		const optionObserver = this[internalSymbol];
+		if (optionObserver === undefined) {
+			return defaultValue;
+		}
+
+		return new Pathfinder(optionObserver.getRealSubject().options).getVia(
+			path,
+			defaultValue,
+		);
 	}
 
 	/**

package/source/types/version.mjs

@@ -155,8 +155,8 @@ function getMonsterVersion() {
 		return monsterVersion;
 	}
 
-	/** don't touch, replaced by make with package.json version */
-	monsterVersion = new Version("4.137.5");
+	/** Managed by the release script; keep synchronized with package.json. */
+	monsterVersion = new Version("4.154.10");
 
 	return monsterVersion;
 }

package/test/cases/dom/customelement.mjs

@@ -1232,6 +1232,54 @@ describe('DOM', function () {
                 mocks.innerHTML = html1;
             })
 
+            it('should return the fallback while defaults and customization initialize options', function () {
+                const htmlTAG = 'monster-testclass-early-option-576';
+
+                if (!customElements.get(htmlTAG)) {
+                    class EarlyOptionComponent extends CustomElement {
+                        static getTag() {
+                            return htmlTAG;
+                        }
+
+                        get defaults() {
+                            return Object.assign({}, super.defaults, {
+                                fromDefaults: this.getOption(
+                                    'source.value',
+                                    'defaults-fallback',
+                                ),
+                                fromCustomization: 'initial',
+                                templates: {
+                                    main: '<span></span>',
+                                },
+                            });
+                        }
+
+                        get customization() {
+                            return new Map([
+                                [
+                                    'fromCustomization',
+                                    this.getOption(
+                                        'source.value',
+                                        'customization-fallback',
+                                    ),
+                                ],
+                            ]);
+                        }
+                    }
+
+                    registerCustomElement(EarlyOptionComponent);
+                }
+
+                const element = document.createElement(htmlTAG);
+
+                expect(element.getOption('fromDefaults')).to.equal(
+                    'defaults-fallback',
+                );
+                expect(element.getOption('fromCustomization')).to.equal(
+                    'customization-fallback',
+                );
+            });
+
             // Pathfinder.exists() is load bearing as an input validator here:
             // the option name is undefined for every unknown
             // data-monster-option-* attribute, and the constructor plus every

package/test/cases/monster.mjs

@@ -1,20 +1,14 @@
-import {expect} from "chai"
-import {Version, getMonsterVersion} from "../../source/types/version.mjs";
-
-describe('Monster', function () {
-
-    describe('.getMonsterVersion()', function () {
-        let monsterVersion
-
-        /** don´t touch, replaced by make with package.json version */
-        monsterVersion = new Version("4.137.5")
-
-        let m = getMonsterVersion();
-
-        it('should ' + monsterVersion + ' is ' + m, function () {
-            expect(m.compareTo(monsterVersion)).is.equal(0);
-        });
-
-    });
-
+import { expect } from "chai";
+import packageData from "../../package.json" with { type: "json" };
+import { Version, getMonsterVersion } from "../../source/types/version.mjs";
+
+describe("Monster", () => {
+	describe(".getMonsterVersion()", () => {
+		it("should match the package version", () => {
+			const packageVersion = new Version(packageData.version);
+			const monsterVersion = getMonsterVersion();
+
+			expect(monsterVersion.compareTo(packageVersion)).to.equal(0);
+		});
+	});
 });