@syntrologie/adapt-faq 0.0.0-semantically-released → 2.0.1

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0DxB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;QAG1B,0CAA0C;;QAE1C,wBAAwB;;QAExB,gDAAgD;;QAEhD,qCAAqC;;;;;;;;;;;;;IAGvC,wDAAwD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAExD,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAMtE;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,qEAAqE;;IAErE,4CAA4C;;IAE5C,kBAAkB;;IAElB,4CAA4C;;;;YA7B1C,0CAA0C;;YAE1C,wBAAwB;;YAExB,gDAAgD;;YAEhD,qCAAqC;;;;;;;;;;;;;QAGvC,wDAAwD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBxD,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAMrD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE9C"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/schema.js

@@ -50,6 +50,71 @@ const DecisionStrategyZ = z.discriminatedUnion('type', [
     ExternalStrategyZ,
 ]);
 // ============================================================================
+// Rich Answer Content Schemas
+// ============================================================================
+/** Schema for media assets embedded in enhanced markdown answers. */
+const AssetZ = z.object({
+    id: z.string(),
+    type: z.enum(['image', 'video']),
+    src: z.string(),
+    alt: z.string().optional(),
+    width: z.number().optional(),
+    height: z.number().optional(),
+});
+/** Schema for rich HTML answer content. */
+const RichHTMLAnswerZ = z.object({
+    type: z.literal('rich'),
+    html: z.string(),
+});
+/** Schema for enhanced markdown answer content with optional assets. */
+const EnhancedMarkdownAnswerZ = z.object({
+    type: z.literal('markdown'),
+    content: z.string(),
+    assets: z.array(AssetZ).optional(),
+});
+/** Union of all FAQ answer types: plain string, rich HTML, or enhanced markdown. */
+const FAQAnswerZ = z.union([z.string(), RichHTMLAnswerZ, EnhancedMarkdownAnswerZ]);
+// ============================================================================
+// Feedback Schemas
+// ============================================================================
+/** Schema for feedback widget configuration. */
+const FeedbackConfigZ = z.object({
+    style: z.enum(['thumbs', 'rating']),
+    prompt: z.string().optional(),
+});
+/** Feedback can be a boolean (enable/disable) or a detailed config object. */
+const FeedbackZ = z.union([z.boolean(), FeedbackConfigZ]);
+// ============================================================================
+// Ordering Schemas
+// ============================================================================
+/** Schema for segment-based ordering strategy. */
+const SegmentOrderingZ = z.object({
+    type: z.literal('segment'),
+    segmentWeights: z.record(z.array(z.string())),
+});
+/** Ordering strategy: static order, priority-based, or segment-based. */
+const OrderingStrategyZ = z.union([z.enum(['static', 'priority']), SegmentOrderingZ]);
+// ============================================================================
+// AI Answer Strategy Schema
+// ============================================================================
+/** Schema for AI-generated answer configuration. */
+const AnswerStrategyZ = z.object({
+    endpoint: z.string().min(1),
+    context: z.array(z.string()).optional(),
+    cache: z.enum(['session', 'none']).optional(),
+    fallback: z.string().optional(),
+});
+// ============================================================================
+// Injection Rule Schema
+// ============================================================================
+/** Schema for dynamic FAQ injection rules. */
+const InjectionRuleZ = z.object({
+    trigger: DecisionStrategyZ,
+    items: z.array(z.lazy(() => FAQQuestionSchema)),
+    position: z.enum(['prepend', 'append']).optional(),
+    once: z.boolean().optional(),
+});
+// ============================================================================
 // FAQ Question Schema
 // ============================================================================
 /**
@@ -62,10 +127,14 @@ export const FAQQuestionSchema = z.object({
         id: z.string().min(1, 'ID is required'),
         /** The question text */
         question: z.string().min(1, 'Question is required'),
-        /** The answer text (supports basic markdown) */
-        answer: z.string().min(1, 'Answer is required'),
+        /** The answer content (plain string, rich HTML, or enhanced markdown) */
+        answer: FAQAnswerZ,
         /** Optional category for grouping */
         category: z.string().optional(),
