@awesomeness-js/server 1.1.10 → 1.1.13

package/tests/fixtures/site-and-components/components/cardMount/index.js

@@ -0,0 +1,86 @@
+export default function() {
+
+	const items = [
+		{
+			id: "itm-1",
+			title: "First",
+			score: 11 
+		},
+		{
+			id: "itm-2",
+			title: "Second",
+			score: 27 
+		},
+		{
+			id: "itm-3",
+			title: "Third",
+			score: 42 
+		},
+		{
+			id: "itm-4",
+			title: "Fourth",
+			score: 31 
+		},
+		{
+			id: "itm-5",
+			title: "Fifth",
+			score: 18 
+		},
+		{
+			id: "itm-6",
+			title: "Sixth",
+			score: 54 
+		},
+		{
+			id: "itm-7",
+			title: "Seventh",
+			score: 39 
+		},
+		{
+			id: "itm-8",
+			title: "Eighth",
+			score: 23 
+		},
+	];
+
+	const grouped = items.reduce((acc, item) => {
+
+		const bucket = item.score >= 40 ? "high" : item.score >= 25 ? "medium" : "low";
+
+		acc[bucket] = acc[bucket] || [];
+		acc[bucket].push(item);
+
+		return acc;
+	
+	}, {});
+
+	const sorted = [ ...items ].sort((a, b) => b.score - a.score);
+	const topThree = sorted.slice(0, 3);
+
+	const details = {
+		count: items.length,
+		topThree,
+		grouped,
+		mountRef,
+		signature: `${topThree.map((item) => item.id).join("|")}:${items.length}`,
+	};
+
+	if (details.count > 5) {
+
+		ui.cardMain();
+	
+	}
+
+	if (details.topThree.length === 3) {
+
+		ui.cardMount.mount();
+	
+	}
+
+	return {
+		$card,
+		details,
+	};
+
+	
+}

package/tests/fixtures/site-and-components/components/pageInit/index.js

@@ -0,0 +1,86 @@
+export default function() {
+
+	const items = [
+		{
+			id: "itm-1",
+			title: "First",
+			score: 11 
+		},
+		{
+			id: "itm-2",
+			title: "Second",
+			score: 27 
+		},
+		{
+			id: "itm-3",
+			title: "Third",
+			score: 42 
+		},
+		{
+			id: "itm-4",
+			title: "Fourth",
+			score: 31 
+		},
+		{
+			id: "itm-5",
+			title: "Fifth",
+			score: 18 
+		},
+		{
+			id: "itm-6",
+			title: "Sixth",
+			score: 54 
+		},
+		{
+			id: "itm-7",
+			title: "Seventh",
+			score: 39 
+		},
+		{
+			id: "itm-8",
+			title: "Eighth",
+			score: 23 
+		},
+	];
+
+	const grouped = items.reduce((acc, item) => {
+
+		const bucket = item.score >= 40 ? "high" : item.score >= 25 ? "medium" : "low";
+
+		acc[bucket] = acc[bucket] || [];
+		acc[bucket].push(item);
+
+		return acc;
+	
+	}, {});
+
+	const sorted = [ ...items ].sort((a, b) => b.score - a.score);
+	const topThree = sorted.slice(0, 3);
+
+	const details = {
+		count: items.length,
+		topThree,
+		grouped,
+		mountRef,
+		signature: `${topThree.map((item) => item.id).join("|")}:${items.length}`,
+	};
+
+	if (details.count > 5) {
+
+		ui.cardMain();
+	
+	}
+
+	if (details.topThree.length === 3) {
+
+		ui.cardMount.mount();
+	
+	}
+
+	return {
+		$card,
+		details,
+	};
+
+	
+}

package/tests/fixtures/site-and-components/components/pageScript/index.js

