@syntrologie/adapt-faq 0.0.0-semantically-released

package/dist/schema.js

@@ -0,0 +1,103 @@
+/**
+ * Adaptive FAQ - Config Schema
+ *
+ * Zod schema for validating FAQ accordion configuration.
+ * Demonstrates compositional action pattern with per-item showWhen.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Decision Strategy Schema (simplified for this package)
+// ============================================================================
+const ConditionZ = z
+    .object({
+    type: z.string(),
+})
+    .passthrough();
+const RuleZ = z.object({
+    conditions: z.array(ConditionZ),
+    value: z.unknown(),
+});
+const RuleStrategyZ = z.object({
+    type: z.literal('rules'),
+    rules: z.array(RuleZ),
+    default: z.unknown(),
+});
+const ScoreStrategyZ = z.object({
+    type: z.literal('score'),
+    field: z.string(),
+    threshold: z.number(),
+    above: z.unknown(),
+    below: z.unknown(),
+});
+const ModelStrategyZ = z.object({
+    type: z.literal('model'),
+    modelId: z.string(),
+    inputs: z.array(z.string()),
+    outputMapping: z.record(z.unknown()),
+    default: z.unknown(),
+});
+const ExternalStrategyZ = z.object({
+    type: z.literal('external'),
+    endpoint: z.string(),
+    method: z.enum(['GET', 'POST']).optional(),
+    default: z.unknown(),
+    timeoutMs: z.number().optional(),
+});
+const DecisionStrategyZ = z.discriminatedUnion('type', [
+    RuleStrategyZ,
+    ScoreStrategyZ,
+    ModelStrategyZ,
+    ExternalStrategyZ,
+]);
+// ============================================================================
+// FAQ Question Schema
+// ============================================================================
+/**
+ * Schema for a single FAQ question (compositional action).
+ */
+export const FAQQuestionSchema = z.object({
+    kind: z.literal('faq:question'),
+    config: z.object({
+        /** Unique identifier for this question */
+        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'),
+        /** Optional category for grouping */
+        category: z.string().optional(),
+    }),
+    /** Per-item activation strategy (null = always show) */
+    showWhen: DecisionStrategyZ.nullable().optional(),
+});
+// ============================================================================
+// FAQ Config Schema
+// ============================================================================
+/**
+ * Full configuration schema for adaptive-faq.
+ */
+export const configSchema = z.object({
+    /** Whether only one or multiple questions can be expanded at once */
+    expandBehavior: z.enum(['single', 'multiple']).default('single'),
+    /** Whether to show a search/filter input */
+    searchable: z.boolean().default(false),
+    /** Color theme */
+    theme: z.enum(['light', 'dark', 'auto']).default('auto'),
+    /** FAQ questions (compositional actions) */
+    actions: z.array(FAQQuestionSchema).default([]),
+});
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Validate a FAQ question action.
+ */
+export function validateFAQQuestion(data) {
+    return FAQQuestionSchema.safeParse(data);
+}
+/**
+ * Validate the full FAQ config.
+ */
+export function validateFAQConfig(data) {
+    return configSchema.safeParse(data);
+}

package/dist/types.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Adaptive FAQ - Types
+ *
+ * Type definitions for the FAQ accordion adaptive.
+ * Demonstrates compositional action pattern with per-item showWhen.
+ */
+/**
+ * Simplified DecisionStrategy type for this package.
+ * Full definition is in @syntrologie/runtime-sdk.
+ */
+export type DecisionStrategy<T = unknown> = RuleStrategy<T> | ScoreStrategy<T> | ModelStrategy<T> | ExternalStrategy<T>;
+export interface RuleStrategy<T = unknown> {
+    type: 'rules';
+    rules: Array<{
+        conditions: Array<Record<string, unknown>>;
+        value: T;
+    }>;
+    default: T;
+}
+export interface ScoreStrategy<T = unknown> {
+    type: 'score';
+    field: string;
+    threshold: number;
+    above: T;
+    below: T;
+}
+export interface ModelStrategy<T = unknown> {
+    type: 'model';
+    modelId: string;
+    inputs: string[];
+    outputMapping: Record<string, T>;
+    default: T;
+}
+export interface ExternalStrategy<T = unknown> {
+    type: 'external';
+    endpoint: string;
+    method?: 'GET' | 'POST';
+    default: T;
+    timeoutMs?: number;
+}
+/**
+ * Single FAQ question configuration.
+ * This is a "compositional action" - it's not executed, but rendered by the parent.
+ */
+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 */
+        category?: string;
+    };
+    /** Optional per-item activation strategy */
+    showWhen?: DecisionStrategy<boolean> | null;
+}
+/**
+ * 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[];
+}
+/**
+ * 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;
+    };
+}
+/**
+ * Props passed to the FAQWidget component.
+ */
+export interface FAQWidgetProps {
+    /** Widget configuration */
+    config: FAQConfig;
+    /** Runtime services */
+    runtime: FAQWidgetRuntime;
+    /** Instance ID for telemetry */
+    instanceId: string;
+}
+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>;
+    };
+    platformClient?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Adaptive FAQ - Types
+ *
+ * Type definitions for the FAQ accordion adaptive.
+ * Demonstrates compositional action pattern with per-item showWhen.
+ */
+export {};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@syntrologie/adapt-faq",
+  "version": "0.0.0-semantically-released",
+  "description": "Adaptive FAQ - Collapsible Q&A accordion with per-item conditional visibility",
+  "license": "Proprietary",
+  "private": false,
+  "author": "Syntrologie <eng@syntrologie.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SyntropyForge/amazing-demos.git",
+    "directory": "tech-core/sdks/adaptives/adaptive-faq"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.js"
+    },
+    "./editor": {
+      "types": "./dist/editor.d.ts",
+      "import": "./dist/editor.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "@syntrologie/runtime-sdk": "^2.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "typescript": "^5.0.0",
+    "zod": "^3.25.0"
+  }
+}