@syntrologie/adapt-nav 2.16.0 → 2.17.0

package/dist/NavWidgetLit.test.js

@@ -1,199 +0,0 @@
-/**
- * NavWidgetLit — Vitest + @open-wc/testing-helpers unit tests
- *
- * Tests cover: rendering, expand/collapse, nav-tip-clicked event, XSS rejection,
- * empty state, category grouping, and visibility filtering (triggerWhen).
- */
-import { fixture, html } from '@open-wc/testing-helpers';
-import { describe, expect, it, vi } from 'vitest';
-import { NavWidgetLit } from './NavWidgetLit';
-// ── Custom element registration ───────────────────────────────────────────────
-const TAG = 'syntro-nav-tips';
-if (!customElements.get(TAG)) {
-    customElements.define(TAG, NavWidgetLit);
-}
-// ── Helpers ────────────────────────────────────────────────────────────────────
-function makeTip(id, overrides = {}) {
-    return {
-        kind: 'nav:tip',
-        config: {
-            id,
-            title: `Tip ${id}`,
-            description: `Description for tip ${id}`,
-            ...overrides,
-        },
-    };
-}
-function makeRuntime(overrides = {}) {
-    return {
-        evaluateSync: vi.fn().mockReturnValue({ value: true, isFallback: false }),
-        context: { subscribe: vi.fn().mockReturnValue(vi.fn()) },
-        events: { publish: vi.fn() },
-        accumulator: {
-            subscribe: vi.fn().mockReturnValue(vi.fn()),
-            register: vi.fn(),
-        },
-        ...overrides,
-    };
-}
-function makeConfig(tips, overrides = {}) {
-    return {
-        expandBehavior: 'single',
-        theme: 'light',
-        actions: tips,
-        ...overrides,
-    };
-}
-async function renderWidget(tips, configOverrides = {}, runtime) {
-    const el = await fixture(html `<syntro-nav-tips></syntro-nav-tips>`);
-    el.config = makeConfig(tips, configOverrides);
-    el.runtime = runtime;
-    await el.updateComplete;
-    return el;
-}
-// ── Tests ─────────────────────────────────────────────────────────────────────
-describe('NavWidgetLit', () => {
-    // ── Rendering ────────────────────────────────────────────────────────────
-    it('renders navigation tips from config', async () => {
-        const el = await renderWidget([makeTip('t1'), makeTip('t2')]);
-        expect(el.querySelectorAll('[data-nav-tip-id]')).toHaveLength(2);
-        expect(el.querySelector('[data-nav-tip-id="t1"]')).not.toBeNull();
-        expect(el.querySelector('[data-nav-tip-id="t2"]')).not.toBeNull();
-    });
-    it('renders tip titles in button text', async () => {
-        const el = await renderWidget([makeTip('a', { title: 'My Nav Tip' })]);
-        const btn = el.querySelector('button');
-        expect(btn.textContent).toContain('My Nav Tip');
-    });
-    // ── Expand / collapse ────────────────────────────────────────────────────
-    it('starts with all tips collapsed', async () => {
-        const el = await renderWidget([makeTip('t1'), makeTip('t2')]);
-        const buttons = el.querySelectorAll('button[aria-expanded]');
-        for (const btn of Array.from(buttons)) {
-            expect(btn.getAttribute('aria-expanded')).toBe('false');
-        }
-    });
-    it('expands a tip when its header button is clicked', async () => {
-        const el = await renderWidget([makeTip('t1')]);
-        const btn = el.querySelector('[data-nav-tip-id="t1"] button');
-        btn.click();
-        await el.updateComplete;
-        expect(btn.getAttribute('aria-expanded')).toBe('true');
-    });
-    it('collapses an expanded tip on second click', async () => {
-        const el = await renderWidget([makeTip('t1')]);
-        const btn = el.querySelector('[data-nav-tip-id="t1"] button');
-        btn.click();
-        await el.updateComplete;
-        btn.click();
-        await el.updateComplete;
-        expect(btn.getAttribute('aria-expanded')).toBe('false');
-    });
-    it('collapses previously-expanded tip in single-expand mode', async () => {
-        const el = await renderWidget([makeTip('t1'), makeTip('t2')], {
-            expandBehavior: 'single',
-        });
-        const btn1 = el.querySelector('[data-nav-tip-id="t1"] button');
-        const btn2 = el.querySelector('[data-nav-tip-id="t2"] button');
-        btn1.click();
-        await el.updateComplete;
-        expect(btn1.getAttribute('aria-expanded')).toBe('true');
-        btn2.click();
-        await el.updateComplete;
-        expect(btn1.getAttribute('aria-expanded')).toBe('false');
-        expect(btn2.getAttribute('aria-expanded')).toBe('true');
-    });
-    it('allows multiple tips open simultaneously in multiple-expand mode', async () => {
-        const el = await renderWidget([makeTip('t1'), makeTip('t2')], {
-            expandBehavior: 'multiple',
-        });
-        const btn1 = el.querySelector('[data-nav-tip-id="t1"] button');
-        const btn2 = el.querySelector('[data-nav-tip-id="t2"] button');
-        btn1.click();
-        await el.updateComplete;
-        btn2.click();
-        await el.updateComplete;
-        expect(btn1.getAttribute('aria-expanded')).toBe('true');
-        expect(btn2.getAttribute('aria-expanded')).toBe('true');
-    });
-    // ── Custom event ─────────────────────────────────────────────────────────
-    it('fires nav-tip-clicked custom event when CTA link is clicked', async () => {
-        const tip = makeTip('t1', { href: '/dashboard' });
-        const el = await renderWidget([tip]);
-        // Expand so the CTA link is rendered
-        const btn = el.querySelector('[data-nav-tip-id="t1"] button');
-        btn.click();
-        await el.updateComplete;
-        const events = [];
-        el.addEventListener('nav-tip-clicked', (e) => events.push(e));
-        const link = el.querySelector('a');
-        link.click();
-        expect(events).toHaveLength(1);
-        expect(events[0].detail.href).toBe('/dashboard');
-    });
-    // ── XSS rejection ────────────────────────────────────────────────────────
-    it('does not navigate when href starts with javascript:', async () => {
-        const originalOpen = window.open;
-        const openSpy = vi.fn();
-        window.open = openSpy;
-        // Directly invoke the internal navigate path via a link with a JS URL
-        const tip = makeTip('xss', { href: 'javascript:alert(1)', external: false });
-        const el = await renderWidget([tip]);
-        const headerBtn = el.querySelector('[data-nav-tip-id="xss"] button');
-        headerBtn.click();
-        await el.updateComplete;
-        const link = el.querySelector('a');
-        if (link) {
-            const navEvents = [];
-            el.addEventListener('nav-tip-clicked', (e) => navEvents.push(e));
-            link.click();
-            // The click handler checks the href and bails out early — no event should fire
-            expect(navEvents).toHaveLength(0);
-        }
-        window.open = originalOpen;
-    });
-    // ── Empty state ───────────────────────────────────────────────────────────
-    it('renders empty state when config has no actions', async () => {
-        const el = await renderWidget([]);
-        // No tip items
-        expect(el.querySelectorAll('[data-nav-tip-id]')).toHaveLength(0);
-        // The empty-state message is present
-        expect(el.textContent).toContain("You're all set for now");
-    });
-    // ── Category grouping ─────────────────────────────────────────────────────
-    it('renders category headers when tips have categories', async () => {
-        const tips = [
-            makeTip('t1', { category: 'Getting Started' }),
-            makeTip('t2', { category: 'Advanced' }),
-        ];
-        const el = await renderWidget(tips);
-        const catHeaders = el.querySelectorAll('[data-category-header]');
-        expect(catHeaders).toHaveLength(2);
-        const headerTexts = Array.from(catHeaders).map((h) => h.textContent?.trim());
-        expect(headerTexts).toContain('Getting Started');
-        expect(headerTexts).toContain('Advanced');
-    });
-    it('does not render category headers when no tips have categories', async () => {
-        const tips = [makeTip('t1'), makeTip('t2')];
-        const el = await renderWidget(tips);
-        expect(el.querySelectorAll('[data-category-header]')).toHaveLength(0);
-    });
-    // ── Visibility filtering (triggerWhen) ────────────────────────────────────
-    it('hides tips whose triggerWhen evaluates to false', async () => {
-        const visibleTip = makeTip('visible');
-        const hiddenTip = {
-            ...makeTip('hidden'),
-            triggerWhen: { type: 'rules', rules: [], default: false },
-        };
-        const runtime = makeRuntime({
-            evaluateSync: vi.fn((strategy) => {
-                if (strategy.default === false)
-                    return { value: false, isFallback: false };
-                return { value: true, isFallback: false };
-            }),
-        });
-        const el = await renderWidget([visibleTip, hiddenTip], {}, runtime);
-        expect(el.querySelector('[data-nav-tip-id="visible"]')).not.toBeNull();
-        expect(el.querySelector('[data-nav-tip-id="hidden"]')).toBeNull();
-    });
-});

