@hkdigital/lib-core 0.5.62 → 0.5.65

package/dist/browser/navigation/navigation.svelte.js

@@ -1,6 +1,6 @@
 import { onMount } from 'svelte';
 
-import { lazySingleton } from '../../util/singleton/index.js';
+import { lazySingleton } from '../../util/singleton.js';
 
 import { beforeNavigate, onNavigate, afterNavigate } from '$app/navigation';
 

package/dist/generic/data/classes/IterableTree.js

@@ -2,7 +2,7 @@
 
 import * as expect from '../../../util/expect.js';
 
-import { PATH_SEPARATOR } from '../../../util/object/index.js';
+import { PATH_SEPARATOR } from '../../../util/object.js';
 
 /* ------------------------------------------------------------------ Typedef */
 

package/dist/generic/promises/classes/HkPromise.js

@@ -36,7 +36,7 @@
 
 import * as expect from '../../../util/expect.js';
 
-import { noop } from '../../../util/function/index.js';
+import { noop } from '../../../util/function.js';
 
 import { PromiseError } from '../../errors.js';
 

package/dist/logging/client.d.ts

@@ -1,3 +1,3 @@
 export { createClientLogger } from "./internal/factories/client.js";
-export { Logger } from "./internal/logger/index.js";
+export { default as Logger } from "./internal/logger/Logger.js";
 export * from "./levels.js";

package/dist/logging/client.js

@@ -2,7 +2,7 @@
 export { createClientLogger } from './internal/factories/client.js';
 
 // Logger (for advanced usage)
-export { Logger } from './internal/logger/index.js';
+export { default as Logger } from './internal/logger/Logger.js';
 
 export * from './levels.js';
 

package/dist/logging/common.d.ts

@@ -1,2 +1,2 @@
 export * from "./levels.js";
-export { Logger } from "./internal/logger/index.js";
+export { default as Logger } from "./internal/logger/Logger.js";

package/dist/logging/common.js

@@ -2,4 +2,4 @@
 export * from './levels.js';
 
 // Logger (for advanced usage)
-export { Logger } from './internal/logger/index.js';
+export { default as Logger } from './internal/logger/Logger.js';

package/dist/logging/internal/factories/client.d.ts

@@ -11,4 +11,4 @@
  * @returns {Logger} Configured logger instance
  */
 export function createClientLogger(name: string, level: import("../../typedef.js").LogLevel, consoleOptions?: Object): Logger;
-import { Logger } from '../logger/index.js';
+import { Logger } from '../logger.js';

package/dist/logging/internal/factories/client.js

@@ -1,4 +1,4 @@
-import { Logger } from '../logger/index.js';
+import { Logger } from '../logger.js';
 import { ConsoleAdapter } from '../adapters/console.js';
 import { DEBUG, LOG, LEVELS } from '../../levels.js';
 

package/dist/logging/internal/factories/server.d.ts

@@ -11,4 +11,4 @@
  * @returns {Logger} Configured logger instance
  */
 export function createServerLogger(name: string, level: import("../../typedef.js").LogLevel, pinoOptions?: Object): Logger;
-import { Logger } from '../logger/index.js';
+import { Logger } from '../logger.js';

package/dist/logging/internal/factories/server.js

@@ -1,4 +1,4 @@
-import { Logger } from '../logger/index.js';
+import { Logger } from '../logger.js';
 import { PinoAdapter } from '../adapters/pino.js';
 import { LOG, LEVELS } from '../../levels.js';
 

package/dist/logging/internal/logger.d.ts

@@ -0,0 +1 @@
+export { default as Logger } from "./logger/Logger.js";

package/dist/logging/internal/logger.js

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

package/dist/logging/server.d.ts

@@ -1,3 +1,3 @@
 export { createServerLogger } from "./internal/factories/server.js";
-export { Logger } from "./internal/logger/index.js";
+export { default as Logger } from "./internal/logger/Logger.js";
 export * from "./levels.js";

package/dist/logging/server.js

@@ -2,6 +2,6 @@
 export { createServerLogger } from './internal/factories/server.js';
 
 // Logger (for advanced usage)
-export { Logger } from './internal/logger/index.js';
+export { default as Logger } from './internal/logger/Logger.js';
 
 export * from './levels.js';

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

@@ -1,5 +1,5 @@
 <script>
