@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/core/guidance/guidance-resource-compiler.shared.utils.js

@@ -0,0 +1,214 @@
+/**
+ * Guidance Resource Compiler
+ *
+ * Compiles resource-level guidance declarations (ResourceUIBehavior_GuidanceFlow)
+ * into standard GuidanceFlowDefinition objects that can be consumed by the Guidance System.
+ *
+ * Resource-level guidance is declared in the frontend preset via
+ * `ResourceUIBehaviorConfig.guidance`. The compiler namespaces refs (e.g., "TASKS.list-intro"),
+ * resolves triggers, and maps elements to the standard OnboardingElement format.
+ */
+import { GuidanceFlowScope } from '@wildo-ai/saas-models';
+import { OnboardingTriggerType, OnboardingElementType, TourStepPlacement } from '@wildo-ai/saas-models';
+/**
+ * Compile resource-level guidance declarations into standard GuidanceFlowDefinition objects.
+ *
+ * @param options - Resource type, guidance flows, and optional URL patterns
+ * @returns Array of GuidanceFlowDefinition ready for the Guidance System
+ */
+export function compileResourceGuidance(options) {
+    const { resourceType, guidanceFlows, urlPatterns } = options;
+    return guidanceFlows.map((flow) => {
+        // 1. Namespace ref: TASKS.list-intro
+        const namespacedRef = `${resourceType}.${flow.ref}`;
+        // 2. Resolve trigger
+        const trigger = resolveFlowTrigger(flow, resourceType, urlPatterns);
+        // 3. Map elements to OnboardingElement format
+        const elements = flow.elements.map((el, index) => compileElement(el, index));
+        // 4. Return standard GuidanceFlowDefinition
+        return {
+            ref: namespacedRef,
+            scope: flow.scope ?? GuidanceFlowScope.USER,
+            renderMode: flow.renderMode,
+            trigger,
+            audience: flow.audience,
+            priority: flow.priority ?? 100,
+            elements,
+        };
+    });
+}
+// ─── Helpers ─────────────────────────────────────────────────
+/**
+ * Map the resource-level trigger declaration to an OnboardingTrigger.
+ *
+ * - FIRST_VISIT → type='route-match' with routePattern derived from urlPatterns
+ *   because resource-level guidance is operation-surface-bound, not app-global
+ * - MANUAL → type='manual'
+ * - DELAYED → type='delayed' with delayMs
+ * - EVENT → type='event' with eventName (defaults to `${resourceType}:${bindToOperation}`)
+ */
+function resolveFlowTrigger(flow, resourceType, urlPatterns) {
+    const triggerDef = flow.trigger;
+    switch (triggerDef.type) {
+        case 'FIRST_VISIT': {
+            const routePattern = urlPatterns?.[flow.bindToOperation];
+            return {
+                type: OnboardingTriggerType.ROUTE_MATCH,
+                routePattern: routePattern ?? `/${resourceType.toLowerCase()}`,
+                conditions: { newUsersOnly: true, triggerOnce: true },
+            };
+        }
+        case 'MANUAL':
+            return {
+                type: OnboardingTriggerType.MANUAL,
+            };
+        case 'DELAYED':
+            return {
+                type: OnboardingTriggerType.DELAYED,
+                delayMs: triggerDef.delayMs ?? 1000,
+            };
+        case 'EVENT': {
+            const eventName = triggerDef.eventName ?? `${resourceType}:${flow.bindToOperation}`;
+            return {
+                type: OnboardingTriggerType.EVENT,
+                eventName,
+            };
+        }
+        default:
+            return {
+                type: OnboardingTriggerType.MANUAL,
+            };
+    }
+}
+/**
+ * Map a ResourceFrontend_GuidanceElement to a standard OnboardingElement.
+ *
+ * - Resolves `targetField` to `targetSelector` via `[data-guidance-field="..."]`
+ * - Preserves `targetField` as a custom property for runtime resolution by GuidanceRenderer
+ * - Maps type-specific properties (steps, questions, placement, actionRef)
+ */
+function compileElement(el, index) {
+    // Resolve targetSelector: explicit selector takes precedence, then derive from targetField
+    const targetSelector = el.targetSelector ?? (el.targetField ? `[data-guidance-field="${el.targetField}"]` : undefined);
+    // Build the base element — common fields across all element types
+    const base = {
+        ref: el.ref,
+        type: el.type,
+        title: '', // i18n — resolved at runtime via makeTrGuidanceElement
+        description: '',
+        order: index,
+        // targetField is a first-class field on OnboardingElementBaseSchema — used by
+        // GuidanceRenderer.resolveTargetSelector() to derive [data-guidance-field="..."] selectors
+        ...(el.targetField ? { targetField: el.targetField } : {}),
+    };
+    // Build type-specific fields
+    switch (el.type) {
+        case OnboardingElementType.TOOLTIP:
+            return {
+                ...base,
+                type: OnboardingElementType.TOOLTIP,
+                targetSelector: targetSelector ?? '',
+                placement: mapPlacement(el.placement),
+                content: '',
+            };
+        case OnboardingElementType.TOUR:
+            return {
+                ...base,
+                type: OnboardingElementType.TOUR,
+                steps: (el.steps ?? []).map((step, stepIndex) => ({
+                    ref: step.ref,
+                    title: '',
+                    description: '',
+                    order: stepIndex,
+                    placement: mapPlacement(step.placement) ?? TourStepPlacement.BOTTOM,
+                    targetSelector: step.targetSelector ?? (step.targetField ? `[data-guidance-field="${step.targetField}"]` : undefined),
+                    ...(step.targetField ? { targetField: step.targetField } : {}),
+                })),
+            };
+        case OnboardingElementType.MODAL:
+            return {
+                ...base,
+                type: OnboardingElementType.MODAL,
+                content: '',
+                dismissible: true,
+                ...(el.actionRef ? { ctaAction: el.actionRef } : {}),
+            };
+        case OnboardingElementType.BANNER:
+            return {
+                ...base,
+                type: OnboardingElementType.BANNER,
+                content: '',
+                actionLabel: '',
+                ...(el.actionRef ? { actionRef: el.actionRef } : {}),
+            };
+        case OnboardingElementType.ANNOUNCEMENT:
+            return {
+                ...base,
+                type: OnboardingElementType.ANNOUNCEMENT,
+                content: '',
+                actionLabel: '',
+                ...(el.actionRef ? { actionRef: el.actionRef } : {}),
+            };
+        case OnboardingElementType.BADGE:
+            return {
+                ...base,
+                type: OnboardingElementType.BADGE,
+                ...(targetSelector ? { targetSelector } : {}),
+                content: '',
+            };
+        case OnboardingElementType.CARD:
+            return {
+                ...base,
+                type: OnboardingElementType.CARD,
+                content: '',
+                actionLabel: '',
+                ...(el.actionRef ? { actionRef: el.actionRef } : {}),
+            };
+        case OnboardingElementType.SURVEY:
+            return {
+                ...base,
+                type: OnboardingElementType.SURVEY,
+                questions: (el.questions ?? []).map((q) => ({
+                    id: q.id,
+                    question: '',
+                    type: q.type,
+                    required: q.required ?? false,
+                    options: q.options?.map((opt) => ({ ref: opt.ref, value: opt.value ?? '' })),
+                })),
+            };
+        case OnboardingElementType.CHECKLIST:
+            return {
+                ...base,
+                type: OnboardingElementType.CHECKLIST,
+                items: [],
+            };
+        case OnboardingElementType.CHECKLIST_ITEM:
+            return {
+                ...base,
+                type: OnboardingElementType.CHECKLIST_ITEM,
+                ...(el.actionRef ? { actionRef: el.actionRef, actionLabel: '' } : {}),
+            };
+        default:
+            // Fallback for unknown/new element types — double-cast is intentional because
+            // the discriminated union requires type-specific fields we cannot know here.
+            // This should only be reached for future element types not yet in the compiler.
+            return {
+                ...base,
+                type: el.type,
+                content: '',
+            };
+    }
+}
+/**
+ * Map a string placement to the TourStepPlacement enum.
+ */
+function mapPlacement(placement) {
+    if (!placement)
+        return undefined;
+    const upper = placement.toUpperCase();
+    if (upper in TourStepPlacement) {
+        return TourStepPlacement[upper];
+    }
+    return undefined;
+}
+//# sourceMappingURL=guidance-resource-compiler.shared.utils.js.map

