@miaixz/sdk 0.5.0

package/dist/contracts/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/contracts/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,wBAAwB,GAAG,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC5F"}

package/dist/contracts/lifecycle.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lifecycle.js.map

package/dist/contracts/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/contracts/lifecycle.ts"],"names":[],"mappings":"","sourcesContent":["import type { MiaixzHostBridge } from \"./host-context.js\";\nimport type { MiaixzModuleManifest } from \"./module-manifest.js\";\n\n/**\n * Provides the host-owned resources required to mount an integrated module.\n *\n * @public\n */\nexport interface MiaixzModuleMountContext {\n  /**\n   * DOM container owned by the host application.\n   */\n  readonly container: HTMLElement;\n\n  /**\n   * Capability-limited bridge supplied by the host.\n   */\n  readonly bridge: MiaixzHostBridge;\n\n  /**\n   * Validated immutable manifest associated with the module.\n   */\n  readonly manifest: Readonly<MiaixzModuleManifest>;\n}\n\n/**\n * Represents the resources returned by a mounted integrated module.\n *\n * @public\n */\nexport interface MiaixzModuleHandle {\n  /**\n   * Releases every resource created by the mounted module.\n   *\n   * @returns Nothing, or a promise resolved after asynchronous cleanup.\n   */\n  unmount(): void | Promise<void>;\n}\n\n/**\n * Defines the only lifecycle entry exposed by an integrated module.\n *\n * @public\n */\nexport interface MiaixzIntegratedModule {\n  /**\n   * Mounts the module into its host-owned container.\n   *\n   * @param context - Validated host resources supplied to the module.\n   * @returns Handle used by the host to unmount the module.\n   */\n  mount(context: MiaixzModuleMountContext): MiaixzModuleHandle | Promise<MiaixzModuleHandle>;\n}\n"]}

package/dist/contracts/module-manifest.d.ts

@@ -0,0 +1,110 @@
+import type { MiaixzEnvironment } from "../types/index.js";
+import { type MiaixzModuleNavigationItem } from "./navigation.js";
+import { type MiaixzModuleRoute } from "./route.js";
+/**
+ * Version of the Miaixz micro-frontend manifest and lifecycle protocol.
+ *
+ * @public
+ */
+export declare const MIAIXZ_MODULE_PROTOCOL_VERSION: "1.0.0";
+/**
+ * Identifies how a module is loaded and isolated by its host.
+ *
+ * @public
+ */
+export type MiaixzModuleKind = "integrated" | "iframe";
+/**
+ * Identifies one host capability that a module may require.
+ *
+ * @public
+ */
+export type MiaixzHostCapability = "context" | "events" | "i18n" | "navigation" | "permissions";
+/**
+ * Describes a pure-data manifest for one independently deployed frontend module.
+ *
+ * @public
+ */
+export interface MiaixzModuleManifest {
+    /**
+     * Protocol version understood by the module.
+     */
+    readonly protocolVersion: "1.0.0";
+    /**
+     * Globally stable kebab-case module identifier.
+     */
+    readonly id: string;
+    /**
+     * Complete semantic version of the module release.
+     */
+    readonly version: string;
+    /**
+     * Caret range describing the minimum compatible host release.
+     */
+    readonly hostVersion: string;
+    /**
+     * Loading and isolation strategy used by the module.
+     */
+    readonly kind: MiaixzModuleKind;
+    /**
+     * Static host path reserved for the module.
+     */
+    readonly basePath: string;
+    /**
+     * Integrated module identifier or iframe deployment URL.
+     */
+    readonly entry: string;
+    /**
+     * Routes contributed by the module.
+     */
+    readonly routes: readonly MiaixzModuleRoute[];
+    /**
+     * Navigation items contributed by the module.
+     */
+    readonly navigation: readonly MiaixzModuleNavigationItem[];
+    /**
+     * Permissions required before the module may load.
+     */
+    readonly requiredPermissions: readonly string[];
+    /**
+     * Host capabilities required by the module.
+     */
+    readonly requiredCapabilities: readonly MiaixzHostCapability[];
+}
+/**
+ * Configures environment-specific and host-version manifest validation.
+ *
+ * @public
+ */
+export interface MiaixzModuleManifestParseOptions {
+    /**
+     * Runtime environment used to validate iframe URLs.
+     *
+     * @defaultValue `"production"`
+     */
+    readonly environment?: MiaixzEnvironment;
+    /**
+     * Optional concrete host version checked against the manifest range.
+     */
+    readonly hostVersion?: string;
+}
+/**
+ * Determines whether a concrete host satisfies the frozen caret-range compatibility rule.
+ *
+ * @param hostVersion - Concrete complete semantic version of the host.
+ * @param requiredHostVersion - Required caret range in `^MAJOR.MINOR.PATCH` form.
+ * @returns Whether majors match and the host is at least the required range floor.
+ * @public
+ */
+export declare function isMiaixzHostVersionCompatible(hostVersion: string, requiredHostVersion: string): boolean;
+/**
+ * Parses, validates, sorts, and deeply freezes a remote module manifest.
+ *
+ * @param value - Untrusted manifest candidate.
+ * @param options - Optional runtime environment and concrete host version.
+ * @returns A deeply immutable manifest copy owned by the SDK.
+ * @throws MiaixzSdkError With `MODULE_MANIFEST_INVALID` for malformed manifest data.
+ * @throws MiaixzSdkError With `MODULE_HOST_INCOMPATIBLE` for an incompatible concrete host.
+ * @public
+ */
+export declare function parseMiaixzModuleManifest(value: unknown, options?: Readonly<MiaixzModuleManifestParseOptions>): Readonly<MiaixzModuleManifest>;
+//# sourceMappingURL=module-manifest.d.ts.map

