@hkdigital/lib-core 0.5.96 → 0.5.98

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}

@@ -4,6 +4,12 @@
 export const name: "HKdigital Lib Core Test";
 export const shortName: "HKlib Core";
 export const description: "Base library that powers up Sveltekit projects";
+export const backgroundAndThemeColor: "#082962";
+export const themeColor: "#082962";
+export const backgroundColor: "#082962";
+export const statusBarStyle: "black-translucent";
+export const orientation: "any";
+export const disablePageZoom: true;
 /**
  * Language and locale configuration
  *
@@ -28,29 +34,23 @@ export const defaultLanguage: string;
  * @type {string}
  */
 export const defaultLocale: string;
-export const backgroundAndThemeColor: "#082962";
-export const themeColor: "#082962";
-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 { default as faviconImages } from "./favicon.png?favicons";
+export { default as appleTouchIcons } from "./favicon.png?apple-touch-icons";
+export { default as previewImageLandscape } from "./preview-landscape.png?seo-landscape";
+export { default as previewImageSquare } from "./preview-square.png?seo-square";
 /**
  * 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/meta/config.js

@@ -0,0 +1,115 @@
+/**
+ * Meta data configuration
+ */
+
+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';
+
+export const backgroundAndThemeColor = '#082962';
+
+export const themeColor = backgroundAndThemeColor;
+export const backgroundColor = backgroundAndThemeColor;
+
+export const statusBarStyle = 'black-translucent';
+
+export const orientation = 'any'; // "landscape"
+
+//
+// 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;
+
+/**
+ * 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' },
+
+  // Explicit variants (add as needed)
+  // 'en-us': { lang: 'en-US', locale: 'en_US' },
+  // 'es': { lang: 'es-ES', locale: 'es_ES' },
+  // 'es-mx': { lang: 'es-MX', locale: 'es_MX' }
+};
+
+/**
+ * Default language code (fallback)
+ *
+ * @type {string}
+ */
+export const defaultLanguage = 'en';
+
+/**
+ * Default locale (derived from defaultLanguage)
+ *
+ * @type {string}
+ */
+export const defaultLocale = languages[defaultLanguage].locale;
+
+/**
+ * Favicon images (processed by Vite imagetools)
+ */
+export { default as faviconImages } from './favicon.png?favicons';
+export { default as appleTouchIcons } from './favicon.png?apple-touch-icons';
+
+/**
+ * SEO social media preview images
+ *
+ * To enable: Import the image and export it
+ * To disable: Comment out the import and export null instead
+ *
+ * Processed dimensions:
+ * - Landscape: 1200×630 (Facebook, LinkedIn, Discord)
+ * - Square: 1200×1200 (various platforms)
+ */
+
+// Preview images
+export { default as previewImageLandscape } from './preview-landscape.png?seo-landscape';
+export { default as previewImageSquare } from './preview-square.png?seo-square';
+
+// Or disable
+// export const SeoImageLandscape = null;
+// export const SeoImageSquare = null;
+
+/**
+ * Site routes for sitemap.xml
+ *
+ * @type {import('./typedef.js').SitemapRoute[]}
+ *
+ * @see hkdigital/lib-core/meta/README.md for detailed configuration options
+ */
+export const siteRoutes = [
+  '/'
+  // Add your routes:
+  // '/about',
+  // '/contact',
+  // { path: '/blog', priority: 0.9, changefreq: 'daily' }
+];
+
+/**
+ * Robots.txt configuration
+ *
+ * @type {import('./typedef.js').RobotsConfig}
+ *
+ * @see hkdigital/lib-core/meta/README.md for detailed configuration options
+ */
+export const robotsConfig = {
+  allowedHosts: '*',       // '*' allows all hosts
+  disallowedPaths: [],     // e.g., ['/admin', '/api']
+
+  // AI bot control (site-wide via robots.txt)
+  allowAiTraining: true,   // GPTBot, Google-Extended, CCBot, anthropic-ai
+  allowAiReading: true     // ChatGPT-User, Claude-Web, cohere-ai
+};
+

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/{config/meta.js → meta/templates/lib/meta/config.js}

@@ -69,21 +69,21 @@ export const disablePageZoom = true;
  */
 
 // 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';
+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)
  */
-import FaviconImgs from '../assets/meta/favicon.png?favicons';
-import AppleTouchImgs from '../assets/meta/favicon.png?apple-touch-icons';
+import FaviconImgs from '../../../../assets/meta/favicon.png?favicons';
+import AppleTouchImgs from '../../../../assets/meta/favicon.png?apple-touch-icons';
 
 export const faviconImages = FaviconImgs;
 export const appleTouchIcons = AppleTouchImgs;
@@ -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/routes/(meta)/manifest.json/+server.js

@@ -6,10 +6,9 @@ import {
   shortName,
   description,
   backgroundAndThemeColor,
-  orientation
-} from '../../../../../config/meta.js';
-
-import faviconImages from '../../../../../assets/meta/favicon.png?favicons';
+  orientation,
+  faviconImages
+} from '../../../../config.js';
 
 /* Generate manifest data */
 

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