package/dist/esm/core/guidance/guidance-resource-compiler.shared.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-resource-compiler.shared.utils.js","sourceRoot":"","sources":["../../../../src/core/guidance/guidance-resource-compiler.shared.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/guidance/renderers/GuidanceAnnouncement.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GuidanceAnnouncement — Announcement renderer with icon support.
+ *
+ * Uses the engine Alert component for theme-compliant variant styling,
+ * and Button for actions/dismiss.
+ */
+import React from 'react';
+import type { GuidanceElementRendererProps } from '../../../core/guidance/GuidanceRenderer.js';
+export declare const GuidanceAnnouncement: React.FC<GuidanceElementRendererProps>;
+//# sourceMappingURL=GuidanceAnnouncement.d.ts.map

package/dist/esm/core/guidance/renderers/GuidanceAnnouncement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceAnnouncement.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceAnnouncement.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAsB,MAAM,OAAO,CAAC;AAS3C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AASvG,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAgEvE,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceAnnouncement.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * GuidanceAnnouncement — Announcement renderer with icon support.
+ *
+ * Uses the engine Alert component for theme-compliant variant styling,
+ * and Button for actions/dismiss.
+ */
+import { useCallback } from 'react';
+import { OnboardingVariant } from '@wildo-ai/saas-models';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { Alert, AlertTitle, AlertDescription } from '../../../components/overlays/containers/alert.js';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { useIconRegistry } from '../../../core/icons/useIconRegistry.js';
+import { IconSize, StandardIconReference } from '../../../core/icons/icon-registry.frontend.schemas.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+const VARIANT_MAP = {
+    [OnboardingVariant.INFO]: 'info',
+    [OnboardingVariant.SUCCESS]: 'success',
+    [OnboardingVariant.WARNING]: 'warning',
+    [OnboardingVariant.ERROR]: 'destructive',
+};
+export const GuidanceAnnouncement = ({ element, t, onAction, onDismiss, }) => {
+    const { tComponent, isReady } = useI18n({ component: FrontendComponentType.GUIDANCE_ANNOUNCEMENT });
+    const { renderIcon } = useIconRegistry();
+    const handleDismiss = useCallback(() => {
+        onDismiss(element.ref);
+    }, [onDismiss, element.ref]);
+    if (!isReady)
+        return null;
+    const el = element;
+    const variant = el.variant ?? OnboardingVariant.INFO;
+    const dismissible = el.dismissible ?? true;
+    const title = t('title') ?? el.title ?? '';
+    const content = t('content') ?? el.content ?? '';
+    const actionLabel = t('actionLabel') ?? el.actionLabel ?? '';
+    const actionRef = el.actionRef;
+    const icon = el.icon;
+    return (_jsxs(Alert, { variant: VARIANT_MAP[variant], role: "status", className: "pointer-events-auto relative", children: [icon && (_jsx("span", { className: "text-xl leading-none shrink-0 mt-0.5", "aria-hidden": "true", children: icon })), _jsxs("div", { className: "flex-1 min-w-0", children: [title && _jsx(AlertTitle, { children: title }), content && _jsx(AlertDescription, { children: content }), actionLabel && actionRef && (_jsx("div", { className: "mt-3", children: _jsx(Button, { size: ButtonSize.SM, onClick: () => onAction(actionRef), children: actionLabel }) }))] }), dismissible && (_jsx(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.ICON_SM, onClick: handleDismiss, "aria-label": tComponent(FrontendComponentType.GUIDANCE_ANNOUNCEMENT, 'dismiss'), className: "absolute top-2 end-2", children: renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM }) }))] }));
+};
+//# sourceMappingURL=GuidanceAnnouncement.js.map