+        /** Optional priority for ordering */
+        priority: z.number().optional(),
+        /** Optional AI answer generation strategy */
+        answerStrategy: AnswerStrategyZ.optional(),
     }),
     /** Per-item activation strategy (null = always show) */
     showWhen: DecisionStrategyZ.nullable().optional(),
@@ -85,6 +154,56 @@ export const configSchema = z.object({
     theme: z.enum(['light', 'dark', 'auto']).default('auto'),
     /** FAQ questions (compositional actions) */
     actions: z.array(FAQQuestionSchema).default([]),
+    /** Feedback widget configuration */
+    feedback: FeedbackZ.optional(),
+    /** Question ordering strategy */
+    ordering: OrderingStrategyZ.optional(),
+    /** Dynamic FAQ injection rules */
+    injections: z.array(InjectionRuleZ).optional(),
+});
+// ============================================================================
+// Executor Action Schemas
+// ============================================================================
+/**
+ * Schema for scrolling to a specific FAQ item.
+ * Requires either itemId or itemQuestion to identify the target.
+ */
+export const ScrollToFaqSchema = z
+    .object({
+    kind: z.literal('faq:scroll_to'),
+    itemId: z.string().optional(),
+    itemQuestion: z.string().optional(),
+    expand: z.boolean().optional(),
+    behavior: z.enum(['smooth', 'instant', 'auto']).optional(),
+})
+    .refine((data) => data.itemId || data.itemQuestion, {
+    message: 'Either itemId or itemQuestion is required',
+});
+/**
+ * Schema for toggling a FAQ item open/closed.
+ * Requires either itemId or itemQuestion to identify the target.
+ */
+export const ToggleFaqItemSchema = z
+    .object({
+    kind: z.literal('faq:toggle_item'),
+    itemId: z.string().optional(),
+    itemQuestion: z.string().optional(),
+    state: z.enum(['open', 'closed', 'toggle']).default('toggle'),
+})
+    .refine((data) => data.itemId || data.itemQuestion, {
+    message: 'Either itemId or itemQuestion is required',
+});
+/**
+ * Schema for updating FAQ items (add, remove, reorder, replace).
+ */
+export const UpdateFaqSchema = z.object({
+    kind: z.literal('faq:update'),
+    operation: z.enum(['add', 'remove', 'reorder', 'replace']),
+    items: z.array(FAQQuestionSchema).optional(),
+    itemId: z.string().optional(),
+    order: z.array(z.string()).optional(),
+    position: z.enum(['prepend', 'append', 'before', 'after']).optional(),
+    anchorId: z.string().optional(),
 });
 // ============================================================================
 // Validation Helpers

package/dist/state.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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.
+ */
+import type { FAQQuestionAction, FAQWidgetState, FeedbackValue } from './types';
+type Listener = (state: FAQWidgetState) => void;
+type Unsubscribe = () => void;
+export interface FAQStore {
+    /** Return a snapshot of the current state. */
+    getState(): FAQWidgetState;
+    expand(itemId: string): void;
+    collapse(itemId: string): void;
+    toggle(itemId: string): void;
+    addItems(items: FAQQuestionAction[], position: 'prepend' | 'append'): void;
+    removeItem(itemId: string): void;
+    reorderItems(order: string[]): void;
+    replaceItems(items: FAQQuestionAction[]): void;
+    setFeedback(itemId: string, value: FeedbackValue): void;
+    setSearchQuery(query: string): void;
+    toggleCategory(category: string): void;
+    findByQuestion(text: string): FAQQuestionAction | null;
+    subscribe(listener: Listener): Unsubscribe;
+}
+export declare function createFAQStore(initialItems: FAQQuestionAction[]): FAQStore;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAMhF,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAChD,KAAK,WAAW,GAAG,MAAM,IAAI,CAAC;AAM9B,MAAM,WAAW,QAAQ;IACvB,8CAA8C;IAC9C,QAAQ,IAAI,cAAc,CAAC;IAG3B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAG7B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC3E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAG/C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAGxD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGpC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAGvC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAAC;IAGvD,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;CAC5C;AAMD,wBAAgB,cAAc,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,QAAQ,CA6I1E"}