@@ -0,0 +1,86 @@
+export default function() {
+
+	const items = [
+		{
+			id: "itm-1",
+			title: "First",
+			score: 11 
+		},
+		{
+			id: "itm-2",
+			title: "Second",
+			score: 27 
+		},
+		{
+			id: "itm-3",
+			title: "Third",
+			score: 42 
+		},
+		{
+			id: "itm-4",
+			title: "Fourth",
+			score: 31 
+		},
+		{
+			id: "itm-5",
+			title: "Fifth",
+			score: 18 
+		},
+		{
+			id: "itm-6",
+			title: "Sixth",
+			score: 54 
+		},
+		{
+			id: "itm-7",
+			title: "Seventh",
+			score: 39 
+		},
+		{
+			id: "itm-8",
+			title: "Eighth",
+			score: 23 
+		},
+	];
+
+	const grouped = items.reduce((acc, item) => {
+
+		const bucket = item.score >= 40 ? "high" : item.score >= 25 ? "medium" : "low";
+
+		acc[bucket] = acc[bucket] || [];
+		acc[bucket].push(item);
+
+		return acc;
+	
+	}, {});
+
+	const sorted = [ ...items ].sort((a, b) => b.score - a.score);
+	const topThree = sorted.slice(0, 3);
+
+	const details = {
+		count: items.length,
+		topThree,
+		grouped,
+		mountRef,
+		signature: `${topThree.map((item) => item.id).join("|")}:${items.length}`,
+	};
+
+	if (details.count > 5) {
+
+		ui.cardMain();
+	
+	}
+
+	if (details.topThree.length === 3) {
+
+		ui.cardMount.mount();
+	
+	}
+
+	return {
+		$card,
+		details,
+	};
+
+	
+}

package/tests/fixtures/site-and-components/components/pageWidget/index.js

@@ -0,0 +1,86 @@
+export default function() {
+
+	const items = [
+		{
+			id: "itm-1",
+			title: "First",
+			score: 11 
+		},
+		{
+			id: "itm-2",
+			title: "Second",
+			score: 27 
+		},
+		{
+			id: "itm-3",
+			title: "Third",
+			score: 42 
+		},
+		{
+			id: "itm-4",
+			title: "Fourth",
+			score: 31 
+		},
+		{
+			id: "itm-5",
+			title: "Fifth",
+			score: 18 
+		},
+		{
+			id: "itm-6",
+			title: "Sixth",
+			score: 54 
+		},
+		{
+			id: "itm-7",
+			title: "Seventh",
+			score: 39 
+		},
+		{
+			id: "itm-8",
+			title: "Eighth",
+			score: 23 
+		},
+	];
+
+	const grouped = items.reduce((acc, item) => {
+
+		const bucket = item.score >= 40 ? "high" : item.score >= 25 ? "medium" : "low";
+
+		acc[bucket] = acc[bucket] || [];
+		acc[bucket].push(item);
+
+		return acc;
+	
+	}, {});
+
+	const sorted = [ ...items ].sort((a, b) => b.score - a.score);
+	const topThree = sorted.slice(0, 3);
+
+	const details = {
+		count: items.length,
+		topThree,
+		grouped,
+		mountRef,
+		signature: `${topThree.map((item) => item.id).join("|")}:${items.length}`,
+	};
+
+	if (details.count > 5) {
+
+		ui.cardMain();
+	
+	}
+
+	if (details.topThree.length === 3) {
+
+		ui.cardMount.mount();
+	
+	}
+
+	return {
+		$card,
+		details,
+	};
+
+	
+}

package/tests/fixtures/site-and-components/components/scrollSpy/elm.js

