@syntrologie/adapt-faq 2.16.0 → 2.17.0

package/dist/runtime-lit.js

@@ -1,94 +0,0 @@
-/**
- * Adaptive FAQ - Runtime Module (Lit)
- *
- * Runtime manifest for the FAQ accordion adaptive.
- * Uses the Lit web component mountable instead of the React one.
- * Provides action executors and widget registration.
- */
-import { executorDefinitions } from './executors';
-import './FAQWidgetLit'; // registers <syntro-faq-accordion> custom element
-// ============================================================================
-// Lit Mountable Widget
-// ============================================================================
-/**
- * Mountable widget interface for <syntro-faq-accordion> (Lit web component).
- *
- * Mirrors FAQMountableWidget but mounts the Lit element instead of a React
- * root — no React dependency required at mount time.
- */
-export const FAQWidgetLitMountable = {
-    mount(container, config) {
-        const { runtime, instanceId = 'faq-widget', ...faqConfig } = config ?? {
-            expandBehavior: 'single',
-            searchable: false,
-            theme: 'auto',
-            actions: [],
-        };
-        const el = document.createElement('syntro-faq-accordion');
-        Object.assign(el, {
-            faqConfig: faqConfig,
-            runtime: runtime ?? null,
-            instanceId,
-        });
-        container.appendChild(el);
-        return () => el.remove();
-    },
-};
-// ============================================================================
-// App Runtime Manifest
-// ============================================================================
-/**
- * Runtime manifest for adaptive-faq (Lit variant).
- *
- * Provides:
- * - FAQ action executors (scroll_to, toggle_item, update)
- * - Widget-based accordion using the Lit web component
- */
-export const runtime = {
-    id: 'adaptive-faq',
-    version: '2.0.0',
-    name: 'FAQ Accordion',
-    description: 'Collapsible Q&A accordion with actions, rich content, feedback, and personalization',
-    /**
-     * Action executors for programmatic FAQ interaction.
-     */
-    executors: executorDefinitions,
-    /**
-     * Widget definitions for the runtime's WidgetRegistry.
-     */
-    widgets: [
-        {
-            id: 'adaptive-faq:accordion',
-            component: FAQWidgetLitMountable,
-            metadata: {
-                name: 'FAQ Accordion',
-                description: 'Collapsible Q&A accordion with search, categories, and feedback',
-                icon: '❓',
-                subtitle: 'Curated just for you.',
-            },
-        },
-    ],
-    /**
-     * Extract notify watcher entries from tile config props.
-     * The runtime evaluates these continuously (even with drawer closed)
-     * and publishes faq:question_revealed when triggerWhen transitions false → true.
-     */
-    notifyWatchers(props) {
-        const actions = (props.actions ?? []);
-        return actions
-            .filter((a) => a.notify && a.triggerWhen)
-            .map((a) => ({
-            id: `faq:${a.config.id}`,
-            strategy: a.triggerWhen,
-            eventName: 'faq:question_revealed',
-            eventProps: {
-                questionId: a.config.id,
-                question: a.config.question,
-                title: a.notify.title,
-                body: a.notify.body,
-                icon: a.notify.icon,
-            },
-        }));
-    },
-};
-export default runtime;

package/dist/state.js