-  import { ImageBox } from '../index.js';
+  import { ImageBox } from '../../components.js';
 
   /**
    * @type {{

package/dist/ui/components/rows/panel-row-2/PanelRow2.svelte

@@ -1,5 +1,5 @@
 <script>
-  import { PanelGridRow } from '../index.js';
+  import PanelGridRow from '../panel-grid-row/PanelGridRow.svelte';
 
   /**
    * @example

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

@@ -6,7 +6,7 @@
 	 * @see https://next.skeleton.dev/docs/resources/contribute/components
 	 */
 
-	import { createOrGetState } from './HkTabBar.state.svelte';
+	import { createOrGetState } from './HkTabBar.state.svelte.js';
 
 	import { HkGridArea } from '../../primitives.js';
 

package/dist/ui/primitives/area.d.ts

@@ -0,0 +1,2 @@
+export { default as HkArea } from "./area//HkArea.svelte";
+export { default as HkGridArea } from "./area/HkGridArea.svelte";

package/dist/ui/primitives/area.js

@@ -0,0 +1,2 @@
+export { default as HkArea } from './area//HkArea.svelte';
+export { default as HkGridArea } from './area/HkGridArea.svelte';

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

@@ -10,7 +10,7 @@
 
 	import { onMount } from 'svelte';
 
-	import { HkGridArea } from '../area';
+	import { HkGridArea } from '../area.js';
 
 	import HkIcon from './HkIcon.svelte';
 

package/dist/ui/primitives/icons/index.d.ts

@@ -1,4 +1,3 @@
 export { default as HkIcon } from "./HkIcon.svelte";
 export { default as HkTabIcon } from "./HkTabIcon.svelte";
 export { default as SteezeIcon } from "./SteezeIcon.svelte";
-export * from "./typedef.js";

package/dist/ui/primitives/icons/index.js

@@ -2,5 +2,3 @@ export { default as HkIcon } from './HkIcon.svelte';
 export { default as HkTabIcon } from './HkTabIcon.svelte';
 
 export { default as SteezeIcon } from './SteezeIcon.svelte';
-
-export * from './typedef.js';

package/dist/util/array/index.js

@@ -2,9 +2,9 @@
 
 import * as expect from '../expect.js';
 
-import { smallestFirst, largestFirst } from '../compare/index.js';
+import { smallestFirst, largestFirst } from '../compare.js';
 
-import { objectGet, PATH_SEPARATOR } from '../object/index.js';
+import { objectGet, PATH_SEPARATOR } from '../object.js';
 
 import { Selector } from '../../generic/data.js';
 

package/dist/util/compare/index.js

@@ -1,6 +1,6 @@
 /* ------------------------------------------------------------------ Imports */
 
-import { objectGet } from '../object/index.js';
+import { objectGet } from '../object.js';
 
 /* ------------------------------------------------------------------ Exports */
 

package/dist/util/expect/compounds.js

@@ -1,5 +1,5 @@
 import * as v from 'valibot';
-import * as is from '../is/index.js';
+import * as is from '../is.js';
 
 /** Compound validators - combinations and unions of basic validators */
 

package/dist/util/expect/objects.js

@@ -1,5 +1,5 @@
 import * as v from 'valibot';
-import * as is from '../is/index.js';
+import * as is from '../is.js';
 
 /** Internals */
 

package/dist/util/iterate/index.js

@@ -1,7 +1,7 @@
 /* ------------------------------------------------------------------ Imports */
 
 import * as expect from '../expect.js';
-import { smallestFirst, largestFirst } from '../compare/index.js';
+import { smallestFirst, largestFirst } from '../compare.js';
 
 import { IterableTree } from '../../generic/data.js';
 

package/dist/util/object/index.js

@@ -2,15 +2,15 @@
 
 import * as expect from '../expect.js';
 
-import { equals } from '../compare/index.js';
+import { equals } from '../compare.js';
 
-import { toArrayPath } from '../array/index.js';
+import { toArrayPath } from '../array.js';
 
 import { toStringPath } from '../string.js';
 
-import * as is from '../is/index.js';
+import * as is from '../is.js';
 
-import { iterateObjectPaths, iterateObjectEntries } from '../iterate/index.js';
+import { iterateObjectPaths, iterateObjectEntries } from '../iterate.js';
 
 // ------------------------------------------------------------------- Internals
 

package/dist/util/string/interpolate.js

@@ -2,7 +2,7 @@ import * as expect from '../expect.js';
 
 import { toArrayPath } from '../array/index.js';
 
-import { objectGet, PATH_SEPARATOR } from '../object/index.js';
+import { objectGet, PATH_SEPARATOR } from '../object.js';
 
 export const RE_JS_EXPRESSION = /\$\{([^${}]*)\}/g;
 export const RE_MUSTACHE = /\{\{([^{}]*)\}\}/g;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.5.62",