package/dist/esm/core/guidance/renderers/GuidanceAnnouncement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceAnnouncement.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceAnnouncement.tsx"],"names":[],"mappings":"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"}

package/dist/esm/core/guidance/renderers/GuidanceBadge.d.ts

@@ -0,0 +1,9 @@
+/**
+ * GuidanceBadge -- Small indicator overlay renderer.
+ *
+ * Uses the engine Badge component for theme-compliant styling.
+ */
+import React from 'react';
+import type { GuidanceElementRendererProps } from '../../../core/guidance/GuidanceRenderer.js';
+export declare const GuidanceBadge: React.FC<GuidanceElementRendererProps>;
+//# sourceMappingURL=GuidanceBadge.d.ts.map

package/dist/esm/core/guidance/renderers/GuidanceBadge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceBadge.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceBadge.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAWvG,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA0BhE,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceBadge.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { OnboardingBadgeVariant } from '@wildo-ai/saas-models';
+import { Badge } from '../../../components/data-display/badge.js';
+const VARIANT_MAP = {
+    [OnboardingBadgeVariant.DEFAULT]: 'outline',
+    [OnboardingBadgeVariant.PRIMARY]: 'default',
+    [OnboardingBadgeVariant.SECONDARY]: 'secondary',
+    [OnboardingBadgeVariant.SUCCESS]: 'default',
+    [OnboardingBadgeVariant.WARNING]: 'secondary',
+    [OnboardingBadgeVariant.ERROR]: 'destructive',
+};
+export const GuidanceBadge = ({ element, t, }) => {
+    const el = element;
+    const variant = el.variant ?? OnboardingBadgeVariant.DEFAULT;
+    const unlocked = el.unlocked ?? false;
+    const title = t('title') ?? el.title ?? '';
+    const content = t('content') ?? el.content ?? '';
+    const icon = el.icon;
+    return (_jsxs(Badge, { variant: VARIANT_MAP[variant], className: unlocked ? '' : 'opacity-[var(--opacity-disabled)]', children: [icon && (_jsx("span", { className: "text-xs leading-none", "aria-hidden": "true", children: icon })), title || content] }));
+};
+//# sourceMappingURL=GuidanceBadge.js.map

