@schukai/monster 5.0.1 → 5.1.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 
 
+## [5.1.0] - 2026-10-11
+
+### Add Features
+
+- **style:** add composable content surfaces ([#598](https://gitlab.schukai.com/oss/libraries/javascript/monster/issues/598))
+
+
+
 ## [5.0.1] - 2026-10-11
 
 ### 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","./documentation/migrations/monster-5-options.md":"./documentation/migrations/monster-5-options.md","./package.json":"./package.json","./source/*":"./source/*","./test/*":"./test/*"},"files":["source","test/cases","test/util","documentation/migrations/monster-5-options.md","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":"5.0.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","./documentation/migrations/monster-5-options.md":"./documentation/migrations/monster-5-options.md","./package.json":"./package.json","./source/*":"./source/*","./test/*":"./test/*"},"files":["source","test/cases","test/util","documentation/migrations/monster-5-options.md","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":"5.1.0"}

package/source/components/style/surface.css

@@ -0,0 +1,2 @@
+/** generated from surface.pcss **/
+:where(.monster-surface){box-sizing:border-box;min-inline-size:0;display:grid;gap:var(--monster-surface-gap,var(--monster-space-3));padding:var(--monster-surface-padding,var(--monster-space-5));border-width:var(--monster-border-width);border-style:var(--monster-border-style);border-color:var(--monster-color-border-1);border-radius:var(--monster-border-radius);box-shadow:var(--monster-box-shadow-1)}.monster-surface-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,var(--monster-surface-grid-min-inline-size,20rem)),1fr));gap:var(--monster-surface-grid-gap,var(--monster-space-5));align-items:stretch}.monster-surface-actions{display:flex;flex-wrap:wrap;align-items:center;gap:var(--monster-surface-actions-gap,var(--monster-space-3));margin-block-start:auto}

package/source/components/style/surface.pcss

@@ -0,0 +1,33 @@
+:where(.monster-surface) {
+	box-sizing: border-box;
+	min-inline-size: 0;
+	display: grid;
+	gap: var(--monster-surface-gap, var(--monster-space-3));
+	padding: var(--monster-surface-padding, var(--monster-space-5));
+	border-width: var(--monster-border-width);
+	border-style: var(--monster-border-style);
+	border-color: var(--monster-color-border-1);
+	border-radius: var(--monster-border-radius);
+	box-shadow: var(--monster-box-shadow-1);
+}
+
+.monster-surface-grid {
+	display: grid;
+	grid-template-columns: repeat(
+		auto-fit,
+		minmax(
+			min(100%, var(--monster-surface-grid-min-inline-size, 20rem)),
+			1fr
+		)
+	);
+	gap: var(--monster-surface-grid-gap, var(--monster-space-5));
+	align-items: stretch;
+}
+
+.monster-surface-actions {
+	display: flex;
+	flex-wrap: wrap;
+	align-items: center;
+	gap: var(--monster-surface-actions-gap, var(--monster-space-3));
+	margin-block-start: auto;
+}

package/source/components/stylesheet/surface.mjs

@@ -0,0 +1,38 @@
+/**
+ * Copyright © Volker Schukai and all contributing authors, 2026. All rights reserved.
+ * Node module: @schukai/monster
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact Volker Schukai.
+ */
+
+import { addAttributeToken } from "../../dom/attributes.mjs";
+import { ATTRIBUTE_ERRORMESSAGE } from "../../dom/constants.mjs";
+
+export { SurfaceStyleSheet };
+
+/**
+ * @private
+ * @type {CSSStyleSheet}
+ */
+const SurfaceStyleSheet = new CSSStyleSheet();
+
+try {
+	SurfaceStyleSheet.insertRule(
+		`
+@layer surface {
+:where(.monster-surface){box-sizing:border-box;min-inline-size:0;display:grid;gap:var(--monster-surface-gap,var(--monster-space-3));padding:var(--monster-surface-padding,var(--monster-space-5));border-width:var(--monster-border-width);border-style:var(--monster-border-style);border-color:var(--monster-color-border-1);border-radius:var(--monster-border-radius);box-shadow:var(--monster-box-shadow-1)}.monster-surface-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,var(--monster-surface-grid-min-inline-size,20rem)),1fr));gap:var(--monster-surface-grid-gap,var(--monster-space-5));align-items:stretch}.monster-surface-actions{display:flex;flex-wrap:wrap;align-items:center;gap:var(--monster-surface-actions-gap,var(--monster-space-3));margin-block-start:auto}
+}`,
+		0,
+	);
+} catch (e) {
+	addAttributeToken(
+		document.getRootNode().querySelector("html"),
+		ATTRIBUTE_ERRORMESSAGE,
+		e + "",
+	);
+}

package/source/types/version.mjs

@@ -156,7 +156,7 @@ function getMonsterVersion() {
 	}
 
 	/** Managed by the release script; keep synchronized with package.json. */
-	monsterVersion = new Version("5.0.1");
+	monsterVersion = new Version("5.1.0");
 
 	return monsterVersion;
 }

package/test/cases/components/style/surface.mjs

@@ -0,0 +1,50 @@
+import { readFileSync } from "node:fs";
+import { expect } from "chai";
+
+const source = readFileSync(
+	new URL("../../../../source/components/style/surface.pcss", import.meta.url),
+	"utf8",
+);
+const generatedStyleSheet = readFileSync(
+	new URL(
+		"../../../../source/components/stylesheet/surface.mjs",
+		import.meta.url,
+	),
+	"utf8",
+);
+
+describe("Content surfaces", () => {
+	it("provides theme-composable static content geometry", () => {
+		expect(source).to.include(":where(.monster-surface)");
+		expect(source).to.include(
+			"gap: var(--monster-surface-gap, var(--monster-space-3));",
+		);
+		expect(source).to.include(
+			"padding: var(--monster-surface-padding, var(--monster-space-5));",
+		);
+		expect(source).to.include("border-width: var(--monster-border-width);");
+		expect(source).to.include("border-style: var(--monster-border-style);");
+		expect(source).to.include("border-color: var(--monster-color-border-1);");
+		expect(source).to.include("border-radius: var(--monster-border-radius);");
+		expect(source).not.to.match(/^\s*(?:background-color|color):/mu);
+	});
+
+	it("provides reusable responsive grids and action rows", () => {
+		expect(source).to.include(".monster-surface-grid");
+		expect(source).to.include("grid-template-columns: repeat(");
+		expect(source).to.include("auto-fit,");
+		expect(source).to.include(".monster-surface-actions");
+		expect(source).to.include("margin-block-start: auto;");
+	});
+
+	it("keeps the generated stylesheet synchronized", () => {
+		expect(generatedStyleSheet).to.include(":where(.monster-surface)");
+		expect(generatedStyleSheet).to.include(
+			"gap:var(--monster-surface-gap,var(--monster-space-3))",
+		);
+		expect(generatedStyleSheet).to.include(
+			"grid-template-columns:repeat(auto-fit,minmax(min(100%,var(--monster-surface-grid-min-inline-size,20rem)),1fr))",
+		);
+		expect(generatedStyleSheet).to.include(".monster-surface-actions");
+	});
+});