@miaixz/sdk 0.5.0

package/dist/contracts/post-message.d.ts

@@ -0,0 +1,124 @@
+import type { MiaixzHostAdapter } from "./host-context.js";
+import type { MiaixzModuleManifest } from "./module-manifest.js";
+/**
+ * Describes one validated cross-origin Bridge message.
+ *
+ * @public
+ */
+export interface MiaixzBridgeEnvelope {
+    /**
+     * Identifies the Miaixz Bridge transport.
+     */
+    readonly channel: "miaixz.bridge";
+    /**
+     * Identifies the Bridge protocol version.
+     */
+    readonly protocolVersion: "1.0.0";
+    /**
+     * Correlates requests, responses, events, and cancellation messages.
+     */
+    readonly messageId: string;
+    /**
+     * Identifies the module owning the connection.
+     */
+    readonly moduleId: string;
+    /**
+     * Selects the message state-machine branch.
+     */
+    readonly kind: "request" | "response" | "event" | "cancel";
+    /**
+     * Identifies the allow-listed Bridge operation.
+     */
+    readonly method: string;
+    /**
+     * Contains the validated method payload when present.
+     */
+    readonly payload?: unknown;
+    /**
+     * Contains a safe remote SDK error when the request failed.
+     */
+    readonly error?: Readonly<{
+        /**
+         * Stable SDK error code.
+         */
+        code: string;
+        /**
+         * Registered internationalization message key.
+         */
+        messageKey: string;
+        /**
+         * Optional already-redacted diagnostic details.
+         */
+        details?: unknown;
+    }>;
+}
+/**
+ * Configures the Host side of one iframe postMessage Bridge.
+ *
+ * @public
+ */
+export interface MiaixzPostMessageHostOptions {
+    /**
+     * Supplies the validated iframe module manifest.
+     */
+    readonly manifest: Readonly<MiaixzModuleManifest>;
+    /**
+     * Supplies the exact iframe content Window receiving Host messages.
+     */
+    readonly targetWindow: Window;
+    /**
+     * Supplies the single allowed iframe origin.
+     */
+    readonly targetOrigin: string;
+    /**
+     * Supplies the Host capabilities exposed to the iframe.
+     */
+    readonly adapter: MiaixzHostAdapter;
+    /**
+     * Overrides the ten-second request and handshake timeout.
+     */
+    readonly timeoutMs?: number;
+}
+/**
+ * Represents the lifecycle of one Host-side postMessage connection.
+ *
+ * @public
+ */
+export interface MiaixzPostMessageHost {
+    /**
+     * Resolves after an accepted handshake or rejects on startup failure.
+     */
+    readonly ready: Promise<void>;
+    /**
+     * Releases the Host listener, subscriptions, and pending work.
+     */
+    dispose(): void;
+}
+/**
+ * Configures the Child side of one iframe postMessage Bridge.
+ *
+ * @public
+ */
+export interface MiaixzPostMessageChildOptions {
+    /**
+     * Identifies the iframe module opening the connection.
+     */
+    readonly moduleId: string;
+    /**
+     * Identifies the complete semantic version of the iframe module.
+     */
+    readonly moduleVersion: string;
+    /**
+     * Supplies the exact parent Window receiving Child messages.
+     */
+    readonly targetWindow: Window;
+    /**
+     * Supplies the single allowed parent origin.
+     */
+    readonly targetOrigin: string;
+    /**
+     * Overrides the ten-second request and handshake timeout.
+     */
+    readonly timeoutMs?: number;
+}
+//# sourceMappingURL=post-message.d.ts.map

package/dist/contracts/post-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-message.d.ts","sourceRoot":"","sources":["../../src/contracts/post-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;QACxB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAElD;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/contracts/post-message.js

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