package/dist/esm/core/guidance/renderers/GuidanceBadge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceBadge.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceBadge.tsx"],"names":[],"mappings":";AAOA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,mDAAmD,CAAC;AAG1E,MAAM,WAAW,GAAwF;IACvG,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,SAAS;IAC3C,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,SAAS;IAC3C,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,WAAW;IAC/C,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,SAAS;IAC3C,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,WAAW;IAC7C,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,aAAa;CAC9C,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAA2C,CAAC,EACpE,OAAO,EACP,CAAC,GACF,EAAE,EAAE;IACH,MAAM,EAAE,GAAG,OAAqD,CAAC;IAEjE,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,IAAI,sBAAsB,CAAC,OAAO,CAAC;IAC7D,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC;IAEtC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC;IACjD,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC;IAErB,OAAO,CACL,MAAC,KAAK,IACJ,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,EAC7B,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mCAAmC,aAE7D,IAAI,IAAI,CACP,eAAM,SAAS,EAAC,sBAAsB,iBAAa,MAAM,YACtD,IAAI,GACA,CACR,EACA,KAAK,IAAI,OAAO,IACX,CACT,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceBanner.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GuidanceBanner — Top/bottom bar renderer for guidance elements.
+ *
+ * Uses the engine Alert component for theme-compliant variant styling,
+ * and Button for actions/dismiss.
+ */
+import React from 'react';
+import type { GuidanceElementRendererProps } from '../../../core/guidance/GuidanceRenderer.js';
+export declare const GuidanceBanner: React.FC<GuidanceElementRendererProps>;
+//# sourceMappingURL=GuidanceBanner.d.ts.map

