forgeframe 0.0.10 → 0.0.13

package/dist/utils/domain-pattern.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @packageDocumentation
+ * Internal domain-pattern helpers shared by ForgeFrame trust and origin checks.
+ *
+ * @remarks
+ * Centralizes wildcard compilation and stateless `RegExp` evaluation so
+ * window helpers and the messenger preserve identical domain-matching behavior.
+ */
+/**
+ * Compiles a wildcard domain pattern into an anchored `RegExp`.
+ *
+ * @param pattern - Domain pattern that may contain `*` wildcards.
+ * @returns Compiled `RegExp`, or `null` when the pattern has no wildcards.
+ *
+ * @remarks
+ * Compiled patterns are cached with a bounded, oldest-entry eviction policy to
+ * preserve the prior helper-level wildcard cache behavior.
+ *
+ * @internal
+ */
+export declare function compileWildcardDomainPattern(pattern: string): RegExp | null;
+/**
+ * Tests a domain `RegExp` without mutating `lastIndex` on global or sticky patterns.
+ *
+ * @param pattern - Pattern to test.
+ * @param value - Domain string to match.
+ * @returns `true` when the pattern matches the provided value.
+ *
+ * @remarks
+ * Global and sticky flags are stripped from a cloned `RegExp` before testing so
+ * repeated trust checks behave consistently regardless of prior matches.
+ *
+ * @internal
+ */
+export declare function testDomainRegExpStateless(pattern: RegExp, value: string): boolean;

package/dist/window/helpers.d.ts

@@ -56,7 +56,7 @@ export declare function isSameDomain(win: Window, reference?: Window): boolean;
  * - `"*"` matches any domain
  * - String patterns without wildcards require exact match
  * - String patterns with `*` use wildcard matching (for example, `'https://*.example.com'`)
- * - RegExp patterns use `.test()` method
+ * - RegExp patterns are evaluated statelessly so global/sticky flags do not leak `lastIndex` across calls
  * - Array patterns return `true` if any element matches (OR logic)
  *
  * @example

package/dist/window/index.d.ts

@@ -1,12 +1,12 @@
 /**
- * Window utilities for ForgeFrame cross-window communication.
+ * @packageDocumentation
+ * Internal source barrel for ForgeFrame window utilities.
  *
  * @remarks
- * This module provides utilities for working with browser windows in cross-origin
- * contexts. It includes helpers for domain matching, window hierarchy navigation,
- * window name payload encoding/decoding, and window reference management.
- *
- * @packageDocumentation
+ * This file groups cross-window helpers, payload parsing, and window reference
+ * helpers for internal source organization. The published package does not
+ * expose a `forgeframe/window` subpath, so consumers should treat this barrel
+ * as internal implementation structure.
  */
 export { getDomain, isSameDomain, matchDomain, isWindowClosed, getOpener, getConsumer, getTop, isIframe, isPopup, getAncestor, getDistanceToConsumer, focusWindow, closeWindow, getFrames, } from './helpers';
 export { buildWindowName, parseWindowName, isForgeFrameWindow, isHostOfComponent, createWindowPayload, updateWindowName, getInitialPayload, } from './name-payload';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgeframe",
-  "version": "0.0.10",
+  "version": "0.0.13",
   "description": "Modern cross-domain iframe component framework - a TypeScript alternative to zoid",
   "type": "module",
   "module": "./dist/forgeframe.js",