@@ -0,0 +1,172 @@
+import ui from '#ui';
+
+export default ({
+	$elm,
+	callback = () => {},
+	root = null,
+	rootMargin = "0px 0px",
+	threshold = 0.01,
+	once = true,
+
+	// auto cleanup
+	destroyOnRemove = true,
+	removeRoot = null, // defaults below
+	debug = false
+} = {}) => {
+
+	const registry = ui.scrollSpy.observerPoolRegistry();
+
+	if (!$elm) throw new Error("observer: missing $elm");
+
+	const el = $elm?.[0] || $elm;
+
+	if (!el || !el.nodeType) {
+
+		throw new Error("observer: $elm must be a DOM element or a jQuery-like wrapper");
+	
+	}
+
+	if (!removeRoot) removeRoot = document.documentElement || document.body;
+
+	let pool = null;
+	let mo = null;
+	let connectMo = null;
+
+	let last = null;
+	let destroyed = false;
+	let started = false;
+	const subscriber = {
+		safeCall: (isIntersecting, entry) => safeCall(isIntersecting, entry)
+	};
+
+	const log = (...args) => debug && console.log("[observer]", ...args);
+
+	const safeCall = (v, entry) => {
+
+		if (destroyed) return;
+
+		v = !!v;
+
+		if (v === last) return;
+		last = v;
+
+		try {
+
+			callback(v, entry);
+
+		} catch (e) {}
+
+		if (once && v) destroy();
+
+	};
+
+	const destroy = () => {
+
+		if (destroyed) return;
+		destroyed = true;
+
+		ui.scrollSpy.observerPoolUnsubscribe({
+			registry,
+			poolEntry: pool,
+			targetElm: el,
+			subscriber
+		});
+		pool = null;
+
+		if (mo) mo.disconnect();
+		mo = null;
+
+		if (connectMo) connectMo.disconnect();
+		connectMo = null;
+
+		log("destroyed");
+
+	};
+
+	const start = () => {
+
+		if (destroyed || started) return;
+		started = true;
+
+		pool = ui.scrollSpy.observerPoolGet({
+			registry,
+			root,
+			rootMargin,
+			threshold 
+		});
+
+		ui.scrollSpy.observerPoolSubscribe({
+			poolEntry: pool,
+			targetElm: el,
+			subscriber
+		});
+
+		log("started", {
+			el,
+			root,
+			rootMargin,
+			threshold,
+			sharedObserverPool: true
+		});
+
+		// auto destroy on removal
+		if (destroyOnRemove) {
+
+			mo = new MutationObserver(() => {
+
+				if (!el.isConnected) destroy();
+
+			});
+
+			mo.observe(removeRoot, {
+				childList: true,
+				subtree: true
+			});
+
+		}
+
+	};
+
+	// If it's already connected, start immediately.
+	// If not, wait until it becomes connected.
+	if (el.isConnected) {
+
+		start();
+
+	} else {
+
+		log("waiting for element to connect...");
+
+		connectMo = new MutationObserver(() => {
+
+			if (destroyed) return;
+
+			if (el.isConnected) {
+
+				connectMo.disconnect();
+				connectMo = null;
+
+				// wait 1 frame so layout exists
+				requestAnimationFrame(() => start());
+
+			}
+
+		});
+
+		connectMo.observe(removeRoot, {
+			childList: true,
+			subtree: true
+		});
+
+	}
+
+	// stash destroy
+	try {
+
+		$elm?.data?.("observerDestroy", destroy); 
+
+	} catch (e) {}
+
+	return { destroy };
+
+};

package/tests/fixtures/site-and-components/components/scrollSpy/index.js

@@ -0,0 +1,63 @@
+export default ({
+	$spyOn,
+	$applyTo,
+	deadZone = 10
+} = {}) => {
+
+	const $classEl = ($applyTo && $applyTo.length)
+		? $applyTo
+		: $('body');
+
+	const spyTarget = ($spyOn && $spyOn.length)
+		? $spyOn.get(0)
+		: window;
+
+	const isWindow = (spyTarget === window);
+
+	const className = 'spy-scrolling-down';
+
+	let lastTop = isWindow
+		? (window.pageYOffset || document.documentElement.scrollTop || 0)
+		: (spyTarget.scrollTop || 0);
+
+	let ticking = false;
+
+	function apply(isDown) {
+
+		if (isDown) $classEl.addClass(className);
+		else $classEl.removeClass(className);
+
+	}
+
+	function readTop() {
+
+		return isWindow
+			? (window.pageYOffset || document.documentElement.scrollTop || 0)
+			: (spyTarget.scrollTop || 0);
+
+	}
+
+	function onRaf() {
+
+		ticking = false;
+
+		const topNow = readTop();
+		const delta = topNow - lastTop;
+
+		if (Math.abs(delta) < deadZone) return;
+
+		apply(delta > 0);
+		lastTop = topNow;
+
+	}
+
+	spyTarget.addEventListener('scroll', function() {
+
+		if (ticking) return;
+
+		ticking = true;
+		requestAnimationFrame(onRaf);
+
+	}, { passive: true });
+
+};