package/dist/esm/core/guidance/renderers/GuidanceBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceBanner.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceBanner.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAsB,MAAM,OAAO,CAAC;AAS3C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AASvG,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA8DjE,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceBanner.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * GuidanceBanner — Top/bottom bar renderer for guidance elements.
+ *
+ * Uses the engine Alert component for theme-compliant variant styling,
+ * and Button for actions/dismiss.
+ */
+import { useCallback } from 'react';
+import { OnboardingBannerPosition, OnboardingVariant } from '@wildo-ai/saas-models';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { Alert, AlertTitle, AlertDescription } from '../../../components/overlays/containers/alert.js';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { useIconRegistry } from '../../../core/icons/useIconRegistry.js';
+import { IconSize, StandardIconReference } from '../../../core/icons/icon-registry.frontend.schemas.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+const VARIANT_MAP = {
+    [OnboardingVariant.INFO]: 'info',
+    [OnboardingVariant.SUCCESS]: 'success',
+    [OnboardingVariant.WARNING]: 'warning',
+    [OnboardingVariant.ERROR]: 'destructive',
+};
+export const GuidanceBanner = ({ element, t, onAction, onDismiss, }) => {
+    const { tComponent, isReady } = useI18n({ component: FrontendComponentType.GUIDANCE_BANNER });
+    const { renderIcon } = useIconRegistry();
+    const el = element;
+    const variant = el.variant ?? OnboardingVariant.INFO;
+    const position = el.position ?? OnboardingBannerPosition.TOP;
+    const dismissible = el.dismissible ?? true;
+    const actionRef = el.actionRef;
+    const handleDismiss = useCallback(() => {
+        onDismiss(element.ref);
+    }, [onDismiss, element.ref]);
+    if (!isReady)
+        return null;
+    const title = t('title') ?? el.title ?? '';
+    const content = t('content') ?? el.content ?? '';
+    const actionLabel = t('actionLabel') ?? el.actionLabel ?? '';
+    const positionClasses = position === OnboardingBannerPosition.BOTTOM
+        ? 'absolute bottom-0 inset-x-0 rounded-none border-x-0 border-b-0'
+        : 'absolute top-0 inset-x-0 rounded-none border-x-0 border-t-0';
+    return (_jsx(Alert, { variant: VARIANT_MAP[variant], role: "alert", className: `pointer-events-auto ${positionClasses}`, children: _jsxs("div", { className: "flex items-center justify-between gap-3 w-full min-w-0", children: [_jsxs("div", { className: "flex flex-col gap-0.5 flex-1 min-w-0", children: [title && _jsx(AlertTitle, { children: title }), content && _jsx(AlertDescription, { children: content })] }), _jsxs("div", { className: "flex items-center gap-2 shrink-0", children: [actionLabel && actionRef && (_jsx(Button, { size: ButtonSize.SM, onClick: () => onAction(actionRef), children: actionLabel })), dismissible && (_jsx(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.ICON_SM, onClick: handleDismiss, "aria-label": tComponent(FrontendComponentType.GUIDANCE_BANNER, 'ariaClose'), title: tComponent(FrontendComponentType.GUIDANCE_BANNER, 'dismiss'), children: renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM }) }))] })] }) }));
+};
+//# sourceMappingURL=GuidanceBanner.js.map

package/dist/esm/core/guidance/renderers/GuidanceBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceBanner.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceBanner.tsx"],"names":[],"mappings":"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"}

package/dist/esm/core/guidance/renderers/GuidanceCard.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GuidanceCard — Rich content card renderer.
+ *
+ * Uses the engine Card component for theme-compliant surface styling,
+ * and Button for actions/dismiss.
+ */
+import React from 'react';
+import type { GuidanceElementRendererProps } from '../../../core/guidance/GuidanceRenderer.js';
+export declare const GuidanceCard: React.FC<GuidanceElementRendererProps>;
+//# sourceMappingURL=GuidanceCard.d.ts.map