package/dist/cdn.d.ts

@@ -1,62 +0,0 @@
-/**
- * CDN Entry Point for Adaptive Nav
- *
- * This module is bundled for CDN delivery and self-registers with the global
- * SynOS app registry when loaded dynamically via the AppLoader.
- */
-import NavEditor from './editor';
-/**
- * App manifest for registry registration.
- * Follows the AppManifest interface expected by AppLoader/AppRegistry.
- */
-export declare const manifest: {
-    id: string;
-    version: string;
-    name: string;
-    description: string;
-    runtime: {
-        actions: {
-            kind: "navigation:scrollTo" | "navigation:navigate";
-            executor: import("packages/sdk-contracts/dist").ActionExecutor<import("./types").ScrollToAction> | import("packages/sdk-contracts/dist").ActionExecutor<import("./types").NavigateAction>;
-        }[];
-        widgets: {
-            id: string;
-            component: {
-                mount(container: HTMLElement, config?: import("./types").NavConfig & {
-                    runtime?: import("./types").NavWidgetRuntime;
-                    instanceId?: string;
-                }): (() => void) | undefined;
-            };
-            metadata: {
-                name: string;
-                description: string;
-                icon: string;
-            };
-        }[];
-        notifyWatchers: (props: Record<string, unknown>) => {
-            id: string;
-            strategy: import("./types").DecisionStrategy<boolean>;
-            eventName: string;
-            eventProps: {
-                tipId: string;
-                title: string | undefined;
-                body: string | undefined;
-                icon: string | undefined;
-            };
-        }[];
-    };
-    editor: {
-        component: typeof NavEditor;
-        panel: {
-            title: string;
-            icon: string;
-            description: string;
-        };
-        getActionLabel(action: Record<string, unknown>): string;
-    };
-    metadata: {
-        isBuiltIn: boolean;
-    };
-};
-export default manifest;
-//# sourceMappingURL=cdn.d.ts.map

