piral-blazor 1.0.0-pre.2217 → 1.0.0

package/esm/types.d.ts

@@ -1,4 +1,60 @@
-import type { ForeignComponent } from 'piral-core';
+import type { ForeignComponent, PiletApi } from 'piral-core';
+export type BlazorRootConfig = [
+    root: HTMLDivElement,
+    capabilities: Array<string>,
+    applyChanges: (pilet: PiletApi) => void
+];
+export interface BlazorDependencyLoader {
+    (config: BlazorRootConfig): Promise<void>;
+}
+export type WebAssemblyBootResourceType = 'assembly' | 'pdb' | 'dotnetjs' | 'dotnetwasm' | 'globalization' | 'manifest';
+export interface WebAssemblyStartOptions {
+    /**
+     * Overrides the built-in boot resource loading mechanism so that boot resources can be fetched
+     * from a custom source, such as an external CDN.
+     * @param type The type of the resource to be loaded.
+     * @param name The name of the resource to be loaded.
+     * @param defaultUri The URI from which the framework would fetch the resource by default. The URI may be relative or absolute.
+     * @param integrity The integrity string representing the expected content in the response.
+     * @returns A URI string or a Response promise to override the loading process, or null/undefined to allow the default loading behavior.
+     */
+    loadBootResource?(type: WebAssemblyBootResourceType, name: string, defaultUri: string, integrity: string): string | Promise<Response> | null | undefined;
+    /**
+     * Override built-in environment setting on start.
+     */
+    environment?: string;
+    /**
+     * Gets the application culture. This is a name specified in the BCP 47 format. See https://tools.ietf.org/html/bcp47
+     */
+    applicationCulture?: string;
+}
+declare global {
+    interface Window {
+        Blazor: {
+            start(options?: Partial<WebAssemblyStartOptions>): Promise<void>;
+            emitPiralEvent(type: string, args: any): void;
+            emitRenderEvent(source: HTMLElement, name: string, params: any, sourceRef: any, fallbackComponent: string | null): void;
+            emitNavigateEvent(target: Element, path: string, replace?: boolean, state?: any): void;
+            _internal: {
+                navigationManager: any;
+                applyHotReload: any;
+                NavigationLock: any;
+            };
+        };
+        DotNet: any;
+        $blazorLoader: Promise<BlazorRootConfig>;
+        $blazorDependencyPrios: Array<{
+            prio: number;
+            load(): Promise<void>;
+        }>;
+        $blazorDependencies: Array<{
+            name: string;
+            url: string;
+            count: number;
+            promise: Promise<void>;
+        }>;
+    }
+}
 declare module 'piral-core/lib/types/custom' {
     interface PiletCustomApi extends PiletBlazorApi {
     }
@@ -6,6 +62,24 @@ declare module 'piral-core/lib/types/custom' {
         blazor(component: BlazorComponent): ForeignComponent<TProps>;
     }
 }
+export declare const enum BlazorLogLevel {
+    trace = 0,
+    debug = 1,
+    info = 2,
+    warn = 3,
+    error = 4,
+    critical = 5,
+    none = 6
+}
+/**
+ * Additional options for the Blazor component
+ */
+export interface BlazorOptions {
+    /**
+     * The root path where resources are located.
+     */
+    resourcePathRoot?: string;
+}
 export interface BlazorComponent {
     /**
      * The name of the Blazor module to render.
@@ -19,26 +93,45 @@ export interface BlazorComponent {
      * An optional dependency that needs to load before
      * the component can be properly displayed.
      */
-    dependency?: () => Promise<void>;
+    dependency?: BlazorDependencyLoader;
     /**
      * The type of the Blazor component.
      */
     type: 'blazor';
+    /**
+     * Additional options for the Blazor component.
+     */
+    options?: BlazorOptions;
 }
 /**
  * Defines the provided set of Blazor Pilet API extensions.
  */
 export interface PiletBlazorApi {
     /**
-     * Defines the additional libraries to Blazor via their URLs.
+     * Defines the additional libraries (and their symbols) to Blazor via
+     * their URLs.
+     *
      * @param referenceUrls The URLs pointing to the different DLLs to include.
+     * @param satellites The URLs of the potential satellite DLLs to include.
+     * @param prio The loading priority of the DLLs. Higher numbers will always be loaded before lower numbers.
      */
-    defineBlazorReferences(referenceUrls: Array<string>): void;
+    defineBlazorReferences(referenceUrls: Array<string>, satellites?: Record<string, Array<string>>, prio?: number): void;
     /**
      * Wraps a Blazor module for use in Piral.
+     *
      * @param moduleName The name of the exposed Blazor component.
      * @param args The optional props to use as arguments for the Blazor component.
      * @returns The Piral Blazor component.
      */
     fromBlazor(moduleName: string, args?: Record<string, any>): BlazorComponent;
+    /**
+     * Defines the additional options to be shared by all Blazor components.
+     *
+     * @param options The options for the Blazor components.
+     */
+    defineBlazorOptions(options: BlazorOptions): void;
+    /**
+     * Releases all defined blazor references from the current pilet.
+     */
+    releaseBlazorReferences(): void;
 }