package/dist/esm/core/guidance/renderers/GuidanceCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceCard.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceCard.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAsB,MAAM,OAAO,CAAC;AAQ3C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAEvG,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAoF/D,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceCard.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * GuidanceCard — Rich content card renderer.
+ *
+ * Uses the engine Card component for theme-compliant surface styling,
+ * and Button for actions/dismiss.
+ */
+import { useCallback } from 'react';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { Card, CardHeader, CardContent, CardFooter } from '../../../components/sections/card.js';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { useIconRegistry } from '../../../core/icons/useIconRegistry.js';
+import { IconSize, StandardIconReference } from '../../../core/icons/icon-registry.frontend.schemas.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+export const GuidanceCard = ({ element, t, onAction, onDismiss, }) => {
+    const { tComponent, isReady } = useI18n({ component: FrontendComponentType.GUIDANCE_CARD });
+    const { renderIcon } = useIconRegistry();
+    const el = element;
+    const dismissible = ('dismissible' in el && typeof el.dismissible === 'boolean') ? el.dismissible : true;
+    const actionRef = el.actionRef;
+    const imageUrl = el.imageUrl;
+    const icon = el.icon;
+    const handleDismiss = useCallback(() => {
+        onDismiss(element.ref);
+    }, [onDismiss, element.ref]);
+    if (!isReady)
+        return null;
+    const title = t('title') ?? el.title ?? '';
+    const description = t('description') ?? el.description ?? '';
+    const content = t('content') ?? el.content ?? '';
+    const actionLabel = t('actionLabel') ?? el.actionLabel ?? '';
+    return (_jsxs(Card, { className: "pointer-events-auto relative overflow-hidden", children: [imageUrl && (_jsx("img", { src: imageUrl, alt: "", className: "w-full max-h-[200px] object-cover" })), _jsx(CardHeader, { children: _jsxs("div", { className: "flex items-start gap-2.5", children: [icon && (_jsx("span", { className: "text-2xl leading-none shrink-0", "aria-hidden": "true", children: icon })), _jsxs("div", { className: "flex-1 min-w-0", children: [title && (_jsx("h3", { className: "text-base font-semibold leading-snug", children: title })), description && (_jsx("p", { className: "text-xs text-muted-foreground mt-1 leading-normal", children: description }))] })] }) }), content && (_jsx(CardContent, { children: _jsx("div", { className: "text-sm text-foreground/80 leading-relaxed", children: content }) })), actionLabel && actionRef && (_jsx(CardFooter, { children: _jsx(Button, { size: ButtonSize.SM, onClick: () => onAction(actionRef), children: actionLabel }) })), dismissible && (_jsx(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.ICON_SM, onClick: handleDismiss, "aria-label": tComponent(FrontendComponentType.GUIDANCE_CARD, 'dismiss'), className: "absolute top-2 end-2", children: renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM }) }))] }));
+};
+//# sourceMappingURL=GuidanceCard.js.map

package/dist/esm/core/guidance/renderers/GuidanceCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceCard.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceCard.tsx"],"names":[],"mappings":"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"}

package/dist/esm/core/guidance/renderers/GuidanceChecklist.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GuidanceChecklist Renderer
+ *
+ * Floating panel that displays a list of checklist items with progress
+ * tracking. Uses Card for container and Progress for the progress bar.
+ */
+import React from 'react';
+import type { GuidanceElementRendererProps } from '../../../core/guidance/GuidanceRenderer.js';
+export interface GuidanceChecklistProps extends GuidanceElementRendererProps {
+    children?: React.ReactNode;
+}
+export declare const GuidanceChecklist: React.FC<GuidanceChecklistProps>;
+//# sourceMappingURL=GuidanceChecklist.d.ts.map

