@hkdigital/lib-core 0.5.93 → 0.5.95

package/dist/meta/templates/routes/(meta)/sitemap.xml/+server.js

@@ -0,0 +1,14 @@
+import { generateSitemap } from '../../../../utils.js';
+import { siteRoutes } from '../../../../../config/meta.js';
+
+/** @type {import('@sveltejs/kit').RequestHandler} */
+export const GET = async ({ url }) => {
+  const sitemap = generateSitemap(url.origin, siteRoutes);
+
+  return new Response(sitemap, {
+    headers: {
+      'Content-Type': 'application/xml',
+      'Cache-Control': 'max-age=0, s-maxage=3600'
+    }
+  });
+};

package/dist/meta/typedef.d.ts

@@ -0,0 +1,3 @@
+export * from "./config.typedef.js";
+export * from "./utils/robots/typedef.js";
+export * from "./utils/sitemap/typedef.js";

package/dist/meta/typedef.js

@@ -0,0 +1,14 @@
+/**
+ * Type definitions for meta utilities
+ *
+ * Re-exports all typedefs from utils subfolder for convenient importing
+ */
+
+// Re-export config typedefs
+export * from './config.typedef.js';
+
+// Re-export robots typedefs
+export * from './utils/robots/typedef.js';
+
+// Re-export sitemap typedefs
+export * from './utils/sitemap/typedef.js';

package/dist/meta/utils/lang.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Create language utilities configured with your app config
+ *
+ * @param {Object} config - Configuration object
+ * @param {Record<string, {lang: string, locale: string}>} config.languages
+ *   Language configurations
+ * @param {string} config.defaultLanguage - Default language code
+ * @param {string} config.name - App name (for %title% injection)
+ * @param {string} config.description - App description
+ *
+ * @returns {{
+ *   getLangFromPath: Function,
+ *   injectLang: Function,
+ *   handleLang: Function
+ * }}
+ */
+export function createLangUtils(config: {
+    languages: Record<string, {
+        lang: string;
+        locale: string;
+    }>;
+    defaultLanguage: string;
+    name: string;
+    description: string;
+}): {
+    getLangFromPath: Function;
+    injectLang: Function;
+    handleLang: Function;
+};

package/dist/meta/utils/lang.js

