nodality 1.0.167 → 1.0.168

package/layout/prerender.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -312,11 +312,21 @@ export async function prerender({
     "requestAnimationFrame", "cancelAnimationFrame", "getComputedStyle",
     "fetch", "dataLayer", "gtag",
     "DOMParser", "XMLSerializer", "Range", "NodeFilter",
+    // `SVGElement` is bridged so library code that does
+    // `obj.svg instanceof SVGElement` (button.js, custom icons, …)
+    // doesn't throw `ReferenceError: SVGElement is not defined` under
+    // jsdom. The previous policy of NOT shimming it caused per-page
+    // render aborts on every detail page that used a UList with
+    // bullets — projects had to drop a `globalThis.SVGElement = class
+    // {}` stub into `_globals.js` to paper over it. SVG-related
+    // checks return `false` for non-real-SVG values at SSG time, same
+    // as in the browser when the value isn't an SVG node.
+    "SVGElement", "SVGSVGElement",
     // Deliberately NOT shimming the browser `Image` / `HTMLImageElement`
-    // / `SVGElement` constructors — Nodality exports its own `Image`
-    // class and `nodality/_globals.js` writes it to `globalThis`. The
-    // browser-constructor copies would clobber it and break every
-    // `new Image().set(…)` call in the entries.
+    // constructors — Nodality exports its own `Image` class and
+    // `nodality/_globals.js` writes it to `globalThis`. The browser
+    // copies would clobber it and break every `new Image().set(…)`
+    // call in the entries.
   ];
   // Some Node versions (22+) make certain globals — most notably
   // `navigator` — getter-only on `globalThis`, which means a plain

package/layout/progress.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/row.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/saved-new-nav-bar.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/scroll-video.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/side-bar.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/side-nav-bar.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/simple-bar.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/slider-2025.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/spacer.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/stack.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/styler.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/svg.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/switcher.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/table.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/text-field.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/text.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/ulist.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/video.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/without-new.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/wrap.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/layout/zoom-card.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/card-getter.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/data.js

@@ -0,0 +1,48 @@
+/*!
+ * nodality v1.0.168
+ * (c) 2026 Filip Vabrousek
+ * License: MIT
+ */
+
+const IS_NODE = typeof process !== "undefined" && !!process.versions?.node;
+
+export async function loadJson(name, { fallback = undefined } = {}) {
+  try {
+    if (IS_NODE) {
+      // ESM JSON imports require the `with { type: "json" }` attribute.
+      // The path is interpreted relative to THIS file's URL, so the
+      // page entry's `upload/pages/` location implicitly resolves to
+      // `upload/<name>`. Consumers don't need to think about it.
+      const mod = await import(`./../../upload/${name}`, { with: { type: "json" } })
+        .catch(async () => {
+          // Fall back to a relative-from-cwd resolution for projects
+          // that don't follow the `upload/` convention. Same shape;
+          // process.cwd() is the project root at prerender time.
+          const fs = await import("node:fs");
+          const path = await import("node:path");
+          const cwd = process.cwd();
+          // Try upload/<name> then plain <name>.
+          for (const rel of [path.join("upload", name), name]) {
+            const abs = path.resolve(cwd, rel);
+            if (fs.existsSync(abs)) {
+              return { default: JSON.parse(fs.readFileSync(abs, "utf8")) };
+            }
+          }
+          throw new Error(`loadJson: ${name} not found (tried ./upload/${name} and ./${name})`);
+        });
+      return mod.default ?? mod;
+    }
+    const res = await fetch(`./${name}`);
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    return await res.json();
+  } catch (err) {
+    if (fallback !== undefined) {
+      // Soft fail — caller asked for a fallback rather than a throw.
+      if (typeof console !== "undefined") {
+        console.warn(`[loadJson] ${name} failed (${err?.message ?? err}) — using fallback`);
+      }
+      return fallback;
+    }
+    throw err;
+  }
+}

package/lib/designer.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/element-mapper.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/keyframe-animation.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/link-getter.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/scroll-video.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/seo.js

@@ -0,0 +1,198 @@
+/*!
+ * nodality v1.0.168
+ * (c) 2026 Filip Vabrousek
+ * License: MIT
+ */
+
+let configuredOrigin = "";
+
+export function setSeoOrigin(origin) {
+  configuredOrigin = String(origin ?? "").replace(/\/+$/, "");
+}
+
+function resolveOrigin() {
+  if (configuredOrigin) return configuredOrigin;
+  if (typeof window !== "undefined" && window.location?.origin) {
+    return window.location.origin;
+  }
+  return "";
+}
+
+function upsert(selector, build) {
+  if (typeof document === "undefined") return;
+  // Drop the previously-managed tag (if any) and write a fresh one.
+  // Safer than in-place mutation because the static template may have
+  // shipped its own <title> or <meta charset>; we own only the
+  // `data-seo="1"` set.
+  document.head.querySelectorAll(selector).forEach((el) => el.remove());
+  const el = build();
+  if (el) document.head.appendChild(el);
+}
+
+function metaTag(nameAttr, name, content) {
+  if (content == null || content === "") return null;
+  const m = document.createElement("meta");
+  m.setAttribute(nameAttr, name);
+  m.setAttribute("content", String(content));
+  m.setAttribute("data-seo", "1");
+  return m;
+}
+
+/**
+ * @param {object} opts
+ * @param {string} [opts.path]        — page path relative to origin ("/" or "/blog/foo")
+ * @param {string} [opts.title]       — used for OG / Twitter title (NOT <title>)
+ * @param {string} [opts.description] — meta description + OG / Twitter description
+ * @param {string} [opts.image]       — hero image (absolute, or origin-relative starting with "/")
+ * @param {string} [opts.ogType]      — defaults to "website"; products use "product", articles "article"
+ * @param {string} [opts.siteName]    — defaults to ""; appears in OG site_name
+ * @param {object} [opts.jsonLd]      — optional schema.org payload (object or @graph wrapper)
+ */
+export function applySeoMeta(opts) {
+  if (typeof document === "undefined") return;
+
+  const origin = resolveOrigin();
+  const canonicalUrl = opts.path
+    ? (origin ? new URL(opts.path, origin).toString() : opts.path)
+    : origin || "";
+
+  let absoluteImage = null;
+  if (opts.image) {
+    absoluteImage = /^https?:/i.test(opts.image)
+      ? opts.image
+      : (origin ? new URL(opts.image, origin).toString() : opts.image);
+  }
+
+  upsert('meta[name="description"][data-seo]', () =>
+    metaTag("name", "description", opts.description));
+
+  upsert('link[rel="canonical"][data-seo]', () => {
+    if (!canonicalUrl) return null;
+    const l = document.createElement("link");
+    l.setAttribute("rel", "canonical");
+    l.setAttribute("href", canonicalUrl);
+    l.setAttribute("data-seo", "1");
+    return l;
+  });
+
+  // Open Graph — Facebook, WhatsApp, iMessage, LinkedIn, Slack.
+  upsert('meta[property="og:type"][data-seo]', () =>
+    metaTag("property", "og:type", opts.ogType ?? "website"));
+  upsert('meta[property="og:title"][data-seo]', () =>
+    metaTag("property", "og:title", opts.title));
+  upsert('meta[property="og:description"][data-seo]', () =>
+    metaTag("property", "og:description", opts.description));
+  upsert('meta[property="og:url"][data-seo]', () =>
+    metaTag("property", "og:url", canonicalUrl));
+  upsert('meta[property="og:image"][data-seo]', () =>
+    metaTag("property", "og:image", absoluteImage));
+  upsert('meta[property="og:site_name"][data-seo]', () =>
+    metaTag("property", "og:site_name", opts.siteName));
+
+  // Twitter / X — prefers its own tags, falls back to OG.
+  upsert('meta[name="twitter:card"][data-seo]', () =>
+    metaTag("name", "twitter:card", absoluteImage ? "summary_large_image" : "summary"));
+  upsert('meta[name="twitter:title"][data-seo]', () =>
+    metaTag("name", "twitter:title", opts.title));
+  upsert('meta[name="twitter:description"][data-seo]', () =>
+    metaTag("name", "twitter:description", opts.description));
+  upsert('meta[name="twitter:image"][data-seo]', () =>
+    metaTag("name", "twitter:image", absoluteImage));
+
+  upsert('script[type="application/ld+json"][data-seo]', () => {
+    if (!opts.jsonLd) return null;
+    const s = document.createElement("script");
+    s.setAttribute("type", "application/ld+json");
+    s.setAttribute("data-seo", "1");
+    s.textContent = JSON.stringify(opts.jsonLd);
+    return s;
+  });
+}
+
+// ─── JSON-LD builders ──────────────────────────────────────────────
+//
+// Each builder returns a plain object the caller can pass to
+// `applySeoMeta({ jsonLd: ... })`. For pages that need to declare more
+// than one type, wrap them in @graph:
+//
+//   applySeoMeta({ jsonLd: { "@context": "https://schema.org",
+//     "@graph": [websiteJsonLd({ name, url }), organizationJsonLd({...}) ] } });
+
+export function websiteJsonLd({ name, url, inLanguage } = {}) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "WebSite",
+    name,
+    url,
+    ...(inLanguage ? { inLanguage } : {}),
+  };
+}
+
+export function organizationJsonLd({ name, url, logo, sameAs } = {}) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "Organization",
+    name,
+    url,
+    ...(logo ? { logo } : {}),
+    ...(sameAs ? { sameAs } : {}),
+  };
+}
+
+/**
+ * Product schema. `priceCurrency` defaults to USD; pass your own
+ * (e.g. "EUR", "CZK") if you ship internationally. `price` is the
+ * numeric value as a string (schema.org spec) — pass undefined to
+ * omit the offer block entirely.
+ */
+export function productJsonLd({ name, description, image, brand, category, sku, url, price, priceCurrency = "USD", availability = "https://schema.org/InStock" } = {}) {
+  const ld = {
+    "@context": "https://schema.org",
+    "@type": "Product",
+    name,
+    ...(description ? { description } : {}),
+    ...(image ? { image: Array.isArray(image) ? image : [image] } : {}),
+    ...(brand ? { brand: typeof brand === "string" ? { "@type": "Brand", name: brand } : brand } : {}),
+    ...(category ? { category } : {}),
+    ...(sku ? { sku } : {}),
+  };
+  if (price != null) {
+    ld.offers = {
+      "@type": "Offer",
+      ...(url ? { url } : {}),
+      priceCurrency,
+      price: String(price),
+      availability,
+    };
+  }
+  return ld;
+}
+
+export function articleJsonLd({ headline, description, image, author, datePublished, dateModified, publisher, url } = {}) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "Article",
+    headline,
+    ...(description ? { description } : {}),
+    ...(image ? { image: Array.isArray(image) ? image : [image] } : {}),
+    ...(author ? { author: typeof author === "string" ? { "@type": "Person", name: author } : author } : {}),
+    ...(datePublished ? { datePublished } : {}),
+    ...(dateModified ? { dateModified } : {}),
+    ...(publisher ? { publisher: typeof publisher === "string" ? { "@type": "Organization", name: publisher } : publisher } : {}),
+    ...(url ? { mainEntityOfPage: url } : {}),
+  };
+}
+
+/** items: [{ name, url }, ...] in breadcrumb order (root → leaf). */
+export function breadcrumbJsonLd(items = []) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    itemListElement: items.map((it, i) => ({
+      "@type": "ListItem",
+      position: i + 1,
+      name: it.name,
+      item: it.url,
+    })),
+  };
+}

package/lib/stacker.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/theme.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/transform-anim.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.167
+ * nodality v1.0.168
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodality",
-  "version": "1.0.167",
+  "version": "1.0.168",
   "description": "A lightweight library for declarative UI elements.",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -19,7 +19,9 @@
       "import": "./dist/index.esm.js"
     },
     "./ssg": "./layout/prerender.js",
-    "./ssg-site": "./layout/prerender-site.js"
+    "./ssg-site": "./layout/prerender-site.js",
+    "./seo": "./lib/seo.js",
+    "./data": "./lib/data.js"
   },
   "publishConfig": {
     "access": "public",