@@ -1,132 +0,0 @@
-/**
- * Adaptive FAQ - Shared Widget State Store
- *
- * Lightweight reactive store that executors and the widget both read/write.
- * Implements an observer pattern so UI components can subscribe to changes.
- */
-// ============================================================================
-// Factory
-// ============================================================================
-export function createFAQStore(initialItems) {
-    // Internal mutable state ---------------------------------------------------
-    let state = {
-        expandedItems: new Set(),
-        items: [...initialItems],
-        searchQuery: '',
-        collapsedCategories: new Set(),
-        feedbackState: new Map(),
-    };
-    const listeners = new Set();
-    // Notify all subscribers with the current state snapshot -------------------
-    function notify() {
-        for (const listener of listeners) {
-            listener(state);
-        }
-    }
-    // Helpers to produce new state objects (immutable from the outside) --------
-    function setState(patch) {
-        state = { ...state, ...patch };
-        notify();
-    }
-    // --- Public API -----------------------------------------------------------
-    function getState() {
-        return state;
-    }
-    function expand(itemId) {
-        const next = new Set(state.expandedItems);
-        next.add(itemId);
-        setState({ expandedItems: next });
-    }
-    function collapse(itemId) {
-        const next = new Set(state.expandedItems);
-        next.delete(itemId);
-        setState({ expandedItems: next });
-    }
-    function toggle(itemId) {
-        if (state.expandedItems.has(itemId)) {
-            collapse(itemId);
-        }
-        else {
-            expand(itemId);
-        }
-    }
-    function addItems(items, position) {
-        const next = position === 'prepend' ? [...items, ...state.items] : [...state.items, ...items];
-        setState({ items: next });
-    }
-    function removeItem(itemId) {
-        setState({
-            items: state.items.filter((i) => i.config.id !== itemId),
-        });
-    }
-    function reorderItems(order) {
-        const orderSet = new Set(order);
-        const itemMap = new Map(state.items.map((i) => [i.config.id, i]));
-        // Place items in the specified order first
-        const ordered = [];
-        for (const id of order) {
-            const item = itemMap.get(id);
-            if (item) {
-                ordered.push(item);
-            }
-        }
-        // Append any items that were not listed in the order array
-        for (const item of state.items) {
-            if (!orderSet.has(item.config.id)) {
-                ordered.push(item);
-            }
-        }
-        setState({ items: ordered });
-    }
-    function replaceItems(items) {
-        setState({ items: [...items] });
-    }
-    function setFeedback(itemId, value) {
-        const next = new Map(state.feedbackState);
-        next.set(itemId, value);
-        setState({ feedbackState: next });
-    }
-    function setSearchQuery(query) {
-        setState({ searchQuery: query });
-    }
-    function toggleCategory(category) {
-        const next = new Set(state.collapsedCategories);
-        if (next.has(category)) {
-            next.delete(category);
-        }
-        else {
-            next.add(category);
-        }
-        setState({ collapsedCategories: next });
-    }
-    function findByQuestion(text) {
-        const needle = text.toLowerCase();
-        for (const item of state.items) {
-            if (item.config.question.toLowerCase().includes(needle)) {
-                return item;
-            }
-        }
-        return null;
-    }
-    function subscribe(listener) {
-        listeners.add(listener);
-        return () => {
-            listeners.delete(listener);
-        };
-    }
-    return {
-        getState,
-        expand,
-        collapse,
-        toggle,
-        addItems,
-        removeItem,
-        reorderItems,
-        replaceItems,
-        setFeedback,
-        setSearchQuery,
-        toggleCategory,
-        findByQuestion,
-        subscribe,
-    };
-}

package/dist/summarize.js

