@hyperfrontend/immutable-api-utils 0.0.1 → 0.1.0

package/built-in-copy/math/index.esm.js

@@ -0,0 +1,272 @@
+/**
+ * Safe copies of Math built-in methods.
+ *
+ * These references are captured at module initialization time to protect against
+ * prototype pollution attacks. Import only what you need for tree-shaking.
+ *
+ * @module @hyperfrontend/immutable-api-utils/built-in-copy/math
+ */
+// Capture references at module initialization time
+const _Math = globalThis.Math;
+const _freeze = globalThis.Object.freeze;
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * (Safe copy) The mathematical constant e, approximately 2.718.
+ */
+const E = _Math.E;
+/**
+ * (Safe copy) The natural logarithm of 2, approximately 0.693.
+ */
+const LN2 = _Math.LN2;
+/**
+ * (Safe copy) The natural logarithm of 10, approximately 2.303.
+ */
+const LN10 = _Math.LN10;
+/**
+ * (Safe copy) The base-2 logarithm of e, approximately 1.443.
+ */
+const LOG2E = _Math.LOG2E;
+/**
+ * (Safe copy) The base-10 logarithm of e, approximately 0.434.
+ */
+const LOG10E = _Math.LOG10E;
+/**
+ * (Safe copy) The mathematical constant π, approximately 3.14159.
+ */
+const PI = _Math.PI;
+/**
+ * (Safe copy) The square root of 1/2, approximately 0.707.
+ */
+const SQRT1_2 = _Math.SQRT1_2;
+/**
+ * (Safe copy) The square root of 2, approximately 1.414.
+ */
+const SQRT2 = _Math.SQRT2;
+// ============================================================================
+// Basic Operations
+// ============================================================================
+/**
+ * (Safe copy) Returns the absolute value of a number.
+ */
+const abs = _Math.abs;
+/**
+ * (Safe copy) Returns the sign of a number (-1, 0, or 1).
+ */
+const sign = _Math.sign;
+/**
+ * (Safe copy) Returns the smallest integer greater than or equal to a number.
+ */
+const ceil = _Math.ceil;
+/**
+ * (Safe copy) Returns the largest integer less than or equal to a number.
+ */
+const floor = _Math.floor;
+/**
+ * (Safe copy) Returns the value of a number rounded to the nearest integer.
+ */
+const round = _Math.round;
+/**
+ * (Safe copy) Returns the integer part of a number by removing fractional digits.
+ */
+const trunc = _Math.trunc;
+// ============================================================================
+// Min/Max
+// ============================================================================
+/**
+ * (Safe copy) Returns the larger of zero or more numbers.
+ */
+const max = _Math.max;
+/**
+ * (Safe copy) Returns the smaller of zero or more numbers.
+ */
+const min = _Math.min;
+// ============================================================================
+// Powers and Roots
+// ============================================================================
+/**
+ * (Safe copy) Returns the base to the exponent power.
+ */
+const pow = _Math.pow;
+/**
+ * (Safe copy) Returns the square root of a number.
+ */
+const sqrt = _Math.sqrt;
+/**
+ * (Safe copy) Returns the cube root of a number.
+ */
+const cbrt = _Math.cbrt;
+/**
+ * (Safe copy) Returns the square root of the sum of squares of its arguments.
+ */
+const hypot = _Math.hypot;
+/**
+ * (Safe copy) Returns e raised to the power of a number.
+ */
+const exp = _Math.exp;
+/**
+ * (Safe copy) Returns e raised to the power of a number minus 1.
+ */
+const expm1 = _Math.expm1;
+// ============================================================================
+// Logarithms
+// ============================================================================
+/**
+ * (Safe copy) Returns the natural logarithm of a number.
+ */
+const log = _Math.log;
+/**
+ * (Safe copy) Returns the base-2 logarithm of a number.
+ */
+const log2 = _Math.log2;
+/**
+ * (Safe copy) Returns the base-10 logarithm of a number.
+ */
+const log10 = _Math.log10;
+/**
+ * (Safe copy) Returns the natural logarithm of 1 + a number.
+ */
+const log1p = _Math.log1p;
+// ============================================================================
+// Trigonometry
+// ============================================================================
+/**
+ * (Safe copy) Returns the sine of a number.
+ */
+const sin = _Math.sin;
+/**
+ * (Safe copy) Returns the cosine of a number.
+ */
+const cos = _Math.cos;
+/**
+ * (Safe copy) Returns the tangent of a number.
+ */
+const tan = _Math.tan;
+/**
+ * (Safe copy) Returns the arcsine of a number.
+ */
+const asin = _Math.asin;
+/**
+ * (Safe copy) Returns the arccosine of a number.
+ */
+const acos = _Math.acos;
+/**
+ * (Safe copy) Returns the arctangent of a number.
+ */
+const atan = _Math.atan;
+/**
+ * (Safe copy) Returns the arctangent of the quotient of its arguments.
+ */
+const atan2 = _Math.atan2;
+/**
+ * (Safe copy) Returns the hyperbolic sine of a number.
+ */
+const sinh = _Math.sinh;
+/**
+ * (Safe copy) Returns the hyperbolic cosine of a number.
+ */
+const cosh = _Math.cosh;
+/**
+ * (Safe copy) Returns the hyperbolic tangent of a number.
+ */
+const tanh = _Math.tanh;
+/**
+ * (Safe copy) Returns the inverse hyperbolic sine of a number.
+ */
+const asinh = _Math.asinh;
+/**
+ * (Safe copy) Returns the inverse hyperbolic cosine of a number.
+ */
+const acosh = _Math.acosh;
+/**
+ * (Safe copy) Returns the inverse hyperbolic tangent of a number.
+ */
+const atanh = _Math.atanh;
+// ============================================================================
+// Bitwise/Integer Operations
+// ============================================================================
+/**
+ * (Safe copy) Returns the result of the C-like 32-bit multiplication.
+ */
+const imul = _Math.imul;
+/**
+ * (Safe copy) Returns the nearest 32-bit single precision float representation.
+ */
+const fround = _Math.fround;
+/**
+ * (Safe copy) Returns the number of leading zero bits in the 32-bit binary representation.
+ */
+const clz32 = _Math.clz32;
+// ============================================================================
+// Random
+// ============================================================================
+/**
+ * (Safe copy) Returns a pseudo-random number between 0 and 1.
+ * Note: This is NOT cryptographically secure. For secure random values,
+ * use crypto.getRandomValues().
+ */
+const random = _Math.random;
+// ============================================================================
+// Namespace Export
+// ============================================================================
+/**
+ * (Safe copy) Namespace object containing all Math utilities.
+ * Note: Importing this imports all methods in this namespace (no tree-shaking).
+ */
+const Math = _freeze({
+    // Constants
+    E,
+    LN2,
+    LN10,
+    LOG2E,
+    LOG10E,
+    PI,
+    SQRT1_2,
+    SQRT2,
+    // Basic operations
+    abs,
+    sign,
+    ceil,
+    floor,
+    round,
+    trunc,
+    // Min/Max
+    max,
+    min,
+    // Powers and roots
+    pow,
+    sqrt,
+    cbrt,
+    hypot,
+    exp,
+    expm1,
+    // Logarithms
+    log,
+    log2,
+    log10,
+    log1p,
+    // Trigonometry
+    sin,
+    cos,
+    tan,
+    asin,
+    acos,
+    atan,
+    atan2,
+    sinh,
+    cosh,
+    tanh,
+    asinh,
+    acosh,
+    atanh,
+    // Bitwise/Integer
+    imul,
+    fround,
+    clz32,
+    // Random
+    random,
+});
+
+export { E, LN10, LN2, LOG10E, LOG2E, Math, PI, SQRT1_2, SQRT2, abs, acos, acosh, asin, asinh, atan, atan2, atanh, cbrt, ceil, clz32, cos, cosh, exp, expm1, floor, fround, hypot, imul, log, log10, log1p, log2, max, min, pow, random, round, sign, sin, sinh, sqrt, tan, tanh, trunc };
+//# sourceMappingURL=index.esm.js.map