package/dist/cdn.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cdn.d.ts","sourceRoot":"","sources":["../src/cdn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,SAA0B,MAAM,UAAU,CAAC;AAGlD;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;2BAsCmymB,CAAC;8BAA8B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAtB7zmB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;CAQjD,CAAC;AAaF,eAAe,QAAQ,CAAC"}

package/dist/cdn.js

@@ -1,48 +0,0 @@
-/**
- * CDN Entry Point for Adaptive Nav
- *
- * This module is bundled for CDN delivery and self-registers with the global
- * SynOS app registry when loaded dynamically via the AppLoader.
- */
-import NavEditor, { editorPanel } from './editor';
-import { executors, runtime } from './runtime';
-/**
- * App manifest for registry registration.
- * Follows the AppManifest interface expected by AppLoader/AppRegistry.
- */
-export const manifest = {
-    id: 'adaptive-nav',
-    version: runtime.version,
-    name: runtime.name,
-    description: runtime.description,
-    runtime: {
-        actions: executors.map(({ kind, executor }) => ({
-            kind,
-            executor,
-        })),
-        widgets: runtime.widgets,
-        notifyWatchers: runtime.notifyWatchers,
-    },
-    editor: {
-        component: NavEditor,
-        panel: editorPanel,
-        getActionLabel(action) {
-            const config = action.config || {};
-            return config.title || action.kind || 'nav:tip';
-        },
-    },
-    metadata: {
-        isBuiltIn: false,
-    },
-};
-/**
- * Self-register with global registry if available.
- * This happens when loaded via script tag (UMD).
- */
-if (typeof window !== 'undefined') {
-    const registry = window.SynOS?.appRegistry;
-    if (registry && typeof registry.register === 'function') {
-        registry.register(manifest);
-    }
-}
-export default manifest;

