@ewanc26/ui 0.1.7 → 0.1.9

package/README.md

@@ -1,64 +1,12 @@
 # @ewanc26/ui
 
-Svelte UI component library extracted from [ewancroft.uk](https://ewancroft.uk). Provides layout and card components, UI primitives, SEO helpers, Svelte stores, post utilities, and a multi-theme configuration system.
-
-## Installation
+Svelte UI component library — layout components, cards, UI primitives, SEO helpers, stores, and a multi-theme configuration system.
 
 ```bash
 pnpm add @ewanc26/ui
 ```
 
-Peer dependencies: `svelte >= 5`, `@sveltejs/kit >= 2`, `tailwindcss >= 4`. Optional: `@ewanc26/atproto` (for AT Protocol card components).
-
-## What's Exported
-
-### Components
-
-| Group | Components |
-|-------|------------|
-| Layout toggles | `ThemeToggle`, `WolfToggle` |
-| Layout main | `DynamicLinks`, `ScrollToTop` |
-| Cards | `ProfileCard`, `PostCard`, `BlueskyPostCard`, `LinkCard`, `MusicStatusCard`, `KibunStatusCard`, `TangledRepoCard` |
-| UI primitives | `Card`, `InternalCard`, `Dropdown`, `Pagination`, `SearchBar`, `Tabs`, `PostsGroupedView`, `DocumentCard`, `BlogPostCard` |
-| SEO | `MetaTags` |
-
-### Stores
-
-| Store | Type | Description |
-|-------|------|-------------|
-| `wolfMode` | `Writable<boolean>` | Wolf mode text transformation |
-| `colorTheme` | `Writable<ColorTheme>` | Active colour theme |
-| `colorThemeDropdownOpen` | `Writable<boolean>` | Theme picker open state |
-| `happyMacStore` | `Writable<boolean>` | Happy Mac easter egg |
-
-### Theme Configuration
-
-12 themes across four categories (neutral, warm, cool, vibrant) using OKLCH colour values. Default: `slate`.
-
-```typescript
-import { THEMES, DEFAULT_THEME, getTheme, getThemesByCategory, CATEGORY_LABELS } from '@ewanc26/ui';
-```
-
-### Helpers
-
-```typescript
-import { getPostBadges, getBadgeClasses } from '@ewanc26/ui';
-import { filterPosts, groupPostsByDate, getSortedMonths, getSortedYears, getAllTags } from '@ewanc26/ui';
-```
-
-### Types
-
-```typescript
-import type { SiteMetadata, NavItem, ColorTheme, ThemeDefinition, PostBadge, MonthData, GroupedPosts } from '@ewanc26/ui';
-```
-
-## Build
-
-```bash
-pnpm build   # svelte-package
-pnpm dev     # svelte-package --watch
-pnpm check   # svelte-check
-```
+Full documentation at **[docs.ewancroft.uk](https://docs.ewancroft.uk/projects/ui)**.
 
 ## Licence
 

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.9",
   "description": "Svelte UI component library extracted from ewancroft.uk — pluggable layout, UI primitives, stores, and SEO components.",
   "type": "module",
   "exports": {
@@ -24,28 +24,28 @@
     "dist",
     "src"
   ],
-  "scripts": {
-    "build": "svelte-package -i src/lib -o dist",
-    "dev": "svelte-package -i src/lib -o dist --watch",
-    "check": "svelte-check --tsconfig ./tsconfig.json"
-  },
   "peerDependencies": {
     "@sveltejs/kit": ">=2.8.3",
     "svelte": ">=5.0.0",
     "tailwindcss": ">=4.0.0"
   },
   "dependencies": {
-    "@lucide/svelte": "^0.554.0"
+    "@lucide/svelte": "^0.577.0"
   },
   "optionalDependencies": {
     "@ewanc26/atproto": ">=0.2.2"
   },
   "devDependencies": {
-    "@sveltejs/kit": "^2.49.0",
+    "@sveltejs/kit": "^2.55.0",
     "@sveltejs/package": "^2.3.10",
     "@sveltejs/vite-plugin-svelte": "^6.2.1",
-    "svelte": "^5.43.14",
-    "svelte-check": "^4.3.4",
+    "svelte": "^5.53.11",
+    "svelte-check": "^4.4.5",
     "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "svelte-package -i src/lib -o dist",
+    "dev": "svelte-package -i src/lib -o dist --watch",
+    "check": "svelte-check --tsconfig ./tsconfig.json"
   }
-}
+}

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';