package/built-in-copy/math/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/math/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/built-in-copy/messaging/index.cjs.js

@@ -0,0 +1,123 @@
+'use strict';
+
+/**
+ * Safe copies of Messaging/Communication built-in functions and constructors.
+ *
+ * These references are captured at module initialization time to protect against
+ * prototype pollution attacks. Import only what you need for tree-shaking.
+ *
+ * Note: `postMessage` is a method on specific objects (Window, Worker, MessagePort)
+ * rather than a global. This module provides factory functions for MessageChannel
+ * and BroadcastChannel, whose instances have safe postMessage methods.
+ *
+ * @module @hyperfrontend/immutable-api-utils/built-in-copy/messaging
+ */
+// Capture references at module initialization time
+const _Reflect = globalThis.Reflect;
+const _freeze = globalThis.Object.freeze;
+const _structuredClone = typeof globalThis.structuredClone === 'function' ? globalThis.structuredClone : undefined;
+const _MessageChannel = typeof globalThis.MessageChannel === 'function' ? globalThis.MessageChannel : undefined;
+const _BroadcastChannel = typeof globalThis.BroadcastChannel === 'function' ? globalThis.BroadcastChannel : undefined;
+/**
+ * (Safe copy) Creates a deep clone of a value using the structured clone algorithm.
+ * Available in modern browsers and Node.js 17+.
+ *
+ * @param value - The value to clone.
+ * @param options - Optional transfer or serialization options.
+ * @returns A deep clone of the value.
+ */
+const structuredClone = _structuredClone
+    ? (value, options) => _structuredClone(value, options)
+    : undefined;
+/**
+ * (Safe copy) Creates a new MessageChannel using the captured constructor.
+ * MessageChannel provides two ports for bidirectional communication.
+ *
+ * @returns A new MessageChannel instance or undefined if not available.
+ */
+const createMessageChannel = _MessageChannel
+    ? () => _Reflect.construct(_MessageChannel, [])
+    : undefined;
+/**
+ * (Safe copy) Creates a new BroadcastChannel using the captured constructor.
+ * BroadcastChannel enables communication between browsing contexts with the same origin.
+ *
+ * @param name - Identifier for the broadcast channel that other contexts use to subscribe.
+ * @returns A new BroadcastChannel instance or undefined if not available.
+ */
+const createBroadcastChannel = _BroadcastChannel
+    ? (name) => _Reflect.construct(_BroadcastChannel, [name])
+    : undefined;
+/**
+ * (Safe copy) Posts a message to a Window object using captured postMessage.
+ * This is a helper that wraps Window.postMessage for safe messaging.
+ *
+ * @param target - Destination window, iframe, or popup context.
+ * @param message - The data payload to send, must be structured-cloneable.
+ * @param options - Target origin and optional transferables.
+ */
+const postMessageToWindow = (target, message, options) => {
+    target.postMessage(message, options.targetOrigin, options.transfer);
+};
+/**
+ * (Safe copy) Posts a message to a Worker using captured postMessage.
+ *
+ * @param target - Web Worker or service worker instance.
+ * @param message - The data payload to send, must be structured-cloneable.
+ * @param transfer - Optional array of Transferable objects.
+ */
+const postMessageToWorker = (target, message, transfer) => {
+    if (transfer) {
+        target.postMessage(message, transfer);
+    }
+    else {
+        target.postMessage(message);
+    }
+};
+/**
+ * (Safe copy) Posts a message to a MessagePort.
+ *
+ * @param port - One end of a two-way communication channel.
+ * @param message - The data payload to send, must be structured-cloneable.
+ * @param transfer - Optional array of Transferable objects.
+ */
+const postMessageToPort = (port, message, transfer) => {
+    if (transfer) {
+        port.postMessage(message, transfer);
+    }
+    else {
+        port.postMessage(message);
+    }
+};
+/**
+ * (Safe copy) Posts a message to a BroadcastChannel.
+ *
+ * @param channel - Named broadcast channel for same-origin contexts.
+ * @param message - The data payload to send, must be structured-cloneable.
+ */
+const postMessageToBroadcast = (channel, message) => {
+    channel.postMessage(message);
+};
+/**
+ * (Safe copy) Namespace object containing all Messaging functions.
+ * Note: Importing this imports all methods in this namespace (no tree-shaking).
+ */
+const Messaging = _freeze({
+    structuredClone,
+    createMessageChannel,
+    createBroadcastChannel,
+    postMessageToWindow,
+    postMessageToWorker,
+    postMessageToPort,
+    postMessageToBroadcast,
+});
+
+exports.Messaging = Messaging;
+exports.createBroadcastChannel = createBroadcastChannel;
+exports.createMessageChannel = createMessageChannel;
+exports.postMessageToBroadcast = postMessageToBroadcast;
+exports.postMessageToPort = postMessageToPort;
+exports.postMessageToWindow = postMessageToWindow;
+exports.postMessageToWorker = postMessageToWorker;
+exports.structuredClone = structuredClone;
+//# sourceMappingURL=index.cjs.js.map

