Improved library

.github/workflows/ci.yml

@@ -20,14 +20,13 @@ jobs:
     strategy:
       matrix:
         node-version: 
-          - 18.x
           - 20.x
           - 22.x
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
       - run: npm ci
@@ -51,15 +50,15 @@ jobs:
       - uses: actions/download-artifact@v4
         with:
           name: build
-      - uses: actions/setup-node@v1
+      - uses: actions/setup-node@v4
         with:
           node-version: 20.x
-      - uses: rlespinasse/github-slug-action@v3.x
+      - uses: rlespinasse/github-slug-action@v4.x
       - name: Append commit hash to package version
         run: 'sed -i -E "s/(\"version\": *\"[^\"]+)/\1-${GITHUB_SHA_SHORT}/" package.json'
       - name: Disable pre- and post-publish actions
         run: 'sed -i -E "s/\"((pre|post)publish)/\"ignore:\1/" package.json'
-      - uses: JS-DevTools/npm-publish@v1
+      - uses: JS-DevTools/npm-publish@v2
         with:
           token: ${{ secrets.NPM_TOKEN }}
           tag: ${{ env.GITHUB_REF_SLUG }}
@@ -72,12 +71,12 @@ jobs:
       - uses: actions/download-artifact@v4
         with:
           name: build
-      - uses: actions/setup-node@v1
+      - uses: actions/setup-node@v4
         with:
           node-version: 20.x
       - name: Disable pre- and post-publish actions
         run: 'sed -i -E "s/\"((pre|post)publish)/\"ignore:\1/" package.json'
-      - uses: JS-DevTools/npm-publish@v1
+      - uses: JS-DevTools/npm-publish@v2
         with:
           token: ${{ secrets.NPM_TOKEN }}
           tag: latest

.gitignore

@@ -1,6 +1,11 @@
 node_modules
-lib
+dist
+coverage
 
 ### VisualStudioCode Patch ###
 # Ignore all local history of files
 .history
+.idea
+.vscode
+
+src/versionInfo.ts

README.md

@@ -1,7 +1,113 @@
 # solid-logic
-Core business logic of SolidOS
 
