@syntrologie/adapt-nav 2.16.0 → 2.17.0

package/dist/editor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/editor.ts", "../src/summarize.ts", "../src/types.ts"],
+  "sourcesContent": ["/**\n * Adaptive Nav - Editor Component\n *\n * Lit web component that displays nav tip cards with detection badges,\n * inline editing (Title, Description, Link URL, Icon, Category), and rationale.\n *\n * Custom events:\n *   navigate-home \u2014 user clicked back\n *   dirty-change  \u2014 { dirty: boolean }\n */\n\nimport { html, LitElement, nothing } from 'lit';\n\nimport { describeTrigger, summarizeNavItem } from './summarize';\nimport { isOwnAction, type NavConfig, type NavTipAction, type RuleStrategy } from './types';\n\n// ============================================================================\n// Types\n// ============================================================================\n\ninterface FlatItem {\n  key: string;\n  index: number;\n  summary: string;\n  trigger: string;\n  rationale?: string;\n  firstAnchor: string | null;\n  firstPage: string | null;\n  tip: NavTipAction;\n}\n\ninterface DetectionEntry {\n  found: boolean;\n}\n\n// ============================================================================\n// Targeting Extraction\n// ============================================================================\n\nconst isRuleStrategy = (s: unknown): s is RuleStrategy<boolean> =>\n  typeof s === 'object' &&\n  s !== null &&\n  (s as Record<string, unknown>).type === 'rules' &&\n  Array.isArray((s as Record<string, unknown>).rules);\n\nconst extractFirstPage = (triggerWhen?: unknown): string | null => {\n  if (!triggerWhen || !isRuleStrategy(triggerWhen)) return null;\n  for (const rule of triggerWhen.rules) {\n    for (const cond of rule.conditions) {\n      const c = cond as Record<string, unknown>;\n      if (c.type === 'page_url' && typeof c.url === 'string') return c.url;\n    }\n  }\n  return null;\n};\n\nconst extractFirstAnchor = (triggerWhen?: unknown): string | null => {\n  if (!triggerWhen || !isRuleStrategy(triggerWhen)) return null;\n  for (const rule of triggerWhen.rules) {\n    for (const cond of rule.conditions) {\n      const c = cond as Record<string, unknown>;\n      if (c.type === 'anchor_visible' && typeof c.anchorId === 'string') return c.anchorId;\n    }\n  }\n  return null;\n};\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nconst flattenItems = (config: NavConfig): FlatItem[] => {\n  const actions = (config.actions || []).filter(isOwnAction);\n  return actions.map((tip, i) => {\n    // Prefer the tip's own anchor (real pipeline data ships the target here).\n    // Fall back to an `anchor_visible` condition inside triggerWhen for older configs.\n    const tipAnchor = tip.kind === 'nav:tip' ? tip.config.anchor?.selector : undefined;\n    const rawRoute = tip.kind === 'nav:tip' ? tip.config.anchor?.route : undefined;\n    const tipRoute = typeof rawRoute === 'string' ? rawRoute : undefined;\n    return {\n      key: String(i),\n      index: i,\n      summary: summarizeNavItem(tip),\n      trigger: describeTrigger(tip.triggerWhen),\n      rationale: tip.rationale?.why,\n      firstAnchor: tipAnchor || extractFirstAnchor(tip.triggerWhen),\n      firstPage: tipRoute || extractFirstPage(tip.triggerWhen),\n      tip,\n    };\n  });\n};\n\nconst runDetection = (items: FlatItem[]): Map<string, DetectionEntry> => {\n  const map = new Map<string, DetectionEntry>();\n  const currentPath = window.location.pathname;\n\n  for (const item of items) {\n    // Page match\n    let pageMatch = true;\n    if (item.firstPage) {\n      const pattern = item.firstPage;\n      const regex = new RegExp(\n        `^${pattern.replace(/\\*\\*/g, '.*').replace(/(?<!\\.)(\\*)/g, '[^/]*')}$`\n      );\n      pageMatch = regex.test(currentPath);\n    }\n\n    // Anchor match\n    let anchorFound = false;\n    if (item.firstAnchor) {\n      try {\n        anchorFound = document.querySelector(item.firstAnchor) !== null;\n      } catch {\n        // Invalid selector\n      }\n    } else {\n      anchorFound = pageMatch;\n    }\n\n    map.set(item.key, { found: pageMatch && anchorFound });\n  }\n  return map;\n};\n\n// ============================================================================\n// Element\n// ============================================================================\n\nexport class NavEditorLit extends LitElement {\n  static override properties = {\n    config: { attribute: false },\n    onChange: { attribute: false },\n    _editingKey: { state: true },\n    _detectionMap: { state: true },\n  };\n\n  config: NavConfig | null = null;\n  onChange: ((updated: Record<string, unknown>) => void) | null = null;\n\n  private _editingKey: string | null = null;\n  private _detectionMap: Map<string, DetectionEntry> = new Map();\n  private _detectionInterval: ReturnType<typeof setInterval> | null = null;\n  private _onPopstate = () => this._runDetection();\n\n  override createRenderRoot() {\n    return this;\n  }\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    window.addEventListener('popstate', this._onPopstate);\n    // Run detection on an interval (matches React's 2s interval)\n    this._detectionInterval = setInterval(() => this._runDetection(), 2000);\n  }\n\n  override disconnectedCallback(): void {\n    window.removeEventListener('popstate', this._onPopstate);\n    if (this._detectionInterval) {\n      clearInterval(this._detectionInterval);\n      this._detectionInterval = null;\n    }\n    super.disconnectedCallback();\n  }\n\n  override firstUpdated(): void {\n    this._runDetection();\n    // No auto-dirty on load \u2014 only dirty when user makes changes (matching React behavior).\n  }\n\n  private _runDetection = () => {\n    if (!this.config) return;\n    this._detectionMap = runDetection(flattenItems(this.config));\n  };\n\n  // ---- Actions ----\n\n  private _handleBack = () => {\n    if (this._editingKey !== null) {\n      this._editingKey = null;\n    } else {\n      this.dispatchEvent(new CustomEvent('navigate-home', { bubbles: true }));\n    }\n  };\n\n  private _handleItemClick = (key: string) => {\n    this._editingKey = key;\n  };\n\n  private _handleFieldChange = (index: number, field: string, value: unknown) => {\n    if (!this.config || !this.onChange) return;\n\n    const ownActions = (this.config.actions || []).filter(isOwnAction).slice();\n    const tip = { ...ownActions[index], config: { ...ownActions[index].config } };\n    (tip.config as Record<string, unknown>)[field] = value;\n    ownActions[index] = tip;\n\n    const otherActions = (this.config.actions || []).filter((a) => !isOwnAction(a));\n    const updated = { ...this.config, actions: [...otherActions, ...ownActions] };\n    this.onChange(updated as unknown as Record<string, unknown>);\n\n    this.dispatchEvent(new CustomEvent('dirty-change', { detail: { dirty: true }, bubbles: true }));\n  };\n\n  // ---- Render ----\n\n  private _handleBadgeClick = (item: FlatItem, e: Event) => {\n    e.stopPropagation();\n    const href = item.tip.config.href;\n    if (!href) return;\n    // SPA navigate via pushState + popstate\n    window.history.pushState({}, '', href);\n    window.dispatchEvent(new PopStateEvent('popstate'));\n  };\n\n  private _renderDetectionBadge = (item: FlatItem) => {\n    const detection = this._detectionMap.get(item.key);\n    const found = detection?.found ?? false;\n\n    if (found) {\n      return html`<button type=\"button\"\n        title=\"Click to scroll to element\"\n        @click=${(e: Event) => this._handleBadgeClick(item, e)}\n        class=\"se-shrink-0 se-w-2 se-h-2 se-rounded-full se-border-none se-cursor-pointer\"\n        style=\"background:#22c55e\"\n      ></button>`;\n    }\n    return html`<button type=\"button\"\n      title=\"Click to navigate to page\"\n      @click=${(e: Event) => this._handleBadgeClick(item, e)}\n      class=\"se-shrink-0 se-w-2 se-h-2 se-rounded-full se-border-none se-cursor-pointer\"\n      style=\"background:#ef4444\"\n    ></button>`;\n  };\n\n  private _renderEditMode = (item: FlatItem) => {\n    const tip = item.tip;\n    return html`\n      <div class=\"se-py-1\">\n        <div class=\"se-flex se-items-center se-gap-2 se-mb-3 se-text-[13px] se-font-semibold se-text-text-primary\">\n          <span>\uD83E\uDDED</span>\n          <span>${item.summary}</span>\n        </div>\n\n        <div class=\"se-mb-3\">\n          <label class=\"se-text-[11px] se-font-semibold se-text-text-secondary se-mb-1 se-block\">Title</label>\n          <input type=\"text\" .value=${tip.config.title}\n            @input=${(e: Event) => this._handleFieldChange(item.index, 'title', (e.target as HTMLInputElement).value)}\n            class=\"se-w-full se-p-2 se-rounded se-border se-border-border-primary se-bg-input-field-bg se-text-text-primary se-text-sm\" />\n        </div>\n\n        <div class=\"se-mb-3\">\n          <label class=\"se-text-[11px] se-font-semibold se-text-text-secondary se-mb-1 se-block\">Description</label>\n          <input type=\"text\" .value=${tip.config.description}\n            @input=${(e: Event) => this._handleFieldChange(item.index, 'description', (e.target as HTMLInputElement).value)}\n            class=\"se-w-full se-p-2 se-rounded se-border se-border-border-primary se-bg-input-field-bg se-text-text-primary se-text-sm\" />\n        </div>\n\n        <div class=\"se-mb-3\">\n          <label class=\"se-text-[11px] se-font-semibold se-text-text-secondary se-mb-1 se-block\">Link URL</label>\n          <input type=\"text\" .value=${tip.config.href || ''} placeholder=\"Optional\"\n            @input=${(e: Event) => this._handleFieldChange(item.index, 'href', (e.target as HTMLInputElement).value)}\n            class=\"se-w-full se-p-2 se-rounded se-border se-border-border-primary se-bg-input-field-bg se-text-text-primary se-text-sm\" />\n        </div>\n\n        <div class=\"se-mb-3\">\n          <label class=\"se-text-[11px] se-font-semibold se-text-text-secondary se-mb-1 se-block\">Icon</label>\n          <input type=\"text\" .value=${tip.config.icon || ''} placeholder=\"e.g., \uD83E\uDDED\"\n            @input=${(e: Event) => this._handleFieldChange(item.index, 'icon', (e.target as HTMLInputElement).value)}\n            class=\"se-w-full se-p-2 se-rounded se-border se-border-border-primary se-bg-input-field-bg se-text-text-primary se-text-sm\" />\n        </div>\n\n        <div class=\"se-mb-3\">\n          <label class=\"se-text-[11px] se-font-semibold se-text-text-secondary se-mb-1 se-block\">Category</label>\n          <input type=\"text\" .value=${tip.config.category || ''} placeholder=\"Optional\"\n            @input=${(e: Event) => this._handleFieldChange(item.index, 'category', (e.target as HTMLInputElement).value)}\n            class=\"se-w-full se-p-2 se-rounded se-border se-border-border-primary se-bg-input-field-bg se-text-text-primary se-text-sm\" />\n        </div>\n\n        ${\n          tip.rationale\n            ? html`\n          <div>\n            <span class=\"se-text-[11px] se-font-semibold se-text-text-secondary se-mb-1 se-block\">AI Rationale</span>\n            <div class=\"se-p-2 se-rounded se-border se-border-dashed se-border-border-primary se-bg-card-bg se-text-text-secondary se-text-xs se-mb-2\">\n              ${tip.rationale.why}\n            </div>\n          </div>\n        `\n            : nothing\n        }\n      </div>\n    `;\n  };\n\n  private _renderListMode = (items: FlatItem[]) => {\n    if (items.length === 0) {\n      return html`<div class=\"se-text-center se-py-8 se-px-4 se-text-text-secondary se-text-sm\">\n        No tips configured.\n      </div>`;\n    }\n\n    return html`\n      <div class=\"se-text-[11px] se-font-semibold se-uppercase se-tracking-wider se-text-text-secondary se-mb-2 se-px-1\">\n        TIPS <span class=\"se-text-text-tertiary se-font-normal\">${items.length}</span>\n      </div>\n      ${items.map(\n        (item) => html`\n        <div\n          data-item-key=${item.key}\n          data-card-body\n          @click=${() => this._handleItemClick(item.key)}\n          class=\"se-p-3 se-rounded-lg se-border se-border-border-primary se-bg-card-bg se-cursor-pointer se-mb-2 se-transition-all hover:se-border-pink-4/40 hover:se-bg-pink-4/5\"\n        >\n          <div class=\"se-flex se-items-center se-gap-2\">\n            ${this._renderDetectionBadge(item)}\n            <span class=\"se-flex-1 se-overflow-hidden se-text-ellipsis se-whitespace-nowrap se-text-sm se-text-text-primary\">\n              ${item.summary}\n            </span>\n          </div>\n          ${\n            item.trigger !== 'All pages'\n              ? html`\n            <div class=\"se-text-[10px] se-text-text-tertiary se-mt-1\">\uD83D\uDCCD ${item.trigger}</div>\n          `\n              : nothing\n          }\n          ${\n            item.rationale\n              ? html`\n            <div class=\"se-text-[10px] se-text-text-tertiary se-mt-1\">WHY: ${item.rationale}</div>\n          `\n              : nothing\n          }\n        </div>\n      `\n      )}\n    `;\n  };\n\n  override render() {\n    if (!this.config) {\n      return html`<div class=\"se-p-8 se-text-center se-text-text-secondary se-text-sm\">Loading...</div>`;\n    }\n\n    const items = flattenItems(this.config);\n    const editItem =\n      this._editingKey !== null ? items.find((it) => it.key === this._editingKey) : null;\n\n    return html`\n      <div class=\"se-flex se-flex-col se-h-full\">\n        <!-- Header (no Back button \u2014 panel provides that) -->\n        <div class=\"se-px-4 se-pt-3 se-pb-1\">\n          <h2 class=\"se-m-0 se-text-base se-font-semibold se-text-text-primary\">Navigation Tips</h2>\n          <p class=\"se-m-0 se-mt-0.5 se-text-xs se-text-text-secondary\">\n            ${items.length} tip${items.length !== 1 ? 's' : ''}\n          </p>\n        </div>\n\n        <div class=\"se-flex-1 se-overflow-auto se-p-4\">\n          ${\n            editItem\n              ? html`\n            <button type=\"button\" @click=${() => {\n              this._editingKey = null;\n            }}\n              class=\"se-mb-3 se-py-1 se-px-2 se-rounded se-border-none se-bg-card-bg se-text-text-secondary se-text-xs se-cursor-pointer\"\n            >\u2190 Back to list</button>\n            ${this._renderEditMode(editItem)}\n          `\n              : this._renderListMode(items)\n          }\n        </div>\n      </div>\n    `;\n  }\n}\n\ncustomElements.define('se-nav-editor', NavEditorLit);\n", "/**\n * Human-readable summary generation for Nav items.\n * Pure functions \u2014 no DOM access, just string formatting.\n */\n\nimport type { DecisionStrategy, NavTipAction, RuleStrategy } from './types';\n\nconst MAX_TITLE_LEN = 30;\n\nfunction truncate(text: string, max: number): string {\n  if (text.length <= max) return text;\n  return `${text.slice(0, max).trimEnd()}...`;\n}\n\nfunction isRuleStrategy(s: unknown): s is RuleStrategy<boolean> {\n  return (\n    typeof s === 'object' &&\n    s !== null &&\n    (s as Record<string, unknown>).type === 'rules' &&\n    Array.isArray((s as Record<string, unknown>).rules)\n  );\n}\n\n/**\n * Parse a triggerWhen strategy into a human-readable trigger description.\n */\nexport function describeTrigger(triggerWhen?: DecisionStrategy<boolean> | null): string {\n  if (!triggerWhen) return 'All pages';\n  if (!isRuleStrategy(triggerWhen)) return 'All pages';\n\n  const pages: string[] = [];\n  const anchors: string[] = [];\n\n  for (const rule of triggerWhen.rules) {\n    for (const condition of rule.conditions) {\n      if (condition.type === 'page_url' && typeof (condition as any).url === 'string') {\n        pages.push((condition as any).url);\n      }\n      if (condition.type === 'anchor_visible' && typeof (condition as any).anchorId === 'string') {\n        anchors.push((condition as any).anchorId);\n      }\n    }\n  }\n\n  const parts: string[] = [];\n  if (pages.length > 0) parts.push(pages[0]);\n  if (anchors.length > 0) parts.push(anchors[0]);\n\n  return parts.length > 0 ? parts.join(' \\u00b7 ') : 'All pages';\n}\n\n/**\n * Generate a one-liner summary for a Nav tip.\n */\nexport function summarizeNavItem(item: NavTipAction): string {\n  const icon = item.config.icon || '\\u{1F9ED}';\n  const title = truncate(item.config.title, MAX_TITLE_LEN);\n  return `${icon} ${title}`;\n}\n", "/**\n * Adaptive Nav - Types\n *\n * Type definitions for the navigation tips accordion adaptive.\n * Demonstrates compositional action pattern with per-item triggerWhen.\n */\n\n// ============================================================================\n// Decision Strategy Types (from runtime-sdk)\n// ============================================================================\n\n/**\n * Simplified DecisionStrategy type for this package.\n * Full definition is in @syntrologie/runtime-sdk.\n */\nexport type DecisionStrategy<T = unknown> =\n  | RuleStrategy<T>\n  | ScoreStrategy<T>\n  | ModelStrategy<T>\n  | ExternalStrategy<T>;\n\nexport interface RuleStrategy<T = unknown> {\n  type: 'rules';\n  rules: Array<{\n    conditions: Array<Record<string, unknown>>;\n    value: T;\n  }>;\n  default: T;\n}\n\nexport interface ScoreStrategy<T = unknown> {\n  type: 'score';\n  field: string;\n  threshold: number;\n  above: T;\n  below: T;\n}\n\nexport interface ModelStrategy<T = unknown> {\n  type: 'model';\n  modelId: string;\n  inputs: string[];\n  outputMapping: Record<string, T>;\n  default: T;\n}\n\nexport interface ExternalStrategy<T = unknown> {\n  type: 'external';\n  endpoint: string;\n  method?: 'GET' | 'POST';\n  default: T;\n  timeoutMs?: number;\n}\n\n// ============================================================================\n// Event Scope Types (from sdk-contracts)\n// ============================================================================\n\n// ============================================================================\n// Nav Tip Action Types\n// ============================================================================\n\n/**\n * Single navigation tip configuration.\n * This is a \"compositional action\" \u2014 rendered as an accordion item by the parent.\n */\nexport interface NavTipAction {\n  /** Action kind identifier */\n  kind: 'nav:tip';\n  /** Tip configuration */\n  config: {\n    /** Unique identifier for this tip */\n    id: string;\n    /** Accordion header text */\n    title: string;\n    /** Expanded body text */\n    description: string;\n    /**\n     * Target anchor: route = where to go, selector = what to highlight/focus.\n     * - Same page + valid selector \u2192 scroll + pulse + focus\n     * - Same page + no selector/\"*\" \u2192 no-op (already there)\n     * - Different page \u2192 navigate via pushState + popstate\n     */\n    anchor?: AnchorId;\n    /** @deprecated Use anchor instead. Falls back to { route: href, selector: \"*\" } */\n    href?: string;\n    /** Optional icon (emoji or icon key) */\n    icon?: string;\n    /** Whether the link opens in a new tab */\n    external?: boolean;\n    /** Category for grouping */\n    category?: string;\n  };\n  /** Optional per-item activation strategy */\n  triggerWhen?: DecisionStrategy<boolean> | null;\n  /** Toast config when triggerWhen transitions false \u2192 true. Required when triggerWhen is set (use null to opt out). */\n  notify?: { title?: string; body?: string; icon?: string } | null;\n  /** AI-generated reasoning for why this tip was recommended */\n  rationale?: {\n    why: string;\n    confidence?: number;\n  };\n}\n\n/** @deprecated Use NavTipAction instead */\nexport type NavLinkAction = NavTipAction;\n\n// ============================================================================\n// Nav Widget Configuration\n// ============================================================================\n\n/**\n * Expand behavior for the accordion.\n */\nexport type NavExpandBehavior = 'single' | 'multiple';\n\n/**\n * Theme for the navigation widget.\n */\nexport type NavTheme = 'light' | 'dark' | 'auto';\n\n/**\n * Full configuration for the adaptive-nav widget.\n */\nexport interface NavConfig {\n  /** Expand behavior */\n  expandBehavior: NavExpandBehavior;\n  /** Color theme */\n  theme: NavTheme;\n  /** Navigation tips (compositional actions) */\n  actions: NavTipAction[];\n}\n\n// ============================================================================\n// Widget Props Types\n// ============================================================================\n\n/**\n * Runtime services passed to the widget.\n */\nexport interface NavWidgetRuntime {\n  /** Synchronously evaluate a decision strategy */\n  evaluateSync: <T>(strategy: DecisionStrategy<T>) => { value: T; isFallback: boolean };\n  /** Context manager for subscribing to changes */\n  context: {\n    subscribe: (callback: () => void) => () => void;\n  };\n  /** Event bus for publishing interactions */\n  events: {\n    publish: (name: string, props?: Record<string, unknown>) => void;\n  };\n  /** Event accumulator for event_count-based triggerWhen */\n  accumulator?: {\n    subscribe: (callback: () => void) => () => void;\n    register: (key: string, predicate: (event: any) => boolean) => void;\n  };\n}\n\n/**\n * Props passed to the NavWidget component.\n */\nexport interface NavWidgetProps {\n  /** Widget configuration */\n  config: NavConfig;\n  /** Runtime services */\n  runtime: NavWidgetRuntime;\n  /** Instance ID for telemetry */\n  instanceId: string;\n}\n\n// ============================================================================\n// Navigation Action Types (merged from adaptive-navigation)\n// ============================================================================\n\nimport type { AnchorId } from '@syntrologie/sdk-contracts';\n\ninterface BaseAction {\n  label?: string;\n}\n\nexport interface ScrollToAction extends BaseAction {\n  kind: 'navigation:scrollTo';\n  anchorId: AnchorId;\n  behavior?: ScrollBehavior;\n  block?: ScrollLogicalPosition;\n  inline?: ScrollLogicalPosition;\n}\n\nexport interface NavigateAction extends BaseAction {\n  kind: 'navigation:navigate';\n  url: string;\n  target?: '_self' | '_blank';\n  /** When true, always use full page navigation (window.location.href) even for same-origin URLs. */\n  forceFullNavigation?: boolean;\n}\n\n// ============================================================================\n// Action Namespace\n// ============================================================================\n\nexport const ACTION_NAMESPACES = ['nav', 'navigation'] as const;\n\n/**\n * Returns true if the action belongs to this adaptive package.\n * Uses prefix matching so new kinds (e.g. nav:dropdown) are automatically included.\n * Covers both `nav:*` (compositional) and `navigation:*` (executor) prefixes.\n */\nexport function isOwnAction(action: { kind: string }): boolean {\n  return ACTION_NAMESPACES.some((ns) => action.kind.startsWith(`${ns}:`));\n}\n\n// ============================================================================\n// Executor Types (from shared contracts)\n// ============================================================================\n\nexport type {\n  ActionExecutor,\n  ExecutorCleanup,\n  ExecutorContext,\n  ExecutorResult,\n  ExecutorUpdate,\n} from '@syntrologie/sdk-contracts';\n\n// ============================================================================\n// Editor Types (from sdk-contracts)\n// ============================================================================\n\nexport type { EditorPanelProps } from '@syntrologie/sdk-contracts';\n"],
+  "mappings": "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",
+  "names": ["isRuleStrategy"]
+}

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"}