@@ -1,62 +0,0 @@
-/**
- * Human-readable summary generation for FAQ items.
- * Pure functions — no DOM access, just string formatting.
- */
-const MAX_Q_LEN = 50;
-const MAX_A_LEN = 40;
-function truncate(text, max) {
-    if (text.length <= max)
-        return text;
-    return `${text.slice(0, max).trimEnd()}...`;
-}
-function stripHtml(html) {
-    return html.replace(/<[^>]*>/g, '').trim();
-}
-function getAnswerPreview(answer) {
-    if (typeof answer === 'string')
-        return answer;
-    if (answer.type === 'rich')
-        return stripHtml(answer.html);
-    return answer.content.replace(/[*_#`]/g, '').trim();
-}
-function isRuleStrategy(s) {
-    return (typeof s === 'object' &&
-        s !== null &&
-        s.type === 'rules' &&
-        Array.isArray(s.rules));
-}
-/**
- * Parse a triggerWhen strategy into a human-readable trigger description.
- */
-export function describeTrigger(triggerWhen) {
-    if (!triggerWhen)
-        return 'All pages';
-    if (!isRuleStrategy(triggerWhen))
-        return 'All pages';
-    const pages = [];
-    const anchors = [];
-    for (const rule of triggerWhen.rules) {
-        for (const condition of rule.conditions) {
-            if (condition.type === 'page_url' && typeof condition.url === 'string') {
-                pages.push(condition.url);
-            }
-            if (condition.type === 'anchor_visible' && typeof condition.anchorId === 'string') {
-                anchors.push(condition.anchorId);
-            }
-        }
-    }
-    const parts = [];
-    if (pages.length > 0)
-        parts.push(pages[0]);
-    if (anchors.length > 0)
-        parts.push(anchors[0]);
-    return parts.length > 0 ? parts.join(' \u00b7 ') : 'All pages';
-}
-/**
- * Generate a one-liner summary for an FAQ item.
- */
-export function summarizeFAQItem(item) {
-    const q = truncate(item.config.question, MAX_Q_LEN);
-    const a = truncate(getAnswerPreview(item.config.answer), MAX_A_LEN);
-    return `Q: "${q}" \u2014 ${a}`;
-}

package/dist/types.js

@@ -1,17 +0,0 @@
-/**
- * Adaptive FAQ - Types
- *
- * Type definitions for the FAQ accordion adaptive.
- * Demonstrates compositional action pattern with per-item triggerWhen.
- */
-// ============================================================================
-// Action Namespace
-// ============================================================================
-export const ACTION_NAMESPACE = 'faq';
-/**
- * Returns true if the action belongs to this adaptive package.
- * Uses prefix matching so new kinds (e.g. faq:category) are automatically included.
- */
-export function isOwnAction(action) {
-    return action.kind.startsWith(`${ACTION_NAMESPACE}:`);
-}

package/node_modules/@syntrologie/sdk-contracts/dist/index.d.ts

@@ -1,129 +0,0 @@
-/**
- * @syntrologie/sdk-contracts
- *
- * Shared TypeScript contracts between runtime-sdk and adaptive packages.
- * Executor types + shared Zod schemas for decision strategies and conditions.
- */
-export { AnchorIdZ, AnchorVisibleConditionZ, COUNTABLE_EVENTS, type ConditionSchema, ConditionZ, CooldownActiveConditionZ, CountableEventZ, CounterDefZ, type DecisionStrategySchema, DecisionStrategyZ, DismissedConditionZ, ELEMENT_MATCH_FIELDS, EventCountConditionZ, EventOccurredConditionZ, type EventScopeSchema, EventScopeZ, ExternalStrategyZ, FrequencyLimitConditionZ, MATCH_FIELD_DOCS, MatchOpZ, ModelStrategyZ, NotifyZ, PageUrlConditionZ, RouteConditionZ, type RuleSchema, RuleStrategyZ, RuleZ, ScoreStrategyZ, SESSION_METRIC_KEYS, SessionMetricConditionZ, SessionMetricKeyZ, StateEqualsConditionZ, TRIGGER_EXAMPLES, type TriggerWhenSchema, TriggerWhenZ, ViewportConditionZ, } from './schemas.js';
-/** Route-scoped anchor identifier */
-export interface AnchorId {
-    /** CSS selector for the anchor element */
-    selector: string;
-    /** Route pattern(s) where this anchor applies */
-    route: string | string[];
-}
-/** Highlight style configuration */
-export interface HighlightStyle {
-    /** Ring color (default: "#5b8cff") */
-    color?: string;
-    /** Backdrop scrim opacity 0-1 (default: 0.55) */
-    scrimOpacity?: number;
-    /** Padding between element and ring (default: 12px) */
-    paddingPx?: number;
-    /** Ring corner radius (default: 12px) */
-    radiusPx?: number;
-}
-/** Badge position relative to anchor */
-export type BadgePosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-/** CTA button configuration for tooltips/modals */
-export interface CtaButton {
-    label: string;
-    actionId: string;
-    primary?: boolean;
-}
-/** Modal content configuration */
-export interface ModalContent {
-    title?: string;
-    body: string;
-}
-/** Tooltip content configuration (action typed as unknown — packages with ActionStep keep local narrowing) */
-export interface TooltipContent {
-    title?: string;
-    body: string;
-    cta?: {
-        label: string;
-        action: unknown;
-    };
-    ctaButtons?: CtaButton[];
-}
-/** Tooltip trigger mode */
-export type TooltipTrigger = 'immediate' | 'hover' | 'click';
-/** Tooltip lifecycle — when the action completes (for sequences) */
-export type TooltipWaitFor = 'dismissed' | 'cta-click' | `timeout:${number}`;
-/** Modal lifecycle — when the action completes (for sequences) */
-export type ModalWaitFor = 'dismissed' | 'cta-click' | `timeout:${number}`;
-/** Position where HTML/content should be inserted */
-export type InsertPosition = 'before' | 'after' | 'prepend' | 'append' | 'replace';
-/** Deep-link target for opening a specific tile/item in the canvas sidebar */
-export interface DeepLink {
-    tileId: string;
-    itemId?: string;
-}
-/**
- * Scoped event filtering for event_count conditions.
- * The adaptive registers a predicate built from this scope.
- */
-export interface EventScope {
-    /** Event names to count */
-    events: string[];
-    /** URL path substring filter */
-    urlContains?: string;
-    /** Exact prop matching (e.g. { tagName: "a" }) */
-    props?: Record<string, string | number | boolean>;
-}
-/** Props passed to editor panel components by the ModularEditorPanel host. */
-export interface EditorPanelProps {
-    config: Record<string, unknown>;
-    onChange: (config: Record<string, unknown>) => void;
-    editor: {
-        setDirty: (dirty: boolean) => void;
-        navigateHome: () => Promise<boolean>;
-        save: () => Promise<void>;
-        publish: (captureScreenshot?: boolean) => Promise<void>;
-        /** Navigate the target page to a different route (preserves editor params). */
-        navigateTo: (route: string) => Promise<void>;
-        /** Show a persistent blue highlight on the element matching this selector. */
-        highlightElement: (selector: string) => void;
-        /** Remove the persistent element highlight. */
-        clearHighlight: () => void;
-        /** Get the current page route (pathname). */
-        getCurrentRoute: () => string;
-        /** Push a temporary config to the live page preview without saving to state. */
-        previewConfig: (config: Record<string, unknown>) => void;
-        /** Global before/after preview mode set by the panel's toggle. */
-        previewMode?: 'before' | 'after';
-        /** Flat action index to open in edit mode (from accordion navigation). */
-        initialEditKey?: string;
-        /** Open the editor in create mode. */
-        initialCreate?: boolean;
-        /** Clear the initial navigation state (call after consuming). */
-        clearInitialState?: () => void;
-        /** Get dismissed keys persisted in navigation context. */
-        getDismissedKeys?: () => Set<string>;
-        /** Sync dismissed keys back to navigation context. */
-        setDismissedKeys?: (keys: Set<string>) => void;
-        /** Register a back handler shown in the panel header. Pass null to clear. */
-        setBackHandler?: (handler: (() => void) | null) => void;
-    };
-    platformClient?: unknown;
-}
-/** Cleanup function returned by executors */
-export type ExecutorCleanup = () => void | Promise<void>;
-/** Update function for actions that support in-place updates */
-export type ExecutorUpdate = (changes: Record<string, unknown>) => void | Promise<void>;
-/** Result returned by action executors */
-export interface ExecutorResult {
-    cleanup: ExecutorCleanup;
-    updateFn?: ExecutorUpdate;
-}
-/** Context passed to action executors by the runtime */
-export interface ExecutorContext {
-    overlayRoot: HTMLElement;
-    resolveAnchor: (anchorId: AnchorId) => HTMLElement | null;
-    waitForAnchor?: (anchorId: AnchorId, timeoutMs?: number) => Promise<HTMLElement | null>;
-    generateId: () => string;
-    publishEvent: (name: string, props?: Record<string, unknown>) => void;
-    adaptiveId?: string;
-}
-/** Executor function signature */
-export type ActionExecutor<T = unknown> = (action: T, context: ExecutorContext) => Promise<ExecutorResult>;

package/node_modules/@syntrologie/sdk-contracts/dist/index.js

@@ -1,17 +0,0 @@
-/**
- * @syntrologie/sdk-contracts
- *
- * Shared TypeScript contracts between runtime-sdk and adaptive packages.
- * Executor types + shared Zod schemas for decision strategies and conditions.
- */
-export { 
-// Anchor ID schema
-AnchorIdZ, AnchorVisibleConditionZ, 
-// Trigger vocabulary — canonical enums, examples, and match field docs
-COUNTABLE_EVENTS, ConditionZ, CooldownActiveConditionZ, CountableEventZ, CounterDefZ, DecisionStrategyZ, DismissedConditionZ, ELEMENT_MATCH_FIELDS, EventCountConditionZ, EventOccurredConditionZ, 
-// Shared schemas
-EventScopeZ, ExternalStrategyZ, FrequencyLimitConditionZ, MATCH_FIELD_DOCS, MatchOpZ, ModelStrategyZ, NotifyZ, 
-// Condition schemas
-PageUrlConditionZ, RouteConditionZ, RuleStrategyZ, 
-// Strategy schemas
-RuleZ, ScoreStrategyZ, SESSION_METRIC_KEYS, SessionMetricConditionZ, SessionMetricKeyZ, StateEqualsConditionZ, TRIGGER_EXAMPLES, TriggerWhenZ, ViewportConditionZ, } from './schemas.js';