package/tests/fixtures/site-and-components/components/scrollSpy/observerPoolGet.js

@@ -0,0 +1,91 @@
+export default ({
+	registry,
+	root,
+	rootMargin,
+	threshold
+} = {}) => {
+
+	if (!registry) {
+
+		throw new Error('observerPoolGet: missing registry');
+
+	}
+
+	const toThresholdKey = (value) => {
+
+		if (Array.isArray(value)) {
+
+			return value.join(',');
+
+		}
+
+		return String(value);
+
+	};
+
+	const getRootKey = (rootElm) => {
+
+		if (!rootElm) {
+
+			return 'viewport';
+
+		}
+
+		if (!registry.rootIds.has(rootElm)) {
+
+			registry.rootSeq += 1;
+			registry.rootIds.set(rootElm, `root-${registry.rootSeq}`);
+
+		}
+
+		return registry.rootIds.get(rootElm);
+
+	};
+
+	const key = `${getRootKey(root)}|${rootMargin}|${toThresholdKey(threshold)}`;
+
+	if (registry.pools.has(key)) {
+
+		return registry.pools.get(key);
+
+	}
+
+	const targets = new Map();
+
+	const observer = new IntersectionObserver((entries) => {
+
+		entries.forEach((entry) => {
+
+			const subscribers = targets.get(entry.target);
+
+			if (!subscribers || subscribers.size === 0) {
+
+				return;
+
+			}
+
+			subscribers.forEach((subscriber) => {
+
+				subscriber.safeCall(entry.isIntersecting, entry);
+
+			});
+
+		});
+
+	}, {
+		root,
+		rootMargin,
+		threshold
+	});
+
+	const poolEntry = {
+		key,
+		observer,
+		targets
+	};
+
+	registry.pools.set(key, poolEntry);
+
+	return poolEntry;
+
+};

package/tests/fixtures/site-and-components/components/scrollSpy/observerPoolRegistry.js

@@ -0,0 +1,18 @@
+export default () => {
+
+	const OBSERVER_POOL_KEY = '__awesomenessScrollSpyElmPool__';
+	const globalScope = typeof window !== 'undefined' ? window : globalThis;
+
+	if (!globalScope[OBSERVER_POOL_KEY]) {
+
+		globalScope[OBSERVER_POOL_KEY] = {
+			pools: new Map(),
+			rootIds: new WeakMap(),
+			rootSeq: 0
+		};
+
+	}
+
+	return globalScope[OBSERVER_POOL_KEY];
+
+};

package/tests/fixtures/site-and-components/components/scrollSpy/observerPoolSubscribe.js

@@ -0,0 +1,37 @@
+export default ({
+	poolEntry,
+	targetElm,
+	subscriber
+} = {}) => {
+
+	if (!poolEntry) {
+
+		throw new Error('observerPoolSubscribe: missing poolEntry');
+
+	}
+
+	if (!targetElm) {
+
+		throw new Error('observerPoolSubscribe: missing targetElm');
+
+	}
+
+	if (!subscriber) {
+
+		throw new Error('observerPoolSubscribe: missing subscriber');
+
+	}
+
+	let subscribers = poolEntry.targets.get(targetElm);
+
+	if (!subscribers) {
+
+		subscribers = new Set();
+		poolEntry.targets.set(targetElm, subscribers);
+		poolEntry.observer.observe(targetElm);
+
+	}
+
+	subscribers.add(subscriber);
+
+};