@hkdigital/lib-core 0.3.10 → 0.3.12

package/dist/valibot/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./user.js";
-export * from "./url.js";
-export default v;
-import * as v from 'valibot';
+export * from "./parsers.js";
+export { valibot as v };
+export default valibot;
+import * as valibot from 'valibot';

package/dist/valibot/index.js

@@ -1,9 +1,8 @@
-import * as v from 'valibot';
+import * as valibot from 'valibot';
 
 // export * from './date.js';
 
-export * from './user.js';
+export * from './parsers.js';
 
-export * from './url.js';
-
-export default v;
+export { valibot as v };
+export default valibot;

package/dist/valibot/parsers/email.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Parser for email addresses with normalization.
+ * Trims whitespace and converts to lowercase.
+ */
+export const Email: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.ToLowerCaseAction, v.EmailAction<string, undefined>]>;
+/**
+ * Parser for email addresses with Latin characters only.
+ * Trims whitespace, converts to lowercase, and validates email format.
+ * Restricts to Latin characters and numbers for international compatibility.
+ */
+export const LatinEmail: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.ToLowerCaseAction, v.RegexAction<string, "Email address contains non-Latin characters">, v.EmailAction<string, undefined>]>;
+import * as v from 'valibot';

package/dist/valibot/parsers/email.js

@@ -0,0 +1,34 @@
+// > Imports
+
+import * as v from 'valibot';
+
+import { LCHAR_LNUMBER } from '../../constants/regexp/index.js';
+
+// > Email Parsers
+
+/**
+ * Parser for email addresses with normalization.
+ * Trims whitespace and converts to lowercase.
+ */
+export const Email = v.pipe(
+	v.string(),
+	v.trim(),
+	v.toLowerCase(),
+	v.email()
+);
+
+/**
+ * Parser for email addresses with Latin characters only.
+ * Trims whitespace, converts to lowercase, and validates email format.
+ * Restricts to Latin characters and numbers for international compatibility.
+ */
+export const LatinEmail = v.pipe(
+	v.string(),
+	v.trim(),
+	v.toLowerCase(),
+	v.regex(
+		new RegExp(`^(?:${LCHAR_LNUMBER}|[\\._%+\\-])+@(?:${LCHAR_LNUMBER}|[.\\-])+\\.(?:${LCHAR_LNUMBER}){2,}$`, 'v'),
+		'Email address contains non-Latin characters'
+	),
+	v.email()
+);

package/dist/valibot/{url.d.ts → parsers/url.d.ts}

@@ -1,26 +1,34 @@
 /**
- * Schema to validate an URL or empty string.
+ * Parser for URL or empty string.
  */
 export const UrlOrEmptyString: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction]>, v.UnionSchema<[v.LiteralSchema<"", undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.UrlAction<string, undefined>]>], undefined>]>;
 /**
- * Schema to validate an url that may miss the protocol part
+ * Parser for URL that may miss the protocol part
  *
  * @note an empty string is not allowed!
  */
 export const HumanUrl: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.TransformAction<string, string>, v.UrlAction<string, undefined>]>;
 /**
- * Schema to validate url path, without a search and hash part
+ * Parser for URL path, without a search and hash part
  */
 export const UrlPath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, URL>, v.CustomSchema<URL, "Invalid URL pathname">, v.TransformAction<URL, string>]>;
 /**
- * Schema to validate a url path, which consists of
+ * Parser for URL path, which consists of
  * a path and optionally search and hash parts
  */
 export const RelativeUrl: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, URL>, v.CustomSchema<URL, "Invalid URL pathname or search part">, v.TransformAction<URL, string>]>;
 /**
- * Schema to validate an absolute or relative url
+ * Parser for absolute or relative URL
  *
  * @note an empty string is not allowed!
  */
 export const AbsOrRelUrl: v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.UrlAction<string, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, URL>, v.CustomSchema<URL, "Invalid URL pathname or search part">, v.TransformAction<URL, string>]>]>], undefined>;
+/**
+ * Parser for URL slug (e.g., "my-blog-post", "user-123")
+ *
+ * @note Must start and end with Latin characters or numbers
+ * @note Hyphens are allowed between character groups
+ * @note Automatically converts to lowercase
+ */
+export const Slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.ToLowerCaseAction, v.RegexAction<string, "Must be a valid URL slug">]>;
 import * as v from 'valibot';

package/dist/valibot/{url.js → parsers/url.js}