package/dist/contracts/module-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-manifest.d.ts","sourceRoot":"","sources":["../../src/contracts/module-manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAiC,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAG,OAAgB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,GAAG,aAAa,CAAC;AAEhG;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAChE;AAED;;;;GAIG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAsKD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAST;AAkFD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,QAAQ,CAAC,gCAAgC,CAAM,GACvD,QAAQ,CAAC,oBAAoB,CAAC,CA4DhC"}

package/dist/contracts/module-manifest.js

@@ -0,0 +1,317 @@
+import { MiaixzSdkError } from "../api/errors.js";
+import { translateMiaixzDefaultMessage } from "../i18n/default-translator.js";
+import { compareMiaixzModuleNavigation } from "./navigation.js";
+import { isMiaixzModuleIdentifier, isMiaixzModulePath, isMiaixzModulePermissionList, } from "./route.js";
+/**
+ * Version of the Miaixz micro-frontend manifest and lifecycle protocol.
+ *
+ * @public
+ */
+export const MIAIXZ_MODULE_PROTOCOL_VERSION = "1.0.0";
+const manifestKeys = new Set([
+    "protocolVersion",
+    "id",
+    "version",
+    "hostVersion",
+    "kind",
+    "basePath",
+    "entry",
+    "routes",
+    "navigation",
+    "requiredPermissions",
+    "requiredCapabilities",
+]);
+const routeKeys = new Set(["id", "path", "titleKey", "requiredPermissions"]);
+const navigationKeys = new Set(["id", "routeId", "labelKey", "icon", "order"]);
+const environments = new Set(["development", "test", "staging", "production"]);
+const capabilities = new Set([
+    "context",
+    "events",
+    "i18n",
+    "navigation",
+    "permissions",
+]);
+const semanticVersionPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?$/;
+const hostVersionPattern = /^\^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+/**
+ * Creates the frozen manifest-validation error without including untrusted values.
+ *
+ * @returns Manifest-validation error using the registered public error code.
+ */
+function invalidManifest() {
+    return new MiaixzSdkError(translateMiaixzDefaultMessage("sdk.error.module.manifestInvalid"), {
+        code: "MODULE_MANIFEST_INVALID",
+    });
+}
+/**
+ * Creates the frozen host-version compatibility error without including version values.
+ *
+ * @returns Host-compatibility error using the registered public error code.
+ */
+function incompatibleHost() {
+    return new MiaixzSdkError(translateMiaixzDefaultMessage("sdk.error.module.hostIncompatible"), {
+        code: "MODULE_HOST_INCOMPATIBLE",
+    });
+}
+/**
+ * Determines whether a value is a plain JSON-style record.
+ *
+ * @param value - Value to inspect.
+ * @returns Whether the value is a plain record without a custom prototype.
+ */
+function isPlainRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/**
+ * Determines whether a record contains exactly the allowed field names.
+ *
+ * @param value - Record whose keys should be checked.
+ * @param allowed - Complete allowed key set.
+ * @returns Whether every own enumerable key is allowed.
+ */
+function hasOnlyKeys(value, allowed) {
+    return Object.keys(value).every((key) => allowed.has(key));
+}
+/**
+ * Parses a complete semantic version without build metadata.
+ *
+ * @param value - Version candidate to parse.
+ * @returns Parsed semantic version, or undefined for invalid syntax.
+ */
+function parseSemanticVersion(value) {
+    const match = semanticVersionPattern.exec(value);
+    if (!match)
+        return undefined;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        prerelease: Object.freeze(match[4]?.split(".") ?? []),
+    };
+}
+/**
+ * Parses the only host-version range syntax accepted by module manifests.
+ *
+ * @param value - Host range candidate to parse.
+ * @returns Parsed range floor, or undefined for invalid syntax.
+ */
+function parseHostVersion(value) {
+    const match = hostVersionPattern.exec(value);
+    if (!match)
+        return undefined;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        prerelease: Object.freeze([]),
+    };
+}
+/**
+ * Compares two parsed semantic versions using standard prerelease precedence.
+ *
+ * @param first - First semantic version.
+ * @param second - Second semantic version.
+ * @returns Negative, zero, or positive precedence result.
+ */
+function compareSemanticVersions(first, second) {
+    const core = first.major - second.major || first.minor - second.minor || first.patch - second.patch;
+    if (core !== 0)
+        return core;
+    if (first.prerelease.length === 0)
+        return second.prerelease.length === 0 ? 0 : 1;
+    if (second.prerelease.length === 0)
+        return -1;
+    const length = Math.max(first.prerelease.length, second.prerelease.length);
+    for (let index = 0; index < length; index += 1) {
+        const left = first.prerelease[index];
+        const right = second.prerelease[index];
+        if (left === undefined)
+            return -1;
+        if (right === undefined)
+            return 1;
+        if (left === right)
+            continue;
+        const leftNumeric = /^\d+$/.test(left);
+        const rightNumeric = /^\d+$/.test(right);
+        if (leftNumeric && rightNumeric)
+            return Number(left) - Number(right);
+        if (leftNumeric)
+            return -1;
+        if (rightNumeric)
+            return 1;
+        return left.localeCompare(right);
+    }
+    return 0;
+}
+/**
+ * Determines whether a concrete host satisfies the frozen caret-range compatibility rule.
+ *
+ * @param hostVersion - Concrete complete semantic version of the host.
+ * @param requiredHostVersion - Required caret range in `^MAJOR.MINOR.PATCH` form.
+ * @returns Whether majors match and the host is at least the required range floor.
+ * @public
+ */
+export function isMiaixzHostVersionCompatible(hostVersion, requiredHostVersion) {
+    const host = parseSemanticVersion(hostVersion);
+    const required = parseHostVersion(requiredHostVersion);
+    return (host !== undefined &&
+        required !== undefined &&
+        host.major === required.major &&
+        compareSemanticVersions(host, required) >= 0);
+}
+/**
+ * Parses one route and creates its immutable manifest-owned copy.
+ *
+ * @param value - Route candidate to parse.
+ * @param basePath - Validated module base path.
+ * @returns Frozen route copy, or undefined for invalid data.
+ */
+function parseRoute(value, basePath) {
+    if (!isPlainRecord(value) || !hasOnlyKeys(value, routeKeys))
+        return undefined;
+    if (!isMiaixzModuleIdentifier(value.id) || !isMiaixzModulePath(value.path))
+        return undefined;
+    if (typeof value.titleKey !== "string" || value.titleKey.trim().length === 0)
+        return undefined;
+    if (basePath !== "/" && (value.path === basePath || value.path.startsWith(`${basePath}/`))) {
+        return undefined;
+    }
+    if (value.requiredPermissions !== undefined &&
+        !isMiaixzModulePermissionList(value.requiredPermissions)) {
+        return undefined;
+    }
+    return Object.freeze({
+        id: value.id,
+        path: value.path,
+        titleKey: value.titleKey,
+        ...(value.requiredPermissions === undefined
+            ? {}
+            : { requiredPermissions: Object.freeze([...value.requiredPermissions]) }),
+    });
+}
+/**
+ * Parses one navigation item and creates its immutable manifest-owned copy.
+ *
+ * @param value - Navigation candidate to parse.
+ * @returns Frozen navigation item, or undefined for invalid data.
+ */
+function parseNavigation(value) {
+    if (!isPlainRecord(value) || !hasOnlyKeys(value, navigationKeys))
+        return undefined;
+    if (!isMiaixzModuleIdentifier(value.id) || !isMiaixzModuleIdentifier(value.routeId)) {
+        return undefined;
+    }
+    if (typeof value.labelKey !== "string" || value.labelKey.trim().length === 0)
+        return undefined;
+    if (value.icon !== undefined && typeof value.icon !== "string")
+        return undefined;
+    if (typeof value.order !== "number" || !Number.isFinite(value.order))
+        return undefined;
+    return Object.freeze({
+        id: value.id,
+        routeId: value.routeId,
+        labelKey: value.labelKey,
+        ...(value.icon === undefined ? {} : { icon: value.icon }),
+        order: value.order,
+    });
+}
+/**
+ * Determines whether a module entry is valid for its loading strategy and environment.
+ *
+ * @param kind - Module loading strategy.
+ * @param entry - Entry candidate to validate.
+ * @param environment - Runtime environment controlling localhost iframe support.
+ * @returns Whether the entry satisfies the selected strategy.
+ */
+function isValidEntry(kind, entry, environment) {
+    if (typeof entry !== "string" || entry.trim().length === 0 || entry !== entry.trim())
+        return false;
+    if (kind === "integrated")
+        return true;
+    try {
+        const url = new URL(entry);
+        return (url.protocol === "https:" ||
+            (environment === "test" && url.protocol === "http:" && url.hostname === "localhost"));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Parses, validates, sorts, and deeply freezes a remote module manifest.
+ *
+ * @param value - Untrusted manifest candidate.
+ * @param options - Optional runtime environment and concrete host version.
+ * @returns A deeply immutable manifest copy owned by the SDK.
+ * @throws MiaixzSdkError With `MODULE_MANIFEST_INVALID` for malformed manifest data.
+ * @throws MiaixzSdkError With `MODULE_HOST_INCOMPATIBLE` for an incompatible concrete host.
+ * @public
+ */
+export function parseMiaixzModuleManifest(value, options = {}) {
+    if (!isPlainRecord(value) || !hasOnlyKeys(value, manifestKeys))
+        throw invalidManifest();
+    const environment = options.environment ?? "production";
+    if (!environments.has(environment))
+        throw invalidManifest();
+    if (value.protocolVersion !== MIAIXZ_MODULE_PROTOCOL_VERSION)
+        throw invalidManifest();
+    if (!isMiaixzModuleIdentifier(value.id))
+        throw invalidManifest();
+    if (typeof value.version !== "string" || !parseSemanticVersion(value.version)) {
+        throw invalidManifest();
+    }
+    if (typeof value.hostVersion !== "string" || !parseHostVersion(value.hostVersion)) {
+        throw invalidManifest();
+    }
+    if (value.kind !== "integrated" && value.kind !== "iframe")
+        throw invalidManifest();
+    if (!isMiaixzModulePath(value.basePath))
+        throw invalidManifest();
+    const basePath = value.basePath;
+    if (!isValidEntry(value.kind, value.entry, environment))
+        throw invalidManifest();
+    if (!Array.isArray(value.routes) || !Array.isArray(value.navigation))
+        throw invalidManifest();
+    if (!isMiaixzModulePermissionList(value.requiredPermissions))
+        throw invalidManifest();
+    if (!Array.isArray(value.requiredCapabilities) ||
+        !value.requiredCapabilities.every((capability) => typeof capability === "string" && capabilities.has(capability))) {
+        throw invalidManifest();
+    }
+    const routes = value.routes.map((route) => parseRoute(route, basePath));
+    if (routes.some((route) => route === undefined))
+        throw invalidManifest();
+    const navigation = value.navigation.map(parseNavigation);
+    if (navigation.some((item) => item === undefined))
+        throw invalidManifest();
+    const parsedRoutes = routes;
+    const parsedNavigation = navigation;
+    const routeIds = new Set(parsedRoutes.map((route) => route.id));
+    const navigationIds = new Set(parsedNavigation.map((item) => item.id));
+    if (routeIds.size !== parsedRoutes.length || navigationIds.size !== parsedNavigation.length) {
+        throw invalidManifest();
+    }
+    if (parsedNavigation.some((item) => !routeIds.has(item.routeId)))
+        throw invalidManifest();
+    if (options.hostVersion !== undefined &&
+        !isMiaixzHostVersionCompatible(options.hostVersion, value.hostVersion)) {
+        throw incompatibleHost();
+    }
+    return Object.freeze({
+        protocolVersion: MIAIXZ_MODULE_PROTOCOL_VERSION,
+        id: value.id,
+        version: value.version,
+        hostVersion: value.hostVersion,
+        kind: value.kind,
+        basePath,
+        entry: value.entry,
+        routes: Object.freeze([...parsedRoutes]),
+        navigation: Object.freeze([...parsedNavigation].sort(compareMiaixzModuleNavigation)),
+        requiredPermissions: Object.freeze([...value.requiredPermissions]),
+        requiredCapabilities: Object.freeze([...value.requiredCapabilities]),
+    });
+}
+//# sourceMappingURL=module-manifest.js.map

package/dist/contracts/module-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-manifest.js","sourceRoot":"","sources":["../../src/contracts/module-manifest.ts"],"names":[],"mappings":"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","sourcesContent":["import { MiaixzSdkError } from \"../api/errors.js\";\nimport { translateMiaixzDefaultMessage } from \"../i18n/default-translator.js\";\nimport type { MiaixzEnvironment } from \"../types/index.js\";\nimport { compareMiaixzModuleNavigation, type MiaixzModuleNavigationItem } from \"./navigation.js\";\nimport {\n  isMiaixzModuleIdentifier,\n  isMiaixzModulePath,\n  isMiaixzModulePermissionList,\n  type MiaixzModuleRoute,\n} from \"./route.js\";\n\n/**\n * Version of the Miaixz micro-frontend manifest and lifecycle protocol.\n *\n * @public\n */\nexport const MIAIXZ_MODULE_PROTOCOL_VERSION = \"1.0.0\" as const;\n\n/**\n * Identifies how a module is loaded and isolated by its host.\n *\n * @public\n */\nexport type MiaixzModuleKind = \"integrated\" | \"iframe\";\n\n/**\n * Identifies one host capability that a module may require.\n *\n * @public\n */\nexport type MiaixzHostCapability = \"context\" | \"events\" | \"i18n\" | \"navigation\" | \"permissions\";\n\n/**\n * Describes a pure-data manifest for one independently deployed frontend module.\n *\n * @public\n */\nexport interface MiaixzModuleManifest {\n  /**\n   * Protocol version understood by the module.\n   */\n  readonly protocolVersion: \"1.0.0\";\n\n  /**\n   * Globally stable kebab-case module identifier.\n   */\n  readonly id: string;\n\n  /**\n   * Complete semantic version of the module release.\n   */\n  readonly version: string;\n\n  /**\n   * Caret range describing the minimum compatible host release.\n   */\n  readonly hostVersion: string;\n\n  /**\n   * Loading and isolation strategy used by the module.\n   */\n  readonly kind: MiaixzModuleKind;\n\n  /**\n   * Static host path reserved for the module.\n   */\n  readonly basePath: string;\n\n  /**\n   * Integrated module identifier or iframe deployment URL.\n   */\n  readonly entry: string;\n\n  /**\n   * Routes contributed by the module.\n   */\n  readonly routes: readonly MiaixzModuleRoute[];\n\n  /**\n   * Navigation items contributed by the module.\n   */\n  readonly navigation: readonly MiaixzModuleNavigationItem[];\n\n  /**\n   * Permissions required before the module may load.\n   */\n  readonly requiredPermissions: readonly string[];\n\n  /**\n   * Host capabilities required by the module.\n   */\n  readonly requiredCapabilities: readonly MiaixzHostCapability[];\n}\n\n/**\n * Configures environment-specific and host-version manifest validation.\n *\n * @public\n */\nexport interface MiaixzModuleManifestParseOptions {\n  /**\n   * Runtime environment used to validate iframe URLs.\n   *\n   * @defaultValue `\"production\"`\n   */\n  readonly environment?: MiaixzEnvironment;\n\n  /**\n   * Optional concrete host version checked against the manifest range.\n   */\n  readonly hostVersion?: string;\n}\n\ninterface MiaixzParsedSemanticVersion {\n  /**\n   * Major semantic-version number.\n   */\n  readonly major: number;\n\n  /**\n   * Minor semantic-version number.\n   */\n  readonly minor: number;\n\n  /**\n   * Patch semantic-version number.\n   */\n  readonly patch: number;\n\n  /**\n   * Optional prerelease identifiers.\n   */\n  readonly prerelease: readonly string[];\n}\n\nconst manifestKeys = new Set([\n  \"protocolVersion\",\n  \"id\",\n  \"version\",\n  \"hostVersion\",\n  \"kind\",\n  \"basePath\",\n  \"entry\",\n  \"routes\",\n  \"navigation\",\n  \"requiredPermissions\",\n  \"requiredCapabilities\",\n]);\nconst routeKeys = new Set([\"id\", \"path\", \"titleKey\", \"requiredPermissions\"]);\nconst navigationKeys = new Set([\"id\", \"routeId\", \"labelKey\", \"icon\", \"order\"]);\nconst environments = new Set<MiaixzEnvironment>([\"development\", \"test\", \"staging\", \"production\"]);\nconst capabilities = new Set<MiaixzHostCapability>([\n  \"context\",\n  \"events\",\n  \"i18n\",\n  \"navigation\",\n  \"permissions\",\n]);\nconst semanticVersionPattern =\n  /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?$/;\nconst hostVersionPattern = /^\\^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$/;\n\n/**\n * Creates the frozen manifest-validation error without including untrusted values.\n *\n * @returns Manifest-validation error using the registered public error code.\n */\nfunction invalidManifest(): MiaixzSdkError {\n  return new MiaixzSdkError(translateMiaixzDefaultMessage(\"sdk.error.module.manifestInvalid\"), {\n    code: \"MODULE_MANIFEST_INVALID\",\n  });\n}\n\n/**\n * Creates the frozen host-version compatibility error without including version values.\n *\n * @returns Host-compatibility error using the registered public error code.\n */\nfunction incompatibleHost(): MiaixzSdkError {\n  return new MiaixzSdkError(translateMiaixzDefaultMessage(\"sdk.error.module.hostIncompatible\"), {\n    code: \"MODULE_HOST_INCOMPATIBLE\",\n  });\n}\n\n/**\n * Determines whether a value is a plain JSON-style record.\n *\n * @param value - Value to inspect.\n * @returns Whether the value is a plain record without a custom prototype.\n */\nfunction isPlainRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return false;\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\n/**\n * Determines whether a record contains exactly the allowed field names.\n *\n * @param value - Record whose keys should be checked.\n * @param allowed - Complete allowed key set.\n * @returns Whether every own enumerable key is allowed.\n */\nfunction hasOnlyKeys(\n  value: Readonly<Record<string, unknown>>,\n  allowed: ReadonlySet<string>,\n): boolean {\n  return Object.keys(value).every((key) => allowed.has(key));\n}\n\n/**\n * Parses a complete semantic version without build metadata.\n *\n * @param value - Version candidate to parse.\n * @returns Parsed semantic version, or undefined for invalid syntax.\n */\nfunction parseSemanticVersion(value: string): MiaixzParsedSemanticVersion | undefined {\n  const match = semanticVersionPattern.exec(value);\n  if (!match) return undefined;\n  return {\n    major: Number(match[1]),\n    minor: Number(match[2]),\n    patch: Number(match[3]),\n    prerelease: Object.freeze(match[4]?.split(\".\") ?? []),\n  };\n}\n\n/**\n * Parses the only host-version range syntax accepted by module manifests.\n *\n * @param value - Host range candidate to parse.\n * @returns Parsed range floor, or undefined for invalid syntax.\n */\nfunction parseHostVersion(value: string): MiaixzParsedSemanticVersion | undefined {\n  const match = hostVersionPattern.exec(value);\n  if (!match) return undefined;\n  return {\n    major: Number(match[1]),\n    minor: Number(match[2]),\n    patch: Number(match[3]),\n    prerelease: Object.freeze([]),\n  };\n}\n\n/**\n * Compares two parsed semantic versions using standard prerelease precedence.\n *\n * @param first - First semantic version.\n * @param second - Second semantic version.\n * @returns Negative, zero, or positive precedence result.\n */\nfunction compareSemanticVersions(\n  first: MiaixzParsedSemanticVersion,\n  second: MiaixzParsedSemanticVersion,\n): number {\n  const core =\n    first.major - second.major || first.minor - second.minor || first.patch - second.patch;\n  if (core !== 0) return core;\n  if (first.prerelease.length === 0) return second.prerelease.length === 0 ? 0 : 1;\n  if (second.prerelease.length === 0) return -1;\n  const length = Math.max(first.prerelease.length, second.prerelease.length);\n  for (let index = 0; index < length; index += 1) {\n    const left = first.prerelease[index];\n    const right = second.prerelease[index];\n    if (left === undefined) return -1;\n    if (right === undefined) return 1;\n    if (left === right) continue;\n    const leftNumeric = /^\\d+$/.test(left);\n    const rightNumeric = /^\\d+$/.test(right);\n    if (leftNumeric && rightNumeric) return Number(left) - Number(right);\n    if (leftNumeric) return -1;\n    if (rightNumeric) return 1;\n    return left.localeCompare(right);\n  }\n  return 0;\n}\n\n/**\n * Determines whether a concrete host satisfies the frozen caret-range compatibility rule.\n *\n * @param hostVersion - Concrete complete semantic version of the host.\n * @param requiredHostVersion - Required caret range in `^MAJOR.MINOR.PATCH` form.\n * @returns Whether majors match and the host is at least the required range floor.\n * @public\n */\nexport function isMiaixzHostVersionCompatible(\n  hostVersion: string,\n  requiredHostVersion: string,\n): boolean {\n  const host = parseSemanticVersion(hostVersion);\n  const required = parseHostVersion(requiredHostVersion);\n  return (\n    host !== undefined &&\n    required !== undefined &&\n    host.major === required.major &&\n    compareSemanticVersions(host, required) >= 0\n  );\n}\n\n/**\n * Parses one route and creates its immutable manifest-owned copy.\n *\n * @param value - Route candidate to parse.\n * @param basePath - Validated module base path.\n * @returns Frozen route copy, or undefined for invalid data.\n */\nfunction parseRoute(value: unknown, basePath: string): Readonly<MiaixzModuleRoute> | undefined {\n  if (!isPlainRecord(value) || !hasOnlyKeys(value, routeKeys)) return undefined;\n  if (!isMiaixzModuleIdentifier(value.id) || !isMiaixzModulePath(value.path)) return undefined;\n  if (typeof value.titleKey !== \"string\" || value.titleKey.trim().length === 0) return undefined;\n  if (basePath !== \"/\" && (value.path === basePath || value.path.startsWith(`${basePath}/`))) {\n    return undefined;\n  }\n  if (\n    value.requiredPermissions !== undefined &&\n    !isMiaixzModulePermissionList(value.requiredPermissions)\n  ) {\n    return undefined;\n  }\n  return Object.freeze({\n    id: value.id,\n    path: value.path,\n    titleKey: value.titleKey,\n    ...(value.requiredPermissions === undefined\n      ? {}\n      : { requiredPermissions: Object.freeze([...value.requiredPermissions]) }),\n  });\n}\n\n/**\n * Parses one navigation item and creates its immutable manifest-owned copy.\n *\n * @param value - Navigation candidate to parse.\n * @returns Frozen navigation item, or undefined for invalid data.\n */\nfunction parseNavigation(value: unknown): Readonly<MiaixzModuleNavigationItem> | undefined {\n  if (!isPlainRecord(value) || !hasOnlyKeys(value, navigationKeys)) return undefined;\n  if (!isMiaixzModuleIdentifier(value.id) || !isMiaixzModuleIdentifier(value.routeId)) {\n    return undefined;\n  }\n  if (typeof value.labelKey !== \"string\" || value.labelKey.trim().length === 0) return undefined;\n  if (value.icon !== undefined && typeof value.icon !== \"string\") return undefined;\n  if (typeof value.order !== \"number\" || !Number.isFinite(value.order)) return undefined;\n  return Object.freeze({\n    id: value.id,\n    routeId: value.routeId,\n    labelKey: value.labelKey,\n    ...(value.icon === undefined ? {} : { icon: value.icon }),\n    order: value.order,\n  });\n}\n\n/**\n * Determines whether a module entry is valid for its loading strategy and environment.\n *\n * @param kind - Module loading strategy.\n * @param entry - Entry candidate to validate.\n * @param environment - Runtime environment controlling localhost iframe support.\n * @returns Whether the entry satisfies the selected strategy.\n */\nfunction isValidEntry(\n  kind: MiaixzModuleKind,\n  entry: unknown,\n  environment: MiaixzEnvironment,\n): entry is string {\n  if (typeof entry !== \"string\" || entry.trim().length === 0 || entry !== entry.trim())\n    return false;\n  if (kind === \"integrated\") return true;\n  try {\n    const url = new URL(entry);\n    return (\n      url.protocol === \"https:\" ||\n      (environment === \"test\" && url.protocol === \"http:\" && url.hostname === \"localhost\")\n    );\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Parses, validates, sorts, and deeply freezes a remote module manifest.\n *\n * @param value - Untrusted manifest candidate.\n * @param options - Optional runtime environment and concrete host version.\n * @returns A deeply immutable manifest copy owned by the SDK.\n * @throws MiaixzSdkError With `MODULE_MANIFEST_INVALID` for malformed manifest data.\n * @throws MiaixzSdkError With `MODULE_HOST_INCOMPATIBLE` for an incompatible concrete host.\n * @public\n */\nexport function parseMiaixzModuleManifest(\n  value: unknown,\n  options: Readonly<MiaixzModuleManifestParseOptions> = {},\n): Readonly<MiaixzModuleManifest> {\n  if (!isPlainRecord(value) || !hasOnlyKeys(value, manifestKeys)) throw invalidManifest();\n  const environment = options.environment ?? \"production\";\n  if (!environments.has(environment)) throw invalidManifest();\n  if (value.protocolVersion !== MIAIXZ_MODULE_PROTOCOL_VERSION) throw invalidManifest();\n  if (!isMiaixzModuleIdentifier(value.id)) throw invalidManifest();\n  if (typeof value.version !== \"string\" || !parseSemanticVersion(value.version)) {\n    throw invalidManifest();\n  }\n  if (typeof value.hostVersion !== \"string\" || !parseHostVersion(value.hostVersion)) {\n    throw invalidManifest();\n  }\n  if (value.kind !== \"integrated\" && value.kind !== \"iframe\") throw invalidManifest();\n  if (!isMiaixzModulePath(value.basePath)) throw invalidManifest();\n  const basePath = value.basePath;\n  if (!isValidEntry(value.kind, value.entry, environment)) throw invalidManifest();\n  if (!Array.isArray(value.routes) || !Array.isArray(value.navigation)) throw invalidManifest();\n  if (!isMiaixzModulePermissionList(value.requiredPermissions)) throw invalidManifest();\n  if (\n    !Array.isArray(value.requiredCapabilities) ||\n    !value.requiredCapabilities.every(\n      (capability): capability is MiaixzHostCapability =>\n        typeof capability === \"string\" && capabilities.has(capability as MiaixzHostCapability),\n    )\n  ) {\n    throw invalidManifest();\n  }\n\n  const routes = value.routes.map((route) => parseRoute(route, basePath));\n  if (routes.some((route) => route === undefined)) throw invalidManifest();\n  const navigation = value.navigation.map(parseNavigation);\n  if (navigation.some((item) => item === undefined)) throw invalidManifest();\n  const parsedRoutes = routes as readonly Readonly<MiaixzModuleRoute>[];\n  const parsedNavigation = navigation as readonly Readonly<MiaixzModuleNavigationItem>[];\n  const routeIds = new Set(parsedRoutes.map((route) => route.id));\n  const navigationIds = new Set(parsedNavigation.map((item) => item.id));\n  if (routeIds.size !== parsedRoutes.length || navigationIds.size !== parsedNavigation.length) {\n    throw invalidManifest();\n  }\n  if (parsedNavigation.some((item) => !routeIds.has(item.routeId))) throw invalidManifest();\n  if (\n    options.hostVersion !== undefined &&\n    !isMiaixzHostVersionCompatible(options.hostVersion, value.hostVersion)\n  ) {\n    throw incompatibleHost();\n  }\n\n  return Object.freeze({\n    protocolVersion: MIAIXZ_MODULE_PROTOCOL_VERSION,\n    id: value.id,\n    version: value.version,\n    hostVersion: value.hostVersion,\n    kind: value.kind,\n    basePath,\n    entry: value.entry,\n    routes: Object.freeze([...parsedRoutes]),\n    navigation: Object.freeze([...parsedNavigation].sort(compareMiaixzModuleNavigation)),\n    requiredPermissions: Object.freeze([...value.requiredPermissions]),\n    requiredCapabilities: Object.freeze([...value.requiredCapabilities]),\n  });\n}\n"]}

