@hkdigital/lib-core 0.5.96 → 0.5.97

package/dist/meta/components/SEO.svelte.d.ts

@@ -7,7 +7,7 @@ declare const SEO: import("svelte").Component<{
     /**
      * - Configuration object
      */
-    config: import("../config.typedef.js").MetaConfig;
+    config: import("../typedef.js").MetaConfig;
     /**
      * - Page title (defaults to config name)
      */
@@ -17,39 +17,39 @@ declare const SEO: import("svelte").Component<{
      */
     description?: string | undefined;
     /**
-     * - Canonical URL for this page
+     * Canonical URL for this content to prevent duplicate content penalties
      */
-    url?: string | undefined;
+    canonicalUrl?: string | undefined;
     /**
-     * Social media preview image URL (defaults to landscape SEO image)
+     * - Landscape preview image (1200×630)
      */
-    image?: string | undefined;
+    previewImageLandscape?: import("../../config/typedef.js").ImageSource | undefined;
     /**
-     * - Alt text for social media image
+     * - Square preview image (1200×1200)
      */
-    imageAlt?: string | undefined;
+    previewImageSquare?: import("../../config/typedef.js").ImageSource | undefined;
+    /**
+     * - Alt text for preview images
+     */
+    previewImageAltText?: string | undefined;
     /**
      * - Open Graph type (default: 'website')
      */
     type?: string | undefined;
     /**
-     * Content locale (auto-detected from URL or defaults to config)
+     * - Content locale (defaults to config locale)
      */
     locale?: string | undefined;
-    /**
-     * Site name for Open Graph (defaults to config name)
-     */
-    siteName?: string | undefined;
     /**
      * Alternate language URLs for hreflang tags
      */
     alternateUrls?: Record<string, string> | undefined;
     /**
-     * Robots meta directives (e.g., 'noindex, nofollow')
+     * - Robots meta directives
      */
     robots?: string | undefined;
     /**
-     * Prevent AI training on this page content
+     * - Block AI training on this page
      */
     noAiTraining?: boolean | undefined;
 }, {}, "">;
@@ -60,7 +60,7 @@ type SEOProps = {
     /**
      * - Configuration object
      */
-    config: import("../config.typedef.js").MetaConfig;
+    config: import("../typedef.js").MetaConfig;
     /**
      * - Page title (defaults to config name)
      */
@@ -70,39 +70,39 @@ type SEOProps = {
      */
     description?: string | undefined;
     /**
-     * - Canonical URL for this page
+     * Canonical URL for this content to prevent duplicate content penalties
      */
-    url?: string | undefined;
+    canonicalUrl?: string | undefined;
     /**
-     * Social media preview image URL (defaults to landscape SEO image)
+     * - Landscape preview image (1200×630)
      */
-    image?: string | undefined;
+    previewImageLandscape?: import("../../config/typedef.js").ImageSource | undefined;
     /**
-     * - Alt text for social media image
+     * - Square preview image (1200×1200)
      */
-    imageAlt?: string | undefined;
+    previewImageSquare?: import("../../config/typedef.js").ImageSource | undefined;
+    /**
+     * - Alt text for preview images
+     */
+    previewImageAltText?: string | undefined;
     /**
      * - Open Graph type (default: 'website')
      */
     type?: string | undefined;
     /**
-     * Content locale (auto-detected from URL or defaults to config)
+     * - Content locale (defaults to config locale)
      */
     locale?: string | undefined;
-    /**
-     * Site name for Open Graph (defaults to config name)
-     */
-    siteName?: string | undefined;
     /**
      * Alternate language URLs for hreflang tags
      */
     alternateUrls?: Record<string, string> | undefined;
     /**
-     * Robots meta directives (e.g., 'noindex, nofollow')
+     * - Robots meta directives
      */
     robots?: string | undefined;
     /**
-     * Prevent AI training on this page content
+     * - Block AI training on this page
      */
     noAiTraining?: boolean | undefined;
 };

package/dist/{config/meta.d.ts → meta/config.d.ts}

@@ -34,23 +34,23 @@ export const backgroundColor: "#082962";
 export const statusBarStyle: "black-translucent";
 export const orientation: "any";
 export const disablePageZoom: true;
-export const SeoImageLandscape: string;
-export const SeoImageSquare: string;
-export const faviconImages: import("./typedef").ImageSource;
-export const appleTouchIcons: import("./typedef").ImageSource;
+export const previewImageLandscape: import("../config/typedef").ImageSource;
+export const previewImageSquare: import("../config/typedef").ImageSource;
+export const faviconImages: import("../config/typedef").ImageSource;
+export const appleTouchIcons: import("../config/typedef").ImageSource;
 /**
  * Site routes for sitemap.xml
  *
- * @type {import('../meta/typedef.js').SitemapRoute[]}
+ * @type {import('./typedef.js').SitemapRoute[]}
  *
  * @see hkdigital/lib-core/meta/README.md for detailed configuration options
  */
-export const siteRoutes: import("../meta/typedef.js").SitemapRoute[];
+export const siteRoutes: import("./typedef.js").SitemapRoute[];
 /**
  * Robots.txt configuration
  *
- * @type {import('../meta/typedef.js').RobotsConfig}
+ * @type {import('./typedef.js').RobotsConfig}
  *
  * @see hkdigital/lib-core/meta/README.md for detailed configuration options
  */
-export const robotsConfig: import("../meta/typedef.js").RobotsConfig;
+export const robotsConfig: import("./typedef.js").RobotsConfig;

package/dist/{config/meta.js → meta/config.js}

@@ -72,12 +72,12 @@ export const disablePageZoom = true;
 import SeoLandscapeImg from '../assets/meta/preview-landscape.png?seo-landscape';
 import SeoSquareImg from '../assets/meta/preview-square.png?seo-square';
 
-export const SeoImageLandscape = SeoLandscapeImg;
-export const SeoImageSquare = SeoSquareImg;
+export const previewImageLandscape = SeoLandscapeImg;
+export const previewImageSquare = SeoSquareImg;
 
 // To disable, comment out imports above and uncomment below:
-// export const SeoImageLandscape = null;
-// export const SeoImageSquare = null;
+// export const previewImageLandscape = null;
+// export const previewImageSquare = null;
 
 /**
  * Favicon images (processed by Vite imagetools)
@@ -91,7 +91,7 @@ export const appleTouchIcons = AppleTouchImgs;
 /**
  * Site routes for sitemap.xml
  *
- * @type {import('../meta/typedef.js').SitemapRoute[]}
+ * @type {import('./typedef.js').SitemapRoute[]}
  *
  * @see hkdigital/lib-core/meta/README.md for detailed configuration options
  */
@@ -106,7 +106,7 @@ export const siteRoutes = [
 /**
  * Robots.txt configuration
  *
- * @type {import('../meta/typedef.js').RobotsConfig}
+ * @type {import('./typedef.js').RobotsConfig}
  *
  * @see hkdigital/lib-core/meta/README.md for detailed configuration options
  */

package/dist/meta/templates/README.md

@@ -13,14 +13,14 @@ cp -r node_modules/@hkdigital/lib-core/meta/templates/routes/* src/routes/
 ```
 
 This copies:
-- `src/lib/config/meta.js` - Your configuration file
+- `src/lib/meta/config.js` - Your configuration file
 - `src/lib/assets/meta/*.png` - Placeholder images
 - `src/lib/meta.js` - Glue file connecting library and config
 - `src/routes/(meta)/*.json/+server.js` - Route endpoints
 
 ### 2. Customize your configuration
 
-Edit `src/lib/config/meta.js` with your app's information:
+Edit `src/lib/meta/config.js` with your app's information:
 
 ```javascript
 export const name = 'Your App Name';
@@ -122,7 +122,7 @@ src/
 - When you update the library, components get bug fixes automatically
 
 **Your code** (you customize):
-- `src/lib/config/meta.js` - Your app's configuration
+- `src/lib/meta/config.js` - Your app's configuration
 - `src/lib/assets/meta/*.png` - Your images
 - `src/lib/meta.js` - Connects library components with your config
 - `src/routes/(meta)/` - Route endpoints that use your config

package/dist/meta/templates/lib/{config/meta.d.ts → meta/config.d.ts}

@@ -1,48 +1,41 @@
 /**
- * Meta configuration
- *
- * Customize this file with your app's information.
- * After copying to your project, update all values below.
- */
-/**
- * App identity
+ * Meta data configuration
  */
-export const name: "Your App Name";
-export const shortName: "YourApp";
-export const description: "Your app description for search engines";
+export const name: "HKdigital Lib Core Test";
+export const shortName: "HKlib Core";
+export const description: "Base library that powers up Sveltekit projects";
 /**
  * Language and locale configuration
  *
+ * Configure supported languages with their locale mappings.
+ * Short codes (e.g., 'en') are defaults, explicit variants optional.
+ *
  * @type {Record<string, {lang: string, locale: string}>}
  */
 export const languages: Record<string, {
     lang: string;
     locale: string;
 }>;
-export const defaultLanguage: "en";
-export const defaultLocale: string;
 /**
- * PWA theme and colors
+ * Default language code (fallback)
+ *
+ * @type {string}
+ */
+export const defaultLanguage: string;
+/**
+ * Default locale (derived from defaultLanguage)
+ *
+ * @type {string}
  */
+export const defaultLocale: string;
 export const backgroundAndThemeColor: "#082962";
 export const themeColor: "#082962";
 export const backgroundColor: "#082962";
-/**
- * iOS PWA configuration
- */
 export const statusBarStyle: "black-translucent";
-/**
- * Screen orientation
- */
 export const orientation: "any";
-/**
- * Disable pinch-to-zoom
- *
- * Only enable for games or canvas apps where zoom breaks functionality
- */
-export const disablePageZoom: false;
-export const SeoImageLandscape: string;
-export const SeoImageSquare: string;
+export const disablePageZoom: true;
+export const previewImageLandscape: import("../../../../config/typedef").ImageSource;
+export const previewImageSquare: import("../../../../config/typedef").ImageSource;
 export const faviconImages: import("../../../../config/typedef").ImageSource;
 export const appleTouchIcons: import("../../../../config/typedef").ImageSource;
 /**
@@ -50,7 +43,7 @@ export const appleTouchIcons: import("../../../../config/typedef").ImageSource;
  *
  * @type {import('../../../typedef.js').SitemapRoute[]}
  *
- * @see @hkdigital/lib-core/meta/README.md for configuration options
+ * @see hkdigital/lib-core/meta/README.md for detailed configuration options
  */
 export const siteRoutes: import("../../../typedef.js").SitemapRoute[];
 /**
@@ -58,6 +51,6 @@ export const siteRoutes: import("../../../typedef.js").SitemapRoute[];
  *
  * @type {import('../../../typedef.js').RobotsConfig}
  *
- * @see @hkdigital/lib-core/meta/README.md for configuration options
+ * @see hkdigital/lib-core/meta/README.md for detailed configuration options
  */
 export const robotsConfig: import("../../../typedef.js").RobotsConfig;

package/dist/meta/templates/lib/{config/meta.js → meta/config.js}

@@ -1,75 +1,83 @@
 /**
- * Meta configuration
- *
- * Customize this file with your app's information.
- * After copying to your project, update all values below.
+ * Meta data configuration
  */
 
-/**
- * App identity
- */
-export const name = 'Your App Name';
-export const shortName = 'YourApp';  // max 12 characters
-export const description = 'Your app description for search engines';
+export const name = 'HKdigital Lib Core Test';
+export const shortName = 'HKlib Core';  // max 12 characters
+
+export const description = 'Base library that powers up Sveltekit projects';
 
 /**
  * Language and locale configuration
  *
+ * Configure supported languages with their locale mappings.
+ * Short codes (e.g., 'en') are defaults, explicit variants optional.
+ *
  * @type {Record<string, {lang: string, locale: string}>}
  */
 export const languages = {
+  // Short codes (defaults)
   'en': { lang: 'en-GB', locale: 'en_GB' },
-  'nl': { lang: 'nl-NL', locale: 'nl_NL' }
+  'nl': { lang: 'nl-NL', locale: 'nl_NL' },
 
-  // Add more languages as needed:
+  // Explicit variants (add as needed)
+  // 'en-us': { lang: 'en-US', locale: 'en_US' },
   // 'es': { lang: 'es-ES', locale: 'es_ES' },
-  // 'en-us': { lang: 'en-US', locale: 'en_US' }
+  // 'es-mx': { lang: 'es-MX', locale: 'es_MX' }
 };
 
+/**
+ * Default language code (fallback)
+ *
+ * @type {string}
+ */
 export const defaultLanguage = 'en';
-export const defaultLocale = languages[defaultLanguage].locale;
 
 /**
- * PWA theme and colors
+ * Default locale (derived from defaultLanguage)
+ *
+ * @type {string}
  */
+export const defaultLocale = languages[defaultLanguage].locale;
+
 export const backgroundAndThemeColor = '#082962';
+
 export const themeColor = backgroundAndThemeColor;
 export const backgroundColor = backgroundAndThemeColor;
 
-/**
- * iOS PWA configuration
- */
-export const statusBarStyle = 'black-translucent';  // 'default' | 'black' | 'black-translucent'
+export const statusBarStyle = 'black-translucent';
 
-/**
- * Screen orientation
- */
-export const orientation = 'any';  // 'any' | 'landscape' | 'portrait'
+export const orientation = 'any'; // "landscape"
 
-/**
- * Disable pinch-to-zoom
- *
- * Only enable for games or canvas apps where zoom breaks functionality
- */
-export const disablePageZoom = false;
+//
+// Only disable zoom if:
+// - You're building a game
+// - Canvas-based app where zoom breaks functionality
+// - You have a very specific (technical) reason...
+//
+export const disablePageZoom = true;
 
 /**
  * SEO social media preview images
  *
- * Replace the image files with your own designs.
- * The images are processed by Vite imagetools to correct dimensions.
+ * To enable: Import the image and export it
+ * To disable: Comment out the import and export null instead
  *
- * To disable: comment out imports and set to null
+ * Processed dimensions:
+ * - Landscape: 1200×630 (Facebook, LinkedIn, Discord)
+ * - Square: 1200×1200 (various platforms)
  */
+
+// Import and export processed images
 import SeoLandscapeImg from '../../../../assets/meta/preview-landscape.png?seo-landscape';
 import SeoSquareImg from '../../../../assets/meta/preview-square.png?seo-square';
 
-export const SeoImageLandscape = SeoLandscapeImg;  // 1200×630
-export const SeoImageSquare = SeoSquareImg;        // 1200×1200
+export const previewImageLandscape = SeoLandscapeImg;
+export const previewImageSquare = SeoSquareImg;
 
-// To disable SEO images:
-// export const SeoImageLandscape = null;
-// export const SeoImageSquare = null;
+// To disable, comment out imports above and uncomment below:
+// export const previewImageLandscape = null;
+// export const previewImageSquare = null;
 
 /**
  * Favicon images (processed by Vite imagetools)
@@ -85,7 +93,7 @@ export const appleTouchIcons = AppleTouchImgs;
  *
  * @type {import('../../../typedef.js').SitemapRoute[]}
  *
- * @see @hkdigital/lib-core/meta/README.md for configuration options
+ * @see hkdigital/lib-core/meta/README.md for detailed configuration options
  */
 export const siteRoutes = [
   '/'
@@ -100,7 +108,7 @@ export const siteRoutes = [
  *
  * @type {import('../../../typedef.js').RobotsConfig}
  *
- * @see @hkdigital/lib-core/meta/README.md for configuration options
+ * @see hkdigital/lib-core/meta/README.md for detailed configuration options
  */
 export const robotsConfig = {
   allowedHosts: '*',       // '*' allows all hosts
@@ -110,3 +118,4 @@ export const robotsConfig = {
   allowAiTraining: true,   // GPTBot, Google-Extended, CCBot, anthropic-ai
   allowAiReading: true     // ChatGPT-User, Claude-Web, cohere-ai
 };
+

package/dist/meta/templates/routes/(meta)/manifest.json/+server.js

@@ -7,7 +7,7 @@ import {
   description,
   backgroundAndThemeColor,
   orientation
-} from '../../../../../config/meta.js';
+} from '../../../../config.js';
 
 import faviconImages from '../../../../../assets/meta/favicon.png?favicons';
 

package/dist/meta/templates/routes/(meta)/robots.txt/+server.js

@@ -1,6 +1,6 @@
 import { text } from '@sveltejs/kit';
 import { generateRobotsTxt } from '../../../../utils.js';
-import { robotsConfig } from '../../../../../config/meta.js';
+import { robotsConfig } from '../../../../config.js';
 
 /** @type {import('@sveltejs/kit').RequestHandler} */
 export const GET = async ({ url }) => {

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

@@ -1,5 +1,5 @@
 import { generateSitemap } from '../../../../utils.js';
-import { siteRoutes } from '../../../../../config/meta.js';
+import { siteRoutes } from '../../../../config.js';
 
 /** @type {import('@sveltejs/kit').RequestHandler} */
 export const GET = async ({ url }) => {

package/dist/meta/typedef.d.ts

@@ -1,3 +1,102 @@
-export * from "./config.typedef.js";
 export * from "./utils/robots/typedef.js";
 export * from "./utils/sitemap/typedef.js";
+/**
+ * App identity
+ */
+export type MetaConfig = {
+    /**
+     * - Full app name
+     */
+    name: string;
+    /**
+     * - Short app name (max 12 characters)
+     */
+    shortName: string;
+    /**
+     * - App description for search engines
+     *
+     * Language and locale
+     */
+    description: string;
+    /**
+     *   Language configurations
+     */
+    languages: Record<string, {
+        lang: string;
+        locale: string;
+    }>;
+    /**
+     * - Default language code
+     */
+    defaultLanguage: string;
+    /**
+     * - Default locale
+     *
+     * PWA theme and colors
+     */
+    defaultLocale: string;
+    /**
+     * - Theme color
+     */
+    backgroundAndThemeColor: string;
+    /**
+     * - Theme color for browser UI
+     */
+    themeColor: string;
+    /**
+     * - Background color
+     */
+    backgroundColor: string;
+    /**
+     * - iOS status bar style
+     */
+    statusBarStyle: string;
+    /**
+     * - Screen orientation
+     */
+    orientation: string;
+    /**
+     * - Disable pinch-to-zoom
+     *
+     * SEO images
+     */
+    disablePageZoom: boolean;
+    /**
+     * Landscape SEO image URL (1200×630)
+     */
+    previewImageLandscape?: import("../config/typedef.js").ImageSource | undefined;
+    /**
+     * Square SEO image URL (1200×1200)
+     */
+    previewImageSquare?: import("../config/typedef.js").ImageSource | undefined;
+    /**
+     * - Alt text for social media image
+     *
+     * Favicon images (processed by imagetools)
+     */
+    previewImageAltText?: string | undefined;
+    /**
+     *   Processed favicon images
+     */
+    faviconImages: Array<{
+        src: string;
+        width: number;
+    }>;
+    /**
+     *   Processed apple-touch-icon images
+     *
+     * Site configuration
+     */
+    appleTouchIcons: Array<{
+        src: string;
+        width: number;
+    }>;
+    /**
+     *   Routes for sitemap.xml
+     */
+    siteRoutes: import("./utils/sitemap/typedef.js").SitemapRoute[];
+    /**
+     *   Robots.txt configuration
+     */
+    robotsConfig: import("./utils/robots/typedef.js").RobotsConfig;
+};

package/dist/meta/typedef.js

@@ -1,14 +1,54 @@
 /**
  * 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';
+
+/**
+ * @typedef {Object} MetaConfig
+ *
+ * App identity
+ * @property {string} name - Full app name
+ * @property {string} shortName - Short app name (max 12 characters)
+ * @property {string} description - App description for search engines
+ *
+ * Language and locale
+ * @property {Record<string, {lang: string, locale: string}>} languages
+ *   Language configurations
+ * @property {string} defaultLanguage - Default language code
+ * @property {string} defaultLocale - Default locale
+ *
+ * PWA theme and colors
+ * @property {string} backgroundAndThemeColor - Theme color
+ * @property {string} themeColor - Theme color for browser UI
+ * @property {string} backgroundColor - Background color
+ * @property {string} statusBarStyle - iOS status bar style
+ * @property {string} orientation - Screen orientation
+ * @property {boolean} disablePageZoom - Disable pinch-to-zoom
+ *
+ * SEO images
+ * @property {import('../config/typedef.js').ImageSource} [previewImageLandscape]
+ *   Landscape SEO image URL (1200×630)
+ *
+ * @property {import('../config/typedef.js').ImageSource} [previewImageSquare]
+ *   Square SEO image URL (1200×1200)
+ *
+ * @property {string} [previewImageAltText] - Alt text for social media image
+ *
+ * Favicon images (processed by imagetools)
+ * @property {Array<{src: string, width: number}>} faviconImages
+ *   Processed favicon images
+ * @property {Array<{src: string, width: number}>} appleTouchIcons
+ *   Processed apple-touch-icon images
+ *
+ * Site configuration
+ * @property {import('./utils/sitemap/typedef.js').SitemapRoute[]} siteRoutes
+ *   Routes for sitemap.xml
+ *
+ * @property {import('./utils/robots/typedef.js').RobotsConfig} robotsConfig
+ *   Robots.txt configuration
+ */

package/dist/meta.d.ts

@@ -4,5 +4,5 @@ import { SEO } from './meta/components.js';
 export const getLangFromPath: Function;
 export const injectLang: Function;
 export const handleLang: Function;
-import * as config from './config/meta.js';
+import * as config from './meta/config.js';
 export { Favicons, PWA, SEO, config };

package/dist/meta.js

@@ -8,7 +8,7 @@
 
 import { Favicons, PWA, SEO } from './meta/components.js';
 import { createLangUtils } from './meta/utils.js';
-import * as config from './config/meta.js';
+import * as config from './meta/config.js';
 
 // Create configured language utilities
 const { getLangFromPath, injectLang, handleLang } = createLangUtils(config);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.5.96",
+	"version": "0.5.97",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"