@@ -2,10 +2,12 @@
 
 import * as v from 'valibot';
 
-// > Exports
+import { URL_SLUG } from '../../constants/regexp/index.js';
+
+// > URL Parsers
 
 /**
- * Schema to validate an URL or empty string.
+ * Parser for URL or empty string.
  */
 export const UrlOrEmptyString = v.pipe(
 	v.pipe(v.string(), v.trim()),
@@ -13,7 +15,7 @@ export const UrlOrEmptyString = v.pipe(
 );
 
 /**
- * Schema to validate an url that may miss the protocol part
+ * Parser for URL that may miss the protocol part
  *
  * @note an empty string is not allowed!
  */
@@ -32,7 +34,7 @@ export const HumanUrl = v.pipe(
 );
 
 /**
- * Schema to validate url path, without a search and hash part
+ * Parser for URL path, without a search and hash part
  */
 export const UrlPath = v.pipe(
 	v.string(),
@@ -56,7 +58,7 @@ export const UrlPath = v.pipe(
 );
 
 /**
- * Schema to validate a url path, which consists of
+ * Parser for URL path, which consists of
  * a path and optionally search and hash parts
  */
 export const RelativeUrl = v.pipe(
@@ -85,7 +87,7 @@ export const RelativeUrl = v.pipe(
 );
 
 /**
- * Schema to validate an absolute or relative url
+ * Parser for absolute or relative URL
  *
  * @note an empty string is not allowed!
  */
@@ -93,3 +95,17 @@ export const AbsOrRelUrl = v.union([
 	v.pipe(v.string(), v.trim(), v.url()),
 	v.pipe(v.string(), v.nonEmpty(), RelativeUrl)
 ]);
+
+/**
+ * Parser for URL slug (e.g., "my-blog-post", "user-123")
+ * 
+ * @note Must start and end with Latin characters or numbers
+ * @note Hyphens are allowed between character groups
+ * @note Automatically converts to lowercase
+ */
+export const Slug = v.pipe(
+	v.string(),
+	v.trim(),
+	v.toLowerCase(),
+	v.regex(new RegExp(URL_SLUG, 'v'), 'Must be a valid URL slug')
+);

package/dist/valibot/{user.js → parsers/user.js}

@@ -8,9 +8,9 @@ import {
 	RE_USERNAME,
 	RE_SURNAME,
 	RE_PHONENUMBER
-} from '../constants/regexp/index.js';
+} from '../../constants/regexp/index.js';
 
-// > Exports
+// > User Parsers
 
 export const Name = v.pipe(v.string(), v.trim(), v.regex(RE_NAME));
 

package/dist/valibot/parsers.d.ts

@@ -0,0 +1,2 @@
+export * from "./parsers/url.js";
+export * from "./parsers/user.js";

package/dist/valibot/parsers.js

@@ -0,0 +1,4 @@
+// > Exports
+
+export * from './parsers/url.js';
+export * from './parsers/user.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.3.10",
+	"version": "0.3.12",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"
@@ -82,8 +82,7 @@
 		"runed": "^0.23.1",
 		"svelte": "^5.33.16",
 		"svelte-preprocess": "^6.0.3",
-		"valibot": "^1.1.0",
-		"zod": "^3.24.2"
+		"valibot": "^1.1.0"
 	},
 	"devDependencies": {
 		"@eslint/js": "^9.28.0",
@@ -124,8 +123,7 @@
 		"typescript": "^5.8.3",
 		"vite": "^6.3.5",
 		"vite-imagetools": "^7.1.0",
-		"vitest": "^3.2.2",
-		"zod": "^3.24.2"
+		"vitest": "^3.2.2"
 	},
 	"dependencies": {
 		"@tailwindcss/postcss": "^4.1.11"

package/dist/components/hk-app-layout/HkAppLayout.state.svelte.d.ts

@@ -1,6 +0,0 @@
-export class AppLayoutState {
-    landscapeOnSmallScreen: boolean;
-}
-export const createOrGetState: (contextKey?: import("../../typedef").ContextKey) => AppLayoutState;
-export const createState: (contextKey?: import("../../typedef").ContextKey) => AppLayoutState;
-export const getState: (contextKey?: import("../../typedef").ContextKey) => AppLayoutState;

package/dist/constants/regexp/web.d.ts

@@ -1 +0,0 @@
-export const URL_SLUG: "^[\\p{Script=Latin}\\p{Nd}]+([-]{0,1}[\\p{Script=Latin}\\p{Nd}]+)*$";

package/dist/constants/regexp/web.js

@@ -1,3 +0,0 @@
-import { CHAR_NUMBER as CN } from './text.js';
-
-export const URL_SLUG = `^[${CN}]+([-]{0,1}[${CN}]+)*$`;

package/dist/logging/internal/unified-logger/index.d.ts

@@ -1,3 +0,0 @@
-export { default as Logger } from "./Logger.js";
-export * from "./constants.js";
-export * from "./typedef.js";

package/dist/logging/internal/unified-logger/index.js

@@ -1,6 +0,0 @@
-
-export { default as Logger } from './Logger.js';
-
-// Constants and typedefs
-export * from './constants.js';
-export * from './typedef.js';

package/dist/schemas/index.d.ts

@@ -1 +0,0 @@
-export * from "./validate-url.js";

package/dist/schemas/index.js

@@ -1 +0,0 @@
-export * from './validate-url.js';

package/dist/schemas/validate-url.d.ts

@@ -1,30 +0,0 @@
-/**
- * Schema to validate an URL
- */
-export const ValidateUrl: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.UrlAction<string, undefined>, v.CustomSchema<any, undefined>]>;
-/**
- * Schema to validate an URL or empty string.
- */
-export const ValidateUrlOrEmptyString: v.UnionSchema<[v.LiteralSchema<"", undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.UrlAction<string, undefined>]>], undefined>;
-/**
- * Schema to validate an URL path
- */
-export const ValidateUrlPath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CustomSchema<any, undefined>, v.TransformAction<any, {
-    url: URL;
-    value: any;
-}>, v.CustomSchema<{
-    url: URL;
-    value: any;
-}, "Value should not contain search path">, v.CustomSchema<{
-    url: URL;
-    value: any;
-}, "Value should not contain hash path">, v.TransformAction<{
-    url: URL;
-    value: any;
-}, string>]>;
-/**
- * Schema to validate a relative URL
- */
-export const ValidateRelativeUrl: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CustomSchema<any, undefined>, v.CustomSchema<any, undefined>]>;
-export const ValidateAbsOrRelUrl: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CustomSchema<any, undefined>, v.CustomSchema<any, undefined>]>;
-import * as v from 'valibot';

