@hkdigital/lib-core 0.3.10 → 0.3.12

package/dist/{primitives → ui/primitives}/buttons/button/Button.svelte

@@ -1,5 +1,5 @@
 <script>
-  import { toStateClasses } from '../../../util/design-system/index.js';
+  import { toStateClasses } from '../../../../design/index.js';
 
   /**
    * @type {{

package/dist/{primitives → ui/primitives}/buttons/button/Button.svelte.d.ts

@@ -41,4 +41,4 @@ declare const Button: import("svelte").Component<{
     snippetLoading?: import("svelte").Snippet;
     snippetError?: import("svelte").Snippet;
     children: import("svelte").Snippet;
-}, {}, "error" | "loading" | "selected" | "disabled" | "active">;
+}, {}, "error" | "loading" | "disabled" | "selected" | "active">;

package/dist/{primitives → ui/primitives}/debug/debug-panel-design-scaling/DebugPanelDesignScaling.svelte

@@ -1,10 +1,10 @@
 <script>
   import { onMount } from 'svelte';
-  import { DESIGN, CLAMPING } from '../../../design/design-config.js';
+  import { DESIGN, CLAMPING } from '../../../../design/config/design-config.js';
   import {
     enableScalingUI,
     getAllRootScalingVars
-  } from '../../../util/design-system/index.js';
+  } from '../../../../design/index.js';
 
   /**
    * Holds the current scaling values for the debug panel

package/dist/{primitives → ui/primitives}/drag-drop/DragDropContext.svelte

@@ -5,7 +5,7 @@
 
   /**
    * @type {{
-   *   contextKey?: import('../../typedef').ContextKey,
+   *   contextKey?: import('../../../typedef').ContextKey,
    *   base?: string,
    *   classes?: string,
    *   children: import('svelte').Snippet,

package/dist/{primitives → ui/primitives}/drag-drop/DragDropContext.svelte.d.ts

@@ -11,7 +11,7 @@ type DragDropContext = {
 };
 declare const DragDropContext: import("svelte").Component<{
     [key: string]: any;
-    contextKey?: import("../../typedef").ContextKey;
+    contextKey?: import("../../../typedef").ContextKey;
     base?: string;
     classes?: string;
     children: import("svelte").Snippet;

package/dist/{primitives → ui/primitives}/drag-drop/Draggable.svelte

@@ -1,7 +1,7 @@
 <script>
   import { browser } from '$app/environment';
 
-  import { toStateClasses } from '../../util/design-system/index.js';
+  import { toStateClasses } from '../../../design/index.js';
   import { createOrGetDragState } from './drag-state.svelte.js';
   import { DragController } from './DragController.js';
   import { onDestroy } from 'svelte';
@@ -10,9 +10,9 @@
     DRAGGING,
     DRAG_PREVIEW,
     DROPPING
-  } from '../../constants/states/drag.js';
+  } from '../../../constants/states/drag.js';
 
-  /** @typedef {import('../../typedef').SimulatedDragEvent} SimulatedDragEvent */
+  /** @typedef {import('../../../typedef').SimulatedDragEvent} SimulatedDragEvent */
 
   /**
    * @type {{
@@ -32,7 +32,7 @@
    *     element: HTMLElement,
    *     rect: DOMRect
    *   }]>,
-   *   contextKey?: import('../../typedef').ContextKey,
+   *   contextKey?: import('../../../typedef').ContextKey,
    *   isDragging?: boolean,
    *   isDropping?: boolean,
    *   isDragPreview?: boolean,

package/dist/{primitives → ui/primitives}/drag-drop/Draggable.svelte.d.ts

@@ -65,7 +65,7 @@ declare const Draggable: import("svelte").Component<{
         element: HTMLElement;
         rect: DOMRect;
     }]>;
-    contextKey?: import("../../typedef").ContextKey;
+    contextKey?: import("../../../typedef").ContextKey;
     isDragging?: boolean;
     isDropping?: boolean;
     isDragPreview?: boolean;

package/dist/{primitives → ui/primitives}/drag-drop/DropZone.svelte

@@ -1,17 +1,17 @@
 <script>
-  import { toStateClasses } from '../../util/design-system/index.js';
+  import { toStateClasses } from '../../../design/index.js';
   import { createOrGetDragState } from './drag-state.svelte.js';
   import { GridLayers } from '../layout';
-  import { generateLocalId } from '../../util/unique';
+  import { generateLocalId } from '../../../util/unique';
   import {
     READY,
     DRAG_OVER,
     CAN_DROP,
     CANNOT_DROP
-  } from '../../constants/states/drop.js';
+  } from '../../../constants/states/drop.js';
 
-  /** @typedef {import('../../typedef').DragData} DragData */
-  /** @typedef {import('../../typedef').DropData} DropData */
+  /** @typedef {import('../../../typedef').DragData} DragData */
+  /** @typedef {import('../../../typedef').DropData} DropData */
 
   /**
    * @type {{
@@ -25,7 +25,7 @@
    *   maxHeight?: string,
    *   heightMode?: 'fixed' | 'flexible' | 'fill',
    *   children?: import('svelte').Snippet,
-   *   contextKey?: import('../../typedef').ContextKey,
+   *   contextKey?: import('../../../typedef').ContextKey,
    *   dropPreviewSnippet?: import('svelte').Snippet<[DragData]>,
    *   isDragOver?: boolean,
    *   canDrop?: boolean,

package/dist/{primitives → ui/primitives}/drag-drop/DropZone.svelte.d.ts

@@ -63,8 +63,8 @@ declare const DropZone: import("svelte").Component<{
     maxHeight?: string;
     heightMode?: "fixed" | "flexible" | "fill";
     children?: import("svelte").Snippet;
-    contextKey?: import("../../typedef").ContextKey;
-    dropPreviewSnippet?: import("svelte").Snippet<[import("../../typedef").DragData]>;
+    contextKey?: import("../../../typedef").ContextKey;
+    dropPreviewSnippet?: import("svelte").Snippet<[import("../../../typedef").DragData]>;
     isDragOver?: boolean;
     canDrop?: boolean;
     onDragEnter?: (detail: {
@@ -80,7 +80,7 @@ declare const DropZone: import("svelte").Component<{
         event: DragEvent;
         zone: string;
     }) => void;
-    onDrop?: (detail: import("../../typedef").DropData) => any | Promise<any>;
+    onDrop?: (detail: import("../../../typedef").DropData) => any | Promise<any>;
     onDropStart?: (detail: {
         event: DragEvent;
         zone: string;

package/dist/{primitives → ui/primitives}/drag-drop/DropZoneArea.svelte

@@ -13,8 +13,8 @@
    *   base?: string,
    *   classes?: string,
    *   children?: import('svelte').Snippet,
-   *   contextKey?: import('../../typedef').ContextKey,
-   *   dropPreviewSnippet?: import('svelte').Snippet<[import('../../typedef').DragData]>,
+   *   contextKey?: import('../../../typedef').ContextKey,
+   *   dropPreviewSnippet?: import('svelte').Snippet<[import('../../../typedef').DragData]>,
    *   isDragOver?: boolean,
    *   canDrop?: boolean,
    *   onDragEnter?: (detail: {
@@ -30,7 +30,7 @@
    *     event: DragEvent,
    *     zone: string
    *   }) => void,
-   *   onDrop?: (detail: import('../../typedef').DropData) => any | Promise<any>,
+   *   onDrop?: (detail: import('../../../typedef').DropData) => any | Promise<any>,
    *   onDropStart?: (detail: {
    *     event: DragEvent,
    *     zone: string,

package/dist/{primitives → ui/primitives}/drag-drop/DropZoneArea.svelte.d.ts

@@ -57,8 +57,8 @@ declare const DropZoneArea: import("svelte").Component<{
     base?: string;
     classes?: string;
     children?: import("svelte").Snippet;
-    contextKey?: import("../../typedef").ContextKey;
-    dropPreviewSnippet?: import("svelte").Snippet<[import("../../typedef").DragData]>;
+    contextKey?: import("../../../typedef").ContextKey;
+    dropPreviewSnippet?: import("svelte").Snippet<[import("../../../typedef").DragData]>;
     isDragOver?: boolean;
     canDrop?: boolean;
     onDragEnter?: (detail: {
@@ -74,7 +74,7 @@ declare const DropZoneArea: import("svelte").Component<{
         event: DragEvent;
         zone: string;
     }) => void;
-    onDrop?: (detail: import("../../typedef").DropData) => any | Promise<any>;
+    onDrop?: (detail: import("../../../typedef").DropData) => any | Promise<any>;
     onDropStart?: (detail: {
         event: DragEvent;
         zone: string;

package/dist/{primitives → ui/primitives}/drag-drop/DropZoneList.svelte

@@ -14,8 +14,8 @@
    *   base?: string,
    *   classes?: string,
    *   children?: import('svelte').Snippet,
-   *   contextKey?: import('../../typedef').ContextKey,
-   *   dropPreviewSnippet?: import('svelte').Snippet<[import('../../typedef').DragData]>,
+   *   contextKey?: import('../../../typedef').ContextKey,
+   *   dropPreviewSnippet?: import('svelte').Snippet<[import('../../../typedef').DragData]>,
    *   isDragOver?: boolean,
    *   canDrop?: boolean,
    *   onDragEnter?: (detail: {
@@ -31,7 +31,7 @@
    *     event: DragEvent,
    *     zone: string
    *   }) => void,
-   *   onDrop?: (detail: import('../../typedef').DropData) => any | Promise<any>,
+   *   onDrop?: (detail: import('../../../typedef').DropData) => any | Promise<any>,
    *   onDropStart?: (detail: {
    *     event: DragEvent,
    *     zone: string,

package/dist/{primitives → ui/primitives}/drag-drop/DropZoneList.svelte.d.ts

@@ -59,8 +59,8 @@ declare const DropZoneList: import("svelte").Component<{
     base?: string;
     classes?: string;
     children?: import("svelte").Snippet;
-    contextKey?: import("../../typedef").ContextKey;
-    dropPreviewSnippet?: import("svelte").Snippet<[import("../../typedef").DragData]>;
+    contextKey?: import("../../../typedef").ContextKey;
+    dropPreviewSnippet?: import("svelte").Snippet<[import("../../../typedef").DragData]>;
     isDragOver?: boolean;
     canDrop?: boolean;
     onDragEnter?: (detail: {
@@ -76,7 +76,7 @@ declare const DropZoneList: import("svelte").Component<{
         event: DragEvent;
         zone: string;
     }) => void;
-    onDrop?: (detail: import("../../typedef").DropData) => any | Promise<any>;
+    onDrop?: (detail: import("../../../typedef").DropData) => any | Promise<any>;
     onDropStart?: (detail: {
         event: DragEvent;
         zone: string;

package/dist/{primitives → ui/primitives}/drag-drop/drag-state.svelte.d.ts

@@ -1,8 +1,8 @@
-export const createOrGetDragState: (contextKey?: import("../../typedef").ContextKey) => DragState;
-export const createDragState: (contextKey?: import("../../typedef").ContextKey) => DragState;
-export const getDragState: (contextKey?: import("../../typedef").ContextKey) => DragState;
-export type SimulatedDragEvent = import("../../typedef").SimulatedDragEvent;
-/** @typedef {import('../../typedef').SimulatedDragEvent} SimulatedDragEvent */
+export const createOrGetDragState: (contextKey?: import("../../../typedef").ContextKey) => DragState;
+export const createDragState: (contextKey?: import("../../../typedef").ContextKey) => DragState;
+export const getDragState: (contextKey?: import("../../../typedef").ContextKey) => DragState;
+export type SimulatedDragEvent = import("../../../typedef").SimulatedDragEvent;
+/** @typedef {import('../../../typedef').SimulatedDragEvent} SimulatedDragEvent */
 declare class DragState {
     draggables: Map<any, any>;
     draggableIdCount: number;
@@ -61,9 +61,9 @@ declare class DragState {
     handleDropAtPoint(x: number, y: number, event: DragEvent | SimulatedDragEvent): void;
     /**
      * @param {string} draggableId
-     * @param {import('../../typedef/drag.js').DragData} dragData
+     * @param {import('../../../typedef/drag.js').DragData} dragData
      */
-    start(draggableId: string, dragData: import("../../typedef/drag.js").DragData): void;
+    start(draggableId: string, dragData: import("../../../typedef/drag.js").DragData): void;
     /**
      * @param {string} draggableId
      */
@@ -73,9 +73,9 @@ declare class DragState {
      * Get a drag data by draggable id
      *
      * @param {string} draggableId
-     * @returns {import('../../typedef/drag.js').DragData|undefined}
+     * @returns {import('../../../typedef/drag.js').DragData|undefined}
      */
-    getDraggableById(draggableId: string): import("../../typedef/drag.js").DragData | undefined;
+    getDraggableById(draggableId: string): import("../../../typedef/drag.js").DragData | undefined;
     /**
      * Get a drag data. Extracts draggable id from the supplied DragEvent
      *
@@ -86,9 +86,9 @@ declare class DragState {
     getDraggable(event: DragEvent | SimulatedDragEvent): any | null;
     /**
      * Get the most recently started drag operation (convenience method)
-     * @returns {import('../../typedef/drag.js').DragData|undefined}
+     * @returns {import('../../../typedef/drag.js').DragData|undefined}
      */
-    get current(): import("../../typedef/drag.js").DragData | undefined;
+    get current(): import("../../../typedef/drag.js").DragData | undefined;
     /**
      * @returns {boolean}
      */

package/dist/{primitives → ui/primitives}/drag-drop/drag-state.svelte.js

@@ -1,7 +1,7 @@
 // drag-state.svelte.js
-import { defineStateContext } from '../../util/svelte/state-context/index.js';
+import { defineStateContext } from '../../../util/svelte/state-context/index.js';
 
-/** @typedef {import('../../typedef').SimulatedDragEvent} SimulatedDragEvent */
+/** @typedef {import('../../../typedef').SimulatedDragEvent} SimulatedDragEvent */
 
 class DragState {
   // Existing draggables map
@@ -216,7 +216,7 @@ class DragState {
 
   /**
    * @param {string} draggableId
-   * @param {import('../../typedef/drag.js').DragData} dragData
+   * @param {import('../../../typedef/drag.js').DragData} dragData
    */
   start(draggableId, dragData) {
     // console.debug('DragState.start called:', draggableId, dragData);
@@ -257,7 +257,7 @@ class DragState {
    * Get a drag data by draggable id
    *
    * @param {string} draggableId
-   * @returns {import('../../typedef/drag.js').DragData|undefined}
+   * @returns {import('../../../typedef/drag.js').DragData|undefined}
    */
   getDraggableById(draggableId) {
     return this.draggables.get(draggableId);
@@ -303,7 +303,7 @@ class DragState {
 
   /**
    * Get the most recently started drag operation (convenience method)
-   * @returns {import('../../typedef/drag.js').DragData|undefined}
+   * @returns {import('../../../typedef/drag.js').DragData|undefined}
    */
   get current() {
     const entries = Array.from(this.draggables.entries());

package/dist/{primitives → ui/primitives}/inputs/text-input/TextInput.svelte

@@ -15,7 +15,7 @@
     INVALID,
     REQUIRED,
     DISABLED
-  } from '../../../constants/states/input.js';
+  } from '../../../../constants/states/input.js';
 
   /**
    * @type {{

package/dist/{primitives → ui/primitives}/tab-bar/HkTabBar.state.svelte.d.ts

@@ -48,7 +48,7 @@ export class HkTabBarState {
      */
     linkTab(index: number, tabElement: HTMLElement): void;
 }
-export const createOrGetState: (contextKey?: import("../../typedef/context.js").ContextKey) => HkTabBarState;
-export const createState: (contextKey?: import("../../typedef/context.js").ContextKey) => HkTabBarState;
-export const getState: (contextKey?: import("../../typedef/context.js").ContextKey) => HkTabBarState;
+export const createOrGetState: (contextKey?: import("../../../typedef/context.js").ContextKey) => HkTabBarState;
+export const createState: (contextKey?: import("../../../typedef/context.js").ContextKey) => HkTabBarState;
+export const getState: (contextKey?: import("../../../typedef/context.js").ContextKey) => HkTabBarState;
 export type Tab = import("./typedef.js").Tab;

package/dist/{primitives → ui/primitives}/tab-bar/HkTabBar.state.svelte.js

@@ -1,5 +1,5 @@
-import { defineStateContext } from '../../util/svelte/state-context/index.js';
-import { nav } from '../../states/navigation.svelte.js';
+import { defineStateContext } from '../../../util/svelte/state-context/index.js';
+import { nav } from '../../../states/navigation.svelte.js';
 
 import { goto } from '$app/navigation';
 

package/dist/{primitives → ui/primitives}/tab-bar/HkTabBarSelector.state.svelte.d.ts

@@ -14,6 +14,6 @@ export class HkTabBarSelectorState {
     tabBarState: any;
     #private;
 }
-export const createOrGetState: (contextKey?: import("../../typedef/context.js").ContextKey) => HkTabBarSelectorState;
-export const createState: (contextKey?: import("../../typedef/context.js").ContextKey) => HkTabBarSelectorState;
-export const getState: (contextKey?: import("../../typedef/context.js").ContextKey) => HkTabBarSelectorState;
+export const createOrGetState: (contextKey?: import("../../../typedef").ContextKey) => HkTabBarSelectorState;
+export const createState: (contextKey?: import("../../../typedef").ContextKey) => HkTabBarSelectorState;
+export const getState: (contextKey?: import("../../../typedef").ContextKey) => HkTabBarSelectorState;

package/dist/{primitives → ui/primitives}/tab-bar/HkTabBarSelector.state.svelte.js

@@ -1,6 +1,6 @@
-import { defineStateContext } from '../../util/svelte/state-context/index.js';
+import { defineStateContext } from '../../../util/svelte/state-context/index.js';
 
-import { useResizeObserver } from '../../util/svelte/observe/index.js';
+import { useResizeObserver } from '../../../util/svelte/observe/index.js';
 
 /* ------------------------------------------------------- Define state class */
 

package/dist/util/exceptions/index.d.ts

@@ -3,13 +3,14 @@
  * to the originating Error
  * - The originating Error is set as `cause` property
  *
- * @param {string} message - Additional message to prepend
- * @param {Error|string} error - Original error
+ * @param {string} message - New error message
+ * @param {Error|string} originalError
  * @param {string|Object.<string, any>|null} [details]
+ *   New error details (a DetailError will be thrown)
  *
  * @throws {DetailedError}
  * @returns {never} This function never returns
  */
-export function rethrow(message: string, error: Error | string, details?: string | {
+export function rethrow(message: string, originalError: Error | string, details?: string | {
     [x: string]: any;
 } | null): never;

package/dist/util/exceptions/index.js

@@ -6,18 +6,21 @@ import { DetailedError } from "../../errors/generic.js";
  * to the originating Error
  * - The originating Error is set as `cause` property
  *
- * @param {string} message - Additional message to prepend
- * @param {Error|string} error - Original error
+ * @param {string} message - New error message
+ * @param {Error|string} originalError
  * @param {string|Object.<string, any>|null} [details]
+ *   New error details (a DetailError will be thrown)
  *
  * @throws {DetailedError}
  * @returns {never} This function never returns
  */
-export function rethrow(message, error, details ) {
-  if (!(error instanceof Error)) {
+export function rethrow(message, originalError, details ) {
+  let error;
+
+  if (!(originalError instanceof Error)) {
     // Convert non-Error values to Error objects
-    error = new Error(String(error));
+    error = new Error(String(originalError));
   }
 
-  throw new DetailedError(message, details, error );
+  throw new DetailedError(message, details, error ?? originalError );
 }

package/dist/util/expect/url.d.ts

@@ -1,31 +1,31 @@
 /**
- * Throws a validation error if value is not an url
+ * Throws a parse error if value is not a URL
  *
  * @param {any} value
  */
 export function url(value: any): void;
 /**
- * Throws a validation error if value is not an url or
+ * Throws a parse error if value is not a URL or
  * an empty string
  *
  * @param {any} value
  */
 export function urlOrEmptyString(value: any): void;
 /**
- * Throws a validation error if value is not a relative url
+ * Throws a parse error if value is not a URL path
  *
  * @param {any} value
  */
 export function urlPath(value: any): void;
 /**
- * Throws a validation error if value is not a relative url
+ * Throws a parse error if value is not a relative URL
  *
  * @param {any} value
  */
 export function relativeUrl(value: any): void;
 /**
- * Throws a validation error if value is not an absolute
- * or relative url
+ * Throws a parse error if value is not an absolute
+ * or relative URL
  *
  * @param {any} value
  */

package/dist/util/expect/url.js

@@ -3,58 +3,58 @@
 import * as v from 'valibot';
 
 import {
-	ValidateUrl,
-	ValidateUrlOrEmptyString,
-	ValidateUrlPath,
-	ValidateRelativeUrl,
-	ValidateAbsOrRelUrl
-} from '../../schemas/validate-url.js';
+	HumanUrl,
+	UrlOrEmptyString,
+	UrlPath,
+	RelativeUrl,
+	AbsOrRelUrl
+} from '../../valibot/parsers.js';
 
 // > Exports
 
 /**
- * Throws a validation error if value is not an url
+ * Throws a parse error if value is not a URL
  *
  * @param {any} value
  */
 export function url(value) {
-	v.parse(ValidateUrl, value);
+	v.parse(HumanUrl, value);
 }
 
 /**
- * Throws a validation error if value is not an url or
+ * Throws a parse error if value is not a URL or
  * an empty string
  *
  * @param {any} value
  */
 export function urlOrEmptyString(value) {
-	v.parse(ValidateUrlOrEmptyString, value);
+	v.parse(UrlOrEmptyString, value);
 }
 
 /**
- * Throws a validation error if value is not a relative url
+ * Throws a parse error if value is not a URL path
  *
  * @param {any} value
  */
 export function urlPath(value) {
-	v.parse(ValidateUrlPath, value);
+	v.parse(UrlPath, value);
 }
 
 /**
- * Throws a validation error if value is not a relative url
+ * Throws a parse error if value is not a relative URL
  *
  * @param {any} value
  */
 export function relativeUrl(value) {
-	v.parse(ValidateRelativeUrl, value);
+	v.parse(RelativeUrl, value);
 }
 
 /**
- * Throws a validation error if value is not an absolute
- * or relative url
+ * Throws a parse error if value is not an absolute
+ * or relative URL
  *
  * @param {any} value
  */
 export function absOrRelUrl(value) {
-	v.parse(ValidateAbsOrRelUrl, value);
+	v.parse(AbsOrRelUrl, value);
 }

package/dist/util/iterate/index.d.ts

@@ -61,11 +61,11 @@ export function iterateObjectEntries(obj: object, options?: {
  * @param {object} obj - Object to iterate
  * @param {IterableTreeOptions & { depthFirst: boolean}} [options]
  *
- * @return {Iterator} iterator object
+ * @return {Iterable<string[]>} iterable object that yields path arrays
  */
 export function iterateObjectPaths(obj: object, options?: IterableTreeOptions & {
     depthFirst: boolean;
-}): Iterator<any, any, any>;
+}): Iterable<string[]>;
 /**
  * Get an Iterator object that can be used to iterate over all values in
  * the object (at the leaves of the object tree)
@@ -73,9 +73,9 @@ export function iterateObjectPaths(obj: object, options?: IterableTreeOptions &
  * @param {object} obj - Object to iterate
  * @param {IterableTreeOptions} [options] - Iteration options
  *
- * @return {Iterator} iterator object
+ * @return {Iterable<any>} iterator object
  */
-export function iterateObjectValues(obj: object, options?: IterableTreeOptions): Iterator<any, any, any>;
+export function iterateObjectValues(obj: object, options?: IterableTreeOptions): Iterable<any>;
 /**
  * Get a list of objects returned by an iterator in sorted order
  *

package/dist/util/iterate/index.js

@@ -110,7 +110,7 @@ export function iterateObjectEntries(obj, options = {}) {
  * @param {object} obj - Object to iterate
  * @param {IterableTreeOptions & { depthFirst: boolean}} [options]
  *
- * @return {Iterator} iterator object
+ * @return {Iterable<string[]>} iterable object that yields path arrays
  */
 export function iterateObjectPaths(obj, options) {
 	let objectIterator;
@@ -140,7 +140,7 @@ export function iterateObjectPaths(obj, options) {
  * @param {object} obj - Object to iterate
  * @param {IterableTreeOptions} [options] - Iteration options
  *
- * @return {Iterator} iterator object
+ * @return {Iterable<any>} iterator object
  */
 export function iterateObjectValues(obj, options) {
 	const objectIterator = new IterableTree(obj, options);

package/dist/valibot/README.md

@@ -0,0 +1,61 @@
+# Valibot Parsers
+
+Collection of Valibot validation parsers for common data types and formats.
+
+## Overview
+
+This module provides pre-configured Valibot parsers for validating and transforming common data types like URLs, emails, and user information.
+
+## Parsers
+
+### URL Parsers
+
+- `UrlOrEmptyString` - Validates URL or allows empty string
+- `HumanUrl` - Validates URL with automatic `https://` prefix for protocol-less URLs
+- `UrlPath` - Extracts and validates URL pathname
+- `RelativeUrl` - Validates relative URLs with path, search, and hash
+- `AbsOrRelUrl` - Validates absolute or relative URLs
+
+### Email Parsers
+
+- `Email` - Validates email addresses with normalization (trim and lowercase)
+- `LatinEmail` - Validates email addresses with Latin characters only (trim and lowercase)
+
+### User Parsers
+
+- `Name` - Validates user names
+- `Fullname` - Validates full names
+- `Username` - Validates usernames
+- `Surname` - Validates surnames
+- `PhoneNumber` - Validates phone numbers
+
+## Usage
+
+```js
+import { v, HumanUrl, Email, LatinEmail, Name } from '$lib/valibot/index.js';
+
+// Validates and transforms URL (throws error if invalid)
+const result = v.parse(HumanUrl, 'example.com'); // Returns 'https://example.com'
+
+// Validates and normalizes email (throws error if invalid)
+const emailResult = v.parse(Email, '  TEST@Example.COM  '); // Returns 'test@example.com'
+
+// Validates Latin-only email (throws error if invalid or contains non-Latin chars)
+const latinEmailResult = v.parse(LatinEmail, 'User@Domain.ORG'); // Returns 'user@domain.org'
+
+// Validates name (throws error if invalid)
+const nameResult = v.parse(Name, 'John');
+
+// Use safeParse to avoid exceptions
+const safeResult = v.safeParse(HumanUrl, 'invalid-url');
+if (safeResult.success) {
+  console.log(safeResult.output);
+} else {
+  console.log(safeResult.issues); // Array of issue objects
+}
+```
+
+## References
+
+- [SafeParseResult API](https://valibot.dev/api/SafeParseResult/)
+- [BaseIssue API](https://valibot.dev/api/BaseIssue/)