-# Adendum
+<img src="https://raw.githubusercontent.com/solid/community-server/main/templates/images/solid.svg" alt="[Solid logo]" height="150" align="right"/>
+
+[![MIT license](https://img.shields.io/github/license/solidos/solidos)](https://github.com/solidos/solidos/blob/main/LICENSE.md)
+
+
+Core business logic of SolidOS which can be used for any webapp as well.
+
+
+# Usage
+
+## Install via npm
+
+```sh
+npm install solid-logic
+```
+
+### Import in your project (ESM/TypeScript)
+
+```js
+import { someFunction } from 'solid-logic';
+```
+
+## Use directly in a browser
+
+There are a few differences to mention:
+* the UMD bundles come in 2 flavours, with rdflib bundled together and without;
+* the ESM bundles do not contain rdflib, so it must be imported separately.
+
+## Files
+- For npm/ESM: `dist/solid-logic.esm.js` (referenced automatically in npm projects)
+- For browser UMD, bundled with rdflib: `dist/solid-logic.umd.js` (global `window.SolidLogic`)
+- For browser UMD, without rdflib: `dist/solid-logic.umd.external.js` (global `window.SolidLogic`)
+- For browser ESM, without rdflib: `dist/solid-logic.esm.external.js` (import as module)
+- also, both flabours, ESM and UMD come in chunked files.
+
+
+### UMD bundle (global variable)
+
+```html
+<!-- Load dependencies first -->
+<script src="https://unpkg.com/rdflib/dist/rdflib.min.js"></script>
+<!-- or -->
+<!-- script src="https://cdn.jsdelivr.net/npm/rdflib/dist/rdflib.min.js"></script -->
+<!-- Load solid-logic UMD bundle -->
+<script src="https://unpkg.com/solid-logic/dist/solid-logic.umd.min.js"></script>
+<!-- or -->
+<!-- script src="https://cdn.jsdelivr.net/npm/solid-logic/dist/solid-logic.umd.min.js"></script -->
+<!-- or -->
+<!-- script src="dist/solid-logic.umd.js"></script -->
+<script>
+	// Access via global variable
+	const logic = window.SolidLogic;
+	// Example usage
+	// logic.someFunction(...)
+</script>
+```
+
+
+### ESM bundle (import as module)
+
+```html
+<script type="module">
+	import * as $rdf from 'https://esm.sh/rdflib'
+	import { someFunction } from 'https://esm.sh/solid-logic'
+
+	// Example usage
+	// someFunction(...)
+</script>
+```
+
+or 
+
+### ESM bundle with import map (bare specifiers)
+
+```html
+<script type="importmap">
+{
+	"imports": {
+		"rdflib": "https://esm.sh/rdflib",
+		"solid-logic": "https://esm.sh/solid-logic"
+	}
+}
+</script>
+<script type="module">
+    import * as $rdf from 'rdflib'
+	import { someFunction } from 'solid-logic'
+
+	// Example usage
+	// someFunction(...)
+</script>
+```
+
+# How to develop
+
+Check the scripts in the `package.json` for build, watch, lint and test.
+
+# Used stack
+
+* TypeScript + Babel
+* Jest
+* ESLint
+* Rollup
+
+# How to release
+
+Change version and push directly to main. This will trigger the npm release latest script in CI.
+
+# History
 
 Solid-logic was a move to separate business logic from UI functionality so that people using different UI frameworks could use logic code. 
 

babel.config.js

@@ -0,0 +1,6 @@
+export default {
+  presets: [
+    ['@babel/preset-env', { targets: { node: 'current' } }],
+    '@babel/preset-typescript'
+  ]
+}

eslint.config.js

@@ -1,29 +1,30 @@
-const {
-    defineConfig,
-} = require("eslint/config");
+import tsParser from '@typescript-eslint/parser'
+import tseslintPlugin from '@typescript-eslint/eslint-plugin'
+import tseslint from 'typescript-eslint'
+import importPlugin from 'eslint-plugin-import'
 
-const tsParser = require("@typescript-eslint/parser");
-const typescriptEslint = require("@typescript-eslint/eslint-plugin");
-const js = require("@eslint/js");
-
-const {
-    FlatCompat,
-} = require("@eslint/eslintrc");
-
-const compat = new FlatCompat({
-    baseDirectory: __dirname,
-    recommendedConfig: js.configs.recommended,
-    allConfig: js.configs.all
-});
-
-module.exports = defineConfig([{
+export default [
+  ...tseslint.configs.recommended,
+  {
+    files: ['src/**/*.ts', 'test/**/*.test.ts'],
+    ignores: ['dist/**', 'node_modules/**'],
     languageOptions: {
-        parser: tsParser,
+      parser: tsParser,
+      parserOptions: {
+        project: ['./tsconfig.json', './tsconfig.test.json'],
+        sourceType: 'module',
+      },
     },
-
     plugins: {
-        "@typescript-eslint": typescriptEslint,
+      '@typescript-eslint': tseslintPlugin,
+      import: importPlugin,
     },
-
-    extends: compat.extends("eslint:recommended", "plugin:@typescript-eslint/recommended"),
-}]);
+    rules: {
+      'semi': ['error', 'never'],
+      'quotes': ['error', 'single'],
+      'no-unused-vars': 'off', // handled by TS
+      '@typescript-eslint/no-unused-vars': ['warn'],
+      '@typescript-eslint/no-explicit-any': 'warn',
+    },
+  },
+]

jest.config.js

@@ -1,10 +1,17 @@
-module.exports = {
-  verbose: true,
+/** @type {import('jest').Config} */
+export default {
+  // verbose: true, // Uncomment for detailed test output
+  collectCoverage: true,
+  coverageDirectory: 'coverage',
   testEnvironment: 'jsdom',
   testEnvironmentOptions: {
-      customExportConditions: ['node']
+    customExportConditions: ['node'],
   },
-  setupFilesAfterEnv: [
-    './test/helpers/setup.ts'
-  ]
-}
+  testPathIgnorePatterns: ['/node_modules/', '/dist/'],
+  transform: {
+    '^.+\\.[tj]sx?$': ['babel-jest', { configFile: './babel.config.js' }],
+  },
+  setupFilesAfterEnv: ['./test/helpers/setup.ts'],
+  testMatch: ['**/__tests__/**/*.ts?(x)', '**/?(*.)+(spec|test).ts?(x)'],
+  roots: ['<rootDir>/src', '<rootDir>/test'],
+}