package/dist/schemas/validate-url.js

@@ -1,180 +0,0 @@
-// > Imports
-
-import * as v from 'valibot';
-// import { UrlOrEmptyString } from '../valibot/url.js';
-
-const ValidateTrim = v.custom((value) => {
-	if (/^\s|\s$/.test(value)) {
-		throw new Error('Should not start or end with whitespace');
-	}
-	return true;
-});
-
-// > Exports
-
-/**
- * Schema to validate an URL
- */
-export const ValidateUrl = v.pipe(v.string(), v.url(), ValidateTrim);
-
-/**
- * Schema to validate an URL or empty string.
- */
-export const ValidateUrlOrEmptyString = v.union([v.literal(''), v.pipe(v.string(), v.url())]);
-
-// export const ValidateHumanUrl
-
-/**
- * Schema to validate an URL path
- */
-export const ValidateUrlPath = v.pipe(
-	v.string(),
-	ValidateTrim,
-	v.transform((value) => {
-		return {
-			url: new URL(value, 'http://localhost'),
-			value
-		};
-	}),
-	v.custom(({ url }) => {
-		if (url.search) {
-			return false;
-		}
-		return true;
-	}, 'Value should not contain search path'),
-	v.custom(({ url }) => {
-		if (url.hash) {
-			return false;
-		}
-		return true;
-	}, 'Value should not contain hash path'),
-	v.transform(({ url }) => {
-		return url.pathname;
-	})
-);
-
-/**
- * Schema to validate a relative URL
- */
-export const ValidateRelativeUrl = v.pipe(
-	v.string(),
-	ValidateTrim,
-	v.custom((value) => {
-		try {
-			return new URL(value, 'http://localhost');
-
-			// eslint-disable-next-line no-unused-vars
-		} catch (e) {
-			throw new Error('Invalid relative URL');
-		}
-	})
-);
-
-export const ValidateAbsOrRelUrl = v.pipe(
-	v.string(),
-	ValidateTrim,
-	v.custom((value) => {
-		try {
-			if (/^https?:\/\//.test(value)) {
-				// Absolute url using protocol http(s)
-				return new URL(value);
-			} else {
-				// Relative URL
-				return new URL(value, 'http://localhost');
-			}
-
-			// eslint-disable-next-line no-unused-vars
-		} catch (e) {
-			throw new Error('Invalid relative URL');
-		}
-	})
-);
-
-/**
- * Schema to validate an url that may miss the protocol part
- *
- * @note an empty string is not allowed!
- */
-// export const HumanUrl = v.pipe(
-//   v.custom( ( value ) => {
-//       if( value.includes('://') )
-//       {
-//         v.parse( Url, value );
-//         return true;
-//       }
-//     } )
-//   );
-
-// 	// v.transform((value) => {
-// 	// 	if (!value.length || value.includes('://')) {
-// 	// 		return value;
-// 	// 	} else {
-// 	// 		// Prefix 'url' with 'https://'
-// 	// 		return `https://${value}`;
-// 	// 	}
-// 	// }),
-// 	// v.url()
-// );
-
-/**
- * Schema to validate url path, without a search and hash part
- */
-// export const UrlPath = v.pipe(
-// 	v.string(),
-// 	v.transform((value) => {
-// 		// Convert relative url to URL object
-// 		// @note removes ../../ parts
-// 		try {
-// 			return new URL(value, 'http://localhost');
-
-// 			// eslint-disable-next-line no-unused-vars
-// 		} catch (e) {
-// 			return null;
-// 		}
-// 	}),
-// 	v.custom((urlOrNull) => {
-// 		return urlOrNull ? true : false;
-// 	}, 'Invalid URL pathname'),
-// 	v.transform((url) => {
-// 		return url.pathname;
-// 	})
-// );
-
-/**
- * Schema to validate a url path, which consists of
- * a path and optionally search and hash parts
- */
-// export const RelativeUrl = v.pipe(
-// 	v.string(),
-// 	v.transform((value) => {
-// 		// Convert relative url to URL object
-// 		// @note removes ../../ parts
-// 		try {
-// 			return new URL(value, 'http://localhost');
-
-// 			// eslint-disable-next-line no-unused-vars
-// 		} catch (e) {
-// 			return null;
-// 		}
-// 	}),
-// 	v.custom((urlOrNull) => {
-// 		return urlOrNull ? true : false;
-// 	}, 'Invalid URL pathname or search part'),
-// 	v.transform((url) => {
-// 		return (
-// 			`${url.pathname}` +
-// 			`${url.search.length <= 1 ? '' : url.search}` +
-// 			`${url.hash.length <= 1 ? '' : url.hash}`
-// 		);
-// 	})
-// );
-
-/**
- * Schema to validate an absolute or relative url
- *
- * @note an empty string is not allowed!
- */
-// export const AbsOrRelUrl = v.union([
-// 	v.pipe(v.string(), v.trim(), v.url()),
-// 	v.pipe(v.string(), v.nonEmpty(), RelativeUrl)
-// ]);