@@ -0,0 +1,84 @@
+/**
+ * Create language utilities configured with your app config
+ *
+ * @param {Object} config - Configuration object
+ * @param {Record<string, {lang: string, locale: string}>} config.languages
+ *   Language configurations
+ * @param {string} config.defaultLanguage - Default language code
+ * @param {string} config.name - App name (for %title% injection)
+ * @param {string} config.description - App description
+ *
+ * @returns {{
+ *   getLangFromPath: Function,
+ *   injectLang: Function,
+ *   handleLang: Function
+ * }}
+ */
+export function createLangUtils(config) {
+  const { languages, defaultLanguage, name, description } = config;
+
+  /**
+   * Extract language code from URL pathname
+   *
+   * @param {string} pathname - URL pathname (e.g., '/en/shop')
+   *
+   * @returns {{
+   *   langCode: string,
+   *   lang: string,
+   *   locale: string
+   * }}
+   */
+  function getLangFromPath(pathname) {
+    const match = pathname.match(/^\/([a-z]{2}(?:-[a-z]{2})?)\//i);
+    const langCode = match ? match[1].toLowerCase() : defaultLanguage;
+
+    const langConfig = languages[langCode] || languages[defaultLanguage];
+
+    return {
+      langCode,
+      lang: langConfig.lang,
+      locale: langConfig.locale
+    };
+  }
+
+  /**
+   * Transform HTML to inject language, title, and description
+   *
+   * @param {string} html - HTML string with placeholders
+   * @param {string} lang - Language code (e.g., 'en-GB')
+   *
+   * @returns {string} HTML with values injected
+   */
+  function injectLang(html, lang) {
+    return html
+      .replace('%lang%', lang)
+      .replace('%title%', name)
+      .replace('%description%', description);
+  }
+
+  /**
+   * SvelteKit hook handler for language detection
+   *
+   * @param {object} event - SvelteKit event object
+   * @param {Function} resolve - SvelteKit resolve function
+   *
+   * @returns {Promise<Response>}
+   */
+  async function handleLang(event, resolve) {
+    const { langCode, lang, locale } = getLangFromPath(event.url.pathname);
+
+    event.locals.langCode = langCode;
+    event.locals.lang = lang;
+    event.locals.locale = locale;
+
+    return resolve(event, {
+      transformPageChunk: ({ html }) => injectLang(html, lang)
+    });
+  }
+
+  return {
+    getLangFromPath,
+    injectLang,
+    handleLang
+  };
+}

package/dist/meta/utils/robots.d.ts

@@ -0,0 +1 @@
+export { generateRobotsTxt, isHostAllowed } from "./robots/robots.js";

package/dist/meta/utils/robots.js

@@ -0,0 +1 @@
+export { generateRobotsTxt, isHostAllowed } from './robots/robots.js';

package/dist/meta/utils/sitemap.d.ts

@@ -0,0 +1 @@
+export { generateSitemap } from "./sitemap/sitemap.js";

package/dist/meta/utils/sitemap.js

@@ -0,0 +1 @@
+export { generateSitemap } from './sitemap/sitemap.js';

package/dist/meta/utils.d.ts

@@ -0,0 +1,3 @@
+export { createLangUtils } from "./utils/lang.js";
+export { generateSitemap } from "./utils/sitemap.js";
+export { generateRobotsTxt, isHostAllowed } from "./utils/robots.js";

package/dist/meta/utils.js

@@ -0,0 +1,11 @@
+/**
+ * Meta utilities for SEO, PWA, and favicons
+ *
+ * @module @hkdigital/lib-core/meta
+ */
+
+// Language utilities
+export { createLangUtils } from './utils/lang.js';
+
+export { generateRobotsTxt, isHostAllowed } from './utils/robots.js';
+export { generateSitemap } from './utils/sitemap.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.5.93",
+	"version": "0.5.95",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"
@@ -41,13 +41,13 @@
 		"cache:clear": "rm -rf node_modules/.cache/imagetools",
 		"lint:prettier": "prettier --check .",
 		"lint:eslint": "eslint .",
-		"lint:imports": "node scripts/validate-imports.mjs",
+		"lint:imports": "node scripts/validate-imports.mjs --exclude src/lib/meta/templates",
 		"test:unit": "vitest",
 		"test:unit-run": "pnpm run test:unit -- --run",
 		"prepack:sync": "svelte-kit sync",
 		"prepack:build": "svelte-package",
 		"prepack:lint": "publint",
-		"prepack:imports": "node scripts/validate-imports.mjs",
+		"prepack:imports": "node scripts/validate-imports.mjs --exclude src/lib/meta/templates",
 		"publish:npm:version": "npm version patch",
 		"publish:npm:publish": "npm publish --access public",
 		"upgrade:hk:update": "ncu --dep dev,optional,peer,prod '@hkdigital/*' -u",

package/scripts/validate-imports.mjs

@@ -9,6 +9,27 @@ const SRC_DIR = join(PROJECT_ROOT, 'src');
 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
 const LIB_ROOT = dirname(SCRIPT_DIR);
 
+/**
+ * Parse command line arguments for exclusion patterns
+ *
+ * @returns {string[]} Array of path patterns to exclude
+ */
+function parseExclusionArgs() {
+  const args = process.argv.slice(2);
+  const exclusions = [];
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--exclude' && i + 1 < args.length) {
+      exclusions.push(args[i + 1]);
+      i++; // Skip next arg since we consumed it
+    }
+  }
+
+  return exclusions;
+}
+
+const EXCLUSION_PATTERNS = parseExclusionArgs();
+
 /**
  * Scopes to validate for barrel exports
  * Any package under these scopes will be checked
@@ -555,6 +576,25 @@ async function findAliasBarrelExport(importPath, targetName) {
   return null;
 }
 
+/**
+ * Check if file path matches any exclusion pattern
+ *
+ * @param {string} filePath - Path to check
+ *
+ * @returns {boolean} True if file should be excluded
+ */
+function isExcluded(filePath) {
+  const relativePath = relative(PROJECT_ROOT, filePath);
+
+  for (const pattern of EXCLUSION_PATTERNS) {
+    if (relativePath.includes(pattern)) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
 /**
  * Validate import paths in a file
  *
@@ -563,6 +603,11 @@ async function findAliasBarrelExport(importPath, targetName) {
  * @returns {Promise<string[]>} Array of error messages
  */
 async function validateFile(filePath) {
+  // Skip excluded files
+  if (isExcluded(filePath)) {
+    return [];
+  }
+
   const content = await readFile(filePath, 'utf-8');
   const errors = [];
   const relativePath = relative(PROJECT_ROOT, filePath);
@@ -1234,6 +1279,12 @@ async function main() {
   console.log(`Using script from @hkdigital/lib-core v${pkgJson.version}`);
   console.log(`Validating import paths...`);
 
+  if (EXCLUSION_PATTERNS.length > 0) {
+    console.log('Excluding patterns:');
+    EXCLUSION_PATTERNS.forEach(pattern => console.log(`  ${pattern}`));
+    console.log();
+  }
+
   // Load project aliases from svelte.config.js
   PROJECT_ALIASES = await loadAliases();
 

package/dist/meta/robots.d.ts

@@ -1 +0,0 @@
-export { generateRobotsTxt, isHostAllowed } from "./robots/index.js";

package/dist/meta/robots.js

@@ -1,5 +0,0 @@
-/**
- * Public exports for robots.txt utilities
- */
-
-export { generateRobotsTxt, isHostAllowed } from './robots/index.js';

package/dist/meta/sitemap.d.ts

@@ -1 +0,0 @@
-export { generateSitemap } from "./sitemap/index.js";

package/dist/meta/sitemap.js

@@ -1,5 +0,0 @@
-/**
- * Public exports for sitemap utilities
- */
-
-export { generateSitemap } from './sitemap/index.js';