package/built-in-copy/messaging/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/messaging/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;AAWG;AAEH;AACA,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO;AACnC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM;AACxC,MAAM,gBAAgB,GAAG,OAAO,UAAU,CAAC,eAAe,KAAK,UAAU,GAAG,UAAU,CAAC,eAAe,GAAG,SAAS;AAClH,MAAM,eAAe,GAAG,OAAO,UAAU,CAAC,cAAc,KAAK,UAAU,GAAG,UAAU,CAAC,cAAc,GAAG,SAAS;AAC/G,MAAM,iBAAiB,GAAG,OAAO,UAAU,CAAC,gBAAgB,KAAK,UAAU,GAAG,UAAU,CAAC,gBAAgB,GAAG,SAAS;AAErH;;;;;;;AAOG;AACI,MAAM,eAAe,GAAG;AAC7B,MAAE,CAAI,KAAQ,EAAE,OAAoC,KAAQ,gBAAgB,CAAC,KAAK,EAAE,OAAO;MACzF;AAEJ;;;;;AAKG;AACI,MAAM,oBAAoB,GAAG;MAChC,MAAsC,QAAQ,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE;MAC5E;AAEJ;;;;;;AAMG;AACI,MAAM,sBAAsB,GAAG;AACpC,MAAE,CAAC,IAAY,KAAyC,QAAQ,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC,IAAI,CAAC;MAClG;AAiBJ;;;;;;;AAOG;AACI,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAE,OAAgB,EAAE,OAAmC,KAAU;AACjH,IAAA,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC;AACrE;AAEA;;;;;;AAMG;AACI,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAE,OAAgB,EAAE,QAAyB,KAAU;IACvG,IAAI,QAAQ,EAAE;AACZ,QAAA,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC;IACvC;SAAO;AACL,QAAA,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;IAC7B;AACF;AAEA;;;;;;AAMG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAiB,EAAE,OAAgB,EAAE,QAAyB,KAAU;IACxG,IAAI,QAAQ,EAAE;AACZ,QAAA,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC;IACrC;SAAO;AACL,QAAA,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;IAC3B;AACF;AAEA;;;;;AAKG;MACU,sBAAsB,GAAG,CAAC,OAAyB,EAAE,OAAgB,KAAU;AAC1F,IAAA,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;AAC9B;AAEA;;;AAGG;AACI,MAAM,SAAS,GAAG,OAAO,CAAQ;IACtC,eAAe;IACf,oBAAoB;IACpB,sBAAsB;IACtB,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,sBAAsB;AACvB,CAAA;;;;;;;;;;;"}