package/dist/esm/core/guidance/renderers/GuidanceChecklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceChecklist.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceChecklist.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAyC,MAAM,OAAO,CAAC;AAY9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAEvG,MAAM,WAAW,sBAAuB,SAAQ,4BAA4B;IAC1E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAoG9D,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceChecklist.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * GuidanceChecklist Renderer
+ *
+ * Floating panel that displays a list of checklist items with progress
+ * tracking. Uses Card for container and Progress for the progress bar.
+ */
+import { useState, useMemo, useCallback } from 'react';
+import { OnboardingStatus } from '@wildo-ai/saas-models';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { Card, CardHeader, CardContent } from '../../../components/sections/card.js';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { Progress } from '../../../components/feedback/progress.js';
+import { useIconRegistry } from '../../../core/icons/useIconRegistry.js';
+import { IconSize, StandardIconReference } from '../../../core/icons/icon-registry.frontend.schemas.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { useGuidance } from '../../../core/guidance/useGuidance.js';
+export const GuidanceChecklist = ({ element, flowRef, state, onComplete, onDismiss, t, children, }) => {
+    const { tComponent, isReady } = useI18n({ component: FrontendComponentType.GUIDANCE_CHECKLIST });
+    const { renderIcon } = useIconRegistry();
+    const { flowStates } = useGuidance();
+    const [isCollapsed, setIsCollapsed] = useState(false);
+    const checklist = element;
+    const flowState = flowStates[flowRef];
+    const { completed, total } = useMemo(() => {
+        const itemRefs = checklist.items ?? [];
+        let completedCount = 0;
+        for (const ref of itemRefs) {
+            const elState = flowState?.elements?.[ref];
+            if (elState?.status === OnboardingStatus.COMPLETED) {
+                completedCount++;
+            }
+        }
+        return { completed: completedCount, total: itemRefs.length };
+    }, [checklist.items, flowState?.elements]);
+    const progressPercent = total > 0 ? Math.round((completed / total) * 100) : 0;
+    const handleToggle = useCallback(() => {
+        setIsCollapsed(prev => !prev);
+    }, []);
+    const handleDismiss = useCallback(() => {
+        onDismiss(checklist.ref);
+    }, [onDismiss, checklist.ref]);
+    if (!isReady)
+        return null;
+    const title = t('title') ?? checklist.title ?? '';
+    const description = t('description') ?? checklist.description ?? '';
+    const headerTitle = tComponent(FrontendComponentType.GUIDANCE_CHECKLIST, 'headerTitle');
+    const progressText = tComponent(FrontendComponentType.GUIDANCE_CHECKLIST, 'progress', { completed, total });
+    const toggleLabel = isCollapsed
+        ? tComponent(FrontendComponentType.GUIDANCE_CHECKLIST, 'expand')
+        : tComponent(FrontendComponentType.GUIDANCE_CHECKLIST, 'collapse');
+    const dismissLabel = tComponent(FrontendComponentType.GUIDANCE_CHECKLIST, 'dismiss');
+    return (_jsxs(Card, { className: "w-80 max-w-[calc(100vw-3rem)] overflow-hidden", role: "region", "aria-label": headerTitle || title, children: [_jsxs(CardHeader, { className: "flex-row items-center justify-between gap-2 py-3 px-4", children: [_jsxs("div", { className: "flex items-center gap-2 flex-1 min-w-0", children: [_jsx("span", { className: "font-semibold text-sm truncate", children: headerTitle || title }), _jsx(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.SM, onClick: handleToggle, "aria-expanded": !isCollapsed, className: "text-xs text-muted-foreground px-1.5 py-0.5 h-auto", children: toggleLabel })] }), _jsx(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.ICON_SM, onClick: handleDismiss, "aria-label": dismissLabel, children: renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM }) })] }), checklist.showProgress && (_jsxs("div", { className: "px-4 pb-2 flex items-center gap-2.5", children: [_jsx(Progress, { value: progressPercent, className: "flex-1", "aria-valuenow": completed, "aria-valuemin": 0, "aria-valuemax": total }), _jsx("span", { className: "text-xs text-muted-foreground shrink-0", children: progressText })] })), !isCollapsed && (_jsxs(CardContent, { className: "pt-0 pb-4 px-4", children: [description && _jsx("p", { className: "text-xs text-muted-foreground mb-2 leading-normal", children: description }), children && _jsx("div", { role: "list", children: children })] }))] }));
+};
+//# sourceMappingURL=GuidanceChecklist.js.map

package/dist/esm/core/guidance/renderers/GuidanceChecklist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceChecklist.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceChecklist.tsx"],"names":[],"mappings":"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"}

package/dist/esm/core/guidance/renderers/GuidanceChecklistItem.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GuidanceChecklistItem Renderer
+ *
+ * Single row within a checklist. Uses engine Checkbox and Button
+ * for theme-compliant, accessible interactive elements.
+ */
+import React from 'react';
+import type { GuidanceElementRendererProps } from '../../../core/guidance/GuidanceRenderer.js';
+export declare const GuidanceChecklistItem: React.FC<GuidanceElementRendererProps>;
+//# sourceMappingURL=GuidanceChecklistItem.d.ts.map