package/dist/contracts/navigation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Describes a navigation item contributed by a remotely loaded Miaixz module.
+ *
+ * @public
+ */
+export interface MiaixzModuleNavigationItem {
+    /**
+     * Module-local navigation item identifier.
+     */
+    readonly id: string;
+    /**
+     * Identifier of a route declared by the same manifest.
+     */
+    readonly routeId: string;
+    /**
+     * Internationalization key used for the navigation label.
+     */
+    readonly labelKey: string;
+    /**
+     * Optional UI icon name interpreted by the host application.
+     */
+    readonly icon?: string;
+    /**
+     * Numeric position used before the identifier tie-breaker.
+     */
+    readonly order: number;
+}
+/**
+ * Compares navigation items using the frozen order and identifier sort rules.
+ *
+ * @param first - First navigation item to compare.
+ * @param second - Second navigation item to compare.
+ * @returns Negative, zero, or positive sort result.
+ */
+export declare function compareMiaixzModuleNavigation(first: MiaixzModuleNavigationItem, second: MiaixzModuleNavigationItem): number;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/contracts/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/contracts/navigation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,0BAA0B,GACjC,MAAM,CAER"}

package/dist/contracts/navigation.js

@@ -0,0 +1,11 @@
+/**
+ * Compares navigation items using the frozen order and identifier sort rules.
+ *
+ * @param first - First navigation item to compare.
+ * @param second - Second navigation item to compare.
+ * @returns Negative, zero, or positive sort result.
+ */
+export function compareMiaixzModuleNavigation(first, second) {
+    return first.order - second.order || first.id.localeCompare(second.id);
+}
+//# sourceMappingURL=navigation.js.map

