@hkdigital/lib-core 0.3.1

package/README.md

@@ -0,0 +1,149 @@
+# HKdigital's lib-core
+
+Core library that we use to power up our Sveltekit projects
+
+This is a library for [SvelteKit](https://svelte.dev/) projects.
+It contains common code and components that we use to create our projects.
+
+## Status
+
+**EARLY DEVELOPMENT RELEASE**
+This package is incomplete and not fully tested.
+Do not use in production environments yet.
+
+### TODO
+
+## Using the library
+
+### Install
+
+The library can be installed as a normal NPM library.
+
+```bash
+pnpm add @hkdigital/lib-sveltekit
+```
+
+#### Tailwind
+
+Components in this package use [tailwindcss](https://tailwindcss.com/).
+
+To compile tailwind classes inside this package, you must add the package location to your tailwindcss plugin configuration.
+
+```
+// tailwind.config.js
+export default {
+  content: [
+    './node_modules/@hkdigital/**/*.{html,js,svelte,ts}',
+    './src/**/*.{html,js,svelte,ts}',
+```
+
+### Update
+
+Make sure your project has a script called `upgrade:hk` to upgrade all packages
+in the '@hkdigital' namespace.
+
+```bash
+pnpm upgrade:hk
+```
+
+### The package.json scripts:
+
+```bash
+pnpm add -D npm-check-updates
+pnpm add -D npm-check-updates
+```
+
+```js
+"scripts": {
+  "upgrade:hk": "run-s upgrade:hk:update pnpm:install",
+  "upgrade:hk:update": "ncu --dep dev,optional,peer,prod '@hkdigital/*' -u",
+  "pnpm:install": "pnpm install"
+}
+```
+
+
+### Import JS, Svelte files and Typedefs
+
+Most subfolders have an index.js that export all functionality and typedefs.
+
+```svelte
+import { CHAR } from '@hkdigital/lib-sveltekit/constants/regexp/index.js';
+```
+
+### Import CSS
+
+Vite should include postcss-import, but the only solution to get it working for now is to use a relative path to the node_modules folder.
+
+For example:
+
+```css
+/* src/app.css */
+@import '../node_modules/@hkdigital/lib-sveltekit/dist/css/utilities.css';
+```
+
+### Enable tailwind processing
+
+Allow the tailwind CSS processor to work on the library inside node_modules
+
+```js
+// tailwind.config.js
+export default {
+  content: [
+    './node_modules/@hkdigital/**/*.{html,js,svelte,ts}',
+    './src/**/*.{html,js,svelte,ts}',
+```
+
+## Building the library
+
+To build your library:
+
+```bash
+npm run package
+```
+
+## Building the showcase app
+
+To create a production version of your showcase app:
+
+```bash
+npm run build
+```
+
+You can preview the production build with `npm run preview`.
+
+> To deploy your app, you may need to install an [adapter](https://svelte.dev/docs/kit/adapters) for your target environment.
+
+## Developing
+
+To develop this library, clone the repository and install the dependencies, then start the development server of the test runners. Checkout the [package.json](./package.json) file for more details.
+
+Everything inside `src/lib` is part of the library, everything inside `src/routes` is the showcase app of this library.
+
+## Publishing
+
+The name of this library is `@hkdigital/lib-sveltekit` and it is published on [NPM](https://npmjs.com). You need NPM credentials to publish in the scope `@hkdigital`.
+
+```bash
+# Manually
+npm login
+npm version patch
+npm publish --access public
+```
+
+```bash
+# Run `npm version patch && npm publish --access public && git push`
+# as specified in package.json
+pnpm run publish:npm
+```
+
+### Troubleshooting
+
+#### Running scripts from package.json in Windows
+
+The CMD terminal in Windows is quite limited. Use the PowerShell instead of some scripts from package.json do not run correctly.
+
+
+## Contribute
+
+If your wish to contribute to this library, please contact us [HKdigital](https://hkdigital.nl/contact). Alternatively, the license permits you to fork the library and publish under an alternative name. Don't forget to change the package name in [package.json](./package.json) if you do so.
+

package/dist/assets/autospuiten/car-paint-picker.d.ts

@@ -0,0 +1,17 @@
+export const carPaintImages: {
+    rusty: import("../../typedef/image.js").ImageMeta[];
+    "army-green": import("../../typedef/image.js").ImageMeta[];
+    "electric-blue": import("../../typedef/image.js").ImageMeta[];
+    "lemon-yellow": import("../../typedef/image.js").ImageMeta[];
+    "opaque-purple": import("../../typedef/image.js").ImageMeta[];
+    "sunset-orange": import("../../typedef/image.js").ImageMeta[];
+    "tomato-red": import("../../typedef/image.js").ImageMeta[];
+};
+import Rusty from './car-paint-picker/rusty.jpg?preset=render&responsive';
+import ArmyGreen from './car-paint-picker/army-green.jpg?preset=render&responsive';
+import ElectricBlue from './car-paint-picker/electric-blue.jpg?preset=render&responsive';
+import LemonYellow from './car-paint-picker/lemon-yellow.jpg?preset=render&responsive';
+import OpaquePurple from './car-paint-picker/opaque-purple.jpg?preset=render&responsive';
+import SunsetOrange from './car-paint-picker/sunset-orange.jpg?preset=render&responsive';
+import TomatoRed from './car-paint-picker/tomato-red.jpg?preset=render&responsive';
+export { Rusty, ArmyGreen, ElectricBlue, LemonYellow, OpaquePurple, SunsetOrange, TomatoRed };

package/dist/assets/autospuiten/car-paint-picker.js

@@ -0,0 +1,41 @@
+import {
+  LABEL_RUSTY,
+  LABEL_ARMY_GREEN,
+  LABEL_ELECTRIC_BLUE,
+  LABEL_LEMON_YELLOW,
+  LABEL_OPAQUE_PURPLE,
+  LABEL_SUNSET_ORANGE,
+  LABEL_TOMATO_RED
+} from './labels.js';
+
+import Rusty from './car-paint-picker/rusty.jpg?preset=render&responsive';
+
+import ArmyGreen from './car-paint-picker/army-green.jpg?preset=render&responsive';
+import ElectricBlue from './car-paint-picker/electric-blue.jpg?preset=render&responsive';
+import LemonYellow from './car-paint-picker/lemon-yellow.jpg?preset=render&responsive';
+import OpaquePurple from './car-paint-picker/opaque-purple.jpg?preset=render&responsive';
+import SunsetOrange from './car-paint-picker/sunset-orange.jpg?preset=render&responsive';
+import TomatoRed from './car-paint-picker/tomato-red.jpg?preset=render&responsive';
+
+// console.log('ArmyGreen', ArmyGreen);
+
+export const carPaintImages = {
+  [LABEL_RUSTY]: Rusty,
+  [LABEL_ARMY_GREEN]: ArmyGreen,
+  [LABEL_ELECTRIC_BLUE]: ElectricBlue,
+  [LABEL_LEMON_YELLOW]: LemonYellow,
+  [LABEL_OPAQUE_PURPLE]: OpaquePurple,
+  [LABEL_SUNSET_ORANGE]: SunsetOrange,
+  [LABEL_TOMATO_RED]: TomatoRed
+};
+
+/* Also export as individual images */
+export {
+  Rusty,
+  ArmyGreen,
+  ElectricBlue,
+  LemonYellow,
+  OpaquePurple,
+  SunsetOrange,
+  TomatoRed
+};

package/dist/assets/autospuiten/labels.d.ts

@@ -0,0 +1,7 @@
+export const LABEL_RUSTY: "rusty";
+export const LABEL_ARMY_GREEN: "army-green";
+export const LABEL_ELECTRIC_BLUE: "electric-blue";
+export const LABEL_LEMON_YELLOW: "lemon-yellow";
+export const LABEL_OPAQUE_PURPLE: "opaque-purple";
+export const LABEL_SUNSET_ORANGE: "sunset-orange";
+export const LABEL_TOMATO_RED: "tomato-red";

package/dist/assets/autospuiten/labels.js

@@ -0,0 +1,7 @@
+export const LABEL_RUSTY = 'rusty';
+export const LABEL_ARMY_GREEN = 'army-green';
+export const LABEL_ELECTRIC_BLUE = 'electric-blue';
+export const LABEL_LEMON_YELLOW = 'lemon-yellow';
+export const LABEL_OPAQUE_PURPLE = 'opaque-purple';
+export const LABEL_SUNSET_ORANGE = 'sunset-orange';
+export const LABEL_TOMATO_RED = 'tomato-red';

package/dist/classes/cache/IndexedDbCache.d.ts

@@ -0,0 +1,216 @@
+/**
+ * IndexedDbCache with automatic background cleanup
+ */
+export default class IndexedDbCache {
+    /**
+     * Create a new IndexedDB cache storage
+     *
+     * @param {Object} [options] - Cache options
+     * @param {string} [options.dbName='http-cache'] - Database name
+     * @param {string} [options.storeName='responses'] - Store name
+     * @param {number} [options.maxSize=50000000] - Max cache size in bytes (50MB)
+     * @param {number} [options.maxAge=604800000] - Max age in ms (7 days)
+     * @param {number} [options.cleanupBatchSize=100] - Items per cleanup batch
+     * @param {number} [options.cleanupInterval=300000] - Time between cleanup attempts (5min)
+     * @param {number} [options.cleanupPostponeTimeout=5000] - Time to postpone cleanup after store (5sec)
+     * @param {string} [options.cacheVersion='1.0.0'] - Cache version, used for cache invalidation
+     */
+    constructor(options?: {
+        dbName?: string;
+        storeName?: string;
+        maxSize?: number;
+        maxAge?: number;
+        cleanupBatchSize?: number;
+        cleanupInterval?: number;
+        cleanupPostponeTimeout?: number;
+        cacheVersion?: string;
+    });
+    dbName: string;
+    storeName: string;
+    maxSize: number;
+    maxAge: number;
+    cleanupBatchSize: number;
+    cleanupInterval: number;
+    cleanupPostponeTimeout: number;
+    cacheVersion: string;
+    EXPIRES_INDEX: string;
+    TIMESTAMP_INDEX: string;
+    SIZE_INDEX: string;
+    CACHE_VERSION_INDEX: string;
+    SCHEMA_VERSION: number;
+    /**
+     * Database connection promise
+     * @type {Promise<IDBDatabase>}
+     * @private
+     */
+    private dbPromise;
+    /**
+     * Cleanup state tracker
+     * @type {Object}
+     * @private
+     */
+    private cleanupState;
+    postponeCleanupTimer: number;
+    /**
+     * Initialize the database connection
+     *
+     * @private
+     */
+    private _initDatabase;
+    /**
+     * Open the IndexedDB database with proper schema versioning
+     *
+     * @private
+     * @returns {Promise<IDBDatabase>}
+     */
+    private _openDatabase;
+    /**
+     * Ensure an index exists in a store, create if missing
+     *
+     * @private
+     * @param {IDBObjectStore} store - The object store
+     * @param {string} indexName - Name of the index
+     * @param {string} keyPath - Key path for the index
+     * @param {Object} options - Index options (e.g. unique)
+     */
+    private _ensureIndexExists;
+    /**
+     * Check if all required indexes exist in the database
+     *
+     * @private
+     * @returns {Promise<boolean>}
+     */
+    private _validateSchema;
+    /**
+     * Postpone cleanup for the specified duration
+     * Resets the postpone timer if called again before timeout
+     *
+     * @private
+     */
+    private _postponeCleanup;
+    /**
+     * Check if cleanup is postponed
+     *
+     * @private
+     * @returns {boolean}
+     */
+    private _isCleanupPostponed;
+    /**
+     * Get a cached response
+     * Supports retrieving older cache versions and migrating them
+     *
+     * @param {string} key - Cache key
+     * @returns {Promise<CacheEntry|null>} Cache entry or null if not found/expired
+     */
+    get(key: string): Promise<CacheEntry | null>;
+    /**
+     * Store a response in the cache
+     *
+     * @param {string} key - Cache key
+     * @param {Response} response - Response to cache
+     * @param {Object} [metadata={}] - Cache metadata
+     * @returns {Promise<void>}
+     */
+    set(key: string, response: Response, metadata?: any): Promise<void>;
+    /**
+     * Update an existing entry in the cache
+     *
+     * @private
+     * @param {Object} entry - The entry to update
+     * @returns {Promise<boolean>}
+     */
+    private _updateEntry;
+    /**
+     * Update last accessed timestamp (without blocking)
+     *
+     * @private
+     * @param {string} key - Cache key
+     * @returns {Promise<void>}
+     */
+    private _updateAccessTime;
+    /**
+     * Delete a cached entry
+     *
+     * @param {string} key - Cache key
+     * @returns {Promise<boolean>}
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Delete a cached entry (internal implementation)
+     *
+     * @private
+     * @param {string} key - Cache key
+     * @returns {Promise<boolean>}
+     */
+    private _deleteEntry;
+    /**
+     * Clear all cached responses
+     *
+     * @returns {Promise<void>}
+     */
+    clear(): Promise<void>;
+    /**
+     * Check storage usage and schedule cleanup if needed
+     *
+     * @private
+     */
+    private _checkAndScheduleCleanup;
+    /**
+     * Schedule a cleanup to run during idle time
+     *
+     * @private
+     * @param {boolean} [urgent=false] - If true, clean up sooner
+     */
+    private _scheduleCleanup;
+    /**
+     * Get a random expiration time between 30 minutes and 90 minutes
+     *
+     * @private
+     * @returns {number} Expiration time in milliseconds
+     */
+    private _getRandomExpiration;
+    /**
+     * Perform a single cleanup step
+     *
+     * @private
+     */
+    private _performCleanupStep;
+    /**
+     * Remove expired entries
+     *
+     * @private
+     * @param {number} limit - Maximum number of entries to remove
+     * @returns {Promise<number>} Number of entries removed
+     */
+    private _removeExpiredEntries;
+    /**
+     * Mark entries from old cache versions for gradual expiration
+     *
+     * @private
+     * @param {number} limit - Maximum number of entries to mark
+     * @returns {Promise<number>} Number of entries marked
+     */
+    private _markOldCacheVersionsForExpiration;
+    /**
+     * Remove old entries based on age and size constraints
+     *
+     * @private
+     * @param {number} limit - Maximum number of entries to remove
+     * @returns {Promise<number>} Number of entries removed
+     */
+    private _removeOldEntries;
+    /**
+     * Get an estimate of the total cache size
+     *
+     * @private
+     * @returns {Promise<number>} Size estimate in bytes
+     */
+    private _getCacheSizeEstimate;
+    /**
+     * Close the database connection
+     */
+    close(): Promise<void>;
+}
+export type CacheEntry = import("./typedef").CacheEntry;
+export type IDBRequestEvent = import("./typedef").IDBRequestEvent;
+export type IDBVersionChangeEvent = import("./typedef").IDBVersionChangeEvent;