package/dist/services/internal/index.d.ts

@@ -1,6 +0,0 @@
-export { default as ServiceBase } from "./service-base/ServiceBase.js";
-export { default as ServiceManager } from "./service-manager/ServiceManager.js";
-export * from "./service-base/constants.js";
-export * from "./service-manager/constants.js";
-export * from "./service-base/typedef.js";
-export * from "./service-manager/typedef.js";

package/dist/services/internal/index.js

@@ -1,8 +0,0 @@
-export { default as ServiceBase } from './service-base/ServiceBase.js';
-export { default as ServiceManager } from './service-manager/ServiceManager.js';
-
-export * from './service-base/constants.js';
-export * from './service-manager/constants.js';
-
-export * from './service-base/typedef.js';
-export * from './service-manager/typedef.js';

package/dist/themes/index.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/themes/index.js

@@ -1 +0,0 @@
-export { default as hkdev } from './hkdev/theme.js';

package/dist/util/design-system/index.d.ts

@@ -1,5 +0,0 @@
-export * from "./css/clamp.js";
-export * from "./css/root-design-vars.js";
-export * from "./components/states.js";
-export * from "./layout/scaling.js";
-export * from "./tailwind.js";

package/dist/util/design-system/index.js

@@ -1,5 +0,0 @@
-export * from './css/clamp.js';
-export * from './css/root-design-vars.js';
-export * from './components/states.js';
-export * from './layout/scaling.js';
-export * from './tailwind.js';

package/dist/zod/all.d.ts

