@hkdigital/lib-core 0.3.9 → 0.3.11

package/dist/config/generators/vite.js

@@ -0,0 +1,142 @@
+import { readFileSync } from 'fs';
+import { resolve } from 'path';
+
+/**
+ * Generates a Vite configuration object with common HKdigital settings
+ *
+ * @param {object} [options] Configuration options
+ * @param {boolean} [options.enableImagetools=true] Enable vite-imagetools plugin
+ * @param {boolean} [options.enableVitest=true] Include Vitest configuration
+ * @param {boolean} [options.enableSvelteKit=true] Enable SvelteKit plugin
+ * @param {object} [options.customDefines={}] Additional define values
+ * @param {Array} [options.customPlugins=[]] Additional Vite plugins
+ * @param {object} [options.imagetoolsOptions={}] Options for imagetools config
+ * @param {string} [options.packageJsonPath='./package.json'] Path to package.json
+ *
+ * @returns {Promise<object>} Vite configuration object
+ */
+export async function generateViteConfig(options = {}) {
+  const {
+    enableImagetools = true,
+    enableVitest = true,
+    enableSvelteKit = true,
+    customDefines = {},
+    customPlugins = [],
+    imagetoolsOptions = {},
+    packageJsonPath = './package.json'
+  } = options;
+
+  // Read package.json for version
+  const packageJson = JSON.parse(
+    readFileSync(resolve(packageJsonPath), 'utf-8')
+  );
+
+  const plugins = [...customPlugins];
+
+  // Add SvelteKit plugin (provides $lib alias and other SvelteKit features)
+  if (enableSvelteKit) {
+    try {
+      const { sveltekit } = await import('@sveltejs/kit/vite');
+      plugins.push(sveltekit());
+    } catch (error) {
+      console.error(error);
+      console.warn(
+        '@sveltejs/kit/vite not found. Install it to enable SvelteKit support.'
+      );
+    }
+  }
+
+  // Conditionally add imagetools
+  if (enableImagetools) {
+    try {
+      const { imagetools } = await import('vite-imagetools');
+      const { 
+        generateDefaultDirectives, 
+        generateResponseConfigs 
+      } = await import('./imagetools.js');
+
+      plugins.push(
+        imagetools({
+          defaultDirectives: generateDefaultDirectives(imagetoolsOptions),
+          resolveConfigs: generateResponseConfigs(imagetoolsOptions)
+        })
+      );
+    } catch (error) {
+      console.error(error);
+      console.warn(
+        'vite-imagetools not found. Install it to enable imagetools support.'
+      );
+    }
+  }
+
+  const config = {
+    plugins,
+    define: {
+      'import.meta.env.VITE_APP_VERSION': JSON.stringify(packageJson.version),
+      'import.meta.env.VITE_BUILD_TIMESTAMP': JSON.stringify(
+        new Date().toISOString()
+      ),
+      ...customDefines
+    }
+  };
+
+  if (enableVitest) {
+    config.test = {
+      include: [
+        'src/**/*.{test,spec}.{js,ts}',
+        'src/**/*.svelte.{test,spec}.{js,ts}'
+      ]
+    };
+  }
+
+  return config;
+}
+
+/**
+ * Generates build-time defines for Vite
+ *
+ * @param {object} [options] Configuration options
+ * @param {string} [options.packageJsonPath='./package.json'] Path to package.json
+ * @param {object} [options.customDefines={}] Additional define values
+ *
+ * @returns {object} Define configuration object
+ */
+export function generateViteDefines(options = {}) {
+  const {
+    packageJsonPath = './package.json',
+    customDefines = {}
+  } = options;
+
+  const packageJson = JSON.parse(
+    readFileSync(resolve(packageJsonPath), 'utf-8')
+  );
+
+  return {
+    'import.meta.env.VITE_APP_VERSION': JSON.stringify(packageJson.version),
+    'import.meta.env.VITE_BUILD_TIMESTAMP': JSON.stringify(
+      new Date().toISOString()
+    ),
+    ...customDefines
+  };
+}
+
+/**
+ * Generates Vitest configuration
+ *
+ * @param {object} [options] Configuration options
+ * @param {string[]} [options.additionalPatterns=[]] Additional test patterns
+ *
+ * @returns {object} Vitest configuration object
+ */
+export function generateVitestConfig(options = {}) {
+  const { additionalPatterns = [] } = options;
+
+  const defaultPatterns = [
+    'src/**/*.{test,spec}.{js,ts}',
+    'src/**/*.svelte.{test,spec}.{js,ts}'
+  ];
+
+  return {
+    include: [...defaultPatterns, ...additionalPatterns]
+  };
+}

