@syntrologie/adapt-nav 2.8.0-canary.31 → 2.8.0-canary.310

package/dist/nav-item-editor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Adaptive Nav — Per-item editor element
+ *
+ * Standalone Lit element that renders the Nav per-item edit form
+ * (title / description / icon / external / category / href fields).
+ * Designed to be mountable both inside the existing right-side panel
+ * (Phase 3.2) and inside the modal host (Phase 3.3+).
+ *
+ * Decorator-free: uses `static override properties` (matches codebase pattern).
+ *
+ * Fields exposed (matching existing NavEditorLit._renderEditMode):
+ *   - title       (text)
+ *   - description (text)
+ *   - href        (text, deprecated but kept for backward compat)
+ *   - icon        (text)
+ *   - category    (text)
+ *   - external    (checkbox / boolean)
+ */
+import { LitElement } from 'lit';
+import type { NavConfig } from './types';
+export declare class NavItemEditorLit extends LitElement {
+    static styles: import("lit").CSSResult;
+    static properties: {
+        itemId: {
+            type: StringConstructor;
+            attribute: string;
+        };
+        appConfig: {
+            attribute: boolean;
+        };
+        onChange: {
+            attribute: boolean;
+        };
+    };
+    itemId: string;
+    appConfig: NavConfig;
+    onChange: (next: NavConfig) => void;
+    private _findItem;
+    private _patchField;
+    private _patchExternal;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=nav-item-editor.d.ts.map

package/dist/nav-item-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-item-editor.d.ts","sourceRoot":"","sources":["../src/nav-item-editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAa,UAAU,EAAW,MAAM,KAAK,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,SAAS,CAAC;AAMvD,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAgB,MAAM,0BAqDpB;IAEF,OAAgB,UAAU;;;;;;;;;;;MAIxB;IAEF,MAAM,SAAM;IAEZ,SAAS,EAAE,SAAS,CAIlB;IAEF,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAY;IAE/C,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,cAAc;IAYb,MAAM;CAqGhB"}

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,18 +2,35 @@
  * 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.
  */
-import type { ActionExecutor, NavigateAction, ScrollToAction } from './types';
+import { type MountPlumbing } from '@syntrologie/sdk-contracts';
+import type { ActionExecutor, NavConfig, NavigateAction, NavWidgetRuntime, ScrollToAction } from './types';
 /**
  * Execute a scrollTo action
  */
 export declare const executeScrollTo: ActionExecutor<ScrollToAction>;
+/**
+ * Try to navigate using the host framework's native router.
+ * Returns true if a framework router handled the navigation,
+ * false if no framework was detected (caller should use pushState or location.href).
+ *
+ * Using the native router preserves SPA behavior (no full reload),
+ * layout state, scroll position, and framework-specific features
+ * (RSC streaming, view transitions, etc.).
+ */
+export declare function navigateWithFrameworkRouter(url: string): boolean;
 /**
  * Execute a navigate action
  */
 export declare const executeNavigate: ActionExecutor<NavigateAction>;
+export declare const NavWidgetLitMountable: {
+    mount(container: HTMLElement, config?: (NavConfig & MountPlumbing & {
+        runtime?: NavWidgetRuntime;
+    }) | null): () => void;
+};
 /**
  * All executors provided by this app.
  * These are registered with the runtime's ExecutorRegistry.
@@ -30,7 +47,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;
@@ -53,10 +70,9 @@ export declare const runtime: {
     widgets: {
         id: string;
         component: {
-            mount(container: HTMLElement, config?: import("./types").NavConfig & {
-                runtime?: import("./types").NavWidgetRuntime;
-                instanceId?: string;
-            }): () => void;
+            mount(container: HTMLElement, config?: (NavConfig & MountPlumbing & {
+                runtime?: NavWidgetRuntime;
+            }) | null): () => 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;AAGH,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EAEd,cAAc,EACf,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,cAAc,CA+B1D,CAAC;AAgBF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,cAAc,CAoC1D,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;EAGZ,CAAC;AAMX;;;;;;GAMG;AACH,eAAO,MAAM,OAAO;;;;;IAMlB;;OAEG;;;;;;;;IAGH;;OAEG;;;;;uBAqCy5e,CAAC;0BAA8B,CAAC;;;;;;;;;IAxB57e;;;;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;AAEH,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,4BAA4B,CAAC;AAEpF,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,CAiD1D,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;AAgBF,eAAO,MAAM,qBAAqB;qBAEnB,WAAW,WACb,CAAC,SAAS,GAAG,aAAa,GAAG;QAAE,OAAO,CAAC,EAAE,gBAAgB,CAAA;KAAE,CAAC,GAAG,IAAI;CAuB/E,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;EAGZ,CAAC;AAMX;;;;;;GAMG;AACH,eAAO,MAAM,OAAO;;;;;IAMlB;;OAEG;;;;;;;;IAGH;;OAEG;;;;6BA/DU,WAAW,WACb,CAAC,SAAS,GAAG,aAAa,GAAG;gBAAE,OAAO,CAAC,EAAE,gBAAgB,CAAA;aAAE,CAAC,GAAG,IAAI;;;;;;;;IA2E9E;;;;OAIG;0BACmB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;CAgB9C,CAAC;AAEF,eAAe,OAAO,CAAC"}