@akinon/app-shared 0.4.1 → 0.6.0

package/dist/cjs/events.d.ts

@@ -0,0 +1,72 @@
+export declare const EVENTS: {
+    /**
+     * The event that is emitted when the AppShell sends
+     * the application ID to the client application.
+     *
+     * AppShell → AppClient
+     */
+    SET_APP_ID: string;
+    /**
+     * The event that is emitted when client applications
+     * sends their configuration to the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    SET_CONFIG: string;
+    /**
+     * The event that is emitted when the AppShell sends
+     * data to the client application.
+     *
+     * AppShell → AppClient
+     */
+    SET_DATA: string;
+    /**
+     * The event that is emitted when client applications
+     * loads and sends their css height information to the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    SET_HEIGHT: string;
+    /**
+     * The event that is emitted to client applications when params property
+     * passed to the PluginRenderer component is received or changed.
+     *
+     * AppShell → AppClient
+     */
+    SET_PARAMS: string;
+    /**
+     * The event that is emitted when client applications trigger
+     * custom actions defined on the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    INVOKE_ACTION: string;
+    /**
+     * The event that is emitted when client applications trigger
+     * default actions defined on the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    INVOKE_DEFAULT_ACTION: string;
+    /**
+     * The event that is emitted when client applications trigger
+     * navigation for their shell application.
+     *
+     * AppClient → AppShell
+     */
+    NAVIGATE: string;
+    /**
+     * The event that is emitted when shell applications trigger
+     * navigation for their child applications.
+     *
+     * AppShell → AppClient
+     */
+    NAVIGATE_CHILD: string;
+};
+export declare const DEFAULT_ACTION_KEYS: {
+    showConfirmationDialog: string;
+    showModalDialog: string;
+    showToast: string;
+    showErrorMessage: string;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/cjs/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;IACjB;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;CAEJ,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;CAK/B,CAAC"}

package/dist/cjs/events.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ACTION_KEYS = exports.EVENTS = void 0;
+exports.EVENTS = {
+    /**
+     * The event that is emitted when the AppShell sends
+     * the application ID to the client application.
+     *
+     * AppShell → AppClient
+     */
+    SET_APP_ID: 'SET_APP_ID',
+    /**
+     * The event that is emitted when client applications
+     * sends their configuration to the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    SET_CONFIG: 'SET_CONFIG',
+    /**
+     * The event that is emitted when the AppShell sends
+     * data to the client application.
+     *
+     * AppShell → AppClient
+     */
+    SET_DATA: 'SET_DATA',
+    /**
+     * The event that is emitted when client applications
+     * loads and sends their css height information to the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    SET_HEIGHT: 'SET_HEIGHT',
+    /**
+     * The event that is emitted to client applications when params property
+     * passed to the PluginRenderer component is received or changed.
+     *
+     * AppShell → AppClient
+     */
+    SET_PARAMS: 'SET_PARAMS',
+    /**
+     * The event that is emitted when client applications trigger
+     * custom actions defined on the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    INVOKE_ACTION: 'INVOKE_ACTION',
+    /**
+     * The event that is emitted when client applications trigger
+     * default actions defined on the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    INVOKE_DEFAULT_ACTION: 'INVOKE_DEFAULT_ACTION',
+    /**
+     * The event that is emitted when client applications trigger
+     * navigation for their shell application.
+     *
+     * AppClient → AppShell
+     */
+    NAVIGATE: 'NAVIGATE',
+    /**
+     * The event that is emitted when shell applications trigger
+     * navigation for their child applications.
+     *
+     * AppShell → AppClient
+     */
+    NAVIGATE_CHILD: 'NAVIGATE_CHILD'
+};
+exports.DEFAULT_ACTION_KEYS = {
+    showConfirmationDialog: 'showConfirmationDialog',
+    showModalDialog: 'showModalDialog',
+    showToast: 'showToast',
+    showErrorMessage: 'showErrorMessage'
+};

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./events"), exports);
+__exportStar(require("./sha256"), exports);
+__exportStar(require("./types"), exports);

package/dist/{sha256.d.ts → cjs/sha256.d.ts}

@@ -1,6 +1,7 @@
 /**
+ * Hashes the value with SHA256.
  *
- * @param val
+ * @param val - Any object or value to hash with SHA256.
  * @returns
  */
 export declare const hashValue: (val: any) => Promise<string>;

package/dist/cjs/sha256.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.d.ts","sourceRoot":"","sources":["../../src/sha256.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,SAAS,QAAe,GAAG,oBAYvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAe,GAAG,oBAG5C,CAAC"}

package/dist/cjs/sha256.js

@@ -0,0 +1,36 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getShortSha256 = exports.hashValue = void 0;
+/**
+ * Hashes the value with SHA256.
+ *
+ * @param val - Any object or value to hash with SHA256.
+ * @returns
+ */
+const hashValue = (val) => __awaiter(void 0, void 0, void 0, function* () {
+    const hash = yield crypto.subtle.digest('SHA-256', new TextEncoder().encode(JSON.stringify(val)));
+    const hexes = [], view = new DataView(hash);
+    for (let i = 0; i < view.byteLength; i += 4)
+        hexes.push(('00000000' + view.getUint32(i).toString(16)).slice(-8));
+    return hexes.join('');
+});
+exports.hashValue = hashValue;
+/**
+ * Returns the first 7 chars of hashed value. Sohuld be unique.
+ *
+ * @param val - Any object or value to hash with SHA256.
+ */
+const getShortSha256 = (val) => __awaiter(void 0, void 0, void 0, function* () {
+    const hash = yield (0, exports.hashValue)(val);
+    return hash.slice(0, 7);
+});
+exports.getShortSha256 = getShortSha256;

package/dist/cjs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,IAAI,EAAE,IAAI,EAAE,CAAC;CACd;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAE9B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IAEjC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACrE,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,KAC1D,IAAI,CAAC;IACV,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5D,OAAO,EAAE;QAGP,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;KACxC,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,IAAI,CAAC;CAC3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;CAChE;AAED;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC"}

package/dist/cjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/esm/events.d.ts

@@ -0,0 +1,72 @@
+export declare const EVENTS: {
+    /**
+     * The event that is emitted when the AppShell sends
+     * the application ID to the client application.
+     *
+     * AppShell → AppClient
+     */
+    SET_APP_ID: string;
+    /**
+     * The event that is emitted when client applications
+     * sends their configuration to the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    SET_CONFIG: string;
+    /**
+     * The event that is emitted when the AppShell sends
+     * data to the client application.
+     *
+     * AppShell → AppClient
+     */
+    SET_DATA: string;
+    /**
+     * The event that is emitted when client applications
+     * loads and sends their css height information to the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    SET_HEIGHT: string;
+    /**
+     * The event that is emitted to client applications when params property
+     * passed to the PluginRenderer component is received or changed.
+     *
+     * AppShell → AppClient
+     */
+    SET_PARAMS: string;
+    /**
+     * The event that is emitted when client applications trigger
+     * custom actions defined on the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    INVOKE_ACTION: string;
+    /**
+     * The event that is emitted when client applications trigger
+     * default actions defined on the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    INVOKE_DEFAULT_ACTION: string;
+    /**
+     * The event that is emitted when client applications trigger
+     * navigation for their shell application.
+     *
+     * AppClient → AppShell
+     */
+    NAVIGATE: string;
+    /**
+     * The event that is emitted when shell applications trigger
+     * navigation for their child applications.
+     *
+     * AppShell → AppClient
+     */
+    NAVIGATE_CHILD: string;
+};
+export declare const DEFAULT_ACTION_KEYS: {
+    showConfirmationDialog: string;
+    showModalDialog: string;
+    showToast: string;
+    showErrorMessage: string;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/esm/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;IACjB;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;CAEJ,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;CAK/B,CAAC"}

package/dist/esm/events.js

@@ -0,0 +1,71 @@
+export const EVENTS = {
+    /**
+     * The event that is emitted when the AppShell sends
+     * the application ID to the client application.
+     *
+     * AppShell → AppClient
+     */
+    SET_APP_ID: 'SET_APP_ID',
+    /**
+     * The event that is emitted when client applications
+     * sends their configuration to the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    SET_CONFIG: 'SET_CONFIG',
+    /**
+     * The event that is emitted when the AppShell sends
+     * data to the client application.
+     *
+     * AppShell → AppClient
+     */
+    SET_DATA: 'SET_DATA',
+    /**
+     * The event that is emitted when client applications
+     * loads and sends their css height information to the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    SET_HEIGHT: 'SET_HEIGHT',
+    /**
+     * The event that is emitted to client applications when params property
+     * passed to the PluginRenderer component is received or changed.
+     *
+     * AppShell → AppClient
+     */
+    SET_PARAMS: 'SET_PARAMS',
+    /**
+     * The event that is emitted when client applications trigger
+     * custom actions defined on the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    INVOKE_ACTION: 'INVOKE_ACTION',
+    /**
+     * The event that is emitted when client applications trigger
+     * default actions defined on the AppShell.
+     *
+     * AppClient → AppShell
+     */
+    INVOKE_DEFAULT_ACTION: 'INVOKE_DEFAULT_ACTION',
+    /**
+     * The event that is emitted when client applications trigger
+     * navigation for their shell application.
+     *
+     * AppClient → AppShell
+     */
+    NAVIGATE: 'NAVIGATE',
+    /**
+     * The event that is emitted when shell applications trigger
+     * navigation for their child applications.
+     *
+     * AppShell → AppClient
+     */
+    NAVIGATE_CHILD: 'NAVIGATE_CHILD'
+};
+export const DEFAULT_ACTION_KEYS = {
+    showConfirmationDialog: 'showConfirmationDialog',
+    showModalDialog: 'showModalDialog',
+    showToast: 'showToast',
+    showErrorMessage: 'showErrorMessage'
+};

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+export * from './events';
+export * from './sha256';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+export * from './events';
+export * from './sha256';
+export * from './types';

package/dist/esm/sha256.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hashes the value with SHA256.
+ *
+ * @param val - Any object or value to hash with SHA256.
+ * @returns
+ */
+export declare const hashValue: (val: any) => Promise<string>;
+/**
+ * Returns the first 7 chars of hashed value. Sohuld be unique.
+ *
+ * @param val - Any object or value to hash with SHA256.
+ */
+export declare const getShortSha256: (val: any) => Promise<string>;
+//# sourceMappingURL=sha256.d.ts.map

package/dist/esm/sha256.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.d.ts","sourceRoot":"","sources":["../../src/sha256.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,SAAS,QAAe,GAAG,oBAYvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAe,GAAG,oBAG5C,CAAC"}

package/dist/esm/sha256.js

@@ -0,0 +1,31 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * Hashes the value with SHA256.
+ *
+ * @param val - Any object or value to hash with SHA256.
+ * @returns
+ */
+export const hashValue = (val) => __awaiter(void 0, void 0, void 0, function* () {
+    const hash = yield crypto.subtle.digest('SHA-256', new TextEncoder().encode(JSON.stringify(val)));
+    const hexes = [], view = new DataView(hash);
+    for (let i = 0; i < view.byteLength; i += 4)
+        hexes.push(('00000000' + view.getUint32(i).toString(16)).slice(-8));
+    return hexes.join('');
+});
+/**
+ * Returns the first 7 chars of hashed value. Sohuld be unique.
+ *
+ * @param val - Any object or value to hash with SHA256.
+ */
+export const getShortSha256 = (val) => __awaiter(void 0, void 0, void 0, function* () {
+    const hash = yield hashValue(val);
+    return hash.slice(0, 7);
+});

package/dist/esm/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Represents the type of a registered application within the system.
+ * @typedef {('fullpage' | 'plugin')} RegisteredAppType
+ */
+export type RegisteredAppType = 'fullpage' | 'plugin';
+/**
+ * Defines the structure of a registered application, including its type,
+ * unique identifier, URL, and slug.
+ * @typedef {Object} RegisteredApp
+ * @property {number} id - The unique identifier of the application.
+ * @property {string} url - The URL where the application is hosted.
+ * @property {string} slug - A short, unique string used to identify the application.
+ * @property {RegisteredAppType} type - The type of the application (e.g., 'fullpage' or 'plugin').
+ */
+export type RegisteredApp = {
+    id: number;
+    name?: string;
+    url: string;
+    slug: string;
+    type: RegisteredAppType;
+};
+/**
+ * Describes a page within an application, including its navigation path and label.
+ * @typedef {Object} Page
+ * @property {string} path - The navigation path of the page.
+ * @property {string} label - The label used for displaying the page in menus or navigation elements.
+ */
+export type Page = {
+    path: string;
+    label: string;
+};
+/**
+ * Common configuration settings for applications, which may include options for
+ * development mode, redirection behavior, and menu structure. This base configuration
+ * is applicable to both full-page and plugin applications.
+ *
+ * @typedef {Object} ApplicationConfig
+ * @property {boolean} [isDev=false] - Indicates if the application is running in development mode. This can
+ *                                      enable more verbose logging or debugging features.
+ * @property {boolean} [forceRedirect=false] - Indicates if the application should force a redirect into an
+ *                                             iframe context, enhancing security and encapsulation.
+ */
+export interface ApplicationConfig {
+    isDev?: boolean;
+    forceRedirect?: boolean;
+}
+/**
+ * Configuration settings for full-page applications, extending the common `ApplicationConfig`.
+ * Full-page applications typically occupy the entire viewport and may have a menu for
+ * navigation.
+ *
+ * Inherits all properties from `ApplicationConfig` with no additional specific properties, but
+ * explicitly restates `menu` to emphasize its relevance to full-page applications.
+ *
+ * @typedef {Object} FullpageApplicationConfig
+ * @extends ApplicationConfig
+ * @property {ShellNavigation} [navigation] - - Navigation object for the
+ * client itself. Provides a way for main applications to trigger navigation on
+ * fullpage applications.
+ * @property {Page[]} [menu] - List of menu items that should be handled by
+ * shell applications.
+ */
+export interface FullpageApplicationConfig extends ApplicationConfig {
+    navigation?: ApplicationNavigation;
+    menu: Page[];
+}
+/**
+ * Configuration settings for plugin applications, which are smaller applications or widgets
+ * embedded within a larger application context. Extends the common `ApplicationConfig` with
+ * an additional property specific to plugins.
+ *
+ * Plugin applications are designed to be embedded and might require a specific placeholder
+ * within the DOM where they can be loaded.
+ *
+ * @typedef {Object} PluginApplicationConfig
+ * @extends ApplicationConfig
+ * @property {string} placeholderId - The ID of the DOM element where the plugin application
+ *                                    should be rendered. This allows the application to be
+ *                                    dynamically inserted into the correct location within
+ *                                    the host environment.
+ */
+export interface PluginApplicationConfig extends ApplicationConfig {
+    placeholderId: string | string[];
+}
+/**
+ * A flexible data structure for storing application data, with string keys and any type of value.
+ * @typedef {Object} ApplicationData
+ */
+export interface ApplicationData {
+    [key: string]: any;
+}
+/**
+ * Defines actions that can be shared across applications, including default UI actions and custom actions.
+ * @typedef {Object} ApplicationActions
+ * @property {Function} [showModalDialog] - Optional. A function to show a modal dialog.
+ * @property {Function} [showConfirmationDialog] - Optional. A function to show a confirmation dialog.
+ * @property {Function} [showToast] - Optional. A function to show a toast message.
+ * @property {Function} [showErrorMessage] - Optional. A function to display an error message.
+ * @property {Object} actions - A collection of custom actions that can be invoked.
+ */
+export interface ApplicationActions {
+    showModalDialog?: (title: string, content: string) => void;
+    showConfirmationDialog?: (title: string, content: string) => boolean;
+    showToast?: (content: string, type: 'success' | 'warning' | 'error' | 'loading' | 'destroy') => void;
+    showErrorMessage?: (title: string, content: string) => void;
+    actions: {
+        [key: string]: (...args: any[]) => any;
+    };
+}
+export interface ShellNavigationPayload {
+    id?: number;
+    path: string;
+    external?: boolean;
+}
+/**
+ * Provides a mechanism for navigating within the shell application.
+ *
+ * @typedef {Object} ShellNavigation
+ * @property {Function} navigate - A function that performs navigation to the specified URL.
+ */
+export interface ShellNavigation {
+    navigate: (payload: ShellNavigationPayload) => void;
+}
+export interface ApplicationNavigationPayload {
+    path: string;
+}
+/**
+ * Provides a mechanism for navigating within the application.
+ *
+ * @typedef {Object} ApplicationNavigation
+ * @property {Function} navigate - A function that performs navigation to the specified URL.
+ */
+export interface ApplicationNavigation {
+    navigate: (payload: ApplicationNavigationPayload) => void;
+}
+/**
+ * Defines the structure of an application's parameters.
+ * @typedef {Object} ApplicationParams
+ * @property {string} [key] - The key of the parameter.
+ * @property {string | number | boolean | string[] | number[]} [value] - The value of the parameter.
+ */
+export interface ApplicationParams {
+    [key: string]: string | number | boolean | string[] | number[];
+}
+/**
+ * Represents a custom event with flexible data structure for storing event-specific data.
+ * @typedef {Object} CustomDataEvent
+ */
+export type CustomDataEvent = {
+    [key: string]: any;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,IAAI,EAAE,IAAI,EAAE,CAAC;CACd;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAE9B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IAEjC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACrE,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,KAC1D,IAAI,CAAC;IACV,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5D,OAAO,EAAE;QAGP,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;KACxC,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,IAAI,CAAC;CAC3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;CAChE;AAED;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC"}

package/dist/esm/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,34 +1,41 @@
 {
   "name": "@akinon/app-shared",
   "description": "Shared utilities and helper functions for app-shell and app-client packages.",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "private": false,
   "type": "module",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
+  "main": "dist/esm/index.js",
+  "module": "dist/esm/index.js",
   "files": [
     "dist"
   ],
   "dependencies": {},
   "devDependencies": {
     "clean-package": "2.2.0",
-    "@akinon/vite-config": "^0.1.1",
-    "eslint-config-custom": "0.1.0",
-    "tsconfig": "0.0.0"
+    "copyfiles": "^2.4.1",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.2.2",
+    "@akinon/typescript-config": "0.0.0",
+    "@akinon/eslint-config": "0.1.0",
+    "@akinon/vite-config": "0.2.0"
   },
   "peerDependencies": {},
   "clean-package": "../../clean-package.config.json",
-  "types": "dist/index.d.ts",
+  "types": "dist/esm/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
     },
     "./package.json": "./package.json"
   },
   "scripts": {
-    "build": "vite build",
+    "build": "pnpm run build:esm && pnpm run build:commonjs && pnpm run copy:files",
+    "build:esm": "tsc --outDir dist/esm",
+    "build:commonjs": "tsc --module commonjs --outDir dist/cjs",
+    "copy:files": "copyfiles -u 1 src/**/*.css dist/esm && copyfiles -u 1 src/**/*.css dist/cjs",
+    "clean": "rimraf dist/",
     "lint": "eslint *.ts*",
     "test": "vitest run",
     "test:ui": "vitest --ui",

package/dist/events.d.ts

@@ -1,2 +0,0 @@
-export declare const EVENTS: {};
-//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,IAAK,CAAC"}

package/dist/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h={},o=async t=>{const s=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(JSON.stringify(t))),n=[],a=new DataView(s);for(let e=0;e<a.byteLength;e+=4)n.push(("00000000"+a.getUint32(e).toString(16)).slice(-8));return n.join("")},i=async t=>(await o(t)).slice(0,7);exports.EVENTS=h;exports.getShortSha256=i;exports.hashValue=o;

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -1,14 +0,0 @@
-const c = {}, o = async (t) => {
-  const n = await crypto.subtle.digest(
-    "SHA-256",
-    new TextEncoder().encode(JSON.stringify(t))
-  ), s = [], a = new DataView(n);
-  for (let e = 0; e < a.byteLength; e += 4)
-    s.push(("00000000" + a.getUint32(e).toString(16)).slice(-8));
-  return s.join("");
-}, h = async (t) => (await o(t)).slice(0, 7);
-export {
-  c as EVENTS,
-  h as getShortSha256,
-  o as hashValue
-};

package/dist/sha256.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sha256.d.ts","sourceRoot":"","sources":["../src/sha256.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAe,GAAG,oBAYvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAe,GAAG,oBAG5C,CAAC"}

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,IAAI,EAAE,IAAI,EAAE,CAAC;CACd;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAE9B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IAEjC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACrE,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,KAC1D,IAAI,CAAC;IACV,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5D,OAAO,EAAE;QAGP,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;KACxC,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,IAAI,CAAC;CAC3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;CAChE;AAED;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC"}