package/dist/esm/core/guidance/renderers/GuidanceChecklistItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceChecklistItem.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceChecklistItem.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAsB,MAAM,OAAO,CAAC;AAS3C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAEvG,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAyDxE,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceChecklistItem.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * GuidanceChecklistItem Renderer
+ *
+ * Single row within a checklist. Uses engine Checkbox and Button
+ * for theme-compliant, accessible interactive elements.
+ */
+import { useCallback } from 'react';
+import { OnboardingStatus } from '@wildo-ai/saas-models';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { z } from 'zod/v4';
+import { Checkbox } from '../../../components/form/controls/boolean/checkbox.js';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+export const GuidanceChecklistItem = ({ element, flowRef, state, onComplete, onAction, t, }) => {
+    const { tComponent, isReady } = useI18n({
+        component: FrontendComponentType.GUIDANCE_CHECKLIST_ITEM,
+    });
+    const item = element;
+    const isCompleted = state?.status === OnboardingStatus.COMPLETED;
+    const handleToggleComplete = useCallback(() => {
+        if (!isCompleted) {
+            onComplete(item.ref);
+        }
+    }, [isCompleted, onComplete, item.ref]);
+    const handleAction = useCallback(() => {
+        if (item.actionRef) {
+            onAction(item.actionRef);
+        }
+    }, [onAction, item.actionRef]);
+    if (!isReady)
+        return null;
+    const title = t('title') ?? item.title ?? '';
+    const actionLabel = t('actionLabel') ?? item.actionLabel ?? '';
+    return (_jsxs("div", { className: "flex items-center gap-2.5 py-2 border-b border-border/50 last:border-b-0", role: "listitem", children: [_jsx(Checkbox, { name: "__display", schema: z.boolean(), checked: isCompleted, onCheckedChange: handleToggleComplete, disabled: isCompleted, "aria-label": isCompleted
+                    ? tComponent(FrontendComponentType.GUIDANCE_CHECKLIST_ITEM, 'completed')
+                    : tComponent(FrontendComponentType.GUIDANCE_CHECKLIST_ITEM, 'markComplete') }), _jsx("span", { className: `flex-1 min-w-0 text-sm leading-snug ${isCompleted ? 'line-through text-muted-foreground' : ''}`, children: title }), actionLabel && item.actionRef && (_jsx(Button, { variant: ButtonVariants_Variant.OUTLINE, size: ButtonSize.SM, onClick: handleAction, className: "shrink-0", children: actionLabel }))] }));
+};
+//# sourceMappingURL=GuidanceChecklistItem.js.map

package/dist/esm/core/guidance/renderers/GuidanceChecklistItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceChecklistItem.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceChecklistItem.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AAEH,OAAc,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,+DAA+D,CAAC;AACzF,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAGhE,MAAM,CAAC,MAAM,qBAAqB,GAA2C,CAAC,EAC5E,OAAO,EACP,OAAO,EACP,KAAK,EACL,UAAU,EACV,QAAQ,EACR,CAAC,GACF,EAAE,EAAE;IACH,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACtC,SAAS,EAAE,qBAAqB,CAAC,uBAAuB;KACzD,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,OAAyC,CAAC;IACvD,MAAM,WAAW,GAAG,KAAK,EAAE,MAAM,KAAK,gBAAgB,CAAC,SAAS,CAAC;IAEjE,MAAM,oBAAoB,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAExC,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QACpC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAE/B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC7C,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;IAE/D,OAAO,CACL,eAAK,SAAS,EAAC,0EAA0E,EAAC,IAAI,EAAC,UAAU,aACvG,KAAC,QAAQ,IACP,IAAI,EAAC,WAAW,EAChB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,EACnB,OAAO,EAAE,WAAW,EACpB,eAAe,EAAE,oBAAoB,EACrC,QAAQ,EAAE,WAAW,gBAEnB,WAAW;oBACT,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,uBAAuB,EAAE,WAAW,CAAC;oBACxE,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,uBAAuB,EAAE,cAAc,CAAC,GAE/E,EAEF,eAAM,SAAS,EAAE,uCAAuC,WAAW,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,EAAE,EAAE,YAC9G,KAAK,GACD,EAEN,WAAW,IAAI,IAAI,CAAC,SAAS,IAAI,CAChC,KAAC,MAAM,IAAC,OAAO,EAAE,sBAAsB,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAC,UAAU,YAC9G,WAAW,GACL,CACV,IACG,CACP,CAAC;AACJ,CAAC,CAAC"}