package/dist/config/imagetools.d.ts

@@ -1,72 +1,72 @@
-type ImageMeta = import('../typedef').ImageMeta;
-type ImageSource = import('../typedef').ImageSource;
-
-declare module '*?responsive' {
-  const out: ImageMeta[];
-  export default out;
-}
-
-declare module '*&responsive' {
-  const out: ImageMeta[];
-  export default out;
-}
-
-declare module '*?preset=photo' {
-  const out: ImageSource;
-  export default out;
-}
-
-declare module '*&preset=photo' {
-  const out: ImageSource;
-  export default out;
-}
-
-declare module '*?preset=render' {
-  const out: ImageSource;
-  export default out;
-}
-
-declare module '*&preset=render' {
-  const out: ImageSource;
-  export default out;
-}
-
-declare module '*?preset=gradient' {
-  const out: ImageSource;
-  export default out;
-}
-
-declare module '*&preset=gradient' {
-  const out: ImageSource;
-  export default out;
-}
-
-declare module '*?preset=drawing' {
-  const out: ImageSource;
-  export default out;
-}
-
-declare module '*&preset=drawing' {
-  const out: ImageSource;
-  export default out;
-}
-
-declare module '*?preset=savedata' {
-  const out: ImageSource;
-  export default out;
-}
-
-declare module '*&preset=savedata' {
-  const out: IImageSource;
-  export default out;
-}
-
-declare module '*?preset=blur' {
-  const out: ImageSource;
-  export default out;
-}
-
-declare module '*&preset=blur' {
-  const out: ImageSource;
-  export default out;
-}
+type ImageMeta = import('../network/typedef.js').ImageMeta;
+type ImageSource = import('../network/typedef.js').ImageSource;
+
+declare module '*?responsive' {
+  const out: ImageMeta[];
+  export default out;
+}
+
+declare module '*&responsive' {
+  const out: ImageMeta[];
+  export default out;
+}
+
+declare module '*?preset=photo' {
+  const out: ImageSource;
+  export default out;
+}
+
+declare module '*&preset=photo' {
+  const out: ImageSource;
+  export default out;
+}
+
+declare module '*?preset=render' {
+  const out: ImageSource;
+  export default out;
+}
+
+declare module '*&preset=render' {
+  const out: ImageSource;
+  export default out;
+}
+
+declare module '*?preset=gradient' {
+  const out: ImageSource;
+  export default out;
+}
+
+declare module '*&preset=gradient' {
+  const out: ImageSource;
+  export default out;
+}
+
+declare module '*?preset=drawing' {
+  const out: ImageSource;
+  export default out;
+}
+
+declare module '*&preset=drawing' {
+  const out: ImageSource;
+  export default out;
+}
+
+declare module '*?preset=savedata' {
+  const out: ImageSource;
+  export default out;
+}
+
+declare module '*&preset=savedata' {
+  const out: IImageSource;
+  export default out;
+}
+
+declare module '*?preset=blur' {
+  const out: ImageSource;
+  export default out;
+}
+
+declare module '*&preset=blur' {
+  const out: ImageSource;
+  export default out;
+}

package/dist/config/vite.d.ts

@@ -0,0 +1 @@
+export { generateViteConfig, generateViteDefines, generateVitestConfig } from "./generators/vite.js";

package/dist/config/vite.js

@@ -0,0 +1,5 @@
+export { 
+  generateViteConfig,
+  generateViteDefines,
+  generateVitestConfig
+} from './generators/vite.js';