+	"version": "0.5.65",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"
@@ -41,11 +41,13 @@
 		"cache:clear": "rm -rf node_modules/.cache/imagetools",
 		"lint:prettier": "prettier --check .",
 		"lint:eslint": "eslint .",
+		"lint:imports": "node scripts/validate-imports.mjs",
 		"test:unit": "vitest",
 		"test:unit-run": "pnpm run test:unit -- --run",
 		"prepack:sync": "svelte-kit sync",
 		"prepack:build": "svelte-package",
 		"prepack:lint": "publint",
+		"prepack:imports": "node scripts/validate-imports.mjs",
 		"publish:npm:version": "npm version patch",
 		"publish:npm:publish": "npm publish --access public",
 		"upgrade:hk:update": "ncu --dep dev,optional,peer,prod '@hkdigital/*' -u",
@@ -54,6 +56,7 @@
 	},
 	"files": [
 		"dist",
+		"scripts",
 		"CLAUDE.md",
 		"!dist/**/*.test.*",
 		"!dist/**/*.spec.*",
@@ -102,6 +105,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",

package/scripts/README.md

@@ -0,0 +1,279 @@
+# Import Path Validation
+
+This directory contains validation scripts for enforcing consistent
+import path conventions across the project.
+
+## Overview
+
+The `validate-imports.mjs` script checks all JavaScript and Svelte
+files to ensure imports follow project conventions. These rules align
+with how Node.js and Vite resolve modules, ensuring code works both
+during development and when published as a package.
+
+## Running the Linter
+
+```bash
+# Run validation
+node scripts/validate-imports.mjs
+
+# Add to package.json scripts
+{
+  "scripts": {
+    "lint:imports": "node scripts/validate-imports.mjs"
+  }
+}
+```
+
+## Import Rules Summary
+
+1. **No cross-domain relative imports** - Use `$lib/` for 3+ levels up
+2. **Write index.js explicitly** - Don't rely on implicit directory
+   resolution (except in test files)
+3. **Standard extensions optional** - `.js` and `.svelte` can be
+   omitted
+4. **Non-standard extensions required** - `.svelte.js`, `.test.js`,
+   etc. must be explicit
+5. **Import paths must exist** - All imports must resolve to actual
+   files
+
+## Import Rules
+
+### Rule 1: No cross-domain relative imports
+
+**Don't navigate up 3+ levels with relative paths**
+
+When importing from a different domain (different main folder under
+`src/lib/`), use `$lib/` imports instead of long relative paths.
+
+❌ Bad:
+```javascript
+// In src/lib/ui/components/MyComponent.svelte
+import { http } from '../../../network/http.js';
+```
+
+✅ Good:
+```javascript
+// In src/lib/ui/components/MyComponent.svelte
+import { http } from '$lib/network/http.js';
+```
+
+**Why:** Makes imports clearer, easier to refactor, and independent of
+file location.
+
+### Rule 2: Write index.js explicitly (except same-directory)
+
+**If importing from a directory, write the index.js explicitly**
+
+When a directory contains an `index.js` file, don't rely on implicit
+resolution - write it explicitly.
+
+❌ Bad:
+```javascript
+// When src/lib/ui/primitives/ has index.js
+import { Button } from '$lib/ui/primitives';
+import { Card } from '../components/cards';
+```
+
+✅ Good:
+```javascript
+import { Button } from '$lib/ui/primitives/index.js';
+import { Card } from '../components/cards/index.js';
+```
+
+✅ Exception - same-directory imports allowed:
+```javascript
+// In drag-drop/DropZoneArea.svelte
+import { DropZone } from './index.js';  // OK - sibling file
+```
+
+✅ Exception - test files can import from index.js:
+```javascript
+// In *.test.js or *.spec.js files
+import { helper } from './index.js';  // OK in tests
+```
+
+**Why:**
+- Makes it explicit that you're importing from a re-export file
+- Same-directory imports are allowed for module cohesion (files
+  within the same module can use their local index.js)
+- Parent navigation (`../index.js`) should use cross-domain imports
+  or specific files instead
+
+### Rule 3: Standard extensions are optional
+
+**Standard extensions (.js, .svelte) can be omitted**
+
+Both `$lib/` and relative imports can omit `.js` and `.svelte`
+extensions. Vite and Node.js will resolve them correctly.
+
+✅ All valid:
+```javascript
+// File exists at src/lib/util/array.js
+import { arraySlice } from '$lib/util/array';
+import { arraySlice } from '$lib/util/array.js';
+
+// File exists at ./components/Button.svelte
+import Button from './components/Button';
+import Button from './components/Button.svelte';
+```
+
+**Why:** Vite and Node.js automatically resolve extensions, so
+requiring them is unnecessary for internal code.
+
+### Rule 4: Non-standard extensions must be explicit
+
+**Files with non-standard extensions require the full extension**
+
+Non-standard extensions like `.svelte.js`, `.test.js`, or `.spec.js`
+are not automatically resolved by module loaders, so they must be
+written explicitly in imports.
+
+❌ Bad:
+```javascript
+// File is MyComponent.state.svelte.js
+import { state } from './MyComponent.state.svelte';
+import { state } from './MyComponent.state';
+```
+
+✅ Good:
+```javascript
+// File is MyComponent.state.svelte.js
+import { state } from './MyComponent.state.svelte.js';
+```
+
+**Why:** Module resolution only tries standard extensions (.js,
+.svelte). Non-standard compound extensions won't be found
+automatically and will cause import errors.
+
+### Rule 5: Import paths must exist
+
+**All import paths must resolve to actual files**
+
+The linter verifies that every internal import (`$lib/`, `./`, `../`)
+points to a file that exists on the filesystem. This catches typos,
+moved/deleted files, and incorrect paths early.
+
+❌ Bad:
+```javascript
+// File doesn't exist
+import { helper } from './utlis.js';  // Typo: should be "utils"
+import Button from '$lib/ui/Buttton.svelte';  // Typo in filename
+import { old } from './deleted-file.js';  // File was removed
+```
+
+✅ Good:
+```javascript
+// All files exist
+import { helper } from './utils.js';
+import Button from '$lib/ui/Button.svelte';
+import { current } from './existing-file.js';
+```
+
+**Special handling:**
+- **Query parameters**: Vite asset imports with query strings (e.g.,
+  `'./image.jpg?preset=render'`) are supported - the query string is
+  stripped before checking file existence
+- **Resolution order**: Follows Node.js/Vite resolution (tries `.js`,
+  `.svelte`, `.svelte.js`, `/index.js` for extensionless imports)
+
+**Why:** Catches broken imports immediately instead of discovering
+them at build time or runtime. Helps prevent errors when refactoring
+or moving files.
+
+## How Module Resolution Works
+
+Understanding how Node.js and Vite resolve imports helps explain
+these rules:
+
+### Resolution order for `import { x } from './foo'`
+
+1. Try `./foo` (exact match)
+2. Try `./foo.js`
+3. Try `./foo.svelte`
+4. Try `./foo/index.js`
+5. Try `./foo/index.svelte`
+
+### Examples
+
+```javascript
+// Import: from './components/things'
+// Resolution:
+//   1. ./components/things (not found)
+//   2. ./components/things.js (✓ found!) → uses this file
+//   3. Never checks ./components/things/index.js
+
+// Import: from './components/cards'
+// Resolution:
+//   1. ./components/cards (not found)
+//   2. ./components/cards.js (not found)
+//   3. ./components/cards.svelte (not found)
+//   4. ./components/cards/index.js (✓ found!) → uses this file
+//      → Should write './components/cards/index.js' explicitly
+```
+
+## Directory imports vs file imports
+
+The linter follows Node.js/Vite resolution order and only flags
+directory imports when they actually resolve to a directory's
+index.js:
+
+✅ No warning - imports a file:
+```javascript
+// src/lib/util/array.js exists (file)
+import { arraySlice } from '$lib/util/array';
+```
+
+⚠️ Warning - imports a directory's index.js:
+```javascript
+// src/lib/ui/primitives/ directory with index.js
+import { Button } from '$lib/ui/primitives';
+// Should be: from '$lib/ui/primitives/index.js'
+```
+
+### Edge case: file and directory with same name
+
+When both a file and directory exist with the same base name, the
+file is always resolved first:
+
+```javascript
+// src/lib/util/env.js (file) exists
+// src/lib/util/env/index.js (directory) also exists
+import { isTestEnv } from '$lib/util/env';
+// ✅ Resolves to env.js, no warning
+```
+
+The linter correctly follows this resolution order.
+
+## Test file exceptions
+
+Test files (*.test.js, *.spec.js) are exempt from Rule 2 because
+they test the public API. It's natural for tests to import from
+`./index.js` alongside the code being tested.
+
+```javascript
+// In Button.test.js
+import { Button } from './index.js';  // ✅ OK in test files
+```
+
+## External package imports
+
+The linter only checks internal imports (`$lib/`, `./`, `../`).
+External package imports are not validated:
+
+```javascript
+import { derived } from 'svelte/store';  // Not checked
+import { v } from 'valibot';             // Not checked
+```
+
+## Implementation details
+
+The validator:
+1. Scans all `.js` and `.svelte` files in `src/`
+2. Parses import statements using regex
+3. Resolves paths to filesystem locations
+4. Checks if directories contain `index.js` files
+5. Reports violations with file:line references
+
+Exit codes:
+- `0` - All imports valid
+- `1` - Violations found or script error

package/scripts/import-fixes.txt

@@ -0,0 +1,60 @@
+src/lib/ui/components/rows/panel-row-2/PanelRow2.svelte:2 - Parent index.js import (use $lib/ or import specific file)
+  import { PanelGridRow } from '../index.js';
+  import { PanelGridRow } from '../index.js'; // TODO: Import specific file or refactor
+
+src/lib/ui/components/tab-bar/HkTabBar.svelte:9 - Missing non-standard extension (use './HkTabBar.state.svelte.js')
+	import { createOrGetState } from './HkTabBar.state.svelte';
+	import { createOrGetState } from './HkTabBar.state.svelte.js';
+
+src/lib/ui/primitives/icons/HkTabIcon.svelte:13 - Directory import (write explicitly: '../area/index.js')
+	import { HkGridArea } from '../area';
+	import { HkGridArea } from '../area/index.js';
+
+src/lib/util/array/index.js:5 - Parent index.js import (use $lib/ or import specific file)
+import { smallestFirst, largestFirst } from '../compare/index.js';
+import { smallestFirst, largestFirst } from '../compare.js';
+
+src/lib/util/array/index.js:7 - Parent index.js import (use $lib/ or import specific file)
+import { objectGet, PATH_SEPARATOR } from '../object/index.js';
+import { objectGet, PATH_SEPARATOR } from '../object.js';
+
+src/lib/util/compare/index.js:3 - Parent index.js import (use $lib/ or import specific file)
+import { objectGet } from '../object/index.js';
+import { objectGet } from '../object.js';
+
+src/lib/util/expect/compounds.js:2 - Parent index.js import (use $lib/ or import specific file)
+import * as is from '../is/index.js';
+import * as is from '../is.js';
+
+src/lib/util/expect/objects.js:2 - Parent index.js import (use $lib/ or import specific file)
+import * as is from '../is/index.js';
+import * as is from '../is.js';
+
+src/lib/util/iterate/index.js:4 - Parent index.js import (use $lib/ or import specific file)
+import { smallestFirst, largestFirst } from '../compare/index.js';
+import { smallestFirst, largestFirst } from '../compare.js';
+
+src/lib/util/object/index.js:5 - Parent index.js import (use $lib/ or import specific file)
+import { equals } from '../compare/index.js';
+import { equals } from '../compare.js';
+
+src/lib/util/object/index.js:7 - Parent index.js import (use $lib/ or import specific file)
+import { toArrayPath } from '../array/index.js';
+import { toArrayPath } from '../array.js';
+
+src/lib/util/object/index.js:11 - Parent index.js import (use $lib/ or import specific file)
+import * as is from '../is/index.js';
+import * as is from '../is.js';
+
+src/lib/util/object/index.js:13 - Parent index.js import (use $lib/ or import specific file)
+import { iterateObjectPaths, iterateObjectEntries } from '../iterate/index.js';
+import { iterateObjectPaths, iterateObjectEntries } from '../iterate.js';
+
+src/lib/util/string/interpolate.js:5 - Parent index.js import (use $lib/ or import specific file)
+import { objectGet, PATH_SEPARATOR } from '../object/index.js';
+import { objectGet, PATH_SEPARATOR } from '../object.js';
+
+src/routes/explorer/[...path]/+page.svelte:4 - Parent index.js import (use $lib/ or import specific file)
+  import { TopBar, Explorer } from '../components/index.js';
+  import { TopBar, Explorer } from '../components.js';
+

package/scripts/validate-imports.mjs

@@ -0,0 +1,375 @@
+#!/usr/bin/env node
+
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, relative, resolve, dirname } from 'node:path';
+
+const PROJECT_ROOT = process.cwd();
+const SRC_DIR = join(PROJECT_ROOT, 'src');
+
+/**
+ * Find all JS and Svelte files recursively
+ *
+ * @param {string} dir - Directory to search
+ *
+ * @returns {Promise<string[]>} Array of file paths
+ */
+async function findFiles(dir) {
+  const files = [];
+  const entries = await readdir(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name !== 'node_modules' && entry.name !== '.svelte-kit') {
+        files.push(...await findFiles(fullPath));
+      }
+    } else if (entry.name.endsWith('.js') || entry.name.endsWith('.svelte')) {
+      files.push(fullPath);
+    }
+  }
+
+  return files;
+}
+
+/**
+ * Check if import path resolves to directory with index.js
+ *
+ * Follows Node.js/Vite resolution order:
+ * 1. Check for file with .js extension
+ * 2. Check for file with .svelte extension
+ * 3. Check for directory with index.js
+ *
+ * @param {string} fsPath - Filesystem path to check (without extension)
+ *
+ * @returns {Promise<boolean>} True if resolves to directory with index.js
+ */
+async function isDirectoryWithIndex(fsPath) {
+  // First check if a file exists (files resolve before directories)
+  try {
+    const jsStats = await stat(fsPath + '.js');
+    if (jsStats.isFile()) {
+      return false; // Resolves to file, not directory
+    }
+  } catch {
+    // .js file doesn't exist, continue checking
+  }
+
+  try {
+    const svelteStats = await stat(fsPath + '.svelte');
+    if (svelteStats.isFile()) {
+      return false; // Resolves to file, not directory
+    }
+  } catch {
+    // .svelte file doesn't exist, continue checking
+  }
+
+  // Now check if it's a directory with index.js
+  try {
+    const dirStats = await stat(fsPath);
+    if (dirStats.isDirectory()) {
+      try {
+        await stat(join(fsPath, 'index.js'));
+        return true; // Directory with index.js
+      } catch {
+        return false; // Directory but no index.js
+      }
+    }
+  } catch {
+    // Path doesn't exist at all
+  }
+
+  return false;
+}
+
+/**
+ * Validate import paths in a file
+ *
+ * @param {string} filePath - Path to the file
+ *
+ * @returns {Promise<string[]>} Array of error messages
+ */
+async function validateFile(filePath) {
+  const content = await readFile(filePath, 'utf-8');
+  const errors = [];
+  const relativePath = relative(PROJECT_ROOT, filePath);
+  const isTestFile = filePath.endsWith('.test.js') ||
+    filePath.endsWith('.spec.js');
+
+  // Check each line for import statements
+  const lines = content.split('\n');
+  for (let index = 0; index < lines.length; index++) {
+    const line = lines[index];
+    const lineNum = index + 1;
+
+    // Skip if not an import line
+    if (!line.trim().startsWith('import ')) {
+      continue;
+    }
+
+    // Extract import path from line
+    const importMatch = line.match(/from ['"]([^'"]+)['"]/);
+    if (!importMatch) {
+      continue;
+    }
+
+    const importPathRaw = importMatch[1];
+
+    // Strip query parameters (Vite asset imports like ?preset=render)
+    const importPath = importPathRaw.split('?')[0];
+
+    // Skip external packages (no ./ or $lib prefix)
+    if (!importPath.startsWith('./') &&
+        !importPath.startsWith('../') &&
+        !importPath.startsWith('$lib/')) {
+      continue;
+    }
+
+    // Check 1: Cross-domain relative imports (3+ levels up)
+    if (importPath.match(/^\.\.\/\.\.\/\.\.\//)) {
+      errors.push(
+        `${relativePath}:${lineNum} - Cross-domain relative import ` +
+        `(use $lib/ instead)`
+      );
+      continue;
+    }
+
+    // Check 2: Local index.js imports (skip for test files)
+    // Allow ./index.js and ./subfolder/index.js but flag parent navigation
+    if (!isTestFile && importPath.match(/\/index\.js$/)) {
+      // Allow same-directory and child directory imports
+      // Examples: ./index.js, ./subfolder/index.js, ./(meta)/index.js
+      // Flag parent navigation: ../index.js, ../../index.js
+      const isParentNavigation = importPath.match(/^\.\..*\/index\.js$/);
+
+      if (isParentNavigation) {
+        errors.push(
+          `${relativePath}:${lineNum} - Parent index.js import ` +
+          `(use $lib/ or import specific file)`
+        );
+        continue;
+      }
+    }
+
+    // Resolve to filesystem path
+    let fsPath;
+    if (importPath.startsWith('$lib/')) {
+      fsPath = join(PROJECT_ROOT, importPath.replace('$lib/', 'src/lib/'));
+    } else {
+      fsPath = resolve(dirname(filePath), importPath);
+    }
+
+    // Check 3: Non-standard extensions (must be explicit)
+    // Files like .svelte.js need full extension in import
+    // Examples:
+    //   import './Button.svelte' when Button.svelte.js exists → error
+    //   import './Button' when Button.svelte.js exists → error
+    //   import './Button.svelte.js' → correct!
+
+    const hasFullNonStandardExt = importPath.match(/\.(svelte\.js|test\.js|spec\.js)$/);
+
+    if (!hasFullNonStandardExt) {
+      // First check if file resolves with standard extension
+      let fileExistsWithStandardExt = false;
+
+      // Check .js
+      if (importPath.endsWith('.js')) {
+        try {
+          const stats = await stat(fsPath);
+          if (stats.isFile()) {
+            fileExistsWithStandardExt = true;
+          }
+        } catch {
+          // Doesn't exist
+        }
+      }
+
+      // Check .svelte
+      if (!fileExistsWithStandardExt && importPath.endsWith('.svelte')) {
+        try {
+          const stats = await stat(fsPath);
+          if (stats.isFile()) {
+            fileExistsWithStandardExt = true;
+          }
+        } catch {
+          // Doesn't exist
+        }
+      }
+
+      // Check implicit .js (no extension in import)
+      if (!fileExistsWithStandardExt &&
+          !importPath.endsWith('.js') &&
+          !importPath.endsWith('.svelte')) {
+        try {
+          const stats = await stat(fsPath + '.js');
+          if (stats.isFile()) {
+            fileExistsWithStandardExt = true;
+          }
+        } catch {
+          // Doesn't exist
+        }
+      }
+
+      // Check implicit .svelte (no extension in import)
+      if (!fileExistsWithStandardExt &&
+          !importPath.endsWith('.js') &&
+          !importPath.endsWith('.svelte')) {
+        try {
+          const stats = await stat(fsPath + '.svelte');
+          if (stats.isFile()) {
+            fileExistsWithStandardExt = true;
+          }
+        } catch {
+          // Doesn't exist
+        }
+      }
+
+      // Only check for non-standard extensions if standard doesn't exist
+      if (!fileExistsWithStandardExt) {
+        // Remove any standard extension from import path
+        const baseImportPath = importPath
+          .replace(/\.js$/, '')
+          .replace(/\.svelte$/, '');
+
+        let baseFsPath;
+        if (baseImportPath.startsWith('$lib/')) {
+          baseFsPath = join(
+            PROJECT_ROOT,
+            baseImportPath.replace('$lib/', 'src/lib/')
+          );
+        } else if (baseImportPath.startsWith('./') ||
+          baseImportPath.startsWith('../')) {
+          baseFsPath = resolve(dirname(filePath), baseImportPath);
+        } else {
+          baseFsPath = fsPath;
+        }
+
+        // Check for files with non-standard extensions
+        const nonStandardExts = ['.svelte.js', '.test.js', '.spec.js'];
+        let foundNonStandard = false;
+
+        for (const ext of nonStandardExts) {
+          try {
+            const testPath = baseFsPath + ext;
+            const stats = await stat(testPath);
+            if (stats.isFile()) {
+              const correctImport = baseImportPath + ext;
+              errors.push(
+                `${relativePath}:${lineNum} - Missing non-standard ` +
+                `extension (use '${correctImport}')`
+              );
+              foundNonStandard = true;
+              break;
+            }
+          } catch {
+            // File doesn't exist with this extension, continue checking
+          }
+        }
+
+        // Skip remaining checks if we found a non-standard extension issue
+        if (foundNonStandard) {
+          continue;
+        }
+      }
+    }
+
+    // Check 4: Directory imports (when directory has index.js)
+    // Only check if import doesn't have extension (extensionless imports)
+    const hasAnyExtension = importPath.match(/\.(js|svelte)$/) ||
+      importPath.match(/\.(svelte\.js|test\.js|spec\.js)$/);
+
+    if (!hasAnyExtension) {
+      // Check if it's a directory with index.js
+      if (await isDirectoryWithIndex(fsPath)) {
+        // Don't suggest ../path/index.js (parent navigation)
+        // Suggest creating export file instead
+        const wouldBeParentNavigation = importPath.match(/^\.\.\//);
+
+        if (wouldBeParentNavigation) {
+          errors.push(
+            `${relativePath}:${lineNum} - Directory import requires ` +
+            `parent navigation (create export file like '${importPath}.js' ` +
+            `or import specific file)`
+          );
+          continue;
+        }
+
+        const suggestion = importPath.endsWith('/') ?
+          `${importPath}index.js` : `${importPath}/index.js`;
+        errors.push(
+          `${relativePath}:${lineNum} - Directory import ` +
+          `(write explicitly: '${suggestion}')`
+        );
+        continue;
+      }
+    }
+
+    // Check 5: File existence (after all other checks)
+    // Verify that the import path resolves to an existing file
+    // Follow Node.js/Vite resolution order
+    let fileExists = false;
+    const possiblePaths = [];
+
+    // If import has extension, check exact path
+    if (importPath.match(/\.(js|svelte|svelte\.js|test\.js|spec\.js)$/)) {
+      possiblePaths.push(fsPath);
+    } else {
+      // No extension, try in resolution order
+      possiblePaths.push(fsPath);  // Exact match
+      possiblePaths.push(fsPath + '.js');
+      possiblePaths.push(fsPath + '.svelte');
+      possiblePaths.push(fsPath + '.svelte.js');
+      possiblePaths.push(fsPath + '/index.js');
+      possiblePaths.push(fsPath + '/index.svelte');
+    }
+
+    for (const testPath of possiblePaths) {
+      try {
+        const stats = await stat(testPath);
+        if (stats.isFile()) {
+          fileExists = true;
+          break;
+        }
+      } catch {
+        // File doesn't exist, continue checking
+      }
+    }
+
+    if (!fileExists) {
+      errors.push(
+        `${relativePath}:${lineNum} - Import path does not exist: ` +
+        `'${importPath}'`
+      );
+    }
+  }
+
+  return errors;
+}
+
+/**
+ * Main validation function
+ */
+async function main() {
+  console.log('Validating import paths...\n');
+
+  const files = await findFiles(SRC_DIR);
+  const allErrors = [];
+
+  for (const file of files) {
+    const errors = await validateFile(file);
+    allErrors.push(...errors);
+  }
+
+  if (allErrors.length > 0) {
+    console.error('❌ Found import path violations:\n');
+    allErrors.forEach(error => console.error(`  ${error}`));
+    console.error(`\n${allErrors.length} error(s) found.`);
+    process.exit(1);
+  }
+
+  console.log('✅ All import paths are valid!');
+}
+
+main().catch(error => {
+  console.error('Validation script error:', error);
+  process.exit(1);
+});

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

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

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

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

package/dist/ui/components/index.d.ts

@@ -1,11 +0,0 @@
-export { default as ButtonGroup } from "./button-group/ButtonGroup.svelte";
-export { default as CompareLeftRight } from "./compare-left-right/CompareLeftRight.svelte";
-export { default as GameBox } from "./game-box/GameBox.svelte";
-export { default as HkAppLayout } from "./hk-app-layout/HkAppLayout.svelte";
-export { default as ImageBox } from "./image-box/ImageBox.svelte";
-export { default as Presenter } from "./presenter/Presenter.svelte";
-export { default as ImageSlide } from "./presenter/ImageSlide.svelte";
-export { default as VirtualViewport } from "./virtual-viewport/VirtualViewport.svelte";
-export * from "./button-group/typedef.js";
-export * from "./presenter/typedef.js";
-export { createOrGetState as createOrGetAppLayoutState, createState as createAppLayoutState, getState as getAppLayoutState } from "./hk-app-layout/HkAppLayout.state.svelte.js";

package/dist/ui/components/index.js

@@ -1,23 +0,0 @@
-export { default as ButtonGroup } from './button-group/ButtonGroup.svelte';
-export { default as CompareLeftRight } from './compare-left-right/CompareLeftRight.svelte';
-export { default as GameBox } from './game-box/GameBox.svelte';
-
-export {
-  createOrGetState as createOrGetAppLayoutState,
-  createState as createAppLayoutState,
-  getState as getAppLayoutState
-} from './hk-app-layout/HkAppLayout.state.svelte.js';
-
-export { default as HkAppLayout } from './hk-app-layout/HkAppLayout.svelte';
-
-export { default as ImageBox } from './image-box/ImageBox.svelte';
-
-export { default as Presenter } from './presenter/Presenter.svelte';
-export { default as ImageSlide } from './presenter/ImageSlide.svelte';
-
-export { default as VirtualViewport } from './virtual-viewport/VirtualViewport.svelte';
-
-// > Types
-
-export * from './button-group/typedef.js';
-export * from './presenter/typedef.js';