package/dist/contracts/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/contracts/navigation.ts"],"names":[],"mappings":"AAgCA;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAiC,EACjC,MAAkC;IAElC,OAAO,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACzE,CAAC","sourcesContent":["/**\n * Describes a navigation item contributed by a remotely loaded Miaixz module.\n *\n * @public\n */\nexport interface MiaixzModuleNavigationItem {\n  /**\n   * Module-local navigation item identifier.\n   */\n  readonly id: string;\n\n  /**\n   * Identifier of a route declared by the same manifest.\n   */\n  readonly routeId: string;\n\n  /**\n   * Internationalization key used for the navigation label.\n   */\n  readonly labelKey: string;\n\n  /**\n   * Optional UI icon name interpreted by the host application.\n   */\n  readonly icon?: string;\n\n  /**\n   * Numeric position used before the identifier tie-breaker.\n   */\n  readonly order: number;\n}\n\n/**\n * Compares navigation items using the frozen order and identifier sort rules.\n *\n * @param first - First navigation item to compare.\n * @param second - Second navigation item to compare.\n * @returns Negative, zero, or positive sort result.\n */\nexport function compareMiaixzModuleNavigation(\n  first: MiaixzModuleNavigationItem,\n  second: MiaixzModuleNavigationItem,\n): number {\n  return first.order - second.order || first.id.localeCompare(second.id);\n}\n"]}