package/dist/constants/bases/index.js

@@ -1,13 +1,13 @@
-
-/**
- * Characters selected for their visually distinct shapes to improve
- * human readability and reduce confusion.
- */
- export const ALPHABET_BASE_HUMAN = '3456789abcdefghjkmnpqrstuvwxy';
-
-/**
- * Base58 character set: alphanumeric characters excluding similar-looking
- * ones (0, O, I, l) to prevent visual ambiguity.
- */
-export const ALPHABET_BASE_58 =
-  '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+
+/**
+ * Characters selected for their visually distinct shapes to improve
+ * human readability and reduce confusion.
+ */
+ export const ALPHABET_BASE_HUMAN = '3456789abcdefghjkmnpqrstuvwxy';
+
+/**
+ * Base58 character set: alphanumeric characters excluding similar-looking
+ * ones (0, O, I, l) to prevent visual ambiguity.
+ */
+export const ALPHABET_BASE_58 =
+  '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';

package/dist/constants/http/headers.js

@@ -1,6 +1,6 @@
-export const ACCEPT = 'accept';
-export const CONTENT_TYPE = 'content-type';
-export const CONTENT_LENGTH = 'content-length';
-
-export const AUTHORIZATION = 'authorization';
-export const WWW_AUTHENTICATE = 'www-authenticate';
+export const ACCEPT = 'accept';
+export const CONTENT_TYPE = 'content-type';
+export const CONTENT_LENGTH = 'content-length';
+
+export const AUTHORIZATION = 'authorization';
+export const WWW_AUTHENTICATE = 'www-authenticate';

package/dist/constants/http/index.js

@@ -1,2 +1,2 @@
-export * from './headers.js';
-export * from './methods.js';
+export * from './headers.js';
+export * from './methods.js';

package/dist/constants/http/methods.js

@@ -1,14 +1,14 @@
-// Get & Post
-export const METHOD_GET = 'GET';
-export const METHOD_POST = 'POST';
-
-// And the REST
-export const METHOD_PUT = 'PUT';
-export const METHOD_DELETE = 'DELETE';
-export const METHOD_PATCH = 'PATCH';
-
-// Check CORS
-export const METHOD_OPTIONS = 'OPTIONS';
-
-// Head
-export const METHOD_HEAD = 'HEAD';
+// Get & Post
+export const METHOD_GET = 'GET';
+export const METHOD_POST = 'POST';
+
+// And the REST
+export const METHOD_PUT = 'PUT';
+export const METHOD_DELETE = 'DELETE';
+export const METHOD_PATCH = 'PATCH';
+
+// Check CORS
+export const METHOD_OPTIONS = 'OPTIONS';
+
+// Head
+export const METHOD_HEAD = 'HEAD';

package/dist/constants/index.js

@@ -1,6 +1,6 @@
-export * as bases from './bases/index.js';
-export * as http from './http/index.js';
-export * as mime from './mime/index.js';
-export * as regexp from './regexp/index.js';
-export * as states from './states/index.js';
-export * as time from './time/index.js';
+export * as bases from './bases/index.js';
+export * as http from './http/index.js';
+export * as mime from './mime/index.js';
+export * as regexp from './regexp/index.js';
+export * as states from './states/index.js';
+export * as time from './time/index.js';

package/dist/constants/mime/application.js

@@ -1,5 +1,5 @@
-export const APPLICATION_JSON = 'application/json';
-export const APPLICATION_XML = 'application/xml';
-
-// "arbitrary binary data"as defined in RFC 2046
-export const OCTET_STREAM = 'application/octet-stream';
+export const APPLICATION_JSON = 'application/json';
+export const APPLICATION_XML = 'application/xml';
+
+// "arbitrary binary data"as defined in RFC 2046
+export const OCTET_STREAM = 'application/octet-stream';

package/dist/constants/mime/audio.js

