chore: update docs

Author: noherczeg

examples/README.md

@@ -2,6 +2,10 @@
 
 Please read every example project's `README.md` carefully, since almost _- if not all -_ projects work differently!
 
+> **Warning:** You may see CDN links for bundle installation at certain sections of each documentation.
+You should look at these as examples/feature show-offs! You are free to store your bundles on your server as well,
+or in certain cases install them via NPM! Using CDNs is not mandatory.
+
 ## Bare Pandino showcase
 
 - [basic-browser-js](./basic-browser-js)

examples/nodejs-cjs/src/index.js

@@ -1,5 +1,5 @@
-const Pandino = require("@pandino/pandino");
 const path = require("path");
+const Pandino = require("@pandino/pandino");
 const loaderConfiguration = require("@pandino/loader-configuration-nodejs");
 
 const deploymentRoot = path.normalize(path.join(__dirname, 'deploy'));

packages/@pandino/bundle-installer-dom/README.md

@@ -32,11 +32,17 @@ Define a `<script type="pandino-manifests" />` tag in your `index.html`, e.g.:
 E.g.: directly via the Pandino instance.
 
 ```javascript
-let pandino: Bundle;
+import loaderConfiguration from 'https://unpkg.com/@pandino/loader-configuration-dom/dist/loader-configuration-dom.mjs';
+import Pandino from 'https://unpkg.com/@pandino/pandino/dist/esm/pandino.mjs';
 
-// ...
+const pandino = new Pandino({
+    ...loaderConfiguration,
+});
 
-pandino.getBundleContext().installBundle('./bundle-installer-dom-manifest.json');
+await pandino.init();
+await pandino.start();
+
+await pandino.getBundleContext().installBundle('https://unpkg.com/@pandino/bundle-installer-dom/dist/bundle-installer-dom-manifest.json');
 ```
 
 ## License

packages/@pandino/bundle-installer-nodejs/README.md

@@ -22,29 +22,19 @@ documentation(s).
 ### Setup Pandino and the Bundle Installer Bundle
 
 ```javascript
-const Pandino = require("@pandino/pandino").default;
-const bundleInstallerHeaders = require('@pandino/bundle-installer-nodejs').default;
+import Pandino from '@pandino/pandino';
+import loaderConfiguration from '@pandino/loader-configuration-nodejs';
+import bundleInstallerHeaders from '@pandino/bundle-installer-nodejs';
 const path = require("path");
-const fs = require("fs");
 
 const deploymentRoot = path.normalize(path.join(__dirname, 'deploy'));
 
 (async () => {
     const app = express();
     const port = 3000;
     const pandino = new Pandino({
+        ...loaderConfiguration,
         'pandino.deployment.root': deploymentRoot,
-        'pandino.bundle.importer': {
-            import: (deploymentRoot, activatorLocation) => {
-                return require(path.normalize(path.join(deploymentRoot, activatorLocation)));
-            },
-        },
-        'pandino.manifest.fetcher': {
-            fetch: async (deploymentRoot, uri) => {
-                const data = fs.readFileSync(path.normalize(path.join(deploymentRoot, uri)), {encoding: 'utf8'});
-                return JSON.parse(data);
-            },
-        },
     });
 
     await pandino.init();

packages/@pandino/loader-configuration-dom/README.md

@@ -8,8 +8,8 @@ Obtain the library from a CDN or NPM (`@pandino/loader-configuration-dom`). Impo
 constructor argument.
 
 ```javascript