package/dist/contracts/permission.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Determines whether a value is a non-wildcard permission accepted in module manifests.
+ *
+ * @param value - Permission candidate to inspect.
+ * @returns Whether the value uses the frozen lowercase three-segment format.
+ */
+export declare function isMiaixzModulePermission(value: unknown): value is string;
+//# sourceMappingURL=permission.d.ts.map

package/dist/contracts/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../src/contracts/permission.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExE"}

package/dist/contracts/permission.js

@@ -0,0 +1,14 @@
+/**
+ * Matches one non-wildcard module permission in namespace, resource, and action form.
+ */
+const modulePermissionPattern = /^[a-z][a-z0-9-]*:[a-z][a-z0-9-]*:[a-z][a-z0-9-]*$/;
+/**
+ * Determines whether a value is a non-wildcard permission accepted in module manifests.
+ *
+ * @param value - Permission candidate to inspect.
+ * @returns Whether the value uses the frozen lowercase three-segment format.
+ */
+export function isMiaixzModulePermission(value) {
+    return typeof value === "string" && modulePermissionPattern.test(value);
+}
+//# sourceMappingURL=permission.js.map

package/dist/contracts/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../../src/contracts/permission.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,uBAAuB,GAAG,mDAAmD,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["/**\n * Matches one non-wildcard module permission in namespace, resource, and action form.\n */\nconst modulePermissionPattern = /^[a-z][a-z0-9-]*:[a-z][a-z0-9-]*:[a-z][a-z0-9-]*$/;\n\n/**\n * Determines whether a value is a non-wildcard permission accepted in module manifests.\n *\n * @param value - Permission candidate to inspect.\n * @returns Whether the value uses the frozen lowercase three-segment format.\n */\nexport function isMiaixzModulePermission(value: unknown): value is string {\n  return typeof value === \"string\" && modulePermissionPattern.test(value);\n}\n"]}