package/dist/contracts/post-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-message.js","sourceRoot":"","sources":["../../src/contracts/post-message.ts"],"names":[],"mappings":"","sourcesContent":["import type { MiaixzHostAdapter, MiaixzHostBridge } from \"./host-context.js\";\nimport type { MiaixzModuleManifest } from \"./module-manifest.js\";\n\n/**\n * Describes one validated cross-origin Bridge message.\n *\n * @public\n */\nexport interface MiaixzBridgeEnvelope {\n  /**\n   * Identifies the Miaixz Bridge transport.\n   */\n  readonly channel: \"miaixz.bridge\";\n\n  /**\n   * Identifies the Bridge protocol version.\n   */\n  readonly protocolVersion: \"1.0.0\";\n\n  /**\n   * Correlates requests, responses, events, and cancellation messages.\n   */\n  readonly messageId: string;\n\n  /**\n   * Identifies the module owning the connection.\n   */\n  readonly moduleId: string;\n\n  /**\n   * Selects the message state-machine branch.\n   */\n  readonly kind: \"request\" | \"response\" | \"event\" | \"cancel\";\n\n  /**\n   * Identifies the allow-listed Bridge operation.\n   */\n  readonly method: string;\n\n  /**\n   * Contains the validated method payload when present.\n   */\n  readonly payload?: unknown;\n\n  /**\n   * Contains a safe remote SDK error when the request failed.\n   */\n  readonly error?: Readonly<{\n    /**\n     * Stable SDK error code.\n     */\n    code: string;\n\n    /**\n     * Registered internationalization message key.\n     */\n    messageKey: string;\n\n    /**\n     * Optional already-redacted diagnostic details.\n     */\n    details?: unknown;\n  }>;\n}\n\n/**\n * Configures the Host side of one iframe postMessage Bridge.\n *\n * @public\n */\nexport interface MiaixzPostMessageHostOptions {\n  /**\n   * Supplies the validated iframe module manifest.\n   */\n  readonly manifest: Readonly<MiaixzModuleManifest>;\n\n  /**\n   * Supplies the exact iframe content Window receiving Host messages.\n   */\n  readonly targetWindow: Window;\n\n  /**\n   * Supplies the single allowed iframe origin.\n   */\n  readonly targetOrigin: string;\n\n  /**\n   * Supplies the Host capabilities exposed to the iframe.\n   */\n  readonly adapter: MiaixzHostAdapter;\n\n  /**\n   * Overrides the ten-second request and handshake timeout.\n   */\n  readonly timeoutMs?: number;\n}\n\n/**\n * Represents the lifecycle of one Host-side postMessage connection.\n *\n * @public\n */\nexport interface MiaixzPostMessageHost {\n  /**\n   * Resolves after an accepted handshake or rejects on startup failure.\n   */\n  readonly ready: Promise<void>;\n\n  /**\n   * Releases the Host listener, subscriptions, and pending work.\n   */\n  dispose(): void;\n}\n\n/**\n * Configures the Child side of one iframe postMessage Bridge.\n *\n * @public\n */\nexport interface MiaixzPostMessageChildOptions {\n  /**\n   * Identifies the iframe module opening the connection.\n   */\n  readonly moduleId: string;\n\n  /**\n   * Identifies the complete semantic version of the iframe module.\n   */\n  readonly moduleVersion: string;\n\n  /**\n   * Supplies the exact parent Window receiving Child messages.\n   */\n  readonly targetWindow: Window;\n\n  /**\n   * Supplies the single allowed parent origin.\n   */\n  readonly targetOrigin: string;\n\n  /**\n   * Overrides the ten-second request and handshake timeout.\n   */\n  readonly timeoutMs?: number;\n}\n"]}

package/dist/contracts/route.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Describes a route contributed by a remotely loaded Miaixz module.
+ *
+ * @public
+ */
+export interface MiaixzModuleRoute {
+    /**
+     * Module-local route identifier.
+     */
+    readonly id: string;
+    /**
+     * Slash-relative path joined to the module base path.
+     */
+    readonly path: string;
+    /**
+     * Internationalization key used for the route title.
+     */
+    readonly titleKey: string;
+    /**
+     * Optional permissions required before the route is made available.
+     */
+    readonly requiredPermissions?: readonly string[];
+}
+/**
+ * Validates IDs used by modules, routes, and navigation items.
+ *
+ * @param value - Identifier candidate to inspect.
+ * @returns Whether the value satisfies the frozen kebab-case identifier grammar.
+ */
+export declare function isMiaixzModuleIdentifier(value: unknown): value is string;
+/**
+ * Validates a module base path or slash-relative route path.
+ *
+ * @param value - Path candidate to inspect.
+ * @returns Whether the path is static, absolute-path-shaped, and normalized.
+ */
+export declare function isMiaixzModulePath(value: unknown): value is string;
+/**
+ * Validates the required-permission list attached to a route or manifest.
+ *
+ * @param value - Permission-list candidate to inspect.
+ * @returns Whether every item is a non-wildcard module permission.
+ */
+export declare function isMiaixzModulePermissionList(value: unknown): value is readonly string[];
+//# sourceMappingURL=route.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/contracts/route.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAUlE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,MAAM,EAAE,CAEvF"}

package/dist/contracts/route.js

