@ewanc26/ui 0.1.7 → 0.1.8

package/dist/helper/metaTags.d.ts

@@ -0,0 +1,12 @@
+import type { SiteMetadata } from '../types/index.js';
+/**
+ * Generates an array of meta tag objects for use in a Svelte <svelte:head>.
+ * Falls back to site defaults if a property is missing from `meta`.
+ */
+export declare function generateMetaTags(meta: SiteMetadata, defaults: SiteMetadata): Array<Record<string, string>>;
+/**
+ * Merges a defaults SiteMetadata object with optional overrides.
+ * Use this to build per-page metadata from site-wide defaults.
+ */
+export declare function createSiteMeta(defaults: SiteMetadata, overrides?: Partial<SiteMetadata>): SiteMetadata;
+//# sourceMappingURL=metaTags.d.ts.map

package/dist/helper/metaTags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaTags.d.ts","sourceRoot":"","sources":["../../src/lib/helper/metaTags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,YAAY,GACpB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkC/B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,YAAY,EACtB,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GACnC,YAAY,CAEd"}

package/dist/helper/metaTags.js

@@ -0,0 +1,43 @@
+/**
+ * Generates an array of meta tag objects for use in a Svelte <svelte:head>.
+ * Falls back to site defaults if a property is missing from `meta`.
+ */
+export function generateMetaTags(meta, defaults) {
+    const finalMeta = {
+        title: meta.title || defaults.title,
+        description: meta.description || defaults.description,
+        keywords: meta.keywords || defaults.keywords,
+        url: meta.url || defaults.url,
+        image: meta.image || defaults.image,
+        imageWidth: meta.imageWidth || defaults.imageWidth,
+        imageHeight: meta.imageHeight || defaults.imageHeight
+    };
+    return [
+        { name: 'description', content: finalMeta.description },
+        { name: 'keywords', content: finalMeta.keywords },
+        { property: 'og:type', content: 'website' },
+        { property: 'og:url', content: finalMeta.url },
+        { property: 'og:title', content: finalMeta.title },
+        { property: 'og:description', content: finalMeta.description },
+        { property: 'og:site_name', content: defaults.title },
+        { property: 'og:image', content: finalMeta.image },
+        ...(finalMeta.imageWidth
+            ? [{ property: 'og:image:width', content: finalMeta.imageWidth.toString() }]
+            : []),
+        ...(finalMeta.imageHeight
+            ? [{ property: 'og:image:height', content: finalMeta.imageHeight.toString() }]
+            : []),
+        { name: 'twitter:card', content: 'summary_large_image' },
+        { name: 'twitter:url', content: finalMeta.url },
+        { name: 'twitter:title', content: finalMeta.title },
+        { name: 'twitter:description', content: finalMeta.description },
+        { name: 'twitter:image', content: finalMeta.image }
+    ];
+}
+/**
+ * Merges a defaults SiteMetadata object with optional overrides.
+ * Use this to build per-page metadata from site-wide defaults.
+ */
+export function createSiteMeta(defaults, overrides = {}) {
+    return { ...defaults, ...overrides };
+}

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { filterPosts, groupPostsByDate, getSortedMonths, getSortedYears, getAllT
 export type { MonthData, GroupedPosts } from './helper/posts.js';
 export { getPostBadges, getBadgeClasses } from './helper/badges.js';
 export type { PostBadge } from './helper/badges.js';
+export { generateMetaTags, createSiteMeta } from './helper/metaTags.js';
 export { default as ThemeToggle } from './components/layout/ThemeToggle.svelte';
 export { default as WolfToggle } from './components/layout/WolfToggle.svelte';
 export { DynamicLinks, ScrollToTop, TangledRepos } from './components/layout/main/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChG,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAClH,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/G,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAG5F,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAG7J,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChG,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAClH,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/G,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAG5F,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAG7J,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export { THEMES, DEFAULT_THEME, CATEGORY_LABELS, getThemesByCategory, getTheme }
 // ─── Helper ───────────────────────────────────────────────────────────────────
 export { filterPosts, groupPostsByDate, getSortedMonths, getSortedYears, getAllTags } from './helper/posts.js';
 export { getPostBadges, getBadgeClasses } from './helper/badges.js';
+export { generateMetaTags, createSiteMeta } from './helper/metaTags.js';
 // ─── Layout toggles ───────────────────────────────────────────────────────────
 export { default as ThemeToggle } from './components/layout/ThemeToggle.svelte';
 export { default as WolfToggle } from './components/layout/WolfToggle.svelte';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ewanc26/ui",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Svelte UI component library extracted from ewancroft.uk — pluggable layout, UI primitives, stores, and SEO components.",
   "type": "module",
   "exports": {

package/src/lib/helper/metaTags.ts

@@ -0,0 +1,55 @@
+import type { SiteMetadata } from '../types/index.js';
+
+/**
+ * Generates an array of meta tag objects for use in a Svelte <svelte:head>.
+ * Falls back to site defaults if a property is missing from `meta`.
+ */
+export function generateMetaTags(
+	meta: SiteMetadata,
+	defaults: SiteMetadata
+): Array<Record<string, string>> {
+	const finalMeta: SiteMetadata = {
+		title: meta.title || defaults.title,
+		description: meta.description || defaults.description,
+		keywords: meta.keywords || defaults.keywords,
+		url: meta.url || defaults.url,
+		image: meta.image || defaults.image,
+		imageWidth: meta.imageWidth || defaults.imageWidth,
+		imageHeight: meta.imageHeight || defaults.imageHeight
+	};
+
+	return [
+		{ name: 'description', content: finalMeta.description },
+		{ name: 'keywords', content: finalMeta.keywords },
+
+		{ property: 'og:type', content: 'website' },
+		{ property: 'og:url', content: finalMeta.url },
+		{ property: 'og:title', content: finalMeta.title },
+		{ property: 'og:description', content: finalMeta.description },
+		{ property: 'og:site_name', content: defaults.title },
+		{ property: 'og:image', content: finalMeta.image },
+		...(finalMeta.imageWidth
+			? [{ property: 'og:image:width', content: finalMeta.imageWidth.toString() }]
+			: []),
+		...(finalMeta.imageHeight
+			? [{ property: 'og:image:height', content: finalMeta.imageHeight.toString() }]
+			: []),
+
+		{ name: 'twitter:card', content: 'summary_large_image' },
+		{ name: 'twitter:url', content: finalMeta.url },
+		{ name: 'twitter:title', content: finalMeta.title },
+		{ name: 'twitter:description', content: finalMeta.description },
+		{ name: 'twitter:image', content: finalMeta.image }
+	];
+}
+
+/**
+ * Merges a defaults SiteMetadata object with optional overrides.
+ * Use this to build per-page metadata from site-wide defaults.
+ */
+export function createSiteMeta(
+	defaults: SiteMetadata,
+	overrides: Partial<SiteMetadata> = {}
+): SiteMetadata {
+	return { ...defaults, ...overrides };
+}

package/src/lib/index.ts

@@ -14,6 +14,7 @@ export { filterPosts, groupPostsByDate, getSortedMonths, getSortedYears, getAllT
 export type { MonthData, GroupedPosts } from './helper/posts.js';
 export { getPostBadges, getBadgeClasses } from './helper/badges.js';
 export type { PostBadge } from './helper/badges.js';
+export { generateMetaTags, createSiteMeta } from './helper/metaTags.js';
 
 // ─── Layout toggles ───────────────────────────────────────────────────────────
 export { default as ThemeToggle } from './components/layout/ThemeToggle.svelte';