@hkdigital/lib-core 0.5.71 → 0.5.73

package/README.md

@@ -303,17 +303,27 @@ pnpm run lint:imports
 node node_modules/@hkdigital/lib-core/scripts/validate-imports.mjs
 ```
 
+**Alias support:**
+
+The validator automatically reads path aliases from your
+`svelte.config.js` and applies the same barrel export validation rules
+to alias imports. This ensures consistent import patterns across:
+- Internal `$lib/` imports
+- Project aliases like `$hklib-core`, `$hklib-pro`, etc.
+- External `@hkdigital/*` package imports
+
 **Validation rules (enforced for `src/lib/` files only):**
 
-1. **Cross-domain imports** - Use `$lib/` instead of `../../../`
-2. **Prefer barrel exports** - Use higher-level export files when available
-3. **Parent index.js imports** - Use `$lib/` or import specific files
-4. **Non-standard extensions** - Include full extension (e.g.,
+1. **Alias optimization** - Use `$lib` instead of `$src/lib` (built-in
+   SvelteKit alias)
+2. **Cross-domain imports** - Use `$lib/` instead of `../../../`
+3. **Prefer barrel exports** - Use higher-level export files when
+   available (applies to `$lib/`, aliases, and `@hkdigital/*` packages)
+4. **Parent index.js imports** - Use `$lib/` or import specific files
+5. **Non-standard extensions** - Include full extension (e.g.,
    `.svelte.js`)
-5. **Directory imports** - Write explicitly or create barrel export file
-6. **File existence** - All import paths must resolve to existing files
-7. **External package optimization** - Suggests barrel exports for
-   `@hkdigital/*` packages
+6. **Directory imports** - Write explicitly or create barrel export file
+7. **File existence** - All import paths must resolve to existing files
 
 **Barrel export preference:**
 
@@ -322,6 +332,10 @@ exports your target. This encourages shorter imports that can be
 combined:
 
 ```js
+// Optimize built-in aliases:
+import { MyComponent } from '$src/lib/ui/components.js';
+// → Use: import { MyComponent } from '$lib/ui/components.js';
+
 // Internal imports - instead of deep imports:
 import ProfileBlocks from '$lib/ui/components/profile-blocks/ProfileBlocks.svelte';
 import Button from '$lib/ui/primitives/buttons/Button.svelte';
@@ -330,6 +344,14 @@ import Button from '$lib/ui/primitives/buttons/Button.svelte';
 import { ProfileBlocks } from '$lib/ui/components.js';
 import { Button } from '$lib/ui/primitives.js';
 
+// Project aliases - instead of deep imports:
+import { Logger } from '$hklib-core/logging/logger/Logger.js';
+import { HttpClient } from '$hklib-core/network/http/HttpClient.js';
+
+// Use barrel exports:
+import { Logger } from '$hklib-core/logging.js';
+import { HttpClient } from '$hklib-core/network/http.js';
+
 // External imports - instead of deep imports:
 import { TextButton } from '@hkdigital/lib-core/ui/primitives/buttons/index.js';
 import { TextInput } from '@hkdigital/lib-core/ui/primitives/inputs/index.js';
@@ -341,7 +363,7 @@ import { TextButton, TextInput } from '@hkdigital/lib-core/ui/primitives.js';
 The validator checks from highest to lowest level (`$lib/ui.js` →
 `$lib/ui/components.js` → `$lib/ui/components/profile-blocks.js`) and
 suggests the highest-level file that exports your target. The same
-logic applies to external `@hkdigital/*` packages.
+logic applies to project aliases and external `@hkdigital/*` packages.
 
 **Routes are exempt from strict rules:**
 
@@ -353,6 +375,17 @@ files.
 **Example output:**
 
 ```
+Validating import paths...
+
+Found project aliases:
+  $src → src
+  $examples → src/routes/examples
+  $hklib-core → src/lib
+
+src/lib/ui/panels/Panel.svelte:3
+  from '$src/lib/ui/components.js'
+  => from '$lib/ui/components.js' (use built-in $lib alias)
+
 src/lib/ui/panels/Panel.svelte:6
   from '../../../components/profile-blocks/ProfileBlocks.svelte'
   => from '$lib/ui/components.js' (use barrel export)
@@ -362,6 +395,10 @@ src/lib/ui/pages/Profile.svelte:8
   => from '$lib/ui/components.js' (use barrel export for shorter imports)
 
 src/lib/forms/LoginForm.svelte:4
+  from '$hklib-core/logging/logger/Logger.js'
+  => from '$hklib-core/logging.js' (use barrel export)
+
+src/lib/forms/LoginForm.svelte:6
   from '@hkdigital/lib-core/ui/primitives/buttons/index.js'
   => from '@hkdigital/lib-core/ui/primitives.js' (use barrel export)
 
@@ -370,9 +407,10 @@ src/routes/explorer/[...path]/+page.svelte:4
   ✅ Allowed in routes
 ```
 
-**What gets checked for external packages:**
+**What gets checked for barrel export suggestions:**
 
-The validator only suggests barrel exports for:
+The validator only suggests barrel exports (for `$lib/`, project aliases,
+and external `@hkdigital/*` packages) for:
 - Explicit `index.js` imports
 - Component files (`.svelte`)
 - Class files (capitalized `.js` files)
@@ -380,6 +418,20 @@ The validator only suggests barrel exports for:
 Intentional imports like `helpers.js`, `config.js`, or other lowercase
 utility files are assumed to be the public API and won't be flagged.
 
+**Alias configuration:**
+
+The validator automatically detects aliases in your `svelte.config.js`.
+For example, if your config has:
+```js
+alias: {
+  $src: 'src',
+  $hklib-core: 'node_modules/@hkdigital/lib-core/dist'
+}
+```
+
+The validator will apply the same barrel export rules to these aliases
+as it does to `$lib/` and `@hkdigital/*` imports.
+
 ### Import Patterns and Export Structure
 
 **Public exports use domain-specific files matching folder names:**

package/dist/ui/components/drag-drop/DragDropContext.svelte

@@ -16,6 +16,7 @@
 
   // Create the state context at this level to ensure all children
   // have access to the same state instance
+  // svelte-ignore state_referenced_locally
   const dragState = createOrGetDragState(contextKey);
 
   /**

package/dist/ui/components/drag-drop/Draggable.svelte

@@ -83,6 +83,7 @@
     ...attrs
   } = $props();
 
+  // svelte-ignore state_referenced_locally
   const dragState = createOrGetDragState(contextKey);
 
   const draggableId = dragState.newDraggableId();

package/dist/ui/components/drag-drop/DropZone.svelte

@@ -84,6 +84,7 @@
     ...attrs
   } = $props();
 
+  // svelte-ignore state_referenced_locally
   const dragState = createOrGetDragState(contextKey);
   const dropZoneId = generateLocalId();
 

package/dist/ui/components/presenter/ImageSlide.svelte

@@ -26,6 +26,7 @@
 
   let show = $state(false);
 
+  // svelte-ignore state_referenced_locally
   let controller = getLoadingController();
 
   async function progressListener(progress, id) {

package/dist/ui/components/tab-bar/HkTabBar.svelte

@@ -54,6 +54,7 @@
 		...attrs
 	} = $props();
 
+	// svelte-ignore state_referenced_locally
 	createOrGetState(contextKey);
 
 	//grid-cols-[repeat({cols},minmax(0,auto))]

package/dist/ui/components/tab-bar/HkTabBarSelector.svelte

@@ -33,6 +33,7 @@
     contextKey
   } = $props();
 
+  // svelte-ignore state_referenced_locally
   const selectorState = createOrGetState(contextKey);
 </script>
 

package/dist/ui/primitives/icons/HkIcon.svelte

@@ -45,23 +45,24 @@
     icon = src?.[theme] ?? src?.['default'] ?? Object.values(src)?.[0];
   });
 
-  if (size !== '100%') {
-    if (size.slice(-1) !== '%') {
+  let normalizedSize = $derived.by(() => {
+    if (size !== '100%' && size.slice(-1) !== '%') {
       try {
-        size = parseInt(size, 10) + 'px';
+        return parseInt(size, 10) + 'px';
       } catch (error) {
-        size = '100%';
+        return '100%';
       }
     }
-  }
+    return size;
+  });
 </script>
 
 <svg
   data-hk-icon
   {...icon?.a}
   xmlns="http://www.w3.org/2000/svg"
-  width={size}
-  height={size}
+  width={normalizedSize}
+  height={normalizedSize}
   class="{base} {classes}"
   {...attrs}
 >

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.5.71",
+	"version": "0.5.73",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"
@@ -78,7 +78,7 @@
 		"./*": "./dist/*"
 	},
 	"dependencies": {
-		"@tailwindcss/postcss": "^4.1.11",
+		"@tailwindcss/postcss": "^4.1.18",
 		"postcss": "^8.5.6"
 	},
 	"peerDependencies": {
@@ -99,45 +99,45 @@
 		"vite-imagetools": "^8.0.0"
 	},
 	"devDependencies": {
-		"@eslint/js": "^9.37.0",
-		"@playwright/test": "^1.56.0",
+		"@eslint/js": "^9.39.2",
+		"@playwright/test": "^1.57.0",
 		"@skeletonlabs/skeleton": "3.1.7",
 		"@skeletonlabs/skeleton-svelte": "1.3.1",
 		"@steeze-ui/heroicons": "^2.4.2",
 		"@sveltejs/adapter-auto": "^6.1.1",
-		"@sveltejs/adapter-node": "^5.4.0",
-		"@sveltejs/kit": "^2.47.0",
-		"@sveltejs/package": "^2.5.4",
-		"@sveltejs/vite-plugin-svelte": "^6.2.1",
+		"@sveltejs/adapter-node": "^5.5.0",
+		"@sveltejs/kit": "^2.49.4",
+		"@sveltejs/package": "^2.5.7",
+		"@sveltejs/vite-plugin-svelte": "^6.2.4",
 		"@tailwindcss/typography": "^0.5.19",
-		"@testing-library/svelte": "^5.2.8",
+		"@testing-library/svelte": "^5.3.1",
 		"@testing-library/user-event": "^14.6.1",
 		"@types/eslint": "^9.6.1",
-		"@types/node": "^24.8.0",
-		"autoprefixer": "^10.4.21",
-		"eslint": "^9.37.0",
+		"@types/node": "^24.10.8",
+		"autoprefixer": "^10.4.23",
+		"eslint": "^9.39.2",
 		"eslint-config-prettier": "^10.1.8",
 		"eslint-plugin-import": "^2.32.0",
-		"eslint-plugin-svelte": "^3.12.4",
-		"fake-indexeddb": "^6.2.3",
-		"globals": "^16.4.0",
+		"eslint-plugin-svelte": "^3.14.0",
+		"fake-indexeddb": "^6.2.5",
+		"globals": "^16.5.0",
 		"jsdom": "^26.1.0",
-		"jsonwebtoken": "^9.0.2",
+		"jsonwebtoken": "^9.0.3",
 		"npm-check-updates": "^18.3.1",
 		"npm-run-all": "^4.1.5",
-		"pino": "^9.13.1",
-		"pino-pretty": "^13.1.2",
-		"prettier": "^3.6.2",
-		"prettier-plugin-svelte": "^3.4.0",
+		"pino": "^9.14.0",
+		"pino-pretty": "^13.1.3",
+		"prettier": "^3.7.4",
+		"prettier-plugin-svelte": "^3.4.1",
 		"prettier-plugin-tailwindcss": "^0.6.14",
-		"publint": "^0.3.14",
+		"publint": "^0.3.16",
 		"standardized-audio-context-mock": "^9.7.24",
-		"svelte": "^5.40.1",
-		"svelte-check": "^4.3.3",
+		"svelte": "^5.46.3",
+		"svelte-check": "^4.3.5",
 		"svelte-preprocess": "^6.0.3",
-		"tailwindcss": "^4.1.14",
+		"tailwindcss": "^4.1.18",
 		"typescript": "^5.9.3",
-		"vite": "^7.1.10",
+		"vite": "^7.3.1",
 		"vite-imagetools": "^8.0.0",
 		"vitest": "^3.2.4"
 	}

package/scripts/validate-imports.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import { readdir, readFile, stat } from 'node:fs/promises';
-import { join, relative, resolve, dirname } from 'node:path';
+import { join, relative, resolve, dirname, isAbsolute } from 'node:path';
 
 const PROJECT_ROOT = process.cwd();
 const SRC_DIR = join(PROJECT_ROOT, 'src');
@@ -55,6 +55,12 @@ function resolveAliasPath(aliasPath) {
   for (const [alias, target] of Object.entries(PROJECT_ALIASES)) {
     if (aliasPath === alias || aliasPath.startsWith(alias + '/')) {
       const pathAfterAlias = aliasPath.slice(alias.length);
+
+      // If target is already absolute, use it directly
+      if (isAbsolute(target)) {
+        return join(target, pathAfterAlias);
+      }
+
       return join(PROJECT_ROOT, target, pathAfterAlias);
     }
   }
@@ -498,7 +504,22 @@ async function validateFile(filePath) {
     const importPathRaw = importMatch[1];
 
     // Strip query parameters (Vite asset imports like ?preset=render)
-    const importPath = importPathRaw.split('?')[0];
+    let importPath = importPathRaw.split('?')[0];
+
+    // Check if using $src/lib when $lib is available (built-in SvelteKit)
+    // Report the issue and normalize the path for further validation
+    let hasSrcLibIssue = false;
+    if (importPath.startsWith('$src/lib/') || importPath === '$src/lib') {
+      hasSrcLibIssue = true;
+      const optimizedPath = importPath.replace('$src/lib', '$lib');
+      errors.push(
+        `${relativePath}:${lineNum}\n` +
+        `  from '${importPath}'\n` +
+        `  => from '${optimizedPath}' (use built-in $lib alias)`
+      );
+      // Normalize for further validation
+      importPath = optimizedPath;
+    }
 
     // Check if import uses a project alias
     const isAliasImport = Object.keys(PROJECT_ALIASES).some(
@@ -874,7 +895,14 @@ async function validateFile(filePath) {
  * Main validation function
  */
 async function main() {
-  console.log('Validating import paths...\n');
+  // Load package version
+  const pkgJsonPath = join(PROJECT_ROOT, 'package.json');
+  const pkgJsonContent = await readFile(pkgJsonPath, 'utf-8');
+  const pkgJson = JSON.parse(pkgJsonContent);
+  console.log(
+    `@hkdigital/lib-core v${pkgJson.version} - ` +
+    `Validating import paths...\n`
+  );
 
   // Load project aliases from svelte.config.js
   PROJECT_ALIASES = await loadAliases();
@@ -902,7 +930,7 @@ async function main() {
     process.exit(1);
   }
 
-  console.log('✅ All import paths are valid!');
+  console.log('\x1b[32m✔ All import paths are valid!\x1b[0m');
 }
 
 main().catch(error => {