package/dist/state.js

@@ -0,0 +1,132 @@
+/**
+ * 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.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Human-readable summary generation for FAQ items.
+ * Pure functions — no DOM access, just string formatting.
+ */
+import type { FAQQuestionAction, DecisionStrategy } from './types';
+/**
+ * Parse a showWhen strategy into a human-readable trigger description.
+ */
+export declare function describeTrigger(showWhen?: DecisionStrategy<boolean> | null): string;
+/**
+ * Generate a one-liner summary for an FAQ item.
+ */
+export declare function summarizeFAQItem(item: FAQQuestionAction): string;
+//# sourceMappingURL=summarize.d.ts.map

package/dist/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAa,gBAAgB,EAAgB,MAAM,SAAS,CAAC;AA6B5F;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,CAuBnF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAIhE"}

package/dist/summarize.js

@@ -0,0 +1,62 @@
+/**
+ * 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 showWhen strategy into a human-readable trigger description.
+ */
+export function describeTrigger(showWhen) {
+    if (!showWhen)
+        return 'All pages';
+    if (!isRuleStrategy(showWhen))
+        return 'All pages';
+    const pages = [];
+    const anchors = [];
+    for (const rule of showWhen.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.d.ts

@@ -38,82 +38,124 @@ export interface ExternalStrategy<T = unknown> {
     default: T;
     timeoutMs?: number;
 }
-/**
- * Single FAQ question configuration.
- * This is a "compositional action" - it's not executed, but rendered by the parent.
- */
+export interface Asset {
+    id: string;
+    type: 'image' | 'video';
+    src: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+}
+export interface RichHTMLAnswer {
+    type: 'rich';
+    html: string;
+}
+export interface EnhancedMarkdownAnswer {
+    type: 'markdown';
+    content: string;
+    assets?: Asset[];
+}
+export type FAQAnswer = string | RichHTMLAnswer | EnhancedMarkdownAnswer;
+export interface AnswerStrategy {
+    endpoint: string;
+    context?: string[];
+    cache?: 'session' | 'none';
+    fallback?: string;
+}
+export interface FeedbackConfig {
+    style: 'thumbs' | 'rating';
+    prompt?: string;
+}
+export type FeedbackValue = 'up' | 'down' | number;
+export interface SegmentOrdering {
+    type: 'segment';
+    segmentWeights: Record<string, string[]>;
+}
+export type OrderingStrategy = 'static' | 'priority' | SegmentOrdering;
+export interface InjectionRule {
+    trigger: DecisionStrategy<boolean>;
+    items: FAQQuestionAction[];
+    position?: 'prepend' | 'append';
+    once?: boolean;
+}
 export interface FAQQuestionAction {
-    /** Action kind identifier */
     kind: 'faq:question';
-    /** Question configuration */
     config: {
-        /** Unique identifier for this question */
         id: string;
-        /** The question text */
         question: string;
-        /** The answer text (supports basic markdown) */
-        answer: string;
-        /** Optional category for grouping */
+        answer: FAQAnswer;
         category?: string;
+        priority?: number;
+        answerStrategy?: AnswerStrategy;
     };
-    /** Optional per-item activation strategy */
     showWhen?: DecisionStrategy<boolean> | null;
+    rationale?: {
+        why: string;
+        confidence?: number;
+    };
 }
-/**
- * Expand behavior for the accordion.
- */
 export type ExpandBehavior = 'single' | 'multiple';
-/**
- * Theme for the FAQ widget.
- */
 export type FAQTheme = 'light' | 'dark' | 'auto';
-/**
- * Full configuration for the adaptive-faq widget.
- */
 export interface FAQConfig {
-    /** Whether only one or multiple questions can be expanded at once */
     expandBehavior: ExpandBehavior;
-    /** Whether to show a search/filter input */
     searchable: boolean;
-    /** Color theme */
     theme: FAQTheme;
-    /** FAQ questions (compositional actions) */
     actions: FAQQuestionAction[];
+    feedback?: boolean | FeedbackConfig;
+    ordering?: OrderingStrategy;
+    injections?: InjectionRule[];
 }
-/**
- * Runtime services passed to the widget.
- */
-export interface FAQWidgetRuntime {
-    /** Synchronously evaluate a decision strategy */
-    evaluateSync: <T>(strategy: DecisionStrategy<T>) => {
-        value: T;
-        isFallback: boolean;
-    };
-    /** Context manager for subscribing to changes */
-    context: {
-        subscribe: (callback: () => void) => () => void;
-    };
-    /** Event bus for publishing interactions */
-    events: {
-        publish: (name: string, props?: Record<string, unknown>) => void;
-    };
-    /** Scoped state store */
-    state?: {
-        get: (key: string) => unknown;
-        set: (key: string, value: unknown) => void;
-    };
+export interface ScrollToFaqAction {
+    kind: 'faq:scroll_to';
+    itemId?: string;
+    itemQuestion?: string;
+    expand?: boolean;
+    behavior?: 'smooth' | 'instant' | 'auto';
+}
+export interface ToggleFaqItemAction {
+    kind: 'faq:toggle_item';
+    itemId?: string;
+    itemQuestion?: string;
+    state?: 'open' | 'closed' | 'toggle';
+}
+export interface UpdateFaqAction {
+    kind: 'faq:update';
+    operation: 'add' | 'remove' | 'reorder' | 'replace';
+    items?: FAQQuestionAction[];
+    itemId?: string;
+    order?: string[];
+    position?: 'prepend' | 'append' | 'before' | 'after';
+    anchorId?: string;
+}
+export interface FAQWidgetState {
+    expandedItems: Set<string>;
+    items: FAQQuestionAction[];
+    searchQuery: string;
+    collapsedCategories: Set<string>;
+    feedbackState: Map<string, FeedbackValue>;
 }
+export type ExecutorCleanup = () => void;
+export type ExecutorUpdate = (action: unknown) => Promise<void>;
+export interface ExecutorResult {
+    cleanup: ExecutorCleanup;
+    updateFn?: ExecutorUpdate;
+}
+export interface ExecutorContext {
+    overlayRoot: HTMLElement;
+    resolveAnchor: (anchorId: string) => HTMLElement | null;
+    generateId: () => string;
+    publishEvent: (name: string, props?: Record<string, unknown>) => void;
+    adaptiveId?: string;
+}
+export type ActionExecutor<T> = (action: T, context: ExecutorContext) => Promise<ExecutorResult>;
+export declare const ACTION_NAMESPACE = "faq";
 /**
- * Props passed to the FAQWidget component.
+ * Returns true if the action belongs to this adaptive package.
+ * Uses prefix matching so new kinds (e.g. faq:category) are automatically included.
  */
-export interface FAQWidgetProps {
-    /** Widget configuration */
-    config: FAQConfig;
-    /** Runtime services */
-    runtime: FAQWidgetRuntime;
-    /** Instance ID for telemetry */
-    instanceId: string;
-}
+export declare function isOwnAction(action: {
+    kind: string;
+}): boolean;
 export interface EditorPanelProps {
     config: Record<string, unknown>;
     onChange: (config: Record<string, unknown>) => void;
@@ -122,6 +164,17 @@ export interface EditorPanelProps {
         navigateHome: () => Promise<boolean>;
         save: () => Promise<void>;
         publish: (captureScreenshot?: boolean) => Promise<void>;
+        navigateTo: (route: string) => Promise<void>;
+        highlightElement: (selector: string) => void;
+        clearHighlight: () => void;
+        getCurrentRoute: () => string;
+        previewConfig: (config: Record<string, unknown>) => void;
+        /** 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;
     };
     platformClient?: unknown;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -4,4 +4,14 @@
  * Type definitions for the FAQ accordion adaptive.
  * Demonstrates compositional action pattern with per-item showWhen.
  */
-export {};
+// ============================================================================
+// 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}:`);
+}