package/infra.codegen

@@ -1,84 +1,69 @@
-const axios = require('axios');
-const yauzl = require('yauzl');
 const fs = require('fs');
-const path = require('path');
+const { join, basename, dirname, resolve } = require('path');
 
-const prefix = 'staticwebassets/';
+function copyFileSync(source, target) {
+  let targetFile = target;
 
-function readSourceFromBuffer(buffer, outDir) {
-  return new Promise((resolve, reject) => {
-    yauzl.fromBuffer(buffer, { lazyEntries: true }, (err, zip) => {
-      if (err) {
-        reject(err);
-      } else {
-        zip.on('entry', (entry) => {
-          const file = entry.fileName;
-          const dir = path.dirname(file);
+  // If target is a directory, a new file with the same name will be created
+  if (fs.existsSync(target) && fs.lstatSync(target).isDirectory()) {
+    targetFile = join(target, basename(source));
+  }
 
-          if (dir.startsWith(prefix)) {
-            const target = path.resolve(outDir, file.substring(prefix.length));
-            zip.openReadStream(entry, (err, rs) => {
-              if (err) {
-                reject(err);
-              } else {
-                const ws = fs.createWriteStream(target);
-                rs.on('end', () => {
-                  ws.close();
-                  zip.readEntry();
-                });
-                rs.pipe(ws);
-              }
-            });
-          } else {
-            zip.readEntry();
-          }
-        });
-        zip.on('end', resolve);
-        zip.readEntry();
-      }
-    });
-  });
+  fs.writeFileSync(targetFile, fs.readFileSync(source));
+}
+
+function copyFolderRecursiveSync(source, target) {
+  // Check if folder needs to be created or integrated
+  const targetFolder = join(target, basename(source));
+
+  if (!fs.existsSync(targetFolder)) {
+    fs.mkdirSync(targetFolder);
+  }
+
+  copyContentRecursiveSync(source, targetFolder);
 }
 
-function generateModule(blazorBootFile) {
-  return new Promise((resolve) => {
-    // we introduce an artificial delay here for slower FS esp. in WSL
-    setTimeout(() => {
-      const content = fs.readFileSync(blazorBootFile, 'utf8');
-      resolve(`module.exports = ${content};`);
-    }, 50);
-  });
+function copyContentRecursiveSync(source, target) {
+  // Copy
+  if (fs.lstatSync(source).isDirectory()) {
+    const files = fs.readdirSync(source);
+
+    files.forEach((file) => {
+      const curSource = join(source, file);
+
+      if (fs.lstatSync(curSource).isDirectory()) {
+        copyFolderRecursiveSync(curSource, target);
+      } else {
+        copyFileSync(curSource, target);
+      }
+    });
+  }
 }
 
 module.exports = function () {
-  const version = process.env.PIRAL_BLAZOR_VERSION || '';
-  const localFile = process.env.PIRAL_BLAZOR_LOCAL_NUPKG;
   const outDir = this.options.outDir;
-  const frameworkDir = path.resolve(outDir, '_framework');
-  const binDir = path.resolve(frameworkDir, '_bin');
-  const wasmDir = path.resolve(frameworkDir, 'wasm');
-  const blazorBootFile = path.resolve(frameworkDir, 'blazor.boot.json');
 
   !fs.existsSync(outDir) && fs.mkdirSync(outDir, { recursive: true });
-  !fs.existsSync(frameworkDir) && fs.mkdirSync(frameworkDir);
-  !fs.existsSync(binDir) && fs.mkdirSync(binDir);
-  !fs.existsSync(wasmDir) && fs.mkdirSync(wasmDir);
-
-  if (localFile) {
-    if (!fs.existsSync(localFile)) {
-      throw new Error(
-        `The file provided via env. variable "PIRAL_BLAZOR_LOCAL_NUPKG" cannot be found: "${localFile}".`,
-      );
-    }
 
-    const content = fs.readFileSync(localFile);
-    return readSourceFromBuffer(content, outDir).then(() => generateModule(blazorBootFile));
-  }
+  try {
+    const blazorPackagePath = require.resolve('blazor/package.json');
+    const releaseType = process.env.NODE_ENV === 'production' ? 'release' : 'debug';
+    const { blazorConfig = {} } = require(blazorPackagePath);
+    const blazorBaseDir = resolve(dirname(blazorPackagePath), releaseType);
+    const wwwRootDir = resolve(blazorBaseDir, 'wwwroot');
+    const noMutation = blazorConfig.noMutation || false;
+    const satellites = blazorConfig.satellites || [];
+    const url = blazorConfig.url || '_framework/blazor.webassembly.js';
+    const bootConfig = {
+      url,
+      satellites,
+      noMutation,
+    };
 
-  console.log(`Downloading Piral.Blazor.Core@${version || 'latest'} from NuGet ...`);
+    copyContentRecursiveSync(wwwRootDir, outDir);
 
-  return axios
-    .get(`https://www.nuget.org/api/v2/package/Piral.Blazor.Core/${version}`, { responseType: 'arraybuffer' })
-    .then((res) => readSourceFromBuffer(res.data, outDir))
-    .then(() => generateModule(blazorBootFile));
+    return `export default (${JSON.stringify(bootConfig)});`;
+  } catch (err) {
+    throw new Error(`The npm package "blazor" was not found. Make sure to install it via "npm i blazor": ${err}`);
+  }
 };

package/lib/converter.d.ts

@@ -1,7 +1,11 @@
-import { ForeignComponent, BaseComponentProps } from 'piral-core';
-export declare function createConverter(lazy?: boolean): {
-    <TProps extends BaseComponentProps>(moduleName: string, dependency: () => Promise<void>, args: Record<string, any>): ForeignComponent<TProps>;
-    loader: Promise<{
-        platform: import("./internal/Platform/Platform").Platform;
-    }>;
+import type { BaseComponentProps, ForeignComponent } from 'piral-core';
+import { BlazorDependencyLoader, BlazorLogLevel, BlazorOptions, BlazorRootConfig, WebAssemblyStartOptions } from './types';
+export interface LanguageOptions {
+    current: string | undefined;
+    onChange(inform: (language: string) => void): void;
+}
+export declare function createConverter(lazy: boolean, opts?: WebAssemblyStartOptions, language?: LanguageOptions, logLevel?: BlazorLogLevel): {
+    <TProps extends BaseComponentProps>(moduleName: string, dependency: BlazorDependencyLoader, args: Record<string, any>, options?: BlazorOptions): ForeignComponent<TProps>;
+    loader: Promise<BlazorRootConfig>;
+    lazy: boolean;
 };

package/lib/converter.js

@@ -1,58 +1,174 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createConverter = void 0;
-var tslib_1 = require("tslib");
-var internal_1 = require("./internal");
-function createConverter(lazy) {
-    if (lazy === void 0) { lazy = true; }
-    var bootConfig = require('../infra.codegen');
-    var boot = function () { return internal_1.initialize(bootConfig); };
-    var root = document.body.appendChild(document.createElement('div'));
-    var loader = !lazy && boot();
-    root.style.display = 'none';
-    root.id = 'blazor-root';
-    var convert = function (moduleName, dependency, args) {
-        var id;
-        var referenceId;
-        var node;
-        var dispose = function () { };
-        var state;
-        return {
-            mount: function (el, data, ctx) {
-                var props = tslib_1.__assign(tslib_1.__assign({}, args), data);
-                el.setAttribute('data-blazor-pilet-root', 'true');
-                (loader || (loader = boot()))
-                    .then(dependency)
-                    .then(function () { return internal_1.activate(moduleName, props); })
-                    .then(function (refId) {
-                    if (state === 'fresh') {
-                        id = moduleName + "-" + refId;
-                        node = el.appendChild(root.querySelector("#" + id + " > div"));
-                        state = 'mounted';
-                        referenceId = refId;
+const tslib_1 = require("tslib");
+const events_1 = require("./events");
+const interop_1 = require("./interop");
+const infra_codegen_1 = require("../infra.codegen");
+const noop = () => { };
+const mediaRules = [
+    { attribute: 'src', selector: 'img, embed, video > source, video > track, audio > source' },
+    { attribute: 'srcset', selector: 'picture > source' },
+];
+function prefixMediaSources(component, prefix) {
+    const prefixAttributeValue = (el, attr) => el.setAttribute(attr, prefix + el.getAttribute(attr));
+    for (const { attribute, selector } of mediaRules) {
+        Array.from(component.querySelectorAll(selector))
+            .filter((el) => el.hasAttribute(attribute) && !el.getAttribute(attribute).match(/^https?:/))
+            .forEach((el) => prefixAttributeValue(el, attribute));
+    }
+}
+function project(component, destination, options) {
+    if ((options === null || options === void 0 ? void 0 : options.resourcePathRoot) && !infra_codegen_1.default.noMutation) {
+        prefixMediaSources(component, options.resourcePathRoot);
+    }
+    destination.appendChild(component);
+}
+function makeUrl(href) {
+    const origin = document.location.origin;
+    if (!href.startsWith(origin)) {
+        return `${origin}${href}`;
+    }
+    return href;
+}
+function createConverter(lazy, opts, language, logLevel) {
+    const bootLoader = (0, interop_1.createBootLoader)(infra_codegen_1.default.url, infra_codegen_1.default.satellites);
+    const boot = (opts) => bootLoader(opts).then((res) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const [_, capabilities] = res;
+        if (capabilities.includes('logging')) {
+            if (typeof logLevel === 'number') {
+                yield (0, interop_1.setLogLevel)(logLevel);
+            }
+        }
+        if (language && capabilities.includes('language')) {
+            if (typeof language.current === 'string') {
+                yield (0, interop_1.setLanguage)(language.current);
+            }
+            if (capabilities.includes('events')) {
+                const eventDispatcher = document.body.dispatchEvent;
+                // listen to all events for forwarding them
+                document.body.dispatchEvent = function (ev) {
+                    if (ev.type.startsWith('piral-')) {
+                        const type = ev.type.replace('piral-', '');
+                        const args = ev.detail.arg;
+                        (0, interop_1.processEvent)(type, args);
+                    }
+                    return eventDispatcher.call(this, ev);
+                };
+            }
+            if (typeof language.onChange === 'function') {
+                language.onChange(interop_1.setLanguage);
+            }
+        }
+        window.dispatchEvent(new CustomEvent('loaded-blazor-core'));
+        return res;
+    }));
+    let loader = !lazy && boot(opts);
+    let listener = undefined;
+    const enqueueChange = (locals, update) => {
+        if (typeof update !== 'function') {
+            // nothing to do in this case
+        }
+        else if (locals.state === 'mounted') {
+            loader.then(update);
+        }
+        else {
+            locals.next = update;
+        }
+    };
+    const convert = (moduleName, dependency, args, options) => ({
+        mount(el, data, ctx, locals) {
+            const props = Object.assign(Object.assign({}, args), data);
+            const { piral } = data;
+            const nav = ctx.navigation;
+            el.setAttribute('data-blazor-pilet-root', 'true');
+            (0, events_1.addGlobalEventListeners)(el);
+            if (listener === undefined) {
+                listener = nav.listen(({ location, action }) => {
+                    // POP is already handled by .NET
+                    if (action !== 'POP') {
+                        const url = makeUrl(location.href);
+                        (0, interop_1.callNotifyLocationChanged)(url, action === 'REPLACE', location.state);
                     }
-                })
-                    .catch(function (err) { return console.error(err); });
-                dispose = internal_1.attachEvents(el, function (ev) { return data.piral.renderHtmlExtension(ev.detail.target, ev.detail.props); }, function (ev) {
-                    return ev.detail.replace
-                        ? ctx.router.history.replace(ev.detail.to, ev.detail.store)
-                        : ctx.router.history.push(ev.detail.to, ev.detail.state);
                 });
-                state = 'fresh';
-            },
-            unmount: function (el) {
-                el.removeAttribute('data-blazor-pilet-root');
-                dispose();
-                if (state === 'mounted') {
-                    root.querySelector("#" + id).appendChild(node);
-                    internal_1.deactivate(moduleName, referenceId);
+            }
+            locals.state = 'fresh';
+            locals.next = noop;
+            locals.dispose = (0, events_1.attachEvents)(el, (ev) => {
+                ev.stopPropagation();
+                const { target, props } = ev.detail;
+                piral.renderHtmlExtension(target, props);
+            }, (ev) => {
+                ev.stopPropagation();
+                const { to, state, replace } = ev.detail;
+                replace ? nav.replace(to, state) : nav.push(to, state);
+            }, (ev) => {
+                ev.stopPropagation();
+                const { type, args } = ev.detail;
+                piral.emit(type, args);
+            });
+            function mountClassic(config) {
+                return (0, interop_1.activate)(moduleName, props).then((refId) => {
+                    const [root] = config;
+                    const node = root.querySelector(`#${refId} > div`);
+                    locals.unmount = () => {
+                        var _a;
+                        (_a = root.querySelector(`#${refId}`)) === null || _a === void 0 ? void 0 : _a.appendChild(node);
+                        (0, interop_1.deactivate)(moduleName, refId);
+                        el.innerHTML = '';
+                    };
+                    locals.update = (props) => {
+                        (0, interop_1.reactivate)(moduleName, refId, props);
+                    };
+                    project(node, el, options);
+                });
+            }
+            function mountModern(_) {
+                return (0, interop_1.createElement)(moduleName, props).then((refId) => {
+                    const child = document.createElement('piral-blazor-component');
+                    child.setAttribute('rid', refId);
+                    el.appendChild(child);
+                    locals.unmount = () => {
+                        (0, interop_1.destroyElement)(refId);
+                        child.remove();
+                        el.innerHTML = '';
+                    };
+                    locals.update = (props) => {
+                        (0, interop_1.updateElement)(refId, props);
+                    };
+                });
+            }
+            (loader || (convert.loader = loader = boot(opts)))
+                .then((config) => dependency(config).then(() => {
+                if (locals.state === 'fresh') {
+                    const [_, capabilities, applyChanges] = config;
+                    const fn = capabilities.includes('custom-element') ? mountModern : mountClassic;
+                    applyChanges(piral);
+                    return fn(config).then(() => {
+                        locals.state = 'mounted';
+                        locals.next(config);
+                        locals.next = noop;
+                    });
                 }
-                el.innerHTML = '';
-                state = 'removed';
-            },
-        };
-    };
+            }))
+                .catch((err) => console.error(err));
+        },
+        update(el, data, ctx, locals) {
+            enqueueChange(locals, () => {
+                var _a;
+                (_a = locals.update) === null || _a === void 0 ? void 0 : _a.call(locals, Object.assign(Object.assign({}, args), data));
+            });
+        },
+        unmount(el, locals) {
+            (0, events_1.removeGlobalEventListeners)(el);
+            el.removeAttribute('data-blazor-pilet-root');
+            locals.dispose();
+            enqueueChange(locals, locals.unmount);
+            locals.state = 'removed';
+        },
+    });
     convert.loader = loader;
+    convert.lazy = lazy;
     return convert;
 }
 exports.createConverter = createConverter;

package/lib/converter.js.map

@@ -1 +1 @@
-{"version":3,"file":"converter.js","sourceRoot":"","sources":["../src/converter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"converter.js","sourceRoot":"","sources":["../src/converter.ts"],"names":[],"mappings":"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"}

package/lib/create.d.ts

@@ -1,5 +1,5 @@
 import type { PiralPlugin } from 'piral-core';
-import type { PiletBlazorApi } from './types';
+import type { BlazorLogLevel, PiletBlazorApi, WebAssemblyStartOptions } from './types';
 /**
  * Available configuration options for the Blazor plugin.
  */
@@ -9,6 +9,26 @@ export interface BlazorConfig {
      * @default true
      */
     lazy?: boolean;
+    /**
+     * Determines the used log level, if any. Otherwise, will use
+     * the default log level (info).
+     */
+    logLevel?: BlazorLogLevel;
+    /**
+     * Determines the initial language to use, if any.
+     * Otherwise, falls back to Blazor's default language.
+     */
+    initialLanguage?: string;
+    /**
+     * Installs a function to handle language change. By default,
+     * this will hook on to the `select-language` event from Piral.
+     * @param inform The callback to use for passing in a new locale.
+     */
+    onLanguageChange?: ((inform: (language: string) => void) => void) | false;
+    /**
+     * Determines the start options to use for booting Blazor.
+     */
+    options?: WebAssemblyStartOptions;
 }
 /**
  * Creates new Pilet API extensions for integration of Blazor.

package/lib/create.js

@@ -1,30 +1,44 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBlazorApi = void 0;
-var converter_1 = require("./converter");
-var dependencies_1 = require("./dependencies");
+const converter_1 = require("./converter");
+const dependencies_1 = require("./dependencies");
+function createDefaultHandler(context) {
+    return (inform) => {
+        context.on('select-language', (ev) => {
+            inform(ev.currentLanguage);
+        });
+    };
+}
 /**
  * Creates new Pilet API extensions for integration of Blazor.
  */
-function createBlazorApi(config) {
-    if (config === void 0) { config = {}; }
-    var lazy = config.lazy;
-    return function (context) {
-        var convert = converter_1.createConverter(lazy);
-        context.converters.blazor = function (_a) {
-            var moduleName = _a.moduleName, args = _a.args, dependency = _a.dependency;
-            return convert(moduleName, dependency, args);
-        };
-        return function () {
-            var loader = dependencies_1.createDependencyLoader(convert, lazy);
+function createBlazorApi(config = {}) {
+    return (context) => {
+        const { lazy = true, initialLanguage, onLanguageChange = createDefaultHandler(context), logLevel } = config;
+        const convert = (0, converter_1.createConverter)(lazy, config.options, {
+            current: initialLanguage,
+            onChange: onLanguageChange || (() => { }),
+        }, logLevel);
+        context.converters.blazor = ({ moduleName, args, dependency, options }) => convert(moduleName, dependency, args, options);
+        return (_, meta) => {
+            const loader = (0, dependencies_1.createDependencyLoader)(convert);
+            let options;
             return {
-                defineBlazorReferences: loader.defineBlazorReferences,
-                fromBlazor: function (moduleName, args) {
+                defineBlazorReferences(references, satellites, prio) {
+                    return loader.defineBlazorReferences(references, meta, satellites, prio);
+                },
+                defineBlazorOptions(blazorOptions) {
+                    options = blazorOptions;
+                },
+                releaseBlazorReferences: loader.releaseBlazorReferences,
+                fromBlazor(moduleName, args) {
                     return {
                         type: 'blazor',
                         dependency: loader.getDependency(),
-                        moduleName: moduleName,
-                        args: args,
+                        moduleName,
+                        args,
+                        options,
                     };
                 },
             };