@syntrologie/adapt-nav 2.16.0 → 2.18.0

package/dist/resolveNavTarget.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Pure decision function for nav-tip click routing.
+ *
+ * Given an href, an `external` flag, the current window's origin, and whether
+ * the SDK is mounted inside an iframe, returns the navigation action to take.
+ *
+ * Extracted from NavWidgetLit so both the Lit and React widget variants
+ * share one decision matrix and so the routing logic can be unit-tested
+ * without mutating window.location (jsdom doesn't allow redefining
+ * origin/href).
+ */
+export type NavTarget = {
+    kind: 'open';
+    url: string;
+} | {
+    kind: 'fullnav';
+    url: string;
+} | {
+    kind: 'spa';
+    url: URL;
+};
+export interface ResolveNavTargetArgs {
+    href: string;
+    external: boolean;
+    windowOrigin: string;
+    /**
+     * True when the SDK is mounted inside an iframe (window !== window.top, or
+     * window.top access threw cross-origin). When true, every nav escapes via
+     * window.open — the parent page's sandbox `allow-popups` lets the new
+     * window pop out to the user's main browser.
+     */
+    isIframe: boolean;
+}
+/**
+ * Decide what to do with a nav-tip click.
+ *
+ * Routing branches (in order):
+ *
+ *   1. **Iframe context** (`isIframe=true` OR opaque origin "null"):
+ *      always `window.open` the href as-is. Action-plan authors who want
+ *      cross-iframe nav must use absolute URLs (any host — customer's,
+ *      partner's, doesn't matter). The sandbox's `allow-popups` lets the
+ *      open() call escape to the user's main browser.
+ *
+ *   2. **Explicit external** (`external=true`): always opens in `_blank`.
+ *
+ *   3. **Cross-origin absolute href** (no iframe; URL parses to a different
+ *      origin): full `window.location.href` navigation.
+ *
+ *   4. **Same-origin** (most common — SDK on customer site, internal route):
+ *      SPA-style `pushState` (caller falls back to framework router).
+ *
+ *   5. **Parse failure**: full-nav fallback; browser does its best.
+ */
+export declare function resolveNavTarget(args: ResolveNavTargetArgs): NavTarget;
+/**
+ * Helper: detect whether the current window is mounted in an iframe.
+ * Cross-origin parent access can throw — treat that as "in iframe."
+ */
+export declare function detectIsIframe(): boolean;
+//# sourceMappingURL=resolveNavTarget.d.ts.map

package/dist/resolveNavTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveNavTarget.d.ts","sourceRoot":"","sources":["../src/resolveNavTarget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC;AAE9B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,SAAS,CAwBtE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAOxC"}

package/dist/resolveNavTarget.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolveNavTarget.test.d.ts.map

package/dist/resolveNavTarget.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveNavTarget.test.d.ts","sourceRoot":"","sources":["../src/resolveNavTarget.test.ts"],"names":[],"mappings":""}

package/dist/runtime.d.ts

@@ -2,6 +2,7 @@
  * Adaptive Nav - Runtime Module
  *
  * Runtime manifest for the navigation tips accordion adaptive.
+ * Mounts the `<syntro-nav-tips>` Lit web component.
  * Includes widget-based nav tips and navigation action executors
  * (scrollTo, navigate) previously in adaptive-navigation.
  */
@@ -26,8 +27,6 @@ export declare function navigateWithFrameworkRouter(url: string): boolean;
 export declare const executeNavigate: ActionExecutor<NavigateAction>;
 /**
  * NavWidgetLitMountable — Mounts the `<syntro-nav-tips>` Lit web component.
- *
- * Drop-in companion to NavMountableWidget that avoids React/ReactDOM entirely.
  * Self-registers the custom element on first use.
  */
 export declare const NavWidgetLitMountable: {
@@ -52,7 +51,7 @@ export declare const executors: readonly [{
  *
  * Provides:
  * - Navigation action executors (scrollTo, navigate)
- * - Widget-based nav tips accordion (compositional nav:tip actions)
+ * - Widget-based nav tips accordion using the Lit web component
  */
 export declare const runtime: {
     id: string;
@@ -78,7 +77,7 @@ export declare const runtime: {
             mount(container: HTMLElement, config?: NavConfig & {
                 runtime?: NavWidgetRuntime;
                 instanceId?: string;
-            }): (() => void) | undefined;
+            }): () => void;
         };
         metadata: {
             name: string;

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,cAAc,EAEd,SAAS,EACT,cAAc,EAEd,gBAAgB,EAChB,cAAc,EACf,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,cAAc,CA+B1D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAgDhE;AAgBD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,cAAc,CAuC1D,CAAC;AAMF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;qBAEnB,WAAW,WACb,SAAS,GAAG;QAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CA2B3E,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;EAGZ,CAAC;AAMX;;;;;;GAMG;AACH,eAAO,MAAM,OAAO;;;;;IAMlB;;OAEG;;;;;;;;IAGH;;OAEG;;;;;uBAqC68Y,CAAC;0BAA8B,CAAC;;;;;;;;;IAxBh/Y;;;;OAIG;0BACmB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;CAgB9C,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,cAAc,EAEd,SAAS,EACT,cAAc,EAEd,gBAAgB,EAChB,cAAc,EACf,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,cAAc,CA+B1D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAgDhE;AAgBD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,cAAc,CAuC1D,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;qBAEnB,WAAW,WACb,SAAS,GAAG;QAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CA2B3E,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;EAGZ,CAAC;AAMX;;;;;;GAMG;AACH,eAAO,MAAM,OAAO;;;;;IAMlB;;OAEG;;;;;;;;IAGH;;OAEG;;;;6BAnEU,WAAW,WACb,SAAS,GAAG;gBAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC;gBAAC,UAAU,CAAC,EAAE,MAAM,CAAA;aAAE;;;;;;;;IA+E1E;;;;OAIG;0BACmB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;CAgB9C,CAAC;AAEF,eAAe,OAAO,CAAC"}