package/built-in-copy/messaging/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Safe copies of Messaging/Communication built-in functions and constructors.
+ *
+ * These references are captured at module initialization time to protect against
+ * prototype pollution attacks. Import only what you need for tree-shaking.
+ *
+ * Note: `postMessage` is a method on specific objects (Window, Worker, MessagePort)
+ * rather than a global. This module provides factory functions for MessageChannel
+ * and BroadcastChannel, whose instances have safe postMessage methods.
+ *
+ * @module @hyperfrontend/immutable-api-utils/built-in-copy/messaging
+ */
+/**
+ * (Safe copy) Creates a deep clone of a value using the structured clone algorithm.
+ * Available in modern browsers and Node.js 17+.
+ *
+ * @param value - The value to clone.
+ * @param options - Optional transfer or serialization options.
+ * @returns A deep clone of the value.
+ */
+export declare const structuredClone: <T>(value: T, options?: StructuredSerializeOptions) => T;
+/**
+ * (Safe copy) Creates a new MessageChannel using the captured constructor.
+ * MessageChannel provides two ports for bidirectional communication.
+ *
+ * @returns A new MessageChannel instance or undefined if not available.
+ */
+export declare const createMessageChannel: () => MessageChannel;
+/**
+ * (Safe copy) Creates a new BroadcastChannel using the captured constructor.
+ * BroadcastChannel enables communication between browsing contexts with the same origin.
+ *
+ * @param name - Identifier for the broadcast channel that other contexts use to subscribe.
+ * @returns A new BroadcastChannel instance or undefined if not available.
+ */
+export declare const createBroadcastChannel: (name: string) => BroadcastChannel;
+/**
+ * PostMessage options for Window.postMessage.
+ */
+export interface PostMessageToWindowOptions {
+    /**
+     * The target origin for the message (e.g., "https://example.com" or "*").
+     */
+    targetOrigin: string;
+    /**
+     * Array of Transferable objects to transfer ownership.
+     */
+    transfer?: Transferable[];
+}
+/**
+ * (Safe copy) Posts a message to a Window object using captured postMessage.
+ * This is a helper that wraps Window.postMessage for safe messaging.
+ *
+ * @param target - Destination window, iframe, or popup context.
+ * @param message - The data payload to send, must be structured-cloneable.
+ * @param options - Target origin and optional transferables.
+ */
+export declare const postMessageToWindow: (target: Window, message: unknown, options: PostMessageToWindowOptions) => void;
+/**
+ * (Safe copy) Posts a message to a Worker using captured postMessage.
+ *
+ * @param target - Web Worker or service worker instance.
+ * @param message - The data payload to send, must be structured-cloneable.
+ * @param transfer - Optional array of Transferable objects.
+ */
+export declare const postMessageToWorker: (target: Worker, message: unknown, transfer?: Transferable[]) => void;
+/**
+ * (Safe copy) Posts a message to a MessagePort.
+ *
+ * @param port - One end of a two-way communication channel.
+ * @param message - The data payload to send, must be structured-cloneable.
+ * @param transfer - Optional array of Transferable objects.
+ */
+export declare const postMessageToPort: (port: MessagePort, message: unknown, transfer?: Transferable[]) => void;
+/**
+ * (Safe copy) Posts a message to a BroadcastChannel.
+ *
+ * @param channel - Named broadcast channel for same-origin contexts.
+ * @param message - The data payload to send, must be structured-cloneable.
+ */
+export declare const postMessageToBroadcast: (channel: BroadcastChannel, message: unknown) => void;
+/**
+ * (Safe copy) Namespace object containing all Messaging functions.
+ * Note: Importing this imports all methods in this namespace (no tree-shaking).
+ */
+export declare const Messaging: Readonly<{
+    readonly structuredClone: <T>(value: T, options?: StructuredSerializeOptions) => T;
+    readonly createMessageChannel: () => MessageChannel;
+    readonly createBroadcastChannel: (name: string) => BroadcastChannel;
+    readonly postMessageToWindow: (target: Window, message: unknown, options: PostMessageToWindowOptions) => void;
+    readonly postMessageToWorker: (target: Worker, message: unknown, transfer?: Transferable[]) => void;
+    readonly postMessageToPort: (port: MessagePort, message: unknown, transfer?: Transferable[]) => void;
+    readonly postMessageToBroadcast: (channel: BroadcastChannel, message: unknown) => void;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/built-in-copy/messaging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/messaging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GACvB,CAAC,SAAS,CAAC,YAAY,0BAA0B,KAAG,CAC5C,CAAA;AAEb;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QACzB,cACK,CAAA;AAEb;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,SACxB,MAAM,KAAG,gBACP,CAAA;AAEb;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;CAC1B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,EAAE,SAAS,OAAO,EAAE,SAAS,0BAA0B,KAAG,IAE3G,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,EAAE,SAAS,OAAO,EAAE,WAAW,YAAY,EAAE,KAAG,IAMjG,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,WAAW,EAAE,SAAS,OAAO,EAAE,WAAW,YAAY,EAAE,KAAG,IAMlG,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,gBAAgB,EAAE,SAAS,OAAO,KAAG,IAEpF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS;+BA/FjB,CAAC,SAAS,CAAC,YAAY,0BAA0B,KAAG,CAAC;yCAUlD,cAAc;4CAWX,MAAM,KAAG,gBAAgB;2CA0BQ,MAAM,WAAW,OAAO,WAAW,0BAA0B,KAAG,IAAI;2CAWpE,MAAM,WAAW,OAAO,aAAa,YAAY,EAAE,KAAG,IAAI;uCAe9D,WAAW,WAAW,OAAO,aAAa,YAAY,EAAE,KAAG,IAAI;+CAcvD,gBAAgB,WAAW,OAAO,KAAG,IAAI;EAgBvF,CAAA"}

package/built-in-copy/messaging/index.esm.js

@@ -0,0 +1,114 @@
+/**
+ * Safe copies of Messaging/Communication built-in functions and constructors.
+ *
+ * These references are captured at module initialization time to protect against
+ * prototype pollution attacks. Import only what you need for tree-shaking.
+ *
+ * Note: `postMessage` is a method on specific objects (Window, Worker, MessagePort)
+ * rather than a global. This module provides factory functions for MessageChannel
+ * and BroadcastChannel, whose instances have safe postMessage methods.
+ *
+ * @module @hyperfrontend/immutable-api-utils/built-in-copy/messaging
+ */
+// Capture references at module initialization time
+const _Reflect = globalThis.Reflect;
+const _freeze = globalThis.Object.freeze;
+const _structuredClone = typeof globalThis.structuredClone === 'function' ? globalThis.structuredClone : undefined;
+const _MessageChannel = typeof globalThis.MessageChannel === 'function' ? globalThis.MessageChannel : undefined;
+const _BroadcastChannel = typeof globalThis.BroadcastChannel === 'function' ? globalThis.BroadcastChannel : undefined;
+/**
+ * (Safe copy) Creates a deep clone of a value using the structured clone algorithm.
+ * Available in modern browsers and Node.js 17+.
+ *
+ * @param value - The value to clone.
+ * @param options - Optional transfer or serialization options.
+ * @returns A deep clone of the value.
+ */
+const structuredClone = _structuredClone
+    ? (value, options) => _structuredClone(value, options)
+    : undefined;
+/**
+ * (Safe copy) Creates a new MessageChannel using the captured constructor.
+ * MessageChannel provides two ports for bidirectional communication.
+ *
+ * @returns A new MessageChannel instance or undefined if not available.
+ */
+const createMessageChannel = _MessageChannel
+    ? () => _Reflect.construct(_MessageChannel, [])
+    : undefined;
+/**
+ * (Safe copy) Creates a new BroadcastChannel using the captured constructor.
+ * BroadcastChannel enables communication between browsing contexts with the same origin.
+ *
+ * @param name - Identifier for the broadcast channel that other contexts use to subscribe.
+ * @returns A new BroadcastChannel instance or undefined if not available.
+ */
+const createBroadcastChannel = _BroadcastChannel
+    ? (name) => _Reflect.construct(_BroadcastChannel, [name])
+    : undefined;
+/**
+ * (Safe copy) Posts a message to a Window object using captured postMessage.
+ * This is a helper that wraps Window.postMessage for safe messaging.
+ *
+ * @param target - Destination window, iframe, or popup context.
+ * @param message - The data payload to send, must be structured-cloneable.
+ * @param options - Target origin and optional transferables.
+ */
+const postMessageToWindow = (target, message, options) => {
+    target.postMessage(message, options.targetOrigin, options.transfer);
+};
+/**
+ * (Safe copy) Posts a message to a Worker using captured postMessage.
+ *
+ * @param target - Web Worker or service worker instance.
+ * @param message - The data payload to send, must be structured-cloneable.
+ * @param transfer - Optional array of Transferable objects.
+ */
+const postMessageToWorker = (target, message, transfer) => {
+    if (transfer) {
+        target.postMessage(message, transfer);
+    }
+    else {
+        target.postMessage(message);
+    }
+};
+/**
+ * (Safe copy) Posts a message to a MessagePort.
+ *
+ * @param port - One end of a two-way communication channel.
+ * @param message - The data payload to send, must be structured-cloneable.
+ * @param transfer - Optional array of Transferable objects.
+ */
+const postMessageToPort = (port, message, transfer) => {
+    if (transfer) {
+        port.postMessage(message, transfer);
+    }
+    else {
+        port.postMessage(message);
+    }
+};
+/**
+ * (Safe copy) Posts a message to a BroadcastChannel.
+ *
+ * @param channel - Named broadcast channel for same-origin contexts.
+ * @param message - The data payload to send, must be structured-cloneable.
+ */
+const postMessageToBroadcast = (channel, message) => {
+    channel.postMessage(message);
+};
+/**
+ * (Safe copy) Namespace object containing all Messaging functions.
+ * Note: Importing this imports all methods in this namespace (no tree-shaking).
+ */
+const Messaging = _freeze({
+    structuredClone,
+    createMessageChannel,
+    createBroadcastChannel,
+    postMessageToWindow,
+    postMessageToWorker,
+    postMessageToPort,
+    postMessageToBroadcast,
+});
+
+export { Messaging, createBroadcastChannel, createMessageChannel, postMessageToBroadcast, postMessageToPort, postMessageToWindow, postMessageToWorker, structuredClone };
+//# sourceMappingURL=index.esm.js.map

package/built-in-copy/messaging/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../../../../../../../../../../libs/utils/immutable-api/src/built-in-copy/messaging/index.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;AAWG;AAEH;AACA,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO;AACnC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM;AACxC,MAAM,gBAAgB,GAAG,OAAO,UAAU,CAAC,eAAe,KAAK,UAAU,GAAG,UAAU,CAAC,eAAe,GAAG,SAAS;AAClH,MAAM,eAAe,GAAG,OAAO,UAAU,CAAC,cAAc,KAAK,UAAU,GAAG,UAAU,CAAC,cAAc,GAAG,SAAS;AAC/G,MAAM,iBAAiB,GAAG,OAAO,UAAU,CAAC,gBAAgB,KAAK,UAAU,GAAG,UAAU,CAAC,gBAAgB,GAAG,SAAS;AAErH;;;;;;;AAOG;AACI,MAAM,eAAe,GAAG;AAC7B,MAAE,CAAI,KAAQ,EAAE,OAAoC,KAAQ,gBAAgB,CAAC,KAAK,EAAE,OAAO;MACzF;AAEJ;;;;;AAKG;AACI,MAAM,oBAAoB,GAAG;MAChC,MAAsC,QAAQ,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE;MAC5E;AAEJ;;;;;;AAMG;AACI,MAAM,sBAAsB,GAAG;AACpC,MAAE,CAAC,IAAY,KAAyC,QAAQ,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC,IAAI,CAAC;MAClG;AAiBJ;;;;;;;AAOG;AACI,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAE,OAAgB,EAAE,OAAmC,KAAU;AACjH,IAAA,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC;AACrE;AAEA;;;;;;AAMG;AACI,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAE,OAAgB,EAAE,QAAyB,KAAU;IACvG,IAAI,QAAQ,EAAE;AACZ,QAAA,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC;IACvC;SAAO;AACL,QAAA,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;IAC7B;AACF;AAEA;;;;;;AAMG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAiB,EAAE,OAAgB,EAAE,QAAyB,KAAU;IACxG,IAAI,QAAQ,EAAE;AACZ,QAAA,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC;IACrC;SAAO;AACL,QAAA,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;IAC3B;AACF;AAEA;;;;;AAKG;MACU,sBAAsB,GAAG,CAAC,OAAyB,EAAE,OAAgB,KAAU;AAC1F,IAAA,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;AAC9B;AAEA;;;AAGG;AACI,MAAM,SAAS,GAAG,OAAO,CAAQ;IACtC,eAAe;IACf,oBAAoB;IACpB,sBAAsB;IACtB,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,sBAAsB;AACvB,CAAA;;;;"}