-import loaderConfiguration from 'https://unpkg.com/@pandino/loader-configuration-dom@0.8.14/dist/loader-configuration-dom.mjs';
-import Pandino from 'https://unpkg.com/@pandino/pandino@0.8.14/dist/esm/pandino.mjs';
+import loaderConfiguration from 'https://unpkg.com/@pandino/loader-configuration-dom/dist/loader-configuration-dom.mjs';
+import Pandino from 'https://unpkg.com/@pandino/pandino/dist/esm/pandino.mjs';
 
 const pandino = new Pandino({
     ...loaderConfiguration,

packages/@pandino/pandino/README.md

@@ -17,49 +17,32 @@ documentation(s).
 
 ```html
 <script type="module">
-  window.addEventListener('DOMContentLoaded', async () => {
-    const Pandino = (await import('./pandino.mjs')).default;
+    import loaderConfiguration from 'https://unpkg.com/@pandino/loader-configuration-dom/dist/loader-configuration-dom.mjs';
+    import Pandino from 'https://unpkg.com/@pandino/pandino/dist/esm/pandino.mjs';
+    
     const pandino = new Pandino({
-      'pandino.deployment.root': location.href,
-      'pandino.bundle.importer': {
-        import: (deploymentRoot, activatorLocation) => import(activatorLocation),
-      },
-      'pandino.manifest.fetcher': {
-        fetch: async (deploymentRoot, uri) => (await fetch(uri)).json(),
-      },
+        ...loaderConfiguration,
     });
-
+    
     await pandino.init();
     await pandino.start();
-
+    
     console.log(pandino.getBundleContext());
-  });
 </script>
 ```
 
 ## Adding Pandino to a TypeScript project (e.g. with Webpack)
 
-Install Pandino via `npm install --save @pandino/pandino @pandino/pandino-api`.
+Install Pandino via `npm install --save @pandino/pandino @pandino/loader-configuration-dom`.
 
 Initialize it somewhere close in you applications own init logic, e.g.:
 
 ```typescript
 import Pandino from '@pandino/pandino';
-import {
-  PANDINO_MANIFEST_FETCHER_PROP,
-  PANDINO_BUNDLE_IMPORTER_PROP,
-  DEPLOYMENT_ROOT_PROP,
-} from '@pandino/pandino-api';
+import loaderConfiguration from '@pandino/loader-configuration-dom';
 
 const pandino = new Pandino({
-  [DEPLOYMENT_ROOT_PROP]: location.href + 'deploy',
-  [PANDINO_MANIFEST_FETCHER_PROP]: {
-    fetch: async (deploymentRoot: string, uri: string) => (await fetch(deploymentRoot + '/' + uri)).json(),
-  },
-  [PANDINO_BUNDLE_IMPORTER_PROP]: {
-    import: (deploymentRoot: string, activatorLocation: string, manifestLocation: string) =>
-      import(/* webpackIgnore: true */ deploymentRoot + '/' + activatorLocation),
-  },
+  ...loaderConfiguration,
 });
 
 await pandino.init();
@@ -70,30 +53,19 @@ await pandino.getBundleContext().installBundle('some-bundle-manifest.json');
 
 ## Adding Pandino to a NodeJS (CJS) project
 
-Install Pandino via `npm install --save @pandino/pandino`.
+Install Pandino via `npm install --save @pandino/pandino @pandino/loader-configuration-nodejs`.
 
 Initialize it somewhere close in you applications own init logic, e.g.:
 
 ```javascript
-const Pandino = require("@pandino/pandino").default;
-const path = require("path");
-const fs = require("fs");
+const Pandino = require("@pandino/pandino");
+const loaderConfiguration = require("@pandino/loader-configuration-nodejs");
 
 const deploymentRoot = path.normalize(path.join(__dirname, 'deploy'));
 
 const pandino = new Pandino({
-  'pandino.deployment.root': deploymentRoot,
-  'pandino.bundle.importer': {
-    import: (deploymentRoot, activatorLocation) => {
-      return require(path.normalize(path.join(deploymentRoot, activatorLocation)));
-    },
-  },
-  'pandino.manifest.fetcher': {
-    fetch: async (deploymentRoot, uri) => {
-      const data = fs.readFileSync(path.normalize(path.join(deploymentRoot, uri)), { encoding: 'utf8' });
-      return JSON.parse(data);
-    },
-  },
+    ...loaderConfiguration,
+    'pandino.deployment.root': deploymentRoot,
 });
 
 (async () => {

packages/@pandino/persistence-manager-api/README.md

@@ -5,7 +5,7 @@
 [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
 [![Conventional Changelog](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-conventional--changelog-e10079.svg?style=flat)](https://github.com/conventional-changelog/conventional-changelog)
 
-Support persisting Configuration Data.
+API support for persisting Configuration Data.
 
 ## Context
 

packages/@pandino/persistence-manager-localstorage/README.md

@@ -23,7 +23,7 @@ documentation(s).
 <script type="pandino-manifests">
   [
     ...,
-    "./persistence-manager-localstorage-manifest.json"
+    "https://unpkg.com/@pandino/persistence-manager-localstorage/dist/esm/persistence-manager-localstorage-manifest.json"
   ]
 </script>
 ```
@@ -37,7 +37,7 @@ const pandino: Bundle;
 
 // ...
 
-pandino.getBundleContext().installBundle('./persistence-manager-localstorage-manifest.json');
+pandino.getBundleContext().installBundle('https://unpkg.com/@pandino/persistence-manager-localstorage/dist/esm/persistence-manager-localstorage-manifest.json');
 ```
 
 ## Usage

packages/@pandino/persistence-manager-memory/README.md

@@ -23,7 +23,7 @@ documentation(s).
 <script type="pandino-manifests">
   [
     ...,
-    "./persistence-manager-memory-manifest.json"
+    "https://unpkg.com/@pandino/[email protected]/dist/esm/persistence-manager-memory-manifest.json"
   ]
 </script>
 ```
@@ -37,7 +37,7 @@ const pandino: Bundle;
 
 // ...
 
-pandino.getBundleContext().installBundle('./persistence-manager-memory-manifest.json');
+pandino.getBundleContext().installBundle('https://unpkg.com/@pandino/[email protected]/dist/esm/persistence-manager-memory-manifest.json');
 ```
 
 ## Usage