@@ -0,0 +1,35 @@
+import { isMiaixzModulePermission } from "./permission.js";
+/**
+ * Validates IDs used by modules, routes, and navigation items.
+ *
+ * @param value - Identifier candidate to inspect.
+ * @returns Whether the value satisfies the frozen kebab-case identifier grammar.
+ */
+export function isMiaixzModuleIdentifier(value) {
+    return typeof value === "string" && /^[a-z][a-z0-9-]{1,63}$/.test(value);
+}
+/**
+ * Validates a module base path or slash-relative route path.
+ *
+ * @param value - Path candidate to inspect.
+ * @returns Whether the path is static, absolute-path-shaped, and normalized.
+ */
+export function isMiaixzModulePath(value) {
+    return (typeof value === "string" &&
+        value.startsWith("/") &&
+        !value.startsWith("//") &&
+        (value === "/" || !value.endsWith("/")) &&
+        !value.includes(":") &&
+        !value.includes("?") &&
+        !value.includes("#"));
+}
+/**
+ * Validates the required-permission list attached to a route or manifest.
+ *
+ * @param value - Permission-list candidate to inspect.
+ * @returns Whether every item is a non-wildcard module permission.
+ */
+export function isMiaixzModulePermissionList(value) {
+    return Array.isArray(value) && value.every(isMiaixzModulePermission);
+}
+//# sourceMappingURL=route.js.map

package/dist/contracts/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/contracts/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AA6B3D;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QACvB,CAAC,KAAK,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACpB,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACpB,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CACrB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import { isMiaixzModulePermission } from \"./permission.js\";\n\n/**\n * Describes a route contributed by a remotely loaded Miaixz module.\n *\n * @public\n */\nexport interface MiaixzModuleRoute {\n  /**\n   * Module-local route identifier.\n   */\n  readonly id: string;\n\n  /**\n   * Slash-relative path joined to the module base path.\n   */\n  readonly path: string;\n\n  /**\n   * Internationalization key used for the route title.\n   */\n  readonly titleKey: string;\n\n  /**\n   * Optional permissions required before the route is made available.\n   */\n  readonly requiredPermissions?: readonly string[];\n}\n\n/**\n * Validates IDs used by modules, routes, and navigation items.\n *\n * @param value - Identifier candidate to inspect.\n * @returns Whether the value satisfies the frozen kebab-case identifier grammar.\n */\nexport function isMiaixzModuleIdentifier(value: unknown): value is string {\n  return typeof value === \"string\" && /^[a-z][a-z0-9-]{1,63}$/.test(value);\n}\n\n/**\n * Validates a module base path or slash-relative route path.\n *\n * @param value - Path candidate to inspect.\n * @returns Whether the path is static, absolute-path-shaped, and normalized.\n */\nexport function isMiaixzModulePath(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.startsWith(\"/\") &&\n    !value.startsWith(\"//\") &&\n    (value === \"/\" || !value.endsWith(\"/\")) &&\n    !value.includes(\":\") &&\n    !value.includes(\"?\") &&\n    !value.includes(\"#\")\n  );\n}\n\n/**\n * Validates the required-permission list attached to a route or manifest.\n *\n * @param value - Permission-list candidate to inspect.\n * @returns Whether every item is a non-wildcard module permission.\n */\nexport function isMiaixzModulePermissionList(value: unknown): value is readonly string[] {\n  return Array.isArray(value) && value.every(isMiaixzModulePermission);\n}\n"]}

package/dist/events/events.d.ts