@@ -1,13 +1,13 @@
-export const AUDIO_BASIC = 'audio/basic';
-export const AUDIO_MIDI = 'audio/mid';
-export const AUDIO_WAV = 'audio/vnd.wav';
-
-export const AUDIO_MP3 = 'audio/mpeg';
-export const AUDIO_MP4 = 'audio/mp4';
-
-export const AUDIO_AIF = 'audio/x-aiff';
-export const AUDIO_AIFC = 'audio/x-aiff';
-export const AUDIO_AIFF = 'audio/x-aiff';
-
-export const AUDIO_M3U = 'audio/x-mpegurl';
-export const AUDIO_OGG = 'audio/ogg';
+export const AUDIO_BASIC = 'audio/basic';
+export const AUDIO_MIDI = 'audio/mid';
+export const AUDIO_WAV = 'audio/vnd.wav';
+
+export const AUDIO_MP3 = 'audio/mpeg';
+export const AUDIO_MP4 = 'audio/mp4';
+
+export const AUDIO_AIF = 'audio/x-aiff';
+export const AUDIO_AIFC = 'audio/x-aiff';
+export const AUDIO_AIFF = 'audio/x-aiff';
+
+export const AUDIO_M3U = 'audio/x-mpegurl';
+export const AUDIO_OGG = 'audio/ogg';

package/dist/constants/mime/image.js

@@ -1,3 +1,3 @@
-export const IMAGE_PNG = 'image/png';
-export const IMAGE_JPEG = 'image/jpeg';
-export const IMAGE_WEBP = 'image/webp';
+export const IMAGE_PNG = 'image/png';
+export const IMAGE_JPEG = 'image/jpeg';
+export const IMAGE_WEBP = 'image/webp';

package/dist/constants/mime/index.js

@@ -1,4 +1,4 @@
-export * from './application.js';
-export * from './audio.js';
-export * from './text.js';
-export * from './image.js';
+export * from './application.js';
+export * from './audio.js';
+export * from './text.js';
+export * from './image.js';

package/dist/constants/mime/text.js

@@ -1,2 +1,2 @@
-export const TEXT_PLAIN = 'text/plain';
-export const TEXT_HTML = 'text/html';
+export const TEXT_PLAIN = 'text/plain';
+export const TEXT_HTML = 'text/html';

package/dist/constants/regexp/README.md