package/dist/editor-lit.d.ts

@@ -1,49 +0,0 @@
-/**
- * Adaptive Nav - Lit Editor Component
- *
- * Lit web component port of the React Nav editor (editor.tsx).
- * Displays nav tip cards with detection badges, inline editing
- * (Title, Description, Link URL, Icon, Category), and rationale.
- *
- * Custom events:
- *   navigate-home — user clicked back
- *   dirty-change  — { dirty: boolean }
- */
-import { LitElement } from 'lit';
-import { type NavConfig } from './types';
-export declare class NavEditorLit extends LitElement {
-    static properties: {
-        config: {
-            attribute: boolean;
-        };
-        onChange: {
-            attribute: boolean;
-        };
-        _editingKey: {
-            state: boolean;
-        };
-        _detectionMap: {
-            state: boolean;
-        };
-    };
-    config: NavConfig | null;
-    onChange: ((updated: Record<string, unknown>) => void) | null;
-    private _editingKey;
-    private _detectionMap;
-    private _detectionInterval;
-    private _onPopstate;
-    createRenderRoot(): this;
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    firstUpdated(): void;
-    private _runDetection;
-    private _handleBack;
-    private _handleItemClick;
-    private _handleFieldChange;
-    private _handleBadgeClick;
-    private _renderDetectionBadge;
-    private _renderEditMode;
-    private _renderListMode;
-    render(): import("lit-html").TemplateResult<1>;
-}
-//# sourceMappingURL=editor-lit.d.ts.map

package/dist/editor-lit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"editor-lit.d.ts","sourceRoot":"","sources":["../src/editor-lit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAQ,UAAU,EAAW,MAAM,KAAK,CAAC;AAGhD,OAAO,EAAe,KAAK,SAAS,EAAwC,MAAM,SAAS,CAAC;AAkH5F,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAgB,UAAU;;;;;;;;;;;;;MAKxB;IAEF,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAChC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAErE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,kBAAkB,CAA+C;IACzE,OAAO,CAAC,WAAW,CAA8B;IAExC,gBAAgB;IAIhB,iBAAiB,IAAI,IAAI;IAOzB,oBAAoB,IAAI,IAAI;IAS5B,YAAY,IAAI,IAAI;IAK7B,OAAO,CAAC,aAAa,CAGnB;IAIF,OAAO,CAAC,WAAW,CAMjB;IAEF,OAAO,CAAC,gBAAgB,CAEtB;IAEF,OAAO,CAAC,kBAAkB,CAaxB;IAIF,OAAO,CAAC,iBAAiB,CAOvB;IAEF,OAAO,CAAC,qBAAqB,CAkB3B;IAEF,OAAO,CAAC,eAAe,CA0DrB;IAEF,OAAO,CAAC,eAAe,CA0CrB;IAEO,MAAM;CAoChB"}