@@ -0,0 +1,191 @@
+import { type MiaixzLocale } from "../i18n/index.js";
+import type { MiaixzAppearancePayload, MiaixzRuntimeContext, MiaixzSdkConfig } from "../types/index.js";
+/**
+ * Validates an untrusted event payload before it crosses a browser-context boundary.
+ *
+ * @public
+ */
+export type MiaixzEventValidator = (payload: unknown) => boolean;
+/**
+ * Describes the only authentication state that may cross an SDK event channel.
+ *
+ * @public
+ */
+export interface MiaixzAuthStatusEvent {
+    /**
+     * Reports whether credentials exist without exposing a session or token.
+     */
+    readonly status: "authenticated" | "anonymous";
+}
+/**
+ * Describes a locale change shared between same-origin application instances.
+ *
+ * @public
+ */
+export interface MiaixzLocaleChangedEvent {
+    /**
+     * Contains the canonical or otherwise valid BCP 47 locale to activate.
+     */
+    readonly locale: MiaixzLocale;
+}
+/**
+ * Maps built-in SDK event names to their payload types.
+ *
+ * @public
+ */
+export interface MiaixzSdkEventMap {
+    /**
+     * Contains a non-sensitive authentication invalidation signal.
+     */
+    readonly "auth:changed": Readonly<MiaixzAuthStatusEvent>;
+    /**
+     * Contains the runtime-context snapshot after it changes.
+     */
+    readonly "context:changed": Readonly<MiaixzRuntimeContext>;
+    /**
+     * Contains the versioned appearance snapshot after it changes.
+     */
+    readonly "appearance:changed": Readonly<MiaixzAppearancePayload>;
+    /**
+     * Contains the active locale after it changes.
+     */
+    readonly "locale:changed": Readonly<MiaixzLocaleChangedEvent>;
+    /**
+     * Contains the SDK configuration snapshot after it changes.
+     */
+    readonly "config:changed": Readonly<MiaixzSdkConfig>;
+}
+/**
+ * Configures local and optional same-origin cross-tab event delivery.
+ *
+ * @public
+ */
+export interface MiaixzEventBusOptions {
+    /**
+     * Selects a validated BroadcastChannel name, or disables cross-tab delivery.
+     *
+     * @defaultValue false
+     */
+    readonly channelName?: string | false;
+    /**
+     * Supplies runtime validators for application-defined event names.
+     */
+    readonly validators?: Readonly<Record<string, MiaixzEventValidator>>;
+    /**
+     * Creates a BroadcastChannel for tests or compatible custom browser runtimes.
+     */
+    readonly broadcastChannelFactory?: (name: string) => BroadcastChannel;
+}
+/**
+ * Defines the only envelope accepted over a Miaixz BroadcastChannel.
+ *
+ * @public
+ */
+export interface MiaixzEventEnvelope {
+    /**
+     * Identifies the frozen event-envelope schema.
+     */
+    readonly version: 1;
+    /**
+     * Uniquely identifies one broadcast operation for deduplication.
+     */
+    readonly eventId: string;
+    /**
+     * Identifies the event-bus instance that originated the message.
+     */
+    readonly sourceId: string;
+    /**
+     * Names the typed event represented by the payload.
+     */
+    readonly type: string;
+    /**
+     * Contains untrusted data that must pass the registered runtime validator.
+     */
+    readonly payload: unknown;
+}
+/**
+ * Configures one event publication.
+ *
+ * @public
+ */
+export interface MiaixzEventEmitOptions {
+    /**
+     * Indicates whether a locally dispatched event may also cross the configured channel.
+     *
+     * @defaultValue true
+     */
+    readonly broadcast?: boolean;
+}
+/**
+ * Extracts string event names from an event map.
+ *
+ * @public
+ */
+export type MiaixzEventName<Events extends object> = Extract<keyof Events, string>;
+/**
+ * Receives a typed event payload.
+ *
+ * @public
+ */
+export type MiaixzEventListener<T> = (payload: T) => void;
+/**
+ * Typed local and optional same-origin cross-tab event bus.
+ *
+ * @typeParam Events - Event-name map whose values define payload types.
+ * @public
+ */
+export declare class MiaixzEventBus<Events extends object = MiaixzSdkEventMap> {
+    #private;
+    /**
+     * Creates a local-first event bus and an optional validated BroadcastChannel.
+     *
+     * @param options - Channel factory and application-defined runtime validators.
+     * @throws MiaixzSdkError When an explicit channel name or secure UUID capability is invalid.
+     */
+    constructor(options?: MiaixzEventBusOptions);
+    /**
+     * Registers a typed listener and returns its unsubscribe function.
+     *
+     * @param type - Event name to observe.
+     * @param listener - Callback invoked with the typed event payload.
+     * @returns Function that unregisters the listener, or a no-op after closure.
+     */
+    on<Name extends MiaixzEventName<Events>>(type: Name, listener: MiaixzEventListener<Events[Name]>): () => void;
+    /**
+     * Registers a typed listener that is removed after its first event.
+     *
+     * @param type - Event name to observe once.
+     * @param listener - Callback invoked with the typed event payload.
+     * @returns Function that unregisters the listener before delivery.
+     */
+    once<Name extends MiaixzEventName<Events>>(type: Name, listener: MiaixzEventListener<Events[Name]>): () => void;
+    /**
+     * Publishes an event synchronously to local listeners before optional cross-tab delivery.
+     *
+     * @param type - Event name to publish.
+     * @param payload - Typed event payload.
+     * @param options - Optional cross-tab publication behavior.
+     * @throws MiaixzSdkError When the bus is closed, a required validator is missing, cloning fails, or secure UUIDs are unavailable.
+     */
+    emit<Name extends MiaixzEventName<Events>>(type: Name, payload: Events[Name], options?: Readonly<MiaixzEventEmitOptions>): void;
+    /**
+     * Removes listeners for one event type or all event types.
+     *
+     * @param type - Optional event name whose listeners should be removed.
+     */
+    clear(type?: MiaixzEventName<Events>): void;
+    /**
+     * Removes listeners and deduplication state, then closes the underlying channel once.
+     */
+    close(): void;
+}
+/**
+ * Creates a typed local-first event bus with optional same-origin cross-tab delivery.
+ *
+ * @typeParam Events - Event-name map whose values define payload types.
+ * @param options - Optional channel and runtime-validator configuration.
+ * @returns Configured typed event bus.
+ * @public
+ */
+export declare function createMiaixzEventBus<Events extends object = MiaixzSdkEventMap>(options?: MiaixzEventBusOptions): MiaixzEventBus<Events>;
+//# sourceMappingURL=events.d.ts.map

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

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