@@ -0,0 +1,95 @@
+# Regular Expression Constants
+
+This directory contains regular expression patterns and components for validating text, user data, and URL formats.
+
+## Overview
+
+All regular expressions use the `v` flag (Unicode Sets mode) for consistent Unicode support and advanced character class operations.
+
+## Unicode Property Escapes
+
+### Character Types
+
+- **Letter (any language)**: `\p{L}`
+- **Letter (Latin only)**: `\p{Script=Latin}`
+- **Number (any language)**: `\p{N}`
+- **Number (decimal digits only)**: `\p{Nd}` - excludes roman numerals
+
+### Available Constants
+
+From `text.js`:
+- `LLCHAR` - Latin script characters: `\p{Script=Latin}`
+- `NUMBER` - Decimal digits: `\p{Nd}`
+- `LLCHAR_NUMBER` - Combination of Latin characters and numbers
+- `EMOJI` - RGI Emoji: `\p{RGI_Emoji}`
+- `PUNCTUATION` - Punctuation marks: `\p{Punctuation}$+<=>\\^`\\|~`
+
+## Usage Examples
+
+### Basic Usage
+```js
+import { LCHAR, NUMBER } from '$lib/constants/regexp/text.js';
+
+// Use with 'v' flag for Unicode Sets mode
+const re = new RegExp(`^(?:${LCHAR}|${NUMBER})+$`, 'v');
+```
+
+### Character Classes vs Groups
+```js
+// ❌ Don't use Unicode properties in character classes with 'v' flag
+const invalid = new RegExp(`^[${LCHAR}]$`, 'v'); // Error
+
+// ✅ Use non-capturing groups instead
+const valid = new RegExp(`^(?:${LCHAR})$`, 'v'); // Works
+```
+
+## Flag Usage
+
+### The `v` Flag (Unicode Sets Mode)
+- Enables advanced Unicode support
+- Supports set operations: `[A--B]`, `[A&&B]`, `[A||B]`
+- Better emoji and complex Unicode sequence handling
+- Stricter syntax requirements than `u` flag
+
+### RGI Emoji Support
+The `v` flag enables support for "Recommended for General Interchange" emoji, allowing matching of emoji regardless of their internal code point complexity.
+
+```js
+const emojiPattern = new RegExp(`^(?:${EMOJI})$`, 'v');
+emojiPattern.test('😄'); // true
+emojiPattern.test('👨🏾‍⚕️'); // true (complex multi-codepoint emoji)
+```
+
+## File Structure
+
+- `text.js` - Basic Unicode character type constants
+- `user.js` - User data validation patterns (names, usernames, etc.)
+- `url.js` - URL and slug validation patterns
+- `index.js` - Exports all regexp constants
+- `*.test.js` - Test files for each module
+
+## Validation Patterns
+
+### User Data (user.js)
+- `RE_NAME` - Personal names with Latin characters
+- `RE_FULLNAME` - Full names with space separators
+- `RE_SURNAME` - Surnames with optional prefixes
+- `RE_USERNAME` - Usernames with alphanumeric and limited special characters
+- `RE_PHONENUMBER` - Phone number formats
+
+### URL Data (url.js)
+- `URL_SLUG` - URL-safe slugs for paths (e.g., "my-blog-post")
+
+## Browser Support
+
+The `v` flag requires modern browser support:
+- Chrome 112+ (March 2023)
+- Firefox 116+ (August 2023)
+- Safari 17+ (September 2023)
+- Node.js 20+ (April 2023)
+
+## References
+
+- [Unicode Character Properties](https://en.wikipedia.org/wiki/Unicode_character_property#General_Category)
+- [RegExp v flag specification](https://v8.dev/features/regexp-v-flag)
+- [MDN Unicode character class escape](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Unicode_character_class_escape)

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

@@ -1,3 +1,3 @@
 export * from "./text.js";
 export * from "./user.js";
-export * from "./web.js";
+export * from "./url.js";

package/dist/constants/regexp/index.js

@@ -1,31 +1,31 @@
-/**
- * Index file for various regexp categories
- *
- * @note
- * To enable unicode search, use the unicode flag 'u'.
- *
- * \p and \P are only supported in Unicode-aware mode. In Unicode-unaware mode,
- * they are identity escapes for the p or P character.
- *
- * @note
- * To enable unicode symbols that consist of multiple 'code points'(characters),
- * such a some emoji, you must use the flag 'v'.
- *
- * @eg
- * const re = new RegExp('^[${Latin_Number}]', 'u');
- *
- * @eg
- * const re = new RegExp('^[${Symbols_Emoji}]', 'v');
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/
- *      Reference/Regular_expressions/Unicode_character_class_escape
- *
- * @see https://javascript.info/regexp-unicode
- *
- * @see https://v8.dev/features/regexp-v-flag
- *
- * @see https://www.regular-expressions.info/unicode.html
- */
-export * from './text.js';
-export * from './user.js';
-export * from './web.js';
+/**
+ * Index file for various regexp categories
+ *
+ * @note
+ * To enable unicode search, use the unicode flag 'u'.
+ *
+ * \p and \P are only supported in Unicode-aware mode. In Unicode-unaware mode,
+ * they are identity escapes for the p or P character.
+ *
+ * @note
+ * To enable unicode symbols that consist of multiple 'code points'(characters),
+ * such a some emoji, you must use the flag 'v'.
+ *
+ * @eg
+ * const re = new RegExp('^(?:${Latin_Number})', 'v');
+ *
+ * @eg
+ * const re = new RegExp('^[${Symbols_Emoji}]', 'v');
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/
+ *      Reference/Regular_expressions/Unicode_character_class_escape
+ *
+ * @see https://javascript.info/regexp-unicode
+ *
+ * @see https://v8.dev/features/regexp-v-flag
+ *
+ * @see https://www.regular-expressions.info/unicode.html
+ */
+export * from './text.js';
+export * from './user.js';
+export * from './url.js';