@@ -1,6 +0,0 @@
-export * from "./generic.js";
-export * from "./javascript.js";
-export * from "./user.js";
-export * from "./web.js";
-export default z;
-import { z } from 'zod';

package/dist/zod/all.js

@@ -1,33 +0,0 @@
-/**
- * The following namespace style import can be used to acces the named exports
- * and als the JSdoc typedefs
- *
- * @example
- *
- * import * as Zods from '<path-to>/zod/all.js';
- *
- * JSdoc:
- * `@param {Zods.Name} name
- * `@param {Zods.Timeout} t
- *
- * Assert style:
- * Zods.String.parse(name);
- *
- * Parse style:
- * const name = Zods.Name.parse('Jens ');
- *
- * Use default export 'z':
- * // eslint-disable-next-line no-unused-vars
- * import z, * as Zods from '<path-to>/zod/all.js';
- *
- * z.string().parse(name);
- */
-
-import { z } from 'zod';
-
-export * from './generic.js';
-export * from './javascript.js';
-export * from './user.js';
-export * from './web.js';
-
-export default z;

package/dist/zod/generic.d.ts

@@ -1,6 +0,0 @@
-export type Label = string;
-export const Label: z.ZodString;
-export type LabelOrSymbol = string | Symbol;
-/** @typedef {string} Label */
-export const LabelOrSymbol: z.ZodUnion<[z.ZodString, z.ZodSymbol]>;
-import { z } from 'zod';

package/dist/zod/generic.js

@@ -1,11 +0,0 @@
-// > Imports
-
-import { z } from 'zod';
-
-// > Exports
-
-export const Label = z.string().min(1).max(80);
-/** @typedef {string} Label */
-
-export const LabelOrSymbol = z.union([z.string().min(1).max(80), z.symbol()]);
-/** @typedef {string|Symbol} LabelOrSymbol */

package/dist/zod/javascript.d.ts

@@ -1,8 +0,0 @@
-export type Timeout = number | NodeJS.Timeout;
-export const Timeout: z.ZodNumber;
-export type TimeoutOrUndefined = number | NodeJS.Timeout | undefined;
-/** @typedef {number|NodeJS.Timeout} Timeout */
-export const TimeoutOrUndefined: z.ZodUnion<[z.ZodNumber, z.ZodUndefined]>;
-declare const _default: {};
-export default _default;
-import { z } from 'zod';

package/dist/zod/javascript.js

@@ -1,32 +0,0 @@
-/**
- * The following namespace style import can be used to acces the named exports
- * and als the JSdoc typedefs
- *
- * import z, * as Zods from '<path-to>/all.js';
- *
- * @example
- *
- *  JSdoc:
- *  `@param {Type.Name} name
- *
- *  Assert style:
- *  Type.String.parse(name);
- *
- *  Parse style:
- *  const name = Type.Name.parse('Jens ');
- */
-
-// > Imports
-
-import { z } from 'zod';
-
-// > Exports
-
-export const Timeout = z.number();
-/** @typedef {number|NodeJS.Timeout} Timeout */
-
-export const TimeoutOrUndefined = z.union([z.number(), z.undefined()]);
-/** @typedef {number|NodeJS.Timeout|undefined} TimeoutOrUndefined */
-
-// Export default is required for exporting typedefs
-export default {};

package/dist/zod/user.d.ts

@@ -1,9 +0,0 @@
-export type Name = z.infer<typeof Name>;
-export const Name: z.ZodString;
-export type Fullname = z.infer<typeof Fullname>;
-/** @typedef { z.infer<typeof Name> } Name */
-export const Fullname: z.ZodString;
-export type Username = z.infer<typeof Username>;
-/** @typedef { z.infer<typeof Fullname> } Fullname */
-export const Username: z.ZodString;
-import { z } from 'zod';

package/dist/zod/user.js

@@ -1,16 +0,0 @@
-// > Imports
-
-import { z } from 'zod';
-
-import { RE_FULLNAME, RE_NAME, RE_USERNAME } from '../constants/regexp/index.js';
-
-// > Exports
-
-export const Name = z.string().trim().regex(RE_NAME);
-/** @typedef { z.infer<typeof Name> } Name */
-
-export const Fullname = z.string().trim().regex(RE_FULLNAME);
-/** @typedef { z.infer<typeof Fullname> } Fullname */
-
-export const Username = z.string().trim().regex(RE_USERNAME);
-/** @typedef { z.infer<typeof Username> } Username */